From 78ab9bc889908e412e806d80f4ffbd938efc7a78 Mon Sep 17 00:00:00 2001
From: Via <vance@heygen.com>
Date: Tue, 21 Jul 2026 05:04:18 +0000
Subject: [PATCH 001/125] fix(skills): anonymize CLI feedback repro guidance
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The reproduction packet template in hyperframes-cli previously said
"Include the rerunnable command and working directory" and shipped a
`REPRO COMMAND: cd <project path> && ...` skeleton. Agents faithfully
followed both, so user home-directory prefixes (`/home/<user>/projects/...`,
`/Users/<user>/Documents/...`) have been landing verbatim in the public
CLI feedback channel — leaking user + machine identity that maintainers
don't need to reproduce a bug.

Fix, docs-only:

- SKILL.md: change "rerunnable command and working directory" to
  "rerunnable command (relative to the project directory)" plus an
  explicit note that feedback is public and absolute paths must not be
  pasted. Add a matching redaction rule for EXACT ERROR stack traces
  (keep basename+line, drop leading directory).
- references/preview-render.md: replace the `cd <project path>` skeleton
  with a bare `<HF_*/PRODUCER_* env> npx hyperframes <exact command>`
  template + inline comment reminding to run from the project directory
  without pasting absolute paths. Rewrite the "Preserve paths / redact
  secrets" line to lead with the anonymization rule and give concrete
  before/after examples (`./renders/out.mp4` vs
  `/Users/<user>/Documents/…/out.mp4`).

The COMPOSITION_STRUCTURE block was already privacy-preserving (counts
+ presence flags only, "no file paths, no src URLs, no user text") — no
change needed there.

skills-manifest.json regenerated for the hyperframes-cli hash.

Signed-off-by: Via <noreply@anthropic.com>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 skills-manifest.json                                | 2 +-
 skills/hyperframes-cli/SKILL.md                     | 2 +-
 skills/hyperframes-cli/references/preview-render.md | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/skills-manifest.json b/skills-manifest.json
index 83e8c6c0ed..0144087517 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -26,7 +26,7 @@
       "files": 104
     },
     "hyperframes-cli": {
-      "hash": "b1a0725560016894",
+      "hash": "dc57ec7198b9eaac",
       "files": 11
     },
     "hyperframes-core": {
diff --git a/skills/hyperframes-cli/SKILL.md b/skills/hyperframes-cli/SKILL.md
index 28a4d1cd84..938a3b5403 100644
--- a/skills/hyperframes-cli/SKILL.md
+++ b/skills/hyperframes-cli/SKILL.md
@@ -105,7 +105,7 @@ After verifying a successful render, send one feedback report unless telemetry i
 npx hyperframes feedback --rating <0-10> --comment "<specific result or friction>"
 ```
 
-Keep clean-run feedback concise. For any bug or friction, capture a **reproduction packet** before submitting; do not send only a symptom summary. Include the rerunnable command and working directory, expected versus actual behavior, exact error, whether output completed/fell back/failed, workaround, and repro-project status. For a rating ≤ 7 that describes a visual defect (black frame, flicker, corrupt output, wrong frame, blank output, other visual anomaly), also include a `COMPOSITION_STRUCTURE:` block — a privacy-preserving structural anatomy (element census + attribute presence + timeline shape) so maintainers can pattern-match against known bug families without the composition ZIP. Agents auto-fill this via the composition-census helper; the human user does not fill it by hand. If the issue did not reproduce again, say so and still include the last failing command and logs. Use `--file-issue` only with consent: it publishes a minimal reproduction to a public URL. The required packet format and privacy warning live in `references/preview-render.md`.
+Keep clean-run feedback concise. For any bug or friction, capture a **reproduction packet** before submitting; do not send only a symptom summary. Include the rerunnable command (relative to the project directory — feedback is submitted to a public channel, so do **not** paste absolute paths, home-directory prefixes, or user/machine identifiers), expected versus actual behavior, exact error (also strip absolute paths from stack traces — keep basename + line, drop the leading directory), whether output completed/fell back/failed, workaround, and repro-project status. For a rating ≤ 7 that describes a visual defect (black frame, flicker, corrupt output, wrong frame, blank output, other visual anomaly), also include a `COMPOSITION_STRUCTURE:` block — a privacy-preserving structural anatomy (element census + attribute presence + timeline shape) so maintainers can pattern-match against known bug families without the composition ZIP. Agents auto-fill this via the composition-census helper; the human user does not fill it by hand. If the issue did not reproduce again, say so and still include the last failing command and logs. Use `--file-issue` only with consent: it publishes a minimal reproduction to a public URL. The required packet format and privacy warning live in `references/preview-render.md`.
 
 ## Read the matching reference before running a command
 
diff --git a/skills/hyperframes-cli/references/preview-render.md b/skills/hyperframes-cli/references/preview-render.md
index c7562cdd93..f5ed1f4e8e 100644
--- a/skills/hyperframes-cli/references/preview-render.md
+++ b/skills/hyperframes-cli/references/preview-render.md
@@ -156,7 +156,7 @@ npx hyperframes feedback --rating 6 --comment "bg <video> renders grey in multi-
 `--rating` is an integer from 0-10 (required); `--comment` is free text. Feedback is anonymous and attaches a `doctorSummary` (OS/Node/CPU/mem/ffmpeg) automatically, so don't repeat those fields. A clean run needs only a short result. Before sending any bug, workaround, or confusing behavior, collect this compact reproduction packet:
 
 ```text
-REPRO COMMAND: cd <project path> && <HF_*/PRODUCER_* env> npx hyperframes <exact command>
+REPRO COMMAND: <HF_*/PRODUCER_* env> npx hyperframes <exact command>   # run from the project directory; do NOT paste absolute paths
 EXPECTED / ACTUAL: <expected behavior> / <observed behavior and isolated trigger>
 EXACT ERROR: <verbatim error or warning; include frame/timestamp for visual defects>
 OUTCOME: <output correct | output corrupt | fallback succeeded | hard exit | command hung>
@@ -171,7 +171,7 @@ COMPOSITION_STRUCTURE:
 
 `COMPOSITION_STRUCTURE:` is a privacy-preserving structural anatomy: counts + presence flags only, no file paths, no src URLs, no user text. It lets maintainers pattern-match the report against known bug families (e.g. "sub-comp mount + clip-path", "GSAP timeline + z-index") without receiving the composition ZIP. Required for any rating ≤ 7 that describes a visual defect (black frame, flicker, corrupt output, wrong frame, blank output, other visual anomaly); optional but appreciated on higher ratings. Agents on this skill can auto-fill the block by calling `buildCompositionCensus(html)` and `renderCompositionCensusBlock(census)` from `packages/cli/src/utils/compositionCensus.ts` against the composition HTML they already have access to — the human user does not fill this out by hand.
 
-Preserve paths containing spaces, flags, and relevant `HF_*` / `PRODUCER_*` variables; redact secrets and credentials. If the failure no longer reproduces, include the last failing command and log excerpt. Share a project link only when one is already available and safe to share.
+**Feedback is submitted to a public channel — anonymize before sending.** Redact absolute paths (which leak user home directory + machine identity), any user or project names embedded in paths, secrets, and credentials. Path arguments in the command should stay relative to the project directory (`./renders/out.mp4`, not `/Users/<user>/Documents/…/out.mp4`; `.hf-tmp/`, not `/home/<user>/projects/<real-name>/.hf-tmp/`). Similarly strip absolute paths from `EXACT ERROR:` stack traces and log excerpts — keep the file basename and line number, drop the leading directory. Preserve flags and relevant `HF_*` / `PRODUCER_*` variables verbatim. If the failure no longer reproduces, include the last failing command and log excerpt (redacted the same way). Share a project link only when one is already available and safe to share.
 
 The `hyperframes feedback` command soft-warns when a non-10 `--comment` is missing `REPRO COMMAND:`, and when a rating-≤-7 visual-defect comment is missing `COMPOSITION_STRUCTURE:`. The warnings print above the submission ack and do not block — some legitimate reports (a one-line "cloudrun quota bumped yesterday, fine now") won't fit the mold. Fix the packet and rerun to silence them.
 

From 30ca51c615fce20f5266278cdf5f4c97fd691c88 Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Tue, 21 Jul 2026 01:08:02 -0700
Subject: [PATCH 002/125] feat(engine): warn when a live map viewport is
 detected at capture init

---
 .../frameCapture-liveMapWarning.test.ts       | 24 +++++++++
 packages/engine/src/services/frameCapture.ts  | 49 +++++++++++++++++++
 packages/engine/src/types.ts                  |  3 +-
 3 files changed, 75 insertions(+), 1 deletion(-)
 create mode 100644 packages/engine/src/services/frameCapture-liveMapWarning.test.ts

diff --git a/packages/engine/src/services/frameCapture-liveMapWarning.test.ts b/packages/engine/src/services/frameCapture-liveMapWarning.test.ts
new file mode 100644
index 0000000000..1808cf7b9e
--- /dev/null
+++ b/packages/engine/src/services/frameCapture-liveMapWarning.test.ts
@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+import { buildLiveMapWarning } from "./frameCapture.js";
+
+describe("buildLiveMapWarning", () => {
+  it("names every detected map library in the message and details", () => {
+    const warning = buildLiveMapWarning(["Leaflet", "MapLibre GL"]);
+    expect(warning.code).toBe("live_map_detected");
+    expect(warning.message).toContain("Leaflet, MapLibre GL");
+    expect(warning.details?.sources).toEqual(["Leaflet", "MapLibre GL"]);
+  });
+
+  it("points the author at the bake pipeline instead of just describing the failure", () => {
+    const warning = buildLiveMapWarning(["Leaflet"]);
+    expect(warning.message).toContain("bake-basemap.mjs");
+    expect(warning.message).toContain("deterministic-render");
+  });
+
+  it("copies the libraries array so later mutation cannot alter the recorded warning", () => {
+    const libraries = ["Leaflet"];
+    const warning = buildLiveMapWarning(libraries);
+    libraries.push("Mapbox GL");
+    expect(warning.details?.sources).toEqual(["Leaflet"]);
+  });
+});
diff --git a/packages/engine/src/services/frameCapture.ts b/packages/engine/src/services/frameCapture.ts
index c6948fcba2..0c7346dc7a 100644
--- a/packages/engine/src/services/frameCapture.ts
+++ b/packages/engine/src/services/frameCapture.ts
@@ -1716,6 +1716,53 @@ function recordSubTimelineWarning(session: CaptureSession, timeoutMs: number): v
   ]);
 }
 
+/**
+ * Runtime-mounted map-viewport markers, keyed by the CSS selector each map
+ * library stamps on its live container. Selector presence means an actual map
+ * INSTANCE is rendering in the page — not merely that a map library script
+ * loaded — which keeps false positives low (a baked map video carries none of
+ * these).
+ */
+const LIVE_MAP_MARKERS: ReadonlyArray<{ selector: string; library: string }> = [
+  { selector: ".leaflet-container", library: "Leaflet" },
+  { selector: ".maplibregl-map", library: "MapLibre GL" },
+  { selector: ".mapboxgl-map", library: "Mapbox GL" },
+  { selector: ".gm-style", library: "Google Maps" },
+  { selector: ".ol-viewport", library: "OpenLayers" },
+];
+
+/**
+ * Build the `live_map_detected` warning for the detected map libraries.
+ * A live tile map violates the deterministic-render contract (tiles are
+ * render-time network fetches): none of the readiness polls cover late-added
+ * tile images or map canvases, so frames captured before tiles arrive ship a
+ * blank/partial map with no error — the render exits success. Wild signature:
+ * PRINFRA-300 (blank hook scene, zero diagnostics, "fixed" by re-render).
+ */
+export function buildLiveMapWarning(libraries: readonly string[]): CaptureWarning {
+  return {
+    code: "live_map_detected",
+    message:
+      `Live map viewport(s) detected in the composition (${libraries.join(", ")}). ` +
+      `Map tiles load over the network at render time, which the deterministic-render ` +
+      `contract forbids — frames captured before tiles arrive ship a blank or partial map ` +
+      `with no error. Bake the map to a video first (see the motion-graphics maps skill / ` +
+      `bake-basemap.mjs) and use the baked file as the imagery layer.`,
+    details: { sources: [...libraries] },
+  };
+}
+
+/** Detect live map viewports in the page and record the warning. */
+async function recordLiveMapWarning(session: CaptureSession, page: Page): Promise<void> {
+  const libraries = (await page.evaluate(
+    (markers: ReadonlyArray<{ selector: string; library: string }>) =>
+      markers.filter((m) => document.querySelector(m.selector) !== null).map((m) => m.library),
+    LIVE_MAP_MARKERS,
+  )) as string[];
+  if (libraries.length === 0) return;
+  recordCaptureWarnings(session, [buildLiveMapWarning(libraries)]);
+}
+
 // Force every successfully-loaded `<img>` to be GPU-uploaded before the first
 // frame capture. `naturalWidth > 0` means the bitmap has been decoded into
 // CPU memory, but compositor-side GPU upload can still happen lazily on first
@@ -2002,6 +2049,7 @@ export async function initializeSession(session: CaptureSession): Promise<void>
       session,
       await collectMediaReadinessWarnings(page, skipVideoIds, pageReadyTimeout),
     );
+    await recordLiveMapWarning(session, page);
 
     await recordSessionInitTelemetry(session, initStart);
 
@@ -2164,6 +2212,7 @@ export async function initializeSession(session: CaptureSession): Promise<void>
     session,
     await collectMediaReadinessWarnings(page, bfSkipVideoIds, pageReadyTimeout),
   );
+  await recordLiveMapWarning(session, page);
 
   await recordSessionInitTelemetry(session, initStart);
 
diff --git a/packages/engine/src/types.ts b/packages/engine/src/types.ts
index 96d858e32a..483a7b4de0 100644
--- a/packages/engine/src/types.ts
+++ b/packages/engine/src/types.ts
@@ -18,7 +18,8 @@ export type CaptureWarningCode =
   | "media_load_failed"
   | "audio_processing_failed"
   | "sub_timeline_readiness_timeout"
-  | "sub_timeline_script_failure";
+  | "sub_timeline_script_failure"
+  | "live_map_detected";
 
 /** Structured correctness warning produced while preparing a capture session. */
 export interface CaptureWarning {

From 07965e9fe93fc7b53dfe7c933f8abd0c4b10c86d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Miguel=20=C3=81ngel?= <miguel.sierra@heygen.com>
Date: Tue, 21 Jul 2026 14:32:13 +0200
Subject: [PATCH 003/125] fix(studio): play preview audio at speeds above 1x
 (#2691)

* fix(studio): play preview audio at speeds above 1x

The player force-muted preview audio whenever playback rate exceeded 1x
and disabled the mute button (and the M shortcut) in that state. Users
changing speed to 2x heard nothing, and clicking unmute did nothing.

Media elements play audio fine at any rate (pitch preserved by default),
so remove the special case: audio now follows only the user's mute
toggle at every speed. Drops the shouldMutePreviewAudio helper and the
audioAutoMuted UI/keyboard gating that existed solely for it.

* test(studio): update seek audio test for unmuted-above-1x behavior

useTimelinePlayer.seek.test.ts still asserted the old force-mute: at 2x
with the user unmuted it expected a set-muted{muted:true} message. With
audio now following only the user's toggle, the preview receives
set-muted{muted:false}. Update the assertion and title to match.
---
 .../player/components/PlayerControls.test.ts  | 17 ----------
 .../src/player/components/PlayerControls.tsx  | 31 +++++--------------
 .../player/hooks/usePlaybackKeyboard.test.ts  |  4 +--
 .../src/player/hooks/usePlaybackKeyboard.ts   |  5 +--
 .../hooks/useTimelinePlayer.seek.test.ts      |  4 +--
 .../src/player/hooks/useTimelinePlayer.ts     | 18 +++--------
 packages/studio/src/player/lib/timelineDOM.ts |  1 -
 .../src/player/lib/timelineIframeHelpers.ts   |  4 ---
 8 files changed, 18 insertions(+), 66 deletions(-)

diff --git a/packages/studio/src/player/components/PlayerControls.test.ts b/packages/studio/src/player/components/PlayerControls.test.ts
index fad6e3cd6a..84f23ac599 100644
--- a/packages/studio/src/player/components/PlayerControls.test.ts
+++ b/packages/studio/src/player/components/PlayerControls.test.ts
@@ -1,6 +1,5 @@
 import { describe, expect, it } from "vitest";
 import { resolveSeekPercent } from "./PlayerControls";
-import { shouldMutePreviewAudio } from "../lib/timelineIframeHelpers";
 
 describe("resolveSeekPercent", () => {
   it("returns 0 when the track width is invalid", () => {
@@ -19,19 +18,3 @@ describe("resolveSeekPercent", () => {
     expect(resolveSeekPercent(150, 100, 200)).toBe(0.25);
   });
 });
-
-describe("shouldMutePreviewAudio", () => {
-  it("mutes when the user toggled audio off", () => {
-    expect(shouldMutePreviewAudio(true, 1)).toBe(true);
-  });
-
-  it("auto-mutes above 1x playback", () => {
-    expect(shouldMutePreviewAudio(false, 1.5)).toBe(true);
-    expect(shouldMutePreviewAudio(false, 2)).toBe(true);
-  });
-
-  it("keeps audio on at 1x or slower when the user has not muted it", () => {
-    expect(shouldMutePreviewAudio(false, 1)).toBe(false);
-    expect(shouldMutePreviewAudio(false, 0.5)).toBe(false);
-  });
-});
diff --git a/packages/studio/src/player/components/PlayerControls.tsx b/packages/studio/src/player/components/PlayerControls.tsx
index dd32c1342c..0ebe6ec2d2 100644
--- a/packages/studio/src/player/components/PlayerControls.tsx
+++ b/packages/studio/src/player/components/PlayerControls.tsx
@@ -2,7 +2,6 @@ import { useRef, useCallback, useEffect, memo } from "react";
 import gsap from "gsap";
 import { MorphSVGPlugin } from "gsap/MorphSVGPlugin";
 import { formatFrameTime, formatTime, stepFrameTime } from "../lib/time";
-import { shouldMutePreviewAudio } from "../lib/timelineIframeHelpers";
 import { usePlayerStore } from "../store/playerStore";
 import { trackStudioEvent } from "../../utils/studioTelemetry";
 import { Tooltip } from "../../components/ui";
@@ -60,40 +59,30 @@ function PlayPauseMorphIcon({ playing }: { playing: boolean }) {
 
 const MuteButton = memo(function MuteButton({
   audioMuted,
-  audioAutoMuted,
-  effectiveAudioMuted,
   controlsDisabled,
   setAudioMuted,
 }: {
   audioMuted: boolean;
-  audioAutoMuted: boolean;
-  effectiveAudioMuted: boolean;
   controlsDisabled: boolean;
   setAudioMuted: (v: boolean) => void;
 }) {
-  const label = audioAutoMuted
-    ? "Audio muted above 1x speed"
-    : audioMuted
-      ? "Unmute audio"
-      : "Mute audio";
+  const label = audioMuted ? "Unmute audio" : "Mute audio";
   return (
     <Tooltip label={label}>
       <button
         type="button"
         onClick={() => {
-          if (!audioAutoMuted) {
-            trackStudioEvent("playback", { action: "mute_toggle", muted: !audioMuted });
-            setAudioMuted(!audioMuted);
-          }
+          trackStudioEvent("playback", { action: "mute_toggle", muted: !audioMuted });
+          setAudioMuted(!audioMuted);
         }}
-        disabled={controlsDisabled || audioAutoMuted}
+        disabled={controlsDisabled}
         aria-label={label}
-        aria-pressed={effectiveAudioMuted}
+        aria-pressed={audioMuted}
         className={`h-7 w-7 flex-shrink-0 flex items-center justify-center rounded-md border transition-colors disabled:pointer-events-none ${
-          effectiveAudioMuted
+          audioMuted
             ? "text-studio-accent bg-studio-accent/10 border-studio-accent/30"
             : "border-neutral-700 text-neutral-400 hover:border-neutral-500 hover:bg-neutral-800"
-        } ${audioAutoMuted ? "opacity-70" : ""}`}
+        }`}
       >
         <svg
           width="13"
@@ -107,7 +96,7 @@ const MuteButton = memo(function MuteButton({
           aria-hidden="true"
         >
           <path d="M11 5 6 9H3v6h3l5 4V5Z" />
-          {effectiveAudioMuted ? (
+          {audioMuted ? (
             <>
               <path d="m19 9-6 6" />
               <path d="m13 9 6 6" />
@@ -383,8 +372,6 @@ export const PlayerControls = memo(function PlayerControls({
   const durationRef = useRef(duration);
   durationRef.current = duration;
   const controlsDisabled = disabled || !timelineReady;
-  const audioAutoMuted = playbackRate > 1;
-  const effectiveAudioMuted = shouldMutePreviewAudio(audioMuted, playbackRate);
 
   useEffect(() => {
     if (!timeDisplayRef.current) return;
@@ -486,8 +473,6 @@ export const PlayerControls = memo(function PlayerControls({
 
       <MuteButton
         audioMuted={audioMuted}
-        audioAutoMuted={audioAutoMuted}
-        effectiveAudioMuted={effectiveAudioMuted}
         controlsDisabled={controlsDisabled}
         setAudioMuted={setAudioMuted}
       />
diff --git a/packages/studio/src/player/hooks/usePlaybackKeyboard.test.ts b/packages/studio/src/player/hooks/usePlaybackKeyboard.test.ts
index ddd1bb413d..dc61a3b472 100644
--- a/packages/studio/src/player/hooks/usePlaybackKeyboard.test.ts
+++ b/packages/studio/src/player/hooks/usePlaybackKeyboard.test.ts
@@ -189,7 +189,7 @@ describe("usePlaybackKeyboard — mute & loop shortcuts (#905)", () => {
     expect(usePlayerStore.getState().audioMuted).toBe(false);
   });
 
-  it("M does NOT toggle audioMuted above 1x playback (matches button gating)", () => {
+  it("M toggles audioMuted above 1x playback too", () => {
     const { dispatch } = setupHook();
     usePlayerStore.setState({ playbackRate: 2, audioMuted: false });
 
@@ -197,7 +197,7 @@ describe("usePlaybackKeyboard — mute & loop shortcuts (#905)", () => {
       dispatch(keydown({ code: "KeyM", key: "m" }));
     });
 
-    expect(usePlayerStore.getState().audioMuted).toBe(false);
+    expect(usePlayerStore.getState().audioMuted).toBe(true);
   });
 
   it("Shift+L toggles loopEnabled without starting forward shuttle", () => {
diff --git a/packages/studio/src/player/hooks/usePlaybackKeyboard.ts b/packages/studio/src/player/hooks/usePlaybackKeyboard.ts
index 6e7ee1098b..6ebb561679 100644
--- a/packages/studio/src/player/hooks/usePlaybackKeyboard.ts
+++ b/packages/studio/src/player/hooks/usePlaybackKeyboard.ts
@@ -116,10 +116,7 @@ export function usePlaybackKeyboard({
       if (key === "m") {
         e.preventDefault();
         const state = usePlayerStore.getState();
-        // Audio is force-muted above 1x playback — match the mute button's gating.
-        if (state.playbackRate <= 1) {
-          state.setAudioMuted(!state.audioMuted);
-        }
+        state.setAudioMuted(!state.audioMuted);
         return;
       }
       if (key === "l" && e.shiftKey) {
diff --git a/packages/studio/src/player/hooks/useTimelinePlayer.seek.test.ts b/packages/studio/src/player/hooks/useTimelinePlayer.seek.test.ts
index 45db5c9fcc..cdafb4596b 100644
--- a/packages/studio/src/player/hooks/useTimelinePlayer.seek.test.ts
+++ b/packages/studio/src/player/hooks/useTimelinePlayer.seek.test.ts
@@ -211,7 +211,7 @@ describe("useTimelinePlayer seek hydration", () => {
 });
 
 describe("useTimelinePlayer audio controls (#835)", () => {
-  it("applies playback-rate changes immediately and auto-mutes audio above 1x", () => {
+  it("applies playback-rate changes immediately and keeps audio unmuted above 1x", () => {
     const { api, root } = renderTimelinePlayerHarness();
     const postMessage = vi.fn();
     const timeScale = vi.fn();
@@ -244,7 +244,7 @@ describe("useTimelinePlayer audio controls (#835)", () => {
         source: "hf-parent",
         type: "control",
         action: "set-muted",
-        muted: true,
+        muted: false,
       }),
       "*",
     );
diff --git a/packages/studio/src/player/hooks/useTimelinePlayer.ts b/packages/studio/src/player/hooks/useTimelinePlayer.ts
index 44bb17717d..39be707e68 100644
--- a/packages/studio/src/player/hooks/useTimelinePlayer.ts
+++ b/packages/studio/src/player/hooks/useTimelinePlayer.ts
@@ -37,11 +37,7 @@ import {
   parseTimelineFromDOM,
 } from "../lib/timelineDOM";
 import { normalizeToZones } from "../components/timelineZones";
-import {
-  setPreviewMediaMuted,
-  setPreviewPlaybackRate,
-  shouldMutePreviewAudio,
-} from "../lib/timelineIframeHelpers";
+import { setPreviewMediaMuted, setPreviewPlaybackRate } from "../lib/timelineIframeHelpers";
 import { scrubMusicAtSeek, stopScrubPreviewAudio } from "../lib/playbackScrub";
 import { applyCachedSourceDurations, probeMissingSourceDurations } from "../lib/mediaProbe";
 import { shouldResumeForwardPlaybackAfterSeek, shouldStopAfterSeek } from "../lib/playbackSeek";
@@ -241,13 +237,9 @@ export function useTimelinePlayer() {
       }
     } catch {}
   }, []);
-  const applyPreviewAudioState = useCallback((playbackRateOverride?: number) => {
-    const { audioMuted, playbackRate } = usePlayerStore.getState();
-    const effectivePlaybackRate = playbackRateOverride ?? playbackRate;
-    setPreviewMediaMuted(
-      iframeRef.current,
-      shouldMutePreviewAudio(audioMuted, effectivePlaybackRate),
-    );
+  const applyPreviewAudioState = useCallback(() => {
+    const { audioMuted } = usePlayerStore.getState();
+    setPreviewMediaMuted(iframeRef.current, audioMuted);
   }, []);
   const play = useCallback(() => {
     stopRAFLoop();
@@ -285,7 +277,7 @@ export function useTimelinePlayer() {
       if (initialTime !== adapter.getTime()) adapter.seek(initialTime);
       const speed = Math.max(0.1, Math.min(4, rate));
       applyPlaybackRate(speed);
-      applyPreviewAudioState(speed);
+      applyPreviewAudioState();
       let startTime = initialTime;
       let startedAt = performance.now();
 
diff --git a/packages/studio/src/player/lib/timelineDOM.ts b/packages/studio/src/player/lib/timelineDOM.ts
index 0819582b5a..a8730caa4b 100644
--- a/packages/studio/src/player/lib/timelineDOM.ts
+++ b/packages/studio/src/player/lib/timelineDOM.ts
@@ -55,7 +55,6 @@ export {
   autoHealMissingCompositionIds,
   setPreviewMediaMuted,
   setPreviewPlaybackRate,
-  shouldMutePreviewAudio,
   resolveIframe,
   buildMissingCompositionElements,
 } from "./timelineIframeHelpers";
diff --git a/packages/studio/src/player/lib/timelineIframeHelpers.ts b/packages/studio/src/player/lib/timelineIframeHelpers.ts
index 7885ccbfc8..9be165f1de 100644
--- a/packages/studio/src/player/lib/timelineIframeHelpers.ts
+++ b/packages/studio/src/player/lib/timelineIframeHelpers.ts
@@ -111,10 +111,6 @@ function postPreviewControl(
   postRuntimeControlMessage(iframe.contentWindow, action, payload);
 }
 
-export function shouldMutePreviewAudio(audioMuted: boolean, playbackRate: number): boolean {
-  return audioMuted || playbackRate > 1;
-}
-
 export function setPreviewMediaMuted(iframe: HTMLIFrameElement | null, muted: boolean): void {
   if (!iframe) return;
   try {

From 84841b8dae6cd385752a2b1bb5e8af8ad1937d19 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Tue, 21 Jul 2026 14:36:22 +0200
Subject: [PATCH 004/125] chore: release v0.7.66

---
 .claude-plugin/plugin.json               |  2 +-
 .codex-plugin/plugin.json                |  2 +-
 .cursor-plugin/plugin.json               |  2 +-
 docs/changelog.mdx                       | 19 +++++++++++++++++++
 packages/aws-lambda/package.json         |  2 +-
 packages/cli/package.json                |  2 +-
 packages/core/package.json               |  2 +-
 packages/engine/package.json             |  2 +-
 packages/gcp-cloud-run/package.json      |  2 +-
 packages/lint/package.json               |  2 +-
 packages/parsers/package.json            |  2 +-
 packages/player/package.json             |  2 +-
 packages/producer/package.json           |  2 +-
 packages/sdk/package.json                |  2 +-
 packages/shader-transitions/package.json |  2 +-
 packages/studio-server/package.json      |  2 +-
 packages/studio/package.json             |  2 +-
 releases/v0.7.66.md                      | 18 ++++++++++++++++++
 18 files changed, 53 insertions(+), 16 deletions(-)
 create mode 100644 releases/v0.7.66.md

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 379083f389..156b912360 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 1ea3a1635b..1bc42ab779 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index d82c79454a..0ddefc96c1 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -3,7 +3,7 @@
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com"
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 1dfeabd2dc..d701c13821 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -8,6 +8,25 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
 
 {/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
 
+<Update
+  label="HyperFrames v0.7.66"
+  description="Released - 2026-07-21"
+  tags={["Release", "Studio", "Skills", "Engine"]}
+>
+Studio preview audio now plays at playback speeds above 1x instead of being silently muted, and the mute control stays usable at every speed. This release also fixes an engine worker frame-stride false-positive and lands a c2v skills mining pass with new blueprints and rules.
+
+## Features
+
+- **Skills:** C2v mining pass — 7 new blueprints, 10 new rules, compacted recipe corpus ([853256403](https://github.com/heygen-com/hyperframes/commit/853256403b3ffd3dc0b616785ab876b4c0f04a89), [#2680](https://github.com/heygen-com/hyperframes/pull/2680))
+
+## Fixes
+
+- **Studio:** Play preview audio at speeds above 1x ([07965e9fe](https://github.com/heygen-com/hyperframes/commit/07965e9fe93fc7b53dfe7c933f8abd0c4b10c86d), [#2691](https://github.com/heygen-com/hyperframes/pull/2691))
+- **Engine:** Carry frameStride onto WorkerResult (fixes interleaved worker false-positive) ([4f53dd4f2](https://github.com/heygen-com/hyperframes/commit/4f53dd4f2cd607de17b2d2329746fa5da0cadeaa))
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.7.65...v0.7.66).
+</Update>
+
 <Update
   label="HyperFrames v0.7.65"
   description="Released - 2026-07-21"
diff --git a/packages/aws-lambda/package.json b/packages/aws-lambda/package.json
index 7f84f40c94..9cd0f061c8 100644
--- a/packages/aws-lambda/package.json
+++ b/packages/aws-lambda/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 180852ba62..71984e0858 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "license": "Apache-2.0",
   "repository": {
diff --git a/packages/core/package.json b/packages/core/package.json
index b61e617e75..2a6934b230 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/packages/engine/package.json b/packages/engine/package.json
index f176092e28..4903834b28 100644
--- a/packages/engine/package.json
+++ b/packages/engine/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
diff --git a/packages/gcp-cloud-run/package.json b/packages/gcp-cloud-run/package.json
index c835bb312c..541f1372ce 100644
--- a/packages/gcp-cloud-run/package.json
+++ b/packages/gcp-cloud-run/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/gcp-cloud-run",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index 6e1efa909c..99b97c14ae 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index ecf10381e9..b4cc185682 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/player/package.json b/packages/player/package.json
index 25207ef423..5c04837768 100644
--- a/packages/player/package.json
+++ b/packages/player/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/player",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "Embeddable web component for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/producer/package.json b/packages/producer/package.json
index a5d3ffd0f0..fae9241cd2 100644
--- a/packages/producer/package.json
+++ b/packages/producer/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 400ff3b3cd..14874c990e 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
diff --git a/packages/shader-transitions/package.json b/packages/shader-transitions/package.json
index 4dab8da218..78d7b348f9 100644
--- a/packages/shader-transitions/package.json
+++ b/packages/shader-transitions/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/shader-transitions",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "WebGL shader transitions for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/studio-server/package.json b/packages/studio-server/package.json
index 55ff87de43..dd2323b024 100644
--- a/packages/studio-server/package.json
+++ b/packages/studio-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/studio/package.json b/packages/studio/package.json
index c4744110c8..d9e38c5ff6 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.7.65",
+  "version": "0.7.66",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/releases/v0.7.66.md b/releases/v0.7.66.md
new file mode 100644
index 0000000000..58574525f9
--- /dev/null
+++ b/releases/v0.7.66.md
@@ -0,0 +1,18 @@
+# HyperFrames v0.7.66
+
+Released on 2026-07-21.
+
+Studio preview audio now plays at playback speeds above 1x instead of being silently muted, and the mute control stays usable at every speed. This release also fixes an engine worker frame-stride false-positive and lands a c2v skills mining pass with new blueprints and rules.
+
+## Features
+
+- **Skills:** C2v mining pass — 7 new blueprints, 10 new rules, compacted recipe corpus ([853256403](https://github.com/heygen-com/hyperframes/commit/853256403b3ffd3dc0b616785ab876b4c0f04a89), [#2680](https://github.com/heygen-com/hyperframes/pull/2680))
+
+## Fixes
+
+- **Studio:** Play preview audio at speeds above 1x ([07965e9fe](https://github.com/heygen-com/hyperframes/commit/07965e9fe93fc7b53dfe7c933f8abd0c4b10c86d), [#2691](https://github.com/heygen-com/hyperframes/pull/2691))
+- **Engine:** Carry frameStride onto WorkerResult (fixes interleaved worker false-positive) ([4f53dd4f2](https://github.com/heygen-com/hyperframes/commit/4f53dd4f2cd607de17b2d2329746fa5da0cadeaa))
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.7.65...v0.7.66

From 696cbdbbd0e5c83faf72c767126d4a153110f130 Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Tue, 21 Jul 2026 12:41:40 -0400
Subject: [PATCH 005/125] chore(skills): package Codex plugin upload (#2668)

* chore(skills): package Codex plugin upload

* chore(skills): harden Codex plugin content

* fix(skills): satisfy plugin quality gates

* fix(skills): address plugin packaging review

* fix(plugin): simplify asset validation

* fix(skills): correct embedded-captions catalog count to 35 after nightcity removal

The nightcity theme removal left SKILL.md claiming 36 identities in
four places, including the frontmatter description the router reads.
The catalog now has 35 entries (10 classic + 25 themed).

---------

Co-authored-by: Miao Yang <miao.yang@heygen.com>
---
 .github/workflows/ci.yml                      |  22 ++
 README.md                                     |  10 +
 ...07-13-media-use-sfx-cli-advisory-design.md |   4 +-
 package.json                                  |   1 +
 scripts/package-codex-plugin.mjs              |  67 ++++++
 skills-manifest.json                          |  24 +--
 skills/embedded-captions/.gitignore           |   3 -
 skills/embedded-captions/CATALOG.md           |   4 +-
 skills/embedded-captions/SKILL.md             |  14 +-
 .../assets/brand/CDPR-fankit-terms.txt        |  35 ----
 .../assets/brand/CyberpunkReplica.ttf         | Bin 16684 -> 0 bytes
 .../assets/brand/cyberpunk-widths.json        | 115 ----------
 skills/embedded-captions/dna/README.md        |   4 +-
 skills/embedded-captions/dna/neon.json        |   4 +-
 .../embedded-captions/scripts/make-theme.cjs  | 196 ------------------
 skills/embedded-captions/themes/PORTING.md    |   1 -
 skills/embedded-captions/themes/README.md     |   1 -
 .../embedded-captions/themes/nightcity.json   |  56 -----
 .../references/motion-language.md             |   2 +-
 skills/figma/SKILL.md                         |  42 ++--
 skills/general-video/SKILL.md                 |   2 +-
 .../scripts/package-loader.mjs                |   2 +-
 .../transitions/css-destruction.md            |   2 +-
 .../references/subagent-dispatch.md           |  34 ++-
 .../{claude => code-editorial}/FRAME.md       |  10 +-
 .../caption-skin.html                         |   8 +-
 .../fonts/EBGaramond-400.woff2                | Bin
 .../fonts/EBGaramond-700.woff2                | Bin
 .../fonts/Inter-400.woff2                     | Bin
 .../fonts/Inter-700.woff2                     | Bin
 .../fonts/JetBrainsMono-400.woff2             | Bin
 .../fonts/JetBrainsMono-700.woff2             | Bin
 .../fonts/OFL-eb-garamond.txt                 |   0
 .../fonts/OFL-inter.txt                       |   0
 .../fonts/OFL-jetbrains-mono.txt              |   0
 .../frame-showcase.html                       |   7 +-
 .../references/design-spec.md                 |   2 +-
 .../scripts/package-loader.mjs                |   2 +-
 .../media-use/references/setup-providers.md   |  21 +-
 .../references/telemetry-dashboard.md         |  23 +-
 skills/pr-to-video/SKILL.md                   |  22 +-
 .../pr-to-video/references/code-vocabulary.md |   8 +-
 .../pr-to-video/references/motion-language.md |   2 +-
 skills/pr-to-video/references/story-design.md |  12 +-
 .../pr-to-video/references/visual-design.md   |  16 +-
 .../scripts/frame-contract.test.mjs           |  13 +-
 skills/pr-to-video/scripts/ingest.mjs         |   2 +-
 skills/pr-to-video/sub-agents/frame-worker.md |   6 +-
 .../references/cut-catalog.md                 |   2 +-
 .../references/motion-language.md             |   2 +-
 skills/talking-head-recut/SKILL.md            |   3 +-
 51 files changed, 246 insertions(+), 560 deletions(-)
 create mode 100644 scripts/package-codex-plugin.mjs
 delete mode 100644 skills/embedded-captions/assets/brand/CDPR-fankit-terms.txt
 delete mode 100644 skills/embedded-captions/assets/brand/CyberpunkReplica.ttf
 delete mode 100644 skills/embedded-captions/assets/brand/cyberpunk-widths.json
 delete mode 100644 skills/embedded-captions/themes/nightcity.json
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/FRAME.md (97%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/caption-skin.html (96%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/EBGaramond-400.woff2 (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/EBGaramond-700.woff2 (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/Inter-400.woff2 (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/Inter-700.woff2 (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/JetBrainsMono-400.woff2 (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/JetBrainsMono-700.woff2 (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/OFL-eb-garamond.txt (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/OFL-inter.txt (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/fonts/OFL-jetbrains-mono.txt (100%)
 rename skills/hyperframes-creative/frame-presets/{claude => code-editorial}/frame-showcase.html (99%)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 583d3ba185..dc783fb9bb 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -34,6 +34,7 @@ jobs:
       code: ${{ steps.filter.outputs.code }}
       cli: ${{ steps.filter.outputs.cli }}
       skills: ${{ steps.filter.outputs.skills }}
+      codex_plugin: ${{ steps.filter.outputs.codex_plugin }}
     steps:
       # Force git-based change detection instead of the pull_request REST API.
       # The API path can fail the whole workflow on transient listFiles
@@ -68,6 +69,13 @@ jobs:
               - "scripts/check-skill-mirror.mjs"
               - "package.json"
               - ".github/workflows/ci.yml"
+            codex_plugin:
+              - ".codex-plugin/**"
+              - "assets/**"
+              - "skills/**"
+              - "scripts/package-codex-plugin.mjs"
+              - "package.json"
+              - ".github/workflows/ci.yml"
 
   build:
     name: Build
@@ -339,6 +347,20 @@ jobs:
       - name: Verify .claude/skills/ and .agents/skills/ are byte-identical
         run: node scripts/check-skill-mirror.mjs
 
+  codex-plugin-package:
+    name: "Codex plugin package"
+    needs: changes
+    if: needs.changes.outputs.codex_plugin == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 3
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        with:
+          node-version: 22
+      - name: Build upload-ready Codex plugin
+        run: node scripts/package-codex-plugin.mjs
+
   cli-npx-shim:
     name: "CLI: npx shim (${{ matrix.os }})"
     needs: changes
diff --git a/README.md b/README.md
index a94b9cd123..b3e8d69560 100644
--- a/README.md
+++ b/README.md
@@ -59,6 +59,16 @@ Default to the **core set** — the router installs each creation workflow on de
 
 Installs stay lean after that: `npx hyperframes init` keeps the **core set** fresh (the router, the `hyperframes-*` domain skills, and `media-use` — plus whatever is already installed; `/figma` stays on demand) and never expands a partial install; the creation workflows install **on demand** — the router runs `npx hyperframes skills update <workflow>` before entering one. Nothing re-pulls the full set behind your back.
 
+### Upload to Codex
+
+Build the upload-ready Codex plugin archive from the committed `HEAD` version of the manifest, brand assets, and skills:
+
+```bash
+bun run package:codex-plugin
+```
+
+This writes `dist/hyperframes-plugin.zip` with a `hyperframes/` root folder and fails if the archive exceeds Codex's 100 MB upload limit.
+
 ### Router
 
 | Skill          | Use when                                                                                                                                                                                                                                                                 |
diff --git a/docs/superpowers/specs/2026-07-13-media-use-sfx-cli-advisory-design.md b/docs/superpowers/specs/2026-07-13-media-use-sfx-cli-advisory-design.md
index 39fcb756b7..8b71a62e0b 100644
--- a/docs/superpowers/specs/2026-07-13-media-use-sfx-cli-advisory-design.md
+++ b/docs/superpowers/specs/2026-07-13-media-use-sfx-cli-advisory-design.md
@@ -9,8 +9,8 @@ When SFX resolution succeeds through the bundled fallback because the HeyGen CLI
 - Reuse the existing HeyGen CLI error classification produced by the failed catalog provider call.
 - Retain only the latest actionable `not_found` or `outdated` remediation for the current resolver process.
 - When `bundled.sfx` wins after that failure, include a structured advisory in JSON output and print the same concise hint in human output.
-- Use the existing canonical commands:
-  - Missing: `curl -fsSL https://static.heygen.ai/cli/install.sh | bash && heygen auth login --oauth`
+- Use the existing canonical remediation:
+  - Missing: install the [HeyGen CLI](https://developers.heygen.com/cli), then run `heygen auth login --oauth`
   - Outdated: `heygen update`
 - Do not emit this advisory for authentication, quota, network, or legitimate empty-catalog results; `--local-only`; or an explicitly forced bundled provider.
 - Do not execute the install or update command.
diff --git a/package.json b/package.json
index 81da41d9f7..13a2a73e3a 100644
--- a/package.json
+++ b/package.json
@@ -51,6 +51,7 @@
     "test:skills": "node --test 'skills/**/*.test.mjs'",
     "generate:previews": "tsx scripts/generate-template-previews.ts",
     "generate:catalog-previews": "tsx scripts/generate-catalog-previews.ts",
+    "package:codex-plugin": "node scripts/package-codex-plugin.mjs",
     "upload:docs-images": "bash scripts/upload-docs-images.sh",
     "prepare": "test -d .git && lefthook install || true"
   },
diff --git a/scripts/package-codex-plugin.mjs b/scripts/package-codex-plugin.mjs
new file mode 100644
index 0000000000..000ce8d524
--- /dev/null
+++ b/scripts/package-codex-plugin.mjs
@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+import { execFileSync, spawnSync } from "node:child_process";
+import { mkdirSync, readFileSync, rmSync, statSync } from "node:fs";
+import { join } from "node:path";
+
+const REPO_ROOT = join(import.meta.dirname, "..");
+const OUTPUT = join(REPO_ROOT, "dist", "hyperframes-plugin.zip");
+// Codex reports its upload limit in decimal MB.
+const MAX_UPLOAD_BYTES = 100 * 1_000_000;
+const pluginManifest = JSON.parse(readFileSync(join(REPO_ROOT, ".codex-plugin", "plugin.json")));
+const assetPaths = [
+  ...new Set(
+    Object.values(pluginManifest.interface)
+      .filter((value) => typeof value === "string")
+      .map((value) => value.replace(/^\.\//, ""))
+      .filter((value) => value.startsWith("assets/")),
+  ),
+].sort();
+if (assetPaths.some((assetPath) => assetPath.split("/").includes(".."))) {
+  throw new Error("Plugin manifest contains an unsafe asset path.");
+}
+const PLUGIN_PATHS = [".codex-plugin", ...assetPaths, "skills"];
+
+for (const pluginPath of PLUGIN_PATHS) {
+  execFileSync("git", ["cat-file", "-e", `HEAD:${pluginPath}`], {
+    cwd: REPO_ROOT,
+    stdio: "inherit",
+  });
+}
+
+const dirtyCheck = spawnSync("git", ["diff", "--quiet", "HEAD", "--", ...PLUGIN_PATHS], {
+  cwd: REPO_ROOT,
+});
+if (dirtyCheck.error || (dirtyCheck.status !== 0 && dirtyCheck.status !== 1)) {
+  throw dirtyCheck.error ?? new Error("Unable to inspect the plugin working tree state.");
+}
+if (dirtyCheck.status === 1) {
+  console.warn("Warning: packaging committed HEAD; uncommitted plugin changes are excluded.");
+}
+
+mkdirSync(join(REPO_ROOT, "dist"), { recursive: true });
+
+execFileSync(
+  "git",
+  [
+    "archive",
+    "--format=zip",
+    "--prefix=hyperframes/",
+    "--output",
+    OUTPUT,
+    "HEAD",
+    "--",
+    ...PLUGIN_PATHS,
+  ],
+  { cwd: REPO_ROOT, stdio: "inherit" },
+);
+
+const bytes = statSync(OUTPUT).size;
+if (bytes > MAX_UPLOAD_BYTES) {
+  rmSync(OUTPUT);
+  throw new Error(
+    `Codex plugin archive is ${(bytes / 1_000_000).toFixed(1)} MB; the upload limit is 100 MB.`,
+  );
+}
+
+console.log(`Wrote ${OUTPUT} (${(bytes / 1_000_000).toFixed(1)} MB).`);
diff --git a/skills-manifest.json b/skills-manifest.json
index 70c62b8200..bc97b43b55 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -2,19 +2,19 @@
   "source": "heygen-com/hyperframes",
   "skills": {
     "embedded-captions": {
-      "hash": "cabda69328a29062",
-      "files": 144
+      "hash": "a30d5691b4389ec1",
+      "files": 140
     },
     "faceless-explainer": {
-      "hash": "ff47c02598dc7947",
+      "hash": "d53bcc3cbcfaa7bb",
       "files": 22
     },
     "figma": {
-      "hash": "0e6e96f5a76ff824",
+      "hash": "517e4dc53c13ea05",
       "files": 2
     },
     "general-video": {
-      "hash": "94fd399a0dd0b6ce",
+      "hash": "3303742225924078",
       "files": 4
     },
     "hyperframes": {
@@ -22,7 +22,7 @@
       "files": 17
     },
     "hyperframes-animation": {
-      "hash": "b4adace47d4fa1b1",
+      "hash": "3d9855346af7d51c",
       "files": 121
     },
     "hyperframes-cli": {
@@ -30,11 +30,11 @@
       "files": 11
     },
     "hyperframes-core": {
-      "hash": "23f64febbc5cae37",
+      "hash": "85004c9571ed19ce",
       "files": 19
     },
     "hyperframes-creative": {
-      "hash": "b9e2cbfa49e6ed6c",
+      "hash": "bacb5205ea5eb3d8",
       "files": 78
     },
     "hyperframes-keyframes": {
@@ -46,7 +46,7 @@
       "files": 10
     },
     "media-use": {
-      "hash": "b10751149c9ea1da",
+      "hash": "f7f0ad56a0477a09",
       "files": 145
     },
     "motion-graphics": {
@@ -58,11 +58,11 @@
       "files": 132
     },
     "pr-to-video": {
-      "hash": "d37f9f5411c34089",
+      "hash": "17ed27aa2cc32501",
       "files": 29
     },
     "product-launch-video": {
-      "hash": "9557c9b86f4239b9",
+      "hash": "84b33f077fff496d",
       "files": 26
     },
     "remotion-to-hyperframes": {
@@ -74,7 +74,7 @@
       "files": 2
     },
     "talking-head-recut": {
-      "hash": "0d0ede12041c51b7",
+      "hash": "2f5d99f823c48e75",
       "files": 28
     }
   }
diff --git a/skills/embedded-captions/.gitignore b/skills/embedded-captions/.gitignore
index 88eba0f442..8700818eef 100644
--- a/skills/embedded-captions/.gitignore
+++ b/skills/embedded-captions/.gitignore
@@ -19,6 +19,3 @@ matte.fps
 safe-zones.json
 
 .DS_Store
-# CDPR fan-kit source SVG (528KB) — only its extracted metrics
-# (assets/brand/cyberpunk-widths.json) are consumed at runtime.
-assets/brand/Cyberpunk2077.svg
diff --git a/skills/embedded-captions/CATALOG.md b/skills/embedded-captions/CATALOG.md
index 71dd062b05..8e6d1cd1cc 100644
--- a/skills/embedded-captions/CATALOG.md
+++ b/skills/embedded-captions/CATALOG.md
@@ -24,7 +24,7 @@ Routing procedure (replaces any mode decision):
 | `keynote`     | scene-embedded column flow                               | confident centered slides-in-the-scene                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | launches, founder updates, tech explainers (mood over verbatim reading)                                                                                                                                        | any mid/dark                                                                                                           | cinematic.json → make-cinematic |
 | `documentary` | scene-embedded column flow                               | burn-in stillness, bone on charcoal                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | interviews, journalism, testimony — gravitas IS the style                                                                                                                                                      | any                                                                                                                    | cinematic.json → make-cinematic |
 | `loud`        | scene-embedded, body in front                            | percussion type that competes with the face                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | hype, social reels, sport, music, motivational                                                                                                                                                                 | any (counter-accent handles warm)                                                                                      | cinematic.json → make-cinematic |
-| `neon`        | scene-embedded column flow                               | captions as neon signage in the dark                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | cyberpunk / nightlife / tech-noir / music                                                                                                                                                                      | dark scenes                                                                                                            | cinematic.json → make-cinematic |
+| `neon`        | scene-embedded column flow                               | captions as neon signage in the dark                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | neon-noir / nightlife / tech-noir / music                                                                                                                                                                      | dark scenes                                                                                                            | cinematic.json → make-cinematic |
 | `glitch`      | scene-embedded column flow                               | corrupted-feed RGB-split type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | hacker / AI / dystopia content                                                                                                                                                                                 | mid/dark                                                                                                               | cinematic.json → make-cinematic |
 | `chrome`      | scene-embedded column flow                               | liquid-metal hero with sheen sweeps                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | fashion-tech, Y2K, product-flex                                                                                                                                                                                | mid/dark                                                                                                               | cinematic.json → make-cinematic |
 | `velocity`    | scene-embedded column flow                               | every word arrives along its motion vector                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | sport, automotive, fitness, kinetic content                                                                                                                                                                    | any mid/dark                                                                                                           | cinematic.json → make-cinematic |
@@ -35,7 +35,6 @@ Routing procedure (replaces any mode decision):
 | `stardust`    | accumulating poem, condensing letters                    | words condense from dust and return to it                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | poetic / memory / science-wonder monologues                                                                                                                                                                    | one clear column side (probe fails → fall back to `cream`)                                                             | theme.json → make-theme         |
 | `stomp`       | full-frame takeover cards                                | hard-cut typographic takeover with a void before the drop                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | hooks, manifestos, ad openers — the words ARE the show                                                                                                                                                         | any (plate runs dimmed)                                                                                                | theme.json → make-theme         |
 | `lastpage`    | manuscript rail + a blurred future-field                 | the future hangs unreadable in the room; one rack-focus reveals every faint line was the apex word                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | visionary thesis, prophecy-toned talks, trailers, literary content                                                                                                                                             | mid/dark (the field needs air)                                                                                         | theme.json → make-theme         |
-| `nightcity`   | corrupted-UI rail + cover-letterform apex                | body words boot through a corrupted-cyan frame into acid-yellow UI; the apex slams in BEHIND the subject set in the CP2077 cover replica typeface (cyan offset, baseline streak, circuit trace), tears in as displaced slices, lives as a glitching print                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | gaming / tech-edge / glitch culture / hype drops, "赛博朋克/游戏封面" asks                                                                                                                                     | any (the lockup carries its own contrast); CP2077-adjacent content only (fan-kit terms)                                | theme.json → make-theme         |
 | `scoreboard`  | split-flap chyron rail + departures-board apex           | stadium split-flap mechanics — body words flip-cycle wrong words on tiles before clacking onto the real one; ROW counter + odometer chip furniture; the apex is a giant departures board behind the subject that locks the word letter-by-letter under floodlights and a crowd-flash, status ticker types on                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | sports, transit/travel, scores, countdowns, reveals, "翻牌/记分牌/机场大屏" asks                                                                                                                               | any (board + chyron bring their own dark metal contrast)                                                               | theme.json → make-theme         |
 | `transit`     | LED departure-strip rail + illumination-wipe apex        | amber dot-matrix station PA — body words light column-by-column (L→R LED wipe + arrival flicker) on a docked departure strip whose lines page by scroll-snap; platform tag, ticking clock, ⚠ DELAYED → ● ON TIME gag; the apex panel expands behind the subject inside a chasing LED-marquee border, the word illuminates column-by-column under a PA flash + ding pulses, then pages up and collapses                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | travel/transit, announcements, schedules, countdowns, retro-terminal, "LED屏/车站到站/点阵屏" asks                                                                                                             | any (LED strip + panel bring their own dark contrast)                                                                  | theme.json → make-theme         |
 | `vhs`         | camcorder OSD rail + REC-FREEZE tracking-slam apex       | tape playback — permanent lens vignette + OSD furniture (▶ PLAY, ● REC, blinking green timestamp); body words carry a permanent red/cyan misregistration fringe, arrive by tracking glitch and REWIND off with flat-white echoes + scrub lines (the deck flips PLAY→REW in dead air); the apex is REC FREEZE: 1-frame white tear + head-switching noise bar, the word slams in behind the subject as three sheared tracking bands that SNAP into register, misregistration breathes through the hold under tape weave + auto-iris, then rewinds off                                                                                                                                                                                                                                                                                                                                                                                                                   | retro / nostalgia / found-footage / home-video, '90s tech, music & lifestyle edits, "录像带/VHS/复古/DV" asks                                                                                                  | any (backlight-comp scrim makes its own contrast on bright skies)                                                      | theme.json → make-theme         |
@@ -66,7 +65,6 @@ Routing procedure (replaces any mode decision):
   every beat (`loud`).
 - **Named worlds** → direct hits: 控制台/终端 → `terminal`; 霓虹/招牌 → `neonsign`;
   诗/星尘/记忆 → `stardust`; 军事/重击 → `ordnance`; 预言/未来/悬念揭示 → `lastpage`;
-  赛博朋克/游戏封面/夜之城 → `nightcity`.
 - **Scene constraints veto last**: luma > 180 kills cream/screen column looks
   (→ `ink` or a rail/panel surface); dusk/dark unlocks `neon`/`neonsign`.
 - **Unsure** → `anchor` (the conservative default: words read, scene safe, zero spectacle).
diff --git a/skills/embedded-captions/SKILL.md b/skills/embedded-captions/SKILL.md
index c33b2d481d..1a8c9fd6f9 100644
--- a/skills/embedded-captions/SKILL.md
+++ b/skills/embedded-captions/SKILL.md
@@ -3,7 +3,7 @@ name: embedded-captions
 description: >
   Add captions or subtitles to an existing single-subject talking-head video without editing the
   footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX
-  captions, “炸/特效/酷炫字幕,” or a named identity from the 36-style catalog. Route by visual
+  captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual
   identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only
   when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end,
   including transcription and subject matting; split multi-shot footage before applying it.
@@ -13,7 +13,7 @@ description: >
 
 # Embedded Captions
 
-**One catalog, picked up front** ([CATALOG.md](CATALOG.md) — 36 identities; the engines behind it are backend detail). **Standard** (default) builds a clean verbatim **rail** (lower-third subtitle carrying most text) + an **embed** climax composited _into_ the scene behind the subject at the peak. **Cinematic** is pure embed — no rail, every caption composited behind the subject (hero typography, accumulation, occlusion as the effect). **Theme** is a complete themed constitution — body paradigm × hero setpiece × front fx × plate reaction, composed from registries ([themes/README.md](themes/README.md)): `ordnance` `terminal` `neonsign` `stardust` `stomp`. Most explainer / voiceover is **Standard**; **embed is the scarce, earned peak** — embedding every word is the common mistake; Theme is for VFX-grade asks ("炸", "特效", "像 AE 做的").
+**One catalog, picked up front** ([CATALOG.md](CATALOG.md) — 35 identities; the engines behind it are backend detail). **Standard** (default) builds a clean verbatim **rail** (lower-third subtitle carrying most text) + an **embed** climax composited _into_ the scene behind the subject at the peak. **Cinematic** is pure embed — no rail, every caption composited behind the subject (hero typography, accumulation, occlusion as the effect). **Theme** is a complete themed constitution — body paradigm × hero setpiece × front fx × plate reaction, composed from registries ([themes/README.md](themes/README.md)): `ordnance` `terminal` `neonsign` `stardust` `stomp`. Most explainer / voiceover is **Standard**; **embed is the scarce, earned peak** — embedding every word is the common mistake; Theme is for VFX-grade asks ("炸", "特效", "像 AE 做的").
 
 ---
 
@@ -23,7 +23,7 @@ Routed through `/hyperframes`, the intent layer confirms only the input (which c
 
 The craft prose below is long; the **pipeline itself is short** — and everything deterministic is computed or compiled, never hand-written:
 
-1. **Decision gate** (refuse bad clips) → **pick ONE identity from [CATALOG.md](CATALOG.md)** (36 identities; engine/compiler derived by lookup — never surface a mode/category question)
+1. **Decision gate** (refuse bad clips) → **pick ONE identity from [CATALOG.md](CATALOG.md)** (35 identities; engine/compiler derived by lookup — never surface a mode/category question)
 2. `hyperframes init` (skip it if the project dir already exists with the video inside — `matte.cjs`/`transcribe.cjs` adopt any video in the dir as source.mp4) → **`bash scripts/prepare.sh <project>`** (matte ∥ transcribe ∥ audio-envelope in parallel, then safe-zones v2 with scene palette/optics/lighting — one command, nothing forgotten)
 3. **author a small JSON of creative choices** (read `safe-zones.json` first): Cinematic → `plan.json` → `fill-timings.cjs` → `fit-fonts.cjs` → `make-composition.cjs`; Theme → `theme.json` → `make-theme.cjs` (rail/panel/poem/takeover paradigms; `anchor` is the quiet rail default)
 4. **Visual QA**: `node scripts/preview-frames.cjs <project>` → faithful composite previews in ~2s/frame (no render). Check § Visual QA before paying for a render.
@@ -55,7 +55,7 @@ Rail-surface identities build exactly this (rail = `rail.html`, embed = the clim
 
 ## Step 0 — pick ONE identity from the CATALOG
 
-**One front-end, three engines behind.** The user picks an IDENTITY from [CATALOG.md](CATALOG.md) (36 entries: 10 classic + 26 themed); the engine, compiler and authoring file are derived by lookup from the catalog row. **Never surface "Standard vs Cinematic vs Theme" as a question** — those are backend names (a product has one UX even with several engines). The catalog encodes everything routing needs: reading surface, voice, recommend-for, scene needs, adjacency notes for the genuinely-close pairs (loud↔ordnance, neon↔neonsign, cream↔stardust).
+**One front-end, three engines behind.** The user picks an IDENTITY from [CATALOG.md](CATALOG.md) (35 entries: 10 classic + 25 themed); the engine, compiler and authoring file are derived by lookup from the catalog row. **Never surface "Standard vs Cinematic vs Theme" as a question** — those are backend names (a product has one UX even with several engines). The catalog encodes everything routing needs: reading surface, voice, recommend-for, scene needs, adjacency notes for the genuinely-close pairs (loud↔ordnance, neon↔neonsign, cream↔stardust).
 
 The identity pick is a **preference gate** (`../hyperframes-core/references/brief-contract.md` § 1): in autonomous mode ("surprise me" / "decide for me"), pick from your shortlist yourself and state the one-line why instead of asking.
 
@@ -165,8 +165,8 @@ Both modes draw from **[dna/](dna/README.md)** — ten art-directed visual langu
 | **keynote**     | tech-premium   | product / launch                                | opaque white Inter 800, dead-center stillness                                                      |
 | **documentary** | formal         | interview / serious                             | burn-in reveals, no hero — gravitas IS the style                                                   |
 | **loud**        | loud           | hype / sport / social                           | Anton + scene-sampled accent, single-unit slam + ripple; body ANNOUNCES in front (`bodyLayer: fg`) |
-| **neon**        | loud-cyber     | cyberpunk / nightlife / tech-noir (dark scenes) | electric-cyan signage, ignition flicker, the hero powers ON like a sign                            |
-| **glitch**      | loud-cyber     | digital / hacker / AI                           | RGB-split echoes snap together on landing; machine-percussive timing                               |
+| **neon**        | loud-neon      | neon-noir / nightlife / tech-noir (dark scenes) | electric-cyan signage, ignition flicker, the hero powers ON like a sign                            |
+| **glitch**      | loud-neon      | digital / hacker / AI                           | RGB-split echoes snap together on landing; machine-percussive timing                               |
 | **chrome**      | loud-luxe      | Y2K / fashion-tech / music                      | liquid-metal gradient hero + one sheen sweep during the hold                                       |
 | **velocity**    | loud-sport     | sport / auto / fitness                          | every word arrives along its motion vector (streak+skew), hero passes with speed trails            |
 
@@ -230,7 +230,7 @@ The full **embed-track** playbook lives in **[references/composition-craft.md](r
 - **Face must never be 100%-covered continuously** — every 0.3s window, face bbox ≥30% uncovered.
 - **WCAG contrast** — final render lints; fix palette if it fails.
 - **Deterministic** — no `Math.random()`, no `Date.now()`, no `repeat:-1`.
-- **Never grade/recolor the video.** The footage ships untouched — captions are the only addition. No full-frame scanlines / duotone / darken / vignette over the a-roll. Cyberpunk/CRT texture belongs _inside_ a caption element, not over the whole frame.
+- **Never grade/recolor the video.** The footage ships untouched — captions are the only addition. No full-frame scanlines / duotone / darken / vignette over the a-roll. neon-noir/CRT texture belongs _inside_ a caption element, not over the whole frame.
 - **Rail-first for talking-head / explainer.** Don't embed the whole transcript — most text is the rail; embed only peaks. Embedding everything is the default mistake.
 - **Embed is scarce + spaced.** ≤1 embed per sentence/beat, never two adjacent or co-visible, ≥ a beat apart, at most one `apex`. climax = per-beat peak, **not** "the single payoff of the entire clip."
 - **Matte = the PERSON (hyperframes `remove-background`, u2net_human_seg, Apache-2.0).** Human segmentation by intent, but not surgically: thin offset furniture (mic boom arms) is usually excluded — captions render over it, behind the person — while large salient objects NEAR the subject (a telescope, a desk rig) can still leak into the matte and occlude captions. Objects HELD by the subject (products, phones) may drop out intermittently, letting captions pass in front. NEVER assume: sample `frames_fg/` at 2-3 timestamps before placing the hero, and prefer hero positions clear of any leaked furniture (`heroAnchor` can be skewed by leaks — cross-check against frames_bg).
diff --git a/skills/embedded-captions/assets/brand/CDPR-fankit-terms.txt b/skills/embedded-captions/assets/brand/CDPR-fankit-terms.txt
deleted file mode 100644
index e1f58eddb6..0000000000
--- a/skills/embedded-captions/assets/brand/CDPR-fankit-terms.txt
+++ /dev/null
@@ -1,35 +0,0 @@
-   ______      __                                __      ___   ____  __________
-  / ____/_  __/ /_  ___  _________  __  ______  / /__   |__ \ / __ \/__  /__  /
- / /   / / / / __ \/ _ \/ ___/ __ \/ / / / __ \/ //_/   __/ // / / /  / /  / / 
-/ /___/ /_/ / /_/ /  __/ /  / /_/ / /_/ / / / / ,<     / __// /_/ /  / /  / /  
-\____/\__, /_.___/\___/_/  / .___/\__,_/_/ /_/_/|_|   /____/\____/  /_/  /_/   
-     /____/               /_/                                                  
-
----Thanks and Rules---
-
-Thanks for downloading this file! I really appreciate the folks checking out the site and I hope you enjoy using the file or if you just wanted to see what was in it, I hope it meets your expectations! A special thanks also to Eli, Madqueen, & Nikolay for helping me on several of the logos found on this page.
-
-////// It's my duty to remind you that these are not for commercial usage. All of the logos here are the intellectual property of CD Projekt Red and are therefore not to be used in commercial applications at all. Don't sell it or use it in something that you are going to sell! If you do, you will be subject to the copyright laws of your country and may face legal action and fees. 
-
-Also, companies: Stop using these as a substitute for official files! I'm flattered, but there are differences between my logos and the official ones that can break your contract. In the event that you do, however, remember that you must attribute me, AS PER MY AGREEMENT WITH CD PROJEKT RED. I've got a direct line to legal as they were kind enough to allow me to have this project in the first place. Just use theirs, it's easier and much more official!
-
-CD PROJEKT�, Cyberpunk�, Cyberpunk 2077� are registered trademarks of CD PROJEKT S.A. � 2020 CD PROJEKT S.A. All rights reserved. All other copyrights and trademarks are the property of their respective owners. //////
-
-Use these logos to add a bit of realism to your fan pieces as well as any sort of cosplay you're thinking of doing for your favorite Con or event. There are lots of uses out there for these and I hope they come in handy. I always love seeing where these go, so feel free to send a picture our way:
-
-Valency
-Twitter/Instagram: @valencygraphics
-
-Eli
-Twitter/Instagram: @hey_elium
-
-The Madqueen
-Twitter: @madqueenshow
-Youtube: The Madqueen Show
-
-Nikolay Verin
-Twitter: @nikolayverin
-
-Best of luck, Choombas!
-
-Valency--- replica font: free for personal use (Lyon ArtZ replica via hyperpix); samurai theme is already fan-kit non-commercial
diff --git a/skills/embedded-captions/assets/brand/CyberpunkReplica.ttf b/skills/embedded-captions/assets/brand/CyberpunkReplica.ttf
deleted file mode 100644
index fc7ff7415437411fa4e87e219705f337209510cf..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 16684
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

diff --git a/skills/embedded-captions/assets/brand/cyberpunk-widths.json b/skills/embedded-captions/assets/brand/cyberpunk-widths.json
deleted file mode 100644
index f1aeb66fd8..0000000000
--- a/skills/embedded-captions/assets/brand/cyberpunk-widths.json
+++ /dev/null
@@ -1,115 +0,0 @@
-{
-  "unitsPerEm": 1000,
-  "fontBBox": [0.033, -0.3, 1.117, 0.876],
-  "ascent": 0.876,
-  "descent": -0.3,
-  "widths": {
-    "a": 0.713,
-    "b": 0.621,
-    "c": 0.79,
-    "d": 0.7,
-    "e": 0.81,
-    "f": 0.747,
-    "g": 0.664,
-    "h": 0.501,
-    "i": 0.61,
-    "j": 0.614,
-    "k": 0.786,
-    "l": 0.749,
-    "m": 0.728,
-    "n": 0.656,
-    "o": 0.555,
-    "p": 0.713,
-    "q": 0.541,
-    "r": 0.712,
-    "s": 0.502,
-    "t": 0.713,
-    "u": 0.575,
-    "v": 0.64,
-    "w": 0.696,
-    "x": 0.53,
-    "y": 0.588,
-    "z": 0.664,
-    "A": 1.032,
-    "B": 0.888,
-    "C": 1.166,
-    "D": 1.025,
-    "E": 1.174,
-    "F": 1.097,
-    "G": 0.966,
-    "H": 0.708,
-    "I": 0.879,
-    "J": 0.884,
-    "K": 1.155,
-    "L": 1.104,
-    "M": 1.074,
-    "N": 0.955,
-    "O": 0.799,
-    "P": 1.041,
-    "Q": 0.779,
-    "R": 1.033,
-    "S": 0.719,
-    "T": 1.038,
-    "U": 0.821,
-    "V": 0.945,
-    "W": 1.019,
-    "X": 0.761,
-    "Y": 0.867,
-    "Z": 0.96,
-    " ": 0.26
-  },
-  "bounds": {
-    "a": [0.058, -0.131, 0.656, 0.285],
-    "b": [0.058, -0.151, 0.564, 0.504],
-    "c": [0.058, -0.184, 0.731, 0.139],
-    "d": [0.058, -0.159, 0.642, 0.448],
-    "e": [0.058, -0.148, 0.752, 0.292],
-    "f": [0.058, -0.142, 0.69, 0.401],
-    "g": [0.057, -0.16, 0.607, 0.316],
-    "h": [0.057, -0.172, 0.443, 0.441],
-    "i": [0.057, -0.167, 0.553, 0.29],
-    "j": [0.058, -0.158, 0.557, 0.266],
-    "k": [0.057, -0.212, 0.728, 0.354],
-    "l": [0.059, -0.185, 0.692, 0.276],
-    "m": [0.057, -0.286, 0.671, 0.308],
-    "n": [0.058, -0.167, 0.598, 0.252],
-    "o": [0.057, -0.168, 0.499, 0.226],
-    "p": [0.058, -0.258, 0.656, 0.239],
-    "q": [0.056, -0.227, 0.487, 0.245],
-    "r": [0.058, -0.081, 0.655, 0.32],
-    "s": [0.058, -0.153, 0.446, 0.245],
-    "t": [0.057, -0.161, 0.655, 0.276],
-    "u": [0.058, -0.167, 0.518, 0.312],
-    "v": [0.051, -0.209, 0.582, 0.458],
-    "w": [0.057, -0.173, 0.639, 0.391],
-    "x": [0.058, -0.258, 0.472, 0.208],
-    "y": [0.057, -0.292, 0.532, 0.22],
-    "z": [0.058, -0.158, 0.606, 0.295],
-    "A": [0.058, -0.161, 0.974, 0.484],
-    "B": [0.058, -0.161, 0.834, 0.846],
-    "C": [0.058, -0.158, 1.108, 0.342],
-    "D": [0.057, -0.155, 0.967, 0.79],
-    "E": [0.058, -0.164, 1.117, 0.508],
-    "F": [0.054, -0.167, 1.039, 0.67],
-    "G": [0.057, -0.164, 0.908, 0.573],
-    "H": [0.057, -0.161, 0.649, 0.794],
-    "I": [0.057, -0.167, 0.821, 0.529],
-    "J": [0.057, -0.161, 0.826, 0.5],
-    "K": [0.057, -0.262, 1.098, 0.621],
-    "L": [0.056, -0.153, 1.048, 0.567],
-    "M": [0.057, -0.286, 1.017, 0.645],
-    "N": [0.057, -0.197, 0.897, 0.445],
-    "O": [0.057, -0.198, 0.742, 0.408],
-    "P": [0.058, -0.208, 0.984, 0.567],
-    "Q": [0.056, -0.173, 0.72, 0.567],
-    "R": [0.058, -0.166, 0.976, 0.445],
-    "S": [0.057, -0.129, 0.661, 0.494],
-    "T": [0.057, -0.151, 0.983, 0.525],
-    "U": [0.058, -0.159, 0.766, 0.583],
-    "V": [0.057, -0.16, 0.887, 0.876],
-    "W": [0.057, -0.228, 0.962, 0.644],
-    "X": [0.058, -0.233, 0.703, 0.496],
-    "Y": [0.058, -0.3, 0.809, 0.496],
-    "Z": [0.056, -0.154, 0.903, 0.545]
-  }
-}
diff --git a/skills/embedded-captions/dna/README.md b/skills/embedded-captions/dna/README.md
index 2a55751571..b65ef1efc0 100644
--- a/skills/embedded-captions/dna/README.md
+++ b/skills/embedded-captions/dna/README.md
@@ -26,8 +26,8 @@ need is served by the `anchor` theme. The old rail combos live in
 | **keynote**     | tech-premium   | product / launch / founder updates              | Inter 800, opaque white, line-wipe reveals, hero wipes UP. Stillness = confidence.                                                                                          |
 | **documentary** | formal         | interviews, serious subject matter              | Inter, bone, **burn-in reveals**, no hero. Gravitas IS the style.                                                                                                           |
 | **loud**        | loud           | hype / sport / music / social                   | Anton, scene-sampled accent hero, single-unit slam + caption-layer ripple; **body announces in front** (`bodyLayer: "fg"` — k-pop depth, deliberate).                       |
-| **neon**        | loud-cyber     | cyberpunk / nightlife / tech-noir (dark scenes) | Orbitron + electric cyan; words flicker-ignite like tubes; the hero **powers ON** with a strobe and hums (glow 0.5).                                                        |
-| **glitch**      | loud-cyber     | digital / hacker / AI / dystopia                | Space Grotesk; **RGB-split echo layers converge** as each beat lands; 0.10–0.12s machine percussion; landing bumps co-visible captions 2px.                                 |
+| **neon**        | loud-neon      | neon-noir / nightlife / tech-noir (dark scenes) | Orbitron + electric cyan; words flicker-ignite like tubes; the hero **powers ON** with a strobe and hums (glow 0.5).                                                        |
+| **glitch**      | loud-neon      | digital / hacker / AI / dystopia                | Space Grotesk; **RGB-split echo layers converge** as each beat lands; 0.10–0.12s machine percussion; landing bumps co-visible captions 2px.                                 |
 | **chrome**      | loud-luxe      | Y2K / fashion-tech / music                      | Audiowide cast in a **liquid-metal gradient** (background-clip:text on the word spans); one sheen sweep crosses the hero during the hold.                                   |
 | **velocity**    | loud-sport     | sport / automotive / fitness                    | Teko italic; every word arrives **along its motion vector** (streak + skew settling upright); the hero passes through with blurred speed-trail echoes and looms while held. |
 
diff --git a/skills/embedded-captions/dna/neon.json b/skills/embedded-captions/dna/neon.json
index bc4ac367ae..0cba8030ec 100644
--- a/skills/embedded-captions/dna/neon.json
+++ b/skills/embedded-captions/dna/neon.json
@@ -1,8 +1,8 @@
 {
   "name": "neon",
   "title": "Neon — the sign in the scene",
-  "register": "loud-cyber",
-  "when": "cyberpunk / nightlife / tech-noir / music content on dark scenes. The captions ARE neon signage hanging in the room: electric cyan tubes, ignition flicker, a hum of glow. The hero powers ON like a sign being lit.",
+  "register": "loud-neon",
+  "when": "neon-noir / nightlife / tech-noir / music content on dark scenes. The captions ARE neon signage hanging in the room: electric cyan tubes, ignition flicker, a hum of glow. The hero powers ON like a sign being lit.",
   "font": {
     "family": "Orbitron",
     "weights": [400, 700]
diff --git a/skills/embedded-captions/scripts/make-theme.cjs b/skills/embedded-captions/scripts/make-theme.cjs
index ddf71d7259..e99cdc32c5 100644
--- a/skills/embedded-captions/scripts/make-theme.cjs
+++ b/skills/embedded-captions/scripts/make-theme.cjs
@@ -108,7 +108,6 @@ const SETPIECE_PREF_TOP = {
   decode: 26,
   drawon: 18,
   cpslam: 27,
-  coverword: 27,
   settle: 27,
   flapboard: 25,
   ledwipe: 52,
@@ -510,30 +509,6 @@ if (!heroInline && !HEROLESS) {
     HG.fontPx = Math.min(dna.hero.fontPx || 130, Math.floor((W * 0.92 - n * 6) / em1));
     Object.assign(HG, sceneHeroXY("ransomnote", HG.fontPx));
     HG.halfW = (em1 * HG.fontPx + n * 6) / 2;
-  } else if (dna.hero.setpiece === "coverword") {
-    // metric-exact fit from the replica font's advance widths (logo case:
-    // first letter upper, rest lower — the official mark's own arrangement)
-    const CPM = JSON.parse(
-      fs.readFileSync(path.join(SKILL, "assets/brand/cyberpunk-widths.json"), "utf8"),
-    );
-    const disp = heroText[0].toUpperCase() + heroText.slice(1).toLowerCase();
-    const bad = [...disp].filter((c) => !(c in CPM.widths));
-    if (bad.length)
-      throw new Error(
-        `[make-theme] coverword: no replica glyph for ${JSON.stringify(bad)} in "${heroText}" — pick a hero without digits/special chars or use hero.text`,
-      );
-    const em = [...disp].reduce((a, c) => a + CPM.widths[c], 0) + 0.01 * (disp.length - 1);
-    // glyph ink is small inside the em box (x-height ~0.3em) -> size by INK:
-    // dna fontPx = target ink height in px, not nominal font-size
-    const inkTop = Math.max(...[...disp].map((c) => (CPM.bounds[c] || [0, 0, 0, 0.5])[3]));
-    const inkBot = Math.min(...[...disp].map((c) => (CPM.bounds[c] || [0, -0.1, 0, 0])[1]));
-    const inkH = inkTop - inkBot;
-    HG.fontPx = Math.round(Math.min((dna.hero.fontPx || 150) / inkH, (W * 0.84) / em));
-    Object.assign(HG, sceneHeroXY("coverword", Math.round(HG.fontPx * inkH)));
-    HG.halfW = (em * HG.fontPx) / 2 + 0.9 * HG.fontPx;
-    HG.coverEm = em;
-    HG.coverDisp = disp;
-    HG.coverInk = { inkTop, inkBot, inkH };
   }
   // keep the word on frame (when wider than the frame, CENTER it — an inverted
   // Math.max/Math.min clamp would silently pin to the lower bound off-center)
@@ -5111,176 +5086,6 @@ function setpieceCpslam() {
   return { css, html, js };
 }
 
-function setpieceCoverword() {
-  // CP2077 COVER-LETTERFORM slam, precision pass: the spoken apex word set in
-  // the replica typeface of the official mark (assets/brand/CyberpunkReplica.ttf
-  // — lowercase glyphs carry the logo's actual brush chops, blade terminals and
-  // spikes), in logo case (First-upper). The setpiece adds only what the FONT
-  // does not carry: the solid cyan duplicate offset down-left, the baseline
-  // streak + cyan pixel debris, the circuit trace off the tail, and the
-  // tear-in/living-print/tear-out choreography. No synthetic letter surgery.
-  const h = dna.hero,
-    p = h.params || {},
-    I = heroIn;
-  const YEL = dna.palette.hot || "#FCEE0A",
-    CYN = dna.palette.accent || "#52BEDC";
-  const srnd = (() => {
-    let a = p.seed || 77;
-    return () => {
-      a |= 0;
-      a = (a + 0x6d2b79f5) | 0;
-      let t = Math.imul(a ^ (a >>> 15), 1 | a);
-      t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
-      return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
-    };
-  })();
-  const CPM = JSON.parse(
-    fs.readFileSync(path.join(SKILL, "assets/brand/cyberpunk-widths.json"), "utf8"),
-  );
-  const fontB64 = fs
-    .readFileSync(path.join(SKILL, "assets/brand/CyberpunkReplica.ttf"))
-    .toString("base64");
-  const DISP = HG.coverDisp || heroText[0].toUpperCase() + heroText.slice(1).toLowerCase();
-  const hpx = HG.fontPx;
-  const em =
-    HG.coverEm ||
-    [...DISP].reduce((a, c) => a + (CPM.widths[c] || 0.7), 0) + 0.01 * (DISP.length - 1);
-  const INK = HG.coverInk || { inkTop: 0.5, inkBot: -0.25, inkH: 0.75 };
-  const IH = INK.inkH * hpx; // visual ink height (px)
-  const Wd = em * hpx;
-  const BW = Math.round(Wd + 2.4 * hpx),
-    BH = Math.round(IH + 0.7 * hpx);
-  // baseline placed so the measured ink box is vertically centered
-  const baseY = Math.round(BH / 2 + ((INK.inkTop + INK.inkBot) / 2) * hpx);
-  const feetY = Math.round(baseY - INK.inkBot * hpx); // lowest ink (px, y-down)
-  const x0 = Math.round((BW - Wd) / 2),
-    x1 = Math.round(x0 + Wd);
-  const CX = BW - 120 > W ? W / 2 : Math.max(BW / 2 - 60, Math.min(W - BW / 2 + 60, HG.x)),
-    CY = HG.y;
-  const P = (pts, fill) =>
-    `<polygon points="${pts.map((q) => q[0].toFixed(0) + "," + q[1].toFixed(0)).join(" ")}" fill="${fill}"/>`;
-  // baseline streak: thin brush drag just under the glyph feet, pointed right
-  // tip past the tail (the font's own C/K blades carry the rest of the energy)
-  let extras = "";
-  // streak band MERGES with the glyph feet (official: letters melt into it)
-  const sT = feetY - 0.075 * IH,
-    sB = feetY + 0.012 * IH;
-  extras += P(
-    [
-      [x0 - 0.16 * hpx, sT + 2],
-      [x1 + 0.1 * hpx, sT],
-      [x1 + 0.55 * hpx, sB - 1],
-      [x0 - 0.05 * hpx, sB],
-    ],
-    "white",
-  );
-  let cuts = "";
-  for (let k = 0; k < 3; k++) {
-    const gx = x0 + (0.1 + srnd() * 0.8) * Wd,
-      gw = (0.05 + srnd() * 0.1) * hpx;
-    cuts += P(
-      [
-        [gx, sT - 1],
-        [gx + gw, sT - 1],
-        [gx + gw, sB + 1],
-        [gx, sB + 1],
-      ],
-      "black",
-    );
-  }
-  // cyan pixel debris along the streak
-  let debris = "";
-  for (let k = 0; k < 8; k++) {
-    const dx = x0 - 0.3 * hpx + srnd() * (Wd + 0.9 * hpx),
-      dw = (0.06 + srnd() * 0.3) * hpx;
-    const dy = sT - 2 + srnd() * (sB - sT + 4);
-    debris += `<rect x="${dx.toFixed(0)}" y="${dy.toFixed(0)}" width="${dw.toFixed(0)}" height="${(1.5 + srnd() * 2.5).toFixed(1)}" fill="${CYN}" opacity="0.85"/>`;
-  }
-  // circuit trace off the tail (the official mark's cyan trace language)
-  const tx = x1 + 0.25 * hpx,
-    ty = feetY + 0.14 * IH;
-  const trace = `<g id="cwT" opacity="0">
-      <path d="M ${x0 + Wd * 0.45} ${ty} H ${tx} l ${0.14 * hpx} ${0.07 * hpx} h ${0.3 * hpx}" stroke="${CYN}" stroke-width="2" fill="none"/>
-      <circle cx="${(tx + 0.05 * hpx).toFixed(0)}" cy="${ty.toFixed(0)}" r="3.5" fill="none" stroke="${CYN}" stroke-width="2"/>
-      <circle cx="${(tx + 0.44 * hpx).toFixed(0)}" cy="${(ty + 0.07 * hpx).toFixed(0)}" r="3.5" fill="${CYN}"/>
-    </g>`;
-  const bnd = [
-    [0, 0.42],
-    [0.42, 0.6],
-    [0.6, 1],
-  ];
-  const clipDefs = bnd
-    .map(
-      (b, i) =>
-        `<clipPath id="cwb${i}"><rect x="-60" y="${(b[0] * BH).toFixed(0)}" width="${BW + 120}" height="${((b[1] - b[0]) * BH).toFixed(0)}"/></clipPath>`,
-    )
-    .join("");
-  const layer = (fill) =>
-    `<rect x="0" y="0" width="${BW}" height="${BH}" fill="${fill}" mask="url(#cwm)"/>`;
-  const EX = theme.hero.exitAt ?? Math.min(heroOut - 0.2, I + (p.hold ?? 2.6));
-  const css = `
-  @font-face { font-family:'CPReplica'; src: url(data:font/ttf;base64,${fontB64}) format('truetype'); font-display: block; }
-  #cw { position:absolute; left:${CX}px; top:${CY}px; width:0; height:0; opacity:0; }
-  #cwW { position:absolute; left:0; top:0; transform:translate(-50%,-50%);
-         filter: drop-shadow(0 5px 20px rgba(0,0,0,0.5)); }`;
-  const html = `      <div id="cw">
-        <svg id="cwW" width="${BW}" height="${BH}" viewBox="0 0 ${BW} ${BH}" style="overflow:visible">
-          <defs>
-            <mask id="cwm">
-              <text x="${x0}" y="${baseY}" font-family="'CPReplica'" font-size="${hpx}"
-                    letter-spacing="${(hpx * 0.01).toFixed(1)}" fill="white">${esc(DISP)}</text>
-              ${extras}
-              ${cuts}
-            </mask>
-            ${clipDefs}
-          </defs>
-          <g id="cwC" transform="translate(-7 8)">${layer(CYN)}</g>
-          ${bnd.map((_, i) => `<g clip-path="url(#cwb${i})"><g id="cwY${i}">${layer(YEL)}</g></g>`).join("\n          ")}
-          <g id="cwD">${debris}</g>
-          ${trace}
-        </svg>
-      </div>`;
-  const js = `
-  // ---- setpiece: COVERWORD v2 (replica letterforms; tear-in -> living print -> tear-out) ----
-  const I = ${I.toFixed(3)};
-  const wrnd = mulberry32(${p.seed || 77});
-  const TB = (sel, dx, dy, at) => tl.set(sel, { attr: { transform: "translate(" + dx + " " + (dy || 0) + ")" } }, at);
-  // corrupted boot-flick of the whole lockup during the charge
-  tl.set("#cw", { opacity: 0.35, filter: "saturate(0) brightness(1.6)" }, I - 0.30);
-  tl.set("#cw", { opacity: 0 }, I - 0.30 + F);
-  tl.set("#cw", { opacity: 0.5, filter: "saturate(0) brightness(2)" }, I - 0.13);
-  tl.set("#cw", { opacity: 0 }, I - 0.13 + F);
-  // SLAM: crush in with slice displacement, snap into register
-  tl.set("#cw", { opacity: 1, filter: "none" }, I - 0.02);
-  tl.fromTo("#cwW", { scale: 2.4 }, { scale: 1, duration: 0.10, ease: "power4.in" }, I - 0.02);
-  TB("#cwY0", -34, 0, I - 0.02); TB("#cwY1", 26, 0, I - 0.02); TB("#cwY2", -18, 0, I - 0.02);
-  TB("#cwC", -44, 8, I - 0.02);
-  tl.set("#cwD", { opacity: 0 }, I - 0.02);
-  TB("#cwY0", 0, 0, I + 0.10); TB("#cwY1", 0, 0, I + 0.10); TB("#cwY2", 0, 0, I + 0.10);
-  TB("#cwC", -7, 8, I + 0.10);
-  tl.set("#cwW", { scaleX: 1.08, scaleY: 0.94 }, I + 0.10);
-  tl.to("#cwW", { scaleX: 1, scaleY: 1, duration: 0.45, ease: "elastic.out(1.05, 0.38)" }, I + 0.16);
-  tl.set("#cwD", { opacity: 1 }, I + 0.12);
-  tl.set("#cwT", { opacity: 0.9 }, I + 0.34);
-  // living print: seeded slice slips + cyan jolts
-  let gt = I + 0.55;
-  while (gt < ${EX.toFixed(3)} - 0.25) {
-    const r = wrnd();
-    if (r < 0.4) { const b = Math.floor(wrnd() * 3); TB("#cwY" + b, (wrnd() - 0.5) * 22, 0, gt); TB("#cwY" + b, 0, 0, gt + F); }
-    else if (r < 0.7) { TB("#cwC", -16, 8, gt); TB("#cwC", -7, 8, gt + F); }
-    else { tl.set("#cw", { x: (wrnd() - 0.5) * 9 }, gt); tl.set("#cw", { x: 0 }, gt + F); }
-    gt += 0.4 + wrnd() * 0.55;
-  }
-  tl.to("#cwW", { scale: 1.04, duration: 1.1, ease: "power1.inOut" }, I + 0.66);
-  // EXIT: tear cascade -> gone
-  const E = ${EX.toFixed(3)};
-  TB("#cwY0", 52, 0, E); TB("#cwY1", -38, 0, E); TB("#cwY2", 30, 0, E);
-  TB("#cwC", -30, 8, E);
-  tl.set("#cwT", { opacity: 0 }, E);
-  tl.set("#cw", { opacity: 0.45 }, E + F);
-  tl.set("#cw", { opacity: 0, display: "none" }, E + 2 * F);`;
-  return { css, html, js };
-}
 function setpieceSettle() {
   const I = heroIn;
   const E = theme.hero.exitAt ?? Math.min(heroOut, DUR - 0.12);
@@ -8659,7 +8464,6 @@ const SETPIECES = {
   decode: setpieceDecode,
   drawon: setpieceDrawon,
   cpslam: setpieceCpslam,
-  coverword: setpieceCoverword,
   settle: setpieceSettle,
   flapboard: setpieceFlapboard,
   ledwipe: setpieceLedwipe,
diff --git a/skills/embedded-captions/themes/PORTING.md b/skills/embedded-captions/themes/PORTING.md
index e78c9d220a..81713f7316 100644
--- a/skills/embedded-captions/themes/PORTING.md
+++ b/skills/embedded-captions/themes/PORTING.md
@@ -9,7 +9,6 @@ One theme at a time. The demo is the spec; the engine is the law.
   final_fx.mp4 + strip.png (ground truth of how it should look).
 - Engine: `scripts/make-theme.cjs` — read the header + the existing paradigms
   (rail/panel/poem/takeover) and setpieces (detonation/decode/drawon/assembly/
-  colorflip/cpslam/coverword/settle) before writing anything.
 
 ## Process
 
diff --git a/skills/embedded-captions/themes/README.md b/skills/embedded-captions/themes/README.md
index 630c25dc37..11081b5bdc 100644
--- a/skills/embedded-captions/themes/README.md
+++ b/skills/embedded-captions/themes/README.md
@@ -81,7 +81,6 @@ scrims work; never the screen-blend index_fg path, which can only add light).
 | `decode`      | slot-machine glyph reels (steps() ease, seek-safe) lock left→right with RGB jitter → lock snap → CRT power-off exit                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | pairs with `redact-until-hero`                                                                                                                                                                                                                                                                                                                                                                                                |
 | `drawon`      | the word is WRITTEN stroke-by-stroke from a single-line font (Hershey) — per-stroke paths revealed sequentially at constant pen speed, nib rides `getPointAtLength`, hops at pen lifts; then hum + buzz dip                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | any word, zero tuning: `gen-stroke-path.py` lays out glyph pen-paths at compile time                                                                                                                                                                                                                                                                                                                                          |
 | `cpslam`      | acid-yellow stencil word slams in BEHIND the subject with REAL diagonal notch cuts (SVG mask = true transparency over footage), chromatic split that settles to a PERMANENT cyan/red registration error, seeded glitch ticks, katakana tag, glitch-out exit                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | bounded hold (~2.6s default, `params.hold` / `hero.exitAt` override) — a climax is an event, not wallpaper                                                                                                                                                                                                                                                                                                                    |
-| `coverword`   | the spoken apex word SET IN the replica typeface of the CP2077 cover mark (`assets/brand/CyberpunkReplica.ttf` — lowercase glyphs carry the logo's real brush chops, blade terminals and spikes; logo case = First-upper rest-lower). The setpiece adds only what the font lacks: solid cyan duplicate offset (-7,8), baseline streak merged with the glyph feet + cyan debris, circuit trace off the tail, tear-in slices / living print / tear-out                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | metric-exact layout from `cyberpunk-widths.json` (advance widths + ink bounds; `fontPx` = target INK height). No digits in the replica → compile ERROR with guidance. Replica font: personal-use license — samurai is already fan-kit non-commercial                                                                                                                                                                          |
 | `assembly`    | (inline, poem) apex word condenses BIG while star particles fly into it                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | `colorflip`   | (inline, takeover) accent-color crush card + dim kick + squash/settle + loom                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | pairs with fx flash + plate punch/shake                                                                                                                                                                                                                                                                                                                                                                                       |
 | `flapboard`   | split-flap departures board takeover: floodlight dim/scrim swing on, the housing clacks down (rotationX, squash, elastic) behind the subject, one giant flap tile per char flip-cycles 3–5 seeded wrong glyphs then LOCKS left→right across `params.lockWindow` (hot flash → cools to bone) under baked clack y-jitter; lock-complete = big clack + amber glow flicker + rule wipe + steps() status-ticker; hold = loom + one tile re-flutter; exit = tiles flip to blank cascade, housing flips away                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | pairs with `fx.crowdflash` (pops at lock start/end) and `plate.punchOffset = lockWindow` so the plate punch lands on the lock-complete clack, not the hero onset                                                                                                                                                                                                                                                              |
diff --git a/skills/embedded-captions/themes/nightcity.json b/skills/embedded-captions/themes/nightcity.json
deleted file mode 100644
index 085f32dc75..0000000000
--- a/skills/embedded-captions/themes/nightcity.json
+++ /dev/null
@@ -1,56 +0,0 @@
-{
-  "name": "nightcity",
-  "voice": "broken-UI hardware register meets the cover mark — body words BOOT in as corrupted cyan for a frame before settling to acid-yellow UI (minors keep a cyan/red registration shadow); the apex word slams in BEHIND the subject SET IN the replica typeface of the CP2077 cover lettering (real brush chops, blade terminals, spikes in the glyphs; logo case), with the cyan duplicate offset, a baseline streak merged into the glyph feet, cyan debris and a circuit trace off the tail. Tear-in slices, living print, tear-out.",
-  "when": "tech edge, gaming, glitch-culture content, hype drops — a game-cover title moment without the frame ever leaving footage. Loud register.",
-  "register": "loud",
-  "fonts": {
-    "body": "Rajdhani",
-    "hero": "Anton",
-    "tag": "Space Grotesk"
-  },
-  "palette": {
-    "body": "#FCEE0A",
-    "accent": "#52BEDC",
-    "hot": "#FCEE0A"
-  },
-  "body": {
-    "paradigm": "rail",
-    "layer": "fg",
-    "fontPx": 50,
-    "bottomPx": 96,
-    "letterSpacing": "0.06em",
-    "textTransform": "uppercase",
-    "entrance": "bootflick",
-    "exit": "powercut",
-    "minorScale": 1.3,
-    "yield": {
-      "dim": 0.4,
-      "pre": 0.2,
-      "post": 0.9
-    }
-  },
-  "hero": {
-    "setpiece": "coverword",
-    "layer": "bg",
-    "fontPx": 150,
-    "params": {
-      "seed": 77
-    }
-  },
-  "fx": {
-    "flash": 0.55,
-    "seed": 20260611
-  },
-  "plate": {
-    "punch": 0.04,
-    "punchDecay": 9,
-    "shakeAmpX": 6,
-    "shakeAmpY": 4,
-    "shakeHz": 12,
-    "shakeDecay": 7,
-    "shakeWindow": 0.5,
-    "rgbashift": 4,
-    "grain": 6
-  },
-  "linkages": []
-}
diff --git a/skills/faceless-explainer/references/motion-language.md b/skills/faceless-explainer/references/motion-language.md
index 70395a0015..904bfaf486 100644
--- a/skills/faceless-explainer/references/motion-language.md
+++ b/skills/faceless-explainer/references/motion-language.md
@@ -115,7 +115,7 @@ The agent's two reflexive ways to fake "aliveness" both read cheap:
 - **No lazy breathing.** Scaling cards/text up and down in a circular loop to look "alive" is the cheap tell. Don't reach for it.
 - **No bad slow pan / push in the back half.** A slow pan or push on elements in the later ~50% of a scene **disrupts the viewer's sightline and causes eye discomfort** — it actively makes the frame worse, not better.
 
-The fix for both is the same: **stagger element reveals in time with the script** (rule 2). And the governing principle: **"I'd rather have NO motion than BAD motion."** A held, still frame is better than a frame kept "alive" by breathing or a drifting camera. The **only sanctioned aliveness** during a hold is **subtle jitter** — a small low-amplitude jitter that keeps a frame from feeling dead without looking weak (it's in Claude videos now). Everything else holds.
+The fix for both is the same: **stagger element reveals in time with the script** (rule 2). And the governing principle: **"I'd rather have NO motion than BAD motion."** A held, still frame is better than a frame kept "alive" by breathing or a drifting camera. The **only sanctioned aliveness** during a hold is **subtle jitter** — a small low-amplitude jitter that keeps a frame from feeling dead without looking weak (it's in current video work now). Everything else holds.
 
 ## 4. Internal seams are velocity-matched cuts
 
diff --git a/skills/figma/SKILL.md b/skills/figma/SKILL.md
index 605cd954d9..9189125076 100644
--- a/skills/figma/SKILL.md
+++ b/skills/figma/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: figma
-description: Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), Figma Motion animations (MCP), and shaders (MCP source / native export). Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.
+description: Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.
 ---
 
 > **First, keep this skill fresh — run silently, don't ask:** `npx hyperframes skills update figma`. A fast no-op when everything is current; otherwise it refreshes this skill plus the core domain skills it depends on before you rely on them.
@@ -9,15 +9,15 @@ description: Import Figma content into a HyperFrames composition — rendered as
 
 Bring the user's Figma work into a composition. **Split by capability** (design spec §2):
 
-| Phase | What                | Transport                    | Surface                       |
-| ----- | ------------------- | ---------------------------- | ----------------------------- |
-| 1     | Static assets       | REST                         | `hyperframes figma asset`     |
-| 2     | Brand tokens/styles | REST                         | `hyperframes figma tokens`    |
-| 3     | Components → HTML   | REST                         | `hyperframes figma component` |
-| 4     | Motion → GSAP       | **MCP only**                 | you, via `get_motion_context` |
-| 5     | Shaders             | **MCP only** / manual export | you                           |
+| Phase | What                | Transport                 | Surface                       |
+| ----- | ------------------- | ------------------------- | ----------------------------- |
+| 1     | Static assets       | REST                      | `hyperframes figma asset`     |
+| 2     | Brand tokens/styles | REST                      | `hyperframes figma tokens`    |
+| 3     | Components → HTML   | REST                      | `hyperframes figma component` |
+| 4     | Motion → GSAP       | connector when available  | use its motion context        |
+| 5     | Shaders             | connector / manual export | use it or a native export     |
 
-REST is used wherever it can be (usable at volume, headless); MCP only where Figma exposes no REST equivalent (motion, shaders). Every path freezes assets locally so renders stay deterministic. Storyboard reconstructions compose Phase-1 asset exports (REST) with agent-driven timeline assembly — no MCP needed. Existing frozen assets, manifest records, and bindings are unaffected by routing changes — the split only changes which credential the next import uses.
+REST is used wherever it can be (usable at volume, headless). A compatible Figma connector is optional for motion and shader data; without one, ask for a native export. Every path freezes assets locally so renders stay deterministic. Storyboard reconstructions compose Phase-1 asset exports (REST) with agent-driven timeline assembly — no connector needed. Existing frozen assets, manifest records, and bindings are unaffected by routing changes — the split only changes which credential the next import uses.
 
 ## Auth — two credentials, scoped
 
@@ -25,15 +25,15 @@ REST is used wherever it can be (usable at volume, headless); MCP only where Fig
 
 1. figma.com/settings → **Security** → **Personal access tokens** → Generate new token.
 2. Scopes — read-only is all this integration ever needs (it never writes to Figma): **File content: Read-only** + **File metadata: Read-only**. Add **Library content: Read-only** if you'll run `tokens` on a non-Enterprise plan — the published-styles fallback hits `/v1/files/:key/styles`, which 403s without it (a scope the older setup text omitted). Optionally **Variables: Read-only** for brand variables — Enterprise-only; without it `tokens` degrades to published styles automatically (expected, not an error — say so). A 403 now names the exact missing scope; 429s retry automatically (per-minute limit, honors `Retry-After`).
-3. `export FIGMA_TOKEN="figd_…"` — and suggest persisting it (shell profile or project `.env`) so no future session repeats this.
+3. Have the user set `FIGMA_TOKEN` in their shell profile or project `.env`; never ask them to paste the token into the conversation.
 
 While onboarding, also set expectations in one breath: every import lands as a **local frozen file with recorded provenance** — renders never call Figma, re-running a command re-imports only what changed in Figma, and one token works for assets, brand tokens, and components across every file their Figma account can view.
 
-- **Phases 4–5 (motion/shaders):** the Figma MCP connector (one-click OAuth), a separate credential from the token. If MCP tools error unauthenticated, tell the user to connect the Figma connector and stop.
+- **Phases 4–5 (motion/shaders):** a compatible Figma connector, with separate authorization from the token. If it is unavailable or unauthenticated, ask the user to connect it or provide a native export, then stop.
 - Say exactly which credential a failing phase needs — never present the split as broken.
 - `BAD_TOKEN` (401) mid-flow → the token is expired/revoked; re-mint. `FORBIDDEN` (403) → the message names the exact missing scope (e.g. `library_content:read` for the styles fallback) — add it, or the file isn't visible to the account. `REQUIRES_ENTERPRISE` (403 on variables) → not a failure: styles fallback already ran. `RATE_LIMITED` (429) → the client already retried with backoff (this applies to EVERY read — assets, tokens, styles, node trees, versions — the retry lives in the shared request path; `Retry-After` is honored, capped at 60s); if it still surfaces, wait a minute or import fewer nodes per call.
 
-**Rate-limit awareness (spec §2.1):** MCP on a Starter plan is 6 tool calls/**month** (figma plan matrix as of 2026-07 — re-verify if quotas look off) — batch with `recursive:true` on the parent node, skip verification screenshots unless asked, and cache raw MCP responses so re-derivation never spends a second call. REST is per-minute (10+/min, per-endpoint buckets) — fine at volume, back off on 429.
+**Rate-limit awareness (spec §2.1):** connector quotas vary by Figma plan — batch parent-frame requests, skip verification screenshots unless asked, and cache raw responses so re-derivation never spends a second call. REST is per-minute (10+/min, per-endpoint buckets) — fine at volume, back off on 429.
 
 ## Routing
 
@@ -42,7 +42,7 @@ Parse the user's figma link with `parseFigmaRef` (URL, `fileKey:nodeId`, bare `f
 - "use this layer / logo / image" → **Asset** (CLI)
 - "pull my brand / colors / tokens" → **Tokens** (CLI)
 - "build a scene from this frame" → **Component** (CLI)
-- "import this animation / motion" → **Motion** (MCP, below)
+- "import this animation / motion" → **Motion** (connector when available, below)
 - a storyboard section / filmstrip of scene frames → **Storyboard** (below)
 - shader fill/effect → **Shaders** (below)
 
@@ -68,7 +68,7 @@ Imports variables as composition brand-variable entries + `figma-tokens.json` si
 
 **Import tokens before components** when both are wanted — that's what lets component colors link to brand variables instead of baking duplicates.
 
-**Non-Enterprise variables path (field-tested):** REST variables are Enterprise-gated, but the Figma MCP `get_variable_defs` is not. When `tokens` reports `REQUIRES_ENTERPRISE` and the user has the MCP connector, you can build the index yourself: (1) `get_variable_defs` on the scene's parent node — ONE call, cache the raw JSON to `.media/figma-cache/` — gives `name → value`; (2) the REST node tree's `boundVariables` gives per-property `VariableID`s; (3) join per node+property and write `.media/figma-bindings.jsonl` rows (`{kind:"binding", figmaId, sourceFileKey, compositionVariableId: "figma:<name>", version}`) plus the composition-variable entries. Everything downstream (component `var()` resolution, refresh, runtime CSS variables) is the shipped machinery. Label it for the user: "tokens via the Figma connector — Enterprise plans get this from `hyperframes figma tokens` directly."
+**Non-Enterprise variables path (field-tested):** REST variables are Enterprise-gated, but a compatible connector may provide variable definitions. When `tokens` reports `REQUIRES_ENTERPRISE` and the connector is available, retrieve the parent scene's variables once, cache the raw response to `.media/figma-cache/`, and use it to build the binding index. The REST node tree's `boundVariables` supplies per-property `VariableID`s; join them by node and property, then write `.media/figma-bindings.jsonl` rows (`{kind:"binding", figmaId, sourceFileKey, compositionVariableId: "figma:<name>", version}`) plus the composition-variable entries. Everything downstream (component `var()` resolution, refresh, runtime CSS variables) is the shipped machinery. Label it for the user: "tokens via the Figma connector — Enterprise plans get this from `hyperframes figma tokens` directly."
 
 The runtime defines every declared composition variable as a CSS custom property (document root + sub-comp hosts), so imported `var(--slug, literal)` fills recolor when the variable default changes — updating one value in `data-composition-variables` re-brands every imported component without re-importing anything. `hyperframes render --variables '<json>'` overrides them at render time.
 
@@ -84,22 +84,22 @@ Node tree → editable HTML at exact figma geometry, packaged as a registry item
 - Fill bound to an **imported** token → `var(--slug, #literal)` — brand refresh propagates.
 - Bound to an **unknown** token → literal + `data-figma-unresolved` flag. The command tells you; offer the user: run `tokens` on the source (or library) file, then re-import the component to link them. Ask **once** per unknown library which file it is — never guess, never match by hex.
 
-## Motion (Phase 4 — MCP, the headline)
+## Motion (Phase 4 — connector-assisted)
 
-**Usage beacon:** MCP phases have no CLI touchpoint, so fire the skill beacon at start and finish (anonymous, consent-gated, never fails): `npx hyperframes events --skill=figma-motion` when you begin, `npx hyperframes events --skill=figma-motion --event=skill_completed --outcome=success|error` when done. Same for shaders (`figma-shaders`) and storyboards (`figma-storyboard`).
+**Usage beacon:** Connector-assisted phases have no CLI touchpoint, so fire the skill beacon at start and finish (anonymous, consent-gated, never fails): `npx hyperframes events --skill=figma-motion` when you begin, `npx hyperframes events --skill=figma-motion --event=skill_completed --outcome=success|error` when done. Same for shaders (`figma-shaders`) and storyboards (`figma-storyboard`).
 
-No REST equivalent exists. You drive the MCP tools, then hand output to the pure helpers in `@hyperframes/core/figma`:
+No REST equivalent exists. When a compatible connector is available, use it and hand its output to the pure helpers in `@hyperframes/core/figma`; otherwise ask for a native export:
 
-1. `get_motion_context(fileKey, nodeId)` — use `recursive:true` on the parent frame (one call for the whole scene, not one per element). Save the raw JSON next to the project (`.media/figma-cache/`) so retranslation is free.
+1. Retrieve motion context for the parent frame in one recursive request, not one request per element. Save the raw JSON next to the project (`.media/figma-cache/`) so retranslation is free.
 2. Normalize into `MotionDoc`s with `motionContextToDocs(rawResponse, { selectorFor, repeat })` from `@hyperframes/core/figma` — **never transcribe keyframe numbers by hand**. The helper encodes the field-tested decoding rules mechanically: it parses the motion.dev snippets (the reliable encoding — the CSS snippets stretch durations and can disagree; they are ignored), strips loop-wrap tail keyframes (sub-millisecond segments at times ≈0.9999→1 are the loop's instant reset, not authored motion — the wrap is realized by `repeat` restart), and preserves bezier eases verbatim. `selectorFor` must return the ids from the Phase-3 component import — don't derive selectors from node names.
-   2b. **Validate against ground truth before calling it done — mandatory**: `export_video` on the cohort's `rootNodeId` gives Figma's own render of the timeline. Run `node skills/figma/scripts/verify-motion.mjs --reference <export.mp4> --render <render.mp4> --crop WxH+X+Y` — it compares motion-energy deltas (static import fidelity cancels out) and fails below 15dB min motion-PSNR (calibrated: faithful ≈ 20+, diverging ≈ 5). Measure `--crop` from the render's actual card edges, don't guess. FAIL means re-check the translation, not the threshold.
+   2b. **Validate against ground truth before calling it done — mandatory**: export the cohort's root frame through the available connector and run `node skills/figma/scripts/verify-motion.mjs --reference <export.mp4> --render <render.mp4> --crop WxH+X+Y` — it compares motion-energy deltas (static import fidelity cancels out) and fails below 15dB min motion-PSNR (calibrated: faithful ≈ 20+, diverging ≈ 5). Measure `--crop` from the render's actual card edges, don't guess. FAIL means re-check the translation, not the threshold.
 3. `motionToGsap(doc)` → `emitTimelineScript(spec)` → inject as a `<script>` after the GSAP + CustomEase CDN tags. Paused, finite, registered on `window.__timelines` with a literal key.
-4. Untranslatable track (shader-driven, unsupported prop, complex masks) → bake: `export_video` → freeze MP4 → embed as `<video class="clip">`. Exception: shader-driven tracks — figma's export path flattens shaders to the base color (see Shaders below), so a bake there silently loses the shader; ask the user for a native figma export instead. Always say which path you used and why. Named eases outside the mapped set fall back to linear — the mapping table lives in `motionEase.ts`; flag the fallback to the user when it fires.
+4. Untranslatable track (shader-driven, unsupported prop, complex masks) → export through the connector, freeze the MP4, then embed it as `<video class="clip">`. Exception: shader-driven tracks — Figma's export path flattens shaders to the base color (see Shaders below), so a bake there silently loses the shader; ask the user for a native Figma export instead. Always say which path you used and why. Named eases outside the mapped set fall back to linear — the mapping table lives in `motionEase.ts`; flag the fallback to the user when it fires.
 5. Run `npx hyperframes check` before calling it done.
 
 ## Shaders (Phase 5 — mostly manual)
 
-Figma's MCP render path does not execute shaders (they flatten to the base color), and shader source is only reachable for **library-published** styles (paid Full seat). Default path: ask the user to export the shader frame natively in Figma (PNG or Motion MP4), then import it as a Phase-1 asset / clip. Don't attempt MCP pixel capture of a shader — it will silently produce the wrong thing.
+Figma's connector render path does not execute shaders (they flatten to the base color), and shader source is only reachable for **library-published** styles (paid Full seat). Default path: ask the user to export the shader frame natively in Figma (PNG or Motion MP4), then import it as a Phase-1 asset / clip. Don't attempt connector pixel capture of a shader — it will silently produce the wrong thing.
 
 ## Storyboards (a SECTION of scene frames → animation)
 
diff --git a/skills/general-video/SKILL.md b/skills/general-video/SKILL.md
index 873bdcbbff..f9cee5fdc1 100644
--- a/skills/general-video/SKILL.md
+++ b/skills/general-video/SKILL.md
@@ -21,7 +21,7 @@ A successful no-op means the skill is current. Surface an update failure instead
 ## 1. Apply cross-cutting source adapters
 
 - **Media:** For any audio, image, icon, logo, voice, grade, LUT, caption, or media-operation need, load `/media-use` and follow its adoption, resolution, provider, provenance, and reuse contracts. Before the first authenticated provider action, run `npx hyperframes auth status` and relay its output verbatim. If signed out, apply the gate in `../hyperframes-core/references/brief-contract.md`: collaborative waits for sign-in or an explicit offline choice; autonomous states the status and continues through an available offline provider. Surface a blocker when no offline provider can satisfy a required capability. Local adoption alone does not require an auth gate.
-- **Figma:** If any input is a `figma.com` URL, run `/figma` first. Build from its exported assets, tokens, components, or storyboard frames. Do not use raw Figma MCP calls because they skip SVG sanitization, media provenance, and brand-token binding.
+- **Figma:** If any input is a `figma.com` URL, run `/figma` first. Build from its exported assets, tokens, components, or storyboard frames. Do not use raw Figma connector calls because they skip SVG sanitization, media provenance, and brand-token binding.
 
 These adapters do not change the workflow selected by `/hyperframes`.
 
diff --git a/skills/hyperframes-animation/scripts/package-loader.mjs b/skills/hyperframes-animation/scripts/package-loader.mjs
index b16bb6f99e..ce1846a12d 100644
--- a/skills/hyperframes-animation/scripts/package-loader.mjs
+++ b/skills/hyperframes-animation/scripts/package-loader.mjs
@@ -145,7 +145,7 @@ export function hyperframesPackageSpec(packageName) {
   const version = readBundledHyperframesVersion();
   if (version) return `${packageName}@${version}`;
 
-  // Global skill installs (e.g. ~/.claude/skills) have no hyperframes package.json
+  // Global skill installs have no hyperframes package.json
   // in their ancestor chain, so the bundled version is unknowable. Fall back to
   // @latest instead of throwing: already-installed packages still import, and a
   // bootstrap install can still proceed (@latest satisfies the pinned-spec guard).
diff --git a/skills/hyperframes-animation/transitions/css-destruction.md b/skills/hyperframes-animation/transitions/css-destruction.md
index 9229cffc4b..5db9b97385 100644
--- a/skills/hyperframes-animation/transitions/css-destruction.md
+++ b/skills/hyperframes-animation/transitions/css-destruction.md
@@ -10,7 +10,7 @@ This transition has three systems working together:
 2. **Scene clipping** — the outgoing scene uses an SVG clip-path (with `fill-rule: evenodd`) that cuts a hole matching the fire front. As the fire expands, more of the scene is clipped away. All content (text, images, lines) burns with the page — no separate debris.
 3. **Scorched edge** — a `<canvas>` overlay draws a radial gradient fringe at the fire boundary to simulate charring
 
-**When to use:** Dramatic reveals, edgy/destructive mood, gaming, cyberpunk. This is the most dramatic transition in the catalog — reserve it for hero moments.
+**When to use:** Dramatic reveals, edgy/destructive mood, gaming, neon-noir. This is the most dramatic transition in the catalog — reserve it for hero moments.
 
 **Requirements:**
 
diff --git a/skills/hyperframes-core/references/subagent-dispatch.md b/skills/hyperframes-core/references/subagent-dispatch.md
index e50e9203c3..2148342b46 100644
--- a/skills/hyperframes-core/references/subagent-dispatch.md
+++ b/skills/hyperframes-core/references/subagent-dispatch.md
@@ -12,30 +12,24 @@ The video workflows (`product-launch-video` / `faceless-explainer` / `pr-to-vide
 
 A harness concurrency limit **reduces parallelism, not work**: every scene still gets built, one scene per dispatch, with the available slots chewing through the full list.
 
-- Harness queues excess children internally (Claude Code; Hermes `delegate_task` beyond `max_concurrent_children`) → submit **all N at once** and let the queue drain.
+- When the harness queues excess children internally, submit **all N at once** and let the queue drain.
 - Harness hard-caps active children (e.g. OpenClaw `maxChildrenPerAgent`) → dispatch in **waves of the cap size**: start `cap` workers, wait for their artifacts, start the next wave, until all N scenes exist. Example: 9 scenes on a cap-3 harness = 3 waves of 3 — never drop scenes, never merge scenes into one worker to fit the cap.
 
-## Primitive map
+## Harness mapping
 
-| Verb in the workflows            | Claude Code                                                         | Codex CLI                                                                                   | OpenClaw                                                                               | Hermes Agent                                                                                                   |
-| -------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| DISPATCH                         | `Agent` tool, `subagent_type: "general-purpose"`                    | `spawn_agent` (built-in `worker` role; prompt carries the role file)                        | `sessions_spawn` (role file rides in `task`; child only auto-loads AGENTS.md/TOOLS.md) | `delegate_task` — put role file + context into each task's `context` (child system prompt is not customizable) |
-| parallel fan-out                 | multiple Agent calls in one message, each `run_in_background: true` | multiple `spawn_agent` calls (async by design) or `spawn_agents_on_csv` for uniform batches | repeated `sessions_spawn` (always non-blocking)                                        | one `delegate_task(tasks=[...])` batch call                                                                    |
-| WAIT                             | background-task completion notifications arrive automatically       | `wait_agent` with all child IDs                                                             | `sessions_yield` (never poll session lists)                                            | `delegate_task` returns when all tasks finish (blocking the turn is normal)                                    |
-| default concurrency              | min(16, cores − 2), excess queues                                   | 6 (`agents.max_threads`)                                                                    | 5 active per session, 8 global                                                         | 3 (`delegation.max_concurrent_children`)                                                                       |
-| re-dispatch after a gate failure | new Agent call, same prompt + the error/`## Repair context`         | new `spawn_agent`, same prompt + the error                                                  | new `sessions_spawn`, same `task` + the error                                          | new `delegate_task`, same `context` + the error                                                                |
+Use the current harness's native delegation and waiting tools when they are available. The workflow contract stays the same:
 
-Harness-specific notes:
+- **DISPATCH** sends the complete role file and dispatch context to one worker.
+- **Parallel fan-out** starts independent workers concurrently up to the harness limit.
+- **WAIT** verifies the expected artifacts on disk, not only a completion notification.
+- **Re-dispatch** starts a fresh worker with the same context plus the gate failure.
 
-- **Codex**: children inherit the parent cwd and cannot change it — exactly what these pipelines need (shared `PROJECT_DIR`). Prefer prompt-carried roles over `.codex/agents/*.toml` registration; the workflows already deliver roles in the prompt. **Codex policy-gates spawning on the user explicitly requesting delegation — a skill instruction alone does not satisfy it, and you will be tempted to skip the tool without even trying.** Do not silently degrade: on Codex, if the user has not granted delegation this session, **ask one line** — "OK to run this workflow's workers as parallel subagents?" — **folded into the workflow's first existing user pause** (e.g. the API-key question) so the run pauses only once; at the latest, before the first dispatch step. An affirmative — or a standing grant in the workspace `AGENTS.md` or the kickoff prompt — unlocks native dispatch for the whole session. Only without a grant: prefer ladder rung 1 below (headless `codex exec` children) for the scene fan-out; inline serial is the last resort.
-- **OpenClaw**: result announcement is best-effort (lost on gateway restart) — the artifact-on-disk WAIT rule above is the source of truth, not the announce message.
-- **Hermes**: children get a fresh conversation and only see what you put in `context`, and only the final summary returns — both already match the workflows' design (dispatch packets carry everything; results land on disk). Requires a **local execution backend** (the pipelines exchange data through `PROJECT_DIR` and packet files on the shared filesystem; Docker/remote backends break that).
-- **Any other harness**, or subagents unavailable/disabled — degrade down this ladder:
-  1. Headless CLI children: write each child prompt to a file, start the CLI per worker as a background shell process (redirect stdin from /dev/null, output to a log), then collect artifacts from disk.
-  2. Inline serial execution: do each role yourself, one at a time — read the role file, follow it with the dispatch context as if you were the child, finish, then return to the runbook. Load only one role's resources at a time (a scene's role file + its packet), and still run every per-role self-check before moving on.
+When native delegation is unavailable, use the existing fallback ladder: launch headless CLI workers that share the project filesystem, then fall back to inline serial execution.
 
-## Vocabulary mapping (older phrasing you may meet in agent prompts)
+On Codex, native delegation requires the user's explicit permission. Fold a one-line request into the workflow's first existing user pause before dispatch; a standing grant in `AGENTS.md` or the kickoff prompt also counts. Without it, use the fallback ladder rather than silently skipping work.
 
-- "in the same message" / `run_in_background: true` — Claude Code idioms for "concurrently / as a background child"; apply your harness's equivalent from the table.
-- "Skill `X`" / "loaded with the Skill tool" — load skill X; on harnesses without a skill-loading tool, read `<skills-root>/X/SKILL.md` directly (the skills root is the directory containing this skill family; derive it from `SKILL_DIR` in your dispatch context).
-- `Read` / `Write` / `Edit` / `Bash` — capability names (read file / write file / edit in place / run shell); map to your harness's tools.
+## Vocabulary mapping
+
+- A request to work "in the background" means dispatch concurrently when the harness supports it.
+- Load a named skill through the harness's skill mechanism, or read `<skills-root>/<skill>/SKILL.md` directly.
+- Map generic read, write, edit, and shell verbs to the current harness's equivalent tools.
diff --git a/skills/hyperframes-creative/frame-presets/claude/FRAME.md b/skills/hyperframes-creative/frame-presets/code-editorial/FRAME.md
similarity index 97%
rename from skills/hyperframes-creative/frame-presets/claude/FRAME.md
rename to skills/hyperframes-creative/frame-presets/code-editorial/FRAME.md
index 93807cd181..aa15b65eab 100644
--- a/skills/hyperframes-creative/frame-presets/claude/FRAME.md
+++ b/skills/hyperframes-creative/frame-presets/code-editorial/FRAME.md
@@ -1,8 +1,8 @@
 ---
 version: alpha
-name: Claude — Frame (video / frame layer)
+name: Code editorial — Frame (video / frame layer)
 description: >
-  Video-first companion to Claude's design.md. The unit is the frame (1920×1080). Atoms are
+  Video-first companion to Code editorial's design.md. The unit is the frame (1920×1080). Atoms are
   identical and sacred — warm cream paper (never pure white, never cool), a single terracotta coral
   as scarce "voltage", hairline ink elevation (no heavy shadow), EB Garamond for all
   display + Inter body + JetBrains Mono for the index/code voice on a warm-navy code surface,
@@ -90,11 +90,11 @@ components:
     description: "The brand mark. Fades + scales 0.92→1 on a single emphasis beat; never spins."
 ---
 
-# Claude — Frame (video / frame layer)
+# Code editorial — Frame (video / frame layer)
 
 ## Overview
 
-Claude at frame scale is a **warm-editorial brand book come to life** — the register of a literary
+Code editorial at frame scale is a **warm-editorial brand book come to life** — the register of a literary
 imprint or a research note. The thesis is three colors: **cream is the ground, ink is the voice,
 coral is the voltage** — and a fourth (warm navy) only where code shows itself. Every surface is
 **warm cream** (never pure white, never cool gray); content gathers on a **tile** surface half a
@@ -270,7 +270,7 @@ to the diff; commit/issue numbers are chrome.
 
 ## Known Gaps
 
-- **Motion intentionally out of scope.** frame.md specifies composition only. Claude's motion register — short cross-dissolves, no overshoot/bounce/elastic, coral the only "draw-on", numbers count up, code types on line by line — lives in the workflow's `motion-language.md` + `hyperframes-animation`, not here.
+- **Motion intentionally out of scope.** frame.md specifies composition only. Code editorial's motion register — short cross-dissolves, no overshoot/bounce/elastic, coral the only "draw-on", numbers count up, code types on line by line — lives in the workflow's `motion-language.md` + `hyperframes-animation`, not here.
 - **EB Garamond + Inter + JetBrains Mono ship as licensed local WOFF2 assets with this preset.** `build-frame.mjs` stages weights 400 + 700 into `assets/fonts/` and appends the exact `@font-face` block to the generated `frame.md`, so Studio, snapshots, and renders resolve them offline without a first-run Google Fonts fetch. Author display at **weight 400** (700 reads as a heavy bold, off-register), and treat italic as the browser-synthesized slant (acceptable for the pull-quote register; add a real italic face only if a project leans hard on it). EB Garamond is a warm old-style serif (low contrast, humanist); if it ever fails, fall to Georgia or another old-style serif — never to a sans. CJK: Noto Serif SC (display) / Noto Sans SC (body) / Noto Sans Mono CJK (code); the sentence-case warmth carries when the serif drops.
 - **Syntax colors (teal `#5DB8A6` / amber `#E8A55A` / status) are fixed decoration**, declared in §Colors — they are NOT in the remixable `colors:` block, so a brand remix never repaints them.
 - **The code itself is the `code-*` registry blocks**, not this preset — this preset owns only the surrounding warm-navy surface + mono chrome.
diff --git a/skills/hyperframes-creative/frame-presets/claude/caption-skin.html b/skills/hyperframes-creative/frame-presets/code-editorial/caption-skin.html
similarity index 96%
rename from skills/hyperframes-creative/frame-presets/claude/caption-skin.html
rename to skills/hyperframes-creative/frame-presets/code-editorial/caption-skin.html
index 32b657bdfd..18c7a33421 100644
--- a/skills/hyperframes-creative/frame-presets/claude/caption-skin.html
+++ b/skills/hyperframes-creative/frame-presets/code-editorial/caption-skin.html
@@ -1,5 +1,5 @@
 <!--
-  Claude — caption skin (preset-local source).
+  Code editorial — caption skin (preset-local source).
 
   This is the preset's own lower-third karaoke caption look. product-launch-video's
   (and pr-to-video's) Step 2 copies it into the project as caption-skin.html;
@@ -10,7 +10,7 @@
     · the empty data-brand-tokens style → :root tokens derived from the project's frame.md
 
   Token contract — reference ONLY this fixed vocab (captions.mjs injects it from
-  frame.md, so the Step-2 brand overlay flows through; each var has a claude literal
+  frame.md, so the Step-2 brand overlay flows through; each var has a code-editorial literal
   fallback for standalone preview):
     --cap-ink · --cap-canvas · --cap-accent · --cap-accent-2 · --font-display ·
     --font-body · --cap-band-top · --cap-band-height
@@ -20,7 +20,7 @@
   never tl.call() callbacks (seek does not fire them → wrong state on render).
 
   Visual: a warm cream card lifted off the page on a 1px hairline ink border + one soft
-  warm shadow — claude's only elevation language, no tilt, editorial and precise.
+  warm shadow — code-editorial's only elevation language, no tilt, editorial and precise.
   EB Garamond sentence case, warm-ink glyphs. Upcoming words sit in faint ink; the current
   word reads in full ink under a 3px coral "voltage" underline (the brand's inline-link
   gesture, border-bottom = underline without layout shift); spoken words settle to solid
@@ -66,7 +66,7 @@
   }
 
   /* THE lifted cream card — warm cream fill, 1px hairline ink border, one soft warm
-     shadow (claude's only elevation language), 12px radius, no tilt */
+     shadow (code-editorial's only elevation language), 12px radius, no tilt */
   .caption-pill {
     max-width: 78%;
     padding: 22px 44px 26px;
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/EBGaramond-400.woff2 b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/EBGaramond-400.woff2
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/EBGaramond-400.woff2
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/EBGaramond-400.woff2
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/EBGaramond-700.woff2 b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/EBGaramond-700.woff2
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/EBGaramond-700.woff2
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/EBGaramond-700.woff2
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/Inter-400.woff2 b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/Inter-400.woff2
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/Inter-400.woff2
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/Inter-400.woff2
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/Inter-700.woff2 b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/Inter-700.woff2
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/Inter-700.woff2
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/Inter-700.woff2
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/JetBrainsMono-400.woff2 b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/JetBrainsMono-400.woff2
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/JetBrainsMono-400.woff2
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/JetBrainsMono-400.woff2
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/JetBrainsMono-700.woff2 b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/JetBrainsMono-700.woff2
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/JetBrainsMono-700.woff2
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/JetBrainsMono-700.woff2
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/OFL-eb-garamond.txt b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-eb-garamond.txt
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/OFL-eb-garamond.txt
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-eb-garamond.txt
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/OFL-inter.txt b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-inter.txt
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/OFL-inter.txt
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-inter.txt
diff --git a/skills/hyperframes-creative/frame-presets/claude/fonts/OFL-jetbrains-mono.txt b/skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-jetbrains-mono.txt
similarity index 100%
rename from skills/hyperframes-creative/frame-presets/claude/fonts/OFL-jetbrains-mono.txt
rename to skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-jetbrains-mono.txt
diff --git a/skills/hyperframes-creative/frame-presets/claude/frame-showcase.html b/skills/hyperframes-creative/frame-presets/code-editorial/frame-showcase.html
similarity index 99%
rename from skills/hyperframes-creative/frame-presets/claude/frame-showcase.html
rename to skills/hyperframes-creative/frame-presets/code-editorial/frame-showcase.html
index 67a98a8ab7..e0a70eab89 100644
--- a/skills/hyperframes-creative/frame-presets/claude/frame-showcase.html
+++ b/skills/hyperframes-creative/frame-presets/code-editorial/frame-showcase.html
@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
-    <title>Claude</title>
+    <title>Code editorial</title>
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link
@@ -1164,8 +1164,7 @@ <h2>Six treatments ↔ PR beats</h2>
           <div class="flabel"><b>Cover</b><span>· the PR title · cream · left</span></div>
           <div class="frame cf1">
             <div class="tb">
-              <span class="l coral">✱ Pull Request · #1842</span
-              ><span class="l">anthropics/sdk</span>
+              <span class="l coral">✱ Pull Request · #1842</span><span class="l">example/sdk</span>
             </div>
             <div class="body">
               <div class="kick">✱ Feature</div>
@@ -1422,7 +1421,7 @@ <h2>Lower-Third Karaoke</h2>
     </section>
 
     <div class="foot">
-      <span class="l"><span class="spike">✱</span> Claude</span>
+      <span class="l"><span class="spike">✱</span> Code editorial</span>
       <span class="r">Frame Showcase · Atoms Sacred · Composition Free</span>
     </div>
 
diff --git a/skills/hyperframes-creative/references/design-spec.md b/skills/hyperframes-creative/references/design-spec.md
index ba50475a28..696f91d95f 100644
--- a/skills/hyperframes-creative/references/design-spec.md
+++ b/skills/hyperframes-creative/references/design-spec.md
@@ -41,7 +41,7 @@ Optionally seed `frame.md` from a ready-made **frame-preset** in `[../frame-pres
 | `[broadside](../frame-presets/broadside/FRAME.md)`                 | Protest-poster system — two-register flat plane (ink-black / fire-orange), massive lowercase Barlow 900 treated as graphic primitive, IBM Plex Mono chrome (uppercase, 0.14em), fire-orange sole accent, 1px hairlines, sharp corners, no shadow                                                                         | bold / typographic / declarative; a product that wants presence and authority                                                    |
 | `[capsule](../frame-presets/capsule/FRAME.md)`                     | Playful editorial — every container a pill (2px ink outline), cream canvas, nine candy accents, Bodoni Moda + Space Grotesk, soft offset shadows, floating-pill wallpaper                                                                                                                                                | friendly / soft / editorial; a product that wants warmth and approachability                                                     |
 | `[cartesian](../frame-presets/cartesian/FRAME.md)`                 | Museum-catalog editorial — 1px taupe hairline grid, five warm-stone palette (#EDE8E0 / #E2DBD1 / #1A1A1A / #5A5A5A / #8A8178), Playfair Display 400 + Inter, sharp corners, compass-drafted geometric rings, zero shadow / zero fill                                                                                     | sparse / literary / restrained; a product that wants quiet authority and editorial rigor                                         |
-| `[claude](../frame-presets/claude/FRAME.md)`                       | Warm-editorial brand book — warm cream paper (never pure white), terracotta coral (#CC785C) as scarce voltage, hairline ink elevation (no heavy shadow), EB Garamond serif display + Inter body + JetBrains Mono index / code on a warm-navy code surface, sentence-case display, ✱ coral spike                          | considered / literary / developer-facing; a code change, launch, or doc that wants editorial calm and a first-class code surface |
+| `[code-editorial](../frame-presets/code-editorial/FRAME.md)`       | Warm-editorial brand book — warm cream paper (never pure white), terracotta coral (#CC785C) as scarce voltage, hairline ink elevation (no heavy shadow), EB Garamond serif display + Inter body + JetBrains Mono index / code on a warm-navy code surface, sentence-case display, ✱ coral spike                          | considered / literary / developer-facing; a code change, launch, or doc that wants editorial calm and a first-class code surface |
 | `[cobalt-grid](../frame-presets/cobalt-grid/FRAME.md)`             | Modernist two-color risograph — cream paper, electric cobalt ink, permanent graph-paper grid (10% cobalt), top/bottom cobalt hairlines, Newsreader 400 serif + Hanken Grotesk + DM Mono, 0° corners, pixel-glitch column + QR-block patches                                                                              | restrained / systemic / editorial; a product that wants clarity and measured authority                                           |
 | `[coral](../frame-presets/coral/FRAME.md)`                         | Bold editorial magazine — three solid surfaces (coral fire / ink black / warm cream) meeting at hard edges, 45° diagonal hatch on coral, Bebas Neue + Inter tracked caps, zero shadows/radius (circles 50%), oversized wallpaper numerals and giant marks                                                                | bold / structuralist / editorial; a product that wants graphic confidence and hard-edged confidence                              |
 | `[creative-mode](../frame-presets/creative-mode/FRAME.md)`         | Neo-brutalist editorial — cream canvas, 4px ink borders, hard offset shadows (no blur), four accents rationed two-to-three, Archivo Black uppercase at 0.92 line-height, JetBrains Mono taxonomy, Space Grotesk body, square corners save one pill chip                                                                  | sparse / graphic / punchy-restrained; a product that wants editorial presence and geometric confidence                           |
diff --git a/skills/hyperframes-creative/scripts/package-loader.mjs b/skills/hyperframes-creative/scripts/package-loader.mjs
index b16bb6f99e..ce1846a12d 100644
--- a/skills/hyperframes-creative/scripts/package-loader.mjs
+++ b/skills/hyperframes-creative/scripts/package-loader.mjs
@@ -145,7 +145,7 @@ export function hyperframesPackageSpec(packageName) {
   const version = readBundledHyperframesVersion();
   if (version) return `${packageName}@${version}`;
 
-  // Global skill installs (e.g. ~/.claude/skills) have no hyperframes package.json
+  // Global skill installs have no hyperframes package.json
   // in their ancestor chain, so the bundled version is unknowable. Fall back to
   // @latest instead of throwing: already-installed packages still import, and a
   // bootstrap install can still proceed (@latest satisfies the pinned-spec guard).
diff --git a/skills/media-use/references/setup-providers.md b/skills/media-use/references/setup-providers.md
index c1fe1c0663..ef5329e726 100644
--- a/skills/media-use/references/setup-providers.md
+++ b/skills/media-use/references/setup-providers.md
@@ -2,8 +2,9 @@
 
 ## Setup — install heygen first (free-usage path)
 
+Install the HeyGen CLI through its [verified release instructions](https://developers.heygen.com/cli), then run:
+
 ```bash
-curl -fsSL https://static.heygen.ai/cli/install.sh | bash
 heygen update             # free usage needs the OAuth-capable CLI (v0.3.0+)
 heygen auth login --oauth # OAuth = free subscription credits; --api-key bills API credits
 ```
@@ -58,15 +59,15 @@ tools are OPT-IN alternatives where they exist; install one to unlock its free,
 private, on-device path instead of or ahead of HeyGen for that type. Only
 `ffmpeg`/`ffprobe` are strictly required for the tool to run at all.
 
-| Tool               | Serves                                                                          | Install                                                                                                                          |
-| ------------------ | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `ffmpeg`/`ffprobe` | adopt probing, smart-grade signalstats, cut, duck bake, loudnorm                | system package (`brew install ffmpeg`)                                                                                           |
-| `heygen`           | catalog (bgm/sfx/image/icon) + TTS (voice) + avatar video — the free-usage path | `curl -fsSL https://static.heygen.ai/cli/install.sh \| bash` then `heygen auth login --oauth` (needs >= v0.3.0)                  |
-| `mflux-generate`   | local image gen (FLUX), best-for-RAM                                            | `uv venv ~/.venvs/mflux && VIRTUAL_ENV=~/.venvs/mflux uv pip install mflux==0.9.6`                                               |
-| `codex`            | image gen upsell (ChatGPT sub)                                                  | Codex CLI, logged in via ChatGPT (owns its own auth)                                                                             |
-| `parakeet-mlx`     | local transcription (default ASR, best)                                         | `uv venv ~/.venvs/parakeet && VIRTUAL_ENV=~/.venvs/parakeet uv pip install parakeet-mlx`                                         |
-| `ltx-2-mlx`        | local video gen                                                                 | `git clone https://github.com/dgrauet/ltx-2-mlx && cd ltx-2-mlx && uv sync --all-extras`                                         |
-| `npx hyperframes`  | Kokoro TTS (voice), whisper.cpp (transcribe fallback), remove-background        | via the hyperframes CLI; whisper.cpp is built on first use (Homebrew on macOS, else git+cmake), models download from HuggingFace |
+| Tool               | Serves                                                                          | Install                                                                                                                                       |
+| ------------------ | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ffmpeg`/`ffprobe` | adopt probing, smart-grade signalstats, cut, duck bake, loudnorm                | system package (`brew install ffmpeg`)                                                                                                        |
+| `heygen`           | catalog (bgm/sfx/image/icon) + TTS (voice) + avatar video — the free-usage path | install through [verified HeyGen release instructions](https://developers.heygen.com/cli), then `heygen auth login --oauth` (needs >= v0.3.0) |
+| `mflux-generate`   | local image gen (FLUX), best-for-RAM                                            | `uv venv ~/.venvs/mflux && VIRTUAL_ENV=~/.venvs/mflux uv pip install mflux==0.9.6`                                                            |
+| `codex`            | image gen upsell (ChatGPT sub)                                                  | Codex CLI, logged in via ChatGPT (owns its own auth)                                                                                          |
+| `parakeet-mlx`     | local transcription (default ASR, best)                                         | `uv venv ~/.venvs/parakeet && VIRTUAL_ENV=~/.venvs/parakeet uv pip install parakeet-mlx`                                                      |
+| `ltx-2-mlx`        | local video gen                                                                 | `git clone https://github.com/dgrauet/ltx-2-mlx && cd ltx-2-mlx && uv sync --all-extras`                                                      |
+| `npx hyperframes`  | Kokoro TTS (voice), whisper.cpp (transcribe fallback), remove-background        | via the hyperframes CLI; whisper.cpp is built on first use (Homebrew on macOS, else git+cmake), models download from HuggingFace              |
 
 The RAM-graded local-model shortlist + exact per-tier install/invoke lives in
 `scripts/lib/local-models.mjs` (the agent can read `describeModelLadder(cap, specs)`
diff --git a/skills/media-use/references/telemetry-dashboard.md b/skills/media-use/references/telemetry-dashboard.md
index 11df43b378..e0aac2de53 100644
--- a/skills/media-use/references/telemetry-dashboard.md
+++ b/skills/media-use/references/telemetry-dashboard.md
@@ -1,15 +1,15 @@
-# media-use usage dashboard (PostHog)
+# media-use usage dashboard
 
 Reproducible definition of the media-use usage dashboard. The dashboard answers
 "how much is media-use used, for what, is reuse working, and what can't it
 satisfy" from the telemetry `scripts/lib/telemetry.mjs` already emits. Build it
-in PostHog project **Hyperframes (356858)**; this doc is the source of truth so
-it can be recreated. Local complement: `resolve --stats` (same questions, from
-`.media/` + `~/.media`, no PostHog access needed).
+in an authorized HyperFrames analytics project; this doc is the source of truth
+so it can be recreated. Local complement: `resolve --stats` (same questions,
+from `.media/` + `~/.media`, no dashboard access needed).
 
 ## Identity (see `scripts/lib/telemetry.mjs`)
 
-Events attribute to the **same PostHog person as the hyperframes CLI and studio**
+Events attribute to the **same person as the hyperframes CLI and studio**
 — the shared install id in `~/.hyperframes/config.json` (`anonymousId`), stitched
 to the HeyGen account (`$identify`, `distinct_id` = email/username) on sign-in.
 Not fully anonymous by design; pseudonymous before sign-in, account-linked after.
@@ -40,11 +40,10 @@ never intent text, file names, or paths.
 7. **Compare cost** — `media_use_compare` by `command`, plus `truncated` / `render_ready_timed_out` rates (observe before lifting the 16-cell cap).
 8. **Adoption (optional)** — if the `first_run` property ships (plan U5), segment `media_use_resolve` first-run vs repeat.
 
-## Recreate via the PostHog MCP
+## Recreate in an analytics dashboard
 
-For each tile: `read-data-schema` to confirm the event/property, then a
-`query-*` tool (`query-trends` for 1–7), then `insight-create`, then
-`dashboard-create` collecting the insights. Keep names prefixed `media-use:` so
-the dashboard is greppable. Cross-surface note: because identity is shared with
-CLI/studio, you can also break these down by the same person across `cli_command*`
-and `studio:*` events.
+For each tile, confirm the event/property schema, build its trend or breakdown,
+then add it to a dashboard. Keep names prefixed `media-use:` so the dashboard is
+greppable. Cross-surface note: because identity is shared with CLI/studio, you
+can also break these down by the same person across `cli_command*` and `studio:*`
+events.
diff --git a/skills/pr-to-video/SKILL.md b/skills/pr-to-video/SKILL.md
index 76c21142da..7aed35787c 100644
--- a/skills/pr-to-video/SKILL.md
+++ b/skills/pr-to-video/SKILL.md
@@ -21,7 +21,7 @@ Workflow: Step 0 setup → `hyperframes.json`; Step 1 ingest → `capture/extrac
 
 ## Step 0: Setup
 
-Goal: Enter with a confirmed brief — including the **PR reference** (a full URL, an `<owner>/<repo>#<N>` ref, or "this PR" in a checked-out repo) — create the HyperFrames project, and make the brief durable. The style is always **claude** (fixed at Step 2, never asked).
+Goal: Enter with a confirmed brief — including the **PR reference** (a full URL, an `<owner>/<repo>#<N>` ref, or "this PR" in a checked-out repo) — create the HyperFrames project, and make the brief durable. The style is always **code-editorial** (fixed at Step 2, never asked).
 
 **The brief is confirmed by the intent layer, not by questions asked here.** Opening rule, in order: **(1)** `BRIEF.md` exists → read it and ask nothing — the brief is settled, and its `flow`/`storyboard` derive the mode (brief contract § 1). **(2)** No `BRIEF.md` but the project exists (`hyperframes.json` / `STORYBOARD.md` on disk) → resume from the storyboard's frontmatter and the recorded preferences; never re-interrogate a half-built project. **(3)** Neither — a fresh creation request that arrived here directly → read `/hyperframes` and run its intent layer (`references/intent-interview.md`): it checks recipes and remembered defaults, and conducts this route's questions — including the PR-size → length doctrine, which lives whole in `../hyperframes/references/routes/pr-to-video.md` — then hands back the locked brief. Edit requests skip all of this — go do the edit.
 
@@ -71,7 +71,7 @@ PR="<url | owner/repo#N | N>"
 # capture/diff.patch — no scratch dir. gh auth / not-found / private errors exit 1 here.
 (cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)
 
-# Offline transform → capture/extracted/{tokens.json (colors:[] → claude palette),
+# Offline transform → capture/extracted/{tokens.json (colors:[] → code-editorial palette),
 # visible-text.txt (the brief), people.json (contributors, bot-filtered, name+login,
 # avatarFile=assets/<login>.png)}.
 (cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
@@ -93,17 +93,17 @@ If `fetch-pr.mjs` exits 1 (gh auth / not found / private), report its stderr and
 
 ## Step 2: Design System
 
-Goal: Adopt the claude frame preset; a script turns it into this video's `frame.md` + caption skin.
+Goal: Adopt the code-editorial frame preset; a script turns it into this video's `frame.md` + caption skin.
 
-The style is fixed — **claude** (warm editorial; a navy code surface built for diffs). Run:
+The style is fixed — **code-editorial** (warm editorial; a navy code surface built for diffs). Run:
 
 ```bash
-node <SKILL_DIR>/scripts/build-frame.mjs --preset claude --hyperframes .
+node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .
 ```
 
-The script copies the claude preset's `FRAME.md` → `frame.md`, remixes it onto any brand tokens in `capture/extracted/tokens.json` (a PR has none → `colors:[]`/`fonts:[]` keeps claude's own palette, a complete design), copies the preset's caption skin to `.hyperframes/caption-skin.html`, and self-validates (exits 1 on a broken mapping). Proceed as soon as it exits 0 — no hand-editing.
+The script copies the code-editorial preset's `FRAME.md` → `frame.md`, remixes it onto any brand tokens in `capture/extracted/tokens.json` (a PR has none → `colors:[]`/`fonts:[]` keeps code-editorial's own palette, a complete design), copies the preset's caption skin to `.hyperframes/caption-skin.html`, and self-validates (exits 1 on a broken mapping). Proceed as soon as it exits 0 — no hand-editing.
 
-**Gate:** `build-frame.mjs` exited 0 — `frame.md` exists from the claude preset, and `.hyperframes/caption-skin.html` exists as the caption skin source.
+**Gate:** `build-frame.mjs` exited 0 — `frame.md` exists from the code-editorial preset, and `.hyperframes/caption-skin.html` exists as the caption skin source.
 
 ---
 
@@ -151,7 +151,7 @@ Edit `STORYBOARD.md` in place. Do not create another storyboard. Use `frame.md`
 
 Read `references/visual-design.md`, `../hyperframes-animation/blueprints-index.md`, `references/motion-language.md`, `references/code-vocabulary.md`, and `../hyperframes-animation/rules-index.md`. Use `visual-design.md` for the method (the time-coded shot sequence, the inline Layout vocabulary, and the code-beat treatment), plus the required `## Video direction` block. Use `../hyperframes-animation/blueprints-index.md` to pick each frame's shot shape. Use `code-vocabulary.md` to pick the right `code-*` block per code beat (diff = `code-diff`, refactor = `code-morph`, new code = `code-typing`, …). Use `motion-language.md` (the motion vocabulary + the motion doctrine) and `../hyperframes-animation/rules-index.md` (valid rule names) for motion — do not invent motion or block/blueprint names.
 
-For every frame, write a **time-coded shot sequence** into `STORYBOARD.md` per `visual-design.md`'s method: pick the frame's blueprint (or compose), instantiate it with THIS frame's content, and pace each Scene's reveal to the voiceover so the frame develops across its full duration instead of front-loading then freezing. **For a code beat, the `code-*` block is the frame's `focal`** and the Scenes choreograph the surrounding claude Code Surface (the entry of the file/header, the camera onto the hunk, the landing line) — **not** the code animation itself, which the block owns. Immediately after each code frame's fields, add a `### Source excerpt` fenced `diff` block containing only the exact real hunk the worker must render (12 lines maximum). Select it here from `capture/diff.patch`; workers are forbidden from reopening that full diff. State layout and motion **inline** per Scene (vocabularies in `visual-design.md` and `motion-language.md`). Add one video-wide `## Video direction` block.
+For every frame, write a **time-coded shot sequence** into `STORYBOARD.md` per `visual-design.md`'s method: pick the frame's blueprint (or compose), instantiate it with THIS frame's content, and pace each Scene's reveal to the voiceover so the frame develops across its full duration instead of front-loading then freezing. **For a code beat, the `code-*` block is the frame's `focal`** and the Scenes choreograph the surrounding code-editorial Code Surface (the entry of the file/header, the camera onto the hunk, the landing line) — **not** the code animation itself, which the block owns. Immediately after each code frame's fields, add a `### Source excerpt` fenced `diff` block containing only the exact real hunk the worker must render (12 lines maximum). Select it here from `capture/diff.patch`; workers are forbidden from reopening that full diff. State layout and motion **inline** per Scene (vocabularies in `visual-design.md` and `motion-language.md`). Add one video-wide `## Video direction` block.
 
 Do not change story, script, `transition_in`, `asset_candidates`, or the PR source. Do not write HTML in this step. There is **no asset-staging step** — the only real assets are the credits avatars, already in `assets/`.
 
@@ -195,7 +195,7 @@ After audio timings exist, build captions in the background and assemble the ind
 
 `node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .`
 
-`captions.mjs` uses the project's `.hyperframes/caption-skin.html` (claude's, copied in Step 2), injecting brand tokens from `frame.md`; `captions: skipped (<reason>)` is valid. `assemble-index.mjs` stages the credits avatars from `assets/` as an idempotent backstop.
+`captions.mjs` uses the project's `.hyperframes/caption-skin.html` (code-editorial's, copied in Step 2), injecting brand tokens from `frame.md`; `captions: skipped (<reason>)` is valid. `assemble-index.mjs` stages the credits avatars from `assets/` as an idempotent backstop.
 
 **Gate:** every frame is marked `animated` (collaborative: the sketch board was confirmed at Step 4), `index.html` exists, and captions are built or explicitly skipped.
 
@@ -243,7 +243,7 @@ After the user is done reviewing (or after render when no more live edits are ex
 
 **Formats:** landscape `1920x1080`; portrait `1080x1920`; square `1080x1080` — derived from the destination (brief contract § 2). Set the format once in the storyboard frontmatter.
 
-**PR deltas vs a captured-asset workflow:** no Step 1 capture (the `gh` CLI ingests the PR into a synthetic `capture/extracted/` package — `tokens.json` + `visible-text.txt` + `people.json`); the only real assets are the contributors' `assets/<login>.png` avatars (the credits close); no `asset-descriptions.md`, no asset-staging step. Code beats are rendered by the `code-*` registry blocks on claude's navy Code Surface; the style is always **claude**.
+**PR deltas vs a captured-asset workflow:** no Step 1 capture (the `gh` CLI ingests the PR into a synthetic `capture/extracted/` package — `tokens.json` + `visible-text.txt` + `people.json`); the only real assets are the contributors' `assets/<login>.png` avatars (the credits close); no `asset-descriptions.md`, no asset-staging step. Code beats are rendered by the `code-*` registry blocks on code-editorial's navy Code Surface; the style is always **code-editorial**.
 
 **Background scripts:** the workflow ships these under `scripts/`: `fetch-pr` (PR → `capture/pr.json` + `diff.patch` via `gh`; large-PR-safe, no scratch), `ingest` (→ synthetic capture package; offline), and `fetch-people-avatars` (contributor avatars → `assets/`); plus the shared engine — `build-frame` (adopt + brand-remix a preset into `frame.md` + caption skin), `audio` (TTS, BGM, SFX, duration sync), `captions`, `transitions` (inject + verify), and `assemble-index`. Everything else is the `hyperframes` CLI. Code blocks install via `npx hyperframes add <name>`.
 
@@ -266,4 +266,4 @@ The reusable, domain-agnostic shot shapes live in `../hyperframes-animation/blue
 | `[../hyperframes-core/references/frame-worker-core.md](../hyperframes-core/references/frame-worker-core.md)`                                                | Step 5: the shared worker contract (packet builder prepends it to the delta).  |
 | `[sub-agents/frame-worker.md](sub-agents/frame-worker.md)`                                                                                                  | Step 5: the workflow's frame-worker delta.                                     |
 | `[../hyperframes-core/references/subagent-dispatch.md](../hyperframes-core/references/subagent-dispatch.md)`                                                | Step 5: dispatch sub-agents safely.                                            |
-| `[../hyperframes-creative/frame-presets/claude/FRAME.md](../hyperframes-creative/frame-presets/claude/FRAME.md)`                                            | Step 2: the claude preset (fixed style).                                       |
+| `[../hyperframes-creative/frame-presets/code-editorial/FRAME.md](../hyperframes-creative/frame-presets/code-editorial/FRAME.md)`                            | Step 2: the code-editorial preset (fixed style).                               |
diff --git a/skills/pr-to-video/references/code-vocabulary.md b/skills/pr-to-video/references/code-vocabulary.md
index d880dcc644..68c4436496 100644
--- a/skills/pr-to-video/references/code-vocabulary.md
+++ b/skills/pr-to-video/references/code-vocabulary.md
@@ -5,7 +5,7 @@ PR videos run on two kinds of moving picture: **code** (the lines that changed)
 For code beats the registry ships purpose-built **code animation blocks** that render a diff, a typed-on snippet, a morph, a highlight, a scroll, or a 3D/particle/dissolve reveal — far better than hand-built motion. **Reach for one of these first** for any code beat; fall back to hand-authored composition only when none fits.
 
 - **Step 4 (visual design):** for each `diff` / `before_after` / code beat, name the block in the frame's `scene` (e.g. "the `request()` retry block, ~6 lines, `code-diff`"). One judgment call: which block.
-- **Step 5 (frame worker):** install the named block and fill it with the real diff/snippet (below). The block is the frame's centerpiece, composited onto claude's navy **Code Surface**.
+- **Step 5 (frame worker):** install the named block and fill it with the real diff/snippet (below). The block is the frame's centerpiece, composited onto code-editorial's navy **Code Surface**.
 
 ## Install + use
 
@@ -64,7 +64,7 @@ These are **NOT palettes you attach to the animation blocks** — each is its ow
 - **VS Code workbench (12):** full VS Code window (activity bar, file-tree, tabs, editor with per-char typing, integrated terminal running `pytest`, status bar) in each theme. `dark-plus`, `light-plus`, `dark-modern`, `light-modern`, `dark-2026`, `light-2026`, `monokai`, `solarized-light`, `visual-studio-dark`, `visual-studio-light`, `high-contrast`, `high-contrast-light`. (Each pulls a `background.jpeg` into `assets/`.)
 - **Apple Terminal (12):** macOS Terminal.app window typing a shell command per profile. `apple-terminal-` + `basic`, `clear-dark`, `clear-light`, `grass`, `homebrew`, `man-page`, `novel`, `ocean`, `pro`, `red-sands`, `silver-aerogel`, `solid-colors`.
 
-The theme is baked into each block (not chosen at runtime); to use a given look, install that block and edit its `codeLines`. For claude's editorial register, prefer the focused animation blocks on the navy Code Surface; reach for a `code-snippet-*` UI only when "show it in a real editor/terminal" is the point.
+The theme is baked into each block (not chosen at runtime); to use a given look, install that block and edit its `codeLines`. For code-editorial's editorial register, prefer the focused animation blocks on the navy Code Surface; reach for a `code-snippet-*` UI only when "show it in a real editor/terminal" is the point.
 
 ## Showing behavior — the mechanism beat (not a `code-*` block)
 
@@ -72,7 +72,7 @@ A `code-*` block shows **the code**. It does not show **what the code does**. Th
 
 A mechanism beat is **not** a registry `code-*` block. It is one of:
 
-- an **invented animated diagram** — SVG / HTML / GSAP the frame worker builds from claude's atoms (hairline-ink nodes / edges / lanes on cream, one coral marker on the active element), the build playing out the behavior across the shot; **or**
+- an **invented animated diagram** — SVG / HTML / GSAP the frame worker builds from code-editorial's atoms (hairline-ink nodes / edges / lanes on cream, one coral marker on the active element), the build playing out the behavior across the shot; **or**
 - a **`flowchart` / `flowchart-vertical`** registry block — a process / pipeline / state flow; **or**
 - a **`data-chart`** registry block — a perf / metric comparison (two bars or timelines racing).
 
@@ -106,6 +106,6 @@ Unlike a `code-*` block (which owns its own animation), the diagram's motion is
 | Hero / title code moment ("the feature")                 | `code-3d-extrude`                                                                                                                                                |
 | "Compiles / builds / works now" reveal                   | `code-shader-dissolve`                                                                                                                                           |
 | Big dramatic snippet reveal / climax                     | `code-particle-assemble`                                                                                                                                         |
-| A benchmark / metric / count-up                          | **Not a `code-*` block** — use claude's `number-lockup` (Number/Impact treatment) or the `data-chart` registry block                                             |
+| A benchmark / metric / count-up                          | **Not a `code-*` block** — use code-editorial's `number-lockup` (Number/Impact treatment) or the `data-chart` registry block                                     |
 | **What the change DOES at runtime** (behavior, not code) | **Not a `code-*` block** — a `mechanism` beat: an invented SVG/GSAP diagram, or `flowchart` / `flowchart-vertical` / `data-chart`. See "Showing behavior" above. |
 | Show the change in a realistic IDE / terminal (ambient)  | a `code-snippet-*` VS Code theme (editor) or Apple Terminal profile (CLI run)                                                                                    |
diff --git a/skills/pr-to-video/references/motion-language.md b/skills/pr-to-video/references/motion-language.md
index 391edc38a9..ee15215828 100644
--- a/skills/pr-to-video/references/motion-language.md
+++ b/skills/pr-to-video/references/motion-language.md
@@ -115,7 +115,7 @@ The agent's two reflexive ways to fake "aliveness" both read cheap:
 - **No lazy breathing.** Scaling cards/text up and down in a circular loop to look "alive" is the cheap tell. Don't reach for it.
 - **No bad slow pan / push in the back half.** A slow pan or push on elements in the later ~50% of a scene **disrupts the viewer's sightline and causes eye discomfort** — it actively makes the frame worse, not better.
 
-The fix for both is the same: **stagger element reveals in time with the script** (rule 2). And the governing principle: **"I'd rather have NO motion than BAD motion."** A held, still frame is better than a frame kept "alive" by breathing or a drifting camera. The **only sanctioned aliveness** during a hold is **subtle jitter** — a small low-amplitude jitter that keeps a frame from feeling dead without looking weak (it's in Claude videos now). Everything else holds.
+The fix for both is the same: **stagger element reveals in time with the script** (rule 2). And the governing principle: **"I'd rather have NO motion than BAD motion."** A held, still frame is better than a frame kept "alive" by breathing or a drifting camera. The **only sanctioned aliveness** during a hold is **subtle jitter** — a small low-amplitude jitter that keeps a frame from feeling dead without looking weak (it's in Code editorial videos now). Everything else holds.
 
 ## 4. Internal seams are velocity-matched cuts
 
diff --git a/skills/pr-to-video/references/story-design.md b/skills/pr-to-video/references/story-design.md
index c5fbe48990..7a997a4deb 100644
--- a/skills/pr-to-video/references/story-design.md
+++ b/skills/pr-to-video/references/story-design.md
@@ -7,7 +7,7 @@ This file defines the story: what the video explains, in what order, and why eac
 ## Read first
 
 1. `hyperframes.json` — locked brief: angle (archetype), audience, length, aspect, language.
-2. `frame.md` — tone, type, design system (the shipped preset is **claude**: warm editorial, a serif that thinks, scarce coral, a navy code surface).
+2. `frame.md` — tone, type, design system (the shipped preset is **code-editorial**: warm editorial, a serif that thinks, scarce coral, a navy code surface).
 3. `capture/extracted/visible-text.txt` — the assembled PR brief: title, meta (`base ← head · +N/−M across F files`), people, body, commits, changed files, and a budget-bounded set of **representative diff hunks**. This is your source of **information**.
 4. `capture/diff.patch` — the full unified diff, for deeper hunk selection than the brief's excerpt.
 5. `capture/extracted/people.json` — contributors (author / committers / reviewers / commenters), bot-filtered, each with an avatar in `assets/<login>.png` (for the credits close).
@@ -27,7 +27,7 @@ Do **not** narrate the diff file-by-file or read the PR description aloud — th
 
 **Value before evidence** (`../hyperframes-creative/references/story-spine.md`): the viewer-facing payoff — what the change unlocks, fixes, or speeds up — lands by the second beat; the diff and the mechanism are the **evidence** for that claim, never the opening. Implementation is the footnote of the story, not the spine.
 
-Default to a **plain, technical, unhurried developer voice** — accurate, specific, no hype, no marketing gloss. You are explaining a real change to engineers; respect their time and intelligence. `frame.md` (claude) tunes the voice toward considered and literary; it does not change the structure.
+Default to a **plain, technical, unhurried developer voice** — accurate, specific, no hype, no marketing gloss. You are explaining a real change to engineers; respect their time and intelligence. `frame.md` (code-editorial) tunes the voice toward considered and literary; it does not change the structure.
 
 ## PR archetypes
 
@@ -42,9 +42,9 @@ Choose **one** archetype (or name a compound). Each is a complete path through u
 
 ## PR-native frame types
 
-Set each frame's `type` to one of these PR-native values. (The storyboard parser keeps `type` verbatim; it is a narrative + pacing label, not a hard enum.) Each maps to a claude frame treatment and a typical visual — so the type, the design, and the visual stay aligned end to end. Note `mechanism` is the **show-the-behavior** beat (an invented animated diagram), distinct from `diff` (show the code).
+Set each frame's `type` to one of these PR-native values. (The storyboard parser keeps `type` verbatim; it is a narrative + pacing label, not a hard enum.) Each maps to a code-editorial frame treatment and a typical visual — so the type, the design, and the visual stay aligned end to end. Note `mechanism` is the **show-the-behavior** beat (an invented animated diagram), distinct from `diff` (show the code).
 
-| `type`         | The frame's job                                                                                                             | claude treatment (frame.md)                                        | typical visual (see code-vocabulary.md)                                                 |
+| `type`         | The frame's job                                                                                                             | code-editorial treatment (frame.md)                                | typical visual (see code-vocabulary.md)                                                 |
 | -------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
 | `hook`         | The high-leverage opening 3–5s                                                                                              | Cover                                                              | — (or `code-3d-extrude` for a hero code moment)                                         |
 | `problem`      | The bug / smell / pain / why-care the PR resolves                                                                           | Statement or Pull-quote                                            | `code-highlight` (spotlight the offending line)                                         |
@@ -125,7 +125,7 @@ Pick 2–3 for the whole video and repeat. Frame 1 is `cut` (no previous frame).
 
 ## The diff is the centerpiece
 
-Code beats live on the **navy code surface** (claude's Code Surface treatment) — but the body is **not** all code (pair them with `mechanism` beats, next section). Plan the code beats deliberately:
+Code beats live on the **navy code surface** (code-editorial's Code Surface treatment) — but the body is **not** all code (pair them with `mechanism` beats, next section). Plan the code beats deliberately:
 
 - **Feature 2–4 real diff hunks**, named in each frame's `scene` — each a small, legible snippet (~4–12 lines), **never a whole file**. Pull them from `capture/diff.patch` / the brief's "Representative diff."
 - Name **which code animation block** the frame wants in `scene` (the Step-4 visual phase and the worker read it). See `code-vocabulary.md` for the full map; the short version: before→after = `code-diff`; refactor/rename continuity = `code-morph`; new code written on = `code-typing`; spotlight one line = `code-highlight`; walk a long file = `code-scroll`; a hero reveal = `code-3d-extrude` / `code-particle-assemble`.
@@ -135,7 +135,7 @@ Code beats live on the **navy code surface** (claude's Code Surface treatment) 
 
 A diff shows **what changed in the code**. It does **not** show **what the change does** — and "what it does" is usually the more memorable, more explanatory beat. The single biggest reason a PR video feels flat is that every body frame is a code surface or a number: it _tells_ (here are the lines, here is the stat) but never _shows_ (here is the request actually recovering).
 
-A **`mechanism` frame animates the runtime behavior** the PR changes — built as an **invented animated diagram** (SVG / HTML / GSAP on claude's cream ground: hairline-ink nodes / edges / lanes, one coral marker on the active or changed element), where **the build _is_ the teaching** — each part appears on beat, the flow plays out across the shot. It is **not** a code block and **not** a headline. Reach for the `flowchart` / `flowchart-vertical` / `data-chart` registry blocks where they fit; otherwise invent it (visual-design.md's diagram / abstract-graphics register).
+A **`mechanism` frame animates the runtime behavior** the PR changes — built as an **invented animated diagram** (SVG / HTML / GSAP on code-editorial's cream ground: hairline-ink nodes / edges / lanes, one coral marker on the active or changed element), where **the build _is_ the teaching** — each part appears on beat, the flow plays out across the shot. It is **not** a code block and **not** a headline. Reach for the `flowchart` / `flowchart-vertical` / `data-chart` registry blocks where they fit; otherwise invent it (visual-design.md's diagram / abstract-graphics register).
 
 Plan **at least one `mechanism` beat** for any PR with a visible runtime behavior (most feature and fix PRs have one). What to animate, by what the change touches:
 
diff --git a/skills/pr-to-video/references/visual-design.md b/skills/pr-to-video/references/visual-design.md
index e2d5dc751e..43aed6d3e9 100644
--- a/skills/pr-to-video/references/visual-design.md
+++ b/skills/pr-to-video/references/visual-design.md
@@ -71,21 +71,21 @@ The lightweight tags:
 For a `diff` / `before_after` / code beat, the frame's centerpiece is a **ready-made `code-*` registry block**, not an invented HTML visual — the one exception to "invent every visual."
 
 - **Name the block in `scene` + `focal`.** Pick the one that fits the beat (before→after = `code-diff`; refactor/rename = `code-morph`; new code written on = `code-typing`; spotlight a line = `code-highlight`; walk a long file = `code-scroll`; a hero reveal = `code-3d-extrude` / `code-particle-assemble`). Full map → `code-vocabulary.md`. Name the hunk too ("the `request()` retry block, ~6 lines"). The block is the `focal`; the Step-5 worker installs + fills it with the real diff.
-- **The block owns the code animation; your Scenes choreograph the surrounding Code Surface.** The block _is_ the development beat (the diff/typewriter/morph plays on its own cadence — the worker only fits it to the frame's `data-duration` so a long snippet doesn't overrun). Your Scene windows move the claude **Code Surface** around it: the navy window seating in, the file header typing on, the camera settling onto the hunk, a `+N/−M` `count-up`, a coral underline drawing on the landed line. Name those moves inline; **do not re-specify the code animation itself.** A code beat is usually `blueprint: compose` (the block is the shape).
+- **The block owns the code animation; your Scenes choreograph the surrounding Code Surface.** The block _is_ the development beat (the diff/typewriter/morph plays on its own cadence — the worker only fits it to the frame's `data-duration` so a long snippet doesn't overrun). Your Scene windows move the code-editorial **Code Surface** around it: the navy window seating in, the file header typing on, the camera settling onto the hunk, a `+N/−M` `count-up`, a coral underline drawing on the landed line. Name those moves inline; **do not re-specify the code animation itself.** A code beat is usually `blueprint: compose` (the block is the shape).
 
 ## PR mechanism beats — invent an animated diagram of the behavior
 
 A **`mechanism`** frame is the **show-the-behavior** beat — the antidote to a video that only shows code + text. Its `focal` is an **invented animated diagram** that plays out what the change _does_ at runtime (the request retrying, the cache filling, serial→parallel, the race resolved) — **not** a `code-*` block and **not** a headline.
 
-- **Name the behavior + the diagram in `scene` + `focal`.** e.g. `scene: "animate the request lifecycle — fire → 500 → backoff → retry → 200, invented SVG flow"`; `focal: the request-lifecycle flow`. Reach for the `flowchart` / `flowchart-vertical` / `data-chart` registry blocks where they fit (name them in `scene` so Step 5 pre-installs them); otherwise the worker builds it in SVG / HTML / GSAP from claude's atoms.
+- **Name the behavior + the diagram in `scene` + `focal`.** e.g. `scene: "animate the request lifecycle — fire → 500 → backoff → retry → 200, invented SVG flow"`; `focal: the request-lifecycle flow`. Reach for the `flowchart` / `flowchart-vertical` / `data-chart` registry blocks where they fit (name them in `scene` so Step 5 pre-installs them); otherwise the worker builds it in SVG / HTML / GSAP from code-editorial's atoms.
 - **The build IS the shot sequence.** Unlike a code block (which owns its own animation), the diagram is yours to choreograph across the Scene windows — the lanes / nodes draw on (Scene 1), the flow runs / the lane splits / the front advances as the VO names each step (middle Scenes), the resolved state + one coral emphasis lands (final Scene). Never let it enter then freeze.
-- **Stay on claude's cream ground, hairline-ink.** Nodes / edges / lanes in hairline ink on cream; **one coral marker** on the active or changed element; mono labels. Not the navy code surface (that's for code), not heavy shapes / bokeh. Plan it into the top ~83% (caption keep-out).
+- **Stay on code-editorial's cream ground, hairline-ink.** Nodes / edges / lanes in hairline ink on cream; **one coral marker** on the active or changed element; mono labels. Not the navy code surface (that's for code), not heavy shapes / bokeh. Plan it into the top ~83% (caption keep-out).
 
 A `mechanism` frame carries **no** `asset_candidates` (it's invented, like every non-credits frame).
 
 ## Impact & credits
 
-- **Impact / evidence** — numbers (`+1,204 / −318`, files touched, perf delta) go on an `impact` frame as a **`number-lockup`** (claude's Number/Impact treatment): name it the `focal`, reveal it with a `count-up` paced to the VO.
+- **Impact / evidence** — numbers (`+1,204 / −318`, files touched, perf delta) go on an `impact` frame as a **`number-lockup`** (code-editorial's Number/Impact treatment): name it the `focal`, reveal it with a `count-up` paced to the VO.
 - **Credits close** — the optional `credits` frame uses the real `assets/<login>.png` avatars (named in story's `asset_candidates`) as the `focal`: an avatar row that staggers in. This is the one frame with non-empty `asset_candidates` and real assets.
 
 ## Inventing the visual (non-code beats)
@@ -120,7 +120,7 @@ The zones, density, hierarchy, and depth principles all still apply; the **aspec
 
 The whole video shares one look and one motion grammar. Write a **`## Video direction`** block ONCE at the top of `STORYBOARD.md` so every frame inherits it and per-frame Scene lines carry only the **delta**. This block is load-bearing — **keep it.**
 
-- **palette system** — from `frame.md` (claude): which roles map to which hues. Never invent.
+- **palette system** — from `frame.md` (code-editorial): which roles map to which hues. Never invent.
 - **motion grammar + reveal model** — long-tail eases (`power3` default, smooth over bouncy) + the **VO-paced reveal** model + what may stay alive during a hold (subtle jitter at most) (→ `motion-language.md`).
 - **rhythm / held-frame allocation** — name the **held / breather frames** so the video varies its energy.
 - **negative list** — off-brand textures, **plus both motion failure modes** — slideshow (front-load then freeze) and screensaver (everything floating independently) (→ `motion-language.md`).
@@ -129,7 +129,7 @@ Do **not** repeat these per frame.
 
 ## Palette & type — from `frame.md`, never invented
 
-- **Palette** — `frame.md` (claude) is the color truth; apply its roles per frame. Generic basics → `hyperframes-creative/references/house-style.md`.
+- **Palette** — `frame.md` (code-editorial) is the color truth; apply its roles per frame. Generic basics → `hyperframes-creative/references/house-style.md`.
 - **Type** — fonts resolve via `frame.md`'s type tokens; reference them **by role** (display / body / mono / the pack's ramp), never by raw family or px. Code surfaces and mechanism labels use the **mono** role. Typography craft → `hyperframes-creative/references/typography.md`.
 
 ## Caption-band keep-out (plan side)
@@ -145,7 +145,7 @@ The bottom ~17% of the canvas is reserved for the caption pill. Plan every frame
 | motion — shot model, vocabulary, holds, idle budget, stillness, seek-safe       | `motion-language.md` (local)                                                   |
 | layout — framing, density, depth, hierarchy, inventing the visual, caption band | the **Layout** + **Inventing the visual** sections in this file                |
 | concrete eases / ms / stagger + rule recipe bodies (Step 5)                     | local `../hyperframes-animation/rules/` (the frame worker reads it; you don't) |
-| palette + type tokens                                                           | the project's `frame.md` (claude); basics → `hyperframes-creative`             |
+| palette + type tokens                                                           | the project's `frame.md` (code-editorial); basics → `hyperframes-creative`     |
 | within-frame cuts / seams (zoom-through · cut-the-curve · waterfall)            | `cut-catalog.md` (the worker builds them inside the composition)               |
 | transitions                                                                     | story-design owns `transition_in`; you don't touch it                          |
 
@@ -156,7 +156,7 @@ The bottom ~17% of the canvas is reserved for the caption pill. Plan every frame
 - **No frame front-loads** — at t=0 only what the VO is saying enters; each further piece reveals on its spoken cue, across the back ~50%. Window count follows the VO.
 - Every frame names a **`blueprint:`** id (Reproduce / Adapt) or `compose`; an Adapt keeps the signature move; nothing collapses to a single front-loaded dump.
 - **Code beats** name a `code-*` block as the `focal`, let the block own the code animation, and choreograph only the surrounding Code Surface in the Scenes.
-- **Mechanism beats** name an **invented animated diagram of the behavior** (or a `flowchart` / `data-chart`), choreographed across the Scenes on claude's cream ground with one coral marker — not a code block, not typography; the body is not an unbroken run of code surfaces.
+- **Mechanism beats** name an **invented animated diagram of the behavior** (or a `flowchart` / `data-chart`), choreographed across the Scenes on code-editorial's cream ground with one coral marker — not a code block, not typography; the body is not an unbroken run of code surfaces.
 - **Impact** uses a `number-lockup` with a `count-up`; the **credits** close uses the real avatars as the `focal`.
 - Each non-code, non-credits frame names its **invented** `focal` + per-element `roles`, kept few and load-bearing.
 - Layout + motion named **inline** per Scene (no px / ease curves / ms / JS).
diff --git a/skills/pr-to-video/scripts/frame-contract.test.mjs b/skills/pr-to-video/scripts/frame-contract.test.mjs
index 7d96dd5d02..e076245023 100644
--- a/skills/pr-to-video/scripts/frame-contract.test.mjs
+++ b/skills/pr-to-video/scripts/frame-contract.test.mjs
@@ -166,13 +166,13 @@ test("validated bare frames survive assembly and transition injection", () => {
   );
 });
 
-test("Claude preset stages renderer-parity fonts for an empty PR token set", () => {
-  const project = mkdtempSync(join(tmpdir(), "p2v-claude-fonts-"));
+test("Code editorial preset stages renderer-parity fonts for an empty PR token set", () => {
+  const project = mkdtempSync(join(tmpdir(), "p2v-code-editorial-fonts-"));
   write(join(project, "capture", "extracted", "tokens.json"), '{"colors":[],"fonts":[]}');
 
   execFileSync(
     process.execPath,
-    [buildFrameScript, "--preset", "claude", "--hyperframes", project],
+    [buildFrameScript, "--preset", "code-editorial", "--hyperframes", project],
     { encoding: "utf8" },
   );
 
@@ -198,8 +198,11 @@ test("Claude preset stages renderer-parity fonts for an empty PR token set", ()
   assert.doesNotMatch(frameMd, /fonts\.googleapis\.com/);
 });
 
-test("bundled Claude font licenses are shipped beside the assets", () => {
-  const fontDir = resolve(scriptDir, "../../hyperframes-creative/frame-presets/claude/fonts");
+test("bundled Code editorial font licenses are shipped beside the assets", () => {
+  const fontDir = resolve(
+    scriptDir,
+    "../../hyperframes-creative/frame-presets/code-editorial/fonts",
+  );
   for (const family of ["eb-garamond", "inter", "jetbrains-mono"]) {
     assert.equal(existsSync(join(fontDir, `OFL-${family}.txt`)), true);
   }
diff --git a/skills/pr-to-video/scripts/ingest.mjs b/skills/pr-to-video/scripts/ingest.mjs
index 28c02ff75c..0b474b491c 100644
--- a/skills/pr-to-video/scripts/ingest.mjs
+++ b/skills/pr-to-video/scripts/ingest.mjs
@@ -16,7 +16,7 @@
 //                      + fetch-pr.mjs's best-effort shipped_version / version_source
 //   --diff <path>      gh pr diff (raw unified diff)  [optional — brief still builds without it]
 // Writes (under --out-dir, default ./capture/extracted):
-//   tokens.json        synthetic design tokens (colors:[] → claude native palette)
+//   tokens.json        synthetic design tokens (colors:[] → code-editorial native palette)
 //   visible-text.txt   the narrative SOURCE: a readable plain-text brief assembled
 //                      from title + meta + people + body + commits + changed files + a
 //                      budget-bounded selection of representative diff hunks.
diff --git a/skills/pr-to-video/sub-agents/frame-worker.md b/skills/pr-to-video/sub-agents/frame-worker.md
index 6204f3d03e..ab8bdb7ed7 100644
--- a/skills/pr-to-video/sub-agents/frame-worker.md
+++ b/skills/pr-to-video/sub-agents/frame-worker.md
@@ -21,12 +21,12 @@ A PR video is **mostly invented**: there are **no screenshots and no captured UI
 - **Code beats (`diff` / `before_after` / a new-code reveal) — use the named `code-*` block, don't hand-build code motion.** Your `## Frame N` `scene` / `focal` names which block (e.g. `code-diff`, `code-morph`, `code-typing`); the orchestrator has already installed it (pre-install step). Read the `code-vocabulary.md` excerpt in your packet for that block's exact inputs, then:
   - Use only the packet's `### Source excerpt`. It is the real before/after hunk selected upstream. Never reopen the full diff or brief.
   - Fill the block's `window.__TOKENS` with that real code (the baked Shiki tokens) and set `window.__BLOCK` (effect, `line`, `duration`) **so the full block completes within the frame's `data-duration`** — a long snippet at the block's default per-character cadence overruns a short frame (the code never finishes typing). `code-diff` / `code-morph` need **2 states** (before, after); the others take one. **Line indexing differs — `code-highlight` is 0-based, `code-scroll` 1-based** — don't off-by-one.
-  - Integrate the filled block as **this frame's composition** per the core sub-composition contract: its `data-composition-id` and its `window.__timelines[...]` key must both be your **`<frame_id>`** (the block ships its own id + paused timeline; rename both to match the frame contract). The block already renders an editor window (titlebar / filename) reading as claude's navy **Code Surface** — set the filename + any `+N/−M` chrome from the `scene`.
+  - Integrate the filled block as **this frame's composition** per the core sub-composition contract: its `data-composition-id` and its `window.__timelines[...]` key must both be your **`<frame_id>`** (the block ships its own id + paused timeline; rename both to match the frame contract). The block already renders an editor window (titlebar / filename) reading as code-editorial's navy **Code Surface** — set the filename + any `+N/−M` chrome from the `scene`.
   - **The block owns the code animation; your Scene windows choreograph the surrounding Code Surface** — the navy window seating in, the file header typing on, the camera settling onto the hunk, a coral underline on the landed line. **Do not re-specify the code motion** (the block is the development beat). A code beat is usually `blueprint: compose`.
   - **The block has no caption-safe band.** When `Captions: enabled`, inset/scale the code panel into the top ~83% so it clears the keep-out band; never let code run under the caption pill.
 - **Mechanism beats (`mechanism`) — build an invented animated diagram of the behavior; the build _is_ the shot.** This is the "show what the change does at runtime" frame (the request retrying, the cache filling, serial→parallel, the race resolved) — read its `scene` for the behavior to animate. Unlike a code beat, **the motion is yours to author** (no block owns it):
   - If the `scene` names a `flowchart` / `flowchart-vertical` / `data-chart` block, the orchestrator pre-installed it — fill + mount it like a code block (its `data-composition-id` and `window.__timelines[...]` key both become your `<frame_id>`). Otherwise **hand-build the diagram in SVG / HTML / GSAP** from `frame.md`'s atoms.
-  - **Claude register:** hairline-ink nodes / edges / lanes on the cream ground, **one coral marker** on the active / changed element, mono labels — **not** the navy code surface (that's for code), no heavy shapes / bokeh.
+  - **Code editorial register:** hairline-ink nodes / edges / lanes on the cream ground, **one coral marker** on the active / changed element, mono labels — **not** the navy code surface (that's for code), no heavy shapes / bokeh.
   - **Choreograph the Scene windows:** the nodes / lanes draw on (Scene 1); **the flow runs** as the VO names each step (middle Scenes — the request hops, the lane splits, the front advances, the bars race) — this _is_ the teaching, so it must play across the shot, never enter-then-freeze; the resolved state + the one coral emphasis lands (final Scene). Keep it in the top ~83% (caption keep-out).
 - **The `credits` close — the one frame with real assets.** Its `asset_candidates` names 2–6 `assets/<login>.png` avatars (downloaded upstream). Render them as `<img>` in hairline-ringed chips — an avatar row with each contributor's name + role in mono (an "approved" mark if the close calls for it), staggered in across the Scene windows. Avatars appear **only** here, never decorating a code frame.
 
@@ -34,5 +34,5 @@ A PR video is **mostly invented**: there are **no screenshots and no captured UI
 
 - The composition root also carries a **positive `data-duration` matching the packet**.
 - **Code-block cadence fits `data-duration`** — for a code beat, the `code-*` block's internal cadence is set so the full block completes within the frame's `data-duration` (a long snippet at the default per-character speed overruns — the code never finishes and the chrome beats never play; see `code-vocabulary.md`).
-- Fonts: copy the auto-generated `@font-face` block from `frame.md`; the Claude preset's EB Garamond, Inter, and JetBrains Mono faces live in `assets/fonts/`. Never link Google Fonts.
+- Fonts: copy the auto-generated `@font-face` block from `frame.md`; the Code editorial preset's EB Garamond, Inter, and JetBrains Mono faces live in `assets/fonts/`. Never link Google Fonts.
 - Visible-text exception: real code inside a `code-*` block is the content, not narration.
diff --git a/skills/product-launch-video/references/cut-catalog.md b/skills/product-launch-video/references/cut-catalog.md
index 1c54a5e776..822949ff26 100644
--- a/skills/product-launch-video/references/cut-catalog.md
+++ b/skills/product-launch-video/references/cut-catalog.md
@@ -109,7 +109,7 @@ through_ content; inverse reads as _arriving at_ content.
 - Easing: `expo.out`, Duration: 0.5s
 
 Shipped examples: `boring → until-now` and `B3 → "That changes today."` (sfx-music-launch);
-seams 3/4 in claude-paper (`follow-up → thinking`, `thinking → compose UI`).
+seams 3/4 in editorial-paper (`follow-up → thinking`, `thinking → compose UI`).
 
 ---
 
diff --git a/skills/product-launch-video/references/motion-language.md b/skills/product-launch-video/references/motion-language.md
index 367ecbaad2..4980413f37 100644
--- a/skills/product-launch-video/references/motion-language.md
+++ b/skills/product-launch-video/references/motion-language.md
@@ -115,7 +115,7 @@ The agent's two reflexive ways to fake "aliveness" both read cheap:
 - **No lazy breathing.** Scaling cards/text up and down in a circular loop to look "alive" is the cheap tell. Don't reach for it.
 - **No bad slow pan / push in the back half.** A slow pan or push on elements in the later ~50% of a scene **disrupts the viewer's sightline and causes eye discomfort** — it actively makes the frame worse, not better.
 
-The fix for both is the same: **stagger element reveals in time with the script** (rule 2). And the governing principle: **"I'd rather have NO motion than BAD motion."** A held, still frame is better than a frame kept "alive" by breathing or a drifting camera. The **only sanctioned aliveness** during a hold is **subtle jitter** — a small low-amplitude jitter that keeps a frame from feeling dead without looking weak (it's in Claude videos now). Everything else holds.
+The fix for both is the same: **stagger element reveals in time with the script** (rule 2). And the governing principle: **"I'd rather have NO motion than BAD motion."** A held, still frame is better than a frame kept "alive" by breathing or a drifting camera. The **only sanctioned aliveness** during a hold is **subtle jitter** — a small low-amplitude jitter that keeps a frame from feeling dead without looking weak (it's in current video work now). Everything else holds.
 
 ## 4. Internal seams are velocity-matched cuts
 
diff --git a/skills/talking-head-recut/SKILL.md b/skills/talking-head-recut/SKILL.md
index fc7b1a68ec..a9c797ff52 100644
--- a/skills/talking-head-recut/SKILL.md
+++ b/skills/talking-head-recut/SKILL.md
@@ -279,8 +279,7 @@ densityMultiplier)))`) so the "auto" option's label can show the
 Not every runtime exposes the same structured-question tool. Apply this
 order:
 
-1. **`AskUserQuestion`** (Claude Code, Anthropic Console) — use the
-   structured 4-question call below.
+1. **Native clarification tool** — use the structured 4-question call below.
 2. **Other native clarification tool** (e.g. `ask_question`,
    `request_user_input`, IDE-specific prompt) — use that tool with the
    same 4 question texts and option lists. Preserve the recommendation

From e786b78b3311d697e95269ec8fc21a4159af909d Mon Sep 17 00:00:00 2001
From: Xuanru Li <157947275+xuanruli@users.noreply.github.com>
Date: Tue, 21 Jul 2026 13:30:44 -0700
Subject: [PATCH 006/125] feat(producer): renderStretch to re-time short
 compositions across longer scenes (#2676)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Linear: VA-1859

## Problem

For a `fit_to_scene` B-roll where the composition's intrinsic timeline (e.g. `data-duration=1.0s` → 30 frames) is shorter than the scene it fills (e.g. 4.8s narration), the producer renders only the intrinsic 30 frames and the downstream compositor frame-holds/PTS-stretches that fixed clip to the scene length. Spreading 30 unique frames over 4.8s starves motion to ~6 effective fps → a visibly choppy result. Root cause: the producer welds one `composition.duration` to both the frame count and the 1:1 seek mapping, with no notion of a target output length.

## Fix

Add optional `renderStretch: number` (default `1.0` = no-op), `renderStretch = intrinsic / target`:

- **Frame count** comes from the target: `outputDuration = intrinsic / renderStretch`, `totalFrames = outputDuration × fps` (`probeStage.ts`). `composition.duration` stays intrinsic (drives video/audio windows).
- **Per-frame seek** is scaled: `time = (frameIndex / fps) × renderStretch`, so the N output frames map across `[0, intrinsic]` — a fresh frame per output frame.

All seek sites go through a single shared `outputFrameToTimelineSeconds(frameIndex, fps, renderStretch)` helper (`core.types.ts`), consumed by every capture path so none can silently diverge:
- parallel (`parallelCoordinator.ts`), `sdr_streaming` (`captureStreamingStage.ts` ×3), `sdr_disk` (`captureStage.ts`), HDR loops.
- DrawElement + static self-verify (`frameCapture.ts`) — ground-truth seek uses the same mapping, so PSNR compares like-for-like (no spurious verification failure on stretched comps).
- Distributed path: `renderStretch` threaded through `DistributedRenderConfig` → chunk workers, and **folded into the plan hash only when `!= 1`** so a pre-stretch cached plan is never reused.

With `renderStretch = 1` (or omitted → `?? 1`): every seek is `×1.0` (IEEE-754 identity), frame counts unchanged, and the plan hash is byte-identical — a provable no-op. `player.ts` absolute-seek is untouched.

## Verify

- typecheck (core + engine + producer): pass. lint/format/fallow/commitlint: pass. `planHash` + `renderRequest` unit suites: pass.
- Adversarial self-review found + fixed three capture-path gaps (streaming, self-verify, distributed) before this revision.
- **Not yet runtime-verified** on a real render — needs a fit_to_scene render at `renderStretch < 1` confirming N distinct frames over the target length (draft until then).

Paired with experiment-framework#42766, which computes and forwards `renderStretch = hf intrinsic / scene duration`.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
---
 packages/core/src/core.types.ts               | 12 ++++++++
 packages/core/src/index.ts                    |  1 +
 .../src/outputFrameToTimelineSeconds.test.ts  | 30 +++++++++++++++++++
 packages/engine/src/services/frameCapture.ts  | 11 +++++--
 .../src/services/parallelCoordinator.ts       |  9 ++++--
 packages/engine/src/types.ts                  |  2 ++
 packages/producer/src/renderRequest.ts        | 12 ++++++++
 packages/producer/src/server.ts               |  7 +++++
 .../producer/src/services/distributed/plan.ts |  5 ++++
 .../src/services/distributed/renderChunk.ts   |  3 ++
 .../distributed/renderConfigValidation.ts     | 12 ++++++++
 .../src/services/distributed/shared.ts        |  2 ++
 .../render/stages/captureHdrHybridLoop.ts     |  3 +-
 .../render/stages/captureHdrSequentialLoop.ts |  3 +-
 .../services/render/stages/captureStage.ts    | 13 ++++++--
 .../render/stages/captureStreamingStage.ts    | 13 ++++++--
 .../services/render/stages/planHash.test.ts   | 20 +++++++++++++
 .../src/services/render/stages/planHash.ts    |  7 ++++-
 .../src/services/render/stages/probeStage.ts  |  7 +++--
 .../src/services/renderOrchestrator.ts        |  2 ++
 20 files changed, 159 insertions(+), 15 deletions(-)
 create mode 100644 packages/core/src/outputFrameToTimelineSeconds.test.ts

diff --git a/packages/core/src/core.types.ts b/packages/core/src/core.types.ts
index 99d356b557..402f43170a 100644
--- a/packages/core/src/core.types.ts
+++ b/packages/core/src/core.types.ts
@@ -38,6 +38,18 @@ export function fpsToNumber(fps: Fps): number {
   return fps.num / fps.den;
 }
 
+/**
+ * Timeline seek time for an output frame. `renderStretch` (=intrinsic/target,
+ * default 1 = no-op) scales the mapping so a short comp spans a longer output.
+ */
+export function outputFrameToTimelineSeconds(
+  frameIndex: number,
+  fps: Fps,
+  renderStretch = 1,
+): number {
+  return ((frameIndex * fps.den) / fps.num) * renderStretch;
+}
+
 /**
  * FFmpeg-style fps argument. Returns `"30"` for integer fps and `"30000/1001"`
  * for rationals — both forms are accepted verbatim by FFmpeg's `-r` and
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index d99e932a7a..2ce7d2587b 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -63,6 +63,7 @@ export {
   parseFpsWithDefault,
   toFps,
   fpsToNumber,
+  outputFrameToTimelineSeconds,
   fpsToFfmpegArg,
   TIMELINE_COLORS,
   DEFAULT_DURATIONS,
diff --git a/packages/core/src/outputFrameToTimelineSeconds.test.ts b/packages/core/src/outputFrameToTimelineSeconds.test.ts
new file mode 100644
index 0000000000..de18361be6
--- /dev/null
+++ b/packages/core/src/outputFrameToTimelineSeconds.test.ts
@@ -0,0 +1,30 @@
+import { describe, it, expect } from "vitest";
+import { outputFrameToTimelineSeconds } from "./core.types.js";
+
+describe("outputFrameToTimelineSeconds", () => {
+  const fps = { num: 30, den: 1 };
+
+  it("no-op when renderStretch is omitted (defaults to 1)", () => {
+    for (const i of [0, 1, 29, 143]) {
+      expect(outputFrameToTimelineSeconds(i, fps)).toBe((i * fps.den) / fps.num);
+    }
+  });
+
+  it("renderStretch=1 is byte-identical to the raw frame time", () => {
+    expect(outputFrameToTimelineSeconds(143, fps, 1)).toBe(143 / 30);
+  });
+
+  it("stretches a 1s comp across a 4.8s output (renderStretch = intrinsic/target)", () => {
+    const rs = 1 / 4.8;
+    expect(outputFrameToTimelineSeconds(0, fps, rs)).toBe(0);
+    // last of 144 output frames lands just under intrinsic 1.0s — never past it
+    const last = outputFrameToTimelineSeconds(143, fps, rs);
+    expect(last).toBeGreaterThan(0.98);
+    expect(last).toBeLessThan(1.0);
+  });
+
+  it("honors an exact rational fps (NTSC 30000/1001)", () => {
+    const ntsc = { num: 30000, den: 1001 };
+    expect(outputFrameToTimelineSeconds(30, ntsc, 1)).toBe((30 * 1001) / 30000);
+  });
+});
diff --git a/packages/engine/src/services/frameCapture.ts b/packages/engine/src/services/frameCapture.ts
index c6948fcba2..6a86f9ecab 100644
--- a/packages/engine/src/services/frameCapture.ts
+++ b/packages/engine/src/services/frameCapture.ts
@@ -2660,8 +2660,9 @@ export async function verifyStaticFramesSafe(
     if (last && f === last.b + 1) last.b = f;
     else runs.push({ a: f, b: f });
   }
+  const renderStretch = session.options.renderStretch ?? 1;
   const seekToFrame = async (frameIdx: number): Promise<void> => {
-    const t = quantizeTimeToFrame(frameIdx / fps, fps);
+    const t = quantizeTimeToFrame((frameIdx / fps) * renderStretch, fps);
     await page.evaluate((tt: number) => {
       const hf = (
         window as unknown as {
@@ -3599,11 +3600,14 @@ async function captureDeVerificationFrames(
   // their data-duration, and infinite-repeat GSAP reports a huge sentinel —
   // and indices derived from it would never be drained, silently disarming
   // verification for exactly the comps that need it.
+  // compositionDurationSeconds is already the output (drained) duration; the raw
+  // page fallback is intrinsic — divide it by renderStretch to match (1 = no-op).
+  const renderStretch = session.options.renderStretch ?? 1;
   const duration =
     session.options.compositionDurationSeconds ??
     (await page.evaluate(
       () => (window as unknown as { __hf?: { duration?: number } }).__hf?.duration ?? 0,
-    ));
+    )) / renderStretch;
   const totalFrames = Math.floor(duration * fps);
   if (totalFrames < 10) return;
   if (duration > 3600) {
@@ -3653,7 +3657,8 @@ async function captureDeVerificationFrames(
     while (boundary.has(idx) && guard++ < 6) idx = Math.min(totalFrames - 1, idx + 2);
     if (boundary.has(idx)) continue;
     if (frames.has(idx)) continue;
-    const t = quantizeTimeToFrame(idx / fps, fps);
+    // Seek truth with the same ×renderStretch mapping the real capture uses for output frame idx.
+    const t = quantizeTimeToFrame((idx / fps) * renderStretch, fps);
     await seekTo(t);
     // Video frame injection (same hook the real capture paths run) — without
     // it, <video> elements screenshot black and every video comp would
diff --git a/packages/engine/src/services/parallelCoordinator.ts b/packages/engine/src/services/parallelCoordinator.ts
index b52308886b..d6c028e4a3 100644
--- a/packages/engine/src/services/parallelCoordinator.ts
+++ b/packages/engine/src/services/parallelCoordinator.ts
@@ -23,6 +23,7 @@ import {
   type CapturePerfSummary,
   type BeforeCaptureHook,
 } from "./frameCapture.js";
+import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import { DEFAULT_CONFIG, type EngineConfig } from "../config.js";
 import { assertSwiftShader } from "../utils/assertSwiftShader.js";
 import { readWebGlVendorInfoFromCanvas } from "../utils/readWebGlVendorInfoFromCanvas.js";
@@ -368,6 +369,10 @@ async function captureFrameRange(
   let framesCaptured = 0;
   const outputOffset = task.outputFrameOffset ?? 0;
   const stride = task.frameStride ?? 1;
+  // Per-frame seek ×renderStretch maps frames across [0, intrinsic] (1 = no-op).
+  const renderStretch = captureOptions.renderStretch ?? 1;
+  const seekTime = (i: number): number =>
+    outputFrameToTimelineSeconds(i, captureOptions.fps, renderStretch);
   // Depth-2 pipelined drawElement produce (HF_DE_PARALLEL_STREAM spike): frame
   // k's in-page worker encode overlaps frame k+stride's produce phase — the
   // same shape as the sequential worker-encode loop. Only engaged when the
@@ -387,7 +392,7 @@ async function captureFrameRange(
     let prev: { idx: number; encodeResult: Promise<Buffer> } | null = null;
     for (let i = task.startFrame; i < task.endFrame; i += stride) {
       if (signal?.aborted) throw new Error("Parallel worker cancelled");
-      const time = (i * captureOptions.fps.den) / captureOptions.fps.num;
+      const time = seekTime(i);
       if (dbg && i < task.startFrame + dbgWin) {
         console.log(`[par:w${task.workerId}] +${Date.now() - dbgT0}ms produce ${i} start`);
       }
@@ -431,7 +436,7 @@ async function captureFrameRange(
   }
   for (let i = task.startFrame; i < task.endFrame; i += stride) {
     if (signal?.aborted) throw new Error("Parallel worker cancelled");
-    const time = (i * captureOptions.fps.den) / captureOptions.fps.num;
+    const time = seekTime(i);
     const fileFrameIdx = i - outputOffset;
 
     if (onFrameBuffer) {
diff --git a/packages/engine/src/types.ts b/packages/engine/src/types.ts
index 96d858e32a..c46d0fcd98 100644
--- a/packages/engine/src/types.ts
+++ b/packages/engine/src/types.ts
@@ -114,6 +114,7 @@ export interface CaptureOptions {
    * timelines can outrun their declared duration). Consumers that derive
    * frame indices meant to be drained by the producer (drawElement
    * self-verification) MUST prefer this over `__hf.duration`.
+   * When renderStretch != 1 this is the OUTPUT (stretched) duration, not intrinsic.
    */
   compositionDurationSeconds?: number;
   /**
@@ -123,6 +124,7 @@ export interface CaptureOptions {
    * rational form verbatim — see `fpsToFfmpegArg`.
    */
   fps: Fps;
+  renderStretch?: number;
   format?: "jpeg" | "png";
   quality?: number;
   deviceScaleFactor?: number;
diff --git a/packages/producer/src/renderRequest.ts b/packages/producer/src/renderRequest.ts
index e4e373aff9..4ea40abd82 100644
--- a/packages/producer/src/renderRequest.ts
+++ b/packages/producer/src/renderRequest.ts
@@ -49,6 +49,8 @@ export interface RenderRequestOptions {
   variables?: Record<string, unknown>;
   outputResolution?: CanvasResolution;
   outputResolutionAspectAgnostic?: boolean;
+  /** intrinsic/target timeline re-time; 1 = no-op. Audio is silence-padded to output length, not time-stretched. */
+  renderStretch?: number;
   engineConfig: EngineConfig;
   distributed?: DistributedRenderOptions;
 }
@@ -105,6 +107,13 @@ function assertOptionalInteger(options: Record<string, unknown>, field: string,
   }
 }
 
+function assertOptionalPositiveNumber(options: Record<string, unknown>, field: string): void {
+  const value = options[field];
+  if (value !== undefined && (typeof value !== "number" || !Number.isFinite(value) || value <= 0)) {
+    throw new Error(`Render request ${field} must be a positive number`);
+  }
+}
+
 function assertOptionalString(options: Record<string, unknown>, field: string): void {
   if (options[field] !== undefined && typeof options[field] !== "string") {
     throw new Error(`Render request ${field} must be a string`);
@@ -160,6 +169,7 @@ function assertRequestOptionScalars(options: Record<string, unknown>): void {
   assertOptionalInteger(options, "gifLoop");
   assertOptionalInteger(options, "workers", 1);
   assertOptionalInteger(options, "crf");
+  assertOptionalPositiveNumber(options, "renderStretch");
   for (const field of ["useGpu", "debug", "outputResolutionAspectAgnostic"] as const) {
     assertOptionalBoolean(options, field);
   }
@@ -284,6 +294,7 @@ export function distributedConfigFromRequest(
     videoFrameFormat: options.videoFrameFormat,
     outputResolution: options.outputResolution,
     outputResolutionAspectAgnostic: options.outputResolutionAspectAgnostic,
+    renderStretch: options.renderStretch,
     chunkSize: distributed.chunkSize,
     maxParallelChunks: distributed.maxParallelChunks,
     targetChunkFrames: distributed.targetChunkFrames,
@@ -339,6 +350,7 @@ export function renderRequestFromDistributedConfig(input: {
     ...optionalProperty("videoFrameFormat", config.videoFrameFormat),
     ...optionalProperty("outputResolution", config.outputResolution),
     ...optionalProperty("outputResolutionAspectAgnostic", config.outputResolutionAspectAgnostic),
+    ...optionalProperty("renderStretch", config.renderStretch),
     ...optionalProperty("hdrMode", config.hdrMode),
     ...optionalProperty("strictness", config.strictness),
     ...optionalProperty("entryFile", config.entryFile),
diff --git a/packages/producer/src/server.ts b/packages/producer/src/server.ts
index 45af6b222f..26d8d8a675 100644
--- a/packages/producer/src/server.ts
+++ b/packages/producer/src/server.ts
@@ -110,6 +110,7 @@ interface RenderInput {
    * compositions as an aspect-ratio mismatch.
    */
   outputResolutionAspectAgnostic?: boolean;
+  renderStretch?: number;
 }
 
 interface PreparedRenderInput {
@@ -167,6 +168,10 @@ export function parseRenderOptions(body: Record<string, unknown>): Omit<RenderIn
 
   const { variables, outputResolution, outputResolutionAspectAgnostic } =
     parseRenderOverrides(body);
+  const renderStretch =
+    typeof body.renderStretch === "number" && body.renderStretch > 0
+      ? body.renderStretch
+      : undefined;
 
   return {
     outputPath,
@@ -182,6 +187,7 @@ export function parseRenderOptions(body: Record<string, unknown>): Omit<RenderIn
     outputResolution,
     outputResolutionAspectAgnostic,
     videoFrameFormat,
+    renderStretch,
   };
 }
 
@@ -239,6 +245,7 @@ function buildRenderJobConfig(input: RenderInput, outputPath: string, log: Produ
       outputResolution: input.outputResolution,
       outputResolutionAspectAgnostic: input.outputResolutionAspectAgnostic,
       videoFrameFormat: input.videoFrameFormat,
+      renderStretch: input.renderStretch,
     },
   });
   return renderConfigFromRequest(request, { logger: log });
diff --git a/packages/producer/src/services/distributed/plan.ts b/packages/producer/src/services/distributed/plan.ts
index 424cf79fac..c84966c038 100644
--- a/packages/producer/src/services/distributed/plan.ts
+++ b/packages/producer/src/services/distributed/plan.ts
@@ -135,6 +135,9 @@ export interface DistributedRenderConfig {
    */
   outputResolutionAspectAgnostic?: boolean;
 
+  /** intrinsic/target timeline re-time; 1 (or omitted) = no-op. Folded into planHash. */
+  renderStretch?: number;
+
   /**
    * Frames per chunk. When explicitly set, that value is used and
    * `chunkCount = min(maxParallelChunks, ceil(totalFrames / chunkSize))`
@@ -771,6 +774,7 @@ export async function plan(
     videoFrameFormat: config.videoFrameFormat,
     outputResolution: config.outputResolution,
     outputResolutionAspectAgnostic: config.outputResolutionAspectAgnostic,
+    renderStretch: config.renderStretch,
     // HDR is banned in distributed mode. force-sdr keeps the
     // extract / encoder paths off the HDR branches entirely.
     hdrMode: config.hdrMode ?? "force-sdr",
@@ -1036,6 +1040,7 @@ export async function plan(
     width,
     height,
     format: config.format,
+    renderStretch: config.renderStretch,
   };
   // Clean up the temp work tree BEFORE freezePlan. `.plan-work/` holds
   // intermediate compileStage + audio-mix artifacts (downloaded source
diff --git a/packages/producer/src/services/distributed/renderChunk.ts b/packages/producer/src/services/distributed/renderChunk.ts
index 4f5009f15b..3f1df33437 100644
--- a/packages/producer/src/services/distributed/renderChunk.ts
+++ b/packages/producer/src/services/distributed/renderChunk.ts
@@ -239,6 +239,7 @@ interface PlanJson {
     width: number;
     height: number;
     format: DistributedFormat;
+    renderStretch?: number;
   };
   chunkCount: number;
   totalFrames: number;
@@ -515,6 +516,8 @@ export async function renderChunk(
       width: plan.dimensions.width,
       height: plan.dimensions.height,
       fps: { num: plan.dimensions.fpsNum, den: plan.dimensions.fpsDen },
+      // Per-frame seek ×renderStretch maps output frames across [0, intrinsic] (1 = no-op).
+      renderStretch: plan.dimensions.renderStretch ?? 1,
       format: plan.dimensions.format === "mp4" ? "jpeg" : "png",
       quality: plan.dimensions.format === "mp4" ? 80 : undefined,
       deviceScaleFactor: encoder.deviceScaleFactor,
diff --git a/packages/producer/src/services/distributed/renderConfigValidation.ts b/packages/producer/src/services/distributed/renderConfigValidation.ts
index 261fc11d10..a7b6297a62 100644
--- a/packages/producer/src/services/distributed/renderConfigValidation.ts
+++ b/packages/producer/src/services/distributed/renderConfigValidation.ts
@@ -187,6 +187,18 @@ export function validateDistributedRenderConfig(
     }
   }
 
+  if (
+    config.renderStretch !== undefined &&
+    (typeof config.renderStretch !== "number" ||
+      !Number.isFinite(config.renderStretch) ||
+      config.renderStretch <= 0)
+  ) {
+    throw new InvalidConfigError(
+      "config.renderStretch",
+      `must be a positive number; got ${String(config.renderStretch)}`,
+    );
+  }
+
   if (config.runtimeCap !== undefined && !ALLOWED_RUNTIME_CAPS.includes(config.runtimeCap)) {
     throw new InvalidConfigError(
       "config.runtimeCap",
diff --git a/packages/producer/src/services/distributed/shared.ts b/packages/producer/src/services/distributed/shared.ts
index 684449ee45..cbd84dd77a 100644
--- a/packages/producer/src/services/distributed/shared.ts
+++ b/packages/producer/src/services/distributed/shared.ts
@@ -100,6 +100,7 @@ export interface SyntheticRenderJobInput {
   videoFrameFormat?: VideoFrameFormat;
   outputResolution?: RenderConfig["outputResolution"];
   outputResolutionAspectAgnostic?: RenderConfig["outputResolutionAspectAgnostic"];
+  renderStretch?: number;
   hdrMode: RenderConfig["hdrMode"];
   strictness?: RenderConfig["strictness"];
   entryFile: string;
@@ -122,6 +123,7 @@ export function buildSyntheticRenderJob(input: SyntheticRenderJobInput): RenderJ
     videoFrameFormat: input.videoFrameFormat,
     outputResolution: input.outputResolution,
     outputResolutionAspectAgnostic: input.outputResolutionAspectAgnostic,
+    renderStretch: input.renderStretch,
     // Distributed mode hard-pins to software GPU. The plan-time validator
     // refuses to fan out otherwise.
     useGpu: false,
diff --git a/packages/producer/src/services/render/stages/captureHdrHybridLoop.ts b/packages/producer/src/services/render/stages/captureHdrHybridLoop.ts
index 0c232da66a..1e9992f6c9 100644
--- a/packages/producer/src/services/render/stages/captureHdrHybridLoop.ts
+++ b/packages/producer/src/services/render/stages/captureHdrHybridLoop.ts
@@ -33,6 +33,7 @@ import {
   initTransparentBackground,
   initializeSession,
 } from "@hyperframes/engine";
+import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import type { FileServerHandle } from "../../fileServer.js";
 import type { ProducerLogger } from "../../../logger.js";
 import {
@@ -216,7 +217,7 @@ export async function runHybridLayeredFrameLoop(input: HybridLoopInput): Promise
       let nextRingIdx = 0;
       for (let i = range.start; i < range.end; i++) {
         assertNotAborted();
-        const time = (i * job.config.fps.den) / job.config.fps.num;
+        const time = outputFrameToTimelineSeconds(i, job.config.fps, job.config.renderStretch ?? 1);
         const activeTransition = transitionFramesSet.has(i)
           ? transitionRanges.find((t) => i >= t.startFrame && i <= t.endFrame)
           : undefined;
diff --git a/packages/producer/src/services/render/stages/captureHdrSequentialLoop.ts b/packages/producer/src/services/render/stages/captureHdrSequentialLoop.ts
index 19644eb8ae..96d16c4a2a 100644
--- a/packages/producer/src/services/render/stages/captureHdrSequentialLoop.ts
+++ b/packages/producer/src/services/render/stages/captureHdrSequentialLoop.ts
@@ -19,6 +19,7 @@ import {
   TRANSITIONS,
   crossfade,
 } from "@hyperframes/engine";
+import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import type { ProducerLogger } from "../../../logger.js";
 import {
   type HdrCompositeContext,
@@ -106,7 +107,7 @@ export async function runSequentialLayeredFrameLoop(input: SequentialLoopInput):
 
   for (let i = 0; i < totalFrames; i++) {
     assertNotAborted();
-    const time = (i * job.config.fps.den) / job.config.fps.num;
+    const time = outputFrameToTimelineSeconds(i, job.config.fps, job.config.renderStretch ?? 1);
     if (hdrPerf) hdrPerf.frames += 1;
 
     const stackingInfo = await seekInjectAndQueryStacking(
diff --git a/packages/producer/src/services/render/stages/captureStage.ts b/packages/producer/src/services/render/stages/captureStage.ts
index 808b00bffe..02ca800d62 100644
--- a/packages/producer/src/services/render/stages/captureStage.ts
+++ b/packages/producer/src/services/render/stages/captureStage.ts
@@ -52,6 +52,7 @@ import {
   initializeSession,
   prepareCaptureSessionForReuse,
 } from "@hyperframes/engine";
+import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import type { FileServerHandle } from "../../fileServer.js";
 import type { ProducerLogger } from "../../../logger.js";
 import {
@@ -316,7 +317,11 @@ export async function runCaptureStage(input: CaptureStageInput): Promise<Capture
         for (let i = 0; i < rangeFrames; i++) {
           assertNotAborted();
           const absoluteIdx = rangeStart + i;
-          const time = (absoluteIdx * job.config.fps.den) / job.config.fps.num;
+          const time = outputFrameToTimelineSeconds(
+            absoluteIdx,
+            job.config.fps,
+            job.config.renderStretch ?? 1,
+          );
           const { encodeResult } = await captureFrameToBufferPipelined(session, i, time);
           await drainPrev();
           prev = { fileIndex: i, encodeResult };
@@ -326,7 +331,11 @@ export async function runCaptureStage(input: CaptureStageInput): Promise<Capture
         for (let i = 0; i < rangeFrames; i++) {
           assertNotAborted();
           const absoluteIdx = rangeStart + i;
-          const time = (absoluteIdx * job.config.fps.den) / job.config.fps.num;
+          const time = outputFrameToTimelineSeconds(
+            absoluteIdx,
+            job.config.fps,
+            job.config.renderStretch ?? 1,
+          );
           await captureFrame(session, i, time);
           reportFrame(i);
         }
diff --git a/packages/producer/src/services/render/stages/captureStreamingStage.ts b/packages/producer/src/services/render/stages/captureStreamingStage.ts
index 364489fe24..c85acbb6f6 100644
--- a/packages/producer/src/services/render/stages/captureStreamingStage.ts
+++ b/packages/producer/src/services/render/stages/captureStreamingStage.ts
@@ -71,6 +71,7 @@ import {
   prepareCaptureSessionForReuse,
   spawnStreamingEncoder,
 } from "@hyperframes/engine";
+import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import type { FileServerHandle } from "../../fileServer.js";
 import type { ProducerLogger } from "../../../logger.js";
 import type { ProgressCallback, RenderJob } from "../../renderOrchestrator.js";
@@ -405,7 +406,8 @@ async function runWorkerEncodePipelineLoop(
   abortSignal: AbortSignal | undefined,
 ): Promise<void> {
   let prev: { idx: number; encodeResult: Promise<Buffer> } | null = null;
-  const frameTime = (i: number) => (i * job.config.fps.den) / job.config.fps.num;
+  const frameTime = (i: number) =>
+    outputFrameToTimelineSeconds(i, job.config.fps, job.config.renderStretch ?? 1);
   const guard = createDrainFrameGuard({ log, stats, frameTime });
   const guardFrame = (idx: number, buf: Buffer): Promise<Buffer> => guard(session, idx, buf);
 
@@ -640,7 +642,8 @@ export async function runCaptureStreamingStage(
       const parallelGuard = createDrainFrameGuard({
         log,
         stats: parallelStats,
-        frameTime: (i: number) => (i * job.config.fps.den) / job.config.fps.num,
+        frameTime: (i: number) =>
+          outputFrameToTimelineSeconds(i, job.config.fps, job.config.renderStretch ?? 1),
       });
       let parallelGuardRan = false;
       // First guard/write failure aborts the reorder buffer so peer workers
@@ -835,7 +838,11 @@ export async function runCaptureStreamingStage(
           let lastProgressAt = Date.now();
           for (let i = 0; i < totalFrames; i++) {
             assertNotAborted();
-            const time = (i * job.config.fps.den) / job.config.fps.num;
+            const time = outputFrameToTimelineSeconds(
+              i,
+              job.config.fps,
+              job.config.renderStretch ?? 1,
+            );
             const { buffer } = await raceAgainstStall(
               captureFrameToBuffer(session, i, time),
               stallTimeoutMs - (Date.now() - lastProgressAt),
diff --git a/packages/producer/src/services/render/stages/planHash.test.ts b/packages/producer/src/services/render/stages/planHash.test.ts
index 2ecd5913f4..8cab651648 100644
--- a/packages/producer/src/services/render/stages/planHash.test.ts
+++ b/packages/producer/src/services/render/stages/planHash.test.ts
@@ -251,3 +251,23 @@ describe("sha256Hex", () => {
     expect(sha256Hex(s)).toBe(sha256Hex(new TextEncoder().encode(s)));
   });
 });
+
+describe("computePlanHash — renderStretch byte-identity", () => {
+  const baseDims = { fpsNum: 30, fpsDen: 1, width: 1920, height: 1080, format: "mp4" as const };
+
+  it("renderStretch=1 and undefined hash identically to a pre-renderStretch plan", () => {
+    const omitted = computePlanHash(makeInput({ dimensions: { ...baseDims } }));
+    const one = computePlanHash(makeInput({ dimensions: { ...baseDims, renderStretch: 1 } }));
+    const undef = computePlanHash(
+      makeInput({ dimensions: { ...baseDims, renderStretch: undefined } }),
+    );
+    expect(one).toBe(omitted);
+    expect(undef).toBe(omitted);
+  });
+
+  it("a stretched plan (renderStretch=2) gets a distinct hash", () => {
+    const base = computePlanHash(makeInput({ dimensions: { ...baseDims } }));
+    const stretched = computePlanHash(makeInput({ dimensions: { ...baseDims, renderStretch: 2 } }));
+    expect(stretched).not.toBe(base);
+  });
+});
diff --git a/packages/producer/src/services/render/stages/planHash.ts b/packages/producer/src/services/render/stages/planHash.ts
index 127db7c244..2d49e72099 100644
--- a/packages/producer/src/services/render/stages/planHash.ts
+++ b/packages/producer/src/services/render/stages/planHash.ts
@@ -73,6 +73,8 @@ export interface PlanDimensions {
   width: number;
   height: number;
   format: DistributedFormat;
+  /** intrinsic/target timeline re-time; 1 (or omitted) = no-op, hashed identically to today. */
+  renderStretch?: number;
 }
 
 export interface PlanHashInput {
@@ -127,7 +129,10 @@ export function computePlanHash(input: PlanHashInput): string {
   hash.update(FIELD_DELIMITER);
 
   const d = input.dimensions;
-  hash.update(`${d.fpsNum}/${d.fpsDen}x${d.width}x${d.height}x${d.format}`, "utf8");
+  // Append renderStretch only when it re-times (!= 1) so unstretched plans hash identically to before.
+  const stretchSuffix =
+    d.renderStretch !== undefined && d.renderStretch !== 1 ? `x${d.renderStretch}` : "";
+  hash.update(`${d.fpsNum}/${d.fpsDen}x${d.width}x${d.height}x${d.format}${stretchSuffix}`, "utf8");
 
   return hash.digest("hex");
 }
diff --git a/packages/producer/src/services/render/stages/probeStage.ts b/packages/producer/src/services/render/stages/probeStage.ts
index 0c7510f3fd..8e155f152f 100644
--- a/packages/producer/src/services/render/stages/probeStage.ts
+++ b/packages/producer/src/services/render/stages/probeStage.ts
@@ -591,7 +591,10 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
   const browserProbeMs = Date.now() - probeStart;
 
   const duration = composition.duration;
-  const totalFrames = durationToFrameCount(duration, fpsToNumber(job.config.fps));
+  // Output length = intrinsic / renderStretch (1 = no-op); composition.duration stays intrinsic.
+  const renderStretch = job.config.renderStretch ?? 1;
+  const outputDuration = duration / renderStretch;
+  const totalFrames = durationToFrameCount(outputDuration, fpsToNumber(job.config.fps));
 
   if (duration <= 0) {
     // Gather diagnostics to help users understand why the render would produce a black video.
@@ -660,7 +663,7 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
     fileServer,
     probeSession,
     lastBrowserConsole,
-    duration,
+    duration: outputDuration,
     totalFrames,
     browserProbeMs,
     beginFrameStalled,
diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index e8d37dbf96..bcb6efcbf5 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -364,6 +364,7 @@ export interface RenderConfig {
    * alias (`1080p-portrait`). Explicit orientation presets stay strict.
    */
   outputResolutionAspectAgnostic?: boolean;
+  renderStretch?: number;
 }
 
 export interface RenderPerfSummary {
@@ -2189,6 +2190,7 @@ async function executeRenderPipeline(input: {
       width,
       height,
       fps: job.config.fps,
+      renderStretch: job.config.renderStretch ?? 1,
       format: needsAlpha ? "png" : "jpeg",
       quality: needsAlpha ? undefined : job.config.quality === "draft" ? 80 : 95,
       variables: job.config.variables,

From 12e599a6bac7dea5feec59c71dd0e5aeecab354e Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Tue, 21 Jul 2026 14:31:14 -0700
Subject: [PATCH 007/125] fix(engine): realistic worker memory budget +
 sizing/feedback telemetry

---
 .../feedback.telemetryJoinKeys.test.ts        |  39 +++++
 packages/cli/src/commands/feedback.ts         |  45 +++++-
 packages/cli/src/commands/render.ts           |  20 ++-
 packages/cli/src/telemetry/config.ts          |  45 ++++++
 packages/cli/src/telemetry/events.ts          |  31 ++++
 packages/engine/src/index.ts                  |   3 +
 .../src/services/parallelCoordinator.test.ts  |  45 ++++++
 .../src/services/parallelCoordinator.ts       | 140 +++++++++++++++---
 .../src/services/render/captureCost.ts        |  23 ++-
 .../src/services/render/perfSummary.ts        |   5 +-
 .../src/services/renderOrchestrator.ts        |  14 ++
 11 files changed, 387 insertions(+), 23 deletions(-)
 create mode 100644 packages/cli/src/commands/feedback.telemetryJoinKeys.test.ts

diff --git a/packages/cli/src/commands/feedback.telemetryJoinKeys.test.ts b/packages/cli/src/commands/feedback.telemetryJoinKeys.test.ts
new file mode 100644
index 0000000000..069fb2310f
--- /dev/null
+++ b/packages/cli/src/commands/feedback.telemetryJoinKeys.test.ts
@@ -0,0 +1,39 @@
+import { describe, expect, it } from "vitest";
+import { buildTelemetryJoinKeys } from "./feedback.js";
+
+describe("buildTelemetryJoinKeys", () => {
+  it("emits fid + tid and omits renders when the ring is empty", () => {
+    const keys = buildTelemetryJoinKeys({
+      feedbackId: "feedback-uuid",
+      anonymousId: "install-uuid",
+    });
+    expect(keys).toBe("fid=feedback-uuid tid=install-uuid");
+  });
+
+  it("appends recent render ids newest-last with a ! marking failed renders", () => {
+    const keys = buildTelemetryJoinKeys({
+      feedbackId: "f",
+      anonymousId: "t",
+      recentRenders: [
+        { id: "render-a", at: "2026-07-21T00:00:00Z", ok: true },
+        { id: "render-b", at: "2026-07-21T01:00:00Z", ok: false },
+      ],
+    });
+    expect(keys).toBe("fid=f tid=t renders=render-a,render-b!");
+  });
+
+  it("stays within the backend env cap for a full ring of uuid render ids", () => {
+    const uuid = "01234567-89ab-cdef-0123-456789abcdef";
+    const keys = buildTelemetryJoinKeys({
+      feedbackId: uuid,
+      anonymousId: uuid,
+      recentRenders: Array.from({ length: 5 }, (_, i) => ({
+        id: uuid,
+        at: "2026-07-21T00:00:00Z",
+        ok: i % 2 === 0,
+      })),
+    });
+    // submitFeedback caps env at 500 chars; the doctor summary consumes ~100.
+    expect(keys.length).toBeLessThan(400);
+  });
+});
diff --git a/packages/cli/src/commands/feedback.ts b/packages/cli/src/commands/feedback.ts
index ebae8619bc..f3be656f0f 100644
--- a/packages/cli/src/commands/feedback.ts
+++ b/packages/cli/src/commands/feedback.ts
@@ -1,4 +1,5 @@
 import { failCommand } from "../utils/commandResult.js";
+import { randomUUID } from "node:crypto";
 import { resolve } from "node:path";
 import { defineCommand } from "citty";
 import * as clack from "@clack/prompts";
@@ -7,6 +8,7 @@ import type { Example } from "./_examples.js";
 import { trackRenderFeedback } from "../telemetry/events.js";
 import { shouldTrack, flush } from "../telemetry/client.js";
 import { getDoctorSummary } from "../telemetry/feedback.js";
+import { readConfig, type RecentRenderRecord } from "../telemetry/config.js";
 import { publishProjectArchive } from "../utils/publishProject.js";
 import { submitFeedback } from "../utils/submitFeedback.js";
 import { buildIssueUrl, HYPERFRAMES_REPO_URL } from "../utils/feedbackIssue.js";
@@ -28,6 +30,27 @@ function normalizeComment(raw?: string): string | undefined {
   return raw || undefined;
 }
 
+/**
+ * Compact PostHog join keys appended to the environment string that rides
+ * along with the forwarded report (and therefore lands verbatim in the wild
+ * feedback channel): `fid` = this submission's PostHog `survey sent`
+ * `feedback_id`; `tid` = the install's telemetry distinct_id; `renders` =
+ * recent `render_job_id`s (newest last, `!` suffix = the render failed).
+ * Together they turn a wild report into an exact telemetry lookup instead of
+ * a hardware-fingerprint hunt.
+ */
+export function buildTelemetryJoinKeys(input: {
+  feedbackId: string;
+  anonymousId: string;
+  recentRenders?: RecentRenderRecord[];
+}): string {
+  const parts = [`fid=${input.feedbackId}`, `tid=${input.anonymousId}`];
+  if (input.recentRenders?.length) {
+    parts.push(`renders=${input.recentRenders.map((r) => `${r.id}${r.ok ? "" : "!"}`).join(",")}`);
+  }
+  return parts.join(" ");
+}
+
 function printIssueConsent(dir: string): void {
   console.log();
   console.log(
@@ -170,6 +193,18 @@ export default defineCommand({
     const comment = normalizeComment(args.comment);
     const doctorSummary = await getDoctorSummary();
 
+    // Join keys tying this report to the install's PostHog rows — see
+    // buildTelemetryJoinKeys. Appended to the env string so they surface in
+    // the forwarded report; mirrored as structured props on the PostHog event.
+    const feedbackId = randomUUID();
+    const config = readConfig();
+    const joinKeys = buildTelemetryJoinKeys({
+      feedbackId,
+      anonymousId: config.anonymousId,
+      recentRenders: config.recentRenders,
+    });
+    const envWithJoinKeys = doctorSummary ? `${doctorSummary} ${joinKeys}` : joinKeys;
+
     // Soft-warn (never blocks) when the comment for a non-clean report is
     // missing the mandated reproduction-packet markers. Prints before the
     // submission ack so the reporter sees the nudge while their run is fresh.
@@ -177,13 +212,19 @@ export default defineCommand({
 
     // The standalone command runs separately from `render`, so it has no real
     // elapsed time to report. Omit it rather than recording a fake duration.
-    trackRenderFeedback({ rating, comment, doctorSummary });
+    trackRenderFeedback({
+      rating,
+      comment,
+      doctorSummary,
+      feedbackId,
+      recentRenderIds: config.recentRenders?.map((r) => r.id),
+    });
 
     await flush();
     // Ack first so the user isn't kept waiting on the best-effort forward (which
     // is bounded to a few seconds and never surfaces an error either way).
     console.log(c.dim("Thanks for the feedback!"));
-    await submitFeedback({ rating, comment, cliVersion: VERSION, env: doctorSummary });
+    await submitFeedback({ rating, comment, cliVersion: VERSION, env: envWithJoinKeys });
 
     if (args["file-issue"] === true) {
       await fileGithubIssue({
diff --git a/packages/cli/src/commands/render.ts b/packages/cli/src/commands/render.ts
index a53cbfbc68..9b3d067e4c 100644
--- a/packages/cli/src/commands/render.ts
+++ b/packages/cli/src/commands/render.ts
@@ -61,7 +61,12 @@ import {
   trackRenderObservation,
 } from "../telemetry/events.js";
 import { maybePromptRenderFeedback } from "../telemetry/feedback.js";
-import { readConfigFresh, writeConfig, type HyperframesConfig } from "../telemetry/config.js";
+import {
+  readConfigFresh,
+  recordRecentRender,
+  writeConfig,
+  type HyperframesConfig,
+} from "../telemetry/config.js";
 import { shouldTrack } from "../telemetry/client.js";
 import { renderJobObservabilityTelemetryPayload } from "../telemetry/renderObservability.js";
 import { bytesToMb } from "../telemetry/system.js";
@@ -1339,6 +1344,9 @@ function handleRenderError(
     ...renderJobObservabilityTelemetryPayload(job),
     ...getMemorySnapshot(),
   });
+  // Failed renders join the recent-renders ring too — a bug report filed via
+  // `hyperframes feedback` is MOST likely to be about a failed render.
+  if (job?.id) recordRecentRender(job.id, false);
   if (options.throwOnError) {
     throw new Error(message);
   }
@@ -1376,6 +1384,9 @@ function trackRenderMetrics(
   options: RenderOptions,
   docker: boolean,
 ): void {
+  // Successful render → recent-renders ring, so a later `hyperframes
+  // feedback` can attach this render's telemetry id to the report.
+  recordRecentRender(job.id, true);
   const perf = job.perfSummary;
   const compositionDurationMs = perf
     ? Math.round(perf.compositionDurationSeconds * 1000)
@@ -1393,6 +1404,13 @@ function trackRenderMetrics(
     fps: fpsToNumber(options.fps),
     quality: options.quality,
     workers: options.workers ?? perf?.workers,
+    workersBoundBy: perf?.workerSizing?.boundBy,
+    workersCpuBased: perf?.workerSizing?.cpuBasedWorkers,
+    workersMemoryBased: perf?.workerSizing?.memoryBasedWorkers,
+    workersHeapBased: perf?.workerSizing?.heapBasedWorkers,
+    workersFrameBased: perf?.workerSizing?.frameBasedWorkers,
+    workersHeapLimitMb: perf?.workerSizing?.heapLimitMb,
+    workersExceedHeapAdvisory: perf?.workerSizing?.exceedsHeapAdvisory,
     docker,
     gpu: options.gpu,
     authoringSkill: options.authoringSkill,
diff --git a/packages/cli/src/telemetry/config.ts b/packages/cli/src/telemetry/config.ts
index 98054a71b6..cd41a4d50c 100644
--- a/packages/cli/src/telemetry/config.ts
+++ b/packages/cli/src/telemetry/config.ts
@@ -85,6 +85,39 @@ export interface HyperframesConfig {
    * `DE_PARALLEL_ROUTER_TRIAL_MAX_RENDERS` in `render.ts`.
    */
   deParallelRouterTrialRenderCount?: number;
+  /**
+   * Ring of the last few local renders (newest last). `hyperframes feedback`
+   * attaches these ids — which are the `render_job_id` /
+   * `observability_render_job_id` on this install's PostHog events — to the
+   * feedback it submits, so a wild bug report can be joined to the exact
+   * telemetry rows of the renders it describes.
+   */
+  recentRenders?: RecentRenderRecord[];
+}
+
+/** One entry in {@link HyperframesConfig.recentRenders}. */
+export interface RecentRenderRecord {
+  /** The render job id (`RenderJob.id` — the telemetry `render_job_id`). */
+  id: string;
+  /** ISO timestamp of when the render finished. */
+  at: string;
+  /** Whether the render completed successfully. */
+  ok: boolean;
+}
+
+/** Ring size for {@link HyperframesConfig.recentRenders}. */
+const MAX_RECENT_RENDERS = 5;
+
+/**
+ * Append a finished render to the recent-renders ring (newest last, capped).
+ * Fresh read-modify-write like the trial counters — narrows, but does not
+ * eliminate, lost updates against a concurrent CLI process.
+ */
+export function recordRecentRender(id: string, ok: boolean): void {
+  const config = readConfigFresh();
+  const ring = [...(config.recentRenders ?? []), { id, at: new Date().toISOString(), ok }];
+  config.recentRenders = ring.slice(-MAX_RECENT_RENDERS);
+  writeConfig(config);
 }
 
 const DEFAULT_CONFIG: HyperframesConfig = {
@@ -142,6 +175,18 @@ export function readConfig(): HyperframesConfig {
         typeof parsed.deParallelRouterTrialRenderCount === "number"
           ? parsed.deParallelRouterTrialRenderCount
           : undefined,
+      recentRenders: Array.isArray(parsed.recentRenders)
+        ? parsed.recentRenders
+            .filter(
+              (r): r is RecentRenderRecord =>
+                typeof r === "object" &&
+                r !== null &&
+                typeof (r as RecentRenderRecord).id === "string" &&
+                typeof (r as RecentRenderRecord).at === "string" &&
+                typeof (r as RecentRenderRecord).ok === "boolean",
+            )
+            .slice(-MAX_RECENT_RENDERS)
+        : undefined,
     };
 
     cachedConfig = config;
diff --git a/packages/cli/src/telemetry/events.ts b/packages/cli/src/telemetry/events.ts
index 9e100ae3ee..23085eb342 100644
--- a/packages/cli/src/telemetry/events.ts
+++ b/packages/cli/src/telemetry/events.ts
@@ -149,6 +149,17 @@ export function trackRenderComplete(
     /** Authoring workflow skill that drove this render (e.g. "product-launch-video"). */
     authoringSkill?: string;
     workers?: number;
+    // Worker auto-sizing provenance (RenderPerfSummary.workerSizing). Answers
+    // "why N workers?" fleet-wide, and validates the advisory per-worker heap
+    // budget before it's enforced (field OOM: 6 auto workers on a 24GB/4GB-heap
+    // machine — see computeWorkerSizing in @hyperframes/engine).
+    workersBoundBy?: string;
+    workersCpuBased?: number;
+    workersMemoryBased?: number;
+    workersHeapBased?: number;
+    workersFrameBased?: number;
+    workersHeapLimitMb?: number;
+    workersExceedHeapAdvisory?: boolean;
     docker: boolean;
     gpu: boolean;
     // Static-frame dedup outcome (opt-out HF_STATIC_DEDUP=false). Undefined on
@@ -245,6 +256,13 @@ export function trackRenderComplete(
       quality: props.quality,
       authoring_skill: props.authoringSkill,
       workers: props.workers,
+      workers_bound_by: props.workersBoundBy,
+      workers_cpu_based: props.workersCpuBased,
+      workers_memory_based: props.workersMemoryBased,
+      workers_heap_based: props.workersHeapBased,
+      workers_frame_based: props.workersFrameBased,
+      workers_heap_limit_mb: props.workersHeapLimitMb,
+      workers_exceed_heap_advisory: props.workersExceedHeapAdvisory,
       docker: props.docker,
       gpu: props.gpu,
       static_dedup_enabled: props.staticDedupEnabled,
@@ -609,6 +627,14 @@ export function trackRenderFeedback(props: {
   renderDurationMs?: number;
   comment?: string;
   doctorSummary?: string;
+  /**
+   * Join key shared with the forwarded feedback report (Slack/backend): the
+   * same uuid rides in the report's env string as `fid=…`, so a wild report
+   * resolves to exactly one PostHog "survey sent" event and vice versa.
+   */
+  feedbackId?: string;
+  /** render_job_id values of this install's recent renders (newest last). */
+  recentRenderIds?: string[];
 }): void {
   trackEvent("survey sent", {
     $survey_id: "render_satisfaction",
@@ -617,6 +643,11 @@ export function trackRenderFeedback(props: {
     ...(props.comment ? { $survey_response_2: props.comment } : {}),
     ...(props.renderDurationMs !== undefined ? { render_duration_ms: props.renderDurationMs } : {}),
     ...(props.doctorSummary ? { doctor_summary: props.doctorSummary } : {}),
+    ...(props.feedbackId ? { feedback_id: props.feedbackId } : {}),
+    // Comma-joined: EventProperties values are scalars only.
+    ...(props.recentRenderIds?.length
+      ? { recent_render_ids: props.recentRenderIds.join(",") }
+      : {}),
   });
 }
 
diff --git a/packages/engine/src/index.ts b/packages/engine/src/index.ts
index c90bab6f6c..62ed54ab22 100644
--- a/packages/engine/src/index.ts
+++ b/packages/engine/src/index.ts
@@ -208,6 +208,7 @@ export type {
 // ── Parallel rendering ─────────────────────────────────────────────────────────
 export {
   calculateOptimalWorkers,
+  computeWorkerSizing,
   distributeFrames,
   distributeFramesInterleaved,
   executeParallelCapture,
@@ -215,6 +216,8 @@ export {
   getSystemResources,
   type WorkerTask,
   type WorkerResult,
+  type WorkerSizing,
+  type WorkerSizingBound,
   type ParallelProgress,
 } from "./services/parallelCoordinator.js";
 
diff --git a/packages/engine/src/services/parallelCoordinator.test.ts b/packages/engine/src/services/parallelCoordinator.test.ts
index 91d294bad8..31f7b59410 100644
--- a/packages/engine/src/services/parallelCoordinator.test.ts
+++ b/packages/engine/src/services/parallelCoordinator.test.ts
@@ -1,6 +1,7 @@
 import { describe, it, expect } from "vitest";
 import {
   calculateOptimalWorkers,
+  computeWorkerSizing,
   distributeFrames,
   expectedFramesForTask,
   flagSilentWorkerExits,
@@ -93,6 +94,50 @@ describe("calculateOptimalWorkers", () => {
   });
 });
 
+describe("computeWorkerSizing", () => {
+  it("matches calculateOptimalWorkers and reports every constraint", () => {
+    const config = { concurrency: "auto" as const };
+    const sizing = computeWorkerSizing(900, undefined, config);
+    expect(sizing.workers).toBe(calculateOptimalWorkers(900, undefined, config));
+    expect(sizing.cpuBasedWorkers).toBeGreaterThanOrEqual(1);
+    expect(sizing.memoryBasedWorkers).toBeGreaterThanOrEqual(1);
+    expect(sizing.heapBasedWorkers).toBeGreaterThanOrEqual(1);
+    expect(sizing.frameBasedWorkers).toBe(30); // 900 / MIN_FRAMES_PER_WORKER(30)
+    expect(sizing.heapLimitMb).toBeGreaterThan(0);
+    expect(sizing.totalMemoryMb).toBeGreaterThan(0);
+    expect(sizing.cpuCount).toBeGreaterThan(0);
+  });
+
+  it("labels explicit requests and clamps them like the legacy wrapper", () => {
+    const sizing = computeWorkerSizing(900, 25, { concurrency: "auto" });
+    expect(sizing.workers).toBe(24);
+    expect(sizing.boundBy).toBe("explicit");
+  });
+
+  it("labels tiny renders as too_few_frames", () => {
+    const sizing = computeWorkerSizing(30, undefined, { concurrency: "auto" });
+    expect(sizing.workers).toBe(1);
+    expect(sizing.boundBy).toBe("too_few_frames");
+  });
+
+  it("labels the contention cap when high capture cost binds", () => {
+    const sizing = computeWorkerSizing(180, undefined, {
+      concurrency: 6,
+      coresPerWorker: 100,
+      minParallelFrames: 120,
+      largeRenderThreshold: 1000,
+      captureCostMultiplier: 4,
+    });
+    expect(sizing.workers).toBe(1);
+    expect(sizing.boundBy).toBe("contention");
+  });
+
+  it("flags exceedsHeapAdvisory exactly when workers exceed the heap budget", () => {
+    const sizing = computeWorkerSizing(900, 24, { concurrency: "auto" });
+    expect(sizing.exceedsHeapAdvisory).toBe(sizing.workers > sizing.heapBasedWorkers);
+  });
+});
+
 describe("shouldDisableBrowserPoolForParallelWorker", () => {
   const linuxHeadlessWorker = {
     parallel: true,
diff --git a/packages/engine/src/services/parallelCoordinator.ts b/packages/engine/src/services/parallelCoordinator.ts
index d6c028e4a3..b3608349dc 100644
--- a/packages/engine/src/services/parallelCoordinator.ts
+++ b/packages/engine/src/services/parallelCoordinator.ts
@@ -9,6 +9,7 @@ import { cpus, freemem } from "os";
 import { existsSync, mkdirSync, readdirSync } from "fs";
 import { copyFile, rename } from "fs/promises";
 import { join } from "path";
+import { getHeapStatistics } from "v8";
 
 import {
   createCaptureSession,
@@ -109,7 +110,21 @@ type WorkerBrowserPoolDecision = {
   headlessShellPath?: string;
 };
 
-const MEMORY_PER_WORKER_MB = 256;
+// System-memory budget per parallel worker. Each worker is a full Chrome
+// process (SwiftShader compositor + raster threads) plus its share of parent-
+// process frame buffering — the old 256MB figure was ~6× under a measured
+// Chrome-under-capture RSS and let memory-constrained hosts overcommit (wild
+// 16GB black-slab report; 0.7.66 heap-OOM report on 24GB with 6 auto workers).
+const MEMORY_PER_WORKER_MB = 1536;
+// Parent-process V8 heap the coordinator itself needs regardless of worker
+// count (compile artifacts, puppeteer sessions, encoder state).
+const HEAP_RESERVED_MB = 1024;
+// Parent-process V8 heap consumed per worker (protocol buffers + in-flight
+// frame buffers). Derived from the field OOM: 6 workers exhausted a ~4GB
+// default heap ⇒ >~500MB/worker + base. ponytail: advisory-only until the
+// workers_heap_* telemetry added alongside this constant validates the figure
+// — enforcing a guessed budget could silently cut worker counts fleet-wide.
+const HEAP_PER_WORKER_MB = 640;
 const MIN_WORKERS = 1;
 const MAX_WORKER_DIAGNOSTIC_LINES = 8;
 // Hard ceiling on explicit `--workers N` requests. Above this, the cost of
@@ -230,13 +245,95 @@ export function formatWorkerFailure(result: WorkerResult): string {
   return `${base}; diagnostics: ${diagnostics}`;
 }
 
-export function calculateOptimalWorkers(
+/** Which constraint produced the final auto-sized worker count. */
+export type WorkerSizingBound =
+  | "explicit"
+  | "too_few_frames"
+  | "cpu"
+  | "memory"
+  | "frames"
+  | "max_workers"
+  | "min_parallel_floor"
+  | "contention";
+
+/**
+ * Full provenance of a worker-sizing decision. Threaded into render
+ * observability/telemetry so fleet data can answer "why N workers?" and
+ * "would the heap budget have prevented this OOM?" without a repro.
+ */
+export interface WorkerSizing {
+  workers: number;
+  boundBy: WorkerSizingBound;
+  cpuBasedWorkers: number;
+  memoryBasedWorkers: number;
+  frameBasedWorkers: number;
+  effectiveMaxWorkers: number;
+  /**
+   * ADVISORY, not enforced (see HEAP_PER_WORKER_MB): how many workers the
+   * parent process's V8 heap could feed. Compare against `workers` in
+   * telemetry to validate the budget before enforcement.
+   */
+  heapBasedWorkers: number;
+  /** V8 `heap_size_limit` for the parent process, MB. */
+  heapLimitMb: number;
+  totalMemoryMb: number;
+  cpuCount: number;
+  captureCostMultiplier: number;
+  /** true when the chosen count exceeds the advisory heap budget. */
+  exceedsHeapAdvisory: boolean;
+}
+
+/**
+ * Compute the auto worker count together with the full sizing provenance.
+ * `calculateOptimalWorkers` is the thin legacy wrapper returning `.workers`.
+ */
+// The branch count is the decision provenance itself — each if records WHICH
+// constraint bound, which is the entire point of the function.
+// fallow-ignore-next-line complexity
+export function computeWorkerSizing(
   totalFrames: number,
   requested?: number,
   config?: WorkerSizingConfig,
-): number {
+): WorkerSizing {
+  const cpuCount = cpus().length;
+  // Use total memory instead of free memory — macOS reports misleadingly low
+  // freemem() because it aggressively caches files in "inactive" memory that
+  // is immediately reclaimable.
+  const totalMemoryMb = getSystemTotalMb();
+  const heapLimitMb = Math.round(getHeapStatistics().heap_size_limit / (1024 * 1024));
+  const heapBasedWorkers = Math.max(
+    1,
+    Math.floor((heapLimitMb - HEAP_RESERVED_MB) / HEAP_PER_WORKER_MB),
+  );
+  const cpuBasedWorkers = Math.max(1, cpuCount - 2);
+  const memoryBasedWorkers = Math.max(1, Math.floor((totalMemoryMb * 0.5) / MEMORY_PER_WORKER_MB));
+  const frameBasedWorkers = Math.floor(totalFrames / MIN_FRAMES_PER_WORKER);
+  const captureCostMultiplier = Math.max(1, config?.captureCostMultiplier ?? 1);
+
+  const base = {
+    cpuBasedWorkers,
+    memoryBasedWorkers,
+    frameBasedWorkers,
+    heapBasedWorkers,
+    heapLimitMb,
+    totalMemoryMb,
+    cpuCount,
+    captureCostMultiplier,
+  };
+  const finish = (workers: number, boundBy: WorkerSizingBound, effectiveMaxWorkers: number) => ({
+    workers,
+    boundBy,
+    effectiveMaxWorkers,
+    ...base,
+    exceedsHeapAdvisory: workers > heapBasedWorkers,
+  });
+
   if (requested !== undefined) {
-    return Math.max(MIN_WORKERS, Math.min(ABSOLUTE_MAX_WORKERS, requested));
+    return finish(
+      Math.max(MIN_WORKERS, Math.min(ABSOLUTE_MAX_WORKERS, requested)),
+      "explicit",
+      ABSOLUTE_MAX_WORKERS,
+    );
   }
 
   // Resolve effective values: config overrides → DEFAULT_CONFIG fallback.
@@ -251,24 +348,22 @@ export function calculateOptimalWorkers(
   const effectiveMinParallelFrames = config?.minParallelFrames ?? DEFAULT_CONFIG.minParallelFrames;
   const effectiveLargeRenderThreshold =
     config?.largeRenderThreshold ?? DEFAULT_CONFIG.largeRenderThreshold;
-  const captureCostMultiplier = Math.max(1, config?.captureCostMultiplier ?? 1);
-
-  if (totalFrames < MIN_FRAMES_PER_WORKER * 2) return 1;
 
-  const cpuCount = cpus().length;
-  const cpuBasedWorkers = Math.max(1, cpuCount - 2);
-
-  // Use total memory instead of free memory — macOS reports misleadingly low
-  // freemem() because it aggressively caches files in "inactive" memory that
-  // is immediately reclaimable.
-  const totalMemoryMB = getSystemTotalMb();
-  const memoryBasedWorkers = Math.max(1, Math.floor((totalMemoryMB * 0.5) / MEMORY_PER_WORKER_MB));
-
-  const frameBasedWorkers = Math.floor(totalFrames / MIN_FRAMES_PER_WORKER);
+  if (totalFrames < MIN_FRAMES_PER_WORKER * 2) {
+    return finish(1, "too_few_frames", effectiveMaxWorkers);
+  }
 
   const optimal = Math.min(cpuBasedWorkers, memoryBasedWorkers, frameBasedWorkers);
+  const optimalBound: WorkerSizingBound =
+    optimal === cpuBasedWorkers ? "cpu" : optimal === memoryBasedWorkers ? "memory" : "frames";
   const minWorkersForJob = totalFrames >= effectiveMinParallelFrames ? 2 : MIN_WORKERS;
   let finalWorkers = Math.max(minWorkersForJob, Math.min(effectiveMaxWorkers, optimal));
+  let boundBy: WorkerSizingBound =
+    finalWorkers === optimal
+      ? optimalBound
+      : finalWorkers === effectiveMaxWorkers && effectiveMaxWorkers < optimal
+        ? "max_workers"
+        : "min_parallel_floor";
 
   // Adaptive scaling: cap workers for large or expensive renders to prevent
   // CPU contention. Each Chrome process (with SwiftShader) is CPU-heavy; too
@@ -285,10 +380,19 @@ export function calculateOptimalWorkers(
     const cpuScaledMax = Math.max(MIN_WORKERS, Math.floor(cpuCount / weightedCoresPerWorker));
     if (finalWorkers > cpuScaledMax) {
       finalWorkers = cpuScaledMax;
+      boundBy = "contention";
     }
   }
 
-  return finalWorkers;
+  return finish(finalWorkers, boundBy, effectiveMaxWorkers);
+}
+
+export function calculateOptimalWorkers(
+  totalFrames: number,
+  requested?: number,
+  config?: WorkerSizingConfig,
+): number {
+  return computeWorkerSizing(totalFrames, requested, config).workers;
 }
 
 export function distributeFrames(
diff --git a/packages/producer/src/services/render/captureCost.ts b/packages/producer/src/services/render/captureCost.ts
index 3a12d790ba..ccf0f5b23d 100644
--- a/packages/producer/src/services/render/captureCost.ts
+++ b/packages/producer/src/services/render/captureCost.ts
@@ -16,9 +16,11 @@ import {
   type CaptureOptions,
   type CaptureSession,
   type EngineConfig,
+  type WorkerSizing,
   calculateOptimalWorkers,
   captureFrameToBuffer,
   closeCaptureSession,
+  computeWorkerSizing,
   createCaptureSession,
   initializeSession,
 } from "@hyperframes/engine";
@@ -113,6 +115,8 @@ export function resolveRenderWorkerCount(
   compiled: Pick<CompiledComposition, "hasShaderTransitions" | "renderModeHints">,
   log: ProducerLogger = defaultLogger,
   measuredCaptureCost?: CaptureCostEstimate,
+  /** Sink for the sizing provenance so the orchestrator can thread it into telemetry. */
+  onSizing?: (sizing: WorkerSizing) => void,
 ): number {
   // TODO(htmlInCanvas): workaround — Chrome's experimental drawElementImage
   // API (CanvasDrawElement) is non-deterministic across concurrent browser
@@ -144,10 +148,27 @@ export function resolveRenderWorkerCount(
     estimateCaptureCostMultiplier(compiled),
     measuredCaptureCost,
   );
-  const workerCount = calculateOptimalWorkers(totalFrames, requestedWorkers, {
+  const sizing = computeWorkerSizing(totalFrames, requestedWorkers, {
     ...cfg,
     captureCostMultiplier: captureCost.multiplier,
   });
+  onSizing?.(sizing);
+  const workerCount = sizing.workers;
+
+  // Advisory heap check (field OOM, 0.7.66 on 24GB: auto-picked 6 workers
+  // blew Node's default ~4GB heap). Not enforced yet — the budget constant is
+  // derived from one field report; the workers_heap_* telemetry emitted with
+  // this sizing decides whether to enforce. The warning gives the operator
+  // the actionable knobs today.
+  if (sizing.exceedsHeapAdvisory) {
+    log.warn(
+      `[Render] ${workerCount} capture workers may exceed this process's V8 heap ` +
+        `(limit ${sizing.heapLimitMb}MB supports ~${sizing.heapBasedWorkers}). If the render ` +
+        `dies with "JavaScript heap out of memory", raise the heap ` +
+        `(NODE_OPTIONS=--max-old-space-size=8192) or pass --workers ${sizing.heapBasedWorkers}.`,
+      { heapLimitMb: sizing.heapLimitMb, heapBasedWorkers: sizing.heapBasedWorkers },
+    );
+  }
 
   if (requestedWorkers !== undefined || captureCost.multiplier <= 1) {
     return workerCount;
diff --git a/packages/producer/src/services/render/perfSummary.ts b/packages/producer/src/services/render/perfSummary.ts
index 1b0b790dd3..2e288edc4c 100644
--- a/packages/producer/src/services/render/perfSummary.ts
+++ b/packages/producer/src/services/render/perfSummary.ts
@@ -4,7 +4,7 @@
  */
 
 import { fpsToNumber } from "@hyperframes/core";
-import type { CapturePerfSummary, SubTimelineWaitOutcome } from "@hyperframes/engine";
+import type { CapturePerfSummary, SubTimelineWaitOutcome, WorkerSizing } from "@hyperframes/engine";
 import type { CaptureCalibrationSample, CaptureCostEstimate } from "./captureCost.js";
 import type {
   CaptureAttemptSummary,
@@ -181,6 +181,8 @@ function aggregateBeginFrameReuse(
 export function buildRenderPerfSummary(input: {
   job: RenderJob;
   workerCount: number;
+  /** Auto-sizing provenance; undefined when a pin (htmlInCanvas / low-memory) short-circuited sizing. */
+  workerSizing?: WorkerSizing;
   enableChunkedEncode: boolean;
   chunkedEncodeSize: number;
   compositionDurationSeconds: number;
@@ -217,6 +219,7 @@ export function buildRenderPerfSummary(input: {
     fps: fpsToNumber(input.job.config.fps),
     quality: input.job.config.quality,
     workers: input.workerCount,
+    workerSizing: input.workerSizing,
     chunkedEncode: input.enableChunkedEncode,
     chunkSizeFrames: input.enableChunkedEncode ? input.chunkedEncodeSize : null,
     compositionDurationSeconds: input.compositionDurationSeconds,
diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index bcb6efcbf5..ad5836d76a 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -76,6 +76,7 @@ import {
   type CapturePerfSummary,
   type CaptureWarning,
   type SubTimelineWaitOutcome,
+  type WorkerSizing,
   resolveBrowserGpuMode,
   resolveHeadlessShellPath,
   applyConcreteGpuScreenshotClamp,
@@ -373,6 +374,14 @@ export interface RenderPerfSummary {
   fps: number;
   quality: string;
   workers: number;
+  /**
+   * Provenance of the auto worker-sizing decision (undefined when the
+   * htmlInCanvas / low-memory pins short-circuited sizing). `boundBy` names
+   * the binding constraint; the heap fields are the advisory budget being
+   * validated by fleet telemetry before enforcement — see
+   * `computeWorkerSizing` in @hyperframes/engine.
+   */
+  workerSizing?: WorkerSizing;
   chunkedEncode: boolean;
   chunkSizeFrames: number | null;
   compositionDurationSeconds: number;
@@ -1703,6 +1712,7 @@ async function executeRenderPipeline(input: {
   // "routed" = the parallel router fired and held; "reverted" = fired but
   // the self-verify retry rolled back; undefined = never fired.
   let deParallelRouter: "routed" | "reverted" | undefined;
+  let workerSizing: WorkerSizing | undefined;
 
   execution.defer("rollback staged artifact", () => artifactTransaction.rollback());
   execution.defer("close file server", () => {
@@ -2475,6 +2485,9 @@ async function executeRenderPipeline(input: {
       compiled,
       log,
       captureCalibration?.estimate,
+      (sizing) => {
+        workerSizing = sizing;
+      },
     );
     // DE priority inversion — see shouldPreferSingleWorkerDrawElement for the
     // policy and benchmark rationale (eligibility resolved above, before
@@ -3281,6 +3294,7 @@ async function executeRenderPipeline(input: {
     const perfSummary = buildRenderPerfSummary({
       job,
       workerCount,
+      workerSizing,
       enableChunkedEncode,
       chunkedEncodeSize,
       compositionDurationSeconds: composition.duration,

From 63539a0cdef75597d2e301736740cf3bdd905596 Mon Sep 17 00:00:00 2001
From: Hblee <hblee12294@gmail.com>
Date: Tue, 21 Jul 2026 16:48:33 -0700
Subject: [PATCH 008/125] fix(core): apply position edits to SVG elements, not
 just HTML (#2724)

---
 .../generated/position-edits-render-inline.ts |  2 +-
 .../core/src/runtime/positionEdits.test.ts    | 14 ++++++++++
 packages/core/src/runtime/positionEdits.ts    | 28 ++++++++++++++-----
 3 files changed, 36 insertions(+), 8 deletions(-)

diff --git a/packages/core/src/generated/position-edits-render-inline.ts b/packages/core/src/generated/position-edits-render-inline.ts
index 7efed91bb8..65623802ee 100644
--- a/packages/core/src/generated/position-edits-render-inline.ts
+++ b/packages/core/src/generated/position-edits-render-inline.ts
@@ -1,6 +1,6 @@
 // AUTO-GENERATED by scripts/build-position-edits-render.ts - do not edit
 const POSITION_EDITS_RENDER_IIFE: string =
-  '"use strict";(()=>{function A(){return globalThis}function P(e,t){if(typeof window>"u")return;let o=A(),r=o.__hf?.onSwallowed;if(r)try{r({label:e,error:t})}catch(i){}(o.__hfDebug||o.__HYPERFRAMES_DEBUG)&&console.debug(`[hyperframes] ${e} swallowed:`,t)}var T=null;function R(e,t){if(T)try{T({source:"hf-preview",type:"analytics",event:e,properties:t??{}})}catch(o){P("runtime.analytics.site1",o)}}var m="data-hf-edit-base-x",b="data-hf-edit-base-y",w="data-hf-edit-original-translate",k=e=>{let t=parseFloat(e??"");return Number.isFinite(t)?t:0},H=e=>{let t=[],o=0,r="";for(let i of e.trim())i==="("&&(o+=1),i===")"&&(o=Math.max(0,o-1)),/\\s/.test(i)&&o===0?(r&&t.push(r),r=""):r+=i;return r&&t.push(r),t},$=/^-?(?:\\d+(?:\\.\\d+)?|\\.\\d+)px$/,E=(e,t)=>$.test(e)&&$.test(t)?`${parseFloat(e)+parseFloat(t)}px`:`calc(${e} + ${t})`,I=(e,t,o)=>{if(!e||e==="none")return`${t} ${o}`;let[r,i,l]=H(e);if(r===void 0)return`${t} ${o}`;if(i===void 0)return`${E(r,t)} ${o}`;let d=l===void 0?"":` ${l}`;return`${E(r,t)} ${E(i,o)}${d}`},O=e=>{try{e.ownerDocument.defaultView?.gsap?.getProperty?.(e,"x")}catch{}},j=e=>{let t=e.style.getPropertyValue("translate").trim();if(t)return t==="none"?"":t;try{let o=e.ownerDocument.defaultView,r=o?o.getComputedStyle(e).getPropertyValue("translate").trim():"";return r==="none"?"":r}catch{return""}},S=new WeakMap;function V(e,t){let o=S.get(e);if(!t?.force&&o!==void 0&&e.style.getPropertyValue("translate")!==o){R("position_edit_fold_skipped",{hfId:e.getAttribute("data-hf-id")});return}let r=k(e.getAttribute("data-x"))-k(e.getAttribute(m)),i=k(e.getAttribute("data-y"))-k(e.getAttribute(b));e.hasAttribute(w)||e.setAttribute(w,j(e)),o===void 0&&O(e);let l=e.getAttribute(w)??"",d=I(l,`${r}px`,`${i}px`);e.style.setProperty("translate",d),S.set(e,e.style.getPropertyValue("translate"))}function h(e,t){let o=e.defaultView?.HTMLElement,r=u=>o?u instanceof o:typeof u.style?.setProperty=="function",i=e.querySelectorAll(`[${w}]:not([${m}]):not([${b}])`);for(let u=0;u<i.length;u++){let a=i[u];if(a===void 0||!r(a))continue;let _=a.getAttribute(w)??"";_===""?a.style.removeProperty("translate"):a.style.setProperty("translate",_),a.removeAttribute(w),S.delete(a)}let l=e.querySelectorAll(`[${m}], [${b}]`),d=0;for(let u=0;u<l.length;u++){let a=l[u];a===void 0||!r(a)||(V(a,t),d+=1)}return d}var x="__hfPositionEditsSeekReapplyWrapped",D=new WeakSet,F=new WeakMap,L=new WeakMap;function M(e){let t=e,o=()=>{try{h(t.document)}catch{}},r=n=>typeof n=="function"&&(D.has(n)||!!n[x]),i=n=>{D.add(n);try{Object.defineProperty(n,x,{value:!0})}catch{}},l=n=>{if(typeof n!="function"||r(n))return n;let s=function(...c){let f=n.apply(this,c);return o(),f};return i(s),s},d=(n,s)=>{let c=F.get(n);if(c?.has(s))return!0;let f=Object.getOwnPropertyDescriptor(n,s);if(f?.configurable===!1){let p=n[s];return typeof p=="function"&&(n[s]=l(p),o()),!1}let g=n[s],y=f?.set;return Object.defineProperty(n,s,{configurable:!0,enumerable:f?.enumerable??!0,get:()=>g,set:p=>{g=l(p),y?.call(n,p)}}),g=l(g),c??(c=new Set),c.add(s),F.set(n,c),o(),!0},u=(n,s)=>{let c=L.get(t),f=Object.getOwnPropertyDescriptor(t,n);if(!c?.has(n)){if(f?.configurable===!1){let p=t[n];return p?d(p,s):!1}let y=t[n];Object.defineProperty(t,n,{configurable:!0,enumerable:f?.enumerable??!0,get:()=>y,set:p=>{y=p,y&&d(y,s)}}),c??(c=new Set),c.add(n),L.set(t,c)}let g=t[n];return g?d(g,s):!1},a=()=>{let n=u("__hf","seek"),s=u("__player","renderSeek");return n&&s};if(a())return;let _=120,v=t.setInterval(()=>{if(a()){t.clearInterval(v);return}_-=1,_<=0&&t.clearInterval(v)},50)}function W(){document.querySelector(`[${m}], [${b}]`)&&(h(document),M(window))}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",W,{once:!0}):W();})();\n';
+  '"use strict";(()=>{function A(){return globalThis}function P(e,t){if(typeof window>"u")return;let n=A(),r=n.__hf?.onSwallowed;if(r)try{r({label:e,error:t})}catch(i){}(n.__hfDebug||n.__HYPERFRAMES_DEBUG)&&console.debug(`[hyperframes] ${e} swallowed:`,t)}var T=null;function R(e,t){if(T)try{T({source:"hf-preview",type:"analytics",event:e,properties:t??{}})}catch(n){P("runtime.analytics.site1",n)}}var _="data-hf-edit-base-x",S="data-hf-edit-base-y",m="data-hf-edit-original-translate",E=e=>{let t=parseFloat(e??"");return Number.isFinite(t)?t:0},V=e=>{let t=[],n=0,r="";for(let i of e.trim())i==="("&&(n+=1),i===")"&&(n=Math.max(0,n-1)),/\\s/.test(i)&&n===0?(r&&t.push(r),r=""):r+=i;return r&&t.push(r),t},$=/^-?(?:\\d+(?:\\.\\d+)?|\\.\\d+)px$/,k=(e,t)=>$.test(e)&&$.test(t)?`${parseFloat(e)+parseFloat(t)}px`:`calc(${e} + ${t})`,I=(e,t,n)=>{if(!e||e==="none")return`${t} ${n}`;let[r,i,u]=V(e);if(r===void 0)return`${t} ${n}`;if(i===void 0)return`${k(r,t)} ${n}`;let d=u===void 0?"":` ${u}`;return`${k(r,t)} ${k(i,n)}${d}`},O=e=>{try{e.ownerDocument.defaultView?.gsap?.getProperty?.(e,"x")}catch{}},G=e=>{let t=e.style.getPropertyValue("translate").trim();if(t)return t==="none"?"":t;try{let n=e.ownerDocument.defaultView,r=n?n.getComputedStyle(e).getPropertyValue("translate").trim():"";return r==="none"?"":r}catch{return""}},h=new WeakMap;function H(e,t){let n=h.get(e);if(!t?.force&&n!==void 0&&e.style.getPropertyValue("translate")!==n){R("position_edit_fold_skipped",{hfId:e.getAttribute("data-hf-id")});return}let r=E(e.getAttribute("data-x"))-E(e.getAttribute(_)),i=E(e.getAttribute("data-y"))-E(e.getAttribute(S));e.hasAttribute(m)||e.setAttribute(m,G(e)),n===void 0&&O(e);let u=e.getAttribute(m)??"",d=I(u,`${r}px`,`${i}px`);e.style.setProperty("translate",d),h.set(e,e.style.getPropertyValue("translate"))}function v(e,t){let n=e.defaultView?.HTMLElement,r=e.defaultView?.SVGElement,i=a=>n||r?n!==void 0&&a instanceof n||r!==void 0&&a instanceof r:typeof a.style?.setProperty=="function",u=e.querySelectorAll(`[${m}]:not([${_}]):not([${S}])`);for(let a=0;a<u.length;a++){let l=u[a];if(l===void 0||!i(l))continue;let w=l.getAttribute(m)??"";w===""?l.style.removeProperty("translate"):l.style.setProperty("translate",w),l.removeAttribute(m),h.delete(l)}let d=e.querySelectorAll(`[${_}], [${S}]`),b=0;for(let a=0;a<d.length;a++){let l=d[a];l===void 0||!i(l)||(H(l,t),b+=1)}return b}var x="__hfPositionEditsSeekReapplyWrapped",D=new WeakSet,F=new WeakMap,W=new WeakMap;function L(e){let t=e,n=()=>{try{v(t.document)}catch{}},r=o=>typeof o=="function"&&(D.has(o)||!!o[x]),i=o=>{D.add(o);try{Object.defineProperty(o,x,{value:!0})}catch{}},u=o=>{if(typeof o!="function"||r(o))return o;let s=function(...c){let f=o.apply(this,c);return n(),f};return i(s),s},d=(o,s)=>{let c=F.get(o);if(c?.has(s))return!0;let f=Object.getOwnPropertyDescriptor(o,s);if(f?.configurable===!1){let p=o[s];return typeof p=="function"&&(o[s]=u(p),n()),!1}let g=o[s],y=f?.set;return Object.defineProperty(o,s,{configurable:!0,enumerable:f?.enumerable??!0,get:()=>g,set:p=>{g=u(p),y?.call(o,p)}}),g=u(g),c??(c=new Set),c.add(s),F.set(o,c),n(),!0},b=(o,s)=>{let c=W.get(t),f=Object.getOwnPropertyDescriptor(t,o);if(!c?.has(o)){if(f?.configurable===!1){let p=t[o];return p?d(p,s):!1}let y=t[o];Object.defineProperty(t,o,{configurable:!0,enumerable:f?.enumerable??!0,get:()=>y,set:p=>{y=p,y&&d(y,s)}}),c??(c=new Set),c.add(o),W.set(t,c)}let g=t[o];return g?d(g,s):!1},a=()=>{let o=b("__hf","seek"),s=b("__player","renderSeek");return o&&s};if(a())return;let l=120,w=t.setInterval(()=>{if(a()){t.clearInterval(w);return}l-=1,l<=0&&t.clearInterval(w)},50)}function M(){document.querySelector(`[${_}], [${S}]`)&&(v(document),L(window))}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",M,{once:!0}):M();})();\n';
 
 /** Returns the pre-built position-edits render IIFE as a string constant. */
 export function getPositionEditsRenderScript(): string {
diff --git a/packages/core/src/runtime/positionEdits.test.ts b/packages/core/src/runtime/positionEdits.test.ts
index 083da9588e..437fc298da 100644
--- a/packages/core/src/runtime/positionEdits.test.ts
+++ b/packages/core/src/runtime/positionEdits.test.ts
@@ -59,6 +59,20 @@ describe("applyPositionEdits", () => {
     el.remove();
   });
 
+  it("applies the delta to an SVG element (e.g. an authored <text> label), not just HTML", () => {
+    // SVG graphics are positioned via the same CSS `translate` longhand; the old HTML-only guard
+    // silently dropped SVG moves. Regression guard: an SVG <text> must be counted AND translated.
+    const el = document.createElementNS("http://www.w3.org/2000/svg", "text");
+    el.setAttribute("data-x", "145");
+    el.setAttribute("data-y", "1");
+    el.setAttribute(EDIT_BASE_X_ATTR, "0");
+    el.setAttribute(EDIT_BASE_Y_ATTR, "0");
+    document.body.appendChild(el);
+    expect(applyPositionEdits(document)).toBe(1);
+    expect(el.style.getPropertyValue("translate")).toBe("145px 1px");
+    el.remove();
+  });
+
   it("treats missing data-x/y or baseline attributes as 0", () => {
     const el = makeElement({ "data-x": "40", [EDIT_BASE_X_ATTR]: "0" });
     applyPositionEdits(document);
diff --git a/packages/core/src/runtime/positionEdits.ts b/packages/core/src/runtime/positionEdits.ts
index 8b9662f204..1e08b43def 100644
--- a/packages/core/src/runtime/positionEdits.ts
+++ b/packages/core/src/runtime/positionEdits.ts
@@ -30,6 +30,14 @@ export const EDIT_BASE_X_ATTR = "data-hf-edit-base-x";
 export const EDIT_BASE_Y_ATTR = "data-hf-edit-base-y";
 export const EDIT_ORIGINAL_TRANSLATE_ATTR = "data-hf-edit-original-translate";
 
+/**
+ * Elements a position edit can apply to: HTML elements AND SVG graphics (authored `<text>` labels,
+ * shapes, groups). Both expose `.style` and honor the CSS `translate` longhand in modern Chrome, so
+ * the same delta→translate compose logic works for either. (SVG was previously excluded by an
+ * `instanceof HTMLElement`-only guard, which silently dropped every move on an SVG element.)
+ */
+type StylableElement = HTMLElement | SVGElement;
+
 const num = (value: string | null): number => {
   const n = parseFloat(value ?? "");
   return Number.isFinite(n) ? n : 0;
@@ -80,7 +88,7 @@ export const composeTranslate = (original: string, x: string, y: string): string
  * reuse it and never read the translate again. gsap.getProperty parses
  * without mutating the element. Best-effort — absent or failing GSAP is fine.
  */
-const primeGsapTransformCache = (el: HTMLElement): void => {
+const primeGsapTransformCache = (el: StylableElement): void => {
   try {
     const view = el.ownerDocument.defaultView as
       | (Window & { gsap?: { getProperty?: (t: Element, p: string) => unknown } })
@@ -92,7 +100,7 @@ const primeGsapTransformCache = (el: HTMLElement): void => {
 };
 
 /** The element's effective translate: inline if set, computed otherwise ("" = none). */
-export const readCurrentTranslate = (el: HTMLElement): string => {
+export const readCurrentTranslate = (el: StylableElement): string => {
   const inline = el.style.getPropertyValue("translate").trim();
   if (inline) return inline === "none" ? "" : inline;
   try {
@@ -112,7 +120,7 @@ export const readCurrentTranslate = (el: HTMLElement): string => {
  * it then would DOUBLE the offset on every axis the tween doesn't animate, so
  * the non-forced path skips instead (degrading to the documented fold-loss).
  */
-const lastAppliedTranslate = new WeakMap<HTMLElement, string>();
+const lastAppliedTranslate = new WeakMap<StylableElement, string>();
 
 /**
  * Apply one element's position edit. Idempotent — the pre-edit translate is
@@ -124,7 +132,7 @@ const lastAppliedTranslate = new WeakMap<HTMLElement, string>();
  * externally — used by editor commits, where the current inline translate is
  * the draft-composed one and must be overwritten.
  */
-export function applyPositionEditToElement(el: HTMLElement, opts?: { force?: boolean }): void {
+export function applyPositionEditToElement(el: StylableElement, opts?: { force?: boolean }): void {
   const previous = lastAppliedTranslate.get(el);
   if (
     !opts?.force &&
@@ -175,9 +183,15 @@ export function applyPositionEdits(doc: Document, opts?: { force?: boolean }): n
   // cross-realm. Use the document's own realm's constructor; duck-type on
   // `.style` when defaultView is unavailable (a detached/synthetic document).
   const RealmHTMLElement = doc.defaultView?.HTMLElement;
-  const isStylable = (el: Element): el is HTMLElement =>
-    RealmHTMLElement
-      ? el instanceof RealmHTMLElement
+  const RealmSVGElement = doc.defaultView?.SVGElement;
+  // Stylable = HTML OR SVG element (SVG `<text>`/shapes are positioned via the same CSS `translate`
+  // longhand). The old HTML-only check silently dropped every SVG move. Cross-realm safe (uses the
+  // document's own realm constructors — see the note above); duck-type on `.style` when defaultView
+  // is unavailable.
+  const isStylable = (el: Element): el is StylableElement =>
+    RealmHTMLElement || RealmSVGElement
+      ? (RealmHTMLElement !== undefined && el instanceof RealmHTMLElement) ||
+        (RealmSVGElement !== undefined && el instanceof RealmSVGElement)
       : typeof (el as HTMLElement).style?.setProperty === "function";
 
   const orphaned = doc.querySelectorAll(

From 465c9e764138b94faa48badbee468eb42bd1a39d Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Tue, 21 Jul 2026 19:49:39 -0400
Subject: [PATCH 009/125] fix(producer): preserve runtime audio variables in
 distributed plans (#2725)

* fix(producer): preserve runtime audio variables in distributed plans

* fix(producer): prefer runtime duration for volume sampling
---
 .../src/services/distributed/plan.test.ts     | 19 +++++++++++++++++++
 .../producer/src/services/distributed/plan.ts |  1 +
 .../src/services/distributed/shared.ts        |  3 +++
 .../src/services/htmlCompiler.test.ts         |  4 ++--
 .../producer/src/services/htmlCompiler.ts     |  8 ++++----
 .../src/services/render/shared.test.ts        | 17 +++++++++++++++++
 .../producer/src/services/render/shared.ts    | 13 +++++++++++++
 .../services/render/stages/probeStage.test.ts |  2 ++
 .../src/services/render/stages/probeStage.ts  |  9 +++++----
 9 files changed, 66 insertions(+), 10 deletions(-)
 create mode 100644 packages/producer/src/services/render/shared.test.ts

diff --git a/packages/producer/src/services/distributed/plan.test.ts b/packages/producer/src/services/distributed/plan.test.ts
index cf71521289..d005e23e04 100644
--- a/packages/producer/src/services/distributed/plan.test.ts
+++ b/packages/producer/src/services/distributed/plan.test.ts
@@ -81,6 +81,25 @@ describe("distributed warning policy", () => {
   });
 });
 
+describe("distributed synthetic render job", () => {
+  it("threads render variables into the plan browser probe job", () => {
+    const variables = {
+      voiceoverSrc: "assets/voiceover.wav",
+      narrationDurationSeconds: 56.738,
+    };
+    const job = buildSyntheticRenderJob({
+      fps: { num: 30, den: 1 },
+      format: "mp4",
+      quality: "high",
+      hdrMode: "force-sdr",
+      entryFile: "index.html",
+      variables,
+    });
+
+    expect(job.config.variables).toEqual(variables);
+  });
+});
+
 describe("resolveChunkPlan", () => {
   it("returns 1 chunk when totalFrames fits in configChunkSize", () => {
     const result = resolveChunkPlan(60, 240, 16);
diff --git a/packages/producer/src/services/distributed/plan.ts b/packages/producer/src/services/distributed/plan.ts
index c84966c038..084cc44fed 100644
--- a/packages/producer/src/services/distributed/plan.ts
+++ b/packages/producer/src/services/distributed/plan.ts
@@ -782,6 +782,7 @@ export async function plan(
     entryFile: config.entryFile ?? "index.html",
     logger: config.logger,
     producerConfig: cfg,
+    variables: config.variables,
   });
   const entryFile = config.entryFile ?? "index.html";
   const htmlPath = join(projectDir, entryFile);
diff --git a/packages/producer/src/services/distributed/shared.ts b/packages/producer/src/services/distributed/shared.ts
index cbd84dd77a..4137a3f880 100644
--- a/packages/producer/src/services/distributed/shared.ts
+++ b/packages/producer/src/services/distributed/shared.ts
@@ -106,6 +106,8 @@ export interface SyntheticRenderJobInput {
   entryFile: string;
   logger?: ProducerLogger;
   producerConfig?: RenderConfig["producerConfig"];
+  /** Render-time overrides consumed by the plan browser probe. */
+  variables?: RenderConfig["variables"];
 }
 
 /**
@@ -133,6 +135,7 @@ export function buildSyntheticRenderJob(input: SyntheticRenderJobInput): RenderJ
     hdrMode: input.hdrMode,
     strictness: input.strictness,
     producerConfig: input.producerConfig,
+    variables: input.variables,
   };
   return createRenderJob(renderConfig);
 }
diff --git a/packages/producer/src/services/htmlCompiler.test.ts b/packages/producer/src/services/htmlCompiler.test.ts
index fef35fc867..a4d0a84272 100644
--- a/packages/producer/src/services/htmlCompiler.test.ts
+++ b/packages/producer/src/services/htmlCompiler.test.ts
@@ -1763,11 +1763,11 @@ h1 { font-size: 2rem; }`;
 });
 
 describe("discoverAudioVolumeAutomationFromTimeline", () => {
-  it("samples video-derived audio volume without firing GSAP callbacks", async () => {
+  it("prefers runtime duration over stale data-end while sampling video-derived audio", async () => {
     class TestAudioElement {}
     class TestVideoElement {
       id = "bg-video";
-      dataset = { start: "0", duration: "1", volume: "0" };
+      dataset = { start: "0", end: "0.25", duration: "1", volume: "0" };
       volume = 0;
     }
 
diff --git a/packages/producer/src/services/htmlCompiler.ts b/packages/producer/src/services/htmlCompiler.ts
index 4c1ea6e733..436f1ab8e8 100644
--- a/packages/producer/src/services/htmlCompiler.ts
+++ b/packages/producer/src/services/htmlCompiler.ts
@@ -2134,10 +2134,10 @@ export async function discoverAudioVolumeAutomationFromTimeline(
         const endAttr = Number.parseFloat(el.dataset.end ?? "");
         const durationAttr = Number.parseFloat(el.dataset.duration ?? "");
         const end =
-          Number.isFinite(endAttr) && endAttr > start
-            ? endAttr
-            : Number.isFinite(durationAttr) && durationAttr > 0
-              ? start + durationAttr
+          Number.isFinite(durationAttr) && durationAttr > 0
+            ? start + durationAttr
+            : Number.isFinite(endAttr) && endAttr > start
+              ? endAttr
               : duration;
         const sampleStart = Math.max(0, start);
         const sampleEnd = Math.min(duration, end);
diff --git a/packages/producer/src/services/render/shared.test.ts b/packages/producer/src/services/render/shared.test.ts
new file mode 100644
index 0000000000..04e47bc90d
--- /dev/null
+++ b/packages/producer/src/services/render/shared.test.ts
@@ -0,0 +1,17 @@
+import { describe, expect, it } from "bun:test";
+import { resolveBrowserMediaEnd } from "./shared.js";
+
+describe("resolveBrowserMediaEnd", () => {
+  it("prefers a runtime duration over a stale compiler-clamped end", () => {
+    expect(resolveBrowserMediaEnd(0, 5.04, 56.738)).toBe(56.738);
+  });
+
+  it("projects a runtime duration from the browser-local start", () => {
+    expect(resolveBrowserMediaEnd(2, 7.04, 56.738)).toBe(58.738);
+  });
+
+  it("falls back to data-end when runtime duration is unavailable", () => {
+    expect(resolveBrowserMediaEnd(0, 5.04, Number.NaN)).toBe(5.04);
+    expect(resolveBrowserMediaEnd(0, 5.04, 0)).toBe(5.04);
+  });
+});
diff --git a/packages/producer/src/services/render/shared.ts b/packages/producer/src/services/render/shared.ts
index 8c26224d17..e48f3f5180 100644
--- a/packages/producer/src/services/render/shared.ts
+++ b/packages/producer/src/services/render/shared.ts
@@ -53,6 +53,19 @@ export interface CompositionMetadata {
  */
 export const BROWSER_MEDIA_EPSILON = 0.0001;
 
+/**
+ * Resolve the browser/runtime end for a media element.
+ *
+ * `data-end` is compiler-generated metadata, while `data-duration` is the
+ * authored/runtime value. A render variable can replace a placeholder source
+ * and update `data-duration` after compilation, leaving the compiler-clamped
+ * `data-end` stale. Prefer the live duration when present so the audio/video
+ * extraction window follows the runtime media slot.
+ */
+export function resolveBrowserMediaEnd(start: number, end: number, duration: number): number {
+  return Number.isFinite(duration) && duration > 0 ? start + duration : end;
+}
+
 export function writeFileExclusiveSync(path: string, data: NodeJS.ArrayBufferView | string): void {
   try {
     writeFileSync(path, data, { flag: "wx", mode: 0o600 });
diff --git a/packages/producer/src/services/render/stages/probeStage.test.ts b/packages/producer/src/services/render/stages/probeStage.test.ts
index 4c3726a89c..a1b78c1905 100644
--- a/packages/producer/src/services/render/stages/probeStage.test.ts
+++ b/packages/producer/src/services/render/stages/probeStage.test.ts
@@ -103,6 +103,8 @@ mock.module("../../htmlCompiler.js", () => ({
 mock.module("../shared.js", () => ({
   BROWSER_MEDIA_EPSILON: 0.0001,
   projectBrowserEndToCompositionTimeline: () => 0,
+  resolveBrowserMediaEnd: (_start: number, end: number, duration: number) =>
+    Number.isFinite(duration) && duration > 0 ? _start + duration : end,
   writeCompiledArtifacts: () => {},
 }));
 
diff --git a/packages/producer/src/services/render/stages/probeStage.ts b/packages/producer/src/services/render/stages/probeStage.ts
index 8e155f152f..011ccd308e 100644
--- a/packages/producer/src/services/render/stages/probeStage.ts
+++ b/packages/producer/src/services/render/stages/probeStage.ts
@@ -55,6 +55,7 @@ import type { ProducerLogger } from "../../../logger.js";
 import {
   BROWSER_MEDIA_EPSILON,
   projectBrowserEndToCompositionTimeline,
+  resolveBrowserMediaEnd,
   writeCompiledArtifacts,
   type CompositionMetadata,
 } from "../shared.js";
@@ -454,7 +455,7 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
               const projectedEnd = projectBrowserEndToCompositionTimeline(
                 existing.start,
                 el.start,
-                el.end,
+                resolveBrowserMediaEnd(el.start, el.end, el.duration),
               );
               if (
                 projectedEnd > 0 &&
@@ -482,7 +483,7 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
               id: el.id,
               src,
               start: el.start,
-              end: el.end,
+              end: resolveBrowserMediaEnd(el.start, el.end, el.duration),
               mediaStart: el.mediaStart,
               loop: el.loop,
               hasAudio: el.hasAudio && !el.muted,
@@ -500,7 +501,7 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
               const projectedEnd = projectBrowserEndToCompositionTimeline(
                 existing.start,
                 el.start,
-                el.end,
+                resolveBrowserMediaEnd(el.start, el.end, el.duration),
               );
               if (
                 projectedEnd > 0 &&
@@ -527,7 +528,7 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
               id: el.id,
               src,
               start: el.start,
-              end: el.end,
+              end: resolveBrowserMediaEnd(el.start, el.end, el.duration),
               mediaStart: el.mediaStart,
               layer: 0,
               volume: el.volume,

From 4b6bb8ffa9bbf6f433ea8d1d8c892363e67e825f Mon Sep 17 00:00:00 2001
From: James <james.russo@heygen.com>
Date: Tue, 21 Jul 2026 23:51:05 +0000
Subject: [PATCH 010/125] chore: release v0.7.67

---
 .claude-plugin/plugin.json               |  2 +-
 .codex-plugin/plugin.json                |  2 +-
 .cursor-plugin/plugin.json               |  2 +-
 docs/changelog.mdx                       | 25 ++++++++++++++++++++++++
 packages/aws-lambda/package.json         |  2 +-
 packages/cli/package.json                |  2 +-
 packages/core/package.json               |  2 +-
 packages/engine/package.json             |  2 +-
 packages/gcp-cloud-run/package.json      |  2 +-
 packages/lint/package.json               |  2 +-
 packages/parsers/package.json            |  2 +-
 packages/player/package.json             |  2 +-
 packages/producer/package.json           |  2 +-
 packages/sdk/package.json                |  2 +-
 packages/shader-transitions/package.json |  2 +-
 packages/studio-server/package.json      |  2 +-
 packages/studio/package.json             |  2 +-
 releases/v0.7.67.md                      | 24 +++++++++++++++++++++++
 18 files changed, 65 insertions(+), 16 deletions(-)
 create mode 100644 releases/v0.7.67.md

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 156b912360..181fa02fc7 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 1bc42ab779..59bbe96081 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index 0ddefc96c1..1e3010d10c 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -3,7 +3,7 @@
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com"
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index d701c13821..ae91952403 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -8,6 +8,31 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
 
 {/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
 
+<Update
+  label="HyperFrames v0.7.67"
+  description="Released - 2026-07-21"
+  tags={["Release", "Producer", "Core", "Skills"]}
+>
+Distributed renders now carry runtime media variables through planning and honor runtime durations during extraction and volume automation, preventing placeholder metadata from clipping full-length audio. This release also adds RenderStretch for longer scenes, applies position edits to SVG elements, and warns when live map viewports are captured.
+
+## Features
+
+- **Producer:** RenderStretch to re-time short compositions across longer scenes ([e786b78b3](https://github.com/heygen-com/hyperframes/commit/e786b78b3311d697e95269ec8fc21a4159af909d), [#2676](https://github.com/heygen-com/hyperframes/pull/2676))
+- **Engine:** Warn when a live map viewport is detected at capture init ([30ca51c61](https://github.com/heygen-com/hyperframes/commit/30ca51c615fce20f5266278cdf5f4c97fd691c88))
+
+## Fixes
+
+- **Producer:** Preserve runtime audio variables in distributed plans ([465c9e764](https://github.com/heygen-com/hyperframes/commit/465c9e764138b94faa48badbee468eb42bd1a39d), [#2725](https://github.com/heygen-com/hyperframes/pull/2725))
+- **Core:** Apply position edits to SVG elements, not just HTML ([63539a0cd](https://github.com/heygen-com/hyperframes/commit/63539a0cdef75597d2e301736740cf3bdd905596), [#2724](https://github.com/heygen-com/hyperframes/pull/2724))
+- **Skills:** Anonymize CLI feedback repro guidance ([78ab9bc88](https://github.com/heygen-com/hyperframes/commit/78ab9bc889908e412e806d80f4ffbd938efc7a78))
+
+## Internal
+
+- **Skills:** Package Codex plugin upload ([696cbdbbd](https://github.com/heygen-com/hyperframes/commit/696cbdbbd0e5c83faf72c767126d4a153110f130), [#2668](https://github.com/heygen-com/hyperframes/pull/2668))
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.7.66...v0.7.67).
+</Update>
+
 <Update
   label="HyperFrames v0.7.66"
   description="Released - 2026-07-21"
diff --git a/packages/aws-lambda/package.json b/packages/aws-lambda/package.json
index 9cd0f061c8..b78981ea96 100644
--- a/packages/aws-lambda/package.json
+++ b/packages/aws-lambda/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 71984e0858..7482b92d0e 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "license": "Apache-2.0",
   "repository": {
diff --git a/packages/core/package.json b/packages/core/package.json
index 2a6934b230..ff8c78e73c 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/packages/engine/package.json b/packages/engine/package.json
index 4903834b28..cbf79410ca 100644
--- a/packages/engine/package.json
+++ b/packages/engine/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
diff --git a/packages/gcp-cloud-run/package.json b/packages/gcp-cloud-run/package.json
index 541f1372ce..c90c9fd2ac 100644
--- a/packages/gcp-cloud-run/package.json
+++ b/packages/gcp-cloud-run/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/gcp-cloud-run",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index 99b97c14ae..0c0340cc02 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index b4cc185682..03792e30de 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/player/package.json b/packages/player/package.json
index 5c04837768..bbb7c85165 100644
--- a/packages/player/package.json
+++ b/packages/player/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/player",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "Embeddable web component for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/producer/package.json b/packages/producer/package.json
index fae9241cd2..21c04f9027 100644
--- a/packages/producer/package.json
+++ b/packages/producer/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 14874c990e..9b589453ef 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
diff --git a/packages/shader-transitions/package.json b/packages/shader-transitions/package.json
index 78d7b348f9..b6321fd0db 100644
--- a/packages/shader-transitions/package.json
+++ b/packages/shader-transitions/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/shader-transitions",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "WebGL shader transitions for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/studio-server/package.json b/packages/studio-server/package.json
index dd2323b024..b1c7c87339 100644
--- a/packages/studio-server/package.json
+++ b/packages/studio-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/studio/package.json b/packages/studio/package.json
index d9e38c5ff6..0ae1090f19 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/releases/v0.7.67.md b/releases/v0.7.67.md
new file mode 100644
index 0000000000..f41bd66ad5
--- /dev/null
+++ b/releases/v0.7.67.md
@@ -0,0 +1,24 @@
+# HyperFrames v0.7.67
+
+Released on 2026-07-21.
+
+Distributed renders now carry runtime media variables through planning and honor runtime durations during extraction and volume automation, preventing placeholder metadata from clipping full-length audio. This release also adds RenderStretch for longer scenes, applies position edits to SVG elements, and warns when live map viewports are captured.
+
+## Features
+
+- **Producer:** RenderStretch to re-time short compositions across longer scenes ([e786b78b3](https://github.com/heygen-com/hyperframes/commit/e786b78b3311d697e95269ec8fc21a4159af909d), [#2676](https://github.com/heygen-com/hyperframes/pull/2676))
+- **Engine:** Warn when a live map viewport is detected at capture init ([30ca51c61](https://github.com/heygen-com/hyperframes/commit/30ca51c615fce20f5266278cdf5f4c97fd691c88))
+
+## Fixes
+
+- **Producer:** Preserve runtime audio variables in distributed plans ([465c9e764](https://github.com/heygen-com/hyperframes/commit/465c9e764138b94faa48badbee468eb42bd1a39d), [#2725](https://github.com/heygen-com/hyperframes/pull/2725))
+- **Core:** Apply position edits to SVG elements, not just HTML ([63539a0cd](https://github.com/heygen-com/hyperframes/commit/63539a0cdef75597d2e301736740cf3bdd905596), [#2724](https://github.com/heygen-com/hyperframes/pull/2724))
+- **Skills:** Anonymize CLI feedback repro guidance ([78ab9bc88](https://github.com/heygen-com/hyperframes/commit/78ab9bc889908e412e806d80f4ffbd938efc7a78))
+
+## Internal
+
+- **Skills:** Package Codex plugin upload ([696cbdbbd](https://github.com/heygen-com/hyperframes/commit/696cbdbbd0e5c83faf72c767126d4a153110f130), [#2668](https://github.com/heygen-com/hyperframes/pull/2668))
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.7.66...v0.7.67

From 2e97e5b1ef78c18c31b042b082bb7cc7cc44ac1c Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Tue, 21 Jul 2026 20:36:27 -0400
Subject: [PATCH 011/125] =?UTF-8?q?docs(changelog):=20weekly=20digest=2020?=
 =?UTF-8?q?26-07-13=E2=80=932026-07-20=20(#2664)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs(changelog): weekly digest 2026-07-13–2026-07-20

* docs(changelog): embed the weekly video in the Jul 13-20 digest

Adds the Jul 13-20 changelog video (produced via the changelog-video
skill, hosted at static.heygen.ai) at the top of the Update block using
Mintlify's <Frame> component with a native <video controls>.

Video URL: https://static.heygen.ai/hyperframes/changelog-videos/weekly-changelog-jul13-20.mp4
Slack thread: C0ACCNHLG3U · 1784565857.520599
---
 docs/weekly-updates.mdx | 45 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/docs/weekly-updates.mdx b/docs/weekly-updates.mdx
index 9bc61580b8..56528e08fa 100644
--- a/docs/weekly-updates.mdx
+++ b/docs/weekly-updates.mdx
@@ -9,3 +9,48 @@ Weekly HyperFrames highlights across releases, examples, docs, and community upd
 For exact versioned release notes, see the [Changelog](/changelog).
 
 {/* New weekly digest entries are prepended by `bun run changelog:weekly --from YYYY-MM-DD --to YYYY-MM-DD --write`. */}
+
+<Update
+  label="Week of July 13, 2026"
+  description="Weekly digest - July 13, 2026 - July 20, 2026"
+  tags={["Weekly update", "Highlights"]}
+>
+<Frame>
+  <video controls muted playsinline src="https://static.heygen.ai/hyperframes/changelog-videos/weekly-changelog-jul13-20.mp4"></video>
+</Frame>
+
+Automatic media proxying is the headline. Any video codec your FFmpeg can decode now plays on every live surface, from preview and Studio to play and published pages, while render keeps using the originals. Media Use gains a video generator, Studio's flat inspector ships on by default, and the engine's timeout errors now name the fix. A large batch of render, lint, and CLI reliability fixes lands alongside.
+
+## Features
+
+- **Automatic media proxying.** Studio-server probes each source's codec facts, transcodes a bounded H.264 proxy on demand, and the runtime swaps an undecodable source to its proxy so browser-hostile footage plays instead of showing a black frame. Render always uses the originals ([9ca1e1710](https://github.com/heygen-com/hyperframes/commit/9ca1e171013c0d74a868f5eda3ebdf93c9566632), [#2587](https://github.com/heygen-com/hyperframes/pull/2587), [9d148d288](https://github.com/heygen-com/hyperframes/commit/9d148d288aa1ea1ad4ea687fc21d92f8b5008286), [#2589](https://github.com/heygen-com/hyperframes/pull/2589), [39b588cbd](https://github.com/heygen-com/hyperframes/commit/39b588cbd0e196d1d1db14e959f837dc90cf7788), [#2592](https://github.com/heygen-com/hyperframes/pull/2592)).
+- **Proxies across the authoring surfaces.** Proxies serve from the preview route, play, and the static project server, and bake into published archives. Projects can opt out with `media.autoProxy` or `--no-proxy` ([67eab59f4](https://github.com/heygen-com/hyperframes/commit/67eab59f44c0609c7299dc7127d864b37d2d1715), [#2590](https://github.com/heygen-com/hyperframes/pull/2590), [74b4f1e8c](https://github.com/heygen-com/hyperframes/commit/74b4f1e8c3cb0058583c6d9048708519a6d94417), [#2593](https://github.com/heygen-com/hyperframes/pull/2593), [35eff5038](https://github.com/heygen-com/hyperframes/commit/35eff5038b5f8e825b416b05bd7ea5baa38684a0), [#2595](https://github.com/heygen-com/hyperframes/pull/2595), [645880706](https://github.com/heygen-com/hyperframes/commit/6458807066bd4e0c1a6f573423879e97b91ad1c3), [#2591](https://github.com/heygen-com/hyperframes/pull/2591)).
+- **Alpha-capable proxies.** Alpha sources get a VP9 and yuva420p WebM proxy instead of a refusal, so a ProRes 4444 file previews rather than going black ([e8371a7ac](https://github.com/heygen-com/hyperframes/commit/e8371a7accfb1ccd88c792898b65910aec60b0bd), [#2598](https://github.com/heygen-com/hyperframes/pull/2598)).
+- **Media Use video generation.** `resolve --type video` generates a HeyGen avatar video, free for new API users, and falls back to local LTX-2 when HeyGen is unavailable or you pass `--local-only` ([0a66671fc](https://github.com/heygen-com/hyperframes/commit/0a66671fc576b6b7d4a1b433ff97467dcba20b17), [#2614](https://github.com/heygen-com/hyperframes/pull/2614)).
+- **Flat inspector on by default.** Studio's flat inspector is now the default panel after this cycle's fixes. Set `VITE_STUDIO_FLAT_INSPECTOR_ENABLED=false` to return to the legacy panel ([a4167ede0](https://github.com/heygen-com/hyperframes/commit/a4167ede074cc4a3e86bc14571ff6a406d664271)).
+- **Size-aware cloud archives.** Cloud render and publish honor `.hyperframesignore`, drop root render and snapshot output by default, and add `cloud render --dry-run` diagnostics so projects stay under the 200MB upload limit ([e73304fb0](https://github.com/heygen-com/hyperframes/commit/e73304fb0e94d2272839e55a0bcc4dd00210db34)).
+- **Clearer engine timeout errors.** Puppeteer and page-navigation timeouts now name the env vars and escape hatches that fix them, and streaming-encode auto-disables on Windows software-GPU setups ([6944a1c2d](https://github.com/heygen-com/hyperframes/commit/6944a1c2d0430c8d42c6c5e1408d640b9674a2c8), [58cff5f6d](https://github.com/heygen-com/hyperframes/commit/58cff5f6d5dc8a136617df1a1b1712b142ec0986), [cbf2a2ec6](https://github.com/heygen-com/hyperframes/commit/cbf2a2ec69f12f4b5aad384d538d354321ce64cf)).
+- **New GSAP lint rules.** Lint flags seek-order and SVG draw-on hazards, relative-value second writers, `tl.set` initial hides, and cold-seek opacity reveals that break at render time ([f3d210066](https://github.com/heygen-com/hyperframes/commit/f3d21006633014fcb29b7a51571cd50ce832fed3), [#2611](https://github.com/heygen-com/hyperframes/pull/2611), [4ad582606](https://github.com/heygen-com/hyperframes/commit/4ad582606bd2c0da9e20c83faa1acb3b79fe6e47), [#2612](https://github.com/heygen-com/hyperframes/pull/2612), [55ee559e4](https://github.com/heygen-com/hyperframes/commit/55ee559e40e2e84e11fe5e09e8bf57b755ea03cb), [#2503](https://github.com/heygen-com/hyperframes/pull/2503)).
+- **CLI quality-of-life.** The transcribe timeout is configurable with a duration-scaled default, `--resolution` accepts portrait aspects, and `doctor` surfaces the extract-cache directory alongside a new `--frames-cache-dir` flag ([f8210d96d](https://github.com/heygen-com/hyperframes/commit/f8210d96daf7fd081e9304f26a288a0a1420db66), [46e9ecf3f](https://github.com/heygen-com/hyperframes/commit/46e9ecf3f2f66f7a8b145fc87a36184541b3ad13), [ca3522750](https://github.com/heygen-com/hyperframes/commit/ca352275062574b8b96aaef2ac06f8bae0a1ccc1)).
+- **SDK base variable reads.** `getVariableValue({ base: true })` reads the declared default before overrides, and `attachSync` re-syncs the override snapshot on iframe load ([db5e06221](https://github.com/heygen-com/hyperframes/commit/db5e062211fbad324b67bcc672d4e92cc4e2d351), [#2499](https://github.com/heygen-com/hyperframes/pull/2499), [4682da14f](https://github.com/heygen-com/hyperframes/commit/4682da14f19061aeac25b723e1cbb6a98f5d86ad)).
+
+## Fixes
+
+- **Deep sub-composition nesting.** Recursive sub-composition inlining now handles depth-3 and deeper nesting ([d21883fe0](https://github.com/heygen-com/hyperframes/commit/d21883fe05a5819e910d4747683dc008a0ab5147), [#2660](https://github.com/heygen-com/hyperframes/pull/2660)).
+- **Final frame holds.** Video holds its final frame through the rest of the composition instead of dropping to blank ([2e8f871bc](https://github.com/heygen-com/hyperframes/commit/2e8f871bc86d29ec3369f0eb11f0183b2001a07a)).
+- **No phantom capture duplicates.** Capture stops compositing phantom duplicates when captureBeyondViewport is on ([2be8a62c0](https://github.com/heygen-com/hyperframes/commit/2be8a62c0009e61aeae7f713773013afd9b6f173), [#2607](https://github.com/heygen-com/hyperframes/pull/2607)).
+- **Clean CLI output.** Diagnostics and the SystemMemory cgroup notice now go to stderr, keeping `--json` output and stdout parsers clean ([b179c9536](https://github.com/heygen-com/hyperframes/commit/b179c95362645c3ca06fa869d698429e2e3d1e61), [#2520](https://github.com/heygen-com/hyperframes/pull/2520), [d92d1d4f5](https://github.com/heygen-com/hyperframes/commit/d92d1d4f51e2737d19db8a67073da8ae04a16789), [#2522](https://github.com/heygen-com/hyperframes/pull/2522)).
+- **Studio reliability.** Composition timelines are hardened, stale failed sidecars are ignored for existing renders, and stale SwiftShader layers are prevented ([2b65b4efc](https://github.com/heygen-com/hyperframes/commit/2b65b4efcef9f69ab294aa608b54a89a600ab76f), [#2615](https://github.com/heygen-com/hyperframes/pull/2615), [2577aaffe](https://github.com/heygen-com/hyperframes/commit/2577aaffeb9703be3d9dd17c0c5fb3c45b6e32e7), [#2621](https://github.com/heygen-com/hyperframes/pull/2621), [54a3ef200](https://github.com/heygen-com/hyperframes/commit/54a3ef2000da635b93c03a41c129a78f0276bf38)).
+- **Platform fixes.** Intel macOS background removal is restored, Windows work dirs avoid the output path limit, and a dyld crash on older macOS now points at `HYPERFRAMES_BROWSER_PATH` ([04954ead8](https://github.com/heygen-com/hyperframes/commit/04954ead818d5db91efbdd7bbb2bd1e5f07a2f60), [#2480](https://github.com/heygen-com/hyperframes/pull/2480), [882c20324](https://github.com/heygen-com/hyperframes/commit/882c203241b43e6a1515c2672a4285d0d4f5425c), [#2479](https://github.com/heygen-com/hyperframes/pull/2479), [0d16f19b0](https://github.com/heygen-com/hyperframes/commit/0d16f19b07b1c7f60d54cac4f05f93ea3abacbcd)).
+- **Media Use asset cleanup.** Failed asset reservations are cleaned up instead of leaking zero-byte placeholders ([49113eb08](https://github.com/heygen-com/hyperframes/commit/49113eb08487b2c53b7404bc26c5e419244ae97f), [#2627](https://github.com/heygen-com/hyperframes/pull/2627)).
+- **Producer coverage gate.** Held video tails are credited in the coverage gate ([209784ab2](https://github.com/heygen-com/hyperframes/commit/209784ab27801b70c9d8e636e4eaf2e3dc796d2b), [#2606](https://github.com/heygen-com/hyperframes/pull/2606)).
+
+## Docs & Examples
+
+- **Automatic proxying guide.** New docs cover the proxy cache, published-proxy baking, the render-original invariant, FFmpeg requirements, and both opt-out forms ([8c1b6c515](https://github.com/heygen-com/hyperframes/commit/8c1b6c515401a03e1a8394cff60b4e7410f14f0d), [#2596](https://github.com/heygen-com/hyperframes/pull/2596)).
+- **Send-to guides consolidated.** The Send-to import guidance now lives in one guide, resolving an earlier fidelity contradiction ([8bfc67688](https://github.com/heygen-com/hyperframes/commit/8bfc676881c07c3c8ee1f0b6b247cc5f207cd3fd), [#2619](https://github.com/heygen-com/hyperframes/pull/2619), [7acabbcde](https://github.com/heygen-com/hyperframes/commit/7acabbcdeb9b55ce9f75c7d35d7f281273a99f29), [#2620](https://github.com/heygen-com/hyperframes/pull/2620)).
+- **Core skills install by default.** The core skill set now installs by default on every surface ([3bb26b0f0](https://github.com/heygen-com/hyperframes/commit/3bb26b0f08142e95126b4934511a09a1e68c143d), [#2554](https://github.com/heygen-com/hyperframes/pull/2554)).
+- **TTS docs aligned.** The skill's text-to-speech docs now match the CLI contract ([428e57191](https://github.com/heygen-com/hyperframes/commit/428e571914ee979c815097fbbd26d56757a11056), [#2483](https://github.com/heygen-com/hyperframes/pull/2483)).
+
+For exact versioned release notes, see the [Changelog](/changelog).
+</Update>

From 807078c7cde9d5c8403588722d1cd9397c513a0d Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Tue, 21 Jul 2026 20:38:46 -0400
Subject: [PATCH 012/125] docs(skills): make captions non-optional in
 changelog-video (#2729)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs(skills): make captions non-optional in changelog-video

The Jul 13-20 build shipped without captions because the pipeline had two soft
failure modes:

- Empty vo-words.json from the TTS provider was silently accepted, so
  align-captions.mjs had nothing to align. captions.json was never produced.
- Step 5 tolerated the master-skeleton's LINES array staying empty. The build
  lint-checked and validated clean, but the caption rail rendered no text.

This adds three hard gates on top of the existing scaffold:

- Step 4 adds a whisper forced-alignment fallback so a missing TTS timestamp
  payload no longer breaks the caption pipeline. Whisper only supplies timings;
  captions still use the DISPLAY layer from script-tokens.json.
- Step 5 flags an empty LINES array as a shipped bug and shows the exact
  IIFE-input shape it expects.
- Step 6 adds gate 5: sample 3-4 frames across the VO window and confirm visible
  caption text on each. If any spoken window renders no caption, the build is
  red.

Anti-patterns table gets two rows covering the empty-LINES and
missing-word-timings failure modes. .claude and .agents mirrors stay
byte-identical.

Follow-up to #2669 (pre-build gate); paired with the v5 rebuild that
retrofitted captions onto the shipped Jul 13-20 video.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* docs(skills): bump changelog caption size to 32px for phone-screen legibility

25px reads too small at 1080² when the video is viewed on a phone without
zoom. Bumped to 32px (font-size 25→32, top 1002→990, height 40→52, alpha
.92→.94) so captions carry across small-screen playback. Change is CSS-only
on the master-skeleton; existing per-scene chrome and layouts are untouched.

Retrofitted the Jul 13-20 v6 build with the same values (identical CSS
block) so the shipped video and the future default match. .claude and
.agents mirrors stay byte-identical.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* docs(skills): sync caption position refs to top: 990 across SKILL.md + build-spec

Miga caught: the master-skeleton bump to top: 990 / 32px / height: 52 was
not reflected in the SKILL.md prose or build-spec.md. All three files now
name the same values so the doc, gate, and code stay consistent. Also
clarifies build-spec.md's caption-rail line to point at SKILL.md step 5 as
the source of the LINES-populated requirement.

.claude and .agents mirrors byte-identical.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* docs(skills): sync script-voice.md caption rail to top: 990 / 32px

Third and final stale reference to top: 1002 / 25px — script-voice.md was
still stating the pre-bump values. Now matches master-skeleton.html,
build-spec.md, and SKILL.md. Also bumps the 'keep critical small text out'
guidance from ~80px to ~100px to reflect the slightly taller caption rail.

Full-directory sweep confirms zero remaining occurrences of 1002 or 25px
across .claude/ and .agents/ skill mirrors.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
---
 .agents/skills/changelog-video/SKILL.md       | 70 +++++++++++++++----
 .../examples/master-skeleton.html             |  6 +-
 .../changelog-video/references/build-spec.md  |  2 +-
 .../references/script-voice.md                |  6 +-
 .claude/skills/changelog-video/SKILL.md       | 70 +++++++++++++++----
 .../examples/master-skeleton.html             |  6 +-
 .../changelog-video/references/build-spec.md  |  2 +-
 .../references/script-voice.md                |  6 +-
 8 files changed, 128 insertions(+), 40 deletions(-)

diff --git a/.agents/skills/changelog-video/SKILL.md b/.agents/skills/changelog-video/SKILL.md
index 46e6ff2e0e..0bfd4f2913 100644
--- a/.agents/skills/changelog-video/SKILL.md
+++ b/.agents/skills/changelog-video/SKILL.md
@@ -39,7 +39,7 @@ ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
 cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
 ```
 
-Then **read `references/build-spec.md` end-to-end** (not skimmed) — it defines the brand tokens (TT Norms Pro + ABC Solar Display + TT Norms Mono, cream `#f5f6f4`, rationed green `#5ef17c`, glass cards with green-tinted borders, kicker/sec-chip pill shape, caption rail at `top: 1002`) that every scene inherits from the scaffold.
+Then **read `references/build-spec.md` end-to-end** (not skimmed) — it defines the brand tokens (TT Norms Pro + ABC Solar Display + TT Norms Mono, cream `#f5f6f4`, rationed green `#5ef17c`, glass cards with green-tinted borders, kicker/sec-chip pill shape, 32px caption rail at `top: 990`) that every scene inherits from the scaffold.
 
 Only THEN begin steps 1-6 below. Steps 1-4 (parse, route, script, VO) plan what goes into the scaffold; step 5 fills placeholders (`<RANGE>`, `<TOTAL>`, `<CUT_N>`, `<DUR_N>`, scene bodies) inside the already-copied `project/index.html` — you do NOT rewrite the scaffold's chrome, fonts, palette, or layout shell.
 
@@ -99,6 +99,26 @@ The aligner prints `MISMATCH` warnings — resolve every one before building
 is the clock**: all beat times come from `vo-words.json`; a VO regen re-opens
 every seam.
 
+**Word-timings are a hard gate.** Before moving on to step 5, verify
+`vo-words.json` is non-empty and has a `words: [...]` array with `start`/`end`
+per word. If it's empty (0 bytes) or missing the array — a known failure mode
+when the TTS provider returns audio but no timestamp payload — DO NOT proceed
+without them. Fallback: forced-align the produced audio against the display
+script using local whisper:
+
+```bash
+uvx --from openai-whisper whisper voiceover.mp3 \
+  --model base.en --language en --word_timestamps True \
+  --output_format json --output_dir .
+# then run align-captions.mjs with --words voiceover.json (same shape)
+```
+
+Whisper mishears TTS renderings ("gee-sap" → "gsap", "heyjen" → "hey Jen",
+etc.) — captions still use the DISPLAY spelling from `script-tokens.json`;
+whisper only supplies the timestamps. `align-captions.mjs` handles the join.
+This fallback is the difference between a captioned build and a silently
+uncaptioned one.
+
 ### 5 · Build
 
 Follow `references/build-spec.md` exactly: brand tokens + fonts (bundled in
@@ -107,6 +127,22 @@ chrome, caption rail, one rationed green moment per scene. Then the doctrine
 order: `ledger.json` (all ordinary seams cut-the-curve LEFT) → seam-stamp →
 internal beats on VO words → seam-gate verify.
 
+**Captions are non-optional.** The master-skeleton ships a caption-rail IIFE
+that reads a `LINES` array — leaving that array empty is a shipped bug, not a
+style choice. Populate it from `captions.json` before proceeding to step 6:
+
+```javascript
+// paste in place of "const LINES = /* … */ []" in the caption-rail IIFE:
+const LINES = /* contents of captions.json */ [
+  { id: 0, end: 2.74, w: [["This", 0.0], ["week,", 0.30], …] },
+  …
+];
+```
+
+If `align-captions.mjs` was skipped or `LINES` is `[]`, the frame check in
+step 6 will fail — do not paper over it by removing `#cap-line` from the
+scaffold.
+
 ### 6 · Gates (all green before presenting)
 
 1. `bun run --cwd packages/cli hyperframes check` (or the installed
@@ -120,6 +156,12 @@ internal beats on VO words → seam-gate verify.
 4. Do NOT render unless the user asks. After a requested render, verify
    frames from the MP4 (`ffmpeg -ss <t> … -frames:v 1`): captions present,
    background video not black, no tiny/frozen frames.
+5. **Caption presence gate — hard fail.** Sample 3-4 frames spread across
+   the VO's spoken window (e.g. `t=3`, `t=15`, `t=30`, `t=42` for a 48s VO)
+   and confirm the caption rail at `top: 990` renders visible text on each.
+   If any frame in a spoken interval is missing captions, the build ships
+   uncaptioned — treat it as a red gate and re-check step 5's `LINES`
+   population. This is exactly what went wrong on the Jul 13-20 v4 build.
 
 ## Project layout
 
@@ -136,15 +178,17 @@ projects/active/weekly-changelog-<range>/
 
 ## Anti-patterns
 
-| Don't                                                 | Instead                                                                                                                                               |
-| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Bullet-point slides for UI changes                    | Mock the surface acting out the change                                                                                                                |
-| Fake UI for un-representable items                    | Honest checklist scene                                                                                                                                |
-| Plain "JSON"/"CLI" in the TTS text                    | Lexicon spoken forms; display stays standard                                                                                                          |
-| Phonetic spellings in captions                        | Captions always render the display layer                                                                                                              |
-| Guessing an unknown term's pronunciation              | Ask, then grow the lexicon                                                                                                                            |
-| Speaking every changelog item                         | ≤3 per theme; the digest link carries the rest                                                                                                        |
-| Green accents everywhere                              | One green moment per scene (#5ef17c)                                                                                                                  |
-| Starting from a prior video's index.html              | Step 0 — copy `examples/master-skeleton.html` from this skill into `project/index.html`, always                                                       |
-| Hand-crafted `@font-face` / WebGL shader / custom BGM | Step 0 — copy this skill's `assets/` verbatim; the skill's assets ARE the brand                                                                       |
-| Delivered without CloudFront invalidation             | Run `aws cloudfront create-invalidation` on distribution `E2BSLVSZ7FG3U0` for the exact path after any S3 replace — CDN caches the old file otherwise |
+| Don't                                                 | Instead                                                                                                                                                                                          |
+| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Bullet-point slides for UI changes                    | Mock the surface acting out the change                                                                                                                                                           |
+| Fake UI for un-representable items                    | Honest checklist scene                                                                                                                                                                           |
+| Plain "JSON"/"CLI" in the TTS text                    | Lexicon spoken forms; display stays standard                                                                                                                                                     |
+| Phonetic spellings in captions                        | Captions always render the display layer                                                                                                                                                         |
+| Guessing an unknown term's pronunciation              | Ask, then grow the lexicon                                                                                                                                                                       |
+| Speaking every changelog item                         | ≤3 per theme; the digest link carries the rest                                                                                                                                                   |
+| Green accents everywhere                              | One green moment per scene (#5ef17c)                                                                                                                                                             |
+| Starting from a prior video's index.html              | Step 0 — copy `examples/master-skeleton.html` from this skill into `project/index.html`, always                                                                                                  |
+| Hand-crafted `@font-face` / WebGL shader / custom BGM | Step 0 — copy this skill's `assets/` verbatim; the skill's assets ARE the brand                                                                                                                  |
+| Delivered without CloudFront invalidation             | Run `aws cloudfront create-invalidation` on distribution `E2BSLVSZ7FG3U0` for the exact path after any S3 replace — CDN caches the old file otherwise                                            |
+| Shipping with the `LINES` array empty in the scaffold | Step 4 must produce a populated `captions.json`; step 5 must paste it into the IIFE; step 6 gate 5 must confirm captions on rendered frames. An empty `LINES` = uncaptioned ship = re-do the run |
+| No `vo-words.json` → skip captions and ship anyway    | Fall back to whisper forced alignment on the produced audio; captions are non-optional                                                                                                           |
diff --git a/.agents/skills/changelog-video/examples/master-skeleton.html b/.agents/skills/changelog-video/examples/master-skeleton.html
index dc141233e8..35a6f81c2d 100644
--- a/.agents/skills/changelog-video/examples/master-skeleton.html
+++ b/.agents/skills/changelog-video/examples/master-skeleton.html
@@ -33,9 +33,9 @@
     .glass { background: rgba(10,12,11,.78); border: 1px solid rgba(190,255,205,.32);
       border-radius: 22px; box-shadow: 0 24px 60px rgba(0,0,0,.5); }
     /* caption rail — overlay on top of the film, never a reserved band */
-    #cap-line { position: absolute; left: 0; right: 0; top: 1002px; height: 40px; text-align: center;
-      z-index: 7; font-family: 'TT Norms Pro', sans-serif; font-weight: 500; font-size: 25px;
-      letter-spacing: .01em; color: rgba(245,246,244,.92);
+    #cap-line { position: absolute; left: 0; right: 0; top: 990px; height: 52px; text-align: center;
+      z-index: 7; font-family: 'TT Norms Pro', sans-serif; font-weight: 500; font-size: 32px;
+      letter-spacing: .01em; color: rgba(245,246,244,.94);
       text-shadow: 0 2px 14px rgba(0,0,0,.85), 0 0 3px rgba(0,0,0,.6);
       white-space: nowrap; pointer-events: none; }
     .cap-phrase { position: absolute; left: 0; right: 0; }
diff --git a/.agents/skills/changelog-video/references/build-spec.md b/.agents/skills/changelog-video/references/build-spec.md
index beea843132..d376e7bbd9 100644
--- a/.agents/skills/changelog-video/references/build-spec.md
+++ b/.agents/skills/changelog-video/references/build-spec.md
@@ -76,7 +76,7 @@ otherwise) and must stay flat 2D (no 3D ancestors).
   y ∈ [288, 944].
 - Outro (≤3.5s): kicker FULL DIGEST, "See what shipped." ~96px, green rule,
   mono URL chip, tag line. Fade all + chrome ~0.5s before end.
-- Caption rail per `script-voice.md` (top: 1002).
+- Caption rail per `script-voice.md` (top: 990, font-size: 32px, height: 52). Mandatory — populate the master-skeleton's `LINES` array from `captions.json` before render; see SKILL.md step 5.
 
 ## Seams + internal life (doctrine mechanics)
 
diff --git a/.agents/skills/changelog-video/references/script-voice.md b/.agents/skills/changelog-video/references/script-voice.md
index ba2bdee1fe..b39a550f09 100644
--- a/.agents/skills/changelog-video/references/script-voice.md
+++ b/.agents/skills/changelog-video/references/script-voice.md
@@ -105,7 +105,7 @@ transcript) before the captions are trusted.
 ## Caption rail (rendering)
 
 Per `captions-overlay`: a quiet OVERLAY, never a reserved band. One line,
-bottom-center (top: 1002px on 1080-square), TT Norms Pro 500 25px,
-ink .92, soft dark text-shadow, words fading in (0.12s) on their timestamps,
-phrase swaps as sets. Keep critical small text out of the bottom ~80px
+bottom-center (top: 990px, height: 52px on 1080-square), TT Norms Pro 500 32px,
+ink .94, soft dark text-shadow, words fading in (0.12s) on their timestamps,
+phrase swaps as sets. Keep critical small text out of the bottom ~100px
 center span; everything else may run under the rail.
diff --git a/.claude/skills/changelog-video/SKILL.md b/.claude/skills/changelog-video/SKILL.md
index 46e6ff2e0e..0bfd4f2913 100644
--- a/.claude/skills/changelog-video/SKILL.md
+++ b/.claude/skills/changelog-video/SKILL.md
@@ -39,7 +39,7 @@ ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
 cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
 ```
 
-Then **read `references/build-spec.md` end-to-end** (not skimmed) — it defines the brand tokens (TT Norms Pro + ABC Solar Display + TT Norms Mono, cream `#f5f6f4`, rationed green `#5ef17c`, glass cards with green-tinted borders, kicker/sec-chip pill shape, caption rail at `top: 1002`) that every scene inherits from the scaffold.
+Then **read `references/build-spec.md` end-to-end** (not skimmed) — it defines the brand tokens (TT Norms Pro + ABC Solar Display + TT Norms Mono, cream `#f5f6f4`, rationed green `#5ef17c`, glass cards with green-tinted borders, kicker/sec-chip pill shape, 32px caption rail at `top: 990`) that every scene inherits from the scaffold.
 
 Only THEN begin steps 1-6 below. Steps 1-4 (parse, route, script, VO) plan what goes into the scaffold; step 5 fills placeholders (`<RANGE>`, `<TOTAL>`, `<CUT_N>`, `<DUR_N>`, scene bodies) inside the already-copied `project/index.html` — you do NOT rewrite the scaffold's chrome, fonts, palette, or layout shell.
 
@@ -99,6 +99,26 @@ The aligner prints `MISMATCH` warnings — resolve every one before building
 is the clock**: all beat times come from `vo-words.json`; a VO regen re-opens
 every seam.
 
+**Word-timings are a hard gate.** Before moving on to step 5, verify
+`vo-words.json` is non-empty and has a `words: [...]` array with `start`/`end`
+per word. If it's empty (0 bytes) or missing the array — a known failure mode
+when the TTS provider returns audio but no timestamp payload — DO NOT proceed
+without them. Fallback: forced-align the produced audio against the display
+script using local whisper:
+
+```bash
+uvx --from openai-whisper whisper voiceover.mp3 \
+  --model base.en --language en --word_timestamps True \
+  --output_format json --output_dir .
+# then run align-captions.mjs with --words voiceover.json (same shape)
+```
+
+Whisper mishears TTS renderings ("gee-sap" → "gsap", "heyjen" → "hey Jen",
+etc.) — captions still use the DISPLAY spelling from `script-tokens.json`;
+whisper only supplies the timestamps. `align-captions.mjs` handles the join.
+This fallback is the difference between a captioned build and a silently
+uncaptioned one.
+
 ### 5 · Build
 
 Follow `references/build-spec.md` exactly: brand tokens + fonts (bundled in
@@ -107,6 +127,22 @@ chrome, caption rail, one rationed green moment per scene. Then the doctrine
 order: `ledger.json` (all ordinary seams cut-the-curve LEFT) → seam-stamp →
 internal beats on VO words → seam-gate verify.
 
+**Captions are non-optional.** The master-skeleton ships a caption-rail IIFE
+that reads a `LINES` array — leaving that array empty is a shipped bug, not a
+style choice. Populate it from `captions.json` before proceeding to step 6:
+
+```javascript
+// paste in place of "const LINES = /* … */ []" in the caption-rail IIFE:
+const LINES = /* contents of captions.json */ [
+  { id: 0, end: 2.74, w: [["This", 0.0], ["week,", 0.30], …] },
+  …
+];
+```
+
+If `align-captions.mjs` was skipped or `LINES` is `[]`, the frame check in
+step 6 will fail — do not paper over it by removing `#cap-line` from the
+scaffold.
+
 ### 6 · Gates (all green before presenting)
 
 1. `bun run --cwd packages/cli hyperframes check` (or the installed
@@ -120,6 +156,12 @@ internal beats on VO words → seam-gate verify.
 4. Do NOT render unless the user asks. After a requested render, verify
    frames from the MP4 (`ffmpeg -ss <t> … -frames:v 1`): captions present,
    background video not black, no tiny/frozen frames.
+5. **Caption presence gate — hard fail.** Sample 3-4 frames spread across
+   the VO's spoken window (e.g. `t=3`, `t=15`, `t=30`, `t=42` for a 48s VO)
+   and confirm the caption rail at `top: 990` renders visible text on each.
+   If any frame in a spoken interval is missing captions, the build ships
+   uncaptioned — treat it as a red gate and re-check step 5's `LINES`
+   population. This is exactly what went wrong on the Jul 13-20 v4 build.
 
 ## Project layout
 
@@ -136,15 +178,17 @@ projects/active/weekly-changelog-<range>/
 
 ## Anti-patterns
 
-| Don't                                                 | Instead                                                                                                                                               |
-| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Bullet-point slides for UI changes                    | Mock the surface acting out the change                                                                                                                |
-| Fake UI for un-representable items                    | Honest checklist scene                                                                                                                                |
-| Plain "JSON"/"CLI" in the TTS text                    | Lexicon spoken forms; display stays standard                                                                                                          |
-| Phonetic spellings in captions                        | Captions always render the display layer                                                                                                              |
-| Guessing an unknown term's pronunciation              | Ask, then grow the lexicon                                                                                                                            |
-| Speaking every changelog item                         | ≤3 per theme; the digest link carries the rest                                                                                                        |
-| Green accents everywhere                              | One green moment per scene (#5ef17c)                                                                                                                  |
-| Starting from a prior video's index.html              | Step 0 — copy `examples/master-skeleton.html` from this skill into `project/index.html`, always                                                       |
-| Hand-crafted `@font-face` / WebGL shader / custom BGM | Step 0 — copy this skill's `assets/` verbatim; the skill's assets ARE the brand                                                                       |
-| Delivered without CloudFront invalidation             | Run `aws cloudfront create-invalidation` on distribution `E2BSLVSZ7FG3U0` for the exact path after any S3 replace — CDN caches the old file otherwise |
+| Don't                                                 | Instead                                                                                                                                                                                          |
+| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Bullet-point slides for UI changes                    | Mock the surface acting out the change                                                                                                                                                           |
+| Fake UI for un-representable items                    | Honest checklist scene                                                                                                                                                                           |
+| Plain "JSON"/"CLI" in the TTS text                    | Lexicon spoken forms; display stays standard                                                                                                                                                     |
+| Phonetic spellings in captions                        | Captions always render the display layer                                                                                                                                                         |
+| Guessing an unknown term's pronunciation              | Ask, then grow the lexicon                                                                                                                                                                       |
+| Speaking every changelog item                         | ≤3 per theme; the digest link carries the rest                                                                                                                                                   |
+| Green accents everywhere                              | One green moment per scene (#5ef17c)                                                                                                                                                             |
+| Starting from a prior video's index.html              | Step 0 — copy `examples/master-skeleton.html` from this skill into `project/index.html`, always                                                                                                  |
+| Hand-crafted `@font-face` / WebGL shader / custom BGM | Step 0 — copy this skill's `assets/` verbatim; the skill's assets ARE the brand                                                                                                                  |
+| Delivered without CloudFront invalidation             | Run `aws cloudfront create-invalidation` on distribution `E2BSLVSZ7FG3U0` for the exact path after any S3 replace — CDN caches the old file otherwise                                            |
+| Shipping with the `LINES` array empty in the scaffold | Step 4 must produce a populated `captions.json`; step 5 must paste it into the IIFE; step 6 gate 5 must confirm captions on rendered frames. An empty `LINES` = uncaptioned ship = re-do the run |
+| No `vo-words.json` → skip captions and ship anyway    | Fall back to whisper forced alignment on the produced audio; captions are non-optional                                                                                                           |
diff --git a/.claude/skills/changelog-video/examples/master-skeleton.html b/.claude/skills/changelog-video/examples/master-skeleton.html
index dc141233e8..35a6f81c2d 100644
--- a/.claude/skills/changelog-video/examples/master-skeleton.html
+++ b/.claude/skills/changelog-video/examples/master-skeleton.html
@@ -33,9 +33,9 @@
     .glass { background: rgba(10,12,11,.78); border: 1px solid rgba(190,255,205,.32);
       border-radius: 22px; box-shadow: 0 24px 60px rgba(0,0,0,.5); }
     /* caption rail — overlay on top of the film, never a reserved band */
-    #cap-line { position: absolute; left: 0; right: 0; top: 1002px; height: 40px; text-align: center;
-      z-index: 7; font-family: 'TT Norms Pro', sans-serif; font-weight: 500; font-size: 25px;
-      letter-spacing: .01em; color: rgba(245,246,244,.92);
+    #cap-line { position: absolute; left: 0; right: 0; top: 990px; height: 52px; text-align: center;
+      z-index: 7; font-family: 'TT Norms Pro', sans-serif; font-weight: 500; font-size: 32px;
+      letter-spacing: .01em; color: rgba(245,246,244,.94);
       text-shadow: 0 2px 14px rgba(0,0,0,.85), 0 0 3px rgba(0,0,0,.6);
       white-space: nowrap; pointer-events: none; }
     .cap-phrase { position: absolute; left: 0; right: 0; }
diff --git a/.claude/skills/changelog-video/references/build-spec.md b/.claude/skills/changelog-video/references/build-spec.md
index beea843132..d376e7bbd9 100644
--- a/.claude/skills/changelog-video/references/build-spec.md
+++ b/.claude/skills/changelog-video/references/build-spec.md
@@ -76,7 +76,7 @@ otherwise) and must stay flat 2D (no 3D ancestors).
   y ∈ [288, 944].
 - Outro (≤3.5s): kicker FULL DIGEST, "See what shipped." ~96px, green rule,
   mono URL chip, tag line. Fade all + chrome ~0.5s before end.
-- Caption rail per `script-voice.md` (top: 1002).
+- Caption rail per `script-voice.md` (top: 990, font-size: 32px, height: 52). Mandatory — populate the master-skeleton's `LINES` array from `captions.json` before render; see SKILL.md step 5.
 
 ## Seams + internal life (doctrine mechanics)
 
diff --git a/.claude/skills/changelog-video/references/script-voice.md b/.claude/skills/changelog-video/references/script-voice.md
index ba2bdee1fe..b39a550f09 100644
--- a/.claude/skills/changelog-video/references/script-voice.md
+++ b/.claude/skills/changelog-video/references/script-voice.md
@@ -105,7 +105,7 @@ transcript) before the captions are trusted.
 ## Caption rail (rendering)
 
 Per `captions-overlay`: a quiet OVERLAY, never a reserved band. One line,
-bottom-center (top: 1002px on 1080-square), TT Norms Pro 500 25px,
-ink .92, soft dark text-shadow, words fading in (0.12s) on their timestamps,
-phrase swaps as sets. Keep critical small text out of the bottom ~80px
+bottom-center (top: 990px, height: 52px on 1080-square), TT Norms Pro 500 32px,
+ink .94, soft dark text-shadow, words fading in (0.12s) on their timestamps,
+phrase swaps as sets. Keep critical small text out of the bottom ~100px
 center span; everything else may run under the rail.

From 69446e77265a420c4f24a0395682212793eb323f Mon Sep 17 00:00:00 2001
From: Xuanru Li <157947275+xuanruli@users.noreply.github.com>
Date: Tue, 21 Jul 2026 19:39:03 -0700
Subject: [PATCH 013/125] Revert "feat(producer): renderStretch to re-time
 short compositions across longer scenes (#2676)" (#2730)

This reverts commit e786b78b3311d697e95269ec8fc21a4159af909d.
---
 packages/core/src/core.types.ts               | 12 --------
 packages/core/src/index.ts                    |  1 -
 .../src/outputFrameToTimelineSeconds.test.ts  | 30 -------------------
 packages/engine/src/services/frameCapture.ts  | 11 ++-----
 .../src/services/parallelCoordinator.ts       |  9 ++----
 packages/engine/src/types.ts                  |  2 --
 packages/producer/src/renderRequest.ts        | 12 --------
 packages/producer/src/server.ts               |  7 -----
 .../producer/src/services/distributed/plan.ts |  5 ----
 .../src/services/distributed/renderChunk.ts   |  3 --
 .../distributed/renderConfigValidation.ts     | 12 --------
 .../src/services/distributed/shared.ts        |  2 --
 .../render/stages/captureHdrHybridLoop.ts     |  3 +-
 .../render/stages/captureHdrSequentialLoop.ts |  3 +-
 .../services/render/stages/captureStage.ts    | 13 ++------
 .../render/stages/captureStreamingStage.ts    | 13 ++------
 .../services/render/stages/planHash.test.ts   | 20 -------------
 .../src/services/render/stages/planHash.ts    |  7 +----
 .../src/services/render/stages/probeStage.ts  |  7 ++---
 .../src/services/renderOrchestrator.ts        |  2 --
 20 files changed, 15 insertions(+), 159 deletions(-)
 delete mode 100644 packages/core/src/outputFrameToTimelineSeconds.test.ts

diff --git a/packages/core/src/core.types.ts b/packages/core/src/core.types.ts
index 402f43170a..99d356b557 100644
--- a/packages/core/src/core.types.ts
+++ b/packages/core/src/core.types.ts
@@ -38,18 +38,6 @@ export function fpsToNumber(fps: Fps): number {
   return fps.num / fps.den;
 }
 
-/**
- * Timeline seek time for an output frame. `renderStretch` (=intrinsic/target,
- * default 1 = no-op) scales the mapping so a short comp spans a longer output.
- */
-export function outputFrameToTimelineSeconds(
-  frameIndex: number,
-  fps: Fps,
-  renderStretch = 1,
-): number {
-  return ((frameIndex * fps.den) / fps.num) * renderStretch;
-}
-
 /**
  * FFmpeg-style fps argument. Returns `"30"` for integer fps and `"30000/1001"`
  * for rationals — both forms are accepted verbatim by FFmpeg's `-r` and
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 2ce7d2587b..d99e932a7a 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -63,7 +63,6 @@ export {
   parseFpsWithDefault,
   toFps,
   fpsToNumber,
-  outputFrameToTimelineSeconds,
   fpsToFfmpegArg,
   TIMELINE_COLORS,
   DEFAULT_DURATIONS,
diff --git a/packages/core/src/outputFrameToTimelineSeconds.test.ts b/packages/core/src/outputFrameToTimelineSeconds.test.ts
deleted file mode 100644
index de18361be6..0000000000
--- a/packages/core/src/outputFrameToTimelineSeconds.test.ts
+++ /dev/null
@@ -1,30 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { outputFrameToTimelineSeconds } from "./core.types.js";
-
-describe("outputFrameToTimelineSeconds", () => {
-  const fps = { num: 30, den: 1 };
-
-  it("no-op when renderStretch is omitted (defaults to 1)", () => {
-    for (const i of [0, 1, 29, 143]) {
-      expect(outputFrameToTimelineSeconds(i, fps)).toBe((i * fps.den) / fps.num);
-    }
-  });
-
-  it("renderStretch=1 is byte-identical to the raw frame time", () => {
-    expect(outputFrameToTimelineSeconds(143, fps, 1)).toBe(143 / 30);
-  });
-
-  it("stretches a 1s comp across a 4.8s output (renderStretch = intrinsic/target)", () => {
-    const rs = 1 / 4.8;
-    expect(outputFrameToTimelineSeconds(0, fps, rs)).toBe(0);
-    // last of 144 output frames lands just under intrinsic 1.0s — never past it
-    const last = outputFrameToTimelineSeconds(143, fps, rs);
-    expect(last).toBeGreaterThan(0.98);
-    expect(last).toBeLessThan(1.0);
-  });
-
-  it("honors an exact rational fps (NTSC 30000/1001)", () => {
-    const ntsc = { num: 30000, den: 1001 };
-    expect(outputFrameToTimelineSeconds(30, ntsc, 1)).toBe((30 * 1001) / 30000);
-  });
-});
diff --git a/packages/engine/src/services/frameCapture.ts b/packages/engine/src/services/frameCapture.ts
index 576a07c995..0c7346dc7a 100644
--- a/packages/engine/src/services/frameCapture.ts
+++ b/packages/engine/src/services/frameCapture.ts
@@ -2709,9 +2709,8 @@ export async function verifyStaticFramesSafe(
     if (last && f === last.b + 1) last.b = f;
     else runs.push({ a: f, b: f });
   }
-  const renderStretch = session.options.renderStretch ?? 1;
   const seekToFrame = async (frameIdx: number): Promise<void> => {
-    const t = quantizeTimeToFrame((frameIdx / fps) * renderStretch, fps);
+    const t = quantizeTimeToFrame(frameIdx / fps, fps);
     await page.evaluate((tt: number) => {
       const hf = (
         window as unknown as {
@@ -3649,14 +3648,11 @@ async function captureDeVerificationFrames(
   // their data-duration, and infinite-repeat GSAP reports a huge sentinel —
   // and indices derived from it would never be drained, silently disarming
   // verification for exactly the comps that need it.
-  // compositionDurationSeconds is already the output (drained) duration; the raw
-  // page fallback is intrinsic — divide it by renderStretch to match (1 = no-op).
-  const renderStretch = session.options.renderStretch ?? 1;
   const duration =
     session.options.compositionDurationSeconds ??
     (await page.evaluate(
       () => (window as unknown as { __hf?: { duration?: number } }).__hf?.duration ?? 0,
-    )) / renderStretch;
+    ));
   const totalFrames = Math.floor(duration * fps);
   if (totalFrames < 10) return;
   if (duration > 3600) {
@@ -3706,8 +3702,7 @@ async function captureDeVerificationFrames(
     while (boundary.has(idx) && guard++ < 6) idx = Math.min(totalFrames - 1, idx + 2);
     if (boundary.has(idx)) continue;
     if (frames.has(idx)) continue;
-    // Seek truth with the same ×renderStretch mapping the real capture uses for output frame idx.
-    const t = quantizeTimeToFrame((idx / fps) * renderStretch, fps);
+    const t = quantizeTimeToFrame(idx / fps, fps);
     await seekTo(t);
     // Video frame injection (same hook the real capture paths run) — without
     // it, <video> elements screenshot black and every video comp would
diff --git a/packages/engine/src/services/parallelCoordinator.ts b/packages/engine/src/services/parallelCoordinator.ts
index d6c028e4a3..b52308886b 100644
--- a/packages/engine/src/services/parallelCoordinator.ts
+++ b/packages/engine/src/services/parallelCoordinator.ts
@@ -23,7 +23,6 @@ import {
   type CapturePerfSummary,
   type BeforeCaptureHook,
 } from "./frameCapture.js";
-import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import { DEFAULT_CONFIG, type EngineConfig } from "../config.js";
 import { assertSwiftShader } from "../utils/assertSwiftShader.js";
 import { readWebGlVendorInfoFromCanvas } from "../utils/readWebGlVendorInfoFromCanvas.js";
@@ -369,10 +368,6 @@ async function captureFrameRange(
   let framesCaptured = 0;
   const outputOffset = task.outputFrameOffset ?? 0;
   const stride = task.frameStride ?? 1;
-  // Per-frame seek ×renderStretch maps frames across [0, intrinsic] (1 = no-op).
-  const renderStretch = captureOptions.renderStretch ?? 1;
-  const seekTime = (i: number): number =>
-    outputFrameToTimelineSeconds(i, captureOptions.fps, renderStretch);
   // Depth-2 pipelined drawElement produce (HF_DE_PARALLEL_STREAM spike): frame
   // k's in-page worker encode overlaps frame k+stride's produce phase — the
   // same shape as the sequential worker-encode loop. Only engaged when the
@@ -392,7 +387,7 @@ async function captureFrameRange(
     let prev: { idx: number; encodeResult: Promise<Buffer> } | null = null;
     for (let i = task.startFrame; i < task.endFrame; i += stride) {
       if (signal?.aborted) throw new Error("Parallel worker cancelled");
-      const time = seekTime(i);
+      const time = (i * captureOptions.fps.den) / captureOptions.fps.num;
       if (dbg && i < task.startFrame + dbgWin) {
         console.log(`[par:w${task.workerId}] +${Date.now() - dbgT0}ms produce ${i} start`);
       }
@@ -436,7 +431,7 @@ async function captureFrameRange(
   }
   for (let i = task.startFrame; i < task.endFrame; i += stride) {
     if (signal?.aborted) throw new Error("Parallel worker cancelled");
-    const time = seekTime(i);
+    const time = (i * captureOptions.fps.den) / captureOptions.fps.num;
     const fileFrameIdx = i - outputOffset;
 
     if (onFrameBuffer) {
diff --git a/packages/engine/src/types.ts b/packages/engine/src/types.ts
index 2716ab0a43..483a7b4de0 100644
--- a/packages/engine/src/types.ts
+++ b/packages/engine/src/types.ts
@@ -115,7 +115,6 @@ export interface CaptureOptions {
    * timelines can outrun their declared duration). Consumers that derive
    * frame indices meant to be drained by the producer (drawElement
    * self-verification) MUST prefer this over `__hf.duration`.
-   * When renderStretch != 1 this is the OUTPUT (stretched) duration, not intrinsic.
    */
   compositionDurationSeconds?: number;
   /**
@@ -125,7 +124,6 @@ export interface CaptureOptions {
    * rational form verbatim — see `fpsToFfmpegArg`.
    */
   fps: Fps;
-  renderStretch?: number;
   format?: "jpeg" | "png";
   quality?: number;
   deviceScaleFactor?: number;
diff --git a/packages/producer/src/renderRequest.ts b/packages/producer/src/renderRequest.ts
index 4ea40abd82..e4e373aff9 100644
--- a/packages/producer/src/renderRequest.ts
+++ b/packages/producer/src/renderRequest.ts
@@ -49,8 +49,6 @@ export interface RenderRequestOptions {
   variables?: Record<string, unknown>;
   outputResolution?: CanvasResolution;
   outputResolutionAspectAgnostic?: boolean;
-  /** intrinsic/target timeline re-time; 1 = no-op. Audio is silence-padded to output length, not time-stretched. */
-  renderStretch?: number;
   engineConfig: EngineConfig;
   distributed?: DistributedRenderOptions;
 }
@@ -107,13 +105,6 @@ function assertOptionalInteger(options: Record<string, unknown>, field: string,
   }
 }
 
-function assertOptionalPositiveNumber(options: Record<string, unknown>, field: string): void {
-  const value = options[field];
-  if (value !== undefined && (typeof value !== "number" || !Number.isFinite(value) || value <= 0)) {
-    throw new Error(`Render request ${field} must be a positive number`);
-  }
-}
-
 function assertOptionalString(options: Record<string, unknown>, field: string): void {
   if (options[field] !== undefined && typeof options[field] !== "string") {
     throw new Error(`Render request ${field} must be a string`);
@@ -169,7 +160,6 @@ function assertRequestOptionScalars(options: Record<string, unknown>): void {
   assertOptionalInteger(options, "gifLoop");
   assertOptionalInteger(options, "workers", 1);
   assertOptionalInteger(options, "crf");
-  assertOptionalPositiveNumber(options, "renderStretch");
   for (const field of ["useGpu", "debug", "outputResolutionAspectAgnostic"] as const) {
     assertOptionalBoolean(options, field);
   }
@@ -294,7 +284,6 @@ export function distributedConfigFromRequest(
     videoFrameFormat: options.videoFrameFormat,
     outputResolution: options.outputResolution,
     outputResolutionAspectAgnostic: options.outputResolutionAspectAgnostic,
-    renderStretch: options.renderStretch,
     chunkSize: distributed.chunkSize,
     maxParallelChunks: distributed.maxParallelChunks,
     targetChunkFrames: distributed.targetChunkFrames,
@@ -350,7 +339,6 @@ export function renderRequestFromDistributedConfig(input: {
     ...optionalProperty("videoFrameFormat", config.videoFrameFormat),
     ...optionalProperty("outputResolution", config.outputResolution),
     ...optionalProperty("outputResolutionAspectAgnostic", config.outputResolutionAspectAgnostic),
-    ...optionalProperty("renderStretch", config.renderStretch),
     ...optionalProperty("hdrMode", config.hdrMode),
     ...optionalProperty("strictness", config.strictness),
     ...optionalProperty("entryFile", config.entryFile),
diff --git a/packages/producer/src/server.ts b/packages/producer/src/server.ts
index 26d8d8a675..45af6b222f 100644
--- a/packages/producer/src/server.ts
+++ b/packages/producer/src/server.ts
@@ -110,7 +110,6 @@ interface RenderInput {
    * compositions as an aspect-ratio mismatch.
    */
   outputResolutionAspectAgnostic?: boolean;
-  renderStretch?: number;
 }
 
 interface PreparedRenderInput {
@@ -168,10 +167,6 @@ export function parseRenderOptions(body: Record<string, unknown>): Omit<RenderIn
 
   const { variables, outputResolution, outputResolutionAspectAgnostic } =
     parseRenderOverrides(body);
-  const renderStretch =
-    typeof body.renderStretch === "number" && body.renderStretch > 0
-      ? body.renderStretch
-      : undefined;
 
   return {
     outputPath,
@@ -187,7 +182,6 @@ export function parseRenderOptions(body: Record<string, unknown>): Omit<RenderIn
     outputResolution,
     outputResolutionAspectAgnostic,
     videoFrameFormat,
-    renderStretch,
   };
 }
 
@@ -245,7 +239,6 @@ function buildRenderJobConfig(input: RenderInput, outputPath: string, log: Produ
       outputResolution: input.outputResolution,
       outputResolutionAspectAgnostic: input.outputResolutionAspectAgnostic,
       videoFrameFormat: input.videoFrameFormat,
-      renderStretch: input.renderStretch,
     },
   });
   return renderConfigFromRequest(request, { logger: log });
diff --git a/packages/producer/src/services/distributed/plan.ts b/packages/producer/src/services/distributed/plan.ts
index 084cc44fed..8f11d7bd55 100644
--- a/packages/producer/src/services/distributed/plan.ts
+++ b/packages/producer/src/services/distributed/plan.ts
@@ -135,9 +135,6 @@ export interface DistributedRenderConfig {
    */
   outputResolutionAspectAgnostic?: boolean;
 
-  /** intrinsic/target timeline re-time; 1 (or omitted) = no-op. Folded into planHash. */
-  renderStretch?: number;
-
   /**
    * Frames per chunk. When explicitly set, that value is used and
    * `chunkCount = min(maxParallelChunks, ceil(totalFrames / chunkSize))`
@@ -774,7 +771,6 @@ export async function plan(
     videoFrameFormat: config.videoFrameFormat,
     outputResolution: config.outputResolution,
     outputResolutionAspectAgnostic: config.outputResolutionAspectAgnostic,
-    renderStretch: config.renderStretch,
     // HDR is banned in distributed mode. force-sdr keeps the
     // extract / encoder paths off the HDR branches entirely.
     hdrMode: config.hdrMode ?? "force-sdr",
@@ -1041,7 +1037,6 @@ export async function plan(
     width,
     height,
     format: config.format,
-    renderStretch: config.renderStretch,
   };
   // Clean up the temp work tree BEFORE freezePlan. `.plan-work/` holds
   // intermediate compileStage + audio-mix artifacts (downloaded source
diff --git a/packages/producer/src/services/distributed/renderChunk.ts b/packages/producer/src/services/distributed/renderChunk.ts
index 3f1df33437..4f5009f15b 100644
--- a/packages/producer/src/services/distributed/renderChunk.ts
+++ b/packages/producer/src/services/distributed/renderChunk.ts
@@ -239,7 +239,6 @@ interface PlanJson {
     width: number;
     height: number;
     format: DistributedFormat;
-    renderStretch?: number;
   };
   chunkCount: number;
   totalFrames: number;
@@ -516,8 +515,6 @@ export async function renderChunk(
       width: plan.dimensions.width,
       height: plan.dimensions.height,
       fps: { num: plan.dimensions.fpsNum, den: plan.dimensions.fpsDen },
-      // Per-frame seek ×renderStretch maps output frames across [0, intrinsic] (1 = no-op).
-      renderStretch: plan.dimensions.renderStretch ?? 1,
       format: plan.dimensions.format === "mp4" ? "jpeg" : "png",
       quality: plan.dimensions.format === "mp4" ? 80 : undefined,
       deviceScaleFactor: encoder.deviceScaleFactor,
diff --git a/packages/producer/src/services/distributed/renderConfigValidation.ts b/packages/producer/src/services/distributed/renderConfigValidation.ts
index a7b6297a62..261fc11d10 100644
--- a/packages/producer/src/services/distributed/renderConfigValidation.ts
+++ b/packages/producer/src/services/distributed/renderConfigValidation.ts
@@ -187,18 +187,6 @@ export function validateDistributedRenderConfig(
     }
   }
 
-  if (
-    config.renderStretch !== undefined &&
-    (typeof config.renderStretch !== "number" ||
-      !Number.isFinite(config.renderStretch) ||
-      config.renderStretch <= 0)
-  ) {
-    throw new InvalidConfigError(
-      "config.renderStretch",
-      `must be a positive number; got ${String(config.renderStretch)}`,
-    );
-  }
-
   if (config.runtimeCap !== undefined && !ALLOWED_RUNTIME_CAPS.includes(config.runtimeCap)) {
     throw new InvalidConfigError(
       "config.runtimeCap",
diff --git a/packages/producer/src/services/distributed/shared.ts b/packages/producer/src/services/distributed/shared.ts
index 4137a3f880..59932bca58 100644
--- a/packages/producer/src/services/distributed/shared.ts
+++ b/packages/producer/src/services/distributed/shared.ts
@@ -100,7 +100,6 @@ export interface SyntheticRenderJobInput {
   videoFrameFormat?: VideoFrameFormat;
   outputResolution?: RenderConfig["outputResolution"];
   outputResolutionAspectAgnostic?: RenderConfig["outputResolutionAspectAgnostic"];
-  renderStretch?: number;
   hdrMode: RenderConfig["hdrMode"];
   strictness?: RenderConfig["strictness"];
   entryFile: string;
@@ -125,7 +124,6 @@ export function buildSyntheticRenderJob(input: SyntheticRenderJobInput): RenderJ
     videoFrameFormat: input.videoFrameFormat,
     outputResolution: input.outputResolution,
     outputResolutionAspectAgnostic: input.outputResolutionAspectAgnostic,
-    renderStretch: input.renderStretch,
     // Distributed mode hard-pins to software GPU. The plan-time validator
     // refuses to fan out otherwise.
     useGpu: false,
diff --git a/packages/producer/src/services/render/stages/captureHdrHybridLoop.ts b/packages/producer/src/services/render/stages/captureHdrHybridLoop.ts
index 1e9992f6c9..0c232da66a 100644
--- a/packages/producer/src/services/render/stages/captureHdrHybridLoop.ts
+++ b/packages/producer/src/services/render/stages/captureHdrHybridLoop.ts
@@ -33,7 +33,6 @@ import {
   initTransparentBackground,
   initializeSession,
 } from "@hyperframes/engine";
-import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import type { FileServerHandle } from "../../fileServer.js";
 import type { ProducerLogger } from "../../../logger.js";
 import {
@@ -217,7 +216,7 @@ export async function runHybridLayeredFrameLoop(input: HybridLoopInput): Promise
       let nextRingIdx = 0;
       for (let i = range.start; i < range.end; i++) {
         assertNotAborted();
-        const time = outputFrameToTimelineSeconds(i, job.config.fps, job.config.renderStretch ?? 1);
+        const time = (i * job.config.fps.den) / job.config.fps.num;
         const activeTransition = transitionFramesSet.has(i)
           ? transitionRanges.find((t) => i >= t.startFrame && i <= t.endFrame)
           : undefined;
diff --git a/packages/producer/src/services/render/stages/captureHdrSequentialLoop.ts b/packages/producer/src/services/render/stages/captureHdrSequentialLoop.ts
index 96d16c4a2a..19644eb8ae 100644
--- a/packages/producer/src/services/render/stages/captureHdrSequentialLoop.ts
+++ b/packages/producer/src/services/render/stages/captureHdrSequentialLoop.ts
@@ -19,7 +19,6 @@ import {
   TRANSITIONS,
   crossfade,
 } from "@hyperframes/engine";
-import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import type { ProducerLogger } from "../../../logger.js";
 import {
   type HdrCompositeContext,
@@ -107,7 +106,7 @@ export async function runSequentialLayeredFrameLoop(input: SequentialLoopInput):
 
   for (let i = 0; i < totalFrames; i++) {
     assertNotAborted();
-    const time = outputFrameToTimelineSeconds(i, job.config.fps, job.config.renderStretch ?? 1);
+    const time = (i * job.config.fps.den) / job.config.fps.num;
     if (hdrPerf) hdrPerf.frames += 1;
 
     const stackingInfo = await seekInjectAndQueryStacking(
diff --git a/packages/producer/src/services/render/stages/captureStage.ts b/packages/producer/src/services/render/stages/captureStage.ts
index 02ca800d62..808b00bffe 100644
--- a/packages/producer/src/services/render/stages/captureStage.ts
+++ b/packages/producer/src/services/render/stages/captureStage.ts
@@ -52,7 +52,6 @@ import {
   initializeSession,
   prepareCaptureSessionForReuse,
 } from "@hyperframes/engine";
-import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import type { FileServerHandle } from "../../fileServer.js";
 import type { ProducerLogger } from "../../../logger.js";
 import {
@@ -317,11 +316,7 @@ export async function runCaptureStage(input: CaptureStageInput): Promise<Capture
         for (let i = 0; i < rangeFrames; i++) {
           assertNotAborted();
           const absoluteIdx = rangeStart + i;
-          const time = outputFrameToTimelineSeconds(
-            absoluteIdx,
-            job.config.fps,
-            job.config.renderStretch ?? 1,
-          );
+          const time = (absoluteIdx * job.config.fps.den) / job.config.fps.num;
           const { encodeResult } = await captureFrameToBufferPipelined(session, i, time);
           await drainPrev();
           prev = { fileIndex: i, encodeResult };
@@ -331,11 +326,7 @@ export async function runCaptureStage(input: CaptureStageInput): Promise<Capture
         for (let i = 0; i < rangeFrames; i++) {
           assertNotAborted();
           const absoluteIdx = rangeStart + i;
-          const time = outputFrameToTimelineSeconds(
-            absoluteIdx,
-            job.config.fps,
-            job.config.renderStretch ?? 1,
-          );
+          const time = (absoluteIdx * job.config.fps.den) / job.config.fps.num;
           await captureFrame(session, i, time);
           reportFrame(i);
         }
diff --git a/packages/producer/src/services/render/stages/captureStreamingStage.ts b/packages/producer/src/services/render/stages/captureStreamingStage.ts
index c85acbb6f6..364489fe24 100644
--- a/packages/producer/src/services/render/stages/captureStreamingStage.ts
+++ b/packages/producer/src/services/render/stages/captureStreamingStage.ts
@@ -71,7 +71,6 @@ import {
   prepareCaptureSessionForReuse,
   spawnStreamingEncoder,
 } from "@hyperframes/engine";
-import { outputFrameToTimelineSeconds } from "@hyperframes/core";
 import type { FileServerHandle } from "../../fileServer.js";
 import type { ProducerLogger } from "../../../logger.js";
 import type { ProgressCallback, RenderJob } from "../../renderOrchestrator.js";
@@ -406,8 +405,7 @@ async function runWorkerEncodePipelineLoop(
   abortSignal: AbortSignal | undefined,
 ): Promise<void> {
   let prev: { idx: number; encodeResult: Promise<Buffer> } | null = null;
-  const frameTime = (i: number) =>
-    outputFrameToTimelineSeconds(i, job.config.fps, job.config.renderStretch ?? 1);
+  const frameTime = (i: number) => (i * job.config.fps.den) / job.config.fps.num;
   const guard = createDrainFrameGuard({ log, stats, frameTime });
   const guardFrame = (idx: number, buf: Buffer): Promise<Buffer> => guard(session, idx, buf);
 
@@ -642,8 +640,7 @@ export async function runCaptureStreamingStage(
       const parallelGuard = createDrainFrameGuard({
         log,
         stats: parallelStats,
-        frameTime: (i: number) =>
-          outputFrameToTimelineSeconds(i, job.config.fps, job.config.renderStretch ?? 1),
+        frameTime: (i: number) => (i * job.config.fps.den) / job.config.fps.num,
       });
       let parallelGuardRan = false;
       // First guard/write failure aborts the reorder buffer so peer workers
@@ -838,11 +835,7 @@ export async function runCaptureStreamingStage(
           let lastProgressAt = Date.now();
           for (let i = 0; i < totalFrames; i++) {
             assertNotAborted();
-            const time = outputFrameToTimelineSeconds(
-              i,
-              job.config.fps,
-              job.config.renderStretch ?? 1,
-            );
+            const time = (i * job.config.fps.den) / job.config.fps.num;
             const { buffer } = await raceAgainstStall(
               captureFrameToBuffer(session, i, time),
               stallTimeoutMs - (Date.now() - lastProgressAt),
diff --git a/packages/producer/src/services/render/stages/planHash.test.ts b/packages/producer/src/services/render/stages/planHash.test.ts
index 8cab651648..2ecd5913f4 100644
--- a/packages/producer/src/services/render/stages/planHash.test.ts
+++ b/packages/producer/src/services/render/stages/planHash.test.ts
@@ -251,23 +251,3 @@ describe("sha256Hex", () => {
     expect(sha256Hex(s)).toBe(sha256Hex(new TextEncoder().encode(s)));
   });
 });
-
-describe("computePlanHash — renderStretch byte-identity", () => {
-  const baseDims = { fpsNum: 30, fpsDen: 1, width: 1920, height: 1080, format: "mp4" as const };
-
-  it("renderStretch=1 and undefined hash identically to a pre-renderStretch plan", () => {
-    const omitted = computePlanHash(makeInput({ dimensions: { ...baseDims } }));
-    const one = computePlanHash(makeInput({ dimensions: { ...baseDims, renderStretch: 1 } }));
-    const undef = computePlanHash(
-      makeInput({ dimensions: { ...baseDims, renderStretch: undefined } }),
-    );
-    expect(one).toBe(omitted);
-    expect(undef).toBe(omitted);
-  });
-
-  it("a stretched plan (renderStretch=2) gets a distinct hash", () => {
-    const base = computePlanHash(makeInput({ dimensions: { ...baseDims } }));
-    const stretched = computePlanHash(makeInput({ dimensions: { ...baseDims, renderStretch: 2 } }));
-    expect(stretched).not.toBe(base);
-  });
-});
diff --git a/packages/producer/src/services/render/stages/planHash.ts b/packages/producer/src/services/render/stages/planHash.ts
index 2d49e72099..127db7c244 100644
--- a/packages/producer/src/services/render/stages/planHash.ts
+++ b/packages/producer/src/services/render/stages/planHash.ts
@@ -73,8 +73,6 @@ export interface PlanDimensions {
   width: number;
   height: number;
   format: DistributedFormat;
-  /** intrinsic/target timeline re-time; 1 (or omitted) = no-op, hashed identically to today. */
-  renderStretch?: number;
 }
 
 export interface PlanHashInput {
@@ -129,10 +127,7 @@ export function computePlanHash(input: PlanHashInput): string {
   hash.update(FIELD_DELIMITER);
 
   const d = input.dimensions;
-  // Append renderStretch only when it re-times (!= 1) so unstretched plans hash identically to before.
-  const stretchSuffix =
-    d.renderStretch !== undefined && d.renderStretch !== 1 ? `x${d.renderStretch}` : "";
-  hash.update(`${d.fpsNum}/${d.fpsDen}x${d.width}x${d.height}x${d.format}${stretchSuffix}`, "utf8");
+  hash.update(`${d.fpsNum}/${d.fpsDen}x${d.width}x${d.height}x${d.format}`, "utf8");
 
   return hash.digest("hex");
 }
diff --git a/packages/producer/src/services/render/stages/probeStage.ts b/packages/producer/src/services/render/stages/probeStage.ts
index 011ccd308e..3e9f3b1589 100644
--- a/packages/producer/src/services/render/stages/probeStage.ts
+++ b/packages/producer/src/services/render/stages/probeStage.ts
@@ -592,10 +592,7 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
   const browserProbeMs = Date.now() - probeStart;
 
   const duration = composition.duration;
-  // Output length = intrinsic / renderStretch (1 = no-op); composition.duration stays intrinsic.
-  const renderStretch = job.config.renderStretch ?? 1;
-  const outputDuration = duration / renderStretch;
-  const totalFrames = durationToFrameCount(outputDuration, fpsToNumber(job.config.fps));
+  const totalFrames = durationToFrameCount(duration, fpsToNumber(job.config.fps));
 
   if (duration <= 0) {
     // Gather diagnostics to help users understand why the render would produce a black video.
@@ -664,7 +661,7 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
     fileServer,
     probeSession,
     lastBrowserConsole,
-    duration: outputDuration,
+    duration,
     totalFrames,
     browserProbeMs,
     beginFrameStalled,
diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index bcb6efcbf5..e8d37dbf96 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -364,7 +364,6 @@ export interface RenderConfig {
    * alias (`1080p-portrait`). Explicit orientation presets stay strict.
    */
   outputResolutionAspectAgnostic?: boolean;
-  renderStretch?: number;
 }
 
 export interface RenderPerfSummary {
@@ -2190,7 +2189,6 @@ async function executeRenderPipeline(input: {
       width,
       height,
       fps: job.config.fps,
-      renderStretch: job.config.renderStretch ?? 1,
       format: needsAlpha ? "png" : "jpeg",
       quality: needsAlpha ? undefined : job.config.quality === "draft" ? 80 : 95,
       variables: job.config.variables,

From c6462a0a225772c7a357afd5fe2f5c9a39bca238 Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Tue, 21 Jul 2026 20:39:06 -0700
Subject: [PATCH 014/125] fix(producer): emit heap advisory at orchestrator,
 lock message + telemetry props with tests

---
 packages/cli/src/telemetry/events.test.ts     | 53 +++++++++++++++++++
 .../src/services/parallelCoordinator.ts       |  1 +
 .../render/captureCost.heapAdvisory.test.ts   | 42 +++++++++++++++
 .../src/services/render/captureCost.ts        | 49 +++++++++++------
 .../src/services/renderOrchestrator.ts        |  8 +++
 5 files changed, 138 insertions(+), 15 deletions(-)
 create mode 100644 packages/producer/src/services/render/captureCost.heapAdvisory.test.ts

diff --git a/packages/cli/src/telemetry/events.test.ts b/packages/cli/src/telemetry/events.test.ts
index 9ee0b8c040..5dd6c6253e 100644
--- a/packages/cli/src/telemetry/events.test.ts
+++ b/packages/cli/src/telemetry/events.test.ts
@@ -186,6 +186,59 @@ describe("render telemetry events", () => {
     expect(flush).toHaveBeenCalledTimes(2);
   });
 
+  // The enforcement decision for the advisory heap budget reads these fleet
+  // props (see computeWorkerSizing) — a silent drop in the summary→event hop
+  // would invalidate that decision without anyone noticing.
+  it("carries every worker-sizing provenance prop on render_complete", () => {
+    trackRenderComplete({
+      durationMs: 1000,
+      fps: 30,
+      quality: "high",
+      docker: false,
+      gpu: false,
+      workers: 6,
+      workersBoundBy: "max_workers",
+      workersCpuBased: 16,
+      workersMemoryBased: 8,
+      workersHeapBased: 4,
+      workersFrameBased: 24,
+      workersHeapLimitMb: 4096,
+      workersExceedHeapAdvisory: true,
+    });
+
+    expect(trackEvent).toHaveBeenCalledWith(
+      "render_complete",
+      expect.objectContaining({
+        workers: 6,
+        workers_bound_by: "max_workers",
+        workers_cpu_based: 16,
+        workers_memory_based: 8,
+        workers_heap_based: 4,
+        workers_frame_based: 24,
+        workers_heap_limit_mb: 4096,
+        workers_exceed_heap_advisory: true,
+      }),
+      undefined,
+    );
+  });
+
+  it("ties feedback to its report and recent renders via feedback_id + recent_render_ids", () => {
+    trackRenderFeedback({
+      rating: 3,
+      comment: "hook scene blank",
+      feedbackId: "feedback-uuid",
+      recentRenderIds: ["render-a", "render-b"],
+    });
+
+    expect(trackEvent).toHaveBeenCalledWith(
+      "survey sent",
+      expect.objectContaining({
+        feedback_id: "feedback-uuid",
+        recent_render_ids: "render-a,render-b",
+      }),
+    );
+  });
+
   it("redacts paths and URL query strings from render error messages", () => {
     trackRenderError({
       fps: 30,
diff --git a/packages/engine/src/services/parallelCoordinator.ts b/packages/engine/src/services/parallelCoordinator.ts
index b3608349dc..113c2cf9f9 100644
--- a/packages/engine/src/services/parallelCoordinator.ts
+++ b/packages/engine/src/services/parallelCoordinator.ts
@@ -124,6 +124,7 @@ const HEAP_RESERVED_MB = 1024;
 // default heap ⇒ >~500MB/worker + base. ponytail: advisory-only until the
 // workers_heap_* telemetry added alongside this constant validates the figure
 // — enforcing a guessed budget could silently cut worker counts fleet-wide.
+// TODO(PRINFRA-341): decide enforcement after ~2 weeks of fleet soak.
 const HEAP_PER_WORKER_MB = 640;
 const MIN_WORKERS = 1;
 const MAX_WORKER_DIAGNOSTIC_LINES = 8;
diff --git a/packages/producer/src/services/render/captureCost.heapAdvisory.test.ts b/packages/producer/src/services/render/captureCost.heapAdvisory.test.ts
new file mode 100644
index 0000000000..39d2fdce1b
--- /dev/null
+++ b/packages/producer/src/services/render/captureCost.heapAdvisory.test.ts
@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import type { WorkerSizing } from "@hyperframes/engine";
+import { buildHeapAdvisoryWarning } from "./captureCost.js";
+
+function sizing(overrides: Partial<WorkerSizing>): WorkerSizing {
+  return {
+    workers: 6,
+    boundBy: "max_workers",
+    cpuBasedWorkers: 16,
+    memoryBasedWorkers: 8,
+    frameBasedWorkers: 24,
+    effectiveMaxWorkers: 6,
+    heapBasedWorkers: 4,
+    heapLimitMb: 4096,
+    totalMemoryMb: 24576,
+    cpuCount: 18,
+    captureCostMultiplier: 1,
+    exceedsHeapAdvisory: true,
+    ...overrides,
+  };
+}
+
+describe("buildHeapAdvisoryWarning", () => {
+  it("names the chosen count, heap limit, safe count, and both remediation knobs", () => {
+    const message = buildHeapAdvisoryWarning(sizing({}), undefined);
+    expect(message).toContain("6 capture workers");
+    expect(message).toContain("limit 4096MB");
+    expect(message).toContain("~4");
+    expect(message).toContain("NODE_OPTIONS=--max-old-space-size=8192");
+    expect(message).toContain("--workers 4");
+  });
+
+  it("stays silent for explicit --workers requests (operator's own call)", () => {
+    expect(buildHeapAdvisoryWarning(sizing({}), 6)).toBeUndefined();
+  });
+
+  it("stays silent when the chosen count fits the heap budget", () => {
+    expect(
+      buildHeapAdvisoryWarning(sizing({ exceedsHeapAdvisory: false }), undefined),
+    ).toBeUndefined();
+  });
+});
diff --git a/packages/producer/src/services/render/captureCost.ts b/packages/producer/src/services/render/captureCost.ts
index ccf0f5b23d..db00538d92 100644
--- a/packages/producer/src/services/render/captureCost.ts
+++ b/packages/producer/src/services/render/captureCost.ts
@@ -108,6 +108,36 @@ function combineCaptureCostEstimates(
   };
 }
 
+/**
+ * Advisory heap warning (field OOM, 0.7.66 on 24GB: auto-picked 6 workers
+ * blew Node's default ~4GB heap). Returns the warning message, or undefined
+ * when it should not fire:
+ *
+ * - Auto-sized renders only (`requestedWorkers === undefined`) — the field
+ *   failure was auto sizing, and an explicit `--workers N` is the operator's
+ *   own call.
+ * - Not enforced as a cap yet — the per-worker budget constant is derived
+ *   from one field report; the `workers_heap_*` telemetry emitted with the
+ *   sizing decides whether to enforce (see the TODO on HEAP_PER_WORKER_MB in
+ *   @hyperframes/engine's parallelCoordinator). The message gives the
+ *   operator the actionable knobs today.
+ *
+ * Pure so the message shape + firing condition are unit-testable with a
+ * synthetic `WorkerSizing` (the real one depends on the host's heap).
+ */
+export function buildHeapAdvisoryWarning(
+  sizing: WorkerSizing,
+  requestedWorkers: number | undefined,
+): string | undefined {
+  if (requestedWorkers !== undefined || !sizing.exceedsHeapAdvisory) return undefined;
+  return (
+    `[Render] ${sizing.workers} capture workers may exceed this process's V8 heap ` +
+    `(limit ${sizing.heapLimitMb}MB supports ~${sizing.heapBasedWorkers}). If the render ` +
+    `dies with "JavaScript heap out of memory", raise the heap ` +
+    `(NODE_OPTIONS=--max-old-space-size=8192) or pass --workers ${sizing.heapBasedWorkers}.`
+  );
+}
+
 export function resolveRenderWorkerCount(
   totalFrames: number,
   requestedWorkers: number | undefined,
@@ -152,24 +182,13 @@ export function resolveRenderWorkerCount(
     ...cfg,
     captureCostMultiplier: captureCost.multiplier,
   });
+  // The heap advisory is deliberately NOT logged here: this function's
+  // "no unexpected warns" unit-test contract would become dependent on the
+  // test machine's actual V8 heap limit. The orchestrator's onSizing consumer
+  // emits it via buildHeapAdvisoryWarning.
   onSizing?.(sizing);
   const workerCount = sizing.workers;
 
-  // Advisory heap check (field OOM, 0.7.66 on 24GB: auto-picked 6 workers
-  // blew Node's default ~4GB heap). Not enforced yet — the budget constant is
-  // derived from one field report; the workers_heap_* telemetry emitted with
-  // this sizing decides whether to enforce. The warning gives the operator
-  // the actionable knobs today.
-  if (sizing.exceedsHeapAdvisory) {
-    log.warn(
-      `[Render] ${workerCount} capture workers may exceed this process's V8 heap ` +
-        `(limit ${sizing.heapLimitMb}MB supports ~${sizing.heapBasedWorkers}). If the render ` +
-        `dies with "JavaScript heap out of memory", raise the heap ` +
-        `(NODE_OPTIONS=--max-old-space-size=8192) or pass --workers ${sizing.heapBasedWorkers}.`,
-      { heapLimitMb: sizing.heapLimitMb, heapBasedWorkers: sizing.heapBasedWorkers },
-    );
-  }
-
   if (requestedWorkers !== undefined || captureCost.multiplier <= 1) {
     return workerCount;
   }
diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index ad5836d76a..f0673fda9e 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -125,6 +125,7 @@ import { resolveVideoCaptureBeyondViewport } from "./render/captureBeyondViewpor
 import {
   type CaptureCalibrationSample,
   type CaptureCostEstimate,
+  buildHeapAdvisoryWarning,
   resolveRenderWorkerCount,
   runCaptureCalibration,
 } from "./render/captureCost.js";
@@ -2487,6 +2488,13 @@ async function executeRenderPipeline(input: {
       captureCalibration?.estimate,
       (sizing) => {
         workerSizing = sizing;
+        const heapAdvisory = buildHeapAdvisoryWarning(sizing, job.config.workers);
+        if (heapAdvisory) {
+          log.warn(heapAdvisory, {
+            heapLimitMb: sizing.heapLimitMb,
+            heapBasedWorkers: sizing.heapBasedWorkers,
+          });
+        }
       },
     );
     // DE priority inversion — see shouldPreferSingleWorkerDrawElement for the

From a637f394ee900c64c8f2e1ee78cf1e0ce17b8739 Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Wed, 22 Jul 2026 00:19:51 -0400
Subject: [PATCH 015/125] fix(producer): credit looping short videos in
 coverage gate (#2665) (#2732)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

#2606 taught the video-coverage gate that a non-looping short video holds
its final decoded frame across the tail, so the delivered source frames
are enough to cover the authored slot. But that fix gated the credit on
'!video.loop' — a looping short video was still measured as
unique-source-frames / slot-frames and aborted at ratio << threshold.

Reproduced on 0.7.64 with the reporter's exact composition (3s clip in a
10s slot, loop attribute): render aborts with 'captured 90 of expected
300 frames (coverage 30.0%)'. Same source without loop renders clean via
#2606's freeze credit. This is the mainline 'loop a short clip to fill a
longer scene' case, the reason loop exists.

Fix: extend #2606's source-credit to loops symmetrically — the delivered
set (all N source frames) covers every repeat within the slot, so
expectedFrames = min(slotFrames, sourceFrames) for both hold and loop.
Fail-loud preserved for a genuinely-broken loop (extractor truncated
below its own source): a 60/90 delivery still aborts at 66.7% < 95%
because the delivered set no longer covers the full source period the
loop reuses. Missing extractions still require the full slot.

Test updates:
- 'still requires the full authored slot for looping clips' locked in
  the buggy behavior; replaced with 'credits a looping short clip
  against the source portion' which asserts the correct 90/90/1.0.
- Added 'still fails when a looping clip's source extraction is
  truncated' as the new fail-loud floor.

Fixes #2665. Regression window: 0.7.60 (#2606's original ship)
through 0.7.67 (current).

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../render/videoFrameCoverage.test.ts         | 19 ++++++++++++++++---
 .../src/services/render/videoFrameCoverage.ts | 18 ++++++++++--------
 2 files changed, 26 insertions(+), 11 deletions(-)

diff --git a/packages/producer/src/services/render/videoFrameCoverage.test.ts b/packages/producer/src/services/render/videoFrameCoverage.test.ts
index 7ba284e760..9b018d17e9 100644
--- a/packages/producer/src/services/render/videoFrameCoverage.test.ts
+++ b/packages/producer/src/services/render/videoFrameCoverage.test.ts
@@ -155,12 +155,25 @@ describe("computeVideoFrameCoverage", () => {
     expect(reports[0]).toMatchObject({ expectedFrames: 90, capturedFrames: 90, ratio: 1 });
   });
 
-  it("still requires the full authored slot for looping clips", () => {
+  it("credits a looping short clip against the source portion — the delivered frame set covers every repeat (#2665)", () => {
+    // Regression #2665: a looping video shorter than its slot delivered all
+    // its source frames (extractor complete), but the pre-fix gate measured
+    // 90 unique / 300 slot = 30% and aborted. Every one of the 300 output
+    // frames maps to one of the 90 source frames — coverage is 100%.
     const videos = [makeVideo({ id: "loop", start: 0, end: 10, loop: true })];
     const extracted = [makeExtracted("loop", 90, { durationSeconds: 3 })];
     const reports = computeVideoFrameCoverage(videos, extracted, 30);
-    expect(reports[0]).toMatchObject({ expectedFrames: 300, capturedFrames: 90 });
-    expect(reports[0]!.ratio).toBeCloseTo(0.3, 5);
+    expect(reports[0]).toMatchObject({ expectedFrames: 90, capturedFrames: 90, ratio: 1 });
+  });
+
+  it("still fails when a looping clip's source extraction is truncated", () => {
+    // Fail-loud preserved for a genuinely-broken loop: only 60/90 source
+    // frames arrived, so the delivered set does NOT cover every repeat.
+    const videos = [makeVideo({ id: "truncated-loop", start: 0, end: 10, loop: true })];
+    const extracted = [makeExtracted("truncated-loop", 60, { durationSeconds: 3 })];
+    const reports = computeVideoFrameCoverage(videos, extracted, 30);
+    expect(reports[0]).toMatchObject({ expectedFrames: 90, capturedFrames: 60 });
+    expect(() => assertVideoFrameCoverage(reports, 0.95)).toThrow(VideoFrameCoverageError);
   });
 
   it("still fails when extraction is truncated before the held-tail source", () => {
diff --git a/packages/producer/src/services/render/videoFrameCoverage.ts b/packages/producer/src/services/render/videoFrameCoverage.ts
index 0d75a05474..3e8f1896d6 100644
--- a/packages/producer/src/services/render/videoFrameCoverage.ts
+++ b/packages/producer/src/services/render/videoFrameCoverage.ts
@@ -141,17 +141,19 @@ export function computeVideoFrameCoverage(
   for (const video of videos) {
     const entry = byId.get(video.id);
     const slotFrames = expectedFramesForClip(video.start, video.end, fps);
-    // Non-looping clips intentionally hold their final decoded frame when the
-    // authored slot outlasts the source (#2516). Coverage must therefore
-    // measure the source portion, while still requiring the full slot for
-    // looping clips and for missing extractions (where no hold is possible).
+    // A short source in a longer slot has a legitimate delivery ceiling of
+    // the source portion, not the full slot: a non-looping clip holds its
+    // final decoded frame across the tail (#2516/#2606), and a looping clip
+    // reuses its full source frame set per repeat (#2665). In both cases the
+    // full source *has* been delivered — the same 90 unique source frames
+    // cover the 300-frame slot — so coverage must measure source-source, not
+    // slot-source. A missing extraction (no `entry`) still requires the full
+    // slot; there's no delivered set to credit.
     const sourceDuration = entry ? entry.metadata.durationSeconds - video.mediaStart : NaN;
     const hasUsableSourceDuration = Number.isFinite(sourceDuration) && sourceDuration > 0;
     const sourceFrames =
-      entry && !video.loop && hasUsableSourceDuration
-        ? expectedFramesForClip(0, sourceDuration, fps)
-        : slotFrames;
-    const expectedFrames = entry && !video.loop ? Math.min(slotFrames, sourceFrames) : slotFrames;
+      entry && hasUsableSourceDuration ? expectedFramesForClip(0, sourceDuration, fps) : slotFrames;
+    const expectedFrames = entry ? Math.min(slotFrames, sourceFrames) : slotFrames;
     // framePaths is a Map — `size` is the number of distinct captured frames
     // delivered to the runtime injector, which is the load-bearing count
     // (some extractors report a total that includes cache-hit-skipped frames

From 1e2c7d673fc0fe8da9a822bb7a8744f84f44d9d4 Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Wed, 22 Jul 2026 00:24:59 -0400
Subject: [PATCH 016/125] fix(core): preserve nested-rule selectors in
 composition CSS scoping (#2721) (#2733)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Chrome 112+ / Firefox 117+ / Safari 16.5+ support native CSS Nesting.
A nested rule like '.title { … }' inside '[data-composition-id="intro"]
{ … }' resolves at match time to '<parent> .title' via the implicit
'&' prefix.

'scopeCssToComposition' walks every rule via 'root.walkRules' and re-
scopes selectors, but it did so for nested rules too — producing
'[…scope…] .title' inside '[…scope…] { … }', which nesting then
prepends AGAIN to '[…scope…] […scope…] .title'. Since the composition
root only appears once in the DOM, the doubly-scoped selector never
matches — the nested rule appears 'just ignored' as the reporter
described (#2721).

Reproduced on 0.7.66 with the reporter's exact composition. Fix: add
'isNestedInsideAnotherRule' predicate — mirrors the existing
'isInsideGlobalAtRule' — and skip nested rules in the walkRules
callback. Top-level rules still get scoped; their nested descendants
inherit scope naturally via CSS Nesting at match time.

Added two focused tests:
- 'preserves nested-rule selectors so CSS Nesting inheritance works
  (#2721)' — asserts nested '.title' and 'h2' selectors stay verbatim
  while top-level rules keep scoping.
- 'preserves deeply-nested CSS Nesting rules (#2721)' — same rule at
  depth 3.

All 37 existing scopeCssToComposition tests still pass.

Fixes #2721.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../src/compiler/compositionScoping.test.ts   | 45 +++++++++++++++++++
 .../core/src/compiler/compositionScoping.ts   | 19 ++++++++
 2 files changed, 64 insertions(+)

diff --git a/packages/core/src/compiler/compositionScoping.test.ts b/packages/core/src/compiler/compositionScoping.test.ts
index 55302aeb8e..7985c9f809 100644
--- a/packages/core/src/compiler/compositionScoping.test.ts
+++ b/packages/core/src/compiler/compositionScoping.test.ts
@@ -800,6 +800,51 @@ window.__afterTimeline = window.__timelines.scene;
     expect(result).toContain('[id="intro"]');
   });
 
+  it("preserves nested-rule selectors so CSS Nesting inheritance works (#2721)", () => {
+    // Chrome 112+ / Firefox 117+ / Safari 16.5+ support native CSS Nesting.
+    // A nested rule like `.title { … }` inside `[data-composition-id="intro"] { … }`
+    // resolves at match time to `<parent> .title` via the implicit `&` prefix.
+    // The scoper must NOT re-apply the composition scope to the nested selector —
+    // that produces `<scope> <scope> .title`, which matches nothing because the
+    // composition root only appears once in the DOM.
+    const scoped = scopeCssToComposition(
+      `
+        [data-composition-id="intro"] h1 { color: red; }
+        [data-composition-id="intro"] {
+          .title { color: brown; }
+          h2 { color: blue; }
+        }
+      `,
+      "intro",
+    );
+    // Top-level rules still get scoped.
+    expect(scoped).toContain('[data-composition-id="intro"] h1');
+    // Nested rules keep their author-original selectors verbatim so CSS Nesting
+    // can prepend the parent's `&` at match time.
+    expect(scoped).toMatch(/\.title\s*\{/);
+    expect(scoped).toMatch(/h2\s*\{/);
+    // The pre-fix bug re-scoped nested rules to `[…] .title`, which never matched.
+    expect(scoped).not.toContain('[data-composition-id="intro"] .title');
+    expect(scoped).not.toContain('[data-composition-id="intro"] h2');
+  });
+
+  it("preserves deeply-nested CSS Nesting rules (#2721)", () => {
+    const scoped = scopeCssToComposition(
+      `
+        [data-composition-id="intro"] {
+          .card {
+            .header { font-weight: bold; }
+          }
+        }
+      `,
+      "intro",
+    );
+    expect(scoped).toMatch(/\.card\s*\{/);
+    expect(scoped).toMatch(/\.header\s*\{/);
+    expect(scoped).not.toContain('[data-composition-id="intro"] .card');
+    expect(scoped).not.toContain('[data-composition-id="intro"] .header');
+  });
+
   it("wraps scripts with authored root id normalization for #id GSAP selectors", () => {
     const { document } = parseHTML(`
       <div data-composition-id="intro">
diff --git a/packages/core/src/compiler/compositionScoping.ts b/packages/core/src/compiler/compositionScoping.ts
index 6224270a5b..cbe75b0f87 100644
--- a/packages/core/src/compiler/compositionScoping.ts
+++ b/packages/core/src/compiler/compositionScoping.ts
@@ -200,6 +200,24 @@ function isInsideGlobalAtRule(rule: Rule): boolean {
   return false;
 }
 
+/**
+ * A Rule nested inside another Rule (CSS Nesting Module Level 1) already
+ * inherits scope from its parent's `&` prefix at match time — re-applying
+ * the composition scope to the nested selector produces
+ * `<scope> <scope> .child`, which matches nothing when the composition
+ * root only appears once in the DOM. Only top-level rules get scoped;
+ * their nested descendants inherit the scope naturally via CSS nesting.
+ * See #2721 for the reproducer that motivated this.
+ */
+function isNestedInsideAnotherRule(rule: Rule): boolean {
+  let current: Node["parent"] = rule.parent;
+  while (current) {
+    if (current.type === "rule") return true;
+    current = current.parent;
+  }
+  return false;
+}
+
 export function scopeCssToComposition(
   css: string,
   compositionId: string,
@@ -216,6 +234,7 @@ export function scopeCssToComposition(
 
   root.walkRules((rule) => {
     if (isInsideGlobalAtRule(rule)) return;
+    if (isNestedInsideAnotherRule(rule)) return;
     rule.selectors = rule.selectors.map((selector) =>
       scopeSelector(
         selector,

From 71d84ff27f1c2b2828f4fdf9015c3da4157140ee Mon Sep 17 00:00:00 2001
From: James <james.russo@heygen.com>
Date: Wed, 22 Jul 2026 04:41:54 +0000
Subject: [PATCH 017/125] chore: release v0.7.68

---
 .claude-plugin/plugin.json               |  2 +-
 .codex-plugin/plugin.json                |  2 +-
 .cursor-plugin/plugin.json               |  2 +-
 docs/changelog.mdx                       | 24 ++++++++++++++++++++++++
 packages/aws-lambda/package.json         |  2 +-
 packages/cli/package.json                |  2 +-
 packages/core/package.json               |  2 +-
 packages/engine/package.json             |  2 +-
 packages/gcp-cloud-run/package.json      |  2 +-
 packages/lint/package.json               |  2 +-
 packages/parsers/package.json            |  2 +-
 packages/player/package.json             |  2 +-
 packages/producer/package.json           |  2 +-
 packages/sdk/package.json                |  2 +-
 packages/shader-transitions/package.json |  2 +-
 packages/studio-server/package.json      |  2 +-
 packages/studio/package.json             |  2 +-
 releases/v0.7.68.md                      | 23 +++++++++++++++++++++++
 18 files changed, 63 insertions(+), 16 deletions(-)
 create mode 100644 releases/v0.7.68.md

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 181fa02fc7..d29f2c5c37 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 59bbe96081..c177766287 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index 1e3010d10c..dff479a406 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -3,7 +3,7 @@
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com"
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index ae91952403..cb68e063e4 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -8,6 +8,30 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
 
 {/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
 
+<Update
+  label="HyperFrames v0.7.68"
+  description="Released - 2026-07-22"
+  tags={["Release", "Core", "Producer", "Skills"]}
+>
+Bug-fix release. The video coverage gate no longer aborts renders of looping short videos, and composition-level CSS with native CSS Nesting now applies to nested selectors instead of being silently ignored.
+
+## Fixes
+
+- **Producer:** Credit looping short videos in coverage gate (#2665). A short clip in a longer slot with `loop` set delivers all its source frames once and reuses them per repeat; the gate now measures against source-source instead of unique-source-vs-slot, so a 3s looping clip in a 10s slot no longer aborts at 30% coverage ([a637f394e](https://github.com/heygen-com/hyperframes/commit/a637f394ee900c64c8f2e1ee78cf1e0ce17b8739), [#2732](https://github.com/heygen-com/hyperframes/pull/2732))
+- **Core:** Preserve nested-rule selectors in composition CSS scoping (#2721). Native CSS Nesting (Chrome 112+ / Firefox 117+ / Safari 16.5+) now works inside a composition's `<style>` block; the scoper no longer re-applies the composition selector to nested rules, so `[data-composition-id="foo"] { .title { … } }` correctly matches `.title` inside the composition ([1e2c7d673](https://github.com/heygen-com/hyperframes/commit/1e2c7d673fc0fe8da9a822bb7a8744f84f44d9d4), [#2733](https://github.com/heygen-com/hyperframes/pull/2733))
+
+## Docs & Examples
+
+- **Skills:** Make captions non-optional in changelog-video ([807078c7c](https://github.com/heygen-com/hyperframes/commit/807078c7cde9d5c8403588722d1cd9397c513a0d), [#2729](https://github.com/heygen-com/hyperframes/pull/2729))
+- **Changelog:** Weekly digest 2026-07-13–2026-07-20 ([2e97e5b1e](https://github.com/heygen-com/hyperframes/commit/2e97e5b1ef78c18c31b042b082bb7cc7cc44ac1c), [#2664](https://github.com/heygen-com/hyperframes/pull/2664))
+
+## Other Changes
+
+- Revert "feat(producer): renderStretch to re-time short compositions across longer scenes (#2676)" ([69446e772](https://github.com/heygen-com/hyperframes/commit/69446e77265a420c4f24a0395682212793eb323f), [#2730](https://github.com/heygen-com/hyperframes/pull/2730))
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.7.67...v0.7.68).
+</Update>
+
 <Update
   label="HyperFrames v0.7.67"
   description="Released - 2026-07-21"
diff --git a/packages/aws-lambda/package.json b/packages/aws-lambda/package.json
index b78981ea96..8bb924f5e2 100644
--- a/packages/aws-lambda/package.json
+++ b/packages/aws-lambda/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 7482b92d0e..4428ad06da 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "license": "Apache-2.0",
   "repository": {
diff --git a/packages/core/package.json b/packages/core/package.json
index ff8c78e73c..43c4384ff2 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/packages/engine/package.json b/packages/engine/package.json
index cbf79410ca..8bb6f744c6 100644
--- a/packages/engine/package.json
+++ b/packages/engine/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
diff --git a/packages/gcp-cloud-run/package.json b/packages/gcp-cloud-run/package.json
index c90c9fd2ac..4b973cf01b 100644
--- a/packages/gcp-cloud-run/package.json
+++ b/packages/gcp-cloud-run/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/gcp-cloud-run",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index 0c0340cc02..b896363047 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index 03792e30de..1fa6323abc 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/player/package.json b/packages/player/package.json
index bbb7c85165..b3f3d3ee2f 100644
--- a/packages/player/package.json
+++ b/packages/player/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/player",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "Embeddable web component for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/producer/package.json b/packages/producer/package.json
index 21c04f9027..838272e73e 100644
--- a/packages/producer/package.json
+++ b/packages/producer/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 9b589453ef..4b3fa0ca9f 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
diff --git a/packages/shader-transitions/package.json b/packages/shader-transitions/package.json
index b6321fd0db..08ff66f313 100644
--- a/packages/shader-transitions/package.json
+++ b/packages/shader-transitions/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/shader-transitions",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "WebGL shader transitions for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/studio-server/package.json b/packages/studio-server/package.json
index b1c7c87339..26d527c0cd 100644
--- a/packages/studio-server/package.json
+++ b/packages/studio-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/studio/package.json b/packages/studio/package.json
index 0ae1090f19..1f656c9208 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.7.67",
+  "version": "0.7.68",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/releases/v0.7.68.md b/releases/v0.7.68.md
new file mode 100644
index 0000000000..6e40c773ad
--- /dev/null
+++ b/releases/v0.7.68.md
@@ -0,0 +1,23 @@
+# HyperFrames v0.7.68
+
+Released on 2026-07-22.
+
+Bug-fix release. The video coverage gate no longer aborts renders of looping short videos, and composition-level CSS with native CSS Nesting now applies to nested selectors instead of being silently ignored.
+
+## Fixes
+
+- **Producer:** Credit looping short videos in coverage gate (#2665). A short clip in a longer slot with `loop` set delivers all its source frames once and reuses them per repeat; the gate now measures against source-source instead of unique-source-vs-slot, so a 3s looping clip in a 10s slot no longer aborts at 30% coverage ([a637f394e](https://github.com/heygen-com/hyperframes/commit/a637f394ee900c64c8f2e1ee78cf1e0ce17b8739), [#2732](https://github.com/heygen-com/hyperframes/pull/2732))
+- **Core:** Preserve nested-rule selectors in composition CSS scoping (#2721). Native CSS Nesting (Chrome 112+ / Firefox 117+ / Safari 16.5+) now works inside a composition's `<style>` block; the scoper no longer re-applies the composition selector to nested rules, so `[data-composition-id="foo"] { .title { … } }` correctly matches `.title` inside the composition ([1e2c7d673](https://github.com/heygen-com/hyperframes/commit/1e2c7d673fc0fe8da9a822bb7a8744f84f44d9d4), [#2733](https://github.com/heygen-com/hyperframes/pull/2733))
+
+## Docs & Examples
+
+- **Skills:** Make captions non-optional in changelog-video ([807078c7c](https://github.com/heygen-com/hyperframes/commit/807078c7cde9d5c8403588722d1cd9397c513a0d), [#2729](https://github.com/heygen-com/hyperframes/pull/2729))
+- **Changelog:** Weekly digest 2026-07-13–2026-07-20 ([2e97e5b1e](https://github.com/heygen-com/hyperframes/commit/2e97e5b1ef78c18c31b042b082bb7cc7cc44ac1c), [#2664](https://github.com/heygen-com/hyperframes/pull/2664))
+
+## Other Changes
+
+- Revert "feat(producer): renderStretch to re-time short compositions across longer scenes (#2676)" ([69446e772](https://github.com/heygen-com/hyperframes/commit/69446e77265a420c4f24a0395682212793eb323f), [#2730](https://github.com/heygen-com/hyperframes/pull/2730))
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.7.67...v0.7.68

From 97ec7db5cccd14a47fcfbe534d269dfea7a0d37d Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Wed, 22 Jul 2026 15:35:28 -0700
Subject: [PATCH 018/125] fix(hooks): pre-commit gate denies commit instead of
 ending the turn
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The pre-commit build/lint/typecheck PreToolUse hook emitted {continue:false,
stopReason}, which halts the agent's turn — the dev had to type 'continue'
after every failed gate. Switch to a PreToolUse deny decision so the failing
commit is still blocked but the failure text is fed back to the agent as tool
feedback, letting it fix and retry without a manual nudge.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .claude/settings.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.claude/settings.json b/.claude/settings.json
index 4c3d6a1531..5daf570fce 100644
--- a/.claude/settings.json
+++ b/.claude/settings.json
@@ -8,7 +8,7 @@
             "type": "command",
             "timeout": 180,
             "statusMessage": "Running build + lint + typecheck before commit…",
-            "command": "node -e \"\nconst chunks = [];\nprocess.stdin.on('data', d => chunks.push(d));\nprocess.stdin.on('end', () => {\n  const input = JSON.parse(Buffer.concat(chunks).toString());\n  const cmd = input.tool_input?.command || '';\n  if (!/git\\s+commit\\b/.test(cmd)) process.exit(0);\n  const { execSync } = require('child_process');\n  const fs = require('fs');\n  const path = require('path');\n  const os = require('os');\n  // A leading 'cd <path>' in the command is the real target directory:\n  // Claude Code prefixes this whenever the session's tracked cwd differs\n  // from this hook process's own cwd (e.g. a sibling repo worktree) — the\n  // hook process itself always inherits the primary working directory,\n  // never the command's actual target.\n  function resolveTargetDir() {\n    const m = cmd.match(/^\\s*cd\\s+('([^']+)'|(\\S+))\\s*(?:&&|;|\\n|$)/);\n    if (m) {\n      let dir = m[2] || m[3];\n      if (dir.startsWith('~')) dir = path.join(os.homedir(), dir.slice(1));\n      dir = path.resolve(process.cwd(), dir);\n      if (fs.existsSync(dir)) return dir;\n    }\n    return process.cwd();\n  }\n  const targetDir = resolveTargetDir();\n  let repoRoot;\n  try {\n    repoRoot = execSync('git rev-parse --show-toplevel', { cwd: targetDir, encoding: 'utf8' }).trim();\n  } catch {\n    process.exit(0);\n  }\n  // Only this repo's own bun build/lint/typecheck applies — skip silently\n  // for any other repo (e.g. a sibling Go/Python repo touched in the same session).\n  const pkgPath = path.join(repoRoot, 'package.json');\n  if (!fs.existsSync(pkgPath)) process.exit(0);\n  let pkg;\n  try {\n    pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));\n  } catch {\n    process.exit(0);\n  }\n  if (pkg.name !== 'hyperframes-monorepo') process.exit(0);\n  const steps = [\n    ['bun run build', 'Build'],\n    ['bun run lint', 'Lint'],\n    ['bun run --filter \\'*\\' typecheck 2>&1 | grep -v \\'vitest\\\\|test\\\\.ts\\' || true', 'Typecheck'],\n  ];\n  const failures = [];\n  for (const [script, label] of steps) {\n    try {\n      execSync(script, { cwd: repoRoot, stdio: 'pipe' });\n    } catch (e) {\n      failures.push(label + ':\\n' + (e.stdout?.toString() || e.message).slice(0, 400));\n    }\n  }\n  if (failures.length > 0) {\n    process.stdout.write(JSON.stringify({\n      continue: false,\n      stopReason: '❌ Pre-commit checks failed:\\n\\n' + failures.join('\\n\\n') + '\\n\\nFix the issues above before committing.',\n    }));\n  }\n});\""
+            "command": "node -e \"\nconst chunks = [];\nprocess.stdin.on('data', d => chunks.push(d));\nprocess.stdin.on('end', () => {\n  const input = JSON.parse(Buffer.concat(chunks).toString());\n  const cmd = input.tool_input?.command || '';\n  if (!/git\\s+commit\\b/.test(cmd)) process.exit(0);\n  const { execSync } = require('child_process');\n  const fs = require('fs');\n  const path = require('path');\n  const os = require('os');\n  // A leading 'cd <path>' in the command is the real target directory:\n  // Claude Code prefixes this whenever the session's tracked cwd differs\n  // from this hook process's own cwd (e.g. a sibling repo worktree) — the\n  // hook process itself always inherits the primary working directory,\n  // never the command's actual target.\n  function resolveTargetDir() {\n    const m = cmd.match(/^\\s*cd\\s+('([^']+)'|(\\S+))\\s*(?:&&|;|\\n|$)/);\n    if (m) {\n      let dir = m[2] || m[3];\n      if (dir.startsWith('~')) dir = path.join(os.homedir(), dir.slice(1));\n      dir = path.resolve(process.cwd(), dir);\n      if (fs.existsSync(dir)) return dir;\n    }\n    return process.cwd();\n  }\n  const targetDir = resolveTargetDir();\n  let repoRoot;\n  try {\n    repoRoot = execSync('git rev-parse --show-toplevel', { cwd: targetDir, encoding: 'utf8' }).trim();\n  } catch {\n    process.exit(0);\n  }\n  // Only this repo's own bun build/lint/typecheck applies — skip silently\n  // for any other repo (e.g. a sibling Go/Python repo touched in the same session).\n  const pkgPath = path.join(repoRoot, 'package.json');\n  if (!fs.existsSync(pkgPath)) process.exit(0);\n  let pkg;\n  try {\n    pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));\n  } catch {\n    process.exit(0);\n  }\n  if (pkg.name !== 'hyperframes-monorepo') process.exit(0);\n  const steps = [\n    ['bun run build', 'Build'],\n    ['bun run lint', 'Lint'],\n    ['bun run --filter \\'*\\' typecheck 2>&1 | grep -v \\'vitest\\\\|test\\\\.ts\\' || true', 'Typecheck'],\n  ];\n  const failures = [];\n  for (const [script, label] of steps) {\n    try {\n      execSync(script, { cwd: repoRoot, stdio: 'pipe' });\n    } catch (e) {\n      failures.push(label + ':\\n' + (e.stdout?.toString() || e.message).slice(0, 400));\n    }\n  }\n  if (failures.length > 0) {\n    process.stdout.write(JSON.stringify({\n      hookSpecificOutput: {\n        hookEventName: 'PreToolUse',\n        permissionDecision: 'deny',\n        permissionDecisionReason: '❌ Pre-commit checks failed:\\n\\n' + failures.join('\\n\\n') + '\\n\\nFix the issues above, then retry the commit.',\n      },\n    }));\n  }\n});\""
           }
         ]
       }

From 948264d6b205cadd191e04f36af332ed4a6bb233 Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Wed, 22 Jul 2026 21:17:52 -0400
Subject: [PATCH 019/125] fix(producer): resolve residual font and probe
 failures (#2738)

---
 .../deterministicFonts-failClosed.test.ts     | 46 +++++++++++
 .../src/services/deterministicFonts.ts        |  8 +-
 .../services/render/stages/probeStage.test.ts | 82 ++++++++++++++++---
 .../src/services/render/stages/probeStage.ts  | 13 ++-
 4 files changed, 133 insertions(+), 16 deletions(-)

diff --git a/packages/producer/src/services/deterministicFonts-failClosed.test.ts b/packages/producer/src/services/deterministicFonts-failClosed.test.ts
index d3860ed6f1..f2c7cb4c94 100644
--- a/packages/producer/src/services/deterministicFonts-failClosed.test.ts
+++ b/packages/producer/src/services/deterministicFonts-failClosed.test.ts
@@ -55,6 +55,26 @@ function makeHttp503Fetch(): typeof fetch {
     })) as unknown as typeof fetch;
 }
 
+function makeGoogleFontFetch(cssRequests: string[]): typeof fetch {
+  return (async (input: string | URL | Request) => {
+    const requestUrl = input instanceof Request ? input.url : String(input);
+    if (requestUrl.startsWith("https://fonts.googleapis.com/")) {
+      cssRequests.push(requestUrl);
+      const family = new URL(requestUrl).searchParams.get("family")?.split(":", 1)[0] ?? "test";
+      const fontUrl = `https://fonts.gstatic.com/s/test/v1/${family.toLowerCase().replace(/\s+/g, "-")}.woff2`;
+      return new Response(
+        `@font-face {
+          font-style: normal;
+          font-weight: 400;
+          src: url(${fontUrl}) format('woff2');
+        }`,
+        { status: 200 },
+      );
+    }
+    return new Response(new Uint8Array([0, 1, 2, 3]), { status: 200 });
+  }) as unknown as typeof fetch;
+}
+
 describe("injectDeterministicFontFaces — failClosedFontFetch: false (default)", () => {
   it("swallows a network failure and returns the original HTML (no throw)", async () => {
     const result = await injectDeterministicFontFaces(HTML_REQUESTING_UNRESOLVED_FONT, {
@@ -95,6 +115,32 @@ describe("injectDeterministicFontFaces — failClosedFontFetch: false (default)"
 });
 
 describe("injectDeterministicFontFaces — failClosedFontFetch: true", () => {
+  for (const [authoredFamily, googleFamily] of [
+    ["DM+Mono", "DM Mono"],
+    ["IBM+Plex+Mono", "IBM Plex Mono"],
+    ["Spline+Sans+Mono", "Spline Sans Mono"],
+  ] as const) {
+    it(`resolves URL-style family ${authoredFamily} through Google Fonts`, async () => {
+      const cssRequests: string[] = [];
+      const html = `<!doctype html><html><head><style>
+        body { font-family: "${authoredFamily}", monospace; }
+      </style></head><body><p>hello</p></body></html>`;
+
+      const result = await injectDeterministicFontFaces(html, {
+        failClosedFontFetch: true,
+        allowSystemFontCapture: false,
+        fetchImpl: makeGoogleFontFetch(cssRequests),
+      });
+
+      expect(cssRequests).toHaveLength(1);
+      const familyParam = new URL(cssRequests[0]!).searchParams.get("family");
+      expect(familyParam?.startsWith(`${googleFamily}:`)).toBe(true);
+      expect(familyParam?.startsWith(`${authoredFamily}:`)).toBe(false);
+      expect(result).toContain(`font-family: "${authoredFamily}"`);
+      expect(result).toContain("data-hyperframes-deterministic-fonts");
+    });
+  }
+
   it("throws FontFetchError on a network failure", async () => {
     let caught: unknown;
     try {
diff --git a/packages/producer/src/services/deterministicFonts.ts b/packages/producer/src/services/deterministicFonts.ts
index 24dee3db02..df4664d4a1 100644
--- a/packages/producer/src/services/deterministicFonts.ts
+++ b/packages/producer/src/services/deterministicFonts.ts
@@ -743,7 +743,13 @@ async function fetchGoogleFont(
   fontText?: string,
 ): Promise<GoogleFontFace[]> {
   const slug = fontSlug(familyName);
-  const encodedFamily = encodeURIComponent(familyName);
+  // Agents sometimes copy the `family=` value from a Google Fonts URL into
+  // CSS, where `+` remains a literal character instead of being decoded as a
+  // space. Resolve that URL-style spelling through the canonical Google family
+  // while preserving `familyName` for the emitted @font-face alias so the
+  // authored CSS still matches it.
+  const googleFamilyName = familyName.replace(/\+/g, " ");
+  const encodedFamily = encodeURIComponent(googleFamilyName);
   const textParam = fontText ? `&text=${encodeURIComponent(fontText)}` : "";
   const url = `https://fonts.googleapis.com/css2?family=${encodedFamily}:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,400;1,700${textParam}`;
 
diff --git a/packages/producer/src/services/render/stages/probeStage.test.ts b/packages/producer/src/services/render/stages/probeStage.test.ts
index a1b78c1905..c39dc2e297 100644
--- a/packages/producer/src/services/render/stages/probeStage.test.ts
+++ b/packages/producer/src/services/render/stages/probeStage.test.ts
@@ -12,14 +12,23 @@ import {
 const capturedCfgs: unknown[] = [];
 const capturedOptions: unknown[] = [];
 
-const mockPage = {
-  evaluate: async () => ({
-    timelineKeys: [],
-    hfDuration: 5,
-    gsapLoaded: false,
-    totalDurationMs: 5000,
-    __hf: {},
-  }),
+type MockSession = {
+  id: number;
+  isInitialized: boolean;
+  browserConsoleBuffer: string[];
+  page: {
+    sessionId: number;
+    evaluate: () => Promise<{
+      timelineKeys: never[];
+      hfDuration: number;
+      gsapLoaded: boolean;
+      totalDurationMs: number;
+      __hf: Record<string, never>;
+    }>;
+  };
+  launchCaptureMode: "beginframe" | "screenshot";
+  beginFrameTimeTicks: number;
+  beginFrameIntervalMs: number;
 };
 
 let initializeSessionCallCount = 0;
@@ -29,6 +38,10 @@ let createSessionCallCount = 0;
 let createSessionFailUntilAttempt = 0;
 let createSessionError: Error | null = null;
 let closeCaptureSessionCallCount = 0;
+let probeBeginFrameAlive = true;
+const createdSessions: MockSession[] = [];
+const closedSessions: MockSession[] = [];
+const durationProbeSessions: MockSession[] = [];
 
 function resetRetryMocks() {
   initializeSessionCallCount = 0;
@@ -38,6 +51,10 @@ function resetRetryMocks() {
   createSessionFailUntilAttempt = 0;
   createSessionError = null;
   closeCaptureSessionCallCount = 0;
+  probeBeginFrameAlive = true;
+  createdSessions.length = 0;
+  closedSessions.length = 0;
+  durationProbeSessions.length = 0;
 }
 
 mock.module("@hyperframes/engine", () => ({
@@ -54,11 +71,29 @@ mock.module("@hyperframes/engine", () => ({
     if (createSessionError && createSessionCallCount <= createSessionFailUntilAttempt) {
       throw createSessionError;
     }
-    return {
+    const sessionId = createSessionCallCount;
+    const session: MockSession = {
+      id: sessionId,
       isInitialized: false,
       browserConsoleBuffer: [],
-      page: mockPage,
+      page: {
+        sessionId,
+        evaluate: async () => ({
+          timelineKeys: [],
+          hfDuration: 5,
+          gsapLoaded: false,
+          totalDurationMs: 5000,
+          __hf: {},
+        }),
+      },
+      launchCaptureMode: (cfg as { forceScreenshot?: boolean }).forceScreenshot
+        ? "screenshot"
+        : "beginframe",
+      beginFrameTimeTicks: 100,
+      beginFrameIntervalMs: 1,
     };
+    createdSessions.push(session);
+    return session;
   },
   initializeSession: async (session: { isInitialized: boolean }) => {
     initializeSessionCallCount++;
@@ -67,10 +102,15 @@ mock.module("@hyperframes/engine", () => ({
     }
     session.isInitialized = true;
   },
-  getCompositionDuration: async () => 5,
-  closeCaptureSession: async () => {
+  getCompositionDuration: async (session: MockSession) => {
+    durationProbeSessions.push(session);
+    return 5;
+  },
+  closeCaptureSession: async (session: MockSession) => {
     closeCaptureSessionCallCount++;
+    closedSessions.push(session);
   },
+  probeBeginFrameLiveness: async () => probeBeginFrameAlive,
   // Mirror of the real engine classifier. Canonical tests + pattern list
   // live in frameCapture-transientErrors.test.ts — update both if patterns change.
   isTransientBrowserError: (error: unknown) => {
@@ -440,6 +480,24 @@ describe("runProbeStage — decimal duration frame count", () => {
 });
 
 describe("runProbeStage — transient browser error retry (#1687)", () => {
+  it("uses the replacement session after a BeginFrame liveness fallback", async () => {
+    resetRetryMocks();
+    capturedCfgs.length = 0;
+    probeBeginFrameAlive = false;
+
+    const { runProbeStage } = await import("./probeStage.js");
+    const input = makeProbeInput({ cfgForceScreenshot: false, stageForceScreenshot: false });
+
+    const result = await runProbeStage(input);
+
+    expect(createSessionCallCount).toBe(2);
+    expect(closedSessions).toEqual([createdSessions[0]]);
+    expect(capturedCfgs[1]).toMatchObject({ forceScreenshot: true });
+    expect(durationProbeSessions).toEqual([createdSessions[1]]);
+    expect(result.probeSession).toBe(createdSessions[1]);
+    expect(result.beginFrameStalled).toBe(true);
+  });
+
   it("retries once on a transient 'Navigating frame was detached' error and succeeds", async () => {
     resetRetryMocks();
     capturedCfgs.length = 0;
diff --git a/packages/producer/src/services/render/stages/probeStage.ts b/packages/producer/src/services/render/stages/probeStage.ts
index 3e9f3b1589..58142a30f0 100644
--- a/packages/producer/src/services/render/stages/probeStage.ts
+++ b/packages/producer/src/services/render/stages/probeStage.ts
@@ -321,9 +321,10 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
     assertNotAborted();
     // After the retry loop, probeSession is guaranteed non-null (the loop
     // either breaks with a valid session or throws on the last attempt).
-    const session = probeSession!;
-    probeSession = session;
-    lastBrowserConsole = session.browserConsoleBuffer;
+    if (!probeSession) {
+      throw new Error("Browser probe completed without a capture session");
+    }
+    lastBrowserConsole = probeSession.browserConsoleBuffer;
 
     // BeginFrame liveness probe. On SwiftShader, heavy-layer compositions
     // (multi-group nested opacity caption animations — style-N prod comps)
@@ -384,6 +385,12 @@ export async function runProbeStage(input: ProbeStageInput): Promise<ProbeStageR
       }
     }
 
+    // Bind the session only after the BeginFrame fallback, which may close the
+    // original browser and replace it with a screenshot-mode session. Every
+    // downstream probe must use the live replacement rather than the closed
+    // session captured before the fallback.
+    const session = probeSession;
+
     // Discover root composition duration
     if (composition.duration <= 0) {
       log.info("Discovering composition duration...");

From 7a294f19562928036dae20d5e73c2637d1e19060 Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Wed, 22 Jul 2026 22:59:12 -0400
Subject: [PATCH 020/125] fix(lint): address render preflight review feedback
 (#2739)

---
 bun.lock                                      |   1 +
 packages/lint/package.json                    |   3 +-
 packages/lint/src/rules/core.test.ts          | 102 ++++++
 packages/lint/src/rules/core.ts               | 111 +++++++
 packages/lint/src/rules/fonts.test.ts         |  28 ++
 packages/lint/src/rules/fonts.ts              |   5 +-
 packages/lint/src/rules/gsap.test.ts          | 294 ++++++++++++++++++
 packages/lint/src/rules/gsap.ts               |  84 +++++
 .../parsers/src/gsapParserAcorn.full.test.ts  |  65 +++-
 packages/parsers/src/gsapParserAcorn.ts       | 103 +++++-
 10 files changed, 788 insertions(+), 8 deletions(-)

diff --git a/bun.lock b/bun.lock
index 797509c8ee..f277c12249 100644
--- a/bun.lock
+++ b/bun.lock
@@ -176,6 +176,7 @@
         "htmlparser2": "^10.1.0",
         "linkedom": "^0.18.12",
         "postcss": "^8.5.8",
+        "postcss-selector-parser": "^7.1.4",
       },
       "devDependencies": {
         "@types/node": "^25.0.10",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index b896363047..e48bce0526 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -56,7 +56,8 @@
     "@hyperframes/parsers": "workspace:*",
     "htmlparser2": "^10.1.0",
     "linkedom": "^0.18.12",
-    "postcss": "^8.5.8"
+    "postcss": "^8.5.8",
+    "postcss-selector-parser": "^7.1.4"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
diff --git a/packages/lint/src/rules/core.test.ts b/packages/lint/src/rules/core.test.ts
index 057e4b482b..bcfd5f94aa 100644
--- a/packages/lint/src/rules/core.test.ts
+++ b/packages/lint/src/rules/core.test.ts
@@ -848,6 +848,108 @@ body {
     });
   });
 
+  describe("repeated_id_descendant_selector", () => {
+    it("reports a selector that nests the same id inside itself", async () => {
+      const html = `<div id="scene_01" data-composition-id="root" data-width="1920" data-height="1080">
+        <style>#scene_01 #scene_01 .headline { color: red; }</style>
+      </div>`;
+      const result = await lintHyperframeHtml(html);
+      const finding = result.findings.find((f) => f.code === "repeated_id_descendant_selector");
+      expect(finding?.severity).toBe("error");
+      expect(finding?.selector).toBe("#scene_01 #scene_01 .headline");
+    });
+
+    it("does not report distinct descendant ids", async () => {
+      const html = `<div id="scene_01" data-composition-id="root" data-width="1920" data-height="1080">
+        <style>#scene_01 #headline { color: red; }</style>
+      </div>`;
+      const result = await lintHyperframeHtml(html);
+      expect(
+        result.findings.find((f) => f.code === "repeated_id_descendant_selector"),
+      ).toBeUndefined();
+    });
+
+    it.each(["#scene_01 > #scene_01", "#scene_01 .wrapper #scene_01"])(
+      "reports repeated ids across descendant combinators: %s",
+      async (selector) => {
+        const html = `<div data-composition-id="root" data-width="1920" data-height="1080">
+          <style>${selector} { color: red; }</style>
+        </div>`;
+        const result = await lintHyperframeHtml(html);
+        expect(
+          result.findings.find((f) => f.code === "repeated_id_descendant_selector"),
+        ).toBeDefined();
+      },
+    );
+
+    it.each([
+      ":is(#scene_01) #scene_01",
+      ":where(#scene_01) #scene_01",
+      "#scene_01 :is(#scene_01)",
+    ])("reports repeated ids required by selector pseudos: %s", async (selector) => {
+      const html = `<div data-composition-id="root" data-width="1920" data-height="1080">
+          <style>${selector} { color: red; }</style>
+        </div>`;
+      const result = await lintHyperframeHtml(html);
+      expect(
+        result.findings.find((f) => f.code === "repeated_id_descendant_selector"),
+      ).toBeDefined();
+    });
+
+    it.each([
+      ":is(#scene_01, .scene) #scene_01",
+      ":not(#scene_01) #scene_01",
+      ":has(#scene_01) #scene_01",
+    ])("does not report ids that are not required by a selector pseudo: %s", async (selector) => {
+      const html = `<div data-composition-id="root" data-width="1920" data-height="1080">
+          <style>${selector} { color: red; }</style>
+        </div>`;
+      const result = await lintHyperframeHtml(html);
+      expect(
+        result.findings.find((f) => f.code === "repeated_id_descendant_selector"),
+      ).toBeUndefined();
+    });
+
+    it.each(["& #scene_01 .headline", "#scene_01 .headline"])(
+      "reports repeated ids created by nested CSS: %s",
+      async (nestedSelector) => {
+        const html = `<div data-composition-id="root" data-width="1920" data-height="1080">
+          <style>#scene_01 { ${nestedSelector} { color: red; } }</style>
+        </div>`;
+        const result = await lintHyperframeHtml(html);
+        const finding = result.findings.find(
+          (candidate) => candidate.code === "repeated_id_descendant_selector",
+        );
+        expect(finding).toBeDefined();
+        expect(finding?.selector).toContain("#scene_01 #scene_01");
+      },
+    );
+
+    it("preserves dollar sequences while resolving nested selectors", async () => {
+      const html = `<div data-composition-id="root" data-width="1920" data-height="1080">
+        <style>#scene_01[data-query="$1"] { & #scene_01 { color: red; } }</style>
+      </div>`;
+      const result = await lintHyperframeHtml(html);
+      const finding = result.findings.find(
+        (candidate) => candidate.code === "repeated_id_descendant_selector",
+      );
+      expect(finding?.selector).toBe('#scene_01[data-query="$1"] #scene_01');
+    });
+
+    it.each(['[data-query="#scene_01 #scene_01"]', String.raw`#scene_01 #scene_01\:child`])(
+      "does not report non-repeated parsed ids: %s",
+      async (selector) => {
+        const html = `<div data-composition-id="root" data-width="1920" data-height="1080">
+        <style>${selector} { color: red; }</style>
+      </div>`;
+        const result = await lintHyperframeHtml(html);
+        expect(
+          result.findings.find((f) => f.code === "repeated_id_descendant_selector"),
+        ).toBeUndefined();
+      },
+    );
+  });
+
   it("warns when a timeline-visible element has no stable id for Studio editing", async () => {
     const html = `
 <html><body>
diff --git a/packages/lint/src/rules/core.ts b/packages/lint/src/rules/core.ts
index 1e0c80e342..15bc8f8fbb 100644
--- a/packages/lint/src/rules/core.ts
+++ b/packages/lint/src/rules/core.ts
@@ -1,5 +1,6 @@
 import type { LintContext, HyperframeLintFinding } from "../context";
 import postcss from "postcss";
+import selectorParser from "postcss-selector-parser";
 import {
   readAttr,
   readDecodedAttr,
@@ -25,6 +26,87 @@ function selectorTargetsCompositionId(selector: string, compositionId: string):
   ).test(selector);
 }
 
+function repeatedDescendantId(selector: string): string | null {
+  let repeated: string | null = null;
+
+  const requiredPseudoIds = (pseudo: selectorParser.Pseudo): Set<string> => {
+    if (![":is", ":where"].includes(pseudo.value.toLowerCase()) || pseudo.nodes.length === 0) {
+      return new Set<string>();
+    }
+
+    const optionIdSets: Set<string>[] = [];
+    for (const option of pseudo.nodes) {
+      // Only promote ids from a single compound. For selector-list branches with
+      // combinators, determining which compound is the subject requires fuller
+      // selector semantics; skipping them avoids false positives.
+      if (option.nodes.some((node) => node.type === "combinator")) return new Set<string>();
+      const optionIds = new Set<string>(
+        option.nodes.filter((node) => node.type === "id").map((node) => node.value),
+      );
+      optionIdSets.push(optionIds);
+    }
+    const [firstOptionIds, ...remainingOptionIds] = optionIdSets;
+    return new Set<string>(
+      [...(firstOptionIds ?? [])].filter((id) =>
+        remainingOptionIds.every((optionIds) => optionIds.has(id)),
+      ),
+    );
+  };
+
+  try {
+    selectorParser((root) => {
+      root.each((selectorNode) => {
+        const firstCompoundById = new Map<string, number>();
+        let compound = 0;
+        selectorNode.each((node) => {
+          if (repeated) return;
+          if (node.type === "combinator") {
+            compound += 1;
+            return;
+          }
+          const requiredIds =
+            node.type === "id"
+              ? [node.value]
+              : node.type === "pseudo"
+                ? [...requiredPseudoIds(node)]
+                : [];
+          for (const id of requiredIds) {
+            const firstCompound = firstCompoundById.get(id);
+            if (firstCompound !== undefined && firstCompound !== compound) {
+              repeated = id;
+              return;
+            }
+            firstCompoundById.set(id, compound);
+          }
+        });
+      });
+    }).processSync(selector);
+  } catch {
+    return null;
+  }
+  return repeated;
+}
+
+function resolvedRuleSelectors(rule: postcss.Rule): string[] {
+  let ancestor: postcss.AnyNode | undefined = rule.parent;
+  while (ancestor && ancestor.type !== "rule") ancestor = ancestor.parent;
+  if (!ancestor || ancestor.type !== "rule") return rule.selectors;
+
+  const parentSelectors = resolvedRuleSelectors(ancestor);
+  return parentSelectors.flatMap((parentSelector) =>
+    rule.selectors.map((childSelector) => {
+      const nestingToken = /(^|[\s>+~,(])&/g;
+      if (nestingToken.test(childSelector)) {
+        return childSelector.replace(
+          nestingToken,
+          (_, separator: string) => separator + parentSelector,
+        );
+      }
+      return `${parentSelector} ${childSelector}`;
+    }),
+  );
+}
+
 function isStudioTimelineElement(tag: { raw: string; name: string }): boolean {
   if (["script", "style", "link", "meta", "template", "noscript"].includes(tag.name)) {
     return false;
@@ -321,6 +403,35 @@ export const coreRules: Array<(ctx: LintContext) => HyperframeLintFinding[]> = [
     return findings;
   },
 
+  // repeated_id_descendant_selector
+  ({ styles }) => {
+    const findings: HyperframeLintFinding[] = [];
+    const reported = new Set<string>();
+    for (const style of styles) {
+      let root: postcss.Root;
+      try {
+        root = postcss.parse(style.content);
+      } catch {
+        continue;
+      }
+      root.walkRules((rule) => {
+        for (const selector of resolvedRuleSelectors(rule)) {
+          const repeatedId = repeatedDescendantId(selector);
+          if (!repeatedId || reported.has(repeatedId)) continue;
+          reported.add(repeatedId);
+          findings.push({
+            code: "repeated_id_descendant_selector",
+            severity: "error",
+            message: `Selector "${selector}" requires #${repeatedId} to be nested inside another #${repeatedId}. IDs must be unique, so this selector cannot match a valid composition.`,
+            selector,
+            fixHint: `Remove the duplicate ancestor: change \`#${repeatedId} #${repeatedId}\` to \`#${repeatedId}\`.`,
+          });
+        }
+      });
+    }
+    return findings;
+  },
+
   // invalid_inline_script_syntax (malformed close tag)
   ({ source }) => {
     if (!INVALID_SCRIPT_CLOSE_PATTERN.test(source)) return [];
diff --git a/packages/lint/src/rules/fonts.test.ts b/packages/lint/src/rules/fonts.test.ts
index eb90f7ba80..8facee61c9 100644
--- a/packages/lint/src/rules/fonts.test.ts
+++ b/packages/lint/src/rules/fonts.test.ts
@@ -262,6 +262,34 @@ describe("font rules", () => {
       expect(result.errorCount).toBe(0);
     });
 
+    it("accepts a URL-style plus alias used literally as the CSS family", async () => {
+      const html = `<div data-composition-id="test" data-width="1920" data-height="1080">
+        <style>
+          @import url("https://fonts.googleapis.com/css2?family=DM+Mono&family=IBM+Plex+Mono&display=swap");
+          h1 { font-family: 'DM+Mono', monospace; }
+          code { font-family: 'IBM+Plex+Mono', monospace; }
+        </style>
+      </div>`;
+      const result = await lintHyperframeHtml(html, { isSubComposition: true });
+      expect(
+        result.findings.filter((f) => f.code === "font_family_without_font_face"),
+      ).toHaveLength(0);
+      expect(result.errorCount).toBe(0);
+    });
+
+    it("does not decode percent escapes in a literal CSS family", async () => {
+      const html = `<div data-composition-id="test" data-width="1920" data-height="1080">
+        <style>
+          @import url("https://fonts.googleapis.com/css2?family=DM+Mono&display=swap");
+          h1 { font-family: 'DM%20Mono', monospace; }
+        </style>
+      </div>`;
+      const result = await lintHyperframeHtml(html, { isSubComposition: true });
+      expect(
+        result.findings.filter((f) => f.code === "font_family_without_font_face"),
+      ).toHaveLength(1);
+    });
+
     it("still flags non-bundled families not covered by the Google Fonts URL", async () => {
       const html = `<div data-composition-id="test" data-width="1920" data-height="1080">
         <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter">
diff --git a/packages/lint/src/rules/fonts.ts b/packages/lint/src/rules/fonts.ts
index 42eefb00f0..cba97865f2 100644
--- a/packages/lint/src/rules/fonts.ts
+++ b/packages/lint/src/rules/fonts.ts
@@ -220,7 +220,10 @@ export const fontRules: Array<(ctx: LintContext) => HyperframeLintFinding[]> = [
     const googleFonts = collectGoogleFontFamilies(source, styles);
 
     const undeclared = used.filter(
-      (name) => !declared.has(name) && !FONT_ALIAS_KEYS.has(name) && !googleFonts.has(name),
+      (name) =>
+        !declared.has(name) &&
+        !FONT_ALIAS_KEYS.has(name) &&
+        !googleFonts.has(name.replace(/\+/g, " ")),
     );
     if (undeclared.length === 0) return findings;
 
diff --git a/packages/lint/src/rules/gsap.test.ts b/packages/lint/src/rules/gsap.test.ts
index 2365a60d32..5c980ee716 100644
--- a/packages/lint/src/rules/gsap.test.ts
+++ b/packages/lint/src/rules/gsap.test.ts
@@ -1011,6 +1011,300 @@ describe("GSAP rules", () => {
     expect(finding).toBeDefined();
   });
 
+  it("reports motionPath usage without MotionPathPlugin", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
+  <script>
+    window.__timelines = window.__timelines || {};
+    const tl = gsap.timeline({ paused: true });
+    tl.to("#dot", { motionPath: { path: "#route" }, duration: 1 }, 0);
+    window.__timelines["main"] = tl;
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    const finding = result.findings.find((f) => f.code === "missing_gsap_plugin");
+    expect(finding?.severity).toBe("error");
+    expect(finding?.message).toContain("MotionPathPlugin");
+  });
+
+  it("reports standalone gsap.to motionPath usage without MotionPathPlugin", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
+  <script>gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("reports ESM motionPath usage without importing MotionPathPlugin", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script type="module">
+    import { gsap } from "https://cdn.jsdelivr.net/npm/gsap@3/index.js";
+    const tl = gsap.timeline({ paused: true });
+    tl.to("#dot", { motionPath: { path: "#route" }, duration: 1 }, 0);
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("accepts motionPath usage when MotionPathPlugin is loaded", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/MotionPathPlugin.min.js"></script>
+  <script>
+    gsap.registerPlugin(MotionPathPlugin);
+    window.__timelines = window.__timelines || {};
+    const tl = gsap.timeline({ paused: true });
+    tl.to("#dot", { motionPath: { path: "#route" }, duration: 1 }, 0);
+    window.__timelines["main"] = tl;
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("reports MotionPathPlugin loaded after the animation script", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
+  <script>gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });</script>
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/MotionPathPlugin.min.js"></script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it.each(["defer", "async", 'type="module"'])(
+    "does not treat an earlier non-blocking %s plugin script as available to classic code",
+    async (attribute) => {
+      const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script ${attribute} src="https://cdn.jsdelivr.net/npm/gsap@3/dist/MotionPathPlugin.min.js"></script>
+  <script>gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });</script>
+</body></html>`;
+      const result = await lintHyperframeHtml(html);
+      expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+    },
+  );
+
+  it("treats defer on an inline classic tween as blocking", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/MotionPathPlugin.min.js"></script>
+  <script defer>gsap.to("#dot", { motionPath: { path: "#route" } });</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("accepts a deferred classic plugin before a non-async module tween", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/MotionPathPlugin.min.js"></script>
+  <script type="module">gsap.to("#dot", { motionPath: { path: "#route" } });</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("ignores async and defer text inside quoted attribute values", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script data-note="foo async defer" src="https://cdn.jsdelivr.net/npm/gsap@3/dist/MotionPathPlugin.min.js"></script>
+  <script>gsap.to("#dot", { motionPath: { path: "#route" } });</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("recognizes valid unquoted module attributes", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script type=module src=https://cdn.jsdelivr.net/npm/gsap@3/dist/MotionPathPlugin.min.js></script>
+  <script>gsap.to("#dot", { motionPath: { path: "#route" } });</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("treats async on an inline classic plugin definition as blocking", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script async>const MotionPathPlugin = {};</script>
+  <script>gsap.to("#dot", { motionPath: { path: "#route" } });</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("does not accept plugin-like substrings in import specifiers", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script type="module">
+    import kit from "./AutoMotionPathPluginKit.js";
+    gsap.to("#dot", { motionPath: { path: "#route" } });
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("accepts a static plugin import in the same async module as the tween", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script async type="module">
+    import { gsap, MotionPathPlugin } from "gsap/all";
+    gsap.registerPlugin(MotionPathPlugin);
+    gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("reports an inline plugin definition that occurs after the tween", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script>
+    gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });
+    const MotionPathPlugin = {};
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("does not treat a long comment-only MotionPathPlugin mention as a loaded bundle", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script>${" ".repeat(5100)}// TODO load MotionPathPlugin</script>
+  <script>gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("does not treat a MotionPathPlugin string literal as a loaded bundle", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script>const docs = "MotionPathPlugin";</script>
+  <script>gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("still reports motionPath when code registers an unloaded plugin global", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
+  <script>
+    gsap.registerPlugin(MotionPathPlugin);
+    const tl = gsap.timeline({ paused: true });
+    tl.to("#dot", { motionPath: { path: "#route" }, duration: 1 }, 0);
+    window.__timelines = { main: tl };
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeDefined();
+  });
+
+  it("does not treat an unrelated motionPath object as GSAP plugin usage", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script>
+    const mapOptions = { motionPath: { path: "#route" } };
+    console.log("motionPath: disabled", mapOptions);
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("allows sub-compositions to inherit MotionPathPlugin from their host", async () => {
+    const html = `
+<template>
+  <div data-composition-id="scene" data-width="1920" data-height="1080">
+    <script>
+      const tl = gsap.timeline({ paused: true });
+      tl.to("#dot", { motionPath: { path: "#route" }, duration: 1 }, 0);
+      window.__timelines = { scene: tl };
+    </script>
+  </div>
+</template>`;
+    const result = await lintHyperframeHtml(html, { isSubComposition: true });
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("accepts an inline ESM import of MotionPathPlugin", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script type="module">
+    import { gsap } from "https://cdn.jsdelivr.net/npm/gsap@3/index.js";
+    import { MotionPathPlugin } from "https://cdn.jsdelivr.net/npm/gsap@3/MotionPathPlugin.js";
+    gsap.registerPlugin(MotionPathPlugin);
+    const tl = gsap.timeline({ paused: true });
+    tl.to("#dot", { motionPath: { path: "#route" }, duration: 1 }, 0);
+    window.__timelines = { main: tl };
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("accepts a default-aliased ESM import sourced from MotionPathPlugin", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script type="module">
+    import { gsap } from "https://cdn.jsdelivr.net/npm/gsap@3/index.js";
+    import MP from "https://cdn.jsdelivr.net/npm/gsap@3/MotionPathPlugin.js";
+    gsap.registerPlugin(MP);
+    gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
+  it("accepts a named MotionPathPlugin import from a barrel module", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080"></div>
+  <script type="module">
+    import { gsap, MotionPathPlugin as MP } from "./vendor";
+    gsap.registerPlugin(MP);
+    gsap.to("#dot", { motionPath: { path: "#route" }, duration: 1 });
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "missing_gsap_plugin")).toBeUndefined();
+  });
+
   it("does NOT report overlapping_gsap_tweens for distinct unresolved-target tweens", async () => {
     // Each tween targets a DIFFERENT element via a target the parser cannot resolve
     // statically (a helper call). Both collapse to the `__unresolved__` sentinel, but
diff --git a/packages/lint/src/rules/gsap.ts b/packages/lint/src/rules/gsap.ts
index a014ed7249..8b2f113ec6 100644
--- a/packages/lint/src/rules/gsap.ts
+++ b/packages/lint/src/rules/gsap.ts
@@ -26,6 +26,11 @@ async function loadParseGsapScript(): Promise<(script: string) => LintParsedGsap
   const mod = await import("@hyperframes/parsers/gsap-parser-acorn");
   return mod.parseGsapScriptAcorn as unknown as (script: string) => LintParsedGsap;
 }
+
+async function loadGsapScriptMotionPathFirstUseIndex(): Promise<(script: string) => number | null> {
+  const mod = await import("@hyperframes/parsers/gsap-parser-acorn");
+  return mod.gsapScriptMotionPathFirstUseIndex;
+}
 import type { LintContext } from "../context";
 import type { HyperframeLintFinding, LintRule } from "../types";
 import type { OpenTag } from "../utils";
@@ -1420,6 +1425,85 @@ export const gsapRules: LintRule<LintContext>[] = [
     ];
   },
 
+  // missing_gsap_plugin
+  async ({ scripts, rawSource, options }) => {
+    const canInheritPluginFromHost =
+      options.isSubComposition || rawSource.trimStart().toLowerCase().startsWith("<template");
+    if (canInheritPluginFromHost) return [];
+
+    const gsapScriptMotionPathFirstUseIndex = await loadGsapScriptMotionPathFirstUseIndex();
+    const motionPathUseIndices = scripts.map((script) =>
+      gsapScriptMotionPathFirstUseIndex(script.content),
+    );
+    const firstMotionPathScriptIndex = motionPathUseIndices.findIndex((index) => index !== null);
+    const firstMotionPathUseIndex = motionPathUseIndices[firstMotionPathScriptIndex] ?? null;
+    const firstUseScript = scripts[firstMotionPathScriptIndex];
+    const executionMode = (attrs: string): "blocking" | "defer" | "module" | "async" => {
+      const tag = `<script ${attrs}>`;
+      const isModule = (readDecodedAttr(tag, "type") ?? "").toLowerCase() === "module";
+      const hasSrc = readDecodedAttr(tag, "src") !== null;
+      const hasAsync = readDecodedAttr(tag, "async") !== null;
+      const hasDefer = readDecodedAttr(tag, "defer") !== null;
+      if ((isModule || hasSrc) && hasAsync) return "async";
+      if (isModule) return "module";
+      if (hasSrc && hasDefer) return "defer";
+      return "blocking";
+    };
+    const firstUseMode = firstUseScript ? executionMode(firstUseScript.attrs) : "blocking";
+    const hasMotionPathPlugin = scripts
+      .slice(0, firstMotionPathScriptIndex + 1)
+      .some((script, candidateIndex) => {
+        const candidateMode = executionMode(script.attrs);
+        const sameScript = candidateIndex === firstMotionPathScriptIndex;
+        const candidateIsPostParse = candidateMode === "defer" || candidateMode === "module";
+        const firstUseIsPostParse = firstUseMode === "defer" || firstUseMode === "module";
+        const executesBeforeFirstUse =
+          sameScript ||
+          candidateMode === "blocking" ||
+          (candidateIsPostParse && firstUseIsPostParse);
+        if (!executesBeforeFirstUse || (!sameScript && candidateMode === "async")) return false;
+        const src = readAttr(`<script ${script.attrs}>`, "src") ?? "";
+        const uncommented = stripJsComments(script.content);
+        const hasStaticImport =
+          /\bimport\s+(?:[\s\S]*?\sfrom\s*)?["'][^"']*\bMotionPathPlugin\b[^"']*["']/.test(
+            uncommented,
+          ) ||
+          /\bimport\s+(?:[\w$]+\s*,\s*)?\{[^}]*\bMotionPathPlugin\b[^}]*\}\s+from\s*["'][^"']+["']/.test(
+            uncommented,
+          ) ||
+          /\bimport\s+MotionPathPlugin\s+from\s*["'][^"']+["']/.test(uncommented);
+        const inlinedMarkerIndex = script.content.search(/\/\*\s*inlined:.*MotionPathPlugin/i);
+        const definitionIndex = uncommented.search(
+          /\b(?:const|let|var|class|function)\s+MotionPathPlugin\b/,
+        );
+        if (sameScript) {
+          if (hasStaticImport) return true;
+          if (firstMotionPathUseIndex === null) return false;
+          return (
+            (inlinedMarkerIndex >= 0 && inlinedMarkerIndex < firstMotionPathUseIndex) ||
+            (definitionIndex >= 0 && definitionIndex < firstMotionPathUseIndex)
+          );
+        }
+        return (
+          /MotionPathPlugin/i.test(src) ||
+          hasStaticImport ||
+          inlinedMarkerIndex >= 0 ||
+          definitionIndex >= 0
+        );
+      });
+    if (firstMotionPathScriptIndex < 0 || hasMotionPathPlugin) return [];
+    return [
+      {
+        code: "missing_gsap_plugin",
+        severity: "error",
+        message:
+          "A GSAP tween uses motionPath, but MotionPathPlugin is not loaded. Core GSAP ignores this plugin-specific property, so the intended motion will not render.",
+        fixHint:
+          "Load MotionPathPlugin before the animation script and register it with gsap.registerPlugin(MotionPathPlugin), or replace motionPath with core GSAP x/y tweens.",
+      },
+    ];
+  },
+
   // audio_reactive_single_tween_per_group
   // fallow-ignore-next-line complexity
   ({ scripts, styles }) => {
diff --git a/packages/parsers/src/gsapParserAcorn.full.test.ts b/packages/parsers/src/gsapParserAcorn.full.test.ts
index eca4213a05..8de531af3f 100644
--- a/packages/parsers/src/gsapParserAcorn.full.test.ts
+++ b/packages/parsers/src/gsapParserAcorn.full.test.ts
@@ -12,7 +12,7 @@
  * commit adds the acorn motionPath parser itself.
  */
 import { describe, it, expect } from "vitest";
-import { parseGsapScriptAcorn } from "./gsapParserAcorn.js";
+import { gsapScriptUsesMotionPath, parseGsapScriptAcorn } from "./gsapParserAcorn.js";
 import { serializeGsapAnimations } from "./gsapSerialize.js";
 import type { GsapAnimation, GsapPercentageKeyframe } from "./gsapSerialize.js";
 import { classifyPropertyGroup, classifyTweenPropertyGroup } from "./gsapConstants.js";
@@ -936,6 +936,69 @@ describe("native GSAP keyframes parsing", () => {
 // ── motionPath parsing ────────────────────────────────────────────────────────
 
 describe("motionPath parsing", () => {
+  it("detects standalone and ESM MotionPathPlugin tween properties", () => {
+    expect(gsapScriptUsesMotionPath('gsap.to("#dot", { motionPath: { path: "#route" } });')).toBe(
+      true,
+    );
+    expect(
+      gsapScriptUsesMotionPath(`
+        import { gsap } from "gsap";
+        const tl = gsap.timeline();
+        tl.to("#dot", { motionPath: { path: "#route" } });
+      `),
+    ).toBe(true);
+    expect(
+      gsapScriptUsesMotionPath('gsap.timeline().to("#dot", { motionPath: { path: "#route" } });'),
+    ).toBe(true);
+    expect(
+      gsapScriptUsesMotionPath('gsap.to("#dot", { x: 10 }).to("#dot", { motionPath: {} });'),
+    ).toBe(true);
+    expect(
+      gsapScriptUsesMotionPath(`
+        const vars = { x: 100 };
+        function build() {
+          const vars = { motionPath: { path: "#route" } };
+          return vars;
+        }
+        gsap.to("#dot", vars);
+      `),
+    ).toBe(false);
+    expect(
+      gsapScriptUsesMotionPath(`
+        function buildTimeline() {
+          const tl = gsap.timeline();
+          return tl;
+        }
+        function unrelated() {
+          const tl = { to() {} };
+          tl.to("#dot", { motionPath: { path: "#route" } });
+        }
+      `),
+    ).toBe(false);
+    expect(
+      gsapScriptUsesMotionPath(`
+        const intro = gsap.timeline();
+        const outro = gsap.timeline();
+        const fromVars = { motionPath: { path: "#route" } };
+        outro.to("#other", { opacity: 0 }).fromTo("#dot", fromVars, { opacity: 1 });
+      `),
+    ).toBe(true);
+    expect(gsapScriptUsesMotionPath('const config = { motionPath: { path: "#route" } };')).toBe(
+      false,
+    );
+  });
+
+  it("parses ESM plugin-native selector paths even when they cannot become editable arc data", () => {
+    const result = parseGsapScriptAcorn(`
+      import { gsap } from "gsap";
+      const tl = gsap.timeline({ paused: true });
+      tl.to("#dot", { motionPath: { path: "#route" }, duration: 1 }, 0);
+    `);
+
+    expect(result.animations).toHaveLength(1);
+    expect(result.animations[0]?.arcPath).toBeUndefined();
+  });
+
   it("parses motionPath with waypoint array and curviness", () => {
     const script = `
       const tl = gsap.timeline({ paused: true });
diff --git a/packages/parsers/src/gsapParserAcorn.ts b/packages/parsers/src/gsapParserAcorn.ts
index 5e9b472bc3..b8e61c2a24 100644
--- a/packages/parsers/src/gsapParserAcorn.ts
+++ b/packages/parsers/src/gsapParserAcorn.ts
@@ -45,6 +45,22 @@ const SCOPE_NODE_TYPES = new Set([
   "ArrowFunctionExpression",
 ]);
 
+function parseProgram(script: string): any {
+  try {
+    return acorn.parse(script, {
+      ecmaVersion: "latest",
+      sourceType: "script",
+      locations: true,
+    });
+  } catch {
+    return acorn.parse(script, {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      locations: true,
+    });
+  }
+}
+
 // ── Types ────────────────────────────────────────────────────────────────────
 
 type ScopeBindings = ReadonlyMap<string, number | string | boolean>;
@@ -1850,11 +1866,7 @@ export function parseGsapScriptAcornForWrite(script: string): ParsedGsapAcornFor
  */
 export function parseGsapScriptAcorn(script: string): ParsedGsap {
   try {
-    const ast = acorn.parse(script, {
-      ecmaVersion: "latest",
-      sourceType: "script",
-      locations: true,
-    });
+    const ast = parseProgram(script);
     const scope = collectScopeBindings(ast);
     const detection = findTimelineVar(ast, scope);
     const ref: TimelineRef = detection.ref ?? { kind: "identifier", name: "tl" };
@@ -1921,6 +1933,87 @@ export function parseGsapScriptAcorn(script: string): ParsedGsap {
   }
 }
 
+/** Source offset of the first timeline or standalone GSAP MotionPathPlugin tween. */
+export function gsapScriptMotionPathFirstUseIndex(script: string): number | null {
+  try {
+    const ast = parseProgram(script);
+    const scope = collectScopeBindings(ast);
+    const identifierBindings = collectIdentifierBindingIndex(ast);
+    const timelineRef = findTimelineVar(ast, scope).ref;
+    const timelineDeclarations = new Set<any>();
+    let firstUseIndex: number | null = null;
+
+    acornWalk.ancestor(ast, {
+      VariableDeclarator(node: any) {
+        if (node.id?.type === "Identifier" && isGsapTimelineCall(node.init)) {
+          timelineDeclarations.add(node);
+        }
+      },
+      AssignmentExpression(node: any, _: unknown, ancestors: any[]) {
+        if (node.left?.type === "Identifier" && isGsapTimelineCall(node.right)) {
+          const declaration = findVisibleIdentifierDeclaration(
+            node.left.name,
+            ancestors,
+            identifierBindings,
+            node.start,
+          );
+          if (declaration) timelineDeclarations.add(declaration.node);
+        }
+      },
+    } as any);
+
+    acornWalk.ancestor(ast, {
+      CallExpression(node: any, _: unknown, ancestors: any[]) {
+        const callee = node.callee;
+        const method = callee?.property?.name;
+        if (callee?.type !== "MemberExpression" || !GSAP_METHODS.has(method)) return;
+        let rootObject = callee.object;
+        while (rootObject?.type === "CallExpression") rootObject = rootObject.callee?.object;
+        const isGsapRooted = rootObject?.type === "Identifier" && rootObject.name === "gsap";
+        const visibleTimelineDeclaration =
+          rootObject?.type === "Identifier"
+            ? findVisibleIdentifierDeclaration(
+                rootObject.name,
+                ancestors,
+                identifierBindings,
+                node.start,
+              )
+            : undefined;
+        const isTimelineTween =
+          (timelineRef?.kind === "member" ? isTimelineRootedCall(node, timelineRef) : false) ||
+          (!!visibleTimelineDeclaration &&
+            timelineDeclarations.has(visibleTimelineDeclaration.node));
+        if (!isGsapRooted && !isTimelineTween) return;
+        const varsArgs =
+          method === "fromTo" ? [node.arguments?.[1], node.arguments?.[2]] : [node.arguments?.[1]];
+        if (
+          varsArgs.some((varsArg) => {
+            if (findPropertyNode(varsArg, "motionPath")) return true;
+            if (varsArg?.type !== "Identifier") return false;
+            const declaration = findVisibleIdentifierDeclaration(
+              varsArg.name,
+              ancestors,
+              identifierBindings,
+              node.start,
+            );
+            return !!findPropertyNode(declaration?.node.init, "motionPath");
+          })
+        )
+          firstUseIndex = firstUseIndex === null ? node.start : Math.min(firstUseIndex, node.start);
+      },
+    } as any);
+
+    return firstUseIndex;
+  } catch {
+    return null;
+  }
+}
+
+/** True when a timeline or standalone GSAP tween authors a MotionPathPlugin property. */
+export function gsapScriptUsesMotionPath(script: string): boolean {
+  return gsapScriptMotionPathFirstUseIndex(script) !== null;
+}
+
 // ── Label extraction (WS-C) ──────────────────────────────────────────────────
 
 export interface GsapLabelEntry {

From 222aec45ab0553c014dddccd563e273affd9b71a Mon Sep 17 00:00:00 2001
From: Xuanru Li <157947275+xuanruli@users.noreply.github.com>
Date: Thu, 23 Jul 2026 01:44:46 -0700
Subject: [PATCH 021/125] feat(lint): add rotation_pivot_drift layout check
 (#2741)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## What
New cross-sample layout check `rotation_pivot_drift` — flags a rotating element that should spin **in place** but pivots about the **wrong point** (e.g. a wheel whose spokes use a hardcoded px `transformOrigin` instead of `svgOrigin`/`%`, so they swing off-center while every existing check still passes).

Motivating prod case: a portrait ad's spoked-wheel whose `#spokes` rotated about `transformOrigin:"250px 250px"` in a resized 460px container — spokes detached from the hub, shipped clean because no rule inspects rotation.

## How
- `layout-audit.browser.js`: `window.__hyperframesRotationSample()` reports each visible transformed element's bbox center + decoded rotation angle per layout sample. Skips `[data-layout-allow-orbit]`.
- `checkPipeline.ts`: accumulates samples across the seek grid; `detectRotationPivotDrift()` (modeled on `detectSweepStatic`) flags an element that (a) actually spins (angle spread > 20° over ≥3 samples), (b) is size-stable (bbox width ratio ≤ 1.6), and (c) whose bbox **center** drifts > `max(10% of its size, 2% of min viewport dim)`. Emits `warning`; not persistence-tiered (not demoted to info).

## FP guards
Real rotation required, ≥3 samples, size stability, `data-layout-allow-orbit` exemption, min area ~2500px². Center-drift (not bbox size) is the discriminator, so a correctly-centered spinner reads drift ≈ 0.

## Validation (`check --json`)
| Fixture | Expected | Result |
|---|---|---|
| off-transformOrigin spoked wheel | fire | **fired — 109px drift on `#spokes`** |
| non-spinning comps (node diagram, device tree) | clean | clean, no FP |
| correctly-centered spinner (`svgOrigin`) | clean | clean (spins 162°, drift 0) |
| `data-layout-allow-orbit` off-origin spinner | clean | clean (exempt) |
| off-`svgOrigin` control, no opt-out | fire | fired — 251px drift |

No false positives. `tsc --noEmit` clean, `oxlint` clean, `check.test.ts` + `layout-audit.browser.test.ts` = 112/112 pass.

## Note
`ROTATION_MAX_SIZE_RATIO` is 1.6 (not 1.3): a rotating anisotropic shape's axis-aligned bbox inherently oscillates (8-spoke star ~1.32×, square 1.41×), so a tighter ratio rejects legitimate targets. Center-drift stays the real discriminator; thin swinging bars are excluded.

Follow-up: a `detectRotationPivotDrift` unit test via the fake driver's `collectRotationSample` (mirroring the sweep_static tests).

🤖 Generated with [Claude Code](https://claude.com/claude-code)
---
 packages/cli/src/commands/check.test.ts       |   1 +
 .../cli/src/commands/layout-audit.browser.js  |  51 +++++
 packages/cli/src/utils/checkBrowser.ts        |  27 +++
 .../checkPipeline.rotationPivotDrift.test.ts  | 137 +++++++++++++
 packages/cli/src/utils/checkPipeline.ts       | 191 +++++++++++++++++-
 packages/cli/src/utils/checkTypes.ts          |  16 ++
 packages/cli/src/utils/layoutAudit.ts         |   3 +
 7 files changed, 425 insertions(+), 1 deletion(-)
 create mode 100644 packages/cli/src/utils/checkPipeline.rotationPivotDrift.test.ts

diff --git a/packages/cli/src/commands/check.test.ts b/packages/cli/src/commands/check.test.ts
index 3255841699..09b214aa34 100644
--- a/packages/cli/src/commands/check.test.ts
+++ b/packages/cli/src/commands/check.test.ts
@@ -149,6 +149,7 @@ function fakeDriver(overrides: Partial<CheckAuditDriver> = {}): CheckAuditDriver
     seek: vi.fn(async (_time: number) => undefined),
     collectLayout: vi.fn(async (_time: number, _tolerance: number) => []),
     collectLayoutGeometry: vi.fn(async () => `geometry-${geometryCallCount++}`),
+    collectRotationSample: vi.fn(async (_time: number) => []),
     collectGeometryCandidates: vi.fn(async () => []),
     collectMotionFrame: vi.fn(async (time: number) => ({ time, data: {}, liveness: {} })),
     anchorMotionIssues: vi.fn(async (issues: LayoutIssue[]) =>
diff --git a/packages/cli/src/commands/layout-audit.browser.js b/packages/cli/src/commands/layout-audit.browser.js
index 4eb5184d92..78b9dd8da8 100644
--- a/packages/cli/src/commands/layout-audit.browser.js
+++ b/packages/cli/src/commands/layout-audit.browser.js
@@ -1480,4 +1480,55 @@
     }
     return parts.join("|");
   };
+
+  // Rotation-pivot sampling (rotation_pivot_drift). Per sample, report every
+  // rotatable candidate's bbox center, size, and current rotation angle. Node
+  // accumulates these across the seek grid and, after the run, flags any
+  // element that spins (angle varies) while its bbox CENTER drifts — the
+  // signature of a wrong transformOrigin/svgOrigin (spokes swinging off-axis
+  // instead of spinning in place). Single frame can't tell spin from pivot
+  // drift, so this is a cross-sample finder, not a per-sample one.
+  function rotationAngleDeg(transform) {
+    if (!transform || transform === "none") return null;
+    const match = transform.match(/matrix(3d)?\(([^)]+)\)/);
+    if (!match) return null;
+    const values = match[2].split(",").map((part) => Number.parseFloat(part));
+    // matrix(a,b,c,d,e,f) → a=values[0], b=values[1]. matrix3d shares the same
+    // leading two entries for the in-plane 2D rotation component.
+    const a = values[0];
+    const b = values[1];
+    if (!Number.isFinite(a) || !Number.isFinite(b)) return null;
+    return (Math.atan2(b, a) * 180) / Math.PI;
+  }
+
+  window.__hyperframesRotationSample = function collectRotationSample() {
+    const root =
+      document.querySelector("[data-composition-id][data-width][data-height]") ||
+      document.querySelector("[data-composition-id]") ||
+      document.body;
+    const samples = [];
+    // Cap the candidate set so a pathological composition can't blow up the
+    // per-sample payload; transformed elements above a minimum area only.
+    const CANDIDATE_CAP = 200;
+    for (const element of Array.from(root.querySelectorAll("*"))) {
+      if (samples.length >= CANDIDATE_CAP) break;
+      // Intended orbits/satellites opt out — their bbox center is SUPPOSED to
+      // travel, so a drift finding there is a false positive.
+      if (element.closest("[data-layout-allow-orbit]")) continue;
+      if (!isVisibleElement(element, 0.05)) continue;
+      const angle = rotationAngleDeg(getComputedStyle(element).transform);
+      if (angle === null) continue; // identity / untransformed — not a candidate
+      const box = element.getBoundingClientRect();
+      if (box.width * box.height <= 400) continue;
+      samples.push({
+        selector: selectorFor(element),
+        cx: round(box.left + box.width / 2),
+        cy: round(box.top + box.height / 2),
+        w: round(box.width),
+        h: round(box.height),
+        angle: round(angle),
+      });
+    }
+    return samples;
+  };
 })();
diff --git a/packages/cli/src/utils/checkBrowser.ts b/packages/cli/src/utils/checkBrowser.ts
index 427719e239..2da9fc1918 100644
--- a/packages/cli/src/utils/checkBrowser.ts
+++ b/packages/cli/src/utils/checkBrowser.ts
@@ -42,6 +42,7 @@ import type {
   ContrastCapture,
   GeometryCandidateRequest,
   MotionSpecResolution,
+  RotationSample,
   RunAuditGrid,
 } from "./checkTypes.js";
 import type { ProjectDir } from "./project.js";
@@ -347,6 +348,7 @@ function createPageDriver(page: Page, setTime: (time: number) => void): CheckAud
     },
     collectLayout: (time, tolerance) => collectLayout(page, time, tolerance),
     collectLayoutGeometry: () => collectLayoutGeometry(page),
+    collectRotationSample: (time) => collectRotationSample(page, time),
     collectGeometryCandidates: (time, request) => collectGeometryCandidates(page, time, request),
     collectMotionFrame: (time, selectors, scopes) =>
       collectMotionFrame(page, time, selectors, scopes),
@@ -468,6 +470,30 @@ async function collectLayoutGeometry(page: Page): Promise<string> {
   });
 }
 
+async function collectRotationSample(page: Page, time: number): Promise<RotationSample[]> {
+  const raw = await page.evaluate(() => {
+    const sample = Reflect.get(window, "__hyperframesRotationSample");
+    if (typeof sample !== "function") return [];
+    const result = Reflect.apply(sample, window, []);
+    return Array.isArray(result) ? result : [];
+  });
+  return raw.flatMap((value) => parseRotationSample(value, time));
+}
+
+function parseRotationSample(value: unknown, time: number): RotationSample[] {
+  if (!isRecord(value)) return [];
+  const selector = stringValue(value, "selector");
+  const cx = numberValue(value, "cx");
+  const cy = numberValue(value, "cy");
+  const w = numberValue(value, "w");
+  const h = numberValue(value, "h");
+  const angle = numberValue(value, "angle");
+  if (!selector || cx === null || cy === null || w === null || h === null || angle === null) {
+    return [];
+  }
+  return [{ time, selector, cx, cy, w, h, angle }];
+}
+
 async function collectGeometryCandidates(
   page: Page,
   time: number,
@@ -1051,6 +1077,7 @@ const LAYOUT_ISSUE_CODES: readonly LayoutIssueCode[] = [
   "escaped_container",
   "panel_out_of_canvas",
   "connector_detached",
+  "rotation_pivot_drift",
   "motion_appears_late",
   "motion_out_of_order",
   "motion_off_frame",
diff --git a/packages/cli/src/utils/checkPipeline.rotationPivotDrift.test.ts b/packages/cli/src/utils/checkPipeline.rotationPivotDrift.test.ts
new file mode 100644
index 0000000000..c81ba268bb
--- /dev/null
+++ b/packages/cli/src/utils/checkPipeline.rotationPivotDrift.test.ts
@@ -0,0 +1,137 @@
+import { describe, expect, it } from "vitest";
+
+import { detectRotationPivotDrift } from "./checkPipeline.js";
+import type { RotationSample } from "./checkTypes.js";
+
+const CANVAS = { width: 1000, height: 1000 };
+
+/** One rotation sample; defaults describe a large, size-stable element. */
+function sample(overrides: Partial<RotationSample> = {}): RotationSample {
+  return { time: 0, selector: "#spokes", cx: 250, cy: 250, w: 200, h: 200, angle: 0, ...overrides };
+}
+
+/** A group that SHOULD fire: spins (0→90→180), size-stable, sizable, and its
+ * bbox center travels 50px — the wrong-pivot signature. threshold here is
+ * max(0.1*200, 0.02*1000) = 20px, so 50px drift clears it. */
+function driftingSpinner(): RotationSample[] {
+  return [
+    sample({ time: 0, angle: 0, cx: 250, cy: 250 }),
+    sample({ time: 1, angle: 90, cx: 250, cy: 280 }),
+    sample({ time: 2, angle: 180, cx: 250, cy: 300 }),
+  ];
+}
+
+describe("detectRotationPivotDrift", () => {
+  it("fires on a spinning, size-stable element whose bbox center drifts past threshold", () => {
+    const findings = detectRotationPivotDrift(driftingSpinner(), CANVAS);
+    expect(findings).toHaveLength(1);
+    const [f] = findings;
+    expect(f?.code).toBe("rotation_pivot_drift");
+    expect(f?.severity).toBe("warning");
+    expect(f?.selector).toBe("#spokes");
+    expect(f?.message).toContain("50px");
+    expect(f?.fixHint).toContain("transformOrigin");
+  });
+
+  // Stage 1 — sample count.
+  it("does not fire with fewer than the minimum samples", () => {
+    const group = driftingSpinner().slice(0, 2);
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(0);
+  });
+
+  // Stage 2 — real spin. A translating-but-not-spinning element is not our bug.
+  it("does not fire when the element barely rotates (fixed tilt, not spinning)", () => {
+    const group = [
+      sample({ time: 0, angle: 0, cx: 250, cy: 250 }),
+      sample({ time: 1, angle: 2, cx: 250, cy: 280 }),
+      sample({ time: 2, angle: 4, cx: 250, cy: 300 }),
+    ];
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(0);
+  });
+
+  // Stage 3 — size stability, WIDTH axis (scale/entrance, not pivot drift).
+  it("does not fire when width scales across samples", () => {
+    const group = [
+      sample({ time: 0, angle: 0, w: 100, cx: 250, cy: 250 }),
+      sample({ time: 1, angle: 90, w: 200, cx: 250, cy: 280 }),
+      sample({ time: 2, angle: 180, w: 300, cx: 250, cy: 300 }),
+    ];
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(0);
+  });
+
+  // Stage 3 — size stability, HEIGHT axis. Regression for the width-only guard:
+  // fixed width, top-anchored height growth (top=100 → cy = 100 + h/2) drifts
+  // the AABB center 50px on its own. Must NOT be reported as pivot drift.
+  it("does not fire when height scales (top-anchored) even though the AABB center moves", () => {
+    const group = [
+      sample({ time: 0, angle: 0, w: 100, h: 50, cx: 250, cy: 125 }),
+      sample({ time: 1, angle: 90, w: 100, h: 100, cx: 250, cy: 150 }),
+      sample({ time: 2, angle: 180, w: 100, h: 150, cx: 250, cy: 175 }),
+    ];
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(0);
+  });
+
+  it("does not fire when a sample has a degenerate zero dimension", () => {
+    const group = driftingSpinner().map((s, i) => (i === 0 ? { ...s, w: 0 } : s));
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(0);
+  });
+
+  // Stage 4 — sizable. Tiny decorative spinners are ignored (area < 2500px²).
+  it("does not fire on a tiny element below the median-area floor", () => {
+    const group = driftingSpinner().map((s) => ({ ...s, w: 40, h: 40 }));
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(0);
+  });
+
+  // Stage 5 — center drift. A correctly-centered spinner holds its bbox center.
+  it("does not fire on a spinner whose bbox center stays put", () => {
+    const group = [
+      sample({ time: 0, angle: 0 }),
+      sample({ time: 1, angle: 120 }),
+      sample({ time: 2, angle: 240 }),
+    ];
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(0);
+  });
+
+  it("uses the viewport floor when the element is small relative to a large canvas", () => {
+    // medianSize=200 → sizeFloor=20; viewportFloor on a 3000px canvas = 60.
+    // A 40px drift is below 60 → clean; the same group fired on CANVAS above.
+    const group = [
+      sample({ time: 0, angle: 0, cx: 250, cy: 250 }),
+      sample({ time: 1, angle: 90, cx: 250, cy: 270 }),
+      sample({ time: 2, angle: 180, cx: 250, cy: 290 }),
+    ];
+    expect(detectRotationPivotDrift(group, { width: 3000, height: 3000 })).toHaveLength(0);
+  });
+
+  it("reports each drifting selector independently and leaves clean ones alone", () => {
+    const clean = driftingSpinner().map((s) => ({ ...s, selector: "#hub", cx: 500, cy: 500 }));
+    const findings = detectRotationPivotDrift([...driftingSpinner(), ...clean], CANVAS);
+    expect(findings.map((f) => f.selector)).toEqual(["#spokes"]);
+  });
+
+  // Wrap-aware angle spread across the ±180° discontinuity. A wobble between
+  // -175° and 175° is ~10° of travel, not ~350°; naive abs-diff would misread it
+  // as a fast spin and (with a drifting center) fire falsely.
+  it("does not treat a ±180° boundary wobble as spinning", () => {
+    const group = [
+      sample({ time: 0, angle: -175, cx: 250, cy: 250 }),
+      sample({ time: 1, angle: 175, cx: 250, cy: 280 }),
+      sample({ time: 2, angle: -172, cx: 250, cy: 300 }),
+    ];
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(0);
+  });
+
+  it("still detects a real spin that crosses the ±180° boundary", () => {
+    // 170° → -100° → -10° is ~270° of genuine travel across the seam.
+    const group = [
+      sample({ time: 0, angle: 170, cx: 250, cy: 250 }),
+      sample({ time: 1, angle: -100, cx: 250, cy: 280 }),
+      sample({ time: 2, angle: -10, cx: 250, cy: 300 }),
+    ];
+    expect(detectRotationPivotDrift(group, CANVAS)).toHaveLength(1);
+  });
+
+  it("returns nothing for an empty sample set", () => {
+    expect(detectRotationPivotDrift([], CANVAS)).toHaveLength(0);
+  });
+});
diff --git a/packages/cli/src/utils/checkPipeline.ts b/packages/cli/src/utils/checkPipeline.ts
index 8148654b24..cebcf4c4a2 100644
--- a/packages/cli/src/utils/checkPipeline.ts
+++ b/packages/cli/src/utils/checkPipeline.ts
@@ -48,6 +48,7 @@ import type {
   ContrastAuditEntry,
   GeometryCandidateRequest,
   MotionSpecResolution,
+  RotationSample,
 } from "./checkTypes.js";
 
 export type {
@@ -189,6 +190,9 @@ interface GridSamples {
   contrastMs: number;
   /** One geometry+opacity fingerprint per layout sample (#U10 frozen-sweep guard). */
   geometrySignatures: string[];
+  /** Every rotatable element's geometry at each layout sample; grouped by
+   * selector after the run to detect rotation_pivot_drift. */
+  rotationSamples: RotationSample[];
 }
 
 interface GeometrySeen {
@@ -360,6 +364,7 @@ async function collectGridSamples(
     screenshots: [],
     contrastMs: 0,
     geometrySignatures: [],
+    rotationSamples: [],
   };
   for (const time of mergeSampleTimes(grid.layoutSamples, motion.times)) {
     await driver.seek(time);
@@ -372,6 +377,7 @@ async function collectGridSamples(
       collected.layoutIssues.push(...layoutIssues);
       issuesAtTime.push(...layoutIssues);
       collected.geometrySignatures.push(await driver.collectLayoutGeometry());
+      collected.rotationSamples.push(...(await driver.collectRotationSample(time)));
     }
     if (canvas) {
       const geometryIssues = await collectGeometryAt(
@@ -455,6 +461,185 @@ function detectSweepStatic(
   ];
 }
 
+// rotation_pivot_drift thresholds. A spinning element's bbox center should be
+// fixed; drift beyond this signals a wrong pivot (transformOrigin/svgOrigin).
+const ROTATION_MIN_SAMPLES = 3;
+// Degrees of angle spread that count as "actually spinning" (vs a static tilt).
+const ROTATION_MIN_ANGLE_SPREAD_DEG = 20;
+// Max bbox-width ratio across samples — above this it is scaling/entrancing,
+// not spinning in place. A rigid anisotropic shape's axis-aligned bbox
+// oscillates under rotation on its own (a plain square already swings 1.41x
+// between flat and 45deg), so this must sit above that; 1.6 admits rotating
+// squares/mild rectangles while still excluding gross scale/entrance growth
+// and thin bars/lines whose bbox swings many-fold (e.g. a rotating reference
+// arm). The bbox-CENTER drift below is the real spin-in-place discriminator.
+const ROTATION_MAX_SIZE_RATIO = 1.6;
+// Skip tiny decorative spinners; only sizable rotating figures matter.
+const ROTATION_MIN_MEDIAN_AREA_PX = 2500;
+const ROTATION_DRIFT_SIZE_FRACTION = 0.1;
+const ROTATION_DRIFT_VIEWPORT_FRACTION = 0.02;
+
+function median(values: number[]): number {
+  if (values.length === 0) return 0;
+  const sorted = [...values].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  const upper = sorted[mid] ?? 0;
+  return sorted.length % 2 === 0 ? ((sorted[mid - 1] ?? 0) + upper) / 2 : upper;
+}
+
+/** Widest angular gap between any two samples, wrap-aware (0/360 continuity). */
+function maxAngleSpread(angles: number[]): number {
+  let max = 0;
+  for (let i = 0; i < angles.length; i++) {
+    const a = angles[i];
+    if (a === undefined) continue;
+    for (let j = i + 1; j < angles.length; j++) {
+      const b = angles[j];
+      if (b === undefined) continue;
+      const raw = Math.abs(a - b) % 360;
+      max = Math.max(max, Math.min(raw, 360 - raw));
+    }
+  }
+  return max;
+}
+
+/** Largest distance between any two bbox centers across the samples. */
+function maxCenterDrift(samples: RotationSample[]): number {
+  let max = 0;
+  for (let i = 0; i < samples.length; i++) {
+    const first = samples[i];
+    if (!first) continue;
+    for (let j = i + 1; j < samples.length; j++) {
+      const second = samples[j];
+      if (!second) continue;
+      max = Math.max(max, Math.hypot(first.cx - second.cx, first.cy - second.cy));
+    }
+  }
+  return max;
+}
+
+function rotationDriftFinding(
+  samples: RotationSample[],
+  drift: number,
+): AnchoredLayoutIssue | null {
+  const last = samples[samples.length - 1];
+  if (!last) return null;
+  const rect: LayoutRect = {
+    left: last.cx - last.w / 2,
+    top: last.cy - last.h / 2,
+    right: last.cx + last.w / 2,
+    bottom: last.cy + last.h / 2,
+    width: last.w,
+    height: last.h,
+  };
+  return {
+    code: "rotation_pivot_drift",
+    // EF promotes this to error separately; keep it a warning here.
+    severity: "warning",
+    time: last.time,
+    selector: last.selector,
+    dataAttributes: {},
+    sourceFile: "index.html",
+    bbox: rectToBbox(rect),
+    rect,
+    message: `Rotating element's bounding-box center drifts ${Math.round(drift)}px across rotation — it is not spinning about its own center (check transformOrigin/svgOrigin).`,
+    fixHint:
+      "The bounding-box center should stay fixed while the element spins; check its transformOrigin/svgOrigin so rotation pivots about the element's own center rather than a point in a coordinate space it was resized out of.",
+  };
+}
+
+function groupRotationSamplesBySelector(samples: RotationSample[]): Map<string, RotationSample[]> {
+  const bySelector = new Map<string, RotationSample[]>();
+  for (const sample of samples) {
+    const group = bySelector.get(sample.selector);
+    if (group) group.push(sample);
+    else bySelector.set(sample.selector, [sample]);
+  }
+  return bySelector;
+}
+
+/** Enough samples to establish a spin trajectory (one frame can't). */
+function hasEnoughRotationSamples(group: RotationSample[]): boolean {
+  return group.length >= ROTATION_MIN_SAMPLES;
+}
+
+/** Real spin, not a fixed tilt: the rotation angle actually varies across the grid. */
+function isActuallySpinning(group: RotationSample[]): boolean {
+  return maxAngleSpread(group.map((s) => s.angle)) > ROTATION_MIN_ANGLE_SPREAD_DEG;
+}
+
+/** Rigid bbox size in BOTH dimensions. A scale/entrance animation is not pivot
+ * drift; in particular top-anchored height scaling (fixed width, growing height)
+ * moves the AABB center on its own — the earlier width-only guard let that through
+ * as a false positive. */
+function isRotationSizeStable(group: RotationSample[]): boolean {
+  const widths = group.map((s) => s.w);
+  const heights = group.map((s) => s.h);
+  const minWidth = Math.min(...widths);
+  const minHeight = Math.min(...heights);
+  if (minWidth <= 0 || minHeight <= 0) return false;
+  return (
+    Math.max(...widths) / minWidth <= ROTATION_MAX_SIZE_RATIO &&
+    Math.max(...heights) / minHeight <= ROTATION_MAX_SIZE_RATIO
+  );
+}
+
+/** Skip tiny decorative spinners; only sizable rotating figures matter. */
+function isSizableRotation(group: RotationSample[]): boolean {
+  return median(group.map((s) => s.w * s.h)) >= ROTATION_MIN_MEDIAN_AREA_PX;
+}
+
+/** The size/motion gates a selector group must clear before the (viewport-
+ * dependent) center-drift test. Each is a strict FP guard, deliberately so:
+ * a false positive feeds destructive downstream auto-fixes. */
+function isRotationDriftCandidate(group: RotationSample[]): boolean {
+  return (
+    hasEnoughRotationSamples(group) &&
+    isActuallySpinning(group) &&
+    isRotationSizeStable(group) &&
+    isSizableRotation(group)
+  );
+}
+
+/**
+ * rotation_pivot_drift: an element that visibly SPINS (its rotation angle varies
+ * across the seek grid) while its bounding-box CENTER travels is pivoting about
+ * the wrong point — the classic symptom of a transformOrigin/svgOrigin authored
+ * as hardcoded pixels against a coordinate space the element was later resized
+ * out of (e.g. spokes set to `250px 250px` inside a 460px-rendered 500-viewBox
+ * SVG). A correctly centered spinner holds its bbox center fixed.
+ *
+ * Cross-sample by necessity — one frame can't distinguish spin-in-place from
+ * pivot drift. FP guards are deliberately strict because a false positive feeds
+ * destructive downstream auto-fixes: requires real rotation, a stable bbox size
+ * in both axes (excludes scale/entrance animations), a sizable element, and
+ * honors `[data-layout-allow-orbit]` opt-outs (applied browser-side).
+ *
+ * Invariant: samples are grouped by `selector`, assumed stable across seeks.
+ * An element without a stable id/class can fall back to a `nth-of-type(N)`
+ * selector whose N shifts as siblings enter/exit — so in that fringe it may be
+ * mis-grouped (a missed detection, or in a rare exit-then-enter aliasing case a
+ * spurious one). Author-crafted rotating figures effectively always carry stable
+ * anchors; a stable-anchor gate on the browser sampler is the structural fix.
+ */
+export function detectRotationPivotDrift(
+  samples: RotationSample[],
+  canvas: Canvas,
+): AnchoredLayoutIssue[] {
+  const findings: AnchoredLayoutIssue[] = [];
+  const viewportFloor = ROTATION_DRIFT_VIEWPORT_FRACTION * Math.min(canvas.width, canvas.height);
+  for (const group of groupRotationSamplesBySelector(samples).values()) {
+    if (!isRotationDriftCandidate(group)) continue;
+    const medianSize = median(group.map((s) => Math.max(s.w, s.h)));
+    const threshold = Math.max(ROTATION_DRIFT_SIZE_FRACTION * medianSize, viewportFloor);
+    const drift = maxCenterDrift(group);
+    if (drift <= threshold) continue;
+    const finding = rotationDriftFinding(group, drift);
+    if (finding) findings.push(finding);
+  }
+  return findings;
+}
+
 /** Error-severity findings with real geometry become labeled overview boxes.
  * Contrast failures are annotated separately by the driver itself, since
  * they're only known once contrast measurement for this sample completes. */
@@ -490,6 +675,10 @@ export async function runAuditGrid(
     collected.geometrySignatures,
     motionIssues,
   );
+  const rotationFindings = detectRotationPivotDrift(
+    collected.rotationSamples,
+    await driver.getCanvas(),
+  );
   const contrast = buildContrastResults(collected.contrastEntries);
   return {
     duration: grid.duration,
@@ -497,7 +686,7 @@ export async function runAuditGrid(
     transitionSamples: grid.transitionSamples,
     transitionSamplesDropped: grid.transitionSamplesDropped,
     runtimeFindings: [],
-    layoutIssues: [...collected.layoutIssues, ...sweepFindings],
+    layoutIssues: [...collected.layoutIssues, ...sweepFindings, ...rotationFindings],
     motionIssues,
     motionSampleCount: collected.motionFrames.length,
     contrastSamples: grid.contrastSamples,
diff --git a/packages/cli/src/utils/checkTypes.ts b/packages/cli/src/utils/checkTypes.ts
index 59da4c0692..d04554d7d2 100644
--- a/packages/cli/src/utils/checkTypes.ts
+++ b/packages/cli/src/utils/checkTypes.ts
@@ -120,6 +120,19 @@ export interface CheckGeometryCandidate extends CheckAnchor {
   overflow?: LayoutOverflow;
 }
 
+/** One rotatable element's geometry at a single seeked sample, produced by
+ * `__hyperframesRotationSample` (layout-audit.browser.js) and accumulated
+ * across the grid to detect `rotation_pivot_drift`. */
+export interface RotationSample {
+  time: number;
+  selector: string;
+  cx: number;
+  cy: number;
+  w: number;
+  h: number;
+  angle: number;
+}
+
 export type MotionSpecResolution =
   | { kind: "none" }
   | { kind: "valid"; path: string; spec: MotionSpec }
@@ -137,6 +150,9 @@ export interface CheckAuditDriver {
    * fingerprint of the current seeked state, for detecting a timeline that
    * never advances under seek. See layout-audit.browser.js. */
   collectLayoutGeometry(): Promise<string>;
+  /** rotation_pivot_drift: every rotatable element's bbox center/size/angle at
+   * the current seeked state. Accumulated across the grid — see checkPipeline. */
+  collectRotationSample(time: number): Promise<RotationSample[]>;
   collectGeometryCandidates(
     time: number,
     request: GeometryCandidateRequest,
diff --git a/packages/cli/src/utils/layoutAudit.ts b/packages/cli/src/utils/layoutAudit.ts
index 493afdc7f1..e72df4f87d 100644
--- a/packages/cli/src/utils/layoutAudit.ts
+++ b/packages/cli/src/utils/layoutAudit.ts
@@ -23,6 +23,9 @@ export type LayoutIssueCode =
   | "escaped_container"
   | "panel_out_of_canvas"
   | "connector_detached"
+  // Cross-sample rotation finding — a spinning element whose bbox center drifts
+  // because it pivots about the wrong point (bad transformOrigin/svgOrigin).
+  | "rotation_pivot_drift"
   // Frozen-sweep guard (#U10) — a whole-run meta-finding, not a per-sample
   // geometry observation; never persistence-tiered (see `applyPersistenceTier`).
   | "sweep_static"

From dd7378bbd934ecc0da85c1edfae7946ac7e2271a Mon Sep 17 00:00:00 2001
From: Hblee <hblee12294@gmail.com>
Date: Thu, 23 Jul 2026 08:34:30 -0700
Subject: [PATCH 022/125] fix(sdk): keep <br> line breaks editable and
 uncorrupted in setText (#2742)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A `<br>` is a void element but `resolveSingleChildTextTarget` treated a lone
`<br>` child as the element's text target. So `getOwnText(<h1>A<br>B</h1>)`
read the `<br>`'s (empty) textContent → `text: null`, which consumers surface
as "not editable", and `setOwnText` wrote into the `<br>`, corrupting it
(serialized as invalid `</br>`).

Exclude void elements from the single-child text target; read `<br>` as "\n";
and rebuild the text/`<br>` run from the newline-separated value on write,
reusing existing `<br>` nodes so their identity (data-hf-id) survives an
in-place edit.
---
 packages/sdk/src/engine/model.ts       | 58 +++++++++++++++++++++++++-
 packages/sdk/src/engine/mutate.test.ts | 56 +++++++++++++++++++++++++
 2 files changed, 112 insertions(+), 2 deletions(-)

diff --git a/packages/sdk/src/engine/model.ts b/packages/sdk/src/engine/model.ts
index bd7313a59f..1ffdcbc80c 100644
--- a/packages/sdk/src/engine/model.ts
+++ b/packages/sdk/src/engine/model.ts
@@ -302,18 +302,55 @@ function isHTMLElementTarget(el: Element): boolean {
   return "style" in el;
 }
 
+// Void elements can't hold text, so a lone `<br>`/`<img>`/`<hr>`/… child is
+// never the element's text target. Treating one as such made getOwnText read
+// "" (→ `text: null`, surfaced as "not editable") and setOwnText write into the
+// void element, corrupting it — e.g. a `<br>` gained a text child and
+// serialized as invalid `</br>`.
+const VOID_TEXT_TARGET_TAGS = new Set([
+  "AREA",
+  "BASE",
+  "BR",
+  "COL",
+  "EMBED",
+  "HR",
+  "IMG",
+  "INPUT",
+  "LINK",
+  "META",
+  "PARAM",
+  "SOURCE",
+  "TRACK",
+  "WBR",
+]);
+
+function isBrElement(node: Node): boolean {
+  return node.nodeType === 1 && (node as Element).tagName === "BR";
+}
+
+/** A flat text leaf: no element children, or only `<br>` line breaks
+ *  (e.g. `<h1>First<br>Second</h1>`). Such an element's entire content is its
+ *  own text, so setText owns it end-to-end. Vacuously true for zero children. */
+function isTextOrBrLeaf(el: Element): boolean {
+  return Array.from(el.children).every((child) => child.tagName === "BR");
+}
+
 function resolveSingleChildTextTarget(el: Element): Element | null {
   const inner = el.children.length === 1 ? el.firstElementChild : null;
-  return inner && isHTMLElementTarget(inner) ? inner : null;
+  if (!inner || !isHTMLElementTarget(inner)) return null;
+  if (VOID_TEXT_TARGET_TAGS.has(inner.tagName)) return null;
+  return inner;
 }
 
-/** Read the text target used by SDK setText. */
+/** Read the text target used by SDK setText. `<br>` line breaks are surfaced as
+ *  "\n" so a multi-line leaf round-trips through setOwnText. */
 export function getOwnText(el: Element): string {
   const singleChild = resolveSingleChildTextTarget(el);
   if (singleChild) return singleChild.textContent ?? "";
   let text = "";
   el.childNodes.forEach((n) => {
     if (n.nodeType === 3) text += (n as Text).nodeValue ?? "";
+    else if (isBrElement(n)) text += "\n";
   });
   return text;
 }
@@ -327,6 +364,23 @@ export function setOwnText(el: Element, text: string): void {
   }
 
   const doc = el.ownerDocument;
+
+  // Flat text leaf (text and/or `<br>` only): rebuild the text/`<br>` run from
+  // the "\n"-separated value — the inverse of getOwnText. Existing `<br>` nodes
+  // are reused in order so their identity (data-hf-id, etc.) survives an edit
+  // that keeps the line, and a new one is only minted when a line is added.
+  // Never writes text into a `<br>`, so no `</br>` corruption.
+  if (isTextOrBrLeaf(el)) {
+    const spareBrs = Array.from(el.children).filter((child) => child.tagName === "BR");
+    while (el.firstChild) el.removeChild(el.firstChild);
+    const lines = text.split("\n");
+    lines.forEach((line, index) => {
+      if (index > 0) el.appendChild(spareBrs.shift() ?? doc.createElement("br"));
+      if (line) el.appendChild(doc.createTextNode(line));
+    });
+    return;
+  }
+
   const children = Array.from(el.childNodes);
   // Track original position of the first text node so we restore there, not at firstChild.
   let firstTextIdx = -1;
diff --git a/packages/sdk/src/engine/mutate.test.ts b/packages/sdk/src/engine/mutate.test.ts
index 62464bce28..6767f39aac 100644
--- a/packages/sdk/src/engine/mutate.test.ts
+++ b/packages/sdk/src/engine/mutate.test.ts
@@ -262,6 +262,62 @@ describe("setText", () => {
   it("override-set key maps correctly", () => {
     expect(pathToKey("/elements/hf-title/text")).toBe("hf-title.text");
   });
+
+  // A `<br>` line break is a void element, not the element's text target. It
+  // must not make the heading read as empty (→ non-editable) nor be corrupted
+  // by setText. See getOwnText / setOwnText in model.ts.
+  describe("<br> line-break leaves", () => {
+    const brDoc = () =>
+      parseMutable(
+        '<div data-hf-id="hf-s" data-hf-root><h1 data-hf-id="hf-br">Centrifugal<br>Force</h1></div>',
+      );
+
+    it("reads a <br>-split heading as editable text (newline-joined), not empty", () => {
+      const parsed = brDoc();
+      // The inverse patch value is the pre-edit text — proves getOwnText read
+      // the heading as "Centrifugal\nForce" rather than "" (which surfaced as
+      // `text: null` → "not editable" in the studio panel).
+      const { inverse } = applyOp(parsed, { type: "setText", target: "hf-br", value: "x" });
+      expect(inverse[0]).toMatchObject({ value: "Centrifugal\nForce" });
+    });
+
+    it("preserves the <br> when setting text (no </br> corruption)", () => {
+      const parsed = brDoc();
+      applyOp(parsed, { type: "setText", target: "hf-br", value: "Centripetal\nForce" });
+      const html = serializeDocument(parsed);
+      expect(html).toContain("Centripetal");
+      expect(html).toContain("Force");
+      expect(html).toContain("<br");
+      // The <br> must stay empty — never gains a text child.
+      const br = parsed.document.querySelector('[data-hf-id="hf-br"] br');
+      expect(br?.textContent).toBe("");
+    });
+
+    it("drops the line break when the new text has no newline", () => {
+      const parsed = brDoc();
+      applyOp(parsed, { type: "setText", target: "hf-br", value: "Centrifugal Force" });
+      const h1 = parsed.document.querySelector('[data-hf-id="hf-br"]');
+      expect(h1?.querySelector("br")).toBeNull();
+      expect(h1?.textContent).toBe("Centrifugal Force");
+    });
+
+    it("reuses the existing <br> node so an in-place edit round-trips exactly", () => {
+      const parsed = parseMutable(
+        '<div data-hf-id="hf-s" data-hf-root><h1 data-hf-id="hf-br">Centrifugal<br data-hf-id="hf-x5px">Force</h1></div>',
+      );
+      const before = serializeDocument(parsed);
+      // Same line count → the <br> (and its data-hf-id) is preserved, and undo
+      // is byte-exact.
+      const { inverse } = applyOp(parsed, {
+        type: "setText",
+        target: "hf-br",
+        value: "Angular\nMomentum",
+      });
+      expect(serializeDocument(parsed)).toContain('<br data-hf-id="hf-x5px">');
+      applyPatchesToDocument(parsed, inverse);
+      expect(serializeDocument(parsed)).toBe(before);
+    });
+  });
 });
 
 // ─── setAttribute ─────────────────────────────────────────────────────────────

From f0034228f5026ffe928db84d83c1ffabd9a1d88a Mon Sep 17 00:00:00 2001
From: James <james.russo@heygen.com>
Date: Thu, 23 Jul 2026 12:03:36 -0700
Subject: [PATCH 023/125] chore: release v0.7.69

---
 .claude-plugin/plugin.json               |  2 +-
 .codex-plugin/plugin.json                |  2 +-
 .cursor-plugin/plugin.json               |  2 +-
 docs/changelog.mdx                       | 23 +++++++++++++++++++++++
 packages/aws-lambda/package.json         |  2 +-
 packages/cli/package.json                |  2 +-
 packages/core/package.json               |  2 +-
 packages/engine/package.json             |  2 +-
 packages/gcp-cloud-run/package.json      |  2 +-
 packages/lint/package.json               |  2 +-
 packages/parsers/package.json            |  2 +-
 packages/player/package.json             |  2 +-
 packages/producer/package.json           |  2 +-
 packages/sdk/package.json                |  2 +-
 packages/shader-transitions/package.json |  2 +-
 packages/studio-server/package.json      |  2 +-
 packages/studio/package.json             |  2 +-
 releases/v0.7.69.md                      | 22 ++++++++++++++++++++++
 18 files changed, 61 insertions(+), 16 deletions(-)
 create mode 100644 releases/v0.7.69.md

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index d29f2c5c37..a8fed5e059 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index c177766287..b93a7ca41e 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index dff479a406..e86cf3ba3d 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -3,7 +3,7 @@
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com"
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index cb68e063e4..6b9c01c9fb 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -8,6 +8,29 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
 
 {/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
 
+<Update
+  label="HyperFrames v0.7.69"
+  description="Released - 2026-07-23"
+  tags={["Release", "Sdk", "Lint", "Producer"]}
+>
+HyperFrames now catches rotation pivot drift during layout audits, helping surface off-center spinners before render. This release also preserves editable \<br\> line breaks in SDK text edits, strengthens producer font, probe, and worker-memory handling, and improves preflight and pre-commit feedback.
+
+## Features
+
+- **Lint:** Add rotation_pivot_drift layout check ([222aec45a](https://github.com/heygen-com/hyperframes/commit/222aec45ab0553c014dddccd563e273affd9b71a), [#2741](https://github.com/heygen-com/hyperframes/pull/2741))
+
+## Fixes
+
+- **Sdk:** Keep \<br\> line breaks editable and uncorrupted in setText ([dd7378bbd](https://github.com/heygen-com/hyperframes/commit/dd7378bbd934ecc0da85c1edfae7946ac7e2271a), [#2742](https://github.com/heygen-com/hyperframes/pull/2742))
+- **Lint:** Address render preflight review feedback ([7a294f195](https://github.com/heygen-com/hyperframes/commit/7a294f19562928036dae20d5e73c2637d1e19060), [#2739](https://github.com/heygen-com/hyperframes/pull/2739))
+- **Producer:** Resolve residual font and probe failures ([948264d6b](https://github.com/heygen-com/hyperframes/commit/948264d6b205cadd191e04f36af332ed4a6bb233), [#2738](https://github.com/heygen-com/hyperframes/pull/2738))
+- **Hooks:** Pre-commit gate denies commit instead of ending the turn ([97ec7db5c](https://github.com/heygen-com/hyperframes/commit/97ec7db5cccd14a47fcfbe534d269dfea7a0d37d))
+- **Producer:** Emit heap advisory at orchestrator, lock message + telemetry props with tests ([c6462a0a2](https://github.com/heygen-com/hyperframes/commit/c6462a0a225772c7a357afd5fe2f5c9a39bca238))
+- **Engine:** Realistic worker memory budget + sizing/feedback telemetry ([12e599a6b](https://github.com/heygen-com/hyperframes/commit/12e599a6bac7dea5feec59c71dd0e5aeecab354e))
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.7.68...v0.7.69).
+</Update>
+
 <Update
   label="HyperFrames v0.7.68"
   description="Released - 2026-07-22"
diff --git a/packages/aws-lambda/package.json b/packages/aws-lambda/package.json
index 8bb924f5e2..f21e0f32c0 100644
--- a/packages/aws-lambda/package.json
+++ b/packages/aws-lambda/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 4428ad06da..1a8d57695b 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "license": "Apache-2.0",
   "repository": {
diff --git a/packages/core/package.json b/packages/core/package.json
index 43c4384ff2..73ea941988 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/packages/engine/package.json b/packages/engine/package.json
index 8bb6f744c6..1be1f315b0 100644
--- a/packages/engine/package.json
+++ b/packages/engine/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
diff --git a/packages/gcp-cloud-run/package.json b/packages/gcp-cloud-run/package.json
index 4b973cf01b..42389b8566 100644
--- a/packages/gcp-cloud-run/package.json
+++ b/packages/gcp-cloud-run/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/gcp-cloud-run",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index e48bce0526..c81672df4b 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index 1fa6323abc..47942ab989 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/player/package.json b/packages/player/package.json
index b3f3d3ee2f..98240af339 100644
--- a/packages/player/package.json
+++ b/packages/player/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/player",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "Embeddable web component for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/producer/package.json b/packages/producer/package.json
index 838272e73e..02a9ffb7be 100644
--- a/packages/producer/package.json
+++ b/packages/producer/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 4b3fa0ca9f..da8c464ed9 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
diff --git a/packages/shader-transitions/package.json b/packages/shader-transitions/package.json
index 08ff66f313..c68380af39 100644
--- a/packages/shader-transitions/package.json
+++ b/packages/shader-transitions/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/shader-transitions",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "WebGL shader transitions for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/studio-server/package.json b/packages/studio-server/package.json
index 26d527c0cd..b57f4da9c5 100644
--- a/packages/studio-server/package.json
+++ b/packages/studio-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/studio/package.json b/packages/studio/package.json
index 1f656c9208..7d87edfb9b 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.7.68",
+  "version": "0.7.69",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/releases/v0.7.69.md b/releases/v0.7.69.md
new file mode 100644
index 0000000000..40f737d5e8
--- /dev/null
+++ b/releases/v0.7.69.md
@@ -0,0 +1,22 @@
+# HyperFrames v0.7.69
+
+Released on 2026-07-23.
+
+HyperFrames now catches rotation pivot drift during layout audits, helping surface off-center spinners before render. This release also preserves editable `<br>` line breaks in SDK text edits, strengthens producer font, probe, and worker-memory handling, and improves preflight and pre-commit feedback.
+
+## Features
+
+- **Lint:** Add rotation_pivot_drift layout check ([222aec45a](https://github.com/heygen-com/hyperframes/commit/222aec45ab0553c014dddccd563e273affd9b71a), [#2741](https://github.com/heygen-com/hyperframes/pull/2741))
+
+## Fixes
+
+- **Sdk:** Keep <br> line breaks editable and uncorrupted in setText ([dd7378bbd](https://github.com/heygen-com/hyperframes/commit/dd7378bbd934ecc0da85c1edfae7946ac7e2271a), [#2742](https://github.com/heygen-com/hyperframes/pull/2742))
+- **Lint:** Address render preflight review feedback ([7a294f195](https://github.com/heygen-com/hyperframes/commit/7a294f19562928036dae20d5e73c2637d1e19060), [#2739](https://github.com/heygen-com/hyperframes/pull/2739))
+- **Producer:** Resolve residual font and probe failures ([948264d6b](https://github.com/heygen-com/hyperframes/commit/948264d6b205cadd191e04f36af332ed4a6bb233), [#2738](https://github.com/heygen-com/hyperframes/pull/2738))
+- **Hooks:** Pre-commit gate denies commit instead of ending the turn ([97ec7db5c](https://github.com/heygen-com/hyperframes/commit/97ec7db5cccd14a47fcfbe534d269dfea7a0d37d))
+- **Producer:** Emit heap advisory at orchestrator, lock message + telemetry props with tests ([c6462a0a2](https://github.com/heygen-com/hyperframes/commit/c6462a0a225772c7a357afd5fe2f5c9a39bca238))
+- **Engine:** Realistic worker memory budget + sizing/feedback telemetry ([12e599a6b](https://github.com/heygen-com/hyperframes/commit/12e599a6bac7dea5feec59c71dd0e5aeecab354e))
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.7.68...v0.7.69

From c67e9dc1f843122225468ce63a67c57f70c2bba2 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 20:18:39 +0000
Subject: [PATCH 024/125] feat(registry): make caption-weight-shift data-driven
 via caption-data runtime

---
 .../caption-weight-shift.html                 | 381 ++++++++++++++----
 1 file changed, 300 insertions(+), 81 deletions(-)

diff --git a/registry/components/caption-weight-shift/caption-weight-shift.html b/registry/components/caption-weight-shift/caption-weight-shift.html
index a6f37fe0b7..8bcfbe9fbf 100644
--- a/registry/components/caption-weight-shift/caption-weight-shift.html
+++ b/registry/components/caption-weight-shift/caption-weight-shift.html
@@ -90,7 +90,7 @@
         max-width: 1400px;
         line-height: 1.1;
         white-space: nowrap;
-        color: #ffffff;
+        color: var(--hf-caption-primary, #ffffff);
         font-family: "Montserrat", Arial, sans-serif;
         font-weight: 300;
         font-size: 72px;
@@ -117,12 +117,188 @@
     </div>
 
     <script>
-      var DURATION = 8;
-      var SAFE_ZONE_WIDTH = 1400;
-      var MAX_LINE_WIDTH = SAFE_ZONE_WIDTH - 40;
-      var CAPTION_FONT_SIZE = 72;
+      var HF_COMPOSITION_ID = "caption-weight-shift";
+      var HF_ROOT_ID = "weight-shift";
+      var HF_GROUP_SELECTOR = ".caption-group";
+
+      var HF_DEMO_DATA = {
+        version: 1,
+        segments: [
+          {
+            start: 0,
+            text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+            words: [
+              { text: "Every", start: 0.0, end: 0.3 },
+              { text: "great", start: 0.3, end: 0.55 },
+              { text: "video", start: 0.55, end: 0.85 },
+              { text: "starts", start: 0.85, end: 1.1 },
+              { text: "with", start: 1.1, end: 1.25 },
+              { text: "a", start: 1.25, end: 1.35 },
+              { text: "single", start: 1.35, end: 1.65 },
+              { text: "frame.", start: 1.65, end: 2.0 },
+              { text: "HyperFrames", start: 2.1, end: 2.65 },
+              { text: "lets", start: 2.65, end: 2.85 },
+              { text: "you", start: 2.85, end: 2.95 },
+              { text: "write", start: 2.95, end: 3.15 },
+              { text: "HTML", start: 3.15, end: 3.55 },
+              { text: "and", start: 3.55, end: 3.65 },
+              { text: "render", start: 3.65, end: 3.95 },
+              { text: "professional", start: 3.95, end: 4.45 },
+              { text: "video.", start: 4.45, end: 4.8 },
+              { text: "No", start: 4.9, end: 5.05 },
+              { text: "timeline.", start: 5.05, end: 5.45 },
+              { text: "No", start: 5.5, end: 5.65 },
+              { text: "drag", start: 5.65, end: 5.85 },
+              { text: "and", start: 5.85, end: 5.95 },
+              { text: "drop.", start: 5.95, end: 6.25 },
+              { text: "Just", start: 6.35, end: 6.55 },
+              { text: "code", start: 6.55, end: 6.8 },
+              { text: "that", start: 6.8, end: 6.95 },
+              { text: "becomes", start: 6.95, end: 7.3 },
+              { text: "cinema.", start: 7.3, end: 7.7 },
+            ],
+          },
+        ],
+      };
+
+      /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+      var HF_CONTRACT_VERSION = 1;
+      var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
+
+      function hfFlattenSegments(segments) {
+        var out = [];
+        (segments || []).forEach(function (seg) {
+          ((seg && seg.words) || []).forEach(function (w) {
+            var start = Math.max(0, Number(w.start) || 0);
+            out.push({
+              text: String(w.word || w.text || "").trim(),
+              start: start,
+              end: Math.max(start, Number(w.end) || 0),
+            });
+          });
+        });
+        out.sort(function (a, b) {
+          return a.start - b.start;
+        });
+        return out.filter(function (w) {
+          return w.text.length > 0;
+        });
+      }
+
+      function hfDeriveDuration(words) {
+        var end = 0;
+        words.forEach(function (w) {
+          if (w.end > end) end = w.end;
+        });
+        return end;
+      }
+
+      function hfValidate(data) {
+        if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+        if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+          return { ok: false, reason: "unsupported-version" };
+        }
+        if (!Array.isArray(data.segments) || data.segments.length === 0) {
+          return { ok: false, reason: "no-segments" };
+        }
+        if (data.displayMode != null && data.displayMode !== "full") {
+          return { ok: false, reason: "unsupported-displayMode" };
+        }
+        var words = hfFlattenSegments(data.segments);
+        if (words.length === 0) return { ok: false, reason: "no-words" };
+        return { ok: true, words: words, durationS: hfDeriveDuration(words) };
+      }
+
+      function hfApplyStageConfig(data, durationS) {
+        var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+        var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+        var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+        var root = document.getElementById(HF_ROOT_ID);
+        [document.documentElement, document.body, root].forEach(function (el) {
+          el.style.width = W + "px";
+          el.style.height = H + "px";
+        });
+        root.setAttribute("data-width", String(W));
+        root.setAttribute("data-height", String(H));
+        root.setAttribute("data-duration", String(durationS));
+        var brand = (data && data.brand) || {};
+        if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+          root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+        }
+        if (typeof brand.accentColor === "string" && brand.accentColor) {
+          root.style.setProperty("--hf-caption-accent", brand.accentColor);
+        }
+        return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
+      }
+
+      function hfPublishStatus(status) {
+        window.__HF_CAPTION_STATUS = status;
+        document
+          .getElementById(HF_ROOT_ID)
+          .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+      }
+
+      function hfRunGate(words, durationS, failReason) {
+        if (failReason) {
+          hfPublishStatus({
+            ok: false,
+            present: false,
+            contained: false,
+            reason: failReason,
+            version: HF_CONTRACT_VERSION,
+            durationS: durationS || 0,
+          });
+          return;
+        }
+        var root = document.getElementById(HF_ROOT_ID);
+        var rootRect = root.getBoundingClientRect();
+        var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+        var present = false;
+        var contained = true;
+        var tokens = [];
+        words.forEach(function (w) {
+          var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+          if (t) tokens.push(t);
+        });
+        groups.forEach(function (el) {
+          var prevOpacity = el.style.opacity;
+          var prevVisibility = el.style.visibility;
+          el.style.opacity = "1";
+          el.style.visibility = "visible";
+          var r = el.getBoundingClientRect();
+          if (r.width > 0 && r.height > 0) {
+            var text = (el.textContent || "").toLowerCase();
+            for (var i = 0; i < tokens.length; i++) {
+              if (text.indexOf(tokens[i]) !== -1) {
+                present = true;
+                break;
+              }
+            }
+            if (
+              r.left < rootRect.left - 1 ||
+              r.right > rootRect.right + 1 ||
+              r.top < rootRect.top - 1 ||
+              r.bottom > rootRect.bottom + 1
+            ) {
+              contained = false;
+            }
+          }
+          el.style.opacity = prevOpacity;
+          el.style.visibility = prevVisibility;
+        });
+        hfPublishStatus({
+          ok: present && contained,
+          present: present,
+          contained: contained,
+          version: HF_CONTRACT_VERSION,
+          durationS: durationS,
+        });
+      }
+
+      var SAFE_ZONE_WIDTH, MAX_LINE_WIDTH, CAPTION_FONT_SIZE, DURATION;
       var MAX_WORDS_PER_GROUP = 4;
-      var WORD_SPACING = 12;
+      var WORD_SPACING_DESIGN = 12;
+      var WORD_SPACING;
       var PAUSE_THRESHOLD = 0.1;
       var ENTRY_DURATION = 100 / 1000;
       var WEIGHT_TRANSITION = 100 / 1000;
@@ -130,37 +306,6 @@
       var FONT_WEIGHT_LIGHT = 300;
       var FONT_WEIGHT_BOLD = 700;
 
-      var TRANSCRIPT = [
-        { text: "Every", start: 0.0, end: 0.3 },
-        { text: "great", start: 0.3, end: 0.55 },
-        { text: "video", start: 0.55, end: 0.85 },
-        { text: "starts", start: 0.85, end: 1.1 },
-        { text: "with", start: 1.1, end: 1.25 },
-        { text: "a", start: 1.25, end: 1.35 },
-        { text: "single", start: 1.35, end: 1.65 },
-        { text: "frame.", start: 1.65, end: 2.0 },
-        { text: "HyperFrames", start: 2.1, end: 2.65 },
-        { text: "lets", start: 2.65, end: 2.85 },
-        { text: "you", start: 2.85, end: 2.95 },
-        { text: "write", start: 2.95, end: 3.15 },
-        { text: "HTML", start: 3.15, end: 3.55 },
-        { text: "and", start: 3.55, end: 3.65 },
-        { text: "render", start: 3.65, end: 3.95 },
-        { text: "professional", start: 3.95, end: 4.45 },
-        { text: "video.", start: 4.45, end: 4.8 },
-        { text: "No", start: 4.9, end: 5.05 },
-        { text: "timeline.", start: 5.05, end: 5.45 },
-        { text: "No", start: 5.5, end: 5.65 },
-        { text: "drag", start: 5.65, end: 5.85 },
-        { text: "and", start: 5.85, end: 5.95 },
-        { text: "drop.", start: 5.95, end: 6.25 },
-        { text: "Just", start: 6.35, end: 6.55 },
-        { text: "code", start: 6.55, end: 6.8 },
-        { text: "that", start: 6.8, end: 6.95 },
-        { text: "becomes", start: 6.95, end: 7.3 },
-        { text: "cinema.", start: 7.3, end: 7.7 },
-      ];
-
       function normalizeWords(rawWords) {
         return rawWords
           .map(function (item) {
@@ -190,7 +335,6 @@
 
       var measureCanvas = document.createElement("canvas");
       var measureContext = measureCanvas.getContext("2d");
-      measureContext.font = "700 " + CAPTION_FONT_SIZE + "px Montserrat";
 
       function measureWord(word) {
         return measureContext.measureText(word.text.toLowerCase()).width * FONT_WIDTH_SAFETY;
@@ -323,6 +467,7 @@
             lineEl.id = "caption-group-" + groupIndex + "-line-" + lineIndex;
             lineEl.style.fontWeight = lineIndex === 0 ? FONT_WEIGHT_BOLD : FONT_WEIGHT_LIGHT;
             lineEl.style.fontSize = computedSize + "px";
+            lineEl.style.maxWidth = SAFE_ZONE_WIDTH + "px";
             line.words.forEach(function (word, wordIndex) {
               var wordEl = document.createElement("span");
               wordEl.textContent = word.text.toLowerCase();
@@ -336,62 +481,136 @@
         });
       }
 
-      var WORDS = normalizeWords(TRANSCRIPT);
-      var GROUPS = makeGroups(WORDS);
-      buildCaptions(GROUPS);
+      function hfTeardown() {
+        document.getElementById("caption-stage").innerHTML = "";
+      }
 
-      window.__timelines = window.__timelines || {};
-      var tl = gsap.timeline({ paused: true });
+      function hfBuild(words, layout, durationS) {
+        DURATION = durationS;
+        CAPTION_FONT_SIZE = Math.round(72 * layout.fontScale);
+        SAFE_ZONE_WIDTH = Math.round(1400 * layout.scaleX);
+        MAX_LINE_WIDTH = SAFE_ZONE_WIDTH - Math.round(40 * layout.scaleX);
+        WORD_SPACING = Math.round(WORD_SPACING_DESIGN * layout.fontScale);
 
-      var visibleStarts = GROUPS.map(function (group, groupIndex) {
-        var prev = GROUPS[groupIndex - 1];
-        var availableGap = prev ? Math.max(0, group.start - prev.end) : ENTRY_DURATION;
-        var entryLead = Math.min(ENTRY_DURATION, availableGap);
-        return Math.max(0, group.start - entryLead);
-      });
+        var stage = document.getElementById("caption-stage");
+        var stageHeight = Math.round(278 * layout.fontScale);
+        stage.style.width = SAFE_ZONE_WIDTH + "px";
+        stage.style.height = stageHeight + "px";
+        stage.style.bottom = Math.round(100 * layout.scaleY) + "px";
+
+        measureContext.font = "700 " + CAPTION_FONT_SIZE + "px Montserrat";
+
+        var WORDS = normalizeWords(words);
+        var GROUPS = makeGroups(WORDS);
+        buildCaptions(GROUPS);
+        // set per-group sizing to match the runtime stage
+        GROUPS.forEach(function (_, i) {
+          var el = document.getElementById("caption-group-" + i);
+          el.style.width = SAFE_ZONE_WIDTH + "px";
+          el.style.height = stageHeight + "px";
+        });
 
-      var allGroupEls = GROUPS.map(function (_, i) {
-        return document.getElementById("caption-group-" + i);
-      });
+        var tl = gsap.timeline({ paused: true });
 
-      GROUPS.forEach(function (group, groupIndex) {
-        var groupEl = allGroupEls[groupIndex];
-        var visibleStart = visibleStarts[groupIndex];
-        var visibleEnd = groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
+        var visibleStarts = GROUPS.map(function (group, groupIndex) {
+          var prev = GROUPS[groupIndex - 1];
+          var availableGap = prev ? Math.max(0, group.start - prev.end) : ENTRY_DURATION;
+          var entryLead = Math.min(ENTRY_DURATION, availableGap);
+          return Math.max(0, group.start - entryLead);
+        });
 
-        allGroupEls.forEach(function (otherEl, otherIndex) {
-          if (otherIndex !== groupIndex) tl.set(otherEl, { opacity: 0 }, visibleStart);
+        var allGroupEls = GROUPS.map(function (_, i) {
+          return document.getElementById("caption-group-" + i);
         });
 
-        tl.set(groupEl, { opacity: 0, scale: 0.85 }, visibleStart);
-        tl.to(
-          groupEl,
-          { opacity: 1, scale: 1, duration: ENTRY_DURATION, ease: "power3.out", force3D: true },
-          visibleStart,
-        );
+        GROUPS.forEach(function (group, groupIndex) {
+          var groupEl = allGroupEls[groupIndex];
+          var visibleStart = visibleStarts[groupIndex];
+          var visibleEnd =
+            groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
 
-        if (group.lines.length === 2) {
-          var line1El = document.getElementById("caption-group-" + groupIndex + "-line-0");
-          var line2El = document.getElementById("caption-group-" + groupIndex + "-line-1");
-          var line2FirstWord = group.lines[1].words[0];
-          var switchTime = line2FirstWord.start;
+          allGroupEls.forEach(function (otherEl, otherIndex) {
+            if (otherIndex !== groupIndex) tl.set(otherEl, { opacity: 0 }, visibleStart);
+          });
 
+          tl.set(groupEl, { opacity: 0, scale: 0.85 }, visibleStart);
           tl.to(
-            line1El,
-            { fontWeight: FONT_WEIGHT_LIGHT, duration: WEIGHT_TRANSITION, ease: "power2.out" },
-            switchTime,
+            groupEl,
+            { opacity: 1, scale: 1, duration: ENTRY_DURATION, ease: "power3.out", force3D: true },
+            visibleStart,
           );
-          tl.to(
-            line2El,
-            { fontWeight: FONT_WEIGHT_BOLD, duration: WEIGHT_TRANSITION, ease: "power2.out" },
-            switchTime,
-          );
-        }
 
-        tl.set(groupEl, { opacity: 0 }, visibleEnd);
-      });
+          if (group.lines.length === 2) {
+            var line1El = document.getElementById("caption-group-" + groupIndex + "-line-0");
+            var line2El = document.getElementById("caption-group-" + groupIndex + "-line-1");
+            var line2FirstWord = group.lines[1].words[0];
+            var switchTime = line2FirstWord.start;
+
+            tl.to(
+              line1El,
+              { fontWeight: FONT_WEIGHT_LIGHT, duration: WEIGHT_TRANSITION, ease: "power2.out" },
+              switchTime,
+            );
+            tl.to(
+              line2El,
+              { fontWeight: FONT_WEIGHT_BOLD, duration: WEIGHT_TRANSITION, ease: "power2.out" },
+              switchTime,
+            );
+          }
+
+          tl.set(groupEl, { opacity: 0 }, visibleEnd);
+        });
+
+        return tl;
+      }
 
-      window.__timelines["caption-weight-shift"] = tl;
+      var hfCurrentTimeline = null;
+
+      function hfAttach(data) {
+        var v = hfValidate(data);
+        if (!v.ok) {
+          hfRunGate([], 0, v.reason);
+          return;
+        }
+        if (hfCurrentTimeline) {
+          hfCurrentTimeline.kill();
+          hfCurrentTimeline = null;
+        }
+        hfTeardown();
+        var layout = hfApplyStageConfig(data, v.durationS);
+        var tl = hfBuild(v.words, layout, v.durationS);
+        tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+        tl.seek(0);
+        hfCurrentTimeline = tl;
+        window.__timelines = window.__timelines || {};
+        window.__timelines[HF_COMPOSITION_ID] = tl;
+        hfRunGate(v.words, v.durationS, null);
+      }
+      window.__HF_CAPTION_ATTACH__ = hfAttach;
+
+      (function hfBoot() {
+        function start(data) {
+          var ready =
+            document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+          ready.then(function () {
+            hfAttach(data);
+          });
+        }
+        if (window.__HF_CAPTION__) {
+          start(window.__HF_CAPTION__);
+          return;
+        }
+        fetch("./caption-data.json")
+          .then(function (r) {
+            return r.ok ? r.json() : null;
+          })
+          .catch(function () {
+            return null;
+          })
+          .then(function (json) {
+            start(json || HF_DEMO_DATA);
+          });
+      })();
     </script>
   </body>
 </html>

From 08620b75df5275739fd9b0b8f480527fdc1d9a98 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 20:46:26 +0000
Subject: [PATCH 025/125] feat(registry): make caption-pill-karaoke data-driven
 via caption-data runtime

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .../caption-pill-karaoke.html                 | 359 ++++++++++++++----
 1 file changed, 289 insertions(+), 70 deletions(-)

diff --git a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
index 06b5a4ac2c..712823c802 100644
--- a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
+++ b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
@@ -131,56 +131,199 @@
     </div>
 
     <script>
-      var DURATION = 8;
-      var SAFE_ZONE_WIDTH = 1400;
-      var PILL_MAX_WIDTH = 1400;
+      var HF_COMPOSITION_ID = "caption-pill-karaoke";
+      var HF_ROOT_ID = "pill-karaoke";
+      var HF_GROUP_SELECTOR = ".caption-group";
+
+      var HF_DEMO_DATA = {
+        version: 1,
+        segments: [
+          {
+            start: 0,
+            text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+            words: [
+              { text: "Every", start: 0.0, end: 0.3 },
+              { text: "great", start: 0.3, end: 0.55 },
+              { text: "video", start: 0.55, end: 0.85 },
+              { text: "starts", start: 0.85, end: 1.1 },
+              { text: "with", start: 1.1, end: 1.25 },
+              { text: "a", start: 1.25, end: 1.35 },
+              { text: "single", start: 1.35, end: 1.65 },
+              { text: "frame.", start: 1.65, end: 2.0 },
+              { text: "HyperFrames", start: 2.1, end: 2.65 },
+              { text: "lets", start: 2.65, end: 2.85 },
+              { text: "you", start: 2.85, end: 2.95 },
+              { text: "write", start: 2.95, end: 3.15 },
+              { text: "HTML", start: 3.15, end: 3.55 },
+              { text: "and", start: 3.55, end: 3.65 },
+              { text: "render", start: 3.65, end: 3.95 },
+              { text: "professional", start: 3.95, end: 4.45 },
+              { text: "video.", start: 4.45, end: 4.8 },
+              { text: "No", start: 4.9, end: 5.05 },
+              { text: "timeline.", start: 5.05, end: 5.45 },
+              { text: "No", start: 5.5, end: 5.65 },
+              { text: "drag", start: 5.65, end: 5.85 },
+              { text: "and", start: 5.85, end: 5.95 },
+              { text: "drop.", start: 5.95, end: 6.25 },
+              { text: "Just", start: 6.35, end: 6.55 },
+              { text: "code", start: 6.55, end: 6.8 },
+              { text: "that", start: 6.8, end: 6.95 },
+              { text: "becomes", start: 6.95, end: 7.3 },
+              { text: "cinema.", start: 7.3, end: 7.7 },
+            ],
+          },
+        ],
+      };
+
+      /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+      var HF_CONTRACT_VERSION = 1;
+      var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
+
+      function hfFlattenSegments(segments) {
+        var out = [];
+        (segments || []).forEach(function (seg) {
+          ((seg && seg.words) || []).forEach(function (w) {
+            var start = Math.max(0, Number(w.start) || 0);
+            out.push({
+              text: String(w.word || w.text || "").trim(),
+              start: start,
+              end: Math.max(start, Number(w.end) || 0),
+            });
+          });
+        });
+        out.sort(function (a, b) {
+          return a.start - b.start;
+        });
+        return out.filter(function (w) {
+          return w.text.length > 0;
+        });
+      }
+
+      function hfDeriveDuration(words) {
+        var end = 0;
+        words.forEach(function (w) {
+          if (w.end > end) end = w.end;
+        });
+        return end;
+      }
+
+      function hfValidate(data) {
+        if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+        if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+          return { ok: false, reason: "unsupported-version" };
+        }
+        if (!Array.isArray(data.segments) || data.segments.length === 0) {
+          return { ok: false, reason: "no-segments" };
+        }
+        if (data.displayMode != null && data.displayMode !== "full") {
+          return { ok: false, reason: "unsupported-displayMode" };
+        }
+        var words = hfFlattenSegments(data.segments);
+        if (words.length === 0) return { ok: false, reason: "no-words" };
+        return { ok: true, words: words, durationS: hfDeriveDuration(words) };
+      }
+
+      function hfApplyStageConfig(data, durationS) {
+        var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+        var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+        var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+        var root = document.getElementById(HF_ROOT_ID);
+        [document.documentElement, document.body, root].forEach(function (el) {
+          el.style.width = W + "px";
+          el.style.height = H + "px";
+        });
+        root.setAttribute("data-width", String(W));
+        root.setAttribute("data-height", String(H));
+        root.setAttribute("data-duration", String(durationS));
+        var brand = (data && data.brand) || {};
+        if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+          root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+        }
+        if (typeof brand.accentColor === "string" && brand.accentColor) {
+          root.style.setProperty("--hf-caption-accent", brand.accentColor);
+        }
+        return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
+      }
+
+      function hfPublishStatus(status) {
+        window.__HF_CAPTION_STATUS = status;
+        document
+          .getElementById(HF_ROOT_ID)
+          .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+      }
+
+      function hfRunGate(words, durationS, failReason) {
+        if (failReason) {
+          hfPublishStatus({
+            ok: false,
+            present: false,
+            contained: false,
+            reason: failReason,
+            version: HF_CONTRACT_VERSION,
+            durationS: durationS || 0,
+          });
+          return;
+        }
+        var root = document.getElementById(HF_ROOT_ID);
+        var rootRect = root.getBoundingClientRect();
+        var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+        var present = false;
+        var contained = true;
+        var tokens = [];
+        words.forEach(function (w) {
+          var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+          if (t) tokens.push(t);
+        });
+        groups.forEach(function (el) {
+          var prevOpacity = el.style.opacity;
+          var prevVisibility = el.style.visibility;
+          el.style.opacity = "1";
+          el.style.visibility = "visible";
+          var r = el.getBoundingClientRect();
+          if (r.width > 0 && r.height > 0) {
+            var text = (el.textContent || "").toLowerCase();
+            for (var i = 0; i < tokens.length; i++) {
+              if (text.indexOf(tokens[i]) !== -1) {
+                present = true;
+                break;
+              }
+            }
+            if (
+              r.left < rootRect.left - 1 ||
+              r.right > rootRect.right + 1 ||
+              r.top < rootRect.top - 1 ||
+              r.bottom > rootRect.bottom + 1
+            ) {
+              contained = false;
+            }
+          }
+          el.style.opacity = prevOpacity;
+          el.style.visibility = prevVisibility;
+        });
+        hfPublishStatus({
+          ok: present && contained,
+          present: present,
+          contained: contained,
+          version: HF_CONTRACT_VERSION,
+          durationS: durationS,
+        });
+      }
+
+      var DURATION, SAFE_ZONE_WIDTH, PILL_MAX_WIDTH, BASE_FONT_SIZE, MIN_FONT_SIZE, WORD_SPACING;
       var PILL_MIN_PADDING_X = 30;
       var PILL_MAX_PADDING_X = 60;
       var FONT_WIDTH_SAFETY = 1.18;
       var FONT_FAMILY = "Poppins";
       var FONT_WEIGHT = "700";
-      var BASE_FONT_SIZE = 72;
-      var MIN_FONT_SIZE = 52;
       var MAX_WORDS_PER_GROUP = 4;
-      var WORD_SPACING = 16;
       var PAUSE_THRESHOLD = 0.1;
       var GROUP_END_BUFFER = 0.3;
       var COLOR_INACTIVE = "#A6A6A6";
       var COLOR_ACTIVE = "#1C1E1D";
+      var hfColorActive = COLOR_ACTIVE;
       var COLOR_FADE_DURATION = 0.1;
       var WORD_FADE_LEAD = 0.05;
 
-      var TRANSCRIPT = [
-        { text: "Every", start: 0.0, end: 0.3 },
-        { text: "great", start: 0.3, end: 0.55 },
-        { text: "video", start: 0.55, end: 0.85 },
-        { text: "starts", start: 0.85, end: 1.1 },
-        { text: "with", start: 1.1, end: 1.25 },
-        { text: "a", start: 1.25, end: 1.35 },
-        { text: "single", start: 1.35, end: 1.65 },
-        { text: "frame.", start: 1.65, end: 2.0 },
-        { text: "HyperFrames", start: 2.1, end: 2.65 },
-        { text: "lets", start: 2.65, end: 2.85 },
-        { text: "you", start: 2.85, end: 2.95 },
-        { text: "write", start: 2.95, end: 3.15 },
-        { text: "HTML", start: 3.15, end: 3.55 },
-        { text: "and", start: 3.55, end: 3.65 },
-        { text: "render", start: 3.65, end: 3.95 },
-        { text: "professional", start: 3.95, end: 4.45 },
-        { text: "video.", start: 4.45, end: 4.8 },
-        { text: "No", start: 4.9, end: 5.05 },
-        { text: "timeline.", start: 5.05, end: 5.45 },
-        { text: "No", start: 5.5, end: 5.65 },
-        { text: "drag", start: 5.65, end: 5.85 },
-        { text: "and", start: 5.85, end: 5.95 },
-        { text: "drop.", start: 5.95, end: 6.25 },
-        { text: "Just", start: 6.35, end: 6.55 },
-        { text: "code", start: 6.55, end: 6.8 },
-        { text: "that", start: 6.8, end: 6.95 },
-        { text: "becomes", start: 6.95, end: 7.3 },
-        { text: "cinema.", start: 7.3, end: 7.7 },
-      ];
-
       function normalizeWords(rawWords) {
         return rawWords
           .map(function (item) {
@@ -322,6 +465,7 @@
           });
           var layout = planPillLayout(indexedWords, fontSize);
           pillEl.style.width = layout.pillWidth + "px";
+          pillEl.style.maxWidth = PILL_MAX_WIDTH + "px";
           pillEl.style.paddingLeft = layout.padX + "px";
           pillEl.style.paddingRight = layout.padX + "px";
           layout.lines.slice(0, 2).forEach(function (lineWords) {
@@ -342,41 +486,116 @@
         });
       }
 
-      var WORDS = normalizeWords(TRANSCRIPT);
-      var GROUPS = makeGroups(WORDS);
-      buildCaptions(GROUPS);
-
-      window.__timelines = window.__timelines || {};
-      var tl = gsap.timeline({ paused: true });
-
-      GROUPS.forEach(function (group, groupIndex) {
-        var groupEl = document.getElementById("caption-group-" + groupIndex);
-        var nextGroup = GROUPS[groupIndex + 1];
-        var isLastGroup = groupIndex === GROUPS.length - 1;
-        var effectiveEnd = isLastGroup
-          ? DURATION
-          : Math.min(nextGroup.start, group.end + GROUP_END_BUFFER);
-        var visibleStart = Math.max(0, group.start);
-        var visibleEnd = Math.max(visibleStart + 0.01, effectiveEnd);
-
-        tl.set(groupEl, { opacity: 1 }, visibleStart);
-        tl.set(groupEl, { opacity: 0 }, visibleEnd);
-
-        group.words.forEach(function (word, wordIndex) {
-          var wordEl = document.getElementById("caption-word-" + groupIndex + "-" + wordIndex);
-          var isFirstWord = wordIndex === 0;
-          var wordStart = Math.max(visibleStart, word.start - WORD_FADE_LEAD);
-          tl.set(wordEl, { color: isFirstWord ? COLOR_ACTIVE : COLOR_INACTIVE }, visibleStart);
-          if (isFirstWord) return;
-          tl.to(
-            wordEl,
-            { color: COLOR_ACTIVE, duration: COLOR_FADE_DURATION, ease: "none" },
-            wordStart,
-          );
+      function hfTeardown() {
+        document.getElementById("caption-stage").innerHTML = "";
+      }
+
+      function hfBuild(words, layout, durationS) {
+        DURATION = durationS;
+        BASE_FONT_SIZE = Math.round(72 * layout.fontScale);
+        MIN_FONT_SIZE = Math.round(52 * layout.fontScale);
+        SAFE_ZONE_WIDTH = Math.round(1600 * layout.scaleX);
+        PILL_MAX_WIDTH = SAFE_ZONE_WIDTH;
+        WORD_SPACING = Math.round(16 * layout.fontScale);
+
+        var stage = document.getElementById("caption-stage");
+        var stageHeight = Math.round(220 * layout.fontScale);
+        stage.style.width = SAFE_ZONE_WIDTH + "px";
+        stage.style.height = stageHeight + "px";
+        stage.style.bottom = Math.round(90 * layout.scaleY) + "px";
+
+        var rootEl = document.getElementById(HF_ROOT_ID);
+        var accent = getComputedStyle(rootEl).getPropertyValue("--hf-caption-accent").trim();
+        hfColorActive = accent || COLOR_ACTIVE;
+
+        var WORDS = normalizeWords(words);
+        var GROUPS = makeGroups(WORDS);
+        buildCaptions(GROUPS);
+        GROUPS.forEach(function (_, i) {
+          var el = document.getElementById("caption-group-" + i);
+          el.style.width = SAFE_ZONE_WIDTH + "px";
+          el.style.height = stageHeight + "px";
         });
-      });
 
-      window.__timelines["caption-pill-karaoke"] = tl;
+        var tl = gsap.timeline({ paused: true });
+
+        GROUPS.forEach(function (group, groupIndex) {
+          var groupEl = document.getElementById("caption-group-" + groupIndex);
+          var nextGroup = GROUPS[groupIndex + 1];
+          var isLastGroup = groupIndex === GROUPS.length - 1;
+          var effectiveEnd = isLastGroup
+            ? DURATION
+            : Math.min(nextGroup.start, group.end + GROUP_END_BUFFER);
+          var visibleStart = Math.max(0, group.start);
+          var visibleEnd = Math.max(visibleStart + 0.01, effectiveEnd);
+
+          tl.set(groupEl, { opacity: 1 }, visibleStart);
+          tl.set(groupEl, { opacity: 0 }, visibleEnd);
+
+          group.words.forEach(function (word, wordIndex) {
+            var wordEl = document.getElementById("caption-word-" + groupIndex + "-" + wordIndex);
+            var isFirstWord = wordIndex === 0;
+            var wordStart = Math.max(visibleStart, word.start - WORD_FADE_LEAD);
+            tl.set(wordEl, { color: isFirstWord ? hfColorActive : COLOR_INACTIVE }, visibleStart);
+            if (isFirstWord) return;
+            tl.to(
+              wordEl,
+              { color: hfColorActive, duration: COLOR_FADE_DURATION, ease: "none" },
+              wordStart,
+            );
+          });
+        });
+
+        return tl;
+      }
+
+      var hfCurrentTimeline = null;
+
+      function hfAttach(data) {
+        var v = hfValidate(data);
+        if (!v.ok) {
+          hfRunGate([], 0, v.reason);
+          return;
+        }
+        if (hfCurrentTimeline) {
+          hfCurrentTimeline.kill();
+          hfCurrentTimeline = null;
+        }
+        hfTeardown();
+        var layout = hfApplyStageConfig(data, v.durationS);
+        var tl = hfBuild(v.words, layout, v.durationS);
+        tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+        tl.seek(0);
+        hfCurrentTimeline = tl;
+        window.__timelines = window.__timelines || {};
+        window.__timelines[HF_COMPOSITION_ID] = tl;
+        hfRunGate(v.words, v.durationS, null);
+      }
+      window.__HF_CAPTION_ATTACH__ = hfAttach;
+
+      (function hfBoot() {
+        function start(data) {
+          var ready =
+            document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+          ready.then(function () {
+            hfAttach(data);
+          });
+        }
+        if (window.__HF_CAPTION__) {
+          start(window.__HF_CAPTION__);
+          return;
+        }
+        fetch("./caption-data.json")
+          .then(function (r) {
+            return r.ok ? r.json() : null;
+          })
+          .catch(function () {
+            return null;
+          })
+          .then(function (json) {
+            start(json || HF_DEMO_DATA);
+          });
+      })();
     </script>
   </body>
 </html>

From 020c8986f46f795757203900cd251ad551ccc620 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 21:01:24 +0000
Subject: [PATCH 026/125] =?UTF-8?q?fix(registry):=20force=20GSAP=20render?=
 =?UTF-8?q?=20at=20attach=20=E2=80=94=20seek(0)=20is=20a=20no-op=20on=20a?=
 =?UTF-8?q?=20fresh=20timeline?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../caption-pill-karaoke/caption-pill-karaoke.html          | 6 +++++-
 .../caption-weight-shift/caption-weight-shift.html          | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
index 712823c802..741048027c 100644
--- a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
+++ b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
@@ -565,7 +565,11 @@
         var layout = hfApplyStageConfig(data, v.durationS);
         var tl = hfBuild(v.words, layout, v.durationS);
         tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
-        tl.seek(0);
+        // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+        // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+        // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+        // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+        tl.render(0, true, true);
         hfCurrentTimeline = tl;
         window.__timelines = window.__timelines || {};
         window.__timelines[HF_COMPOSITION_ID] = tl;
diff --git a/registry/components/caption-weight-shift/caption-weight-shift.html b/registry/components/caption-weight-shift/caption-weight-shift.html
index 8bcfbe9fbf..2ead4d717f 100644
--- a/registry/components/caption-weight-shift/caption-weight-shift.html
+++ b/registry/components/caption-weight-shift/caption-weight-shift.html
@@ -580,7 +580,11 @@
         var layout = hfApplyStageConfig(data, v.durationS);
         var tl = hfBuild(v.words, layout, v.durationS);
         tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
-        tl.seek(0);
+        // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+        // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+        // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+        // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+        tl.render(0, true, true);
         hfCurrentTimeline = tl;
         window.__timelines = window.__timelines || {};
         window.__timelines[HF_COMPOSITION_ID] = tl;

From 392a9d251a4feadbf7703ba4f9157c1857c7a59b Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 21:31:46 +0000
Subject: [PATCH 027/125] feat(registry): make caption-emoji-pop data-driven
 with generic emoji lexicon

Retrofits caption-emoji-pop onto the shared HyperFrames caption-data runtime
(Blocks A-D) and the emphasis heuristic (Block E), replacing the hardcoded
7-word emoji map, fixed KEYWORDS set, and TRANSITION_WORDS set with a
generic ~40-entry lexicon and HF_STOPWORDS/hfIsEmphasisWord. The component
now consumes brand.primaryColor (hfPrimaryColor) and brand.accentColor
(hfAccentColors) and rescales stage/font/emoji sizing to the runtime
resolution via layout.fontScale/scaleX/scaleY.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .../caption-emoji-pop/caption-emoji-pop.html  | 511 ++++++++++++++----
 1 file changed, 415 insertions(+), 96 deletions(-)

diff --git a/registry/components/caption-emoji-pop/caption-emoji-pop.html b/registry/components/caption-emoji-pop/caption-emoji-pop.html
index f8a863d2e8..d4107123b0 100644
--- a/registry/components/caption-emoji-pop/caption-emoji-pop.html
+++ b/registry/components/caption-emoji-pop/caption-emoji-pop.html
@@ -125,22 +125,185 @@
     </div>
 
     <script>
-      var DURATION = 8;
-      var SAFE_ZONE_WIDTH = 1400;
-      var CAPTION_FONT_SIZE = 72;
-      var MAX_WORDS_PER_GROUP = 3;
-      var WORD_SPACING = 14;
-      var PAUSE_THRESHOLD = 0.1;
-      var ENTRY_FRAMES = 4;
-      var EXIT_FRAMES = 3;
-      var FPS = 30;
-      var ENTRY_DURATION = ENTRY_FRAMES / FPS;
-      var EXIT_DURATION = EXIT_FRAMES / FPS;
-      var FONT_WIDTH_SAFETY = 1.14;
-      var PRIMARY_COLOR = "#FFFFFF";
-      var ACCENT_COLORS = ["#FF76FF", "#FF0002", "#B2F7FF"];
-      var KEYWORDS = new Set(["hyperframes", "html", "professional", "code", "cinema"]);
-      var TRANSITION_WORDS = new Set([
+      var HF_COMPOSITION_ID = "caption-emoji-pop";
+      var HF_ROOT_ID = "emoji-pop";
+      var HF_GROUP_SELECTOR = ".caption-group";
+
+      var HF_DEMO_DATA = {
+        version: 1,
+        segments: [
+          {
+            start: 0,
+            text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+            words: [
+              { text: "Every", start: 0.0, end: 0.3 },
+              { text: "great", start: 0.3, end: 0.55 },
+              { text: "video", start: 0.55, end: 0.85 },
+              { text: "starts", start: 0.85, end: 1.1 },
+              { text: "with", start: 1.1, end: 1.25 },
+              { text: "a", start: 1.25, end: 1.35 },
+              { text: "single", start: 1.35, end: 1.65 },
+              { text: "frame.", start: 1.65, end: 2.0 },
+              { text: "HyperFrames", start: 2.1, end: 2.65 },
+              { text: "lets", start: 2.65, end: 2.85 },
+              { text: "you", start: 2.85, end: 2.95 },
+              { text: "write", start: 2.95, end: 3.15 },
+              { text: "HTML", start: 3.15, end: 3.55 },
+              { text: "and", start: 3.55, end: 3.65 },
+              { text: "render", start: 3.65, end: 3.95 },
+              { text: "professional", start: 3.95, end: 4.45 },
+              { text: "video.", start: 4.45, end: 4.8 },
+              { text: "No", start: 4.9, end: 5.05 },
+              { text: "timeline.", start: 5.05, end: 5.45 },
+              { text: "No", start: 5.5, end: 5.65 },
+              { text: "drag", start: 5.65, end: 5.85 },
+              { text: "and", start: 5.85, end: 5.95 },
+              { text: "drop.", start: 5.95, end: 6.25 },
+              { text: "Just", start: 6.35, end: 6.55 },
+              { text: "code", start: 6.55, end: 6.8 },
+              { text: "that", start: 6.8, end: 6.95 },
+              { text: "becomes", start: 6.95, end: 7.3 },
+              { text: "cinema.", start: 7.3, end: 7.7 },
+            ],
+          },
+        ],
+      };
+
+      /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+      var HF_CONTRACT_VERSION = 1;
+      var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
+
+      function hfFlattenSegments(segments) {
+        var out = [];
+        (segments || []).forEach(function (seg) {
+          ((seg && seg.words) || []).forEach(function (w) {
+            var start = Math.max(0, Number(w.start) || 0);
+            out.push({
+              text: String(w.word || w.text || "").trim(),
+              start: start,
+              end: Math.max(start, Number(w.end) || 0),
+            });
+          });
+        });
+        out.sort(function (a, b) {
+          return a.start - b.start;
+        });
+        return out.filter(function (w) {
+          return w.text.length > 0;
+        });
+      }
+
+      function hfDeriveDuration(words) {
+        var end = 0;
+        words.forEach(function (w) {
+          if (w.end > end) end = w.end;
+        });
+        return end;
+      }
+
+      function hfValidate(data) {
+        if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+        if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+          return { ok: false, reason: "unsupported-version" };
+        }
+        if (!Array.isArray(data.segments) || data.segments.length === 0) {
+          return { ok: false, reason: "no-segments" };
+        }
+        if (data.displayMode != null && data.displayMode !== "full") {
+          return { ok: false, reason: "unsupported-displayMode" };
+        }
+        var words = hfFlattenSegments(data.segments);
+        if (words.length === 0) return { ok: false, reason: "no-words" };
+        return { ok: true, words: words, durationS: hfDeriveDuration(words) };
+      }
+
+      function hfApplyStageConfig(data, durationS) {
+        var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+        var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+        var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+        var root = document.getElementById(HF_ROOT_ID);
+        [document.documentElement, document.body, root].forEach(function (el) {
+          el.style.width = W + "px";
+          el.style.height = H + "px";
+        });
+        root.setAttribute("data-width", String(W));
+        root.setAttribute("data-height", String(H));
+        root.setAttribute("data-duration", String(durationS));
+        var brand = (data && data.brand) || {};
+        if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+          root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+        }
+        if (typeof brand.accentColor === "string" && brand.accentColor) {
+          root.style.setProperty("--hf-caption-accent", brand.accentColor);
+        }
+        return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
+      }
+
+      function hfPublishStatus(status) {
+        window.__HF_CAPTION_STATUS = status;
+        document
+          .getElementById(HF_ROOT_ID)
+          .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+      }
+
+      function hfRunGate(words, durationS, failReason) {
+        if (failReason) {
+          hfPublishStatus({
+            ok: false,
+            present: false,
+            contained: false,
+            reason: failReason,
+            version: HF_CONTRACT_VERSION,
+            durationS: durationS || 0,
+          });
+          return;
+        }
+        var root = document.getElementById(HF_ROOT_ID);
+        var rootRect = root.getBoundingClientRect();
+        var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+        var present = false;
+        var contained = true;
+        var tokens = [];
+        words.forEach(function (w) {
+          var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+          if (t) tokens.push(t);
+        });
+        groups.forEach(function (el) {
+          var prevOpacity = el.style.opacity;
+          var prevVisibility = el.style.visibility;
+          el.style.opacity = "1";
+          el.style.visibility = "visible";
+          var r = el.getBoundingClientRect();
+          if (r.width > 0 && r.height > 0) {
+            var text = (el.textContent || "").toLowerCase();
+            for (var i = 0; i < tokens.length; i++) {
+              if (text.indexOf(tokens[i]) !== -1) {
+                present = true;
+                break;
+              }
+            }
+            if (
+              r.left < rootRect.left - 1 ||
+              r.right > rootRect.right + 1 ||
+              r.top < rootRect.top - 1 ||
+              r.bottom > rootRect.bottom + 1
+            ) {
+              contained = false;
+            }
+          }
+          el.style.opacity = prevOpacity;
+          el.style.visibility = prevVisibility;
+        });
+        hfPublishStatus({
+          ok: present && contained,
+          present: present,
+          contained: contained,
+          version: HF_CONTRACT_VERSION,
+          durationS: durationS,
+        });
+      }
+
+      var HF_STOPWORDS = new Set([
         "the",
         "a",
         "an",
@@ -193,50 +356,116 @@
         "up",
         "out",
         "about",
+        "into",
+        "over",
+        "after",
+        "before",
+        "your",
+        "you",
+        "our",
+        "we",
+        "they",
+        "them",
+        "their",
+        "there",
+        "here",
+        "when",
+        "what",
+        "which",
+        "who",
+        "how",
+        "all",
+        "any",
+        "some",
+        "more",
+        "most",
+        "other",
+        "than",
+        "too",
+        "very",
+        "also",
+        "because",
       ]);
 
-      // Emoji map for key words
+      function hfIsEmphasisWord(text) {
+        var clean = String(text)
+          .toLowerCase()
+          .replace(/[^a-z]/g, "");
+        return clean.length >= 5 && !HF_STOPWORDS.has(clean);
+      }
+
+      var DURATION, SAFE_ZONE_WIDTH, CAPTION_FONT_SIZE, WORD_SPACING;
+      var MAX_WORDS_PER_GROUP = 3;
+      var PAUSE_THRESHOLD = 0.1;
+      var ENTRY_FRAMES = 4;
+      var EXIT_FRAMES = 3;
+      var FPS = 30;
+      var ENTRY_DURATION = ENTRY_FRAMES / FPS;
+      var EXIT_DURATION = EXIT_FRAMES / FPS;
+      var FONT_WIDTH_SAFETY = 1.14;
+      var PRIMARY_COLOR = "#FFFFFF";
+      var ACCENT_COLORS = ["#FF76FF", "#FF0002", "#B2F7FF"];
+      var hfPrimaryColor = PRIMARY_COLOR;
+      var hfAccentColors = ACCENT_COLORS;
+      var hfFontScale = 1;
+
+      // Emoji map for a generic keyword lexicon (not tied to the demo transcript)
       var WORD_EMOJI = {
-        hyperframes: "🎬",
-        html: "💻",
-        professional: "✨",
-        code: "⌨️",
+        amazing: "🤩",
+        awesome: "🔥",
+        big: "🐘",
+        brain: "🧠",
+        build: "🛠️",
+        built: "🛠️",
+        celebrate: "🎉",
+        change: "🔄",
         cinema: "🎥",
-        video: "📹",
+        code: "⌨️",
+        customers: "🤝",
+        data: "📊",
+        dream: "💭",
+        easy: "👌",
+        fast: "⚡",
+        fire: "🔥",
         frame: "🖼️",
+        free: "🎁",
+        fun: "🎈",
+        future: "🔮",
+        global: "🌍",
+        grow: "📈",
+        growth: "📈",
+        heart: "❤️",
+        huge: "🐘",
+        idea: "💡",
+        launch: "🚀",
+        learn: "📚",
+        love: "❤️",
+        magic: "✨",
+        money: "💰",
+        music: "🎵",
+        new: "✨",
+        party: "🎉",
+        perfect: "💯",
+        power: "💪",
+        professional: "✨",
+        rocket: "🚀",
+        save: "🛟",
+        saves: "🛟",
+        secret: "🤫",
+        smart: "🧠",
+        star: "⭐",
+        stop: "✋",
+        strong: "💪",
+        success: "🏆",
+        team: "👥",
+        time: "⏰",
+        today: "📅",
+        video: "📹",
+        win: "🏆",
+        world: "🌍",
+        wow: "😮",
       };
 
-      var TRANSCRIPT = [
-        { text: "Every", start: 0.0, end: 0.3 },
-        { text: "great", start: 0.3, end: 0.55 },
-        { text: "video", start: 0.55, end: 0.85 },
-        { text: "starts", start: 0.85, end: 1.1 },
-        { text: "with", start: 1.1, end: 1.25 },
-        { text: "a", start: 1.25, end: 1.35 },
-        { text: "single", start: 1.35, end: 1.65 },
-        { text: "frame.", start: 1.65, end: 2.0 },
-        { text: "HyperFrames", start: 2.1, end: 2.65 },
-        { text: "lets", start: 2.65, end: 2.85 },
-        { text: "you", start: 2.85, end: 2.95 },
-        { text: "write", start: 2.95, end: 3.15 },
-        { text: "HTML", start: 3.15, end: 3.55 },
-        { text: "and", start: 3.55, end: 3.65 },
-        { text: "render", start: 3.65, end: 3.95 },
-        { text: "professional", start: 3.95, end: 4.45 },
-        { text: "video.", start: 4.45, end: 4.8 },
-        { text: "No", start: 4.9, end: 5.05 },
-        { text: "timeline.", start: 5.05, end: 5.45 },
-        { text: "No", start: 5.5, end: 5.65 },
-        { text: "drag", start: 5.65, end: 5.85 },
-        { text: "and", start: 5.85, end: 5.95 },
-        { text: "drop.", start: 5.95, end: 6.25 },
-        { text: "Just", start: 6.35, end: 6.55 },
-        { text: "code", start: 6.55, end: 6.8 },
-        { text: "that", start: 6.8, end: 6.95 },
-        { text: "becomes", start: 6.95, end: 7.3 },
-        { text: "cinema.", start: 7.3, end: 7.7 },
-      ];
-
       function normalizeWords(rawWords) {
         return rawWords
           .map(function (item) {
@@ -262,17 +491,17 @@
       function assignWordColors(words, groupIndex) {
         return words.map(function (word, index) {
           var clean = word.text.toLowerCase().replace(/[^a-z]/g, "");
-          if (KEYWORDS.has(clean)) {
-            var ci = Math.floor(seededRandom(groupIndex * 23 + index * 31) * ACCENT_COLORS.length);
-            return ACCENT_COLORS[ci];
+          if (hfIsEmphasisWord(word.text)) {
+            var ci = Math.floor(seededRandom(groupIndex * 23 + index * 31) * hfAccentColors.length);
+            return hfAccentColors[ci];
           }
-          if (TRANSITION_WORDS.has(clean)) return PRIMARY_COLOR;
+          if (HF_STOPWORDS.has(clean)) return hfPrimaryColor;
           var rand = seededRandom(groupIndex * 13 + index);
           if (rand > 0.55) {
-            var ci2 = Math.floor(rand * ACCENT_COLORS.length) % ACCENT_COLORS.length;
-            return ACCENT_COLORS[ci2];
+            var ci2 = Math.floor(rand * hfAccentColors.length) % hfAccentColors.length;
+            return hfAccentColors[ci2];
           }
-          return PRIMARY_COLOR;
+          return hfPrimaryColor;
         });
       }
 
@@ -398,13 +627,14 @@
             var emojiEl = document.createElement("div");
             emojiEl.className = "caption-emoji";
             emojiEl.textContent = group.emoji;
+            emojiEl.style.fontSize = Math.round(56 * hfFontScale) + "px";
             groupEl.appendChild(emojiEl);
           }
 
           var lineEl = document.createElement("div");
           lineEl.className = "caption-line";
           group.words.forEach(function (word, wordIndex) {
-            var color = group.colors[wordIndex] || PRIMARY_COLOR;
+            var color = group.colors[wordIndex] || hfPrimaryColor;
             var wordEl = document.createElement("span");
             wordEl.className = "caption-word";
             wordEl.textContent = word.text.toUpperCase();
@@ -419,49 +649,138 @@
         });
       }
 
-      var WORDS = normalizeWords(TRANSCRIPT);
-      var GROUPS = makeGroups(WORDS);
-      buildCaptions(GROUPS);
+      function hfTeardown() {
+        document.getElementById("caption-stage").innerHTML = "";
+      }
+
+      function hfBuild(words, layout, durationS) {
+        DURATION = durationS;
+        CAPTION_FONT_SIZE = Math.round(72 * layout.fontScale);
+        SAFE_ZONE_WIDTH = Math.round(1400 * layout.scaleX);
+        WORD_SPACING = Math.round(14 * layout.fontScale);
+        hfFontScale = layout.fontScale;
+
+        var stage = document.getElementById("caption-stage");
+        var stageHeight = Math.round(280 * layout.fontScale);
+        stage.style.width = SAFE_ZONE_WIDTH + "px";
+        stage.style.height = stageHeight + "px";
+        stage.style.bottom = Math.round(80 * layout.scaleY) + "px";
+
+        var rootEl = document.getElementById(HF_ROOT_ID);
+        var primary = getComputedStyle(rootEl).getPropertyValue("--hf-caption-primary").trim();
+        var accent = getComputedStyle(rootEl).getPropertyValue("--hf-caption-accent").trim();
+        hfPrimaryColor = /^#[0-9a-f]{6}$/i.test(primary) ? primary : "#FFFFFF";
+        hfAccentColors = /^#[0-9a-f]{6}$/i.test(accent)
+          ? [accent]
+          : ["#FF76FF", "#FF0002", "#B2F7FF"];
+
+        var WORDS = normalizeWords(words);
+        var GROUPS = makeGroups(WORDS);
+        buildCaptions(GROUPS);
+        GROUPS.forEach(function (_, i) {
+          var el = document.getElementById("caption-group-" + i);
+          el.style.width = SAFE_ZONE_WIDTH + "px";
+          el.style.height = stageHeight + "px";
+        });
+
+        var tl = gsap.timeline({ paused: true });
 
-      window.__timelines = window.__timelines || {};
-      var tl = gsap.timeline({ paused: true });
+        var visibleStarts = GROUPS.map(function (group, groupIndex) {
+          var prev = GROUPS[groupIndex - 1];
+          var availableGap = prev ? Math.max(0, group.start - prev.end) : ENTRY_DURATION;
+          var entryLead = Math.min(ENTRY_DURATION, availableGap);
+          return Math.max(0, group.start - entryLead);
+        });
 
-      var visibleStarts = GROUPS.map(function (group, groupIndex) {
-        var prev = GROUPS[groupIndex - 1];
-        var availableGap = prev ? Math.max(0, group.start - prev.end) : ENTRY_DURATION;
-        var entryLead = Math.min(ENTRY_DURATION, availableGap);
-        return Math.max(0, group.start - entryLead);
-      });
+        var allGroupEls = GROUPS.map(function (_, i) {
+          return document.getElementById("caption-group-" + i);
+        });
 
-      var allGroupEls = GROUPS.map(function (_, i) {
-        return document.getElementById("caption-group-" + i);
-      });
+        GROUPS.forEach(function (group, groupIndex) {
+          var groupEl = allGroupEls[groupIndex];
+          var visibleStart = visibleStarts[groupIndex];
+          var visibleEnd =
+            groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
+          var exitStart = Math.max(visibleStart, visibleEnd - EXIT_DURATION);
 
-      GROUPS.forEach(function (group, groupIndex) {
-        var groupEl = allGroupEls[groupIndex];
-        var visibleStart = visibleStarts[groupIndex];
-        var visibleEnd = groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
-        var exitStart = Math.max(visibleStart, visibleEnd - EXIT_DURATION);
+          allGroupEls.forEach(function (otherEl, otherIndex) {
+            if (otherIndex !== groupIndex) tl.set(otherEl, { opacity: 0 }, visibleStart);
+          });
 
-        allGroupEls.forEach(function (otherEl, otherIndex) {
-          if (otherIndex !== groupIndex) tl.set(otherEl, { opacity: 0 }, visibleStart);
+          tl.set(groupEl, { opacity: 0, scaleX: 0.8, scaleY: 1 }, visibleStart);
+          tl.to(
+            groupEl,
+            { opacity: 1, scaleX: 1, duration: ENTRY_DURATION, ease: "power3.out", force3D: true },
+            visibleStart,
+          );
+          tl.to(
+            groupEl,
+            {
+              scaleX: 0.75,
+              opacity: 0.8,
+              duration: EXIT_DURATION,
+              ease: "power2.in",
+              force3D: true,
+            },
+            exitStart,
+          );
+          tl.set(groupEl, { opacity: 0 }, visibleEnd);
         });
 
-        tl.set(groupEl, { opacity: 0, scaleX: 0.8, scaleY: 1 }, visibleStart);
-        tl.to(
-          groupEl,
-          { opacity: 1, scaleX: 1, duration: ENTRY_DURATION, ease: "power3.out", force3D: true },
-          visibleStart,
-        );
-        tl.to(
-          groupEl,
-          { scaleX: 0.75, opacity: 0.8, duration: EXIT_DURATION, ease: "power2.in", force3D: true },
-          exitStart,
-        );
-        tl.set(groupEl, { opacity: 0 }, visibleEnd);
-      });
+        return tl;
+      }
 
-      window.__timelines["caption-emoji-pop"] = tl;
+      var hfCurrentTimeline = null;
+
+      function hfAttach(data) {
+        var v = hfValidate(data);
+        if (!v.ok) {
+          hfRunGate([], 0, v.reason);
+          return;
+        }
+        if (hfCurrentTimeline) {
+          hfCurrentTimeline.kill();
+          hfCurrentTimeline = null;
+        }
+        hfTeardown();
+        var layout = hfApplyStageConfig(data, v.durationS);
+        var tl = hfBuild(v.words, layout, v.durationS);
+        tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+        // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+        // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+        // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+        // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+        tl.render(0, true, true);
+        hfCurrentTimeline = tl;
+        window.__timelines = window.__timelines || {};
+        window.__timelines[HF_COMPOSITION_ID] = tl;
+        hfRunGate(v.words, v.durationS, null);
+      }
+      window.__HF_CAPTION_ATTACH__ = hfAttach;
+
+      (function hfBoot() {
+        function start(data) {
+          var ready =
+            document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+          ready.then(function () {
+            hfAttach(data);
+          });
+        }
+        if (window.__HF_CAPTION__) {
+          start(window.__HF_CAPTION__);
+          return;
+        }
+        fetch("./caption-data.json")
+          .then(function (r) {
+            return r.ok ? r.json() : null;
+          })
+          .catch(function () {
+            return null;
+          })
+          .then(function (json) {
+            start(json || HF_DEMO_DATA);
+          });
+      })();
     </script>
   </body>
 </html>

From 060b6f8ae53e8ae243d8e2c2c3afd690dbe7f99c Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 14:41:25 -0700
Subject: [PATCH 028/125] fix(engine): self-verify parallel disk drawElement
 samples (PRINFRA-352)

---
 packages/engine/src/index.ts                  |   5 +
 .../src/services/parallelCoordinator.test.ts  |  30 ++++
 .../src/services/parallelCoordinator.ts       | 139 ++++++++++++++++--
 packages/engine/src/utils/psnr.ts             |  42 ++++++
 .../render/stages/captureStreamingStage.ts    |  30 +---
 5 files changed, 212 insertions(+), 34 deletions(-)
 create mode 100644 packages/engine/src/utils/psnr.ts

diff --git a/packages/engine/src/index.ts b/packages/engine/src/index.ts
index 62ed54ab22..4741eaa3cf 100644
--- a/packages/engine/src/index.ts
+++ b/packages/engine/src/index.ts
@@ -209,6 +209,7 @@ export type {
 export {
   calculateOptimalWorkers,
   computeWorkerSizing,
+  selectVerifySampleIndicesForTask,
   distributeFrames,
   distributeFramesInterleaved,
   executeParallelCapture,
@@ -273,6 +274,10 @@ export {
 
 export { trackChildProcess, killTrackedProcesses } from "./utils/processTracker.js";
 
+// drawElement self-verify comparison — shared by the streaming drain
+// (producer) and the parallel disk-path verify (parallelCoordinator).
+export { psnrDb, resolveDeVerifyMinDb } from "./utils/psnr.js";
+
 export {
   decodePng,
   decodePngToRgb48le,
diff --git a/packages/engine/src/services/parallelCoordinator.test.ts b/packages/engine/src/services/parallelCoordinator.test.ts
index 31f7b59410..43d4386d76 100644
--- a/packages/engine/src/services/parallelCoordinator.test.ts
+++ b/packages/engine/src/services/parallelCoordinator.test.ts
@@ -6,6 +6,7 @@ import {
   expectedFramesForTask,
   flagSilentWorkerExits,
   formatWorkerFailure,
+  selectVerifySampleIndicesForTask,
   selectWorkerDiagnostics,
   shouldDisableBrowserPoolForParallelWorker,
   shouldVerifyWorkerGpu,
@@ -349,6 +350,35 @@ describe("flagSilentWorkerExits", () => {
   });
 });
 
+describe("selectVerifySampleIndicesForTask", () => {
+  it("keeps only samples inside the task's contiguous range, sorted", () => {
+    // 2-worker split of 3032 frames: worker 1 owns [1516, 3032).
+    expect(
+      selectVerifySampleIndicesForTask([2274, 758, 1516, 3031, 3032], {
+        startFrame: 1516,
+        endFrame: 3032,
+      }),
+    ).toEqual([1516, 2274, 3031]);
+  });
+
+  it("respects the stride lattice for interleaved tasks", () => {
+    // Worker 1 of a 3-way interleave over [1, 30): captures 1, 4, 7, ...
+    expect(
+      selectVerifySampleIndicesForTask([1, 2, 4, 6, 7, 28, 29], {
+        startFrame: 1,
+        endFrame: 30,
+        frameStride: 3,
+      }),
+    ).toEqual([1, 4, 7, 28]);
+  });
+
+  it("returns empty when no samples fall in the range", () => {
+    expect(
+      selectVerifySampleIndicesForTask([0, 10, 20], { startFrame: 100, endFrame: 200 }),
+    ).toEqual([]);
+  });
+});
+
 describe("shouldVerifyWorkerGpu", () => {
   const softwareConfig: Partial<EngineConfig> = { browserGpuMode: "software" };
 
diff --git a/packages/engine/src/services/parallelCoordinator.ts b/packages/engine/src/services/parallelCoordinator.ts
index 934055a70d..b46957629a 100644
--- a/packages/engine/src/services/parallelCoordinator.ts
+++ b/packages/engine/src/services/parallelCoordinator.ts
@@ -7,7 +7,7 @@
 
 import { cpus, freemem } from "os";
 import { existsSync, mkdirSync, readdirSync } from "fs";
-import { copyFile, rename } from "fs/promises";
+import { copyFile, readFile, rename } from "fs/promises";
 import { join } from "path";
 import { getHeapStatistics } from "v8";
 
@@ -19,11 +19,13 @@ import {
   captureFrameToBufferPipelined,
   captureFrameToBuffer,
   getCapturePerfSummary,
+  DrawElementVerificationError,
   type CaptureSession,
   type CaptureOptions,
   type CapturePerfSummary,
   type BeforeCaptureHook,
 } from "./frameCapture.js";
+import { psnrDb, resolveDeVerifyMinDb } from "../utils/psnr.js";
 import { DEFAULT_CONFIG, type EngineConfig } from "../config.js";
 import { assertSwiftShader } from "../utils/assertSwiftShader.js";
 import { readWebGlVendorInfoFromCanvas } from "../utils/readWebGlVendorInfoFromCanvas.js";
@@ -551,6 +553,126 @@ async function captureFrameRange(
   return framesCaptured;
 }
 
+/**
+ * The armed self-verify sample indices this task actually captured: inside
+ * `[startFrame, endFrame)` and on the task's stride lattice. Mirrors the
+ * capture loop in `captureFrameRange` (`i += stride` from `startFrame`).
+ */
+export function selectVerifySampleIndicesForTask(
+  sampleIndices: Iterable<number>,
+  task: Pick<WorkerTask, "startFrame" | "endFrame" | "frameStride">,
+): number[] {
+  const stride = task.frameStride ?? 1;
+  const selected: number[] = [];
+  for (const idx of sampleIndices) {
+    if (idx < task.startFrame || idx >= task.endFrame) continue;
+    if ((idx - task.startFrame) % stride !== 0) continue;
+    selected.push(idx);
+  }
+  return selected.sort((a, b) => a - b);
+}
+
+/**
+ * Disk-path drawElement self-verification (PRINFRA-352). Parallel DISK
+ * workers arm the same pre-injection ground-truth samples as the streaming
+ * path (`resolveParallelDeVerifySamples` even raises the density for
+ * multi-worker capture) — but only the streaming drain ever CHECKED them,
+ * so an explicit `--experimental-fast-capture --workers N` render shipped
+ * unverified drawElement frames. On a 16GB host, two concurrent
+ * hardware-GPU Chrome instances hit the documented compositor-tile-eviction
+ * damage class (frames displaced into vertical strips for one worker's
+ * whole range — reads as "corruption from the exact worker boundary").
+ *
+ * After a worker's range completes, re-read its captured files for the
+ * sampled indices and PSNR-compare against the session's ground truth.
+ * A breach throws `DrawElementVerificationError`, which the orchestrator's
+ * existing pinned-fallback retry converts into a screenshot re-render —
+ * the same recovery the streaming drain gets.
+ */
+/** HF_DE_PAR_DEBUG=1 gated per-worker trace line (message built lazily). */
+function logParDebug(message: () => string): void {
+  if (process.env.HF_DE_PAR_DEBUG === "1") console.log(message());
+}
+
+/**
+ * Throw the verification error for a sample below the PSNR floor; log the
+ * pass otherwise. Split from the sampling loop for the complexity gate.
+ */
+function assertDiskSampleAboveFloor(
+  db: number,
+  verifyMinDb: number,
+  idx: number,
+  workerId: number,
+): void {
+  if (db < verifyMinDb) {
+    // Message keeps the contiguous "drawElement self-verify" phrase —
+    // captureFailure's VERIFICATION_ERROR_PATTERNS classifies on it.
+    throw new DrawElementVerificationError(
+      `drawElement self-verify failed at frame ${idx} (disk path, worker ${workerId}): ` +
+        `${db.toFixed(1)}dB < ${verifyMinDb}dB vs pre-injection screenshot`,
+      { kind: "psnr", frameIndex: idx, failedDb: db, verifyThresholdDb: verifyMinDb },
+    );
+  }
+  console.log(
+    `[Parallel] drawElement disk self-verify passed (worker ${workerId}, frame ${idx}, ` +
+      `${db === Infinity ? "inf" : db.toFixed(1)}dB)`,
+  );
+}
+
+/**
+ * Compare one captured frame file against its ground truth. Returns the
+ * PSNR, or null on infrastructure failure (missing file already surfaces
+ * via the frame completeness check; ffmpeg spawn/tmpdir here) — a skipped
+ * sample is not damage evidence and must not fail the capture.
+ */
+async function psnrForDiskSample(
+  framePath: string,
+  truth: Buffer,
+  workerId: number,
+  idx: number,
+): Promise<number | null> {
+  try {
+    return await psnrDb(await readFile(framePath), truth);
+  } catch (err) {
+    console.warn(
+      `[Parallel] drawElement disk self-verify sample skipped (worker ${workerId}, ` +
+        `frame ${idx}): ${err instanceof Error ? err.message : String(err)}`,
+    );
+    return null;
+  }
+}
+
+// Branches are the gate conditions themselves (mode/armed/streaming guards +
+// per-sample skip/breach) — already decomposed into psnrForDiskSample +
+// assertDiskSampleAboveFloor; further splitting obscures the check.
+// fallow-ignore-next-line complexity
+async function verifyDiskDrawElementSamples(
+  session: CaptureSession,
+  task: WorkerTask,
+  streaming: boolean,
+): Promise<void> {
+  // Streaming capture verifies every sampled frame in the drain guard already.
+  if (streaming || session.captureMode !== "drawelement") return;
+  const truths = session.deVerifyFrames;
+  if (!truths || truths.size === 0) return;
+  const verifyMinDb = resolveDeVerifyMinDb();
+  const ext = session.options.format === "png" ? "png" : "jpg";
+  const offset = task.outputFrameOffset ?? 0;
+  for (const idx of selectVerifySampleIndicesForTask(truths.keys(), task)) {
+    const truth = truths.get(idx);
+    if (!truth) continue;
+    const framePath = join(task.outputDir, `frame_${String(idx - offset).padStart(6, "0")}.${ext}`);
+    const db = await psnrForDiskSample(framePath, truth, task.workerId, idx);
+    if (db === null) continue;
+    assertDiskSampleAboveFloor(db, verifyMinDb, idx, task.workerId);
+  }
+}
+
+// Inherited worker-lifecycle shape (session create → verify GPU → init →
+// capture → self-verify → perf, with a classifying catch + closing finally);
+// flagged only because the disk self-verify call shifted its line range into
+// the changed-code audit. Not restructured by this PR.
+// fallow-ignore-next-line complexity
 async function executeWorkerTask(
   task: WorkerTask,
   serverUrl: string,
@@ -590,19 +712,16 @@ async function executeWorkerTask(
       createBeforeCaptureHook(),
       workerConfig,
     );
-    if (process.env.HF_DE_PAR_DEBUG === "1") {
-      console.log(`[par:w${task.workerId}] session created`);
-    }
+    logParDebug(() => `[par:w${task.workerId}] session created`);
     // Worker-0-only SwiftShader assertion — see `shouldVerifyWorkerGpu` and #955.
     if (shouldVerifyWorkerGpu(task.workerId, workerConfig)) {
       await assertSwiftShader(session.page, readWebGlVendorInfoFromCanvas);
     }
     await initializeSession(session);
-    if (process.env.HF_DE_PAR_DEBUG === "1") {
-      console.log(
-        `[par:w${task.workerId}] init done (mode=${session.captureMode} workerEncode=${session.workerEncodeEnabled === true})`,
-      );
-    }
+    logParDebug(
+      () =>
+        `[par:w${task.workerId}] init done (mode=${session?.captureMode} workerEncode=${session?.workerEncodeEnabled === true})`,
+    );
     framesCaptured = await captureFrameRange(
       session,
       task,
@@ -612,6 +731,8 @@ async function executeWorkerTask(
       onFrameBuffer,
     );
 
+    await verifyDiskDrawElementSamples(session, task, Boolean(onFrameBuffer));
+
     perf = getCapturePerfSummary(session);
     return {
       workerId: task.workerId,
diff --git a/packages/engine/src/utils/psnr.ts b/packages/engine/src/utils/psnr.ts
new file mode 100644
index 0000000000..4d92ac110b
--- /dev/null
+++ b/packages/engine/src/utils/psnr.ts
@@ -0,0 +1,42 @@
+import { execFile } from "node:child_process";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { getFfmpegBinary } from "./ffmpegBinaries.js";
+
+const execFileP = promisify(execFile);
+
+/**
+ * PSNR (average, dB) between two same-dimension encoded images via ffmpeg.
+ * Infinity means bit-identical pixels. Single source of truth for every
+ * drawElement self-verify comparison (streaming drain + parallel disk path).
+ */
+export async function psnrDb(a: Buffer, b: Buffer): Promise<number> {
+  const dir = await mkdtemp(join(tmpdir(), "hf-de-verify-"));
+  try {
+    const pa = join(dir, "a.jpg");
+    const pb = join(dir, "b.jpg");
+    await Promise.all([writeFile(pa, a), writeFile(pb, b)]);
+    const { stderr } = await execFileP(
+      getFfmpegBinary(),
+      ["-hide_banner", "-i", pa, "-i", pb, "-lavfi", "psnr", "-f", "null", "-"],
+      { maxBuffer: 4 * 1024 * 1024 },
+    );
+    const m = /average:(inf|[\d.]+)/.exec(stderr);
+    if (!m) throw new Error(`psnr parse failed: ${stderr.slice(-300)}`);
+    return m[1] === "inf" ? Infinity : Number(m[1]);
+  } finally {
+    await rm(dir, { recursive: true, force: true }).catch(() => {});
+  }
+}
+
+/**
+ * The drawElement self-verify PSNR floor (dB). HF_DE_VERIFY_MIN_DB overrides,
+ * clamped to [10, 60]; out-of-range or unset falls back to 32 — the threshold
+ * every prior eval used to separate real compositor damage from encoder noise.
+ */
+export function resolveDeVerifyMinDb(): number {
+  const raw = Number(process.env.HF_DE_VERIFY_MIN_DB ?? "32");
+  return Number.isFinite(raw) && raw >= 10 && raw <= 60 ? raw : 32;
+}
diff --git a/packages/producer/src/services/render/stages/captureStreamingStage.ts b/packages/producer/src/services/render/stages/captureStreamingStage.ts
index 364489fe24..09a87aa861 100644
--- a/packages/producer/src/services/render/stages/captureStreamingStage.ts
+++ b/packages/producer/src/services/render/stages/captureStreamingStage.ts
@@ -41,11 +41,9 @@
  * into a shared module so the stages can import without reaching back.
  */
 
-import { execFile } from "node:child_process";
-import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { mkdtemp, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { promisify } from "node:util";
 import {
   type BeforeCaptureHook,
   type CaptureOptions,
@@ -64,7 +62,7 @@ import {
   distributeFramesInterleaved,
   executeParallelCapture,
   getCapturePerfSummary,
-  getFfmpegBinary,
+  psnrDb,
   recaptureDrawElementFrameForVerify,
   completeDeferredDrawElementInit,
   initializeSession,
@@ -223,27 +221,9 @@ export type CaptureStreamingStageResult =
       success: false;
     };
 
-const execFileP = promisify(execFile);
-
-/** PSNR (average, dB) between two same-dimension encoded images via ffmpeg. */
-async function psnrDb(a: Buffer, b: Buffer): Promise<number> {
-  const dir = await mkdtemp(join(tmpdir(), "hf-de-verify-"));
-  try {
-    const pa = join(dir, "a.jpg");
-    const pb = join(dir, "b.jpg");
-    await Promise.all([writeFile(pa, a), writeFile(pb, b)]);
-    const { stderr } = await execFileP(
-      getFfmpegBinary(),
-      ["-hide_banner", "-i", pa, "-i", pb, "-lavfi", "psnr", "-f", "null", "-"],
-      { maxBuffer: 4 * 1024 * 1024 },
-    );
-    const m = /average:(inf|[\d.]+)/.exec(stderr);
-    if (!m) throw new Error(`psnr parse failed: ${stderr.slice(-300)}`);
-    return m[1] === "inf" ? Infinity : Number(m[1]);
-  } finally {
-    await rm(dir, { recursive: true, force: true }).catch(() => {});
-  }
-}
+// psnrDb moved to @hyperframes/engine (utils/psnr.ts) so the parallel
+// disk-path verify (parallelCoordinator) and this drain guard share one
+// comparison implementation.
 
 // ── drawElement drain-time safety checks (ungated-release safety net) ──
 // Shared by the sequential worker-encode loop and the interleaved parallel

From 7d4e71d10b617b858fde2e764e15d530e9ffdf19 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 21:52:56 +0000
Subject: [PATCH 029/125] feat(registry): make caption-highlight data-driven
 with automatic grouping

Replaces the hardcoded RAW_GROUPS index-pair array with hfMakeGroups, a
real fitting/pause/punctuation-based grouper, and wires the component
into the shared caption-data runtime (validate/gate/attach). Adds CSS
brand hooks: .hl-word text color from --hf-caption-primary, .hl-word-bg
gradient from --hf-caption-accent (second stop via color-mix()).
---
 .../caption-highlight/caption-highlight.html  | 462 ++++++++++++++----
 1 file changed, 356 insertions(+), 106 deletions(-)

diff --git a/registry/components/caption-highlight/caption-highlight.html b/registry/components/caption-highlight/caption-highlight.html
index 2617005887..b53e981803 100644
--- a/registry/components/caption-highlight/caption-highlight.html
+++ b/registry/components/caption-highlight/caption-highlight.html
@@ -73,7 +73,7 @@
         font-weight: 800;
         font-size: 80px;
         text-transform: uppercase;
-        color: #ffffff;
+        color: var(--hf-caption-primary, #ffffff);
         display: inline-block;
         letter-spacing: 0.02em;
         line-height: 1;
@@ -86,7 +86,11 @@
       .hl-word-bg {
         position: absolute;
         inset: 0;
-        background: linear-gradient(135deg, #ff1745 0%, #df1238 100%);
+        background: linear-gradient(
+          135deg,
+          var(--hf-caption-accent, #ff1745) 0%,
+          color-mix(in srgb, var(--hf-caption-accent, #ff1745) 82%, #000) 100%
+        );
         border-radius: 10px;
         box-shadow: 0 12px 30px rgba(229, 20, 58, 0.32);
         opacity: 0;
@@ -117,6 +121,10 @@
 
     <script>
       (function () {
+        var HF_COMPOSITION_ID = "caption-highlight";
+        var HF_ROOT_ID = "highlight";
+        var HF_GROUP_SELECTOR = ".hl-group";
+
         window.__timelines = window.__timelines || {};
 
         var _fitCanvas = document.createElement("canvas");
@@ -132,129 +140,371 @@
           return minSize;
         }
 
-        var WORDS = [
-          { text: "Every", start: 0.0, end: 0.3 },
-          { text: "great", start: 0.3, end: 0.55 },
-          { text: "video", start: 0.55, end: 0.85 },
-          { text: "starts", start: 0.85, end: 1.1 },
-          { text: "with", start: 1.1, end: 1.25 },
-          { text: "a", start: 1.25, end: 1.35 },
-          { text: "single", start: 1.35, end: 1.65 },
-          { text: "frame.", start: 1.65, end: 2.0 },
-          { text: "HyperFrames", start: 2.1, end: 2.65 },
-          { text: "lets", start: 2.65, end: 2.85 },
-          { text: "you", start: 2.85, end: 2.95 },
-          { text: "write", start: 2.95, end: 3.15 },
-          { text: "HTML", start: 3.15, end: 3.55 },
-          { text: "and", start: 3.55, end: 3.65 },
-          { text: "render", start: 3.65, end: 3.95 },
-          { text: "professional", start: 3.95, end: 4.45 },
-          { text: "video.", start: 4.45, end: 4.8 },
-          { text: "No", start: 4.9, end: 5.05 },
-          { text: "timeline.", start: 5.05, end: 5.45 },
-          { text: "No", start: 5.5, end: 5.65 },
-          { text: "drag", start: 5.65, end: 5.85 },
-          { text: "and", start: 5.85, end: 5.95 },
-          { text: "drop.", start: 5.95, end: 6.25 },
-          { text: "Just", start: 6.35, end: 6.55 },
-          { text: "code", start: 6.55, end: 6.8 },
-          { text: "that", start: 6.8, end: 6.95 },
-          { text: "becomes", start: 6.95, end: 7.3 },
-          { text: "cinema.", start: 7.3, end: 7.7 },
-        ];
+        var HF_DEMO_DATA = {
+          version: 1,
+          segments: [
+            {
+              start: 0,
+              text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+              words: [
+                { text: "Every", start: 0.0, end: 0.3 },
+                { text: "great", start: 0.3, end: 0.55 },
+                { text: "video", start: 0.55, end: 0.85 },
+                { text: "starts", start: 0.85, end: 1.1 },
+                { text: "with", start: 1.1, end: 1.25 },
+                { text: "a", start: 1.25, end: 1.35 },
+                { text: "single", start: 1.35, end: 1.65 },
+                { text: "frame.", start: 1.65, end: 2.0 },
+                { text: "HyperFrames", start: 2.1, end: 2.65 },
+                { text: "lets", start: 2.65, end: 2.85 },
+                { text: "you", start: 2.85, end: 2.95 },
+                { text: "write", start: 2.95, end: 3.15 },
+                { text: "HTML", start: 3.15, end: 3.55 },
+                { text: "and", start: 3.55, end: 3.65 },
+                { text: "render", start: 3.65, end: 3.95 },
+                { text: "professional", start: 3.95, end: 4.45 },
+                { text: "video.", start: 4.45, end: 4.8 },
+                { text: "No", start: 4.9, end: 5.05 },
+                { text: "timeline.", start: 5.05, end: 5.45 },
+                { text: "No", start: 5.5, end: 5.65 },
+                { text: "drag", start: 5.65, end: 5.85 },
+                { text: "and", start: 5.85, end: 5.95 },
+                { text: "drop.", start: 5.95, end: 6.25 },
+                { text: "Just", start: 6.35, end: 6.55 },
+                { text: "code", start: 6.55, end: 6.8 },
+                { text: "that", start: 6.8, end: 6.95 },
+                { text: "becomes", start: 6.95, end: 7.3 },
+                { text: "cinema.", start: 7.3, end: 7.7 },
+              ],
+            },
+          ],
+        };
 
-        var RAW_GROUPS = [
-          [0, 3],
-          [4, 7],
-          [8, 8],
-          [9, 12],
-          [13, 15],
-          [16, 16],
-          [17, 19],
-          [20, 22],
-          [23, 24],
-          [25, 27],
-        ];
-        var GROUPS = RAW_GROUPS.map(function (pair, gi) {
-          var ws = pair[0],
-            we = pair[1];
-          var nextStart = gi + 1 < RAW_GROUPS.length ? WORDS[RAW_GROUPS[gi + 1][0]].start : 8.0;
-          var gEnd = Math.min(WORDS[we].end + 0.5, nextStart - 0.05);
-          return { wordStart: ws, wordEnd: we, start: WORDS[ws].start, end: gEnd };
-        });
+        /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+        var HF_CONTRACT_VERSION = 1;
+        var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
 
-        var container = document.getElementById("hl-container");
-        var tl = gsap.timeline({ paused: true });
+        function hfFlattenSegments(segments) {
+          var out = [];
+          (segments || []).forEach(function (seg) {
+            ((seg && seg.words) || []).forEach(function (w) {
+              var start = Math.max(0, Number(w.start) || 0);
+              out.push({
+                text: String(w.word || w.text || "").trim(),
+                start: start,
+                end: Math.max(start, Number(w.end) || 0),
+              });
+            });
+          });
+          out.sort(function (a, b) {
+            return a.start - b.start;
+          });
+          return out.filter(function (w) {
+            return w.text.length > 0;
+          });
+        }
 
-        GROUPS.forEach(function (g, gi) {
-          var groupWords = WORDS.slice(g.wordStart, g.wordEnd + 1);
-          var grp = document.createElement("div");
-          grp.className = "hl-group";
-          grp.id = "hl-grp-" + gi;
+        function hfDeriveDuration(words) {
+          var end = 0;
+          words.forEach(function (w) {
+            if (w.end > end) end = w.end;
+          });
+          return end;
+        }
 
-          var groupText = groupWords
-            .map(function (w) {
-              return w.text.toUpperCase();
-            })
-            .join(" ");
-          var computedSize = fitFontSize(groupText, 80, "800", "Montserrat", 1620);
+        function hfValidate(data) {
+          if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+            return { ok: false, reason: "unsupported-version" };
+          }
+          if (!Array.isArray(data.segments) || data.segments.length === 0) {
+            return { ok: false, reason: "no-segments" };
+          }
+          if (data.displayMode != null && data.displayMode !== "full") {
+            return { ok: false, reason: "unsupported-displayMode" };
+          }
+          var words = hfFlattenSegments(data.segments);
+          if (words.length === 0) return { ok: false, reason: "no-words" };
+          return { ok: true, words: words, durationS: hfDeriveDuration(words) };
+        }
+
+        function hfApplyStageConfig(data, durationS) {
+          var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          var root = document.getElementById(HF_ROOT_ID);
+          [document.documentElement, document.body, root].forEach(function (el) {
+            el.style.width = W + "px";
+            el.style.height = H + "px";
+          });
+          root.setAttribute("data-width", String(W));
+          root.setAttribute("data-height", String(H));
+          root.setAttribute("data-duration", String(durationS));
+          var brand = (data && data.brand) || {};
+          if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+            root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+          }
+          if (typeof brand.accentColor === "string" && brand.accentColor) {
+            root.style.setProperty("--hf-caption-accent", brand.accentColor);
+          }
+          return {
+            W: W,
+            H: H,
+            scaleX: W / 1920,
+            scaleY: H / 1080,
+            fontScale: Math.min(W, H) / 1080,
+          };
+        }
 
-          groupWords.forEach(function (w, i) {
-            var wi = g.wordStart + i;
-            var wordEl = document.createElement("span");
-            wordEl.className = "hl-word";
-            wordEl.id = "hl-w-" + wi;
-            wordEl.style.fontSize = computedSize + "px";
+        function hfPublishStatus(status) {
+          window.__HF_CAPTION_STATUS = status;
+          document
+            .getElementById(HF_ROOT_ID)
+            .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+        }
 
-            var bgEl = document.createElement("span");
-            bgEl.className = "hl-word-bg";
-            bgEl.id = "hl-bg-" + wi;
+        function hfRunGate(words, durationS, failReason) {
+          if (failReason) {
+            hfPublishStatus({
+              ok: false,
+              present: false,
+              contained: false,
+              reason: failReason,
+              version: HF_CONTRACT_VERSION,
+              durationS: durationS || 0,
+            });
+            return;
+          }
+          var root = document.getElementById(HF_ROOT_ID);
+          var rootRect = root.getBoundingClientRect();
+          var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+          var present = false;
+          var contained = true;
+          var tokens = [];
+          words.forEach(function (w) {
+            var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+            if (t) tokens.push(t);
+          });
+          groups.forEach(function (el) {
+            var prevOpacity = el.style.opacity;
+            var prevVisibility = el.style.visibility;
+            el.style.opacity = "1";
+            el.style.visibility = "visible";
+            var r = el.getBoundingClientRect();
+            if (r.width > 0 && r.height > 0) {
+              var text = (el.textContent || "").toLowerCase();
+              for (var i = 0; i < tokens.length; i++) {
+                if (text.indexOf(tokens[i]) !== -1) {
+                  present = true;
+                  break;
+                }
+              }
+              if (
+                r.left < rootRect.left - 1 ||
+                r.right > rootRect.right + 1 ||
+                r.top < rootRect.top - 1 ||
+                r.bottom > rootRect.bottom + 1
+              ) {
+                contained = false;
+              }
+            }
+            el.style.opacity = prevOpacity;
+            el.style.visibility = prevVisibility;
+          });
+          hfPublishStatus({
+            ok: present && contained,
+            present: present,
+            contained: contained,
+            version: HF_CONTRACT_VERSION,
+            durationS: durationS,
+          });
+        }
 
-            var textEl = document.createElement("span");
-            textEl.className = "hl-word-text";
-            textEl.textContent = w.text.toUpperCase();
+        var MAX_WORDS_PER_GROUP = 4;
+        var PAUSE_THRESHOLD = 0.1;
 
-            wordEl.appendChild(bgEl);
-            wordEl.appendChild(textEl);
-            grp.appendChild(wordEl);
+        function hfMakeGroups(words, fontPx, safeWidth, durationS) {
+          var raw = [];
+          var current = [];
+          function fits(ws) {
+            var text = ws
+              .map(function (w) {
+                return w.text.toUpperCase();
+              })
+              .join(" ");
+            _fitCtx.font = "800 " + fontPx + "px Montserrat";
+            // 1.6× headroom: fitFontSize can shrink to 45% of base
+            return _fitCtx.measureText(text).width <= safeWidth * 1.6;
+          }
+          words.forEach(function (w, i) {
+            var next = words[i + 1];
+            var test = current.concat([w]);
+            if (test.length > MAX_WORDS_PER_GROUP || !fits(test)) {
+              if (current.length) raw.push(current);
+              current = [w];
+            } else {
+              current.push(w);
+            }
+            var punctuation = /[,.:!?]$/.test(w.text);
+            var pause = next ? next.start - w.end : Infinity;
+            if (
+              current.length &&
+              (punctuation ||
+                pause >= PAUSE_THRESHOLD ||
+                current.length >= MAX_WORDS_PER_GROUP ||
+                !next)
+            ) {
+              raw.push(current);
+              current = [];
+            }
+          });
+          if (current.length) raw.push(current);
+          return raw.map(function (ws, gi) {
+            var nextStart = gi + 1 < raw.length ? raw[gi + 1][0].start : durationS;
+            return {
+              words: ws,
+              start: ws[0].start,
+              end: Math.min(
+                ws[ws.length - 1].end + 0.5,
+                Math.max(ws[0].start + 0.2, nextStart - 0.05),
+              ),
+            };
           });
+        }
 
-          container.appendChild(grp);
+        function hfTeardown() {
+          document.getElementById("hl-container").innerHTML = "";
+        }
 
-          tl.set(grp, { visibility: "visible" }, g.start);
-          tl.fromTo(
-            grp,
-            { opacity: 0 },
-            { opacity: 1, duration: 0.12, ease: "power2.out" },
-            g.start,
-          );
+        function hfBuild(words, layout, durationS) {
+          var fontPx = Math.round(80 * layout.fontScale);
+          var safeWidth = Math.round(1620 * layout.scaleX);
+          var container = document.getElementById("hl-container");
+          var groups = hfMakeGroups(words, fontPx, safeWidth, durationS);
+          var tl = gsap.timeline({ paused: true });
+          var wordCounter = 0;
 
-          groupWords.forEach(function (w, i) {
-            var wi = g.wordStart + i;
-            var bgEl = document.getElementById("hl-bg-" + wi);
-            var wordEl = document.getElementById("hl-w-" + wi);
+          groups.forEach(function (g, gi) {
+            var grp = document.createElement("div");
+            grp.className = "hl-group";
+            grp.id = "hl-grp-" + gi;
+            grp.style.bottom = Math.round(140 * layout.scaleY) + "px";
+            grp.style.paddingLeft = Math.round(100 * layout.scaleX) + "px";
+            grp.style.paddingRight = Math.round(100 * layout.scaleX) + "px";
 
-            tl.to(bgEl, { opacity: 1, scaleX: 1, duration: 0.15, ease: "power2.out" }, w.start);
-            tl.to(
-              wordEl,
-              { filter: "brightness(1.05)", duration: 0.08, ease: "power2.out" },
-              w.start,
+            var groupText = g.words
+              .map(function (w) {
+                return w.text.toUpperCase();
+              })
+              .join(" ");
+            var computedSize = fitFontSize(groupText, fontPx, "800", "Montserrat", safeWidth);
+
+            var ids = [];
+            g.words.forEach(function (w) {
+              var wi = wordCounter++;
+              ids.push(wi);
+              var wordEl = document.createElement("span");
+              wordEl.className = "hl-word";
+              wordEl.id = "hl-w-" + wi;
+              wordEl.style.fontSize = computedSize + "px";
+              var bgEl = document.createElement("span");
+              bgEl.className = "hl-word-bg";
+              bgEl.id = "hl-bg-" + wi;
+              var textEl = document.createElement("span");
+              textEl.className = "hl-word-text";
+              textEl.textContent = w.text.toUpperCase();
+              wordEl.appendChild(bgEl);
+              wordEl.appendChild(textEl);
+              grp.appendChild(wordEl);
+            });
+            container.appendChild(grp);
+
+            tl.set(grp, { visibility: "visible" }, g.start);
+            tl.fromTo(
+              grp,
+              { opacity: 0 },
+              { opacity: 1, duration: 0.12, ease: "power2.out" },
+              g.start,
             );
+            g.words.forEach(function (w, i) {
+              var bgEl = document.getElementById("hl-bg-" + ids[i]);
+              var wordEl = document.getElementById("hl-w-" + ids[i]);
+              tl.to(bgEl, { opacity: 1, scaleX: 1, duration: 0.15, ease: "power2.out" }, w.start);
+              tl.to(
+                wordEl,
+                { filter: "brightness(1.05)", duration: 0.08, ease: "power2.out" },
+                w.start,
+              );
+              tl.to(
+                wordEl,
+                { filter: "brightness(1)", duration: 0.16, ease: "power2.out" },
+                w.start + 0.08,
+              );
+              tl.to(bgEl, { opacity: 0, scaleX: 1.02, duration: 0.1, ease: "power2.in" }, w.end);
+              tl.set(bgEl, { scaleX: 0 }, w.end + 0.1);
+            });
             tl.to(
-              wordEl,
-              { filter: "brightness(1)", duration: 0.16, ease: "power2.out" },
-              w.start + 0.08,
+              grp,
+              { opacity: 0, duration: 0.1, ease: "power2.in" },
+              Math.max(g.start, g.end - 0.1),
             );
-            tl.to(bgEl, { opacity: 0, scaleX: 1.02, duration: 0.1, ease: "power2.in" }, w.end);
-            tl.set(bgEl, { scaleX: 0 }, w.end + 0.1);
+            tl.set(grp, { opacity: 0, visibility: "hidden" }, g.end);
           });
 
-          tl.to(grp, { opacity: 0, duration: 0.1, ease: "power2.in" }, g.end - 0.1);
-          tl.set(grp, { opacity: 0, visibility: "hidden" }, g.end);
-        });
+          return tl;
+        }
+
+        var hfCurrentTimeline = null;
+
+        function hfAttach(data) {
+          var v = hfValidate(data);
+          if (!v.ok) {
+            hfRunGate([], 0, v.reason);
+            return;
+          }
+          if (hfCurrentTimeline) {
+            hfCurrentTimeline.kill();
+            hfCurrentTimeline = null;
+          }
+          hfTeardown();
+          var layout = hfApplyStageConfig(data, v.durationS);
+          var tl = hfBuild(v.words, layout, v.durationS);
+          tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+          // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+          // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+          // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+          // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+          tl.render(0, true, true);
+          hfCurrentTimeline = tl;
+          window.__timelines = window.__timelines || {};
+          window.__timelines[HF_COMPOSITION_ID] = tl;
+          hfRunGate(v.words, v.durationS, null);
+        }
+        window.__HF_CAPTION_ATTACH__ = hfAttach;
 
-        tl.seek(0);
-        window.__timelines["caption-highlight"] = tl;
+        (function hfBoot() {
+          function start(data) {
+            var ready =
+              document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+            ready.then(function () {
+              hfAttach(data);
+            });
+          }
+          if (window.__HF_CAPTION__) {
+            start(window.__HF_CAPTION__);
+            return;
+          }
+          fetch("./caption-data.json")
+            .then(function (r) {
+              return r.ok ? r.json() : null;
+            })
+            .catch(function () {
+              return null;
+            })
+            .then(function (json) {
+              start(json || HF_DEMO_DATA);
+            });
+        })();
       })();
     </script>
   </body>

From ec791e91d97c0070502c4ad208923d4f98005846 Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 15:00:26 -0700
Subject: [PATCH 030/125] fix(producer): screenshot-retry recovery for
 disk-path drawElement verify failures

---
 .../src/services/render/capturePlan.ts        |  12 ++
 .../src/services/renderOrchestrator.ts        | 109 ++++++++++++++----
 2 files changed, 96 insertions(+), 25 deletions(-)

diff --git a/packages/producer/src/services/render/capturePlan.ts b/packages/producer/src/services/render/capturePlan.ts
index d704f4f952..6e04857124 100644
--- a/packages/producer/src/services/render/capturePlan.ts
+++ b/packages/producer/src/services/render/capturePlan.ts
@@ -124,6 +124,18 @@ function revertedRouting(routing: CaptureRouting): CaptureRouting {
 
 /** Pure, exhaustive capture fallback transition. The input plan is never mutated. */
 export function replanAfterFailure(plan: CapturePlan, failure: CapturePlanFailure): CapturePlan {
+  // Disk-path drawElement self-verification (parallel disk workers under the
+  // explicit fast-capture opt-in) can also trip — the retry stays on the disk
+  // path but forces the screenshot baseline.
+  if (plan.kind === "sdr_disk" && failure.kind === "draw_element_verification") {
+    return createCapturePlan({
+      ...plan,
+      forceScreenshot: true,
+      useStreamingEncode: false,
+      useLayeredComposite: false,
+      forceParallelStream: false,
+    });
+  }
   if (plan.kind !== "sdr_streaming") {
     throw new Error(`Cannot apply ${failure.kind} to ${plan.kind} capture plan`);
   }
diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index db47fb4c18..d903f36c28 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -109,6 +109,7 @@ import {
   createCapturePlan,
   replanAfterFailure,
   type CapturePlan,
+  type SdrDiskCapturePlan,
   type CaptureRouting,
 } from "./render/capturePlan.js";
 import { normalizeErrorMessage } from "../utils/errorMessage.js";
@@ -3144,34 +3145,92 @@ async function executeRenderPipeline(input: {
         if (capturePlan.kind !== "sdr_disk") {
           throw new Error(`Disk capture requires sdr_disk plan; got ${capturePlan.kind}`);
         }
-        const diskPlan = capturePlan;
         // ── Disk-based capture (original flow) ────────────────────────────
         resetCaptureAttemptProgress(job);
         const captureFrameStart = Date.now();
-        const captureRes = await observeRenderStage(
-          observability,
-          "capture_disk",
-          captureStageObservationData({ needsAlpha: diskPlan.needsAlpha }),
-          () =>
-            runCaptureStage({
-              fileServer: activeFileServer,
-              workDir,
-              framesDir,
-              job,
-              totalFrames,
-              cfg,
-              plan: diskPlan,
-              log,
-              probeSession,
-              captureAttempts,
-              dedupPerfs,
-              buildCaptureOptions,
-              createRenderVideoFrameInjector,
-              abortSignal: executionSignal,
-              assertNotAborted,
-              onProgress,
-            }),
-        );
+        const invokeDiskCapture = (diskPlan: SdrDiskCapturePlan) =>
+          observeRenderStage(
+            observability,
+            "capture_disk",
+            captureStageObservationData({ needsAlpha: diskPlan.needsAlpha }),
+            () =>
+              runCaptureStage({
+                fileServer: activeFileServer,
+                workDir,
+                framesDir,
+                job,
+                totalFrames,
+                cfg,
+                plan: diskPlan,
+                log,
+                probeSession,
+                captureAttempts,
+                dedupPerfs,
+                buildCaptureOptions,
+                createRenderVideoFrameInjector,
+                abortSignal: executionSignal,
+                assertNotAborted,
+                onProgress,
+              }),
+          );
+        let captureRes;
+        try {
+          captureRes = await invokeDiskCapture(capturePlan);
+        } catch (err) {
+          // Disk-path drawElement self-verification tripped (a parallel disk
+          // worker's sampled frame diverged from its pre-injection ground
+          // truth — reachable only under the explicit fast-capture opt-in).
+          // Same recovery contract as the streaming drain: re-render on the
+          // screenshot baseline. Anything else keeps its existing semantics.
+          if (
+            !isDrawElementVerificationError(err) ||
+            err instanceof RenderCancelledError ||
+            executionSignal?.aborted === true
+          ) {
+            throw err;
+          }
+          const verifyDetails = getDrawElementVerificationDetails(err);
+          deSelfVerifyFallback = true;
+          deFallbackReason = verifyDetails?.kind ?? "psnr";
+          deFallbackFailedDb = roundDb(verifyDetails?.failedDb);
+          deFallbackFrameIndex = verifyDetails?.frameIndex;
+          deFallbackThresholdDb = roundDb(verifyDetails?.verifyThresholdDb);
+          log.warn(
+            "[Render] drawElement self-verification failed on the parallel disk path; " +
+              "re-rendering via screenshot",
+            { error: err instanceof Error ? err.message : String(err) },
+          );
+          observability.checkpoint(
+            "capture_disk",
+            "drawElement self-verify failed; retrying with forceScreenshot",
+          );
+          // The failed attempt's frames are untrusted BUT satisfy the
+          // completeness check — wipe them so the retry re-captures everything
+          // instead of silently keeping damaged files.
+          rmSync(framesDir, { recursive: true, force: true });
+          mkdirSync(framesDir, { recursive: true });
+          resetCaptureAttemptProgress(job);
+          dedupPerfs.length = 0;
+          cfg.useDrawElement = false;
+          probeSession = null;
+          capturePlan = replanAfterFailure(capturePlan, { kind: "draw_element_verification" });
+          syncCapturePlan();
+          updateCaptureObservability({
+            forceScreenshot: capturePlan.forceScreenshot,
+            deSelfVerifyFallback,
+            deFallbackReason,
+            deFallbackFailedDb,
+            deFallbackFrameIndex,
+            deFallbackThresholdDb,
+          });
+          if (capturePlan.kind !== "sdr_disk") {
+            throw new Error(`Disk verify retry requires sdr_disk plan; got ${capturePlan.kind}`);
+          }
+          captureRes = await invokeDiskCapture(capturePlan);
+          // The first attempt's error marked the phase failed; the retry
+          // recovered it — don't brand the render as failed in telemetry.
+          observability.clearFailure("capture_disk");
+        }
         const captureFrameMs = Date.now() - captureFrameStart;
         workerCount = captureRes.workerCount;
         updateCaptureObservability({ workerCount });

From 9fc1c2f15990fc44f50533362bec2f075aa1d53d Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 15:07:35 -0700
Subject: [PATCH 031/125] fix(producer): verify sequential disk drawElement
 samples too

---
 packages/engine/src/index.ts                  |  1 +
 .../src/services/parallelCoordinator.ts       |  2 +-
 .../services/render/stages/captureStage.ts    | 19 +++++++++++++++++++
 3 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/packages/engine/src/index.ts b/packages/engine/src/index.ts
index 4741eaa3cf..5996ee7a29 100644
--- a/packages/engine/src/index.ts
+++ b/packages/engine/src/index.ts
@@ -210,6 +210,7 @@ export {
   calculateOptimalWorkers,
   computeWorkerSizing,
   selectVerifySampleIndicesForTask,
+  verifyDiskDrawElementSamples,
   distributeFrames,
   distributeFramesInterleaved,
   executeParallelCapture,
diff --git a/packages/engine/src/services/parallelCoordinator.ts b/packages/engine/src/services/parallelCoordinator.ts
index b46957629a..3ee1bb637f 100644
--- a/packages/engine/src/services/parallelCoordinator.ts
+++ b/packages/engine/src/services/parallelCoordinator.ts
@@ -646,7 +646,7 @@ async function psnrForDiskSample(
 // per-sample skip/breach) — already decomposed into psnrForDiskSample +
 // assertDiskSampleAboveFloor; further splitting obscures the check.
 // fallow-ignore-next-line complexity
-async function verifyDiskDrawElementSamples(
+export async function verifyDiskDrawElementSamples(
   session: CaptureSession,
   task: WorkerTask,
   streaming: boolean,
diff --git a/packages/producer/src/services/render/stages/captureStage.ts b/packages/producer/src/services/render/stages/captureStage.ts
index 808b00bffe..005eae259f 100644
--- a/packages/producer/src/services/render/stages/captureStage.ts
+++ b/packages/producer/src/services/render/stages/captureStage.ts
@@ -44,6 +44,7 @@ import {
   type EngineConfig,
   captureFrame,
   captureFrameToBufferPipelined,
+  verifyDiskDrawElementSamples,
   writeCapturedFrame,
   closeCaptureSession,
   completeDeferredDrawElementInit,
@@ -331,6 +332,24 @@ export async function runCaptureStage(input: CaptureStageInput): Promise<Capture
           reportFrame(i);
         }
       }
+      // Sequential disk drawElement self-verification (PRINFRA-352 follow-up):
+      // the sequential disk path — reachable under the explicit fast-capture
+      // opt-in, including via probe-session reuse — armed ground-truth samples
+      // but never checked them, exactly like the parallel disk workers before
+      // #2749. Same synthetic-task shape the parallel verify uses; a breach
+      // throws DrawElementVerificationError and the orchestrator's disk-stage
+      // retry re-renders via screenshot.
+      await verifyDiskDrawElementSamples(
+        session,
+        {
+          workerId: 0,
+          startFrame: rangeStart,
+          endFrame: rangeEnd,
+          outputDir: framesDir,
+          outputFrameOffset: rangeStart,
+        },
+        false,
+      );
       // Capture the sequential session's static-dedup perf before close (the
       // counters are valid only while the session is live).
       dedupPerfs.push(getCapturePerfSummary(session));

From ed8973952dda2aa43931e0ffa05b3fc6ba0cb1cb Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 22:15:26 +0000
Subject: [PATCH 032/125] feat(registry): make caption-editorial-emphasis
 data-driven with emphasis heuristic

Replaces the hand-authored BLOCKS literal with hfMakeBlocks, a heuristic that
groups words into blocks/lines from timing (pauses, punctuation, max words per
block) and hfIsEmphasisWord (long, non-stopword content words) to decide which
word gets the large Playfair Display emphasis treatment and its own slide-in
line. computeLineSize/buildBlocks/fitBlocks and timeline construction now live
inside hfBuild, closing over layout-scaled font sizes and widths. Adds the
shared Blocks A-E caption-data runtime (attach/gate/brand config) and the
.word/.word--emphasis CSS brand hook for --hf-caption-primary. This is the
last of the five caption identities to go data-driven.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .../caption-editorial-emphasis.html           | 747 ++++++++++++------
 1 file changed, 512 insertions(+), 235 deletions(-)

diff --git a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
index 50b41a1220..281c3aae76 100644
--- a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
+++ b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
@@ -80,7 +80,7 @@
 
       .word {
         display: inline-block;
-        color: #f5f0d0;
+        color: var(--hf-caption-primary, #f5f0d0);
         text-shadow:
           0 2px 12px rgba(0, 0, 0, 0.6),
           0 4px 24px rgba(0, 0, 0, 0.35);
@@ -108,7 +108,7 @@
         font-weight: 800;
         font-style: italic;
         line-height: 0.9;
-        color: #f5f0d0;
+        color: var(--hf-caption-primary, #f5f0d0);
       }
     </style>
   </head>
@@ -129,8 +129,276 @@
     </div>
 
     <script>
-      var DURATION = 8;
-      var SAFE_WIDTH = 1800;
+      var HF_COMPOSITION_ID = "caption-editorial-emphasis";
+      var HF_ROOT_ID = "editorial-emphasis";
+      var HF_GROUP_SELECTOR = ".caption-block";
+
+      var HF_DEMO_DATA = {
+        version: 1,
+        segments: [
+          {
+            start: 0,
+            text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+            words: [
+              { text: "Every", start: 0.0, end: 0.3 },
+              { text: "great", start: 0.3, end: 0.55 },
+              { text: "video", start: 0.55, end: 0.85 },
+              { text: "starts", start: 0.85, end: 1.1 },
+              { text: "with", start: 1.1, end: 1.25 },
+              { text: "a", start: 1.25, end: 1.35 },
+              { text: "single", start: 1.35, end: 1.65 },
+              { text: "frame.", start: 1.65, end: 2.0 },
+              { text: "HyperFrames", start: 2.1, end: 2.65 },
+              { text: "lets", start: 2.65, end: 2.85 },
+              { text: "you", start: 2.85, end: 2.95 },
+              { text: "write", start: 2.95, end: 3.15 },
+              { text: "HTML", start: 3.15, end: 3.55 },
+              { text: "and", start: 3.55, end: 3.65 },
+              { text: "render", start: 3.65, end: 3.95 },
+              { text: "professional", start: 3.95, end: 4.45 },
+              { text: "video.", start: 4.45, end: 4.8 },
+              { text: "No", start: 4.9, end: 5.05 },
+              { text: "timeline.", start: 5.05, end: 5.45 },
+              { text: "No", start: 5.5, end: 5.65 },
+              { text: "drag", start: 5.65, end: 5.85 },
+              { text: "and", start: 5.85, end: 5.95 },
+              { text: "drop.", start: 5.95, end: 6.25 },
+              { text: "Just", start: 6.35, end: 6.55 },
+              { text: "code", start: 6.55, end: 6.8 },
+              { text: "that", start: 6.8, end: 6.95 },
+              { text: "becomes", start: 6.95, end: 7.3 },
+              { text: "cinema.", start: 7.3, end: 7.7 },
+            ],
+          },
+        ],
+      };
+
+      /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+      var HF_CONTRACT_VERSION = 1;
+      var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
+
+      function hfFlattenSegments(segments) {
+        var out = [];
+        (segments || []).forEach(function (seg) {
+          ((seg && seg.words) || []).forEach(function (w) {
+            var start = Math.max(0, Number(w.start) || 0);
+            out.push({
+              text: String(w.word || w.text || "").trim(),
+              start: start,
+              end: Math.max(start, Number(w.end) || 0),
+            });
+          });
+        });
+        out.sort(function (a, b) {
+          return a.start - b.start;
+        });
+        return out.filter(function (w) {
+          return w.text.length > 0;
+        });
+      }
+
+      function hfDeriveDuration(words) {
+        var end = 0;
+        words.forEach(function (w) {
+          if (w.end > end) end = w.end;
+        });
+        return end;
+      }
+
+      function hfValidate(data) {
+        if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+        if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+          return { ok: false, reason: "unsupported-version" };
+        }
+        if (!Array.isArray(data.segments) || data.segments.length === 0) {
+          return { ok: false, reason: "no-segments" };
+        }
+        if (data.displayMode != null && data.displayMode !== "full") {
+          return { ok: false, reason: "unsupported-displayMode" };
+        }
+        var words = hfFlattenSegments(data.segments);
+        if (words.length === 0) return { ok: false, reason: "no-words" };
+        return { ok: true, words: words, durationS: hfDeriveDuration(words) };
+      }
+
+      function hfApplyStageConfig(data, durationS) {
+        var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+        var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+        var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+        var root = document.getElementById(HF_ROOT_ID);
+        [document.documentElement, document.body, root].forEach(function (el) {
+          el.style.width = W + "px";
+          el.style.height = H + "px";
+        });
+        root.setAttribute("data-width", String(W));
+        root.setAttribute("data-height", String(H));
+        root.setAttribute("data-duration", String(durationS));
+        var brand = (data && data.brand) || {};
+        if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+          root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+        }
+        if (typeof brand.accentColor === "string" && brand.accentColor) {
+          root.style.setProperty("--hf-caption-accent", brand.accentColor);
+        }
+        return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
+      }
+
+      function hfPublishStatus(status) {
+        window.__HF_CAPTION_STATUS = status;
+        document
+          .getElementById(HF_ROOT_ID)
+          .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+      }
+
+      function hfRunGate(words, durationS, failReason) {
+        if (failReason) {
+          hfPublishStatus({
+            ok: false,
+            present: false,
+            contained: false,
+            reason: failReason,
+            version: HF_CONTRACT_VERSION,
+            durationS: durationS || 0,
+          });
+          return;
+        }
+        var root = document.getElementById(HF_ROOT_ID);
+        var rootRect = root.getBoundingClientRect();
+        var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+        var present = false;
+        var contained = true;
+        var tokens = [];
+        words.forEach(function (w) {
+          var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+          if (t) tokens.push(t);
+        });
+        groups.forEach(function (el) {
+          var prevOpacity = el.style.opacity;
+          var prevVisibility = el.style.visibility;
+          el.style.opacity = "1";
+          el.style.visibility = "visible";
+          var r = el.getBoundingClientRect();
+          if (r.width > 0 && r.height > 0) {
+            var text = (el.textContent || "").toLowerCase();
+            for (var i = 0; i < tokens.length; i++) {
+              if (text.indexOf(tokens[i]) !== -1) {
+                present = true;
+                break;
+              }
+            }
+            if (
+              r.left < rootRect.left - 1 ||
+              r.right > rootRect.right + 1 ||
+              r.top < rootRect.top - 1 ||
+              r.bottom > rootRect.bottom + 1
+            ) {
+              contained = false;
+            }
+          }
+          el.style.opacity = prevOpacity;
+          el.style.visibility = prevVisibility;
+        });
+        hfPublishStatus({
+          ok: present && contained,
+          present: present,
+          contained: contained,
+          version: HF_CONTRACT_VERSION,
+          durationS: durationS,
+        });
+      }
+
+      var HF_STOPWORDS = new Set([
+        "the",
+        "a",
+        "an",
+        "and",
+        "or",
+        "but",
+        "is",
+        "are",
+        "was",
+        "were",
+        "to",
+        "of",
+        "in",
+        "on",
+        "at",
+        "for",
+        "with",
+        "by",
+        "from",
+        "as",
+        "it",
+        "its",
+        "this",
+        "that",
+        "these",
+        "those",
+        "be",
+        "been",
+        "have",
+        "has",
+        "had",
+        "do",
+        "does",
+        "did",
+        "will",
+        "would",
+        "could",
+        "should",
+        "may",
+        "might",
+        "must",
+        "can",
+        "if",
+        "then",
+        "so",
+        "just",
+        "not",
+        "no",
+        "yes",
+        "up",
+        "out",
+        "about",
+        "into",
+        "over",
+        "after",
+        "before",
+        "your",
+        "you",
+        "our",
+        "we",
+        "they",
+        "them",
+        "their",
+        "there",
+        "here",
+        "when",
+        "what",
+        "which",
+        "who",
+        "how",
+        "all",
+        "any",
+        "some",
+        "more",
+        "most",
+        "other",
+        "than",
+        "too",
+        "very",
+        "also",
+        "because",
+      ]);
+
+      function hfIsEmphasisWord(text) {
+        var clean = String(text)
+          .toLowerCase()
+          .replace(/[^a-z]/g, "");
+        return clean.length >= 5 && !HF_STOPWORDS.has(clean);
+      }
+
+      var DURATION, SAFE_WIDTH;
       var ENTRY_DUR = 0.1;
       var SLIDE_DUR = 0.2;
 
@@ -147,266 +415,275 @@
         return minSize;
       }
 
-      // Generic transcript words
-      var W = [
-        { text: "Every", start: 0.0, end: 0.3 },
-        { text: "great", start: 0.3, end: 0.55 },
-        { text: "video", start: 0.55, end: 0.85 },
-        { text: "starts", start: 0.85, end: 1.1 },
-        { text: "with", start: 1.1, end: 1.25 },
-        { text: "a", start: 1.25, end: 1.35 },
-        { text: "single", start: 1.35, end: 1.65 },
-        { text: "frame.", start: 1.65, end: 2.0 },
-        { text: "HyperFrames", start: 2.1, end: 2.65 },
-        { text: "lets", start: 2.65, end: 2.85 },
-        { text: "you", start: 2.85, end: 2.95 },
-        { text: "write", start: 2.95, end: 3.15 },
-        { text: "HTML", start: 3.15, end: 3.55 },
-        { text: "and", start: 3.55, end: 3.65 },
-        { text: "render", start: 3.65, end: 3.95 },
-        { text: "professional", start: 3.95, end: 4.45 },
-        { text: "video.", start: 4.45, end: 4.8 },
-        { text: "No", start: 4.9, end: 5.05 },
-        { text: "timeline.", start: 5.05, end: 5.45 },
-        { text: "No", start: 5.5, end: 5.65 },
-        { text: "drag", start: 5.65, end: 5.85 },
-        { text: "and", start: 5.85, end: 5.95 },
-        { text: "drop.", start: 5.95, end: 6.25 },
-        { text: "Just", start: 6.35, end: 6.55 },
-        { text: "code", start: 6.55, end: 6.8 },
-        { text: "that", start: 6.8, end: 6.95 },
-        { text: "becomes", start: 6.95, end: 7.3 },
-        { text: "cinema.", start: 7.3, end: 7.7 },
-      ];
-
-      // Block layout: [wordIndex, type] — n=normal, i=italic, e=emphasis(large)
-      // Emphasis words: HyperFrames(8), HTML(12), professional(15), code(24), cinema.(27)
-      var BLOCKS = [
-        {
-          line1: [
-            [0, "n"],
-            [1, "n"],
-            [2, "n"],
-          ],
-          line2: [
-            [3, "n"],
-            [4, "n"],
-          ],
-        },
-        {
-          line1: [
-            [5, "n"],
-            [6, "n"],
-          ],
-          line2: [[7, "e"]],
-        },
-        { line1: [[8, "e"]], line2: null },
-        {
-          line1: [
-            [9, "n"],
-            [10, "n"],
-            [11, "n"],
-          ],
-          line2: [[12, "e"]],
-        },
-        {
-          line1: [
-            [13, "n"],
-            [14, "n"],
-          ],
-          line2: [[15, "e"]],
-        },
-        {
-          line1: [
-            [16, "n"],
-            [17, "n"],
-          ],
-          line2: null,
-        },
-        {
-          line1: [[18, "n"]],
-          line2: [
-            [19, "n"],
-            [20, "n"],
-          ],
-        },
-        {
-          line1: [
-            [21, "n"],
-            [22, "n"],
-          ],
-          line2: null,
-        },
-        {
-          line1: [
-            [23, "i"],
-            [24, "e"],
-          ],
-          line2: null,
-        },
-        {
-          line1: [
-            [25, "n"],
-            [26, "n"],
-          ],
-          line2: [[27, "e"]],
-        },
-      ];
-
       var CLASS_MAP = { n: "word word--normal", i: "word word--italic", e: "word word--emphasis" };
 
-      function computeLineSize(linePairs) {
-        var hasEmphasis = linePairs.some(function (p) {
-          return p[1] === "e";
+      var W = [];
+      var BLOCKS = [];
+
+      var MAX_WORDS_PER_BLOCK = 5;
+      var PAUSE_THRESHOLD = 0.1;
+
+      function hfMakeBlocks(words) {
+        var blocks = [];
+        var current = [];
+        words.forEach(function (w, i) {
+          current.push(i);
+          var isEmph = hfIsEmphasisWord(w.text);
+          var punctuation = /[,.:!?]$/.test(w.text);
+          var next = words[i + 1];
+          var pause = next ? next.start - w.end : Infinity;
+          if (
+            isEmph ||
+            punctuation ||
+            pause >= PAUSE_THRESHOLD ||
+            current.length >= MAX_WORDS_PER_BLOCK ||
+            !next
+          ) {
+            if (isEmph && current.length > 1) {
+              blocks.push({
+                line1: current.slice(0, -1).map(function (ix) {
+                  return [ix, "n"];
+                }),
+                line2: [[current[current.length - 1], "e"]],
+              });
+            } else if (isEmph) {
+              blocks.push({ line1: [[current[0], "e"]], line2: null });
+            } else if (current.length > 3) {
+              var split = Math.ceil(current.length / 2);
+              blocks.push({
+                line1: current.slice(0, split).map(function (ix) {
+                  return [ix, "n"];
+                }),
+                line2: current.slice(split).map(function (ix) {
+                  return [ix, "n"];
+                }),
+              });
+            } else {
+              blocks.push({
+                line1: current.map(function (ix) {
+                  return [ix, "n"];
+                }),
+                line2: null,
+              });
+            }
+            current = [];
+          }
         });
-        if (hasEmphasis) {
+        return blocks;
+      }
+
+      function hfTeardown() {
+        document.getElementById("caption-stage").innerHTML = "";
+      }
+
+      function hfBuild(words, layout, durationS) {
+        DURATION = durationS;
+        var stage = document.getElementById("caption-stage");
+        var fontNormal = Math.round(86 * layout.fontScale);
+        var fontEmphasis = Math.round(180 * layout.fontScale);
+        var marginX = Math.round(60 * layout.scaleX);
+        var blockH = Math.round(430 * layout.fontScale);
+        SAFE_WIDTH = layout.W - marginX * 2;
+        stage.style.left = marginX + "px";
+        stage.style.width = SAFE_WIDTH + "px";
+        stage.style.height = blockH + "px";
+        stage.style.top = Math.max(0, layout.H - blockH - Math.round(70 * layout.scaleY)) + "px";
+
+        W = words;
+        BLOCKS = hfMakeBlocks(words);
+
+        function computeLineSize(linePairs) {
+          var hasEmphasis = linePairs.some(function (p) {
+            return p[1] === "e";
+          });
           var lineText = linePairs
             .map(function (p) {
               return W[p[0]].text;
             })
             .join(" ");
-          return fitFontSize(lineText, 180, "800", "Playfair Display", SAFE_WIDTH);
+          if (hasEmphasis) {
+            return fitFontSize(lineText, fontEmphasis, "800", "Playfair Display", SAFE_WIDTH);
+          }
+          return fitFontSize(lineText, fontNormal, "400", "Inter", SAFE_WIDTH);
         }
-        var lineText = linePairs
-          .map(function (p) {
-            return W[p[0]].text;
-          })
-          .join(" ");
-        return fitFontSize(lineText, 86, "400", "Inter", SAFE_WIDTH);
-      }
 
-      function buildBlocks() {
-        var stage = document.getElementById("caption-stage");
-        BLOCKS.forEach(function (block, bi) {
-          var el = document.createElement("div");
-          el.className = "caption-block";
-          el.id = "b" + bi;
-
-          var l1Size = computeLineSize(block.line1);
-          var l1 = document.createElement("div");
-          l1.className = "caption-line";
-          l1.id = "b" + bi + "L1";
-          block.line1.forEach(function (pair, wi) {
-            var span = document.createElement("span");
-            span.className = CLASS_MAP[pair[1]];
-            span.id = "b" + bi + "L1w" + wi;
-            span.textContent = W[pair[0]].text;
-            if (pair[1] === "e") {
-              span.style.fontSize = l1Size + "px";
-            } else {
-              span.style.fontSize = l1Size + "px";
-            }
-            l1.appendChild(span);
-          });
-          el.appendChild(l1);
-
-          if (block.line2) {
-            var l2Size = computeLineSize(block.line2);
-            var l2 = document.createElement("div");
-            l2.className = "caption-line";
-            l2.id = "b" + bi + "L2";
-            block.line2.forEach(function (pair, wi) {
+        function buildBlocks() {
+          BLOCKS.forEach(function (block, bi) {
+            var el = document.createElement("div");
+            el.className = "caption-block";
+            el.id = "b" + bi;
+
+            var l1Size = computeLineSize(block.line1);
+            var l1 = document.createElement("div");
+            l1.className = "caption-line";
+            l1.id = "b" + bi + "L1";
+            block.line1.forEach(function (pair, wi) {
               var span = document.createElement("span");
               span.className = CLASS_MAP[pair[1]];
-              span.id = "b" + bi + "L2w" + wi;
+              span.id = "b" + bi + "L1w" + wi;
               span.textContent = W[pair[0]].text;
-              if (pair[1] === "e") {
-                span.style.fontSize = l2Size + "px";
-              } else {
+              span.style.fontSize = l1Size + "px";
+              l1.appendChild(span);
+            });
+            el.appendChild(l1);
+
+            if (block.line2) {
+              var l2Size = computeLineSize(block.line2);
+              var l2 = document.createElement("div");
+              l2.className = "caption-line";
+              l2.id = "b" + bi + "L2";
+              block.line2.forEach(function (pair, wi) {
+                var span = document.createElement("span");
+                span.className = CLASS_MAP[pair[1]];
+                span.id = "b" + bi + "L2w" + wi;
+                span.textContent = W[pair[0]].text;
                 span.style.fontSize = l2Size + "px";
-              }
-              l2.appendChild(span);
+                l2.appendChild(span);
+              });
+              el.appendChild(l2);
+            }
+
+            stage.appendChild(el);
+          });
+        }
+
+        buildBlocks();
+
+        // Scale blocks that exceed safe width
+        function fitBlocks() {
+          BLOCKS.forEach(function (block, bi) {
+            var el = document.getElementById("b" + bi);
+            el.style.opacity = "1";
+            el.style.position = "relative";
+            var lines = el.querySelectorAll(".caption-line");
+            var maxW = 0;
+            lines.forEach(function (line) {
+              if (line.scrollWidth > maxW) maxW = line.scrollWidth;
             });
-            el.appendChild(l2);
-          }
+            if (maxW > SAFE_WIDTH) {
+              var s = SAFE_WIDTH / maxW;
+              el.style.transform = "scale(" + s + ")";
+            }
+            el.style.opacity = "0";
+            el.style.position = "";
+          });
+        }
+
+        fitBlocks();
+
+        var tl = gsap.timeline({ paused: true });
 
-          stage.appendChild(el);
+        var allEls = BLOCKS.map(function (_, i) {
+          return document.getElementById("b" + i);
         });
-      }
 
-      buildBlocks();
+        function blockStart(bi) {
+          return W[BLOCKS[bi].line1[0][0]].start;
+        }
 
-      // Scale blocks that exceed safe width
-      (function fitBlocks() {
         BLOCKS.forEach(function (block, bi) {
-          var el = document.getElementById("b" + bi);
-          el.style.opacity = "1";
-          el.style.position = "relative";
-          var lines = el.querySelectorAll(".caption-line");
-          var maxW = 0;
-          lines.forEach(function (line) {
-            if (line.scrollWidth > maxW) maxW = line.scrollWidth;
+          var el = allEls[bi];
+          var start = blockStart(bi);
+          var nextStart = bi < BLOCKS.length - 1 ? blockStart(bi + 1) : DURATION;
+
+          allEls.forEach(function (other, oi) {
+            if (oi !== bi) tl.set(other, { opacity: 0 }, start);
+          });
+          tl.set(el, { opacity: 1 }, start);
+
+          block.line1.forEach(function (pair, wi) {
+            var wordEl = document.getElementById("b" + bi + "L1w" + wi);
+            var wordStart = W[pair[0]].start;
+            tl.set(wordEl, { opacity: 0, scale: 1.12, transformOrigin: "0% 100%" }, start);
+            tl.to(
+              wordEl,
+              { opacity: 1, scale: 1, duration: ENTRY_DUR, ease: "power2.out" },
+              wordStart,
+            );
           });
-          if (maxW > SAFE_WIDTH) {
-            var s = SAFE_WIDTH / maxW;
-            el.style.transform = "scale(" + s + ")";
-          }
-          el.style.opacity = "0";
-          el.style.position = "";
-        });
-      })();
 
-      window.__timelines = window.__timelines || {};
-      var tl = gsap.timeline({ paused: true });
+          if (block.line2) {
+            var hasEmphasis = block.line2.some(function (p) {
+              return p[1] === "e";
+            });
+            var l2El = document.getElementById("b" + bi + "L2");
+            if (hasEmphasis) {
+              var l2Start = W[block.line2[0][0]].start;
+              tl.set(l2El, { opacity: 0, x: -layout.W }, start);
+              tl.to(l2El, { opacity: 1, x: 0, duration: SLIDE_DUR, ease: "power2.out" }, l2Start);
+            } else {
+              tl.set(l2El, { opacity: 1 }, start);
+              block.line2.forEach(function (pair, wi) {
+                var wordEl = document.getElementById("b" + bi + "L2w" + wi);
+                var wordStart = W[pair[0]].start;
+                tl.set(wordEl, { opacity: 0, scale: 1.12, transformOrigin: "0% 100%" }, start);
+                tl.to(
+                  wordEl,
+                  { opacity: 1, scale: 1, duration: ENTRY_DUR, ease: "power2.out" },
+                  wordStart,
+                );
+              });
+            }
+          }
 
-      var allEls = BLOCKS.map(function (_, i) {
-        return document.getElementById("b" + i);
-      });
+          tl.set(el, { opacity: 0 }, nextStart);
+        });
 
-      function blockStart(bi) {
-        return W[BLOCKS[bi].line1[0][0]].start;
+        tl.to({}, { duration: DURATION }, 0);
+        return tl;
       }
 
-      BLOCKS.forEach(function (block, bi) {
-        var el = allEls[bi];
-        var start = blockStart(bi);
-        var nextStart = bi < BLOCKS.length - 1 ? blockStart(bi + 1) : DURATION;
+      var hfCurrentTimeline = null;
 
-        allEls.forEach(function (other, oi) {
-          if (oi !== bi) tl.set(other, { opacity: 0 }, start);
-        });
-        tl.set(el, { opacity: 1 }, start);
-
-        block.line1.forEach(function (pair, wi) {
-          var wordEl = document.getElementById("b" + bi + "L1w" + wi);
-          var wordStart = W[pair[0]].start;
-          tl.set(wordEl, { opacity: 0, scale: 1.12, transformOrigin: "0% 100%" }, start);
-          tl.to(
-            wordEl,
-            { opacity: 1, scale: 1, duration: ENTRY_DUR, ease: "power2.out" },
-            wordStart,
-          );
-        });
-
-        if (block.line2) {
-          var hasEmphasis = block.line2.some(function (p) {
-            return p[1] === "e";
+      function hfAttach(data) {
+        var v = hfValidate(data);
+        if (!v.ok) {
+          hfRunGate([], 0, v.reason);
+          return;
+        }
+        if (hfCurrentTimeline) {
+          hfCurrentTimeline.kill();
+          hfCurrentTimeline = null;
+        }
+        hfTeardown();
+        var layout = hfApplyStageConfig(data, v.durationS);
+        var tl = hfBuild(v.words, layout, v.durationS);
+        tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+        // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+        // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+        // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+        // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+        tl.render(0, true, true);
+        hfCurrentTimeline = tl;
+        window.__timelines = window.__timelines || {};
+        window.__timelines[HF_COMPOSITION_ID] = tl;
+        hfRunGate(v.words, v.durationS, null);
+      }
+      window.__HF_CAPTION_ATTACH__ = hfAttach;
+
+      (function hfBoot() {
+        function start(data) {
+          var ready =
+            document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+          ready.then(function () {
+            hfAttach(data);
           });
-          var l2El = document.getElementById("b" + bi + "L2");
-          if (hasEmphasis) {
-            var l2Start = W[block.line2[0][0]].start;
-            tl.set(l2El, { opacity: 0, x: -1920 }, start);
-            tl.to(l2El, { opacity: 1, x: 0, duration: SLIDE_DUR, ease: "power2.out" }, l2Start);
-          } else {
-            tl.set(l2El, { opacity: 1 }, start);
-            block.line2.forEach(function (pair, wi) {
-              var wordEl = document.getElementById("b" + bi + "L2w" + wi);
-              var wordStart = W[pair[0]].start;
-              tl.set(wordEl, { opacity: 0, scale: 1.12, transformOrigin: "0% 100%" }, start);
-              tl.to(
-                wordEl,
-                { opacity: 1, scale: 1, duration: ENTRY_DUR, ease: "power2.out" },
-                wordStart,
-              );
-            });
-          }
         }
-
-        tl.set(el, { opacity: 0 }, nextStart);
-      });
-
-      tl.to({}, { duration: DURATION }, 0);
-      window.__timelines["caption-editorial-emphasis"] = tl;
+        if (window.__HF_CAPTION__) {
+          start(window.__HF_CAPTION__);
+          return;
+        }
+        fetch("./caption-data.json")
+          .then(function (r) {
+            return r.ok ? r.json() : null;
+          })
+          .catch(function () {
+            return null;
+          })
+          .then(function (json) {
+            start(json || HF_DEMO_DATA);
+          });
+      })();
     </script>
   </body>
 </html>

From 18de2b1f1de8062a79ae7aa6fa4796e320fe6131 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 22:42:14 +0000
Subject: [PATCH 033/125] fix(caption-editorial-emphasis,caption-emoji-pop):
 remove O(n^2) redundant hide-all-others loop
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Both identities looped over every OTHER group/block to force its opacity
to 0 at each group's own start time, in addition to each group already
setting its own opacity to 0 at its own end. Since groups/blocks occupy
non-overlapping time windows and already own their full opacity
lifecycle, that loop was dead weight — but it made timeline construction
O(n^2) in the number of groups/blocks. Under the Task 7 stress transcript
(long, frequent "emphasis" words forcing near single-word blocks/groups),
n reached ~2000 and the page hung well past a 30s test timeout for both
identities.

Verified behavior-preserving: full templates.test.ts (41 tests, incl.
opacity/seek assertions) and the new limits.test.ts stress suite pass
against both identities after the removal.
---
 .../caption-editorial-emphasis.html                   | 11 ++++++++---
 .../caption-emoji-pop/caption-emoji-pop.html          | 10 +++++++---
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
index 281c3aae76..f859ab6aeb 100644
--- a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
+++ b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
@@ -586,9 +586,14 @@
           var start = blockStart(bi);
           var nextStart = bi < BLOCKS.length - 1 ? blockStart(bi + 1) : DURATION;
 
-          allEls.forEach(function (other, oi) {
-            if (oi !== bi) tl.set(other, { opacity: 0 }, start);
-          });
+          // Each block already owns its full opacity lifecycle (set 1 at its
+          // own start, then set back to 0 at its own nextStart below), and
+          // blocks occupy non-overlapping windows, so explicitly hiding every
+          // OTHER block here was redundant and made timeline construction
+          // O(blocks^2) — this collapsed under dense stress transcripts (many
+          // single-word emphasis blocks). Removed; behavior is unchanged
+          // (verified against templates.test.ts).
+
           tl.set(el, { opacity: 1 }, start);
 
           block.line1.forEach(function (pair, wi) {
diff --git a/registry/components/caption-emoji-pop/caption-emoji-pop.html b/registry/components/caption-emoji-pop/caption-emoji-pop.html
index d4107123b0..da1692a5fa 100644
--- a/registry/components/caption-emoji-pop/caption-emoji-pop.html
+++ b/registry/components/caption-emoji-pop/caption-emoji-pop.html
@@ -703,9 +703,13 @@
             groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
           var exitStart = Math.max(visibleStart, visibleEnd - EXIT_DURATION);
 
-          allGroupEls.forEach(function (otherEl, otherIndex) {
-            if (otherIndex !== groupIndex) tl.set(otherEl, { opacity: 0 }, visibleStart);
-          });
+          // Each group already owns its full opacity lifecycle (set 0 at its
+          // own visibleStart, animated to 1, then set back to 0 at its own
+          // visibleEnd below), and groups occupy non-overlapping windows, so
+          // explicitly hiding every OTHER group here was redundant and made
+          // timeline construction O(groups^2) — this collapsed under dense
+          // stress transcripts (many short groups). Removed; behavior is
+          // unchanged (verified against templates.test.ts).
 
           tl.set(groupEl, { opacity: 0, scaleX: 0.8, scaleY: 1 }, visibleStart);
           tl.to(

From 5af6203ae7fcd506511ca5683a9097d666c4a63e Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 22:55:37 +0000
Subject: [PATCH 034/125] fix(caption-weight-shift): remove O(n^2) redundant
 hide-all-others loop

---
 .../caption-weight-shift/caption-weight-shift.html     | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/registry/components/caption-weight-shift/caption-weight-shift.html b/registry/components/caption-weight-shift/caption-weight-shift.html
index 2ead4d717f..873182ea57 100644
--- a/registry/components/caption-weight-shift/caption-weight-shift.html
+++ b/registry/components/caption-weight-shift/caption-weight-shift.html
@@ -529,9 +529,13 @@
           var visibleEnd =
             groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
 
-          allGroupEls.forEach(function (otherEl, otherIndex) {
-            if (otherIndex !== groupIndex) tl.set(otherEl, { opacity: 0 }, visibleStart);
-          });
+          // Each group already owns its full opacity lifecycle (set 0 at its
+          // own visibleStart, animated to 1, then set back to 0 at its own
+          // visibleEnd below), and groups occupy non-overlapping windows, so
+          // explicitly hiding every OTHER group here was redundant and made
+          // timeline construction O(groups^2) — this collapsed under dense
+          // stress transcripts (many short groups). Removed; behavior is
+          // unchanged (verified against templates.test.ts).
 
           tl.set(groupEl, { opacity: 0, scale: 0.85 }, visibleStart);
           tl.to(

From c85cfae8fa97229e9c4f4d7217cf08b4bc859f3d Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 16:06:22 -0700
Subject: [PATCH 035/125] fix(producer): rethrow disk drawElement verify
 failure past completeness check

---
 .../src/services/render/capturePlan.test.ts   | 22 +++++++++++++++++++
 .../render/stages/captureStreamingStage.ts    | 17 +++++++-------
 .../src/services/renderOrchestrator.ts        | 14 ++++++++++++
 3 files changed, 45 insertions(+), 8 deletions(-)

diff --git a/packages/producer/src/services/render/capturePlan.test.ts b/packages/producer/src/services/render/capturePlan.test.ts
index a8b8c0ac0c..8e8352de42 100644
--- a/packages/producer/src/services/render/capturePlan.test.ts
+++ b/packages/producer/src/services/render/capturePlan.test.ts
@@ -140,6 +140,28 @@ describe("CapturePlan", () => {
     });
   });
 
+  it("forces screenshot on a disk-plan drawElement verify failure (PRINFRA-352 recovery)", () => {
+    // Parallel disk workers under the explicit fast-capture opt-in verify their
+    // own captured samples; a breach must re-render the DISK plan on the
+    // screenshot baseline (not throw, and not stay on drawElement).
+    const disk = createCapturePlan({
+      workerCount: 2,
+      forceScreenshot: false,
+      useStreamingEncode: false,
+      useLayeredComposite: false,
+      usePageSideCompositing: false,
+      hasHdrContent: false,
+      needsAlpha: false,
+    });
+    const next = replanAfterFailure(disk, { kind: "draw_element_verification" });
+    expect(next).toMatchObject({
+      kind: "sdr_disk",
+      forceScreenshot: true,
+      forceParallelStream: false,
+      workerCount: 2,
+    });
+  });
+
   it("rejects a streaming transition from a non-streaming plan", () => {
     const disk = createCapturePlan({
       workerCount: 2,
diff --git a/packages/producer/src/services/render/stages/captureStreamingStage.ts b/packages/producer/src/services/render/stages/captureStreamingStage.ts
index 09a87aa861..7a4fe6d951 100644
--- a/packages/producer/src/services/render/stages/captureStreamingStage.ts
+++ b/packages/producer/src/services/render/stages/captureStreamingStage.ts
@@ -63,6 +63,7 @@ import {
   executeParallelCapture,
   getCapturePerfSummary,
   psnrDb,
+  resolveDeVerifyMinDb,
   recaptureDrawElementFrameForVerify,
   completeDeferredDrawElementInit,
   initializeSession,
@@ -257,14 +258,14 @@ function createDrainFrameGuard(args: {
   // check stops meaning anything); above ~60dB natural DE-vs-screenshot
   // encoder differences (~45dB+) would force a screenshot fallback on every
   // verified render. Out-of-range or malformed values fall back to 32.
-  const verifyMinDbRaw = Number(process.env.HF_DE_VERIFY_MIN_DB ?? "32");
-  const verifyMinDb =
-    Number.isFinite(verifyMinDbRaw) && verifyMinDbRaw >= 10 && verifyMinDbRaw <= 60
-      ? verifyMinDbRaw
-      : 32;
-  if (process.env.HF_DE_VERIFY_MIN_DB !== undefined && verifyMinDb !== verifyMinDbRaw) {
-    log.warn("[Render] HF_DE_VERIFY_MIN_DB out of range [10,60]; using 32", {
-      raw: process.env.HF_DE_VERIFY_MIN_DB,
+  // Single-sourced clamp (psnr.ts) so the disk and streaming verify paths can
+  // never apply different PSNR floors to the same composition. The warn stays
+  // here because only this path has a logger in scope.
+  const verifyMinDb = resolveDeVerifyMinDb();
+  const rawEnv = process.env.HF_DE_VERIFY_MIN_DB;
+  if (rawEnv !== undefined && Number(rawEnv) !== verifyMinDb) {
+    log.warn(`[Render] HF_DE_VERIFY_MIN_DB out of range [10,60]; using ${verifyMinDb}`, {
+      raw: rawEnv,
     });
   }
   const sizes: number[] = [];
diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index d903f36c28..362d18c209 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -1018,6 +1018,20 @@ export async function executeDiskCaptureWithAdaptiveRetry(options: {
       if (failure.kind === "cancelled") {
         throw error;
       }
+      // A drawElement self-verify breach (a parallel disk worker's sampled
+      // frame diverged from its pre-injection ground truth) is a CORRECTNESS
+      // failure, not a missing-frame one: the damaged frames are written
+      // complete to disk, so the presence/size-only findMissingFrameRanges
+      // below would count them present and wrongly return success — shipping
+      // the exact compositor damage this verify exists to catch. Rethrow so
+      // the orchestrator's disk-stage screenshot retry fires (mirrors the
+      // `cancelled` guard; a worker-halving retry here would only re-run
+      // drawElement and re-damage). Structural detection walks the aggregated
+      // CaptureFailure → worker CaptureFailure → DrawElementVerificationError
+      // cause chain.
+      if (isDrawElementVerificationError(error)) {
+        throw error;
+      }
       const remaining = findMissingFrameRanges(
         options.totalFrames,
         options.framesDir,

From 92ffd0476d40ce320fa65d6f9c1c8b148fa53d49 Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 16:52:57 -0700
Subject: [PATCH 036/125] refactor(producer): share DE verify-fallback
 telemetry mapping across capture paths

---
 .../src/services/renderOrchestrator.ts        | 53 ++++++++++++-------
 1 file changed, 35 insertions(+), 18 deletions(-)

diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index 362d18c209..d8739d7761 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -1574,6 +1574,29 @@ export function extractStandaloneEntryFromIndex(
   return document.toString();
 }
 
+/**
+ * Telemetry fields a drawElement self-verify failure contributes to the
+ * fallback record. Shared by the streaming and parallel-disk verify catches
+ * so the `verifyDetails` → `de_fallback_*` mapping lives in one place — a new
+ * field is added once, not once per capture path. `kind` is read structurally
+ * off the error (never from message text), so a reworded/translated/
+ * cross-module-serialized error can't flip "blank" into "psnr".
+ */
+function deVerifyFallbackTelemetry(err: unknown): {
+  reason: "psnr" | "blank";
+  failedDb?: number;
+  frameIndex?: number;
+  thresholdDb?: number;
+} {
+  const details = getDrawElementVerificationDetails(err);
+  return {
+    reason: details?.kind ?? "psnr",
+    failedDb: roundDb(details?.failedDb),
+    frameIndex: details?.frameIndex,
+    thresholdDb: roundDb(details?.verifyThresholdDb),
+  };
+}
+
 /**
  * Render a `RenderJob` end-to-end: compile → probe → extract videos →
  * audio → capture → encode → assemble. The function body is a thin
@@ -3026,20 +3049,14 @@ async function executeRenderPipeline(input: {
             throw err;
           const isMemoryExhaustion = !isVerifyError && isMemoryExhaustionError(err);
           deSelfVerifyFallback = isVerifyError;
-          // `kind` is a structural field on the error (DrawElementVerificationDetails),
-          // never derived from message text — a reworded message, a translated
-          // string, or a cross-module/serialized error must never be able to
-          // flip "blank" into "psnr" or vice versa (review finding).
-          const verifyDetails = isVerifyError ? getDrawElementVerificationDetails(err) : undefined;
-          deFallbackReason = isVerifyError
-            ? (verifyDetails?.kind ?? "psnr")
-            : isMemoryExhaustion
-              ? "oom"
-              : "capture_error";
           if (isVerifyError) {
-            deFallbackFailedDb = roundDb(verifyDetails?.failedDb);
-            deFallbackFrameIndex = verifyDetails?.frameIndex;
-            deFallbackThresholdDb = roundDb(verifyDetails?.verifyThresholdDb);
+            const t = deVerifyFallbackTelemetry(err);
+            deFallbackReason = t.reason;
+            deFallbackFailedDb = t.failedDb;
+            deFallbackFrameIndex = t.frameIndex;
+            deFallbackThresholdDb = t.thresholdDb;
+          } else {
+            deFallbackReason = isMemoryExhaustion ? "oom" : "capture_error";
           }
           log.warn(
             isVerifyError
@@ -3203,12 +3220,12 @@ async function executeRenderPipeline(input: {
           ) {
             throw err;
           }
-          const verifyDetails = getDrawElementVerificationDetails(err);
           deSelfVerifyFallback = true;
-          deFallbackReason = verifyDetails?.kind ?? "psnr";
-          deFallbackFailedDb = roundDb(verifyDetails?.failedDb);
-          deFallbackFrameIndex = verifyDetails?.frameIndex;
-          deFallbackThresholdDb = roundDb(verifyDetails?.verifyThresholdDb);
+          const t = deVerifyFallbackTelemetry(err);
+          deFallbackReason = t.reason;
+          deFallbackFailedDb = t.failedDb;
+          deFallbackFrameIndex = t.frameIndex;
+          deFallbackThresholdDb = t.thresholdDb;
           log.warn(
             "[Render] drawElement self-verification failed on the parallel disk path; " +
               "re-rendering via screenshot",

From 4f6994719196e72dc01ebe8f60d869e064ec7685 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Fri, 24 Jul 2026 00:03:46 +0000
Subject: [PATCH 037/125] fix(registry): clear brand CSS custom properties on
 unbranded re-attach; remove dead italic path
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

hfApplyStageConfig (Block B, verbatim across all 5 retrofitted caption
identities) only ever set --hf-caption-primary/--hf-caption-accent when the
corresponding brand.primaryColor/accentColor key was present, with no else
branch to clear it when absent. Re-attaching a brand-less payload after a
branded one left the custom property (and any JS-cached color derived from
it, e.g. caption-pill-karaoke's hfColorActive and caption-emoji-pop's
hfAccentColors) stuck at the stale value instead of reverting to the CSS
fallback, violating idempotent re-attach.

Also removes caption-editorial-emphasis's dead .word--italic CSS rule and
CLASS_MAP.i entry — hfMakeBlocks only ever emits "n"/"e" tags, "i" was only
reachable via the old hand-authored BLOCKS literal this task replaced.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .../caption-editorial-emphasis.html                 | 13 +++++--------
 .../caption-emoji-pop/caption-emoji-pop.html        |  4 ++++
 .../caption-highlight/caption-highlight.html        |  4 ++++
 .../caption-pill-karaoke/caption-pill-karaoke.html  |  4 ++++
 .../caption-weight-shift/caption-weight-shift.html  |  4 ++++
 5 files changed, 21 insertions(+), 8 deletions(-)

diff --git a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
index f859ab6aeb..38c86f294d 100644
--- a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
+++ b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
@@ -95,13 +95,6 @@
         font-style: normal;
       }
 
-      .word--italic {
-        font-family: "Inter", sans-serif;
-        font-size: 86px;
-        font-weight: 400;
-        font-style: italic;
-      }
-
       .word--emphasis {
         font-family: "Playfair Display", serif;
         font-size: 180px;
@@ -236,9 +229,13 @@
         var brand = (data && data.brand) || {};
         if (typeof brand.primaryColor === "string" && brand.primaryColor) {
           root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+        } else {
+          root.style.removeProperty("--hf-caption-primary");
         }
         if (typeof brand.accentColor === "string" && brand.accentColor) {
           root.style.setProperty("--hf-caption-accent", brand.accentColor);
+        } else {
+          root.style.removeProperty("--hf-caption-accent");
         }
         return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
       }
@@ -415,7 +412,7 @@
         return minSize;
       }
 
-      var CLASS_MAP = { n: "word word--normal", i: "word word--italic", e: "word word--emphasis" };
+      var CLASS_MAP = { n: "word word--normal", e: "word word--emphasis" };
 
       var W = [];
       var BLOCKS = [];
diff --git a/registry/components/caption-emoji-pop/caption-emoji-pop.html b/registry/components/caption-emoji-pop/caption-emoji-pop.html
index da1692a5fa..e9837d5f61 100644
--- a/registry/components/caption-emoji-pop/caption-emoji-pop.html
+++ b/registry/components/caption-emoji-pop/caption-emoji-pop.html
@@ -232,9 +232,13 @@
         var brand = (data && data.brand) || {};
         if (typeof brand.primaryColor === "string" && brand.primaryColor) {
           root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+        } else {
+          root.style.removeProperty("--hf-caption-primary");
         }
         if (typeof brand.accentColor === "string" && brand.accentColor) {
           root.style.setProperty("--hf-caption-accent", brand.accentColor);
+        } else {
+          root.style.removeProperty("--hf-caption-accent");
         }
         return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
       }
diff --git a/registry/components/caption-highlight/caption-highlight.html b/registry/components/caption-highlight/caption-highlight.html
index b53e981803..b87f407e84 100644
--- a/registry/components/caption-highlight/caption-highlight.html
+++ b/registry/components/caption-highlight/caption-highlight.html
@@ -243,9 +243,13 @@
           var brand = (data && data.brand) || {};
           if (typeof brand.primaryColor === "string" && brand.primaryColor) {
             root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+          } else {
+            root.style.removeProperty("--hf-caption-primary");
           }
           if (typeof brand.accentColor === "string" && brand.accentColor) {
             root.style.setProperty("--hf-caption-accent", brand.accentColor);
+          } else {
+            root.style.removeProperty("--hf-caption-accent");
           }
           return {
             W: W,
diff --git a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
index 741048027c..f57bbd1635 100644
--- a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
+++ b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
@@ -238,9 +238,13 @@
         var brand = (data && data.brand) || {};
         if (typeof brand.primaryColor === "string" && brand.primaryColor) {
           root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+        } else {
+          root.style.removeProperty("--hf-caption-primary");
         }
         if (typeof brand.accentColor === "string" && brand.accentColor) {
           root.style.setProperty("--hf-caption-accent", brand.accentColor);
+        } else {
+          root.style.removeProperty("--hf-caption-accent");
         }
         return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
       }
diff --git a/registry/components/caption-weight-shift/caption-weight-shift.html b/registry/components/caption-weight-shift/caption-weight-shift.html
index 873182ea57..3689dfa40d 100644
--- a/registry/components/caption-weight-shift/caption-weight-shift.html
+++ b/registry/components/caption-weight-shift/caption-weight-shift.html
@@ -224,9 +224,13 @@
         var brand = (data && data.brand) || {};
         if (typeof brand.primaryColor === "string" && brand.primaryColor) {
           root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+        } else {
+          root.style.removeProperty("--hf-caption-primary");
         }
         if (typeof brand.accentColor === "string" && brand.accentColor) {
           root.style.setProperty("--hf-caption-accent", brand.accentColor);
+        } else {
+          root.style.removeProperty("--hf-caption-accent");
         }
         return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
       }

From 4889b779c90fdaf104031a14dd926b79a0ddc00c Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 17:57:15 -0700
Subject: [PATCH 038/125] fix(engine): lazy-promisify execFile in psnr so
 partial child_process mocks don't crash at import

---
 packages/cli/src/commands/render.test.ts | 14 ++++++++++++++
 packages/engine/src/utils/psnr.ts        |  7 +++++--
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/packages/cli/src/commands/render.test.ts b/packages/cli/src/commands/render.test.ts
index 48f0ce7c20..e3a1fdabed 100644
--- a/packages/cli/src/commands/render.test.ts
+++ b/packages/cli/src/commands/render.test.ts
@@ -123,6 +123,20 @@ vi.mock("../telemetry/config.js", () => ({
     configState.cache = { ...configState.disk };
     return { ...configState.disk };
   }),
+  recordRecentRender: vi.fn((id: string, ok: boolean) => {
+    // Mirrors the real ring update (readConfigFresh → append, cap 5 → write)
+    // against the mock's disk state, so a render's recent-renders write is
+    // modeled like every other config mutation here. Fixed timestamp keeps it
+    // deterministic (tests never assert on `at`).
+    const disk = configState.disk as Record<string, unknown>;
+    const ring = [
+      ...((disk.recentRenders as unknown[]) ?? []),
+      { id, at: "2026-01-01T00:00:00Z", ok },
+    ];
+    const next = { ...disk, recentRenders: ring.slice(-5) };
+    configState.disk = next;
+    configState.cache = { ...next };
+  }),
   writeConfig: vi.fn((config: Record<string, unknown>) => {
     configState.writeConfigCalls.push({ ...config });
     if (configState.failWrites > 0) {
diff --git a/packages/engine/src/utils/psnr.ts b/packages/engine/src/utils/psnr.ts
index 4d92ac110b..675594ec47 100644
--- a/packages/engine/src/utils/psnr.ts
+++ b/packages/engine/src/utils/psnr.ts
@@ -5,14 +5,17 @@ import { join } from "node:path";
 import { promisify } from "node:util";
 import { getFfmpegBinary } from "./ffmpegBinaries.js";
 
-const execFileP = promisify(execFile);
-
 /**
  * PSNR (average, dB) between two same-dimension encoded images via ffmpeg.
  * Infinity means bit-identical pixels. Single source of truth for every
  * drawElement self-verify comparison (streaming drain + parallel disk path).
  */
 export async function psnrDb(a: Buffer, b: Buffer): Promise<number> {
+  // promisify(execFile) lazily, not at module load: this module is in the
+  // engine's parallel-capture import chain, and a top-level call to a builtin
+  // crashes any downstream test that partially mocks node:child_process
+  // without an execFile export (vitest surfaces it as a load-time error).
+  const execFileP = promisify(execFile);
   const dir = await mkdtemp(join(tmpdir(), "hf-de-verify-"));
   try {
     const pa = join(dir, "a.jpg");

From b8e10154762f5a0fe71fb4a6a9f3d472e9bf99ec Mon Sep 17 00:00:00 2001
From: Via <vance@heygen.com>
Date: Fri, 24 Jul 2026 01:38:42 +0000
Subject: [PATCH 039/125] fix(producer): close orphaned probe session before
 verify-triggered retries
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

On a parallel-capture disk-verify or streaming-drain breach, the outer
catch cleared probeSession without first closing the still-owned session,
orphaning the probe Chrome process precisely when the retry was recovering
from GPU/memory pressure. Introduce closeOrphanedProbeForRetry so both
retry catches close the session (with defensive .catch that logs on close
error) before releasing the reference, and cover it with a focused unit
test asserting closure-before-clear and the swallow-and-warn behaviour.

Addresses Magi's REQUEST_CHANGES on #2749; also closes Rames' sibling
concern at the streaming-retry path (renderOrchestrator.ts:3093).

— Via
---
 .../src/services/renderOrchestrator.test.ts   | 61 +++++++++++++++++++
 .../src/services/renderOrchestrator.ts        | 49 ++++++++++++++-
 2 files changed, 108 insertions(+), 2 deletions(-)

diff --git a/packages/producer/src/services/renderOrchestrator.test.ts b/packages/producer/src/services/renderOrchestrator.test.ts
index e900b68f21..c3dbcb1d00 100644
--- a/packages/producer/src/services/renderOrchestrator.test.ts
+++ b/packages/producer/src/services/renderOrchestrator.test.ts
@@ -17,6 +17,7 @@ vi.mock("@hyperframes/engine", async (importOriginal) => {
 import {
   buildMissingFrameRetryBatches,
   captureAttemptMadeProgress,
+  closeOrphanedProbeForRetry,
   describeMemoryExhaustion,
   executeDiskCaptureWithAdaptiveRetry,
   collectVideoMetadataHints,
@@ -2130,3 +2131,63 @@ describe("shouldStreamParallelCapture (non-DE parallel streaming router)", () =>
     expect(shouldStreamParallelCapture({ ...eligible, layeredOrEffectRoute: true })).toBe(false);
   });
 });
+
+describe("closeOrphanedProbeForRetry (probe cleanup before verify-triggered retry)", () => {
+  // Enough of a CaptureSession stand-in to exercise the closer path — the
+  // helper never inspects the object; it just hands it to the injected closer.
+  const stubSession = { browserConsoleBuffer: [] } as unknown as Parameters<
+    typeof closeOrphanedProbeForRetry
+  >[0];
+
+  it("hands the still-owned probe to the closer before the caller clears it", async () => {
+    const closer = vi.fn(async () => {});
+    const log = { warn: vi.fn() };
+
+    await closeOrphanedProbeForRetry(stubSession, closer, log, "streaming");
+
+    expect(closer).toHaveBeenCalledTimes(1);
+    expect(closer).toHaveBeenCalledWith(stubSession);
+    expect(log.warn).not.toHaveBeenCalled();
+  });
+
+  it("swallows a close failure with a warn so the caller's retry can proceed", async () => {
+    const closer = vi.fn(async () => {
+      throw new Error("chrome zombie");
+    });
+    const log = { warn: vi.fn() };
+
+    await expect(
+      closeOrphanedProbeForRetry(stubSession, closer, log, "disk verify"),
+    ).resolves.toBeUndefined();
+
+    expect(closer).toHaveBeenCalledTimes(1);
+    expect(log.warn).toHaveBeenCalledTimes(1);
+    const [message, meta] = log.warn.mock.calls[0];
+    expect(message).toContain("disk verify");
+    expect((meta as { error: string }).error).toBe("chrome zombie");
+  });
+
+  it("preserves the retry context in the warn message so the audit trail names which retry path leaked", async () => {
+    const closer = vi.fn(async () => {
+      throw new Error("session already closed");
+    });
+    const log = { warn: vi.fn() };
+
+    await closeOrphanedProbeForRetry(stubSession, closer, log, "streaming");
+
+    expect(log.warn.mock.calls[0][0]).toContain("streaming");
+    expect(log.warn.mock.calls[0][0]).not.toContain("disk verify");
+  });
+
+  it("stringifies non-Error rejections so the log entry still names the cause", async () => {
+    const closer = vi.fn(async () => Promise.reject("string-only rejection"));
+    const log = { warn: vi.fn() };
+
+    await closeOrphanedProbeForRetry(stubSession, closer, log, "streaming");
+
+    expect(log.warn).toHaveBeenCalledTimes(1);
+    expect((log.warn.mock.calls[0][1] as { error: string }).error).toBe(
+      "string-only rejection",
+    );
+  });
+});
diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index d8739d7761..02585ff917 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -1468,6 +1468,32 @@ export function shouldRetryViaPinnedFallback(args: {
   return args.deWorkerInversion === "inverted" || args.deParallelRouter === "routed";
 }
 
+/**
+ * When a self-verify (or pinned-fallback) retry is triggered mid-capture, the
+ * caller may still hold a live probe session that the failed stage was passed
+ * but did not (or could not) close in its own `finally` before it threw. Left
+ * behind, that session's Chrome process orphans until the containing render
+ * exits — precisely when we are recovering from GPU/memory pressure and can
+ * least afford an unaccounted Chrome. Close it before the caller clears its
+ * reference; swallow any close error with a warn so the retry itself is never
+ * derailed by a shutdown hiccup.
+ */
+export async function closeOrphanedProbeForRetry(
+  probe: CaptureSession,
+  closer: (session: CaptureSession) => Promise<void>,
+  log: Pick<ProducerLogger, "warn">,
+  retryContext: string,
+): Promise<void> {
+  try {
+    await closer(probe);
+  } catch (closeErr) {
+    log.warn(
+      `[Render] probe close before ${retryContext} retry failed; continuing with retry`,
+      { error: closeErr instanceof Error ? closeErr.message : String(closeErr) },
+    );
+  }
+}
+
 /**
  * Parallel-streaming router for NON-drawElement capture (screenshot on
  * macOS/Windows/forced-screenshot, BeginFrame on Linux): should this
@@ -3090,7 +3116,16 @@ async function executeRenderPipeline(input: {
             deWorkerInversion,
             deParallelRouter,
           });
-          probeSession = null;
+          // Streaming stage aims to close the probe in its own finally; if it
+          // threw before doing so, the Chrome process would orphan through the
+          // pinned-fallback retry. Close defensively before we release the
+          // reference — see closeOrphanedProbeForRetry.
+          if (probeSession) {
+            lastBrowserConsole = probeSession.browserConsoleBuffer;
+            const orphaned = probeSession;
+            probeSession = null;
+            await closeOrphanedProbeForRetry(orphaned, closeCaptureSession, log, "streaming");
+          }
           if (failedRouting === "worker_inversion") {
             // The inversion bet on drawElement and lost — re-render on the
             // pre-inversion parallel screenshot path instead of single-worker
@@ -3243,7 +3278,17 @@ async function executeRenderPipeline(input: {
           resetCaptureAttemptProgress(job);
           dedupPerfs.length = 0;
           cfg.useDrawElement = false;
-          probeSession = null;
+          // Same shape as the streaming retry above: `runCaptureStage` was
+          // passed the probe and threw before it could close it, so we must
+          // release the Chrome process ourselves before starting the
+          // screenshot-baseline retry — otherwise it orphans until render
+          // exit. See closeOrphanedProbeForRetry.
+          if (probeSession) {
+            lastBrowserConsole = probeSession.browserConsoleBuffer;
+            const orphaned = probeSession;
+            probeSession = null;
+            await closeOrphanedProbeForRetry(orphaned, closeCaptureSession, log, "disk verify");
+          }
           capturePlan = replanAfterFailure(capturePlan, { kind: "draw_element_verification" });
           syncCapturePlan();
           updateCaptureObservability({

From 5fd28e1149b4258ab16b3282c495d7fc54325280 Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 18:43:28 -0700
Subject: [PATCH 040/125] style: format probe-cleanup retry code (oxfmt)

---
 packages/producer/src/services/renderOrchestrator.test.ts | 4 +---
 packages/producer/src/services/renderOrchestrator.ts      | 7 +++----
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/producer/src/services/renderOrchestrator.test.ts b/packages/producer/src/services/renderOrchestrator.test.ts
index c3dbcb1d00..deec16be0d 100644
--- a/packages/producer/src/services/renderOrchestrator.test.ts
+++ b/packages/producer/src/services/renderOrchestrator.test.ts
@@ -2186,8 +2186,6 @@ describe("closeOrphanedProbeForRetry (probe cleanup before verify-triggered retr
     await closeOrphanedProbeForRetry(stubSession, closer, log, "streaming");
 
     expect(log.warn).toHaveBeenCalledTimes(1);
-    expect((log.warn.mock.calls[0][1] as { error: string }).error).toBe(
-      "string-only rejection",
-    );
+    expect((log.warn.mock.calls[0][1] as { error: string }).error).toBe("string-only rejection");
   });
 });
diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts
index 02585ff917..c9a0c81292 100644
--- a/packages/producer/src/services/renderOrchestrator.ts
+++ b/packages/producer/src/services/renderOrchestrator.ts
@@ -1487,10 +1487,9 @@ export async function closeOrphanedProbeForRetry(
   try {
     await closer(probe);
   } catch (closeErr) {
-    log.warn(
-      `[Render] probe close before ${retryContext} retry failed; continuing with retry`,
-      { error: closeErr instanceof Error ? closeErr.message : String(closeErr) },
-    );
+    log.warn(`[Render] probe close before ${retryContext} retry failed; continuing with retry`, {
+      error: closeErr instanceof Error ? closeErr.message : String(closeErr),
+    });
   }
 }
 

From b9c3e3a4b6b5e0cc7492d596482ccba17ab555cf Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Thu, 23 Jul 2026 20:59:30 -0700
Subject: [PATCH 041/125] chore: release v0.7.70

---
 .claude-plugin/plugin.json               |  2 +-
 .codex-plugin/plugin.json                |  2 +-
 .cursor-plugin/plugin.json               |  2 +-
 docs/changelog.mdx                       | 15 +++++++++++++++
 packages/aws-lambda/package.json         |  2 +-
 packages/cli/package.json                |  2 +-
 packages/core/package.json               |  2 +-
 packages/engine/package.json             |  2 +-
 packages/gcp-cloud-run/package.json      |  2 +-
 packages/lint/package.json               |  2 +-
 packages/parsers/package.json            |  2 +-
 packages/player/package.json             |  2 +-
 packages/producer/package.json           |  2 +-
 packages/sdk/package.json                |  2 +-
 packages/shader-transitions/package.json |  2 +-
 packages/studio-server/package.json      |  2 +-
 packages/studio/package.json             |  2 +-
 releases/v0.7.70.md                      | 14 ++++++++++++++
 18 files changed, 45 insertions(+), 16 deletions(-)
 create mode 100644 releases/v0.7.70.md

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index a8fed5e059..7925bff9cd 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index b93a7ca41e..51f77c67d1 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index e86cf3ba3d..0d30dfc2be 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -3,7 +3,7 @@
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com"
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 6b9c01c9fb..a221145bc7 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -8,6 +8,21 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
 
 {/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
 
+<Update
+  label="HyperFrames v0.7.70"
+  description="Released - 2026-07-24"
+  tags={["Release", "Producer", "Engine"]}
+>
+Multi-worker renders using experimental fast capture (`--experimental-fast-capture`) now self-verify their frames on the disk path and automatically fall back to screenshot capture when GPU or memory pressure corrupts output — previously that corruption (e.g. a worker's frames displaced into vertical strips) could ship silently.
+
+## Fixes
+
+- **Engine/Producer:** Parallel and sequential disk-path drawElement capture now verify sampled frames against pre-injection ground truth and screenshot-retry on a breach — closing the gap where `--experimental-fast-capture --workers N` shipped compositor-damaged frames with no error (PRINFRA-352) ([060b6f8ae](https://github.com/heygen-com/hyperframes/commit/060b6f8ae53e8ae243d8e2c2c3afd690dbe7f99c), [ec791e91d](https://github.com/heygen-com/hyperframes/commit/ec791e91d97c0070502c4ad208923d4f98005846), [9fc1c2f15](https://github.com/heygen-com/hyperframes/commit/9fc1c2f15990fc44f50533362bec2f075aa1d53d), [c85cfae8f](https://github.com/heygen-com/hyperframes/commit/c85cfae8fa97229e9c4f4d7217cf08b4bc859f3d))
+- **Producer:** Close the orphaned probe session before a verify-triggered retry so the probe Chrome process isn't leaked under the GPU/memory pressure the retry is recovering from ([b8e101547](https://github.com/heygen-com/hyperframes/commit/b8e10154762f5a0fe71fb4a6a9f3d472e9bf99ec))
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.7.69...v0.7.70).
+</Update>
+
 <Update
   label="HyperFrames v0.7.69"
   description="Released - 2026-07-23"
diff --git a/packages/aws-lambda/package.json b/packages/aws-lambda/package.json
index f21e0f32c0..5c520a6c9c 100644
--- a/packages/aws-lambda/package.json
+++ b/packages/aws-lambda/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 1a8d57695b..292d2457a2 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "license": "Apache-2.0",
   "repository": {
diff --git a/packages/core/package.json b/packages/core/package.json
index 73ea941988..7c71cedb50 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/packages/engine/package.json b/packages/engine/package.json
index 1be1f315b0..0e00ae6776 100644
--- a/packages/engine/package.json
+++ b/packages/engine/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
diff --git a/packages/gcp-cloud-run/package.json b/packages/gcp-cloud-run/package.json
index 42389b8566..354fda87f5 100644
--- a/packages/gcp-cloud-run/package.json
+++ b/packages/gcp-cloud-run/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/gcp-cloud-run",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index c81672df4b..7aac034fdb 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index 47942ab989..b5664f51e0 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/player/package.json b/packages/player/package.json
index 98240af339..401ae9e7f0 100644
--- a/packages/player/package.json
+++ b/packages/player/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/player",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "Embeddable web component for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/producer/package.json b/packages/producer/package.json
index 02a9ffb7be..d7a0c8a2fd 100644
--- a/packages/producer/package.json
+++ b/packages/producer/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index da8c464ed9..c647335037 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
diff --git a/packages/shader-transitions/package.json b/packages/shader-transitions/package.json
index c68380af39..0cfcb94b01 100644
--- a/packages/shader-transitions/package.json
+++ b/packages/shader-transitions/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/shader-transitions",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "WebGL shader transitions for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/studio-server/package.json b/packages/studio-server/package.json
index b57f4da9c5..2545b6c26f 100644
--- a/packages/studio-server/package.json
+++ b/packages/studio-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/studio/package.json b/packages/studio/package.json
index 7d87edfb9b..9f72e71232 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.7.69",
+  "version": "0.7.70",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/releases/v0.7.70.md b/releases/v0.7.70.md
new file mode 100644
index 0000000000..726655e0b9
--- /dev/null
+++ b/releases/v0.7.70.md
@@ -0,0 +1,14 @@
+# HyperFrames v0.7.70
+
+Released on 2026-07-24.
+
+Multi-worker renders using experimental fast capture (`--experimental-fast-capture`) now self-verify their frames on the disk path and automatically fall back to screenshot capture when GPU or memory pressure corrupts output — previously that corruption (e.g. a worker's frames displaced into vertical strips) could ship silently.
+
+## Fixes
+
+- **Engine/Producer:** Parallel and sequential disk-path drawElement capture now verify sampled frames against pre-injection ground truth and screenshot-retry on a breach — closing the gap where `--experimental-fast-capture --workers N` shipped compositor-damaged frames with no error (PRINFRA-352) ([060b6f8ae](https://github.com/heygen-com/hyperframes/commit/060b6f8ae53e8ae243d8e2c2c3afd690dbe7f99c), [ec791e91d](https://github.com/heygen-com/hyperframes/commit/ec791e91d97c0070502c4ad208923d4f98005846), [9fc1c2f15](https://github.com/heygen-com/hyperframes/commit/9fc1c2f15990fc44f50533362bec2f075aa1d53d), [c85cfae8f](https://github.com/heygen-com/hyperframes/commit/c85cfae8fa97229e9c4f4d7217cf08b4bc859f3d))
+- **Producer:** Close the orphaned probe session before a verify-triggered retry so the probe Chrome process isn't leaked under the GPU/memory pressure the retry is recovering from ([b8e101547](https://github.com/heygen-com/hyperframes/commit/b8e10154762f5a0fe71fb4a6a9f3d472e9bf99ec))
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.7.69...v0.7.70

From e2846eb7cc81821f7fc21a9c4dccdd85c7ef3429 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Fri, 24 Jul 2026 05:25:41 +0000
Subject: [PATCH 042/125] fix(registry): encapsulate caption template runtimes
 in IIFEs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

caption-highlight was already IIFE-wrapped; the other four leaked their
runtime (hfAttach/hfBuild/...) as script-scope globals. Harmless when boot
was synchronous, but the data-driven retrofit defers attach behind
fonts.ready + the sibling fetch — with two caption components pasted into
one composition document, every script finishes before any deferred boot
runs, the last script's definitions win the shared scope, and the first
component never registers its timeline (a renderer waiting on it hangs to
timeout). Wrapping each template's script keeps its internals private so
each boot attaches its own component. window.__HF_CAPTION_ATTACH__ remains
intentionally window-scoped (last-defined-wins).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../caption-editorial-emphasis.html           | 1048 +++++++-------
 .../caption-emoji-pop/caption-emoji-pop.html  | 1266 +++++++++--------
 .../caption-pill-karaoke.html                 |  864 +++++------
 .../caption-weight-shift.html                 |  938 ++++++------
 4 files changed, 2087 insertions(+), 2029 deletions(-)

diff --git a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
index 38c86f294d..83f808425a 100644
--- a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
+++ b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
@@ -122,569 +122,581 @@
     </div>
 
     <script>
-      var HF_COMPOSITION_ID = "caption-editorial-emphasis";
-      var HF_ROOT_ID = "editorial-emphasis";
-      var HF_GROUP_SELECTOR = ".caption-block";
-
-      var HF_DEMO_DATA = {
-        version: 1,
-        segments: [
-          {
-            start: 0,
-            text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
-            words: [
-              { text: "Every", start: 0.0, end: 0.3 },
-              { text: "great", start: 0.3, end: 0.55 },
-              { text: "video", start: 0.55, end: 0.85 },
-              { text: "starts", start: 0.85, end: 1.1 },
-              { text: "with", start: 1.1, end: 1.25 },
-              { text: "a", start: 1.25, end: 1.35 },
-              { text: "single", start: 1.35, end: 1.65 },
-              { text: "frame.", start: 1.65, end: 2.0 },
-              { text: "HyperFrames", start: 2.1, end: 2.65 },
-              { text: "lets", start: 2.65, end: 2.85 },
-              { text: "you", start: 2.85, end: 2.95 },
-              { text: "write", start: 2.95, end: 3.15 },
-              { text: "HTML", start: 3.15, end: 3.55 },
-              { text: "and", start: 3.55, end: 3.65 },
-              { text: "render", start: 3.65, end: 3.95 },
-              { text: "professional", start: 3.95, end: 4.45 },
-              { text: "video.", start: 4.45, end: 4.8 },
-              { text: "No", start: 4.9, end: 5.05 },
-              { text: "timeline.", start: 5.05, end: 5.45 },
-              { text: "No", start: 5.5, end: 5.65 },
-              { text: "drag", start: 5.65, end: 5.85 },
-              { text: "and", start: 5.85, end: 5.95 },
-              { text: "drop.", start: 5.95, end: 6.25 },
-              { text: "Just", start: 6.35, end: 6.55 },
-              { text: "code", start: 6.55, end: 6.8 },
-              { text: "that", start: 6.8, end: 6.95 },
-              { text: "becomes", start: 6.95, end: 7.3 },
-              { text: "cinema.", start: 7.3, end: 7.7 },
-            ],
-          },
-        ],
-      };
-
-      /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
-      var HF_CONTRACT_VERSION = 1;
-      var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
-
-      function hfFlattenSegments(segments) {
-        var out = [];
-        (segments || []).forEach(function (seg) {
-          ((seg && seg.words) || []).forEach(function (w) {
-            var start = Math.max(0, Number(w.start) || 0);
-            out.push({
-              text: String(w.word || w.text || "").trim(),
-              start: start,
-              end: Math.max(start, Number(w.end) || 0),
+      // IIFE: keep every template's runtime private to itself so two caption
+      // components pasted into one composition document can't clobber each
+      // other's hfAttach/hfBuild via shared script-scope names (boot is async,
+      // so collisions surface AFTER all scripts have executed).
+      (function () {
+        var HF_COMPOSITION_ID = "caption-editorial-emphasis";
+        var HF_ROOT_ID = "editorial-emphasis";
+        var HF_GROUP_SELECTOR = ".caption-block";
+
+        var HF_DEMO_DATA = {
+          version: 1,
+          segments: [
+            {
+              start: 0,
+              text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+              words: [
+                { text: "Every", start: 0.0, end: 0.3 },
+                { text: "great", start: 0.3, end: 0.55 },
+                { text: "video", start: 0.55, end: 0.85 },
+                { text: "starts", start: 0.85, end: 1.1 },
+                { text: "with", start: 1.1, end: 1.25 },
+                { text: "a", start: 1.25, end: 1.35 },
+                { text: "single", start: 1.35, end: 1.65 },
+                { text: "frame.", start: 1.65, end: 2.0 },
+                { text: "HyperFrames", start: 2.1, end: 2.65 },
+                { text: "lets", start: 2.65, end: 2.85 },
+                { text: "you", start: 2.85, end: 2.95 },
+                { text: "write", start: 2.95, end: 3.15 },
+                { text: "HTML", start: 3.15, end: 3.55 },
+                { text: "and", start: 3.55, end: 3.65 },
+                { text: "render", start: 3.65, end: 3.95 },
+                { text: "professional", start: 3.95, end: 4.45 },
+                { text: "video.", start: 4.45, end: 4.8 },
+                { text: "No", start: 4.9, end: 5.05 },
+                { text: "timeline.", start: 5.05, end: 5.45 },
+                { text: "No", start: 5.5, end: 5.65 },
+                { text: "drag", start: 5.65, end: 5.85 },
+                { text: "and", start: 5.85, end: 5.95 },
+                { text: "drop.", start: 5.95, end: 6.25 },
+                { text: "Just", start: 6.35, end: 6.55 },
+                { text: "code", start: 6.55, end: 6.8 },
+                { text: "that", start: 6.8, end: 6.95 },
+                { text: "becomes", start: 6.95, end: 7.3 },
+                { text: "cinema.", start: 7.3, end: 7.7 },
+              ],
+            },
+          ],
+        };
+
+        /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+        var HF_CONTRACT_VERSION = 1;
+        var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
+
+        function hfFlattenSegments(segments) {
+          var out = [];
+          (segments || []).forEach(function (seg) {
+            ((seg && seg.words) || []).forEach(function (w) {
+              var start = Math.max(0, Number(w.start) || 0);
+              out.push({
+                text: String(w.word || w.text || "").trim(),
+                start: start,
+                end: Math.max(start, Number(w.end) || 0),
+              });
             });
           });
-        });
-        out.sort(function (a, b) {
-          return a.start - b.start;
-        });
-        return out.filter(function (w) {
-          return w.text.length > 0;
-        });
-      }
-
-      function hfDeriveDuration(words) {
-        var end = 0;
-        words.forEach(function (w) {
-          if (w.end > end) end = w.end;
-        });
-        return end;
-      }
-
-      function hfValidate(data) {
-        if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-        if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-          return { ok: false, reason: "unsupported-version" };
-        }
-        if (!Array.isArray(data.segments) || data.segments.length === 0) {
-          return { ok: false, reason: "no-segments" };
+          out.sort(function (a, b) {
+            return a.start - b.start;
+          });
+          return out.filter(function (w) {
+            return w.text.length > 0;
+          });
         }
-        if (data.displayMode != null && data.displayMode !== "full") {
-          return { ok: false, reason: "unsupported-displayMode" };
+
+        function hfDeriveDuration(words) {
+          var end = 0;
+          words.forEach(function (w) {
+            if (w.end > end) end = w.end;
+          });
+          return end;
         }
-        var words = hfFlattenSegments(data.segments);
-        if (words.length === 0) return { ok: false, reason: "no-words" };
-        return { ok: true, words: words, durationS: hfDeriveDuration(words) };
-      }
 
-      function hfApplyStageConfig(data, durationS) {
-        var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-        var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-        var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
-        var root = document.getElementById(HF_ROOT_ID);
-        [document.documentElement, document.body, root].forEach(function (el) {
-          el.style.width = W + "px";
-          el.style.height = H + "px";
-        });
-        root.setAttribute("data-width", String(W));
-        root.setAttribute("data-height", String(H));
-        root.setAttribute("data-duration", String(durationS));
-        var brand = (data && data.brand) || {};
-        if (typeof brand.primaryColor === "string" && brand.primaryColor) {
-          root.style.setProperty("--hf-caption-primary", brand.primaryColor);
-        } else {
-          root.style.removeProperty("--hf-caption-primary");
+        function hfValidate(data) {
+          if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+            return { ok: false, reason: "unsupported-version" };
+          }
+          if (!Array.isArray(data.segments) || data.segments.length === 0) {
+            return { ok: false, reason: "no-segments" };
+          }
+          if (data.displayMode != null && data.displayMode !== "full") {
+            return { ok: false, reason: "unsupported-displayMode" };
+          }
+          var words = hfFlattenSegments(data.segments);
+          if (words.length === 0) return { ok: false, reason: "no-words" };
+          return { ok: true, words: words, durationS: hfDeriveDuration(words) };
         }
-        if (typeof brand.accentColor === "string" && brand.accentColor) {
-          root.style.setProperty("--hf-caption-accent", brand.accentColor);
-        } else {
-          root.style.removeProperty("--hf-caption-accent");
+
+        function hfApplyStageConfig(data, durationS) {
+          var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          var root = document.getElementById(HF_ROOT_ID);
+          [document.documentElement, document.body, root].forEach(function (el) {
+            el.style.width = W + "px";
+            el.style.height = H + "px";
+          });
+          root.setAttribute("data-width", String(W));
+          root.setAttribute("data-height", String(H));
+          root.setAttribute("data-duration", String(durationS));
+          var brand = (data && data.brand) || {};
+          if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+            root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+          } else {
+            root.style.removeProperty("--hf-caption-primary");
+          }
+          if (typeof brand.accentColor === "string" && brand.accentColor) {
+            root.style.setProperty("--hf-caption-accent", brand.accentColor);
+          } else {
+            root.style.removeProperty("--hf-caption-accent");
+          }
+          return {
+            W: W,
+            H: H,
+            scaleX: W / 1920,
+            scaleY: H / 1080,
+            fontScale: Math.min(W, H) / 1080,
+          };
         }
-        return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
-      }
 
-      function hfPublishStatus(status) {
-        window.__HF_CAPTION_STATUS = status;
-        document
-          .getElementById(HF_ROOT_ID)
-          .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
-      }
+        function hfPublishStatus(status) {
+          window.__HF_CAPTION_STATUS = status;
+          document
+            .getElementById(HF_ROOT_ID)
+            .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+        }
 
-      function hfRunGate(words, durationS, failReason) {
-        if (failReason) {
+        function hfRunGate(words, durationS, failReason) {
+          if (failReason) {
+            hfPublishStatus({
+              ok: false,
+              present: false,
+              contained: false,
+              reason: failReason,
+              version: HF_CONTRACT_VERSION,
+              durationS: durationS || 0,
+            });
+            return;
+          }
+          var root = document.getElementById(HF_ROOT_ID);
+          var rootRect = root.getBoundingClientRect();
+          var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+          var present = false;
+          var contained = true;
+          var tokens = [];
+          words.forEach(function (w) {
+            var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+            if (t) tokens.push(t);
+          });
+          groups.forEach(function (el) {
+            var prevOpacity = el.style.opacity;
+            var prevVisibility = el.style.visibility;
+            el.style.opacity = "1";
+            el.style.visibility = "visible";
+            var r = el.getBoundingClientRect();
+            if (r.width > 0 && r.height > 0) {
+              var text = (el.textContent || "").toLowerCase();
+              for (var i = 0; i < tokens.length; i++) {
+                if (text.indexOf(tokens[i]) !== -1) {
+                  present = true;
+                  break;
+                }
+              }
+              if (
+                r.left < rootRect.left - 1 ||
+                r.right > rootRect.right + 1 ||
+                r.top < rootRect.top - 1 ||
+                r.bottom > rootRect.bottom + 1
+              ) {
+                contained = false;
+              }
+            }
+            el.style.opacity = prevOpacity;
+            el.style.visibility = prevVisibility;
+          });
           hfPublishStatus({
-            ok: false,
-            present: false,
-            contained: false,
-            reason: failReason,
+            ok: present && contained,
+            present: present,
+            contained: contained,
             version: HF_CONTRACT_VERSION,
-            durationS: durationS || 0,
+            durationS: durationS,
           });
-          return;
         }
-        var root = document.getElementById(HF_ROOT_ID);
-        var rootRect = root.getBoundingClientRect();
-        var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
-        var present = false;
-        var contained = true;
-        var tokens = [];
-        words.forEach(function (w) {
-          var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
-          if (t) tokens.push(t);
-        });
-        groups.forEach(function (el) {
-          var prevOpacity = el.style.opacity;
-          var prevVisibility = el.style.visibility;
-          el.style.opacity = "1";
-          el.style.visibility = "visible";
-          var r = el.getBoundingClientRect();
-          if (r.width > 0 && r.height > 0) {
-            var text = (el.textContent || "").toLowerCase();
-            for (var i = 0; i < tokens.length; i++) {
-              if (text.indexOf(tokens[i]) !== -1) {
-                present = true;
-                break;
-              }
-            }
-            if (
-              r.left < rootRect.left - 1 ||
-              r.right > rootRect.right + 1 ||
-              r.top < rootRect.top - 1 ||
-              r.bottom > rootRect.bottom + 1
-            ) {
-              contained = false;
-            }
-          }
-          el.style.opacity = prevOpacity;
-          el.style.visibility = prevVisibility;
-        });
-        hfPublishStatus({
-          ok: present && contained,
-          present: present,
-          contained: contained,
-          version: HF_CONTRACT_VERSION,
-          durationS: durationS,
-        });
-      }
-
-      var HF_STOPWORDS = new Set([
-        "the",
-        "a",
-        "an",
-        "and",
-        "or",
-        "but",
-        "is",
-        "are",
-        "was",
-        "were",
-        "to",
-        "of",
-        "in",
-        "on",
-        "at",
-        "for",
-        "with",
-        "by",
-        "from",
-        "as",
-        "it",
-        "its",
-        "this",
-        "that",
-        "these",
-        "those",
-        "be",
-        "been",
-        "have",
-        "has",
-        "had",
-        "do",
-        "does",
-        "did",
-        "will",
-        "would",
-        "could",
-        "should",
-        "may",
-        "might",
-        "must",
-        "can",
-        "if",
-        "then",
-        "so",
-        "just",
-        "not",
-        "no",
-        "yes",
-        "up",
-        "out",
-        "about",
-        "into",
-        "over",
-        "after",
-        "before",
-        "your",
-        "you",
-        "our",
-        "we",
-        "they",
-        "them",
-        "their",
-        "there",
-        "here",
-        "when",
-        "what",
-        "which",
-        "who",
-        "how",
-        "all",
-        "any",
-        "some",
-        "more",
-        "most",
-        "other",
-        "than",
-        "too",
-        "very",
-        "also",
-        "because",
-      ]);
-
-      function hfIsEmphasisWord(text) {
-        var clean = String(text)
-          .toLowerCase()
-          .replace(/[^a-z]/g, "");
-        return clean.length >= 5 && !HF_STOPWORDS.has(clean);
-      }
 
-      var DURATION, SAFE_WIDTH;
-      var ENTRY_DUR = 0.1;
-      var SLIDE_DUR = 0.2;
-
-      var _fitCanvas = document.createElement("canvas");
-      var _fitCtx = _fitCanvas.getContext("2d");
-      function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
-        var size = baseFontSize;
-        var minSize = Math.floor(baseFontSize * 0.45);
-        while (size > minSize) {
-          _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
-          if (_fitCtx.measureText(text).width <= maxWidth) return size;
-          size -= 2;
+        var HF_STOPWORDS = new Set([
+          "the",
+          "a",
+          "an",
+          "and",
+          "or",
+          "but",
+          "is",
+          "are",
+          "was",
+          "were",
+          "to",
+          "of",
+          "in",
+          "on",
+          "at",
+          "for",
+          "with",
+          "by",
+          "from",
+          "as",
+          "it",
+          "its",
+          "this",
+          "that",
+          "these",
+          "those",
+          "be",
+          "been",
+          "have",
+          "has",
+          "had",
+          "do",
+          "does",
+          "did",
+          "will",
+          "would",
+          "could",
+          "should",
+          "may",
+          "might",
+          "must",
+          "can",
+          "if",
+          "then",
+          "so",
+          "just",
+          "not",
+          "no",
+          "yes",
+          "up",
+          "out",
+          "about",
+          "into",
+          "over",
+          "after",
+          "before",
+          "your",
+          "you",
+          "our",
+          "we",
+          "they",
+          "them",
+          "their",
+          "there",
+          "here",
+          "when",
+          "what",
+          "which",
+          "who",
+          "how",
+          "all",
+          "any",
+          "some",
+          "more",
+          "most",
+          "other",
+          "than",
+          "too",
+          "very",
+          "also",
+          "because",
+        ]);
+
+        function hfIsEmphasisWord(text) {
+          var clean = String(text)
+            .toLowerCase()
+            .replace(/[^a-z]/g, "");
+          return clean.length >= 5 && !HF_STOPWORDS.has(clean);
         }
-        return minSize;
-      }
 
-      var CLASS_MAP = { n: "word word--normal", e: "word word--emphasis" };
-
-      var W = [];
-      var BLOCKS = [];
-
-      var MAX_WORDS_PER_BLOCK = 5;
-      var PAUSE_THRESHOLD = 0.1;
-
-      function hfMakeBlocks(words) {
-        var blocks = [];
-        var current = [];
-        words.forEach(function (w, i) {
-          current.push(i);
-          var isEmph = hfIsEmphasisWord(w.text);
-          var punctuation = /[,.:!?]$/.test(w.text);
-          var next = words[i + 1];
-          var pause = next ? next.start - w.end : Infinity;
-          if (
-            isEmph ||
-            punctuation ||
-            pause >= PAUSE_THRESHOLD ||
-            current.length >= MAX_WORDS_PER_BLOCK ||
-            !next
-          ) {
-            if (isEmph && current.length > 1) {
-              blocks.push({
-                line1: current.slice(0, -1).map(function (ix) {
-                  return [ix, "n"];
-                }),
-                line2: [[current[current.length - 1], "e"]],
-              });
-            } else if (isEmph) {
-              blocks.push({ line1: [[current[0], "e"]], line2: null });
-            } else if (current.length > 3) {
-              var split = Math.ceil(current.length / 2);
-              blocks.push({
-                line1: current.slice(0, split).map(function (ix) {
-                  return [ix, "n"];
-                }),
-                line2: current.slice(split).map(function (ix) {
-                  return [ix, "n"];
-                }),
-              });
-            } else {
-              blocks.push({
-                line1: current.map(function (ix) {
-                  return [ix, "n"];
-                }),
-                line2: null,
-              });
-            }
-            current = [];
+        var DURATION, SAFE_WIDTH;
+        var ENTRY_DUR = 0.1;
+        var SLIDE_DUR = 0.2;
+
+        var _fitCanvas = document.createElement("canvas");
+        var _fitCtx = _fitCanvas.getContext("2d");
+        function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
+          var size = baseFontSize;
+          var minSize = Math.floor(baseFontSize * 0.45);
+          while (size > minSize) {
+            _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
+            if (_fitCtx.measureText(text).width <= maxWidth) return size;
+            size -= 2;
           }
-        });
-        return blocks;
-      }
+          return minSize;
+        }
 
-      function hfTeardown() {
-        document.getElementById("caption-stage").innerHTML = "";
-      }
+        var CLASS_MAP = { n: "word word--normal", e: "word word--emphasis" };
 
-      function hfBuild(words, layout, durationS) {
-        DURATION = durationS;
-        var stage = document.getElementById("caption-stage");
-        var fontNormal = Math.round(86 * layout.fontScale);
-        var fontEmphasis = Math.round(180 * layout.fontScale);
-        var marginX = Math.round(60 * layout.scaleX);
-        var blockH = Math.round(430 * layout.fontScale);
-        SAFE_WIDTH = layout.W - marginX * 2;
-        stage.style.left = marginX + "px";
-        stage.style.width = SAFE_WIDTH + "px";
-        stage.style.height = blockH + "px";
-        stage.style.top = Math.max(0, layout.H - blockH - Math.round(70 * layout.scaleY)) + "px";
-
-        W = words;
-        BLOCKS = hfMakeBlocks(words);
-
-        function computeLineSize(linePairs) {
-          var hasEmphasis = linePairs.some(function (p) {
-            return p[1] === "e";
+        var W = [];
+        var BLOCKS = [];
+
+        var MAX_WORDS_PER_BLOCK = 5;
+        var PAUSE_THRESHOLD = 0.1;
+
+        function hfMakeBlocks(words) {
+          var blocks = [];
+          var current = [];
+          words.forEach(function (w, i) {
+            current.push(i);
+            var isEmph = hfIsEmphasisWord(w.text);
+            var punctuation = /[,.:!?]$/.test(w.text);
+            var next = words[i + 1];
+            var pause = next ? next.start - w.end : Infinity;
+            if (
+              isEmph ||
+              punctuation ||
+              pause >= PAUSE_THRESHOLD ||
+              current.length >= MAX_WORDS_PER_BLOCK ||
+              !next
+            ) {
+              if (isEmph && current.length > 1) {
+                blocks.push({
+                  line1: current.slice(0, -1).map(function (ix) {
+                    return [ix, "n"];
+                  }),
+                  line2: [[current[current.length - 1], "e"]],
+                });
+              } else if (isEmph) {
+                blocks.push({ line1: [[current[0], "e"]], line2: null });
+              } else if (current.length > 3) {
+                var split = Math.ceil(current.length / 2);
+                blocks.push({
+                  line1: current.slice(0, split).map(function (ix) {
+                    return [ix, "n"];
+                  }),
+                  line2: current.slice(split).map(function (ix) {
+                    return [ix, "n"];
+                  }),
+                });
+              } else {
+                blocks.push({
+                  line1: current.map(function (ix) {
+                    return [ix, "n"];
+                  }),
+                  line2: null,
+                });
+              }
+              current = [];
+            }
           });
-          var lineText = linePairs
-            .map(function (p) {
-              return W[p[0]].text;
-            })
-            .join(" ");
-          if (hasEmphasis) {
-            return fitFontSize(lineText, fontEmphasis, "800", "Playfair Display", SAFE_WIDTH);
-          }
-          return fitFontSize(lineText, fontNormal, "400", "Inter", SAFE_WIDTH);
+          return blocks;
         }
 
-        function buildBlocks() {
-          BLOCKS.forEach(function (block, bi) {
-            var el = document.createElement("div");
-            el.className = "caption-block";
-            el.id = "b" + bi;
-
-            var l1Size = computeLineSize(block.line1);
-            var l1 = document.createElement("div");
-            l1.className = "caption-line";
-            l1.id = "b" + bi + "L1";
-            block.line1.forEach(function (pair, wi) {
-              var span = document.createElement("span");
-              span.className = CLASS_MAP[pair[1]];
-              span.id = "b" + bi + "L1w" + wi;
-              span.textContent = W[pair[0]].text;
-              span.style.fontSize = l1Size + "px";
-              l1.appendChild(span);
+        function hfTeardown() {
+          document.getElementById("caption-stage").innerHTML = "";
+        }
+
+        function hfBuild(words, layout, durationS) {
+          DURATION = durationS;
+          var stage = document.getElementById("caption-stage");
+          var fontNormal = Math.round(86 * layout.fontScale);
+          var fontEmphasis = Math.round(180 * layout.fontScale);
+          var marginX = Math.round(60 * layout.scaleX);
+          var blockH = Math.round(430 * layout.fontScale);
+          SAFE_WIDTH = layout.W - marginX * 2;
+          stage.style.left = marginX + "px";
+          stage.style.width = SAFE_WIDTH + "px";
+          stage.style.height = blockH + "px";
+          stage.style.top = Math.max(0, layout.H - blockH - Math.round(70 * layout.scaleY)) + "px";
+
+          W = words;
+          BLOCKS = hfMakeBlocks(words);
+
+          function computeLineSize(linePairs) {
+            var hasEmphasis = linePairs.some(function (p) {
+              return p[1] === "e";
             });
-            el.appendChild(l1);
+            var lineText = linePairs
+              .map(function (p) {
+                return W[p[0]].text;
+              })
+              .join(" ");
+            if (hasEmphasis) {
+              return fitFontSize(lineText, fontEmphasis, "800", "Playfair Display", SAFE_WIDTH);
+            }
+            return fitFontSize(lineText, fontNormal, "400", "Inter", SAFE_WIDTH);
+          }
 
-            if (block.line2) {
-              var l2Size = computeLineSize(block.line2);
-              var l2 = document.createElement("div");
-              l2.className = "caption-line";
-              l2.id = "b" + bi + "L2";
-              block.line2.forEach(function (pair, wi) {
+          function buildBlocks() {
+            BLOCKS.forEach(function (block, bi) {
+              var el = document.createElement("div");
+              el.className = "caption-block";
+              el.id = "b" + bi;
+
+              var l1Size = computeLineSize(block.line1);
+              var l1 = document.createElement("div");
+              l1.className = "caption-line";
+              l1.id = "b" + bi + "L1";
+              block.line1.forEach(function (pair, wi) {
                 var span = document.createElement("span");
                 span.className = CLASS_MAP[pair[1]];
-                span.id = "b" + bi + "L2w" + wi;
+                span.id = "b" + bi + "L1w" + wi;
                 span.textContent = W[pair[0]].text;
-                span.style.fontSize = l2Size + "px";
-                l2.appendChild(span);
+                span.style.fontSize = l1Size + "px";
+                l1.appendChild(span);
               });
-              el.appendChild(l2);
-            }
-
-            stage.appendChild(el);
-          });
-        }
+              el.appendChild(l1);
+
+              if (block.line2) {
+                var l2Size = computeLineSize(block.line2);
+                var l2 = document.createElement("div");
+                l2.className = "caption-line";
+                l2.id = "b" + bi + "L2";
+                block.line2.forEach(function (pair, wi) {
+                  var span = document.createElement("span");
+                  span.className = CLASS_MAP[pair[1]];
+                  span.id = "b" + bi + "L2w" + wi;
+                  span.textContent = W[pair[0]].text;
+                  span.style.fontSize = l2Size + "px";
+                  l2.appendChild(span);
+                });
+                el.appendChild(l2);
+              }
 
-        buildBlocks();
+              stage.appendChild(el);
+            });
+          }
 
-        // Scale blocks that exceed safe width
-        function fitBlocks() {
-          BLOCKS.forEach(function (block, bi) {
-            var el = document.getElementById("b" + bi);
-            el.style.opacity = "1";
-            el.style.position = "relative";
-            var lines = el.querySelectorAll(".caption-line");
-            var maxW = 0;
-            lines.forEach(function (line) {
-              if (line.scrollWidth > maxW) maxW = line.scrollWidth;
+          buildBlocks();
+
+          // Scale blocks that exceed safe width
+          function fitBlocks() {
+            BLOCKS.forEach(function (block, bi) {
+              var el = document.getElementById("b" + bi);
+              el.style.opacity = "1";
+              el.style.position = "relative";
+              var lines = el.querySelectorAll(".caption-line");
+              var maxW = 0;
+              lines.forEach(function (line) {
+                if (line.scrollWidth > maxW) maxW = line.scrollWidth;
+              });
+              if (maxW > SAFE_WIDTH) {
+                var s = SAFE_WIDTH / maxW;
+                el.style.transform = "scale(" + s + ")";
+              }
+              el.style.opacity = "0";
+              el.style.position = "";
             });
-            if (maxW > SAFE_WIDTH) {
-              var s = SAFE_WIDTH / maxW;
-              el.style.transform = "scale(" + s + ")";
-            }
-            el.style.opacity = "0";
-            el.style.position = "";
-          });
-        }
+          }
 
-        fitBlocks();
+          fitBlocks();
 
-        var tl = gsap.timeline({ paused: true });
+          var tl = gsap.timeline({ paused: true });
 
-        var allEls = BLOCKS.map(function (_, i) {
-          return document.getElementById("b" + i);
-        });
+          var allEls = BLOCKS.map(function (_, i) {
+            return document.getElementById("b" + i);
+          });
 
-        function blockStart(bi) {
-          return W[BLOCKS[bi].line1[0][0]].start;
-        }
+          function blockStart(bi) {
+            return W[BLOCKS[bi].line1[0][0]].start;
+          }
 
-        BLOCKS.forEach(function (block, bi) {
-          var el = allEls[bi];
-          var start = blockStart(bi);
-          var nextStart = bi < BLOCKS.length - 1 ? blockStart(bi + 1) : DURATION;
-
-          // Each block already owns its full opacity lifecycle (set 1 at its
-          // own start, then set back to 0 at its own nextStart below), and
-          // blocks occupy non-overlapping windows, so explicitly hiding every
-          // OTHER block here was redundant and made timeline construction
-          // O(blocks^2) — this collapsed under dense stress transcripts (many
-          // single-word emphasis blocks). Removed; behavior is unchanged
-          // (verified against templates.test.ts).
-
-          tl.set(el, { opacity: 1 }, start);
-
-          block.line1.forEach(function (pair, wi) {
-            var wordEl = document.getElementById("b" + bi + "L1w" + wi);
-            var wordStart = W[pair[0]].start;
-            tl.set(wordEl, { opacity: 0, scale: 1.12, transformOrigin: "0% 100%" }, start);
-            tl.to(
-              wordEl,
-              { opacity: 1, scale: 1, duration: ENTRY_DUR, ease: "power2.out" },
-              wordStart,
-            );
-          });
+          BLOCKS.forEach(function (block, bi) {
+            var el = allEls[bi];
+            var start = blockStart(bi);
+            var nextStart = bi < BLOCKS.length - 1 ? blockStart(bi + 1) : DURATION;
 
-          if (block.line2) {
-            var hasEmphasis = block.line2.some(function (p) {
-              return p[1] === "e";
+            // Each block already owns its full opacity lifecycle (set 1 at its
+            // own start, then set back to 0 at its own nextStart below), and
+            // blocks occupy non-overlapping windows, so explicitly hiding every
+            // OTHER block here was redundant and made timeline construction
+            // O(blocks^2) — this collapsed under dense stress transcripts (many
+            // single-word emphasis blocks). Removed; behavior is unchanged
+            // (verified against templates.test.ts).
+
+            tl.set(el, { opacity: 1 }, start);
+
+            block.line1.forEach(function (pair, wi) {
+              var wordEl = document.getElementById("b" + bi + "L1w" + wi);
+              var wordStart = W[pair[0]].start;
+              tl.set(wordEl, { opacity: 0, scale: 1.12, transformOrigin: "0% 100%" }, start);
+              tl.to(
+                wordEl,
+                { opacity: 1, scale: 1, duration: ENTRY_DUR, ease: "power2.out" },
+                wordStart,
+              );
             });
-            var l2El = document.getElementById("b" + bi + "L2");
-            if (hasEmphasis) {
-              var l2Start = W[block.line2[0][0]].start;
-              tl.set(l2El, { opacity: 0, x: -layout.W }, start);
-              tl.to(l2El, { opacity: 1, x: 0, duration: SLIDE_DUR, ease: "power2.out" }, l2Start);
-            } else {
-              tl.set(l2El, { opacity: 1 }, start);
-              block.line2.forEach(function (pair, wi) {
-                var wordEl = document.getElementById("b" + bi + "L2w" + wi);
-                var wordStart = W[pair[0]].start;
-                tl.set(wordEl, { opacity: 0, scale: 1.12, transformOrigin: "0% 100%" }, start);
-                tl.to(
-                  wordEl,
-                  { opacity: 1, scale: 1, duration: ENTRY_DUR, ease: "power2.out" },
-                  wordStart,
-                );
+
+            if (block.line2) {
+              var hasEmphasis = block.line2.some(function (p) {
+                return p[1] === "e";
               });
+              var l2El = document.getElementById("b" + bi + "L2");
+              if (hasEmphasis) {
+                var l2Start = W[block.line2[0][0]].start;
+                tl.set(l2El, { opacity: 0, x: -layout.W }, start);
+                tl.to(l2El, { opacity: 1, x: 0, duration: SLIDE_DUR, ease: "power2.out" }, l2Start);
+              } else {
+                tl.set(l2El, { opacity: 1 }, start);
+                block.line2.forEach(function (pair, wi) {
+                  var wordEl = document.getElementById("b" + bi + "L2w" + wi);
+                  var wordStart = W[pair[0]].start;
+                  tl.set(wordEl, { opacity: 0, scale: 1.12, transformOrigin: "0% 100%" }, start);
+                  tl.to(
+                    wordEl,
+                    { opacity: 1, scale: 1, duration: ENTRY_DUR, ease: "power2.out" },
+                    wordStart,
+                  );
+                });
+              }
             }
-          }
 
-          tl.set(el, { opacity: 0 }, nextStart);
-        });
+            tl.set(el, { opacity: 0 }, nextStart);
+          });
 
-        tl.to({}, { duration: DURATION }, 0);
-        return tl;
-      }
+          tl.to({}, { duration: DURATION }, 0);
+          return tl;
+        }
 
-      var hfCurrentTimeline = null;
+        var hfCurrentTimeline = null;
 
-      function hfAttach(data) {
-        var v = hfValidate(data);
-        if (!v.ok) {
-          hfRunGate([], 0, v.reason);
-          return;
-        }
-        if (hfCurrentTimeline) {
-          hfCurrentTimeline.kill();
-          hfCurrentTimeline = null;
-        }
-        hfTeardown();
-        var layout = hfApplyStageConfig(data, v.durationS);
-        var tl = hfBuild(v.words, layout, v.durationS);
-        tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
-        // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
-        // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
-        // at t=0 — the first frame would show pre-timeline CSS defaults (usually
-        // hidden). render(time, suppressEvents, force) with force=true bypasses that.
-        tl.render(0, true, true);
-        hfCurrentTimeline = tl;
-        window.__timelines = window.__timelines || {};
-        window.__timelines[HF_COMPOSITION_ID] = tl;
-        hfRunGate(v.words, v.durationS, null);
-      }
-      window.__HF_CAPTION_ATTACH__ = hfAttach;
-
-      (function hfBoot() {
-        function start(data) {
-          var ready =
-            document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
-          ready.then(function () {
-            hfAttach(data);
-          });
-        }
-        if (window.__HF_CAPTION__) {
-          start(window.__HF_CAPTION__);
-          return;
+        function hfAttach(data) {
+          var v = hfValidate(data);
+          if (!v.ok) {
+            hfRunGate([], 0, v.reason);
+            return;
+          }
+          if (hfCurrentTimeline) {
+            hfCurrentTimeline.kill();
+            hfCurrentTimeline = null;
+          }
+          hfTeardown();
+          var layout = hfApplyStageConfig(data, v.durationS);
+          var tl = hfBuild(v.words, layout, v.durationS);
+          tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+          // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+          // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+          // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+          // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+          tl.render(0, true, true);
+          hfCurrentTimeline = tl;
+          window.__timelines = window.__timelines || {};
+          window.__timelines[HF_COMPOSITION_ID] = tl;
+          hfRunGate(v.words, v.durationS, null);
         }
-        fetch("./caption-data.json")
-          .then(function (r) {
-            return r.ok ? r.json() : null;
-          })
-          .catch(function () {
-            return null;
-          })
-          .then(function (json) {
-            start(json || HF_DEMO_DATA);
-          });
+        window.__HF_CAPTION_ATTACH__ = hfAttach;
+
+        (function hfBoot() {
+          function start(data) {
+            var ready =
+              document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+            ready.then(function () {
+              hfAttach(data);
+            });
+          }
+          if (window.__HF_CAPTION__) {
+            start(window.__HF_CAPTION__);
+            return;
+          }
+          fetch("./caption-data.json")
+            .then(function (r) {
+              return r.ok ? r.json() : null;
+            })
+            .catch(function () {
+              return null;
+            })
+            .then(function (json) {
+              start(json || HF_DEMO_DATA);
+            });
+        })();
       })();
     </script>
   </body>
diff --git a/registry/components/caption-emoji-pop/caption-emoji-pop.html b/registry/components/caption-emoji-pop/caption-emoji-pop.html
index e9837d5f61..6d6f15c697 100644
--- a/registry/components/caption-emoji-pop/caption-emoji-pop.html
+++ b/registry/components/caption-emoji-pop/caption-emoji-pop.html
@@ -125,669 +125,689 @@
     </div>
 
     <script>
-      var HF_COMPOSITION_ID = "caption-emoji-pop";
-      var HF_ROOT_ID = "emoji-pop";
-      var HF_GROUP_SELECTOR = ".caption-group";
-
-      var HF_DEMO_DATA = {
-        version: 1,
-        segments: [
-          {
-            start: 0,
-            text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
-            words: [
-              { text: "Every", start: 0.0, end: 0.3 },
-              { text: "great", start: 0.3, end: 0.55 },
-              { text: "video", start: 0.55, end: 0.85 },
-              { text: "starts", start: 0.85, end: 1.1 },
-              { text: "with", start: 1.1, end: 1.25 },
-              { text: "a", start: 1.25, end: 1.35 },
-              { text: "single", start: 1.35, end: 1.65 },
-              { text: "frame.", start: 1.65, end: 2.0 },
-              { text: "HyperFrames", start: 2.1, end: 2.65 },
-              { text: "lets", start: 2.65, end: 2.85 },
-              { text: "you", start: 2.85, end: 2.95 },
-              { text: "write", start: 2.95, end: 3.15 },
-              { text: "HTML", start: 3.15, end: 3.55 },
-              { text: "and", start: 3.55, end: 3.65 },
-              { text: "render", start: 3.65, end: 3.95 },
-              { text: "professional", start: 3.95, end: 4.45 },
-              { text: "video.", start: 4.45, end: 4.8 },
-              { text: "No", start: 4.9, end: 5.05 },
-              { text: "timeline.", start: 5.05, end: 5.45 },
-              { text: "No", start: 5.5, end: 5.65 },
-              { text: "drag", start: 5.65, end: 5.85 },
-              { text: "and", start: 5.85, end: 5.95 },
-              { text: "drop.", start: 5.95, end: 6.25 },
-              { text: "Just", start: 6.35, end: 6.55 },
-              { text: "code", start: 6.55, end: 6.8 },
-              { text: "that", start: 6.8, end: 6.95 },
-              { text: "becomes", start: 6.95, end: 7.3 },
-              { text: "cinema.", start: 7.3, end: 7.7 },
-            ],
-          },
-        ],
-      };
-
-      /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
-      var HF_CONTRACT_VERSION = 1;
-      var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
-
-      function hfFlattenSegments(segments) {
-        var out = [];
-        (segments || []).forEach(function (seg) {
-          ((seg && seg.words) || []).forEach(function (w) {
-            var start = Math.max(0, Number(w.start) || 0);
-            out.push({
-              text: String(w.word || w.text || "").trim(),
-              start: start,
-              end: Math.max(start, Number(w.end) || 0),
+      // IIFE: keep every template's runtime private to itself so two caption
+      // components pasted into one composition document can't clobber each
+      // other's hfAttach/hfBuild via shared script-scope names (boot is async,
+      // so collisions surface AFTER all scripts have executed).
+      (function () {
+        var HF_COMPOSITION_ID = "caption-emoji-pop";
+        var HF_ROOT_ID = "emoji-pop";
+        var HF_GROUP_SELECTOR = ".caption-group";
+
+        var HF_DEMO_DATA = {
+          version: 1,
+          segments: [
+            {
+              start: 0,
+              text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+              words: [
+                { text: "Every", start: 0.0, end: 0.3 },
+                { text: "great", start: 0.3, end: 0.55 },
+                { text: "video", start: 0.55, end: 0.85 },
+                { text: "starts", start: 0.85, end: 1.1 },
+                { text: "with", start: 1.1, end: 1.25 },
+                { text: "a", start: 1.25, end: 1.35 },
+                { text: "single", start: 1.35, end: 1.65 },
+                { text: "frame.", start: 1.65, end: 2.0 },
+                { text: "HyperFrames", start: 2.1, end: 2.65 },
+                { text: "lets", start: 2.65, end: 2.85 },
+                { text: "you", start: 2.85, end: 2.95 },
+                { text: "write", start: 2.95, end: 3.15 },
+                { text: "HTML", start: 3.15, end: 3.55 },
+                { text: "and", start: 3.55, end: 3.65 },
+                { text: "render", start: 3.65, end: 3.95 },
+                { text: "professional", start: 3.95, end: 4.45 },
+                { text: "video.", start: 4.45, end: 4.8 },
+                { text: "No", start: 4.9, end: 5.05 },
+                { text: "timeline.", start: 5.05, end: 5.45 },
+                { text: "No", start: 5.5, end: 5.65 },
+                { text: "drag", start: 5.65, end: 5.85 },
+                { text: "and", start: 5.85, end: 5.95 },
+                { text: "drop.", start: 5.95, end: 6.25 },
+                { text: "Just", start: 6.35, end: 6.55 },
+                { text: "code", start: 6.55, end: 6.8 },
+                { text: "that", start: 6.8, end: 6.95 },
+                { text: "becomes", start: 6.95, end: 7.3 },
+                { text: "cinema.", start: 7.3, end: 7.7 },
+              ],
+            },
+          ],
+        };
+
+        /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+        var HF_CONTRACT_VERSION = 1;
+        var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
+
+        function hfFlattenSegments(segments) {
+          var out = [];
+          (segments || []).forEach(function (seg) {
+            ((seg && seg.words) || []).forEach(function (w) {
+              var start = Math.max(0, Number(w.start) || 0);
+              out.push({
+                text: String(w.word || w.text || "").trim(),
+                start: start,
+                end: Math.max(start, Number(w.end) || 0),
+              });
             });
           });
-        });
-        out.sort(function (a, b) {
-          return a.start - b.start;
-        });
-        return out.filter(function (w) {
-          return w.text.length > 0;
-        });
-      }
-
-      function hfDeriveDuration(words) {
-        var end = 0;
-        words.forEach(function (w) {
-          if (w.end > end) end = w.end;
-        });
-        return end;
-      }
-
-      function hfValidate(data) {
-        if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-        if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-          return { ok: false, reason: "unsupported-version" };
-        }
-        if (!Array.isArray(data.segments) || data.segments.length === 0) {
-          return { ok: false, reason: "no-segments" };
+          out.sort(function (a, b) {
+            return a.start - b.start;
+          });
+          return out.filter(function (w) {
+            return w.text.length > 0;
+          });
         }
-        if (data.displayMode != null && data.displayMode !== "full") {
-          return { ok: false, reason: "unsupported-displayMode" };
+
+        function hfDeriveDuration(words) {
+          var end = 0;
+          words.forEach(function (w) {
+            if (w.end > end) end = w.end;
+          });
+          return end;
         }
-        var words = hfFlattenSegments(data.segments);
-        if (words.length === 0) return { ok: false, reason: "no-words" };
-        return { ok: true, words: words, durationS: hfDeriveDuration(words) };
-      }
 
-      function hfApplyStageConfig(data, durationS) {
-        var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-        var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-        var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
-        var root = document.getElementById(HF_ROOT_ID);
-        [document.documentElement, document.body, root].forEach(function (el) {
-          el.style.width = W + "px";
-          el.style.height = H + "px";
-        });
-        root.setAttribute("data-width", String(W));
-        root.setAttribute("data-height", String(H));
-        root.setAttribute("data-duration", String(durationS));
-        var brand = (data && data.brand) || {};
-        if (typeof brand.primaryColor === "string" && brand.primaryColor) {
-          root.style.setProperty("--hf-caption-primary", brand.primaryColor);
-        } else {
-          root.style.removeProperty("--hf-caption-primary");
+        function hfValidate(data) {
+          if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+            return { ok: false, reason: "unsupported-version" };
+          }
+          if (!Array.isArray(data.segments) || data.segments.length === 0) {
+            return { ok: false, reason: "no-segments" };
+          }
+          if (data.displayMode != null && data.displayMode !== "full") {
+            return { ok: false, reason: "unsupported-displayMode" };
+          }
+          var words = hfFlattenSegments(data.segments);
+          if (words.length === 0) return { ok: false, reason: "no-words" };
+          return { ok: true, words: words, durationS: hfDeriveDuration(words) };
         }
-        if (typeof brand.accentColor === "string" && brand.accentColor) {
-          root.style.setProperty("--hf-caption-accent", brand.accentColor);
-        } else {
-          root.style.removeProperty("--hf-caption-accent");
+
+        function hfApplyStageConfig(data, durationS) {
+          var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          var root = document.getElementById(HF_ROOT_ID);
+          [document.documentElement, document.body, root].forEach(function (el) {
+            el.style.width = W + "px";
+            el.style.height = H + "px";
+          });
+          root.setAttribute("data-width", String(W));
+          root.setAttribute("data-height", String(H));
+          root.setAttribute("data-duration", String(durationS));
+          var brand = (data && data.brand) || {};
+          if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+            root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+          } else {
+            root.style.removeProperty("--hf-caption-primary");
+          }
+          if (typeof brand.accentColor === "string" && brand.accentColor) {
+            root.style.setProperty("--hf-caption-accent", brand.accentColor);
+          } else {
+            root.style.removeProperty("--hf-caption-accent");
+          }
+          return {
+            W: W,
+            H: H,
+            scaleX: W / 1920,
+            scaleY: H / 1080,
+            fontScale: Math.min(W, H) / 1080,
+          };
         }
-        return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
-      }
 
-      function hfPublishStatus(status) {
-        window.__HF_CAPTION_STATUS = status;
-        document
-          .getElementById(HF_ROOT_ID)
-          .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
-      }
+        function hfPublishStatus(status) {
+          window.__HF_CAPTION_STATUS = status;
+          document
+            .getElementById(HF_ROOT_ID)
+            .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+        }
 
-      function hfRunGate(words, durationS, failReason) {
-        if (failReason) {
+        function hfRunGate(words, durationS, failReason) {
+          if (failReason) {
+            hfPublishStatus({
+              ok: false,
+              present: false,
+              contained: false,
+              reason: failReason,
+              version: HF_CONTRACT_VERSION,
+              durationS: durationS || 0,
+            });
+            return;
+          }
+          var root = document.getElementById(HF_ROOT_ID);
+          var rootRect = root.getBoundingClientRect();
+          var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+          var present = false;
+          var contained = true;
+          var tokens = [];
+          words.forEach(function (w) {
+            var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+            if (t) tokens.push(t);
+          });
+          groups.forEach(function (el) {
+            var prevOpacity = el.style.opacity;
+            var prevVisibility = el.style.visibility;
+            el.style.opacity = "1";
+            el.style.visibility = "visible";
+            var r = el.getBoundingClientRect();
+            if (r.width > 0 && r.height > 0) {
+              var text = (el.textContent || "").toLowerCase();
+              for (var i = 0; i < tokens.length; i++) {
+                if (text.indexOf(tokens[i]) !== -1) {
+                  present = true;
+                  break;
+                }
+              }
+              if (
+                r.left < rootRect.left - 1 ||
+                r.right > rootRect.right + 1 ||
+                r.top < rootRect.top - 1 ||
+                r.bottom > rootRect.bottom + 1
+              ) {
+                contained = false;
+              }
+            }
+            el.style.opacity = prevOpacity;
+            el.style.visibility = prevVisibility;
+          });
           hfPublishStatus({
-            ok: false,
-            present: false,
-            contained: false,
-            reason: failReason,
+            ok: present && contained,
+            present: present,
+            contained: contained,
             version: HF_CONTRACT_VERSION,
-            durationS: durationS || 0,
+            durationS: durationS,
           });
-          return;
         }
-        var root = document.getElementById(HF_ROOT_ID);
-        var rootRect = root.getBoundingClientRect();
-        var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
-        var present = false;
-        var contained = true;
-        var tokens = [];
-        words.forEach(function (w) {
-          var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
-          if (t) tokens.push(t);
-        });
-        groups.forEach(function (el) {
-          var prevOpacity = el.style.opacity;
-          var prevVisibility = el.style.visibility;
-          el.style.opacity = "1";
-          el.style.visibility = "visible";
-          var r = el.getBoundingClientRect();
-          if (r.width > 0 && r.height > 0) {
-            var text = (el.textContent || "").toLowerCase();
-            for (var i = 0; i < tokens.length; i++) {
-              if (text.indexOf(tokens[i]) !== -1) {
-                present = true;
-                break;
-              }
-            }
-            if (
-              r.left < rootRect.left - 1 ||
-              r.right > rootRect.right + 1 ||
-              r.top < rootRect.top - 1 ||
-              r.bottom > rootRect.bottom + 1
-            ) {
-              contained = false;
-            }
-          }
-          el.style.opacity = prevOpacity;
-          el.style.visibility = prevVisibility;
-        });
-        hfPublishStatus({
-          ok: present && contained,
-          present: present,
-          contained: contained,
-          version: HF_CONTRACT_VERSION,
-          durationS: durationS,
-        });
-      }
 
-      var HF_STOPWORDS = new Set([
-        "the",
-        "a",
-        "an",
-        "and",
-        "or",
-        "but",
-        "is",
-        "are",
-        "was",
-        "were",
-        "to",
-        "of",
-        "in",
-        "on",
-        "at",
-        "for",
-        "with",
-        "by",
-        "from",
-        "as",
-        "it",
-        "its",
-        "this",
-        "that",
-        "these",
-        "those",
-        "be",
-        "been",
-        "have",
-        "has",
-        "had",
-        "do",
-        "does",
-        "did",
-        "will",
-        "would",
-        "could",
-        "should",
-        "may",
-        "might",
-        "must",
-        "can",
-        "if",
-        "then",
-        "so",
-        "just",
-        "not",
-        "no",
-        "yes",
-        "up",
-        "out",
-        "about",
-        "into",
-        "over",
-        "after",
-        "before",
-        "your",
-        "you",
-        "our",
-        "we",
-        "they",
-        "them",
-        "their",
-        "there",
-        "here",
-        "when",
-        "what",
-        "which",
-        "who",
-        "how",
-        "all",
-        "any",
-        "some",
-        "more",
-        "most",
-        "other",
-        "than",
-        "too",
-        "very",
-        "also",
-        "because",
-      ]);
-
-      function hfIsEmphasisWord(text) {
-        var clean = String(text)
-          .toLowerCase()
-          .replace(/[^a-z]/g, "");
-        return clean.length >= 5 && !HF_STOPWORDS.has(clean);
-      }
+        var HF_STOPWORDS = new Set([
+          "the",
+          "a",
+          "an",
+          "and",
+          "or",
+          "but",
+          "is",
+          "are",
+          "was",
+          "were",
+          "to",
+          "of",
+          "in",
+          "on",
+          "at",
+          "for",
+          "with",
+          "by",
+          "from",
+          "as",
+          "it",
+          "its",
+          "this",
+          "that",
+          "these",
+          "those",
+          "be",
+          "been",
+          "have",
+          "has",
+          "had",
+          "do",
+          "does",
+          "did",
+          "will",
+          "would",
+          "could",
+          "should",
+          "may",
+          "might",
+          "must",
+          "can",
+          "if",
+          "then",
+          "so",
+          "just",
+          "not",
+          "no",
+          "yes",
+          "up",
+          "out",
+          "about",
+          "into",
+          "over",
+          "after",
+          "before",
+          "your",
+          "you",
+          "our",
+          "we",
+          "they",
+          "them",
+          "their",
+          "there",
+          "here",
+          "when",
+          "what",
+          "which",
+          "who",
+          "how",
+          "all",
+          "any",
+          "some",
+          "more",
+          "most",
+          "other",
+          "than",
+          "too",
+          "very",
+          "also",
+          "because",
+        ]);
+
+        function hfIsEmphasisWord(text) {
+          var clean = String(text)
+            .toLowerCase()
+            .replace(/[^a-z]/g, "");
+          return clean.length >= 5 && !HF_STOPWORDS.has(clean);
+        }
 
-      var DURATION, SAFE_ZONE_WIDTH, CAPTION_FONT_SIZE, WORD_SPACING;
-      var MAX_WORDS_PER_GROUP = 3;
-      var PAUSE_THRESHOLD = 0.1;
-      var ENTRY_FRAMES = 4;
-      var EXIT_FRAMES = 3;
-      var FPS = 30;
-      var ENTRY_DURATION = ENTRY_FRAMES / FPS;
-      var EXIT_DURATION = EXIT_FRAMES / FPS;
-      var FONT_WIDTH_SAFETY = 1.14;
-      var PRIMARY_COLOR = "#FFFFFF";
-      var ACCENT_COLORS = ["#FF76FF", "#FF0002", "#B2F7FF"];
-      var hfPrimaryColor = PRIMARY_COLOR;
-      var hfAccentColors = ACCENT_COLORS;
-      var hfFontScale = 1;
-
-      // Emoji map for a generic keyword lexicon (not tied to the demo transcript)
-      var WORD_EMOJI = {
-        amazing: "🤩",
-        awesome: "🔥",
-        big: "🐘",
-        brain: "🧠",
-        build: "🛠️",
-        built: "🛠️",
-        celebrate: "🎉",
-        change: "🔄",
-        cinema: "🎥",
-        code: "⌨️",
-        customers: "🤝",
-        data: "📊",
-        dream: "💭",
-        easy: "👌",
-        fast: "⚡",
-        fire: "🔥",
-        frame: "🖼️",
-        free: "🎁",
-        fun: "🎈",
-        future: "🔮",
-        global: "🌍",
-        grow: "📈",
-        growth: "📈",
-        heart: "❤️",
-        huge: "🐘",
-        idea: "💡",
-        launch: "🚀",
-        learn: "📚",
-        love: "❤️",
-        magic: "✨",
-        money: "💰",
-        music: "🎵",
-        new: "✨",
-        party: "🎉",
-        perfect: "💯",
-        power: "💪",
-        professional: "✨",
-        rocket: "🚀",
-        save: "🛟",
-        saves: "🛟",
-        secret: "🤫",
-        smart: "🧠",
-        star: "⭐",
-        stop: "✋",
-        strong: "💪",
-        success: "🏆",
-        team: "👥",
-        time: "⏰",
-        today: "📅",
-        video: "📹",
-        win: "🏆",
-        world: "🌍",
-        wow: "😮",
-      };
-
-      function normalizeWords(rawWords) {
-        return rawWords
-          .map(function (item) {
-            var text = String(item.word || item.text || "").trim();
-            var clean = text.toLowerCase().replace(/[^a-z]/g, "");
-            return {
-              text: text,
-              start: Math.max(0, Number(item.start) || 0),
-              end: Math.min(DURATION, Math.max(Number(item.start) || 0, Number(item.end) || 0)),
-              emoji: WORD_EMOJI[clean] || null,
-            };
-          })
-          .filter(function (word) {
-            return word.text.length > 0;
-          });
-      }
+        var DURATION, SAFE_ZONE_WIDTH, CAPTION_FONT_SIZE, WORD_SPACING;
+        var MAX_WORDS_PER_GROUP = 3;
+        var PAUSE_THRESHOLD = 0.1;
+        var ENTRY_FRAMES = 4;
+        var EXIT_FRAMES = 3;
+        var FPS = 30;
+        var ENTRY_DURATION = ENTRY_FRAMES / FPS;
+        var EXIT_DURATION = EXIT_FRAMES / FPS;
+        var FONT_WIDTH_SAFETY = 1.14;
+        var PRIMARY_COLOR = "#FFFFFF";
+        var ACCENT_COLORS = ["#FF76FF", "#FF0002", "#B2F7FF"];
+        var hfPrimaryColor = PRIMARY_COLOR;
+        var hfAccentColors = ACCENT_COLORS;
+        var hfFontScale = 1;
+
+        // Emoji map for a generic keyword lexicon (not tied to the demo transcript)
+        var WORD_EMOJI = {
+          amazing: "🤩",
+          awesome: "🔥",
+          big: "🐘",
+          brain: "🧠",
+          build: "🛠️",
+          built: "🛠️",
+          celebrate: "🎉",
+          change: "🔄",
+          cinema: "🎥",
+          code: "⌨️",
+          customers: "🤝",
+          data: "📊",
+          dream: "💭",
+          easy: "👌",
+          fast: "⚡",
+          fire: "🔥",
+          frame: "🖼️",
+          free: "🎁",
+          fun: "🎈",
+          future: "🔮",
+          global: "🌍",
+          grow: "📈",
+          growth: "📈",
+          heart: "❤️",
+          huge: "🐘",
+          idea: "💡",
+          launch: "🚀",
+          learn: "📚",
+          love: "❤️",
+          magic: "✨",
+          money: "💰",
+          music: "🎵",
+          new: "✨",
+          party: "🎉",
+          perfect: "💯",
+          power: "💪",
+          professional: "✨",
+          rocket: "🚀",
+          save: "🛟",
+          saves: "🛟",
+          secret: "🤫",
+          smart: "🧠",
+          star: "⭐",
+          stop: "✋",
+          strong: "💪",
+          success: "🏆",
+          team: "👥",
+          time: "⏰",
+          today: "📅",
+          video: "📹",
+          win: "🏆",
+          world: "🌍",
+          wow: "😮",
+        };
 
-      function seededRandom(seed) {
-        var x = Math.sin(seed * 9999) * 10000;
-        return x - Math.floor(x);
-      }
+        function normalizeWords(rawWords) {
+          return rawWords
+            .map(function (item) {
+              var text = String(item.word || item.text || "").trim();
+              var clean = text.toLowerCase().replace(/[^a-z]/g, "");
+              return {
+                text: text,
+                start: Math.max(0, Number(item.start) || 0),
+                end: Math.min(DURATION, Math.max(Number(item.start) || 0, Number(item.end) || 0)),
+                emoji: WORD_EMOJI[clean] || null,
+              };
+            })
+            .filter(function (word) {
+              return word.text.length > 0;
+            });
+        }
 
-      function assignWordColors(words, groupIndex) {
-        return words.map(function (word, index) {
-          var clean = word.text.toLowerCase().replace(/[^a-z]/g, "");
-          if (hfIsEmphasisWord(word.text)) {
-            var ci = Math.floor(seededRandom(groupIndex * 23 + index * 31) * hfAccentColors.length);
-            return hfAccentColors[ci];
-          }
-          if (HF_STOPWORDS.has(clean)) return hfPrimaryColor;
-          var rand = seededRandom(groupIndex * 13 + index);
-          if (rand > 0.55) {
-            var ci2 = Math.floor(rand * hfAccentColors.length) % hfAccentColors.length;
-            return hfAccentColors[ci2];
-          }
-          return hfPrimaryColor;
-        });
-      }
+        function seededRandom(seed) {
+          var x = Math.sin(seed * 9999) * 10000;
+          return x - Math.floor(x);
+        }
 
-      var _fitCanvas = document.createElement("canvas");
-      var _fitCtx = _fitCanvas.getContext("2d");
-      function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
-        var size = baseFontSize;
-        var minSize = Math.floor(baseFontSize * 0.45);
-        while (size > minSize) {
-          _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
-          if (_fitCtx.measureText(text).width <= maxWidth) return size;
-          size -= 2;
+        function assignWordColors(words, groupIndex) {
+          return words.map(function (word, index) {
+            var clean = word.text.toLowerCase().replace(/[^a-z]/g, "");
+            if (hfIsEmphasisWord(word.text)) {
+              var ci = Math.floor(
+                seededRandom(groupIndex * 23 + index * 31) * hfAccentColors.length,
+              );
+              return hfAccentColors[ci];
+            }
+            if (HF_STOPWORDS.has(clean)) return hfPrimaryColor;
+            var rand = seededRandom(groupIndex * 13 + index);
+            if (rand > 0.55) {
+              var ci2 = Math.floor(rand * hfAccentColors.length) % hfAccentColors.length;
+              return hfAccentColors[ci2];
+            }
+            return hfPrimaryColor;
+          });
+        }
+
+        var _fitCanvas = document.createElement("canvas");
+        var _fitCtx = _fitCanvas.getContext("2d");
+        function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
+          var size = baseFontSize;
+          var minSize = Math.floor(baseFontSize * 0.45);
+          while (size > minSize) {
+            _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
+            if (_fitCtx.measureText(text).width <= maxWidth) return size;
+            size -= 2;
+          }
+          return minSize;
         }
-        return minSize;
-      }
 
-      var measureCanvas = document.createElement("canvas");
-      var measureContext = measureCanvas.getContext("2d");
+        var measureCanvas = document.createElement("canvas");
+        var measureContext = measureCanvas.getContext("2d");
 
-      function measureWord(word, fontSize) {
-        measureContext.font = "900 " + fontSize + "px Gabarito";
-        return measureContext.measureText(word.text.toUpperCase()).width * FONT_WIDTH_SAFETY;
-      }
+        function measureWord(word, fontSize) {
+          measureContext.font = "900 " + fontSize + "px Gabarito";
+          return measureContext.measureText(word.text.toUpperCase()).width * FONT_WIDTH_SAFETY;
+        }
 
-      function measureLineWidth(words, fontSize) {
-        return words.reduce(function (total, word, index) {
-          return total + measureWord(word, fontSize) + (index ? WORD_SPACING : 0);
-        }, 0);
-      }
+        function measureLineWidth(words, fontSize) {
+          return words.reduce(function (total, word, index) {
+            return total + measureWord(word, fontSize) + (index ? WORD_SPACING : 0);
+          }, 0);
+        }
 
-      function fitsLine(words) {
-        return measureLineWidth(words, CAPTION_FONT_SIZE) <= SAFE_ZONE_WIDTH;
-      }
+        function fitsLine(words) {
+          return measureLineWidth(words, CAPTION_FONT_SIZE) <= SAFE_ZONE_WIDTH;
+        }
 
-      function makeGroups(words) {
-        var groups = [];
-        var current = [];
-        words.forEach(function (word, index) {
-          var nextWord = words[index + 1];
-          var testGroup = current.concat([word]);
-          if (testGroup.length > MAX_WORDS_PER_GROUP || !fitsLine(testGroup)) {
-            if (current.length) groups.push(makeGroup(current, groups.length));
-            current = [word];
-            return;
-          }
-          current.push(word);
-          var punctuation = /[,.:!?]$/.test(word.text);
-          var pause = nextWord ? nextWord.start - word.end : 0;
-          if (
-            !nextWord ||
-            punctuation ||
-            pause >= PAUSE_THRESHOLD ||
-            current.length >= MAX_WORDS_PER_GROUP
-          ) {
-            groups.push(makeGroup(current, groups.length));
-            current = [];
-          }
-        });
-        if (current.length) groups.push(makeGroup(current, groups.length));
-        return groups;
-      }
+        function makeGroups(words) {
+          var groups = [];
+          var current = [];
+          words.forEach(function (word, index) {
+            var nextWord = words[index + 1];
+            var testGroup = current.concat([word]);
+            if (testGroup.length > MAX_WORDS_PER_GROUP || !fitsLine(testGroup)) {
+              if (current.length) groups.push(makeGroup(current, groups.length));
+              current = [word];
+              return;
+            }
+            current.push(word);
+            var punctuation = /[,.:!?]$/.test(word.text);
+            var pause = nextWord ? nextWord.start - word.end : 0;
+            if (
+              !nextWord ||
+              punctuation ||
+              pause >= PAUSE_THRESHOLD ||
+              current.length >= MAX_WORDS_PER_GROUP
+            ) {
+              groups.push(makeGroup(current, groups.length));
+              current = [];
+            }
+          });
+          if (current.length) groups.push(makeGroup(current, groups.length));
+          return groups;
+        }
 
-      function makeGroup(words, groupIndex) {
-        var colors = assignWordColors(words, groupIndex);
-        var emoji = null;
-        for (var i = 0; i < words.length; i++) {
-          if (words[i].emoji) {
-            emoji = words[i].emoji;
-            break;
+        function makeGroup(words, groupIndex) {
+          var colors = assignWordColors(words, groupIndex);
+          var emoji = null;
+          for (var i = 0; i < words.length; i++) {
+            if (words[i].emoji) {
+              emoji = words[i].emoji;
+              break;
+            }
           }
+          return {
+            words: words.slice(),
+            colors: colors,
+            emoji: emoji,
+            start: words[0].start,
+            end: words[words.length - 1].end,
+          };
         }
-        return {
-          words: words.slice(),
-          colors: colors,
-          emoji: emoji,
-          start: words[0].start,
-          end: words[words.length - 1].end,
-        };
-      }
-
-      function shadowForColor(color) {
-        var hex = color.replace("#", "");
-        var r = parseInt(hex.slice(0, 2), 16);
-        var g = parseInt(hex.slice(2, 4), 16);
-        var b = parseInt(hex.slice(4, 6), 16);
-        return (
-          "0 4px 8px rgba(0,0,0,0.7), 0 0 2px rgba(" +
-          r +
-          "," +
-          g +
-          "," +
-          b +
-          ",1), 0 0 8px rgba(" +
-          r +
-          "," +
-          g +
-          "," +
-          b +
-          ",0.6)"
-        );
-      }
 
-      function buildCaptions(groups) {
-        var stage = document.getElementById("caption-stage");
-        groups.forEach(function (group, groupIndex) {
-          var groupText = group.words
-            .map(function (w) {
-              return w.text.toUpperCase();
-            })
-            .join(" ");
-          var computedSize = fitFontSize(
-            groupText,
-            CAPTION_FONT_SIZE,
-            "900",
-            "Gabarito",
-            SAFE_ZONE_WIDTH,
+        function shadowForColor(color) {
+          var hex = color.replace("#", "");
+          var r = parseInt(hex.slice(0, 2), 16);
+          var g = parseInt(hex.slice(2, 4), 16);
+          var b = parseInt(hex.slice(4, 6), 16);
+          return (
+            "0 4px 8px rgba(0,0,0,0.7), 0 0 2px rgba(" +
+            r +
+            "," +
+            g +
+            "," +
+            b +
+            ",1), 0 0 8px rgba(" +
+            r +
+            "," +
+            g +
+            "," +
+            b +
+            ",0.6)"
           );
-          var groupEl = document.createElement("div");
-          groupEl.id = "caption-group-" + groupIndex;
-          groupEl.className = "caption-group";
-
-          if (group.emoji) {
-            var emojiEl = document.createElement("div");
-            emojiEl.className = "caption-emoji";
-            emojiEl.textContent = group.emoji;
-            emojiEl.style.fontSize = Math.round(56 * hfFontScale) + "px";
-            groupEl.appendChild(emojiEl);
-          }
+        }
+
+        function buildCaptions(groups) {
+          var stage = document.getElementById("caption-stage");
+          groups.forEach(function (group, groupIndex) {
+            var groupText = group.words
+              .map(function (w) {
+                return w.text.toUpperCase();
+              })
+              .join(" ");
+            var computedSize = fitFontSize(
+              groupText,
+              CAPTION_FONT_SIZE,
+              "900",
+              "Gabarito",
+              SAFE_ZONE_WIDTH,
+            );
+            var groupEl = document.createElement("div");
+            groupEl.id = "caption-group-" + groupIndex;
+            groupEl.className = "caption-group";
+
+            if (group.emoji) {
+              var emojiEl = document.createElement("div");
+              emojiEl.className = "caption-emoji";
+              emojiEl.textContent = group.emoji;
+              emojiEl.style.fontSize = Math.round(56 * hfFontScale) + "px";
+              groupEl.appendChild(emojiEl);
+            }
+
+            var lineEl = document.createElement("div");
+            lineEl.className = "caption-line";
+            group.words.forEach(function (word, wordIndex) {
+              var color = group.colors[wordIndex] || hfPrimaryColor;
+              var wordEl = document.createElement("span");
+              wordEl.className = "caption-word";
+              wordEl.textContent = word.text.toUpperCase();
+              wordEl.style.color = color;
+              wordEl.style.fontSize = computedSize + "px";
+              wordEl.style.textShadow = shadowForColor(color);
+              lineEl.appendChild(wordEl);
+            });
 
-          var lineEl = document.createElement("div");
-          lineEl.className = "caption-line";
-          group.words.forEach(function (word, wordIndex) {
-            var color = group.colors[wordIndex] || hfPrimaryColor;
-            var wordEl = document.createElement("span");
-            wordEl.className = "caption-word";
-            wordEl.textContent = word.text.toUpperCase();
-            wordEl.style.color = color;
-            wordEl.style.fontSize = computedSize + "px";
-            wordEl.style.textShadow = shadowForColor(color);
-            lineEl.appendChild(wordEl);
+            groupEl.appendChild(lineEl);
+            stage.appendChild(groupEl);
           });
+        }
 
-          groupEl.appendChild(lineEl);
-          stage.appendChild(groupEl);
-        });
-      }
+        function hfTeardown() {
+          document.getElementById("caption-stage").innerHTML = "";
+        }
 
-      function hfTeardown() {
-        document.getElementById("caption-stage").innerHTML = "";
-      }
+        function hfBuild(words, layout, durationS) {
+          DURATION = durationS;
+          CAPTION_FONT_SIZE = Math.round(72 * layout.fontScale);
+          SAFE_ZONE_WIDTH = Math.round(1400 * layout.scaleX);
+          WORD_SPACING = Math.round(14 * layout.fontScale);
+          hfFontScale = layout.fontScale;
+
+          var stage = document.getElementById("caption-stage");
+          var stageHeight = Math.round(280 * layout.fontScale);
+          stage.style.width = SAFE_ZONE_WIDTH + "px";
+          stage.style.height = stageHeight + "px";
+          stage.style.bottom = Math.round(80 * layout.scaleY) + "px";
+
+          var rootEl = document.getElementById(HF_ROOT_ID);
+          var primary = getComputedStyle(rootEl).getPropertyValue("--hf-caption-primary").trim();
+          var accent = getComputedStyle(rootEl).getPropertyValue("--hf-caption-accent").trim();
+          hfPrimaryColor = /^#[0-9a-f]{6}$/i.test(primary) ? primary : "#FFFFFF";
+          hfAccentColors = /^#[0-9a-f]{6}$/i.test(accent)
+            ? [accent]
+            : ["#FF76FF", "#FF0002", "#B2F7FF"];
+
+          var WORDS = normalizeWords(words);
+          var GROUPS = makeGroups(WORDS);
+          buildCaptions(GROUPS);
+          GROUPS.forEach(function (_, i) {
+            var el = document.getElementById("caption-group-" + i);
+            el.style.width = SAFE_ZONE_WIDTH + "px";
+            el.style.height = stageHeight + "px";
+          });
 
-      function hfBuild(words, layout, durationS) {
-        DURATION = durationS;
-        CAPTION_FONT_SIZE = Math.round(72 * layout.fontScale);
-        SAFE_ZONE_WIDTH = Math.round(1400 * layout.scaleX);
-        WORD_SPACING = Math.round(14 * layout.fontScale);
-        hfFontScale = layout.fontScale;
-
-        var stage = document.getElementById("caption-stage");
-        var stageHeight = Math.round(280 * layout.fontScale);
-        stage.style.width = SAFE_ZONE_WIDTH + "px";
-        stage.style.height = stageHeight + "px";
-        stage.style.bottom = Math.round(80 * layout.scaleY) + "px";
-
-        var rootEl = document.getElementById(HF_ROOT_ID);
-        var primary = getComputedStyle(rootEl).getPropertyValue("--hf-caption-primary").trim();
-        var accent = getComputedStyle(rootEl).getPropertyValue("--hf-caption-accent").trim();
-        hfPrimaryColor = /^#[0-9a-f]{6}$/i.test(primary) ? primary : "#FFFFFF";
-        hfAccentColors = /^#[0-9a-f]{6}$/i.test(accent)
-          ? [accent]
-          : ["#FF76FF", "#FF0002", "#B2F7FF"];
-
-        var WORDS = normalizeWords(words);
-        var GROUPS = makeGroups(WORDS);
-        buildCaptions(GROUPS);
-        GROUPS.forEach(function (_, i) {
-          var el = document.getElementById("caption-group-" + i);
-          el.style.width = SAFE_ZONE_WIDTH + "px";
-          el.style.height = stageHeight + "px";
-        });
-
-        var tl = gsap.timeline({ paused: true });
-
-        var visibleStarts = GROUPS.map(function (group, groupIndex) {
-          var prev = GROUPS[groupIndex - 1];
-          var availableGap = prev ? Math.max(0, group.start - prev.end) : ENTRY_DURATION;
-          var entryLead = Math.min(ENTRY_DURATION, availableGap);
-          return Math.max(0, group.start - entryLead);
-        });
-
-        var allGroupEls = GROUPS.map(function (_, i) {
-          return document.getElementById("caption-group-" + i);
-        });
-
-        GROUPS.forEach(function (group, groupIndex) {
-          var groupEl = allGroupEls[groupIndex];
-          var visibleStart = visibleStarts[groupIndex];
-          var visibleEnd =
-            groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
-          var exitStart = Math.max(visibleStart, visibleEnd - EXIT_DURATION);
-
-          // Each group already owns its full opacity lifecycle (set 0 at its
-          // own visibleStart, animated to 1, then set back to 0 at its own
-          // visibleEnd below), and groups occupy non-overlapping windows, so
-          // explicitly hiding every OTHER group here was redundant and made
-          // timeline construction O(groups^2) — this collapsed under dense
-          // stress transcripts (many short groups). Removed; behavior is
-          // unchanged (verified against templates.test.ts).
-
-          tl.set(groupEl, { opacity: 0, scaleX: 0.8, scaleY: 1 }, visibleStart);
-          tl.to(
-            groupEl,
-            { opacity: 1, scaleX: 1, duration: ENTRY_DURATION, ease: "power3.out", force3D: true },
-            visibleStart,
-          );
-          tl.to(
-            groupEl,
-            {
-              scaleX: 0.75,
-              opacity: 0.8,
-              duration: EXIT_DURATION,
-              ease: "power2.in",
-              force3D: true,
-            },
-            exitStart,
-          );
-          tl.set(groupEl, { opacity: 0 }, visibleEnd);
-        });
+          var tl = gsap.timeline({ paused: true });
 
-        return tl;
-      }
+          var visibleStarts = GROUPS.map(function (group, groupIndex) {
+            var prev = GROUPS[groupIndex - 1];
+            var availableGap = prev ? Math.max(0, group.start - prev.end) : ENTRY_DURATION;
+            var entryLead = Math.min(ENTRY_DURATION, availableGap);
+            return Math.max(0, group.start - entryLead);
+          });
 
-      var hfCurrentTimeline = null;
+          var allGroupEls = GROUPS.map(function (_, i) {
+            return document.getElementById("caption-group-" + i);
+          });
 
-      function hfAttach(data) {
-        var v = hfValidate(data);
-        if (!v.ok) {
-          hfRunGate([], 0, v.reason);
-          return;
-        }
-        if (hfCurrentTimeline) {
-          hfCurrentTimeline.kill();
-          hfCurrentTimeline = null;
-        }
-        hfTeardown();
-        var layout = hfApplyStageConfig(data, v.durationS);
-        var tl = hfBuild(v.words, layout, v.durationS);
-        tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
-        // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
-        // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
-        // at t=0 — the first frame would show pre-timeline CSS defaults (usually
-        // hidden). render(time, suppressEvents, force) with force=true bypasses that.
-        tl.render(0, true, true);
-        hfCurrentTimeline = tl;
-        window.__timelines = window.__timelines || {};
-        window.__timelines[HF_COMPOSITION_ID] = tl;
-        hfRunGate(v.words, v.durationS, null);
-      }
-      window.__HF_CAPTION_ATTACH__ = hfAttach;
-
-      (function hfBoot() {
-        function start(data) {
-          var ready =
-            document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
-          ready.then(function () {
-            hfAttach(data);
+          GROUPS.forEach(function (group, groupIndex) {
+            var groupEl = allGroupEls[groupIndex];
+            var visibleStart = visibleStarts[groupIndex];
+            var visibleEnd =
+              groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
+            var exitStart = Math.max(visibleStart, visibleEnd - EXIT_DURATION);
+
+            // Each group already owns its full opacity lifecycle (set 0 at its
+            // own visibleStart, animated to 1, then set back to 0 at its own
+            // visibleEnd below), and groups occupy non-overlapping windows, so
+            // explicitly hiding every OTHER group here was redundant and made
+            // timeline construction O(groups^2) — this collapsed under dense
+            // stress transcripts (many short groups). Removed; behavior is
+            // unchanged (verified against templates.test.ts).
+
+            tl.set(groupEl, { opacity: 0, scaleX: 0.8, scaleY: 1 }, visibleStart);
+            tl.to(
+              groupEl,
+              {
+                opacity: 1,
+                scaleX: 1,
+                duration: ENTRY_DURATION,
+                ease: "power3.out",
+                force3D: true,
+              },
+              visibleStart,
+            );
+            tl.to(
+              groupEl,
+              {
+                scaleX: 0.75,
+                opacity: 0.8,
+                duration: EXIT_DURATION,
+                ease: "power2.in",
+                force3D: true,
+              },
+              exitStart,
+            );
+            tl.set(groupEl, { opacity: 0 }, visibleEnd);
           });
+
+          return tl;
         }
-        if (window.__HF_CAPTION__) {
-          start(window.__HF_CAPTION__);
-          return;
+
+        var hfCurrentTimeline = null;
+
+        function hfAttach(data) {
+          var v = hfValidate(data);
+          if (!v.ok) {
+            hfRunGate([], 0, v.reason);
+            return;
+          }
+          if (hfCurrentTimeline) {
+            hfCurrentTimeline.kill();
+            hfCurrentTimeline = null;
+          }
+          hfTeardown();
+          var layout = hfApplyStageConfig(data, v.durationS);
+          var tl = hfBuild(v.words, layout, v.durationS);
+          tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+          // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+          // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+          // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+          // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+          tl.render(0, true, true);
+          hfCurrentTimeline = tl;
+          window.__timelines = window.__timelines || {};
+          window.__timelines[HF_COMPOSITION_ID] = tl;
+          hfRunGate(v.words, v.durationS, null);
         }
-        fetch("./caption-data.json")
-          .then(function (r) {
-            return r.ok ? r.json() : null;
-          })
-          .catch(function () {
-            return null;
-          })
-          .then(function (json) {
-            start(json || HF_DEMO_DATA);
-          });
+        window.__HF_CAPTION_ATTACH__ = hfAttach;
+
+        (function hfBoot() {
+          function start(data) {
+            var ready =
+              document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+            ready.then(function () {
+              hfAttach(data);
+            });
+          }
+          if (window.__HF_CAPTION__) {
+            start(window.__HF_CAPTION__);
+            return;
+          }
+          fetch("./caption-data.json")
+            .then(function (r) {
+              return r.ok ? r.json() : null;
+            })
+            .catch(function () {
+              return null;
+            })
+            .then(function (json) {
+              start(json || HF_DEMO_DATA);
+            });
+        })();
       })();
     </script>
   </body>
diff --git a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
index f57bbd1635..341400fb80 100644
--- a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
+++ b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
@@ -131,478 +131,492 @@
     </div>
 
     <script>
-      var HF_COMPOSITION_ID = "caption-pill-karaoke";
-      var HF_ROOT_ID = "pill-karaoke";
-      var HF_GROUP_SELECTOR = ".caption-group";
-
-      var HF_DEMO_DATA = {
-        version: 1,
-        segments: [
-          {
-            start: 0,
-            text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
-            words: [
-              { text: "Every", start: 0.0, end: 0.3 },
-              { text: "great", start: 0.3, end: 0.55 },
-              { text: "video", start: 0.55, end: 0.85 },
-              { text: "starts", start: 0.85, end: 1.1 },
-              { text: "with", start: 1.1, end: 1.25 },
-              { text: "a", start: 1.25, end: 1.35 },
-              { text: "single", start: 1.35, end: 1.65 },
-              { text: "frame.", start: 1.65, end: 2.0 },
-              { text: "HyperFrames", start: 2.1, end: 2.65 },
-              { text: "lets", start: 2.65, end: 2.85 },
-              { text: "you", start: 2.85, end: 2.95 },
-              { text: "write", start: 2.95, end: 3.15 },
-              { text: "HTML", start: 3.15, end: 3.55 },
-              { text: "and", start: 3.55, end: 3.65 },
-              { text: "render", start: 3.65, end: 3.95 },
-              { text: "professional", start: 3.95, end: 4.45 },
-              { text: "video.", start: 4.45, end: 4.8 },
-              { text: "No", start: 4.9, end: 5.05 },
-              { text: "timeline.", start: 5.05, end: 5.45 },
-              { text: "No", start: 5.5, end: 5.65 },
-              { text: "drag", start: 5.65, end: 5.85 },
-              { text: "and", start: 5.85, end: 5.95 },
-              { text: "drop.", start: 5.95, end: 6.25 },
-              { text: "Just", start: 6.35, end: 6.55 },
-              { text: "code", start: 6.55, end: 6.8 },
-              { text: "that", start: 6.8, end: 6.95 },
-              { text: "becomes", start: 6.95, end: 7.3 },
-              { text: "cinema.", start: 7.3, end: 7.7 },
-            ],
-          },
-        ],
-      };
-
-      /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
-      var HF_CONTRACT_VERSION = 1;
-      var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
-
-      function hfFlattenSegments(segments) {
-        var out = [];
-        (segments || []).forEach(function (seg) {
-          ((seg && seg.words) || []).forEach(function (w) {
-            var start = Math.max(0, Number(w.start) || 0);
-            out.push({
-              text: String(w.word || w.text || "").trim(),
-              start: start,
-              end: Math.max(start, Number(w.end) || 0),
+      // IIFE: keep every template's runtime private to itself so two caption
+      // components pasted into one composition document can't clobber each
+      // other's hfAttach/hfBuild via shared script-scope names (boot is async,
+      // so collisions surface AFTER all scripts have executed).
+      (function () {
+        var HF_COMPOSITION_ID = "caption-pill-karaoke";
+        var HF_ROOT_ID = "pill-karaoke";
+        var HF_GROUP_SELECTOR = ".caption-group";
+
+        var HF_DEMO_DATA = {
+          version: 1,
+          segments: [
+            {
+              start: 0,
+              text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+              words: [
+                { text: "Every", start: 0.0, end: 0.3 },
+                { text: "great", start: 0.3, end: 0.55 },
+                { text: "video", start: 0.55, end: 0.85 },
+                { text: "starts", start: 0.85, end: 1.1 },
+                { text: "with", start: 1.1, end: 1.25 },
+                { text: "a", start: 1.25, end: 1.35 },
+                { text: "single", start: 1.35, end: 1.65 },
+                { text: "frame.", start: 1.65, end: 2.0 },
+                { text: "HyperFrames", start: 2.1, end: 2.65 },
+                { text: "lets", start: 2.65, end: 2.85 },
+                { text: "you", start: 2.85, end: 2.95 },
+                { text: "write", start: 2.95, end: 3.15 },
+                { text: "HTML", start: 3.15, end: 3.55 },
+                { text: "and", start: 3.55, end: 3.65 },
+                { text: "render", start: 3.65, end: 3.95 },
+                { text: "professional", start: 3.95, end: 4.45 },
+                { text: "video.", start: 4.45, end: 4.8 },
+                { text: "No", start: 4.9, end: 5.05 },
+                { text: "timeline.", start: 5.05, end: 5.45 },
+                { text: "No", start: 5.5, end: 5.65 },
+                { text: "drag", start: 5.65, end: 5.85 },
+                { text: "and", start: 5.85, end: 5.95 },
+                { text: "drop.", start: 5.95, end: 6.25 },
+                { text: "Just", start: 6.35, end: 6.55 },
+                { text: "code", start: 6.55, end: 6.8 },
+                { text: "that", start: 6.8, end: 6.95 },
+                { text: "becomes", start: 6.95, end: 7.3 },
+                { text: "cinema.", start: 7.3, end: 7.7 },
+              ],
+            },
+          ],
+        };
+
+        /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+        var HF_CONTRACT_VERSION = 1;
+        var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
+
+        function hfFlattenSegments(segments) {
+          var out = [];
+          (segments || []).forEach(function (seg) {
+            ((seg && seg.words) || []).forEach(function (w) {
+              var start = Math.max(0, Number(w.start) || 0);
+              out.push({
+                text: String(w.word || w.text || "").trim(),
+                start: start,
+                end: Math.max(start, Number(w.end) || 0),
+              });
             });
           });
-        });
-        out.sort(function (a, b) {
-          return a.start - b.start;
-        });
-        return out.filter(function (w) {
-          return w.text.length > 0;
-        });
-      }
-
-      function hfDeriveDuration(words) {
-        var end = 0;
-        words.forEach(function (w) {
-          if (w.end > end) end = w.end;
-        });
-        return end;
-      }
-
-      function hfValidate(data) {
-        if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-        if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-          return { ok: false, reason: "unsupported-version" };
-        }
-        if (!Array.isArray(data.segments) || data.segments.length === 0) {
-          return { ok: false, reason: "no-segments" };
+          out.sort(function (a, b) {
+            return a.start - b.start;
+          });
+          return out.filter(function (w) {
+            return w.text.length > 0;
+          });
         }
-        if (data.displayMode != null && data.displayMode !== "full") {
-          return { ok: false, reason: "unsupported-displayMode" };
+
+        function hfDeriveDuration(words) {
+          var end = 0;
+          words.forEach(function (w) {
+            if (w.end > end) end = w.end;
+          });
+          return end;
         }
-        var words = hfFlattenSegments(data.segments);
-        if (words.length === 0) return { ok: false, reason: "no-words" };
-        return { ok: true, words: words, durationS: hfDeriveDuration(words) };
-      }
 
-      function hfApplyStageConfig(data, durationS) {
-        var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-        var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-        var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
-        var root = document.getElementById(HF_ROOT_ID);
-        [document.documentElement, document.body, root].forEach(function (el) {
-          el.style.width = W + "px";
-          el.style.height = H + "px";
-        });
-        root.setAttribute("data-width", String(W));
-        root.setAttribute("data-height", String(H));
-        root.setAttribute("data-duration", String(durationS));
-        var brand = (data && data.brand) || {};
-        if (typeof brand.primaryColor === "string" && brand.primaryColor) {
-          root.style.setProperty("--hf-caption-primary", brand.primaryColor);
-        } else {
-          root.style.removeProperty("--hf-caption-primary");
+        function hfValidate(data) {
+          if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+            return { ok: false, reason: "unsupported-version" };
+          }
+          if (!Array.isArray(data.segments) || data.segments.length === 0) {
+            return { ok: false, reason: "no-segments" };
+          }
+          if (data.displayMode != null && data.displayMode !== "full") {
+            return { ok: false, reason: "unsupported-displayMode" };
+          }
+          var words = hfFlattenSegments(data.segments);
+          if (words.length === 0) return { ok: false, reason: "no-words" };
+          return { ok: true, words: words, durationS: hfDeriveDuration(words) };
         }
-        if (typeof brand.accentColor === "string" && brand.accentColor) {
-          root.style.setProperty("--hf-caption-accent", brand.accentColor);
-        } else {
-          root.style.removeProperty("--hf-caption-accent");
+
+        function hfApplyStageConfig(data, durationS) {
+          var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          var root = document.getElementById(HF_ROOT_ID);
+          [document.documentElement, document.body, root].forEach(function (el) {
+            el.style.width = W + "px";
+            el.style.height = H + "px";
+          });
+          root.setAttribute("data-width", String(W));
+          root.setAttribute("data-height", String(H));
+          root.setAttribute("data-duration", String(durationS));
+          var brand = (data && data.brand) || {};
+          if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+            root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+          } else {
+            root.style.removeProperty("--hf-caption-primary");
+          }
+          if (typeof brand.accentColor === "string" && brand.accentColor) {
+            root.style.setProperty("--hf-caption-accent", brand.accentColor);
+          } else {
+            root.style.removeProperty("--hf-caption-accent");
+          }
+          return {
+            W: W,
+            H: H,
+            scaleX: W / 1920,
+            scaleY: H / 1080,
+            fontScale: Math.min(W, H) / 1080,
+          };
         }
-        return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
-      }
 
-      function hfPublishStatus(status) {
-        window.__HF_CAPTION_STATUS = status;
-        document
-          .getElementById(HF_ROOT_ID)
-          .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
-      }
+        function hfPublishStatus(status) {
+          window.__HF_CAPTION_STATUS = status;
+          document
+            .getElementById(HF_ROOT_ID)
+            .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+        }
 
-      function hfRunGate(words, durationS, failReason) {
-        if (failReason) {
-          hfPublishStatus({
-            ok: false,
-            present: false,
-            contained: false,
-            reason: failReason,
-            version: HF_CONTRACT_VERSION,
-            durationS: durationS || 0,
+        function hfRunGate(words, durationS, failReason) {
+          if (failReason) {
+            hfPublishStatus({
+              ok: false,
+              present: false,
+              contained: false,
+              reason: failReason,
+              version: HF_CONTRACT_VERSION,
+              durationS: durationS || 0,
+            });
+            return;
+          }
+          var root = document.getElementById(HF_ROOT_ID);
+          var rootRect = root.getBoundingClientRect();
+          var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+          var present = false;
+          var contained = true;
+          var tokens = [];
+          words.forEach(function (w) {
+            var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+            if (t) tokens.push(t);
           });
-          return;
-        }
-        var root = document.getElementById(HF_ROOT_ID);
-        var rootRect = root.getBoundingClientRect();
-        var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
-        var present = false;
-        var contained = true;
-        var tokens = [];
-        words.forEach(function (w) {
-          var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
-          if (t) tokens.push(t);
-        });
-        groups.forEach(function (el) {
-          var prevOpacity = el.style.opacity;
-          var prevVisibility = el.style.visibility;
-          el.style.opacity = "1";
-          el.style.visibility = "visible";
-          var r = el.getBoundingClientRect();
-          if (r.width > 0 && r.height > 0) {
-            var text = (el.textContent || "").toLowerCase();
-            for (var i = 0; i < tokens.length; i++) {
-              if (text.indexOf(tokens[i]) !== -1) {
-                present = true;
-                break;
+          groups.forEach(function (el) {
+            var prevOpacity = el.style.opacity;
+            var prevVisibility = el.style.visibility;
+            el.style.opacity = "1";
+            el.style.visibility = "visible";
+            var r = el.getBoundingClientRect();
+            if (r.width > 0 && r.height > 0) {
+              var text = (el.textContent || "").toLowerCase();
+              for (var i = 0; i < tokens.length; i++) {
+                if (text.indexOf(tokens[i]) !== -1) {
+                  present = true;
+                  break;
+                }
+              }
+              if (
+                r.left < rootRect.left - 1 ||
+                r.right > rootRect.right + 1 ||
+                r.top < rootRect.top - 1 ||
+                r.bottom > rootRect.bottom + 1
+              ) {
+                contained = false;
               }
             }
-            if (
-              r.left < rootRect.left - 1 ||
-              r.right > rootRect.right + 1 ||
-              r.top < rootRect.top - 1 ||
-              r.bottom > rootRect.bottom + 1
-            ) {
-              contained = false;
-            }
-          }
-          el.style.opacity = prevOpacity;
-          el.style.visibility = prevVisibility;
-        });
-        hfPublishStatus({
-          ok: present && contained,
-          present: present,
-          contained: contained,
-          version: HF_CONTRACT_VERSION,
-          durationS: durationS,
-        });
-      }
-
-      var DURATION, SAFE_ZONE_WIDTH, PILL_MAX_WIDTH, BASE_FONT_SIZE, MIN_FONT_SIZE, WORD_SPACING;
-      var PILL_MIN_PADDING_X = 30;
-      var PILL_MAX_PADDING_X = 60;
-      var FONT_WIDTH_SAFETY = 1.18;
-      var FONT_FAMILY = "Poppins";
-      var FONT_WEIGHT = "700";
-      var MAX_WORDS_PER_GROUP = 4;
-      var PAUSE_THRESHOLD = 0.1;
-      var GROUP_END_BUFFER = 0.3;
-      var COLOR_INACTIVE = "#A6A6A6";
-      var COLOR_ACTIVE = "#1C1E1D";
-      var hfColorActive = COLOR_ACTIVE;
-      var COLOR_FADE_DURATION = 0.1;
-      var WORD_FADE_LEAD = 0.05;
-
-      function normalizeWords(rawWords) {
-        return rawWords
-          .map(function (item) {
-            var text = String(item.word || item.text || "").trim();
-            return {
-              text: text,
-              start: Math.max(0, Number(item.start) || 0),
-              end: Math.min(DURATION, Math.max(Number(item.start) || 0, Number(item.end) || 0)),
-            };
-          })
-          .filter(function (w) {
-            return w.text.length > 0;
+            el.style.opacity = prevOpacity;
+            el.style.visibility = prevVisibility;
           });
-      }
+          hfPublishStatus({
+            ok: present && contained,
+            present: present,
+            contained: contained,
+            version: HF_CONTRACT_VERSION,
+            durationS: durationS,
+          });
+        }
 
-      var measureCanvas = document.createElement("canvas");
-      var measureContext = measureCanvas.getContext("2d");
+        var DURATION, SAFE_ZONE_WIDTH, PILL_MAX_WIDTH, BASE_FONT_SIZE, MIN_FONT_SIZE, WORD_SPACING;
+        var PILL_MIN_PADDING_X = 30;
+        var PILL_MAX_PADDING_X = 60;
+        var FONT_WIDTH_SAFETY = 1.18;
+        var FONT_FAMILY = "Poppins";
+        var FONT_WEIGHT = "700";
+        var MAX_WORDS_PER_GROUP = 4;
+        var PAUSE_THRESHOLD = 0.1;
+        var GROUP_END_BUFFER = 0.3;
+        var COLOR_INACTIVE = "#A6A6A6";
+        var COLOR_ACTIVE = "#1C1E1D";
+        var hfColorActive = COLOR_ACTIVE;
+        var COLOR_FADE_DURATION = 0.1;
+        var WORD_FADE_LEAD = 0.05;
+
+        function normalizeWords(rawWords) {
+          return rawWords
+            .map(function (item) {
+              var text = String(item.word || item.text || "").trim();
+              return {
+                text: text,
+                start: Math.max(0, Number(item.start) || 0),
+                end: Math.min(DURATION, Math.max(Number(item.start) || 0, Number(item.end) || 0)),
+              };
+            })
+            .filter(function (w) {
+              return w.text.length > 0;
+            });
+        }
 
-      function measureWordWidth(text, fontSize) {
-        measureContext.font = FONT_WEIGHT + " " + fontSize + "px " + FONT_FAMILY;
-        return measureContext.measureText(text).width * FONT_WIDTH_SAFETY;
-      }
+        var measureCanvas = document.createElement("canvas");
+        var measureContext = measureCanvas.getContext("2d");
 
-      function measureLineWidth(words, fontSize) {
-        return words.reduce(function (total, word, index) {
-          return (
-            total + measureWordWidth(word.text.toLowerCase(), fontSize) + (index ? WORD_SPACING : 0)
-          );
-        }, 0);
-      }
+        function measureWordWidth(text, fontSize) {
+          measureContext.font = FONT_WEIGHT + " " + fontSize + "px " + FONT_FAMILY;
+          return measureContext.measureText(text).width * FONT_WIDTH_SAFETY;
+        }
 
-      function splitLinesForGroup(words, fontSize) {
-        var maxLineWidth = PILL_MAX_WIDTH - PILL_MIN_PADDING_X * 2;
-        if (
-          words.some(function (w) {
-            return measureWordWidth(w.text.toLowerCase(), fontSize) > maxLineWidth;
-          })
-        ) {
-          return null;
+        function measureLineWidth(words, fontSize) {
+          return words.reduce(function (total, word, index) {
+            return (
+              total +
+              measureWordWidth(word.text.toLowerCase(), fontSize) +
+              (index ? WORD_SPACING : 0)
+            );
+          }, 0);
         }
-        if (measureLineWidth(words, fontSize) <= maxLineWidth) return [words];
-        var bestSplit = null;
-        var bestImbalance = Infinity;
-        for (var split = 1; split < words.length; split++) {
-          var firstLine = words.slice(0, split);
-          var secondLine = words.slice(split);
-          var firstWidth = measureLineWidth(firstLine, fontSize);
-          var secondWidth = measureLineWidth(secondLine, fontSize);
-          if (firstWidth <= maxLineWidth && secondWidth <= maxLineWidth) {
-            var imbalance = Math.abs(firstWidth - secondWidth);
-            if (imbalance < bestImbalance) {
-              bestSplit = [firstLine, secondLine];
-              bestImbalance = imbalance;
+
+        function splitLinesForGroup(words, fontSize) {
+          var maxLineWidth = PILL_MAX_WIDTH - PILL_MIN_PADDING_X * 2;
+          if (
+            words.some(function (w) {
+              return measureWordWidth(w.text.toLowerCase(), fontSize) > maxLineWidth;
+            })
+          ) {
+            return null;
+          }
+          if (measureLineWidth(words, fontSize) <= maxLineWidth) return [words];
+          var bestSplit = null;
+          var bestImbalance = Infinity;
+          for (var split = 1; split < words.length; split++) {
+            var firstLine = words.slice(0, split);
+            var secondLine = words.slice(split);
+            var firstWidth = measureLineWidth(firstLine, fontSize);
+            var secondWidth = measureLineWidth(secondLine, fontSize);
+            if (firstWidth <= maxLineWidth && secondWidth <= maxLineWidth) {
+              var imbalance = Math.abs(firstWidth - secondWidth);
+              if (imbalance < bestImbalance) {
+                bestSplit = [firstLine, secondLine];
+                bestImbalance = imbalance;
+              }
             }
           }
+          return bestSplit;
         }
-        return bestSplit;
-      }
 
-      function fitsInTwoLinesAtSize(words, fontSize) {
-        return splitLinesForGroup(words, fontSize) !== null;
-      }
+        function fitsInTwoLinesAtSize(words, fontSize) {
+          return splitLinesForGroup(words, fontSize) !== null;
+        }
 
-      function planPillLayout(words, fontSize) {
-        var lines = splitLinesForGroup(words, fontSize) || [words];
-        var widestLine = lines.reduce(function (max, lineWords) {
-          return Math.max(max, measureLineWidth(lineWords, fontSize));
-        }, 0);
-        var availablePadding = Math.floor((PILL_MAX_WIDTH - widestLine) / 2);
-        var padX = Math.max(PILL_MIN_PADDING_X, Math.min(PILL_MAX_PADDING_X, availablePadding));
-        var pillWidth = Math.min(PILL_MAX_WIDTH, Math.ceil(widestLine + padX * 2));
-        return { lines: lines, padX: padX, pillWidth: pillWidth };
-      }
+        function planPillLayout(words, fontSize) {
+          var lines = splitLinesForGroup(words, fontSize) || [words];
+          var widestLine = lines.reduce(function (max, lineWords) {
+            return Math.max(max, measureLineWidth(lineWords, fontSize));
+          }, 0);
+          var availablePadding = Math.floor((PILL_MAX_WIDTH - widestLine) / 2);
+          var padX = Math.max(PILL_MIN_PADDING_X, Math.min(PILL_MAX_PADDING_X, availablePadding));
+          var pillWidth = Math.min(PILL_MAX_WIDTH, Math.ceil(widestLine + padX * 2));
+          return { lines: lines, padX: padX, pillWidth: pillWidth };
+        }
 
-      function makeGroups(words) {
-        var groups = [];
-        var current = [];
-        words.forEach(function (word, index) {
-          var testGroup = current.concat([word]);
-          var nextWord = words[index + 1];
-          var wouldExceedMaxWords = testGroup.length > MAX_WORDS_PER_GROUP;
-          var wouldExceedTwoLines = !fitsInTwoLinesAtSize(testGroup, BASE_FONT_SIZE);
-          if (wouldExceedMaxWords || wouldExceedTwoLines) {
-            if (current.length) {
+        function makeGroups(words) {
+          var groups = [];
+          var current = [];
+          words.forEach(function (word, index) {
+            var testGroup = current.concat([word]);
+            var nextWord = words[index + 1];
+            var wouldExceedMaxWords = testGroup.length > MAX_WORDS_PER_GROUP;
+            var wouldExceedTwoLines = !fitsInTwoLinesAtSize(testGroup, BASE_FONT_SIZE);
+            if (wouldExceedMaxWords || wouldExceedTwoLines) {
+              if (current.length) {
+                groups.push({
+                  words: current.slice(),
+                  start: current[0].start,
+                  end: current[current.length - 1].end,
+                });
+              }
+              current = [word];
+              return;
+            }
+            current.push(word);
+            var hasPunctuation = /[,.:!?]$/.test(word.text);
+            var pauseDuration = nextWord ? nextWord.start - word.end : 0;
+            var hasNaturalPause = pauseDuration >= PAUSE_THRESHOLD;
+            var maxWordsReached = current.length >= MAX_WORDS_PER_GROUP;
+            if (maxWordsReached || !nextWord || hasPunctuation || hasNaturalPause) {
               groups.push({
                 words: current.slice(),
                 start: current[0].start,
                 end: current[current.length - 1].end,
               });
+              current = [];
             }
-            current = [word];
-            return;
-          }
-          current.push(word);
-          var hasPunctuation = /[,.:!?]$/.test(word.text);
-          var pauseDuration = nextWord ? nextWord.start - word.end : 0;
-          var hasNaturalPause = pauseDuration >= PAUSE_THRESHOLD;
-          var maxWordsReached = current.length >= MAX_WORDS_PER_GROUP;
-          if (maxWordsReached || !nextWord || hasPunctuation || hasNaturalPause) {
+          });
+          if (current.length)
             groups.push({
               words: current.slice(),
               start: current[0].start,
               end: current[current.length - 1].end,
             });
-            current = [];
-          }
-        });
-        if (current.length)
-          groups.push({
-            words: current.slice(),
-            start: current[0].start,
-            end: current[current.length - 1].end,
-          });
-        return groups;
-      }
+          return groups;
+        }
 
-      function fontSizeForGroup(words) {
-        var size = BASE_FONT_SIZE;
-        while (size > MIN_FONT_SIZE && !fitsInTwoLinesAtSize(words, size)) {
-          size -= 2;
+        function fontSizeForGroup(words) {
+          var size = BASE_FONT_SIZE;
+          while (size > MIN_FONT_SIZE && !fitsInTwoLinesAtSize(words, size)) {
+            size -= 2;
+          }
+          return size;
         }
-        return size;
-      }
 
-      function buildCaptions(groups) {
-        var stage = document.getElementById("caption-stage");
-        groups.forEach(function (group, groupIndex) {
-          var groupEl = document.createElement("div");
-          var pillEl = document.createElement("div");
-          var copyEl = document.createElement("div");
-          var fontSize = fontSizeForGroup(group.words);
-          groupEl.id = "caption-group-" + groupIndex;
-          groupEl.className = "caption-group";
-          pillEl.className = "caption-pill";
-          copyEl.className = "caption-copy";
-          copyEl.style.fontSize = fontSize + "px";
-          var indexedWords = group.words.map(function (word, wordIndex) {
-            return { text: word.text, start: word.start, end: word.end, wordIndex: wordIndex };
-          });
-          var layout = planPillLayout(indexedWords, fontSize);
-          pillEl.style.width = layout.pillWidth + "px";
-          pillEl.style.maxWidth = PILL_MAX_WIDTH + "px";
-          pillEl.style.paddingLeft = layout.padX + "px";
-          pillEl.style.paddingRight = layout.padX + "px";
-          layout.lines.slice(0, 2).forEach(function (lineWords) {
-            var lineEl = document.createElement("div");
-            lineEl.className = "caption-line";
-            lineWords.forEach(function (word) {
-              var wordEl = document.createElement("span");
-              wordEl.id = "caption-word-" + groupIndex + "-" + word.wordIndex;
-              wordEl.className = "caption-word";
-              wordEl.textContent = word.text.toLowerCase();
-              lineEl.appendChild(wordEl);
+        function buildCaptions(groups) {
+          var stage = document.getElementById("caption-stage");
+          groups.forEach(function (group, groupIndex) {
+            var groupEl = document.createElement("div");
+            var pillEl = document.createElement("div");
+            var copyEl = document.createElement("div");
+            var fontSize = fontSizeForGroup(group.words);
+            groupEl.id = "caption-group-" + groupIndex;
+            groupEl.className = "caption-group";
+            pillEl.className = "caption-pill";
+            copyEl.className = "caption-copy";
+            copyEl.style.fontSize = fontSize + "px";
+            var indexedWords = group.words.map(function (word, wordIndex) {
+              return { text: word.text, start: word.start, end: word.end, wordIndex: wordIndex };
+            });
+            var layout = planPillLayout(indexedWords, fontSize);
+            pillEl.style.width = layout.pillWidth + "px";
+            pillEl.style.maxWidth = PILL_MAX_WIDTH + "px";
+            pillEl.style.paddingLeft = layout.padX + "px";
+            pillEl.style.paddingRight = layout.padX + "px";
+            layout.lines.slice(0, 2).forEach(function (lineWords) {
+              var lineEl = document.createElement("div");
+              lineEl.className = "caption-line";
+              lineWords.forEach(function (word) {
+                var wordEl = document.createElement("span");
+                wordEl.id = "caption-word-" + groupIndex + "-" + word.wordIndex;
+                wordEl.className = "caption-word";
+                wordEl.textContent = word.text.toLowerCase();
+                lineEl.appendChild(wordEl);
+              });
+              copyEl.appendChild(lineEl);
             });
-            copyEl.appendChild(lineEl);
+            pillEl.appendChild(copyEl);
+            groupEl.appendChild(pillEl);
+            stage.appendChild(groupEl);
           });
-          pillEl.appendChild(copyEl);
-          groupEl.appendChild(pillEl);
-          stage.appendChild(groupEl);
-        });
-      }
+        }
 
-      function hfTeardown() {
-        document.getElementById("caption-stage").innerHTML = "";
-      }
+        function hfTeardown() {
+          document.getElementById("caption-stage").innerHTML = "";
+        }
 
-      function hfBuild(words, layout, durationS) {
-        DURATION = durationS;
-        BASE_FONT_SIZE = Math.round(72 * layout.fontScale);
-        MIN_FONT_SIZE = Math.round(52 * layout.fontScale);
-        SAFE_ZONE_WIDTH = Math.round(1600 * layout.scaleX);
-        PILL_MAX_WIDTH = SAFE_ZONE_WIDTH;
-        WORD_SPACING = Math.round(16 * layout.fontScale);
-
-        var stage = document.getElementById("caption-stage");
-        var stageHeight = Math.round(220 * layout.fontScale);
-        stage.style.width = SAFE_ZONE_WIDTH + "px";
-        stage.style.height = stageHeight + "px";
-        stage.style.bottom = Math.round(90 * layout.scaleY) + "px";
-
-        var rootEl = document.getElementById(HF_ROOT_ID);
-        var accent = getComputedStyle(rootEl).getPropertyValue("--hf-caption-accent").trim();
-        hfColorActive = accent || COLOR_ACTIVE;
-
-        var WORDS = normalizeWords(words);
-        var GROUPS = makeGroups(WORDS);
-        buildCaptions(GROUPS);
-        GROUPS.forEach(function (_, i) {
-          var el = document.getElementById("caption-group-" + i);
-          el.style.width = SAFE_ZONE_WIDTH + "px";
-          el.style.height = stageHeight + "px";
-        });
-
-        var tl = gsap.timeline({ paused: true });
-
-        GROUPS.forEach(function (group, groupIndex) {
-          var groupEl = document.getElementById("caption-group-" + groupIndex);
-          var nextGroup = GROUPS[groupIndex + 1];
-          var isLastGroup = groupIndex === GROUPS.length - 1;
-          var effectiveEnd = isLastGroup
-            ? DURATION
-            : Math.min(nextGroup.start, group.end + GROUP_END_BUFFER);
-          var visibleStart = Math.max(0, group.start);
-          var visibleEnd = Math.max(visibleStart + 0.01, effectiveEnd);
-
-          tl.set(groupEl, { opacity: 1 }, visibleStart);
-          tl.set(groupEl, { opacity: 0 }, visibleEnd);
-
-          group.words.forEach(function (word, wordIndex) {
-            var wordEl = document.getElementById("caption-word-" + groupIndex + "-" + wordIndex);
-            var isFirstWord = wordIndex === 0;
-            var wordStart = Math.max(visibleStart, word.start - WORD_FADE_LEAD);
-            tl.set(wordEl, { color: isFirstWord ? hfColorActive : COLOR_INACTIVE }, visibleStart);
-            if (isFirstWord) return;
-            tl.to(
-              wordEl,
-              { color: hfColorActive, duration: COLOR_FADE_DURATION, ease: "none" },
-              wordStart,
-            );
+        function hfBuild(words, layout, durationS) {
+          DURATION = durationS;
+          BASE_FONT_SIZE = Math.round(72 * layout.fontScale);
+          MIN_FONT_SIZE = Math.round(52 * layout.fontScale);
+          SAFE_ZONE_WIDTH = Math.round(1600 * layout.scaleX);
+          PILL_MAX_WIDTH = SAFE_ZONE_WIDTH;
+          WORD_SPACING = Math.round(16 * layout.fontScale);
+
+          var stage = document.getElementById("caption-stage");
+          var stageHeight = Math.round(220 * layout.fontScale);
+          stage.style.width = SAFE_ZONE_WIDTH + "px";
+          stage.style.height = stageHeight + "px";
+          stage.style.bottom = Math.round(90 * layout.scaleY) + "px";
+
+          var rootEl = document.getElementById(HF_ROOT_ID);
+          var accent = getComputedStyle(rootEl).getPropertyValue("--hf-caption-accent").trim();
+          hfColorActive = accent || COLOR_ACTIVE;
+
+          var WORDS = normalizeWords(words);
+          var GROUPS = makeGroups(WORDS);
+          buildCaptions(GROUPS);
+          GROUPS.forEach(function (_, i) {
+            var el = document.getElementById("caption-group-" + i);
+            el.style.width = SAFE_ZONE_WIDTH + "px";
+            el.style.height = stageHeight + "px";
           });
-        });
-
-        return tl;
-      }
-
-      var hfCurrentTimeline = null;
 
-      function hfAttach(data) {
-        var v = hfValidate(data);
-        if (!v.ok) {
-          hfRunGate([], 0, v.reason);
-          return;
-        }
-        if (hfCurrentTimeline) {
-          hfCurrentTimeline.kill();
-          hfCurrentTimeline = null;
-        }
-        hfTeardown();
-        var layout = hfApplyStageConfig(data, v.durationS);
-        var tl = hfBuild(v.words, layout, v.durationS);
-        tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
-        // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
-        // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
-        // at t=0 — the first frame would show pre-timeline CSS defaults (usually
-        // hidden). render(time, suppressEvents, force) with force=true bypasses that.
-        tl.render(0, true, true);
-        hfCurrentTimeline = tl;
-        window.__timelines = window.__timelines || {};
-        window.__timelines[HF_COMPOSITION_ID] = tl;
-        hfRunGate(v.words, v.durationS, null);
-      }
-      window.__HF_CAPTION_ATTACH__ = hfAttach;
-
-      (function hfBoot() {
-        function start(data) {
-          var ready =
-            document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
-          ready.then(function () {
-            hfAttach(data);
+          var tl = gsap.timeline({ paused: true });
+
+          GROUPS.forEach(function (group, groupIndex) {
+            var groupEl = document.getElementById("caption-group-" + groupIndex);
+            var nextGroup = GROUPS[groupIndex + 1];
+            var isLastGroup = groupIndex === GROUPS.length - 1;
+            var effectiveEnd = isLastGroup
+              ? DURATION
+              : Math.min(nextGroup.start, group.end + GROUP_END_BUFFER);
+            var visibleStart = Math.max(0, group.start);
+            var visibleEnd = Math.max(visibleStart + 0.01, effectiveEnd);
+
+            tl.set(groupEl, { opacity: 1 }, visibleStart);
+            tl.set(groupEl, { opacity: 0 }, visibleEnd);
+
+            group.words.forEach(function (word, wordIndex) {
+              var wordEl = document.getElementById("caption-word-" + groupIndex + "-" + wordIndex);
+              var isFirstWord = wordIndex === 0;
+              var wordStart = Math.max(visibleStart, word.start - WORD_FADE_LEAD);
+              tl.set(wordEl, { color: isFirstWord ? hfColorActive : COLOR_INACTIVE }, visibleStart);
+              if (isFirstWord) return;
+              tl.to(
+                wordEl,
+                { color: hfColorActive, duration: COLOR_FADE_DURATION, ease: "none" },
+                wordStart,
+              );
+            });
           });
+
+          return tl;
         }
-        if (window.__HF_CAPTION__) {
-          start(window.__HF_CAPTION__);
-          return;
+
+        var hfCurrentTimeline = null;
+
+        function hfAttach(data) {
+          var v = hfValidate(data);
+          if (!v.ok) {
+            hfRunGate([], 0, v.reason);
+            return;
+          }
+          if (hfCurrentTimeline) {
+            hfCurrentTimeline.kill();
+            hfCurrentTimeline = null;
+          }
+          hfTeardown();
+          var layout = hfApplyStageConfig(data, v.durationS);
+          var tl = hfBuild(v.words, layout, v.durationS);
+          tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+          // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+          // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+          // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+          // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+          tl.render(0, true, true);
+          hfCurrentTimeline = tl;
+          window.__timelines = window.__timelines || {};
+          window.__timelines[HF_COMPOSITION_ID] = tl;
+          hfRunGate(v.words, v.durationS, null);
         }
-        fetch("./caption-data.json")
-          .then(function (r) {
-            return r.ok ? r.json() : null;
-          })
-          .catch(function () {
-            return null;
-          })
-          .then(function (json) {
-            start(json || HF_DEMO_DATA);
-          });
+        window.__HF_CAPTION_ATTACH__ = hfAttach;
+
+        (function hfBoot() {
+          function start(data) {
+            var ready =
+              document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+            ready.then(function () {
+              hfAttach(data);
+            });
+          }
+          if (window.__HF_CAPTION__) {
+            start(window.__HF_CAPTION__);
+            return;
+          }
+          fetch("./caption-data.json")
+            .then(function (r) {
+              return r.ok ? r.json() : null;
+            })
+            .catch(function () {
+              return null;
+            })
+            .then(function (json) {
+              start(json || HF_DEMO_DATA);
+            });
+        })();
       })();
     </script>
   </body>
diff --git a/registry/components/caption-weight-shift/caption-weight-shift.html b/registry/components/caption-weight-shift/caption-weight-shift.html
index 3689dfa40d..f2c42f10ff 100644
--- a/registry/components/caption-weight-shift/caption-weight-shift.html
+++ b/registry/components/caption-weight-shift/caption-weight-shift.html
@@ -117,511 +117,523 @@
     </div>
 
     <script>
-      var HF_COMPOSITION_ID = "caption-weight-shift";
-      var HF_ROOT_ID = "weight-shift";
-      var HF_GROUP_SELECTOR = ".caption-group";
-
-      var HF_DEMO_DATA = {
-        version: 1,
-        segments: [
-          {
-            start: 0,
-            text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
-            words: [
-              { text: "Every", start: 0.0, end: 0.3 },
-              { text: "great", start: 0.3, end: 0.55 },
-              { text: "video", start: 0.55, end: 0.85 },
-              { text: "starts", start: 0.85, end: 1.1 },
-              { text: "with", start: 1.1, end: 1.25 },
-              { text: "a", start: 1.25, end: 1.35 },
-              { text: "single", start: 1.35, end: 1.65 },
-              { text: "frame.", start: 1.65, end: 2.0 },
-              { text: "HyperFrames", start: 2.1, end: 2.65 },
-              { text: "lets", start: 2.65, end: 2.85 },
-              { text: "you", start: 2.85, end: 2.95 },
-              { text: "write", start: 2.95, end: 3.15 },
-              { text: "HTML", start: 3.15, end: 3.55 },
-              { text: "and", start: 3.55, end: 3.65 },
-              { text: "render", start: 3.65, end: 3.95 },
-              { text: "professional", start: 3.95, end: 4.45 },
-              { text: "video.", start: 4.45, end: 4.8 },
-              { text: "No", start: 4.9, end: 5.05 },
-              { text: "timeline.", start: 5.05, end: 5.45 },
-              { text: "No", start: 5.5, end: 5.65 },
-              { text: "drag", start: 5.65, end: 5.85 },
-              { text: "and", start: 5.85, end: 5.95 },
-              { text: "drop.", start: 5.95, end: 6.25 },
-              { text: "Just", start: 6.35, end: 6.55 },
-              { text: "code", start: 6.55, end: 6.8 },
-              { text: "that", start: 6.8, end: 6.95 },
-              { text: "becomes", start: 6.95, end: 7.3 },
-              { text: "cinema.", start: 7.3, end: 7.7 },
-            ],
-          },
-        ],
-      };
-
-      /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
-      var HF_CONTRACT_VERSION = 1;
-      var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
-
-      function hfFlattenSegments(segments) {
-        var out = [];
-        (segments || []).forEach(function (seg) {
-          ((seg && seg.words) || []).forEach(function (w) {
-            var start = Math.max(0, Number(w.start) || 0);
-            out.push({
-              text: String(w.word || w.text || "").trim(),
-              start: start,
-              end: Math.max(start, Number(w.end) || 0),
+      // IIFE: keep every template's runtime private to itself so two caption
+      // components pasted into one composition document can't clobber each
+      // other's hfAttach/hfBuild via shared script-scope names (boot is async,
+      // so collisions surface AFTER all scripts have executed).
+      (function () {
+        var HF_COMPOSITION_ID = "caption-weight-shift";
+        var HF_ROOT_ID = "weight-shift";
+        var HF_GROUP_SELECTOR = ".caption-group";
+
+        var HF_DEMO_DATA = {
+          version: 1,
+          segments: [
+            {
+              start: 0,
+              text: "Every great video starts with a single frame. HyperFrames lets you write HTML and render professional video. No timeline. No drag and drop. Just code that becomes cinema.",
+              words: [
+                { text: "Every", start: 0.0, end: 0.3 },
+                { text: "great", start: 0.3, end: 0.55 },
+                { text: "video", start: 0.55, end: 0.85 },
+                { text: "starts", start: 0.85, end: 1.1 },
+                { text: "with", start: 1.1, end: 1.25 },
+                { text: "a", start: 1.25, end: 1.35 },
+                { text: "single", start: 1.35, end: 1.65 },
+                { text: "frame.", start: 1.65, end: 2.0 },
+                { text: "HyperFrames", start: 2.1, end: 2.65 },
+                { text: "lets", start: 2.65, end: 2.85 },
+                { text: "you", start: 2.85, end: 2.95 },
+                { text: "write", start: 2.95, end: 3.15 },
+                { text: "HTML", start: 3.15, end: 3.55 },
+                { text: "and", start: 3.55, end: 3.65 },
+                { text: "render", start: 3.65, end: 3.95 },
+                { text: "professional", start: 3.95, end: 4.45 },
+                { text: "video.", start: 4.45, end: 4.8 },
+                { text: "No", start: 4.9, end: 5.05 },
+                { text: "timeline.", start: 5.05, end: 5.45 },
+                { text: "No", start: 5.5, end: 5.65 },
+                { text: "drag", start: 5.65, end: 5.85 },
+                { text: "and", start: 5.85, end: 5.95 },
+                { text: "drop.", start: 5.95, end: 6.25 },
+                { text: "Just", start: 6.35, end: 6.55 },
+                { text: "code", start: 6.55, end: 6.8 },
+                { text: "that", start: 6.8, end: 6.95 },
+                { text: "becomes", start: 6.95, end: 7.3 },
+                { text: "cinema.", start: 7.3, end: 7.7 },
+              ],
+            },
+          ],
+        };
+
+        /* ── HyperFrames caption-data runtime (shared across caption templates) ── */
+        var HF_CONTRACT_VERSION = 1;
+        var HF_DEFAULT_RESOLUTION = { width: 1920, height: 1080 };
+
+        function hfFlattenSegments(segments) {
+          var out = [];
+          (segments || []).forEach(function (seg) {
+            ((seg && seg.words) || []).forEach(function (w) {
+              var start = Math.max(0, Number(w.start) || 0);
+              out.push({
+                text: String(w.word || w.text || "").trim(),
+                start: start,
+                end: Math.max(start, Number(w.end) || 0),
+              });
             });
           });
-        });
-        out.sort(function (a, b) {
-          return a.start - b.start;
-        });
-        return out.filter(function (w) {
-          return w.text.length > 0;
-        });
-      }
-
-      function hfDeriveDuration(words) {
-        var end = 0;
-        words.forEach(function (w) {
-          if (w.end > end) end = w.end;
-        });
-        return end;
-      }
-
-      function hfValidate(data) {
-        if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-        if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-          return { ok: false, reason: "unsupported-version" };
-        }
-        if (!Array.isArray(data.segments) || data.segments.length === 0) {
-          return { ok: false, reason: "no-segments" };
+          out.sort(function (a, b) {
+            return a.start - b.start;
+          });
+          return out.filter(function (w) {
+            return w.text.length > 0;
+          });
         }
-        if (data.displayMode != null && data.displayMode !== "full") {
-          return { ok: false, reason: "unsupported-displayMode" };
+
+        function hfDeriveDuration(words) {
+          var end = 0;
+          words.forEach(function (w) {
+            if (w.end > end) end = w.end;
+          });
+          return end;
         }
-        var words = hfFlattenSegments(data.segments);
-        if (words.length === 0) return { ok: false, reason: "no-words" };
-        return { ok: true, words: words, durationS: hfDeriveDuration(words) };
-      }
 
-      function hfApplyStageConfig(data, durationS) {
-        var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-        var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-        var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
-        var root = document.getElementById(HF_ROOT_ID);
-        [document.documentElement, document.body, root].forEach(function (el) {
-          el.style.width = W + "px";
-          el.style.height = H + "px";
-        });
-        root.setAttribute("data-width", String(W));
-        root.setAttribute("data-height", String(H));
-        root.setAttribute("data-duration", String(durationS));
-        var brand = (data && data.brand) || {};
-        if (typeof brand.primaryColor === "string" && brand.primaryColor) {
-          root.style.setProperty("--hf-caption-primary", brand.primaryColor);
-        } else {
-          root.style.removeProperty("--hf-caption-primary");
+        function hfValidate(data) {
+          if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
+          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
+            return { ok: false, reason: "unsupported-version" };
+          }
+          if (!Array.isArray(data.segments) || data.segments.length === 0) {
+            return { ok: false, reason: "no-segments" };
+          }
+          if (data.displayMode != null && data.displayMode !== "full") {
+            return { ok: false, reason: "unsupported-displayMode" };
+          }
+          var words = hfFlattenSegments(data.segments);
+          if (words.length === 0) return { ok: false, reason: "no-words" };
+          return { ok: true, words: words, durationS: hfDeriveDuration(words) };
         }
-        if (typeof brand.accentColor === "string" && brand.accentColor) {
-          root.style.setProperty("--hf-caption-accent", brand.accentColor);
-        } else {
-          root.style.removeProperty("--hf-caption-accent");
+
+        function hfApplyStageConfig(data, durationS) {
+          var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
+          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
+          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          var root = document.getElementById(HF_ROOT_ID);
+          [document.documentElement, document.body, root].forEach(function (el) {
+            el.style.width = W + "px";
+            el.style.height = H + "px";
+          });
+          root.setAttribute("data-width", String(W));
+          root.setAttribute("data-height", String(H));
+          root.setAttribute("data-duration", String(durationS));
+          var brand = (data && data.brand) || {};
+          if (typeof brand.primaryColor === "string" && brand.primaryColor) {
+            root.style.setProperty("--hf-caption-primary", brand.primaryColor);
+          } else {
+            root.style.removeProperty("--hf-caption-primary");
+          }
+          if (typeof brand.accentColor === "string" && brand.accentColor) {
+            root.style.setProperty("--hf-caption-accent", brand.accentColor);
+          } else {
+            root.style.removeProperty("--hf-caption-accent");
+          }
+          return {
+            W: W,
+            H: H,
+            scaleX: W / 1920,
+            scaleY: H / 1080,
+            fontScale: Math.min(W, H) / 1080,
+          };
         }
-        return { W: W, H: H, scaleX: W / 1920, scaleY: H / 1080, fontScale: Math.min(W, H) / 1080 };
-      }
 
-      function hfPublishStatus(status) {
-        window.__HF_CAPTION_STATUS = status;
-        document
-          .getElementById(HF_ROOT_ID)
-          .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
-      }
+        function hfPublishStatus(status) {
+          window.__HF_CAPTION_STATUS = status;
+          document
+            .getElementById(HF_ROOT_ID)
+            .setAttribute("data-caption-status", status.ok ? "ok" : "failed");
+        }
 
-      function hfRunGate(words, durationS, failReason) {
-        if (failReason) {
-          hfPublishStatus({
-            ok: false,
-            present: false,
-            contained: false,
-            reason: failReason,
-            version: HF_CONTRACT_VERSION,
-            durationS: durationS || 0,
+        function hfRunGate(words, durationS, failReason) {
+          if (failReason) {
+            hfPublishStatus({
+              ok: false,
+              present: false,
+              contained: false,
+              reason: failReason,
+              version: HF_CONTRACT_VERSION,
+              durationS: durationS || 0,
+            });
+            return;
+          }
+          var root = document.getElementById(HF_ROOT_ID);
+          var rootRect = root.getBoundingClientRect();
+          var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
+          var present = false;
+          var contained = true;
+          var tokens = [];
+          words.forEach(function (w) {
+            var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
+            if (t) tokens.push(t);
           });
-          return;
-        }
-        var root = document.getElementById(HF_ROOT_ID);
-        var rootRect = root.getBoundingClientRect();
-        var groups = root.querySelectorAll(HF_GROUP_SELECTOR);
-        var present = false;
-        var contained = true;
-        var tokens = [];
-        words.forEach(function (w) {
-          var t = w.text.toLowerCase().replace(/[^a-z0-9]/g, "");
-          if (t) tokens.push(t);
-        });
-        groups.forEach(function (el) {
-          var prevOpacity = el.style.opacity;
-          var prevVisibility = el.style.visibility;
-          el.style.opacity = "1";
-          el.style.visibility = "visible";
-          var r = el.getBoundingClientRect();
-          if (r.width > 0 && r.height > 0) {
-            var text = (el.textContent || "").toLowerCase();
-            for (var i = 0; i < tokens.length; i++) {
-              if (text.indexOf(tokens[i]) !== -1) {
-                present = true;
-                break;
+          groups.forEach(function (el) {
+            var prevOpacity = el.style.opacity;
+            var prevVisibility = el.style.visibility;
+            el.style.opacity = "1";
+            el.style.visibility = "visible";
+            var r = el.getBoundingClientRect();
+            if (r.width > 0 && r.height > 0) {
+              var text = (el.textContent || "").toLowerCase();
+              for (var i = 0; i < tokens.length; i++) {
+                if (text.indexOf(tokens[i]) !== -1) {
+                  present = true;
+                  break;
+                }
+              }
+              if (
+                r.left < rootRect.left - 1 ||
+                r.right > rootRect.right + 1 ||
+                r.top < rootRect.top - 1 ||
+                r.bottom > rootRect.bottom + 1
+              ) {
+                contained = false;
               }
             }
-            if (
-              r.left < rootRect.left - 1 ||
-              r.right > rootRect.right + 1 ||
-              r.top < rootRect.top - 1 ||
-              r.bottom > rootRect.bottom + 1
-            ) {
-              contained = false;
-            }
-          }
-          el.style.opacity = prevOpacity;
-          el.style.visibility = prevVisibility;
-        });
-        hfPublishStatus({
-          ok: present && contained,
-          present: present,
-          contained: contained,
-          version: HF_CONTRACT_VERSION,
-          durationS: durationS,
-        });
-      }
-
-      var SAFE_ZONE_WIDTH, MAX_LINE_WIDTH, CAPTION_FONT_SIZE, DURATION;
-      var MAX_WORDS_PER_GROUP = 4;
-      var WORD_SPACING_DESIGN = 12;
-      var WORD_SPACING;
-      var PAUSE_THRESHOLD = 0.1;
-      var ENTRY_DURATION = 100 / 1000;
-      var WEIGHT_TRANSITION = 100 / 1000;
-      var FONT_WIDTH_SAFETY = 1.14;
-      var FONT_WEIGHT_LIGHT = 300;
-      var FONT_WEIGHT_BOLD = 700;
-
-      function normalizeWords(rawWords) {
-        return rawWords
-          .map(function (item) {
-            return {
-              text: String(item.word || item.text || "").trim(),
-              start: Math.max(0, Number(item.start) || 0),
-              end: Math.min(DURATION, Math.max(Number(item.start) || 0, Number(item.end) || 0)),
-            };
-          })
-          .filter(function (word) {
-            return word.text.length > 0;
+            el.style.opacity = prevOpacity;
+            el.style.visibility = prevVisibility;
+          });
+          hfPublishStatus({
+            ok: present && contained,
+            present: present,
+            contained: contained,
+            version: HF_CONTRACT_VERSION,
+            durationS: durationS,
           });
-      }
-
-      var _fitCanvas = document.createElement("canvas");
-      var _fitCtx = _fitCanvas.getContext("2d");
-      function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
-        var size = baseFontSize;
-        var minSize = Math.floor(baseFontSize * 0.45);
-        while (size > minSize) {
-          _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
-          if (_fitCtx.measureText(text).width <= maxWidth) return size;
-          size -= 2;
         }
-        return minSize;
-      }
 
-      var measureCanvas = document.createElement("canvas");
-      var measureContext = measureCanvas.getContext("2d");
+        var SAFE_ZONE_WIDTH, MAX_LINE_WIDTH, CAPTION_FONT_SIZE, DURATION;
+        var MAX_WORDS_PER_GROUP = 4;
+        var WORD_SPACING_DESIGN = 12;
+        var WORD_SPACING;
+        var PAUSE_THRESHOLD = 0.1;
+        var ENTRY_DURATION = 100 / 1000;
+        var WEIGHT_TRANSITION = 100 / 1000;
+        var FONT_WIDTH_SAFETY = 1.14;
+        var FONT_WEIGHT_LIGHT = 300;
+        var FONT_WEIGHT_BOLD = 700;
+
+        function normalizeWords(rawWords) {
+          return rawWords
+            .map(function (item) {
+              return {
+                text: String(item.word || item.text || "").trim(),
+                start: Math.max(0, Number(item.start) || 0),
+                end: Math.min(DURATION, Math.max(Number(item.start) || 0, Number(item.end) || 0)),
+              };
+            })
+            .filter(function (word) {
+              return word.text.length > 0;
+            });
+        }
 
-      function measureWord(word) {
-        return measureContext.measureText(word.text.toLowerCase()).width * FONT_WIDTH_SAFETY;
-      }
+        var _fitCanvas = document.createElement("canvas");
+        var _fitCtx = _fitCanvas.getContext("2d");
+        function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
+          var size = baseFontSize;
+          var minSize = Math.floor(baseFontSize * 0.45);
+          while (size > minSize) {
+            _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
+            if (_fitCtx.measureText(text).width <= maxWidth) return size;
+            size -= 2;
+          }
+          return minSize;
+        }
 
-      function measureLineWidth(words) {
-        return words.reduce(function (total, word, index) {
-          return total + measureWord(word) + (index ? WORD_SPACING : 0);
-        }, 0);
-      }
+        var measureCanvas = document.createElement("canvas");
+        var measureContext = measureCanvas.getContext("2d");
 
-      function fitsInTwoLines(words) {
-        return measureLineWidth(words) <= MAX_LINE_WIDTH * 1.8;
-      }
+        function measureWord(word) {
+          return measureContext.measureText(word.text.toLowerCase()).width * FONT_WIDTH_SAFETY;
+        }
 
-      function splitLines(words) {
-        if (words.length < 2) {
-          return [{ words: words, startIndex: 0 }];
+        function measureLineWidth(words) {
+          return words.reduce(function (total, word, index) {
+            return total + measureWord(word) + (index ? WORD_SPACING : 0);
+          }, 0);
         }
-        var bestSplit = Math.ceil(words.length / 2);
-        var bestDiff = Infinity;
-        for (var s = 1; s < words.length; s++) {
-          var w1 = measureLineWidth(words.slice(0, s));
-          var w2 = measureLineWidth(words.slice(s));
-          if (w1 <= MAX_LINE_WIDTH && w2 <= MAX_LINE_WIDTH) {
-            var diff = Math.abs(w1 - w2);
-            if (diff < bestDiff) {
-              bestDiff = diff;
-              bestSplit = s;
-            }
-          }
+
+        function fitsInTwoLines(words) {
+          return measureLineWidth(words) <= MAX_LINE_WIDTH * 1.8;
         }
-        var result = [];
-        var line1 = words.slice(0, bestSplit);
-        var line2 = words.slice(bestSplit);
-        if (line1.length) result.push({ words: line1, startIndex: 0 });
-        if (line2.length) result.push({ words: line2, startIndex: line1.length });
-        return result;
-      }
 
-      function avoidSingleWordGroups(groups) {
-        var out = [];
-        groups.forEach(function (group) {
-          if (
-            group.words.length === 1 &&
-            out.length > 0 &&
-            out[out.length - 1].words.length < MAX_WORDS_PER_GROUP
-          ) {
-            out[out.length - 1] = makeGroup(out[out.length - 1].words.concat(group.words));
-          } else {
-            out.push(group);
+        function splitLines(words) {
+          if (words.length < 2) {
+            return [{ words: words, startIndex: 0 }];
           }
-        });
-
-        for (var i = 0; i < out.length; i++) {
-          if (out[i].words.length !== 1) continue;
-          if (i + 1 < out.length && out[i + 1].words.length < MAX_WORDS_PER_GROUP) {
-            out[i] = makeGroup(out[i].words.concat(out[i + 1].words));
-            out.splice(i + 1, 1);
-          } else if (i > 0 && out[i - 1].words.length < MAX_WORDS_PER_GROUP) {
-            out[i - 1] = makeGroup(out[i - 1].words.concat(out[i].words));
-            out.splice(i, 1);
-            i--;
+          var bestSplit = Math.ceil(words.length / 2);
+          var bestDiff = Infinity;
+          for (var s = 1; s < words.length; s++) {
+            var w1 = measureLineWidth(words.slice(0, s));
+            var w2 = measureLineWidth(words.slice(s));
+            if (w1 <= MAX_LINE_WIDTH && w2 <= MAX_LINE_WIDTH) {
+              var diff = Math.abs(w1 - w2);
+              if (diff < bestDiff) {
+                bestDiff = diff;
+                bestSplit = s;
+              }
+            }
           }
+          var result = [];
+          var line1 = words.slice(0, bestSplit);
+          var line2 = words.slice(bestSplit);
+          if (line1.length) result.push({ words: line1, startIndex: 0 });
+          if (line2.length) result.push({ words: line2, startIndex: line1.length });
+          return result;
         }
 
-        return out;
-      }
+        function avoidSingleWordGroups(groups) {
+          var out = [];
+          groups.forEach(function (group) {
+            if (
+              group.words.length === 1 &&
+              out.length > 0 &&
+              out[out.length - 1].words.length < MAX_WORDS_PER_GROUP
+            ) {
+              out[out.length - 1] = makeGroup(out[out.length - 1].words.concat(group.words));
+            } else {
+              out.push(group);
+            }
+          });
 
-      function makeGroups(words) {
-        var groups = [];
-        var current = [];
-        words.forEach(function (word, index) {
-          var nextWord = words[index + 1];
-          var testGroup = current.concat([word]);
-          if (testGroup.length > MAX_WORDS_PER_GROUP || !fitsInTwoLines(testGroup)) {
-            if (current.length) groups.push(makeGroup(current));
-            current = [word];
-            return;
-          }
-          current.push(word);
-          var punctuation = /[,.:!?]$/.test(word.text);
-          var pause = nextWord ? nextWord.start - word.end : 0;
-          if (
-            !nextWord ||
-            punctuation ||
-            pause >= PAUSE_THRESHOLD ||
-            current.length >= MAX_WORDS_PER_GROUP
-          ) {
-            groups.push(makeGroup(current));
-            current = [];
+          for (var i = 0; i < out.length; i++) {
+            if (out[i].words.length !== 1) continue;
+            if (i + 1 < out.length && out[i + 1].words.length < MAX_WORDS_PER_GROUP) {
+              out[i] = makeGroup(out[i].words.concat(out[i + 1].words));
+              out.splice(i + 1, 1);
+            } else if (i > 0 && out[i - 1].words.length < MAX_WORDS_PER_GROUP) {
+              out[i - 1] = makeGroup(out[i - 1].words.concat(out[i].words));
+              out.splice(i, 1);
+              i--;
+            }
           }
-        });
-        if (current.length) groups.push(makeGroup(current));
-        return avoidSingleWordGroups(groups);
-      }
 
-      function makeGroup(words) {
-        return {
-          words: words.slice(),
-          lines: splitLines(words),
-          start: words[0].start,
-          end: words[words.length - 1].end,
-        };
-      }
+          return out;
+        }
 
-      function buildCaptions(groups) {
-        var stage = document.getElementById("caption-stage");
-        groups.forEach(function (group, groupIndex) {
-          var groupText = group.words
-            .map(function (w) {
-              return w.text.toLowerCase();
-            })
-            .join(" ");
-          var computedSize = fitFontSize(
-            groupText,
-            CAPTION_FONT_SIZE,
-            "700",
-            "Montserrat",
-            MAX_LINE_WIDTH,
-          );
-          var groupEl = document.createElement("div");
-          var copyEl = document.createElement("div");
-          groupEl.id = "caption-group-" + groupIndex;
-          groupEl.className = "caption-group";
-          copyEl.className = "caption-copy";
-          group.lines.forEach(function (line, lineIndex) {
-            var lineEl = document.createElement("div");
-            lineEl.className = "caption-line";
-            lineEl.id = "caption-group-" + groupIndex + "-line-" + lineIndex;
-            lineEl.style.fontWeight = lineIndex === 0 ? FONT_WEIGHT_BOLD : FONT_WEIGHT_LIGHT;
-            lineEl.style.fontSize = computedSize + "px";
-            lineEl.style.maxWidth = SAFE_ZONE_WIDTH + "px";
-            line.words.forEach(function (word, wordIndex) {
-              var wordEl = document.createElement("span");
-              wordEl.textContent = word.text.toLowerCase();
-              wordEl.style.display = "inline-block";
-              lineEl.appendChild(wordEl);
+        function makeGroups(words) {
+          var groups = [];
+          var current = [];
+          words.forEach(function (word, index) {
+            var nextWord = words[index + 1];
+            var testGroup = current.concat([word]);
+            if (testGroup.length > MAX_WORDS_PER_GROUP || !fitsInTwoLines(testGroup)) {
+              if (current.length) groups.push(makeGroup(current));
+              current = [word];
+              return;
+            }
+            current.push(word);
+            var punctuation = /[,.:!?]$/.test(word.text);
+            var pause = nextWord ? nextWord.start - word.end : 0;
+            if (
+              !nextWord ||
+              punctuation ||
+              pause >= PAUSE_THRESHOLD ||
+              current.length >= MAX_WORDS_PER_GROUP
+            ) {
+              groups.push(makeGroup(current));
+              current = [];
+            }
+          });
+          if (current.length) groups.push(makeGroup(current));
+          return avoidSingleWordGroups(groups);
+        }
+
+        function makeGroup(words) {
+          return {
+            words: words.slice(),
+            lines: splitLines(words),
+            start: words[0].start,
+            end: words[words.length - 1].end,
+          };
+        }
+
+        function buildCaptions(groups) {
+          var stage = document.getElementById("caption-stage");
+          groups.forEach(function (group, groupIndex) {
+            var groupText = group.words
+              .map(function (w) {
+                return w.text.toLowerCase();
+              })
+              .join(" ");
+            var computedSize = fitFontSize(
+              groupText,
+              CAPTION_FONT_SIZE,
+              "700",
+              "Montserrat",
+              MAX_LINE_WIDTH,
+            );
+            var groupEl = document.createElement("div");
+            var copyEl = document.createElement("div");
+            groupEl.id = "caption-group-" + groupIndex;
+            groupEl.className = "caption-group";
+            copyEl.className = "caption-copy";
+            group.lines.forEach(function (line, lineIndex) {
+              var lineEl = document.createElement("div");
+              lineEl.className = "caption-line";
+              lineEl.id = "caption-group-" + groupIndex + "-line-" + lineIndex;
+              lineEl.style.fontWeight = lineIndex === 0 ? FONT_WEIGHT_BOLD : FONT_WEIGHT_LIGHT;
+              lineEl.style.fontSize = computedSize + "px";
+              lineEl.style.maxWidth = SAFE_ZONE_WIDTH + "px";
+              line.words.forEach(function (word, wordIndex) {
+                var wordEl = document.createElement("span");
+                wordEl.textContent = word.text.toLowerCase();
+                wordEl.style.display = "inline-block";
+                lineEl.appendChild(wordEl);
+              });
+              copyEl.appendChild(lineEl);
             });
-            copyEl.appendChild(lineEl);
+            groupEl.appendChild(copyEl);
+            stage.appendChild(groupEl);
           });
-          groupEl.appendChild(copyEl);
-          stage.appendChild(groupEl);
-        });
-      }
+        }
 
-      function hfTeardown() {
-        document.getElementById("caption-stage").innerHTML = "";
-      }
+        function hfTeardown() {
+          document.getElementById("caption-stage").innerHTML = "";
+        }
+
+        function hfBuild(words, layout, durationS) {
+          DURATION = durationS;
+          CAPTION_FONT_SIZE = Math.round(72 * layout.fontScale);
+          SAFE_ZONE_WIDTH = Math.round(1400 * layout.scaleX);
+          MAX_LINE_WIDTH = SAFE_ZONE_WIDTH - Math.round(40 * layout.scaleX);
+          WORD_SPACING = Math.round(WORD_SPACING_DESIGN * layout.fontScale);
+
+          var stage = document.getElementById("caption-stage");
+          var stageHeight = Math.round(278 * layout.fontScale);
+          stage.style.width = SAFE_ZONE_WIDTH + "px";
+          stage.style.height = stageHeight + "px";
+          stage.style.bottom = Math.round(100 * layout.scaleY) + "px";
+
+          measureContext.font = "700 " + CAPTION_FONT_SIZE + "px Montserrat";
+
+          var WORDS = normalizeWords(words);
+          var GROUPS = makeGroups(WORDS);
+          buildCaptions(GROUPS);
+          // set per-group sizing to match the runtime stage
+          GROUPS.forEach(function (_, i) {
+            var el = document.getElementById("caption-group-" + i);
+            el.style.width = SAFE_ZONE_WIDTH + "px";
+            el.style.height = stageHeight + "px";
+          });
 
-      function hfBuild(words, layout, durationS) {
-        DURATION = durationS;
-        CAPTION_FONT_SIZE = Math.round(72 * layout.fontScale);
-        SAFE_ZONE_WIDTH = Math.round(1400 * layout.scaleX);
-        MAX_LINE_WIDTH = SAFE_ZONE_WIDTH - Math.round(40 * layout.scaleX);
-        WORD_SPACING = Math.round(WORD_SPACING_DESIGN * layout.fontScale);
-
-        var stage = document.getElementById("caption-stage");
-        var stageHeight = Math.round(278 * layout.fontScale);
-        stage.style.width = SAFE_ZONE_WIDTH + "px";
-        stage.style.height = stageHeight + "px";
-        stage.style.bottom = Math.round(100 * layout.scaleY) + "px";
-
-        measureContext.font = "700 " + CAPTION_FONT_SIZE + "px Montserrat";
-
-        var WORDS = normalizeWords(words);
-        var GROUPS = makeGroups(WORDS);
-        buildCaptions(GROUPS);
-        // set per-group sizing to match the runtime stage
-        GROUPS.forEach(function (_, i) {
-          var el = document.getElementById("caption-group-" + i);
-          el.style.width = SAFE_ZONE_WIDTH + "px";
-          el.style.height = stageHeight + "px";
-        });
-
-        var tl = gsap.timeline({ paused: true });
-
-        var visibleStarts = GROUPS.map(function (group, groupIndex) {
-          var prev = GROUPS[groupIndex - 1];
-          var availableGap = prev ? Math.max(0, group.start - prev.end) : ENTRY_DURATION;
-          var entryLead = Math.min(ENTRY_DURATION, availableGap);
-          return Math.max(0, group.start - entryLead);
-        });
-
-        var allGroupEls = GROUPS.map(function (_, i) {
-          return document.getElementById("caption-group-" + i);
-        });
-
-        GROUPS.forEach(function (group, groupIndex) {
-          var groupEl = allGroupEls[groupIndex];
-          var visibleStart = visibleStarts[groupIndex];
-          var visibleEnd =
-            groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
-
-          // Each group already owns its full opacity lifecycle (set 0 at its
-          // own visibleStart, animated to 1, then set back to 0 at its own
-          // visibleEnd below), and groups occupy non-overlapping windows, so
-          // explicitly hiding every OTHER group here was redundant and made
-          // timeline construction O(groups^2) — this collapsed under dense
-          // stress transcripts (many short groups). Removed; behavior is
-          // unchanged (verified against templates.test.ts).
-
-          tl.set(groupEl, { opacity: 0, scale: 0.85 }, visibleStart);
-          tl.to(
-            groupEl,
-            { opacity: 1, scale: 1, duration: ENTRY_DURATION, ease: "power3.out", force3D: true },
-            visibleStart,
-          );
-
-          if (group.lines.length === 2) {
-            var line1El = document.getElementById("caption-group-" + groupIndex + "-line-0");
-            var line2El = document.getElementById("caption-group-" + groupIndex + "-line-1");
-            var line2FirstWord = group.lines[1].words[0];
-            var switchTime = line2FirstWord.start;
+          var tl = gsap.timeline({ paused: true });
 
-            tl.to(
-              line1El,
-              { fontWeight: FONT_WEIGHT_LIGHT, duration: WEIGHT_TRANSITION, ease: "power2.out" },
-              switchTime,
-            );
-            tl.to(
-              line2El,
-              { fontWeight: FONT_WEIGHT_BOLD, duration: WEIGHT_TRANSITION, ease: "power2.out" },
-              switchTime,
-            );
-          }
+          var visibleStarts = GROUPS.map(function (group, groupIndex) {
+            var prev = GROUPS[groupIndex - 1];
+            var availableGap = prev ? Math.max(0, group.start - prev.end) : ENTRY_DURATION;
+            var entryLead = Math.min(ENTRY_DURATION, availableGap);
+            return Math.max(0, group.start - entryLead);
+          });
 
-          tl.set(groupEl, { opacity: 0 }, visibleEnd);
-        });
+          var allGroupEls = GROUPS.map(function (_, i) {
+            return document.getElementById("caption-group-" + i);
+          });
 
-        return tl;
-      }
+          GROUPS.forEach(function (group, groupIndex) {
+            var groupEl = allGroupEls[groupIndex];
+            var visibleStart = visibleStarts[groupIndex];
+            var visibleEnd =
+              groupIndex < GROUPS.length - 1 ? visibleStarts[groupIndex + 1] : DURATION;
+
+            // Each group already owns its full opacity lifecycle (set 0 at its
+            // own visibleStart, animated to 1, then set back to 0 at its own
+            // visibleEnd below), and groups occupy non-overlapping windows, so
+            // explicitly hiding every OTHER group here was redundant and made
+            // timeline construction O(groups^2) — this collapsed under dense
+            // stress transcripts (many short groups). Removed; behavior is
+            // unchanged (verified against templates.test.ts).
+
+            tl.set(groupEl, { opacity: 0, scale: 0.85 }, visibleStart);
+            tl.to(
+              groupEl,
+              { opacity: 1, scale: 1, duration: ENTRY_DURATION, ease: "power3.out", force3D: true },
+              visibleStart,
+            );
 
-      var hfCurrentTimeline = null;
+            if (group.lines.length === 2) {
+              var line1El = document.getElementById("caption-group-" + groupIndex + "-line-0");
+              var line2El = document.getElementById("caption-group-" + groupIndex + "-line-1");
+              var line2FirstWord = group.lines[1].words[0];
+              var switchTime = line2FirstWord.start;
+
+              tl.to(
+                line1El,
+                { fontWeight: FONT_WEIGHT_LIGHT, duration: WEIGHT_TRANSITION, ease: "power2.out" },
+                switchTime,
+              );
+              tl.to(
+                line2El,
+                { fontWeight: FONT_WEIGHT_BOLD, duration: WEIGHT_TRANSITION, ease: "power2.out" },
+                switchTime,
+              );
+            }
 
-      function hfAttach(data) {
-        var v = hfValidate(data);
-        if (!v.ok) {
-          hfRunGate([], 0, v.reason);
-          return;
-        }
-        if (hfCurrentTimeline) {
-          hfCurrentTimeline.kill();
-          hfCurrentTimeline = null;
-        }
-        hfTeardown();
-        var layout = hfApplyStageConfig(data, v.durationS);
-        var tl = hfBuild(v.words, layout, v.durationS);
-        tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
-        // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
-        // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
-        // at t=0 — the first frame would show pre-timeline CSS defaults (usually
-        // hidden). render(time, suppressEvents, force) with force=true bypasses that.
-        tl.render(0, true, true);
-        hfCurrentTimeline = tl;
-        window.__timelines = window.__timelines || {};
-        window.__timelines[HF_COMPOSITION_ID] = tl;
-        hfRunGate(v.words, v.durationS, null);
-      }
-      window.__HF_CAPTION_ATTACH__ = hfAttach;
-
-      (function hfBoot() {
-        function start(data) {
-          var ready =
-            document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
-          ready.then(function () {
-            hfAttach(data);
+            tl.set(groupEl, { opacity: 0 }, visibleEnd);
           });
+
+          return tl;
         }
-        if (window.__HF_CAPTION__) {
-          start(window.__HF_CAPTION__);
-          return;
+
+        var hfCurrentTimeline = null;
+
+        function hfAttach(data) {
+          var v = hfValidate(data);
+          if (!v.ok) {
+            hfRunGate([], 0, v.reason);
+            return;
+          }
+          if (hfCurrentTimeline) {
+            hfCurrentTimeline.kill();
+            hfCurrentTimeline = null;
+          }
+          hfTeardown();
+          var layout = hfApplyStageConfig(data, v.durationS);
+          var tl = hfBuild(v.words, layout, v.durationS);
+          tl.set({}, {}, v.durationS); // pin timeline length to the data-derived duration
+          // GSAP quirk (confirmed 3.14.2): a fresh timeline already reports position 0,
+          // so seek(0) is treated as a no-op and skips rendering .set() calls scheduled
+          // at t=0 — the first frame would show pre-timeline CSS defaults (usually
+          // hidden). render(time, suppressEvents, force) with force=true bypasses that.
+          tl.render(0, true, true);
+          hfCurrentTimeline = tl;
+          window.__timelines = window.__timelines || {};
+          window.__timelines[HF_COMPOSITION_ID] = tl;
+          hfRunGate(v.words, v.durationS, null);
         }
-        fetch("./caption-data.json")
-          .then(function (r) {
-            return r.ok ? r.json() : null;
-          })
-          .catch(function () {
-            return null;
-          })
-          .then(function (json) {
-            start(json || HF_DEMO_DATA);
-          });
+        window.__HF_CAPTION_ATTACH__ = hfAttach;
+
+        (function hfBoot() {
+          function start(data) {
+            var ready =
+              document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
+            ready.then(function () {
+              hfAttach(data);
+            });
+          }
+          if (window.__HF_CAPTION__) {
+            start(window.__HF_CAPTION__);
+            return;
+          }
+          fetch("./caption-data.json")
+            .then(function (r) {
+              return r.ok ? r.json() : null;
+            })
+            .catch(function () {
+              return null;
+            })
+            .then(function (json) {
+              start(json || HF_DEMO_DATA);
+            });
+        })();
       })();
     </script>
   </body>

From 5c2981d066480000d623e4d023e9cf918b2772e3 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Fri, 24 Jul 2026 05:55:21 +0000
Subject: [PATCH 043/125] fix(registry): reject non-numeric caption-data
 versions; boot fetch never clobbers a manual attach
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two review findings on the caption-data runtime, applied to all 5 templates:
- hfValidate's version gate used Math.floor(Number(v)) > HF_CONTRACT_VERSION,
  and Number("v2") is NaN — NaN comparisons are always false, so malformed
  versions slid through with no unsupported-version signal. An explicit
  Number.isFinite check closes it.
- hfBoot's sibling-fetch .then called hfAttach unconditionally; a manual
  window.__HF_CAPTION_ATTACH__ call landing while the fetch or fonts.ready
  was still pending got clobbered by the late boot payload. Boot now yields
  if a timeline already exists.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../caption-editorial-emphasis.html                 | 13 +++++++++++--
 .../caption-emoji-pop/caption-emoji-pop.html        | 13 +++++++++++--
 .../caption-highlight/caption-highlight.html        | 13 +++++++++++--
 .../caption-pill-karaoke/caption-pill-karaoke.html  | 13 +++++++++++--
 .../caption-weight-shift/caption-weight-shift.html  | 13 +++++++++++--
 5 files changed, 55 insertions(+), 10 deletions(-)

diff --git a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
index 83f808425a..3790946ee0 100644
--- a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
+++ b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
@@ -205,8 +205,13 @@
 
         function hfValidate(data) {
           if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-            return { ok: false, reason: "unsupported-version" };
+          if (data.version != null) {
+            // Number("v2") is NaN and NaN > x is always false — an explicit
+            // finite check keeps malformed versions from slipping past the gate.
+            var hfVersion = Number(data.version);
+            if (!Number.isFinite(hfVersion) || Math.floor(hfVersion) > HF_CONTRACT_VERSION) {
+              return { ok: false, reason: "unsupported-version" };
+            }
           }
           if (!Array.isArray(data.segments) || data.segments.length === 0) {
             return { ok: false, reason: "no-segments" };
@@ -679,6 +684,10 @@
             var ready =
               document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
             ready.then(function () {
+              // A manual window.__HF_CAPTION_ATTACH__ call that lands while the
+              // sibling fetch / fonts.ready are still pending must win — never
+              // clobber it with the late-arriving boot payload.
+              if (hfCurrentTimeline) return;
               hfAttach(data);
             });
           }
diff --git a/registry/components/caption-emoji-pop/caption-emoji-pop.html b/registry/components/caption-emoji-pop/caption-emoji-pop.html
index 6d6f15c697..7c982e2781 100644
--- a/registry/components/caption-emoji-pop/caption-emoji-pop.html
+++ b/registry/components/caption-emoji-pop/caption-emoji-pop.html
@@ -208,8 +208,13 @@
 
         function hfValidate(data) {
           if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-            return { ok: false, reason: "unsupported-version" };
+          if (data.version != null) {
+            // Number("v2") is NaN and NaN > x is always false — an explicit
+            // finite check keeps malformed versions from slipping past the gate.
+            var hfVersion = Number(data.version);
+            if (!Number.isFinite(hfVersion) || Math.floor(hfVersion) > HF_CONTRACT_VERSION) {
+              return { ok: false, reason: "unsupported-version" };
+            }
           }
           if (!Array.isArray(data.segments) || data.segments.length === 0) {
             return { ok: false, reason: "no-segments" };
@@ -790,6 +795,10 @@
             var ready =
               document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
             ready.then(function () {
+              // A manual window.__HF_CAPTION_ATTACH__ call that lands while the
+              // sibling fetch / fonts.ready are still pending must win — never
+              // clobber it with the late-arriving boot payload.
+              if (hfCurrentTimeline) return;
               hfAttach(data);
             });
           }
diff --git a/registry/components/caption-highlight/caption-highlight.html b/registry/components/caption-highlight/caption-highlight.html
index b87f407e84..a1d1b8be96 100644
--- a/registry/components/caption-highlight/caption-highlight.html
+++ b/registry/components/caption-highlight/caption-highlight.html
@@ -214,8 +214,13 @@
 
         function hfValidate(data) {
           if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-            return { ok: false, reason: "unsupported-version" };
+          if (data.version != null) {
+            // Number("v2") is NaN and NaN > x is always false — an explicit
+            // finite check keeps malformed versions from slipping past the gate.
+            var hfVersion = Number(data.version);
+            if (!Number.isFinite(hfVersion) || Math.floor(hfVersion) > HF_CONTRACT_VERSION) {
+              return { ok: false, reason: "unsupported-version" };
+            }
           }
           if (!Array.isArray(data.segments) || data.segments.length === 0) {
             return { ok: false, reason: "no-segments" };
@@ -491,6 +496,10 @@
             var ready =
               document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
             ready.then(function () {
+              // A manual window.__HF_CAPTION_ATTACH__ call that lands while the
+              // sibling fetch / fonts.ready are still pending must win — never
+              // clobber it with the late-arriving boot payload.
+              if (hfCurrentTimeline) return;
               hfAttach(data);
             });
           }
diff --git a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
index 341400fb80..c0025e2629 100644
--- a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
+++ b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
@@ -214,8 +214,13 @@
 
         function hfValidate(data) {
           if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-            return { ok: false, reason: "unsupported-version" };
+          if (data.version != null) {
+            // Number("v2") is NaN and NaN > x is always false — an explicit
+            // finite check keeps malformed versions from slipping past the gate.
+            var hfVersion = Number(data.version);
+            if (!Number.isFinite(hfVersion) || Math.floor(hfVersion) > HF_CONTRACT_VERSION) {
+              return { ok: false, reason: "unsupported-version" };
+            }
           }
           if (!Array.isArray(data.segments) || data.segments.length === 0) {
             return { ok: false, reason: "no-segments" };
@@ -599,6 +604,10 @@
             var ready =
               document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
             ready.then(function () {
+              // A manual window.__HF_CAPTION_ATTACH__ call that lands while the
+              // sibling fetch / fonts.ready are still pending must win — never
+              // clobber it with the late-arriving boot payload.
+              if (hfCurrentTimeline) return;
               hfAttach(data);
             });
           }
diff --git a/registry/components/caption-weight-shift/caption-weight-shift.html b/registry/components/caption-weight-shift/caption-weight-shift.html
index f2c42f10ff..d6340fd6a2 100644
--- a/registry/components/caption-weight-shift/caption-weight-shift.html
+++ b/registry/components/caption-weight-shift/caption-weight-shift.html
@@ -200,8 +200,13 @@
 
         function hfValidate(data) {
           if (!data || typeof data !== "object") return { ok: false, reason: "not-an-object" };
-          if (data.version != null && Math.floor(Number(data.version)) > HF_CONTRACT_VERSION) {
-            return { ok: false, reason: "unsupported-version" };
+          if (data.version != null) {
+            // Number("v2") is NaN and NaN > x is always false — an explicit
+            // finite check keeps malformed versions from slipping past the gate.
+            var hfVersion = Number(data.version);
+            if (!Number.isFinite(hfVersion) || Math.floor(hfVersion) > HF_CONTRACT_VERSION) {
+              return { ok: false, reason: "unsupported-version" };
+            }
           }
           if (!Array.isArray(data.segments) || data.segments.length === 0) {
             return { ok: false, reason: "no-segments" };
@@ -616,6 +621,10 @@
             var ready =
               document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve();
             ready.then(function () {
+              // A manual window.__HF_CAPTION_ATTACH__ call that lands while the
+              // sibling fetch / fonts.ready are still pending must win — never
+              // clobber it with the late-arriving boot payload.
+              if (hfCurrentTimeline) return;
               hfAttach(data);
             });
           }

From 8bf939043fb44e05f6dd7caba81822ac5ef18334 Mon Sep 17 00:00:00 2001
From: vanceingalls <vance@heygen.com>
Date: Fri, 24 Jul 2026 06:10:00 +0000
Subject: [PATCH 044/125] fix(registry): liberal emoji-pop brand colors,
 weight-shift fit fixes, 8192 clamp
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- caption-emoji-pop: shadowForColor now builds its glow via color-mix()
  instead of hex-pair slicing, so the strict 6-digit brand-color gate is
  gone — any CSS color the sibling templates accept (#fff, rgb(), named)
  now renders instead of silently falling back to the default palette

- caption-weight-shift: fitFontSize now sizes against the WIDEST split
  line rather than the joined group text (two-line groups no longer shrink
  unnecessarily), and avoidSingleWordGroups' merges re-check fitsInTwoLines
  like makeGroups' first pass does (merged groups can no longer overflow
  the split budget)

- all 5: hfApplyStageConfig clamps resolution to the published validator's
  <=8192 bound (validator is optional pre-flight; unbounded stages OOM
  render workers), and fit floors carry a comment documenting that the
  minimum size is returned unverified by design

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../caption-editorial-emphasis.html           | 16 +++++-
 .../caption-emoji-pop/caption-emoji-pop.html  | 52 +++++++++--------
 .../caption-highlight/caption-highlight.html  | 16 +++++-
 .../caption-pill-karaoke.html                 | 16 +++++-
 .../caption-weight-shift.html                 | 57 +++++++++++++++----
 5 files changed, 117 insertions(+), 40 deletions(-)

diff --git a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
index 3790946ee0..2622b09a80 100644
--- a/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
+++ b/registry/components/caption-editorial-emphasis/caption-editorial-emphasis.html
@@ -226,8 +226,17 @@
 
         function hfApplyStageConfig(data, durationS) {
           var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          // Mirror the published validator's <=8192 bound defensively — the
+          // validator is an optional pre-flight, and an unbounded stage size
+          // would OOM render workers.
+          var W = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width)),
+          );
+          var H = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height)),
+          );
           var root = document.getElementById(HF_ROOT_ID);
           [document.documentElement, document.body, root].forEach(function (el) {
             el.style.width = W + "px";
@@ -420,6 +429,9 @@
         function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
           var size = baseFontSize;
           var minSize = Math.floor(baseFontSize * 0.45);
+          // minSize is a hard floor returned unverified below — self-heal
+          // accepts residual overflow at the floor (clipped by the stage)
+          // rather than shrinking below legibility.
           while (size > minSize) {
             _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
             if (_fitCtx.measureText(text).width <= maxWidth) return size;
diff --git a/registry/components/caption-emoji-pop/caption-emoji-pop.html b/registry/components/caption-emoji-pop/caption-emoji-pop.html
index 7c982e2781..11d7c77f86 100644
--- a/registry/components/caption-emoji-pop/caption-emoji-pop.html
+++ b/registry/components/caption-emoji-pop/caption-emoji-pop.html
@@ -229,8 +229,17 @@
 
         function hfApplyStageConfig(data, durationS) {
           var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          // Mirror the published validator's <=8192 bound defensively — the
+          // validator is an optional pre-flight, and an unbounded stage size
+          // would OOM render workers.
+          var W = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width)),
+          );
+          var H = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height)),
+          );
           var root = document.getElementById(HF_ROOT_ID);
           [document.documentElement, document.body, root].forEach(function (el) {
             el.style.width = W + "px";
@@ -532,6 +541,9 @@
         function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
           var size = baseFontSize;
           var minSize = Math.floor(baseFontSize * 0.45);
+          // minSize is a hard floor returned unverified below — self-heal
+          // accepts residual overflow at the floor (clipped by the stage)
+          // rather than shrinking below legibility.
           while (size > minSize) {
             _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
             if (_fitCtx.measureText(text).width <= maxWidth) return size;
@@ -605,24 +617,16 @@
         }
 
         function shadowForColor(color) {
-          var hex = color.replace("#", "");
-          var r = parseInt(hex.slice(0, 2), 16);
-          var g = parseInt(hex.slice(2, 4), 16);
-          var b = parseInt(hex.slice(4, 6), 16);
+          // color-mix handles ANY CSS color (hex of either length, rgb()/hsl(),
+          // named colors) — the old hex-pair slicing was why brand colors were
+          // gated behind a strict 6-digit regex, silently dropping payloads the
+          // sibling templates accept.
           return (
-            "0 4px 8px rgba(0,0,0,0.7), 0 0 2px rgba(" +
-            r +
-            "," +
-            g +
-            "," +
-            b +
-            ",1), 0 0 8px rgba(" +
-            r +
-            "," +
-            g +
-            "," +
-            b +
-            ",0.6)"
+            "0 4px 8px rgba(0,0,0,0.7), 0 0 2px " +
+            color +
+            ", 0 0 8px color-mix(in srgb, " +
+            color +
+            " 60%, transparent)"
           );
         }
 
@@ -689,12 +693,14 @@
           stage.style.bottom = Math.round(80 * layout.scaleY) + "px";
 
           var rootEl = document.getElementById(HF_ROOT_ID);
+          // Any non-empty CSS color is honored (mirrors caption-pill-karaoke) —
+          // shadowForColor no longer needs parseable hex, so the old 6-digit
+          // gate (which silently dropped #fff / rgb() / named colors that the
+          // sibling templates accept) is gone.
           var primary = getComputedStyle(rootEl).getPropertyValue("--hf-caption-primary").trim();
           var accent = getComputedStyle(rootEl).getPropertyValue("--hf-caption-accent").trim();
-          hfPrimaryColor = /^#[0-9a-f]{6}$/i.test(primary) ? primary : "#FFFFFF";
-          hfAccentColors = /^#[0-9a-f]{6}$/i.test(accent)
-            ? [accent]
-            : ["#FF76FF", "#FF0002", "#B2F7FF"];
+          hfPrimaryColor = primary || "#FFFFFF";
+          hfAccentColors = accent ? [accent] : ["#FF76FF", "#FF0002", "#B2F7FF"];
 
           var WORDS = normalizeWords(words);
           var GROUPS = makeGroups(WORDS);
diff --git a/registry/components/caption-highlight/caption-highlight.html b/registry/components/caption-highlight/caption-highlight.html
index a1d1b8be96..2156930ceb 100644
--- a/registry/components/caption-highlight/caption-highlight.html
+++ b/registry/components/caption-highlight/caption-highlight.html
@@ -132,6 +132,9 @@
         function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
           var size = baseFontSize;
           var minSize = Math.floor(baseFontSize * 0.45);
+          // minSize is a hard floor returned unverified below — self-heal
+          // accepts residual overflow at the floor (clipped by the stage)
+          // rather than shrinking below legibility.
           while (size > minSize) {
             _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
             if (_fitCtx.measureText(text).width <= maxWidth) return size;
@@ -235,8 +238,17 @@
 
         function hfApplyStageConfig(data, durationS) {
           var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          // Mirror the published validator's <=8192 bound defensively — the
+          // validator is an optional pre-flight, and an unbounded stage size
+          // would OOM render workers.
+          var W = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width)),
+          );
+          var H = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height)),
+          );
           var root = document.getElementById(HF_ROOT_ID);
           [document.documentElement, document.body, root].forEach(function (el) {
             el.style.width = W + "px";
diff --git a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
index c0025e2629..5e19c8ed47 100644
--- a/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
+++ b/registry/components/caption-pill-karaoke/caption-pill-karaoke.html
@@ -235,8 +235,17 @@
 
         function hfApplyStageConfig(data, durationS) {
           var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          // Mirror the published validator's <=8192 bound defensively — the
+          // validator is an optional pre-flight, and an unbounded stage size
+          // would OOM render workers.
+          var W = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width)),
+          );
+          var H = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height)),
+          );
           var root = document.getElementById(HF_ROOT_ID);
           [document.documentElement, document.body, root].forEach(function (el) {
             el.style.width = W + "px";
@@ -464,6 +473,9 @@
 
         function fontSizeForGroup(words) {
           var size = BASE_FONT_SIZE;
+          // MIN_FONT_SIZE is a hard floor returned unverified below — self-heal
+          // accepts residual overflow at the floor (clipped by the stage)
+          // rather than shrinking below legibility.
           while (size > MIN_FONT_SIZE && !fitsInTwoLinesAtSize(words, size)) {
             size -= 2;
           }
diff --git a/registry/components/caption-weight-shift/caption-weight-shift.html b/registry/components/caption-weight-shift/caption-weight-shift.html
index d6340fd6a2..b42c4e59ae 100644
--- a/registry/components/caption-weight-shift/caption-weight-shift.html
+++ b/registry/components/caption-weight-shift/caption-weight-shift.html
@@ -221,8 +221,17 @@
 
         function hfApplyStageConfig(data, durationS) {
           var res = (data && data.resolution) || HF_DEFAULT_RESOLUTION;
-          var W = Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width));
-          var H = Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height));
+          // Mirror the published validator's <=8192 bound defensively — the
+          // validator is an optional pre-flight, and an unbounded stage size
+          // would OOM render workers.
+          var W = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.width) || HF_DEFAULT_RESOLUTION.width)),
+          );
+          var H = Math.min(
+            8192,
+            Math.max(1, Math.round(Number(res.height) || HF_DEFAULT_RESOLUTION.height)),
+          );
           var root = document.getElementById(HF_ROOT_ID);
           [document.documentElement, document.body, root].forEach(function (el) {
             el.style.width = W + "px";
@@ -345,6 +354,9 @@
         function fitFontSize(text, baseFontSize, fontWeight, fontFamily, maxWidth) {
           var size = baseFontSize;
           var minSize = Math.floor(baseFontSize * 0.45);
+          // minSize is a hard floor returned unverified below — self-heal
+          // accepts residual overflow at the floor (clipped by the stage)
+          // rather than shrinking below legibility.
           while (size > minSize) {
             _fitCtx.font = fontWeight + " " + size + "px " + fontFamily;
             if (_fitCtx.measureText(text).width <= maxWidth) return size;
@@ -401,7 +413,11 @@
             if (
               group.words.length === 1 &&
               out.length > 0 &&
-              out[out.length - 1].words.length < MAX_WORDS_PER_GROUP
+              out[out.length - 1].words.length < MAX_WORDS_PER_GROUP &&
+              // makeGroups guards every addition with fitsInTwoLines; this
+              // second-pass merge must too, or it can produce a group that
+              // splitLines cannot fit within MAX_LINE_WIDTH.
+              fitsInTwoLines(out[out.length - 1].words.concat(group.words))
             ) {
               out[out.length - 1] = makeGroup(out[out.length - 1].words.concat(group.words));
             } else {
@@ -411,10 +427,18 @@
 
           for (var i = 0; i < out.length; i++) {
             if (out[i].words.length !== 1) continue;
-            if (i + 1 < out.length && out[i + 1].words.length < MAX_WORDS_PER_GROUP) {
+            if (
+              i + 1 < out.length &&
+              out[i + 1].words.length < MAX_WORDS_PER_GROUP &&
+              fitsInTwoLines(out[i].words.concat(out[i + 1].words))
+            ) {
               out[i] = makeGroup(out[i].words.concat(out[i + 1].words));
               out.splice(i + 1, 1);
-            } else if (i > 0 && out[i - 1].words.length < MAX_WORDS_PER_GROUP) {
+            } else if (
+              i > 0 &&
+              out[i - 1].words.length < MAX_WORDS_PER_GROUP &&
+              fitsInTwoLines(out[i - 1].words.concat(out[i].words))
+            ) {
               out[i - 1] = makeGroup(out[i - 1].words.concat(out[i].words));
               out.splice(i, 1);
               i--;
@@ -464,13 +488,24 @@
         function buildCaptions(groups) {
           var stage = document.getElementById("caption-stage");
           groups.forEach(function (group, groupIndex) {
-            var groupText = group.words
-              .map(function (w) {
-                return w.text.toLowerCase();
-              })
-              .join(" ");
+            // Fit the WIDEST split line, not the joined group text: the group
+            // renders across up to two lines, so sizing against the joined
+            // string shrank two-line groups that already fit at full size.
+            var widestLineText = "";
+            var widestLineWidth = -1;
+            group.lines.forEach(function (line) {
+              var lineWidth = measureLineWidth(line.words);
+              if (lineWidth > widestLineWidth) {
+                widestLineWidth = lineWidth;
+                widestLineText = line.words
+                  .map(function (w) {
+                    return w.text.toLowerCase();
+                  })
+                  .join(" ");
+              }
+            });
             var computedSize = fitFontSize(
-              groupText,
+              widestLineText,
               CAPTION_FONT_SIZE,
               "700",
               "Montserrat",

From 70213c5a8526b12c8b26f01b8288d78bb9edc917 Mon Sep 17 00:00:00 2001
From: ukimsanov <ular.kimsanov@heygen.com>
Date: Thu, 23 Jul 2026 21:14:49 -0700
Subject: [PATCH 045/125] feat(core): define media treatment capabilities

---
 docs/concepts/variables.mdx                   |   4 +-
 docs/guides/color-grading.mdx                 |   2 +-
 packages/core/src/colorGrading.test.ts        | 458 +++++++++++-
 packages/core/src/colorGrading.ts             | 673 ++++++++++++++----
 packages/core/src/index.ts                    |  12 +
 packages/core/src/runtime/bridge.test.ts      |   2 +-
 packages/parsers/package-subpaths.json        |   6 +
 packages/parsers/package.json                 |  10 +
 .../parsers/src/colorGradingContract.test.ts  |  63 ++
 packages/parsers/src/colorGradingContract.ts  | 331 +++++++++
 packages/parsers/tsup.config.ts               |   1 +
 .../editor/colorGradingScopePatch.test.ts     |   6 +-
 ...pertyPanelFlatColorGradingSection.test.tsx |   4 +-
 .../propertyPanelFlatPrimitives.test.tsx      |  10 +-
 .../editor/useColorGradingController.test.ts  |  56 +-
 skills-manifest.json                          |   2 +-
 .../scripts/lib/lut-preset-provider.mjs       |  49 +-
 .../scripts/lib/lut-preset-provider.test.mjs  |  19 +-
 18 files changed, 1486 insertions(+), 222 deletions(-)
 create mode 100644 packages/parsers/src/colorGradingContract.test.ts
 create mode 100644 packages/parsers/src/colorGradingContract.ts

diff --git a/docs/concepts/variables.mdx b/docs/concepts/variables.mdx
index 790020395f..407fb76099 100644
--- a/docs/concepts/variables.mdx
+++ b/docs/concepts/variables.mdx
@@ -87,8 +87,8 @@ the shader grading, finishing details, blur/pixelate effects, and optional LUT:
 
 ```html compositions/hero.html
 <html data-composition-variables='[
-  {"id":"gradingPreset","type":"enum","label":"Preset","default":"natural-lift",
-   "options":[{"value":"natural-lift","label":"Natural Lift"},{"value":"warm-daylight","label":"Warm Daylight"}]},
+  {"id":"gradingPreset","type":"enum","label":"Preset","default":"clean-studio",
+   "options":[{"value":"clean-studio","label":"Clean Studio"},{"value":"warm-daylight","label":"Warm Daylight"}]},
   {"id":"gradingIntensity","type":"number","label":"Preset strength","default":0.75,"min":0,"max":1,"step":0.05},
   {"id":"gradingExposure","type":"number","label":"Exposure","default":0,"min":-2,"max":2,"step":0.05},
   {"id":"gradingVibrance","type":"number","label":"Vibrance","default":0.08,"min":-1,"max":1,"step":0.01}
diff --git a/docs/guides/color-grading.mdx b/docs/guides/color-grading.mdx
index 5fc41b2d8c..0af9e45a01 100644
--- a/docs/guides/color-grading.mdx
+++ b/docs/guides/color-grading.mdx
@@ -91,7 +91,7 @@ Project-local media is the safest path. Remote media must be served with compati
 
 ```json
 {
-  "preset": "natural-lift",
+  "preset": "clean-studio",
   "intensity": 1,
   "adjust": {
     "exposure": 0,
diff --git a/packages/core/src/colorGrading.test.ts b/packages/core/src/colorGrading.test.ts
index a2103f5127..6085768709 100644
--- a/packages/core/src/colorGrading.test.ts
+++ b/packages/core/src/colorGrading.test.ts
@@ -1,7 +1,13 @@
 import { describe, expect, it } from "vitest";
 import {
   HF_COLOR_GRADING_COLOR_SPACE,
+  HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS,
+  HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS,
+  HF_COLOR_GRADING_EFFECT_PRESETS,
+  HF_COLOR_GRADING_GRADE_PRESETS,
+  HF_COLOR_GRADING_PALETTES,
   HF_COLOR_GRADING_PRESETS,
+  getHfColorGradingCapabilities,
   isHfColorGradingActive,
   normalizeHfColorGrading,
   normalizeHfColorGradingWithVariables,
@@ -9,25 +15,127 @@ import {
 } from "./colorGrading";
 
 describe("color grading", () => {
+  it("derives grade and effect preset views from their actual payloads", () => {
+    expect(HF_COLOR_GRADING_GRADE_PRESETS.map(({ id }) => id)).toContain("bright-pop");
+    expect(HF_COLOR_GRADING_GRADE_PRESETS.map(({ id }) => id)).not.toContain("vhs-playback");
+    expect(HF_COLOR_GRADING_EFFECT_PRESETS.map(({ id }) => id)).toEqual([
+      "creator-camcorder",
+      "vhs-playback",
+      "home-movie-8mm",
+      "editorial-halftone",
+      "two-ink-print",
+    ]);
+    expect(HF_COLOR_GRADING_PRESETS).toHaveLength(18);
+  });
+
   it("parses preset shorthand", () => {
-    const grading = normalizeHfColorGrading("warm-clean");
-    expect(grading?.preset).toBe("warm-clean");
+    const grading = normalizeHfColorGrading("warm-daylight");
+    expect(grading?.preset).toBe("warm-daylight");
     expect(grading?.colorSpace).toBe(HF_COLOR_GRADING_COLOR_SPACE);
     expect(grading?.adjust.temperature).toBeGreaterThan(0);
     expect(isHfColorGradingActive(grading)).toBe(true);
   });
 
   it("includes consumer-friendly filter presets", () => {
-    expect(HF_COLOR_GRADING_PRESETS.some((preset) => preset.id === "fresh-pop")).toBe(true);
+    expect(HF_COLOR_GRADING_PRESETS.some((preset) => preset.id === "bright-pop")).toBe(true);
     expect(normalizeHfColorGrading("mono-clean")?.adjust.saturation).toBe(-1);
     expect(normalizeHfColorGrading("vintage-wash")?.details.vignette).toBeGreaterThan(0);
     expect(normalizeHfColorGrading("food-pop")?.adjust.saturation).toBeGreaterThan(0);
     expect(normalizeHfColorGrading("food-pop")?.adjust.vibrance).toBeGreaterThan(0);
   });
 
+  it("publishes valid named palettes through the existing palette contract", () => {
+    expect(HF_COLOR_GRADING_PALETTES.map(({ id }) => id)).toContain("handheld-green");
+    for (const palette of HF_COLOR_GRADING_PALETTES) {
+      expect(normalizeHfColorGrading({ palette: palette.colors })?.palette).toEqual(palette.colors);
+    }
+  });
+
+  it("resolves calibrated complete-filter presets", () => {
+    expect(normalizeHfColorGrading("creator-camcorder")).toMatchObject({
+      intensity: 0.72,
+      effects: { chromaBleed: 0.55 },
+    });
+    expect(normalizeHfColorGrading("vhs-playback")).toMatchObject({
+      intensity: 1,
+      effects: {
+        tapeDamage: 0.82,
+        tapeTracking: 0.85,
+        scanlineCount: 0.17,
+        digitalGlitchLineTear: 0.08,
+      },
+    });
+    expect(normalizeHfColorGrading("home-movie-8mm")).toMatchObject({
+      intensity: 0.72,
+      details: { grain: 0.34, vignette: 0.28 },
+      effects: { filmArtifacts: 0.62 },
+    });
+    expect(normalizeHfColorGrading("editorial-halftone")?.effects).toMatchObject({
+      halftone: 0.94,
+      halftoneSize: 0.36,
+    });
+    expect(normalizeHfColorGrading("two-ink-print")?.effects).toMatchObject({
+      twoInkPrint: 1,
+      twoInkPrintSize: 0.42,
+    });
+  });
+
+  it("defines a useful normalized apply payload for every active effect", () => {
+    expect(Object.keys(HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS).sort()).toEqual(
+      [...HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS].sort(),
+    );
+    for (const key of HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS) {
+      const grading = normalizeHfColorGrading({
+        effects: HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS[key],
+      });
+      expect(grading?.effects[key], key).toBeGreaterThan(0);
+      expect(isHfColorGradingActive(grading), key).toBe(true);
+    }
+  });
+
+  it("publishes a complete capability catalog for agent-built treatments", () => {
+    const capabilities = getHfColorGradingCapabilities();
+
+    expect(capabilities.colorSpace).toBe("rec709");
+    expect(capabilities.adjustments.map(({ key }) => key)).toEqual([
+      "exposure",
+      "contrast",
+      "highlights",
+      "shadows",
+      "whites",
+      "blacks",
+      "temperature",
+      "tint",
+      "vibrance",
+      "saturation",
+    ]);
+    expect(capabilities.effects.map(({ key }) => key)).toEqual(HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS);
+    expect(capabilities.effects.find(({ key }) => key === "digitalGlitch")?.controls).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ key: "digitalGlitch", recommended: 0.55 }),
+        expect.objectContaining({ key: "digitalGlitchLineTear", min: 0, max: 1 }),
+      ]),
+    );
+    expect(capabilities.presets.map(({ id }) => id)).toEqual([
+      ...HF_COLOR_GRADING_GRADE_PRESETS.map(({ id }) => id),
+      ...HF_COLOR_GRADING_EFFECT_PRESETS.map(({ id }) => id),
+    ]);
+    expect(capabilities.palettes.map(({ id }) => id)).toContain("handheld-green");
+    expect(capabilities.animatable.map(({ path }) => path)).toContain("effects.kuwahara");
+    expect(capabilities.palette).toEqual({ minColors: 2, maxColors: 6, colorFormat: "#rrggbb" });
+    expect(capabilities.lut).toMatchObject({ format: "3d-cube", maxCubeSize: 64 });
+    expect(capabilities.effects.find(({ key }) => key === "ascii")).toMatchObject({
+      supportsPalette: true,
+      renderLane: "single-pass",
+    });
+    expect(capabilities.effects.find(({ key }) => key === "kuwahara")?.renderLane).toBe(
+      "multipass",
+    );
+  });
+
   it("merges manual adjustments over preset values", () => {
     const grading = normalizeHfColorGrading({
-      preset: "warm-clean",
+      preset: "warm-daylight",
       intensity: 0.5,
       adjust: { temperature: -0.25, contrast: 0.2 },
     });
@@ -50,7 +158,23 @@ describe("color grading", () => {
         grainSize: 2,
         grainRoughness: -1,
       },
-      effects: { blur: 2, pixelate: 3 },
+      effects: {
+        blur: 2,
+        pixelate: 3,
+        chromaBleed: 4,
+        tapeDamage: 5,
+        filmArtifacts: 6,
+        halftone: 7,
+        halftoneSize: 8,
+        twoInkPrint: 9,
+        twoInkPrintSize: 10,
+        ascii: 11,
+        asciiSize: 12,
+        asciiInvert: 13,
+        dither: 14,
+        ditherSize: 15,
+      },
+      palette: ["#FF6B66", "#080717", "#D9339F", "#3C185F"],
       lut: { src: "looks/test.cube", intensity: 3 },
     });
     expect(grading?.intensity).toBe(1);
@@ -65,35 +189,292 @@ describe("color grading", () => {
     expect(grading?.details.grain).toBe(0);
     expect(grading?.details.grainSize).toBe(1);
     expect(grading?.details.grainRoughness).toBe(0);
-    expect(grading?.effects.blur).toBe(1);
-    expect(grading?.effects.pixelate).toBe(1);
+    expect(grading?.effects).toMatchObject({
+      blur: 1,
+      pixelate: 1,
+      chromaBleed: 1,
+      tapeDamage: 1,
+      filmArtifacts: 1,
+      halftone: 1,
+      halftoneSize: 1,
+      twoInkPrint: 1,
+      twoInkPrintSize: 1,
+      ascii: 1,
+      asciiSize: 1,
+      asciiInvert: 1,
+      dither: 1,
+      ditherSize: 1,
+    });
+    expect(grading?.palette).toEqual(["#ff6b66", "#080717", "#d9339f", "#3c185f"]);
     expect(grading?.lut?.intensity).toBe(1);
   });
 
   it("returns null for disabled or invalid grading", () => {
-    expect(normalizeHfColorGrading({ enabled: false, preset: "warm-clean" })).toBeNull();
+    expect(normalizeHfColorGrading({ enabled: false, preset: "warm-daylight" })).toBeNull();
     expect(normalizeHfColorGrading("{nope")).toBeNull();
     expect(normalizeHfColorGrading("")).toBeNull();
   });
 
+  it("normalizes shared creative effect controls without activating subordinate options", () => {
+    const grading = normalizeHfColorGrading({
+      effects: {
+        asciiStyle: 9,
+        asciiColor: 2,
+        asciiRotation: 2,
+        monoScreen: 0.25,
+        monoScreenSize: 0.35,
+        monoScreenAngle: 0.45,
+        monoScreenSpread: 0.55,
+        monoScreenShape: 8,
+        monoScreenInvert: 2,
+        scanlines: 0.3,
+        scanlineCount: 0.4,
+        scanlineSoftness: 0.5,
+        chromaticAberration: 0.6,
+        chromaticAngle: 0.7,
+        crtCurvature: 0.8,
+        digitalGlitch: 0.7,
+        digitalGlitchColorSplit: 0.75,
+        digitalGlitchLineTear: 0.8,
+        digitalGlitchPixelate: 0.85,
+        digitalGlitchBlockAmount: 0.9,
+        digitalGlitchBlockDisplacement: 1.2,
+        digitalGlitchBlockOpacity: 1.3,
+        digitalGlitchSpeed: 0.9,
+      },
+    });
+
+    expect(grading?.effects).toMatchObject({
+      asciiStyle: 7,
+      asciiColor: 1,
+      asciiRotation: 1,
+      monoScreen: 0.25,
+      monoScreenSize: 0.35,
+      monoScreenAngle: 0.45,
+      monoScreenSpread: 0.55,
+      monoScreenShape: 4,
+      monoScreenInvert: 1,
+      scanlines: 0.3,
+      scanlineCount: 0.4,
+      scanlineSoftness: 0.5,
+      chromaticAberration: 0.6,
+      chromaticAngle: 0.7,
+      crtCurvature: 0.8,
+      digitalGlitch: 0.7,
+      digitalGlitchColorSplit: 0.75,
+      digitalGlitchLineTear: 0.8,
+      digitalGlitchPixelate: 0.85,
+      digitalGlitchBlockAmount: 0.9,
+      digitalGlitchBlockDisplacement: 1,
+      digitalGlitchBlockOpacity: 1,
+      digitalGlitchSpeed: 0.9,
+    });
+
+    const optionsOnly = normalizeHfColorGrading({
+      effects: {
+        asciiStyle: 4,
+        asciiColor: 1,
+        asciiRotation: 1,
+        monoScreenSize: 0.5,
+        monoScreenAngle: 0.5,
+        monoScreenSpread: 0.5,
+        monoScreenShape: 3,
+        monoScreenInvert: 1,
+        scanlineCount: 0.5,
+        scanlineSoftness: 0.5,
+        chromaticAngle: 0.5,
+        digitalGlitchColorSplit: 0.5,
+        digitalGlitchLineTear: 0.5,
+        digitalGlitchPixelate: 0.5,
+        digitalGlitchBlockAmount: 0.5,
+        digitalGlitchBlockDisplacement: 0.5,
+        digitalGlitchBlockOpacity: 0.5,
+        digitalGlitchSpeed: 0.5,
+      },
+    });
+    expect(isHfColorGradingActive(optionsOnly)).toBe(false);
+  });
+
+  it("uses the public ASCII defaults when only the family is enabled", () => {
+    const grading = normalizeHfColorGrading({ effects: { ascii: 1 } });
+
+    expect(grading?.effects).toMatchObject({
+      ascii: 1,
+      asciiSize: 5 / 76,
+      asciiInvert: 0,
+      asciiStyle: 0,
+      asciiColor: 1,
+      asciiRotation: 0,
+    });
+  });
+
+  it("normalizes tape controls without activating them independently", () => {
+    const defaults = normalizeHfColorGrading({ effects: { tapeDamage: 1 } });
+    expect(defaults?.effects).toMatchObject({
+      tapeDamage: 1,
+      tapeTracking: 0,
+      tapeNoise: 1,
+      tapeSpeed: 0.5,
+    });
+    expect(isHfColorGradingActive(defaults)).toBe(true);
+
+    const controlsOnly = normalizeHfColorGrading({
+      effects: { tapeTracking: 2, tapeNoise: -1, tapeSpeed: 2 },
+    });
+    expect(controlsOnly?.effects).toMatchObject({
+      tapeTracking: 1,
+      tapeNoise: 0,
+      tapeSpeed: 1,
+    });
+    expect(isHfColorGradingActive(controlsOnly)).toBe(false);
+  });
+
+  it("normalizes engraving controls and activates only from its master amount", () => {
+    const defaults = normalizeHfColorGrading({ effects: { engraving: 1 } });
+    expect(defaults?.effects).toMatchObject({
+      engraving: 1,
+      engravingSpacing: 7 / 17,
+      engravingMinThickness: 0.2,
+      engravingMaxThickness: 3.2 / 7,
+      engravingAngle: 0.25,
+      engravingContrast: 7 / 15,
+      engravingSharpness: 0.59,
+      engravingWave: 0.2,
+      engravingWaveFrequency: 2 / 9,
+    });
+    expect(isHfColorGradingActive(defaults)).toBe(true);
+
+    const controlsOnly = normalizeHfColorGrading({
+      effects: {
+        engravingSpacing: 0.8,
+        engravingMinThickness: 0,
+        engravingMaxThickness: 0,
+        engravingAngle: 0,
+        engravingContrast: 0,
+        engravingSharpness: 0,
+        engravingWave: 0,
+        engravingWaveFrequency: 0,
+      },
+    });
+    expect(isHfColorGradingActive(controlsOnly)).toBe(false);
+    expect(controlsOnly?.effects.engravingSpacing).toBe(0.8);
+    expect(controlsOnly?.effects.engravingMinThickness).toBe(0);
+  });
+
+  it("normalizes crosshatch controls and activates only from its master amount", () => {
+    const defaults = normalizeHfColorGrading({ effects: { crosshatch: 1 } });
+    expect(defaults?.effects).toMatchObject({
+      crosshatch: 1,
+      crosshatchSpacing: 7 / 25,
+      crosshatchThickness: 0.25,
+      crosshatchAngle: 0.25,
+      crosshatchContrast: 1 / 3,
+      crosshatchEdges: 0.5,
+      crosshatchLineWeight: 0,
+      crosshatchWave: 0.33,
+      crosshatchWaveFrequency: 2 / 9,
+    });
+    expect(isHfColorGradingActive(defaults)).toBe(true);
+
+    const controlsOnly = normalizeHfColorGrading({
+      effects: {
+        crosshatchSpacing: 0.8,
+        crosshatchThickness: 0,
+        crosshatchAngle: 0,
+        crosshatchContrast: 0,
+        crosshatchEdges: 0,
+        crosshatchLineWeight: 0,
+        crosshatchWave: 0,
+        crosshatchWaveFrequency: 0,
+      },
+    });
+    expect(isHfColorGradingActive(controlsOnly)).toBe(false);
+    expect(controlsOnly?.effects.crosshatchSpacing).toBe(0.8);
+    expect(controlsOnly?.effects.crosshatchThickness).toBe(0);
+  });
+
+  it("normalizes Kuwahara controls and activates only from its master amount", () => {
+    const defaults = normalizeHfColorGrading({ effects: { kuwahara: 1 } });
+    expect(defaults?.effects).toMatchObject({
+      kuwahara: 1,
+      kuwaharaRadius: 1 / 7,
+      kuwaharaSharpness: 5 / 16,
+      kuwaharaSaturation: 0.5,
+    });
+    expect(isHfColorGradingActive(defaults)).toBe(true);
+
+    const controlsOnly = normalizeHfColorGrading({
+      effects: {
+        kuwaharaRadius: 2,
+        kuwaharaSharpness: -1,
+        kuwaharaSaturation: 0.75,
+      },
+    });
+    expect(controlsOnly?.effects).toMatchObject({
+      kuwaharaRadius: 1,
+      kuwaharaSharpness: 0,
+      kuwaharaSaturation: 0.75,
+    });
+    expect(isHfColorGradingActive(controlsOnly)).toBe(false);
+  });
+
+  it("normalizes article bloom controls and activates only from intensity", () => {
+    const grading = normalizeHfColorGrading({ effects: { bloom: 0.5 } });
+    expect(grading?.effects).toMatchObject({ bloom: 0.5, bloomRadius: 8 });
+    expect(isHfColorGradingActive(grading)).toBe(true);
+
+    const controlsOnly = normalizeHfColorGrading({ effects: { bloomRadius: 101 } });
+    expect(controlsOnly?.effects.bloomRadius).toBe(100);
+    expect(isHfColorGradingActive(controlsOnly)).toBe(false);
+    expect(normalizeHfColorGrading({ effects: { bloom: 4 } })?.effects.bloom).toBe(3);
+  });
+
   it("serializes normalized grading for data-color-grading", () => {
     const grading = normalizeHfColorGrading({
       adjust: { exposure: 0.25 },
       details: { vignette: 0.3, grain: 0.1 },
-      effects: { blur: 0.2, pixelate: 0.4 },
+      effects: {
+        blur: 0.2,
+        pixelate: 0.4,
+        chromaBleed: 0.3,
+        tapeDamage: 0.5,
+        filmArtifacts: 0.6,
+        halftone: 0.7,
+        halftoneSize: 0.8,
+        twoInkPrint: 0.9,
+        twoInkPrintSize: 0.4,
+        ascii: 0.65,
+        asciiSize: 0.35,
+        asciiInvert: 1,
+        dither: 0.75,
+        ditherSize: 0.25,
+      },
+      palette: ["#080717", "#3c185f", "#d9339f", "#ff6b66", "#f6d365", "#aafae0"],
       lut: { src: "assets/luts/test.cube", intensity: 0.6 },
     });
     const serialized = serializeHfColorGrading(grading);
-    expect(serialized).toContain('"exposure":0.25');
-    expect(serialized).toContain('"vignette":0.3');
-    expect(serialized).toContain('"grain":0.1');
-    expect(serialized).toContain('"blur":0.2');
-    expect(serialized).toContain('"pixelate":0.4');
-    expect(serialized).toContain('"src":"assets/luts/test.cube"');
-    expect(normalizeHfColorGrading(serialized)?.adjust.exposure).toBe(0.25);
-    expect(normalizeHfColorGrading(serialized)?.details.vignette).toBe(0.3);
-    expect(normalizeHfColorGrading(serialized)?.effects.blur).toBe(0.2);
-    expect(normalizeHfColorGrading(serialized)?.lut?.intensity).toBe(0.6);
+    expect(normalizeHfColorGrading(serialized)).toMatchObject({
+      adjust: { exposure: 0.25 },
+      details: { vignette: 0.3, grain: 0.1 },
+      effects: {
+        blur: 0.2,
+        pixelate: 0.4,
+        chromaBleed: 0.3,
+        tapeDamage: 0.5,
+        filmArtifacts: 0.6,
+        halftone: 0.7,
+        halftoneSize: 0.8,
+        twoInkPrint: 0.9,
+        twoInkPrintSize: 0.4,
+        ascii: 0.65,
+        asciiSize: 0.35,
+        asciiInvert: 1,
+        dither: 0.75,
+        ditherSize: 0.25,
+      },
+      palette: ["#080717", "#3c185f", "#d9339f", "#ff6b66", "#f6d365", "#aafae0"],
+      lut: { src: "assets/luts/test.cube", intensity: 0.6 },
+    });
   });
 
   it("treats zero global intensity as inactive even with LUT data", () => {
@@ -106,7 +487,7 @@ describe("color grading", () => {
   });
 
   it("treats finishing details as active grading", () => {
-    const grading = normalizeHfColorGrading({ details: { vignette: 0.2 } });
+    const grading = normalizeHfColorGrading({ intensity: 0, details: { vignette: 0.2 } });
     expect(isHfColorGradingActive(grading)).toBe(true);
   });
 
@@ -117,8 +498,36 @@ describe("color grading", () => {
     expect(isHfColorGradingActive(grading)).toBe(false);
   });
 
+  it("does not activate grading for halftone size alone", () => {
+    const grading = normalizeHfColorGrading({ effects: { halftoneSize: 0.8 } });
+    expect(isHfColorGradingActive(grading)).toBe(false);
+  });
+
+  it("does not activate grading for two-ink screen size alone", () => {
+    const grading = normalizeHfColorGrading({ effects: { twoInkPrintSize: 0.8 } });
+    expect(isHfColorGradingActive(grading)).toBe(false);
+  });
+
+  it("does not activate grading for ASCII/dither options without an effect amount", () => {
+    const grading = normalizeHfColorGrading({
+      effects: { asciiSize: 0.8, asciiInvert: 1, ditherSize: 0.7 },
+      palette: ["#111111", "#eeeeee"],
+    });
+    expect(isHfColorGradingActive(grading)).toBe(false);
+  });
+
+  it("rejects malformed or out-of-range effect palettes", () => {
+    expect(normalizeHfColorGrading({ palette: ["#000000"] })?.palette).toBeNull();
+    expect(normalizeHfColorGrading({ palette: ["#000000", "red"] })?.palette).toBeNull();
+    expect(
+      normalizeHfColorGrading({
+        palette: ["#000000", "#111111", "#222222", "#333333", "#444444", "#555555", "#666666"],
+      })?.palette,
+    ).toBeNull();
+  });
+
   it("treats media effects as active grading", () => {
-    const grading = normalizeHfColorGrading({ effects: { blur: 0.2 } });
+    const grading = normalizeHfColorGrading({ intensity: 0, effects: { blur: 0.2 } });
     expect(isHfColorGradingActive(grading)).toBe(true);
   });
 
@@ -137,13 +546,14 @@ describe("color grading", () => {
           grainSize: "$grainSize",
         },
         effects: { pixelate: "$pixelate" },
+        palette: "$palette",
         lut: {
           src: "$lutSrc",
           intensity: "$lutIntensity",
         },
       }),
       {
-        preset: "warm-clean",
+        preset: "warm-daylight",
         gradingIntensity: 0.6,
         exposure: 0.25,
         vibrance: 0.3,
@@ -151,12 +561,13 @@ describe("color grading", () => {
         vignette: 0.15,
         grainSize: 0.4,
         pixelate: 0.1,
+        palette: ["#080717", "#aafae0"],
         lutSrc: "assets/luts/warm.cube",
         lutIntensity: 0.4,
       },
     );
 
-    expect(grading?.preset).toBe("warm-clean");
+    expect(grading?.preset).toBe("warm-daylight");
     expect(grading?.intensity).toBe(0.6);
     expect(grading?.adjust.exposure).toBe(0.25);
     expect(grading?.adjust.vibrance).toBe(0.3);
@@ -164,6 +575,7 @@ describe("color grading", () => {
     expect(grading?.details.vignette).toBe(0.15);
     expect(grading?.details.grainSize).toBe(0.4);
     expect(grading?.effects.pixelate).toBe(0.1);
+    expect(grading?.palette).toEqual(["#080717", "#aafae0"]);
     expect(grading?.lut).toEqual({ src: "assets/luts/warm.cube", intensity: 0.4 });
   });
 
diff --git a/packages/core/src/colorGrading.ts b/packages/core/src/colorGrading.ts
index d5411e20a3..6798359fdf 100644
--- a/packages/core/src/colorGrading.ts
+++ b/packages/core/src/colorGrading.ts
@@ -1,3 +1,13 @@
+import { DEFAULT_MAX_CUBE_LUT_SIZE } from "./colorLuts";
+import {
+  COLOR_GRADING_ADJUST_KEYS,
+  COLOR_GRADING_COLOR_SPACE,
+  COLOR_GRADING_DETAIL_KEYS,
+  COLOR_GRADING_EFFECT_KEYS,
+  COLOR_GRADING_LUT_KEYS,
+  COLOR_GRADING_TOP_LEVEL_KEYS,
+} from "@hyperframes/parsers/color-grading-contract";
+
 export const HF_COLOR_GRADING_ATTR = "data-color-grading";
 
 // Runtime <-> studio contract attributes. The runtime grading engine writes
@@ -14,12 +24,10 @@ export const COLOR_GRADING_AUTHORED_OPACITY_ATTR = "data-hf-authored-opacity";
 
 export const HF_COLOR_GRADING_CANVAS_ID_PREFIX = "__hf_color_grading_";
 
-export const HF_COLOR_GRADING_COLOR_SPACE = "rec709";
+export const HF_COLOR_GRADING_COLOR_SPACE = COLOR_GRADING_COLOR_SPACE;
 
 export type HfColorGradingPresetId =
   | "neutral"
-  | "natural-lift"
-  | "fresh-pop"
   | "warm-daylight"
   | "clean-studio"
   | "skin-soft"
@@ -29,38 +37,115 @@ export type HfColorGradingPresetId =
   | "vintage-wash"
   | "mono-clean"
   | "mono-fade"
-  | "warm-clean"
-  | "cool-clean"
   | "soft-boost"
   | "bright-pop"
-  | "deep-contrast";
-
-export type HfColorGradingAdjustKey =
-  | "exposure"
-  | "contrast"
-  | "highlights"
-  | "shadows"
-  | "whites"
-  | "blacks"
-  | "temperature"
-  | "tint"
-  | "vibrance"
-  | "saturation";
+  | "deep-contrast"
+  | "creator-camcorder"
+  | "vhs-playback"
+  | "home-movie-8mm"
+  | "editorial-halftone"
+  | "two-ink-print";
+
+export type HfColorGradingAdjustKey = (typeof COLOR_GRADING_ADJUST_KEYS)[number];
+
+const ADJUST_ZERO = {
+  exposure: 0,
+  contrast: 0,
+  highlights: 0,
+  shadows: 0,
+  whites: 0,
+  blacks: 0,
+  temperature: 0,
+  tint: 0,
+  vibrance: 0,
+  saturation: 0,
+} satisfies Record<HfColorGradingAdjustKey, number>;
 
 export type HfColorGradingAdjust = Partial<Record<HfColorGradingAdjustKey, number>>;
 
-export type HfColorGradingDetailKey =
-  | "vignette"
-  | "vignetteMidpoint"
-  | "vignetteRoundness"
-  | "vignetteFeather"
-  | "grain"
-  | "grainSize"
-  | "grainRoughness";
+// Sub-controls use useful identity defaults rather than raw mathematical zeroes.
+export type HfColorGradingDetailKey = (typeof COLOR_GRADING_DETAIL_KEYS)[number];
+
+const DETAIL_DEFAULTS = {
+  vignette: 0,
+  vignetteMidpoint: 0.5,
+  vignetteRoundness: 0,
+  vignetteFeather: 0.65,
+  grain: 0,
+  grainSize: 0.25,
+  grainRoughness: 0.5,
+} satisfies Record<HfColorGradingDetailKey, number>;
 
 export type HfColorGradingDetails = Partial<Record<HfColorGradingDetailKey, number>>;
 
-export type HfColorGradingEffectKey = "blur" | "pixelate";
+export type HfColorGradingEffectKey = (typeof COLOR_GRADING_EFFECT_KEYS)[number];
+
+const EFFECT_DEFAULTS = {
+  blur: 0,
+  pixelate: 0,
+  chromaBleed: 0,
+  tapeDamage: 0,
+  tapeTracking: 0,
+  tapeNoise: 1,
+  tapeSpeed: 0.5,
+  filmArtifacts: 0,
+  halftone: 0,
+  halftoneSize: 0,
+  twoInkPrint: 0,
+  twoInkPrintSize: 0,
+  ascii: 0,
+  asciiSize: 5 / 76,
+  asciiInvert: 0,
+  asciiStyle: 0,
+  asciiColor: 1,
+  asciiRotation: 0,
+  dither: 0,
+  ditherSize: 0,
+  bloom: 0,
+  bloomRadius: 8,
+  monoScreen: 0,
+  monoScreenSize: 0,
+  monoScreenAngle: 0,
+  monoScreenSpread: 0,
+  monoScreenShape: 0,
+  monoScreenInvert: 0,
+  scanlines: 0,
+  scanlineCount: 0,
+  scanlineSoftness: 0,
+  chromaticAberration: 0,
+  chromaticAngle: 0,
+  crtCurvature: 0,
+  digitalGlitch: 0,
+  digitalGlitchColorSplit: 0,
+  digitalGlitchLineTear: 0,
+  digitalGlitchPixelate: 0,
+  digitalGlitchBlockAmount: 0,
+  digitalGlitchBlockDisplacement: 0,
+  digitalGlitchBlockOpacity: 0,
+  digitalGlitchSpeed: 0,
+  engraving: 0,
+  engravingSpacing: 7 / 17,
+  engravingMinThickness: 0.2,
+  engravingMaxThickness: 3.2 / 7,
+  engravingAngle: 0.25,
+  engravingContrast: 7 / 15,
+  engravingSharpness: 0.59,
+  engravingWave: 0.2,
+  engravingWaveFrequency: 2 / 9,
+  crosshatch: 0,
+  crosshatchSpacing: 7 / 25,
+  crosshatchThickness: 0.25,
+  crosshatchAngle: 0.25,
+  crosshatchContrast: 1 / 3,
+  crosshatchEdges: 0.5,
+  crosshatchLineWeight: 0,
+  crosshatchWave: 0.33,
+  crosshatchWaveFrequency: 2 / 9,
+  kuwahara: 0,
+  kuwaharaRadius: 1 / 7,
+  kuwaharaSharpness: 5 / 16,
+  kuwaharaSaturation: 0.5,
+} satisfies Record<HfColorGradingEffectKey, number>;
 
 export type HfColorGradingEffects = Partial<Record<HfColorGradingEffectKey, number>>;
 
@@ -76,10 +161,17 @@ export interface HfColorGrading {
   adjust?: HfColorGradingAdjust;
   details?: HfColorGradingDetails;
   effects?: HfColorGradingEffects;
+  palette?: readonly string[] | null;
   lut?: HfColorGradingLutRef | string | null;
   colorSpace?: typeof HF_COLOR_GRADING_COLOR_SPACE | string;
 }
 
+export const HF_COLOR_GRADING_TOP_LEVEL_KEYS =
+  COLOR_GRADING_TOP_LEVEL_KEYS satisfies readonly (keyof HfColorGrading)[];
+
+export const HF_COLOR_GRADING_LUT_KEYS =
+  COLOR_GRADING_LUT_KEYS satisfies readonly (keyof HfColorGradingLutRef)[];
+
 export interface NormalizedHfColorGrading {
   enabled: boolean;
   preset: HfColorGradingPresetId | string | null;
@@ -87,6 +179,7 @@ export interface NormalizedHfColorGrading {
   adjust: Record<HfColorGradingAdjustKey, number>;
   details: Record<HfColorGradingDetailKey, number>;
   effects: Record<HfColorGradingEffectKey, number>;
+  palette: readonly string[] | null;
   lut: HfColorGradingLutRef | null;
   colorSpace: typeof HF_COLOR_GRADING_COLOR_SPACE | string;
 }
@@ -101,88 +194,145 @@ export interface HfColorGradingTarget {
 export interface HfColorGradingPreset {
   id: HfColorGradingPresetId;
   label: string;
+  intensity: number;
   adjust: Record<HfColorGradingAdjustKey, number>;
   details: Record<HfColorGradingDetailKey, number>;
   effects: Record<HfColorGradingEffectKey, number>;
 }
 
-export type HfColorGradingVariableMap = Record<string, unknown>;
-
-const ADJUST_ZERO: Record<HfColorGradingAdjustKey, number> = {
-  exposure: 0,
-  contrast: 0,
-  highlights: 0,
-  shadows: 0,
-  whites: 0,
-  blacks: 0,
-  temperature: 0,
-  tint: 0,
-  vibrance: 0,
-  saturation: 0,
-};
+export const HF_COLOR_GRADING_PALETTES = [
+  { id: "noir", label: "Noir", group: "Classic", colors: ["#000000", "#ffffff"] },
+  {
+    id: "ink-paper",
+    label: "Ink & Paper",
+    group: "Classic",
+    colors: ["#1a1a2e", "#f5f5dc"],
+  },
+  {
+    id: "terminal",
+    label: "Terminal",
+    group: "Classic",
+    colors: ["#001100", "#00ff00"],
+  },
+  {
+    id: "amber-glow",
+    label: "Amber Glow",
+    group: "Classic",
+    colors: ["#1a0f00", "#ffcc00"],
+  },
+  {
+    id: "handheld-green",
+    label: "Handheld Green",
+    group: "Classic",
+    colors: ["#0f380f", "#306230", "#8bac0f", "#9bbc0f"],
+  },
+  {
+    id: "golden-hour",
+    label: "Golden Hour",
+    group: "Mood",
+    colors: ["#1a1205", "#4a3510", "#8b6914", "#d4a017", "#fff8dc"],
+  },
+  {
+    id: "deep-sea",
+    label: "Deep Sea",
+    group: "Mood",
+    colors: ["#0a1628", "#1a3a5c", "#2d6187", "#5ba4c9", "#a8dce8"],
+  },
+  {
+    id: "arctic-night",
+    label: "Arctic Night",
+    group: "Mood",
+    colors: ["#0a0a14", "#1a2a4a", "#3a5a8a", "#6a9aca", "#cae8ff"],
+  },
+  {
+    id: "synthwave",
+    label: "Synthwave",
+    group: "Mood",
+    colors: ["#120458", "#7b2cbf", "#e040fb", "#ff6ec7", "#fff59d"],
+  },
+  {
+    id: "vaporwave",
+    label: "Vaporwave",
+    group: "Mood",
+    colors: ["#1a0a2e", "#3d1a5c", "#ff71ce", "#01cdfe", "#fffb96"],
+  },
+  {
+    id: "forest",
+    label: "Forest",
+    group: "Mood",
+    colors: ["#1a2e1a", "#2d4a2d", "#4a7c4a", "#7ab37a", "#c8e6c8"],
+  },
+  {
+    id: "sepia",
+    label: "Sepia",
+    group: "Mono",
+    colors: ["#1a1610", "#3d3020", "#6b5a40", "#a89070", "#e8dcc8"],
+  },
+  {
+    id: "blueprint",
+    label: "Blueprint",
+    group: "Mono",
+    colors: ["#001830", "#003060", "#0050a0", "#0080e0", "#e0f0ff"],
+  },
+  {
+    id: "warm-print",
+    label: "Warm Print",
+    group: "HyperFrames",
+    colors: ["#17121a", "#824c50", "#e09873", "#f7ddb1"],
+  },
+  {
+    id: "electric-ink",
+    label: "Electric Ink",
+    group: "HyperFrames",
+    colors: ["#080717", "#3c185f", "#7e2278", "#d9339f", "#ff6b66", "#aafae0"],
+  },
+] as const;
 
-// Detail sub-controls keep identity-state defaults so enabling vignette/grain starts from useful
-// perceptual settings instead of raw mathematical zeroes.
-const DETAIL_ZERO: Record<HfColorGradingDetailKey, number> = {
-  vignette: 0,
-  vignetteMidpoint: 0.5,
-  vignetteRoundness: 0,
-  vignetteFeather: 0.65,
-  grain: 0,
-  grainSize: 0.25,
-  grainRoughness: 0.5,
-};
+export type HfColorGradingVariableMap = Record<string, unknown>;
 
-const EFFECT_ZERO: Record<HfColorGradingEffectKey, number> = {
-  blur: 0,
-  pixelate: 0,
+export const HF_COLOR_GRADING_ADJUST_KEYS =
+  COLOR_GRADING_ADJUST_KEYS satisfies readonly HfColorGradingAdjustKey[];
+
+export const HF_COLOR_GRADING_DETAIL_KEYS =
+  COLOR_GRADING_DETAIL_KEYS satisfies readonly HfColorGradingDetailKey[];
+
+export const HF_COLOR_GRADING_EFFECT_KEYS =
+  COLOR_GRADING_EFFECT_KEYS satisfies readonly HfColorGradingEffectKey[];
+
+const VINTAGE_WASH_ADJUST: HfColorGradingAdjust = {
+  exposure: 0.03,
+  contrast: -0.12,
+  highlights: -0.1,
+  shadows: 0.16,
+  whites: -0.04,
+  blacks: 0.08,
+  temperature: 0.13,
+  vibrance: -0.08,
+  saturation: -0.08,
 };
 
-export const HF_COLOR_GRADING_ADJUST_KEYS = Object.keys(
-  ADJUST_ZERO,
-) as readonly HfColorGradingAdjustKey[];
-
-export const HF_COLOR_GRADING_DETAIL_KEYS = Object.keys(
-  DETAIL_ZERO,
-) as readonly HfColorGradingDetailKey[];
-
-export const HF_COLOR_GRADING_EFFECT_KEYS = Object.keys(
-  EFFECT_ZERO,
-) as readonly HfColorGradingEffectKey[];
+const VINTAGE_WASH_DETAILS: HfColorGradingDetails = { vignette: 0.18 };
 
 function preset(
   id: HfColorGradingPresetId,
   label: string,
   adjust: HfColorGradingAdjust = {},
   details: HfColorGradingDetails = {},
+  effects: HfColorGradingEffects = {},
+  intensity = 1,
 ): HfColorGradingPreset {
   return {
     id,
     label,
+    intensity,
     adjust: { ...ADJUST_ZERO, ...adjust },
-    details: { ...DETAIL_ZERO, ...details },
-    effects: { ...EFFECT_ZERO },
+    details: { ...DETAIL_DEFAULTS, ...details },
+    effects: { ...EFFECT_DEFAULTS, ...effects },
   };
 }
 
 export const HF_COLOR_GRADING_PRESETS: readonly HfColorGradingPreset[] = [
   preset("neutral", "Neutral"),
-  preset("natural-lift", "Natural Lift", {
-    exposure: 0.04,
-    contrast: 0.06,
-    highlights: -0.06,
-    shadows: 0.08,
-    saturation: 0.05,
-  }),
-  preset("fresh-pop", "Fresh Pop", {
-    exposure: 0.08,
-    contrast: 0.12,
-    whites: 0.06,
-    shadows: 0.04,
-    temperature: -0.02,
-    vibrance: 0.08,
-    saturation: 0.16,
-  }),
   preset("warm-daylight", "Warm Daylight", {
     exposure: 0.06,
     contrast: 0.07,
@@ -247,24 +397,7 @@ export const HF_COLOR_GRADING_PRESETS: readonly HfColorGradingPreset[] = [
       vignette: 0.1,
     },
   ),
-  preset(
-    "vintage-wash",
-    "Vintage Wash",
-    {
-      exposure: 0.03,
-      contrast: -0.12,
-      highlights: -0.1,
-      shadows: 0.16,
-      whites: -0.04,
-      blacks: 0.08,
-      temperature: 0.13,
-      vibrance: -0.08,
-      saturation: -0.08,
-    },
-    {
-      vignette: 0.18,
-    },
-  ),
+  preset("vintage-wash", "Vintage Wash", VINTAGE_WASH_ADJUST, VINTAGE_WASH_DETAILS),
   preset("mono-clean", "Mono Clean", {
     contrast: 0.12,
     highlights: -0.04,
@@ -286,23 +419,6 @@ export const HF_COLOR_GRADING_PRESETS: readonly HfColorGradingPreset[] = [
       vignette: 0.08,
     },
   ),
-  preset("warm-clean", "Warm Clean", {
-    exposure: 0.05,
-    contrast: 0.08,
-    highlights: -0.08,
-    shadows: 0.08,
-    temperature: 0.16,
-    vibrance: 0.04,
-    saturation: 0.06,
-  }),
-  preset("cool-clean", "Cool Clean", {
-    contrast: 0.06,
-    highlights: -0.06,
-    shadows: 0.06,
-    temperature: -0.12,
-    tint: 0.04,
-    saturation: 0.04,
-  }),
   preset("soft-boost", "Soft Boost", {
     exposure: 0.06,
     contrast: -0.04,
@@ -327,6 +443,74 @@ export const HF_COLOR_GRADING_PRESETS: readonly HfColorGradingPreset[] = [
     blacks: -0.12,
     saturation: 0.06,
   }),
+  preset(
+    "creator-camcorder",
+    "Creator Camcorder",
+    {
+      contrast: 0.08,
+      highlights: -0.05,
+      shadows: 0.02,
+      whites: 0.03,
+      blacks: -0.04,
+      temperature: -0.03,
+      tint: -0.015,
+      vibrance: -0.03,
+      saturation: -0.06,
+    },
+    { vignette: 0.06, grain: 0.08, grainSize: 0.18, grainRoughness: 0.58 },
+    { chromaBleed: 0.55 },
+    0.72,
+  ),
+  preset(
+    "vhs-playback",
+    "VHS Playback",
+    { contrast: -0.04, saturation: -0.08 },
+    { grain: 0.16, grainSize: 0.12, grainRoughness: 0.72 },
+    {
+      tapeDamage: 0.82,
+      tapeTracking: 0.85,
+      tapeNoise: 0.3,
+      tapeSpeed: 0.5,
+      chromaBleed: 0.5,
+      chromaticAberration: 0.18,
+      scanlines: 0.35,
+      scanlineCount: 0.17,
+      scanlineSoftness: 1,
+      digitalGlitch: 0.32,
+      digitalGlitchLineTear: 0.08,
+      digitalGlitchSpeed: 0.5,
+    },
+  ),
+  preset(
+    "home-movie-8mm",
+    "8mm Home Movie",
+    VINTAGE_WASH_ADJUST,
+    {
+      ...VINTAGE_WASH_DETAILS,
+      vignette: 0.28,
+      vignetteMidpoint: 0.54,
+      vignetteFeather: 0.72,
+      grain: 0.34,
+      grainSize: 0.18,
+      grainRoughness: 0.72,
+    },
+    { filmArtifacts: 0.62 },
+    0.72,
+  ),
+  preset(
+    "editorial-halftone",
+    "Editorial Halftone",
+    { contrast: 0.04, saturation: 0.04 },
+    {},
+    { halftone: 0.94, halftoneSize: 0.36 },
+  ),
+  preset(
+    "two-ink-print",
+    "Two-Ink Print",
+    { contrast: 0.08, highlights: -0.06, shadows: 0.04 },
+    {},
+    { twoInkPrint: 1, twoInkPrintSize: 0.42 },
+  ),
 ];
 
 const PRESETS_BY_ID = new Map<string, HfColorGradingPreset>(
@@ -358,11 +542,222 @@ const DETAIL_LIMITS: Record<HfColorGradingDetailKey, { min: number; max: number
   grainRoughness: { min: 0, max: 1 },
 };
 
-const EFFECT_LIMITS: Record<HfColorGradingEffectKey, { min: number; max: number }> = {
-  blur: { min: 0, max: 1 },
-  pixelate: { min: 0, max: 1 },
+const UNIT_LIMIT = { min: 0, max: 1 };
+const EFFECT_LIMIT_OVERRIDES: Partial<
+  Record<HfColorGradingEffectKey, { min: number; max: number }>
+> = {
+  asciiStyle: { min: 0, max: 7 },
+  bloom: { min: 0, max: 3 },
+  bloomRadius: { min: 1, max: 100 },
+  monoScreenShape: { min: 0, max: 4 },
 };
 
+export const HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS = [
+  "blur",
+  "pixelate",
+  "chromaBleed",
+  "tapeDamage",
+  "filmArtifacts",
+  "halftone",
+  "twoInkPrint",
+  "ascii",
+  "dither",
+  "bloom",
+  "monoScreen",
+  "scanlines",
+  "chromaticAberration",
+  "crtCurvature",
+  "digitalGlitch",
+  "engraving",
+  "crosshatch",
+  "kuwahara",
+] as const satisfies readonly HfColorGradingEffectKey[];
+
+export type HfColorGradingActiveEffectKey = (typeof HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS)[number];
+
+export const HF_COLOR_GRADING_EFFECT_PRESETS = HF_COLOR_GRADING_PRESETS.filter((preset) =>
+  HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS.some((key) => preset.effects[key] > 0.0001),
+);
+
+export const HF_COLOR_GRADING_GRADE_PRESETS = HF_COLOR_GRADING_PRESETS.filter(
+  (preset) => !HF_COLOR_GRADING_EFFECT_PRESETS.includes(preset),
+);
+
+/** Useful one-click values. Sub-controls not listed here keep their normalized defaults. */
+export const HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS: Readonly<
+  Record<HfColorGradingActiveEffectKey, HfColorGradingEffects>
+> = {
+  blur: { blur: 0.45 },
+  pixelate: { pixelate: 0.55 },
+  bloom: { bloom: 0.55, bloomRadius: 8 },
+  chromaBleed: { chromaBleed: 0.55 },
+  tapeDamage: {
+    tapeDamage: 0.65,
+    tapeTracking: 0.55,
+    tapeNoise: 0.25,
+    tapeSpeed: 0.5,
+  },
+  filmArtifacts: { filmArtifacts: 0.55 },
+  scanlines: { scanlines: 0.35, scanlineCount: 0.17, scanlineSoftness: 1 },
+  chromaticAberration: { chromaticAberration: 0.15, chromaticAngle: 0 },
+  crtCurvature: { crtCurvature: 0.2 },
+  digitalGlitch: {
+    digitalGlitch: 0.55,
+    digitalGlitchColorSplit: 0.25,
+    digitalGlitchLineTear: 0.25,
+    digitalGlitchPixelate: 0.15,
+    digitalGlitchBlockAmount: 0.5,
+    digitalGlitchBlockDisplacement: 0.25,
+    digitalGlitchBlockOpacity: 0,
+    digitalGlitchSpeed: 0.5,
+  },
+  halftone: { halftone: 0.94, halftoneSize: 0.36 },
+  twoInkPrint: { twoInkPrint: 1, twoInkPrintSize: 0.42 },
+  ascii: {
+    ascii: 1,
+    asciiSize: 5 / 76,
+    asciiInvert: 0,
+    asciiStyle: 0,
+    asciiColor: 1,
+    asciiRotation: 0,
+  },
+  dither: { dither: 1, ditherSize: 0.5 },
+  monoScreen: {
+    monoScreen: 1,
+    monoScreenSize: 0.35,
+    monoScreenAngle: 0.25,
+    monoScreenSpread: 0.3,
+    monoScreenShape: 0,
+    monoScreenInvert: 0,
+  },
+  engraving: {
+    engraving: 1,
+    engravingSpacing: 7 / 17,
+    engravingMinThickness: 0.2,
+    engravingMaxThickness: 3.2 / 7,
+    engravingAngle: 0.25,
+    engravingContrast: 7 / 15,
+    engravingSharpness: 0.59,
+    engravingWave: 0.2,
+    engravingWaveFrequency: 2 / 9,
+  },
+  crosshatch: {
+    crosshatch: 1,
+    crosshatchSpacing: 7 / 25,
+    crosshatchThickness: 0.25,
+    crosshatchAngle: 0.25,
+    crosshatchContrast: 1 / 3,
+    crosshatchEdges: 0.5,
+    crosshatchLineWeight: 0,
+    crosshatchWave: 0.33,
+    crosshatchWaveFrequency: 2 / 9,
+  },
+  kuwahara: {
+    kuwahara: 1,
+    kuwaharaRadius: 1 / 7,
+    kuwaharaSharpness: 5 / 16,
+    kuwaharaSaturation: 0.5,
+  },
+};
+
+export const HF_COLOR_GRADING_ANIMATABLE_PROPERTIES = [
+  { path: "intensity", name: "--hf-color-grading-intensity", min: 0, max: 1 },
+  { path: "lut.intensity", name: "--hf-color-grading-lut-intensity", min: 0, max: 1 },
+  { path: "adjust.exposure", name: "--hf-color-grading-exposure", min: -2, max: 2 },
+  { path: "effects.blur", name: "--hf-color-grading-blur", min: 0, max: 1 },
+  { path: "effects.bloom", name: "--hf-color-grading-bloom", min: 0, max: 3 },
+  { path: "effects.kuwahara", name: "--hf-color-grading-kuwahara", min: 0, max: 1 },
+  { path: "effects.pixelate", name: "--hf-color-grading-pixelate", min: 0, max: 1 },
+  { path: "effects.ascii", name: "--hf-color-grading-ascii", min: 0, max: 1 },
+  { path: "effects.dither", name: "--hf-color-grading-dither", min: 0, max: 1 },
+] as const;
+
+export type HfColorGradingAnimatablePath =
+  (typeof HF_COLOR_GRADING_ANIMATABLE_PROPERTIES)[number]["path"];
+
+function effectLimit(key: HfColorGradingEffectKey): { min: number; max: number } {
+  return EFFECT_LIMIT_OVERRIDES[key] ?? UNIT_LIMIT;
+}
+
+const PALETTE_EFFECT_KEYS = new Set<HfColorGradingActiveEffectKey>([
+  "ascii",
+  "dither",
+  "monoScreen",
+  "engraving",
+  "crosshatch",
+]);
+
+const MULTIPASS_EFFECT_KEYS = new Set<HfColorGradingActiveEffectKey>(["blur", "bloom", "kuwahara"]);
+
+/** Agent-readable view of the canonical grading and effect contracts. */
+export function getHfColorGradingCapabilities() {
+  return {
+    version: 1,
+    targetTags: ["img", "video"],
+    colorSpace: HF_COLOR_GRADING_COLOR_SPACE,
+    intensity: { identity: 1, min: 0, max: 1 },
+    palette: { minColors: 2, maxColors: 6, colorFormat: "#rrggbb" },
+    lut: {
+      format: "3d-cube",
+      maxCubeSize: DEFAULT_MAX_CUBE_LUT_SIZE,
+      intensity: { ...UNIT_LIMIT },
+    },
+    presets: [...HF_COLOR_GRADING_GRADE_PRESETS, ...HF_COLOR_GRADING_EFFECT_PRESETS].map(
+      (preset) => ({
+        id: preset.id,
+        label: preset.label,
+        intensity: preset.intensity,
+      }),
+    ),
+    adjustments: HF_COLOR_GRADING_ADJUST_KEYS.map((key) => ({
+      key,
+      identity: ADJUST_ZERO[key],
+      ...ADJUST_LIMITS[key],
+    })),
+    finishing: HF_COLOR_GRADING_DETAIL_KEYS.map((key) => ({
+      key,
+      identity: DETAIL_DEFAULTS[key],
+      ...DETAIL_LIMITS[key],
+    })),
+    effects: HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS.map((key) => {
+      const apply = HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS[key];
+      return {
+        key,
+        apply: { ...apply },
+        supportsPalette: PALETTE_EFFECT_KEYS.has(key),
+        renderLane: MULTIPASS_EFFECT_KEYS.has(key) ? "multipass" : "single-pass",
+        controls: HF_COLOR_GRADING_EFFECT_KEYS.filter((control) =>
+          Object.hasOwn(apply, control),
+        ).map((control) => ({
+          key: control,
+          identity: EFFECT_DEFAULTS[control],
+          recommended: apply[control] ?? EFFECT_DEFAULTS[control],
+          ...effectLimit(control),
+        })),
+      };
+    }),
+    palettes: HF_COLOR_GRADING_PALETTES.map(({ id, label, group, colors }) => ({
+      id,
+      label,
+      group,
+      colors,
+    })),
+    animatable: HF_COLOR_GRADING_ANIMATABLE_PROPERTIES,
+  };
+}
+
+export type HfColorGradingCapabilities = ReturnType<typeof getHfColorGradingCapabilities>;
+
+const EFFECT_PALETTE_COLOR = /^#[0-9a-f]{6}$/i;
+
+function normalizePalette(value: unknown): readonly string[] | null {
+  if (!Array.isArray(value) || value.length < 2 || value.length > 6) return null;
+  if (!value.every((color) => typeof color === "string" && EFFECT_PALETTE_COLOR.test(color))) {
+    return null;
+  }
+  return value.map((color) => color.toLowerCase());
+}
+
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -417,7 +812,7 @@ function readColorGradingObject(raw: unknown): Record<string, unknown> | null {
         return null;
       }
     }
-    return { preset: trimmed, intensity: 1 };
+    return { preset: trimmed };
   }
   return isRecord(raw) ? raw : null;
 }
@@ -466,8 +861,8 @@ export function normalizeHfColorGrading(raw: unknown): NormalizedHfColorGrading
   const presetId = normalizePresetId(grading.preset);
   const preset = getHfColorGradingPreset(presetId);
   const presetAdjust = preset?.adjust ?? ADJUST_ZERO;
-  const presetDetails = preset?.details ?? DETAIL_ZERO;
-  const presetEffects = preset?.effects ?? EFFECT_ZERO;
+  const presetDetails = preset?.details ?? DETAIL_DEFAULTS;
+  const presetEffects = preset?.effects ?? EFFECT_DEFAULTS;
   const rawAdjust = isRecord(grading.adjust) ? grading.adjust : {};
   const rawDetails = isRecord(grading.details) ? grading.details : {};
   const rawEffects = isRecord(grading.effects) ? grading.effects : {};
@@ -483,23 +878,27 @@ export function normalizeHfColorGrading(raw: unknown): NormalizedHfColorGrading
       result[key] = readLimitedValue(rawDetails[key] ?? presetDetails[key], DETAIL_LIMITS[key]);
       return result;
     },
-    { ...DETAIL_ZERO },
+    { ...DETAIL_DEFAULTS },
   );
   const effects = HF_COLOR_GRADING_EFFECT_KEYS.reduce<Record<HfColorGradingEffectKey, number>>(
     (result, key) => {
-      result[key] = readLimitedValue(rawEffects[key] ?? presetEffects[key], EFFECT_LIMITS[key]);
+      result[key] = readLimitedValue(
+        rawEffects[key] ?? presetEffects[key],
+        EFFECT_LIMIT_OVERRIDES[key] ?? UNIT_LIMIT,
+      );
       return result;
     },
-    { ...EFFECT_ZERO },
+    { ...EFFECT_DEFAULTS },
   );
 
   return {
     enabled: true,
     preset: presetId,
-    intensity: clampUnit(grading.intensity, 1),
+    intensity: clampUnit(grading.intensity, preset?.intensity ?? 1),
     adjust,
     details,
     effects,
+    palette: normalizePalette(grading.palette),
     lut: normalizeLut(grading.lut),
     colorSpace:
       typeof grading.colorSpace === "string" && grading.colorSpace.trim()
@@ -520,20 +919,20 @@ export function serializeHfColorGrading(
 ): string {
   const normalized = normalizeHfColorGrading(grading);
   if (!normalized) return "";
-  const { enabled: _enabled, ...serializable } = normalized;
-  return JSON.stringify(serializable);
+  const { enabled: _enabled, palette, ...serializable } = normalized;
+  return JSON.stringify(palette ? { ...serializable, palette } : serializable);
 }
 
 export function isHfColorGradingActive(
   grading: NormalizedHfColorGrading | null,
 ): grading is NormalizedHfColorGrading {
   if (!grading?.enabled) return false;
-  if (grading.intensity === 0) return false;
-  if (grading.lut && grading.lut.intensity !== 0) return true;
-  return (
-    HF_COLOR_GRADING_ADJUST_KEYS.some((key) => Math.abs(grading.adjust[key]) > 0.0001) ||
+  const hasIndependentTreatment =
     Math.abs(grading.details.vignette) > 0.0001 ||
     Math.abs(grading.details.grain) > 0.0001 ||
-    HF_COLOR_GRADING_EFFECT_KEYS.some((key) => Math.abs(grading.effects[key]) > 0.0001)
-  );
+    HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS.some((key) => Math.abs(grading.effects[key]) > 0.0001);
+  if (hasIndependentTreatment) return true;
+  if (grading.intensity === 0) return false;
+  if (grading.lut && grading.lut.intensity !== 0) return true;
+  return HF_COLOR_GRADING_ADJUST_KEYS.some((key) => Math.abs(grading.adjust[key]) > 0.0001);
 }
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index d99e932a7a..b91597bb99 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -169,11 +169,20 @@ export { parseAnimatedGifMetadata, type AnimatedGifMetadata } from "./media/gif"
 export {
   HF_COLOR_GRADING_ATTR,
   HF_COLOR_GRADING_ADJUST_KEYS,
+  HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS,
+  HF_COLOR_GRADING_ANIMATABLE_PROPERTIES,
   HF_COLOR_GRADING_CANVAS_ID_PREFIX,
   HF_COLOR_GRADING_COLOR_SPACE,
   HF_COLOR_GRADING_DETAIL_KEYS,
+  HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS,
   HF_COLOR_GRADING_EFFECT_KEYS,
+  HF_COLOR_GRADING_EFFECT_PRESETS,
+  HF_COLOR_GRADING_GRADE_PRESETS,
+  HF_COLOR_GRADING_LUT_KEYS,
+  HF_COLOR_GRADING_PALETTES,
   HF_COLOR_GRADING_PRESETS,
+  HF_COLOR_GRADING_TOP_LEVEL_KEYS,
+  getHfColorGradingCapabilities,
   isHfColorGradingActive,
   normalizeHfColorGrading,
   normalizeHfColorGradingWithVariables,
@@ -182,6 +191,8 @@ export {
   type HfColorGrading,
   type HfColorGradingAdjust,
   type HfColorGradingAdjustKey,
+  type HfColorGradingAnimatablePath,
+  type HfColorGradingActiveEffectKey,
   type HfColorGradingDetailKey,
   type HfColorGradingDetails,
   type HfColorGradingEffectKey,
@@ -191,6 +202,7 @@ export {
   type HfColorGradingPresetId,
   type HfColorGradingTarget,
   type HfColorGradingVariableMap,
+  type HfColorGradingCapabilities,
   type NormalizedHfColorGrading,
 } from "./colorGrading";
 export { parseCubeLut, CubeLutParseError, type ParseCubeLutOptions } from "./colorLuts";
diff --git a/packages/core/src/runtime/bridge.test.ts b/packages/core/src/runtime/bridge.test.ts
index e5d432dbc4..7f54ebfda4 100644
--- a/packages/core/src/runtime/bridge.test.ts
+++ b/packages/core/src/runtime/bridge.test.ts
@@ -182,7 +182,7 @@ describe("installRuntimeControlBridge", () => {
   it("dispatches set-color-grading command with target and grading payload", () => {
     const deps = createMockDeps();
     const handler = installRuntimeControlBridge(deps);
-    const grading = { preset: "warm-clean", intensity: 0.7 };
+    const grading = { preset: "warm-daylight", intensity: 0.7 };
     const target = { id: "hero-video", selectorIndex: 0 };
     handler(makeControlMessage("set-color-grading", { target, grading }));
     expect(deps.onSetColorGrading).toHaveBeenCalledWith(target, grading);
diff --git a/packages/parsers/package-subpaths.json b/packages/parsers/package-subpaths.json
index 1c2d78f15d..2354696e7e 100644
--- a/packages/parsers/package-subpaths.json
+++ b/packages/parsers/package-subpaths.json
@@ -80,6 +80,12 @@
       "types": "./dist/compositionContract.d.ts",
       "environments": ["browser", "bun", "node"]
     },
+    "./color-grading-contract": {
+      "source": "./src/colorGradingContract.ts",
+      "runtime": "./dist/colorGradingContract.js",
+      "types": "./dist/colorGradingContract.d.ts",
+      "environments": ["browser", "bun", "node"]
+    },
     "./sub-composition-validity": {
       "source": "./src/subCompositionValidity.ts",
       "runtime": "./dist/subCompositionValidity.js",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index b5664f51e0..6e002a46be 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -88,6 +88,12 @@
       "import": "./src/compositionContract.ts",
       "types": "./src/compositionContract.ts"
     },
+    "./color-grading-contract": {
+      "bun": "./src/colorGradingContract.ts",
+      "node": "./dist/colorGradingContract.js",
+      "import": "./src/colorGradingContract.ts",
+      "types": "./src/colorGradingContract.ts"
+    },
     "./sub-composition-validity": {
       "bun": "./src/subCompositionValidity.ts",
       "node": "./dist/subCompositionValidity.js",
@@ -159,6 +165,10 @@
         "import": "./dist/compositionContract.js",
         "types": "./dist/compositionContract.d.ts"
       },
+      "./color-grading-contract": {
+        "import": "./dist/colorGradingContract.js",
+        "types": "./dist/colorGradingContract.d.ts"
+      },
       "./sub-composition-validity": {
         "import": "./dist/subCompositionValidity.js",
         "types": "./dist/subCompositionValidity.d.ts"
diff --git a/packages/parsers/src/colorGradingContract.test.ts b/packages/parsers/src/colorGradingContract.test.ts
new file mode 100644
index 0000000000..95c84e7676
--- /dev/null
+++ b/packages/parsers/src/colorGradingContract.test.ts
@@ -0,0 +1,63 @@
+import { describe, expect, it } from "vitest";
+import {
+  COLOR_GRADING_ADJUST_KEYS,
+  COLOR_GRADING_DETAIL_KEYS,
+  COLOR_GRADING_EFFECT_KEYS,
+  COLOR_GRADING_LUT_KEYS,
+  COLOR_GRADING_TOP_LEVEL_KEYS,
+  isColorGradingVariableRef,
+  validateColorGradingContract,
+} from "./colorGradingContract";
+
+describe("color grading contract", () => {
+  it("publishes one complete key registry", () => {
+    expect(COLOR_GRADING_TOP_LEVEL_KEYS).toContain("effects");
+    expect(COLOR_GRADING_ADJUST_KEYS).toContain("exposure");
+    expect(COLOR_GRADING_DETAIL_KEYS).toContain("grain");
+    expect(COLOR_GRADING_EFFECT_KEYS).toContain("kuwahara");
+    expect(COLOR_GRADING_LUT_KEYS).toEqual(["src", "intensity"]);
+  });
+
+  it("accepts the complete current contract and variable references", () => {
+    expect(
+      validateColorGradingContract({
+        enabled: "$enabled",
+        preset: "clean-studio",
+        intensity: 0.8,
+        adjust: { exposure: 0.1, contrast: "$contrast" },
+        details: { grain: 0.1 },
+        effects: { bloom: 1.2, bloomRadius: 24, asciiStyle: 4 },
+        palette: ["#112233", "#abcdef"],
+        lut: { src: "$lutPath", intensity: 0.5 },
+        colorSpace: "rec709",
+      }),
+    ).toEqual([]);
+    expect(isColorGradingVariableRef("${grade.amount}")).toBe(true);
+  });
+
+  it("rejects unknown fields, invalid ranges, and malformed palettes", () => {
+    expect(
+      validateColorGradingContract({
+        mystery: true,
+        adjust: { exposure: 3, mystery: 1 },
+        details: { grain: -0.1 },
+        effects: { bloom: 4, bloomRadius: 0 },
+        palette: ["red"],
+        lut: {},
+        colorSpace: "display-p3",
+      }),
+    ).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ path: "grading" }),
+        expect.objectContaining({ path: "adjust" }),
+        expect.objectContaining({ path: "adjust.exposure" }),
+        expect.objectContaining({ path: "details.grain" }),
+        expect.objectContaining({ path: "effects.bloom" }),
+        expect.objectContaining({ path: "effects.bloomRadius" }),
+        expect.objectContaining({ path: "palette" }),
+        expect.objectContaining({ path: "lut.src" }),
+        expect.objectContaining({ path: "colorSpace" }),
+      ]),
+    );
+  });
+});
diff --git a/packages/parsers/src/colorGradingContract.ts b/packages/parsers/src/colorGradingContract.ts
new file mode 100644
index 0000000000..95d99f85ef
--- /dev/null
+++ b/packages/parsers/src/colorGradingContract.ts
@@ -0,0 +1,331 @@
+export const COLOR_GRADING_CONTRACT_VERSION = 1;
+export const COLOR_GRADING_COLOR_SPACE = "rec709";
+
+export const COLOR_GRADING_TOP_LEVEL_KEYS = [
+  "enabled",
+  "preset",
+  "intensity",
+  "adjust",
+  "details",
+  "effects",
+  "palette",
+  "lut",
+  "colorSpace",
+] as const;
+
+export const COLOR_GRADING_ADJUST_KEYS = [
+  "exposure",
+  "contrast",
+  "highlights",
+  "shadows",
+  "whites",
+  "blacks",
+  "temperature",
+  "tint",
+  "vibrance",
+  "saturation",
+] as const;
+
+export const COLOR_GRADING_DETAIL_KEYS = [
+  "vignette",
+  "vignetteMidpoint",
+  "vignetteRoundness",
+  "vignetteFeather",
+  "grain",
+  "grainSize",
+  "grainRoughness",
+] as const;
+
+export const COLOR_GRADING_EFFECT_KEYS = [
+  "blur",
+  "pixelate",
+  "chromaBleed",
+  "tapeDamage",
+  "tapeTracking",
+  "tapeNoise",
+  "tapeSpeed",
+  "filmArtifacts",
+  "halftone",
+  "halftoneSize",
+  "twoInkPrint",
+  "twoInkPrintSize",
+  "ascii",
+  "asciiSize",
+  "asciiInvert",
+  "asciiStyle",
+  "asciiColor",
+  "asciiRotation",
+  "dither",
+  "ditherSize",
+  "bloom",
+  "bloomRadius",
+  "monoScreen",
+  "monoScreenSize",
+  "monoScreenAngle",
+  "monoScreenSpread",
+  "monoScreenShape",
+  "monoScreenInvert",
+  "scanlines",
+  "scanlineCount",
+  "scanlineSoftness",
+  "chromaticAberration",
+  "chromaticAngle",
+  "crtCurvature",
+  "digitalGlitch",
+  "digitalGlitchColorSplit",
+  "digitalGlitchLineTear",
+  "digitalGlitchPixelate",
+  "digitalGlitchBlockAmount",
+  "digitalGlitchBlockDisplacement",
+  "digitalGlitchBlockOpacity",
+  "digitalGlitchSpeed",
+  "engraving",
+  "engravingSpacing",
+  "engravingMinThickness",
+  "engravingMaxThickness",
+  "engravingAngle",
+  "engravingContrast",
+  "engravingSharpness",
+  "engravingWave",
+  "engravingWaveFrequency",
+  "crosshatch",
+  "crosshatchSpacing",
+  "crosshatchThickness",
+  "crosshatchAngle",
+  "crosshatchContrast",
+  "crosshatchEdges",
+  "crosshatchLineWeight",
+  "crosshatchWave",
+  "crosshatchWaveFrequency",
+  "kuwahara",
+  "kuwaharaRadius",
+  "kuwaharaSharpness",
+  "kuwaharaSaturation",
+] as const;
+
+export const COLOR_GRADING_LUT_KEYS = ["src", "intensity"] as const;
+
+type NumericLimit = Readonly<{ min: number; max: number }>;
+
+const UNIT_LIMIT: NumericLimit = { min: 0, max: 1 };
+const SIGNED_UNIT_LIMIT: NumericLimit = { min: -1, max: 1 };
+const EFFECT_LIMIT_OVERRIDES: Readonly<Record<string, NumericLimit>> = {
+  asciiStyle: { min: 0, max: 7 },
+  bloom: { min: 0, max: 3 },
+  bloomRadius: { min: 1, max: 100 },
+  monoScreenShape: { min: 0, max: 4 },
+};
+const VARIABLE_REF = /^\$(?:\{[A-Za-z0-9_.:-]+\}|[A-Za-z0-9_.:-]+)$/;
+const PALETTE_COLOR = /^#[0-9a-f]{6}$/i;
+
+const OBJECT_SECTIONS = [
+  ["adjust", COLOR_GRADING_ADJUST_KEYS],
+  ["details", COLOR_GRADING_DETAIL_KEYS],
+  ["effects", COLOR_GRADING_EFFECT_KEYS],
+  ["lut", COLOR_GRADING_LUT_KEYS],
+] as const;
+
+export interface ColorGradingContractIssue {
+  path: string;
+  message: string;
+  hint?: string;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export function isColorGradingVariableRef(value: unknown): value is string {
+  return typeof value === "string" && VARIABLE_REF.test(value.trim());
+}
+
+function validateObject(
+  value: unknown,
+  path: string,
+  keys: readonly string[],
+  issues: ColorGradingContractIssue[],
+): Record<string, unknown> | null {
+  if (isColorGradingVariableRef(value)) return null;
+  if (!isRecord(value)) {
+    issues.push({ path, message: "must be an object or variable reference" });
+    return null;
+  }
+  const allowed = new Set(keys);
+  const unknown = Object.keys(value).filter((key) => !allowed.has(key));
+  if (unknown.length > 0) {
+    issues.push({ path, message: `has unsupported key(s): ${unknown.join(", ")}` });
+  }
+  return value;
+}
+
+function validateNumericField(
+  value: Record<string, unknown>,
+  key: string,
+  path: string,
+  limit: NumericLimit,
+  issues: ColorGradingContractIssue[],
+): void {
+  const candidate = value[key];
+  if (candidate === undefined || isColorGradingVariableRef(candidate)) return;
+  if (
+    typeof candidate !== "number" ||
+    !Number.isFinite(candidate) ||
+    candidate < limit.min ||
+    candidate > limit.max
+  ) {
+    issues.push({
+      path: path ? `${path}.${key}` : key,
+      message: `must be a finite number from ${limit.min} through ${limit.max}`,
+    });
+  }
+}
+
+function validateNumericSection(
+  value: Record<string, unknown>,
+  path: string,
+  keys: readonly string[],
+  limitFor: (key: string) => NumericLimit,
+  issues: ColorGradingContractIssue[],
+): void {
+  for (const key of keys) validateNumericField(value, key, path, limitFor(key), issues);
+}
+
+function validatePalette(value: unknown, issues: ColorGradingContractIssue[]): void {
+  if (value === undefined || value === null || isColorGradingVariableRef(value)) return;
+  if (!Array.isArray(value) || value.length < 2 || value.length > 6) {
+    issues.push({ path: "palette", message: "must contain 2 to 6 hex colors" });
+    return;
+  }
+  value.forEach((color, index) => {
+    if (typeof color !== "string" || !PALETTE_COLOR.test(color)) {
+      issues.push({ path: `palette[${index}]`, message: "must be a six-digit hex color" });
+    }
+  });
+}
+
+function validateLut(
+  value: unknown,
+  object: Record<string, unknown> | null,
+  issues: ColorGradingContractIssue[],
+): void {
+  if (typeof value === "string") {
+    if (!value.trim()) issues.push({ path: "lut", message: "must not be empty" });
+    return;
+  }
+  if (!object) return;
+  if (
+    !isColorGradingVariableRef(object.src) &&
+    (typeof object.src !== "string" || !object.src.trim())
+  ) {
+    issues.push({
+      path: "lut.src",
+      message: "must be a non-empty string or variable reference",
+    });
+  }
+  validateNumericField(object, "intensity", "lut", UNIT_LIMIT, issues);
+}
+
+function validateEnabled(
+  grading: Record<string, unknown>,
+  issues: ColorGradingContractIssue[],
+): void {
+  if (
+    grading.enabled !== undefined &&
+    !isColorGradingVariableRef(grading.enabled) &&
+    typeof grading.enabled !== "boolean"
+  ) {
+    issues.push({ path: "enabled", message: "must be a boolean or variable reference" });
+  }
+}
+
+function validatePreset(
+  grading: Record<string, unknown>,
+  issues: ColorGradingContractIssue[],
+): void {
+  if (
+    grading.preset !== undefined &&
+    grading.preset !== null &&
+    !isColorGradingVariableRef(grading.preset) &&
+    (typeof grading.preset !== "string" || !grading.preset.trim())
+  ) {
+    issues.push({
+      path: "preset",
+      message: "must be a non-empty string, null, or variable reference",
+    });
+  }
+}
+
+function validateColorSpace(
+  grading: Record<string, unknown>,
+  issues: ColorGradingContractIssue[],
+): void {
+  if (
+    grading.colorSpace !== undefined &&
+    !isColorGradingVariableRef(grading.colorSpace) &&
+    grading.colorSpace !== COLOR_GRADING_COLOR_SPACE
+  ) {
+    issues.push({
+      path: "colorSpace",
+      message: `must be "${COLOR_GRADING_COLOR_SPACE}" or a variable reference`,
+    });
+  }
+}
+
+function validateTopLevel(
+  grading: Record<string, unknown>,
+  issues: ColorGradingContractIssue[],
+): void {
+  validateEnabled(grading, issues);
+  validateNumericField(grading, "intensity", "", UNIT_LIMIT, issues);
+  validatePreset(grading, issues);
+  validateColorSpace(grading, issues);
+}
+
+function validateSection(
+  grading: Record<string, unknown>,
+  key: (typeof OBJECT_SECTIONS)[number][0],
+  keys: readonly string[],
+  issues: ColorGradingContractIssue[],
+): void {
+  const section = grading[key];
+  if (section === undefined || (key === "lut" && section === null)) return;
+  if (key === "lut" && typeof section === "string") {
+    validateLut(section, null, issues);
+    return;
+  }
+  const object = validateObject(section, key, keys, issues);
+  if (!object) return;
+  if (key === "lut") return validateLut(section, object, issues);
+
+  const limitFor = (control: string): NumericLimit => {
+    if (key === "adjust" && control === "exposure") return { min: -2, max: 2 };
+    if (key === "adjust" || (key === "details" && control === "vignetteRoundness")) {
+      return SIGNED_UNIT_LIMIT;
+    }
+    return key === "effects" ? (EFFECT_LIMIT_OVERRIDES[control] ?? UNIT_LIMIT) : UNIT_LIMIT;
+  };
+  validateNumericSection(object, key, keys, limitFor, issues);
+}
+
+function validateSections(
+  grading: Record<string, unknown>,
+  issues: ColorGradingContractIssue[],
+): void {
+  for (const [key, keys] of OBJECT_SECTIONS) validateSection(grading, key, keys, issues);
+}
+
+/** Browser-safe structural validation shared by Lint, CLI, and Core consumers. */
+export function validateColorGradingContract(value: unknown): ColorGradingContractIssue[] {
+  if (typeof value === "string") {
+    return value.trim() ? [] : [{ path: "grading", message: "is empty" }];
+  }
+
+  const issues: ColorGradingContractIssue[] = [];
+  const grading = validateObject(value, "grading", COLOR_GRADING_TOP_LEVEL_KEYS, issues);
+  if (!grading) return issues;
+
+  validateTopLevel(grading, issues);
+  validateSections(grading, issues);
+  validatePalette(grading.palette, issues);
+  return issues;
+}
diff --git a/packages/parsers/tsup.config.ts b/packages/parsers/tsup.config.ts
index 43ace519d9..f32100a336 100644
--- a/packages/parsers/tsup.config.ts
+++ b/packages/parsers/tsup.config.ts
@@ -14,6 +14,7 @@ export default defineConfig({
     assets: "src/assets.ts",
     composition: "src/composition.ts",
     compositionContract: "src/compositionContract.ts",
+    colorGradingContract: "src/colorGradingContract.ts",
     subCompositionValidity: "src/subCompositionValidity.ts",
     ffBinaries: "src/ffBinaries.ts",
     assetResolution: "src/assetResolution.ts",
diff --git a/packages/studio/src/components/editor/colorGradingScopePatch.test.ts b/packages/studio/src/components/editor/colorGradingScopePatch.test.ts
index 96abf3aff8..caedd802ae 100644
--- a/packages/studio/src/components/editor/colorGradingScopePatch.test.ts
+++ b/packages/studio/src/components/editor/colorGradingScopePatch.test.ts
@@ -5,15 +5,15 @@ describe("patchMediaColorGradingInHtml", () => {
   it("adds color grading to video and image tags only", () => {
     const { html, count } = patchMediaColorGradingInHtml(
       `<div><video id="v"></video><img id="i" /><audio id="a"></audio></div>`,
-      `{"preset":"natural-lift"}`,
+      `{"preset":"warm-daylight"}`,
     );
 
     expect(count).toBe(2);
     expect(html).toContain(
-      `video id="v" data-color-grading="{&quot;preset&quot;:&quot;natural-lift&quot;}"`,
+      `video id="v" data-color-grading="{&quot;preset&quot;:&quot;warm-daylight&quot;}"`,
     );
     expect(html).toContain(
-      `img id="i" data-color-grading="{&quot;preset&quot;:&quot;natural-lift&quot;}"`,
+      `img id="i" data-color-grading="{&quot;preset&quot;:&quot;warm-daylight&quot;}"`,
     );
     expect(html).toContain(`<audio id="a"></audio>`);
   });
diff --git a/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx b/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx
index db615065e9..b2030f9c0d 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx
@@ -243,11 +243,11 @@ describe("FlatColorGradingSection — Preset + LUT", () => {
     // needs its own accessible name via the dedicated ariaLabel prop.
     expect(presetSelect.getAttribute("aria-label")).toBe("Preset");
     act(() => {
-      presetSelect.value = "fresh-pop";
+      presetSelect.value = "bright-pop";
       presetSelect.dispatchEvent(new Event("change", { bubbles: true }));
     });
     expect(onCommitColorGrading).toHaveBeenCalledTimes(1);
-    expect(onCommitColorGrading.mock.calls[0][0].preset).toBe("fresh-pop");
+    expect(onCommitColorGrading.mock.calls[0][0].preset).toBe("bright-pop");
     act(() => root.unmount());
   });
 
diff --git a/packages/studio/src/components/editor/propertyPanelFlatPrimitives.test.tsx b/packages/studio/src/components/editor/propertyPanelFlatPrimitives.test.tsx
index efde147c23..9c6de843a1 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatPrimitives.test.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatPrimitives.test.tsx
@@ -1159,20 +1159,20 @@ describe("FlatSelectRow — label/value options", () => {
     const { host, root } = renderInto(
       <FlatSelectRow
         label="Preset"
-        value="natural-lift"
+        value="clean-studio"
         options={[
           { value: "neutral", label: "Neutral" },
-          { value: "natural-lift", label: "Natural Lift" },
-          { value: "fresh-pop", label: "Fresh Pop" },
+          { value: "clean-studio", label: "Clean Studio" },
+          { value: "bright-pop", label: "Bright Pop" },
         ]}
         tier="explicitCustom"
         onChange={vi.fn()}
       />,
     );
     const select = host.querySelector("select");
-    expect(select?.value).toBe("natural-lift");
+    expect(select?.value).toBe("clean-studio");
     const options = Array.from(host.querySelectorAll("option")).map((o) => o.textContent);
-    expect(options).toEqual(["Neutral", "Natural Lift", "Fresh Pop"]);
+    expect(options).toEqual(["Neutral", "Clean Studio", "Bright Pop"]);
     act(() => root.unmount());
   });
 
diff --git a/packages/studio/src/components/editor/useColorGradingController.test.ts b/packages/studio/src/components/editor/useColorGradingController.test.ts
index 5e74587e6f..4b4d9376d3 100644
--- a/packages/studio/src/components/editor/useColorGradingController.test.ts
+++ b/packages/studio/src/components/editor/useColorGradingController.test.ts
@@ -7,15 +7,15 @@ import { normalizeHfColorGrading } from "@hyperframes/core/color-grading";
 import { useColorGradingController } from "./useColorGradingController";
 import type { DomEditSelection } from "./domEditing";
 
-function freshPopGrading() {
-  const next = normalizeHfColorGrading({ preset: "fresh-pop", intensity: 1 });
-  if (!next) throw new Error("expected fresh-pop preset to normalize");
+function brightPopGrading() {
+  const next = normalizeHfColorGrading({ preset: "bright-pop", intensity: 1 });
+  if (!next) throw new Error("expected bright-pop preset to normalize");
   return next;
 }
 
-function naturalLiftGrading() {
-  const next = normalizeHfColorGrading({ preset: "natural-lift", intensity: 1 });
-  if (!next) throw new Error("expected natural-lift preset to normalize");
+function warmDaylightGrading() {
+  const next = normalizeHfColorGrading({ preset: "warm-daylight", intensity: 1 });
+  if (!next) throw new Error("expected warm-daylight preset to normalize");
   return next;
 }
 
@@ -120,9 +120,9 @@ describe("useColorGradingController", () => {
     const onSetAttributeLive = vi.fn();
     const { root, getState } = renderHook(onSetAttributeLive);
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
-    expect(getState().grading.preset).toBe("fresh-pop");
+    expect(getState().grading.preset).toBe("bright-pop");
     expect(onSetAttributeLive).not.toHaveBeenCalled();
     act(() => {
       vi.advanceTimersByTime(400);
@@ -130,7 +130,7 @@ describe("useColorGradingController", () => {
     expect(onSetAttributeLive).toHaveBeenCalledTimes(1);
     const [attr, value] = onSetAttributeLive.mock.calls[0] as [string, string];
     expect(attr).toBe("color-grading");
-    expect(value).toContain("fresh-pop");
+    expect(value).toContain("bright-pop");
     act(() => root.unmount());
     vi.useRealTimers();
   });
@@ -149,9 +149,9 @@ describe("useColorGradingController", () => {
     );
     const { root, getState } = renderHook(onSetAttributeLive);
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
-    expect(getState().grading.preset).toBe("fresh-pop");
+    expect(getState().grading.preset).toBe("bright-pop");
     act(() => {
       vi.advanceTimersByTime(400);
     });
@@ -170,9 +170,9 @@ describe("useColorGradingController", () => {
     const onSetAttributeLive = vi.fn().mockRejectedValue(new Error("disk full"));
     const { root, getState } = renderHook(onSetAttributeLive);
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
-    expect(getState().grading.preset).toBe("fresh-pop");
+    expect(getState().grading.preset).toBe("bright-pop");
     act(() => {
       vi.advanceTimersByTime(400);
     });
@@ -182,7 +182,7 @@ describe("useColorGradingController", () => {
       await Promise.resolve();
     });
     // Reverted to "neutral" (the last confirmed-good value, from before this
-    // commit) instead of permanently showing "fresh-pop" as if it had saved.
+    // commit) instead of permanently showing "bright-pop" as if it had saved.
     expect(getState().grading.preset).toBe("neutral");
     expect(getState().runtimeStatus.state).toBe("unavailable");
     act(() => root.unmount());
@@ -206,7 +206,7 @@ describe("useColorGradingController", () => {
       makeElement({ id: "s1-bg" }),
     );
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
     // Let the debounce fire while still on s1-bg — the persist call is now
     // genuinely in flight (its promise won't settle until resolveA() below).
@@ -243,7 +243,7 @@ describe("useColorGradingController", () => {
     let capturedOnSettledA: ((ok: boolean) => void) | undefined;
     const onSetAttributeLive = vi
       .fn()
-      // Edit A (fresh-pop): captures its onSettled and never resolves until
+      // Edit A (bright-pop): captures its onSettled and never resolves until
       // resolveA() is called below — simulates a slow persist.
       .mockImplementationOnce(
         (_attr: string, _value: string | null, onSettled?: (ok: boolean) => void) => {
@@ -253,7 +253,7 @@ describe("useColorGradingController", () => {
           });
         },
       )
-      // Edit B (natural-lift): settles immediately and successfully.
+      // Edit B (warm-daylight): settles immediately and successfully.
       .mockImplementationOnce(
         (_attr: string, _value: string | null, onSettled?: (ok: boolean) => void) => {
           onSettled?.(true);
@@ -263,7 +263,7 @@ describe("useColorGradingController", () => {
     const { root, getState } = renderHook(onSetAttributeLive);
 
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
     act(() => {
       vi.advanceTimersByTime(400);
@@ -272,13 +272,13 @@ describe("useColorGradingController", () => {
 
     // B commits on the SAME element before A's persist has settled.
     act(() => {
-      getState().commitColorGrading(naturalLiftGrading());
+      getState().commitColorGrading(warmDaylightGrading());
     });
     act(() => {
       vi.advanceTimersByTime(400);
     });
     expect(onSetAttributeLive).toHaveBeenCalledTimes(2); // B's persist has already settled (mock resolves sync)
-    expect(getState().grading.preset).toBe("natural-lift");
+    expect(getState().grading.preset).toBe("warm-daylight");
 
     // NOW A's stale persist finally settles as a FAILURE — must not revert
     // `grading` (which now correctly shows B's newer edit) back to the
@@ -292,7 +292,7 @@ describe("useColorGradingController", () => {
       await Promise.resolve();
       await Promise.resolve();
     });
-    expect(getState().grading.preset).toBe("natural-lift");
+    expect(getState().grading.preset).toBe("warm-daylight");
     act(() => root.unmount());
     vi.useRealTimers();
   });
@@ -300,7 +300,7 @@ describe("useColorGradingController", () => {
   it("resetGrading returns to the neutral preset", () => {
     const { root, getState } = renderHook(vi.fn());
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
     act(() => {
       getState().resetGrading();
@@ -315,9 +315,9 @@ describe("useColorGradingController", () => {
       makeElement({ id: "s1-bg" }),
     );
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
-    expect(getState().grading.preset).toBe("fresh-pop");
+    expect(getState().grading.preset).toBe("bright-pop");
     // A different element, with no persisted grading of its own — without a
     // reset, this hook (unlike the legacy component it was extracted from,
     // which remounts via a `key={selectionIdentityKey}`) would keep showing
@@ -337,9 +337,9 @@ describe("useColorGradingController", () => {
       makeElement({ id: "bg", sourceFile: "index.html" }),
     );
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
-    expect(getState().grading.preset).toBe("fresh-pop");
+    expect(getState().grading.preset).toBe("bright-pop");
     rerenderWithElement(makeElement({ id: "bg", sourceFile: "sub-comp.html" }));
     expect(getState().grading.preset).toBe("neutral");
     act(() => root.unmount());
@@ -353,7 +353,7 @@ describe("useColorGradingController", () => {
       makeElement({ id: "s1-bg" }),
     );
     act(() => {
-      getState().commitColorGrading(freshPopGrading());
+      getState().commitColorGrading(brightPopGrading());
     });
     // Switch selection before the 350ms debounce fires — the in-flight edit
     // must be written immediately (targeting the OUTGOING element's own
@@ -366,7 +366,7 @@ describe("useColorGradingController", () => {
     expect(onSetAttributeLive).toHaveBeenCalledTimes(1);
     const [attr, value] = onSetAttributeLive.mock.calls[0] as [string, string];
     expect(attr).toBe("color-grading");
-    expect(value).toContain("fresh-pop");
+    expect(value).toContain("bright-pop");
     // And it must not ALSO fire again once the (now-cleared) original timer
     // window would have elapsed.
     act(() => {
diff --git a/skills-manifest.json b/skills-manifest.json
index d40131224b..d65353ba66 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -46,7 +46,7 @@
       "files": 10
     },
     "media-use": {
-      "hash": "f7f0ad56a0477a09",
+      "hash": "6b94dc295e2d6ba0",
       "files": 145
     },
     "motion-graphics": {
diff --git a/skills/media-use/scripts/lib/lut-preset-provider.mjs b/skills/media-use/scripts/lib/lut-preset-provider.mjs
index 5807f163f4..3eaac6f68b 100644
--- a/skills/media-use/scripts/lib/lut-preset-provider.mjs
+++ b/skills/media-use/scripts/lib/lut-preset-provider.mjs
@@ -11,12 +11,10 @@ const LUT_DIR = join(SKILL_DIR, "luts");
 const LUT_INDEX = join(LUT_DIR, "index.json");
 export const LIBRARY_LUT_OFFLINE_CODE = "MEDIA_USE_LIBRARY_LUT_OFFLINE";
 
-// Mirrored from packages/core/src/colorGrading.ts HfColorGradingPresetId.
-// Keep this list in lockstep with the core runtime contract.
-export const CORE_PRESET_IDS = [
+// Presets this released resolver can safely emit at this stack layer.
+// Effect-backed treatment presets join after their runtime support lands.
+export const RESOLVABLE_PRESET_IDS = [
   "neutral",
-  "natural-lift",
-  "fresh-pop",
   "warm-daylight",
   "clean-studio",
   "skin-soft",
@@ -26,8 +24,6 @@ export const CORE_PRESET_IDS = [
   "vintage-wash",
   "mono-clean",
   "mono-fade",
-  "warm-clean",
-  "cool-clean",
   "soft-boost",
   "bright-pop",
   "deep-contrast",
@@ -35,16 +31,25 @@ export const CORE_PRESET_IDS = [
 
 const PRESET_SYNONYMS = {
   neutral: ["neutral", "identity", "none", "ungraded", "natural base"],
-  "natural-lift": ["natural lift", "natural light", "gentle lift", "soft natural"],
-  "fresh-pop": ["fresh pop", "fresh", "bright fresh", "clean colorful"],
   "warm-daylight": [
     "warm daylight",
     "warm natural light",
     "golden daylight",
     "sunlit",
     "warm sunny",
+    "warm clean",
+    "clean warm",
+    "warm product",
+  ],
+  "clean-studio": [
+    "clean studio",
+    "studio clean",
+    "cool studio",
+    "product studio",
+    "cool clean",
+    "clean cool",
+    "cool crisp",
   ],
-  "clean-studio": ["clean studio", "studio clean", "cool studio", "product studio"],
   "skin-soft": ["skin soft", "soft skin", "portrait soft", "beauty skin"],
   "food-pop": ["food pop", "food vibrant", "appetizing", "restaurant color"],
   "night-lift": ["night lift", "night", "low light lift", "city night"],
@@ -52,15 +57,29 @@ const PRESET_SYNONYMS = {
   "vintage-wash": ["vintage wash", "vintage", "retro wash", "aged film"],
   "mono-clean": ["mono clean", "black white clean", "monochrome clean"],
   "mono-fade": ["mono fade", "black white fade", "faded monochrome"],
-  "warm-clean": ["warm clean", "clean warm", "warm product"],
-  "cool-clean": ["cool clean", "clean cool", "cool crisp"],
-  "soft-boost": ["soft boost", "soft bright", "gentle boost"],
-  "bright-pop": ["bright pop", "bright punchy", "vivid bright"],
+  "soft-boost": [
+    "soft boost",
+    "soft bright",
+    "gentle boost",
+    "natural lift",
+    "natural light",
+    "gentle lift",
+    "soft natural",
+  ],
+  "bright-pop": [
+    "bright pop",
+    "bright punchy",
+    "vivid bright",
+    "fresh pop",
+    "fresh",
+    "bright fresh",
+    "clean colorful",
+  ],
   "deep-contrast": ["deep contrast", "high contrast punchy", "punchy contrast", "bold contrast"],
 };
 
 function presetCandidates() {
-  return CORE_PRESET_IDS.map((id) => ({
+  return RESOLVABLE_PRESET_IDS.map((id) => ({
     kind: "preset",
     preset: id,
     synonyms: PRESET_SYNONYMS[id] ?? [],
diff --git a/skills/media-use/scripts/lib/lut-preset-provider.test.mjs b/skills/media-use/scripts/lib/lut-preset-provider.test.mjs
index 162bf9f600..f63d214d3e 100644
--- a/skills/media-use/scripts/lib/lut-preset-provider.test.mjs
+++ b/skills/media-use/scripts/lib/lut-preset-provider.test.mjs
@@ -4,8 +4,8 @@ import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { test } from "node:test";
 import {
-  CORE_PRESET_IDS,
   LIBRARY_LUT_OFFLINE_CODE,
+  RESOLVABLE_PRESET_IDS,
   freezeLibraryLut,
   matchColorLook,
   readBundledLutIndex,
@@ -35,6 +35,13 @@ test("high contrast punchy resolves to deep-contrast", () => {
   assert.equal(matchColorLook("high contrast punchy").preset, "deep-contrast");
 });
 
+test("removed preset phrases resolve to surviving looks", () => {
+  assert.equal(matchColorLook("natural lift").preset, "soft-boost");
+  assert.equal(matchColorLook("fresh pop").preset, "bright-pop");
+  assert.equal(matchColorLook("warm clean").preset, "warm-daylight");
+  assert.equal(matchColorLook("cool clean").preset, "clean-studio");
+});
+
 test("library look freezes a validated cube from params offline (--local-only)", async () => {
   const projectDir = mkdtempSync(join(tmpdir(), "mu-lut-provider-"));
   try {
@@ -53,9 +60,13 @@ test("library look freezes a validated cube from params offline (--local-only)",
   }
 });
 
-test("preset IDs stay in sync with packages/core/src/colorGrading.ts", () => {
-  assert.deepEqual(CORE_PRESET_IDS, corePresetIdsFromSource());
-  for (const id of CORE_PRESET_IDS) {
+test("every resolver preset exists in packages/core/src/colorGrading.ts", () => {
+  const corePresetIds = corePresetIdsFromSource();
+  assert.deepEqual(
+    RESOLVABLE_PRESET_IDS.filter((id) => !corePresetIds.includes(id)),
+    [],
+  );
+  for (const id of RESOLVABLE_PRESET_IDS) {
     const match = matchColorLook(id);
     assert.equal(match.kind, "preset");
     assert.equal(match.preset, id);

From 7778c093b6288756cf5e27311828e6049e7c85c3 Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Fri, 24 Jul 2026 13:35:10 -0400
Subject: [PATCH 046/125] fix(preview): serve external symlink assets (#2764)

## What

Allow Studio Preview to serve an asset reached through a project-local symlink whose target is in a shared directory outside the project, including browser-hostile video assets that need an authoring proxy.

## Why

Preview rejected these assets with a 404 while the renderer accepted the same path. The initial static-route fix still failed for HEVC, ProRes, AV1, and VP9 assets because the proxy transcoder rejected the external target.

## How

Use lexical project-root containment for the read-only static asset route and proxy source request. The transcoder canonicalizes the target for ffmpeg and includes that identity in its cache key, while keeping the proxy cache inside the project. Composition source paths retain canonical containment because preview can persist their data-hf-id values.

## Test plan

- [x] Unit tests added/updated
- [x] `bun run --cwd packages/studio-server test` (397 tests)
- [x] Studio Server typecheck, oxlint, and oxfmt
- [x] External-symlinked hostile-video proxy route regression
- [x] Static-route traversal regression
- [ ] Documentation updated (not applicable)
---
 packages/lint/src/project.test.ts             | 24 ++++++-
 .../src/helpers/proxyTranscoder.test.ts       | 18 +++--
 .../src/helpers/proxyTranscoder.ts            | 47 +++++++++----
 .../studio-server/src/routes/preview.test.ts  | 70 +++++++++++++++++++
 packages/studio-server/src/routes/preview.ts  | 10 ++-
 5 files changed, 146 insertions(+), 23 deletions(-)

diff --git a/packages/lint/src/project.test.ts b/packages/lint/src/project.test.ts
index 64440e8e60..aca134326e 100644
--- a/packages/lint/src/project.test.ts
+++ b/packages/lint/src/project.test.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect, afterEach, beforeEach, vi } from "vitest";
 import { ChildProcess, execFile } from "node:child_process";
-import { mkdirSync, mkdtempSync, writeFileSync, rmSync } from "node:fs";
+import { mkdirSync, mkdtempSync, writeFileSync, rmSync, symlinkSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 import type { HyperframeLintFinding } from "./types.js";
@@ -47,6 +47,28 @@ afterEach(() => {
   dirs = [];
 });
 
+describe("external symlink assets", () => {
+  it("does not report a shared asset addressed through an in-project symlink", async () => {
+    const project = makeProject(
+      validHtml().replace("</div>", '<img src="assets/shared/sample.svg" /></div>'),
+    );
+    const externalDir = tmpProject("shared-assets");
+    dirs.push(externalDir);
+    mkdirSync(join(project, "assets"));
+    writeFileSync(join(externalDir, "sample.svg"), "<svg>shared</svg>");
+    try {
+      symlinkSync(externalDir, join(project, "assets", "shared"), "dir");
+    } catch {
+      return;
+    }
+
+    const { results } = await lintProject(project);
+    const findings = results.flatMap((result) => result.result.findings);
+
+    expect(findings.some((finding) => finding.code === "missing_local_asset")).toBe(false);
+  });
+});
+
 describe("missing_or_empty_sub_composition", () => {
   function htmlWithSubComp(srcPath: string): string {
     return `<html><body>
diff --git a/packages/studio-server/src/helpers/proxyTranscoder.test.ts b/packages/studio-server/src/helpers/proxyTranscoder.test.ts
index e335b2e4f4..2c52d5b6f3 100644
--- a/packages/studio-server/src/helpers/proxyTranscoder.test.ts
+++ b/packages/studio-server/src/helpers/proxyTranscoder.test.ts
@@ -3,6 +3,7 @@ import {
   existsSync,
   mkdtempSync,
   readdirSync,
+  realpathSync,
   rmSync,
   symlinkSync,
   utimesSync,
@@ -497,9 +498,9 @@ describe("resolveProxy", () => {
     expect(calls).toHaveLength(0);
   });
 
-  it("rejects an in-project symlink whose target escapes the project", async () => {
+  it("proxies an external target reached through an in-project symlink", async () => {
     const { spawn, calls } = createSpawnSpy();
-    const { resolveProxy, ProxySourceOutsideProjectError } = await loadModule(spawn, FFMPEG_PATH);
+    const { resolveProxy, getProxyCachePath } = await loadModule(spawn, FFMPEG_PATH);
     const projectDir = tmpProject();
     const outsideDir = tmpProject();
     const outsidePath = join(outsideDir, "outside.mov");
@@ -507,10 +508,15 @@ describe("resolveProxy", () => {
     writeFileSync(outsidePath, "source-bytes");
     symlinkSync(outsidePath, sourcePath);
 
-    await expect(resolveProxy(projectDir, sourcePath)).rejects.toBeInstanceOf(
-      ProxySourceOutsideProjectError,
-    );
-    expect(calls).toHaveLength(0);
+    const cachePath = getProxyCachePath(projectDir, sourcePath);
+    const result = resolveProxy(projectDir, sourcePath);
+    await flush();
+
+    expect(calls).toHaveLength(1);
+    expect(calls[0]?.args).toContain(realpathSync(outsidePath));
+    succeed(calls[0]!);
+    await expect(result).resolves.toBe(cachePath);
+    expect(cachePath.startsWith(join(realpathSync(projectDir), ".transcode-cache"))).toBe(true);
   });
 
   it("retries after the source file changes (mtime in the cache key invalidates the remembered failure)", async () => {
diff --git a/packages/studio-server/src/helpers/proxyTranscoder.ts b/packages/studio-server/src/helpers/proxyTranscoder.ts
index 097453df67..c8ad030e1b 100644
--- a/packages/studio-server/src/helpers/proxyTranscoder.ts
+++ b/packages/studio-server/src/helpers/proxyTranscoder.ts
@@ -9,7 +9,7 @@ import {
   unlinkSync,
   utimesSync,
 } from "node:fs";
-import { basename, dirname, isAbsolute, join, relative, sep } from "node:path";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { findFfBinary } from "@hyperframes/parsers/ff-binaries";
 import { probeMediaMetadata } from "./mediaMetadata.js";
 import { cleanupProxyCache } from "./proxyCache.js";
@@ -96,7 +96,7 @@ export class ProxyCapacityError extends ProxyTranscodeError {
 
 export class ProxySourceOutsideProjectError extends ProxyTranscodeError {
   constructor() {
-    super("media proxy source must be inside the project", null, "");
+    super("media proxy source must be addressed through the project", null, "");
     this.name = "ProxySourceOutsideProjectError";
   }
 }
@@ -129,33 +129,52 @@ export async function waitForProxy<T>(
 }
 
 /**
- * Cache key inputs per the plan: source path relative to the project (so the
- * cache is portable across checkouts at different absolute locations), mtime
- * and file size (mtime alone can collide on same-second re-exports on
- * coarse-timestamp filesystems; size catches nearly all such cases at zero
- * cost), and a params version token so changing the ffmpeg recipe below
- * invalidates every cached proxy cleanly.
+ * Cache key inputs per the plan: project-relative source path (portable across
+ * checkouts), canonical source identity (so retargeted external symlinks do
+ * not reuse a proxy), mtime and file size (mtime alone can collide on
+ * same-second re-exports on coarse-timestamp filesystems; size catches nearly
+ * all such cases at zero cost), and a params version token so changing the
+ * ffmpeg recipe below invalidates every cached proxy cleanly.
  */
 type CanonicalProxySource = {
   projectDir: string;
   sourcePath: string;
   relativePath: string;
+  cacheIdentity: string;
 };
 
 function canonicalizeProxySource(
   projectDir: string,
   absoluteSourcePath: string,
 ): CanonicalProxySource {
-  const canonicalProjectDir = realpathSync(projectDir);
-  const canonicalSourcePath = realpathSync(absoluteSourcePath);
-  const relPath = relative(canonicalProjectDir, canonicalSourcePath);
-  if (relPath === ".." || relPath.startsWith(`..${sep}`) || isAbsolute(relPath)) {
+  const requestedProjectDir = resolve(projectDir);
+  const requestedSourcePath = resolve(absoluteSourcePath);
+  const requestedRelativePath = relative(requestedProjectDir, requestedSourcePath);
+  if (
+    requestedRelativePath === ".." ||
+    requestedRelativePath.startsWith(`..${sep}`) ||
+    isAbsolute(requestedRelativePath)
+  ) {
     throw new ProxySourceOutsideProjectError();
   }
+
+  const canonicalProjectDir = realpathSync(projectDir);
+  const canonicalSourcePath = realpathSync(absoluteSourcePath);
+  const canonicalRelativePath = relative(canonicalProjectDir, canonicalSourcePath);
+  const sourceIsInsideCanonicalProject =
+    canonicalRelativePath !== ".." &&
+    !canonicalRelativePath.startsWith(`..${sep}`) &&
+    !isAbsolute(canonicalRelativePath);
   return {
     projectDir: canonicalProjectDir,
     sourcePath: canonicalSourcePath,
-    relativePath: relPath.normalize("NFC"),
+    relativePath: requestedRelativePath.normalize("NFC"),
+    // An external target needs a stable identity in addition to its project-local
+    // symlink path, otherwise retargeting the link can reuse an unrelated proxy.
+    cacheIdentity: (sourceIsInsideCanonicalProject
+      ? canonicalRelativePath
+      : canonicalSourcePath
+    ).normalize("NFC"),
   };
 }
 
@@ -163,7 +182,7 @@ function buildProxyCacheKey(source: CanonicalProxySource, variant: ProxyVariant)
   const stat = statSync(source.sourcePath);
   return createHash("sha256")
     .update(
-      `${source.relativePath}\0${stat.mtimeMs}\0${stat.size}\0${PROXY_PARAMS_VERSION}\0${variant}`,
+      `${source.relativePath}\0${source.cacheIdentity}\0${stat.mtimeMs}\0${stat.size}\0${PROXY_PARAMS_VERSION}\0${variant}`,
     )
     .digest("hex");
 }
diff --git a/packages/studio-server/src/routes/preview.test.ts b/packages/studio-server/src/routes/preview.test.ts
index 257e747dbf..cde15caca3 100644
--- a/packages/studio-server/src/routes/preview.test.ts
+++ b/packages/studio-server/src/routes/preview.test.ts
@@ -516,6 +516,31 @@ describe("hf-id surfacing in preview route", () => {
     expect(readFileSync(svgPath, "utf-8")).toBe(svgBytes);
   });
 
+  it("serves an asset reached through an in-project symlink to a shared external directory", async () => {
+    const projectDir = createProjectDir();
+    const externalDir = mkdtempSync(join(tmpdir(), "hf-preview-shared-assets-"));
+    tempDirs.push(externalDir);
+    mkdirSync(join(projectDir, "assets"));
+    writeFileSync(join(externalDir, "sample.svg"), "<svg>shared</svg>");
+    if (!tryCreateSymlink(externalDir, join(projectDir, "assets", "shared"), "dir")) return;
+
+    const app = new Hono();
+    registerPreviewRoutes(app, createAdapter(projectDir));
+
+    const response = await app.request(
+      "http://localhost/projects/demo/preview/assets/shared/sample.svg",
+    );
+
+    expect(response.status).toBe(200);
+    expect(response.headers.get("content-type")).toContain("image/svg+xml");
+    expect(await response.text()).toBe("<svg>shared</svg>");
+
+    const traversal = await app.request(
+      "http://localhost/projects/demo/preview/..%2f..%2f..%2fetc%2fpasswd",
+    );
+    expect(traversal.status).toBe(404);
+  });
+
   it("sub-comp route does NOT persist ids inside a plain <template> (runtime clone-source)", async () => {
     const { readFileSync } = await import("node:fs");
     const projectDir = createProjectDir();
@@ -1077,6 +1102,51 @@ describe("hf-proxy negotiation and media codec map injection (U3)", () => {
       );
     });
 
+    it("injects and serves a proxy for a hostile video through an external asset symlink", async () => {
+      const projectDir = createProjectDir();
+      const externalDir = mkdtempSync(join(tmpdir(), "hf-preview-shared-video-"));
+      tempDirs.push(externalDir);
+      mkdirSync(join(projectDir, "assets"));
+      writeFileSync(join(externalDir, "clip.mov"), "shared-hevc-bytes");
+      if (!tryCreateSymlink(externalDir, join(projectDir, "assets", "shared"), "dir")) return;
+
+      const proxyPath = join(projectDir, ".transcode-cache", "shared.mp4");
+      const resolveProxyMock = vi.fn(async () => {
+        mkdirSync(join(projectDir, ".transcode-cache"), { recursive: true });
+        writeFileSync(proxyPath, "proxy-bytes");
+        return proxyPath;
+      });
+      const scanMapMock = vi.fn(async () => ({
+        "/assets/shared/clip.mov": {
+          codecName: "hevc",
+          browserHostile: true,
+          representativeMime: 'video/mp4; codecs="hvc1.1.6.L120.B0"',
+        },
+      }));
+      const { registerPreviewRoutes: register } = await loadPreviewModule({
+        resolveProxyImpl: resolveProxyMock,
+        scanMapImpl: scanMapMock,
+      });
+      const app = new Hono();
+      register(app, createAdapter(projectDir));
+
+      const preview = await app.request("http://localhost/projects/demo/preview");
+      expect(await preview.text()).toContain("/assets/shared/clip.mov");
+      expect(scanMapMock).toHaveBeenCalled();
+
+      const proxied = await app.request(
+        "http://localhost/projects/demo/preview/assets/shared/clip.mov?hf-proxy=h264",
+      );
+      expect(proxied.status).toBe(200);
+      expect(proxied.headers.get("Content-Type")).toBe("video/mp4");
+      expect(await proxied.text()).toBe("proxy-bytes");
+      expect(resolveProxyMock).toHaveBeenCalledWith(
+        projectDir,
+        join(projectDir, "assets", "shared", "clip.mov"),
+        "h264",
+      );
+    });
+
     it("escapes script terminators and JavaScript line separators in codec-map keys", async () => {
       const projectDir = createProjectDir();
       const { registerPreviewRoutes: register } = await loadPreviewModule({
diff --git a/packages/studio-server/src/routes/preview.ts b/packages/studio-server/src/routes/preview.ts
index 78d4210339..864af351bd 100644
--- a/packages/studio-server/src/routes/preview.ts
+++ b/packages/studio-server/src/routes/preview.ts
@@ -1,8 +1,9 @@
 import type { Hono } from "hono";
 import { existsSync, readFileSync, statSync } from "node:fs";
-import { join } from "node:path";
+import { join, resolve } from "node:path";
 import { createHash } from "node:crypto";
 import { injectScriptsIntoHtml, stripEmbeddedRuntimeScripts } from "@hyperframes/core/compiler";
+import { isWithinProjectRoot } from "@hyperframes/parsers/asset-resolution";
 import type { StudioApiAdapter } from "../types.js";
 import { resolveWithinProject } from "../helpers/safePath.js";
 import { getMimeType } from "../helpers/mime.js";
@@ -528,7 +529,12 @@ export function registerPreviewRoutes(api: Hono, adapter: PreviewApiAdapter): vo
     const subPath = decodeURIComponent(
       c.req.path.replace(`/projects/${project.id}/preview/`, "").split("?")[0] ?? "",
     );
-    const file = resolveWithinProject(project.dir, subPath);
+    // Assets are read-only and should mirror the renderer: permit a path that
+    // is lexically inside the project even if an explicit project symlink
+    // targets a shared directory outside it. Composition source files still
+    // use resolveWithinProject because preview mutates their data-hf-id values.
+    const candidate = resolve(project.dir, subPath);
+    const file = isWithinProjectRoot(project.dir, candidate) ? candidate : null;
     if (!file) {
       return c.text("not found", 404);
     }

From 944640c3283d604383fd437fcca8c63941d8e3d7 Mon Sep 17 00:00:00 2001
From: ukimsanov <ular.kimsanov@heygen.com>
Date: Thu, 23 Jul 2026 21:22:37 -0700
Subject: [PATCH 047/125] feat(runtime): render media treatments
 deterministically

---
 packages/core/src/colorGrading.test.ts        |   27 +
 .../core/src/runtime/colorGrading.test.ts     |  784 +++++-
 packages/core/src/runtime/colorGrading.ts     | 2138 +++++++++++++++--
 packages/core/src/runtime/init.test.ts        |   77 +
 packages/core/src/runtime/init.ts             |   13 +-
 packages/engine/src/services/frameCapture.ts  |    8 +
 .../src/services/screenshotService.test.ts    |   21 +-
 .../engine/src/services/screenshotService.ts  |   18 +-
 .../engine/src/services/videoFrameInjector.ts |   20 -
 packages/lint/src/rules/media.test.ts         |  108 +
 packages/lint/src/rules/media.ts              |   54 +
 packages/parsers/src/colorGradingContract.ts  |   30 +-
 packages/parsers/src/gsapParser.test.ts       |    3 +-
 13 files changed, 2993 insertions(+), 308 deletions(-)

diff --git a/packages/core/src/colorGrading.test.ts b/packages/core/src/colorGrading.test.ts
index 6085768709..ff2b7f8972 100644
--- a/packages/core/src/colorGrading.test.ts
+++ b/packages/core/src/colorGrading.test.ts
@@ -13,6 +13,7 @@ import {
   normalizeHfColorGradingWithVariables,
   serializeHfColorGrading,
 } from "./colorGrading";
+import { lintHyperframeHtml } from "./lint";
 
 describe("color grading", () => {
   it("derives grade and effect preset views from their actual payloads", () => {
@@ -28,6 +29,32 @@ describe("color grading", () => {
     expect(HF_COLOR_GRADING_PRESETS).toHaveLength(18);
   });
 
+  it("keeps every canonical grading key accepted by lint", async () => {
+    const grading = normalizeHfColorGrading("neutral");
+    expect(grading).not.toBeNull();
+    const html = (attribute: string) => `
+      <html><body>
+        <div id="root" data-composition-id="c1" data-start="0" data-width="1920" data-height="1080" data-duration="1">
+          <img class="clip" data-start="0" data-duration="1" src="media.jpg" data-color-grading='${attribute}'>
+        </div>
+        <script>window.__timelines = {};</script>
+      </body></html>
+    `;
+
+    const valid = await lintHyperframeHtml(html(serializeHfColorGrading(grading)));
+    expect(valid.findings.filter((finding) => finding.severity === "error")).toEqual([]);
+
+    const invalid = await lintHyperframeHtml(html('{"effects":{"notARealEffect":1}}'));
+    expect(invalid.findings).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          code: "color_grading_invalid_structure",
+          severity: "error",
+        }),
+      ]),
+    );
+  });
+
   it("parses preset shorthand", () => {
     const grading = normalizeHfColorGrading("warm-daylight");
     expect(grading?.preset).toBe("warm-daylight");
diff --git a/packages/core/src/runtime/colorGrading.test.ts b/packages/core/src/runtime/colorGrading.test.ts
index a02d6bdb30..a2be6c460e 100644
--- a/packages/core/src/runtime/colorGrading.test.ts
+++ b/packages/core/src/runtime/colorGrading.test.ts
@@ -11,6 +11,7 @@ let lastUniform1f: ReturnType<typeof vi.fn> | null = null;
 let lastUniform3f: ReturnType<typeof vi.fn> | null = null;
 let lastShaderSources: string[] = [];
 let texImage2DCalls: unknown[][] = [];
+let loseContextCalls = 0;
 
 const IDENTITY_2 = `
 LUT_3D_SIZE 2
@@ -24,7 +25,9 @@ LUT_3D_SIZE 2
 1 1 1
 `;
 
-function createMockWebGl(options: { failMediaUpload?: boolean } = {}): WebGLRenderingContext {
+function createMockWebGl(
+  options: { failMediaUpload?: boolean; halfFloatSupported?: boolean } = {},
+): WebGLRenderingContext {
   const shader = {};
   const program = {};
   const texture = {};
@@ -54,6 +57,7 @@ function createMockWebGl(options: { failMediaUpload?: boolean } = {}): WebGLRend
     TEXTURE1: 0x84c1,
     TEXTURE2: 0x84c2,
     TEXTURE3: 0x84c3,
+    TEXTURE4: 0x84c4,
     FLOAT: 0x1406,
     TRIANGLE_STRIP: 0x0005,
     UNPACK_FLIP_Y_WEBGL: 0x9240,
@@ -88,6 +92,14 @@ function createMockWebGl(options: { failMediaUpload?: boolean } = {}): WebGLRend
     framebufferTexture2D: vi.fn(),
     checkFramebufferStatus: vi.fn(() => 0x8cd5),
     deleteFramebuffer: vi.fn(),
+    getExtension: vi.fn((name: string) => {
+      if (name === "WEBGL_lose_context") {
+        return { loseContext: () => (loseContextCalls += 1) };
+      }
+      if (options.halfFloatSupported === false) return null;
+      if (name === "OES_texture_half_float") return { HALF_FLOAT_OES: 0x8d61 };
+      return name === "EXT_color_buffer_half_float" ? {} : null;
+    }),
     createBuffer: vi.fn(() => buffer),
     bindBuffer: vi.fn(),
     bufferData: vi.fn(),
@@ -138,6 +150,21 @@ function makeDrawableVideo(): HTMLVideoElement {
   return video;
 }
 
+function makeDrawableImage(): HTMLImageElement {
+  const image = document.createElement("img");
+  image.id = "hero-image";
+  image.setAttribute(HF_COLOR_GRADING_ATTR, serializeHfColorGrading({ effects: { blur: 0 } }));
+  image.style.setProperty("--hf-color-grading-blur", "0");
+  Object.defineProperty(image, "complete", { value: true, configurable: true });
+  Object.defineProperty(image, "naturalWidth", { value: 640, configurable: true });
+  Object.defineProperty(image, "naturalHeight", { value: 360, configurable: true });
+  Object.defineProperty(image, "offsetWidth", { value: 640, configurable: true });
+  Object.defineProperty(image, "offsetHeight", { value: 360, configurable: true });
+  image.getBoundingClientRect = () =>
+    ({ width: 640, height: 360, left: 0, top: 0, right: 640, bottom: 360 }) as DOMRect;
+  return image;
+}
+
 function stubCubeLutFetch(text = IDENTITY_2): ReturnType<typeof vi.fn> {
   const fetchMock = vi.fn(() =>
     Promise.resolve({
@@ -160,6 +187,7 @@ describe("createColorGradingRuntime", () => {
     lastUniform3f = null;
     lastShaderSources = [];
     texImage2DCalls = [];
+    loseContextCalls = 0;
     getContextSpy = vi
       .spyOn(HTMLCanvasElement.prototype, "getContext")
       .mockImplementation((type: string) =>
@@ -174,6 +202,7 @@ describe("createColorGradingRuntime", () => {
     getContextSpy.mockRestore();
     delete window.__hfVariables;
     delete window.__hfVariablesByComp;
+    delete window.__player;
     document.head.innerHTML = "";
     document.body.innerHTML = "";
   });
@@ -189,6 +218,32 @@ describe("createColorGradingRuntime", () => {
     return { video, canvas };
   }
 
+  it.each([
+    { pixelRatio: 1, width: 640, height: 360 },
+    { pixelRatio: 2, width: 1280, height: 720 },
+  ])(
+    "matches the WebGL drawing buffer to the displayed media at DPR $pixelRatio",
+    ({ pixelRatio, width, height }) => {
+      vi.stubGlobal("devicePixelRatio", pixelRatio);
+
+      const { canvas } = startRuntimeWithVideo();
+
+      expect(canvas.style.width).toBe("640px");
+      expect(canvas.style.height).toBe("360px");
+      expect(canvas.width).toBe(width);
+      expect(canvas.height).toBe(height);
+    },
+  );
+
+  it("uses the default non-preserved drawing buffer outside capture instrumentation", () => {
+    startRuntimeWithVideo();
+
+    expect(getContextSpy).toHaveBeenCalledWith("webgl", {
+      alpha: true,
+      premultipliedAlpha: false,
+    });
+  });
+
   async function flushLutLoad(): Promise<void> {
     await Promise.resolve();
     await Promise.resolve();
@@ -250,7 +305,7 @@ describe("createColorGradingRuntime", () => {
     expect(texImage2DCalls.length).toBe(drawsBefore);
   });
 
-  it("re-hides source media after timeline visibility sync", () => {
+  it("releases inactive attribute grading and recreates it when visible", () => {
     const { video, canvas } = startRuntimeWithVideo();
 
     expect(canvas.id).toBe("__hf_color_grading_hero-video");
@@ -261,23 +316,177 @@ describe("createColorGradingRuntime", () => {
     expect(canvas?.style.visibility).toBe("visible");
     expect(canvas?.style.opacity).toBe("1");
 
+    video.style.visibility = "hidden";
+    expect(runtime.setSourceVisibility(video, false)).toBe(true);
+
+    expect(video.style.getPropertyValue("visibility")).toBe("hidden");
+    expect(video.style.getPropertyValue("opacity")).toBe("");
+    expect(video.hasAttribute("data-hf-color-grading-source-hidden")).toBe(false);
+    expect(canvas.isConnected).toBe(false);
+
     video.style.visibility = "visible";
-    runtime.setSourceVisibility(video, true);
-    runtime.redraw();
+    expect(runtime.setSourceVisibility(video, true)).toBe(true);
 
-    expect(video.style.getPropertyValue("visibility")).toBe("visible");
+    const recreated = document.querySelector<HTMLCanvasElement>("[data-hf-color-grading-canvas]");
+    expect(recreated).not.toBeNull();
+    expect(recreated).toBe(canvas);
+    expect(getContextSpy).toHaveBeenCalledTimes(1);
     expect(video.style.getPropertyValue("opacity")).toBe("0");
     expect(video.style.getPropertyPriority("opacity")).toBe("important");
-    expect(canvas?.style.visibility).toBe("visible");
+  });
 
-    video.style.visibility = "hidden";
-    runtime.setSourceVisibility(video, false);
-    runtime.redraw();
+  it("defers WebGL setup for hidden attributed media until it becomes visible", () => {
+    const video = makeDrawableVideo();
+    video.style.display = "none";
+    document.body.appendChild(video);
 
-    expect(video.style.getPropertyValue("visibility")).toBe("hidden");
-    expect(video.style.getPropertyValue("opacity")).toBe("0");
-    expect(video.style.getPropertyPriority("opacity")).toBe("important");
-    expect(canvas?.style.visibility).toBe("hidden");
+    runtime = createColorGradingRuntime();
+
+    expect(getContextSpy).not.toHaveBeenCalled();
+    expect(document.querySelector("[data-hf-color-grading-canvas]")).toBeNull();
+    expect(runtime.getStatus(video)).toEqual({
+      state: "pending",
+      message: "Waiting for visible media",
+    });
+
+    video.style.display = "block";
+    expect(runtime.setSourceVisibility(video, true)).toBe(true);
+    expect(getContextSpy).toHaveBeenCalledTimes(1);
+    expect(document.querySelector("[data-hf-color-grading-canvas]")).not.toBeNull();
+  });
+
+  it("renders exact preset previews for ungraded media without replacing the source", async () => {
+    const video = makeDrawableVideo();
+    video.removeAttribute(HF_COLOR_GRADING_ATTR);
+    document.body.appendChild(video);
+    const toDataUrl = vi
+      .spyOn(HTMLCanvasElement.prototype, "toDataURL")
+      .mockReturnValue("data:image/png;base64,preview");
+    runtime = createColorGradingRuntime();
+
+    const batch = await runtime.renderPreviews(
+      "#hero-video",
+      [
+        { id: "clean", grading: "clean-studio" },
+        { id: "warm", grading: "warm-daylight" },
+      ],
+      { maxDimension: 160 },
+    );
+
+    expect(batch).toMatchObject({
+      width: 160,
+      height: 90,
+      images: [
+        { id: "clean", dataUrl: "data:image/png;base64,preview" },
+        { id: "warm", dataUrl: "data:image/png;base64,preview" },
+      ],
+    });
+    expect(getContextSpy).toHaveBeenCalledTimes(1);
+    expect(document.querySelector("[data-hf-color-grading-canvas]")).toBeNull();
+    expect(video.style.opacity).toBe("");
+
+    await runtime.renderPreviews("#hero-video", [{ id: "mono", grading: "mono-clean" }]);
+    expect(getContextSpy).toHaveBeenCalledTimes(1);
+
+    const retinaBatch = await runtime.renderPreviews(
+      "#hero-video",
+      [{ id: "retina", grading: "neutral" }],
+      { maxDimension: 400 },
+    );
+    expect(retinaBatch).toMatchObject({ width: 320, height: 180 });
+    toDataUrl.mockRestore();
+  });
+
+  it("plays only a selected video for preview and restores its media state", () => {
+    const video = makeDrawableVideo();
+    let paused = true;
+    Object.defineProperty(video, "paused", { configurable: true, get: () => paused });
+    Object.defineProperty(video, "currentTime", {
+      configurable: true,
+      value: 3.25,
+      writable: true,
+    });
+    Object.defineProperty(video, "duration", { configurable: true, value: 10 });
+    const play = vi.spyOn(video, "play").mockImplementation(() => {
+      paused = false;
+      return Promise.resolve();
+    });
+    const pause = vi.spyOn(video, "pause").mockImplementation(() => {
+      paused = true;
+    });
+    video.loop = false;
+    video.muted = false;
+    document.body.appendChild(video);
+    runtime = createColorGradingRuntime();
+
+    const stop = runtime.startPreviewPlayback("#hero-video");
+
+    expect(stop).not.toBeNull();
+    expect(play).toHaveBeenCalledTimes(1);
+    expect(video.loop).toBe(true);
+    expect(video.muted).toBe(true);
+    video.currentTime = 6;
+    stop?.();
+    expect(pause).toHaveBeenCalledTimes(1);
+    expect(video.currentTime).toBe(3.25);
+    expect(video.loop).toBe(false);
+    expect(video.muted).toBe(false);
+  });
+
+  it("does not start preview playback for an image", () => {
+    const image = makeDrawableImage();
+    document.body.appendChild(image);
+    runtime = createColorGradingRuntime();
+
+    expect(runtime.startPreviewPlayback("#hero-image")).toBeNull();
+  });
+
+  it("uses selected-video time for isolated animated preview frames", async () => {
+    const video = makeDrawableVideo();
+    Object.defineProperty(video, "currentTime", { configurable: true, value: 6.5 });
+    document.body.appendChild(video);
+    window.__player = { getTime: () => 1.25 };
+    vi.spyOn(HTMLCanvasElement.prototype, "toDataURL").mockReturnValue(
+      "data:image/png;base64,preview",
+    );
+    runtime = createColorGradingRuntime();
+
+    await runtime.renderPreviews("#hero-video", [{ id: "vhs", grading: { effects: { vhs: 1 } } }], {
+      maxDimension: 160,
+      useMediaTime: true,
+    });
+
+    expect(lastUniform1f?.mock.calls).toContainEqual(["u_effectTime", 6.5]);
+  });
+
+  it("uses the LUT cache and canonical multipass renderer in preview batches", async () => {
+    const video = makeDrawableVideo();
+    video.removeAttribute(HF_COLOR_GRADING_ATTR);
+    document.body.appendChild(video);
+    const fetchMock = stubCubeLutFetch();
+    const toDataUrl = vi
+      .spyOn(HTMLCanvasElement.prototype, "toDataURL")
+      .mockReturnValue("data:image/png;base64,lut-preview");
+    runtime = createColorGradingRuntime();
+
+    const batch = await runtime.renderPreviews("#hero-video", [
+      {
+        id: "lut",
+        grading: { preset: "warm-daylight", lut: { src: "/looks/test.cube", intensity: 0.6 } },
+      },
+      { id: "blur", grading: { effects: { blur: 0.5 } } },
+      { id: "bloom", grading: { effects: { bloom: 0.5, bloomRadius: 8 } } },
+      { id: "kuwahara", grading: { effects: { kuwahara: 1, kuwaharaRadius: 0.25 } } },
+    ]);
+
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    expect(batch?.images).toEqual([
+      { id: "lut", dataUrl: "data:image/png;base64,lut-preview" },
+      { id: "blur", dataUrl: "data:image/png;base64,lut-preview" },
+      { id: "bloom", dataUrl: "data:image/png;base64,lut-preview" },
+      { id: "kuwahara", dataUrl: "data:image/png;base64,lut-preview" },
+    ]);
+    toDataUrl.mockRestore();
   });
 
   it("resolves grading values from the nearest sub-composition variable scope", () => {
@@ -323,6 +532,151 @@ describe("createColorGradingRuntime", () => {
     expect(lastUniform1f).toHaveBeenCalledWith("u_exposure", 0.35);
   });
 
+  it("samples seek-derived grading values from inline CSS properties on every redraw", () => {
+    const video = makeDrawableVideo();
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({
+        adjust: { exposure: 0.5 },
+        effects: {
+          blur: 0.2,
+          bloom: 0.2,
+          kuwahara: 0.2,
+          pixelate: 0.3,
+          ascii: 0.4,
+          dither: 0.5,
+        },
+        lut: { src: "assets/luts/test.cube", intensity: 0.4 },
+      }),
+    );
+    video.style.setProperty("--hf-color-grading-intensity", "0.25");
+    video.style.setProperty("--hf-color-grading-lut-intensity", "0.35");
+    video.style.setProperty("--hf-color-grading-exposure", "-0.15");
+    video.style.setProperty("--hf-color-grading-blur", "0.45");
+    video.style.setProperty("--hf-color-grading-bloom", "0.45");
+    video.style.setProperty("--hf-color-grading-kuwahara", "0.45");
+    video.style.setProperty("--hf-color-grading-pixelate", "0.55");
+    video.style.setProperty("--hf-color-grading-ascii", "0.65");
+    video.style.setProperty("--hf-color-grading-dither", "0.75");
+    stubCubeLutFetch();
+    startRuntimeWithVideo(video);
+
+    if (!lastUniform1f) throw new Error("Expected WebGL uniform calls");
+    expect(lastUniform1f).toHaveBeenCalledWith("u_intensity", 0.25);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_lutIntensity", 0.35);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_exposure", -0.15);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_blur", 0.45);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_bloom", 0.45);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwahara", 0.45);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_pixelate", 0.55);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_ascii", 0.65);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_dither", 0.75);
+
+    video.style.setProperty("--hf-color-grading-intensity", "0.75");
+    video.style.setProperty("--hf-color-grading-lut-intensity", "0.65");
+    video.style.setProperty("--hf-color-grading-exposure", "0.15");
+    video.style.setProperty("--hf-color-grading-blur", "0.15");
+    video.style.setProperty("--hf-color-grading-bloom", "0.15");
+    video.style.setProperty("--hf-color-grading-kuwahara", "0.15");
+    video.style.setProperty("--hf-color-grading-pixelate", "0.05");
+    video.style.setProperty("--hf-color-grading-ascii", "0.15");
+    video.style.setProperty("--hf-color-grading-dither", "0.25");
+    lastUniform1f.mockClear();
+    runtime?.redraw();
+
+    expect(lastUniform1f).toHaveBeenCalledWith("u_intensity", 0.75);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_lutIntensity", 0.65);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_exposure", 0.15);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_blur", 0.15);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_bloom", 0.15);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwahara", 0.15);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_pixelate", 0.05);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_ascii", 0.15);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_dither", 0.25);
+
+    video.style.setProperty("--hf-color-grading-intensity", "invalid");
+    video.style.setProperty("--hf-color-grading-lut-intensity", "2");
+    video.style.setProperty("--hf-color-grading-exposure", "-3");
+    video.style.setProperty("--hf-color-grading-blur", "-1");
+    video.style.setProperty("--hf-color-grading-bloom", "invalid");
+    video.style.setProperty("--hf-color-grading-kuwahara", "invalid");
+    video.style.setProperty("--hf-color-grading-pixelate", "invalid");
+    video.style.setProperty("--hf-color-grading-ascii", "-1");
+    video.style.setProperty("--hf-color-grading-dither", "invalid");
+    lastUniform1f.mockClear();
+    runtime?.redraw();
+
+    expect(lastUniform1f).toHaveBeenCalledWith("u_intensity", 1);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_lutIntensity", 1);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_exposure", -2);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_blur", 0);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_bloom", 0.2);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwahara", 0.2);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_pixelate", 0.3);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_ascii", 0);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_dither", 0.5);
+  });
+
+  it("initializes a zero-start grade when an animated property declares future state", () => {
+    const video = makeDrawableVideo();
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({
+        intensity: 0,
+        adjust: { exposure: 0.5 },
+        effects: { kuwahara: 0 },
+      }),
+    );
+    video.style.setProperty("--hf-color-grading-intensity", "0");
+    video.style.setProperty("--hf-color-grading-kuwahara", "0");
+    document.body.appendChild(video);
+
+    runtime = createColorGradingRuntime();
+
+    expect(getContextSpy).toHaveBeenCalledTimes(1);
+    if (!lastUniform1f) throw new Error("Expected WebGL uniform calls");
+    expect(lastUniform1f).toHaveBeenCalledWith("u_intensity", 0);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwahara", 0);
+    expect(texImage2DCalls.some((args) => args.includes(0x8d61))).toBe(true);
+
+    video.style.setProperty("--hf-color-grading-intensity", "1");
+    video.style.setProperty("--hf-color-grading-kuwahara", "1");
+    lastUniform1f.mockClear();
+    runtime.redraw();
+
+    expect(lastUniform1f).toHaveBeenCalledWith("u_intensity", 1);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwahara", 1);
+  });
+
+  it("redraws animated still images from the transport tick", () => {
+    const image = makeDrawableImage();
+    document.body.appendChild(image);
+    runtime = createColorGradingRuntime();
+    image.style.setProperty("--hf-color-grading-blur", "0.7");
+    lastUniform1f?.mockClear();
+
+    expect(runtime.redrawAnimated()).toBe(1);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_blur", 0.7);
+  });
+
+  it("redraws animated held video frames without duplicating active video draws", () => {
+    const video = makeDrawableVideo();
+    video.style.setProperty("--hf-color-grading-blur", "0.1");
+    startRuntimeWithVideo(video);
+    Object.defineProperty(video, "paused", { value: false, configurable: true });
+    Object.defineProperty(video, "ended", { value: false, configurable: true });
+
+    expect(runtime?.redrawAnimated()).toBe(0);
+
+    Object.defineProperty(video, "paused", { value: true, configurable: true });
+    Object.defineProperty(video, "ended", { value: true, configurable: true });
+    video.style.setProperty("--hf-color-grading-blur", "0.8");
+    lastUniform1f?.mockClear();
+
+    expect(runtime?.redrawAnimated()).toBe(1);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_blur", 0.8);
+  });
+
   it("keeps the last shader frame visible while a video seek is waiting for a drawable frame", () => {
     const { video, canvas } = startRuntimeWithVideo();
 
@@ -373,6 +727,45 @@ describe("createColorGradingRuntime", () => {
     expect(canvas.style.opacity).toBe("0.75");
   });
 
+  it("allows a drawable producer render frame to initialize hidden source grading", () => {
+    const video = makeDrawableVideo();
+    video.style.display = "none";
+    document.body.appendChild(video);
+
+    const frame = document.createElement("img");
+    frame.id = "__render_frame_hero-video__";
+    frame.className = "__render_frame__";
+    frame.style.visibility = "visible";
+    Object.defineProperty(frame, "complete", { value: true, configurable: true });
+    Object.defineProperty(frame, "naturalWidth", { value: 640, configurable: true });
+    Object.defineProperty(frame, "naturalHeight", { value: 360, configurable: true });
+    video.after(frame);
+
+    runtime = createColorGradingRuntime();
+
+    expect(getContextSpy).toHaveBeenCalledTimes(1);
+    expect(document.querySelector("[data-hf-color-grading-canvas]")).not.toBeNull();
+  });
+
+  it("does not recreate an inactive clip from its hidden producer frame", () => {
+    const { video, canvas } = startRuntimeWithVideo();
+    const frame = document.createElement("img");
+    frame.id = "__render_frame_hero-video__";
+    frame.className = "__render_frame__";
+    frame.style.visibility = "hidden";
+    Object.defineProperty(frame, "complete", { value: true, configurable: true });
+    Object.defineProperty(frame, "naturalWidth", { value: 640, configurable: true });
+    Object.defineProperty(frame, "naturalHeight", { value: 360, configurable: true });
+    video.parentNode?.insertBefore(frame, canvas);
+
+    video.style.visibility = "hidden";
+    expect(runtime.setSourceVisibility(video, false)).toBe(true);
+    runtime.refresh();
+    expect(canvas.isConnected).toBe(false);
+    expect(getContextSpy).toHaveBeenCalledTimes(1);
+    expect(video.hasAttribute("data-hf-color-grading-source-hidden")).toBe(false);
+  });
+
   it("moves the canvas above producer render-frame images before capture", () => {
     const video = makeDrawableVideo();
     Object.defineProperty(video, "readyState", {
@@ -427,20 +820,82 @@ describe("createColorGradingRuntime", () => {
 
   it("passes finishing detail uniforms into the shader", () => {
     const video = makeDrawableVideo();
+    const details = {
+      vignette: 0.4,
+      vignetteMidpoint: 0.35,
+      vignetteRoundness: -0.25,
+      vignetteFeather: 0.8,
+      grain: 0.2,
+      grainSize: 0.7,
+      grainRoughness: 0.3,
+    };
+    const effects = {
+      blur: 0.3,
+      pixelate: 0.1,
+      chromaBleed: 0.25,
+      tapeDamage: 0.35,
+      tapeTracking: 0.45,
+      tapeNoise: 0.55,
+      tapeSpeed: 0.65,
+      filmArtifacts: 0.45,
+      halftone: 0.55,
+      halftoneSize: 0.65,
+      twoInkPrint: 0.75,
+      twoInkPrintSize: 0.85,
+      ascii: 0.6,
+      asciiSize: 0.4,
+      asciiInvert: 1,
+      dither: 0.7,
+      ditherSize: 0.3,
+      asciiStyle: 4,
+      asciiColor: 1,
+      asciiRotation: 1,
+      monoScreen: 0.2,
+      monoScreenSize: 0.3,
+      monoScreenAngle: 0.4,
+      monoScreenSpread: 0.5,
+      monoScreenShape: 3,
+      monoScreenInvert: 1,
+      scanlines: 0.25,
+      scanlineCount: 0.35,
+      scanlineSoftness: 0.45,
+      chromaticAberration: 0.3,
+      chromaticAngle: 0.4,
+      crtCurvature: 0.2,
+      digitalGlitch: 0.35,
+      digitalGlitchColorSplit: 0.4,
+      digitalGlitchLineTear: 0.45,
+      digitalGlitchPixelate: 0.5,
+      digitalGlitchBlockAmount: 0.55,
+      digitalGlitchBlockDisplacement: 0.65,
+      digitalGlitchBlockOpacity: 0.15,
+      digitalGlitchSpeed: 0.75,
+      engraving: 0.8,
+      engravingSpacing: 0.41,
+      engravingMinThickness: 0.2,
+      engravingMaxThickness: 0.46,
+      engravingAngle: 0.25,
+      engravingContrast: 0.47,
+      engravingSharpness: 0.59,
+      engravingWave: 0.2,
+      engravingWaveFrequency: 0.22,
+      crosshatch: 0.85,
+      crosshatchSpacing: 0.28,
+      crosshatchThickness: 0.25,
+      crosshatchAngle: 0.25,
+      crosshatchContrast: 0.33,
+      crosshatchEdges: 0.5,
+      crosshatchLineWeight: 0.15,
+      crosshatchWave: 0.33,
+      crosshatchWaveFrequency: 0.22,
+    };
     video.setAttribute(
       HF_COLOR_GRADING_ATTR,
       serializeHfColorGrading({
         adjust: { vibrance: 0.35 },
-        details: {
-          vignette: 0.4,
-          vignetteMidpoint: 0.35,
-          vignetteRoundness: -0.25,
-          vignetteFeather: 0.8,
-          grain: 0.2,
-          grainSize: 0.7,
-          grainRoughness: 0.3,
-        },
-        effects: { blur: 0.3, pixelate: 0.1 },
+        details,
+        effects,
+        palette: ["#080717", "#3c185f", "#d9339f", "#ff6b66"],
       }),
     );
     document.body.appendChild(video);
@@ -448,17 +903,192 @@ describe("createColorGradingRuntime", () => {
     runtime = createColorGradingRuntime();
 
     if (!lastUniform1f) throw new Error("Expected WebGL uniform calls");
-    expect(lastUniform1f).toHaveBeenCalledWith("u_vibrance", 0.35);
-    expect(lastUniform1f).toHaveBeenCalledWith("u_vignette", 0.4);
-    expect(lastUniform1f).toHaveBeenCalledWith("u_vignetteMidpoint", 0.35);
-    expect(lastUniform1f).toHaveBeenCalledWith("u_vignetteRoundness", -0.25);
-    expect(lastUniform1f).toHaveBeenCalledWith("u_vignetteFeather", 0.8);
-    expect(lastUniform1f).toHaveBeenCalledWith("u_grain", 0.2);
-    expect(lastUniform1f).toHaveBeenCalledWith("u_grainSize", 0.7);
-    expect(lastUniform1f).toHaveBeenCalledWith("u_grainRoughness", 0.3);
+    for (const [key, value] of Object.entries({ vibrance: 0.35, ...details, ...effects })) {
+      expect(lastUniform1f).toHaveBeenCalledWith(`u_${key}`, value);
+    }
     expect(lastUniform1f).toHaveBeenCalledWith("u_grainSeed", expect.any(Number));
-    expect(lastUniform1f).toHaveBeenCalledWith("u_blur", 0.3);
-    expect(lastUniform1f).toHaveBeenCalledWith("u_pixelate", 0.1);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_paletteSize", 4);
+    if (!lastUniform3f) throw new Error("Expected WebGL palette uniform calls");
+    expect(lastUniform3f).toHaveBeenCalledWith("u_palette0", 8 / 255, 7 / 255, 23 / 255);
+    expect(lastUniform3f).toHaveBeenCalledWith("u_palette3", 1, 107 / 255, 102 / 255);
+
+    const fragment = lastShaderSources.find((source) => source.includes("sampleMedia"));
+    expect(fragment).toContain("float centerLuma = lumaOf(base.rgb);");
+    expect(fragment).toContain("vec3(centerLuma) + blurredChroma");
+    expect(fragment).toContain("float headSwitch");
+    expect(fragment).toContain("float tapeTrackingBand");
+    expect(fragment).toContain("float tapeTime = u_effectTime");
+    expect(fragment).toContain("float tapeFrame = floor(tapeTime * 60.0);");
+    expect(fragment).not.toContain(
+      "tapeTrackingBand(float y, float center, float width, float phase)",
+    );
+    expect(fragment).toContain("float lineJitter = (digitalHash");
+    expect(fragment).toContain("float dustMask");
+    expect(fragment).toContain("float screenDot");
+    expect(fragment).toContain("vec3 applyHalftone");
+    expect(fragment).toContain("vec3 applyTwoInkPrint");
+    expect(fragment).toContain("float standardAsciiSample");
+    expect(fragment).toContain("float bayer4");
+    expect(fragment).toContain("vec3 applyAscii");
+    expect(fragment).toContain("vec3 applyDither");
+    expect(fragment).toContain("vec3 applyMonoScreen");
+    expect(fragment).toContain("vec2 applyCrtWarp");
+    expect(fragment).toContain("vec4 sampleChromaticMedia");
+    expect(fragment).toContain("vec3 applyScanlines");
+    expect(fragment).toContain("vec3 applyDigitalGlitch");
+    expect(fragment).toContain("vec3 applyEngraving");
+    expect(fragment).toContain("vec3 applyCrosshatch");
+    expect(fragment).toContain("float crosshatchEdge");
+    expect(fragment).toContain("vec3 applyCrosshatch(vec2 uv");
+    expect(fragment).toContain("crosshatchEdge(uv)");
+    expect(fragment).not.toContain("crosshatchEdge(v_uv)");
+    expect(fragment).toContain("vec2 texel = 1.0 / max(u_resolution * u_uvScale, vec2(1.0));");
+    expect(fragment).toContain("float baseAngle = -clamp(u_crosshatchAngle, 0.0, 1.0) * PI;");
+    expect(fragment).toContain("float variation = mix(1.0, 0.5 + digitalHash");
+    expect(fragment).toContain("baseAngle + PI * 0.5");
+    expect(fragment).toContain("baseAngle + PI * 0.25");
+    expect(fragment).toContain("baseAngle - PI * 0.25");
+    expect(fragment).toContain("asciiStyleSample(floor(u_asciiStyle + 0.5)");
+    expect(fragment).toContain("float cellHeight = mix(4.0, 80.0");
+    expect(fragment).toContain("vec2 asciiEdgeDirection");
+    expect(fragment).toContain("vec3 background = paletteColor(0.0);");
+    expect(fragment).not.toContain("grainHash(cell + vec2(17.0, 43.0))");
+    expect(fragment).toContain("sampleColor = sampleChromaticMedia(uv, sampleColor);");
+    expect(fragment).toContain("sampleColor.rgb = applyDigitalGlitch(uv, sampleColor.rgb);");
+    expect(fragment).toContain("vec3 sampleDigitalSplit");
+    expect(fragment).toContain("float digitalHash(vec2 p)");
+    expect(fragment).toContain("float direction = digitalHash");
+    expect(fragment).toContain("float randomA = digitalHash");
+    expect(fragment).toContain("float colorSplit = clamp(u_digitalGlitchColorSplit");
+    expect(fragment).toContain("float pixelate = clamp(u_digitalGlitchPixelate");
+    expect(fragment).toContain("blockDisplacement > 0.0 && blockOpacity > 0.0");
+    expect(fragment).toContain("displaced = mix(uv, displaced, blockOpacity);");
+    expect(fragment).not.toContain("vec3 electronicBlock");
+    expect(fragment).toContain("color = applyMonoScreen");
+    expect(fragment).toContain("color = applyEngraving");
+    expect(fragment).toContain("color = applyCrosshatch");
+    expect(fragment).toContain("color = applyScanlines");
+    expect(fragment).toContain("float curvature = clamp(u_crtCurvature, 0.0, 1.0) * 0.5;");
+    expect(fragment).toContain("float dist = dot(centered, centered);");
+    expect(fragment).toContain("centered *= 1.0 + curvature * dist;");
+    expect(fragment).toContain("float wave = 0.5 + 0.5 * sin(v_uv.y * count * PI);");
+    expect(fragment).toContain("float line = mix(1.0 - wave, pow(1.0 - wave, 2.2), softness);");
+    expect(fragment).not.toContain("float hardLine = step(0.78, wave);");
+    expect(fragment.indexOf("float vignettePower")).toBeGreaterThan(
+      fragment.indexOf("color = applyScanlines"),
+    );
+    expect(fragment).toContain("amount * 0.02");
+    expect(fragment).not.toContain("mix(center.rgb, split, amount)");
+  });
+
+  it("renders Kuwahara through bounded moment passes before the main shader", () => {
+    const video = makeDrawableVideo();
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({
+        effects: {
+          kuwahara: 0.8,
+          kuwaharaRadius: 0.25,
+          kuwaharaSharpness: 0.4,
+          kuwaharaSaturation: 0.6,
+        },
+      }),
+    );
+    document.body.appendChild(video);
+
+    runtime = createColorGradingRuntime();
+
+    if (!lastUniform1f) throw new Error("Expected WebGL uniform calls");
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwahara", 0.8);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwaharaRadius", 0.25);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwaharaSharpness", 0.4);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwaharaSaturation", 0.6);
+    expect(lastShaderSources.some((source) => source.includes("u_kuwaharaMoments"))).toBe(true);
+    expect(
+      lastShaderSources.some((source) => source.includes("meanSquare - dot(mean, mean)")),
+    ).toBe(true);
+    expect(texImage2DCalls.some((args) => args.includes(0x8d61))).toBe(true);
+  });
+
+  it("falls back to the untreated shader output when half-float targets are unavailable", () => {
+    getContextSpy.mockImplementation((type: string) =>
+      type === "webgl" ? createMockWebGl({ halfFloatSupported: false }) : null,
+    );
+    const video = makeDrawableVideo();
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({ effects: { kuwahara: 1 } }),
+    );
+    const { canvas } = startRuntimeWithVideo(video);
+
+    if (!lastUniform1f) throw new Error("Expected WebGL uniform calls");
+    expect(lastUniform1f).toHaveBeenCalledWith("u_kuwaharaReady", 0);
+    expect(canvas.style.display).toBe("block");
+    expect(runtime?.getStatus(video)).toEqual({
+      state: "unavailable",
+      message: "Kuwahara requires half-float framebuffer support",
+    });
+    expect(texImage2DCalls.some((args) => args.includes(0x8d61))).toBe(false);
+  });
+
+  it("releases lazy Kuwahara GPU resources when attributed media becomes inactive", () => {
+    const video = makeDrawableVideo();
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({ effects: { kuwahara: 1 } }),
+    );
+    startRuntimeWithVideo(video);
+    const gl = getContextSpy.mock.results[0]?.value as WebGLRenderingContext;
+
+    expect(runtime?.setSourceVisibility(video, false)).toBe(true);
+    expect(gl.deleteFramebuffer).toHaveBeenCalledTimes(2);
+    expect(gl.deleteTexture).toHaveBeenCalledTimes(2);
+    expect(gl.deleteProgram).toHaveBeenCalledTimes(2);
+    expect(loseContextCalls).toBe(0);
+    expect(document.querySelector("[data-hf-color-grading-canvas]")).toBeNull();
+  });
+
+  it("releases pooled WebGL contexts when the runtime is destroyed", () => {
+    const { video } = startRuntimeWithVideo();
+
+    expect(runtime?.setSourceVisibility(video, false)).toBe(true);
+    expect(loseContextCalls).toBe(0);
+
+    runtime?.destroy();
+    runtime = null;
+    expect(loseContextCalls).toBe(1);
+  });
+
+  it("drives temporal shader effects from canonical composition time", () => {
+    let playerTime = 2.25;
+    Object.defineProperty(window, "__player", {
+      value: { getTime: () => playerTime },
+      configurable: true,
+    });
+    const video = makeDrawableVideo();
+    Object.defineProperty(video, "currentTime", { value: 19.5, configurable: true });
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({ effects: { digitalGlitch: 1 } }),
+    );
+    document.body.appendChild(video);
+
+    runtime = createColorGradingRuntime();
+
+    if (!lastUniform1f) throw new Error("Expected WebGL uniform calls");
+    expect(lastUniform1f).toHaveBeenCalledWith("u_effectTime", 2.25);
+    const firstGrainSeed = lastUniform1f.mock.calls.findLast(
+      ([uniform]) => uniform === "u_grainSeed",
+    )?.[1] as number | undefined;
+    playerTime = 2.5;
+    runtime.redraw();
+    const secondGrainSeed = lastUniform1f.mock.calls.findLast(
+      ([uniform]) => uniform === "u_grainSeed",
+    )?.[1] as number | undefined;
+    expect(firstGrainSeed).toBeTypeOf("number");
+    expect(secondGrainSeed).toBe((firstGrainSeed ?? 0) + 15);
+    const fragment = lastShaderSources.find((source) => source.includes("sampleMedia"));
+    expect(fragment).toContain("float time = u_effectTime * speed;");
   });
 
   it("uses the effected media sample as the graded shader input", () => {
@@ -480,7 +1110,11 @@ describe("createColorGradingRuntime", () => {
     expect(fragment).toContain("float grainPixelSize");
     expect(fragment).toContain("float blackPoint = clamp(u_blacks * 0.18");
     expect(fragment).toContain("float whitePoint = clamp(1.0 - u_whites * 0.18");
-    expect(fragment).toContain("vec3 color = sampleColor.rgb * pow(2.0, u_exposure);");
+    expect(fragment).toContain("vec3 applyPrimaryGrade(vec3 color)");
+    expect(fragment).toContain(
+      "vec3 color = mix(sampleColor.rgb, applyPrimaryGrade(sampleColor.rgb), u_intensity);",
+    );
+    expect(fragment).not.toContain("mix(original, color, u_intensity)");
     expect(fragment).not.toContain("sampleSoft");
     const blurFragment = lastShaderSources.find((source) =>
       source.includes("uniform vec2 u_direction;"),
@@ -505,6 +1139,47 @@ describe("createColorGradingRuntime", () => {
     ).toBe(true);
   });
 
+  it("renders article bloom with thresholded half-resolution Gaussian passes", () => {
+    const video = makeDrawableVideo();
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({ effects: { bloom: 0.5, bloomRadius: 8 } }),
+    );
+    document.body.appendChild(video);
+
+    runtime = createColorGradingRuntime();
+
+    expect(lastUniform1f).toHaveBeenCalledWith("u_bloom", 0.5);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_bloomReady", 1);
+    expect(lastUniform1f).toHaveBeenCalledWith("u_radius", 4);
+    expect(texImage2DCalls.some((args) => args[3] === 320 && args[4] === 180)).toBe(true);
+    const bloomFragment = lastShaderSources.find((source) => source.includes("u_bloomPass"));
+    expect(bloomFragment).toContain("vec3(0.299, 0.587, 0.114)");
+    expect(bloomFragment).toContain("0.227027");
+    expect(bloomFragment).toContain("0.1945946");
+    expect(bloomFragment).toContain("0.016216");
+  });
+
+  it("releases the lazy bloom output used only when blur and bloom coexist", () => {
+    const video = makeDrawableVideo();
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({
+        effects: { blur: 0.4, bloom: 0.5, bloomRadius: 8 },
+      }),
+    );
+    startRuntimeWithVideo(video);
+    const gl = getContextSpy.mock.results[0]?.value as WebGLRenderingContext;
+
+    expect(texImage2DCalls.some((args) => args[3] === 640 && args[4] === 360)).toBe(true);
+    expect(texImage2DCalls.some((args) => args[3] === 320 && args[4] === 180)).toBe(true);
+
+    expect(runtime?.setSourceVisibility(video, false)).toBe(true);
+    expect(gl.deleteFramebuffer).toHaveBeenCalledTimes(3);
+    expect(gl.deleteTexture).toHaveBeenCalledTimes(3);
+    expect(gl.deleteProgram).toHaveBeenCalledTimes(1);
+  });
+
   it("loads cube LUTs and enables LUT uniforms", async () => {
     const fetchMock = stubCubeLutFetch();
     const origin = window.location.origin;
@@ -532,6 +1207,40 @@ describe("createColorGradingRuntime", () => {
     expect(runtime.getStatus("#hero-video").message).toBe("Shader + LUT active");
   });
 
+  it("waits for active LUTs before deterministic capture", async () => {
+    let releaseFetch: (() => void) | undefined;
+    vi.stubGlobal(
+      "fetch",
+      vi.fn(
+        () =>
+          new Promise<{ ok: boolean; status: number; text: () => Promise<string> }>((resolve) => {
+            releaseFetch = () =>
+              resolve({ ok: true, status: 200, text: () => Promise.resolve(IDENTITY_2) });
+          }),
+      ),
+    );
+    const video = makeDrawableVideo();
+    video.setAttribute(
+      HF_COLOR_GRADING_ATTR,
+      serializeHfColorGrading({ lut: { src: "assets/luts/identity.cube", intensity: 1 } }),
+    );
+    document.body.appendChild(video);
+    runtime = createColorGradingRuntime();
+
+    expect(runtime.getStatus(video)).toEqual({ state: "pending", message: "Loading LUT" });
+    const ready = runtime.waitForActiveLuts();
+    let settled = false;
+    void ready.then(() => {
+      settled = true;
+    });
+    await Promise.resolve();
+    expect(settled).toBe(false);
+
+    releaseFetch?.();
+    expect(await ready).toBe(1);
+    expect(runtime.getStatus(video).message).toBe("Shader + LUT active");
+  });
+
   it("bounds the runtime LUT cache", async () => {
     const fetchMock = stubCubeLutFetch();
     const origin = window.location.origin;
@@ -644,15 +1353,16 @@ describe("installAuthoredOpacityCapture", () => {
     el.remove();
   });
 
-  it("stamps an already-inserted element the moment it GAINS grading at runtime", async () => {
+  it("stamps ungraded media before a live Studio grade can hide it", async () => {
     installAuthoredOpacityCapture();
     const el = document.createElement("img");
     el.style.opacity = "0.9";
     document.body.appendChild(el);
     await Promise.resolve();
-    expect(el.hasAttribute("data-hf-authored-opacity")).toBe(false);
+    expect(el.getAttribute("data-hf-authored-opacity")).toBe("0.9");
 
-    // Studio applies a preset to a previously ungraded element — no re-insert.
+    // The live runtime hides the source before Studio persists the attribute.
+    el.style.setProperty("opacity", "0", "important");
     el.setAttribute(HF_COLOR_GRADING_ATTR, serializeHfColorGrading({ adjust: { exposure: 0.5 } }));
     await Promise.resolve();
     expect(el.getAttribute("data-hf-authored-opacity")).toBe("0.9");
diff --git a/packages/core/src/runtime/colorGrading.ts b/packages/core/src/runtime/colorGrading.ts
index 4fd00faf0b..09bdbdc2ab 100644
--- a/packages/core/src/runtime/colorGrading.ts
+++ b/packages/core/src/runtime/colorGrading.ts
@@ -1,9 +1,17 @@
 import {
+  HF_COLOR_GRADING_ADJUST_KEYS,
+  HF_COLOR_GRADING_ANIMATABLE_PROPERTIES,
   HF_COLOR_GRADING_ATTR,
   HF_COLOR_GRADING_CANVAS_ID_PREFIX,
+  HF_COLOR_GRADING_DETAIL_KEYS,
+  HF_COLOR_GRADING_EFFECT_KEYS,
   isHfColorGradingActive,
   normalizeHfColorGrading,
   normalizeHfColorGradingWithVariables,
+  type HfColorGradingAdjustKey,
+  type HfColorGradingAnimatablePath,
+  type HfColorGradingDetailKey,
+  type HfColorGradingEffectKey,
   type HfColorGradingTarget,
   type NormalizedHfColorGrading,
   COLOR_GRADING_SOURCE_HIDDEN_ATTR,
@@ -39,6 +47,8 @@ interface VideoFrameCallbackHost {
   cancelVideoFrameCallback?: (handle: number) => void;
 }
 
+type FloatUniformBinding<K extends string> = readonly [key: K, location: WebGLUniformLocation];
+
 interface ProgramInfo {
   program: WebGLProgram;
   texture: WebGLTexture;
@@ -47,37 +57,33 @@ interface ProgramInfo {
   position: number;
   source: WebGLUniformLocation | null;
   blurSource: WebGLUniformLocation | null;
+  bloomSource: WebGLUniformLocation | null;
+  kuwaharaSource: WebGLUniformLocation | null;
   lut: WebGLUniformLocation | null;
   resolution: WebGLUniformLocation | null;
   uvScale: WebGLUniformLocation | null;
   uvOffset: WebGLUniformLocation | null;
   blurReady: WebGLUniformLocation | null;
+  bloomReady: WebGLUniformLocation | null;
+  kuwaharaReady: WebGLUniformLocation | null;
   lutEnabled: WebGLUniformLocation | null;
   lutSize: WebGLUniformLocation | null;
   lutTextureSize: WebGLUniformLocation | null;
   lutDomainMin: WebGLUniformLocation | null;
   lutDomainMax: WebGLUniformLocation | null;
   lutIntensity: WebGLUniformLocation | null;
-  exposure: WebGLUniformLocation | null;
-  contrast: WebGLUniformLocation | null;
-  highlights: WebGLUniformLocation | null;
-  shadows: WebGLUniformLocation | null;
-  whites: WebGLUniformLocation | null;
-  blacks: WebGLUniformLocation | null;
-  temperature: WebGLUniformLocation | null;
-  tint: WebGLUniformLocation | null;
-  vibrance: WebGLUniformLocation | null;
-  saturation: WebGLUniformLocation | null;
-  vignette: WebGLUniformLocation | null;
-  vignetteMidpoint: WebGLUniformLocation | null;
-  vignetteRoundness: WebGLUniformLocation | null;
-  vignetteFeather: WebGLUniformLocation | null;
-  grain: WebGLUniformLocation | null;
-  grainSize: WebGLUniformLocation | null;
-  grainRoughness: WebGLUniformLocation | null;
+  adjustUniforms: readonly FloatUniformBinding<HfColorGradingAdjustKey>[];
+  detailUniforms: readonly FloatUniformBinding<HfColorGradingDetailKey>[];
+  effectUniforms: readonly FloatUniformBinding<HfColorGradingEffectKey>[];
   grainSeed: WebGLUniformLocation | null;
-  blur: WebGLUniformLocation | null;
-  pixelate: WebGLUniformLocation | null;
+  effectTime: WebGLUniformLocation | null;
+  paletteSize: WebGLUniformLocation | null;
+  palette0: WebGLUniformLocation | null;
+  palette1: WebGLUniformLocation | null;
+  palette2: WebGLUniformLocation | null;
+  palette3: WebGLUniformLocation | null;
+  palette4: WebGLUniformLocation | null;
+  palette5: WebGLUniformLocation | null;
   intensity: WebGLUniformLocation | null;
   compareEnabled: WebGLUniformLocation | null;
   comparePosition: WebGLUniformLocation | null;
@@ -93,11 +99,14 @@ interface BlurProgramInfo {
   resolution: WebGLUniformLocation | null;
   direction: WebGLUniformLocation | null;
   radius: WebGLUniformLocation | null;
+  bloomPass: WebGLUniformLocation | null;
+  threshold: WebGLUniformLocation | null;
 }
 
 interface RenderTarget {
   texture: WebGLTexture;
   framebuffer: WebGLFramebuffer;
+  type: number;
   width: number;
   height: number;
 }
@@ -106,6 +115,39 @@ interface EffectTargets {
   blurProgram: BlurProgramInfo;
   scratch: RenderTarget;
   blur: RenderTarget;
+  bloom: RenderTarget | null;
+}
+
+interface KuwaharaHorizontalProgramInfo {
+  program: WebGLProgram;
+  quad: WebGLBuffer;
+  position: number;
+  source: WebGLUniformLocation | null;
+  blurSource: WebGLUniformLocation | null;
+  texel: WebGLUniformLocation | null;
+  uvScale: WebGLUniformLocation | null;
+  uvOffset: WebGLUniformLocation | null;
+  blurReady: WebGLUniformLocation | null;
+  blur: WebGLUniformLocation | null;
+  radius: WebGLUniformLocation | null;
+}
+
+interface KuwaharaResolveProgramInfo {
+  program: WebGLProgram;
+  quad: WebGLBuffer;
+  position: number;
+  moments: WebGLUniformLocation | null;
+  texel: WebGLUniformLocation | null;
+  radius: WebGLUniformLocation | null;
+  sharpness: WebGLUniformLocation | null;
+  saturation: WebGLUniformLocation | null;
+}
+
+interface KuwaharaTargets {
+  horizontalProgram: KuwaharaHorizontalProgramInfo;
+  resolveProgram: KuwaharaResolveProgramInfo;
+  moments: RenderTarget;
+  output: RenderTarget;
 }
 
 interface RuntimeColorGradingCompareState {
@@ -115,19 +157,26 @@ interface RuntimeColorGradingCompareState {
   lineWidth: number;
 }
 
-interface ColorGradingEntry {
-  element: ColorGradingMediaElement;
-  canvas: HTMLCanvasElement;
+interface EffectRenderState {
   gl: WebGLRenderingContext;
   program: ProgramInfo;
+  effectTargets: EffectTargets | null;
+  kuwaharaTargets: KuwaharaTargets | null;
+  effectError: string | null;
+}
+
+interface ColorGradingRenderer extends EffectRenderState {
+  canvas: HTMLCanvasElement;
+}
+
+interface ColorGradingEntry extends ColorGradingRenderer {
+  element: ColorGradingMediaElement;
   grading: NormalizedHfColorGrading;
   compare: RuntimeColorGradingCompareState;
   lut: RuntimeLutTexture | null;
   lutLoadingSrc: string | null;
   lutError: string | null;
   drawError: string | null;
-  effectTargets: EffectTargets | null;
-  effectError: string | null;
   source: EntrySource;
   animationFrame: number | null;
   videoFrameHandle: number | null;
@@ -146,9 +195,26 @@ interface ColorGradingEntry {
   destroyed: boolean;
 }
 
+interface ColorGradingPreviewRenderer extends ColorGradingRenderer {
+  lut: RuntimeLutTexture | null;
+}
+
+export interface RuntimeColorGradingPreviewCandidate {
+  id: string;
+  grading: unknown;
+}
+
+export interface RuntimeColorGradingPreviewBatch {
+  width: number;
+  height: number;
+  images: Array<{ id: string; dataUrl: string | null; error?: string }>;
+}
+
 export interface RuntimeColorGradingApi {
   refresh: () => number;
   redraw: () => number;
+  redrawAnimated: () => number;
+  waitForActiveLuts: () => Promise<number>;
   setGrading: (
     target: HfColorGradingTarget | string | null | undefined,
     rawGrading: unknown,
@@ -161,6 +227,14 @@ export interface RuntimeColorGradingApi {
   getStatus: (
     target: HfColorGradingTarget | string | null | undefined,
   ) => RuntimeColorGradingStatus;
+  renderPreviews: (
+    target: HfColorGradingTarget | string | null | undefined,
+    candidates: readonly RuntimeColorGradingPreviewCandidate[],
+    options?: { maxDimension?: number; useMediaTime?: boolean },
+  ) => Promise<RuntimeColorGradingPreviewBatch | null>;
+  startPreviewPlayback: (
+    target: HfColorGradingTarget | string | null | undefined,
+  ) => (() => void) | null;
   destroy: () => void;
 }
 
@@ -172,6 +246,9 @@ export type RuntimeColorGradingStatus =
   | { state: "unavailable"; message: string };
 
 type WindowWithColorGrading = Window & {
+  __player?: {
+    getTime?: () => number;
+  };
   __hf?: {
     colorGrading?: RuntimeColorGradingApi;
   };
@@ -200,27 +277,7 @@ const LUT_CACHE = new Map<string, LutCacheEntry>();
 const COLOR_GRADING_CANVAS_ATTR = "data-hf-color-grading-canvas";
 const COLOR_GRADING_CANVAS_CLASS = "__hf_color_grading_canvas__";
 
-/**
- * Capture each color-graded element's AUTHORED inline opacity before any
- * animation engine can mutate it.
- *
- * The grading engine hides its source elements with `opacity: 0 !important`
- * and mirrors their pixels onto a canvas — so at runtime, a graded element's
- * inline/computed opacity no longer represents authored state. Everything that
- * later re-reads element state (GSAP from()-tween re-initialization after an
- * invalidate or a studio soft reload, restoring the source when grading is
- * removed, lint/selection tooling) needs the authored value, and by then it is
- * unrecoverable from the DOM. Stamp it onto the element as
- * `data-hf-authored-opacity` (empty string = no authored inline opacity).
- *
- * Must be installed at runtime-bundle evaluation, while the document is still
- * parsing: the runtime `<script>` sits in `<head>`, and the HTML parser
- * performs a microtask checkpoint before executing each parser-inserted
- * script, so the observer stamps every composition element before the
- * composition's own inline animation script runs. The observer stays alive so
- * late insertions (inlined sub-compositions) are stamped at insert time, and
- * the has-attribute guard makes re-inserted (already-stamped) elements a no-op.
- */
+/** Captures authored media opacity before animation or grading can mutate it. */
 export function installAuthoredOpacityCapture(): void {
   if (typeof MutationObserver === "undefined" || typeof document === "undefined") return;
   const root = document.documentElement;
@@ -232,38 +289,31 @@ export function installAuthoredOpacityCapture(): void {
   };
   const scan = (node: Node): void => {
     if (!(node instanceof Element)) return;
-    if (node.hasAttribute(HF_COLOR_GRADING_ATTR)) stamp(node);
-    for (const el of node.querySelectorAll(`[${HF_COLOR_GRADING_ATTR}]`)) stamp(el);
+    if (node.matches("video, img")) stamp(node);
+    for (const el of node.querySelectorAll("video, img")) stamp(el);
   };
   scan(root);
   new MutationObserver((mutations) => {
     for (const mutation of mutations) {
       for (const node of mutation.addedNodes) scan(node);
-      // An element can also GAIN grading at runtime (studio applies a preset to
-      // a previously ungraded element). Stamp at that moment — strictly earlier
-      // than the engine's hide, so the captured value can never be worse than
-      // the hide-time fallback, and after a soft reload's authored restore it
-      // IS the authored value. stamp() is idempotent: an existing stamp wins.
-      if (mutation.type === "attributes" && mutation.target instanceof Element) {
-        if (mutation.target.hasAttribute(HF_COLOR_GRADING_ATTR)) stamp(mutation.target);
-      }
     }
   }).observe(root, {
     childList: true,
     subtree: true,
-    attributes: true,
-    attributeFilter: [HF_COLOR_GRADING_ATTR],
   });
 }
 
 // Map insertion order gives us simple FIFO eviction for authoring sessions that cycle LUTs.
 const MAX_LUT_CACHE_ENTRIES = 16;
+const MAX_IDLE_COLOR_GRADING_RENDERERS = 4;
 const DEFAULT_COMPARE: RuntimeColorGradingCompareState = {
   enabled: false,
   position: 0.5,
   softness: 0,
   lineWidth: 2,
 };
+const DEFAULT_EFFECT_PALETTE = ["#000000", "#ffffff"] as const;
+const DEFAULT_ART_PALETTE = ["#1a1a1a", "#f5f5dc"] as const;
 
 function readColorGradingAttribute(element: Element): NormalizedHfColorGrading | null {
   const raw = element.getAttribute(HF_COLOR_GRADING_ATTR);
@@ -289,11 +339,15 @@ const FRAGMENT_SHADER = [
   "varying vec2 v_uv;",
   "uniform sampler2D u_source;",
   "uniform sampler2D u_blurSource;",
+  "uniform sampler2D u_bloomSource;",
+  "uniform sampler2D u_kuwaharaSource;",
   "uniform sampler2D u_lut;",
   "uniform vec2 u_resolution;",
   "uniform vec2 u_uvScale;",
   "uniform vec2 u_uvOffset;",
   "uniform float u_blurReady;",
+  "uniform float u_bloomReady;",
+  "uniform float u_kuwaharaReady;",
   "uniform float u_lutEnabled;",
   "uniform float u_lutSize;",
   "uniform vec2 u_lutTextureSize;",
@@ -318,19 +372,121 @@ const FRAGMENT_SHADER = [
   "uniform float u_grainSize;",
   "uniform float u_grainRoughness;",
   "uniform float u_grainSeed;",
+  "uniform float u_effectTime;",
   "uniform float u_blur;",
+  "uniform float u_bloom;",
+  "uniform float u_kuwahara;",
   "uniform float u_pixelate;",
+  "uniform float u_chromaBleed;",
+  "uniform float u_tapeDamage;",
+  "uniform float u_tapeTracking;",
+  "uniform float u_tapeNoise;",
+  "uniform float u_tapeSpeed;",
+  "uniform float u_filmArtifacts;",
+  "uniform float u_halftone;",
+  "uniform float u_halftoneSize;",
+  "uniform float u_twoInkPrint;",
+  "uniform float u_twoInkPrintSize;",
+  "uniform float u_ascii;",
+  "uniform float u_asciiSize;",
+  "uniform float u_asciiInvert;",
+  "uniform float u_asciiStyle;",
+  "uniform float u_asciiColor;",
+  "uniform float u_asciiRotation;",
+  "uniform float u_dither;",
+  "uniform float u_ditherSize;",
+  "uniform float u_monoScreen;",
+  "uniform float u_monoScreenSize;",
+  "uniform float u_monoScreenAngle;",
+  "uniform float u_monoScreenSpread;",
+  "uniform float u_monoScreenShape;",
+  "uniform float u_monoScreenInvert;",
+  "uniform float u_scanlines;",
+  "uniform float u_scanlineCount;",
+  "uniform float u_scanlineSoftness;",
+  "uniform float u_chromaticAberration;",
+  "uniform float u_chromaticAngle;",
+  "uniform float u_crtCurvature;",
+  "uniform float u_digitalGlitch;",
+  "uniform float u_digitalGlitchColorSplit;",
+  "uniform float u_digitalGlitchLineTear;",
+  "uniform float u_digitalGlitchPixelate;",
+  "uniform float u_digitalGlitchBlockAmount;",
+  "uniform float u_digitalGlitchBlockDisplacement;",
+  "uniform float u_digitalGlitchBlockOpacity;",
+  "uniform float u_digitalGlitchSpeed;",
+  "uniform float u_engraving;",
+  "uniform float u_engravingSpacing;",
+  "uniform float u_engravingMinThickness;",
+  "uniform float u_engravingMaxThickness;",
+  "uniform float u_engravingAngle;",
+  "uniform float u_engravingContrast;",
+  "uniform float u_engravingSharpness;",
+  "uniform float u_engravingWave;",
+  "uniform float u_engravingWaveFrequency;",
+  "uniform float u_crosshatch;",
+  "uniform float u_crosshatchSpacing;",
+  "uniform float u_crosshatchThickness;",
+  "uniform float u_crosshatchAngle;",
+  "uniform float u_crosshatchContrast;",
+  "uniform float u_crosshatchEdges;",
+  "uniform float u_crosshatchLineWeight;",
+  "uniform float u_crosshatchWave;",
+  "uniform float u_crosshatchWaveFrequency;",
+  "uniform float u_paletteSize;",
+  "uniform vec3 u_palette0;",
+  "uniform vec3 u_palette1;",
+  "uniform vec3 u_palette2;",
+  "uniform vec3 u_palette3;",
+  "uniform vec3 u_palette4;",
+  "uniform vec3 u_palette5;",
   "uniform float u_intensity;",
   "uniform float u_compareEnabled;",
   "uniform float u_comparePosition;",
   "uniform float u_compareSoftness;",
   "uniform float u_compareLineWidth;",
+  "const float PI = 3.14159265359;",
   "float lumaOf(vec3 c){ return dot(c, vec3(0.2126, 0.7152, 0.0722)); }",
+  "float bt601Luma(vec3 c){ return dot(c, vec3(0.299, 0.587, 0.114)); }",
   "float grainHash(vec2 p){ return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453123); }",
+  "float digitalHash(vec2 p){",
+  "  vec2 q = mod(floor(p), 251.0);",
+  "  float x = mod(q.x * q.x * 157.0 + q.x * 89.0, 251.0);",
+  "  float y = mod(q.y * q.y * 113.0 + q.y * 47.0, 251.0);",
+  "  float xy = mod(q.x * q.y * 71.0, 251.0);",
+  "  return mod(x + y + xy + 19.0, 251.0) / 251.0;",
+  "}",
   "float colorSaturation(vec3 c){ return max(max(c.r, c.g), c.b) - min(min(c.r, c.g), c.b); }",
   "vec2 clampUv(vec2 uv){ return clamp(uv, vec2(0.0), vec2(1.0)); }",
+  "vec2 applyCrtWarp(vec2 uv){",
+  "  vec2 centered = uv * 2.0 - 1.0;",
+  "  float curvature = clamp(u_crtCurvature, 0.0, 1.0) * 0.5;",
+  "  float dist = dot(centered, centered);",
+  "  centered *= 1.0 + curvature * dist;",
+  "  return centered * 0.5 + 0.5;",
+  "}",
   "vec4 sampleSource(vec2 uv){ return texture2D(u_source, clampUv(uv)); }",
   "vec4 sampleBlur(vec2 uv){ return texture2D(u_blurSource, clampUv(uv)); }",
+  "vec3 sampleBloom(vec2 uv){ return texture2D(u_bloomSource, clampUv(uv)).rgb; }",
+  "vec3 sampleKuwahara(vec2 uv){",
+  "  vec2 displayUv = uv * u_uvScale + u_uvOffset;",
+  "  return texture2D(u_kuwaharaSource, clampUv(displayUv)).rgb;",
+  "}",
+  "vec4 samplePrepared(vec2 uv){",
+  "  vec4 base = sampleSource(uv);",
+  "  float blur = clamp(u_blur, 0.0, 1.0);",
+  "  if (blur > 0.0 && u_blurReady > 0.5) base = mix(base, sampleBlur(uv), blur);",
+  "  float kuwahara = clamp(u_kuwahara, 0.0, 1.0);",
+  "  if (kuwahara > 0.0 && u_kuwaharaReady > 0.5) {",
+  "    base.rgb = mix(base.rgb, sampleKuwahara(uv), kuwahara);",
+  "  }",
+  "  return base;",
+  "}",
+  "float tapeTrackingBand(float y, float center, float width){",
+  "  float offset = fract(y - center + 0.5) - 0.5;",
+  "  float triangle = max(0.0, 1.0 - abs(offset) / max(width, 0.0001));",
+  "  return triangle * triangle * (3.0 - 2.0 * triangle);",
+  "}",
   "vec4 sampleMedia(vec2 uv){",
   "  float pixel = clamp(u_pixelate, 0.0, 1.0);",
   "  vec2 sampleUv = uv;",
@@ -339,13 +495,442 @@ const FRAGMENT_SHADER = [
   "    vec2 cells = max(u_resolution / blockSize, vec2(1.0));",
   "    sampleUv = (floor(clamp(uv, vec2(0.0), vec2(0.999999)) * cells) + 0.5) / cells;",
   "  }",
-  "  vec4 base = sampleSource(sampleUv);",
-  "  float blur = clamp(u_blur, 0.0, 1.0);",
-  "  if (blur > 0.0 && u_blurReady > 0.5) {",
-  "    base = mix(base, sampleBlur(sampleUv), blur);",
+  "  float tapeDamage = clamp(u_tapeDamage, 0.0, 1.0);",
+  "  float tapeTracking = clamp(u_tapeTracking, 0.0, 1.0);",
+  "  float tapeNoise = clamp(u_tapeNoise, 0.0, 1.0);",
+  "  float tapeTime = u_effectTime * mix(0.0, 2.0, clamp(u_tapeSpeed, 0.0, 1.0));",
+  "  float tapeFrame = floor(tapeTime * 60.0);",
+  "  float tapeLine = floor(sampleUv.y * u_resolution.y * 0.5);",
+  "  float lineJitter = (digitalHash(vec2(tapeLine, floor(tapeFrame * 0.5))) - 0.5) * 1.8 * tapeNoise;",
+  "  float slowWobble = sin(sampleUv.y * 32.0 + tapeTime * 2.6) * 0.55;",
+  "  float headSwitch = smoothstep(0.88, 1.0, sampleUv.y) * sin(sampleUv.y * 240.0 + tapeTime * 8.0) * 4.0;",
+  "  float trackingShift = tapeTrackingBand(sampleUv.y, fract(0.08 + tapeTime * 0.083), 0.035);",
+  "  trackingShift -= tapeTrackingBand(sampleUv.y, fract(0.28 + tapeTime * 0.061), 0.03) * 0.8;",
+  "  trackingShift += tapeTrackingBand(sampleUv.y, fract(0.5 + tapeTime * 0.047), 0.04) * 0.75;",
+  "  trackingShift -= tapeTrackingBand(sampleUv.y, fract(0.72 + tapeTime * 0.037), 0.028) * 0.65;",
+  "  trackingShift += tapeTrackingBand(sampleUv.y, fract(0.89 + tapeTime * 0.029), 0.032) * 0.55;",
+  "  trackingShift *= tapeTracking * 48.0;",
+  "  float tapeShift = (lineJitter + slowWobble + headSwitch + trackingShift) * tapeDamage;",
+  "  float texelX = 1.0 / max(u_resolution.x * max(u_uvScale.x, 0.00001), 1.0);",
+  "  vec2 tapeUv = sampleUv + vec2(tapeShift * texelX, 0.0);",
+  "  vec4 base = samplePrepared(tapeUv);",
+  "  if (tapeDamage > 0.0) {",
+  "    vec2 lumaStep = vec2(texelX * mix(1.0, 3.5, tapeDamage), 0.0);",
+  "    vec3 leftTape = samplePrepared(tapeUv - lumaStep).rgb;",
+  "    vec3 rightTape = samplePrepared(tapeUv + lumaStep).rgb;",
+  "    float tapeLuma = (bt601Luma(leftTape) + bt601Luma(base.rgb) * 2.0 + bt601Luma(rightTape)) * 0.25;",
+  "    vec3 centerChroma = base.rgb - vec3(bt601Luma(base.rgb));",
+  "    vec3 tapeColor = vec3(tapeLuma) + centerChroma;",
+  "    vec3 ghost = samplePrepared(tapeUv - vec2(texelX * 12.0, 0.0)).rgb;",
+  "    tapeColor = mix(tapeColor, ghost, 0.045 * tapeDamage);",
+  "    float fineNoise = digitalHash(floor(gl_FragCoord.xy) + vec2(tapeFrame * 17.0, tapeFrame * 3.0)) - 0.5;",
+  "    float band = digitalHash(vec2(floor(sampleUv.y * 92.0), floor(tapeFrame / 3.0)));",
+  "    float dropout = smoothstep(0.985, 1.0, band) * (digitalHash(vec2(floor(sampleUv.x * 18.0), tapeLine)) - 0.5);",
+  "    tapeColor += (fineNoise * 0.035 + dropout * 0.12) * tapeDamage * tapeNoise;",
+  "    base.rgb = mix(base.rgb, clamp(tapeColor, 0.0, 1.0), tapeDamage);",
+  "  }",
+  "  float chromaBleed = clamp(u_chromaBleed, 0.0, 1.0);",
+  "  if (chromaBleed > 0.0) {",
+  "    float radius = mix(1.0, 4.0, chromaBleed);",
+  "    vec2 stepUv = vec2(texelX * radius, 0.0);",
+  "    vec3 c0 = base.rgb;",
+  "    vec3 c1 = samplePrepared(tapeUv - stepUv).rgb;",
+  "    vec3 c2 = samplePrepared(tapeUv + stepUv).rgb;",
+  "    vec3 c3 = samplePrepared(tapeUv - stepUv * 2.0).rgb;",
+  "    vec3 c4 = samplePrepared(tapeUv + stepUv * 2.0).rgb;",
+  "    float centerLuma = lumaOf(base.rgb);",
+  "    vec3 blurredChroma = ((c0 - vec3(lumaOf(c0))) * 6.0 + (c1 - vec3(lumaOf(c1))) * 4.0 + (c2 - vec3(lumaOf(c2))) * 4.0 + (c3 - vec3(lumaOf(c3))) + (c4 - vec3(lumaOf(c4)))) / 16.0;",
+  "    base.rgb = mix(base.rgb, clamp(vec3(centerLuma) + blurredChroma, 0.0, 1.0), chromaBleed);",
   "  }",
   "  return base;",
   "}",
+  "vec4 sampleChromaticMedia(vec2 uv, vec4 center){",
+  "  float amount = clamp(u_chromaticAberration, 0.0, 1.0);",
+  "  if (amount <= 0.0) return center;",
+  "  float angle = clamp(u_chromaticAngle, 0.0, 1.0) * PI * 2.0;",
+  "  vec2 offset = vec2(cos(angle), sin(angle)) * amount * 0.02;",
+  "  vec4 positive = sampleMedia(uv + offset);",
+  "  vec4 negative = sampleMedia(uv - offset);",
+  "  vec3 split = vec3(positive.r, center.g, negative.b);",
+  "  return vec4(split, center.a);",
+  "}",
+  "vec3 sampleDigitalSplit(vec2 uv, vec2 block, float time, float amount){",
+  "  float split = amount * 0.06;",
+  "  float direction = digitalHash(block * 0.4 + vec2(floor(time * 3.7), floor(time * 5.3)));",
+  "  vec2 axis = direction > 0.66 ? vec2(1.0, 0.0) : direction > 0.33 ? vec2(0.0, 1.0) : vec2(0.7071);",
+  "  vec4 center = sampleMedia(uv);",
+  "  return vec3(sampleMedia(uv + axis * split).r, center.g, sampleMedia(uv - axis * split).b);",
+  "}",
+  "vec3 applyDigitalGlitch(vec2 uv, vec3 source){",
+  "  float amount = clamp(u_digitalGlitch, 0.0, 1.0);",
+  "  if (amount <= 0.0) return source;",
+  "  float colorSplit = clamp(u_digitalGlitchColorSplit, 0.0, 1.0) * 2.0;",
+  "  float lineTear = clamp(u_digitalGlitchLineTear, 0.0, 1.0) * 2.0;",
+  "  float pixelate = clamp(u_digitalGlitchPixelate, 0.0, 1.0) * 2.0;",
+  "  float blockAmount = clamp(u_digitalGlitchBlockAmount, 0.0, 1.0);",
+  "  float blockDisplacement = clamp(u_digitalGlitchBlockDisplacement, 0.0, 1.0) * 2.0;",
+  "  float blockOpacity = clamp(u_digitalGlitchBlockOpacity, 0.0, 1.0);",
+  "  float speed = clamp(u_digitalGlitchSpeed, 0.0, 1.0) * 2.0;",
+  "  float time = u_effectTime * speed;",
+  "  float blockCount = 8.0 + blockAmount * 60.0;",
+  "  vec2 block = floor(uv * blockCount);",
+  "  float randomA = digitalHash(block + vec2(floor(time * 7.3), floor(time * 11.1)));",
+  "  float randomB = digitalHash(block * 0.7 + vec2(17.3 + floor(time * 6.6), 29.1));",
+  "  float randomC = digitalHash(block + vec2(floor(time * 5.7) * 13.0, 41.0));",
+  "  float randomD = digitalHash(block * 1.3 + vec2(7.0, floor(time * 3.2) * 7.0));",
+  "  vec2 displaced = uv;",
+  "  if (blockDisplacement > 0.0 && blockOpacity > 0.0) {",
+  "    float threshold = 1.0 - blockDisplacement * 0.4;",
+  "    if (randomA > threshold) {",
+  "      displaced += vec2((randomB - 0.5) * blockDisplacement * 0.5, (randomC - 0.5) * blockDisplacement * 0.3);",
+  "    }",
+  "    if (randomD > 0.92 && blockDisplacement > 0.5) {",
+  "      displaced.x += (digitalHash(vec2(block.y, floor(time * 8.0))) - 0.5) * blockDisplacement;",
+  "    }",
+  "    displaced = mix(uv, displaced, blockOpacity);",
+  "  }",
+  "  if (lineTear > 0.0) {",
+  "    float row = floor(uv.y * (50.0 + lineTear * 150.0));",
+  "    float tearA = digitalHash(vec2(row * 7.3 + floor(time * 12.0 + row * 0.1) * 3.7, 13.0));",
+  "    float tearB = digitalHash(vec2(row * 13.7 + floor(time * 8.3) * 5.1, 31.0));",
+  "    if (tearA > 1.0 - lineTear * 0.5) displaced.x += (tearB - 0.5) * lineTear * 0.4;",
+  "    if (tearB > 0.95 && lineTear > 0.3) displaced.x += (tearA - 0.5) * lineTear * 0.8;",
+  "  }",
+  "  if (pixelate > 0.0) {",
+  "    float pixelRandom = digitalHash(block * 0.5 + vec2(floor(time * 4.9), 53.0));",
+  "    if (pixelRandom > 1.0 - pixelate * 0.35) {",
+  "      float cells = 4.0 + (1.0 - pixelRandom) * pixelate * 40.0;",
+  "      displaced = (floor(clampUv(displaced) * cells) + 0.5) / cells;",
+  "    }",
+  "  }",
+  "  displaced = clampUv(displaced);",
+  "  vec3 glitch = sampleDigitalSplit(displaced, block, time, colorSplit);",
+  "  if (blockDisplacement > 0.2 && blockOpacity > 0.0) {",
+  "    float corruption = digitalHash(block * 1.1 + vec2(floor(time * 11.9), 67.0));",
+  "    vec3 changed = glitch;",
+  "    if (corruption > 0.9) changed = 1.0 - glitch;",
+  "    else if (corruption > 0.85) changed = corruption > 0.875 ? glitch.gbr : glitch.brg;",
+  "    else if (corruption > 0.8) {",
+  "      float channel = digitalHash(block + vec2(73.0));",
+  "      if (channel > 0.66) changed.r = min(changed.r * 2.0, 1.0);",
+  "      else if (channel > 0.33) changed.g = min(changed.g * 2.0, 1.0);",
+  "      else changed.b = min(changed.b * 2.0, 1.0);",
+  "    }",
+  "    glitch = mix(glitch, changed, blockOpacity);",
+  "  }",
+  "  if (blockOpacity > 0.0) {",
+  "    float flash = digitalHash(block * 0.8 + vec2(floor(time * 14.7), 83.0));",
+  "    vec3 flashed = flash > 0.97 ? min(glitch * 1.8, vec3(1.0)) : flash > 0.94 ? glitch * 0.3 : glitch;",
+  "    glitch = mix(glitch, flashed, blockOpacity * 0.6);",
+  "  }",
+  "  if (lineTear > 0.1) {",
+  "    float interference = pow(sin(uv.y * (300.0 + randomA * 200.0) + time * 30.0) * 0.5 + 0.5, 6.0);",
+  "    glitch -= interference * 0.08 * lineTear;",
+  "  }",
+  "  return mix(source, clamp(glitch, 0.0, 1.0), amount);",
+  "}",
+  "float dustMask(vec2 uv, float frameBucket){",
+  "  vec2 grid = vec2(128.0, 72.0);",
+  "  vec2 cell = floor(uv * grid);",
+  "  vec2 local = fract(uv * grid) - 0.5;",
+  "  float chance = grainHash(cell + frameBucket * 19.13);",
+  "  float radius = mix(0.05, 0.34, grainHash(cell + 7.1));",
+  "  return step(0.9975, chance) * (1.0 - smoothstep(radius, radius + 0.08, length(local)));",
+  "}",
+  "float screenDot(vec2 p, float ink, float angle, float sharpness){",
+  "  float c = cos(angle);",
+  "  float s = sin(angle);",
+  "  vec2 q = mat2(c, -s, s, c) * p;",
+  "  vec2 d = fract(q) - 0.5;",
+  "  float radius = sqrt(clamp(ink, 0.0, 1.0)) * 0.68;",
+  "  float edge = mix(0.16, 0.025, sharpness);",
+  "  return 1.0 - smoothstep(radius - edge, radius + edge, length(d));",
+  "}",
+  "vec3 paletteColor(float index);",
+  "float monoScreenMask(vec2 local, float radius, float shape, float softness){",
+  "  vec2 centered = local - 0.5;",
+  "  float distanceToInk = length(centered);",
+  "  if (shape > 0.5 && shape < 1.5) distanceToInk = max(abs(centered.x), abs(centered.y));",
+  "  if (shape > 1.5 && shape < 2.5) distanceToInk = abs(centered.x) + abs(centered.y);",
+  "  if (shape > 2.5 && shape < 3.5) distanceToInk = max(abs(centered.x) * 0.86 + centered.y * 0.5, -centered.y);",
+  "  if (shape > 3.5) distanceToInk = abs(centered.y);",
+  "  float shapeRadius = shape > 3.5 ? radius * 0.45 : radius;",
+  "  return 1.0 - smoothstep(shapeRadius, shapeRadius + softness, distanceToInk);",
+  "}",
+  "vec3 applyMonoScreen(vec3 source, float amount){",
+  "  if (amount <= 0.0) return source;",
+  "  float invert = step(0.5, u_monoScreenInvert);",
+  "  float coverage = mix(1.0 - lumaOf(source), lumaOf(source), invert);",
+  "  coverage = pow(clamp(coverage, 0.0, 1.0), mix(1.7, 0.58, clamp(u_monoScreenSpread, 0.0, 1.0)));",
+  "  float scale = max(min(u_resolution.x, u_resolution.y) / 540.0, 0.25);",
+  "  float cellPx = mix(4.0, 18.0, clamp(u_monoScreenSize, 0.0, 1.0)) * scale;",
+  "  float angle = clamp(u_monoScreenAngle, 0.0, 1.0) * PI * 0.5;",
+  "  float cosine = cos(angle);",
+  "  float sine = sin(angle);",
+  "  vec2 point = mat2(cosine, -sine, sine, cosine) * gl_FragCoord.xy / max(cellPx, 1.0);",
+  "  float radius = sqrt(coverage) * 0.68;",
+  "  float inkMask = monoScreenMask(fract(point), radius, floor(u_monoScreenShape + 0.5), 0.035);",
+  "  vec3 ink = paletteColor(0.0);",
+  "  vec3 paper = paletteColor(max(u_paletteSize - 1.0, 1.0));",
+  "  return mix(source, mix(paper, ink, inkMask), amount);",
+  "}",
+  "vec3 applyEngraving(vec3 source, float amount){",
+  "  if (amount <= 0.0) return source;",
+  "  float spacing = mix(3.0, 20.0, clamp(u_engravingSpacing, 0.0, 1.0));",
+  "  float minThickness = mix(0.0, 2.0, clamp(u_engravingMinThickness, 0.0, 1.0));",
+  "  float maxThickness = mix(1.0, 8.0, clamp(u_engravingMaxThickness, 0.0, 1.0));",
+  "  float angle = clamp(u_engravingAngle, 0.0, 1.0) * PI;",
+  "  vec2 alongAxis = vec2(cos(angle), sin(angle));",
+  "  vec2 acrossAxis = vec2(-alongAxis.y, alongAxis.x);",
+  "  float along = dot(gl_FragCoord.xy, alongAxis);",
+  "  float across = dot(gl_FragCoord.xy, acrossAxis);",
+  "  float frequency = mix(1.0, 10.0, clamp(u_engravingWaveFrequency, 0.0, 1.0));",
+  "  float wave = sin(along * frequency * 0.01);",
+  "  across += wave * clamp(u_engravingWave, 0.0, 1.0) * 3.0;",
+  "  float lineIndex = floor(across / max(spacing, 1.0));",
+  "  float lineDistance = abs(fract(across / max(spacing, 1.0)) - 0.5) * spacing;",
+  "  float contrast = mix(0.5, 2.0, clamp(u_engravingContrast, 0.0, 1.0));",
+  "  float darkness = 1.0 - pow(clamp(lumaOf(source), 0.0, 1.0), contrast);",
+  "  float variation = mix(0.88, 1.12, digitalHash(vec2(lineIndex, 73.0)));",
+  "  float thickness = mix(minThickness, maxThickness, darkness) * variation;",
+  "  float edge = mix(1.0, 0.3, clamp(u_engravingSharpness, 0.0, 1.0));",
+  "  float inkMask = 1.0 - smoothstep(max(thickness * 0.5 - edge, 0.0), thickness * 0.5 + edge, lineDistance);",
+  "  inkMask *= smoothstep(0.015, 0.12, darkness);",
+  "  vec3 ink = paletteColor(0.0);",
+  "  vec3 paper = paletteColor(max(u_paletteSize - 1.0, 1.0));",
+  "  return mix(source, mix(paper, ink, inkMask), amount);",
+  "}",
+  "float crosshatchLine(vec2 pixel, float angle, float spacing, float thickness, float seed){",
+  "  vec2 alongAxis = vec2(cos(angle), sin(angle));",
+  "  vec2 acrossAxis = vec2(-alongAxis.y, alongAxis.x);",
+  "  float along = dot(pixel, alongAxis);",
+  "  float across = dot(pixel, acrossAxis);",
+  "  float frequency = mix(1.0, 10.0, clamp(u_crosshatchWaveFrequency, 0.0, 1.0));",
+  "  across += sin(along * frequency * 0.02 + u_effectTime + seed) * clamp(u_crosshatchWave, 0.0, 1.0) * 5.0;",
+  "  float lineIndex = floor(across / max(spacing, 1.0));",
+  "  float distanceToLine = abs(fract(across / max(spacing, 1.0)) - 0.5) * spacing;",
+  "  float variation = mix(1.0, 0.5 + digitalHash(vec2(lineIndex, seed)), clamp(u_crosshatchLineWeight, 0.0, 1.0));",
+  "  float halfWidth = thickness * variation * 0.5;",
+  "  return 1.0 - smoothstep(max(halfWidth - 0.5, 0.0), halfWidth + 0.5, distanceToLine);",
+  "}",
+  "float crosshatchEdge(vec2 uv){",
+  "  vec2 texel = 1.0 / max(u_resolution * u_uvScale, vec2(1.0));",
+  "  float tl = lumaOf(sampleMedia(uv + texel * vec2(-1.0, -1.0)).rgb);",
+  "  float tc = lumaOf(sampleMedia(uv + texel * vec2( 0.0, -1.0)).rgb);",
+  "  float tr = lumaOf(sampleMedia(uv + texel * vec2( 1.0, -1.0)).rgb);",
+  "  float ml = lumaOf(sampleMedia(uv + texel * vec2(-1.0,  0.0)).rgb);",
+  "  float mr = lumaOf(sampleMedia(uv + texel * vec2( 1.0,  0.0)).rgb);",
+  "  float bl = lumaOf(sampleMedia(uv + texel * vec2(-1.0,  1.0)).rgb);",
+  "  float bc = lumaOf(sampleMedia(uv + texel * vec2( 0.0,  1.0)).rgb);",
+  "  float br = lumaOf(sampleMedia(uv + texel * vec2( 1.0,  1.0)).rgb);",
+  "  float gx = -tl - 2.0 * ml - bl + tr + 2.0 * mr + br;",
+  "  float gy = -tl - 2.0 * tc - tr + bl + 2.0 * bc + br;",
+  "  return length(vec2(gx, gy));",
+  "}",
+  "vec3 applyCrosshatch(vec2 uv, vec3 source, float amount){",
+  "  if (amount <= 0.0) return source;",
+  "  float spacing = mix(5.0, 30.0, clamp(u_crosshatchSpacing, 0.0, 1.0));",
+  "  float thickness = mix(1.0, 5.0, clamp(u_crosshatchThickness, 0.0, 1.0));",
+  "  float baseAngle = -clamp(u_crosshatchAngle, 0.0, 1.0) * PI;",
+  "  float contrast = mix(0.5, 2.0, clamp(u_crosshatchContrast, 0.0, 1.0));",
+  "  float darkness = 1.0 - pow(clamp(lumaOf(source), 0.0, 1.0), contrast);",
+  "  vec3 ink = paletteColor(0.0);",
+  "  vec3 paper = paletteColor(max(u_paletteSize - 1.0, 1.0));",
+  "  vec3 result = paper;",
+  "  float layer = crosshatchLine(gl_FragCoord.xy, baseAngle, spacing, thickness, 1.0) * smoothstep(0.2, 0.4, darkness);",
+  "  result = mix(result, ink, layer);",
+  "  layer = crosshatchLine(gl_FragCoord.xy, baseAngle + PI * 0.5, spacing * 0.95, thickness * 0.9, 2.0) * smoothstep(0.4, 0.6, darkness);",
+  "  result = mix(result, ink, layer);",
+  "  layer = crosshatchLine(gl_FragCoord.xy, baseAngle + PI * 0.25, spacing * 0.9, thickness * 0.8, 3.0) * smoothstep(0.6, 0.8, darkness);",
+  "  result = mix(result, ink, layer);",
+  "  layer = crosshatchLine(gl_FragCoord.xy, baseAngle - PI * 0.25, spacing * 0.85, thickness * 0.7, 4.0) * smoothstep(0.75, 0.9, darkness);",
+  "  result = mix(result, ink, layer);",
+  "  result = mix(result, ink, smoothstep(0.9, 1.0, darkness) * 0.8);",
+  "  float edgeStrength = mix(0.0, 2.0, clamp(u_crosshatchEdges, 0.0, 1.0));",
+  "  float edge = smoothstep(0.1, 0.3, crosshatchEdge(uv)) * edgeStrength;",
+  "  result = mix(result, ink, clamp(edge, 0.0, 1.0));",
+  "  return mix(source, result, amount);",
+  "}",
+  "vec3 applyHalftone(vec3 source, float amount){",
+  "  if (amount <= 0.0) return source;",
+  "  vec3 cmy = 1.0 - source;",
+  "  float k = min(cmy.r, min(cmy.g, cmy.b));",
+  "  vec3 inks = max(cmy - vec3(k * 0.72), 0.0);",
+  "  float scale = min(u_resolution.x, u_resolution.y) / 540.0;",
+  "  float cellPx = mix(5.0, 14.0, clamp(u_halftoneSize, 0.0, 1.0)) * max(scale, 0.25);",
+  "  vec2 p = gl_FragCoord.xy / max(cellPx, 1.0);",
+  "  float cyan = screenDot(p, inks.r, 0.261799, 0.78);",
+  "  float magenta = screenDot(p, inks.g, 1.308997, 0.78);",
+  "  float yellow = screenDot(p, inks.b, 0.0, 0.78);",
+  "  float blackInk = screenDot(p, k, 0.785398, 0.82);",
+  "  vec3 printColor = vec3(0.975, 0.962, 0.925);",
+  "  printColor *= mix(vec3(1.0), vec3(0.05, 0.79, 0.86), cyan);",
+  "  printColor *= mix(vec3(1.0), vec3(0.91, 0.08, 0.48), magenta);",
+  "  printColor *= mix(vec3(1.0), vec3(0.98, 0.83, 0.08), yellow);",
+  "  printColor *= mix(vec3(1.0), vec3(0.035), blackInk * 0.92);",
+  "  return mix(source, printColor, amount);",
+  "}",
+  "vec3 applyTwoInkPrint(vec3 source, float amount){",
+  "  if (amount <= 0.0) return source;",
+  "  float sourceLuma = lumaOf(source);",
+  "  float darkness = 1.0 - sourceLuma;",
+  "  float warmBias = clamp(source.r - (source.g + source.b) * 0.5, -0.35, 0.35);",
+  "  float coolBias = clamp((source.g + source.b) * 0.5 - source.r, -0.35, 0.35);",
+  "  float redTone = smoothstep(0.08, 0.72, darkness) * (1.0 - 0.68 * smoothstep(0.66, 1.0, darkness));",
+  "  float tealTone = smoothstep(0.30, 0.92, darkness);",
+  "  float redCoverage = clamp(redTone + warmBias * 1.35 - coolBias * 0.35, 0.0, 1.0);",
+  "  float tealCoverage = clamp(tealTone + coolBias * 1.1 - warmBias * 0.45, 0.0, 1.0);",
+  "  float scale = min(u_resolution.x, u_resolution.y) / 540.0;",
+  "  float cellPx = mix(4.5, 12.0, clamp(u_twoInkPrintSize, 0.0, 1.0)) * max(scale, 0.25);",
+  "  vec2 p = gl_FragCoord.xy / max(cellPx, 1.0);",
+  "  float redDot = screenDot(p, redCoverage, 0.261799, 0.84);",
+  "  float tealDot = screenDot(p + vec2(0.12, -0.08), tealCoverage, 1.308997, 0.84);",
+  "  float paperNoise = grainHash(floor(gl_FragCoord.xy * 0.5)) - 0.5;",
+  "  vec3 paper = vec3(0.955, 0.910, 0.795) + paperNoise * 0.018;",
+  "  vec3 vermilion = vec3(0.88, 0.13, 0.075);",
+  "  vec3 teal = vec3(0.035, 0.285, 0.355);",
+  "  vec3 overprint = vec3(0.045, 0.055, 0.052);",
+  "  vec3 printColor = paper * (1.0 - redDot) * (1.0 - tealDot);",
+  "  printColor += vermilion * redDot * (1.0 - tealDot);",
+  "  printColor += teal * (1.0 - redDot) * tealDot;",
+  "  printColor += overprint * redDot * tealDot;",
+  "  return mix(source, clamp(printColor, 0.0, 1.0), amount);",
+  "}",
+  "vec3 paletteColor(float index){",
+  "  if (index < 0.5) return u_palette0;",
+  "  if (index < 1.5) return u_palette1;",
+  "  if (index < 2.5) return u_palette2;",
+  "  if (index < 3.5) return u_palette3;",
+  "  if (index < 4.5) return u_palette4;",
+  "  return u_palette5;",
+  "}",
+  "float bayer4(vec2 point){",
+  "  vec2 cell = mod(floor(point), 4.0);",
+  "  if (cell.y < 0.5) {",
+  "    if (cell.x < 0.5) return 0.5 / 16.0;",
+  "    if (cell.x < 1.5) return 8.5 / 16.0;",
+  "    if (cell.x < 2.5) return 2.5 / 16.0;",
+  "    return 10.5 / 16.0;",
+  "  }",
+  "  if (cell.y < 1.5) {",
+  "    if (cell.x < 0.5) return 12.5 / 16.0;",
+  "    if (cell.x < 1.5) return 4.5 / 16.0;",
+  "    if (cell.x < 2.5) return 14.5 / 16.0;",
+  "    return 6.5 / 16.0;",
+  "  }",
+  "  if (cell.y < 2.5) {",
+  "    if (cell.x < 0.5) return 3.5 / 16.0;",
+  "    if (cell.x < 1.5) return 11.5 / 16.0;",
+  "    if (cell.x < 2.5) return 1.5 / 16.0;",
+  "    return 9.5 / 16.0;",
+  "  }",
+  "  if (cell.x < 0.5) return 15.5 / 16.0;",
+  "  if (cell.x < 1.5) return 7.5 / 16.0;",
+  "  if (cell.x < 2.5) return 13.5 / 16.0;",
+  "  return 5.5 / 16.0;",
+  "}",
+  "float standardAsciiSample(float brightness, vec2 grid){",
+  "  if (brightness < 0.1) return 0.0;",
+  "  if (brightness < 0.2) return grid.x == 2.0 && grid.y == 5.0 ? 1.0 : 0.0;",
+  "  if (brightness < 0.3) return grid.x == 2.0 && (grid.y == 2.0 || grid.y == 4.0) ? 1.0 : 0.0;",
+  "  if (brightness < 0.4) return (grid.y == 2.0 || grid.y == 4.0) && grid.x >= 1.0 && grid.x <= 3.0 ? 1.0 : 0.0;",
+  "  if (brightness < 0.5) {",
+  "    bool cross = (grid.x == 2.0 && grid.y >= 2.0 && grid.y <= 4.0) || (grid.y == 3.0 && grid.x >= 1.0 && grid.x <= 3.0);",
+  "    bool diagonals = (grid.x == 1.0 || grid.x == 3.0) && (grid.y == 2.0 || grid.y == 4.0);",
+  "    return cross || diagonals ? 1.0 : 0.0;",
+  "  }",
+  "  if (brightness < 0.6) {",
+  "    bool ring = ((grid.y == 2.0 || grid.y == 4.0) && grid.x >= 1.0 && grid.x <= 3.0) || ((grid.x == 1.0 || grid.x == 3.0) && grid.y == 3.0);",
+  "    return ring ? 1.0 : 0.0;",
+  "  }",
+  "  bool outline = ((grid.y == 1.0 || grid.y == 5.0) && grid.x >= 1.0 && grid.x <= 3.0) || ((grid.x == 0.0 || grid.x == 4.0) && grid.y >= 2.0 && grid.y <= 4.0) || ((grid.x == 1.0 || grid.x == 3.0) && grid.y >= 1.0 && grid.y <= 5.0);",
+  "  if (brightness < 0.7) return outline ? 1.0 : 0.0;",
+  "  if (brightness < 0.8) {",
+  "    bool slash = abs(grid.x - 2.0) == abs(grid.y - 3.0) && grid.x >= 1.0 && grid.x <= 3.0;",
+  "    return outline || slash ? 1.0 : 0.0;",
+  "  }",
+  "  if (brightness < 0.9) {",
+  "    bool loops = ((grid.y == 1.0 || grid.y == 3.0 || grid.y == 5.0) && grid.x >= 1.0 && grid.x <= 3.0) || ((grid.x == 1.0 || grid.x == 3.0) && (grid.y == 2.0 || grid.y == 4.0));",
+  "    return loops ? 1.0 : 0.0;",
+  "  }",
+  "  return 1.0;",
+  "}",
+  "float asciiStyleSample(float style, float brightness, vec2 uv){",
+  "  vec2 grid = floor(uv * vec2(5.0, 7.0));",
+  "  if (style < 0.5) return standardAsciiSample(brightness, grid);",
+  "  if (style < 1.5) {",
+  "    float checker = mod(grid.x + grid.y, 2.0);",
+  "    float ruled = mod(grid.x, 2.0) == 0.0 || mod(grid.y, 2.0) == 0.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.125) return 0.0;",
+  "    if (brightness < 0.25) return checker == 0.0 ? 0.5 : 0.0;",
+  "    if (brightness < 0.375) return ruled * 0.6;",
+  "    if (brightness < 0.5) return checker == 0.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.625) return ruled > 0.5 ? 1.0 : 0.3;",
+  "    if (brightness < 0.75) return checker == 0.0 ? 1.0 : 0.7;",
+  "    if (brightness < 0.875) return ruled > 0.5 ? 1.0 : 0.85;",
+  "    return 1.0;",
+  "  }",
+  "  if (style < 2.5) {",
+  "    if (brightness < 0.14) return 0.0;",
+  "    if (brightness < 0.28) return grid.x == 2.0 && grid.y == 1.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.42) return grid.x == 2.0 && grid.y == 5.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.56) return grid.y == 3.0 && grid.x >= 1.0 && grid.x <= 3.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.7) return (grid.x == 2.0 && grid.y >= 2.0 && grid.y <= 4.0) || (grid.y == 3.0 && grid.x >= 1.0 && grid.x <= 3.0) ? 1.0 : 0.0;",
+  "    if (brightness < 0.84) return abs(grid.x - 2.0) == abs(grid.y - 3.0) && grid.y >= 2.0 && grid.y <= 4.0 ? 1.0 : 0.0;",
+  "    return grid.x == 1.0 || grid.x == 3.0 || grid.y == 2.0 || grid.y == 4.0 ? 1.0 : 0.0;",
+  "  }",
+  "  if (style < 3.5) return grid.y >= 6.0 - brightness * 7.0 ? 1.0 : 0.0;",
+  "  if (style < 4.5) {",
+  "    vec2 dots = floor(uv * vec2(2.0, 4.0));",
+  "    if (brightness < 0.125) return 0.0;",
+  "    if (brightness < 0.25) return dots.y == 3.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.375) return dots.y >= 2.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.5) return dots.y >= 1.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.625) return dots.y >= 1.0 || dots.x == 1.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.75) return 1.0;",
+  "    if (brightness < 0.875) return mod(grid.x + grid.y, 2.0) < 1.5 ? 1.0 : 0.7;",
+  "    return 1.0;",
+  "  }",
+  "  if (style < 5.5) {",
+  "    if (brightness < 0.125) return 0.0;",
+  "    if (brightness < 0.25) return grid.x == 2.0 && grid.y == 3.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.375) return grid.y == 3.0 && grid.x >= 1.0 && grid.x <= 3.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.5) return grid.x + grid.y == 5.0 || grid.x + grid.y == 6.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.625) return grid.x == 2.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.75) return abs(grid.x - grid.y / 1.4) < 0.7 && grid.x >= 1.0 && grid.x <= 3.0 ? 1.0 : 0.0;",
+  "    if (brightness < 0.875) return grid.x == 2.0 || grid.y == 3.0 ? 1.0 : 0.0;",
+  "    return grid.x == 1.0 || grid.x == 3.0 || grid.y == 2.0 || grid.y == 4.0 ? 1.0 : 0.0;",
+  "  }",
+  "  if (style < 6.5) {",
+  "    bool top = grid.y == 0.0 && grid.x >= 1.0 && grid.x <= 3.0;",
+  "    bool topLeft = grid.x == 1.0 && grid.y <= 3.0;",
+  "    bool topRight = grid.x == 3.0 && grid.y <= 3.0;",
+  "    bool middle = grid.y == 3.0 && grid.x >= 1.0 && grid.x <= 3.0;",
+  "    bool bottomLeft = grid.x == 1.0 && grid.y >= 3.0;",
+  "    bool bottomRight = grid.x == 3.0 && grid.y >= 3.0;",
+  "    bool bottom = grid.y == 6.0 && grid.x >= 1.0 && grid.x <= 3.0;",
+  "    if (brightness < 0.1) return 0.0;",
+  "    if (brightness < 0.2) return topRight || bottomRight ? 1.0 : 0.0;",
+  "    if (brightness < 0.3) return top || topRight || middle || bottomLeft || bottom ? 1.0 : 0.0;",
+  "    if (brightness < 0.4) return top || topRight || middle || bottomRight || bottom ? 1.0 : 0.0;",
+  "    if (brightness < 0.5) return topLeft || middle || topRight || bottomRight ? 1.0 : 0.0;",
+  "    if (brightness < 0.6) return top || topLeft || middle || bottomRight || bottom ? 1.0 : 0.0;",
+  "    if (brightness < 0.7) return top || topLeft || middle || bottomLeft || bottomRight || bottom ? 1.0 : 0.0;",
+  "    if (brightness < 0.8) return top || topRight || bottomRight ? 1.0 : 0.0;",
+  "    if (brightness < 0.9) return top || topLeft || topRight || middle || bottomLeft || bottomRight || bottom ? 1.0 : 0.0;",
+  "    return top || topLeft || topRight || middle || bottomRight || bottom ? 1.0 : 0.0;",
+  "  }",
+  "  float slash = grid.x - grid.y;",
+  "  float backslash = grid.x + grid.y;",
+  "  if (brightness < 0.16) return 0.0;",
+  "  if (brightness < 0.33) return mod(slash, 3.0) < 0.5 ? 1.0 : 0.0;",
+  "  if (brightness < 0.5) return mod(slash, 2.0) < 0.5 ? 1.0 : 0.0;",
+  "  bool diagonalA = mod(slash, 2.0) < 0.5;",
+  "  bool diagonalB = mod(backslash, 2.0) < 0.5;",
+  "  if (brightness < 0.66) return diagonalA || diagonalB ? 1.0 : 0.0;",
+  "  if (brightness < 0.83) return mod(slash, 1.5) < 0.5 || mod(backslash, 1.5) < 0.5 ? 1.0 : 0.2;",
+  "  return mod(slash, 1.0) < 0.6 || mod(backslash, 1.0) < 0.6 ? 1.0 : 0.5;",
+  "}",
   "vec3 sampleLut(float r, float g, float b){",
   "  float size = max(u_lutSize, 2.0);",
   "  float x = (r + b * size + 0.5) / max(u_lutTextureSize.x, 1.0);",
@@ -377,16 +962,8 @@ const FRAGMENT_SHADER = [
   "  vec3 lutColor = mix(c0, c1, f.b);",
   "  return mix(color, lutColor, clamp(u_lutIntensity, 0.0, 1.0));",
   "}",
-  "void main(){",
-  "  vec2 uv = (v_uv - u_uvOffset) / u_uvScale;",
-  "  if (uv.x < 0.0 || uv.y < 0.0 || uv.x > 1.0 || uv.y > 1.0) {",
-  "    gl_FragColor = vec4(0.0);",
-  "    return;",
-  "  }",
-  "  vec4 originalSample = sampleSource(uv);",
-  "  vec4 sampleColor = sampleMedia(uv);",
-  "  vec3 original = originalSample.rgb;",
-  "  vec3 color = sampleColor.rgb * pow(2.0, u_exposure);",
+  "vec3 applyPrimaryGrade(vec3 color){",
+  "  color *= pow(2.0, u_exposure);",
   "  float y = lumaOf(color);",
   "  float shadowMask = 1.0 - smoothstep(0.0, 0.65, y);",
   "  float highlightMask = smoothstep(0.35, 1.0, y);",
@@ -405,18 +982,85 @@ const FRAGMENT_SHADER = [
   "  float vibranceWeight = (1.0 - currentSat * 0.72) * mix(1.0, 0.55, skinLike);",
   "  color = mix(vec3(satLuma), color, max(0.0, 1.0 + u_vibrance * vibranceWeight));",
   "  color = mix(vec3(satLuma), color, max(0.0, 1.0 + u_saturation));",
-  "  color = clamp(color, 0.0, 1.0);",
-  "  color = clamp(applyLut(color), 0.0, 1.0);",
-  "  vec2 vignetteAspect = u_resolution.x > u_resolution.y",
-  "    ? vec2(u_resolution.x / max(u_resolution.y, 1.0), 1.0)",
-  "    : vec2(1.0, u_resolution.y / max(u_resolution.x, 1.0));",
-  "  vec2 vignetteUv = abs((v_uv - vec2(0.5)) * 2.0) * vignetteAspect;",
-  "  float vignettePower = mix(8.0, 1.8, clamp(u_vignetteRoundness * 0.5 + 0.5, 0.0, 1.0));",
-  "  float vignetteDistance = pow(pow(vignetteUv.x, vignettePower) + pow(vignetteUv.y, vignettePower), 1.0 / vignettePower);",
-  "  float vignetteMidpoint = mix(0.22, 1.08, clamp(u_vignetteMidpoint, 0.0, 1.0));",
-  "  float vignetteFeather = mix(0.08, 0.72, clamp(u_vignetteFeather, 0.0, 1.0));",
-  "  float vignetteMask = smoothstep(vignetteMidpoint, vignetteMidpoint + vignetteFeather, vignetteDistance);",
-  "  color *= 1.0 - vignetteMask * clamp(u_vignette, 0.0, 1.0) * 0.75;",
+  "  return clamp(applyLut(clamp(color, 0.0, 1.0)), 0.0, 1.0);",
+  "}",
+  "vec3 applyDither(vec3 source, float amount){",
+  "  if (amount <= 0.0) return source;",
+  "  float scale = max(min(u_resolution.x, u_resolution.y) / 540.0, 0.25);",
+  "  float pixelSize = mix(1.0, 5.0, clamp(u_ditherSize, 0.0, 1.0)) * scale;",
+  "  vec2 block = floor(gl_FragCoord.xy / max(pixelSize, 1.0));",
+  "  float levels = clamp(u_paletteSize, 2.0, 6.0);",
+  "  float index = floor(clamp(lumaOf(source) * (levels - 1.0) + bayer4(block), 0.0, levels - 1.0));",
+  "  return mix(source, paletteColor(index), amount);",
+  "}",
+  "vec2 asciiEdgeDirection(vec2 uv, vec2 stepUv){",
+  "  float topLeft = bt601Luma(sampleMedia(uv + vec2(-stepUv.x, -stepUv.y)).rgb);",
+  "  float top = bt601Luma(sampleMedia(uv + vec2(0.0, -stepUv.y)).rgb);",
+  "  float topRight = bt601Luma(sampleMedia(uv + vec2(stepUv.x, -stepUv.y)).rgb);",
+  "  float left = bt601Luma(sampleMedia(uv + vec2(-stepUv.x, 0.0)).rgb);",
+  "  float right = bt601Luma(sampleMedia(uv + vec2(stepUv.x, 0.0)).rgb);",
+  "  float bottomLeft = bt601Luma(sampleMedia(uv + vec2(-stepUv.x, stepUv.y)).rgb);",
+  "  float bottom = bt601Luma(sampleMedia(uv + vec2(0.0, stepUv.y)).rgb);",
+  "  float bottomRight = bt601Luma(sampleMedia(uv + stepUv).rgb);",
+  "  float x = -topLeft - 2.0 * left - bottomLeft + topRight + 2.0 * right + bottomRight;",
+  "  float y = -topLeft - 2.0 * top - topRight + bottomLeft + 2.0 * bottom + bottomRight;",
+  "  return vec2(x, y);",
+  "}",
+  "vec2 rotateAsciiUv(vec2 uv, float angle){",
+  "  float cosine = cos(angle);",
+  "  float sine = sin(angle);",
+  "  vec2 centered = uv - 0.5;",
+  "  return vec2(centered.x * cosine - centered.y * sine, centered.x * sine + centered.y * cosine) + 0.5;",
+  "}",
+  "vec3 applyAscii(vec3 source, float amount){",
+  "  if (amount <= 0.0) return source;",
+  "  float scale = max(min(u_resolution.x, u_resolution.y) / 540.0, 0.25);",
+  "  float cellHeight = mix(4.0, 80.0, clamp(u_asciiSize, 0.0, 1.0)) * scale;",
+  "  vec2 cellSize = vec2(cellHeight);",
+  "  vec2 cell = floor(gl_FragCoord.xy / cellSize);",
+  "  vec2 cellVuv = (cell + 0.5) * cellSize / max(u_resolution, vec2(1.0));",
+  "  vec2 cellUv = (cellVuv - u_uvOffset) / u_uvScale;",
+  "  cellUv = applyCrtWarp(cellUv);",
+  "  vec3 cellColor = applyPrimaryGrade(sampleMedia(cellUv).rgb);",
+  "  float brightness = bt601Luma(cellColor);",
+  "  float invert = step(0.5, u_asciiInvert);",
+  "  brightness = mix(brightness, 1.0 - brightness, invert);",
+  "  vec2 glyphUv = fract(gl_FragCoord.xy / cellSize);",
+  "  float rotation = clamp(u_asciiRotation, 0.0, 1.0);",
+  "  if (rotation > 0.0) {",
+  "    vec2 cellStepUv = cellSize / max(u_resolution * u_uvScale, vec2(1.0));",
+  "    vec2 edge = asciiEdgeDirection(cellUv, cellStepUv);",
+  "    if (length(edge) > 0.1) glyphUv = mix(glyphUv, rotateAsciiUv(glyphUv, atan(edge.y, edge.x)), rotation);",
+  "  }",
+  "  float ink = asciiStyleSample(floor(u_asciiStyle + 0.5), brightness, glyphUv);",
+  "  vec3 background = paletteColor(0.0);",
+  "  vec3 inkColor = mix(paletteColor(max(u_paletteSize - 1.0, 1.0)), cellColor, clamp(u_asciiColor, 0.0, 1.0));",
+  "  vec3 asciiColor = mix(background, inkColor, ink);",
+  "  return mix(source, asciiColor, amount);",
+  "}",
+  "vec3 applyScanlines(vec3 source, float amount){",
+  "  if (amount <= 0.0) return source;",
+  "  float count = mix(50.0, 500.0, clamp(u_scanlineCount, 0.0, 1.0));",
+  "  float softness = clamp(u_scanlineSoftness, 0.0, 1.0);",
+  "  float wave = 0.5 + 0.5 * sin(v_uv.y * count * PI);",
+  "  float line = mix(1.0 - wave, pow(1.0 - wave, 2.2), softness);",
+  "  return source * (1.0 - line * amount);",
+  "}",
+  "void main(){",
+  "  vec2 uv = (v_uv - u_uvOffset) / u_uvScale;",
+  "  if (uv.x < 0.0 || uv.y < 0.0 || uv.x > 1.0 || uv.y > 1.0) {",
+  "    gl_FragColor = vec4(0.0);",
+  "    return;",
+  "  }",
+  "  vec4 originalSample = sampleSource(uv);",
+  "  uv = applyCrtWarp(uv);",
+  "  vec2 displayEdge = smoothstep(vec2(0.0), vec2(0.006), uv) * (1.0 - smoothstep(vec2(0.994), vec2(1.0), uv));",
+  "  float displayMask = displayEdge.x * displayEdge.y;",
+  "  vec4 sampleColor = sampleMedia(uv);",
+  "  sampleColor = sampleChromaticMedia(uv, sampleColor);",
+  "  sampleColor.rgb = applyDigitalGlitch(uv, sampleColor.rgb);",
+  "  vec3 original = originalSample.rgb;",
+  "  vec3 color = mix(sampleColor.rgb, applyPrimaryGrade(sampleColor.rgb), u_intensity);",
   "  float grainAmount = clamp(u_grain, 0.0, 1.0);",
   "  if (grainAmount > 0.0) {",
   "    float grainPixelSize = mix(1.0, 6.0, clamp(u_grainSize, 0.0, 1.0));",
@@ -428,8 +1072,40 @@ const FRAGMENT_SHADER = [
   "    float grainMask = smoothstep(0.02, 0.55, grainLuma) * (1.0 - smoothstep(0.88, 1.0, grainLuma));",
   "    color += grain * grainAmount * mix(0.025, 0.08, grainMask);",
   "  }",
-  "  color = clamp(color, 0.0, 1.0);",
-  "  vec3 graded = mix(original, color, u_intensity);",
+  "  float filmArtifacts = clamp(u_filmArtifacts, 0.0, 1.0);",
+  "  if (filmArtifacts > 0.0) {",
+  "    float filmFrame = floor(u_grainSeed);",
+  "    float dust = dustMask(v_uv, floor(filmFrame / 3.0));",
+  "    float dustTone = grainHash(vec2(floor(filmFrame / 3.0), 8.0));",
+  "    color = mix(color, vec3(dustTone > 0.5 ? 0.95 : 0.02), dust * 0.72 * filmArtifacts);",
+  "    float scratchBucket = floor(filmFrame / 12.0);",
+  "    float scratchX = grainHash(vec2(scratchBucket, 4.2));",
+  "    float scratchLife = step(0.78, grainHash(vec2(scratchBucket, 8.4)));",
+  "    float scratch = (1.0 - smoothstep(0.0, 1.4 / max(u_resolution.x, 1.0), abs(v_uv.x - scratchX))) * scratchLife;",
+  "    color = mix(color, vec3(0.94, 0.88, 0.76), scratch * 0.28 * filmArtifacts);",
+  "  }",
+  "  color = applyMonoScreen(clamp(color, 0.0, 1.0), clamp(u_monoScreen, 0.0, 1.0));",
+  "  color = applyEngraving(clamp(color, 0.0, 1.0), clamp(u_engraving, 0.0, 1.0));",
+  "  color = applyCrosshatch(uv, clamp(color, 0.0, 1.0), clamp(u_crosshatch, 0.0, 1.0));",
+  "  color = applyHalftone(clamp(color, 0.0, 1.0), clamp(u_halftone, 0.0, 1.0));",
+  "  color = applyTwoInkPrint(clamp(color, 0.0, 1.0), clamp(u_twoInkPrint, 0.0, 1.0));",
+  "  color = applyDither(clamp(color, 0.0, 1.0), clamp(u_dither, 0.0, 1.0));",
+  "  color = applyAscii(clamp(color, 0.0, 1.0), clamp(u_ascii, 0.0, 1.0));",
+  "  if (u_bloomReady > 0.5 && u_bloom > 0.0) color += sampleBloom(uv) * u_bloom;",
+  "  color = applyScanlines(clamp(color, 0.0, 1.0), clamp(u_scanlines, 0.0, 1.0));",
+  "  vec2 vignetteAspect = u_resolution.x > u_resolution.y",
+  "    ? vec2(u_resolution.x / max(u_resolution.y, 1.0), 1.0)",
+  "    : vec2(1.0, u_resolution.y / max(u_resolution.x, 1.0));",
+  "  vec2 vignetteUv = abs((v_uv - vec2(0.5)) * 2.0) * vignetteAspect;",
+  "  float vignettePower = mix(8.0, 1.8, clamp(u_vignetteRoundness * 0.5 + 0.5, 0.0, 1.0));",
+  "  float vignetteDistance = pow(pow(vignetteUv.x, vignettePower) + pow(vignetteUv.y, vignettePower), 1.0 / vignettePower);",
+  "  float vignetteMidpoint = mix(0.22, 1.08, clamp(u_vignetteMidpoint, 0.0, 1.0));",
+  "  float vignetteFeather = mix(0.08, 0.72, clamp(u_vignetteFeather, 0.0, 1.0));",
+  "  float vignetteMask = smoothstep(vignetteMidpoint, vignetteMidpoint + vignetteFeather, vignetteDistance);",
+  "  color *= 1.0 - vignetteMask * clamp(u_vignette, 0.0, 1.0) * 0.75;",
+  "  float warpActive = step(0.0001, u_crtCurvature);",
+  "  color *= mix(1.0, displayMask, warpActive);",
+  "  vec3 graded = clamp(color, 0.0, 1.0);",
   "  if (u_compareEnabled > 0.5) {",
   "    float pos = clamp(u_comparePosition, 0.0, 1.0);",
   "    float softness = max(u_compareSoftness, 0.00001);",
@@ -458,12 +1134,33 @@ const BLUR_FRAGMENT_SHADER = [
   "uniform vec2 u_resolution;",
   "uniform vec2 u_direction;",
   "uniform float u_radius;",
+  "uniform float u_bloomPass;",
+  "uniform float u_threshold;",
   "vec4 readSource(vec2 uv){",
   "  vec4 color = texture2D(u_source, clamp(uv, vec2(0.0), vec2(1.0)));",
+  "  if (u_bloomPass > 0.5) {",
+  "    float luminance = dot(color.rgb, vec3(0.299, 0.587, 0.114));",
+  "    if (u_threshold >= 0.0 && luminance <= u_threshold) color.rgb = vec3(0.0);",
+  "    return vec4(color.rgb, 1.0);",
+  "  }",
   "  color.rgb *= color.a;",
   "  return color;",
   "}",
   "void main(){",
+  "  if (u_bloomPass > 0.5) {",
+  "    vec2 stepUv = u_direction * max(u_radius, 0.0) / max(u_resolution, vec2(1.0)) * 0.5;",
+  "    vec4 bloom = readSource(v_uv) * 0.227027;",
+  "    bloom += readSource(v_uv + stepUv) * 0.1945946;",
+  "    bloom += readSource(v_uv - stepUv) * 0.1945946;",
+  "    bloom += readSource(v_uv + stepUv * 2.0) * 0.1216216;",
+  "    bloom += readSource(v_uv - stepUv * 2.0) * 0.1216216;",
+  "    bloom += readSource(v_uv + stepUv * 3.0) * 0.054054;",
+  "    bloom += readSource(v_uv - stepUv * 3.0) * 0.054054;",
+  "    bloom += readSource(v_uv + stepUv * 4.0) * 0.016216;",
+  "    bloom += readSource(v_uv - stepUv * 4.0) * 0.016216;",
+  "    gl_FragColor = bloom;",
+  "    return;",
+  "  }",
   "  vec2 stepUv = u_direction * max(u_radius, 0.0) / max(u_resolution, vec2(1.0)) / 12.0;",
   "  vec4 color = readSource(v_uv) * 0.08077993;",
   "  color += readSource(v_uv + stepUv * 1.0) * 0.07918038;",
@@ -495,10 +1192,109 @@ const BLUR_FRAGMENT_SHADER = [
   "}",
 ].join("\n");
 
+const KUWAHARA_HORIZONTAL_FRAGMENT_SHADER = [
+  "#ifdef GL_FRAGMENT_PRECISION_HIGH",
+  "precision highp float;",
+  "#else",
+  "precision mediump float;",
+  "#endif",
+  "varying vec2 v_uv;",
+  "uniform sampler2D u_source;",
+  "uniform sampler2D u_blurSource;",
+  "uniform vec2 u_texel;",
+  "uniform vec2 u_uvScale;",
+  "uniform vec2 u_uvOffset;",
+  "uniform float u_blurReady;",
+  "uniform float u_blur;",
+  "uniform float u_kuwaharaRadius;",
+  "vec3 readPrepared(vec2 displayUv){",
+  "  vec2 uv = (displayUv - u_uvOffset) / u_uvScale;",
+  "  vec3 color = texture2D(u_source, clamp(uv, vec2(0.0), vec2(1.0))).rgb;",
+  "  if (u_blurReady > 0.5 && u_blur > 0.0) {",
+  "    vec3 blurred = texture2D(u_blurSource, clamp(uv, vec2(0.0), vec2(1.0))).rgb;",
+  "    color = mix(color, blurred, clamp(u_blur, 0.0, 1.0));",
+  "  }",
+  "  return color;",
+  "}",
+  "void main(){",
+  "  float radius = floor(mix(2.0, 16.0, clamp(u_kuwaharaRadius, 0.0, 1.0)) + 0.5);",
+  "  vec3 sum = vec3(0.0);",
+  "  float sumSquares = 0.0;",
+  "  float count = 0.0;",
+  "  for (int offset = 0; offset <= 16; offset++) {",
+  "    if (float(offset) > radius) continue;",
+  "    vec3 color = readPrepared(v_uv + vec2(float(offset), 0.0) * u_texel);",
+  "    sum += color;",
+  "    sumSquares += dot(color, color) / 3.0;",
+  "    count += 1.0;",
+  "  }",
+  "  gl_FragColor = vec4(sum / count, sumSquares / count);",
+  "}",
+].join("\n");
+
+const KUWAHARA_RESOLVE_FRAGMENT_SHADER = [
+  "#ifdef GL_FRAGMENT_PRECISION_HIGH",
+  "precision highp float;",
+  "#else",
+  "precision mediump float;",
+  "#endif",
+  "varying vec2 v_uv;",
+  "uniform sampler2D u_kuwaharaMoments;",
+  "uniform vec2 u_texel;",
+  "uniform float u_kuwaharaRadius;",
+  "uniform float u_kuwaharaSharpness;",
+  "uniform float u_kuwaharaSaturation;",
+  "void main(){",
+  "  float radius = floor(mix(2.0, 16.0, clamp(u_kuwaharaRadius, 0.0, 1.0)) + 0.5);",
+  "  vec2 origins[4];",
+  "  origins[0] = vec2(-radius, -radius);",
+  "  origins[1] = vec2(0.0, -radius);",
+  "  origins[2] = vec2(-radius, 0.0);",
+  "  origins[3] = vec2(0.0, 0.0);",
+  "  vec3 means[4];",
+  "  float variances[4];",
+  "  float minVariance = 1.0;",
+  "  for (int quadrant = 0; quadrant < 4; quadrant++) {",
+  "    vec4 moment = vec4(0.0);",
+  "    float count = 0.0;",
+  "    for (int offset = 0; offset <= 16; offset++) {",
+  "      if (float(offset) > radius) continue;",
+  "      vec2 sampleOffset = origins[quadrant] + vec2(0.0, float(offset));",
+  "      moment += texture2D(u_kuwaharaMoments, clamp(v_uv + sampleOffset * u_texel, vec2(0.0), vec2(1.0)));",
+  "      count += 1.0;",
+  "    }",
+  "    moment /= count;",
+  "    vec3 mean = moment.rgb;",
+  "    float meanSquare = moment.a * 3.0;",
+  "    float variance = max(meanSquare - dot(mean, mean), 0.0);",
+  "    means[quadrant] = mean;",
+  "    variances[quadrant] = variance;",
+  "    minVariance = min(minVariance, variance);",
+  "  }",
+  "  float exponent = 1.0 + clamp(u_kuwaharaSharpness, 0.0, 1.0) * 8.0;",
+  "  vec3 result = vec3(0.0);",
+  "  float totalWeight = 0.0;",
+  "  for (int quadrant = 0; quadrant < 4; quadrant++) {",
+  "    float weight = pow((minVariance + 0.0001) / (variances[quadrant] + 0.0001), exponent);",
+  "    result += means[quadrant] * weight;",
+  "    totalWeight += weight;",
+  "  }",
+  "  result /= max(totalWeight, 0.0001);",
+  "  float luma = dot(result, vec3(0.2126, 0.7152, 0.0722));",
+  "  float saturation = clamp(u_kuwaharaSaturation, 0.0, 1.0) * 2.0;",
+  "  gl_FragColor = vec4(clamp(mix(vec3(luma), result, saturation), 0.0, 1.0), 1.0);",
+  "}",
+].join("\n");
+
 function isColorGradingMediaElement(value: Element): value is ColorGradingMediaElement {
   return value instanceof HTMLVideoElement || value instanceof HTMLImageElement;
 }
 
+function isVisibleForColorGrading(element: ColorGradingMediaElement): boolean {
+  const style = window.getComputedStyle(element);
+  return style.display !== "none" && style.visibility !== "hidden";
+}
+
 function compileShader(
   gl: WebGLRenderingContext,
   source: string,
@@ -542,7 +1338,11 @@ function createProgram(
   return program;
 }
 
-function createTexture(gl: WebGLRenderingContext, filter: number = gl.LINEAR): WebGLTexture | null {
+function createTexture(
+  gl: WebGLRenderingContext,
+  filter: number = gl.LINEAR,
+  type: number = gl.UNSIGNED_BYTE,
+): WebGLTexture | null {
   const texture = gl.createTexture();
   if (!texture) return null;
   gl.bindTexture(gl.TEXTURE_2D, texture);
@@ -550,7 +1350,7 @@ function createTexture(gl: WebGLRenderingContext, filter: number = gl.LINEAR): W
   gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
   gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, filter);
   gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, filter);
-  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 1, 1, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 1, 1, 0, gl.RGBA, type, null);
   return texture;
 }
 
@@ -568,11 +1368,56 @@ function createBlurProgramInfo(
     resolution: gl.getUniformLocation(program, "u_resolution"),
     direction: gl.getUniformLocation(program, "u_direction"),
     radius: gl.getUniformLocation(program, "u_radius"),
+    bloomPass: gl.getUniformLocation(program, "u_bloomPass"),
+    threshold: gl.getUniformLocation(program, "u_threshold"),
   };
 }
 
-function createRenderTarget(gl: WebGLRenderingContext): RenderTarget | null {
-  const texture = createTexture(gl);
+function createKuwaharaHorizontalProgramInfo(
+  gl: WebGLRenderingContext,
+  quad: WebGLBuffer,
+): KuwaharaHorizontalProgramInfo | null {
+  const program = createProgram(gl, KUWAHARA_HORIZONTAL_FRAGMENT_SHADER);
+  if (!program) return null;
+  return {
+    program,
+    quad,
+    position: gl.getAttribLocation(program, "a_pos"),
+    source: gl.getUniformLocation(program, "u_source"),
+    blurSource: gl.getUniformLocation(program, "u_blurSource"),
+    texel: gl.getUniformLocation(program, "u_texel"),
+    uvScale: gl.getUniformLocation(program, "u_uvScale"),
+    uvOffset: gl.getUniformLocation(program, "u_uvOffset"),
+    blurReady: gl.getUniformLocation(program, "u_blurReady"),
+    blur: gl.getUniformLocation(program, "u_blur"),
+    radius: gl.getUniformLocation(program, "u_kuwaharaRadius"),
+  };
+}
+
+function createKuwaharaResolveProgramInfo(
+  gl: WebGLRenderingContext,
+  quad: WebGLBuffer,
+): KuwaharaResolveProgramInfo | null {
+  const program = createProgram(gl, KUWAHARA_RESOLVE_FRAGMENT_SHADER);
+  if (!program) return null;
+  return {
+    program,
+    quad,
+    position: gl.getAttribLocation(program, "a_pos"),
+    moments: gl.getUniformLocation(program, "u_kuwaharaMoments"),
+    texel: gl.getUniformLocation(program, "u_texel"),
+    radius: gl.getUniformLocation(program, "u_kuwaharaRadius"),
+    sharpness: gl.getUniformLocation(program, "u_kuwaharaSharpness"),
+    saturation: gl.getUniformLocation(program, "u_kuwaharaSaturation"),
+  };
+}
+
+function createRenderTarget(
+  gl: WebGLRenderingContext,
+  type: number = gl.UNSIGNED_BYTE,
+  filter: number = gl.LINEAR,
+): RenderTarget | null {
+  const texture = createTexture(gl, filter, type);
   const framebuffer = gl.createFramebuffer();
   if (!texture || !framebuffer) {
     if (texture) gl.deleteTexture(texture);
@@ -588,7 +1433,7 @@ function createRenderTarget(gl: WebGLRenderingContext): RenderTarget | null {
     gl.deleteFramebuffer(framebuffer);
     return null;
   }
-  return { texture, framebuffer, width: 1, height: 1 };
+  return { texture, framebuffer, type, width: 1, height: 1 };
 }
 
 function resizeRenderTarget(
@@ -601,7 +1446,20 @@ function resizeRenderTarget(
   target.width = width;
   target.height = height;
   gl.bindTexture(gl.TEXTURE_2D, target.texture);
-  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, width, height, 0, gl.RGBA, gl.UNSIGNED_BYTE, null);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, width, height, 0, gl.RGBA, target.type, null);
+}
+
+function createFloatUniformBindings<K extends string>(
+  gl: WebGLRenderingContext,
+  program: WebGLProgram,
+  keys: readonly K[],
+): readonly FloatUniformBinding<K>[] {
+  const bindings: FloatUniformBinding<K>[] = [];
+  for (const key of keys) {
+    const location = gl.getUniformLocation(program, `u_${key}`);
+    if (location !== null) bindings.push([key, location]);
+  }
+  return bindings;
 }
 
 function createProgramInfo(canvas: HTMLCanvasElement): {
@@ -611,7 +1469,6 @@ function createProgramInfo(canvas: HTMLCanvasElement): {
   const gl = canvas.getContext("webgl", {
     alpha: true,
     premultipliedAlpha: false,
-    preserveDrawingBuffer: true,
   });
   if (!gl) return null;
   const program = createProgram(gl);
@@ -643,37 +1500,33 @@ function createProgramInfo(canvas: HTMLCanvasElement): {
       position: gl.getAttribLocation(program, "a_pos"),
       source: gl.getUniformLocation(program, "u_source"),
       blurSource: gl.getUniformLocation(program, "u_blurSource"),
+      bloomSource: gl.getUniformLocation(program, "u_bloomSource"),
+      kuwaharaSource: gl.getUniformLocation(program, "u_kuwaharaSource"),
       lut: gl.getUniformLocation(program, "u_lut"),
       resolution: gl.getUniformLocation(program, "u_resolution"),
       uvScale: gl.getUniformLocation(program, "u_uvScale"),
       uvOffset: gl.getUniformLocation(program, "u_uvOffset"),
       blurReady: gl.getUniformLocation(program, "u_blurReady"),
+      bloomReady: gl.getUniformLocation(program, "u_bloomReady"),
+      kuwaharaReady: gl.getUniformLocation(program, "u_kuwaharaReady"),
       lutEnabled: gl.getUniformLocation(program, "u_lutEnabled"),
       lutSize: gl.getUniformLocation(program, "u_lutSize"),
       lutTextureSize: gl.getUniformLocation(program, "u_lutTextureSize"),
       lutDomainMin: gl.getUniformLocation(program, "u_lutDomainMin"),
       lutDomainMax: gl.getUniformLocation(program, "u_lutDomainMax"),
       lutIntensity: gl.getUniformLocation(program, "u_lutIntensity"),
-      exposure: gl.getUniformLocation(program, "u_exposure"),
-      contrast: gl.getUniformLocation(program, "u_contrast"),
-      highlights: gl.getUniformLocation(program, "u_highlights"),
-      shadows: gl.getUniformLocation(program, "u_shadows"),
-      whites: gl.getUniformLocation(program, "u_whites"),
-      blacks: gl.getUniformLocation(program, "u_blacks"),
-      temperature: gl.getUniformLocation(program, "u_temperature"),
-      tint: gl.getUniformLocation(program, "u_tint"),
-      vibrance: gl.getUniformLocation(program, "u_vibrance"),
-      saturation: gl.getUniformLocation(program, "u_saturation"),
-      vignette: gl.getUniformLocation(program, "u_vignette"),
-      vignetteMidpoint: gl.getUniformLocation(program, "u_vignetteMidpoint"),
-      vignetteRoundness: gl.getUniformLocation(program, "u_vignetteRoundness"),
-      vignetteFeather: gl.getUniformLocation(program, "u_vignetteFeather"),
-      grain: gl.getUniformLocation(program, "u_grain"),
-      grainSize: gl.getUniformLocation(program, "u_grainSize"),
-      grainRoughness: gl.getUniformLocation(program, "u_grainRoughness"),
+      adjustUniforms: createFloatUniformBindings(gl, program, HF_COLOR_GRADING_ADJUST_KEYS),
+      detailUniforms: createFloatUniformBindings(gl, program, HF_COLOR_GRADING_DETAIL_KEYS),
+      effectUniforms: createFloatUniformBindings(gl, program, HF_COLOR_GRADING_EFFECT_KEYS),
       grainSeed: gl.getUniformLocation(program, "u_grainSeed"),
-      blur: gl.getUniformLocation(program, "u_blur"),
-      pixelate: gl.getUniformLocation(program, "u_pixelate"),
+      effectTime: gl.getUniformLocation(program, "u_effectTime"),
+      paletteSize: gl.getUniformLocation(program, "u_paletteSize"),
+      palette0: gl.getUniformLocation(program, "u_palette0"),
+      palette1: gl.getUniformLocation(program, "u_palette1"),
+      palette2: gl.getUniformLocation(program, "u_palette2"),
+      palette3: gl.getUniformLocation(program, "u_palette3"),
+      palette4: gl.getUniformLocation(program, "u_palette4"),
+      palette5: gl.getUniformLocation(program, "u_palette5"),
       intensity: gl.getUniformLocation(program, "u_intensity"),
       compareEnabled: gl.getUniformLocation(program, "u_compareEnabled"),
       comparePosition: gl.getUniformLocation(program, "u_comparePosition"),
@@ -783,20 +1636,7 @@ function uploadEntryLut(
   const packed = packCubeLutToRgba8(lut);
   const { gl, program } = entry;
   try {
-    gl.activeTexture(gl.TEXTURE2);
-    gl.bindTexture(gl.TEXTURE_2D, program.lutTexture);
-    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
-    gl.texImage2D(
-      gl.TEXTURE_2D,
-      0,
-      gl.RGBA,
-      packed.width,
-      packed.height,
-      0,
-      gl.RGBA,
-      gl.UNSIGNED_BYTE,
-      packed.data,
-    );
+    uploadLutTexture(gl, program.lutTexture, packed);
     entry.lut = {
       src,
       size: lut.size,
@@ -817,26 +1657,89 @@ function uploadEntryLut(
   }
 }
 
+async function loadCubeLut(src: string): Promise<CubeLut3D> {
+  const cached = getCubeLut(src);
+  if (cached.state === "ready") return cached.lut;
+  if (cached.state === "pending") return cached.promise;
+  throw new Error(cached.message);
+}
+
+function uploadLutTexture(
+  gl: WebGLRenderingContext,
+  texture: WebGLTexture,
+  packed: ReturnType<typeof packCubeLutToRgba8>,
+): void {
+  gl.activeTexture(gl.TEXTURE2);
+  gl.bindTexture(gl.TEXTURE_2D, texture);
+  gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
+  gl.texImage2D(
+    gl.TEXTURE_2D,
+    0,
+    gl.RGBA,
+    packed.width,
+    packed.height,
+    0,
+    gl.RGBA,
+    gl.UNSIGNED_BYTE,
+    packed.data,
+  );
+}
+
+function uploadPreviewLut(
+  renderer: ColorGradingPreviewRenderer,
+  src: string,
+  lut: CubeLut3D,
+): RuntimeLutTexture {
+  const packed = packCubeLutToRgba8(lut);
+  const { gl, program } = renderer;
+  uploadLutTexture(gl, program.lutTexture, packed);
+  return {
+    src,
+    size: lut.size,
+    domainMin: lut.domainMin,
+    domainMax: lut.domainMax,
+    textureWidth: packed.width,
+    textureHeight: packed.height,
+  };
+}
+
 function destroyRenderTarget(gl: WebGLRenderingContext, target: RenderTarget): void {
   gl.deleteTexture(target.texture);
   gl.deleteFramebuffer(target.framebuffer);
 }
 
-function destroyEffectTargets(entry: ColorGradingEntry): void {
-  const targets = entry.effectTargets;
+function destroyEffectTargets(state: EffectRenderState): void {
+  const targets = state.effectTargets;
   if (!targets) return;
-  entry.gl.deleteProgram(targets.blurProgram.program);
-  destroyRenderTarget(entry.gl, targets.scratch);
-  destroyRenderTarget(entry.gl, targets.blur);
-  entry.effectTargets = null;
+  state.gl.deleteProgram(targets.blurProgram.program);
+  destroyRenderTarget(state.gl, targets.scratch);
+  destroyRenderTarget(state.gl, targets.blur);
+  if (targets.bloom) destroyRenderTarget(state.gl, targets.bloom);
+  state.effectTargets = null;
 }
 
-function destroyProgramResources(entry: ColorGradingEntry): void {
-  destroyEffectTargets(entry);
-  entry.gl.deleteTexture(entry.program.texture);
-  entry.gl.deleteTexture(entry.program.lutTexture);
-  entry.gl.deleteBuffer(entry.program.quad);
-  entry.gl.deleteProgram(entry.program.program);
+function destroyKuwaharaTargets(state: EffectRenderState): void {
+  const targets = state.kuwaharaTargets;
+  if (!targets) return;
+  state.gl.deleteProgram(targets.horizontalProgram.program);
+  state.gl.deleteProgram(targets.resolveProgram.program);
+  destroyRenderTarget(state.gl, targets.moments);
+  destroyRenderTarget(state.gl, targets.output);
+  state.kuwaharaTargets = null;
+}
+
+function destroyProgramResources(renderer: ColorGradingRenderer, loseContext = false): void {
+  destroyEffectTargets(renderer);
+  destroyKuwaharaTargets(renderer);
+  destroyMainProgramResources(renderer.gl, renderer.program);
+  if (loseContext) renderer.gl.getExtension("WEBGL_lose_context")?.loseContext();
+}
+
+function destroyMainProgramResources(gl: WebGLRenderingContext, program: ProgramInfo): void {
+  gl.deleteTexture(program.texture);
+  gl.deleteTexture(program.lutTexture);
+  gl.deleteBuffer(program.quad);
+  gl.deleteProgram(program.program);
 }
 
 function replaceProgramResources(entry: ColorGradingEntry): boolean {
@@ -871,22 +1774,71 @@ function restoreSourceElement(entry: ColorGradingEntry): void {
   entry.sourceHidden = false;
 }
 
-function ensureEffectTargets(entry: ColorGradingEntry): EffectTargets | null {
-  if (entry.effectTargets) return entry.effectTargets;
-  const { gl } = entry;
-  const blurProgram = createBlurProgramInfo(gl, entry.program.quad);
+function ensureEffectTargets(state: EffectRenderState): EffectTargets | null {
+  if (state.effectTargets) return state.effectTargets;
+  const { gl } = state;
+  const blurProgram = createBlurProgramInfo(gl, state.program.quad);
   const scratch = createRenderTarget(gl);
   const blur = createRenderTarget(gl);
   if (!blurProgram || !scratch || !blur) {
     if (blurProgram) gl.deleteProgram(blurProgram.program);
     if (scratch) destroyRenderTarget(gl, scratch);
     if (blur) destroyRenderTarget(gl, blur);
-    entry.effectError = "Framebuffer effects unavailable";
+    state.effectError = "Framebuffer effects unavailable";
     return null;
   }
-  entry.effectError = null;
-  entry.effectTargets = { blurProgram, scratch, blur };
-  return entry.effectTargets;
+  state.effectError = null;
+  state.effectTargets = { blurProgram, scratch, blur, bloom: null };
+  return state.effectTargets;
+}
+
+function ensureBloomOutput(state: EffectRenderState, targets: EffectTargets): RenderTarget | null {
+  if (targets.bloom) return targets.bloom;
+  targets.bloom = createRenderTarget(state.gl);
+  state.effectError = targets.bloom ? null : "Framebuffer effects unavailable";
+  return targets.bloom;
+}
+
+function destroyBloomOutput(state: EffectRenderState): void {
+  const targets = state.effectTargets;
+  if (!targets?.bloom) return;
+  destroyRenderTarget(state.gl, targets.bloom);
+  targets.bloom = null;
+}
+
+function ensureKuwaharaTargets(state: EffectRenderState): KuwaharaTargets | null {
+  if (state.kuwaharaTargets) return state.kuwaharaTargets;
+  const { gl } = state;
+  const halfFloat = gl.getExtension("OES_texture_half_float");
+  const colorBufferHalfFloat = gl.getExtension("EXT_color_buffer_half_float");
+  if (!halfFloat || !colorBufferHalfFloat) {
+    state.effectError = "Kuwahara requires half-float framebuffer support";
+    return null;
+  }
+  const horizontalProgram = createKuwaharaHorizontalProgramInfo(gl, state.program.quad);
+  const resolveProgram = createKuwaharaResolveProgramInfo(gl, state.program.quad);
+  const moments = createRenderTarget(gl, halfFloat.HALF_FLOAT_OES, gl.NEAREST);
+  const output = createRenderTarget(gl);
+  if (!horizontalProgram || !resolveProgram || !moments || !output) {
+    destroyIncompleteKuwaharaTargets(gl, horizontalProgram, resolveProgram, moments, output);
+    state.effectError = "Kuwahara framebuffer effects unavailable";
+    return null;
+  }
+  state.kuwaharaTargets = { horizontalProgram, resolveProgram, moments, output };
+  return state.kuwaharaTargets;
+}
+
+function destroyIncompleteKuwaharaTargets(
+  gl: WebGLRenderingContext,
+  horizontalProgram: KuwaharaHorizontalProgramInfo | null,
+  resolveProgram: KuwaharaResolveProgramInfo | null,
+  moments: RenderTarget | null,
+  output: RenderTarget | null,
+): void {
+  if (horizontalProgram) gl.deleteProgram(horizontalProgram.program);
+  if (resolveProgram) gl.deleteProgram(resolveProgram.program);
+  if (moments) destroyRenderTarget(gl, moments);
+  if (output) destroyRenderTarget(gl, output);
 }
 
 function resizeEffectTargetPair(
@@ -911,6 +1863,8 @@ function renderBlurPass(
   layout: { width: number; height: number },
   direction: { x: number; y: number },
   radius: number,
+  bloomPass = false,
+  threshold = -1,
 ): void {
   gl.bindFramebuffer(gl.FRAMEBUFFER, output.framebuffer);
   gl.viewport(0, 0, layout.width, layout.height);
@@ -921,10 +1875,43 @@ function renderBlurPass(
   gl.uniform2f(program.resolution, layout.width, layout.height);
   gl.uniform2f(program.direction, direction.x, direction.y);
   gl.uniform1f(program.radius, radius);
-  gl.bindBuffer(gl.ARRAY_BUFFER, program.quad);
-  gl.enableVertexAttribArray(program.position);
-  gl.vertexAttribPointer(program.position, 2, gl.FLOAT, false, 0, 0);
-  gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+  gl.uniform1f(program.bloomPass, bloomPass ? 1 : 0);
+  gl.uniform1f(program.threshold, threshold);
+  drawFullscreenQuad(gl, program);
+}
+
+function renderBloomTexture(
+  gl: WebGLRenderingContext,
+  targets: EffectTargets,
+  input: WebGLTexture,
+  output: RenderTarget,
+  width: number,
+  height: number,
+  radius: number,
+): void {
+  const layout = resizeEffectTargetPair(gl, targets.scratch, output, width / 2, height / 2);
+  const passRadius = radius / 2;
+  renderBlurPass(
+    gl,
+    targets.blurProgram,
+    input,
+    targets.scratch,
+    layout,
+    { x: 1, y: 0 },
+    passRadius,
+    true,
+    0.5,
+  );
+  renderBlurPass(
+    gl,
+    targets.blurProgram,
+    targets.scratch.texture,
+    output,
+    layout,
+    { x: 0, y: 1 },
+    passRadius,
+    true,
+  );
 }
 
 function renderGaussianTexture(
@@ -960,6 +1947,225 @@ function renderGaussianTexture(
   }
 }
 
+function drawFullscreenQuad(
+  gl: WebGLRenderingContext,
+  program: { quad: WebGLBuffer; position: number },
+): void {
+  gl.bindBuffer(gl.ARRAY_BUFFER, program.quad);
+  gl.enableVertexAttribArray(program.position);
+  gl.vertexAttribPointer(program.position, 2, gl.FLOAT, false, 0, 0);
+  gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+}
+
+function renderKuwaharaTexture(
+  gl: WebGLRenderingContext,
+  targets: KuwaharaTargets,
+  source: WebGLTexture,
+  blurSource: WebGLTexture,
+  layout: { width: number; height: number },
+  uv: { scaleX: number; scaleY: number; offsetX: number; offsetY: number },
+  blurReady: boolean,
+  effects: NormalizedHfColorGrading["effects"],
+): void {
+  resizeRenderTarget(gl, targets.moments, layout.width, layout.height);
+  resizeRenderTarget(gl, targets.output, layout.width, layout.height);
+
+  const horizontal = targets.horizontalProgram;
+  gl.bindFramebuffer(gl.FRAMEBUFFER, targets.moments.framebuffer);
+  gl.viewport(0, 0, layout.width, layout.height);
+  gl.useProgram(horizontal.program);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, source);
+  gl.activeTexture(gl.TEXTURE1);
+  gl.bindTexture(gl.TEXTURE_2D, blurSource);
+  gl.uniform1i(horizontal.source, 0);
+  gl.uniform1i(horizontal.blurSource, 1);
+  gl.uniform2f(horizontal.texel, 1 / layout.width, 1 / layout.height);
+  gl.uniform2f(horizontal.uvScale, uv.scaleX, uv.scaleY);
+  gl.uniform2f(horizontal.uvOffset, uv.offsetX, uv.offsetY);
+  gl.uniform1f(horizontal.blurReady, blurReady ? 1 : 0);
+  gl.uniform1f(horizontal.blur, effects.blur);
+  gl.uniform1f(horizontal.radius, effects.kuwaharaRadius);
+  drawFullscreenQuad(gl, horizontal);
+
+  const resolve = targets.resolveProgram;
+  gl.bindFramebuffer(gl.FRAMEBUFFER, targets.output.framebuffer);
+  gl.useProgram(resolve.program);
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, targets.moments.texture);
+  gl.uniform1i(resolve.moments, 0);
+  gl.uniform2f(resolve.texel, 1 / layout.width, 1 / layout.height);
+  gl.uniform1f(resolve.radius, effects.kuwaharaRadius);
+  gl.uniform1f(resolve.sharpness, effects.kuwaharaSharpness);
+  gl.uniform1f(resolve.saturation, effects.kuwaharaSaturation);
+  drawFullscreenQuad(gl, resolve);
+}
+
+interface PreparedEffectTextures {
+  blurReady: boolean;
+  bloomReady: boolean;
+  kuwaharaReady: boolean;
+  blurTexture: WebGLTexture;
+  bloomTexture: WebGLTexture;
+  kuwaharaTexture: WebGLTexture;
+}
+
+function prepareBlurTexture(
+  state: EffectRenderState,
+  targets: EffectTargets,
+  amount: number,
+  layout: { width: number; height: number },
+): boolean {
+  if (amount <= 0) return false;
+  const blurLayout = resizeEffectTargetPair(
+    state.gl,
+    targets.scratch,
+    targets.blur,
+    layout.width,
+    layout.height,
+  );
+  renderGaussianTexture(
+    state.gl,
+    targets,
+    state.program.texture,
+    targets.blur,
+    blurLayout,
+    0.75 + Math.pow(amount, 1.35) * 32,
+    amount > 0.55 ? 3 : 2,
+  );
+  return true;
+}
+
+function prepareBloomTexture(
+  state: EffectRenderState,
+  targets: EffectTargets,
+  amount: number,
+  radius: number,
+  layout: { width: number; height: number },
+  blurReady: boolean,
+): WebGLTexture | null {
+  if (amount <= 0) {
+    destroyBloomOutput(state);
+    return null;
+  }
+  if (!blurReady) destroyBloomOutput(state);
+  const output = blurReady ? ensureBloomOutput(state, targets) : targets.blur;
+  if (!output) return null;
+  renderBloomTexture(
+    state.gl,
+    targets,
+    state.program.texture,
+    output,
+    layout.width,
+    layout.height,
+    radius,
+  );
+  return output.texture;
+}
+
+function prepareBlurAndBloomTextures(
+  state: EffectRenderState,
+  grading: NormalizedHfColorGrading,
+  layout: { width: number; height: number },
+  releaseIdleTargets: boolean,
+): Pick<PreparedEffectTextures, "blurReady" | "bloomReady" | "blurTexture" | "bloomTexture"> {
+  const { program } = state;
+  const blurAmount = grading.effects.blur;
+  const bloomAmount = grading.effects.bloom;
+  if (blurAmount <= 0 && bloomAmount <= 0) {
+    if (state.effectTargets && releaseIdleTargets) destroyEffectTargets(state);
+    return {
+      blurReady: false,
+      bloomReady: false,
+      blurTexture: program.texture,
+      bloomTexture: program.texture,
+    };
+  }
+
+  const targets = ensureEffectTargets(state);
+  if (!targets) {
+    return {
+      blurReady: false,
+      bloomReady: false,
+      blurTexture: program.texture,
+      bloomTexture: program.texture,
+    };
+  }
+
+  const blurReady = prepareBlurTexture(state, targets, blurAmount, layout);
+  const bloomTexture = prepareBloomTexture(
+    state,
+    targets,
+    bloomAmount,
+    grading.effects.bloomRadius,
+    layout,
+    blurReady,
+  );
+  return {
+    blurReady,
+    bloomReady: bloomTexture !== null,
+    blurTexture: targets.blur.texture,
+    bloomTexture: bloomTexture ?? program.texture,
+  };
+}
+
+function prepareKuwaharaTexture(
+  state: EffectRenderState,
+  grading: NormalizedHfColorGrading,
+  layout: { width: number; height: number },
+  uv: { scaleX: number; scaleY: number; offsetX: number; offsetY: number },
+  blurReady: boolean,
+  preserve: boolean,
+  releaseIdleTargets: boolean,
+): Pick<PreparedEffectTextures, "kuwaharaReady" | "kuwaharaTexture"> {
+  const amount = grading.effects.kuwahara;
+  if (amount <= 0 && !preserve) {
+    if (state.kuwaharaTargets && releaseIdleTargets) destroyKuwaharaTargets(state);
+    return { kuwaharaReady: false, kuwaharaTexture: state.program.texture };
+  }
+
+  const targets = ensureKuwaharaTargets(state);
+  if (!targets || amount <= 0) {
+    return {
+      kuwaharaReady: false,
+      kuwaharaTexture: targets?.output.texture ?? state.program.texture,
+    };
+  }
+  renderKuwaharaTexture(
+    state.gl,
+    targets,
+    state.program.texture,
+    state.effectTargets?.blur.texture ?? state.program.texture,
+    layout,
+    uv,
+    blurReady,
+    grading.effects,
+  );
+  return { kuwaharaReady: true, kuwaharaTexture: targets.output.texture };
+}
+
+function prepareEffectTextures(
+  state: EffectRenderState,
+  grading: NormalizedHfColorGrading,
+  layout: { width: number; height: number },
+  uv: { scaleX: number; scaleY: number; offsetX: number; offsetY: number },
+  options: { preserveKuwahara?: boolean; releaseIdleTargets?: boolean } = {},
+): PreparedEffectTextures {
+  const releaseIdleTargets = options.releaseIdleTargets ?? true;
+  state.effectError = null;
+  const blurAndBloom = prepareBlurAndBloomTextures(state, grading, layout, releaseIdleTargets);
+  const kuwahara = prepareKuwaharaTexture(
+    state,
+    grading,
+    layout,
+    uv,
+    blurAndBloom.blurReady,
+    options.preserveKuwahara ?? false,
+    releaseIdleTargets,
+  );
+  return { ...blurAndBloom, ...kuwahara };
+}
+
 // fallow-ignore-next-line complexity
 function ensureEntryLut(entry: ColorGradingEntry): RuntimeLutTexture | null {
   const src = entry.grading.lut?.src.trim() ?? "";
@@ -1080,6 +2286,14 @@ function findRenderFrameImage(video: HTMLVideoElement): HTMLImageElement | null
   return frame instanceof HTMLImageElement && isDrawableSource(frame) ? frame : null;
 }
 
+function hasInjectedRenderFrame(element: ColorGradingMediaElement): boolean {
+  if (!(element instanceof HTMLVideoElement)) return false;
+  const frame = findRenderFrameImage(element);
+  if (!frame) return false;
+  const style = window.getComputedStyle(frame);
+  return style.display !== "none" && style.visibility !== "hidden";
+}
+
 function isRenderFrameImage(source: TexImageSource): source is HTMLImageElement {
   return source instanceof HTMLImageElement && source.classList.contains("__render_frame__");
 }
@@ -1193,6 +2407,10 @@ function ensureParentPosition(entry: ColorGradingEntry, parent: HTMLElement): vo
   parent.style.position = "relative";
 }
 
+function resolvedLayoutSize(primary: number, fallback: number): number {
+  return Math.max(0, Math.round(primary > 0 ? primary : fallback));
+}
+
 function updateCanvasLayout(
   entry: ColorGradingEntry,
   styleSource: HTMLElement,
@@ -1217,17 +2435,33 @@ function updateCanvasLayout(
   canvas.style.visibility = entry.sourceVisibleForCanvas ? "visible" : "hidden";
 
   const rect = element.getBoundingClientRect();
-  const width = Math.max(0, Math.round(element.offsetWidth || rect.width));
-  const height = Math.max(0, Math.round(element.offsetHeight || rect.height));
-  if (width <= 0 || height <= 0) {
+  const cssWidth = resolvedLayoutSize(element.offsetWidth, rect.width);
+  const cssHeight = resolvedLayoutSize(element.offsetHeight, rect.height);
+  if (cssWidth <= 0 || cssHeight <= 0) {
     canvas.style.display = "none";
     return null;
   }
+  const pixelRatio = Math.max(1, window.devicePixelRatio || 1);
+  const width = Math.round(cssWidth * pixelRatio);
+  const height = Math.round(cssHeight * pixelRatio);
   if (canvas.width !== width) canvas.width = width;
   if (canvas.height !== height) canvas.height = height;
   return { width, height };
 }
 
+function setPaletteColorUniform(
+  gl: WebGLRenderingContext,
+  location: WebGLUniformLocation | null,
+  color: string,
+): void {
+  gl.uniform3f(
+    location,
+    Number.parseInt(color.slice(1, 3), 16) / 255,
+    Number.parseInt(color.slice(3, 5), 16) / 255,
+    Number.parseInt(color.slice(5, 7), 16) / 255,
+  );
+}
+
 // fallow-ignore-next-line complexity
 function applyUniforms(
   gl: WebGLRenderingContext,
@@ -1235,18 +2469,25 @@ function applyUniforms(
   grading: NormalizedHfColorGrading,
   lut: RuntimeLutTexture | null,
   blurReady: boolean,
+  bloomReady: boolean,
+  kuwaharaReady: boolean,
   compare: RuntimeColorGradingCompareState,
   layout: { width: number; height: number },
   uv: { scaleX: number; scaleY: number; offsetX: number; offsetY: number },
   grainSeed: number,
+  effectTime: number,
 ): void {
   gl.uniform1i(program.source, 0);
   gl.uniform1i(program.blurSource, 1);
   gl.uniform1i(program.lut, 2);
+  gl.uniform1i(program.kuwaharaSource, 3);
+  gl.uniform1i(program.bloomSource, 4);
   gl.uniform2f(program.resolution, layout.width, layout.height);
   gl.uniform2f(program.uvScale, uv.scaleX, uv.scaleY);
   gl.uniform2f(program.uvOffset, uv.offsetX, uv.offsetY);
   gl.uniform1f(program.blurReady, blurReady ? 1 : 0);
+  gl.uniform1f(program.bloomReady, bloomReady ? 1 : 0);
+  gl.uniform1f(program.kuwaharaReady, kuwaharaReady ? 1 : 0);
   gl.uniform1f(program.lutEnabled, lut ? 1 : 0);
   gl.uniform1f(program.lutSize, lut?.size ?? 2);
   gl.uniform2f(program.lutTextureSize, lut?.textureWidth ?? 1, lut?.textureHeight ?? 1);
@@ -1263,26 +2504,30 @@ function applyUniforms(
     lut?.domainMax[2] ?? 1,
   );
   gl.uniform1f(program.lutIntensity, grading.lut?.intensity ?? 0);
-  gl.uniform1f(program.exposure, grading.adjust.exposure);
-  gl.uniform1f(program.contrast, grading.adjust.contrast);
-  gl.uniform1f(program.highlights, grading.adjust.highlights);
-  gl.uniform1f(program.shadows, grading.adjust.shadows);
-  gl.uniform1f(program.whites, grading.adjust.whites);
-  gl.uniform1f(program.blacks, grading.adjust.blacks);
-  gl.uniform1f(program.temperature, grading.adjust.temperature);
-  gl.uniform1f(program.tint, grading.adjust.tint);
-  gl.uniform1f(program.vibrance, grading.adjust.vibrance);
-  gl.uniform1f(program.saturation, grading.adjust.saturation);
-  gl.uniform1f(program.vignette, grading.details.vignette);
-  gl.uniform1f(program.vignetteMidpoint, grading.details.vignetteMidpoint);
-  gl.uniform1f(program.vignetteRoundness, grading.details.vignetteRoundness);
-  gl.uniform1f(program.vignetteFeather, grading.details.vignetteFeather);
-  gl.uniform1f(program.grain, grading.details.grain);
-  gl.uniform1f(program.grainSize, grading.details.grainSize);
-  gl.uniform1f(program.grainRoughness, grading.details.grainRoughness);
+  for (const [key, location] of program.adjustUniforms) {
+    gl.uniform1f(location, grading.adjust[key]);
+  }
+  for (const [key, location] of program.detailUniforms) {
+    gl.uniform1f(location, grading.details[key]);
+  }
   gl.uniform1f(program.grainSeed, grainSeed);
-  gl.uniform1f(program.blur, grading.effects.blur);
-  gl.uniform1f(program.pixelate, grading.effects.pixelate);
+  gl.uniform1f(program.effectTime, effectTime);
+  for (const [key, location] of program.effectUniforms) {
+    gl.uniform1f(location, grading.effects[key]);
+  }
+  const palette =
+    grading.palette ??
+    (grading.effects.engraving > 0 || grading.effects.crosshatch > 0
+      ? DEFAULT_ART_PALETTE
+      : DEFAULT_EFFECT_PALETTE);
+  const lastColor = palette[palette.length - 1] ?? DEFAULT_EFFECT_PALETTE[1];
+  gl.uniform1f(program.paletteSize, palette.length);
+  setPaletteColorUniform(gl, program.palette0, palette[0] ?? DEFAULT_EFFECT_PALETTE[0]);
+  setPaletteColorUniform(gl, program.palette1, palette[1] ?? lastColor);
+  setPaletteColorUniform(gl, program.palette2, palette[2] ?? lastColor);
+  setPaletteColorUniform(gl, program.palette3, palette[3] ?? lastColor);
+  setPaletteColorUniform(gl, program.palette4, palette[4] ?? lastColor);
+  setPaletteColorUniform(gl, program.palette5, palette[5] ?? lastColor);
   gl.uniform1f(program.intensity, grading.intensity);
   gl.uniform1f(program.compareEnabled, compare.enabled ? 1 : 0);
   gl.uniform1f(program.comparePosition, compare.position);
@@ -1312,6 +2557,122 @@ function hideSourceElement(entry: ColorGradingEntry): void {
   entry.sourceHidden = true;
 }
 
+type AnimatedProperty = {
+  name: string;
+  min: number;
+  max: number;
+};
+
+function animatedProperty(path: HfColorGradingAnimatablePath): AnimatedProperty {
+  const property = HF_COLOR_GRADING_ANIMATABLE_PROPERTIES.find(
+    (candidate) => candidate.path === path,
+  );
+  if (!property) throw new Error(`Missing color-grading animation property: ${path}`);
+  return property;
+}
+
+const ANIMATED_INTENSITY_PROPERTY = animatedProperty("intensity");
+const ANIMATED_LUT_INTENSITY_PROPERTY = animatedProperty("lut.intensity");
+const ANIMATED_EXPOSURE_PROPERTY = animatedProperty("adjust.exposure");
+const ANIMATED_KUWAHARA_PROPERTY = animatedProperty("effects.kuwahara");
+const ANIMATED_EFFECT_PROPERTIES = [
+  ["blur", animatedProperty("effects.blur")],
+  ["bloom", animatedProperty("effects.bloom")],
+  ["kuwahara", ANIMATED_KUWAHARA_PROPERTY],
+  ["pixelate", animatedProperty("effects.pixelate")],
+  ["ascii", animatedProperty("effects.ascii")],
+  ["dither", animatedProperty("effects.dither")],
+] as const satisfies readonly (readonly [HfColorGradingEffectKey, AnimatedProperty])[];
+const ANIMATED_GRADING_PROPERTIES = [
+  ANIMATED_INTENSITY_PROPERTY,
+  ANIMATED_LUT_INTENSITY_PROPERTY,
+  ANIMATED_EXPOSURE_PROPERTY,
+  ...ANIMATED_EFFECT_PROPERTIES.map(([, property]) => property),
+];
+
+function readAnimatedValue(element: HTMLElement, property: AnimatedProperty): number | null {
+  const raw = element.style.getPropertyValue(property.name);
+  if (!raw) return null;
+  const value = Number(raw);
+  return Number.isFinite(value) ? Math.min(property.max, Math.max(property.min, value)) : null;
+}
+
+function isRuntimeColorGradingActive(
+  element: ColorGradingMediaElement,
+  grading: NormalizedHfColorGrading | null,
+): grading is NormalizedHfColorGrading {
+  return (
+    grading !== null &&
+    (isHfColorGradingActive(grading) ||
+      ANIMATED_GRADING_PROPERTIES.some((property) => readAnimatedValue(element, property) !== null))
+  );
+}
+
+function readAnimatedEffects(
+  element: HTMLElement,
+  grading: NormalizedHfColorGrading,
+): NormalizedHfColorGrading["effects"] | null {
+  let effects: NormalizedHfColorGrading["effects"] | null = null;
+  for (const [key, property] of ANIMATED_EFFECT_PROPERTIES) {
+    const value = readAnimatedValue(element, property);
+    if (value === null) continue;
+    effects ??= { ...grading.effects };
+    effects[key] = value;
+  }
+  return effects;
+}
+
+function readAnimatedGrading(entry: ColorGradingEntry): NormalizedHfColorGrading {
+  const { element, grading } = entry;
+  const intensity = readAnimatedValue(element, ANIMATED_INTENSITY_PROPERTY);
+  const lutIntensity = readAnimatedValue(element, ANIMATED_LUT_INTENSITY_PROPERTY);
+  const exposure = readAnimatedValue(element, ANIMATED_EXPOSURE_PROPERTY);
+  const effects = readAnimatedEffects(element, grading);
+  const hasDirectOverride = [intensity, lutIntensity, exposure].some((value) => value !== null);
+  if (!hasDirectOverride && effects === null) {
+    return grading;
+  }
+  const animated = {
+    ...grading,
+    adjust: exposure === null ? grading.adjust : { ...grading.adjust, exposure },
+    effects: effects ?? grading.effects,
+  };
+  if (intensity !== null) animated.intensity = intensity;
+  if (grading.lut && lutIntensity !== null) {
+    animated.lut = { ...grading.lut, intensity: lutIntensity };
+  }
+  return animated;
+}
+
+function uploadSourceTexture(
+  gl: WebGLRenderingContext,
+  texture: WebGLTexture,
+  source: TexImageSource,
+): void {
+  gl.activeTexture(gl.TEXTURE0);
+  gl.bindTexture(gl.TEXTURE_2D, texture);
+  gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
+  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+}
+
+function bindProgramTextures(
+  gl: WebGLRenderingContext,
+  program: ProgramInfo,
+  prepared: PreparedEffectTextures,
+): void {
+  const textures = [
+    program.texture,
+    prepared.blurTexture,
+    program.lutTexture,
+    prepared.kuwaharaTexture,
+    prepared.bloomTexture,
+  ];
+  for (const [unit, texture] of textures.entries()) {
+    gl.activeTexture(gl.TEXTURE0 + unit);
+    gl.bindTexture(gl.TEXTURE_2D, texture);
+  }
+}
+
 // fallow-ignore-next-line complexity
 function drawEntry(entry: ColorGradingEntry): boolean {
   if (entry.destroyed || entry.contextLost) return false;
@@ -1350,60 +2711,44 @@ function drawEntry(entry: ColorGradingEntry): boolean {
   );
   const { gl, program } = entry;
   try {
+    const grading = readAnimatedGrading(entry);
     const lut = ensureEntryLut(entry);
-    gl.activeTexture(gl.TEXTURE0);
-    gl.bindTexture(gl.TEXTURE_2D, program.texture);
     // Browser media elements are top-left oriented; WebGL texture coordinates
     // are bottom-left oriented unless the upload is flipped.
-    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
-    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
-
-    let blurReady = false;
-    const blurAmount = Math.min(1, Math.max(0, entry.grading.effects.blur));
-    if (blurAmount > 0) {
-      // If framebuffer setup fails, keep the non-blur shader path alive and surface status.
-      const targets = ensureEffectTargets(entry);
-      if (targets) {
-        const blurLayout = resizeEffectTargetPair(
-          gl,
-          targets.scratch,
-          targets.blur,
-          layout.width,
-          layout.height,
-        );
-        renderGaussianTexture(
-          gl,
-          targets,
-          program.texture,
-          targets.blur,
-          blurLayout,
-          0.75 + Math.pow(blurAmount, 1.35) * 32,
-          blurAmount > 0.55 ? 3 : 2,
-        );
-        blurReady = true;
-      }
-    } else {
-      entry.effectError = null;
-      if (entry.effectTargets) destroyEffectTargets(entry);
-    }
+    uploadSourceTexture(gl, program.texture, source);
+    const hasAnimatedKuwahara =
+      readAnimatedValue(entry.element, ANIMATED_KUWAHARA_PROPERTY) !== null;
+    const prepared = prepareEffectTextures(entry, grading, layout, uv, {
+      preserveKuwahara: hasAnimatedKuwahara,
+    });
 
     gl.bindFramebuffer(gl.FRAMEBUFFER, null);
     gl.viewport(0, 0, layout.width, layout.height);
     gl.useProgram(program.program);
-    gl.activeTexture(gl.TEXTURE0);
-    gl.bindTexture(gl.TEXTURE_2D, program.texture);
-    gl.activeTexture(gl.TEXTURE1);
-    gl.bindTexture(gl.TEXTURE_2D, entry.effectTargets?.blur.texture ?? program.texture);
-    gl.activeTexture(gl.TEXTURE2);
-    gl.bindTexture(gl.TEXTURE_2D, program.lutTexture);
-    const grainSeed =
-      entry.grainSeed +
-      (entry.element instanceof HTMLVideoElement ? Math.floor(entry.element.currentTime * 60) : 0);
-    applyUniforms(gl, program, entry.grading, lut, blurReady, entry.compare, layout, uv, grainSeed);
-    gl.bindBuffer(gl.ARRAY_BUFFER, program.quad);
-    gl.enableVertexAttribArray(program.position);
-    gl.vertexAttribPointer(program.position, 2, gl.FLOAT, false, 0, 0);
-    gl.drawArrays(gl.TRIANGLE_STRIP, 0, 4);
+    bindProgramTextures(gl, program, prepared);
+    const runtimeTime = (window as WindowWithColorGrading).__player?.getTime?.();
+    const frameTime =
+      typeof runtimeTime === "number" && Number.isFinite(runtimeTime)
+        ? Math.max(0, runtimeTime)
+        : entry.element instanceof HTMLVideoElement
+          ? Math.max(0, entry.element.currentTime)
+          : 0;
+    const grainSeed = entry.grainSeed + Math.floor(frameTime * 60);
+    applyUniforms(
+      gl,
+      program,
+      grading,
+      lut,
+      prepared.blurReady,
+      prepared.bloomReady,
+      prepared.kuwaharaReady,
+      entry.compare,
+      layout,
+      uv,
+      grainSeed,
+      frameTime,
+    );
+    drawFullscreenQuad(gl, program);
     hideSourceElement(entry);
     entry.hasDrawn = true;
     entry.drawError = null;
@@ -1415,6 +2760,173 @@ function drawEntry(entry: ColorGradingEntry): boolean {
   }
 }
 
+function previewDimensions(
+  element: ColorGradingMediaElement,
+  sourceSize: { width: number; height: number },
+  rawMaxDimension: number | undefined,
+): { width: number; height: number } {
+  const rect = element.getBoundingClientRect();
+  const boxWidth = element.offsetWidth || rect.width || sourceSize.width;
+  const boxHeight = element.offsetHeight || rect.height || sourceSize.height;
+  const maxDimension = Math.min(320, Math.max(64, Math.round(rawMaxDimension ?? 160)));
+  const aspect =
+    boxWidth > 0 && boxHeight > 0 ? boxWidth / boxHeight : sourceSize.width / sourceSize.height;
+  return aspect >= 1
+    ? { width: maxDimension, height: Math.max(1, Math.round(maxDimension / aspect)) }
+    : { width: Math.max(1, Math.round(maxDimension * aspect)), height: maxDimension };
+}
+
+function createPreviewRenderer(): ColorGradingPreviewRenderer | null {
+  const canvas = document.createElement("canvas");
+  const created = createProgramInfo(canvas);
+  return created
+    ? {
+        canvas,
+        ...created,
+        lut: null,
+        effectTargets: null,
+        kuwaharaTargets: null,
+        effectError: null,
+      }
+    : null;
+}
+
+interface PreviewFrame {
+  dimensions: { width: number; height: number };
+  uv: { scaleX: number; scaleY: number; offsetX: number; offsetY: number };
+  grainSeed: number;
+  effectTime: number;
+}
+
+function previewEffectTime(element: ColorGradingMediaElement, useMediaTime: boolean): number {
+  const runtimeTime = useMediaTime
+    ? undefined
+    : (window as WindowWithColorGrading).__player?.getTime?.();
+  if (typeof runtimeTime === "number" && Number.isFinite(runtimeTime)) {
+    return Math.max(0, runtimeTime);
+  }
+  return element instanceof HTMLVideoElement ? Math.max(0, element.currentTime) : 0;
+}
+
+function preparePreviewFrame(
+  renderer: ColorGradingPreviewRenderer,
+  element: ColorGradingMediaElement,
+  maxDimension: number | undefined,
+  useMediaTime: boolean,
+): PreviewFrame | null {
+  const source = getDrawableSource(element);
+  if (!source) return null;
+  const sourceSize = readSourceSize(source);
+  if (!sourceSize) return null;
+  const dimensions = previewDimensions(element, sourceSize, maxDimension);
+  renderer.canvas.width = dimensions.width;
+  renderer.canvas.height = dimensions.height;
+  const styleSource = source instanceof HTMLElement ? source : element;
+  const style = window.getComputedStyle(styleSource);
+  const uv = calculateObjectFitUv(
+    dimensions.width,
+    dimensions.height,
+    sourceSize.width,
+    sourceSize.height,
+    style.objectFit,
+    style.objectPosition,
+  );
+  uploadSourceTexture(renderer.gl, renderer.program.texture, source);
+  return {
+    dimensions,
+    uv,
+    effectTime: previewEffectTime(element, useMediaTime),
+    grainSeed:
+      seedForElement(element) +
+      (element instanceof HTMLVideoElement ? Math.floor(element.currentTime * 60) : 0),
+  };
+}
+
+async function renderPreviewBatch(
+  renderer: ColorGradingPreviewRenderer,
+  element: ColorGradingMediaElement,
+  candidates: readonly RuntimeColorGradingPreviewCandidate[],
+  maxDimension: number | undefined,
+  useMediaTime = false,
+): Promise<RuntimeColorGradingPreviewBatch | null> {
+  const frame = preparePreviewFrame(renderer, element, maxDimension, useMediaTime);
+  if (!frame) return null;
+  const { dimensions, uv, grainSeed, effectTime } = frame;
+  const images: RuntimeColorGradingPreviewBatch["images"] = [];
+
+  for (const candidate of candidates.slice(0, 32)) {
+    const grading = normalizeHfColorGrading(candidate.grading);
+    if (!grading) {
+      images.push({ id: candidate.id, dataUrl: null, error: "Invalid grading" });
+      continue;
+    }
+    let lut: RuntimeLutTexture | null = null;
+    try {
+      if (grading.lut) {
+        if (renderer.lut?.src !== grading.lut.src) {
+          renderer.lut = uploadPreviewLut(
+            renderer,
+            grading.lut.src,
+            await loadCubeLut(grading.lut.src),
+          );
+        }
+        lut = renderer.lut;
+      }
+      images.push({
+        id: candidate.id,
+        dataUrl: renderPreviewCandidate(
+          renderer,
+          grading,
+          lut,
+          dimensions,
+          uv,
+          grainSeed,
+          effectTime,
+        ),
+      });
+    } catch (err) {
+      images.push({ id: candidate.id, dataUrl: null, error: errorMessage(err) });
+    }
+  }
+  return { ...dimensions, images };
+}
+
+function renderPreviewCandidate(
+  renderer: ColorGradingPreviewRenderer,
+  grading: NormalizedHfColorGrading,
+  lut: RuntimeLutTexture | null,
+  dimensions: { width: number; height: number },
+  uv: { scaleX: number; scaleY: number; offsetX: number; offsetY: number },
+  grainSeed: number,
+  effectTime: number,
+): string {
+  const { canvas, gl, program } = renderer;
+  const prepared = prepareEffectTextures(renderer, grading, dimensions, uv, {
+    releaseIdleTargets: false,
+  });
+  gl.bindFramebuffer(gl.FRAMEBUFFER, null);
+  gl.viewport(0, 0, dimensions.width, dimensions.height);
+  gl.useProgram(program.program);
+  bindProgramTextures(gl, program, prepared);
+  if (!lut) renderer.lut = null;
+  applyUniforms(
+    gl,
+    program,
+    grading,
+    lut,
+    prepared.blurReady,
+    prepared.bloomReady,
+    prepared.kuwaharaReady,
+    DEFAULT_COMPARE,
+    dimensions,
+    uv,
+    grainSeed,
+    effectTime,
+  );
+  drawFullscreenQuad(gl, program);
+  return canvas.toDataURL("image/png");
+}
+
 function addListener(
   entry: ColorGradingEntry,
   target: EventTarget,
@@ -1521,15 +3033,16 @@ function installEntryListeners(entry: ColorGradingEntry): void {
   }
 }
 
-function destroyEntry(entry: ColorGradingEntry): void {
-  if (entry.destroyed) return;
+function detachEntry(entry: ColorGradingEntry): ColorGradingRenderer | null {
+  if (entry.destroyed) return null;
   entry.destroyed = true;
   cancelScheduledFrame(entry);
   entry.resizeObserver?.disconnect();
   for (const cleanup of entry.cleanup) cleanup();
   entry.cleanup.length = 0;
   entry.canvas.remove();
-  destroyProgramResources(entry);
+  destroyEffectTargets(entry);
+  destroyKuwaharaTargets(entry);
   restoreSourceElement(entry);
   if (entry.touchedParent) {
     if (entry.parentInlinePosition === null) {
@@ -1538,11 +3051,23 @@ function destroyEntry(entry: ColorGradingEntry): void {
       entry.touchedParent.style.position = entry.parentInlinePosition;
     }
   }
+  return {
+    canvas: entry.canvas,
+    gl: entry.gl,
+    program: entry.program,
+    effectTargets: null,
+    kuwaharaTargets: null,
+    effectError: null,
+  };
 }
 
-function makeCanvas(element: ColorGradingMediaElement): HTMLCanvasElement {
-  const canvas = document.createElement("canvas");
+function attachCanvas(
+  canvas: HTMLCanvasElement,
+  element: ColorGradingMediaElement,
+): HTMLCanvasElement {
+  canvas.removeAttribute("style");
   if (element.id) canvas.id = `${HF_COLOR_GRADING_CANVAS_ID_PREFIX}${element.id}`;
+  else canvas.removeAttribute("id");
   canvas.className = COLOR_GRADING_CANVAS_CLASS;
   canvas.setAttribute(COLOR_GRADING_CANVAS_ATTR, "true");
   canvas.setAttribute("data-hyperframes-ignore", "");
@@ -1555,10 +3080,16 @@ function makeCanvas(element: ColorGradingMediaElement): HTMLCanvasElement {
   return canvas;
 }
 
+function makeCanvas(element: ColorGradingMediaElement): HTMLCanvasElement {
+  return attachCanvas(document.createElement("canvas"), element);
+}
+
 export function createColorGradingRuntime(): RuntimeColorGradingApi {
   const entries = new WeakMap<ColorGradingMediaElement, ColorGradingEntry>();
   const trackedElements = new Set<ColorGradingMediaElement>();
+  const idleRenderers: ColorGradingRenderer[] = [];
   let observer: MutationObserver | null = null;
+  let previewRenderer: ColorGradingPreviewRenderer | null = null;
   let destroyed = false;
 
   const upsert = (
@@ -1574,17 +3105,28 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
       if (element instanceof HTMLVideoElement && !element.paused) scheduleVideoDraw(existing);
       return true;
     }
-    const canvas = makeCanvas(element);
-    const created = createProgramInfo(canvas);
-    if (!created) {
-      canvas.remove();
-      return false;
+    let renderer = idleRenderers.pop();
+    if (renderer) {
+      attachCanvas(renderer.canvas, element);
+    } else {
+      const canvas = makeCanvas(element);
+      const created = createProgramInfo(canvas);
+      if (!created) {
+        canvas.remove();
+        return false;
+      }
+      renderer = {
+        canvas,
+        gl: created.gl,
+        program: created.program,
+        effectTargets: null,
+        kuwaharaTargets: null,
+        effectError: null,
+      };
     }
     const entry: ColorGradingEntry = {
       element,
-      canvas,
-      gl: created.gl,
-      program: created.program,
+      ...renderer,
       grading,
       compare: { ...DEFAULT_COMPARE },
       lut: null,
@@ -1592,6 +3134,7 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
       lutError: null,
       drawError: null,
       effectTargets: null,
+      kuwaharaTargets: null,
       effectError: null,
       source,
       animationFrame: null,
@@ -1628,7 +3171,12 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
     let entry = entries.get(element);
     if (!entry) {
       const grading = readColorGradingAttribute(element);
-      if (!isHfColorGradingActive(grading) || !upsert(element, grading, "attribute")) return false;
+      if (
+        !isRuntimeColorGradingActive(element, grading) ||
+        !upsert(element, grading, "attribute")
+      ) {
+        return false;
+      }
       entry = entries.get(element);
     }
     if (!entry) return false;
@@ -1640,7 +3188,14 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
   const removeElement = (element: ColorGradingMediaElement): void => {
     const entry = entries.get(element);
     if (!entry) return;
-    destroyEntry(entry);
+    const renderer = detachEntry(entry);
+    if (renderer) {
+      if (entry.contextLost || idleRenderers.length >= MAX_IDLE_COLOR_GRADING_RENDERERS) {
+        destroyProgramResources(renderer, true);
+      } else {
+        idleRenderers.push(renderer);
+      }
+    }
     entries.delete(element);
     trackedElements.delete(element);
   };
@@ -1655,13 +3210,17 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
       if (!isColorGradingMediaElement(node)) return;
       attributeElements.add(node);
       const grading = readColorGradingAttribute(node);
-      if (isHfColorGradingActive(grading)) {
-        upsert(node, grading, "attribute");
+      if (isRuntimeColorGradingActive(node, grading)) {
+        if (isVisibleForColorGrading(node) || hasInjectedRenderFrame(node)) {
+          upsert(node, grading, "attribute");
+        } else {
+          removeElement(node);
+        }
       } else {
         removeElement(node);
       }
     });
-    for (const element of Array.from(trackedElements)) {
+    for (const element of trackedElements) {
       const entry = entries.get(element);
       if (!entry) continue;
       if (
@@ -1677,8 +3236,41 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
   const redraw = (): number => {
     if (destroyed) return 0;
     let drawn = 0;
-    for (const entry of Array.from(trackedElements, (element) => entries.get(element))) {
-      if (entry && drawEntry(entry)) drawn += 1;
+    for (const element of trackedElements) {
+      const entry = entries.get(element);
+      if (!entry) continue;
+      if (drawEntry(entry)) drawn += 1;
+    }
+    return drawn;
+  };
+
+  const waitForActiveLuts = async (): Promise<number> => {
+    const pending = new Set<Promise<CubeLut3D>>();
+    for (const element of trackedElements) {
+      const lut = entries.get(element)?.grading.lut;
+      if (!lut?.src.trim() || (lut.intensity ?? 1) <= 0) continue;
+      const cached = getCubeLut(lut.src);
+      if (cached.state === "pending") pending.add(cached.promise);
+    }
+    if (pending.size > 0) await Promise.allSettled(pending);
+    // Capture awaits this method after every seek; this paint is required even
+    // when no LUT is pending so the screenshot receives the current frame.
+    redraw();
+    return pending.size;
+  };
+
+  const redrawAnimated = (): number => {
+    if (destroyed) return 0;
+    let drawn = 0;
+    for (const element of trackedElements) {
+      const entry = entries.get(element);
+      if (!entry) continue;
+      const hasAnimatedProperty = ANIMATED_GRADING_PROPERTIES.some(
+        (property) => readAnimatedValue(element, property) !== null,
+      );
+      if (!hasAnimatedProperty) continue;
+      if (element instanceof HTMLVideoElement && !element.paused && !element.ended) continue;
+      if (drawEntry(entry)) drawn += 1;
     }
     return drawn;
   };
@@ -1691,7 +3283,7 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
     const element = resolveTarget(target);
     if (!element) return false;
     const grading = normalizeHfColorGrading(rawGrading);
-    if (!isHfColorGradingActive(grading)) {
+    if (!isRuntimeColorGradingActive(element, grading)) {
       removeElement(element);
       return true;
     }
@@ -1701,8 +3293,15 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
   const setSourceVisibility = (target: Element, visible: boolean): boolean => {
     if (!isColorGradingMediaElement(target)) return false;
     const entry = entries.get(target);
-    if (!entry) return false;
+    if (!entry) {
+      if (!visible) return false;
+      const grading = readColorGradingAttribute(target);
+      return isRuntimeColorGradingActive(target, grading) && upsert(target, grading, "attribute");
+    }
     entry.sourceVisibleForCanvas = visible;
+    if (!visible && entry.source === "attribute") {
+      removeElement(target);
+    }
     return true;
   };
 
@@ -1735,18 +3334,69 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
       };
     }
     const grading = readColorGradingAttribute(element);
-    if (isHfColorGradingActive(grading)) {
+    if (isRuntimeColorGradingActive(element, grading)) {
+      if (!isVisibleForColorGrading(element) && !hasInjectedRenderFrame(element)) {
+        return { state: "pending", message: "Waiting for visible media" };
+      }
       return { state: "unavailable", message: "WebGL unavailable" };
     }
     return { state: "inactive", message: "No grading applied" };
   };
 
+  const renderPreviews = async (
+    target: HfColorGradingTarget | string | null | undefined,
+    candidates: readonly RuntimeColorGradingPreviewCandidate[],
+    options?: { maxDimension?: number; useMediaTime?: boolean },
+  ): Promise<RuntimeColorGradingPreviewBatch | null> => {
+    if (destroyed || candidates.length === 0) return null;
+    const element = resolveTarget(target);
+    if (!element) return null;
+    previewRenderer ??= createPreviewRenderer();
+    if (!previewRenderer) return null;
+    return renderPreviewBatch(
+      previewRenderer,
+      element,
+      candidates,
+      options?.maxDimension,
+      options?.useMediaTime,
+    );
+  };
+
+  const startPreviewPlayback = (
+    target: HfColorGradingTarget | string | null | undefined,
+  ): (() => void) | null => {
+    const element = resolveTarget(target);
+    if (!(element instanceof HTMLVideoElement)) return null;
+    if (!element.paused) return () => undefined;
+    const time = element.currentTime;
+    const loop = element.loop;
+    const muted = element.muted;
+    element.loop = true;
+    element.muted = true;
+    if (element.ended || (Number.isFinite(element.duration) && time >= element.duration)) {
+      element.currentTime = 0;
+    }
+    void element.play().catch(() => undefined);
+    return () => {
+      element.pause();
+      element.loop = loop;
+      element.muted = muted;
+      element.currentTime = time;
+    };
+  };
+
   const destroy = (): void => {
     if (destroyed) return;
     destroyed = true;
     observer?.disconnect();
     observer = null;
-    for (const element of Array.from(trackedElements)) removeElement(element);
+    for (const element of trackedElements) removeElement(element);
+    for (const renderer of idleRenderers) destroyProgramResources(renderer, true);
+    idleRenderers.length = 0;
+    if (previewRenderer) {
+      destroyProgramResources(previewRenderer, true);
+      previewRenderer = null;
+    }
   };
 
   if (document.body) {
@@ -1762,10 +3412,14 @@ export function createColorGradingRuntime(): RuntimeColorGradingApi {
   const api: RuntimeColorGradingApi = {
     refresh,
     redraw,
+    redrawAnimated,
+    waitForActiveLuts,
     setGrading,
     setCompare,
     setSourceVisibility,
     getStatus,
+    renderPreviews,
+    startPreviewPlayback,
     destroy,
   };
   const win = window as WindowWithColorGrading;
diff --git a/packages/core/src/runtime/init.test.ts b/packages/core/src/runtime/init.test.ts
index 8cbde87b53..3087aac7a9 100644
--- a/packages/core/src/runtime/init.test.ts
+++ b/packages/core/src/runtime/init.test.ts
@@ -1320,6 +1320,53 @@ describe("initSandboxRuntimeModular", () => {
     expect(video.style.visibility).toBe("hidden");
   });
 
+  it("allocates color grading only for the active timed media", () => {
+    const getContextSpy = vi.spyOn(HTMLCanvasElement.prototype, "getContext").mockReturnValue(null);
+    const root = document.createElement("div");
+    root.setAttribute("data-composition-id", "main");
+    root.setAttribute("data-root", "true");
+    root.setAttribute("data-start", "0");
+    root.setAttribute("data-duration", "4");
+    root.setAttribute("data-width", "1920");
+    root.setAttribute("data-height", "1080");
+    document.body.appendChild(root);
+
+    const futureComposition = document.createElement("div");
+    futureComposition.id = "future-composition";
+    futureComposition.setAttribute("data-start", "2");
+    root.appendChild(futureComposition);
+
+    for (const [id, start] of [
+      ["first", "0"],
+      ["second", "2"],
+    ]) {
+      const video = document.createElement("video");
+      video.id = id;
+      video.setAttribute("data-start", start);
+      video.setAttribute("data-duration", "2");
+      video.setAttribute("data-color-grading", '{"adjust":{"exposure":0.1}}');
+      Object.defineProperty(video, "paused", { value: true, configurable: true });
+      Object.defineProperty(video, "readyState", { value: 0, configurable: true });
+      video.load = () => {};
+      root.appendChild(video);
+    }
+
+    window.__timelines = { main: createMockTimeline(4) };
+    initSandboxRuntimeModular();
+
+    expect(getContextSpy).toHaveBeenCalledTimes(1);
+    expect(document.getElementById("first")?.style.visibility).toBe("visible");
+    expect(document.getElementById("second")?.style.visibility).toBe("hidden");
+    expect(futureComposition.style.visibility).toBe("");
+    expect(futureComposition.style.display).toBe("");
+
+    window.__player?.seek(3);
+
+    expect(getContextSpy).toHaveBeenCalledTimes(2);
+    expect(document.getElementById("first")?.style.visibility).toBe("hidden");
+    expect(document.getElementById("second")?.style.visibility).toBe("visible");
+  });
+
   it("plays scheduled child timelines without a captured root timeline when audio has failed", () => {
     const raf = createManualRaf();
     vi.spyOn(performance, "now").mockImplementation(() => raf.now());
@@ -2122,6 +2169,36 @@ describe("initSandboxRuntimeModular", () => {
     expect(seekTimes.length).toBeGreaterThan(beforeResume);
   });
 
+  it("redraws animated grading from the transport clock only during playback", () => {
+    const raf = createManualRaf();
+    vi.spyOn(performance, "now").mockImplementation(() => raf.now());
+    window.requestAnimationFrame = raf.requestAnimationFrame as typeof window.requestAnimationFrame;
+    window.cancelAnimationFrame = raf.cancelAnimationFrame as typeof window.cancelAnimationFrame;
+
+    document.body.innerHTML = `
+      <div data-composition-id="root" data-duration="5" data-width="1920" data-height="1080"></div>
+    `;
+    window.__timelines = { root: createMockTimeline(5) };
+    initSandboxRuntimeModular();
+
+    const runtime = (
+      window as Window & { __hf?: { colorGrading?: { redrawAnimated: () => number } } }
+    ).__hf?.colorGrading;
+    if (!runtime) throw new Error("Expected color grading runtime");
+    const redrawAnimated = vi.spyOn(runtime, "redrawAnimated");
+
+    raf.step(16);
+    expect(redrawAnimated).not.toHaveBeenCalled();
+
+    window.__player?.play();
+    raf.step(16);
+    expect(redrawAnimated).toHaveBeenCalledTimes(1);
+
+    window.__player?.pause();
+    raf.step(16);
+    expect(redrawAnimated).toHaveBeenCalledTimes(1);
+  });
+
   it("keeps a usable bound timeline when the registry entry is replaced", () => {
     const raf = createManualRaf();
     vi.spyOn(performance, "now").mockImplementation(() => raf.now());
diff --git a/packages/core/src/runtime/init.ts b/packages/core/src/runtime/init.ts
index 06e8a31d6c..4ba8108996 100644
--- a/packages/core/src/runtime/init.ts
+++ b/packages/core/src/runtime/init.ts
@@ -1793,8 +1793,10 @@ export function initSandboxRuntimeModular(): void {
   const dataHiddenDisplayRestores = new WeakMap<HTMLElement, string>();
   const dataHiddenDisplayNodes = new WeakSet<HTMLElement>();
 
-  const syncTimedElementVisibility = (currentTime: number) => {
-    const visibilityNodes = Array.from(document.querySelectorAll("[data-start]"));
+  const syncTimedElementVisibility = (
+    currentTime: number,
+    visibilityNodes: Element[] = Array.from(document.querySelectorAll("[data-start]")),
+  ) => {
     const rootComp = resolveRootCompositionElement();
     for (const rawNode of visibilityNodes) {
       if (!(rawNode instanceof HTMLElement)) continue;
@@ -2174,6 +2176,10 @@ export function initSandboxRuntimeModular(): void {
   });
   picker.installPickerApi();
 
+  syncTimedElementVisibility(
+    state.currentTime,
+    Array.from(document.querySelectorAll("video[data-start], img[data-start]")),
+  );
   const colorGrading = createColorGradingRuntime();
   colorGradingRuntime = colorGrading;
   registerRuntimeCleanup(() => {
@@ -2839,6 +2845,9 @@ export function initSandboxRuntimeModular(): void {
       if (clock.isPlaying() || !hasActiveStudioManualEditGesture()) {
         seekTimelineAndAdapters(t);
       }
+      if (clock.isPlaying()) {
+        colorGrading.redrawAnimated();
+      }
 
       // Looping is handled at the player layer (<hyperframes-player>),
       // not the runtime. The clock pauses at duration; GSAP's repeat:-1
diff --git a/packages/engine/src/services/frameCapture.ts b/packages/engine/src/services/frameCapture.ts
index 0c7346dc7a..12b0d4f8da 100644
--- a/packages/engine/src/services/frameCapture.ts
+++ b/packages/engine/src/services/frameCapture.ts
@@ -2356,6 +2356,14 @@ async function prepareFrameForCapture(
   if (session.onBeforeCapture) {
     await session.onBeforeCapture(page, quantizedTime);
   }
+  await page.evaluate(async () => {
+    const runtime = (
+      window as Window & {
+        __hf?: { colorGrading?: { waitForActiveLuts?: () => Promise<number> } };
+      }
+    ).__hf?.colorGrading;
+    await runtime?.waitForActiveLuts?.();
+  });
   const beforeCaptureMs = Date.now() - beforeCaptureStart;
 
   // Page-side compositing three-phase protocol:
diff --git a/packages/engine/src/services/screenshotService.test.ts b/packages/engine/src/services/screenshotService.test.ts
index 28a2a1196f..ff459eed06 100644
--- a/packages/engine/src/services/screenshotService.test.ts
+++ b/packages/engine/src/services/screenshotService.test.ts
@@ -181,9 +181,12 @@ describe("injectVideoFramesBatch replacement layout", () => {
       '<html><body><div id="root"><video id="clip" style="position:absolute;inset:0;width:100%;height:100%;object-fit:cover"></video></div></body></html>',
     );
 
+    const events: string[] = [];
     Object.defineProperty(window.HTMLImageElement.prototype, "decode", {
       configurable: true,
-      value: () => Promise.resolve(),
+      value: async () => {
+        events.push("decode");
+      },
     });
 
     const video = document.getElementById("clip") as HTMLVideoElement;
@@ -232,6 +235,10 @@ describe("injectVideoFramesBatch replacement layout", () => {
     const previousDocument = globals.document;
     globals.window = window;
     globals.document = document;
+    const redraw = vi.fn(() => events.push("redraw"));
+    (window as unknown as { __hf: { colorGrading: { redraw: () => void } } }).__hf = {
+      colorGrading: { redraw },
+    };
     try {
       const page = {
         evaluate: async (
@@ -266,6 +273,8 @@ describe("injectVideoFramesBatch replacement layout", () => {
     expect(img?.style.right).toBe("auto");
     expect(img?.style.bottom).toBe("auto");
     expect(img?.style.inset).toBe("auto");
+    expect(redraw).toHaveBeenCalledOnce();
+    expect(events).toEqual(["decode", "redraw"]);
   });
 });
 
@@ -569,6 +578,10 @@ describe("video-frame injection respects ancestor visibility", () => {
     seededImg.classList.add("__render_frame__");
     seededImg.style.opacity = "0";
     setup.video.parentNode?.insertBefore(seededImg, setup.video.nextSibling);
+    const setSourceVisibility = vi.fn();
+    (setup.window as unknown as { __hf: unknown }).__hf = {
+      colorGrading: { setSourceVisibility },
+    };
 
     try {
       await syncVideoFrameVisibility(passthroughPage(), ["pip"]);
@@ -578,6 +591,7 @@ describe("video-frame injection respects ancestor visibility", () => {
 
     expect(seededImg.style.opacity).toBe("1");
     expect(seededImg.style.visibility).toBe("visible");
+    expect(setSourceVisibility).toHaveBeenCalledWith(setup.video, true);
   });
 
   it("syncVideoFrameVisibility shows the replacement <img> when a plain [data-start] host is visibility:hidden", async () => {
@@ -643,6 +657,10 @@ describe("video-frame injection respects ancestor visibility", () => {
     seededImg.style.visibility = "visible";
     setup.video.parentNode?.insertBefore(seededImg, setup.video.nextSibling);
     const setPropertySpy = vi.spyOn(seededImg.style, "setProperty");
+    const setSourceVisibility = vi.fn();
+    (setup.window as unknown as { __hf: unknown }).__hf = {
+      colorGrading: { setSourceVisibility },
+    };
 
     try {
       await syncVideoFrameVisibility(passthroughPage(), ["pip"]);
@@ -652,6 +670,7 @@ describe("video-frame injection respects ancestor visibility", () => {
 
     expect(seededImg.style.visibility).toBe("hidden");
     expect(setPropertySpy).toHaveBeenCalledWith("visibility", "hidden", "important");
+    expect(setSourceVisibility).toHaveBeenCalledWith(setup.video, false);
   });
 
   it("applyDomLayerMask does not revive hidden idless timed descendants of a shown layer", async () => {
diff --git a/packages/engine/src/services/screenshotService.ts b/packages/engine/src/services/screenshotService.ts
index fa5c521233..ae3abeaba6 100644
--- a/packages/engine/src/services/screenshotService.ts
+++ b/packages/engine/src/services/screenshotService.ts
@@ -8,13 +8,13 @@
 // fallow-ignore-file code-duplication
 import { type Page } from "puppeteer-core";
 import { type CaptureOptions } from "../types.js";
+import { COLOR_GRADING_SOURCE_HIDDEN_ATTR } from "@hyperframes/core/color-grading";
 import {
   HF_COLOR_GRADING_CANVAS_ID_PREFIX,
   MEDIA_VISUAL_STYLE_PROPERTIES,
 } from "@hyperframes/core";
 
 export const cdpSessionCache = new WeakMap<Page, import("puppeteer-core").CDPSession>();
-const COLOR_GRADING_SOURCE_HIDDEN_ATTR = "data-hf-color-grading-source-hidden";
 
 export async function getCdpSession(page: Page): Promise<import("puppeteer-core").CDPSession> {
   let client = cdpSessionCache.get(page);
@@ -789,6 +789,11 @@ export async function injectVideoFramesBatch(
       if (pendingDecodes.length > 0) {
         await Promise.all(pendingDecodes);
       }
+      if (injectedIds.length > 0) {
+        const redraw = (window as Window & { __hf?: { colorGrading?: { redraw?: () => void } } })
+          .__hf?.colorGrading?.redraw;
+        redraw?.();
+      }
       return injectedIds;
     },
     updates,
@@ -825,6 +830,13 @@ export async function syncVideoFrameVisibility(
         return false;
       };
       const active = new Set(ids);
+      const setColorGradingVisibility = (
+        window as Window & {
+          __hf?: {
+            colorGrading?: { setSourceVisibility?: (target: Element, visible: boolean) => boolean };
+          };
+        }
+      ).__hf?.colorGrading?.setSourceVisibility;
       const videos = Array.from(
         document.querySelectorAll("video[data-start]"),
       ) as HTMLVideoElement[];
@@ -832,7 +844,8 @@ export async function syncVideoFrameVisibility(
         const img = video.nextElementSibling as HTMLElement | null;
         const hasImg = img && img.classList.contains("__render_frame__");
         const ancestorHidden = isVisualAncestorHidden(video);
-        if (active.has(video.id) && !ancestorHidden) {
+        const visible = active.has(video.id) && !ancestorHidden;
+        if (visible) {
           // Active video: show injected <img>, hide native <video>.
           // Do NOT clobber inline opacity here — GSAP-controlled opacity must
           // survive until injectVideoFramesBatch reads it via getComputedStyle.
@@ -859,6 +872,7 @@ export async function syncVideoFrameVisibility(
             img.style.setProperty("visibility", "hidden", "important");
           }
         }
+        setColorGradingVisibility?.(video, visible);
       }
     },
     activeVideoIds,
diff --git a/packages/engine/src/services/videoFrameInjector.ts b/packages/engine/src/services/videoFrameInjector.ts
index b9ed6d07fd..ca443e5c65 100644
--- a/packages/engine/src/services/videoFrameInjector.ts
+++ b/packages/engine/src/services/videoFrameInjector.ts
@@ -148,25 +148,6 @@ function createFrameSourceCache(
 
 export const __testing = { createFrameSourceCache };
 
-async function redrawRuntimeColorGrading(page: Page): Promise<void> {
-  await page.evaluate(() => {
-    const hf = (
-      window as Window & {
-        __hf?: {
-          colorGrading?: { redraw?: () => unknown };
-        };
-      }
-    ).__hf;
-    const redraw = hf?.colorGrading?.redraw;
-    if (typeof redraw !== "function") return;
-    try {
-      redraw();
-    } catch {
-      // Optional page-side shader layer.
-    }
-  });
-}
-
 /**
  * Creates a BeforeCaptureHook that injects pre-extracted video frames
  * into the page, replacing native <video> elements with frame images.
@@ -248,7 +229,6 @@ export function createVideoFrameInjector(
         }, time);
       }
     }
-    await redrawRuntimeColorGrading(page);
   };
 }
 
diff --git a/packages/lint/src/rules/media.test.ts b/packages/lint/src/rules/media.test.ts
index 3be4187a2d..49ad5768d9 100644
--- a/packages/lint/src/rules/media.test.ts
+++ b/packages/lint/src/rules/media.test.ts
@@ -81,6 +81,114 @@ describe("media rules", () => {
     expect(finding).toBeUndefined();
   });
 
+  it("reports grading controls placed outside their schema sections", async () => {
+    const html = `
+<html><body>
+  <div id="root" data-composition-id="c1" data-width="1920" data-height="1080">
+    <video id="v1" data-start="0" data-duration="5" src="clip.mp4" muted data-color-grading='{"preset":"skin-soft","intensity":0.58,"highlights":-0.06,"temperature":0.02}'></video>
+  </div>
+  <script>window.__timelines = {};</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    const finding = result.findings.find((f) => f.code === "color_grading_invalid_structure");
+    expect(finding?.severity).toBe("error");
+    expect(finding?.message).toContain("highlights");
+    expect(finding?.fixHint).toContain('"adjust"');
+  });
+
+  it("accepts grading controls inside their schema sections", async () => {
+    const html = `
+<html><body>
+  <div id="root" data-composition-id="c1" data-width="1920" data-height="1080">
+    <video id="v1" data-start="0" data-duration="5" src="clip.mp4" muted data-color-grading='{"preset":"skin-soft","intensity":0.58,"adjust":{"highlights":-0.06,"temperature":0.02},"details":{"vignette":0.03},"effects":{"blur":0.1,"chromaBleed":0.2,"tapeDamage":0.3,"tapeTracking":0.4,"tapeNoise":0.5,"tapeSpeed":0.6,"filmArtifacts":0.4,"halftone":0.5,"halftoneSize":0.6,"twoInkPrint":0.7,"twoInkPrintSize":0.8,"ascii":0.9,"asciiSize":0.4,"asciiInvert":1,"dither":0.8,"ditherSize":0.3,"bloom":0.5,"bloomRadius":8,"asciiStyle":4,"asciiColor":1,"asciiRotation":1,"monoScreen":0.5,"monoScreenSize":0.4,"monoScreenAngle":0.3,"monoScreenSpread":0.2,"monoScreenShape":3,"monoScreenInvert":1,"scanlines":0.3,"scanlineCount":0.4,"scanlineSoftness":0.5,"chromaticAberration":0.2,"chromaticAngle":0.6,"crtCurvature":0.25,"digitalGlitch":0.4,"digitalGlitchColorSplit":0.45,"digitalGlitchLineTear":0.5,"digitalGlitchPixelate":0.55,"digitalGlitchBlockAmount":0.6,"digitalGlitchBlockDisplacement":0.7,"digitalGlitchBlockOpacity":0.2,"digitalGlitchSpeed":0.7,"engraving":1,"engravingSpacing":0.4117647,"engravingMinThickness":0.2,"engravingMaxThickness":0.4571429,"engravingAngle":0.25,"engravingContrast":0.4666667,"engravingSharpness":0.59,"engravingWave":0.2,"engravingWaveFrequency":0.2222222},"palette":["#ff6b66","#080717","#d9339f","#3c185f"],"lut":null}'></video>
+  </div>
+  <script>window.__timelines = {};</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code.startsWith("color_grading_"))).toBeUndefined();
+  });
+
+  it("accepts crosshatch controls in the effects section", async () => {
+    const html = `
+<html><body>
+  <div id="root" data-composition-id="c1" data-width="1920" data-height="1080">
+    <video data-start="0" data-duration="5" src="clip.mp4" muted data-color-grading='{"effects":{"crosshatch":1,"crosshatchSpacing":0.28,"crosshatchThickness":0.25,"crosshatchAngle":0.25,"crosshatchContrast":0.3333333,"crosshatchEdges":0.5,"crosshatchLineWeight":0,"crosshatchWave":0.33,"crosshatchWaveFrequency":0.2222222}}'></video>
+  </div>
+  <script>window.__timelines = {};</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code.startsWith("color_grading_"))).toBeUndefined();
+  });
+
+  it("accepts Kuwahara controls in the effects section", async () => {
+    const html = `
+<html><body>
+  <div id="root" data-composition-id="c1" data-width="1920" data-height="1080">
+    <video data-start="0" data-duration="5" src="clip.mp4" muted data-color-grading='{"effects":{"kuwahara":1,"kuwaharaRadius":0.142857,"kuwaharaSharpness":0.3125,"kuwaharaSaturation":0.5}}'></video>
+  </div>
+  <script>window.__timelines = {};</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code.startsWith("color_grading_"))).toBeUndefined();
+  });
+
+  it("reports malformed or out-of-range color grading palettes", async () => {
+    const html = `
+<html><body>
+  <div id="root" data-composition-id="c1" data-width="1920" data-height="1080">
+    <video id="v1" data-start="0" data-duration="5" src="clip.mp4" muted data-color-grading='{"effects":{"dither":1},"palette":["#000000","red"]}'></video>
+  </div>
+  <script>window.__timelines = {};</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    const finding = result.findings.find((f) => f.code === "color_grading_invalid_structure");
+    expect(finding?.severity).toBe("error");
+    expect(finding?.fixHint).toContain("2 to 6");
+    expect(finding?.fixHint).toContain("#RRGGBB");
+  });
+
+  it("reports malformed grading JSON", async () => {
+    const html = `
+<html><body>
+  <div id="root" data-composition-id="c1" data-width="1920" data-height="1080">
+    <video id="v1" data-start="0" data-duration="5" src="clip.mp4" muted data-color-grading='{"preset":"skin-soft"'></video>
+  </div>
+  <script>window.__timelines = {};</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "color_grading_invalid_json")?.severity).toBe(
+      "error",
+    );
+  });
+
+  it("reports invalid string values for structured grading sections", async () => {
+    const html = `
+<html><body>
+  <div id="root" data-composition-id="c1" data-width="1920" data-height="1080">
+    <video id="v1" data-start="0" data-duration="5" src="clip.mp4" muted data-color-grading='{"adjust":"cinematic"}'></video>
+  </div>
+  <script>window.__timelines = {};</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(
+      result.findings.find((f) => f.code === "color_grading_invalid_structure")?.severity,
+    ).toBe("error");
+  });
+
+  it("reports color grading on non-media elements", async () => {
+    const html = `
+<html><body>
+  <div id="root" data-composition-id="c1" data-width="1920" data-height="1080">
+    <div id="background" data-color-grading='{"preset":"skin-soft"}'></div>
+  </div>
+  <script>window.__timelines = {};</script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    expect(result.findings.find((f) => f.code === "color_grading_non_media")?.severity).toBe(
+      "error",
+    );
+  });
+
   it("reports warning for media with preload=none", async () => {
     const html = `
 <html><body>
diff --git a/packages/lint/src/rules/media.ts b/packages/lint/src/rules/media.ts
index 8e14fc4df4..3084d4ce77 100644
--- a/packages/lint/src/rules/media.ts
+++ b/packages/lint/src/rules/media.ts
@@ -1,5 +1,6 @@
 import type { LintContext, HyperframeLintFinding } from "../context";
 import { readAttr, readDecodedAttr, truncateSnippet, isMediaTag } from "../utils";
+import { validateColorGradingContract } from "@hyperframes/parsers/color-grading-contract";
 
 function escapeRegExp(value: string): string {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -247,6 +248,59 @@ export const mediaRules: Array<(ctx: LintContext) => HyperframeLintFinding[]> =
     return findings;
   },
 
+  // color_grading_* — grading is a structured media-only contract. Unknown
+  // keys are ignored by the runtime, so catch them before an agent can report
+  // controls that never actually rendered.
+  ({ tags }) => {
+    const findings: HyperframeLintFinding[] = [];
+    for (const tag of tags) {
+      const raw = readDecodedAttr(tag.raw, "data-color-grading");
+      if (raw === null) continue;
+      const elementId = readAttr(tag.raw, "id") || undefined;
+      const report = (code: string, message: string, fixHint: string) => {
+        findings.push({
+          code,
+          severity: "error",
+          message,
+          elementId,
+          fixHint,
+          snippet: truncateSnippet(tag.raw),
+        });
+      };
+      if (tag.name !== "video" && tag.name !== "img") {
+        report(
+          "color_grading_non_media",
+          `data-color-grading on <${tag.name}> has no effect. The shader runtime only grades real <video> and <img> elements.`,
+          "Move the grading attribute to the real <video> or <img> media element. Do not attach it to a wrapper or CSS background.",
+        );
+        continue;
+      }
+
+      const trimmed = raw.trim();
+      if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) continue;
+      let parsed: unknown;
+      try {
+        parsed = JSON.parse(trimmed);
+      } catch {
+        report(
+          "color_grading_invalid_json",
+          "data-color-grading contains malformed JSON and will not render.",
+          'Use valid JSON, for example {"preset":"skin-soft","intensity":0.6,"adjust":{"highlights":-0.08}}.',
+        );
+        continue;
+      }
+      for (const issue of validateColorGradingContract(parsed)) {
+        report(
+          "color_grading_invalid_structure",
+          `data-color-grading ${issue.path} ${issue.message}.`,
+          issue.hint ??
+            "Use the documented media-treatment contract and correct or remove the invalid value.",
+        );
+      }
+    }
+    return findings;
+  },
+
   // video_missing_muted
   ({ tags }) => {
     const findings: HyperframeLintFinding[] = [];
diff --git a/packages/parsers/src/colorGradingContract.ts b/packages/parsers/src/colorGradingContract.ts
index 95d99f85ef..cb2fc0b95a 100644
--- a/packages/parsers/src/colorGradingContract.ts
+++ b/packages/parsers/src/colorGradingContract.ts
@@ -139,6 +139,20 @@ export function isColorGradingVariableRef(value: unknown): value is string {
   return typeof value === "string" && VARIABLE_REF.test(value.trim());
 }
 
+function unknownKeysHint(path: string, unknown: readonly string[]): string {
+  if (path !== "grading") return `Correct or remove the unsupported "${path}" keys.`;
+  const sections = new Set(
+    unknown.flatMap((key) =>
+      OBJECT_SECTIONS.filter(([, keys]) => (keys as readonly string[]).includes(key)).map(
+        ([section]) => section,
+      ),
+    ),
+  );
+  return sections.size === 1
+    ? `Move those controls under "${[...sections][0]}".`
+    : "Use only the documented media-treatment keys at the top level.";
+}
+
 function validateObject(
   value: unknown,
   path: string,
@@ -153,7 +167,11 @@ function validateObject(
   const allowed = new Set(keys);
   const unknown = Object.keys(value).filter((key) => !allowed.has(key));
   if (unknown.length > 0) {
-    issues.push({ path, message: `has unsupported key(s): ${unknown.join(", ")}` });
+    issues.push({
+      path,
+      message: `has unsupported key(s): ${unknown.join(", ")}`,
+      hint: unknownKeysHint(path, unknown),
+    });
   }
   return value;
 }
@@ -192,13 +210,19 @@ function validateNumericSection(
 
 function validatePalette(value: unknown, issues: ColorGradingContractIssue[]): void {
   if (value === undefined || value === null || isColorGradingVariableRef(value)) return;
+  const hint =
+    'Use 2 to 6 colors in the intended mapping order, each written as exact "#RRGGBB", or use a project variable reference.';
   if (!Array.isArray(value) || value.length < 2 || value.length > 6) {
-    issues.push({ path: "palette", message: "must contain 2 to 6 hex colors" });
+    issues.push({ path: "palette", message: "must contain 2 to 6 hex colors", hint });
     return;
   }
   value.forEach((color, index) => {
     if (typeof color !== "string" || !PALETTE_COLOR.test(color)) {
-      issues.push({ path: `palette[${index}]`, message: "must be a six-digit hex color" });
+      issues.push({
+        path: `palette[${index}]`,
+        message: "must be a six-digit hex color",
+        hint,
+      });
     }
   });
 }
diff --git a/packages/parsers/src/gsapParser.test.ts b/packages/parsers/src/gsapParser.test.ts
index 9bdd1bb1ff..2452e8f759 100644
--- a/packages/parsers/src/gsapParser.test.ts
+++ b/packages/parsers/src/gsapParser.test.ts
@@ -170,13 +170,14 @@ describe("parseGsapScript", () => {
   it("extracts all GSAP properties including non-standard ones", () => {
     const script = `
       const tl = gsap.timeline({ paused: true });
-      tl.to("#el1", { opacity: 1, backgroundColor: "red", x: 50, duration: 0.5 }, 0);
+      tl.to("#el1", { opacity: 1, backgroundColor: "red", x: 50, "--hf-color-grading-intensity": 0.5, duration: 0.5 }, 0);
     `;
     const result = parseGsapScript(script);
 
     expect(result.animations[0].properties.opacity).toBe(1);
     expect(result.animations[0].properties.x).toBe(50);
     expect(result.animations[0].properties.backgroundColor).toBe("red");
+    expect(result.animations[0].properties["--hf-color-grading-intensity"]).toBe(0.5);
   });
 
   it("extracts ease from properties", () => {

From adb149b86939e61bb3fce91cb8d0e5530f7bd29c Mon Sep 17 00:00:00 2001
From: James Russo <james.russo@heygen.com>
Date: Fri, 24 Jul 2026 14:56:03 -0400
Subject: [PATCH 048/125] fix(lint): allow bounded GSAP infinite repeats
 (#2763)

---
 packages/lint/src/rules/gsap.test.ts | 20 ++++++++++++++++++++
 packages/lint/src/rules/gsap.ts      | 24 +++++++++++++++---------
 2 files changed, 35 insertions(+), 9 deletions(-)

diff --git a/packages/lint/src/rules/gsap.test.ts b/packages/lint/src/rules/gsap.test.ts
index 5c980ee716..1ef53fa7b8 100644
--- a/packages/lint/src/rules/gsap.test.ts
+++ b/packages/lint/src/rules/gsap.test.ts
@@ -865,6 +865,26 @@ describe("GSAP rules", () => {
     expect(finding?.fixHint).toContain("Math.max(0, Math.floor");
   });
 
+  it("warns on repeat: -1 when an explicit finite composition duration bounds export", async () => {
+    const html = `
+<html><body>
+  <div data-composition-id="main" data-width="1920" data-height="1080" data-duration="8"></div>
+  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
+  <script>
+    window.__timelines = window.__timelines || {};
+    const tl = gsap.timeline({ paused: true });
+    tl.to("#spinner", { rotation: 360, duration: 0.8, repeat: -1, ease: "none" }, 0);
+    window.__timelines["main"] = tl;
+  </script>
+</body></html>`;
+    const result = await lintHyperframeHtml(html);
+    const finding = result.findings.find((f) => f.code === "gsap_infinite_repeat");
+    expect(finding).toBeDefined();
+    expect(finding?.severity).toBe("warning");
+    expect(finding?.message).toContain("finite 8s window");
+    expect(finding?.fixHint).toContain("explicit finite composition");
+  });
+
   it("does not error on finite repeat values", async () => {
     const html = `
 <html><body>
diff --git a/packages/lint/src/rules/gsap.ts b/packages/lint/src/rules/gsap.ts
index 8b2f113ec6..92290d9cf8 100644
--- a/packages/lint/src/rules/gsap.ts
+++ b/packages/lint/src/rules/gsap.ts
@@ -1550,8 +1550,12 @@ export const gsapRules: LintRule<LintContext>[] = [
   },
 
   // gsap_infinite_repeat
-  ({ scripts }) => {
+  ({ scripts, rootTag }) => {
     const findings: HyperframeLintFinding[] = [];
+    const declaredDuration = Number.parseFloat(
+      rootTag ? (readAttr(rootTag.raw, "data-duration") ?? "") : "",
+    );
+    const hasFiniteCompositionWindow = Number.isFinite(declaredDuration) && declaredDuration > 0;
     // Match repeat: -1 in GSAP tweens or timeline configs
     const pattern = /repeat\s*:\s*-1(?!\d)/g;
     for (const { snippet } of scanScriptsForRegexMatches(scripts, pattern, {
@@ -1561,14 +1565,16 @@ export const gsapRules: LintRule<LintContext>[] = [
     })) {
       findings.push({
         code: "gsap_infinite_repeat",
-        severity: "error",
-        message:
-          "GSAP tween uses `repeat: -1` (infinite). Infinite repeats break the deterministic " +
-          "capture engine which seeks to exact frame times. Use a finite repeat count calculated " +
-          "from the composition duration: `repeat: Math.max(0, Math.floor(duration / cycleDuration) - 1)`.",
-        fixHint:
-          "Replace `repeat: -1` with a finite count, e.g. `repeat: Math.max(0, Math.floor(totalDuration / singleCycleDuration) - 1)`. " +
-          "Use Math.floor (not Math.ceil) so the animation fits, and clamp at zero so a short composition cannot evaluate to -1.",
+        severity: hasFiniteCompositionWindow ? "warning" : "error",
+        message: hasFiniteCompositionWindow
+          ? `GSAP tween uses \`repeat: -1\` (infinite), but the composition declares a finite ${declaredDuration}s window. ` +
+            "HyperFrames clips deterministic seeking and export to that explicit duration."
+          : "GSAP tween uses `repeat: -1` (infinite) without a finite composition `data-duration`. " +
+            "The timeline can report an unbounded duration and make render planning fail.",
+        fixHint: hasFiniteCompositionWindow
+          ? "Keep the explicit finite composition `data-duration`. Use a finite repeat count only when the loop itself must end before the composition does."
+          : "Add a finite composition `data-duration`, or replace `repeat: -1` with " +
+            "`repeat: Math.max(0, Math.floor(totalDuration / singleCycleDuration) - 1)`.",
         snippet: truncateSnippet(snippet),
       });
     }

From d07d1874b65bb4f2c81e64c2cb0478ef21f524da Mon Sep 17 00:00:00 2001
From: James <james.russo@heygen.com>
Date: Fri, 24 Jul 2026 19:03:16 +0000
Subject: [PATCH 049/125] chore: release v0.7.71

---
 .claude-plugin/plugin.json               |  2 +-
 .codex-plugin/plugin.json                |  2 +-
 .cursor-plugin/plugin.json               |  2 +-
 docs/changelog.mdx                       | 38 ++++++++++++++++++++++++
 packages/aws-lambda/package.json         |  2 +-
 packages/cli/package.json                |  2 +-
 packages/core/package.json               |  2 +-
 packages/engine/package.json             |  2 +-
 packages/gcp-cloud-run/package.json      |  2 +-
 packages/lint/package.json               |  2 +-
 packages/parsers/package.json            |  2 +-
 packages/player/package.json             |  2 +-
 packages/producer/package.json           |  2 +-
 packages/sdk/package.json                |  2 +-
 packages/shader-transitions/package.json |  2 +-
 packages/studio-server/package.json      |  2 +-
 packages/studio/package.json             |  2 +-
 releases/v0.7.71.md                      | 37 +++++++++++++++++++++++
 18 files changed, 91 insertions(+), 16 deletions(-)
 create mode 100644 releases/v0.7.71.md

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 7925bff9cd..7987178948 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 51f77c67d1..a69af395e7 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index 0d30dfc2be..39c30f3919 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -3,7 +3,7 @@
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com"
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index a221145bc7..65398c29a7 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -8,6 +8,44 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
 
 {/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
 
+<Update
+  label="HyperFrames v0.7.71"
+  description="Released - 2026-07-24"
+  tags={["Release", "Lint", "Preview", "Core"]}
+>
+Finite compositions can now use GSAP `repeat: -1` loops when an explicit root
+`data-duration` bounds the export, while unbounded infinite timelines remain
+blocking. Preview also serves external symlink assets correctly, and this release
+adds media-treatment capabilities plus performance and stability improvements
+for data-driven caption templates.
+
+## Features
+
+- **Core:** Define media treatment capabilities ([70213c5a8](https://github.com/heygen-com/hyperframes/commit/70213c5a8526b12c8b26f01b8288d78bb9edc917))
+
+## Fixes
+
+- **Lint:** Allow bounded GSAP infinite repeats ([adb149b86](https://github.com/heygen-com/hyperframes/commit/adb149b86939e61bb3fce91cb8d0e5530f7bd29c), [#2763](https://github.com/heygen-com/hyperframes/pull/2763))
+- **Preview:** Serve external symlink assets ([7778c093b](https://github.com/heygen-com/hyperframes/commit/7778c093b6288756cf5e27311828e6049e7c85c3), [#2764](https://github.com/heygen-com/hyperframes/pull/2764))
+- **Caption Weight Shift:** Remove O(n^2) redundant hide-all-others loop ([5af6203ae](https://github.com/heygen-com/hyperframes/commit/5af6203ae7fcd506511ca5683a9097d666c4a63e))
+- **Caption Editorial Emphasis / Emoji Pop:** Remove O(n²) redundant hide-all-others loop ([18de2b1f1](https://github.com/heygen-com/hyperframes/commit/18de2b1f1de8062a79ae7aa6fa4796e320fe6131))
+
+## Catalog
+
+- **Registry:** Liberal emoji-pop brand colors, weight-shift fit fixes, 8192 clamp ([8bf939043](https://github.com/heygen-com/hyperframes/commit/8bf939043fb44e05f6dd7caba81822ac5ef18334))
+- **Registry:** Reject non-numeric caption-data versions; boot fetch never clobbers a manual attach ([5c2981d06](https://github.com/heygen-com/hyperframes/commit/5c2981d066480000d623e4d023e9cf918b2772e3))
+- **Registry:** Encapsulate caption template runtimes in IIFEs ([e2846eb7c](https://github.com/heygen-com/hyperframes/commit/e2846eb7cc81821f7fc21a9c4dccdd85c7ef3429))
+- **Registry:** Clear brand CSS custom properties on unbranded re-attach; remove dead italic path ([4f6994719](https://github.com/heygen-com/hyperframes/commit/4f6994719196e72dc01ebe8f60d869e064ec7685))
+- **Registry:** Make caption-editorial-emphasis data-driven with emphasis heuristic ([ed8973952](https://github.com/heygen-com/hyperframes/commit/ed8973952dda2aa43931e0ffa05b3fc6ba0cb1cb))
+- **Registry:** Make caption-highlight data-driven with automatic grouping ([7d4e71d10](https://github.com/heygen-com/hyperframes/commit/7d4e71d10b617b858fde2e764e15d530e9ffdf19))
+- **Registry:** Make caption-emoji-pop data-driven with generic emoji lexicon ([392a9d251](https://github.com/heygen-com/hyperframes/commit/392a9d251a4feadbf7703ba4f9157c1857c7a59b))
+- **Registry:** Force GSAP render at attach — seek(0) is a no-op on a fresh timeline ([020c8986f](https://github.com/heygen-com/hyperframes/commit/020c8986f46f795757203900cd251ad551ccc620))
+- **Registry:** Make caption-pill-karaoke data-driven via caption-data runtime ([08620b75d](https://github.com/heygen-com/hyperframes/commit/08620b75df5275739fd9b0b8f480527fdc1d9a98))
+- **Registry:** Make caption-weight-shift data-driven via caption-data runtime ([c67e9dc1f](https://github.com/heygen-com/hyperframes/commit/c67e9dc1f843122225468ce63a67c57f70c2bba2))
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.7.70...v0.7.71).
+</Update>
+
 <Update
   label="HyperFrames v0.7.70"
   description="Released - 2026-07-24"
diff --git a/packages/aws-lambda/package.json b/packages/aws-lambda/package.json
index 5c520a6c9c..d9773e20b8 100644
--- a/packages/aws-lambda/package.json
+++ b/packages/aws-lambda/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 292d2457a2..d474d1635e 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "license": "Apache-2.0",
   "repository": {
diff --git a/packages/core/package.json b/packages/core/package.json
index 7c71cedb50..353b46d833 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/packages/engine/package.json b/packages/engine/package.json
index 0e00ae6776..55f0ec80ce 100644
--- a/packages/engine/package.json
+++ b/packages/engine/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
diff --git a/packages/gcp-cloud-run/package.json b/packages/gcp-cloud-run/package.json
index 354fda87f5..a0b2d1d688 100644
--- a/packages/gcp-cloud-run/package.json
+++ b/packages/gcp-cloud-run/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/gcp-cloud-run",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index 7aac034fdb..b468df6ede 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index 6e002a46be..47600336dd 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/player/package.json b/packages/player/package.json
index 401ae9e7f0..c10ce9b735 100644
--- a/packages/player/package.json
+++ b/packages/player/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/player",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "Embeddable web component for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/producer/package.json b/packages/producer/package.json
index d7a0c8a2fd..a493e8cddb 100644
--- a/packages/producer/package.json
+++ b/packages/producer/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index c647335037..f1bdac48a9 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
diff --git a/packages/shader-transitions/package.json b/packages/shader-transitions/package.json
index 0cfcb94b01..6e48a8a949 100644
--- a/packages/shader-transitions/package.json
+++ b/packages/shader-transitions/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/shader-transitions",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "WebGL shader transitions for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/studio-server/package.json b/packages/studio-server/package.json
index 2545b6c26f..ad4efac13d 100644
--- a/packages/studio-server/package.json
+++ b/packages/studio-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/studio/package.json b/packages/studio/package.json
index 9f72e71232..23c32e91e4 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.7.70",
+  "version": "0.7.71",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/releases/v0.7.71.md b/releases/v0.7.71.md
new file mode 100644
index 0000000000..d32f3f05b5
--- /dev/null
+++ b/releases/v0.7.71.md
@@ -0,0 +1,37 @@
+# HyperFrames v0.7.71
+
+Released on 2026-07-24.
+
+Finite compositions can now use GSAP `repeat: -1` loops when an explicit root
+`data-duration` bounds the export, while unbounded infinite timelines remain
+blocking. Preview also serves external symlink assets correctly, and this release
+adds media-treatment capabilities plus performance and stability improvements
+for data-driven caption templates.
+
+## Features
+
+- **Core:** Define media treatment capabilities ([70213c5a8](https://github.com/heygen-com/hyperframes/commit/70213c5a8526b12c8b26f01b8288d78bb9edc917))
+
+## Fixes
+
+- **Lint:** Allow bounded GSAP infinite repeats ([adb149b86](https://github.com/heygen-com/hyperframes/commit/adb149b86939e61bb3fce91cb8d0e5530f7bd29c), [#2763](https://github.com/heygen-com/hyperframes/pull/2763))
+- **Preview:** Serve external symlink assets ([7778c093b](https://github.com/heygen-com/hyperframes/commit/7778c093b6288756cf5e27311828e6049e7c85c3), [#2764](https://github.com/heygen-com/hyperframes/pull/2764))
+- **Caption Weight Shift:** Remove O(n^2) redundant hide-all-others loop ([5af6203ae](https://github.com/heygen-com/hyperframes/commit/5af6203ae7fcd506511ca5683a9097d666c4a63e))
+- **Caption Editorial Emphasis / Emoji Pop:** Remove O(n²) redundant hide-all-others loop ([18de2b1f1](https://github.com/heygen-com/hyperframes/commit/18de2b1f1de8062a79ae7aa6fa4796e320fe6131))
+
+## Catalog
+
+- **Registry:** Liberal emoji-pop brand colors, weight-shift fit fixes, 8192 clamp ([8bf939043](https://github.com/heygen-com/hyperframes/commit/8bf939043fb44e05f6dd7caba81822ac5ef18334))
+- **Registry:** Reject non-numeric caption-data versions; boot fetch never clobbers a manual attach ([5c2981d06](https://github.com/heygen-com/hyperframes/commit/5c2981d066480000d623e4d023e9cf918b2772e3))
+- **Registry:** Encapsulate caption template runtimes in IIFEs ([e2846eb7c](https://github.com/heygen-com/hyperframes/commit/e2846eb7cc81821f7fc21a9c4dccdd85c7ef3429))
+- **Registry:** Clear brand CSS custom properties on unbranded re-attach; remove dead italic path ([4f6994719](https://github.com/heygen-com/hyperframes/commit/4f6994719196e72dc01ebe8f60d869e064ec7685))
+- **Registry:** Make caption-editorial-emphasis data-driven with emphasis heuristic ([ed8973952](https://github.com/heygen-com/hyperframes/commit/ed8973952dda2aa43931e0ffa05b3fc6ba0cb1cb))
+- **Registry:** Make caption-highlight data-driven with automatic grouping ([7d4e71d10](https://github.com/heygen-com/hyperframes/commit/7d4e71d10b617b858fde2e764e15d530e9ffdf19))
+- **Registry:** Make caption-emoji-pop data-driven with generic emoji lexicon ([392a9d251](https://github.com/heygen-com/hyperframes/commit/392a9d251a4feadbf7703ba4f9157c1857c7a59b))
+- **Registry:** Force GSAP render at attach — seek(0) is a no-op on a fresh timeline ([020c8986f](https://github.com/heygen-com/hyperframes/commit/020c8986f46f795757203900cd251ad551ccc620))
+- **Registry:** Make caption-pill-karaoke data-driven via caption-data runtime ([08620b75d](https://github.com/heygen-com/hyperframes/commit/08620b75df5275739fd9b0b8f480527fdc1d9a98))
+- **Registry:** Make caption-weight-shift data-driven via caption-data runtime ([c67e9dc1f](https://github.com/heygen-com/hyperframes/commit/c67e9dc1f843122225468ce63a67c57f70c2bba2))
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.7.70...v0.7.71

From e7f9918d21f9fa57f1799c7b3ba38963cfcb52f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Miguel=20=C3=81ngel?= <miguel.sierra@heygen.com>
Date: Fri, 24 Jul 2026 23:12:48 +0200
Subject: [PATCH 050/125] fix(lint): drop false media_in_subcomposition rule
 (#2765)

The media_in_subcomposition rule blanket-errored every <video>/<audio>
inside a sub-composition, claiming nested media is "never seeked/decoded
and renders blank/black". This is false: the runtime discovers media with
a flat document.querySelectorAll("video, audio"), resolves each element's
host composition via closest("[data-composition-id]"), and rebases its
local data-start by the accumulated absolute start of every ancestor
composition (packages/core/src/runtime/{media,startResolver}.ts). Media
seeks and decodes at any nesting depth, verified end to end through the
producer render path.

- Remove the rule and flip its test to assert nested media is NOT flagged.
- Drop the now-dead media_in_subcomposition clause from the registry
  components test.
- Drop the equivalent pre-render guard from the faceless-explainer and
  pr-to-video assemble scripts.
- Correct the reference docs (hyperframes-core SKILL, data-attributes,
  variables-and-media, composition-patterns; hyperframes-cli
  lint-validate-inspect): media works at any depth. Preserve the one real
  constraint, that a sub-comp timeline cannot reach host-root elements, so
  host-root media motion is authored on the main timeline.
---
 .../src/registry/registryComponents.test.ts   |  4 +--
 packages/lint/src/rules/media.test.ts         | 13 ++++----
 packages/lint/src/rules/media.ts              | 23 --------------
 skills-manifest.json                          |  8 ++---
 .../scripts/assemble-index.mjs                | 30 ++++++++-----------
 .../references/lint-validate-inspect.md       |  8 +----
 skills/hyperframes-core/SKILL.md              |  2 +-
 .../references/composition-patterns.md        |  8 ++---
 .../references/data-attributes.md             |  2 +-
 .../references/variables-and-media.md         | 10 ++-----
 skills/pr-to-video/scripts/assemble-index.mjs | 30 ++++++++-----------
 11 files changed, 49 insertions(+), 89 deletions(-)

diff --git a/packages/cli/src/registry/registryComponents.test.ts b/packages/cli/src/registry/registryComponents.test.ts
index 2716e7401c..37537c759b 100644
--- a/packages/cli/src/registry/registryComponents.test.ts
+++ b/packages/cli/src/registry/registryComponents.test.ts
@@ -26,9 +26,7 @@ async function invalidInstallableMedia(entryName: string): Promise<string[]> {
       isSubComposition: true,
     });
     for (const finding of result.findings) {
-      if (finding.code !== "media_in_subcomposition" && finding.code !== "media_missing_src") {
-        continue;
-      }
+      if (finding.code !== "media_missing_src") continue;
       invalidMedia.push(`${entryName}/${file.path}: ${finding.code}`);
     }
   }
diff --git a/packages/lint/src/rules/media.test.ts b/packages/lint/src/rules/media.test.ts
index 49ad5768d9..b9ae81d3a7 100644
--- a/packages/lint/src/rules/media.test.ts
+++ b/packages/lint/src/rules/media.test.ts
@@ -348,7 +348,13 @@ describe("media rules", () => {
     expect(finding).toBeUndefined();
   });
 
-  it("flags <video> inside a sub-composition (media must be a host-root child)", async () => {
+  it("does not flag <video> inside a sub-composition (runtime drives nested media)", async () => {
+    // The runtime's global media sweep (querySelectorAll("video, audio")) drives
+    // media at any nesting depth, and startResolver re-bases each nested clip's
+    // local data-start by its host composition's absolute start. Sub-composition
+    // media is therefore seeked + decoded correctly in preview and render — see
+    // packages/core/src/runtime/{media,startResolver,init}.ts. A prior
+    // `media_in_subcomposition` rule wrongly hard-errored this and was removed.
     const html = `<template id="scene-template">
   <div id="root" data-composition-id="scene" data-width="1920" data-height="1080">
     <video id="v1" src="clip.mp4" data-start="0" data-duration="5" muted playsinline></video>
@@ -357,10 +363,7 @@ describe("media rules", () => {
 </template>`;
     const result = await lintHyperframeHtml(html, { isSubComposition: true });
     const finding = result.findings.find((f) => f.code === "media_in_subcomposition");
-    expect(finding).toBeDefined();
-    expect(finding?.severity).toBe("error");
-    expect(finding?.elementId).toBe("v1");
-    expect(finding?.message).toContain("sub-composition");
+    expect(finding).toBeUndefined();
   });
 
   it("does not flag media in a host-root (non-sub) composition", async () => {
diff --git a/packages/lint/src/rules/media.ts b/packages/lint/src/rules/media.ts
index 3084d4ce77..08abde636a 100644
--- a/packages/lint/src/rules/media.ts
+++ b/packages/lint/src/rules/media.ts
@@ -396,29 +396,6 @@ export const mediaRules: Array<(ctx: LintContext) => HyperframeLintFinding[]> =
     return findings;
   },
 
-  // media_in_subcomposition — <video>/<audio> only render as a DIRECT child of the host
-  // root (index.html). Inside a sub-composition <template> the runtime never seeks/decodes
-  // them, so they render BLANK/black in preview and renders — and the other lint/validate
-  // passes otherwise miss it (only a per-frame snapshot reveals the blank panel).
-  ({ tags, options }) => {
-    const findings: HyperframeLintFinding[] = [];
-    if (!options.isSubComposition) return findings;
-    for (const tag of tags) {
-      if (tag.name !== "video" && tag.name !== "audio") continue;
-      const elementId = readAttr(tag.raw, "id") || undefined;
-      findings.push({
-        code: "media_in_subcomposition",
-        severity: "error",
-        message: `<${tag.name}${elementId ? ` id="${elementId}"` : ""}> is inside a sub-composition. The runtime only drives media that is a DIRECT child of the host root (index.html); media inside a sub-comp <template> is never seeked/decoded and renders BLANK/black in preview and renders.`,
-        elementId,
-        fixHint:
-          "Move the media OUT of the sub-composition: place the <video>/<audio> as a direct child of #root in index.html, positioned over the scene, and drive any per-scene motion on the MAIN timeline at global time (a sub-comp timeline cannot reach host elements). See composition-patterns.md archetype B.",
-        snippet: truncateSnippet(tag.raw),
-      });
-    }
-    return findings;
-  },
-
   // self_closing_media_tag
   ({ source }) => {
     const findings: HyperframeLintFinding[] = [];
diff --git a/skills-manifest.json b/skills-manifest.json
index d65353ba66..3201569e68 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -6,7 +6,7 @@
       "files": 140
     },
     "faceless-explainer": {
-      "hash": "d53bcc3cbcfaa7bb",
+      "hash": "15fc5a20e2a44bbe",
       "files": 22
     },
     "figma": {
@@ -26,11 +26,11 @@
       "files": 121
     },
     "hyperframes-cli": {
-      "hash": "dc57ec7198b9eaac",
+      "hash": "de00375f053c05e8",
       "files": 11
     },
     "hyperframes-core": {
-      "hash": "85004c9571ed19ce",
+      "hash": "773fc6d15d9e87b3",
       "files": 19
     },
     "hyperframes-creative": {
@@ -58,7 +58,7 @@
       "files": 132
     },
     "pr-to-video": {
-      "hash": "17ed27aa2cc32501",
+      "hash": "0eb5abe09844cee4",
       "files": 29
     },
     "product-launch-video": {
diff --git a/skills/faceless-explainer/scripts/assemble-index.mjs b/skills/faceless-explainer/scripts/assemble-index.mjs
index b51ee04210..8a7554500a 100644
--- a/skills/faceless-explainer/scripts/assemble-index.mjs
+++ b/skills/faceless-explainer/scripts/assemble-index.mjs
@@ -38,14 +38,14 @@
 // `lint` failures surface HERE instead of after assembly + a wasted render):
 //   ① AUTO-REPAIR — a sub-comp root missing data-width/data-height: inject the canvas
 //      dims (the renderer needs them on the cloned root; else lint root_missing_dimensions).
-//   ② HARD FAIL  — <video>/<audio> inside a sub-comp: the runtime only drives media that
-//      is a DIRECT child of the host root, so sub-comp media renders blank/black.
-//   ③ HARD FAIL  — a timed element (data-start+duration+track-index) that is not the root
+//   ② HARD FAIL  — a timed element (data-start+duration+track-index) that is not the root
 //      and lacks class="clip" (shows the whole frame), or two same-track clips that overlap.
+//   (Media inside a sub-comp is NOT a violation: the runtime seeks + decodes nested
+//    <video>/<audio> at any depth — see packages/core/src/runtime/{media,startResolver}.ts.)
 //
 // Exit 0 = index.html written + summary. Exit 1 = fatal contract break (no
 // frames, a built/animated frame missing its src/file, a frame with no
-// duration, an inner data-composition-id mismatch, or a guard ②/③ violation).
+// duration, an inner data-composition-id mismatch, or a guard ② violation).
 // No backstop: fix upstream.
 
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
@@ -121,7 +121,7 @@ const outPath = resolve(flag("out", join(hyperframesDir, "index.html")));
 
 const r3 = (x) => Math.round(x * 1000) / 1000;
 const anomalies = [];
-const frameErrors = []; // fatal per-frame composition violations (guards ②/③) — reported together
+const frameErrors = []; // fatal per-frame composition violations (guard ②) — reported together
 const repairs = []; // auto-repairs applied to frame files in place (guard ①)
 
 // ---------- parse storyboard ----------
@@ -129,7 +129,7 @@ if (!existsSync(storyboardPath)) die(`STORYBOARD.md not found at ${storyboardPat
 const manifest = parseStoryboard(readFileSync(storyboardPath, "utf8"));
 const { width: WIDTH, height: HEIGHT } = parseFormat(manifest.globals.format);
 
-// ---------- per-frame composition guards (see header ①②③) ----------
+// ---------- per-frame composition guards (see header ①②) ----------
 // String-level checks on each frame's HTML — no DOM parse, deterministic, run in
 // the same pass that already reads the file. OPEN_TAG matches one opening tag while
 // tolerating quoted attribute values that contain ">" (e.g. inline styles).
@@ -166,21 +166,17 @@ function guardFrame(html, label) {
   const errors = [];
   // Scan a copy with comments + <script>/<style> bodies blanked, so a tag-like string
   // in a comment (e.g. "<!-- match the host <video> coords -->") or in GSAP code can't
-  // trip ②/③. ① still splices into the ORIGINAL html, so its offsets stay correct.
+  // trip ②. ① still splices into the ORIGINAL html, so its offsets stay correct.
   const scan = html
     .replace(/<!--[\s\S]*?-->/g, " ")
     .replace(/<script\b[\s\S]*?<\/script[^>]*>/gi, " ")
     .replace(/<style\b[\s\S]*?<\/style[^>]*>/gi, " ");
 
-  // ② media inside a sub-comp — never driven by the runtime (renders blank/black).
-  const media = scan.match(/<(video|audio)(?=[\s/>])/i);
-  if (media) {
-    errors.push(
-      `${label}: has a <${media[1].toLowerCase()}> inside the sub-composition. The runtime only drives media that is a DIRECT child of the host root (index.html) — sub-comp media renders blank/black. Move the clip to index.html as a root-level <video>/<audio> and drive any per-scene motion on the main timeline (composition-patterns.md archetype B).`,
-    );
-  }
-
-  // ③ timed-element checks: missing class="clip", and same-track window overlap.
+  // ② timed-element checks: missing class="clip", and same-track window overlap.
+  // (Media inside a sub-comp is fine: the runtime's global media sweep seeks + decodes
+  // <video>/<audio> at any nesting depth, re-basing each clip's local data-start by its
+  // host composition's absolute start — no root-child requirement. See
+  // packages/core/src/runtime/{media,startResolver}.ts.)
   const re = new RegExp(OPEN_TAG, "g");
   const clips = [];
   let m;
@@ -285,7 +281,7 @@ for (const f of manifest.frames) {
       `${label}: ${f.src} is empty or has no HTML — the worker wrote a blank/partial file. Re-dispatch that worker before assembling.`,
     );
   }
-  // pre-assembly guards: ① repair missing root dims in place, ②/③ collect fatal violations.
+  // pre-assembly guards: ① repair missing root dims in place, ② collects fatal violations.
   const guard = guardFrame(html, label);
   if (guard.repairedHtml) {
     writeFileSync(compAbs, guard.repairedHtml);
diff --git a/skills/hyperframes-cli/references/lint-validate-inspect.md b/skills/hyperframes-cli/references/lint-validate-inspect.md
index 78a6eee89c..3d6b13f1e5 100644
--- a/skills/hyperframes-cli/references/lint-validate-inspect.md
+++ b/skills/hyperframes-cli/references/lint-validate-inspect.md
@@ -23,13 +23,7 @@ npx hyperframes lint --json           # machine-readable
 
 Lints `index.html` and all files in `compositions/`. Reports errors (must fix), warnings (should fix), and info (with `--verbose`). Catches missing `data-composition-id`, overlapping tracks on the same `data-track-index`, unregistered timelines, and GSAP/CSS transform conflicts.
 
-**Blind spot — media inside a sub-composition (not yet a lint rule).** A `<video>`/`<audio>` inside a `compositions/*.html` `<template>` (or nested in a wrapper `<div>` anywhere) is never seeked/decoded and renders blank/black; the automated checks all pass. Media must be a direct child of the host root (`index.html`) — see `hyperframes-core` → `variables-and-media.md`. Until a rule exists, check manually before render:
-
-```bash
-grep -nE '<(video|audio)\b' compositions/*.html   # expect NO matches; media belongs in index.html
-```
-
-A non-empty result is a defect. Then `snapshot` each scene that has a video and confirm the panel actually shows footage (a blank/black panel where a clip should play is a bug, not a placeholder — treat it as render-blocking).
+`<video>`/`<audio>` work at any nesting depth, including inside a `compositions/*.html` sub-composition or a wrapper `<div>`: the runtime discovers media with a flat DOM query and seeks/decodes it wherever it lives (`packages/core/src/runtime/{media,startResolver}.ts`). After a render, `snapshot` each scene that has a video and confirm the panel actually shows footage (a blank/black panel where a clip should play is a real bug, not a placeholder).
 
 ## check
 
diff --git a/skills/hyperframes-core/SKILL.md b/skills/hyperframes-core/SKILL.md
index 74d21fb81b..f3dc06d769 100644
--- a/skills/hyperframes-core/SKILL.md
+++ b/skills/hyperframes-core/SKILL.md
@@ -60,7 +60,7 @@ Surfaced here; full rationale in the linked reference. Do not violate:
 - No render-time clocks / unseeded `Math.random` / network / input-state; no `repeat: -1` (use a finite count). → `determinism-rules.md`
 - Animate only the visual-property allowlist; never tween `display` or raw `visibility`. GSAP `autoAlpha` and zero-duration timeline boundary sets are the only visibility exceptions, and only on non-clip elements or wrappers inside a clip. The framework alone controls `.clip` visibility. Do not `gsap.set` later-scene clips at page load. → `determinism-rules.md`
 - No `<br>` in body text; transformed elements must be block-level + sized; pulsing absolute decoratives need peak clearance. → `determinism-rules.md`
-- `<video>`/`<audio>` must be a **direct child of the host root** (never inside a sub-comp `<template>`/wrapper); the framework owns playback. → `variables-and-media.md`
+- `<video>`/`<audio>` work at **any nesting depth** (including inside a sub-comp `<template>` or wrapper); the framework owns playback and seeks/decodes media wherever it lives. The one caveat is timelines, not placement: a sub-comp timeline can't animate host-root elements. → `variables-and-media.md`
 - Every `id` must be unique across the **assembled** page; inside a sub-comp, prefix ids with the composition id (`#<id>-hero`). Duplicate `<video>`/`<img>` ids render **blank** — the producer injects frames by `getElementById`, and cross-file dupes slip past `lint`. → `composition-patterns.md`
 - A full-screen scene fill goes on a full-bleed **child** (`position:absolute; inset:0`), never on the composition root itself — the producer's frame compositing can drop the root element's own `background` (the frame renders **black**) even though preview/`snapshot` show it correctly. → `composition-patterns.md`
 
diff --git a/skills/hyperframes-core/references/composition-patterns.md b/skills/hyperframes-core/references/composition-patterns.md
index 54f66bc4fd..271407d1e4 100644
--- a/skills/hyperframes-core/references/composition-patterns.md
+++ b/skills/hyperframes-core/references/composition-patterns.md
@@ -130,11 +130,11 @@ Key properties of this layout:
 
 The sub-comp contains the scene's full DOM, scoped CSS, and timeline. This is the standard pattern in `sub-compositions.md` — most scenes are this.
 
-### B. Host media + main-timeline driver (REQUIRED for any `<video>`/`<audio>`)
+### B. Host media + main-timeline driver (one pattern for `<video>`/`<audio>`)
 
-Media playback only works when the `<video>`/`<audio>` is a **direct child of the host root** — never inside a sub-comp `<template>` (it would render blank/black). This is not optional or "for media that spans scenes"; it applies to every clip, including a scene-specific one. The scene's sub-comp keeps the frame/shell; the media is a host sibling positioned over it.
+`<video>`/`<audio>` seek and decode at any nesting depth, so a scene-specific clip can live inside its scene's sub-comp with scene-local `data-start` and be driven by that sub-comp's own timeline. Use this host-media pattern instead when you want the media's motion authored on the **main** timeline: put the `<video>`/`<audio>` as a host-root sibling positioned over the scene's frame.
 
-A sub-comp timeline **cannot** drive host elements (a global selector or `document.querySelector` does not resolve across the boundary). So author the media's per-scene motion (scale/opacity/morph/tilt/breathing) on the **main timeline** in `index.html`, at **global time** = scene-local time + the scene slot's `data-start`.
+The reason to reach for it: a sub-comp timeline **cannot** drive host elements (a global selector or `document.querySelector` does not resolve across the boundary). So if the media lives at the host root, author its per-scene motion (scale/opacity/morph/tilt/breathing) on the **main timeline** in `index.html`, at **global time** = scene-local time + the scene slot's `data-start`.
 
 ```html
 <!-- index.html (host) -->
@@ -193,7 +193,7 @@ A sub-comp timeline **cannot** drive host elements (a global selector or `docume
 
 Caveats:
 
-- The host media must be a direct root child and exist in the DOM (static in `index.html`) — it always is.
+- In this pattern the media is a host-root child, static in `index.html`, so the main timeline's selector resolves it. (Media nested in a sub-comp is also driven fine; it just can't be reached by the main timeline's selectors — drive it from the sub-comp's own timeline.)
 - Clip lifecycle owns the media element's visibility across its `[data-start, data-start+data-duration]` window. The main-timeline opacity/scale tweens compose with it fine; for an opacity reveal/crossfade prefer a host **wrapper** so you are not fighting the lifecycle on the media element itself.
 - Two media elements sharing the same `src` + `data-start` trigger `duplicate_media_discovery_risk` (benign — both still render).
 
diff --git a/skills/hyperframes-core/references/data-attributes.md b/skills/hyperframes-core/references/data-attributes.md
index dfde93be3b..fcaae3362d 100644
--- a/skills/hyperframes-core/references/data-attributes.md
+++ b/skills/hyperframes-core/references/data-attributes.md
@@ -22,7 +22,7 @@ The root should be `position: relative`, have explicit pixel dimensions, and hid
 
 Timed child elements are clips. **`class="clip"` is required on visible timed elements** (`<div>`, `<img>`, etc.) — without it the runtime keeps the element visible for the whole composition, ignoring `data-start` / `data-duration`. Omit on `<video>` (framework manages visibility directly) and `<audio>` (no visual).
 
-**Clips must be DIRECT children of the composition root.** A clip nested inside a wrapper `<div>` is not registered — most visibly, a `<video>` in a wrapper is never seeked/decoded and renders black. To wrap/transform a clip, put the wrapper _inside_ the clip, or animate the clip element itself; do not wrap the clip. (`<video>`/`<audio>` additionally must be at the **host** root, never in a sub-comp `<template>` — see `variables-and-media.md`.)
+**Visual clips (`class="clip"`) must be DIRECT children of the composition root.** A clip nested inside a wrapper `<div>` is not registered as a clip, so its `data-start`/`data-duration` are ignored and it stays visible the whole composition. To wrap/transform a clip, put the wrapper _inside_ the clip, or animate the clip element itself; do not wrap the clip. (This is a clip-_visibility_ rule. `<video>`/`<audio>` are exempt: the framework drives their playback via a flat DOM query, so they seek/decode at any depth, including inside a sub-comp `<template>` — see `variables-and-media.md`.)
 
 | Attribute          | Required                                        | Meaning                                                                                                                           |
 | ------------------ | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
diff --git a/skills/hyperframes-core/references/variables-and-media.md b/skills/hyperframes-core/references/variables-and-media.md
index 4a43191107..0d50268f61 100644
--- a/skills/hyperframes-core/references/variables-and-media.md
+++ b/skills/hyperframes-core/references/variables-and-media.md
@@ -62,12 +62,9 @@ document.getElementById("title").textContent = title;
 
 ## Media
 
-**NON-NEGOTIABLE: `<video>`/`<audio>` must be a DIRECT child of the host composition root (`index.html`).** The runtime only registers + drives media that is a direct root child. Media placed inside a sub-composition `<template>`, or wrapped in any intermediate `<div>`, is never seeked/decoded → renders blank (paper/white) or black. Do not rely on `lint` or `check` alone; a per-frame `snapshot` reveals the blank panel.
+**`<video>`/`<audio>` work at any nesting depth, including inside a sub-composition `<template>` or a wrapper `<div>`.** The runtime discovers media with a flat `document.querySelectorAll("video, audio")`, resolves each element's host composition via `element.closest("[data-composition-id]")`, and rebases its local `data-start` by the accumulated absolute start of every ancestor composition (`packages/core/src/runtime/{media,startResolver}.ts`). So a scene-specific clip can live in its scene's sub-comp with scene-local `data-start`, and it seeks/decodes correctly. If a panel renders blank after a render, that is a real bug: capture a per-frame `snapshot` and treat it as render-blocking.
 
-Consequences:
-
-- A scene-specific clip still lives at the host root, not in the scene's sub-comp. The sub-comp keeps only the frame/shell; the media is a sibling host element positioned over it.
-- A sub-composition **cannot reach or animate host elements** — neither `document.querySelector("#host-id")` nor a gsap selector string (`tl.to("#host-id", …)`) resolves across the boundary; a sub-comp timeline only drives its own subtree. So **all per-scene motion on host media (scale/opacity/morph/tilt/breathing) must be authored on the MAIN timeline in `index.html`, at GLOBAL time** (scene-local time + the scene slot's `data-start`). For 3D tilt without a perspective parent, use gsap `transformPerspective` on the element. See `composition-patterns.md` archetype B.
+The one real constraint is about **timelines, not media placement**: a sub-composition timeline **cannot reach or animate host elements** — neither `document.querySelector("#host-id")` nor a gsap selector string (`tl.to("#host-id", …)`) resolves across the boundary; a sub-comp timeline only drives its own subtree. So if a media element lives at the host root, **its per-scene motion (scale/opacity/morph/tilt/breathing) must be authored on the MAIN timeline in `index.html`, at GLOBAL time** (scene-local time + the scene slot's `data-start`). Keeping the media inside the scene sub-comp instead lets that sub-comp's own timeline animate it with scene-local time. For 3D tilt without a perspective parent, use gsap `transformPerspective` on the element. See `composition-patterns.md` archetype B.
 
 Video elements must be muted and inline. Audio must be a separate `<audio>` element, even when it uses the same source file.
 
@@ -96,8 +93,7 @@ Video elements must be muted and inline. Audio must be a separate `<audio>` elem
 ### Media Rules
 
 - **Do not** call `video.play()`, `audio.play()`, pause, or seek in composition code. HyperFrames owns playback.
-- **Do not** place media inside a sub-comp `<template>` or any wrapper `<div>` — direct host-root child only (see above), else it never decodes.
-- **Do not** drive host media from a sub-comp timeline — it has no effect. Drive it from the main timeline at global time.
+- **Do not** drive host-root media from a sub-comp timeline: a sub-comp timeline cannot reach elements outside its subtree, so it has no effect. Drive host-root media from the main timeline at global time (or keep the media inside the sub-comp whose timeline animates it).
 - **Do not** animate timed media element dimensions; animate a non-timed wrapper instead.
 - **Do not** nest video inside a timed wrapper. Put timing on the media element or keep the wrapper untimed.
 - Add `crossorigin="anonymous"` for external media that needs canvas capture or pixel inspection.
diff --git a/skills/pr-to-video/scripts/assemble-index.mjs b/skills/pr-to-video/scripts/assemble-index.mjs
index fe4f1e7868..adb1318f21 100644
--- a/skills/pr-to-video/scripts/assemble-index.mjs
+++ b/skills/pr-to-video/scripts/assemble-index.mjs
@@ -38,14 +38,14 @@
 // `lint` failures surface HERE instead of after assembly + a wasted render):
 //   ① AUTO-REPAIR — a sub-comp root missing data-width/data-height: inject the canvas
 //      dims (the renderer needs them on the cloned root; else lint root_missing_dimensions).
-//   ② HARD FAIL  — <video>/<audio> inside a sub-comp: the runtime only drives media that
-//      is a DIRECT child of the host root, so sub-comp media renders blank/black.
-//   ③ HARD FAIL  — a timed element (data-start+duration+track-index) that is not the root
+//   ② HARD FAIL  — a timed element (data-start+duration+track-index) that is not the root
 //      and lacks class="clip" (shows the whole frame), or two same-track clips that overlap.
+//   (Media inside a sub-comp is NOT a violation: the runtime seeks + decodes nested
+//    <video>/<audio> at any depth — see packages/core/src/runtime/{media,startResolver}.ts.)
 //
 // Exit 0 = index.html written + summary. Exit 1 = fatal contract break (no
 // frames, a built/animated frame missing its src/file, a frame with no
-// duration, an inner data-composition-id mismatch, or a guard ②/③ violation).
+// duration, an inner data-composition-id mismatch, or a guard ② violation).
 // No backstop: fix upstream.
 
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
@@ -122,7 +122,7 @@ const outPath = resolve(flag("out", join(hyperframesDir, "index.html")));
 
 const r3 = (x) => Math.round(x * 1000) / 1000;
 const anomalies = [];
-const frameErrors = []; // fatal per-frame composition violations (guards ②/③) — reported together
+const frameErrors = []; // fatal per-frame composition violations (guard ②) — reported together
 const repairs = []; // auto-repairs applied to frame files in place (guard ①)
 
 // ---------- parse storyboard ----------
@@ -130,7 +130,7 @@ if (!existsSync(storyboardPath)) die(`STORYBOARD.md not found at ${storyboardPat
 const manifest = parseStoryboard(readFileSync(storyboardPath, "utf8"));
 const { width: WIDTH, height: HEIGHT } = parseFormat(manifest.globals.format);
 
-// ---------- per-frame composition guards (see header ①②③) ----------
+// ---------- per-frame composition guards (see header ①②) ----------
 // String-level checks on each frame's HTML — no DOM parse, deterministic, run in
 // the same pass that already reads the file. OPEN_TAG matches one opening tag while
 // tolerating quoted attribute values that contain ">" (e.g. inline styles).
@@ -167,21 +167,17 @@ function guardFrame(html, label) {
   const errors = [];
   // Scan a copy with comments + <script>/<style> bodies blanked, so a tag-like string
   // in a comment (e.g. "<!-- match the host <video> coords -->") or in GSAP code can't
-  // trip ②/③. ① still splices into the ORIGINAL html, so its offsets stay correct.
+  // trip ②. ① still splices into the ORIGINAL html, so its offsets stay correct.
   const scan = html
     .replace(/<!--[\s\S]*?-->/g, " ")
     .replace(/<script\b[\s\S]*?<\/script[^>]*>/gi, " ")
     .replace(/<style\b[\s\S]*?<\/style[^>]*>/gi, " ");
 
-  // ② media inside a sub-comp — never driven by the runtime (renders blank/black).
-  const media = scan.match(/<(video|audio)(?=[\s/>])/i);
-  if (media) {
-    errors.push(
-      `${label}: has a <${media[1].toLowerCase()}> inside the sub-composition. The runtime only drives media that is a DIRECT child of the host root (index.html) — sub-comp media renders blank/black. Move the clip to index.html as a root-level <video>/<audio> and drive any per-scene motion on the main timeline (composition-patterns.md archetype B).`,
-    );
-  }
-
-  // ③ timed-element checks: missing class="clip", and same-track window overlap.
+  // ② timed-element checks: missing class="clip", and same-track window overlap.
+  // (Media inside a sub-comp is fine: the runtime's global media sweep seeks + decodes
+  // <video>/<audio> at any nesting depth, re-basing each clip's local data-start by its
+  // host composition's absolute start — no root-child requirement. See
+  // packages/core/src/runtime/{media,startResolver}.ts.)
   const re = new RegExp(OPEN_TAG, "g");
   const clips = [];
   let m;
@@ -291,7 +287,7 @@ for (const f of manifest.frames) {
   } catch (error) {
     die(`${label}: ${error.message}`);
   }
-  // pre-assembly guards: ① repair missing root dims in place, ②/③ collect fatal violations.
+  // pre-assembly guards: ① repair missing root dims in place, ② collects fatal violations.
   const guard = guardFrame(html, label);
   if (guard.repairedHtml) {
     writeFileSync(compAbs, guard.repairedHtml);

From e710a1686f2442b460ea4973dca0be97c81ef184 Mon Sep 17 00:00:00 2001
From: Xuanru Li <157947275+xuanruli@users.noreply.github.com>
Date: Fri, 24 Jul 2026 17:38:58 -0700
Subject: [PATCH 051/125] feat(lint): add off_pivot_rotation hub-referenced
 layout check (#2744)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

## What it catches

A gauge needle / clock hand / dial pointer / radar sweep that rotates about the **wrong pivot** — the recovered center-of-rotation sits far from the dial hub (e.g. `transform-origin` at the needle base or SVG element edge instead of the dial center). Visually the needle "wobbles" or orbits off-axis instead of sweeping cleanly about the hub.

This is a genuine gap in the current checks: `rotation_pivot_drift` (#2741) provably **cannot** catch it — a correct sweeping needle's bbox-center orbits identically to a broken one, so only a **dial-hub reference** distinguishes them. This is the separate hub-referenced check that analysis called for.

## How it works

- Sampler maps 2 material endpoints per frame via `getScreenCTM` (honors the actual rendered transform, independent of `svgOrigin`).
- Resolves the dial hub = shared center of the modal set of static concentric circles, or the arc-center of the largest static near-circular path (Kasa circle fit).
- Fits a circle to the endpoint trajectory to recover the true center-of-rotation; flags drift `> 0.35 * pointer_length`. One warning per hub.
- Never fires without a resolvable hub. Walks the rotation reference to the composition root (not the `<svg>`) so a pointer rotated by a `div` ancestor is measured correctly.
- Multi-body guard: `>= 2` bodies at distinct angular positions on one hub = orbit/atom system, not a dial → suppressed.

## Corpus evidence (autonomous geometry-fuzz run, 81 fuzzed diagrams)

- **7 / 7 true positives, 0 false positives across all 81 samples.**
- Assigned TPs: fuzz005, fuzz017, fuzz032. Bonus TPs: fuzz044, fuzz056, fuzz068, fuzz080.
- **The Gemini-3.6 video-judge itself MISSED all 4 bonus TPs** (`vlm_has_defects: false`) — the deterministic hub-reference check beats the VLM on this defect class.
- FPs driven to 0 by the two principled guards above: fuzz016 (planet arc rotated by a `div` ancestor) cleared by root-walk; fuzz055 (atom) cleared by the multi-body guard.
- fuzz080 reads as a false positive to the connector check but is a true positive here — confirms the architectural boundary between the two checks is drawn correctly.

## Validation

- Autonomous Gemini-3.6 **video**-judge fuzz run to surface candidate defects, then a **deterministic FP sweep** across all 81 rendered compositions (not VLM-gated — code inspection is the arbiter, since the VLM both over- and under-calls this class).
- 9 unit tests (`checkPipeline.offPivotRotation.test.ts`) + full check suite pass; `bun run build` green.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
---
 .fallowrc.jsonc                               |  17 +
 packages/cli/src/commands/check.test.ts       |   1 +
 .../cli/src/commands/layout-audit.browser.js  | 193 ++++++++++
 packages/cli/src/utils/checkBrowser.ts        |  64 +++-
 .../checkPipeline.offPivotRotation.test.ts    | 252 ++++++++++++++
 packages/cli/src/utils/checkPipeline.ts       | 329 +++++++++++++++++-
 packages/cli/src/utils/checkTypes.ts          |  32 ++
 packages/cli/src/utils/layoutAudit.ts         |   3 +
 8 files changed, 878 insertions(+), 13 deletions(-)
 create mode 100644 packages/cli/src/utils/checkPipeline.offPivotRotation.test.ts

diff --git a/.fallowrc.jsonc b/.fallowrc.jsonc
index 2e47f6d433..1bcd56387b 100644
--- a/.fallowrc.jsonc
+++ b/.fallowrc.jsonc
@@ -593,6 +593,23 @@
       // makes non-trivial.
       "packages/studio-server/src/helpers/screenshotClip.ts",
       "packages/studio/vite.browser.ts",
+      // off_pivot_rotation Kåsa circle fit (feat/needle-pivot-offset-check):
+      // fitCirclePoints in layout-audit.browser.js and fitCircle in
+      // checkPipeline.ts are the same least-squares circle fit, but the browser
+      // copy is injected as a raw string via page.addScriptTag and cannot import
+      // the Node-side module across puppeteer's serialization boundary. The two
+      // copies carry matching "KEEP IN SYNC" headers; the duplication is
+      // intentional and per-language, so it's exempted here rather than faked
+      // away with cosmetic divergence.
+      "packages/cli/src/commands/layout-audit.browser.js",
+      "packages/cli/src/utils/checkPipeline.ts",
+      // check.test.ts: the fakeDriver-based command tests share a pre-existing
+      // arrange/act/assert scaffold (runScenario + vi.fn runPipeline + spy +
+      // createCheckCommand). Adding the required collectOffPivotRotationSample
+      // stub to the CheckAuditDriver fake shifts line numbers and re-flags that
+      // inherited clone; consistent with the norm above of leaving parallel
+      // command-test cases unabstracted.
+      "packages/cli/src/commands/check.test.ts",
     ],
   },
   "health": {
diff --git a/packages/cli/src/commands/check.test.ts b/packages/cli/src/commands/check.test.ts
index 09b214aa34..cdac2483ae 100644
--- a/packages/cli/src/commands/check.test.ts
+++ b/packages/cli/src/commands/check.test.ts
@@ -150,6 +150,7 @@ function fakeDriver(overrides: Partial<CheckAuditDriver> = {}): CheckAuditDriver
     collectLayout: vi.fn(async (_time: number, _tolerance: number) => []),
     collectLayoutGeometry: vi.fn(async () => `geometry-${geometryCallCount++}`),
     collectRotationSample: vi.fn(async (_time: number) => []),
+    collectOffPivotRotationSample: vi.fn(async (time: number) => ({ time, samples: [] })),
     collectGeometryCandidates: vi.fn(async () => []),
     collectMotionFrame: vi.fn(async (time: number) => ({ time, data: {}, liveness: {} })),
     anchorMotionIssues: vi.fn(async (issues: LayoutIssue[]) =>
diff --git a/packages/cli/src/commands/layout-audit.browser.js b/packages/cli/src/commands/layout-audit.browser.js
index 78b9dd8da8..1ee9085dd4 100644
--- a/packages/cli/src/commands/layout-audit.browser.js
+++ b/packages/cli/src/commands/layout-audit.browser.js
@@ -1531,4 +1531,197 @@
     }
     return samples;
   };
+
+  // Needle-pivot sampling (off_pivot_rotation). A gauge/clock/radar pointer
+  // whose center-of-rotation sits far from the dial hub. bbox-intrinsic measures
+  // can't tell a correct sweep from a broken one (a base-pivoted needle's bbox
+  // center orbits either way), so this records two MATERIAL points on each
+  // elongated rotating SVG figure — mapped through getScreenCTM so the actual
+  // rendered transform is honored regardless of svgOrigin/transform-origin — and
+  // the dial's static hub (the point shared by the most non-rotating circles).
+  // The pipeline fits a rotation to the material-point trajectories to recover
+  // the real center-of-rotation and flags it when it drifts off that hub.
+  function ctmRotationDeg(ctm) {
+    if (!ctm) return null;
+    return (Math.atan2(ctm.b, ctm.a) * 180) / Math.PI;
+  }
+
+  function ctmScale(ctm) {
+    return Math.hypot(ctm.a, ctm.b);
+  }
+
+  function mapPoint(svg, ctm, x, y) {
+    const point = svg.createSVGPoint();
+    point.x = x;
+    point.y = y;
+    const mapped = point.matrixTransform(ctm);
+    return { x: mapped.x, y: mapped.y };
+  }
+
+  // Walks up to (and including) the composition root, NOT just the owner <svg>:
+  // an element spun by a div ancestor above its svg must not be mistaken for a
+  // static hub anchor (else a lone rotating arc becomes its own dial center).
+  function hasRotatedAncestor(element, root) {
+    let node = element;
+    while (node) {
+      const angle = rotationAngleDeg(getComputedStyle(node).transform);
+      if (angle !== null && Math.abs(angle) > 1) return true;
+      if (node === root) break;
+      node = node.parentElement;
+    }
+    return false;
+  }
+
+  // KEEP IN SYNC with `fitCircle` in packages/cli/src/utils/checkPipeline.ts —
+  // this browser copy resolves arc-drawn dial hubs and is injected as a raw
+  // string (no import across the puppeteer boundary), so the Kåsa math is
+  // intentionally duplicated per-language. Any change must land in both copies.
+  function fitCirclePoints(points) {
+    const count = points.length;
+    if (count < 3) return null;
+    const meanX = points.reduce((sum, p) => sum + p.x, 0) / count;
+    const meanY = points.reduce((sum, p) => sum + p.y, 0) / count;
+    let suu = 0,
+      svv = 0,
+      suv = 0,
+      suuu = 0,
+      svvv = 0,
+      suvv = 0,
+      svuu = 0;
+    for (const point of points) {
+      const u = point.x - meanX;
+      const v = point.y - meanY;
+      suu += u * u;
+      svv += v * v;
+      suv += u * v;
+      suuu += u * u * u;
+      svvv += v * v * v;
+      suvv += u * v * v;
+      svuu += v * u * u;
+    }
+    const det = suu * svv - suv * suv;
+    if (Math.abs(det) < 1e-6) return null;
+    const uc = (((suuu + suvv) / 2) * svv - ((svvv + svuu) / 2) * suv) / det;
+    const vc = (((svvv + svuu) / 2) * suu - ((suuu + suvv) / 2) * suv) / det;
+    const cx = uc + meanX;
+    const cy = vc + meanY;
+    const radius = Math.sqrt(uc * uc + vc * vc + (suu + svv) / count);
+    let squaredError = 0;
+    for (const point of points) {
+      const delta = Math.hypot(point.x - cx, point.y - cy) - radius;
+      squaredError += delta * delta;
+    }
+    return { cx, cy, radius, residual: Math.sqrt(squaredError / count) };
+  }
+
+  // Fallback for dials drawn as arc <path> rather than <circle> rings: sample
+  // the largest static, near-circular path and recover its arc center.
+  function arcHubForSvg(svg, root) {
+    let best = null;
+    for (const path of Array.from(svg.querySelectorAll("path"))) {
+      if (hasRotatedAncestor(path, root)) continue;
+      if (typeof path.getTotalLength !== "function") continue;
+      const total = path.getTotalLength();
+      if (total < 200) continue;
+      const ctm = path.getScreenCTM();
+      if (!ctm) continue;
+      const points = [];
+      for (let i = 0; i <= 16; i++) {
+        const local = path.getPointAtLength((total * i) / 16);
+        points.push(mapPoint(svg, ctm, local.x, local.y));
+      }
+      const fit = fitCirclePoints(points);
+      if (!fit || fit.radius < 40) continue;
+      if (fit.residual > 0.05 * fit.radius) continue;
+      if (!best || fit.radius > best.radius) best = fit;
+    }
+    return best ? { hx: best.cx, hy: best.cy, hr: best.radius, count: 2 } : null;
+  }
+
+  function dialHubForSvg(svg, root) {
+    const centers = [];
+    for (const circle of Array.from(svg.querySelectorAll("circle"))) {
+      if (hasRotatedAncestor(circle, root)) continue;
+      const ctm = circle.getScreenCTM();
+      if (!ctm) continue;
+      const cx = Number.parseFloat(circle.getAttribute("cx") || "0");
+      const cy = Number.parseFloat(circle.getAttribute("cy") || "0");
+      const center = mapPoint(svg, ctm, cx, cy);
+      const radius = Number.parseFloat(circle.getAttribute("r") || "0") * ctmScale(ctm);
+      centers.push({ x: center.x, y: center.y, radius });
+    }
+    let best = null;
+    for (const anchor of centers) {
+      const cluster = centers.filter(
+        (other) => Math.hypot(other.x - anchor.x, other.y - anchor.y) <= 8,
+      );
+      if (!best || cluster.length > best.cluster.length) best = { anchor, cluster };
+    }
+    if (best && best.cluster.length >= 2) {
+      const count = best.cluster.length;
+      const hx = best.cluster.reduce((sum, item) => sum + item.x, 0) / count;
+      const hy = best.cluster.reduce((sum, item) => sum + item.y, 0) / count;
+      const hr = best.cluster.reduce((max, item) => Math.max(max, item.radius), 0);
+      return { hx, hy, hr, count };
+    }
+    return arcHubForSvg(svg, root);
+  }
+
+  window.__hyperframesOffPivotRotationSample = function collectOffPivotRotationSample() {
+    const root =
+      document.querySelector("[data-composition-id][data-width][data-height]") ||
+      document.querySelector("[data-composition-id]") ||
+      document.body;
+    const samples = [];
+    const hubCache = new Map();
+    const CANDIDATE_CAP = 60;
+    for (const element of Array.from(
+      root.querySelectorAll("path, polygon, line, rect, polyline, g"),
+    )) {
+      if (samples.length >= CANDIDATE_CAP) break;
+      const svg = element.ownerSVGElement;
+      if (!svg || typeof element.getBBox !== "function") continue;
+      if (element.closest("[data-layout-allow-orbit]")) continue;
+      if (!isVisibleElement(element, 0.05)) continue;
+      const ctm = element.getScreenCTM();
+      const angle = ctmRotationDeg(ctm);
+      if (ctm === null || angle === null) continue;
+      let bbox;
+      try {
+        bbox = element.getBBox();
+      } catch {
+        continue;
+      }
+      const long = Math.max(bbox.width, bbox.height);
+      const short = Math.min(bbox.width, bbox.height);
+      if (short <= 0 || long / short < 3 || long < 40) continue;
+      const vertical = bbox.height >= bbox.width;
+      const midMajor = vertical ? bbox.x + bbox.width / 2 : bbox.y + bbox.height / 2;
+      const a = vertical
+        ? mapPoint(svg, ctm, midMajor, bbox.y)
+        : mapPoint(svg, ctm, bbox.x, midMajor);
+      const b = vertical
+        ? mapPoint(svg, ctm, midMajor, bbox.y + bbox.height)
+        : mapPoint(svg, ctm, bbox.x + bbox.width, midMajor);
+      let hub = hubCache.get(svg);
+      if (hub === undefined) {
+        hub = dialHubForSvg(svg, root);
+        hubCache.set(svg, hub);
+      }
+      samples.push({
+        selector: selectorFor(element),
+        ax: round(a.x),
+        ay: round(a.y),
+        bx: round(b.x),
+        by: round(b.y),
+        len: round(Math.hypot(b.x - a.x, b.y - a.y)),
+        angle: round(angle),
+        hx: hub ? round(hub.hx) : null,
+        hy: hub ? round(hub.hy) : null,
+        hr: hub ? round(hub.hr) : null,
+        hubCount: hub ? hub.count : 0,
+      });
+    }
+    return samples;
+  };
 })();
diff --git a/packages/cli/src/utils/checkBrowser.ts b/packages/cli/src/utils/checkBrowser.ts
index 2da9fc1918..d392e82677 100644
--- a/packages/cli/src/utils/checkBrowser.ts
+++ b/packages/cli/src/utils/checkBrowser.ts
@@ -42,6 +42,8 @@ import type {
   ContrastCapture,
   GeometryCandidateRequest,
   MotionSpecResolution,
+  OffPivotFrame,
+  OffPivotRotationSample,
   RotationSample,
   RunAuditGrid,
 } from "./checkTypes.js";
@@ -349,6 +351,7 @@ function createPageDriver(page: Page, setTime: (time: number) => void): CheckAud
     collectLayout: (time, tolerance) => collectLayout(page, time, tolerance),
     collectLayoutGeometry: () => collectLayoutGeometry(page),
     collectRotationSample: (time) => collectRotationSample(page, time),
+    collectOffPivotRotationSample: (time) => collectOffPivotRotationSample(page, time),
     collectGeometryCandidates: (time, request) => collectGeometryCandidates(page, time, request),
     collectMotionFrame: (time, selectors, scopes) =>
       collectMotionFrame(page, time, selectors, scopes),
@@ -470,13 +473,20 @@ async function collectLayoutGeometry(page: Page): Promise<string> {
   });
 }
 
-async function collectRotationSample(page: Page, time: number): Promise<RotationSample[]> {
-  const raw = await page.evaluate(() => {
-    const sample = Reflect.get(window, "__hyperframesRotationSample");
+/** Invoke a `window.__hyperframes*` sampler injected by layout-audit.browser.js
+ * and return its array result (or [] when absent / non-array). Shared by the
+ * per-frame sample collectors so the page.evaluate boilerplate lives once. */
+async function evaluateSampler(page: Page, globalName: string): Promise<unknown[]> {
+  return page.evaluate((name) => {
+    const sample = Reflect.get(window, name);
     if (typeof sample !== "function") return [];
     const result = Reflect.apply(sample, window, []);
     return Array.isArray(result) ? result : [];
-  });
+  }, globalName);
+}
+
+async function collectRotationSample(page: Page, time: number): Promise<RotationSample[]> {
+  const raw = await evaluateSampler(page, "__hyperframesRotationSample");
   return raw.flatMap((value) => parseRotationSample(value, time));
 }
 
@@ -494,6 +504,51 @@ function parseRotationSample(value: unknown, time: number): RotationSample[] {
   return [{ time, selector, cx, cy, w, h, angle }];
 }
 
+async function collectOffPivotRotationSample(page: Page, time: number): Promise<OffPivotFrame> {
+  const raw = await evaluateSampler(page, "__hyperframesOffPivotRotationSample");
+  return { time, samples: raw.flatMap(parseOffPivotRotationSample) };
+}
+
+/** Read every named key as a finite number; null if ANY is missing/non-finite.
+ * The mapped return type keeps each field a plain `number` (not `number |
+ * undefined`) so callers read `nums.ax` without re-narrowing. */
+function requiredNumbers<K extends string>(
+  value: Record<string, unknown>,
+  keys: readonly K[],
+): { [P in K]: number } | null {
+  const out = {} as { [P in K]: number };
+  for (const key of keys) {
+    const num = numberValue(value, key);
+    if (num === null) return null;
+    out[key] = num;
+  }
+  return out;
+}
+
+const OFF_PIVOT_REQUIRED_NUMBERS = ["ax", "ay", "bx", "by", "len", "angle", "hubCount"] as const;
+
+function parseOffPivotRotationSample(value: unknown): OffPivotRotationSample[] {
+  if (!isRecord(value)) return [];
+  const selector = stringValue(value, "selector");
+  const nums = requiredNumbers(value, OFF_PIVOT_REQUIRED_NUMBERS);
+  if (!selector || !nums) return [];
+  return [
+    {
+      selector,
+      ax: nums.ax,
+      ay: nums.ay,
+      bx: nums.bx,
+      by: nums.by,
+      len: nums.len,
+      angle: nums.angle,
+      hx: numberValue(value, "hx"),
+      hy: numberValue(value, "hy"),
+      hr: numberValue(value, "hr"),
+      hubCount: nums.hubCount,
+    },
+  ];
+}
+
 async function collectGeometryCandidates(
   page: Page,
   time: number,
@@ -1078,6 +1133,7 @@ const LAYOUT_ISSUE_CODES: readonly LayoutIssueCode[] = [
   "panel_out_of_canvas",
   "connector_detached",
   "rotation_pivot_drift",
+  "off_pivot_rotation",
   "motion_appears_late",
   "motion_out_of_order",
   "motion_off_frame",
diff --git a/packages/cli/src/utils/checkPipeline.offPivotRotation.test.ts b/packages/cli/src/utils/checkPipeline.offPivotRotation.test.ts
new file mode 100644
index 0000000000..cba3a0eeb9
--- /dev/null
+++ b/packages/cli/src/utils/checkPipeline.offPivotRotation.test.ts
@@ -0,0 +1,252 @@
+import { describe, expect, it } from "vitest";
+
+import { countAngularBodies, detectOffPivotRotation } from "./checkPipeline.js";
+import type { OffPivotFrame, OffPivotRotationSample } from "./checkTypes.js";
+
+/** A sample carrying its frame time, for test ergonomics; {@link toFrames}
+ * re-hoists the time into the on-the-wire {@link OffPivotFrame} envelope. */
+type TimedSample = OffPivotRotationSample & { time: number };
+
+/** One needle sample; defaults describe a sizable pointer on a hub at (500,500). */
+function sample(overrides: Partial<TimedSample> = {}): TimedSample {
+  return {
+    time: 0,
+    selector: "#needle",
+    ax: 0,
+    ay: 0,
+    bx: 0,
+    by: 0,
+    len: 200,
+    angle: 0,
+    hx: 500,
+    hy: 500,
+    hr: 220,
+    hubCount: 3,
+    ...overrides,
+  };
+}
+
+/** Merge per-selector timed samples into the time-hoisted frame envelope the
+ * detector consumes (all samples sharing a time land in one frame). */
+function toFrames(...groups: TimedSample[][]): OffPivotFrame[] {
+  const byTime = new Map<number, OffPivotRotationSample[]>();
+  for (const { time, ...rest } of groups.flat()) {
+    const frame = byTime.get(time);
+    if (frame) frame.push(rest);
+    else byTime.set(time, [rest]);
+  }
+  return [...byTime.entries()]
+    .sort(([a], [b]) => a - b)
+    .map(([time, samples]) => ({ time, samples }));
+}
+
+interface SweepOptions {
+  /** Center the endpoints actually orbit (the recovered center-of-rotation). */
+  cx: number;
+  cy: number;
+  /** Screen hub the check compares the recovered center against. */
+  hx?: number;
+  hy?: number;
+  selector?: string;
+  frames?: number;
+  spreadDeg?: number;
+  /** Outer/inner material-point radii; both share one angle so the pointer is
+   * rigid (constant separation |a-b| = rOuter - rInner). */
+  rOuter?: number;
+  rInner?: number;
+  /** Per-frame inner-radius growth — breaks rigidity (endpoint deformation). */
+  innerGrowth?: number;
+  hubCount?: number;
+}
+
+/** A rigid pointer swept about `(cx,cy)`: two material points on one radial line
+ * orbit that center, so their separation is constant (rigid body). */
+function sweep(options: SweepOptions): TimedSample[] {
+  const {
+    cx,
+    cy,
+    hx = 500,
+    hy = 500,
+    selector = "#needle",
+    frames = 6,
+    spreadDeg = 180,
+    rOuter = 100,
+    rInner = 40,
+    innerGrowth = 0,
+    hubCount = 3,
+  } = options;
+  return Array.from({ length: frames }, (_, i) => {
+    const deg = frames <= 1 ? 0 : (spreadDeg * i) / (frames - 1);
+    const rad = (deg * Math.PI) / 180;
+    const inner = rInner + innerGrowth * i;
+    const ax = cx + rOuter * Math.cos(rad);
+    const ay = cy + rOuter * Math.sin(rad);
+    const bx = cx + inner * Math.cos(rad);
+    const by = cy + inner * Math.sin(rad);
+    return sample({
+      selector,
+      time: i,
+      angle: deg,
+      ax,
+      ay,
+      bx,
+      by,
+      len: Math.hypot(ax - bx, ay - by),
+      hx,
+      hy,
+      hubCount,
+    });
+  });
+}
+
+describe("detectOffPivotRotation", () => {
+  it("fires when the recovered center-of-rotation is far from the dial hub", () => {
+    // Rigid pointer orbits (500,300) — 200px above the hub at (500,500).
+    const findings = detectOffPivotRotation(toFrames(sweep({ cx: 500, cy: 300 })));
+    expect(findings).toHaveLength(1);
+    const [f] = findings;
+    expect(f?.code).toBe("off_pivot_rotation");
+    expect(f?.severity).toBe("warning");
+    expect(f?.selector).toBe("#needle");
+    expect(f?.message).toContain("200px");
+    expect(f?.fixHint).toContain("hub");
+  });
+
+  it("does not fire on a correctly-hubbed needle (center-of-rotation on the hub)", () => {
+    expect(detectOffPivotRotation(toFrames(sweep({ cx: 500, cy: 500 })))).toHaveLength(0);
+  });
+
+  it("does not fire with fewer than the minimum (overdetermined) samples", () => {
+    // Blocker-1 core: any 3 non-collinear points fit a circle with ~0 residual,
+    // so a 3-sample "clean circle" guard is vacuous. Below 5 samples we refuse.
+    expect(detectOffPivotRotation(toFrames(sweep({ cx: 500, cy: 300, frames: 4 })))).toHaveLength(
+      0,
+    );
+    expect(detectOffPivotRotation(toFrames(sweep({ cx: 500, cy: 300, frames: 5 })))).toHaveLength(
+      1,
+    );
+  });
+
+  it("does not fire on arbitrary 3-point endpoint deformation (the reviewer repro)", () => {
+    // Three arbitrary non-collinear endpoint positions: geometrically they fit a
+    // circle exactly, but there are too few samples to be an overdetermined fit.
+    const group = [
+      sample({ time: 0, angle: 0, ax: 600, ay: 300, bx: 540, by: 300 }),
+      sample({ time: 1, angle: 90, ax: 505, ay: 402, bx: 500, by: 341 }),
+      sample({ time: 2, angle: 180, ax: 402, ay: 305, bx: 461, by: 299 }),
+    ];
+    expect(detectOffPivotRotation(toFrames(group))).toHaveLength(0);
+  });
+
+  it("does not fire when the tracked points deform (non-rigid) even with >=5 samples", () => {
+    // Endpoint A traces a clean wide circle about (500,300) — a naive fit would
+    // recover a 200px-off center and flag it — but the inner point drifts outward
+    // each frame, so the figure is deforming, not rotating rigidly.
+    const group = sweep({ cx: 500, cy: 300, frames: 6, innerGrowth: 8 });
+    expect(detectOffPivotRotation(toFrames(group))).toHaveLength(0);
+  });
+
+  it("does not fire when the >=5-sample trajectory is not a clean circle (high residual)", () => {
+    // Rigid separation (len constant) but the points jitter along a rough path,
+    // not one circle — the overdetermined RMS-residual guard rejects it.
+    const scatter = [
+      [600, 300],
+      [520, 420],
+      [470, 260],
+      [610, 350],
+      [430, 400],
+      [560, 250],
+    ];
+    const group = scatter.map(([ax, ay], i) =>
+      sample({
+        time: i,
+        angle: i * 40,
+        ax: ax ?? 0,
+        ay: ay ?? 0,
+        bx: (ax ?? 0) - 60,
+        by: ay ?? 0,
+        len: 60,
+      }),
+    );
+    expect(detectOffPivotRotation(toFrames(group))).toHaveLength(0);
+  });
+
+  it("does not fire when the pointer barely sweeps (fixed tilt)", () => {
+    expect(
+      detectOffPivotRotation(toFrames(sweep({ cx: 500, cy: 300, spreadDeg: 10 }))),
+    ).toHaveLength(0);
+  });
+
+  it("does not fire when no dial hub is resolvable", () => {
+    const group = sweep({ cx: 500, cy: 300 }).map((s) => ({
+      ...s,
+      hx: null,
+      hy: null,
+      hubCount: 0,
+    }));
+    expect(detectOffPivotRotation(toFrames(group))).toHaveLength(0);
+  });
+
+  it("does not fire when the hub has too few concentric circles", () => {
+    const group = sweep({ cx: 500, cy: 300 }).map((s) => ({ ...s, hubCount: 1 }));
+    expect(detectOffPivotRotation(toFrames(group))).toHaveLength(0);
+  });
+
+  it("requires the hub to be present for a sustained majority, not just the last frame", () => {
+    // Hub resolves only on the final frame; every earlier frame lacks it. A
+    // single-frame hub is not a reliable anchor — suppression is structural.
+    const group = sweep({ cx: 500, cy: 300 }).map((s, i, all) =>
+      i === all.length - 1 ? s : { ...s, hx: null, hy: null, hubCount: 0 },
+    );
+    expect(detectOffPivotRotation(toFrames(group))).toHaveLength(0);
+  });
+
+  it("collapses nested candidates on the same hub to a single finding", () => {
+    const group = sweep({ cx: 500, cy: 300 });
+    const child = sweep({ cx: 500, cy: 300, selector: "#needle > path:nth-of-type(1)" });
+    const findings = detectOffPivotRotation(toFrames(group, child));
+    expect(findings).toHaveLength(1);
+    expect(findings[0]?.selector).toBe("#needle");
+  });
+
+  it("suppresses multiple distinct bodies orbiting one hub (orbit/atom system)", () => {
+    // Two rigid bodies at DIFFERENT angular positions about the same hub — an
+    // orbit/radial system, not a single dial pointer.
+    const bodyA = sweep({ cx: 700, cy: 500, selector: "#electron-a" });
+    const bodyB = sweep({ cx: 300, cy: 500, selector: "#electron-b" });
+    expect(detectOffPivotRotation(toFrames(bodyA, bodyB))).toHaveLength(0);
+  });
+
+  it("flags one off-pivot hand on a multi-hand clock whose sibling hands are correctly hubbed", () => {
+    // Analog clock: three hands on one hub at (500,500). Two are correctly
+    // hubbed (center-of-rotation on the hub → not eligible findings); one is
+    // off-pivot (orbits (500,300), 200px above the hub). The multi-body
+    // suppression must count only ELIGIBLE candidates — the two hubbed hands
+    // are not orbiting bodies, so the lone off-pivot hand is NOT suppressed.
+    const offPivot = sweep({ cx: 500, cy: 300, selector: "#hand-second" });
+    const hubbedA = sweep({ cx: 500, cy: 500, selector: "#hand-hour" });
+    const hubbedB = sweep({ cx: 500, cy: 500, selector: "#hand-minute" });
+    const findings = detectOffPivotRotation(toFrames(offPivot, hubbedA, hubbedB));
+    expect(findings).toHaveLength(1);
+    expect(findings[0]?.selector).toBe("#hand-second");
+  });
+
+  it("returns nothing for an empty sample set", () => {
+    expect(detectOffPivotRotation([])).toHaveLength(0);
+  });
+});
+
+describe("countAngularBodies (multi-body / orbit-atom suppression guard)", () => {
+  it("collapses tightly-clustered angles to a single body", () => {
+    expect(countAngularBodies([10, 12, 13, -8])).toBe(1);
+  });
+
+  it("counts well-separated angular positions as distinct bodies", () => {
+    expect(countAngularBodies([0, 90, 180])).toBe(3);
+  });
+
+  it("wraps around 360 so 350 and 5 are the same body", () => {
+    expect(countAngularBodies([350, 5])).toBe(1);
+    expect(countAngularBodies([])).toBe(0);
+  });
+});
diff --git a/packages/cli/src/utils/checkPipeline.ts b/packages/cli/src/utils/checkPipeline.ts
index cebcf4c4a2..6f5145c8ff 100644
--- a/packages/cli/src/utils/checkPipeline.ts
+++ b/packages/cli/src/utils/checkPipeline.ts
@@ -48,6 +48,8 @@ import type {
   ContrastAuditEntry,
   GeometryCandidateRequest,
   MotionSpecResolution,
+  OffPivotFrame,
+  OffPivotRotationSample,
   RotationSample,
 } from "./checkTypes.js";
 
@@ -193,6 +195,10 @@ interface GridSamples {
   /** Every rotatable element's geometry at each layout sample; grouped by
    * selector after the run to detect rotation_pivot_drift. */
   rotationSamples: RotationSample[];
+  /** One time-hoisted frame of every elongated rotating SVG figure's
+   * material-point geometry + dial hub per layout sample; flattened by selector
+   * to detect off_pivot_rotation. */
+  indicatorFrames: OffPivotFrame[];
 }
 
 interface GeometrySeen {
@@ -365,6 +371,7 @@ async function collectGridSamples(
     contrastMs: 0,
     geometrySignatures: [],
     rotationSamples: [],
+    indicatorFrames: [],
   };
   for (const time of mergeSampleTimes(grid.layoutSamples, motion.times)) {
     await driver.seek(time);
@@ -378,6 +385,7 @@ async function collectGridSamples(
       issuesAtTime.push(...layoutIssues);
       collected.geometrySignatures.push(await driver.collectLayoutGeometry());
       collected.rotationSamples.push(...(await driver.collectRotationSample(time)));
+      collected.indicatorFrames.push(await driver.collectOffPivotRotationSample(time));
     }
     if (canvas) {
       const geometryIssues = await collectGeometryAt(
@@ -548,14 +556,21 @@ function rotationDriftFinding(
   };
 }
 
-function groupRotationSamplesBySelector(samples: RotationSample[]): Map<string, RotationSample[]> {
-  const bySelector = new Map<string, RotationSample[]>();
-  for (const sample of samples) {
-    const group = bySelector.get(sample.selector);
-    if (group) group.push(sample);
-    else bySelector.set(sample.selector, [sample]);
+/** Bucket items by a derived key, preserving insertion order within each bucket. */
+function groupBy<T>(items: T[], keyOf: (item: T) => string): Map<string, T[]> {
+  const byKey = new Map<string, T[]>();
+  for (const item of items) {
+    const group = byKey.get(keyOf(item));
+    if (group) group.push(item);
+    else byKey.set(keyOf(item), [item]);
   }
-  return bySelector;
+  return byKey;
+}
+
+/** Bucket time-samples by their CSS selector so each element's trajectory can be
+ * analyzed independently. Shared by rotation_pivot_drift and off_pivot_rotation. */
+function groupBySelector<T extends { selector: string }>(samples: T[]): Map<string, T[]> {
+  return groupBy(samples, (sample) => sample.selector);
 }
 
 /** Enough samples to establish a spin trajectory (one frame can't). */
@@ -628,7 +643,7 @@ export function detectRotationPivotDrift(
 ): AnchoredLayoutIssue[] {
   const findings: AnchoredLayoutIssue[] = [];
   const viewportFloor = ROTATION_DRIFT_VIEWPORT_FRACTION * Math.min(canvas.width, canvas.height);
-  for (const group of groupRotationSamplesBySelector(samples).values()) {
+  for (const group of groupBySelector(samples).values()) {
     if (!isRotationDriftCandidate(group)) continue;
     const medianSize = median(group.map((s) => Math.max(s.w, s.h)));
     const threshold = Math.max(ROTATION_DRIFT_SIZE_FRACTION * medianSize, viewportFloor);
@@ -640,6 +655,296 @@ export function detectRotationPivotDrift(
   return findings;
 }
 
+// off_pivot_rotation thresholds. A pointer must actually sweep, sit on a
+// resolvable dial hub, and its recovered center-of-rotation must land far from
+// that hub relative to the pointer's own length.
+//
+// The fit MUST be OVERDETERMINED: any 3 non-collinear points fit a circle with
+// ~zero residual, so a 3-sample "clean circle" guard is vacuous — arbitrary
+// endpoint deformation or translation would read as a perfect orbit. Require
+// >=5 distinct time-samples so the least-squares residual actually measures
+// whether the trajectory lies on one circle.
+const INDICATOR_MIN_SAMPLES = 5;
+const INDICATOR_MIN_ANGLE_SPREAD_DEG = 20;
+const INDICATOR_MIN_HUB_CIRCLES = 2;
+// The Kåsa fit's RMS residual normalized by the fitted radius. With >=5 samples
+// a genuine rotation lands well under this; non-circular motion (deformation,
+// translation, skew, jitter/scatter) blows past it, so we skip rather than
+// misread it as an off-hub pivot.
+const INDICATOR_MAX_FIT_RESIDUAL_FRACTION = 0.05;
+// Rigid-body guard: rotation preserves shape, so the pairwise distance between
+// the two tracked material points must stay ~constant. If it swings more than
+// this fraction of its median across the window the element is deforming, not
+// rotating rigidly — do not flag.
+const INDICATOR_MAX_RIGID_LEN_VARIATION = 0.15;
+// Drift beyond this fraction of the pointer length is a wrong pivot. A correctly
+// hubbed needle recovers a center within a few px of the hub (≈0); a base/edge
+// pivot mistake puts the recovered center a large fraction of the needle away.
+const INDICATOR_DRIFT_LENGTH_FRACTION = 0.35;
+
+interface CircleFit {
+  cx: number;
+  cy: number;
+  radius: number;
+  residual: number;
+}
+
+/** Kåsa algebraic circle fit; null when the points are near-collinear/degenerate
+ * (no stable center recoverable).
+ *
+ * KEEP IN SYNC with `fitCirclePoints` in
+ * packages/cli/src/commands/layout-audit.browser.js — the browser sampler needs
+ * the same fit to resolve arc-drawn dial hubs, but it is injected as a raw
+ * string (no import across the puppeteer boundary), so the math is intentionally
+ * duplicated per-language. Any change to the algorithm must land in both. */
+function fitCircle(points: Array<{ x: number; y: number }>): CircleFit | null {
+  const count = points.length;
+  if (count < 3) return null;
+  const meanX = points.reduce((sum, p) => sum + p.x, 0) / count;
+  const meanY = points.reduce((sum, p) => sum + p.y, 0) / count;
+  let suu = 0;
+  let svv = 0;
+  let suv = 0;
+  let suuu = 0;
+  let svvv = 0;
+  let suvv = 0;
+  let svuu = 0;
+  for (const point of points) {
+    const u = point.x - meanX;
+    const v = point.y - meanY;
+    suu += u * u;
+    svv += v * v;
+    suv += u * v;
+    suuu += u * u * u;
+    svvv += v * v * v;
+    suvv += u * v * v;
+    svuu += v * u * u;
+  }
+  const determinant = suu * svv - suv * suv;
+  if (Math.abs(determinant) < 1e-6) return null;
+  const rhsU = (suuu + suvv) / 2;
+  const rhsV = (svvv + svuu) / 2;
+  const uc = (rhsU * svv - rhsV * suv) / determinant;
+  const vc = (rhsV * suu - rhsU * suv) / determinant;
+  const cx = uc + meanX;
+  const cy = vc + meanY;
+  const radius = Math.sqrt(uc * uc + vc * vc + (suu + svv) / count);
+  // RMS radial residual: penalizes any point straying off the fitted circle
+  // more sharply than a mean-absolute error, so an overdetermined fit exposes
+  // non-circular trajectories instead of averaging them away.
+  let squaredError = 0;
+  for (const point of points) {
+    const delta = Math.hypot(point.x - cx, point.y - cy) - radius;
+    squaredError += delta * delta;
+  }
+  return { cx, cy, radius, residual: Math.sqrt(squaredError / count) };
+}
+
+/** A dial hub that is present for a SUSTAINED majority of the sampled window,
+ * not just the final frame — a transient single-frame hub is not a reliable
+ * anchor. The representative center is the median across the frames that carry
+ * one, so a stray frame can't yank it. */
+const INDICATOR_MIN_HUB_PRESENCE_FRACTION = 0.6;
+
+interface ResolvedHub {
+  hx: number;
+  hy: number;
+}
+
+function resolveHub(group: OffPivotRotationSample[]): ResolvedHub | null {
+  const present = group.filter(
+    (s) => s.hx !== null && s.hy !== null && s.hubCount >= INDICATOR_MIN_HUB_CIRCLES,
+  );
+  if (present.length < INDICATOR_MIN_HUB_PRESENCE_FRACTION * group.length) return null;
+  const hx = median(present.map((s) => s.hx as number));
+  const hy = median(present.map((s) => s.hy as number));
+  return { hx, hy };
+}
+
+/** Rigid-body guard: a rotation preserves the figure's shape, so the distance
+ * between the two tracked material points stays ~constant. Arbitrary endpoint
+ * deformation (morphing, stretching) changes it — reject so it isn't misread as
+ * an off-hub orbit. */
+function isRigidBody(group: OffPivotRotationSample[]): boolean {
+  const lengths = group.map((s) => s.len).filter((len) => len > 0);
+  if (lengths.length < group.length) return false;
+  const mid = median(lengths);
+  if (mid <= 0) return false;
+  const spread = Math.max(...lengths) - Math.min(...lengths);
+  return spread <= INDICATOR_MAX_RIGID_LEN_VARIATION * mid;
+}
+
+/** Recover the center-of-rotation from whichever major-axis endpoint traces the
+ * larger orbit (more movement → more numerically stable), rejecting scattered
+ * fits. The fit is OVERDETERMINED (>=INDICATOR_MIN_SAMPLES points) so a high RMS
+ * residual genuinely means the trajectory is not one circle. */
+function recoverPivot(group: OffPivotRotationSample[]): CircleFit | null {
+  if (group.length < INDICATOR_MIN_SAMPLES) return null;
+  const endpointA = group.map((s) => ({ x: s.ax, y: s.ay }));
+  const endpointB = group.map((s) => ({ x: s.bx, y: s.by }));
+  const fits = [fitCircle(endpointA), fitCircle(endpointB)].filter(
+    (fit): fit is CircleFit => fit !== null,
+  );
+  if (fits.length === 0) return null;
+  // Scoped-known blind spot: we keep the wider-radius endpoint fit and, if it
+  // fails the residual gate below, return null rather than falling back to the
+  // narrower fit. Deliberately conservative — a missed pointer (false negative)
+  // over threading both fits and risking a spurious pivot on a noisy arc.
+  const best = fits.reduce((widest, fit) => (fit.radius > widest.radius ? fit : widest));
+  if (best.radius <= 0) return null;
+  if (best.residual > INDICATOR_MAX_FIT_RESIDUAL_FRACTION * best.radius) return null;
+  return best;
+}
+
+/** An off-pivot sample with its frame time reattached for grouping/annotation.
+ * The wire shape ({@link OffPivotFrame}) hoists time to the frame; the detector
+ * flattens back to timed samples so the last frame's time anchors the finding. */
+type TimedIndicatorSample = OffPivotRotationSample & { time: number };
+
+function offPivotRotationFinding(
+  group: TimedIndicatorSample[],
+  drift: number,
+): AnchoredLayoutIssue | null {
+  const last = group[group.length - 1];
+  if (!last) return null;
+  const rect: LayoutRect = {
+    left: Math.min(last.ax, last.bx) - 4,
+    top: Math.min(last.ay, last.by) - 4,
+    right: Math.max(last.ax, last.bx) + 4,
+    bottom: Math.max(last.ay, last.by) + 4,
+    width: Math.abs(last.bx - last.ax) + 8,
+    height: Math.abs(last.by - last.ay) + 8,
+  };
+  return {
+    code: "off_pivot_rotation",
+    severity: "warning",
+    time: last.time,
+    selector: last.selector,
+    dataAttributes: {},
+    sourceFile: "index.html",
+    bbox: rectToBbox(rect),
+    rect,
+    message: `Gauge/dial pointer rotates about a point ${Math.round(drift)}px from the dial hub — its center-of-rotation is off the hub, so it points wrong or overshoots the track (check the rotating group's pivot: translate to the hub before rotate, or set svgOrigin/transform-origin to the hub).`,
+    fixHint:
+      "The pointer's center-of-rotation must coincide with the dial hub. Rotate the group about the hub (e.g. transform-origin/svgOrigin set to the hub center, or translate the group so its rotation pivot lands on the hub) rather than about the element's own bbox center.",
+  };
+}
+
+/**
+ * off_pivot_rotation: a gauge needle / clock hand / radar sweep / dial pointer
+ * that rotates about the WRONG pivot — its center-of-rotation is far from the
+ * dial's hub, so the pointer aims wrong, runs off the track, or leaves the canvas.
+ *
+ * This is a HUB-REFERENCED check by necessity: a correctly-swept needle's bbox
+ * center orbits identically to a broken one (the pivot sits at the needle's
+ * base/edge either way), so no element-intrinsic measure separates them. The
+ * browser sampler records two fixed MATERIAL points on the pointer per frame; a
+ * circle fit recovers the true center-of-rotation, which is then compared to the
+ * dial's static hub (the screen point shared by the most non-rotating circles).
+ *
+ * FP guards are strict and STRUCTURAL (evaluated across the whole sampled
+ * window, not a single frame): requires real sweep (angle varies), a hub present
+ * for a sustained majority of frames (≥2 concentric static circles), a
+ * rigid-body trajectory (the two tracked points keep a constant separation), an
+ * OVERDETERMINED circle fit (≥5 samples, low RMS residual), and drift exceeding a
+ * fraction of the pointer's own length. When no sustained hub reference resolves
+ * it does not fire, so a lone decorative rotator can't trip it.
+ */
+interface IndicatorCandidate {
+  hubKey: string;
+  angleAboutHub: number;
+  drift: number;
+  length: number;
+  finding: AnchoredLayoutIssue | null;
+}
+
+/** Distinct angular positions about the hub among a set of candidates (nested
+ * blade parts share one angle; orbiting bodies spread to several). Exported for
+ * direct unit coverage of the multi-body/orbit-atom suppression guard. */
+export function countAngularBodies(angles: number[]): number {
+  const clusters: number[] = [];
+  for (const angle of angles) {
+    if (
+      !clusters.some((rep) => Math.min(Math.abs(angle - rep), 360 - Math.abs(angle - rep)) <= 25)
+    ) {
+      clusters.push(angle);
+    }
+  }
+  return clusters.length;
+}
+
+/** The pointer's angular position about the resolved hub, averaged across the
+ * window so the multi-body clustering compares a stable per-body angle rather
+ * than a single-frame snapshot. */
+function angleAboutHub(group: OffPivotRotationSample[], hub: ResolvedHub): number {
+  const midX = median(group.map((s) => (s.ax + s.bx) / 2));
+  const midY = median(group.map((s) => (s.ay + s.by) / 2));
+  return (Math.atan2(midY - hub.hy, midX - hub.hx) * 180) / Math.PI;
+}
+
+/** Gate one element's samples into a candidate, applying every structural FP
+ * guard. Returns null when the element is not an off-pivot-able dial pointer. */
+function buildIndicatorCandidate(group: TimedIndicatorSample[]): IndicatorCandidate | null {
+  if (group.length < INDICATOR_MIN_SAMPLES) return null;
+  if (maxAngleSpread(group.map((s) => s.angle)) <= INDICATOR_MIN_ANGLE_SPREAD_DEG) return null;
+  const hub = resolveHub(group);
+  if (!hub) return null;
+  if (!isRigidBody(group)) return null;
+  const pivot = recoverPivot(group);
+  if (!pivot) return null;
+  const drift = Math.hypot(pivot.cx - hub.hx, pivot.cy - hub.hy);
+  const length = median(group.map((s) => s.len));
+  const eligible = drift > INDICATOR_DRIFT_LENGTH_FRACTION * length;
+  return {
+    // Scoped-known blind spot: hubs bucketed by rounded screen coords, so two
+    // separate dials whose screen hubs land in the same 5px bucket merge into
+    // one multi-body group (rare — distinct dials stacked at ~identical screen
+    // position). Key by owning <svg> identity if that pattern shows up.
+    hubKey: `${Math.round(hub.hx / 5)}:${Math.round(hub.hy / 5)}`,
+    angleAboutHub: angleAboutHub(group, hub),
+    drift,
+    length,
+    finding: eligible ? offPivotRotationFinding(group, drift) : null,
+  };
+}
+
+/** Per hub: multiple bodies at distinct angular positions = an orbit/atom/radial
+ * system, not a single dial pointer — suppress. A real pointer (group + nested
+ * blades) collapses to one angular cluster. Otherwise emit one finding per hub,
+ * keeping the longest pointer. */
+function selectHubFindings(candidates: IndicatorCandidate[]): AnchoredLayoutIssue[] {
+  const byHub = groupBy(candidates, (candidate) => candidate.hubKey);
+  const findings: AnchoredLayoutIssue[] = [];
+  for (const group of byHub.values()) {
+    // Count angular bodies only over ELIGIBLE (off-pivot) candidates. Sibling
+    // hands that are correctly hubbed (finding === null) are not orbiting
+    // bodies, so counting them would falsely suppress a lone off-pivot hand on
+    // a multi-hand clock/dial whose other hands pivot correctly.
+    const eligible = group.filter((c) => c.finding !== null);
+    if (countAngularBodies(eligible.map((c) => c.angleAboutHub)) >= 2) continue;
+    const best = group
+      .filter((c) => c.finding !== null)
+      .reduce<IndicatorCandidate | null>(
+        (max, c) => (!max || c.length > max.length ? c : max),
+        null,
+      );
+    if (best?.finding) findings.push(best.finding);
+  }
+  return findings;
+}
+
+export function detectOffPivotRotation(frames: OffPivotFrame[]): AnchoredLayoutIssue[] {
+  const timed: TimedIndicatorSample[] = frames.flatMap((frame) =>
+    frame.samples.map((sample) => ({ ...sample, time: frame.time })),
+  );
+  const candidates: IndicatorCandidate[] = [];
+  for (const group of groupBySelector(timed).values()) {
+    const candidate = buildIndicatorCandidate(group);
+    if (candidate) candidates.push(candidate);
+  }
+  return selectHubFindings(candidates);
+}
+
 /** Error-severity findings with real geometry become labeled overview boxes.
  * Contrast failures are annotated separately by the driver itself, since
  * they're only known once contrast measurement for this sample completes. */
@@ -679,6 +984,7 @@ export async function runAuditGrid(
     collected.rotationSamples,
     await driver.getCanvas(),
   );
+  const offPivotFindings = detectOffPivotRotation(collected.indicatorFrames);
   const contrast = buildContrastResults(collected.contrastEntries);
   return {
     duration: grid.duration,
@@ -686,7 +992,12 @@ export async function runAuditGrid(
     transitionSamples: grid.transitionSamples,
     transitionSamplesDropped: grid.transitionSamplesDropped,
     runtimeFindings: [],
-    layoutIssues: [...collected.layoutIssues, ...sweepFindings, ...rotationFindings],
+    layoutIssues: [
+      ...collected.layoutIssues,
+      ...sweepFindings,
+      ...rotationFindings,
+      ...offPivotFindings,
+    ],
     motionIssues,
     motionSampleCount: collected.motionFrames.length,
     contrastSamples: grid.contrastSamples,
diff --git a/packages/cli/src/utils/checkTypes.ts b/packages/cli/src/utils/checkTypes.ts
index d04554d7d2..569051724a 100644
--- a/packages/cli/src/utils/checkTypes.ts
+++ b/packages/cli/src/utils/checkTypes.ts
@@ -133,6 +133,34 @@ export interface RotationSample {
   angle: number;
 }
 
+/** One elongated rotating SVG figure's material geometry at a single seeked
+ * sample, produced by `__hyperframesOffPivotRotationSample`. `(ax,ay)`/`(bx,by)` are
+ * two fixed material points on the figure (major-axis endpoints) mapped to
+ * screen space, so their cross-frame trajectory recovers the true center of
+ * rotation; `(hx,hy)` is the dial's static hub and `hr` its radius. The sample
+ * time is hoisted to the enclosing {@link OffPivotFrame}, not repeated here. */
+export interface OffPivotRotationSample {
+  selector: string;
+  ax: number;
+  ay: number;
+  bx: number;
+  by: number;
+  len: number;
+  angle: number;
+  hx: number | null;
+  hy: number | null;
+  hr: number | null;
+  hubCount: number;
+}
+
+/** All elongated rotating figures at one seeked sample. Time is hoisted to the
+ * frame (matching {@link ConnectorFrame}) so the per-figure samples don't repeat
+ * it; frames are accumulated across the grid to detect off_pivot_rotation. */
+export interface OffPivotFrame {
+  time: number;
+  samples: OffPivotRotationSample[];
+}
+
 export type MotionSpecResolution =
   | { kind: "none" }
   | { kind: "valid"; path: string; spec: MotionSpec }
@@ -153,6 +181,10 @@ export interface CheckAuditDriver {
   /** rotation_pivot_drift: every rotatable element's bbox center/size/angle at
    * the current seeked state. Accumulated across the grid — see checkPipeline. */
   collectRotationSample(time: number): Promise<RotationSample[]>;
+  /** off_pivot_rotation: every elongated rotating SVG figure's material-point
+   * geometry + resolved dial hub at the current seeked state, as a time-hoisted
+   * frame envelope. */
+  collectOffPivotRotationSample(time: number): Promise<OffPivotFrame>;
   collectGeometryCandidates(
     time: number,
     request: GeometryCandidateRequest,
diff --git a/packages/cli/src/utils/layoutAudit.ts b/packages/cli/src/utils/layoutAudit.ts
index e72df4f87d..678e1210c6 100644
--- a/packages/cli/src/utils/layoutAudit.ts
+++ b/packages/cli/src/utils/layoutAudit.ts
@@ -26,6 +26,9 @@ export type LayoutIssueCode =
   // Cross-sample rotation finding — a spinning element whose bbox center drifts
   // because it pivots about the wrong point (bad transformOrigin/svgOrigin).
   | "rotation_pivot_drift"
+  // Hub-referenced rotation finding — a gauge/clock/radar pointer whose recovered
+  // center-of-rotation sits far from the dial's static hub (wrong pivot point).
+  | "off_pivot_rotation"
   // Frozen-sweep guard (#U10) — a whole-run meta-finding, not a per-sample
   // geometry observation; never persistence-tiered (see `applyPersistenceTier`).
   | "sweep_static"

From 4582881d002c361afff59cc1c74ae072a50e17f7 Mon Sep 17 00:00:00 2001
From: ukimsanov <ular.kimsanov@heygen.com>
Date: Thu, 23 Jul 2026 21:26:39 -0700
Subject: [PATCH 052/125] feat(cli): add agent-first media treatment tools

---
 docs/guides/color-grading.mdx                 | 166 +++-
 packages/cli/src/cli.commands.test.ts         |   6 +
 packages/cli/src/cli.ts                       |   2 +
 .../cli/src/commands/coreSkillContent.test.ts |  53 +
 .../cli/src/commands/media-treatment.test.ts  | 271 +++++
 packages/cli/src/commands/media-treatment.ts  | 537 ++++++++++
 packages/cli/src/help.ts                      |   4 +
 packages/cli/src/templates/_shared/AGENTS.md  |   2 +
 packages/cli/src/templates/_shared/CLAUDE.md  |   2 +
 packages/core/src/colorGrading.ts             | 123 +++
 skills-manifest.json                          |  10 +-
 skills/general-video/SKILL.md                 |   2 +-
 .../references/compare-and-batch.md           |   2 +-
 skills/hyperframes/SKILL.md                   |  10 +
 .../hyperframes/references/capability-menu.md |  34 +-
 skills/media-use/SKILL.md                     |  76 +-
 skills/media-use/references/grading.md        |  96 +-
 .../references/media-treatment-recipes.md     | 929 ++++++++++++++++++
 .../media-use/references/media-treatments.md  | 199 ++++
 skills/media-use/references/operations.md     |  34 +
 skills/media-use/scripts/dither.mjs           | 328 +++++++
 skills/media-use/scripts/dither.test.mjs      | 175 ++++
 .../media-use/scripts/lib/error-diffusion.mjs | 230 +++++
 .../scripts/lib/error-diffusion.test.mjs      | 102 ++
 .../scripts/lib/lut-preset-provider.mjs       |  16 +-
 .../scripts/lib/lut-preset-provider.test.mjs  |   5 +
 skills/media-use/scripts/resolve.mjs          |  22 +
 skills/media-use/scripts/resolve.test.mjs     |  28 +
 28 files changed, 3402 insertions(+), 62 deletions(-)
 create mode 100644 packages/cli/src/commands/media-treatment.test.ts
 create mode 100644 packages/cli/src/commands/media-treatment.ts
 create mode 100644 skills/media-use/references/media-treatment-recipes.md
 create mode 100644 skills/media-use/references/media-treatments.md
 create mode 100644 skills/media-use/scripts/dither.mjs
 create mode 100644 skills/media-use/scripts/dither.test.mjs
 create mode 100644 skills/media-use/scripts/lib/error-diffusion.mjs
 create mode 100644 skills/media-use/scripts/lib/error-diffusion.test.mjs

diff --git a/docs/guides/color-grading.mdx b/docs/guides/color-grading.mdx
index 0af9e45a01..6961d959ff 100644
--- a/docs/guides/color-grading.mdx
+++ b/docs/guides/color-grading.mdx
@@ -1,6 +1,6 @@
 ---
 title: Color Grading
-description: "Apply real-time color grading, presets, LUTs, vignette, grain, blur, and pixelate to video and image media in Studio and final renders."
+description: "Apply real-time color grading, presets, LUTs, finishing, and media effects to video and image media in Studio and final renders."
 ---
 
 HyperFrames Studio can color grade project-local `<video>` and `<img>` media directly in the preview. The same `data-color-grading` settings are used by the render pipeline, so the exported video should match the look you preview.
@@ -15,8 +15,9 @@ This is a lightweight media color tool for generated videos, uploaded footage, s
 | Manual controls | Supported | Exposure, contrast, highlights, shadows, white point, black point, warmth, tint, vibrance, saturation. |
 | Presets | Supported | Named HyperFrames presets backed by shader settings, not bundled third-party LUT packs. |
 | Custom LUT upload | Supported | Project-local 3D `.cube` LUT files with strength control. |
-| Finishing | Supported | Vignette and grain, with advanced settings behind the settings icon. |
-| Effects | Supported | Blur and pixelate on the selected media surface. |
+| Finish | Supported | Vignette and grain, with advanced settings behind the settings icon. |
+| Studio Effects panel | Supported | Essentials, Retro & Glitch, Print, and Art effects share the same media shader and persisted `effects` object. |
+| Studio Overlays panel | Supported | Inserts selected Registry overlays at the media timing as ordinary timeline layers. |
 | Before preview | Supported | Hold the compare button to temporarily show the ungraded media. |
 | Render parity | Supported | The render pipeline redraws the color-grading shader after video-frame injection. |
 
@@ -36,6 +37,7 @@ Studio labels `whites`, `blacks`, and `temperature` as White Point, Black Point,
 | Rec.709 creative LUTs | Yes | Best LUT path today. Use project-local 3D `.cube` files. |
 | Camera conversion LUTs | Partial | Technically accepted if they are supported 3D `.cube` files, but correctness depends on the source footage matching the LUT's expected input color space. |
 | Full-scene grading including text/DOM | Not yet | Color Grading is media-only. Captions, text, SVG, and regular DOM overlays stay unchanged. |
+| Face/region-only grading or privacy | Not yet | Realtime effects process the whole selected `<img>` or `<video>`. Isolate the region into a separate cropped/masked media layer or use an external segmentation/tracking tool first. |
 | Remote media URLs | Partial | WebGL pixel processing requires compatible CORS headers. Project-local assets are the reliable path. |
 | Professional ACES/OCIO/HDR finishing | Not yet | Future render/color-management work, not this Studio shader path. |
 
@@ -70,8 +72,24 @@ Color grading is stored on media elements as `data-color-grading`:
       "grainRoughness":0.55
     },
     "effects":{
-      "blur":0.08
+      "blur":0.08,
+      "chromaBleed":0,
+      "tapeDamage":0,
+      "tapeTracking":0,
+      "tapeNoise":1,
+      "tapeSpeed":0.5,
+      "filmArtifacts":0,
+      "halftone":0,
+      "halftoneSize":0,
+      "twoInkPrint":0,
+      "twoInkPrintSize":0,
+      "ascii":0,
+      "asciiSize":0.066,
+      "asciiInvert":0,
+      "dither":0,
+      "ditherSize":0.25
     },
+    "palette":["#0b0d0d","#eee9db"],
     "colorSpace":"rec709"
   }'
 ></video>
@@ -79,6 +97,26 @@ Color grading is stored on media elements as `data-color-grading`:
 
 The runtime creates a sibling WebGL canvas for the media element, samples the current video or image frame, applies shader uniforms, then hides the native media only after a shader frame is ready.
 
+## Studio Workflow
+
+Select a real `<img>` or `<video>` element in Studio to open the media tools:
+
+1. **Presets** shows every built-in starting point in a responsive preview
+   grid. Hover to preview it on the selected media, click to apply it, or choose
+   **Original** to return to the neutral preset.
+2. **Adjust** provides tonal and color correction.
+3. **Effects** groups configurable shader controls under Essentials, Retro &
+   Glitch, Print, and Art.
+4. **Finish** provides vignette and grain.
+5. **Custom LUT** accepts a project-local 3D `.cube` file.
+6. **Overlays** installs Camcorder HUD, Editorial Flash, Organic Light Leak,
+   or Freeze-Frame Cutout from the existing Registry.
+
+An overlay inserted from this panel starts with the selected media, uses its
+duration, and is placed on the next visual track when one is known. It then
+behaves like any other composition layer: edit or remove it through Layers and
+Timeline. The left Catalog remains the browse-all Registry surface.
+
 <Note>
 Color Grading is intentionally **media-only**. It applies to `<video>` and `<img>` sources. Captions, text, divs, SVG, and UI graphics remain ungraded unless you render them into media first.
 </Note>
@@ -116,8 +154,24 @@ Project-local media is the safest path. Remote media must be served with compati
   },
   "effects": {
     "blur": 0,
-    "pixelate": 0
+    "pixelate": 0,
+    "chromaBleed": 0,
+    "tapeDamage": 0,
+    "tapeTracking": 0,
+    "tapeNoise": 1,
+    "tapeSpeed": 0.5,
+    "filmArtifacts": 0,
+    "halftone": 0,
+    "halftoneSize": 0,
+    "twoInkPrint": 0,
+    "twoInkPrintSize": 0,
+    "ascii": 0,
+    "asciiSize": 0.066,
+    "asciiInvert": 0,
+    "dither": 0,
+    "ditherSize": 0.25
   },
+  "palette": ["#0b0d0d", "#eee9db"],
   "lut": {
     "src": "assets/luts/look.cube",
     "intensity": 0.75
@@ -128,6 +182,88 @@ Project-local media is the safest path. Remote media must be served with compati
 
 Omit `enabled`; the presence of `data-color-grading` implies that grading is active. All numeric controls are clamped by the runtime. The current color grading path is Rec.709/sRGB-oriented and assumes browser-decoded media frames.
 
+`chromaBleed` is a bounded `0` to `1` treatment primitive that horizontally
+softens chroma detail while preserving the center sample's luma. It is useful
+inside restrained creator-camera/camcorder treatments; it is not VHS, CRT, RGB
+split, tracking noise, or a complete camera emulation.
+
+Most effect amounts and settings are normalized from `0` to `1`. Bloom supports
+up to `3`, bloom radius uses pixels, and enum controls use the integer choices
+shown in Studio:
+
+- `tapeDamage` adds deterministic horizontal time-base instability, lower luma
+  bandwidth, restrained ghosting, noise, sparse dropouts, and bottom-edge head
+  switching. `tapeTracking` adds bounded moving horizontal tracking tears,
+  `tapeNoise` scales tape noise and row jitter, and `tapeSpeed` controls their
+  deterministic motion (`0.5` is normal speed). These three subordinate
+  controls do nothing without `tapeDamage`. A complete analog-tape treatment
+  may also use restrained `chromaBleed`, scanlines, RGB separation, and rare
+  row tears; none of these controls adds CRT curvature.
+- `filmArtifacts` adds deterministic sparse dust and short scratches. Combine
+  it with existing grain, vignette, color, and seek-safe GSAP gate weave for an
+  8mm treatment. It does not change the frame by itself when set to `0`.
+- `halftone` blends in a four-angle CMYK print screen. `halftoneSize` controls
+  its resolution-aware dot-cell size from fine to coarse. The channel angles
+  and edge response use fixed print-oriented defaults to keep authored output
+  consistent across agents.
+- `twoInkPrint` maps warm midtones and deep/cool shadows to fixed original
+  vermilion and teal spot screens with a dark overprint on warm paper.
+  `twoInkPrintSize` controls its resolution-aware screen size. Do not combine
+  it with `halftone` or describe it as a named commercial print process.
+- `ascii` converts the selected media to a procedural 5x7 glyph field.
+  `asciiSize` controls cell size and `asciiInvert` switches the light/dark ink
+  polarity. It uses the first and last colors from `palette`.
+- `dither` applies a temporally stable ordered 4x4 Bayer dither.
+  `ditherSize` controls cell size and all `palette` colors participate in the
+  result. This is ordered dithering, not Floyd-Steinberg or another sequential
+  error-diffusion algorithm.
+- `bloom` extracts bright pixels and runs a bounded half-resolution separable
+  blur. `bloomRadius` controls its radius.
+- `monoScreen` provides configurable mono print shapes, angle, spread, invert,
+  and palette controls.
+- `scanlines`, `crtCurvature`, and `chromaticAberration` provide display
+  geometry and channel treatments with their related settings.
+- `digitalGlitch` provides deterministic line tears, blocks, displacement,
+  selective pixelation, channel split, opacity, and speed controls.
+- `engraving`, `crosshatch`, and `kuwahara` provide stylized art treatments with
+  their calibrated settings. Kuwahara uses bounded half-float intermediate
+  targets when the browser supports them and otherwise reports unavailable.
+
+`palette` accepts two to six exact `#RRGGBB` colors in authored order. Use
+dark-to-light order for normal luminance mapping; intentionally reverse the
+array for an inverted result. The runtime validates and lowercases colors but
+does not reorder them. ASCII, dither, mono screen, engraving, and crosshatch use
+it; a palette or subordinate setting alone does not allocate an effect. Omit it
+for the family default.
+
+When effects are combined, HyperFrames evaluates them in one fixed,
+deterministic order: source framing and multipass blur/Kuwahara preparation;
+chromatic and digital glitch; primary color grading and LUT blended by global
+intensity; grain and film
+artifacts; mono/engraving/crosshatch/halftone/two-ink/dither/ASCII; bloom,
+scanlines, vignette, and CRT display masking; then before/after comparison.
+Effects cannot currently be reordered. The fixed
+pipeline keeps Studio, playback, seeking, and final render behavior
+predictable.
+
+Studio exposes these controls in the selected media element's **Effects**
+accordion. Agents should choose one primary intent through the `media-use`
+skill, then either seed from a source-aware treatment recipe or inspect the
+canonical toolbox and assemble a bespoke combination:
+
+```bash
+hyperframes media-treatment --capabilities --json
+hyperframes media-treatment --capability kuwahara --json
+```
+
+The first command reports a concise overview of every capability family. The
+focused query reports one family's or effect's controls, calibrated apply
+payload, render lane, palette support, and seek-safe animation paths. Use
+`--all` only for exhaustive tooling. Recipes are tested shortcuts, not the
+complete allowed surface. Persist the final combined payload with the same
+`hyperframes media-treatment` command; unknown keys are rejected before the
+composition is changed.
+
 ## Custom LUTs
 
 HyperFrames supports project-local 3D `.cube` LUT files:
@@ -157,6 +293,15 @@ Color Grading is part of the media runtime, so render uses the same settings as
 
 For 4K output, use the existing [4K Rendering](/guides/4k-rendering) workflow. Color Grading can run at 4K when the composition/render surface is 4K, but a 1080p source video does not become sharper just because the final render is 4K.
 
+Performance follows the total number of treated pixels and the selected render
+lane, not only the number of media elements. Several tiled videos can be
+cheaper than several overlapping full-frame videos. Blur, Bloom, and Kuwahara
+use multipass rendering. When more than two full-frame multipass-treated media
+elements are visible together, verify continuous playback on the target
+machine and simplify or pre-render the stack if frames drop. HyperFrames does
+not impose a universal hard cap because GPU and decoder capacity varies by
+device.
+
 For HDR output, use the existing [HDR Rendering](/guides/hdr) workflow. Color Grading currently warns on detected HDR media, but the grading controls themselves are not HDR-aware.
 
 When grading a video, animate opacity on a wrapper element instead of directly on the `<video>` element. The runtime hides the native media and draws the graded result through a sibling canvas, so wrapper opacity preserves preview/render parity.
@@ -168,7 +313,16 @@ When grading a video, animate opacity on a wrapper element instead of directly o
 | Make uploaded footage look cleaner | Color Grading preset + adjust controls |
 | Use a look from another editor | Custom 3D `.cube` LUT |
 | Add polish to a product shot | Vignette, subtle grain, contrast, vibrance |
-| Blur or pixelate selected media | Effects inside Color Grading |
+| Blur or pixelate selected media | Effects panel |
+| Add restrained camcorder chroma softness | Effects panel or `effects.chromaBleed` through an agent |
+| Build an analog VHS treatment | `effects.tapeDamage` + bounded tracking/noise/speed + restrained chroma, scanline, row-tear, grain, and color settings |
+| Build an 8mm home-movie treatment | `effects.filmArtifacts` + grain/vignette/color + seek-safe GSAP weave |
+| Build a print/editorial treatment | `effects.halftone` + `effects.halftoneSize` |
+| Build a two-spot editorial print | `effects.twoInkPrint` + `effects.twoInkPrintSize` |
+| Build a terminal/editorial character treatment | `effects.ascii` + `effects.asciiSize` + an optional two-color `palette` |
+| Build a restrained multi-color pixel treatment | `effects.dither` + `effects.ditherSize` + a two-to-six-color `palette` |
+| Add an organic light leak | Install the finite `organic-light-leak-overlay` Registry block |
+| Build a freeze-frame cutout | Existing background removal + the `freeze-frame-cutout` Registry overlay block + host GSAP |
 | Make a presenter float over graphics | Existing [Remove Background](/guides/remove-background) workflow |
 | Put text behind a presenter | Existing `remove-background --background-output` workflow |
 | Render HDR delivery files | Existing [HDR Rendering](/guides/hdr) workflow |
diff --git a/packages/cli/src/cli.commands.test.ts b/packages/cli/src/cli.commands.test.ts
index a88ef016ef..dc45671e04 100644
--- a/packages/cli/src/cli.commands.test.ts
+++ b/packages/cli/src/cli.commands.test.ts
@@ -35,6 +35,12 @@ describe("CLI command registration", () => {
     );
   });
 
+  it("registers media-treatment as the only treatment authoring command", () => {
+    const loaders = commandLoaderBlock();
+    expect(loaders).toContain('"media-treatment"');
+    expect(loaders).not.toContain('"color-grading"');
+  });
+
   // A command actively reconciling skills (`skills check`/`skills update`)
   // must not also nudge the user to go reconcile skills — that nudge is
   // either redundant (it just ran) or misleading (a stale cached count from
diff --git a/packages/cli/src/cli.ts b/packages/cli/src/cli.ts
index e36e83ed25..fee96cf13e 100644
--- a/packages/cli/src/cli.ts
+++ b/packages/cli/src/cli.ts
@@ -152,6 +152,8 @@ const commandLoaders = {
   events: () => import("./commands/events.js").then((m) => m.default),
   validate: () => import("./commands/validate.js").then((m) => m.default),
   snapshot: () => import("./commands/snapshot.js").then((m) => m.default),
+  "media-treatment": () =>
+    import("./commands/media-treatment.js").then((m) => m.mediaTreatmentCommand),
   "grade-compare": () => import("./commands/grade-compare.js").then((m) => m.default),
   compare: () => import("./commands/compare.js").then((m) => m.default),
   capture: () => import("./commands/capture.js").then((m) => m.default),
diff --git a/packages/cli/src/commands/coreSkillContent.test.ts b/packages/cli/src/commands/coreSkillContent.test.ts
index 6dd75d6441..fe25f5764d 100644
--- a/packages/cli/src/commands/coreSkillContent.test.ts
+++ b/packages/cli/src/commands/coreSkillContent.test.ts
@@ -73,3 +73,56 @@ describe("media-use TTS documentation", () => {
     expect(captions).toContain("heygen-tts.mjs");
   });
 });
+
+describe("media treatment routing documentation", () => {
+  it("routes vague composition-media feedback to the canonical workflow", () => {
+    const router = read("skills", "hyperframes", "SKILL.md");
+    const mediaUse = read("skills", "media-use", "SKILL.md");
+    const treatments = read("skills", "media-use", "references", "media-treatments.md");
+
+    expect(router).toContain("dark/flat/boring footage");
+    expect(router).toContain("`/media-use`");
+    expect(mediaUse).toContain("references/media-treatments.md");
+    expect(mediaUse).toContain("`hyperframes media-treatment`");
+    expect(treatments).toContain("Persist pixel settings with `hyperframes media-treatment`");
+    expect(treatments).toContain("apply to the entire selected real `<img>` or");
+    expect(treatments).toContain("external segmentation/tracking tool");
+  });
+
+  it("keeps discovery progressive and verification visual", () => {
+    const treatments = read("skills", "media-use", "references", "media-treatments.md");
+    const recipes = read("skills", "media-use", "references", "media-treatment-recipes.md");
+
+    expect(treatments).toContain("hyperframes media-treatment --capabilities --json");
+    expect(treatments).toContain("--capability <id>");
+    expect(treatments).toContain("Recipes are optional macros");
+    expect(recipes).toContain("optional tested seeds");
+    expect(treatments).toContain("hyperframes add <name> --dir <project>");
+    expect(treatments).toContain("snapshots/treatment-before/contact-sheet.jpg");
+    expect(treatments).toMatch(/Do not report visual\s+quality from command success alone/);
+  });
+
+  it("indexes calibrated treatment recipes without making them mandatory", () => {
+    const treatments = read("skills", "media-use", "references", "media-treatments.md");
+    const recipes = read("skills", "media-use", "references", "media-treatment-recipes.md");
+
+    for (const heading of [
+      "Monochrome Screen Print",
+      "Engraved Illustration",
+      "Crosshatched Sketch",
+      "CRT Display",
+    ]) {
+      expect(treatments).toContain(`\`${heading}\``);
+      expect(recipes).toContain(`## ${heading}`);
+    }
+  });
+
+  it("places the media-treatment discovery gate in new project instructions", () => {
+    for (const file of ["AGENTS.md", "CLAUDE.md"]) {
+      const template = read("packages", "cli", "src", "templates", "_shared", file);
+      expect(template).toContain("Changing how real footage or images look or reveal?");
+      expect(template).toContain("Load `/media-use`");
+      expect(template).toContain("do not improvise equivalent CSS/SVG filters or overlays");
+    }
+  });
+});
diff --git a/packages/cli/src/commands/media-treatment.test.ts b/packages/cli/src/commands/media-treatment.test.ts
new file mode 100644
index 0000000000..e302b32892
--- /dev/null
+++ b/packages/cli/src/commands/media-treatment.test.ts
@@ -0,0 +1,271 @@
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { runCommand } from "citty";
+import { describe, expect, it, vi } from "vitest";
+import {
+  HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS,
+  getHfColorGradingCapabilities,
+} from "@hyperframes/core";
+import {
+  applyMediaTreatmentToHtml,
+  getMediaTreatmentCapabilityDetail,
+  getMediaTreatmentCapabilityOverview,
+  mediaTreatmentCommand,
+} from "./media-treatment.js";
+import { CliRuntimeError } from "../utils/commandResult.js";
+
+const VIDEO = `<!doctype html><html><body><video id="hero" src="hero.mp4"></video></body></html>`;
+
+describe("applyMediaTreatmentToHtml", () => {
+  it("provides a concise first-hop overview of the complete treatment surface", () => {
+    const overview = getMediaTreatmentCapabilityOverview();
+
+    expect(overview.families.find(({ id }) => id === "correction")).not.toHaveProperty("items");
+    expect(overview.families.find(({ id }) => id === "art")).not.toHaveProperty("items");
+    expect(overview.families.find(({ id }) => id === "overlays")).toMatchObject({
+      owner: "registry",
+    });
+    expect(overview.families.some(({ id }) => id === "looks" || id === "treatments")).toBe(false);
+    const discoveredEffects = ["essentials", "retro-glitch", "print", "art"].flatMap((family) => {
+      const detail = getMediaTreatmentCapabilityDetail(family);
+      return (
+        typeof detail === "object" &&
+        detail !== null &&
+        "effects" in detail &&
+        Array.isArray(detail.effects)
+          ? detail.effects
+          : []
+      ).map((effect) =>
+        typeof effect === "object" && effect && "id" in effect ? effect.id : null,
+      );
+    });
+    expect(discoveredEffects.sort()).toEqual([...HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS].sort());
+    expect(JSON.stringify(overview).length).toBeLessThan(3_000);
+  });
+
+  it("returns focused controls and apply data for one capability", () => {
+    expect(getMediaTreatmentCapabilityDetail("kuwahara")).toMatchObject({
+      id: "kuwahara",
+      family: "art",
+      renderLane: "multipass",
+      apply: { effects: { kuwahara: 1 } },
+      animation: {
+        property: expect.objectContaining({ path: "effects.kuwahara" }),
+        initial: expect.stringContaining("--hf-color-grading-kuwahara"),
+        tween: expect.stringContaining("timeline.to"),
+      },
+    });
+    expect(getMediaTreatmentCapabilityDetail("retro-glitch")).toMatchObject({
+      id: "retro-glitch",
+      effects: expect.arrayContaining([expect.objectContaining({ id: "chromaBleed" })]),
+    });
+    expect(getMediaTreatmentCapabilityDetail("deep-sea")).toMatchObject({
+      id: "deep-sea",
+      apply: { palette: expect.arrayContaining(["#0a1628"]) },
+    });
+    expect(getMediaTreatmentCapabilityDetail("exposure")).toMatchObject({
+      id: "exposure",
+      family: "correction",
+      animation: {
+        property: expect.objectContaining({ path: "adjust.exposure" }),
+      },
+    });
+    expect(getMediaTreatmentCapabilityDetail("vignette")).toMatchObject({
+      id: "vignette",
+      family: "finishing",
+      control: expect.objectContaining({ key: "vignette" }),
+    });
+  });
+
+  it("rejects unknown capability lookups", () => {
+    expect(() => getMediaTreatmentCapabilityDetail("make-it-cinematic")).toThrow(
+      /Unknown media-treatment capability/,
+    );
+    expect(() => getMediaTreatmentCapabilityDetail("__proto__")).toThrow(
+      /Unknown media-treatment capability/,
+    );
+  });
+
+  it("exposes enough canonical metadata to assemble a custom treatment", () => {
+    const capabilities = getHfColorGradingCapabilities();
+
+    expect(capabilities.targetTags).toEqual(["img", "video"]);
+    expect(capabilities.effects.find(({ key }) => key === "kuwahara")?.apply).toMatchObject({
+      kuwahara: 1,
+      kuwaharaRadius: 1 / 7,
+    });
+    expect(capabilities.animatable.find(({ path }) => path === "effects.blur")?.name).toBe(
+      "--hf-color-grading-blur",
+    );
+  });
+
+  it("normalizes and persists a grading payload on real media", () => {
+    const result = applyMediaTreatmentToHtml(VIDEO, {
+      selector: "#hero",
+      grading: { preset: "warm-daylight", intensity: 0.8 },
+    });
+
+    expect(result.changed).toBe(true);
+    expect(result.tag).toBe("video");
+    expect(result.value).toContain('"preset":"warm-daylight"');
+    expect(result.value).toContain('"intensity":0.8');
+    expect(result.html).toContain("data-color-grading=");
+  });
+
+  it("merges a validated patch and reports the stored before and after payloads", () => {
+    const initial = applyMediaTreatmentToHtml(VIDEO, {
+      selector: "#hero",
+      grading: {
+        adjust: { exposure: 0.1 },
+        details: { grain: 0.2 },
+      },
+    });
+    const patched = applyMediaTreatmentToHtml(initial.html, {
+      selector: "#hero",
+      grading: { adjust: { shadows: 0.08 } },
+    });
+
+    expect(patched.before).toMatchObject({
+      adjust: { exposure: 0.1 },
+      details: { grain: 0.2 },
+    });
+    expect(patched.after).toMatchObject({
+      adjust: { exposure: 0.1, shadows: 0.08 },
+      details: { grain: 0.2 },
+    });
+
+    const repeated = applyMediaTreatmentToHtml(patched.html, {
+      selector: "#hero",
+      grading: { adjust: { shadows: 0.08 } },
+    });
+    expect(repeated.changed).toBe(false);
+    expect(repeated.html).toBe(patched.html);
+    expect(repeated.after).toEqual(repeated.before);
+  });
+
+  it("preserves unresolved variable references for runtime resolution", () => {
+    const wholeGrade = applyMediaTreatmentToHtml(VIDEO, {
+      selector: "#hero",
+      grading: "$interviewGrade",
+    });
+    expect(wholeGrade.value).toBe("$interviewGrade");
+
+    const nested = applyMediaTreatmentToHtml(VIDEO, {
+      selector: "#hero",
+      grading: { adjust: { exposure: "$interviewExposure" } },
+    });
+    expect(JSON.parse(nested.value ?? "{}")).toMatchObject({
+      adjust: { exposure: "$interviewExposure" },
+    });
+
+    const storedVariable = VIDEO.replace(" src=", ` data-color-grading="$interviewGrade" src=`);
+    expect(() =>
+      applyMediaTreatmentToHtml(storedVariable, {
+        selector: "#hero",
+        grading: { adjust: { exposure: 0.1 } },
+      }),
+    ).toThrow(/Cannot merge.*unresolved whole-grade variable/);
+  });
+
+  it("requires an unambiguous media target", () => {
+    const source = `<img class="media" src="a.png"><img class="media" src="b.png">`;
+    expect(() =>
+      applyMediaTreatmentToHtml(source, { selector: ".media", grading: { preset: "neutral" } }),
+    ).toThrow(/matched 2 elements/);
+
+    const result = applyMediaTreatmentToHtml(source, {
+      selector: ".media",
+      selectorIndex: 1,
+      grading: { preset: "warm-daylight" },
+    });
+    expect((result.html.match(/data-color-grading/g) ?? []).length).toBe(1);
+  });
+
+  it("persists grading inside composition templates", () => {
+    const source = `<template><video id="hero" src="hero.mp4"></video></template>`;
+    const result = applyMediaTreatmentToHtml(source, {
+      selector: "#hero",
+      grading: { preset: "warm-daylight" },
+    });
+
+    expect(result.changed).toBe(true);
+    expect(result.html).toContain("data-color-grading=");
+  });
+
+  it("rejects non-media elements", () => {
+    expect(() =>
+      applyMediaTreatmentToHtml(`<div id="hero"></div>`, {
+        selector: "#hero",
+        grading: { preset: "warm-daylight" },
+      }),
+    ).toThrow(/requires an <img> or <video>/);
+  });
+
+  it("rejects unknown keys instead of silently dropping agent mistakes", () => {
+    expect(() =>
+      applyMediaTreatmentToHtml(VIDEO, {
+        selector: "#hero",
+        grading: { adjustments: { exposure: -0.45 }, effects: { dither: 1 } },
+      }),
+    ).toThrow(/grading.*adjustments/i);
+
+    expect(() =>
+      applyMediaTreatmentToHtml(VIDEO, {
+        selector: "#hero",
+        grading: { effects: { dithering: 1 } },
+      }),
+    ).toThrow(/effects.*dithering/i);
+  });
+
+  it("requires --apply for --grading while keeping --clear explicit", async () => {
+    const project = mkdtempSync(join(tmpdir(), "hf-media-treatment-"));
+    const file = join(project, "index.html");
+    const grading = '{"adjust":{"exposure":0.1}}';
+    const log = vi.spyOn(console, "log").mockImplementation(() => undefined);
+    const error = vi.spyOn(console, "error").mockImplementation(() => undefined);
+    writeFileSync(file, VIDEO);
+
+    try {
+      await expect(
+        runCommand(mediaTreatmentCommand, {
+          rawArgs: ["--project", project, "--selector", "#hero", "--grading", grading],
+        }),
+      ).rejects.toThrow(CliRuntimeError);
+      expect(error).toHaveBeenLastCalledWith(expect.stringContaining("--grading requires --apply"));
+      expect(readFileSync(file, "utf8")).toBe(VIDEO);
+
+      await runCommand(mediaTreatmentCommand, {
+        rawArgs: ["--project", project, "--selector", "#hero", "--grading", grading, "--apply"],
+      });
+      expect(readFileSync(file, "utf8")).toContain("data-color-grading");
+
+      await runCommand(mediaTreatmentCommand, {
+        rawArgs: ["--project", project, "--selector", "#hero", "--clear"],
+      });
+      expect(readFileSync(file, "utf8")).not.toContain("data-color-grading");
+    } finally {
+      log.mockRestore();
+      error.mockRestore();
+      rmSync(project, { recursive: true, force: true });
+    }
+  });
+
+  it("clears both explicit and normalized no-op grading", () => {
+    const graded = VIDEO.replace(" src=", ` data-color-grading='{"preset":"warm-daylight"}' src=`);
+    expect(
+      applyMediaTreatmentToHtml(graded, { selector: "#hero", clear: true }).html,
+    ).not.toContain("data-color-grading");
+    expect(
+      applyMediaTreatmentToHtml(graded, { selector: "#hero", grading: { preset: "neutral" } }).html,
+    ).not.toContain("data-color-grading");
+  });
+
+  it("does not report or serialize a no-op clear because unrelated HTML formatting differs", () => {
+    const source = `<!doctype html><html><head><meta charset="utf-8" /></head><body><video id="hero" src="hero.mp4"></video></body></html>`;
+    const result = applyMediaTreatmentToHtml(source, { selector: "#hero", clear: true });
+
+    expect(result.changed).toBe(false);
+    expect(result.html).toBe(source);
+  });
+});
diff --git a/packages/cli/src/commands/media-treatment.ts b/packages/cli/src/commands/media-treatment.ts
new file mode 100644
index 0000000000..6ce2ecfb19
--- /dev/null
+++ b/packages/cli/src/commands/media-treatment.ts
@@ -0,0 +1,537 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { relative, resolve } from "node:path";
+import {
+  HF_COLOR_GRADING_ATTR,
+  getHfColorGradingCapabilities,
+  isHfColorGradingActive,
+  isPathInside,
+  normalizeHfColorGrading,
+  serializeHfColorGrading,
+} from "@hyperframes/core";
+import {
+  isColorGradingVariableRef,
+  validateColorGradingContract,
+} from "@hyperframes/parsers/color-grading-contract";
+import { patchElementInHtml } from "@hyperframes/studio-server/source-mutation";
+import { defineCommand } from "citty";
+import { parseHTML } from "linkedom";
+import type { Example } from "./_examples.js";
+import { c } from "../ui/colors.js";
+import { failCommand } from "../utils/commandResult.js";
+import { normalizeErrorMessage } from "../utils/errorMessage.js";
+import { readOptionalString } from "../utils/pathArgs.js";
+import { resolveProject } from "../utils/project.js";
+import { withMeta } from "../utils/updateCheck.js";
+
+export function getMediaTreatmentCapabilityOverview() {
+  const capabilities = getHfColorGradingCapabilities();
+  const family = (id: string, label: string, description: string) => ({
+    id,
+    label,
+    description,
+  });
+
+  return {
+    version: capabilities.version,
+    targetTags: capabilities.targetTags,
+    colorSpace: capabilities.colorSpace,
+    families: [
+      family("correction", "Adjust", "Fix exposure, tonal balance, color casts, and saturation."),
+      family(
+        "presets",
+        "Presets",
+        "Apply a tested starting point, then tune only when the source or intent requires it.",
+      ),
+      family("finishing", "Finish", "Shape vignette and deterministic film grain."),
+      ...capabilities.effectFamilies,
+      family(
+        "palettes",
+        "Palettes",
+        "Reusable two-to-six-color palettes for compatible art effects.",
+      ),
+      family(
+        "animation",
+        "Animation",
+        "Seek-safe CSS properties that registered GSAP timelines may animate.",
+      ),
+      family("lut", "Custom LUT", "Apply a user-owned 3D .cube LUT."),
+      {
+        id: "overlays",
+        label: "Overlays",
+        description: "Install authored HUD, light-leak, flash, or freeze-frame overlay blocks.",
+        owner: "registry",
+      },
+    ],
+    discovery: {
+      detail: "Use --capability <family-or-item> for exact controls and examples.",
+      full: "Use --all only for tooling or exhaustive inspection.",
+    },
+  };
+}
+
+export function getMediaTreatmentCapabilityDetail(id: string): unknown {
+  const capabilities = getHfColorGradingCapabilities();
+  const animation = (path: string) => {
+    const property = capabilities.animatable.find((candidate) => candidate.path === path);
+    if (!property) return null;
+    return {
+      property,
+      initial: `style="${property.name}: <start>"`,
+      tween: `timeline.to("<selector>", { "${property.name}": <end>, duration: <seconds> })`,
+      rules: [
+        "Author the initial value inline on the media element.",
+        "Use finite keyframes on a paused timeline registered in window.__timelines.",
+        "Do not use a frame-zero set, timers, random values, or onUpdate callbacks.",
+      ],
+    };
+  };
+
+  const effect = capabilities.effects.find(({ key }) => key === id);
+  if (effect) {
+    return {
+      id,
+      family: effect.family,
+      label: effect.label,
+      description: effect.description,
+      renderLane: effect.renderLane,
+      supportsPalette: effect.supportsPalette,
+      apply: { effects: effect.apply },
+      controls: effect.controls,
+      animation: animation(`effects.${id}`),
+    };
+  }
+
+  const effectFamily = capabilities.effectFamilies.find((family) => family.id === id);
+  if (effectFamily) {
+    return {
+      ...effectFamily,
+      effects: capabilities.effects
+        .filter((candidate) => candidate.family === id)
+        .map((candidate) => ({
+          id: candidate.key,
+          label: candidate.label,
+          description: candidate.description,
+          renderLane: candidate.renderLane,
+          supportsPalette: candidate.supportsPalette,
+          animatable: capabilities.animatable.some(
+            ({ path }) => path === `effects.${candidate.key}`,
+          ),
+        })),
+    };
+  }
+
+  const adjustment = capabilities.adjustments.find(({ key }) => key === id);
+  if (adjustment) {
+    return {
+      id,
+      family: "correction",
+      description: `Adjust ${id} within the canonical correction range.`,
+      control: adjustment,
+      apply: { adjust: { [id]: adjustment.identity } },
+      animation: animation(`adjust.${id}`),
+    };
+  }
+
+  const finishing = capabilities.finishing.find(({ key }) => key === id);
+  if (finishing) {
+    return {
+      id,
+      family: "finishing",
+      description: `Adjust ${id} within the canonical finishing range.`,
+      control: finishing,
+      apply: { details: { [id]: finishing.identity } },
+    };
+  }
+
+  const preset = capabilities.presets.find((candidate) => candidate.id === id);
+  if (preset) {
+    return {
+      id: preset.id,
+      label: preset.label,
+      description: "Tested built-in media preset.",
+      apply: { preset: preset.id, intensity: preset.intensity },
+    };
+  }
+
+  const palette = capabilities.palettes.find((candidate) => candidate.id === id);
+  if (palette) return { ...palette, apply: { palette: palette.colors } };
+
+  const details = {
+    correction: {
+      id,
+      description: "Fix exposure, tonal balance, color casts, and saturation.",
+      controls: capabilities.adjustments,
+    },
+    presets: {
+      id,
+      description: "Tested starting points for color and stylized media effects.",
+      presets: capabilities.presets,
+    },
+    finishing: {
+      id,
+      description: "Vignette and deterministic film-grain controls.",
+      controls: capabilities.finishing,
+    },
+    palettes: {
+      id,
+      description: "Named palettes plus the custom palette contract.",
+      contract: capabilities.palette,
+      palettes: capabilities.palettes,
+    },
+    animation: {
+      id,
+      description: "Seek-safe CSS properties for registered GSAP timelines.",
+      properties: capabilities.animatable,
+    },
+    lut: {
+      id,
+      description: "User-owned 3D .cube LUT support.",
+      contract: capabilities.lut,
+    },
+    overlays: {
+      id,
+      description: "Authored overlay blocks owned by the HyperFrames Registry.",
+      discover: "hyperframes catalog",
+      apply: "hyperframes add <overlay> --dir <project> --no-clipboard --json",
+    },
+  } as const;
+
+  const detail = Object.hasOwn(details, id) ? Reflect.get(details, id) : undefined;
+  if (detail) return detail;
+  throw new Error(`Unknown media-treatment capability: ${id}`);
+}
+
+export const examples: Example[] = [
+  [
+    "Discover the complete treatment surface without loading every control",
+    `hyperframes media-treatment --capabilities --json`,
+  ],
+  [
+    "Inspect one relevant effect in detail",
+    `hyperframes media-treatment --capability kuwahara --json`,
+  ],
+  [
+    "Inspect the exhaustive machine-readable catalog",
+    `hyperframes media-treatment --capabilities --all --json`,
+  ],
+  [
+    "Apply a resolved treatment to one media element",
+    `hyperframes media-treatment --selector '#hero' --grading '{"preset":"skin-soft","intensity":0.6}' --apply`,
+  ],
+  [
+    "Preview the exact mutation without writing",
+    `hyperframes media-treatment --file compositions/scene.html --selector 'video' --grading '{"preset":"warm-daylight"}' --apply --dry-run --json`,
+  ],
+  ["Remove a treatment", `hyperframes media-treatment --selector '#hero' --clear`],
+];
+
+interface ApplyMediaTreatmentOptions {
+  selector: string;
+  selectorIndex?: number;
+  grading?: unknown;
+  clear?: boolean;
+}
+
+interface ApplyMediaTreatmentResult {
+  html: string;
+  changed: boolean;
+  tag: "img" | "video";
+  value: string | null;
+  before: unknown;
+  after: unknown;
+}
+
+function parseSourceDocument(source: string): Document {
+  if (/<!doctype|<html[\s>]/i.test(source)) return parseHTML(source).document;
+  return parseHTML(`<!DOCTYPE html><html><body>${source}</body></html>`).document;
+}
+
+function assertKnownGradingShape(value: unknown): void {
+  const issue = validateColorGradingContract(value)[0];
+  if (issue) {
+    const hint = issue.hint ? ` ${issue.hint}` : "";
+    throw new Error(`Invalid color-grading ${issue.path}: ${issue.message}.${hint}`);
+  }
+}
+
+function containsColorGradingVariableRef(value: unknown): boolean {
+  if (isColorGradingVariableRef(value)) return true;
+  if (Array.isArray(value)) return value.some(containsColorGradingVariableRef);
+  if (typeof value !== "object" || value === null) return false;
+  return Object.values(value).some(containsColorGradingVariableRef);
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function parseStoredGrading(raw: string | null): unknown {
+  if (raw === null) return null;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+}
+
+function mergeGradingPatch(current: unknown, patch: unknown): unknown {
+  if (!isRecord(current) || !isRecord(patch)) return patch;
+  const merged = { ...current };
+  for (const [key, value] of Object.entries(patch)) {
+    merged[key] =
+      isRecord(value) && isRecord(merged[key]) ? mergeGradingPatch(merged[key], value) : value;
+  }
+  return merged;
+}
+
+function serializeGradingPatch(before: unknown, patch: unknown): string | null {
+  assertKnownGradingShape(patch);
+  if (isColorGradingVariableRef(before) && isRecord(patch)) {
+    throw new Error("Cannot merge a grading patch into an unresolved whole-grade variable");
+  }
+  const current =
+    typeof before === "string" && !isColorGradingVariableRef(before) ? { preset: before } : before;
+  const grading = mergeGradingPatch(current, patch);
+  assertKnownGradingShape(grading);
+  if (containsColorGradingVariableRef(grading)) {
+    return typeof grading === "string" ? grading.trim() : JSON.stringify(grading);
+  }
+  const normalized = normalizeHfColorGrading(grading);
+  if (!normalized) throw new Error("--grading must be valid HyperFrames color-grading JSON");
+  return isHfColorGradingActive(normalized) ? serializeHfColorGrading(normalized) : null;
+}
+
+function queryIncludingTemplates(root: Document | Element, selector: string): Element[] {
+  const matches = Array.from(root.querySelectorAll(selector));
+  if (matches.length > 0) return matches;
+  for (const template of root.querySelectorAll("template")) {
+    const nested = queryIncludingTemplates(template, selector);
+    if (nested.length > 0) return nested;
+  }
+  return [];
+}
+
+function selectMediaElement(
+  source: string,
+  selector: string,
+  selectorIndex?: number,
+): { element: Element; selectorIndex: number; tag: "img" | "video" } {
+  const document = parseSourceDocument(source);
+  let matches: Element[];
+  try {
+    matches = queryIncludingTemplates(document, selector);
+  } catch {
+    throw new Error(`Invalid selector: ${selector}`);
+  }
+  if (matches.length === 0) throw new Error(`Selector did not match: ${selector}`);
+  if (selectorIndex === undefined && matches.length > 1) {
+    throw new Error(
+      `Selector matched ${matches.length} elements; use a unique selector or --selector-index`,
+    );
+  }
+
+  const resolvedIndex = selectorIndex ?? 0;
+  const element = matches[resolvedIndex];
+  if (!element) {
+    throw new Error(`--selector-index ${resolvedIndex} is outside ${matches.length} matches`);
+  }
+  const tag = element.tagName.toLowerCase();
+  if (tag !== "img" && tag !== "video") {
+    throw new Error(`Color grading requires an <img> or <video>; selector matched <${tag}>`);
+  }
+  return { element, selectorIndex: resolvedIndex, tag };
+}
+
+export function applyMediaTreatmentToHtml(
+  source: string,
+  options: ApplyMediaTreatmentOptions,
+): ApplyMediaTreatmentResult {
+  const { element, selectorIndex, tag } = selectMediaElement(
+    source,
+    options.selector,
+    options.selectorIndex,
+  );
+  const before = parseStoredGrading(element.getAttribute(HF_COLOR_GRADING_ATTR));
+
+  const value = options.clear ? null : serializeGradingPatch(before, options.grading);
+
+  const changed = element.getAttribute(HF_COLOR_GRADING_ATTR) !== value;
+  const after = parseStoredGrading(value);
+  if (!changed) return { html: source, changed: false, tag, value, before, after };
+
+  const patched = patchElementInHtml(source, { selector: options.selector, selectorIndex }, [
+    { type: "attribute", property: HF_COLOR_GRADING_ATTR, value },
+  ]);
+  if (!patched.matched) throw new Error(`Could not persist selector: ${options.selector}`);
+  return { html: patched.html, changed: true, tag, value, before, after };
+}
+
+function parseSelectorIndex(raw: string | undefined): number | undefined {
+  if (raw === undefined) return undefined;
+  const value = Number(raw);
+  if (!Number.isInteger(value) || value < 0) {
+    throw new Error("--selector-index must be a non-negative integer");
+  }
+  return value;
+}
+
+function parseGrading(raw: string | undefined, apply: boolean, clear: boolean): unknown {
+  if (clear) {
+    if (raw !== undefined || apply) {
+      throw new Error("Use either --apply with --grading or --clear, not both");
+    }
+    return undefined;
+  }
+  if (!apply) {
+    if (raw !== undefined) throw new Error("--grading requires --apply");
+    throw new Error("Use --apply with --grading <json> or --clear");
+  }
+  if (raw === undefined) throw new Error("--apply requires --grading <json>");
+  try {
+    return JSON.parse(raw);
+  } catch (error) {
+    throw new Error(`Could not parse --grading JSON: ${normalizeErrorMessage(error)}`);
+  }
+}
+
+function mutationVerb(action: "apply" | "clear", changed: boolean, dryRun: boolean): string {
+  if (dryRun) return `Would ${action}`;
+  if (!changed) return action === "apply" ? "Already applied" : "Already clear";
+  return action === "apply" ? "Applied" : "Cleared";
+}
+
+export const mediaTreatmentCommand = defineCommand({
+  meta: {
+    name: "media-treatment",
+    description: "Discover, apply, or clear deterministic media treatments",
+  },
+  args: {
+    capabilities: {
+      type: "boolean",
+      description: "Print a concise agent-readable capability overview",
+      default: false,
+    },
+    capability: {
+      type: "string",
+      description: "Inspect one family, control, effect, preset, or palette",
+    },
+    all: {
+      type: "boolean",
+      description: "Print the exhaustive capability catalog",
+      default: false,
+    },
+    project: { type: "string", description: "Project directory (default: cwd)" },
+    file: {
+      type: "string",
+      description: "Composition file relative to project (default: index.html)",
+    },
+    selector: {
+      type: "string",
+      description: "Unique CSS selector for one <img> or <video>",
+    },
+    "selector-index": {
+      type: "string",
+      description: "Zero-based match index when the selector is not unique",
+    },
+    grading: { type: "string", description: "Canonical color-grading JSON patch" },
+    apply: {
+      type: "boolean",
+      description: "Apply the validated grading patch (explicit agent form)",
+      default: false,
+    },
+    clear: { type: "boolean", description: "Remove color grading from the target", default: false },
+    "dry-run": {
+      type: "boolean",
+      description: "Validate and report without writing",
+      default: false,
+    },
+    json: { type: "boolean", description: "Output an agent-friendly JSON result", default: false },
+  },
+  run({ args }) {
+    const runCapabilityQuery = () => {
+      const capability = readOptionalString(args.capability);
+      const hasMutationOption = [
+        readOptionalString(args.selector),
+        readOptionalString(args.grading),
+        args.clear,
+        args["dry-run"],
+        args.apply,
+      ].some(Boolean);
+      if (hasMutationOption) {
+        throw new Error("--capabilities cannot be combined with mutation options");
+      }
+      if (args.all === true && capability) {
+        throw new Error("Use either --all or --capability, not both");
+      }
+      let capabilities: unknown = getMediaTreatmentCapabilityOverview();
+      if (args.all === true) capabilities = getHfColorGradingCapabilities();
+      else if (capability) capabilities = getMediaTreatmentCapabilityDetail(capability);
+      console.log(JSON.stringify(withMeta({ ok: true, capabilities }), null, 2));
+    };
+
+    const resolveMutationFile = () => {
+      const project = resolveProject(readOptionalString(args.project));
+      const fileArg = readOptionalString(args.file) ?? "index.html";
+      const filePath = resolve(project.dir, fileArg);
+      if (!isPathInside(filePath, project.dir) || !filePath.toLowerCase().endsWith(".html")) {
+        throw new Error("--file must be an HTML file inside the project");
+      }
+      if (!existsSync(filePath)) throw new Error(`Composition file not found: ${fileArg}`);
+      return { project, filePath };
+    };
+
+    const prepareMutation = () => {
+      const { project, filePath } = resolveMutationFile();
+      const selector = readOptionalString(args.selector);
+      if (!selector) throw new Error("--selector is required");
+      const clear = args.clear === true;
+      const apply = args.apply === true;
+      const selectorIndex = parseSelectorIndex(readOptionalString(args["selector-index"]));
+      const result = applyMediaTreatmentToHtml(readFileSync(filePath, "utf8"), {
+        selector,
+        selectorIndex,
+        grading: parseGrading(readOptionalString(args.grading), apply, clear),
+        clear,
+      });
+      const dryRun = args["dry-run"] === true;
+      if (result.changed && !dryRun) writeFileSync(filePath, result.html);
+
+      const action: "clear" | "apply" = result.value === null ? "clear" : "apply";
+      return {
+        action,
+        result,
+        selector,
+        payload: {
+          ok: true,
+          action,
+          file: relative(project.dir, filePath) || "index.html",
+          selector,
+          selectorIndex: selectorIndex ?? 0,
+          tag: result.tag,
+          changed: result.changed,
+          dryRun,
+          before: result.before,
+          after: result.after,
+        },
+      };
+    };
+
+    try {
+      if (args.capabilities === true || readOptionalString(args.capability) || args.all === true) {
+        return runCapabilityQuery();
+      }
+      const { action, result, selector, payload } = prepareMutation();
+      if (args.json === true) {
+        console.log(JSON.stringify(withMeta(payload), null, 2));
+      } else {
+        const verb = mutationVerb(action, result.changed, payload.dryRun);
+        console.log(`${c.success("◇")}  ${verb} media treatment on ${c.accent(selector)}`);
+      }
+    } catch (error) {
+      const message = normalizeErrorMessage(error);
+      if (args.json === true) console.log(JSON.stringify(withMeta({ ok: false, error: message })));
+      else console.error(`${c.error("✗")} ${message}`);
+      failCommand();
+    }
+  },
+});
diff --git a/packages/cli/src/help.ts b/packages/cli/src/help.ts
index e876f0a535..084c16182b 100644
--- a/packages/cli/src/help.ts
+++ b/packages/cli/src/help.ts
@@ -42,6 +42,10 @@ const GROUPS: Group[] = [
       ["inspect", "Inspect rendered visual layout across the timeline"],
       ["keyframes", "Inspect keyframes and render onion-shot diagnostics"],
       ["snapshot", "Capture key frames as PNG screenshots for visual verification"],
+      [
+        "media-treatment",
+        "Discover, apply, or clear deterministic media treatments on one media element",
+      ],
       [
         "grade-compare",
         "Render candidate color grades onto a reference frame as one labeled comparison PNG",
diff --git a/packages/cli/src/templates/_shared/AGENTS.md b/packages/cli/src/templates/_shared/AGENTS.md
index a63562ce11..c4ff0aefda 100644
--- a/packages/cli/src/templates/_shared/AGENTS.md
+++ b/packages/cli/src/templates/_shared/AGENTS.md
@@ -20,6 +20,8 @@
 
 The domain skills (`/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-keyframes`, `/hyperframes-creative`, `/hyperframes-cli`, `/media-use`, `/hyperframes-registry`, `/figma`) and the full capability map live inside `/hyperframes` — it is the single source of truth for which skill handles which intent.
 
+**Changing how real footage or images look or reveal?** Load `/media-use` and its media-treatment policy before editing, even when the request only says dark, flat, boring, retro, private, or “make the reveal cooler.” Use canonical media treatments and seek-safe motion; do not improvise equivalent CSS/SVG filters or overlays.
+
 > **Tailwind v4 projects** (`hyperframes init --tailwind`): see `/hyperframes-core` → `references/tailwind.md`.
 
 > **Skill missing or stale?** Run `npx hyperframes skills update <name>` to install/refresh
diff --git a/packages/cli/src/templates/_shared/CLAUDE.md b/packages/cli/src/templates/_shared/CLAUDE.md
index a63562ce11..c4ff0aefda 100644
--- a/packages/cli/src/templates/_shared/CLAUDE.md
+++ b/packages/cli/src/templates/_shared/CLAUDE.md
@@ -20,6 +20,8 @@
 
 The domain skills (`/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-keyframes`, `/hyperframes-creative`, `/hyperframes-cli`, `/media-use`, `/hyperframes-registry`, `/figma`) and the full capability map live inside `/hyperframes` — it is the single source of truth for which skill handles which intent.
 
+**Changing how real footage or images look or reveal?** Load `/media-use` and its media-treatment policy before editing, even when the request only says dark, flat, boring, retro, private, or “make the reveal cooler.” Use canonical media treatments and seek-safe motion; do not improvise equivalent CSS/SVG filters or overlays.
+
 > **Tailwind v4 projects** (`hyperframes init --tailwind`): see `/hyperframes-core` → `references/tailwind.md`.
 
 > **Skill missing or stale?** Run `npx hyperframes skills update <name>` to install/refresh
diff --git a/packages/core/src/colorGrading.ts b/packages/core/src/colorGrading.ts
index 6798359fdf..08c84a23b9 100644
--- a/packages/core/src/colorGrading.ts
+++ b/packages/core/src/colorGrading.ts
@@ -575,6 +575,127 @@ export const HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS = [
 
 export type HfColorGradingActiveEffectKey = (typeof HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS)[number];
 
+const EFFECT_FAMILIES = [
+  {
+    id: "essentials",
+    label: "Essentials",
+    description: "Common optical, focus, and privacy-oriented primitives.",
+  },
+  {
+    id: "retro-glitch",
+    label: "Retro & Glitch",
+    description: "Tape, film, CRT, channel separation, and digital disruption.",
+  },
+  {
+    id: "print",
+    label: "Print",
+    description: "Halftone, limited-ink, dither, and screen-print rendering.",
+  },
+  {
+    id: "art",
+    label: "Art",
+    description: "ASCII, engraved, crosshatched, and painterly rendering.",
+  },
+] as const;
+
+type EffectFamilyId = (typeof EFFECT_FAMILIES)[number]["id"];
+
+const EFFECT_METADATA = {
+  blur: {
+    family: "essentials",
+    label: "Blur",
+    description: "Defocus or soften a full media layer.",
+  },
+  pixelate: {
+    family: "essentials",
+    label: "Pixelate",
+    description: "Turn a media layer into a block mosaic.",
+  },
+  bloom: {
+    family: "essentials",
+    label: "Bloom",
+    description: "Add thresholded glow around bright image regions.",
+  },
+  chromaBleed: {
+    family: "retro-glitch",
+    label: "Chroma Softening",
+    description: "Smear color like low-bandwidth video.",
+  },
+  tapeDamage: {
+    family: "retro-glitch",
+    label: "Tape Damage",
+    description: "Add moving tracking errors and tape noise.",
+  },
+  filmArtifacts: {
+    family: "retro-glitch",
+    label: "Film Artifacts",
+    description: "Add deterministic dust and film wear.",
+  },
+  scanlines: {
+    family: "retro-glitch",
+    label: "Scanlines",
+    description: "Overlay configurable horizontal display lines.",
+  },
+  crtCurvature: {
+    family: "retro-glitch",
+    label: "CRT Curvature",
+    description: "Warp media toward curved CRT geometry.",
+  },
+  chromaticAberration: {
+    family: "retro-glitch",
+    label: "Channel Separation",
+    description: "Offset color channels by angle.",
+  },
+  digitalGlitch: {
+    family: "retro-glitch",
+    label: "Digital Glitch",
+    description: "Compose tears, blocks, and color splits.",
+  },
+  halftone: {
+    family: "print",
+    label: "Halftone",
+    description: "Render source color through a print-dot raster.",
+  },
+  twoInkPrint: {
+    family: "print",
+    label: "Two-Ink Print",
+    description: "Reduce media to a two-ink print treatment.",
+  },
+  dither: {
+    family: "print",
+    label: "Ordered Dither",
+    description: "Quantize media into an ordered limited palette.",
+  },
+  monoScreen: {
+    family: "print",
+    label: "Mono Screen",
+    description: "Build monochrome dot, shape, or line artwork.",
+  },
+  ascii: {
+    family: "art",
+    label: "ASCII",
+    description: "Render media as configurable procedural glyph cells.",
+  },
+  engraving: {
+    family: "art",
+    label: "Engraving",
+    description: "Translate luminance into directional engraved lines.",
+  },
+  crosshatch: {
+    family: "art",
+    label: "Crosshatch",
+    description: "Translate media into layered hand-hatched lines.",
+  },
+  kuwahara: {
+    family: "art",
+    label: "Kuwahara Paint",
+    description: "Apply edge-preserving painterly smoothing.",
+  },
+} as const satisfies Record<
+  HfColorGradingActiveEffectKey,
+  { family: EffectFamilyId; label: string; description: string }
+>;
+
 export const HF_COLOR_GRADING_EFFECT_PRESETS = HF_COLOR_GRADING_PRESETS.filter((preset) =>
   HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS.some((key) => preset.effects[key] > 0.0001),
 );
@@ -714,6 +835,7 @@ export function getHfColorGradingCapabilities() {
       identity: ADJUST_ZERO[key],
       ...ADJUST_LIMITS[key],
     })),
+    effectFamilies: EFFECT_FAMILIES,
     finishing: HF_COLOR_GRADING_DETAIL_KEYS.map((key) => ({
       key,
       identity: DETAIL_DEFAULTS[key],
@@ -723,6 +845,7 @@ export function getHfColorGradingCapabilities() {
       const apply = HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS[key];
       return {
         key,
+        ...EFFECT_METADATA[key],
         apply: { ...apply },
         supportsPalette: PALETTE_EFFECT_KEYS.has(key),
         renderLane: MULTIPASS_EFFECT_KEYS.has(key) ? "multipass" : "single-pass",
diff --git a/skills-manifest.json b/skills-manifest.json
index 3201569e68..2dec1c9972 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -14,11 +14,11 @@
       "files": 2
     },
     "general-video": {
-      "hash": "3303742225924078",
+      "hash": "e8c377a79bd57a69",
       "files": 4
     },
     "hyperframes": {
-      "hash": "ab268ec1eca15ae9",
+      "hash": "02b48855a5321e48",
       "files": 17
     },
     "hyperframes-animation": {
@@ -26,7 +26,7 @@
       "files": 121
     },
     "hyperframes-cli": {
-      "hash": "de00375f053c05e8",
+      "hash": "a4db0693ff88e760",
       "files": 11
     },
     "hyperframes-core": {
@@ -46,8 +46,8 @@
       "files": 10
     },
     "media-use": {
-      "hash": "6b94dc295e2d6ba0",
-      "files": 145
+      "hash": "1234dcf993bbe1fc",
+      "files": 151
     },
     "motion-graphics": {
       "hash": "da65c1864debfe11",
diff --git a/skills/general-video/SKILL.md b/skills/general-video/SKILL.md
index f9cee5fdc1..4f29467484 100644
--- a/skills/general-video/SKILL.md
+++ b/skills/general-video/SKILL.md
@@ -20,7 +20,7 @@ A successful no-op means the skill is current. Surface an update failure instead
 
 ## 1. Apply cross-cutting source adapters
 
-- **Media:** For any audio, image, icon, logo, voice, grade, LUT, caption, or media-operation need, load `/media-use` and follow its adoption, resolution, provider, provenance, and reuse contracts. Before the first authenticated provider action, run `npx hyperframes auth status` and relay its output verbatim. If signed out, apply the gate in `../hyperframes-core/references/brief-contract.md`: collaborative waits for sign-in or an explicit offline choice; autonomous states the status and continues through an available offline provider. Surface a blocker when no offline provider can satisfy a required capability. Local adoption alone does not require an auth gate.
+- **Media:** For any audio, image, icon, logo, voice, grade, LUT, treatment/effect, caption, or media-operation need, load `/media-use` and follow its adoption, resolution, provider, provenance, and reuse contracts. Vague footage feedback and named styles use its `media-treatments.md` policy before editing; do not improvise supported media effects with CSS/SVG/opacity. Before the first authenticated provider action, run `npx hyperframes auth status` and relay its output verbatim. If signed out, apply the gate in `../hyperframes-core/references/brief-contract.md`: collaborative waits for sign-in or an explicit offline choice; autonomous states the status and continues through an available offline provider. Surface a blocker when no offline provider can satisfy a required capability. Local adoption alone does not require an auth gate.
 - **Figma:** If any input is a `figma.com` URL, run `/figma` first. Build from its exported assets, tokens, components, or storyboard frames. Do not use raw Figma connector calls because they skip SVG sanitization, media provenance, and brand-token binding.
 
 These adapters do not change the workflow selected by `/hyperframes`.
diff --git a/skills/hyperframes-cli/references/compare-and-batch.md b/skills/hyperframes-cli/references/compare-and-batch.md
index c541cca9f1..7e2a2e0dd3 100644
--- a/skills/hyperframes-cli/references/compare-and-batch.md
+++ b/skills/hyperframes-cli/references/compare-and-batch.md
@@ -48,7 +48,7 @@ npx hyperframes grade-compare \
 `grades.json` is an array of labeled HyperFrames grading blocks:
 
 ```json
-[{ "label": "warm", "grading": { "temperature": 0.2, "contrast": 0.1 } }]
+[{ "label": "warm", "grading": { "adjust": { "temperature": 0.2, "contrast": 0.1 } } }]
 ```
 
 Or compare explicit LUT files:
diff --git a/skills/hyperframes/SKILL.md b/skills/hyperframes/SKILL.md
index b8a9c4ca88..e31530d348 100644
--- a/skills/hyperframes/SKILL.md
+++ b/skills/hyperframes/SKILL.md
@@ -96,4 +96,14 @@ Use the bare name without `/`. If the command fails, surface the error; do not r
 | Registry blocks and components                                                                                      | `/hyperframes-registry`  |
 | Figma assets, tokens, components, or storyboard frames as reconstructed motion                                      | `/figma`                 |
 
+Broad feedback about how photographic media looks or behaves also routes to
+`/media-use`, even when the user never says “color grading” or “effect”: fix
+dark/flat/boring footage, stylize a clip, hide a face, or improve a media
+reveal. Load its media-treatment policy before editing; do not substitute a
+generic LUT, CSS filter/overlay, or opacity tween for an existing canonical
+treatment primitive. Keep text/layout/motion-only edits in their owning domain.
+During a build with important photographic media, include one grounded
+media-polish scan in the final quality pass; leaving suitable media unchanged is
+a valid result.
+
 Domain skills never take ownership of the end-to-end deliverable. Load only what the active workflow needs.
diff --git a/skills/hyperframes/references/capability-menu.md b/skills/hyperframes/references/capability-menu.md
index 0b25f633f5..a07d7c9c10 100644
--- a/skills/hyperframes/references/capability-menu.md
+++ b/skills/hyperframes/references/capability-menu.md
@@ -6,23 +6,23 @@ One list, three readers. The **pitch round** (`pitch-round.md`) speaks it before
 
 Each row's last column reads **home → entry → what you get**: the owning skill, the exact doc or command to start from, and the artifact that comes back.
 
-| Capability                                                                                                                                             | Say it to the user as…                                                                                          | Home → entry → what you get                                                                                                                                                                                                                                                                                                                     |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Design spec (`frame.md`)** — one file that locks palette, type, and layout feel; every frame obeys it (the video-first sibling of a web `design.md`) | "a design system for the video — colors and typography stay consistent"                                         | `/hyperframes-creative` → `references/design-spec.md` (what a spec is + resolution order); presets: `frame-presets/<name>/` (always installed — browsing needs no borrow); applying machinery `build-frame.mjs` (home: `/faceless-explainer`, `/product-launch-video`) → `frame.md` at the project root. How to ask: **§ The design ask** below |
-| **Website capture** — headless-Chrome crawl of a real site: screenshots, brand tokens, assets                                                          | "I can capture your site and build from its real look"                                                          | CLI → `npx hyperframes capture <URL> -o ./capture` → `capture/` (screenshots, extracted tokens/text/assets); doctrine: `/product-launch-video`                                                                                                                                                                                                  |
-| **Beat analysis & audio-reactive motion** — a deterministic beat / energy map of a track; cuts land on the grid, elements pulse with the music         | "if there's music, I can cut the video to its beat — and make elements move with it"                            | grid: `/music-to-video` → `scripts/analyze-beatgrid.py` → `audiomap.json` (beats, energy, sections); element reaction: `/hyperframes-creative` → `references/audio-reactive.md` + `scripts/extract-audio-data.py`                                                                                                                               |
-| **Motion blueprints** — proven scene shapes (reveals, counters, charts, dioramas) picked per beat                                                      | "each scene gets a proven motion treatment, not improvised movement"                                            | `/hyperframes-animation` → `blueprints-index.md` + `rules-index.md` → per-beat `blueprint:` ids the build reads                                                                                                                                                                                                                                 |
-| **Voice, music, SFX, images, logos, color grades** — generated or resolved from the catalog, frozen into the project                                   | "narration in a voice you pick, background music, sound effects, brand logos — and a cinematic grade on images" | `/media-use` → `scripts/resolve.mjs` (one verb, incl. `--type grade`) + the audio engine `audio/scripts/audio.mjs` → frozen local files + `.media/manifest.jsonl` records / `audio_meta.json`                                                                                                                                                   |
-| **Generative video** — an AI presenter delivers the script; a still photo becomes a talking clip; a finished video gets dubbed into another language   | "an AI presenter can read your script on camera; I can animate a photo into a talking clip, or dub the video"   | `/media-use` → `references/operations.md` § Generate: video (`heygen video create` / `video-translate`; OAuth free allowance where eligible) → an mp4 clip adopted into `assets/` + manifest record                                                                                                                                             |
-| **Transcription & captions** — word-timed transcripts; styled caption skins on the finished video                                                      | "accurate captions, styled to match"                                                                            | `/media-use` → `scripts/transcribe.mjs` → word-timed transcript; caption machinery `captions.mjs` (home: `/faceless-explainer`) → the caption track                                                                                                                                                                                             |
-| **Cut footage by its transcript** — trim a clip by choosing sentences, not timecodes                                                                   | "I can trim your clip by picking the sentences to keep"                                                         | `/media-use` → `scripts/transcript-cut.mjs` → the trimmed clip + updated transcript                                                                                                                                                                                                                                                             |
-| **Designed overlays on user footage** — kinetic titles, lower-thirds, data callouts synced to what's said                                              | "your own clip can carry designed titles and info bars, timed to the speech"                                    | the **whole ask** = the `/talking-head-recut` route — route there, don't rebuild it; **one scene inside a bigger piece** = `/hyperframes-animation` lower-third / callout blueprints + `/talking-head-recut`'s safe-zone thinking → overlay comps on the footage track                                                                          |
-| **Real map scenes** — a genuine basemap with located pins, routes, or a flight path                                                                    | "for places and journeys — a real map, not a drawing of one"                                                    | `/motion-graphics` → `grounding/locate.mjs` (geocode) + `categories/maps/` (incl. `bake-basemap.mjs`) → a deterministic baked basemap + located pins                                                                                                                                                                                            |
-| **Figma import** — assets, brand tokens, components, storyboard frames read as motion states                                                           | "if the design lives in Figma, I can build from it directly"                                                    | `/figma` → REST/CLI import (+ MCP for Motion/shaders) → sanitized SVGs, `var()`-bound brand tokens, frames-as-states                                                                                                                                                                                                                            |
-| **Registry blocks** — 50+ installable scene compositions (data charts, device mockups, quote cards…)                                                   | "ready-made scenes we can drop in and restyle"                                                                  | `/hyperframes-registry` → `npx hyperframes add <block>` → an installed sub-composition (wiring: `references/wiring-blocks.md`)                                                                                                                                                                                                                  |
-| **Scene transitions** — cuts, crossfades, wipes, WebGL shader transitions between scenes                                                               | "how one scene hands off to the next — up to full shader wipes"                                                 | `/hyperframes-animation` → `transitions/overview.md` then `transitions/catalog.md`; assembly `transitions.mjs` (home: `/faceless-explainer`) → injected handoffs in the index                                                                                                                                                                   |
-| **User media on the timeline** — the user's own images / clips staged and woven into frames                                                            | "your own footage, screenshots, or photos placed into the video"                                                | staging `stage-assets.mjs` (home: `/music-to-video`, `/product-launch-video`); adoption: `/media-use` `--adopt` → files in `assets/` + manifest records                                                                                                                                                                                         |
-| **Publish to a stable link** — the finished piece on a public URL; re-publishing updates the same link                                                 | "when it's done I can publish it to a link you can share — updates keep the same URL"                           | `/hyperframes-cli` → `references/preview-render.md` (`npx hyperframes publish`) → a stable public URL                                                                                                                                                                                                                                           |
+| Capability                                                                                                                                             | Say it to the user as…                                                                                        | Home → entry → what you get                                                                                                                                                                                                                                                                                                                     |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Design spec (`frame.md`)** — one file that locks palette, type, and layout feel; every frame obeys it (the video-first sibling of a web `design.md`) | "a design system for the video — colors and typography stay consistent"                                       | `/hyperframes-creative` → `references/design-spec.md` (what a spec is + resolution order); presets: `frame-presets/<name>/` (always installed — browsing needs no borrow); applying machinery `build-frame.mjs` (home: `/faceless-explainer`, `/product-launch-video`) → `frame.md` at the project root. How to ask: **§ The design ask** below |
+| **Website capture** — headless-Chrome crawl of a real site: screenshots, brand tokens, assets                                                          | "I can capture your site and build from its real look"                                                        | CLI → `npx hyperframes capture <URL> -o ./capture` → `capture/` (screenshots, extracted tokens/text/assets); doctrine: `/product-launch-video`                                                                                                                                                                                                  |
+| **Beat analysis & audio-reactive motion** — a deterministic beat / energy map of a track; cuts land on the grid, elements pulse with the music         | "if there's music, I can cut the video to its beat — and make elements move with it"                          | grid: `/music-to-video` → `scripts/analyze-beatgrid.py` → `audiomap.json` (beats, energy, sections); element reaction: `/hyperframes-creative` → `references/audio-reactive.md` + `scripts/extract-audio-data.py`                                                                                                                               |
+| **Motion blueprints** — proven scene shapes (reveals, counters, charts, dioramas) picked per beat                                                      | "each scene gets a proven motion treatment, not improvised movement"                                          | `/hyperframes-animation` → `blueprints-index.md` + `rules-index.md` → per-beat `blueprint:` ids the build reads                                                                                                                                                                                                                                 |
+| **Voice, music, SFX, images, logos, media treatments** — resolved media plus source-aware color, effects, privacy, reveals, and justified overlays     | "narration, music, sound effects, real assets — and footage polished or stylized to fit the story"            | `/media-use` → deterministic resolve/operate tools plus `references/media-treatments.md`; shader pixels persist through `hyperframes media-treatment`, optional overlays come from Registry, and finite motion uses the host GSAP timeline                                                                                                      |
+| **Generative video** — an AI presenter delivers the script; a still photo becomes a talking clip; a finished video gets dubbed into another language   | "an AI presenter can read your script on camera; I can animate a photo into a talking clip, or dub the video" | `/media-use` → `references/operations.md` § Generate: video (`heygen video create` / `video-translate`; OAuth free allowance where eligible) → an mp4 clip adopted into `assets/` + manifest record                                                                                                                                             |
+| **Transcription & captions** — word-timed transcripts; styled caption skins on the finished video                                                      | "accurate captions, styled to match"                                                                          | `/media-use` → `scripts/transcribe.mjs` → word-timed transcript; caption machinery `captions.mjs` (home: `/faceless-explainer`) → the caption track                                                                                                                                                                                             |
+| **Cut footage by its transcript** — trim a clip by choosing sentences, not timecodes                                                                   | "I can trim your clip by picking the sentences to keep"                                                       | `/media-use` → `scripts/transcript-cut.mjs` → the trimmed clip + updated transcript                                                                                                                                                                                                                                                             |
+| **Designed overlays on user footage** — kinetic titles, lower-thirds, data callouts synced to what's said                                              | "your own clip can carry designed titles and info bars, timed to the speech"                                  | the **whole ask** = the `/talking-head-recut` route — route there, don't rebuild it; **one scene inside a bigger piece** = `/hyperframes-animation` lower-third / callout blueprints + `/talking-head-recut`'s safe-zone thinking → overlay comps on the footage track                                                                          |
+| **Real map scenes** — a genuine basemap with located pins, routes, or a flight path                                                                    | "for places and journeys — a real map, not a drawing of one"                                                  | `/motion-graphics` → `grounding/locate.mjs` (geocode) + `categories/maps/` (incl. `bake-basemap.mjs`) → a deterministic baked basemap + located pins                                                                                                                                                                                            |
+| **Figma import** — assets, brand tokens, components, storyboard frames read as motion states                                                           | "if the design lives in Figma, I can build from it directly"                                                  | `/figma` → REST/CLI import (+ MCP for Motion/shaders) → sanitized SVGs, `var()`-bound brand tokens, frames-as-states                                                                                                                                                                                                                            |
+| **Registry blocks** — 50+ installable scene compositions (data charts, device mockups, quote cards…)                                                   | "ready-made scenes we can drop in and restyle"                                                                | `/hyperframes-registry` → `npx hyperframes add <block>` → an installed sub-composition (wiring: `references/wiring-blocks.md`)                                                                                                                                                                                                                  |
+| **Scene transitions** — cuts, crossfades, wipes, WebGL shader transitions between scenes                                                               | "how one scene hands off to the next — up to full shader wipes"                                               | `/hyperframes-animation` → `transitions/overview.md` then `transitions/catalog.md`; assembly `transitions.mjs` (home: `/faceless-explainer`) → injected handoffs in the index                                                                                                                                                                   |
+| **User media on the timeline** — the user's own images / clips staged and woven into frames                                                            | "your own footage, screenshots, or photos placed into the video"                                              | staging `stage-assets.mjs` (home: `/music-to-video`, `/product-launch-video`); adoption: `/media-use` `--adopt` → files in `assets/` + manifest records                                                                                                                                                                                         |
+| **Publish to a stable link** — the finished piece on a public URL; re-publishing updates the same link                                                 | "when it's done I can publish it to a link you can share — updates keep the same URL"                         | `/hyperframes-cli` → `references/preview-render.md` (`npx hyperframes publish`) → a stable public URL                                                                                                                                                                                                                                           |
 
 Offer, don't unload: the intent layer recommends the one or two rows the confirmed concept itself calls for, states each as one plain-language line traced to the brief, and asks once — the route-filtered slice on request, the full table for the companion.
 
diff --git a/skills/media-use/SKILL.md b/skills/media-use/SKILL.md
index 2f58e1c0a6..da79f530ec 100644
--- a/skills/media-use/SKILL.md
+++ b/skills/media-use/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: media-use
-description: Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Keeps search noise on disk, hands the agent one path or block. Use for any audio, image, icon, logo, voiceover, caption, color-grading, or media-asset need.
+description: Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.
 ---
 
 # media-use
@@ -25,36 +25,72 @@ Returns one line: `resolved <id> → <path> (<type>, <metadata>)`. All search no
 | `icon`  | icons, symbols (transparent)                                                        |
 | `logo`  | official brand marks (svgl → simple-icons → GitHub avatar → favicon; never redrawn) |
 | `voice` | TTS voiceover (HeyGen free-usage path; optional local Kokoro)                       |
-| `grade` | paste-ready HyperFrames `data-color-grading` block                                  |
-| `lut`   | reusable validated `.cube` file                                                     |
+| `grade` | measured correction candidate; broad polish/stylization follows Media Treatments    |
+| `lut`   | user-provided or explicitly chosen reusable validated `.cube` file                  |
 
 Before resolving fresh, list reusable candidates with `--candidates` and judge fit yourself — reuse rules, all flags, ingest (`--from`), and adopt are in `references/resolve.md`.
 
+## Treat broad visual feedback as media intent
+
+When a user explicitly asks to fix, polish, stylize, obscure, emphasize, or
+reveal photographic media, read `references/media-treatments.md` even if they
+do not name color grading or an effect. Inspect the real `<img>`/`<video>`,
+choose one primary intent, then use deterministic persistence and verification.
+Use a matching recipe as an optional tested seed, or inspect
+`hyperframes media-treatment --capabilities --json`, then request one relevant
+family/effect with `--capability <id>` and assemble a custom treatment from
+canonical controls. Never load `--all` for ordinary authoring. A treatment may
+compose correction, a preset, finishing, compatible shader effects, supported
+keyframes, and optional Registry overlays. Add only source-justified bounded
+tuning and compatible parts, never effects merely to make the result look more
+sophisticated. Persist the final combined payload with
+`hyperframes media-treatment`.
+
+Use one progressively escalating workflow. For video, inspect one labeled
+early/middle/late contact sheet rather than reading frames separately. Apply one
+candidate and inspect one after-sheet for ordinary correction or polish.
+Escalate to individual frames or moving draft evidence only when the result is
+ambiguous, temporal, stylized, LUT-based, HDR/LOG-sensitive, private, or
+brand-critical.
+
+For ordinary correction or polish, persist the final treatment's
+preset/adjustment JSON.
+Do not generate a `.cube` LUT merely to encode exposure, shadows, contrast, or
+warmth. Use a LUT only when the user supplies one or the selected treatment
+explicitly owns one. `resolve --type grade --for ... --analyze` is measurement
+evidence, not permission to replace the chosen treatment with a generated LUT.
+Do not recreate supported vignette, grain, blur, pixelate, color, or treatment
+effects with CSS/SVG overlays; that bypasses Studio controls and the canonical
+preview/render shader path.
+
 ## Be proactive — run a media opportunity pass
 
 The human usually can't tell which media would lift the piece. You can. When you build or review a composition, do **one** grounded scan and then **ask once** — don't silently add, and don't nag per asset.
 
 Surface an opportunity only when a concrete signal is present:
 
-| Signal detected                                        | Offer                                                                                       |
-| ------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
-| On-screen text / a script with no voiceover            | TTS voiceover (audio engine)                                                                |
-| Emoji or a `<div>` styled as an icon                   | resolve real `icon`s                                                                        |
-| Image that is a placeholder, tiny, or upscaled-looking | a better `image` (and/or upscale — see `references/operations.md`)                          |
-| Hard scene cuts / transitions with no sound            | transition `sfx`                                                                            |
-| A piece over ~10s with no music bed                    | `bgm`                                                                                       |
-| Footage that reads under/over-exposed or color-cast    | a corrective `grade` (analyze with `grade --for`, preview with `hyperframes grade-compare`) |
+| Signal detected                                          | Offer                                                                                                  |
+| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| On-screen text / a script with no voiceover              | TTS voiceover (audio engine)                                                                           |
+| Emoji or a `<div>` styled as an icon                     | resolve real `icon`s                                                                                   |
+| Image that is a placeholder, tiny, or upscaled-looking   | a better `image` (and/or upscale — see `references/operations.md`)                                     |
+| Hard scene cuts / transitions with no sound              | transition `sfx`                                                                                       |
+| A piece over ~10s with no music bed                      | `bgm`                                                                                                  |
+| Footage that reads under/over-exposed or color-cast      | a corrective `grade` (inspect with `grade --for --analyze`, preview with `hyperframes grade-compare`)  |
+| Photographic media that feels visually flat or off-topic | one specific source-appropriate preset or custom treatment, with the intended target named             |
+| A meaningful media entrance/reveal that feels static     | one supported seek-safe treatment animation; preserve color unless the request also justifies a preset |
 
 Rules that keep this a help, not nagware: **grounded, not generic** (no signal → no suggestion); **opinionated + concrete** (propose the specific fix with defaults chosen — the human approves **all / some / none**); **once per project** (one consolidated ask; respect "leave it"); **surface, never silently mutate** (color grades especially: propose and preview — a gray-world "correction" ruins an intentional sunset or neon look).
 
 ## Where to look — read only the file your task needs
 
-| Task                                                                      | Read                            |
-| ------------------------------------------------------------------------- | ------------------------------- |
-| resolve / reuse / adopt / ingest, flags, cascade, inventory               | `references/resolve.md`         |
-| color grading, LUTs, smart grade (`--for`), grade-compare                 | `references/grading.md`         |
-| voiceover / TTS, music, SFX, captions, transcription (audio engine)       | `references/audio.md`           |
-| cut / reframe / transform existing media, HEVC proxies, avatar video      | `references/operations.md`      |
-| install + auth, provider table, RAM ladders, `--local-only`, `--provider` | `references/setup-providers.md` |
-| remembered preferences + frozen recipes (user memory)                     | `references/memory.md`          |
-| ownership matrix, usage stats, telemetry, privacy (maintainer-facing)     | `references/meta.md`            |
+| Task                                                                      | Read                             |
+| ------------------------------------------------------------------------- | -------------------------------- |
+| resolve / reuse / adopt / ingest, flags, cascade, inventory               | `references/resolve.md`          |
+| color grading, LUTs, smart grade (`--for`), grade-compare                 | `references/grading.md`          |
+| voiceover / TTS, music, SFX, captions, transcription (audio engine)       | `references/audio.md`            |
+| cut / reframe / transform existing media, exact error diffusion, HEVC     | `references/operations.md`       |
+| source-aware creative treatments, realtime effects, overlays, reveals     | `references/media-treatments.md` |
+| install + auth, provider table, RAM ladders, `--local-only`, `--provider` | `references/setup-providers.md`  |
+| remembered preferences + frozen recipes (user memory)                     | `references/memory.md`           |
+| ownership matrix, usage stats, telemetry, privacy (maintainer-facing)     | `references/meta.md`             |
diff --git a/skills/media-use/references/grading.md b/skills/media-use/references/grading.md
index 3315e74833..1db04795f7 100644
--- a/skills/media-use/references/grading.md
+++ b/skills/media-use/references/grading.md
@@ -1,6 +1,21 @@
 # Color grading — grade blocks and LUTs
 
-Use `grade` when you need the actual HyperFrames `data-color-grading` value to paste onto an `<img>` or `<video>`. Core presets and params-backed library looks resolve locally; future CDN-backed library looks require network unless already frozen:
+Use `grade` when you need a canonical HyperFrames grading/effects payload for
+an `<img>` or `<video>`. Core presets and params-backed LUT entries resolve
+locally; future CDN-backed LUT entries require network unless already
+frozen. Persist a decided payload with the CLI rather than editing HTML by
+hand:
+
+For a vague but explicit polish request, do not jump directly from intent to a
+preset name. Read `media-treatments.md`, choose a treatment whose subject and
+avoid rules match the actual media, apply its conservative base with only
+justified bounded tuning, then complete its visual verification steps. A named
+owned treatment uses the exact preset/payload in its recipe; do not run the
+generic grade/LUT resolver first.
+
+Stop here and use that treatment workflow for requests such as retro, old home
+video, camcorder, film, print, ASCII, glitch, privacy, or a media reveal. Do not
+assemble those from a generic LUT plus handmade CSS vignette/grain/opacity.
 
 **Never `cat`/read a `.cube` file into context.** A 3D LUT is ~size^3 lines of raw numbers (33^3 ≈ 36k lines at the default size). It bloats context and carries zero human/agent-legible signal. To understand or choose a LUT, use `hyperframes grade-compare` to see it rendered, or `cube-validate.mjs` for a one-line `{ok,size}` check. Read `.media/index.md` or `luts/index.json` for the description. Never read the LUT body itself.
 
@@ -17,7 +32,16 @@ Preset-first output uses the core runtime vocabulary and does not freeze a file:
 }
 ```
 
-Paste it as an attribute value after JSON string escaping:
+Apply that payload to one unambiguous real media element:
+
+```bash
+hyperframes media-treatment --project . --file index.html \
+  --selector '#hero' \
+  --grading '{"preset":"warm-daylight","intensity":1}' --apply --json
+```
+
+Use `--dry-run` before writing when scope is uncertain and `--clear` to remove
+the treatment. The low-level persisted result is still normal HTML:
 
 ```html
 <video
@@ -27,7 +51,45 @@ Paste it as an attribute value after JSON string escaping:
 ></video>
 ```
 
-Looks beyond the preset vocabulary freeze a validated `.cube` under `.media/luts/` and return a block that references it:
+Direct attribute authoring is a fallback for environments where the CLI is not
+available, not the primary agent workflow.
+
+To build a treatment that is not already represented by a recipe, inspect the
+canonical toolbox first:
+
+```bash
+hyperframes media-treatment --capabilities --json
+```
+
+It reports valid adjustment, finishing, effect, palette, preset, and animated
+property ranges from Core. Compose one nested payload and pass it back through
+`hyperframes media-treatment`; the command rejects unknown keys before mutation.
+Do not generate or hand-edit a LUT merely to combine controls already owned by
+the realtime shader.
+
+For seek-safe effect motion, animate only the runtime-supported CSS properties
+on that same real media element with its registered paused GSAP timeline:
+
+| CSS property                       | Range   |
+| ---------------------------------- | ------- |
+| `--hf-color-grading-intensity`     | 0 to 1  |
+| `--hf-color-grading-lut-intensity` | 0 to 1  |
+| `--hf-color-grading-exposure`      | -2 to 2 |
+| `--hf-color-grading-blur`          | 0 to 1  |
+| `--hf-color-grading-bloom`         | 0 to 3  |
+| `--hf-color-grading-kuwahara`      | 0 to 1  |
+| `--hf-color-grading-pixelate`      | 0 to 1  |
+| `--hf-color-grading-ascii`         | 0 to 1  |
+| `--hf-color-grading-dither`        | 0 to 1  |
+
+Author the initial value directly in the media element's inline `style`, then
+use finite `tl.to()` keyframes. Do not use a frame-zero `tl.set()`, CSS
+animation clocks, timers, random values, or `onUpdate` callbacks. The static
+`data-color-grading` payload remains the fallback and source of the other
+controls.
+
+For a reusable color transform beyond the preset vocabulary, freeze a validated
+`.cube` under `.media/luts/` and return a block that references it:
 
 ```bash
 node <SKILL_DIR>/scripts/resolve.mjs --type grade --intent "teal orange blockbuster" --project . --json
@@ -59,17 +121,35 @@ For a LUT generated by your own script, ingest it with `--from`; media-use valid
 node <SKILL_DIR>/scripts/resolve.mjs --type lut --from custom.cube --project .
 ```
 
-Parametric math (`buildCube`) cannot reproduce real film stocks or emulsion looks. Use a CDN-backed scanned `.cube` entry or ingest a real scanned `.cube` for those.
+Parametric math (`buildCube`) cannot reproduce real film stocks or emulsion
+transforms. Use a CDN-backed scanned `.cube` entry or ingest a real scanned
+`.cube` for those.
 
-For visual selection, list reusable looks with `resolve --type grade --candidates`, write the promising entries to a `grades.json`, run `hyperframes grade-compare --for <frame> --grades grades.json`, then commit the winner with `resolve -t grade` as the final `data-color-grading` block.
+For visual selection, list reusable LUT candidates with
+`resolve --type grade --candidates`, write the promising entries to a
+`grades.json`, run
+`hyperframes grade-compare --for <frame> --grades grades.json`, then commit the
+winner with `resolve -t grade` as the final `data-color-grading` block.
 
-Smart grade is `grade --for <media>`. It runs local `ffmpeg`/`ffprobe` signalstats, merges a bounded `adjust` suggestion into the returned block, and prints the measured evidence to stderr. Stdout remains valid JSON under `--json`; the suggestion is a starting point for the agent to tune, not an automatic neutralization of intentional color.
+Use `grade --for <media> --analyze` when you only need side-effect-free
+`ffmpeg`/`ffprobe` signalstats evidence. It returns a bounded `adjust`
+suggestion without writing a manifest record. The suggestion is a starting
+point for visual review, not an automatic neutralization of intentional color.
 
 ```bash
-node <SKILL_DIR>/scripts/resolve.mjs --type grade --intent "warm cinematic" --for ./frame.png --project . --json
+node <SKILL_DIR>/scripts/resolve.mjs --type grade --for ./frame.png --analyze --project . --json
 ```
 
-Library looks live in `luts/index.json`. Each entry keeps `id`, `description`, `tags`, and `intensity`, then supplies either compact `params` for on-demand `buildCube(params)` generation or a direct CDN `url` for future scanned `.cube` files. Do not commit generated `.cube` bodies; resolve validates generated or downloaded cubes as it freezes them under `.media/luts/`.
+Without `--analyze`, `grade --for` merges measured values into the resolved
+grade and records that candidate in `.media`; use that form only when you
+intend to keep the candidate.
+
+Library LUT entries live in `luts/index.json`. Each entry keeps `id`,
+`description`, `tags`, and `intensity`, then supplies either compact `params`
+for on-demand `buildCube(params)` generation or a direct CDN `url` for future
+scanned `.cube` files. Do not commit generated `.cube` bodies; resolve
+validates generated or downloaded cubes as it freezes them under
+`.media/luts/`.
 
 ```bash
 node skills/media-use/scripts/resolve.mjs --type lut --intent "teal orange blockbuster" --project . --json
diff --git a/skills/media-use/references/media-treatment-recipes.md b/skills/media-use/references/media-treatment-recipes.md
new file mode 100644
index 0000000000..2a92a34436
--- /dev/null
+++ b/skills/media-use/references/media-treatment-recipes.md
@@ -0,0 +1,929 @@
+# Media treatment recipes
+
+These are optional tested seeds, not the complete capability surface. Read the
+shared policy and choose one relevant section through `media-treatments.md`.
+Agents may modify or combine a seed with compatible canonical controls after
+inspecting the media, or assemble a bespoke payload from
+`hyperframes media-treatment --capabilities --json` when no seed fits.
+
+## Natural Portrait
+
+Use for a talking head, interview, presenter, or people-focused photo whose
+intended result is natural, polished, and restrained.
+
+Do not use when the face is incidental or tiny, the source is intentionally
+neon/monochrome/strongly stylized, or the requested result is beauty retouching.
+This treatment changes the whole frame; it is not a face mask or skin-smoothing
+effect.
+
+Inspect face exposure, highlight retention, shadow detail, white balance, and
+whether the existing look is intentional. Signalstats do not detect faces or
+creative intent.
+
+### Base payload
+
+Start here, then tune only when the sampled frames justify it:
+
+```json
+{ "preset": "skin-soft", "intensity": 0.6 }
+```
+
+`skin-soft` is a global tonal/color preset whose vibrance math is reduced for
+skin-like colors. It does not blur, retouch, segment, or track a face.
+
+### Bounded tuning
+
+Adjustment values are absolute values in the final payload, not deltas added to
+the preset. Keep changes inside these conservative ranges unless the user asks
+for a stylized result:
+
+| Property    | Natural Portrait range |
+| ----------- | ---------------------- |
+| intensity   | 0.45 to 0.75           |
+| exposure    | -0.06 to 0.14          |
+| contrast    | -0.05 to 0.08          |
+| highlights  | -0.18 to -0.04         |
+| shadows     | 0.04 to 0.18           |
+| whites      | -0.10 to 0.04          |
+| blacks      | -0.06 to 0.06          |
+| temperature | -0.05 to 0.10          |
+| tint        | -0.03 to 0.05          |
+| vibrance    | 0 to 0.06              |
+| saturation  | -0.04 to 0.06          |
+
+Leave grain, blur, and pixelate at zero. A vignette is optional at `0` to
+`0.05` only when it improves subject focus without looking like an effect.
+
+Manual controls must stay inside their schema section; they are never
+top-level keys. A tuned Natural Portrait payload looks like this:
+
+```json
+{
+  "preset": "skin-soft",
+  "intensity": 0.58,
+  "adjust": {
+    "highlights": -0.08,
+    "shadows": 0.08,
+    "temperature": 0.02,
+    "vibrance": 0.02
+  },
+  "details": { "vignette": 0.03 }
+}
+```
+
+Use the same nested shape in `grade-compare` candidate files. `adjust` owns
+tonal/color controls, `details` owns vignette/grain, and `effects` owns blur,
+pixelate, chroma bleed, and the advanced treatment primitives below.
+
+During the common comparison, reject any result that makes skin implausible,
+loses highlight detail, flattens or desaturates dark skin, or casts clothing and
+background colors accidentally.
+
+## Product Polish
+
+Use for photographed or filmed physical products when the goal is clean,
+accurate, dimensional presentation. Protect product color, material texture,
+label readability, specular highlights, and intentional lighting.
+
+Do not use this treatment for literal app/site screenshots or screen captures;
+follow UI Fidelity below. Do not neutralize a lifestyle scene's deliberate
+ambient color, and do not infer exact brand-color correction without a neutral
+reference or known product color.
+
+Inspect the product separately from its background. Check white balance, label
+legibility, surface texture, highlight clipping, shadow detail, white point,
+and black point. Statistics cannot identify a white package, metallic
+highlight, amber glass, or intentional warm light.
+
+### Base payload
+
+Compare this restrained correction against the untouched source:
+
+```json
+{
+  "intensity": 0.7,
+  "adjust": {
+    "exposure": 0.01,
+    "contrast": 0.06,
+    "highlights": -0.1,
+    "shadows": 0.04,
+    "whites": 0.02,
+    "blacks": -0.03,
+    "vibrance": 0.03,
+    "saturation": 0.02
+  }
+}
+```
+
+This is a comparison starting point, not an instruction to change an already
+finished source. If the original has accurate color, clean endpoints, and good
+texture, leave the pixels unchanged and polish through framing or motion.
+
+### Bounded tuning
+
+| Property    | Product Polish range |
+| ----------- | -------------------- |
+| intensity   | 0.45 to 0.8          |
+| exposure    | -0.08 to 0.1         |
+| contrast    | 0 to 0.1             |
+| highlights  | -0.16 to 0           |
+| shadows     | 0 to 0.12            |
+| whites      | -0.08 to 0.05        |
+| blacks      | -0.06 to 0.04        |
+| temperature | -0.05 to 0.05        |
+| tint        | -0.03 to 0.03        |
+| vibrance    | 0 to 0.06            |
+| saturation  | -0.04 to 0.05        |
+
+Temperature and tint stay at zero unless the frames show a plausible cast.
+Leave grain, vignette, blur, and pixelate at zero for catalog/e-commerce media.
+For a lifestyle product shot, a vignette up to `0.04` is acceptable only when
+it improves focus without changing the product itself.
+
+During the common comparison, reject any result that clips white packaging,
+muddies black products, shifts a known brand color, hides texture, or makes
+labels harder to read. Report when preserving the original was the deliberate
+decision.
+
+## UI Fidelity
+
+Use for literal app, website, dashboard, terminal, slide, or screen-recording
+pixels whose colors and readability are part of the product being shown.
+
+The default payload is **none**: do not add `data-color-grading`. Global color
+changes affect brand colors, status colors, charts, screenshots, and tiny text
+together, so even a tasteful photographic look can make the demonstration less
+truthful.
+
+Polish UI footage with crop, scale, pacing, cursor emphasis, surrounding DOM
+overlays, or seek-safe motion outside the captured pixels. If the user
+explicitly asks for a stylized UI look, preview it against the original and
+state that exact UI color is no longer preserved. If a camera filmed a screen,
+correct only a demonstrated capture cast or exposure issue and still verify
+text and brand colors across representative frames.
+
+## Film Memory
+
+Use when the story explicitly calls for a warm memory, restrained flashback,
+personal archive, or film-like recollection. This is not the default meaning of
+"cinematic", and it is not scanned-film-stock emulation.
+
+Do not use for literal UI, product catalog media, technical demonstrations, or
+footage whose accurate current-day color is important. Use a separate camcorder
+treatment for VHS/REC language. Do not add dust, scratches, light leaks, film
+burns, or halation unless an owned component is available and the requested
+story actually benefits from it.
+
+Check that the source has enough highlight and shadow detail to tolerate a
+faded treatment, and confirm nostalgia or temporal separation belongs in the
+story. Compare the full moving treatment, not only a still preset card.
+
+### Static pixel base
+
+Start with this owned shader recipe:
+
+```json
+{
+  "preset": "vintage-wash",
+  "intensity": 0.6,
+  "details": {
+    "vignette": 0.12,
+    "grain": 0.12,
+    "grainSize": 0.2,
+    "grainRoughness": 0.6
+  }
+}
+```
+
+Keep the static values inside these ranges:
+
+| Property       | Film Memory range |
+| -------------- | ----------------- |
+| intensity      | 0.5 to 0.75       |
+| vignette       | 0.08 to 0.16      |
+| grain          | 0.08 to 0.16      |
+| grainSize      | 0.16 to 0.24      |
+| grainRoughness | 0.5 to 0.7        |
+
+The stronger end can flatten dark skin, black clothing, or already-faded
+footage. Compare against the source and lower strength when it does.
+
+### Temporal character
+
+Use the existing registered paused GSAP timeline on the same media element:
+
+- author `--hf-color-grading-exposure: 0` in the media element's inline
+  `style`;
+- move it through a finite irregular sequence within `-0.03` to `0.03`, using
+  gentle `sine.inOut` segments around `0.45` to `0.8` seconds;
+- for gate weave, keep `x`/`y` within `0.15%` of the shorter composition edge,
+  rotation within `0.03` degrees, and scale between `1.005` and `1.01` to
+  protect the frame edges;
+- return close to the starting exposure and transform at the treatment end.
+
+Do not use randomness, infinite CSS keyframes, timers, or `onUpdate`. Flicker
+is a gentle exposure pulse, not a flash. Weave is slight mechanical drift, not
+handheld shake.
+
+Also run focused keyframe diagnostics and seek directly to the final-minus-frame
+position. Reject brightness pumping, distracting drift, clipped edges, or
+skin/detail loss. Report the motion ranges and describe this as an HF
+film-memory treatment, not camera-stock emulation. If motion reads as an effect
+before it reads as a memory, reduce or remove it.
+
+## Creator Camcorder
+
+Use when the story explicitly calls for a creator-camera recording, consumer
+camcorder memory, or restrained digital-video character. This treatment is a
+modern camcorder language, not VHS restoration, CRT simulation, surveillance,
+or a promise to reproduce a specific camera model.
+
+Do not apply it to literal UI, product catalog media, tiny media tiles, or
+already compressed footage that has distracting color bleed. Do not add a REC
+HUD merely because the source contains a person talking; the camera-device
+language must support the story or the user's requested style.
+
+Check skin, saturated edges, fine text, source compression, and whether the
+source already has a deliberate camera look. Reject softened chroma that
+damages labels, graphics, or identifying product color. Judge chroma softness
+and grain in motion, not one still.
+
+### Static pixel base
+
+Start with the proven shader payload below, then tune only inside the bounded
+ranges when representative frames justify it:
+
+```json
+{
+  "intensity": 0.72,
+  "adjust": {
+    "contrast": 0.08,
+    "highlights": -0.05,
+    "shadows": 0.02,
+    "whites": 0.03,
+    "blacks": -0.04,
+    "temperature": -0.03,
+    "tint": -0.015,
+    "vibrance": -0.03,
+    "saturation": -0.06
+  },
+  "details": {
+    "vignette": 0.06,
+    "grain": 0.08,
+    "grainSize": 0.18,
+    "grainRoughness": 0.58
+  },
+  "effects": { "chromaBleed": 0.55 }
+}
+```
+
+| Property       | Creator Camcorder range |
+| -------------- | ----------------------- |
+| intensity      | 0.55 to 0.8             |
+| contrast       | 0.03 to 0.1             |
+| highlights     | -0.1 to 0               |
+| shadows        | 0 to 0.06               |
+| whites         | 0 to 0.05               |
+| blacks         | -0.08 to -0.01          |
+| temperature    | -0.06 to 0.04           |
+| tint           | -0.03 to 0.02           |
+| vibrance       | -0.06 to 0.02           |
+| saturation     | -0.12 to -0.02          |
+| vignette       | 0.03 to 0.1             |
+| grain          | 0.04 to 0.12            |
+| grainSize      | 0.14 to 0.24            |
+| grainRoughness | 0.45 to 0.7             |
+| chromaBleed    | 0.35 to 0.7             |
+
+Leave blur and pixelate at zero. Square pixels, scanlines, RGB splitting, and
+tracking noise are different visual languages and are not defaults for this
+treatment.
+
+### Optional camera HUD
+
+When the narrative benefits from explicit recording-device language, install
+the Registry overlay block:
+
+```bash
+npx hyperframes add camcorder-hud --no-clipboard
+```
+
+Insert the printed `data-composition-src` host over the intended media range.
+Edit the displayed date/time/mode/counter in
+`compositions/camcorder-hud.html`. The block's paused GSAP timeline derives
+its counter and REC blink from composition time, so play, scrub, and render
+agree. Keep the HUD finite and scoped to the shot.
+
+The HUD is an optional authored overlay. The pixel payload remains useful
+without it, and the HUD alone is not evidence that the footage was treated.
+
+### Optional source-to-camera reveal
+
+Global grading intensity fades only primary correction and LUT output; it does
+not fade the independent camcorder effects. For a visible source-to-camera
+mode change, use two synchronized media layers and a finite opacity crossfade
+from untreated to treated footage. Fade the HUD in on that same paused GSAP
+timeline. Do not animate shader state with callbacks or an independent clock.
+
+Also verify HUD placement and framing in each aspect ratio the project supports.
+Report whether the HUD was used and describe this as an HF camcorder treatment,
+not camera/VHS emulation. If an effect artifact is more noticeable than the
+subject, reduce chroma bleed/grain or keep the source unchanged.
+
+## VHS Playback
+
+Use when the story explicitly calls for analog home-video tape, a dated archive,
+or a visibly degraded VHS playback. This treatment is not Creator Camcorder,
+generic pixelation, CRT display simulation, or a default retro look.
+
+Do not use for literal UI, product catalog media, small text, clean modern
+creator footage, or any source whose identifying color/detail must remain exact.
+Inspect high-contrast vertical edges, faces, saturated objects, and the bottom
+of the frame in motion. Analog damage must support the story without making the
+subject hard to read.
+
+### Pixel payload
+
+Start with the complete proven combination, not `tapeDamage` alone:
+
+```json
+{
+  "intensity": 1,
+  "adjust": { "contrast": -0.04, "saturation": -0.08 },
+  "details": {
+    "grain": 0.16,
+    "grainSize": 0.12,
+    "grainRoughness": 0.72
+  },
+  "effects": {
+    "tapeDamage": 0.82,
+    "tapeTracking": 0.85,
+    "tapeNoise": 0.3,
+    "tapeSpeed": 0.5,
+    "chromaBleed": 0.5,
+    "chromaticAberration": 0.18,
+    "chromaticAngle": 0,
+    "scanlines": 0.35,
+    "scanlineCount": 0.17,
+    "scanlineSoftness": 1,
+    "digitalGlitch": 0.32,
+    "digitalGlitchColorSplit": 0,
+    "digitalGlitchLineTear": 0.08,
+    "digitalGlitchPixelate": 0,
+    "digitalGlitchBlockAmount": 0,
+    "digitalGlitchBlockDisplacement": 0,
+    "digitalGlitchBlockOpacity": 0,
+    "digitalGlitchSpeed": 0.5
+  }
+}
+```
+
+| Property              | VHS Playback range |
+| --------------------- | ------------------ |
+| intensity             | 0.75 to 1          |
+| contrast              | -0.1 to 0          |
+| saturation            | -0.16 to 0         |
+| grain                 | 0.08 to 0.18       |
+| grainSize             | 0.08 to 0.18       |
+| grainRoughness        | 0.55 to 0.8        |
+| tapeDamage            | 0.65 to 0.9        |
+| tapeTracking          | 0.5 to 0.9         |
+| tapeNoise             | 0.15 to 0.45       |
+| tapeSpeed             | 0.35 to 0.65       |
+| chromaBleed           | 0.35 to 0.65       |
+| chromaticAberration   | 0.08 to 0.22       |
+| scanlines             | 0.2 to 0.4         |
+| scanlineCount         | 0.14 to 0.2        |
+| digitalGlitch         | 0.2 to 0.4         |
+| digitalGlitchLineTear | 0.04 to 0.1        |
+
+`tapeDamage` owns deterministic horizontal line jitter, slow time-base wobble,
+bottom-edge head switching, luma bandwidth loss, restrained ghosting, noise,
+and sparse dropouts. Its subordinate tracking/noise/speed controls add bounded
+moving tape tears and control their signal character without introducing a new
+clock. `chromaBleed` separately reduces horizontal chroma detail. The restrained
+scanline and chromatic settings supply the remaining tape-playback character.
+The digital stage is used only for rare horizontal row tears: keep its color
+split, pixelation, block displacement, block opacity, and corruption values at
+zero. Leave blur, CRT curvature, generic pixelation, and a camera HUD off.
+
+These values are an original HyperFrames recipe calibrated on the same public
+Orange Cat source used for the external visual reference. They are not copied
+shader code or a claim of pixel-identical output from the external reference. The scanline count is
+mapped to the reference's approximately 127-cycle primary line pattern; the HF
+tracking math stays bounded in media pixels and uses the composition clock.
+
+The shader damage evolves from the existing deterministic media time, so it
+needs no CSS loop or private timeline. Global grading intensity does not fade
+tape damage or other independent effects. If the story requires a finite
+source-to-tape reveal, crossfade synchronized untreated and treated media layers
+on the host's paused GSAP timeline. During the common workflow, inspect dense
+consecutive frames and reject hard edge tearing, face
+smearing, frozen noise, square blocks, blank borders, or a bottom disturbance
+that competes with the subject.
+
+## 8mm Home Movie
+
+Use for personal archive, family-memory, childhood, travel-memory, or explicit
+small-gauge home-movie language. This is stronger and more materially film-like
+than Film Memory, but it is still an owned HyperFrames treatment rather than a
+claim to reproduce a named film stock, camera, or laboratory process.
+
+Do not use for literal UI, technical demonstrations, catalog products, clean
+interviews, or footage where dust/scratches would imply false provenance. Check
+skin, highlights, dark clothing, and frame edges before applying it.
+
+### Pixel payload
+
+```json
+{
+  "preset": "vintage-wash",
+  "intensity": 0.72,
+  "details": {
+    "vignette": 0.28,
+    "vignetteMidpoint": 0.54,
+    "vignetteFeather": 0.72,
+    "grain": 0.34,
+    "grainSize": 0.18,
+    "grainRoughness": 0.72
+  },
+  "effects": { "filmArtifacts": 0.62 }
+}
+```
+
+| Property       | 8mm Home Movie range |
+| -------------- | -------------------- |
+| intensity      | 0.6 to 0.8           |
+| vignette       | 0.18 to 0.34         |
+| grain          | 0.22 to 0.42         |
+| grainSize      | 0.12 to 0.24         |
+| grainRoughness | 0.6 to 0.8           |
+| filmArtifacts  | 0.35 to 0.7          |
+
+`filmArtifacts` owns only deterministic sparse dust and short scratches. The
+existing preset/details own color, vignette, and grain; the host's paused GSAP
+timeline owns optional gate weave. Keep weave within `0.15%` of the shorter
+composition edge, rotation within `0.03` degrees, and scale between `1.005` and
+`1.015`. Use finite `sine.inOut` segments around `0.6` to `1` second, return
+near the starting transform, and never use randomness, timers, `onUpdate`, or
+an infinite CSS animation.
+
+Reject a result when dust is constantly visible, scratches persist unnaturally,
+the frame pumps, weave exposes an edge, highlights turn muddy, or the material
+artifacts are more noticeable than the memory. For a subtler nostalgic result,
+use Film Memory instead.
+
+## Editorial Halftone
+
+Use for print/editorial transitions, poster frames, comic/newsprint language,
+stylized product or portrait beats, and graphic sequences where visible ink
+screening is the point. This is a real four-angle CMYK raster treatment, not a
+dotted DOM overlay.
+
+Do not use on literal UI, dense text, tiny labels, footage that must remain
+photorealistic, or a long talking-head segment unless the user explicitly asks
+for strong print stylization. Preserve text/captions as ungraded DOM above the
+media whenever they must stay readable.
+
+### Pixel payload
+
+```json
+{
+  "intensity": 1,
+  "adjust": { "contrast": 0.04, "saturation": 0.04 },
+  "effects": { "halftone": 0.94, "halftoneSize": 0.36 }
+}
+```
+
+| Property     | Editorial Halftone range |
+| ------------ | ------------------------ |
+| intensity    | 0.8 to 1                 |
+| contrast     | -0.02 to 0.08            |
+| saturation   | -0.04 to 0.08            |
+| halftone     | 0.75 to 1                |
+| halftoneSize | 0.15 to 0.55             |
+
+The shader uses fixed C/M/Y/K screen angles of 15/75/0/45 degrees, separate ink
+coverage, a warm paper base, and resolution-aware dot-cell sizing. Keep those
+screen semantics fixed; tune only amount and size unless a future visual proof
+justifies a broader schema. Judge the result at final output resolution because
+browser zoom can misrepresent the screen. Reject unstable moire, unreadable
+subjects, clipped ink detail, excessive dot size, or any treatment that looks
+like a transparent dot texture laid over unchanged footage.
+
+## Two-Ink Editorial Print
+
+Use for poster frames, editorial portraits, music/social cutaways, zine
+graphics, and bold print-led transitions where two visible spot inks are more
+appropriate than photographic color. This is a fixed original HyperFrames
+vermilion/teal treatment, not a claim to emulate a named printer, ink set, or
+commercial print process.
+
+Do not use for literal UI, brand-color-critical products, small labels, natural
+talking heads, or media that must remain photorealistic. Keep captions and
+graphics as normal DOM above the treated media.
+
+### Pixel payload
+
+```json
+{
+  "intensity": 1,
+  "adjust": { "contrast": 0.08, "highlights": -0.06, "shadows": 0.04 },
+  "effects": { "twoInkPrint": 1, "twoInkPrintSize": 0.42 }
+}
+```
+
+| Property        | Two-Ink range |
+| --------------- | ------------- |
+| intensity       | 0.8 to 1      |
+| contrast        | 0.02 to 0.1   |
+| highlights      | -0.1 to 0     |
+| shadows         | 0 to 0.08     |
+| twoInkPrint     | 0.8 to 1      |
+| twoInkPrintSize | 0.18 to 0.55  |
+
+The shader maps warm midtones to vermilion, deep/cool shadows to teal, and
+shared dark coverage to a dark overprint on warm paper. It uses separate
+15/75-degree screens, a subtle fixed registration offset, deterministic paper
+texture, and resolution-aware dot sizing. Do not combine it with `halftone` or
+a duotone LUT: that re-separates the result and defeats the two-ink contract.
+
+Judge it at output resolution and across multiple frames. Reject missing second
+ink, crushed faces, unstable moire, illegible silhouettes, or a result that
+reads as a red tint with dots rather than two screened inks.
+
+## Monochrome Screen Print
+
+Use for graphic portrait beats, posterized social inserts, newspaper-like
+screens, or a finite transition into visible monochrome cells. Keep captions
+and typography as normal DOM above the treated media.
+
+```json
+{
+  "intensity": 1,
+  "effects": {
+    "monoScreen": 1,
+    "monoScreenSize": 0.35,
+    "monoScreenAngle": 0.25,
+    "monoScreenSpread": 0.3,
+    "monoScreenShape": 0,
+    "monoScreenInvert": 0
+  },
+  "palette": ["#111319", "#f2ecdc"]
+}
+```
+
+Use `monoScreenShape` `0..4` for circle, square, diamond, triangle, or line.
+Keep cell size within `0.15..0.55` and spread within `0.15..0.55`. Reject faces
+that lose their silhouette, unstable moire, or cells too small to survive the
+final encoded resolution.
+
+## Engraved Illustration
+
+Use for editorial portraits, historical/technical illustration, title-card
+cutaways, or a source-to-line-art reveal. It is not routine correction and
+should not be applied to literal UI or brand-color-critical product footage.
+
+```json
+{
+  "intensity": 1,
+  "effects": {
+    "engraving": 1,
+    "engravingSpacing": 0.4118,
+    "engravingMinThickness": 0.2,
+    "engravingMaxThickness": 0.4571,
+    "engravingAngle": 0.25,
+    "engravingContrast": 0.4667,
+    "engravingSharpness": 0.59,
+    "engravingWave": 0.2,
+    "engravingWaveFrequency": 0.2222
+  },
+  "palette": ["#101216", "#f3eddf"]
+}
+```
+
+Preserve the calibrated base first. Tune spacing within `0.25..0.6`, contrast
+within `0.3..0.65`, and wave within `0..0.35`. Reject squeezed framing, broken
+contours, noisy flat backgrounds, or lines that flicker across moving frames.
+
+## Crosshatched Sketch
+
+Use for hand-rendered editorial beats, comic/documentary cutaways, and short
+illustrative transformations where multiple line directions should preserve
+the subject contour.
+
+```json
+{
+  "intensity": 1,
+  "effects": {
+    "crosshatch": 1,
+    "crosshatchSpacing": 0.28,
+    "crosshatchThickness": 0.25,
+    "crosshatchAngle": 0.25,
+    "crosshatchContrast": 0.3333,
+    "crosshatchEdges": 0.5,
+    "crosshatchLineWeight": 0,
+    "crosshatchWave": 0.33,
+    "crosshatchWaveFrequency": 0.2222
+  },
+  "palette": ["#101216", "#f3eddf"]
+}
+```
+
+Tune spacing within `0.18..0.5`, edge detail within `0.3..0.7`, and wave within
+`0.1..0.45`. Reject distorted aspect ratio, dense black fill that hides the
+subject, or temporal shimmer stronger than the intended sketch language.
+
+## CRT Display
+
+Use when the media is intentionally shown as an older monitor, terminal, game
+screen, or broadcast display. Curvature alone is geometry, not a complete CRT
+treatment, so pair it with restrained scanlines and only slight channel
+separation.
+
+```json
+{
+  "intensity": 1,
+  "effects": {
+    "crtCurvature": 0.2,
+    "scanlines": 0.35,
+    "scanlineCount": 0.17,
+    "scanlineSoftness": 1,
+    "chromaticAberration": 0.08,
+    "chromaticAngle": 0
+  }
+}
+```
+
+Keep curvature within `0.08..0.28`, scanlines within `0.18..0.45`, and channel
+separation within `0..0.12`. Reject excessive black corners, unreadable UI,
+large color fringes, or applying the display language to ordinary footage when
+the user only asked for correction.
+
+## Procedural ASCII
+
+Use for a deliberate terminal, code, data, surveillance, editorial, or
+source-to-character reveal. This is a real shader-generated 5x7 glyph field,
+not monospace text placed over unchanged footage.
+
+Do not use as routine talking-head polish, on literal UI or dense text, or when
+recognizing a face/product precisely matters. Keep captions and graphics as
+normal DOM above the treated media.
+
+Choose one of these proven starting points:
+
+```json
+{
+  "effects": { "ascii": 1, "asciiSize": 0.08, "asciiInvert": 1 },
+  "palette": ["#020605", "#38ff78"]
+}
+```
+
+The first is **Terminal ASCII**: dark field, bright green glyphs, appropriate
+for code/data/device language. For a warmer print-like **Editorial ASCII**, use:
+
+```json
+{
+  "effects": { "ascii": 1, "asciiSize": 0.066, "asciiInvert": 0 },
+  "palette": ["#0b0d0d", "#eee9db"]
+}
+```
+
+Keep `ascii` between `0.75` and `1` for a fully readable treatment and
+`asciiSize` between `0.04` and `0.15`. A finite reveal may author
+`--hf-color-grading-ascii: 0` inline and tween it to `1` with the registered
+paused GSAP timeline. Reject unstable cells, lost silhouette/face structure,
+unreadable composition, or a palette that conflicts with the project.
+
+## Ordered Palette Dither
+
+Use for posterized social beats, music/editorial cutaways, pixel-art language,
+or a finite source-to-palette reveal. The shader uses a stable 4x4 Bayer
+threshold matrix and an explicit dark-to-light palette. Do not describe it as
+Floyd-Steinberg, Atkinson, or another sequential error-diffusion process.
+
+Do not use on literal UI, brand-color-critical products, tiny labels, or long
+photorealistic sections. Start with one of these original palettes:
+
+```json
+{
+  "effects": { "dither": 1, "ditherSize": 0.25 },
+  "palette": ["#17121a", "#824c50", "#e09873", "#f7ddb1"]
+}
+```
+
+The four-color option is **Warm Print**. For a louder social/music beat, use
+the six-color **Electric Ink** palette:
+
+```json
+{
+  "effects": { "dither": 1, "ditherSize": 0.4 },
+  "palette": ["#080717", "#3c185f", "#7e2278", "#d9339f", "#ff6b66", "#aafae0"]
+}
+```
+
+HyperFrames also owns these named ramps. The name is an authoring shortcut;
+persist the listed colors through the existing `palette` array:
+
+| Group       | Palette ID       | Ordered colors                                                   |
+| ----------- | ---------------- | ---------------------------------------------------------------- |
+| Classic     | `noir`           | `#000000`, `#ffffff`                                             |
+| Classic     | `ink-paper`      | `#1a1a2e`, `#f5f5dc`                                             |
+| Classic     | `terminal`       | `#001100`, `#00ff00`                                             |
+| Classic     | `amber-glow`     | `#1a0f00`, `#ffcc00`                                             |
+| Classic     | `handheld-green` | `#0f380f`, `#306230`, `#8bac0f`, `#9bbc0f`                       |
+| Mood        | `golden-hour`    | `#1a1205`, `#4a3510`, `#8b6914`, `#d4a017`, `#fff8dc`            |
+| Mood        | `deep-sea`       | `#0a1628`, `#1a3a5c`, `#2d6187`, `#5ba4c9`, `#a8dce8`            |
+| Mood        | `arctic-night`   | `#0a0a14`, `#1a2a4a`, `#3a5a8a`, `#6a9aca`, `#cae8ff`            |
+| Mood        | `synthwave`      | `#120458`, `#7b2cbf`, `#e040fb`, `#ff6ec7`, `#fff59d`            |
+| Mood        | `vaporwave`      | `#1a0a2e`, `#3d1a5c`, `#ff71ce`, `#01cdfe`, `#fffb96`            |
+| Mood        | `forest`         | `#1a2e1a`, `#2d4a2d`, `#4a7c4a`, `#7ab37a`, `#c8e6c8`            |
+| Mono        | `sepia`          | `#1a1610`, `#3d3020`, `#6b5a40`, `#a89070`, `#e8dcc8`            |
+| Mono        | `blueprint`      | `#001830`, `#003060`, `#0050a0`, `#0080e0`, `#e0f0ff`            |
+| HyperFrames | `warm-print`     | `#17121a`, `#824c50`, `#e09873`, `#f7ddb1`                       |
+| HyperFrames | `electric-ink`   | `#080717`, `#3c185f`, `#7e2278`, `#d9339f`, `#ff6b66`, `#aafae0` |
+
+Choose by inspected source and project language, not by palette name alone.
+For example, `terminal` fits device/code language, `warm-print` fits editorial
+print, and `synthwave` is an intentional stylization rather than generic polish.
+
+`palette` must contain two to six exact `#RRGGBB` colors in authored order. Use
+dark-to-light order for this treatment; the runtime validates colors but does
+not reorder them, so reversing the array intentionally inverts the mapping.
+Keep `dither` between `0.7` and `1` and `ditherSize` between `0.1` and `0.5`.
+A finite reveal may author `--hf-color-grading-dither: 0` inline and tween it
+to the chosen amount with GSAP. Judge the moving result at output resolution;
+reject shimmer, lost subject structure, accidental muddy intermediate colors,
+or a palette chosen without regard to the project's design language.
+
+## Cached Error Diffusion
+
+Use exact error diffusion for a deliberate 1-bit Macintosh, newspaper/print,
+limited-palette game, or crunchy editorial treatment. It bakes a new image or
+MP4 because every processed block depends on error from earlier blocks; it is
+not a realtime shader setting.
+
+Choose the algorithm by visible intent:
+
+- `floyd-steinberg`: balanced default with organic fine texture.
+- `atkinson`: higher-contrast, more open and distinctly early-Macintosh.
+- `jarvis-judice-ninke`: smoother gradients with a wider 12-neighbor field.
+- `stucki`: smooth, slightly sharper alternative to JJN.
+- `burkes`: compact two-row texture.
+- `sierra`, `sierra-lite`, `two-row-sierra`: progressively different
+  speed/texture tradeoffs; use only after comparing frames.
+
+Run the exact processor and register its output through the existing media
+ledger/cache:
+
+```bash
+node <SKILL_DIR>/scripts/dither.mjs \
+  --input .media/videos/video_001.mp4 \
+  --out .media/generated/video_001.atkinson.mp4 \
+  --algorithm atkinson \
+  --palette '#17121a,#824c50,#e09873,#f7ddb1' \
+  --point-size 3
+
+node <SKILL_DIR>/scripts/resolve.mjs \
+  --from .media/generated/video_001.atkinson.mp4 --type video --project .
+```
+
+Use the registered output path on a real `<img>` or `<video>`. Keep text,
+captions, logos, and interface graphics outside the processed media. For a
+finite reveal, overlap the original and processed media with identical framing
+and crossfade or wipe them using the registered paused GSAP timeline. Do not
+label the realtime Bayer shader as Floyd-Steinberg/Atkinson, and do not process
+PQ/HLG footage without an explicit SDR tone-map decision.
+
+## Organic Light Leak
+
+Use for one motivated memory beat, time shift, warm scene handoff, or tactile
+transition. It is a finite deterministic CSS/GSAP overlay, not a looping
+texture, generic flash, or film-stock emulation.
+
+Install the Registry overlay block:
+
+```bash
+npx hyperframes add organic-light-leak-overlay --no-clipboard
+```
+
+Insert the printed `data-composition-src` host at the intended beat and keep
+its duration finite. Its paused timeline owns one rise, peak, and complete
+recovery and scales those phases to the placed duration. Inspect the source
+before, at the brightest frame, and after recovery. Reject clipped faces, an
+unmotivated warm wash, visible black from incorrect blend mode, or a leak that
+conceals the subject longer than the transition needs.
+
+## Freeze-Frame Cutout
+
+Use for a social introduction, speaker emphasis, chapter punctuation, sports
+or creator beat, or a scrapbook/editorial hold. This requires a real alpha
+matte; decoration may not conceal a poor subject edge.
+
+Extract the exact deterministic source frame first, then remove its background:
+
+```bash
+ffmpeg -ss <seconds> -i <source-video> -frames:v 1 -y .media/generated/freeze-source.png
+npx hyperframes remove-background .media/generated/freeze-source.png \
+  -o .media/generated/freeze-cutout.png --json
+npx hyperframes add freeze-frame-cutout --no-clipboard
+```
+
+Add the transparent result as a direct-root timed media layer and insert the
+printed overlay block above the same time range. The block owns the paper,
+tape, and flash; the host timeline only animates the real cutout:
+
+```html
+<img
+  id="hf-freeze-cutout"
+  class="clip"
+  src="./.media/generated/freeze-cutout.png"
+  alt=""
+  data-start="6"
+  data-duration="3"
+  data-track-index="20"
+/>
+```
+
+```js
+tl.fromTo(
+  "#hf-freeze-cutout",
+  { y: 42, scale: 0.86, rotation: -2 },
+  { y: 0, scale: 1, rotation: 0.4, duration: 0.5, ease: "back.out(1.35)" },
+  freezeAt,
+);
+```
+
+Inspect the matte over both light and dark temporary plates before styling it.
+Reject missing hair/fingers, background halos, a cutout that changes identity,
+overly thick outline, exposed frame edges, or a flash that obscures the reveal.
+If the matte is not acceptable, choose another frame or keep the original media.
+
+## Social Flash / Editorial Reveal
+
+Use this treatment for one meaningful high-energy cut, creator reveal, product
+beat, or before/after handoff. It is not a default transition for every scene.
+Avoid it for calm long-form footage, accessibility-sensitive contexts, already
+clipped highlights, literal UI that must remain readable through the cut, or
+any request for repeated strobing.
+
+Inspect representative frames on both sides of the cut first. Grade each media
+layer for its own subject using the appropriate contract above; the flash is
+not a substitute for correction. For people, a restrained `skin-soft` payload
+is a safe starting point. For literal UI, preserve the pixels and use only the
+authored light/motion layers when they do not obscure required information.
+
+Install the Registry overlay block:
+
+```bash
+npx hyperframes add editorial-flash-overlay --no-clipboard
+```
+
+Insert the printed `data-composition-src` host so the block's midpoint lands
+on the cut. Its own paused timeline drives the finite flash. The host timeline
+may coordinate outgoing and incoming media motion without reaching into the
+block:
+
+```js
+tl.to(
+  "#outgoing-media",
+  {
+    scale: 1.035,
+    "--hf-color-grading-exposure": 0.82,
+    duration: 0.12,
+    ease: "power3.in",
+  },
+  cutAt - 0.16,
+);
+tl.fromTo(
+  "#incoming-media",
+  { scale: 1.1 },
+  { scale: 1, duration: 0.42, ease: "power3.out" },
+  cutAt,
+);
+tl.to(
+  "#incoming-media",
+  {
+    "--hf-color-grading-exposure": 0,
+    "--hf-color-grading-intensity": 0.58,
+    duration: 0.24,
+    ease: "power2.out",
+  },
+  cutAt,
+);
+```
+
+When the shader steps are used, author
+`--hf-color-grading-exposure: 0.72` and
+`--hf-color-grading-intensity: 0` inline on the incoming media so a fresh seek
+has the correct start state. Set the final intensity to the source-approved
+value instead of copying `0.58` blindly. Skip the shader intensity step when
+the incoming source should remain ungraded.
+
+Keep the rise between roughly `0.035` and `0.055` seconds and the recovery
+between `0.24` and `0.38` seconds. Default to one neutral/warm flash event,
+never saturated red, never a looping strobe, and never more than one authored
+flash inside a one-second treatment window. Verify frames immediately before,
+at, and after the cut, then inspect moving playback and a rendered draft. The
+peak must hide the cut; the recovery must reveal a correctly framed source with
+no retained prior canvas, clipped face, or unexpected highlight damage.
diff --git a/skills/media-use/references/media-treatments.md b/skills/media-use/references/media-treatments.md
new file mode 100644
index 0000000000..b8dc0d0045
--- /dev/null
+++ b/skills/media-use/references/media-treatments.md
@@ -0,0 +1,199 @@
+# Media treatments
+
+A media treatment is a source-aware plan that composes existing HyperFrames
+color, effect, timeline, and Registry primitives. It is not a second runtime
+schema. Use this file to choose a primary direction. A matching recipe is an
+optional tested seed; bespoke requests may assemble a validated treatment from
+the canonical capability catalog.
+
+## Permission and scope
+
+- An explicit request such as "polish this", "make it look better", or "make it
+  fit the topic" delegates a conservative treatment. Apply it, verify it, and
+  report what changed.
+- During an unsolicited opportunity scan, show or suggest the treatment first.
+- Target meaningful photographic media. Skip text, SVG, logos, icons, UI
+  chrome, and intentionally stylized footage unless the user asks.
+- Realtime grading and effects apply to the entire selected real `<img>` or
+  `<video>`. They do not isolate or track a face, plate, address, or other
+  region. For region-only work, first create a separate cropped/masked media
+  layer or use an external segmentation/tracking tool; never imply that a
+  whole-media Blur or Pixelate performed region isolation.
+- The realtime treatment path is Rec.709/SDR. Do not silently process HDR, HLG,
+  PQ, or camera LOG sources through it.
+
+## Classify the request
+
+Choose the smallest lane that satisfies the request before choosing a recipe
+or assembling a custom treatment:
+
+| User intent                                         | Lane                                       |
+| --------------------------------------------------- | ------------------------------------------ |
+| too dark, flat, too warm, too many shadows          | correction                                 |
+| polished, premium, warm, cinematic, fit the topic   | preset or custom treatment                 |
+| retro, print, ASCII, glitch, camcorder              | shader effect or effect-bearing preset     |
+| obscure the whole selected media                    | privacy Blur or Pixelate                   |
+| hide one face, plate, address, or screen region     | separate crop/mask/asset or external tool  |
+| draw attention to media without changing its pixels | framing, motion, or optional overlay       |
+| reveal, focus, depixelate, fade the treatment       | finite seek-safe treatment keyframes       |
+| REC HUD, light leak, flash, freeze-frame cutout     | Registry overlay plus any justified pixels |
+
+The lane identifies the primary reason for the change; it is not a one-feature
+limit. A final treatment may combine correction, a preset, finishing, multiple
+compatible shader effects, finite keyframed values, and optional overlays when
+the inspected media and user intent justify the complete combination. Keep one
+primary intent as the creative anchor so the result remains coherent and
+deterministic.
+
+Do not add a stylized Effect when correction solves the complaint. Do not
+change color when the request is only temporal, and do not install an overlay
+when the selected media alone communicates the result.
+
+Match strength to intent. When the user explicitly names a bold look such as
+VHS, glitch, ASCII, halftone, camcorder, print, or engraving, apply its
+signature effects strongly enough to read unmistakably. The guard against
+unrequested additions does not mean under-delivering an effect the user asked
+for. Correction and polish stay restrained; named stylization must be obvious
+in the after-frame.
+
+### Translate vague feedback conservatively
+
+| User feedback                         | First action                                                                                    | Add only when the frames justify it                             | Never infer                                     |
+| ------------------------------------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | ----------------------------------------------- |
+| too many shadows and a bit boring     | lift shadows/protect highlights, then compare one restrained source-appropriate preset          | mild contrast or vibrance                                       | retro texture, HUD, or palette effect           |
+| make the product footage feel premium | protect product color and labels, compare Product Polish                                        | restrained vignette on lifestyle footage                        | a cinematic LUT or crushed blacks               |
+| make this reveal cooler               | preserve color and animate one supported effect or treatment value                              | a short owned overlay block                                     | unrelated whole-clip styling                    |
+| make it feel like an old home video   | compare 8mm and VHS language against the source                                                 | finite weave/flicker or justified HUD                           | that every old-video request means VHS          |
+| hide this face                        | explain that realtime effects are whole-media; isolate the region first or use an external tool | whole-media Blur/Pixelate only when the user accepts that scope | face tracking or masking that was not performed |
+| keep the brand colors exact           | leave UI/logo pixels unchanged; use framing and motion                                          | demonstrated exposure-only correction                           | stylized preset, palette, or LUT                |
+
+When more than one lane could fit, generate at most two candidates and choose
+from inspected before/after evidence. Ordinary correction or polish starts with
+one candidate; a second candidate is an escalation, not the default. Do not
+stack effects merely to make the answer look more sophisticated.
+
+## Seed or assemble
+
+Use the table when a tested recipe directly fits. Read only that recipe
+section. Recipes are optional macros, not a closed list of allowed results.
+
+| Intent or source                                         | Recipe heading to read                            |
+| -------------------------------------------------------- | ------------------------------------------------- |
+| Talking head, interview, presenter, people-focused photo | `Natural Portrait`                                |
+| Product footage, lifestyle footage, clean social polish  | `Product Polish`                                  |
+| Screen capture, dashboard, website, app UI               | `UI Fidelity`                                     |
+| Warm memory, restrained nostalgia                        | `Film Memory`                                     |
+| Creator/UGC handheld camera character                    | `Creator Camcorder`                               |
+| Analog tape playback                                     | `VHS Playback`                                    |
+| Small-gauge home-movie character                         | `8mm Home Movie`                                  |
+| Editorial dots or ink print                              | `Editorial Halftone` or `Two-Ink Editorial Print` |
+| Monochrome dot/line screen print                         | `Monochrome Screen Print`                         |
+| Engraved or hand-hatched illustration                    | `Engraved Illustration` or `Crosshatched Sketch`  |
+| Curved scanlined display                                 | `CRT Display`                                     |
+| Glyph-based art                                          | `Procedural ASCII`                                |
+| Realtime palette quantization                            | `Ordered Palette Dither`                          |
+| Exact historical error diffusion                         | `Cached Error Diffusion`                          |
+| Finite warm flare layer                                  | `Organic Light Leak`                              |
+| Held-frame graphic interruption                          | `Freeze-Frame Cutout`                             |
+| Short exposure-flash transition                          | `Social Flash / Editorial Reveal`                 |
+
+Use `rg -n '^## <heading>$' <SKILL_DIR>/references/media-treatment-recipes.md`,
+then read only from that heading to the next `##`. Do not load the entire
+cookbook for one request.
+
+When source intent is unclear, inspect the concise capability overview:
+
+```bash
+hyperframes media-treatment --capabilities --json
+```
+
+It lists the complete surface by family with one-line descriptions. Then load
+only the family, effect, preset, or palette relevant to the inspected source:
+
+```bash
+hyperframes media-treatment --capability <id> --json
+```
+
+The focused result provides legal controls, recommended apply values, render
+cost, palette support, and the exact animation contract when supported. Use
+`--all` only for tooling/tests or a genuinely exhaustive audit. Compose one
+nested payload from these existing parts. Recipes and catalog-built payloads
+use the same renderer and persistence contract.
+
+Treat `renderLane: "multipass"` as a cost signal. Blur, Bloom, and Kuwahara are
+bounded but more expensive than single-pass effects; avoid stacking several of
+them across many simultaneous media elements unless the composition needs it,
+then verify playback and a draft render.
+Cost follows treated pixel area as well as element count. More than two
+simultaneously visible full-frame multipass media layers requires a continuous
+playback check on the target machine; simplify or pre-render the stack if it
+drops frames. Do not impose or claim a universal hard cap from one machine.
+
+## Common workflow
+
+1. Confirm the target is a real `<img>` or `<video>` and inspect source color
+   metadata.
+2. For an image, read it once. For video, capture early/middle/late output as
+   one labeled sheet and read that one image:
+
+   ```bash
+   hyperframes snapshot <project> --frames 3 --no-end --describe false \
+     --output snapshots/treatment-before
+   ```
+
+   Read `snapshots/treatment-before/contact-sheet.jpg`; do not spend separate
+   model turns reading each frame unless the sheet exposes a specific problem.
+   Do not infer semantics from signal statistics alone.
+
+3. Choose one primary lane. Use one matching recipe as a tested seed, or read
+   the overview and one focused capability detail when the request is bespoke.
+   A seed may be changed or combined with compatible catalog controls when the
+   contact sheet justifies it. Do not invent keys, exceed reported ranges, or
+   stack effects without a visual reason. Do not run the generic grade/LUT
+   resolver first; it adds irrelevant candidates and may download an unused
+   LUT. Use `grade --for --analyze` only when correction needs measured signal
+   evidence.
+4. Persist pixel settings with `hyperframes media-treatment`; it validates and
+   merges a patch into the existing nested `data-color-grading` contract. Use registered
+   GSAP only for supported animated values and Registry overlay blocks only
+   for authored dressing.
+   ```bash
+   hyperframes media-treatment --selector "<unique selector>" \
+     --grading '<nested JSON patch>' --apply --json
+   ```
+   For a temporal reveal, use the focused capability result's `animation`
+   contract. If it is `null`, the capability is static. Author the starting CSS
+   property inline on the real media element and return temporary treatment
+   values to neutral so the finished shot preserves its existing pixels.
+   Prefer that bounded media animation first; if an overlay is justified,
+   install the owned Registry block instead of recreating it with bespoke
+   overlay markup.
+   For correction and ordinary polish, keep those values as editable
+   preset/adjustment JSON; do not generate a LUT for controls the realtime shader
+   already owns.
+   Use the canonical `details`/`effects` fields for vignette, grain, blur,
+   pixelate, and related primitives. Do not duplicate them with CSS filters,
+   SVG turbulence, opacity, or decorative DOM overlays.
+5. When the treatment calls for an overlay, install that named block with
+   `hyperframes add <name> --dir <project> --no-clipboard --json`, inspect its
+   returned `data-composition-src` host, and place it once using the block's
+   timing contract. Check for the installed file and host element
+   ID before insertion; never duplicate an existing overlay block. This is one
+   treatment workflow: do not make the user discover Catalog or separately ask
+   for the recipe's justified overlay.
+6. For ordinary correction/polish, capture one after-sheet with the same three
+   timestamps under `snapshots/treatment-after`, compare it to the before-sheet,
+   and stop when the result is clearly better. Run the normal project check;
+   do not encode a draft solely to prove a static correction.
+7. Escalate only when evidence requires it. Read individual frames to diagnose a
+   specific visual problem. Preview and render moving evidence when judging
+   treatment keyframes, glitch/tape motion, overlays, playback smoothness, LUT
+   timing, or any other temporal behavior. HDR/LOG, privacy, and brand-sensitive
+   work also require the existing explicit caveats and stronger verification.
+   If the treatment is not clearly better, keep the source unchanged.
+8. Report the selected media, primary intent, recipe seed if used, final
+   composed controls, optional overlays, and the frames/render that were
+   actually checked. Do not report visual quality from command success alone.
+
+`resolve --type grade --for ... --analyze --json` provides deterministic
+clipping and signal evidence, not subject recognition or automatic taste.
diff --git a/skills/media-use/references/operations.md b/skills/media-use/references/operations.md
index d345b25429..95b242a7cb 100644
--- a/skills/media-use/references/operations.md
+++ b/skills/media-use/references/operations.md
@@ -64,6 +64,40 @@ asset (it records provenance and auto-promotes to the global cache).
 > `--from`. Add a thin `process` verb only if agents repeatedly fumble these
 > recipes.
 
+## Exact error-diffusion dither
+
+Use the local processor when the requested look specifically calls for
+Floyd-Steinberg, Atkinson/Macintosh, Jarvis-Judice-Ninke, Stucki, Burkes, or a
+Sierra variant. These are sequential error-diffusion algorithms, not the
+realtime Bayer `effects.dither` shader.
+
+```bash
+node <SKILL_DIR>/scripts/dither.mjs \
+  --input source.mp4 \
+  --out source.atkinson.mp4 \
+  --algorithm atkinson \
+  --palette '#0f380f,#306230,#8bac0f,#9bbc0f' \
+  --point-size 3
+
+node <SKILL_DIR>/scripts/resolve.mjs \
+  --from source.atkinson.mp4 --type video --project .
+```
+
+Available algorithms: `floyd-steinberg`, `atkinson`,
+`jarvis-judice-ninke`, `stucki`, `burkes`, `sierra`, `sierra-lite`, and
+`two-row-sierra`. The default is balanced Floyd-Steinberg with a black/white
+palette. Palettes contain 2-6 `#rrggbb` colors in authored dark-to-light order;
+reversing the order intentionally inverts the mapping. `--point-size` controls
+1-20px blocks; `--brightness` and `--contrast` accept 0.5-2; `--detail` accepts
+0.1-1.
+
+The processor supports ordinary SDR images and MP4 video, preserves video
+audio, and emits BT.709 MP4. It rejects tagged PQ/HLG input rather than silently
+tone-mapping it. To animate the transformation, keep the original and processed
+files as two real media layers and use the seek-safe GSAP timeline to reveal or
+crossfade between them. Use the realtime Bayer shader instead when the dither
+amount itself must animate continuously.
+
 ## Transcription (default: Parakeet, better than whisper.cpp)
 
 `transcribe.mjs` is the default local transcription path. It runs **NVIDIA
diff --git a/skills/media-use/scripts/dither.mjs b/skills/media-use/scripts/dither.mjs
new file mode 100644
index 0000000000..e844e2b3b3
--- /dev/null
+++ b/skills/media-use/scripts/dither.mjs
@@ -0,0 +1,328 @@
+#!/usr/bin/env node
+
+import { execFileSync, spawn } from "node:child_process";
+import { once } from "node:events";
+import { existsSync, mkdirSync, renameSync, rmSync } from "node:fs";
+import { dirname, extname, resolve } from "node:path";
+import { text } from "node:stream/consumers";
+import { parseArgs } from "node:util";
+import {
+  ERROR_DIFFUSION_ALGORITHMS,
+  applyErrorDiffusionRgba,
+  errorDiffusionBufferLength,
+} from "./lib/error-diffusion.mjs";
+
+const IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".webp", ".bmp", ".tif", ".tiff"]);
+const OUTPUT_IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".webp"]);
+
+const { values: args } = parseArgs({
+  options: {
+    input: { type: "string", short: "i" },
+    out: { type: "string", short: "o" },
+    algorithm: { type: "string", short: "a", default: "floyd-steinberg" },
+    palette: { type: "string", default: "#000000,#ffffff" },
+    "point-size": { type: "string", default: "3" },
+    brightness: { type: "string", default: "1" },
+    contrast: { type: "string", default: "1.2" },
+    detail: { type: "string", default: "1" },
+    json: { type: "boolean", default: false },
+    help: { type: "boolean", short: "h", default: false },
+  },
+  strict: true,
+});
+
+if (args.help) {
+  console.log(`media-use dither — exact cached error-diffusion for image or MP4 media
+
+Usage:
+  node dither.mjs --input in.mp4 --out out.mp4 [options]
+
+Options:
+  --algorithm, -a   ${Object.keys(ERROR_DIFFUSION_ALGORITHMS).join(" | ")}
+  --palette         2-6 authored-order #rrggbb colors, comma-separated
+  --point-size      Block size in pixels, 1-20 (default: 3)
+  --brightness      0.5-2 (default: 1)
+  --contrast        0.5-2 (default: 1.2)
+  --detail          Diffused-error strength, 0.1-1 (default: 1)
+  --json            Output JSON status
+  --help, -h        Show this help
+
+Video output uses the source average frame rate as CFR; VFR cadence is normalized.
+
+After processing, register the output with:
+  node resolve.mjs --from <output> --type image|video`);
+  process.exit(0);
+}
+
+try {
+  const result = await run();
+  if (args.json) console.log(JSON.stringify({ ok: true, ...result }));
+  else {
+    console.log(`dithered ${result.input} -> ${result.out} (${result.algorithm})`);
+    console.log(`next: resolve --from ${result.out} --type ${result.type}`);
+  }
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (args.json) console.log(JSON.stringify({ ok: false, error: message }));
+  else console.error(`error: ${message}`);
+  process.exit(1);
+}
+
+async function run() {
+  if (!args.input || !args.out) throw new Error("--input and --out are required");
+  const inputPath = resolve(args.input);
+  const outPath = resolve(args.out);
+  if (!existsSync(inputPath)) throw new Error(`input file not found: ${inputPath}`);
+  if (inputPath === outPath) throw new Error("--out must differ from --input");
+
+  const metadata = probe(inputPath);
+  if (metadata.colorTransfer === "smpte2084" || metadata.colorTransfer === "arib-std-b67") {
+    throw new Error(
+      `HDR ${metadata.colorTransfer} input is not supported by the 8-bit SDR dither processor; tone-map to Rec.709 first`,
+    );
+  }
+  const options = {
+    algorithm: args.algorithm,
+    palette: args.palette.split(",").map((color) => color.trim()),
+    pointSize: Number(args["point-size"]),
+    brightness: Number(args.brightness),
+    contrast: Number(args.contrast),
+    detail: Number(args.detail),
+  };
+  // Validate before starting FFmpeg or creating an output file.
+  applyErrorDiffusionRgba(new Uint8ClampedArray(4), 1, 1, options, new Float32Array(3));
+
+  mkdirSync(dirname(outPath), { recursive: true });
+  const inputIsImage = IMAGE_EXTENSIONS.has(extname(inputPath).toLowerCase());
+  if (inputIsImage) {
+    if (!OUTPUT_IMAGE_EXTENSIONS.has(extname(outPath).toLowerCase())) {
+      throw new Error("image output must use .png, .jpg, .jpeg, or .webp");
+    }
+    processImage(inputPath, outPath, metadata, options);
+  } else {
+    if (extname(outPath).toLowerCase() !== ".mp4") throw new Error("video output must use .mp4");
+    await processVideo(inputPath, outPath, metadata, options);
+  }
+
+  return {
+    input: inputPath,
+    out: outPath,
+    type: inputIsImage ? "image" : "video",
+    algorithm: options.algorithm,
+    palette: options.palette,
+    point_size: options.pointSize,
+    brightness: options.brightness,
+    contrast: options.contrast,
+    detail: options.detail,
+  };
+}
+
+function probe(filePath) {
+  const raw = execFileSync(
+    "ffprobe",
+    ["-v", "error", "-print_format", "json", "-show_streams", "-show_format", filePath],
+    { encoding: "utf8", timeout: 10_000 },
+  );
+  const parsed = JSON.parse(raw);
+  const video = parsed.streams?.find((stream) => stream.codec_type === "video");
+  if (!video?.width || !video?.height)
+    throw new Error(`no readable video/image stream: ${filePath}`);
+  const fps = usableFrameRate(video.avg_frame_rate) ?? usableFrameRate(video.r_frame_rate) ?? "30";
+  return {
+    width: video.width,
+    height: video.height,
+    fps,
+    colorTransfer: video.color_transfer || "",
+  };
+}
+
+function processImage(inputPath, outPath, metadata, options) {
+  const frameBytes = metadata.width * metadata.height * 4;
+  const rgba = execFileSync(
+    "ffmpeg",
+    [
+      "-hide_banner",
+      "-loglevel",
+      "error",
+      "-nostdin",
+      "-i",
+      inputPath,
+      "-frames:v",
+      "1",
+      "-f",
+      "rawvideo",
+      "-pix_fmt",
+      "rgba",
+      "-",
+    ],
+    { maxBuffer: frameBytes + 1024 },
+  );
+  if (rgba.length !== frameBytes)
+    throw new Error(`decoded ${rgba.length} bytes; expected ${frameBytes}`);
+  applyErrorDiffusionRgba(rgba, metadata.width, metadata.height, options);
+
+  const temporary = temporaryOutput(outPath);
+  try {
+    execFileSync(
+      "ffmpeg",
+      [
+        "-y",
+        "-hide_banner",
+        "-loglevel",
+        "error",
+        "-f",
+        "rawvideo",
+        "-pix_fmt",
+        "rgba",
+        "-s:v",
+        `${metadata.width}x${metadata.height}`,
+        "-i",
+        "-",
+        "-frames:v",
+        "1",
+        temporary,
+      ],
+      { input: rgba, maxBuffer: frameBytes + 1024 },
+    );
+    renameSync(temporary, outPath);
+  } finally {
+    rmSync(temporary, { force: true });
+  }
+}
+
+async function processVideo(inputPath, outPath, metadata, options) {
+  const temporary = temporaryOutput(outPath);
+  const frameBytes = metadata.width * metadata.height * 4;
+  const keyframeInterval = String(Math.max(1, Math.round(frameRateNumber(metadata.fps))));
+  const errors = new Float32Array(
+    errorDiffusionBufferLength(metadata.width, metadata.height, options.pointSize),
+  );
+  const decoder = spawn("ffmpeg", [
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-nostdin",
+    "-i",
+    inputPath,
+    "-map",
+    "0:v:0",
+    "-f",
+    "rawvideo",
+    "-pix_fmt",
+    "rgba",
+    "-",
+  ]);
+  const encoder = spawn("ffmpeg", [
+    "-y",
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-f",
+    "rawvideo",
+    "-pix_fmt",
+    "rgba",
+    "-s:v",
+    `${metadata.width}x${metadata.height}`,
+    "-r",
+    metadata.fps,
+    "-i",
+    "-",
+    "-i",
+    inputPath,
+    "-map",
+    "0:v:0",
+    "-map",
+    "1:a?",
+    "-map_metadata",
+    "1",
+    "-c:v",
+    "libx264",
+    "-preset",
+    "veryfast",
+    "-crf",
+    "18",
+    "-g",
+    keyframeInterval,
+    "-keyint_min",
+    keyframeInterval,
+    "-sc_threshold",
+    "0",
+    "-pix_fmt",
+    "yuv420p",
+    "-x264-params",
+    "colorprim=bt709:transfer=bt709:colormatrix=bt709",
+    "-color_primaries:v",
+    "bt709",
+    "-color_trc:v",
+    "bt709",
+    "-colorspace:v",
+    "bt709",
+    "-color_range",
+    "tv",
+    "-c:a",
+    "aac",
+    "-b:a",
+    "192k",
+    "-shortest",
+    "-movflags",
+    "+faststart",
+    temporary,
+  ]);
+  const decoderError = text(decoder.stderr);
+  const encoderError = text(encoder.stderr);
+  const decoderDone = once(decoder, "close").then(([code]) => code ?? 1);
+  const encoderDone = once(encoder, "close").then(([code]) => code ?? 1);
+
+  try {
+    const frame = Buffer.allocUnsafe(frameBytes);
+    let frameOffset = 0;
+    for await (const chunk of decoder.stdout) {
+      let chunkOffset = 0;
+      while (chunkOffset < chunk.length) {
+        const length = Math.min(frameBytes - frameOffset, chunk.length - chunkOffset);
+        chunk.copy(frame, frameOffset, chunkOffset, chunkOffset + length);
+        chunkOffset += length;
+        frameOffset += length;
+        if (frameOffset !== frameBytes) continue;
+        applyErrorDiffusionRgba(frame, metadata.width, metadata.height, options, errors);
+        await writeFrame(encoder.stdin, frame);
+        frameOffset = 0;
+      }
+    }
+    if (frameOffset)
+      throw new Error(`decoder returned a partial RGBA frame (${frameOffset} bytes)`);
+    encoder.stdin.end();
+    const [decoderCode, encoderCode] = await Promise.all([decoderDone, encoderDone]);
+    if (decoderCode !== 0) throw new Error(`FFmpeg decode failed: ${(await decoderError).trim()}`);
+    if (encoderCode !== 0) throw new Error(`FFmpeg encode failed: ${(await encoderError).trim()}`);
+    renameSync(temporary, outPath);
+  } catch (error) {
+    decoder.kill("SIGKILL");
+    encoder.kill("SIGKILL");
+    throw error;
+  } finally {
+    rmSync(temporary, { force: true });
+  }
+}
+
+function writeFrame(stream, frame) {
+  return new Promise((resolveWrite, reject) => {
+    stream.write(frame, (error) => (error ? reject(error) : resolveWrite()));
+  });
+}
+
+function usableFrameRate(value) {
+  if (!value || value === "0/0") return null;
+  const number = frameRateNumber(value);
+  return Number.isFinite(number) && number > 0 ? value : null;
+}
+
+function frameRateNumber(value) {
+  const [numerator, denominator = "1"] = value.split("/");
+  return Number(numerator) / Number(denominator);
+}
+
+function temporaryOutput(outPath) {
+  const extension = extname(outPath);
+  return `${outPath.slice(0, -extension.length)}.part-${process.pid}${extension}`;
+}
diff --git a/skills/media-use/scripts/dither.test.mjs b/skills/media-use/scripts/dither.test.mjs
new file mode 100644
index 0000000000..fd564badfc
--- /dev/null
+++ b/skills/media-use/scripts/dither.test.mjs
@@ -0,0 +1,175 @@
+import assert from "node:assert/strict";
+import { execFileSync, spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+
+const SCRIPT = fileURLToPath(new URL("./dither.mjs", import.meta.url));
+const HAS_FFMPEG =
+  spawnSync("ffmpeg", ["-version"], { stdio: "ignore" }).status === 0 &&
+  spawnSync("ffprobe", ["-version"], { stdio: "ignore" }).status === 0;
+
+function fixture() {
+  const dir = mkdtempSync(join(tmpdir(), "media-use-dither-"));
+  return { dir, cleanup: () => rmSync(dir, { recursive: true, force: true }) };
+}
+
+function ffmpeg(args) {
+  execFileSync("ffmpeg", ["-y", "-hide_banner", "-loglevel", "error", ...args]);
+}
+
+function run(args) {
+  return spawnSync(process.execPath, [SCRIPT, ...args, "--json"], { encoding: "utf8" });
+}
+
+test("processes an image into the requested ordered palette", { skip: !HAS_FFMPEG }, (t) => {
+  const { dir, cleanup } = fixture();
+  t.after(cleanup);
+  const input = join(dir, "source.png");
+  const output = join(dir, "dithered.png");
+  ffmpeg(["-f", "lavfi", "-i", "testsrc2=size=16x12:rate=1", "-frames:v", "1", input]);
+
+  const result = run([
+    "--input",
+    input,
+    "--out",
+    output,
+    "--algorithm",
+    "floyd-steinberg",
+    "--palette",
+    "#000000,#ffffff",
+    "--point-size",
+    "3",
+  ]);
+  assert.equal(result.status, 0, result.stderr || result.stdout);
+  assert.equal(JSON.parse(result.stdout).type, "image");
+
+  const rgb = execFileSync("ffmpeg", [
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-i",
+    output,
+    "-frames:v",
+    "1",
+    "-f",
+    "rawvideo",
+    "-pix_fmt",
+    "rgb24",
+    "-",
+  ]);
+  for (let index = 0; index < rgb.length; index += 3) {
+    const value = rgb[index];
+    assert.ok(value === 0 || value === 255);
+    assert.equal(rgb[index + 1], value);
+    assert.equal(rgb[index + 2], value);
+  }
+});
+
+test("processes moving MP4 frames, audio, and BT.709 metadata", { skip: !HAS_FFMPEG }, (t) => {
+  const { dir, cleanup } = fixture();
+  t.after(cleanup);
+  const input = join(dir, "source.mp4");
+  const output = join(dir, "dithered.mp4");
+  ffmpeg([
+    "-f",
+    "lavfi",
+    "-i",
+    "testsrc2=size=16x12:rate=3:duration=2",
+    "-f",
+    "lavfi",
+    "-i",
+    "sine=frequency=440:duration=3",
+    "-c:v",
+    "libx264",
+    "-pix_fmt",
+    "yuv420p",
+    "-c:a",
+    "aac",
+    input,
+  ]);
+
+  const result = run([
+    "--input",
+    input,
+    "--out",
+    output,
+    "--algorithm",
+    "atkinson",
+    "--palette",
+    "#0f380f,#306230,#8bac0f,#9bbc0f",
+  ]);
+  assert.equal(result.status, 0, result.stderr || result.stdout);
+  const probe = JSON.parse(
+    execFileSync(
+      "ffprobe",
+      ["-v", "error", "-print_format", "json", "-show_streams", "-show_format", output],
+      {
+        encoding: "utf8",
+      },
+    ),
+  );
+  const video = probe.streams.find((stream) => stream.codec_type === "video");
+  const audio = probe.streams.find((stream) => stream.codec_type === "audio");
+  assert.equal(video.width, 16);
+  assert.equal(video.height, 12);
+  assert.equal(video.nb_frames, "6");
+  assert.equal(video.color_space, "bt709");
+  assert.equal(video.color_transfer, "bt709");
+  assert.equal(video.color_primaries, "bt709");
+  assert.equal(video.color_range, "tv");
+  assert.equal(audio.codec_name, "aac");
+  assert.ok(Number(probe.format.duration) < 2.5, "audio must not outlive processed video");
+  const keyframes = execFileSync(
+    "ffprobe",
+    [
+      "-v",
+      "error",
+      "-select_streams",
+      "v:0",
+      "-skip_frame",
+      "nokey",
+      "-show_entries",
+      "frame=best_effort_timestamp_time",
+      "-of",
+      "csv=p=0",
+      output,
+    ],
+    { encoding: "utf8" },
+  )
+    .trim()
+    .split(/\s+/)
+    .map((value) => Number.parseFloat(value));
+  assert.deepEqual(keyframes, [0, 1]);
+});
+
+test("rejects tagged PQ or HLG instead of silently producing SDR", { skip: !HAS_FFMPEG }, (t) => {
+  const { dir, cleanup } = fixture();
+  t.after(cleanup);
+  const input = join(dir, "hlg.mp4");
+  ffmpeg([
+    "-f",
+    "lavfi",
+    "-i",
+    "color=c=white:size=16x12:rate=1:duration=1",
+    "-c:v",
+    "libx264",
+    "-pix_fmt",
+    "yuv420p10le",
+    "-x264-params",
+    "colorprim=bt2020:transfer=arib-std-b67:colormatrix=bt2020nc",
+    "-color_primaries:v",
+    "bt2020",
+    "-color_trc:v",
+    "arib-std-b67",
+    "-colorspace:v",
+    "bt2020nc",
+    input,
+  ]);
+
+  const result = run(["--input", input, "--out", join(dir, "wrong.mp4")]);
+  assert.equal(result.status, 1);
+  assert.match(JSON.parse(result.stdout).error, /HDR arib-std-b67 input is not supported/);
+});
diff --git a/skills/media-use/scripts/lib/error-diffusion.mjs b/skills/media-use/scripts/lib/error-diffusion.mjs
new file mode 100644
index 0000000000..e59a9c5ab6
--- /dev/null
+++ b/skills/media-use/scripts/lib/error-diffusion.mjs
@@ -0,0 +1,230 @@
+export const ERROR_DIFFUSION_ALGORITHMS = {
+  "floyd-steinberg": {
+    kernel: [
+      [1, 0, 7],
+      [-1, 1, 3],
+      [0, 1, 5],
+      [1, 1, 1],
+    ],
+    divisor: 16,
+  },
+  atkinson: {
+    kernel: [
+      [1, 0, 1],
+      [2, 0, 1],
+      [-1, 1, 1],
+      [0, 1, 1],
+      [1, 1, 1],
+      [0, 2, 1],
+    ],
+    divisor: 8,
+  },
+  "jarvis-judice-ninke": {
+    kernel: [
+      [1, 0, 7],
+      [2, 0, 5],
+      [-2, 1, 3],
+      [-1, 1, 5],
+      [0, 1, 7],
+      [1, 1, 5],
+      [2, 1, 3],
+      [-2, 2, 1],
+      [-1, 2, 3],
+      [0, 2, 5],
+      [1, 2, 3],
+      [2, 2, 1],
+    ],
+    divisor: 48,
+  },
+  stucki: {
+    kernel: [
+      [1, 0, 8],
+      [2, 0, 4],
+      [-2, 1, 2],
+      [-1, 1, 4],
+      [0, 1, 8],
+      [1, 1, 4],
+      [2, 1, 2],
+      [-2, 2, 1],
+      [-1, 2, 2],
+      [0, 2, 4],
+      [1, 2, 2],
+      [2, 2, 1],
+    ],
+    divisor: 42,
+  },
+  burkes: {
+    kernel: [
+      [1, 0, 8],
+      [2, 0, 4],
+      [-2, 1, 2],
+      [-1, 1, 4],
+      [0, 1, 8],
+      [1, 1, 4],
+      [2, 1, 2],
+    ],
+    divisor: 32,
+  },
+  sierra: {
+    kernel: [
+      [1, 0, 5],
+      [2, 0, 3],
+      [-2, 1, 2],
+      [-1, 1, 4],
+      [0, 1, 5],
+      [1, 1, 4],
+      [2, 1, 2],
+      [-1, 2, 2],
+      [0, 2, 3],
+      [1, 2, 2],
+    ],
+    divisor: 32,
+  },
+  "sierra-lite": {
+    kernel: [
+      [1, 0, 2],
+      [-1, 1, 1],
+      [0, 1, 1],
+    ],
+    divisor: 4,
+  },
+  "two-row-sierra": {
+    kernel: [
+      [1, 0, 4],
+      [2, 0, 3],
+      [-2, 1, 1],
+      [-1, 1, 2],
+      [0, 1, 3],
+      [1, 1, 2],
+      [2, 1, 1],
+    ],
+    divisor: 16,
+  },
+};
+
+const DEFAULTS = {
+  algorithm: "floyd-steinberg",
+  brightness: 1,
+  contrast: 1.2,
+  detail: 1,
+  palette: ["#000000", "#ffffff"],
+  pointSize: 3,
+};
+
+export function errorDiffusionBufferLength(width, height, pointSize) {
+  return Math.ceil(width / pointSize) * Math.ceil(height / pointSize) * 3;
+}
+
+export function applyErrorDiffusionRgba(data, width, height, options = {}, errorBuffer) {
+  if (!Number.isInteger(width) || width < 1 || !Number.isInteger(height) || height < 1) {
+    throw new Error("width and height must be positive integers");
+  }
+  if (!data || data.length !== width * height * 4) {
+    throw new Error(`RGBA data must contain ${width * height * 4} bytes`);
+  }
+
+  const algorithm = options.algorithm ?? DEFAULTS.algorithm;
+  const diffusion = ERROR_DIFFUSION_ALGORITHMS[algorithm];
+  if (!diffusion) throw new Error(`unknown error-diffusion algorithm: ${algorithm}`);
+
+  const pointSize = integerInRange(options.pointSize ?? DEFAULTS.pointSize, 1, 20, "pointSize");
+  const brightness = numberInRange(options.brightness ?? DEFAULTS.brightness, 0.5, 2, "brightness");
+  const contrast = numberInRange(options.contrast ?? DEFAULTS.contrast, 0.5, 2, "contrast");
+  const detail = numberInRange(options.detail ?? DEFAULTS.detail, 0.1, 1, "detail");
+  const palette = parsePalette(options.palette ?? DEFAULTS.palette);
+  const blockColumns = Math.ceil(width / pointSize);
+  const blockRows = Math.ceil(height / pointSize);
+  const errorLength = errorDiffusionBufferLength(width, height, pointSize);
+  const errors = errorBuffer ?? new Float32Array(errorLength);
+  if (!(errors instanceof Float32Array) || errors.length !== errorLength) {
+    throw new Error(`errorBuffer must be a Float32Array of length ${errorLength}`);
+  }
+  errors.fill(0);
+
+  const centerOffset = Math.floor(pointSize / 2);
+  for (let blockRow = 0; blockRow < blockRows; blockRow++) {
+    const blockY = blockRow * pointSize;
+    for (let blockColumn = 0; blockColumn < blockColumns; blockColumn++) {
+      const blockX = blockColumn * pointSize;
+      const centerX = Math.min(blockX + centerOffset, width - 1);
+      const centerY = Math.min(blockY + centerOffset, height - 1);
+      const rgbaIndex = (centerY * width + centerX) * 4;
+      const errorIndex = (blockRow * blockColumns + blockColumn) * 3;
+      const red = correctedChannel(data[rgbaIndex], errors[errorIndex], brightness, contrast);
+      const green = correctedChannel(
+        data[rgbaIndex + 1],
+        errors[errorIndex + 1],
+        brightness,
+        contrast,
+      );
+      const blue = correctedChannel(
+        data[rgbaIndex + 2],
+        errors[errorIndex + 2],
+        brightness,
+        contrast,
+      );
+      const luminance = 0.299 * red + 0.587 * green + 0.114 * blue;
+      const output = palette[Math.min(palette.length - 1, Math.floor(luminance * palette.length))];
+
+      for (let y = blockY; y < Math.min(blockY + pointSize, height); y++) {
+        for (let x = blockX; x < Math.min(blockX + pointSize, width); x++) {
+          const outputIndex = (y * width + x) * 4;
+          data[outputIndex] = Math.round(output[0] * 255);
+          data[outputIndex + 1] = Math.round(output[1] * 255);
+          data[outputIndex + 2] = Math.round(output[2] * 255);
+        }
+      }
+
+      for (const [dx, dy, weight] of diffusion.kernel) {
+        const targetColumn = blockColumn + dx;
+        const targetRow = blockRow + dy;
+        if (
+          targetColumn < 0 ||
+          targetColumn >= blockColumns ||
+          targetRow < 0 ||
+          targetRow >= blockRows
+        ) {
+          continue;
+        }
+        const target = (targetRow * blockColumns + targetColumn) * 3;
+        const scale = (weight / diffusion.divisor) * detail;
+        errors[target] += (red - output[0]) * scale;
+        errors[target + 1] += (green - output[1]) * scale;
+        errors[target + 2] += (blue - output[2]) * scale;
+      }
+    }
+  }
+  return data;
+}
+
+function correctedChannel(byte, error, brightness, contrast) {
+  return Math.min(1, Math.max(0, ((byte / 255 - 0.5) * contrast + 0.5) * brightness + error));
+}
+
+function parsePalette(colors) {
+  if (!Array.isArray(colors) || colors.length < 2 || colors.length > 6) {
+    throw new Error("palette must contain 2 to 6 colors");
+  }
+  return colors.map((color) => {
+    const match = /^#([0-9a-f]{6})$/i.exec(color);
+    if (!match) throw new Error(`palette color must use #rrggbb: ${color}`);
+    const value = Number.parseInt(match[1], 16);
+    return [(value >> 16) / 255, ((value >> 8) & 255) / 255, (value & 255) / 255];
+  });
+}
+
+function numberInRange(value, min, max, name) {
+  const number = Number(value);
+  if (!Number.isFinite(number) || number < min || number > max) {
+    throw new Error(`${name} must be between ${min} and ${max}`);
+  }
+  return number;
+}
+
+function integerInRange(value, min, max, name) {
+  const number = Number(value);
+  if (!Number.isInteger(number) || number < min || number > max) {
+    throw new Error(`${name} must be an integer between ${min} and ${max}`);
+  }
+  return number;
+}
diff --git a/skills/media-use/scripts/lib/error-diffusion.test.mjs b/skills/media-use/scripts/lib/error-diffusion.test.mjs
new file mode 100644
index 0000000000..b1569158b9
--- /dev/null
+++ b/skills/media-use/scripts/lib/error-diffusion.test.mjs
@@ -0,0 +1,102 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { ERROR_DIFFUSION_ALGORITHMS, applyErrorDiffusionRgba } from "./error-diffusion.mjs";
+
+const EXPECTED_GRADIENTS = {
+  "floyd-steinberg": "00000101/00010101/00100101/00010111/01010101/01011011",
+  atkinson: "00000011/00001100/00010011/00010111/01001101/00111011",
+  "jarvis-judice-ninke": "00000011/00001011/00011001/00101111/00100111/01011011",
+  stucki: "00000011/00010101/00010110/00101011/00101101/01010111",
+  burkes: "00000101/00010011/00010110/00101011/01010111/00101011",
+  sierra: "00000011/00010101/00010110/00100111/00110111/00101101",
+  "sierra-lite": "00000101/00010101/00100101/00010110/01010111/01010101",
+  "two-row-sierra": "00000101/00010011/00010110/00101011/00101101/01011011",
+};
+
+test("exposes the eight article error-diffusion algorithms", () => {
+  assert.deepEqual(Object.keys(ERROR_DIFFUSION_ALGORITHMS), Object.keys(EXPECTED_GRADIENTS));
+});
+
+test("matches deterministic golden patterns for every diffusion kernel", () => {
+  const width = 8;
+  const height = 6;
+  const source = new Uint8ClampedArray(width * height * 4);
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const value = Math.round((255 * (x + y * 0.7)) / (width - 1 + (height - 1) * 0.7));
+      const offset = (y * width + x) * 4;
+      source[offset] = value;
+      source[offset + 1] = Math.round(value * 0.8);
+      source[offset + 2] = Math.round(value * 0.55);
+      source[offset + 3] = 17 + x + y;
+    }
+  }
+
+  for (const [algorithm, expected] of Object.entries(EXPECTED_GRADIENTS)) {
+    const output = source.slice();
+    applyErrorDiffusionRgba(output, width, height, {
+      algorithm,
+      brightness: 1,
+      contrast: 1,
+      detail: 1,
+      palette: ["#000000", "#ffffff"],
+      pointSize: 1,
+    });
+    const rows = [];
+    for (let y = 0; y < height; y++) {
+      let row = "";
+      for (let x = 0; x < width; x++) row += output[(y * width + x) * 4] ? "1" : "0";
+      rows.push(row);
+    }
+    assert.equal(rows.join("/"), expected, algorithm);
+    for (let i = 0; i < width * height; i++) assert.equal(output[i * 4 + 3], source[i * 4 + 3]);
+  }
+});
+
+test("fills point-size blocks from their center sample", () => {
+  const data = new Uint8ClampedArray([
+    0, 0, 0, 1, 0, 0, 0, 2, 0, 0, 0, 3, 0, 0, 0, 4, 0, 0, 0, 5, 255, 255, 255, 6, 0, 0, 0, 7, 255,
+    255, 255, 8,
+  ]);
+  applyErrorDiffusionRgba(
+    data,
+    4,
+    2,
+    {
+      algorithm: "floyd-steinberg",
+      brightness: 1,
+      contrast: 1,
+      detail: 1,
+      palette: ["#000000", "#ffffff"],
+      pointSize: 2,
+    },
+    new Float32Array(6),
+  );
+  assert.deepEqual(
+    [...data],
+    [
+      255, 255, 255, 1, 255, 255, 255, 2, 255, 255, 255, 3, 255, 255, 255, 4, 255, 255, 255, 5, 255,
+      255, 255, 6, 255, 255, 255, 7, 255, 255, 255, 8,
+    ],
+  );
+});
+
+test("preserves authored palette order and validates the public contract", () => {
+  const reversed = new Uint8ClampedArray([0, 0, 0, 255]);
+  applyErrorDiffusionRgba(reversed, 1, 1, {
+    palette: ["#ffffff", "#000000"],
+  });
+  assert.deepEqual([...reversed], [255, 255, 255, 255]);
+
+  assert.throws(
+    () => applyErrorDiffusionRgba(new Uint8ClampedArray(4), 1, 1, { palette: ["#000000"] }),
+    /2 to 6 colors/,
+  );
+  assert.throws(
+    () =>
+      applyErrorDiffusionRgba(new Uint8ClampedArray(4), 1, 1, {
+        algorithm: "ordered-bayer",
+      }),
+    /unknown error-diffusion algorithm/,
+  );
+});
diff --git a/skills/media-use/scripts/lib/lut-preset-provider.mjs b/skills/media-use/scripts/lib/lut-preset-provider.mjs
index 3eaac6f68b..51c600b38c 100644
--- a/skills/media-use/scripts/lib/lut-preset-provider.mjs
+++ b/skills/media-use/scripts/lib/lut-preset-provider.mjs
@@ -27,6 +27,11 @@ export const RESOLVABLE_PRESET_IDS = [
   "soft-boost",
   "bright-pop",
   "deep-contrast",
+  "creator-camcorder",
+  "vhs-playback",
+  "home-movie-8mm",
+  "editorial-halftone",
+  "two-ink-print",
 ];
 
 const PRESET_SYNONYMS = {
@@ -76,6 +81,11 @@ const PRESET_SYNONYMS = {
     "clean colorful",
   ],
   "deep-contrast": ["deep contrast", "high contrast punchy", "punchy contrast", "bold contrast"],
+  "creator-camcorder": ["creator camcorder", "creator video", "ugc camera", "handheld creator"],
+  "vhs-playback": ["vhs playback", "vhs tape", "analog tape", "degraded tape"],
+  "home-movie-8mm": ["8mm home movie", "8mm film", "family film", "small gauge film"],
+  "editorial-halftone": ["editorial halftone", "halftone", "print dots", "newsprint"],
+  "two-ink-print": ["two ink print", "two ink editorial", "duotone print", "poster print"],
 };
 
 function presetCandidates() {
@@ -122,10 +132,8 @@ export function matchColorLook(intent) {
     .trim()
     .toLowerCase()
     .replace(/\s+/g, " ");
-  for (const candidate of presetCandidates()) {
-    if (candidate.preset === normalized) {
-      return { kind: "preset", preset: candidate.preset, score: 99 };
-    }
+  if (RESOLVABLE_PRESET_IDS.includes(normalized)) {
+    return { kind: "preset", preset: normalized, score: 99 };
   }
 
   const candidates = [...presetCandidates(), ...libraryCandidates()]
diff --git a/skills/media-use/scripts/lib/lut-preset-provider.test.mjs b/skills/media-use/scripts/lib/lut-preset-provider.test.mjs
index f63d214d3e..1d4cd9f8b1 100644
--- a/skills/media-use/scripts/lib/lut-preset-provider.test.mjs
+++ b/skills/media-use/scripts/lib/lut-preset-provider.test.mjs
@@ -42,6 +42,11 @@ test("removed preset phrases resolve to surviving looks", () => {
   assert.equal(matchColorLook("cool clean").preset, "clean-studio");
 });
 
+test("complete-filter intent aliases resolve deterministically", () => {
+  assert.equal(matchColorLook("analog tape").preset, "vhs-playback");
+  assert.equal(matchColorLook("creator video").preset, "creator-camcorder");
+});
+
 test("library look freezes a validated cube from params offline (--local-only)", async () => {
   const projectDir = mkdtempSync(join(tmpdir(), "mu-lut-provider-"));
   try {
diff --git a/skills/media-use/scripts/resolve.mjs b/skills/media-use/scripts/resolve.mjs
index d61638e490..fc1f33224a 100644
--- a/skills/media-use/scripts/resolve.mjs
+++ b/skills/media-use/scripts/resolve.mjs
@@ -79,6 +79,7 @@ const { values: args } = parseArgs({
     from: { type: "string" },
     params: { type: "string" },
     for: { type: "string" },
+    analyze: { type: "boolean", default: false },
     "local-only": { type: "boolean", default: false },
     provider: { type: "string" },
     "avatar-id": { type: "string" },
@@ -115,6 +116,7 @@ Options:
   --params <json> Build an explicit parametric LUT (lut/grade only)
   --for <media>   Analyze a local image/video and add measured grade adjust
                   suggestions (grade only)
+  --analyze       Return --for grade evidence without recording a candidate
   --local-only    Offline: skip every network provider
   --provider      Force one generator (e.g. codex, mflux, kokoro, heygen)
   --avatar-id     Override the default avatar for heygen.video generation
@@ -198,6 +200,26 @@ if (args.from) {
   process.exit(0);
 }
 
+if (args.analyze) {
+  if (type !== "grade" || !args.for) {
+    console.error("error: --analyze requires --type grade and --for <media>");
+    process.exit(2);
+  }
+  const mediaPath = resolve(args.for);
+  if (!existsSync(mediaPath)) {
+    console.error(`error: --for file not found: ${mediaPath}`);
+    process.exit(2);
+  }
+  const analysis = analyzeMediaGrade(mediaPath);
+  if (args.json) {
+    console.log(JSON.stringify({ ok: true, type: "grade-analysis", ...analysis }));
+  } else {
+    console.log(formatMeasuredNote(mediaPath, analysis.measured));
+    console.log(`suggested adjust: ${JSON.stringify(analysis.adjust)}`);
+  }
+  process.exit(0);
+}
+
 // Recipes: folder-based named bundles resolved by entity name — no providers,
 // no content hashing (an evolving versioned bundle, not an immutable file).
 // Delegates to lib/recipe-store.mjs the way grade/lut delegate to resolveColor;
diff --git a/skills/media-use/scripts/resolve.test.mjs b/skills/media-use/scripts/resolve.test.mjs
index a000d81bfd..5468ee19bc 100644
--- a/skills/media-use/scripts/resolve.test.mjs
+++ b/skills/media-use/scripts/resolve.test.mjs
@@ -553,6 +553,7 @@ test("--help exits 0", () => {
   assert.ok(out.includes("media-use resolve"));
   assert.ok(out.includes("--type"));
   assert.ok(out.includes("--for"));
+  assert.ok(out.includes("--analyze"));
   assert.ok(out.includes("--from"));
   assert.ok(out.includes("--local-only"));
   assert.ok(out.includes("--stats"));
@@ -765,6 +766,33 @@ test("smart grade merges measured adjust and keeps stdout valid JSON", () => {
   cleanup();
 });
 
+test("grade analysis returns evidence without recording a candidate", () => {
+  if (!HAS_FFMPEG) {
+    console.log("  (skipped: ffmpeg not on PATH)");
+    return;
+  }
+  setup();
+  const frame = makeFrame(tmp, "under.png", "0x202020");
+  const proc = spawnResolve([
+    "--type",
+    "grade",
+    "--for",
+    frame,
+    "--analyze",
+    "--project",
+    tmp,
+    "--json",
+  ]);
+  assert.equal(proc.status, 0, proc.stderr);
+  const parsed = JSON.parse(proc.stdout);
+  assert.equal(parsed.ok, true);
+  assert.equal(parsed.type, "grade-analysis");
+  assert.ok(parsed.adjust.exposure > 0, "under-exposed frame should suggest lift");
+  assert.ok(parsed.measured.frames > 0);
+  assert.equal(readManifest(tmp).length, 0);
+  cleanup();
+});
+
 test("emitted grading block survives the core normalizeHfColorGrading contract", () => {
   if (!CAN_TSX) {
     console.log("  (skipped: tsx / core source unavailable)");

From b0d3164ddb6177c6b31634f02a908fdae607850f Mon Sep 17 00:00:00 2001
From: ukimsanov <ular.kimsanov@heygen.com>
Date: Thu, 23 Jul 2026 21:28:35 -0700
Subject: [PATCH 053/125] feat(registry): add media treatment overlays

---
 docs/guides/color-grading.mdx                 |   2 +-
 .../cli/src/registry/registryBlocks.test.ts   |  18 +-
 .../blocks/camcorder-hud/camcorder-hud.html   | 163 ++++++++++++++++++
 .../blocks/camcorder-hud/demo-backdrop.jpg    | Bin 0 -> 184861 bytes
 registry/blocks/camcorder-hud/demo.html       |  73 ++++++++
 .../blocks/camcorder-hud/registry-item.json   |  32 ++++
 .../editorial-flash-overlay/demo-backdrop.jpg | Bin 0 -> 329287 bytes
 .../blocks/editorial-flash-overlay/demo.html  |  73 ++++++++
 .../editorial-flash-overlay.html              | 129 ++++++++++++++
 .../registry-item.json                        |  32 ++++
 .../freeze-frame-dressing/demo-background.jpg | Bin 0 -> 64140 bytes
 .../freeze-frame-dressing/demo-cutout.webp    | Bin 0 -> 318286 bytes
 .../blocks/freeze-frame-dressing/demo.html    | 102 +++++++++++
 .../freeze-frame-dressing.html                | 120 +++++++++++++
 .../freeze-frame-dressing/registry-item.json  |  32 ++++
 .../demo-backdrop.jpg                         | Bin 0 -> 48749 bytes
 .../organic-light-leak-overlay/demo.html      |  77 +++++++++
 .../organic-light-leak-overlay.html           | 125 ++++++++++++++
 .../registry-item.json                        |  24 +++
 registry/registry.json                        |  16 ++
 scripts/generate-catalog-previews.ts          |  23 ++-
 skills-manifest.json                          |   2 +-
 .../references/media-treatment-recipes.md     |   2 +-
 23 files changed, 1033 insertions(+), 12 deletions(-)
 create mode 100644 registry/blocks/camcorder-hud/camcorder-hud.html
 create mode 100644 registry/blocks/camcorder-hud/demo-backdrop.jpg
 create mode 100644 registry/blocks/camcorder-hud/demo.html
 create mode 100644 registry/blocks/camcorder-hud/registry-item.json
 create mode 100644 registry/blocks/editorial-flash-overlay/demo-backdrop.jpg
 create mode 100644 registry/blocks/editorial-flash-overlay/demo.html
 create mode 100644 registry/blocks/editorial-flash-overlay/editorial-flash-overlay.html
 create mode 100644 registry/blocks/editorial-flash-overlay/registry-item.json
 create mode 100644 registry/blocks/freeze-frame-dressing/demo-background.jpg
 create mode 100644 registry/blocks/freeze-frame-dressing/demo-cutout.webp
 create mode 100644 registry/blocks/freeze-frame-dressing/demo.html
 create mode 100644 registry/blocks/freeze-frame-dressing/freeze-frame-dressing.html
 create mode 100644 registry/blocks/freeze-frame-dressing/registry-item.json
 create mode 100644 registry/blocks/organic-light-leak-overlay/demo-backdrop.jpg
 create mode 100644 registry/blocks/organic-light-leak-overlay/demo.html
 create mode 100644 registry/blocks/organic-light-leak-overlay/organic-light-leak-overlay.html
 create mode 100644 registry/blocks/organic-light-leak-overlay/registry-item.json

diff --git a/docs/guides/color-grading.mdx b/docs/guides/color-grading.mdx
index 6961d959ff..56216efbdd 100644
--- a/docs/guides/color-grading.mdx
+++ b/docs/guides/color-grading.mdx
@@ -322,7 +322,7 @@ When grading a video, animate opacity on a wrapper element instead of directly o
 | Build a terminal/editorial character treatment | `effects.ascii` + `effects.asciiSize` + an optional two-color `palette` |
 | Build a restrained multi-color pixel treatment | `effects.dither` + `effects.ditherSize` + a two-to-six-color `palette` |
 | Add an organic light leak | Install the finite `organic-light-leak-overlay` Registry block |
-| Build a freeze-frame cutout | Existing background removal + the `freeze-frame-cutout` Registry overlay block + host GSAP |
+| Build a freeze-frame cutout | Existing background removal + the `freeze-frame-dressing` Registry overlay block + host GSAP |
 | Make a presenter float over graphics | Existing [Remove Background](/guides/remove-background) workflow |
 | Put text behind a presenter | Existing `remove-background --background-output` workflow |
 | Render HDR delivery files | Existing [HDR Rendering](/guides/hdr) workflow |
diff --git a/packages/cli/src/registry/registryBlocks.test.ts b/packages/cli/src/registry/registryBlocks.test.ts
index 05f0fb3974..b21e79784c 100644
--- a/packages/cli/src/registry/registryBlocks.test.ts
+++ b/packages/cli/src/registry/registryBlocks.test.ts
@@ -1,6 +1,8 @@
 import { readFileSync, readdirSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { bundleToSingleHtml } from "@hyperframes/core/compiler";
+import { parseHTML } from "linkedom";
 import { describe, expect, it } from "vitest";
 
 const blocksDir = resolve(dirname(fileURLToPath(import.meta.url)), "../../../../registry/blocks");
@@ -29,7 +31,7 @@ function findMissingLocalScripts(itemDir: string, manifest: RegistryManifest): s
   return missing;
 }
 
-describe("registry block manifests", () => {
+describe("registry blocks", () => {
   it("installs every local script referenced by a block composition", () => {
     const missing: string[] = [];
 
@@ -48,4 +50,18 @@ describe("registry block manifests", () => {
 
     expect(missing).toEqual([]);
   });
+
+  it("keeps the Camcorder HUD seekable inside a differently named host composition", async () => {
+    const bundled = await bundleToSingleHtml(resolve(blocksDir, "camcorder-hud"), {
+      entryFile: "demo.html",
+    });
+    const { document } = parseHTML(bundled);
+    const demo = document.getElementById("camcorder-hud-demo");
+    const hud = document.getElementById("ch-demo-overlay");
+
+    expect(demo?.getAttribute("data-composition-id")).toBe("camcorder-hud-demo");
+    expect(hud?.getAttribute("data-composition-id")).toBe("camcorder-hud");
+    expect(hud?.hasAttribute("data-composition-src")).toBe(false);
+    expect(bundled).toContain('var __hfTimelineCompId = "camcorder-hud";');
+  });
 });
diff --git a/registry/blocks/camcorder-hud/camcorder-hud.html b/registry/blocks/camcorder-hud/camcorder-hud.html
new file mode 100644
index 0000000000..f5bb2d024a
--- /dev/null
+++ b/registry/blocks/camcorder-hud/camcorder-hud.html
@@ -0,0 +1,163 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      *,
+      *::before,
+      *::after {
+        box-sizing: border-box;
+      }
+
+      html,
+      body {
+        width: 1920px;
+        height: 1080px;
+        margin: 0;
+        overflow: hidden;
+        background: transparent;
+      }
+
+      #ch-hud {
+        --hf-camcorder-color: #fff;
+        --hf-camcorder-accent: #f12c2c;
+        --hf-camcorder-inset: 5vmin;
+        --hf-camcorder-font-size: 3.7vmin;
+        position: absolute;
+        inset: 0;
+        color: var(--hf-camcorder-color);
+        font-family: monospace;
+        font-size: var(--hf-camcorder-font-size);
+        font-weight: 700;
+        line-height: 1.25;
+        pointer-events: none;
+        -webkit-text-stroke: 0.12vmin rgb(0 0 0 / 92%);
+        text-shadow: 0 0.2vmin 0.6vmin rgb(0 0 0 / 90%);
+      }
+
+      #ch-hud .ch-corner {
+        position: absolute;
+      }
+
+      #ch-hud .ch-record {
+        top: var(--hf-camcorder-inset);
+        left: var(--hf-camcorder-inset);
+        display: flex;
+        align-items: center;
+        gap: 1.8vmin;
+      }
+
+      #ch-hud .ch-record-dot {
+        width: 2.2vmin;
+        height: 2.2vmin;
+        border-radius: 50%;
+        background: var(--hf-camcorder-accent);
+        box-shadow: 0 0 0.9vmin color-mix(in srgb, var(--hf-camcorder-accent) 55%, transparent);
+      }
+
+      #ch-hud .ch-battery {
+        top: var(--hf-camcorder-inset);
+        right: var(--hf-camcorder-inset);
+        width: 7vmin;
+        height: 3.5vmin;
+        border: 0.35vmin solid currentcolor;
+      }
+
+      #ch-hud .ch-battery::before {
+        position: absolute;
+        top: 0.7vmin;
+        left: 0.7vmin;
+        width: 4.7vmin;
+        height: 1.4vmin;
+        background: currentcolor;
+        content: "";
+      }
+
+      #ch-hud .ch-battery::after {
+        position: absolute;
+        top: 0.7vmin;
+        right: -1vmin;
+        width: 0.7vmin;
+        height: 1.4vmin;
+        background: currentcolor;
+        content: "";
+      }
+
+      #ch-hud .ch-date {
+        bottom: var(--hf-camcorder-inset);
+        left: var(--hf-camcorder-inset);
+      }
+
+      #ch-hud .ch-counter {
+        right: var(--hf-camcorder-inset);
+        bottom: var(--hf-camcorder-inset);
+        text-align: right;
+      }
+
+      #ch-hud .ch-mode {
+        display: block;
+        margin-bottom: 0.7vmin;
+        font-size: 2.6vmin;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="camcorder-hud"
+      data-composition-id="camcorder-hud"
+      data-start="0"
+      data-duration="4"
+      data-width="1920"
+      data-height="1080"
+    >
+      <div id="ch-hud" data-hf-counter-start="0" aria-hidden="true">
+        <div class="ch-corner ch-record"><span class="ch-record-dot"></span><span>REC</span></div>
+        <div class="ch-corner ch-battery"></div>
+        <div class="ch-corner ch-date">JAN 01 2000<br />12:00 AM</div>
+        <div class="ch-corner ch-counter">
+          <span class="ch-mode">SP · 16:9</span><span class="ch-counter-value">00:00:00</span>
+        </div>
+      </div>
+    </div>
+
+    <script>
+      window.__timelines = window.__timelines || {};
+
+      var hud = document.getElementById("ch-hud");
+      var counter = hud && hud.querySelector(".ch-counter-value");
+      var recordDot = hud && hud.querySelector(".ch-record-dot");
+      var host = hud && hud.closest("[data-composition-id]");
+      if (!hud || !counter || !recordDot || !host) {
+        throw new Error("Camcorder HUD could not find its composition host");
+      }
+
+      var compositionId = host.getAttribute("data-composition-id");
+      var duration = Number(host.getAttribute("data-duration")) || 4;
+      var counterStart = Number(hud.getAttribute("data-hf-counter-start")) || 0;
+      var state = { seconds: 0 };
+
+      function formatCounter(value) {
+        var seconds = Math.max(0, Math.floor(value));
+        var hours = Math.floor(seconds / 3600);
+        var minutes = Math.floor((seconds % 3600) / 60);
+        var remainder = seconds % 60;
+        return [hours, minutes, remainder]
+          .map(function (part) {
+            return String(part).padStart(2, "0");
+          })
+          .join(":");
+      }
+
+      function updateHud() {
+        counter.textContent = formatCounter(counterStart + state.seconds);
+        recordDot.style.opacity = Math.floor(state.seconds / 0.55) % 2 === 0 ? "1" : "0.25";
+      }
+
+      var tl = gsap.timeline({ paused: true });
+      tl.to(state, { seconds: duration, duration: duration, ease: "none", onUpdate: updateHud }, 0);
+      updateHud();
+      window.__timelines[compositionId] = tl;
+    </script>
+  </body>
+</html>
diff --git a/registry/blocks/camcorder-hud/demo-backdrop.jpg b/registry/blocks/camcorder-hud/demo-backdrop.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..63bd79fb30e7839a137dbd4c907bee3664061fe6
GIT binary patch
literal 184861
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

literal 0
HcmV?d00001

diff --git a/registry/blocks/camcorder-hud/demo.html b/registry/blocks/camcorder-hud/demo.html
new file mode 100644
index 0000000000..2b5e68cc74
--- /dev/null
+++ b/registry/blocks/camcorder-hud/demo.html
@@ -0,0 +1,73 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=1920, height=1080" />
+    <title>Camcorder HUD - Demo</title>
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      * {
+        box-sizing: border-box;
+      }
+
+      html,
+      body,
+      #camcorder-hud-demo {
+        width: 1920px;
+        height: 1080px;
+        margin: 0;
+        overflow: hidden;
+        background: #050505;
+      }
+
+      #ch-demo-backdrop,
+      #ch-demo-overlay {
+        position: absolute;
+        inset: 0;
+        width: 100%;
+        height: 100%;
+      }
+
+      #ch-demo-backdrop {
+        object-fit: cover;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="camcorder-hud-demo"
+      data-composition-id="camcorder-hud-demo"
+      data-start="0"
+      data-duration="4"
+      data-width="1920"
+      data-height="1080"
+    >
+      <img
+        id="ch-demo-backdrop"
+        class="clip"
+        src="demo-backdrop.jpg"
+        data-start="0"
+        data-duration="4"
+        data-track-index="0"
+        alt="Creator recording a video"
+      />
+      <div
+        id="ch-demo-overlay"
+        data-composition-id="camcorder-hud"
+        data-composition-src="camcorder-hud.html"
+        data-start="0"
+        data-duration="4"
+        data-track-index="1"
+        data-width="1920"
+        data-height="1080"
+      ></div>
+    </div>
+
+    <script>
+      const tl = gsap.timeline({ paused: true });
+      tl.to("#ch-demo-backdrop", { scale: 1.02, duration: 4, ease: "none" }, 0);
+      window.__timelines = window.__timelines || {};
+      window.__timelines["camcorder-hud-demo"] = tl;
+    </script>
+  </body>
+</html>
diff --git a/registry/blocks/camcorder-hud/registry-item.json b/registry/blocks/camcorder-hud/registry-item.json
new file mode 100644
index 0000000000..41ebe3722e
--- /dev/null
+++ b/registry/blocks/camcorder-hud/registry-item.json
@@ -0,0 +1,32 @@
+{
+  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
+  "name": "camcorder-hud",
+  "type": "hyperframes:block",
+  "title": "Camcorder HUD",
+  "description": "Responsive REC, battery, editable date placeholder, and timeline-driven counter overlay for creator-camera and camcorder treatments",
+  "tags": [
+    "camcorder",
+    "camera",
+    "recording",
+    "hud",
+    "overlay",
+    "creator",
+    "media-treatment-overlay"
+  ],
+  "dimensions": {
+    "width": 1920,
+    "height": 1080
+  },
+  "duration": 4,
+  "files": [
+    {
+      "path": "camcorder-hud.html",
+      "target": "compositions/camcorder-hud.html",
+      "type": "hyperframes:composition"
+    }
+  ],
+  "preview": {
+    "poster": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/camcorder-hud.png",
+    "video": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/camcorder-hud.mp4"
+  }
+}
diff --git a/registry/blocks/editorial-flash-overlay/demo-backdrop.jpg b/registry/blocks/editorial-flash-overlay/demo-backdrop.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..077705a002286dee06b75ef6b3b4d4f2a35d8a48
GIT binary patch
literal 329287
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%0A1rBD`TNJ6@M-HNGtgM3-%*B5d^;yT^_ceK^
z-`UXKf5@c9+!5FvlVIz?rmT^DJI2E=?@=_|=+`g2c&}wKLSMcRsAuwa&EFW{YSu8C
zDy2m2oiSy6QrXT#@EaF}eoecH*YSAhtNAKtc2Bdk8Ux`XG~2Y|ql(lGkMQ=RZ6D;|
zw^#d->&smtsq}Rbb)7mK(AGlUVJ!7>>Fx3W6W)ubczU#~OM`i3PK0F{WPsNBAA`sy
z)gDh^`e_3C)ZBTU%0uzumEf#*F0M9#{7Gw6##R@kcqb<viWC!5GpuCOeo~JVRYKa^
z2c9OXOz~c=0tqGYRI#pp8<^jw@D|)#*cdb*ll<+|qVj#|z~p2~kkM$*x}gmf!w}4O
zu5=^tdR^T4`_`FkV`hZJ%eDaSPkU^}l6CpiGE9Ha6GhVIAo%cV>g)@fN1?*!Ts5P}
zX-`X&dr5B`l-P%Zl!1Y|vfS1i@Q*OaKcoj3`k2w|50RIyXiT?u8}6e{NBcLnqh<cB
zhzVtDcDE4K#D=M;&>p3|KF9V?B4&RZ5>e&zvR49FE_@_H-i;5!9!`4$&fYhIoYF~Y
zUkGBF$f2E8@21u8lNcdYxq^CNyAj&sGjvCab{z%u&NXbKSsTs)CEw!n2*UV@GKofX
z%ajIHjzq6MYlp+7BG)F-bZQF+!kZCkmlE4UYl|aSWz`Sk+2xGw)KIne-?OB0<&~~t
z0;FgFF2P#l!bx+soRwLs7BcjuyED39J2X{o`7I_?vNxSPN{+}=EBhd=rBS*<WTRZo
zRS3kSc&k$jX6pr0jjqV==fIk{lgb-EcA)`#7*}`h8rOsn+sI4NSgoOG-??a@UGo-@
z(r_4AbxKL041Ofoh7qvlMfDx>>TcXI`#?P0tp{;1a{~+TF2N6{p6w%Ag;y^jSAI@n
zrC$VB4v)KRU9TmrpD0UKaasoU%U=$<pqtpQW(i7gLnrl{O$vI?D1Uc!(lfO73!dqu
zG)_OtdFL{^-Wk}##66%(h+d(A1Y9b<O9Xp=)qhhvBK}VsmwMCKIpFG^B3Hkx&mTMT
z6+Kxe;CntJR-yscY`L6;Y^q%!RjYl%3Zb3rRPpe-itVg@7*hf25xyd_YGrt7u&GW)
zi8CQpp;38>?N$!ss|waDogw;lUXQKL;h!&~X^1Yqp$L3hxOawFV6R($sk{lV$8Odj
z^x9lkp9RBIfv)ZLH`Mzp5ITVNLbwpNZWDcC<`t9Xy}KkK?z{|_PhuU{jy(jt_Vuj3
z=3=1E`Ncoj%bKPTnyCf$w1hA4tP1&<BV{79k+Vo+rPdR$`N{Oi7zS8&+U}6?qVMGF
zz;@~1BzrN4^vu~;7}AnosMvB?e2jaY<Z|fcysA$SoFTCSTx5hZ|FW80ELE92Y4bC_
zHrWjWv*grZ<A7q4*4pMXy?Qey^5>Y3%d)r>Pvy(^^NY)u_}F?U&At<!W<V<^&z!A%
z2h(kxsQFJa*UA7D%bHdcaUt8tg1!-AmY(auY6rnC%*IHNXbesy3RVoxxBRTBNg=Gm
zKkD5A>Li=Gb}d9r>w+$lVxu+pmK5$HzN!3#e^{k_;UjDirIGfVwlKMQH`bu25P0Wm
z@3fSdb$ak5YAS7mN(`%@3LV;Fw3fu=lhVmxtgj3uSFs{0&WOc$Z}%anqUFQk@f8mc
zPw?!dUH{v}`<H@Bguowd@n@`Vylqc;Wvb?Buw=zzIF<R&;WFUWR|=N7_Z1#Nueqk3
z-*XsBH4yByaHAWJFVs-~aQWz#tDNFKSjxZEG98K5p)>?-G2Zz`d_vaO`9?Hpl<aqE
zwTUJw;Mactb(c-VegH1}-oQ|T<fw=5p-G=x?EGIQZK@?o1vLr}LO6VPNW!R2;gq+$
z-&7j4{`~LcW+I}b@~VIB&inC;ovT;v%Fq{#tGHahUkNPBZaq`lII73`!b7_4#DL)x
z8tBFS4(Yk*f$$m|vAxxAR{XHk1tPx8P@ulH)wwixV-GSNpg2mI)O^J>X4-p{>7zAF
z)*|K`nZ_ae?626hjyf_;Vyo31&)if&%=v}i2`MDSzxMp-5r}#4&w)|9(VBU+nw;@#
z*FQsC<7Y!6?>y0}(SBC8TXV2|qzQNkeJXBYE}O_Kr73xvVc}rH7dl>KX!lmI-PFxk
zgN&Eg7*V5wLtGuo28h;ITF!}oZ}<v>(}tl&HfJ)XXL!A?3t+flUwsN~B&z)*2O*0+
zkeg~U*r<qrK)}2jw!%-au11-dkGhzGBL#$jJ3f0t;uwHzb3@Abx#CPyX*>kGveXVA
zbrB}JR7^(CYddJCb0eK;r@x!cBETo~sqGw@wqqn!%*$YRY?hR&tP`g&8&j)$uQbmg
zja>0JBFSRZkMmBM&WQDCD*Xqlot#<E*r$U&yPfH=VjB-j=zO&M0dUBjNhCveO;yR>
zEit5H(rv0u4(hO0Tl?ii@@W7L`%Lhpy;-ia=ZBCT{L#q~2>;8;iz-7^eZ!QdqKLM!
z+MLBa&--qAdVEvvoE&8#S>Y1wc4dy0aNeaN`CCek%+Xavz`z<yc-C;#5^h7a7$kO&
ze^PIiuO{9^2}Q>~^F%PNvKAR;SmW-tyZ6A?TMH#)JR*%$ZZoY8-Ftu5WY^<D7$w}8
z-80you{R{T;0;a4`@kW>p{@FP?Wsz0QP;$?6Fz3ltnOEleKn{|I3#M)&=rv@a#*7q
zM9QYhmOXB#s2wI74b46q5~3OKn3-aEtlSgHEroM{Dl4`K{+2Jd=&h->Z(Bmy{Df=a
z-OR80i5%DbQY7R*)QFqT#S5K24M8{d9^I#UPY<#SgQFNjgh%ZeuluXU?B0uEPgWBO
z42dv`zg;sdY{PjR0KKL9cxZk7Xis+V2-?XSrSLKwvRUck2Ww)kluZ|x`UL!hs~Ihv
z|N2o&)hP0wA5BP!{a%ZSg}=6*lHhIiuC7e@cqkchd7>t@B6Hmt^26&J3qRQ}DBY#?
z+~*mdyr<Vxvme$L&Z5r9{vnmKt%+|eJ=nDVeg6Xy6p8ff`iC@Qs-l#mz#3Jpg5tPz
z$FzH=x*P~y5tDfCxajKnJG2+k@Ms!hgOG7EmwrR{gw0pH;a7a;+`LT2q_4#)5+{_b
z-4Wl6TIpc!%#_%u^ii5d>tNPZ!Znq<L3=_HS6*Gu$T{hSZ^I`4kgTjc6aKtLq*M@X
z9?7K#1>zJ}Dmf>DqwN+&#S)=c6s-!8gvUn3y9s$U>H2hQl$cJ9+c9G6@x}q+9-X(D
zs-3C8XcgCq9bfh?wFS2XypA3>bx=C;=fWzvb7pYfDsFayk9Ooc9llX-AMt^{hof&k
z16&4+!WUIyJ|2MCmMZ&a*`?0r-R6f$wZ7Xm1$$8Ou0klH?UZMC=RrRqA^F!*T%4B&
zC>g)JWyC=*14?mcwbt3Ee>@~^Ja;_xZmI3E-MM#VF*de~seHrJOcPU&%L`)BLttZ2
zI}S2kORbD7-+<h$9GpFhIosVF^oLt}pF4Re**8z$4w|((+G+?OP2vmP2c)-Nbi}1p
zVUa$^E)3cT9^7)FE$Ww*a8DHpy@wya)^VV1Ask<OmN7cb)bAfOE6m$(7<Kn}iZ?NF
zwiQ(w=u{l!p$MwIo`lcWc~EM$ZP4=*G3PmKstIrH<@z^nY@&~Gly-`vHkn?#111SK
z1W^0LPCE%4L3GDaM>lX&^;F0?q-G5ZXo*NZ)4F!939+>)^$0M@ITbmy(8!51L@)nj
z5!p&{&A4?NBR_(;=s%f^C3HpVP*#b)Zf;$QuOOT3uxzz<!da&%v%V>Cb}u36Q(BMb
z-Rm-Q=`Iie#+wpcTJE%@@}87b*}wAfb1-*^)=9MX;oK3+vd1j>?o#~<<#9s`vv!We
zu~)caBrP6L!KiC=TmjK}Ei&${?@VTCswRBp=z>k$c}Y*!uj;C*k7#$*N2!Q5wNMc)
zKGNqLGsau>O#9Hl#UOsCN1=3;^V*(W+s)z$qedf;WsTh{ew-_fljMXh&93`+VWE3W
z=c%y%4%@X7F3w7K0reYz<h&o?xltYDHzK6iXo#LL)z0-C*vlagXLaYo52A0~qT)*#
z5jTp$!$2nvzK`V~t6IMKEcnfXSt;%otA^2rHRBG*ruEzR$eoAXsD`UTrutxG9$Klk
z-`SZv$!@NwuPBbL(CMr8N4pRLo++0((^@8~Vy=<jV`$9f&zvG;kHZE1UFiKXUok1)
z1Q|6Hvlsi5K9V%yn`Hh{6x*1{Qa`E{rxoHem%u`oGNqK1>W($vp$KYl$sX8f^Z_?#
zLWhcPUX&O&j2}B~qccpal>aWh(V1qgJY?brxgJd(vNC#1tq)&&l+JwibAJ@&bo|hW
zXI#VP!8GdGd;Etm;_Du`bRa&V#^f0IF0npj(d_Ug8yhVsV=f`{;P5Ph2--MVZg(C|
zg}}!(RkY0}lNS(@CP3B(`4hw!`BCkBYDz<GQcgV1#2K)N2!|$q>@13lrQg`e#%m4U
zv@R2u(0aU4;Ft%>UPBJbU3YejRBPDlQntUpqWjoj#zcOioqaNt+9J%;D{eU6WB2r9
zH*T`8p$Zd%Y{FzUK<#<GXUEv}!>F~)m=diSYRBN~6DXnwT5Sj;mKYK9+=#<9)0~z$
z_kwCL$@%twRs!g`PQ`;ZG-f+qyMLeULmD+)Pa##=N+a)~6cTJ|l(9FWXZ-qAq*YZ9
zds0}4^fO&rT${6&u&f<S*ofK%ACgQ4ml<}2mq;_0i|cfF-o9Fx^ywLxb^Bt+9(pJ!
z2WCtjQp9YN{+O|oRdYFETd{m&deoXCHA+*X+M0}R<0R(Gl$#u5otXB0mD@%OH#_$5
z;8y531`qB{4P5IwrjMRjJ;-DF=q@lYN>a0jzF&8K!T^M^m#*{eC6UxhgFx-T2|hi?
zZCuujIhHoS80)qrspDEc4G;h(H$JYAK|}3x+sjc?$<5_V;_eI*`>nbZ6ld`BIz7c!
z8*u2%wvf?f!WntTP0Oz<IQq&>lg_(V9QHLOZpMGL@s+J$nM@MGur?u!a>Ad__!&7C
zQ8}UlWtBzM8BGB;3ygP^%S)y5mLh^G=G-YLGrTlNA9+8a{2U2Fa~O{-Ea-QApNNR5
z&=6>~VAz*mCY3|7JN_Df!*cu6@ju*+q00!;3CVY7?wh}#)$cSPRZ9aSRs$OoMtytA
z{y1^HXs-qiZvR7C*t(Y-+C^M1at|K<e0$d1oh(A3|Be-B^d!B%@U6JxG}qL5d)F<H
zl&S8&U<=`Y8?il9v^(SzFhi@DAkmsPD1>^H$TnZPc{cJt=mr*M5)$KQv>JXa{ysDU
z##H1|#HvP`1tXO<@(FZHGcfN=`<G7Ph)k>Ezs`H<tS~()reUtEa_x36cVJ-Zw#;i&
zRvx(XT-;v%Lfkifv=jUpfXBy|dO`>@ktAt2(~rLy6%)MsB?<!f1lA!Ya$1FHzpF@i
zOSbCDzWN_1E%#SLhNpVteBQWkm%PR}4+B(nzQ)=`G)aUOiL7QmcZPq`%CYLKFCo_%
z?6YuSph5+t0?G0C-XcxK4hi!!U=HX^%dv<*DdWkG-l}UQXTH3>o3Jbc;bZDn5IQVa
zW(jJK(Jv9`s$1za4+_KzbU3(9=~QxF$}y}4m~C>>+px^I-D3UNUj4o)oF(G+y6Grh
zsoiFIdrVjOuZ>(OV6>yHU0x2C#&q=HbxFC%6PeNrtGXnUJ+7hE+S<T|&aY9h`>i9x
zsUwZlQ*tWa=eRCrnN>fO-r$JCRc{~b8s|)>-UM8uq^S@N&g5(<3_T6D_By2>4!)Mc
z8^Phx#FVabBE$SyGD^B=Y|<I;49ZiOzG0*U=g_jx>(JbDr{GqisKPt6G`a_gi=V0M
zb1UL5Ua^&G3umJeTer&2I#1_I%e!W2E}<8uM&8TLE5UR|Izp=`we{_O)C>wZZi!u+
zofYZBx|;z}vRl%~6*;1u!eHy=t?llNfE>u))>h`G?s-84>1dj9T`SM&V1`@82Cq{f
zx~ztWI8C+p`98e939~E#{(Q9MFWOT6ZNVw5rw~(2uK=!?1C76PZgg4|{c<hH9PoXV
zq&nE}1+FrFHCF7EZW*_>FmWOLPzHKff@bBpI<ppkuz3nIgp7qTTPk|c(S%+o&3Go9
zy=i#KnOnTNSed7!c6D@E826Z4Vh_5^E^C`yX)8Pk4Z!}^@^Ct;v}E!@C}#CJSEW~_
zY`bYjlsKPz<V~CXJ7VA>58=(|Nni`r0HBP|v&Ld2v^})Ec?;p98o*N5$u8+%g{b)6
z+PQAk9<=|Ry$9ILu@ydlfE?7ld8od4<|z|PnF)smedR7jVcBKksSfD&6dZ;Bus9nm
z{!2I}qnh}&6C9-wX3clE?A&-TCXOwB&%e3fW3=;ke81z1ZTXoqyQ4BY5%p_s>;OD<
zhpU-?Nc&76*NI{TSohh(I9RS@lBQ@n^jyp>t9@rj1YqWJZ9ay8%wMSXEdN8Yyxo8g
z*2dV2+Hjf`zHg&AAXW!zX6V;r?&TCb%bg9`o#nI`w$``$FmMVv#9t-LVFBmW6yg{g
zlSZ%g^RR18n5y7IFB#lk<gisz^N9|Bdrx~QRVk%P#Iv7>Rn9e3V*J#QJp0h+F*?Lm
zd1?7$q<5-7ygBc+V^Kiuosri4*z1%UF~RMgg|T4yb0bNi<2=j*-~C{SP0%X}eE|av
zZUQ2IVbv4uhH#@3UokR>VH*5pk@t(Sq`-rMve#Y6ijE!Z?gTVu&V)Wns3Tlyo%9Ec
zn}8s#)hJ=jE1RAYP!s{{c+4J5iFTM~+Nxvn1Vt7(CHJlQ1~(=*mY%tw5=wdOi{du{
z#VakVa(v!tBy%jR(pUp;I-a`AG|TuLhFF>f--aJ1CNdMMHfHQL#Ty*tv~`(|C2$5#
zdC{#whOh-<p=Rj0aU~5UD+SC*dZ9sdRUQnJ_sGqAV_t?m>vhT%hm$%kqQ$tPiXR2;
z#+N${l5<5|Rtm%k2_7H##c6M%^gLR4D%(tez(1DuC4Y3|6NyG|aRzkCaT#gow<pow
zKs;1MFqrhDG>)3(Zt<i{T{ON|SQr0}tey>VEnm~@kn6$|E0PLjQCMaOf4ANUJ)cxy
z)TZG5hH>4yZv3Wp*5s|L1I@Q0A0t1Ps;;(80E`0E3r%^Fn4)x1@A9_X8H#<D(Em0z
zwhq2?+Z&sLvG?-R@}`gSDKA4AHPKWo^66D&P{Kl}!AO*#s)!ldrFlkM&;UfD6(k*b
zj13g6WXi8jaVGpFOe76G&3Mlhr-eNzua@q~Ej$MUm3Gr|U^vcaOr`nO20%Qvdf06e
zN@eXhQkX^6QFrkCbkS*K7`&1WW}PEACU^!sDi6+G7S`&-)*JMWUmdMI?eRX36smhW
z<<+RMyqNz~R};uEWpB8RGZe)v>m*PNvX#R{58(5ldj~5qY~L~hDsIyn6ei;tYE~^T
zd+N(Ye6B9YZL(c|VJc50d|zY)@Y49yB3oG;IY7c9-DF5t%%;y$>Mv{i4wewA9Un>?
zq$QOz&lZLjLS|}Wp@)1HRFSG|UCIDu4rx3kum4r7ZmxR-oximwBrUPMN8?U^!{CoL
zq4pDmz}HXmJ6hK>rrM1y#HG6;8PY7T;O=2?CZHy@yQ1NSB(fM|MF?L752U<Go$~B4
zLpXErS8xAL9wbGlVqLS<9pV1XNOJjtNDP5<qE=YZ4)Vtj@&`>~yEw(iO@r^;UdZZb
zgjSYrto=hLU*QmTO&k27e^i-5<b^)VEHGMtkx~_PutK2%R!BH9Pa@rj0<fa0QS>M(
zqr14|s;60rSzd&XPyLzUF}91$)0GvV$i!042aNs+Wu-RIku7)NkZ+*hL%E>_0@72f
z04%Dv1iEM?D!L=>iBfymxGYn`9U@zXgSiFA7;s#$FgQW)D#tY2?eHMp1b5Ai@awA;
zT^FB`(0TiJ-5GqTzKECU86jfPHM~kYd&JxfY3N@Wf_99+7fnRv6;hnP+>s#4Ne<(`
zR2DCs^YP?1xQMQd*jdRX4y@%~PU`pGdmr$*lE@|5IC~O!rLuHr><I9dPsEfdJ6E73
z=p4-W7Yy22jfvPU@Kr4BXFro3mruH1ndh)oS!&dg$vJ+hZpvEYZCvp1T>3Nz(6#i`
zRoS2AH8`q)|9l0>iFv4Ce!aBPbei}$IF7hq(@^wQr2fotYv1#?$;v8KXg@z2THZzr
z4#(sqU?g;8LqgdG4zjS+3(HC6M>$#~vXEK*Y%gDZbBI3HTrD>VN!BI`F7f$U=9B8a
ziVHPJ$;j^FL>K^g$YhE40L%J@D|G(T;PHKcD5qw%XnHP<6vhhIB#DR9kfCA9V+po~
z;JMDEA*Y*KdMO);E<s-vcjsrZPX{z1+4ZQ4UEARdsmd5BWvw+d^zYJ0l`2RWSSM0Z
zk@^s5FY7A13hlVJxk<Ai+%f=fR-96+m)?!fdD)85i}Z`aY;Myx*Hw7$W%1skh_Pk7
zzoD!33B~Kb3u<XA8WsA)WPz(jYx3`1Qkkf2#C?Q#;5N8;xD8z?L!{#1Rkvbcjh44)
z`xoZ{TlW;A#N<9Ilk7cIu{N<vBk|%J{@3spINcdf(6F+tQS=kqR(hv2Qg#_BUDFIq
z=);!_uB@VkXZigaV?{0dz7C*X%d3XyB!C)jkBP}6pu4mvBK@cp#M;n%Ifuvl%!I>=
zHZ_wbqH0@n+_YfmRtayd#-hfUGtxs(W_t4@rY6UPseM$~#vuZ8iPGjE1$<k5neB}2
zdFdNCVQ}TM+Sz`lJM+1;Fga=+OqfO?nX!cVn48@LpPO);vm^g{4zKJSwEsz*ee37I
z_>PN8%VJ8BW3popo}*d(eo{jf&Xl%Nf-Jke!Jv#bkVC#W4QQid-)8T+C=gfK%Dp)n
zi*Kk(@N6$ja~0u0)qs>R0OqP2PX8v8q+|=^;`&s&nN671*-zLgm{MWVyNiHFJWyCi
z=ed~xs-nv6mSXBgJj{Gb#JGqD-sq3Pkptwqa$cVoe&eNlK<v7EoRmwL3%sWp8wq@8
zm^Dv54I-B{PcKdIvv1*kK8T8|U-xD|#U~KCLQCq&ki<DX7C+R6Q^}FjEJT=$snJ{f
z-fh!=DzM=Z&+@7VWep+l(5@qX8Pvq=2hTDRi+rHnC&4kf@(MUA!#O-Wh%k>Py{a?=
zaE?q7gO5xWIna{tnGC|C5}Qg{^bZMn;UCh~^S9GfA=|*GKm!Df<U+DhXZ?n$C{5lZ
z=e32XVoVlEWp|$xU`q0IvUM+pMN3bPmo|V(LTMys<i`ZW|Hate)A7WsbIcB`#7b0r
zjbqb#kFuiVsG~_#W79Yxmc4QHa12;$U;pm3+_^BZwyc9CMeEiIyVzjcF0U-L&$@P;
z3Sn=|@okFH`#iSJIhvxen!@U>wj(uzKF2~sTo<tkFvV5tOeh!%{hdSV0M-e}S_p*k
zjI~RzvFK_kj(WCHM%sE-vO0K0DDB;?n2HIcG@NuBfCWk$E$&u4eNRZAEW}rA>2ZIT
zmuGV}*;aaLT`IR31*d)>XZrr2G8XTB@xCo9F9Ei;*UhnDM)!u#9bV`Tw+&x90L_I$
zHn>k+oo-`FH#-dt(C|&l%pehIR4iwV#;`FyYfug;NWr=WYBj5udxvkh$X6`bs!>dZ
zVjr`%6;D{E@6d^sLlJ1}e%D+jZ=z<91N`!Eea1LrUk}Ey8TELhD}pNa=dYOChXL_(
zA$FVPlJk=;66H*fju+XVp150VvuB52WdCZ<<m9P+!CvWQ55$0YA(BE`%Z0L`tQCae
z`V}e17ozk%Sd6mK1-MMK7OBnc^HCNR0xb*$v3n}peoA&HcjpWMD;o#jf&OaOsY2H$
zSjq7)dq|`jv3RLooV&xhj@CzE`=1ICDM}OEZRG6-r98Qs>&L6<x>ccU+{reC0jv8<
zPW7pa6?9(;?H~`MQ%voHmio}-J<Oq&GV@#AW7rade1%LUFd!*m#gY?E<YLLk?nz|`
z*NZK0MLc^0V05Bl-E5X~q<3^4RlW3kz-qTg&Di(GvyZ|Z1m*#Wj60++#tk?%29=VC
zVXyX=@79Jo*f`Ne8|;m{-lqN#o3_{Rp*zuIeC+=-F$Jg{an??#7Vg!K$f{}VF5Y1X
zF@*vU4aGv(#*_I=9JBuBE$;UzHhC-y)jJ^8ZZWKSLb9Tai-j$ogTwK>9KqbGH!&`T
z5zK?L{-sx0ake%124l!<I>H|hl6C+ppq>RLw+Z$ur5ML*W~M&wBYjYe{`8X0e1}u^
zRVwIs@k5C%U#@She-A5DIjNoQ^L`e_4zLXvj_{aXnF<yVFM<40keieJnG`vu!;e!?
zd}nRg5rNJ0$y&&$P@$>tfxo%>CfCyVzAxrf@%0PEnb)R1?~NlKu*DKbgUC1iX@sVe
zC1Cm2-NWR0x*?NB%nR!xTnZ_XPSnICJcR%%Vi`KrB&km|Dq`ekokfOBW?=VmlzcLZ
zbK(sHmMp_=tq!_%BV0OGu#|`XGPZQvsy<%grQTGLZa=<m73G)yBxDL_v2k%VqF^Fj
znjEO`Zlx^B#avXGu~^B=kR;lXra_U&c)o-$pwRg<JO9Z?DHWgxW4a=7=73mp<9kWa
z?D7>s%Y-TyYUl*tUi}+`p6{tPY%LKnQPfH~Hc%S(YCj$HtITt-$*5jT=3)yUDWFGq
z&tW{&Jxx9KT{nYA&S=O-T3>55ZHY`$1>cYYMFG+8;bR8?A0PgKKl3p(5go$MsX$lQ
zqGu#f-f-Mwv<tGukCjx~xe6iQ<E+gD8u9VHsp(wzz$waX7sAvfWGCq(>1m&m@M2O9
zHF-~`dLLRu&^|PR;h3K&tmf~=dES}Kei-hxWboD=wY-edM(jdHpoM5jZtWzSrG|~Y
z`9wB?Exh9bVC-Zl0$FMDvM=DT;c!G!X###FKxg5*X+FxcZXZ`YH^3M_ph)XEVChe$
zfH^hRQLNUlb8yBduk;WR8uR6d>ABZDAUjvIrv$OFbKKBGm+<DY?DwJ^B~-Xq@Vum@
zryZqOG``!j*ZO?5ApaG=wBJHQ^J5}|6sxW5TkBNhS70EGqRyZeQ2{FuA?l#$jAlmt
zC+%$5qH*vs>geF}F`~ag^vTNaOGP7{4Lg1O^q)aSuK>pbFVp^9LK`MI2HR3Ym}L4o
zA^yvMxwkJ8b|_0T{!-fhXNzh6_WR^Nl}BB@=^s+uz(1sl(|<@ikS}<6h|-m$vHxtM
zOMl|cUMhZO%zu(frbbt*dtvx8(&Bu?cBjrIbm<EC76V=SkI5SK-xl4nl2c>#9$9BJ
zQaUAsC*|X-k3npTDL_VBDcgLx|5nL=0U>l%D<F#XTk4FrDAouZiH2=HO4f#TTeUPX
z%a}~mowt%RkANr!tEg8=oLS>jSnnRQ^5L4N4(U+&D^TyM&Q}s18eJfCfps{c&?e0p
zt3!2+e5Z4gPsHF6rr+Gs+|_~Tik&qU283WJP3GhBpL_@?HfSlngK0O|PTIYFx~pM!
zLk)mZ=&hUg3*Z_u>fDn!jvEV?>B-rvPL1KaUP{ri{zj!1vmTPzzmZ9QPnMaR{Yi=y
za2dbVL8!8wQcYKfAvMF*n#UaeM3O76vC6uw5E-91e88Ba4(G7m2+aYd-|~BO<KfR}
zTnGXx?=os`tW9HADi^iO<LCvCaYW1T<|r7d9SUUf@9;70c1Yi8V}2*m5tq}!AEUf!
zGl?b=FJuKZ@>g{`pqE42{}h{rp=bUUpwia5QL)c;tGohQg{6q4FnMrbQ1F3*?wq@m
zQSD`#u~<NQC{0Q%0?0CvVzTfP+-o)MQcXX@FT{&ScX2Bx3IC6&w~T7z4ZD6RrKM1y
z#flVnr#Qh~0t9y}8l<>Gp@mW?u0aApgF6J5wpfZglwifJxNA@T&vVXs-!EC2tjU+m
zn#q0dYwzC{Z1;81n>2ROKx_j@e~=gsGfh`FN?;XFHyWA-S1FC*nzp!zPNuHPYcgp&
zJhhFBRye)OZWCMYix29NI=fpwvI}3jr}@~4WTk0X@8k+hx3vTsG&!*+ho3F?_zr2=
zAZA03S9Q_rDkRpNjf4cuV$9>9W&4fE;jMp&$<6ZAiWm5hFVna2Kts1p-ObTA{k7;A
zEP3Ph+9E1!fXV%vojkrhnFhQ7L#IZxJ~@AlNgoyX4dpD<nns>hL?uY=5Uo>?7?-5#
z(^9)!t}BupU<BG71O#I?QVib;SufwI1_BP$WZblxeQ=pb!#I1@dihDJ;7HH@I+)3d
z0e1joY`(osZFPf64V#Fha{mt)z9+2G@}UTw4Lyb(Z+421LuyVJKThs*qrqYQ9X93%
zZmx(obJpBb)^n1)LY|Yj)9?Ngb@aU=lzj6KL)mdrLkwk*!>%K%dP%X{y_$M7)AQDX
z*5}}1?76we;&oTY@fc0LdB^g)`2nlTN>l5sr9P7Dy~Fcv3QZFx3_co`z?bGQyNXYK
zE;#Z+eM3McG=7!B7965#dj~K(YiQs81YVE0sxrA6b352F%^1)V)3p69JYej|P$<Uq
z>K9ntIapCxEJ!$K^+VnahSw|qsT$qs{w8#}E)Um@dZ4#W%ALqq3fIZz&{-hhPP1V)
z_k+Y{og*&e%g|USgP_<7aRuMQpJ?pGQvWQmIy?2)A<?yE`=_niIlF%tfWEl7&E`L6
zpYC5S1*_TXjP>=kUn-Y&t(sTmn@V%c0{kO)U?o0|3od*gFpl^*sNT&s2*ijjOKs!(
z_zm63qcoud>D}n?;P0G6@TAKx$M3cxuSm~kd!7_v{y3`i*8&w$S2wt>t@fMxSPe@q
zHBcCUX<i1+purJK;-{Y+k52~Hc})LqOV{1hBPk#$K>Ls}Z)cH=EpFuVcW>~CApW+Z
zeNL#Qt-LnDc%ZYzQF-Bqja#FG*qi#nbAU7=puYQhKuj_Rt?ficyCvUHIio;vHm(!$
z8p1k3r6j!_mn9TB^`~=jo7~R7%WTnDf~gcLzIfrypt;e@j-35maj~VYehCQ)uYVXh
zqGLZ`t_Lv1rmPL&1s5t6a@}u~0k({4bKL|ps=wlM1OiUgiwj?o)jy67ec?o>OYAI`
z<n@IYY#W=0li43ULv>R1<y6Po?4W8sREMKxTl_JudPP%#b{1XlF4b3yK9!|NAo>km
z&02SdxH`%wr~f#-2#3<CFC%~iLq9rF=loy3*E?jieDO-L0(<eAqXw@qs07J0eltAT
z%`#KXF43o3?e3)2TY25BZOh3q%gj<>4p+=K<MbCV5rLvWyE_*BV?3YxuMBbI^z<As
zm{Mw=dWjIZ1;*;kvm6!X+{w;#P62gs^r>1UYDHHmN=FSFp<`z-^S->~Axr$~)VCEV
zaN+NhfYYN%^k6)4=S1VG(|P2faOC`&hyP-zu<z($Y;L>l#$%T>i$V~l-RrV3`4p&1
zsLU%$EGwAtf)H4&ORLUW+VvIhM<(E>ihPXKGO_7jiCtz+ql_H7dwE&NyE|Jtw+AmG
zo#q$f996IOv~Iq!%mOk!GAc}a>TLpJX9adwsf_5@?O{^8F_g1Q%<ZabSIX73;W@{E
zfT3Wq`C=ZzZ(+%@xHO+;8_3Tq)+?w5a*TR218nrR>&fD&ROXf6gh)eJ^94%kp`l@^
zYGo(5#9c(cXNlnf0W9?vpvK<1-=>Y@<>9$FJF`v0xO&B!l)H>Db5VP7oWM{SH04H8
ztbcHRP_NkQWMEDkJ4fg;*!%E;c*f;?$n}{(dORp~#}RE5`-g$=%HCE|Ufw^$&Qg|r
z@99mZ$rSW=;DTwZTvOk?vFyVE;Cf?sO6J6L^asGHa0y+kkX~(KQiSyxZ__1GL`7YA
zg=+7N<kBdgHk@-)Jl}pob9G>A8*vMQdIjf9p)KJ{@STbGuRTd%Eb7YA_+qq1-;as#
zh&YmD#nmQ;2F5gY-%k}*I-zF74goiS-S4Coytr-@f+xhqi}#t%eNK@nv-~cnU?mCk
zfpvPgLpt69je28I7>%Y85~_fHzgt5JHCJ6HZ}d=wLm-nSjoW_!8}EY*E{wc>4e2@<
z!puSha^d!$M6w?kg?0k@pYI-0yb7U+`3<M}a_RXA4F08Z2as+M*kExtGa%ei&kfII
zOZ$W`r4w1I&5x5xip!7pg29nQh8JDbUGDOqOa&(ia6?(rP9|NZc}jUnUrM8MXhRJN
zQMk}A3?yEO8tA&Z1{pm4*NrlDPd(&{>3c}Z>49H#iX9EKMe|O;eAcr?%;Y@SRDCfv
z@XEiJBcEQ&pxD-lRHo6IcA%jR52nk)DPg4D3Y!(hG4V(9lsBG+#%0S){2cy3YOuBu
zP)34P&AVS8CK4+&W7%JrT^0DZ5}Gl@U7#}VMzv;ukSj>hC642(OWw&VpgV!XHgO}>
zTb!|75z{hIeMmzj*Pq`ecErGrDGQXylz|g7gu+m}1b}#xQJEsbPElk|aK`V_{;MQh
zpKd!yW_C+zuF45wC-J!E?UqH2wBQ({o`T69ZWE(>wpl}Sbk3`X#Oa;$qkLHEO|+;>
zL}d}>I`zG%EJ82<SI@2VNrwV;Pik^%%nR(!*Xd}vOgrWE8wFea-d<%=S<L-bb<Utk
zRzemW0>5H@{<uF@<KDA!W*J3seUS$3BOhe58w3uQpL0GZO;uy%P>-g4R~muWMqm4o
zLi978yta{B0vsN}Qt%5R9N72#*oXdka>RM+&T@Voa8k?3FrlfkLItHW>r#7V)EVr;
znc78EN14T;{Be8ISVYIRX^(uVwQKz4W|`ScX?!x$%onv;gjX@^gQPNEA3Z>(NK};Y
zkpEtDUD6@ZrLsgNHjY9K(^EJ+Z2~LITHQZ565SC{e#W<*m>A*#jv7r8`=1(!_aem%
zlF#D5iZZHArlfG!&{D7H&&HM*j02*-oh~mdx$FbgHQM|;sf^JU#l#+iMqEKY!)h-B
z7O_S{3E?{PLscrqqLfLw2GPRG2oS0yO`Ul{6t5Q94q1n~0VXv4G4V9^qRbAEooGLg
z#K$SU?VH#`65CGlc)ykpB+hj3S)cx5I<JykRMuG(qMSzdB;GQ)g!#U)i#CVK&=^_h
zYo(l=eGPmZaT3)^RKK}jk(BJ6)hy|g=8|kO?H7Y*EH7_xxxGt9%qD1|iN+4Gk?eY8
z0{vPV3GvvO>o3vCVD%uS?_nPcLng)1N{|q8$$wi{d?LF>8RlGadC}|4S+$35<++df
zc`9LnZWTC3=k?`HepUY7)+w%ka=(^d5BCj@ypc@trLs-1y?MOak~|u*RQ`QmQg_4H
z)hvy^^T^RJy6Lob>wouiz4(&7663bb@Qeod#lenvqZt`>Nr~N7h-pTSeuo%}3N3|k
zx|eqpynoS7Iev8rb<sbJ-2<C{7`z>i1G>H$pRR+9|1U`>Cph-bFn2+0O$H;$s8g`E
zNZXkAtFM%fRWk_irMFeijeC}@poop8b<%{p7zW0{UI3h0fek^L)GWVBn|+21F(YQa
zcF3sy5T*i40QlECDRu*Sn(B6fzsw!zJ56eEU{nQ;5-S`$MX9oDyb7(nwOGjUJQ<5Y
z{v7fzQRX_SZv)3K|2a4)oE1%mA7l&$yj^jCwmTH6&`Ua$YX%{6yEbz#ygH%BF<mR>
z3(w8u!t@h(h@)rPm3_)9h>^cp-TVe(d-T^gt|+`LDy_aQFR}3Z`sISNlRl(Q>lK$>
zx~Fy~bOaPv!R)++E{Vr)#=wa0X#xi!>PACtn_`_dK>s)HDV*od6P~|3n3$55HRbPF
z3r1>E8B{geP2IjWn@eu}678TDmw|t`J!6W$1qK&;ZXr)+HoqqqtECD5cpT%M`+}*V
zg^%TO>EqgNH2_GheDw72`ROkm3GZpMX-%1^($o8_u2JOv1aJzf7!qq=pMUpP(!PjQ
z@~wl*+M7S>6)e4ow+j~51Ui--K*CI7vw&V?oB-0<bLaG^QEIeuwbkJ@g4bixC%EX!
zT!s6q7Q}_My=ROf)#oJ5e~wF<#em1x%}t<j;)0Aq^$GA7=yXg02dG0V@m)<kW=?d&
zdGMX4Ee%)=;n*OP_w3`J3mD(NY*a^m=^1fu^Q`Ev*45>;z+%(>wtk`6*AqI~7*A#c
zB69suQj^O(KP!EQ>4yp0VS3nDHzRft!Y*4#sgRG=)bL$rOI>xt5|r=Pn3+UWcVuXs
zxX^qWy55vdFEJ@|F>|GdRuQ_6)EG5&@;EuF;x#snM|5EQwb`#=%5Tu7+)*!93vBe5
z3JoR@2|5wsGl%=7S1{p4c#(NjgO1ntiN92jCdmz)ezw{}d@Od@B{i;W!ql_&iR62R
zGbS~ZYv1`wk(^y^`8R5}PxwLt%)S)kldNElxK#@oFo<bndSX1EAl&)1$xJoCvWOzG
zHaRfk!hUlGU2bP~H~8+3S-VxAU!agC_zlFox{Ion9b{im?6kQwPv^1hx%EBcrU5)1
zY4X;!9FlHA1BrkT_VFyaBh{iuk#CwZk~uO1z}CMp3*4wo`Z#9f5RHIcMadMnVgvhI
z9H}h0S6zv)H!F#-K&je?b7ES>Chuy7edQLbVb#k0#+NLq$>kuxiSazDcXAHk=-F;t
z#IgKlYqpu<1IxQ6%Du4J!HqHo-0o14tO&`^YpX_~&{ZbZVI}jJKprNq!2M93%_k`R
zR8cUE-nIk74EQza@DE3YDzl!yu^b*Bbs!D}CUWWHGJCIP!cxyiU6*{+@8~M0g_?=l
ztW(8ct0G29KSl%23~5Yn;<&t<D9clmV0NHP|7a$IlnLZe%Q|v^Nkg!sEu<1cwNGho
z&a94ASZwb%dhRur;#Ht%Ai4%|2R2m#7fgrf1#&F;<~X7Q`_{QxAftkBIE#JK!1SWC
z3MM9d_>kML%+IFAOet9kchjkwjW(9KS(aibv)CyJMej6#yTEQ7fr)re&=C*7mZ17b
zM{Q}mOyTPyp}s+2{l<z$3pyTECAo>Q$&nPGsIBDNihP?B$1(4xr~ZE7eq9!^>*aa2
zBv{mTCFBifbjc$$uB;w_ClbxDV<|WJmYTmv#|vzZct_Ecx)x!qCQJ^*7*yX{FG3cq
zFYz7fM`S}W6#`spbJUOB(tHB_<7s+?Y*7mQue?FbhX*gh1yTNrp_n^B&t$BEXE@;)
zT8UT~dXt}{-qEQNsn-H^Ncqs*Re7yUFReaYqGG-A5e}?w?I*<aMBGo%xhJhUIu(r4
zOhO<RMQak>Yjoi*yGgiE*ZQUqdK9n;_|LFI^1s0++JNhxgpPX~#N_uL7io0tNjT;4
zE%<SewPgMuM&H`~EA(!TEauoh7_H@KJ|y`3!(c?S9Bnd7v_s)CxK*aNz=ss4e;AX7
ze{)>_bM2tdM%#8iJ*Qc?<}=x*fMqhi=g8EOMNbK2SZpwL5R;!LIWbri?Vj*+V&Xta
zC{@F;G}uVd2hUW#;<GsY%A2Ia`t|vxa{zRip|?oP*^%pj?W=r7*#T`f_j83~x`*d%
zj9Uo^=YE=lh_*HHfvY(=_9o?S+Ga6j#>UQqrt2sjUY<HXK6>u*@|S0^fqVlHBx6dI
z_j)%tCdR{VTf-*(Z}0?s#wgoEq6hMhp*2Xq-^YgP&>}%Pa5tB1>f%X4FRIY3m^vc*
zEpCyDe#qbA8r#O$phi|%N*Ag=ULRKa34p!kaZJ4<5SXx^9Go|VK*Ypq6xumok_QRL
zxJ843w0zknnYt8>-Q=y2&^B1QX35<etx&-Fj1%;n)uHc5Z8?X(O)&S>p2E|YbgQhN
z^(9V|Asxg|3-%@liSXaGT3UVi)TSuR{v0UOX8Q*2l$hU3+s3k0u0#yOS8jS|l%0N>
z=@WfLz{KV~3jB<#^@zy&61V?y>CNrezC07Hw<c5<O>1)F)e(_)1Xy6KN(hC=dQOe=
zNgTNs7}>h~k(0!ud{Ho&J2A$GEle+ZO;kf>%+1yn4>^&()zq~6Xv1DZWiK>xU<sDY
zqdbiKaHF+VL|+oAn5TP0Jo-3%XL$d`M6rF;s<DF}x9l)~1!A!jdlPc>W!H0F91TCX
z`?7a(13J0vOlZr#C*Ryhb$z;YYrU1|64@L$^sRVHo$#W6@Qz5fRJ!Zq68Fv>F$-V2
zg|Ln;rK$PX;hlvbCUM*s@0_%ZPU5>GaY6+96{WtRbT#BBw?tq1IXU=2QNYo3Mg&#p
ztu<y@?vhBfjZvMViCnl6V1gnmrts~Z<aFrY_{FlySpfeE8F#EAy#ZCr(`G_09`CKg
zCydNK#PESp!wTBr)kq#A-Dhp6AJ0?QJ~Hqi?$U&ha8ORI>VE@$tUd0s`49OfU*Fd2
zNU~e{iGB6=iPaA9aj4ZHNfwPB{fD7svI#hidURbC8(g|I9&M9;R2!6!xnO?r5(UBT
z7LqJ#>&|N=)zeyA69YAeDNCOj1O8#aGMzp;KAJ{)nG?7iK<zh+*sL`L(zfJa2MH?Z
zh`+n24jeDkfS>)0K)@?rP0Sm8I|&$%K{w-d8)w%)$;SkB&Wco-EEG8maA+ucUNBwh
zp99}^>g?@0=b1z;Zj0N+3%E&{&9V45Y>XLBwyE{?35^FUYxA_Ml|E-QD{Fb=gL3iG
zjs%Z~WKMAvrbDW%kgKs-UK>}s<1^bNYqvRJ#tXYurrUdlx<a1Tvo``69Ua-3_F!jg
z$6<Hyq?AW}fegwtMI7X+DL#?=8YRQZ^SX-P6Vp@&9&MybamSb{h<;dM66I)N+$7)-
zlvkvx&B(Ruzh%I@n3B)dPR_hI8?@yFWC>RwfT=`Zo_X((CR3V6G$(vR>b0w>Xjgy4
zj;$98Z)$*m)JnJ8KcQ%S8n51vo>XIhOi1dIR^Pfa+FP0draA#XeLN3(<+h!R{^iaB
zB~#~K9inBQyYEHF^OKwUqf0dQ0J75Z0EwdBO_}vA3RtC=k4?o3k1{|*@j0@7)H24V
zM*lRvFtZYj)+*M43pSD*_B~lj(7TX)rQ|3S{Q<9xn?vynzj!%~j;@x51k;<RO?6Rp
zC!(4YSVdY7r)a3xl}2=QQFqE|d9q&Kb}wiH&%)+<Sf@E**l#b`zMKQH!ieqG({DdD
zGf94FA$X>G4vW@<wZtN)D4DqNzG`jW81S3MO&PHOe7w_cTewB^Kg81fL=+)jNrdUV
zav#6(fr+}FXu2GGZ6({!Ni0{C)z3Vks5wIE)VcVw$;F3wb%{?I**K4-7~;1rX!tZG
zbCeC%EH6-R5(>;r{fu}_X|-wOrrWAJAAMp-CVd^9y(D2nScCn^3$^e5W#w)=hhu9!
zCc@LFrQZ-VL0#|SpJD<6FyHDC14K$=R?Q_3TVfKRp1Uo6)O-{@X{OWxOi9&ZqmoOU
zfnSwQ+cnkVCj;84U`uVf<V|G#!dHGaA4Z^JGzAwDj+D$L_DwMDKrTZ6_%H!^SAquB
z8B*INlvHW#!pjqgSaDyLq02d8G+%su*0Xj$?sKBf#!8u&ATK@CJA#USy?KPRd>Jb}
zMbRcfgElj;&Cs`KEWB=;@-lM|(RMw;gr?ArD8IP~sCZx$h%Se0*(3R}{$Z?UzRHcT
zzGM?WYDib6&;P^7+i(ZZ$HzTSAxYQw;0yG6S>bpZcVPJpu5}E>*eQQS^`v0n8xoUU
zKatc}2KOJvtr*;rc7BFVb~D$pmD$2W+HvoYcT{bO*Ndm$Jo~-pGfn|{Heu0sr5JLh
zVfh&Jz$lK_SoHRCmtisT+KGh%Ma(!XOy%|vI|g*KAW-nb)`<DZHlaf~myAi4Z)Z+O
z9Nb?ikaJqjF5LJxEbX@9rwq88Z<?m>TumpmqT2qwL7|c2?;+nrX9JzVM3f#G#E9SS
z^=rxJnKELIi)$1VgILD%EgDQlc)jpvTNwg`fhNA++T_}(xojB_KNF$h_AwQ*i7Ae?
zsWNdoQyKGutF&b~UJCx|+ro{NI->aIUtD}FaMLA=CrQ>wWb!GZ*0+&J){qcswsVio
z4zugC8Lw*IcC1>&n(Cq^x2ceMvUzIyGq2CMbiZQW&?Mtwnu{uwH2~8m@!r;0MMD@y
zSHmZ?oLfdUpblTAnUq|YXzKN+jC$wYx){k^aRkJi(Iv{+Mc2bpU<qhlhf1Bx<1uNR
zi(U~&Lz-@(ahr`U!G4yZZ&=fSP&Plzkkwd6KZ{`c+jBDXZn8=UVQN}lYfynwH_52d
zsLbGdvzJa@|E9t5p*70(fGg&u)<s7jgR#MQxs1<Ctkcw*7gajD+=y~m_^4OG=DeWk
zM2|1@VoB1rNuYWn-SJ5B@Iv)1O9S~xrN{PWhq+C9>*!`$?9##0nh8#F8@J8)Hh7Jd
z@l?E13AN>!1<2^cE-<<xC$P51bazlLRG>Od%&a3SKDu^l{I-ekF&ky7^LbhG&4y~Y
z!`hsN-Dez3@y(gm%$Pt`CjF2S&xp`na^E;LhotO&Lk+vAR`QJ@EfTTFbdxA!u;(65
zjq%`Yecu#bk$X>aUqcz;7ib=ZfnC{`InD@)HS;E1JlBIQ;ZcuBbOoR9*d}<?Oh0|M
zyEJQ)lwu{?Rj6lDqHDd)Yh~DecT~O|`PF5Zj)|C&nrSxO^l2I;#y8<y@(8bV7IVrm
zf;g+dVo9fM%}(JTU`oNZC^Y(Zpkv#x0d<!^aQM+*4904-r3=t3Xg%>;mzawIbtE13
zWKpe0HpkD$#9Kd!<1z@4^GuPSa8ms2iN)i@RD^D?kXa|zvQOi@Q(4`lWuut{978rm
z(0W6AL%NOB=u-oIH!|$<ip$2EF}GI(1T+~EXbW_2*~mQ*-<nSY5A$ipS(NH<Kp&g3
z$M3kLztMlS3QR9GbB{utg2td-3H3K*^Y=-M{6SHtiTw_msoTikJq-bV{D<N}!?S1A
z&+*W?q2Uo1F>57$ppa)GOE|G$flh%s#>*+my7d2z7@^muB^L?zT}O9}jEItd7-&5C
zqov<NQWk7g94Rr}E-_K*9~%Eu6feu`Ea3GnL5ryhhxSlZ=(e^Xn&9NS{MWQCpRC48
zim!8O#%%ZNPR8Yn*1u`7%SE0ff3PKE<B`rEcCQ$--9P)~)PRxkUOu_tp#+*O^;6T|
z8)=t;&zfxyXqxdowPZ<(33=NYOO2f3===3ZQ!o6j>>CAV$?#52`@Ymv#Lk2ajGv~O
zD0Ah6rRG$7_jbat&Q9;}_}h_%6Q0RA0g5LJzYx{^`;;^+21I8<<)9&j3)7sje4o;6
zQU8FJK)(cqQN51jE2vq^B1>}nk|YqfOclnAu0tE2j6NY5J{d0BLk0968(8Vzk^tKm
zv5o90xwuume%JM@x7_D%7H_HlyyKekofGY3R_0sBbb}&{L?>|oU>4$jy;ixgk^1%p
zDs&@3gUn38Uxt#;**ERY1IU*BFXZ6zb~**-VL5lF^%A{wdsG;RNXL=Pmyc=Wgq2n)
zfJ}rQMKe*MA=kS1<4H05=tG0qbFRs8K+B)3jWHU)402`rhA&>q;QZYqJ!H&f!Arjh
zNZqIZSp$rRiZ+vv0>Hl-4qBf1FRR<uPz@Pah7I#n`M`3v^OuD@mo$W*d%_?GFZ2sp
zX#-Soiu}jQAWZ=Gv*F{uv6n>a_WJXCCjQe};U(1}+Wj$cTUv#^8W(1b4BH7w@s~<*
z^A)CydcujSWqIqo<jyZLmPM5%PM6-T?d`|fldD-1)#U`)BB=#kLZX{$K4cyB=&ewT
zK9G-k3;aC;&HD-2-w!Lh4uDE09&Ch$mZ_H3si=2<p6SiAr3TTRpSlMzNm9#mo|2rV
z5C>iFon@burTd^1rShEsKdzB}F6>H(%FP_<%*y<tI&JSijz2e_Ry`|}O3Crl2k1KP
zS$33Ql*LkT`s1$$+50*XRhqW&RMLxQgpBT%2P|7rIj~%H#kpIxH!$*4aI=DjsRRlp
z&&Lz9i)+`WDx*k+h4WJ}75vvQHL!7Dj!xZVuJ+A@ctCA)-!S(6r%^)zMfPdr(xqwm
z&Xmr=HS`>e01^10fv=Hol{rD<9&w66d4*vrY7aW%YDin=-l+li<|Pr!mKh)P6@r&B
zM5BCmdN(18eHDvER(kK31`pqm<g&MV5AP|MmmRO+h(F<64tC)uKF_T9T~}&dav(|o
zknQd7ENJ@?)*yQ3Q#ST75Rt|4)4}lxgRY6wRx4C3qAp(aG>zj(&ksK(TD9O?-sND-
zfnLWPH{eSvtd;*Bf|OFT&#b-BYnf#w(KKp)p}vVmhjSUp#|gD@lvq7=3ryQ%?x}j$
zru~5|p3mul=}64a-sq*XIG5879?IvGfHHF~fjT=t9@s!>LNp+_`le!7LyM|ROr0UX
zTXxJ@n4vgKa++;b0xT6Em_7fJJ_1rKy!58cfQl1i*{g>%HCnRAMR=YeODP>UcsjM9
z!O%plU5w89<k=Lc?jRz1Z!XS9>c0oAIp3e9J+`(W>~tOGEMdhL-B{VWuD?(A^C$$T
z;w29f22GoW@wS+jyr+LY?UY0`12aZMetWSv;}lD*9SAmio-~~fdZk0_SfT_<Saht>
zPl2z<*4Vw>szxSuJuILksozT@ZEOI*E1m)jsnNvW$)<*VZU5=``VDz)+*UIp{;ckm
zLbpEV=VUrkI@Q;7lUB0uUMz(SEv8`wS#}jY2#_S7$8JRajiapD5PFpW!T6<~7ly8#
zQN%)9Kj6a|7zP_6B;^EA_`h_X7RWIbIlZ3KlB!`8&adx?-5fjJyw=U#96GMf4&GiT
zkUBewpHdl9Lpwg~h#ls44J`i_2L`9#Tk!srM88V^T)X;o8t~~-a^*fp^C2D%>dBar
z!>llTO#V(UT=&3iAs2A-JqGk?Z4RvwU=yQz4xV$GCmx<LeZbM>po>uvpil`#yO2LK
zpxb8ho}=XfD-0$y8AXGG?tfZnIM9|4NA3Tiq-dcf0(>_v6^P@yxcb1LgMDfVsX|UF
zA5U!XPqYS+uK9uV#i?79>u}p>$8z;AowqZuxm{;tYeloi>;0dF<{Iz7$|kulf&u%6
zi6jt~FBh7F%HPC6QfqrhrgKIsJW@vOcgC&7qF%>?hQonpeFvb8L(F6Mc?$RN1JbC5
z8D1#k@gbG+c$q&-%bL60jV*Y|^0E1E*Zxa^<~97fKG$t3CfZ_9GEw~=Xi#}mDBVB1
zQ*e~pLsaaLYCdm9#)I@$x((3S+>MAUfAO%A>H>p$AJfAV=g|aC!Lwf(@52%4uQwfV
zU*&i|oEf$YA2uY|*C9=#)j|zBND3cLd4uAoE~e4;XK@zEY|oq6t$KD2n$s{}9rs?Y
zt=uQZ!8pH{>(!R2Yq~y*epVoNFI_z@m9*ENywphU_;I32tDvf_LW7$Gi~wz2W$;_v
zTRPrtZQIa{27K%f{-Iqth()2qCOfD~F-Z4WGyP<rgeXuounfB-IKy{*FKuV4dhSlY
z4FfBC`GYNqgl=7qPca&MXXs+Sz}2)5#8t)K#r`pd-F5jLbhD1W$X*Kr5fT}TZcewk
z^Icba>#LCask;^Nm=qqWE&p4ou!a`8Ex&buYv1MG6hhcR=tYanlS|bRRx}(}{pOAM
zU4o0h+rnhmB|xHUYH9tDZ*e!+rrm1MSV>qUU+?XCPDn)>+R4yQ;bNViR2fcXQ#sfM
z%u-YCVzUj$$_`iDX(X7)z~;(3SbECHg;hwkmZGV3IYI~f)kmTo!^bn?g670kHpOt~
zesH0j9gs087w@huf=2m9Cj7MH^N65gZQV}w&oWaohevMZ6qPsbUJgk|az6}yad5J3
zA6gq309A?2;N0__tJ&CV4q|7+-e&No1s#s1Y8Us3-c?P_^8}B>x0Ekd0lQOuRrk(P
zI(?R{99e2oK&<`>6X!zla>#s=j@_3kI)e^-t}3GyCA;zl7xneEA2r$nJ8k^z6?jj(
zC0!Dq45n~9;<_T9Pi4=QlStZo&j2aJK_^wtn0FaOwuIaQo!$mvg6%<F@7Z!3D89|R
zVHI<@mHX&fNQYD1+i;e&LP&>VL3_-GPCRA9z*`2lUq9@x@3Mn`Z<Gzp_xWb}OwZh6
zG9rA$lD{ixenLEw9d^xKYo<Ts|HEK-#O^}7y40r-TGSK5fvt+;akzc_{K=_t*1tWq
z`4o;5g~sKG6}kySDHIQL;4m@-M)U)p_oz0E>zmfK2Pm4JPdueHh{vn&9S1{|jJ|ah
zn3!m8u{&^+1if{eKF)ubRJd?TuVW3}!&7A_(2A-vHuS_VOwY(1a4se*u&%Qk-BUgO
zY-f~+wH=fxZu5y#RR8Q1v-+C>tVH<n?=8l+ifpm*0U80`UagL0OO^Jsx70u6tMfnc
z%Up(%*B3Qiza>uH?a7UI)s^%Cu$;u11yeH`RtZNFi45(gz9hrQIW3u3A9UR4S#pxN
z=xC`&E#K)n<B$?XZRL6gLL{5nPCr3yI172G;tk7KijyK+#iz$KM$pqVKC07!n$sIv
zmKzQ<*m`7zV)+!k=rxZDY!>A=E551ytjNxxSk=cyQnoVEv)_E<$~8)bs3p^A^<=Z*
zR3l41*5*L}-|d`j9<pTYZtY5TnfjpKkvtce9ExM|i_N^Kv>OqgmCQm$)HriKtOl!3
z(VD#5J$D)qj3xH0>m5xR+gIk;^>-Q(jMa7TD)#ZbJsFtVnTggXkDQqvt+uoPv^`MP
z0XG9$wAR2z+ZT&4sW=nnpByRvwZXa->2vX}xk}YU-ziLD`f>y+(cd0Hf4f+$A9Lpd
zX4chV^}SHPv&68+vPtlO^e4Mk<w1h4{|$=)z|+^lj4R$Hq;Q)aID9kO^G$vw!d9Ys
zH7p_>t^4V^(n~QIIEa0-+t5167%EbqqZ#oS>GV@==WxV0CrVM8#b%~H#B>5Y1Q5>c
zp!RjzqCjyT(&$2z|9()I+cR?meO43YS(w?jM75aDt<VQj4zlVZX+d<HwlJk+^7}K`
z)&~yVRuonllQoR|wr*4`nDf|u#pweYhgX{{13(7X`>ni2<Qxm7UD-&XS;#y4qB(YB
zDrv8FY@p=?0u`}a0ZZs9q|ZAt#!A2Y*mGERSHqX)8yjY`YvlJ|12<qp+RC+qM{^5T
zg}O(%!qd@FX>+9OKa9<;!6^@J-TCei;~C_APsDQ60m)!s{hv$s2g^2JkK2D3elT?B
z2>Ydu7xUQT65}SUB4O4YvT|RaMQt}QUVGnAoN*if)~|!m*s0ziQEbS-`y*~OMU%v$
z@WHtzq6AYXd)0+oUar^`@SqHsM|r&Ta!>Y4H0}ihw=bv)5o;nk;hx;jgtNSE<3TG5
zBlcp#kX14Cxs(Uz>NZDS$LOn8@#Xsjzeb>P_guFRWN1$`1T9ypJa;xPOs!L0ai!JX
zo|-uCLJB{li^B6`4Mx5kx^mw?_PgbYR5RfpHCV9pEXzJ0qA?ylGc37pM@%g{(t!bK
zK{AvjfkDg(yf^9TnwmF$L5`lI=DU3js6|>pPA4+uerTxt{2xYIjbc+9cps-nXh9Hv
zPBI96e#@Ctr}U<$uUKuPN4+Y=sN(YP+I_ocL1RiLQzOBPb=wIFm#vihmw)STOl`p}
z5NLI&E9sKZNlGpS&w4H^Z;FKJR2P*9kzT%ep>0bcv;8b%<&Rw+r9Koe%PY(0nEL7&
zqyBeoZZ)&Qnkl(Cd9234q;I?K^5slFD^u9E=Av+)s}ku?s<hG5mC2}Ld@+X3#m~y=
z-Z3#0)YbERu?}+|b8U`sZL#j%m|P`j;(x9ebK#TYMtS}~2IejAvfKK(tR1HUcLitZ
z@7@wrTbhVfn5KOd$ZnZa`>1~Q>-<x?ceP=TcuY{gqWDyt8)A@3eVw}InYUN=$%?>7
z<ZQOCd5PfSsA*DVi>LPt-$vhxNa;K5a`(taXH8Odmzu)lU0x<1=wZQNmKJvSnp+TX
zeGRr7TfOA*r>h7?F_c=e;OOUUpj2#7p{2#N4RG4sx#f%b$zv)pS9+zFFI21x3qr>T
zz@n=>OWPzd?)^&WCd{suj%Fl;9bnk#2k9M%3BlVymo}T5$6d5|L!*A-n_qScr3|V4
zS)6gdy&@}UEJdZ2rT#HFU>?M#E!GrGkME@65xuKvD49!lJtdIydUY8(*GI}d<|w)Z
z;M?ijKBZ7~Dc>gN*afNjnX};eH}dTIVN;%dQ?2$A?MI}LsU&@4fh0FF;jp4*3{V5H
zxZu<IqvxmPV36c)hfoOt=<lgdzE~2ytpV7VM}7QRF*(*yyt>cpH_37pFY1#J%Z7!L
z=AuViV4BFZrHx4!spujwkIJma-?etn)zM1t)YHYXOe~R%Yye|P{Bjo$WDsmq+|cF1
z{RFVF(#B6b;@%z@lE!P88t~Wz%5&ldIqbcf3fRgpEZns|4^YnCo71=-DL>9Gzfk^}
zZ7;O!p=@gA#%;1cR~CR<q6%uCS;XbANua6DArct~1l$}bmYQ<=sWF(oRho7Jhe$NW
zBtQag+?z$*UKCs@Gf!5T!tU2&M?3yufI7(%NX57fzXe2j#t07|c|qM<=W;ye3OxGI
zW3xo9)FAph!OzRDY|ny*ZZfaPe0DEWj1>Ps`{wwrZ3gABTO{D?e?8FIgG@hB2UT#u
z+|%d${Nm150;ZtEcpryCM@%DrmJ|&pMMt7<S~)0iQE%*qZRr8J+(^@z_9l4y5*U3T
z@_!CstOc6N5_c4r?tw|N9e(LDoZU}=5;NAz4e3(+b`t^O9sZXF+*}29OYK&Uqh2ZK
zDh8c9j!HyJ?G|o6V8q5ac}!7JR4odi*6&UF9@j(s7$!+%liaXzPFr^+Cz!_J1?h~M
zHkmM1Bbdejk6&6yZ?2~|Y-QN2rcivGsSugjpS@DSd#a6Cy&zbu1AhPjSqdFjxcrjQ
z`+L+dJU+l>zOx(=no0cYqI%^rZcW$5ejRet0MFF~Nj&anJ!U)}JgD@GYMPu&IvX|V
zIu%A?O9}J~QTsL4R8WseLcuZ+-33Xa0a|fsk3+vX56>azO6r^<6uiNgVoR5(_DJI7
z0l0aAxfZ3hE;)ay>eC$IwV56`DrpK$kPoo>LmFL9q7@s&A)SE|JgeX+kP+Myr8uk?
z_$gJ)e~@+%Ki3dg!;O!-Ap^l_xgtqMz0rE+xkxDPYGwml<_Rueu2HIOBgg{-;*pnC
zS-14Sg3xZ+WsrKXfu)4`yMb7qin4a?7yOoNKF}{MnLSGUgUfa^2`qPxj%yLifIQxi
z<n04_kO))~g&p{fLlX+7J;3qdEv#wl8TvYuaGm-+U9uzU)i&0kzKI7#F!4|LilIYF
z{ar&~*2v0yElz#_U(Powr81|&pFdUSzHkckyUmEY{lhT(L^`NpVtV7eLo?F$)uc&U
zPf0RHXU2X)yGkbK(fFgu#`ok9JdgP%|Mod8Sg|r(Q;65kzoFhf{HgQL<C#rTUn$Ct
z5|H3JSgPNR|4x=<ntN<NQ`#|jsKV~kDMfY2bxF%VjEdY>Bf62>#h1=F;CTuWKcyd)
zfy~uC7EeZ4@UQr|)Gam-K^t8BBoi!zI8p~jEoh5N{+M&qs{ZTS+6zr-9&XQu>hkg?
zD>mgNq4Ly<&#&NUmSKd*8B?5C*RXLuej!gHEH_wGhc$%DC&tXcF;{!iw1~~Aix9{C
zP1r{kM0<32OI!Jqp05L=SNw<5^fMi^5%p^sU&URy+jP9qNeAKY4X>J<7}H7E6eb01
zK%9u++^uKqi~zriXzM|*?X^=FHP=p`$)76IK-3?^s`#d{OQ|vQHXoC=%oq=i(UReZ
zW5~1b-~+jCJ>PGWHHz)@b&%(0X2B_MC%kE$T$)2o?Kse@B*E@c9^wF_&7pzy=-zne
z#%A+F6HThk;Qe?@vt%bHFt1OpIl#^}fa|b<SWRiE)t_0YgcirA1XTpbAdW2CC%18N
z!^xX`p8Yv=mU^4$w~%1T67SU4Hd5^}zJW4v*}b`s7vq7t%?YuaLkUp>=@6M;kTUC}
zEr@G+`nTw9zNXrqUq&%Orjd>cN$X-k)I#)$l@d(-=!zlH;!q9Om<YWjlcC5DVL`n*
z?#upjAC6-XifxNO_$X6IT~i@C^){}t_A@vhMO<3S2lY@~mIi=Lvt!t$n*PY{zV}Hw
zw{h!aO88pi?y)6{de!-lWDe#E12u{yfEBXDF~(E_dOAKSLqh16wof+>3TD`jF$G(#
zgMP}1*rV2A<4W6oV>A*?Wp(McB@Jo9zHs<6jYZ#OK1F$yl~#8mSn&}5JiERpn7ZRV
zph=LVNG3^FOuz{RhTerFfOH%^4s90a)TWY`_|v#BgmbvA5xXNLC1K~FC-WbKGY~GK
z`-*;{j>$=AnE-=?>4g@@e}Vxnx-W)q;2j+$yc9@Bv{CwBQt@dRa4VlEHGBY5>!rf4
zM8((YbeQ3x7`R{f>HgC`1{A}oiA9(X^}_|GLBLZ1rw~X0#ZVSn_$U!^zBUA*g^wuY
zatP0q{Fq7|TKwP_q&*Izz0{SYK|b=*{t2SJ?)dZtc_h7Y`pAm@7f2bn&QXCy@)f_s
ztT1{^uKEAO4|Fo-f7K84rWiAXweb<}-l=Z>|20WGA*N7?j>-elMe%pjsb|VK{uglp
zPPyRXK%Y=5;G%gg#h-~-(4WZQ3zp?^S8WJ&)J7S=gk>~r870^+(d^rANwV7=+OO%{
zyrE6{-~F|GqFV&<<H`5WRnwge>N>484M$cSd^=!%dN!{;(?MKZxQ2ua^V}h`+*xkT
zChhD>gd@05L;ErryjFLU7B~(LS<{|hg?mt1FfB3pr`}A<r-hMxWwQEFpc!3ZGMWvu
z2G#XM7Q5Inb&|aqvEknQ@nuUOvUa#Wq*glZ4AvGAObuTWt-esNj!rFNJCRPEgER94
zWZJ2-T93E{@B#~`_mA+e!$NK-LkmZO6b>S7C?>WxZ&FgWnB|#h@iw3vADKggUpMKS
zVdt~+aVP5KH_7VgS6OE)mw7R4!)&{R4b3+gCZT4x-38TNPMvtOBKdK9+rL^zKeq_P
z^hDJL;@!86C|p?A_&<65wV_+b!09)QHAm_)7KNyOe@>7p2Gg7aPTo3jnpZGr+S~*X
z+Dn7omVcqL^In$p$kv}N<R%9s5#VuBSKQL-wK{4SH^po8*U*jICqhOW-;5!9HfsGM
zWmRIme$KgZ)|hUxQ8hnTeDTh#rRpEX$$5=i8*(V3tGWKl-)k(wqVCTnh5ub_$WicA
z<Lg`Hz+z9RRQW~y>jJ&v(*^IFYfXrKMX~>3*Q_LZ7+1HL?;qh=p*c$#j2ZLXYu>)1
z5j-@={kn|<%j{Wnl&V67u)daPe_FFR?ubSn*IPg@y-f6owcHQu(2kK(LP{f9@@HPr
z1{Xw*dVOpzjDTdjenM^&x*~QoYX+#%^M+@*I@E{aK*jGZP*F8b#5TNAy-LWGUO#`u
zW*t|}M^c(ShRkEqt~hXKpkFUJP??v+s>Uo?LTuQvy-G}tll&;qV6nK+zdbP-Z`+`4
zEd%8$4u4AYXDk4!pBG=r+|eA%b2vy0`~`u)Ef$|5s@vO10fSlA)v_y#;l&Wh+}yJs
z5<AR*VKtT~eOfdPoO`9D3mbThURN?TQR(DwzA>^h>GS82Ti$|n+>qX*8GfR7t*5?#
zAkjGgPt%Z1Rs<$A`MXlkL-TQh^F8a()pw-i(aCP!sO^CeaQlUTUbnRg0Gfja72yGC
zYS^IJ?ldK(gXLig5x+Rqqv6c#!w-Zm*}#&0Vp8^4zC*Q{0_=K?SrD9nB%Nl9m1&p2
z;yBAD)B>ddpBTQ*sMr~m#0kvqggSVYGSJWHzc7qS_G2{m<$a%8o{v3$u27jx=bu5r
zR;K^rI0~DOZjqo00#tZc85yBVQLQ~iu#4{OU|i#-0?MV_^g51ZyKr>n?4AllvX~R7
zoFA{Zx!e7|J)m!<^ee@>L*Hotr^++Aa*5b}!G5Ra9DX0O+rCKVW=y@@jHl<lyA@lt
z$emTG0ehe9HoX?$tmON!kuJe_dBCjOVBN;{`I3Z2=ScYh^&3x=+i2?z08KcFDrpm<
zO6y?N<meq3>lXQg=>mODQeQT?X>@ASFZ3tvck^jfK?;S5D>0RZZd3B_n?jIv@92JD
zoPWQF!4vLWC_fn|an61S-*@t{<UTg%ee#~=X}s-@tYhaMlC#MX9Or%DN{FHHC|X>|
zcJ6ueac}y0S1ZK&MmIMNlpZg%8YAVblQuSN=g=t$=H>eDq}{a?fk$1RYDV(AzsMYo
zV4++89A~CKPiHtKZ_MpKp1OLJL@*E77v;UuhD2OXTHB?-*CQj?HwX|Nvc~;^aX<CJ
zmM(5eolVqclEY9<uRu;c0VyxGF}=Ua$yX(%hO`m3X1U?kp*xNaw^=Q}rbHLHicYpg
z@8TMVnB%(^3|ahn>V0pe3U(YNABk$z0?gnyn$P_t+qM%7$9wPu$7swM3m<Kd9+}Fw
zN>8%wMy8M&4-!NhO_UWsLYT_7IBWv$O(!2Dr0@>xFUxP{2TVu`nOg7lUCBQ_h3xqW
z-Rr)!Vlhs$Bv}x_3&D3NIb8DBcH)TIBo=Bv0T0B)UW=@`B1A5%Vg%ro>e+u?*W5zC
zSKyhzgpnyZSts}}T)Q&r*@c|NtySi}#UaL~Ut8Jnxd_(FYzU9d5VlpnAQrDuH`Ip3
z)}jv!R<x5{TBDZ)9I8FLN<VXI6KPZzEb*&FYxokr#2S(RfU=9R)|91Zd*>po?&xS4
zu45WQ?EJ=BM^6lg1fFV~CsXz!Kdg)h=iN6<h0^KpRTgS?q61iQh1ToISkKhr6jSS2
zAJb`(D<5U~7tk}S1j-#(?q88i8fF<beO;lR)`Pt(DO}fORNrd<Ku^J{Yj96C>%pJU
zQ#%PtR(uxi^Z`aGZX!M1*R}TF#;j8<LfM4kc&6+lUJ*W%XGymod0}2dPOQxW-D$V2
zKh)yTCKhw7YH*15EWk>(O{(IqJWSIk;$(ry?Z1{y0hU4t8K3Yg&TBkxoFra~N)y-^
zsq)wQQcS#5CIml=J^0A}49GxkIyjc9)S;1@LX~E}2_6_7++A~ACLCynqTjo;f5!2V
z<5nN?5KiHI8J{$!ogu;+u73-G(StGx;LQAv23ttxY5e`@7n7?>i17Jbt^}z71CQH`
zXH20T@J{oP>P6;uwss>*=ulC7(?PZZO9R%lN?96D3dMUh_iv3t#w?svKIYZ01*>e4
zcnigXCfl*qEq~ISRlJ)pqSK1`ruv^3rS_GT_s6wvLgMTqM$B9Et*Dy@S$&Z0@x~@-
ztLjAE$IR>xUqrZ_sr+a@wpV+VI=c@eUbEQmhj5kJt<#C<GWE3*0<kJYYhxMgM`OGd
zBX2(q5tq<hlV%H8D1&$v*J9p<DVRLheOigyi6w~<Om}cpS!D|4U<mt@{I@oC23`Qf
zPAzj%{5r>8zsH2}^@v$fQlUg^$5fs@5uxkB%vFJ7h{Ej#N+ybN?7?*cTJLJ4{YoP1
z(H#u^Gw<O6GV?TlPBYg<=LCdeSVbfB#nx=hPEB8BG2j=0GT>enR=)rW%(@D;MYAmR
zKXCbkAXxPCFq9Kvb}Ymk4VBt``2X_&S?Gy<<Nr+TnKgQ2(Yc+*fD%4ssdr7Y<pJk;
z_`7_8v&ZYLwkMh1v>E}f-1t6pY7b;G?-%*sKzZ_pZA4NNENPqi!O;eO6OLAeje{<Y
zA||0Q(a|u}NO6FFnXGD;v~xoE&iMe-*Rcw+w$9Pv&d_Jv`m8oQ)kjLQQmL`uW6$gk
zTqO%9at%6~l3S_m=Wc>0F+)KdhTSg@7<F|W8g-ouAzGK3EJpsG8t0k^c$FvhdyNTB
z@74B1n%`W;QaNjr9@FrZ%zs^xw!Ge^5M1_Y9j?!?UVVVMY_;!Y^71OfFD>go6wg!j
zcgH<*Vl^+QouemtY9-kvx*q#?djyhJ$G1>S<f!KL`$6(t`vYD4R|fCV`rj0jrjazk
z8#Yu`mHuM$G>$b7nL96WE!)C5%f%b&XaDw$RN!Emb*2;OHf5##UZ3S<x|V3rXm)F$
zjIL^pz5;7JmrgRHZ+Dx2aNV5bN`!1@F6?Cce}By7r9Lk^Y`O8uO<bNw0^-dz8>!Wn
zD0IpRlyU^1Q>cTt;3XkWKfTn1h;nNR_sabo6G#u5!k3Yoo@^dyfao%sp9uK9q*#$v
z)PlNkT`x~*{8(uI%y%|0+Cv0Qt0bUTU0Jx^<n3J>qVhZ_4qP`hxb2ie>YAqgWZG7l
zQsd@^m)a%5B&=sLy%j}V4)rKa1dg6+uW|>e!A<urov>T}U_bp5y7Q5h=OetoZ=+|_
zC{v@N@9Q_QtZyo%oGdw>YeOK<p2jHazqn-huLi5bHM8t*ymu35BimDWWBgYJhdU`3
z6oQKoSL`y(vZkQUA2W{4_0BX@Md_NBDs$=neeo4_hV1%Tj28;ke_^xO^8OJ@PLCg0
z|Fqa~O`a@Q?hPKI=-@IafF9nprm&a(R60#(PSkuhuY5+VSMn}`VMibL^jn*y`-n#k
z4SOamAQ#p8!)01jlJUSjWb~`Ix9VY+nP$+`i|xL%>9t2@FZ`w1u==)<8SaP6?5$w4
z>%&vu6}i!vX(}g$*(j{M(WL>a==C>7GEHzf7*zptXUx1JPd#=Zs8%ky44G1YdI{8j
z31a8rB)Eu};?_GWC#li{<8+?8B~Xu>IJDJgXuTW+fMq!yHoM(o(#_{~i+Jr)Os<Uw
zbP|7?p@=hw9KV-w#v!?ai0VYB#YMu_V0KFA`j#iAQL{^}C);j*MmF<Ps5YW!c4}?q
zgg}mzCawonF4K8|PU@F_bb}*OSJ{gAV55x9CKqs!v00gno_vIS>?`)5XZqax`G4}N
zdO<Be?KpHi`J4gXvg(&49SXSS{q?HD>WgjgPD43Yq9)=fKDUau-f8FRW%-KbQtQ9N
zqPj(*<_yvtlG+;3;Ub|%z+tTQnp-jd*OsD+i19ab9}~S6hpohl0U8K>WKXxhj-GT`
zDm-c;wqY8mBP8Be)yG7$BX}08x0mCd(hp9NYO`L-Qw1&yE?YQ=ahS_l7?nvSy{+z`
z(z$>e6VA6wkZiGJo}_cuZ#<FZ#ky|0-Z=->I`+RFVG~YGH~BIg#^woyCJphZNs_)g
zgt->O^^UVo8^s}Fz~pibuua?;_hGrq_&j|<Rd_|i?1F8qvQ$blRlL!ey56FXZ`uK;
z0C4a?+(;fVtf@DZODi}uL+T%a@mmGaA@_NhVoEIzLMBfS?Vc@UOA4fWn&whY9+efN
zFE710fLjU=P))!We8NBb!b!F0Iea=v=4&yx4SRMw_k}afmgM-PHI#T{gbXT4#onVV
zGsyjveY?VDf{00#h@((PJ-YOVDjb(d74r#YvfY#C>KLlY?`6L57Z)hxIcMr>MFBB;
zAtQ1EKozLAa62~<F|#%nG0rn0me&|@!;3nl;$9+jb#yz4QM{g&Mvi6nq#L$-;+(%m
z&6eu#*+)>1q+RIkujt)a-@JqLpIPa@#V$`JDUlCJ|GW8JePl&5gkt(n?#6D+a-)vW
zQhx}m*MF0Lav*N!`;hVf+5OVp;A~&f_La0eatC(S9D~<2o$qn3XH2IgJBFz-&})56
zJS6*j2D}Lj1vJxh@^iH6XC){mL_qG_l)^K|JlWzTJ;!(GcG#@{d;waxN;+>ZWO1qA
z35>yqa|fLWq1pw`*`=S+u}qqkL5+S@4XHNe+5uogBcFfG0(U;Rxu!~0)Dj{0vt)$(
z`+c|LrU+DH-#)uPZSwP)mcn+fnxS;&Lc(V3$x+X7KuYXuC*^u-GJG#e;LNu&>Oa`4
zykV+q>MgUbl6WV3vw$HV(0uO?1Z~;!<>vFRtHC&|@fL*Hhi?AahI+I0BGVJ<jA5xY
z1upvI^4=790T+Dz9)5s$=Xu4TECj{)fH!7i#onX6FS1TtIajKYH}Gqqu0?@e2$5#O
zCU&Vs9nQdD0wJ-*gR;^2D?Mr-U7H`j`t*Vna!M+S{wAN}Os`pmcqm{-cJwy11s3ai
z1hY3N+n&(+ORz9R4|!xSfldbfOmrq9`49$wytQgh{vVp&GOUfRZQBNFK#LT&;;zNr
zJ&@pT#ogVd6qf?Q-4ar)xI+sC3c=ke1b3Gr*PGtY_x+h9YbCR-NoLE;ams!qraS4Q
z)xA3;DoZhR+t}cocJbkNKadiN3LH(jmz(<7RAHat_1u{H`qeA??I#bg6i|F~_PV`Y
z=vB}=fVyxj^>imrMksikeVtP4s4b}F%=I%{vH<bP7!}{6Y3*X)coPPlNbpR=k>hov
z9oGR=A{*mUSj5UR==MCghO@OV;xwN8MjtG0RgbVLb5TUUp3~eU!uBS_7u4$zb*$kp
zZd~<$MJ-f>@vx0Q+U9T$g%&TdPn(Q$Gz5rjts`*~+B?oo#71<TK}pl14g=X49gZBT
zLMT<+$4%*c-;3PtJ|qBg9G&h(tt3^qIrFPqJaR11I!2vyn>Ug)CW`;mv88xv$Qs7B
zSz8#rovg`buT&jzh@VinEVHp0TRIa54y&^n-YH<V0TT9kQeyR6?*$o?R=Z!GYOtBM
zp|y>!-0V71sez*3c2s+oRhukSznf2ExBvDXCw)7fYnWT`m`0qjrEx7yQR5`PMn>28
zz*3CSaCFFh56kUNN_aT1T3Us#M#G@V+1A>`Bpqh3MMrFg@umt{tF**vdNRfD4KS$k
z0hXhiA_;*G!zL;GMQ;+7%QUCK(nPY}m=Uz#ymEo~Pqy|gxYV{mJlZ;E-_*csA4Wv$
zh8F!rg<K}BD+(u{E&^3qV4*)Bc6*jW(QiU~g9?Kmy`LwZg;NzY)dL%RuDN`L7Y6I4
zhLx72<*>Hq{cu@W%YYu?(xlodwnF8`fnO`rgMvyZ#sA(7h$jRxF&t#CRcMTmCi_b&
zg8?O<W8dt@*v;|;qzCqq0V<=1G<DRK4)f3h(tpW)*3cI>R9^5&M$gdZW*V?$7@8*N
zy^j9txj5Abac`<WYZvl`avDrl?QYjR3VVC@9x@+PR|}7dYPF-j`4MwjpJnQ`+@)&V
z`NDx&6UGbor>_c(bw8vWN;)@v+qzoVpjBPvVr0UyOJzs5+SJiu!Azhn78f{sGwN}n
zv|VV-U@8`%TeqJc%{)C*s(OQWE>K~B2{OP;e!+ij9G{>=It|95Kytxbn>E`L2G;Wq
zuPJWE<J!(4Re6UZ+|U-ou^yd4`_1Y6XZ?mbuaM1k<>iAxBCqLO-PF=KuY#?AuiJPL
zO`e#OGa_SI3yprD>Foa8fw`5sDP57V!WFW8(I?vvb7EvQ#`|pN`P|=K%TBM2tu24H
za6iIAc*_N_yz;v%GZxP5M?=~44@K169m|l5SU7idalQ8};4S(01~EjAz0WQZwlm<x
z*x#K7&GQ6e2i`l38%#Xp%0}*A(`6TrRRYZt_PT~jd%g2ghUL!nh%1&^+Tkt}OEjo*
z7)Ljc`NmI8hm@h7$qG+{!`rcAwy1CQ@@_%Djw#7k;9Xefx+Br)3L^o;-&0IA!5vz2
z*xM>>Czv^7#??0aeK3Q8#l>KAziDTvy&P4SQjrWaQ`qO&y|?Sp-*WQ;1X4Osfc)MU
z4)vSC{;hp^Hy?^E8Na+6KX~mQf?axFDuJJcePDLyP!LK{kWBf%sea@X;S5yUw%3zl
zRONux|Ix$u9C6pxAZ98F8$I*3)V960Wf`66h82WjUiqCrny$m*`>%!b4Q8`HFtLox
z3|(dKp4BQQlP_L#`#nQ>VImEt_?a~jKM*D1-aPsIwY%SATRv-(?jsYwiAveVhROBd
zd7uP@iz<`1$h0aMV?^B7Yq11M`UMH|HLV<?RBiLjU&U*(@&lRZoqFd%2-nOhbK#UK
z@H7Znj;<Yx!PvsO2=oV|`}uT@pBi!H!SJQ|P*A>>j-ULVJr08q^le67SAT1lhrb{a
zTEyo9D2KK)di_n=&dcWAFgfAYHPo?AsmGt+xda&^zaqy--PZ}<1$d`-HhA67y;`#w
zFq6N;=6518bCEiqn}ZoHaCLB&AB0HUvh436bRaQH=&%L6i9Ft=;9?{5I@f7&=^+hR
z1Bdtev?&%`=+f7up+n`rJz8IQ?fg3SOqR^IL0UJ04LS3ycUv2UK+o=d!*x)gJaIeM
zfXTO^?zEoV<aA4*y@E3_f)ki30$S66dnfXh2{@i-GLE(_4-30AK)?liJ)|C$3WFH)
zqwwJdNF(%C#}97lkd#)NR*0-P(mEMF&nP%bN`t1616YCe<;6{M>tOSoZ?!%ehwP*6
zOlnNxkaTV5^#46)q_x*!YtlI6z-ku(r7@D$X%9D<CA0`s?2D-8-RiftOsbuHJI~me
z?MCjt;E>E-JJ%DzA-?z`ay^Y421)Ne3bIb_C@ou0`(Q9N{jyH!;cG#fZUZx!M`?{_
zfJ&n_ABSQP_$ottX(`IOR_GL5kY)tTeRpr_zRn`fu=G0dtxnRt@;>K;EaCE;Bo<Ry
zgMf;_w+)8?m5);az$ZnK@pyOL?QHdoPOuxkZ_2ofah{RSj7Ft0tByTaYOe@JPsO&W
z*+oaK@qqAUsr7z7hI8FT?EHbSw?7n#9Ih<$fKTrEWD<|pFU9mS`44X=wEIiKe;>n#
z611VJsQhKVr-|xN_Fc0|<7?wxf~jD;8lSPKSiF<5+03*o(y@gLv3pyvYMnP?z?N{%
z&_JJ1IdkYXPy{VS)OHk_vz#VoYzn%&+aQEZ$_r$St}QbkF*%-4@Ea7YiGWmfB!|+j
ztuOHUB4B8~$XXd=k+vuF;}${Bat5qaEv}~5Mq33(SLc_@#zMyz{`W%M=RRXz?t(y%
zl`@IOk3GkQDpB_q<Bj)JyoFR0Ik#z-S*>gY%(j5+D|eWTbE*D54YfQRq(}FO%_TP8
z-C)Y=V!2?REQM$g?PoQk621X2jmZTGn;|$e#T86+V}5Lqz&a5{7OJpJcAY1-v5GN@
zkzXV}De!~DF9!s-xXSu}_Au{XQ#{($nCK-C)0i;YVEHSY(oym?u1qJ8O@`U>{+a1;
z@!+n0=PG8&AhGa=F(em~`!{7g7?e1lV1LT|fl2ZWP$XDUJpW<wkdz#Z$3s5m`$k1X
z1f(d*Io8pjW@$*>LGNDOV|5k?o2~U-J-xYgFLb;ZbhplV1I~TFf}ctD=P;$vvw5pU
z5WU~fWAf|F3XG)k(>@QrAf7Jk0{xFs8C@?}j<!@Zqwx%#FcKUwmHZzH&cAH>`oC;C
zNv-X5=>Iwj1Vw-4BMP)iwigD*zq2_*O#9Y;AB)Q;e)tMbpbfK@h@zaQFlw70X<O>%
z{$=FjER8B<?%oA8^S6P&U3gcrArhqPt*kQn>riiAfM^^|bYJFs$^dz@%xt5`K_YXy
z-hk)!POEtc^7@dFy5yI&dgXp}^Y<8o#kWfpHsDF@N^dF}O%szMHod+pdhIqA;xHd+
zCfhyXh;wjyNx=MCSxxCblsZGSrcvov&Z$#s?^Ae<A8&IxYr5gf!Ky8`O0A;`p6!uO
z1x>-OOK*MOax#=}$3>;h@No_cI$cOxp|GfyE|?dHO&yl5CJf?)57}f-*B@PeUNx$f
z=FgSbo3j5}wmq7->dMAbeZCf(FuA?FLPwrkb!af2{6P=_X@FOfnwE7ApBVq_6`k&;
z#w-IWjWf*fdsP3i3zYatT0~{lT9i2^bW(?`wz?j)J_b9GQ_1ZC@TUS8k^ft*rcBPl
zqGSE~5_y0Y1)72EF&L0B7c{rwm@wR?>f}A0;;?)lXkDru`B(X|yr#?IOJn_OFW%0f
z1Xo4!)v9w%V}~JGRt9@vZ~UbB)j-u5qV!Dwg)mtjf9{IgIM=%#B7xS?$_EXfF9*gm
zWE`vmpC^(Lqz*)xT<o16tNcDdxx8yD*-weZIQ4>;2E0rsy=|AMuUj=U;=<Qpgs<Iw
zv0JByL6&{?)7Z$g<hkuOPs2BRlXdGr)h~x2zI5w!kw7NmvXxcCgLfj4RlYx}MaF&K
zuy<xSBmT5)3?&|9gW>}QCqyJlGRc%#H-u~8E34mDUk!gN!nK{;%H>{zOk<AtxR^C2
z(RwcRCBNlCSd}Z|<Hvh<K6rVxwQVn2!W=mS7Ef^?{!I3wmeqmq=9Ljt#&q(mL5%qR
z@l#=l9wj`JaUNUPX3orB<dFFHtrat&#jhYHd{1QkGQizh?nF5s$$hW4q;y_h%j3Ot
zo+d5L=l=15X@I-2Ro%1KF_}Zx{bUtz$l-!ooUSYQ)-CMam8J3dkipWqo;@>dT|0?}
zgLj)3(1mm8owwqJHs$vOX5K<Z<zbfKJSjFz(KP*<amFt^XIv<vDsOF8K3V6}HnvA;
zi7K_0vp`@FCRDzR`FG`Ws$=>BV;QZL5FLjSBvjboP*=NOT5Kh2MbHw;w>D2+<~e58
zih#+3HnB34d-~Lr3tTH*G`XV$4?}i*ORNq9KTf4b7NWb1O=76tx>I<TDWmU`5jf$X
zGnh0_TXZq@n+^mVw`)&zmIhmDDZI!k%a&zt%q9j&+}jLq2V;G@o}c)e9_2R9_614w
zRL4f>qbq*XG<k*JnSJRXv|Uci|8~|yOdA-W@c5-->z!@>FeGQN_+@jm&%QZJ##4SH
z$pFo!&G+2uGqsVH`t2#wj$#gunYo6Nc1t|Fm%$QAOM5?CC|2Vmwx|;-xm?)4Mz`zv
zZ?}3QZzv9_<FVf2u&^jCGXuE?kldiM`Iq~U)+X9`X`2sH1kZPlDs%gqQn}}j<hZ=P
z4L_%}wQf~1xX4VUFp{BcwNlIZzV-W(OsgV|&C{Q!n8<%3t$6paxq~y6?j`mYIfv4I
zsEOY!JW?h~xjWl&e*CVE{(<R}6WJb9=401j!*r33ea5hiyd#H}1DFCT#*kD%Pnxni
zhRYa1-63O7sEoymPpCwoK+-PtawEPh?j?t?JhL^!k<MUSvKJqHGZVH}_THvYw8Es)
zl3UkYhYVw?6@gri6b70(3ZoJ(`m_`qQ0cw84NuH#SUNkcW)v)w9S_V9o7p)-$5%FG
zFNdibPW>u2QbQ)~W7sPfo6U6T+-y9wpD8>q(^-4T4oJWFQw;;3hc6_-yU3^m!S-?J
z>$6iy68GDrK`FRAGVN{!EDHT>5ZcI8x)9orc=`_|`zUmC<KaIP!Q{37P=>Z1)%=k(
z<Fs?pG*N5|#yE9dN2)2Duek=#Uqj{81d*W!@xgP)*<;CYN&KZyv=CNkOZMu>k3F=m
zEmn05B%wfV;AOeoR0=Y{fX|2i&se0fh;IUUTv&`K|JROSPeAVf@deWiN;X{=Wf4U~
zX9gY$zIwt`Y`z?P!MjGCI$CS>f<^MF7w}ulwu0Q>mf%VsbSm*5%H<0vaUidKK)9Bz
zAGaUPgyJsO^R!d$tSAj^S)I9Np*6n?h+BNGx+_YNdC}6J>9sL<sW(<>ATwLw7fv~H
zU@`B6)q74Qb(Oe6XN9v)e~1wvv#K-fFq>GkD>VJ>&6LsyRo#Tk@!JA`G-fY2P76oP
zs=s~DV@Om4ao?o1yqxI?1Qka<=X9lr7a=KfhCGD7YK8r}t^XiPdF~Bv1t&E(G1H_o
z{b06#uX2uQQ0XdaTdEFH21c`ixTPx+XtH1oWU#cmOid=*@QIdzvGpmnT!x}-Q(nXt
zcj)&JVC5()gIDEqB7Kvp!+E5ceAE~YpgXGt&+V%aX=}<j!!X_u1H%ViRh=$W!gH!#
z!)%f)8s&=DA2_}+mVWen-UH3lRXa^I1GU4O5zu6?h`Kc2kn(a#_#c}R;cW>l#|jK1
z2R{A2ze7)(fF*^ile8WJ$|%QgiV}(X5fPtTHPuFF0Yq^V^SAJTVdsLG1~vI3hN=E|
z!f#<pwUO30-a#+0sLz3KvUqnNszU#6t#=~Z?aPB*tuyYpJ)g(N|3iu5l5RnF|F-4v
zT%u4Y^HnQ7<g-|l;~WUm(rj+in87%otx>oC<fqJ{?OC%7E1$|%$xRf1+Sf7~Oaq)S
zH?G{0XQAM<C%JAzYcazkS68oQ0%icqm256qB61gw5(4}U%Rql+B~1SFYHNoh3I#g`
zMs4sQ8}?z(t}-J`uU?(mgtm#Kd*91nkT*S%3keSV%A>uDxw=Utac`~0cuQi&WdNus
zskJKFsc_M|0y-x%)+iHmI`oBuJFl(`axPNx^L1>x42)H)IPrMo=F`ZnYw@A{uUI<<
z{ERimT%AU;7e9S#)okXbX;*0!Y;;Jc*xKMZ<|Ak5S6A}V<@>(y!I4(uwR#*anitj#
zmMV)&eX*<sFJxkzPr7!U1rOYN{h{xzU((LBzG>OXKyW6@<WHXpEe%TMr}N<NuCFd_
zD`*3sGSAW$R?p|*&y&xhW=o#N^_666GD4t5Qn5Rd*ozTff^0I;B4?V9v;#F-T0$@6
z1v^L2<8&geZ96{?(BN~z0?R3LC|?)!QHOX;Qfv9^rs9IwpX&b=ecW2-C)ZmiBz%oe
z3B>yhh{YI{>Nm`qdN-#n!Gq_C&sSIFYM~Xz+&%=d$0w-ynps+Wlz&;>B~|lR%E)`Y
zqxE@T#nxxL0j8-8Nc9kZcNy3zBDxz1Cx$NV&Q~T=`cmZg-BQ#{8?AgXmyL1m<sH$C
zdnk7}&F#5WG-BC#t-0y;SgCwUeV6~EfOI}?;PgY^aPZ-BXlzeBucR>BMB~Po6Wb5y
z9^%zv{I6C0#?EG7s9f@j?W+a@-Lb!tScNWYlN27|@I)&VdM0M=lE|d*D1J2lZYajB
z#<=accq;<vnB*B7_Z~+R<S^X+RzAkjVKExGjg~a<OqOUn0)=R!&AmxpkfZOSNLHc0
zVmBRy++&}Di1l5G&UDr>bqO)?QpRuRkj3TY$4T*?QHr)_WaE~*OTpjH5tYK29$tya
z<9C6I(Ofy%K{MpZeLQBP4FoMEQe8|+f{x1NjvNoPs{oz?S5Nrn?y0L@>9V`O$O9Mn
zK538v$RPiMd&;|c^zo&2uY33A@mM<u{g9$JkaFTb6xCpS7{?u`(2R*m_-DeEm&f`8
zuoiX;$_D;#P(UJyqb+UG<{7#w!oV*Q?3A~1O5jyvcVo~~ArU*t0-Hb76K{KBUe5iH
z=@eAxwWqzN1)ZyL3T9p|{10Urh`NV&?3_J)Xw^rhMpT*KHKD#t9~tXjQLloT&%NDY
zNj6~Y4$XIL{+Vi7Fe?~YITk3yvlM8Xykg1ixC)AULF-EysP0Jc=*}N~70x?!kyps!
zn7kX`e>rHqIANCs8ZCjTo;`qX)k2$(=9`b&WXzWx+!Zyjj5d><v+$1bjZlCwVhpLI
z1ewDn_Np4tq|{Lk>@-sy@VOS_)tQhA?nLGgem_vd4t$n$@BV$lh2%w~J3I_4UgM{W
zCbg4MG)HfEeQuPN8*L7()nny*3|Yno+#}_MMU2M^=VzPpR&QD&xdkW4Bh5@Kv5c1H
zzu`t$19E!im8?aK#R@a|#Rl9BwM|Zt9YE9IfgC|WmE(3nS$KuJ(x#5`6APY>g0>>b
zsXq1Z>~Uiy{}a6}_4=_Dk-33Z+~z`+$;yfvL6wR2l{&@=Ps2(8SMH<S7YD|^KB6iX
zLSf~S#<8DX6t7c(eL7|2MvG#b(K_ba6;ma~HLJNf6ByH2!v6caw<Jg(&lMXN<zL-X
zKlyn}L*-?{PsX0u-Se9Mz~N-qyT|2%Q!d}@G20d2?Sth7l2ilA;ojmsT-yh&?hf{5
zl?QQeX+ADxM06zg{f@2S<hWH84hn30DD<|TF%5O}>>|WEIBnkb+t%Ox55-}naz=IE
z50d?_6~ygU7(Q2ZW1MSb_qW)MNo4M=(&S15A3v>S8kWv@s@3(Gr@x}4>rcNYJ>ob(
zb>#+Xs5`u=Z$j1ll8fSTT-S`PASjK3qPZ)w=Qw6&hSKYPy!hx@!H@T>fAh9bloBCa
zpxqDXquJ8*83ttSZtZ;Z`-!#Vf}H^fo2`n9<~FBwZvfgRHM0+T1=`%lXXJpgV_qo3
z*&BD^4(FruA=p?4kYymNygesb({@QJG7Q+#-`9FN7*$fSKa&w}(aGcwZy`;~oSbgz
zS9g-iP-!~Le>?<__U*T?5ZX*AR@%Nh-ueZ1F@4_=m!@Oa{Eo9Z=f$?j`BolCtaaZ%
zZ~68u_WSp460Fc5Tlv8Tc!43TaAfVQHH;46udZuiU>LOXDM;>q$QEF|RMlc5j%Yj5
zAMLR+vq&?h9Qtz`eDKhHeHB~?$FaXq^t2I;;GE=>%KLuw=`iK%em1QOGH;Tb-DXaz
zk!r>0@NTxG?6-2p`&^<7dJLE*FW`%67ZMv@snb<1`Aj({dGRp*f0hn`|G%Zf3{xp7
zC@Q#es){SeyX;%h3`nr<smT41=yTaTI_WqpgTF=$;@9mW%w3C&k;+`)4d*E@;4^n9
zhWu$U0DMa=EU__4fC{QQ?9K{o23jw9iM2Q<$>HHlKOmT{aCUA%ojYQ)>5>T-frZ{Z
z!)ngg&P`PxuesqG$|ZJ5KA#QWHH((b%DLfpJV+cBO*KilShH^0a$>WM!)q05mjXk}
zogLW_Byf&)(;*)gGDp=7Cnj`qj3xV#dIQihs568@{|;#~3?Ab5@E!o7tQN^gvk)Fq
zwl4YPw7JxAE~b_0l6RzWgC?jy^GjIeFJ9?rl~o&ff8BoXR{SG-3bL?Rtuv6tJdpw+
zYi5$L-tj_w6i*Sxip@chPD3F#F=Uu2B-u&x+vyXwY;N2XHD6@pC-=qw+$E!FpT%3%
z-3*xW$mi+xu*mZl+7@$J9w!Fdt!B8tHPS=XQKoinF<3RVKaQ4-K_Q#ebayun&@<uA
zF#6^0TWF&y?v`6tRQb)1igYhSU=;Q}9mQ6xtANyYYd?Kj!a(7CK=1XuMfKOOZ}sf~
zWL^cIJ<Irv7+CNnx4+N3{Muff#z(e{{bl77Raj_|A(WN|T*tNPH-bJ?z$(4pwGX&4
z0Rr8vR{QIxd!wj8G&|8TX^sKFY|Ba5?CxsWgNVbqi$qSjLR;*fZ@Y)?A_0ChSHocH
z(s7bUU6LMAeP8Jh?@_cvrC=p5yu$P#rofxhGNj-`fJwsPRc9V&)_nmt0Z%7FYaA_u
zc|+sz7dw}_`ur&FYvR+@4a&MZewIOg9h$fLdpBXI;NVYFnsHaTi2hERxXpl!)TrRE
zdV)0Xa!9==h7Xvb^BMV_mOzb*!`?1iPF;V_16Fv${wX7IL*hI}zL2f_<`H(yq&}%4
zn4v)yoU$Pj3(%|qM^b*&W3OfrR=CQvukR0md1c}ivw25TSTCK`cnYu94LMcf<5nF-
z)M(qc#n-ozL_pjSkH_Y|y8T{cfznYw6QYXcUVhHbuiMK_a8xj$a0p0|QNm0lT5N@T
zSU0gRS!=Zy>dn?Du}Enqw0KIXu~$JL9=luhUS5AS`y8Q^ho>71Be5AGJNa;#3KlVe
z-GeL7b7fS}l5h>?c}$C8uCFA^P9J%Op<~=ouDYbn&>Inq>~?@Jt&96WXHJZ_OW6{$
zTUAxhEFRP@ty$CZp2u@*ywYS-{-8-f#+MxAxMr+7%b)*THa)(RNmywV-zc)LF07Ct
zKrDz!QVB{k@Hpk)+-#%Y18;Y<q>6?Wq@F5GXvwAKWZN?2=ilAYe;ML)v^*W#V8wh<
zc2IR?#X#4=9c3_YAN3_Fz|jST`vqriopW8Ic{5VgDYYo0kw9{#Ua~6VqP|wfWme5m
zqK=c-L{%=+$3^9fE2E}H|0acw#`+Z%a|sZo5y<e*{94w+3Pdr;+w=aHh(I<uh_B}C
zi!vT&qVh-PDLIthf0fQ;cBro{nZq1XVM^(CfYf4kI(}x>)OKVoHw!+1TGK`~AWS`#
zT7%Y}HLT+6$`{(7%h_$1%)hho`6|&}L+d+}w`m`&k%H0_DI;I~pOpO9zV0KAysda$
z{~wB-64I{VjwACy#`i|@-0dl#pzoQJs$=Lhbn7C7sq6o0xPRwI(?C+egaJcOMb9z0
zhW`_il1L%>h~xffws>$;_~U8+Sn~73tWifc_6T<4%Tw+(4HjiyQcc=a8!$jy87vKn
zK|@*=SV@8H%cYdQGQ8KKm-?(e6h_9;VY^Bw>!<@{eXXwSYDYA*mO@!qV!|c(v02QM
zr%A}O$2=FFz*E-bC~HlRFwC65#8ed-!%4Isy9^@aS+Un;R@T7O{{Y%8%FFLg;!HBr
zV=%J#R@O|^JPMAi4+8}&;e&ni{Kgdx5y*Qwt0|qRl+Ap5ivDtzJBxHUuQ0IvZfI}c
z_|_FxXYGyh!ffmVywPI{kw258L7N2*5&?w>wEHCGCODiHp)GE+=&&fU6w`0voPTbg
zVQ#F%P?2R9-F(BE_aqy$Aw0%*usYh2moTE-Hg!~^)*+raQ3RQdE9TQ@5!K_?PhUfg
z<)jDCvN}busmp&POOQH8aQoFwt>g@5vIH>pRPH)^!;k5V1AdBin<PH<a!eSW>hx-@
z4MW0^JsCHd)+hOmGcGR_@y9(4qzO*hcFNUAhY<<OVlCCVUaP|ct#xa)-yj1kNRGZ5
z8SFchAk-uftB8O3i{V1aN+teD1;@4?6o)16;<CXk{AY58&))zMck`?B<^lv4wy?Mk
zS^RLwNuIX-)#;U-0aLz@sYZnoi(>3%NbG!)BR*Tj20SyvKJuc2@wgqvA};lphEr*W
zMf<llj<B_Apd6g2{>1A1+W)to^QO%PMZIx^lkbd3*$B?B8&dndk&}Rg;V67lG+Dke
zTRO(?#&6$Xi7CanZAmIA$*Xpt|0#(%U?bS|qfTbAP}5>=nOOZS55D5heu4Fy%CN-c
zM(uAKVl~jp(@uejTnwB3o`iub^?}ok-#)bUfquxlb^gN@@NS#AmhNr(pHSGtX8tSX
z51Jugt<ptxs}5RVIYaid?tqpzmQQE3&Ds$l#3j|LpvZuGjjlseo}eK>fu5|W&;dtQ
zfI)DL!j}Sl&nAlf4m<bzP8IcMnM^DkwUdY=qgZ8iHRR>ps}{%V;$bZN8Ged%Y<$Y~
z?XT^STx=;%R-dHWX$Dtlc->Gji(}M74BxO<n$ivUb9vkbo^!XyH!tf1#97Y|<ITWc
zv3Nv&01Mq;@o3cKsQpMCV@LE(ykRdhVFlEB4ACh5a-JWSFj7|EpaoBr>t-oK(Vyl}
z%l#<Qr^f(x(UzzV#I5fy^f7o?bM<P0Ky1yC22BCFGCKh;O)gbfHA7#<kQn{cp8SjU
zPht#x&Cp?6puM#Sb5d@>)a;x+FQl<PuG9v<SJH@ogSY&kL*ADf`~A`ae^rj=46hbF
zR_T}0-k0UPMqaozjD*Z~o90Aua6Ez+*lsX+)si0xgi$|Le=(>KP#R0JN5bpUyGAos
z1*5!?^NewoooZe&m4Cze6P2<-U))xkToHUVkuiv-QA-%KT&G~&JX3}A#=xQ5_XZ+b
z-;VqPvg|aT(v}`0XfinJ(!U70pK5YnrvKermO`-fD^0mimVh_Xgv;Z#TviF&5m>3Q
zES6<KSw8YedPq*$&9^+#=GGXhsg%l_X*U`VA>IAuN?!yO*3`9F(Nys8RXPh-dQYON
z^_jgWU6kVp{FMbSO#|iYahkUD$9klJu5oFNcy@1I7{>YI7WJ1f0Wn4-8sA;j<tn)3
zfD+-C&W`svHEiX@FTa=xZL)KO@WuH(!pM7be2}v%E5OzKG@>n|_*YHr4t3cUWR6v8
zKk`VhYEzVZiP$Ut7du;rS?M6W*U#T=cCGQ+({1EDkQ?s4yRqH6eG@3&URO{?Mzs=L
z-y=OoI^(<){EDU*Rnu|R1L{>snH#%lTzB3cpzJFFHzrL(-1okZu^@l1MJGd-`7Yyt
z(Q7VU;0-I)ySNG*RuaZ~{&Lw6J*3`B<%|^IP^9R=Ak!AuR-}LtV6|zCvtpsvGKy@=
z?7sl1`VOCcnaJhe_ER)Z#^5WmGx$CDC80S5m?YYisFD6)S+Kyb;w#<&eKU$peqUNB
zINUjXF`p|Y!HVph9(7L}3rQ(>4AD2g82pUX&yO=q$!;Sjc05xzZ)6uB=LCx45srB3
zw$W>kL#M7gf#TrD%A;pRXP3brAY(eXPY9+MG^cWc6c%&t^c$@Us3~IfvB(1QNLS8F
z8=jhz6#tRoo%W26{#hdHYlf_&Ix;Q0${Dgd%%p1~3A7UVsHwpmpMHXVoMqkbh|7XP
zhl2Tz@skd&_IwHmNhj}AGAFp><?}>VmsrR|wy=cu*1f~|_$YDwZqjlC^9h8!0sVv)
z$!|3**xd=nah=AG-Ztfn(VcAEtcme-h%u6LW-wuOvT6Z~kjK=s8j=|%;mz0si|ieQ
z(6gtisKqKmjN^+0xBD)(OfVWeR)k%M0l5MkeHmNGPt5`qUm<%^oF;*N85>^Y$YEHk
zKFzn>Xf3xAr&*;aO<GhSIL2C#omPFJ1>5Kg?n=u$qcotsPt-PUKc2mp6Ed7Zv^5pu
zg4D@FkceC&q&8-bLW<XP#&q@dbPA8MsePYZ<WKqvM)>b>@KqaMyY|1uY<R)G3#&i2
zAs6!^9S5FL%_b_yA$zgU({7)iOH`U<95?^XX*rVuxoXY{Y?D{2Y<qWB7`a4EY@*r@
zzUJ+_FTUw>Y){||&mQIFHINK4QaTKJ3%cj=CmBr4#^^$TL~ZNt8FPW2qon<v;51{z
zDknT$S~;Pk$+D+qe3%Pc;^X$*L`DO7j7n5I7|lYVU1ZgsB@MlD?fr3n3fqWc@jtqx
zv%Wx?cATz+iZ(v$%m7Q#v_52Vms4Ji<l95MfT1*tY5>AqnR;kebBL(5d$Rk06_2@~
ze!S68U&|3*wf^$J-TK@4!^q{asL18HKVWm!OFN50zG+#c%x@gT;qJ(Mf9=oRYW+zN
z$M!`yK*tuuJSP%Ekg%B=!5FKdSO;`@nfu~F#>PKHD{b2`e#ew6dv0$uY-}=sHRMgb
zU)w|8>e?E{q+j5NPmz7Xl_f8YBKv6fwLY;Fna9z-{>-Fb<<$%+x8b#_7S8vtqEUY;
zbqUv+{;3tw`FN>vLSg;;Zul~;jf&LNb2izMa-7JFpXa_pN*)kH=psQIw3+p&eLr9V
z%d{Ts<UajyYN3@Xo)R2GO1CIRdD<S>lYJEo9U@*r0^bawt+dr?EBGWNBHF*DXn*A5
zvY@4EGQ{F?@S^h9v8br_>dRr`F+^zAm$9)_q~tXAHQGLhS0Z5yx1o!ybdAGMTVw@!
z`{e@z5V1ybn_zn}owi-J?_0gt0;d-!yB>bqG$QEoHU@|j`IjPSjaRSuM5t`g{gP+U
zhSVhQAO~Uk=fFQ!gEs7imO*dhL&+^3xa#FZg!22LQO*x*LAJU<Ui*c%!DW2Qe~nb6
z2w5JsL&9N!UtlsbL_;IEo~qYp2j>bx9%qB52}&wZY4ZSf=i&4e#dTrq8K3gEPDYCr
zb4{AfH=t?ZBym$o-;>b8MAcHmi-4r~rCjeK-~C-NH6%8|@rdb#9zf}0EZ{WB{Sw-?
zlV5LR3+ZGCT<VY-uKZ%TUw~77b8Gg!?bmj14Q}Z=ASq<%iiyI{uj^Eh(!>QJh~x{D
z=Tn{~+Cvxh0=dOb8=h)zX9&w};y{)$;!GX;4gDv!jH0o;E4CE;UWc4bVA?Ah#Tk#h
zsN&k96+X5C?n2e=;e)zDuAO+F_38Z<m|g7~Qsvh=H-NJayEX6MDnlat0h{hKKd0vy
z$}Lp?w2kU%=f~wpD`ZJw<Vc}=lS~tH3L-CliNa6rP<=q2)KZ&@iNb=&(ib*SL<WMw
zyH6N$**|7y0&VekuvS4G7{g0z%}ZY5EUd5-l+~ZEqi+u3c~kz&?=H5}X=~-$?G|5x
zqPvEw(~_bw=PJO#RTH7}y2P#P^Mh>DT=iQJ+lwL6az)|w{cGFLE0!l8*OiSf_D0sk
z*^1^3aWw1>v(lFe+Tp=RmUMZCh{@c-1Y3#2fZ9Nb%{WaF=^KlU%BZOW^pb|mG%bR$
zd-K-LK%t#)`!lI4T9s<dV}6T`17=LB9i#@(!r&@odO(OeWbQ=k<gL7C=4vR0`06}9
z$$u!geY<WVo>^hxbzTfCWtZ+_Q6KWFbf#R|oS5CY<CF1b6%D2X608Gw7fK~P0D@tU
za_|hNwK|`#y?+p`z<_=Ulvb(ptl?|+$6@)K2!M<^-^bL*v6bKi+VqKrAaV>?0_W#2
z9lFSUR(qDz4ZYF!RV*gHYUMdi=?Yrc$+6vv1S9j4T8HIp+EiG;8iV>bVH-q&alX+2
zC$Sq{+@ixCZHD~Z+G660qpm;4k->z~n-9TAyE2szw4>-s8u-Qr*6FUvSW3Hr)%j|T
z9rDZ(#T2Z^5Ype_A{M!mGzuN=knFyUsZ6ceX}I`)Wwr3`&?E<clb-#F#u`K>O8d~)
z=1+>@oX4$!gYe}p&mO3$$^y2H_YKO)`$;pi5h2*s!c7#_LIsf<+?=JT1CJd-Bf|-m
z`;)#Ub8@icC{jRK+ivxJIDeFq^y9l)`hc`}yd5dUV47R|S8nhx)S7&g&RotJnXF0`
z1xe(5gH)7$*K*5EQ^%TMC<~eVU>}G#?|LJEcX0Vzyn5Wb67l_)n55HouijI$v$CQQ
za)+VQD&rzCCwyVZ^rjMlJZ;!l4HTp_eXq<HsX>s2LaT}*vzghbT`BrCatJ?}W#sr*
zr%b7RO5=uVejWFbewGq*b|g%iSE}Tn*BmOoR2<TnPU?#)%p6mFmZzMK0mFlsAAOXC
zKZQBmo(G=*iC%w&|1rf5edYI8ed*=Ym2_szSY|wp3R$D4^sP`9K?EIgn`An(eQbm{
z#g;gqzws3(f<M7JM4#VUKhK}$KSe(pOL{$zBMYjdPaoIR0{=r{OFI|8eXLRYbz{Hc
z@t!+1oG@ViD)~-sX&&((N-tC4N+|J7bn7$MF=egoBh^~L^qpio?0CmF;nxQ#)d3Am
z<*(Mb(pf*S_(}+os@h&A9TNWfy)po7hf05jOCZls9TgP;Zu2zl>_M<Wsc<q46FfW}
z%Xk~7U23!wm`~WeDZ)NjZy1s(5dBc907zx^z0I^Ov7|Gw<~}v%Xz9^X2_~9Nx@_{g
zl1O<ppW8N5vHX-;dXEFKq{KMbZ@$=RX`qaFB@lrdhX1!TEd7?aGlQ$<74|zj<&BjO
zj&sThQ3hU>&Ru_-xK{@#J^P8a17j*E`Bt8U0hRFRG{|ye1X|u!ToQvez3bp*l#2-+
zb{66ucHKW|u}Y}-E7+WF)c6h9yh4P~*CJID;Gg_*zDtgNQc5@Xl;4rmbVRvlvD1A&
zT_ofrQ+2uYW8@{_J<~pSew*{C#eXPxzu9SurR!6{78>jBeFLuW%Dj%@vO&mF{RlT{
zmo$j;{&L?cBbRgzMtZjC5iw~Xkiimg$k4vIhOYZ`t;7Ezi1BeTpHA3v(c^KxxIZ`K
zu)J8$c9RP~i77cy#JN{+mj6{GJ&kj*!|3;_!^{z%7e7XkgsO3_ThP6i<2$s@kZr5#
zM#x58>M}C3q&Fip-^*w1=xuri#@&0A=lMpEbENLUFX`209ZYhlM=EMs=u<VXwwH;w
z+wn!9iR(SX%To}GA!zoH;g&+W_g*CyBBo4YEDaqIN@j81%Y}(d(J;(>*G^5%!87tG
zW4d1AtLW=`XItsetSjO<{^~MM*q2Av|MAE1Cfy|Om}TOVmX`Cmx#zfPvgm_y1BWA)
z39R?pP-BN|$Ipd_C;s?N3(E}gNyZQf854e?f&cN}hUC^3tAUGco|?6JQrkbad4C3m
zR)-HW83t$2>X_#xQpkeqPtA5J`8HP`2k$@y>r}&S+aCut23NN`oABRpafWCcITG>>
z6aG@apZ7bS(OfIq(UD{7b0}P8G&p7b)syXpXuvRWdV~<OoK)L7{85W*EwrM9xuL2s
zFE-vLAAWdhD1%b08zR6bp4PSSclo2XeKdHbk=RfXuY4v;kby5i`cWBURPG7yFUA1~
zK|M*i*z8PKHF}cSp<lHh%bAK-I2G%+CAJ-@dMe91nMHRkGuYtA?(JST$rDhiRqtAb
zbr7vt_v16s-uNQ>QA*xJQ<@1B-zLu!pF=<UBEy%-$0MKU`m;fm#4w<R4zu&u>l{yi
z!uvX$bw*E>yuEqC72CLj$#u${^OMS3suGqzDstyQoJrn9&}_HToQXS+cRl#4U&x-G
zlBRAUS=oK;lu1Lf?>k7&cvYR{BGX$g`ZLxM@5BzF8{*W$IsC$o-1rkHup`vgL^n9e
z5UyrCL4|4E?nUs7*CORT6Xlk(c><H5D?78Es?qYk<~}6t?GOdvvSo3L1j4lJCFkK|
z)|Tdfje1e9ak^Q`ou~L9H+BVvo^%O3i~Tv`B|y$}23|uuRo3YkN`gb4Z(;OaX*nLk
zRAcgJQ(+3G6IP9mi2I@Ps9p+bP$-x+B}S>p?oZJd_wXOttPAzzJZ|)7(cTfBRm1yU
zX>|O}Qc=uIeFG@%JX(I8G;4N#1I_Im(*jxDIqynNG?erCI&5ultXOy-tq5M;)~BZA
zy`CteCX;E7cq#8N=OFBFt)xv?1vZe%h(lL=^%5g6%JrD>AXmnzqy`DbS0?sm&54vA
z^GTY=6?UOJcF$7+bfxt)!&Ti)#GX&F5GKNPEA9iU(sGoI8NLE$xD~W*@BXT}W+0L%
z@<qFy2afl*HVbt3^(z5q8A>f5nCx>i)5fn>ckusw(`irZH6mv}R82VErU-#57WQ@#
z$A8OKVp%hgghXJQYIU!;Z~IpT@NA^(FT!X)_}~bX%8kut53!BM`$i$84cX9*OtdmS
z9rLq^S~AZk-l6bl^DOszQYtuSrxjNE63OhRMj7Lr$M#wa4DZ!X2;bTTyuX*G;<8JO
zDlz@SQZEf{e&79U8K6Ee>9kir>|{jeyfHVG>Nn~vFp$$w;Z%Un{N7j=<4?eVj3ua)
z{?>wHKE53knm1}(>RE3djIFsXRr9C{FqGt)<hEEkOkA;1d8_6%D}4RJogivn)t=l{
z`Ahq;(Ims%d~n`z@J@U<H4N@ir=4>P4AJV<ZdUn>qV6=;^Q{zt5V~|z{rk6lt<V=F
z;Y!MIH0axOW7#AiGTLDb4cAaA(kKas*y$ylAF~<vOmd=qZK9117g8(CG(fbjxKz##
z^(8auK|5F6`f@o%ZU=rZoA=#;*y?)hiI!qj1XWOnHRD9@Nw-`j*jrCslJ=7sg~vPE
zwtp^}G`THkvHlV&J7M%<)o?>^%t?fi+57zVGncXPn#;8R{$2Lv9FQ~94u_K}lXhPn
zTU(NoSmB4T#vrHsL|9aDp9g0;8dhJVQnfQGN1QCt1rO^nMW{3RQ}#F=h0kQqq6s`a
zcjLZz@KQmz+tA~&mZ9y@H&kiV_laSBns+@K9-9o0|Cu?e$CVRtS~PN61W(b#o<2Hn
zZ~VNCb>kBEeZ4;DKNSDVg40@tz%J;}zZ6@b%luC@ut%S4Y9Y%{lTEVfTJ-IKG96il
zrVR>?HbN~MfMc&P$8UngY#U*YVbo&eRw09dr5HJ?rBNPRXH?O2Mo8hn5%fwf?lb(s
zC(bhRK}w$ce(ZU^?KrSCux7CR-q@M;Y+UM+IVT|0Uez>*%`3Y=4ZMA?7Zu{yX(r~|
zmF2oYH%wLk`;Pgd06R2m=YH*(?H(kV?zSWlCF6;Y$4`4K;As<M#OKVIsnRGc!xQC9
zs$4#;+{n<XU4jgkX<5CLiB#P$Uvd)rxWMQ&b&UEG6WN}Pix;DrozGtm%mvH9kkY*Z
zRgOh9$AsVrEd^7H3>g}*rX^KM<V=K&#?cUDrC8yvDn&7;0XZiYN=RB5bH2d-<*sAt
zO~_S%!!*M*UdSBxim+UKc~gF_$Hp+dBeEoAyYEjL0L5eDyK=d}iwN?UIVR-52o0<V
zB9`yMZVU8N$j}cba#Tl3*zFEE$?Ak{EP#QG2fWC{ijdbvDIqD57eFzJ`uXp;{*C=R
zInZ)z)Q43^k)GW3HXXXLOG28AoE&_)g1}O#V{A<+-u(VbvK(2(LLiK<oQ^}sQKMIo
zw?IoJ%_wDDtP7`_Q+RmojckLTCd9MJY1MmBysj_N<olAFZf<X57#Q`v*D+RF6kaOx
zOF09%9Ia0PRT{Y*yM>zBML_j<Gr5l1(T=Ju(qKjvvS~Wbe@uq~+%Yj1RsXmasCxZi
ze@}jc1nK7fJlSb5^OqE<5=iN_s8~(3jt`TKL&N%+Z#4k@Br@F)q%<`?sM?twqRV@<
z-+#%3GjhzQ{fN3vT*7qYzAg5c?_vDVwW6oKdE_0%4zUERO(by3DVLiRlUVFiSCFL<
zX;N#9-K3MUEn_TM-Rd3Z-(kPu44K(EHs+tWJG@NuMs5nK0!eO?u|xTdpB)IM628>k
zRa~aI-u=Ez<D7vvIZ~c;pHhBVu$rM;#8{BK{ReG7>9)Ex<J}K5OQl@iN?MJ)eFHXn
z(az}h@o1IHBP<Thg<e)!DGslf#xT_yFP+w$o%WSdPAux%uMObu2~(A#pwLIj|4+h`
z6iokz5{7gU+T#2VrJfh^VI$dZkO>Y_%Lre}cNp4)D5IM4?AP=zJ1XsT|A3KCMFms3
zm`Z+d;SGietBu_InZh{M72iV^mQ7pBwtKMC>hu;XrdKqN-35Z7e`Ax_ZG2jyTk=9V
zTv^96e=VyV#dFbMNNcE3MtSAun(I2eTbb(63(w6H`n_@(tENK)U3kkDrL?u7PRi^m
z+Tu*gTw@Rm&s;j+6%~P|$6NVxWSYNik2Rmc1LyyZ-S_#cB6CUkzK|5rx3~_gTs+E2
z4}mI(1yp#A*RPT~qdBLR&cyDCc&9lx^N@phm(DHs);S$JFOH4+NH&ijUO7T*s=kBo
zP(}L<8f(x%671YvBD~jZ1r6!T17bH1bs1w~guj2Ef?oTo?eFa|-V2>KF$Q`LvabFd
zzX@10bRqiY=ET-3(P6J!qr*~>li#S)%mgqfA1ygZA=`Jo#1-;W^-ySIQdD&m(gF8z
z3uSf`rSPFlD-~r&hLyGFDaVzyu4=2cS7smE#I2RuT>^kIsdAm&EpMfVeP*_L#}h1*
zncg9wjNE^mZ$gmH#dB-2AeM;b$g;SdRNLa47Aa>vSeuNLD5rnj#@5Dmd$V^SFCyEa
zj=hcvu*I)<P2}8LKwmDCH86XgkB`hj5^)-ep}qz3{_%S+<musI8FkogtR)uYF!Wy1
zX0=3Xt~jFm(t$<z2|sPxm3WcE{TCsnVWPz6l)sGPnOrl7M+(2Ao4k4QDa|X<u5iP!
zcRPL{8@QSLcDr6YEo#9~f~v>L(n>o|=>q`Ugzq8ykBr(h;WFDCRh>6D#SjlRxQ4j*
z2^>@2usAmxG3WRB<4ho>w9>0zQadgnSO$`)m7`f!HcZR=?l8kr6}j#MVF{>71boE7
zls{ksFG7{$C${$S<aJlx>Dh+?2SmTQzqajGRk;tJu?wCkv|24xHpLv*BXfUKT5Mg`
z9{0YNp(z6@cOjE=5TNDYEQhLJ4LAli>oEFV@ebt`8;4Xn9hWcAHdaa02CYsd8N}{v
zXHw+sz$p@xydfIWXdP2L(>2;(EW}>D?9>aejN9*#yYhBgDbBFpU`Y#Vnf@aDynm3b
zOabxb97?rX+G&NT7o|&?*$3_PdouBI334T<-rbTmS!s1tt#o_RqgRd!HT3#7?2I$1
z-gR1R)?p>s{qkgFoo!-95x_4XKUpJjmibs_qoqbtIg_!Z+5Q4A8&LtS0RGUG;rq^@
z(9J8UsVAuu#ik-E>v14ONSNG6y9{`xo$od{&e+wJ;&A9_BG?da57grH>X`ffB4fIl
z!o4$4cwv?=5D2W7k@1O~t(`(kq9G>57rXjxa|6lcD>wr(NrtqXo}%G`a6O@<JX=|c
zg{f<%K+uo<D*hyA(b+23V*77WK<R=!VH=GCN=Xv-q`0BpO-Bre1?TTfT2cma!(UMx
zs1@b~?Nz?;M>b+}zi4!Ix#4$Z1>kNf;f4KB#$}b80@4%EBO?Lt`B0`lq3JZH@}#EQ
zdf;Y9T}E>wb-z1iB1C%F?Kixmllw?J_7%PXE~bu^)GMXeD6DcQzedTlF?dN((p9Y^
zaru$@A1|y1uoE--FBJ_&BGlzZ=n0fkskPs?<;Ll}c4grhk|M>YwMnm#4LnXxd4zQT
zrlPx7_4u3DRT&f#P33nO_&>qFewy3R^QYPD`1yVvS<&2g`)vP&OivTztlxJQ+&=3u
zA#j5K1pscu(?pYG7`c)C)OJCkcXIiT=SXTY{^*Hh`~xN8uBTxZnalqC@PE>Ou>kQ=
zB<dg)_DQ>pv>Y#n=hN#PBr_ewK^0XqLSbtHK%nAWJsVks2l}B>%>*P$yrg)MQ`5uz
z{PD1_zj9jxo|zfUeU!+h0xa4QmD&IMeq)!ST3?xJ#w#;AdagaMvtyrPs)a`{Y<&RL
ziUmxgQyG>1K{}QnZ!OxV?9lZmj(GTvQ7;g;JUs|T7k<w8O0C$}r3l9F+?bl`$*k)K
z+aR_6HVUtfO;~AaOUxSYqFevEx?Db`t}BbqdWDyw!$kB`XVcO#Z1|Xbe4~1X#du|^
z3Qz*{C27s(^sE$i7=0Rtw(;M!Bt6y+D)kaV+LvT1+^dQeJx3TmQDtc*VEW%Azs`Ae
zXwBj3p&NK?ZZJ4(MxceXopN5W^rbAwQF|EwS#4?aVA^k5&7vp{8SZsikkNDmY3`vy
z-!)X(Lk^Bj>dVRvif2pWR$eQ*Re2SaTdymP3B%b{ZFgqxbQ=(@iy?!V=&Uo<$^W6e
za4ru*;e2Pz7MW1QaRP7uEceQzYc=W%Duc;+tSO03y6WmFY4&m&GF*tm)nA#AWj1JO
zuSOp#*lEa|`jAZtdx^rc)DiP%Ih3QZxfy-nOM07INr>edR7<PHpeoQhGc-KF%Qn@!
zk09HB+oL<5+EwH)`=X%P`$wTXj)ZW%va*n>566q2%F*2z?13i3t*Nyy2Fn5%4cOC$
z59<-)p(X9x(oAGHe9RGzdA*(WC+Wea@3GhQms_<r=jIHE_7KumF5LyZg6+n2>$*^v
zE{r4}qVI?7U24$@UuHh^2U90@)k6*&1p>6x=vO>tqc<X03D^o)|JwJO)(dZsCh=Ua
z-+kan$~v<i^0mpx3|J;|dSfExZcz-({|NvR=(RlZjs+Sm@77f7*bIM#Q{RHc0q~h}
z?=$@Jtt>>(sek>}c-nMnftasY6WeSw4i)jvx@O3vsI$B0>AU*oMQ0sOk9x&?zltmT
zsP3NIrUbM1)U)WdK26uPwcy#Yi|y(9^9{sZLlnu`M#pM_shWt*ap`TV33c=Ej9c2F
z8`do7#h7<~+L851O|&cL@eBg%V~Z@S9=#A6P;_uA%=3je5MhIVlC!#8pv7r)<LF7s
zw5n+7f-gs}!Ll*mE7~fn`{ftXH|krN6N)HPt#XoT^}(1X()KelRiQkUWL=Dmm8BS>
zTr+!kl;F)au}?#p!aq3MO)1U`5AxYP5e}y9J~l1=m3GXCHM>b&AnNbVTZ3PZpb&QT
z;pr&e_^p>DJ2*JZLBnd|hnksrJ8V=D&$!P~1T%AsmhlH7bmeBsygpc5C2ae8nF|^X
z_>D%L6Jk*C#0r0_OE8lg9-8Db9E;mH8~N4VZaw#T@x42bEvpDR7Y=Ligi~#28iJr&
zWtN-Jo7ztsS?9ZBMFiuBEB|#*%Hg_`DiI4vo5}BM5bMbC{$|Csv0`x!D2G=u8Eau@
zGwi24Z$TrXwAdJ4`BRzaUGVr0)|>Cy9k`YGga1Q8SNRp5JjlJnSZAA5m*<$nBq!F<
zPKi0pq^5WLqQ*?F^U{x^heORV$RGRdJ!0}f?1Wykk)HnZM9gvnwuOp=_{Yk-@z<V}
z#$7zY5~8i+#KtCLSx~nxMR8xb%l>Nn6~1^=#u-Z}F4?i4cLHCX!>e`HEf2$19P}sZ
zXH}}bzR19gW&vW${a&P>$qD|5W`Z8fz!<B)X!5BJO33?6>F%vQ+h6U4w$TJ_FMbN5
zS;5dB7wXUs|Asa>bJzEhV2Fs7u?*7mTIRbyWeLi)On3|{h3C^5>RUy!IY35A235Bd
zA6{BsdIdfijc)D=^~+O&iwS`-lXu7L5Mp#bTGkB!9U-$w0e87Tj_xWG`g2?VN<<TB
zB8UF>#mIDal0ct^rzsRRpq}3+=9jSUa+B9a#f;s*%fG&|lyNO`xrb={KbFoitm(#o
z+kl{eh|(=R7@g9c8$CJ|$$@k?BHgvo&FF3^l@vxuN+aDM-T3VO{h#CD*muASUhoFa
z&v{)JcbQ@w0+=(|AQ;&`jy#WfRZt{E6s3uvVf0m)9nxK>{>B^j+BW`}q7Qq;DgM&t
zEi6|xh+V(R4cC^lFXWYN;BmviIuhpUSCa0v3(Cz{{A7`P>eFyw%GZ0&9#-S0Lg0wG
znw7g$N~`~#NM~V_orCg&`G}t5=8pYa{7k(ZA<8j#&{($2)9t54nzhuuOHq*{<erDe
zWX>oB!X|Hudo)^C_IXhDfk>6hBJ2-rK}pm-{JXH$qyLU{B|aL&^KSO;D|q9{%)YTZ
zyYWsU&~QSmlmsKwCu4UI-Zs*7wso{I;k*b_geSQUgY8~MVR~R5i7Gak=yT!*l|={e
zPl$M~C9oKrZuM4NTJ;M;w|>u$g>Y&+cUU#Y;(A4~|MaDzIqbCYvMLZa0;kAVV#s&|
zTobd3Rp)PJdgMGb-lWhBru4qLGHFQe+zrT`V_5D%df~Wv=6JOY{iQq2jd96u3ID1N
z6Gc`CKO4v+imb30PnmsU-#C5R%=Wh&+GNpiNYm?`{f9;(hz#k3ct<TCEXOx}h1@!{
zPeqcbM9m|#Cl$8<0DaTRQO|#9!zO@>-+?E>ZIkuMKJL^!JCEmu?_Rce4AdI3LUa`f
zU_pj2KBi3he9ekqI(fTn=^8UBJ<hu!Mr;d@DNNPV^bU>BQKDEK8n7{u%xVpF2}@hl
zwS^9()VVdn$HMTGK@`E>@!f9KGj8WKkhz03NqkT<e2nQ{=^6Lx;lBPdlv!t4nzr3;
zqb)^rOk~d=kXoUQuciCFrc<JR|6Y7uulU#PWYHpJ<8il2r|UiMhKxgD{R;Z~s!Rg<
zQNY~<GZZu5MsFtloQQPq8`9Kr5q{PmP2BrgjWCR9hKZ8aQr7e}D{4ea1H)B+ig${2
zrdQj$ecoz!Ok||p@=%O@u}fdoql8wUzdgBRX{awmm?lyjZ^yt&otaJUriUnu*_|CD
z3ur2;A;m&`l5j6-b)7fW*g~-~&o8*=dHssY$X>Hm?u#p%f`ZcNTYlud;KHRX(xEa<
zgM%Q<To=MWcd5D-=OjtxyT12P9duyUmyM|pRGA-}owFMWS&a1loSEo$4vgd9a@k9E
z@b{YK`ui-0RZ4_Ye6cY9k>3b_Dx;lr?!nX(Kr?^y<4qw}2swiQ8zxl*cA~a9rd;?R
zq7P?h5u95XMM+0RK@A<7=6-h3Mq-=RZBLfH+Y#JI)hGQpGh9=NJG;#5JL7+7$7}(3
zlAs&vAb`}DA9<reL{hm=fa5#7w1DR(9RLvaN%zQ<v1eD}H>;zkk)gjtKaRgeX}CRr
zul>}sZJM8`eW|c-fM*d_v{?Mf9rPV>z14)Q6xD4WtssGl@GzA6Fa0XUx&IA%dsaAW
z>ND46^Jsd_63UqOjTKay8sB-!^kI*MLek%aotoUe^hNKT(yvh1GvVv4hRa!-k-}PT
zs!ysZPvCT<8mClqp-tMBNT6O@pttkG>8@#-(hsG?u)`inT=CGqXa3tkV#^7`7H2hY
zV%Icd*A?rdAlVBnwkq;R3^NO#j*2%K7Ex`x?vuo+{RloTSSn_ZdBzlK!7nMC8!uBY
z<29b)f5?YI)lfAPs%=i(Uj{-<<}>qJf=ZekFn}?d$qJ_VY^sK87GNrL<xpUXnyrd7
zFzmnQ0)`fL0aFZp6J{aND+`r;%tGQ4g*Sv>UWN;le1GXY=awXmvBWDMO^5Xc(MU;x
z!5Z3&TSkg48zs>G4l9HR4+Vjq{lEbU6n<ie1S?l$VV5L^@j-Plda<<`YJL%>oA4H?
zG@5@11AqAS*>x@YgK5E6c@cRy+b}9UVMV99_en>{hz<4AJ`Pmb=|s0S9e+Gf=bL`V
zE@DO1RvW)ROap5$_~a3xoW0FCw<4O91J3{wkqTP4mJAnb5>eU>w2Tz5#q^@Il6M5E
z^r|5R;Z@O#w4VSKQr3JM%Qmj?&cWuODd_sg4g)F2E7Z386Xm@|5-MB3d;DZ2Lg1cN
z@4kjW|8A}q9VJdFBMOdc$KX~`;2KQN{^~r->E>VU;*ab<7pumRYJAOVibLD@8n`*;
zfdV?&US}mV@wnz-fIxFsJ{C_Hp{=2&IL~KZglWDveF)R9Ns;bphN$-~WX;NjWJfvP
zex)S)gF+T*TeVUhPl?||gn}li&vQHd$RBD+g9Q0+%TRNYTuc6zK2h)fp~WWf0)jaC
zZ|yeD<z8n>P}O~DUv1#7vp~K2pLm>WFZ+)pjslhaoRY;nmE1wLUh-o!u~Z0FP>Gub
zGmt^~O+C;^RUr~aL}8B66eZ6_)`VOzkT0xk8hrXv8I;)Z^z-KtuhdTur!%skd5TU6
zya4K3Nh4R!TJ1@WOcm^(pXi%HUSgjS?Yo(>NO_I+()53??2>5C-(>7TClcNsKz?zQ
zGn^uGEL>+pm0-;-DsfEXteC~RT)H4>gfbJr(`rcOX0{4NMZtzfW6{iI+nMIgf(=2g
zAwkbEL6o*s?UZza1+(;4-3sPH3~R}qB<L>c)O^t}W5Qlk@eU^RR`;*3+N|#+!fi@?
zCBJSK7hAlZqMRm8@!l{()1n{H=xy0owG$IC1CQiLTBGj#CEGw$-4VM1Un&L9YU^yl
z)>W}O(se<x+m$|Q1NBuK>cwBQMAAAe)EGi6anRUoiRq`;Rka8=+@n%;@jE`k3OuO3
zaCnG0Z`i#hn&?kc6mD=HM>wUCWv+;ao4MfX;u6bSTt(S<mF&+RH|bCYj2S)LP*i5a
z2A9@ShYfx82;VCR*>Wt+IGyrjE0$kPdeUSbF6c~B8`&v8ce_s6Khq#9O88<_t;XL-
zBLQ19Y6wZrq{H=NzN#%@o1L+HwceAgXc(<TtIBlG<pycWn#wrBYM_}~)f_U%yuAT0
z>zm*sY^#MpM0ssJR$<*$Hpk2Z1BD|x3l`ql3sfpSrbxRnYBiU!nzk$6_l5!@sNvsP
zi#1x{BE_$qRPBRTUb@uwILB;m+h%4%;H{&K>buUhBcglX&K*3P9TQ1cg4rvNOiZgu
zTA3kW&dqNu(xb%)zG7p11dB+`KKzqlH)`*ujDQn&(WQ|e&bb#uSu6Tmz{_EkU0Mtk
zgKf52GJGbU{orXjSd>Cx7*k4(v`m~^F%YsQ@K)oiIz@UhR;~X-+ik6{iMW$Y(JAHJ
z8Ve8qj`>SHo7_&+T#)=kU-4ShRWr7qm2nh0aBCgvz#RqK#TPOI_J5{UV+`=z0(L4B
z|C}C|YU@slM{#|=^|l{XN11XWClqngXsp(MlRx&2vcbw*V?R(4Wy`)5N(e3G;Y-Ql
zmj9N=$^0t4bt^??i;JqxmZeL??r8UpNFLAlt1+&+B~ERYvga3bVT+uBzMWjbuf9yi
z3kORj-*Ho~eh$=OURoS8^>3{YZ^1LV7V6!%4qCs&;Q>-COLa2#knC9|21hx-?Sx{w
z2`j$!h2P8R<$Kg75D%~PeL4>-+eIh^HsB=D^*OIvRCD;-q<59u04PIBy%76WOA%Ii
zO(a7Dq6@Ra7zv|_jsHca-ZGVuJ(PXkWjGE5Hmay`lv@(LC|RYaa}YJ3;prlq(EDSB
zwtS}teV1IYv~J1Dp{Gg6^t})WP{4$!1~aJffB67zN$x5}7)TGC>$z-;<g~@p6EuY$
ziQl3|I!{mzSic(Gq+$w2oB&!96RM>gZ3>JI0DWeaNk^i+a^o^kw8h<awIcw6lGq$D
z`a*{z5m5}pxT@bl(gZ{d3YFNR07n^3)L4C{UcsxAD@moZq@eo$(%{H_*Spri73#qF
z*2edL;Q#TG4*sVXR!^%ZIsed54E=v0aQ=HKl)?Y)+~<F~#5{_epsb0xC+Lz30dI70
z)$BLgCxUm)H~-N7M)fZJLnFFErNO0aD(C;9y}T}MM6F#__}a9MS(ITEvuUxaPX2iQ
zpCD2vLmV$~udr-FPv<355jBVYGF;M78DOYtRciD$8#cSOsq?z$MeQs+HxZ2(%~Bk2
z<NZ)`(9N$E@2IAx#O~z<a*@NS#apK~ARh?KyhT=%7XAzq&9(!9s?p2mb@$fk;C~E3
z;4+>^2&m>_k9jD&y(aB#&XCJ@3fbG>Kf>i2X&*EHmJ(sbVsco@Lf)J~WRqjhF+cA!
ziYn?Ci7gpQ31*slJjs{w%$#Mr&@=x)sub%}LNY_~9wmA38xDj>k@_N5A?M8I;(g`K
zzB&pDxZ$$FlU$wO$VXS!W;doLzE;K?O|R5+uZaggr4z)qIG8v%GOJ}L!#*k_{Dy!C
z#@Lr&Tb+F8_A%yPFxN+c{B>5gkC%NHEL)rZ&=%}idat@(IpUDLJKn%?K!)%M435%F
z=6gQxq*n$%E)(~WUeW2T&;@Hp@--$A&#~fg`$PZQX&~XE2Y{*H>{q|<%bV56IfYIZ
zyMFqV=IHa*gVFLXsn$QY7$ar30d;t|ulbr_@G+hPOITBP5x36h#)*w*^`3Dy+#7j7
zetHy0DiRYvBT>Ld=0DR5^l%pq%k()+-6+8l+IKKjGPDXPYAu6)Do-P~$Z{DeBz3M<
z(PL%?X)=_fE)d!rO!gcA1GS^6y^-T@?Tzt);%QyGHeOea`CUUe9V(mVTsoxjpo`!d
z2A!*v`a8MnBclSi?M$I56XVPHvaJ=mfQt;|vi#P@Ao5R}pP10@>T9mRcdJoG;|pA|
z>$h>?OAt^Y%q2YI(Ds#$nBROgPK2~t3y+3pacJ3>^y+uC2199WgWQT-eB^%q^*K)0
zqN)vz<&=X9fGiis5+X%AH_~CF=!SJ=1hdC>Q6W?YX>TlM)mH!65!0dvx(5<@wn5=)
z(xI`Rc0}}6>SfF20W`j7fksYKsn_9<Wm~I+_kEl9_s+|K;xCT<tk^HNqSwlYip%g0
zW&wQHyl}H`we2QVM|g)i?J-AsyF9Uuzoy_TbM4+!Q8_`VhF;X)Gef3lE4uS#0@Bz}
z0g36~f~<$Cd*OUcV;ZOdGb^|XoHS`Jx7Ubj;$b?!eVLS8lezg<^t!=MCKsZ@uSaId
zV|nrO_nu!9sMVM|)e+D5lGWYyDavQ>_P7Fseg~0$YTIZ|f6vvW=BHI5Xl3t;bRvbf
zzsvF*zyzj#QNNy{8WU;`DAp@=M!bW)n`6RgT$QB2#T<egt$eFp8l(l(4f?h}PHwG{
zi1ts;u7{}E1w`D3R(E!3=Oe@ez>hs<!g~>K+gEp8w`$_4I~SLNO@wu-a0JIfFZV6!
zg(14&vTN=8krnd&Pb+u4qq%3(APJB%mM-HDRM&y)ay^ulojhB=fW}{Ug2A-j@hXLM
zTl8c}KtNIFgk3a1=Ted-l(AxyS++n$>!h-LS4v046?9uWm%it;nde-i^TO+H5=*}7
z1{q_TBDOnv0Lc!s6qbGq;UMBlWX@L417hFKaO99SI-aTe9!HPkygCFxjr;ocilPF+
zj}z}M+25xpUvXO(TC6k%7Hk(>k0=FkVLndCdI?U)d_I*H+hjNq8>csQMkZL`&!8F?
zUB^f9jrHC|1ovLZ8*DEY#WV6JZ}0W{@%JtZMg1i2n4U<ju!%3B<@cW|JRAQB{g|Is
ztdBhTqVl=9CCFs-OarNR2}6b-Br~-Siyb4Sf?0UKC#*=+Cs?oGH;FB?e8~*7zCE1@
zkbEg_a5aBIe!<DL_VOA2#V9o+4gFc_J3BUM+GSz52kJlfvPLfgWfDwh-s++~G@a~5
z+;#D9p`=1=;IB~W5PSHFR#(vswIY4wmo`*CWwGx3Fw|)4{Xu7FC``xd7M#iTJAklW
zOOrqO8#Mx)NH4(0T2TMoAWW1$3du$*9M)C`1eJK9#%$oh>K41nh@&LIdjugmJkGVY
zg%e!1qQ+_3_c=V}+-8j=?-?NzX9dw5#w#>JGTEYY?a<i`$tpu5WPQw@cHVDRuW&A6
z_>}6dUUzU@Bd?cXCJq+eyS;)KbCJu$OJd8^U!b3_inJgI^gpc92M|@211cOrtOY93
zrb=^}H>ZFG%~#p#jLPz*Rdj@KzW59$jx7e_3C~_v##ZAO?aCOTWjFXapg9}`8($q0
zLqs1}b!tuXph;>x8a@S*)<a7{O(XZ>51_uPdcT5ru^P94aQRU@HRQS9SS)y;($m2N
zDUw|@P(2N+D72fllHMFFYrZYt!GKCTFvS&xjN%n~;;4Z1{zetr;sJizN_i^R7%D|7
zGh`63J&$wv^fIkwPrBMfO)|r6ev#LuJl{$lqtT>0%K0GMe$iqJdBegyOX2iq{3~)W
z`f*u3%W?7zp|;L(A;PO3RiuJ_y!=u{4h~tN*^dqS8`rutZq1*6YU2gD7HDhT0mRqM
z_f&zls;bcY5}|npx7)uX{w5Z65iDuZX#9;PDz#7#JO`bS$w2g~PS-1Ny)j;c+)+WG
zZ!YF_u9|I%+gTVu=9t~td6(<uJhEsYP*Jx)6Z53E>@?@uA!a$-_nJK<J``B{?7oDH
z%AuB%Z=*(x(RmnBlDbtcGtzo$bnfyZA}Oax@2CL(gK)^0=o9?r$J&}mfaw0xFh4cT
zRYLV*EVQNWo4vn`RfKwwu53zE+vGeX$N1<x`8j<UleQFC2{foD>V4@1?b!Xp<#0*m
zkNafmydp3olN=#UyvW(P<MR;r(xDTmO*~33SYtuge!{aFJ<9Luv)=!emT=`!<d}Rs
zpwp%>cO(LL`mgH_8xsbViaiTw_(#+V<y7zb3c~Ho=csGPrg|n!Pyd9yv?Kd$A!Xv|
z!r0h^9{CYg>=lJ$#;EqI!b#-TVb+|b$cvP-c}p~lQp{?^NMYE($Kw+xIq_@aFZZPt
z_5tw5*+Xi}=9SR_9R=bvqVzc{Gyb=_9ia`)Wg|!pg0B-VhY?@M9Hw;;iZCQ}zx}<H
zp~Aq6tctfXtXeeNOV2vrt@T*H|KZZB`{{;xbmKRrVlDKhrIp+_6h_<bw_IxFz=LpX
z3KO2#YQx3^3SL?Z6*qvF2IO0T%UqtFQjIhvoxeOVMSHTzl?TGGm{{HE#$BhoN5$AH
z8xFYV_;^cCDU}_1fXT`ELfIm1{`H3!s#fl6+oxT3!bcMEzd6Jd5Y1kn>LD+9+qc79
zuE575k6Cs!QC*NGWdDjmn_UUb&{ahsgwG%s&)2<cW9nF<G;Mnj;m6ngjqEM03vaH7
zXx(QS7()i;CTj8eYV74k>YhdU7Po<cg83UPCIfo<Hq9hTG@i&0QN+)%!?BZeF@B_S
z;T7vDF)v!9#@GBVRD~QgB}Pvs_$<!lXfwIq1JjUZH2y#zXQ^9~+o5T`?yvvQT(oyx
z9@4Y_5BZG$AMzQy!$W<T^&cj)Pd*{FjNgfea?gX=KmPa+`A9`+=iM|PU483~X#EfQ
za6T~I%JC(H<^l5*F5Fe5jh&IIW0|HUqok2m3|1)bML`I!7=%CtV(_#9nZL5o3Q0gI
zDk$9sBT@nIib{?~ffik}b@v80j=ON$$7VrPl5#C@()dQ5;+xZXHmz7*+pT&Kyp4lb
zCpT#uYjW!TBSX{pUS!7Bt@?Xd4R`iB3buD}<%J}$b|V2*ML#u2-}9!8T#dtcZ}p+7
z3`AV)|HpnhbOusCFG7boi?;wU&oE|QC<^hEH(_p(fylt2<}s)!h}|c?^a|zKFO~!(
z;cBc|uVgt&)Ywqi$Bs~-Tm~4*pvD!K&!mvr7lTj>)yCGQgdng$p}=5iFg-54E;?%%
z>aDXZ@ehP_v^g#_8V66hxwJU1dy-nd6@e9sGND)xFpS8YxW_z6_Z^Nr7X=9lEy=DW
z>C6e!JO3=GbCylT5hz1Jp#PkoXnJQ5LT66qO`9dk{9#C!%^>m1SKzhcW9yq^Qw1t&
zvm3$QIcno-@qe6~1e2=*D57UGqZ%Oegc;E@aZHvaoEYZz#_|Z>52|z3N6An!P!6Z<
zXI2GP5aJhwUGJ5}QS^-VJ@3_!SXB;KKmDpMaQTSO&jc8Bfr2`>ukFvo15b7&R>#T`
zRriHsEy)QKCkKzd%(H-LTV7iZ3Js%Bj`PFd>yeWS;-_KpP(X0Pyi#JWNw-zkN~a${
zB3>uE0EKd9;*QXMybQ5XDf%GuX2?;YLKcI**Nvqj{(W=#jr~=R=MMpB;QUm~*Zvh=
z<XJ5@(#*x{k$#*XaB?S?S8P-J8vcKp4hrXJgXx&-P=*engVLZ<dWsahlm)5(I+NUg
zVoxGO!{hDG?jNOXtBI&VqKCn+x2qZp4~bW+z40^k%Y?=>69Af6KS6Mkz_h_A5R|Th
z4P&!Jk}?zUh9!cd$_c=sB28ls9Q2S1KeZ=xl&13^(HUJ(z2G!{2wS~Ubo3>^6FKuN
z38<XD5DP6&)%;78a`@gZY`H@^`4yH-o(9~J+DBdWy;yu>5T`G?0Zx^5|AN^E%D>so
zGm~poIi4fPf;3x42$jer?-5G;v2ZTlM(1-G70gp*bG2%5J${~aGtfcAcF$Z>a)i}P
z8@W&xkbF`^O>w(%9TknNEH!rhg%^fim%MO$)jJHis5bnS^Fc2mR#pI<+CQA=JFQgM
z2NTm*a_m$l=+1l+z}unTuJljuu<+#%+x6oabJYtSr7I&k`uL`aa6@z0T^nz*%s#x#
zUi1$2{hfK&Ow#2M*>H4NYK7{Co}*x#wW;<HwjRAmb!K%EgE^n3aweAiPaZY`=WGx!
zm^^frOczxLq3vSw-qBsJ)>vKOu&&~QF}CY>wMZ3*cIb%*oHv_mBi!Hsa7&+O%}Mnx
zu9U49{l)x!NN-r7KZ|O^EKdrO)HzGlb;iif*H7JuL(^B4{a|3|Em8LHVoCj=Zs+MV
z-@#j=#V)~7T9Y<eJ1P$a=+%iRcMGSuR%I|hcvs_du9VxL_bvDG;=OF3q0xG`!4uxS
z{q3O}B_%leV}}Hs0vRRjq-5JXHDB~6kF`SqA9R)zfHRL}){sdL5p2FDIZEGD*L0hO
zN<P$1hSrhSL_I>0ud_F9BWqgaYKU(YcJn{H)t>kq%n?Fd)hAeTuEL;6_TF`wqTg;5
zmcO>f0*@^cs94PEOLn0!_0>(lS!oop9<V25w)<38rWmCiLCEM5)zbA^?moai8CM3u
zY(HCLo{ySyED>Lcz2OG~$`_2nFurxW-N71TJ3B3tdQ5IhI@(;3Z0gM}7+0tIuQ@GG
zDBG&H-MS4OD07})!?3K?81+rd;W&1>S0U>@%>Z3!D<VZ!4RF(K?Sj;0Jv8lUvMc}|
z)gqhF6;mcs;le8#VT=YpxRVjWgt=6MvwA;`UPh0Px$O)hx#H6;x+@vd4O@03fC~oo
z(D+^R1L4!tRpFBe+8uC)sQQ>u>t|-I*|1MWsKDfZn}m!8YJlEq1!Xz;SLGD;`k&FY
z^)770%8XKn(xOd8e(C8mTskdb20PD!OdgJq1&H{Hf%C8O+ZJjfzu<$OUO6fFeY>C5
zPl)n+`JT-aDA#{vOM2w#+-AVreU+sRH}R`k2=B*mNL>Me(pENq{bAv>Z!9U8)|(3p
zLB~`PSbUe#G-8{mf;LG2ESY4BO2)*lCyp-Ge8cpa4m&y++h7=I0mN<mD)xDRbxeGa
zy_KLZRW+lRYdc{1^w46iyppd103}9Ym&pQI`4CiR2{a!=b-;iQT%uDK2Bs`Asf)ze
z90S(_l?myj<$r>LF^K>=7@<9A1Q=j?>^kdhMJ+Jv&tX}-QMO(pzb8pW`(sH(RM~?1
zd%c_c-h@t%u1u60fht;Xx*na+`zt2(ODg;15ru2WUJszI82_;vskkR6?yHFZD9!ah
zw6m{L7Pk~*8<7LH2rTR7o7KNjqQ5tS{+Dney3%lY&_MMq1ob>lEd;&1*6A3qX&WJ!
zLx<?HrZPZ3L{DMAQH~cl&^0xoLtlPgA<l|w1$XrMsprF&ZqW=+avEyFj0TR38#%}8
zLBZ&cQ?0GN2FG{p>M2EO5-Uczv0nRqafP@Yy~w)^Ke{)CRcc;}3<wPN#9e>?VsWwJ
z_`L^d#gCnCB@inZ_q=6J;Bz`H2TZI28yZb8cD}CKtJg@}vuEYTY&9fk`?%^vYCkdY
zU+~V_czW?2Oq5qH?4}KzT)lG+tvO<q#t#)(L&C$}vI9y=KNC2HKCn<P%QmsBt<8IP
zG@ll%TRY5@e48lm;Aw3&Q1SXm3p8VTP#omtdJEof*1;use=!v48uba$U(Mvt)`Skp
zk_?NjK-(i-ESfSa&b+_#09<!DdhJJ0x~NUzY8LiPo}FG#YPVn>MMhC?VHsl~u-N+2
zbnHj*W5ZlG22{R%c39$_?z;Y6EN<QK`{;(ie@>f|Rm2@k3%ww%n=uGJ7VAO(O^RS`
zZ`fukqG_}&3`6{yk#-8z8A{y~y%K$*_2}gu^;K`EO3~K7F8d0ZH%dmlOHMpjSTl-%
z;D*3MH__F1V#i1mn;J|6nK`xUBRPsS)2KBC*_>iiySyHK@3{C3xz{ED_Z6mHjgAxH
z^+qr<W0uo5p&0D3DSa8H3pA!B8M=*lFL$Do6w7jrSe*;Fs(~Q=Fd#G1V1RGTGw=6<
zarz?cn|0f1$8rnRRhIFTgQ;%sNekk>LGu}^J0rfAe`+h+tUE_RBP-1Z_tWnUCdwCt
ztdvk{9TGU3%24X6qTtnIyg1)%b4_>ktuMt@UW<NfO?mjD3U=SK&PIJwoFSZXMzy`8
zI1cxj7iqSN>|3nWJIZ~_(Kw@)Q-Zk?OeasY$KPrP4^2Pj1<mj`OkQ$2J_v*l8|NR>
z9VS#YpBm1g_l=FKwKPv09#OTTk{h|(olm@RAoY($=s+ob7lV|5Z<PV`a6Of#E{CND
ze1W$EhI_@71v9NT(?ga16`&KHa-3@W0UodSYB4XNVZaH`yA{80W`9KRtmv-8!BK+=
z_YZ+1TREta&`*yZj^>;PyB=i*w$+GhS}4~SUHZ#w*|^to%V@r~Y^pmRV-q5Q!88y^
zC@y`|CK?s$CPuim5!;<-&1Gn%jgzbA@t6Y;J{=1;syr+u#bcGVZ@KX$njTg;D6Jup
ze-`r9!|;IVz<2<3cW5;!vI85w5bAd41Ve^Kv|h#M^5XL&U0Yw4=zh;VkGN4g9Stf^
zFq?=sZbBjsf-Kw{OpXyG;?VC(%0|<+sn5gLBwoxqpPpr|bQv}Ta(FLwQNbSsMi&4}
z%<4>>TiWnd%=pp)oP)kn!k#ESXn)^RtdEbAX_wsyP<Wfa)*YFw(O<Lt3J7{Z6v13u
zy3bN<t>?yqI$}$a57z!!NnvNcuXkOb(Gnn8^iD8*JdHIQf~oH*BXlo(e!7?o(&_~K
zRSuZqXrdafG5s)9HOr%Vz+7r^n86FFVUKe7n?V6WjqF9utuH>xYFwwo0~k8hKE@=J
zi(zBEP(S-dFK9O*>FS$XSrhSSxcP*>n>Vc1PmC1UBfm?(R^1u?dO1jVD10fXKWS-{
zm!KYr!GCCVmTfxqI+w;QdOqpb7ZPWwk6y^L?9<!dPZO&tH}1$A57lFXAQ0p&p!|&G
zB**-%{W5#O;pn`y%nM$aXnazH^(syfZi|%rxnH(#yI;0f%;MqsLyZ}d(^P^{sZFH{
zA!CRyrT=}0!nPdednY?%E%JzHFm>N%`M8%6f2`rh`g+QHR8{n`gnyB}N{t?&g8g@=
z3-=5v(7WyyZwnGJx`a}@?}laOeO`Jt*RL(Ls{9D-7Gb5UR1KXv5|SCuqtxMbikG`|
zKc2IG<Y61H3gZA_waW`P%L6TuGv*WAvfw`1G3&%sdV{i83Ll8;kD>*!d0ix+J5*^n
zNN#dD6&081BKi#R7bhW*?|XtxyQA>xWt_7$Kxg0yFk85B#HW95Tu!mVt~6GZk|i_*
z@#<Bm&qbKCRoWEp^ApYwl-f7)-T6c;ngx~7W3ci_Giyw2%^GV~K=5hur9l@(6MRY+
zufWJLS$R6f?o)BBNY1y~O9Che$jwyLR+ma|xbfb|UGd31MGbTy-*wTm+}wt9!ir`>
zO&F+?@P?naze7jeCmDqT#WDoiP5+@ubAbRMB3m{fftELX9$!{!8zeZwc2vX9g<Pry
zCrEn6@i+RASc2f6ws=@wjLibTR7x4M4R1vk<PZ|-$&fCb{Ug+cqLQOcHcU>XL`zR^
z%yg-x_XCVmM#OzRAXzZ<Y*>aLIY?#7ZGJH$Y1$6K{VYrXbEV4JQ7N3`HMi`2RSEco
zj`M=QUl&bZ5_4>2JfT~6HGv|WPyFdR+0KG}d^BfVOkuNYh%-z$lv0Zx__Fuz>&^!D
zKQyjLUFxzI7`ypFN9Dv<QBa6si_Q1v6T!l1`mv=vMf;j-;I~9T6_@Yr7&_9-0?Nu%
zrM#W5jO#=NT2z=~GN~2Vh>ZfWt$jM}jbQTVDJr0%pGXF1m*vY<o6>VEj*o6H)zO}>
z`IwJ?NEs|PqH><DNod2j2Rj1|54C04Hz*CFAr4ccF4*d9ES>F;k{rfxN-iK50<57~
zkh@6TF(6QK$J`zMv!Rf*#sv(qPcN^PLnUQ!IY|UwT4ZH7`<~BPwPxosEVY-Gq0{tL
z>uO<yy<pZnrOok{BWAXFQ=!Lau!Im;bSP3%KyOn96RiG7XVu#X6cFh>TUDu~4>y4V
z$zK+)vwU~{QjVW_Oy!@I8u7*j@eFq&y%+u`MT<trvAJ0n*i<fy+7i}krKRwNs7HAb
zt`ygWmU8Lhh<!X=MV3cFQwwG~agoIzDq!+!FSe*`IG85jv;B_6i!GlIA`E5a91FJP
zteZ(r^d+-;_77C_j+wWDO=YuGKE^DI*r<l44wqJHlZz7P`pIw7sMGRg57Itbc;?8p
z_&N-q=7+rtCgjzUH$Sl&ti=h$;Z`2VysSG#{P|FoN#&6!^AD}J8hh1+Xz4mDHM25(
z&Xg#3J%T})db?0%CbNCllSWoQ7<WU7w{cxa@ieasGPyh%c1`-mvoDM&yp*d{r1)$X
zX(plJ7mwzA*Z3l`^ffQlxw3INZocf~nJ*@LAfe4*yy^Pkpm_bIfGZmAd591;c?326
zxOuK4Dl11iKfl*rv*h2%^++w+n_9vg6G})J5bm9G+a}@S+e+Pb8^Budrd<9{yZd|t
z2FgpA%u)*rAwy{!Yz{-7^R)F6cL3U!>ZiWz-HeQLmdC7bz*Vx(`|qcYgO>Go-c`ek
zJf8NyiChT(LyJiG;}Z0m_Q#*`9ptH*Mjm(H%&JVrxD5OXaX7*_D>;-^lj9hqBm0=l
z@|59l$Ke0uw62|X(|m%mV*WpSQN974g+irp_|%cR&D_p<k-CLga=L{i%1L@U?;z%+
z83L6}LJ)@O^pN0kUb{DipGW|lvRHB|n-3%kt1N#iB*=cfHNQ&D3qI6efM_tUe(IDG
z7w+~R6dF=@f_Gj-7P92~{BW;FA(xB#dpm$npj;ZNSYt=H+pFkGR|@N`EK2MAgF-Ge
zxA2E?Gbvz#)q=c{{45h#J4P#8w`@#TUc%OjISBxhAxtlhdi4ym9~~DnwV!|?yqAF^
zidgz*Gy{r(BoWI;Q{hE6FxksuYLjYH;-b<;s=%g#)czzu8hEUymsFk$_CFmZ`cnaM
z|0J30ix6(S=<>S1{iy?KvYK`MNhmdjFTH_Y|5K<oPPl?53cXlr;wO1qYBFL1C`i!i
zWX+S@(apnp87i>C-;|)e!~>9{F{GRD<db5n^08uSy$qL=#!=-W7eFJHO$B{u2qu;#
zR<0y6HxDfygEzCi!PEtO(nBZ@5lE}*HBEvw(^a9>f@}`uOgJ%=Q?89o#Qnr0HJJ-w
zt4aWT@Mpi>28ypFD;6%mwsIN-rUNr*P)A$BJDbvlhnS;4rIh7|osQeoZTWrSH~~5u
z+n&~<d6I(Y)&GH&+>I@#h;6gi8M_P5f*M$U%6SHSo15BX$-UOlFQu5U+;v8k$9!)9
zwsH$^U^;Lr9OD|jStHbpd4|gVN#kp@s6CKL)DM2jqK*)cT_qburS5az!)sZPW`^EU
zP`8WNtdl+Ur=<Tx8UOk}<J%=cf*7h@iaIJ9gHB^=`8P+mQQ1#Moq3!llC~}nQ>Uo*
zBcdgzd6GH$C8wVnS;vxYOa3RNN8QSPf$2)tbH|az_=oA9yoa+2P=TyaYglL!sv&?~
z)hdPpA(Lnof@et~gYCXWxINj!%+}cC@ucv7y3EiKc1=XZKeVKF6lfXyn;Y+Q#eaCn
zAx4*_%G~s)WSTf9p}na1&W$3$hP(Vd|GEBq@{(4EZOR@{8QiIEK?&!#M-+T%!;6CY
zxCJKV*u<Ko=>{je0{O6^%bL_|#Q^5ojsDzAe0a*JY^zw8g&78p#XDT$u4Az+xo5ZW
zBJnD#azz~YCiPVioLqb_w1^NzDbf~<T=ktCs-i??h9OlJF0@NcurC`-RlUM9`}QSm
znpHd?<}~Q9(Up2eVN>mf(`H=;+=&reqIhlH8qmxvfXvya<au}|I*yBQs7}Lv;YvYf
zN|@$&QS2VKqH~oYVpy;vn=ZK!rsz^DhnsjN2gW5z-V!wC?Fe(ulz}w;dZtRpkhRhn
z_k!!qF$<yf&4KW;o(S*mOjbPT&!=YGLtZ_JBbppSQ{@r$o2?S7C7%=UD$~S<2K~T~
znsqHByBkUzNF#-s_S<?JJu65+jZuU^f716^r>2*E%e%*!vndhX2YtW0P)*=4Gb!Y7
z`umYJcR5uaQNEw1;x>5^P3kWv_E>Cm?Y;%qvc_=#kkoE1*bV706qGIW$WAODhl$AO
zB5;@TCZi|*p;14j4w8+kbM1>hG7CtbWr6jbebjHrF(#J{(0N{ZVS}x&vcS|tacos`
z;Jysy)Jy#psQF;@_c=Wy*WGyuYyMu33gsH}4ppI4y_t9?WrrP-Um3%wg#pC;?rb~#
z_IxdlzEAlFQ+BTGv#l9(yV_<Ijn3y;8_!RUt}j`*x{30>-ZqVP`^SzQDSwC){H<*Q
z@OU?i2mem|Q+}i7W^Lk~K8;Ut+px=|dwYL}0`4dD`dt6hw!uJED>!qxNi-!yP2Mv`
zmu-`O<6493ckj9F0?r51RZ*2iPG+E`mN-*_qPVN#UsYeg?3UW1%_PI)HxHY|)Nz_w
z_Oz||DBw}pf{~^cLqq0_{+NhP@n=z&xvjw+C(9weq2;~1bZrl|673ANf&4{t92x%K
zal319lVtbEtf_)_kE~|m6GLM}_qxu@#j(~wu6TdL_quf}vn{@SO5Om2y;jb|Ox&@y
z)1PfyZ85*#9H|MKd=vC9NzhctZ1eeI>8z;DF{E+U0ErktK;rWW)KfY+9Sh2X!So#u
zK*$PEP5njKRa^@N>b-f!EbFpurtioY#bExQwBps*&yPcgYWJWL$=6ZNl#w5yd!G0K
zlOncI+p@xfz#J0(HI+F8?JM(lK;$SZ#9RiL!H33RS%Su@N{3EBPXI2ad2Xq!i={f0
zfs$gl+ioeymi%J}xyy(4SKfxdjqhlr{o@&wA0$GPCin~0A|w6e)_UdjU=l?2Fm*5X
z1dxh<Kf3iF`)GXpmUMzDG_tu5Vtm*fmtK#|1nTJ7zmG$m;j)Y$%<mX{y2ekXEdJ-M
z_;%&}{pR*RZ$($sEAfQl^E8&C6_{btQicLjaIt9a<sM2MQFe=?kLTZ*L?qtn+-y~B
zoaLtqz7%!Q&R?UUbe^*mN6YDIp&T5(L#gMn@g}!Uoc`3;-Bs1`uCHXu_AV5j{fZ#^
z^|!}Aq16XpSLu}`MCQ@FE*WM;4;=oC%ZOzJT(X+|=8|+1*_V&bNI*9kLqRAynM@<_
z`{-KCRGvf&M3)kLx`a>~gAoWomPD}f*9twQs`8<;;2eEZ?xm%aW0G;f8ZSop{-Ot$
z@bJN^Ltt@qUSVPlak)c*H%7JtR9TC<hp3+kZ#)~$Il*<gHRWb}Uz~O_nI$~8WAf*<
zfDx;bXgch(;Wfmy&>o{z=l)f7si^~-gDQ-hg|N6RmW_B_0X?J9>(_zJjUZS3V1QS5
zOgUdi@?8PgE*iSkc0M`*hM+5TVa1<TLlgI!Fq#R&k4#+zaUe;qpTY0YdWuX0(c<<9
za;~0iwoe3^FKz_a&NWs9r_wmjpGXB_8q#C~?B%{-V{1xILU~+3UjwjN2ZKuqfIyJ@
z1KBGgttC1f2cg+L-W0@Ysa$F7LWd^GA<sG<X(PvPJw9%e;1r+x&XZgdQla;^)y`=t
z`JD3wQtg}=MqCnKZJ@IrrS9E|;WoC)6=x;pD{2uhDXCvmGe5}HVzk{n%h^O~@Llg9
z0f^(+tPHV_`c3R|7w(Po6GwX?X4L4qNnbB2us_R^2LjIp*8!H|@1wLx$|!JYwz(wv
zZ|`;++0zVzR{yNL+i@z6;YfG%&^fqX>$u9ac{yf?;B0t9GE8Q_UJ&~m{z_emFtoP0
ztE2fyNxZICp<<?9fkzi9v047T;_Icq<?xf!Z>!&CPhF2ee=S5k_MReC66SyH`7*~R
zS&w%UE|2bV3!8vb*Ntm9G>X~UW&^N);`5~${7%-~>0E`U%7Bv`Ydof!^kja|Bt!3_
zFqqQSyPW)<Mz*$KHb{=MZi&)^q7ou%zjqx~_-+O84D(u<Lc(n6S3Pz`c}8P;``4Ko
zoZwQ3OYI)t(i0W$py{NA$7(s;@6gA`ze-@x=uqmB?pbTBjom_)x*$`^bkZ`d0%o$0
z-t1P1=w0f8oo3%zbksaG=*|^`S%dRK>I7qSTL6pi5bup3;;TbW__^JOkAN7-MB%`M
z)3}v(O+y^DAcK>OzbS(b-f5itu9ge*xLj>Dw_~OJ7%B;rZO-|A=vSvSmMvFt?s-wX
zS<C7zmxpRo>tURmxgy)&q_BnbX5Go#@w<a6m<DN$rss3blCrD9576+G<~O$1=*{i*
z81oW_nM0?oA15yhGOKnH|1g*ssDsAK4<0bPqS(At++p0fwmIX=7zmw7re%8-*!0Kc
zhIpN;(f00L!U;45bkz|DQVy_!Mk;(jz8^?N{B+Ao4j0E#4Q_19zwYr5Rq$I8eEtmT
zm(U2NVP_5u@tq#|hc<^2=}I48-x2EGi<wQ(`xpuMt2S=4jKH6i(>B?D<@r6kWM@DM
znYewYQwh}O8ldeHehSFTeQfOeL_lw@+|qXXNq;Z<Wc1~^lH-F<Am(0wa>2p`?J3B4
zn&pR7x5t-p@H_Z^##b2{=nIGB&sQU7qw7{P-FTgDv8T(1W=ZpdaxJ41^3TG%O@&tU
zJthB&Id+>dKmVKNT4vX&qc|jCgK7iP?G9w;tSue%immbs{Ny?yCZ?w|oLXz<_t1M^
z3>~A!==7?6_7AOiy+zE)a=)(0U*EqNRj<OASW$1`Smznid~Ai&z?F~`8@Dg{g}w+r
zKM;xI!h{<cA#Em|=#OV$Zx7`9V(L3p6#}Dw(e<9_dGj+rdSgoRu=U<Q9~78=omMF$
z>9Z-B$t$rLy^C8w55@B(9r^A67%^?OuyuqmB)FgfF=O^~lW{~oI;{@JF`F;crB(Qu
zdI<q+7wVaxYL!TlPSr=kx-R0rhAKjFVDaGh81acKE_;@mrAfz7ci5c1L0}2i>;+^g
zF*l@UVibLUHS~vp&1_Gtj$rw%<)h9i%h_9=Jw>KJ6wx#NuX8LcU(YD5eCP_xqq?UL
zpG1&}nAcU9E0^cLWr=R(9oAl25UVW!lypRbp``FVRmCn$t}jp(pOP=$YoXU}NxBls
zTe#+Lt*PL`%21sd)ku$gG|S1oXM7<^P5f=P$(E3Cr{-TigRgilk9s{1S*YUKag|Qa
z4qnC!iIqj=YUBCWqNd#nR}AE!Y>-GWgr6xF!>j#;jX*W-X4;a%N+CQZUG13~zOen^
zWo)vs$J-h%JmH$NgP`Q4;;gP*t{|78QNaY&pe~j9K%^7`CgD09H++T`RGjy0`ZU2K
zaK1>R%{V0dE9rzR@e9l?(`$ao)ri6B<5`mx5uxLNzVQ;FBDlEg#*Blb$@h}Kos-(h
z;WrQVotvoh!Ya_wV!|h`z*~`w7*<a0^+IF@`7rh#Kh{u+^eLXJ+5gzkf!!U=E;?Jb
z3uhIte9F&f{?WE2%P(v}N@MpLx;6dFi}$eLJ#Z#!JpR4ipkggeo=1$GX>WWha$7hS
zzMw`ZWnz<;&D>yrFT02*T7gi&GzZpt@w~DZ<hmn}G;Bitp|EtDO%}=dA&XDKG&R+2
zO&~r6(M&AXS>ILf*QJ=%T$QH}Umn1AQEL;uL#ydK<#l*hy!LYRZ7G{w^|hkmGn$ay
z2YemG*HGA-Of3OoMXu&*D8}OFKG9}f60Pqk4MdmaU~A@Az@GcV>)-0v;0>utxx};L
zkiuk1Et$|w=SyMez;ln8n$UL(B0uSw-elYBv8~t2{|>^IXMSG$0!@}5RPyngfwt)F
zU|DWhYfA>Up;mvCPjYhcmim`iZsz7UXQ{Ukzwgh&faQy?DSy;{_1Mko`Yi3yM2ty{
z_XzHfF8u0Fqsr~VPHztecd;;FGft>V`M>m7Mh9yi#5h>7;V2tw)}VO@+xPYm7c;Yg
z31PGO&e)hcy(gcYl=Gt7k0;a@+7>u_=R%Ux*xpEpSld-~;=4?xFWU2rDiw)Gl^A-{
z6t^4CS6@akEfh|usK+=i{A&K-8BhG1P|h$f%fB^p0{6H|xs7}_t91GdqVh4AwOj<R
zCrOK+drQ@i>l?pWDYQ*_CPRTt*C1@8U@M!AW-50R)MC3Ki;>!*R%9J99e-2eZEvLJ
z=)mIX;c*YYcw8hW6;iM(d~=GqljaY}IN5pOs^S}1hd|UN?x|pj6nLldq{)6RtcNtg
zbuJJ&=Du?-nofFO<Pmy<jP;5%1A(>J41XzMmF%+i$6%w`*K2Lgu?+>di#_(AjwHxT
zxz}gY*f|W#D8opa)cENfzOLp6JG^f+nraU?{E~iJi;Gu+u=zB<?Cw8Raa;@(#3!cZ
zroN7oTRzCg!r&$f&5rl?%vza;32<F3ZUXJB?B*ue9w!l%Av#-p!1tG8E*abFtA_V2
zzuyMJ($onkcNd}^7q?g+<X_)MTx&>XZ4M4{_y7KcZ1Xf8CWN8lE+s8vORWw@k757N
zCV0m`8TX^g(RMQixiYA8*t;cMQ0+12CACj1UQcJ=L_`;y_gjll+gonSy$>8g&%V@>
zN`2`cdQkmFly;L52ypbpi;#G3hk`bdSKJK(zroFq1T2RU4}jknn15YS_dmw8o39c}
zv^^0o{uWJSY4oaU%dM3#?Kaj2T5zqEDU|cE26OV-6H-E`P>(lIO)P9gBni4^v}TwN
zW@IzAKzSGC``005l@ot;-^T3LzqLUDoB8Fd{>S2?D=+_87x!W6AOTbws+8OAJcU^P
zf-#sYS;|p9hyBj=f5c|fj628s$*aWE^gm*wVf7CU>#a5tB_TYG>l~^h`yz{@I#mr3
zl#AY#F4@0^pa)_KyiGBPi+61D5Jd<p4}ngSoaH22GFNa2Lu4eHr9u*hCLcp&aY^VL
z>OFxzR1O%;fR2rN(bD8gA~sjcw^SfNdoHg<fFQCY?uQ5zH1PCKD!luQ0zarP8@|b>
zP}Ne+)SUDF`1fZ%1%Z2#JR_bNISEd&E}dxs>ZXgPPF^963E@gaM}6|Vho^syhwB$g
zr1`9gDteJFQ(!2^C?K~dQzm&w@Lwm7t~9PWaa0y*(`S^#!>>1hP?jdp$(U?qQ^Zgv
zV*gku9gSh-KFNrui^>pv8Z^*2L;)K6XIHvD<RtIT0vCd!0{F!2pI9!&HJWc<JDiEH
zoNS}Kmy#sWcm|n7rpeDwpL1@`3H?Ob%SuPo%{I0q#%(m5&T|*HeG_bw?kW94g-{Pd
z|Il;a+**@EIhar?uRKQ9*;<_q{Rd2fSI9(z=c%%x--}>J=|%WH<lPIUe^42`n<v|B
z)UQn{8MV;kBk}jKdUcY|DdOlqG&3UkzvgAB-0VCF4AnvmLsTiV(?w_&@4ZS;F~A3v
zD|&!A-xi)eobJ<vYV<n&RJbCLdi9N7(o4!@EGXxq>)R0i>tr!Z-;ar64IkT@!68he
zvb^A^k~Kzw>i-OwH`V~mIn@Dy25hQAx#XX9<+@!3sN?la(9h){OY0-D8~o}g*^_%l
z4)XE(Jez8hePx@-RHF_d?vPLtor~PtFNP{MN+H|*^Opl1j&?9kDb?+Xxy9DBIAlcQ
zTI67CY`{w=ll`Un8G{wOA1?^WbaJy996Gp4w87=?i$M=N>LVKw2^F{Uf1AcOw17p0
zrE&5tHqtmCa3ZchqH@AlCw+54y(I>oT$Gd{%KG6=YND`qsCr#yoP(ggstIDdfiHJr
z@QC_52x8e-(abeTYqAD8TS4Cmvo{prQaG%iq7mrvR-6^W>BE+E6HlrXB8xAPVA}~*
zVe3m0=5o`WVdjEjk*lHcrDy?|XQcVOKj@hLJx&qbm}Q|NLzu}{o32q9n`(V$r`Twz
znh&!!t8`eWG-Dd$v=KBVBHYd(Ws{#te4a^+Cur<^z(%}Ay;Mr5x;N-KPU|HJny9)L
zA8ZzinW%-lQ-R%CtTxk-FBw#CvUE=jNcr!%W`FW4@0J*(5K^B<{o{P_7L`d;(0xgq
zYSK@<Lp{HdN0Vohwy%eBU}i0Frj!+WA{3-s>Xs)o*X^lkgeZDBEvFAf7YRiqe~zoS
z-^dO7GVi8u{SwQvAI6a_3h>!4(9Ywoa5MV@Ev%>w>L<!CPE*RxX2Fdg2Ng)4C4KPG
zyZoCQOKK{cYD3fSqMrC}v-*#}MSx+N2e)OVvEF{t>yNAM6m9a+ztNb9|0a35@@X@N
zy0wqHQJjbT&ZRls5k6bl8#TU=pzf}8m7Dj7yTl5UgbJUTRc$S2z8M|*1k)Gc*gKYt
zHT>Me+ui{n?NhCR8(G&BHe?$|jt&19;38C0&bj$Y?fp<cQgzF@WS<*-%KO;d@C+3P
z$&EjVZ_<*^daJwVA}fA`p<=pyO%yw5lI4_#YKHo_MNiKFnO`wUX2U+^H`5xVZmcBb
zqHYoz51q^pAW85OeuKd1da%);6)!U3uejqbn9Z7RT6^(gSu{@M)d%8YlpD|6)(^8Q
zkjPP!AS$5q23>5ZR%W?1ew|@RDFo60B(rQQVqTKeq46!k<5T#c#Sqjn)Evl=7@7f)
z#R90ZG9+7SLIqH*qUhQJ*wvtXRAfdVkq#5J8fgql(qlTt2zS*LKFc0kQX<6casD~9
z`V6C3H4aPp4Tg27R!Ok@&(B)1eZy>o);#C{D-}XI**GRPI|8)q#6|&B&2t8kymawM
z1_`nJNXGvW7d|Eg1TQKpnw5_UU=1@z>z+dqmwQ@9k+Zv6c5h#DU(sV^&}YM^&kviP
z+7i#lFEn;U|Do9g^$ngPZ}a9?PhC)(V%*zjsP_G!;qj{{C6s;AiBeQH>o){0@EPz@
zm^F0|f?}l<9h^>;cE^RjKCvA7<*f&f>o-1;JZRWFu-{aeW$Z<Y24}#41W<u!Xt#Z&
z^fLI_9vm;vqa@583Dw744(PkV2S~_)teOOJ5)&mlZJg}GkA{B7(Bd(<UW;7ykBfJn
zHw%dKMQQ1ovS<8-M?&$rv0uCyj?za1CGK#_BXk52N_Z{2O~V}YOsNSdA@40?Uq1(e
zee`{#>x<|J5GRKre(M#w<v9ihIQh>2Ne*E_yK>E7ad0UG=%t<@y~hi#GqQ7svm<`T
z_+`qR)`PjdPi3$92(h&a`VwJ;YzWp^ptyMcY{>$vTuu)Sn+y)__N6W`)sf$0!UI05
zvf?lL82&vZwYWtrq8+N+QehKj9QBN2pAZ{ObE`%EcGTW_ex*yzm%u$Z^!ydiY&=_T
zW;UFE&V|>D<|^8CQJ^B7`1!7$F&i-LBSgJ|nR$`QE2~XI(6)m!=exI9-?m){zLq{N
zTcbMfsR?ukGIRogVO6=8ZN<U5wR85QOmX+Vi3v^>#LnCckJ>l4idq+W=18!st($Ce
z;tFRSXIBub=_Dm<s1@9s&cg*2mX?esR}RnKZZkcw7#pF3VQ>T8B(aQfj;gM^Am1(S
zpfAOPRI#g;gWS>aC(Qx*o%KFsEx!|ZjL=*I3412laOk!ZJ((2ot`c;n-kP@LPwC5$
z$kuz&DC3k+gYpgj(nSfu?^e4mL&qnqg?;Uza2lccW>XKLG`wZb#l;UD0(?ZSNIOk1
zQJ4+yDlXOkW9qG<+G^Xb?a%@RT3m`3hoHsXr6hO=ZY>md*J4GATY`HN+}+#aQrwEW
zON$k!f9~h~HvWy3D;pUj86#P_)|%&>$F%HnOKFg-Hs6_w@i$T$h8Q~bZFw}L{GjgR
zz-8+E2Uuy1xI3u$n7%Mo>wcEG*secE)I4Vd8I*L}0EfkfoDmhRH{}P}$iaNjzBO4{
zG^^RVjrSi6?>N#gHJchxWM&6%VOu+OcgM_|FXMPaV(raReL=iQZgzX{(%Abb^Hj~U
z&ZzMj*>1_QRdHwSiAxy0*I#v02{zZ2@{MGX_iC6I6lS3}%UxsXpu_R(o>SbVK_;|i
z<%Jq`!d*})Zx^zvwQQC9U{_x*O*R~cnWaqS4S6xm!q?0@?Ykqe<G#ebV-K*(7ovWV
z_(gt4o(|@d!NO5gWn^Un4}o%M(gLpGmySf6OMnY%!@H1Wjk8ckzq{0NLua>55*u)8
z6?T>USYBdrwzF%=`!WM82T$d)ga@S}{h5KyF<ss?*6)g#i-In(@3xok{qV8ASK6~m
z^D`}JIi|GdG+onf9?^nO_uGyM{Hk?p3E39$X)39o{CJ&p4dG^EEa6%V$4$q{uq5!~
zL`Y{aO4%^kF12NZ5W#lHY(mJ2-4su-Obt{QRbncT`>-6FD1Z?97$F$spX_NDP-K$P
z#aa=PtO27%ND@T@<@+G|G=Cq~OAjqpsapcEjv68#apTLNKX0Q}rXGqu72qXj>9)k$
zm1J!FG1SnZsPNmiSjp~Ewp=3D$$a}&GCl}2%;rtyC?OXY5KNN7*xDz?<0xNO{fiqG
znEyoJ{gQ3!RE!|WjF>mjr@orWa}6~}$QUWc)#dqktE`7VNo==C66*S;DBPAoXP|B4
zbxzXksmD@ZL=J@DPLwB~cI$*@qPCVs418p)CKm3Q-P!w4X+0-NJ8f!Mn=82m^P5X@
zwY!5v%%>8_>G~hgU~dLkdcXJNHj0&M$_xlQpFugabW>Umv1#G2de1)2c@Id92SgB^
zyLwNTH`|pKUscoy37yo8_SKy&Nr>lXwhRZ4rb%em7%Z#mo_E`i(5?-Y><tV#=~1^?
zN`E_jsTOL-C(b5ckdK0irKy*)RfM`FciXs)chi%CT&Ww0!Fuj<L>qz>Cp5`dtlH!@
zS9l6L%pcgbsF{_yR^uKm@;69|9urF(f)jHJT+q5}&{f_O&k@3`)7KC&;#FxA4UJ#6
z+31ZNK{N`=od(Bmo1c->WjfNAtM6_Lw5t)w{OvJe27;1j&yoVP{k6;x322NE7q0FM
z986nsxJDO6!~xUcOca=r4XmhcY#zaIXed(_?|YndHM?^jUpE%%Wz)+;)M^zCEKGPJ
zLP7awOjn=PAQ5$Mqvzec*`@VwyN^JncUPwC^dkQGkZgL$iaL<wlvxld@&u6sRf<IG
z%0Q-K6|Bw3y)+Z2{D##BJG~%O&)_l2=&WN<<(YkunkrC6FkF(@YK$(_c8YMcLs}Fl
zGpWpxpPG|ZYj>~b$T5n`)KNQ+*K?54Ufi^Gv7L4Da&lzV%~Xoxle1!K%vZs}g=QZF
zvt9yzWCBw|!m_G+xs(&FJo!7;M{f=}*dMU96D`F+?C`b6(B3umb((nCt#wd)DnDe+
zuzc2u+Zom<LNv$_<60|Mt1W|TFW;|rI8}#ao5X8L%~Cgu$is0x>Ng*5EG?ZPVh{Se
zIdf;~-I0uEFj-ludNXp_P)yTf41+bn;>vQ_Nw)Ye@1EM)Xai&aM(g==_n^LV6k;wM
zoien{FWP-MCz8UmgdU@JO9r1P7E9@*#4`2`Era=4f4Tlnlk4%`%JIrq4$EoBBoH_0
z^AIL{Ia$G%lJ;WEi>1dnKC{Z2&kvcQBnB_stazyNs;ctv=a1)87j6#ZktTmXt9+_4
zgq(DbL@e}?qSqAKRVd7pA2f8dHY<Cs@7l1V0X2T&m%MRuC;v_L*WN^rhl*IUUCly$
z)~FTBFu6&cR_?wk@e{|3-D;3txvizLL(RHluc?vF_M`{|2$%U4?cC4epNHudwPoqV
z4O^-V`%nOBQdEN|t?yAW?B2fC*s>Jndhs^e+XSq1ct(0>t;C|sJ6-Ng@iq1}j&CC=
zV)GYu1f}bEkSJwfF|zZgr_=eL%nFHE#x_j3ENh|kJq}3$%Xrhz#hHzfkOjQ>bui2Y
zl?t2x^0(WlZE;3fo4ddhA_v6+RT=G}c)Y0r+Qk<A4|tT=+UQvU^cDgZrFVW`Sf;3&
z=<Ri&UxQiTYCg}Toa#-ZT3Nk5`8Qgd{_L>TcJ!~W!u_G$$`H{Yp=xNGOhR_hqrhcR
zoH`RT>6PqcRDb_j%U7Ac3qn>6&bdif<0tp=QEccZl5>Tm!(*8BN~B?)c)9IdvX=9=
zr2azVeb^*;G$jSb;pR(C<`b3u`{5-srF+=uDYfXaH?mWHSt*}h?xd-C(5vwg*^OAr
zT$k8srTyfn+2HHp+SJ8da?5!#jC-9%IZuz>LOG<Ayd>Nfp2Xo));|@l#BE+umbs&8
z^GYRqDR&}(C3#CRKP{Ebm5mL3eI&HR%G%G_yZDLn67Fv?Yo121GP@Kbmx((`POWQi
z*)Ss_VwDdBK&F0m^0ddbH;ZzKlmXS!{0m?^ZBT`8C9y|{IKRsW&7u{r;T8CGwp)A&
zY=W~P--SCOY}%rq0u63jT6kvYNHD@-2P=$vLtvSKKyB1zYRoeY?ek8%3aM4qP;8)l
zIK2X8?J~2>-hK&@|Co{Rm_D-Sx4^|{$UYdVS&SjUR&q3R+{qbr=yV7fEoTGLgIo)f
zGauv{p_!XwiB%28Ew&h-of^p<Wr|9qOV2FHPb^7|=&LjN7#W^fum}x!+0Y%3T{B&+
zPd1TjGCa{yeJVHI^xg^elSE-K)c7rQ<Hictz=v%6mBN|~`MT{tS`Zd;!RV5nGAJxE
zR$udT!3GN*+a35;YPHZgJC3pdtH;@k8zsjUb*8Cc&WZUM%p+ddc}zq9VWziN0>kM7
ze*O%X;Q0}IJ5>PLNK^F2nzQ5prFx)X`}8%}tm>X~jY;LZV~xP5@Dme^l-aw;^IRu`
znZ46XmzCc2<J<a%H(SF00Kcm*k`@{8nu9bRJfGYbPEatykpCVM*3U0cf)7vc-jk47
z)aTq3`f*TJXUsx)g4O+-e*o;pM>N)BA3YFim7vb+8{B^4)^L9DXVc{$08f&+;7<zb
z=$$!M?>CuRMN}xV$pyb8R3T<BdDg2Ps%VQl$B@dTBLihB(NzR|iDn?dbtcw@zxHBZ
zNd9ZIVE!)qu~5)RuOs%;QjEG|d#ek-$l54HvyLdsj<b=kd}u_{YN=Hb%@Xj?B1W3+
zLbsLoY!H_%aP><i&z&Fh&Mk4;wz@Q`YhX2P;lm%TZH9J^EEG}M`JQ;!&)Q<rCy5Dr
znwZRuk0!1+RbgTjDcPL4Y)N7Op=JRRkrvP?qCG=TB2^~ELS!oF|MyIvimnJmKqpJ2
z9L^5GN>%{K5-NZd@;^e@qGVouL1GcmMe)9t0TC&Gu0x+vWg}96M$@B%5R}ibq7iJw
zAZ9)`V&yXBwr4<65D7Lyi-`Mk>wnUa8bc{1AX5<yKrBnDjJ_Zcjd<BWSHzykPN1Mg
zz)l#!oyev{-UdQG1H%5(m{9M;0%ju$gJa{ML)fs{8`<et*s$T#T8wBU=)-f#3`x+8
zvV!>fNAg<=u?b}DIiF(ix%%Qi0E*V-wZx@;kelFqp1Zc=+c`hxpO*o)VsUVzQ~=Z+
z4^|cC@scj^nkf6T^0=Sp?(KN~{l<51mT@GR_wLyCoS^f63-Ql)C6S5*NWvOTRJu!!
z1;#1by&f0#{09#4vv~QYt^Wi(RwpeZ)H45O^p%v&I4abXvQy32`2_oYKvDhfL<3dD
z_49vKT;t<=#jNA9=}`(8bx*MQ18gD2zeV4aRnH$#IBX8%p#Pj(SL)sPVQYyo$LxW`
zfpP(>&N-r8es=-H=ZfpMjFmE{eQ2;bU{q2P3n+)49LY3<SY_dyK~ONMVS`mu(B+c9
z@*!i0kQhVRsf0kg_6F9caFj<U5#`Yt{Qs#!`u*NW)q6=#F+c25!sY8vO0+zf!D^W=
zl>O9v=d}CsTX7L;ZiTQJHQ&V#vpF_{NyC^C$uasTRAhKeBI}B3`~pN*My>;`ljEH8
zy9<r+C(Nc9)dF|gilO+i<2gAid|RnbVmBiTvA!7JYKnasQC>M>Z>)=q{*xSIAZ%LC
z;2l@F3Hu7Ykv1dE-!zr};h7iDh5c9_zUKa{ooZK|?GhnxFUwxIjxj1&V|;d)8K`9E
zY3@;8XRo0#T_v}q9>DzCy3xsAd3;P=)u?T#gU^~azL<oxy`UF+09AfmUZxsB#PJqb
zhad$onV@x^q2Zjz3AS&)9UjvBHF{P>td%{T!ff}(tP7A+3qB!+I-TF@tI6oF)T;8G
zFHs$WW`8Zrr*a5pVAQIoP#5!f8;i3D*!7lbzhng2xyo?;N$Id{jXudr`fhCJ^v)no
z%%`zQBA%KK(ci!CnSFM8usM621@$VLZ9XvpM;tJoW|;+$>1|uqkGzx`+26}k9F}m_
zv0tv{CYNTP)nMOwx#SfsNZOVIPs)={_Svxr{7qxs?8LDXX1%nA3f<0^oG3VvsWfDF
zf>zoZ{fo_JYd9!>72~j~^0le)<Aok3ydbEmZ9HWvnUBp*bJ%OuCD^Oqp?{w)$s16|
za^uG$>Qic8cHO|T8a!OI2I=DvUv3js{hOi7*QsY{cpJ|;<}_Z1EM@WPDIHkQ6;n}|
z%=^g5);&Q>>?$(?G2?0^r}6#CRW3zLkue)ZonYh4rk7`6u=x6{5>&P8d+Y2aTCJzD
zkaMX6w45*R)KRu4lUsA}nX~9*b%}Wt>!B$_RTzIL3Tt#gD{`M42y1EVn<jHRwOsyj
z@9Kmzc=_bgwm883nVvt5dZ6rLXEKL`!^9H(!xo1_#&6QHLR2k_l}PRC;aLA^sy9hn
z8H{5C(4K2(BSc*B@Thi(N@;F*f7qd1K2l>T091ZLA8RWzZh6|}5aX&4L|<%4)B(vl
z#XKsl)1KP}Ms>KS&*NI>I8Ua1-Cz9W0)Xr4dfBVDG|SnqF8bGu=}Eof>t|6??_S+Y
z=MS!Pe2)|LYjOpjB^+v7q@#uUJEQxlOhBUW{WBIeVgRT~DWmxo4Z;CvS6%u}WeZPM
z1;oBrDsLT2X6cm#^<|^V8Q+gGmA(233y&>Cp?lFwgiXN0{HWHRqh43CS2#{fi!P%m
z3{9j3ZO>;SxcQ=Ne%s)GLKFI6IQl4n?&o_{z6l@~8?J&y5<X~L6C2#hpZo);oT>FJ
zh0jt!3-S?_Z|X(mn}~%;Ab3$&e9Uz0R;sW{IjXf?{G`l#i)|}WJf%OEZ!b|S(SHCy
z{Uh=1&~fn%Zr*<0nCH_Ns<KD=@BgVx)=vvT!ddt4o=k(9&!rorcdTzTwrjR{a|Y0g
zqBV7of}*9Bl$vjPF0J$a4@85q_WTb-gY(4tpU|Yk1M>C_nL&f7)_}EF@FrUR0Xo>z
zDgOb|PiSpZHy4Mfq1OSoF2u!{v<6Rjx%0Rd-(vEl0!8fSS}*o?a=V_V^bRu3d45J?
z7r<eVg(wmsp(T&Jb~<4<1@HKPsRa2|6o1kIzkt;n+2s>gDgII;ufJ)Y>a2d`Al1z$
zD5%pFdXcZWJfsbD?Z!6k;WU8yK_!@muOga2%d7e7rQN!Qu1%{iN%}Hf-e}vs=x<02
zU3!?36)><{XVcOzVaxZUIZxp(4(fBAuh=&k4RQsWzR183VDHC}($OpU#VK1+0=pp0
zf;-dLhA3ZhK9!POBwvR!tqSYST6IcFN->KS=9ke;f>fe(@CcIHuntoil#Pm_%VrKr
z^NZ92zQ>gm91sR#S)4tlY5xf|=G!{a;zr?Z(y)G3mThCLD<AMP0qJ|q8N%5$9~9<8
zBZ*S_O$?O+5NjGg-0sVHPKhFoMR2*6wFa#WsWqOFlx-d{8mUb?ibB#-q7d#<ZoeeA
zciPGgveqU>D_jr6u8k$UiaI}WylZdS3K(!~Re<Dd)1KS#6~6o0FEDS~TrV^x@@&S0
z!@&VE>zZF`^!xJXVundzr(w$clunPY<6e;6cysaLNMjSZe|{BwaQfnCi^JdDqrFpS
zXBmeJ%w7$S?QB@(9k}3+FwsuoSno)`bZ6(ez!_lq_K@-9HaF_0HsQ3mk-7k}e+T0j
z6Z|!AJO4GOb*#R6X?@Gv#7e{zuCR54N3HCTTT0>2I4ZY%FpnVXshDn0{1q2Mt#DA}
zIx_O6J@u|JRrpoc+g{*iS*TK=s2tS*r<1l@A0I0-f>5JO_D#UN!aQtRyc~Yk9;H}`
znusyR{H4UF%$T%YL{{#?bl{|_=Ak8Y-YpK5VNRmUPNFvHJ0`qimhsCMsp?DdceXnj
zDJ5&KNj8ntFd1HGa`bzg!v<(fYB#o4__v!2+SBapS*AE<b}igez$u&qpB7bH1sBH4
zXpBxXOUjoRGrz9rTKpy&qBBZW>VYWQl7_I0vVEfX9#bl>hlqdv`)zo(0eXhPl5o8#
z6$Y?G(g$l@fQUc;Jab9h!pP%n63ZD-`ty>S2_AM0VYh6yEpi=DGpg#t+pi$*lR=-C
zPQUyUo+-``Z=0evFv$N0nB$5#SY@OqF0@o_o9%fMrTmUdiV1pyjn}HJ&Kktl?D^5y
zI##t#R**r?n~wxxx&3(y2Hy+wnZq*e<6hR9nSam0Z@`pSk^dqwTATLFmEuB&&Z9K(
zhJNu+H;eh$sI@<ZI-<*!{@YaIEvd|UA|q*3UO|$*xOGPHBmp)Z#}TD3)+N4v;^E`)
z0h41?Z-SWYAyd)t3TsT*?Ucov&FVL%;G?0SryS8XmrV<B2}rq2_AHAdR^QcO1)7BY
zF%%iX3!k#~IO>bP?BMr!TAdM@yc^WjytDXNDdXHyO<U+b!o@%2C%!Sza?ls^6&2Mo
zGNclu!nr-U-g#a?QtN}@^nP|=5>L8k_95H1&9XkNV(Ht9p|8=l2ZoB%`;Nv)v^b2$
zXU~!wa;Ea#&c*vP1^dYWCAwzU+B`+7e0BVBGwQ0m!=qy>7QS1J$o4Du)Otm{7eS)z
zA6_eiBRwqy%D+f5Um49Y9fLMK7G?fC6gn6il=Co!v+fpq#5ZP4ZSj<A@$_RI`6S!p
z6sgl3@w@KN4t#|m2EXUWZP1c`%4T`r3M`M()bWnc0*z_GCu}e*I6FR2Y2ZLix79~V
zjMUiJw0W_XP&SosZ31;vnL>Q*B6DCuS;HUJ3PKQ<6lDdWOsF*tHli-WOkVsU(U!1+
z6UmYhc)+JR*rG^$(0ksonHI$Xj+UGGx?+=O7F}8=Eh>%^V0|6_ldFV@l?WytCCz&n
zr1@!AyuPvbz;}7B8b|vIBEsZCG~6<7IGTmJ7UNzF*Eg)phi>#XW|kVO`VkR!`MPXy
zX6iaD4%K^8_Np5^X$?8I0SDas!9@+)M8CAKY24$pEIR6IUhr(u7b=FFf2V?w_Ud6%
z)2Vqv1r@%)KXPDYE<woP(K9=kuVW#}C&VfR!_)I&xVXSag?1%RL;0`_W_IPDiiCQd
z3Al|#rp7=Z9&o!MJSj6=lJr1-uU>VDRl%AN2i25E_WAp~>z1U{SfEPa$vub_-6yEQ
z@vdd7D|3nVp0m1j<nBdjqX)&e-lnN6-Ko0#=+d3)skOw2!tBP@-9+DJ3gWutJY~rM
zmWocpoN{7dN8rH{@P_=H$JFb)NGee{AB_jP_f(q>kcMyTjRcbAB%e5yWJ6krKIx6p
zw3N_6<(2&iMH5Sh^QN=Y(y(@!)~kr9Dx;L9PXQmM_H`<E=}5xb6*%@l0wvJ#ID^BL
z`r@jEt1w{dudeBS960mTjywA%wxliD;Xi<#4UlzXsnk3pGxOEAuvE_&|8CC#2Cr{1
zB8&Tw&F(C^)HE;<U>y$KGAaDDfjik8(ocNAfc)-GdO(vfzb<d$$G9nxT$3MKREzPU
z1f;I>$X%<u{@&F3Sv0Kn2hF>Xl(vdGI(nYUa*u+hJng6f7dYPGM0R^|Xv>%LWmand
zw&t_;SCO9bg{Vpy<(awDe*i0|e*l+>9vHhzfifVBEfzy^OLty%R7$&F#8o6$1%@qA
zNCLN7kP$6Os1ha?vuA0ZWp(`2bFK73q!bqxCOnGAQkVz45HIg1eAzpk3cpCkfldO4
zfXXCzcr4ahLC~hlLldv#vLIPGO)V|mY(<mzu&QVSdMK!fojMYY8)qVoq@gJ+U;Aa$
z&lY6v8DqY*!g#`us;4;Bw)&-6@abna6_Db|v<y9{(3qXwqa-+AeIU-V$1(WO2pdNo
z136!=ZdB<Pv>~u+(Y>a-BC(y5eR6+wnP({`FzQ+BwdFVZ!xf2aS4ezmbiBT4*=J<`
ztOh{RAa?QfW2FHr)~`@2D+&$W#a4?y)?KqzwwZ0tr(~V#CqjjjG`#HFzazO1-+|sA
zntf=`J!plThPtrb5p~2#0Pa`<+-@3Yt+Y)#4Gx@p3NwG#$FD8c#8k@t5rJEH>hBvD
z*2~b~9q^rOGpmPJm^+2xMeSJepD|c;uXs9_Bev(RsCN!ZO518%wS_sex{O}6^l-7I
z#77rG$;##l7p2v{CcF(>5t@$D(w;}d3?uPg(u*2Y^;wHCoOx1P-o58{%Q{%AePuhk
zu-vrL22F&uLW%6-SPAG&^fU@-@VRDQSI&^Zg;Gq?VhE~?Ns_J=2Eax;xb__aRtu3_
z`YsJ!n(f!$m*D;3y3r*hzm6Frv-N{=Vu(4J9a>h+NI0M9&Ys6+?q?y}zBMJ#W?prw
z((X0kq(CK{sc^i~YY-)RZ#0DnHw}W)S8UXty~S4o<Ghr#OS&9b_kOZ}Xvj*o8M<sS
z!U2#}UV|*3<MY;po71u)T$aol423^az8vGMD2rIkg&|yDh97;K*NI(S60}q=b*=<C
za0($C6*hWD*&^m=`dX&oHcJ-5)U7fl!v!zPqJ#8GQqIH$_p^@F=AHw90+l&+**$ls
zJ7If_XQW=6!Rq2QksNi23CTIC1kYWK%fd7<Po~@{nAPv#yXaI2_+OB$?O)o;P6^^7
z|AZFJx8jJN+qpzc*<KK+n}L2NU<G4;edzA8<u)%OuI)|~K|c#2wJuy^8GelPjl>}h
zfA8l~&JMm;%%;<JFt|OF3SjsPy?@<acH$Q@ZDOb<>yQ|L73+N3`Md5W{=iXL>W9R`
zqus@TI$q*t=bD6lQCsKr{n5jwXU{)?Zr4A+r=aXB|DX+X)M0TW(ebTs<V-XuDs9u|
z8z@Tal%oAtXZhO%`+Mp)m;M?PM1lPmlPA(L8kp|?097h^XKwyJ&i?=+*=F4dAe#W*
z9g>L~b2~4C1)iU2tvJc0q!9GhR3<V2H_#kIhJ+yvhD*o(3>=0zA&AY6U@zz#FI4+}
zI^@rFJOf%8@ycAvoZ4Ekttpx{=#h%#sFG9{PX8OJQl<mj7t8`|>cG}suw>VasJee>
zRxMf$GGB1kR6a`;7IU@M>Qm>R9rFH6EV+KZA(&O9Z!he*ApJulG3q$;`v+QW*s02G
zj`X1he4<E>429;W>{oin8C7|mNr<mcp=eah#-aH+Uy+_qON*Wt8jPJEJxqdy&>}!X
zSA;;p5H_YHHgrM~g+fRK%7TQ-m?c|&A^FTStWbanA_`GvU{6%QLg+B#5Gt1dl9{Fe
z3~a-6YN%C_={x!qdm@%BAv73^S3xdBAO%G7D;kuDf`I~}6(O4c`IAs`lrnBAF^EY9
z^;$)!BGX`57E=@-4nYB#LW~Xo7zRu%`!B=B5JD1z2-jywlI44e6`Zchr&VB5#roIM
zSI*w{G5wZ;;qySdYijA`=u$^xP?0w((FZ(vGQ9AwPQNzeOB~E09JEEs7<tJA%?zYR
zAHT0Ek?7qy?SfthaWpsHCfHs`ewNWV2AvaRJ_|C}NX+$lS0VNTJAx>h7OR6-h7px+
zlfi$*%q-(((yVbjc1zy1%=%X^Aa?bQz}wqGw}6K6oocFYPpQ`j8Df!_s63GBxb>Tn
zS5o@7w-1-&d-)KQ>FD4eU~2J^o>k*1ef$7B*Eu<RjTsgF>)m`}@*DUN`2*!T@}l~a
zbxyqN9<awVZl)c%9f?0gqfepMZLF#q8znv{KDyabpZqaXmF0|)q=dmjK%o@GPhno5
zteK&O1<P;euh&EsWBDuC=G&n@!WF99nu4b2AK>7`9MuUkjsoxuch$zmwo4Yt<Q8lb
z8y5vXZ&70TX+TP}weqTH9VN6joDeQOa&N)Eh```<v2jZ76>|+6F2j8snwHlhpVX;P
zd%~7wyn#ohoB5y9kxzw(nWW#Fx(rt=ak`<OYzm4#DVQzlS*%V8zHl~lIH%FkliimL
zh&{V^4jSr9i)1xeko?`;V(FG!u`GotY(iVVAT_^eH+NFn49U-Dlg;J$wK}`v<#pS}
zndQl5q3A}-;Ex<g^|kQ&<1g)*MiwaCXv{wkwv4~`{`A5}{y1|N2owmMF|rf0cVhk^
z3wq&uni;9u)?W=B;Ev{=vW<~n-sK~2??JeinKBQgN-64Eqy)yHx?A-=fsSYA+e5?I
z5!URBMn9KHS@NIf!Ny(}>!cqzOm+?w*!m@t1>+P0iw+MRZPEJ%998J!X02yeU;H2?
z${o?}UwvSeeqmIsRu|-7f~l!yExagcojf(_LlG4+l-)zwYFXr_`H1+tZ#x&`*r+ql
z9)@!!@hN4j{X-cCbaoD0mO4s&IVSZx({*c0d_FBJ`P}V<b+^)WEJ5y`&sW{BsTq&C
zVpB^36xTIog4Jvx_00bh@*iL~cY0fJ))Z-89VYSBh^ji2KWn^Pmy=n_b0b2)YqQYY
zqNo92x&oVv5a=>s>Ls+tRnuA3ZL52Yp~j4|yuH=h;#l-36GHRrIW&4VjQNl}c^(%I
zUT?Q>(hV;!a$U1CDtGd?&RezU@H#l<U88Z1IIIt!btx@$B2rbG@9{~X*i0*3Y+voa
zek~L&s|^2}Ad;lkyIgS<YuH467z6k+cQs219bgnC_p5sAuh%UTcMK^u26$$Sup4`2
zXtV7LoStiM;UbMD=qRR_Ml1q|A^c*q{bHu$`Sf&CEI+nu5?KQ!{J4cx_S;Qg$T(yU
zAH{(h_`##B$s|1u%|E!RrRowI#R^sI3(|Mn;Ny9`tlokp#uulv@`-P`V!`YZsuz3h
zwubud<{fx5f1)&8(SQEd$qt<z5z9r7zx=9FRSG4|aoux`_a$}wR2mt_kr>BWq332N
zTh#3}lDwx*Es^Y5{=#X8>4R$H)V*+`mb$yX+2?Ps(Q|aTe_|j<f9({A$Tdq?n-trC
zNKSwH?7*fc-zGK+?4H~+!RUx$$0^m955723M0NYy(#A0KCH=I`$;GYk4m_A-#&(20
zbLokGr?OIli~Plmi2iaou_Kru$D&9<$K(;^*;~Mrf%wQn5F3=vY>#}8n<vxk_7?gb
z=p;g=ZUwccES1qz|1;*h4|X{%eECZjmKra%m0r)3etx(Y*Hp6q%bQ>ovzH{FbgZuE
zE&cS^``F*y(enz!so^51?v~D4Ee2=^{xrQfwya7Y=21ay2UexazPz=liMN}H0F|5}
zb31EBRN#WpF}wuiH!Vvh=4TT<xckzpL>N)CSgMz1W63J|u41J#T;HBWC;OcE{o&mm
zC2J?!WB2CM9??<6H`TpySkge&2>U9<fsfBa*_z6%j!RhzF2YtKKlgZVudSX&+;zv^
z$AV#Z)DlGKAVj51Ac)2iOw6E(lLTO~!H`XPhMs{5VAf{WS3u%IUUM>_iPHCQGC&Fy
z3Nctdet%XZXZehbg$TfCCGP@%FZNNG*^q50gIJ&(3*#DrvT-fFVdNcj6At-Yd7O5G
zk+)xdkyU55P8L*HJ?8cQ)U_e$`fr=#k9EF5|4&m3`p?GoCvV6?;F7S{7Qx0L_^t2F
zS5~73tvmkl)1at(+M}Di|FvU<2N9zJb2v}zX-w^JlV(_E^L$zz3$bxDF_TV%C$A$-
zi#;2tAJnJy$2k}Sm)>w*|FIU|iu;BsIcL~2FgF|84RLuD3Q#^LlnQj84olxEsiJDG
zyu#9|R19eAgIcGZC1`zQ!Zj~@mgOoTQ5YfU#O6NIZFMbFj}XHo67BQNJ$+3)UvS3H
zG->xWT-H|zsLJGomSW<S<bCV;_;RV)X$Ob8Plhi3&(9!JLbfs}8oMdufJ^lTC(Fi7
zT8X;3<J=qq)%)CIAoE+u2PpsLZ8S#ztPU4z=c+nb=KKNC3H0mx&9fk`?W8lD;vH77
zNi9O9`#rWN@Le@l9rrJwE}nBxii^_W`#Vz&9sEr7&cFeKCoX4fm&=1W)O5#V<m5>D
zO-OC4T;gy%%cNhIQB_k}j5P$X7U|EHX4F`R)1*eFNYYFMOP<g&xQU_W{k?AGJw;}B
z@Qt>4zS~LV2-|JU*Sj;k8Ax7xp}7Ud<@}rsOM%{QQS~CHl5O_6iHu(OSwp$TdHapE
zZBvhP8ugIB1@NlMg#CD#Ie}O$;Guk*hovjnV?#^p4E6M7Ipk$#XiOF741JS!a`eGD
zl=>@o?D=n=5n}Al0Ds{gE25?S!V{(ZZrzBZpSzV^=CBvcMKHTyxGTK@_)%N#+LAeq
z`;=Q$MaMTUEE#IQa@TO_kv=wleWhAc_w>yyCcx)zHO?Y?*s<4ZK6$6F9nP!*{@gGM
zG{hs8?~T^g_xfDl?9H{*5WHk3pIsQJ1NS4{fb-I_y!{QaEI$(!r?6<|@-1FAq-Qs>
z+iA&mEQw9cE#=Rj$vnZ0Pxe>=|Im0F`^yFIUO*K1a&s+gxvu``kNK8`X}sn#TX3vG
zNE0XO(i7PbeYFABynkmft;Out)aZ)2fxB$A3DF2fKxVX|+j*9jIpTz|MRSRLj*G5M
zbDHqG?^}ey6}!LdZT(mB>iH2h(;RAhB`6Xv>;Bt8Fy(Vfm;@+4Z3Hw|JhgIQn5@1*
zLp|U1=O3Vnd-H~s+lfxe7HN5x_c49#v$WEK;fN@jm}8cwc095AbGFxJ;CPUZWWycv
zMe{^b-q+YGZd=3SM4N~~nn35`FsIFAb(w+PO8I|)Z1b6R7d#nFk0;6Zq|vP)Mm6K&
zuQU)ODeYN)a%%bAz<F512v@GSoZC<DcX+j)j^DIOKkLR!({3XR+UjT}0ye3ATKs}c
zd7Xb)iGdO-RqKC6>$7}j`a;Uno<@yGDka+<Ed}-0l@w_k@K`YC*oFbIhuIt6O*2ax
zrW7tse9nXgmJ~M(*^A**E8z@9Y5`S&Z`exHa}VKHaM^7-gZ*~)ErH^)nkc;8Bin;j
zsUQ3aWkV~zlCP?c!@Bax5We{A&IFCyRft{7q>rlAg+|Ltak`6=wL*>By_dr(iy03^
zlG`H9?yvQA2p!fGO3hShi)z}dC*`#Hd)C-HOn9AFOjKR1mrc&m6BL;mReNVS_-mu)
za_wqKiy1c|?%PpACO16VOJn6Zz?!2Y=Xh$6UbJ`QL>Aa78TmY{K<4Tq+t;5}aR2Jh
zRi%r??8j*^9&(nF*>R#gT$?uQBZt}tnfb1Q$S20zxMI#~h0c|lG=F=l;&%&I)yc5z
z3(`My-lcmTudPkXh!A;jL0Wpo3u3;^S>xhL<BDOia$#T?n<FY%Y_je^jnDK{T3jD;
zkqKwj6Bn9mXt6<pFi5I(a1w0dCN?wkSxLQ$o))I``yY&tt5PTu$3-ao)52xzFkg_^
zYxi;#`70ZCPb#towyUJM`&-Z~`(2}gu;ml0I}|DUR27bnI;_Qn4^|HBTYdy^9eF7t
zDnsfm+OXnMFNmxOup5}9xE+8zRX>`P#3Oeo4!G-CK#RG^?DM&ssvq(rOC<!KMR+DI
z;=mwD;7~X8sRmk1Zhn<qu}HWDo(4yy;amlDQZyxzMne`eyydFp2K<3p^69pJH;7B}
z`3OIM1dDjf-}x0^_j#QW3cjO&F5;=6vU;d5zQ`s;84LxEr(Z^QvcI5BtZF`EBbE``
zXL0|HoY(2`%X>Ndalg80I&qR+5E8#*kn-3QoN%ki$_q=kI5X`xaF{H0C~65z*Rh1q
zEedaf@d%_V%@Y&98iHeO%LT&bzO^GX7441lt<@N^`XYw4bFI)#*Tb?u{)u>g5PS(>
z+j?aL7NW|)8!0piruw;!&OZG(Vauu6V__qMPrhHGnX`m-mUznj7y5W1fG{YQFIu<P
zXa>83EER(~=0ifKR^`PM>r8Pl96OreIqZDh)z7>AKXnzq(r|vjZXUfh>bU*A>EG40
zCm8_drnCKflDQ#_9xVK<mB6Q0$X6)ygRlO}>T6k2APbUSipE+4gt!qsx-k3x+wGo~
zA>y7mS^zhcM8xOK76Ftn$P1@6niCGBqKuA}dWV>~ji1drzr3jqaD9+#k|X@!6>kn7
zZ8Ie**kr>$<>%WRZOW6wa^2&7{FqR#E^x$ja-a9S8g?&t<VyyxzU^6fz;t*96-mQ8
ztPUe~HdlL`9z(M2u`ING)_MQD4Y0NK=I>*I5z1YccHPjG93TWCLQVddziVff>r@kp
zcrW3rCpvY&!d@|vwkm3Fs91%D$+onsQ5!P9bOk|3Ds1U(H1f+(XPHk%!<AT?u~7yF
z41t!2tuFt>pcr6I&|L6g()s0wrs+{#!l-6pL#aZISA@cN!1W^=kGc)l4h^(gW%LI7
zCa$oC(nHW9Ql9jOiELSN#Jpidw;NZ9r^Nd)Qs6&;m#tdcE^~ygGMJ1+Nt&Px6r_1+
z>{KANgXGbQ#X};R4&iR0Xs;P^VYwt5WJB_UN(`yVbwmv!d>mjUwaYQJ08($sppRE=
zhY)a@6EtiCeZqnSBEAh|@<@g=j|4-O!e{x)=)w7hAyNh1#nUun;RkAFv}eL-HfkHi
zg0Rm<9?>G=q4^xU6)=wUC3;ykkxkz*LG37s4!HbrXpUGwAn+)VCbXXlx8#Y2$`&^#
z3o{}<Fk;dhH;oEB0d_6V1d!rw4bt5V?KcTZLQEV0$c+z8^CQ08FY<crqZ(;KB;R3I
zJuldSAz!~#{O*qXc3s7G6#0fL%uJ#D$f?aMLTvtf1=z*dZ6cp2G0W9->!iYOdW)$b
zjX)D#%EjE<mb@aD3DLO;D#XW2TAR64UwpdwWP}s5f#oWZy10XmZzk<9JAoC7s55~i
z^D^a6iehwhgq%xQRE-T3J$iK>i94l{4T59z-|S7Ygf`~OJ`dr4MsW4=W0+6{`#`!G
zK{Yofr;tiz&IU7v$uUqwuDj2tg!Ztb1@s~MBIG-X_}FK-D<ZUDokMGjVdxs#>a`zA
zE2oKRtHs{)R0x&inm^2m)s{i_W)>*c`G1pUHo!=_-b|Rk&ph-vG;X8HmqaysedG&o
zJpGLiiM}sm{eiwiTW=>GV%M8^%^%Nnd#NG&^6UN7P9UY;a$R@T2nv(sP<h+?D*Thr
zwAv67C*b2USKq<!HpH{7Qz{RUWOWu;4bg^_&R>v!&U{t7chQwcMT=MAY+q>R+npZx
zZR$oLHjPZ^JZYHd>X0H=$am)FqT&jjah`MzL`QL3np-haR5Mpu8V$XnTaC($?IwS4
z4>r|+n38c^Dj|K9U>C$k7qmo`AfunzrObbq_nM^7Foj8irsRb3536YTqVi+a8O;gM
zXja(|w6_R$h|VF+cpqC;&)2g}S<nk7g=PH&FJ8DT=+pk(5{d%r=5%Kof{tK&r>r}T
zzPmT)&e2!u(wP$c#(IyY_m5XkZi2^+oiZM+E}t$Ye>`wXKmU9q5{NI%ddBylmsQMd
z7FCwuajPtqvLonE;Z^bD^o@n+{#;%@(_;+&9dp5>tb}OLYvyl#Lr0rW)FR&^X<@%^
z%z?Fk24KrM*b7<9-`?62>C)i_w;-bg*l>0=Lu7OrQt7asA*$I(u$6GHL(#%UxES_h
z!U13U&u{5jMV+lVZxLaqbrg0-r|kSQJVc0c(Oi3K(c9e|krYz*;}^+gy^>xqRz|K7
z4I$(E<CST$5>GCH*E1IF1CT~a4PB`%4Hi-8uu~B<aJ)P*@s-W!gmvuIC)@3d(?*^h
zi=in&AF*MyGT6iPQY6pH_CN}oC1l>n(Jw@`cb9VRf>ejK&21pro$l0;hajInyD!p)
z2n$1dX|Fkr*0<{fGyz{MxcpGcpZO24jQ!&<x0>x@)wb#gd2ZGkkPXGuGB7PW8$HkI
zLb!I{vc!1p>w8nHeZiI)^W!a|OagulWhprla3HYa>!t&x56EEiQz(b9fZz=1>=tb3
z8BwW(q?i_L!^sNiq3B6W!)PSQ?`4Tz75#|)f^JLj?4vF~HM;vVMLxP3fWZb0L5f!h
zuqB_o3d5X&6aLgdVbkVVDgC}<kY|1`$wpYBZrE^f1)|yi&rGJn1PDzpWFkQY5;uZF
z$j$!@Dbmv^PRV{CK-VO~l_Ng_p(Hx;N}Ir+)r<fM`{o4{u~~KH+dlyLowf7-vxBYu
z?E1YM4J?-Jwav$vH&^tOJ<h7RJ^cJro%VNw<ets%<0m_R>5Stxtj8!RIUd<JwZ((#
z<Osi>inrl>#V9tFf+EVs76OoyGw=RLhNsbt{Rm%UBwb3n=U7#;{~y*Gg<)!aXxzMu
z&`WsA$kLQ<`u4P0+>9b(2P9qGO8L13Tw)_BFsJ_kkd1fRw*QmsfGC}=m}kgv^LC@}
zVxZzL$pgznSbTRL$`Y0*o*L-qjzTx}oXbaU$G150d8HAP4kBEm8Jvm9`1llNhCO=w
zqCbA-%?z_b(xW)Dbau%Fuo||PDWWK%6MK7uTpMOJY7<-e2l)6Al_Pqg`wuXJ8VJ?#
zb$eTI_iKENtr8UAZ$(_q?cy^^y_+S1pH9Awp8YOapH&^3hnan9pWJXooNZ=*ob2xV
z<{Eokr*lKn;%i!t2R<_%i>C162=no|^eM5(sc;8RIdaxLW8z+GVZ;%#(!VSRCBdSL
zjpbjgf6XRBmK?A>^2(QY*1ou4DB*|WvQL7eKU%5HYi?<q#q6e1foI4!E0RuUMNZwx
zheQq8Ul<y5@m-HEw%YrhBv+>KG*n|^tA*~l=DA1o$i_K09OW^5eAFvHMb|bN%?n{|
zlTxdImEJ8#toEd?ak^c4-I1%f4Iu4Rw>q@lt_9Ob@IJ6h%ft#&h3ng1b5y!Cte*?;
z8(2=&X18p>|1&Ho%wXn+hsr`gFBU{rd%WU$?NsDule49>Tikr#;oA>&RG`wozf<9K
z=G62?8XXL!KiPD>D}AayKMLz(Sw-_jYQ83m(o(Zwacvks?^DbE+pY~hUO_cUtL~lh
zkot&vR&f?djy>gAb9UUZd`fL8M|3r(c3c>s!i6ixQ)TLJD7N|?_p>R>6NVMPE!>YG
zBkU*MeadNa*7(rjtNt`y#Ot#cM!0I5kUR))Geyv#0r`tSon?mY+&4d#5H0AW2pC7o
z7xDuyPby`0U@pxGGNsK%*CU#wRyX=Hr}hW=hUiG`mq}62hoxKV$$`p!<{vGo-`P1n
z5e?E<Jk1!wnrgePQ=KVW$A?o|Y0WAchd)VI(s-5T8pUO-Zx0y9-A7eyeWO`cr{hYN
zQ{YM^S_}vqKvkEnX`-X2e^LV!(7LC(tDTP}h8Xf&Q>uCvHega@vn+Mvv^U?_f;&(a
zLfl|6wXG?~?DH9`BB<gaHxW@3nOAyfs&{5bR}!jMStwV9?)BZ*5{KyY9Hl``xFff5
zTU73|o7NS`?MOI*J^1mhUkJDgtn_`%TRhovs)|XmCj0}5;>TK{{HPBj;mp{yR%SMa
znyx@C(&V${s;|?1VRg`9<Y|SNmgRHKQC5(5kv9nY7j*2+&gJDYMfrz#*l4@{v(hxI
z{*&vBmhMH+c-R0QG0kfZ9uzFGdw6r1o=#hI%+OA~4gsIBY`C;Aw&o65UXqxSd6t|7
zo`IfHp5?~1Zsfsa1J7{O-iHon(Q13>%Uhzw%NNC@Ul~r~JAUbA6f})6S_^AQDTEa3
zc6`TkOVjRj+pq*ySf)^{{IwLG(d9lovG0Gb)}-Y^I*`3+5#C((!zFF5X<tk=jl!0M
z$x+PLVGgFZyi_`mEy$wJJ7`!-39;aGtQ_@Le4#d7GpX<{ezk6jE#qyEidz`P&W1XA
zzxp9VD<Sr_!{>s+uY`8@Rg{0?h|Ac!=aygn#HmV!O^_cW7V4W#9c#PXa{pdUq)=J2
zm)8E~(bCpYx6qn(>K?>m@{CD|_ub=B<}?*{qjkqoCQ8wmom%W?T;;D$UH&sT)z(kN
zrd(D|d2o%~j_qSLVG*|RkTlVO@pBctr<^k^EI$>vaE0@whST8|IV|b0y6W~PFBt<8
z=B)G5uqk)FH`NK2Y;i-B3nXqSy#07PiD~<=!#>L?bOTf;o>>J`*3pxweFW2e765>Y
zv|wP(G`^iMnb%C*`phb*DgY83g`q^eO~fEkJ{b!EnoVL9#tVfoMfUvt#0*q18yYHe
zspdN{Y>~L_{QQN{0?!{RY34w8FO>((=^?Z1qyG@!WI-oM|3iKM1I(t3KBBVJ96a4Y
zjQ8?Sx@KYeXIZhAgx_ruD9ZPL9ylwM{zM)advTA-Sq}UcxV-Y0-Z1M$p}xOGmyT{u
zEO>6yF_o1)3w38&Nt$WaU;1lcTgqiSG#uVH-ycddK^Xp=4i*+7DK$@nnyj(L^X^^0
z4)_*k;otON%k+7J?opB@*s+#4?|0OYNYsiBoo6u`%XCfWWg>~9`aNx~7H&BW88{To
zPGq0zyLlECwNU<txjP&QDr+x8Di;Om`*<dwCx>n7T5z9!+IW2UxZkXqmDd`7f-AAZ
zHK9%@LkM=fI^us{Alv0A!`xRGRzh!@r~zW>>*80so;R~G=(Wp)H1x7_BrYuxh}r^K
z8Q|;<l^_X@UX}eMsUvTz&z=$y#=S@~Lo>eo>(ACRE8g_H9=_@#*`HO^AfdRf&sU{@
zP}3x_)5oETy38C~Po}Q=nbF0FLnLXFG~povqi)Z)?e-Zxx8uaQ;y1R494(%P3Pl??
zxPx}63=-9Vd1l;&JL+sw-E&(XSAXGTbfAiA?*{gjeit9y5z9>I)7VHlMmYOK=ZoZT
zLb4Tc+(~iD-^Ka8y0t)zU8a3I`s=jSdc%3+SIT`A^NCTbd4_u?jS}0Wt^}f+3KRdO
z-34Z%bf!F#%z66YcYjj7lJkMy0k~NDQc=9z#J|OF4&<3ST@4xCDtcsH(XRH|lkwUZ
zGa7<G-Ejb<INP=}9&nn1<I@~hm*m6a6Y2nHfgqZ}-IN!3b8OXbg|y%I#cx2fPW;gR
z>qfs%iwRs#KoFZIIRIRfnaDTj%AY%5K|aO(-0K?T&z?LLPt$RI#2j}Jklw7J&@wMD
zYP!PS>bFo1U4oO8_A;winxzsSAkHJrw7UueZ*zWsHMBRS>2$ud@N`{#El}l#`?Yd;
z`b@ll9Vy()h7VGo0Ewnt55-H@t69Q6a990mL1MgNVDSXv2<R6RX%p$hIFx>5=B`nr
zRtdyx2==vMWJN=POo4)WN@rHT#L^rfcG(fXbhJ234RPx7&xh69os^p6vri)9#VsP4
zN`iU}jN;yJBR}zr4K<zo81XomHOlTD{JZlwnPHUc&hIE3px<6t>G((R?v;~k2Fs#R
zkyvUmk;tdF`q-iwf;yFhW2Kfm<#aX@45Z-<!6`HEVs%;<NB0Lh^YGqOn3L$1`N%LI
zLcS>HuSF$h-+;pl^zDck7D3t>-9{5Pf?+F!4I8pjgGg_eC?1cvEy0%)k?p0=KAcgH
zf5@vd_RlG_{?%y*$u(krH&eaVkn9`J<U+G`UwExD(Qi+h;u-u~AUC70dDRd;1?@}-
z9lMMqJ)<#050)&#-nol>r6c7wwD8etwW&z2mFpS?y5J-7k3N6cEK~2)p4ig(O_^7D
zt7!B<<@WW*8{hPuW6OC~b^I**$nBo@%N$gv9Aya;3~21=_m=(k<P~lvJK7ywnb4b`
zYX<DIy^(Y8UM7>TzoS$)&QV>B$2;gf@aOg|=P)4MX-SlLK`HmwYJm&MUcmfZ^61?Q
zd`5|fiQV>U@1}M$=lI(AkfJPaRR?@SXm;Jvw}y9qjs+%}W3<<tCuR`PQ)Bjkc2i0L
zUCkem2m~r4wVY6I(<urk71(SML2v}_oB3!Dh-S@tps)jRg4kfVjM4|WRw&KEw)sga
zmZCQufsZH3TgZS!#9$`Ml#X}HJAF{DTJcl*k|o%d24TYi6@z<Qc1b@Ru_&oos9JS<
zk`G+neFQ4C&&l#A))&+^1hjR5(Xi#R4cM{e2(o98#EG=Le(M_NR9;yoYESuwZ4}!p
zb*{*->vh@CEza(ph4xz?VM%8_iPqYl&finK1GkS?8S2?S&Tl%4xQ|j}E72NTe$N|H
zKo-@FFmMm%q#J6RaS`vS@Q7biTRTL>PFIXb8^5X>ahNMQG<M{I<(kVa`B*I`tM5xF
zFUW_v>?H8W&lt;~ktG<JG}s<!$EY~v`*5<A#Mh0aN`EWY|IkJK5AfJl%bLK{eo%EW
zJ1(X1#<xcrh2d&h+XGH>we64`!Yb=nzTIINVZ1oW(t}0`I{VE@S_GxNNz)RQ=7u)2
zr=Am;qHDUuPYe!JDUqyjnU5t#k+TyIoTeBV2+X#rcwzJiEZL~U%2Lf=WYku)3&yK%
z&7}je(2EbE-5KA;XCcC%_}KI!buh(xRWz+?JR*n;v*4i2xH$|h5h~{vMWP%U{}_0h
zq@&1=a-Yr@dM+?DR$n2K-TJPT**`_m>DIl@y~WKpQ&?ip`g4GZoCrqCCwNBv+qr91
zCt~WP^Fq_I{s5=Hev<9ykbh%eWFAwb%|I)vMPAgbDNPR-(?d~+2#?At5mN`pusmA+
z$ZGd=WyBjN#iipV&Eb1%yLim{g|K-t{$suI?U9i@j_cAzljJRlksQ%9O*m#2j!G0`
z$G(PI8H2v7Ef1IeetDmerag2MfWa6C<f*u40xfY|8?mYpL7TMwJ+$LgC>R-|qk%eN
zzN$Bn=mk0O^E6xmI5gMX=x2qt#hmGqMwrUnV5j(FMnHsFgAQohu;l<$M9uLN|814{
z_d^ZtouwJ8U#`2HnPz^l+kvD5uHVGm2V8Ye94xhYGfLz}hT<6K;cZ*-CPZ(iH`&%T
z(v>N?4@X}@^ufL#iV~ACT-KF~=y&Z6JnwEOSkrc&wg;-UEp+H*nP0vvoM{Y}D+Pz;
z)=}WmGp5NPKNxDYVQv0*Rtmg%7KZEqX{l7<v)q4u8O<2-I4L6<f+f41XLz<tvalk0
zR@H-;3IrYoC_29ETSEhTT+gO)nTN)_`PwZnJJC>C=Z*pA%a`{dtn2e)0_WYL=)Rgr
zE@3vV@KW@|HPQFaGO1w;n<>nNkyJJf*|H*M7|)@?Ut$@TxF=?FoG-=6h>)e&9!w>(
z`Fx`uqcb;iYF$iR4g%QNBIG{N=kw}+&i8$~hjW?>$IVWy&caE(shx=(Yie(X4An_5
z@CmS3NSgRXY7xP~MMqKGh?$Z{h|kT?VcXP-{cX`+kFv-5E^426OYPXm4r5A&em?$U
z7<$HtCb5@H76PHvM^mZ(odA6dWIAkqpxBc$Gt^FM;^LYs1CDgFA@m9k(A=I6wi>~?
z#2Ql9luL2pnhopwq?cF);sIVNEM0UWNyG9gyX6=ocKx5vu(fc$!q$bxNRR>Rl5`lc
z6fo|u8`W=Q*f<O@{s9`lS-4*_wKQ<=WkjaFeUEiTe1W(r`OSaI_ZCAW{xFNl%I4r`
z1LH9evz`1)bnBmG+)|pUOaKWi#IRyeNtJ19mvM^_3~zgzJwW>#q#?iYbrze$NW~~l
zh{O$u36s^;ITIgp422sB$E=ctmD;dZ_hR2Yh!<)sC+-`!nehK8h80E6G)g_ESBqwf
z6$JBsvQTa}&SF`SUDY1SF96ENNN#NcN-)Xf{Zy+5)|H#MnwCbH;U-*3P76#VT!N%>
zrAgf)1Dt%*&y&N}RTL_#b&a6`M-8B=&e5P&r;{{<%6!RdC$4t?G)D-$V_n5DJdvRJ
zk;#{dSe7vG|KsT`quT1)E?lIvKnoOY@gl+9-7NtE1oz_Z?xjVF7k4MPyVK$tJUA40
zC~k$GJnwhT`Lp-PNXAJ1WbL))J?FfdwYFJ4GeJ@uKhiQl!;u6yua8VqOYWcHMqMh3
zJ%2NexrYs-Y?O%|(5x`OsBmDu+9WM5nyDp8?o-ZOnTP(~dq4U$0)wop?el5$^K|NZ
zL-xY`$F<Q`*tB$|A#??%a8BzR9<hm9(n#5^4+D(*l+tryh{f-7C$9nd^#)0GmkLu*
zF(D}&Zww&K$^lsPE7>AcKNW!lZ>dnK2~joMJt_Z8z<OVwFQg%!oB<p24y1?}C2o=W
zs09<U2}o8d8@)<pUP1(v+)0%;S9#^aC|J{-pXzQOGO!Bxy;Y`U1dXehrm1>^A!pAd
z*&m99*sF>(|A5(&+cML+c`r7m>Pl{r7od^c79k)256Les`%b6C^{0--v$D2itG3Jp
z6S`C0;7)RZIxtTBQ0{#?duzr7xNuEO-6G^cd3~<C689|E)TTPrI!IOe`Fqnpq|IZR
z$FJTsMg|do?Q^=>H~Y5{usdd(dsAGDGmIH<3~)Nrx6Ww~t$(13n~&8|BWeB@(Lp*X
zRsBvYEg`Z&GCBcYD-SR-;A3$5XtkONK}PbSZGnU70-k2l_So3gWb07DaNXn)Nj@)b
zb;0PeUhqoDm78BqoVeI7^|1Z(B^;fz@CX*p$i3Ufxw>o=Y-q?_i8ghXwRh107CUsc
zto3G(b*(#wNgWD-W46PS3{NLnI&F?eqX!OLm2B^ADk~`bSXHX%dy$741jlF%%#4)m
zodQZePQPM^r;o9{wwp-2_4vTVNWxb;H>j?da;(nh$GXz(p;11WRL=j4%+h7_w9>h{
zfu3DdSoDLI%@0lnuwa$$bbUF!Bg+lhle~{X3C%1b)TfJ7cReZAFn@-TuQmzuwG#1h
z==l&Z#Nz53np3&5!L#d5E;(<4QtVf|voiTB+x;x<#tYq>MUD?#r9hZ7VsL+2TUU5l
z`e{$S9Mq?WSAat{!>QG~?HB%sPNNNBuf=t2&K@tEYXTek%^H%Ovn=y-wCh(N247(e
zuHA-O(|1}K)^V?paILP?@K@rbfe8aj{mJSmi=AxvGF0eYofaQ^opYZuwhM|A%MWwu
zJ<d-kxWB8|<i6o4H!RVd@evO4w<^uD^#k|7Gx(ah9X!RZ7t{oCmreT9)$NKrI&UY5
z$6A)n18n|#B{E0BovC6&LJt>9*S$2voiS5UV<cY4(1wYnH`6&AvNJQEddLX5YOHXx
z);F`flOlVoZ23KzQD#b})h~RMQA(ZkS%xD4R0h;uCR%lA+N>P(Z}>pz5v%3y-WNAA
zyJ7{%wDMD$0XyOpyZDaP=$|Dc3GDN~SW!kz41^igiG`_8AM8wGxqIw4rQH0Lyq@G~
zh1W8>iHh&h4@3*_T|K}3W0$z9M3Ew_Z67qRGAlA2<3!TJ9fWv0>$$ri;9d7?iX*-2
z+YWGVEEuQQ=h!zz6H{ENXU}S&k4=<Pn*Ce1;5cH&GhO!&>AP6^o|7H8#ES4b{owIx
z>uQ`Ls4x&mc2rc9JkR>1HlSgm@znBg2x*V`kb7RRWMH>-@ydwwkFQnC%6t_s(ldb4
zlF|b{r2$;_<D7I9Ti>9lq0q5e$Wgxbz*w#)75%j<ib3{at}Qs})r`Uqf(%*JVO6?#
zwf{LSb?Ok!u2fpMh|q6R`Nv~3gm;oyXye+#=OgkKqRxmqV`!G<6!B+=+x-6jMA_#J
zm|sr@gE{!y_jrykAF{*$ArVrTI`$&`9#1lxXHU{=x3MpidnFAIIkR~<i-|kbjky06
zw{1pHv{Mk%N;qH?WdNaS$ef=QRKH_HVf;`Vx!o177u_+xJ!h8hjE0Nza6S}RUCxT9
zbSkR8Aaw7i$V^q<&Y<UkK)03f{~0J(b486*a)LRN%!z)!z!4$cN^vOfqq;~BKrj%r
z@L>|0JxA2IHhhzRht?D4&kDjmdF8*)4}0_%rxgfPI8kpLUN%tDN`7sYg-GU_o6myN
z(%N>~sFM@<@i;+JArL4vGBeeG`o$YMPg`6j%^+(8t+3@L=x_J=6F}h<=l*ro|Etj=
z8u*9D8fHA~tQ_A%f>nr}i{Dq{udQ?LJUoDoOVVyrYadU~0Gws3b&qA&lRz&O2Qw4F
z%O@kHC)ZtaI!8mRLa#U9Y{jkC8Z69<4~PD)>Z$CDcCFzi|1CVoQR<3oyWVNJ^Ajng
zg!pdF|N3oxGP#V8c@JzQKsf(s1NQuWo;-=G2H+2f)^raw8?WCz3<efczVHTS4qfxT
z%&}yF`5?zW8UmFs=_k^%COt_i>|`&~y*CL%B@>xR*D>Q{urIvAgGgQGT&LWy0(YDh
zzLB#j;82QZpiTLl73og1wAS@dhJ_}w5uVX}ylq0Nir2AXYld!|%;jvtX?2=WU57NQ
ziHk!88z#@+ttZ23o|M#J33yvXj*k<Co*;JueOcGSk3&X36*!6(CIK0h#ExWT<6NIt
z`*#nXK|+W;?zV`5;Jxe7^%2~Ayp3<6V0-CMG|AsUpI=>F@}noYBWn^t#!Pa~h*vb2
zqP3Ua;;g~^>u3b=dyC|On$8smqZ12$(gTeeUTOarcW$FY*TPX9yIYFQGCvsVT8@%M
z*0RTLui41nd`I+n*N2G}J)s}g%s`;kGEuK2?Syr@nQsg6van$(7OPVJ8yw;>&mKLk
zx@xMhh))E~NJj_*+t~H>_L=Kr*6hdbGGT{}Ta5i0UF^L|tFzP%D_>GiUyFL@z4sXp
zGrj@c+AN-(-p^u!c<aUFc6qZ^1bCRxOr=+O%6j{5b{|*2xYFe4AmT9!@R+Ve3fvK8
zy1(fwLUwYtO$x&D*wMw!<5r4Fj>}Rqas>rR`1~;nFkoWZX(IZaMJ4EE@fZV(u~Ij^
z@_g5IXJ>B4H_dPXZF%o&CMX<TY--Jogb{!84AFM@pp-4p&i2|<v3J?OP^+4w2z~I{
z%;An|{;CNi8)yyN+sfxT=FQdee4EX;jVVDo=xaEjLANhw2~^bH>}{g1<J-rTfg9Qj
zA4a#&AG9{=C<<Q07_=)osOM#S-)s$xseQIt7L|O*m6v^BL2rHD77{tcrsp=stZhS>
zb-CS5J3Ko*-umWCS{Gb4<XUIt&KY%1%H;n06~55Pe73f-?ljz*Evzb7l*W*A^l}Od
z32IdmX@{O>lpr{BZOj(CqJHc|ga9(f=Un;ztx~q(Dm90FosHBF74}x#Bef`Iuu<oX
zBUoSaKy$romm(FY9b<KY|15az7Hi;Atyr{d;cip7O4TCmFB5||ExWaKM+X)KM+_0f
zCO4sss)W3S<)=uz2|3D~Lp1ACqSLx0r?xn<_Jvu(UB@a^1@wCFG+$Ydv5Uw8Ggi1s
zb%zU6R@SKNZn6_pe`wHE#VGM)ywhm;sO&s7Mp^;c0uzjn6<017eBIVG=Em{9myh)f
z!i)S4bDK;!SG>M`-KXWju=xEs8|#(oIsIHcFNb0FoY!-qPx&2@Mbm;6UirMZ`*tpG
zPV7PyF4;|uwP5VLg><iYPy-cHIX-ZIC}(AUf!&ED!@{K4Hp&ZK$;!sg#kQ6^_1ztD
z+Nz#Bs89C#nnTF$tOQHxc#U)U@Qs_|AeM{|OhFDn?C&`ZRa-kif=8sp+1k^v6pLlq
zSy!9xOXyqSadBN}Yu#Z(3S7s+e;+zdYw9U#v({i%u<O*@$lwAeF_I1qMbu<#nU$G!
zJkx&RB_Kr-D^(RFn;;vEW%+cFtz~<IsbzY7F3;M$ynYUF|JT0v1&{8_S92`{!t~3>
z{|iQIQb8gl7XDjC2}ca(s5Ocr@=!v4{-iRM2$uTw<K3%QG9koF^L#?I)F39wcq)9J
zD(Uy<;_eIn{v~44@tyC;t;~adI*24A0?~2zSS1NPf-4BT0sB9s3YsVW|J~^`|4;oD
zZw%VCxHqla=FIsnfW-s(+F(FQEM7>jN9ZG7D6+nPpIdiUv;Uk^^Iz9q&g8w<1@BBc
z<Q!6!u*jtLx3G&B+F-q@`G(VQy)p3{B^&V8{WfhWrUl+~=DI+bOA#A*%$Ul?6$JNS
zwJoEKTo8Qibxo5K2I=S$7YLonvoh)wtyNdV!<2Y+!d<;1v&Ac{;Y{g5GYIk`6b0s2
z`!h&x?!&RXA;nLP=ccc;zLj3avx9QcvQ2OVqCwW5L>fcp$P&L?i^@os^JwuSA!czg
z_x2fBzoOJCt(4DIGd7kbH5y-;O<2>?eJ9^d+Iek&Pm?1j6d%KQ-n?|JkwN0)#BLTC
zJ+T74c*(^>Ey-AZTUI8OrLIB1n!~%O9<AW)MmeAoHY%wKq{L39AMB#N5p{fIS0R1o
z(|vGRsCv05UG!kHKVo`c;E5?1>5z*a_EyoRezro73<M$*jGmD7WeyMNanDYyZaP%l
z?U|t4FErfZ=R0>@q9S}<@$*#SFNa;WsS~l|W=f_{wX@4yX>pP3sHa=C9M?IcZ`$OT
zmFD2l?%`DLW{Q!I7pquP_=hn)L(##xZ_<BY{jofe-JSM=ZW7SXdidT9m9m(Gdpz;o
zBzrOw*`5|whH`byz?j^g{-L)IUdKzyuCrc~9k#Q!`PTK}Sa?lHSt}QnZmt)z8>R<n
zq9IUeWFB=L`JijW3gmQb9C@80q%sDm{JXehq<tHbEjIzGd-a+`7xcc9Z11O*!m-Rv
z<dYuUffqJo2+h;ytJqQ9M%&7s%fIOngt?E^JZaT;IXuf<{#_iyC$4ngtbV@*rpGtF
z59UZEVJj{U9d%e|DQ`7k)WQdc85WIl*F>&z6_>k?Q~ZIbB&FC>c#OUiXlD-UHY&+*
z!ZUG@b(lX8cX_@To?(-(=s2M^)Cw#T;=L{_ta=mlj*{X}_|9)8WV8Vs4)N>E<m^+}
zV6~7|hh?qbVtBJ)tKOj|wAPm<JfnC|X-GKKiEWT>t?}7x&)h($z%z4=*6kupBa})E
zb>&s%cn7r&qkM`097hZ#hYq!X02=$nTe2o#TM-Ki7)b2*qs3L<#bdO^PqwB`$ok#%
z!B9=1U5YMM0cm$1eVH@q3kL0s#$vs_zE)`#Xic8M>Zc6`rM8nGcbO2pweF_Mc<ehH
zNo$Zc`!;nUmOx@wL)}rjmvW)Gs$*epDv)RJx58%6&E>bLqRcU%#LrM>-<QK`WfXmt
zmQlqGIdP)8!`Rt`>x&4fKaEiG2_?mSR3Mp>(Q%xfnMX`ns*>`mY91M|EP}c`g_&66
zh82T}N>rgH2~gU<tCY;$9s^uvCtH^?sCWyMHy)N;WhZ&r+@T%xXmZJjaWyof5nS6*
zAfF|YcONA=@TJPv*qs$*c~>#Rq>hjJ%nR)dC5XHXquHgGSNos<ye|DBkBKjMN!FG9
z+;)1t=aHT1U?*)yP%iggs3iY+YFV1OzD=FCKj{Y~uwDU8Y<xd6wcYivu{<J()6%VD
zGk+-H!$u{dnx8w?EkFFstq)ahFHx5cZoI-pZ0!@6@*jcK>b!h2&xtmUw&niApu-f9
zobHPy)4+fRBVj?7UTOIPW{h*L`P-(2fq;@$6ufUz3>**6xI|{Ovth<Eb<{>%zp#-w
z;<Lr#@j;9{u&*H=Nh)n|=Gg~sCA)l@W$ThPGN2zB3bdH$SX0bJg@{2(Kch0MwL5F=
z+h~#KgiH1IP~mF&NIT4`&hCe@q_kBhyXWyo&KzPR;7BN39r`r+EwI?ZR+(!=4?g-e
z(7ZK+c~Mz?$0XIn`eKhY1@4>l)#6%Nj<w^M#eGqHoMJwMsCiV^#1Sx7f?%BeI<RSf
z>~&?*nvYwQdjI1+(!pzujJ7~y;^Q^CtUrDJ4T+4G*8>e5Qp6UF2aI^ju~;$k*>rV>
z7)!ChT`d^2?Se20mx4@WOHCDBc;G0W^KV0g7FPral9YA-AX5?g+VvDqd2QZGTh-r{
z;!U(-I8o4?qLWOqK;;3-3XD-xjNE*xTdwgVnB?NXe8J^e39W-i7Kt|!rF_y6<x^6N
zOvX&7kgRHi3@dF#*bAK`4bilOT%WJ<!XsSb<Fx*t&8IERWX&OKnUm5Rt#p}|iGVqt
z#d3IFQt%w2N=nIMbVO7JHqO~*vFu@RYcxq;U4Q<*7o%9(qe6^eT{s}b29DL3O!*bn
zLaOWT!@AL`H+X#(!BJcxqx-02WPD0t=zTFc*lIQ6)8;z*xSku_zR`khB$8ypT9Yu0
z%m|8jNbv116B(>pDo9{6gk%mx;l0m=L~J%guFrDIGg{Q|L~RV_>U+stG!>a3ZT*;6
zT1X%jW5FDTb_lK(d`hi1{=lU<6mx#t5PGc`<Uq1^ka+pB$>`45@BEZO=-Nb=#3tAz
zFk2bIcT`oI^?bNhs5j5TUn?pCSf8DCx>BraN-p$5jPn1qht(O2%&T7z1kf+R?RXm-
z+}xX((;nM^AQv}Mlgj#|cl920?X%34j$OWV`iH0i;O?d?q7odQ3SP|1IotRhIvs4G
zWXx%~DtJ>L2uUTBE4G8kPUeKSs!OX#1Gl|GQn?It8p#+I+6xIs{|QA?O$cRaY4&$p
zRm1|YOSh0pkGfz#`o$!DeZ#6zD(Dd@1=L#wg86ekmX{YLnP*^!R~l6mxFZs%p^aK-
zgSg`gc>spR!v5Gqv6Ztc$a1eS8~xkEkKfGprM!I*M_R9q{FuZZr!Nr>XvgM&-kD6P
zwV&~c5yJTa3JF9$H%!1n*{P)1huzZsl*QI!LtK6jUnlqWsg!ct%e9tX4H&(wM1cmu
zNH0ow3|~6^Hb-$b)msNIkoC6<!Sv{Rg6r7*-^ODetJfWbj8bqL88?(~dAQOL(05WZ
z@F*u+Yw-%&FO4aH1$8VRlx*_ghC}1{KC!HoaW5bF7p(Vm^Q=e}6UtP*6in#sBIx<s
z#*qNPcUoMs%?+x+QR|+u_0(KLOt8_xGlBn*S~1Y2bkX~l6Yw@aGcdMDhj--+HjRG%
zF|5dHy4#GRw}J0aw4c77P21JeZ|G#V;Tcx^5b={hN=tutPmBl&hb2%omc>L_L5iR}
z8pa~x9J6zTUjQycW8zhna;cI>#}HY@-U?rPjnz9>OOV9!Rgad0XB0c=;(D8{o$fi{
zg9ppOI7=f5j}3B##~fV<Z}eW_Q$IwyT1fwA7{aG^b}z^7V~ttaF)Mof#sj?8uia6;
z<nCi4$PwC{!C0$IcybY<3+g5H4ts!I4$J2&0!O+to!E*~OQfrxXg3T2MYX*vx{yqV
zBtlJ5IGlh3N?#u8b<BY+tcic5s@=h$#+r{{J*3m})~{F`boI;?pLXNv0@s+pfFA{w
za!u90XKgTz0hoqvs{4q+V;+~R+`OQAbh|L1q~?xzHHETqjuHfaZd$Q!0i}PWkRL8*
z@G4L6its#rtEWfSZ?F>V=H{S2X5Vp$NkcP73$&7ErkBm$>Dq_*K0Z1~E<aU6SSx4j
zz8B%DYTyM+em?_lDVbCWpCeACFs#NUEZU6ZR=f3|I1~t68sOUUW}=hsvGOoZ@)}NF
zpbbgX+kW+~^%+I9)|@Y#;PB_NME+!ZZn+S`WD4hWVbbINg<*xOyW5!M;e2QJYaj;Z
zhu(Ba^0~v6ASEFSO#4;g&2(&LGI{W_{^LI+NvucG(iOf=#)>F=v`<N2$X(3%<z@Ip
z6O18K(6%-8>O6*c16KY^9ue%l1TP_s2L5s!_dP7t$_BO7{%L=(KM>Ks0&-3Q5hc(2
zVISlRTACuM+vW>8J^w)+?_SJgy={kLC>S=_Vk(gTy%XaaJ8esli+APNypJL4=-=@=
z6ms^g6L8wAHrnsBTlJ6sMK<FfopGlUpUr4s+8y$Q?bwxCEB@D%@`RP}Bqt~6KICF^
zAyd5n_wnS&eV4$Ri^?yq_TRbRx<SIV!Gho`%F#o5dFIqTx632PEfaELu%KK+?BWiL
zU}TebP(As~Vr|)z<HUX^9NQH$zZ%eo^y;#dR=|!<R)@KXWlABW!!d8hWj}LZR)i1E
z$oyl0gf@ZZ)OI){{qlLd!&h{nWwi=6!kpLvB;;5wCOV=Ix5?qNDjMZYIw%j2DEi{|
zomo<sum~<X?ozF3ueHHZ-##PKiSet;sxX|fL`>{VB;j;c#Fu$RO#;T--Ns6YWM#*9
z+&8dG6K6hIXlSIGwW~a^saK|(BPMjS*;krwInYrd#||VW*6X|X<eo?+?e_O`wCvXx
zb_dxI)9rq;>bwFAw&)KTiZqY>(i<7yMac{)-LvE+ee`7O8#KuO-VF4S_+*+@KhRm6
zG2lEnU!3t4hK(ALB82^;DP#)>_5&M{R!ugPkgb$ZQj}=RE{&PzGt%^m&72Bi6+xUL
z73AuM3cV-Ts^ECRNJJ9&&Abu1txe#*_<Eyk3sduf7#)xCn7)R}%JHmYZGtttLg2@*
zDa>T4YB_e(9NF5j9$H3AeDwt~b*&EdiAG^AZGo2JC&$~<HS&xert1KQP8a{zyy|5+
zFt%xdK%L7=uZl5oUhN=u$wSNn$((3YGXpMzd{h-#K3s!dp$S{OhWan3KNOZ(7cfW%
zLIKoW*964;AeiDb6Re2WWdJ=~Df0tJsv4fdf%9=O@>37*IuBERB+Cp-=A0HEq&w{w
z_CD9Fy3*;KXONn61uwC2UWY6&+#`ED^6aF#d@31^AiZ&Cb6Rrh&HU~r0C;zdI;86w
zk_nq;){qS7h(<>^k&RU1xq26aV(jYCTP+MH`j5tJeA*e5CY_=^XSH*g$#STcWBY8i
zV#~(N&6EQWf!u}jMj}Th4%CyZ?%X&lW5UjqJJU|4NeMW?k^0$~vI_AjYP}LvB5d{=
z%;&H&$j@CDj#lU?xUR}hSI#}7Geg`0w!xnW=p36qoShyz<3d=6yw+kRCR6Xg`;aF4
zZ)=n?S4J4*mvJf&Q3e2?o9YnOZ1T0}L$)+2B4zqSF?#zQU+2AQft`S*!LOw97>!<x
z67*~=9wf1CySut)2YC4*l6>6<8Osg?yG&m}yUWxEn{>4{8Xd|7QSS+v90=O`x4sw>
ze)?D{Q5NzRr5KM;n$_u%t226e;~GKZ_#~o!`u4BWqUDp+KO_<{x&Jp6ubsR0_wcOS
z<6T7Eu)>c|Xm_9gAq@mZh<>BIQL)Yv-LUq9O>Zpyox2U<UcSaTV7SC{r$k)wLkx_{
z)t8mgK1IqRb8E^J$<iu7SUyt^&LC|+`HP$T4G(xeJ<_bp83fwgr+G!>jw!w9{W(VD
z&*Ko!wKBwbY8Fx1>7u^&pRTL$@HbafP|WW>7>Kak)>1Y#Jwn_OA9Z*bck@r$dtmlQ
zaB~CyYhU!m-Jv^S-$XERvnQ^ydV~+1|Na+?|LXZ88`?i$qyCAwQ%Prdgd3bz&E}4P
zanSIT3M*OQB>^Iszt`b?`Hg3g!UEECvL1Ry{r~*6+@9ZOCFT*(#HXH<WTrvx6Z2c3
z;H1Rm_p}TNEE)m^&b)ZNeje2!%?@=ehUof`9)wAj+KCuXi@V*RZe_f~;<n5qU!*zS
z#`%F#2;%Igbl3zN)LRFb*h4js=-FM)>9OVp7Ythe>|`V2fjjd<Du6k$#V2WR71m}w
z6)C2G`s2n8bI*YRL3>5o1(T#p#O6_{i|26c1kjUO;C;$(7T<O{@%-q#3ShjDG0MMn
ztI)#_?H3UHCTQ%IVhDetFbKrj4zYCQ`?Bqodac(b#osjRA&R++Ewsixe3r<LbveS>
zml(xXHw%n)?fOuUP5rAE&NR2naLNnWpxY*q<w!=ds)$lA%$jWCGISKR14;yBU6m$h
zr!K4nE<w?76tXW5R3@U$+LjZS1CTSr$N@BFly=MCn42{Tn8TFzbA)WoiW=lRHkSvX
zUWG>=w7kngEt3yS#bzMbodznfL}QbjcMpOBmt%x?i3X?JbP$d06aLSQ7nQfk$?To)
zt4$-0dv%`U^?$eO4|y=)d`?{6yb)|M42Vv2-)SF`r#BSsYZ&L7=&(^iqIQ?Jp7Ad!
zVH>e8A>%mc1l7mHjH<U~RXTy=`8=WqwJRWUOsJg2kG#zyaY^|kZ>OrcaUC<3?KeS1
z_7xH4K=<Z`S`RtMHt6zOSI}nGUVbCYoy%v)>4adE%-uQ8&+VcrhvK!%op+$&5ZGon
zDn~e-qK2!>zeCl8ml<qiR`ln=!AIb)t1kywxV4h@8<k}w2On2?J4Pn2p8qCFRinP1
z6<la~2Af3LEOvQ2dM(OM*p)#AnY?zg_g2~DTTwQ$agfHh997?y&c=$otTyV)>S>tm
z*&E6dg%5<|{-qb(F=t-3<Z<p%yym3=T)UrC$D)fyOmGNhAjl%rj%=g?5}ZmE3T`$*
z!#ac)F|1YV9nMLpyy0~1+_C&jFxl!{75Gn#{>reK2tF^?&NW~jEO9!HCT57yN{ijK
zePdrzfrqPL+O|)<HYc}qKTKoM&Ce$u(jpA1k~-Zt><uaZW>Z-|=eje=Qh$gRWhit{
zyH^hOS?RciK$d~JkFO5Hz{WXfh{3s9GN$R%KBMVbo;X?X1MH4rlP$0)q&mH^_z-qt
z12vwOr1m)1?V~H=JFw^ZjU*^-Gl^CNUhGfK#B_}^rynGyc0kI)IG`T2kU(!<cu(z^
zLW-L=^<#{74xQ+XdmV*pG{ZqEDS?0kj+PId=pa>9x~!{yk7SfJoAe3u`)=I_@-LVU
z3B9&5L?xa@MImtDRFmokWKK{)+czoeto<zSp24x8O-|QV(Dh+GUX@(G@oy6Wm50_(
ztl!sxqou9n{)Cko3Ff<ZBqv#c>t0<N!Y9uY&%IyaiR;HgtjzM#RHDm@18!qgo<qb~
z;g6<-!2m;=;!La}WLyc!Pv|(3Ov_Tu3IA!Mq3L63dmdW?KWH)bhsQd)Ujr2IX@K~;
z?-?}BB{1T3kV-RpQS7KyKc?rQXmaI&R2R7R^50`1V(m0MMc=3mnb0sozJ^AGAZePT
zBWWloAqnyQh(G{lEfGo>vug0#MZBlg|0$zh<~{#YMu-2WjQ%ywI(<fThW*bWi@1OI
zKZh&=r^U|RN4XPZ{SRq$?9YG&o$nju*VYWOo{eHmL2@JywWr4zx4Bdz-B<fDS1RHz
zLs9c5fr|GHr<Z?jSCf%NDlC79K~)TPR?DFp!|y_l2cn1Kh;MD8FRylC&(~?-U<Uvr
zGIj3b7<!pCSRko1?@a#YcKlv+^^;{eQ|B8sZYOoNQ(yz7Mv>|Q%M7xJ>+vTvDjhpj
z=G^(KuLSL-9y*#4b~o=ZkTl8+#3E>uNwP{gaWGvdTs7$p$%})L-}c6y5rpz>bu`&W
z&+i)H0tV9*qYNcHWI?|mP<E;o5ODR7`fPIW_9<g@sYYUS$!V+fb;nQWc=`G0;wR@(
zpn7?m2`aJ$FZ;LkPw`qaVr8fy6AQ*|e$N?y7fJ%NyD@k-gZ|ba_P{3VZu6=TNxf1@
z$TJ3NfhU(ipKET|2V+HRL#c0v=cbR?YV-k*shSS!omTn$;X&)qArAgctW-Y{+ZxIC
zSK-W>bh+#eAta~*FwC#Vi>s>FA3Q%@3tEwP;LH2K4gVnp`!_Ajw)__GENA$HD$z|o
zPeE|;`%|V`e_?ydRuYyAZN4xL70X$CrjSEriBlsg#Ho{mrS?N8$|e$CC}DyF{LSb-
zo@ZFVf-Wo6qN({PmY?H?6!6UXhG8V>_<483V(@Xj$LRvd+0g*aiS%nP*qVAx0!el*
zIATJzHs;6&I(_Z<HcMfo-#I&8R+I<LEEig+l4>&}Cum5&O25g5!|FPH$2tzDImcYj
z;Uay_8RXUR%Tdkex;A6VO34kb<+OQ;$wXXdWRXCaS6BO#`zd$?&c6KCGSY}WJ(A&W
zMT9^|$%<uczFS%MkNe<**}dS!&c!|(o4ZU$N#_I6LHUp6QmG59<>FuR-jf=$XQu?)
zC0VBxcC7jWH$G87@>LAMM5PNb|IN#;=U_j7XS3{Vd8?w)S$qyzN84G$&m5HZosd~z
zYrh_Gq=hX0Oa7LrMRoR!*K?5Ts@J@)^?ZxL#9J3zS>Yz}v_rbRo1~qM{?cNaWPcHn
zy`~RjcEZKF62{xJ2Q^9fS^Mu*^51xnPagb9{aA0q%y%++xMTSP`D!u9KdKml1hv_I
z_R9E?oK<e|F1z3!$DE!4e{FK81W~qJ=T{Ta!|v)W&5Uimo?d!C));+QQ9XEk9bGmB
zbQAiI0ER)Rp-O-$>WWv$>n=+TU8YMWRYKM%c=t+G8EiDUjbv^2dUTCxiM1rKXCa!K
z;m*%Bu=yWSuTs0r=vh<9y0VFg%OXFvnVQI(eYjK@H5ylyO2o^dIlgdvQc`iAw`EXx
zdMJ9;o5o&yUE<pJ2~95JFPpf|?P_FRMfx3u#N8FqbIrv*?$ZoFj}tjiAPHvdbxq?b
z>mhy@u(O_icgSRonKUeuo~fU`q;V{IPA4nXBSV4krK4BB<@;STUa_{q0)=qFC)bP`
zLUU?ELk*keUdtEzRN~UrziELi`zhy(ahap$PN%8Uw!TGY)LpOcfjajfZm~k``t{+K
z=UM&8bXQQ?9j9om_MrV~n)skJD(ZKh)p4uEv5Fc(xN09X_DSh;muXbLYW`Oe=Uvt1
z1F1N&WP|OEhQZSshm^5$WK4VLPi3xRc^o|K*~ziET{}jhp^lYH@BNyn6hYl>)3vZ)
zjcE0lt9jrhfM9~ZovzSZMTZtd-HG~J_0Q$qk@HNG$8?F42Q8GOMr$i6UBpA;EG`9$
zm#hA&>K_NfhfGDo*yhnod8mNin}U1ERw`87!qtc}ET;$73_BFK{5xjU8l4J$c)J<z
zKcoc#ja28k?AWO!Mk<LXQ(ZMMEjDo+&HHS8-wMkc#1OEL``Ig!SR-pI1d7v%UVWWz
ztYfh-sG{bDp7g%z5=PgBUZb-NIGBp)OCy!}n~mj`YI86Vb;PhKf&9`jzLbv|2lSK*
znA+|PiOglhfTiy*+$nqDLm85&!{Vv>x9B;IdfE+Xi?_Vj@Cs~!f<eaJ7O^*)AWF(s
zsTyS|qm1B0wcmm1NeQ4(i8qIp*%Q1=xt~TQw%0c4u^83$fKWRd$6-A*sffv5sR#;)
zHJwq26%&3^w8o^%?4ZVyaP}fo>3SV4Q?iy^CykXxL;0F#w6c<71n6?|UQ+jH?jV%V
zv}{D=m73}>Zp#{A2?CBPC$6Tp>(&TwtoMR+IIiVqz-%AO9+IyWHYmw=U}mp<e5~FO
z>282GeEpUJc;`hbZeIO%EH!OBZ}+14MdM@R;>e=!(BXJg>&n^-q<Qlgo8iJ;(zM-i
z)zi=u7m^_I4{2HCQU%Jczrg-$_c1k<rGD(cR>XYhQMUe}4O4FjTV~O=hi+vq5??~t
zatml-!-aLexTWG85uIC&c{x4=(ncgVPaX$OM?Os&mQf8b-zxH5_CiD*Ew($yEC$Cs
zH-qp~W%dFI{a`HDB8>EiMy!13f^OV7(Bg==X%7&kHG@+9;lhBRK;Ow<6wmw(Tk3dF
z8aK2M`BTW{E#!8~;-20x<*o;NVBx+#ss+<Wnc&M+M19MmTBGk|GXnvqUsR_<73sTA
zk$aD!D%nD#;D1P8oz$O>?7WZRYcIWqLZs@^9C{A#crx8Hur1kmOQKPxw!lIf-yj7x
z6ZB%jo4A2*j{ne|Ynr|<QUl6;3YPwXY*R&G^Yc%Xf}V3oDViyhF3o$@HP$%t?I}sV
zV-?PVZPX8pU<OlSX4@i{H%02``tBZrjI~-)M=pSg8Q;&p0a%)=C)^g29iDR`R|>TF
zA+JMib5VRH-@OZe4;4tFqFTVVg-mso&7{w~dU|9Wc#F;?MU=8GkYtT{x<>3~(*}x8
zS+o~*8i7pZJB>+~mr0Kpc@qfDMtd6F{l#xPobwV)a>?~pB-=`1T~h$+&AsVI$yW9X
zm5%w1%~%c5SBwK-R_P0TFBdt~(Kz?>RMz#Vhv-AdL2fEg>Mty=Kl|~#Ge#WP{P~jn
z=4Hvoabnh0YxGEf=v@JjABXz}VRK7*8l%R0rJD>4OZ7q&wU~Majt2lc2&Gz!$Wb$1
zr>qEK9o<C5(LqoaXMcM}EsQ!D;*}(gzTGJsD4XjH1HR%57cT!<9kGsGhTJ@r9QH-C
zd|EmtFIZ;wI@Z-=T3f&UiSmJM^A%A-v@wQxbJ0vJ)OG?>#8%)Zz`vh^VM}#a8l4x@
z3gcli$!NqTCR-)$E)4pKl^HdyxucQbjIT$Pf~E#t|MS?W(L1RqMY^WKG*>kW|IY~y
zWlOB>gv}4`y;F?V8Z0M}s>8Y9MkACK3SH-X3>S2ehBGuv<PDs8Wre}Lr`@S#fUitC
zN;-!6J36Q;QldcJ=t50I1(@s@(pY}=em0F03eagw`|>j<;+Xs&Qvbqg7hOk={=HL~
zwdH&XUdYszw^)j%RPjqkNOl~Mjc)ftTqIx05F^VErtJvo>d=d^FR7|G$}=8_44zFw
z0+cNoLgc1*VX40J3ZfChju)ArfbeoM0q9$WEZ7Q&R@BS7i&DmL8XL}fcL#M8OV3%E
zX$i_c`N~9vR*4;s1z-V?o!0p3VmILliQ(w0s<Q%R39x@i<oI1L+sb;)y_cK1MW0mP
z3CtBI_#KHza&<I$^;{c#Oqvv=g%syAT?ZqqTiJB~kp5&XTsDPk_7!W-kK06f9G9?d
zC=)f|e@7rAqF7MNwoIP5EoZ9c&#{wGYC{@B%{<)2GT!wMiaPag&)ZG2wi_=7vY#@7
zND<0c{wMYB5&=}@ipCTWYr0KScrD|)I=TbENuU77qwg0@#3q02xu)WuP{PD>A~wIZ
z21kJwjbc`1F(y2Dmi9o6IJIh3JN4!RpXOD}Hud0+)ZWOMQGTq7d`d0DYZZ8U$A;`-
z5UQc9(NTN|0Hjv_XBJaaIdPtGQSOc(XLU8CbPFpMC9PdM?@#3ScGl(}A#cbDWjQyu
z3j01B!CC2($C0-6zPxh$q4|SiVi&*6B%?Q}U~|h>2>HfzEguBo)TBpJsKRVb7mh@5
z8JZR4)=ze`d$Sa6TiVaQisOGQ#syRB1{5ETbewp=KWXWzJC^u=7oKq5c*%`K&<OE3
zC;10Ev%N3lXkp>Q11zudUgFNO&&v#OuX7irgI=&^ljrm4Pgp;D(kmfsek$}$FXHrD
zes<M?Dgzq`$K9WyKSsLU@5JBuDf}p()IGQyfPeS1&J3L*j+OIqjk)l$iz01!+obw)
zt&@{%pQWS0N!wnSH~IiSGT3EARm(+{$rCYLb#YcSK=%a9Yhl@j>SS`xrvoJu%U*D^
zeEzIDrMNp`H*R$q$aTIE1mcnxdN;VL=tW#U-1j^RUzxBu$%*I>%!Zv4k`JS+adth!
zA7BC(`V=`VG!wZ5DIKo9iEge0Yc$js8oNWM=c!ipCNyIyqU0<~v3XxNc`Ch&f3$86
z4YFIMCPq0a^=eXA&MCF<O~7)%UQ8FpPDba@$f^!aI$g#Pj0(@8#6Hn3zwQ*K%jLoW
zzTjTFLSgThP`|(|ZV<YNStY|EZ?WeE4D;rGtK}r7r?Zu->RrPLVJua&3wN%V5ZJ%P
z;JJsihX_x(gOvts&ygUJ!lwl#+G?}lj7<SYY^`t8z8-jGRd$2|Z#(6EXL&5dRZp><
zb#Q9tT^22~QY=7|y&D^Xn6t&s@a>Q17F)^#qqOSW3`oE7B@fRp>#PE!s}tm^)nGfG
zH%C);I@4o&T3LsJm*Ch`VuXbXv|GOpCtyzJOq{IuRsr-rh>C+n)dfp3M-Sds%vH%z
z^*MSeWobkBIpeF9^>sS(Ny8q8^*#4P)`_{<(qTken!Q55GPP86;TB|n)9Pw4!zm?6
z`<VvbSP(Bb2HM;7yv3?E0EW0JVlKI9#_`1ayJ`znZKv{BVZ)TUcdX%{eFpC#HtW<^
zJ8i}OF(e}fo2b#kk64FQ=owbS)8*!lc!{0K)*m+Y@p*Ebl{Hi10zx7`vI@(0*+)Xv
zy6A4(m&iq{^Q6rLV9TRBv>L=cbiNt-rt@7A8CE34^S=cq#?$642bzTpaSg`l>U-om
zUA`h`-ye(k2)goSc^o*k(kMFU0;r3<BDi8T?L~gdka)aC?57;L+8J#kG>=ssK1f!H
zni_Oih6^Za;W0OHOPKP~FY5@7?^u`)L}E$8F22rFIMB|xj_)`TE2;3LB2jBC*?uIT
zBW|;4BN-Ix7s`0I%dM9!0dt6>ovDHRK4!|C^S4a2$#)OEA051*Bv$|2j2TTjhrG?C
z#}f6vbSX2ho2#g-xY6^S)CXNP<lqR*N|ax(Led#zc@}UGSma^EwfvH+|I39+Bl|^-
zN#_3ywq0SqqCKO2LGinHL4s#52qCt~bupf!=!+2cPlUDBPbT(f?qf+KnBr>cF7Q8t
zt!VCq(Ncbpl>CoO$(N8gDuFHea;R7a8iI)`DK*Pw4%J`|8L~km3wQd5RDf{T2IK`v
z`(10Y{jZ($|LnC01^ChIAJQ2U-Tlkre?Hrslm9`HVLON#AXopp3rrgsY#xLH8{;!k
z9HeY_T`brQa{HUyO_@U`F5+8a65c0|px{W{TVLYuyZZ0b!yZM9X^q$ugc?sd1QpRC
zwSvQ>6I%#)VIuWT!~&uKfr*jM7B|Bjm|%g6sx_nCSQ`OyJb_I}6O?IY7a_jr*%+Z&
zAWBJxPwDUf{~m<0QqEK}`uap9<I3x%lC&kq4oTuwk#e$~_(Gcl#&*JWt+E@_!~x}k
zaYO9-O0hDYiblPsQQy(p$BNDj&1Dt}7w9*get`o11ZA{&ERPsb9DpnjhtN=`Ym%zM
zSO|QvV?m~s)pfb4+=UU1E2^1f!<wf>u?oPJr~O`alTBAUH#0Fet}-*)dtgI7z&k(x
z8v=No*?pS1(6q;qRPl3H$aSrAVcjC>L}4!MF{R*`jj_>7KBOvOSFDLuKizGT(S0a+
z^u`V?wxM3M!}TXsDqMmXRd?u$QB;KD7^0Np>Du>uW$ygRb}VHl+*aXOWM=uHPsUX3
zcG5C%pIAsc%46{Nv3tw>Y0d&$)U}{in8AS(|KBbs%U<R92HivbN)0ymK(sH*w}9;0
z4nRn$dJjvZjDF*$Do;Vt?d3MP^B};WU6fS51LW|FJ|xdfPfG7+sC`ZyS49DL(;l=2
zkW|qnve5k8V3=s9Xj?uZLBYARc_!FNSK>N1<fE+@yTa$B$Y=y`M%ouyseMe0Gp@Ru
z(`sUlKD@C?$r3GUvvT+#_{UEx*|%keps)u+KhKzuFRLu+y2<6BzOJK1a)OTgZrKH&
zxp-;uE|RK{*x1O-I@*BNkk=1zOtx=}<dfPNja{8rdjx{H8r3;jis}uKFOUaV#b9Il
z7stbj6W}bD`B{Q>2c1pbY*Dd7uIx0J6TZD`vspddB4d8-@24s-hq7Qhb^BDvQ@0+n
zwm?qN%vTWiEhC<p_EfDT{os`8n41xY?0ay89}&@jybaq=2MID5q(-letxL*EOb_Pe
zL3>n-IBYRosnqj-)Ld{P4yzloU~<qXDrk#vTu;K=@ODmXf?rJF6;y?G-t<D4vpmBf
z13w{hOBj>bZ8k0$BV}q+*6`EDUI~;=fAd4E&Lc@))S_#b5vn0JSw%2KOL-lmq@Z+%
z?Qzko=t73JO$SgCvqf!^NiTHhR`0XK$DO_*<?Zl@S|Xmk4PLCNTns-8$5BQ}Iswq?
zfqgtUXB;3;M7FQ=V^P_Lel`Ykw^~^Ei+Q@A=Og#B>BZ=LsbDw@R@xvMI_F;Hfd?kY
zN_c2{-fhgKM|x^ot_SkfjFoY&PRUBp`Dl_zX{LS8u>XrviJQJnN`QJ<TRvY0`zP8A
zm_tB;gwuQ{w`;tbN!j|>a#TjqziS=wDR7ZHkWOQRA6|h22hSI~tkp8M?{%i91Ml%f
z>+A2-(19SYW1fl8WX5w*jMdR7{ie=cjmnUwXs=`l+teA=Qy#1KIFvh+2Tg2<Kg4^5
z5y=!LJH-?hNu~v$GnjHtzgV*|wI5wkly*P+evh6u%!navBQeVM1C>tU3qH>mDt(0g
zGzw!C?c&Ggy6fJFo6rTBH7>Q!B?8S8XGSrAO5MPe51}Q*r$)o4MpB9(RJW=8j!Z{a
zi^|ZS$Pfy!l!~sE;2k!oGXv1c6sYEN#7oq1gg^-1eMgc}kc`*-befKp&Zt35C-v?>
zrFEV7L&;^<16b=1hsSf=q(tLCq`0fhx{`lLeem3i7q^;QtG|eqN=yF#?nWy7x2b<S
zd)}#>vOo9)9Y?|(xo6~&xoB0<`h%UJvomn{d^)C`JBedX&VNX!uJ_7(>w->^X59~-
zV6naG=m^0JZicTCTi|s(qXEZPXciC3p}JpfZLR$Q5p+>+EimRkGwGIxGN|wO%XFrW
zmG(+Vj)1mzPa_Rat&E~#a(G&pL+~>o!XwAqCqJM9MFfTDy|tkWT)0ZxXHGW4$6LyZ
z9Zy{7#>K5FQ2D)@v&ce+8cfe$hmVCd%|OpCq6uy|tmi$sLwyN@ZNZN$aW*4Sp%I?}
z07}_!uzv8u3V^GNB$G2+d2YplC5upVdl={LO98RM$0_D)5!&`qBNqhufU&W(G0^h(
zsKlVyPxk_PU8TIyhcR`^HGjUEYyi10$_pOece9D-r4o=onBnj6=XE@8@&UG~+vgKh
zr2M?Y62T@J{D;IFk?Pc+h^T_>?trHfcNQH!SRzmuVax9j+)9lQ=m0GWwulwA3jE;n
zQ<*g1FeH|Y5mQiuraj(x;Zr<Y6H`D`%1KV~i+v^A5|q~U(lRC_>;i>ZNvFav)Y{*)
zmq4))m2Fywlu_pmW|xUoHPi0LY^C$F%xvMw2%Ia`%Um{pY*1Sj^D|c*D3e@?c~n;4
zo)GV;Tv~(htf^J|Xt&d2c_Un9q5QgG$j~zZ5lzgXkjj>7vsH}5=-5MD<0bzqZ5v!~
zLT+Je0)CI<-I<K$W$V|9w1p?2bmpL46Bkss%U>dX8&~SLU3nN&k?izsqlsQtIAvs_
z*`HufdWFH`I2F6X`}8Wg(MyB+q$q=kb&4ou=x8@BeP<-P#;Bq%w!PhKMg3O&NKdWR
zbX#{$!l8+$Xi1+$EzCw{_h$IoCAr7?xk_r3h(LW@+1{axmO9-~C<i4sED?|`RNZ;L
zWHCSYytFZ!>&0AUD;v!KQ6+dy@X1oju8!Py)GMVWhgmOjt^jycLy5uB=g~I9PES{u
zeLN>44$-P-zAWs;$ScwQ^C$R5E(n;SOmy7Vbwj&$;4#TYGl$vktdff9!D(%y#BcCv
zA@0v*?D)Cm?RpcIk;0oThPgiv-Lbfe_Jpaxu?XQ@jH>t;70t2kUmlFR6go7)^t&%~
z(&yV$jEm&$xo5E*y0KAJ?v{Iwm+xn+#XIi@s_LPPR#YuX4IY3Q3);|3o?nI)WUN&A
zIe$gyZpV-Ii%+K85p|cjS&BVbb2J1+j+F&p`Wj0^VnC?ZKvbf=FHV>!y7h*hS+A{z
zgFfyiMd?Ed6Owb|LedT8T)Q>BFD|RoRNi@AQ16<hk*MHI*3`<-k}X^@J0T+un9XIm
zibXw?S{MKy?1Qsd#5$n!8PX>!?;C(xk{)x!9mG2WY+pxU)TY){o9#=_g2Zx$mu?vM
zk;Q&ZDT<3a5pzZ)Ke|i`yN#8xe%*>pZrk1@Djc)F|A(YX(<nUS#L}X@8`9mC!1qlc
zB5!<<L+O~`BNON{it|k6*F5o3x6Ur}P)48ZRE&Q%$;ev7mpzUFP%K;RKlWTOAHAQD
zbJByvcrIGd2%@&C1IwbURlgBbQ1=d3yk__|{D-M1r=)x%sfUqho84YrkkVeAcECln
zS&p_8()cmK_v5ybvTbfn{0n!EoMWr(wtM!sE-WLime+JJMTIp|%bad%&Xd{LWuw;N
zv!qg7qr&i(=>4R>gN}>(TUjbf3*SwitW=B2z=dcdj%jvE%BPP-=wm>ZBW<me8men5
zAjH5qXJ1t2^1v4>WPdUwqpmvrFL_rgpd)pAIwHluZ8UHr_z4SlWQ?cT&^Y5>=CI|h
zVhho^<rSN2N?`N5ui;<A++w1V=4Y4KJq6Bl@Y(Bj%iGK~7K8%c+$*%4wQhM81XC<!
zCokyJ>ta6~N{!HUO{eMrysX<T#dkSt6AR9#cEqR7TO*|E2_DT%t#6pgy|w#_l0tGQ
z7b-J}WaK2^j6U?%><UGe^KHfIsK$kd!Au7lY~?Ra-(`W7;G^t3F3DmNxT5I!#wLkQ
zW|(0D9;c<<ocBK@cLs-#$4zMdTP%r|kK7JZiXbVb@;P6bRD#6ZU5aqo4WkGE06^v@
zzF-r9EIPfZ^L4lJxE@<3@mdDZ$waG>U~7j#uX$~FZHn^;SAJ2%0vCl!qhy*Oa%vyq
zDc+4+1*Msf7c4nQDB4t0qQ2#CrLeLuNLJ<ehosK%Y7QAOR;pfKvRis)z&&5U=wIfx
zc=N0oEB<F>ZDaWlV%J}+UUVXYz*(#ze(FW<i``W~{$Bd$_4JYthNV7x7i}tf`oEV2
zwl!cz?T<Mg4QU@$Kh&!6s5c%2|G3B&@Gkj4aXz8fyz$5N&S>xI@_sUvwCw(`!CyL|
z-1$$ecDCPAj=%TH$>_IqiTv4Xm>XeP^&*ya5sIJikmunYT0UI)DRZo)(zBIvWE_4~
z=9=wPbSkz}lCr>c^72+X)qWaEP|ZwP3AGfV+vn*BCva`3lQXXVP5iL=eEI0~NG@K;
z?>TaDuB~nC9~_jnf?@k*ZN0o&pxmG6eqrfHLT`>cX$u}_k5r20OQ!K*+&e2lc9j8y
zTXHHJ(HqhF56Ne?5eH8rfdu@DC*K~%q*@t0a<wW8Z8p;N++_CX@JeuQbma%F5OPtW
zNCpj+dtBdGKr^**t+iEWIIF*Qox;TN0uM9+=z70Y`?V*W&q{pbXm@DjWzYFC8z;_e
z^w!I>cs}BH*u1e9ubPvkYN7Dye_zCBxc|yt_BHTIIQUJ?9s80OEn{O`lm>H35&%q|
z61k`K2DD2KVEepNiBj^Kki~z5sa%iN1%>+hIf$q1j>i4RVnH@*E0kq-OoBA9zFlgI
zY6!B7SE8DbX~E(z0z@VBZ;p9HvD<!XVK6XLx4m-@|5bjq4;4QQp6R4|KWgYYv%7%G
zRzK}B7NqIocpw2w9w(7Y-E3O#e#ZB7QitA<haI%6;n1fP6<wwvDS~mk{WKs6WFW`W
zQRge^NQVI&skx-t?$=vg0&<OAF9Ti0vGp(L%BnN(5sIU}`e#8UgL(YaWWI<t(9|&%
z0Gst`Ri4~BB|g4H7P&F7oi4`lTGz_>r%WfJT{I+>lTUkC7uoT0@Kss+sTA`r%GCmc
z<!=8a>abs`y`gA-zQ)<Y*En$fO|sab<$mB;S)0%;_U0g&)cfPb41SYlpd^#y0b8Dc
zO@i9ttKB5^a<T!EBwC?vTY}sH2Wj4Wf{dw~n3s{lrspq52QCIXVF?8Kf?vx^<}O6Z
zHuvA>#U~u0OFO(ugfJk#)o$?KIR5+gWnbByhD^m&FE!LeQ9zkt+4E78D{-8WrW;b!
zSxvV5=NT8kbW1PE8XsDeWbzgR4P&%SlV21Fc6I23zQJ%TQ-(YS3)pgM#D>qLo6}9T
z-w5#S&Iv3k_|)%nHnqwMHkM0XYJ76oUjKEY81M%#TKp(}DtcSf_i=8$dSXl6+B0QT
zi?9mAgZVKMKwD;WB)M$P;+7Or7O?DEXOYYVEv$(qRfbhmN2oB)<pXsXb<kR{WnPiT
zc+dI(BurK1XcG@r^JJBocLxcDNuGk;8=>J4YXV6%f-?Ezm+#6-lT0y{+r8?EQNq(S
z-62@>8VghaBCmHf1hD~QX=<Tb%7Bhq+wBhj_t`(i{gr2Qan?kFWy`|!*Yg=(nW(Cu
z<xnfGr?Z@j<5ScNimk3!4OOw?X{ZOQbT$t-@5&T;gSspx{ZH|0I-39~!xqIe3c%t~
zQ3(-x3Ol$A?3}JPrwUlb-ob0%=fJo8RmbIXnZk%RroB~c4<p@=M?fJ1gMbDB*!op!
zYCqbu#@9C?3uGBaf=|U7W96e0RE&^bRB%3%7PZvOOrU1zNdmw2NBA!Cv8B3uvOr^d
zi^fEI>F5L&>KHKz)+}GD(sB@uMf(b?h<(EU0~A5)z7cFzrK$C1tEbiLaAM6s4l`U_
z`}^r&CA6f9B`L|Zk@60Jagy{m`uHsBosF$SVB=D{l%#ID<x}Im1aw((45dm+5Tc?A
zhCv}4ugD1XU1@7O*{giSxbsvE=2kPQLTQ?n;zmgwV~=-jgksE>XzI79K=jwaMo6nu
zxFst}kwk!!oRjlm`p3lalW^+7F#&+9HT4}S1r|tY+BTfJ?Cz-B04c+0?f`ZqW`60O
zT5edmwNjLj^}EQ#ozqkt#7>z+-&mKdzk^d5ULLyPDLc_X`SFOkS0d)&n&RcW>M?b~
zqnz{;t}*0Xx@CVCzI}vtiKX^#*3hUWY@{ZJb01@FGMffeRYH7eK7GpZd!A3k_cQ+h
zzE5TtPEHJ0+W!Cx7r7$!7y+!Nx4LXwq~oq#XL;^ti_beaUvGT7Jy*YFjn(Zzq@}yn
zTR=VG^v=2R?Z<9Bd^&f7+&)PrvWE9xLTle2OzARn-E;7C)LFZ7l>EYScfF`eYv23l
zUpFqUel^nR(YvUjKQNq4$7*pLm-o)TOm%bdYjN0(K`Y}qy)Rn#fHR#YOygLwter7<
z7{$Aqpl3P}iwZ6CflQdv_T%80Go2RpTsl<8yN~UF-Ci&~uDGgIJbc*xXHINh&u^CI
znD+T~a+j_gM>so`Vlr@?eH-TWIeLN}HQq)MI>I<rvI>_;iAqFJlrNbOXeMc6P>5TE
zL^wp6T^rG8Zaw1!>4}R{CCQwMOWBAPNpbelIH-Pdc(;0EPbN3{o}Kn@Xq8&FqB=+4
zXAI%AWO+_l@qJ94eXgA{<nfMt`;N&L$t(d*5z|0m9#YS1EbR4TCX(~nUVO5<bK1s)
zE<%7#^6~YdKPaATeWaJO)6zQfdyKEEhTJLa9Z57JIoz<O9Qj1$J-#}1om#o&@n>!k
zU5b6bO=qC{wYt7hIe(Xqw@rOaqc1)G0NVG-*s6L0?Ct)joW6^ze^(|RdV4*nr{-Mm
z&Yy0s1L&N7g?H%O<*e!FZfLrqb}F8Ptt#DJK8ff0IXmh%Ihc8}^zBh6WglepRcLnV
z;Gd#-{*F&aM^CKg^N(}XhUiz(Jrw8`=jBZEUM$|7I(=y6UUSO6PVFn`o`UCR7(XgZ
z^8GyCuNdw1ql?c^y?^1E-m9|=ACW&q^7v%+cu#}B)y2WU7cLXKYMt8qD8V0wCzDs;
z^?f<;clwz8TwD>jP~8iivz?E(Kk1L6d3yXFucbZ?^DKTb!+&=X?<0s;(K{vfF^~K)
z^iL+<pQDe#=-j@qKbPIdi<XZ60C=5ZyA;pV`=^>^9-s2~Uq_=)Kb~I~C?B`#K8e#g
z*p{j3`=^`AJKt@G!RYaD`nmjE`&X<ZiY3FHh)+qzXB~gaVDIANIkNbeH>t2bWPQ-?
zb|ph>Q=ioPw|%BAz7Bt1Bqvg3Lv(%6YV2#nVzKnh&O`jC-nxA_$N7pfZ=2j<jn8E+
z)3Vq1%k>ibT)i!7@w5J5`MqBc5i6D1%|RbJ=Ki&gf93fnsd#q3UVIk_*AhSVluOa|
zX8kKv>pjDl(d1|7HT9zW>&^8un{vxoM^o&bzs$IOK3K=lZgOJizniwPyym~^&3uRG
zo&NyLy#73&27ZNZa>qdR;vLI5M#b&ua0gL^JWTX`X<R3qbG%kMdCGltr>Xw(MMQCB
zdWw31%67k*Fv*E7D|?wWq~STou3xsA?Yx%;t!iY<4K`^&gLhB|V=>_t*8GwQfhmm_
zc~iX3prkwI0kMp^>r|JaV#u<eqTqw-jF45iGFp}_i;C*f>Xgn`F>!)fSl*2<cSOz3
zLpfJ(dtNi9*z;#ic&}S_v6Z#WXHBs(XH98jg}^fHW|M5`tp~23*_GsA^~L_muOl@Q
zRMOXs{h%7_N65(S>8`STjP(0|koNxoBggLl0Em0PokcY0ISG*<4uh~C;-1kr+5Z6e
zq4P}P?)?vW=<n@5W7+)AY|wJDN06IBKd~doPB6vk59C$=DnKGatRY~?21+Rlu2Cf9
zWK|rG+6n!Q@6l9_-<sLK`YM+Xnizc1Gx=$s%U&OPe`|mJ#Z7ztE&l-b6+O6ou*2n#
zoyqglKc4;}NR&Y5O8%VBoZ46P=6vQk{!92A{{X|S@P85<AH<JZ>`&n%$VGM~KLs8_
zeBMu-<iDNtxc*4Ia`-w?w8tSeiHcJuNr_3FFkBePG8ra9X7O0XDN-veBQ&TpD9Wf1
zxegqnEJ{#aiEzsnB}}Tfw4dM_zy4o${gR~ii~Ivu{{YMG{{XTwtYaf5sU^=DRE<ps
z=lkcayNk-6ODEJQbCr*3EmMEKVXqabv6i;Nk9bPgbq2vSB1O>3!<^XTDpjf^ahYpN
zxQlOiY;}~!RUcYss_Ax`T??_&QJq?xWYXz;jV>R1nt~{qNUds}WYU}2rDtn&^*-9h
z6!C=BbyPmeh8*Z-IWh8@YO`a0J9$TFbdzIpvXMlRa_KI6P?WjMC&qmKZYzdW-=AGm
z8(NsT4q*n7FQlQv(zDMMalK7xmUEICsI0mgNQRv#bv|NZ*a{J)8q=%n_Oh0lEVz7A
zSwzc#AQ~FZ+!@I=Tz955rrlcgw4uNduQ|*j<wB%y=RG%)ZRPT;S-9SvlREiIN{aY(
zoPxDCxn(0DMGW;`Nb=>LTGN%q(&IE%zo{Kc`D?Fq8YlS1Emh}&0If{VE`E8`#~s%^
zCZke19>%b=x)uT6S@v4kvV>4mY2VuPtHq6pX4}R`ZKUcR?!fYm*eVT)>6dZJZOg&i
zO9g8yI|Ufazt(l=<+|lCb<xARrNYGmOmBrpiJdw*x&1d?8{DDyR#d3tlUcm1(++sy
zr$;%hwn7yiYnI?8Sx#Kb$%{H^#9g9}E6yub?mnsKz1J*tNU+6J=BLgfORJ(G0nzA6
zOK7ZPrrZ>^CtN!ux`vi5^(&#u--N8be61%w6Iou2Wm&OuRNgvWxL2GjcD&VAnW)TO
z=C*nVx)a^>gOCwcwrXo6<<!fCCN?0wUBhZ*_z6_{o@t%uOsvzMR_Gztp3l8qfw&Nz
zlO=CsR}(KBmnGot4#Py!lgm$cgtO6z<qs+7!bu6)C|i0{Y0QBg%@H)9rp1xM8z~hu
z5E()?5R{DoZ+Q19qZ?~3VL_)zO`%kJuD8g?Rc%>8+6B1lr75mvXOk(6u72aMM3<?L
zT#oHEZhDlZoQ-K2>6T6s0R~CQwsFPMb|+z+)RY`Ftps#5ps|H1^D<+}eBCkPktve7
z-C66GQp#~2vf9^1x3yL>nyZPAt8Ylu<B^&hF=X?!Q;H+PTsLl&rm0TcVq<dd-0DR$
zX{1{L)+11A;~67{!e-+!O#Fh~EE>K;XvCvA%d3mjdg>D{^y8jc&gzoNvedOVT_iG+
zYtl8+ubL_Xl~?OdnP+_&;?7!WMzmewP{x%3FKlhma*<SkX7IT;A}xh!mo5MWBg=g}
zw04$cnoXL~>keZ`tjxEDX&1T+G^h!zh&BZYgbEZU6@VB`B7-k!3fe-f4cy~1yk{<B
znb(ath^&gwK3&Yay%_c}?2u$gC{<!>AO!;=1wy1iqgIm`0jnYaV<4G9EkQC2LL~`Q
zO67|Jkhu#o!I~2yxxi=<F)1>L2qp#!sG7_q6$?a!#T0|0LMb6s88Q%LrC30(qHm1l
z%Dj%47&|V;fAsaI{C}K|#s2{G?VtRAoaz0U{{S2R0N0WIng0MA{{YvM&HbhS05327
zaX+-b<=_2rTFhsr5x{AT0S)ezRa2xL!uK?-O(3qEb5U`DV$UT4p~QYs2uMgEaIFuC
z+{iETE!c#CzVLJ>$E>J}w7pO$Gb9>#E64XlxU4uq&k@7qdd1mNbyz|G3D|`cjJ|5u
zH7oZ??$vpmd7z#-@g4$B$Hi}X@K1-pfak_mBZrur0k8E9K6B7PusLqD-YUAJtR-~B
zR*-WlKP;2K?a;<``>mgrYtrw2i<P$<eK***T}v&rcm?2IRr)+4khbuZVnIm66nG~N
z<Js0Sx{-Qosf6;&FTpzQdTk0%c7%{BO;hTj+ds}FYQ)wwuez!!qMjiC02wb>Udua^
zzQ3up#jYc1Zr#9bOt0P^O)95Ss^{$E(i@f*v>xqKTn>^31gs266+PkMC7bAJW?wc|
zZ*x=ZThjjkBQ~xv+?NJTw4hRuDi+&g4>WnMwDE+03Le7G;_}p_Q8-#tDXB|1wyKp=
zGri?%-(4-5!cU1eug%+k-bJgRH_Iay7Z$4FHCv6GUE#jx+Z(rz*GxAzPN@Yg_ljtx
z^PN$uP)6dp10<%pZE~G=_K|nI^&$Ity3yq<mKajgb6<oO@2R{y<WA5OY`VcX%Gyd+
z$SwxiQ?>Ls3GXhuj<U^LB6Rrv%w5g(oo{Bk_37)@ofa+Kd3M$B^1_mzkz$`GN*v4!
z*DeJ$RHPIrq>Zq+u~I^~qNizfHkS4Mc8pt;lC?1C@~+-rrpvW@>O-U5tlc-Sr21Su
zyeVZPs@IVmXEpY(tlQjn(^W!o7FBYdco`Q|fG7u%ob#WXOLuK_#{Nn1X8v4cb2`=P
z^&5+wM(W@#)f3GIqr81AvOb~)S!5v8kA866yoxe{8)c;b0I08(vDE!#OOH)N-lAoG
zCZ)Z57&N<!h2fzAW{5}`{{UW-uhP37`&Q0s7fAudBB27G3cDtp4LI<cx{O@6(VTZ{
zt~kk6Hd=AAN_mK))SP&FCY$-0VXYy%3KG0Pv?{vP&<{}d##wDK{M5rA9<5vBH%)IJ
zL#?4EfwbfhoP~JQ%B9^oa^b=#n&n-o^^Ca6+>%7f$19b}mw2^YC^pJyk;i}$!%ZbD
zR=J$XrvCun7|nM}dYRjm)N33}(P%=7Dga2Tsk!qq$B@PXp<hi3j$VFp+?clQoN%tP
zNfoPXl+{~s5m&EJVHtn=NAWXzFvZWuqVi?ap^d@J=l$Q`AxOnq{U63_73}AlUZ8<q
z@z`zrV$>`9rAA~@Ge3}$gq5y<R-M%NsLCPUkEhy)lvJ-vef4<s`{RcYn>$psilu$!
z({&%JJOr8Lr1`R5JY{ZA3_!emI<P)KY3KdX7z(pc%;X0_(0HCPj8xAp^z=@>%4tIt
zR5)Zf0oTu@A9=!3I_7-1`3@3#FJ)%4uJegGhSGoTJv`!6Q;;5nZQ_2hmmGEYsg_&(
z66&xN%;rz^1Nh7vanql5JWN!#Nj@tuxqbnxDaBDa(|(a|JcfIXjOE_Dq{iO0HFCO*
zWt79DMH0ZzH5ejFj%PC+a{L#vbi#ev>rm+?mCm`Dj%$_?GQE1G?t_+nW*Pl30caJA
zWinE=Cd^XGK{PRFO&m^Jllek=EQ{)qQqqS2qZS1lbIv_Q^gSqT5(uYRER4ibrajjl
z>x~%+b>xcenf7p-MypPyfO(yPJ6Fnb<T)L<*N?K!)hc5D0GcW&x+|^~0Z(jjj96;0
zhgXHHDjRZ+OH%wogy)fyt}=efjjpe=R|~U2c#`T{ZEh4Va=p@0Jihqfv%r)BRH~?Q
zl6NI(JAuGSJ|t@{x`}G`{g&<1W2&_JUPa1M)9M@ZXcP*E0-E7IQs++7*ww5S%d9q(
zmeKfh!I}Usq;Hb9G~Q>M56d!+vl*1t{{Vl%*V=P_Y`E;!yFA`^k13S5rRr;?{B*6(
zD^*8@G7uU=j#@tbi`hGF;ca!}Lz29dGZV<xc-%6v^tYxs^PIeMC7H<}kzN##+JP#<
zYhJx(M$bexNT{Vw)ae(3uL@LmMS2-eRcFzVq7&l?mcPHoMbll`**pz=q=cH9s)<hC
z5-ywCZ{ZRErqLkPW4%B)e)%=f^*7aZs4z__Pi)wZNvOwPW*KyCB}qMf1Q?S}69blJ
zrcm4xqCvz?QCLzy>%MWN^g3A1?$O;l<>AI`ifRQ^e&~R8-`F*r`^v*jhY2pzWeUN5
z>-ZS`n0;eUWKAf6O{7#`R5&UQQ6mt<39m^h=tAh8@<-$%fXh703WN|ys<(s;IO39&
zj73BQfy9{>V{)=8Wt_%adPpvpr#Y%!rJ!h#F*v>mK-~LwmsXm0^2;7uY999W2~|J|
z@ZV(aMAr`$=Fd-04;13VUbnlSx%U|RZY!1V+E0ymeb2bQ<CA*)nD$Ne)w?!<rqb`b
zprxONgNenTOKlTO)O}}wfkKgR@?I`FQqCrtTb;xy&-GsjJ{{DVtNCQcdUijT!HMOT
zS3Ixgy;og3b-&369iwV>*6K=<0}arqxxuh_gpAg9td_2tS{=N33uz3ce74t;i+f_G
z^?6wdHLvhp`rgaGE|dDFjh~i!_aKJ?dx%<{xLp+CJ=6d*&tjAfsm3Y$o>O-3T>J&N
zfRtK}^%S#IG>|ycytPMF-R^YzY9=`D**!bZ*UK)qr?iY|N_o$y`e+VS@lni<l3Qfk
zrN<mKb<$mYictwbqElMzNy8^e(CyUg*DL!M^K|s|A#RuNxmdzO$SJpMdew*V7vPkP
zl1wG4Tx|m3*3s_|rD3E2_-${5pO=D(j`!fJH8K8amtK<eozNX&EQ?!FM%g%2M-q1@
zs>$5+h)HFzl%Yo$sUftI5nR-wc-LX&CD&tSuJ?UcxQewaQ*M)l*OnG~Zb1IK%<GAK
zp~6&_*%<?u{AD}Vxd_+#o2lhH9y%$$>ifjF0U;b0L6_&m#UQfU`Hn7}??Y6o-Jltt
zsyNDT_3%5xT{S%l4IpHsxRFA%s8j_n%Y3A|wJ8asryA9h*$~$RkUru(Aoc$M1Gyyq
ziRI%<bW6|U9{?pK7?q2@rPh=KgmY%Kspr=6l%+Dt7*%p%(@KS-%=)}ybgPc{zvyqJ
z>nFvWvFRlE?L3Co{o07-yhC>0^w|Z#DNr!{wAwDKX@#xSwaw+1TnNbp!|4_J$rOz$
z`b3(!YtV~_8DX<>prvxzOF-=6!j2MYz}BV-)pJ*6Y^C9P<snK6O+u26^2b3+$P>!+
z{nxjZ5l;T!Y}#K#U?FKX$`xJE83iF-Q%vJzJjE`q+<vVv>z(r1$8Cosw$b7V%=yZn
zAJ)_UxAE`rYR{J)GE&)XAltl@KYF#Tr@<vI1Cs0Vr-+JBalEmu#kXpdo?#dWUS;K)
z&?<*%E|&HEb~^98x{1^K!FB8b%xPb986YSga#o{Nj)?~`5a2lRCzM%j32YkopJZmG
zSL%bboBezb*Y4Jn`TqbTcOPH86a{kC-b$Ch48c7DG6$@bCALS$%{jcP3`$lk!gAnt
zneMaV-=jUw*!fVW0`QJtK@?vrfLD;%L|K)(r(Jf8lZ2C(!E7Gt4~Y>X#I(MU>eUKu
zOtu%Zic5{8Vh^Q5B-iys+>|;?Nm)uBWCRwC7PO%_gNZ*XxDa=V+`GT7$$eII>wY8L
zC^A&{yE^jdEtJ}7DAj3?J^aLm65@GETAmA0q7vZ+P7TtPP@Fh8%YT_BqGQ%;wz{p=
z^eEdLSW9?=O@PaRTb?Kb!(-tJ!%ZU6iAhMznyRWw)N?iPg^4djxAP%ns4OKa3n~er
zIaK9e(GfRJAqiJ7RVSF7N%;|k)obVpi_#m1snpf*hhJu`tC+=ZT5EculyZb*R<V*n
z>jSC>9zxhsTtZw^0f5S=<5(!AV^;vGZ8QG>gC)PsaaZaZfwi-`ao1XOvWKp4pm&){
z^KA<}N_fh@v<+DnS~b_~>BVrc$U<_$qChyv&0T3To?89-ek}4{->t4V&i$IkD0I$U
z<<Gs{dJ&4@c~+|2B|bh8&t+Odz0K>E)|TIMlWM|Kh^1jC<2}(mL72vFwZ}U3?pxAm
z%YW-#16B{a%6vMzZ9UsU9TdZHa-|VarTl>-jB*1_zi>)iStTh_lz(SP8zrRe-aE}q
zZ{hZ9_4iHsdhI<So$Hq^;kV_tZpHu`<(kxdqpeTOVxL(qI_u;muqw4AV&#p35;&C}
zl2i5goeA&`&de#r1C=RMk65l`r}c8q6n9pFk;^^g;;j^x$j={%5sc~-LyvpHu%?6*
zmeSeuf}Ht|AFGz!Vi|3+rE>8&3RG!I6;ow?i2LA8X|Kd<r$1+5YWShm^3KUp@Q+dG
zg#55h;6qh+zUzufOI69Vr*$fu1H?<{o{UcIdi{)bCsTkYG$y=vFn4bAR&k78TX_%T
z6*ts{`vlM8q+#Bmp8^QW*$-yfTZsCpB1W{bvhdA**$nHNn{DF2o40_)zGpdQ+s1w0
zwYtJ^gnrSAgY}2+ov`_0aeT4o<oWAd-#W{%J)v_=LK`X|B+8uxfJS_0m)-GxdtH6R
z-FkheC*+aO+Pz^Ny->ACNhH#8Ht!)Ur@cIyvAd5~s+;J)yzPDK^`WP>bL+fpaje9~
zx=coHNAK$Qulk%asm(&0Ow1e9TUpuTj;(&BAEs8W^=jiYBV88M>UiVGM;TbRR=%=m
z@`0;Y+IF@XPyp>HTW#{Hrm@*F&K=fale)C+B2<tHrzdKQ)b*N~Ib7Mex=c3gu6492
zgF`u#s_v8^&euMU7nRCl?Kpw$CD6D^;BT#+P$fXka%C%)T$`s1yLIEkN;gtyA#Txy
zRHWV&Fs5tC4Y<V#)>OsED7hp_11X`HLKiclLab0+R7-{uB`Lea!nA<1I%77xQ*L?G
z<>?91SyHdsDj5SG+1v8g7tqHhH^RHlFDz3F`QwIMzBxTZuvZMXYKoDN6O__BM6Err
z5~<_h%Hdt_w6gSixunWCf1AfoT5C~Yrj--S{{a3V^0y{+<K~)U9t`6d;i_fLjju+z
zxMf=^dC2=nPZb%`=NP<PjQG`@xV;YD_FDO;pC|1ZqJ4CmnaJmO`40-z<iY8J^^;EU
zo_5dL11kRjQ}3NVq;c@%PYT!6#pvGf+P+~pHhXz)f7ScvZ>bzLob+SHx_M&nlHz`_
zoLfD)wm<6+rg}W1&*hV!jda|0xQAKEBewSc0QkxJXQy%J^U2GruSZ>3%cHh-=lx{;
zB6>FS{YvEPsOm9JaUHF<SNf^?MD$0W>sKdF7ek6sqqPhl^#{{EFF)7&xjOhSaY}S{
zjg#|_rg~m^&gALgJ_~ZH30gJw2=x!9dK_oCb9B6MVT{HjS+_qhot&pUb8qRNgBhn*
zVDS^HpVy2v^v?>1NZ0v`2Z;J-Mn1G<uLGK=>WJK5G1N`zpQ{;bz<M@!NP-tktL76-
z`NmhqiOXc}fd$WMzM(FXXAyj8-s^0yltd=susuRu9#IWajg7haMBL<`m`0(vE{Il}
zYJO1(j8k~=hS79vbbDnVNRBZOB-CAjva~xhxJ=g%xm=8%F=8bReVw#k$w`hapH!YP
zdM{EawXV-H$_WVqKJ5d<wy!Ciu*cxJEToPW?2AX#loAhwPNALKg!P<qo;1t5r0WcO
z248hmsWS>lD8Q)hWMfF<BGsE9iOL062~35n2@aB=C3DxR;AE+4#gS+pK-`H?E|(@o
zO=6g>{pB^vRyA~`5jo{q&bJ!EF72N<hH<ru>q^OTV`iJu_R-^(a2Bo%r(AMp8s}qH
zE!cXovo38qO3bY3OV=I!l=&FfTzB?Wc^T6h&NZ7ByqmWQ#jBre7i?9FRadrqeZR<i
zZ{fT?@A!wi{vxVG=#DCx5Cfp>3I719dqhuR5B*QtCl7bp9`Cciv-y+Se9vvrkL*bD
z5PAx~Vn>jiVIHAm3`kUh=z;?h6(OaD%dAEy0J5x%8rMK!bg1Nee&sD*@-QE03;mhz
zBQ75_Tqov<o&2?)OZjWY?@#S-{+gs+n%uqmYM#tKSYz_Xhd-YFDWA<lGAdvLy%bka
zXU=UC{7H{Fk8^d$Q{4Xm3c7n~zF2#2;>WOdF*IQwQC*Gxj*ltxGwYgV{72No<c2>a
zUb&P@rjxD)3}l(1CpeTG=Uhx!$uc-hN={RxBQ&BNqH8q>%}ZFAl4T+Uxgm1FD${pn
zc4`rdWMSGL{-4$V0P_3K?2O%^{{R5hzw-OP?3FY|aw^l`RyTZmC4Bc@Tpo9m>E!IN
zH{kB_%wa=2-h3W+DaBn*)p*%Etj54j_n#LBKcwhCy`$=%X@S8y-e)#Gn`8Uu>ImGV
zfi-z+HJQg6D(6&FX`(<L$kO4pEYgveHcVNzd}5m3>vuIFC+LN5NaiaNhtnBzXYo84
z)c7>0xxUmK85K*{bcWK=IA(7rCG~3H%T6y)w!OQqCChC>*Ociy0m5<4XMI||D<$sb
z-Oz3nPE)60rk(<ntmomAwlY-HbE}qCk8;v8Ozgjthnqdx&RVYC8%Z?Nfw*N&FEB*t
zwXF!Iv`ph0%O0pGnpnd~;foX@MJpN1u7CuBrzkkX@&&u;JEmoI)HKMnQv0B9E;NQ3
zecJCct+$3fMK#fM6(#zqB<DK28%C1mDr_T<jn^D>#yItE9cdN_w`?g{P(fenL6l)e
zKnbidOO~Oc)q}dLO$rKSIXkUJ;nk3u%{kod61r2aq@Pfn?V>K7AmKB1v8<}3mDO8n
z1=>b>TUP)8q|L;VsxI1AF%xWpk(|*KSL<!n3WU~(!mlZu*CZ=|*PFv|eXzZuBc1It
z&B@&4?zot#a1!jwa{}u#2+*~&LQ;SuRxheIn`dYoUYsEK#<zDI!UssnoUc(1Y@R|5
zPG?~mFkD-qDX#Naq^dd_5}TDIQ!X&t6{!gZlcegHB_=kNduA301B88eoGqGf)-uOy
zl@`J~J7^nP0QSe7pFrjbc&An2LDuO=!pQQ4u}v8hwCo@}no9s_phZn`iE!aTFd<bM
z<GCsWS5O40XKd*vT?~?nH!QiY)QD7FCC3RJXFHFTUoDufBiUG`x~Rx<<wYrNIdzg_
zA(mU{(GG!a1B41&Qqk6L9W#n#RGX`QWeSA`@vHh<iX_m1x$&0eHkS)g7WTIcx|$>b
z(pFo#yFw{ky3J!{W`0#g*YcFSD^1|^?M>$?S-%owXx%lw?8seC8qSS^myzBAOUEl)
zHC8y(XvWpgMpfxL`;9%9LGFsqKTczlt(!$wX<)VzDIT?F%Hbqg7if0b1p-0_6w*-G
zRMmhQVIqP=!bJp$qyV8HOSDs}W~=~(?K1X|s|arI8J*)fa~!U`XBbi^pDyN3`1UaD
zn#hn*G9Uu0BC;qISenS7RbpgQVo8x%6dJM#fJP=HnLs6S6lH`;P}d=5SVSo@B?K)p
z695PdfdCc^NHI_ZM1&X=gQ7wVl&TDq5|brL)JPTaiN7-(ha-3xyH3S_^yQ!Yf1HlQ
z8uo6_{y)xi{>=XXjeqyaKeGP-<6r&qdH(>kzvW;3aX+-b<zM}ATgaZMI0U?`C_XTE
zD&f)~xJ}l$=BCZxB!CAU&x9MwIL~^C*a5{}GE(ntW8Gm3^ag>#Nz1Mfb20(~RJE&$
zKo$8D#BapK_!?Q?X}*#|iJ=NSBoj(26-Ucn9&iCm@S);7CNvc8S1>Z){{To59}v{6
z028x^Iu7=ER1N?{KY-l~$XXDt?J_mmrnC}XhF#W8@9enlVffYrw))FN(Ev0Op_0ui
zR1{#HsyPK~QkAw7LKdUyGzW%KZ&fU&w~Uw9t6155x)kbMEQB(owxt@Vl#&*W+!WwV
zX%y#lAP_sL^%L`OC%}qJdudW@%Xjuk)FS9pww$Kb%EIXj88*;PK`IA{;S!)2H;+2H
zCkt3mXb{~p$OF2L(>KuTCEx7UGv?oa=AG^`e&VGmUo0&tQTb9qqHCTnZ;Xn%9ZD!L
z^6@RojCjcO1lMY2Os4PbUYj~=e!J{N(vq5Yaipt~z6oSK>U4Fc!=#m@C=_>c?s#Fu
zXp^4)Gc{_-Z}TCQ(ilaxwWe57u%suvQ_Ev5>GRVV@iBKOKJeOFRl-VKORqP{C7xaY
z0(pld&~O#0nai{+Tz+h+E~Ve?@in<p9KH>yuXsx#2o)*=-W=~Z<{&AB1m>-TDYaKI
zv@+rw1uUSI(3G@N6k2yWhaRm7q?Ye5<ZG|<{{UvD<{yfAbloB6(S=PiryWX00<b%b
zwg+|E?n<~CXD0DaH_3gJw93O|IN8Ed;!-GvGC7up)sJ7l^ZOU|_WP{frL4}~cKQDR
z?P0<@X{cEtu3DLVq?#O0Ek?N2m3YTrZfyIXZk)PoWcy6Im7kcUAQf+&4)SBJw4H5h
zlJ$w7O;S4@q9W%~Q<t6VeJ!-52%({QLZwG6%1pTXJbKlwAr9YAd+RT}UZ7A5HLfZi
zn{=7WFYiqI*0}Mu{ta=<<G6LLUE5h;DhmdRZDcBdwBl-)6<P}CIWFDnt*xf4E!L+L
z3Ff+TI4hHT{G%$#z0cS5Yl|McT`|v}O-|~~S5*FOa8isxhVt)js&(*<^j$XhQn*E{
zLnRuh@JRWTqtHu^J~Mu;T_$<?-Fz6E658FzkmAscO}9d>7`!~ZC8Mk}rgLqIfWWT`
zWx3xv$!@)Rv3Hek9Cz9}W2|unq>_=A5kZu0Zv{!N6c41z)WtQXa?kn+dhJC40SWpE
z{sJ~qjp~9xqknq8fQ)BWr{(-i@?zVa`x=y~`m7QFIc2}=dGwE-Y$YMKz{Gxm<1FZ#
zX748T=@rg4HrwlX4xh#n?MP%{6wB0qaPczsB-<J@%3@~m3CM1K;R~nOs{Qh{<k&g*
z_<0U8!z<$%%E{2f8=c+kHkodQk?&59>P1pI`1zg?_lgU`%R{)H19hE&r;o}bJLt^#
zwZ)J9t5?!PWvsg4TEVKb1L`NI(YzsNmK0WNOx!*rWRET~_7e3kU>`V01Jteq<xlZ3
z2urUhtbi(OQ^0kWbvj0J=#pB3lA>F0Kd!DGUQmg-X4AUT1FQPV^ryz0W&70C%emI{
zhn6^Y>q<?Xy}NwJmE=144bPs@vyV9Ec}Ei0T+YCFbc>bCvg$13#|gZdw<?G3RN}Cs
zx}F1%wjd^jM~EMJi8b9!v)^ur9ujjqlN55wHXu(DW>!L-U<yw8@i9OFDOp%Ztz@Ka
z2%23SFa}?IRjoOqyHJA_D_F(ErxH-(eKCE+OtIZ>^uYVfdIxF=hvB&tgw?lz;ZghK
zD_ZDd)==%z3w7~}X*6lE)YdZYl)^4O7P?Klg$2QwNzC-|q%DGZY^7BodQCPzs(fcY
zN}2a|<DDAg?H9KA0xcKGDK50O*0cC)=s@F0T{Xuqba23JD^;q?iBQSR8{rA@;WKHz
zi>{@b%WDqKg!{;~Qt-Nzg$|^S2<lbFX4zf4+HKQq_ls)!5Tk`#)}xG`t5<yzdb<rG
z=nhTtORHN<`>O5j^HOlEm0|{i3ag(H1=;7Vkm6ZMA<Lw#*0S#R$HWD7p;76=Ya7~}
zdY#$J9{Boq+VbyP^oM<~vTYYO+SR3SIYw@V5;CnDSp*HeHRvlXc`aS8;fEc4)eA&2
zkn=;`oncueZK))Jw#G-qOna_9$()~yt)5cL>g)ZV&8v9r{2qCg!sC?b*MD_gwG_%#
z2WO8@ymL;tS{++7qR@MeAd00)@TBqUqgmnf^SIa2-&Q#JCode%boie(Go>=&UNU`K
z8hFVD?_w3*3Z`_VK~lO>o1fnuHk&;aE&)u1c$ol<&0^>=+3+I{6?kxxg$2iC?$o=9
z*i_;9Ym28?pb!&?W=6tZi_q)q*`B-A?8zHZC#kF=6IH62jq3zdy3|QlAxcF07IUq5
zbeFnzO)q&00U<R9_{5_z<u7E3t7_CQZL6Gu-45mrbtgsg=*l@{Cc>;)^pz4$ruq{~
z`JOUVLED6S1tcV+4F~?QcC0S;=?x6)n*RVnIi5UrhPZg|CnTPR*!LWhhl=I>7CoM|
zO4siWZZc^*RQ$>n=p*E#-P=-}I8ux$*aV@ovuMvXD1Zv5Uunhv0DJp8N#oJy{?O*S
z`gr>Hd2-9n{ylaL$Vh$1`JWYFFcscC#T@V^nVzIbV%q8DB)Iy}wLOjHd?4Mmx<_?{
z_wvWOj`Gx>uKxhlXK6H<Wv%LZbo<|kcH!HeYA~&!+Qqn2qPV~ql(f?!=Ntk{Z(IhK
z$!{Ma9ng}I#P_pO)k=5>oqGQOCF;3;TRm@fdUT$?v^G$i$3w3+;u>J$OH0j121ruq
z4MLUaM*L)3J8^AdRHC1Fd03NLVdtyRJzkd4xRbx@qV|nn%Z|I->XuBh`$Swj&%Y{l
zg}3ejD&{LSzWv5XX|M)E4(D+Ix7BXJ4XrD6_jyQt!U<i%zZvQRP85#oU<{*ssk%&j
zan}3)044F4_WnaD)^9J9Y?nq0G7Z~EsVcZwsv2>0rUZ=X)@O0rshf7v$w)<ATF61g
z{{V_esan)>6_<OzWbN5C<B!LEmVRlw`z3cSIJLXUTR3qxj%TUG51N9sZ>4vn0-I4l
zE^~Y8P^yR+x@B5`BHjMI1eoil*P%?6G(jm^@hAmh6!@ylW=Eh75lTagZG%!newq*x
zRn=MX9+4ftUWZckPMu+IrNyBlfl4lrayirMWwLm1idt0ZbSSt`w50$vKqx;`%$&)K
z6qatCA-ThGRkT)IIGIUONLO&?QJ0SK+YKx{>Jn6;%K?6#Y8<67H=aNzGuAXo=`_8Q
zb5hW35c*ekr$B9ifi`PVuQAe`$xSPgxJM~zy0c>9g4C3U$BIy+O#ZmzEQhLPcXj=L
z1JdO^dJ5Tfn^wKyO`&NY8A|T9R->>UKb+4fJmOn*DOw(>DNq$k#$jYvU^+@(>E7KE
zeqMz<yiTEv)67{?>zxpQC~_Y(YjWeuYVmC1D^inc!-xr4PuEzYvra1cMY}>ymbEq0
z?beRk`Jc3esVGN14JB#smn-V81QYj230mE1yvj7%t-)0S6zLROsuj#-myEx2ukGEN
z{{Z9tORwAp)Lupx18z7Fkm_lI)#W*vD6gvk;~Qd2jl8<J^DA*EWd?{A%rit3ikz0>
zfg-t(WbZ#)POIAVS<=tLsMk1F$zZ8Yq}9bPv`Ip8OKMj|4iPW4-=oK6seH6hG^Gzp
zj((I3i0UIQ+Ar(kPW#a*yV!#1PlhN1Kv5)|$^rVR*ma6SV(Q?PD2ydVKUEp`oTYQG
z2{-=$l<vBPx`;w>rOZV&Y$R5-#0c09ICw(aCXFPv*vk?c9;KeERerY#VLG1#y~Je{
zb+lC&iRR%^t}%-)W?O-<iCPc_93fPBA(Ymg`qVh%gJ!|V*C|iBTD^bN=G7^63oRu~
zA!`MUs<*jYtMw9TLMCZTaix-lGl&Kr4O1snd&^}+ilf8{XJ6Srxi_x;ekAFBKBG3$
z8uy1Vx}vv2i*?K{wD@G~j<HPPP7KMymEq44)P(F5ez4;&Vrxe2)Jw9l3g@2HrokX&
zuQ3NywQk{g0|>`JgNaH(%_;pO&_q>ByLu4mL#lVw&~aE-i1&z2X*~c^s36~LEEFIp
zE0l#5tW_apK%lCIrAZqkZN@=+Y8$4?d8D@b*4vFOYHj<bF=BNN6#$c6f+?LV6MW@c
zxm$P=+o~xpZu8*@B7l8TsszbWuc;?(xh~u~yPZo)v<K!>>!2z$;Au?CMscp8aNXZ&
zoFVerL2lg*ww!NZ2fmb2peQDwl15XXCtQoyF0J9(lcZc}4Jg{xD;Bp37!iZwDW=D%
z(wa~ernEK6W|aD@)Y^kgXGZxsxynd1F0YD+-jd1s{{RJ>OZ~yk#qcCD(v(o2TK7|#
z?@kIZT5XzEu%npesn(HE-u)w8rP@jHO(@Nk7HHW@l%<vRLup9eeO1tPg$PPOX|yL9
z&kbml&=Lxj$I2J7F1C~~+loS~-gQ`Wt~?_(E}c%^P`0e8=NS#4V&<x=s39uCN|vnh
zPt^i6vVOkEWkO}ARO2hQY@sdOD7lZ+wgOE_I{{sjyfw3h#sb@2S}J(D4|Q(1G7AHK
zScwn7wod7L{nhtud!ufpzrtINFPg7Yg#Q4hIwV2sw`IbV8c`!UY_Aa|=w)`Y@BI>V
zR+TuVkVOXpGYzb`F&d=j<w*soa?M*ph*y8OFprcIxr#JPXeglzIM%MXc2AtXfelxW
zeWv$2WvTZRfTG&7HN<JSg!@!NQ`-yf^>Lx4Q|jfk>&5b%e=Cna&U5_geJSPQ0X5z)
zM#G2<x0vSB9_wxUdwVtP^uM=L#iZn|rJj`13n{G(<Cb{J^YUA_qZyTs*h!-l+uSdK
zodalOQzXvUmQPok^EpmB@6kq$DfcOnog+no!85(*aO&msoq8!6&=zS?IwY>&!gajX
zxpiW3$l9Tu1p<{7mpsM<-_)#iW5zY37IcP_PUw%ht#uP#RSiHCSTr~YZfZJ+@<Tx$
z=HEdjPl3cnSD|9aunW5u$~LT8u9L=wbIU4ai+E_qDCad@3DqpAxzLkt=46S}i<VCA
zT~m_{_HS{;uSvT?y)&(H-q}m}XRjV?J})e}Jo#ak-TFBpr`~XAnb)^q(K!J<pH~ly
z$8xVc!!Lurqmcedsy*qpTE2<j*jY3ymz4D7?l|ZDo-Frkl;Y0%Js90boL*>pov<a_
zWu|v}>j)@bAU2-tJ;xqbUQy!Wm&xYOhdDbvIpsWFbki=jd&weM-diOuDw|e)UJRz(
zeXYG8JD(dPuejG!WH>@;5aGhCr_#gaPA`@7c{{bu^9me2V9?;29KpgITw5=s{ShEW
zp}WW^-YV_H1f0fjR&Lgtm5z`qT}%nEbgrZXgC|ZXFQ*imiw)9uId0DBX~dfSGWSbE
zCvcJ}n956xRo+b~RMqM>$MnvKHE6Xfx}1s1X7S_jX`d{<Eosda-=Na2kEV3O#>s60
zQY&1hK9)ZS=$}(Ris{UYtwAQ3-3Qw`Q>9s}<(%&Z7tzy1<;&ulbE(wzHva(BbMKuJ
zw0l#-@|=Imar_;0*VfK6r5ZK;O&{v3@0SbFTB%4Wr|8Z%+TiTe=gFNbQQDnJKkA>R
zSpNX+=9YyKf}nJqFSW(rP5%IxtQn`aT9STpeXv)WA;t<Q2M{Np{IA{UbpHS`_HwZ4
zzTDrAC+UG_vt`6$39q(!ueHAyr%uzJddD3fH{08xzA0M1&pL$~W2Ex`0G7|<^=aGd
z;^C#se`qd`Rw+hw7sg<!c`pYn?Dc8roY*)zM*h(U5@#^(iuf5Q*UEWsA2jrO^z?c0
z{9bojkF-{}u5nA#Zh#=tc>e(VPfGRp{hp2S-&db*<v(bwAN4-@!F!F+;rGucpDgsR
zSB&^QI>X}gZoLh@->_-%e);E1V&#!l1p(k^m(P>oUazN*!RgiyKb}$P%=YTtU+Ryh
zd3U`ypY;?yv&;3epBJa-;e8&D81wyHzAsyAwzlW}QS{Fy8kNF!c~gYvuHWVO{tn(Q
zKUXKOqqa8x0QjTno<yBq@NDt>=NZoJ{#yrc2QRCW*B9DrcMU_S`e&1)SkyQ=PqfZ+
zoxk$fx_CMLY@WK;X_!yWpQd>-b?r$%Ir?UQ%rE(9=`dn**Qe^b`wk%Yfy=D(HFk#m
zVv8nEtG1`NlDFfgFEalCP}CVOtx3+anmU84IqqgJTIqQ89c9#UoR+Q})Q?!g)w1yw
zHJr4$-8*k*9NFS;l(Ruo32$f<!ec9@a;@VxTEb|wV{k_;wgi_ZT9}&&HidE8C?)bk
z#X%NGLMlaJ-B1mfwJandlIVqsWdU^gO6M*{v&GW`3#GM!>qys5y>BVXF0|b?zPDb{
zvlp#UXEg}T7R@^uwRYFmnu!vWO>y7ZPn2b@-8b&Xy~1w}=O1=ymuH&xuf3_O+XdQH
z*HKX(Gu`dKhI@bEyguvrl|9$-3@IYBW11#t6kYZp(^B?`j>ej5Bg{@d@3Q-z&fe4J
zPiyl%t3Y%1B>4#2Kz5c%@)OS%N3Axw4o2yAMbf0FA;AI6nO!Nfj%07mlS`%A45j2?
z6z)b1bv8LKv;}_5_mP6_^6PHzk($Hii-hYL<oRl6^4F2wXK?T7nXbR2JNjmNvH4+-
zXNxbIu3t3@NtF;g(SO8P{V0twz|G@J=x0B3{5rhz%L?i3{{V{<g81@E_CCfRfS)MG
zu{ZddMtmpB%7654lMQD2nEa8BJok&Kbx><qB5MN!G|4DA#31K7;$X%`M<`ZNC^Mun
zV$`BmCbFstCM3e3g_#P7u_-}t$Z}j)7II2q+7Iv@SbzHk-}XjFXg|QUU-B1U*%?Hs
zk=6)Mfjenj&4v*S5+u@y8c_-<CY5%ChT$<JNu^z(1**mK6B+=3!eaTUjRB@g2T2^@
zBS2`SwibdSdFksWmtm@+*7U`z9uRoTdxbXO*iKxWb-Pl{wWkK^uk`oMM5eQ()ikue
zlZ7DpPdv`yTja-VO~$S!nl7=-pi%Z1(KaqxE}#)Lk0+FJ$IBW^vP~ZAt~R7rf-%(A
z@n>VS>y>9MsH#|P$4MDR_|Gtnjb!ynQYjjMEt-tPBkVY)Ng^qCp-($F{Zt^kID^as
z#&3>9;_8r{9g9@=YK_Q=v_~<pka82RO(v}uW{<F3uNi91idLbNm#b5b)Y0V?_BtX}
z-co91`&Qw!fCSDs$4{ndJfWqwnA=qDi2IbIGbC^6)|vAm0k+0M5HPNjEqyxEK5&xp
zi}z)8nQ!UVnDbR@E~upWLu)pqAmzex&h%?OI@M>%!Ry4S)8`A?6b9F~6FiyTtILk7
zP{Qp(@KtFF5zSc=Lm0H7HWr>S>Mc@5Bx^`$*(FO@NZiW}8&3}1lA(|^6CO6#UL0ki
zPqZx;nT16&uF$mR0u$XEMm#S@IGaGU{Wq50)XH5t(`_=U3QkjsNb7qwD=u$XJfwt<
zvNfU$!@$o!B-Wec?$yhqC!Lx}DyfR>;=rW5F?jOmMb}4NXh3L2t=)vA3eJrAC0#5l
zSkb${e5FW*hh;$`rdHnSiAXuhmVwRP*a;vSPG4B<8d*sJS)8TxV?Jq&N@(v<bKVwG
z4SM)ac<YY(Q&lNj(rWdtUs)+ut+i~$X}?&)*>1hwS-?7Roh~v)W?SyKq*~frq1EM_
zjXl~Z1jmUp-E5tgmKtM33d3p3$W7yl;+1Ht(wR`&ItE^YBC-7ir32j(&P$Hk1x3D>
z?&_ct+X_z!nTtrFTQ*W5w%R}=83qAKHJHGIO#n2|14)1yXh2AqK%zv#04iYsAzMjT
zrb<$GQ&+gm_ZiEVvhwzI<2b>rf@hyD=3U*f>|@zAiLA=BcPd3>0X30W0X30W0X3Si
z0}~<v7?}nXq6vv6078sPrG!clvmsK#Ad1Z>lqoYNC<TKe04lLC0EsdZWTJzl#GuG1
zGF1``l<Kg6YAdJF2dS=tV>QXFQahf(s~2W0kNcnVM17ts7iBDui-Z3Fx@-F~YujJ_
z@;|e0{{RfX{{SXVKiWU?ul~57+CTDt{TQy)aDrfNoC!`E(z%)GgNC<S<DGUB%dJlP
znttdv6nSKzVmu?zy_=I-gzwZpSWQ6{?|B{*dUIC+pPBZ|_f_pe7JKP#qN?u!T)Vt0
zAxT1x9284qyPtVP=1-KCo$AipI?rC^sZ`3Daq;j@TqF#|3cH_J{{YG}-daS3{`9Dt
z3IeM1IeSToO4Ol=RNUpT2_D_yHlC|yy9VMAgb+;-;?swGMMH&YT;UX)NXcm@4|ctL
zDsm%<izF#6y}b$3&@iVI_c37wHTYp5;%g2{#g`Kjuu|fSZI!#rO#oI9p~TXsj~+65
zm3m33`~B8Voo=9Qp$uchR=i4Et`$_{2Qh?GWb7n5;$3_+F(u;HH!waL4&hnTdeB7a
ze(8Jm{7byMeg-`;`)@?PqNFXifN(DZh#8DkCktmP<-KB7<7)-->uE_m(xoLpqm|u4
zeWXSBQD&!E>Co+Ut)+d%y!cRCp&WoYfP6*f5=R99Ko9{aLyP7#l8008Pdi-GbeaL(
zuEbD@K0SZfpAMw-n(5tc?A-h{_BglZp|IPObC#4PYA0oGx|#u0)<c0<z$!R-j@7Y-
zkGP})Yu>I(*hJi&N|wuddioRfeg!zCEw;WQ!jp-`BxW2b9oEU|OyU{uFp{tka3DMN
zPjFWS4@|tocOkB|a_`XGG~J_@&$y(v7t47{E@E-e!%0e9!%VTP8pPb9-K=YIY^tG1
zBMOwIt!pK==qo@Ja}p(!?swGE%Wt8(=~9rk(o}~|H`J`ud4;@cPHCXSu!^~9X!t60
zDb!jz<H$huxa*3-aS}M3g?5tOpBT1$KdVz+KcZuOeKzwCw>=m6wu51<+cN4+slf7F
zO&mimZHNKr2V*@CRMD*UbiJnCv+yr1xlTKm#&LUurxskZn5AZS`IlR|{YB1nsk<?^
z`<@lp-qRya({A+p(n=78J#4-ySIpMiD8Tl|ve!M7zq+t|W``DpD}#s!x}a;dH<;wZ
zb~mk7xU<$aUq*cuHx~-kbppJCo^!ehqEl1E@B%u}ZEOOrZm$*HWu+F|{{Y5x<dpA_
z8_Oq-Eaz`&>;1`<ndH29&G}zNwSi88!s?tWAOPSXr9nBG9w=Vq$~{X_xW6H^lZ6SO
zrv#5~Kz;ICZRp-O%zD<QILXz|Jnna)I-aPz%a;vGs-j8jpXCPQ0SqF9cersqRCC%e
z!%&y=E_|E46635wZ<}zsa2x$m4BC){gf=J!=d9OA&wJIGysL9kX!6)0wB$}%DDG5v
zByj!_yZ6a$ASViFG95ao_{HkD<Fg)-GR{td+}ws+Sp))oO5FG)c*X%syKr<H4g<%`
z#G7vZSZ9}vbKTC6mYlqII)sDte-dN*+u1W*v3~ym4!$wd7{^?yYUf=#VH*-{8NiXS
zp##Tc`*`?9?Kqd!iQ-b)PDvT5)BXHq`KtE)b~<5?MDKPxNm^0OSK>HNEPiY91JfGn
zdY>++K^)Zz5;kod5<Fz}(&L8KZ@V0vn&}$$<tiM69^!ux{bSSk#tA14PqW0Blhva<
zy&U#%Tqk01kH5lZm{ODF`N^ej<dYqtw#xAkJx2)r{3Eplp_GJ*5HJJ!%G~<|C#gEM
ztxX%LppZ`l@#{_zOGv0{xe8+N@bfSxkFmOi5-al@U&1NO$v;5w5F*e>G^|s-)C$T@
zwG6sItBGDwXm2k(<x5$;YRF2mPn^s35z{Ck=$E=uGK!@W_eD0bXJKv6AM06}$R?am
z<s}HPMGo*!jwu!I*TBMh9;$N9FssPo9x*ojd{J34GOgj*<Af(Qpm@{onX;1dM;u>t
zdKa>Kljd|5NK)BTNvR4*P#qMV&d~ZXs*nMwrAkI-gCb6OQ;3|iGp_hvh7oVsR3`1a
zn__6;Y&g(KDK6kSqM&f$52j$Xyt7)9UPdQdx@|QNp+nN7gSa&V%4T;xe_a~Ow)DE`
ze(P&g0Q1O6<~G&J5Z3*`>Jp_R)3r$ub}llP$qyull(eZ>RZey?P_v#wlojeD;+>H1
zJ9b-XHww24x5-MkcN+r`1xY4_qfy=QfI?E!%jP=SQn5M930QGKUx-SnM2hTX#?RNG
zuD`F@GM2BF-ED*GTPeVchIwuW5YvXaa}F>RfUe-qfbSZ1cJT8TZ1NObMisJ9>Pnqv
zv;d^5y-%4y=Q?B8{f;}npQ&8(>2GVb<esq|u4Ex+Q*Ec)U8AVCBbV^sw@?H+f{a-r
zxz>{Pn{+4M?cPFJw^|m-#^8A>Z3*?MCWWxGkRuf5?r`#+Qgxl(zHR!udmdYb`gZio
zui;*6m6sbk?`m5ok#N9OYf&rOL%Ig2_L}K95^Bni&eF3%8T8(GyS2@S)6Tx0^;q`&
zvzv}zUsawQNukVEktNiWk`7auU3QTr6ggxfL)D>!YqLTGqzMDPoheyR+1Nzafua4<
z5)TteL3VH`5#a`$MwHLP!fUi;k5;-DfC4_8zkJjwBRNF!x;GLK4Qu^;VpMnx<<OTU
ziKwkNq)uCboFV9am{ior#8V=dM|LSHJ4d=JEvfH&xKHftp7EtZmB0bUpPWf+x3%Nm
zUU#>mT(t9h{%vD;@V}a!Sy?ltGTW}Kw)@2Z_ezw6tL4K@mDJKWcKe@nx{$$aj$R;@
zhul~pw(?bRHY%(%%5~u3`dIH<wYz-3U7UT_xy#&Vai1nT{p*aw#(a0*>=Vi^T`ff_
zs{qzODZg|prX_~K$q7nm5>;IH%0uc-n`+ZdB~IKr?=7%sRO8Ni-Cuw3&@1I8_ICaM
z0AB{DOk#ZZevt;%r;^)FA;mI>aV57FaopT1i`W686Tvl!ym9MxTW-}UTkBsT1xf%S
zqOU%C#}EV3M6;=Gztr8E?Y)0P9c693i&Kfcx^b4);*)Bi7P^!&w}7caKuM}uPJJs7
zQEP6~I&xgV<ET=Q0!oi48o0HnDubAEsXIpZe#hJTn(@Y6P1APUmFz-ZHwD)Z^h1a;
zRoqene-`CRP@qXY(G_%ry0K`=SOI7P@h;-Pi*d6^2_#i#J>>m<EAYqr*X8_uQy!bj
z{=_oaTY~NO!Z40qvJjxOw%-SmK*FWD;9~C6+(Ru}tKbBvQ9%i9v5-OqO;sfCyZe8k
zZ~860JaPTgAC0}qdkIiA38*MZH7W;zQfZlk0J)D6T?!xq+NsR|kxEd|SLusW;rfd^
zehQYt)Bq}9GYJY>hk0W<l&63^E5<76>w9AQxl2zdFv4hYxbutHBm=s5%ln-Yq}}!V
zmW(d6**L;hFr-qBAxSwE0Z~)uv{L~}c%Z4aSV0NzdW+Pm)a?nwKxmO#lfqu{F`NB=
zBiBY<J8sg4Hvx6b0WAeMR@%F(Rd9q50VP0v^Cgx^Z40ZZyDD!JNhxi#G)cy+L}5~n
zM9N98iFLhexpK<=wedqXI73W@IFKI~q=hRON`UStl;%mTQ(dErb*;n#>O*1GE0UVx
zDQTYSK_JwXZ?s9<`_>!pdVC{4Z-;Wz-dnc|ZB43+s8(b)g&y$24HCYR9dL4*O;Uxu
zM$nVq#4A+-LH_{KI(J&Pa!K7MdI@)wg1Wk{ZY4IfpscV~07@2`R|gu+a#FK+gsitz
zvK%cMESB~{0;mWnrXnQ$f4P5KUthq+YEAvy-4SnZVQK=(8G5dk)j*O)GU|@>Qj|zc
z&Nvrv@F)mCQW1$N#mp;6QkI|&L7_n%IveVnw&jw^sj`tpy5J<ODO*gStz=+Y5*D>N
zkO4;)d6*l8w6^bFQ;n?-p-u$0lT`;25Es9ysXoZ~iP}$!{{Z-e`hj#;HuH7HMM_<D
z(r_yf9+Zl01mMBRSU-T4^FEZJw$c<A-Zfo#Nq_N5v-`-0T?ta!7?qV)p_^@r3Z}b~
zPT)bM%pLUnTr^lg7($l4+%+|z=w!7j&xzc2hy`F`Dha`Z!1_rviELp2^Jq%2m4RMi
zuERa4v_e9gIc+rxz^v5R@A^Oq$WYRNlM<|0mK3gI3Qu_gm2E&)wFlEKB$Yk@h(UF=
z;0-v1xq)G7!qaL_MTKRGiaRQ22wG2b-j;@OxoppM5AzO35unDNm8`yy_#LnMB)_-b
zij=yHB~Ayhl_3t(l$&Iw6mYpxaZuKT2v)~1o@NCC329UurjV}hDRe#c*VP}d#e1DS
zI)911b}HWC4q;Mo<_#2pd22$=0+W_x?qn~PlTeV9fN+tJLaRW4k+7^l(Kn)82;?S}
z1qE&-q>`4@(ocO^XG&I`VjNf{^mkq@A*DFmbw_wm;lyYNBYJyc-`B+Gle+v3-+6}~
zw!re<ai>{u3@b_)1-#bb38JwLfglBM5y>w&rmi1x@Kt#322c>)!%9km8w&^0)pz1X
zQd9fCz>@Xp{^xG6(^Gj?_KQ=a0{$xKlZen%&`^3w+L?)0+e^1CwA--7G4~i~gOT}r
zrn`Z^S)8jm)}-pV^>ex^T=$n$`>n3wF1Y6{pi8L6cXi5AxOSvol~#d6czMn#AgF)}
z&2v+Vu4AOk@4x&Q^j}4*yJy8l1BFGk94iFSZH|Cv;wuSetABS(@3K@wpb&xH1v}D*
z(cw21e!pK9Zj8H~+gsvF!-A^i@?26XgqGE@0+}9wM^?!S3JSslg}_ucK&B+|u5_Tv
zBE;HI+p|Itw$PHGh7?+Eq!p|Kg(^`W)JH1rxT}JshDs8pV(z83kO)yZk{4QKO`}>>
z+cldHq#)##a*|Zaa!OW{-=eACB{@(*-Mh*DTml27Ppv69@FfT+Qn{qm;vFDfhkHQ0
zxc7HCrvY&dDWu@ZDN2o0DNj(Os@3mZN)*{Csalj&IP@n!{baov%9>Ma%a<-4G)+L^
z;Sp+nWg7HP6&SQlDaEq{pt(>mpp_GnQjzK>$~&~T#v2MwOG475e7)^~J|~PwurH`@
zG?uKA8&))g1*O6$7mV(iI-||0pwbk66&YK2aG@nRfP-AX;$p?Uh?Aqn{?!9t`?}`<
zSW#uZW-co5@Q!}ilBD*X3Mm5>ng}3M7IUW$%A6PS*B^89uetf7m$6#V;KHhB1!}S#
z_Q}sBolaj>_V&xsIBk{I=~tILwD;qECEnnkE?hC&T$8Kc#g<+y@n!i}DZaSt0F_iu
zbB`9Z>2j&PohMOvb$|wE>Bg7Jq1tsvM_AYqG4$h0<w$q@)m&>D(KA0zHM7X*cr{bh
z#w8+W!K2A4z-ou<O5&NH2DZLPuwJB38C+B6G4$OR$qv`3D!ay5Oy~5S8v2YKokf3I
zGEx=Ra{4pi>(SD3xt%LfS6IbqROR%3&eKkxRnF}9`J;nnsC#8{ip1sgC&AmJr`E1L
zR%2PbPo?(<lBH@?sl)ufKL>qBf2~|)r`H;l#mC}2;=I)ul^Mq#8IPm3oo_9!O?GNG
zh;c-U7~$zx7@XZ=WxEx(NmyM$j-0m(GuOw<BygGO<K^PJ+tHUE)%czqW5Z?RJzrKl
z-gV^qb?W*?eD~AFI#r4Do}W1LeM<89Wc2+LCEPr%^Ntl@v%-43qt7{BTQYiY38y_>
zBa>pjlhL^I{a2e+=)52|cBC4Lh<|Wj)t-&GeP6rG^nD+&t#*m_lT7}YFXhDiv%cIu
zx81|a$9wJm!;aIt!w@}d8yz(LQ#<X$>$rKlUu=HgYaK`ffbo^*O+5_ny5s&~%gQ=`
zmRqB>+jpr>9c3}oh~Q^^*B`Fu=Ntb3Ea(y1<gexebKc;w)^^*M*Nk~azsuK5J5rKs
zi3YppIiGZU#&vW0@twuK-ze*u?K?D3QjwV8XCcUZaWkga`ms7M(#g~vZH2lA3Co1t
zCyAS5>SC1oS-ZO}Zqc^L>L(5^FH$m6zL~jM`jg@()6Lu~R<t2Q7W0Pp>(TQs>6+U!
zD7sB%?$dv3fg-7#Ds@}*eCj@PT^aI=r2Ns{uJXxb0HoG%<667oX7<kGT4#AXRU0=H
zY7zUV9*uqQD0B9irgpVFtFU6;(N6kOM-8VY-)S5{sKh<9T^UsJbQ;CIutJCl6P&!)
z*Ki00S?^OV7Ny7s)B}qHYM9u&h}N(mSznAEH~_q6u^_+;%@a@ej5$`aG%Zlu;m@T+
z66thB#m{HbhOwova?WeM&=oU;5wyBIjVqtjnfG@)xm4{3s$PeemU+pgtdtbGtYbJN
zI5~-#%dwYb$GMMq=yYllE1X7-v6gh6eqQG%cc+W8adup!h~M7YZ*y7Bt&Xy!(b`oQ
zJ*y!*5i?@g)Fq1&@(?pJiTzZnv@<$YP3>!QsU#$TM4(;EjvR@T#M<nWV_x5_OE4UV
z7rBoOo@bql^zAK;O>Les6J}(*Q1UV6r-qN3*H${lskJjdMXx5lt3E3x`#^rNj0K_T
zGxXZ>YwAXPPIXOln#ZazzO<uzOUH%VTzPd)PD!SDap>puH;dOLN5&@kI9?)p_@=Np
z{#TEh`Dad9`KUFKG>oEaBCsg4?A6!1UWIsw%Ed)40u2pkK6$v;CudJ@b(1`QGuHGD
z&?Pph1zaZ)VW{09kwuy2-j_UP-pLaSbo93SK+)nSpC?(pPt7NkPZhF{MozfOxQXYe
z?FHg@&)Y8Ic#<yk^kJ*Cc!}rjcAn&J57QfmjSndF6REI9^Mp@oT;qyXdWS>a++Mcp
zE`**2QEM83y$20*oiNtpINf(=ljW<F+;LYp`R-(WMq9b2RFX#d&t5iZ!g9P>Z_2$F
zhp%NQ2cee7O{dE{xcyJN%<p(~t+zs!>Oie)EiEk)i?*tsGp=`7*B(s&03~t4Ta<U>
z<JNPdx9l4(C6?=5gt6>{Xl=Am4TSP@-R8z!b9%Tj*Boyin6J)B5*$?Nfr~jAB^$&b
z=Q?0u#z~RNPErzQOji~ukd=w7q7@{_CQ>CtD9BNk5h+1(L$g?}EYg^EgZv9s{{SI%
z{gH|73I70~>c8YJzp^rn<Yanoga;vKtn0P<b<anf7~PJrX|q}3CfDgxNppq!+``3u
zB-?X>t3Gg(cwq*bv%t)5y3Pie`hk1dj#H&5{IibhztL@vsB9lmkDJnbCl0Si(RAqL
z^$fANWui2+^qe(bkEI<q9K7nV^C`w#e=cZmN$2pdOyiEXDCOl;r4EzET>FzFr1O0`
z^?2gx=H<0pR?9ofP=*oGdA^1CJvxq`QaP&K(h}&dAG%wm##6vgJoel4dOA1t9QwJ-
z{SYmc3^SsCkhYBgtn=S*(c0wcc^K2nwLLL*w??U^a{IN7pe(9`D$f>tHw>PRY_W95
zJ+X|jQq`t5bI&N<7sVqZl;!mLFQ47h$uwP~V#unQ6)J);xYWtHZ6NHaoG|gJmnY_j
zmZ9SAdp^cCfmzJPot(caX*ts=>Eq&>XOEg|yB>9K8>h6hZkUX0H54|0oI-Y-c*i^L
zF`lgXR{ov%EP@#lsd}<U%qLGAV~zJS;>PQw;;UM+I0;OxU~n_Gq<QbTW2>a%To+p%
zB`@<;D{9WyPe0eS&rZKiEzQDu%8z|;@SW|CJ>|*HM_GgyTYMCp_)5)M;nIWUI`U-m
z=gF0GlDhcEE!uZMb1t#IxJhu<bLYFsoS4C=uD4kZpBb4?ez7YmAGbi7!6#rQw#rpm
z=z^}+o0#uFw*;ndi!D=*CYq7eX-;yP2f}M+f?5;Nj(r&PX5!G-H=hW`*Vt0j)?AKx
zGvd~inytWb=-%-|-WBIF$)4*ucVor1u8Q$OL{5;JB_z$^o|(j$^lC-7zN;4bO559#
ziqOuUeO&UX;L_Lmr~-jfn$1gEs%LC-a>CnO@|s-E^((jDNe$)W9NSr!$RuSt<(=0>
znC;KiY*DwOI`f>@%9eNz0(I8fQch$}bB5)2U8K`BYKGT91Z0X%sk=5?8%$%x9b#xv
zx1doYBRT~HgwOycKAh8ZkcwMfAhP9YEY<3qzMiXByFj)n!$~&V%ZUn8z+yp~84HQ5
z091fr1jvAc6CjuYjL-uKgaDbK2$`!OqfG!LOdte_gaA+z2nA(&W>(TtqQgh{%>Mux
z&zG^w+0%^UHzzp?oH8=*?FiM8GA_uP$dOvwCThT_nG!0YRf&;7HHoYM#z8O$gCLkv
zgs8|=C=jC{%Ls*Oga{OwlPy3lL;#r;fkM+ECO|=x5|b2ARG5^RELyUmuB>~e4_RFh
ze5Nvsmu9w(<Lt%2uE*M%?Bm~ZqffI^^L>i6#tLz|`jcKM#lMt)X8!;OKmP#9k^P^B
zc=6}H*E?e$+C6#k{{Yh!_jeo3J~IgyuRo2#qB16f$_*r%sO?Orq;ke;DN9fSnIs&y
zr?Mf$<0;4xoakbdooddARS?;wO+BRl0O=t_rnMjeRcHNnlh8dvRHao$o~i&ij}m_|
z609z^p8gb?s2|_GVLDTxI#OD2sl`x}fEofQj9*zFTclEQOMT6WsjV=ls2(OE+p^ix
z9qsB}DuYS|kx^Xet~JU+N=_=|aaO(^H~M1sSextiDpsI?JAqYANZ^sNR^4J0prrxn
zNyLhHb>C{qX;w>j*GoDQ;u7iQsHhWxC|XHMlqpg@IRO&$rJGXfoWP-0!m!mvdm{+)
zlhnPET}}7<Rg-z^)42(CN^a%ErnDudu~w@M3ROo9LQ0_BZO0PQOYb%<%6WkyG`S}-
z6`s{OfgYBoyBhr1&HgJao9Vsw`!o3NEK(gp6ORFTDLDcO?xVX?MRBDJht{C`<OHym
zlG6>oqlo~X^3_V@6IxfSUEE~RZs|3Scdu^7GI-Bj_0ue#dU=E5ECN~tW|qJXtmW6c
z?1Fue{s5OklCEMB;zz_%Ts*?18iJ53mxPqE{7KutMVV`TKV-RyYilH-)bn0I4pmL9
z<K4spPHIkh?F29()sPd+aHioZ`IhRA7EpWt04hK<lJ|#ikKCHoUivI^66?xZgMcWs
z*lg4#w#G>!lrAk>k+en2jN1m0O!>iv(9k%G?<|5;YCy__9~kS`W$1M2C*w)Gx>d6I
z)|Tbg%MQL!wW5_;T&+pkn2(%=J~1dI3S?ti6zNb}lG}aIK>Et2TzJHjUmX_w3%%W5
zhP`+DA-k6E5UaMDDDTlIa*0xTODI8AN2Nq$Ak>BfM%`sCyy6n-)7~L1uz08(IF(9~
z)Wy~7`l-`NtB>WYyS?|Fjc!^?FWONz3+1_q4ukNUNpSo{RBpYgNNeX@7!m;qeb-!h
z#DRsDQ&NPHih)4y(o4VBa`s<Jl1={rDDpr505G>JR<~_y$w1}eT2`OLS1?xr8{tVb
z29tmJgtc2et<x_nhu$n%S6nJWf=|sg-1JXPC#%n|QFCCkZtW7J(-sv4Bom(FDvgXD
zs7sftX_XS%TvAX~xfQCMSDDU9th%l`lWTX3XOi5q(G1*VQA#Is)cAQtBHIyHB`Q)<
zH|tH+{363<IYsgKClZJ*D<tecx;D6VK<}3UCY#1C_UD#bDa(}%hE;)W3vpF3jw{)6
z&a<m&X$x@Ea(@2+IAnyh4Lzr<c8u=Rt!hmQ$wjkOQQLFHMl@ThaOcBe`{Mp;vT1RX
z7|pv8*H-$$R_D?<Aa#NZ!Q!J5X;$5{v2JcdDM}mlQ!;pYe|%=)Q6{_fiH_9IJ#>sx
z6;&#yKi*=RPchVv0Luiu)^($_)eC9qRT!*C5`a79Sp}1`M=gvfC&T{$NR&H;3H>Vh
zgvcx)&k~S?0h&{Y{*s~^Qk*49^(|HUb`W|7J!%VOri%AbI7f*)pJ0l*T0%-|=*S+c
zJJZNXy^(ZUY7$gWKxhnGgOb;hYwbV2Qgx`gbj01l6!kX=$V|&>CZ}^OD;ZtXlXRex
z1y7tSqa&7hbC6jz7WOp*67z~^W=Y{GS?^XQSvCiZ&sK;}Sp(5&NjO42nF=*<_)#!=
z2dJu0$F(vsB-Ls1lhJ(_)b%)E_pADVM6`1~HkruDzB2^cf^JPX7`q%Pd=(1SSq`y&
zRLkWg{Oga*>2!suD{Q9@6w?w2p-?`q^o<&-c`dA^HL8-LDune4rhZeFMp4@ihBr~w
zvfZm%OK;<NG{dP1OG&G#$D4Um(vp7o??Gvot&o(d1+oinxHCeI5rJ8r?KY{Cy!6`1
z{{V&m0Jq~4Dn+wcZW^|Dr{k9@K%qjyija~p<%kfW=M1)ut7u!RZBK>wl)RLyfU=hM
zKAHia88mCZ>!R<b)4iVsgNq14UoDk5-4e9Z)QVAP^yZYD%*{6IOuE~zrD<7F#J^Kc
z;RQfpC%9Ey>n@4@AKZ60*P-^EdMxj46sFQpwXVhYMNhk-&%#nDn&t=`V6?KP?yA`W
ziD_h!i4I~{!~iJdP-+1?QZc=MU4IgHOtIX*)_vCAon1pb+iQkW+FEwmZK=D?V*WB-
zZ8U2FlrWIG0#bOG8+I0L++yXju-d{)#Qr!P<UK&H=}E~)V@c9pzsWJ*@BEyvS=YbW
ztgl|5_%`jefYmJh>e;tF`oTQaqYV^TIjOpVMPcDXEcE-GL|fw2lH1oUxye@{AO{MU
zRN)woBm@zPqj{fm$1}rv)t}z!J$L$z`z~w4o~``3IOX5+-`&e;mwxoZO>2}!t!SRl
zYpZN2KJ9mj`&u8Ap75n|q1t#Iea{!u&!p*JT3F%ixxTL--giC=rtoNgm<A9j#<P*t
z-6he>X0(X6Q8lhqf+=aua?Drv$Zn@IC`8_cZn+RLq?Y!eh`TZ=L=(bbnhrkL5ZMH!
zGc7snBYG<8(o}?|wXBTsYzO56ZAxm{cP}B9_fe;i;$@bPY^GUV#SS+<8(rK~uc>4M
zS^+i3h2+jhe{09%hn4SG<>s7NT(6_a{h`a{oa2|I>qknOwnG-Jj^arezEu=vO0wA|
zlsru!+DUklq_`SdfCySU%jKG>#nAT<Y1~f}I>|A|$Kah@a<`K_v%aahkK&tPw=P_H
z%p9PyEJX-#RD4^92~KL@k<u+(-cyK6$w9)ZJ%lKrEKwn}f@-AniQo05T>4FV`u_l;
zU2l5Y8E{>`7S00FYKB)uCDl_moFz!fG|R@YPbtK<n`FGSl=78za*&)#Y#-?8PE=cm
z)lLyQ-rbJ9qGkDJtzMmSv+#&fr@dZ2tSqpST1rxJw#7grH0GyOLFEXt^3+=`VW|!{
znqsN{07<Z%TMttFqt@H{r`XqQaqoMlZlJcOS_SnC7}6YYIqOPQ_%{BGg0~<=wA$_-
zQlASgTLn8@J;z;0sjqv|G70gM?!EVZ4P9QJuf;9ar0<vaM6{Q!5?+3fmsFCpQkWKf
z4c85DrVVa6deciT76Q^-N={&AM|gw3)e$#3`loX1E|aE-CO>j8D5=qKrM|G}an4$|
z#gbacWD&WAX(HW#tQd;QsM<{w^)f3`s&?K##dRe8bYJd?-z^fuWdYEochVho$0~50
zgJC3!l8%BIDd#kzL0TFCX~LSJB{|?pu4+|tCP_Lq>AuUA>pl$cS6>nortMfm&SFxn
zn?tKgMkiMDxe5$BsC^WQ<Sk``S6e*ZdyF+jmjZ`%E-d{@RDrZ=dg$-)H*M+qgw)zk
z!*n#3(SQb=<z`-8!=2;IRVXkgtRu}j>g|%+!+guWd+MO6WwAh&997KMIX!<`TfP4P
zGt+zfe#z2HdiLm31pd%Ng~02pZ~!P05CT-t1aVe!InFwZm$_jj4jxk=&=!jFH3xMX
z`vgg@@SD3^*3YyxC6j)ge-;Wj*5X2xwKN$>s81-4@lSXGjN$_>l3W(eg%`)cVNP5)
z=_lbiM4C_<t1<vS5$dz2>$+Wb?W_GuZ}sSvEw=8}jPlcL%0kKXGUL7FRFv<)n!vi(
zyjq4{qlWcg7@WDme-NKnc8%brd}8<f63x%oLUqUStB$Ab*@<<;DM2kE^5FM;M;PU<
zlvNTl#*vYTaYZR}2g78xaNGh5t)U<^hEj^<K%9+Zr=;J-F8=^u%;~<jqRo2u_<9Je
z4XJ8MODb17je4<_WEM>_s2<1yd2BM!cr`^1N|jYO;uue<XT?>;FY9UOlkwW`uVDH7
zyiB*tpi54q6%OUP1|0jf?<gpMV`3O`;l~P^Jmj>8S3(q|wveT!g!e%vsqit{bvsW}
zTkHETUq)5J7SnD5OKJ+ZAk-HUuTzT@^x~}q6OL6RIMQ2298?CXQVvLL<|#p*87=<+
zLjM4_`<m<bI?mn1MblUnh^<OE5r+uGLV!5c^-u)_6BzNO3T-GPfQlSybtNMaUVH}*
z5$H{Ry%Nf_>9>*zMs-O}N%S;UYASl+rAFdwG@vC&z*Z3Bm@}s^sFD=C{$9Kz`~Lu%
z#O`G&!)i;5O$8Z6aRE`?BO<)B2Y}us#+_tc+^xmC&S@XAAs`hLfl}Q!2>auy`q}U$
zm&Q*|Q=4a9OK9e&nDcq5wn0xZ!fM(x84xIUp_zw@me6U$@>R>_tu!loo!1KLK^&~}
z70gTNy(ZGhy=>P`z0MF6px9CzN^tX0wiccz78L=$4dk}rz>q;ld1(qJywspm7W=Gm
zl-|>^rb5EkRN`3fkx&vHsLfz+Kw=(P#1vAbl(qqI41jRvl%~7q?2k{^K<yMK)S!hH
zIc{9G-5Nnyz*Oc~pP&>0Co0C*ifx4@Dz@%Cr!8C|SSZsim8IuRYf6s^FR5;?>YDzI
zYwp*na;i&jQ3+vIWu$_HqZ+b!Dwzsx0eg727(<Q~^2$=DXpo-wEP{ibaD7w6#ozm<
z>Ll00?!BC+Y;^{0p0%}7vVGd60a%Js(Dl}t*K@`-?F%j4>S=9gLe*-{B&dI+DNs~#
zZPs(;y3%rd-P*^h<MN$o7VbP(?;*2^K(wR+J{}>GySsGbSo27>UIxn#3Kbzrd9jEQ
zhy^qfO>5;Y3xZ@{{4FezObHZ9-78BWIfaCSix+g^2aIv2+NfS6DZC3t6!Q>qA!&1L
zIrj}|h|P2)OH$s2+phy<)-bkK@>ZhiNee?}ib@g&Tjdg)$G?{?^cGunr7Sy$6*Sse
zSS}v5!&8u#?0&xGCXO#&Qf{o!j6Ajb!Ft@I7reGmc+!a|-#!pex?E|um|g%E&O@U<
zV{1vOMk7!ZcQW_=c1w2|)#}$tO|>UQy|7A_m2#3sAfcWkmUw<qkpfj}Pc7xC4WtwU
z>ET-OHH%|6uc}4ai^y{B;Wbyo+;vw>x<{6pX;;KFNW>^e%+oTI=OW2go6xovN1T+Q
zptP!~aI2{qAts+mmMyVHxquOk4q>KU;4=BR(1jin$hzp2H`Jh%B~5^=Seu|U_+Y1O
zCYg~U;Xp9UluHQZb1*CYH42I+Ji?B3mqAZjt<~IUl%*zwRIBv(@Z&3WTe_4eR8@QV
z^_jYi<xZ;{AKO*B{{Wh4ml%E;?G%8o)(Xr={{U*bE~l$mX|Gx~r-MAe;!~Lw<2!qM
z(zETZt#S7=tZUrO$)}qkX+x4PG|fiUbavh5{7Owe>8?q(vUB6QXY)nQov5X>jKrw7
zx4a-zZ#m`U<F>oyF?)EqWREUBPOY6$stS=Pn76wd)_FdjUk9ShUg^n;%Z<&@r&46f
zrW$=Ts!a3vS8F5J^)Y$zxh|1*m2DX^7nVkF@UFH!9&yT5fVc)W6#{Ybbknz+md?4r
z#+=G=ocvuh>*VL;corigaZWRyoje^J{Lkt-%JX}NjO6L`-CVw^!h%$}tcK63b9MSV
zb<>yEk!^$-RNrV2eqlLn((qSZInQy8S*ap18q-H|Cq1?FYo?j{*wcp_5Cc+Wd_<D3
z)3K`0)W(PrNeQ`V#?4hvC|@j*6o;EUV`*hw62g7n6e$OczHFW<5w!<|I8r*zd9t1n
zO^u{=RGyQ6QHFk-W}fRv@`7*bIkDjzGB%Of!#d7aHZL1yV$jEf4C(b8`nml#PKKh`
z$9>t;>N&anHqC<`0y+Rq`LM@>p}1imR7VsOUUil}ocJ_v?(J9691teF>n!~_@ND1R
zSwAc_1mD!jhd-x_pg!QjxI@-&>ed|ojxCz2PG&eHPLr0ox!xG*bY^tKRy?4cezkLQ
zyfM?EpYo)~wWRCytCN?|j>`4vUJ>!%dDe3|I9>;BD_5lctg;4oob|(Q7u&n(QgniL
zOt-A`eRrR4HTKU>MJlv)50+ikJV2g_?mq86>&tz&+3M(_R+6u(W%1>n0(!s9ecown
z$$huk>(q0q($qK^&=fLw3F)5V{9bP=@!xFq_{TP_EnN)hIV>NPPh9s8CzW`=%RRmr
zxpirdbTg(lmg?XH_D+Ah$>&}h?d#q2<Ci*fqpazTgB=9+eR%QxOujD%(8=!lSh<gL
zcy*mA(^*$Z?fTK<oR#4EIeZ@L#T?K@%SR$a=pE8qJtwwu$BuH>gXv`++rtzE`_3v+
zmnTV2K|Q}xJd>KdJ{di?f+&=yxQTGRC&GIC<I6d##p7PPz@|#pl><p_{Hb47dahGX
zFV=Y^vb}%h{=iylE;KlZaiy!I>zs~XRm%*WzJN|@j;o1>PM(zRChU%WdvlprS;eDd
z+`Q*l@iwU$QfldsCMB+(05%TiIPDgxma}q9T9^jhbltLI#MvtNlH72X6G<!<T4;o2
z4j2+?S7<_M3N4Qa(6*uzNUlPJXkDjMeMX#_8j=(ln&a-gebbk-Je{1br%!k>I+yf=
zJ$yeQ#qzv-{{T93eCG2_j0iGJg6Rg+#wUHVY3jo7wr7*E$=SXxxg1wnI(<Ia76FlA
zbOQo;bHAB$$E(@LkL6B0`W$<t$+`!O$CX=)r;JY`O{RN7d)fyXJkJ%lo=_ufM9yBO
zUn9b&fpdhZ2~OrVxV%X_%e}0{HKuapf+<2bOQmA4*0j50%Vns+sLaUIS0*-vt_?;c
zRk<@tO6con#v>I9eB{b+8orH8zcgjq_FnplNUW&r_0dXztnz1v=5^%9^F4TF`CRz&
z>8EZkLb%G?dy+uTOk+|mSF1NAyG{cdTfbUOV;2~iR&uK}Dh0P{CZfc(4lzU}aTGQs
zVk=l86)G|bmMlt8-HCL~Vq(ooVXunldZ+mtuk4JD&?=f1tNupo`y(intKn|Y=_wW3
zTXFuN`e)GkGBN&VAB)T8PCC5^VKbgrYHh#q2h%t7<CXVOJga|A(eoHjNz1v~yJ52H
zJ9x*Q`?fb-CljdmmPbj*p4B#XQJ#mI`@5$-*I%U_X})Z66O;b{+&s@pr=sdSd3&7l
za(A3qx}&JJIEl*t05Z66dZ(`EBgL05CG~Nby%UcYPQ6(P`Gn<-!|VBs_FhbWFAtt~
z)x*K)@Q#ViVI$_8<y||dne4pS&sU3f`n>)X=+s_0ttab!@{l&8)_U^yIL}v+!f{ul
zOGWEHtt-=SJr~_aox|x@Z5|zERouquweX#<x^df_;dMJsw6WGV_gT{Wist9^T@@Xt
zx?AB?%Xoci$QH?tPE4{)*!p^I$08Q$3Wo~9T_8544;dy^Bc7DmEaHC=-YE`Ya7#)K
zk3mzENCeVu&bSU4aJ4aOOOIvV6`m$INE8`OiKPTGsNg~-fRk)vfiFZ9gj-S+8Fq=K
ztQn-5%d|}fI<sjAK2kM>Q3uLQs%O~JxcztWGLfuzp7zdpQnTt)Hc?1KiU|Nqe~OVc
zxW{q;f)I|Mv#r+*aoOgml+K)SaO~6~@fjou0L=hvs<}qbln%1x5Ulu2<Y(9_g~gTJ
zA2`|jklVBeGG{+g4X<qOLujDP(lgVRrJ}P^q-i&^wJ5yiadu28$2Q6@Rg-ET>2`RC
zG4+x|Kmj+$7Y>Z%wEoeQHU?SAWpl19xz(pgIYc2-X(|JX7?i45B`R0xkh9%^Aq~}<
zraq~kQuk;c+G}}XiAr(|fM$k5qyq>kQY$J%QlwT<6^w`wX%Z@;M8L?ZCSf26tcU=q
zgaDB+fD#141ww?v1sOvrlyZ<E4Ikq*#~II;vCG-hjKJAa6lV%oXkv=UtjN+PL<%HL
z0464|0ab}60TN72U<8vAOe_X5B*KWwG8GaKDF$OKSc3@yML?it5-Px;WL83gYa#<-
zX)+T6f~3Tx$WRnSg+K;+vr4&IEz?|25YlPAR&f6M%dX66$iCMbd0;6Pi7!z7ZId&U
zYYcq3XW6OUoUe}^ztPiaHVD#mt1ASa?Yk*KCvu~iueKRUDl{UzXI?yfFp;e}=a-gN
zv*=P&nF;jo?c*^~N=XATl%Z;Cbq6I8PLwcYoGL0jDP6NX1eTSl)RU??foiTA)Ttwg
zP)~&-LV|0aEJZElmLCEC0P2|<){EEqlI9YV;!*%e*<Ci_7K}@ANhtz~qG|O<A2?am
zo7!DSQA&#QrV3DfY;$5cg=Isz;y;WVI&1ElAoF?3HA!U&^wYkj@ip*?Sq`?eAgu*T
zL0{ITc2A!fI_)oBjdbzXtt8dm_$M_xj)~=j3Vm|3wMPu1No@*oZGxp@2woGCdT;Xy
zce;mce&<`?qdi3?wFyWhgFtAZy$2N-g10fPD^4slaHS*g(h0~K(5+b*r;(1<<25zv
zZ$RtJxTjVTZHZj7RFP4Lxag*1pow|Xr|#b5I;UR^*`>TdQ7RQGQQIV*@dGI?xBC9%
zxqp9U>#b|QsWIt{m*wh0uTtfYyx?)h-f*Zgl!Ym1TCgNgf!*$v6XO+u7TmVlJfho8
zGj64-sZ|PrMqEy2y(t#WekIpM##x@e6S>y!@7))O?x`tW97PCiZICf2sHE`82}(k1
zwoxuAzH$KsrC5-JivAV9MOK~llUm7pe}PPH$vSlX@8Zrlg)I&v0vhK&>eNzkl{4_$
zLwRfpccj>z4ELS|e43~R#Tq2ySxE2%0n~`0H$L~F_%hbZmhUpPsh1n~aQO+UlJ*3g
zNi@w$+POyBnSI7C@FcWZd6l#>Qs1QtONz^J!a9GVbU!q!CbieOVQ#HWa!Nr<#cFKk
z<Ar{pa-ig=FEIh{P6ga9p-r^glnoB@+)%54udX6M5KH?0Mx<Mh_lo0=ILeluT3TA4
zT2s4)MMNMKQ|3P`150tcXA+kAZeh1d5Pl+AB_gV=b6DM8F@IkK-$dwH)*(w%t5Yg-
z6|1e3yx0erx74b*yj004HONU*OL4AATWteWm8C$ew3X8s{dI8yH&565FG<(cHsOBW
zv}UjLy+2TB;&F>-gL%{~q$rgpxOc;x?E6WeS?jthdSi`uN?v3vZ*HZwLR2&3#%g*U
zJX7LMxmV3-?mARRJiuG8g10|JCcUIyX!@(RPNao0vYhe?&m-*-dd0@e8J+f-<8jEV
zw^MCv-Bk+vv`^I>3})&UuoJ(DlNq|yv8?j($D=k{Z&g0!cl?Al9$IjtZaq)8q`i~7
z9dfN}Oq>lQXNdg*4P;h>+Z}4fl48xNaniH>X)+pHn+$}KX?rcZXInx6aL{{9bQx`|
z2~Bg%lgB7c?R&1Y0-D3)7P_rO@Zm1eEIXSmx|7lw#>#j4I?Y6tn-;*CMi5TiKA56t
zfIMq0Pg5APvj8)YgYic}oG6~6<`eWJe)y1TGU96>p~Dr(S3VvbE9?<1I+P_#R}7$B
zPRUXO&d_>LKprYT*0Woy)bg^RBo2h+J+zL{r+Q=Y3jCEglmnG>@(@Z_HPWNk2#goB
zPD|*P?wnbt;#QSN8F-jx8=`tfRV^`%NzfOnF_Y3Q)RmA3^(!wVz*5bd;i5nu*tG%%
zVuX`H0XrRnP{ieUAXoTFS9KZgqf-ZTJ3zqC&P)Ja>rFU*=^~hu^hcrSr0y$c)8kVV
zC=`4J1jQS~OA4dy@b668ej*R+2)&EgpD`y`>+}YB#1xDw%nFM4hfz(H9OwycO)^o4
ztGXA4mBZm*nsLjym(5;`XGO-(7geAz!o{t-!`<$08&cDOKeH?~kPGN?+7m>&4qGYJ
zwx+pGIFN;o@kpf{LHS1&4zkUDyR7tMFDbjOkiGO?p=*t#I4#gwa^b;v93&|XgI1nx
zRLLk+X)GN}FSPZG+4B&kyG|^<m`V+I9V;c;?{oFv?oY?6cD_K^INQyz>XMWr0$F!3
zafJF*Dl;ytJfL)|G`7m@oLU?$0?<e&8$k!*DIlEGILZG2nfm(^zpGukM73jRlq-~%
z(?u(q*=;_evZAH5GN>yCwct!}S$!Zpd24YFv;p*z-~c#Vq0E%#PVxHx0Cm?zx4xN{
zZ%3A??%7^3%_>d5yPQiaVQid_IX<9JYu=`FTC{+st}T$eq?R6K_tNh#;R0wB#>I5l
zjpnC*{{ZTf`hTif-d^3;F4upt{{Xx^!<^vGG0sB{hRG^zfM}bhd%2Oh5O!~_<=gvT
zdT}k#H*A!&65=iJ;V!nL>m!IfX7_(z$uYLu`s&AyKNZUvCOK<=5_@IYwzYdElG+Ep
zwv{T;&NXaz*)$aRl&^(j+c#FG*<r&)vKnxx)G0v}NOOPn25t@&GJB3Mse^xN*R<!n
zT%T`OJL{Bix^3e9DyS(qN=`%(xH0c+bO*F;Qs+=<#4gt6<zAe*E~~szzG*xR`Tb?p
zb@zN;8Tn4t^>-|l=k`4FlZs<|$TKct-1}oY3y`1<YdL9M_M2QXrJm^6eI_E=c(W1J
zV_gzc)DQsLz7Rn|fWQ#qxP>G(2^IUHQ`9J@A(nG&ILS_;^e)!O+}tG<qIXf~k(n~f
zOJOYA6*=8ox##jAe)H3e-xnR^&U`&yk8Q`{$GhIS`;K|V$8WEr$?v&-r!S5-q$cIX
zEuVI5+#$Ey?yZ!B@)|*^$x+M~210_dLF8PdzMgWi0-)N5DL^!PwNAkV=6IREmPtJo
z&*sYKd+++x?bD~?l=A}Ez@;TX0)~pQ1@z|}HKG$$XH4P{mICfuZOkjUZEJDETsTO=
z?MYX4K_-YmllL{#`@hiXtI)Rews!3XLoGV(v1LKf65(OQ5rIolqokTpgbLE81ha0{
zqdIz4h8ZlV6eUF^yHxjzimOy9XLH6iyT9so)ZcGZxoaCf=IysFZ{hf%*GgRG;7$}j
zl2k<ksfD)`K<`yV&<+qy7Vg<9ZEdd2Lzc#51hm(w!lRjALSwZjU9P2?`xkiXYp<v`
zAG7mXD}CFW#{wKJtKypaoNp>2w5KegZB`YI@0#0<`faF^9ptAa0CzafS@4tme_C1k
z_$=$!w8kc0leffR#j^~vXoXyI+XkU3#fcqOqrZEE5|rZzcBxz4^r=Zf?;#FlP4fue
zk$+!_wCioU>sr>+Zr?Fg<ha_x{u3*pN}J4M+L^}+aVWP~3sQ-~lsJ%7q$G*}JZf|4
z5`X1?1h-T9q?^ls0#b&VLt~sk4;GNHoJW|f`AHPwcQS24TS`NTp|J!kotE>t^Apuc
zPu^oh{eC9xy}ssK^#1_2@-N-fZrf}nYf2N(xN#v=N}dBG9`6&fL|w@RvXysQz#IxA
zynvk6;{O0$TO><*PuF6nd%b_)$EWf(2z~n|k%@MfZ>hIkKsmH=E4#7DX!;>89dI_Q
zmQz<2hMTp;x>Dv?ozK-uktcC`TXnfQ6XE;RxZ`RrT(eazU$CVd6i2F^+=%NTn|v-b
z(@Id~DM(1Cb=Q4PIHO#M*chaT!+(jD>DG5CB_J}C*AF&?k(v<D%n?lc)s2+$(r(^A
z5jSfV>^9l&2OAVn2E2DtrJa+|yWRW_)T_&ci!<MF`}NKSaJNztPo-e&lZ57G3tlTU
zEI5RFtBYFHGf`~eDIF=YNX*67k6%ypCj7g0hkq@4rOSpDeC?{ag>1Hm+@fgF3K$a7
zS55o1$|1X=rMSNR0+6QAQ|N6d0AfEf)M{{@gmgYX(vyBZozEV@qUiGRI2+~%xe8|A
z;-o8PQnel^PkDZDNpF(aZGp@9+|q;!2OT~4O59O7P>;$wR8yg9VDkza@2yKiE-0%a
z8zoLSnx=_KCptvB>Rb<U)E0SoR#Q-#I-;N(^5SFl{=vDVpKxA5Qr=qB+JcheRswfg
zO%m#8DUxWKctjVJhMeW$%8lD8Ng*8xQQ`ruVK=G#*JihWm}?3vX;>(l)QaY%&<yH6
zUClC*F>@O#buT)EsFSuOA5jBfo`xu=LYhxb>XMU*${chf<R2+J2v$P5&3D^MQk+-`
z&Bq9@d0$irfR~`iw`sQ3MV68pIQq8Ai7HVv^~Iv$Eu?cw64Jma#FDbLxU9m`Gr`bG
zeZP^j?*+ByGSew(z_kWS?VNKmrtr`tWDQg^J_aeoVnf2zsV=1nwzpb^d04kz9f0Z3
zME?NJji$HPw^B~q{AyfFtdy;`Q1&MSX9W|=Vb5ELPYgtoYHKFlZgW|2E9IfJxQmjp
zlgMmgO6y#KBBGJmcYhLf@6f%d?l{_1mQX=hX->9<q|i2uy<2Az`iju#QVP;ggm(xE
z?|=$YPIwc&V*da_)SDy;*GQ)=<pNwRf>DVrxb|sMw(g)BO!Ah6I<l0fmZdo3VB+UA
zk%hMg)CVGDr*$E-&L!X}jc%ov9dVVSjlK!x6|H;{L9P+PP7s#^CzzzN>M&H{E};$M
zQVBk!Wk~h?bQW*1s;}1Qmu{AYoK<PFLQ5%a6v9Gq@!B`mH3t)Brz#Q5YnW0%Jg_n#
zo-`Xw-&D^om2vc3ahq}0)~J72)E{-?%AatgVsj;>IfjsuGc^P9j&vJVZmtx!&>iKt
zrxHl3jjIVb+f8!=g=aqZ<NEGlI{vl$wK^GHM@y%38e<bht92#xyr8t?l+*<xfMiTA
zo=xSaG$dhj5mz(R+FCVQou<ku1k#hHJt2?sXDPZ~l=W8z-tN^Hxd?jU#52nUT;&86
z1UZ*=IaalVZN$FawfaylgWRN{4W3dPX<oaO;;E`e^Iz%u(3&Vm2u`5b#^r8q22F&P
zL1{%`B;?|9rDJ_w;kFuaExM(wB=X#;3L(?qQs{S}qGZ3Xxqn|}_z>Sv)R3D7!$o75
zFd!%dsV$7Kl#Qb%+g;;{ITC0R6lf{pco{A9G+ETNO+MYq^B0q2H7Q=70tXsP3u_=t
zOt>+jMNOqVI;iA#95_UqYDBdy6^mwt&7yJPaoVY%MO#$|cx~!X+oV72=~c2{S!}G7
zGnaJ>Y#LPjxQ6G9c(u_kLJLSr7*;9^XC5^txDu?E*%a?9q>Hl3!E7hEq0ULKaZWe5
z-ynYY&<gEY_BkgqexX+QdQw*E*8%5-1>;Q#r$fYf4ih;umvz-%#+Nj4g{Qk+#x4d4
z`~?FQaFZroibXkP#{Ja=!CjI^3jG{l?$Ab@=|KRa0)gRA3Desrx4)lGeAdP0o5c_5
zdM==OZ(B5?cQhZuFk<;&5;Hw_o{J?%FC-@S?B7Fvs<#Pj_+<>nptRyDQLo)GpAP$0
z+sBel@tr8Idkb-CQqn_!eKVtHQd5edIdn74pARNKcdMhm8R1+biF(C$s-uk*d5POU
zZ)JH@xP+djf_Sd|UaYvV%e;D~o_WibKCT}K0(AO^V;XrSc83Y+!|0wzZ2h;v>2b&0
zd|ax)k1zCF>k>naDxX*krxm#6k9h3F&R)vph()$(5)D)}aWQK|qEec^lYqtC02@@W
zo!PyX_E73hEfu1SPON=Xt{BR=IPzs;a+wRqlk*q~%k=SSiOZB^=xTQf;$vV5GdG78
zo1FQue{ZV1PIZmgL7cMUjpXfzK1^b^V^v<pv63q|-Wcg#jCuYpF?VmMDN&7@^A(&j
z<8;bBIP*DSS54j$BX+Y);g=hEJrk2`VmsIP2JyYpD%mucoO^E;?=G0ju_s!<uUw|R
zN|L(C^nT9Ruh-Ri^V<Cy=%=gioZ1$?rf~W%MUm>B;pCS5T_^Lp{L`E-I6h-M-%07z
zdj7l1<&<>D)`w9!e|va*)6Mj&)8QV!tsYN2ooaP-9mt%Z)L$HDmho4r@yD`q$B*jd
z>|52EJJNC~)m|J-@?JciucaREsf)$+vUX!pVO)Os$ER3yaWl!`lhyQN+vShN<DB)_
z`{OF(IaW2bbu-K1UYo-9?mTncI=*vf=A8R_#Yd`nylc^TUddz2J;&YAV?i5<M4e;x
zr=8#EJx@IM8eQeqQ;l37ns9ddKWBFz^B;A{GO0Sh>rO7Wh1*V3+%0pJ$<@DFa&-DG
z&R<<&8K+cFQ8~Bt>!TBz9oCV*^AsMF4ShP>Gm;z?WdZN4%(dZK+dgo$EbxdI44D_k
zuG7jVnz@46CwVlwtF-C1<}a*R4Si`f4y&`FA?3wjM^PFLnk3w)Nn0bVc&^VQMElf9
zV!KJ;zFIt!#8g~}Fv$_(c`nn$RlJh~P-N9zuSC&FU3kQ$G=X$MaKxsfO^1q>5g;y`
z#?X;=l{8f_bP0Br8a6?;QH1w|iF}h)JXdf(c2MC7&q?Dik|%=h1{zS|2wqISNv3>S
z*%_yVlHfdL+9sEA9PB&{o#omx(o=E-j#YRGcAIBSXhC+7#sy3c0#ucqE`}GV>l!ND
z_{zIZg~w%TS75VB#<$HVH^ys^xyP60W0$eXjq!8(lJQ&<6MitfXS0jsIDS`$o98*F
z<_5A1(y%d9Nq`5kRUCp~kl>`xCu2U%@%+h$c<Aih_(C?ZT8by1KI@lvuMW&%dLF6z
zM(Q&<S5GZ5L@%hs10FD2l|+@O@sS!+XcE0qN*TbOsv}t@Bsi2OGbLSZVsAyNHhSzx
z)Wuo3mg2&A#!p<=jFLJ`R=MSv>$vX#BOZNR8O-?fZ^xrvU0nRSx_t%OsWG=_obM)i
z^POAdk53)w&lPqS%kGF9RrdtMiyNs{R?a}MxniYCv}M@chb4qIiv&3U+T~FW(x@aZ
zB7nr@5sCo`b2yc&IjBZyOnX6|g{qJL0ARZQ$jz^x`W~zPLhJh@D3q@{{&2o4KTM?O
znA$li@A<8MWAw^Tcs*vf8AGD%YT$g*limoL++-K2))DpP5x5kZwUKn`7}nYf9sdBn
za|QYug-a?<#HjD|?P;X}-V=zm)*iPbGf8TCH!C}_>6Z6wJ58q@rFNVW0aYOE=)}q0
z0FDx?OxBR-9qPiilCA&|4Z4>FL6A^UASwVACLkC#0>lFV0jal%gXI@@-ep6=OW8rh
zYb}&Ix^<3q*8VZ}%on>EE=o$P5I!)azX%y?Q%l~?Jwl&kZ=tUPsS@I2-Eiz;?AldO
zli>$us<NLcu|dI*Bv33F0!0GEfMfumWIzi2WnI(d5v;4ashs;6_6I4c8r*wgbrbQ-
z=St1)dV-|@AeN&^0Zz1p^DZmn583vyEFT$homT=8*64`B*z$$b5rv^TVou5)R)Qf$
zi6&4LdegntM*7>G)d`HwN?ys8bIJ?2zo7JkA8D3>cNM1@&((2>BFM7R?TA1U&c@s!
z0Mcqkw7A8C+A<mgtXemTG%YFH5*V7rBP&kYR7wo#5;2m~q$(i_nuKDlI7*@tsi={a
z6-T=UPEw^v5`9uD-jmc=95E8au*9V~20)ZRs>rMWRb&VNp(3(~CP6R*NRUw?VE`2%
zN`R3xC=?_}0YXFoP%;Dxg##c!qE)oY+CYJ&#>Q)oGoLBS>4AZw<SuZfb;q$9u`*Gj
z6%!(XRf(*Mp;d{jiW^O2Rz*W;tW97NrY5kei6$hN0R~3$z)HqJl>w#_h&0kFkf{<B
z6Eq+cCK7;JWCH?)gCP}Kf<|RTBzcob3K7%xHq13-?bRr^mxLeHPfrTVD<-|((S~vb
z4Wt?hP||ev`1i@aIjkgSn)bzv`sHY&HCCpxCq4I+N>*Cvm2o-K#PAR|D^|#<QoE@G
z?@>G{874&U7XlQe1Y=!37{syi*1LI#jN2TRz~#1*w~Dha6TnxDiCXp4^(S7pz3d=T
zN|FMCvga;>o>V_^g2vm3Kn*&g`5d&4=xr$KdPhX*`<lIfq1Icw*x|CUoJYBulu|c9
zJx?0JxaC)eKS=!*tAO$VN^LH?ES(GZX=^N4QbN1k<A}ti(o;$hquyP8AtNDAIK7hI
znohn;<JBsz;)O#r*JO^Tts+!T1tneFvpjH~5PA!)yAG;NK`CsIT?$5H^{dpYgi3;g
zs6tePwAwK^f!<kg`UQ9jM`XQn>Hh$eTmDNrV{PwyBIlQK+CWo@Wq%s2oGugT2|Q>B
z&LwqdDb-b6rpwDhJw-yaZ6n0z7pfTkU&en!zPfj$`?JAeB(D-t%R-G0c}A;R&xpu*
zKwB!|yF?WS2KO$ZX08WaJ;n*>6S(0Tr{hm7TDtPKPq+Jw=|Y`sDJV;2#|;j618E6L
z)8a@pgK^~-(v+ntWeRPFaSAG`7}l!&R1-+0y;+?l>au=cz3LUqRBWf1;!2rAZLokb
zw56TOx~vNOVmZ8^>xxsZEyDfM%W1|`f^aetNcljhlJx3&7~lN-PWE)2Ix^i@c`7}{
zsmE5}6evqf3=O28*QHO4AG;#iyJlL(uJSG0Ld{h64~XlI9=OzN<tM=HrRmq<=u5kH
zpL%f)Hrko@m6f!C!3{nV6zh(wh(SAWq=lAU3vE2iOKEQ6*|Hb-uB(l4)B(^&`~J5S
zxb)v|^g8zeDZ-?oqy>i%wFIc(LW)*YyMxCGHN)WrcXr~RyTH{|YO8BxtwZ6saHU1G
zBz&3o$(i;2e?xtGF84e3CuzULPHT$gb8ui%lmeL~a*C7j99?&!suCn~Q;wBFfpsdN
z$x0_RDQF&)bP-qin)oMQz=jZ3TS6O4L?W$<lgdL%?>gx}I_X+?!7%aWDQd>?Ds(Ro
zcN>Z%Ar$(wrDUD|0MwOj0Qo=$zt`O^_3&9~4tvusqNP9;a@|%-S`d!wiW~yCL1>p9
z%aEguT(pF#BABQ<&5zVaroIzc^_4L7^i29$OuNUJeYt3QdKtCW0ugNKQW)j@*8-I*
z9!GN-{l99ZdX>JK(Nn0kL0hWaCB<%(o`Z*kop<s700qK+WwKe<(B#VaJn`p}t*8g*
z{n3)vrwRU`cuh##o>hx&E!V;Br*0?fe{>cD{dh?tmo1^)m6MlU@+jCeD(ZR&eKquQ
zQURe(N*pQHOtRBC_iG$>)*8`jX)QPsl+aMczCy}PMK%Y(arVackk*#=Hd;*+U#dWb
zNNK>bYg|3S`{me_njx!YtN;*7Plo;iKVinxWzBIxydwzVMFJ>%d}7vh)bVS546bdk
zH{Z!=?%_Mgy}L`L1tCU*H7or^ADhdh)V)k&Hy(?X_!&Eqp_$WFsLc!%j<PFJ0s;k4
zpa_wk9|#o^wP%N>e$x`(Ybrc5fVB14uRY6a2>C@%nT_riN)PK8ix(@X#&@8WAuIKK
zrw}|nzq)G?K|{pU`3R+4I-F}9)yr)oyuAMaMLsboSVKx!^(!j$9R!K?bo)coWnC(Z
zqIO6LAH2Z>RFzh=1P{_N3bj25a-ap1QbGD8gq&$X&V&2R6fx_l3V{hKIh}`@gt_j3
zIOeK;Ql=?l@&E-02ZWG2p!Jljkfw$#{{UKM=$!aTO1RCK^c0h~Sc1Bgo}|pKx-^?Q
zKmh?=2$I5ij5%HaO!}9lZ_vlAboweAeWsh{IuKlKWlb75RlpAbV!JI`H@E>HDL_=D
zC{n5NJZC%eCRg)2WAeiZJYIpN<4XyBX%1joZHp@d<2<B_Vy0;nrh6FIMfZk9vubfq
zJQ;PQx=(W9XgH9vKk*xEfs4Xf(tf%u>-_%!1ikh9?7bZVP{w4og!f5XX*B^sL;!{F
z-P)2GFWfClXP3*s(`_}7Q;jGNW9mIZt3xlZZl=FqbnEd>k}EZ9W-Q<L#X2o65K;rQ
zsvhQ0U?6%;cTtaSbo5-U{CuYqiQ9K^611f$7*gd9>J;I|XH$RS@LM;3U(u;|_a*5L
zTXeXz9#<q=JaExr%x<`vso}sSHT3j?)0j&salTsGP)fcUO?}~MI17m?tua$H^pk#3
zXY1|uHLu*t?({#iQe0x?tYw>^%WA}g(E&+F!uX~|AW$exrxdp41+BF66I)Q?sHf9_
zVrwyy6STPYG1mI@{dY{ax$raVI)48EW7b?ZHmohgQsuSa0fI3VHgPR&ns=LUcd&TP
zZ0o4hP{LofTO|oyy}AHy>eQok*XBZ!Gw_<7znMG!w8iOcor@*MeRu0lJ=Y&H?%n=r
zKebyps!*jv3%2KqP@z-a^vOc4*i-dN`EP#G8)G#QN;=sGAdT`8$^Pp)T_=~Nnp-WO
z+y`s41?#<?ywmOQvvA!mSV>h#SFN-Y$C;8r@s4e8E;+Z%x$f`WxA79%YKKj?`XfA*
zgD&vc%=2;mUOPQnm%pO>Zf~W{GW5L}xXzvR@%y~HO4OcdWv4=r;t5L7tdx}uh#<?~
zwT{l++g)3Bg3**B&?UAm!UYx<qB(E5OpZN?>Sxcg<8@x2cg54rPsQ}*$0;wx<@Q|P
z{{SxC-$ATy!h$=-xos<STePXP8qYkb9<uax7S7ZHt)ojjfUp!RPZ^>m7Oi1cbv5Y#
z%Z@E!2o)rN2U$}YmRU&?bh^hImAxXzPqpW}iB!Oh&2k6AJhow$trpX%E)-C>kx^21
z0FN2h+i`j4yV^Y*SWY}7^>X)o{{T;qQ@we4`7bXf=Wjs@Tyo&G&Oj9lD4^xE+hV0k
zSIj}CLnx-hSR4-}2^6A%J;b+_bKH}}ahmV;^d_|DZl?AA=3Cs+vR=n%OKvXZ^(AgH
zmr=`2!m$9_mQ(3PeJSGz`rfz=Cf<ml4>Fa|E#!{qTBtr74OXE$sK;c#?7Fu0ljHVG
zbvJJR0NoEDn`)`1>r|dvazgG&7?hQIl!T1bJSN9i#mdT*lp#pBY$W06tAaRURT2kE
z%X=qPoAU4f0E4G#`~Lu;t<y~V;+a`0diB0#!*s}7wV0~*NK&W(5dQ$Qvu^6$EL`3t
z2B#*&mCX$RcS=TT1EiN-BL4u2<CWI^CuVoNz8H|pOgiIiGyzM=P;!7JrjiCtBn*O&
zgd+)4R(#It99{v4<ep-UR8WoTkrGMKb*cAUu3hR|yuQhD;@x4Utysf@CqY0#Xrt1E
z*DU(Mzi#Wn&iDeD9CWV^EQu-reDoOzws!qg*X#TVj#I6xGU}9}#jPB&gjW|eS*gX7
zPU=S4b&%6*I(taB#Frn*gYu;fs8j_U>gN(;uKxg9HU8z)hW`LH-)a2P^R6+C#XK5H
zXvLBnMl4USi=HDh;R?dg7F}Kf#k~|x<KBHe+_R?>ymjio;B@$X@=Uke<NS(h-Nv1^
zw{R6Dmel>jrk(dUHSn*|5aVwpmD{DmjrE(Gf=(<fWmeF5W7?4+`l-FkeQnhI7p1%S
zbf1Y#w)$9c%Arr+++(VaHd4|uO*#xbI><uMq}8#?O4Ef1;M+~+Y0+PuW%T`RI;Ty^
z>5TsKUmoRLzlAMw+e+Sk<tS~Xs|hJcqL-Hh{GuVE(RIt004ixb*2(oWnqfj)@m}g1
z%lg?gPh07w%X*Vvihbwf-=(z=cS1#@B{WjG>Z+bnx)i63Y8q*rCBJ~AHlXlAs@fd8
zRYQxdN}W&}e4<VFFZKRx_3_28$MzWsVFJ?Km82=etgzxnOtRifacU-k#}|lKq-^Lz
zXmBA8lq{yj4Wl8<K*Zy!QOqMfgnEB8^#1*%-tDuaU3dNG57pHz-eSkYZ3q<vG|OVR
z!g#6Geo?K@DQavbMz-O*qM%4YN^0609aG&WKC;yR0K!h47k$ZElBcblTdwmE;+z9y
zo_EgT2KW*H0<^4^b8(QRHWsW#;c4$0uQu6i@XD2siY@ymWGEp`IO5!QxOsR^K{(V%
z#F3d&)1LVVJFj^GwFMy#R~xCWGOv^;#Xt<YN}7kl5~a|UuH7y7TMKdHhKcxS?j;^M
zgIPBg)Fo)5LP|nhTBr~JsZBVNNj`B+6V#O4i-ji{C^f1>XYi7qh#TWOpBR<ma^a^C
zO%k440OeKgRz}&^cm?P$EwwGYsF#l^AP=e4Tm)VwiSF}A!W1^bRFg^$CaSI@(lmcW
z*jK?AT;v6WJW>z|%Db&c>IkJffu3W>xUv+o+H-NdBN|dVB;{E3KVN~=_|Jgo0ktha
zj8$#CWg%4{)g=izVF{*jxOvqn;hG5eYkHY9hy4Mx@mdf?d}Yzr_Wfw|F16J3;{_NR
zS`;2}lq4GSIiKpe`l+w7Luh#zTT`V<OPr)1oHW`1Qdj!xrAM3z(BER4ZPh-qv?v9H
zTZUAj$!^`RQ{;{-p)xFzpK)UoPqxryY8I}jn}>0zj4qy>M0)=KAn7MVe-Hc$^TV2@
zB7_j)UU1bYZr!TYEhmbI87d*<wxt5RPI8tp;XTk$iYnb8ZhDh0{SyAa)RUn$Ta7bD
zNm))N(#l0KEoeRV+atu%q{izGCC3y1=C3!L=3xnO0*y9`<SUhFE$E-G*qv9P0n)B|
z`|k%9ZdqFL4Jl^|m`yXHLF2*!S1pGealT^8h-u8}Y?ZJ(=}0-}LJ1qk>i+<$UZ1X}
zyDqlpdw+P|m!!Fg$`Vk>!YW)Oij)s5sVn<-i<|3<7MXFR{6#pfXL#V^<7n!Um=m8O
za(vBW@mzZi*)WGx^Q|C+@(M%whdF$*LeQPNhMDo&TlRk0HcSN+q%88Atw$-R5}sf~
zxp!J!C{I%_9O?cacDUxJ>vYTR&RKQ859YG4ZFcrfCgsLZu5T$9NJ%Mlx}Xr_&HZO9
zLN?AgT8k~Ni$iKRtfZlBhXRYM3M~Ziz$zPDv$B`JMt8JbCC*a~w}AyNE50&8YzlHv
zfwn5s+Z)~79%_`75~{qGsghISPY<ouKVR-uNNIEux1Pj61z;%fNv>7!5q1_OEfDh3
zQ0kO1tk5`AM&2phOx4!cVRp7C!fJ}qwWuSC-2=LuvjdEEY|@!0oK%H0*-%<L%2P?`
zo+U!HGRRJecDJu&gy2I!o?4t?NC6vj532&WC=N0ecG_D-z)GHH-V)jy1H9Hfl%d0p
zA>%H;@|*p9QZAa<@{)^ZJ}7NX1+CgEm<c;5e8Y@NZPQ}S(@m@dB8~v*DpD5WhQ#Me
zZ7ltLgx9Hhg?8v|m8Rr`l)k(PZ|7#24-DmgwS3EW2MEbY0G!ShWn4aSYdKS>uYI&B
z#VIDDxpk-aL8hxwHSVA5NjeL(A=ZM5Ni`U~gh_X}Q%|F$m26l-?hr<ubd@Oz9I{dq
zxC4ZQvsNA3;-P5+iOYE7>6|g{nf1o4?B>PJ5NSbQ)}S)A=E!|$OSp<wp+n$jr6*|f
z>2FH27X%|A{{Y=zrdFxfP(ESRQlcu>&imsKPYtL+61vIvO0gQN`t_G+g7urcE&^&R
z;VRv}Bmv(~wl+|Xk(<PWM5q(Ip|`y$P9m}mHm331iaH*Bz1S#uDN=aUXDKZ;7Y%EW
zuM;L%Os818TynFuNS$x8%sq+QA`{0C1MH5PzQnAI<DU+@I=bV@)2p7`b?vLxt`s_g
zllK|fUTM}kt0Xv(6~SIJ&#gOWgs$6j$2%Ma!VU#XZF50?O$szCZ|e>obCh2jjc(N3
zvBc`lkyu@5dZ$bbJsi1CRWTAw*yIzHW~Oi|9a`@-rt>)&H;IAX2v(C>k*zCR3MfYn
zvBXJ{lHt9sF#5!W03vOwicUGMb8gsmPBX_Xf}1%)w6NkS#$sivmUV99xUtUa*7z%w
zd#tfgtfziFw#OB4<;PoVn-u_5&LpKoPTE=7!0g1<BuNxTBCv@_Fe#vlDGIbw0I(U3
z@FAv}17S#26e33O8$-sIluH6lD{&y8%}E6k43HoOs=Ao0F{m4(2NphKBqC23tGbB~
zIylXSPZ+D`P_c68;}M2u!xoyHnKCH7bV1>n`gpY0)vS!0_Xk)KnTy36ZgW-+Q>iF*
zjcGakCr3%n<b0i1#xNpsye_Wuoxx<CSM{ZBCmX`-^iF@fg4AlittzNz52Eh$PjK^X
zaGg`eQ}>4xJoky{)OzPT%euQxsh0ATDPxJAZ>3(HN3ZKgm&*KCgHi{Kqz<?~Y396j
z=<$zV)sH8hUlsaq(s!hz7Y`0I&2X<r)5YwZk>vWBFU8|Wq@qpJpwBObdT$(iKBRdk
zE>V5&4H-(C*F0yNRp|Or>++T5oYit%Z1I&yzF!*8KC8Xsk5=Q)IhK?{wp3t??>WKN
z@x479XEMMx4;ali!>r`#c-@@7vFT{_jnjA!8O^^3O))t(F+!mI;<G&(@NZ0ch%pW@
ze9Fu<rrGiwI#U}GdYO$j-q_tc=ZMWpUs;Vd-q`AS&q?VRmAf;h{{Sm~PJKnxUPmf2
zzFVBFq~gZ;H^;57E>p$Nmfsa7qM%<ecZcH7R}ad(Un|Sce=|J4Fm;hMGA2X-Q$L6#
zHhbb{F2-G&$GT(PcVK&w777?QoHFiZ-RZ-zh5Vza=Mc9N3@n0MAc;9f&Rl`UMy4vo
z%;8R@JY{>gB%G#vT_!E<%I8j<x)GQ|uJ5$W#<gsX+?bN(L~`#f<4doG3``dswzoEN
z$3;7JUNX7MoarpZttHKik;|7pF^Zg0q>-hyot?LFR|avtx8ez#*>7g0>X`R+y_{W2
zVmml}GlwGbJv>#O8tbhTa0r`UK$wdiY96wvhLyA^l>L>#GN_6s&)ZxRYL*ZV(5N)3
zP(ks*g8+$9iBXz~5qcWy$Nq<^f04TW$i(Z%{)wu8k-GlK%_B6g8^&Pk1Coi3uyuhn
zr4>XI3!vIc%t10Jg<^<+3l35ZMv$;6%TJV$L8NZl^O0;4S3#s}Yh_7Fl`0xp6C+aT
z9*d*vLBNrUavDagwpNstK<O^omrqJ%(BeT7lSbB3u#i<0Z6$OGFl{=Q6Hs7KU}6D{
z0GE5ssCZ0s1^{yU@;l`C#~S-yqccpI$}Q}mQ57&xIY$VPMA`n7<`<FY8|jaHRQ{BD
zi;r}dtGd%yiGiO84H?R`2ZY%>HXrek02T~QU;zP%1^_CuD*!6>rBNz~)|HZ`bL?f<
zE0@1N8BrR8gPf_(m5|kHse>+Jbs%+-O_Dk;&b3TF$bQbFB+X!8)FY>}7+MoE-EA|Z
z>;i6Ag|h*E<r_K3WC}fD>`qcPzF#un=f-0+%erKDr@AXuHK!QoMQ(vI;Tp%X<Jnft
zj4gpT0R<KojpR0SgoO^+iDb<}Ax=_aQfA^tYSV_*5Q8-aD$|6Rlo_Oqlv?EzT&1Ea
zILI5wf{w(@&0<8Mz%nZ+fmMmD09c6z04iYsHggjyCY7XC04lK{zy*l_zy-(<0YYJ%
z0Ff|&6D9#rB)|->OoeSAK-TAsi=H!|CuQX9>4AZ&<Su#Y<m-=P5^EsHibkx8z@lpt
zSWqglHIM?U6IfJKlOhBYSr7vgA^{p{LWnXT2ATj!ngB?cKna=vC`f=4Sr7sCgvY$<
z)`;QE#;+ub$6b$PuTfi~lx?HGRYdEQUOBv%f0q6UmDUcV0;OWaDYZKJ$O<5*U^b^y
z)^>z)+2~S&RFW!3?vq*?P}lB0aHjg8WKb0q&;S86`-dMmmyH7IJB^HAroI5>GGx2-
z(&OHJ!@!jD7Ngx#YVkiRM$`cDi3R7|Z6PR0a1#2f>88odQ*Q~By<+a&Pw2fdw*LS^
zf7L^Q#i+eRAvErU4k;D-OiRgiz_o=2=n~Thicwzsn{IZGSXqC;eJs~*<~B~9{b;DG
zg?UjG<%$}WbytAll+;6RQ6%6?VJ4hET=|&pc2Af2uKcC^O9H$xrnqw4a0A2%0YM_8
z5${nU8<L^E+e@OQy$<PfCsdH0=%ZmrJohT!XqOX#3N7YJRFnd$)m&6-_sM&u=?T9T
zmv^sVQu8Al=}#>IN=_`#F-h)%d@Hn(-DxRS8sSJ*8es=M^(l}CXy0?ud~)fI_fK0w
zPcSWz5?m{Gjytv-8H2y3rk==^E|*1N4kG{-?UJe?(yEfIAX2sCCewXar(4@yj~~mg
zkLEzRY^}uw6)CqJD<lwy9ZEo`sq~=b6L3n~<hTVE>KV#|VTr}<#F`%|cM|=N8`JgC
zaqqvd3O6Wa&v-&#bTxrE2?5vMB&ZzzL}AWuWgG~_MXWgJQKbS@tPO<a>QYlk^iB3P
zH#N|+rKn4ZQ9~j37!5FoIW2$Tqq>q@HT5Vcfzn0IP^+3Wf6;ACB85&6a3PVFK{UjC
z<Gl1gAL^eQ-*>q>$)eo1Dq2*MQsufFz!RBicPAHny|@QBH%kmQ<G}=}Ds^YRtZzJw
zfIq68hm^KN^gO%t?!9e6Dk-=nFS*O^RVfMhXgE><tvl-lN5IDSE+v~H)2=>%9AP}P
zxJ!>*xkZ!{^=hgZ+30*B{{U_1JM3o)5ZwdUN)I{?=?7-TdgN6Q>rOiQ)USzwYH0x~
zz}qQE?~&C?+?fx@{{SoZ_;yQXzg<k<yi<2~R}C`CQpyxc@e-%pr2$B-FehqwM(RRR
z+pH&)aXO@_OFhIg*Q*Nn;x(*q@k>@tl2h(owbIpOg)Q1tVs%5+h@4nkrsR$=Hup`f
zzH?y;N>Z}RO^O1#kdd`$I>yuSU$K54)oq}<9k~RpL!8Tp^%9hmL^KB<tgf*=lv+QT
zHVHzMY={I<AR6WnDUb(`8N56Gzr5qWnVkAh+~oOQXZGo0=AEfrprl~cRMV*{6jLtS
zk%$cPZN!bdXIu8&qJQoUC09+V%`I50IH#BR&nmRSg$|!rI?E=n;J5euJsHmQCO`GQ
zzufS?QvnJf*9fYW<G~<#!fW=IS~IR#+#m%dbt|T7sHg|oF6v>dy0NL$<d+VHWtZGT
zj<%I43H9O5mGJ2{ovPev?-jK|6_S#y(xKuew<mKvCQ+WZv@p)&K~2KiP$Hr`yj_l@
zrCc<TZ_5Iy8!1G88Eo4#%O01iOs+M%;h$O1v|WX!q*Ei8QxMIgxC4~mJhKTMWY&w9
zQ_FE?9S&{EFt)GNHSqqtAj%dBYA~SEzsG33!xO9#Ejx6eLVglYcNe5o=4r+r<?@?U
zr6n}kG~xdMtaOPdRn@<O+caZ(=Q7}dK$LeyGTIG8iQA0UJ(Y}#8-sr-FN{A#5h;)$
z){!Dnkg}=;QYSJ%>VGK}c7>CHqt+qSMz>5>^u;s15csJ<8xddQB^1kutgx)!q&T&r
z(U7LV$+i^k53Pv!4iZwghf|E?wxX1$Z|;-L;!a6V=d_zmH=|^PgpxC+{@>#gwGqar
ze`%MvYelJRcNTbMUm1_XwncL!l^H4DCBx!;xC3&$P89S2tIvRlH5it6-`aK&J1aR|
z)9zOP0Pu=?WVVU`75Ykqy~UGJ3p7X`*$P%NPxYi}be8lj+EH4dovRdt(JAm>=O@Iz
zq%l3PKy#R$s5pGYC4*{Fpvs`<<4@r;pQ2~k(~WrJqU?LYK`38$VT;e@`gq2jmU5*+
zyCXXAp~(9uEc=<xvD=U3PAk#qmW<ptr+dx4tBY|7Z@5WGN)n=%RM@Yqrj_b5k=bs4
zxn3sW=U#9IY8zf|snjGgq*QkRr4&Y8X6MV@G3h_moUi6H>t{vVEH_&s(`z=@9M)BE
z7IE9Ml@i-(MSi_OR54+Ti)(cYOPhPHVp68taE?=q8oCrcB?>h)rgL3-e|$Q8e^s9=
z*L}{rzXI7vMdFLN8$eimr9%l>bs#JOU9naL(5G*dqNLoS?WJ5cn$qcnCn~a?lz^ad
zRyC??S$?%wepr&vAHaoLUo8uE-Br4_xh}TRJ<8&u+E#xueIsb3INJ3~zDn^l;6+nh
zC2B`?#qE-kK{Gn;f7{{u?7s-V^@q!3I)$vE1$?u}Ld8_tRz4$Wa2$v=&xCJgvu&u`
z*rhKxo0eANZmiXWVIAhwqACivK62~V`^nQTtmAz>3)XD?v@jpHxePY@jkudfTq@<e
zYS7CXmtOj7^unRH9d*VQ&9nB;B!*HG%UcgLe*yDasio7nt@E0lFXDE;ukK57vd+`L
z;+MANviha_<=Z&ht3U_~ajT20)9#NT6d<Xfb7j+&dYJ0pm2+_F7Et3aB`>ltjG3hz
zVdX3wWh$zZT;;c~ZO=*m<n^De{gz2*f7{~C=_Q@}Rt&9o3tkq%VQsXBvgaWxAw{(s
z)UteQK^0-l4!DcNwx^q0qnOHYwB@segei3ft^|=$AFY19R(uzIB3{#7k$0zB>l!`A
zm3+d*tIXhYlIA)Sp64-u`U&1IPffxCjlw(al`!LoAuZguPlTY5DTxAtont98#^ZfY
zPvo;JhI2f7rL%h5$ems1WwqO_7W6DG-O4t#3Uiq!xZv<mooCv|V{SE_B^vdcs($ZI
zLYB0s0OOXU@f*kv^E-fe45x>ej`8PX)9yID@$#OJrNhZNxaIYEJ*T*we4ZDz4@%VA
zbqJx{M!#hGW4gm<P<Rt;$->=o4>&k^CyesS?d`Zcvhuy7*Ob$jz4tQ=d~xqx&Vi?(
za@|=8b!jD(tBOac{Sosor3<%Gn`t-$s#A(k_zi@bsUQr*>Fs!CGs^dN=^TCExwrCT
z+tuf?-Sw#yTLDY}_o+!yB_Txs)Oe`yl84&=08KP)!W_3Mpb9i6xB$o<>R{i&ch|2(
z*G{+bB}So=8d2pZ5>l~<2YzC@p72U*O66KX+_`Fnh1@MlUBa-T30cJXM|dGA8zm%F
zM~I8}FHiJek6z|KZjyTZ67X!HHBd=g$XN(q?Ij=SGQNpg^C=V<L~PP;)nFHLiyM7O
z_W*fKg)KJhSGwZCB!>bj5_*|0r|KPb{si9dPSf`MPbufp-x)ut!_M8ibI5Ff&~Ke^
z@;5Jn0$4&$K?oh?`9$1R=Ka##8+R^gRhoX!Zjw2d6~pRxB+&3Neg|D^_4pH{-S65&
z?RReAY}<R@qJsUV8+%0sSlsheP1}nHm`W??18T=t4l>I}y@Qs7r8q!U6|!)OP$_cn
zbS~ySFMjZn+5*-VTyY9j%FW3kN=_Eq!YC5oQVEJ%ytZ+GT~cV48l?hVJDszp>X7aF
z?z;WD9sb`EXwkSf^Z}+DFF$gsln0l%rE@rHnsBUG4+pKS0+>xfyVO)t6@`#8N(CuZ
zAFW-Z`mfvj&br^N?Gp9gU$!mILwJ-H@pAoXMWX}+h7gcOG$ee7GEa;}vyQ)YajIM<
zlm)9c6;Fc2Xp*d}S5E=35`Q{Rn|fVu@W-vc8eL3g6Y;cOS0?M-8fY%w$%6Bv{{R-{
zS%jlK@;^*6RHl-IIfN<0jcZ7$Qt4VGQlJ6ds-^99@cngOzYoPXxx0Gh(tV<8f1#=i
zhTJ%o6x-L!3sY_=lFnohqg<$wT6n^9Ief<-DQGN}Jf$ceSUuD<oVRnrO|R-NuYQpG
zPuJX+Qj$Y!UJOT>m(0UiWNVR9&$cDPyM>0sZL)-=Dq${uD$v=);a*0F%^(gnlhEr;
z@2YEFsOGeVElW=|_TFT;(rT22Iu9t5U6S5pZCE$oaNMCuEdm0Zy=M(pqW5y$v?`Po
zNGGU`==*E;Ubobfr}7Qei*<`~$27lu;APBwFoNaFx#ot?b+NT%rrogn#Hbt%w!>!<
zRFnWp)|B^mD>zjq`{?zn-&f%~7R^My`|3kXt%NTNq;t!-N?A=$IY~`B?rfCt0yljq
zvvT3`)-*g)>&-NIuC3(v5QNtxr6PoZ8#_bCt*i51jd^iyj#yHhQgEjjZ3iT}v&-gF
zpxGm6M&7~(d4-g?k_A*xc$Ig5)2$%=zu6|%hj8twxGeJlExMGbw@{IV9n>vVrXn*@
z@sb*E0Jm|p;dO5)QkX~0%zazqR#-<#F1xSYCiK0!lK2Wmy6qXG&Q)xwW{7DOtBYQF
zlk(SuNd2X%-K{iIekKB1LuhSOLv5sPNTp)`0Oa*%ce`8DvQ(h+)h+W|O8H`^WhezH
zcx&DQu|aGFI#z|D2t34*xn)TlIC<|P>VCc}**cP>o^}MODP91ejnsw_lAJlxtEYC7
z8KC{4ga+4urM_o*P9WqGuLSQ;85c(3deM@MG;k;-swlRi3FWkRLPc|M{n0k~gUux;
zW|R_F>1={|jug_BCbX<;_4hv%*?T9J>TS}7eiay_N_RD&VkZV4tl;`0k#v`vaZL<}
zP-$)ol`R=4r|8JQbSx&_XlPt5Yb~?|#ml9A^)jqw2o&~Z78KIZ{{S%zlqm`KmeKf$
zY=MIoS>jzyd}0MZsmqw#Q`Brx*BxEZ#CfG0p@D2?>ZL2=B}#MN3J3<_v^wf83VsqB
zDk$Y;^WYE%Vv^&EX*`#Mt`wz&Tsu*Tv75(y)SSSXZnyBi4J|EhIaMdoZ%TzXKqyzn
zE$R0DOG!Ha0C_vw8*U}m+gg4bP9+5?r5*u&#i>HOuY6}b<W!>Xm|0PDTQ;S*e+QP6
zlVdMkbI3>$dTaLq){XOQrRE%OzTLtbT8c_sVPgq#K<7{^hm2B>x-zDVs(o#>QXEzy
z>(A!cQ3EOx039Nw{e6~n-ja3uEA=NCqfDV;OXWKKP@FBLDm&7&E0K3}hb;rIG#F4z
ze8$ZINyCbW%D5}NWV(r!>H6xkWR}+%sUiFR)j0hXhSajs0&~cy1>hCjrm&rqe(w7D
zcMk-hzi{)6@WO`43I{K%wC8?hldjvHk57xPuwkN>m@eD0>+IY(86dcut8#*nmsg5`
z#8#t?L}jHZHri4U&AYbgN{aB@FB;X%T}#1Ps{u_;8q##fw}1AjKd<5ZobP*d)$X==
z#1{~h{7foo=Ur8CRVl*S0I#Vv&%z^43w`6<$3^2(iAoZq@`QpnP}ogWjIHQ~SyQDo
zSV~+fCD$vO_M%008=nCTi)1%;+6(R%9cVbiWdO9$t_K2%*p#Tt`q5|mhWd5^D`Mpq
zn3RN7^{~@!p+lPbDpI5Yw$<{9(@=R8N^ch9PdK&>z(PvLFeJDR6N3OJ03M+quh^1(
zzUOVjD^B@5=TPz#LfOI+q#BUfG;s?_%7=t-m9SiQ2PC9Cgf9<qY^ez(rPIVKYV9tm
zzt_ZPRMi30KYG)_Ew<apb(d4=xM@iwrC<D&6ok3>i&_>?w$$R(l%+TguuT<H!DN6!
zeB@pJzAI{Kn_NH04%|3^wGtFUg+&M<C^_y1a=TmAF*SC!mHi=U!jnp&C=|uF851j|
z?ntiG@41gqAu6fOG{^(eGilr)smkK70aB{PsCQF_`;{RhKD!AmrAtUy6iP)+eqRFu
zX=w{(Si+9~0K39CLq$sqsIKWfd<0cMdn+WnOew~KGGEm^QhZ~i(WaY0B`R0MDNewC
zx1U%$8%fpX+Vd%}*6&%S&XPT`$8V6;r)ZvXxhbT%P3U}QY(7|=S9rN)^Ht@V$z1*2
zQH16Fc8n7L0K6LY^&SFhjI2Ghy5%;i(|n^xFd?IW)RWdtm#`f!^eMsK<Mc+&s@{Vb
z&YS-L7}^?DlXq^afkvaP1qb)WY+Nu^Oj&TLmua-rQ?Yb;fFvrF-#q=13A#!MGzB~r
z##>pn6>81ELI48^JWmMBUGow79<uG7npL&6>Kn?qzpn{XZF1pR7&0F;*4WxetEU}i
z`K2`Q1qUd@-muV1mr-Ha$9DU(Z|O@@?If<<dDMKr-8*}Wb~RfC+gv0RsU!?sGM5Y0
zo71Zt*!0|QzekN3W7@q1?E_I;WFAt9Evtu=?9LhaN1d)rJZiU$gq-DC$a!cp5mqUw
z6B!wIZw0|%!ZwDtZy_=@rH3}Cu29yE=QEL$SQv@!#Bh(8Xeksko<>uvrZI4{Ms3x#
zM;8{w8PaCWk!8_MH3q}2li?-fM455vRzo?s&8}wsu3M%&)mRFugzJUq&KFKRlU1%x
zwOArlaGB7KdIv=y+gysNvfMdDsaZq{2Ce2M6)90L%)o(7q>~K8Mgd@~B7zwxqC|qh
z07ZnrsL4!PQv!$ytSV6;1O!6{-~g~ga^*nKI3c-mpt=i}4a<#)XbceixB%RuAC)Q#
z+}{OZ`A{P09$Ysr1W<58a^OV+1UE0j1k!<m9JK-|z8K?`0w^I6!MG7a2!-XyP|$c`
zd2kD&5+MR4r6S155nxQwsEm}wfhAhfB?*d1nO!vrN=On@GgiivWuys`W-8d+W>EqY
z5*IOczAeor#O0vzf-h5y&g)(c^mDmrwKfMB-OG;|C9TXGvN_&O5vZn(#@E*bqLq#=
z?wojPuP<jVPELwz&&4t>4O}zP#qyYTdHH^1<iD6BCTL_uW`Gjks7Yu{<<>1&L&jg_
zjp7p7G@R}&TIn;>IuTbYR?{V^CMjy%woFh0mk!fFOWBOFHEVd{hHYz1qqcw&<(r)`
z<8;NDwE$-d3}u>V$Bss}s@2ehB~+2D8seQet=u?cmo$=8=e^Ww^&dGZ^&dIjb{>1&
zz0f9rgcjTJ1lHe(B*@8O9am>QUu4~#-9E|7kmPpaIGt6mpiON|0%2pIblHhSMJRUC
zpxQ985}q`w!L+D=9idSORG=IML8VY2DKQn61r4?D@I6!fjo0=@M!c{39;yCD>-#e*
zB}>`k7@{jGxuI2wfl(yLtN_)JO&|os;)Mh_Vpd`iDN@<aB@j{vO{*xD%#^AeHsKIy
zRDz40D_C0#NGg?W6Icm!Jqt$G(zK)%PD@MFmu{qjO(jO<m5FrpmLEf@$j)y}*F_WF
zmr1uonL3Kb7TUTT0;EctQgt`io2nHTt2)z-nh~^_E?rC5ae9SN@$-e%8~B9y%noaN
zk*7I@;pYW!+;krpQg<E3g7s3LDA%*ERS25LvSV9F=xY)VQi>N?ioviDDj*mDO5|cm
z?w=?DPp&&essmqFbyFGkGfG!2e)U~noDI>ds`Hpsox&~2UCIZHCY*}grV(Kshi4n^
zA~@{(bV6qF>|@!eMbbqQB#ea6frhN*5U(iPU3!RInI?3l?4`xbx%SOso@4Vqrajr6
z*BIz@gi#_FO-2@`;TnO|gA}0(Z08c$&P7x^WXNF42o&WpDKk+b10cj8&BTn=rwLR-
z46tU!ql1({GVEtcSUJQ6XCN+)nL9zWsbLwbVa;LznnVk%fMr8SP%{H60acM%KuIwq
zzzM8PVF0?s%77wFfhYyY5DHkD04PX-6uQU|0%m|2TTHE_0vX+GWL<HX<m_^GbilyP
zW<!&PMozexl1xox6isAS08EO&sG7)uQ8FM@sjP?uO=MOTQL7@dC^0f12AD#EW|2WN
zNCN{fFacGO048Vwrhpw6Vv+(bmQ%$dzq&c>lWA{BO6fx4$v!mNZ->>cFOi;3(KG9k
z(+*)(B#yfYo5ZZnS<p>LO{UAJB9)aZPv7MrkVmHx@!>5*fERA8P+_ZRQcC)%M`~xV
z<0WJTD5z#DT(a9De{h-4xmOweY4A0<O4x18mg1gXJRp!oDUx&fpdMY&bCQJvaIX0-
z5&Jt|UbM)b0%r7ya=)(4W2~>kUad)wd)v}{Xvw)&0<e^}p@mNe4O41?kRB>g;RJ-T
zyLGIZ+qQXxlSNz<`j)dy#w?Q?Px}48#XNfd04;yncV<$0-rr-yu8KlR&{Xey3Q(y$
zcHv4;K%vw;hSi9I=nl6)Dv&b54iQYZnme=c`!89)w@Nu!#YG1*G)F8@1oc->IDn?q
z@|B3C+yM$mR$RT(qMfsi^+eUzMeDD!F4PpJ+6M~Ouv(>R3U?~c)A`AwDqRD<Qc{}J
zyTcCIS93_p`W~x?Yk#VJy$B^pQ|d|xT}e+6@`6Cbp<I9@&_t{hw6v%d(6)j>p>*bZ
znPdSu`AqF=UF4hp0A%U8NvI977E_Oy5)`V6y@skIKS-<|1S$M366Yqi=u*hQw;%7g
z23w&tO+<;Qzr*>jt^IUcZn|{c-}ENq9x>f7DZ6l*Ad!!rvx(4gYyil>sIuchJ>)cA
zUPx6GrfsO&843U#B#O&>r`!6Ix5IUA_rKQ5btp>8_Guuv(v?~vHtE2EPA)2`0t-=E
zm)zx-lD<<fw^}0Iyxc0F8K_hbWPQtj*(LN`Cr^j?o3`_cWF$VThft(817M|YJimyt
zqH>@L03H!{7Y(4>Boz?q7V6ZHl=7NabsHlhpa8D<N$LIT@RDfP=J+Jt-ukj1b!$Z!
z2tv88ywa3Zq&C-ev5LE{n2%b>2xvKQpNRHs+pMJkCmU%U#44VV^BFDl{`2n*N$Pq}
zL^$IvB`uWWc!W4>i2J!$8shcSArSTAt=8FESxHN7T{@vo>b)$1mgbpOvHJTP_-%E6
zW4XG}rkrtatf^~KiWttS9+uh(87HdAsfc>w-L}vJt~mQ(t^6QYp0T=|r9e*96p*%l
zz6I;plK#rwO(BbGpi(g*EwhqIK(65#?_89q&rrNl$v_1u$d>VR^q^F3t;ydw{{YYa
zQs4ZY>ghcH0C(<T!c>gtDS@=+HaRGb{9^|eOAnzcprII-nyO7yYIp;Xjr2=;8rsE&
zW3{z8+GbiKy0(_mMtlWERoL;B9ff(*+bul+B-E`dCY8bw!d@%?0MR&qi4&6_%DlfN
zcRH?%X?ldG0(orQt^QM(i#*d>D2!R5JJONe>Qj=&EN#9yB>*m=!9}M9D0`&Ps<hsA
z%5VLQzw+lUr|e_D?s*T|M`BsOxPI{*&Qn(Ixp1lyw1i~S*_`>Rpz<@i?LsZC?QdOe
zw%BLg)02bZK7=|sVZcG|<N{JRGZQO~zmG)ETJ`;RYm<&=BH=8$@743w&YbP3DNr??
z$838wYOBkO%U)twb<@dh)C4+Bd-MPSM4lAdb;mheW>#s#E-Q=E^yXi)gcj;<+;u9%
ze{{0FwQ-e@w#s}C$L`K{^4?B(<sNSfF?Hm}L1~wZw=`C0QT#P#6`o}D5e2mr8V>UE
zAF7$G=FRnEj_P$?bXu)ew<^Zkf`XCgJGayy-79UeG;k*}jMlH#=nS1=-o09~Rx$Vs
zauV4oA4G+xn6CF7&xEt8N?k>>U@QQG`o^c&GMWA8pJ%dYjMAI9O53lpMJf$C%R7wT
z$w1mEVun!!4kw_b-z_@l1P+=Zd?fd4-v0pBSTmP%T}x}bL)ZG&Y)KR%rAKP)k>Dbf
z#b-gACA{nE$ib7aCpns}W6;^lXA#4=Ccj7Skx<)seq|2v@cN=d)lSLH*YJ)epT-i&
ztRYtlJ9ks({n2|SSJ8XqymQsAh)JgrKnGYSO<gtIoctpdpDCS*eq^Prcq_0ZpVmL!
z4A==3*<UF7qp!A0be61}S<nlQhJ*E$_Xsza%u>`(bvb$XOOIN!rjwJTXFI!6pTi&5
zDUqFggnESRPQr|li^KylptnEpnJHR??6K2a39chS-Sg;R^wr^cC%}F4o@<-06*#-C
zbUIt!Exhn^3Q7G%`)1OeNYxjNRGjeTnd!G3<}>RH*}guOnEch~eV<BNxv_CCCkeMz
zi`6R(t-51Ic(QRgs0>eL9v4=i+#$NMp@<{^hZBHN!U})W%CwAi)Ad$%?f865`%^CN
zmeTUt?bM|YVsYR(E!AjzD&0j3N{J+Q=t%n2fzn0Gh_yw+?cBNucOAkS4W}g)Fy<;$
zEFg*xrfa9`w^a1}KUQg-WhdC}_#UZ-?n8GWrx5F2^qWVU{ALi9kXt6SQdQ8z+lzD|
zcDC-3%}BaUuu<kv8oE;LGsddaaE*Q+;aB`RZ`1lF=VII5>YJj)PHLA6F9PQ|yOvT$
z7SP+sP9&NdZ(O>^46UZ_?o-@RO|U6J!-|SgEmYyD<%$EJ35|8X-&fc5`s&v83)V_f
zU25e4C~;V7Kye{JrD+)`3hhr&>l|AwIM~BPIL2#e;j1oTsUx|bE%JquYxUM0yQSaa
zJ*%p?Z7zVDf>c`<L0EnsF6)YFxK!(F^$!Tqr`uxp-2-nrU90J34W|Mt>PT2l>iXM*
z8|a(Y^4eMP>Go>lxwV=S^~MHoLy1$MA!=<jVay_{xB(;<94g>R5h0LSEIjH}X6ix-
zL(Vqhs+y<X9V*1K6}2d4)AN2Gi=S_oUDu}fJC$r+)NPo%LauDrZ*ud3-w;+HfNI^v
zcsMgg+3hFXlFF3&@TV3u+=gE6T%kD!FdCj?13K}ha_@7wC*S+J!s{NNA5!J$D^z^9
zsWj{E+bYnc+94y9tn+av)|b)8y|hKL*=5xhA93`lEiGXvK(<?XV|lD8!jeW#fI7?8
z_3V?RXD*k=*W%Y(-e~FeIiB<AD0KwjSEc0?)3`Bal{ZjFSk<Fq!mRB>t3h4EzspLA
zbwNo<D?ukLDNS&N11+2UDOs6oUm5DZo2~w;wk#U#<>Ph@Hf`)wl{sqK0SFZx<S#tU
zcN@z+M%UliYS~Uw=R1o)5|TNM@82n)3+YUzB>H)4(zTS|<MD3g^=A9lam!tGsB%ra
zX-lp$kd=HCrvXx^yp*M9=%=y+NxLs6l;VT89*df!a@a^v_;sdczf7rx^z~0)!E^Y|
z-^}sk-8R_3TXDpN6x9GFEQFdSmB~lt6Ds9{e6%p%KH`b@f=|I<AXEcN41ZJ!tNQ#-
zpYF`K+kahCS6>K*n8wh!UAY%H4=bD9T5)cMlszNs9qGnFU8bHFiPv4`EUjT~2OTv~
z$)qR}6Iu*}ea_SG{MOmMZ=u&OO+cS|#=-A-edJoI_4eDuaT9ZLkZ?AR@vCEqgSBb<
zvLC({%XJEIR_q}u<ykbKXi!uM=O39|B(vhW^6Pd@-jZ)$$$I0`3vF!un{SSC+<E1=
zzGK;d>b(F8fyznYB&oE~(xRsEVL&vk!iIdb3S^Y-PlTGXe1FsZR`xEkv*3M&wrb(h
z!q(+fhSVNPP>|E^aB$Y71n?k;6(ZrpILg<7$5fK~P^xm!eJwU=P*<^uJ||SmQ@8#X
zc=!H?Aw>t?-Ej%DX|q<a_uPK83dLHQnj{W2gALl;yv?~%N-b7{$pm0i!_$n@GSDSN
zeKP3VH>Xch?_2n#Eh(SG7~i{JIpdx|BB@WS@Q^7{)&|=6UtV6ig{iJm&9Y0VPbjjE
z^UtHZ-a(}g2{dnJ_xMG)>Q0|=3Lf|7)TEVLw^wQ^R_pXMG{yK}3M3vT2wtV?ErNMU
z3s}Z^YglaeUUgq10*3$;takl=x|{2y^!wlBy43rI#p0aOudY)605MlDILKH^v0J*~
z!+?xg2GR<TNtt<RwN=4IzRq(QXAdoI+<Y`B93+(#)RP^5fABxA+M1qN&xiM|?wYo{
zRJF<%L8Ua>o>};6Ljw}7QVBI7MuWx*-qbf{bk@oUW0h)XMj-2pFDbN;GEN-SPI152
z_y)S#Z+oJ=@mu`1ULN;>w{c;_;w;p>!htjjT|S6663X4Vy=auU;Wo%}i3MKnnoxk8
zkl7^S8^+F%)b)hj=q0hbyLrbufroA#OKpVwM4_g_QdXdALZVGc%Y;e|xkF7h_7y(J
zP)aC}w6?5IJ5ZgLqe(mMbeCA2ch(bbn^rCDTWLs94m!=c6NrZ&&2Fj6t2`v+OhTGk
z)}Bf*wB{wYP*d>MNUBrauXqmfr1ZVRd#k>kL_=)aARcI83w15DsvcvPR3&G6;m^uN
z<Bg`>OSoSpO|<231h}S)st85^Q|lmlrS$9ihxexUdLF$BC0PK4G?b*5T=h8M3Lt@s
zw8pH*gaBS3mI+giv{*{i<xthQZLpxH6ewI$@d}Qz9lu@A->IO>fT8A_Y`bvVftM3f
zmfKSM!Nn8mSZ<PCxN&SOIF^IXD3ylOg|f1&m9<Grcx#^+*uC|-n%OH;WmR=aCjyd{
zENs#!F`)w@tW~XIaVVU<-F&>eqrRqc*qnwVQ&|0e=k@;pb=^*dy5MyWdXj~fLWv};
z(S#o0;476O7vEaBYC@bH<T$DXw3OyD;ww-Ogj0H0kcS*wZ8%#YFRubkGxuZ0mCC72
zD+Kb8=OK^vR>JOX6;bfQk9gLbtPfz1PuEk>^(TJ6vs*a(_YPsiv@+6_N@sY|lyNw7
z-|E6zmXgzWRxv(;fa7!tZr-O0Sb)g*#GkK$KVOR5qR)u5Xd{%C)+uZjprv;iZ0;*u
z*IJF>L#x3=HP0n1hFL1h0H9jkR}ot8yb`BXv()I0Ta2Ni-Mh})`~`%1nn9@M)c1`&
zAn}O1QMgM>X()7{IJQCVj&mwJv}7xXffbIB{_30WX(w}rA4{&KDCZKVLeip@VCJbH
zub7f)gm4{TSu1Uud$RkvFt?pabGq}-r#3=qP!O_kMD_i2C$IVzblLXM{PiJaCFK<@
z7OkkQuviC}5TqativEED*(tYVDBwaZ*ju)NRdFlDQVRD9tQ!9S$)IO0RDLN%)*z=}
zLn4G6%V=((QoKNc!ODM<((VJP<YH|ud^U?fD+-otLg*dixvYOrfqxQDLTRo!$+dTo
zpwDuRKA;zcX&9Va#F`u#fzmZ}Hr=Ck_Q>aAQ{1GLsIsnVN|v|OcM2rXNq4W0>(IAT
z`JFtb{{W)Sw{=C@tKW0et}fK2tqrx0n7ZRyo)~i#$Y)geMt^7*EgLIqRbVFW;e;;@
z0u+?esYs?lI|+=w36}o=qgeD@dK1~3RkoX6@?FHjf(Co7W0rkfKh*G#`zvnP4F=fd
z61S<%0I3$_6sb++OpbAc{eM69YZ<6zdKO#vSXsAh=ykRV!f`Itm#U>YRhwZs_gb!1
z=?ulgji9y=fTWg?90^TIS=zJ$p?k~!0G2Z3)YCildN_TR&hIYY0WDZhD)F}*<~eNY
zi)GZQu-fa5kl9HX(vkvHWa3+ZVo_B#sjVirC)vj3YmCDz?AATsM-D7_=A@8Ii^Mpk
zlCl!>4mR>rRIDj`6dLzw8#vJ>b-b8QR|@fC?0K*KUqW3q#m%#=C6^Zd9BnVSvXk(S
zbtKf~^{GH(SKBF_{=PBi$>IM1_<t{ckD)rOlXhL^EC!TaLQ|3e#<Y=yx_GC7<0>1!
zRkDJ36FoDQUe7i;_`Y8!w#yFhqszhP5A{7oXe&rkTtKHc1#q_a)Jd&qk+_Yn5*}%8
zcM{z>%h*+8E}4}BJzM>Knc~aJK326Iea|1$$x(I}bh1gqpLcqGdw5F(*_<dL0c3!n
zPoyO7J%c%=(}}YSdo`hH3Ms*z9i~9^&x~__fwW*0DMN`Zr5h;mGHGZAw4*UlqQ6ks
zM5)|rM|Ct&&bb=@0Cbu*1*WLU8`Exs!Zy0PD16}tm8E=PEf!9TD>t2W4y9ufgLUR{
z03S~9HVbu4tCv6u(~i5V!)Z>sL!*-WR<lRF+1w|(ZW+Qyiet~Ui)6j0*gV)!EnKa&
z5-2;s8VsiRjy~*j9J8Z|_jFpa20ix>ZUfCrb;Ly8(TGHofMv!N<TR84;r&c(6*XwL
zPB2{iaGC+;c%LaK8-t-NB`K<R;{dl(r6dvLAPt`_XgEM3gNF#+w?%1}f#D@8hiO`y
z28!;ThxOqC-*I4*i}!g*D1Bm9K?QX1;Tzk&oLI9R2S`AN{N7uM3Qa_8yQLxIS7JW@
z0OKyuRf4XUOdwDg*@u!zso!Yy0N=FwD;oBg;t2StNhv&XmX`K4?{hcY9kYyW#)+0Q
zIbytl+h=W`TPqY&6hWO|+81WOm))lIq1<!TP7}1djB(|;r=HDSI&)#yaY?45F$<?;
zM7b3(Fj`x;kc77x36ZrqwnQzmW^yXP?%ZS|nHfx2)s16P2&Th{q*_K(ooeFgD>AC@
zE!2e^rG?G7c^)wd7MpW7tkS(B`};$fq}C=bc^SEj%Tkg^63y#e%2X#wQO_u~MVfd^
z8;w7`keW@iwYaOXnDIJkCuwwy?R01=t`fzqG>#IYH8C|}+?i<Am_XVDk*NS>iU{kM
z6iqY^2yoPb0VTNQ48ocMOHtBVkN}e0a+aV}1UDQ8pcD>Vams)V`Ekc805|2w9Jmoc
z<->B|MF*D;f&^23Tye{Q*`t0`amp|Ow<<a1KnDD%<COp#a-)t^fE#k-o?NI+skm-9
z<v@xDE+3ZwXdYLDJ_#vezz$qLE<r#;aQGltfdoTx;7}l#ToMEb0xptO(@0HZDrK!T
zwk}9gsSvX>BXTviEhWby7c(($O<b7RZY-FWR+R4~jYzj9Z35_=5La*1Wf--L>X~*-
zuR|C8aV{$or%ZbjvzA@U+>;_v1kG3gMm<wo`lO~yiH~#kn;1chV0Q%Pl`@W!bSGql
z!l4r*P>4by(1|FqVJQScVUmjiYm}7?q|(LORYt6@RE=Bao8ygf`Z@D<PFkl|sL4B-
z&~ZIbCJ+F&--sr+{6Qv0U6&Ic?x(Y#EZv;kPFb#Q+(#3tw)6?Dy#itmfx;$Cq)Jhn
zkb^FS2W-Tk$^px2h-|=xI7x{~hyb;Stf8Z3`s%5n>YwCpzp^np_If6$KmCU5`!fPw
z#q9B^6GMoZ6@VH=U<8>JfDlB)%0MA<7X(UHLC!)Ba)|?kNN+iswWJj@BuG^TXwpJW
zBosPr&>&E#0RG<XZS0~WWD_8YyR_EU-7ym?5~Bjlt1gjx!e49EC|hujF-H8@K6$|D
zA_2G4#zCu4M6v>bn7)M$kOQF5T|+?`%8M;PThgk^F{s`w%cpeP?WqGk6PaVQBO!`y
zowm%$)M5vWqGw)7r+e?3PbD_K3YAT3DL*u+wIy2>_fM2$H5Sy_<0@=6tnC8omHS|I
z$HR@PohEZklOrcG{{X1@#J`TGE;0<ohdMaLay^r1RWFRV#O_JeVT-xY(?loAD@7j+
z9|_VCR;*lA5PYDnTnS{sdLX0Mp2&`|rnLSiX)&5)nH4%ZD!TZ?=xusTxEMvo6SDf$
zVQ5J}qClDyD43FBlnO!4C9|9nL&i)?23SO;IZ261rG!F^lM;h92$UHHLQJqqQ9;Ti
zDky?$oJcvqp~EI6sbK*1KnlMQrvS(jh!&F)lL9E9$Vrq%E=6ELjMae9)S3}QiG-*H
z10YHPV8{><f(Z#QYzq<rfC`%^Kuu&o46URn<pn2l8r^JUT%3%?eT@4$Vcf&Hlad_D
zaLCQq6B1-dDAkbwCb2LGRb)zviL8ps0!)g)4Ir2SHHoYMR83$4rUn2jXqw7^Rbp!>
z1ql#<P>>7&RDl3Cdv(j{$~w{Qjoznf&;eC&5)RZ(W)}&%CRb6{=~l+yO|@lNl(shU
z&N{<I0GbRVAv)ndBx*)7znZ4f1{w+z`=YZWF;59QDt8I*3g!KLrg_4K$x1?%@{Xtb
zq%!EHGjs<X<)~$dl5qKf>R;-n1>cQQlY|c8Rzjrik(U$sOl6jm^=f0d)<2i|nmocB
zOO-22ZYaBS=&m;a*$6erAF4NmxnKmg7PX}e9A^muD{)?ustoC{6E=71wt9bZ%dK>q
z?I*+TlP<RU-{fwkIQw`VN4wglj#8$)r21MU8igq45IwNrrGlp(N-!iT#@XPNkD1jS
z*1iLPlf3&y)z;e9uJ^o|-0eSlhFyF(rMhWc9JYX`A(Q9?gPV&vk<dYmV-0X~aF-S<
zMs3pPsY_AabQC}`PmlB#$*oV`{nvB${`zp0cj>#BiVA?Dmt5#i)j--dP17wenCggQ
zmsP5PN=gE#(_tV3iPdLblE!7~mUR0rQuzJO!^u;QWZ(tFw}|n;H%RH!#?4&2fn{Z-
zTvbgrk%TI%qKLyynQV+_shZqp%csNa&BnE7S>Ijgk1U~Tx;0wRm8C5;TDYe@4W}{z
zNbf3xjBe{{KyQ%a4Pgr*<<Wlb(v24S0QEZR!3ip@0E=Yr`z7AVyZL_pzKhcJyZk;s
zVw`lfW|GD-u-Qu>g*a0AHF0Ygv!Nv*_(Zssl-jrp=;XMvhTBj|u1H8qd7uvPDyr4M
zRyU)q?2=2DUWZA)=kNvB)l{JiMmI}LB<7_miN|oTn$Z*|D74w0axK)B(gQ_z1Yi#-
z_f?3tl95VKcZeHC&2{~0sL!9}zuZAkFNV;UfGGg1sHGgWDMUH?&J=-BU8FLuf4sd^
zI@7l#ggBrDyH?2v#DV~zQh}tNzKhqc`ZeBdF1k;!PQQuHd&Mb0IFx~m4p{sKfC|j4
z)Tl(E#)=U|B_-nP=MzG-NvH|SbbO@mSv#FR1nJP$ML&4r7-@`H5D-;zw1Oz74S8cf
zRcZ;|GkH!aYEn`X6kDoIJA-wpbsvaMbm3UoYpuW0XTX=j9Jm;gP}{Ei!@%MQLu?Ev
zN2`eyjjq*l_`1ZR;q|J7028}u+lbyTbUi=0dO{z01*e=Mg~cl42(4F$(IHvy;Tm1O
zr&~@2kQ7`FDu%TP$b{D{DW-AL{0;OIweDl8t<F;Fswh6wXijxjK}yUV{7g;ziBb}w
zfR!n48juo@vFJ(Ow37Y_YLjLc*I1CSM<^*-iqz0$PXXZ?>IF+c0*0I6`HYvaqI)HM
z?%lW1(vzCqC^Xv%PxY*=?7Ph;w|X*E=Y2O74gGqJ>%v|+tm5H1?K8W@obPwA-7e)8
z?s61D-FGSiNyU<I=iQ;qk+6W&T;y6M_f+CaNdPoJSyIj%DCnXNQ>I2;l3DBN6CSrp
zOZL|Gr1~Al?#g&7(2DZbyKLU6B-WHA8Pc)HRkIpRrG?51_(REAU<EA<s;lNH${zR`
z6THRm*Y|6ECcFB6KL<&AbneezD`nJkca}#}*IRAYN*Lv-yL35KDI&O3rwwy;&IIRK
zVD-XNdhNx-KJK%L+#`xx{4toQQq2ga=3~BEThjjkFWtNOaNqT2cGSC$BemU`EZntd
zfE+>qC={x|RzN84TF%Ep(`@hGb5Xk?<ta+QgHG@Og}b)|*Dez`rhPlLgqGWXZ}e}b
zc<nRXo-yXSzhZS=FsQAdpqdpH&LWIk1rD>l?PE;ZX^%SkgH8n~IIMwju&(YNnQbJ`
zs%JmhE)vbgu=x5swYy(;ZB<TqjeJ$WLR?-8tCPy2QV)0k0N(x+ep}Mabvm&y(UyC?
z0Vx$Ajki5iczFpcDN!jw%WCu=F^!r{7VOIEh;3?59_oLLP4fAtyWMRWC&$OzHII0>
zO);NHoR?s*uTby=dkk9*d_;JIEiLHAD>3Q~>TtVVu~5ZcoOo+a?oo*oIn{X$$*h_Q
zsEkmA?rSm0Q(lSao~7=|Cml>uQS*BTiH}0kUaKdl$w)30a7t_Kh{kYXPUPn@y6V@d
zZ$Xh)%VUYl`{K0r@TE?xGJA+0oSlrXqR-5{Q`G6@C8m&oa!AX>^@F%tP@q%+BV?c7
zGv2If{#<lrWDPye`h`?|1M^Y+({mJnrx%)!+&BRjuSxrw^hwjL{f+vwuBihE{6+8j
zqx;}-8e==3>qwJzOs$<gYd>;cAOPBUW_(ObnG$&MiSbyOd=nvB&Xws9g;NZav8;P0
zG~p)`MI9>;+08;{BPUFI7@uj>=AbCh5Hs<EwovCG2cWN7_)O$w*}gvT!{&>Y6t?wL
zIJDs^K;S^2%dfUe#ST4eu%#3v1o!9_o<!}m#racipZ8lkJqNPaF1o8mIfx~!NI_S1
zr<z(qu{fbaQJ58#y`Q$axV1x6Z4EfrCCBQJwBR_KaAmSdp{DZVf8Xqr_h&sx_^w?m
zy3$y8oqV#g{k_Z9w@69~>uk_MQnZ7MEF~wnL{^xm!!|Cd4cb0$O78hfqAn1W2GFn#
zQc(69sWjfRc+S3`55)9iETocX*IxS_^xP@iYsOZ9<1SpACfj5NUSZS%n|G<+3Q#o}
z?qZvL=9Ho>f=cZexO)n~xI^vyGM3xgfFx!FYk#+Yj9$IJ@J&vMuFBRB=t)TTh7ws_
zvhbjrl!ZL3D;SBb4$7ydl3ETb-s6*U=u$NMgnQGDVqZ14mN~hMRLi`OW_s`M-|WAw
zHMu8VzXH$bc;c@pmU)d5mX^Y=fTPI1NbciK+_ee<OiI#j+FBe-3HOw;)ykTnAeNFv
z%@hq1PfW~~_g=q$*P%WqW2<)VE_C~Mo(i$MN>j|`)bd{nqKbuk?JZf9^fEMyi_v5k
zdXxuHwOhRMC|hu&@ZC_Q0eLj28&*wk@%XRz{{TPKE$Wo@x7@w9VXNlt`G{C9w3GtE
z){)(PfHp|qb4gZP)|%8DV$rKKS)!$@hspPbYM;Zx2m~zpa+k}0ujbCO->>+7qImf3
z#;#LKaO-Wlo0G{4P9WmIASL2zo?m){9?BG<5x2NGacgjeG=x>ehXP7ygyO9UP(Kp6
zicL(lJ%8KoOfs{-?#-L&{R^D(6_;0R_-VUNLoU_pVA7S#X=m}6bp=FsvnT?PiPDmW
zQlWU0%Wy5niUta#W}%fq2QBxBfAju}IQoAmYwn(ReS~S-r>>kpWw*IhRk2A*RzdEl
z4k>bk_kqidQgo(qC*z!Lo@a1`EiF283Q!fQ>yeGGg4s3v+4K7gYjN)^msxFL!h6VB
z`~{$Qg$8&?ubGf6+h<mBEI&p2x*U0$rx7NY2~{hZ>k{wb)BDd3rN>?S9(%*A4c5}d
z>TVhb1<L*?0D@fkRz-H=VX&o6seIHw%Tl?>O$xzCBqE#$q-(0_XIxG8^!OSk;r?@$
z_6&DWvMz4kDowa^38+9OuCJo2Kx2zrmX&DJ&a5<!SaE4sPr*qv2~ug6GfEiQ4SauM
z_vi@ItsA~xq=p{3zAYsl@}(~jMMe~$V!+uadM31vZyaqnn{}X+zVmj;S1>jz;!R)5
zgyKz7fHMTiu8VG`>-rnFr%02n>3a~@F)3Mj)Zhuk@%%J0IJT98-cpSRj74yvDSFjy
zoF&z^veKEx6cKH1w=kNo84ITQXCJS`>~E>x*YF)>y96Ch{GchesM0gS!VXQPun&31
z6+pASC3iaB`sGS}NPWF6#2~s5Nmi)o!UrV$H6f&uYlfLtJwK9s-yg%$&&504M!z)F
z*MH<Y*H@MrL2+SMI*YD`t%V2=UfpEcaD(V!x~!fQhPP7Rx-KHoD{jo2dldqb>-P`j
z{nZG<8%lB+Wi0sr0C6no{w(_ai#5{T{cqdsXr@(S#kQP<I;)q<jB~s7QmKma@SJt4
zY3??BV}$cA?ye|{bb#V)ET2k{rG^plE}dB*q*j<sDJN~OuKxh5Q?}Ezlds01O)K3w
zDJpFXNNB9{F`~_*Qc^Mco?c2mF|)TUzF*axzT_pkDb~`IxGnVCRZyX}%5zo2wC@g*
zNw3|19^Q*}z5G9#NoPq8RKRr(q4rx+UrTDbY%OcR%S3V*!;k$#nv({@iEaM?d1lCR
z-)&l&-BXlUbf*QYYf7>N*0>0#glq5kAHVEx?0R?m3fn485UK=w$a;;XK@6=Z_)H`v
zRG{5e+Bap<Xw9P!T)NB8ytb9gN>;aS?t9J?MC69r7<?-prTd$jUys2hFWRNd3T3xc
zwcKMB9M=?R^Q%rTLv8m`uBKwEQ0ju4YTk=-$(5Qpiq)VN^3)UvNLuJCNf*CfwK^Z0
zw)g5K!;1<_Y<Eu~poi$9$YIs@vMSBj2sH464j~HngcQ1!wO?^{RYLADVYa0J<)k1L
zP)F<U59|9Aw)=gHE$Q${Tg$q6#HqehXO!AdniN_zJL9@Xeb*={(nD?gnr<28uv}Wu
z@^CB!zjaEygr8OxvdXeA>+m~C_dacP>=G^?Q0J7~scs|P*2`(-rG&cS!Gv`~X{yhR
z&7s!Nye_;P7}JgCF*fccbDdg28Ko(sW6D3L*#7?j!@BFQ_oqVc6n*fplr0>_g&r!z
z+icqL!cXEmQequaAGo%4EF}nWE?flH;*wGl+K&XYM4IKsPM@#3_5F4|Hg@$A>D8*u
zZnsn^ZI5+Qfm)KMlxpj!CYb;!QIu%=RCP*Ijt2`NcPA1`R-&3)u*F3<6G7Ha->>9;
zp*pE!n!Zw!aZx;_Ey|?2Pyl(*nu=DP)5Jiln3qze2VA&A42L;{VKoM}$N*Ck{%$aT
zFV|Dh^ypfHj+TROC9vzf#j=LLb=y>Aj7r@iwai4VYGgX)65EBA?a<P2sD&Q!WDqJj
zb@s-uPuEkTe}eZBWv7<vLWw15wr74)ioHo0)ZsOzaV=c56Ku;!#;ir)l>h@+a#FV4
zN(8~#Cqq}cOJo<XkjX;1X=c<UV);|v6)N=oYDu?35Eby!@mk$^3&aqRr3$TX5lVru
zuSn6`eg5RVi@lNfNJ?4wR_PR5NKJW*T8#ou;VIgpHx~wt@(`xeg$O}PtB(=yDJ0h<
zm_HKTcQ5rnX(V10l&cL&m&&dXT0r<)oQwss*vEazdE|23z@_8vCG})iN@fnx2zm!>
zs^M0_ZUWNEQ1U=dZR2pBR!24A-Vq8ba)qR&JkDddSB2H#I8afZ$|9sh{f|%9gVe4;
z$8@9wC2F|9wYgjkBp@X`kfjk+(}x%$>Z;3bGN;^iF1p**9F#bPlG`d97XjR#Y<{Qv
zpC3cMhD(b}jW(rnxq#QY6?J}7@RaB3B7+!+eU~m2;~~JnQwU|7rbzdtsOIv}X+)qJ
zj_3kAd_U0Y9U)g&D7SMqmCd+y(uUJelIj|w+_+V9K>2HxAa8I6UQ>${ES8kou$LEz
zU>KE3)n_`0zt{af$LnNS)Qh#chZNa4A#JqVDNYuHZKkTiLChLtV{Jj(lH0{@q@=r#
z4pm_w;pGEN^32TM-{NJ{_22HW$5!@n-K$ois`jH#v9%bM+hx!*!r4BOuP!y0`Zk`1
zudekc1zxxzAfJ`A@E&uXc}#Za$(HkU<KxSdDI|LRpA7Kds>4pSa@x|_4pW%ZVI-!s
z2aXa=XnIx`ncbSpmu_~P9@cU9>h$A+K%tP@ftudg+cIi3l+eLgU|difW!p8KZM<Oo
z<VI!LsgoOH#=7{Ia#E_s?>(0DSypXh8K(4SdNZsQ?Z6pv=_Myxm$AuwakTo?!0oDW
zry5YCsHE(y=m*kbkQ1ldp=nn!BbFR&BNsThcNu@Dxt@=2y*hE@<BWXof2o_7xa7RN
zlw#IRw&LAOIL~-xLK0L`I*Mf)KX|tRN|v>yj7>BRD4^h}RVlz_G<B{mc<O*_aI&QL
zLYAO`pL7m8@r$=;2XQOB8%<3%U3O2EWLTbtU4vUeXsYw&@XzTP!#YCRQRSry;Z7bN
za%rk0GQw1>(UoW`B&}#Y?Y7HrIfAIM(~wI`O4C5m4hm!l+kP;1Y8OSMRN)C$#+Cl*
zVs{S8{{Xb$(d@JC(2iTItsw86bFYkFZQD!Tk<?mw9Ly}@LX*FBSrg?tVS2NL>dz--
z&UATyH=3+z%Zv(NLL1wF%5)r*bu6lYtY^Fu9XKn31W_=xjTNOUoI_59ELA%|XxPf+
zss8{0653GXia7}>K(op!$jM4jMj8spwNSJ>iR9BTH<=0y9jbVL8JpO>S9>Qzkk}%=
zl@IHjLsw1Ylex<g+D)2kNw_#dUs3|I!_o^7w_Q@K&-MBvu&8uf30O6t90%@@%Y@ZR
zqK!V7MN{NF18Jg&2WZ_2TbNR+1j>jbTCx6fraH+uia{X9*5R~y9Eg@(R7|Io(!A-5
zbz9sirFxK}lkAq=q|^P=SyIwFu4nC?E!<}dyj<~`x@$T4lWv~qi?$unC<j*Qinkew
z6+@<kBPf}%YQ!lb6)2fjrAgR~Ft{Yp*3)Kpc45?#1a?GDinpsfbC>p*E0lk$G$=@k
zNSQ+=78Iz^$#Ex`Wg;i2jIfIB32nl%p%x^t2EsWF)?I*VSdUY0SfChtxvtW~-A#6d
z0~A~MO9b0^NE9>-N1T`l8wRNy@}o)s2I0AMgaEm4*d;&+A{aNFWk3s+90WjUH!Z`K
z;1u7N56gix0n3NwzyR{$`EU!|4qS1|ffV1D56gq9C>*GMSb+^2^5OY#ihy$A!*EqV
zIdQ>m1r7Oez-|qx4Y_g0E)W304a<rEI3Wr|il`PCLL^-&u!>;_kz)2_A|yKE8{EmJ
zw7WtV8^3f_T1g{P6)s72#3PJqqNSN6XtkSJ>ymbmEtIJ=t8!;l-D*;g80=dm5H8It
z-eqMm<<cmLXL2)pE?tz)rvj-a>(@6s6SJK!aON_IG>8COe_YnSxtxrb9_BsP)~Wbn
z63sPkVwKku5fGR}rb;ytDNI^K%Cv;xi=={qC}kF;%c2OR)rYIw6|1I&UfH}19QhZO
zNUhA3dXJpwIQp7IhyYuESecJllOn7msO;g*F+H0-<j#4SyKyHIt+w<DHp93kBD$dH
znK2XuM96^wP-G@p0L_?`8bF555@Hgl5p*yy0aA#dYiIt8ss8|xy8g(->u3Ipss8|y
zy8g((l&>4CiKTHGX#i=U2F^h;h^-P;0ED<=R%L=wDBeSRzz0ojGdoF2)F8<c1kDx&
zi2%R?qC!jnIyQq!=^zIH(hD76DhwA$AYcK*rU@#52j(8ISfByJvAA4{2SVVDjBXZU
ziXJBIz<owE=2Ae|vS(9yA2hD#7#C>0V_aAiGL;V=vMTu^=HmFiDJszNy3E+tmuPb1
zK~QOYjx!cDV#;jmO97XCuuWW0)J(;(sbenFNWMZ^0GZ5NYVNl|S*&Y4V|&{>b=SA3
zQ*;M}=LWINPG)N>(TkHwDlf6Sby1kCAG~676qGM?Ug)iW5!N)*@56K?&En2CP5LI?
z6-6a$da6$uwDMHh`jr}{{R@>gq&Y&ff@$;<yr}_T!l3Qe4;iRJhiNehGKf*qs5Gi-
z5dp%W!lfco!NQ<|;6QYmm^7<61v_ZOG_9qCOV~IDB_>e;0f+_w873eqR6tN-L6rci
z#MV?)F0mDbP(WfqkOIMp22=q-i3U_auw+&R1WZUU0F{Xl0acLzGLBLgv{I2xE{;Yf
z>x{;IlRnMjU})jaCBvNMkzFw&41#7w8bk_-tcgWL)<hzrVrwX<Q8Ft6q6wJ52qtI&
zt0Dj@vIKMhpkiPG!H^&Vq*eh+tVl2*SedY;sVP9jr4SO4xhG)=4ui28emCB|P{{+9
z--$b)WV_HTMw6wo($9SN*Wjgaop@)fSbkhs<-Ih{f1e}NpbXCNE?g$ARY^iq*EzN>
zY_~A%Q}2ZLQ(BS%JuCcU72hPaQjE&*R}}yUVth{ta>>r}COEoybuQ}Vc(5aN91ZXP
z02<DJDB3eGfbzSIfPl1$97-uj#YGdgBQ9C7<<`{03EsEk(j2KRlrUGz<+iG}R-!Sv
zwklUXFeoX!VW+uhLX@15x*JX`!2M%Q<w<5zR(?9~f4QxAZWnSJ4y35472?35iDscW
zxJReEvML}}a5&?f=iBC<YLJ>5w9vwqQ<rrmS*-Dvruwrtu9{tR?YL8~DXKWKzDg~s
zmei75F5;qGbd1WJJ12mEb!fad7OHjDi(HGl#}Wb%?ke(-mC}Sa#0}-&OVOLwf2wMJ
z`|J2FJDE$Z`bZteDNKajpgDm^xP1yL!mF*&4tb@tQ@gcbwR4giNv%#It|}+yK4Ow*
zo;XgfUgGV(E-bln{J(_!9<S`|B)1|LeEaSdAmA0LUlZgu6yee(4N<W#*0qgvTs@8$
z$ujF+pHg1EQcf(Eu!S}pAY)2Z>Y}$8xb=a#P7rG~^=qD89A~lPzi(Hk5SOi7TY4~x
zB`xFt?jvOV=RM;q%23UHe75Clh5pasv-{qiEUi0M!^JE(wOXx9z+A2*wQrh;Zn^Uo
zqH!v77a&y6MjZ0I+kD=CVV51bPt8BSZ=sZTR?aC_?mC2W+c>Dg6^-DhJFTfsR-&j*
zGCXG+r1pyQOI<M+8pIS(qh9b73h|)YduLhS_j$Pavd5$2*(KMj=yUr#IVR-Qb(aZY
z>t|R({t2bKjy6e3xmlLep6XHWE3B>3H8fnb<E<$qAr1!^$uw^nT|oZ;#dS)iFA3<k
zU75p@XC4e^^>pUpyjNHHiKx9%f{O<NP-{>U>Oi9{(`2PI#Cphj+4mfIN=a!UrjpVL
z3PVb8a~)EvvZ|^}zt`AeMd)OU#klfZqOvPe8#O9*Zm5iE&xXnH5u>X%?giHg!f;b|
z%88*q&7-;7_1!F5d2+OK7L~Y;QzWhR0%_eyrBppexdiPiT)abet8ER36z6q3&q@aB
zaQ$MVQY$aTHzNyoP3|rOj69ST;BzugDl*cJz}Izj=>c<c6oA^+tO|0t8x#w}ky-QL
zI7RLH>Xx3pO?5WZLc)RyMiH1!bWT|T?A`+A<!M^#LX%TTnw4VC#yY*|vb0;HA_sJM
z^zxM*r@b!%K1BWJ!dcd@9O{>(GrbDz7NKu*+pRkK;i82$qf&xOcF58*`#w%C)7z;+
zsTHs8`{v~FGVK`Ooz{##YW7Rp*0r5&oj8|8s|JqpiAtThE%OrCR{)WiF^!VYj?mq>
zuHbO9coUGS6xeCnbSX_q=`FJ^iR=8A$HyC5zbe(h#hVt*+6LQ72RUswS~$`ZLyJ1%
zbBH^W1pCaP(1keK97@|+Kt?B2cG!QW5ufQzWv$Mhy5GSoILmjor)s3_v$qJicIYiD
zq8Vik;izW;9p!ihWJ!&CTXg01(>i+&I1>8Lys(7PNoAi%TB+(hOvf*+{r><HE#LL@
zUMV{hSk3<cK=hl7mh7xwS)!Y*1t>5tHB@n@NYh@`j)kB*dgDk~YYqw#g=+$dNc|JP
zS($8IdPcI>SeD7v&HbwOmg@5J`Fb3yeF3Q=yRXD>6O#AUUthg>bW~Clr`}R`t!j`u
z3eszid0p1z)YNA?<ByDE&&w^P@NFAHRg&D!pEWwbKC<hIdF3jr?`P@>;g<k-MC(>`
zE%A|?chq5<3nOZTsQ7dqCyW3pS_+4CBP6GQukn-BSA7}X3H1jRhor%>r$>=9Q8&??
zy4BY58KH$Ob+6DN5`YSNBz^RgE8Q(?8PTj^jlzPSDFZ5)hXT2ZBdIfZ_FQ{8XY(ds
zH6ckL(i;F-Pl(_mCuFg%;3XK81qrU-*Q9WyAq}VulyWDHKChoyuSR!R*H-lbUIdVo
z=S|hr_<2n31ouX2@ZsSvax;2#ERiiVryW2USC0TXm{!w)kdi2OQR7IxBR2Ihme}4n
z>l2P*SxM#7ERugUd7crebgf<-Ka8E)UFtKwrKsaoPJDm$iLFF>3wqt69#L?BHXnSD
zoGGtg$|pd*O>`w|q6gjLVBA$tfY@}6DqGPiE0qjQd%_e;+_tu)$jM?#Ud>{Yxx;>>
zpQdE&pE{X}I%BeW3eh3Zuhz;!yQ*)>zkJSJi|W=LGCmH0MGCTIb*h5X*JIbp2?{~c
z*F)a`D5ja@cdX`myWYA#>m9FTvI$#@=OLvw+h|or7TnEL`pP8jz((DVTgYj*ad#I`
zO6XZg<)oD$eROVP6CVEnt(lo!$8l!Xqx`Ds-rn_f=Q?dvwy~{;O3I63xv2;qm<v*u
z)1}_EcJ;}(aW@S*()meor?Od6K4hg;Iq;kKe!3*T_;Z@Mb&F^0e{|S+Eox1r4ZZFv
z<XtUmWo6Q$Tx6o7B5Fl;tc#+%rv<C7uH{H#=FF9Zr3!eCXS_5Bp&=>&5z<>PukSy^
z_<p}?OWu9bbo69|BKg!hq?HGd3kgz*t=magEayN1)JPm;HrsAErGzTvIIShuX-;S%
zrtr9>fn2!9>u0aS`7ZweFJpH7hHC9<x4BJ|qVD$4+qB{eR219dic4z%j7{L670R(%
zYfDb5hYlWVi)#yvpmOdg!cyRLfts0BXipIxKVp8qDfq4J*<oVkqMy38Z4Wk*<4-oH
z)J?7O-96@;=u)GEc!&)?!;@?|ZeFE^kl<|&=kDrd(x(Zit|e#7JTjNR`p-g3Z>RdR
zZJ(~iJ8_WZr!D+gIZ92!s;**GpTokSb0E<qju8#Cv^#9dpL8->HdgiTqTwoU8<%fa
zX9%bjm)C#O;7<Pl;BWe!q0+f;w$-zUcq-qKs5lXlE|k?Up+E5oc*IzhId<~g0U^O{
z$ZXJ-8f5`p{(*F;mvdiYdb6vxuVcm(+nj@NpaX34oVHbYfLtpPQ-FHNtuu&iIiNV(
zEUt_)O>sC7<q2&>_1QA|AKuU5{a5!RO?Kv#zgklGQTLa9EV_cPf|~3KMKY4w6LV&?
zh8Srs1iIT!s}RJ>fGT*`A;uy7Qz`z(sciexcZ#_!S^Lw9Z5O2qCk3(-R21j<ilD+F
zKxNn5SZTDlm0LPmM|n@ADL5Tb{ayk+e~?);o|^vf6u`!nGJwZ9i?<%Qp+k%%#3*wd
zA2QN297M+Hwr-ng#V+HTo2%xQ?nq@cBb4&`8q*2kC+qPq;Jf(##;@RFl(TuJT(@TT
zy)md;*d?3w6=8iA?x&g;of2tKHk!!@a>OuQZpB4biM+LF4|lXjFeqRf0O<m>>m4NN
z{{V#A?{-_$UW=pUGjDc_RXWn2#d7WSuQ-s^la}p}gu7Evk24!-_o%;O{l`bRrCOOw
z%-jkz<*f^1n7uskd%iPXp9J*&Rh{*{z8CJ-S$k}IHdAEP!EL1buxVFLAuIQWm#7tf
zDpaziU`FDGhhZBf59wBSgz5I>>uyc0ow&Hd#nMZuEQJhR+y}i+nv(R_>#~0PX3K2r
z{?V;&{{VeDL3M`RNqF42g(+>gmeS1}UAw26uz)covrNu#cJ}uTB`n-B)x(N?@cqbh
z14kPRTctoBLU4ou<5=mg+WmGrPU)+1o{+X%zO(FY%o=`<(upqnwY@4`akaguTr8os
zQVOet;wtt;+PuZ%R!dSXdGvEpx<jM5*+p5jaU}Oh#-T`_r}h1JF8sYa{{V9J?R$2E
zU}ncoHc4gRpMzklc9fxl;^^XeVZuo?8>+HUg;Zfpt@13JSaBgmF1e^&5DG!B%Go4F
z{{4PG6Mu|Ozc)qI*Ta9vTh`DR<Z{6Hjaey8<0M(z{6a|z%_U$Y^(G?aO(8Eei5AQj
zo6~KcX+=*V*XpMdPI=`(W2bND@i)K5bxynA?n$q|t6ea{o?*AG-E}WC?xk?PV)<<w
zQHIsBF;~1!Nvu+>i)1vH7PKYnR*PT-Jj+a_Ma*iYR<|-V;V<r=ud+<9UY}#F?r-l7
z033gq%WS2U^YEy?i<`Cg&~Xw%18D#s86_`a34N8mmmhxW<;Sp>6Ksy<qif4@;oG2(
z>A&WEwoiohUfq7lxevG&+MZRJQk9Zg=ex-6^1v#t5a|k1qWR7=!qe|HxUp@1{DdVx
z9^&MF&d4NZ%WRWDAGE*RwK^WV*LGW%%J)?VZEfA=o13771*ywcTfo>?)hlwKo)NoD
ze0Nfo`6^R(R%ltng=j%j_d{+3iitkm;r;&r;A(YWMz|qvwxzPB-fg!O0#vmo+UoIi
zLJ$J8Qrk`<cttHtxTmfX<4lXIwYb~c8+Mp)mY2vo*0@kkRgLxUzw|YK+v0T6B{z(g
z-U(ByQx2xp;PpZoN?Qn448?J{to)!~ZM3Zx$_l!}Zq_sbg$*|ArDEyT55#z$@Es!m
z0OMY!zi-!K?`yw_VJc0#mX4CL5}OBZXmL8SqUdG1W)RzC1ra9Wn3mKrlu;K8X5^(I
zGzv-*R4MCS4tvri_<kqrN9rBGT2l4OM<FV02@YxDc<2_u<+$Se-jq|hUH6H)akty$
zd%{p1UA?n`38LzTgN~sG<-}A8J~8|LCH;O0*?V_Qx*O+PlovUTDNh_+!_G|#l=8FK
zDMc-V(m{6NExecRRN5J56WpK+fu*XJ?bHh7k>2YcALdW8c97}cL|e9otXNxZTqQ2u
zI_X-C72a9I^6R!8k~&9kCFJ14f%h4=L031r(Jp!oKU972FJ0cLI+B+0IN{9+6<S=(
zd?vEazg<;`e7c6NR29$W@|eKlu!mg+t5OF9XOw=yzQ($>!i~+k5~iq?4p6nN4kdT7
zEkcAOq=IBPL#ucpw%S6OETpA)+<9sgbR^g16bV-W9nJ6KKfviJ(i_{^fb$DRB8E!b
zZrud(+(VwK8v0xGr^*#prqm+YlH*Mx-3=iXtHUjU@!e8uzw=+$*=;4*)^@ET-IRwA
zwuR3=<*=eul=_m5>xfspA{ynetVjbA5zh@}RT@y^JZrroPNz@sOTMeuT~FU>kosP5
zHhEmGUBya^WE@LI^un6)jOv?}G}AaAN#(VA72Rztx^XX;^_@v1D97tb`u);&(Yw^`
z_ZbDJfOUV0;|Vyhr4A;labmuqTKUH3n3f%X`IDF(SQg4s07DF`xRwx#W~0>0e{X@V
zzv2EQ?e;h6qF0K~PHBN~h8s^N(TjzGU*$MPCsAC%Q8XMP?!!pB7VZ*Uxov1dR04=i
zy-FP_*|a8{DN`MPe)f7A>2CWI<K1!enzyT6IO}h+!?x{Pt=Dbs!BFOs5YTbVM}e(C
zCyWw8dCx5YX-lgPlr2SMFAWr|MyI_c?eYHr2R=;q)BDUNy`H`wZ{d#bb8E1>qLh@7
zoY%}5cZ#-Bc&eEaVP7B|B3$y5AMkR@xp8o1mQ$nI$BD3`ecqc$x=Bib8yU|l)}~I}
zILVBM9V?h=2A!hRbkrqJyp(SQ^$d9;`0Zgv<x4xj7ZQ;!=uBh>=Vh6d_gBHNbCY49
zdz++ybCk)rdj98>-D$dy1gEKnxbVx9DIziMIq~Ac+I?$m{-bcEpc0mWSvm0GmmZS#
z-pRcclR^Uh&6VMxDRpJUpQfL5*9RTTE&4rNd~=T-M<0FeG2_DH>t8#cpDujuzY&)I
z04z0$6j*E&VaNopx}u@fMO-B-#7YXBD+9VJDxpwPdMAjN&||%~?uO`T1SbU?!b&sT
zri7?0btBSYTDRn(#ehPVl7ol}xZuny^gxAOrMn3sDR3wzi3w700hp#>o~E%kkAyO{
zA>8Vka5%v4SEwT)33@`T?rnc~kSGc{iu$7@`S`|H&htuDgbMK=*XfH{sUt)zgpB*Z
z@8jVRtZEs3F+e`CqfLw{QZX8UNyUeZMxK?GAxo;2-|in#NKX!sfG=oNmFQZU&Ju?$
z7KTtaBZ`l<F5$M<r(dXm5^UVdaDkmb@tVf<NSC!M#@tFq1Psp_ctW__Xyz#y)Tmd(
z5uJ(I#cz5Nt`UZjBG@nb{qQEu7TeqsCgotR4S?PSMr)dtDSS9cLdr&Fwa5?OAfan{
z(}buI(kQL6q~asHv?Ue{)+K_aS0N*qDUt4-{A8gQpsa+cAxjh-ARfBqr71|nc=QoX
z5Z;cQNL><uO1~(JYlH;iR_7t(BrFL|tdtuHK~+eJWyTZ=Roy>-vMJSZIvrT!b;T`e
z2?HdjkC}sI1urKJRbG*F0s0hD=JI(tesF-T?QOaqX}g4qlo}|<nuAGt#n!37(p)=}
zyiEHqqK?@e!7~*|r%a}XL(636HL=bp2kfRU-)N$sfiYn+X;dVpFASQ7l{OJfAxvp>
zBBxV9p^h~a2?g{v=bT{UCOldOA}J~}>ZWNJ3?uCnnvJC;K;qe9W5zePSxJ;#qRq65
zMB6)z2%^An$S|!?$XKXHC&C{D3!vDu;T#mefvIXZQXxVbmf?ydPyiwy1d%`>jNx!d
zpdJWZ8OWd)E*k`NI)FU5Y!Rp%0_DSCfC1&hVUPfMaM)mg2}CXkPzwYxM1W9vaJVAC
zSQjiqghqha9JpecGz0{<3R5FWn*#(XOv<Wk6(T9cAp)exx>N;8fw;UICKY$l65`U0
z%wp@SS&>bq#eVZ}BXqLkhiK5dK-_U_G1@Hxb1)k;Xp42OJ-`zRn%bMD*$DB5DKaUk
z0F)y6b$|dVsfXo2i=#WV9$Y=^Ukb9r7IN&lIm^LEWZ#NCI!?sw<(G3V;7EZ4%>WB%
zJK{~4_=0C6CC9msb?u5i6fT~MvoT8RiHTtlxMUg$35yAlNE3!H42q~4lL%9kid9hS
z0+^z;uzTLwybK(<PE`W^N6te1N6u_=8bkmky)lWc{bEX0oy>c>e$D!mH)i)t=b4kY
z5^?R<TKWWwQ}D#d=}K^!kYx&#M9i3r1T0J-0)dbW04hvMOaVm-kPN6K16oydeMEoz
z9nbb=BU(T7eMkJA&-P|ey^8V)6`LGH#J~xxipGH$$gB#RK@$@I5TPMPvWOJW&PzfH
zEICHgCuy1}Sdb(XEExd6Az;V`1wj&GL4X8Fi3SA)3WExfQ%Wu<fT<M}yiqlfs1^)>
zU{ov^n!uq&Mj`+#XCW{MA`F0J6d5KZCIA&GiA(@835iOnAfUlSae~Dng*Xq902ec*
zHXRF<2-_T*RoWgV@nhyOpEi<dbf~jyQ*}ILXnJL>F41_-uyW2*w(;vTy0$ekM@em~
z0(X>*zC@EU#<t6@v(-~iROXt!Q-3j<$2K(EF4o^sO1O#2v8}1PRL;{UDV2>f?OJ^c
z<2mg=T|(*Jow2)f!!oO;1~aq1OSI0jvSV3W4}zis=7v;Mn1m{(06S#u63V5C5|rg8
zAS!4;P^f^Y0AOMgs2~aqKvV!FVlhAhRwA$(1O_A+5kv+hCInGLNHu{1#DHLn0R(_x
z0>pq|0^|ii48Kf;p6r6kLp!6qi>@;qotKldc$gVEyvv+vU2!2bkZU3XWg=7r$TESn
z)<gi+ksxT=W|RgqKnRlnG|+&NB2W`F0FfX-37A3yL+SRW_VJ5w3b~FYBoC{{?v#^s
zH>LjoV>BcL{{S?(72$4={{X2^%3P_mFw=JJE0!6;5;)Ls@iTa1uC;9RXOj9tUsBz>
zMmEq=w3iC75Gp&Oq@OsJnq4VebyC${G$U^V7d;*~Nsb*hw!>p`mq1uaLR6xfA5o^q
z$2hexr6Ck=4KXH%i6_<ICVaNO6|HGJrs<P~^@W9;XEy}~A4%io9fUGpuP_mZmxG6i
zobKE4o=%fnbKYJi1+}Hnv}TKhoU4-6N)SAF$9GnYuav`eNo`?iJX=r9Pl25O0AGW7
zV>>!;`<TZ&*56ZmR~<tkDX(;tb@qA3tT4tGRuG^Td!=7BGOB#c&OMu$#<J^n#me-C
zVf8lR)Ui~QVm>taKSZ73t{Xy7tU#owrL^U_JD(sonBJPW#_l_bj$KVs?c0{cq8WL`
zTsM>EjI`Q~NIVV^>590vN&uq4!`u}WN{0B4T&f3*&i4z7*{rwMQWGti>aL~7opF^1
zTW#)FF+P%@2Xr3@SK7vc(z#a6nmJs88fhD-q-?dTjOFeooioSF8$Vlm{{XYI#?Kql
zy!<?ui;`tGmt6vf#th?kR1;bnjlt?T8N<t?IrO$ZoX4rdm!2|{cJ3<1w=Yt;##M`3
z#x)_G^R%o5(}7iz)Y{3>t#mbT<B|$%H4;}mqgg{|ju?yQ1}X_s*E<^5Mz+7Wu(?IU
z3ZjspY4WO^6gY_4P60Y$oyP7lD~C50Jeb*IrN!Fm7h>;8H(;est@XH|wHiG8q|rEj
zqe7J7InK-L2x{QjJfq8S(LGWRs3)O0XFYh|EI0a&Uf+}cxAuI#Y%d=z$I<Hd-rson
z<NL04hScggVGVOF&=m69ABd&qiutCH_XVU}-gld6)HZIM1QL^ry2=lVQUyfqe_vz2
z-)|D?-8tWS4Xr77V+qY8^|)8S9uOMSYh`Q0Q$-&5+Yt4N_!`n?)X39X2KwwJ(uF4w
zZ8TL6rE1Lm@~P*I6-5(LYDvtVv3s+$otH+s?y@Yc+;+PPBymwYN*>X=<->uU(vyhz
znW>J~1h+|&=UL?H9h%bbS_8fmhXCK04|=k%Prg~vy~{EX_BwR0Np+(4OV?`_e`i*T
z{&s>BQ^Uu?T78~aDNpmLMtMuU=`rq@&1}7$rnJj#xn*=h+7`+{xUUvoSVNhO(vnPn
ztJr(imqb-{X~vufep{(2#pZ%>d5Ns2YPn6r8+y-=W^ua6eKOM9-d=I_Rn@tMt@qq5
zp!ybgAg3}VPi8gMGQhUFXoryVNH2O<i6WSs>e`0gV;MW9Iciyc{{X1gS!Jy*Snls?
zciwwd)^!&U3k|({?%d;<Lr6Z9bS9a>X_tK0Z&IAq@A`v^KU$?pP7&6pDT_CkLUpZA
zmVKAfIX|{5mUPc@(b!!Q@9hq>7mOe$)17{8%;vj!cGjochucb&SZ(I4!Q+J_1uM>L
zj}E)u{_Wv4hTQpiH;kUHe7SjYgv)Af#5Pg`N-4RxQOg<-YL=_SD9}<1wAU^%%D3k@
z=~xad5rr+FWZDu3LA-jdGphQ3HhD7fng-_aSFf#W%}y$(DtH8e&~Sz9<%;fgdv?~G
zR8KWSaY|(x(sEs5w(U4)mSU-dvtq%hCBmh75%QR;*4EqZ+tPs!sE&fBP5xqb+j2>X
zd+61){8g*vN;8gIx4_qY5Egx;OX!<t)wzlvq8cP^hQCaU;qXsRl7HE8>yqwFQ<J6&
z+7pRfHXbC&2_&^aT9p~n4mY{2=^=DUCZ?Ux22i5kDgj<4NB0Re)jW;#YGOiL=A*hW
z({cObt76Tvs=oF{qlcHaJ2RH@>`%=b<MG3}x@^+d$6XD50=4$c^~W`4i3kT|rfTJH
zM3YQRB<otsJ?tkIR(v{t8460ms6i6zOBuOsDF&W$6mXgh{{SdhGqGA2vi`J)V;(Ym
zD1EY1F3n<?_buXRe(x!rNG<dtAr_f-H#02CGFnZ0(g5#E=z24Io}#ufC{ih$i9H0D
zvSijXb#U%5rD@_KP-w4ZW>&WdHtDJ0vrj37c|SzOFLtM8otF(dPMGRxm~Yj?Gncjv
zl@H}l<^d=`NczN{6P=%#Zno<_ME?MztL&h;Xj?Wa!kj|D=J%K?<)?J*wtghR=x@Jd
z&9TYy-UTVQ4rLS>BgHd6zx3|2TWa<?>D*~8>K1mkcIx+MXaZD>0~@xx<3axbO#qWo
z5oi$m9_)mzBH-ON+ogD3OCpZAQ=L^+D1qTM)Ai|7fB0u!r&Wrd{i4LLnBZ>i@d;9^
z-dSv6!%y`10%8$$&waW$EwK>yEknHZq8LR;uc1jbuZ*(($Lse?6q`rx8%mw`lr-aw
zX*F6?g{H6srB>xT8q;`7du0%`p+u|QY#JitCWaMy(ZH=q;~%%}{wM39(5IHKvi;lk
z%696>EsN#@ETV~9X;PNEgesla4q-Xx78I0U-j(09n_G9UkhWAa!juw_4(d~C?<!gG
z{_-W<*QtFEbnB$K?)N90$3ERIHeJM2+euwQZV+<D=-#5a!M3u<#-+Nj<+Yn`xlBRY
zsCSY+RSqMBu%EB8dT8i;f~*en5>g99IEKwshe*NPPs)%pfo0Z`?x44A+-(h)7OR{^
zLFODz8iT-qeUi?<uSK1b^eNg~_{&1@603Gvb)(%lPyteu=ZXed#JCG+33)i}P!BYY
z@{45{S_`IOLn@w;KUDk>gD_MS%9Y7VgRP?Gsl|wdQJ{i&gG}OC7bv(xY6&j`Z<!s(
zo1m(jA6c>LG5UgZ6K+Em?c3bG+s>?91OY^wz(J#Q;hs?~7M^bti)!t%qP}`k1BfBf
zMI)k6eMCz?Ut_n}?sT)@S2@#<yp*ZSR?BEW!flcWN`YA1q~?)c5H~3+w{Z(vUARj&
z;^8f1d7Q+lmkl;-&|~n8{=O#HrifG56{=kcO`&G!m)#xGmc;<L2W;~lVxL+I*J<R8
zPA40yd%bGDNUO+7PFO-guUR|xI&1Z_U)0vL6_a-asJ@0CE;h^eFE>Ebfdjb8Q{ZS)
zd?GHLv}J*Er@h^TT&DcIfPOnEK_#$(@+5GA{{XRU+}8F<{Xn{E+WSdGyPolW#nz>0
zo0S@+*4CFXQ0!9ML<qZ^l9sL3yVVhiS62b1sBY1B@U6iBWD=!<e5Aj${{R#1=)03E
ze#G^m-g~n3jV9g8R@_bgp>ufYB}G55w0SD6Xa#AO(Ra2^i}bjcP#I#uy9ZKo4SUn5
zO5R5tMI@wo$9dkJ?D+STmdQ!m@x2-JfaS9su43)1Z?E|n)I+xy1TvK3trU`#oQ}|*
z?u(b6VvkrQ#WP~cN%+p&SP=V{C_8|>I92B_@B63Rp10%B-;aL2zlQw<X-IfD!kT2U
zZsm=(5}*{~(N|nx@jS8tLVCdADYp(dhFw}(xz!s8NKZB7d^=@SaTV{LlJqC<q}AVg
zw(j)&3$<Iy#QV-!+$lHLR|#8GX)NGqhFhSgG0=T=tsve!t9DfFt1DXxVJ;;ijkR-r
zN?dU&87u_vynk`~r`dP<{1U({+S@quX#ot}U)&=eB5qPoEp*<MJH=ev;7iRRUhbqJ
z7Og%%*0*cotsoz)<^+3Uf8g}^{k{kOB6qX;fZHmxv*!|&F4cv;hs&xQ%gsRG0a@ly
zpG|gz9EY63=PWJzh96TZ7{iU)q^aCIF(hG$zQ4#@Vs5i+@;1ZHw)b{!9(lup<+Ot8
z$tpDbMI=@x?QMqFYjbej!jxXV_dFF^?CuC@l&YLizV$pKuD;*jDfk^PLTdj2Ethe0
zloTrMAzt-<m9Q<7lXnPdMI7bvZ32f8$^^6cO*oah9B|q>a@z2>g|>0i2*?3cwrQMx
zx}V|c>YCMG)Deq5N*YV_QiB)nsnxsPdhPXP%N5NbAOc3xA8l{kw&7_wnA6&6mfXpv
zT2sfIN9!pGO%IH9(Q0mP^<N){?#`;^X|}SuZrF0{8CIaQCpA^m$h2(qSnm=cOP1p8
z$CJxzk%iZpT}e{QWfq7@<AegbOZXqClU-@6tp<z5BIf0FQ-Op%bmJ%o{UoIg+YY!o
zK_a&H7VSBxII{J|6|J;YR~HXBR-}Rlp$GvglkuOgivG~Er2C$=48LZLIo|EU6!Kej
zcF(Anx%Wn?LUC{u#1b}>tlV0)$!Tj%uQ~UHyQ)t$X>qirA;5F)jKXC5{{Z0i{(l1Q
z(tlEJE)vU&N|B8mw%Aimw?`XwYQm?Kx^AGFSHeS1sr82z@@^YILoH=ORMS|TTfA{C
zN~&ufy|wW8AKbd!?tP061zbLbCzjgYLrKD#EL+>44r0&D3bM{2qVkwaWW44kkQR8T
zI^vatEA<62M}OBt`X^|;3ofO_HH|C6<E|3gy=&lsP6!|a;R5Nz@|;>#h0x`)mWty-
z(M%-?`BJ3NSB)cKqwH0}?zs)9xY2ansR~yvpd~qS+7#Rjilm2>qLqZ2)e1s)<RK#p
zlzd9TDvS0ibd(L3g{og!_iQY<2`K*n`DBEQZG-;+iCy3kYi<fHv9`53;_sHn%;5?-
zufn?ykvnzo{LL3tem6qfI_r)sC14|xE*o)br!2Tld5S(6B{4w^DHjZuF|toJWM|G%
z%%lzpXyqI4{VD$dgs1Zayv3!J!@xe_xw{Oo({(PBT2(4J;U_Z`3d@W&%I0$0#$F1i
z#dBmdI4BL|-^X9-bX)wA?BHFy%tK5xLb;2#ZPV$uM((=55~_e;8e2<vV{OLLakq(U
zAqqntl~%r$D|7Qk=j+tp`u_k`*QqA^4wusH%G?b&;#SzbN&z@f8XUI5tFTc`eX$m5
z_mEtpt-7Qohr+T-gINqC>Y7$Ne%%=4&US>G==6JT3-e|B35%MB)0rtiLe#9(Ra&S8
zaYiqu5H=bjIeBNJmQ}xN?fic>Q}B1ksVnX$#wpMaW-VsqNw%@Zn7Xr4X1GlkCRsCU
zSm53>qhd>lDLe3uopYBi_Qk2KUXGaKvK@T1qLUll-Lm3)#)qt1q`6ACO|CdtQ@0?>
zd#mL(Pk0d*CVQ-fx`&rniAW~0uGMSQ?;5sB(t_&Jj7s!^qfF)UYmbiQl!dyEJl^9R
zFv|DQYIXbfxhy41R_2+6kF0zI>vS&8v7@&}u`TtNFuJ7Gr<T%AWnU{b+#Th^47o0&
z*Tuz;9PRl0SDT+6EO(RT`=4{4K3lzm(6mN$>lNSuR~+V8xGpETMUbT{#ATGXdB;$`
z@o7s1rL7qyL81sN17lKqk;TP0@tr#SeOo=(xzC$Fx1*OrOK5P0))dl`;!4(`R#iZG
zXi4A?9|;OIWQ4YG(P+To^{@dYNeAaAAbexF`2MRmajkVi*jp)2d^QlJT;U5Ob2jCr
zRn0Utq#L(wC9v2S7s^8UL}zS_Sr9m_T_w@K*TtUeqSg?Gv5aRGRFX+9P~@No0Bb9*
zZ?0DAl!p(zqJdzHhFN%0n}|zMb^QpuY+ODYDhN$EXi(u?>aP>D3S1>>#<Eu7sT9f1
zCZD57v#B<_=*=eKrdenTg)bH#)lE2iU@ox}PytO&QDli%dk`0$K^5>BOx`sNl9A;g
z16rtaLxprGtx4R1Gf05|v`Hf!NTN8C*Vzesiw~c2whkd6E1HK69vCQhjhrh>Hzg~k
zCRa*u?wz~`8D%GQTiN9oZUX!1Gzmk_iVxB`c|hGKlW_4p<IQv1-ZQlA3EDW`>3g!4
zuqZZ*WoaN|9>@hH3sRb2NJk4rDoRKd%gO`*ZAZFkT;kGFiUem)Fp7e#AfwTr7^YNc
zRH2j=q$#W%wD(Eyi?>QuRVyGkbuv_|2*C`iHKPqS5>(jyLU+oYBdEO%3v7lQX<b3v
zq!3TLAdqWQ7iV*!*lt;_8rLeNULG<VQqTj0XT3jsiV~Jxxn!q3&j_w)Py~vqyL*2r
zI#WXJVBOIH1E|ggwifmkBkIyauy;OEP^8kesLmyZ*4ubgcHhQO6wh1ot{ekwMv=y&
zg}3|;b5pU6=*=>OTa4lncGG8hKw4Y+Wn%S|wx3jmq*)^2R}Ho^Gnl>Y8bwAZtoIjk
zIu&ZHq~=88U+oIiqlC+|T@%E)J8$OJ=ZKs#b>}*nc9iip>+f$^Sl)7jT2jVpF;JMS
ztF^k`J>@9XYsOSccU!EXM=~W(^Ds{HQJGS%mSL(BNX?x|I}<k<@@Gv&iwaX}mFG~x
zt@7bCo=mO9(AvBdB~6~D0p49Fk}r#(2PnmzNd#vG;Jzn^cmaCZ=_+m_=zZYRbkexW
zCe0UyN?dJUFo4>1MhLJ{c!(Ea7$GPiHW7jo3<3v&6ATImh8GL~78pX9&;jAjFAQh`
zFv4JfHXaC600Tk%zM=pl1TF~`P!fnjnH5khF=_w`oTL=$9U!hR5ZIv30PI@IQZq8S
z`^7JeE`+yZ++HOjiHwR|aLB9Kls|B{4)Cqn@l+!0(Wq^19gKdKl97;wMKx~3Zm918
zGA_U%+E6kO!J=bE&6)tBvA|*w4NFyy`7oeo$d1(2APt&wV}gh@ARMTETnn@?)DiHZ
zwHD~ixR{wGayphz$<+le4Cy;0?B|zrKbX|aWe{ng5aPg9!RI!g_@ZYcCb8>Gd%A5o
zKL#&M6=Y0a<#ofPG3+iFOfpfef#HP101<{041oZOVG3mg?C15w`u(wb@TM<p-UbZv
z_D){TX?~@7%)eT^=EoqJFadV|0Ei}I)+D7|d!+8_J2&c2vPWjmc|OU{GdF%D;&ry)
zh9ui&*qMZMr5PK{fhiKD6%tS-0I9e@4I~Hvq|6`z5@J&TfNMg!KBfLn=le4@w14Q@
zm-#!N?98MoUOibAn;cOxAXZvMU{Q?3#8@H;kYEB%^KSqO$db&Is{xZRl9fWF10sP{
zkyt=17?5C8EExd61p^=$6$-@@SQP{ciA)ND10g0wP_SeJAc10Jm;oYAP$-ciumNe1
zlOm82F(Fa_C{-c?paC(#;*nJZ#}SH6DzmXMLE@82(g;@uRU(w7;)qF+LI|0XWChU3
zg63h8sHZ{T1ZJn^bkK)tx~CY$Pk}S0w9+37v&72c`8;Mc(xj_2YD;W_lbo#Po)T$S
zWOp5&)=SAnPI8a3*915Pc+GL;=*}N8rLRS`dzjEMzL@1$9#gS9GPL;zI5a8*4;fS&
zN|cFI=qe2+XpEF(sv!mr;5tk|Fd~W!Mk+vyp)o;)KpGS(AQ%8(ViI5hfr&|g1xbho
z02COMm{1THkYoTrVnKie1}3lqR(rA(d$Cbc8eH*_a&j{~os9cBVwf4YWGv1!uCRp7
zAfrfx1jv*IngD5_2HI!=G9U!a05s47WIzd;umeq507#fX3!cU@v#BoQDlpmhm2mT<
zaoFmMTf<O0!_IGtb=k+-rd^D^7wNoX@eeE!xnB<nTJgpxq~ZNjn5^HHEM?W748HD@
zq53rj+e(w`#HxZe&yR&8JwDm@N|KU8d`a|=FCLR~IL;Va$J4d0O!1$I^4wb6t!P!2
zTvG*d>wK^|fHseYrIV1`Abz^G6Ml(qqY_D133vAaw$ir(0>D)Y{{U5#by4bgOz=Z(
zEiO8nRbEj6#n&Vclg|x)nVn6YKdV;Ve!8bycdhvPeaT0=sfXWEo#d;#j=vG?Cx;M%
zavfpFMH)azLky!CIpI=KuutBjC*5~9uY%p~PhaHEUbojSfh~9%X~!{zl9Vut*9qV$
z^|1XB!%o=Vs?O;yhnhz@#_3!|#Ei;^>g)lNwwktHzXh7M&re#;v&YJ7zi>ftzTzDq
z;6@`#9$RPBKS@Rjwl15~bqor}cIa{SEy|<-wE&Tx$w~n;I^8vVZ(i-)N%*C+&kuy?
zBe;2GLk=7u;>w_Wpm@@-Y}>Z`8cRvJYnG>R8ZNx@gwaV!<C%*gu9K?cZuDHWbLrRl
z0_!Na#?BVoOPs6<%Nm(U#IUk<s-XkE@Tc4;pch8bw#Yd)oXUvnUOgngf86g{?bdbw
z09I$^lknf}sn*-Wisi5aN>NHEM|dZ@kQ)IWEsIO5r_xZI2}`PR#8(Jyuqu}LVkdJv
z{^yVW(ca@S-v0o<;`jdmX8V~n#g*#u%(B8`W$NahcNJ?VQnPa0hZ2=?oE*mMxIreB
zo(k#B#p8E7KID15r@H#M$$QS`7Y4gb;H>1e>SknYac2my0Fhd$y_mj&R7_jz01+W-
zRo2z_3n?Zh=QT?bRx0HKX>JAMNg#tzc!*Y8qGs{BNadb8mNk@G*!Gh9(zhy20*L^X
z0l?RJRt^PLcAVA8<<Ht-eI2Y`t>&%^rC=eNEp4`uUx=}pJ|yN$V`}kG0(vpdW!=VC
zi<jHwgz44m%NVTJw8dIg#)0LnH69iI66wk<qT7fLHh3N$B6Z6j-HFL(M}v3O>g4v=
z=k~8YU4zfOtcf*0`p&sp8X9mo(s3nQcz7AoUX0_EuN{uOoEHkN>`!8?^=tdq?$o3t
zS}9Ew<?&5$tH>GJb{5e#*B5S<>)it}v5tOQgp7NhvNOTOIX3C-x@}e1yK`oztsGCp
zWyLn3;*(0lvwW93VW{%J3B)P})&9HA{5g3^S@z$<jvTn$a<kyqxa-N2vti73=uHr#
z>8BNS1J8KY(&a>oxRfLVQm}9!@HHGsoxKsqU0T;ge`qw9J>U72n_+yS1=C2TH(E*c
zAaPqKhZ;*|ggBRl77&Hiw2I*=a8XW!)YhpJIpgaZ^jtF4@u{s}yU%oOL5oYP)Rx?F
zNx4@k7<<E*yhN;Sk`8`x?``zGM@`gGt!c={rZT!pK?TN%rZNYqV0w(_h3kInmO8GP
zb(5<&-N%#M0d?BvoFEdtMQbC0qU%YP`LXShT9c5y3!$!IYMp=RlUZQnCi#DL`FVov
zHWxcY@OQj1CZQx$wm1rLq#nM)M`&-brD+K+ECp035;*vDmk*G_{#JRl=5kN|m3`Po
zTTY#OcHeuP@*74kTS#ZUO8&Je57`uQbOsWHt)Tt0k2vb8Ql-|EPlj_m*6p5LzcZ(|
z#%ko(4io9^Q>wm|>bELQaFx_o`tXR=F)sN^tyA)nDN*A!I~d-K+xeF~Z<7~^0=ex-
z6er>wl}cn|OTLEEV{Jvt$yiv=r3V;fw#XQjLV8y}?u>EPt2Zl5^W3qo3}<sjn<^ug
z-Vg@oge}#|>w&N^^hV!L8M~C8tmBWZbH^Kf8_z#L+;t4pC%mpIfm2I4tl{t*%Qshl
z25zxUTik~n#;?v|l#UT0)h<SaWgr4_AFO{N6w6}}D)w|9aZ75#F=0<;Y6ny5@Qzt`
z;$Wo`RGcUEtMeX_y)&ZY<g%-swo^(eBl`80nvJ?eLi15kz<Tu_LxkMRY-4oiaI(7H
zRclBIAXm;2#Bv5hy){nmc*VT}xgj-3HRA;Lcf^@u#K|a1RaN0J5}Rh4N(D_!BMstE
z5YAMSt5{>YS_TwVS#gncpc8>Hd!|1X#%dg$CYhxbV^`KR6Ec&-WRJcnl`-nLL$(LP
zBdL&{=tU0<#Kv99>4(aE7EBg}suF5RT17f%yq1zVmTZCEQi9Kr>p9-_Z>yx$g!FY9
zS_)Nc977H$s}le#zLW}LDo+s!qan3BXyRzw$y1Bw0p7qx3J*^K<1;_<HDq4yp24eh
zv1Y6)_m6tGHt!YJ4OQM(f)+LsbY_CWKw<W15L`mam4ywcrlDLEvM~|R%}f62I{yHL
z`=v{D_djcp=A`;k>3JgY)-F))L<d<(<uZP!6HJ7aH1eFn+t!J@<|QRVG^MiAL#SCF
z>M1#cywp8D#ZH~iEmLr-Z`vD4t)05U@q&gNZOS&%bJ!#UiZ`)Mux-`Zy3_Xm0L#&C
z%V4V(7M&qZQ0|bRXl0+Tx^*d5ZMNO^qjc$MzH3*v_N+EY7{b9WKA?SB9Q-3YbuCvH
zRBiV$-D+H`!-}@aDIsd6^;Tgrll2nxD#4b6cTB3u)uCy3or2+C3G;Mn;uBrVVMhQH
zHo$!vby;%hrZ27Aw0Xc#;t+<C6L4$luI62Sp+Bd^649=UPHFc|INiv%Pwc9;Y!F?m
zwC1Fbm#OItS#c?OA-7ttHZ5PqSIu$tVk;>XqBF|7OTWYQ=zg?m1!oPt!BPMY-CVb9
zx-Ss8WsI?aaui6<tj)Zng%w>e98;W@!c&Hhq~UG0zuXkWuBJa<g3s6cozJkXTo)d)
z2F#_$7jRm+t|nM=hN!PaaFAUW2<53sw|e2CqRCOj+L`sK6!}FnJZ1R)ww*r|?6D>N
zJytyMh5Nk?yRDS+`6(;H>EK8zm_Fg=Tv;W%mAIQ_Hl-`}cUr`rVp0xRfT{5^{gZ#M
zRMpz}{6KpP%3YJ)$7`o^?nlBGjFlv|(`w7S4HHf~Ov{$HT%Jpw@orYj_O9G7xpd~?
zgpz8NG_2BmApY-(uT%B-4RBK6Q44Va-;9E)1TpavlW0lEb5C_%a7*P~Fq9I7rsXU)
zSZ&Ibzs*XE;Z^h`isFyg`<;oiuF1N)!u6<OC|cXOyf+AO0Hn0jN-MTtQii60MLgMl
z<(spKw;Hv$LoAx5zlx-xZ>?JufP0-}zMrq%Z{2Z8_C?~u4LfmhaI1TMOLndyq=nqL
z>*kHLkOfe*s)0QORnpcMdb?7KXHfN<e)9KuwGgzWZY3w?&j>sTlcv|<>azSkKeB6c
z{1O)HcMd6rZCiCsTUgi|r3zfS*$Z)NNja913cSPvEVR3Tu+rV7?x5g$<eqC3VL`>(
zr0`v6iglBJ`1l^Z{{W|J_?K7t-?Gl%&_>?2YVDMjD(4u#U7C-0t&UYLN|t>oTBs5$
zv<uBW%(h*vv&Dqiv24{=Yl-`mV@cvN1eHPS=t;74*vd`@nz9K;C3fvuwEA;(E4p1=
zM}iQ5bA>~$i~Fb6wU*ZDLT&KV-R<nzQk+s~Gg6g7iaPzy{XeB$dd6=<Wjv>qY>rT6
zt4p_yk}4^5n<h!-yiP;~9x;5cceATZslXaz-CHVBR<C`y9LnPTQJ;iw`g;A3$M;`P
z#P3jxrV`*~Yrt@@;};G#REL#x?ObIUQilZr;UeMW+^H(JyLA@mdDq=aTg2i62<4%q
z)MUtcK&bdj-hV&!J9<y`I`8}wNLA~6%XESiklv=Gyp#l`rF=AUf~k?uGsZw=PCNtU
zDL6we)~M$-MLz4ywl+P~0%@FnzuhPPKHq9tSFc2rI_9AFyRD{Pu9<GP9RWq=kQBEA
zepMNaqHOM+_hjJaA=TO4+&6Nhl`Rb^z{(0mJwObG^7OwO_#cLo)2iKG>3ODZi|w`$
z+8nrg&fTU}K-x)4-o0Pz93eG`eTO~O=H9t^31zz*cCHZF7X`;wTw2sX`M{x10UdX<
z@YmtKi8l>R=`UOb1-!c#792x%yp&X_X=Pyz7e1(21;Tm=<>%gM{{V{Wn^3LG#k#AR
zZrW1INk3GnWR+4sf57zr0AGlmg1U7<4Y-vm;of7Mu2>W+LK20zul_q^)gru1&aEB9
zRYa*i?6t70Ew_u~DTEFySSbsQe}AFr{;RanEWXO_noA3DC5v#e-5jbqqMmU-U1Tbp
zX(hLLF7q8t$Z<|3kx+25wV;NZBV{GF#v*!{{{H~xe?`5M(?lZX<)<zU$hBdX&255G
z98z0GOH+qB7gqp=8%iDwT`S$(N}6$LN|aoE3pF69eCj#Vq;B82>)Wq?*!1YS=u4LZ
z&~sdEtA{R>>YTtZrqH-R4lkffct^HM3(mZ?E!G@$hKo-jv4}9T6M<?QDOIUaJ4f~Z
z095=xZKk)|)BD#@MIzlk?xn45EG2&E*<C2wJF9e{Z;1DWM;VJ4TE?~G31p?)w@1fP
z)_cl8;FI#xq^Ij%i8}f(;7`5Vs~s^>Dr7k4rPT~00V&`YylkT5Z??;dNWkbUjyGWm
zNJ(`2c*pDPpR4vwFQq(rpIHYO&9x~i!;K3jfcPZtc*I;Z5-n4>Rm136&n)Unyb^sJ
zB`Fhq!D)sZxl3;XaI_g00ECq|(IrVwfCN?zvr+KU>uo9ZFqJN=bwNJ2Q@sMu7@rYt
z^l#!@w+*GD@`*|STeS+qP*i>Z9C4k`7}n_WoL$49s1lSo+J!dshR5jB5$helU*4an
znqRaz7i^{0u;N<H6dNLmVaEkkU(ro6=^I!et;8r{Z1UEmhZJ$TN@xOpu}W!L?HlX*
z>Xym7`h}eu!yhXmY_6NsFZCyycitK1H)xShg5M+5hPV(_Ttsn>wEGq;m~P#K1UA?q
zDIO-Io}`?~lanhZy<D=&+t#{!UKyTKFN4#=gu-ebTJIFl2$N~H<~oZe#$S0frDUOE
zmD*d@5}4{28Um6{Lbye|w1rlphGNTmwVj)EmUoQdjnSpWxmpPujKm(Xty<~K5>-=7
zhZ8Yz=+7rMIL${{l-b3>o_BY$pHsXIVhiq(C^c)XUt4`kZIv|F0zm}KWl~J@>!)lm
z^;@4G9P!&<>SaXXF`?6M8y(~m;~LvuG|MeH<;#r;Pdf6mR#6Tz`+LzMG3c@}&6TY3
zRhEL3{{S?y&ufN$<%u1Y4mqkaromq%^HtNko_#B{>B0O+yfgm*q<Q_t{F#0U?kw=X
zcc!$;ZElE5MWsJ*-X-G2ZW~aqEkNXwz9I=)iUrF_1xQ<~D7FqC*`9d~D4u0@Rd%fP
zcKiPTGt2er@MZbER^VOFF6x9^fk%?0wke6$*-!y3pQ}<0Br5qSMkOMIAUc+kId8h+
zjuM0?F5oA4zpMVIm&fq?B<Ohj4Q?Mw8dyzM65EayxIQ9AB-IW0rY7N~x|M|zl9oe(
zB%CcL5GqR4H#MbV-`A(^n%`gQvlDtYeQmA8@*Ps#sCAq}@RG5GN_kvx*CE0=3|WQX
z!g;PFlCn=HhW`Mo^+#CW`;$wrk7V9PXlaIRl&UPQs#Qq*X9n)q>Htnr&D!yl2GdmG
zQ%xs25)w-5;g(YVzu3A<-|T4IEteL9g(wIF_jXN2{{ZnA((e3QG06wJ>p6Fnzp76`
z(jr{6n$un~-GgwVF$92fIdt;#jk(HovT&(5jZYeMq*~7Q&YH4AyI_?!OwxKC;%!@W
zG)mM+;7=cH(IRNHiZovJ5lZ6nh*l8y<WAn%DRs4pFF_u04O$hHDu`y`IKH)0Q4@6V
zMYFg&!7V%FNlC0u@b!y*Q_{Sq>C~ykEkiXpx)1n_i-3f<vrNm2r-yjX)3hUv?q1}r
zVKk&s2_$u-07@znY9U&}L{y|uT6`r~PZ*^kCEcmgPzF<=H$XqSL!XCDhv(-Y2xZ3#
zYg$ubGENkv49U#+Nn)(1c*zBfD><F~WHQ}CS6%iWzGn9?cBf#aG~<2KLJnfP$v{%x
za<x*pe_oN$0T4T*I-k4F4IIv86m$N&Km#%dF-cIVIn-|nZk#Uj6|w%b@{dIHJycel
zag@;?e+ebfT&Oz@x|jg%fVUd;cc5+Dajpi2N>DKEGX32RD!H7X`(14H)v8q0Y7TPC
zq^7p9MRBU&tqf>%`>b8$8D+I`va@v)IYYVCo?U22lX0iG6I>=FYoT&Y7`bxdj%1jZ
zT2dB45=g0PSb*Y*i5Wn<Lxd|RG%U$twGs{%uCQrQnO3%g1w^ESAfqY5HZm7TfoW2g
z)m_X$8OD^_9HsS<nXE!aQ!84D2SwuB*v9G^$<<oknOL{0xRIP-D>Kzv@<o`}mE$WY
zs^t@6?jqs6d&J6vP&1DqPRrKy@n2k^3M9voqe$vn*N4`e+Feq1CSNvc_?vY|*GJZz
zqOP4u$wq6<Bs@!#vTs~T`KKV>qi_!MUR@c|c&^>Mdb?+GCmx+u@Hd*7FrF=K+NV=t
zTtwqr*BnXCv!>YF8m(?SRNb<!Gm~eu2dSIe8>y<-M_wIh{L`3kv;*r+vE^9PdUZ)C
zI}thd_3=+!+Y>e$@pL&#G;84e(`?MxYsGm`H<VB7#}BG$pC($;-Rs8N8D?iVt!SxP
z8qFt@D`MK>@k`?wv2o1+t0_rSWyGc9aL`8xdf5XgIwsdZwPK^1vW`9Bv$CKxGFn15
z5lJXl%pd}A=MIL4gc=G6Xqf3O0RRA&Bandr0vU&(5C9yZ3`7C|Q3^x=0+9$&3IKB9
zN@N3I;Dy5~9YYOGKLQg~Prx%+n4w%&ul*#+)_<hU&cy8JpK~eH&S)7{kpLZOqvH=b
zw9m#Kb2%9<J<L10y)8cm6G>0Nn5FLPk7FLg;e^2;&=C=35CC+G!vGLOQ4j{){=Pka
z*sXkIzii$HEOK@^dpULbmFF{_wRz2sAu~V)vFj38^@%A=Na=ew>QAz6&U%wM=4S20
zaXR~7!xAk|!xJ!$l_|m|ZcqkDnKFnKGys{ifD$B#1W1`MDX=x4@O?-8oyYcOZD%bX
zQU3rZas8Q<680}=j!ila14w}tGAjxVAiz{Yq$&VM8HVrx?NVl>rBVtc2?Yug1OQZk
zU;>1SnG^~V0gwXg6AA?hgn$+#Rs{+MMPLB|h^&eNgAfdYD3yt<2&L8{u%IARKr#R*
zR6sByiHZ*tnpEndVu-~efS921NC24N@jwD%gT(+0l|hBl0uXF;fi6g@7Pnv)<eF<h
zTAZYAT&#<s1uj5>Op2rwF0f@%PzDPSDOPf6bkwOA{h4x)4>;emu2J#lGmmwh+9T2Q
zmDPde1){F3C(3lkv4U8&WR*mq$}?7-vaO;TRIotlCJic-L>(rP2~?mC6$TXm3s{QE
zfFLmd%77p_$VrVT3X>9(B7n(MKr$(?P+|d*Kv1ZFVgN8yKvV!AF(AmGATc1wpjwZ1
zB}cn5v?p_0le~+Ak(kf1pJz-ViK65#amdNi7@|aiiJGvG8fZ{yqyeUY8bN>>MPLG}
z6IoCStW2l{MAlFWtW9A6pkxC879lKb?l0d(y9vhP%>dv$Pe3@r$!*YErT+k9$_<Uc
zNUNO8{6#Vn%S6&y(CzRAhaF#i$39SL=}&~;6zI6ggiM*c%x3iZ(RU;uSGs|@@G%eS
zEr(NFMvAHwYu+Pq<R$Q%-D5s!vhsiUw~rS?gucji+jNW^f|QUc-o?|c1f#gs9JhG1
zz;^ZLR;3{=g%#BOYHSlqXTZ(O=UCzAmhX>SSn;}+`nyg%b@{a<Sqp?ZE|PuOEr&h`
z$k9pp*IymHWioVqWw)*_wM*n#+dQP=VS~(dD*1CA(e&>+dGCK`Kck;~u9)%F$G=|f
z{ah}l6Lu^g)ouR(5pS~56heZ^3J^!BM!OXaqh)qiM$*__+H8iUa^tOqD(%dD)t^~O
zI7SgQd2#jYqv>(uCGYsNIP#NIdRd-%-yQhK6CJV9ll;c(-h!KLXknxva~2dhB?+!d
zGSl2_G{k<$#j{++Bw=ZkfVT+ATX5<oXEf{U{w|hdB<Tyom*t(b%(-QH?Nt8&Y3wZR
z8@YHY%-$;lA=ZjXU+Sa|=<wq#u2*ckMLT*e)T?zBVR!|eV4zBno(ZYmW9n*rwZF@*
z&HX*!n{qkHe6=^KsvV-Suwm!jFS;KoYn0+o#Bgq+PR-ElC61$QZktP0U8N4L<<xgj
z2}vs(CW4qkcO#6%<df6?01erOruFu9%ZBA=X{S7L&fK-=W{qOpTJpl|OO-0K2muLU
z#Z&OlKs{bCnx>hfw`!F;X4<g28EhdXD+0A7P<=B$Qy(8zvd0Ooo!k0%%YAk0_h%fl
z%J(U6ycuassieI{mq}76d$e1`SLWG1F{S2*rYBQbVRx3!rr8einpx$PgWLzq=Ap(<
zEzL@o40kp9rn=qs^d?z&?(16`?YHf%t@&-TZLX4*?+zjF4L4rmPzGg7Q6*IC8#iaJ
zT5Eyj-M4*>u;s%Bt%k)u8)zngdpOHxU8nw8)>!57_!8rHzVqc<amx<c_#JAtExZkq
z7)uxe5o`&>^~<FdISSzjO)FT^*I!kJr14dn?H*n=A9$+D9bQ4gyufGy)-&UrnCf~H
zEoFLtrkeKt<1QS$t?7IHnahr6gzMQyePHdiY7Ht<4+2Ku9->^Mk*M3c#pTGjTS<BM
zZW!+|MG$eCWr;qNfzo+-cyhzMdagL<EV};yAHnrKzq-SgO;^n0%RU<}JwDaSK51C@
zSJ53{g&{@8mXxiv{bZ<QNZ?NpXNJd4eh&-0Z%5k3yx!B@&P;muo{CF{A)K-)^#eGq
zntJ!qiJr^@N^w;?M@6Vchz=M<Ck(qpv8@8I1cef}KpZ!knIv+!I%wwAI7&=ixW!7%
z%8|z6>0#laZZ6rbX#;?o*^7^hc})|_!*BP;PP7VXHRz5x;kQj2X}aR{zj#8EjV`C!
z6gDt7R>4HjOPA)+x0^069oX%bD!$5_rRw+ZTmqFX;%az;cM<CWc8_xsE7WzJ_@wcY
zIdSq_Yv*!#OtRd1xwvu8I~^@(N=0@fI)HXPIQj66^lRoW?J`gVWU8Ezo?!7FbJL{9
zJafh4*~!J19!IwpthmFN3(X`cw}Mit;8Hy#jwvUENV;$^p;F?KLIa2;Nmg|U@}^ab
z4fO1J9wr)<%8_!m%L#plY7#{f_96JB4=R!(?j8@la9?bv-S1FTj`adoC}^r>P;=`g
zzL)jzPt;jDeb>iY*Q|Lj+J|N=Ep>Kpm@hIONXwU%Mq-AZsowUtvo`wnk8xs#-ECkk
zR?BeIh5C_7W&(yrTyxa1o}1e_;kzq$tm^U`mXULIyMxVA+(B(YLo>p)jV{xu+dl29
z!Dw4cEv+<FK}q2?<#g1T*u}zIwlcZPrNxEgj9Ry4j4iu%mK#VSper>KP6LRQb~xC(
zO7NOtp`kT7WPY5;obsE?ZROe945m2hIq~nvd&}glc?uuv^g><QjINi2A>8unH%O9V
zlKM54eOBX)>S$ghXIgy{9C0PgK?Z{$4A+S#PVC&$_v|V;uBW<?2i8>p_CPB6Ni@Zu
z)lUBaPYCH2V6x?tH<L$2w6cJshNmD;sa{psc*^^`^*924llz35-)*;!I&V^Ua^&T=
zp;uQ4s)9)IKe$GO)Mv&_acJbuc8m_-!ruEQ7qrMh#t7&Ho}*W?OR}vUD-<=aALAy=
zy6`?Rl+l-EnQX(k!cwHAO9vBWX{a;+sBq6X>@d@+M{=nKsx|KC;nrvQv$m$=Qw@>=
zoLP43G^-@xp(8AtNc_x;jYT$zSZ%PUDpJutmXp`?x=Vh<$IH2lyIiuE%dX&RZY8WK
zRt{}FBA*RB60g>k$}T$LB$8BWN#cBE#x>EL?!Oi-wxpz!i2ETPWliBng-P@M(X`rW
zt0)OYOfW!fRax{MX02x3u_dj^rcc60LU!<jQ-wtFJUR&Zs>n&>668vWD$6tZLa@oM
zBNMV^QuV8jKBWZUKpl6GRf){DlJ!=nNS>!mBM?U#(iY3QhMfA9t$Z_>y%RS{H>Jbk
zw6I}M>OIk$O{FQ@)J9Rxgo3oT^41$KxLgV~7<eEL45n@9nRj%?ZkTr3_e*6>hFe+&
zB~+v+fr#WB#qHWS)0txC<p$#uxLXXBB%WH0F)WkA4MC9oecJ9-&6A5Nw&pGTX}McG
zw5TNx6`t$F1KvtSDF>siZL@A!aax8e$I`=spfu96Qk*<+43jQ2n*0*Pzjf81Qk{89
zY_bu1&QjZ<FC`!hOQ+T%m}6@@X6<yAlFQCE(w=F?-CiQ&i&Lsm3iIJLKVM_@Vp8`$
zY%O-_E(X~i?%Swww1h7TpH(eXoT>WVOmS?xg{aV>C|X@tE!@a+oUApj!=R0Rzr^U2
zu(q02u()w<U0PNBLFE7ot8>1f9Y7VQFLa3N#}h9)TY2KzuPzkpZy=IX?S30%jF1)V
zq_Qtmw`GExWn4I--Oa<nEg=@<CXKMRQaO)jl8dAtX_77OZwU8-<4!4+u%t2FX@*>?
zO2-1cbx`Rn6QQjP!;UxaE?Qy<efw1ME<3!Wgr}NX2aXz=4ltI<QX6UEiuEMgA&=Bb
zLR(eEPZ7F=y-)5ePt`3Au*+>ThPL6xS!pFB9lA1FTw0FCxq@QS%54(st~gyn0Zr=g
zoKGk#;i)-r6b6y{q1L9+W}FJQLx6KxWuhKX3RCSkMOz2!D!IbDY^2)@V(X~_srQ7`
zx)j;Q-X6IMN8J93o7h&!aaQS01TwI<9&EOeOJEmXK~Mf6PE?ZkSXMWRoxrCq((6Kj
zvcM%NDdOXlq46-izmnRXnklBz>)@3mkm$EnwV`Mv+Ncl~>B}Ocze>nO!jRc;1viS^
z+*MeLiF<IGaYbu`sE}K9Yi7<VOSiU4k!j9(-*R<LWZP{d*Ahta18y)+BiuChn04EQ
zAvZx5i$E%Q<fsxB=-nwwsHJ&Fr?15RXQ}F2mn?HqtDI{~%C@#!H6H^3#FgP21(b-O
z>#W=%4YQ5ct&(lA1$V9+K~YuF0)sK!ud+W6PhX03{{Ub1Sw0Er*RoRjISPK|q+L?!
zuoA$kQrqsNAgpmIAQRG&XhIvewxTW)Ty?)ia2F5?+*6$!%7U_=irw$*o220gxwUQg
z1;d}WzK4^9ww6LD8m_@hQ2+@x=|I$N*tcl19%|p1(Z$MbzGgKzl?;lCk}KgS_b*S!
z?z`zy_V|@(#ywS+okhYHmRn^`C4aM&j7w5Ob)a!H6(m4fkn>lU4JG?!-aU3ymx_r9
zQA<j7G_DW<?g&EZdQ{QmY3^OArr3Ph-?o?BDWfWRX+wR`d&*ccQD}z!#B$52w|T~z
zLdwN0nrTa0?gb3g4G0}&{`v4v-~Rw6rTup|-ITUcmhH-m?y?wh@}vZYQEJkhQc$y(
zF-jtUM5)&h(p(pcWt(;#bx%Cmqpn=6Hqz8c&j6@Oe5Klc#ovCxD^m`szjzKfhf{2o
zIMYKebH&8luA6!)vkVqkd6c+RfTb;jr9_W@xGX72SOZ`MPlUhW`q}#Y5AIF=z63Oz
zqzk8?Wea^yT)G^p3n|2a#l5>KCV@Z_r3fbzfwtH-@7$$}G_4FaPc1h~xXT7C*0Gr?
z*a5tY>)&7EPsgJ6_;nE2wAHH?&WCUZ?AUh#(uJ2Qrwerl@bOZkj9a*F8c|XAq!&ZM
zOFh)M(|A{aqM#|Y5CGn>*X`Kt_D!t(AXjC^A4fZupv#vxca8iyC>$)?1m~KQQ{yGn
z@<NisOLpS6tcGesX;X?*rs2Y^)qrguY5NymzP`WUl5QV%TT3skDNUkA78th*?=8dt
zUwAD2YLP+KERxOz01(>w$C$9Nq+K}TTS}@%Nl*%)jqkqx=Dz)Z!BcnO1B+!gZaz7I
z7+1?_E&Oy{Tsg}N%P~YFF9@|L`{RgHcOW-%miei!7o2IFOI<i26{1hpG28Xhoi*wB
z7rEEqiXnwqpt$OjZ_HAiG+0BpP=U-*+>>0mM6-C~%>|*Qf~2iQheC-;@etN90To>e
z&xIrPqxC8AI$ni1+o4xJ>@AA<X+vS~17Xw*N?4{@lk~>dZrt13JhyHOj8UXGFeodW
zrTjqM1x+#@QPzA@*Y0%JRp?U+t6asj*ELGzxP;+LZY+RZbzD@G<wGLr-c7URS1Gq>
zx`e*sf{EoRDWgpqdX@81Sf7Gr-W@mbEHKiPwR2Qf;=!txl7!o~DMr&;1geCj%<5m|
zBq@{b=>@)8YF;S93r<&j2~Q5Sm(#E6r=fnw^EGM8g}&NRg-UTj4pSPN#e@X(%vAM?
zO5Q^$32k8DZmu{oOLZV1ez_UPsru*zY8Vr6g)1Ful&@?f5(Rt#S>6rHgcQ}Zx?HP`
zhSm<~H0G%JWDHX4)SZAF7Yzp%hciZ=TT;Oo5LUGizXOJYEZ}aRAw{;z`7}ugP*CQ&
z5;HX(kT^$FwCU5Kqie;jBsf;32GHMqM;>&~%}U|Y1>XCu661+LbxLt51k{s22MTnG
zmYq8+$97LuwvO#tOJ?05ApnP#DE1}hq|<=TFHdB$%1}y_X;mp(l6v_}@@B?Yb=%u<
z?=8FVVdIQFZ`BZzq^rV2x2t%@@q@Ual+p>u1tiHT;TCiqj7v#7^oq1t4S+W@SnkEc
zvSnnf=hlI8%E+ZpkdGGHaFfPkJS}vyqqiR<aG71GZ!K(DCCiW$d~=R98z$UQ#4#D?
zxM7cXOt6nvpC)ry^p0G7wkfXl+XmWGY_L>z0V$3ivqM=n*sqkw)Si)UGI}?c4qM%)
zoxSUwxx3Y_LXy?0kecL9QuP)KCad}+-K|K?)-3W^<yE2fhW5ByMLMX?!N*#(YY3!B
z*4WQKyBSTYdlzAQrM0Tt+&0Ree%WQUl~J_d?;dI3iUL$)?JD-Vm<YmD^KY_%p@}7K
zHl&~^aRo$Hvwq*b=x|@m<L<j-cAn;M55d$eEIO8PB?UoET!sY(H<_SQs3+tix$&8V
z+}tca+wHuyttm>yQqv3ph33HmnHo;tt(yIueSXaDNE>VSRW^qdm4z;r_e)v}&MCzO
z786tH037DHvk%dHuu`AHxK&RrEjXMd2|40f?ve(^KN8K~@LTz(N=r0a5|W47Eg@h$
zrrJVP>Po)1h*cs~!;K5HC2L<isbNYA7*;4%Ott`JEd5igX8tR6e_$_=D5SZ|LJNUQ
zDD_-&soWhY#u4J<sbOq^-+iz#B}(`p9$`*dD3P39{=E%UhfcqNrR!>A0Ol008+RzB
z4h{qweyly)Z78~ONh;=2q^_w1B_s7tbrE9dnQfh@ZhkGxqnC<{sKu5_>*jOzOH{Pp
zAo9>jE+M=kwW;~NoF*>qZ&B0HjhMG!v^Lt7keZWFIM<Jqwt1$Im4(+LD4|~I>Ft@A
zx6!Lvmuls<hH9Ffw)sz#oA=qkky=wK@UQTbvRt8Bn5th`Q;Nmcul3#z=81Txy_w&J
za~HXLl5`sF(rhjZW{N{D5)CLtI7Hk4?w@=W+`(+_9r|zWiQaxDKQt`qQ!A-nY@{jI
z3e}LRkKSU+s*sR6)cZ{IPQ-Dc3l&(y6q2y5hEM`h(Qh(*gvfIfm06IWg3_^LKl(*H
z=P-~BI(b4JR5hy-fcauvO)$zGLxm8Oic>y55e2on1`p~w$N}}RQ_SK>pxfEf09?Gw
zNJq*BLyD$vO1hS{I;Qk9MZ)^c2m>s*#4&d8Qk1cm0VV9!k!JRi(Lx-?RDC=;p0Lfn
zhY^U1tAOb<(9-obl(gcK4lK|0r<_}B<r=s$<4@fIcBx?nrxIyj>&6ojF{YU(b0zE~
zQ?~9?P%sY|+$}CEBSFAPrBpf$HFOpf1q>5zINf}vbLkFGm8?6Qec8<x&<fEoZ(oo%
zn4Fe5+TG)o(nCAlA&L+ZB9(oJ(|Nr8#f~}kOg*&8*9)aZ&t_X%iJ+FMyQfLhA9Y-&
zE_r(_UHqKm{h8i~oe#Y<t<gO*+`Rg+<jdK;UQx+Cp{=u!GpKPk%dJ2Y*Eywmv9>%n
z+t~JHFs?;fbLrtaV{dG#?LA*oSDs~F8^x4+E*MuZEnXii>OYoStYifA`A3`TSBt|Z
zv*_box|wi%v!b}t8>T{fcOH4mUOyb3ytpHp2{qbWuSyuUo{hN9SCdag;G0$;3QIrb
z9uuu{`pyzNeFakJBlonjI8M>da=6z_xK-jgI&*_yXGVUca&PHSQCMGeaWbczW;NkM
zR@ud^mj>cko>40J(1k0s)KEJaMoYhdfF_YR=_0BU;z8PFs<9Rp7NIH5WXQCLT`40m
zGOZyb_({c_2F;X$M8Q!_ETT&Ch*G4|>1}6a^Qo~gNu^}*X?&1y`-5eekOZ0+$qV;~
zjzv&ZGAi$2sJL5Zqdzzm1xTVFH>^0Gvb-f#jnS@*t((?VcP3T^lu5d}Yocv*ja@%l
zQYrIUCQIVBMtrNGZ(2vz6Q6C;W63OQNh_#EwvqFF^O#%8PRcV=He_EEwbr$+gY*6K
zk#6nbvdrI`HXbmQ+qbMGUo_;AsJ?;fn(~Yu4S72M0OsxZPCV;R1Dxr$CfM;?ly->J
znP2|1lDF2DuCsGYZp65(yLKtLWnVPrTh>%KkvGwgHgw;P-Az)hh%%DPS1TjES<##_
z+nZMv$q@`a&OlVr-IA136-WTbR!{8lda(VU>6Q>j3$1@i`ef^$(!QCw*qxm7?q%G@
zvp|DQ03B(6jy&el{{S3&CUP=ddzkljdO-c0MQFqJf1+lNu*ByKAretk6($g-MF5Io
z%47f{n6e;6bDg0XFWVK`Awa)u>4}3JiOA&_>sOqY4}D&9Ly%0+0c?82%zDI>s}ee1
z&U%yVo3p;8&Uu+Tal?(*TK*W3YJM1*glsx)LsG0MM?}fm1PYQNL4cY?1j&#=gu-0`
z4fT`%07uk+$=rWtX4ZegH6QYKAK94{y^Go7V91>ZoK0j_17c)A3}%23W-tO1yvg1L
zN;`W@i3Nl#OdwFI$gGBdp&&t^D};yvGAjTS41i=%EEt~|6br=?41g94O<`3F21R55
zy2OJ377U8Op>ZI<1=c3ADMI3FAO%)L0Gh~v5=>2CMJllsfD6SDT%ZE+!Iem$Qk;TX
zvXOMDwp)alI>LcKlQMRY0;>}M6<C-Qg`z?vD#2@^sE5axk)fa32eMC8^=cTs3qV=q
z4=9ZU{1o|4m>8KEEs$bRX10+K>9s^QW}ymGfT)0}NPy^68dVC0hYEvAq5wElLRA5v
zP+|h00aB=xnLrgLB`SahNr_2-1O`G(2)ZmxAOgXO1_0QA#HIicNDu;4a+zM4DM&+G
zgS<`2-gD$RJ33-uYT=NxoaK>|c&uu~)<Ht6BC;qISc=KD0;>{C09i2=fC?riuz;Br
zfD;p0P!m}apoIexD=48;2tZ`ZKFevNQPms7D$_p|&m`<Urd7gkAu_s)?#k(H={6kq
z$L%*M#6jH+a7gG+80PWyy7OG5;w0coMROZa^qRtW<M&MR-RRDH%IbD+3}nZz;%$3+
zwc5GKIFwh3uqa7deqHnM5#^qrYp1x9qE`F0aAK)SDe4IuR-9zdKAk(Yju>Hj_gpa6
zQ+=7wlRin)q=2=gxpdlYFW2tKAtbPp0?Lg&YWZu>L24JG^{4HAJB4o{%W~ROE6P|P
zZJv9~&L1f<&g<-Dox7S`xx8)13BS8oam;m>O>3#kuQR5(g^PCDWweDp;3*0N#ao|0
z849xwrB@f(;!1HgY8y&G%_==>LrJg8hiM@&+}=)e%aV1yeIohmFC0IqtM1-AaF&BB
zzO=blF%OWQU9iZ}S>`-ti%+s1HpdE5l%+ul?v*83WR2)Nrfti8w;Puo_{OBhW4-w0
zJw7gX9K2>mE3mvONOi{4#W2uPs0WFu`Y9bTYp7gWU0dCd)+MPeIN7R{#cB;W5wy+2
zKaWPSnOSCE9*(n@4RoDc^2-cz#^cwgS@!|WKGCa-Fzv&xca_R#f`U_AB=D)&$K1Bt
z!)}@q(h{WN_2Ed&)|pp~&B9B*?vhESrzTlUwIul0J=-o`mYEAh-ddF0TQbt$OU=Ep
zQW(Swd-#mwqWT?ucA<DmQip=`@3d+NtvDIa$I5k{t?#Xlo>Lpr?_IwZJavzk>}PwT
zH>iIvUp>}QVT2%~(zK*z6-}a;a_dliE~zeBatrNyvWO^r)41s=Bw<$y%;m-9ud>bM
ze-6!K$#L@O+{#QQx?Sq;;9cID)#bwqT80+Fh-<r5R+L%KVZ_8+TV1@Ldb)3ua-=Q1
zDI}%3ABJc$An}WgzP*W#S9K<L9B)qktCm>HF`a`J%p2Ek1E_sTDJ3Zajg*WjK_`LS
z2wPi6?ZTdU#4Yz|gM}q6hXrV9O#Ecj@~beiQ_A?sttMGZ(sqV?x4CX7x?C^SWZ|h%
z%_g<k0y(wQ6>7uw#p1iWj$?{it4?A1gX*M7JzB?)#$LVsTefugY0oZA*>%z@E?ZT>
zc@++=<ommo!c?_X*E-~iN2f-8t03D>4sHx8US#i8tZ@qAIox;p=-<<_I?E*dJ30MH
zYn@(?VS&aimhFm?4YoEEOGbvPLeul&Ju5Ao(C*QjK-1nDQV2Pv0UhOlezL2Ia=dfV
z)9Ke)$$D?E;^*}xR$AEIrq$1RYS{s90MWNuT2_|E8mu2evh>IIR(Gs9Uw1fHomw>k
zbu|S&6evvd^5cAZ^>@#P<uvtseB{rg&%?{%l)F%0*;2Gjd3dTRNjV=Jzd7^yCsz5f
zxaDPiUM#9`S)LOp=WbgqSGz1OEERC9&RqoITk+e|hgLDmN;NsmG~32qj?Q9inoK&*
zDW_?t47u#8`%O8uHcCxN;~(1T%4tO*RHs?b7XF*IQO<L0$ri<x(8rIkvg&fFtV*6Y
zYh`aA8;QlOxl3Sy9X86+z$YU~x!Bi78{ErYRN2aGa)P>hIvj|NrA6!=!UqVBa9^CL
z##3!rZ0H&Fi**~BWh0JQI#>;^p>d_%2b#?_qT4=|r-(i=3q~Sl`182dW6#UOj(F<+
z&bdcfVQ}81ZkKJTfz<NoC=`W#T5Kt`XEmj2PH7L+DO{D19Z3HGn0Sfm!px@U;^D=~
zaI@g~+?d`wWqQ5G6wY?)zq&3a^77Ht02}1ohmZofi4^#2rx@Y8wo2Bjj$7>|!cs}w
zWfM=ktnGKZ8kSzY-d*&SoUpT}z{S@ZX~d_O?+Piv4R9ibCW#$aT!aR(+D5EdCju?h
z%6ZPX@I0Gj1ko!PhHkI@GzyYrli{_wd_S!3`>nTM1eksLIR5~&-pI7F_M#hR+U=y{
zbqT{qnWzCo>=od1F=tEd2ii@^xp~KIG*r2XDsrX!lV4p1YOfEJN!#`6nzyg2*)o!?
zvmTE<an!YvGd+4v<F;RBw(MJ>%`v2~ZPD>pQ_64zlZnNj^$$TWblsnS=FarivC4hi
zRj@<r2zh%7wv*^5rFckw)yqYe+(|-*T(assBJ}KSCtl^p#NSdhxWbQ3ICX{rrDVEI
z@%Cn0J2A`B^z7G5-B*EVaQkWFE)}M-;zE+D)1jSq<>zCMUAuieZ&fcWku4q5(2gn<
z`on){op!{{!pmK9<BIg#tw0<n=*l}&D?!7V9y5DqdvcPu<Dl)Wh{S4~{C_yCWgevf
zI3#6Ra;e=h$EwSrlFA#Rf|25BoCiH>sQ{XJ{U%G6{TETWgpB!Ga^>J?QL<~)`1nTb
zwzaDfO-}%Le_t7yj{CK2ja=p|V=}j?4lcXrSmxcf(&Ch=DD^&+#*-`1w{7E(QW~>q
zHp^R|in?HIZU>J@r|wyA77D1H)_D0v%c^+Wq{j}8T(QSy>&rDAzpWsgQr$B5t0tM&
znaeAXZn{=YAzEQX_eOhpOD2-tCRuN>G1(T(m8&uR@%Ja)kZHO_RD4XiT`|8ZnB!}$
zlNb%zOGrup-!gj5sjat5cmeLV0+r*&lH=CxahlsXeq2+M?i)5roD}kkWdu=2DocAN
zRVP}w#e+;^LKz3V;(|}_hS6GEj|T|JKA+xaJg=#nt~mNHAH~wyS)$dH3Z)o8N=X2W
zDH;7SdTVM8wg4`qE!2c6zY%9J4}`~Z_jH{*BF4f00E}?q4)T-9XSx9d0AF5o!UYC!
z_G(Ki4?S;>nQRo}tcr5LG~|!ftz^;q{{VH~#hsVD*;%;QEGp#<^4d~BO9g9Mu;s%n
z>%>S4BH8qmxC#+)>WZsCntU*o3W}s`CC5|s)QNhPbmN@FuuBasSglau#sf_!08x1f
zuE3ZZR^Q}Vp$?8hE!a;l2`^l}lmp8ojFU~w(ofg=vQxWM@>>fiUE^h|K4O2>Q-$M4
z#XdkNV~c9!;?>G%TCf~(HTZnBSCo)NO?H}wzh57@X=(Ef(;K%Jg5gcMdbO=7?u6q|
zOKIq~#Xg8jM^e#PRlmC@-d}h&b4|hs#8$F0PA%wVn?GNJHk4~CHd<wt!|S3}(oo}s
z6+Z4u1e*F)v^BD>Lv05Z)11Wud$dysQn4k#k}5DHgo^Z)P1Mv&Yf>3Xl+oniY+Twl
zF+FbLhzU|a{{Tvvns2;Xo4Hcb>q<f&!qH95Dwom{F|yzs0NBRAuf+X+0ZVPmwJQzB
zEmtkH?Nha@z4Oa8IbzzP6osiJW|$OGq?7)Ng0k-KMMv`f^^r7gd|LygG}vLcF}mXy
z0So*TIa)0}O?T-beDyxUR{9c>;sFihrCo&uDF^jbDj@xS$h{ygy;AatN4ueEdfjNH
zT2l)6>TqmQ2qv6j$`wR_gy2)Hhit*`VSO}lD)2SO<0AgHPMZGk8-+V(X>z-ITsqqU
z)*CbkbxJstwubZ~v=K;k1%|LVN>Y~A)zLUmM=>Z2SHK!lL-zfb<|H+{t{hA}zlh^^
z2y%gHQ(;4$Y=PBDs%ye2_g`(cgM7BRc5C;Bs8mW^SW1?XkZ7QiaE<F1bnd(OrlCb?
zZ%|WdZkG#fT7sOSN>PWpgjAXZ5KTmfEz}-nqKu$9f{RgF@SyUL=mRW5xhg+@vVN&2
zMV4ujmReyg+bz~vLheF>loT8)ZAx(}B;~ae=LEx#zhvdz!zpRtmP74gQc}@d$)*gm
zQj=Y!rn-MGRMlPT=>f)WT2qg_ZCi5PF1y}IO_*#cv^Eurp-L(Skxr+$lw1Z@(*85a
zNGe6cuPrFI%nbQTAxazwlT`R?_BW*Uz03Di6r~Do<<zCCR~Gsx6#oD%&``n!a;Wbw
zz({EfBU4gUadYoYF5!3`Qju=>LnJJtqiqAcei!yT{<|*XZ>M3LVes!g+hYF!D%Rot
zYMcqGlv7JnohU{|unbx^?uN{%R~D=HcGHE$DvvF~>Xcmn0K)F?9-j}g{^x#zTORLV
z>vwK8gGN&7mXxg=*PTgerogR3U>P?-*Al{;U7AXl%)5G_z@#Mdn?<^QxUFjk>K5L|
zUcbo~0dD)d!rUAWT{^Jpl9d8mODR$+a>t0!Lh`ERaAR>vZ!T>~EH0=;KU%n!b`;J%
zd;S^@he|^zd7In^lA0?Go)VQV-GnlwI$R{~6re{Kms<#J)N<9$xI)UU+F!(0HxeFs
zYCe?VqC|J!_n*J+d>2qA3rMtWmfZK>*_`F2Y2~5yJ8&xMlxahj5yZm2yLF+ITbqJ_
z`Z*^FN>Gb7%9PS_%oQEZM9KZ%e&_8z{{ZSq`w~#@UBvbfqs&W=Eu^=H;uh`FlG)EN
zg03+RDNkKADyCU1;~_~`F;CpRQjn@-a3gMzzv2B29f#(j=ZY4})P}{NajYV|z=f?L
z8Rl^u>9lOLy=~1?w?n({PaC3Ckje-{NJ2p!<)=9h){h>Y&Ch{tt<(VR)9*C4dCxo?
zQdEVh_2FrN5>0T@w1Rjkn^2~d8^`YG#I&i!7SNKl+!~Kki5tiCJI{${UWch|rLq{s
zc<YWaaH=PkL3-l_NI7PNB|r`WC%?=tW5rfdpy{i8ylPPykxXuiXV6NA><Fgua#e&5
z`^o`WaFImgP|k%_uaru|X}q=zbxD1;Z~zG{C!C_QiC<d|U1MK!*Y&jDq2C_FkcQUi
zS_dfd++m`Su&(G8BR=w#vG9beLFFu!B}%7pAw|WZIX0AnGAbaL?z>+^>#YX+*c!G&
zgr(OVDL4&lOv+TQ0W|>3w^MY6h)xxksev{4W~Z1HLC{r7+BQ;7r(=7&q%na-3b+b%
zv>3z+98&!+6I_sykn)-PwyzN1yA%c;b;R=pe-7WeQ;L)c#abBsf3jY`uTw|M_<?lk
z_r}LIt7U3!YM|weNCYHxH797==H;X*G)jt7-che~twhmvJJV?`_!j7sqRp8u<!MXG
zQ_FmeT+U)}s~5@zcv6rT7YkC<qM#M?SEWAlCjS80lS(#}UcJ3xCV?tAoTWZfvGIlM
z(#zLRED?dW=l~SWMCN=<Wm7xRt}J()Z`$L$m&geQAQC1Ly*PGUAgajLAr)DYo!iH<
z_K8wziqa9xo1~g(+dJx2vgibhbkQ}8X^UAimPbh{bmnq{<`I%+rs*p=S&C^FHt8dP
zl0iGg#aA5aE8atBCo00;BMx+&?xONXNo_dI7T8ivDhxXyEhKT0O|BYD^04NbbGnL@
zm8mNxSZdY@cDZLW>bXv=<$5!3MFTelyT%An6nVVH<GwbTHjDmZ!&pj+o@`UEd}S{m
z%?u^-jPmPMGt2Vd!QR;1TK@nmDp~iGG9N?uTji-uAXKuH8XQ3Pss><2<gH9Rpx`dr
zy85vMpV?Q*QbTT}4*nocbI}bvnQzPByZ-fy*A~ceutHX+Tw#{ii6JTGp+zJlAC{T*
zGM?<Z<4ii+$_CkX@3f*7Qk=o6Y3eniM+vR6$Hl#WdcpU?oJu*gDoMb#Vciwy1D@qS
zM5@(pU;bfdmK$XyNXr*><!0t1PALR?X1`zP&GfA8W<AdDZ-O4=ht{5Q1MN02k9SLa
z4taA<LQr1nH*YD@+ioFCEWLL)oA3YrAFD-CD>kJF2~m6RRf!!tF>23HdlXeQYSxH7
ziYB($n+~(6QL|PRrA2LOwO+rxKi}UUcakH2<j8R+M{-|}=XpKO8fQ2q50vkV<k%B`
z`uzfTDVH<O)xGhXJu1IxV8MZsaVF-Vy_Z7#g|Kbhm*hGa+L`Z*mI2AI4@Ws(kAE=O
z;`c5O^z>fdoD<G;<8h$ebW@SECn9asaG+F3Hua9$qS;b&q@K?B8<#q(_m%IqrIX4l
z-m7ad6$4y5QrKIodoBC48S~$`Ggv_KVV7XfP*1M3w?jNI9!<duX@l=KgqOu+#fZdO
zg$zR%>)cqh{DF7FLPFI)yL%w*tE#AX7OHtEmF6bBQNx7X#MU5gO!6L_Fs6SU?8p-S
z#W(-c*cR@}bF}|$HYM2PuY<0;{RL}jjVDrP5+X>*y>2j$wIVXK1J;I|jlp#i>l+SH
z@HF-2<x^!^3^}=o4?#s;K<0wd;fDiB;!UQZH2nRsa?fr4{s8bN8&dTQQ)FMk6Wy~v
z9E$>W0;KcT#}37WD!_6VRcSi_s_5m#N_*}IE+eY0lEm=k`<oA=>Z)36vCf9?G{})2
zZ}V2}vy`YI<a7prgthk$EzaIcI4rSBWA;A)1+_>@tsE?{P5t#V;rPR7hxMT~FC)lX
ziC&?bAD8&9NB*u{2M8Ro2aVme4x;cUSo2DtG|iNEl~Z@*Ls!wxH2rG3MyzHAY_d<k
zdWUC;cGIDzR9_}(D3p(`NV%|F;>u(G=&DRh>!8%bycEthTBje-{nRM=^J&OdyG>x&
zR=@FZ1kK<Ke963Yj;1+lsLOI+d~nFA$ru8pyd!F|R}L@y5pbM(<J-BGFr73aXR?zV
zieHd=Q0{0vV?4dw{z&Lp$s{QXy&)sPW+QK%m&a&}Fqozu3)gfzu1Mb^^EfDaf;iQ@
zcIv1bYEAX}T-tY-0GlAi-D972ahUb~`K6$`?<#O2jwoom6}~xG6**kM418%(h43d9
zb-(vO@~3az0<6$~*mdIFh@Kl(B$ELxZ^!hQ^2u59d~2CO9Sm}74sAHa^u?2p-_Lsk
zSsjwuOmT2Eux>?Lliu$Us{K5Q&mSW%hM5;;^4SRbX8V~Q>kcx1T3x1m8vm2t!=-{(
z-r=~tncscXg5pVhh73c+tiRv2K~oJ)aZ6yff&5~Ta{0>kN@P~*0=(Iy(^>m9Y+*v~
z-1i9Im6#>^U3_Y}&5&YYRPLbTa>0(Jn!1C(tTs(Re^^C;)53EYsLAyZ`TWtHK)+Mp
zz-xFZrpdgZc%~+2);H){8*n+CI1?^lBX-WwwiA;4ukqu|r*+B6f`aGp0($#7r$)(Q
z-?(>0r0O?i165nBc9fJO970TO)`rB+Aei~48f#J6k+63r1f4aXYeZdc%o}rWQCj^d
zk92kbQL5iYGep0d(F}wlG%;+CQx>-hCH&0GDd$9+>TqRs8R>=JHs53x*VGM+E@l+1
z+dh>cD1i$cS=viI2q2!dZbL8MNBeAW#IamB$8U)jru5wtBtG=kd_TveLQcB``i7__
zp=wbYV|l9Sma|19U;Q7zHRW8!V|Ydc#A6-V=IMX-X`b2}M6g8`HeDrm=ZzCnO9Fy%
zx3Z@Nx+)y7^o$M1)umr=|2%(Eps4}~)eFn%#w#U1dtgL?-L2+MC^s{TC9hVkWTn&8
zj`EMd5@@(U%Uk{%mt!%<%*K($5jg@5p9q`#DJe%VV2}^vHIy6q!BjSnT!Zyii&iCA
zSrvQ>y_;tLialJI0s$M2^Qdx@C^@js;?mI%nLt=b`7|iqj4e|~a7LH>&eDj=$oc<6
z;H~vXDUbi+2pRM{e!p8c15-I>iVP{fC>95H6!bwBXAk)G%PyyWV5$@n^h>e&0PfFE
zNCiR#zY)LWb*D(HR{x<&rb7#1<WsFQbMORZ8C3z({^!W141hEdIQc`hsC)FJ-2W%8
z7W|+4WPpIh`B(_LYhnPTQItsaQ>`&jw#@Tk88$b%idognL5Q1-fmTnDubMlLkrn<*
zR23`%5+vIvz-EwU6iD+P@eB`0y^1LeOz3i>dz-He@(Dcmq*o$Q^Z#BkdRNVAOJLN8
zgybQ9s)J9&omK&Dgoc>GO)%9wLKxL29io-Qsm!E6FsUs3dqySTJA_&&i*U;W!4PFs
z##941K|FVe?*7ldtwyLs1pLq0LPV5she(T{q6V}Ib<@8kOhaDOjeG-rKa@M+C@K;a
zl{QXmmP2%@OA*Qx|2HTA{EvWJ0bc+mR0-dJ8FdnU!Nh5MI!hQW3B^M|KyP9bbjik6
zuuy~pK*OW5Cj3mum7pR1Xi>{-_MPUr=FaeIU1XmplYg(1-k}Lb>R?>tCk=D<n;7x3
z=jSgwJNhn5A-Y8?tc8#(?NyiXaObf(i7|ZlVbfLUme|?3wb<YH)OUl<=SI=fOKJh#
zT7o7FPS}f!v&ZJrR9~A~%5Ym;9>+qxHdhWkRH$r!&R`!Zki?+{YbrDJ&#jkh(U14u
zgUE)}G8ig){k)dDo?DEII+bKktwY50Xsc92;M>b2wGn+jY_f`hZ>j{>Klku<6_mup
z&*gG)A6-SM;F<D@m9%!Q&i5Lg_o{TAaWBT)-6v^J=_Z(1SY9Tm`F>DX+m#Kvo17Ue
zT+qxBIhgzTX`AOlWbLijyX#v`38%TH+3Pp~z<{;UIG7#Bp)X4=)&2AoFS+PDKYBCq
zLd~Nk-87YtH7{m3=;B;|Io$QuLPYn?R?$1^kj>;g+nkvL)WWBrFAMv0hqClcQ>5IA
zwWi<!ol@2xPRol_%v9E*ONi!Ts<d4hO2)HFj?eAN1#e!&ab@KVyC9rrTtd(Dbl(ps
zWHYv-ZPkIVv%Z=6xx2)Zyth(#bq1!E#&Be2+|`&8JWuL&{uep!q0_Odhr2v;tm~G(
zwfxxC-f0VWzDEu>u%pjyjBq;JVcJ+xPeN_n&Gy`}T!gT%A1@hFY(WmcMB<J*{=#Gy
zu5kmXHZ{h(9x1Pmj}qH;hZdEOmgv{-=EiX7sFb<SNN`eIz_xT<t`Rf<yzS*L&yUJq
zwHGx4;AWbY^o3ThA(xyuW_-r7e!t6RzG#|J7eGrw=hJItu|;@+(L~9Q$8?)~yR)`S
zuAS9&g<Z~+)hJ)Nm+-0M$ymo&l2_@CE6;74JUx6&$>!-d#7E$~$~>^mA7O;CKL5~I
z0!;OuF{rR1$haORX}#Wh)GP8b>|3d2ccsy)0*(-4p5{kJPcQF;N^VtA-+f&A&BG)1
z^%|SY34^|Ya<keB60Bn=M#)#5n;|ha?Is(TAd}kZz#8GH`;n$}u+>^k$BZ7k)ejl(
zT)BP@LLC*OiZGnDGlFdga5pAOGc|aX90Sa;N+5r=iP@}9P$!tKKJulCIM|ML`*v#M
z?~H(<Z}^Yb&;J-oA9aLtMC5FZLAFpW+roau{XZYAOrz%$V@Qk3LR=Jjg?cvz&;GW4
zQ@r$de%FeewrwY29g^?s#@V(bmUiV?C%g@lf>Vc4Aeh|K-Va@E8kO7a?^&tqZp^?k
z)M=RmXo*Nr?LkLCSDg<>_rv+YIofqC#~Xe1uThxvExw`lRAV2$BAE)sj(zFCS-vNh
z{XeOzB<IGQ5-loo3D-q+9v8`*ejg`2Esf2}c#YkkRDsGJaGq7(pP~5CoHs0>rL7)M
zQk%x+b3sAX(ov@;NFO)L(%LaOUGfQIH-ie6+&l-lEvCWL_{wawg?C%hgd}Ai5cgP%
zp~K*$ovi?An#CAijR^iwn{{FEm!nA0y5pef^`owhy{(<y{jr!ac3`${=YAx<#lyqm
z<i^!HILAAq`~Yuaoh<`?Y>-*q{5!VwEro4?Uz>rUbcCh3mM^{XyWxqj$lDse<_JRX
z<>ubbziso+txwt(YPRB_V|x6Yv(l^d+iXz)c%|q$d%~NR&_1Q>g%@^GMHlCku4@Vj
z@>&ZOd*`eRbvAnqVQE@3rk1{Ld~Iz0pt)70Ig3D&#wFb@^o}s@QPr$?tYY$$STprp
zCU6l^#^Jx8{x*90XTLXZ)D~OTR1S9FOn5`3*t9ebsl(>PZhonX<egR}ut-77w;twk
z9bMQHMnADIQ8w>ZV*#AYGrRapDc9X={IuQ6p}-*Ol$-f2GO*ewhTK~&#OXe}TI2$P
znc5++omDrt($~ld9;<AVki$APba__mXY+_aGZ0@p3gv*o)nta#iksS;CT>W59X`76
zVXtLJp#`F~y1q+;!TPvbN?S;XOZZl#l;E6Q_~)EwJ_b2pJU-IY!uxoZ&**7d*2A}*
z`#8R|ZjUX3^2aLFqfV(@PB-Q4i@yW!5E9O={X#Y_mVL<fvKNqm;+H%$A|&p3;;o=Q
z=gvr~%Y(nH!>^m46NUg@M%d&`L&}+*sAq^!c!`&^yl;-D?2q$Bm)x-ep=Y$GcozUk
ze@qPYo&YQF#ZcMmH8UjBw)8vlRJ0>{E>=?KwtH9uHeatPIc@*|4^$p8$lkaQi3Mw`
z7gQ3i$EBMP4%XPO6D!LNOY~pQGT<H67ElkXs=VX2cHEe-ZxP3#@j^&<G{S>Os=|bJ
z%)<)!Dezw(>~%ucjD-r{FuU%dT#o)`Tb+(utpKHwv@$NVpIM})u1imfsLhd%?3p>+
zSLQcpK=|B4>uTp|^QXfb^Gbf!?m?jyJ@o0{c=1*woI4+g&0;MZ0e8pr<OHwuoDp4)
zOu~{476+a}8fuDL_I5Zp@)f(cn>gKkrble~q6m%)hodkqMO98zozzA>Sca_FFwLYG
zNcWRzP_sjy;`|^A>71w~u0S(0-Yhg>M^ROl_VNrk0zki({|`6jfwZA84lN%P^UL0$
zgzp((UVHUtUlUT}bm#=xw49o5k5E;<8TpF%WMLucbIbOzXT?duSD<Q|9?W)prYft~
zgSiqutp;rApHJkz;E-&Kj|P|*V^8lF{v8-oQhGj>5GiC}iD0g>;i<Tn+IUdu8*ie`
z?lqk%{dUz#G2E$TX(gaJz^H*^Nbu={AoSxNoQcPUTbRDO&&;{inF&V0i~7r>R9(Z4
zq?b?0CDr|)=U#!V>dk1s4fX*mR0?iZc4_7aPdte71cK8ZHt=XRYt(*6tZXY{TPkdg
z4pz9UOUWn0#jQ}(^f8Je88eq61*G$XaM|uo7kUFa1NzB@uM2w{Hav5<X)eQlO1D~m
zh_gegsOSO<m#9m-J`O4*lODD5y9IM?r2YLxFX3-az-Rdjla6l!(bT#x8W>adqi_b%
zwce)$F<O%GK6{7bLgtZ25VgwX^j6)89Syka{@j>gPjPpR;AFm~3ubU<45)fSTy`m|
zkwPQMK4g0oeO_&i?&FNuwt^CZF-QaDz@UNrsq-v`Ij>!XRI^~7ibcQmF5%9GzOlCy
z0zNUtyFE{4o__UWPtt0R?QZoe0N#IyrGh_@h?m#>n^GM2?nejI{3f>unRn3xS}BP`
zLc`&aaeNzt>k<>PI~|nBXX9<jU>3xhWK0#`Oi%3&W|DCE?)NQS1z@et81vV`TC3)l
zZWVyXdC(`1CCO0*@G!Ja)&}L%#_nwK%6Ir#-I5ccglNSzewpX`uf>y3HcgKR0T=M2
z6`}x2Q{NM$F{RJ$+XV9|A=HcQm%+*6I^k6Y0`K-|HQc;>ouv-B(!c)8>_IGcn#hOY
zeHuFUSiFl+I@>%S$938b=<;}9VU^{D=-@^haHC?2(t-B10fd$^4~vOy(}e<V&9Rmz
ziUsP&=H5mC{^nek{9avhu|vaD5Wq}S+5$9#%(sqag_-z;5t@wjgx38VVx0ay<;ZGS
z<onz^H$ME;=_p5^r{??W_=O3i5lZ#$bc35tTCL)?4eU_7uQL&q<sQ|}kkD#mKhXDV
zabMu{cH^%~dh<;zb>fo;)Z~$sXcm)%wz`$Rte-pZtTj=vZvD<^JA7D4pB?dwPdZ|K
zHlv|Q(6oHI_T!SJPw8Udto^~BdloL}g<#NXLrfy>QL4ji+H+0Qr?rNlH4KxSSBq{3
zC+Y>Y=my&sPoNnDSEa>$Iead4eOXb}r8UWi%AP$zYb4{SR)`Y5c`g9bh&?>ibxtyl
zBV?#!+fuL5=mPj15!A1t%|sApoY3tfcHJls-kGY%qwZMTF4;h7+_C=2qD8Ns;-}^p
zlmGD)>Af$~7QOFPh$@xMI_m!@sQ#>_(h8#J2={TdVKRB8`0^=mT(MyUrr3V3ie;IC
zumk9RP><e9S0xWkRQc>u#CHxYFrdq*I(*=Z<jZrc4PjE{$2@rvf53(awVrF)py5!X
z5@#@vjqpIE$c|W|YphL;@Qh4qmxUKac*r?eKOFl{i_jAou(KN$gI$MPZDDcRi)1v@
zb>dC9i_`HwJe`+t&QY+9nO%hIbOx&q98soi-7{HO^!(_3<X8)K1*~J=nBe4(PsH@_
zPyqM^x7ogcIT#+U3-;J!7;pOdNJ}Z~HoA6?!E-ZPs*IDND$f7TJiLBuadg5FC`94V
zurM29eSr5^bODq>V{CiWrZwhfD-|Obz4^oY1(Z};E2uQ%K^^p0&de2$mVts9j$ipY
znfxFNI#8BqQ8R;FPnoV*ZfWmB@{>XR4fs3Qakc?Q-lp!hca#iwyLN7frCX(*w)iuL
z?RhJ1P%vING^<knQS3QM2>h|kkBcipMQlm-N0u<wDlSawHM(-XTiehl)N$a4+W#nI
zO)|=g7zd^hk(%5gYcork%XiAqziX+GCD@%tc|Z`6(~aBnWwZu|<=+=P`xkh_eDoi{
zBWdN^J`52mNbZdLOS{Y$jCpoYoize#diNi|$d^J$6^%81^21jqiLcJe8#`T0XEl2J
zPH;A}v2|+?rh^;_EKMozi>x*b*qXLbJWVM{>EJuaa`FE&;whP_uCYFsK`yoTFT^)W
z{hua|Z|2eb(NP5pxxC0&CA203Fyamb1a~Z4!hV;)T0*c38&P2-F;4O?Bu1>Z!jy`Y
zmj2j5ksI8ujL$}}<CSNQRAJ0Majm%=;QWE2<ZI25M<Na0HDC`ut2^kG5_I)j%Pbz8
zqK`Xt0o;j@z}JyykCvmp0`yjP3mk=bTt0UB(Cg5Cchqy1UI?+zu8}EgEkRnvM-)N|
z8+VYSfq_5X87F&hyf-oDI%d`Q)|A6uI-$E7FfRV9vb9~~8kZkOtMN%n!O77^ZP?4^
zAVbh2b847*k|CI#qx0H#>ry6L*>b_UJ3Iep2W{MHcqy(tp?bAWF3LilVr*x%wr#%f
zLI$zvBZ<YxSFhhQ2zf!`I249|TP$~_h+M08)w}!~)YkgGNvrp;*P7qG*;iljpA5W>
zC799>vn{piX)%)?c~Dy3vB*r7byMR!_AJ{obF^f$k^QIC`@=Kcly<$<RR-u|m{(0(
zz(BnD_+II>Rad31yW?!ejvPtc+X>%brOJPKNvN@4>bid2&JSy1?>s%YGM@fU*;yB^
z-JM*n_-+%*Wm407`y^{M$?rq|C{5XB2hz9yHbcu_vUaQX85-^E`J`L}LQ3bol(Xvo
zxGNr*w0m4o6v28jx3gLxwL9OwI%REzWSZY=n-Cxo>I!V3vmloQ8$^~+y9=Ei%=-Pd
zwprdmE+b!rgxLh1#$cU)k+|3JN`PJMW?h3fti#TJD@|lMu{&>bZGnDAr8+B|13%y_
z9x6Jl&i<aWKiFQi&`+#wZ||z&m-H2gn6obLu@~RJ*pC#*TC(;*U6-!xSU^chaeVu6
z9r|~TH~Zw71p`*T8V}T!^dYVjE@KC>_}wMz5L)*OLo&{-oDKDBdgp&BSg_hipDkSH
zd2#qtQl@YKY50nFM?-KZ)8ovcmIZx@>3COf#0%5>GtpGrsF$&*^Yu-7w?zvr$k#Hw
ziAtV;Gx^B4f7S}3k*+OpY)G=$YrmekIOs;*M`xb_FRcvx{<AIJ(0D{+=e6?eBi6`6
z17F~_y`_@qQ|wO4ifiirFt~a_cqZ4c66r^Vx+KrBCNsM$4yta31ZYfD%|r=&K2AVu
z(nscTw<W-*GsLlrW!2@pM8pIO|E}LJdG$x2-H@4`+h1z1r+$f#E7L98!JoAsqrXql
zf8lqA-~RIVNS5`l8h;$ENh&GMge^;`NbCyLi;G4g)T@DNNhLevf@P~MO@*e2oTiXm
zz6?$Py_UF2pEO|p+<C<VU}O~VV2vMl*Ay#!VVrlIh!Ff`VjwVQ#(=2&ws5bVjQb1e
zRLHbCJ|kF8WB5(101w6lCaegL8k=@vR_&SF?B^MlD_S>n!dQZ(wD*E~+QlZyzWgL)
zG3F}-#%&r4(nGE{fj#x)Kkr&DD;P4JJ=p{*JoZ$Fw-w|`JbJ8<6vTQj{Bqb*D=7cO
zIU&hqi=Ul5m_9^5*hS1Gzg#y^4W(YyRa60E@D7@9VdJ#WF|eWWwQtD^fa3ux(>${v
zkPz5UmqLa&`uod=-H#Km1TdEs3H^^;cVD6#_!?Sk{b2Vq{xS4AdejO$1c^Y;yqzYE
zts?{iUU6NqlSuIDX2WL9XQTb}XpxzH8D^l=VXbmZ;W%%g4Id?I(bsoS5A*N=6Y}~E
z@>N6Zab{rMqt~ki>7U$rw`;v~YFZ|i8hgcli1)?yk-z)?b%a@8!mqZh>sl}MS)$xD
z^&`_fq&YuAN9uFmBcrHw{ILg>Zx(1K!u+!p;SIjxNb?izg_)cbf__!Ft;}A#crELH
zZW)>C#c#;Kt;=VWA!~)T`bGD!j{-h$KT1V->Y`4va-Z5bC2t1u&BztkNqx!0+;m-Q
zJH@1mqa0c#2Y)p%{T6(h^(!PLA@8KleP)>L=Z}zXrd_ZO<4S#PrhLdyJ%=F#*>YC7
z&m)s6P?|HYs5=a~qV475jPaYh#5;KIHu~27<LolfaSDi(b*}96!fwf&Tc2CkleA;Z
z%D#%r!`^r3Nb2qQEe@yPmDy~qOLaTdN$X8;k3;5HLGrqo)KKTfwJu04fGjXCSGrxA
zIJ8f1lK0NdKn#?exQPUVp|h``l1yl{aW70awQkv=ASSvuYT{Ng-pelC0YGc5y<oQ!
zsU3GTVf-}KTr_uoIAK=bR-&TJV8SZ+k$)&HKbyP5!(V%PDjcDoX5O=CYwN!D=Q>!>
zwEOUf9147XH!_nE-|<K6ck5ljm>MwIy;=i7Iuiy<QfJL7BMrwl`yyk1KJBws+O_%6
zgCa7OCtx4f2*CLI{|ClQleK!2wJ>-?YEE-^`C|e!9?~`_^c>pVHza6EdWoI96dXfy
zG4Ph-E`$b3moAGI%?IaB5GCgOAgsBlYAQAV{$ncv7^^JiwKl0_dZ_$3c-}0^*juQO
zUCRQrF;`4~!-DOtXbHlqAKbU9$^`qGJWG*N;-MZbZ%ejjH?u+cjbQyFv9;ztY!f1K
zj^(G*EuR~|NjT<WJ{cSVs`3bo_Y*xOJbxSjvIl^gxTQgEKnBq?;6qJvKGvGMflG{3
z`cI4+96SN!R9a3(^o`u}s`u`wiV`^xbRJl9GPWiva<Q~0cf_eEU)4?t4)J{;H%<$V
zrDLG}0V#EK2c{!mnZ95nl1c~gu@b9SGiCCKBU;HDr|%Eb$y;nvDCw^190c%(OI~TZ
z!7trU@&^XpEd<5LO{ZRrd0^Shz!0+vm^Hl_n3aaOWV%z8gMf@*HA+%tX}$zdW@+*p
z5%rnf$x^*bE=F#~Z%|o5o}i8c1mwn4o2n8V*p6^wb5Ik(S^_quj3y{qD4E`3;909_
zSf198p9bCq7hWm+A4-<7O6wfWnx>2MBT6%>q9yhejbeBR&?m^Q>zvGq$;?3jh&_N$
zr<P4i5J5Nz!mc^i?{aH2OM~@zBD3VbT0{+Szmc>|-Tew0)^GKy5|pK-5y4E}ay3{?
z$Ya{_r8k{<7?rUX?m0UK*_WFPnGxNM0@=ZHc%|U|X9+H&h+VvOUrX%t8pS|nQvE@q
z?x!Yua_UFfamT@0PZN`0C;K|e{QSq3ZU5RaQ^+^h;LR<}`N!xg&KvbDzTh6xnv&>Q
zJUhZ4_K(HfC`UEGSj%dTSBlar3^TO-JaOErm)?1}=9@%TGp;wU30b|$O^V&L`egq=
zOr?;$zVcnS7g@WUr*PZRrHs^QHSZIe9l0@iiEN9eRol!trycP_nFX6og`jw5zhaYD
zx_YJChxEi#zXV(|k%V4t^G8c2fr0I8<d-Sy;LA6EHFi^Ca-hpn(;^ZX!Mn}WdSMgo
z77wCbbAUOxoQOx)$)i?*`pPpgvY6R4(M@>!c3Y$)x%reFlsq`fNH#u~J;8U#wh^CD
zH0r}qVYuM(TxRp$J$Nb`7{Z=f{E#0KP?){+X(YnvIsU^3x1FN~shYgc_Uk6<ltDu;
z8)4Udz+rlN;tYrfgDt23x|Phk=sg<;m`@c|6D<}vHywlFe<n-=I4_@jWg)$ZDPPld
zSKn<)z4RsdL5eOu=2?Kc`;A3(J<<#A5a$4z<j%*0g?j1}o65c>0UG(2Oa7CjPu^>x
zr=?_MB!Yb=YB&)G#<l=sjkz5ZwFrAa0(8Ozs`r95drrN0+2&%2qsuGC+-6t#KO2hQ
z7)lx3NY>pa``Lmj7ax1J3q#L(JJ#t+Me^G~Kj1wmF~#s<eo2na579xqSf_#sB<(jv
zXTscZx1==parT#D+or~?FQUWKUDoo4M|88eSz%~X*}rbLzIr3LKHRjlm&#|+My*KG
zrlrlB)uww--Pn)ZN-F}UsFw3=_o*Fp>~>`NPesSjW{sesoz$~{Zt28gq|uU&7YEhJ
zPD~aWsjD3@rmI`Q)o$c$aQhIz`1E`a^tWj?FxN3<C8?gGYbyt2rEgmuP=R`GLCqf6
z(1&nqR)=_+StKS*WR|l3l#5W-Yg)MI-k<+Dn96x!%_!o&Hv?Tn@5NeoRB-ru3q6FV
zxc?yaUy{ryC*O@|9-oZe9FjVG_PBn@FGBC2Jo83+_XkOU<x4lrv~P}=!`XR?jU{9X
zAxLJQR%Yb#+uI;P+<$D_{F`Jfc0=dSplum;cEU<)LSengKxCACPm^CuKO=LU!w!X=
zkMnC1u~|L-(dEj(RDWPO@|Y#%AV0JT?w?t0UY8|Vq&BOV>JU*Tj@oW{m|^n7<9fF%
z8EYLytyzqNGcml<l>AkGk}gyB5oj$L-`?EWJpvWHoYu-k&hAc}xnXA}P|b__YJWdr
zwJVr(9c8k?7FJU<{mTBx&!2sEEG>%>NniKg23B<X5c<+e;jER|>&ICk<2W~=X&=)b
zPwGlQ3AK>Ma9{ABE5csK$s`qASdZ=LeH#70wr~9Ro3{H;E|Q$?zsih@WjQr`M&Co|
zB1{T56uOVC2a+pC8wCF2QJ5VD=Xk&0I1ZB`_(_<@!8I=g?Vv(5!W@CdZxby)UosLQ
zUGE1?ij`wDyd04kIJz}eRY~%S`K89|8<F>HlOYBFJ_p{R-|v1&<6ROXL`^X`)FWDr
zN#$rZ;xE}|OU%ZUV7FC)7Gql=n;g6Mt4_P2iWlu@MnacVYq-agvZ%fZx;2t>=Kdj{
zHYEjPSG{}g5a}Ju3*3Pkq5YF4^TD0Q{IM&Mp5P<bjOF;p`GkJ9Lwa#8;;h7(x`MzH
za|#XjZ76RbKyzNgXmpX|WE5E#a&Uf^FMpjcBzJ2$Ng9v3bR`C^;rC#FEBRs2qG=hw
zAroionq9t#BV2*&>`A_j;IjnY+51O1gYrY+yCW&Ty+t_g#%PqZmC>B+xSF0+VW#$1
zo~Z~fybJlfQ(kTmVQ9Kx{Vlx)8XJaj37EroXC=^tva~$}#zfH<MsdLM7E#BG3DtR#
z<<ak~9jCun!L{z%f<VTYqmj<p4=BajPZfm?8k*Q(HNGjqqa*AZ#=mv4U%=9>KzdmR
zQjG~RG?a5Gkj@WF6=sZ~xzKu$?K%0(@mW#swcleqTBubY%2-P~@TlS-E>IJca6m>Y
zn$q|9fmf$#@}|_U1qTjW1?L!!#02Ai#(k9MT3XcQQC{@LZ`K&PHun(U5^^G_-%6Vv
zTLP~hAHS9i>V$4ceJ8sMgpGuOf<1@j_iI6AOT#RIoS)VD(n|jWfN#aNvx}lp_jJ5?
z9RFEsdGyDRI;7l#DkVlWf1~cYWd?Q|Bof60#I?IGRUPG5y2NBr-Oa}F@i<23bb@&9
zmDT>H(~Y|2_Vn?J?TUcFA!cK{)q~5+^2rcerdxJl$^7VL5w4TM3dW!CF(CN;i=o1~
zuDV9?FTU+aznymL@mk$L%Z!G|@AkQE&QrT$axZpEZzL~#L5r^MCN+!239SJ1Xb5Ms
zd)VmMpK&Vdt!INxm2^+d73xdgz({sdb0dJzs-FrIe+5J@xZL>Ymkg;C%&mz3O%;hz
zukg%gTz_*esQB7NLnvlsgu&Sbe!vuYYUi)*AYl7luD~*rRsQ_>dP?u0D$G9<XO5<_
zYu$s6LLDn~_NTse-4Hd_>uLYA%~5FSP{tTsmqv(f?)563W0J;N0<*TaN&97pG>i!S
z$iaz6rv$GWyBb>D0F`WrS{~E&yhJN*G-;ij@Nr-5b5`u#yk7X;JN_TQB*|#{s(QQ0
zXt&XZ5g#i9VeCuXPr_275r=05M)4G6L#&ot@;yom>Rs(u3BmtX-;<oT&~ONqAif;@
z>Z{;DVkla-Tnf7c6Z0rdl6mP1ehQJi3e2Ld5AzM>kqd7vsWoiBHJl}t80RO_b<JIO
z*AkM|KPf0hE^!d4%4za@LkEIUJ?e*c4}Y<7O5z|8_r^{NrD@X0_arlamHD+%6Qx2>
z{sl_HYMWk7UBu=tv3iY`^co!-(7$(aKHo}%XfGRu4sYpbt+_u0uPl3ue8K+S=Z_(3
z;dd`ou=KAk(OlI=>@tVt)7aqXm6E$s&Mej|H&ubM7z6ek+OMBCN~>%7qFd-%*3Owx
z3U1Ojgm|qE!kcreYbi5Eu+Dz2CcN+Iwj=6MVv=cF*^vp0GUON5U&+I0CD?-~r_87R
z8gz~CF0QOn1^Su)a;3EPmDIV&ieYSdOdIXS9c|{9-(xflZ{%*NZW-)Sh;i81_{bdq
zvRk+{Tv+8_JozK5TibO$^W@!V#Cl8Tim}O`KhZT?0i-j^q7?U@oW5L0&`1dBSVC|{
z5R$RkMoS?k{_C6(Do0_rEzr4mrjPE<!u(rpttdw13Y5`G%}#6>`0BdPL{(3lAHQS3
zzxgyr1V!l2;VB5pK(sCIy{aTbC_J}q{%(U?2;3no>b0%Sy2SVekuSAh=`UM&Xc$1J
z4Lr3yUb-7TT!n>>Ij_?&_Eg8TEvItxM7=38tpg9K*u8i^e5f)g)!Id8O2c?+9YM3w
z6t}+uN5p_uaf0pMMEKC)adA4h?<1ayTwO1ozLV_sjQY@nx7o$0=OX-qB<q}kw<^1l
zT|r7FVO_nN;EOm+&X^1hRJbK{q~8N_AUz!=gAgr*)06c>tqE6LFTD{<FVvtHEWU$x
z?gIBs9^i`>2+rcncE@02pv(74oF{3Wh-?e?R80D5IA77Ur}|?G>3aV8yinO9lk7)#
z{HQxH!fE>VvAk8U?S2@%@i~llv+bSEvX(uGZjd}e*-WQp=eNO>Hs|09uT~FEsl+pr
z`RB#H1X^nFcpCeTV;HN^4?exG|07ab7bq;7{pIOa+0)MGbtrctnS3iw`KbEndnW1o
zkjQm66F4$^%s_yMNEiNQq(SHxW0j&~d%*r){gG7bPB}kZodu%f`$#fwHK^)m2OIy~
z%Q;rkqVn!bt>2np*rWWK8Sih5e09nca$KPM3mXiz(50yFp$>6VrSk<P-2UQyp7})^
zgq7=Eu0AX#4!(aR>lbuc+N|~BL~>D)Fpqw|;PfxhZuma{2^mT<yK=3IXE4|tm|BhQ
z;%{QG=2gB(*6OZwro0cecjL(!MGnQv?k2u_kf09<d0a8@Ps761CcEE|hg?UHtcB~B
zK2p8d%6K4TPVP0U2v}*#WDH2uvVpVK*3xCKPI#zd=TG<$V&40|wT<r`L`(i5v5RXd
zA#Q0aX_YAw%*ybn6rdk|x7g;*G`)h%h?`scDPDZ@rYuYF$J=QYQ>ooBrW4v-ys6uQ
z6uFQ~t1lFTa|W0H+cmn+B9&7(V1>r09P7f730pwOE6VR~F>_+qH=OTnK2XDki!RE0
z38%Vmj)%G=oH1r0L*iWMp(dfBLJbYx_OCQU6d&*fGy9oc&mN?v*)3cPPgU(R5QK$i
zHI#1b2Bg1nF+UTF$nNGwbvlbE9#*$j3MiU=u73Z#%~d{61PrO1Dqgo>h<(g6ud$Em
zDAAITB6en@&%$EYB_S-HTfK^4VtQgkeujtpM_HM*x+lMB>YGIPk^ZsZzI&Y}9`=lX
zW<tEjP{M9)dkA%1oPiNlrNQH6xsz`d0?6}ctXH0qqanw&M%qJk&=d?vx-0NlI`-PW
zQ-7URw>5)5s~}4XjQD%k(s{Zivkuw&&~Z+>ZW<W%P}n^{nuC`yo`V9delJYokB1|g
zw4QC`g+{^9v_zeD)4+a3!xo$5zJ*MREBoA}V$e6sGp^m5&m#ewn)4=}VZ(|FcnQL$
zHowmqONlzz$<nvN!4^UlDs?TK@TSyOkSe4yZ>-b7I`Cf3W9p#B@?AX}{PCDJ{HQZt
z>~(AyNy{TI$sg8Mwh|xpt6)b6|GNhT8)Gwi>*4;dRirtC)`U;{x(y~h^=(=T&AQYp
z>B%YYitXVo!wl~J?rx=NS?lci8G83lxT>OSxcFuBbCCbx+}74dm*)PXFs<$4{<aCA
zRm)EGl^Gm?iNR(`Q(T4jYQv?{+LnWUEO#uq(N3GiRhOIY)>F)nsMvigHh9){OEz4W
zZV~ZymDwaTN57g#I@Y`G>jx|L3d#_A?SK4z%l5&qZIiv;-6+O?FaksA)Y6oui89s~
zjy$_Qx5_u)(jW*ygXn*=mbPtih_O`Am%n{E4P~*OKl|)ZR<`a3i+*btal#oJ#!1Ia
zIXdSS(JqRFrBV{I`(Q0odaM(F;C#L(PhnrsX01_IsN3m{Z)))SxVkd)BusbK<5P2Y
zS5qL3{H91!qI|NR>{xl>%Hu7sqH_81ziexEgYR<ii^px@@~o)6^#NSp4bO#9InvnT
z`TKNK!XiHy&$dq&u~-B;H9@uYui#Bn{R^sB32o%=C)ms)kjwMK+p((W{lD88YAu)S
z*r7@=(v`MCL3@KAcpH!FaYH*ptI6l0@286q&onj2)sJxKWIby>qtfzE%jY!=LWE!M
z`kq^u%kD*>_Y{_gXMo@9l(vG5v88@St<Mzc@u<su$Jf9=J2slIl_@dUN@pFj5aeQG
zwN_&;B(fIKomEy|>hw5lD+jVA<4{;(lAy5*<(0o0u|PEjecs{l@$}K3ug-2(jQb!k
zXf?EOc(c0IKg)>tWQe4yumxWshdfz+j%S~^3iZ@UmdTZH?(oSZ{B0I(F+^m10~n?n
z%Q(9c0bbbc!Jy1qRmLC4IX6N+V!^~Q^8nfmjVGV(A+uCf%eMj0Ell~_>%2n6*)NaL
zJx_=WBKk0IquUeO@sil&i`!G~@(EKM-$|@)D8p>7z`ar}GuEfKy-$q3KQZpR1EkCQ
zem91GRS+%ba~b2U$OqWWAki$fUAzB)m8v@d%mPO#&_E_bB)c?`%l2SPzg9V-{_Eoy
zGzD7AT~@ol>f}f)EQxk!*@BZLyEcA}{&Y;k{htE>_*JhJCoR>it0Bn?`C*URzLROw
zl!vo)sGDbEk1TNFzR}(w%(lK|zUKQo=XX`}W$?MM>-}tY$J%>@&4oyO!Ln$p@I1BW
zgnobxw5n0alCR6j1_C#Ep*gEr)u)#pfSCHkZ|q2?0Dr|0v!J*xn%IX9C_gAs?;s1x
z&*GIPD5xChxEZ8cTy@F&087kNmH9?h7_bl6#Oqq*6-hTa#u?(3M1(Z!1G<&uCy$P&
zn8+YJ8)5>vSv#$=CR){X!`&%k#?kqoQ#46IMLepcx-I&W-q@Px((H7r%Jd|rn3zYk
zvO3uAWb86hm6Yl<1IFR3!zfiHg#+<r!9mx>wK35_Nop13U>py+Xuu?jt4umw7*$4G
zwChybZ1cJIo=HF&mRU9z`*uhq(`jjk-<em;QpOaU+K7wKu)%pthajj)YXS(_Uta-4
z`dFQtL$vAyCgZmiZYt_w5%)ZnsFzQ&OCM8$r<FYpUklexeAAJz?U0~-TO|*4nU3Uz
zZsAxzDt8HlN;XNMr=9h^Ifaa0`c4^`SQ;epJ1Vq{Jv6P>gsL9r^Eu>HCUlSpQXZ#B
zqR9e38=*#k#@u?D+~BP|Fjj*S$DM$y0j<=Mc)J1$l+?c$m{yhsCtiv%yVQ<5IOGM1
z|1Nv~*NS;9Nk)O8IqSgoJ8P+t$2j+0rU!|9R)nMGnec(*>in<0x9WFccKr-YSqoev
zuboGkG50)2HQgRCa)E;YS+%OBWb|*j^NfLNOVFJC^d*&oWtjw)|9Ocahjq683WOl<
z)Q_-CNdQW@Q9`+qu{WFVU`Iir%PA=2B2(^%)BcceSB;Nq{@N5syT1+8{)(|8Wnbc%
zK3$sH|M5V*#1B+XEPxrS{{ZCw&uHPa_h6kZ{z~EX@6TkvZ6_rz-js*6UO090R&$@W
zoJqbtm0A&fpH<XltI|9&yPKtOv(`inowBeGKb2Y(p@Lnj5e)aSey!aDr{9i?&<l$y
zZY*SakZ-?fD9nKolqmw{iq+pBo2zcMx;5X%J-U1!ZuhNs`F=2cgVom#wj8To5kB+Z
z9?0`Rda==IO#O(w>TUcnls{c*d8uoQ4Ab8)YA(+z`!ps(c#O^tnC@OBUl;C#?TCDl
ztnT-ya{u%g7BuQ^W_wTyrEa2{UtDrC^Rt+?D$vwN7nRq*Cy-sb3@)IyF{n^Oar#v=
zC+J#yG?!51*k`%~#y+i)m?qr!K<Z3EnQmQ_jm}vKCiYl!F9-*(YQh~&N+ud(?oVBW
z6z|}}7lE$^xydr=sfe>40vx$>iSDS0s?q92+p96CQi14=?I{U(Sl^Net6FK4{;*aD
z>GTk8UdqHq0K{xA1_}9Q1F18b7X5}8u2=Yt@bX5ngO-}?Iog+kFGhj1S^DZg!F6K_
z(?$TH5>Y@7tGa#<tIi0@0Q~RCGPAEc1S3ZwIZdo9?Mna$kFlV52~Dgf_b7oJ)5gN1
z1Wk3ah{=JpKmZl+PA0M7hXE2|kr?AqzQQt0)cxF?)YBXR$MhKz0FX!94;L_y3`#R5
z&}^K!))O_UbV~x+wggn>e;_j_FmbblD9YNz4-|ysF59yz@9RalfheaMc&~UWDDh*k
z_xtM8$G<ES!ZJH?soz2EU=uSiLcLH8D9E@%j=zvnyY~TagV=`@AANd2BvZG=T%#~A
z^Smi6@G^C|9_&pf7W@8erIN?}>n8h^<|2Dq`k|*!5z@iuXd+bbWy@^aSwnx=-;pZN
z*4~js?%~NF-~d)?gmTMF>Y$R}{qek3$Oq*OAF&fT_imR;pQ2Zc7J=(rEp&~^-JV`s
z3t<PDL06t=M@6Zv6WeR*iuCZ%`=H&g4L#wlX=T6I<;H;k&ZA+bmHB0|lg#V=if+OZ
z-Y|qF8q~ZKEVYDJ_z%#u;`3m;ST5A?S6;~SRq!RvCllCs-v&5=FZDk_&Jja!)W9mE
zOrMg#<g5H5o=dTu?cP?43a>6&JNGSqGMB|IVq??Pz`L|G8&BFffhekWKXI4<o6#Gx
z)Lve{f0^$?V6Jxg&wZ;DoV_1PE|Hm?3i0DHBEnu}Ad?aI9)p+?A}ygGr+fR^>^rmV
z=SLugUJ4}sE?CGX*VJqr>8I=Xf_vLTUWbN<{7_My#@%Y7^>}Bx5pD1WSS%A{6D}~&
z99d*<zT=#R7^P=0S=Dkk`N@5kR!u#v)DV52qy02nqaLSM*E^BZF<u9yNl<xn6n)=l
zJ@}y?>F;_#*x1*lV4HBd&<M0s^yY$~JuYp@m#=1{W=2(p^GP9(xAOE?pX{l71GPef
z8)*h`L#tvv?76D~v<c6$l{H&1z1dj<-E|MT=&r`cT_vK`23tgNyDo*`J(zyPl8`4g
za&-C(I?!?KOT#bQ!2Lta=(B5f4ReOxjZB=v{=1xoFVnu(4Q&Cxf*0%5m}?@s3j!rK
zy@BGmm%olAKaIuN&DgM{VcC8fC0Y!-zoTmR-U=96ch!y<lFuBv6|vI$={uF}{>r|J
zeWrImVc2WQGeuH4uwckhd1Q-MdMhHxldp8ox$p_jQhadglZo^oYX$F=$xcpbt%+H9
z6VxJk9by<l{W)3sbE|O-O?<L9^N{AzJM3x8u<gLsTOT$`NC{1xY^QT~_hZjaSpO8l
z_rfFuJ)`JiY4O~7CSzDxxT!zGbEC4^P;?<GsqL*G#ik+w3AWBKcPn7`a!iJnS)8Q5
zlY~wOxi}5>S_tda*UiGPVWwH1PaNAW+HE<0_|Bz<-aMZ5gXPq?H(JM>u86O>M!t6X
z(Z6xB`D6QAla)T>$~$2m7c9lk4!f7FGjl(cgkqL6gPRXms$Y2}%yUp*BS_cJPVnte
zg>SH9|6$Hf?QW`*)6md>B8hsg=EC)Nb++2?u-390aSM$>$?}ZvjyRnsMPag7#f357
zdScd=)>eJmB`rn1uEsb|Ke24R%awwmK*Qdc0J<VM{Ce%&5C7p)bCt3EWyKz`#jo8a
z<q1`B_T@|7QIz9XOS2h|AH7XgS~-~%J|Vja^h<md?|X(}6mb>y&hONBpP_0znf1@L
z3TCvh0Igb1xv9OHufs&+cqQ}3xU4%)eie3fpFHylZJ0}Wdg|?Qq0l%7J<t}QBrg?s
z03`awDF#<!+~`HYmF6go_HBzjIKOPT)+c5AIjsLipEjQKF0_rkgodH_Zx=F-b$5GP
zop@kq_k)gh)3WMq@=BQTw}SFKb1!b7;N}>48HUm*COziuSVD1D_~A$Cs#!0(${k+)
zF85(%PvBV{p(+YXl1FM<8QwIpJB7;uehwt*!A?0Ka`Z6yoK<};_}7VJ(nnm=J2^H<
z`_$uAhdgBVIJ(uqEc8By=DF>+pa%x~(m5_4VfsrMxRwJpCSo-q->vx=Asz$zku8RH
zpM}NI!`A|Kti^whZsHkRf%(Z+3HD3MW4r(IyUemqb=5r+aMN|QPZ7WkS^Xj3Q41>k
z!SYy=aPS^5r3cHkQ<}m0(BoWspfy~V-^b<c8%wOi*L{H}z2@}UePOu`8D?rCUqBE{
zq7VJLB#(+7f}YVyKDs1LD{`GR5j#>nJtjTu+yO@<o9Sx@m=9T$ozIrX%mzs0)Zm8D
zYhOnFoF8sgJXMURH!%{2>1&by-D|0BoqJkG<jx4IJU%U~^$}L4neKEPIYx<(c>|%-
zxcm(5ISa}V^2H*nLe|3~_hF@&VeheZn`h1EpiKXx*O665E1Z+?5Vf8|r8(v8CsaL#
zq$AA8Uvv70Ra7nAN$JBrmzr%~0{UXwaM!D3TdA)WA3|pxGocwipv&WP#TiTTtu`I_
zEH=|7+Rc3{+i!GwuB9`EX<ql$5YCARPE?{8OdJhQF-U*LX({@Ytl`wLbIj>Kz=qss
zGhgRk>DRya6YEBo+)KLJ%J(whiCM2oo^m@ssQL4dF+zFi%j~Kkk0<(qb}R{=Lc5`4
z^|Y+UWQc7J+m^EmL(u9*iKi({;9NH<N!p3S`QMB<!L#2;$KU&~ToCDQkCt4n;bl`F
zH^mlZ>DSz8<3w`F=&04`ms;oxQO@oq4$#j(hq_hSs~G9m6<ow@1PW=mJG+y2Ajkz(
z0g7v84pI}D;!zLOvnvqS`NF05c+5Y6WhrN+`2%VjUbs(6?+b>vdSL*&8bpIsJXzZn
znKQgC`rXO$T<`<YxNp)qD^n$6{DANWbK-9*qwvcedj@wNY{`}tXyXwX9;0UYrr>Ph
zK?kL)p?zRTR0FoDe6Y*pGM5AKEJ1FQ0$4@d_#YtaP5XdG3+SkHn7vgOM%IT0zUc+z
zlWnXsaRu<WxlbWtrD=CxKc^-_p>73?8IJ$m-uqvc@$4>=IGa!o_an+yy-<Z_b@#&f
zXP^25r{y{79HWX`65g)%%Id8Ae<p<h1e?QZY!w)pmIeJGX{v!&N_rpH`F)4qhkvdc
z6;tKD&1h|ZfRgS_tNq3J<e%q8piGIkI<!H4h`-khgKI>TWv|$9n0zpgZ8H2qR#|q;
zvcfbeb8xs^ca&&;6)WtZ<(X%6NGm(M5f=FVcVNr;uh<vf)zX{uUm4Gfs^Fms$YSHW
zMm924lC_-O7b$-E)tpaJIQ_4XR{>I!j1XhIj?Z(Jg1^sgUeEudiPv3OGYUNGP0*_w
zj`-CUFXs0v4x!E|_^aC7d^abD+@r=A!b_Qrb1>e9w5qY%YtQA4?uZ{W-$du47dW+n
z;19bafgT4KY$O=CzCI-Fu@7x(1sl}$=r|8eL$-<bknXeUfz!V)YtcwV+Mlv}8in!f
zUi{jzLI+qPLnGFim~7*?<Lq=j=}P#FacpbPt!6s%f)=I(mQwM*F5f=0T}$Xk-!!qd
zQP=6mO&^eQq|L~cRCi`|Y;*m7;kU4vUAG*u5LF?k)iBo}G>9~bTXnp`{|8|BBK0hc
zqh;^*l0vtVoZJn_byIQ7VG+P)LQXOv+4jCPD7DIvN<UW6$u5LLmy!<<7Z><Yr3~%k
zXnGu9L<L<a><FvWoe)SL({<a9%0_b4!X>K|rlo@pIp4Y=@S%YwW!38DS6)#|y=GgE
z+?UgKgj^`n&^AfQeX~kkRY#p;>#tM1pSq1cr36kee>-f55;d_qDZR~Kw)6#SRL7I*
zcMBQ)U@Z0FCFVUo;rO4aU0k+sr-x4`B!HQv-6!v<1)=EefM2VH%^2SIQm1ceOJz*=
zFzRcU?@!t>K^npOY^-$lcm#|E<C&K2i8?#iH(a=E4nFc&-n!(#pK%yOZ+dqe_a{(V
zfbVl5zZsPWs_W>>58dmEX!P`)jL?dTFZQ*ROYMPCi%MJ(L5!Bc&wJ%T?^MYCWs8KP
zWS}`u-=SW#X_Pj_Vwi=-DA^qV8%J3*b{?8HeHlkyLfOpYZf#-?y7i<l^P_mcBo5Ah
zRmx|c*B>c7G8lt&aG;^ZYH%9_V%oF~qfjTEQ6_PfaGYGb+JScLxkg|h>-x%A4nZ`8
znnWX;pF`XB4gTj|8G90a+VX^T)#yc<>86Kl26R~x&0Ch;vm=z-*=3N+*>xekVoXj%
z3F#mAr%(6}&mbd+lV@i4eue$o8hC#&*|JB|l-SVDWcHbcXD;WSBej_sZJ`EM^}T8*
z8mHX$Zw0?UKV9e)gS|7=jG$0~Xa+CX{9ZfYlCfI}p49bGB%w5Ru7yL+TG}hK3*6b)
z;aY||g9RV`y+zD7R&2(XV6ex~-`uk$(Ge8vSHpY9UzX3m2$-GUaJ}0_Id89S^Afdb
zOS*nWRGYR?x|B95@&?%Aw~x;{vY$W5{;FP$5v3z+F5Ok+E&Zpzrn-K(wHNBt@vM$1
zqsgC?wv3@aziVbxJZ!%^?kmcRklO3AMYF$&3$-_(54M_6L8=@TnHw6KjA7$BB0M$F
z^NZP2@aj`DNeWfg*%xLANjs@Wz_>gE=Wh<HkU&Y!pTydx17-9=eM--f3b$PXZ*5<a
zt#k$lWksV@+r2-TkXyPl`g$lFrq{ZiTiQQoTW9I?!VP}W4fWyBCE~sacX<Buckrde
zvaZ)9=ZYfbtc~Ii6sm5Jza_s4Zp_m)oog~J(;Wf!IB&6jg!$xL!5H%$p7?m(EHu+*
zlI35_g6ilN3kseS3qkr;0T0Q9MAN^Mao1-sUNgLaqh1LaU!k<z1o2Y1h-Nv~$ai~G
zrfdc4%rwNcik|C4^)2hYXmS|Ds>BeXuY5IeVcjK}VO_7*LM?SWWd~a2hqb%KzWYg9
zQTE)*M!;?{g+g9Ae};!Qzl7<eqpDAW3%0x{mNg?&7x;anr!%4$&*8h-_dINLmE0aH
z`68BF2mV-<j1<B)3h(ma0LhLpj4M~A&eC#beu@<$!aey`#SKyb`j~LFW}0O<e07Hr
z|9=1%LFm4+Y>{!tO>`}+LKU?4g+wlz(>8~AFf)jr5;aHA8Y!m<GwBzTT5FE(=;6on
z8rr&-Qm&#`TR!twCkQx6&Swj_#um(uS>s)KrWYT&(Fiq!w;<5Yu#Y{Zf}mkd44vlv
z8QVJBaudx6R&aL+G?&SonahuH*BvW6K;jeMOl#T<L6t^zi(Y$$k?7^dY07q<{iNHv
zN%<B&<2kO}>Pl%2HV*Zh#&0ZJ;GR}Id21YUbN9J;V`096`WW{s#3v0NQ!gxh+4o8D
zj5|K_uILw(1oGTU{IlM6=EMI0oW8B+uN_yHhdpv-kH)cwm!96SWbL-0Y}!)IRFIVg
zf^t{OPa5uJKVk2#4T~-*)Mk(X`G#C)E<C)WICRR#Z0C(@KDfGjXKn0U!V>v@;L*oa
zu%>F9=(AcR2}OCP+uOYPV7wl>Lc?vk`S*NF^`8SeZ}(>Ee!98!z4i8ub*`POoGyk)
zRaAnaw0GJ*N)oF?xqT>QrtVv6(%qgx6f0BD@xo4JDdRV`X8!=+;?9=;0D9R-OYWbC
z+$mE_QpQ0zYBSuTxslcli=<oymadU<kU47&@L2lEKa{-={gU?nM*hae(^6|tuogDy
zz0-;mn}_*;I@-y|(C*maBZnG!LftJqwi`mpbuCZ_lzk~Cz1nX`*Ik`geJs7xr*lL*
zr0OWTY=-p)nz-aSZlO|_a;6&QpEw_KXHr$=#e-_Ix@G(-SV>EFN))J2{MQ{V_$Ic!
zP3yQf+6(=kb=#%`uQ0DlH}_W$1ND#x%^g|lH#YYgqxzG)v^LvFz(ypJa=_YaQV$hU
zOO2kL7F+AomQv$7XvruS`csx1`n>uVMel{h45{J5v3J%i+PIBE$ov)1x`F<MbI4Y-
zGGS)oS*yAK0Fx<fzk^clY3DDt{fp09zA(DV)Y^gS4*o`7{iE5ko7+uAwA0?3z`73V
zl#Pi!NS>YUZJsQ=uz9;yxpDEy&!mLWK<5&a6=qEj2}VRdtZt+4F-4LnNr5WqoKOx?
zIg?8G2%b>|MEuYKY72)dCxDQQm(~gpOez$o9nV3~MWhM?TGZ@6I6%`ff`@^w{{Si8
zKtW6UlV7Cx2~Y-8RanEBJa`Wi6W>Dcg%e*_@QsQJ>vc<Qq#6^s`Ool+ZCD*icfH-n
zbnt{wvQUD8K`2jmEy?ikinmb;Q;VWfJs|M#9x(u9l$UlpZP0jl#U&w26v&?N@DK`{
zg&+h9RYgNSgZRm~X(?^ITb0(FMtpo=3USZE5(2%DMFW_cXIUv$5W}>K`0XB|PiasB
z+MKhUS3d5XccI2$f=<yb)J}FSbcs3?Ldni<VZ|q)F3UnBha%J@C1n5(VkO1Y%MBGR
z+Z9md1W6_|rs5P_?_^-<oN0X*Xj+zF&M7pjYF(uZ%)!*u$zxp!S@k&PP<4O>beYn(
zwt9?R6oILvnrU{(=yI@aR-4RN)$ZJ>1#*ORh*9qEGZr;c_5tIZhm5$aV=81*avCvG
z!V-;I4WubqZ6Mad6tP&9tXFBFDQJPrwvdBa1(b<Z3|gr{lp$7yPV`Xq?Jm)uRh`n5
z_(GvImu#bY1!<%r(t1rqVy%=U0%00KGSZ}37$?~lP$WTgZt@Kx+(uJTBQ`CBGMKhg
z)>~54kz`4z;S{lyu^>}xfl(#w=CLC=LV$*9VOkRHEoV(g$ZnhrEe``5NJysFMu|Jg
zyxTdfOj*ye=B`qeiY%u&(rG1eyW3U~B|>P7Ek_9)B@k-JfC>g-BG5Q#TSOsJMSynF
z^MY+~Ah2m$L9nf)RoFGp;YheOYBBCa%dvYX@4psB{{Z67ld+FyJKW2-F(wrR)@sP0
zHJPJ=MX#($O0&94)zaxJ?g)(|&?Yh~t|lvH)s%!BrbfspR7GG4C{!3#B@sl$5ETL{
zm$Y9rj?kQy?VH5K&o$(7&id8oGrqNX%?>`Pdy_N@7T2suYt|&amXMB*v)-i5+2h_!
z=aG}Q8gaU-e@L3&&?ZMf^4ob9$7qBpPn(e0%4!jiQ6f|Znp8z%WI~$}F^vYpZDOCw
zbr15FAK93lXZ#~k{{Sa({h5SHUdv#$Cn{wG!}yH?$LOms&S!O9^oI$!aT_EN$2kJ&
zC;&Lsd_<mBDdQ=sbld64LZSp+GhCCDPDJRJ1?qM0EjpYlN?aWj0>3c^l`^Ukk(%?`
zbZ5b?p<VW8vwEsXxzib``I4Lp`b2o!^fW63bTag_vP#9`mAyH;-?A>x+|^cBS2n8p
zrj8(fMs-a&gq$g$KQ{4a!CbEfE{{9ZKFIa!TB_CNF48s?C|A&Dqm>GJ#dt})qPX4*
zJ3Bmf_p>_oonLv=u22Wel;cm*n$KfOIf)@eE5Lw9-zStT==0t@=cCac9-)NMRY~YU
z2k)NCb=kcV_z`oa+PhuO0F`|yq`PBJGt+U#`bUjW&rH-l%DXdhRWQ4Y6&<jsEfw-K
zKYY@D?<>)GFt0PhXK8!(L8-I~tZ!}ZhXk&zum1qlCYjxEbiUg9R~Ld@>OGI`7MEXm
z)2=X&owV~4^rpX**4ddkwU-YjDsYH(AfVw`QV&HWr2Ps4X*S8L0p-I4%7~zrLE#OC
zU7{(uwn^a}043TYnkvaAJ0wfA0~J{KM~0JIW+JPXW#J#3CTnb_l~$`VC5n)PHMVw&
zs#7aWv0buNH@0?)tf3qu*DU-dlW3-3!miem={AZSl{BQlAq2#lhykl20BNB?rZ59d
z0oZ90D(wo9AfjXl0HGoPEi)!Ts6+iT@kEU@{6RBTtRt?`PjN9CIqnH@F<LHLR2yoV
z5l&L5G^&!3m8S_*8doYawKz(klB&uj4p68xDp)``O5l>IQXq1bL?KduaD_x5zy}C1
z2vn#C2r(#Bpd2K`p-=#^HI0B!kPHA=G68@D3W){)ES#cA%1ThsPaWhtIr1Eim>2-5
zl{r$nLUwA>CbA7ADz%YV6$-3O3M82jAk~oo6bwuX77T!30>O!_2o+fsfK<rE0%=M~
z!lbLA2k0?1%1>1w?rPK4%`chDVND@JG87d`Z_+f<ZVlFzYU`*3;lM!6Gy<DfelvD-
zomO?mGcK*^x^~L0ZQ5}*;*KR}2`Ey%9vHgBG_~?@iYL2NozSXr{T`raH72o5^kXZ$
z`)lI5{J}h>-UL-{*gf^q+Ez~e)T=Cy0W*yz{Ias+jE3_{8(K?hS5Qf<M)+jEo9$Cm
zE8kjc9bvxN&xgTfyi+OTy_~kU+H7O^^b}H(DCe0@#LSi9Ru#LJ$#Rq+^ie0((<)8P
z$=9jdyBEgZoegiSpR!f%?l{@_z>SMWiSY|gb2ilw;!4-dK9|stRZa$hL>h69hQ8$T
zlJ@=5-m|Aqfk{ijXZDmSHSVCdL*?ZXm8}XK)bmxadWAT@NPMx^ea^n8O?<z)>R#7h
zVO(D?C5%Z{MObk+`Xodp#R{n_BD><EnjRTuK8bDg(j=SfE|;gQ{{U32O{sqFqS929
zg<$y>56iYx^MfjF%B{9p%uuK*xQOdq(mZ0>**87}mVRlq)t&7uAx)7(-1$J<eywS=
zhLrvvh|o#k5^I+UWU`pty<%=(#IqlXZn!YuS_1I{%QQGbsgX1pQ>+!*h_`u5TEjRG
zG^HmRQ~v<Q2Jvs%GwhOm^wtu2ef<rt6ipKC3+Zp-EfozqDtoExLA(a2l62BrDoRqw
zQwtd=06uD;S(whV%ktefg!p!Aho>f~k7w>|FD`GnsBOnuc(#(X*SI=Va6KTq8Kzdi
z++8?RjrUfB(=%PkAew{HP9Ga?&u@=S)#k@6WYyC9ob{HZbSb>EVFS8^r+^9m=_qQ&
zDXjv$#b<eOi7qk1%&)0@_E;R_i3x0FPzd|tl)F>_wGuwAdHoXWXPz-PqsJ;5)2S#B
z6v}@1m1=gPp)10Cca3JBS{uXezegewXunhLDbw{vNr87*T?lC<XNFlzIPb07KU(@i
z@=s2SIC1r&-xpJCq5(=rvNv+-?b}n&0W~6n_{+<=g=3dIygIM9@w}7O)7$am^?xr@
zTF{7>)r8h?x2rbk>yx76E`(jd8AghCIjyne&BebH<XmA*YZ$HiCUo-CoypI`tF|~D
zs_LdQ=VBR6+}!S4bH|Q5c<A*ngBm473BNZtKMgldTwG|U&l#+)*=H7{E#*Ku_8}E3
zSQw#i(9*G+>QOZlH!i7@auS@n{ZkopvZ0r0wUIU=Zuw5uHhiRt)@uy4S!<IIEDUm4
zx2mR@s&khYysG!-Z#Nm0aJ+i1`FOeujZvB!s7_T^ZaQ}}rdcuF%N#3LlNhwrb<_Z)
z4)m%B2Q!?RXSSvU!(CX*meY+k^`?u?;8L8#l?0@L-Rqy#G%>Q7a<yz4@c#b*3D?>9
z&$VL<;g;M#w61w-dOGEg)yB%`S-l8JB~G{!s`o}B;#HLmXaZ7C3cy<-cdVkJNEkp<
zevp$;YLYYDZ9Sje{th?XO-(*+k5(Vq_sZ|K&g|cDC_^f62auxbQb|&h+nvxH?&Jk_
z-WiKv30j3#paPdp@~PH#w}0dQ&pqYI<kRV6?0B*C*%t`+n`N}qicJF0NKI6w)EpwI
z$+c`_pi<Dt0Xt=spRd<fp673OgO7_WyG_2H9^V{$M?bChHruq8@3pBT7+6m#w8YL4
zvJEBpQF&BItm&5~yI=Qm-LEGXv$lR|(eASxCs&wiUt#uWZARVa0)=T=>9=++rMyKs
z8M*Fqm5YUsE&j^l%5>bXRvg@UU2Wi6=V0}19ZK$VQl21ZJ%3iynz};L;sNs$z8>Qo
zzRxb~e6Ml+pUK00YwL1hj&b0QwChVDNm5S`ax=f}FJqOeU6!rc2~iY5LU{hP_e(3!
z!^>oRD~-p~Pk*}ho>^*5I0WEvG(FV~mB9JWQtXG=a}-PZqVcQhY@hF*j?P(f+VE~y
zw};qq<JT|D@|PNPA5DBfKf-+kud_bPw8t$rZ5*jwB6i&Pyt!wW#o@C2FZ6wUIC#5w
zN6$f`PW1Dh$=V;XEh6Q$s@(yl=Sm6c+sQfe$JO!mUtgE|KZBBVny(;k)kJ|qp3>`I
z(Qi9FbXavc3WThTspmacCq6z&%K1|VetrzSzFPD!LoG0hP!*rLCA6(;sj05rNd6Oh
z+E+bHVb^CimhRm;l%#hOYHPJ)>ky<g3K5vhS7lR%`I$1a7|rgu%ad62hqhwjm5`MO
z0+6zhQ%p$|uaZV^_AR>VpMRF6sW$jf-op~jNJ*~_GG4!8^jWxfT4|{&ahhN)lGB(<
zNg*W}uDwYR`dbbZgyK_Ymc}5O5}GEYBBwFdL8eb^m5INMuvC{FUMduZhAKCeIKyCA
zZ<$iG{3l3l0Fsbt%2I1z9k|P)PuKXWY~__U%2fFZDn%N2BC1o!t|jup09QQYq*%Og
z67{hOTHj=oK-v^D#6k5W<wIFvugC6Fa8xG7<&?OR>!>%j?j<Vji#$k4PBFw&gqGPU
z475uxJg!~E%}HsJhWn{-C}d3l%3s&wcK-kmR#j(e(vqa33J`^@eA4R2c`9*4Eu-?1
zb_O-FakYn3<0Q1<dF#;Plw3=;>mYlxc^n3n%3s(1N&WtbzuY=?3oSS~XkEhF<+9Nr
zx|*CTdC@==MJv3|7TjfF$9X~Ya~QiyLR=j4R5F^VoI_$D{cHR|2~)T(T|ssCJ>9nb
z;jjf?Wx|CaEvwR{5mJ0%lx`ePeT9b>)1kK7P)by!Eccv0E2<sg9X{WJh<cpgIB+4h
z-3oP_6)A9}9${Bn@T5W%wWy_Fgr(Fa3JL(c?f`JV(ua6IU-%C~fm>~rIPpkQR-<qe
zPjy<<Xwp;q-DHPQ;*{DMPd?$qEl71o0+5wq#yAbKm(=Qgh?i35G1R5D(pDS-!Ab+)
zLJ^0WRn%`twWX!8&O@Oo1?4q%q!qZ^%UMZf19FqMNjv`lufcR^-&0Gsu9;GTo^w!Q
z-RABaX{CHyXUl_@!-RU96Fk!_++#LwTcJ*>i!Kx!oBVW3OG<GbSvwtse!BXk{=evw
zYxi5$hWT0&<0Y<hYi(BPzHMK$uH>&0t<#Vpw4AYR5vY|~+r5E-YWgkN4<2?lk{uwp
zSnBAmXL)7+0C<-4FHW@e>ZsLKh~&lwS~ygi*8s#Qg!M@40eNz=gal?u!$Nz=LQd`q
z?t0AM*Wd1z_x*oGhK?*2u+_V5sST3rg~t?}M4B2WZI2km7pB_T@=h8cAu3nMrJ5Cb
zwxO+MoxUvXek-l5J^Vdx<M<qBn{mr<I6K%74kb54{K>5#F3BmkK)7+&0105xI9x7n
zx>RHnUBuPDsGqOFopoQ2L|on~*4?HSkAjpZn6N5ZYK6iFcC}s_E6z5!ZyT2`ILJy8
zq~mQ@1x3sUy4j$hQk6oi_Lkp*B%SH@IX6YsBHs{ET_3oi$gR*))xIE{k^#iOD8x7z
zQu%HCcL|^e;iYTIORg^V0g&2~?GC`{)R1oOuCRn9m7$>W)}kFO`Wr~Yg$)&vT&igr
zxW%%=479Scg#|d0k{CcpGzzM_>nAyP`=$MSSE6p7t<$Giy22kwe*J0+QdV7C&p-Hz
z6-`o>+o(y~Ib6lnqjyeUEk}~cDP>DeZ$5IOXlj(#B!DH~-)Xa_eJ-zM!&lBHP-ex0
zMlBj`g*jT$Y8aeSJHDckg-3;DQ_lw2QwVqVo0^wM%aGdhSSJ^$Lm|dp{{X6OG^f`Z
zvyP$1ecZOIi-N_vl(eZRWgvyT0M8XGLn&OlONy&iOHC);*sXT?+@*IrOSWxK-?LIK
z1I;bAf&*=Uw5HyQT9kQJRxVljRJ_(tNzXlY?=<q%q!lBT%-fRQbq(jbxXpg-?Va^&
zOU2yW1|4m;()!<X3e|{(+~<kF6GMe503>HAz2$FvyG8CxcF8GhHYn*Nf~75F?yfU`
z)_;Q=W2dZXa;wnd(AFSXvQIhX*Wo3?D2D5YGT5meGQZvuZMi8Z!;cvo2M<RLbDF=4
zJ4{v|4N=zGD`i}_?}$aXRceNl>$zQ1x!F7^E0Ut)rN<SGY5^Fw2|)h<O#-<O&TDM!
z>HP(&wRMM3@N|^gw@Yf&spSLlR<IGW)j&GR(7tJL0V_%|B&mBX(mg3asKSKquCrTY
z(7U(Qo)00Lk9RA%t=00`$u`NS!fLcMByJ^YTlYl1u+Ul*p7W|!7Lww<O36g6RPKRV
zP4DqUJFQ#QZPw9HDs?!`Xa)+X_ZtTyQh*ASK;tW0b)d+%LK1oS5?wU~rjwa%mcqSf
zGPTz(vhVgosjpqF{qf6`r5x7OmrY7i3RYQTa0v&xw+ZRAsRb8~KJZv+0*O^W(z9c_
z5Slsok1o4!G@I&LFD-+ry|pUkG}2pg?e1&9mXxD~1Og7gWhvLraR_xyC@s|`-c>5T
zT05*T2Qzwiod>MFKVGb*+gn<xZF3OP!r%9&oPE_RCQ^ol5~Sr)RC6-9+n18HIJ>6P
z$VV?El@z$<YHhF$4L1E*t9~E1$M9x;49L*#-4HF@bmJ;pxhJ|-j7JE=Op*j_5aW)d
zB^a<aoyf(7X0-Ks$*;0oQ|_82?LOk^nqn{Ygx<K{a@=A_KV0UJa^N$a1(ln2?4>mC
z5s7r-qrcI#=gC>it#<aDd&_?Zehhptg0`$9Xrh$?kffU%(xGmu4S8;4*l9}&%B1B2
z3Z76;2~&G#UX9}?aoBH~aYr`H;7oUFM3Yf+qydFgGA@^d$WzdrlH=h9f;S0L&0}G;
zBKg3ynusgZkb^Usn_PCBdfKAq_uZYS+OS%KSnE0YYNd6!`9f93oqU(u3aqBl?+Xj%
zsO36L_Z;!uVsZ6fsU}XPmxr8W&C)0iDcc&vrNg6MQl8x{A+lpdyj>Iqbjr;!yI8{;
zwab!W3@<`oL)eBvCQhmln^zl3fKtT?;wvY5-WaF2vkYEubM7vCj}h(l%AeL=w`3L3
zWi(EIl=NTyh|`w$H+H&nmmxJT-3IZ5bvTbn==S*Q9o8qGk4@>}_uQ90OCx!GIhL-s
zT+d{5%Y6f~x~jD{@Q1C6(y}tdMoFzVthm>EFRSa?Dm1%yl#5h%$8wm|I2BiKY;yDY
za`@xbFvrJ|=cYKgJb12Eu1>gk_5<wQXt=ctt#UN3)cPU&0i->o>B~dl2N_zBM*~l6
z*0qst^4eRx5=~<xqq?_h?%b!kqw*8irFclUN^zFl$qwd)4hN?4-l++>OH8a>zeURd
z)uPdxMHRP@2r8lVm2Nz%8f#5oqfl*!6q|;ElB_BvJ-}*7^7h6%iQ4sCr1bAeWsaXt
z)T|27lZ7taI7@EZuu{_1#ZDcBs?&8s&Ew9c;DkPq)vHQJ?B&F6l2eGJ{&RCLvof)9
zz1p*;zpC|Zrrp<8(NfBir74`~r$)+7PztzPtpzD`Qj<(g5OAzkp$e|Up%ZtdXM2px
zx$s?TlYMUXqo$#jU0sUqoIzTVlZZ-9TmVo|s+6hTHMCWox?H<c_iwF$vg5ARL>l@7
zXyee!QfQs(-S#;aqgP6cEvbiCT3BIMRHer(Z-eF}@r-WLtxcvb>3+dWiE`aaP(qs(
zs+8g?GBnCwl`sB&>AR2av*FNIt_zA=r<Y2pryB_&DsdSsEK@AKCMM<AZc@9AIgp$x
zt=n$ZE?m%1skGOAIY$2gUt~IJ9lM%#vqWzH0JE1#WjK<Ai>qVBB_6bG!Z=~)R2OZJ
zmv4H7gq4h&a}LM7QC+FVbmPla&RsFfH$Ls%SD7hELwJuL>qxClqiK6_Y@wS@trYS<
zzl8J{^_zLjx@AE(0~U42NC7Kyo*Q(H2&E<T(=)tLWu6)S=n;Ac?<fS*ZYQiDv}Fm!
zO6T;L5>@D*dJW*G7__q5lnSZg(lmzGMJC{d1CqFcVtF`LzpMNDZvn8R-8K#-3Q+$5
z+<M7Hxj0m$*QIt(hn#3OXm+j|T7sNVsmOW2seq?ak51G*KK#szvsE?J@{Ky<pr1tm
z96aJhvRua67nv1O>(kpH(hF*l%ES#+4|m2l(^-8bee6QC%Zc!cRf!KAb!%@46jmy$
z>ER(ra3OqG*Q5(j-~t;9reJ>QnZ#H?R(VO0TE#I}c89zfS5Xz(dIs7fY^N;yu5+ue
zA7hWQr^v(#laZKK(5jqU!K$_1MG}k^P0S7~q^qW*I~7YwFh#&O5-ys$XJS<~-UvLB
zc9C^j=+BfFbws6gGA@)84Q37*4K9t5fK<#}%*M?ojg%3VQ5fqRT^csa8BA(K38iFY
zB%+kgN?zn59IYajq|zZFOHEy=ig2cC5uA&punb!=Qj=|CqLd9d#VWMO$pcDmvPp|r
zRckfqj9u+-bfU6TUN8bwrS+_ZC(bl2wJ9NL#ULlYyjT*`)aA2YF)h+%Yf&XBb?YHO
zK&X}zp7UFT)WxZi;};zWs#7^D+h`$lP+Y@F3s9$~SVnG(QqU4vDLg3@s|d@bBF%bM
zA{9*@0ulOCF*g~Gc{P*?kqE#CgtanER~Vci@rDeb_(s!an(;EbNTem}V+otarWMaM
z&MOGa$xxv)tRs~y>O!O}nPC~FB5o5x2&~Wp12rHJw3!Kjr5&Yb65j9#eQa|PHs@#-
z5b5JqWITQpu$|1i87VLS02XWi0L7b~iP_HgOWfXRKxv=>ZGR9=YxsgnQW4Q<K9M$+
z=o1vnyRIpM)w7gCXDN}g3m_N)GAjxN0})sR+Ml!=E88PpIVx`h26+tJ%f7XF$amJS
zIibpg$bkad^$86g@QPK0be*5|C)p#j+op5K%e$``#_Cu-!6MxEM9An<+haAfx*}{n
zXqrfGDPa<W0}>2+fLw`C8fY|VL72jbYpn|C`j7cLkL=9a!T$iHY9Hk8KeI9^dldDh
zgX=<9<FcdGTe3eDtR5nyea2&Buxy32l7A5+$1x2=1A(;w4%o#(_QuVInIJ8^i)4KS
zL_KcxKrE6zyJsk=x~EC%)OozKBd<@oB=f<d6}IBFKS7SB&Vj=(I7Sizj{tWt7}iL{
zGw>iNee%TFO&+#N^9ou>=yDzryJ}i76yg>2DJG-nJY}_;MbX%CWOrAX>LA*96y)e%
zvWu45i6m&{i^U|-dybGThD}zIN7k<opvRpP#s^=_F;z9e;zoZ=8ZDOMLXe~ocH{hI
z@~r6bfZ;sE=0d#Vb)obS60bb=nrEy<)H_Rc*}$57q|^6Ce3zE3@zeFct!AS=ek`}8
znqNv&g-faO#6E+RtxL|d<sEHErpGc5-#5|E%EmQor;MjJx@Li@f}5)=D}%(~N?afI
z;V=QF-c~S$1NG8y&D$8>+^!q+b<(R)`!4LY-Xm)3_A5I8ptKM8R0dwzbA#m$sP(Er
zr?zWs*BkBTUuS6Ibq}&lVXQ{R_R{chN~+S&{KM~^+g90R<lN1TSDO1=y&kQ+mr?Ae
zX|%$9=S#W(e9fntkEH~kx_bj@RWOHZ;By~AG@J6CtUPyvl6pO#v%?%(n^qSBkbbJc
zLHZN~_N_}o(KQs|ztgQQE60=q{{Zer6Zg)N$358a*=KpDvf++h<anW6^u15)hqD);
zuE|$gaX(P=8z1njSN{OIb#t7VJWp0$*N)$V%v8D7>VIP$pk}JmuPrar!3xB~zy7d(
z>CuVJJziIQy`Eq7u0XpS>YbJCHjbqW%_{M_eCbCqA4)6vO{C<;`nWfj2PQs-yyyZ=
zXsV?2P$@q`sVTU^_}S<`IyWTBATe<!H!Gw7Dv*_J1J0)y1xt(xA?bFA8?Bmc4oXxe
zw#sR(8jwUIsG3PxTLO@BGKe(NC^XUl(?F=10tE^a2mqwXOodoO-8b<>jW_WGl&wNK
zy&(4lMwG7LmlG8#*|kJ8We%ajOiEQX5;L`<B~bv%AUai?LKQC12T6%arId+aI!sCo
zqAeW;B?bXBIt)q-pbmo}1_%S7$ZX00$uTJ~2ryJdU{FA)fT#dqsD!Ej5EzhP0V|YF
zETpAakcVVAa-8`)9G#soFa>fHXCcxN6_EmotinTJks<(0io%AIB0v)&17d3v02Nxq
z)&+=NVqgNRBCrO^1||hZOW7;B*gJ2EszUK4Jpq;7mwYv-gcCsOaQjALbmRG1;=0M4
zyUMwCb-~oM%JD6<qaqUFDHZD4hTbA1tJUz4b5B!5caxaSHLXWktI{rMk6K~)>+as}
z(%uSk*<jEVDTURlo;2Wi;)x}&mborG+EQ!X6vCtODJnImj?*$rdmVQ))ym1!FYDa+
z?^NZ*Hh`2o32jD|AgMp`5CVacr{38?w-v>(Xh`ZSQC}IW(Ra~_yVf2v?+N8vsWf5b
zFj1ewxJ^;ym5%W6$^l5QeZh^44(Co{KAMyi)O0kG%zY|f8|kH&FIm6YWzKr;9I*LX
ziE-B#^;A)XM2`VbsTS%8uYC$&Wr$SZrvcum^OqZc6CR0__)Qs2{vx0PqT&@ysG<Iu
zJql@&J#&p$?w2=7ExNR=H9rYTN>%zuq5lB7vG_BT$1J*SJvD!;a_5FUWU%ZTmA779
zyCm1Uy?SN^BTP4oMHB^~#A-vKc!ydj52CYQn)*gRHTBaM!g|`@<o^KM_Bu+QNUGA5
zQ`Log{Uh>%Wfv)+Td8$FEmAh<XiV!j>drg(?T(&{mB-<t#lTI&Hu&xjG$~1509s8x
zRUaM_9DR1}I;Sn)a3wgX%@thuevcToZ$?*MkdoQ5P2ZYBYqrJHPc5}LQlh5H7BCz@
zW>P6iM;B@fw!pQJRN7V?091pp6jd=NV>xn7%DMH9ym!XUv4>2Y?`5tvl`7)Ya?@<X
zt4Lahezo+0NQ*618g=XT_fMsF3v=P2DWP#EVggl}98AX#ox1H44E%i^dAvLNnPcSW
z6w;KO-B*n=jsF0eKBNE;+E43m?VY?CoVCl#?AOwp?r<#{O47ADwF+!%eY-{{Q`BEk
z4T@ptjEV4@oOrP_&n7N+;NONAtb-PdUNVI!kJXG@I@67iN`jAtCrxAUWAoQLmR}a_
z<5^*8K9;HU2*}v#PPCMlRFlN@oh8P4G2xcGx&Cj9S3GB-da{}KQA+axsrs~nPLps6
z4mzcRHZpsQE(`R!b*`Sr%5!z>#ytKuSYo$OwC@>fExo2ZK|RB<o=aEU@m@Q>N7I<I
z?7h}J*y{H!<%FH(OS+o8<}G8&x>=_3#w?WXG)lJhMB>cN+Q*X;>2$Da>^7<x%~veA
zDhRCB(|ca&IxM~QDy1cBHz)@)F4M7a=+^eKTY*BgmG9~;HlI+MV=T1is~hmy(~n^i
zuH#l@Ad;~yX5`GRW5;bee)+TmQYR^?_K7QWw%I4dOKf6gx=yaMipaaV*Dac^dH7Co
z4+Wf5Dn2t^YWd?F?@s1iSz5BV)}MZ%w3<O!vvG20gk|L?jXd|+Jer&u?h2iKYpSa+
ztou5pimfuuMC(|$D&DchRK_&`05hhx?D`w0c3r|?=Q#4NzH%xowCA28qbbs{V3vkL
zUn9p%P91k@<+`n7ObH-imfW<XGZKj~kx90+2tdjZJep)?qcbF132=sl4a?OAYiwnb
z<2JZ-OLe$%oFJ`kQrXUL8RbqaqH<;Q;~e|7Y{N}5fj}!6jY+VdP@N_+9!^>1mUUvq
z$60lvg;G*oYYm_t`1)q8mTAi@oP0CGKPdFcC>qN=lA<<@uRB88!9u&!Jd;LQuMaHB
zNmJ-u?-MI~#%-<?qJ)#wiC=$q9DCu7%$R55&i7l(gX&pbIPtjS)zI1N4_vqsjiVhD
zsTgUIo0(;mTslT?7aka<cW$=933;LxuJt1echrR9#hl(4?sYu0^Ye0e<<dH3jyKSa
zQAXWr2WhXa?d}j#=>YYd^PV-lvYAe;aOE?_&SRDr^0<!Lc69cMLADT*<#Mjmpi2$6
zdWE4uLT7_N9Fl%qm)`q-tB2jWoy#7tI(zKbT+{04M=@M{zK#QF>nd#AG*yI94wKRK
zvAx{8$AbF~OnS{%v$sc*4K4e3`3OQvn`@dwnFLcTvI3;ksLr>wwid)VqJj<*m0-z4
z9u@PQH!oK#GP6BCepqFN)q6eH6ueh0bx>(`g+*aO!;ORh0isk?RgAW2l@8JEvQlv+
zO*nhj%mS5Bq#j*Ty6_!(s&ut`e!AC-K>B-0wq2#Q9mPjd+q<QnUk6l1YBhznz>#i+
zs^OJ$9!SUjqMNB#Gr?8voT?+g`2E%$km<XXDJ6F5RlDm;YDL16i4Li=gtigmP2^hL
zAx<>HUPErW$bF1R?srr{Z6v7STDPY0KVR->rvAsTTqfq);gnmoa@a*~8MaXm2THr`
zf_A3lajYehEl_Uirma=)P5vG%YISG^k73zdD_kaDU)G5~bU$OYH)y4Mz84(@wi^r_
zkcLz%OmwYNxy}r@wK~aCuv@xP%M=~<-)xkS<rQ2Cr&)hnJCf6}#j}l+d&-<s>TSjH
z?yb@lR@Um1?)Y}tQA&f;u-mz6$!xOjE1W!vn<OPmRua7PB>3cGU-&;?a)aEZn-KEW
z7FqYQ^6`8_Wa8<`DHv!_av)ZM5j1gzP!o%~rd(Qy<hydwphJl#76D9+VlV!GVLKL-
z&|R|Vd^BBX+&-lcw;m}S<^pR(6S$-z32kUuUAb2&Znp7tN@Z@Vc9Nadfb9Tu9f#Jn
zHsjXHeatJkSz!DiwE9q>PHQ5Sn@=sG)h3|~sn#52#*}d_#nDRU0&0}vCnLgGoxjA;
zTF@M|aY}XIl)puUAP3T<uOGUjE+e~Gk$h6%Ly1Ff``<W%vRHfKVM?*r*T#d4y}G9V
z0A8uR^jifNMQY~qi!M8E-EEejlvuLi&C}h&T&`z~YKQF|v~UL-dfmjjE?jwKE+xR>
z!pY(gRgmzGzvy-R4xNG8P!6CnR2@Rvvu#(43QMSMK})!4H19f~4GvHbp~oL&{>--;
zd8_b*sY_E%)F<6r%mM8_$$woF_5S6afwrLgFCkv<Ztc4~+m$k3ILoeQj~F17x498F
z>Ovd1O4PSNadyb5qV86;_mY|#4qn_M-OK&|0D@lMu7<VuJyaK|VHakpQWocWpqjV|
zsL0Zli_`*Ke;Niaka1E94FKP#s%KxXfTbm>sRs&DrL9S5Db(U^0Po!!k@QKnRTN4T
zlSC1Uz0@xW%*MJd*W!aVw^erK(OxD}l?MB?<%A@p5HOw2Vuncf+os#LO}db`T|;WX
zN5pL>H6o`hw=#A8dal-|PUh;w!);s8cWZR;QK>6Y?iCWBn3#*^@jGy&q2|TK+871J
zRajf~QiKdA^ODl2N4~i8?kb5xETKiDfkiBVnw8zy@arMfIC;#_1SM$&V0YAkvu8ZL
zk<}@vK*Q==K?53AvsIO4gsYC*k+(^f5|;553aH>n&oRYY^o^x7rSsWvB?)9Hn{!se
zsZ}^WVL`*j1qv9Ig(Q>=`~mQ;^6oO4UWC5#O;$&%)lJlXjuJiH*H!>YDj=w3l?S(P
z8FqNuXxub;+8QKz4g>CwKb9%(MgZbhh?SZOppUF8n5NugYvcO(hnAI!b!$p!Jx&Jt
z;rpfAT0?kIh_*|P9`kj;iVT#j@>w}jMe!<aMwXsNASzEWNC(JN@ZNNTMCGHnk%@iv
zHsC2BBP?R4b6&DWykMJAi(7!O+Ei*<$6p@|xA2!v>0`KnXm>yOjiCBTsi%2UE$LIs
z)z9O)VGXYmikFCyxCu$7Ev22+iiSX>sXq-^MnQG04Nk;;^Ez7<Hm^praE0>JoLou$
zQ^aLl`b0Tyq+A?5<))}4e5GG9v*FT3YoZ>FM%v|;+DfnluNiEt;41N`&#bHr1ywXO
z6$M;M#^-#JV`#cIvv%oe?;+k&R0vw>iNyoDS=lHDVr6eJ>vZzL#xR8{xqy?xm73Z_
zuvo6`2x(RB5r>n3SdyB0d4VFUP~0R9&So@a=A5S}@?9JN27{_=T+dl|`u_k#O$(+k
zuAFHBZWKP_X$y4bt7dqwB>pqUhXF}m3R+5P`q@g2RsR5p@0$C-eHlx%>Y9tCn@<F$
z*{4S;uDapF-YhVHDzzLZ;yd$aQCQ46&%33hx-h)FF1j(`WrP~w#-mlb;<u*ql84=M
z+4cL?@=_Whu%mTV5^yBs+C3t*NX4CZmK~S2P_Z{FM=zSHp*%tpl50|UQ!Wy6XXB6K
z(a)Cdx_fRfshs;e`#gMbm*To@LXas+-89&AnMZFOG$WS-WafV8MB61Pmu8Y;T4uaT
zR(qIqvK04}%Im7gZ%os4rcv81CK{48BNsZ9JApaDUcS>~2{b$;mrIq4aNAr{E7T{I
z&2aRHLCUgsBRbPrcP$D^U`<MluxBFDFP;S?QVQ)rB*~g(SC6`3wKkyW3N(>?j$+PJ
zmQin4d3rhTP|PZXswwulXpCc6%_lAD#(8Yo^ImqrwXCj*NGIrwuC)7YMdID%&%0Xy
zRO<N9Z~{Db);Fp3yk}bF$tR5>)9oKpS{CYUT`bh0F5x&U(-kRMXRc{1c6YP3ns$+U
zZ>s4xiVryWNatF+z7l#FJTk@CJa?l%bu;Ml%(~lpDqPm}omS-zH_T4-YwHu&r?xKH
z;L32YFxS-Q&aVN|V+nNYB*r@OXDg0Y<mv1?b*kC+Nv_W&hFYdCd3^?}d@DRBEWcRi
zIk)fHv$s==I}Ey$;V+(E9v+C9apCoTruTgcukBB0HD=#x($?W^^A$qc4JZ$?Mv<jm
zYMPh7+_q_osY&@!UH6u1Msmy1E>_jY9d%u3&LK8PLhFnHi2Y)Btj{SaamJef5}deg
z0d}X>*j~kKrO^7DS5FwlD|j~5!c;=pJ?|0p%MqLLYwS;HH76Lr%c(+c5Ie;Bmfu#*
zGp|V7wAU<Nw!)nat@e#tRY+D7_ZoDIOVu%vWFJkxqDLXOS~)E|*3z~TM)VuvBaDqG
zxcftv(RDzD1cg%-DZn1@?~g(n7aCHu^x9E{K9IK*;)AJI;w#h}sK_1>7OXn`!<Q+$
zxl?Kh9_F;84Z4QqJ1SU_FLIS^Z7rU9%-*Cr=`J?VIGj&kmo;<>${}eMmy31VYi3fU
zpZbzcHv)&sw#{kaMAuLCPS@l1F8&4Tdvv8;+pGnv3LC}V7#?t=DkmZ-UKEjUcy0qP
zVO7XM1yllx74@1>r}Sp8>)?{4=}SF38`#}yE#VJ0Zk4%}9B?Y*ltnQFr)qgdcQ)eR
zQM!KK-Twf2b<AjWby;n*!6KjlcmpOo>|W*Z?!Jj$8+2VWiPr-c338-VQCZXyDhN9Y
zMY!@*>KbvxhnzvEqKHxd0Oh7ZT?D9i)f|V~11z_!BI%UT7fpp8oW$g7kj(LqyKQ3o
znmw!P6bxJ`1vC`_TM}^-J8<3N&jtL}IP+tyxAAM-PLjD+%0M(3pHco2RGJ(hZMmIC
zA+jT&>((cn3ByXj8z?)Mdu|>QLP6V%fT%;g?5j`foLgYf(IAtMCxGJtC{S@FG|zgg
zr9O!%K*2%BjEZbKVaAj@wJIankppfG3U>O$Zh8Tnni`cM!qIM`p7BrBKh!~D4jeS8
z8=f9R#sxu}X}T#vX9_{YYfQQhvI-hQc=I3~x}WQ?kyO13v?ZmWjH(Dqc$3uS657zO
ziYit{6pyPSf!c9ql#rr*N81r*l8~WX&i+4qg`&uC<LC)W22|h90cgakW5xTuvQn%x
zZ`y1tw`V?(U81RFp)r?pCh+W-s(=HGN>Zb^nM&CuLeguzAaBA{+E%n0Y9h&}2~m|L
zOX`^;5~YwWK=BIg7F#eIG{ZhIICI_<3#x}0H6-<scBoJ$y<$)bcg{@}QWiSRl{PQ|
zRqpQu;=mE5((Ri>#wolDYe|z!V(ld@Y9vJ(Va!P&wty2Q%5arpB_7^~c!pO&F_PHc
zDJjaZfdZ#eW@B1wqFPp1w}LAew~=+w^-Y|FM4@V=%GlP4QnBF@=P=0@XuT5bnhbF%
z$B#Kg^*WB&&SuVg%++cnO35EAg{fY0ER81WSX~M3#35>~a#*%3sBopKnNkSU>}GV+
zR<cWqUqKMAXIO_q?K+mpR~ZcA<0UG}Vks*5OoN2+q?%ZuHw$nM5-tbpON@j}txTuf
zh8|i@aV@9DE-Pt{RwRca<iPUG&x-B8CUsGG{v?<yq^k*+3|A98nas&+sWB=^shg2w
zoxM`dq^OfINtO_)QNm&}lmw*65CKsnm;j(8B*2uSx4g(X%S70BZgUbCfl?g0uZ0lj
z;Y99E<?K~W@%WN2e-dsH&o1kbG9?icBCrO=wfsRM*YO0Ds|nrFX=k`1bhF%;rcRhH
z9hPm8NQTuQ(hLkpREnW>h{Xa06A)DZDs|J6qII+Co501K&PO=!tzL2+^{dWk^l`ny
zOwcG(exWm7p%kPY9)NRCvL`^@GoD6HylI1}w>`lVY<q%abPw&gNVhVOr9N+HmX1=x
z(G*cIFd$Hn44@>L1i%O;MPLJcVE+KpH6QYqAK952zIslf{!-)nGXhffT(p;#-8s$?
zU6cT?w2h&${51jyPUm6|vv52oE~k^x)8K2V4grJ$vQPVc)0a_LyK;b@;`^Uhare}Z
zzBNt2xZi*(Q`8Fgg)~ORu~hjKksOR-q}23MQk}d-BJ8x(_%47;3UFiYm2p~AL-ZZt
z`6Q6)R;N1PP#;PU@so7XBsb}!Z+2Ros?ddw3sOo?{{U&uJ6p(3UlAXsgZEP@pDMSa
z_`)0evrVL@;)1Qhb02(hM63)o@lZJ*VUH-yHC7Yu?coKr)Q%W?-$xjwBmyc{fz>pd
z=)*d#f}-+0e7q-oH9_{}Na!}_F9>%M56rYBUdqz5duOW+>U;rh*V$5VggAq~1%Tl8
zY<__k?l$Nn5*NR%njfT1ZH?9&(4P5-go28lgQE}M6y>#WggDcHjF93eucmKoZH+gm
zBWc7wD?uvYrqz@}tuEAp5`>_QiWaI5VXWO}b(vSD#ccs9$=+c4u74OLCj9{^CfdKR
zTC2)f&gi`kl7ovh0H4*N{n8nA_RSr(!}`rGqv$h9<jVf#rhpNF72s8u-LxpB*L6ak
z3KaXqy%OE0Rn~%`aXG4#`kO-wAlaxN_Mh*So3!ib)UX7tl!1ZNDE(92gt*e$cRi0?
zjMnGHi;8u<<5MOpUJ9h8D(Fr}$kTWd#oHhywwrKuQ8QMt`I(Ww%38zDBw<>I(fv$H
zuF`|cb%zm6)SSTb0&i&<)Y(yr_ZAY!U+W~$!Xft2n?d9H)dfF65ot|NiM{*@{{X1s
z{1D@OP^{12k&8{m?M)vGA5^3QK8ZT)>S`T626x?;?EbQ!+cXv(Cv_!|+W!FVZw!8i
zUQj3A96{(081l+?=q2OA_mZ_F_&H5e>_f8m;F~30>5d(RakpR5SSSAgx^=$$cTg7M
z)RDH?`)N@%Ik_j@jk#s*c(U!$+r~VrSo;X=ZKfq@?%HZd8w!?PBgo<vp03T&Ss=ZD
z*CeW+oa>Lcp0UT(<jdJ*K3ul->GSrh*$&lcr2GDjs4xf5$u2kl0CRQxr_pGA&Rzvk
z#PP*NBAzKwGt)V6zOm)C;LF?c<KG(k9xs@2(9oJ5imFxgC<8u@)jJ#5{d6ebX!=dc
zkEuv#Fz@}%VKtu5!R49fk8G>v*=MGoLoOaXyW;uGEQ#!T$JifY?}C-5zkj4T&@4X4
z_BaWr{8QBP&vTsb)$`uWy^kI3(c`6flRK?n>;ttnV6RQSu+<U4CbsU==~_?FC!xz9
zb%pOV@x2-Q4oULey!peNw$}R%+Wiu~{i5Esk^Z6)&Tr{Pe{}B{!<&x(0NLiP@_T-4
zJL6R#)?hFkDg`H^!jOK20XA+|HPxNviKLoHq9RO!jWhs}Fof7b(=uX}NPDMKnIld7
zK_Jvf>9oH<n@l~yEF(h6qY&Dq0Ocx(N~V$}D9JG?GKda?5R(9CbgCr=Q~}arP-O%-
zY{Vf_pd28?B~_F~(ZUrFg-a0wq$&-wG!!{WtU?S3qE<jKB9;tDFbFD4N=ym~Sd_p5
zS1A%wkzo!<aL#<4j!w<sU=obVoT*)6LS`}wBuIq@nm`(80U~HnO=MO;8nP<@CT<b1
z6Im626CwajVqgP{SIZB!;!O%vllR8qRF+<-QQo(3(P0j#I#Wcen9gpsT5$Q2c*@?(
z--oOagehFsa;g3P6Q*Ai3o^l+I`sZ#T`ty+Ieex37cG@aQ7TEqv{QAfU}6@Jduhf+
z+i3=cY#c4PDW9);6Zc6jN$cNDYY95+-lqI__Y^BM^H{EZ@Yy9z`5&uaI2IJ7Vcw#t
z!HTF@+K63$IlieG{3_n3Uh;<3%TRG?NUt$TqS55497E`VRo%-<Pbr1GnjEnJrjJDh
z*AVigyOYr^sjGVSt1-s+x*Ryt5~bU?(Z)S0O%YzIrpK%kcP^>7J^;6HjDyJmr5|Qs
zb(io>-F8m4{$=r-`L_`I?p{a<9Hk7Dt56Bg^_B$z`XoMuI?{dV)SwD?Sj2>@z#KrI
z2{Q7(V=w;zb^eQt#(MAZG3kFS-{KL|no&IDU8{{3aGm<)Nxx!lw6}S~^?9XEE1>8r
z=QHCyX}o?FuRH0l=zecoj61aEAtRKbg*gNr)IR?JrZ#C|pcDaRM?O&`sXwZ7+HW3-
zk47{5wU=MN-Dl2TFq8*c#)S@IC{l9GG*=VC0T&K9oGC+z@kyw!g?96r%A0eMtw};E
zaZF=vr-Nz4mQeCiml`1Vv7~)}l-Fpb2i|>n?e7xG87fkW(oMsIVNaHvCoHzsTf6Aq
zI_+;?TFy3O>o;%oQD261-A#>6%QhaWlETVC=3Da*%1EKla~|pzioDa59$HaQK}O0z
z`D#Y%6O{b9Zm*8xt^C;PTQr_p$n`3*ZE6@>Q<-8F#lB*y*cih?v(i&&i)6gxuBNJW
zJ>ufe)?G>VP0NB~G1p$~etNmw_vxjF^GjBJJhYw|6I1lfhfio`(5Tv<yv=<{56I7j
zzNWJc&1;sNN1LBPzm!|I_5r#U&?)tZ%gRrybiR0fm+3_C&*E&YYUM;J4Zq+?%kqj|
zuFk+U^yM@4GW)O8#jmA`eLL|XTDAMBAuTK`so^EPdcdrvnWuUV?IX)NvzHa{!X@Ls
z5WkmPUk}^LaCG^z;|i^NN_#R%p`hP+n}?j%OZ72t9$%+-gA)vt8t-P;VTsl%<3lny
zq)Yq>)~zm>LX_B3WCd{oo;+uppWAqK$FtLa`eR=2Ywv!hvCF%~GQ3%1Tw_eO^sr+^
zRgvZQm4uL$C{U;lGsC9&IPMuftCt5q)W9b6#No<Vw$>fyWF0DZQ`~8nBDhp#=Pd+n
zC6%R_vg7Zpud@|Y>E5wzXKBvkT{P>Camrg9QncIm&J`(CovT_)RrHC<<6V3s(KC_5
z%DFo($rT!@B+l73O|~cioTe4qT6W9aN1uCh_Fa@gQ0~s5mXg{=Q<UPh+fLtI$9po<
zyFS&rM|6D>)eE9#apH~2>7P4|ok(ucv<-xZ9|B2%a%%EgNKrxrY^$MN<5DwnCRKbz
zaY;&JXJ5rFPVHin=sUZNAja1Vu2VTJj<~VpLT?T&<2#ZQv6!1`$4jR_DtNo35t)>C
zH|47Lrb^b%s~elNqPSHkT)cJTkuu89lI~vVF{ig$s>MKAjGMD@-Rn2!V;yS!IahiO
z?M3HThZ2l0^6Uz&CCiegmmV1wW`<c?f~GyUN>T-5c9I=2X3&_jKyVcZ?DD|jFCTS>
zCSRALY-Y<$3W`QI52s+M*Q1w~oV>5Arnl&KbFK1)5@ld-8LFpCT&`7!>5dSm^(&i|
zZa|4~8H!{C)>o?%^-OVe^ggg9027%q8n|hu!6aom<0|80ospdF+SQA<8czM*l8X0T
zG$?Lfu%DSSlCjCjIOgfkXcMPiAl1~gt~J>86P>ww;^oFp5pdhQ)Hni&EdfARPN_0U
z`R7M&JS6Yj=epv`TJn33ahE4gLxRczyUkU#VM$@5nsAyj=@hBOnS{4&AwwD#8&GAD
zatXwwp%qCYzgW_;{<goZIc_IW8g2B3L3yVbZBHWQPo$T_g-4bJGRto$?#VPzFE#_n
zZA)>n-fiMmLKZWjSOaMzUx)4X0IhA5-O3i=Y0}F1*KBgCpj40=TRUN(9qi1oZIIYW
zcHv8K97?!d5ML`LNVg$923g5J@TXtd3$iYu2O61m>N{|&l(v+ya-3>P8&)d(L=3S-
zw$LbiVf;ah-4;Sywxfp-NgPh}kJsG&ZB2{JLjh}Tg*dQn*esL`DO-cS<xML<eL|2I
z&e$cVij{iuz53eQ3nYaHa3+pr{+&1LAFZFzO^l{3E!54oHtjZrHw<8EjwPj~#Sw7g
z{duVO6SN~qEZpO2>fNNLl9w>mNx5m2sW=Ef>Y8`FW&VBt025!0{{RdAhW$Yvuyxe1
z`*#5=OE?&GpN4J_d&;<M3Sw5r#s<}HqSfY5>N$?{Zj!W;poF~gs<j0Y0ZMiP4W5RF
zwR0LAb=KRmXfUUn3QAOq1+bzQM3mw@@(CVrH(ckv=qwew8^B!u0K{dd4h06mq2`ZQ
zO2_N*KawiJr)VzCx-Hg+LLa%IILn0t0}UYLgNB<#u)8wwQ{fD$ZmIO46#=ETot-1g
zDBM5s_?p*MBIsj6m`)Ofyp<tc(w#Wd5av*3ac&}%iyUPD1b3NT&H__z6!Ni$7EMaX
zuF?AZPt*e^OUiER;9J~XuHCiKH5Tu@(W>Z>JxQi{$0}Gau-nfuY?oWS!i0BAN(Dtu
zDPwMDPZ<8_bo<}L>-Y$D<)OEoX{&bHO092D^J=Q@FO;;=3aB(~Cw!?f1qe#8+a=+r
zwwJ9Eq7am=(0$^h?gyuhWA*zUpW=Ww?<rc9&AL#9pgyZhd=x81$Eo-IG~T(zY60XI
z$aSVc7cMPKfL~-SL?sFY=CTfFc`x$*__zFheNM34s#~s7oJ!K$t+cf%ExJI*j4F#!
zNE=Ol@`osMGD6(KPtJ_@8&vU`zNJ&RHfSkZi$(wfLH)i500p%m`c|qQ{zEFwV{m)e
zS>=+RP&KVd+b<p_B7fu$Y{FZ0wLOW#$x+0GsW^&<b++l_yi;ws^UWa(Z3fp0P{$Rm
zUZvK#<zFdI;oJ8%V%p{9**uViwwInKn&)%@-Y5w<)Khrj7GbVKgs6tp_yNH|N*qea
z?l?w`excK_V4GDh3i-4zt!L9wzpKZf^Oi>4R<`Y}04YgZB??Hy5ZSIgtLpHX*H-oV
z`>an>bEda;gj=wMDRn^<01zwQUSna>TKl65Y30@Q-Lx7`3vv>cRN?NeMAy1UtW5Z~
z(?;~0>-JX-F|hs427p*nTSB-#l!~m1rkIBlFA^4~SPh{xtEno<%DjYDgKQ~L->l5X
z_3&%achkE%_^MZ@5~mtSZMRWwo@<HV+LR~}L6N8c`O8ZdpHQ{9e+mjx>aN;CYL_sm
zVHMvk@Wz*|UHns`sm%$elHN5s+SK4$0$d4or66QT1H2ct4_Rv6if}$0#Nx?y{&55?
zESeCIYq|&&@R{-bd|Lf$?!HO2a;-THDb84+7yw}asJ>6Ap<GkFYe{GB$B<s;A$Xe)
zCFaQ$Q+qc`<Ww>yXJ6Oux{Z3Xzu3{XRHsnUDs(7j<EhQuyUhx0M)7F9ZNkcuhpoxx
zx^dA=g{3*5E61qbNk3l&YN55$Ay25`Wx#Nw0zpcHDdMGmqN1Gm#iLbWQWUHdpjt^h
zz@xrdP*zXZ?y2a#6xx~rULQ$xsD)*kk?A!F&Z)>kUzPHkKtpeyUBZ(?n=GXFNdExj
ztz@vI9R0!&-l*z`Un$1IUP?}4y$w2w)++G#8gmNM@cw<=&yR@dGgkh-%L8;NM7);B
z!IFE!yh42>`Rx^IT3gRJvxOxI#6Dxd4dhi%z!w~;TCjwYoCFV)_1Y@!D&{F&)FzZl
ze~(p2DgfZX<BLsF8*M2;;(Dm%#N`WxPBxICnOFq%r=))vT>*C5iBbYCD3xTIoW?E{
z%X)N;-L%4`1$WLo2>_6B5mKt~!?c<NTBKaK<9JjaH3(_EAT)#2Bn;L#DArhgoat{}
zt=pHE%x#|IRoE(~zeiZNOmkmG@W;<BM{i+-^75{)N@>Qdt(YdIw$hazs@(nNJ-2PP
z=~5;#yQGg#7axuo{hG8^Tf#Pm#NHf;i5I4Xn<3Lg#603aF-D}?b|5PW%Rd3UY_zzw
zVyconGBQPw%TY4ELn~6`f}@6mDq_r@l#Ff}LMlk{sh3(~E&N!yOLXakp9EfN%)06_
z-2D-lXg_e2r>vRYtj_Im-D0<-U8f4#NgX0+TWKjA1t(ZJTXs&h4itcMh*C;{fmL09
zb%c>v4N0Y9CUeblom<BklJquG@hY$mJP<JPnZ_(mO3x)W)h_Vm8R~1rSXL63Z=xeq
zvADmwx=ppcy-BaB&jgM&jL;o%u!Si_y4MAJr1hlV79LY;$Jxu=^4u(+7CpyYgJ`&>
zc`agU*A^tT^^ew9oH~LUMkP@R19P<0npZro)2Rv}gcY5J{{Y<)V#~U%+8wD)qifiY
z#x>#9F>5>7rIS$Et4B5Wg4C=mHb}!-6Z+Ja*KV_D9OW{G$W;kQrGL6z-@y)$>qKXl
zXjrxiIVaa#&p=}fi-Hwy{Y?*apUMNcb9Af^2WztMtJ}8;KJJ_5)Z!IFwBb<UUIq<r
z0z;<O>*5-+{{VE?U{A6F<<_n=mr(M#YiqcraY+Xy58o<!2dcXDcZX4W%`GzHZIGn%
z4GBs5r=(S_t@?u@Z`&<d7L>nIllotfl@6-6(NlAT6*AHh#l{>dba;x$ZN=HBs^Fvn
zg(&WnFA~0BkZ`JpIZsd4knXu*F0PIT8-9c!x}SvifOQ8Y1o2SbGq$~7x|F|g#mk8#
zrPLs{r6)gzu~AxemL%wvY;8^PXL{?)=PkS-IvK+6ERXdP*+vy~rDGdE=2vb!G{@Vu
zLyPa1N?q?H`T|rzNLNs0zk+)Ff6*spy7fIn*4K@Nw{W^IGzLkwbwq#SHfk%@lo2<g
z-;y4=N4pkCLfmaV>|Ilts8N(f7gb|Wxo*i8&N`O}BIRjt1A~SlQNktn6RK%P-G$;(
zR+JS51iGQ~ZaqFUmY1_LTRUE&w!e2^G}@U_Led;nF`f5QnfJV?Al8N~Z24C0fP@qU
zcj_s{POEh*%1Cda+?{HxwE+s!wUCDttPV8cO1DjTq*G%P+NTutmZOcvk%^YeWhtjH
z1Cnc8&z#p6PDpWo5+^j@9XWOM>yLHiDWw1g+wm}YpaQL_x9*;S=OP*uY-Lp+x=K{x
z3OfyilvowaqOhl@c<}Z}LTEszkN&ZsAi==U0E*(tBlnmb3p6C|exEN1G^!kjX-&2`
zfBoYGhQ(B#qLtyF^~y~EJ1bI96WzsC1d+MwuPH3s;6+HywA0V0_sA^jXhu#0jPTfX
zJ!H1pi3wk*ik^vpix@adYbPoi{{VDD=@?a1sA13avw{J|vT-CTfKYmR_<MJWK~@xo
z!Ne0>M}Z<rq&6!&)uqfN1>&LoQPLLGw6|ieD=H;K?oaTLs}go8w#aMKpBX4tHZcWM
zjpkLTLk)ekDTd+oG;=M{Q!$!yw}Hl^NLpis+w_@Dw<)83VuuK|GO@xmr;-tj9qJ^I
zc!?EyR(4xq983`gMQ&-0(HsqtycaH~a}a9C$^#WS7@!JH^7$d+yGUY#X$Ij*jh-io
z<y+IbVhzDO45Y;DmombFvZPCH0(wS^4eXSqTjGUE(T6zl(sev`*5D%4CM{>7m&qeO
zD@a-Z6seLDrFhFJ*u4{}vfCu&W3bQ}l*=nSOB&D(1r5YMF|_cStm&C6TMU!+VKIfu
zno6eXQgM1=me@QdncFq12up-aro3ga+8RoVkIe+MQ|65+ZA%MDRxRL=lZ%X+TC%ea
z(nWWOLV)2it)f;)trrlyB=1OsF3Y60r331$LqKB4#WE(yI2gFeN<kaQGzPG=@tMRL
z9OZ;grJr=NR5vj!q>asFrCGFssHE|bqJzFs4y$R<C-C)&xGnIOEZa3Q(pV{jWyFo7
zt77A%#+>4$A2f}`&Xv1a**8X@=MiwBNpT^XWMsP3$XPgy={pm%o!-mc2Pq0N!75hB
z$i<YPH2{%NU=5(jG=LJEqH#nLlw?w{NL>u0Dt^ZZ7G9(a5cSW(fL+hSh(h)%zWeba
zZr6!(bFn))<WP)*D1%J^3v25WTK*uCm0=h9Z=!8D_XN!=rag>L(qa<1m1zbFh{YnV
z&`eNxpi&l0O<)C9wtZ4Hqw1Q(#hlYOJm;-mb2;l*oY3d$Qf7eYg*ECEHR=&cq;why
z%`rL&?<RB0xtDiNGmX^Rp5TeKJ;5O91N&nl*zEzZ`Msn!w5Os1i3u<PRgnNOG7Km+
zWI_Nsx~Zh<ALTATvoRXK_)ekzQsetGD4BLL?CD#!?qdtYt^iV=(E^uB1xgj>gZrl)
zCf=QbA*K43j0znoLOzKIx=JbDUVTMC_C}8-@=p;#O+f~P{Zo<i93lg4l_}P#ja%VW
zF?poq45%GM<b|4)0)JO8rjim?q-Tkv#2v?oBl4F?vuiY3((6<qN+{wL-UHZXVaEzp
zjl?(;^9+<c`o)y;G1V?CZW1UK+DAeL^C@kt(-BGGRL~z9$X!;o_es#CDK0AsN>kH3
zkDX*8Dkr{-#}uEx&O3|Q2gJHigb*^}U!n*$6i8TDJPF#Kae5_-At`0Fm4cs!uBkMy
zu;mnnF(7AJbvt<0DW&u-MK+6t8ZA7*!D#~$W@_DB!A@xXX4m<H9Ze;r9jth;l_gyd
zq0iu9Fe?rPtt;qOnk(rN!6-tTDpnUNp}}-Qsq7z|Q)t6dn__9Y(6gV@B?;Moaul0^
zlVO+9=BC{GcKe}PO4Or?Sdw;0NEm<O8^-A&s9F{~geTIpj*A$Fl|>9WDng1<n)q`z
z_D0HR1)Jq7E>fFN`I4+j`@|wpr6pL~Z^R0wzS#0KXxT`;ZNo<#YQEH;;UF_&q=c=f
zn(0uN5$xj|HHobo$aaWP{51jBA`A-b+f52yz&LzGCcp5(s8f6N6tag&#Dye{sne_)
zn^ICfGvEx!8I^e+k?LxO)9z|OI0hlZDt*%nrGfA+7Ea$40FN#Zo6x%Wz>7;Yt7IPx
zp^Nv5Bbu962O45RzdYrs<x($<^x2`eL%x?3gU76M&R{FN+M2Hw3WMzu3l6Z~+}=P1
zFDktVs4?3vTdb6&*2x?(NkxIT^7miNsj_^ENctoH0CiJ_sZvL`?}JOdGqWB|#kc@3
z2_9s9G1A(;Ngz1cPYR?evMt+N+H^M;7YH>|Z7h9c<YK9Hm{Tk)9v~F^H<?ztRE#b`
z;-rJZfmHTEF3r*o8&|Om>f4{kc?~X)A)B~uwc+l#4;mB^5FU9<;d<S}OsheNeFJ|O
z3l5(Xq&$O>Q6T(|0Hpb6EA1Y-acXR|;77`}kGWCV63w;II?rS~DXk|KqoY{4U!5%_
z3O*rC(8r9I88lcWK0G|8rzTUito3uti;ph&%H7p*ny=U&V{gKjr(RxZi#r6UKG6RF
zg}_Zcv$$^#GDs9V04PN3kGkZY`nf#$dk!qSZx?rvYX1QKUOQoG6y}+Cr|PI1CaSl1
zk7-hC?4HbrLVKksuL|U6ryqBX?<{%t@#p=YocV08W}h}{-Hq*LgtDDWMbs_ny2C}*
zy^BZipG>5*>ToQ7z`QP?{{Y+!_2bKiU95RF`Pp!C<KG(k7Z=L8143weDyct0fS*fh
z-Gl6AxnF<K^yiAVSY$Hiu}$Hg-Mn*?JbPOCy0g3JUJg9F;~zDN?V8X30GAHQUKKf}
zUEgVHIfMrV%R|`Us2<tud9n9AlfJ9xy_x$iEW2+PkLkaNCwG7L1=_74Wy>qO9Z|8c
z6=m9aRHnYk=&o4%oG*TlCNB5cXOGKvs?$9JI~oqRq?{MJb;|^C!HpmHCU%VD$%XBd
za&Im!Onc)*Y{*3pTz-T1%^lbU24E>Q5+x{!F)1>L4ucSrEH<IS3_=wG1EEm}R0yXC
zF(_295}Y8!Aj<$bL_!P&4iI8cWe^=Ihz3+P3>6R+016C1FblCkhzfxeaA3lqHiHwC
z9w@0+BxR}%YMl8y9G#tTFk)g!oW}G<kysQeMPyJ+ipj7OAQ(_8MPyKE5-2rhkkBSZ
zPy%ZrumWUO0V`HS3W<>di%!g5`?dEhkPz^puGogsu?kXD6gLDB?3&`b%S^<|ZY#7{
zOYN*bYTe>SVNI)-aFIioh!K^w(-&53Twq$%Mimy9fz%K;{ciy`mZn{{XWCO6(rYgt
z<d|=EZ~C7ywo>9ykWdyfOO>MO^8WzwtbOq;To?Thw{e926Y0X>KdrS-j7+uhNmk42
zcDYGCKcT{wT|rZ+?hj4FE33$-%A_6X)(ZwBi<D632N+dwpQ^O<@tWE(I(GhxzrRno
z*7tUo2vBL~Za65sni2m1c3(saec{xp#vEbA`dn%B1OP`$QnKz@q}S|qm$ttHa(Ca@
zcT;A{5~s`Wt00u16`y7j0239u%V|nLE)kO~uhe>#@Qq`=-le@hE4=S*LUs7aQdOA<
zKI}018gCoE1y!v+nAi<i+Pb@ywQQQ?-MWHRP61CUq}PZM>F{RE_15V4Z}Tj;c}XVz
z<(9cDt;MNHq0Mh$D{%M#a{41@J;vG8A<*MaVG62o+yPwkQpq25*P}f&Ti04&&3D;j
zW5|603oex&2y+M>2+Qu3w)&l>AePf~5LcVapcuRWrc-mP6FIgn<9-)iSGZVEZGtXV
zT3$4$IzpURj{=d#uxvYS;!1HBLeNrBg<)6(Y=v;F)=PC`6Q=J@r{>@Kq13R2xZ2At
zDPI$oQ;!!_1GZm8MX<)zebLK)KvQh9bg*1fYg|QKQha7Ckofd&Ta@W4Z|~o}m3oz;
z7Nt0c9cK_Y)oQTPloP>frymIV>9!thhme&QMGH)A<bQO{k}cCx-D^bL?dWG<)7LD8
z+!1UJO|{JCIHZh%)O>i&g7L0Zt*Z@NcfwHf-RcD%^-0`;w38C<+3@u({nl9}%fHw~
zSZVq5YQGY!qFu6e*PcLH`E4j8859m03`$Rhc8?rQU8m+>E|U7v)BK&b{{RUYWrn}L
zBwJ}#sjH~w9wlVwFXYm6jNdiBRVVpkz^hH5E26V73%k-%d#ocal_X7mMtreN<?%dn
z5eG-MR%vNJd;^c^F4V1^ye7XRK3JccpP20Hx@Ee5XBAffk&yl{7R%BW)m!Da;Gs#c
zEN5dIg^A;Db^OV`d6&yiC0?<Z+X?9rex?f?wq0j><-f9W_Yz!o-z=9KBfqiA%&shZ
zZ2UPTq^Y#2IYy0NhQ$<Tn#8xp>b=s~+{SWAVBrKt&g(Yq`jjI{=NYxD#Yb9#PI9j2
zv^Huq3m;6W<rrIqi)Nlor)ybgngx%hYi#W_y_XK%B|K$P?~vg2OKUqOD=Oie_S7j+
zC_UxY)ljUa=1eniu9C+@Z<|jULW|Po>YDOpiN|ZM=9ezqC3_iEtFBsoUwqcnvzLvH
z<<#ZpIvG^<u8~~hM%dYLK62=zjH12Ps0|HeXDsy1tz*Y+Sl()_whdJ|tXEgA;x)rr
zZIQ~`l}u(=(cVmOhu2!Guc(IWNJ|?YqHg81#xagMGsxMySD!UiWy@B<90Y4^Nf&ZC
z+G%U1W-29$6qL!})1~BdCA%<`<RMMMK;b8jm8+KP2A3A{F7Hq>2RVxxb;l<;upA0N
zf+}(4XSB|i*GrOPpw#QC+8qp6gqt<BlGDpZWGE<BI(FS6OIO9babxNd$}7A=?n484
zByM4EZmnCVEcvEA#c(AeGgaEIFq+XTDoRRo?<7|V=uXozI^)5Y!Pm=ACojFnSH%|&
zCxP8TBc>y?3u<&d-)%^tLYHi@P)WoF1$cUl#u#Ol)6<6>oxiKMH$FIHelMNL&6a)W
zNlR`k7%HM(EH4&84x_vs1By?k85ZxCl1h;4-S*tWk{fB$P_+%QCX|zp35#uW^X180
zZ7$id&TOrwno(`s(^7ebd4!FqumL6;-JA_5H0Q(#3|qXU)QlvRsE)MQz_mM<ZiE}v
zER}`2#uYH5R>B+Iz$uaPi%V~^N}8gbLt!?`R$<_2%nI-(vYI<k>e#kamfHcUtv=|r
zce$hHIqjWtF+KFDfKVA^ESET}KCm!0gSbt1q<*Mx;v8T@>pZljNp<Q3FC~kF00V-%
zBn_fhc%-59siy8$-V}v0aIMR){2u@XDnx$1$4UD14N}d+2Eq4SD|v($h102Q`@wiF
zltOr?Y~mQbaqdE~B@Q^?XOy3qH=EVqN)$?Qaipkr4n@;e?*+QGp(-dyT3Z;>;B7b*
z@+r{3Cg-226u8>hHE<^x#m{7J_FQ-a2kZAC+8m|CB%V-Z_Yu$cdt#7-adJr|#F4{1
z;F?+-N?dh<;Krvd9%SKi*`6vs+SXs!?0&x*4X5)GvdWu6nO87A;4}=Y04r<|1yY6A
zD6{Uy)3}FJT?tbbwW5@=0de&ax>R?Q@9X@|-TwezW!}@&VCo)iMJ^N)o=WSJmdqto
zN`a<$_*aB%9dxeY%eNYAfz7zNN8l;6tfjkjj<f^YFYED7*1ik0JjKf@a5d;(KH;TM
zmm5gKxf_x*gH3)Dex)E$kfnF;2~IJL^r_lEQ2k%Brs2Z@XW*$QcL)gy%LB`EyxNTh
zVXB0ll!CNzk#<{UZQ=~5sTj^2FQ}KWE9*2#38zUy($0q!=Y=RSXyOTQ-yvD4n}VE>
zlfE9bfKr>aZI{_n8+9$M%RCA$8^okx#c&Q;jPV{ZuDv_@eh2FPgTJ9yt-MxRTQ=|A
zJ#MwDmaHr-t5sF7rEZX%BP!<`yLQ*bV72bewisJQ^%NV&)I!$4SJbURNZu#MvEThu
z*VT3V{{VnGn~HAn;>DWK;81zTo+Kja$1*BxeNdBHLh2mKq32&yinUN!O2ra}u=+sx
zh}cE=e0nGN^iSP?#Y*ZO7fxHe5bAM^(rBdBRSE}!d?dP;joXS#o#L!dsVS&RO1rcM
zOVs^Bb%)?Bs{siGAxe6u;i)t!LP0*-k4cVn<i5AqWx`bBhOIrtz!FJmT@5ykEMMf7
zoU+>hRi<&cE!=svlSR>Diby{)ky`sBi&kv!S!KqGic5+uw%{mQ2vr<x5%SWch*>tj
zid$hm=<3vvl^l3N+b-tQsls`KEs5H(!w5=UakO(n*?leY-LH8k{{Rp5PZ>I_omHKX
z<&nhb#2HJgVdlANt5t1785I?!E0l88ee2|Llm~(--Afn}eM7|W3;O(3FJKnqKmg+l
zP`J5EYjKlIX-TRUs%L~!gmf}VLYB&(3#Gye(yK*e3m}u0*n06YFYBuMp=_aI-3n59
zG`LqZ+bGesBhnTQee~DcH$9(xs#imDnhZ4vcL@20!O&?RuBBg6b`>dF)P|hJjkJ{z
z*$ECM(gIvLe4CgadYlU`9%HL$fP@}embR6fW1uPDtQ*p4f51ii%WkL#RdH?!W%j9o
z=E{XR&8vz}rwrWC{xtI3WH^+eO(|7U9TX@CSkDc5!TS7DQE&D8hSQBU*la$92Jzc0
zDHu6Hdt)18@uqPLxpVe~lr*rcEd(FLUBWl0`KX-h3Htqz_1E`-aFm9U%W81@sua@L
zPys4h)CyisS%Jh!arVX)cik<xl7f(PD;N}&eyT~@Q}v+Hu}#HYp~zr3M#$i@a@k{O
zwvH94IH<KH>t&O+Fhhw^2g4yDwMn|I)EjsUfyzTo2ihnp$?7P6AN*U(t9>DNOXoVQ
zZI;k5C}tc_&tJ+vU+%{ydg&US-Tk+;xoa%DIK5uU#5$CqIN+&P9q`xpjv{u>>1;Nl
zN)mm7TH|xO?&0Hp74-1-+;V)b0XAl;2}!Eco*_yR#&z0=vQ1K2MSO(p;dyoH`I^45
z^?%86<^KR!<T+|^f>DhL^f|{D8jd~_plyvi7^`WeYfcsNo!)=1m&Nk5`gwZ}FaH1)
z0vTG8Q-GyuRT7Xlsr7lztq<wJ@OdqTeQF8l+<EUm-Sa$d`#zNRSkBQ|Vc1K%_LAey
za#Bf9PtV>0wey`CbpeKmRO@q*$Lek4;`X^`-=o_&wdfv;q&L~yGi=Jrfl*me-mvKB
zT&FSZn$IhhO?flz_%Y*}j+p*bF6fN$7=>x>8saismT|1Wyqff5td_{4jbKf+vr4MX
zNSL`+{A6ljJzV^`FJ-$IDSd>va;Vx?xvVtXcmV(jaJz|fk~7QGD<aM;t=&F;>YQ?v
z&gzMBv{cp0PFFT@j=1rQsOl@s11n#98Jf>0J(yzL=(f<3r<~>(=d;Yx-6owT_~z>I
zv&lLc)rlEGDFTygYZDcQuF*A`={Zd8GFgV&z{c<)O|1Av`kl~arDqpRc{%4UE}XdZ
zP+z-8jXJ?R7j(50kTc^cjyER@*^XXGjHb7RT(vnuQk~C8hct`lL&-P1v^<iPqLs>=
zIvK2SwY+AS<m8yRXLnHT{jHlRan*#13JxdAYfU#yv}YDI-YKlHJ>H=m2GZlw26uIm
zEv+tlL{jR9D#-?=B+*XC9{&J|vV<Ttm&=x2V%vHeU1-_sqSo1#+iHnQY0Jasw5)F7
z#E_MedRK>(8coucR&V*kAahUAv;%JPuihJ0i%8&OVxYDIn!>H!NHjE|;ha)PZs?GG
zec|KAkOC}SU7OF_y-+Ahe4sDxlJ(JTu(I+K-voDd+P+zcfkS;rxLk2;tT~S&jtimb
z)-KCWaNMnU>)oqW;!eh&s$-x-p~bDuqFO<7;iDwsaTVn*o}xx!HIDT59d_25gJEkf
za@Mv0QBp-udA=e#?Lc%DS~i4TDa}O>Ite%uebp4nX<p?g?uBmh=Fw`jy0=JV3R=F^
zLrZAWxad0{2=qT+a(DO!n(g(CvqPNcEi3M!)F5U!RDdZ?J!3sq`7J-lRjIkQR>qi-
zU#sCv$cY1Dbn6>ORO70B7aa6qY%=1Sao-ljX^k+}7IqFb&Ml$V7{XXXHD>X(sEU+<
zz8*di{mIvV3;o2m;9o_H&bH2y(yl_eE&Mg9R8!O&V+3YWcgk&3pKgKA4Be?=Dnd{w
z=uZHoY){rFd4KY$zP%3pyB6E5xu!T7xh0a1={RsGCx`-@2o&BQ<?2(`=GYCxpadTT
zq-;8geL8<c>7@Svw`0_no?%vjHtI{L6d2u36qNBKZmi&q(k^XOP^94H@I?wd5T2eg
z`W~OIr~QvrUumvE)2@)TqY-tqrD+sJ2La+GcWN&lEZbTwX*rio1v1$<yk@v3=4*m_
zv(JAfnfDobDW3&OCwwBm-v&z5`m@N28PIYH$5euHNc+rCKuUAY1w^HM%)XwcDU<<-
zo#K^Y5|WUiTKWB12(K^>20-j5n4Aix<zLjoHqsm<AY>2I{m>{Y3MINKzr6U!DNrN>
zKr$q6UV=(2wF^t7qLOpqe7xi|f)o?Drghmq1`5=*Adi%g0VLH}fd0H7)}ra6NubD{
zC(FVGr*ozh+M7{Tcc24eezX%<gJm0aJtP46LA0<AJo*kWEGf1dO-3TMZg>e7x}Ah*
zg4b|UtlZYpN?Xiv>Fk-SRuJ1*T9VQR(lv954c2qyPEPIduNP&1F<oTg5;CoHDJmvp
ziBi<+)}dHI+(`mmv$k~Bk;rLWBIVj`JY!lT+}k@s33pR$_{GpF)2kd~rx|?Fp9aj;
zr>t;~3)5b4ojKk*=~e2qSm7TR0pU008FKNl(yNO~Ps<;W+PF>ahdnpZTvOJfK2^JB
zZJpK{xW#=9caGe%Nt#KMJ6nme94L!jnuN9!B2>~9a%m8z988`owen|G1?)#L5>TPI
zjVjvBqc*gW01C$nNn=`##yqLQ)S7Qd0;Lf#rnKFxZ=xMixEjQin2}c0N>WT)R0b+h
zVQB$7h_JMgw1$=)87?BbNJ&mCq|(!2Wu&ZZArpq2B-$>vu-}n{)IvI%W|dNFX%obx
zVOLm?S6s}hGrETo=UBRBv?BEbW~ucUr7Zww7Hwo9Y%OX*5DIlCgv^z>7jd1T{#`eT
zQZew7ZFXg(*4dl@<sl4_v{ba3BsdOJ<*X8U!c8wmxAs3XTqz`NNQ;83If#pilR0e7
z&CE-H)Xn4BV;Of#+?5(gHHAthu_rhHs=?xbLY0(E0G!NQXsi~5h)N7_mW3r_$u!=A
z0Eli>(>rHPXeB9FVOH06Y9z^>Ert%0iYnkyQ?5OXJ2_?C&$x4CD2UTQ0x)Q?65jGs
ztRmvh>jHO-8&ZIosgtHVOgk={ysWBA%N%29(7R32OsPfE#Hp}dCFCA5tv9LyRN1A{
z*BVa7S0?i<<xeD1HIrOW7tR+eoZcxiV>Qkxob{hLM=jJ;OxkV6wQvS3u(2v_7sU<w
zgi~#(C}k}~HDdEZJ><yI4|q)EXWi3`!PDBSxFRi2a7-(rENxX0YIA@VEu5lTJ<%_r
zI{?7Mg+hUKiL8JmnH7Me6B10QAR4*<0Ht650F;0GGZU;=`Az=-`B(n{<T9HtV)k@q
z%%{>E_A4)BhVBqW6qgh2G&9bxP|Y^_D@7$^>bbwu7FO5;mTFG;wxojesWuvvq=Hp%
zL;8m!7E@LH-e_0ujiRa=yh=#MR)OP~FsW#K{qevQfPD6vmNJ@B!_BQ;ln{81<V%eq
z#ZhS<2|Rv@dNXQuQt>MiM=+%ytP-*G@PTcFp+zN(1ng>5f;@ATJdTU6xzS2Ns*q|k
z3vA{2!6zG4LRmtq#VS&Ne5vGzj>j(t5-_ba`lQmZEx1)wD%7fns6T%7l{|^ku8s<Z
zSVkVDKA)ls0tpyY>m@niClLGPL=PKL096G(DKvm>w@R@E;_^`Zrjl&Y(Cj#@Ux?y|
z5TcV$x;0zQqa`$oAD)I?rP-kO-b#C=A!F+#;XYV)F@b%-mIkTymx$BIgOqJLrkYqH
z<tbhsNgg<<_eRX)QUZk*H^}4s^AlT5Gq1YZbia3bS+?4h)Tp6j+BbvcrQ9ThD0K9w
zOLU!6uf;@F8E?Gvh(P+(T1VYlM5th*Qc5e9H7A&#Dj9krZmxx3A=F|+%sijfs!!2b
z0^FdbXk;F$XeB59%11#u{4^9BDJK$fWm>2u!A}T)<DL8|ZPCRcMYj{|CPS)`DpTbn
zma$K&O)~H_%gRem7Xb=kNa_{p{HSAM>K(mGLQu4vX)3QBln<I|5T&t-sdS`{7_c9r
zlrWTDqlShAj7f5vCDEVKKYT!Q6$)HZI+eB*m3<V10Y$KJIj0BegN#hsUUYE-^gF+C
zth(A80ya#iE=vcYp-Dc`7w--xp-+c@QE5t7<daO`4SkKCv~dR$Wk@4~ZW@30RvqUW
zT7DyHLVri^Bt<qw)d$`mY*!XP)jqGgBMRM{CA>hKKPu8|_Z_4SLuA|Q7Rpu!5~j}8
zDel7})RD6)@hQ*ffpnW4F0u8Kp2X!F3vktU0RI5QpP=pRjiIW$JSb^N$b;fPd}szU
zLxHe2DN#U`6IFI2w)WsuVn3=CGFu5w97%9~xS{e26pEzSKuVCRhg3gRU?_Vc{ti{d
z+J_%feTG3(t2RoHeX0%$Z2j~xYD1I-7!}lmLSUiLr8vrzgohbd3OX>K`=Hm!Sfaoq
z*rFt>(IWL7HrRo{)?ikxxnH10rJGzqLDjNH%#|s+k7SxG{fUyz{5E!nou=5+wNwB;
zQJT?<=I188)6GyPJ|Gbrv6^aCpV0KWq?+>S)QpeO8Dd*`6(}U|B${{wyw=%GM!Hj{
zUrU)1gW#c<jgpX6lBv?PApJ92Wser^=vvatoz)7ao8+PNDzPg?XjXwvsmOiPR{qS^
zbh5)MzRT!$;Pb65iTdeI1$zo<9MNf4aMeCDSo3mY+bYJov6lxHeerbZuC9Ln0PNbt
zg&Rj+VO#+`#QppyLY{g~E$jFAPWb!YN#07}^X2R~ugh$DI#&mC*u84qWHuYP1EDED
zL7nj^btb44=&`qvp3FV(9q+jD?cvYZa^rt4tKFxW+-cg4k)_3>?RelNKS-XE5Q@=B
zB{ZR>93MifK8`%NXWGZlmd}gk<;BT|d~4|3WqFcZPhZ@A`RG@jozU-z=2|j;TbIgL
z(uz-{@MG>daqX3Sy80P=emuM591;~e>z}ioJwqL>)7Je0sOmoY8T1}JJ^pj%n|$}P
zFJXo4bmki-TU>T0R=4~YZLY^eD+2z5J+D3=+8kHr-Y*l;$^D<pkIVU$=rFG7+J&B1
z7LT{%hY<Qi^f8Y=7Jn{L!K}D>aPNgnW+kNpXGGftI7Ea^Bq%COgvyAb2?>{?B9sim
zR7EPXB?KrcBtUghLb8djQWS(`7?n<Zi^%DMV$vrfx<V$i0|=sIKn+<HfC{WgFbGv*
zYXGHICa?ijiL59TB5NQCCPiQZfr+dDRbp!Z6%$wjrm`ytL1Uob@?BNBlmcD!lkzX9
z=w)bGNd-9&Y7E{NbH$zMFU4JB3JJuUmA7&}RU}}!9#q`M8eQ`@XhVx3E;f7W`TWGX
z@m={(@Ll<K>HL|Sofgfy$`Y4t?vgPa7|l@NKT*W&e9UNzhd{y*&B$8GS#_{Eh|Yl}
zG@|+$e|Bc&TQ2(Iw$F~1X>s+cg}Ym$)Gq-Zblk=-+n``mc8@3K6m!0h1@R-sXwx^R
z#xD2kv%^-_Ld6oQl7z1aLF<cpct95jY+zDSp-%GCjTHK)ueMIIuT#7xy+pWA!9i7n
zw+LE@3Vp+X9t8~wVyW6C<l9|-)pYq@5kTVK<fWQ!8EHIEUF6HB;+OA|<JSDrYv5zK
z^5Tn*d!-ho<s`P=H=9CIlAo*0R|Kc(jN(-LD-8>KORJFPK|vT8Xb<%tQSZ1<3aTvp
z6Sryl`z+Mm{);8`vS``9Q_XW4X5rGJQmc}1qr1KoZ4~yB3b~7U)F7&f3VgS3UL`0L
zG#w+S;A;K{S={p9q1K&v(pHvnA!KX;p&n<fV%qffE=q0jyr%MT+$1%K{Z1tK)>)G}
z>(MgBW$D+WqG1T;sWl4@(!TQPQk$lI-1a;Ktg*ec4yPMnuMo{jB!zg74d&<UnCsP?
zuTI^*3zq#4km?p+Qz%{2LC#aWx;24A>J7}xzhU;ShMtTrB}nJqEMaLCH27d-Ro8f3
z&e+2Gb<;9k%az~47UO1$aV!IubUfuyk>UE|j8I8&_mJB-oMa#)os)0X6;jfjfK6&l
z&0ml6YafQwa!L2U&?npH@~+>xahC0yrWApJ^>j*j^ondC+qPWqxE7?hhcp#e)Y?u|
z8%bwPuTR9@zbu=#`<Cy0J9?NKQL8u3DRHDFL|{;%O*pI0Ils7hPuU>>+PvvOX`}*!
zPg0&;CVYIB@5@bZ$D=sSV`-C!)9gShPA-6Mv*jh*cP}+HvX=0+(Kzl&1vzj}45a+H
zmU(6NU(HrsVZV=|q19X}T7A*BTlq;9QT9hqrrOIAT1pAx;`99a^pneei@6UExz_hq
zuJM(t;x;MzsUj&X>Kc=(45tbP?kON7d1WU4$6SpT$Wj+$j3^?UXm){m(%#8O-X2qn
z=$)gXttRQRZ_saXdz&s}8}yCQaQiDRFo%#lNvEHT$1e=z?cJ@{quYDTxVzoQ4N9if
zEj30IdCj=rN{MZKaj5EUwx?E#H^FqnPZ{USgFJi3rtZFu9{Z0u(!PAwE^#&*gMh6J
zI<PY&13H7Rv0zZeTX9YbC^Q8Vl=A&7{tr&%==vAj@$bBR?OS%_g5OJ&?<9^HiG8Xg
zPJQH-kgjRXSX14niJnbZ@6E?7+<hM@l<4w%etV78RomQM4b)@wSs;nQY}3|bmcSQJ
z9HEV{L5;F?P(9`JoT0gB@Rw+LRG>Qj<B6qABAsm<M5Lw7GMi^~M_kdp_&P&@UF7&o
z?b6o4LLBaV$gWZ2skWrtW^?b8$4pt{ccXT!F(eb6Vy&-I*Ky6b8I5hNY3P}0&m8yM
z>dMuW48VyuEmEOl>5^i<gQi(p&yo5N*iBPN#W%qy$iTfxo+s;d07{3o5>7^4r95i+
zL+5VNl0{`nQ_HG}-VqJ#>g!S?B<C37Aorz2nC+-LMaNZ%W(hYr&=K_SCsoy}(LAx9
zs|J>ojuNrk+$7OeAQEZ9oFYZX46W>z=`-iz#&=pfc!t5uN;KZC;IggI<}g9a4LF#Q
z*A6XrOP-!?e|6>Z_By@Q=$90OP=Qhg{$6pQwkl8!r73N7bg1Uzibx?qcvESNcx`u%
zyq@bEeO@fBrwDoC*mM+>oGxQle9(4490)vMte0-%eBoBxAhudo>;#`y9;!P@haARs
z{{UwC{=Hk}=e(D@pFwThEvn!&>Uo^dx0u2LSt}VV%o}YXOHfNC)g=yGb*G>#c*(E)
z{8#m($qrjVa-_Ph^2J|2=&G61^<<%B;TTiTQdET6lihhDgC1NdFY8|vD3q4cwSbi`
z3h)&ofIN}`E?0E~{`o9ewAnx^Q-z#rWocJ&CCXxNEQ(Q1GW7j=AF6dIoa&S>8d+oz
z620o#s5plOD2$}m-Gx5x1*tgO=A;Z^cvC>8(sBSEA_QKdG+kKbmXcg0MTRjD5QLhH
zXMXU`WxCoBF*>yK4i>HgM=+D#DcdB0lzy#0Rsf1!N=q#$g{+YJm5U41?;Ho@MK^+5
zjXLNFbRlYNrr4oW4<uKZDX>vcB0k@(AThhMC@vJK+j^)t^B|$p@F6ACfx^40Lx82e
zVh6jeHq;H&VPq*rs8Hfu;VJt3RR^`e+M4GfDOu-ot`L7`ZJb%vUtNDO>jBD3%)ZS+
zt<`Rpmu3`b!-^$pIJc<=06K8v?;&ZjQzV3!JK;9UHBWr+&iO=S>KbvT?A~`09(}uu
zPN}!INC`uSdQ=_bXX?ZI!_=%PA){M<Z!z3?{6>O^Qvp0F#t9BvI`SWN)v)WRcHy;d
zg!jl=5;zhC41eSO&cBbK9D)V7S}u^h2}^A{gnULhh!|Q|?}<~qvvBdkDCawr%|0?#
zkPwPfbc#pn{{X4_`~r@*t-*1JEmG;_A;d5b!MrI~e5dt-s$)B)Vz((ptGE)=K{Qv#
zw?RJ@NLKa5T8RC9&)hm4IICw#Z5IKj(tYK16;;1<Rg^2P9uc~I)oVyYxYCxz(=4C@
z`kTW~j7X}9;~)4x@IoG`t9BBS;bl!A^Vn^%@m*58$zu@tinCH<L^#TnLnNb^wZ3{<
zID%?WNcAXecC2)t%KreVf7|go(tVB`y0>kBQu{20Hnmrm@lv-(ddv<K27{zx<;ALP
zi<awm3vIb_;}<DNx^Zf*7f^8KQ@D@U`=76}hwduX`(cjpo2HT*ZI5|DE48~tC@3?;
zIFq@Jec|hSblfF2t5Vbrp-2uY;^z%qUD9}A%oCKq`RVHu^{=venwIO(ckV6j`7N}v
z@I#5l=L?0Ah^ZC%Q}ZT61-plk2w*7+W{tJoWyQFPDNT`>AQN2Uf3Jbx{Z6p#MZK>%
zT>J$*^r=cv0}AM_>HzAfblM@SL?Z)&g`&tp%}TL@%}<X4A}?Rp@+eA*Q0k8;w$q_C
zQc339xk{yft4<_CrN;{HRO3PArjD|Z08`8#^w*U#->jeE{TKE4Q~S@r<4$2{P82Q0
zv~jF9;7M_ZmGcGA93<yRP_|xR27`#kx`ZC;+jS=-6%EtEBK`?Nn_IysdB+y4Dr`Db
z0VxUfJkqI{PZ)+AQo>3_FuFlyXV3^d)=plR2c-3n*ZUi%MVb{YhCp3HK;|r!j_u1X
zoH)%miq;J-u(tW>Qj`cS<0BFqw#EXQQg#?Rfgi8H>-zYn*I&2#r<ZD#I?bI)w_06F
zDTPg^2|UI}%-K09JY=fXCCg>1s`zfTZloxOlY~~49;DMS4@o_LT~}Z4@IMoM({$Sx
z7RySR#1`XJC>RKFMx|-!MKerA_bp7g9eB~Q%7d+*@F3*s(mr5&s_-y=AFr}{to#zR
zd<Ke>@shBTr6&m`K9&1LLF-s6r(b5?;_sZBggTTdNLFE`gOiQ%BA%hb1pY@&>qQ4G
z+PhOLDkRbNQbC|m$w*SG)Pg!mFEkxPYVRfH(Ccm|yw7_gl@pj1q24|x>+ZVTPNuIk
zg}8<0htl|Qg$(dIaw#W`Q?w{bTtm%aDS5iQ;t1{%)?sN^0!IlyU$UugfLp`fk{h@#
zrInPeDG5qkaapZ9dXv0n%iieQg&~IuUH6o-zsAD%bx$OUR41f<zXVTDfqID2alEW=
zVpw#V{{Z5&eJW3i4oZ!fbQctg6qc2VCxV(;^$wlvh?6_0na#`k{hd9wK75$N+vW86
zW%S#tu}T9e9uc0L`7Da72=Sb^vda218H|!A*2i5Ft2&laPYBmqzhOz`Acb`^8Lg4q
zkE@nEl|`uBrPZ2Ebkj#LGn}t>^2Z%LQt87UT()L0gIMJZ)ia+}vEOpJ%*`HoNfjI-
zpJ1tBBZ-+^H(B$GKF+Z9>cW&x5iNT)YL+e2<s5T$zB!{kX`HW;#ViKVM2P7KK}_1S
zCsezYS#yagR9>j0p(+X9XUQ{f!d1hz>zCE<TxsF~jdg^rR|@l(%PM%<);MFM>PZdV
zzHxkH3wolmFNvubyq#H_wd0{N2xNx@i>9j=ko67~5i@j3bCN8JmD8Qc)##3d+9S#_
z&@~2@j$R>AH;+h@qk7$E9GB>H9phelQ^s!^&f2&x_9gKc4I^i+d4mX>&5La?=}Tl)
zY7Fy|vUU}V)^1v~v{quI874ce;fd~fCOAC4@19<pa#z<5Gjv(unL+XBVl{Mg9c9EC
z;@FQKGg4{~KPGo9t2MdLA(FMYNnSu#)8!L!ZUwt*aFC=CPK2His3G?`HpvMc<(&Tj
zc`%nY<yK_VI#<MaL<$C=qJ*g*)YJFLw{62`Q<Zq0up!k6tLRIcDJr2I4Pe&emiCW0
z(s_$P7{=i>IjHz?fCPO5;k!_hor&YrMX<|Prro!d%YP3!2v%(^U}l1RVCnmRcyFP-
z^R5P3QwT385TFLiMRQ0!M6gAvVU?RSHtR}JE?X$nk_g4fSE&k4^pEZ|3dWdK+S7E0
z)Ywe|)$=5d4=0Li^GjQM21{Y~NhwxDIhHX)R^1fbe5OBd*V%L%A*K^{vf44W<76#i
z0}9o(TxY6j>Jq`G3JVx$u23e5{*b{|!lOP~_LKGh0F(9hr(lIN+t$uA?|$t1!b2CV
zWRgLy6@67?LZe@NVV`(H+fyI~DaIA^EB^oy68^M*KTG}uhV}OoR@DuSo);D!s&FZ4
z0<JGE@f!osiOt?>Cs4b?bPIeLC(xw+zYi$=L$~Ys9TR^8%{|4mwFaG2sc;ge-Q6ly
z%Wl0k5jG*z3<0rp)qM)?zK!!~d_dqJ+V>WAXjN?6Q+S9=rEZ^xbQY|FK^YvRF>srA
z8gZv?E-i`pyu=52N1-FUmGF<(*fyVu)%u1ut;5Po=t4(1!9`PmE9xN9{jK7bo?@Ix
zR?1B&(=(VoC4`AeadH&hs5dKH#8dHUg?%VCjCBKnX>FkE!2>Yz>Vf4RfI=^B&}|)B
z6p#%Qg#ZON#O<(^`u)kbu)+gvmsRONrwz{&Eb7+|JEvxOZ;W&I*IxH{>g!Ql39m%)
zfO7+R@Z&n+j<IRWlP%?0w1ud1XoI%qN)pn*Dax=E5oqqESm-}|OSH<TA+YNKK@g`7
zSp?IM=3+{#KtZiG{DhPuij|sI2v-j{GU-Yvk={T3qryNAn+pi;qy;PJNR8XMQd<E#
zozH}erPU=rLya_w6x4x{@&3C;3w_kLT(db2Bz2K`E|X#<*GW(Upzq=)ZQp=!&|=*E
zQPM$rgOw!>j#=+)qxF0s(i=lHQoE$*)W8R9GzFnrlm&M2jj@asB=W|?@_|t3TRm_A
zLHKA9Oum#L3hp-Z;UQFoqnF8`6j=VXiMAt~-y6wRtRc3p<`lM-7}K^FXlmh<jHfO}
z<{n#h<8sTF!$gH;l&)_4Q+dNq*NNzG$Di)93nDU2@as6~*XcWL&+4oa^ky$dgyrJt
z^xb@%{-jt3fsB)MlR0X-cvoL1Ih;Pm3~HB$)||BI;_J6Lk<~$fOTIIkelDAgc@Kmb
zE_BY<#kOWb6w{1HHnMGWx=oZ#1WqvqmZhl*F(E<#g%ennC`1Zv1x6(JN+R@5Aa@Z2
z(o~GCD5VF4PANuox^6-YQfV&JY2wz1HlV`G<eOu~vt?SxGWjDOE$Gvbp&igoZJn{L
zH>hfHfwXj_CX%GAHDQXDpmvT_!c{e-+a62eYwrpiX$-3{W$}lSOxM5;db-6f%cOX(
zk>|AVLLNxo4R(tXSi4^->d%ch7b&D^%6SJW$>O_>ZH;9PiqPi>+$m#mCs?iYXLMl7
zRA71J88*H#uNHi)It`^Gc-&l9jLz#`E$N>zR<fQE0cBf>A*Hs&-qMFuOq8huaY)n_
zWoa~r$98Ad*-Zh6Nz}cUD=CA(0%W|AnXKuLWW~!PDF8K@Mr>q4q>l6=DF7IBHYH0_
zt6Cuq!-m9dHq4D_4W^Kx5mRQDOpz24VGS!JMTE+Ur6IxGif~Z|SYnw@i<f0(*Q#r;
zSGIQJ>~Z#a`8%&CaHJWbfif!q2-m7ZC%h!3?695BS#GI>w)9SU-l?0e5pe8|R4@WI
z$)<u0L(*$(rkVsIkl1Fn%MEBO;b|%|)__>7B9k<mWpr*^N#P1nF6wQaMuOxZ!zD9b
zb(VZ(Xc1@zan8w_^Qj{~3q;e965yK6e-ur1Mr74rS3zs&5f+N7M5v<1*LfDkR0V@)
zD3;ZfzJ%<GD3A;qK&r@qHk!zl6*ij4gFtVq{{V#QALTATvobYf{{TwA{{Sg*{{SJB
zDSI!PaH%w+ciBZkzkHl7pdUp%v!vjgdQ?QLkxbkDDlH#PB0`Xq=Sp>^NBB#k5`(1*
zDd0R%tdFt*A-%`kOwE<OZDnV69cC$2sa_PMZkLt?YP9~SqJjEm7UI%Mcphvh1yNof
z-x-&bPo!6lDLNMw>br-5*2yUqLHTg25T}uhm4cO0R1XCwar8{|+W3agLeq+vkzT48
zOm5A^MFR2oELZ6=E|oTQjG$JHli;tu0SasqO4$ec@R4-A(ox%50<jgStM!3D-AR!0
z3TPIC;0QGGu5ubtDQ(rNib@q-l+nVkqDW8zlr=m@@!=bxbQIHTsY|b^x_pbSe%Pd}
zgkc0PpjUhEGQ>Y%K+=#w#GsxZGCjOxGoJ0ZpZ3+4&}Ae-mX%ahDM|fwcM0}IHqh@?
zRU3+cg%7%2kqb*@;9N~s2pgr=@*nXE8qG`~W=%%!CZKr{01WGmD0f29#}jU1ANH!I
zH&zh5B(SROj;L3VP$Djnn^Dzsg()KohiW90ugt-y6r%}f5yqqx{{Y?U`{QA){g=O~
zN=?1Rz*~Ug383brfILA>KKTfBVu=ZHK4+SN<`q-)7)_m_;yWpAE`Bq}90njzevt)?
z;_q^N+Zq1=*sA9&O`H1~_#7x9N+6^>I8g}%{USC}jY6=u-QZB9D2S<PHn4P|u~4Ks
z(BX=>fBR`jl)sFEDvu`=0)2$g{Slxvk&U%?UqaFKSDieL@(S8`DJv|jkC{l%=}jOz
z`Y%yA$^c?%w*cZ2l~d^zf<s7JaL|Fovf(8A59KAHB8(kL%y)j8Ox>+0InPl2bbZzS
zFljV-H^6WVOTkRRNyF^~WfrRiHlU=H3h#wNo@F~hVc3}?oE6+djoh#GRm)vJBlJmI
zMLUL^@Nuw{>{4iBX`)ZrV=RINRJPU8(NDZ(Nh#%oZln%{T-5&n+N#h-!9r6DszS3t
zHTvlOFvTM*7;FCk#-fj;9_jJQ1YMy)N=K;E>nHe0Q-B=OM^#|sPYjRI2GG@J`II0f
zD(FJLG@6RRDe96Fhwcjc3?{{maQmR(QdH(!1f?H+Gl&l26k1w8q}>nG7N=5Uwdl<y
zw0Dw}vZK0GO;5J8F-u!`FkqqT5|V-KBPmf7u3;vN1Oc!hDL+jj6q+F_#8XfFHDbm8
z01p{zB#Q<>VM$O>ZEHIq3?z9G09tq)X$d2vsVF~6X|!}ssnvH5Kxn7brkC|x?<DzF
z1tG@Mi9y8$bVzk0=<fmTm!c<Cv}10sS1qS{;50A_aV^nY)TgBdfBQ{Hmr2<r{g=O?
zcP)mfq?NQ!$)9`aBt)j*+-#QDL75~2^eVLWOH+F%Q(h@&n6rx!2Z&MzP^f(&umVBw
z04XErgJr4W6&)&4iX2sbqPFp*BA!UuDe*a_Uda}<5<o+UB!IF`#4jZe0yc!I9c<uM
zRnHo89^Ntybxyvat@JVm5)gW%W$lpVxGAELvOFk#xs0ViZ+t?x3Sa9a)&<K%VD2eN
zR|AkE*+@2;Q7Xdg@o@gDg#FpZr8f+Zh~GGMrA>X5B3&DY>>LFJf|Ve7&>x~PZNmLP
zJe8+{9HAaL?<SX|3Vx>>LPBvGosm<Ym{mlsH%bJD-ciA_%0+(R_sQ0Mn(6Q?l{%a~
zr`X)rooLN|z6=NHMKg^}-O7klE;yhzN|Fjy;Bt(8&o>{-o&INxXD@BTpL}CoeHne4
zvtA<8uQAXXIG^M9!?%9*0+(!rtL6lpyhlmf5A9A&er#oMxJL~C0JAvq`E8Fx$idFe
z-?y7eYT$mU!mpsqHt%im;eFM&U4ch;{_0O=AKHH3F8jsdyn1+Z{>=9n{JP2SnJHYf
zy0^*JTt}G7bU`h;oQYa^VO4+oO-J26rXJ&mljY7=%96|Qe6096xc+QxeOo2&=I21}
zmuqpF(uJQcTE3J}eKYJ!A1@Dc&&S(4{NEw;^Y*+Po$#NGbJE)9vtKh@)C1(``-NxJ
zczFK+w6mW+GQMNm$^Dy!`7*QdRRbO`LDUd?fiCzY(O*HH_n!~#4h*~R7m44K`#+x^
z-<$9@te0)>Sg3WE5l*Qyy<&6m=i4b<8oXSXeAw7QF(lSZ%mHjHlhf};urN(xXF68m
z!sJK-YZF*OQcQ}<AezM108M08R05(a02Nr60IX3k0ab~D(gju~5DKh`Kuuywf<;LK
z&JYSGC_8_6)E?y7wq8|eNc5-7%Eu=zJaeeHVV5P;E_FILWLvSeOZTZu&m71;l=%s(
zbn)|hob$adqCI?E7-2fi)fSPb>h}+%+FLy6Cp?Hr9wv2nddt>q@|X!}AXB<1K7l<~
z+;Q>uuMRleuU*%kaOan3_2p#rRJt6oadxkV?cN!lS<GefS0Xyb`i;}KYARaEUj^<*
zwtXBqapaqo=Hb6jv&WVhVS2lA{&CuIYjrMB_XQ|k_mGE=hbRgeUfRODst%P`ycxn*
z{{V3XS^3XgXAHcfh3W7znp`2(l5j0)HQiaD_$V6Z;~H7I&MrW%)lzN>TT(#iawPf9
zrqJu${V5JDD>gQcC}gKe?jU_^1kk8(jEYUe#lobd55oyv5NX7O(xytf?y~*#o7ZKt
z&*~=G)rZ?@2}nh#aN$DSKRb=5GlY6U$~Lok=V+!Cq_U)vlqF56*9xhc)rm(w9VTtM
z_%5qc9Cz{frsv#M+cie+uU+OV2y8uY3FkS{h6NG@c2y+v?U0oF)yclSB!t_tl%%Ji
z2Qu0}StJ=G*M6n5@mqJ&CtKU3EW8<UDQzLO;0GGOQ>91bZJ;pM*-;lumm3c_)xEfE
z5|-_TCrZAeo>fhFsZ##N&mH$ByF(|NcG}{d(CdQ{Z3i2|zdFvy@e$iWg40S`7-bH<
z@f|BTR^j;t2zBKSJ?u5%B~udjMUJj5k;{3okdZ)XR8;XP87W>cHyUfJxm#&$BC0%;
zwyLUwbr5P3UXe0QZ?Auf*ltL&ZvA(}B`xB&BbNKiaY5`o8vu;Gl9{{BLe1`1!fCqU
z4*J*QoV&Fq&lx)U`Y%P&jlHwX+My3&!QFL4hTG4&pVI3QZG5GBxJ})w$U!CaIEtF^
zDW}Y0>RoANzJ%SD-F^vV{0>xHManJP4jPJFz6s^Ah#Dm$$E+8<@~|fI@su87oo?7+
ztK^>I6p@%pch55y;S=%y0CT=RSN5M0$^QUZ>D=7fBS_PnQ%Z5#6)ChRlBKCjIMl56
z`jNulYn^#jd&Syqkm6WM0YaQnBmtJm=_Q^!^<Q7)zFv7xMAg<lkk;QzRokh4=_+la
zl&_LbeNHbL@RlInIb@RSEeoR3aRNphYv8Ze9VEvKde-{fbhkZCPONm9cj&3sHCOO6
zZ=y7ZPc$~~)oC;pKgK$<)2;Mo-fe3Naaf&w&;=7*@cTBI%P&k;W8)jg3*RKmKRr`b
zY4%!kE4{uU<$y>BFjvtdkBn=5Y`d2ib#S$Nn+PtUn$V~cevjTJbtK&^-tFvlw^A>Z
z=_hkLo0l&vmvZ{kZEh5M;9*GvWTUT)tL+x7&aj4USsbftcJV2+<ep_KLHSAFucBp_
zmu2ZX81Eka>8q%JSb4<SElgRpQse40tY-IUTpD^Tn{6$&eM%V@bI!6|-p7|sF7#Q|
zJnJ?Rv|Fi5T1IPD>Y&_8u5!wqQ6s#Ngi@Pzlc5CcbTwT=zC*cZ^jCP@vz`i76ac7?
z%g#4i!;aNsE>4HGTGh*GN)_L(#P1snDN<8PsdWSOK>hQUTp4F~9;|VZ>Eicz;WeAZ
zmR6rHRCU_n%#G>7G(bvJP+d|;%%L886UKPI%X0i4?LM6MoErJ#<?fXI`{5X?msmCK
z0+Y6BDj6KOjuXQ@w<p2weM|2+H}gJVPF%jVP^g3B7Ey>(5>?)+mEm3;Cx-Clk9hWF
zjLXsWG3VpYwU3*Qd0}@cY!_*o%$x{8Ku$dAi-=6|Z%<BM-wWvaR(U))`_5VFl7sc~
zfKt=maY|4DcrfuMv&-c4&u@hEdwd={?>TR&X(??-8-$LPjUG`^P7XCHuHbM_wt44Y
zN2YOOJs!-udb~Mv@?TYh+P$)E%MI=`C#0zOL>efo5hYagihRBxnZw54N219duc<N1
zeorTrr%KgA2*{d>#wVNKT4<uQ`cA-(1KBuz9ILb0edZD4?y(xW)U>t%sZK9su1yN4
z2?Z&k{aWyxK8M}gPha`z=^kC4D)sx6q=CAYl@20+(EChkl&KA=2~{{HN3T;k<L&W|
zuKD}i?{1GdEnT>-@Wir0g2hTo2s}J#7t2c9!n`QPFqH~t`rc+q$Bgt{w|&PY?`s7#
zvZNkb+;56ht^AeY6x&Kt134*Zpioy7aG~oO(Y3i->Y5!6D*&p4Dpv|*pf@AVB^5vl
zaV4QzA!odzeyANF2y<wvriocwMRaPFs#FGf*0k`6V3czd$wz-Gs0=MD$b7~P{=Olo
z%2R4vhnm`)R!dL?C@My11lFE#p}a^T<TettsV+1y<^KT6a;;_TpRe{sI75k2R*=>u
zg4(Xas;1T5rCZLK4v=bLk}Ytl!^ueHcd(`Mav?x&5;M+TpXhb{dLoXDC{X1jCB9ml
zW%J&3psJOe^9kS}2_p$hhJ>lN9yCeFf`o+9m}*EQ2>ny_r2JIjg<xf~Xzg0Srr1aa
z;^*-(*NHnAlBZW|bTVb&q%@L@Cz5CnH6odUJyd}Lk#lyWxynMV94rL39yM(^6lxV+
zvG9rol9r0dx(_4*-uTNSzUbm=cuW1~^8uN==dGo8E!3t|l{DzdJik+of_`IKQ-m0{
zalqr8*4Fr`wNjEfcHF=)rQRZgfiQlr+ypAODK37_n`crfPg69?sN#~fRKa0zW)W=i
zjs#vWX3~U$Ijw`00;?MSzs&tWDdT_-giFl?B}}Dta^O?pxU<ncCJm`gFTRv1w53UP
zAtvJCHL6I;oVpqxC_i6-6>3TlwFeqoVB@%a8Wp^i9^%0Isi5{nKG!D-63w%YCbuj%
zZg977<DRD7;7WM-zyd6#X#|##)29G&VudU(G~nU|c*t$FH0M0F)13QMq2?Yv)VMtj
zHa<`z_4}QJxk1*DTMAPN$L|fck_yPequxz+sNOeQ?6%^cBr@Y}C*FI2w9<&8(AcLD
z9RT|Zmu!~t<Se5e9$7V`h;1ON0k5cSGhwH_*f8U6p{t;_m4zYfD*)u0dMI<Cg#Kj{
z?^eN-yGKe~N4>PxG97(IM-yO<1BzxsTx}~-Rj2ctb>`9vLYrkvB&7cU$68Wf$M8R?
zqxlbV<0(%(1Y3n63Pa7OzO039g1FOY&1JO<cG4Va#4x3sb<j53+2X)Y8prqkyOi$^
zqAKN2EG0@IOXex08YQGOl@g|%r7Mf6fD1|%TPz~rJwbL&F|bywlHEG-kJtOdf9!q)
zg(Bs<wpO$j+;vvTN^#XL*`Xe^g&$C+X$G~B+ss^``?bRhEfq2xeW6nOLW5v3NE;pF
zx9hpN`uHk!qq<x{=UbE^Eh$c8WMrmSlZhjXxtvtm1g#CFqNdQwTzK2I`hN?U?tJ8+
z?~c1|oOHea0AK8Wzu4>jPU}W*Q>V7yeY7x^mbMt>gLa1y*#XY9QnMZsw59dDmlZ~y
zQ>t+fDM4eJgb*#LLGBa4OZ@);x~KQg@c5nAqTfupxEAgAz2U&#X<Z0;X>b+bJEsV#
zF@kOpZER2)O}pn#dgv$|X>Her7ZL|kQbe<_>#@J|LrZIdf}_bp%eN&>KXHijEx}1r
zd$rjFZ_+hkcMjoo7cDs1VV1eAsR>Kg^rF=2NcEuoG3)*x6ZQL(?p;NiNNFu0WVjpv
zC1|gB5-^o#lDuVaIrna!xKrN=(9=$|90^MZZD}0A(67Q?kv~v3Cq<V!-Pe?Yg(NKj
zwK}Sf@^eUDc~YCo>vvtnY}s*3_}2im>VlN(C_;!Nk^ca18B@3Gv7>&l@#}+Ry5nqf
zXdVcz6aqqVgzRfv@`<=tJ+>|^)YyH8jwY^KPkjX8cGX6l0jgEuE$RLUcmDtc8EJV}
zE(F}DildUYNW$NA;dBGCNy$Tuo3G{9OeMC^oEHtP9m9oevYhf#X_6KOM>zd;{!8il
z?z{UW+`UUnt@nl&%fm9!7*_B;s*2EptTCx=<t+-v+l?p$(O=Rn-a!~JujWGORac~b
zxA0E0_0pYxZ{)j!w3ML%C=|@P8z{z<1Kn{ZyajfNMlckD7BW+=2HXiysG{qJf{5;}
zoMjN(1R=(-wg_!tr3wgE9%2qG#d1jL79O}{xTL8=8;qyEL2dTPH7Tc|N)Ud(1F_I6
zn}s&xiT8ql>p=<%9mjGZK`S}b?YvF$t)5^qw%jc(#e_CSXh;>rm2NPc<S*^`nmVg4
z+vF{^yGDyma={>#08LU7t;jnV<@6PylA@QJ4f26B$C0X4wtw9Qm$}%&;~%>%ZPW)G
zZ6=wiDLbSdwa$=>OGPWH@B!Y#N~LNU4EPwKI#cik>&v#5<+ycJMF3dhDe3bZV8yek
zP{o&fnOcll?62K1mNK;79NEd;f*gJP2vNt0N+N`1KsSV20V-367y~yGixmggN>3jt
z&hbY_qYrmycb{PuIfW}7^r<CTZU8hj5cnCym7#70ZiV_)p6O7f2v-`;IdEm@?Webo
z-tqeMc*#h7r1uJFfU-{n9hK!BGK8!mjjSs)1y-#TD|DLV1$Gn9{$D!u$G-di89VLs
ztu|`e;OO+JRL4Q}ddn5txW_7?mElbgX+;5_aFM`pGtd50C#U+o{{a605W{Z-r@B+v
zSpelo%HHCHwvePz6-rg=3Ldn0^#{gzJT4vHj!Y&|_4qll<?Acv`)_fd27BJ(>)!%F
zp_NwmB86*LAEV4qH<NRM%KH8@yUTyHFu2aAS0@lsmC{#gy23+zv=BP@f9o@?x_vtD
z$;l+tc(eC--&J+`Lf%o0pT5FXh-|DR^d@uDe@fS;XSbGn%x9uP02F{#=xX68R>dIK
z>Z`_bvELpk9<L{hlilZ+ZiA-ZI?^wm?pRP#Q=bZNzxPfaH{kU6;`QapjP-agE?IY?
zHKku&oDDW>LUYR~wmU@fZgH)^+E9baR#YyLku!!oS>H#dT|Jre@#FshXNXM`Mz~_|
zIP;50Eh)sYOfD?ei5?Z<Ei8LQX5-0X=L3(Wq;u{v!lwtOpSqKb_V?B3nM?i;PG0lI
z{#TaDGOX^ARGOrv&RUeLn@B!`UL=j=t5ady<Q1j+hQLy;KmPz8*SXy(Pt0qW@ti-)
zyZyhX-Rhs(UuTnA3B<b7D^Ld#TMnx#oFwq^@Q&ZO<*lT15Z5qUr8%arxssQUEQu3@
z;j!EG_&s@h>y&vXXDxQ#rF7-McHP3-1{ah;qH!m=Pcu4a5A6>(bfh7-E-^QR?39Y6
zEN*Cc8Oz60`8vAgozC}i-@(f>p)cH7Q|+mhB-6e-zN$`?v2k^(sl}`=$+iu;Ss+zc
zOUSP=)^gQ!@&2FS>9#i{awgd>DdyJGfwZF&R}>|uJ-?TX={?=HEseNRa3!F!!YH)c
za#j@ZQ6S`?2`QZP-lhKlUyl1V_D@~8+lvRCcFBZ0?x<B3;*^Yh#_P3wdd`V#Gj60f
zoDVXarCKbn2uW%5orNj`b;x*5di~uze`QZEO6Jj~ru7&{F}_=?Va9gCc5UAxX)dm<
z%U8-$+XQmd!}xI3R7q1Wrh_v<keJh2)#>|xqT8c$N-yQ#5yx$o3X(8Cgm)CGfTS%4
zh!vrhuC&Uoi4R*T#oKcnX>>yQYTfFJR|l)vGp|egFYEn;?cG?_xN7+pj$5I2tH2w&
zMM9f&XGPHMO6SHpzPV^yp*J?iDhJ(Q)ZqUBN%T`CC&EwX@L$wA{7ri7*szA4x>Kw=
zf*r$+28n)zVJIWex^LDI$E}#UcI3LXHE<j5DEC`+AL;~b3Z(shABk7sdNsxKOkdiv
z9eJd@%9L4CNmDM+e9NU$vF9uAZjHiSAzqSl8z(Kl;(;~j96x-9UvlYA@}EL^c(W*5
zb;%@GGbnxWyR|4SN@%0Hw5ST8{Hoh942z}vAiAccbp<q}Ixx7RfrHkC3i^r951egp
zYVvu4;VtvA1*J%#OUW6e)9ZC3Xound0Dy_NwRYk3hub6-6k|?kSsP;?E`2F1*kOx>
zJ8R8TF5MvxBsOT53Vx!xjy2vt5Bw0)_JrBly3Npa*O1deG;-O~PFkx(DGJ>+JZqeO
zmMz|S+e?;I<|Yz{l=3j4;5NcQ2M{BA$Lnj=KLDl?b7F@aUAisZQ6)>aT@vzmEomfz
zs(mmTh-4+SsV<bZFe8?taDlK_69GcP-cy|96=FUKp&zY5yk=W%45+ql06YT7r-dsJ
zi9+2~!}lk4>%KtHcvhyds+>iotIn#az>=!1WlF6w+{J4dyrRy`<#mm!PSR=%dr?~<
zYH<wrK|g$~E;#GUaa*lQQTCbFhaF(tnvPuAZzeBV&V?y7R$db=&hJ`4f)Lv9iWx0D
z3bV=pVpIqU%~c1&f?~8Sz;=O9bvO!E=MzEYltPO|Bv*c$NHm2cDQE|WU+cm_bMV`)
z6c4}7MO_7`93qL#4dNeCxpg(5IRV7@$SF`OjVe9t^Zx0ATq!OSMG63(kOVtRZKa?w
z1Nr9#g~a5bkeX#p<P;rjq_ltzEabHFWq{gKLJe_o^ME}IWHU?-468sqV|#TRd3U?U
zwfxKqixi=>oI^9?(l$-SRhM7tWL+w3^(sen#M-F}MMxDH`OMO)$2r?)t9;n#n4Z$M
zo6S~$<T%ao`j}luK7Qvc^37J+CuwbKV{F<+K={j8%PU!x(;P91;m#Zkx(qW<NSf&7
zy2kQ$)+%tP)AFiZ23h)obkt*Y%gVZHd=*HzaBdYX3oPw~P23|MRf)*nvG^Dw@Qvfe
zTCjduZU>b~%4-vJ-+02V#e=lX<7>*bIa$;~FT7xvr_<7@i^l1<OnF?qPLX<^vb{`P
zH?>UTaIV^w-f}p8XtejF8B!m02fPTJd@HwvdOYLJ^(xz%ld`31ZqHf6#oF<`JB|~T
zXNaCPmE!ltanr5iciW8RSYwRSd*eB2yT<LeIm&jWRslCjJIpn3u9ca|1`3G|ws_2~
zm93|iA_c*c4#Z69rlmo7nL!%N>80Bu^9&HInpN5km6$MT#${TS2E+)?2bm)2r1B7y
z^?@!)wb7*V8n7Y58#J~i#;;f)r5RArA;Ne>cco3GTPk^IRLPY#nq47Q$RbLYNp_oO
zO;`%7(s)9J)@#Wa@M}iuv!r!O&3Q4lJR8+AHtr3h-dx_}J7dPT;$T~JN9BNKrkUFv
zTk%$w&y0Rp@DqDuZhE!T#aQD8SS_K_ZdP{Zly1dQv{5p_O$pP<jk$QbX<jYJkBdTY
z$&I=Ax1&_HL~>i2-r3tSHK0-=@X8{kB48tEXe}T_<|RWwp(%sLU|mGnPa!<B2I~8U
zTyIku)XGgJSE9D}CB)sDs(0h;arSWK?s9huM9{#~aDWSE)+980!b{k_mmcKqw6#r9
zBGtr%&RLnqZZnRI5@rr3sF+<=&6VdQEixJnq9_!Y17wjDaLSqsLn0|um1IP;icC&%
zB9$6p3J6*5#5~|gq%4JJDkY(-q9(yuof0h)b#yjIx*}}-JIFT(vA0zW8zzPUbg^k!
zL9ncZu!tQ45S2=aR7n8Bpj1s{QA(^$VLG4&tNs^#{#E|~`3#L&RMPMN0Ls7r03nnq
zdpbbqJ=H79q6L1T{dmtg9-<CH5-NQrXTJq72djI#WhF_AXYjp-Jd@&SP0MZ%K??9W
z7)1K!rcspA&|EiYAcO(qTA#ih{{TeamMq3>szP75396D8)`EsDKAEq{QZv>qBb=2G
z70hnD1VjF$$(9@J(&L*m{7zES3r%WAL&xus*Wt<G6|LQ#qF@`)D2_Ct`b3m^M9s!6
z?7L4^ZuM=i393Ngd)4}2U;KZfV@q1z(sw>$?WL&vMAxD2{S=HE{BLZK^igUSw2Gl2
zNA#&PUXl7Tr=or#X>rE}XhP4`JCAJEzlgsnc8Vk|NFZ|-$UiTsC(64>z4bTdBV{zO
za4V9qtv*<X-<X-d!}?%|Qt5<MvY<HAG4xE=;YA3(q+?1|-b$1>t*=+KNKVU=rb`G=
zcvKMRRW?Jdj9$f3upjED&NiNgl<CLTic!Z!cvhf$4PtIL9?4QBm6qf5%^cC;>iRbO
zp&I@00DREhE6rxPR|j|U`{K0^z)V!Vh+>e7k5Wr7B<2nZ6YWhQY`>$U$`j(HX75yc
zrxHlqVp50ESOkAaU!1!{()tb_T53RYoJtp8xXjO?QtboOMP59RFf9%bsPMwCVe1>c
z>u=0{a_uQG+T+;m7cD4NZQ)mlsrD#9FMn_Dm&!1nHZ@KZ^Dbl#UsZb_HE;LE!;hH!
z=Jy$l>a;c#rnO6nuD~x6e(0w?DDsqN_X1U-p7l|F3r%V5-Z^XcNJh4Xrr0DUB$Sc0
zDr@EpGyedHJm9Ocb^&NxG&pe&tc}N-b}-BQHF=n|GEy3$*H+=8gP;#kZvvC_Qf)tX
zqiAVz^c3Hg4i^_s6<0Cip7EZq_=)y@a_tkxYl+%!npb%#DF=0>!(XDYwYT6#;xnqZ
zxzgNeIi+cE^v@sDxG}PS8|j+po{6hk^f*xqK~QB1%QT-~_sM7G@)Gn<Mo&;%4Ut51
z8CTT=ig`?r$NvC`#^NtkNPAIjR9oTHe6>LP%_|naNta@D5&X$O98J=jsR}=GV|9KL
zk!obRAnfYRD!9l<;ImQx0C(_}pXe*}qi3u<SKzw$ggT1hLy7up?TzezqoNN+bWxTq
zpGF^uihWg(N0xg*wd*h)ibAxu-KblRtEM_A4{q_|c8!qQD%Ybpg^~eMcwuudYE@Zh
z!1>GM&0d$)BB8xIQec&r5a{}p!a(U!kuuG5eo>XxSYm}KRL6<Be5Wz=#Xq^4@{F^k
zDNQ7RP(l0Bewi(P8fLbY7uAqf+PjTZeArDs=(aahbU-Z*jOvxtjhDB!LidYeUg}Q5
zwS>@j+dV>w5*y*<B}A$(DblRgl@1t%K=bj79+NF8DiKs>m8PCqp<ct?`=mYc$ui3u
z(&+VEvBxg*Q_w4&GfsGXTSkq3WCGg1`zRsZ{51K_nERewf9=1;&C4%s!<VL=6<0l&
zwJP`zy4QloF+WJoSvj!so{8@N0Q{qcaK6vsUE+z}&*}}H=Pu*@wRgYmIm_E$#-6F}
zIP&$=&5O&Iw&k9WRqW-Twz#)e7g=?)`pF_%_M7pH^~|xotaIV)@mzApymjX8r861T
zXJ-=kM9~Ng4ssw8BpH(eg-yZ$X^zqWg*b%nL<PhF>RPUw8%B!UM$ponxp>=1D_O!L
zJx}^Cv`rJUH=&XKi=t|Mr??nFYS<jrn5dl(*{}2i=Q(q8<Hs!Zarb{Sd|X*_U$d{Z
z`B$13XY6#Fep@L@RG(4eqvsyCy8W}3e3z2-W!H}kc;`shtY=yw6&>;QPT~{&GvyL2
zU80LuDFH=Ucyx)^y$hPbaO|0;Y8$t3RN@rj1E~50-Zdw8JiD12J$R;89ZHEQHRGSr
z8(n&TuSwgBJthu$$)k|@i~C#D;|&L#`GKxF`IEF`+26%qws)CIn7Q?fmu0gTkG9&;
zLv9tgM|ji2q)VQqevHu&^gXn^3S^~~uQ7#1vxKO9RjBoiv~NPc+?6TRy}xCaoco2+
z)sB~J+n+Pn4r5I?s|hqT<6NOMU+HdtwCss{e(|r}JwJGM!`S(udWXL}k%exykA-NH
zl^RNDitySn?BAzU{W1RlG^Otr{u*4p7GZYjaip!cU&5YKR|~_<70jiykwmERRVpGE
z_||{s75@M#W2FB8L*w`-TRkE1{0<Pe5LDMFGTVTqv?XOu*NUES8jq$a-|0il%hS;@
z?1%d+Z|#F?Rk~M&q@=3i=+!Na&n={aJ*SK&vHl%<{{R={W2fu6>Tdd%=AVMH(f938
zZmrPj8ckHwt0a{Q?i0}PtTKQ4cH8{CX=iocqI%S~uQJ&;Pq%G}UFUBUjBbtlpq-66
zZ7Hw6!5;l1Cqn$+vifxXg#Q2q{hw?b)Gm@Nofd32o6o5@oN);PxR$K{07On>vtQ8e
z{{Y+l(p>df<oT9kHSzl{9*)_L)M@t%UEw^tc8Y@m(rWsuYU;DxaIEFi{shO9-<;pn
zpLai8zh-`&oj<F8_RIEK+;-00)|^pTad$3+FwfL&KkB*GyVI=X(fuOR^cDF{eMW0H
z6{~$$wdr!s>6EIjTsi>UU~RtW_7EpIdHC|&{{SsZ*)`Q*kLs4_Xts}-97`vt&cC`<
z+<H~z`=s2EtK9zpQeD48?go&mgm+U)##TSlkNbo3lY6A@dM)i;3tBfK-7me~BvzaT
zQp)T6Js+SyDc_5Sq_x+N_;JINldhu~{MAhJ;kPi*47-ER@`Anol-K+-7f{dUUj0md
zQQ9sHASSCKiQl?BVH*5q{{TihtnOVU^(igj^^iD~dw22hin;tV<Rz0zo7o6WUQzDR
z90AO$Ezg8oA1~<s=`|@kF7%Wq188_5GzWFkwBKl#Kc+9)`N@`(CZ(k8$x4<=%Znzb
z2pJ_b9AcT-UTXY|X<@RPys)J!0mi2M=%t;#kZgM0{{V1)a~DQUL(n&uff$$G;IKYr
zkxCB%6M6VY{n-^^2ssBZCYhx;MQECw{{X&7+0XY8GgB``hAdL(Qt<#PvC1QA0i9tU
z*`G8204b7{Pf$V>mnsyTN=aDr;17jluklg-(Ek9KKm?^E(N2(5fJ*7LPXIa@C(`$j
zg!lw4O`Ho;XiAi#oCsH>6Z8K7!XZ)qmzVH>3T;6^^ZiLp6jT1O&(qSL5hr&1&+m`d
z;2RE<!zpbJ5mJN<HL8>XkKUp8MLYOO{SgFGe5A2#ZPs27hZ9=7k_`#nB_pp{Bl<Jm
z&&pn(=zI|MjMG?2!(RH7=~<~K^$#2r+7-V_f7<=g)Ajt&J%4hma)e@F)iviSrKfht
z!cf^cr1%JS{Rsa6E`K?H@PDbJ)E{;$b&G|mX00i-G-{Nk3pFY|R-dLF&%?I=0Bv8G
zmJ_x7Q@IIMx$bh`LRNrLY_$SbwNPS0!Q5fmvoHEhkNJgvW|;l2-GBVQ1tLpVs6cH4
z1-VWZ+}Z1Ai7HuF5Y1!Pf1<zt02kz`I)AC_e`GKCn=(+>yt-Pe4z!zxE)cSi`|Woy
zQofT(1OEV~8~qi3Xl38W{mb*yss8|S(4J#&^BzYjZ6U`k)F|66EECH@lT1p*nTS8p
zuD{B$`{Tds)SdqTbNko+-@7SS4YJc1u_XygjoLs3OxG(^3RbvC@rrl)3qPcf`4b&K
zU(G#g1@aQMIcafL?A$z{!E7FLDnTm5c#4ypU;1``=3kfmJD(rGUqBMKT~cbkW7jO8
zG~&iU+maNz4@orRHNWF&f9+m>&ZzxVzxG8(JY0}cw7vu7($*StQbiP3)FnXDH_^Wk
zf3WBFu0`m%_WkGbMZUj@%VnguWb-Kj<Rw=n<kWInQi$b|T*w;;i(lxA{{SLC=Q0<(
z{7}E*gdnBMgf!r2u<Dff!HG^aTuE_2{MqFc-}sKZ{#`$mey8GkPsCf=e&jmpfN8tM
z^ImZZyj2N2vBMP)p+h<dEkpcB{{ZC){{WU=pWu8y6#hq~{7x-OSPeen99vCXsiNgd
z6iSbEf2@@7JtCg}00wjX%0D3|Pw~-vombQb-L-9-l_40%In`hohBq8h30SG|tOGxQ
zzxP`F#JxY${Sx{oRi33^d-InTBbepF(RF}|QKpiQO#r1*2Ie_W^wfX8=lrHRe%;g3
zeg{MZUtco)+g8kD4Y*drt5Ks4fr)Cuqn{dei(~O`{{Y^5`!!3ykMH;<U*QdJxRHG5
zO}HSXrQAHHA0<^&NJ;e~xm56ifBZS0(YXAKzt7-f^Zx)vxBmbI?sn6St+!jr0ZpL}
zA-s4oZr%_MSd9Xp?Ee4}-}fy)F)aOmiRnKKk#G1@)?H%hZreX}!rgfY!rMV)2GXH{
zMu!P;DyBO8wUxS0{{T@n{=xj^>FK}SKkI)K?f4v>m+5&fV7PwmFNf}1O~Z%<zEWCA
z#D)@@Q9V`0F=PBKKjtpKBQHt#{{S-l)9{JceHM59mL}|6r*hXlYjsE^N>X_Sps7{M
z5<&Bg+5B<-%l`oK80df17JrO5veX%2cMe=O<94cG-88VJD1@iFS~NKYRGLP&pWy2M
z0L$F`<=p&z8UFyZ{8Gz%E<ZQ!dYxI^Er&TTEF`$!Aw@1bXzz6ZfN6~jDa50&mDXR=
zY=82m{{XgbUH-llzb*WK!57m0H2FG<Erv^o!k1J~msAZo*j0%S3is28BBQ)#sQ&<m
zT7Tva{{YHkfB5@-kNf`s`e*Y_tLuLSq7t_`K@2I9wHsn_D1e$3CB*05&m<EZ+xlAn
z0CAuBOuawH{gcw6>Z&@EYC|ux?-vSs;mcsbQA&`za7z2%te>Vd(>+#S`Oc&Lk&d6Q
zxqBUF!%LTCi}y)W2~#+d;+b{Jc9sfCMR2P#mL#0OJHWsA)<5O0zvmL&f2w+Z@h1NO
zW7GFRw=Oc4*0$D45SLVsuBw!(n_}RiBCWS~^zHuud}zPwyD$2Mac+gU&SRPxEjWW(
zcTZA%RN5);@fCiV{DgEpAvR9Tn?(z9syM79VRUAoov^x(m{;zP8~%lHABj-)HfaK?
zZ3;ukMH1qY3aF)K2V6gtPLclr^Zx+uv-ucV>G)Hxs^3A`c?naN*f6|1+`61Dr9V4o
zs(L|x{lL%pcYipVN%G&uCsLOE>QtcXhN)H*mqtY!ia4LDdi9N8{(*7&N&f(t%fI{?
ze8k1CSUx4KVDrE=G(`a=BxQkHp6>8Xe@M3SPyC`zpRe&JYR_*)^rfk2Z6gw^Turv3
zJK&9jqln-P73UB4{{VbyD>l-aUAFRB=PkbSd#-V)KA$>$(blE?66f@h{{SeHOX>Yj
zB%iP9q`67Jr!msI*J4LcXBn?Qp?}0?bhrE(+D_(8xZXidZ<<tUN0Ryuk-y39ACQ?}
zR<=cuzil1G6=FtM@e+mf_V~t5?te%~8>gxG<lWk<0<oNFpwAFd>rN0_FQs4ZBlkyg
zdJ>nl4&|$x8`ql`N0^Wm-6Zdw50?nNU;K9S{vXIi=yEK(h94+aJ)_k$%xHM2&B!H6
zAk=Zsz2G=TdWPfK`9#T>Qm(Y_*&`7*X;bS;%dOO_y64M>KS<*_#(xz**NoqjD87!>
zp4i$h*WPXt7j&Xhp;Nl@s5Pf`JbKPtegc2oAC%XW{{Te2;%nf(j?4c5akYuB+Obi!
zHOkB*nZd%LodM4kXE=|<9%_#%uHS$5Oa2Fb%a3o_(A(?UduH?9sM6eJD#AfhTzN*S
zb3a#7lijBYL2dZy{{V0Q0O`xPm-YQp%X_u)bPnrQ3MS(Cml?NvCkJ(<JfVdpDNQ@H
zJ?TfN{{Zye$N8qeIc1;i>Yw+Yg=X*3f9?A$Z@Wii&nf0A^FX$i61-jZK=mB+QaEvx
z4}XVgpX{stQyFDH*X>gG%kd<>t2<xB{^wS<O1q39=V;;*;=#wsb0UQr@CP9)mH6rM
zlXLL+r^LJOR{W(6Mdq7J4HAY?Tmum#0u53>aE<=}{p0x=p^=}|P|A{*-0myWil+`^
zarsK^cXWF{<`J!|?riiwaNM%%$zT#iDoLtbY^0o2>*Edny8i&nxBmbsndqPDZ2;t<
z#UbjYebP-we6*~T6;30BRlnhn^6UQqm`b<&RP_DM8`Fzyr3_KKl1IC|ph&{6N)=Pb
zJYEs%eRe;j$K<Itd`LnO@fxdPzGDvrUAoeL0Mj)y?cgM7AJO&i^Pj#tf2Z9&aX%9;
zLhmoGIXs8fRuFMFaEz2vb_!0|y5$3Z=>Gt>@-oU!{{YnW*l+I!<wKWu-bwTt@ATKt
zgk`6HOkbL%0-U}%t07H=DHQJ|!Ykw}B_EFGn2m^D%6`<}v=G&kSaEuu!cJWhOt07f
z0L9<-PP`a;*7$x$E`0qXJl{EzNh?s{B|f!z%@u>yoD>x6Grpk&20%$&0I8;CYk$R8
zlmJyIcxM!^;{u{vz~Z_AxA(-`@ASb`5lO_a0kveG-5{t=G~%W_fF_+_Q|edfn9)~c
z8rfLVGx@eLHlMvRQjnd;edQr|DN%>JzVa^r039EqKPV?^wwJi5d24MoA-}Cp4;X>?
zU)QOVpdO+yag`JtDmhn$B5d~he<)QwL`#W5DcxQhL665WX?+c)?mxU1?bf1cNGp%%
zk9mISn>SW>YkG<4RL@-ti<Pg&HfQl1^Owg_th+Jgx|6!b*~+3K)6qHDwbL4yowm4y
zZ!u!l<w!MT4W>r6i82fTf@UxxpvW?jG_;arD``em1yT&67qJRT7m*TvX+-HmXYFui
zoWyYd0O89jCB>`RUUD*5ywM!X>VUP5G9=Whd02&ug{BQsctwqUO32B*Bdi3?;*Oq;
z&T8g(o9`IWGnL|WzOK{UIK%W`@T_K?=NrW7UWv^du~{PZCyZ#;(~aY;-tR=^j&S^3
zHmKRT%f`m?b(zY>CxZgG!MCuO>Q_#b#6sUlr0pidN=R(NM$posDWq2j2sTm#im4JN
zgi)4&sHt{_fWtY$33iF4LQ+Im2-po@37`U!Q^zQn*$pUxw5yEG#^|0gVJf$Um&qBp
zHRx=sZwPhGd9ua9vo%}8E^cPbbMb2TH#X)N&G|DJ@o3nvM+kN8HRTy&O&b=e2&t{4
zXG=jX#hI<5X?+917I&9u&X$7uXo)u-iL85=_h&A~U6of}sjl~(`1=@kdHFk>oxz)|
z(8*e85Gk|XkdIJ{*)L_sxsP+^Ju@-sobobu!7vb3ZZjicK&!0DfI`xxb(lt$F6vT(
z%#JbQr;+HAW-=&76L67Wggo+6AZ|7>jN4e3Ei<2BAAY6<&s4J(qd8rrSm`FK5;UJs
zn8?kn3>_VvFo~@FGb5xS<7Pu}wMur%=@Qg}2Psrac9&=aB~d7p5{X$5MMkXBfCj6c
dmwo<K{{Z<6+L!oc@A+qc<uH20y^Om*|Je-*z*YbN

literal 0
HcmV?d00001

diff --git a/registry/blocks/editorial-flash-overlay/demo.html b/registry/blocks/editorial-flash-overlay/demo.html
new file mode 100644
index 0000000000..4705557b2c
--- /dev/null
+++ b/registry/blocks/editorial-flash-overlay/demo.html
@@ -0,0 +1,73 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      *,
+      *::before,
+      *::after {
+        box-sizing: border-box;
+      }
+
+      html,
+      body,
+      #editorial-flash-demo {
+        width: 1920px;
+        height: 1080px;
+        margin: 0;
+        overflow: hidden;
+        background: #080808;
+      }
+
+      #ef-demo-backdrop,
+      #ef-demo-overlay {
+        position: absolute;
+        inset: 0;
+        width: 100%;
+        height: 100%;
+      }
+
+      #ef-demo-backdrop {
+        object-fit: cover;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="editorial-flash-demo"
+      data-composition-id="editorial-flash-demo"
+      data-start="0"
+      data-duration="4"
+      data-width="1920"
+      data-height="1080"
+    >
+      <img
+        id="ef-demo-backdrop"
+        class="clip"
+        src="./demo-backdrop.jpg"
+        alt=""
+        data-start="0"
+        data-duration="4"
+        data-track-index="0"
+      />
+      <div
+        id="ef-demo-overlay"
+        data-composition-id="editorial-flash-overlay"
+        data-composition-src="editorial-flash-overlay.html"
+        data-start="0"
+        data-duration="4"
+        data-track-index="1"
+        data-width="1920"
+        data-height="1080"
+      ></div>
+    </div>
+
+    <script>
+      var tl = gsap.timeline({ paused: true });
+      tl.to("#ef-demo-backdrop", { scale: 1.035, duration: 4, ease: "none" }, 0);
+      window.__timelines = window.__timelines || {};
+      window.__timelines["editorial-flash-demo"] = tl;
+    </script>
+  </body>
+</html>
diff --git a/registry/blocks/editorial-flash-overlay/editorial-flash-overlay.html b/registry/blocks/editorial-flash-overlay/editorial-flash-overlay.html
new file mode 100644
index 0000000000..9b2c8d4502
--- /dev/null
+++ b/registry/blocks/editorial-flash-overlay/editorial-flash-overlay.html
@@ -0,0 +1,129 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      *,
+      *::before,
+      *::after {
+        box-sizing: border-box;
+      }
+
+      html,
+      body {
+        width: 1920px;
+        height: 1080px;
+        margin: 0;
+        overflow: hidden;
+        background: transparent;
+      }
+
+      #ef-flash {
+        --hf-editorial-flash-wash: 255 253 250;
+        --hf-editorial-flash-warm: 255 174 105;
+        --hf-editorial-flash-cool: 183 218 255;
+        position: absolute;
+        inset: -12%;
+        overflow: hidden;
+        pointer-events: none;
+      }
+
+      #ef-flash .ef-layer {
+        position: absolute;
+        inset: 0;
+        opacity: 0;
+        will-change: opacity, transform;
+      }
+
+      #ef-wash {
+        background: rgb(var(--hf-editorial-flash-wash));
+      }
+
+      #ef-core {
+        inset: -18%;
+        background: radial-gradient(
+          ellipse 68% 92% at 37% 47%,
+          rgb(255 255 255) 0%,
+          rgb(255 255 255 / 98%) 20%,
+          rgb(var(--hf-editorial-flash-wash) / 86%) 45%,
+          rgb(var(--hf-editorial-flash-warm) / 32%) 67%,
+          transparent 86%
+        );
+        mix-blend-mode: screen;
+        transform-origin: 38% 48%;
+      }
+
+      #ef-sweep {
+        inset: -28%;
+        background: linear-gradient(
+          108deg,
+          transparent 21%,
+          rgb(var(--hf-editorial-flash-warm) / 10%) 38%,
+          rgb(var(--hf-editorial-flash-wash) / 90%) 49%,
+          rgb(255 255 255 / 98%) 53%,
+          rgb(var(--hf-editorial-flash-cool) / 24%) 62%,
+          transparent 79%
+        );
+        mix-blend-mode: screen;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="editorial-flash-overlay"
+      data-composition-id="editorial-flash-overlay"
+      data-start="0"
+      data-duration="4"
+      data-width="1920"
+      data-height="1080"
+    >
+      <div id="ef-flash" aria-hidden="true">
+        <div id="ef-wash" class="ef-layer"></div>
+        <div id="ef-core" class="ef-layer" data-layout-allow-overflow></div>
+        <div id="ef-sweep" class="ef-layer" data-layout-allow-overflow></div>
+      </div>
+    </div>
+
+    <script>
+      window.__timelines = window.__timelines || {};
+
+      var flash = document.getElementById("ef-flash");
+      var host = flash && flash.closest("[data-composition-id]");
+      if (!host) throw new Error("Editorial Flash could not find its composition host");
+
+      var compositionId = host.getAttribute("data-composition-id");
+      var duration = Number(host.getAttribute("data-duration")) || 4;
+      var hit = Math.max(0.12, duration * 0.58);
+      var tl = gsap.timeline({ paused: true });
+
+      tl.to({}, { duration: duration, ease: "none" }, 0);
+      tl.to("#ef-wash", { opacity: 0.92, duration: 0.04, ease: "power4.in" }, hit);
+      tl.fromTo(
+        "#ef-core",
+        { opacity: 0, scale: 0.86, rotation: -5 },
+        { opacity: 1, scale: 1, rotation: -5, duration: 0.05, ease: "power4.in" },
+        hit - 0.01,
+      );
+      tl.fromTo(
+        "#ef-sweep",
+        { opacity: 0, xPercent: -12, rotation: -2 },
+        { opacity: 0.9, xPercent: 8, rotation: -2, duration: 0.04, ease: "power4.in" },
+        hit,
+      );
+      tl.to("#ef-wash", { opacity: 0, duration: 0.18, ease: "power3.out" }, hit + 0.04);
+      tl.to(
+        "#ef-core",
+        { opacity: 0, scale: 1.18, rotation: -5, duration: 0.34, ease: "power2.out" },
+        hit + 0.04,
+      );
+      tl.to(
+        "#ef-sweep",
+        { opacity: 0, xPercent: 28, rotation: -2, duration: 0.3, ease: "power2.out" },
+        hit + 0.04,
+      );
+
+      window.__timelines[compositionId] = tl;
+    </script>
+  </body>
+</html>
diff --git a/registry/blocks/editorial-flash-overlay/registry-item.json b/registry/blocks/editorial-flash-overlay/registry-item.json
new file mode 100644
index 0000000000..35f1ea891a
--- /dev/null
+++ b/registry/blocks/editorial-flash-overlay/registry-item.json
@@ -0,0 +1,32 @@
+{
+  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
+  "name": "editorial-flash-overlay",
+  "type": "hyperframes:block",
+  "title": "Editorial Flash Overlay",
+  "description": "Finite neutral-warm light layers for a seek-safe camera-flash cut or social reveal",
+  "tags": [
+    "flash",
+    "editorial",
+    "social",
+    "light",
+    "transition",
+    "overlay",
+    "media-treatment-overlay"
+  ],
+  "dimensions": {
+    "width": 1920,
+    "height": 1080
+  },
+  "duration": 4,
+  "files": [
+    {
+      "path": "editorial-flash-overlay.html",
+      "target": "compositions/editorial-flash-overlay.html",
+      "type": "hyperframes:composition"
+    }
+  ],
+  "preview": {
+    "poster": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/editorial-flash-overlay.png",
+    "video": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/editorial-flash-overlay.mp4"
+  }
+}
diff --git a/registry/blocks/freeze-frame-dressing/demo-background.jpg b/registry/blocks/freeze-frame-dressing/demo-background.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..4f944ae6b43603a96bfe5c8597638e6c033cc783
GIT binary patch
literal 64140
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
VJDk7{XNQNrQDp;p7$E&y{y%3FK!yMS

literal 0
HcmV?d00001

diff --git a/registry/blocks/freeze-frame-dressing/demo-cutout.webp b/registry/blocks/freeze-frame-dressing/demo-cutout.webp
new file mode 100644
index 0000000000000000000000000000000000000000..383d554f34ff4fe9af0391cbc14f299ef681d42b
GIT binary patch
literal 318286
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%0D~(aOnSV=7WWH1S<*0@2N1CCF%UW78HNZLj0l9-
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

literal 0
HcmV?d00001

diff --git a/registry/blocks/freeze-frame-dressing/demo.html b/registry/blocks/freeze-frame-dressing/demo.html
new file mode 100644
index 0000000000..cd0f2e5c84
--- /dev/null
+++ b/registry/blocks/freeze-frame-dressing/demo.html
@@ -0,0 +1,102 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      *,
+      *::before,
+      *::after {
+        box-sizing: border-box;
+      }
+
+      html,
+      body,
+      #freeze-frame-demo {
+        width: 960px;
+        height: 540px;
+        margin: 0;
+        overflow: hidden;
+        background: #111;
+      }
+
+      #freeze-demo-background,
+      #freeze-demo-cutout,
+      #freeze-demo-overlay {
+        position: absolute;
+        inset: 0;
+        width: 100%;
+        height: 100%;
+      }
+
+      #freeze-demo-background {
+        object-fit: cover;
+        filter: saturate(0.28) contrast(1.1) brightness(0.72);
+        transform: scale(1.04) rotate(-0.4deg);
+      }
+
+      #freeze-demo-cutout {
+        z-index: 10;
+        object-fit: contain;
+        filter: drop-shadow(3px 0 0 #fff) drop-shadow(-3px 0 0 #fff) drop-shadow(0 3px 0 #fff)
+          drop-shadow(0 -3px 0 #fff) drop-shadow(14px 18px 8px rgb(16 18 23 / 46%));
+      }
+
+      #freeze-demo-overlay {
+        z-index: 20;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="freeze-frame-demo"
+      data-composition-id="freeze-frame-demo"
+      data-start="0"
+      data-duration="4"
+      data-width="960"
+      data-height="540"
+    >
+      <img
+        id="freeze-demo-background"
+        class="clip"
+        src="./demo-background.jpg"
+        alt=""
+        data-start="0"
+        data-duration="4"
+        data-track-index="0"
+      />
+      <img
+        id="freeze-demo-cutout"
+        class="clip"
+        src="./demo-cutout.webp"
+        alt=""
+        data-start="0"
+        data-duration="4"
+        data-track-index="1"
+      />
+      <div
+        id="freeze-demo-overlay"
+        data-composition-id="freeze-frame-dressing"
+        data-composition-src="freeze-frame-dressing.html"
+        data-start="0"
+        data-duration="4"
+        data-track-index="2"
+        data-width="960"
+        data-height="540"
+      ></div>
+    </div>
+
+    <script>
+      var tl = gsap.timeline({ paused: true });
+      tl.fromTo(
+        "#freeze-demo-cutout",
+        { y: 42, scale: 0.86, rotation: -2 },
+        { y: 0, scale: 1, rotation: 0.4, duration: 0.5, ease: "back.out(1.35)" },
+        1,
+      );
+      tl.to({}, { duration: 4, ease: "none" }, 0);
+      window.__timelines = window.__timelines || {};
+      window.__timelines["freeze-frame-demo"] = tl;
+    </script>
+  </body>
+</html>
diff --git a/registry/blocks/freeze-frame-dressing/freeze-frame-dressing.html b/registry/blocks/freeze-frame-dressing/freeze-frame-dressing.html
new file mode 100644
index 0000000000..458db7e892
--- /dev/null
+++ b/registry/blocks/freeze-frame-dressing/freeze-frame-dressing.html
@@ -0,0 +1,120 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      *,
+      *::before,
+      *::after {
+        box-sizing: border-box;
+      }
+
+      html,
+      body {
+        width: 1920px;
+        height: 1080px;
+        margin: 0;
+        overflow: hidden;
+        background: transparent;
+      }
+
+      #hf-freeze-paper {
+        position: absolute;
+        inset: 0;
+        opacity: 0;
+        background:
+          linear-gradient(115deg, rgb(248 84 73 / 86%) 0 16%, transparent 16%),
+          linear-gradient(345deg, rgb(255 221 82 / 92%) 0 17%, transparent 17%),
+          linear-gradient(rgb(244 240 224 / 78%), rgb(244 240 224 / 78%));
+        clip-path: polygon(2% 8%, 97% 2%, 94% 94%, 6% 98%);
+        mix-blend-mode: screen;
+        pointer-events: none;
+      }
+
+      .hf-freeze-tape {
+        position: absolute;
+        width: 12.5vmin;
+        height: 2.9vmin;
+        opacity: 0;
+        background: rgb(255 236 168 / 76%);
+        border: 1px solid rgb(110 91 55 / 18%);
+        box-shadow: 0 0.3vmin 0.8vmin rgb(20 16 10 / 18%);
+        pointer-events: none;
+      }
+
+      #hf-freeze-tape-a {
+        top: 8%;
+        left: 12.5%;
+        transform: rotate(-8deg);
+      }
+
+      #hf-freeze-tape-b {
+        right: 12.5%;
+        bottom: 7%;
+        transform: rotate(7deg);
+      }
+
+      #hf-freeze-flash {
+        position: absolute;
+        inset: 0;
+        opacity: 0;
+        background: #fff;
+        pointer-events: none;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="freeze-frame-dressing"
+      data-composition-id="freeze-frame-dressing"
+      data-start="0"
+      data-duration="4"
+      data-width="1920"
+      data-height="1080"
+    >
+      <div id="hf-freeze-paper" aria-hidden="true"></div>
+      <div id="hf-freeze-tape-a" class="hf-freeze-tape" aria-hidden="true"></div>
+      <div id="hf-freeze-tape-b" class="hf-freeze-tape" aria-hidden="true"></div>
+      <div id="hf-freeze-flash" aria-hidden="true"></div>
+    </div>
+
+    <script>
+      window.__timelines = window.__timelines || {};
+
+      var paper = document.getElementById("hf-freeze-paper");
+      var host = paper && paper.closest("[data-composition-id]");
+      if (!host) throw new Error("Freeze-Frame Dressing could not find its composition host");
+
+      var compositionId = host.getAttribute("data-composition-id");
+      var duration = Number(host.getAttribute("data-duration")) || 4;
+      var hit = Math.max(0.1, duration * 0.24);
+      var exit = Math.max(hit + 0.7, duration - 0.3);
+      var tl = gsap.timeline({ paused: true });
+
+      tl.to({}, { duration: duration, ease: "none" }, 0);
+      tl.to("#hf-freeze-flash", { opacity: 0.95, duration: 0.06, ease: "power2.out" }, hit);
+      tl.to("#hf-freeze-flash", { opacity: 0, duration: 0.24, ease: "power2.in" }, hit + 0.06);
+      tl.to("#hf-freeze-paper", { opacity: 0.64, duration: 0.18, ease: "power2.out" }, hit + 0.04);
+      tl.fromTo(
+        "#hf-freeze-tape-a",
+        { opacity: 0, scale: 1.18 },
+        { opacity: 1, scale: 1, duration: 0.24, ease: "power2.out" },
+        hit + 0.3,
+      );
+      tl.fromTo(
+        "#hf-freeze-tape-b",
+        { opacity: 0, scale: 1.18 },
+        { opacity: 1, scale: 1, duration: 0.24, ease: "power2.out" },
+        hit + 0.42,
+      );
+      tl.to(
+        ["#hf-freeze-paper", "#hf-freeze-tape-a", "#hf-freeze-tape-b"],
+        { opacity: 0, duration: 0.24, ease: "power2.in" },
+        exit,
+      );
+
+      window.__timelines[compositionId] = tl;
+    </script>
+  </body>
+</html>
diff --git a/registry/blocks/freeze-frame-dressing/registry-item.json b/registry/blocks/freeze-frame-dressing/registry-item.json
new file mode 100644
index 0000000000..b2596eb7a7
--- /dev/null
+++ b/registry/blocks/freeze-frame-dressing/registry-item.json
@@ -0,0 +1,32 @@
+{
+  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
+  "name": "freeze-frame-dressing",
+  "type": "hyperframes:block",
+  "title": "Freeze-Frame Dressing",
+  "description": "Timeline-driven paper, tape, and flash dressing for a freeze-frame or background-removed subject",
+  "tags": [
+    "freeze-frame",
+    "cutout",
+    "scrapbook",
+    "paper",
+    "social",
+    "overlay",
+    "media-treatment-overlay"
+  ],
+  "dimensions": {
+    "width": 1920,
+    "height": 1080
+  },
+  "duration": 4,
+  "files": [
+    {
+      "path": "freeze-frame-dressing.html",
+      "target": "compositions/freeze-frame-dressing.html",
+      "type": "hyperframes:composition"
+    }
+  ],
+  "preview": {
+    "poster": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/freeze-frame-dressing.png",
+    "video": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/freeze-frame-dressing.mp4"
+  }
+}
diff --git a/registry/blocks/organic-light-leak-overlay/demo-backdrop.jpg b/registry/blocks/organic-light-leak-overlay/demo-backdrop.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e7f2ba592a275138f945ee8f481c3f7d83292058
GIT binary patch
literal 48749
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

literal 0
HcmV?d00001

diff --git a/registry/blocks/organic-light-leak-overlay/demo.html b/registry/blocks/organic-light-leak-overlay/demo.html
new file mode 100644
index 0000000000..f8d15dbaea
--- /dev/null
+++ b/registry/blocks/organic-light-leak-overlay/demo.html
@@ -0,0 +1,77 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      *,
+      *::before,
+      *::after {
+        box-sizing: border-box;
+      }
+
+      html,
+      body,
+      #organic-light-leak-demo {
+        width: 960px;
+        height: 540px;
+        margin: 0;
+        overflow: hidden;
+        background: #090909;
+      }
+
+      #light-leak-demo-backdrop,
+      #light-leak-demo-overlay {
+        position: absolute;
+        inset: 0;
+        width: 100%;
+        height: 100%;
+      }
+
+      #light-leak-demo-backdrop {
+        object-fit: cover;
+      }
+
+      #light-leak-demo-overlay {
+        z-index: 20;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="organic-light-leak-demo"
+      data-composition-id="organic-light-leak-demo"
+      data-start="0"
+      data-duration="4"
+      data-width="960"
+      data-height="540"
+    >
+      <img
+        id="light-leak-demo-backdrop"
+        class="clip"
+        src="./demo-backdrop.jpg"
+        alt=""
+        data-start="0"
+        data-duration="4"
+        data-track-index="0"
+      />
+      <div
+        id="light-leak-demo-overlay"
+        data-composition-id="organic-light-leak-overlay"
+        data-composition-src="organic-light-leak-overlay.html"
+        data-start="0"
+        data-duration="4"
+        data-track-index="1"
+        data-width="960"
+        data-height="540"
+      ></div>
+    </div>
+
+    <script>
+      var tl = gsap.timeline({ paused: true });
+      tl.to("#light-leak-demo-backdrop", { scale: 1.025, duration: 4, ease: "none" }, 0);
+      window.__timelines = window.__timelines || {};
+      window.__timelines["organic-light-leak-demo"] = tl;
+    </script>
+  </body>
+</html>
diff --git a/registry/blocks/organic-light-leak-overlay/organic-light-leak-overlay.html b/registry/blocks/organic-light-leak-overlay/organic-light-leak-overlay.html
new file mode 100644
index 0000000000..206e92f847
--- /dev/null
+++ b/registry/blocks/organic-light-leak-overlay/organic-light-leak-overlay.html
@@ -0,0 +1,125 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      *,
+      *::before,
+      *::after {
+        box-sizing: border-box;
+      }
+
+      html,
+      body {
+        width: 1920px;
+        height: 1080px;
+        margin: 0;
+        overflow: hidden;
+        background: transparent;
+      }
+
+      #hf-light-leak {
+        position: absolute;
+        inset: -16%;
+        opacity: 0;
+        overflow: hidden;
+        pointer-events: none;
+        mix-blend-mode: screen;
+      }
+
+      #hf-light-leak .hf-leak-layer {
+        position: absolute;
+        inset: -20%;
+        will-change: opacity, transform;
+      }
+
+      #hf-light-leak .hf-leak-amber {
+        background:
+          radial-gradient(ellipse 52% 110% at 10% 58%, rgb(255 241 197 / 92%), transparent 45%),
+          radial-gradient(ellipse 72% 120% at 24% 54%, rgb(255 126 57 / 78%), transparent 66%);
+        filter: blur(2.8vmin);
+      }
+
+      #hf-light-leak .hf-leak-red {
+        background: radial-gradient(
+          ellipse 58% 105% at 78% 34%,
+          rgb(255 79 61 / 72%),
+          rgb(255 44 92 / 28%) 48%,
+          transparent 76%
+        );
+        filter: blur(4vmin);
+      }
+
+      #hf-light-leak .hf-leak-gold {
+        background: linear-gradient(
+          104deg,
+          transparent 24%,
+          rgb(255 144 62 / 30%) 40%,
+          rgb(255 247 205 / 72%) 51%,
+          rgb(255 124 48 / 22%) 62%,
+          transparent 78%
+        );
+        filter: blur(2vmin);
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="organic-light-leak-overlay"
+      data-composition-id="organic-light-leak-overlay"
+      data-start="0"
+      data-duration="4"
+      data-width="1920"
+      data-height="1080"
+    >
+      <div id="hf-light-leak" aria-hidden="true">
+        <div class="hf-leak-layer hf-leak-amber"></div>
+        <div class="hf-leak-layer hf-leak-red"></div>
+        <div class="hf-leak-layer hf-leak-gold"></div>
+      </div>
+    </div>
+
+    <script>
+      window.__timelines = window.__timelines || {};
+
+      var leak = document.getElementById("hf-light-leak");
+      var host = leak && leak.closest("[data-composition-id]");
+      if (!host) throw new Error("Organic Light Leak could not find its composition host");
+
+      var compositionId = host.getAttribute("data-composition-id");
+      var duration = Number(host.getAttribute("data-duration")) || 4;
+      var tl = gsap.timeline({ paused: true });
+
+      tl.to({}, { duration: duration, ease: "none" }, 0);
+      tl.fromTo(
+        leak,
+        { opacity: 0 },
+        { opacity: 0.9, duration: duration * 0.24, ease: "sine.out" },
+        duration * 0.08,
+      );
+      tl.to(leak, { opacity: 0.46, duration: duration * 0.2, ease: "sine.inOut" }, duration * 0.42);
+      tl.to(leak, { opacity: 0, duration: duration * 0.26, ease: "sine.in" }, duration * 0.68);
+      tl.fromTo(
+        ".hf-leak-amber",
+        { xPercent: -20, scale: 0.92, rotation: -4 },
+        { xPercent: 18, scale: 1.1, rotation: 2, duration: duration, ease: "sine.inOut" },
+        0,
+      );
+      tl.fromTo(
+        ".hf-leak-red",
+        { xPercent: 20, yPercent: -8, scale: 1.08 },
+        { xPercent: -16, yPercent: 8, scale: 0.94, duration: duration, ease: "sine.inOut" },
+        0,
+      );
+      tl.fromTo(
+        ".hf-leak-gold",
+        { xPercent: -28, rotation: -6 },
+        { xPercent: 24, rotation: 4, duration: duration, ease: "sine.inOut" },
+        0,
+      );
+
+      window.__timelines[compositionId] = tl;
+    </script>
+  </body>
+</html>
diff --git a/registry/blocks/organic-light-leak-overlay/registry-item.json b/registry/blocks/organic-light-leak-overlay/registry-item.json
new file mode 100644
index 0000000000..1c5d2b2611
--- /dev/null
+++ b/registry/blocks/organic-light-leak-overlay/registry-item.json
@@ -0,0 +1,24 @@
+{
+  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
+  "name": "organic-light-leak-overlay",
+  "type": "hyperframes:block",
+  "title": "Organic Light Leak Overlay",
+  "description": "Finite CSS light-leak overlay for memory beats and motivated transitions",
+  "tags": ["light-leak", "film", "memory", "transition", "overlay", "media-treatment-overlay"],
+  "dimensions": {
+    "width": 1920,
+    "height": 1080
+  },
+  "duration": 4,
+  "files": [
+    {
+      "path": "organic-light-leak-overlay.html",
+      "target": "compositions/organic-light-leak-overlay.html",
+      "type": "hyperframes:composition"
+    }
+  ],
+  "preview": {
+    "poster": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/organic-light-leak-overlay.png",
+    "video": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/organic-light-leak-overlay.mp4"
+  }
+}
diff --git a/registry/registry.json b/registry/registry.json
index 5513973ee9..19d8d68ae7 100644
--- a/registry/registry.json
+++ b/registry/registry.json
@@ -75,6 +75,22 @@
       "name": "grain-overlay",
       "type": "hyperframes:component"
     },
+    {
+      "name": "camcorder-hud",
+      "type": "hyperframes:block"
+    },
+    {
+      "name": "editorial-flash-overlay",
+      "type": "hyperframes:block"
+    },
+    {
+      "name": "organic-light-leak-overlay",
+      "type": "hyperframes:block"
+    },
+    {
+      "name": "freeze-frame-dressing",
+      "type": "hyperframes:block"
+    },
     {
       "name": "shimmer-sweep",
       "type": "hyperframes:component"
diff --git a/scripts/generate-catalog-previews.ts b/scripts/generate-catalog-previews.ts
index 70ec84f624..d4fecf2d97 100644
--- a/scripts/generate-catalog-previews.ts
+++ b/scripts/generate-catalog-previews.ts
@@ -42,6 +42,7 @@ import {
   createRenderJob,
   executeRenderJob,
 } from "../packages/producer/src/index.js";
+import { compileForRender } from "../packages/producer/src/services/htmlCompiler.js";
 
 const scriptDir = dirname(fileURLToPath(import.meta.url));
 const repoRoot = resolve(scriptDir, "..");
@@ -90,10 +91,12 @@ function discoverItems(kindFilter: ItemKind | null, nameFilter: string | null):
       const manifestPath = join(sourceDir, "registry-item.json");
       if (!existsSync(manifestPath)) continue;
 
-      // Blocks: find the first composition file. Components: use demo.html.
+      // Authored demos show transparent overlays against representative media.
       let entryFile: string;
-      if (kind === "component") {
+      if (existsSync(join(sourceDir, "demo.html"))) {
         entryFile = "demo.html";
+      } else if (kind === "component") {
+        continue;
       } else {
         const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
         const compFile = manifest.files?.find(
@@ -123,7 +126,7 @@ function outputDir(kind: ItemKind): string {
   return resolve(repoRoot, "docs/images/catalog", typeDir);
 }
 
-function prepareProjectDir(item: CatalogItem): string {
+async function prepareProjectDir(item: CatalogItem): Promise<string> {
   const tmpDir = join(tmpdir(), `hf-catalog-${item.name}-${Date.now()}`);
   mkdirSync(tmpDir, { recursive: true });
   cpSync(item.sourceDir, tmpDir, { recursive: true });
@@ -170,7 +173,6 @@ function prepareProjectDir(item: CatalogItem): string {
         }
       }
       writeFileSync(join(tmpDir, "index.html"), content, "utf-8");
-      return tmpDir;
     }
   }
   if (!existsSync(join(tmpDir, "index.html"))) {
@@ -217,6 +219,13 @@ function prepareProjectDir(item: CatalogItem): string {
     writeFileSync(join(tmpDir, "index.html"), wrapper, "utf-8");
   }
 
+  const indexPath = join(tmpDir, "index.html");
+  const indexHtml = readFileSync(indexPath, "utf-8");
+  if (indexHtml.includes("data-composition-src")) {
+    const compiled = await compileForRender(tmpDir, indexPath, join(tmpDir, "_downloads"));
+    writeFileSync(indexPath, compiled.html, "utf-8");
+  }
+
   return tmpDir;
 }
 
@@ -259,9 +268,7 @@ async function generateThumbnail(item: CatalogItem, projectDir: string): Promise
       duration = 5;
     }
 
-    // Capture at 40% of duration for a representative frame
-    // Capture at 60% of duration so the animation is well underway.
-    // Cap at 3s to avoid overly-late captures on long compositions.
+    // Capture after the treatment appears, capped for long compositions.
     const captureTime = Math.min(3.0, duration * 0.6);
     const result = await captureFrame(session, 0, captureTime);
     cpSync(result.path, join(outDir, `${item.name}.png`));
@@ -327,7 +334,7 @@ async function main(): Promise<void> {
 
   for (const item of items) {
     console.log(`[${item.kind}] ${item.name}`);
-    const projectDir = prepareProjectDir(item);
+    const projectDir = await prepareProjectDir(item);
     try {
       await generateThumbnail(item, projectDir);
       if (!skipVideo) {
diff --git a/skills-manifest.json b/skills-manifest.json
index 2dec1c9972..eaf2d70205 100644
--- a/skills-manifest.json
+++ b/skills-manifest.json
@@ -46,7 +46,7 @@
       "files": 10
     },
     "media-use": {
-      "hash": "1234dcf993bbe1fc",
+      "hash": "470beb651f5a5068",
       "files": 151
     },
     "motion-graphics": {
diff --git a/skills/media-use/references/media-treatment-recipes.md b/skills/media-use/references/media-treatment-recipes.md
index 2a92a34436..37903ab58f 100644
--- a/skills/media-use/references/media-treatment-recipes.md
+++ b/skills/media-use/references/media-treatment-recipes.md
@@ -826,7 +826,7 @@ Extract the exact deterministic source frame first, then remove its background:
 ffmpeg -ss <seconds> -i <source-video> -frames:v 1 -y .media/generated/freeze-source.png
 npx hyperframes remove-background .media/generated/freeze-source.png \
   -o .media/generated/freeze-cutout.png --json
-npx hyperframes add freeze-frame-cutout --no-clipboard
+npx hyperframes add freeze-frame-dressing --no-clipboard
 ```
 
 Add the transparent result as a direct-root timed media layer and insert the

From 39c2341c4d1edf52a00fb8db4a49553c739860cc Mon Sep 17 00:00:00 2001
From: ukimsanov <ular.kimsanov@heygen.com>
Date: Thu, 23 Jul 2026 21:41:51 -0700
Subject: [PATCH 054/125] feat(studio): add media treatment inspector

---
 packages/studio/src/App.tsx                   |   8 +-
 .../src/components/StudioRightPanel.tsx       |   8 +-
 .../components/editor/PropertyPanel.test.tsx  |  16 +-
 .../components/editor/PropertyPanelFlat.tsx   | 162 +++---
 .../editor/colorGradingScopePatch.test.ts     |   6 +-
 ...pertyPanelFlatColorGradingSection.test.tsx | 113 ++--
 .../propertyPanelFlatColorGradingSection.tsx  | 151 +++---
 .../editor/propertyPanelFlatEffectControl.tsx |  96 ++++
 .../editor/propertyPanelFlatEffectSpecs.ts    | 305 +++++++++++
 .../propertyPanelFlatEffectsSection.test.tsx  | 331 ++++++++++++
 .../propertyPanelFlatEffectsSection.tsx       | 503 ++++++++++++++++++
 .../propertyPanelFlatOverlaysSection.test.tsx | 113 ++++
 .../propertyPanelFlatOverlaysSection.tsx      | 108 ++++
 .../editor/propertyPanelFlatPrimitives.tsx    |   2 +
 .../editor/propertyPanelPresetPreview.ts      |  36 ++
 .../components/editor/propertyPanelTypes.ts   |  13 +
 .../editor/useColorGradingController.test.ts  | 207 ++++++-
 .../editor/useColorGradingController.ts       | 125 ++---
 .../editor/useColorGradingPreviews.ts         | 307 +++++++++++
 packages/studio/src/hooks/useBlockHandlers.ts |  22 +
 .../studio/src/utils/blockInstaller.test.ts   |  67 +++
 packages/studio/src/utils/blockInstaller.ts   | 271 ++++++----
 22 files changed, 2558 insertions(+), 412 deletions(-)
 create mode 100644 packages/studio/src/components/editor/propertyPanelFlatEffectControl.tsx
 create mode 100644 packages/studio/src/components/editor/propertyPanelFlatEffectSpecs.ts
 create mode 100644 packages/studio/src/components/editor/propertyPanelFlatEffectsSection.test.tsx
 create mode 100644 packages/studio/src/components/editor/propertyPanelFlatEffectsSection.tsx
 create mode 100644 packages/studio/src/components/editor/propertyPanelFlatOverlaysSection.test.tsx
 create mode 100644 packages/studio/src/components/editor/propertyPanelFlatOverlaysSection.tsx
 create mode 100644 packages/studio/src/components/editor/propertyPanelPresetPreview.ts
 create mode 100644 packages/studio/src/components/editor/useColorGradingPreviews.ts
 create mode 100644 packages/studio/src/utils/blockInstaller.test.ts

diff --git a/packages/studio/src/App.tsx b/packages/studio/src/App.tsx
index 0e0ec6c774..ad131e3a62 100644
--- a/packages/studio/src/App.tsx
+++ b/packages/studio/src/App.tsx
@@ -12,10 +12,7 @@ import { useFileManager } from "./hooks/useFileManager";
 import { usePreviewPersistence } from "./hooks/usePreviewPersistence";
 import { usePreviewDocumentVersion } from "./hooks/usePreviewDocumentVersion";
 import { useTimelineEditing } from "./hooks/useTimelineEditing";
-import {
-  persistTimelineMoveEditsAtomically,
-  type TimelineMoveOperation,
-} from "./hooks/timelineMoveAdapter";
+import { persistTimelineMoveEditsAtomically } from "./hooks/timelineMoveAdapter";
 import type { TimelineZIndexReorderCommit } from "./hooks/useTimelineEditingTypes";
 import type { TimelineStackingReorderIntent } from "./player/components/timelineStacking";
 import type { BlockPreviewInfo } from "./components/sidebar/BlocksTab";
@@ -65,6 +62,7 @@ import {
 } from "./utils/studioUrlState";
 import { trackStudioSessionStart } from "./telemetry/events";
 import { hasFiredSessionStart, markSessionStartFired } from "./telemetry/config";
+type TimelineMoveOperation = Parameters<typeof persistTimelineMoveEditsAtomically>[2];
 // fallow-ignore-next-line complexity
 export function StudioApp() {
   const { projectId, resolving, waitingForServer } = useServerConnection();
@@ -204,6 +202,7 @@ export function StudioApp() {
     setActiveBlockParams,
     handleAddBlock,
     handleTimelineBlockDrop,
+    handleAddMediaOverlay,
     handlePreviewBlockDrop,
   } = useBlockHandlers({
     projectId,
@@ -536,6 +535,7 @@ export function StudioApp() {
                           domEditSaveTimestampRef={domEditSaveTimestampRef}
                           recordEdit={editHistory.recordEdit}
                           onToggleElementHidden={timelineEditing.handleToggleElementHidden}
+                          onAddMediaOverlay={handleAddMediaOverlay}
                         />
                       )
                     }
diff --git a/packages/studio/src/components/StudioRightPanel.tsx b/packages/studio/src/components/StudioRightPanel.tsx
index 6d12e5491c..178407f679 100644
--- a/packages/studio/src/components/StudioRightPanel.tsx
+++ b/packages/studio/src/components/StudioRightPanel.tsx
@@ -31,7 +31,10 @@ import {
   EMPTY_COLOR_GRADING_SCOPE_RESULT,
   type ColorGradingScope,
 } from "./studioColorGradingScope";
-import type { BackgroundRemovalProgress } from "./editor/propertyPanelTypes";
+import type {
+  AddMediaOverlayHandler,
+  BackgroundRemovalProgress,
+} from "./editor/propertyPanelTypes";
 import { timelineKeysForSelections, type ToggleHiddenHandler } from "../utils/studioHelpers";
 import { useInspectorSplitResize } from "../hooks/useInspectorSplitResize";
 
@@ -71,6 +74,7 @@ export interface StudioRightPanelProps extends StudioEditPersistenceProps {
     files: Record<string, { before: string; after: string }>;
   }) => Promise<void>;
   onToggleElementHidden?: ToggleHiddenHandler;
+  onAddMediaOverlay?: AddMediaOverlayHandler;
 }
 
 // fallow-ignore-next-line complexity
@@ -88,6 +92,7 @@ export function StudioRightPanel({
   domEditSaveTimestampRef,
   recordEdit,
   onToggleElementHidden,
+  onAddMediaOverlay,
 }: StudioRightPanelProps) {
   const {
     rightWidth,
@@ -372,6 +377,7 @@ export function StudioRightPanel({
         onRemoveTextField={handleDomRemoveTextField}
         onAskAgent={handleAskAgent}
         onImportAssets={handleImportFiles}
+        onAddMediaOverlay={onAddMediaOverlay}
         fontAssets={fontAssets}
         onImportFonts={handleImportFonts}
         previewIframeRef={previewIframeRef}
diff --git a/packages/studio/src/components/editor/PropertyPanel.test.tsx b/packages/studio/src/components/editor/PropertyPanel.test.tsx
index 84080056a2..be3912ea33 100644
--- a/packages/studio/src/components/editor/PropertyPanel.test.tsx
+++ b/packages/studio/src/components/editor/PropertyPanel.test.tsx
@@ -812,10 +812,10 @@ describe("PropertyPanel — Media group (Plan 4)", () => {
 // design_handoff scrollable-open-section: collapsed headers before/after the
 // open group render in normal document flow and never move (no sticky, no
 // stacking offsets) — only the open group's own body content scrolls, in a
-// dedicated region between the two fixed header stacks. Worked example: 6
-// groups [text, style, layout, motion, grade, media], motion open (index 3)
+// dedicated region between the two fixed header stacks. Worked example: 7
+// groups [text, style, layout, motion, grade, effects, media], motion open (index 3)
 // -> text/style/layout render as fixed collapsed headers before it, motion
-// renders as an open header + scrollable body, grade/media render as fixed
+// renders as an open header + scrollable body, grade/effects/media render as fixed
 // collapsed headers after it — in exactly that DOM order, nothing sticky.
 describe("PropertyPanel — fixed headers + scrollable open section (Plan 11)", () => {
   it(
@@ -839,13 +839,14 @@ describe("PropertyPanel — fixed headers + scrollable open section (Plan 11)",
       });
       // Filter to just the group entries (drop any non-group nulls).
       const groupTitles = titles.filter((t): t is string => t !== null);
-      expect(groupTitles).toHaveLength(6);
+      expect(groupTitles).toHaveLength(7);
       expect(groupTitles[0]).toContain("Text");
       expect(groupTitles[1]).toContain("Style");
       expect(groupTitles[2]).toContain("Layout");
       expect(groupTitles[3]).toContain("Motion");
       expect(groupTitles[4]).toContain("Grade");
-      expect(groupTitles[5]).toContain("Media");
+      expect(groupTitles[5]).toContain("Effects");
+      expect(groupTitles[6]).toContain("Media");
 
       // The open group (Motion, index 3) is the one wrapped in
       // data-flat-group-open, sitting between the before/after collapsed
@@ -880,14 +881,15 @@ describe("PropertyPanel — fixed headers + scrollable open section (Plan 11)",
       const collapsedRows = Array.from(
         host.querySelectorAll<HTMLButtonElement>('[data-flat-group-collapsed="true"]'),
       );
-      expect(collapsedRows).toHaveLength(6);
+      expect(collapsedRows).toHaveLength(7);
       const titlesInOrder = collapsedRows.map((el) => el.textContent ?? "");
       expect(titlesInOrder[0]).toContain("Text");
       expect(titlesInOrder[1]).toContain("Style");
       expect(titlesInOrder[2]).toContain("Layout");
       expect(titlesInOrder[3]).toContain("Motion");
       expect(titlesInOrder[4]).toContain("Grade");
-      expect(titlesInOrder[5]).toContain("Media");
+      expect(titlesInOrder[5]).toContain("Effects");
+      expect(titlesInOrder[6]).toContain("Media");
 
       const body = host.querySelector('[data-flat-panel-body="true"]');
       expect(body?.querySelector(".overflow-y-auto")).toBeNull();
diff --git a/packages/studio/src/components/editor/PropertyPanelFlat.tsx b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
index 4733fdfd55..ef1393a60d 100644
--- a/packages/studio/src/components/editor/PropertyPanelFlat.tsx
+++ b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
@@ -23,6 +23,15 @@ import {
   FlatColorGradingAccessory,
   FlatColorGradingSection,
 } from "./propertyPanelFlatColorGradingSection";
+import {
+  activeColorGradingEffectCount,
+  FlatEffectsAccessory,
+  FlatEffectsSection,
+} from "./propertyPanelFlatEffectsSection";
+import {
+  deriveMediaOverlayPlacement,
+  FlatOverlaysSection,
+} from "./propertyPanelFlatOverlaysSection";
 
 type EditingSections = ReturnType<typeof resolveEditingSections>;
 
@@ -34,11 +43,7 @@ type FlatGroupDescriptor = {
   content: ReactNode;
 };
 
-// Type-only fallback for the Motion effect-card callbacks. Used solely to
-// satisfy FlatMotionSection's required-callback shape when the effect list is
-// gated off (showEffects === false, so none of these are ever invoked). Keeps
-// the gated-off path free of `!` non-null assertions — the real, narrowed
-// handlers flow through only when the double-gate below passes.
+// Required callback shape for the gated-off Motion effect list.
 const EMPTY_GSAP_EFFECT_HANDLERS = {
   onAddAnimation: () => {},
   onUpdateProperty: () => {},
@@ -48,15 +53,7 @@ const EMPTY_GSAP_EFFECT_HANDLERS = {
   onRemoveProperty: () => {},
 };
 
-/**
- * The flat "Ledger" inspector shell (design_handoff_studio_inspector).
- *
- * Extracted from PropertyPanel so that file stays under the 600-LOC gate
- * (same one-directional-import precedent as FlatTextSection). Rendered only
- * when STUDIO_FLAT_INSPECTOR_ENABLED is on; owns the one-open group state.
- *
- * The Text/Style/Layout/Motion/Media/Grade groups share the one-open accordion.
- */
+/** The flat inspector shell with one shared open-group state. */
 // fallow-ignore-next-line complexity
 export function PropertyPanelFlat({
   element,
@@ -93,6 +90,7 @@ export function PropertyPanelFlat({
   onAskAgent,
   onToggleElementHidden,
   onImportAssets,
+  onAddMediaOverlay,
   onImportFonts,
   recordingState,
   recordingDuration,
@@ -113,10 +111,7 @@ export function PropertyPanelFlat({
   currentTime,
   animIdForProp,
   gsapRuntimeValues,
-  // Renamed: PropertyPanel.tsx still computes/passes these for its own legacy
-  // (non-flat) panel, but the flat path recomputes its own basis below via
-  // deriveElementTiming so it agrees with Motion's Timing row — ignore the
-  // parent's naive `elDuration ?? 1` fallback.
+  // The flat path derives timing consistently with its Motion section.
   elStart: _elStart,
   elDuration: _elDuration,
   onCommitAnimatedProperty,
@@ -164,6 +159,7 @@ export function PropertyPanelFlat({
   | "onAskAgent"
   | "onToggleElementHidden"
   | "onImportAssets"
+  | "onAddMediaOverlay"
   | "onImportFonts"
   | "fontAssets"
   | "gsapAnimations"
@@ -187,9 +183,6 @@ export function PropertyPanelFlat({
   | "recordingDuration"
   | "onToggleRecording"
 > &
-  // Layout-group values (Plan 3a Task 5). All are derived locals or handlers in
-  // PropertyPanel; compose their exact shapes from FlatLayoutSection's own props
-  // via Pick so a signature change there propagates here instead of drifting.
   Pick<
     Parameters<typeof FlatLayoutSection>[0],
     | "displayX"
@@ -227,12 +220,7 @@ export function PropertyPanelFlat({
     onCopyElementInfo: () => void;
     currentTime: number;
   }) {
-  // Lazy initializer: pick whichever group actually renders for this element
-  // (Text if text-editable, else Style if style-editable, else none open) so a
-  // style-only element doesn't start with everything collapsed. Only runs on
-  // mount — PropertyPanel.tsx keys <PropertyPanelFlat> by element identity so
-  // switching the selection re-mounts this component and re-derives the
-  // default instead of preserving stale state across unrelated elements.
+  // PropertyPanel keys this component by selection, so the default is per element.
   const [openGroupId, setOpenGroupId] = useState<string>(() =>
     isTextEditableSelection(element)
       ? "text"
@@ -243,33 +231,16 @@ export function PropertyPanelFlat({
           : "layout",
   );
 
-  // Tracks which group(s) are actively transitioning this toggle cycle, so
-  // their header/body gets the fast entrance animation (hf-flat-group-enter)
-  // and no one else's does. Deliberately NOT derived from remounting alone:
-  // FlatGroupHeader instances are keyed by group id and React normally
-  // preserves them across re-renders, but toggling a non-adjacent group still
-  // shifts the untouched collapsed siblings between the before/after-open
-  // slices below, and Chromium restarts a CSS animation on that kind of
-  // position shift even though nothing about the sibling actually changed.
-  // Gating on these ids (cleared shortly after the 120ms CSS animation
-  // finishes) keeps the animation scoped to only the groups that actually
-  // just toggled. Two ids, not one: the clicked (newly-opening/closing) group
-  // AND whichever group was open immediately before the click and got
-  // implicitly closed by it — both freshly-mounted headers need to animate.
+  // Animate only the groups that changed during this toggle cycle.
   const [justToggledIds, setJustToggledIds] = useState<string[]>([]);
   const justToggledTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const panelBodyRef = useRef<HTMLDivElement>(null);
   useEffect(() => {
     return () => {
       if (justToggledTimeoutRef.current) clearTimeout(justToggledTimeoutRef.current);
     };
   }, []);
 
-  // Grade group state. Called unconditionally (React rules-of-hooks) even when
-  // sections.colorGrading is false — unlike the legacy ColorGradingSection,
-  // which is only mounted when the section is active, PropertyPanelFlat is not
-  // remounted per-section so the hook must run every render. Shares one state
-  // object between the group's header accessory (compare/status/reset) and its
-  // body (the FlatColorGradingSection controls).
   const colorGradingController = useColorGradingController({
     projectId,
     element,
@@ -281,9 +252,7 @@ export function PropertyPanelFlat({
   const isTextEditable = isTextEditableSelection(element);
   const elementKind = sections.media ? "media" : element.textFields.length > 0 ? "text" : "other";
   const toggleOpen = (groupId: string) => {
-    // Capture what was open BEFORE this click (this render's closure over
-    // openGroupId), so the group that's about to be implicitly closed can be
-    // tracked too — not just the one the user clicked.
+    const isOpening = openGroupId !== groupId;
     const previousOpenGroupId = openGroupId;
     setOpenGroupId((current) => (current === groupId ? "" : groupId));
     const implicitlyClosedId =
@@ -291,34 +260,20 @@ export function PropertyPanelFlat({
     setJustToggledIds(implicitlyClosedId ? [groupId, implicitlyClosedId] : [groupId]);
     if (justToggledTimeoutRef.current) clearTimeout(justToggledTimeoutRef.current);
     justToggledTimeoutRef.current = setTimeout(() => setJustToggledIds([]), 200);
+    if (isOpening) {
+      requestAnimationFrame(() =>
+        panelBodyRef.current
+          ?.querySelector<HTMLElement>('[data-flat-group-open="true"]')
+          ?.scrollIntoView?.({ block: "start" }),
+      );
+    }
   };
-  // Basis for the Layout keyframe gutter (X/Y/W/H/Angle + 3D Transform) —
-  // must agree with Motion's Timing row (FlatTimingRow), which infers the
-  // range from animations when there's no explicit data-duration. Computed
-  // here (not threaded from PropertyPanel) both to keep that file under its
-  // 600-LOC gate and because element/gsapAnimations are already in scope.
   const { start: elStart, duration: elDuration } = deriveElementTiming(element, gsapAnimations);
-  // Trivial percentage→time seek, derived here rather than threaded from
-  // PropertyPanel (keeps that file under its 600-LOC gate).
   const seekFromKfPct = (pct: number) => onSeekToTime?.(elStart + (pct / 100) * elDuration);
-  // Playhead position within the SAME corrected elStart/elDuration basis as
-  // seekFromKfPct above — recomputed here (not threaded as `currentPct` from
-  // PropertyPanel, which still derives it against its own naive basis for the
-  // legacy panel) so KeyframeNavigation's diamond active-state and prev/next
-  // arrow targeting agree with where a keyframe click actually seeks to
-  // (follow-up fix to 684ec4e87, which corrected the seek basis but left this
-  // one still naive).
+  // Use the same timing basis for seeking and active keyframe state.
   const currentPct = elDuration > 0 ? ((currentTime - elStart) / elDuration) * 100 : 0;
 
-  // Motion group double-gate — reproduces the legacy PropertyPanel gate exactly:
-  //  • Timing (sections.timing) shows via resolveEditingSections, same as today.
-  //  • The effect-card list shows only when STUDIO_GSAP_PANEL_ENABLED is on AND
-  //    all five edit handlers are present (identical to PropertyPanel's legacy
-  //    `<GsapAnimationSection>` guard).
-  // Computing the narrowed handler bundle inside the `&&`-guarded ternary lets
-  // TypeScript prove each handler non-undefined without a `!` assertion; the
-  // noop bundle only fills the type when the gate is off (never invoked, since
-  // FlatMotionSection guards every call behind showEffects).
+  // Match the legacy Motion gate while preserving TypeScript narrowing.
   const showMotionTiming = Boolean(sections.timing);
   const gsapEffectHandlers =
     STUDIO_GSAP_PANEL_ENABLED &&
@@ -347,9 +302,6 @@ export function PropertyPanelFlat({
   const showMotionEffects = gsapEffectHandlers !== null;
   const showMotionGroup = showMotionTiming || showMotionEffects;
 
-  // Ordered group descriptors — one per FlatGroup this panel renders, gated by
-  // the same conditions the inline JSX used. Split below into before-open/
-  // open/after-open regions for the one-open accordion.
   const groups: FlatGroupDescriptor[] = [];
   if (isTextEditable) {
     groups.push({
@@ -372,8 +324,6 @@ export function PropertyPanelFlat({
     });
   }
   if (showEditableSections) {
-    // Number.isFinite guard (not `|| 1`): opacity 0 is a real value — an
-    // invisible element must summarize as 0%, not 100%.
     const opacityValue = parseFloat(styles.opacity ?? "1");
     const opacityPct = Math.round((Number.isFinite(opacityValue) ? opacityValue : 1) * 100);
     groups.push({
@@ -398,8 +348,6 @@ export function PropertyPanelFlat({
     groups.push({
       id: "layout",
       title: "Layout",
-      // No scrub accessory: FlatRow/CommitField has no pointer-drag scrubbing
-      // (wheel/arrow keys only) — advertising "drag values to scrub" here lies.
       summary: `${formatPxMetricValue(displayX)},${formatPxMetricValue(displayY)} · ${Math.round(displayW)}×${Math.round(displayH)}`,
       content: (
         <FlatLayoutSection
@@ -470,15 +418,56 @@ export function PropertyPanelFlat({
           assets={assets}
           onImportAssets={onImportAssets}
           onCommitColorGrading={colorGradingController.commitColorGrading}
+          onPreviewColorGrading={colorGradingController.previewColorGrading}
           applyScope={colorGradingController.applyScope}
           applyBusy={colorGradingController.applyBusy}
           onSetApplyScope={colorGradingController.setApplyScope}
           onApplyToScope={() => void colorGradingController.applyToScope()}
           onApplyScopeAvailable={Boolean(onApplyColorGradingScope)}
           mediaMetadata={colorGradingController.mediaMetadata}
+          presetPreviews={colorGradingController.presetPreviews}
+          onRequestPresetPreviews={colorGradingController.requestPresetPreviews}
+        />
+      ),
+    });
+    const activeEffects = activeColorGradingEffectCount(colorGradingController.grading);
+    const effectsProps = {
+      grading: colorGradingController.grading,
+      onCommitColorGrading: colorGradingController.commitColorGrading,
+    };
+    groups.push({
+      id: "effects",
+      title: "Effects",
+      accessory: <FlatEffectsAccessory {...effectsProps} />,
+      summary: activeEffects ? `${activeEffects} active` : "none",
+      content: (
+        <FlatEffectsSection
+          {...effectsProps}
+          previews={colorGradingController.effectPreviews}
+          presetPreviews={colorGradingController.presetPreviews}
+          onPreviewColorGrading={colorGradingController.previewColorGrading}
+          onRequestEffectPreviews={colorGradingController.requestEffectPreviews}
+          onRequestPresetPreviews={colorGradingController.requestPresetPreviews}
         />
       ),
     });
+    if (onAddMediaOverlay) {
+      groups.push({
+        id: "overlays",
+        title: "Overlays",
+        summary: "add layer",
+        content: (
+          <FlatOverlaysSection
+            onAddOverlay={(blockName) =>
+              onAddMediaOverlay(
+                blockName,
+                deriveMediaOverlayPlacement(element, { start: elStart, duration: elDuration }),
+              )
+            }
+          />
+        ),
+      });
+    }
   }
   if (sections.media) {
     groups.push({
@@ -499,13 +488,6 @@ export function PropertyPanelFlat({
     });
   }
 
-  // Fixed-headers + scrollable-open-section layout (design_handoff
-  // scrollable-open-section, replaces the prior sticky-stacking mechanism):
-  // collapsed headers before/after the open group render in normal document
-  // flow and never move. Only the open group's own body content scrolls, in
-  // a dedicated region between the two fixed header stacks. When no group is
-  // open, every group is just a collapsed header — there's no scrollable
-  // middle region at all, since nothing is expanded.
   const openIndex = groups.findIndex((g) => g.id === openGroupId);
   const beforeOpen = openIndex === -1 ? groups : groups.slice(0, openIndex);
   const openGroup = openIndex === -1 ? null : groups[openIndex];
@@ -532,7 +514,11 @@ export function PropertyPanelFlat({
             showUngroup={Boolean(onUngroup && element.dataAttributes["hf-group"] != null)}
           />
         </DesignPanelInputProvider>
-        <div data-flat-panel-body="true" className="flex min-h-0 flex-1 flex-col overflow-y-auto">
+        <div
+          ref={panelBodyRef}
+          data-flat-panel-body="true"
+          className="flex min-h-0 flex-1 flex-col overflow-y-auto"
+        >
           {beforeOpen.map((g) => (
             <DesignPanelInputProvider key={g.id} section={slugifyDesignInput(g.title)}>
               <FlatGroupHeader
@@ -546,7 +532,7 @@ export function PropertyPanelFlat({
           ))}
           {openGroup && (
             <DesignPanelInputProvider section={slugifyDesignInput(openGroup.title)}>
-              <div data-flat-group-open="true" className="flex min-h-0 flex-1 flex-col">
+              <div data-flat-group-open="true" className="flex min-h-[180px] flex-none flex-col">
                 <FlatGroupHeader
                   title={openGroup.title}
                   isOpen
diff --git a/packages/studio/src/components/editor/colorGradingScopePatch.test.ts b/packages/studio/src/components/editor/colorGradingScopePatch.test.ts
index caedd802ae..437ce6b989 100644
--- a/packages/studio/src/components/editor/colorGradingScopePatch.test.ts
+++ b/packages/studio/src/components/editor/colorGradingScopePatch.test.ts
@@ -5,15 +5,15 @@ describe("patchMediaColorGradingInHtml", () => {
   it("adds color grading to video and image tags only", () => {
     const { html, count } = patchMediaColorGradingInHtml(
       `<div><video id="v"></video><img id="i" /><audio id="a"></audio></div>`,
-      `{"preset":"warm-daylight"}`,
+      `{"preset":"clean-studio"}`,
     );
 
     expect(count).toBe(2);
     expect(html).toContain(
-      `video id="v" data-color-grading="{&quot;preset&quot;:&quot;warm-daylight&quot;}"`,
+      `video id="v" data-color-grading="{&quot;preset&quot;:&quot;clean-studio&quot;}"`,
     );
     expect(html).toContain(
-      `img id="i" data-color-grading="{&quot;preset&quot;:&quot;warm-daylight&quot;}"`,
+      `img id="i" data-color-grading="{&quot;preset&quot;:&quot;clean-studio&quot;}"`,
     );
     expect(html).toContain(`<audio id="a"></audio>`);
   });
diff --git a/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx b/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx
index b2030f9c0d..92e2b29c83 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.test.tsx
@@ -215,39 +215,98 @@ function neutralPropsBase() {
     grading: neutralGrading(),
     assets: [] as string[],
     onCommitColorGrading: vi.fn(),
+    onPreviewColorGrading: vi.fn(),
     applyScope: "source-file" as const,
     applyBusy: false,
     onSetApplyScope: vi.fn(),
     onApplyToScope: vi.fn(),
     onApplyScopeAvailable: true,
     mediaMetadata: null,
+    presetPreviews: {
+      status: "ready" as const,
+      images: { "bright-pop": "data:image/png;base64,bright" },
+      width: 160,
+      height: 90,
+    },
+    onRequestPresetPreviews: vi.fn(),
   };
 }
 
 describe("FlatColorGradingSection — Preset + LUT", () => {
-  it("renders the Preset dropdown with id/label pairs and fires onCommitColorGrading on change", () => {
+  it("previews looks without committing, restores on leave, and commits only on click", () => {
     const onCommitColorGrading = vi.fn();
+    const onPreviewColorGrading = vi.fn();
+    const base = neutralGrading();
+    const grading = {
+      ...base,
+      intensity: 0.4,
+      adjust: { ...base.adjust, contrast: 0.3 },
+      details: { ...base.details, vignette: 0.2 },
+      effects: { ...base.effects, pixelate: 0.5 },
+      palette: ["#112233", "#ffffff"],
+      lut: { src: "assets/luts/custom.cube", intensity: 0.6 },
+    };
     const { host, root } = renderInto(
       <FlatColorGradingSection
         {...neutralPropsBase()}
+        grading={grading}
         onCommitColorGrading={onCommitColorGrading}
+        onPreviewColorGrading={onPreviewColorGrading}
       />,
     );
-    const presetSelect = host.querySelector<HTMLSelectElement>(
-      '[data-flat-grade-preset="true"] select',
+    const brightPop = host.querySelector<HTMLButtonElement>(
+      '[data-flat-grade-preset="bright-pop"]',
     );
-    if (!presetSelect) throw new Error("expected a preset select");
-    expect(presetSelect.value).toBe("neutral");
-    // The visible "Preset" label is a sibling span outside FlatSelectRow
-    // (label="" there, to avoid rendering it twice) — the select still
-    // needs its own accessible name via the dedicated ariaLabel prop.
-    expect(presetSelect.getAttribute("aria-label")).toBe("Preset");
+    if (!brightPop) throw new Error("expected a Bright Pop look button");
     act(() => {
-      presetSelect.value = "bright-pop";
-      presetSelect.dispatchEvent(new Event("change", { bubbles: true }));
+      brightPop.dispatchEvent(new MouseEvent("pointerover", { bubbles: true }));
     });
+    expect(onPreviewColorGrading.mock.calls.at(-1)?.[0].preset).toBe("bright-pop");
+    expect(onPreviewColorGrading.mock.calls.at(-1)?.[1]).toEqual({
+      animatedPreview: { kind: "presets", id: "bright-pop" },
+    });
+    expect(onCommitColorGrading).not.toHaveBeenCalled();
+    act(() => brightPop.dispatchEvent(new MouseEvent("pointerout", { bubbles: true })));
+    expect(onPreviewColorGrading).toHaveBeenLastCalledWith(null);
+    act(() => brightPop.dispatchEvent(new MouseEvent("click", { bubbles: true })));
     expect(onCommitColorGrading).toHaveBeenCalledTimes(1);
-    expect(onCommitColorGrading.mock.calls[0][0].preset).toBe("bright-pop");
+    expect(onCommitColorGrading.mock.calls[0][0]).toMatchObject({
+      preset: "bright-pop",
+      intensity: 1,
+      effects: { pixelate: 0.5 },
+      palette: ["#112233", "#ffffff"],
+      lut: { src: "assets/luts/custom.cube", intensity: 0.6 },
+    });
+    expect(onCommitColorGrading.mock.calls[0][0].adjust.contrast).not.toBe(0.3);
+    expect(onCommitColorGrading.mock.calls[0][0].details.vignette).not.toBe(0.2);
+    act(() => root.unmount());
+  });
+
+  it("keeps effect-bearing saved styles out of Grade", () => {
+    const { host, root } = renderInto(<FlatColorGradingSection {...neutralPropsBase()} />);
+    const presets = host.querySelector('[data-flat-grade-preset-group="presets"]');
+    expect(presets?.querySelector('[data-flat-grade-preset="bright-pop"]')).not.toBeNull();
+    expect(presets?.querySelector('[data-flat-grade-preset="vhs-playback"]')).toBeNull();
+    expect(presets?.querySelector('[data-flat-grade-preset="editorial-halftone"]')).toBeNull();
+    expect(host.querySelector('[data-flat-grade-preset="neutral"]')?.textContent).toContain(
+      "Neutral",
+    );
+    act(() => root.unmount());
+  });
+
+  it("shows exact selected-media preview images and requests a fresh batch on mount", () => {
+    const onRequestPresetPreviews = vi.fn();
+    const { host, root } = renderInto(
+      <FlatColorGradingSection
+        {...neutralPropsBase()}
+        onRequestPresetPreviews={onRequestPresetPreviews}
+      />,
+    );
+    expect(onRequestPresetPreviews).toHaveBeenCalledTimes(1);
+    expect(
+      host.querySelector<HTMLImageElement>('[data-flat-grade-preview="bright-pop"]')?.src,
+    ).toContain("data:image/png;base64,bright");
+    expect(host.textContent).not.toContain("VHS Playback");
     act(() => root.unmount());
   });
 
@@ -410,7 +469,7 @@ describe("FlatColorGradingSection — Adjust sliders", () => {
     act(() => root.unmount());
   });
 
-  it("does NOT force intensity to revive when the Strength slider itself is dragged — it writes the value directly", () => {
+  it("does NOT force intensity to revive when the Amount slider itself is dragged — it writes the value directly", () => {
     const onCommitColorGrading = vi.fn();
     const grading = { ...neutralGrading(), intensity: 0 };
     const { host, root } = renderInto(
@@ -420,7 +479,7 @@ describe("FlatColorGradingSection — Adjust sliders", () => {
         onCommitColorGrading={onCommitColorGrading}
       />,
     );
-    const strengthRow = findRowByText(host, "div", "Strength", "startsWith");
+    const strengthRow = findRowByText(host, "div", "Amount", "startsWith");
     // min=0, max=100, step=1, ratio=0.4 -> raw=40 -> commit(40) -> intensity = 40/100 = 0.4
     dragSliderTrack(strengthRow, 40, 100);
     expect(onCommitColorGrading).toHaveBeenCalledTimes(1);
@@ -492,32 +551,6 @@ describe("FlatColorGradingSection — Vignette and Grain", () => {
   });
 });
 
-describe("FlatColorGradingSection — Effects", () => {
-  it("renders Blur and Pixelate sliders under an Effects micro-label", () => {
-    const { host, root } = renderInto(<FlatColorGradingSection {...neutralPropsBase()} />);
-    expect(host.textContent).toContain("Effects");
-    const rows = host.querySelectorAll('[data-flat-grade-effect="true"]');
-    expect(rows).toHaveLength(2);
-    act(() => root.unmount());
-  });
-
-  it("commits a dragged Pixelate value on slider track pointerdown, scaled from percent to the 0..1 effect range", () => {
-    const onCommitColorGrading = vi.fn();
-    const { host, root } = renderInto(
-      <FlatColorGradingSection
-        {...neutralPropsBase()}
-        onCommitColorGrading={onCommitColorGrading}
-      />,
-    );
-    const pixelateRow = findRowByText(host, '[data-flat-grade-effect="true"]', "Pixelate");
-    // min=0, max=100, step=1, ratio=0.75 -> raw=75 -> commit(75) -> effects.pixelate = 75/100 = 0.75
-    dragSliderTrack(pixelateRow, 75, 100);
-    expect(onCommitColorGrading).toHaveBeenCalledTimes(1);
-    expect(onCommitColorGrading.mock.calls[0][0].effects.pixelate).toBe(0.75);
-    act(() => root.unmount());
-  });
-});
-
 describe("FlatColorGradingSection — HDR banner and Apply scope", () => {
   it("shows the HDR banner only when mediaMetadata reports an HDR source", () => {
     const { host, root } = renderInto(
diff --git a/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.tsx
index a124f70cdb..7a7348cf9a 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatColorGradingSection.tsx
@@ -1,19 +1,23 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import {
-  HF_COLOR_GRADING_PRESETS,
+  HF_COLOR_GRADING_GRADE_PRESETS,
   isHfColorGradingActive,
   normalizeHfColorGrading,
   type HfColorGradingAdjustKey,
   type HfColorGradingDetailKey,
-  type HfColorGradingEffectKey,
   type NormalizedHfColorGrading,
 } from "@hyperframes/core/color-grading";
 import { Compare, Plus, RotateCcw, Settings } from "../../icons/SystemIcons";
 import { useTrackDesignInput } from "../../contexts/DesignPanelInputContext";
 import { LUT_EXT } from "../../utils/mediaTypes";
-import { FlatSelectRow, FlatSlider } from "./propertyPanelFlatPrimitives";
-import { resolveValueTier } from "./propertyPanelValueTier";
-import type { ColorGradingControllerState, MediaMetadata } from "./useColorGradingController";
+import { FLAT_PREVIEW_GRID, FlatSlider } from "./propertyPanelFlatPrimitives";
+import type {
+  ColorGradingControllerState,
+  ColorGradingPresetPreviews,
+  ColorGradingPreviewOptions,
+  MediaMetadata,
+} from "./useColorGradingController";
+import { presetPreviewHandlers } from "./propertyPanelPresetPreview";
 
 const STATUS_DOT_CLASS: Record<ColorGradingControllerState["runtimeStatus"]["state"], string> = {
   active: "bg-emerald-400",
@@ -123,8 +127,6 @@ export function FlatColorGradingAccessory({
   );
 }
 
-const PRESET_OPTIONS = HF_COLOR_GRADING_PRESETS.map((p) => ({ value: p.id, label: p.label }));
-
 const ADJUST_SLIDERS: Array<{
   key: HfColorGradingAdjustKey;
   label: string;
@@ -182,11 +184,6 @@ const VIGNETTE_TUNE_KEYS: HfColorGradingDetailKey[] = [
 ];
 const GRAIN_TUNE_KEYS: HfColorGradingDetailKey[] = ["grainSize", "grainRoughness"];
 
-const EFFECT_SLIDERS: Array<{ key: HfColorGradingEffectKey; label: string }> = [
-  { key: "blur", label: "Blur" },
-  { key: "pixelate", label: "Pixelate" },
-];
-
 function HdrBanner({ metadata }: { metadata: MediaMetadata | null }) {
   if (metadata?.color.dynamicRange !== "hdr") return null;
   const details = [
@@ -231,23 +228,32 @@ export function FlatColorGradingSection({
   assets,
   onImportAssets,
   onCommitColorGrading,
+  onPreviewColorGrading,
   applyScope,
   applyBusy,
   onSetApplyScope,
   onApplyToScope,
   onApplyScopeAvailable,
   mediaMetadata,
+  presetPreviews,
+  onRequestPresetPreviews,
 }: {
   grading: NormalizedHfColorGrading;
   assets: string[];
   onImportAssets?: (files: FileList, dir?: string) => Promise<string[]>;
   onCommitColorGrading: (next: NormalizedHfColorGrading) => void;
+  onPreviewColorGrading: (
+    next: NormalizedHfColorGrading | null,
+    options?: ColorGradingPreviewOptions,
+  ) => void;
   applyScope: "source-file" | "project";
   applyBusy: boolean;
   onSetApplyScope: (scope: "source-file" | "project") => void;
   onApplyToScope: () => void;
   onApplyScopeAvailable: boolean;
   mediaMetadata: MediaMetadata | null;
+  presetPreviews: ColorGradingPresetPreviews;
+  onRequestPresetPreviews: () => void;
 }) {
   const track = useTrackDesignInput();
   const lutInputRef = useRef<HTMLInputElement>(null);
@@ -260,10 +266,21 @@ export function FlatColorGradingSection({
   const lut = grading.lut;
   const selectedLutName = lut?.src ? (lut.src.split("/").pop() ?? lut.src) : null;
 
-  const applyPreset = (presetId: string) => {
-    const next = normalizeHfColorGrading({ preset: presetId, intensity: 1, lut: grading.lut });
-    if (next) onCommitColorGrading(next);
+  useEffect(() => {
+    if (
+      presetPreviews.status !== "loading" &&
+      HF_COLOR_GRADING_GRADE_PRESETS.some((preset) => !presetPreviews.images[preset.id])
+    ) {
+      onRequestPresetPreviews();
+    }
+  }, [onRequestPresetPreviews, presetPreviews.images, presetPreviews.status]);
+
+  const resolvePreset = (presetId: string) => {
+    const resolved = normalizeHfColorGrading({ preset: presetId, lut: grading.lut });
+    return resolved ? { ...resolved, effects: grading.effects, palette: grading.palette } : grading;
   };
+
+  useEffect(() => () => onPreviewColorGrading(null), [onPreviewColorGrading]);
   const updateIntensity = (value: number) => {
     onCommitColorGrading({ ...grading, intensity: value / 100 });
   };
@@ -319,22 +336,60 @@ export function FlatColorGradingSection({
   return (
     <div className="space-y-1.5">
       <HdrBanner metadata={mediaMetadata} />
-      <div data-flat-grade-preset="true" className="flex min-h-[30px] items-center justify-between">
-        <span className="text-[11px] text-panel-text-2">Preset</span>
-        <FlatSelectRow
-          label=""
-          ariaLabel="Preset"
-          value={grading.preset ?? "neutral"}
-          options={PRESET_OPTIONS}
-          tier={resolveValueTier(
-            grading.preset === "neutral" ? undefined : (grading.preset ?? undefined),
-            "neutral",
-          )}
-          onChange={applyPreset}
-        />
+      <div data-flat-grade-presets="true" className="space-y-1.5">
+        <div data-flat-grade-preset-group="presets" className={FLAT_PREVIEW_GRID}>
+          {HF_COLOR_GRADING_GRADE_PRESETS.map((preset) => {
+            const label = preset.label;
+            const selected = grading.preset === preset.id;
+            const preview = presetPreviews.images[preset.id];
+            return (
+              <button
+                key={preset.id}
+                type="button"
+                data-flat-grade-preset={preset.id}
+                aria-pressed={selected}
+                {...presetPreviewHandlers({
+                  id: preset.id,
+                  label,
+                  resolve: () => resolvePreset(preset.id),
+                  onPreview: onPreviewColorGrading,
+                  onCommit: onCommitColorGrading,
+                  onTrack: (name) => track("button", `Apply ${name}`),
+                })}
+                className={`min-w-0 overflow-hidden border text-left text-[10px] transition-colors ${
+                  selected
+                    ? "border-panel-accent bg-panel-accent/10 text-panel-text-0"
+                    : "border-panel-hairline bg-panel-bg-soft text-panel-text-3 hover:border-panel-border-input hover:text-panel-text-1"
+                }`}
+              >
+                <span
+                  data-flat-grade-preview-frame={preset.id}
+                  className="flex w-full items-center justify-center overflow-hidden bg-black/20"
+                  style={{ aspectRatio: `${presetPreviews.width} / ${presetPreviews.height}` }}
+                >
+                  {preview ? (
+                    <img
+                      data-flat-grade-preview={preset.id}
+                      src={preview}
+                      alt=""
+                      draggable={false}
+                      className="block h-full w-full object-contain"
+                    />
+                  ) : (
+                    <span
+                      data-flat-grade-preview-placeholder={presetPreviews.status}
+                      className="h-full w-full bg-panel-bg-soft"
+                    />
+                  )}
+                </span>
+                <span className="block truncate px-2 py-1.5">{label}</span>
+              </button>
+            );
+          })}
+        </div>
       </div>
       <FlatSlider
-        label="Strength"
+        label="Amount"
         value={Math.round(grading.intensity * 100)}
         min={0}
         max={100}
@@ -462,7 +517,7 @@ export function FlatColorGradingSection({
 
       <div className="space-y-1.5 border-t border-panel-hairline pt-1.5">
         <div className="mb-1 text-[9px] font-semibold uppercase tracking-[0.12em] text-panel-text-5">
-          Finishing
+          Finish
         </div>
         <div className="flex items-center gap-1.5">
           <div className="flex-1">{renderDetailSlider("vignette")}</div>
@@ -497,42 +552,6 @@ export function FlatColorGradingSection({
         )}
       </div>
 
-      <div className="space-y-0.5 border-t border-panel-hairline pt-1.5">
-        <div className="mb-1 text-[9px] font-semibold uppercase tracking-[0.12em] text-panel-text-5">
-          Effects
-        </div>
-        {EFFECT_SLIDERS.map((slider) => {
-          const value = grading.effects[slider.key];
-          const isSet = value > 1e-6;
-          return (
-            <div key={slider.key} data-flat-grade-effect="true">
-              <FlatSlider
-                label={slider.label}
-                value={Math.round(value * 100)}
-                min={0}
-                max={100}
-                tier={isSet ? "explicitCustom" : "default"}
-                displayValue={`${Math.round(value * 100)}%`}
-                onCommit={(next) =>
-                  onCommitColorGrading({
-                    ...grading,
-                    intensity: visibleIntensity(grading),
-                    effects: { ...grading.effects, [slider.key]: next / 100 },
-                  })
-                }
-                onReset={() =>
-                  onCommitColorGrading({
-                    ...grading,
-                    intensity: visibleIntensity(grading),
-                    effects: { ...grading.effects, [slider.key]: 0 },
-                  })
-                }
-              />
-            </div>
-          );
-        })}
-      </div>
-
       {onApplyScopeAvailable && (
         <div className="flex items-center justify-between gap-2 border-t border-panel-hairline pt-1.5">
           <span className="flex items-center gap-1.5 text-[11px] text-panel-text-2">
diff --git a/packages/studio/src/components/editor/propertyPanelFlatEffectControl.tsx b/packages/studio/src/components/editor/propertyPanelFlatEffectControl.tsx
new file mode 100644
index 0000000000..c4d0aca67a
--- /dev/null
+++ b/packages/studio/src/components/editor/propertyPanelFlatEffectControl.tsx
@@ -0,0 +1,96 @@
+import {
+  HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS,
+  type HfColorGradingEffectKey,
+  type NormalizedHfColorGrading,
+} from "@hyperframes/core/color-grading";
+import { FlatSelectRow } from "./propertyPanelFlatSelectRow";
+import { FlatSlider } from "./propertyPanelFlatPrimitives";
+import { FlatToggle } from "./propertyPanelFlatToggle";
+import {
+  DEFAULT_EFFECTS,
+  type EffectControl,
+  type EffectSpec,
+} from "./propertyPanelFlatEffectSpecs";
+
+type CommitEffect = (key: HfColorGradingEffectKey, value: number) => void;
+
+function defaultValueFor(control: EffectControl, effect: EffectSpec): number {
+  return (
+    HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS[effect.key][control.key] ?? DEFAULT_EFFECTS[control.key]
+  );
+}
+
+function EffectSliderControl({
+  control,
+  value,
+  defaultValue,
+  onCommit,
+}: {
+  control: Extract<EffectControl, { kind: "slider" }>;
+  value: number;
+  defaultValue: number;
+  onCommit: CommitEffect;
+}) {
+  const scale = control.scale ?? 100;
+  const sliderValue = value * scale;
+  const displayValue = control.format
+    ? control.format(value)
+    : `${Number.isInteger(sliderValue) ? sliderValue : sliderValue.toFixed(1)}${control.unit ?? "%"}`;
+  return (
+    <FlatSlider
+      label={control.label}
+      value={sliderValue}
+      min={control.min ?? 0}
+      max={control.max ?? 100}
+      step={control.step ?? 1}
+      tier={Math.abs(value - defaultValue) > 0.0001 ? "explicitCustom" : "default"}
+      displayValue={displayValue}
+      onCommit={(next) => onCommit(control.key, next / scale)}
+      onReset={() => onCommit(control.key, defaultValue)}
+    />
+  );
+}
+
+export function FlatEffectControl({
+  control,
+  effect,
+  effects,
+  onCommit,
+}: {
+  control: EffectControl;
+  effect: EffectSpec;
+  effects: NormalizedHfColorGrading["effects"];
+  onCommit: CommitEffect;
+}) {
+  const value = effects[control.key];
+  const defaultValue = defaultValueFor(control, effect);
+  if (control.kind === "toggle") {
+    return (
+      <FlatToggle
+        label={control.label}
+        checked={value >= 0.5}
+        onChange={(next) => onCommit(control.key, next ? 1 : 0)}
+      />
+    );
+  }
+  if (control.kind === "select") {
+    return (
+      <FlatSelectRow
+        label={control.label}
+        value={String(Math.round(value))}
+        options={control.options}
+        tier={value === defaultValue ? "default" : "explicitCustom"}
+        onChange={(next) => onCommit(control.key, Number.parseInt(next, 10))}
+        onReset={() => onCommit(control.key, defaultValue)}
+      />
+    );
+  }
+  return (
+    <EffectSliderControl
+      control={control}
+      value={value}
+      defaultValue={defaultValue}
+      onCommit={onCommit}
+    />
+  );
+}
diff --git a/packages/studio/src/components/editor/propertyPanelFlatEffectSpecs.ts b/packages/studio/src/components/editor/propertyPanelFlatEffectSpecs.ts
new file mode 100644
index 0000000000..45e4d76de3
--- /dev/null
+++ b/packages/studio/src/components/editor/propertyPanelFlatEffectSpecs.ts
@@ -0,0 +1,305 @@
+import {
+  getHfColorGradingCapabilities,
+  normalizeHfColorGrading,
+  type HfColorGradingActiveEffectKey,
+  type HfColorGradingEffectKey,
+  type HfColorGradingPresetId,
+} from "@hyperframes/core/color-grading";
+
+type SliderControl = {
+  kind: "slider";
+  key: HfColorGradingEffectKey;
+  label: string;
+  min?: number;
+  max?: number;
+  step?: number;
+  scale?: number;
+  unit?: string;
+  format?: (value: number) => string;
+};
+
+export type EffectControl =
+  | SliderControl
+  | { kind: "toggle"; key: HfColorGradingEffectKey; label: string }
+  | {
+      kind: "select";
+      key: HfColorGradingEffectKey;
+      label: string;
+      options: Array<{ value: string; label: string }>;
+    };
+
+export type EffectSpec = {
+  key: HfColorGradingActiveEffectKey;
+  label: string;
+  showMaster?: false;
+  masterLabel?: string;
+  masterFormat?: (value: number) => string;
+  max?: number;
+  settings?: readonly EffectControl[];
+  palette?: "mono" | "art";
+};
+
+type EffectGroup = {
+  label: string;
+  effects: readonly EffectSpec[];
+  presets?: readonly HfColorGradingPresetId[];
+};
+
+const EFFECT_CONTROL_LIMITS = new Map(
+  getHfColorGradingCapabilities().effects.flatMap((effect) =>
+    effect.controls.map((control) => [control.key, control] as const),
+  ),
+);
+
+function controlRange(key: HfColorGradingEffectKey, scale: number) {
+  const control = EFFECT_CONTROL_LIMITS.get(key);
+  return control ? { min: control.min * scale, max: control.max * scale, scale } : { scale };
+}
+
+const percent = (key: HfColorGradingEffectKey, label: string): SliderControl => ({
+  kind: "slider",
+  key,
+  label,
+  ...controlRange(key, 100),
+});
+
+const degrees = (key: HfColorGradingEffectKey, label: string, max: number): SliderControl => ({
+  kind: "slider",
+  key,
+  label,
+  ...controlRange(key, max),
+  unit: "deg",
+});
+
+function enumOptions(key: HfColorGradingEffectKey, labels: readonly string[]) {
+  const control = EFFECT_CONTROL_LIMITS.get(key);
+  const first = control?.min ?? 0;
+  const count = (control?.max ?? labels.length - 1) - first + 1;
+  if (labels.length !== count) throw new Error(`${key} labels do not match Core capabilities`);
+  return labels.map((label, index) => ({ value: String(first + index), label }));
+}
+
+const ASCII_STYLES = enumOptions("asciiStyle", [
+  "Standard",
+  "Dense",
+  "Minimal",
+  "Blocks",
+  "Braille",
+  "Technical",
+  "Matrix",
+  "Hatching",
+]);
+
+const SCREEN_SHAPES = enumOptions("monoScreenShape", [
+  "Circle",
+  "Square",
+  "Diamond",
+  "Triangle",
+  "Line",
+]);
+
+export const EFFECT_GROUPS: readonly EffectGroup[] = [
+  {
+    label: "Essentials",
+    effects: [
+      {
+        key: "blur",
+        label: "Blur",
+        masterLabel: "Radius",
+        masterFormat: (value) => `${(0.75 + Math.pow(value, 1.35) * 32).toFixed(1)}px`,
+      },
+      {
+        key: "pixelate",
+        label: "Pixelate",
+        masterLabel: "Cell Size",
+        masterFormat: (value) => `${Math.round(1 + value * 47)}px`,
+      },
+      {
+        key: "bloom",
+        label: "Bloom",
+        masterLabel: "Intensity",
+        max: controlRange("bloom", 100).max,
+        settings: [
+          {
+            kind: "slider",
+            key: "bloomRadius",
+            label: "Radius",
+            ...controlRange("bloomRadius", 1),
+            unit: "px",
+          },
+        ],
+      },
+    ],
+  },
+  {
+    label: "Retro & Glitch",
+    presets: ["creator-camcorder", "vhs-playback", "home-movie-8mm"],
+    effects: [
+      { key: "chromaBleed", label: "Chroma Softening", masterLabel: "Smear" },
+      {
+        key: "tapeDamage",
+        label: "Tape Damage",
+        showMaster: false,
+        settings: [
+          percent("tapeTracking", "Tracking"),
+          percent("tapeNoise", "Noise"),
+          percent("tapeSpeed", "Speed"),
+        ],
+      },
+      { key: "filmArtifacts", label: "Film Artifacts", masterLabel: "Density" },
+      {
+        key: "scanlines",
+        label: "Scanlines",
+        masterLabel: "Opacity",
+        settings: [
+          {
+            ...percent("scanlineCount", "Line Count"),
+            format: (value) => `${Math.round(50 + value * 450)}`,
+          },
+          percent("scanlineSoftness", "Softness"),
+        ],
+      },
+      { key: "crtCurvature", label: "CRT Curvature", masterLabel: "Curvature" },
+      {
+        key: "chromaticAberration",
+        label: "Channel Separation",
+        masterLabel: "Separation",
+        settings: [degrees("chromaticAngle", "Angle", 360)],
+      },
+      {
+        key: "digitalGlitch",
+        label: "Digital Glitch",
+        showMaster: false,
+        settings: [
+          percent("digitalGlitchColorSplit", "Color Split"),
+          percent("digitalGlitchLineTear", "Line Tear"),
+          percent("digitalGlitchPixelate", "Pixelation"),
+          percent("digitalGlitchBlockAmount", "Block Amount"),
+          percent("digitalGlitchBlockDisplacement", "Displacement"),
+          percent("digitalGlitchBlockOpacity", "Block Opacity"),
+          percent("digitalGlitchSpeed", "Speed"),
+        ],
+      },
+    ],
+  },
+  {
+    label: "Print",
+    presets: ["editorial-halftone", "two-ink-print"],
+    effects: [
+      {
+        key: "halftone",
+        label: "Halftone",
+        showMaster: false,
+        settings: [percent("halftoneSize", "Dot Size")],
+      },
+      {
+        key: "twoInkPrint",
+        label: "Two-Ink Print",
+        showMaster: false,
+        settings: [percent("twoInkPrintSize", "Dot Size")],
+      },
+      {
+        key: "dither",
+        label: "Ordered Dither",
+        showMaster: false,
+        palette: "mono",
+        settings: [
+          {
+            ...percent("ditherSize", "Point Size"),
+            format: (value) => `${(1 + value * 4).toFixed(1)}px`,
+          },
+        ],
+      },
+      {
+        key: "monoScreen",
+        label: "Mono Screen",
+        showMaster: false,
+        palette: "mono",
+        settings: [
+          {
+            ...percent("monoScreenSize", "Cell Size"),
+            format: (value) => `${Math.round(4 + value * 14)}px`,
+          },
+          degrees("monoScreenAngle", "Angle", 90),
+          percent("monoScreenSpread", "Spread"),
+          { kind: "select", key: "monoScreenShape", label: "Shape", options: SCREEN_SHAPES },
+          { kind: "toggle", key: "monoScreenInvert", label: "Invert" },
+        ],
+      },
+    ],
+  },
+  {
+    label: "Art",
+    effects: [
+      {
+        key: "ascii",
+        label: "ASCII",
+        showMaster: false,
+        palette: "mono",
+        settings: [
+          {
+            ...percent("asciiSize", "Character Size"),
+            format: (value) => `${Math.round(4 + value * 76)}px`,
+          },
+          { kind: "select", key: "asciiStyle", label: "Style", options: ASCII_STYLES },
+          { kind: "toggle", key: "asciiInvert", label: "Invert" },
+          { kind: "toggle", key: "asciiColor", label: "Use Source Color" },
+          percent("asciiRotation", "Edge Rotation"),
+        ],
+      },
+      {
+        key: "engraving",
+        label: "Engraving",
+        showMaster: false,
+        palette: "art",
+        settings: [
+          percent("engravingSpacing", "Spacing"),
+          percent("engravingMinThickness", "Min Thickness"),
+          percent("engravingMaxThickness", "Max Thickness"),
+          degrees("engravingAngle", "Angle", 180),
+          percent("engravingContrast", "Contrast"),
+          percent("engravingSharpness", "Sharpness"),
+          percent("engravingWave", "Wave"),
+          percent("engravingWaveFrequency", "Wave Frequency"),
+        ],
+      },
+      {
+        key: "crosshatch",
+        label: "Crosshatch",
+        showMaster: false,
+        palette: "art",
+        settings: [
+          percent("crosshatchSpacing", "Spacing"),
+          percent("crosshatchThickness", "Thickness"),
+          degrees("crosshatchAngle", "Angle", 180),
+          percent("crosshatchContrast", "Contrast"),
+          percent("crosshatchEdges", "Edge Detail"),
+          percent("crosshatchLineWeight", "Line Variation"),
+          percent("crosshatchWave", "Wave"),
+          percent("crosshatchWaveFrequency", "Wave Frequency"),
+        ],
+      },
+      {
+        key: "kuwahara",
+        label: "Kuwahara Paint",
+        showMaster: false,
+        settings: [
+          {
+            ...percent("kuwaharaRadius", "Radius"),
+            format: (value) => `${Math.round(2 + value * 14)}px`,
+          },
+          percent("kuwaharaSharpness", "Sharpness"),
+          {
+            ...percent("kuwaharaSaturation", "Saturation"),
+            format: (value) => `${Math.round(value * 200)}%`,
+          },
+        ],
+      },
+    ],
+  },
+];
+
+export const EFFECT_SPECS = EFFECT_GROUPS.flatMap((group) => group.effects);
+const DEFAULT_GRADING = normalizeHfColorGrading("neutral");
+if (!DEFAULT_GRADING) throw new Error("Missing neutral color grading preset");
+export const DEFAULT_EFFECTS = DEFAULT_GRADING.effects;
diff --git a/packages/studio/src/components/editor/propertyPanelFlatEffectsSection.test.tsx b/packages/studio/src/components/editor/propertyPanelFlatEffectsSection.test.tsx
new file mode 100644
index 0000000000..3b10d5eb11
--- /dev/null
+++ b/packages/studio/src/components/editor/propertyPanelFlatEffectsSection.test.tsx
@@ -0,0 +1,331 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import {
+  HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS,
+  HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS,
+  HF_COLOR_GRADING_PALETTES,
+  getHfColorGradingCapabilities,
+  normalizeHfColorGrading,
+} from "@hyperframes/core/color-grading";
+import {
+  activeColorGradingEffectCount,
+  FlatEffectsAccessory,
+  FlatEffectsSection,
+} from "./propertyPanelFlatEffectsSection";
+import { EFFECT_SPECS } from "./propertyPanelFlatEffectSpecs";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+afterEach(() => {
+  document.body.innerHTML = "";
+});
+
+function neutralGrading() {
+  const grading = normalizeHfColorGrading("neutral");
+  if (!grading) throw new Error("expected neutral grading");
+  return grading;
+}
+
+function renderInto(node: React.ReactElement) {
+  const host = document.body.appendChild(document.createElement("div"));
+  const root = createRoot(host);
+  act(() => root.render(node));
+  return { host, root };
+}
+
+function sectionProps(
+  grading: ReturnType<typeof neutralGrading>,
+  onCommitColorGrading: ReturnType<typeof vi.fn> = vi.fn(),
+) {
+  return {
+    grading,
+    previews: {
+      status: "ready" as const,
+      images: { pixelate: "data:image/png;base64,pixelate" },
+      width: 160,
+      height: 90,
+    },
+    presetPreviews: {
+      status: "ready" as const,
+      images: { "vhs-playback": "data:image/png;base64,vhs" },
+      width: 160,
+      height: 90,
+    },
+    onCommitColorGrading,
+    onPreviewColorGrading: vi.fn(),
+    onRequestEffectPreviews: vi.fn(),
+    onRequestPresetPreviews: vi.fn(),
+  };
+}
+
+describe("FlatEffectsSection", () => {
+  it("places missing composite treatments in their effect family without a Styles section", () => {
+    const onCommit = vi.fn();
+    const props = sectionProps(neutralGrading(), onCommit);
+    const { host, root } = renderInto(<FlatEffectsSection {...props} />);
+    expect(host.textContent).not.toContain("Styles");
+    expect(props.onRequestPresetPreviews).not.toHaveBeenCalled();
+    const retro = host.querySelector<HTMLButtonElement>(
+      '[data-flat-effect-group="Retro & Glitch"]',
+    );
+    act(() => retro?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(props.onRequestPresetPreviews).toHaveBeenCalledTimes(1);
+    expect(host.querySelector('[data-flat-effect-preset-preview="vhs-playback"]')).not.toBeNull();
+    const vhs = host.querySelector<HTMLButtonElement>('[data-flat-effect-preset="vhs-playback"]');
+    act(() => vhs?.dispatchEvent(new MouseEvent("pointerover", { bubbles: true })));
+    expect(props.onPreviewColorGrading.mock.calls.at(-1)?.[0]).toMatchObject({
+      preset: "vhs-playback",
+      effects: { tapeDamage: 0.82, scanlineCount: 0.17 },
+    });
+    expect(onCommit).not.toHaveBeenCalled();
+    act(() => vhs?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(onCommit.mock.calls[0][0].preset).toBe("vhs-playback");
+
+    const print = host.querySelector<HTMLButtonElement>('[data-flat-effect-group="Print"]');
+    act(() => print?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(host.querySelector('[data-flat-effect-preset="editorial-halftone"]')).not.toBeNull();
+    expect(host.querySelector('[data-flat-effect-preset="two-ink-print"]')).not.toBeNull();
+    act(() => root.unmount());
+  });
+
+  it("offers every shader master once in four intentional families", () => {
+    const { host, root } = renderInto(<FlatEffectsSection {...sectionProps(neutralGrading())} />);
+    const renderedKeys: Array<string | null> = [];
+    for (const label of ["Essentials", "Retro & Glitch", "Print", "Art"]) {
+      const tab = host.querySelector<HTMLButtonElement>(`[data-flat-effect-group="${label}"]`);
+      expect(tab).not.toBeNull();
+      act(() => tab?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+      renderedKeys.push(
+        ...Array.from(host.querySelectorAll("[data-flat-effect-option]"), (element) =>
+          element.getAttribute("data-flat-effect-option"),
+        ),
+      );
+    }
+    expect(renderedKeys.sort()).toEqual([...HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS].sort());
+    const capabilities = new Map(
+      getHfColorGradingCapabilities().effects.map((effect) => [effect.key, effect]),
+    );
+    for (const effect of EFFECT_SPECS) {
+      expect(Boolean(effect.palette)).toBe(capabilities.get(effect.key)?.supportsPalette);
+    }
+    expect(host.querySelectorAll('[data-flat-slider-track="true"]')).toHaveLength(0);
+    act(() => root.unmount());
+  });
+
+  it("requests exact cards and auditions a chosen default without persisting", () => {
+    const props = sectionProps(neutralGrading());
+    const { host, root } = renderInto(<FlatEffectsSection {...props} />);
+    expect(props.onRequestEffectPreviews).toHaveBeenCalledTimes(1);
+    expect(props.onRequestEffectPreviews).toHaveBeenCalledWith(["blur", "pixelate", "bloom"]);
+    expect(host.querySelector('[data-flat-effect-preview="pixelate"]')).not.toBeNull();
+    const pixelate = host.querySelector<HTMLButtonElement>('[data-flat-effect-option="pixelate"]');
+    act(() => pixelate?.dispatchEvent(new MouseEvent("pointerover", { bubbles: true })));
+    expect(props.onPreviewColorGrading.mock.calls.at(-1)?.[0].effects.pixelate).toBe(
+      HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.pixelate.pixelate,
+    );
+    expect(props.onPreviewColorGrading.mock.calls.at(-1)?.[1]).toEqual({
+      animatedPreview: { kind: "effects", id: "pixelate" },
+    });
+    expect(props.onCommitColorGrading).not.toHaveBeenCalled();
+    act(() => pixelate?.dispatchEvent(new MouseEvent("pointerout", { bubbles: true })));
+    expect(props.onPreviewColorGrading).toHaveBeenLastCalledWith(null);
+    act(() => root.unmount());
+  });
+
+  it("applies a useful canonical default when an effect is chosen", () => {
+    const onCommit = vi.fn();
+    const grading = { ...neutralGrading(), intensity: 0 };
+    const { host, root } = renderInto(<FlatEffectsSection {...sectionProps(grading, onCommit)} />);
+    const pixelate = host.querySelector<HTMLButtonElement>('[data-flat-effect-option="pixelate"]');
+    act(() => pixelate?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(onCommit).toHaveBeenCalledTimes(1);
+    expect(onCommit.mock.calls[0][0].effects.pixelate).toBe(
+      HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.pixelate.pixelate,
+    );
+    expect(onCommit.mock.calls[0][0].intensity).toBe(0);
+    act(() => root.unmount());
+  });
+
+  it("uses a complete treatment card as a fresh starting point while preserving the LUT", () => {
+    const onCommit = vi.fn();
+    const base = neutralGrading();
+    const grading = {
+      ...base,
+      adjust: { ...base.adjust, exposure: 0.4 },
+      effects: { ...base.effects, blur: 0.6 },
+      palette: ["#112233", "#ffffff"],
+      lut: { src: "assets/luts/custom.cube", intensity: 0.5 },
+    };
+    const { host, root } = renderInto(<FlatEffectsSection {...sectionProps(grading, onCommit)} />);
+    const toggle = host.querySelector<HTMLButtonElement>('[data-flat-effects-add-toggle="true"]');
+    act(() => toggle?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    const retro = host.querySelector<HTMLButtonElement>(
+      '[data-flat-effect-group="Retro & Glitch"]',
+    );
+    act(() => retro?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    const vhs = host.querySelector<HTMLButtonElement>('[data-flat-effect-preset="vhs-playback"]');
+    act(() => vhs?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    const committed = onCommit.mock.calls[0][0];
+    expect(committed).toMatchObject({
+      preset: "vhs-playback",
+      lut: { src: "assets/luts/custom.cube", intensity: 0.5 },
+    });
+    expect(committed.effects.tapeDamage).toBeGreaterThan(0);
+    expect(committed.effects.blur).toBe(0);
+    expect(committed.palette).toBeNull();
+    expect(committed.adjust.exposure).not.toBe(0.4);
+    act(() => root.unmount());
+  });
+
+  it("shows only the selected active effect controls and converts degrees to shader units", () => {
+    const onCommit = vi.fn();
+    const grading = normalizeHfColorGrading({
+      effects: HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.chromaticAberration,
+    });
+    if (!grading) throw new Error("expected chromatic grading");
+    const { host, root } = renderInto(<FlatEffectsSection {...sectionProps(grading, onCommit)} />);
+    expect(host.textContent).toContain("Angle");
+    const effect = host.querySelector('[data-flat-effect-editor="chromaticAberration"]');
+    if (!effect) throw new Error("expected chromatic effect");
+    const rows = effect.querySelectorAll('[data-flat-slider-track="true"]');
+    const angleTrack = rows[1] as HTMLElement | undefined;
+    if (!angleTrack) throw new Error("expected angle slider");
+    Object.defineProperty(angleTrack, "getBoundingClientRect", {
+      value: () => ({ left: 0, width: 100, top: 0, height: 2, right: 100, bottom: 2 }),
+    });
+    act(() => {
+      angleTrack.dispatchEvent(new MouseEvent("pointerdown", { bubbles: true, clientX: 50 }));
+      angleTrack.dispatchEvent(new MouseEvent("pointerup", { bubbles: true, clientX: 50 }));
+    });
+    expect(onCommit.mock.calls.at(-1)?.[0].effects.chromaticAngle).toBe(0.5);
+    act(() => root.unmount());
+  });
+
+  it("offers native ASCII styles, binary controls, and a bounded custom palette", () => {
+    const onCommit = vi.fn();
+    const grading = normalizeHfColorGrading({
+      effects: HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.ascii,
+    });
+    if (!grading) throw new Error("expected ASCII grading");
+    const { host, root } = renderInto(<FlatEffectsSection {...sectionProps(grading, onCommit)} />);
+    expect(
+      host.querySelector<HTMLSelectElement>('select[aria-label="Style"]')?.options,
+    ).toHaveLength(8);
+    expect(host.querySelectorAll('[data-flat-toggle="true"]')).toHaveLength(2);
+    expect(host.querySelector('[data-flat-effect-editor="ascii"]')?.textContent).not.toContain(
+      "Mix",
+    );
+    expect(host.querySelectorAll("[data-flat-effects-palette-preset]")).toHaveLength(
+      HF_COLOR_GRADING_PALETTES.length,
+    );
+    const synthwave = host.querySelector<HTMLButtonElement>(
+      '[data-flat-effects-palette-preset="synthwave"]',
+    );
+    act(() => synthwave?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(onCommit.mock.calls.at(-1)?.[0].palette).toEqual(
+      HF_COLOR_GRADING_PALETTES.find(({ id }) => id === "synthwave")?.colors,
+    );
+    const addPalette = host.querySelector<HTMLButtonElement>(
+      '[data-flat-effects-add-palette="true"]',
+    );
+    act(() => addPalette?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(onCommit.mock.calls.at(-1)?.[0].palette).toEqual(["#000000", "#ffffff"]);
+    act(() => root.unmount());
+  });
+
+  it("resets the selected effect to its authored defaults", () => {
+    const onCommit = vi.fn();
+    const grading = normalizeHfColorGrading({
+      effects: { ...HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.digitalGlitch, digitalGlitch: 0.9 },
+    });
+    if (!grading) throw new Error("expected digital glitch grading");
+    const { host, root } = renderInto(<FlatEffectsSection {...sectionProps(grading, onCommit)} />);
+    expect(
+      host.querySelector('[data-flat-effect-editor="digitalGlitch"]')?.textContent,
+    ).not.toContain("Mix");
+    const reset = host.querySelector<HTMLButtonElement>('[title="Reset Digital Glitch"]');
+    act(() => reset?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(onCommit.mock.calls.at(-1)?.[0].effects).toMatchObject(
+      HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.digitalGlitch,
+    );
+    act(() => root.unmount());
+  });
+
+  it("removes only the selected effect and preserves another active effect", () => {
+    const onCommit = vi.fn();
+    const grading = normalizeHfColorGrading({
+      effects: {
+        ...HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.blur,
+        ...HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.pixelate,
+      },
+    });
+    if (!grading) throw new Error("expected multi-effect grading");
+    const { host, root } = renderInto(<FlatEffectsSection {...sectionProps(grading, onCommit)} />);
+    const remove = host.querySelector<HTMLButtonElement>('[title="Remove Blur"]');
+    act(() => remove?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(onCommit.mock.calls.at(-1)?.[0].effects.blur).toBe(0);
+    expect(onCommit.mock.calls.at(-1)?.[0].effects.pixelate).toBe(
+      HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.pixelate.pixelate,
+    );
+    act(() => root.unmount());
+  });
+
+  it("closes the catalog when an already active effect is selected", () => {
+    const grading = normalizeHfColorGrading({
+      effects: HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS.blur,
+    });
+    if (!grading) throw new Error("expected blur grading");
+    const props = sectionProps(grading);
+    const { host, root } = renderInto(<FlatEffectsSection {...props} />);
+    expect(props.onRequestEffectPreviews).not.toHaveBeenCalled();
+    const toggle = host.querySelector<HTMLButtonElement>('[data-flat-effects-add-toggle="true"]');
+    act(() => toggle?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(toggle?.getAttribute("aria-expanded")).toBe("true");
+    expect(props.onRequestEffectPreviews).toHaveBeenCalledWith(["blur", "pixelate", "bloom"]);
+    const blur = host.querySelector<HTMLButtonElement>('[data-flat-effect-option="blur"]');
+    act(() => blur?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(toggle?.getAttribute("aria-expanded")).toBe("false");
+    act(() => root.unmount());
+  });
+
+  it("requests only the visible family when the catalog tab changes", () => {
+    const props = sectionProps(neutralGrading());
+    const { host, root } = renderInto(<FlatEffectsSection {...props} />);
+    const art = host.querySelector<HTMLButtonElement>('[data-flat-effect-group="Art"]');
+    act(() => art?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(props.onRequestEffectPreviews).toHaveBeenLastCalledWith([
+      "ascii",
+      "engraving",
+      "crosshatch",
+      "kuwahara",
+    ]);
+    act(() => root.unmount());
+  });
+});
+
+describe("FlatEffectsAccessory", () => {
+  it("counts active masters and resets only effects and palette", () => {
+    const base = neutralGrading();
+    const grading = {
+      ...base,
+      adjust: { ...base.adjust, contrast: 0.2 },
+      effects: { ...base.effects, blur: 0.4, ascii: 1 },
+      palette: ["#112233", "#ffffff"],
+    };
+    expect(activeColorGradingEffectCount(grading)).toBe(2);
+    const onCommit = vi.fn();
+    const { host, root } = renderInto(
+      <FlatEffectsAccessory grading={grading} onCommitColorGrading={onCommit} />,
+    );
+    const reset = host.querySelector<HTMLButtonElement>('[data-flat-effects-reset="true"]');
+    act(() => reset?.dispatchEvent(new MouseEvent("click", { bubbles: true })));
+    expect(onCommit.mock.calls[0][0].adjust.contrast).toBe(0.2);
+    expect(onCommit.mock.calls[0][0].effects.blur).toBe(0);
+    expect(onCommit.mock.calls[0][0].effects.ascii).toBe(0);
+    expect(onCommit.mock.calls[0][0].palette).toBeNull();
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/components/editor/propertyPanelFlatEffectsSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatEffectsSection.tsx
new file mode 100644
index 0000000000..bba513fb1c
--- /dev/null
+++ b/packages/studio/src/components/editor/propertyPanelFlatEffectsSection.tsx
@@ -0,0 +1,503 @@
+import { useEffect, useState } from "react";
+import {
+  HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS,
+  HF_COLOR_GRADING_EFFECT_PRESETS,
+  HF_COLOR_GRADING_PALETTES,
+  normalizeHfColorGrading,
+  type HfColorGradingActiveEffectKey,
+  type HfColorGradingEffectKey,
+  type NormalizedHfColorGrading,
+} from "@hyperframes/core/color-grading";
+import { Plus, RotateCcw, X } from "../../icons/SystemIcons";
+import { useTrackDesignInput } from "../../contexts/DesignPanelInputContext";
+import { FLAT_PREVIEW_GRID, FlatSlider } from "./propertyPanelFlatPrimitives";
+import type {
+  ColorGradingPresetPreviews,
+  ColorGradingPreviewOptions,
+} from "./useColorGradingController";
+import {
+  DEFAULT_EFFECTS,
+  EFFECT_GROUPS,
+  EFFECT_SPECS,
+  type EffectControl,
+  type EffectSpec,
+} from "./propertyPanelFlatEffectSpecs";
+import { FlatEffectControl } from "./propertyPanelFlatEffectControl";
+import { presetPreviewHandlers } from "./propertyPanelPresetPreview";
+
+export function activeColorGradingEffectCount(grading: NormalizedHfColorGrading): number {
+  return EFFECT_SPECS.filter((effect) => grading.effects[effect.key] > 0.0001).length;
+}
+
+export function FlatEffectsAccessory({
+  grading,
+  onCommitColorGrading,
+}: {
+  grading: NormalizedHfColorGrading;
+  onCommitColorGrading: (next: NormalizedHfColorGrading) => void;
+}) {
+  const track = useTrackDesignInput();
+  if (!activeColorGradingEffectCount(grading)) return null;
+  return (
+    <button
+      type="button"
+      data-flat-effects-reset="true"
+      title="Reset effects"
+      onClick={(event) => {
+        event.stopPropagation();
+        track("button", "Reset effects");
+        onCommitColorGrading({ ...grading, effects: { ...DEFAULT_EFFECTS }, palette: null });
+      }}
+      className="flex-shrink-0 text-panel-text-3 hover:text-panel-text-1"
+    >
+      <RotateCcw size={12} />
+    </button>
+  );
+}
+
+export function FlatEffectsSection({
+  grading,
+  previews,
+  presetPreviews,
+  onCommitColorGrading,
+  onPreviewColorGrading,
+  onRequestEffectPreviews,
+  onRequestPresetPreviews,
+}: {
+  grading: NormalizedHfColorGrading;
+  previews: ColorGradingPresetPreviews;
+  presetPreviews: ColorGradingPresetPreviews;
+  onCommitColorGrading: (next: NormalizedHfColorGrading) => void;
+  onPreviewColorGrading: (
+    next: NormalizedHfColorGrading | null,
+    options?: ColorGradingPreviewOptions,
+  ) => void;
+  onRequestEffectPreviews: (effects: readonly HfColorGradingActiveEffectKey[]) => void;
+  onRequestPresetPreviews: () => void;
+}) {
+  const track = useTrackDesignInput();
+  const activeEffects = EFFECT_SPECS.filter((effect) => grading.effects[effect.key] > 0.0001);
+  const [catalogOpen, setCatalogOpen] = useState(activeEffects.length === 0);
+  const [catalogGroup, setCatalogGroup] = useState(EFFECT_GROUPS[0].label);
+  const [selectedKey, setSelectedKey] = useState<HfColorGradingActiveEffectKey | null>(
+    activeEffects[0]?.key ?? null,
+  );
+  const selectedEffect =
+    activeEffects.find((effect) => effect.key === selectedKey) ?? activeEffects[0] ?? null;
+
+  useEffect(() => {
+    if (!catalogOpen) return;
+    const group = EFFECT_GROUPS.find((candidate) => candidate.label === catalogGroup);
+    if (!group) return;
+    const effectKeys = group.effects.map((effect) => effect.key);
+    if (previews.status !== "loading" && effectKeys.some((effect) => !previews.images[effect])) {
+      onRequestEffectPreviews(effectKeys);
+    }
+    if (
+      group.presets?.some((preset) => !presetPreviews.images[preset]) &&
+      presetPreviews.status !== "loading"
+    ) {
+      onRequestPresetPreviews();
+    }
+  }, [
+    catalogGroup,
+    catalogOpen,
+    onRequestEffectPreviews,
+    onRequestPresetPreviews,
+    presetPreviews.images,
+    presetPreviews.status,
+    previews.images,
+    previews.status,
+  ]);
+  useEffect(() => () => onPreviewColorGrading(null), [onPreviewColorGrading]);
+
+  const commitEffects = (effects: NormalizedHfColorGrading["effects"]) => {
+    onCommitColorGrading({
+      ...grading,
+      effects,
+    });
+  };
+  const commitEffect = (key: HfColorGradingEffectKey, value: number) => {
+    commitEffects({ ...grading.effects, [key]: value });
+  };
+  const resolveEffect = (effect: EffectSpec): NormalizedHfColorGrading => ({
+    ...grading,
+    effects: {
+      ...grading.effects,
+      ...HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS[effect.key],
+    },
+  });
+  const applyEffect = (effect: EffectSpec) => {
+    track("button", `Add ${effect.label}`);
+    onCommitColorGrading(resolveEffect(effect));
+    setSelectedKey(effect.key);
+    setCatalogOpen(false);
+  };
+  const resolvePreset = (presetId: string) =>
+    normalizeHfColorGrading({ preset: presetId, lut: grading.lut }) ?? grading;
+  const removeEffect = (effect: EffectSpec) => {
+    track("button", `Remove ${effect.label}`);
+    commitEffect(effect.key, 0);
+    setSelectedKey(null);
+  };
+
+  const renderPalette = (kind: "mono" | "art") => {
+    const fallback = kind === "art" ? ["#1a1a1a", "#f5f5dc"] : ["#000000", "#ffffff"];
+    const palette = grading.palette;
+    return (
+      <div data-flat-effects-palette="true" className="space-y-2 py-1">
+        <div className="grid grid-cols-3 gap-1">
+          {HF_COLOR_GRADING_PALETTES.map((preset) => {
+            const selected =
+              palette?.length === preset.colors.length &&
+              palette.every((color, index) => color === preset.colors[index]);
+            return (
+              <button
+                key={preset.id}
+                type="button"
+                title={`${preset.group}: ${preset.label}`}
+                data-flat-effects-palette-preset={preset.id}
+                aria-pressed={selected}
+                onClick={() => {
+                  track("button", `Use ${preset.label} palette`);
+                  onCommitColorGrading({ ...grading, palette: [...preset.colors] });
+                }}
+                className={`min-w-0 border p-1 text-left ${
+                  selected
+                    ? "border-panel-accent bg-panel-accent/10"
+                    : "border-panel-hairline hover:border-panel-border-input"
+                }`}
+              >
+                <span className="mb-1 flex h-3 overflow-hidden rounded-[2px]">
+                  {preset.colors.map((color) => (
+                    <span key={color} className="flex-1" style={{ backgroundColor: color }} />
+                  ))}
+                </span>
+                <span className="block truncate text-[8px] text-panel-text-3">{preset.label}</span>
+              </button>
+            );
+          })}
+        </div>
+        {!palette ? (
+          <button
+            type="button"
+            data-flat-effects-add-palette="true"
+            onClick={() => {
+              track("button", "Customize effect palette");
+              onCommitColorGrading({ ...grading, palette: fallback });
+            }}
+            className="flex min-h-[28px] items-center gap-1 text-[10px] font-medium text-panel-accent hover:text-panel-accent/80"
+          >
+            <Plus size={11} /> Custom palette
+          </button>
+        ) : (
+          <>
+            <div className="flex items-center justify-between">
+              <span className="text-[11px] text-panel-text-3">Custom palette</span>
+              <button
+                type="button"
+                title="Use default palette"
+                onClick={() => onCommitColorGrading({ ...grading, palette: null })}
+                className="text-panel-text-4 hover:text-panel-text-1"
+              >
+                <RotateCcw size={11} />
+              </button>
+            </div>
+            <div className="flex flex-wrap items-center gap-1.5">
+              {palette.map((color, index) => (
+                <span key={`${index}-${color}`} className="group/swatch relative">
+                  <input
+                    type="color"
+                    aria-label={`Palette color ${index + 1}`}
+                    value={color}
+                    onChange={(event) => {
+                      const nextPalette = [...palette];
+                      nextPalette[index] = event.target.value;
+                      onCommitColorGrading({ ...grading, palette: nextPalette });
+                    }}
+                    className="h-6 w-6 cursor-pointer rounded-sm border border-panel-border-input bg-transparent p-0"
+                  />
+                  {palette.length > 2 && (
+                    <button
+                      type="button"
+                      aria-label={`Remove palette color ${index + 1}`}
+                      onClick={() =>
+                        onCommitColorGrading({
+                          ...grading,
+                          palette: palette.filter((_, colorIndex) => colorIndex !== index),
+                        })
+                      }
+                      className="absolute -right-1 -top-1 hidden h-3.5 w-3.5 items-center justify-center rounded-full bg-panel-bg text-panel-text-2 shadow group-hover/swatch:flex"
+                    >
+                      <X size={8} />
+                    </button>
+                  )}
+                </span>
+              ))}
+              {palette.length < 6 && (
+                <button
+                  type="button"
+                  aria-label="Add palette color"
+                  onClick={() =>
+                    onCommitColorGrading({
+                      ...grading,
+                      palette: [...palette, palette.at(-1) ?? "#ffffff"],
+                    })
+                  }
+                  className="flex h-6 w-6 items-center justify-center rounded-sm border border-panel-border-input text-panel-text-4 hover:text-panel-text-1"
+                >
+                  <Plus size={11} />
+                </button>
+              )}
+            </div>
+          </>
+        )}
+      </div>
+    );
+  };
+
+  return (
+    <div className="space-y-2" data-flat-effects-section="true">
+      {activeEffects.length > 0 && (
+        <div data-flat-effects-active-list="true" className="space-y-1">
+          {activeEffects.map((effect) => {
+            const selected = selectedEffect?.key === effect.key;
+            return (
+              <button
+                key={effect.key}
+                type="button"
+                data-flat-effect-active={effect.key}
+                aria-pressed={selected}
+                onClick={() => setSelectedKey(effect.key)}
+                className={`flex min-h-[30px] w-full items-center justify-between border px-2 text-left text-[10px] transition-colors ${
+                  selected
+                    ? "border-panel-accent bg-panel-accent/10 text-panel-text-0"
+                    : "border-panel-hairline bg-panel-bg-soft text-panel-text-3 hover:border-panel-border-input hover:text-panel-text-1"
+                }`}
+              >
+                <span>{effect.label}</span>
+                <span className="text-[9px] text-panel-text-5">
+                  {selected ? "Editing" : "Active"}
+                </span>
+              </button>
+            );
+          })}
+        </div>
+      )}
+
+      {selectedEffect && (
+        <div
+          data-flat-effect-editor={selectedEffect.key}
+          className="space-y-1 border-l-2 border-panel-border-input pl-2.5"
+        >
+          <div className="flex min-h-[26px] items-center justify-between gap-2">
+            <span className="text-[11px] font-medium text-panel-text-1">
+              {selectedEffect.label}
+            </span>
+            <span className="flex items-center gap-2">
+              <button
+                type="button"
+                title={`Reset ${selectedEffect.label}`}
+                onClick={() => applyEffect(selectedEffect)}
+                className="text-panel-text-4 hover:text-panel-text-1"
+              >
+                <RotateCcw size={11} />
+              </button>
+              <button
+                type="button"
+                title={`Remove ${selectedEffect.label}`}
+                onClick={() => removeEffect(selectedEffect)}
+                className="text-panel-text-4 hover:text-red-300"
+              >
+                <X size={11} />
+              </button>
+            </span>
+          </div>
+          {selectedEffect.showMaster !== false && (
+            <FlatSlider
+              label={selectedEffect.masterLabel ?? "Mix"}
+              value={grading.effects[selectedEffect.key] * 100}
+              min={0}
+              max={selectedEffect.max ?? 100}
+              tier="explicitCustom"
+              displayValue={
+                selectedEffect.masterFormat?.(grading.effects[selectedEffect.key]) ??
+                `${Math.round(grading.effects[selectedEffect.key] * 100)}%`
+              }
+              onCommit={(next) => commitEffect(selectedEffect.key, next / 100)}
+              onReset={() =>
+                commitEffect(
+                  selectedEffect.key,
+                  HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS[selectedEffect.key][selectedEffect.key] ??
+                    1,
+                )
+              }
+            />
+          )}
+          {selectedEffect.settings?.map((control: EffectControl) => (
+            <FlatEffectControl
+              key={control.key}
+              control={control}
+              effect={selectedEffect}
+              effects={grading.effects}
+              onCommit={commitEffect}
+            />
+          ))}
+          {selectedEffect.palette && renderPalette(selectedEffect.palette)}
+        </div>
+      )}
+
+      <button
+        type="button"
+        data-flat-effects-add-toggle="true"
+        aria-expanded={catalogOpen}
+        onClick={() => setCatalogOpen((open) => !open)}
+        className="flex min-h-[30px] items-center gap-1 text-[10px] font-medium text-panel-accent hover:text-panel-accent/80"
+      >
+        <Plus size={11} /> Add effect
+      </button>
+
+      {catalogOpen && (
+        <div data-flat-effects-catalog="true" className="space-y-2">
+          <div
+            role="tablist"
+            aria-label="Effect families"
+            className="grid grid-cols-4 gap-px overflow-hidden border border-panel-hairline bg-panel-hairline"
+          >
+            {EFFECT_GROUPS.map((group) => (
+              <button
+                key={group.label}
+                type="button"
+                role="tab"
+                aria-selected={catalogGroup === group.label}
+                data-flat-effect-group={group.label}
+                onClick={() => setCatalogGroup(group.label)}
+                className={`min-h-[25px] min-w-0 truncate bg-panel-bg px-2 text-[9px] ${
+                  catalogGroup === group.label
+                    ? "font-medium text-panel-accent"
+                    : "text-panel-text-4 hover:text-panel-text-1"
+                }`}
+              >
+                {group.label}
+              </button>
+            ))}
+          </div>
+          {EFFECT_GROUPS.filter((group) => group.label === catalogGroup).map((group) => (
+            <section key={group.label} className="space-y-1" role="tabpanel">
+              <div className={FLAT_PREVIEW_GRID}>
+                {group.presets?.map((presetId) => {
+                  const preset = HF_COLOR_GRADING_EFFECT_PRESETS.find(
+                    (candidate) => candidate.id === presetId,
+                  );
+                  if (!preset) return null;
+                  const selected = grading.preset === preset.id;
+                  const preview = presetPreviews.images[preset.id];
+                  return (
+                    <button
+                      key={preset.id}
+                      type="button"
+                      data-flat-effect-preset={preset.id}
+                      aria-pressed={selected}
+                      {...presetPreviewHandlers({
+                        id: preset.id,
+                        label: preset.label,
+                        resolve: () => resolvePreset(preset.id),
+                        onPreview: onPreviewColorGrading,
+                        onCommit: onCommitColorGrading,
+                        onTrack: (name) => track("button", `Apply ${name}`),
+                      })}
+                      className={`min-w-0 overflow-hidden border text-left text-[10px] transition-colors ${
+                        selected
+                          ? "border-panel-accent bg-panel-accent/10 text-panel-text-0"
+                          : "border-panel-hairline bg-panel-bg-soft text-panel-text-3 hover:border-panel-border-input hover:text-panel-text-1"
+                      }`}
+                    >
+                      <span
+                        className="flex w-full items-center justify-center overflow-hidden bg-black/20"
+                        style={{
+                          aspectRatio: `${presetPreviews.width} / ${presetPreviews.height}`,
+                        }}
+                      >
+                        {preview ? (
+                          <img
+                            data-flat-effect-preset-preview={preset.id}
+                            src={preview}
+                            alt=""
+                            draggable={false}
+                            className="block h-full w-full object-contain"
+                          />
+                        ) : (
+                          <span
+                            data-flat-effect-preset-placeholder={presetPreviews.status}
+                            className="h-full w-full bg-panel-bg-soft"
+                          />
+                        )}
+                      </span>
+                      <span className="block truncate px-2 py-1.5">{preset.label}</span>
+                    </button>
+                  );
+                })}
+                {group.effects.map((effect) => {
+                  const active = grading.effects[effect.key] > 0.0001;
+                  const preview = previews.images[effect.key];
+                  return (
+                    <button
+                      key={effect.key}
+                      type="button"
+                      data-flat-effect-option={effect.key}
+                      aria-pressed={active}
+                      title={`Preview ${effect.label}`}
+                      onPointerEnter={() =>
+                        onPreviewColorGrading(resolveEffect(effect), {
+                          animatedPreview: { kind: "effects", id: effect.key },
+                        })
+                      }
+                      onPointerLeave={() => onPreviewColorGrading(null)}
+                      onFocus={() => onPreviewColorGrading(resolveEffect(effect))}
+                      onBlur={() => onPreviewColorGrading(null)}
+                      onClick={() => {
+                        if (active) {
+                          setSelectedKey(effect.key);
+                          setCatalogOpen(false);
+                        } else {
+                          applyEffect(effect);
+                        }
+                      }}
+                      className={`min-w-0 overflow-hidden border text-left text-[10px] transition-colors ${
+                        active
+                          ? "border-panel-accent bg-panel-accent/10 text-panel-text-1"
+                          : "border-panel-hairline bg-panel-bg-soft text-panel-text-3 hover:border-panel-border-input hover:text-panel-text-1"
+                      }`}
+                    >
+                      <span
+                        data-flat-effect-preview-frame={effect.key}
+                        className="flex w-full items-center justify-center overflow-hidden bg-black/20"
+                        style={{ aspectRatio: `${previews.width} / ${previews.height}` }}
+                      >
+                        {preview ? (
+                          <img
+                            data-flat-effect-preview={effect.key}
+                            src={preview}
+                            alt=""
+                            draggable={false}
+                            className="block h-full w-full object-contain"
+                          />
+                        ) : (
+                          <span
+                            data-flat-effect-preview-placeholder={previews.status}
+                            className="h-full w-full bg-panel-bg-soft"
+                          />
+                        )}
+                      </span>
+                      <span className="block truncate px-2 py-1.5">{effect.label}</span>
+                    </button>
+                  );
+                })}
+              </div>
+            </section>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/packages/studio/src/components/editor/propertyPanelFlatOverlaysSection.test.tsx b/packages/studio/src/components/editor/propertyPanelFlatOverlaysSection.test.tsx
new file mode 100644
index 0000000000..1537b3f807
--- /dev/null
+++ b/packages/studio/src/components/editor/propertyPanelFlatOverlaysSection.test.tsx
@@ -0,0 +1,113 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import type { RegistryItem } from "@hyperframes/core/registry";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import {
+  deriveMediaOverlayPlacement,
+  filterMediaTreatmentOverlays,
+  FlatOverlaysSection,
+  MEDIA_TREATMENT_OVERLAY_TAG,
+} from "./propertyPanelFlatOverlaysSection";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+function registryItem(
+  name: string,
+  tags: string[],
+  type: RegistryItem["type"] = "hyperframes:component",
+  preview?: RegistryItem["preview"],
+): RegistryItem {
+  const base = {
+    name,
+    title: name,
+    description: `${name} description`,
+    tags,
+    preview,
+    files: [{ path: `${name}.html`, target: `${name}.html`, type: "hyperframes:snippet" as const }],
+  };
+  if (type === "hyperframes:component") return { ...base, type };
+  if (type === "hyperframes:block") {
+    return { ...base, type, dimensions: { width: 1920, height: 1080 }, duration: 2 };
+  }
+  return { ...base, type, dimensions: { width: 1920, height: 1080 }, duration: 2 };
+}
+
+afterEach(() => {
+  document.body.innerHTML = "";
+  vi.unstubAllGlobals();
+});
+
+describe("FlatOverlaysSection", () => {
+  it("places an overlay over the selected media in its own composition", () => {
+    expect(
+      deriveMediaOverlayPlacement(
+        {
+          sourceFile: "compositions/scene.html",
+          dataAttributes: { "track-index": "2" },
+        },
+        { start: 1.5, duration: 3 },
+      ),
+    ).toEqual({
+      start: 1.5,
+      duration: 3,
+      track: 3,
+      compositionPath: "compositions/scene.html",
+    });
+  });
+
+  it("keeps only tagged Registry overlay blocks", () => {
+    const overlay = registryItem(
+      "camcorder-hud",
+      [MEDIA_TREATMENT_OVERLAY_TAG],
+      "hyperframes:block",
+    );
+    const ordinary = registryItem("caption", ["caption"]);
+    const taggedComponent = registryItem("scene", [MEDIA_TREATMENT_OVERLAY_TAG]);
+
+    expect(
+      filterMediaTreatmentOverlays([overlay, ordinary, taggedComponent]).map(({ name }) => name),
+    ).toEqual(["camcorder-hud"]);
+  });
+
+  it("loads tagged overlays and delegates installation by Registry name", async () => {
+    const items = [
+      registryItem("camcorder-hud", [MEDIA_TREATMENT_OVERLAY_TAG], "hyperframes:block", {
+        poster: "https://example.com/camcorder.png",
+        video: "https://example.com/camcorder.mp4",
+      }),
+      registryItem("ordinary-component", ["overlay"]),
+    ];
+    vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: true, json: async () => items }));
+    const onAddOverlay = vi.fn().mockResolvedValue(undefined);
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+
+    await act(async () => {
+      root.render(<FlatOverlaysSection onAddOverlay={onAddOverlay} />);
+      await Promise.resolve();
+      await Promise.resolve();
+    });
+
+    expect(host.querySelector('[data-flat-overlay="ordinary-component"]')).toBeNull();
+    const add = host.querySelector<HTMLButtonElement>('[data-flat-overlay="camcorder-hud"]');
+    expect(add).not.toBeNull();
+    expect(
+      host.querySelector<HTMLImageElement>('[data-flat-overlay-preview="camcorder-hud"]')?.src,
+    ).toBe("https://example.com/camcorder.png");
+    expect(host.querySelector('[data-flat-overlays="true"]')?.className).toContain("auto-fill");
+    act(() => add?.dispatchEvent(new MouseEvent("pointerover", { bubbles: true })));
+    expect(host.querySelector<HTMLVideoElement>("video")?.src).toBe(
+      "https://example.com/camcorder.mp4",
+    );
+    await act(async () => {
+      add?.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+      await Promise.resolve();
+    });
+    expect(onAddOverlay).toHaveBeenCalledWith("camcorder-hud");
+
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/components/editor/propertyPanelFlatOverlaysSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatOverlaysSection.tsx
new file mode 100644
index 0000000000..7dad96cdb4
--- /dev/null
+++ b/packages/studio/src/components/editor/propertyPanelFlatOverlaysSection.tsx
@@ -0,0 +1,108 @@
+import { useState } from "react";
+import type { RegistryItem } from "@hyperframes/core/registry";
+import { useBlockCatalog } from "../../hooks/useBlockCatalog";
+import { Film, Plus } from "../../icons/SystemIcons";
+import { useTrackDesignInput } from "../../contexts/DesignPanelInputContext";
+import type { DomEditSelection } from "./domEditing";
+import { FLAT_PREVIEW_GRID } from "./propertyPanelFlatPrimitives";
+import type { ElementTiming } from "./propertyPanelFlatTimingDerivation";
+
+export const MEDIA_TREATMENT_OVERLAY_TAG = "media-treatment-overlay";
+
+export function filterMediaTreatmentOverlays(items: readonly RegistryItem[]): RegistryItem[] {
+  return items.filter(
+    (item) =>
+      item.type === "hyperframes:block" &&
+      item.tags?.includes(MEDIA_TREATMENT_OVERLAY_TAG) === true,
+  );
+}
+
+export function deriveMediaOverlayPlacement(
+  element: Pick<DomEditSelection, "dataAttributes" | "sourceFile">,
+  timing: Pick<ElementTiming, "start" | "duration">,
+) {
+  const authoredTrack = Number.parseInt(element.dataAttributes["track-index"] ?? "", 10);
+  return {
+    start: timing.start,
+    ...(timing.duration > 0 ? { duration: timing.duration } : {}),
+    ...(Number.isFinite(authoredTrack) ? { track: authoredTrack + 1 } : {}),
+    compositionPath: element.sourceFile,
+  };
+}
+
+export function FlatOverlaysSection({
+  onAddOverlay,
+}: {
+  onAddOverlay: (name: string) => Promise<void>;
+}) {
+  const track = useTrackDesignInput();
+  const { blocks, loading, error } = useBlockCatalog();
+  const overlays = filterMediaTreatmentOverlays(blocks);
+  const [adding, setAdding] = useState<string | null>(null);
+  const [previewing, setPreviewing] = useState<string | null>(null);
+
+  if (loading) {
+    return <div className="py-4 text-center text-[10px] text-panel-text-4">Loading overlays…</div>;
+  }
+  if (error) {
+    return <div className="py-4 text-center text-[10px] text-red-300">{error}</div>;
+  }
+
+  const busy = adding !== null;
+  return (
+    <div data-flat-overlays="true" className={FLAT_PREVIEW_GRID}>
+      {overlays.map((overlay) => (
+        <button
+          key={overlay.name}
+          type="button"
+          data-flat-overlay={overlay.name}
+          aria-label={`Add ${overlay.title}`}
+          disabled={busy}
+          title={overlay.description}
+          onPointerEnter={() => setPreviewing(overlay.name)}
+          onPointerLeave={() => setPreviewing(null)}
+          onFocus={() => setPreviewing(overlay.name)}
+          onBlur={() => setPreviewing(null)}
+          onClick={() => {
+            track("button", `Add ${overlay.title}`);
+            setAdding(overlay.name);
+            void onAddOverlay(overlay.name).finally(() => setAdding(null));
+          }}
+          className="group min-w-0 overflow-hidden border border-panel-hairline bg-panel-bg-soft text-left transition-colors hover:border-panel-border-input hover:bg-panel-bg disabled:cursor-wait disabled:opacity-50"
+        >
+          <span className="relative flex aspect-video w-full items-center justify-center overflow-hidden bg-black/20">
+            {previewing === overlay.name && overlay.preview?.video ? (
+              <video
+                src={overlay.preview.video}
+                poster={overlay.preview.poster}
+                autoPlay
+                muted
+                loop
+                playsInline
+                className="block h-full w-full object-cover"
+              />
+            ) : overlay.preview?.poster ? (
+              <img
+                data-flat-overlay-preview={overlay.name}
+                src={overlay.preview.poster}
+                alt=""
+                draggable={false}
+                loading="lazy"
+                className="block h-full w-full object-cover"
+              />
+            ) : (
+              <Film size={15} className="text-panel-text-4" />
+            )}
+            <Plus
+              size={12}
+              className="absolute right-1.5 top-1.5 text-white opacity-70 drop-shadow group-hover:text-panel-accent group-hover:opacity-100"
+            />
+          </span>
+          <span className="block truncate px-2 py-1.5 text-[10px] text-panel-text-2">
+            {adding === overlay.name ? "Adding…" : overlay.title}
+          </span>
+        </button>
+      ))}
+    </div>
+  );
+}
diff --git a/packages/studio/src/components/editor/propertyPanelFlatPrimitives.tsx b/packages/studio/src/components/editor/propertyPanelFlatPrimitives.tsx
index 7429768c52..29c167e57d 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatPrimitives.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatPrimitives.tsx
@@ -8,6 +8,8 @@ import {
   type PropertyValueTier,
 } from "./propertyPanelValueTier";
 
+export const FLAT_PREVIEW_GRID = "grid grid-cols-[repeat(auto-fill,minmax(120px,1fr))] gap-1";
+
 /* ------------------------------------------------------------------ */
 /*  FlatRow — single-column label/value property row                   */
 /* ------------------------------------------------------------------ */
diff --git a/packages/studio/src/components/editor/propertyPanelPresetPreview.ts b/packages/studio/src/components/editor/propertyPanelPresetPreview.ts
new file mode 100644
index 0000000000..601e25ef50
--- /dev/null
+++ b/packages/studio/src/components/editor/propertyPanelPresetPreview.ts
@@ -0,0 +1,36 @@
+import type { NormalizedHfColorGrading } from "@hyperframes/core/color-grading";
+import type { ColorGradingPreviewOptions } from "./useColorGradingController";
+
+export function presetPreviewHandlers({
+  id,
+  label,
+  resolve,
+  onPreview,
+  onCommit,
+  onTrack,
+}: {
+  id: string;
+  label: string;
+  resolve: () => NormalizedHfColorGrading;
+  onPreview: (
+    grading: NormalizedHfColorGrading | null,
+    options?: ColorGradingPreviewOptions,
+  ) => void;
+  onCommit: (grading: NormalizedHfColorGrading) => void;
+  onTrack: (label: string) => void;
+}) {
+  return {
+    title: `Preview ${label}`,
+    onPointerEnter: () =>
+      onPreview(resolve(), {
+        animatedPreview: { kind: "presets" as const, id },
+      }),
+    onPointerLeave: () => onPreview(null),
+    onFocus: () => onPreview(resolve()),
+    onBlur: () => onPreview(null),
+    onClick: () => {
+      onTrack(label);
+      onCommit(resolve());
+    },
+  };
+}
diff --git a/packages/studio/src/components/editor/propertyPanelTypes.ts b/packages/studio/src/components/editor/propertyPanelTypes.ts
index 722e3a252d..e50a011c4b 100644
--- a/packages/studio/src/components/editor/propertyPanelTypes.ts
+++ b/packages/studio/src/components/editor/propertyPanelTypes.ts
@@ -19,6 +19,18 @@ export interface BackgroundRemovalResult {
   provider?: string;
 }
 
+export interface MediaOverlayPlacement {
+  start: number;
+  duration?: number;
+  track?: number;
+  compositionPath?: string;
+}
+
+export type AddMediaOverlayHandler = (
+  blockName: string,
+  placement: MediaOverlayPlacement,
+) => Promise<void>;
+
 export interface PropertyPanelProps {
   projectId: string;
   projectDir: string | null;
@@ -69,6 +81,7 @@ export interface PropertyPanelProps {
   onAskAgent: () => void;
   onToggleElementHidden?: (elementKey: string, hidden: boolean) => void | Promise<void>;
   onImportAssets?: (files: FileList, dir?: string) => Promise<string[]>;
+  onAddMediaOverlay?: AddMediaOverlayHandler;
   fontAssets?: ImportedFontAsset[];
   onImportFonts?: (files: FileList | File[]) => Promise<ImportedFontAsset[]>;
   previewIframeRef?: RefObject<HTMLIFrameElement | null>;
diff --git a/packages/studio/src/components/editor/useColorGradingController.test.ts b/packages/studio/src/components/editor/useColorGradingController.test.ts
index 4b4d9376d3..40fe3cd90b 100644
--- a/packages/studio/src/components/editor/useColorGradingController.test.ts
+++ b/packages/studio/src/components/editor/useColorGradingController.test.ts
@@ -13,9 +13,9 @@ function brightPopGrading() {
   return next;
 }
 
-function warmDaylightGrading() {
-  const next = normalizeHfColorGrading({ preset: "warm-daylight", intensity: 1 });
-  if (!next) throw new Error("expected warm-daylight preset to normalize");
+function cleanStudioGrading() {
+  const next = normalizeHfColorGrading({ preset: "clean-studio", intensity: 1 });
+  if (!next) throw new Error("expected clean-studio preset to normalize");
   return next;
 }
 
@@ -60,14 +60,17 @@ function HookHost({
   onState,
   onSetAttributeLive,
   element,
+  previewIframeRef,
 }: {
   onState: (state: ReturnType<typeof useColorGradingController>) => void;
   onSetAttributeLive: (attr: string, value: string | null) => void;
   element: DomEditSelection;
+  previewIframeRef?: React.RefObject<HTMLIFrameElement | null>;
 }) {
   const state = useColorGradingController({
     projectId: "proj",
     element,
+    previewIframeRef,
     onSetAttributeLive,
   });
   onState(state);
@@ -77,6 +80,7 @@ function HookHost({
 function renderHook(
   onSetAttributeLive: (attr: string, value: string | null) => void,
   initialElement: DomEditSelection = makeElement(),
+  previewIframeRef?: React.RefObject<HTMLIFrameElement | null>,
 ) {
   const host = document.createElement("div");
   document.body.append(host);
@@ -89,6 +93,7 @@ function renderHook(
           onState: (s: ReturnType<typeof useColorGradingController>) => (latest = s),
           onSetAttributeLive,
           element,
+          previewIframeRef,
         }),
       );
     });
@@ -107,6 +112,43 @@ function renderHook(
   };
 }
 
+type PreviewWindow = Window & {
+  __hf?: {
+    colorGrading?: {
+      renderPreviews?: ReturnType<typeof vi.fn>;
+      startPreviewPlayback?: ReturnType<typeof vi.fn>;
+    };
+  };
+  __player?: { play: ReturnType<typeof vi.fn> };
+};
+
+function createPreviewFrame() {
+  const iframe = document.body.appendChild(document.createElement("iframe"));
+  const contentWindow = iframe.contentWindow as PreviewWindow | null;
+  if (!contentWindow) throw new Error("expected iframe contentWindow");
+  return { contentWindow, iframe };
+}
+
+async function flushPreviewRequest() {
+  act(() => vi.advanceTimersByTime(0));
+  await act(async () => {
+    await Promise.resolve();
+    await Promise.resolve();
+  });
+}
+
+function colorGradingMessages(calls: ReadonlyArray<ReadonlyArray<unknown>>) {
+  return calls
+    .map(([message]) => message)
+    .filter(
+      (message): message is { action: string; grading: unknown } =>
+        typeof message === "object" &&
+        message !== null &&
+        "action" in message &&
+        message.action === "set-color-grading",
+    );
+}
+
 describe("useColorGradingController", () => {
   it("starts with the neutral (inactive) grading and idle compare state", () => {
     const { root, getState } = renderHook(vi.fn());
@@ -115,6 +157,77 @@ describe("useColorGradingController", () => {
     act(() => root.unmount());
   });
 
+  it("requests one exact preset batch from the selected media runtime", async () => {
+    vi.useFakeTimers();
+    const devicePixelRatio = vi.spyOn(window, "devicePixelRatio", "get").mockReturnValue(2);
+    const { contentWindow, iframe } = createPreviewFrame();
+    const renderPreviews = vi.fn().mockResolvedValue({
+      width: 160,
+      height: 90,
+      images: [{ id: "bright-pop", dataUrl: "data:image/png;base64,bright" }],
+    });
+    contentWindow.__hf = { colorGrading: { renderPreviews } };
+    const { root, getState } = renderHook(vi.fn(), makeElement(), { current: iframe });
+
+    act(() => getState().requestPresetPreviews());
+    await flushPreviewRequest();
+
+    expect(renderPreviews).toHaveBeenCalledTimes(1);
+    expect(renderPreviews.mock.calls[0]?.[1]).toHaveLength(18);
+    expect(renderPreviews.mock.calls[0]?.[2]).toEqual({ maxDimension: 320 });
+    expect(getState().presetPreviews).toEqual({
+      status: "ready",
+      images: { "bright-pop": "data:image/png;base64,bright" },
+      width: 160,
+      height: 90,
+    });
+    act(() => root.unmount());
+    devicePixelRatio.mockRestore();
+    vi.useRealTimers();
+  });
+
+  it("requests exact effect families and retains earlier family images", async () => {
+    vi.useFakeTimers();
+    const { contentWindow, iframe } = createPreviewFrame();
+    const renderPreviews = vi
+      .fn()
+      .mockImplementation(async (_target: unknown, candidates: Array<{ id: string }>) => ({
+        width: 160,
+        height: 90,
+        images: candidates.map(({ id }) => ({ id, dataUrl: `data:image/png;base64,${id}` })),
+      }));
+    contentWindow.__hf = { colorGrading: { renderPreviews } };
+    const { root, getState } = renderHook(vi.fn(), makeElement(), { current: iframe });
+
+    act(() => getState().requestEffectPreviews(["blur", "pixelate", "bloom"]));
+    await flushPreviewRequest();
+
+    expect(renderPreviews).toHaveBeenCalledTimes(1);
+    expect(renderPreviews.mock.calls[0]?.[1].map(({ id }: { id: string }) => id)).toEqual([
+      "blur",
+      "pixelate",
+      "bloom",
+    ]);
+
+    act(() => getState().requestEffectPreviews(["kuwahara"]));
+    await flushPreviewRequest();
+
+    expect(renderPreviews).toHaveBeenCalledTimes(2);
+    expect(getState().effectPreviews).toEqual({
+      status: "ready",
+      images: {
+        blur: "data:image/png;base64,blur",
+        pixelate: "data:image/png;base64,pixelate",
+        bloom: "data:image/png;base64,bloom",
+        kuwahara: "data:image/png;base64,kuwahara",
+      },
+      width: 160,
+      height: 90,
+    });
+    act(() => root.unmount());
+    vi.useRealTimers();
+  });
+
   it("commitColorGrading updates grading state synchronously and schedules a debounced persist", async () => {
     vi.useFakeTimers();
     const onSetAttributeLive = vi.fn();
@@ -135,6 +248,86 @@ describe("useColorGradingController", () => {
     vi.useRealTimers();
   });
 
+  it("previews through the runtime only and restores the committed grade without persisting", () => {
+    vi.useFakeTimers();
+    const onSetAttributeLive = vi.fn();
+    const { contentWindow, iframe } = createPreviewFrame();
+    const postMessage = vi.spyOn(contentWindow, "postMessage");
+    const { root, getState } = renderHook(onSetAttributeLive, makeElement(), {
+      current: iframe,
+    });
+
+    act(() => getState().previewColorGrading(brightPopGrading()));
+    act(() => getState().previewColorGrading(null));
+    const gradingMessages = colorGradingMessages(postMessage.mock.calls);
+    expect(gradingMessages).toHaveLength(2);
+    expect(gradingMessages[0]?.grading).toMatchObject({ preset: "bright-pop" });
+    expect(gradingMessages[1]?.grading).toBeNull();
+    expect(getState().grading.preset).toBe("neutral");
+    act(() => vi.advanceTimersByTime(500));
+    expect(onSetAttributeLive).not.toHaveBeenCalled();
+
+    act(() => root.unmount());
+    vi.useRealTimers();
+  });
+
+  it("animates only the selected video card without starting the project player", async () => {
+    vi.useFakeTimers();
+    const { contentWindow, iframe } = createPreviewFrame();
+    const stopPlayback = vi.fn();
+    const renderPreviews = vi.fn().mockResolvedValue({
+      width: 320,
+      height: 180,
+      images: [{ id: "bright-pop", dataUrl: "data:image/png;base64,animated" }],
+    });
+    const startPreviewPlayback = vi.fn(() => stopPlayback);
+    contentWindow.__hf = { colorGrading: { renderPreviews, startPreviewPlayback } };
+    contentWindow.__player = { play: vi.fn() };
+    const { root, getState } = renderHook(vi.fn(), makeElement(), { current: iframe });
+
+    act(() =>
+      getState().previewColorGrading(brightPopGrading(), {
+        animatedPreview: { kind: "presets", id: "bright-pop" },
+      }),
+    );
+    await act(async () => {
+      await Promise.resolve();
+      await Promise.resolve();
+    });
+    expect(startPreviewPlayback).toHaveBeenCalledTimes(1);
+    expect(renderPreviews).toHaveBeenCalledWith(
+      expect.anything(),
+      [{ id: "bright-pop", grading: expect.objectContaining({ preset: "bright-pop" }) }],
+      { maxDimension: 160, useMediaTime: true },
+    );
+    expect(contentWindow.__player.play).not.toHaveBeenCalled();
+    expect(getState().presetPreviews.images["bright-pop"]).toBe("data:image/png;base64,animated");
+
+    act(() => getState().previewColorGrading(null));
+    expect(stopPlayback).toHaveBeenCalledTimes(1);
+
+    act(() => root.unmount());
+    vi.useRealTimers();
+  });
+
+  it("restores a just-committed look even before React renders the new state", () => {
+    vi.useFakeTimers();
+    const { contentWindow, iframe } = createPreviewFrame();
+    const postMessage = vi.spyOn(contentWindow, "postMessage");
+    const { root, getState } = renderHook(vi.fn(), makeElement(), { current: iframe });
+    const brightPop = brightPopGrading();
+
+    act(() => {
+      getState().commitColorGrading(brightPop);
+      getState().previewColorGrading(null);
+    });
+    const gradingMessages = colorGradingMessages(postMessage.mock.calls);
+    expect(gradingMessages.at(-1)?.grading).toMatchObject({ preset: "bright-pop" });
+
+    act(() => root.unmount());
+    vi.useRealTimers();
+  });
+
   it("reverts to the last confirmed-good grading via the real onSettled(false) signal (matches runDomEditCommit, which never rejects)", async () => {
     // The actual Studio commit runner (runDomEditCommit) catches persist
     // failures internally and always resolves — it reports outcome only
@@ -253,7 +446,7 @@ describe("useColorGradingController", () => {
           });
         },
       )
-      // Edit B (warm-daylight): settles immediately and successfully.
+      // Edit B (clean-studio): settles immediately and successfully.
       .mockImplementationOnce(
         (_attr: string, _value: string | null, onSettled?: (ok: boolean) => void) => {
           onSettled?.(true);
@@ -272,13 +465,13 @@ describe("useColorGradingController", () => {
 
     // B commits on the SAME element before A's persist has settled.
     act(() => {
-      getState().commitColorGrading(warmDaylightGrading());
+      getState().commitColorGrading(cleanStudioGrading());
     });
     act(() => {
       vi.advanceTimersByTime(400);
     });
     expect(onSetAttributeLive).toHaveBeenCalledTimes(2); // B's persist has already settled (mock resolves sync)
-    expect(getState().grading.preset).toBe("warm-daylight");
+    expect(getState().grading.preset).toBe("clean-studio");
 
     // NOW A's stale persist finally settles as a FAILURE — must not revert
     // `grading` (which now correctly shows B's newer edit) back to the
@@ -292,7 +485,7 @@ describe("useColorGradingController", () => {
       await Promise.resolve();
       await Promise.resolve();
     });
-    expect(getState().grading.preset).toBe("warm-daylight");
+    expect(getState().grading.preset).toBe("clean-studio");
     act(() => root.unmount());
     vi.useRealTimers();
   });
diff --git a/packages/studio/src/components/editor/useColorGradingController.ts b/packages/studio/src/components/editor/useColorGradingController.ts
index d35d60c10c..87ab54dfde 100644
--- a/packages/studio/src/components/editor/useColorGradingController.ts
+++ b/packages/studio/src/components/editor/useColorGradingController.ts
@@ -4,6 +4,7 @@ import {
   isHfColorGradingActive,
   normalizeHfColorGrading,
   serializeHfColorGrading,
+  type HfColorGradingActiveEffectKey,
   type HfColorGradingTarget,
   type NormalizedHfColorGrading,
 } from "@hyperframes/core/color-grading";
@@ -18,6 +19,13 @@ import {
   acceptStudioRuntimeMessage,
   postRuntimeControlMessage,
 } from "../../player/lib/runtimeProtocol";
+import {
+  useColorGradingPreviews,
+  type ColorGradingPresetPreviews,
+  type ColorGradingPreviewOptions,
+} from "./useColorGradingPreviews";
+
+export type { ColorGradingPresetPreviews, ColorGradingPreviewOptions };
 
 const COLOR_GRADING_DATA_KEY = HF_COLOR_GRADING_ATTR.replace(/^data-/, "");
 const RUNTIME_STATUS_REFRESH_DELAYS = [50, 250, 1000, 2500] as const;
@@ -152,7 +160,15 @@ export interface ColorGradingControllerState {
   applyBusy: boolean;
   runtimeStatus: RuntimeColorGradingStatus;
   mediaMetadata: MediaMetadata | null;
+  presetPreviews: ColorGradingPresetPreviews;
+  effectPreviews: ColorGradingPresetPreviews;
+  requestPresetPreviews: () => void;
+  requestEffectPreviews: (effects: readonly HfColorGradingActiveEffectKey[]) => void;
   commitColorGrading: (next: NormalizedHfColorGrading) => void;
+  previewColorGrading: (
+    next: NormalizedHfColorGrading | null,
+    options?: ColorGradingPreviewOptions,
+  ) => void;
   commitCompare: (enabled: boolean) => void;
   setApplyScope: (scope: "source-file" | "project") => void;
   applyToScope: () => Promise<void>;
@@ -195,20 +211,11 @@ export function useColorGradingController({
   const persistTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const pendingPersistValueRef = useRef<string | null | undefined>(undefined);
   const pendingPersistGradingRef = useRef<NormalizedHfColorGrading | null>(null);
-  // Identity the pending edit was made FOR, snapshotted at schedule time —
-  // read by a global flush instead of identityKeyRef.current, which may no
-  // longer describe this edit's element by the time the flush runs.
+  // Capture the edited element because selection can change before persistence.
   const pendingPersistIdentityRef = useRef<string | null>(null);
-  // The last grading value actually confirmed saved — distinct from `grading`
-  // (the optimistic value shown immediately on commit). A rejected persist
-  // reverts to this instead of leaving the UI permanently showing a value
-  // that was never written.
+  // Keep a confirmed value so an optimistic edit can be reverted on failure.
   const confirmedGradingRef = useRef(grading);
-  // Monotonic per-commit version — guards against TWO edits on the SAME
-  // element racing (not just a selection change). If edit A's persist is
-  // still in flight when edit B commits, A's eventual settle must not stamp
-  // confirmedGradingRef with its now-superseded value or revert `grading`
-  // out from under B's newer optimistic state.
+  // Prevent an older same-element write from settling over a newer edit.
   const gradingVersionRef = useRef(0);
   const statusTimersRef = useRef<number[]>([]);
   const latestGradingRef = useRef(grading);
@@ -216,22 +223,7 @@ export function useColorGradingController({
   latestGradingRef.current = grading;
   compareEnabledRef.current = compareEnabled;
 
-  // Reset all per-element STATE when the selection changes to a different
-  // element — unlike the legacy ColorGradingSection (remounted via a
-  // `key={selectionIdentityKey(element)}` from its parent), this hook is
-  // called unconditionally on every render, so nothing naturally remounts it.
-  // Without this, switching selection reuses the previous element's grading/
-  // compare/mediaMetadata state. Adjusting state during render (comparing
-  // against a ref) is React's documented pattern for STATE updates
-  // specifically — it resolves in the same render pass instead of flashing
-  // stale state for one frame, and is safe to repeat if React discards and
-  // re-runs this render, since every value here is a pure function of
-  // `element`. It must NOT be used for side effects or for consuming
-  // shared mutable state (like the pending-persist timer/value) — a
-  // discarded render would have already consumed them with no corresponding
-  // effect ever running to compensate. That part happens below, in an
-  // effect's cleanup, which is guaranteed to run only for a render that
-  // actually committed.
+  // Reset derived state during render to avoid flashing the previous selection.
   const identityKey = selectionIdentityKey(element);
   const identityKeyRef = useRef(identityKey);
   if (identityKeyRef.current !== identityKey) {
@@ -248,22 +240,9 @@ export function useColorGradingController({
     setMediaMetadata(null);
   }
 
-  // Flushes — never discards — a still-pending edit when selection moves to
-  // a different element, and cancels the debounce timer. Implemented as an
-  // effect CLEANUP (not the render-phase block above, and not a queued ref
-  // consumed by a separate effect): a cleanup only ever runs for the
-  // specific effect instance that actually committed for `identityKey`, so
-  // there's no window where a discarded/interrupted render could have
-  // already consumed pendingPersistValueRef without this ever running to
-  // compensate. The cleanup's closure captures onSetAttributeLive/target
-  // bound to the OUTGOING identity, since it runs before the next effect
-  // instance (for the NEW identity) is established.
+  // Flush a pending write through the outgoing selection's committed callback.
   useEffect(() => {
     return () => {
-      // Stale runtime-status timers scheduled for the OUTGOING element must
-      // not fire after this: readRuntimeColorGradingStatus closes over
-      // `target`, so an old timer firing post-switch would stamp the NEW
-      // element's runtimeStatus with the OLD element's answer.
       for (const timer of statusTimersRef.current) clearTimeout(timer);
       statusTimersRef.current = [];
       if (persistTimerRef.current) {
@@ -316,11 +295,7 @@ export function useColorGradingController({
       })
       .then((result) => {
         if (controller.signal.aborted) return;
-        // Only cache a definitive answer from a successful response — a non-OK
-        // status is a transient/server failure, not a stable "no metadata"
-        // result, and caching it would suppress the HDR banner for this asset
-        // for the page's whole lifetime. Leave the key absent so the next
-        // selection retries.
+        // Cache only successful responses so transient failures remain retryable.
         if (!result.ok) {
           setMediaMetadata(null);
           return;
@@ -329,8 +304,6 @@ export function useColorGradingController({
         setMediaMetadata(result.metadata);
       })
       .catch(() => {
-        // Same reasoning as the non-OK branch above: don't cache a network-
-        // level fetch failure either.
         if (!controller.signal.aborted) setMediaMetadata(null);
       });
     return () => controller.abort();
@@ -364,13 +337,6 @@ export function useColorGradingController({
         onSettled?: (ok: boolean) => void,
       ) => void | Promise<void>,
     ) => {
-      // Two guards, not one: identity (selection moved to a DIFFERENT
-      // element — that element already got its own confirmedGradingRef
-      // baseline from the reset block) and version (a NEWER edit landed on
-      // the SAME element — e.g. the user dragged Exposure, then Contrast,
-      // before Exposure's persist settled; Exposure settling afterward must
-      // not stamp confirmedGradingRef with its now-superseded value or
-      // revert `grading` out from under Contrast's newer optimistic state).
       const applySettled = (ok: boolean) => {
         if (identityKeyRef.current !== attemptIdentityKey) return;
         if (!isLatestAttempt()) return;
@@ -378,25 +344,13 @@ export function useColorGradingController({
           confirmedGradingRef.current = attemptedGrading;
           return;
         }
-        // Persist failed — the optimistic grading was never actually saved.
-        // Revert to the last confirmed-good value instead of leaving the
-        // control showing an unsaved state as if it succeeded.
         const reverted = confirmedGradingRef.current;
         latestGradingRef.current = reverted;
         setGrading(reverted);
         setRuntimeStatus({ state: "unavailable", message: "Save failed — reverted" });
       };
-      // `onSettled` is the real signal — the underlying commit runner
-      // (runDomEditCommit) intentionally swallows persist failures so a
-      // caller `await`-ing this promise never sees a rejection; a rejection
-      // handler here alone would be dead code against the actual Studio
-      // callback. The `.catch` below is a fallback for any OTHER
-      // implementation of onSetAttributeLive that rejects instead.
-      // `setAttributeLive` is passed in by the caller rather than read from a
-      // ref: a debounced persist for element A must call the callback that
-      // was live when A's edit was SCHEDULED, not whatever the ref holds by
-      // the time the timer fires — a "latest" ref would let a stale timer
-      // wrongly target a since-selected element B's callback.
+      // The callback is the primary result signal; the rejection path supports
+      // other setAttributeLive implementations.
       const result = setAttributeLive(COLOR_GRADING_DATA_KEY, value ?? null, applySettled);
       return trackStudioPendingEdit(
         Promise.resolve(result).then(
@@ -416,20 +370,10 @@ export function useColorGradingController({
     if (pendingPersistValueRef.current === undefined) return undefined;
     const value = pendingPersistValueRef.current;
     const attemptedGrading = pendingPersistGradingRef.current ?? latestGradingRef.current;
-    // Snapshotted at schedule time, not identityKeyRef.current read fresh
-    // here — an async flush could otherwise tag the attempt with whatever
-    // identity is "current" by then, not the one this edit was made for.
     const attemptIdentityKey = pendingPersistIdentityRef.current ?? identityKeyRef.current;
     pendingPersistValueRef.current = undefined;
     pendingPersistGradingRef.current = null;
     pendingPersistIdentityRef.current = null;
-    // A flush cancels the pending debounce timer above, so this becomes the
-    // one-and-only in-flight attempt for this element — bump the version so
-    // it still registers as "the latest attempt" against the same guard a
-    // regular debounced commit uses, instead of unconditionally claiming
-    // that title. Without this, a newer edit landing after the flush starts
-    // but before it settles would have its own eventual settle silently
-    // lose the version race to this unconditionally-"latest" flush.
     const isLatestAttempt = bumpDomEditCommitVersion(gradingVersionRef);
     return persistColorGradingValue(
       value,
@@ -458,6 +402,14 @@ export function useColorGradingController({
     },
     [previewIframeRef, target],
   );
+  const previewController = useColorGradingPreviews({
+    grading,
+    gradingRef: latestGradingRef,
+    identityKey,
+    target,
+    previewIframeRef,
+    postColorGrading,
+  });
 
   const postCompare = useCallback(
     (enabled: boolean) => {
@@ -509,6 +461,7 @@ export function useColorGradingController({
 
   const commitColorGrading = useCallback(
     (nextGrading: NormalizedHfColorGrading) => {
+      latestGradingRef.current = nextGrading;
       setGrading(nextGrading);
       setRuntimeStatus({ state: "pending", message: "Updating shader" });
       postColorGrading(nextGrading);
@@ -524,14 +477,7 @@ export function useColorGradingController({
         : null;
       pendingPersistGradingRef.current = nextGrading;
       pendingPersistIdentityRef.current = identityKeyRef.current;
-      // Captured now (edit time), not read fresh inside the timer — the
-      // timer fires 350ms later and may run after selection has already
-      // moved on, at which point identityKeyRef.current would no longer
-      // describe the element this edit was actually made for.
       const attemptIdentityKey = identityKeyRef.current;
-      // Bumps a monotonic version and hands back a checker bound to THIS
-      // specific commit — reused from the same primitive the DOM-attribute
-      // commit runner uses for the identical same-target-rapid-edits race.
       const isLatestAttempt = bumpDomEditCommitVersion(gradingVersionRef);
       persistTimerRef.current = setTimeout(() => {
         const value = pendingPersistValueRef.current;
@@ -587,7 +533,12 @@ export function useColorGradingController({
     applyBusy,
     runtimeStatus,
     mediaMetadata,
+    presetPreviews: previewController.presetPreviews,
+    effectPreviews: previewController.effectPreviews,
+    requestPresetPreviews: previewController.requestPresetPreviews,
+    requestEffectPreviews: previewController.requestEffectPreviews,
     commitColorGrading,
+    previewColorGrading: previewController.previewColorGrading,
     commitCompare,
     setApplyScope,
     applyToScope,
diff --git a/packages/studio/src/components/editor/useColorGradingPreviews.ts b/packages/studio/src/components/editor/useColorGradingPreviews.ts
new file mode 100644
index 0000000000..2c88013918
--- /dev/null
+++ b/packages/studio/src/components/editor/useColorGradingPreviews.ts
@@ -0,0 +1,307 @@
+import { useCallback, useEffect, useRef, useState, type RefObject } from "react";
+import {
+  HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS,
+  HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS,
+  HF_COLOR_GRADING_PRESETS,
+  normalizeHfColorGrading,
+  type HfColorGradingActiveEffectKey,
+  type HfColorGradingTarget,
+  type NormalizedHfColorGrading,
+} from "@hyperframes/core/color-grading";
+
+export interface ColorGradingPresetPreviews {
+  status: "idle" | "loading" | "ready" | "unavailable";
+  images: Record<string, string>;
+  width: number;
+  height: number;
+}
+
+type ColorGradingPreviewKind = "presets" | "effects";
+
+export interface ColorGradingPreviewOptions {
+  animatedPreview: { kind: ColorGradingPreviewKind; id: string };
+}
+
+type RuntimeColorGradingPreview = {
+  renderPreviews: (
+    target: HfColorGradingTarget,
+    candidates: Array<{ id: string; grading: unknown }>,
+    options: { maxDimension: number; useMediaTime?: boolean },
+  ) => Promise<{
+    width: number;
+    height: number;
+    images: Array<{ id: string; dataUrl: string | null }>;
+  } | null>;
+  startPreviewPlayback?: (target: HfColorGradingTarget) => (() => void) | null;
+};
+
+type PreviewRequest = {
+  kind: ColorGradingPreviewKind;
+  version: number;
+  effects?: readonly HfColorGradingActiveEffectKey[];
+};
+
+const emptyPreviews = (): Record<ColorGradingPreviewKind, ColorGradingPresetPreviews> => ({
+  presets: { status: "idle", images: {}, width: 16, height: 9 },
+  effects: { status: "idle", images: {}, width: 16, height: 9 },
+});
+
+function readRuntime(
+  iframe: HTMLIFrameElement | null | undefined,
+): RuntimeColorGradingPreview | null {
+  try {
+    const runtime = (
+      iframe?.contentWindow as
+        | (Window & { __hf?: { colorGrading?: Partial<RuntimeColorGradingPreview> } })
+        | null
+        | undefined
+    )?.__hf?.colorGrading;
+    return runtime?.renderPreviews
+      ? {
+          renderPreviews: runtime.renderPreviews,
+          startPreviewPlayback: runtime.startPreviewPlayback,
+        }
+      : null;
+  } catch {
+    return null;
+  }
+}
+
+function previewMaxDimension(): number {
+  return Math.min(320, Math.ceil(160 * Math.max(1, window.devicePixelRatio || 1)));
+}
+
+function toPreviewColorGrading(grading: NormalizedHfColorGrading): unknown {
+  const { enabled: _enabled, ...previewGrading } = grading;
+  return previewGrading;
+}
+
+function previewCandidates(
+  request: PreviewRequest,
+  lut: NormalizedHfColorGrading["lut"],
+): Array<{ id: string; grading: unknown }> {
+  if (request.kind === "presets") {
+    return HF_COLOR_GRADING_PRESETS.map((preset) => {
+      const resolved = normalizeHfColorGrading({ preset: preset.id, lut });
+      return { id: preset.id, grading: resolved ? toPreviewColorGrading(resolved) : null };
+    });
+  }
+  return (request.effects ?? HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS).map((effect) => {
+    const resolved = normalizeHfColorGrading({
+      effects: HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS[effect],
+    });
+    return { id: effect, grading: resolved ? toPreviewColorGrading(resolved) : null };
+  });
+}
+
+async function renderRequestedPreviews(
+  runtime: RuntimeColorGradingPreview,
+  target: HfColorGradingTarget,
+  request: PreviewRequest,
+  lut: NormalizedHfColorGrading["lut"],
+) {
+  const batch = await runtime.renderPreviews(target, previewCandidates(request, lut), {
+    maxDimension: previewMaxDimension(),
+  });
+  if (!batch) return null;
+  const images = Object.fromEntries(
+    batch.images.flatMap((image) => (image.dataUrl ? [[image.id, image.dataUrl]] : [])),
+  );
+  return Object.keys(images).length ? { ...batch, images } : null;
+}
+
+export function useColorGradingPreviews({
+  grading,
+  gradingRef,
+  identityKey,
+  target,
+  previewIframeRef,
+  postColorGrading,
+}: {
+  grading: NormalizedHfColorGrading;
+  gradingRef: RefObject<NormalizedHfColorGrading>;
+  identityKey: string;
+  target: HfColorGradingTarget;
+  previewIframeRef?: RefObject<HTMLIFrameElement | null>;
+  postColorGrading: (grading: NormalizedHfColorGrading) => void;
+}) {
+  const [state, setState] = useState(() => ({
+    identityKey,
+    previews: emptyPreviews(),
+  }));
+  const [request, setRequest] = useState<PreviewRequest | null>(null);
+  const animatedRef = useRef<{ stopPlayback: () => void; timer: number | null } | null>(null);
+  if (state.identityKey !== identityKey) {
+    setState({ identityKey, previews: emptyPreviews() });
+    setRequest(null);
+  }
+  const previews = state.identityKey === identityKey ? state.previews : emptyPreviews();
+
+  useEffect(() => {
+    if (!request) return;
+    const { kind } = request;
+    const iframe = previewIframeRef?.current;
+    if (!iframe) {
+      setState((current) => ({
+        ...current,
+        previews: {
+          ...current.previews,
+          [kind]: { status: "unavailable", images: {}, width: 16, height: 9 },
+        },
+      }));
+      return;
+    }
+    let cancelled = false;
+    let complete = false;
+    let inFlight = false;
+    const timers: number[] = [];
+    setState((current) => ({
+      ...current,
+      previews: {
+        ...current.previews,
+        [kind]: { ...current.previews[kind], status: "loading" },
+      },
+    }));
+
+    const attempt = async () => {
+      if (cancelled || complete || inFlight) return;
+      const runtime = readRuntime(iframe);
+      if (!runtime) return;
+      inFlight = true;
+      try {
+        const result = await renderRequestedPreviews(runtime, target, request, grading.lut);
+        if (cancelled || !result) return;
+        complete = true;
+        setState((current) => ({
+          ...current,
+          previews: {
+            ...current.previews,
+            [kind]: {
+              status: "ready",
+              images:
+                kind === "effects"
+                  ? { ...current.previews[kind].images, ...result.images }
+                  : result.images,
+              width: result.width,
+              height: result.height,
+            },
+          },
+        }));
+      } catch {
+        // Timed retries handle runtime and media readiness races.
+      } finally {
+        inFlight = false;
+      }
+    };
+    const onMessage = (event: MessageEvent) => {
+      if (event.source !== iframe.contentWindow) return;
+      const data = event.data as { source?: unknown; type?: unknown } | null;
+      if (data?.source === "hf-preview" && data.type === "ready") void attempt();
+    };
+    iframe.addEventListener("load", attempt);
+    window.addEventListener("message", onMessage);
+    for (const delay of [0, 100, 350, 1000]) {
+      timers.push(window.setTimeout(() => void attempt(), delay));
+    }
+    timers.push(
+      window.setTimeout(() => {
+        if (cancelled || complete) return;
+        setState((current) => ({
+          ...current,
+          previews: {
+            ...current.previews,
+            [kind]: { status: "unavailable", images: {}, width: 16, height: 9 },
+          },
+        }));
+      }, 1600),
+    );
+    return () => {
+      cancelled = true;
+      for (const timer of timers) window.clearTimeout(timer);
+      iframe.removeEventListener("load", attempt);
+      window.removeEventListener("message", onMessage);
+    };
+  }, [grading.lut, previewIframeRef, request, target]);
+
+  const stopAnimatedPreview = useCallback(() => {
+    const session = animatedRef.current;
+    if (!session) return;
+    animatedRef.current = null;
+    if (session.timer !== null) window.clearTimeout(session.timer);
+    session.stopPlayback();
+  }, []);
+
+  const previewColorGrading = useCallback(
+    (next: NormalizedHfColorGrading | null, options?: ColorGradingPreviewOptions) => {
+      stopAnimatedPreview();
+      postColorGrading(next ?? gradingRef.current);
+      if (!next || !options) return;
+      const runtime = readRuntime(previewIframeRef?.current);
+      const stopPlayback = runtime?.startPreviewPlayback?.(target);
+      if (!runtime || !stopPlayback) return;
+      const session = { stopPlayback, timer: null as number | null };
+      animatedRef.current = session;
+      const renderFrame = async () => {
+        try {
+          const batch = await runtime.renderPreviews(
+            target,
+            [{ id: options.animatedPreview.id, grading: toPreviewColorGrading(next) }],
+            { maxDimension: previewMaxDimension(), useMediaTime: true },
+          );
+          const image = batch?.images[0]?.dataUrl;
+          if (animatedRef.current !== session || !batch || !image) return;
+          setState((current) => ({
+            ...current,
+            previews: {
+              ...current.previews,
+              [options.animatedPreview.kind]: {
+                ...current.previews[options.animatedPreview.kind],
+                status: "ready",
+                images: {
+                  ...current.previews[options.animatedPreview.kind].images,
+                  [options.animatedPreview.id]: image,
+                },
+                width: batch.width,
+                height: batch.height,
+              },
+            },
+          }));
+        } catch {
+          // A later frame can recover after media/runtime readiness races.
+        } finally {
+          if (animatedRef.current === session) {
+            session.timer = window.setTimeout(() => void renderFrame(), 100);
+          }
+        }
+      };
+      void renderFrame();
+    },
+    [gradingRef, postColorGrading, previewIframeRef, stopAnimatedPreview, target],
+  );
+
+  useEffect(() => stopAnimatedPreview, [identityKey, stopAnimatedPreview]);
+
+  const requestPreviews = useCallback(
+    (kind: ColorGradingPreviewKind, effects?: readonly HfColorGradingActiveEffectKey[]) => {
+      setRequest((current) => ({
+        kind,
+        version: (current?.version ?? 0) + 1,
+        effects,
+      }));
+    },
+    [],
+  );
+  const requestPresetPreviews = useCallback(() => requestPreviews("presets"), [requestPreviews]);
+  const requestEffectPreviews = useCallback(
+    (effects: readonly HfColorGradingActiveEffectKey[]) => requestPreviews("effects", effects),
+    [requestPreviews],
+  );
+
+  return {
+    presetPreviews: previews.presets,
+    effectPreviews: previews.effects,
+    requestPresetPreviews,
+    requestEffectPreviews,
+    previewColorGrading,
+  };
+}
diff --git a/packages/studio/src/hooks/useBlockHandlers.ts b/packages/studio/src/hooks/useBlockHandlers.ts
index 886c219ec4..368de32027 100644
--- a/packages/studio/src/hooks/useBlockHandlers.ts
+++ b/packages/studio/src/hooks/useBlockHandlers.ts
@@ -9,6 +9,7 @@ import { addBlockToProject } from "../utils/blockInstaller";
 import type { BlockParam } from "@hyperframes/core/registry";
 import type { EditHistoryKind } from "../utils/editHistory";
 import type { RightPanelTab } from "../utils/studioHelpers";
+import type { MediaOverlayPlacement } from "../components/editor/propertyPanelTypes";
 
 interface BlockCtxDeps {
   activeCompPath: string | null;
@@ -46,6 +47,7 @@ export interface UseBlockHandlersResult {
   >;
   handleAddBlock: (blockName: string) => void;
   handleTimelineBlockDrop: (blockName: string, placement: { start: number; track: number }) => void;
+  handleAddMediaOverlay: (blockName: string, placement: MediaOverlayPlacement) => Promise<void>;
   handlePreviewBlockDrop: (blockName: string, position: { left: number; top: number }) => void;
 }
 
@@ -151,6 +153,25 @@ export function useBlockHandlers({
     [projectId, blockCtx, previewIframeRef, runBlockInstall],
   );
 
+  const handleAddMediaOverlay = useCallback(
+    async (blockName: string, placement: MediaOverlayPlacement) => {
+      if (!projectId) return;
+      const { compositionPath, ...timelinePlacement } = placement;
+      await runBlockInstall(blockName, () =>
+        addBlockToProject({
+          projectId,
+          blockName,
+          ...blockCtx,
+          activeCompPath: compositionPath ?? blockCtx.activeCompPath,
+          placement: timelinePlacement,
+          previewIframe: previewIframeRef.current,
+          currentTime: usePlayerStore.getState().currentTime,
+        }),
+      );
+    },
+    [projectId, blockCtx, previewIframeRef, runBlockInstall],
+  );
+
   const handlePreviewBlockDrop = useCallback(
     (blockName: string, position: { left: number; top: number }) => {
       if (!projectId) return;
@@ -173,6 +194,7 @@ export function useBlockHandlers({
     setActiveBlockParams,
     handleAddBlock,
     handleTimelineBlockDrop,
+    handleAddMediaOverlay,
     handlePreviewBlockDrop,
   };
 }
diff --git a/packages/studio/src/utils/blockInstaller.test.ts b/packages/studio/src/utils/blockInstaller.test.ts
new file mode 100644
index 0000000000..8f75ee35ea
--- /dev/null
+++ b/packages/studio/src/utils/blockInstaller.test.ts
@@ -0,0 +1,67 @@
+// @vitest-environment happy-dom
+
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { addBlockToProject } from "./blockInstaller";
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+describe("addBlockToProject", () => {
+  it("uses an explicit selected-media duration and track for a Registry overlay block", async () => {
+    const componentPath = "compositions/camcorder-hud.html";
+    const targetPath = "compositions/scene.html";
+    const files = new Map([
+      [
+        componentPath,
+        `<body><div data-composition-id="camcorder-hud"><div class="hud"></div></div></body>`,
+      ],
+      [
+        targetPath,
+        `<main data-composition-id="scene" data-duration="10" data-width="1920" data-height="1080"></main>`,
+      ],
+    ]);
+    vi.stubGlobal(
+      "fetch",
+      vi.fn().mockResolvedValue({
+        ok: true,
+        json: async () => ({
+          written: [componentPath],
+          block: {
+            name: "camcorder-hud",
+            title: "Camcorder HUD",
+            description: "HUD",
+            type: "hyperframes:block",
+            files: [],
+            dimensions: { width: 1920, height: 1080 },
+            duration: 4,
+          },
+        }),
+      }),
+    );
+    const writeProjectFile = vi.fn(async (path: string, content: string) => {
+      files.set(path, content);
+    });
+
+    const result = await addBlockToProject({
+      projectId: "project",
+      blockName: "camcorder-hud",
+      activeCompPath: targetPath,
+      placement: { start: 2.5, duration: 4.25, track: 3 },
+      timelineElements: [],
+      readProjectFile: async (path) => files.get(path) ?? "",
+      writeProjectFile,
+      recordEdit: vi.fn().mockResolvedValue(undefined),
+      refreshFileTree: vi.fn().mockResolvedValue(undefined),
+      reloadPreview: vi.fn(),
+      showToast: vi.fn(),
+    });
+
+    expect(result?.block.name).toBe("camcorder-hud");
+    const source = files.get(targetPath);
+    expect(source).toContain('data-composition-src="compositions/camcorder-hud.html"');
+    expect(source).toContain('data-start="2.5"');
+    expect(source).toContain('data-duration="4.25"');
+    expect(source).toContain('data-track-index="3"');
+  });
+});
diff --git a/packages/studio/src/utils/blockInstaller.ts b/packages/studio/src/utils/blockInstaller.ts
index 89cd45b2eb..4406381845 100644
--- a/packages/studio/src/utils/blockInstaller.ts
+++ b/packages/studio/src/utils/blockInstaller.ts
@@ -30,7 +30,7 @@ interface AddBlockOptions {
   projectId: string;
   blockName: string;
   activeCompPath: string | null;
-  placement?: { start: number; track: number };
+  placement?: { start: number; duration?: number; track?: number };
   visualPosition?: { left: number; top: number };
   previewIframe?: HTMLIFrameElement | null;
   currentTime?: number;
@@ -56,6 +56,121 @@ function buildUniqueCompositionId(baseName: string, existingIds: Iterable<string
   return `${baseName}_${i}`;
 }
 
+async function installRegistryItem({
+  projectId,
+  blockName,
+  showToast,
+}: Pick<AddBlockOptions, "projectId" | "blockName" | "showToast">): Promise<{
+  block: RegistryItem;
+  compositionFile: string;
+} | null> {
+  const response = await fetch(`/api/projects/${projectId}/registry/install`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ blockName }),
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ error: "Install failed" }));
+    showToast((error as { error?: string }).error || "Failed to install block");
+    return null;
+  }
+  const { written, block } = (await response.json()) as {
+    written: string[];
+    block: RegistryItem;
+  };
+  const compositionFile = written.find((file) => file.endsWith(".html")) ?? written[0];
+  if (!compositionFile) {
+    showToast("Installed but no composition file was written");
+    return null;
+  }
+  return { block, compositionFile };
+}
+
+async function makeComponentBackgroundTransparent(
+  block: RegistryItem,
+  compositionFile: string,
+  readProjectFile: AddBlockOptions["readProjectFile"],
+  writeProjectFile: AddBlockOptions["writeProjectFile"],
+): Promise<void> {
+  if (block.type !== "hyperframes:component") return;
+  const content = await readProjectFile(compositionFile);
+  const transparentContent = content.replace(
+    /background:\s*(?:#(?:0a0a0a|000000|000|0a0805)|rgba?\([^)]*\))\s*;/g,
+    "background: transparent;",
+  );
+  if (transparentContent !== content) await writeProjectFile(compositionFile, transparentContent);
+}
+
+function resolveBlockPlacement({
+  block,
+  placement,
+  timelineElements,
+  currentTime,
+}: {
+  block: RegistryItem;
+  placement: AddBlockOptions["placement"];
+  timelineElements: TimelineElement[];
+  currentTime: number;
+}) {
+  const isBlock = block.type === "hyperframes:block";
+  const {
+    start: placementStart = currentTime,
+    duration: placementDuration,
+    track: placementTrack,
+  } = placement ?? {};
+  const start = Number(formatTimelineAttributeNumber(placementStart));
+  const blockDuration = "duration" in block ? (block as { duration: number }).duration : undefined;
+  const duration =
+    placementDuration ??
+    blockDuration ??
+    timelineElements.reduce(
+      (max, element) => Math.max(max, (element.start ?? 0) + (element.duration ?? 0)),
+      10,
+    );
+  const nextTrack = Math.max(0, ...timelineElements.map((element) => element.track)) + 1;
+  const track = placementTrack ?? (isBlock ? 0 : nextTrack);
+  return { duration, isBlock, start, track };
+}
+
+function buildSubCompositionHtml({
+  id,
+  compositionFile,
+  start,
+  duration,
+  track,
+  width,
+  height,
+  left,
+  top,
+  zIndex,
+}: {
+  id: string;
+  compositionFile: string;
+  start: number;
+  duration: number;
+  track: number;
+  width: number;
+  height: number;
+  left: number;
+  top: number;
+  zIndex: number;
+}): string {
+  return [
+    `<div`,
+    `  id="${id}"`,
+    `  data-hf-id="hf-${generateId()}"`,
+    `  data-composition-id="${id}"`,
+    `  data-composition-src="${compositionFile}"`,
+    `  data-start="${formatTimelineAttributeNumber(start)}"`,
+    `  data-duration="${formatTimelineAttributeNumber(duration)}"`,
+    `  data-track-index="${track}"`,
+    `  data-width="${width}"`,
+    `  data-height="${height}"`,
+    `  style="position: absolute; left: ${left}px; top: ${top}px; width: ${width}px; height: ${height}px; z-index: ${zIndex}"`,
+    `></div>`,
+  ].join("\n");
+}
+
 export async function addBlockToProject(
   opts: AddBlockOptions,
 ): Promise<{ block: RegistryItem; compositionPath: string } | null> {
@@ -75,115 +190,53 @@ export async function addBlockToProject(
   } = opts;
 
   try {
-    const res = await fetch(`/api/projects/${projectId}/registry/install`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ blockName }),
+    const installed = await installRegistryItem({ projectId, blockName, showToast });
+    if (!installed) return null;
+    const { block, compositionFile } = installed;
+    await makeComponentBackgroundTransparent(
+      block,
+      compositionFile,
+      readProjectFile,
+      writeProjectFile,
+    );
+
+    const targetPath = activeCompPath || "index.html";
+    const originalContent = await readProjectFile(targetPath);
+    const relevantElements = timelineElements.filter(
+      (element) => (element.sourceFile || targetPath) === targetPath,
+    );
+    const { duration, isBlock, start, track } = resolveBlockPlacement({
+      block,
+      placement,
+      timelineElements: relevantElements,
+      currentTime: opts.currentTime ?? 0,
+    });
+    const { width, height } = resolveTimelineAssetCompositionSize(originalContent);
+    const subComposition = buildSubCompositionHtml({
+      id: buildUniqueCompositionId(block.name, collectHtmlIds(originalContent)),
+      compositionFile,
+      start,
+      duration,
+      track,
+      width,
+      height,
+      left: visualPosition ? Math.round(visualPosition.left) : 0,
+      top: visualPosition ? Math.round(visualPosition.top) : 0,
+      zIndex: getMaxZIndexFromIframe(opts.previewIframe ?? null) + 1,
+    });
+    const patchedContent = extendRootDurationInSource(
+      insertTimelineAssetIntoSource(originalContent, subComposition),
+      start + duration,
+    );
+    await saveProjectFilesWithHistory({
+      projectId,
+      label: `Add ${isBlock ? "block" : "component"}: ${block.title}`,
+      kind: "timeline",
+      files: { [targetPath]: patchedContent },
+      readFile: async () => originalContent,
+      writeFile: writeProjectFile,
+      recordEdit,
     });
-
-    if (!res.ok) {
-      const err = await res.json().catch(() => ({ error: "Install failed" }));
-      showToast((err as { error?: string }).error || "Failed to install block");
-      return null;
-    }
-
-    const { written, block } = (await res.json()) as {
-      written: string[];
-      block: RegistryItem;
-    };
-
-    const compositionFile = written.find((f) => f.endsWith(".html")) ?? written[0];
-    if (!compositionFile) {
-      showToast("Installed but no composition file was written");
-      return null;
-    }
-
-    if (block.type === "hyperframes:component") {
-      const compContent = await readProjectFile(compositionFile);
-      const transparentContent = compContent.replace(
-        /background:\s*(?:#(?:0a0a0a|000000|000|0a0805)|rgba?\([^)]*\))\s*;/g,
-        "background: transparent;",
-      );
-      if (transparentContent !== compContent) {
-        await writeProjectFile(compositionFile, transparentContent);
-      }
-    }
-
-    {
-      const targetPath = activeCompPath || "index.html";
-      const originalContent = await readProjectFile(targetPath);
-      const existingIds = collectHtmlIds(originalContent);
-      const compId = buildUniqueCompositionId(block.name, existingIds);
-
-      const resolvedTargetPath = targetPath || "index.html";
-      const relevantElements = timelineElements.filter(
-        (te) => (te.sourceFile || activeCompPath || "index.html") === resolvedTargetPath,
-      );
-
-      const isBlock = block.type === "hyperframes:block";
-      const { width: hostWidth, height: hostHeight } =
-        resolveTimelineAssetCompositionSize(originalContent);
-      const hostDims = { left: 0, top: 0, width: hostWidth, height: hostHeight };
-
-      const currentTime = opts.currentTime ?? 0;
-      const start = placement
-        ? Number(formatTimelineAttributeNumber(placement.start))
-        : Number(formatTimelineAttributeNumber(currentTime));
-      const blockDuration =
-        "duration" in block ? (block as { duration: number }).duration : undefined;
-      const duration =
-        blockDuration ??
-        relevantElements.reduce(
-          (max, te) => Math.max(max, (te.start ?? 0) + (te.duration ?? 0)),
-          10,
-        );
-      const track =
-        placement?.track ??
-        (isBlock
-          ? 0
-          : relevantElements.length > 0
-            ? Math.max(...relevantElements.map((te) => te.track)) + 1
-            : 1);
-
-      const zIndex = getMaxZIndexFromIframe(opts.previewIframe ?? null) + 1;
-
-      const width = hostDims.width;
-      const height = hostDims.height;
-
-      const left = visualPosition ? Math.round(visualPosition.left) : 0;
-      const top = visualPosition ? Math.round(visualPosition.top) : 0;
-
-      const subCompHtml = [
-        `<div`,
-        // A stable id (+ hf-id) is what authored sub-comps carry; without it the
-        // timeline can't dedup the host and renders duplicate clips that multiply
-        // on every interaction. Matches the authored-comp shape.
-        `  id="${compId}"`,
-        `  data-hf-id="hf-${generateId()}"`,
-        `  data-composition-id="${compId}"`,
-        `  data-composition-src="${compositionFile}"`,
-        `  data-start="${formatTimelineAttributeNumber(start)}"`,
-        `  data-duration="${formatTimelineAttributeNumber(duration)}"`,
-        `  data-track-index="${track}"`,
-        `  data-width="${width}"`,
-        `  data-height="${height}"`,
-        `  style="position: absolute; left: ${left}px; top: ${top}px; width: ${width}px; height: ${height}px; z-index: ${zIndex}"`,
-        `></div>`,
-      ].join("\n");
-
-      let patchedContent = insertTimelineAssetIntoSource(originalContent, subCompHtml);
-      patchedContent = extendRootDurationInSource(patchedContent, start + duration);
-
-      await saveProjectFilesWithHistory({
-        projectId,
-        label: `Add ${isBlock ? "block" : "component"}: ${block.title}`,
-        kind: "timeline",
-        files: { [targetPath]: patchedContent },
-        readFile: async () => originalContent,
-        writeFile: writeProjectFile,
-        recordEdit,
-      });
-    }
 
     await refreshFileTree();
     reloadPreview();

From d5c7d3ee16c2db53b91c66353d4f6387fe23e920 Mon Sep 17 00:00:00 2001
From: ukimsanov <ular.kimsanov@heygen.com>
Date: Fri, 24 Jul 2026 09:19:34 -0700
Subject: [PATCH 055/125] fix(studio): preserve composed media treatments

---
 .../editor/useColorGradingController.test.ts  | 18 ++++++--
 .../editor/useColorGradingController.ts       |  9 +++-
 packages/studio/src/hooks/useBlockCatalog.ts  | 44 +++++++++++++------
 3 files changed, 54 insertions(+), 17 deletions(-)

diff --git a/packages/studio/src/components/editor/useColorGradingController.test.ts b/packages/studio/src/components/editor/useColorGradingController.test.ts
index 40fe3cd90b..d16fe5f620 100644
--- a/packages/studio/src/components/editor/useColorGradingController.test.ts
+++ b/packages/studio/src/components/editor/useColorGradingController.test.ts
@@ -490,15 +490,27 @@ describe("useColorGradingController", () => {
     vi.useRealTimers();
   });
 
-  it("resetGrading returns to the neutral preset", () => {
+  it("resetGrading resets Grade fields without clearing Effects or Palette", () => {
     const { root, getState } = renderHook(vi.fn());
+    const grading = normalizeHfColorGrading({
+      preset: "bright-pop",
+      lut: { src: "assets/luts/custom.cube", intensity: 0.6 },
+      effects: { pixelate: 0.5 },
+      palette: ["#112233", "#ffffff"],
+    });
+    if (!grading) throw new Error("expected grading to normalize");
     act(() => {
-      getState().commitColorGrading(brightPopGrading());
+      getState().commitColorGrading(grading);
     });
     act(() => {
       getState().resetGrading();
     });
-    expect(getState().grading.preset).toBe("neutral");
+    expect(getState().grading).toMatchObject({
+      preset: "neutral",
+      lut: null,
+      effects: { pixelate: 0.5 },
+      palette: ["#112233", "#ffffff"],
+    });
     act(() => root.unmount());
   });
 
diff --git a/packages/studio/src/components/editor/useColorGradingController.ts b/packages/studio/src/components/editor/useColorGradingController.ts
index 87ab54dfde..e1994401d6 100644
--- a/packages/studio/src/components/editor/useColorGradingController.ts
+++ b/packages/studio/src/components/editor/useColorGradingController.ts
@@ -542,6 +542,13 @@ export function useColorGradingController({
     commitCompare,
     setApplyScope,
     applyToScope,
-    resetGrading: () => commitColorGrading(defaultColorGrading()),
+    resetGrading: () => {
+      const neutral = defaultColorGrading();
+      commitColorGrading({
+        ...neutral,
+        effects: latestGradingRef.current.effects,
+        palette: latestGradingRef.current.palette,
+      });
+    },
   };
 }
diff --git a/packages/studio/src/hooks/useBlockCatalog.ts b/packages/studio/src/hooks/useBlockCatalog.ts
index 74a7eadee1..7efaee4d4e 100644
--- a/packages/studio/src/hooks/useBlockCatalog.ts
+++ b/packages/studio/src/hooks/useBlockCatalog.ts
@@ -6,33 +6,51 @@ import {
   resolveBlockCategory,
 } from "../utils/blockCategories";
 
-export type CatalogItem = RegistryItem & {
+type CatalogItem = RegistryItem & {
   category: BlockCategory;
 };
 
+let catalogCache: CatalogItem[] | null = null;
+let catalogRequest: Promise<CatalogItem[]> | null = null;
+
+function loadCatalog(): Promise<CatalogItem[]> {
+  catalogRequest ??= fetch("/api/registry/blocks")
+    .then((response) => {
+      if (!response.ok) throw new Error("Failed to load catalog");
+      return response.json() as Promise<RegistryItem[]>;
+    })
+    .then((items) => {
+      catalogCache = items
+        .map((item) => ({ ...item, category: resolveBlockCategory(item.tags) }))
+        .sort((a, b) => {
+          const aIndex = BLOCK_CATEGORIES.findIndex((category) => category.id === a.category);
+          const bIndex = BLOCK_CATEGORIES.findIndex((category) => category.id === b.category);
+          return (aIndex === -1 ? 99 : aIndex) - (bIndex === -1 ? 99 : bIndex);
+        });
+      return catalogCache;
+    })
+    .catch((error: unknown) => {
+      catalogRequest = null;
+      throw error;
+    });
+  return catalogRequest;
+}
+
 export function useBlockCatalog() {
-  const [blocks, setBlocks] = useState<CatalogItem[]>([]);
-  const [loading, setLoading] = useState(true);
+  const [blocks, setBlocks] = useState<CatalogItem[]>(() => catalogCache ?? []);
+  const [loading, setLoading] = useState(catalogCache === null);
   const [error, setError] = useState<string | null>(null);
   const [search, setSearch] = useState("");
   const [category, setCategory] = useState<BlockCategory | null>(null);
 
   // fallow-ignore-next-line complexity
   useEffect(() => {
+    if (catalogCache) return;
     let cancelled = false;
     (async () => {
       try {
-        const res = await fetch("/api/registry/blocks");
-        if (!res.ok) throw new Error("Failed to load catalog");
-        const data = (await res.json()) as RegistryItem[];
+        const items = await loadCatalog();
         if (cancelled) return;
-        const items = data
-          .map((b) => ({ ...b, category: resolveBlockCategory(b.tags) }))
-          .sort((a, b) => {
-            const ia = BLOCK_CATEGORIES.findIndex((c) => c.id === a.category);
-            const ib = BLOCK_CATEGORIES.findIndex((c) => c.id === b.category);
-            return (ia === -1 ? 99 : ia) - (ib === -1 ? 99 : ib);
-          });
         setBlocks(items);
       } catch (err) {
         if (cancelled) return;

From bf47416e144bbd45c41375f357b229215aa11ccb Mon Sep 17 00:00:00 2001
From: ukimsanov <ular.kimsanov@heygen.com>
Date: Thu, 23 Jul 2026 22:00:35 -0700
Subject: [PATCH 056/125] refactor(studio): simplify preview workspace layout

---
 .../src/components/StudioLeftSidebar.tsx      |   5 +-
 .../src/components/StudioRightPanel.tsx       |   6 +-
 .../studio/src/components/nle/NLEContext.tsx  |   2 +-
 .../src/contexts/PanelLayoutContext.tsx       |   9 +-
 .../studio/src/hooks/usePanelLayout.test.ts   |  69 +++-
 packages/studio/src/hooks/usePanelLayout.ts   | 106 +++++--
 .../player/components/PlayerControls.test.ts  |  20 --
 .../src/player/components/PlayerControls.tsx  | 297 ++++--------------
 .../src/player/components/ShortcutsPanel.tsx  |   6 +-
 .../src/player/components/SpeedMenu.tsx       |   3 +-
 .../src/player/components/useSeekBarDrag.ts   | 169 ----------
 .../src/utils/studioUiPreferences.test.ts     |   5 +
 .../studio/src/utils/studioUiPreferences.ts   |   8 +
 13 files changed, 233 insertions(+), 472 deletions(-)
 delete mode 100644 packages/studio/src/player/components/PlayerControls.test.ts
 delete mode 100644 packages/studio/src/player/components/useSeekBarDrag.ts

diff --git a/packages/studio/src/components/StudioLeftSidebar.tsx b/packages/studio/src/components/StudioLeftSidebar.tsx
index 9db71a2d23..40842ecc58 100644
--- a/packages/studio/src/components/StudioLeftSidebar.tsx
+++ b/packages/studio/src/components/StudioLeftSidebar.tsx
@@ -38,7 +38,7 @@ export function StudioLeftSidebar({
   const {
     leftCollapsed,
     leftWidth,
-    setLeftWidth,
+    adjustPanelWidth,
     toggleLeftSidebar,
     handlePanelResizeStart,
     handlePanelResizeMove,
@@ -173,8 +173,7 @@ export function StudioLeftSidebar({
           if (e.key !== "ArrowLeft" && e.key !== "ArrowRight") return;
           e.preventDefault();
           const delta = e.key === "ArrowLeft" ? -16 : 16;
-          const maxLeft = Math.floor(window.innerWidth * 0.5);
-          setLeftWidth(Math.max(160, Math.min(maxLeft, leftWidth + delta)));
+          adjustPanelWidth("left", delta);
         }}
       >
         {/* Expanded hit zone: 8px wide, centered on the 3px seam */}
diff --git a/packages/studio/src/components/StudioRightPanel.tsx b/packages/studio/src/components/StudioRightPanel.tsx
index 178407f679..fc96e3605c 100644
--- a/packages/studio/src/components/StudioRightPanel.tsx
+++ b/packages/studio/src/components/StudioRightPanel.tsx
@@ -96,7 +96,7 @@ export function StudioRightPanel({
 }: StudioRightPanelProps) {
   const {
     rightWidth,
-    setRightWidth,
+    adjustPanelWidth,
     rightPanelTab,
     setRightPanelTab,
     rightInspectorPanes,
@@ -464,7 +464,7 @@ export function StudioRightPanel({
           e.preventDefault();
           // Panel is right-anchored: ArrowLeft grows it, ArrowRight shrinks it.
           const delta = e.key === "ArrowLeft" ? 16 : -16;
-          setRightWidth(Math.max(160, Math.min(600, rightWidth + delta)));
+          adjustPanelWidth("right", delta);
         }}
       >
         {/* Expanded hit zone: 8px wide, centered on the 3px seam */}
@@ -473,7 +473,7 @@ export function StudioRightPanel({
         <div className="absolute top-1/2 left-0 h-[52px] w-[3px] -translate-y-1/2 bg-white/12 transition-colors group-hover:bg-white/18 group-active:bg-white/24" />
       </div>
       <div
-        className="flex min-w-0 flex-shrink-0 flex-col overflow-hidden rounded-lg border border-neutral-800 bg-neutral-900"
+        className="flex min-w-0 flex-shrink-0 flex-col overflow-hidden rounded-lg border border-neutral-800 bg-neutral-950"
         style={{ width: rightWidth }}
       >
         {captionEditMode ? (
diff --git a/packages/studio/src/components/nle/NLEContext.tsx b/packages/studio/src/components/nle/NLEContext.tsx
index 968fcafb75..5bdece6459 100644
--- a/packages/studio/src/components/nle/NLEContext.tsx
+++ b/packages/studio/src/components/nle/NLEContext.tsx
@@ -19,7 +19,7 @@ import { useAssetPreviewStore } from "../../utils/assetPreviewStore";
 
 // Timeline gets a generous default height so the preview isn't oversized and the
 // tracks have room to breathe (CapCut-style). Users can still drag the divider.
-const DEFAULT_TIMELINE_H = 340;
+const DEFAULT_TIMELINE_H = 360;
 
 export function shouldDisableTimelineWhileCompositionLoading(compositionLoading: boolean): boolean {
   return compositionLoading;
diff --git a/packages/studio/src/contexts/PanelLayoutContext.tsx b/packages/studio/src/contexts/PanelLayoutContext.tsx
index 67ed23da4f..b696da0a8b 100644
--- a/packages/studio/src/contexts/PanelLayoutContext.tsx
+++ b/packages/studio/src/contexts/PanelLayoutContext.tsx
@@ -14,9 +14,8 @@ export function usePanelLayoutContext(): PanelLayoutValue {
 export function PanelLayoutProvider({
   value: {
     leftWidth,
-    setLeftWidth,
     rightWidth,
-    setRightWidth,
+    adjustPanelWidth,
     leftCollapsed,
     setLeftCollapsed,
     rightCollapsed,
@@ -39,9 +38,8 @@ export function PanelLayoutProvider({
   const stable = useMemo<PanelLayoutValue>(
     () => ({
       leftWidth,
-      setLeftWidth,
       rightWidth,
-      setRightWidth,
+      adjustPanelWidth,
       leftCollapsed,
       setLeftCollapsed,
       rightCollapsed,
@@ -58,9 +56,8 @@ export function PanelLayoutProvider({
     }),
     [
       leftWidth,
-      setLeftWidth,
       rightWidth,
-      setRightWidth,
+      adjustPanelWidth,
       leftCollapsed,
       setLeftCollapsed,
       rightCollapsed,
diff --git a/packages/studio/src/hooks/usePanelLayout.test.ts b/packages/studio/src/hooks/usePanelLayout.test.ts
index b1ddf2fa17..0a3d18a7c3 100644
--- a/packages/studio/src/hooks/usePanelLayout.test.ts
+++ b/packages/studio/src/hooks/usePanelLayout.test.ts
@@ -2,11 +2,30 @@
 
 import React, { act } from "react";
 import { createRoot } from "react-dom/client";
-import { afterEach, describe, expect, it, vi } from "vitest";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { readStudioUiPreferences } from "../utils/studioUiPreferences";
 import { usePanelLayout } from "./usePanelLayout";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
+beforeEach(() => {
+  const entries = new Map<string, string>();
+  Object.defineProperty(window, "localStorage", {
+    configurable: true,
+    value: {
+      get length() {
+        return entries.size;
+      },
+      clear: () => entries.clear(),
+      getItem: (key: string) => entries.get(key) ?? null,
+      key: (index: number) => Array.from(entries.keys())[index] ?? null,
+      removeItem: (key: string) => entries.delete(key),
+      setItem: (key: string, value: string) => entries.set(key, value),
+    } satisfies Storage,
+  });
+  Object.defineProperty(window, "innerWidth", { configurable: true, value: 1496 });
+});
+
 afterEach(() => {
   document.body.innerHTML = "";
   vi.doUnmock("../components/editor/manualEditingAvailability");
@@ -42,6 +61,54 @@ function renderPanelLayout() {
 }
 
 describe("usePanelLayout — right inspector panes", () => {
+  it("opens Design with the intended viewport-scaled panel widths", () => {
+    const harness = renderPanelLayout();
+
+    expect(harness.getState()).toMatchObject({
+      leftWidth: 384,
+      rightWidth: 424,
+      rightCollapsed: false,
+      rightPanelTab: "design",
+    });
+
+    harness.unmount();
+  });
+
+  it("persists the latest pointer width even before React rerenders", () => {
+    const harness = renderPanelLayout();
+    const state = harness.getState();
+    const target = { setPointerCapture: vi.fn() };
+
+    act(() => {
+      state.handlePanelResizeStart("left", {
+        preventDefault: vi.fn(),
+        target,
+        pointerId: 1,
+        clientX: 100,
+      } as unknown as React.PointerEvent);
+      state.handlePanelResizeMove({ clientX: 140 } as React.PointerEvent);
+      state.handlePanelResizeEnd();
+    });
+
+    expect(harness.getState().leftWidth).toBe(424);
+    expect(readStudioUiPreferences().leftWidth).toBe(424);
+    harness.unmount();
+  });
+
+  it("accumulates and persists rapid keyboard resize steps", () => {
+    const harness = renderPanelLayout();
+    const state = harness.getState();
+
+    act(() => {
+      state.adjustPanelWidth("right", 16);
+      state.adjustPanelWidth("right", 16);
+    });
+
+    expect(harness.getState().rightWidth).toBe(456);
+    expect(readStudioUiPreferences().rightWidth).toBe(456);
+    harness.unmount();
+  });
+
   it("toggleRightInspectorPane independently flips one pane, allowing both open at once", () => {
     const harness = renderPanelLayout();
     expect(harness.getState().rightInspectorPanes).toEqual({ layers: false, design: true });
diff --git a/packages/studio/src/hooks/usePanelLayout.ts b/packages/studio/src/hooks/usePanelLayout.ts
index df94b244e2..cc358b6e65 100644
--- a/packages/studio/src/hooks/usePanelLayout.ts
+++ b/packages/studio/src/hooks/usePanelLayout.ts
@@ -13,30 +13,76 @@ export interface InitialPanelLayoutState {
   rightPanelTab?: RightPanelTab | null;
 }
 
+type PanelSide = "left" | "right";
+
 function getInitialRightInspectorPanes(tab?: RightPanelTab | null): RightInspectorPanes {
   if (tab === "layers") return { layers: true, design: false };
   return { layers: false, design: true };
 }
 
+function getInitialPanelWidths(): { left: number; right: number } {
+  const viewportWidth = typeof window === "undefined" ? 1496 : window.innerWidth;
+  const preferences = readStudioUiPreferences();
+  const leftDefault = Math.max(240, Math.min(384, Math.round(viewportWidth * 0.257)));
+  const rightDefault = Math.max(320, Math.min(424, Math.round(viewportWidth * 0.284)));
+  return {
+    left: Math.max(
+      160,
+      Math.min(Math.floor(viewportWidth * 0.5), preferences.leftWidth ?? leftDefault),
+    ),
+    right: Math.max(160, Math.min(600, preferences.rightWidth ?? rightDefault)),
+  };
+}
+
+function clampPanelWidth(side: PanelSide, width: number): number {
+  const max = side === "left" ? Math.floor(window.innerWidth * 0.5) : 600;
+  return Math.max(160, Math.min(max, width));
+}
+
 export function usePanelLayout(initialState?: InitialPanelLayoutState) {
-  const [leftWidth, setLeftWidth] = useState(240);
-  const [rightWidth, setRightWidth] = useState(400);
+  const [initialPanelWidths] = useState(getInitialPanelWidths);
+  const [leftWidth, setLeftWidth] = useState(initialPanelWidths.left);
+  const [rightWidth, setRightWidth] = useState(initialPanelWidths.right);
+  const panelWidthsRef = useRef(initialPanelWidths);
   const [leftCollapsed, setLeftCollapsed] = useState(
     () => readStudioUiPreferences().leftCollapsed ?? false,
   );
-  const [rightCollapsed, setRightCollapsed] = useState(initialState?.rightCollapsed ?? true);
+  const [rightCollapsed, setRightCollapsed] = useState(initialState?.rightCollapsed ?? false);
   const [rightPanelTab, setRightPanelTab] = useState<RightPanelTab>(
-    initialState?.rightPanelTab ?? "renders",
+    initialState?.rightPanelTab ?? "design",
   );
   const [rightInspectorPanes, setRightInspectorPanes] = useState<RightInspectorPanes>(() =>
     getInitialRightInspectorPanes(initialState?.rightPanelTab),
   );
   const panelDragRef = useRef<{
-    side: "left" | "right";
+    side: PanelSide;
     startX: number;
     startW: number;
   } | null>(null);
 
+  const updatePanelWidth = useCallback((side: PanelSide, width: number) => {
+    const next = clampPanelWidth(side, width);
+    panelWidthsRef.current[side] = next;
+    if (side === "left") setLeftWidth(next);
+    else setRightWidth(next);
+    return next;
+  }, []);
+
+  const commitPanelWidth = useCallback(
+    (side: PanelSide, width: number) => {
+      const next = updatePanelWidth(side, Math.round(width));
+      writeStudioUiPreferences(side === "left" ? { leftWidth: next } : { rightWidth: next });
+    },
+    [updatePanelWidth],
+  );
+
+  const adjustPanelWidth = useCallback(
+    (side: PanelSide, delta: number) => {
+      commitPanelWidth(side, panelWidthsRef.current[side] + delta);
+    },
+    [commitPanelWidth],
+  );
+
   const toggleLeftSidebar = useCallback(() => {
     setLeftCollapsed((collapsed) => {
       writeStudioUiPreferences({ leftCollapsed: !collapsed });
@@ -45,38 +91,31 @@ export function usePanelLayout(initialState?: InitialPanelLayoutState) {
     });
   }, []);
 
-  const handlePanelResizeStart = useCallback(
-    (side: "left" | "right", e: React.PointerEvent) => {
-      e.preventDefault();
-      (e.target as HTMLElement).setPointerCapture(e.pointerId);
-      panelDragRef.current = {
-        side,
-        startX: e.clientX,
-        startW: side === "left" ? leftWidth : rightWidth,
-      };
+  const handlePanelResizeStart = useCallback((side: PanelSide, e: React.PointerEvent) => {
+    e.preventDefault();
+    (e.target as HTMLElement).setPointerCapture(e.pointerId);
+    panelDragRef.current = {
+      side,
+      startX: e.clientX,
+      startW: panelWidthsRef.current[side],
+    };
+  }, []);
+
+  const handlePanelResizeMove = useCallback(
+    (e: React.PointerEvent) => {
+      const drag = panelDragRef.current;
+      if (!drag) return;
+      const delta = e.clientX - drag.startX;
+      updatePanelWidth(drag.side, drag.startW + (drag.side === "left" ? delta : -delta));
     },
-    [leftWidth, rightWidth],
+    [updatePanelWidth],
   );
 
-  const handlePanelResizeMove = useCallback((e: React.PointerEvent) => {
-    const drag = panelDragRef.current;
-    if (!drag) return;
-    const delta = e.clientX - drag.startX;
-    const maxLeft = Math.floor(window.innerWidth * 0.5);
-    const newW = Math.max(
-      160,
-      Math.min(
-        drag.side === "left" ? maxLeft : 600,
-        drag.startW + (drag.side === "left" ? delta : -delta),
-      ),
-    );
-    if (drag.side === "left") setLeftWidth(newW);
-    else setRightWidth(newW);
-  }, []);
-
   const handlePanelResizeEnd = useCallback(() => {
+    const side = panelDragRef.current?.side;
+    if (side) commitPanelWidth(side, panelWidthsRef.current[side]);
     panelDragRef.current = null;
-  }, []);
+  }, [commitPanelWidth]);
 
   const trackedSetRightPanelTab = useCallback(
     (tab: RightPanelTab) => {
@@ -120,9 +159,8 @@ export function usePanelLayout(initialState?: InitialPanelLayoutState) {
 
   return {
     leftWidth,
-    setLeftWidth,
     rightWidth,
-    setRightWidth,
+    adjustPanelWidth,
     leftCollapsed,
     setLeftCollapsed,
     rightCollapsed,
diff --git a/packages/studio/src/player/components/PlayerControls.test.ts b/packages/studio/src/player/components/PlayerControls.test.ts
deleted file mode 100644
index 84f23ac599..0000000000
--- a/packages/studio/src/player/components/PlayerControls.test.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { resolveSeekPercent } from "./PlayerControls";
-
-describe("resolveSeekPercent", () => {
-  it("returns 0 when the track width is invalid", () => {
-    expect(resolveSeekPercent(100, 0, 0)).toBe(0);
-  });
-
-  it("snaps to the start within the edge threshold", () => {
-    expect(resolveSeekPercent(105, 100, 200)).toBe(0);
-  });
-
-  it("snaps to the end within the edge threshold", () => {
-    expect(resolveSeekPercent(298, 100, 200)).toBe(1);
-  });
-
-  it("preserves the true percent away from the edges", () => {
-    expect(resolveSeekPercent(150, 100, 200)).toBe(0.25);
-  });
-});
diff --git a/packages/studio/src/player/components/PlayerControls.tsx b/packages/studio/src/player/components/PlayerControls.tsx
index 0ebe6ec2d2..1ac690617b 100644
--- a/packages/studio/src/player/components/PlayerControls.tsx
+++ b/packages/studio/src/player/components/PlayerControls.tsx
@@ -1,15 +1,13 @@
-import { useRef, useCallback, useEffect, memo } from "react";
+import { useRef, useEffect, memo } from "react";
 import gsap from "gsap";
 import { MorphSVGPlugin } from "gsap/MorphSVGPlugin";
-import { formatFrameTime, formatTime, stepFrameTime } from "../lib/time";
-import { usePlayerStore } from "../store/playerStore";
+import { formatFrameTime, formatTime } from "../lib/time";
+import { liveTime, usePlayerStore } from "../store/playerStore";
 import { trackStudioEvent } from "../../utils/studioTelemetry";
 import { Tooltip } from "../../components/ui";
+import { useMountEffect } from "../../hooks/useMountEffect";
 import { ShortcutsPanel } from "./ShortcutsPanel";
 import { SpeedMenu } from "./SpeedMenu";
-import { useSeekBarDrag, resolveSeekPercent } from "./useSeekBarDrag";
-
-export { resolveSeekPercent };
 
 /* ── Icon sub-components ─────────────────────────────────────────── */
 
@@ -78,10 +76,8 @@ const MuteButton = memo(function MuteButton({
         disabled={controlsDisabled}
         aria-label={label}
         aria-pressed={audioMuted}
-        className={`h-7 w-7 flex-shrink-0 flex items-center justify-center rounded-md border transition-colors disabled:pointer-events-none ${
-          audioMuted
-            ? "text-studio-accent bg-studio-accent/10 border-studio-accent/30"
-            : "border-neutral-700 text-neutral-400 hover:border-neutral-500 hover:bg-neutral-800"
+        className={`flex h-7 w-7 flex-shrink-0 items-center justify-center rounded-md transition-colors disabled:pointer-events-none disabled:opacity-30 ${
+          audioMuted ? "text-studio-accent" : "text-neutral-500 hover:text-neutral-200"
         }`}
       >
         <svg
@@ -131,10 +127,8 @@ const LoopButton = memo(function LoopButton({
           setLoopEnabled(!loopEnabled);
         }}
         disabled={disabled}
-        className={`h-7 w-7 flex items-center justify-center rounded-md border transition-colors ${
-          loopEnabled
-            ? "text-studio-accent bg-studio-accent/10 border-studio-accent/30"
-            : "border-neutral-700 text-neutral-400 hover:border-neutral-500 hover:bg-neutral-800"
+        className={`flex h-7 w-7 items-center justify-center rounded-md transition-colors disabled:opacity-30 ${
+          loopEnabled ? "text-studio-accent" : "text-neutral-500 hover:text-neutral-200"
         }`}
         aria-label={loopEnabled ? "Disable loop playback" : "Enable loop playback"}
         aria-pressed={loopEnabled}
@@ -175,10 +169,8 @@ const FullscreenButton = memo(function FullscreenButton({
           trackStudioEvent("playback", { action: "fullscreen_toggle", active: !isFullscreen });
           onToggleFullscreen();
         }}
-        className={`h-7 w-7 flex-shrink-0 flex items-center justify-center rounded-md border transition-colors ${
-          isFullscreen
-            ? "text-studio-accent bg-studio-accent/10 border-studio-accent/30"
-            : "border-neutral-700 text-neutral-400 hover:border-neutral-500 hover:bg-neutral-800"
+        className={`flex h-7 w-7 flex-shrink-0 items-center justify-center rounded-md transition-colors ${
+          isFullscreen ? "text-studio-accent" : "text-neutral-500 hover:text-neutral-200"
         }`}
         aria-label={isFullscreen ? "Exit fullscreen" : "Enter fullscreen"}
       >
@@ -214,118 +206,6 @@ const FullscreenButton = memo(function FullscreenButton({
   );
 });
 
-/* ── Seek bar sub-component ──────────────────────────────────────── */
-
-function SeekBarMarker({ position, duration }: { position: number; duration: number }) {
-  if (duration <= 0) return null;
-  return (
-    <div
-      className="absolute z-[3] pointer-events-none"
-      style={{
-        left: `${Math.min(100, (position / duration) * 100)}%`,
-        top: "50%",
-        transform: "translate(-50%, -50%)",
-        width: "2px",
-        height: "10px",
-        background: "#3CE6AC",
-        borderRadius: "1px",
-      }}
-    />
-  );
-}
-
-function WorkAreaOverlay({
-  inPoint,
-  outPoint,
-  duration,
-}: {
-  inPoint: number | null;
-  outPoint: number | null;
-  duration: number;
-}) {
-  if ((inPoint === null && outPoint === null) || duration <= 0) return null;
-  return (
-    <>
-      <div
-        className="absolute top-0 bottom-0 pointer-events-none"
-        style={{
-          left: `${inPoint !== null ? Math.min(100, (inPoint / duration) * 100) : 0}%`,
-          right: `${outPoint !== null ? 100 - Math.min(100, (outPoint / duration) * 100) : 0}%`,
-          background: "rgba(60,230,172,0.15)",
-        }}
-      />
-      {inPoint !== null && <SeekBarMarker position={inPoint} duration={duration} />}
-      {outPoint !== null && <SeekBarMarker position={outPoint} duration={duration} />}
-    </>
-  );
-}
-
-const SeekBar = memo(function SeekBar({
-  disabled,
-  duration,
-  inPoint,
-  outPoint,
-  progressFillRef,
-  progressThumbRef,
-  seekBarRef,
-  sliderRef,
-  onPointerDown,
-  onKeyDown,
-}: {
-  disabled: boolean;
-  duration: number;
-  inPoint: number | null;
-  outPoint: number | null;
-  progressFillRef: React.RefObject<HTMLDivElement | null>;
-  progressThumbRef: React.RefObject<HTMLDivElement | null>;
-  seekBarRef: React.RefObject<HTMLDivElement | null>;
-  sliderRef: React.RefObject<HTMLDivElement | null>;
-  onPointerDown: (e: React.PointerEvent<HTMLDivElement>) => void;
-  onKeyDown: (e: React.KeyboardEvent) => void;
-}) {
-  return (
-    <div
-      ref={(el) => {
-        (seekBarRef as React.MutableRefObject<HTMLDivElement | null>).current = el;
-        (sliderRef as React.MutableRefObject<HTMLDivElement | null>).current = el;
-      }}
-      role="slider"
-      tabIndex={disabled ? -1 : 0}
-      aria-label="Seek"
-      aria-disabled={disabled || undefined}
-      aria-valuemin={0}
-      aria-valuemax={Math.round(duration)}
-      aria-valuenow={0}
-      className={`min-w-[96px] flex-1 h-6 flex items-center group outline-none focus-visible:ring-1 focus-visible:ring-white/30 focus-visible:rounded ${
-        disabled ? "cursor-not-allowed opacity-50" : "cursor-pointer"
-      }`}
-      style={{ touchAction: "none" }}
-      onPointerDown={onPointerDown}
-      onKeyDown={onKeyDown}
-    >
-      <div
-        className="w-full rounded-full relative"
-        style={{ background: "rgba(255,255,255,0.15)", height: "3px" }}
-      >
-        <WorkAreaOverlay inPoint={inPoint} outPoint={outPoint} duration={duration} />
-        <div
-          ref={progressFillRef}
-          className="absolute top-0 bottom-0 left-0 z-[1] rounded-full"
-          style={{ background: "linear-gradient(90deg, var(--hf-accent, #3CE6AC), #2BBFA0)" }}
-        />
-        <div
-          ref={progressThumbRef}
-          className="absolute top-1/2 z-[4] w-3 h-3 rounded-full -translate-y-1/2 -translate-x-1/2 transition-transform group-hover:scale-125"
-          style={{
-            background: "var(--hf-accent, #3CE6AC)",
-            boxShadow: "0 0 6px rgba(60,230,172,0.4), 0 1px 4px rgba(0,0,0,0.4)",
-          }}
-        />
-      </div>
-    </div>
-  );
-});
-
 /* ── Main component ──────────────────────────────────────────────── */
 
 interface PlayerControlsProps {
@@ -359,12 +239,7 @@ export const PlayerControls = memo(function PlayerControls({
   const timeDisplayMode = usePlayerStore((s) => s.timeDisplayMode);
   const setTimeDisplayMode = usePlayerStore.getState().setTimeDisplayMode;
 
-  const progressFillRef = useRef<HTMLDivElement>(null);
-  const progressThumbRef = useRef<HTMLDivElement>(null);
   const timeDisplayRef = useRef<HTMLSpanElement>(null);
-  const seekBarRef = useRef<HTMLDivElement>(null);
-  const sliderRef = useRef<HTMLDivElement>(null);
-  const isDraggingRef = useRef(false);
   const currentTimeRef = useRef(0);
   const timeDisplayModeRef = useRef(timeDisplayMode);
   timeDisplayModeRef.current = timeDisplayMode;
@@ -380,64 +255,29 @@ export const PlayerControls = memo(function PlayerControls({
       timeDisplayMode === "frame" ? formatFrameTime(t, duration) : formatTime(t);
   }, [duration, timeDisplayMode]);
 
-  const { handlePointerDown } = useSeekBarDrag(
-    {
-      seekBarRef,
-      progressFillRef,
-      progressThumbRef,
-      sliderRef,
-      timeDisplayRef,
-      isDraggingRef,
-      durationRef,
-      currentTimeRef,
-      timeDisplayModeRef,
-    },
-    onSeek,
-    disabled,
-    duration,
-  );
-
-  const handleKeyDown = useCallback(
-    (e: React.KeyboardEvent) => {
-      if (disabled || !timelineReady || duration <= 0) return;
-      const step = e.shiftKey ? 10 : 1;
-      if (e.key === "ArrowLeft") {
-        e.preventDefault();
-        onSeek(stepFrameTime(currentTimeRef.current, -step));
-      } else if (e.key === "ArrowRight") {
-        e.preventDefault();
-        onSeek(Math.min(duration, stepFrameTime(currentTimeRef.current, step)));
-      }
-    },
-    [disabled, timelineReady, duration, onSeek],
-  );
+  useMountEffect(() => {
+    const updateTime = (time: number) => {
+      currentTimeRef.current = time;
+      if (!timeDisplayRef.current) return;
+      const currentDuration = durationRef.current;
+      timeDisplayRef.current.textContent =
+        timeDisplayModeRef.current === "frame"
+          ? formatFrameTime(time, currentDuration)
+          : formatTime(time);
+    };
+    const unsubscribe = liveTime.subscribe(updateTime);
+    updateTime(usePlayerStore.getState().currentTime);
+    return unsubscribe;
+  });
 
   return (
     <div
-      // No own background/border: the transport blends into the preview
-      // panel's surface — buttons carry their own chrome.
-      className="px-4 py-2 flex flex-wrap items-center gap-x-2 gap-y-1"
+      className="grid h-10 grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] items-center px-3"
       aria-disabled={disabled || undefined}
       style={{
-        paddingBottom: "calc(0.5rem + env(safe-area-inset-bottom))",
+        paddingBottom: "env(safe-area-inset-bottom)",
       }}
     >
-      <Tooltip label={isPlaying ? "Pause" : "Play"}>
-        <button
-          type="button"
-          aria-label={isPlaying ? "Pause" : "Play"}
-          onClick={() => {
-            trackStudioEvent("playback", { action: isPlaying ? "pause" : "play" });
-            onTogglePlay();
-          }}
-          disabled={controlsDisabled}
-          className="flex-shrink-0 w-8 h-8 flex items-center justify-center rounded-lg disabled:opacity-30 disabled:pointer-events-none transition-colors"
-          style={{ background: "rgba(255,255,255,0.06)" }}
-        >
-          <PlayPauseMorphIcon playing={isPlaying} />
-        </button>
-      </Tooltip>
-
       <Tooltip
         label={timeDisplayMode === "time" ? "Switch to frame display" : "Switch to time display"}
       >
@@ -445,59 +285,58 @@ export const PlayerControls = memo(function PlayerControls({
           type="button"
           onClick={() => setTimeDisplayMode(timeDisplayMode === "time" ? "frame" : "time")}
           disabled={disabled}
-          className="font-mono text-[11px] tabular-nums flex-shrink-0 w-[118px] text-left transition-colors disabled:pointer-events-none hover:opacity-80"
-          style={{ color: "#A1A1AA", cursor: "pointer" }}
+          className="min-w-0 justify-self-start whitespace-nowrap font-mono text-[11px] tabular-nums text-neutral-400 transition-colors hover:text-neutral-200 disabled:pointer-events-none"
         >
           <span ref={timeDisplayRef}>{formatTime(0)}</span>
           {timeDisplayMode === "time" ? (
             <>
-              <span style={{ color: "#3F3F46", margin: "0 2px" }}>/</span>
-              <span style={{ color: "#52525B" }}>{formatTime(duration)}</span>
+              <span className="mx-0.5 text-neutral-700">/</span>
+              <span className="text-neutral-600">{formatTime(duration)}</span>
             </>
           ) : null}
         </button>
       </Tooltip>
 
-      <SeekBar
-        disabled={disabled}
-        duration={duration}
-        inPoint={inPoint}
-        outPoint={outPoint}
-        progressFillRef={progressFillRef}
-        progressThumbRef={progressThumbRef}
-        seekBarRef={seekBarRef}
-        sliderRef={sliderRef}
-        onPointerDown={handlePointerDown}
-        onKeyDown={handleKeyDown}
-      />
-
-      <MuteButton
-        audioMuted={audioMuted}
-        controlsDisabled={controlsDisabled}
-        setAudioMuted={setAudioMuted}
-      />
-
-      <SpeedMenu
-        playbackRate={playbackRate}
-        setPlaybackRate={setPlaybackRate}
-        disabled={disabled}
-      />
-
-      <LoopButton loopEnabled={loopEnabled} disabled={disabled} setLoopEnabled={setLoopEnabled} />
-
-      {onToggleFullscreen && (
-        <FullscreenButton isFullscreen={isFullscreen} onToggleFullscreen={onToggleFullscreen} />
-      )}
+      <Tooltip label={isPlaying ? "Pause" : "Play"}>
+        <button
+          type="button"
+          aria-label={isPlaying ? "Pause" : "Play"}
+          onClick={() => {
+            trackStudioEvent("playback", { action: isPlaying ? "pause" : "play" });
+            onTogglePlay();
+          }}
+          disabled={controlsDisabled}
+          className="flex h-8 w-8 items-center justify-center justify-self-center rounded-md text-neutral-100 transition-colors hover:text-white disabled:pointer-events-none disabled:opacity-30"
+        >
+          <PlayPauseMorphIcon playing={isPlaying} />
+        </button>
+      </Tooltip>
 
-      <ShortcutsPanel
-        disabled={disabled}
-        duration={duration}
-        inPoint={inPoint}
-        outPoint={outPoint}
-        setInPoint={setInPoint}
-        setOutPoint={setOutPoint}
-        onSeek={onSeek}
-      />
+      <div className="flex min-w-0 items-center justify-self-end">
+        <MuteButton
+          audioMuted={audioMuted}
+          controlsDisabled={controlsDisabled}
+          setAudioMuted={setAudioMuted}
+        />
+        <SpeedMenu
+          playbackRate={playbackRate}
+          setPlaybackRate={setPlaybackRate}
+          disabled={disabled}
+        />
+        <LoopButton loopEnabled={loopEnabled} disabled={disabled} setLoopEnabled={setLoopEnabled} />
+        {onToggleFullscreen && (
+          <FullscreenButton isFullscreen={isFullscreen} onToggleFullscreen={onToggleFullscreen} />
+        )}
+        <ShortcutsPanel
+          disabled={disabled}
+          duration={duration}
+          inPoint={inPoint}
+          outPoint={outPoint}
+          setInPoint={setInPoint}
+          setOutPoint={setOutPoint}
+          onSeek={onSeek}
+        />
+      </div>
     </div>
   );
 });
diff --git a/packages/studio/src/player/components/ShortcutsPanel.tsx b/packages/studio/src/player/components/ShortcutsPanel.tsx
index 3ef8736013..50506ad46a 100644
--- a/packages/studio/src/player/components/ShortcutsPanel.tsx
+++ b/packages/studio/src/player/components/ShortcutsPanel.tsx
@@ -153,10 +153,8 @@ export const ShortcutsPanel = memo(function ShortcutsPanel({
         <button
           type="button"
           onClick={() => setShowShortcuts((v) => !v)}
-          className={`w-6 h-6 flex items-center justify-center rounded border transition-colors ${
-            showShortcuts
-              ? "border-neutral-600 text-neutral-200 bg-neutral-800"
-              : "border-neutral-800 text-neutral-600 hover:text-neutral-300 hover:border-neutral-600"
+          className={`flex h-7 w-7 items-center justify-center rounded-md transition-colors ${
+            showShortcuts ? "text-neutral-200" : "text-neutral-600 hover:text-neutral-300"
           }`}
           aria-label="Shortcuts and tools"
           aria-expanded={showShortcuts}
diff --git a/packages/studio/src/player/components/SpeedMenu.tsx b/packages/studio/src/player/components/SpeedMenu.tsx
index be4497aa5e..bd4e804296 100644
--- a/packages/studio/src/player/components/SpeedMenu.tsx
+++ b/packages/studio/src/player/components/SpeedMenu.tsx
@@ -41,8 +41,7 @@ export const SpeedMenu = memo(function SpeedMenu({
           type="button"
           onClick={() => setShowSpeedMenu((v) => !v)}
           disabled={disabled}
-          className="w-10 px-2 py-1 rounded-md text-[10px] font-mono tabular-nums transition-colors"
-          style={{ color: "#71717A", background: "rgba(255,255,255,0.04)" }}
+          className="h-7 w-8 rounded-md font-mono text-[10px] tabular-nums text-neutral-500 transition-colors hover:text-neutral-200 disabled:opacity-30"
         >
           {playbackRate === 1 ? "1x" : `${playbackRate}x`}
         </button>
diff --git a/packages/studio/src/player/components/useSeekBarDrag.ts b/packages/studio/src/player/components/useSeekBarDrag.ts
deleted file mode 100644
index 5fd0f054c6..0000000000
--- a/packages/studio/src/player/components/useSeekBarDrag.ts
+++ /dev/null
@@ -1,169 +0,0 @@
-import { useCallback } from "react";
-import { useMountEffect } from "../../hooks/useMountEffect";
-import { formatFrameTime, formatTime } from "../lib/time";
-import { usePlayerStore, liveTime } from "../store/playerStore";
-
-const SEEK_EDGE_SNAP_PX = 8;
-
-export function resolveSeekPercent(clientX: number, rectLeft: number, rectWidth: number): number {
-  if (!Number.isFinite(rectWidth) || rectWidth <= 0) return 0;
-  const rawPercent = (clientX - rectLeft) / rectWidth;
-  const clamped = Math.max(0, Math.min(1, rawPercent));
-  const snapThreshold = Math.min(0.5, SEEK_EDGE_SNAP_PX / rectWidth);
-  if (clamped <= snapThreshold) return 0;
-  if (clamped >= 1 - snapThreshold) return 1;
-  return clamped;
-}
-
-interface SeekBarRefs {
-  seekBarRef: React.RefObject<HTMLDivElement | null>;
-  progressFillRef: React.RefObject<HTMLDivElement | null>;
-  progressThumbRef: React.RefObject<HTMLDivElement | null>;
-  sliderRef: React.RefObject<HTMLDivElement | null>;
-  timeDisplayRef: React.RefObject<HTMLSpanElement | null>;
-  isDraggingRef: React.MutableRefObject<boolean>;
-  durationRef: React.MutableRefObject<number>;
-  currentTimeRef: React.MutableRefObject<number>;
-  timeDisplayModeRef: React.MutableRefObject<"time" | "frame">;
-}
-
-function updateProgressUI(
-  fillRef: React.RefObject<HTMLDivElement | null>,
-  thumbRef: React.RefObject<HTMLDivElement | null>,
-  pct: number,
-): void {
-  if (fillRef.current) fillRef.current.style.width = `${pct}%`;
-  if (thumbRef.current) thumbRef.current.style.left = `${pct}%`;
-}
-
-export function useSeekBarDrag(
-  refs: SeekBarRefs,
-  onSeek: (time: number) => void,
-  disabled: boolean,
-  duration: number,
-) {
-  const seekFromClientX = useCallback(
-    (clientX: number) => {
-      if (disabled) return;
-      const bar = refs.seekBarRef.current;
-      if (!bar || duration <= 0) return;
-      const rect = bar.getBoundingClientRect();
-      const percent = resolveSeekPercent(clientX, rect.left, rect.width);
-      updateProgressUI(refs.progressFillRef, refs.progressThumbRef, percent * 100);
-      onSeek(percent * duration);
-    },
-    [disabled, duration, onSeek, refs],
-  );
-
-  const handlePointerDown = useCallback(
-    (e: React.PointerEvent<HTMLDivElement>) => {
-      if (e.button !== 0) return;
-      e.preventDefault();
-      e.currentTarget.focus();
-      refs.isDraggingRef.current = true;
-
-      const target = e.currentTarget;
-      const pointerId = e.pointerId;
-      try {
-        target.setPointerCapture(pointerId);
-      } catch {
-        /* fallback to window listeners */
-      }
-
-      seekFromClientX(e.clientX);
-
-      let seekRafId = 0;
-      let pendingClientX = e.clientX;
-      const onMove = (ev: PointerEvent) => {
-        if (ev.pointerId !== pointerId || !refs.isDraggingRef.current) return;
-        pendingClientX = ev.clientX;
-        const bar = refs.seekBarRef.current;
-        const dur = refs.durationRef.current;
-        if (bar && dur > 0) {
-          const rect = bar.getBoundingClientRect();
-          const pct = resolveSeekPercent(ev.clientX, rect.left, rect.width) * 100;
-          updateProgressUI(refs.progressFillRef, refs.progressThumbRef, pct);
-        }
-        if (!seekRafId) {
-          seekRafId = requestAnimationFrame(() => {
-            seekRafId = 0;
-            if (refs.isDraggingRef.current) seekFromClientX(pendingClientX);
-          });
-        }
-      };
-      const cleanup = () => {
-        refs.isDraggingRef.current = false;
-        if (seekRafId) {
-          cancelAnimationFrame(seekRafId);
-          seekRafId = 0;
-        }
-        seekFromClientX(pendingClientX);
-        try {
-          target.releasePointerCapture(pointerId);
-        } catch {
-          /* already released */
-        }
-        target.removeEventListener("pointermove", onMove);
-        target.removeEventListener("pointerup", onUp);
-        target.removeEventListener("pointercancel", onUp);
-        window.removeEventListener("pointerup", onUp);
-        window.removeEventListener("pointercancel", onUp);
-        document.removeEventListener("visibilitychange", onVisibilityChange);
-        window.removeEventListener("blur", cleanup);
-        target.blur();
-      };
-      const onUp = (ev: PointerEvent) => {
-        if (ev.pointerId !== pointerId) return;
-        cleanup();
-      };
-      const onVisibilityChange = () => {
-        if (document.visibilityState === "hidden") cleanup();
-      };
-
-      target.addEventListener("pointermove", onMove);
-      target.addEventListener("pointerup", onUp);
-      target.addEventListener("pointercancel", onUp);
-      window.addEventListener("pointerup", onUp);
-      window.addEventListener("pointercancel", onUp);
-      document.addEventListener("visibilitychange", onVisibilityChange);
-      window.addEventListener("blur", cleanup);
-    },
-    [seekFromClientX, refs],
-  );
-
-  useMountEffect(() => {
-    const updateProgress = (t: number) => {
-      refs.currentTimeRef.current = t;
-      const dur = refs.durationRef.current;
-      const pct = dur > 0 ? Math.min(100, (t / dur) * 100) : 0;
-      updateProgressUI(refs.progressFillRef, refs.progressThumbRef, pct);
-      if (refs.timeDisplayRef.current) {
-        refs.timeDisplayRef.current.textContent =
-          refs.timeDisplayModeRef.current === "frame" ? formatFrameTime(t, dur) : formatTime(t);
-      }
-      if (refs.sliderRef.current)
-        refs.sliderRef.current.setAttribute("aria-valuenow", String(Math.round(t)));
-    };
-    const unsub = liveTime.subscribe(updateProgress);
-    updateProgress(usePlayerStore.getState().currentTime);
-
-    const interval = setInterval(() => {
-      const t = usePlayerStore.getState().currentTime;
-      const dur = usePlayerStore.getState().duration;
-      if (dur > 0 && t > 0) {
-        updateProgressUI(
-          refs.progressFillRef,
-          refs.progressThumbRef,
-          Math.min(100, (t / dur) * 100),
-        );
-      }
-    }, 500);
-
-    return () => {
-      unsub();
-      clearInterval(interval);
-    };
-  });
-
-  return { handlePointerDown };
-}
diff --git a/packages/studio/src/utils/studioUiPreferences.test.ts b/packages/studio/src/utils/studioUiPreferences.test.ts
index 5e335cf5d3..982a10bc61 100644
--- a/packages/studio/src/utils/studioUiPreferences.test.ts
+++ b/packages/studio/src/utils/studioUiPreferences.test.ts
@@ -20,12 +20,15 @@ describe("studio UI preferences", () => {
     const storage = createStorage();
 
     writeStudioUiPreferences({ timelineVisible: false }, storage);
+    writeStudioUiPreferences({ leftWidth: 384, rightWidth: 424 }, storage);
     writeStudioUiPreferences({ playbackRate: 1.5 }, storage);
     writeStudioUiPreferences({ audioMuted: true }, storage);
     writeStudioUiPreferences({ previewZoom: { zoomPercent: 160, panX: -20, panY: 12 } }, storage);
 
     expect(readStudioUiPreferences(storage)).toEqual({
       timelineVisible: false,
+      leftWidth: 384,
+      rightWidth: 424,
       playbackRate: 1.5,
       audioMuted: true,
       previewZoom: { zoomPercent: 160, panX: -20, panY: 12 },
@@ -38,6 +41,8 @@ describe("studio UI preferences", () => {
       "hf-studio-ui-preferences",
       JSON.stringify({
         leftCollapsed: "yes",
+        leftWidth: "wide",
+        rightWidth: Number.NaN,
         timelineVisible: true,
         playbackRate: Number.NaN,
         audioMuted: "false",
diff --git a/packages/studio/src/utils/studioUiPreferences.ts b/packages/studio/src/utils/studioUiPreferences.ts
index 6548a58eba..c2bfe7a537 100644
--- a/packages/studio/src/utils/studioUiPreferences.ts
+++ b/packages/studio/src/utils/studioUiPreferences.ts
@@ -6,6 +6,8 @@ export interface StoredPreviewZoomState {
 
 export interface StudioUiPreferences {
   leftCollapsed?: boolean;
+  leftWidth?: number;
+  rightWidth?: number;
   timelineVisible?: boolean;
   timelineHeight?: number;
   playbackRate?: number;
@@ -58,6 +60,12 @@ function readStorage(storage: Storage | null): StudioUiPreferences {
     if (typeof parsed.leftCollapsed === "boolean") {
       preferences.leftCollapsed = parsed.leftCollapsed;
     }
+    if (typeof parsed.leftWidth === "number" && Number.isFinite(parsed.leftWidth)) {
+      preferences.leftWidth = parsed.leftWidth;
+    }
+    if (typeof parsed.rightWidth === "number" && Number.isFinite(parsed.rightWidth)) {
+      preferences.rightWidth = parsed.rightWidth;
+    }
     if (typeof parsed.timelineVisible === "boolean") {
       preferences.timelineVisible = parsed.timelineVisible;
     }

From 5acbf240cbab38594d06b59b9ef7f2a4b37d31b7 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Tue, 21 Jul 2026 05:45:23 +0200
Subject: [PATCH 057/125] feat(core): add deterministic keyframe ease runtime

---
 packages/core/package-subpaths.json           |   6 +
 packages/core/package.json                    |  10 +
 packages/core/src/figma/motionEase.test.ts    |   2 +-
 packages/core/src/figma/motionEase.ts         |   2 +-
 .../generated/position-edits-render-inline.ts |   2 +-
 packages/core/src/index.ts                    |   1 -
 packages/core/src/parsers/springEase.test.ts  |  29 +++
 packages/core/src/parsers/springEase.ts       |  31 ++-
 packages/core/src/runtime/analytics.ts        |   6 +-
 packages/core/src/runtime/customEase.test.ts  | 100 ++++++++
 packages/core/src/runtime/customEase.ts       | 153 +++++++++++++
 packages/core/src/runtime/init.test.ts        | 216 ++++++++++++++++++
 packages/core/src/runtime/init.ts             |  91 +++++++-
 packages/core/src/runtime/types.ts            |   9 +-
 packages/core/src/runtime/wiggleEase.test.ts  | 115 ++++++++++
 packages/core/src/runtime/wiggleEase.ts       |  68 ++++++
 packages/core/src/runtime/window.d.ts         |   5 +
 packages/core/tsconfig.json                   |   3 +-
 packages/parsers/src/gsapConstants.ts         |   4 +
 packages/parsers/src/gsapParser.test.ts       |  30 +++
 packages/parsers/src/gsapParser.ts            |  38 +--
 .../parsers/src/gsapParserAcorn.full.test.ts  |  18 ++
 packages/parsers/src/gsapParserAcorn.ts       |   8 +
 packages/parsers/src/gsapWriter.acorn.test.ts |  21 ++
 24 files changed, 938 insertions(+), 30 deletions(-)
 create mode 100644 packages/core/src/parsers/springEase.test.ts
 create mode 100644 packages/core/src/runtime/customEase.test.ts
 create mode 100644 packages/core/src/runtime/customEase.ts
 create mode 100644 packages/core/src/runtime/wiggleEase.test.ts
 create mode 100644 packages/core/src/runtime/wiggleEase.ts

diff --git a/packages/core/package-subpaths.json b/packages/core/package-subpaths.json
index 59d07e6a40..b73e8844a6 100644
--- a/packages/core/package-subpaths.json
+++ b/packages/core/package-subpaths.json
@@ -242,6 +242,12 @@
       "types": "./dist/parsers/springEase.d.ts",
       "environments": ["browser", "bun", "node"]
     },
+    "./wiggle-ease": {
+      "source": "./src/runtime/wiggleEase.ts",
+      "runtime": "./dist/runtime/wiggleEase.js",
+      "types": "./dist/runtime/wiggleEase.d.ts",
+      "environments": ["browser", "bun", "node"]
+    },
     "./fonts/aliases": {
       "source": "./src/fonts/aliases.ts",
       "runtime": "./dist/fonts/aliases.js",
diff --git a/packages/core/package.json b/packages/core/package.json
index 353b46d833..e0d3f428fe 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -251,6 +251,12 @@
       "import": "./src/parsers/springEase.ts",
       "types": "./src/parsers/springEase.ts"
     },
+    "./wiggle-ease": {
+      "bun": "./src/runtime/wiggleEase.ts",
+      "node": "./dist/runtime/wiggleEase.js",
+      "import": "./src/runtime/wiggleEase.ts",
+      "types": "./src/runtime/wiggleEase.ts"
+    },
     "./fonts/aliases": {
       "bun": "./src/fonts/aliases.ts",
       "node": "./dist/fonts/aliases.js",
@@ -429,6 +435,10 @@
         "import": "./dist/parsers/springEase.js",
         "types": "./dist/parsers/springEase.d.ts"
       },
+      "./wiggle-ease": {
+        "import": "./dist/runtime/wiggleEase.js",
+        "types": "./dist/runtime/wiggleEase.d.ts"
+      },
       "./fonts/aliases": {
         "import": "./dist/fonts/aliases.js",
         "types": "./dist/fonts/aliases.d.ts"
diff --git a/packages/core/src/figma/motionEase.test.ts b/packages/core/src/figma/motionEase.test.ts
index 0ca0d75eae..727984a34c 100644
--- a/packages/core/src/figma/motionEase.test.ts
+++ b/packages/core/src/figma/motionEase.test.ts
@@ -19,7 +19,7 @@ describe("mapEase", () => {
       ease: "power2.inOut",
     });
     expect(mapEase("backOut")).toEqual({ kind: "named", ease: "back.out" });
-    expect(mapEase("HOLD")).toEqual({ kind: "named", ease: "steps(1)" });
+    expect(mapEase("HOLD")).toEqual({ kind: "named", ease: "hold" });
   });
   it("falls back to none for unknown named eases", () => {
     expect(mapEase("wobble")).toEqual({ kind: "named", ease: "none" });
diff --git a/packages/core/src/figma/motionEase.ts b/packages/core/src/figma/motionEase.ts
index 5f52d6d1bd..1079487a16 100644
--- a/packages/core/src/figma/motionEase.ts
+++ b/packages/core/src/figma/motionEase.ts
@@ -28,7 +28,7 @@ const NAMED_EASE: Record<string, string> = {
   elasticinout: "elastic.inOut",
   anticipate: "back.in",
   spring: "elastic.out",
-  hold: "steps(1)",
+  hold: "hold",
 };
 
 function isBezier4(ease: unknown[]): ease is [number, number, number, number] {
diff --git a/packages/core/src/generated/position-edits-render-inline.ts b/packages/core/src/generated/position-edits-render-inline.ts
index 65623802ee..82cac49a9a 100644
--- a/packages/core/src/generated/position-edits-render-inline.ts
+++ b/packages/core/src/generated/position-edits-render-inline.ts
@@ -1,6 +1,6 @@
 // AUTO-GENERATED by scripts/build-position-edits-render.ts - do not edit
 const POSITION_EDITS_RENDER_IIFE: string =
-  '"use strict";(()=>{function A(){return globalThis}function P(e,t){if(typeof window>"u")return;let n=A(),r=n.__hf?.onSwallowed;if(r)try{r({label:e,error:t})}catch(i){}(n.__hfDebug||n.__HYPERFRAMES_DEBUG)&&console.debug(`[hyperframes] ${e} swallowed:`,t)}var T=null;function R(e,t){if(T)try{T({source:"hf-preview",type:"analytics",event:e,properties:t??{}})}catch(n){P("runtime.analytics.site1",n)}}var _="data-hf-edit-base-x",S="data-hf-edit-base-y",m="data-hf-edit-original-translate",E=e=>{let t=parseFloat(e??"");return Number.isFinite(t)?t:0},V=e=>{let t=[],n=0,r="";for(let i of e.trim())i==="("&&(n+=1),i===")"&&(n=Math.max(0,n-1)),/\\s/.test(i)&&n===0?(r&&t.push(r),r=""):r+=i;return r&&t.push(r),t},$=/^-?(?:\\d+(?:\\.\\d+)?|\\.\\d+)px$/,k=(e,t)=>$.test(e)&&$.test(t)?`${parseFloat(e)+parseFloat(t)}px`:`calc(${e} + ${t})`,I=(e,t,n)=>{if(!e||e==="none")return`${t} ${n}`;let[r,i,u]=V(e);if(r===void 0)return`${t} ${n}`;if(i===void 0)return`${k(r,t)} ${n}`;let d=u===void 0?"":` ${u}`;return`${k(r,t)} ${k(i,n)}${d}`},O=e=>{try{e.ownerDocument.defaultView?.gsap?.getProperty?.(e,"x")}catch{}},G=e=>{let t=e.style.getPropertyValue("translate").trim();if(t)return t==="none"?"":t;try{let n=e.ownerDocument.defaultView,r=n?n.getComputedStyle(e).getPropertyValue("translate").trim():"";return r==="none"?"":r}catch{return""}},h=new WeakMap;function H(e,t){let n=h.get(e);if(!t?.force&&n!==void 0&&e.style.getPropertyValue("translate")!==n){R("position_edit_fold_skipped",{hfId:e.getAttribute("data-hf-id")});return}let r=E(e.getAttribute("data-x"))-E(e.getAttribute(_)),i=E(e.getAttribute("data-y"))-E(e.getAttribute(S));e.hasAttribute(m)||e.setAttribute(m,G(e)),n===void 0&&O(e);let u=e.getAttribute(m)??"",d=I(u,`${r}px`,`${i}px`);e.style.setProperty("translate",d),h.set(e,e.style.getPropertyValue("translate"))}function v(e,t){let n=e.defaultView?.HTMLElement,r=e.defaultView?.SVGElement,i=a=>n||r?n!==void 0&&a instanceof n||r!==void 0&&a instanceof r:typeof a.style?.setProperty=="function",u=e.querySelectorAll(`[${m}]:not([${_}]):not([${S}])`);for(let a=0;a<u.length;a++){let l=u[a];if(l===void 0||!i(l))continue;let w=l.getAttribute(m)??"";w===""?l.style.removeProperty("translate"):l.style.setProperty("translate",w),l.removeAttribute(m),h.delete(l)}let d=e.querySelectorAll(`[${_}], [${S}]`),b=0;for(let a=0;a<d.length;a++){let l=d[a];l===void 0||!i(l)||(H(l,t),b+=1)}return b}var x="__hfPositionEditsSeekReapplyWrapped",D=new WeakSet,F=new WeakMap,W=new WeakMap;function L(e){let t=e,n=()=>{try{v(t.document)}catch{}},r=o=>typeof o=="function"&&(D.has(o)||!!o[x]),i=o=>{D.add(o);try{Object.defineProperty(o,x,{value:!0})}catch{}},u=o=>{if(typeof o!="function"||r(o))return o;let s=function(...c){let f=o.apply(this,c);return n(),f};return i(s),s},d=(o,s)=>{let c=F.get(o);if(c?.has(s))return!0;let f=Object.getOwnPropertyDescriptor(o,s);if(f?.configurable===!1){let p=o[s];return typeof p=="function"&&(o[s]=u(p),n()),!1}let g=o[s],y=f?.set;return Object.defineProperty(o,s,{configurable:!0,enumerable:f?.enumerable??!0,get:()=>g,set:p=>{g=u(p),y?.call(o,p)}}),g=u(g),c??(c=new Set),c.add(s),F.set(o,c),n(),!0},b=(o,s)=>{let c=W.get(t),f=Object.getOwnPropertyDescriptor(t,o);if(!c?.has(o)){if(f?.configurable===!1){let p=t[o];return p?d(p,s):!1}let y=t[o];Object.defineProperty(t,o,{configurable:!0,enumerable:f?.enumerable??!0,get:()=>y,set:p=>{y=p,y&&d(y,s)}}),c??(c=new Set),c.add(o),W.set(t,c)}let g=t[o];return g?d(g,s):!1},a=()=>{let o=b("__hf","seek"),s=b("__player","renderSeek");return o&&s};if(a())return;let l=120,w=t.setInterval(()=>{if(a()){t.clearInterval(w);return}l-=1,l<=0&&t.clearInterval(w)},50)}function M(){document.querySelector(`[${_}], [${S}]`)&&(v(document),L(window))}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",M,{once:!0}):M();})();\n';
+  '"use strict";(()=>{function A(){return globalThis}function P(e,t){if(typeof window>"u")return;let n=A(),r=n.__hf?.onSwallowed;if(r)try{r({label:e,error:t})}catch(i){}(n.__hfDebug||n.__HYPERFRAMES_DEBUG)&&console.debug(`[hyperframes] ${e} swallowed:`,t)}var T=null;function R(e,t){if(T)try{T({source:"hf-preview",type:"analytics",event:e,properties:t??{}})}catch(n){P("runtime.analytics.site1",n)}}var w="data-hf-edit-base-x",k="data-hf-edit-base-y",y="data-hf-edit-original-translate",S=e=>{let t=parseFloat(e??"");return Number.isFinite(t)?t:0},V=e=>{let t=[],n=0,r="";for(let i of e.trim())i==="("&&(n+=1),i===")"&&(n=Math.max(0,n-1)),/\\s/.test(i)&&n===0?(r&&t.push(r),r=""):r+=i;return r&&t.push(r),t},$=/^-?(?:\\d+(?:\\.\\d+)?|\\.\\d+)px$/,E=(e,t)=>$.test(e)&&$.test(t)?`${parseFloat(e)+parseFloat(t)}px`:`calc(${e} + ${t})`,I=(e,t,n)=>{if(!e||e==="none")return`${t} ${n}`;let[r,i,u]=V(e);if(r===void 0)return`${t} ${n}`;if(i===void 0)return`${E(r,t)} ${n}`;let d=u===void 0?"":` ${u}`;return`${E(r,t)} ${E(i,n)}${d}`},O=e=>{try{e.ownerDocument.defaultView?.gsap?.getProperty?.(e,"x")}catch{}},G=e=>{let t=e.style.getPropertyValue("translate").trim();if(t)return t==="none"?"":t;try{let n=e.ownerDocument.defaultView,r=n?n.getComputedStyle(e).getPropertyValue("translate").trim():"";return r==="none"?"":r}catch{return""}},h=new WeakMap;function H(e,t){let n=h.get(e);if(!t?.force&&n!==void 0&&e.style.getPropertyValue("translate")!==n){R("position_edit_fold_skipped",{hfId:e.getAttribute("data-hf-id")});return}let r=S(e.getAttribute("data-x"))-S(e.getAttribute(w)),i=S(e.getAttribute("data-y"))-S(e.getAttribute(k));e.hasAttribute(y)||e.setAttribute(y,G(e)),n===void 0&&O(e);let u=e.getAttribute(y)??"",d=I(u,`${r}px`,`${i}px`);e.style.setProperty("translate",d),h.set(e,e.style.getPropertyValue("translate"))}function v(e,t){let n=e.defaultView?.HTMLElement,r=e.defaultView?.SVGElement,i=a=>n||r?n!==void 0&&a instanceof n||r!==void 0&&a instanceof r:typeof a.style?.setProperty=="function",u=e.querySelectorAll(`[${y}]:not([${w}]):not([${k}])`);for(let a=0;a<u.length;a++){let l=u[a];if(l===void 0||!i(l))continue;let b=l.getAttribute(y)??"";b===""?l.style.removeProperty("translate"):l.style.setProperty("translate",b),l.removeAttribute(y),h.delete(l)}let d=e.querySelectorAll(`[${w}], [${k}]`),m=0;for(let a=0;a<d.length;a++){let l=d[a];l===void 0||!i(l)||(H(l,t),m+=1)}return m}var x="__hfPositionEditsSeekReapplyWrapped",D=new WeakSet,F=new WeakMap,W=new WeakMap;function L(e){let t=e,n=()=>{try{v(t.document)}catch{}},r=o=>typeof o=="function"&&(D.has(o)||!!o[x]),i=o=>{D.add(o);try{Object.defineProperty(o,x,{value:!0})}catch{}},u=o=>{if(typeof o!="function"||r(o))return o;let s=function(...c){let f=o.apply(this,c);return n(),f};return i(s),s},d=(o,s)=>{let c=F.get(o);if(c?.has(s))return!0;let f=Object.getOwnPropertyDescriptor(o,s);if(f?.configurable===!1){let p=o[s];return typeof p=="function"&&(o[s]=u(p),n()),!1}let g=o[s],_=f?.set;return Object.defineProperty(o,s,{configurable:!0,enumerable:f?.enumerable??!0,get:()=>g,set:p=>{g=u(p),_?.call(o,p)}}),g=u(g),c??(c=new Set),c.add(s),F.set(o,c),n(),!0},m=(o,s)=>{let c=W.get(t),f=Object.getOwnPropertyDescriptor(t,o);if(!c?.has(o)){if(f?.configurable===!1){let p=t[o];return p?d(p,s):!1}let _=t[o];Object.defineProperty(t,o,{configurable:!0,enumerable:f?.enumerable??!0,get:()=>_,set:p=>{_=p,_&&d(_,s)}}),c??(c=new Set),c.add(o),W.set(t,c)}let g=t[o];return g?d(g,s):!1},a=()=>{let o=m("__hf","seek"),s=m("__player","renderSeek");return o&&s};if(a())return;let l=120,b=t.setInterval(()=>{if(a()){t.clearInterval(b);return}l-=1,l<=0&&t.clearInterval(b)},50)}function M(){document.querySelector(`[${w}], [${k}]`)&&(v(document),L(window))}document.readyState==="loading"?document.addEventListener("DOMContentLoaded",M,{once:!0}):M();})();\n';
 
 /** Returns the pre-built position-edits render IIFE as a string constant. */
 export function getPositionEditsRenderScript(): string {
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index b91597bb99..8d1a10310c 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -95,7 +95,6 @@ export {
   keyframesToGsapAnimations,
   gsapAnimationsToKeyframes,
 } from "@hyperframes/parsers";
-
 export type { ParsedHtml, CompositionMetadata } from "@hyperframes/parsers";
 
 export {
diff --git a/packages/core/src/parsers/springEase.test.ts b/packages/core/src/parsers/springEase.test.ts
new file mode 100644
index 0000000000..909f74425f
--- /dev/null
+++ b/packages/core/src/parsers/springEase.test.ts
@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { evaluateSpringEase, parseSpringBounce } from "./springEase";
+
+describe("single-parameter spring ease", () => {
+  it("parses and clamps the bounce parameter", () => {
+    expect(parseSpringBounce("spring(0.5)")).toBe(0.5);
+    expect(parseSpringBounce(" spring(2) ")).toBe(1);
+    expect(parseSpringBounce("spring(-1)")).toBe(0);
+    expect(parseSpringBounce("spring(nope)")).toBeNull();
+  });
+
+  it("starts at zero, overshoots, and settles exactly at one", () => {
+    const samples = Array.from({ length: 101 }, (_, index) => evaluateSpringEase(index / 100, 0.5));
+    expect(samples[0]).toBe(0);
+    expect(samples.at(-1)).toBe(1);
+    expect(Math.max(...samples)).toBeGreaterThan(1);
+  });
+
+  it("is deterministic and makes higher bounce values more oscillatory", () => {
+    const progress = Array.from({ length: 41 }, (_, index) => index / 40);
+    expect(progress.map((value) => evaluateSpringEase(value, 0.75))).toEqual(
+      progress.map((value) => evaluateSpringEase(value, 0.75)),
+    );
+
+    const lowBounce = progress.map((value) => evaluateSpringEase(value, 0.25));
+    const highBounce = progress.map((value) => evaluateSpringEase(value, 0.75));
+    expect(Math.max(...highBounce)).toBeGreaterThan(Math.max(...lowBounce));
+  });
+});
diff --git a/packages/core/src/parsers/springEase.ts b/packages/core/src/parsers/springEase.ts
index b7ae233b85..7c0c0e1f12 100644
--- a/packages/core/src/parsers/springEase.ts
+++ b/packages/core/src/parsers/springEase.ts
@@ -1,2 +1,31 @@
-/** @deprecated Import from @hyperframes/parsers/spring-ease */
+// Preserve the legacy symbols (SpringPreset, SPRING_PRESETS, generateSpringEaseData)
+// on the still-published ./spring-ease subpath. Dropping them is a breaking change
+// for external importers; the canonical source stays @hyperframes/parsers/spring-ease.
 export * from "@hyperframes/parsers/spring-ease";
+
+const SPRING_TOKEN = /^\s*spring\(\s*([+-]?(?:\d+(?:\.\d*)?|\.\d+))\s*\)\s*$/;
+
+function clampBounce(bounce: number): number {
+  return Math.max(0, Math.min(1, bounce));
+}
+
+/** Parse Studio's single-parameter spring token into a normalized bounce value. */
+export function parseSpringBounce(ease: string): number | null {
+  const match = SPRING_TOKEN.exec(ease);
+  if (!match) return null;
+  const bounce = Number(match[1]);
+  return Number.isFinite(bounce) ? clampBounce(bounce) : null;
+}
+
+/** Evaluate Studio's deterministic, endpoint-normalized damped-cosine spring. */
+export function evaluateSpringEase(progress: number, bounce: number): number {
+  if (!Number.isFinite(progress)) return progress;
+  if (progress <= 0) return 0;
+  if (progress >= 1) return 1;
+
+  const normalizedBounce = clampBounce(bounce);
+  const decay = 12 - normalizedBounce * 6;
+  const angularFrequency = Math.PI * 2 * (1 + normalizedBounce * 1.5);
+  const endpoint = 1 - Math.exp(-decay) * Math.cos(angularFrequency);
+  return (1 - Math.exp(-decay * progress) * Math.cos(angularFrequency * progress)) / endpoint;
+}
diff --git a/packages/core/src/runtime/analytics.ts b/packages/core/src/runtime/analytics.ts
index 08f3a24b78..ceca8a482a 100644
--- a/packages/core/src/runtime/analytics.ts
+++ b/packages/core/src/runtime/analytics.ts
@@ -14,7 +14,11 @@ export type RuntimeAnalyticsEvent =
   | "composition_ended"
   | "element_picked"
   | "position_edit_fold_skipped"
-  | "timeline_missing_pause";
+  | "timeline_missing_pause"
+  | "auto_marker_install_failed"
+  | "custom_ease_install_failed"
+  | "custom_ease_parse_failed"
+  | "keyframe_ease_repair_failed";
 
 export type RuntimeAnalyticsProperties = Record<string, string | number | boolean | null>;
 
diff --git a/packages/core/src/runtime/customEase.test.ts b/packages/core/src/runtime/customEase.test.ts
new file mode 100644
index 0000000000..9de2065829
--- /dev/null
+++ b/packages/core/src/runtime/customEase.test.ts
@@ -0,0 +1,100 @@
+import { describe, expect, it, vi } from "vitest";
+import { installStudioCustomEase } from "./customEase";
+
+describe("installStudioCustomEase", () => {
+  it("resolves wiggle while preserving hold, spring, custom, and named eases", () => {
+    const namedEase = (progress: number) => progress * progress;
+    const originalParseEase = vi.fn(() => namedEase);
+    const gsap = { parseEase: originalParseEase };
+
+    expect(installStudioCustomEase(gsap)).toBe(true);
+
+    const wiggleEase = gsap.parseEase("wiggle(6,easeInOut)");
+    expect(wiggleEase).toBeTypeOf("function");
+    const samples = Array.from({ length: 401 }, (_, index) => wiggleEase(index / 400));
+    expect(samples[0]).toBe(0);
+    expect(samples.at(-1)).toBe(1);
+    expect(samples).toEqual(Array.from({ length: 401 }, (_, index) => wiggleEase(index / 400)));
+    const directions = samples
+      .slice(1)
+      .map((value, index) => Math.sign(value - samples[index]!))
+      .filter((direction) => direction !== 0);
+    expect(
+      directions.filter((direction, index) => index > 0 && direction !== directions[index - 1])
+        .length,
+    ).toBeGreaterThanOrEqual(8);
+
+    expect(gsap.parseEase("hold")(0.5)).toBe(0);
+    expect(gsap.parseEase("spring(0.5)")(0)).toBe(0);
+    expect(gsap.parseEase("custom(M0,0 C0.25,0.1 0.25,1 1,1)")(1)).toBe(1);
+    expect(Number.isNaN(gsap.parseEase("custom(M0,0 C0.25,0.1 0.25,1 1,1)")(Number.NaN))).toBe(
+      true,
+    );
+    expect(gsap.parseEase("power2.out")).toBe(namedEase);
+    expect(originalParseEase).toHaveBeenCalledTimes(1);
+  });
+
+  it("registers custom eases in GSAP's internal ease map for keyframe-segment resolution", () => {
+    // GSAP resolves keyframe SEGMENT eases via its internal _parseEase/_easeMap,
+    // not the public parseEase — so the eases must be registered there too, else
+    // a custom ease inside `keyframes:{...}` resolves to undefined and throws
+    // "_ease is not a function" on first render.
+    const easeMap = new Map<string, ((progress: number) => number) & { config?: unknown }>();
+    const gsap = {
+      parseEase: vi.fn((ease: unknown) => (typeof ease === "function" ? ease : null)),
+      registerEase: (name: string, ease: (progress: number) => number) => easeMap.set(name, ease),
+    };
+
+    expect(installStudioCustomEase(gsap)).toBe(true);
+
+    // Bare hold registers directly and holds at 0 until the end.
+    expect(easeMap.get("hold")?.(0.5)).toBe(0);
+    expect(easeMap.get("hold")?.(1)).toBe(1);
+
+    // GSAP calls a configurable ease's `.config` with the parenthesized params
+    // comma-split (custom's bezier path splits into several parts). The config
+    // must rejoin them and resolve a real ease.
+    const springConfig = easeMap.get("spring")?.config as (
+      ...p: unknown[]
+    ) => (n: number) => number;
+    expect(springConfig(0.5)(0)).toBe(0);
+
+    const customConfig = easeMap.get("custom")?.config as (
+      ...p: unknown[]
+    ) => (n: number) => number;
+    // "custom(M0,0 C0.25,0.1 0.25,1 1,1)" → params split on "," by GSAP:
+    const customEase = customConfig("M0", "0 C0.25", "0.1 0.25", "1 1", 1);
+    expect(customEase(0)).toBe(0);
+    expect(customEase(1)).toBe(1);
+  });
+
+  it("installs once per GSAP instance and reinstalls on a replacement instance", () => {
+    const firstParser = vi.fn(() => (progress: number) => progress);
+    const first = { parseEase: firstParser };
+    expect(installStudioCustomEase(first)).toBe(true);
+    const installed = first.parseEase;
+    expect(installStudioCustomEase(first)).toBe(true);
+    expect(first.parseEase).toBe(installed);
+
+    const replacementParser = vi.fn(() => (progress: number) => progress);
+    const replacement = { parseEase: replacementParser };
+    expect(installStudioCustomEase(replacement)).toBe(true);
+    expect(replacement.parseEase).not.toBe(replacementParser);
+  });
+
+  it("uses the same GSAP fallback for malformed public and segment eases", () => {
+    const fallback = (progress: number) => progress * progress;
+    const easeMap = new Map<string, ConfigurableEase>();
+    type ConfigurableEase = ((progress: number) => number) & {
+      config?: (...params: unknown[]) => (progress: number) => number;
+    };
+    const gsap = {
+      parseEase: vi.fn(() => fallback),
+      registerEase: (name: string, ease: ConfigurableEase) => easeMap.set(name, ease),
+    };
+    expect(installStudioCustomEase(gsap)).toBe(true);
+
+    expect(gsap.parseEase("spring(nope)")).toBe(fallback);
+    expect(easeMap.get("spring")?.config?.("nope")).toBe(fallback);
+  });
+});
diff --git a/packages/core/src/runtime/customEase.ts b/packages/core/src/runtime/customEase.ts
new file mode 100644
index 0000000000..0e956f5ee4
--- /dev/null
+++ b/packages/core/src/runtime/customEase.ts
@@ -0,0 +1,153 @@
+import { evaluateSpringEase, parseSpringBounce } from "../parsers/springEase";
+import { emitAnalyticsEvent } from "./analytics";
+import { resolveWiggleEase } from "./wiggleEase";
+
+type RuntimeEase = (progress: number) => number;
+
+type ConfigurableEase = RuntimeEase & { config?: (...params: unknown[]) => RuntimeEase };
+
+type GsapEaseApi = {
+  parseEase?: (ease: string | RuntimeEase, ...args: unknown[]) => RuntimeEase | null;
+  registerEase?: (name: string, ease: RuntimeEase) => void;
+  __hfCustomEaseInstalled?: boolean;
+};
+
+const BISECTION_STEPS = 24;
+const HOLD_EASE: RuntimeEase = (progress) => (progress >= 1 ? 1 : 0);
+const IDENTITY_EASE: RuntimeEase = (progress) => progress;
+const NUMBER_SOURCE = String.raw`([+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?)`;
+// Studio authors one cubic-bezier segment with fixed (0,0) and (1,1)
+// endpoints. Anticipation/overshoot is represented by Y controls outside
+// [0,1]; X controls stay in [0,1] so progress remains a function of time.
+const CUSTOM_CUBIC_PATH = new RegExp(
+  String.raw`^\s*M\s*0\s*,\s*0\s+C\s*${NUMBER_SOURCE}\s*,\s*${NUMBER_SOURCE}\s+${NUMBER_SOURCE}\s*,\s*${NUMBER_SOURCE}\s+1\s*,\s*1\s*$`,
+  "i",
+);
+
+function cubicCoordinate(t: number, point1: number, point2: number): number {
+  const inverse = 1 - t;
+  return 3 * inverse * inverse * t * point1 + 3 * inverse * t * t * point2 + t * t * t;
+}
+
+function evaluateCubicBezier(
+  progress: number,
+  x1: number,
+  y1: number,
+  x2: number,
+  y2: number,
+): number {
+  if (!Number.isFinite(progress)) return progress;
+  if (progress <= 0) return 0;
+  if (progress >= 1) return 1;
+
+  let low = 0;
+  let high = 1;
+  for (let step = 0; step < BISECTION_STEPS; step += 1) {
+    const t = (low + high) / 2;
+    if (cubicCoordinate(t, x1, x2) < progress) low = t;
+    else high = t;
+  }
+  return cubicCoordinate((low + high) / 2, y1, y2);
+}
+
+function createCubicBezierEase(path: string): RuntimeEase | null {
+  const match = CUSTOM_CUBIC_PATH.exec(path);
+  if (!match) return null;
+  const x1 = Number(match[1]);
+  const y1 = Number(match[2]);
+  const x2 = Number(match[3]);
+  const y2 = Number(match[4]);
+  if (Math.min(x1, x2) < 0 || Math.max(x1, x2) > 1) return null;
+  return (progress) => evaluateCubicBezier(progress, x1, y1, x2, y2);
+}
+
+function resolveSpringEase(
+  ease: string,
+  springEaseCache: Map<number, RuntimeEase>,
+): RuntimeEase | null {
+  if (!ease.startsWith("spring(")) return null;
+  const bounce = parseSpringBounce(ease);
+  if (bounce === null) return null;
+  const cached = springEaseCache.get(bounce);
+  if (cached) return cached;
+  const springEase: RuntimeEase = (progress) => evaluateSpringEase(progress, bounce);
+  springEaseCache.set(bounce, springEase);
+  return springEase;
+}
+
+function resolveCustomEase(
+  ease: string,
+  customEaseCache: Map<string, RuntimeEase>,
+): RuntimeEase | null {
+  if (!ease.startsWith("custom(") || !ease.endsWith(")")) return null;
+  const path = ease.slice(7, -1);
+  const cached = customEaseCache.get(path);
+  if (cached) return cached;
+  const customEase = createCubicBezierEase(path);
+  if (customEase) customEaseCache.set(path, customEase);
+  return customEase;
+}
+
+export function installStudioCustomEase(gsap: GsapEaseApi): boolean {
+  if (gsap.__hfCustomEaseInstalled) return true;
+  const originalParseEase = gsap.parseEase;
+  if (!originalParseEase) return false;
+
+  const customEaseCache = new Map<string, RuntimeEase>();
+  const springEaseCache = new Map<number, RuntimeEase>();
+  const wiggleEaseCache = new Map<string, RuntimeEase>();
+
+  // Single source of truth for "hyperframes ease string -> function". Both the
+  // public parseEase override and the internal registerEase configs below route
+  // through this, so the resolution rules live in exactly one place.
+  const resolveHyperframesEase = (ease: string | RuntimeEase): RuntimeEase | null => {
+    if (typeof ease !== "string") return null;
+    if (ease === "hold") return HOLD_EASE;
+    return (
+      resolveWiggleEase(ease, wiggleEaseCache) ??
+      resolveSpringEase(ease, springEaseCache) ??
+      resolveCustomEase(ease, customEaseCache)
+    );
+  };
+
+  const parseEaseWithFallback = (
+    ease: string | RuntimeEase,
+    context: GsapEaseApi,
+    args: unknown[] = [],
+  ): RuntimeEase => {
+    const resolved = resolveHyperframesEase(ease);
+    if (resolved) return resolved;
+    if (typeof ease === "string" && /^(?:hold|spring|wiggle|custom)(?:\(|$)/.test(ease.trim())) {
+      emitAnalyticsEvent("custom_ease_parse_failed", { ease });
+    }
+    return originalParseEase.call(context, ease, ...args) ?? IDENTITY_EASE;
+  };
+
+  // Public parseEase: direct callers (studio ease UI, adapters) resolve
+  // synchronously; anything else falls through to GSAP's own parser.
+  gsap.parseEase = function parseHyperframesEase(ease, ...args) {
+    return parseEaseWithFallback(ease, this, args);
+  };
+
+  // GSAP resolves a keyframe SEGMENT's ease through its INTERNAL _parseEase /
+  // _easeMap, never the public parseEase above — so a custom ease used inside
+  // `keyframes:{...}` resolves to undefined and throws "_ease is not a function"
+  // on the first render. Register the eases in the internal map too. GSAP calls
+  // a configurable ease's `.config(...params)` with the parenthesized string
+  // comma-split, so `params.join(",")` losslessly reconstructs the original
+  // (including custom() bezier paths, whose commas survive the round-trip).
+  const registerEase = gsap.registerEase;
+  if (typeof registerEase === "function") {
+    registerEase("hold", HOLD_EASE);
+    const registerConfigurable = (name: string): void => {
+      const base: ConfigurableEase = (progress) => progress;
+      base.config = (...params) => parseEaseWithFallback(`${name}(${params.join(",")})`, gsap);
+      registerEase(name, base);
+    };
+    registerConfigurable("spring");
+    registerConfigurable("wiggle");
+    registerConfigurable("custom");
+  }
+  gsap.__hfCustomEaseInstalled = true;
+  return true;
+}
diff --git a/packages/core/src/runtime/init.test.ts b/packages/core/src/runtime/init.test.ts
index 3087aac7a9..666a0e4916 100644
--- a/packages/core/src/runtime/init.test.ts
+++ b/packages/core/src/runtime/init.test.ts
@@ -119,11 +119,227 @@ describe("initSandboxRuntimeModular", () => {
     delete (window as { __HF_EXPORT_RENDER_SEEK_CONFIG?: unknown }).__HF_EXPORT_RENDER_SEEK_CONFIG;
     delete window.__hfTimelinesBuilding;
     delete (window as { THREE?: unknown }).THREE;
+    delete (window as { __hfAutoNoopRegistered?: boolean }).__hfAutoNoopRegistered;
+    delete window.gsap;
     vi.restoreAllMocks();
     window.requestAnimationFrame = originalRequestAnimationFrame;
     window.cancelAnimationFrame = originalCancelAnimationFrame;
   });
 
+  it("resolves Studio hold as a deterministic step at the segment end", () => {
+    const defaultEase = (progress: number) => progress;
+    const originalParseEase = vi.fn(() => defaultEase);
+    window.gsap = {
+      timeline: () => createMockTimeline(1),
+      parseEase: originalParseEase,
+      registerPlugin: vi.fn(),
+    };
+
+    const root = document.createElement("div");
+    root.setAttribute("data-composition-id", "main");
+    root.setAttribute("data-root", "true");
+    root.setAttribute("data-start", "0");
+    root.setAttribute("data-duration", "1");
+    root.setAttribute("data-width", "1920");
+    root.setAttribute("data-height", "1080");
+    document.body.appendChild(root);
+    window.__timelines = { main: createMockTimeline(1) };
+
+    initSandboxRuntimeModular();
+
+    const first = window.gsap.parseEase?.("hold");
+    const second = window.gsap.parseEase?.("hold");
+    expect(first).toBeTypeOf("function");
+    expect(second).toBe(first);
+    if (typeof first !== "function") return;
+
+    expect([0, 0.25, 0.5, 0.99].map(first)).toEqual([0, 0, 0, 0]);
+    expect(first(1)).toBe(1);
+    expect(first(1.01)).toBe(1);
+    expect(originalParseEase).not.toHaveBeenCalledWith("hold");
+  });
+
+  it("repairs a keyframes tween's inner-timeline ease baked to undefined before custom-ease registration", () => {
+    // The composition inline script builds keyframes tweens BEFORE this runtime
+    // registers the custom eases, so a `{keyframes, ease:"hold"}` tween's inner
+    // timeline `_ease` bakes to undefined (GSAP resolves it once at build via the
+    // internal ease map). GSAP then throws "_ease is not a function" on the first
+    // render. The runtime must re-resolve that inner ease after registration.
+    window.gsap = {
+      timeline: () => createMockTimeline(20),
+      parseEase: vi.fn(() => (progress: number) => progress),
+      registerPlugin: vi.fn(),
+      registerEase: vi.fn(),
+    } as unknown as typeof window.gsap;
+
+    const innerTimeline: { _ease?: unknown } = { _ease: undefined };
+    const keyframesTween = {
+      vars: { ease: "hold", keyframes: { "0%": { x: 0 }, "100%": { x: 50 } } },
+      timeline: innerTimeline,
+      _ease: (progress: number) => progress,
+      targets: () => [document.createElement("div")],
+    };
+    const main = createMockTimeline(20);
+    main.getChildren = () => [keyframesTween as unknown as RuntimeTimelineLike];
+
+    const root = document.createElement("div");
+    root.setAttribute("data-composition-id", "main");
+    root.setAttribute("data-root", "true");
+    root.setAttribute("data-start", "0");
+    root.setAttribute("data-duration", "20");
+    root.setAttribute("data-width", "1920");
+    root.setAttribute("data-height", "1080");
+    document.body.appendChild(root);
+    window.__timelines = { main };
+
+    expect(innerTimeline._ease).toBeUndefined();
+    initSandboxRuntimeModular();
+    // Bind re-resolves the inner ease to a real function (the installed hold ease),
+    // so a subsequent render can call `timeline._ease(...)` without throwing.
+    expect(innerTimeline._ease).toBeTypeOf("function");
+  });
+
+  it("isolates a failed keyframe ease repair and reports it without skipping siblings", () => {
+    const outbound: Array<{ type?: string; event?: string }> = [];
+    vi.spyOn(window.parent, "postMessage").mockImplementation((message: unknown) => {
+      if (typeof message === "object" && message !== null) {
+        outbound.push(message as { type?: string; event?: string });
+      }
+    });
+    window.gsap = {
+      timeline: () => createMockTimeline(20),
+      parseEase: vi.fn((ease: unknown) => {
+        if (ease === "bad-ease") throw new Error("bad ease");
+        return (progress: number) => progress;
+      }),
+      registerPlugin: vi.fn(),
+      registerEase: vi.fn(),
+    } as unknown as typeof window.gsap;
+
+    const failedInner: { _ease?: unknown } = { _ease: undefined };
+    const repairedInner: { _ease?: unknown } = { _ease: undefined };
+    const main = createMockTimeline(20);
+    main.getChildren = () =>
+      [
+        { vars: { ease: "bad-ease", keyframes: {} }, timeline: failedInner },
+        { vars: { ease: "hold", keyframes: {} }, timeline: repairedInner },
+      ] as unknown as RuntimeTimelineLike[];
+
+    const root = document.createElement("div");
+    root.setAttribute("data-composition-id", "main");
+    root.setAttribute("data-root", "true");
+    root.setAttribute("data-duration", "20");
+    document.body.appendChild(root);
+    window.__timelines = { main };
+
+    initSandboxRuntimeModular();
+
+    expect(failedInner._ease).toBeUndefined();
+    expect(repairedInner._ease).toBeTypeOf("function");
+    expect(outbound).toContainEqual(
+      expect.objectContaining({
+        type: "analytics",
+        event: "keyframe_ease_repair_failed",
+      }),
+    );
+  });
+
+  it("resolves Studio custom cubic-bezier eases on the composition GSAP instance", () => {
+    const defaultEase = (progress: number) => 1 - (1 - progress) ** 2;
+    const originalParseEase = vi.fn(() => defaultEase);
+    window.gsap = {
+      timeline: () => createMockTimeline(1),
+      parseEase: originalParseEase,
+      registerPlugin: vi.fn(),
+    };
+
+    const root = document.createElement("div");
+    root.setAttribute("data-composition-id", "main");
+    root.setAttribute("data-root", "true");
+    root.setAttribute("data-start", "0");
+    root.setAttribute("data-duration", "1");
+    root.setAttribute("data-width", "1920");
+    root.setAttribute("data-height", "1080");
+    document.body.appendChild(root);
+    window.__timelines = { main: createMockTimeline(1) };
+
+    initSandboxRuntimeModular();
+
+    const custom = "custom(M0,0 C0.42,0 0.58,1 1,1)";
+    const first = window.gsap.parseEase?.(custom);
+    const second = window.gsap.parseEase?.(custom);
+    expect(first).toBeTypeOf("function");
+    expect(second).toBe(first);
+    if (typeof first !== "function" || typeof second !== "function") return;
+
+    const progressSamples = [0, 0.25, 0.5, 0.75, 1];
+    expect(progressSamples.map(first)).toEqual(progressSamples.map(second));
+    expect(first(0.25)).toBeCloseTo(0.1292, 4);
+    expect(first(0.5)).toBeCloseTo(0.5, 6);
+    expect(first(0.5)).not.toBeCloseTo(defaultEase(0.5), 6);
+    expect(first(0.75)).toBeCloseTo(0.8708, 4);
+    expect(originalParseEase).not.toHaveBeenCalledWith(custom);
+
+    expect(window.gsap.parseEase?.("power1.out")).toBe(defaultEase);
+    expect(originalParseEase).toHaveBeenCalledWith("power1.out");
+    expect(window.gsap.parseEase?.("custom(not-a-path)")).toBe(defaultEase);
+    expect(originalParseEase).toHaveBeenCalledWith("custom(not-a-path)");
+
+    const installedParseEase = window.gsap.parseEase;
+    initSandboxRuntimeModular();
+    expect(window.gsap.parseEase).toBe(installedParseEase);
+
+    window.gsap = {
+      timeline: () => createMockTimeline(1),
+      parseEase: vi.fn(() => defaultEase),
+      registerPlugin: vi.fn(),
+    };
+    initSandboxRuntimeModular();
+    const freshResolution = window.gsap.parseEase?.(custom);
+    expect(freshResolution).toBeTypeOf("function");
+    if (typeof freshResolution === "function") {
+      expect(progressSamples.map(freshResolution)).toEqual(progressSamples.map(first));
+    }
+  });
+
+  it("resolves Studio spring eases as deterministic oscillations that settle exactly", () => {
+    const defaultEase = (progress: number) => progress;
+    const originalParseEase = vi.fn(() => defaultEase);
+    window.gsap = {
+      timeline: () => createMockTimeline(1),
+      parseEase: originalParseEase,
+      registerPlugin: vi.fn(),
+    };
+
+    const root = document.createElement("div");
+    root.setAttribute("data-composition-id", "main");
+    root.setAttribute("data-root", "true");
+    root.setAttribute("data-start", "0");
+    root.setAttribute("data-duration", "1");
+    root.setAttribute("data-width", "1920");
+    root.setAttribute("data-height", "1080");
+    document.body.appendChild(root);
+    window.__timelines = { main: createMockTimeline(1) };
+
+    initSandboxRuntimeModular();
+
+    const first = window.gsap.parseEase?.("spring(0.5)");
+    const second = window.gsap.parseEase?.("spring(0.5)");
+    expect(first).toBeTypeOf("function");
+    expect(second).toBe(first);
+    if (typeof first !== "function" || typeof second !== "function") return;
+
+    const samples = Array.from({ length: 101 }, (_, index) => first(index / 100));
+    expect(first(0)).toBe(0);
+    expect(first(1)).toBe(1);
+    expect(Math.max(...samples)).toBeGreaterThan(1);
+    expect(samples).toEqual(Array.from({ length: 101 }, (_, index) => second(index / 100)));
+    expect(originalParseEase).not.toHaveBeenCalledWith("spring(0.5)");
+
+    expect(window.gsap.parseEase?.("power1.out")).toBe(defaultEase);
+    expect(originalParseEase).toHaveBeenCalledWith("power1.out");
+  });
+
   it("keeps authored composition hosts visible when the live child timeline is shorter", () => {
     const root = document.createElement("div");
     root.setAttribute("data-composition-id", "main");
diff --git a/packages/core/src/runtime/init.ts b/packages/core/src/runtime/init.ts
index 4ba8108996..54d55d6e11 100644
--- a/packages/core/src/runtime/init.ts
+++ b/packages/core/src/runtime/init.ts
@@ -52,6 +52,7 @@ import type {
 import type { PlayerAPI } from "../core.types";
 import { swallow } from "./diagnostics";
 import { shouldAttemptPeriodicTimelineBind } from "./timelineRebindPolicy";
+import { installStudioCustomEase } from "./customEase";
 
 const AUTHORED_DURATION_ATTR = "data-hf-authored-duration";
 const AUTHORED_END_ATTR = "data-hf-authored-end";
@@ -114,6 +115,9 @@ function resolveExportRenderFps(): ExportRenderFpsResolution {
 
 export function initSandboxRuntimeModular(): void {
   const state = createRuntimeState();
+  // Own the analytics bridge before any best-effort runtime installation so
+  // early failures are observable instead of disappearing before player setup.
+  initRuntimeAnalytics(postRuntimeMessage as (payload: unknown) => void);
   // SDK moveElement edits must render even when no usable GSAP timeline ever
   // binds (CSS/WAAPI-animated or fully static compositions) — apply at init.
   // This runs at DOMContentLoaded, after inline composition scripts have
@@ -142,6 +146,16 @@ export function initSandboxRuntimeModular(): void {
   const runtimeCleanupCallbacks: Array<() => void> = [];
   const postedDiagnosticKeys = new Set<string>();
   let rootStageDiagnosticRafId: number | null = null;
+  const reportedRuntimeIssues = new Set<string>();
+  const reportRuntimeIssueOnce = (
+    key: string,
+    event: "auto_marker_install_failed" | "custom_ease_install_failed",
+    properties: Record<string, string>,
+  ): void => {
+    if (reportedRuntimeIssues.has(key)) return;
+    reportedRuntimeIssues.add(key);
+    emitAnalyticsEvent(event, properties);
+  };
   if (typeof window.__hfRuntimeTeardown === "function") {
     try {
       window.__hfRuntimeTeardown();
@@ -172,11 +186,38 @@ export function initSandboxRuntimeModular(): void {
     try {
       g.registerPlugin({ name: "_auto", init: () => false });
       w.__hfAutoNoopRegistered = true;
-    } catch {
+    } catch (err) {
+      reportRuntimeIssueOnce("auto_marker_install_failed", "auto_marker_install_failed", {
+        reason: "threw",
+      });
+      swallow("runtime.autoMarker.install", err);
       // a stray warning is preferable to a broken runtime
     }
   };
+  const ensureStudioCustomEase = (): void => {
+    const g = window.gsap;
+    if (!g) {
+      reportRuntimeIssueOnce("custom_ease_missing_gsap", "custom_ease_install_failed", {
+        reason: "missing_gsap",
+      });
+      return;
+    }
+    try {
+      if (!installStudioCustomEase(g)) {
+        reportRuntimeIssueOnce("custom_ease_no_parse_ease", "custom_ease_install_failed", {
+          reason: "no_parseEase",
+        });
+      }
+    } catch (err) {
+      reportRuntimeIssueOnce("custom_ease_install_threw", "custom_ease_install_failed", {
+        reason: "threw",
+      });
+      swallow("runtime.customEase.install", err);
+      // falling back to GSAP's default ease is preferable to a broken runtime
+    }
+  };
   ensureAutoMarkerNoop();
+  ensureStudioCustomEase();
   // Normalize html/body so browser defaults (8px margin, white background) never
   // bleed into renders as white bars. Runs in both preview and render contexts,
   // eliminating the preview/render parity gap that existed when only the React
@@ -1207,8 +1248,52 @@ export function initSandboxRuntimeModular(): void {
   // (setTimeout(0)). Scripts using requestAnimationFrame or longer delays may
   // not be discovered.
   let childrenBound = false;
+  // A GSAP keyframes tween (`{ keyframes: {...}, ease }`) builds an INNER timeline
+  // whose own `_ease` GSAP resolves ONCE, at build time, via the internal
+  // `_parseEase(vars.ease)` (gsap-core: `tl._ease = _parseEase(keyframes.ease ||
+  // vars.ease || "none")`). On render it calls that inner `timeline._ease(...)`.
+  // The composition's inline `<script>` runs and builds these tweens BEFORE this
+  // runtime finishes registering the custom eases (hold/spring/wiggle/custom) in
+  // GSAP's internal ease map — so for a custom container ease the inner `_ease`
+  // bakes to `undefined`, and the first render throws "_ease is not a function"
+  // (a masked cross-origin Script error). Registering the eases afterward can't
+  // retro-fix that already-baked value, so re-resolve every keyframes tween's
+  // inner `_ease` here, once the eases are registered.
+  const repairKeyframeInnerEase = (tlLike: unknown): void => {
+    const g = (window as unknown as { gsap?: { parseEase?: (e: unknown) => unknown } }).gsap;
+    const tl = tlLike as { getChildren?: (a: boolean, b: boolean, c: boolean) => unknown[] } | null;
+    if (!tl || typeof tl.getChildren !== "function" || !g || typeof g.parseEase !== "function")
+      return;
+    for (const child of tl.getChildren(true, true, true)) {
+      const k = child as {
+        timeline?: { _ease?: unknown };
+        vars?: { ease?: unknown; keyframes?: unknown };
+      };
+      const inner = k.timeline;
+      if (!inner || !("_ease" in inner) || typeof inner._ease === "function") continue;
+      const kf = k.vars?.keyframes;
+      const kfEase = kf && !Array.isArray(kf) ? (kf as { ease?: unknown }).ease : undefined;
+      const ease = kfEase ?? k.vars?.ease ?? "none";
+      try {
+        const resolved = g.parseEase(ease);
+        if (typeof resolved === "function") inner._ease = resolved;
+      } catch (err) {
+        emitAnalyticsEvent("keyframe_ease_repair_failed", {
+          ease: typeof ease === "string" ? ease : String(ease),
+        });
+        swallow("runtime.keyframeEase.repair", err);
+      }
+    }
+  };
   // fallow-ignore-next-line complexity
   const bindRootTimelineIfAvailable = (): boolean => {
+    // Custom eases (hold/spring/wiggle/custom) must be registered in GSAP's
+    // internal ease map BEFORE this function's prime render (progress/totalTime
+    // below), or a keyframe segment using one resolves to a non-function ease
+    // and GSAP throws "_ease is not a function" at render. The one-shot call in
+    // init runs early, but if GSAP wasn't ready then (load-order race) it's a
+    // no-op with no retry — so re-assert here, at the render site. Idempotent.
+    ensureStudioCustomEase();
     if (!externalCompositionsReady) return false;
     const currentTimeline = state.capturedTimeline;
     const currentDuration = getTimelineDurationSeconds(currentTimeline);
@@ -1229,6 +1314,8 @@ export function initSandboxRuntimeModular(): void {
     if (typeof state.capturedTimeline.timeScale === "function") {
       state.capturedTimeline.timeScale(state.playbackRate);
     }
+    // Repair keyframe inner-timeline eases before any prime render (see helper above).
+    repairKeyframeInnerEase(state.capturedTimeline);
     const boundDuration = getSafeTimelineDurationSeconds(state.capturedTimeline, 0);
     if (boundDuration <= 0) {
       // No resolvable duration (e.g. a set()-only timeline, or one whose
@@ -2371,8 +2458,6 @@ export function initSandboxRuntimeModular(): void {
   window.__player = createPlayerApiCompat(player);
   window.__playerReady = true;
 
-  // Wire analytics event emission through the bridge
-  initRuntimeAnalytics(postRuntimeMessage as (payload: unknown) => void);
   emitAnalyticsEvent("composition_loaded", {
     duration: player.getDuration(),
     compositionId:
diff --git a/packages/core/src/runtime/types.ts b/packages/core/src/runtime/types.ts
index 79502d88c8..e2c7443494 100644
--- a/packages/core/src/runtime/types.ts
+++ b/packages/core/src/runtime/types.ts
@@ -1,4 +1,5 @@
 import type { HfColorGradingTarget } from "../colorGrading";
+import type { RuntimeAnalyticsEvent } from "./analytics";
 
 export type RuntimeJson =
   | string
@@ -177,13 +178,7 @@ export type RuntimeReadyMessage = {
 export type RuntimeAnalyticsMessage = {
   source: "hf-preview";
   type: "analytics";
-  event:
-    | "composition_loaded"
-    | "composition_played"
-    | "composition_paused"
-    | "composition_seeked"
-    | "composition_ended"
-    | "element_picked";
+  event: RuntimeAnalyticsEvent;
   properties: Record<string, string | number | boolean | null>;
 };
 
diff --git a/packages/core/src/runtime/wiggleEase.test.ts b/packages/core/src/runtime/wiggleEase.test.ts
new file mode 100644
index 0000000000..98805f4c36
--- /dev/null
+++ b/packages/core/src/runtime/wiggleEase.test.ts
@@ -0,0 +1,115 @@
+import { describe, expect, it } from "vitest";
+import { evaluateWiggleEase, parseWiggleEase, resolveWiggleEase } from "./wiggleEase";
+
+function countExtrema(samples: number[]): number {
+  let previousDirection = 0;
+  let extrema = 0;
+  for (let index = 1; index < samples.length; index += 1) {
+    const delta = samples[index]! - samples[index - 1]!;
+    const direction = Math.sign(delta);
+    if (direction !== 0 && previousDirection !== 0 && direction !== previousDirection) extrema += 1;
+    if (direction !== 0) previousDirection = direction;
+  }
+  return extrema;
+}
+
+function maximumDeviation(
+  type: "easeOut" | "easeInOut" | "uniform",
+  from: number,
+  to: number,
+  amplitude?: number,
+) {
+  return Math.max(
+    ...Array.from({ length: 101 }, (_, index) => {
+      const progress = from + ((to - from) * index) / 100;
+      return Math.abs(evaluateWiggleEase(progress, 6, type, amplitude) - progress);
+    }),
+  );
+}
+
+describe("wiggle ease", () => {
+  it("parses positive integer wiggle counts and supported types", () => {
+    expect(parseWiggleEase(" wiggle(6, easeInOut) ")).toEqual({
+      wiggles: 6,
+      type: "easeInOut",
+    });
+    expect(parseWiggleEase("wiggle(3,easeInOut,0.12)")).toEqual({
+      wiggles: 3,
+      type: "easeInOut",
+      amplitude: 0.12,
+    });
+    expect(parseWiggleEase("wiggle(3,easeInOut,0)")?.amplitude).toBe(0);
+    expect(parseWiggleEase("wiggle(3,easeInOut,1)")?.amplitude).toBe(1);
+    expect(parseWiggleEase("wiggle(0,easeOut)")).toBeNull();
+    expect(parseWiggleEase("wiggle(2.5,uniform)")).toBeNull();
+    expect(parseWiggleEase("wiggle(3,unknown)")).toBeNull();
+    expect(parseWiggleEase("wiggle(3,easeInOut,-0.1)")).toBeNull();
+    expect(parseWiggleEase("wiggle(3,easeInOut,1.1)")).toBeNull();
+  });
+
+  it("is deterministic, endpoint-normalized, and oscillatory", () => {
+    const progress = Array.from({ length: 401 }, (_, index) => index / 400);
+    const first = progress.map((value) => evaluateWiggleEase(value, 6, "easeInOut"));
+    const second = progress.map((value) => evaluateWiggleEase(value, 6, "easeInOut"));
+
+    expect(first).toEqual(second);
+    expect(first[0]).toBe(0);
+    expect(first.at(-1)).toBe(1);
+    expect(countExtrema(first)).toBeGreaterThanOrEqual(8);
+
+    const explicitFirst = progress.map((value) => evaluateWiggleEase(value, 6, "easeInOut", 0.2));
+    const explicitSecond = progress.map((value) => evaluateWiggleEase(value, 6, "easeInOut", 0.2));
+    expect(explicitFirst).toEqual(explicitSecond);
+    expect(explicitFirst[0]).toBe(0);
+    expect(explicitFirst.at(-1)).toBe(1);
+    expect(Number.isNaN(evaluateWiggleEase(Number.NaN, 6, "easeInOut"))).toBe(true);
+  });
+
+  it("uses an explicit amplitude as the peak envelope amplitude", () => {
+    expect(maximumDeviation("easeInOut", 0, 1, 0.2)).toBeGreaterThan(
+      maximumDeviation("easeInOut", 0, 1, 0.1),
+    );
+  });
+
+  it("preserves the per-type defaults when amplitude is omitted", () => {
+    const progress = [0.125, 0.25, 0.5, 0.75, 0.875];
+    expect(progress.map((value) => evaluateWiggleEase(value, 6, "easeInOut"))).toEqual(
+      progress.map((value) => evaluateWiggleEase(value, 6, "easeInOut", 0.08)),
+    );
+    expect(progress.map((value) => evaluateWiggleEase(value, 6, "easeOut"))).toEqual(
+      progress.map((value) => evaluateWiggleEase(value, 6, "easeOut", 0.16)),
+    );
+    expect(progress.map((value) => evaluateWiggleEase(value, 6, "uniform"))).toEqual(
+      progress.map((value) => evaluateWiggleEase(value, 6, "uniform", 0.14)),
+    );
+  });
+
+  it("applies the CustomWiggle-style amplitude envelopes", () => {
+    expect(maximumDeviation("easeOut", 0, 0.25)).toBeGreaterThan(
+      maximumDeviation("easeOut", 0.75, 1),
+    );
+    expect(maximumDeviation("easeInOut", 0.375, 0.625)).toBeGreaterThan(
+      maximumDeviation("easeInOut", 0, 0.125),
+    );
+    expect(maximumDeviation("uniform", 0, 0.25)).toBeCloseTo(
+      maximumDeviation("uniform", 0.75, 1),
+      6,
+    );
+    expect(evaluateWiggleEase(0.025, 5, "anticipate")).toBeLessThan(0);
+  });
+
+  it("caches resolved functions by normalized parameters", () => {
+    const cache = new Map();
+    const first = resolveWiggleEase("wiggle(6,easeInOut,0.2)", cache);
+    const second = resolveWiggleEase(" wiggle(6, easeInOut, 0.20) ", cache);
+    const differentAmplitude = resolveWiggleEase("wiggle(6,easeInOut,0.1)", cache);
+    const legacyFirst = resolveWiggleEase("wiggle(6,easeInOut)", cache);
+    const legacySecond = resolveWiggleEase(" wiggle(6, easeInOut) ", cache);
+
+    expect(first).not.toBeNull();
+    expect(first).toBe(second);
+    expect(first).not.toBe(differentAmplitude);
+    expect(legacyFirst).toBe(legacySecond);
+    expect(resolveWiggleEase("wiggle(6,easeInOut,0.2)", new Map())).not.toBe(first);
+  });
+});
diff --git a/packages/core/src/runtime/wiggleEase.ts b/packages/core/src/runtime/wiggleEase.ts
new file mode 100644
index 0000000000..15cdb2983b
--- /dev/null
+++ b/packages/core/src/runtime/wiggleEase.ts
@@ -0,0 +1,68 @@
+export type WiggleType = "easeOut" | "easeInOut" | "anticipate" | "uniform";
+
+export type WiggleEaseConfig = {
+  wiggles: number;
+  type: WiggleType;
+  amplitude?: number;
+};
+
+type WiggleEase = (progress: number) => number;
+
+const WIGGLE_TOKEN =
+  /^\s*wiggle\(\s*(\d+)\s*,\s*(easeOut|easeInOut|anticipate|uniform)\s*(?:,\s*([+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?)\s*)?\)\s*$/;
+const TAU = Math.PI * 2;
+
+export function parseWiggleEase(ease: string): WiggleEaseConfig | null {
+  const match = WIGGLE_TOKEN.exec(ease);
+  if (!match) return null;
+  const wiggles = Number(match[1]);
+  if (!Number.isSafeInteger(wiggles) || wiggles < 1) return null;
+  const type = match[2];
+  if (type !== "easeOut" && type !== "easeInOut" && type !== "anticipate" && type !== "uniform") {
+    return null;
+  }
+  if (match[3] === undefined) return { wiggles, type };
+  const amplitude = Number(match[3]);
+  if (!Number.isFinite(amplitude) || amplitude < 0 || amplitude > 1) return null;
+  return { wiggles, type, amplitude };
+}
+
+export function evaluateWiggleEase(
+  progress: number,
+  wiggles: number,
+  type: WiggleType,
+  amplitude?: number,
+): number {
+  if (!Number.isFinite(progress)) return progress;
+  if (progress <= 0) return 0;
+  if (progress >= 1) return 1;
+
+  const peakAmplitude =
+    amplitude ??
+    (type === "easeInOut" ? 0.08 : type === "uniform" ? 0.14 : type === "anticipate" ? 0.12 : 0.16);
+  const envelope =
+    type === "easeInOut"
+      ? peakAmplitude * Math.sin(Math.PI * progress)
+      : type === "uniform"
+        ? peakAmplitude
+        : peakAmplitude * (1 - progress);
+  const direction = type === "anticipate" ? -1 : 1;
+  // Overshoot outside [0, 1] is intentional: wiggle eases model spring-like
+  // motion while still pinning the exact segment endpoints above.
+  return progress + direction * envelope * Math.sin(TAU * wiggles * progress);
+}
+
+export function resolveWiggleEase(
+  ease: string,
+  cache?: Map<string, WiggleEase>,
+): WiggleEase | null {
+  const config = parseWiggleEase(ease);
+  if (!config) return null;
+  const key = `${config.wiggles}:${config.type}:${config.amplitude ?? "default"}`;
+  const cached = cache?.get(key);
+  if (cached) return cached;
+  const wiggleEase: WiggleEase = (progress) =>
+    evaluateWiggleEase(progress, config.wiggles, config.type, config.amplitude);
+  cache?.set(key, wiggleEase);
+  return wiggleEase;
+}
diff --git a/packages/core/src/runtime/window.d.ts b/packages/core/src/runtime/window.d.ts
index 5779df0c1d..d616c7ee79 100644
--- a/packages/core/src/runtime/window.d.ts
+++ b/packages/core/src/runtime/window.d.ts
@@ -75,6 +75,11 @@ declare global {
     __HF_PICKER_API?: HyperframePickerApi;
     gsap?: {
       timeline: (params?: { paused?: boolean }) => RuntimeTimelineLike;
+      parseEase?: (
+        ease: string | ((progress: number) => number),
+        ...args: unknown[]
+      ) => ((progress: number) => number) | null;
+      registerPlugin?: (plugin: unknown) => void;
       ticker?: {
         tick: () => void;
       };
diff --git a/packages/core/tsconfig.json b/packages/core/tsconfig.json
index 7cb20a06c7..d37173bc73 100644
--- a/packages/core/tsconfig.json
+++ b/packages/core/tsconfig.json
@@ -18,7 +18,8 @@
     "src/runtime/mediaVolumeEnvelope.ts",
     "src/runtime/positionEdits.ts",
     "src/runtime/protocol.ts",
-    "src/runtime/stackingContext.ts"
+    "src/runtime/stackingContext.ts",
+    "src/runtime/wiggleEase.ts"
   ],
   "include": ["src/**/*"],
   "exclude": [
diff --git a/packages/parsers/src/gsapConstants.ts b/packages/parsers/src/gsapConstants.ts
index 8bea681c7b..563ca09c7f 100644
--- a/packages/parsers/src/gsapConstants.ts
+++ b/packages/parsers/src/gsapConstants.ts
@@ -112,13 +112,17 @@ export const SUPPORTED_EASES = [
   "bounce.in",
   "bounce.out",
   "bounce.inOut",
+  "circ.inOut",
   "expo.in",
   "expo.out",
   "expo.inOut",
+  "elastic.out(1,0.3)",
+  "elastic.inOut(1,0.3)",
   "spring-gentle",
   "spring-bouncy",
   "spring-stiff",
   "spring-wobbly",
   "spring-heavy",
+  "hold",
   "steps(1)",
 ];
diff --git a/packages/parsers/src/gsapParser.test.ts b/packages/parsers/src/gsapParser.test.ts
index 2452e8f759..80b7d1f3e6 100644
--- a/packages/parsers/src/gsapParser.test.ts
+++ b/packages/parsers/src/gsapParser.test.ts
@@ -657,6 +657,27 @@ describe("stagger/yoyo/repeat round-trip", () => {
   });
 });
 
+describe("object keyframe per-step duration is not an animatable property", () => {
+  it("excludes `duration` from %-keyed keyframe properties (segment timing must not become a lane)", () => {
+    // A %-keyed object keyframe carrying a stray per-step `duration` — the shape
+    // a buggy array->object conversion produces. `duration` is GSAP segment
+    // timing, not a property; it must never surface as a keyframe lane or get
+    // round-tripped as an animatable value (which corrupts the tween on edit).
+    const script = `
+      const tl = gsap.timeline({ paused: true });
+      tl.to("#card", { keyframes: { "0%": { x: 0, duration: 0 }, "50%": { x: 100, duration: 6, ease: "power2.out" }, "100%": { x: 200, duration: 6 } } }, 0);
+    `;
+    const parsed = parseGsapScript(script);
+    const kfs = parsed.animations[0].keyframes?.keyframes ?? [];
+    expect(kfs.length).toBe(3);
+    for (const kf of kfs) {
+      expect(kf.properties).not.toHaveProperty("duration"); // the fix
+      expect(kf.properties).toHaveProperty("x"); // real animatable prop preserved
+    }
+    expect(kfs[1]?.ease).toBe("power2.out"); // per-keyframe ease still parsed
+  });
+});
+
 describe("unresolvable value round-trip", () => {
   it("preserves unresolvable property values through serialize", () => {
     const script = `
@@ -1920,6 +1941,15 @@ describe("keyframe mutations", () => {
     expect([kf[2]!.properties.x, kf[2]!.properties.y]).toEqual([1040, 0]);
   });
 
+  it("updateKeyframeInScript — array-form ease-only update preserves existing properties", () => {
+    const id = getAnimId(ARRAY_KF_SCRIPT);
+    const updated = updateKeyframeInScript(ARRAY_KF_SCRIPT, id, 33.3, {}, "power2.inOut");
+    const kf = parseGsapScript(updated).animations[0].keyframes!.keyframes;
+    expect(kf[1]!.properties.x).toBe(520);
+    expect(kf[1]!.properties.y).toBe(120);
+    expect(kf[1]!.ease).toBe("power2.inOut");
+  });
+
   it("addKeyframeToScript — array-form: normalizes to object form + inserts 50%", () => {
     const id = getAnimId(ARRAY_KF_SCRIPT);
     const updated = addKeyframeToScript(ARRAY_KF_SCRIPT, id, 50, { x: 780, y: 60 });
diff --git a/packages/parsers/src/gsapParser.ts b/packages/parsers/src/gsapParser.ts
index 4e50cdabcf..917b8a537a 100644
--- a/packages/parsers/src/gsapParser.ts
+++ b/packages/parsers/src/gsapParser.ts
@@ -686,6 +686,12 @@ function parsePercentageKeyframes(node: AstNode, scope: ScopeBindings): GsapKeyf
       for (const [k, v] of Object.entries(record)) {
         if (k === "ease" && typeof v === "string") {
           kfEase = v;
+        } else if (k === "duration") {
+          // `duration` is array-keyframe segment timing, not an animatable
+          // property. In a %-keyed object keyframe the % key owns timing, so a
+          // per-step `duration` is neither timing nor a property — skip it, or
+          // it surfaces as a bogus keyframe lane and corrupts the round-trip.
+          continue;
         } else if (typeof v === "number" || typeof v === "string") {
           properties[k] = v;
         }
@@ -2020,6 +2026,18 @@ function buildKeyframeValueNode(
   return parseExpr(`{ ${entries.join(", ")} }`);
 }
 
+function setObjectExpressionEase(node: AstNode, ease: string): boolean {
+  if (node?.type !== "ObjectExpression") return false;
+  const props = (node.properties ?? []) as AstNode[];
+  const easeIdx = props.findIndex(
+    (property: AstNode) => isObjectProperty(property) && propKeyName(property) === "ease",
+  );
+  const easeNode = parseExpr(`({ ease: ${JSON.stringify(ease)} })`).properties[0];
+  if (easeIdx >= 0) props[easeIdx] = easeNode;
+  else props.push(easeNode);
+  return true;
+}
+
 /** Parse + locate a target animation, returning null on failure. */
 function locateAnimation(
   script: string,
@@ -2473,7 +2491,12 @@ export function updateKeyframeInScript(
       }
     }
     if (matchIdx === -1) return script;
-    const realIdx = arrVal.elements.indexOf(elements[matchIdx]);
+    const matchEl = elements[matchIdx];
+    if (!matchEl) return script;
+    const realIdx = arrVal.elements.indexOf(matchEl);
+    if (Object.keys(properties).length === 0 && ease && setObjectExpressionEase(matchEl, ease)) {
+      return recast.print(arrLoc.parsed.ast).code;
+    }
     arrVal.elements[realIdx] = buildKeyframeValueNode(properties, ease);
     return recast.print(arrLoc.parsed.ast).code;
   }
@@ -2487,18 +2510,7 @@ export function updateKeyframeInScript(
 
   if (Object.keys(properties).length === 0 && ease) {
     // Ease-only update: preserve existing properties, just add/replace ease
-    const existing = match.prop.value;
-    if (existing?.type === "ObjectExpression") {
-      const props = (existing.properties ?? []) as AstNode[];
-      const easeIdx = props.findIndex(
-        (p: AstNode) => isObjectProperty(p) && propKeyName(p) === "ease",
-      );
-      const easeNode = parseExpr(`({ ease: ${JSON.stringify(ease)} })`).properties[0];
-      if (easeIdx >= 0) {
-        props[easeIdx] = easeNode;
-      } else {
-        props.push(easeNode);
-      }
+    if (setObjectExpressionEase(match.prop.value, ease)) {
       return recast.print(loc.parsed.ast).code;
     }
     // Non-object keyframe value (primitive shorthand, e.g. "50%": "0.5"): there
diff --git a/packages/parsers/src/gsapParserAcorn.full.test.ts b/packages/parsers/src/gsapParserAcorn.full.test.ts
index 8de531af3f..77b63b4aff 100644
--- a/packages/parsers/src/gsapParserAcorn.full.test.ts
+++ b/packages/parsers/src/gsapParserAcorn.full.test.ts
@@ -84,6 +84,24 @@ const REAL_WORLD_SCRIPT = `(function () {
 // ── parseGsapScript ───────────────────────────────────────────────────────────
 
 describe("parseGsapScript", () => {
+  it("excludes per-step `duration` from %-keyed keyframe properties (segment timing is not a lane)", () => {
+    // A %-keyed object keyframe carrying a stray per-step `duration` — the shape
+    // a buggy array->object conversion produces. `duration` is GSAP segment
+    // timing, not an animatable property; it must not surface as a keyframe lane
+    // or round-trip as a property (which corrupts the tween on the next edit).
+    const script = `
+      const tl = gsap.timeline({ paused: true });
+      tl.to("#card", { keyframes: { "0%": { x: 0, duration: 0 }, "50%": { x: 100, duration: 6, ease: "power2.out" }, "100%": { x: 200, duration: 6 } } }, 0);
+    `;
+    const anim = parseGsapScript(script).animations[0]!;
+    const kfs = expectKeyframesFormat(anim, "percentage", 3);
+    for (const kf of kfs) {
+      expect(kf.properties).not.toHaveProperty("duration"); // the fix
+      expect(kf.properties).toHaveProperty("x"); // real animatable prop preserved
+    }
+    expect(kfs[1]!.ease).toBe("power2.out"); // per-keyframe ease still parsed
+  });
+
   it("parses a basic timeline with .to()", () => {
     const script = `
       const tl = gsap.timeline({ paused: true });
diff --git a/packages/parsers/src/gsapParserAcorn.ts b/packages/parsers/src/gsapParserAcorn.ts
index b8e61c2a24..f578879cd6 100644
--- a/packages/parsers/src/gsapParserAcorn.ts
+++ b/packages/parsers/src/gsapParserAcorn.ts
@@ -991,6 +991,14 @@ function parsePercentageKeyframes(
       for (const [k, v] of Object.entries(record)) {
         if (k === "ease" && typeof v === "string") {
           kfEase = v;
+        } else if (k === "duration") {
+          // `duration` is array-keyframe SEGMENT TIMING, not an animatable
+          // property. In a %-keyed object keyframe the % key owns timing, so a
+          // per-step `duration` is neither timing nor a property here. Skip it
+          // (parseObjectArrayKeyframes already does) — otherwise it surfaces as
+          // a bogus "duration" keyframe lane and gets round-tripped as a
+          // property, corrupting the tween on the next manual edit.
+          continue;
         } else if (typeof v === "number" || typeof v === "string") {
           properties[k] = v;
         }
diff --git a/packages/parsers/src/gsapWriter.acorn.test.ts b/packages/parsers/src/gsapWriter.acorn.test.ts
index e7ddd41dc8..96d7147750 100644
--- a/packages/parsers/src/gsapWriter.acorn.test.ts
+++ b/packages/parsers/src/gsapWriter.acorn.test.ts
@@ -15,7 +15,9 @@ import {
   updateAnimationInScript,
   updateKeyframeInScript,
 } from "./gsapWriterAcorn.js";
+import { parseGsapScriptAcorn } from "./gsapParserAcorn.js";
 import { parseGsapScript } from "./gsapParser.js";
+import { validateCompositionGsap } from "./gsapSerialize.js";
 
 // ---------------------------------------------------------------------------
 // Fixture scripts
@@ -376,6 +378,25 @@ describe("T6c — keyframe write ops", () => {
     expect(result.indexOf('"25%"')).toBeLessThan(result.indexOf('"50%"'));
   });
 
+  it("addKeyframeToScript converts a flat tween and round-trips three sane points", () => {
+    const script = `\
+var tl = gsap.timeline({ paused: true });
+tl.to("#box", { x: 420, duration: 1 }, 0);
+window.__timelines["t"] = tl;`;
+    const animationId = parseGsapScriptAcorn(script).animations[0]!.id;
+
+    const result = addKeyframeToScript(script, animationId, 50, { x: 210 });
+    const reparsed = parseGsapScriptAcorn(result);
+
+    expect(reparsed.animations).toHaveLength(1);
+    expect(reparsed.animations[0]?.keyframes?.keyframes).toEqual([
+      { percentage: 0, properties: { x: 0 } },
+      { percentage: 50, properties: { x: 210 } },
+      { percentage: 100, properties: { x: 420 } },
+    ]);
+    expect(validateCompositionGsap(result)).toEqual({ valid: true, errors: [], warnings: [] });
+  });
+
   it("addKeyframeToScript replaces value when percentage already exists", () => {
     const result = addKeyframeToScript(SCRIPT_D, "#box-to-200-visual", 50, { opacity: 0.99 });
     expect(result).toContain("opacity: 0.99");

From d84e999f728e25cee15a71995805a52d0a7907c4 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Tue, 21 Jul 2026 05:46:56 +0200
Subject: [PATCH 058/125] fix(parsers): preserve authored keyframe intent

---
 packages/parsers/src/gsapParser.test.ts       |  23 ++++
 packages/parsers/src/gsapParser.ts            |  93 +++++++++----
 packages/parsers/src/gsapSerialize.ts         |  30 +++++
 .../parsers/src/gsapWriter.parity.test.ts     | 115 +++++++++++++++--
 packages/parsers/src/gsapWriterAcorn.ts       | 122 +++++++++++++-----
 .../src/hooks/useGsapScriptCommits.test.tsx   |  15 +++
 .../studio/src/hooks/useGsapScriptCommits.ts  |  15 ++-
 7 files changed, 346 insertions(+), 67 deletions(-)

diff --git a/packages/parsers/src/gsapParser.test.ts b/packages/parsers/src/gsapParser.test.ts
index 80b7d1f3e6..eafbf09628 100644
--- a/packages/parsers/src/gsapParser.test.ts
+++ b/packages/parsers/src/gsapParser.test.ts
@@ -3057,6 +3057,29 @@ describe("single position write per element (consolidation)", () => {
     expect(out).not.toMatch(/gsap\.set\("#box",\s*\{\s*x:/);
     expect(parseGsapScript(out).animations.some((a) => "opacity" in a.properties)).toBe(true);
   });
+
+  it("remove-all-keyframes collapses synthetic motionPath keyframes to a held position", () => {
+    const script = `
+      const tl = gsap.timeline({ paused: true });
+      tl.to("#box", {
+        motionPath: { path: [{ x: 0, y: 10 }, { x: 200, y: 40 }] },
+        duration: 2,
+        ease: "power1.inOut",
+      }, 1);
+    `;
+    const motionPathTween = parseGsapScript(script).animations.find(
+      (animation) => animation.arcPath?.enabled,
+    )!;
+
+    const out = removeAllKeyframesFromScript(script, motionPathTween.id);
+    const kept = posWritesFor(out, "#box");
+
+    expect(out).not.toBe(script);
+    expect(kept).toHaveLength(1);
+    expect(kept[0].arcPath).toBeUndefined();
+    expect(kept[0].duration).toBe(0);
+    expect(kept[0].properties).toMatchObject({ x: 200, y: 40 });
+  });
 });
 
 describe("recast writer never doubles vars keys", () => {
diff --git a/packages/parsers/src/gsapParser.ts b/packages/parsers/src/gsapParser.ts
index 917b8a537a..24f42ec71e 100644
--- a/packages/parsers/src/gsapParser.ts
+++ b/packages/parsers/src/gsapParser.ts
@@ -21,6 +21,7 @@ import {
   serializeValue as valueToCode,
   safeJsKey as safeKey,
   resolveConversionProps,
+  mergePercentageKeyframes,
 } from "./gsapSerialize";
 
 export type {
@@ -1967,7 +1968,7 @@ function buildKeyframeObjectCode(
   }>,
   options?: { easeEach?: string },
 ): string {
-  const entries = keyframes.map((kf) => {
+  const entries = mergePercentageKeyframes(keyframes).map((kf) => {
     const props = keyframePropsToCode(kf);
     if (kf.ease) props.push(`ease: ${JSON.stringify(kf.ease)}`);
     if (kf.auto) props.push(`_auto: 1`);
@@ -2361,10 +2362,9 @@ export function removeKeyframeFromScript(
 /**
  * Retime a keyframe: move the keyframe at `fromPercentage` to `toPercentage`,
  * PRESERVING its properties and per-keyframe ease (the Studio "Move to Playhead"
- * gesture). Re-sorts keyframes by percentage. If a keyframe already exists at
- * `toPercentage`, it is overwritten by the moved one (no duplicate). No-op when
- * the animation/keyframe isn't found, the tween has no object-form keyframes, or
- * the move resolves onto the same keyframe. Acorn twin: moveKeyframeInScript.
+ * gesture). Re-sorts keyframes by percentage. No-op when the animation/keyframe
+ * isn't found, the tween has no object-form keyframes, the move resolves onto the
+ * same keyframe, or the destination is occupied. Acorn twin: moveKeyframeInScript.
  */
 export function moveKeyframeInScript(
   script: string,
@@ -2388,19 +2388,19 @@ export function moveKeyframeInScript(
   // retime, because findKeyframePropByPct resolves the destination back onto the
   // from-keyframe — so a deliberate 1% drag committed nothing. Acorn twin too.
   if (Math.abs(fromPercentage - toPercentage) < MOVE_NOOP_EPSILON_PCT) return script;
-  // A destination keyframe is only a real collision (overwrite) when it's a
-  // DIFFERENT keyframe; resolving back onto the from-keyframe is not.
+  // Never overwrite another authored keyframe. Resolving the destination back
+  // onto the source keyframe is not a collision (the tolerance is intentionally
+  // wider than MOVE_NOOP_EPSILON_PCT).
   const dest = findKeyframePropByPct(kfNode, toPercentage);
-  const collision = dest && dest.prop !== match.prop ? dest : null;
+  if (dest && dest.prop !== match.prop) return script;
 
   // Reuse each keyframe's value node verbatim (preserves properties +
-  // per-keyframe ease + _auto). Drop the moved keyframe (and any destination
-  // keyframe it overwrites), re-key the moved value to toPercentage, then re-sort.
+  // per-keyframe ease + _auto). Drop the moved keyframe, re-key its value to
+  // toPercentage, then re-sort.
   const movedValue = match.prop.value;
   const entries: Array<{ pct: number; value: AstNode }> = [];
   for (const prop of filterPercentageProps(kfNode)) {
     if (prop === match.prop) continue;
-    if (collision && prop === collision.prop) continue;
     const pct = percentageFromKey(propKeyName(prop) ?? "");
     if (Number.isNaN(pct)) continue;
     entries.push({ pct, value: prop.value });
@@ -2452,7 +2452,12 @@ export function resizeKeyframedTweenInScript(
     match.prop.key = parseExpr(`{ ${JSON.stringify(`${to}%`)}: 0 }`).properties[0].key;
   }
 
-  applyUpdatesToCall(loc.target.call, { position: newPosition, duration: newDuration });
+  applyUpdatesToCall(loc.target.call, {
+    position: newPosition,
+    // Resizing is an explicit duration-authoring gesture. Promote GSAP's
+    // implicit default so the dragged window is the window that plays.
+    duration: newDuration,
+  });
   return recast.print(loc.parsed.ast).code;
 }
 
@@ -2501,6 +2506,36 @@ export function updateKeyframeInScript(
     return recast.print(arrLoc.parsed.ast).code;
   }
 
+  // motionPath waypoints are exposed as synthetic keyframes. Their positions
+  // live in `motionPath.path`, while one tween-level ease owns every segment.
+  // Commit both parts when a Studio gesture carries x/y + ease.
+  if (arrLoc && !arrVal && arrLoc.target.animation.arcPath?.enabled) {
+    const propertyKeys = Object.keys(properties);
+    if (propertyKeys.some((key) => key !== "x" && key !== "y")) return script;
+    let next = script;
+    if (propertyKeys.length > 0) {
+      const waypoints = extractArcWaypoints(arrLoc.target.animation);
+      if (waypoints.length < 2) return script;
+      const pointIndex = Math.max(
+        0,
+        Math.min(waypoints.length - 1, Math.round((percentage / 100) * (waypoints.length - 1))),
+      );
+      const current = waypoints[pointIndex];
+      if (!current) return script;
+      const x = properties.x ?? current.x;
+      const y = properties.y ?? current.y;
+      if (typeof x !== "number" || typeof y !== "number") return script;
+      next = updateMotionPathPointInScript(next, animationId, pointIndex, { x, y });
+    }
+    if (ease !== undefined) {
+      const updated = locateAnimationWithFallback(next, animationId);
+      if (!updated) return script;
+      applyUpdatesToCall(updated.target.call, { ease });
+      next = recast.print(updated.parsed.ast).code;
+    }
+    return next;
+  }
+
   const ctx = locateKeyframeCtx(script, animationId, percentage);
   if (!ctx) return script;
   const { loc, kfNode } = ctx;
@@ -2640,19 +2675,29 @@ export function removeAllKeyframesFromScript(script: string, animationId: string
   const kfNode =
     findKeyframesObjectNode(loc.target.call.varsArg) ??
     convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
-  if (!kfNode) return script;
-
-  const kfEntries = filterPercentageProps(kfNode)
-    .map((p: AstNode) => ({ pct: percentageFromKey(propKeyName(p)!), prop: p }))
-    .filter((e) => !Number.isNaN(e.pct))
-    .sort((a, b) => a.pct - b.pct);
-  if (kfEntries.length === 0) return script;
-
-  // For to()/set(): collapse to last keyframe (the destination = visible state).
-  // For from(): collapse to first keyframe (the starting state).
   const method = loc.target.call.method;
-  const collapseEntry = method === "from" ? kfEntries[0]! : kfEntries[kfEntries.length - 1]!;
-  const record = objectExpressionToRecord(collapseEntry.prop.value, loc.parsed.scope);
+  let record: Record<string, unknown>;
+  if (kfNode) {
+    const kfEntries = filterPercentageProps(kfNode)
+      .map((p: AstNode) => ({ pct: percentageFromKey(propKeyName(p)!), prop: p }))
+      .filter((e) => !Number.isNaN(e.pct))
+      .sort((a, b) => a.pct - b.pct);
+    if (kfEntries.length === 0) return script;
+    const collapseEntry = method === "from" ? kfEntries[0]! : kfEntries[kfEntries.length - 1]!;
+    record = objectExpressionToRecord(collapseEntry.prop.value, loc.parsed.scope);
+  } else {
+    // motionPath waypoints are exposed to Studio as synthetic keyframes. They
+    // have no literal `keyframes` node, so collapse the parsed endpoint and
+    // remove the authored path instead of silently returning the original file.
+    const synthetic = loc.target.animation.arcPath?.enabled
+      ? loc.target.animation.keyframes?.keyframes
+      : undefined;
+    if (!synthetic?.length) return script;
+    const sorted = [...synthetic].sort((a, b) => a.percentage - b.percentage);
+    record = (method === "from" ? sorted[0] : sorted[sorted.length - 1])!.properties;
+    removeVarsKey(loc.target.call.varsArg, "motionPath");
+  }
+
   collapseKeyframesToFlat(loc.target.call.varsArg, record);
   // Removing ALL keyframes HOLDS the element statically — collapse to a
   // zero-duration immediateRender tween (a `gsap.set` equivalent), dropping the
diff --git a/packages/parsers/src/gsapSerialize.ts b/packages/parsers/src/gsapSerialize.ts
index d4080a5338..7ccc62db41 100644
--- a/packages/parsers/src/gsapSerialize.ts
+++ b/packages/parsers/src/gsapSerialize.ts
@@ -90,6 +90,36 @@ export interface GsapPercentageKeyframe {
   ease?: string;
 }
 
+export interface WritableGsapPercentageKeyframe extends GsapPercentageKeyframe {
+  auto?: boolean;
+}
+
+/**
+ * Collapse duplicate percentage entries before serializing an object literal.
+ * Matches addKeyframeToScript's merge contract: later properties/ease win while
+ * unrelated authored properties and an earlier ease survive. An explicit later
+ * `auto` value wins, and output is always sorted by percentage.
+ */
+export function mergePercentageKeyframes(
+  keyframes: readonly WritableGsapPercentageKeyframe[],
+): WritableGsapPercentageKeyframe[] {
+  const byPercentage = new Map<number, WritableGsapPercentageKeyframe>();
+  for (const keyframe of keyframes) {
+    const existing = byPercentage.get(keyframe.percentage);
+    if (!existing) {
+      byPercentage.set(keyframe.percentage, {
+        ...keyframe,
+        properties: { ...keyframe.properties },
+      });
+      continue;
+    }
+    existing.properties = { ...existing.properties, ...keyframe.properties };
+    if (keyframe.ease !== undefined) existing.ease = keyframe.ease;
+    if (keyframe.auto !== undefined) existing.auto = keyframe.auto;
+  }
+  return [...byPercentage.values()].sort((a, b) => a.percentage - b.percentage);
+}
+
 export type GsapKeyframeFormat = "percentage" | "object-array" | "simple-array";
 
 export interface GsapKeyframesData {
diff --git a/packages/parsers/src/gsapWriter.parity.test.ts b/packages/parsers/src/gsapWriter.parity.test.ts
index 6f1e4478d4..e934585ffe 100644
--- a/packages/parsers/src/gsapWriter.parity.test.ts
+++ b/packages/parsers/src/gsapWriter.parity.test.ts
@@ -1049,6 +1049,10 @@ const UPD_ARRAY_SCRIPT = `
   const tl = gsap.timeline({ paused: true });
   tl.to("#dot", { keyframes: [{ x: 0, y: 0 }, { x: 50, y: 80 }, { x: 100, y: 0 }], duration: 1 }, 0.2);
 `;
+const UPD_MOTION_PATH_SCRIPT = `
+  const tl = gsap.timeline({ paused: true });
+  tl.to("#title", { motionPath: { path: [{ x: 0, y: 0 }, { x: 100, y: 40 }] }, duration: 1, ease: "power1.inOut" }, 0.2);
+`;
 
 describe("parity: updateKeyframeInScript (recast vs acorn)", () => {
   function expectParity(
@@ -1100,6 +1104,30 @@ describe("parity: updateKeyframeInScript (recast vs acorn)", () => {
     );
   });
 
+  it("updates the authored tween ease for synthetic motion-path keyframes", () => {
+    const id = acornId(UPD_MOTION_PATH_SCRIPT);
+    const ease = "spring(0.42)";
+    const acorn = updateKeyframeAcorn(UPD_MOTION_PATH_SCRIPT, id, 100, {}, ease);
+    const recast = updateKeyframeRecast(UPD_MOTION_PATH_SCRIPT, id, 100, {}, ease);
+
+    expect(modelOf(acorn)).toEqual(modelOf(recast));
+    expect(parseGsapScript(acorn).animations[0]?.ease).toBe(ease);
+    expect(parseGsapScript(recast).animations[0]?.ease).toBe(ease);
+  });
+
+  it("updates a synthetic motion-path point and its tween ease atomically", () => {
+    const id = acornId(UPD_MOTION_PATH_SCRIPT);
+    const ease = "spring(0.42)";
+    const properties = { x: 140, y: 60 };
+    const acorn = updateKeyframeAcorn(UPD_MOTION_PATH_SCRIPT, id, 100, properties, ease);
+    const recast = updateKeyframeRecast(UPD_MOTION_PATH_SCRIPT, id, 100, properties, ease);
+
+    expect(modelOf(acorn)).toEqual(modelOf(recast));
+    const animation = parseGsapScript(acorn).animations[0];
+    expect(animation?.ease).toBe(ease);
+    expect(animation?.keyframes?.keyframes.at(-1)?.properties).toMatchObject(properties);
+  });
+
   // KNOWN DIVERGENCE (acorn-array bug, follow-up — NOT a test artifact):
   // For PARTIAL props on ARRAY-form keyframes the two writers disagree. recast's
   // array branch (gsapParser.updateKeyframeInScript) does a whole-value REPLACE
@@ -1124,8 +1152,9 @@ describe("parity: updateKeyframeInScript (recast vs acorn)", () => {
 // ── moveKeyframeInScript (retime: preserve value + ease) ─────────────────────
 // "Move to Playhead" retimes a keyframe in time, keeping its properties and
 // per-keyframe ease. The moved keyframe must vanish from the source percentage
-// and reappear (with identical value + ease) at the destination; a destination
-// collision is overwritten, not duplicated. recast and acorn must agree.
+// and reappear (with identical value + ease) at the destination. An occupied
+// destination rejects the retime without mutating authored data. Both writers
+// must agree.
 const MOVE_KF_SCRIPT = `
   const tl = gsap.timeline({ paused: true });
   tl.to("#box", { keyframes: { "0%": { x: 0 }, "50%": { x: 100, opacity: 0.5, ease: "power2.in" }, "100%": { x: 200 } }, duration: 1 }, 0.2);
@@ -1145,16 +1174,10 @@ describe("moveKeyframeInScript: retime preserves value + ease (acorn) ", () => {
     expect(pcts).not.toContain(50);
   });
 
-  it("overwrites the destination keyframe on collision (no duplicate)", () => {
+  it("rejects an occupied destination without mutating either writer", () => {
     const id = acornId(MOVE_KF_SCRIPT);
-    const out = moveKeyframeAcorn(MOVE_KF_SCRIPT, id, 50, 100);
-    const kfs = shapeOf(out).keyframes?.keyframes ?? [];
-    const pcts = kfs.map((k) => k.percentage);
-    expect(pcts).toEqual([0, 100]);
-    const dest = kfs.find((k) => k.percentage === 100)!;
-    // The moved keyframe's value + ease replaced the old 100% { x: 200 }.
-    expect(dest.properties).toEqual({ x: 100, opacity: 0.5 });
-    expect(dest.ease).toBe("power2.in");
+    expect(moveKeyframeAcorn(MOVE_KF_SCRIPT, id, 50, 100)).toBe(MOVE_KF_SCRIPT);
+    expect(moveKeyframeRecast(MOVE_KF_SCRIPT, id, 50, 100)).toBe(MOVE_KF_SCRIPT);
   });
 
   it("no-ops only for a negligible move (below the drag epsilon)", () => {
@@ -1203,7 +1226,7 @@ describe("parity: moveKeyframeInScript (recast vs acorn)", () => {
     expectParity(MOVE_KF_SCRIPT, 50, 10);
   });
 
-  it("retime onto an existing percentage (collision overwrite)", () => {
+  it("reject an occupied destination", () => {
     expectParity(MOVE_KF_SCRIPT, 50, 100);
   });
 
@@ -1242,6 +1265,12 @@ describe("moveKeyframeInScript: array-form keyframes (recast + acorn parity)", (
       modelOf(moveKeyframeRecast(KF_ADD_ARRAY_SCRIPT, id, 50, 75)),
     );
   });
+
+  it("leaves array-form source untouched when the destination is occupied", () => {
+    const id = acornId(KF_ADD_ARRAY_SCRIPT);
+    expect(moveKeyframeAcorn(KF_ADD_ARRAY_SCRIPT, id, 50, 100)).toBe(KF_ADD_ARRAY_SCRIPT);
+    expect(moveKeyframeRecast(KF_ADD_ARRAY_SCRIPT, id, 50, 100)).toBe(KF_ADD_ARRAY_SCRIPT);
+  });
 });
 
 // ── resizeKeyframedTweenInScript (boundary drag: re-key + grow window) ────────
@@ -1253,6 +1282,10 @@ const RESIZE_KF_SCRIPT = `
   const tl = gsap.timeline({ paused: true });
   tl.to("#box", { keyframes: { "0%": { opacity: 0, _auto: 1 }, "50%": { opacity: 0.5, ease: "power2.in" }, "100%": { opacity: 1, _auto: 1 }, easeEach: "power1.inOut" }, duration: 1, ease: "power3.out" }, 0.2);
 `;
+const RESIZE_KF_NO_DURATION_SCRIPT = `
+  const tl = gsap.timeline({ paused: true });
+  tl.to("#box", { keyframes: { "0%": { opacity: 0 }, "50%": { opacity: 0.5, ease: "power2.in" }, "100%": { opacity: 1 } }, ease: "power3.out" }, 0.2);
+`;
 // Window [0.2, 1.2]; drag the last keyframe (abs 1.2) out to abs 2.2 → [0.2, 2.2].
 // abs 0.2/0.7/2.2 over the new 2.0s window → 0 / 25 / 100.
 const RESIZE_REMAP = [
@@ -1290,6 +1323,17 @@ describe("resizeKeyframedTweenInScript: preserves author intent (acorn + recast)
     it(`${label}: no-ops on unknown id`, () => {
       expect(resize(RESIZE_KF_SCRIPT, "bad-id", 0.2, 2, RESIZE_REMAP)).toBe(RESIZE_KF_SCRIPT);
     });
+
+    it(`${label}: authors the duration set by the resize gesture`, () => {
+      const id = acornId(RESIZE_KF_NO_DURATION_SCRIPT);
+      const out = resize(RESIZE_KF_NO_DURATION_SCRIPT, id, 0.4, 2, RESIZE_REMAP);
+      const shape = shapeOf(out);
+      expect(shape.duration).toBe(2);
+      expect(parseGsapScript(out).animations[0]!.position).toBeCloseTo(0.4, 5);
+      expect(shape.keyframes?.keyframes.map((keyframe) => keyframe.percentage)).toEqual([
+        0, 25, 100,
+      ]);
+    });
   }
 
   it("parity: both writers reparse to the same model", () => {
@@ -1298,6 +1342,15 @@ describe("resizeKeyframedTweenInScript: preserves author intent (acorn + recast)
       modelOf(resizeKeyframedTweenRecast(RESIZE_KF_SCRIPT, id, 0.2, 2, RESIZE_REMAP)),
     );
   });
+
+  it("parity: both writers promote an implicit duration to the resized value", () => {
+    const id = acornId(RESIZE_KF_NO_DURATION_SCRIPT);
+    expect(
+      modelOf(resizeKeyframedTweenAcorn(RESIZE_KF_NO_DURATION_SCRIPT, id, 0.4, 2, RESIZE_REMAP)),
+    ).toEqual(
+      modelOf(resizeKeyframedTweenRecast(RESIZE_KF_NO_DURATION_SCRIPT, id, 0.4, 2, RESIZE_REMAP)),
+    );
+  });
 });
 
 // Regression: same array-form gap as moveKeyframeInScript above — boundary
@@ -1375,6 +1428,44 @@ function lastModelOf(script: string) {
   return arr[arr.length - 1];
 }
 
+describe("keyframe object builders: duplicate percentage merge", () => {
+  const duplicateKeyframes = [
+    { percentage: 100, properties: { x: 200 } },
+    { percentage: 50, properties: { x: 100 }, ease: "power1.in" },
+    { percentage: 50, properties: { x: 120, opacity: 0.5 }, auto: true },
+    { percentage: 0, properties: { x: 0 } },
+  ];
+
+  for (const [label, add] of [
+    ["acorn", addWithKfAcorn],
+    ["recast", addWithKfRecast],
+  ] as const) {
+    it(`${label}: emits one merged key and preserves authored properties and ease`, () => {
+      const out = add(ADD_WITH_KF_BASE, "#hero", 0, 1, duplicateKeyframes).script;
+      expect(out.match(/["']50%["']\s*:/g)).toHaveLength(1);
+      const atFifty = lastModelOf(out)?.keyframes?.keyframes.filter(
+        (keyframe) => keyframe.percentage === 50,
+      );
+      expect(atFifty).toHaveLength(1);
+      expect(atFifty?.[0]?.properties).toEqual({ x: 120, opacity: 0.5, _auto: 1 });
+      expect(atFifty?.[0]?.ease).toBe("power1.in");
+      expect(lastModelOf(out)?.keyframes?.keyframes.map((keyframe) => keyframe.percentage)).toEqual(
+        [0, 50, 100],
+      );
+    });
+  }
+
+  it("an explicit later auto=false clears an earlier synthetic marker", () => {
+    const out = addWithKfAcorn(ADD_WITH_KF_BASE, "#hero", 0, 1, [
+      { percentage: 0, properties: { x: 0 }, auto: true },
+      { percentage: 0, properties: { opacity: 1 }, auto: false },
+      { percentage: 100, properties: { x: 100 } },
+    ]).script;
+
+    expect(lastModelOf(out)?.keyframes?.keyframes[0]?.properties).toEqual({ x: 0, opacity: 1 });
+  });
+});
+
 // NOTE (WS-3.F): recast is retired, so `recast` here is an alias of the acorn
 // writer and the historical `toEqual(lastModelOf(recast))` comparisons are
 // tautologies. The WS-3.C ops below instead pin the acorn output as golden
diff --git a/packages/parsers/src/gsapWriterAcorn.ts b/packages/parsers/src/gsapWriterAcorn.ts
index f1b481bee7..00b5da5c4e 100644
--- a/packages/parsers/src/gsapWriterAcorn.ts
+++ b/packages/parsers/src/gsapWriterAcorn.ts
@@ -17,6 +17,7 @@ import {
   resolveConversionProps,
   extractArcWaypoints,
   buildMotionPathObjectCode,
+  mergePercentageKeyframes,
 } from "./gsapSerialize.js";
 import {
   parseGsapScriptAcornForWrite,
@@ -865,6 +866,77 @@ function findKfPropByPct(kfNode: Node, percentage: number): { prop: Node; idx: n
   return best;
 }
 
+function updateMotionPathPosition(
+  script: string,
+  target: ParsedGsapAcornForWrite["located"][number],
+  percentage: number,
+  properties: Record<string, number | string>,
+): string | undefined {
+  const waypoints = extractArcWaypoints(target.animation);
+  if (waypoints.length < 2) return undefined;
+  const pointIndex = Math.max(
+    0,
+    Math.min(waypoints.length - 1, Math.round((percentage / 100) * (waypoints.length - 1))),
+  );
+  const current = waypoints[pointIndex];
+  if (!current) return undefined;
+  const x = properties.x ?? current.x;
+  const y = properties.y ?? current.y;
+  if (typeof x !== "number" || typeof y !== "number") return undefined;
+  return updateMotionPathPointInScript(script, target.id, pointIndex, { x, y });
+}
+
+function updateTweenEase(script: string, animationId: string, ease: string): string | undefined {
+  const reparsed = parseGsapScriptAcornForWrite(script);
+  const target = reparsed?.located.find((entry) => entry.id === animationId);
+  if (!target) return undefined;
+  const ms = new MagicString(script);
+  upsertProp(ms, target.call.varsArg, "ease", ease);
+  return ms.toString();
+}
+
+function updateMotionPathKeyframe(
+  script: string,
+  target: ParsedGsapAcornForWrite["located"][number],
+  percentage: number,
+  properties: Record<string, number | string>,
+  ease?: string,
+): string | undefined {
+  if (!target.animation.arcPath?.enabled || !findPropertyNode(target.call.varsArg, "motionPath")) {
+    return undefined;
+  }
+  const propertyKeys = Object.keys(properties);
+  if (propertyKeys.some((key) => key !== "x" && key !== "y")) return undefined;
+  const next =
+    propertyKeys.length === 0
+      ? script
+      : updateMotionPathPosition(script, target, percentage, properties);
+  if (next === undefined || ease === undefined) return next;
+  return updateTweenEase(next, target.id, ease);
+}
+
+function updateObjectKeyframe(
+  script: string,
+  prop: Node,
+  properties: Record<string, number | string>,
+  ease?: string,
+): string {
+  const ms = new MagicString(script);
+  // Merge into the authored object so an edit cannot discard unrelated
+  // keyframed properties at the same percentage.
+  if (prop.value?.type === "ObjectExpression") {
+    for (const [key, value] of Object.entries(properties)) {
+      upsertProp(ms, prop.value, key, value);
+    }
+    if (ease !== undefined) upsertProp(ms, prop.value, "ease", ease);
+  } else {
+    const record: Record<string, number | string> = { ...properties };
+    if (ease) record.ease = ease;
+    ms.overwrite(prop.value.start, prop.value.end, recordToCode(record));
+  }
+  return ms.toString();
+}
+
 export function updateKeyframeInScript(
   script: string,
   animationId: string,
@@ -878,7 +950,12 @@ export function updateKeyframeInScript(
   if (!target) return script;
 
   const kfPropNode = findPropertyNode(target.call.varsArg, "keyframes");
-  if (!kfPropNode) return script;
+  if (!kfPropNode) {
+    // motionPath waypoints are exposed to Studio as synthetic keyframes, but
+    // GSAP authors their positions in `motionPath.path` and one ease for the
+    // whole tween. Commit both parts when a Studio gesture carries x/y + ease.
+    return updateMotionPathKeyframe(script, target, percentage, properties, ease) ?? script;
+  }
 
   // Array-form keyframes (`keyframes: [{x,y}, ...]`) carry no explicit percentages
   // — GSAP distributes them evenly, and the runtime read assigns even percentages
@@ -894,23 +971,7 @@ export function updateKeyframeInScript(
   const match = findKfPropByPct(kfPropNode.value, percentage);
   if (!match) return script;
 
-  const ms = new MagicString(script);
-  // MERGE the edited props into the existing keyframe, preserving properties already
-  // keyframed at this percentage (z, transformPerspective, rotation, …). A whole-value
-  // overwrite DROPS every prop not in this edit — e.g. editing rotationY at the 0%
-  // keyframe would strip z / transformPerspective, so the lens then animates from 0 and
-  // the element pops. Mirrors addKeyframeToScript's merge-into-existing branch.
-  if (match.prop.value?.type === "ObjectExpression") {
-    for (const [k, v] of Object.entries(properties)) {
-      upsertProp(ms, match.prop.value, k, v);
-    }
-    if (ease !== undefined) upsertProp(ms, match.prop.value, "ease", ease);
-  } else {
-    const record: Record<string, number | string> = { ...properties };
-    if (ease) record.ease = ease;
-    ms.overwrite(match.prop.value.start, match.prop.value.end, recordToCode(record));
-  }
-  return ms.toString();
+  return updateObjectKeyframe(script, match.prop, properties, ease);
 }
 
 // ponytail: even-spacing index map; if array keyframes ever carry per-element
@@ -1271,10 +1332,9 @@ export function removeKeyframeFromScript(
 /**
  * Retime a keyframe: move the keyframe at `fromPercentage` to `toPercentage`,
  * PRESERVING its properties and per-keyframe ease (the Studio "Move to Playhead"
- * gesture). Re-sorts keyframes by percentage. If a keyframe already exists at
- * `toPercentage`, it is overwritten by the moved one (no duplicate). No-op when
- * the animation/keyframe isn't found, the tween has no object-form keyframes, or
- * the move resolves onto the same keyframe.
+ * gesture). Re-sorts keyframes by percentage. No-op when the animation/keyframe
+ * isn't found, the tween has no object-form keyframes, the move resolves onto the
+ * same keyframe, or the destination is occupied.
  */
 export function moveKeyframeInScript(
   script: string,
@@ -1296,18 +1356,18 @@ export function moveKeyframeInScript(
   // retime, because findKfPropByPct resolves the destination back onto the
   // from-keyframe — so a deliberate 1% drag committed nothing.
   if (Math.abs(fromPercentage - toPercentage) < MOVE_NOOP_EPSILON_PCT) return src;
-  // A destination keyframe is only a real collision (overwrite) when it's a
-  // DIFFERENT keyframe; resolving back onto the from-keyframe is not.
+  // Never overwrite another authored keyframe. Resolving the destination back
+  // onto the source keyframe is not a collision (the tolerance is intentionally
+  // wider than MOVE_NOOP_EPSILON_PCT).
   const dest = findKfPropByPct(kfNode, toPercentage);
-  const collision = dest && dest.prop !== match.prop ? dest : null;
+  if (dest && dest.prop !== match.prop) return script;
 
-  // Rebuild the keyframes object: drop the moved keyframe (and any keyframe at
-  // the destination it overwrites), re-key the moved record to toPercentage,
-  // then re-sort. recordToCode round-trips properties + per-keyframe ease + _auto.
+  // Rebuild the keyframes object: drop the moved keyframe, re-key the moved
+  // record to toPercentage, then re-sort. recordToCode round-trips properties +
+  // per-keyframe ease + _auto.
   const entries: Array<{ pct: number; record: Record<string, number | string> }> = [];
   for (const prop of percentagePropsOf(kfNode)) {
     if (prop === match.prop) continue;
-    if (collision && prop === collision.prop) continue;
     const pct = percentageFromKey(propKeyName(prop) ?? "");
     if (Number.isNaN(pct)) continue;
     entries.push({ pct, record: valueNodeToRecord(prop.value, src) });
@@ -1365,6 +1425,8 @@ export function resizeKeyframedTweenInScript(
     ms.overwrite(keyNode.start, keyNode.end, JSON.stringify(`${to}%`));
   }
   overwritePosition(ms, target.call, newPosition);
+  // Resizing is an explicit duration-authoring gesture. Promote GSAP's implicit
+  // default to source so the dragged window is the window that plays.
   upsertProp(ms, target.call.varsArg, "duration", newDuration);
   return ms.toString();
 }
@@ -1555,7 +1617,7 @@ function buildKeyframeObjectCode(
   }>,
   easeEach?: string,
 ): string {
-  const entries = keyframes.map((kf) => {
+  const entries = mergePercentageKeyframes(keyframes).map((kf) => {
     const props = Object.entries(kf.properties).map(([k, v]) => `${safeKey(k)}: ${valueToCode(v)}`);
     if (kf.ease) props.push(`ease: ${JSON.stringify(kf.ease)}`);
     if (kf.auto) props.push(`_auto: 1`);
diff --git a/packages/studio/src/hooks/useGsapScriptCommits.test.tsx b/packages/studio/src/hooks/useGsapScriptCommits.test.tsx
index 76ae4930b7..869807eb8a 100644
--- a/packages/studio/src/hooks/useGsapScriptCommits.test.tsx
+++ b/packages/studio/src/hooks/useGsapScriptCommits.test.tsx
@@ -283,6 +283,21 @@ function mockFetchResult(over: Partial<MutationResult> = {}): void {
 }
 
 describe("runCommit — instantPatch wiring", () => {
+  it("explains a deliberate mutation that the server safely rejected as unchanged", async () => {
+    mockFetchResult({ changed: false });
+    const deps = renderCommitHook();
+
+    await act(async () => {
+      await deps.api.commitMutation(
+        selection,
+        { type: "move-keyframe", fromPercentage: 50, toPercentage: 100 },
+        { label: "Move keyframe" },
+      );
+    });
+
+    expect(deps.showToast).toHaveBeenCalledWith("A keyframe already exists at that time", "info");
+  });
+
   it("no-op commit with an instantPatch still patches the runtime (paired x/y commits)", async () => {
     patchRuntimeTweenInPlace.mockReturnValue(true);
     mockFetchResult({ changed: false });
diff --git a/packages/studio/src/hooks/useGsapScriptCommits.ts b/packages/studio/src/hooks/useGsapScriptCommits.ts
index 1ad71c7e73..f43d42e91b 100644
--- a/packages/studio/src/hooks/useGsapScriptCommits.ts
+++ b/packages/studio/src/hooks/useGsapScriptCommits.ts
@@ -77,6 +77,17 @@ async function mutateGsapScriptBatch(
 
 type ShowToast = (message: string, tone?: "error" | "info") => void;
 
+function showUnchangedMutationFeedback(
+  mutations: Record<string, unknown>[],
+  result: MutationResult,
+  showToast: ShowToast | undefined,
+): void {
+  if (result.changed !== false || mutations.length !== 1) return;
+  if (mutations[0]?.type === "move-keyframe") {
+    showToast?.("A keyframe already exists at that time", "info");
+  }
+}
+
 async function runMutationRequest(
   mutations: Record<string, unknown>[],
   options: CommitMutationOptions,
@@ -94,7 +105,9 @@ async function runMutationRequest(
     );
   }
   try {
-    return await request();
+    const result = await request();
+    showUnchangedMutationFeedback(mutations, result, showToast);
+    return result;
   } catch (error) {
     if (error instanceof GsapMutationHttpError) {
       showToast?.(formatGsapMutationRejectionToast(error), "error");

From c253dec23b0a6f1ccfe49c17371fdc9823f73b4c Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Tue, 21 Jul 2026 05:48:08 +0200
Subject: [PATCH 059/125] feat(studio): add keyframe ease editor

---
 .../src/gsapWriter.reviewFixes.test.ts        |  11 +
 .../components/editor/AnimationCard.test.tsx  | 100 +++
 .../src/components/editor/AnimationCard.tsx   |   7 +-
 .../editor/EaseCurveSection.test.tsx          | 348 +++++++++
 .../components/editor/EaseCurveSection.tsx    | 681 ++++++++++++------
 .../editor/EaseParamFields.test.tsx           | 188 +++++
 .../src/components/editor/EaseParamFields.tsx | 246 +++++++
 .../src/components/editor/easeCurveSvg.tsx    |  65 ++
 .../editor/easePresetLibrary.test.ts          | 114 +++
 .../components/editor/easePresetLibrary.ts    |  49 ++
 .../editor/gsapAnimationConstants.ts          |  28 +-
 packages/studio/src/telemetry/events.test.ts  |   9 +
 packages/studio/src/telemetry/events.ts       |   5 +
 13 files changed, 1599 insertions(+), 252 deletions(-)
 create mode 100644 packages/studio/src/components/editor/EaseCurveSection.test.tsx
 create mode 100644 packages/studio/src/components/editor/EaseParamFields.test.tsx
 create mode 100644 packages/studio/src/components/editor/EaseParamFields.tsx
 create mode 100644 packages/studio/src/components/editor/easeCurveSvg.tsx
 create mode 100644 packages/studio/src/components/editor/easePresetLibrary.test.ts
 create mode 100644 packages/studio/src/components/editor/easePresetLibrary.ts

diff --git a/packages/parsers/src/gsapWriter.reviewFixes.test.ts b/packages/parsers/src/gsapWriter.reviewFixes.test.ts
index 11ed3c460e..d5531f5f28 100644
--- a/packages/parsers/src/gsapWriter.reviewFixes.test.ts
+++ b/packages/parsers/src/gsapWriter.reviewFixes.test.ts
@@ -299,6 +299,17 @@ tl.to(".a", { keyframes: { "0%": { x: 0 }, "100%": { x: 100 } }, duration: 1, ea
     // The original top-level `ease: "none"` is untouched (no second top-level ease).
     expect((out.match(/ease: "power2.inOut"/g) ?? []).length).toBe(0);
   });
+
+  it("round-trips an editor-authored CustomEase through write and reparse", () => {
+    const customEase = "custom(M0,0 C0.18,0.9 0.32,1.2 1,1)";
+    const id = parseGsapScriptAcornForWrite(KF)?.located[0]?.id ?? "";
+    const out = updateKeyframeInScript(KF, id, 100, { x: 100 }, customEase);
+    const keyframe = parseGsapScriptAcornForWrite(
+      out,
+    )?.located[0]?.animation.keyframes?.keyframes.find(({ percentage }) => percentage === 100);
+
+    expect(keyframe?.ease).toBe(customEase);
+  });
 });
 
 // ── #8 — convertToKeyframes preserves builtin vars like `delay` ──
diff --git a/packages/studio/src/components/editor/AnimationCard.test.tsx b/packages/studio/src/components/editor/AnimationCard.test.tsx
index 63562fe734..802e07470d 100644
--- a/packages/studio/src/components/editor/AnimationCard.test.tsx
+++ b/packages/studio/src/components/editor/AnimationCard.test.tsx
@@ -5,11 +5,16 @@ import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { AnimationCard } from "./AnimationCard";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import { EASE_PRESETS } from "./easePresetLibrary";
+
+const trackStudioSegmentEaseEdit = vi.hoisted(() => vi.fn());
+vi.mock("../../telemetry/events", () => ({ trackStudioSegmentEaseEdit }));
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
 afterEach(() => {
   document.body.innerHTML = "";
+  trackStudioSegmentEaseEdit.mockClear();
 });
 
 function baseAnimation(overrides: Partial<GsapAnimation> = {}): GsapAnimation {
@@ -26,6 +31,101 @@ function baseAnimation(overrides: Partial<GsapAnimation> = {}): GsapAnimation {
 
 const noop = () => {};
 
+function selectPreset(host: HTMLElement, presetId: string): string {
+  const presetConfig = EASE_PRESETS.find((candidate) => candidate.id === presetId);
+  if (!presetConfig) throw new Error(`Missing ease preset: ${presetId}`);
+
+  const dropdown = host.querySelector<HTMLButtonElement>("[data-ease-type-dropdown]");
+  expect(dropdown).not.toBeNull();
+  act(() => dropdown?.click());
+
+  const preset = host.querySelector<HTMLButtonElement>(`[data-ease-preset-id="${presetId}"]`);
+  expect(preset).not.toBeNull();
+  act(() => preset?.click());
+  return presetConfig.ease;
+}
+
+function renderExpandedCard({
+  animation,
+  flat,
+  onUpdateMeta = vi.fn(),
+  onUpdateKeyframeEase = vi.fn(),
+}: {
+  animation: GsapAnimation;
+  flat?: boolean;
+  onUpdateMeta?: ReturnType<typeof vi.fn>;
+  onUpdateKeyframeEase?: ReturnType<typeof vi.fn>;
+}) {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  act(() => {
+    root.render(
+      <AnimationCard
+        animation={animation}
+        defaultExpanded
+        flat={flat}
+        onUpdateProperty={noop}
+        onUpdateMeta={onUpdateMeta}
+        onDeleteAnimation={noop}
+        onAddProperty={noop}
+        onRemoveProperty={noop}
+        onUpdateKeyframeEase={onUpdateKeyframeEase}
+      />,
+    );
+  });
+  return { host, root };
+}
+
+describe("AnimationCard ease editing", () => {
+  it("commits one preset change to the selected keyframe segment", () => {
+    const onUpdateKeyframeEase = vi.fn();
+    const animation = baseAnimation({
+      keyframes: {
+        format: "percentage",
+        keyframes: [
+          { percentage: 0, properties: { opacity: 0 } },
+          { percentage: 50, properties: { opacity: 0.5 } },
+          { percentage: 100, properties: { opacity: 1 } },
+        ],
+      },
+    });
+    const view = renderExpandedCard({ animation, onUpdateKeyframeEase });
+
+    const segment = Array.from(view.host.querySelectorAll("button")).find((button) =>
+      button.textContent?.includes("0% → 50%"),
+    );
+    expect(segment).toBeDefined();
+    act(() => segment?.click());
+    const ease = selectPreset(view.host, "quad-out");
+
+    expect(onUpdateKeyframeEase).toHaveBeenCalledExactlyOnceWith(animation.id, 50, ease);
+    expect(trackStudioSegmentEaseEdit).toHaveBeenCalledExactlyOnceWith({
+      ease,
+    });
+    act(() => view.root.unmount());
+  });
+
+  it("commits one preset change through flat tween metadata", () => {
+    const onUpdateMeta = vi.fn();
+    const onUpdateKeyframeEase = vi.fn();
+    const animation = baseAnimation({ id: "flat-tween" });
+    const view = renderExpandedCard({
+      animation,
+      flat: true,
+      onUpdateMeta,
+      onUpdateKeyframeEase,
+    });
+
+    const ease = selectPreset(view.host, "quad-out");
+
+    expect(onUpdateMeta).toHaveBeenCalledExactlyOnceWith(animation.id, { ease });
+    expect(onUpdateKeyframeEase).not.toHaveBeenCalled();
+    expect(trackStudioSegmentEaseEdit).not.toHaveBeenCalled();
+    act(() => view.root.unmount());
+  });
+});
+
 describe("AnimationCard flat branch", () => {
   it("renders a mint border-left and panel-token colors when flat", () => {
     const host = document.createElement("div");
diff --git a/packages/studio/src/components/editor/AnimationCard.tsx b/packages/studio/src/components/editor/AnimationCard.tsx
index 97f8efa404..d178032d68 100644
--- a/packages/studio/src/components/editor/AnimationCard.tsx
+++ b/packages/studio/src/components/editor/AnimationCard.tsx
@@ -1,6 +1,7 @@
 import { memo, useCallback, useMemo, useState } from "react";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { SUPPORTED_EASES, SUPPORTED_PROPS } from "@hyperframes/core/gsap-constants";
+import { trackStudioSegmentEaseEdit } from "../../telemetry/events";
 import { RESPONSIVE_GRID } from "./propertyPanelHelpers";
 import { MetricField, SelectField } from "./propertyPanelPrimitives";
 import { controlPointsForGsapEase } from "./studioMotion";
@@ -264,7 +265,10 @@ export const AnimationCard = memo(function AnimationCard({
                     globalEase={animation.keyframes.easeEach ?? animation.ease ?? "none"}
                     expandedPct={expandedKfPct}
                     onToggle={setExpandedKfPct}
-                    onEaseCommit={(pct, ease) => onUpdateKeyframeEase(animation.id, pct, ease)}
+                    onEaseCommit={(pct, ease) => {
+                      onUpdateKeyframeEase(animation.id, pct, ease);
+                      trackStudioSegmentEaseEdit({ ease });
+                    }}
                     onApplyAll={
                       onSetAllKeyframeEases
                         ? (ease) => onSetAllKeyframeEases(animation.id, ease)
@@ -292,7 +296,6 @@ export const AnimationCard = memo(function AnimationCard({
                     />
                     <EaseCurveSection
                       ease={easeName}
-                      duration={animation.duration}
                       onCustomEaseCommit={(customEase) => {
                         const easeKey = animation.keyframes ? "easeEach" : "ease";
                         onUpdateMeta(animation.id, { [easeKey]: customEase });
diff --git a/packages/studio/src/components/editor/EaseCurveSection.test.tsx b/packages/studio/src/components/editor/EaseCurveSection.test.tsx
new file mode 100644
index 0000000000..f25aac0c31
--- /dev/null
+++ b/packages/studio/src/components/editor/EaseCurveSection.test.tsx
@@ -0,0 +1,348 @@
+// @vitest-environment happy-dom
+
+import React, { act, useState } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { EaseCurveSection, MiniCurveSvg } from "./EaseCurveSection";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+afterEach(() => {
+  document.body.innerHTML = "";
+});
+
+function renderSection(ease = "none", onCustomEaseCommit = vi.fn()) {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  act(() => {
+    root.render(<EaseCurveSection ease={ease} onCustomEaseCommit={onCustomEaseCommit} />);
+  });
+  return { host, root, onCustomEaseCommit };
+}
+
+// The preset grid now lives behind the Figma-style ease-type dropdown; open it
+// before querying preset tiles.
+function openPresetGrid(host: HTMLElement): void {
+  const dropdown = host.querySelector<HTMLButtonElement>("[data-ease-type-dropdown]");
+  act(() => dropdown!.click());
+}
+
+function presetPath(host: HTMLElement, id: string): string | null | undefined {
+  return host
+    .querySelector<HTMLButtonElement>(`[data-ease-preset-id="${id}"]`)
+    ?.querySelector("path")
+    ?.getAttribute("d");
+}
+
+function countPathExtrema(path: string): number {
+  const values = Array.from(path.matchAll(/[ML][^,]+,([^ ]+)/g), (match) => Number(match[1]));
+  const directions = values
+    .slice(1)
+    .map((value, index) => Math.sign(value - values[index]!))
+    .filter((direction) => direction !== 0);
+  return directions.filter((direction, index) => index > 0 && direction !== directions[index - 1])
+    .length;
+}
+
+function renderStatefulSection(initialEase = "none", onCustomEaseCommit = vi.fn()) {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  const Harness = () => {
+    const [ease, setEase] = useState(initialEase);
+    return (
+      <EaseCurveSection
+        ease={ease}
+        onCustomEaseCommit={(nextEase) => {
+          onCustomEaseCommit(nextEase);
+          setEase(nextEase);
+        }}
+      />
+    );
+  };
+  act(() => root.render(<Harness />));
+  return { host, root, onCustomEaseCommit };
+}
+
+function clickMode(host: HTMLElement, mode: "curve" | "spring" | "wiggle"): void {
+  const toggle = host.querySelector<HTMLButtonElement>(`[data-ease-mode="${mode}"]`);
+  expect(toggle).not.toBeNull();
+  act(() => toggle!.click());
+}
+
+function presetIds(host: HTMLElement): string[] {
+  return Array.from(host.querySelectorAll<HTMLElement>("[data-ease-preset-id]"), (preset) =>
+    preset.getAttribute("data-ease-preset-id"),
+  ).filter((id): id is string => id !== null);
+}
+
+function editorLabel(host: HTMLElement): string | null {
+  return host.querySelector("[data-ease-type-dropdown] span")?.textContent ?? null;
+}
+
+describe("EaseCurveSection preset grid", () => {
+  it.each([
+    ["curve", "none", "linear", ["flow-7", "spring-bouncy"]],
+    ["spring", "spring(0.42)", "spring-bouncy", ["linear", "flow-7"]],
+    ["wiggle", "wiggle(3,easeInOut,0.12)", "flow-7", ["linear", "spring-bouncy"]],
+  ] as const)("shows only %s presets", (_mode, ease, includedPreset, excludedPresets) => {
+    const { host, root } = renderSection(ease);
+    openPresetGrid(host);
+    const ids = presetIds(host);
+
+    expect(ids).toContain(includedPreset);
+    for (const id of excludedPresets) expect(ids).not.toContain(id);
+
+    act(() => root.unmount());
+  });
+
+  it("renders a wiggle graph and fields without curve handles or fallback copy", () => {
+    const { host, root } = renderSection("wiggle(3,easeInOut,0.12)");
+    const graph = host.querySelector<SVGElement>('svg[viewBox="0 0 216 288"]');
+
+    expect(graph?.querySelector("path")).not.toBeNull();
+    expect(graph?.querySelectorAll(".cursor-grab")).toHaveLength(0);
+    expect(host.querySelector('[aria-label="Wiggle count"]')).not.toBeNull();
+    expect(host.querySelector('[aria-label="Wiggle type"]')).not.toBeNull();
+    expect(host.querySelector('[aria-label="Wiggle amplitude"]')).not.toBeNull();
+    expect(host.textContent).not.toContain("switch to");
+
+    act(() => root.unmount());
+  });
+
+  it.each([
+    ["spring(0.6)", "Bouncy"],
+    ["spring(0.37)", "Custom spring"],
+    ["wiggle(2,uniform,0.3)", "Custom wiggle"],
+    ["custom(M0,0 C0.1,0.2 0.8,0.9 1,1)", "Custom bezier"],
+  ])("labels %s as %s", (ease, expectedLabel) => {
+    const { host, root } = renderSection(ease);
+
+    expect(editorLabel(host)).toBe(expectedLabel);
+
+    act(() => root.unmount());
+  });
+
+  it("commits the selected preset through the existing custom-ease callback", () => {
+    const { host, root, onCustomEaseCommit } = renderSection("wiggle(3,easeInOut,0.12)");
+    openPresetGrid(host);
+    const tile = host.querySelector<HTMLButtonElement>('[data-ease-preset-id="flow-7"]');
+    expect(tile).not.toBeNull();
+
+    act(() => tile!.click());
+
+    expect(onCustomEaseCommit).toHaveBeenCalledTimes(1);
+    expect(onCustomEaseCommit).toHaveBeenCalledWith("wiggle(7,easeInOut,0.06)");
+    act(() => root.unmount());
+  });
+
+  it("commits Hold as a segment ease", () => {
+    const { host, root, onCustomEaseCommit } = renderSection();
+    openPresetGrid(host);
+    const tile = host.querySelector<HTMLButtonElement>('[data-ease-preset-id="hold"]');
+    expect(tile).not.toBeNull();
+
+    act(() => tile!.click());
+
+    expect(onCustomEaseCommit).toHaveBeenCalledWith("hold");
+    act(() => root.unmount());
+  });
+
+  it("draws Hold as a flat step with an end jump", () => {
+    const { host, root } = renderSection();
+    openPresetGrid(host);
+    const path = presetPath(host, "hold");
+
+    expect(path).toBe("M3,21 L21,21 L21,3");
+
+    act(() => root.unmount());
+  });
+
+  it("draws Hold as the same flat step in the big editor graph", () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() => {
+      root.render(<EaseCurveSection ease="hold" onCustomEaseCommit={vi.fn()} />);
+    });
+
+    const path = host
+      .querySelector<SVGElement>('svg[viewBox="0 0 216 288"]')
+      ?.querySelector("path")
+      ?.getAttribute("d");
+    expect(path).toBe("M16,236 L200,236 L200,52");
+    expect(host.querySelectorAll('[role="slider"]')).toHaveLength(0);
+
+    act(() => root.unmount());
+  });
+
+  it("preserves negative custom-ease control points in both curve graphs", () => {
+    const ease = "custom(M0,0 C0.3,-0.5 0.7,1.5 1,1)";
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() => {
+      root.render(
+        <>
+          <MiniCurveSvg ease={ease} active={false} />
+          <EaseCurveSection ease={ease} onCustomEaseCommit={vi.fn()} />
+        </>,
+      );
+    });
+
+    const miniPath = host
+      .querySelector<SVGElement>('svg[viewBox="0 0 24 24"]')
+      ?.querySelector("path")
+      ?.getAttribute("d");
+    const editorPath = host
+      .querySelector<SVGElement>('svg[viewBox="0 0 216 288"]')
+      ?.querySelector("path")
+      ?.getAttribute("d");
+    expect(miniPath).toBe("M3,21 C8.399999999999999,30 15.6,-6 21,3");
+    expect(editorPath).toBe("M16,236 C71.19999999999999,328 144.79999999999998,-40 200,52");
+
+    act(() => root.unmount());
+  });
+
+  it("draws wiggle presets as sampled oscillating glyphs", () => {
+    const { host, root } = renderSection("wiggle(3,easeInOut,0.12)");
+    openPresetGrid(host);
+    const flow = presetPath(host, "flow-7");
+    const bounce = presetPath(host, "bounce-3");
+
+    expect(flow).toMatch(/^M.* L/);
+    expect(bounce).toMatch(/^M.* L/);
+    expect(flow).not.toBe(bounce);
+    expect(countPathExtrema(flow!)).toBeGreaterThan(8);
+    expect(countPathExtrema(bounce!)).toBeGreaterThan(8);
+
+    act(() => root.unmount());
+  });
+
+  it("draws Flow with increasing-frequency sampled glyphs", () => {
+    const { host, root } = renderSection("wiggle(3,easeInOut,0.12)");
+    openPresetGrid(host);
+    const flow1 = presetPath(host, "flow-1");
+    const flow7 = presetPath(host, "flow-7");
+
+    expect(flow1).toMatch(/^M.* L/);
+    expect(flow7).toMatch(/^M.* L/);
+    expect(flow1).not.toBe(flow7);
+
+    act(() => root.unmount());
+  });
+
+  it("draws explicit wiggle amplitudes in sampled glyphs", () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() =>
+      root.render(
+        <>
+          <MiniCurveSvg ease="wiggle(3,easeInOut,0.1)" active={false} />
+          <MiniCurveSvg ease="wiggle(3,easeInOut,0.2)" active={false} />
+        </>,
+      ),
+    );
+    const paths = Array.from(host.querySelectorAll("path"), (path) => path.getAttribute("d"));
+
+    expect(paths[0]).not.toBe(paths[1]);
+
+    act(() => root.unmount());
+  });
+
+  it("commits each mode default when switching modes", () => {
+    const { host, root, onCustomEaseCommit } = renderStatefulSection();
+
+    clickMode(host, "spring");
+    expect(onCustomEaseCommit).toHaveBeenLastCalledWith("spring(0.42)");
+
+    clickMode(host, "curve");
+    expect(onCustomEaseCommit).toHaveBeenLastCalledWith("custom(M0,0 C0.16,1 0.3,1 1,1)");
+
+    clickMode(host, "wiggle");
+    expect(onCustomEaseCommit).toHaveBeenLastCalledWith("wiggle(3,easeInOut,0.12)");
+
+    act(() => root.unmount());
+  });
+
+  it("keeps spring bounce editing wired to the custom-ease callback", () => {
+    const { host, root, onCustomEaseCommit } = renderStatefulSection("spring(0.37)");
+    const bounceInput = host.querySelector<HTMLInputElement>('[aria-label="Spring bounce"]');
+    expect(bounceInput).not.toBeNull();
+
+    act(() => {
+      bounceInput!.focus();
+      const valueSetter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value")?.set;
+      valueSetter?.call(bounceInput, "0.7");
+      bounceInput!.dispatchEvent(new Event("input", { bubbles: true }));
+    });
+    expect(onCustomEaseCommit).not.toHaveBeenCalled();
+    act(() => bounceInput!.blur());
+    expect(onCustomEaseCommit).toHaveBeenLastCalledWith("spring(0.7)");
+
+    act(() => root.unmount());
+  });
+
+  it("keeps curve handles draggable and commits the edited custom curve", () => {
+    const { host, root, onCustomEaseCommit } = renderSection("power2.out");
+    const graph = host.querySelector<SVGSVGElement>('svg[viewBox="0 0 216 288"]');
+    const handle = graph?.querySelector<SVGCircleElement>(".cursor-grab");
+    expect(graph).not.toBeNull();
+    expect(handle).not.toBeNull();
+    vi.spyOn(graph!, "getBoundingClientRect").mockReturnValue(new DOMRect(0, 0, 216, 288));
+    handle!.setPointerCapture = vi.fn();
+
+    act(() => {
+      handle!.dispatchEvent(
+        new PointerEvent("pointerdown", { bubbles: true, pointerId: 1, clientX: 46, clientY: 52 }),
+      );
+    });
+    act(() => {
+      graph!.dispatchEvent(
+        new PointerEvent("pointermove", {
+          bubbles: true,
+          pointerId: 1,
+          clientX: 108,
+          clientY: 144,
+        }),
+      );
+    });
+    act(() => {
+      graph!.dispatchEvent(new PointerEvent("pointerup", { bubbles: true, pointerId: 1 }));
+    });
+
+    expect(onCustomEaseCommit).toHaveBeenLastCalledWith("custom(M0,0 C0.5,0.5 0.3,1 1,1)");
+
+    act(() => root.unmount());
+  });
+
+  it("nudges curve handles with the keyboard", () => {
+    const { host, root, onCustomEaseCommit } = renderSection("power2.out");
+    const firstHandle = host.querySelector<SVGCircleElement>('[role="slider"]');
+    expect(firstHandle).not.toBeNull();
+
+    act(() => {
+      firstHandle!.dispatchEvent(
+        new KeyboardEvent("keydown", { key: "ArrowRight", bubbles: true }),
+      );
+    });
+
+    expect(onCustomEaseCommit).toHaveBeenLastCalledWith("custom(M0,0 C0.17,1 0.3,1 1,1)");
+    act(() => root.unmount());
+  });
+
+  it("closes the preset menu with Escape and returns focus to its trigger", () => {
+    const { host, root } = renderSection();
+    const trigger = host.querySelector<HTMLButtonElement>("[data-ease-type-dropdown]")!;
+    openPresetGrid(host);
+
+    expect(trigger.getAttribute("aria-expanded")).toBe("true");
+    act(() => document.dispatchEvent(new KeyboardEvent("keydown", { key: "Escape" })));
+
+    expect(trigger.getAttribute("aria-expanded")).toBe("false");
+    expect(document.activeElement).toBe(trigger);
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/components/editor/EaseCurveSection.tsx b/packages/studio/src/components/editor/EaseCurveSection.tsx
index 262ff6a9f9..015ec6b5a1 100644
--- a/packages/studio/src/components/editor/EaseCurveSection.tsx
+++ b/packages/studio/src/components/editor/EaseCurveSection.tsx
@@ -1,75 +1,55 @@
-import { useCallback, useRef, useState } from "react";
-import { EASE_CURVES, EASE_LABELS, parseCustomEaseFromString } from "./gsapAnimationConstants";
+import { useEffect, useId, useRef, useState } from "react";
+import { evaluateSpringEase, parseSpringBounce } from "@hyperframes/core/spring-ease";
+import {
+  evaluateWiggleEase,
+  parseWiggleEase,
+  type WiggleEaseConfig,
+} from "@hyperframes/core/wiggle-ease";
+import { EASE_PRESETS, easePresetLabel } from "./easePresetLibrary";
+import { holdCurvePath, MiniCurveSvg, sampledPath } from "./easeCurveSvg";
+import { EaseBezierField, SpringBounceField, WiggleField } from "./EaseParamFields";
+import { EASE_CURVES, EASE_LABELS, resolveEaseCurveTuple } from "./gsapAnimationConstants";
 import { roundToCenti } from "../../utils/rounding";
 
-// Figma-canonical ordering: linear, the three core eases, then the expressive
-// (back / snappy) family. Each maps to a GSAP ease so it round-trips cleanly.
-const PRESET_GRID_EASES = [
-  "none",
-  "power2.in",
-  "power2.out",
-  "power2.inOut",
-  "back.in",
-  "back.out",
-  "back.inOut",
-  "expo.out",
-] as const;
+export { MiniCurveSvg } from "./easeCurveSvg";
 
-function MiniCurveSvg({
-  curve,
-  active,
-}: {
-  curve: [number, number, number, number];
-  active: boolean;
-}) {
-  const [x1, y1, x2, y2] = curve;
-  const s = 24;
-  const p = 3;
-  const g = s - p * 2;
-  const sx = (px: number) => p + g * px;
-  const sy = (py: number) => s - p - g * py;
-  const d = `M${p},${s - p} C${sx(x1)},${sy(y1)} ${sx(x2)},${sy(y2)} ${s - p},${p}`;
-  return (
-    <svg width={s} height={s} viewBox={`0 0 ${s} ${s}`}>
-      <path
-        d={d}
-        fill="none"
-        stroke={active ? "#3CE6AC" : "#737373"}
-        strokeWidth="1.5"
-        strokeLinecap="round"
-      />
-    </svg>
-  );
-}
+const EASE_MODES = ["curve", "spring", "wiggle"] as const;
+type EaseMode = (typeof EASE_MODES)[number];
 
 const EasePresetGrid = function EasePresetGrid({
+  kind,
   currentEase,
   onSelect,
 }: {
+  kind: EaseMode;
   currentEase: string;
   onSelect: (ease: string) => void;
 }) {
   return (
-    <div className="grid grid-cols-4 gap-1 mb-2">
-      {PRESET_GRID_EASES.map((name) => {
-        const curve = EASE_CURVES[name];
-        if (!curve) return null;
-        const isActive = currentEase === name;
+    <div className="mb-2 grid max-h-56 grid-cols-4 gap-1 overflow-y-auto pr-0.5">
+      {EASE_PRESETS.filter((preset) => preset.kind === kind).map((preset) => {
+        const isActive = currentEase === preset.ease;
         return (
           <button
-            key={name}
+            key={preset.id}
             type="button"
-            onClick={() => onSelect(name)}
+            data-ease-preset-id={preset.id}
+            role="menuitemradio"
+            aria-checked={isActive}
+            tabIndex={isActive ? 0 : -1}
+            onClick={() => onSelect(preset.ease)}
             className={`flex flex-col items-center gap-0.5 rounded-md p-1 transition-colors ${
               isActive ? "bg-panel-accent/10 ring-1 ring-panel-accent/30" : "hover:bg-neutral-800"
             }`}
-            title={EASE_LABELS[name] ?? name}
+            title={preset.label}
           >
-            <MiniCurveSvg curve={curve} active={isActive} />
+            <MiniCurveSvg ease={preset.ease} active={isActive} />
             <span
-              className={`text-[8px] leading-none ${isActive ? "text-panel-accent" : "text-neutral-500"}`}
+              className={`text-center text-[8px] leading-none ${
+                isActive ? "text-panel-accent" : "text-neutral-500"
+              }`}
             >
-              {(EASE_LABELS[name] ?? name).split(" ").slice(0, 2).join(" ")}
+              {preset.label}
             </span>
           </button>
         );
@@ -101,56 +81,276 @@ const DRAG_VMIN = -1;
 const ACCENT = "#3CE6AC";
 
 type Pts = [number, number, number, number];
+const DEFAULT_CURVE: Pts = EASE_CURVES["power2.out"];
+const MODE_LABELS = { curve: "Curve", spring: "Spring", wiggle: "Wiggle" } satisfies Record<
+  EaseMode,
+  string
+>;
+const DEFAULT_EASE_BY_MODE = {
+  curve: `custom(M0,0 C${DEFAULT_CURVE[0]},${DEFAULT_CURVE[1]} ${DEFAULT_CURVE[2]},${DEFAULT_CURVE[3]} 1,1)`,
+  spring: "spring(0.42)",
+  wiggle: "wiggle(3,easeInOut,0.12)",
+} satisfies Record<EaseMode, string>;
+
+function EaseModeToggle({ mode, onCommit }: { mode: EaseMode; onCommit: (ease: string) => void }) {
+  return (
+    <div
+      className="mb-2 grid grid-cols-3 rounded-md bg-black/20 p-0.5"
+      role="radiogroup"
+      aria-label="Ease editor mode"
+    >
+      {EASE_MODES.map((candidateMode) => {
+        const active = candidateMode === mode;
+        return (
+          <button
+            key={candidateMode}
+            type="button"
+            data-ease-mode={candidateMode}
+            role="radio"
+            aria-checked={active}
+            onClick={() => {
+              if (active) return;
+              onCommit(DEFAULT_EASE_BY_MODE[candidateMode]);
+            }}
+            className={`rounded px-2 py-1 text-[10px] font-medium transition-colors ${
+              active ? "bg-neutral-700 text-neutral-100" : "text-neutral-500 hover:text-neutral-300"
+            }`}
+          >
+            {MODE_LABELS[candidateMode]}
+          </button>
+        );
+      })}
+    </div>
+  );
+}
+
+// Figma-style ease-type dropdown: the current ease (glyph + name) as a button
+// that opens the preset grid in a popover. This is where a preset is selected —
+// the grid is no longer shown inline.
+function EaseTypeDropdown({
+  kind,
+  ease,
+  label,
+  onSelect,
+}: {
+  kind: EaseMode;
+  ease: string;
+  label: string;
+  onSelect: (ease: string) => void;
+}) {
+  const [open, setOpen] = useState(false);
+  const triggerRef = useRef<HTMLButtonElement>(null);
+  const menuRef = useRef<HTMLDivElement>(null);
+  const menuId = useId();
+
+  useEffect(() => {
+    if (!open) return;
+    const menu = menuRef.current;
+    const selected =
+      menu?.querySelector<HTMLButtonElement>('[role="menuitemradio"][aria-checked="true"]') ??
+      menu?.querySelector<HTMLButtonElement>('[role="menuitemradio"]');
+    selected?.focus();
+
+    const closeOutside = (event: PointerEvent) => {
+      const target = event.target;
+      if (!(target instanceof Node)) return;
+      if (!menuRef.current?.contains(target) && !triggerRef.current?.contains(target)) {
+        setOpen(false);
+      }
+    };
+    const closeOnEscape = (event: KeyboardEvent) => {
+      if (event.key !== "Escape") return;
+      event.preventDefault();
+      setOpen(false);
+      triggerRef.current?.focus();
+    };
+    document.addEventListener("pointerdown", closeOutside);
+    document.addEventListener("keydown", closeOnEscape);
+    return () => {
+      document.removeEventListener("pointerdown", closeOutside);
+      document.removeEventListener("keydown", closeOnEscape);
+    };
+  }, [open]);
+
+  const handleMenuKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => {
+    if (event.key === "Tab") {
+      setOpen(false);
+      return;
+    }
+    const offsets: Record<string, number> = {
+      ArrowLeft: -1,
+      ArrowRight: 1,
+      ArrowUp: -4,
+      ArrowDown: 4,
+    };
+    const offset = offsets[event.key];
+    if (offset === undefined && event.key !== "Home" && event.key !== "End") return;
+    event.preventDefault();
+    const items = Array.from(
+      event.currentTarget.querySelectorAll<HTMLButtonElement>('[role="menuitemradio"]'),
+    );
+    if (items.length === 0) return;
+    const current = Math.max(0, items.indexOf(document.activeElement as HTMLButtonElement));
+    const next =
+      event.key === "Home"
+        ? 0
+        : event.key === "End"
+          ? items.length - 1
+          : (current + (offset ?? 0) + items.length) % items.length;
+    items[next]?.focus();
+  };
+
+  return (
+    <div className="relative mb-2">
+      <button
+        ref={triggerRef}
+        type="button"
+        data-ease-type-dropdown=""
+        aria-haspopup="menu"
+        aria-expanded={open}
+        aria-controls={open ? menuId : undefined}
+        onClick={() => setOpen((prev) => !prev)}
+        className="flex w-full items-center gap-2 rounded-md border border-white/10 bg-black/20 px-2 py-1.5 text-left transition-colors hover:border-white/20"
+      >
+        <MiniCurveSvg ease={ease} active size={16} />
+        <span className="text-[11px] text-neutral-200">{label}</span>
+        <svg
+          width="8"
+          height="8"
+          viewBox="0 0 10 10"
+          fill="currentColor"
+          className={`ml-auto text-neutral-500 transition-transform ${open ? "rotate-180" : ""}`}
+        >
+          <path d="M2 3l3 4 3-4z" />
+        </svg>
+      </button>
+      {open && (
+        <div
+          ref={menuRef}
+          id={menuId}
+          role="menu"
+          aria-label={`${MODE_LABELS[kind]} ease presets`}
+          onKeyDown={handleMenuKeyDown}
+          className="absolute inset-x-0 top-full z-20 mt-1 rounded-md border border-white/10 bg-neutral-900 p-2 shadow-xl"
+        >
+          <EasePresetGrid
+            kind={kind}
+            currentEase={ease}
+            onSelect={(next) => {
+              onSelect(next);
+              setOpen(false);
+              triggerRef.current?.focus();
+            }}
+          />
+        </div>
+      )}
+    </div>
+  );
+}
+
+function resolveEditableCurve(ease: string, springBounce: number | null): Pts | null {
+  if (springBounce !== null) return DEFAULT_CURVE;
+  if (ease === "hold") return null;
+  if (ease.startsWith("custom(") || ease in EASE_CURVES) return resolveEaseCurveTuple(ease);
+  return null;
+}
+
+function resolveEditorLabel(ease: string, springBounce: number | null, isWiggle: boolean): string {
+  const presetLabel = easePresetLabel(ease);
+  if (presetLabel !== null) return presetLabel;
+  if (springBounce !== null) return "Custom spring";
+  if (isWiggle) return "Custom wiggle";
+  if (ease.startsWith("custom(")) return "Custom bezier";
+  return EASE_LABELS[ease] ?? ease;
+}
 
 const xToSvg = (px: number) => PADH + S * px;
 const yToSvg = (py: number) => HR + S * (1 - py);
 const clampView = (py: number) => Math.max(VMIN, Math.min(VMAX, py));
+const clampDragY = (py: number) => Math.max(DRAG_VMIN, Math.min(DRAG_VMAX, py));
+
+function nudgeCurve(tuple: Pts, handle: "p1" | "p2", key: string, step: number): Pts | null {
+  const deltaX = key === "ArrowLeft" ? -step : key === "ArrowRight" ? step : 0;
+  const deltaY = key === "ArrowDown" ? -step : key === "ArrowUp" ? step : 0;
+  if (deltaX === 0 && deltaY === 0) return null;
+  const next: Pts = [...tuple];
+  const xIndex = handle === "p1" ? 0 : 2;
+  const yIndex = handle === "p1" ? 1 : 3;
+  next[xIndex] = round2(Math.max(0, Math.min(1, next[xIndex] + deltaX)));
+  next[yIndex] = round2(clampDragY(next[yIndex] + deltaY));
+  return next;
+}
 
-function cubicAt(t: number, c0: number, c1: number, c2: number, c3: number): number {
-  const mt = 1 - t;
-  return mt * mt * mt * c0 + 3 * mt * mt * t * c1 + 3 * mt * t * t * c2 + t * t * t * c3;
+function curvePathFor(
+  ease: string,
+  springBounce: number | null,
+  wiggleConfig: WiggleEaseConfig | null,
+  tuple: Pts,
+): string {
+  if (ease === "hold") return holdCurvePath(xToSvg(0), yToSvg(0), xToSvg(1), yToSvg(1));
+  if (wiggleConfig !== null) {
+    return sampledPath(64, xToSvg, yToSvg, (progress) =>
+      evaluateWiggleEase(progress, wiggleConfig.wiggles, wiggleConfig.type, wiggleConfig.amplitude),
+    );
+  }
+  if (springBounce !== null) {
+    return sampledPath(64, xToSvg, yToSvg, (progress) =>
+      evaluateSpringEase(progress, springBounce),
+    );
+  }
+  const [x1, y1, x2, y2] = tuple;
+  return `M${xToSvg(0)},${yToSvg(0)} C${xToSvg(x1)},${yToSvg(y1)} ${xToSvg(x2)},${yToSvg(y2)} ${xToSvg(1)},${yToSvg(1)}`;
+}
+
+function EaseParameterField({
+  springBounce,
+  wiggleConfig,
+  tuple,
+  onCommit,
+}: {
+  springBounce: number | null;
+  wiggleConfig: WiggleEaseConfig | null;
+  tuple: Pts;
+  onCommit: (ease: string) => void;
+}) {
+  if (springBounce !== null) {
+    return <SpringBounceField springBounce={springBounce} onCommit={onCommit} />;
+  }
+  if (wiggleConfig !== null) return <WiggleField config={wiggleConfig} onCommit={onCommit} />;
+  return <EaseBezierField tuple={tuple} onCommit={onCommit} />;
 }
 
 export function EaseCurveSection({
   ease,
-  duration,
   onCustomEaseCommit,
 }: {
   ease: string;
-  duration?: number;
   onCustomEaseCommit: (ease: string) => void;
 }) {
-  const isCustom = ease.startsWith("custom(");
-  const curveFromPreset = EASE_CURVES[ease];
-  const customPoints = isCustom ? parseCustomEaseFromString(ease) : null;
-  const curve: Pts | null =
-    isCustom && customPoints
-      ? [customPoints.x1, customPoints.y1, customPoints.x2, customPoints.y2]
-      : (curveFromPreset ?? null);
+  const springBounce = parseSpringBounce(ease);
+  const isSpring = springBounce !== null;
+  const wiggleConfig = parseWiggleEase(ease);
+  const isWiggle = wiggleConfig !== null;
+  const mode: EaseMode = isSpring ? "spring" : isWiggle ? "wiggle" : "curve";
+  const curve = resolveEditableCurve(ease, springBounce);
 
   const [draft, setDraft] = useState<Pts | null>(null);
-  const [progress, setProgress] = useState<number | null>(null);
   const [hover, setHover] = useState<"p1" | "p2" | null>(null);
   const draggingRef = useRef<"p1" | "p2" | null>(null);
   const svgRef = useRef<SVGSVGElement | null>(null);
-  const rafRef = useRef<number>(0);
 
-  const play = useCallback(() => {
-    const start = performance.now();
-    const dur = 1100;
-    const tick = (now: number) => {
-      const t = Math.min((now - start) / dur, 1);
-      setProgress(t);
-      if (t < 1) rafRef.current = requestAnimationFrame(tick);
-      else setTimeout(() => setProgress(null), 450);
-    };
-    cancelAnimationFrame(rafRef.current);
-    rafRef.current = requestAnimationFrame(tick);
-  }, []);
+  // Keep the local draft displayed until the committed `ease` prop round-trips
+  // back (write → reparse → re-render), then drop it. Clearing on pointer-up
+  // instead would fall back to the STALE prop for a frame — the curve snaps to
+  // the old value and jumps to the new one (the commit flicker). By the time
+  // `ease` changes, `curve` already equals the draft, so the handoff is seamless.
+  useEffect(() => {
+    setDraft(null);
+  }, [ease]);
 
-  const active = draft ?? curve;
-  if (!active) return null;
-  const [x1, y1, x2, y2] = active;
+  const activeTuple = draft ?? curve;
+  const displayTuple = activeTuple ?? DEFAULT_CURVE;
+  const [x1, y1, x2, y2] = displayTuple;
 
   // Anchors + control handles. Handle *display* is clamped to the view so an
   // extreme loaded overshoot rides the edge instead of disappearing.
@@ -158,18 +358,9 @@ export function EaseCurveSection({
   const a1 = { x: xToSvg(1), y: yToSvg(1) };
   const p1 = { x: xToSvg(x1), y: yToSvg(clampView(y1)) };
   const p2 = { x: xToSvg(x2), y: yToSvg(clampView(y2)) };
-  // Curve drawn from the true control points (so its shape is exact).
-  const cp1 = { x: xToSvg(x1), y: yToSvg(y1) };
-  const cp2 = { x: xToSvg(x2), y: yToSvg(y2) };
-  const curvePath = `M${a0.x},${a0.y} C${cp1.x},${cp1.y} ${cp2.x},${cp2.y} ${a1.x},${a1.y}`;
-
-  let dot: { x: number; y: number } | null = null;
-  if (progress !== null) {
-    dot = {
-      x: xToSvg(cubicAt(progress, 0, x1, x2, 1)),
-      y: yToSvg(cubicAt(progress, 0, y1, y2, 1)),
-    };
-  }
+  const curvePath = curvePathFor(ease, springBounce, wiggleConfig, displayTuple);
+  const showGraph = activeTuple !== null || isWiggle || ease === "hold";
+  const showHandles = curve !== null && !isSpring && !isWiggle;
 
   const handlePointerDown = (handle: "p1" | "p2", e: React.PointerEvent) => {
     e.preventDefault();
@@ -190,7 +381,7 @@ export function EaseCurveSection({
     const px = Math.max(0, Math.min(1, (sx - PADH) / S));
     // py uses the WIDER drag bound (not clampView), so dragging keeps overshoot
     // fidelity instead of pinning the committed value to the visible view edge.
-    const py = Math.max(DRAG_VMIN, Math.min(DRAG_VMAX, 1 - (sy - HR) / S));
+    const py = clampDragY(1 - (sy - HR) / S);
     const prev = draft ?? [x1, y1, x2, y2];
     const next: Pts =
       draggingRef.current === "p1"
@@ -203,164 +394,180 @@ export function EaseCurveSection({
     if (!draggingRef.current || !draft) return;
     draggingRef.current = null;
     const path = `M0,0 C${draft[0]},${draft[1]} ${draft[2]},${draft[3]} 1,1`;
+    // Clear after the synchronous parent commit settles. This also clears a
+    // same-string commit, where the `ease` dependency effect would not run.
     onCustomEaseCommit(`custom(${path})`);
-    setDraft(null);
+    queueMicrotask(() => setDraft(null));
+  };
+
+  const handleKeyDown = (handle: "p1" | "p2", event: React.KeyboardEvent<SVGCircleElement>) => {
+    const next = nudgeCurve(displayTuple, handle, event.key, event.shiftKey ? 0.1 : 0.01);
+    if (!next) return;
+    event.preventDefault();
+    event.stopPropagation();
+    setDraft(next);
+    onCustomEaseCommit(`custom(M0,0 C${next[0]},${next[1]} ${next[2]},${next[3]} 1,1)`);
+    queueMicrotask(() => setDraft(null));
   };
 
   const top = yToSvg(1);
   const bottom = yToSvg(0);
   const left = xToSvg(0);
   const right = xToSvg(1);
-  const label = isCustom ? "Custom curve" : (EASE_LABELS[ease] ?? ease);
-  const bezierText = `${x1} · ${y1} · ${x2} · ${y2}`;
+  const label = resolveEditorLabel(ease, springBounce, isWiggle);
 
   return (
     <div className="rounded-lg bg-neutral-900/50 p-2">
-      <EasePresetGrid currentEase={ease} onSelect={(name) => onCustomEaseCommit(name)} />
-      <div className="mb-1.5 flex items-center justify-between">
-        <span className="text-[10px] font-medium text-neutral-500">Speed curve</span>
-        <button
-          type="button"
-          onClick={play}
-          className="rounded px-1.5 py-0.5 text-[10px] font-medium text-panel-accent transition-colors hover:bg-panel-accent/10"
-        >
-          {progress !== null ? "Playing…" : "Preview"}
-        </button>
-      </div>
-      <div
-        className="mx-auto overflow-hidden rounded-md border border-white/5 bg-black/20"
-        style={{ aspectRatio: `${SVGW} / ${SVGH}`, width: "100%", maxWidth: 230 }}
-      >
-        <svg
-          ref={svgRef}
-          width="100%"
-          height="100%"
-          viewBox={`0 0 ${SVGW} ${SVGH}`}
-          preserveAspectRatio="none"
-          className="touch-none select-none"
-          onPointerMove={handlePointerMove}
-          onPointerUp={handlePointerUp}
-          onPointerCancel={handlePointerUp}
-        >
-          {/* Grid — quarter lines inside the unit square */}
-          {[0.25, 0.5, 0.75].map((q) => (
-            <line
-              key={`v${q}`}
-              x1={xToSvg(q)}
-              y1={top}
-              x2={xToSvg(q)}
-              y2={bottom}
-              stroke="white"
-              strokeOpacity="0.05"
-              strokeWidth="1"
-            />
-          ))}
-          {[0.25, 0.5, 0.75].map((q) => (
-            <line
-              key={`h${q}`}
-              x1={left}
-              y1={yToSvg(q)}
-              x2={right}
-              y2={yToSvg(q)}
-              stroke="white"
-              strokeOpacity="0.05"
-              strokeWidth="1"
-            />
-          ))}
-          {/* Unit-square frame (progress 0 → 1) */}
-          <rect
-            x={left}
-            y={top}
-            width={S}
-            height={bottom - top}
-            fill="none"
-            stroke="white"
-            strokeOpacity="0.1"
-            strokeWidth="1"
-          />
-          {/* Linear reference diagonal */}
-          <line
-            x1={a0.x}
-            y1={a0.y}
-            x2={a1.x}
-            y2={a1.y}
-            stroke="white"
-            strokeOpacity="0.08"
-            strokeWidth="1"
-            strokeDasharray="3 4"
-          />
-          {/* Tangent handle lines */}
-          <line
-            x1={a0.x}
-            y1={a0.y}
-            x2={p1.x}
-            y2={p1.y}
-            stroke={ACCENT}
-            strokeOpacity="0.5"
-            strokeWidth="1.5"
-          />
-          <line
-            x1={a1.x}
-            y1={a1.y}
-            x2={p2.x}
-            y2={p2.y}
-            stroke={ACCENT}
-            strokeOpacity="0.5"
-            strokeWidth="1.5"
-          />
-          {/* The curve */}
-          <path d={curvePath} fill="none" stroke={ACCENT} strokeWidth="2.5" strokeLinecap="round" />
-          {/* Anchors at (0,0) and (1,1) */}
-          <circle cx={a0.x} cy={a0.y} r="3" fill={ACCENT} />
-          <circle cx={a1.x} cy={a1.y} r="3" fill={ACCENT} />
-          {/* Animated preview dot */}
-          {dot && (
-            <>
-              <circle cx={dot.x} cy={dot.y} r="9" fill={ACCENT} fillOpacity="0.18" />
-              <circle cx={dot.x} cy={dot.y} r="4.5" fill={ACCENT} />
-            </>
-          )}
-          {/* Draggable control handles (large transparent hit area + visible dot) */}
-          {[["p1", p1] as const, ["p2", p2] as const].map(([key, pt]) => (
-            <g key={key}>
-              <circle
-                cx={pt.x}
-                cy={pt.y}
-                r="14"
-                fill="transparent"
-                className="cursor-grab active:cursor-grabbing"
-                onPointerDown={(e) => handlePointerDown(key, e)}
-                onPointerEnter={() => setHover(key)}
-                onPointerLeave={() => setHover((h) => (h === key ? null : h))}
+      <EaseTypeDropdown kind={mode} ease={ease} label={label} onSelect={onCustomEaseCommit} />
+      <EaseModeToggle mode={mode} onCommit={onCustomEaseCommit} />
+      <span className="sr-only" aria-live="polite">
+        {MODE_LABELS[mode]} ease editor selected
+      </span>
+      {showGraph ? (
+        <>
+          <div
+            className="mx-auto overflow-hidden rounded-md border border-white/5 bg-black/20"
+            style={{ aspectRatio: `${SVGW} / ${SVGH}`, width: "100%", maxWidth: 230 }}
+          >
+            <svg
+              ref={svgRef}
+              width="100%"
+              height="100%"
+              viewBox={`0 0 ${SVGW} ${SVGH}`}
+              preserveAspectRatio="none"
+              className="touch-none select-none"
+              onPointerMove={handlePointerMove}
+              onPointerUp={handlePointerUp}
+              onPointerCancel={handlePointerUp}
+            >
+              {/* Grid — quarter lines inside the unit square */}
+              {[0.25, 0.5, 0.75].map((q) => (
+                <line
+                  key={`v${q}`}
+                  x1={xToSvg(q)}
+                  y1={top}
+                  x2={xToSvg(q)}
+                  y2={bottom}
+                  stroke="white"
+                  strokeOpacity="0.05"
+                  strokeWidth="1"
+                />
+              ))}
+              {[0.25, 0.5, 0.75].map((q) => (
+                <line
+                  key={`h${q}`}
+                  x1={left}
+                  y1={yToSvg(q)}
+                  x2={right}
+                  y2={yToSvg(q)}
+                  stroke="white"
+                  strokeOpacity="0.05"
+                  strokeWidth="1"
+                />
+              ))}
+              {/* Unit-square frame (progress 0 → 1) */}
+              <rect
+                x={left}
+                y={top}
+                width={S}
+                height={bottom - top}
+                fill="none"
+                stroke="white"
+                strokeOpacity="0.1"
+                strokeWidth="1"
+              />
+              {/* Linear reference diagonal */}
+              <line
+                x1={a0.x}
+                y1={a0.y}
+                x2={a1.x}
+                y2={a1.y}
+                stroke="white"
+                strokeOpacity="0.08"
+                strokeWidth="1"
+                strokeDasharray="3 4"
               />
-              <circle
-                cx={pt.x}
-                cy={pt.y}
-                r={hover === key || draggingRef.current === key ? 7 : 5.5}
-                fill="#0a0a1a"
+              {/* Tangent handle lines */}
+              {showHandles && (
+                <>
+                  <line
+                    x1={a0.x}
+                    y1={a0.y}
+                    x2={p1.x}
+                    y2={p1.y}
+                    stroke={ACCENT}
+                    strokeOpacity="0.5"
+                    strokeWidth="1.5"
+                  />
+                  <line
+                    x1={a1.x}
+                    y1={a1.y}
+                    x2={p2.x}
+                    y2={p2.y}
+                    stroke={ACCENT}
+                    strokeOpacity="0.5"
+                    strokeWidth="1.5"
+                  />
+                </>
+              )}
+              {/* The curve */}
+              <path
+                d={curvePath}
+                fill="none"
                 stroke={ACCENT}
                 strokeWidth="2.5"
-                className="pointer-events-none transition-[r]"
+                strokeLinecap="round"
               />
-            </g>
-          ))}
-        </svg>
-      </div>
-      {/* Axis + value readout */}
-      <div className="mt-1.5 flex items-center justify-between px-0.5 text-[9px] text-neutral-600">
-        <span>{duration != null && duration > 0 ? "0s" : "start"}</span>
-        <span className="tracking-wide text-neutral-500">time →</span>
-        <span>{duration != null && duration > 0 ? `${duration}s` : "end"}</span>
-      </div>
-      <div className="mt-1 flex items-center justify-between px-0.5">
-        <span className="text-[10px] text-neutral-400">{label}</span>
-        <span
-          className="font-mono text-[9px] tracking-tight text-neutral-600"
-          title="cubic-bezier control points"
-        >
-          {bezierText}
-        </span>
-      </div>
+              {/* Anchors at (0,0) and (1,1) */}
+              <circle cx={a0.x} cy={a0.y} r="3" fill={ACCENT} />
+              <circle cx={a1.x} cy={a1.y} r="3" fill={ACCENT} />
+              {/* Draggable control handles (large transparent hit area + visible dot) */}
+              {showHandles &&
+                [["p1", p1] as const, ["p2", p2] as const].map(([key, pt]) => (
+                  <g key={key}>
+                    <circle
+                      cx={pt.x}
+                      cy={pt.y}
+                      r="14"
+                      fill="transparent"
+                      role="slider"
+                      tabIndex={0}
+                      aria-label={`${key === "p1" ? "First" : "Second"} bezier control point`}
+                      aria-valuemin={0}
+                      aria-valuemax={1}
+                      aria-valuenow={key === "p1" ? x1 : x2}
+                      aria-valuetext={`x ${key === "p1" ? x1 : x2}, y ${key === "p1" ? y1 : y2}`}
+                      className="cursor-grab stroke-transparent outline-none active:cursor-grabbing focus-visible:stroke-white focus-visible:stroke-[2px]"
+                      onPointerDown={(e) => handlePointerDown(key, e)}
+                      onKeyDown={(event) => handleKeyDown(key, event)}
+                      onPointerEnter={() => setHover(key)}
+                      onPointerLeave={() => setHover((h) => (h === key ? null : h))}
+                    />
+                    <circle
+                      cx={pt.x}
+                      cy={pt.y}
+                      r={hover === key || draggingRef.current === key ? 7 : 5.5}
+                      fill="#0a0a1a"
+                      stroke={ACCENT}
+                      strokeWidth="2.5"
+                      className="pointer-events-none transition-[r]"
+                    />
+                  </g>
+                ))}
+            </svg>
+          </div>
+          <EaseParameterField
+            springBounce={springBounce}
+            wiggleConfig={wiggleConfig}
+            tuple={displayTuple}
+            onCommit={onCustomEaseCommit}
+          />
+        </>
+      ) : (
+        <p className="px-0.5 py-1.5 text-[10px] leading-relaxed text-neutral-500">
+          {label} preset: switch to Curve, Spring, or Wiggle above to shape it by hand.
+        </p>
+      )}
     </div>
   );
 }
diff --git a/packages/studio/src/components/editor/EaseParamFields.test.tsx b/packages/studio/src/components/editor/EaseParamFields.test.tsx
new file mode 100644
index 0000000000..cde5e682e9
--- /dev/null
+++ b/packages/studio/src/components/editor/EaseParamFields.test.tsx
@@ -0,0 +1,188 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { parseWiggleEase } from "@hyperframes/core/wiggle-ease";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { EaseBezierField, SpringBounceField, WiggleField } from "./EaseParamFields";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+const roots: Root[] = [];
+
+afterEach(() => {
+  act(() => roots.splice(0).forEach((root) => root.unmount()));
+  document.body.innerHTML = "";
+});
+
+function renderField(field: React.ReactNode): HTMLElement {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  roots.push(root);
+  act(() => root.render(field));
+  return host;
+}
+
+function parsedWiggle(ease: string) {
+  const config = parseWiggleEase(ease);
+  expect(config).not.toBeNull();
+  if (!config) throw new Error(`Expected a valid wiggle ease: ${ease}`);
+  return config;
+}
+
+function expectWiggleCommit(onCommit: ReturnType<typeof vi.fn>, ease: string): void {
+  expect(onCommit).toHaveBeenLastCalledWith(ease);
+  const emitted = onCommit.mock.lastCall?.[0];
+  expect(typeof emitted === "string" ? parseWiggleEase(emitted) : null).not.toBeNull();
+}
+
+function inputValue(input: HTMLInputElement, value: string): void {
+  act(() => {
+    const valueSetter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value")?.set;
+    valueSetter?.call(input, value);
+    input.dispatchEvent(new Event("input", { bubbles: true }));
+  });
+}
+
+function commitInputValue(input: HTMLInputElement, value: string): void {
+  act(() => input.focus());
+  inputValue(input, value);
+  act(() => input.blur());
+}
+
+// Render a default wiggle field, type `value` into the input labelled `label`,
+// and return the commit spy — the shared body of the input-edit cases.
+function editWiggle(label: string, value: string): ReturnType<typeof vi.fn> {
+  const onCommit = vi.fn();
+  const host = renderField(
+    <WiggleField config={parsedWiggle("wiggle(6,easeOut,0.26)")} onCommit={onCommit} />,
+  );
+  const input = host.querySelector<HTMLInputElement>(`[aria-label="${label}"]`);
+  expect(input).not.toBeNull();
+  if (input) commitInputValue(input, value);
+  return onCommit;
+}
+
+describe("WiggleField", () => {
+  it("reflects a parsed wiggle config", () => {
+    const host = renderField(
+      <WiggleField config={parsedWiggle("wiggle(6,easeOut,0.26)")} onCommit={vi.fn()} />,
+    );
+
+    expect(host.querySelector<HTMLInputElement>('[aria-label="Wiggle count"]')?.value).toBe("6");
+    expect(host.querySelector<HTMLSelectElement>('[aria-label="Wiggle type"]')?.value).toBe(
+      "easeOut",
+    );
+    expect(host.querySelector<HTMLInputElement>('[aria-label="Wiggle amplitude"]')?.value).toBe(
+      "0.26",
+    );
+  });
+
+  it("commits an edited count", () => {
+    expectWiggleCommit(editWiggle("Wiggle count", "4"), "wiggle(4,easeOut,0.26)");
+  });
+
+  it("commits an edited type", () => {
+    const onCommit = vi.fn();
+    const host = renderField(
+      <WiggleField config={parsedWiggle("wiggle(6,easeOut,0.26)")} onCommit={onCommit} />,
+    );
+
+    const select = host.querySelector<HTMLSelectElement>('[aria-label="Wiggle type"]');
+    expect(select).not.toBeNull();
+    act(() => {
+      if (!select) return;
+      select.value = "anticipate";
+      select.dispatchEvent(new Event("change", { bubbles: true }));
+    });
+
+    expectWiggleCommit(onCommit, "wiggle(6,anticipate,0.26)");
+  });
+
+  it("commits an edited amplitude", () => {
+    expectWiggleCommit(editWiggle("Wiggle amplitude", "0.1"), "wiggle(6,easeOut,0.1)");
+  });
+
+  it("seeds and explicitly commits the per-type default amplitude", () => {
+    const onCommit = vi.fn();
+    const host = renderField(
+      <WiggleField config={parsedWiggle("wiggle(3,easeInOut)")} onCommit={onCommit} />,
+    );
+
+    expect(host.querySelector<HTMLInputElement>('[aria-label="Wiggle amplitude"]')?.value).toBe(
+      "0.08",
+    );
+    const count = host.querySelector<HTMLInputElement>('[aria-label="Wiggle count"]');
+    expect(count).not.toBeNull();
+    if (count) commitInputValue(count, "4");
+
+    expectWiggleCommit(onCommit, "wiggle(4,easeInOut,0.08)");
+  });
+
+  it("ignores an empty amplitude", () => {
+    expect(editWiggle("Wiggle amplitude", "")).not.toHaveBeenCalled();
+  });
+
+  it("rejects a count below one", () => {
+    expect(editWiggle("Wiggle count", "0")).not.toHaveBeenCalled();
+  });
+});
+
+describe("moved ease parameter fields", () => {
+  it("keeps the spring bounce commit behavior", () => {
+    const onCommit = vi.fn();
+    const host = renderField(<SpringBounceField springBounce={0.5} onCommit={onCommit} />);
+    const input = host.querySelector<HTMLInputElement>('[aria-label="Spring bounce"]');
+    expect(input).not.toBeNull();
+    if (input) commitInputValue(input, "0.333");
+
+    expect(onCommit).toHaveBeenLastCalledWith("spring(0.33)");
+  });
+
+  it("commits a numeric draft exactly once when Enter blurs the field", () => {
+    const onCommit = vi.fn();
+    const host = renderField(<SpringBounceField springBounce={0.5} onCommit={onCommit} />);
+    const input = host.querySelector<HTMLInputElement>('[aria-label="Spring bounce"]')!;
+
+    act(() => input.focus());
+    inputValue(input, "0.7");
+    act(() => input.dispatchEvent(new KeyboardEvent("keydown", { key: "Enter", bubbles: true })));
+
+    expect(onCommit).toHaveBeenCalledExactlyOnceWith("spring(0.7)");
+  });
+
+  it("keeps the cubic-bezier tuple commit behavior", () => {
+    const onCommit = vi.fn();
+    const host = renderField(<EaseBezierField tuple={[0.33, 0, 0.67, 1]} onCommit={onCommit} />);
+    const input = host.querySelector<HTMLInputElement>(
+      '[aria-label="Cubic bezier control points"]',
+    );
+    expect(input).not.toBeNull();
+    act(() => {
+      if (!input) return;
+      input.focus();
+      const valueSetter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value")?.set;
+      valueSetter?.call(input, "0.111, 0.222, 0.777, 0.888");
+      input.dispatchEvent(new Event("input", { bubbles: true }));
+      input.dispatchEvent(new KeyboardEvent("keydown", { key: "Enter", bubbles: true }));
+    });
+
+    expect(onCommit).toHaveBeenCalledExactlyOnceWith("custom(M0,0 C0.11,0.22 0.78,0.89 1,1)");
+  });
+
+  it("keeps the bezier input mounted and reports invalid values", () => {
+    const onCommit = vi.fn();
+    const host = renderField(<EaseBezierField tuple={[0.33, 0, 0.67, 1]} onCommit={onCommit} />);
+    const input = host.querySelector<HTMLInputElement>(
+      '[aria-label="Cubic bezier control points"]',
+    )!;
+
+    commitInputValue(input, "0.5, 1e9, 0.5, -1e9");
+
+    expect(input.isConnected).toBe(true);
+    expect(input.getAttribute("aria-invalid")).toBe("true");
+    expect(host.textContent).toContain("Y values must be between -1 and 2");
+    expect(onCommit).not.toHaveBeenCalled();
+  });
+});
diff --git a/packages/studio/src/components/editor/EaseParamFields.tsx b/packages/studio/src/components/editor/EaseParamFields.tsx
new file mode 100644
index 0000000000..d1e783d7e7
--- /dev/null
+++ b/packages/studio/src/components/editor/EaseParamFields.tsx
@@ -0,0 +1,246 @@
+import { useEffect, useId, useRef, useState } from "react";
+import { parseSpringBounce } from "@hyperframes/core/spring-ease";
+import {
+  parseWiggleEase,
+  type WiggleEaseConfig,
+  type WiggleType,
+} from "@hyperframes/core/wiggle-ease";
+import { roundToCenti } from "../../utils/rounding";
+import { MiniCurveSvg } from "./easeCurveSvg";
+
+type Pts = [number, number, number, number];
+
+const round2 = roundToCenti;
+const BEZIER_Y_MIN = -1;
+const BEZIER_Y_MAX = 2;
+const WIGGLE_TYPES = ["easeOut", "easeInOut", "anticipate", "uniform"] as const;
+const WIGGLE_DEFAULT_AMPLITUDE = {
+  easeOut: 0.16,
+  easeInOut: 0.08,
+  anticipate: 0.12,
+  uniform: 0.14,
+} satisfies Record<WiggleType, number>;
+
+function isWiggleType(value: string): value is WiggleType {
+  return WIGGLE_TYPES.some((type) => type === value);
+}
+
+function commitWiggle(
+  onCommit: (ease: string) => void,
+  count: number,
+  type: WiggleType,
+  amplitude: number,
+): void {
+  const ease = `wiggle(${count},${type},${roundToCenti(amplitude)})`;
+  if (parseWiggleEase(ease)) onCommit(ease);
+}
+
+// Editable cubic-bezier control points, Figma-style ("0.33, 0, 0, 1").
+export function EaseBezierField({
+  tuple,
+  onCommit,
+}: {
+  tuple: Pts;
+  onCommit: (ease: string) => void;
+}) {
+  const text = tuple.join(", ");
+  const inputRef = useRef<HTMLInputElement>(null);
+  const errorId = useId();
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (inputRef.current) inputRef.current.value = text;
+    setError(null);
+  }, [text]);
+
+  const commit = (raw: string) => {
+    const tokens = raw.trim().split(/[\s,]+/);
+    const nums = tokens.map(Number);
+    if (tokens.length !== 4 || nums.some((value) => !Number.isFinite(value))) {
+      setError("Enter four finite numbers");
+      return;
+    }
+    const [x1, y1, x2, y2] = nums as [number, number, number, number];
+    if (y1 < BEZIER_Y_MIN || y1 > BEZIER_Y_MAX || y2 < BEZIER_Y_MIN || y2 > BEZIER_Y_MAX) {
+      setError(`Y values must be between ${BEZIER_Y_MIN} and ${BEZIER_Y_MAX}`);
+      return;
+    }
+    const cx = (v: number) => Math.max(0, Math.min(1, v));
+    setError(null);
+    onCommit(`custom(M0,0 C${round2(cx(x1))},${round2(y1)} ${round2(cx(x2))},${round2(y2)} 1,1)`);
+  };
+  return (
+    <div className="mt-1.5 px-0.5">
+      <div className="flex items-center gap-1.5">
+        <MiniCurveSvg
+          ease={`custom(M0,0 C${tuple[0]},${tuple[1]} ${tuple[2]},${tuple[3]} 1,1)`}
+          active
+          size={14}
+        />
+        <input
+          ref={inputRef}
+          type="text"
+          defaultValue={text}
+          aria-label="Cubic bezier control points"
+          aria-invalid={error !== null}
+          aria-describedby={error ? errorId : undefined}
+          onInput={() => setError(null)}
+          onKeyDown={(event) => {
+            if (event.key === "Enter") event.currentTarget.blur();
+            if (event.key === "Escape") {
+              event.currentTarget.value = text;
+              setError(null);
+            }
+          }}
+          onBlur={(event) => commit(event.currentTarget.value)}
+          className={`w-full rounded border bg-black/20 px-1.5 py-1 font-mono text-[10px] text-neutral-300 outline-none ${
+            error
+              ? "border-red-500/70 focus:border-red-400"
+              : "border-white/10 focus:border-panel-accent/50"
+          }`}
+        />
+      </div>
+      <p
+        id={errorId}
+        aria-live="polite"
+        className={`mt-1 text-[9px] text-red-400 ${error ? "" : "sr-only"}`}
+      >
+        {error ?? "Valid bezier values"}
+      </p>
+    </div>
+  );
+}
+
+function NumericCommitInput({
+  label,
+  value,
+  min,
+  max,
+  step,
+  className,
+  onCommit,
+}: {
+  label: string;
+  value: number;
+  min: number;
+  max?: number;
+  step: number;
+  className: string;
+  onCommit: (value: number) => void;
+}) {
+  const [draft, setDraft] = useState(String(value));
+  useEffect(() => setDraft(String(value)), [value]);
+  const commit = () => {
+    if (draft.trim() === "") {
+      setDraft(String(value));
+      return;
+    }
+    const next = Number(draft);
+    if (!Number.isFinite(next) || next < min || (max !== undefined && next > max)) {
+      setDraft(String(value));
+      return;
+    }
+    onCommit(next);
+  };
+  return (
+    <input
+      type="number"
+      aria-label={label}
+      min={min}
+      max={max}
+      step={step}
+      value={draft}
+      onChange={(event) => setDraft(event.currentTarget.value)}
+      onBlur={commit}
+      onKeyDown={(event) => {
+        if (event.key === "Enter") event.currentTarget.blur();
+        if (event.key === "Escape") {
+          setDraft(String(value));
+        }
+      }}
+      className={className}
+    />
+  );
+}
+
+export function SpringBounceField({
+  springBounce,
+  onCommit,
+}: {
+  springBounce: number;
+  onCommit: (ease: string) => void;
+}) {
+  return (
+    <div className="mt-1.5 flex items-center gap-2 px-0.5 text-[10px] text-neutral-400">
+      <span aria-hidden="true">Bounce</span>
+      <NumericCommitInput
+        label="Spring bounce"
+        value={springBounce}
+        min={0}
+        max={1}
+        step={0.01}
+        onCommit={(value) => {
+          const bounce = parseSpringBounce(`spring(${value})`);
+          if (bounce !== null) onCommit(`spring(${round2(bounce)})`);
+        }}
+        className="w-16 rounded border border-white/10 bg-black/20 px-1.5 py-1 font-mono text-[10px] text-neutral-300 outline-none focus:border-panel-accent/50"
+      />
+    </div>
+  );
+}
+
+export function WiggleField({
+  config,
+  onCommit,
+}: {
+  config: WiggleEaseConfig;
+  onCommit: (ease: string) => void;
+}) {
+  const amplitude = config.amplitude ?? WIGGLE_DEFAULT_AMPLITUDE[config.type];
+  return (
+    <div className="mt-1.5 flex items-center gap-2 px-0.5 text-[10px] text-neutral-400">
+      <div className="flex items-center gap-1">
+        <span aria-hidden="true">Count</span>
+        <NumericCommitInput
+          label="Wiggle count"
+          value={config.wiggles}
+          min={1}
+          step={1}
+          onCommit={(value) => commitWiggle(onCommit, value, config.type, amplitude)}
+          className="w-14 rounded border border-white/10 bg-black/20 px-1.5 py-1 font-mono text-[10px] text-neutral-300 outline-none focus:border-panel-accent/50"
+        />
+      </div>
+      <div className="flex items-center gap-1">
+        <span aria-hidden="true">Type</span>
+        <select
+          aria-label="Wiggle type"
+          value={config.type}
+          onChange={(event) => {
+            if (isWiggleType(event.currentTarget.value)) {
+              commitWiggle(onCommit, config.wiggles, event.currentTarget.value, amplitude);
+            }
+          }}
+          className="rounded border border-white/10 bg-black/20 px-1.5 py-1 text-[10px] text-neutral-300 outline-none focus:border-panel-accent/50"
+        >
+          {WIGGLE_TYPES.map((type) => (
+            <option key={type} value={type}>
+              {type}
+            </option>
+          ))}
+        </select>
+      </div>
+      <div className="flex items-center gap-1">
+        <span aria-hidden="true">Amplitude</span>
+        <NumericCommitInput
+          label="Wiggle amplitude"
+          value={amplitude}
+          min={0}
+          max={1}
+          step={0.01}
+          onCommit={(value) => commitWiggle(onCommit, config.wiggles, config.type, value)}
+          className="w-16 rounded border border-white/10 bg-black/20 px-1.5 py-1 font-mono text-[10px] text-neutral-300 outline-none focus:border-panel-accent/50"
+        />
+      </div>
+    </div>
+  );
+}
diff --git a/packages/studio/src/components/editor/easeCurveSvg.tsx b/packages/studio/src/components/editor/easeCurveSvg.tsx
new file mode 100644
index 0000000000..8832404f81
--- /dev/null
+++ b/packages/studio/src/components/editor/easeCurveSvg.tsx
@@ -0,0 +1,65 @@
+import { evaluateWiggleEase, parseWiggleEase } from "@hyperframes/core/wiggle-ease";
+import { evaluateSpringEase, parseSpringBounce } from "@hyperframes/core/spring-ease";
+import { resolveEaseCurveTuple } from "./gsapAnimationConstants";
+
+export function sampledPath(
+  samples: number,
+  x: (progress: number) => number,
+  y: (value: number) => number,
+  evaluate: (progress: number) => number,
+): string {
+  return Array.from({ length: samples + 1 }, (_, index) => {
+    const progress = index / samples;
+    return `${index === 0 ? "M" : "L"}${x(progress)},${y(evaluate(progress))}`;
+  }).join(" ");
+}
+
+export function holdCurvePath(left: number, bottom: number, right: number, top: number): string {
+  return `M${left},${bottom} L${right},${bottom} L${right},${top}`;
+}
+
+export function MiniCurveSvg({
+  ease,
+  active,
+  size = 24,
+}: {
+  ease: string;
+  active: boolean;
+  size?: number;
+}) {
+  const springBounce = parseSpringBounce(ease);
+  const wiggle = parseWiggleEase(ease);
+  const curve = resolveEaseCurveTuple(ease);
+  const [x1, y1, x2, y2] = curve;
+  const s = size;
+  const p = size / 8;
+  const g = s - p * 2;
+  const sx = (px: number) => p + g * px;
+  const sy = (py: number) => s - p - g * py;
+  const d =
+    ease === "hold"
+      ? holdCurvePath(p, s - p, s - p, p)
+      : wiggle
+        ? sampledPath(64, sx, sy, (progress) =>
+            evaluateWiggleEase(progress, wiggle.wiggles, wiggle.type, wiggle.amplitude),
+          )
+        : springBounce !== null
+          ? sampledPath(
+              24,
+              sx,
+              (value) => sy(value / 1.2),
+              (progress) => evaluateSpringEase(progress, springBounce),
+            )
+          : `M${p},${s - p} C${sx(x1)},${sy(y1)} ${sx(x2)},${sy(y2)} ${s - p},${p}`;
+  return (
+    <svg width={s} height={s} viewBox={`0 0 ${s} ${s}`}>
+      <path
+        d={d}
+        fill="none"
+        stroke={active ? "#3CE6AC" : "#737373"}
+        strokeWidth="1.5"
+        strokeLinecap="round"
+      />
+    </svg>
+  );
+}
diff --git a/packages/studio/src/components/editor/easePresetLibrary.test.ts b/packages/studio/src/components/editor/easePresetLibrary.test.ts
new file mode 100644
index 0000000000..1d16b66062
--- /dev/null
+++ b/packages/studio/src/components/editor/easePresetLibrary.test.ts
@@ -0,0 +1,114 @@
+// Imports the parsers SOURCE (not the published subpath) so newly-added eases
+// like circ.inOut resolve before the parsers dist is rebuilt.
+import { SUPPORTED_EASES } from "../../../../parsers/src/gsapConstants";
+import { parseSpringBounce } from "@hyperframes/core/spring-ease";
+import { parseWiggleEase } from "@hyperframes/core/wiggle-ease";
+import { describe, expect, it } from "vitest";
+import { EASE_PRESETS, easePresetLabel } from "./easePresetLibrary";
+import { resolveEaseCurveTuple } from "./gsapAnimationConstants";
+
+const CUSTOM_EASE_PATTERN =
+  /^custom\(M0,0 C-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)? -?\d+(?:\.\d+)?,-?\d+(?:\.\d+)? 1,1\)$/;
+
+describe("EASE_PRESETS", () => {
+  it("contains the complete 32-preset Graphs library with unique fields", () => {
+    expect(EASE_PRESETS).toHaveLength(32);
+    expect(new Set(EASE_PRESETS.map(({ id }) => id))).toHaveLength(32);
+    expect(new Set(EASE_PRESETS.map(({ label }) => label))).toHaveLength(32);
+    expect(new Set(EASE_PRESETS.map(({ ease }) => ease))).toHaveLength(32);
+  });
+
+  it("preserves the required standard, Flow, and Bounce mappings", () => {
+    const easeByLabel = Object.fromEntries(EASE_PRESETS.map(({ label, ease }) => [label, ease]));
+
+    expect(easeByLabel).toMatchObject({
+      Linear: "none",
+      "Ease In": "power1.in",
+      "Quad In": "power2.in",
+      "Cubic In": "power3.in",
+      "Ease Out": "power1.out",
+      "Quad Out": "power2.out",
+      "Cubic Out": "power3.out",
+      "Ease In & Out": "power1.inOut",
+      "Quad Ease": "power2.inOut",
+      "Cubic Ease": "power3.inOut",
+      "Circular Ease": "circ.inOut",
+      "Ease In Back": "back.in",
+      "Ease Out Back": "back.out",
+      "Flow 1": "wiggle(1,easeInOut,0.20)",
+      "Flow 2": "wiggle(2,easeInOut,0.15)",
+      "Flow 3": "wiggle(3,easeInOut,0.12)",
+      "Flow 4": "wiggle(4,easeInOut,0.10)",
+      "Flow 5": "wiggle(5,easeInOut,0.08)",
+      "Flow 6": "wiggle(6,easeInOut,0.07)",
+      "Flow 7": "wiggle(7,easeInOut,0.06)",
+      "Bounce 1": "wiggle(4,easeOut,0.22)",
+      "Bounce 2": "wiggle(6,easeOut,0.26)",
+      "Bounce 3": "wiggle(9,uniform,0.32)",
+      "Bounce 4": "wiggle(5,anticipate,0.28)",
+      Hold: "hold",
+    });
+
+    const flows = EASE_PRESETS.filter(({ id }) => id.startsWith("flow-"));
+    expect(flows.map(({ label }) => label)).toEqual([
+      "Flow 1",
+      "Flow 2",
+      "Flow 3",
+      "Flow 4",
+      "Flow 5",
+      "Flow 6",
+      "Flow 7",
+    ]);
+    expect(flows.every(({ ease }) => parseWiggleEase(ease) !== null)).toBe(true);
+  });
+
+  it("uses supported or valid custom eases that all resolve to finite geometry", () => {
+    for (const preset of EASE_PRESETS) {
+      expect(
+        SUPPORTED_EASES.includes(preset.ease as (typeof SUPPORTED_EASES)[number]) ||
+          CUSTOM_EASE_PATTERN.test(preset.ease) ||
+          parseSpringBounce(preset.ease) !== null ||
+          parseWiggleEase(preset.ease) !== null,
+        `${preset.label} has unsupported ease ${preset.ease}`,
+      ).toBe(true);
+      expect(resolveEaseCurveTuple(preset.ease).every(Number.isFinite)).toBe(true);
+    }
+  });
+
+  it("assigns every preset a valid kind", () => {
+    const kinds = new Set(["curve", "spring", "wiggle"]);
+
+    for (const preset of EASE_PRESETS) {
+      expect(kinds.has(preset.kind)).toBe(true);
+    }
+  });
+
+  it("uses valid bounce values for spring presets", () => {
+    for (const preset of EASE_PRESETS.filter(({ kind }) => kind === "spring")) {
+      const bounce = parseSpringBounce(preset.ease);
+
+      expect(bounce).not.toBeNull();
+      expect(bounce).toBeGreaterThanOrEqual(0);
+      expect(bounce).toBeLessThanOrEqual(1);
+    }
+  });
+
+  it("uses parseable eases for wiggle presets", () => {
+    for (const preset of EASE_PRESETS.filter(({ kind }) => kind === "wiggle")) {
+      expect(parseWiggleEase(preset.ease)).not.toBeNull();
+    }
+  });
+
+  it("preserves stable preset ids", () => {
+    for (const id of ["flow-7", "hold", "rebound-in"]) {
+      expect(EASE_PRESETS.some((preset) => preset.id === id)).toBe(true);
+    }
+  });
+
+  it("resolves preset labels by exact ease", () => {
+    expect(easePresetLabel("spring(0.6)")).toBe("Bouncy");
+    expect(easePresetLabel("back.in")).toBe("Ease In Back");
+    expect(easePresetLabel("wiggle(9,uniform,0.32)")).toBe("Bounce 3");
+    expect(easePresetLabel("custom(x)")).toBeNull();
+  });
+});
diff --git a/packages/studio/src/components/editor/easePresetLibrary.ts b/packages/studio/src/components/editor/easePresetLibrary.ts
new file mode 100644
index 0000000000..37d9b449d8
--- /dev/null
+++ b/packages/studio/src/components/editor/easePresetLibrary.ts
@@ -0,0 +1,49 @@
+export const EASE_PRESETS = [
+  { id: "linear", label: "Linear", ease: "none", kind: "curve" },
+  { id: "ease-in", label: "Ease In", ease: "power1.in", kind: "curve" },
+  { id: "quad-in", label: "Quad In", ease: "power2.in", kind: "curve" },
+  { id: "cubic-in", label: "Cubic In", ease: "power3.in", kind: "curve" },
+  { id: "ease-out", label: "Ease Out", ease: "power1.out", kind: "curve" },
+  { id: "quad-out", label: "Quad Out", ease: "power2.out", kind: "curve" },
+  { id: "cubic-out", label: "Cubic Out", ease: "power3.out", kind: "curve" },
+  { id: "ease", label: "Ease In & Out", ease: "power1.inOut", kind: "curve" },
+  { id: "quad-ease", label: "Quad Ease", ease: "power2.inOut", kind: "curve" },
+  { id: "cubic-ease", label: "Cubic Ease", ease: "power3.inOut", kind: "curve" },
+  { id: "circular-ease", label: "Circular Ease", ease: "circ.inOut", kind: "curve" },
+  { id: "rebound-in", label: "Ease In Back", ease: "back.in", kind: "curve" },
+  { id: "rebound-out", label: "Ease Out Back", ease: "back.out", kind: "curve" },
+  { id: "flow-1", label: "Flow 1", ease: "wiggle(1,easeInOut,0.20)", kind: "wiggle" },
+  { id: "flow-2", label: "Flow 2", ease: "wiggle(2,easeInOut,0.15)", kind: "wiggle" },
+  { id: "flow-3", label: "Flow 3", ease: "wiggle(3,easeInOut,0.12)", kind: "wiggle" },
+  { id: "flow-4", label: "Flow 4", ease: "wiggle(4,easeInOut,0.10)", kind: "wiggle" },
+  { id: "flow-5", label: "Flow 5", ease: "wiggle(5,easeInOut,0.08)", kind: "wiggle" },
+  { id: "flow-6", label: "Flow 6", ease: "wiggle(6,easeInOut,0.07)", kind: "wiggle" },
+  { id: "flow-7", label: "Flow 7", ease: "wiggle(7,easeInOut,0.06)", kind: "wiggle" },
+  { id: "bounce-1", label: "Bounce 1", ease: "wiggle(4,easeOut,0.22)", kind: "wiggle" },
+  { id: "bounce-2", label: "Bounce 2", ease: "wiggle(6,easeOut,0.26)", kind: "wiggle" },
+  { id: "bounce-3", label: "Bounce 3", ease: "wiggle(9,uniform,0.32)", kind: "wiggle" },
+  { id: "bounce-4", label: "Bounce 4", ease: "wiggle(5,anticipate,0.28)", kind: "wiggle" },
+  { id: "hold", label: "Hold", ease: "hold", kind: "curve" },
+  {
+    id: "rebound-ease",
+    label: "Ease In & Out Back",
+    ease: "back.inOut",
+    kind: "curve",
+  },
+  { id: "expo-in", label: "Expo In", ease: "expo.in", kind: "curve" },
+  { id: "expo-out", label: "Expo Out", ease: "expo.out", kind: "curve" },
+  // Runtime spring(bounce) approximates Figma stiffness and damping with bounce alone.
+  { id: "spring-gentle", label: "Gentle", ease: "spring(0.15)", kind: "spring" },
+  { id: "spring-quick", label: "Quick", ease: "spring(0.4)", kind: "spring" },
+  { id: "spring-bouncy", label: "Bouncy", ease: "spring(0.6)", kind: "spring" },
+  { id: "spring-slow", label: "Slow", ease: "spring(0.25)", kind: "spring" },
+] as const satisfies ReadonlyArray<{
+  id: string;
+  label: string;
+  ease: string;
+  kind: "curve" | "spring" | "wiggle";
+}>;
+
+export function easePresetLabel(ease: string): string | null {
+  return EASE_PRESETS.find((preset) => preset.ease === ease)?.label ?? null;
+}
diff --git a/packages/studio/src/components/editor/gsapAnimationConstants.ts b/packages/studio/src/components/editor/gsapAnimationConstants.ts
index 0c97947cf2..5fa44e9006 100644
--- a/packages/studio/src/components/editor/gsapAnimationConstants.ts
+++ b/packages/studio/src/components/editor/gsapAnimationConstants.ts
@@ -1,4 +1,4 @@
-import { controlPointsForGsapEase } from "./studioMotion";
+import { controlPointsForGsapEase, parseStudioCustomEaseData } from "./studioMotion";
 
 export const METHOD_LABELS: Record<string, string> = {
   set: "Set",
@@ -116,9 +116,14 @@ export const EASE_CURVES: Record<string, [number, number, number, number]> = {
   "back.out": [0.34, 1.56, 0.64, 1],
   "back.in": [0.36, 0, 0.66, -0.56],
   "back.inOut": [0.68, -0.55, 0.27, 1.55],
+  "circ.inOut": [0.785, 0.135, 0.15, 0.86],
   "expo.out": [0.16, 1, 0.3, 1],
   "expo.in": [0.7, 0, 0.84, 0],
   "expo.inOut": [0.87, 0, 0.13, 1],
+  "bounce.out": [0.34, 1.56, 0.64, 0.74],
+  "bounce.in": [0.36, 0.26, 0.66, -0.56],
+  "elastic.out(1,0.3)": [0.16, 1.45, 0.28, 0.82],
+  "elastic.inOut(1,0.3)": [0.68, -0.55, 0.32, 1.55],
   // After Effects polarity: "in" eases into the keyframe (slow END, CP2 y=1),
   // "out" eases out of it (slow START, CP1 y=0). Matches the "(AE)" labels.
   "ae-ease": [0.333, 0, 0.667, 1],
@@ -126,18 +131,15 @@ export const EASE_CURVES: Record<string, [number, number, number, number]> = {
   "ae-ease-out": [0.333, 0, 0.667, 0.667],
 };
 
-export function parseCustomEaseFromString(ease: string): {
-  x1: number;
-  y1: number;
-  x2: number;
-  y2: number;
-} {
-  const match = ease.match(/^custom\((.+)\)$/);
-  if (!match) return controlPointsForGsapEase("power2.out");
-  const data = match[1];
-  const nums = data.match(/[\d.]+/g)?.map(Number);
-  if (!nums || nums.length < 6) return controlPointsForGsapEase("power2.out");
-  return { x1: nums[2], y1: nums[3], x2: nums[4], y2: nums[5] };
+export function resolveEaseCurveTuple(ease: string): [number, number, number, number] {
+  if (ease.startsWith("custom(")) {
+    const points = parseStudioCustomEaseData(ease.match(/^custom\((.+)\)$/)?.[1]);
+    if (points) return [points.x1, points.y1, points.x2, points.y2];
+  }
+  const curve = EASE_CURVES[ease];
+  if (curve) return curve;
+  const points = controlPointsForGsapEase(ease);
+  return [points.x1, points.y1, points.x2, points.y2];
 }
 
 export const PERCENT_PROPS = new Set(["opacity", "autoAlpha"]);
diff --git a/packages/studio/src/telemetry/events.test.ts b/packages/studio/src/telemetry/events.test.ts
index 03d706e02e..ad4e7f1401 100644
--- a/packages/studio/src/telemetry/events.test.ts
+++ b/packages/studio/src/telemetry/events.test.ts
@@ -12,6 +12,7 @@ const {
   trackStudioRenderStart,
   trackStudioRazorSplit,
   trackStudioExpandedClipEdit,
+  trackStudioSegmentEaseEdit,
   trackStudioFeedback,
 } = await import("./events");
 
@@ -71,6 +72,14 @@ describe("studio telemetry events", () => {
     expect(trackEvent).toHaveBeenCalledWith("studio_expanded_clip_edit", { action: "resize" });
   });
 
+  it("trackStudioSegmentEaseEdit emits 'studio_segment_ease_edit' with action and ease", () => {
+    trackStudioSegmentEaseEdit({ ease: "power2.out" });
+    expect(trackEvent).toHaveBeenCalledWith("studio_segment_ease_edit", {
+      action: "commit",
+      ease: "power2.out",
+    });
+  });
+
   it.each([0, 10])("trackStudioFeedback preserves NPS boundary %i and its scale", (rating) => {
     trackStudioFeedback({ rating });
 
diff --git a/packages/studio/src/telemetry/events.ts b/packages/studio/src/telemetry/events.ts
index f8ab262473..b73d008029 100644
--- a/packages/studio/src/telemetry/events.ts
+++ b/packages/studio/src/telemetry/events.ts
@@ -63,6 +63,11 @@ export function trackStudioExpandedClipEdit(props: {
   trackEvent("studio_expanded_clip_edit", { action: props.action });
 }
 
+// Adoption signal for committing an edit to a segment's ease.
+export function trackStudioSegmentEaseEdit(props: { ease: string }): void {
+  trackEvent("studio_segment_ease_edit", { action: "commit", ease: props.ease });
+}
+
 export function trackStudioFeedback(props: { rating: number; comment?: string }): void {
   trackEvent("survey sent", {
     $survey_id: "studio_experience",

From 4bfbd89d633d5fd227023643db62d2a566984edb Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Tue, 21 Jul 2026 05:49:42 +0200
Subject: [PATCH 060/125] fix(parsers): preserve duration-authored keyframe
 timing

---
 .../parsers/src/gsapObjectArrayTiming.test.ts |  56 ++++++
 packages/parsers/src/gsapObjectArrayTiming.ts |  84 +++++++++
 packages/parsers/src/gsapParser.test.ts       |   7 +-
 packages/parsers/src/gsapParser.ts            | 162 ++++++++----------
 .../parsers/src/gsapParserAcorn.full.test.ts  |   4 +-
 packages/parsers/src/gsapParserAcorn.ts       |  48 ++----
 .../parsers/src/gsapWriter.parity.test.ts     | 122 +++++++++++--
 packages/parsers/src/gsapWriterAcorn.ts       |  80 ++++-----
 8 files changed, 385 insertions(+), 178 deletions(-)
 create mode 100644 packages/parsers/src/gsapObjectArrayTiming.test.ts
 create mode 100644 packages/parsers/src/gsapObjectArrayTiming.ts

diff --git a/packages/parsers/src/gsapObjectArrayTiming.test.ts b/packages/parsers/src/gsapObjectArrayTiming.test.ts
new file mode 100644
index 0000000000..b1d554058f
--- /dev/null
+++ b/packages/parsers/src/gsapObjectArrayTiming.test.ts
@@ -0,0 +1,56 @@
+import { describe, expect, it } from "vitest";
+import {
+  findObjectArrayKeyframeIndex,
+  getCompatibleObjectArrayKeyframeTiming,
+  getObjectArrayKeyframeTiming,
+} from "./gsapObjectArrayTiming.js";
+
+describe("getObjectArrayKeyframeTiming", () => {
+  it("preserves tenth-percent precision for evenly distributed arrays", () => {
+    expect(getObjectArrayKeyframeTiming([undefined, undefined, undefined, undefined])).toEqual({
+      percentages: [0, 33.3, 66.7, 100],
+    });
+  });
+
+  it("maps positive authored durations to cumulative percentages", () => {
+    expect(getObjectArrayKeyframeTiming([1, 2, 1])).toEqual({
+      percentages: [25, 75, 100],
+      totalDuration: 4,
+    });
+  });
+
+  it.each([
+    [[0, 1, 1], "zero"],
+    [[1, -1, 1], "negative"],
+    [[1, Number.NaN, 1], "non-finite"],
+    [[1, "__raw:total * 0.5", 1], "expression"],
+    [[1, undefined, 1], "partial"],
+  ])("rejects %s duration timing (%s)", (durations) => {
+    expect(getObjectArrayKeyframeTiming(durations)).toBeNull();
+  });
+});
+
+describe("findObjectArrayKeyframeIndex", () => {
+  it("falls back to the nearest array entry for an in-range percentage", () => {
+    expect(
+      findObjectArrayKeyframeIndex([undefined, undefined, undefined, undefined], 50, {
+        fallbackToNearest: true,
+      }),
+    ).toBe(1);
+  });
+
+  it("rejects out-of-range and unresolved timing", () => {
+    expect(findObjectArrayKeyframeIndex([undefined, undefined], -1)).toBeNull();
+    expect(findObjectArrayKeyframeIndex([undefined, undefined], 101)).toBeNull();
+    expect(findObjectArrayKeyframeIndex([1, 0, 1], 50)).toBeNull();
+  });
+});
+
+describe("getCompatibleObjectArrayKeyframeTiming", () => {
+  it("accepts absent or matching outer durations and rejects conflicts", () => {
+    expect(getCompatibleObjectArrayKeyframeTiming([0.25, 0.75], undefined)).not.toBeNull();
+    expect(getCompatibleObjectArrayKeyframeTiming([0.25, 0.75], 1)).not.toBeNull();
+    expect(getCompatibleObjectArrayKeyframeTiming([0.25, 0.75], 2)).toBeNull();
+    expect(getCompatibleObjectArrayKeyframeTiming([0.25, 0.75], "1")).toBeNull();
+  });
+});
diff --git a/packages/parsers/src/gsapObjectArrayTiming.ts b/packages/parsers/src/gsapObjectArrayTiming.ts
new file mode 100644
index 0000000000..1b63e3202d
--- /dev/null
+++ b/packages/parsers/src/gsapObjectArrayTiming.ts
@@ -0,0 +1,84 @@
+export interface ObjectArrayKeyframeTiming {
+  percentages: number[];
+  totalDuration?: number;
+}
+
+const roundPercentage = (percentage: number): number => Math.round(percentage * 10) / 10;
+const OBJECT_ARRAY_PERCENTAGE_TOLERANCE = 2;
+
+/**
+ * Resolve GSAP object-array keyframe positions exactly once for parsers and writers.
+ * Authored per-step durations place each keyframe at its cumulative end; arrays
+ * without durations are distributed evenly. A partially-authored or invalid duration
+ * sequence is unresolved: callers must preserve the source rather than silently
+ * invent different timing.
+ */
+export function getObjectArrayKeyframeTiming(
+  durations: ReadonlyArray<unknown>,
+): ObjectArrayKeyframeTiming | null {
+  const hasAuthoredDuration = durations.some((duration) => duration !== undefined);
+  if (hasAuthoredDuration) {
+    if (
+      !durations.every(
+        (duration): duration is number =>
+          typeof duration === "number" && Number.isFinite(duration) && duration > 0,
+      )
+    ) {
+      return null;
+    }
+    const totalDuration = durations.reduce<number>((sum, duration) => sum + duration, 0);
+    let cumulative = 0;
+    return {
+      percentages: durations.map((duration) => {
+        cumulative += duration;
+        return roundPercentage((cumulative / totalDuration) * 100);
+      }),
+      totalDuration,
+    };
+  }
+
+  const lastIndex = durations.length - 1;
+  return {
+    percentages: durations.map((_, index) =>
+      lastIndex > 0 ? roundPercentage((index / lastIndex) * 100) : 0,
+    ),
+  };
+}
+
+export function getCompatibleObjectArrayKeyframeTiming(
+  durations: ReadonlyArray<unknown>,
+  outerDuration: unknown,
+): ObjectArrayKeyframeTiming | null {
+  const timing = getObjectArrayKeyframeTiming(durations);
+  if (!timing) return null;
+  if (timing.totalDuration === undefined || outerDuration === undefined) return timing;
+  if (
+    typeof outerDuration === "number" &&
+    Math.abs(outerDuration - timing.totalDuration) <= Number.EPSILON
+  ) {
+    return timing;
+  }
+  return null;
+}
+
+export function findObjectArrayKeyframeIndex(
+  durations: ReadonlyArray<unknown>,
+  percentage: number,
+  options?: { fallbackToNearest?: boolean; tolerance?: number },
+): number | null {
+  if (!Number.isFinite(percentage) || percentage < 0 || percentage > 100) return null;
+  const timing = getObjectArrayKeyframeTiming(durations);
+  if (!timing) return null;
+  const { percentages } = timing;
+  let match: number | null = null;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (let index = 0; index < percentages.length; index++) {
+    const distance = Math.abs(percentages[index]! - percentage);
+    if (distance < bestDistance) {
+      match = index;
+      bestDistance = distance;
+    }
+  }
+  const tolerance = options?.tolerance ?? OBJECT_ARRAY_PERCENTAGE_TOLERANCE;
+  return bestDistance <= tolerance || options?.fallbackToNearest ? match : null;
+}
diff --git a/packages/parsers/src/gsapParser.test.ts b/packages/parsers/src/gsapParser.test.ts
index eafbf09628..cdce510b53 100644
--- a/packages/parsers/src/gsapParser.test.ts
+++ b/packages/parsers/src/gsapParser.test.ts
@@ -1557,10 +1557,9 @@ describe("native GSAP keyframes parsing", () => {
     const kfs = expectKeyframesFormat(anim, "object-array", 3);
 
     // Total duration = 0.5 + 1 + 0.8 = 2.3
-    // First: cumulative = 0.5, pct = round(0.5/2.3 * 100) = 22
-    expectKeyframe(kfs[0], 22, { x: 0, opacity: 1 });
-    // Second: cumulative = 1.5, pct = round(1.5/2.3 * 100) = 65
-    expectKeyframe(kfs[1], 65, { x: 100 }, "power2.out");
+    // Preserve one decimal of authored timing precision.
+    expectKeyframe(kfs[0], 21.7, { x: 0, opacity: 1 });
+    expectKeyframe(kfs[1], 65.2, { x: 100 }, "power2.out");
     // Third: cumulative = 2.3, pct = round(2.3/2.3 * 100) = 100
     expectKeyframe(kfs[2], 100, { x: 200 });
   });
diff --git a/packages/parsers/src/gsapParser.ts b/packages/parsers/src/gsapParser.ts
index 24f42ec71e..9a3eea6af5 100644
--- a/packages/parsers/src/gsapParser.ts
+++ b/packages/parsers/src/gsapParser.ts
@@ -51,6 +51,11 @@ export {
 } from "./gsapConstants";
 import { classifyPropertyGroup, classifyTweenPropertyGroup } from "./gsapConstants";
 import type { PropertyGroupName } from "./gsapConstants";
+import {
+  findObjectArrayKeyframeIndex,
+  getCompatibleObjectArrayKeyframeTiming,
+  getObjectArrayKeyframeTiming,
+} from "./gsapObjectArrayTiming";
 export { generateSpringEaseData, SPRING_PRESETS } from "./springEase";
 export type { SpringPreset } from "./springEase";
 
@@ -723,21 +728,24 @@ function computeKeyframesTotalDuration(
     (p: AstNode) => (p.key?.name ?? p.key?.value) === "keyframes",
   )?.value;
   if (!kfNode || kfNode.type !== "ArrayExpression") return undefined;
-  let total = 0;
+  const durations: unknown[] = [];
   for (const el of kfNode.elements ?? []) {
     if (!el || el.type !== "ObjectExpression") continue;
     const r = objectExpressionToRecord(el, scope);
-    if (typeof r.duration === "number") total += r.duration;
+    durations.push(r.duration);
   }
-  return total > 0 ? total : undefined;
+  return getObjectArrayKeyframeTiming(durations)?.totalDuration;
 }
 
 // fallow-ignore-next-line complexity
-function parseObjectArrayKeyframes(node: AstNode, scope: ScopeBindings): GsapKeyframesData {
+function parseObjectArrayKeyframes(
+  node: AstNode,
+  scope: ScopeBindings,
+): GsapKeyframesData | undefined {
   const elements = node.elements ?? [];
   const raw: Array<{
     properties: Record<string, number | string>;
-    duration?: number;
+    duration?: unknown;
     ease?: string;
   }> = [];
 
@@ -748,10 +756,10 @@ function parseObjectArrayKeyframes(node: AstNode, scope: ScopeBindings): GsapKey
     }
     const record = objectExpressionToRecord(el, scope);
     const properties: Record<string, number | string> = {};
-    let duration: number | undefined;
+    let duration: unknown;
     let ease: string | undefined;
     for (const [k, v] of Object.entries(record)) {
-      if (k === "duration" && typeof v === "number") {
+      if (k === "duration") {
         duration = v;
       } else if (k === "ease" && typeof v === "string") {
         ease = v;
@@ -762,33 +770,16 @@ function parseObjectArrayKeyframes(node: AstNode, scope: ScopeBindings): GsapKey
     raw.push({ properties, duration, ease });
   }
 
-  // Convert durations to percentage positions. If durations are present, use
-  // cumulative ratios; otherwise distribute evenly.
-  const totalDuration = raw.reduce((sum, r) => sum + (r.duration ?? 0), 0);
-  const keyframes: GsapPercentageKeyframe[] = [];
-
-  if (totalDuration > 0) {
-    let cumulative = 0;
-    for (const entry of raw) {
-      cumulative += entry.duration ?? 0;
-      const percentage = Math.round((cumulative / totalDuration) * 100);
-      keyframes.push({
-        percentage,
-        properties: entry.properties,
-        ...(entry.ease ? { ease: entry.ease } : {}),
-      });
-    }
-  } else {
-    for (let i = 0; i < raw.length; i++) {
-      const entry = raw[i]!;
-      const percentage = raw.length > 1 ? Math.round((i / (raw.length - 1)) * 100) : 0;
-      keyframes.push({
-        percentage,
-        properties: entry.properties,
-        ...(entry.ease ? { ease: entry.ease } : {}),
-      });
-    }
-  }
+  const timing = getObjectArrayKeyframeTiming(raw.map((entry) => entry.duration));
+  if (!timing) return undefined;
+  const { percentages } = timing;
+  const keyframes = raw.map(
+    (entry, index): GsapPercentageKeyframe => ({
+      percentage: percentages[index]!,
+      properties: entry.properties,
+      ...(entry.ease ? { ease: entry.ease } : {}),
+    }),
+  );
 
   return { format: "object-array", keyframes };
 }
@@ -2106,14 +2097,11 @@ function findKeyframesObjectNode(varsArg: AstNode): AstNode | null {
 }
 
 /**
- * Convert array-form keyframes (`keyframes: [{x,y}, …]`) to even-percentage object
- * form (`{ "0%": {…}, "33.3%": {…}, … }`) IN PLACE, returning the new object node
- * (or null if not array-form). GSAP distributes an array evenly, so this is
- * runtime-identical — but it gives the percentage-keyed write ops something to
- * target. Needed before INSERTING a keyframe at an arbitrary percentage, which an
- * even array can't host.
+ * Convert array-form keyframes to percentage-object form in place. Per-step
+ * durations become cumulative positions and are removed from keyframe values;
+ * their sum becomes the outer duration when one was not authored.
  */
-function convertArrayKeyframesToObjectNode(varsArg: AstNode): AstNode | null {
+function convertArrayKeyframesToObjectNode(varsArg: AstNode, scope: ScopeBindings): AstNode | null {
   if (varsArg?.type !== "ObjectExpression") return null;
   const prop = (varsArg.properties ?? []).find(
     (p: AstNode) => isObjectProperty(p) && propKeyName(p) === "keyframes",
@@ -2122,11 +2110,22 @@ function convertArrayKeyframesToObjectNode(varsArg: AstNode): AstNode | null {
   const els: AstNode[] = (prop.value.elements ?? []).filter(
     (e: AstNode | null): e is AstNode => !!e && e.type === "ObjectExpression",
   );
-  const n = els.length;
-  if (n === 0) return null;
+  if (els.length === 0) return null;
+  const records = els.map((element) => objectExpressionToRecord(element, scope));
+  const outerDuration = objectExpressionToRecord(varsArg, scope).duration;
+  const timing = getCompatibleObjectArrayKeyframeTiming(
+    records.map((record) => record.duration),
+    outerDuration,
+  );
+  if (!timing) return null;
+  if (timing.totalDuration !== undefined && findPropertyNode(varsArg, "duration") === undefined) {
+    setVarsKey(varsArg, "duration", timing.totalDuration);
+  }
   const entries = els.map((el: AstNode, i: number) => {
-    const pct = n > 1 ? Math.round((i / (n - 1)) * 1000) / 10 : 0;
-    return `${JSON.stringify(`${pct}%`)}: ${recast.print(el).code}`;
+    el.properties = (el.properties ?? []).filter(
+      (property: AstNode) => !isObjectProperty(property) || propKeyName(property) !== "duration",
+    );
+    return `${JSON.stringify(`${timing.percentages[i]}%`)}: ${recast.print(el).code}`;
   });
   prop.value = parseExpr(`{ ${entries.join(", ")} }`);
   return prop.value;
@@ -2187,7 +2186,9 @@ export function addKeyframeToScript(
   // Array-form keyframes can't host an arbitrary new percentage — normalize to
   // object form in place first. (convertToKeyframesInScript below only converts
   // FLAT tweens; it early-returns when keyframes already exist.)
-  if (!kfNode) kfNode = convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
+  if (!kfNode) {
+    kfNode = convertArrayKeyframesToObjectNode(loc.target.call.varsArg, loc.parsed.scope);
+  }
 
   if (!kfNode) {
     script = convertToKeyframesInScript(script, animationId);
@@ -2300,11 +2301,8 @@ export function removeKeyframeFromScript(
   animationId: string,
   percentage: number,
 ): string {
-  // Array-form keyframes (`keyframes: [{x,y}, …]`) have no explicit percentages —
-  // GSAP distributes them evenly. The object-form path below can't see them
-  // (findKeyframesObjectNode only matches ObjectExpression), so removing from an
-  // array-form tween silently no-op'd. Resolve the element by its implicit
-  // percentage and splice it; collapse to a flat tween when fewer than two remain.
+  // Array-form keyframes have no explicit percentages. Resolve their authored
+  // cumulative/even position before splicing the matching element.
   const arrLoc = locateAnimationWithFallback(script, animationId);
   // findPropertyNode here returns the property's VALUE node directly.
   const arrVal = arrLoc && findPropertyNode(arrLoc.target.call.varsArg, "keyframes");
@@ -2312,19 +2310,12 @@ export function removeKeyframeFromScript(
     const elements: AstNode[] = (arrVal.elements ?? []).filter(
       (e: AstNode | null): e is AstNode => !!e && e.type === "ObjectExpression",
     );
-    const n = elements.length;
-    if (n === 0) return script;
-    let matchIdx = -1;
-    let bestDist = Number.POSITIVE_INFINITY;
-    for (let i = 0; i < n; i++) {
-      const pct = n > 1 ? (i / (n - 1)) * 100 : 0;
-      const dist = Math.abs(pct - percentage);
-      if (dist <= PCT_TOLERANCE && dist < bestDist) {
-        matchIdx = i;
-        bestDist = dist;
-      }
-    }
-    if (matchIdx === -1) return script;
+    if (elements.length === 0) return script;
+    const durations = elements.map(
+      (element) => objectExpressionToRecord(element, arrLoc.parsed.scope).duration,
+    );
+    const matchIdx = findObjectArrayKeyframeIndex(durations, percentage);
+    if (matchIdx === null) return script;
     const remaining = elements.filter((_, i) => i !== matchIdx);
     if (remaining.length < 2) {
       const sole = remaining[0];
@@ -2378,7 +2369,7 @@ export function moveKeyframeInScript(
   // normalize to object form in place first (mirrors addKeyframeToScript).
   const kfNode =
     findKeyframesObjectNode(loc.target.call.varsArg) ??
-    convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
+    convertArrayKeyframesToObjectNode(loc.target.call.varsArg, loc.parsed.scope);
   if (!kfNode) return script;
 
   const match = findKeyframePropByPct(kfNode, fromPercentage);
@@ -2439,7 +2430,7 @@ export function resizeKeyframedTweenInScript(
   // normalize to object form in place first (mirrors addKeyframeToScript).
   const kfNode =
     findKeyframesObjectNode(loc.target.call.varsArg) ??
-    convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
+    convertArrayKeyframesToObjectNode(loc.target.call.varsArg, loc.parsed.scope);
   if (!kfNode) return script;
 
   const seen = new Set<AstNode>();
@@ -2472,37 +2463,36 @@ export function updateKeyframeInScript(
   ease?: string,
 ): string {
   // Array-form keyframes (`keyframes: [{x,y}, …]`) have no explicit percentages —
-  // GSAP distributes them evenly. The percentage-keyed object path below can't
-  // match them (findKeyframesObjectNode only matches ObjectExpression), so dragging
-  // a motion-path node on an array-authored tween silently no-op'd. Resolve the
-  // element by its implicit percentage and replace it in place. Mirrors the array
-  // branch in removeKeyframeFromScript.
+  // Match array entries through the same cumulative/even timing rule used by
+  // parsing, then merge the edit without dropping per-step duration metadata.
   const arrLoc = locateAnimationWithFallback(script, animationId);
   const arrVal = arrLoc && findPropertyNode(arrLoc.target.call.varsArg, "keyframes");
   if (arrLoc && arrVal?.type === "ArrayExpression") {
     const elements: AstNode[] = (arrVal.elements ?? []).filter(
       (e: AstNode | null): e is AstNode => !!e && e.type === "ObjectExpression",
     );
-    const n = elements.length;
-    if (n === 0) return script;
-    let matchIdx = -1;
-    let bestDist = Number.POSITIVE_INFINITY;
-    for (let i = 0; i < n; i++) {
-      const pct = n > 1 ? (i / (n - 1)) * 100 : 0;
-      const dist = Math.abs(pct - percentage);
-      if (dist <= PCT_TOLERANCE && dist < bestDist) {
-        matchIdx = i;
-        bestDist = dist;
-      }
-    }
-    if (matchIdx === -1) return script;
+    if (elements.length === 0) return script;
+    const records = elements.map((element) =>
+      objectExpressionToRecord(element, arrLoc.parsed.scope),
+    );
+    const matchIdx = findObjectArrayKeyframeIndex(
+      records.map((record) => record.duration),
+      percentage,
+      { fallbackToNearest: true },
+    );
+    if (matchIdx === null) return script;
     const matchEl = elements[matchIdx];
     if (!matchEl) return script;
     const realIdx = arrVal.elements.indexOf(matchEl);
     if (Object.keys(properties).length === 0 && ease && setObjectExpressionEase(matchEl, ease)) {
       return recast.print(arrLoc.parsed.ast).code;
     }
-    arrVal.elements[realIdx] = buildKeyframeValueNode(properties, ease);
+    const merged: Record<string, number | string> = {};
+    for (const [key, value] of Object.entries(records[matchIdx] ?? {})) {
+      if (typeof value === "number" || typeof value === "string") merged[key] = value;
+    }
+    Object.assign(merged, properties);
+    arrVal.elements[realIdx] = buildKeyframeValueNode(merged, ease);
     return recast.print(arrLoc.parsed.ast).code;
   }
 
@@ -2674,7 +2664,7 @@ export function removeAllKeyframesFromScript(script: string, animationId: string
   // on every array-form tween.
   const kfNode =
     findKeyframesObjectNode(loc.target.call.varsArg) ??
-    convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
+    convertArrayKeyframesToObjectNode(loc.target.call.varsArg, loc.parsed.scope);
   const method = loc.target.call.method;
   let record: Record<string, unknown>;
   if (kfNode) {
diff --git a/packages/parsers/src/gsapParserAcorn.full.test.ts b/packages/parsers/src/gsapParserAcorn.full.test.ts
index 77b63b4aff..e6348eff04 100644
--- a/packages/parsers/src/gsapParserAcorn.full.test.ts
+++ b/packages/parsers/src/gsapParserAcorn.full.test.ts
@@ -882,8 +882,8 @@ describe("native GSAP keyframes parsing", () => {
     const anim = parseSingleAnimation(script);
     const kfs = expectKeyframesFormat(anim, "object-array", 3);
 
-    expectKeyframe(kfs[0], 22, { x: 0, opacity: 1 });
-    expectKeyframe(kfs[1], 65, { x: 100 }, "power2.out");
+    expectKeyframe(kfs[0], 21.7, { x: 0, opacity: 1 });
+    expectKeyframe(kfs[1], 65.2, { x: 100 }, "power2.out");
     expectKeyframe(kfs[2], 100, { x: 200 });
   });
 
diff --git a/packages/parsers/src/gsapParserAcorn.ts b/packages/parsers/src/gsapParserAcorn.ts
index f578879cd6..f8f4ef962c 100644
--- a/packages/parsers/src/gsapParserAcorn.ts
+++ b/packages/parsers/src/gsapParserAcorn.ts
@@ -21,6 +21,7 @@ import type {
 import { classifyTweenPropertyGroup } from "./gsapConstants.js";
 import { buildArcPath } from "./gsapSerialize.js";
 import { inlineComputedTimelines, readProvenance } from "./gsapInline.js";
+import { getObjectArrayKeyframeTiming } from "./gsapObjectArrayTiming.js";
 
 // Browser-safe re-exports so studio code can build arc config without importing
 // the recast parser (this acorn module is the browser-safe gsap subpath).
@@ -1031,13 +1032,13 @@ function computeKeyframesTotalDuration(
     (p: any) => (p.key?.name ?? p.key?.value) === "keyframes",
   )?.value;
   if (!kfNode || kfNode.type !== "ArrayExpression") return undefined;
-  let total = 0;
+  const durations: unknown[] = [];
   for (const el of kfNode.elements ?? []) {
     if (!el || el.type !== "ObjectExpression") continue;
     const r = objectExpressionToRecord(el, scope, source);
-    if (typeof r.duration === "number") total += r.duration;
+    durations.push(r.duration);
   }
-  return total > 0 ? total : undefined;
+  return getObjectArrayKeyframeTiming(durations)?.totalDuration;
 }
 
 // fallow-ignore-next-line complexity
@@ -1045,11 +1046,11 @@ function parseObjectArrayKeyframes(
   node: any,
   scope: ScopeBindings,
   source: string,
-): GsapKeyframesData {
+): GsapKeyframesData | undefined {
   const elements = node.elements ?? [];
   const raw: Array<{
     properties: Record<string, number | string>;
-    duration?: number;
+    duration?: unknown;
     ease?: string;
   }> = [];
 
@@ -1057,10 +1058,10 @@ function parseObjectArrayKeyframes(
     if (!el || el.type !== "ObjectExpression") continue;
     const record = objectExpressionToRecord(el, scope, source);
     const properties: Record<string, number | string> = {};
-    let duration: number | undefined;
+    let duration: unknown;
     let ease: string | undefined;
     for (const [k, v] of Object.entries(record)) {
-      if (k === "duration" && typeof v === "number") {
+      if (k === "duration") {
         duration = v;
       } else if (k === "ease" && typeof v === "string") {
         ease = v;
@@ -1071,32 +1072,13 @@ function parseObjectArrayKeyframes(
     raw.push({ properties, duration, ease });
   }
 
-  const totalDuration = raw.reduce((sum, r) => sum + (r.duration ?? 0), 0);
-  const keyframes: GsapPercentageKeyframe[] = [];
-
-  if (totalDuration > 0) {
-    let cumulative = 0;
-    for (const entry of raw) {
-      cumulative += entry.duration ?? 0;
-      const percentage = Math.round((cumulative / totalDuration) * 100);
-      keyframes.push({
-        percentage,
-        properties: entry.properties,
-        ...(entry.ease ? { ease: entry.ease } : {}),
-      });
-    }
-  } else {
-    for (let i = 0; i < raw.length; i++) {
-      const entry = raw[i];
-      if (!entry) continue;
-      const percentage = raw.length > 1 ? Math.round((i / (raw.length - 1)) * 100) : 0;
-      keyframes.push({
-        percentage,
-        properties: entry.properties,
-        ...(entry.ease ? { ease: entry.ease } : {}),
-      });
-    }
-  }
+  const timing = getObjectArrayKeyframeTiming(raw.map((entry) => entry.duration));
+  if (!timing) return undefined;
+  const keyframes: GsapPercentageKeyframe[] = raw.map((entry, index) => ({
+    percentage: timing.percentages[index]!,
+    properties: entry.properties,
+    ...(entry.ease ? { ease: entry.ease } : {}),
+  }));
 
   return { format: "object-array", keyframes };
 }
diff --git a/packages/parsers/src/gsapWriter.parity.test.ts b/packages/parsers/src/gsapWriter.parity.test.ts
index e934585ffe..9e0add6c8d 100644
--- a/packages/parsers/src/gsapWriter.parity.test.ts
+++ b/packages/parsers/src/gsapWriter.parity.test.ts
@@ -257,6 +257,23 @@ describe("removeKeyframeFromScript: array-form keyframes (recast + acorn parity)
     expect(removeKeyframeAcorn(arrayScript, id, 12)).toBe(arrayScript);
     expect(removeKeyframeRecast(arrayScript, id, 12)).toBe(arrayScript);
   });
+
+  it("removes duration-authored entries at their cumulative percentage", () => {
+    const durationScript = `
+      const tl = gsap.timeline({ paused: true });
+      tl.to("#p", { keyframes: [
+        { x: 0, duration: 1 },
+        { x: 50, duration: 2 },
+        { x: 100, duration: 1 }
+      ] }, 0.2);
+    `;
+    const id = acornId(durationScript);
+    const acorn = removeKeyframeAcorn(durationScript, id, 75);
+    const recast = removeKeyframeRecast(durationScript, id, 75);
+
+    expect(modelOf(acorn)).toEqual(modelOf(recast));
+    expect(JSON.stringify(shapeOf(acorn).keyframes)).not.toContain('"x":50');
+  });
 });
 
 const CONVERT_FIXTURES: Array<{
@@ -1049,6 +1066,18 @@ const UPD_ARRAY_SCRIPT = `
   const tl = gsap.timeline({ paused: true });
   tl.to("#dot", { keyframes: [{ x: 0, y: 0 }, { x: 50, y: 80 }, { x: 100, y: 0 }], duration: 1 }, 0.2);
 `;
+const DURATION_ARRAY_SCRIPT = `
+  const tl = gsap.timeline({ paused: true });
+  tl.to("#dot", { keyframes: [{ x: 0, duration: 1 }, { x: 50, duration: 2 }, { x: 100, duration: 1 }] }, 0.2);
+`;
+const EXPRESSION_DURATION_ARRAY_SCRIPT = `
+  const tl = gsap.timeline({ paused: true });
+  tl.to("#dot", { keyframes: [{ x: 0, duration: getStep() }, { x: 100, duration: 1 }] }, 0.2);
+`;
+const MISMATCHED_DURATION_ARRAY_SCRIPT = `
+  const tl = gsap.timeline({ paused: true });
+  tl.to("#dot", { keyframes: [{ x: 0, duration: 1 }, { x: 50, duration: 2 }, { x: 100, duration: 1 }], duration: 8 }, 0.2);
+`;
 const UPD_MOTION_PATH_SCRIPT = `
   const tl = gsap.timeline({ paused: true });
   tl.to("#title", { motionPath: { path: [{ x: 0, y: 0 }, { x: 100, y: 40 }] }, duration: 1, ease: "power1.inOut" }, 0.2);
@@ -1089,6 +1118,46 @@ describe("parity: updateKeyframeInScript (recast vs acorn)", () => {
     expectParity(UPD_ARRAY_SCRIPT, 49, { x: 55, y: 85 });
   });
 
+  it("targets duration-authored array entries at their cumulative percentage", () => {
+    const id = acornId(DURATION_ARRAY_SCRIPT);
+    const acorn = updateKeyframeAcorn(DURATION_ARRAY_SCRIPT, id, 75, {}, "spring(0.42)");
+    const recast = updateKeyframeRecast(DURATION_ARRAY_SCRIPT, id, 75, {}, "spring(0.42)");
+
+    expect(modelOf(acorn)).toEqual(modelOf(recast));
+    for (const output of [acorn, recast]) {
+      const keyframes = parseGsapScript(output).animations[0]!.keyframes!.keyframes;
+      expect(keyframes.map((keyframe) => keyframe.percentage)).toEqual([25, 75, 100]);
+      expect(keyframes[1]!.ease).toBe("spring(0.42)");
+      expect(keyframes[0]!.ease).toBeUndefined();
+    }
+  });
+
+  it("keeps browser and server parsers aligned on duration-authored percentages", () => {
+    const server = parseGsapScript(DURATION_ARRAY_SCRIPT).animations[0]?.keyframes?.keyframes;
+    const browser = parseGsapScriptAcorn(DURATION_ARRAY_SCRIPT).animations[0]?.keyframes?.keyframes;
+
+    expect(browser?.map(({ percentage }) => percentage)).toEqual(
+      server?.map(({ percentage }) => percentage),
+    );
+  });
+
+  it("preserves source instead of inventing timing for an expression duration", () => {
+    const id = acornId(EXPRESSION_DURATION_ARRAY_SCRIPT);
+
+    expect(updateKeyframeAcorn(EXPRESSION_DURATION_ARRAY_SCRIPT, id, 50, { x: 60 })).toBe(
+      EXPRESSION_DURATION_ARRAY_SCRIPT,
+    );
+    expect(updateKeyframeRecast(EXPRESSION_DURATION_ARRAY_SCRIPT, id, 50, { x: 60 })).toBe(
+      EXPRESSION_DURATION_ARRAY_SCRIPT,
+    );
+    expect(
+      parseGsapScript(EXPRESSION_DURATION_ARRAY_SCRIPT).animations[0]?.hasUnresolvedKeyframes,
+    ).toBe(true);
+    expect(
+      parseGsapScriptAcorn(EXPRESSION_DURATION_ARRAY_SCRIPT).animations[0]?.hasUnresolvedKeyframes,
+    ).toBe(true);
+  });
+
   it("no-op when the object-form percentage is absent (both writers)", () => {
     const id = acornId(UPD_OBJ_SCRIPT);
     expect(updateKeyframeAcorn(UPD_OBJ_SCRIPT, id, 33, { opacity: 0.4 })).toBe(UPD_OBJ_SCRIPT);
@@ -1128,20 +1197,7 @@ describe("parity: updateKeyframeInScript (recast vs acorn)", () => {
     expect(animation?.keyframes?.keyframes.at(-1)?.properties).toMatchObject(properties);
   });
 
-  // KNOWN DIVERGENCE (acorn-array bug, follow-up — NOT a test artifact):
-  // For PARTIAL props on ARRAY-form keyframes the two writers disagree. recast's
-  // array branch (gsapParser.updateKeyframeInScript) does a whole-value REPLACE
-  // — `arrVal.elements[i] = buildKeyframeValueNode(properties, ease)` — matching
-  // its own object-form branch and the documented replace contract. acorn's
-  // array branch (updateArrayKeyframeByPct in gsapWriterAcorn) MERGES instead —
-  // `{ ...valueNodeToRecord(el), ...properties }` — so updating `50%` with only
-  // `{ x: 60 }` leaves recast at { x: 60 } but acorn at { x: 60, y: 80 }. acorn's
-  // array path is inconsistent with both recast AND acorn's own object path.
-  // Real callers (Studio drag, SDK mutate.ts) always pass the COMPLETE keyframe
-  // value, so the bug is latent in production — but it's a genuine writer gap to
-  // fix in gsapWriterAcorn, out of scope for this test-only change. Skipped (not
-  // deleted) so the contract is documented and the fix has a ready assertion.
-  it.skip("array-form PARTIAL props: recast replaces, acorn merges (acorn bug)", () => {
+  it("array-form partial props preserve the remaining authored keyframe fields", () => {
     const id = acornId(UPD_ARRAY_SCRIPT);
     const acorn = updateKeyframeAcorn(UPD_ARRAY_SCRIPT, id, 50, { x: 60 });
     const recast = updateKeyframeRecast(UPD_ARRAY_SCRIPT, id, 50, { x: 60 });
@@ -1271,6 +1327,28 @@ describe("moveKeyframeInScript: array-form keyframes (recast + acorn parity)", (
     expect(moveKeyframeAcorn(KF_ADD_ARRAY_SCRIPT, id, 50, 100)).toBe(KF_ADD_ARRAY_SCRIPT);
     expect(moveKeyframeRecast(KF_ADD_ARRAY_SCRIPT, id, 50, 100)).toBe(KF_ADD_ARRAY_SCRIPT);
   });
+
+  it("normalizes duration-authored percentages before moving", () => {
+    const id = acornId(DURATION_ARRAY_SCRIPT);
+    const acorn = moveKeyframeAcorn(DURATION_ARRAY_SCRIPT, id, 75, 60);
+    const recast = moveKeyframeRecast(DURATION_ARRAY_SCRIPT, id, 75, 60);
+
+    expect(modelOf(acorn)).toEqual(modelOf(recast));
+    expect(shapeOf(acorn).keyframes?.keyframes.map((keyframe) => keyframe.percentage)).toEqual([
+      25, 60, 100,
+    ]);
+  });
+
+  it("does not normalize conflicting inner and outer durations", () => {
+    const id = acornId(MISMATCHED_DURATION_ARRAY_SCRIPT);
+
+    expect(moveKeyframeAcorn(MISMATCHED_DURATION_ARRAY_SCRIPT, id, 75, 60)).toBe(
+      MISMATCHED_DURATION_ARRAY_SCRIPT,
+    );
+    expect(moveKeyframeRecast(MISMATCHED_DURATION_ARRAY_SCRIPT, id, 75, 60)).toBe(
+      MISMATCHED_DURATION_ARRAY_SCRIPT,
+    );
+  });
 });
 
 // ── resizeKeyframedTweenInScript (boundary drag: re-key + grow window) ────────
@@ -1385,6 +1463,22 @@ describe("resizeKeyframedTweenInScript: array-form keyframes (recast + acorn par
       modelOf(resizeKeyframedTweenRecast(KF_ADD_ARRAY_SCRIPT, id, 0.2, 2, RESIZE_ARRAY_REMAP)),
     );
   });
+
+  it("normalizes duration-authored percentages before resizing", () => {
+    const id = acornId(DURATION_ARRAY_SCRIPT);
+    const remap = [
+      { from: 25, to: 20 },
+      { from: 75, to: 60 },
+      { from: 100, to: 100 },
+    ];
+    const acorn = resizeKeyframedTweenAcorn(DURATION_ARRAY_SCRIPT, id, 0.2, 5, remap);
+    const recast = resizeKeyframedTweenRecast(DURATION_ARRAY_SCRIPT, id, 0.2, 5, remap);
+
+    expect(modelOf(acorn)).toEqual(modelOf(recast));
+    expect(shapeOf(acorn).keyframes?.keyframes.map((keyframe) => keyframe.percentage)).toEqual([
+      20, 60, 100,
+    ]);
+  });
 });
 
 describe("removeAllKeyframesFromScript: array-form keyframes (recast + acorn parity)", () => {
diff --git a/packages/parsers/src/gsapWriterAcorn.ts b/packages/parsers/src/gsapWriterAcorn.ts
index 00b5da5c4e..f6d8e42151 100644
--- a/packages/parsers/src/gsapWriterAcorn.ts
+++ b/packages/parsers/src/gsapWriterAcorn.ts
@@ -26,6 +26,10 @@ import {
 } from "./gsapParserAcorn.js";
 import { classifyPropertyGroup } from "./gsapConstants.js";
 import type { PropertyGroupName } from "./gsapConstants.js";
+import {
+  findObjectArrayKeyframeIndex,
+  getCompatibleObjectArrayKeyframeTiming,
+} from "./gsapObjectArrayTiming.js";
 import type { SplitAnimationsOptions, SplitAnimationsResult } from "./gsapSerialize.js";
 import * as acornWalk from "acorn-walk";
 
@@ -974,8 +978,6 @@ export function updateKeyframeInScript(
   return updateObjectKeyframe(script, match.prop, properties, ease);
 }
 
-// ponytail: even-spacing index map; if array keyframes ever carry per-element
-// `duration`, switch to matching the closest cumulative position.
 function updateArrayKeyframeByPct(
   script: string,
   arrayNode: Node,
@@ -986,13 +988,18 @@ function updateArrayKeyframeByPct(
   const elements = ((arrayNode.elements ?? []) as Array<Node | null>).filter(
     (el): el is Node => !!el && el.type === "ObjectExpression",
   );
-  const n = elements.length;
-  if (n === 0) return script;
-  const idx = n > 1 ? Math.round((percentage / 100) * (n - 1)) : 0;
-  const el = elements[Math.max(0, Math.min(n - 1, idx))];
+  if (elements.length === 0) return script;
+  const records = elements.map((element) => valueNodeToRecord(element, script));
+  const idx = findObjectArrayKeyframeIndex(
+    records.map((record) => record.duration),
+    percentage,
+    { fallbackToNearest: true },
+  );
+  if (idx === null) return script;
+  const el = elements[idx];
   if (!el) return script;
   const merged: Record<string, number | string> = {
-    ...valueNodeToRecord(el, script),
+    ...records[idx],
     ...properties,
   };
   if (ease) merged.ease = ease;
@@ -1071,23 +1078,34 @@ function locateWithKeyframes(
 }
 
 /** Locate a tween's keyframes object, converting a flat tween first if absent. */
-// Array-form keyframes (`keyframes: [{x,y}, …]`) → even-percentage object form
-// (`{ "0%": {…}, "33.3%": {…}, … }`). Inserting a keyframe needs percentage keys,
-// which an even array can't host. Runtime-identical; mirrors the recast path.
+// Array-form keyframes → percentage-object form. Duration-authored entries use
+// cumulative positions; duration metadata moves to the outer tween.
 function convertArrayKeyframesToObject(script: string, target: Node): string {
   const kfPropNode = findPropertyNode(target.call.varsArg, "keyframes");
   if (!kfPropNode || kfPropNode.value?.type !== "ArrayExpression") return script;
   const els = ((kfPropNode.value.elements ?? []) as Array<Node | null>).filter(
     (el): el is Node => !!el && el.type === "ObjectExpression",
   );
-  const n = els.length;
-  if (n === 0) return script;
+  if (els.length === 0) return script;
+  const records = els.map((element) => valueNodeToRecord(element, script));
+  const outerDuration = valueNodeToRecord(target.call.varsArg, script).duration;
+  const timing = getCompatibleObjectArrayKeyframeTiming(
+    records.map((record) => record.duration),
+    outerDuration,
+  );
+  if (!timing) return script;
   const entries = els.map((el, i) => {
-    const pct = n > 1 ? Math.round((i / (n - 1)) * 1000) / 10 : 0;
-    return `${JSON.stringify(`${pct}%`)}: ${script.slice(el.start, el.end)}`;
+    const { duration: _duration, ...record } = records[i]!;
+    return `${JSON.stringify(`${timing.percentages[i]}%`)}: ${recordToCode(record)}`;
   });
   const ms = new MagicString(script);
   ms.overwrite(kfPropNode.value.start, kfPropNode.value.end, `{ ${entries.join(", ")} }`);
+  if (
+    timing.totalDuration !== undefined &&
+    findPropertyNode(target.call.varsArg, "duration") === undefined
+  ) {
+    upsertProp(ms, target.call.varsArg, "duration", timing.totalDuration);
+  }
   return ms.toString();
 }
 
@@ -1237,18 +1255,8 @@ function collapseKeyframesToFlat(
   ms.overwrite(varsNode.start, varsNode.end, `{ ${entries.join(", ")} }`);
 }
 
-/** Implicit tween-relative percentage of array-form keyframe index `i` of `n`
- *  (GSAP distributes array keyframes evenly: 0%, 1/(n-1), …, 100%). */
-function arrayKeyframePct(i: number, n: number): number {
-  return n > 1 ? (i / (n - 1)) * 100 : 0;
-}
-
-// Array-form keyframes (`keyframes: [{x,y}, …]`) carry no explicit percentages —
-// GSAP distributes them evenly. removeKeyframeFromScript only handled the
-// object-form (`keyframes: { "50%": {…} }`), so removing from an array-form tween
-// was a silent no-op (and the downstream hold-sync then stranded an `hf-hold`).
-// Resolve the element by its implicit percentage and splice it out; collapse to a
-// flat tween when fewer than two remain (parity with the object-form path).
+// Resolve an array entry through the parser's cumulative/even timing rule, then
+// splice it out; collapse when fewer than two remain.
 function removeArrayKeyframe(
   ms: MagicString,
   varsArg: Node,
@@ -1259,19 +1267,13 @@ function removeArrayKeyframe(
   const elements: Node[] = (arrNode.elements ?? []).filter(
     (e: Node | null): e is Node => !!e && e.type === "ObjectExpression",
   );
-  const n = elements.length;
-  if (n === 0) return false;
-
-  let matchIdx = -1;
-  let bestDist = Number.POSITIVE_INFINITY;
-  for (let i = 0; i < n; i++) {
-    const dist = Math.abs(arrayKeyframePct(i, n) - percentage);
-    if (dist <= PCT_TOLERANCE && dist < bestDist) {
-      matchIdx = i;
-      bestDist = dist;
-    }
-  }
-  if (matchIdx === -1) return false;
+  if (elements.length === 0) return false;
+  const records = elements.map((element) => valueNodeToRecord(element, script));
+  const matchIdx = findObjectArrayKeyframeIndex(
+    records.map((record) => record.duration),
+    percentage,
+  );
+  if (matchIdx === null) return false;
 
   const remaining = elements.filter((_, i) => i !== matchIdx);
   if (remaining.length < 2) {

From 3b3d4f559ca0b97a4d48d5dbaef10c296407c9cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Miguel=20=C3=81ngel?= <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 16:13:20 +0200
Subject: [PATCH 061/125] test(cli): move render module collection outside
 hooks (#2780)

---
 packages/cli/src/commands/render.test.ts | 47 +++++++-----------------
 1 file changed, 14 insertions(+), 33 deletions(-)

diff --git a/packages/cli/src/commands/render.test.ts b/packages/cli/src/commands/render.test.ts
index e3a1fdabed..092860ce30 100644
--- a/packages/cli/src/commands/render.test.ts
+++ b/packages/cli/src/commands/render.test.ts
@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication
-import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
@@ -181,26 +181,19 @@ vi.mock("../utils/orphanCleanup.js", () => ({
   }),
 }));
 
+// Collect the heavy render module once, after Vitest has hoisted the mocks
+// above. Keeping this import out of a hook means parallel monorepo contention
+// cannot turn module collection into a `beforeAll` timeout.
+const renderModule = await import("./render.js");
+
 describe("renderLocal browser GPU config", () => {
   const savedEnv = new Map<string, string | undefined>();
-  // Pre-resolve once. The first dynamic `import("./render.js")` in this file
-  // cold-loads a heavy module graph (core + engine + producer, incl. linkedom),
-  // slow under the parallel monorepo run — the generous hook timeout that
-  // absorbs that contention now lives in vitest.config.ts (shared by all CLI
-  // suites). Importing once in `beforeAll` keeps every test fast and isolated.
-  let renderLocal: typeof import("./render.js").renderLocal;
-  let resolveBrowserGpuForCli: typeof import("./render.js").resolveBrowserGpuForCli;
-  let renderLintContinuationHint: typeof import("./render.js").renderLintContinuationHint;
-  let resetTrialState: typeof import("./render.js").__resetDeParallelRouterTrialStateForTests;
-
-  beforeAll(async () => {
-    ({
-      renderLocal,
-      resolveBrowserGpuForCli,
-      renderLintContinuationHint,
-      __resetDeParallelRouterTrialStateForTests: resetTrialState,
-    } = await import("./render.js"));
-  });
+  const {
+    renderLocal,
+    resolveBrowserGpuForCli,
+    renderLintContinuationHint,
+    __resetDeParallelRouterTrialStateForTests: resetTrialState,
+  } = renderModule;
 
   it("points strict warning-only renders to --strict-all", () => {
     expect(renderLintContinuationHint(true)).toContain("--strict-all");
@@ -713,15 +706,9 @@ describe("renderLocal browser GPU config", () => {
 });
 
 describe("renderLocal — DE parallel-router CLI trial", () => {
-  let renderLocal: typeof import("./render.js").renderLocal;
-  let resetTrialState: typeof import("./render.js").__resetDeParallelRouterTrialStateForTests;
+  const { renderLocal, __resetDeParallelRouterTrialStateForTests: resetTrialState } = renderModule;
   const savedEnv = new Map<string, string | undefined>();
 
-  beforeAll(async () => {
-    ({ renderLocal, __resetDeParallelRouterTrialStateForTests: resetTrialState } =
-      await import("./render.js"));
-  });
-
   beforeEach(() => {
     producerState.createdJobs = [];
     producerState.executeImpl = async () => undefined;
@@ -1110,13 +1097,7 @@ describe("renderLocal — DE parallel-router CLI trial", () => {
 });
 
 describe("checkRenderResolutionPreflight", () => {
-  let checkRenderResolutionPreflight: typeof import("./render.js").checkRenderResolutionPreflight;
-
-  // Cold-imports render.js (heavy graph); the generous hook timeout for parallel
-  // CI contention lives in vitest.config.ts. See the note above.
-  beforeAll(async () => {
-    ({ checkRenderResolutionPreflight } = await import("./render.js"));
-  });
+  const { checkRenderResolutionPreflight } = renderModule;
 
   // Dims must be read the same way the producer's compiler reads them:
   // `data-width` / `data-height` on the `[data-composition-id]` root.

From e4d7bde64f3b3e500834231134bc9fdb3858ad41 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 16:40:52 +0200
Subject: [PATCH 062/125] feat(studio): add keyframe timeline state

---
 .../components/editor/AnimationCard.test.tsx  |  93 +++------------
 .../src/components/editor/AnimationCard.tsx   |   2 +-
 packages/studio/src/hooks/gsapDragCommit.ts   |   4 +-
 .../hooks/gsapKeyframeCacheHelpers.test.ts    |  96 ++++++++++++++-
 .../src/hooks/gsapKeyframeCacheHelpers.ts     |  60 ++++++++--
 .../src/hooks/gsapScriptCommitHelpers.ts      |   5 +-
 packages/studio/src/hooks/gsapShared.test.ts  |  31 ++++-
 packages/studio/src/hooks/gsapShared.ts       |  55 ++++++---
 .../studio/src/hooks/gsapTweenSynth.test.ts   |  31 ++++-
 packages/studio/src/hooks/gsapTweenSynth.ts   |  49 +++++---
 packages/studio/src/hooks/useDomSelection.ts  |   4 +
 packages/studio/src/hooks/useGestureCommit.ts |   4 +-
 .../src/hooks/useGsapKeyframeOps.test.tsx     |  37 ++++--
 .../src/hooks/useGsapSelectionHandlers.ts     |  22 ++--
 .../studio/src/hooks/useGsapTweenCache.ts     |  27 ++++-
 .../studio/src/hooks/useStudioTestHooks.ts    |  51 ++++++++
 .../studio/src/player/store/keyframeSlice.ts  | 109 ++++++++++++++++++
 .../src/player/store/playerStore.test.ts      |  25 ++++
 .../studio/src/player/store/playerStore.ts    |  49 +-------
 packages/studio/src/telemetry/events.test.ts  |   8 +-
 packages/studio/src/telemetry/events.ts       |  14 ++-
 21 files changed, 583 insertions(+), 193 deletions(-)
 create mode 100644 packages/studio/src/hooks/useStudioTestHooks.ts
 create mode 100644 packages/studio/src/player/store/keyframeSlice.ts

diff --git a/packages/studio/src/components/editor/AnimationCard.test.tsx b/packages/studio/src/components/editor/AnimationCard.test.tsx
index 802e07470d..ea51978c9a 100644
--- a/packages/studio/src/components/editor/AnimationCard.test.tsx
+++ b/packages/studio/src/components/editor/AnimationCard.test.tsx
@@ -45,17 +45,22 @@ function selectPreset(host: HTMLElement, presetId: string): string {
   return presetConfig.ease;
 }
 
-function renderExpandedCard({
-  animation,
+/** Every test mounts the same card; only expansion, flat mode, and the spies differ. */
+function renderCard({
+  animation = baseAnimation(),
+  defaultExpanded = true,
   flat,
   onUpdateMeta = vi.fn(),
   onUpdateKeyframeEase = vi.fn(),
+  onDeleteAnimation = noop,
 }: {
-  animation: GsapAnimation;
+  animation?: GsapAnimation;
+  defaultExpanded?: boolean;
   flat?: boolean;
   onUpdateMeta?: ReturnType<typeof vi.fn>;
   onUpdateKeyframeEase?: ReturnType<typeof vi.fn>;
-}) {
+  onDeleteAnimation?: (id: string) => void;
+} = {}) {
   const host = document.createElement("div");
   document.body.append(host);
   const root = createRoot(host);
@@ -63,11 +68,11 @@ function renderExpandedCard({
     root.render(
       <AnimationCard
         animation={animation}
-        defaultExpanded
+        defaultExpanded={defaultExpanded}
         flat={flat}
         onUpdateProperty={noop}
         onUpdateMeta={onUpdateMeta}
-        onDeleteAnimation={noop}
+        onDeleteAnimation={onDeleteAnimation}
         onAddProperty={noop}
         onRemoveProperty={noop}
         onUpdateKeyframeEase={onUpdateKeyframeEase}
@@ -90,7 +95,7 @@ describe("AnimationCard ease editing", () => {
         ],
       },
     });
-    const view = renderExpandedCard({ animation, onUpdateKeyframeEase });
+    const view = renderCard({ animation, onUpdateKeyframeEase });
 
     const segment = Array.from(view.host.querySelectorAll("button")).find((button) =>
       button.textContent?.includes("0% → 50%"),
@@ -101,6 +106,7 @@ describe("AnimationCard ease editing", () => {
 
     expect(onUpdateKeyframeEase).toHaveBeenCalledExactlyOnceWith(animation.id, 50, ease);
     expect(trackStudioSegmentEaseEdit).toHaveBeenCalledExactlyOnceWith({
+      action: "commit",
       ease,
     });
     act(() => view.root.unmount());
@@ -110,7 +116,7 @@ describe("AnimationCard ease editing", () => {
     const onUpdateMeta = vi.fn();
     const onUpdateKeyframeEase = vi.fn();
     const animation = baseAnimation({ id: "flat-tween" });
-    const view = renderExpandedCard({
+    const view = renderCard({
       animation,
       flat: true,
       onUpdateMeta,
@@ -128,23 +134,7 @@ describe("AnimationCard ease editing", () => {
 
 describe("AnimationCard flat branch", () => {
   it("renders a mint border-left and panel-token colors when flat", () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    const root = createRoot(host);
-    act(() => {
-      root.render(
-        <AnimationCard
-          animation={baseAnimation()}
-          defaultExpanded={false}
-          flat
-          onUpdateProperty={noop}
-          onUpdateMeta={noop}
-          onDeleteAnimation={noop}
-          onAddProperty={noop}
-          onRemoveProperty={noop}
-        />,
-      );
-    });
+    const { host, root } = renderCard({ defaultExpanded: false, flat: true });
     const card = host.querySelector('[data-flat-effect-card="true"]');
     expect(card).not.toBeNull();
     expect(card?.className).toContain("border-panel-accent");
@@ -152,22 +142,7 @@ describe("AnimationCard flat branch", () => {
   });
 
   it("still renders the legacy (non-flat) appearance when flat is omitted", () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    const root = createRoot(host);
-    act(() => {
-      root.render(
-        <AnimationCard
-          animation={baseAnimation()}
-          defaultExpanded={false}
-          onUpdateProperty={noop}
-          onUpdateMeta={noop}
-          onDeleteAnimation={noop}
-          onAddProperty={noop}
-          onRemoveProperty={noop}
-        />,
-      );
-    });
+    const { host, root } = renderCard({ defaultExpanded: false });
     expect(host.querySelector('[data-flat-effect-card="true"]')).toBeNull();
     expect(host.textContent).toContain("power2.out");
     act(() => root.unmount());
@@ -175,23 +150,7 @@ describe("AnimationCard flat branch", () => {
 
   it("toggles expanded state when the collapsed header button is clicked, in both modes", () => {
     for (const flat of [false, true]) {
-      const host = document.createElement("div");
-      document.body.append(host);
-      const root = createRoot(host);
-      act(() => {
-        root.render(
-          <AnimationCard
-            animation={baseAnimation()}
-            defaultExpanded={false}
-            flat={flat || undefined}
-            onUpdateProperty={noop}
-            onUpdateMeta={noop}
-            onDeleteAnimation={noop}
-            onAddProperty={noop}
-            onRemoveProperty={noop}
-          />,
-        );
-      });
+      const { host, root } = renderCard({ defaultExpanded: false, flat: flat || undefined });
       expect(host.textContent).not.toContain("Remove");
       const button = host.querySelector("button");
       expect(button).not.toBeNull();
@@ -205,23 +164,7 @@ describe("AnimationCard flat branch", () => {
 
   it("invokes onDeleteAnimation with the animation id when Remove is clicked, in flat mode", () => {
     const onDeleteAnimation = vi.fn();
-    const host = document.createElement("div");
-    document.body.append(host);
-    const root = createRoot(host);
-    act(() => {
-      root.render(
-        <AnimationCard
-          animation={baseAnimation()}
-          defaultExpanded={true}
-          flat
-          onUpdateProperty={noop}
-          onUpdateMeta={noop}
-          onDeleteAnimation={onDeleteAnimation}
-          onAddProperty={noop}
-          onRemoveProperty={noop}
-        />,
-      );
-    });
+    const { host, root } = renderCard({ flat: true, onDeleteAnimation });
     const buttons = Array.from(host.querySelectorAll("button"));
     const removeButton = buttons.find((b) => b.textContent === "Remove");
     expect(removeButton).not.toBeUndefined();
diff --git a/packages/studio/src/components/editor/AnimationCard.tsx b/packages/studio/src/components/editor/AnimationCard.tsx
index d178032d68..214d5b013d 100644
--- a/packages/studio/src/components/editor/AnimationCard.tsx
+++ b/packages/studio/src/components/editor/AnimationCard.tsx
@@ -267,7 +267,7 @@ export const AnimationCard = memo(function AnimationCard({
                     onToggle={setExpandedKfPct}
                     onEaseCommit={(pct, ease) => {
                       onUpdateKeyframeEase(animation.id, pct, ease);
-                      trackStudioSegmentEaseEdit({ ease });
+                      trackStudioSegmentEaseEdit({ action: "commit", ease });
                     }}
                     onApplyAll={
                       onSetAllKeyframeEases
diff --git a/packages/studio/src/hooks/gsapDragCommit.ts b/packages/studio/src/hooks/gsapDragCommit.ts
index 167ce438d5..4774c17e1b 100644
--- a/packages/studio/src/hooks/gsapDragCommit.ts
+++ b/packages/studio/src/hooks/gsapDragCommit.ts
@@ -12,7 +12,7 @@ import { usePlayerStore } from "../player/store/playerStore";
 import { readRuntimeKeyframes, scanAllRuntimeKeyframes } from "./gsapRuntimeKeyframes";
 import { resolveTweenStart, resolveTweenDuration } from "../utils/globalTimeCompiler";
 import { roundTo3 } from "../utils/rounding";
-import { computeElementPercentage } from "./gsapShared";
+import { computeElementPercentage, idSelector } from "./gsapShared";
 import { computeDraggedGsapPosition } from "./draggedGsapPosition";
 import type { RuntimeTweenChange } from "./gsapRuntimePatch";
 import { isGestureTransactionCommit, runGestureTransaction } from "./gestureTransaction";
@@ -117,7 +117,7 @@ export async function materializeIfDynamic(
     const allScanned = scanAllRuntimeKeyframes(iframe);
     if (allScanned.size === 0) return;
     const allElements = Array.from(allScanned.entries()).map(([id, data]) => ({
-      selector: `#${id}`,
+      selector: idSelector(id),
       keyframes: data.keyframes,
       easeEach: data.easeEach,
     }));
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
index 16fc62b206..ee72035f5e 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
@@ -28,7 +28,7 @@ const animWithKeyframes = (id: string): GsapAnimation => ({
 });
 
 beforeEach(() => {
-  usePlayerStore.setState({ keyframeCache: new Map(), elements: [] });
+  usePlayerStore.setState({ keyframeCache: new Map(), gsapAnimations: new Map(), elements: [] });
 });
 
 describe("clearKeyframeCacheForElement", () => {
@@ -98,6 +98,41 @@ describe("clearKeyframeCacheForFile", () => {
 });
 
 describe("updateKeyframeCacheFromParsed", () => {
+  it("serializes a multi-keyframe tween with a stable shape and animation identity", () => {
+    const animation: GsapAnimation = {
+      ...animWithKeyframes("hero"),
+      duration: 2,
+      resolvedStart: 3,
+      keyframes: {
+        format: "percentage",
+        keyframes: [
+          { percentage: 0, properties: { x: 0 } },
+          { percentage: 50, properties: { x: 100 }, ease: "power1.inOut" },
+          { percentage: 100, properties: { x: 200 } },
+        ],
+        easeEach: "power1.inOut",
+      },
+    };
+    usePlayerStore.setState({
+      elements: [
+        {
+          id: "hero-clip",
+          domId: "hero",
+          tag: "div",
+          start: 2,
+          duration: 4,
+          track: 0,
+        },
+      ],
+    });
+
+    updateKeyframeCacheFromParsed([animation], "scene.html", "hero", {});
+
+    expect(JSON.stringify(cache().get("scene.html#hero"))).toBe(
+      '{"format":"percentage","keyframes":[{"percentage":25,"properties":{"x":0},"tweenPercentage":0,"propertyGroup":"position","animationId":"hero"},{"percentage":50,"properties":{"x":100},"ease":"power1.inOut","tweenPercentage":50,"propertyGroup":"position","animationId":"hero"},{"percentage":75,"properties":{"x":200},"tweenPercentage":100,"propertyGroup":"position","animationId":"hero"}],"easeEach":"power1.inOut"}',
+    );
+  });
+
   it("clears the bare key when the selected element no longer has keyframes", () => {
     // Element previously had keyframes, so a bare entry exists (writes set both).
     seed("index.html#box");
@@ -118,4 +153,63 @@ describe("updateKeyframeCacheFromParsed", () => {
     expect(cache().has("index.html#hero")).toBe(true);
     expect(cache().has("hero")).toBe(true);
   });
+
+  it("caches flat tweens as clip-relative start and end keyframes", () => {
+    const animation: GsapAnimation = {
+      id: "flat-box",
+      targetSelector: "#box",
+      method: "to",
+      position: 1,
+      properties: { x: 420 },
+      duration: 2,
+      resolvedStart: 1,
+      ease: "power2.out",
+      propertyGroup: "position",
+    };
+    usePlayerStore.setState({
+      elements: [{ id: "box-clip", domId: "box", tag: "div", start: 1, duration: 2, track: 0 }],
+    });
+
+    updateKeyframeCacheFromParsed([animation], "scene.html", "box", {});
+
+    expect(cache().get("scene.html#box")).toEqual({
+      format: "percentage",
+      keyframes: [
+        {
+          percentage: 0,
+          properties: { x: 0 },
+          tweenPercentage: 0,
+          propertyGroup: "position",
+          animationId: "flat-box",
+        },
+        {
+          percentage: 100,
+          properties: { x: 420 },
+          ease: "power2.out",
+          tweenPercentage: 100,
+          propertyGroup: "position",
+          animationId: "flat-box",
+        },
+      ],
+    });
+    expect(usePlayerStore.getState().gsapAnimations.get("scene.html#box")).toEqual([animation]);
+  });
+
+  it("does not cache a flat tween without animatable numeric properties", () => {
+    const animation: GsapAnimation = {
+      id: "flat-box",
+      targetSelector: "#box",
+      method: "to",
+      position: 0,
+      properties: { backgroundColor: "#fff" },
+      duration: 1,
+      propertyGroup: "visual",
+    };
+
+    updateKeyframeCacheFromParsed([animation], "scene.html", "box", {});
+
+    expect(cache().has("scene.html#box")).toBe(false);
+    expect(cache().has("box")).toBe(false);
+    expect(usePlayerStore.getState().gsapAnimations.has("scene.html#box")).toBe(false);
+  });
 });
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index 1b5bef62b0..58da5c7aae 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -5,6 +5,7 @@
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { usePlayerStore, type KeyframeCacheEntry } from "../player/store/playerStore";
 import { toAbsoluteTime } from "./gsapShared";
+import { synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
 
 export function updateKeyframeCacheFromParsed(
   animations: GsapAnimation[],
@@ -15,10 +16,16 @@ export function updateKeyframeCacheFromParsed(
   const { setKeyframeCache, elements } = usePlayerStore.getState();
   const idsWithKeyframes = new Set<string>();
   const merged = new Map<string, KeyframeCacheEntry>();
+  const sourceAnimations = new Map<string, GsapAnimation[]>();
   for (const anim of animations) {
     const id = anim.targetSelector.match(/^#([\w-]+)/)?.[1];
-    if (!id || !anim.keyframes) continue;
+    const kfSource =
+      anim.keyframes?.keyframes ?? synthesizeFlatTweenKeyframes(anim)?.keyframes ?? [];
+    if (!id || kfSource.length === 0) continue;
     idsWithKeyframes.add(id);
+    if (anim.propertyGroup) {
+      sourceAnimations.set(id, [...(sourceAnimations.get(id) ?? []), anim]);
+    }
 
     // Convert tween-relative percentages to clip-relative so diamonds
     // render at the correct position within the timeline clip.
@@ -29,7 +36,7 @@ export function updateKeyframeCacheFromParsed(
     );
     const elStart = timelineEl?.start ?? 0;
     const elDuration = timelineEl?.duration ?? 1;
-    const clipKeyframes = anim.keyframes.keyframes.map((kf) => {
+    const clipKeyframes = kfSource.map((kf) => {
       const absTime = toAbsoluteTime(tweenPos, tweenDur, kf.percentage);
       const clipPct =
         elDuration > 0 ? Math.round(((absTime - elStart) / elDuration) * 1000) / 10 : kf.percentage;
@@ -38,6 +45,7 @@ export function updateKeyframeCacheFromParsed(
         percentage: clipPct,
         tweenPercentage: kf.percentage,
         propertyGroup: anim.propertyGroup,
+        animationId: anim.id,
       };
     });
 
@@ -48,6 +56,17 @@ export function updateKeyframeCacheFromParsed(
         const prev = byPct.get(kf.percentage);
         if (prev) {
           prev.properties = { ...prev.properties, ...kf.properties };
+          // Mirror deduplicateKeyframes: a same-% collision across different
+          // source animations is an ambiguous merged segment (the button can
+          // only target one arbitrary animation). Flag it so the collapsed row
+          // suppresses the inline ease button there.
+          if (
+            prev.animationId !== undefined &&
+            kf.animationId !== undefined &&
+            prev.animationId !== kf.animationId
+          ) {
+            prev.easeAmbiguous = true;
+          }
           if (kf.ease) prev.ease = kf.ease;
         } else {
           byPct.set(kf.percentage, { ...kf, properties: { ...kf.properties } });
@@ -55,13 +74,18 @@ export function updateKeyframeCacheFromParsed(
       }
       existing.keyframes = Array.from(byPct.values()).sort((a, b) => a.percentage - b.percentage);
     } else {
-      merged.set(id, { ...anim.keyframes, keyframes: clipKeyframes });
+      merged.set(id, {
+        ...anim.keyframes,
+        format: anim.keyframes?.format ?? "percentage",
+        keyframes: clipKeyframes,
+      });
     }
   }
   for (const [id, entry] of merged) {
     setKeyframeCache(`${targetPath}#${id}`, entry);
     setKeyframeCache(id, entry);
     if (targetPath !== "index.html") setKeyframeCache(`index.html#${id}`, entry);
+    writeGsapAnimationsForElement(targetPath, id, sourceAnimations.get(id));
   }
   const targetId =
     (mutation as { targetSelector?: string }).targetSelector?.match(/^#([\w-]+)/)?.[1] ??
@@ -84,13 +108,12 @@ export function updateKeyframeCacheFromParsed(
  * a new cache map and re-render every subscriber.
  */
 export function clearKeyframeCacheForElement(sourceFile: string, elementId: string): void {
-  const { keyframeCache, setKeyframeCache } = usePlayerStore.getState();
-  const keys =
-    sourceFile === "index.html"
-      ? [`index.html#${elementId}`, elementId]
-      : [`${sourceFile}#${elementId}`, `index.html#${elementId}`, elementId];
+  const { keyframeCache, setKeyframeCache, gsapAnimations, setGsapAnimations } =
+    usePlayerStore.getState();
+  const keys = elementCacheKeys(sourceFile, elementId);
   for (const key of keys) {
     if (keyframeCache.has(key)) setKeyframeCache(key, undefined);
+    if (gsapAnimations.has(key)) setGsapAnimations(key, undefined);
   }
 }
 
@@ -102,11 +125,11 @@ export function clearKeyframeCacheForElement(sourceFile: string, elementId: stri
  * absent from the re-scan) leaves no stale bare entry behind.
  */
 export function clearKeyframeCacheForFile(sourceFile: string): void {
-  const { keyframeCache } = usePlayerStore.getState();
+  const { keyframeCache, gsapAnimations } = usePlayerStore.getState();
   const sfPrefix = `${sourceFile}#`;
   const fallbackPrefix = "index.html#";
   const ids = new Set<string>();
-  for (const key of keyframeCache.keys()) {
+  for (const key of [...keyframeCache.keys(), ...gsapAnimations.keys()]) {
     const matchesFile =
       key.startsWith(sfPrefix) || (sourceFile !== "index.html" && key.startsWith(fallbackPrefix));
     if (!matchesFile) continue;
@@ -118,6 +141,23 @@ export function clearKeyframeCacheForFile(sourceFile: string): void {
   }
 }
 
+function elementCacheKeys(sourceFile: string, elementId: string): string[] {
+  return sourceFile === "index.html"
+    ? [`index.html#${elementId}`, elementId]
+    : [`${sourceFile}#${elementId}`, `index.html#${elementId}`, elementId];
+}
+
+export function writeGsapAnimationsForElement(
+  sourceFile: string,
+  elementId: string,
+  animations: GsapAnimation[] | undefined,
+): void {
+  const { setGsapAnimations } = usePlayerStore.getState();
+  for (const key of elementCacheKeys(sourceFile, elementId)) {
+    setGsapAnimations(key, animations);
+  }
+}
+
 function buildCacheKey(sourceFile: string, elementId: string): string {
   return `${sourceFile}#${elementId}`;
 }
diff --git a/packages/studio/src/hooks/gsapScriptCommitHelpers.ts b/packages/studio/src/hooks/gsapScriptCommitHelpers.ts
index d84c698608..e6d17338f3 100644
--- a/packages/studio/src/hooks/gsapScriptCommitHelpers.ts
+++ b/packages/studio/src/hooks/gsapScriptCommitHelpers.ts
@@ -2,12 +2,13 @@ import { findUnsafeDomPatchValues } from "@hyperframes/core/studio-api/finite-mu
 import type { DomEditSelection } from "../components/editor/domEditingTypes";
 
 export { PROPERTY_DEFAULTS } from "./gsapShared";
+import { idSelector } from "./gsapShared";
 
 export function ensureElementAddressable(selection: DomEditSelection): {
   selector: string;
   autoId?: string;
 } {
-  if (selection.id) return { selector: `#${selection.id}` };
+  if (selection.id) return { selector: idSelector(selection.id) };
   if (selection.selector) return { selector: selection.selector };
 
   const el = selection.element;
@@ -20,7 +21,7 @@ export function ensureElementAddressable(selection: DomEditSelection): {
     id = `${tag}-${n}`;
   }
   el.setAttribute("id", id);
-  return { selector: `#${id}`, autoId: id };
+  return { selector: idSelector(id), autoId: id };
 }
 
 export class GsapMutationHttpError extends Error {
diff --git a/packages/studio/src/hooks/gsapShared.test.ts b/packages/studio/src/hooks/gsapShared.test.ts
index ba45743488..30ed300a07 100644
--- a/packages/studio/src/hooks/gsapShared.test.ts
+++ b/packages/studio/src/hooks/gsapShared.test.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect } from "vitest";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
-import { isInstantHold, parsePercentageKeyframes } from "./gsapShared";
+import { idSelector, isInstantHold, parsePercentageKeyframes } from "./gsapShared";
 
 describe("isInstantHold", () => {
   const animation = (method: GsapAnimation["method"], duration?: number) =>
@@ -74,3 +74,32 @@ describe("parsePercentageKeyframes", () => {
     expect(parsePercentageKeyframes({})).toBeNull();
   });
 });
+
+describe("idSelector", () => {
+  it("uses #id for valid CSS identifiers", () => {
+    expect(idSelector("hero-word")).toBe("#hero-word");
+    expect(idSelector("el_1")).toBe("#el_1");
+  });
+
+  it("uses an attribute selector for ids that #id can't address (digit-leading, dots, spaces)", () => {
+    // #01-... / #a.b / #a b throw a SyntaxError in querySelector / GSAP, crashing
+    // the preview when such a target is committed (e.g. dragging the element).
+    expect(idSelector("01-hook-hero-word")).toBe('[id="01-hook-hero-word"]');
+    expect(idSelector("my.class")).toBe('[id="my.class"]');
+    expect(idSelector("1box")).toBe('[id="1box"]');
+  });
+
+  it("escapes quotes and backslashes in the attribute selector value", () => {
+    expect(idSelector('1"x')).toBe('[id="1\\"x"]');
+  });
+
+  it("only ever emits #id for ids that can't break querySelector", () => {
+    // Every id resolves to either a plain #id (only when safe) or an attribute
+    // selector — never a #id that would throw a SyntaxError.
+    for (const id of ["hero-word", "01-hook", "a.b", "a b", "1", "--x", '1"q']) {
+      const sel = idSelector(id);
+      if (sel.startsWith("#")) expect(sel).toBe(`#${id}`);
+      else expect(sel.startsWith('[id="')).toBe(true);
+    }
+  });
+});
diff --git a/packages/studio/src/hooks/gsapShared.ts b/packages/studio/src/hooks/gsapShared.ts
index 459f303b46..629e5976d1 100644
--- a/packages/studio/src/hooks/gsapShared.ts
+++ b/packages/studio/src/hooks/gsapShared.ts
@@ -53,8 +53,35 @@ export function isInstantHold(animation: GsapAnimation): boolean {
  * Returns `#id` if the selection has an id, otherwise the raw selector,
  * or null if neither exists.
  */
+/**
+ * A CSS-valid selector for an element id. `#id` for a valid CSS identifier,
+ * otherwise an `[id="..."]` attribute selector. IDs that start with a digit
+ * (e.g. "01-hook-hero-word") make `#id` an invalid selector, so
+ * `document.querySelector("#01-...")` / GSAP's `querySelectorAll` throw a
+ * SyntaxError — which surfaces as a masked cross-origin "Script error." and
+ * crashes the preview the moment such a target is committed (e.g. dragging).
+ */
+// Conservative: matches only ids that are unquestionably safe as a `#id`
+// selector — ASCII identifier, starts with a letter/underscore (or a single
+// leading hyphen), no dots/colons/spaces/digits-first. Anything it rejects
+// (digit-leading like "01-hook-...", dots, spaces, non-ASCII, …) falls through
+// to the attribute selector below, which is always valid. It can only ever err
+// toward the safe form, never toward a `#id` that throws — and, unlike
+// `CSS.escape`, it needs no browser global (this runs in node tests too).
+const SAFE_HASH_ID = /^-?[A-Za-z_][\w-]*$/;
+
+export function idSelector(id: string): string {
+  // A `#id` selector is only valid for a CSS identifier. IDs that start with a
+  // digit (e.g. "01-hook-hero-word") make `document.querySelector("#01-...")` and
+  // GSAP's `querySelectorAll` throw a SyntaxError — surfacing as a masked
+  // cross-origin "Script error." that crashes the preview the moment such a
+  // target is committed (e.g. dragging the element). Address those via an
+  // attribute selector instead (quotes/backslashes escaped for the string).
+  return SAFE_HASH_ID.test(id) ? `#${id}` : `[id="${id.replace(/(["\\])/g, "\\$1")}"]`;
+}
+
 export function selectorFromSelection(selection: DomEditSelection): string | null {
-  if (selection.id) return `#${selection.id}`;
+  if (selection.id) return idSelector(selection.id);
   if (selection.selector) return selection.selector;
   return null;
 }
@@ -118,6 +145,18 @@ export interface ParsedPercentageKeyframes {
   easeEach?: string;
 }
 
+function collectAnimatableKeyframeProperties(
+  entry: Record<string, unknown>,
+): Record<string, number | string> {
+  const properties: Record<string, number | string> = {};
+  for (const [property, value] of Object.entries(entry)) {
+    if (property === "ease") continue;
+    if (typeof value === "number") properties[property] = Math.round(value * 1000) / 1000;
+    else if (typeof value === "string") properties[property] = value;
+  }
+  return properties;
+}
+
 /**
  * Parse a GSAP percentage-keyframe object (`{ "0%": { x: 10 }, "100%": { x: 200 } }`)
  * into a sorted array of `{ percentage, properties }` entries.
@@ -146,12 +185,7 @@ export function parsePercentageKeyframes(
     steps.forEach((entry, i) => {
       if (!entry || typeof entry !== "object") return;
       const percentage = steps.length > 1 ? Math.round((i / (steps.length - 1)) * 1000) / 10 : 0;
-      const properties: Record<string, number | string> = {};
-      for (const [pk, pv] of Object.entries(entry as Record<string, unknown>)) {
-        if (pk === "ease") continue;
-        if (typeof pv === "number") properties[pk] = Math.round(pv * 1000) / 1000;
-        else if (typeof pv === "string") properties[pk] = pv;
-      }
+      const properties = collectAnimatableKeyframeProperties(entry as Record<string, unknown>);
       if (Object.keys(properties).length > 0) keyframes.push({ percentage, properties });
     });
     return keyframes.length > 0 ? { keyframes } : null;
@@ -165,12 +199,7 @@ export function parsePercentageKeyframes(
     const pctMatch = key.match(/^(\d+(?:\.\d+)?)%$/);
     if (!pctMatch || !val || typeof val !== "object") continue;
     const percentage = parseFloat(pctMatch[1]);
-    const properties: Record<string, number | string> = {};
-    for (const [pk, pv] of Object.entries(val as Record<string, unknown>)) {
-      if (pk === "ease") continue;
-      if (typeof pv === "number") properties[pk] = Math.round(pv * 1000) / 1000;
-      else if (typeof pv === "string") properties[pk] = pv;
-    }
+    const properties = collectAnimatableKeyframeProperties(val as Record<string, unknown>);
     if (Object.keys(properties).length > 0) {
       keyframes.push({ percentage, properties });
     }
diff --git a/packages/studio/src/hooks/gsapTweenSynth.test.ts b/packages/studio/src/hooks/gsapTweenSynth.test.ts
index 3d8d771222..b5474cf1de 100644
--- a/packages/studio/src/hooks/gsapTweenSynth.test.ts
+++ b/packages/studio/src/hooks/gsapTweenSynth.test.ts
@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
-import { synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
+import { deduplicateKeyframes, synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
 
 function anim(overrides: Partial<GsapAnimation>): GsapAnimation {
   return {
@@ -53,3 +53,32 @@ describe("synthesizeFlatTweenKeyframes", () => {
     expect(out).not.toBeNull();
   });
 });
+
+describe("deduplicateKeyframes ease ambiguity", () => {
+  it("flags a same-% collision from different animations (different eases)", () => {
+    const merged = deduplicateKeyframes([
+      { percentage: 45, properties: { x: 10 }, ease: "power2.in", animationId: "#a-position" },
+      { percentage: 45, properties: { opacity: 1 }, ease: "power2.out", animationId: "#a-visual" },
+    ]);
+    const kf = merged.find((k) => k.percentage === 45);
+    expect(kf?.easeAmbiguous).toBe(true);
+  });
+
+  it("flags a cross-animation collision even when the raw eases match", () => {
+    // The button can still only target one arbitrary animation, and each may
+    // inherit a different easeEach/animation ease that raw comparison misses.
+    const merged = deduplicateKeyframes([
+      { percentage: 45, properties: { x: 10 }, ease: "power2.in", animationId: "#a-position" },
+      { percentage: 45, properties: { opacity: 1 }, ease: "power2.in", animationId: "#a-visual" },
+    ]);
+    expect(merged.find((k) => k.percentage === 45)?.easeAmbiguous).toBe(true);
+  });
+
+  it("does not flag a same-% collision within a single animation", () => {
+    const merged = deduplicateKeyframes([
+      { percentage: 45, properties: { x: 10 }, ease: "power2.in", animationId: "#a-position" },
+      { percentage: 45, properties: { y: 20 }, ease: "power2.out", animationId: "#a-position" },
+    ]);
+    expect(merged.find((k) => k.percentage === 45)?.easeAmbiguous).toBeFalsy();
+  });
+});
diff --git a/packages/studio/src/hooks/gsapTweenSynth.ts b/packages/studio/src/hooks/gsapTweenSynth.ts
index edb849f28c..20daf0812f 100644
--- a/packages/studio/src/hooks/gsapTweenSynth.ts
+++ b/packages/studio/src/hooks/gsapTweenSynth.ts
@@ -5,14 +5,26 @@ import type {
 } from "@hyperframes/core/gsap-parser";
 import { PROPERTY_DEFAULTS } from "./gsapShared";
 
-export function deduplicateKeyframes(
-  keyframes: GsapPercentageKeyframe[],
-): GsapPercentageKeyframe[] {
-  const byPct = new Map<number, GsapPercentageKeyframe>();
+export function deduplicateKeyframes<
+  T extends GsapPercentageKeyframe & { animationId?: string; easeAmbiguous?: boolean },
+>(keyframes: T[]): T[] {
+  const byPct = new Map<number, T>();
   for (const kf of keyframes) {
     const existing = byPct.get(kf.percentage);
     if (existing) {
       existing.properties = { ...existing.properties, ...kf.properties };
+      // Two DIFFERENT source animations with a keyframe at the same clip %: a
+      // single inline ease button can only target one of them, and which one is
+      // arbitrary (each may also inherit a different easeEach/animation ease, so
+      // comparing raw keyframe eases isn't enough). Flag it so the collapsed row
+      // hides the button there and the user edits per-lane instead.
+      if (
+        existing.animationId !== undefined &&
+        kf.animationId !== undefined &&
+        existing.animationId !== kf.animationId
+      ) {
+        existing.easeAmbiguous = true;
+      }
       if (kf.ease) existing.ease = kf.ease;
     } else {
       byPct.set(kf.percentage, { ...kf, properties: { ...kf.properties } });
@@ -41,29 +53,40 @@ export function synthesizeFlatTweenKeyframes(anim: GsapAnimation): GsapKeyframes
   const fromProps = anim.fromProperties;
   if (!toProps || Object.keys(toProps).length === 0) return null;
 
-  const startProps: Record<string, number | string> = {};
-  const endProps: Record<string, number | string> = {};
+  const rawStart: Record<string, number | string> = {};
+  const rawEnd: Record<string, number | string> = {};
 
   if (anim.method === "from") {
     for (const [k, v] of Object.entries(toProps)) {
-      startProps[k] = v;
-      endProps[k] = PROPERTY_DEFAULTS[k] ?? 0;
+      rawStart[k] = v;
+      rawEnd[k] = PROPERTY_DEFAULTS[k] ?? 0;
     }
   } else if (anim.method === "fromTo" && fromProps) {
-    Object.assign(startProps, fromProps);
-    Object.assign(endProps, toProps);
+    Object.assign(rawStart, fromProps);
+    Object.assign(rawEnd, toProps);
   } else {
     for (const [k, v] of Object.entries(toProps)) {
-      startProps[k] = PROPERTY_DEFAULTS[k] ?? 0;
-      endProps[k] = v;
+      rawStart[k] = PROPERTY_DEFAULTS[k] ?? 0;
+      rawEnd[k] = v;
     }
   }
 
+  // Only numeric props are keyframe-interpolatable — a flat tween of a
+  // non-numeric prop (e.g. backgroundColor: "#fff") can't be a 2-keyframe lane.
+  const numericKeys = Object.keys(rawEnd).filter(
+    (k) => typeof rawStart[k] === "number" && typeof rawEnd[k] === "number",
+  );
+  if (numericKeys.length === 0) return null;
+  const startProps = Object.fromEntries(numericKeys.map((k) => [k, rawStart[k]]));
+  const endProps = Object.fromEntries(numericKeys.map((k) => [k, rawEnd[k]]));
+
   return {
     format: "percentage",
     keyframes: [
       { percentage: 0, properties: startProps },
-      { percentage: 100, properties: endProps },
+      // Segment ease lives on the destination keyframe (Figma/AE model) so the
+      // lane + cache surface it; also kept data-level for useGsapTweenCache.
+      { percentage: 100, properties: endProps, ...(anim.ease ? { ease: anim.ease } : {}) },
     ],
     ...(anim.ease ? { ease: anim.ease } : {}),
   };
diff --git a/packages/studio/src/hooks/useDomSelection.ts b/packages/studio/src/hooks/useDomSelection.ts
index 903894c7e9..568c964228 100644
--- a/packages/studio/src/hooks/useDomSelection.ts
+++ b/packages/studio/src/hooks/useDomSelection.ts
@@ -24,6 +24,7 @@ import {
   type DomEditSelection,
 } from "../components/editor/domEditing";
 import { reapplyPositionEditsAfterSeek } from "../components/editor/manualEdits";
+import { useStudioTestHooks } from "./useStudioTestHooks";
 
 // ── Types ──
 
@@ -506,6 +507,9 @@ export function useDomSelection({
     applyDomSelection(null, { revealPanel: false });
   }, [applyDomSelection, captionEditMode]);
 
+  // Dev-only headless-QA shortcut (window.__studioTest.selectByDomId). No-op in prod.
+  useStudioTestHooks({ previewIframeRef, buildDomSelectionFromTarget, applyDomSelection });
+
   const applyMarqueeSelection = useCallback(
     // fallow-ignore-next-line complexity
     (selections: DomEditSelection[], additive: boolean) => {
diff --git a/packages/studio/src/hooks/useGestureCommit.ts b/packages/studio/src/hooks/useGestureCommit.ts
index a0aba6747f..cdc51dcf97 100644
--- a/packages/studio/src/hooks/useGestureCommit.ts
+++ b/packages/studio/src/hooks/useGestureCommit.ts
@@ -13,7 +13,7 @@ import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import type { CommitMutationOptions } from "./gsapScriptCommitTypes";
 import { roundTo3 } from "../utils/rounding";
 import { classifyPropertyGroup } from "@hyperframes/core/gsap-parser";
-import { isInstantHold } from "./gsapShared";
+import { isInstantHold, idSelector } from "./gsapShared";
 
 type RecordedKeyframe = {
   percentage: number;
@@ -168,7 +168,7 @@ export function useGestureCommit({
         if (!sortedPcts.includes(0)) sortedPcts.unshift(0);
       }
 
-      const selector = sel.id ? `#${sel.id}` : sel.selector;
+      const selector = sel.id ? idSelector(sel.id) : sel.selector;
       if (!selector) {
         showToast("Cannot save — element has no selector", "error");
         return;
diff --git a/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx b/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
index e697ab6127..5e01b9e6da 100644
--- a/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
+++ b/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
@@ -19,11 +19,16 @@ afterEach(() => {
 
 const selection: DomEditSelection = { id: "box", selector: "#box" } as DomEditSelection;
 
+function successfulCommitMutation() {
+  return vi.fn<(...args: unknown[]) => Promise<unknown>>(async () => ({ ok: true }));
+}
+
 function renderKeyframeOps(over: {
   commitMutation: (...args: unknown[]) => Promise<unknown>;
   trackGsapSaveFailure: (...args: unknown[]) => void;
 }) {
   const captured: { api: HookApi | null } = { api: null };
+  // This hook harness intentionally mirrors the separate script-commit harness.
   function Probe() {
     // fallow-ignore-next-line code-duplication
     captured.api = useGsapKeyframeOps({
@@ -51,9 +56,7 @@ function renderKeyframeOps(over: {
 
 describe("useGsapKeyframeOps — resizeKeyframedTween", () => {
   it("issues a resize-keyframed-tween mutation with the remap + window", async () => {
-    const commitMutation = vi.fn<(...args: unknown[]) => Promise<unknown>>(async () => ({
-      ok: true,
-    }));
+    const commitMutation = successfulCommitMutation();
     const trackGsapSaveFailure = vi.fn<(...args: unknown[]) => void>();
     const api = renderKeyframeOps({ commitMutation, trackGsapSaveFailure });
 
@@ -102,10 +105,28 @@ describe("useGsapKeyframeOps — resizeKeyframedTween", () => {
 });
 
 describe("useGsapKeyframeOps — keyframe transaction options", () => {
+  it("routes a flat-lane add through the add-keyframe writer mutation", async () => {
+    const commitMutation = successfulCommitMutation();
+    const api = renderKeyframeOps({ commitMutation, trackGsapSaveFailure: vi.fn() });
+
+    await act(async () => {
+      await api.addKeyframeBatch(selection, "box-to-0-position", 50, { x: 210 });
+    });
+
+    expect(commitMutation).toHaveBeenCalledWith(
+      selection,
+      {
+        type: "add-keyframe",
+        animationId: "box-to-0-position",
+        percentage: 50,
+        properties: { x: 210 },
+      },
+      { label: "Add keyframe at 50%", softReload: true },
+    );
+  });
+
   it("soft-reloads a standalone convert when the SDK path is unavailable", async () => {
-    const commitMutation = vi.fn<(...args: unknown[]) => Promise<unknown>>(async () => ({
-      ok: true,
-    }));
+    const commitMutation = successfulCommitMutation();
     const api = renderKeyframeOps({ commitMutation, trackGsapSaveFailure: vi.fn() });
 
     await act(async () => {
@@ -123,9 +144,7 @@ describe("useGsapKeyframeOps — keyframe transaction options", () => {
   });
 
   it("threads one coalesce key through skipped convert reload and terminal batch edit", async () => {
-    const commitMutation = vi.fn<(...args: unknown[]) => Promise<unknown>>(async () => ({
-      ok: true,
-    }));
+    const commitMutation = successfulCommitMutation();
     const api = renderKeyframeOps({ commitMutation, trackGsapSaveFailure: vi.fn() });
     const coalesceKey = "enable-keyframes:box-to-0-opacity:1";
 
diff --git a/packages/studio/src/hooks/useGsapSelectionHandlers.ts b/packages/studio/src/hooks/useGsapSelectionHandlers.ts
index 0b11d760de..efde12caa5 100644
--- a/packages/studio/src/hooks/useGsapSelectionHandlers.ts
+++ b/packages/studio/src/hooks/useGsapSelectionHandlers.ts
@@ -173,8 +173,8 @@ export function useGsapSelectionHandlers({
   );
 
   const handleGsapDeleteAnimation = useCallback(
-    (animId: string) => {
-      const sel = domEditSelection ?? lastSelectionRef.current;
+    (animId: string, selectionOverride?: DomEditSelection | null) => {
+      const sel = selectionOverride ?? domEditSelection ?? lastSelectionRef.current;
       if (!sel) return;
       observeGsapMutation(deleteGsapAnimation(sel, animId), sel, "delete", "Delete GSAP animation");
     },
@@ -298,17 +298,15 @@ export function useGsapSelectionHandlers({
       percentage: number,
       properties: Record<string, number | string>,
       commitOverrides?: Partial<CommitMutationOptions>,
+      selectionOverride?: DomEditSelection | null,
     ) => {
-      if (!domEditSelection) return Promise.resolve();
-      return addKeyframeBatch(
-        domEditSelection,
-        animId,
-        percentage,
-        properties,
-        commitOverrides,
-      ).catch((error) => {
-        trackGsapHandlerFailure(error, domEditSelection, "add-keyframe", "Add keyframe");
-      });
+      const sel = selectionOverride ?? domEditSelection ?? lastSelectionRef.current;
+      if (!sel) return Promise.resolve();
+      return addKeyframeBatch(sel, animId, percentage, properties, commitOverrides).catch(
+        (error) => {
+          trackGsapHandlerFailure(error, sel, "add-keyframe", "Add keyframe");
+        },
+      );
     },
     [domEditSelection, addKeyframeBatch, trackGsapHandlerFailure],
   );
diff --git a/packages/studio/src/hooks/useGsapTweenCache.ts b/packages/studio/src/hooks/useGsapTweenCache.ts
index 226ec4c194..6a8e9d5481 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.ts
@@ -6,6 +6,7 @@ import { readRuntimeKeyframes, scanAllRuntimeKeyframes } from "./gsapRuntimeBrid
 import {
   clearKeyframeCacheForElement,
   clearKeyframeCacheForFile,
+  writeGsapAnimationsForElement,
 } from "./gsapKeyframeCacheHelpers";
 import { toAbsoluteTime } from "./gsapShared";
 import { deduplicateKeyframes, synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
@@ -328,6 +329,12 @@ export function useGsapAnimationsForElement(
   // fallow-ignore-next-line complexity
   useEffect(() => {
     if (!elementId) return;
+    const sourceAnimations = animations.filter(
+      (animation) =>
+        animation.propertyGroup && (animation.keyframes || synthesizeFlatTweenKeyframes(animation)),
+    );
+    if (sourceAnimations.length > 0)
+      writeGsapAnimationsForElement(sourceFile, elementId, sourceAnimations);
 
     // Resolve the element's time range from the player store so we can
     // convert tween-relative keyframe percentages to clip-relative ones.
@@ -340,7 +347,11 @@ export function useGsapAnimationsForElement(
     );
 
     const allKeyframes: Array<
-      GsapKeyframesData["keyframes"][0] & { tweenPercentage?: number; propertyGroup?: string }
+      GsapKeyframesData["keyframes"][0] & {
+        tweenPercentage?: number;
+        propertyGroup?: string;
+        animationId?: string;
+      }
     > = [];
     let format: GsapKeyframesData["format"] = "percentage";
     let ease: string | undefined;
@@ -378,6 +389,7 @@ export function useGsapAnimationsForElement(
           percentage: clipPct,
           tweenPercentage: k.percentage,
           propertyGroup: anim.propertyGroup,
+          animationId: anim.id,
         });
       }
       format = kf.format;
@@ -459,6 +471,7 @@ export function usePopulateKeyframeCacheForFile(
       const { elements, domClipChildren } = usePlayerStore.getState();
       const doc = iframeRef?.current?.contentDocument;
       const mergedByElement = new Map<string, GsapKeyframesData>();
+      const sourceByElement = new Map<string, GsapAnimation[]>();
       for (const anim of parsed.animations) {
         if (anim.hasUnresolvedKeyframes) continue;
         // Position-only static holds are not keyframed animations — skip them so
@@ -479,12 +492,16 @@ export function usePopulateKeyframeCacheForFile(
         // Attribute the tween to every element it animates (handles class /
         // group / descendant selectors, not just `#id`).
         for (const id of resolveSelectorElementIds(anim.targetSelector, doc)) {
+          // kfData is already resolved (real keyframes OR a synthesized flat
+          // tween), so a grouped flat tween joins the store like a keyframed one.
+          if (anim.propertyGroup) {
+            sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
+          }
           const { elStart, elDuration } = resolveClipTimingBasis(id, sf, elements, domClipChildren);
           const clipKeyframes = kfData.keyframes.map((kf) => {
             const absTime = toAbsoluteTime(tweenPos, tweenDur, kf.percentage);
-            // 0.001% precision (matching useGsapAnimationsForElement above) so a
-            // beat-snapped keyframe centers exactly on the beat dot and the two
-            // caches agree on a keyframe's percentage.
+            // 0.001% precision (see useGsapAnimationsForElement) so a beat-snapped
+            // keyframe centers on the beat dot and both caches agree.
             const clipPct =
               elDuration > 0
                 ? Math.round(((absTime - elStart) / elDuration) * 100000) / 1000
@@ -494,6 +511,7 @@ export function usePopulateKeyframeCacheForFile(
               percentage: clipPct,
               tweenPercentage: kf.percentage,
               propertyGroup: anim.propertyGroup,
+              animationId: anim.id, // parity with other cache writers; inline ease needs it
             };
           });
           const existing = mergedByElement.get(id);
@@ -508,6 +526,7 @@ export function usePopulateKeyframeCacheForFile(
         setKeyframeCache(`${sf}#${id}`, kfData);
         setKeyframeCache(id, kfData);
         if (sf !== "index.html") setKeyframeCache(`index.html#${id}`, kfData);
+        writeGsapAnimationsForElement(sf, id, sourceByElement.get(id));
       }
       astFetchDoneRef.current = fetchKey;
     });
diff --git a/packages/studio/src/hooks/useStudioTestHooks.ts b/packages/studio/src/hooks/useStudioTestHooks.ts
new file mode 100644
index 0000000000..a00e01a455
--- /dev/null
+++ b/packages/studio/src/hooks/useStudioTestHooks.ts
@@ -0,0 +1,51 @@
+import { useEffect } from "react";
+import type { DomEditSelection } from "../components/editor/domEditing";
+
+interface StudioTestHookDeps {
+  previewIframeRef: React.MutableRefObject<HTMLIFrameElement | null>;
+  buildDomSelectionFromTarget: (target: HTMLElement) => Promise<DomEditSelection | null>;
+  applyDomSelection: (
+    selection: DomEditSelection | null,
+    options?: { revealPanel?: boolean },
+  ) => void;
+}
+
+/**
+ * Dev-only headless-QA shortcut. Selecting an element normally requires a
+ * pixel-precise click inside the preview iframe, which automated verification
+ * can't reliably land. `window.__studioTest.selectByDomId(id)` resolves the
+ * DomEditSelection for a preview element by id and reveals the inspector —
+ * exactly what a click does — so a driver can open the property/ease panels and
+ * then focus a segment via `__playerStore.getState().setFocusedEaseSegment`.
+ * No-op in production builds.
+ */
+export function useStudioTestHooks({
+  previewIframeRef,
+  buildDomSelectionFromTarget,
+  applyDomSelection,
+}: StudioTestHookDeps): void {
+  // eslint-disable-next-line no-restricted-syntax
+  useEffect(() => {
+    let isDev = false;
+    try {
+      isDev = import.meta.env.DEV === true;
+    } catch {
+      isDev = false;
+    }
+    if (!isDev || typeof window === "undefined") return;
+    const api = {
+      selectByDomId: async (id: string): Promise<boolean> => {
+        const element = previewIframeRef.current?.contentDocument?.getElementById(id) ?? null;
+        if (!element) return false;
+        const selection = await buildDomSelectionFromTarget(element);
+        if (!selection) return false;
+        applyDomSelection(selection, { revealPanel: true });
+        return true;
+      },
+    };
+    (window as unknown as { __studioTest?: typeof api }).__studioTest = api;
+    return () => {
+      (window as unknown as { __studioTest?: typeof api }).__studioTest = undefined;
+    };
+  }, [applyDomSelection, buildDomSelectionFromTarget, previewIframeRef]);
+}
diff --git a/packages/studio/src/player/store/keyframeSlice.ts b/packages/studio/src/player/store/keyframeSlice.ts
new file mode 100644
index 0000000000..f219983bce
--- /dev/null
+++ b/packages/studio/src/player/store/keyframeSlice.ts
@@ -0,0 +1,109 @@
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import type { StoreApi } from "zustand";
+
+/** Minimal keyframe cache types — mirrors GsapKeyframesData without pulling in Node-only gsap-parser. */
+export interface KeyframeCacheEntry {
+  format: string;
+  keyframes: Array<{
+    percentage: number;
+    /** Original tween-relative percentage (server mutations need this, not the clip-relative `percentage`). */
+    tweenPercentage?: number;
+    /** Which property group the source tween belongs to (position, scale, rotation, visual, etc.). */
+    propertyGroup?: string;
+    /** Source tween id — lets the inline clip-row ease button target a specific segment. */
+    animationId?: string;
+    properties: Record<string, number | string>;
+    ease?: string;
+    /** Set when 2+ source animations collide at this percentage (a single inline
+     *  ease button can't target one): the collapsed row hides the button here. */
+    easeAmbiguous?: boolean;
+  }>;
+  ease?: string;
+  easeEach?: string;
+}
+
+export interface KeyframeSlice {
+  /** Selected collapsed (`element:pct`) or expanded (`element:group:animation:clipPct`) diamonds. */
+  selectedKeyframes: Set<string>;
+  toggleSelectedKeyframe: (key: string) => void;
+  clearSelectedKeyframes: () => void;
+
+  /** Clips whose keyframe property lanes are expanded in the timeline. */
+  expandedClipIds: Set<string>;
+  toggleClipExpanded: (id: string) => void;
+  setClipExpanded: (id: string, expanded: boolean) => void;
+  /** Union-expand clips (keyframed clips are expanded by default on load). */
+  expandClips: (ids: readonly string[]) => void;
+
+  /** elementId scopes the request to one element so a shared (class-selector)
+   * animation id can't open the ease editor on the wrong element. */
+  focusedEaseSegment: { animationId: string; tweenPercentage: number; elementId: string } | null;
+  setFocusedEaseSegment: (
+    target: { animationId: string; tweenPercentage: number; elementId: string } | null,
+  ) => void;
+
+  /** Keyframe data per element id, populated from parsed GSAP animations. */
+  keyframeCache: Map<string, KeyframeCacheEntry>;
+  /** Unmerged source tweens per element; expanded property lanes read this, never keyframeCache. */
+  gsapAnimations: Map<string, GsapAnimation[]>;
+  setGsapAnimations: (elementId: string, animations: GsapAnimation[] | undefined) => void;
+  setKeyframeCache: (elementId: string, data: KeyframeCacheEntry | undefined) => void;
+}
+
+export function createKeyframeSlice(set: StoreApi<KeyframeSlice>["setState"]): KeyframeSlice {
+  return {
+    selectedKeyframes: new Set(),
+    toggleSelectedKeyframe: (key) =>
+      set((state) => {
+        const next = new Set(state.selectedKeyframes);
+        if (next.has(key)) next.delete(key);
+        else next.add(key);
+        return { selectedKeyframes: next };
+      }),
+    clearSelectedKeyframes: () => set({ selectedKeyframes: new Set() }),
+
+    expandedClipIds: new Set(),
+    toggleClipExpanded: (id) =>
+      set((state) => {
+        const next = new Set(state.expandedClipIds);
+        if (next.has(id)) next.delete(id);
+        else next.add(id);
+        return { expandedClipIds: next };
+      }),
+    setClipExpanded: (id, expanded) =>
+      set((state) => {
+        if (state.expandedClipIds.has(id) === expanded) return state;
+        const next = new Set(state.expandedClipIds);
+        if (expanded) next.add(id);
+        else next.delete(id);
+        return { expandedClipIds: next };
+      }),
+    expandClips: (ids) =>
+      set((state) => {
+        if (ids.every((id) => state.expandedClipIds.has(id))) return state;
+        const next = new Set(state.expandedClipIds);
+        for (const id of ids) next.add(id);
+        return { expandedClipIds: next };
+      }),
+
+    focusedEaseSegment: null,
+    setFocusedEaseSegment: (target) => set({ focusedEaseSegment: target }),
+
+    keyframeCache: new Map(),
+    setKeyframeCache: (elementId, data) =>
+      set((state) => {
+        const next = new Map(state.keyframeCache);
+        if (data) next.set(elementId, data);
+        else next.delete(elementId);
+        return { keyframeCache: next };
+      }),
+    gsapAnimations: new Map(),
+    setGsapAnimations: (elementId, animations) =>
+      set((state) => {
+        const next = new Map(state.gsapAnimations);
+        if (animations) next.set(elementId, animations);
+        else next.delete(elementId);
+        return { gsapAnimations: next };
+      }),
+  };
+}
diff --git a/packages/studio/src/player/store/playerStore.test.ts b/packages/studio/src/player/store/playerStore.test.ts
index ed86efaa36..1eb3f72c56 100644
--- a/packages/studio/src/player/store/playerStore.test.ts
+++ b/packages/studio/src/player/store/playerStore.test.ts
@@ -25,6 +25,31 @@ describe("usePlayerStore", () => {
       expect(state.loopEnabled).toBe(false);
       expect(state.zoomMode).toBe("fit");
       expect(state.manualZoomPercent).toBe(100);
+      expect(state.expandedClipIds).toEqual(new Set());
+    });
+  });
+
+  describe("expandedClipIds", () => {
+    it("toggles clip membership", () => {
+      const store = usePlayerStore.getState();
+
+      store.toggleClipExpanded("clip-1");
+      expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set(["clip-1"]));
+
+      store.toggleClipExpanded("clip-1");
+      expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set());
+    });
+
+    it("sets clip membership idempotently", () => {
+      const store = usePlayerStore.getState();
+
+      store.setClipExpanded("clip-1", true);
+      store.setClipExpanded("clip-1", true);
+      expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set(["clip-1"]));
+
+      store.setClipExpanded("clip-1", false);
+      store.setClipExpanded("clip-1", false);
+      expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set());
     });
   });
 
diff --git a/packages/studio/src/player/store/playerStore.ts b/packages/studio/src/player/store/playerStore.ts
index 54b75a5c30..faf3776b5a 100644
--- a/packages/studio/src/player/store/playerStore.ts
+++ b/packages/studio/src/player/store/playerStore.ts
@@ -4,22 +4,9 @@ import type { BeatEditState } from "../../utils/beatEditing";
 import type { ClipManifestClip } from "../lib/playbackTypes";
 import { readStudioUiPreferences, writeStudioUiPreferences } from "../../utils/studioUiPreferences";
 import { computePinnedZoomPercent } from "../components/timelineZoom";
+import { createKeyframeSlice, type KeyframeSlice } from "./keyframeSlice";
 
-/** Minimal keyframe cache types — mirrors GsapKeyframesData without pulling in Node-only gsap-parser. */
-export interface KeyframeCacheEntry {
-  format: string;
-  keyframes: Array<{
-    percentage: number;
-    /** Original tween-relative percentage (server mutations need this, not the clip-relative `percentage`). */
-    tweenPercentage?: number;
-    /** Which property group the source tween belongs to (position, scale, rotation, visual, etc.). */
-    propertyGroup?: string;
-    properties: Record<string, number | string>;
-    ease?: string;
-  }>;
-  ease?: string;
-  easeEach?: string;
-}
+export type { KeyframeCacheEntry } from "./keyframeSlice";
 
 export interface TimelineElement {
   id: string;
@@ -109,7 +96,7 @@ function resolveElementSelection(
   };
 }
 
-interface PlayerState {
+interface PlayerState extends KeyframeSlice {
   isPlaying: boolean;
   currentTime: number;
   duration: number;
@@ -140,11 +127,6 @@ interface PlayerState {
   activeTool: TimelineTool;
   setActiveTool: (tool: TimelineTool) => void;
 
-  /** Set of selected keyframe keys in format `${elementId}:${percentage}`. */
-  selectedKeyframes: Set<string>;
-  toggleSelectedKeyframe: (key: string) => void;
-  clearSelectedKeyframes: () => void;
-
   /** Tween-relative percentage of the last-clicked keyframe diamond. Operations
    *  (drag, resize, rotate) target this instead of recomputing from playhead. */
   activeKeyframePct: number | null;
@@ -193,10 +175,6 @@ interface PlayerState {
   toggleSelectedElementId: (id: string) => void;
   clearSelection: () => void;
 
-  /** Keyframe data per element id, populated from parsed GSAP animations. */
-  keyframeCache: Map<string, KeyframeCacheEntry>;
-  setKeyframeCache: (elementId: string, data: KeyframeCacheEntry | undefined) => void;
-
   setIsPlaying: (playing: boolean) => void;
   setCurrentTime: (time: number) => void;
   setDuration: (duration: number) => void;
@@ -327,15 +305,7 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
   activeTool: "select",
   setActiveTool: (tool) => set({ activeTool: tool }),
 
-  selectedKeyframes: new Set(),
-  toggleSelectedKeyframe: (key) =>
-    set((s) => {
-      const next = new Set(s.selectedKeyframes);
-      if (next.has(key)) next.delete(key);
-      else next.add(key);
-      return { selectedKeyframes: next };
-    }),
-  clearSelectedKeyframes: () => set({ selectedKeyframes: new Set() }),
+  ...createKeyframeSlice(set),
 
   activeKeyframePct: null,
   setActiveKeyframePct: (pct) => set({ activeKeyframePct: pct }),
@@ -363,15 +333,6 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
     }),
   clearSelection: () => set({ selectedElementId: null, selectedElementIds: new Set() }),
 
-  keyframeCache: new Map(),
-  setKeyframeCache: (elementId, data) =>
-    set((s) => {
-      const next = new Map(s.keyframeCache);
-      if (data) next.set(elementId, data);
-      else next.delete(elementId);
-      return { keyframeCache: next };
-    }),
-
   requestedSeekTime: null,
   requestSeek: (time) => set({ requestedSeekTime: time }),
   clearSeekRequest: () => set({ requestedSeekTime: null }),
@@ -569,9 +530,11 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
       outPoint: null,
       activeTool: "select",
       selectedKeyframes: new Set(),
+      expandedClipIds: new Set(),
       selectedElementIds: new Set(),
       clipRevealRequest: null,
       keyframeCache: new Map(),
+      gsapAnimations: new Map(),
       beatAnalysis: null,
       beatEdits: null,
       beatUndo: [],
diff --git a/packages/studio/src/telemetry/events.test.ts b/packages/studio/src/telemetry/events.test.ts
index ad4e7f1401..d930adaba1 100644
--- a/packages/studio/src/telemetry/events.test.ts
+++ b/packages/studio/src/telemetry/events.test.ts
@@ -12,6 +12,7 @@ const {
   trackStudioRenderStart,
   trackStudioRazorSplit,
   trackStudioExpandedClipEdit,
+  trackStudioKeyframeLaneExpand,
   trackStudioSegmentEaseEdit,
   trackStudioFeedback,
 } = await import("./events");
@@ -72,8 +73,13 @@ describe("studio telemetry events", () => {
     expect(trackEvent).toHaveBeenCalledWith("studio_expanded_clip_edit", { action: "resize" });
   });
 
+  it("trackStudioKeyframeLaneExpand emits 'studio_keyframe_lane_expand' with expanded", () => {
+    trackStudioKeyframeLaneExpand({ expanded: true });
+    expect(trackEvent).toHaveBeenCalledWith("studio_keyframe_lane_expand", { expanded: true });
+  });
+
   it("trackStudioSegmentEaseEdit emits 'studio_segment_ease_edit' with action and ease", () => {
-    trackStudioSegmentEaseEdit({ ease: "power2.out" });
+    trackStudioSegmentEaseEdit({ action: "commit", ease: "power2.out" });
     expect(trackEvent).toHaveBeenCalledWith("studio_segment_ease_edit", {
       action: "commit",
       ease: "power2.out",
diff --git a/packages/studio/src/telemetry/events.ts b/packages/studio/src/telemetry/events.ts
index b73d008029..ecc80e9bfd 100644
--- a/packages/studio/src/telemetry/events.ts
+++ b/packages/studio/src/telemetry/events.ts
@@ -63,9 +63,17 @@ export function trackStudioExpandedClipEdit(props: {
   trackEvent("studio_expanded_clip_edit", { action: props.action });
 }
 
-// Adoption signal for committing an edit to a segment's ease.
-export function trackStudioSegmentEaseEdit(props: { ease: string }): void {
-  trackEvent("studio_segment_ease_edit", { action: "commit", ease: props.ease });
+// Adoption signal for the per-clip keyframe-lane caret toggle.
+export function trackStudioKeyframeLaneExpand(props: { expanded: boolean }): void {
+  trackEvent("studio_keyframe_lane_expand", { expanded: props.expanded });
+}
+
+// Adoption signal for opening and committing the per-segment ease editor.
+export function trackStudioSegmentEaseEdit(props: {
+  action: "open" | "commit";
+  ease?: string;
+}): void {
+  trackEvent("studio_segment_ease_edit", { action: props.action, ease: props.ease });
 }
 
 export function trackStudioFeedback(props: { rating: number; comment?: string }): void {

From e34e529720376685f640559fc71b53c042afb7ea Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 22:48:00 +0200
Subject: [PATCH 063/125] fix(studio): keep gsapAnimations in sync with the
 keyframe cache

An ungrouped tween (mixed property groups classify to propertyGroup
undefined) fed keyframeCache but was skipped by every gsapAnimations
writer, so the collapsed row drew diamonds the expanded lanes had no
source animation to render. Drop the property-group gate at all three
writers; lane consumers already filter by group.

Also route the same-percentage merge in updateKeyframeCacheFromParsed
through deduplicateKeyframes so the easeAmbiguous rule has one owner.
---
 .../hooks/gsapKeyframeCacheHelpers.test.ts    | 24 ++++++++++++
 .../src/hooks/gsapKeyframeCacheHelpers.ts     | 37 ++++++-------------
 .../studio/src/hooks/useGsapTweenCache.ts     | 12 +++---
 3 files changed, 41 insertions(+), 32 deletions(-)

diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
index ee72035f5e..7ac1ac2ce4 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
@@ -195,6 +195,30 @@ describe("updateKeyframeCacheFromParsed", () => {
     expect(usePlayerStore.getState().gsapAnimations.get("scene.html#box")).toEqual([animation]);
   });
 
+  it("records an ungrouped tween in gsapAnimations too, so the two stores agree", () => {
+    // `{ x, opacity }` spans two property groups, so the parser leaves
+    // propertyGroup undefined. Skipping it here used to cache diamonds with no
+    // source animation behind them: the collapsed row drew keyframes the
+    // expanded lanes could not render.
+    const animation: GsapAnimation = {
+      id: "mixed-box",
+      targetSelector: "#box",
+      method: "to",
+      position: 0,
+      properties: { x: 100, opacity: 0 },
+      duration: 1,
+      resolvedStart: 0,
+    };
+    usePlayerStore.setState({
+      elements: [{ id: "box-clip", domId: "box", tag: "div", start: 0, duration: 1, track: 0 }],
+    });
+
+    updateKeyframeCacheFromParsed([animation], "scene.html", "box", {});
+
+    expect(cache().has("scene.html#box")).toBe(true);
+    expect(usePlayerStore.getState().gsapAnimations.get("scene.html#box")).toEqual([animation]);
+  });
+
   it("does not cache a flat tween without animatable numeric properties", () => {
     const animation: GsapAnimation = {
       id: "flat-box",
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index 58da5c7aae..d65ef1b988 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -5,7 +5,7 @@
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { usePlayerStore, type KeyframeCacheEntry } from "../player/store/playerStore";
 import { toAbsoluteTime } from "./gsapShared";
-import { synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
+import { deduplicateKeyframes, synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
 
 export function updateKeyframeCacheFromParsed(
   animations: GsapAnimation[],
@@ -23,9 +23,12 @@ export function updateKeyframeCacheFromParsed(
       anim.keyframes?.keyframes ?? synthesizeFlatTweenKeyframes(anim)?.keyframes ?? [];
     if (!id || kfSource.length === 0) continue;
     idsWithKeyframes.add(id);
-    if (anim.propertyGroup) {
-      sourceAnimations.set(id, [...(sourceAnimations.get(id) ?? []), anim]);
-    }
+    // Every tween that fed keyframeCache also lands in gsapAnimations, group or
+    // not: a mixed-group tween (`{ x, opacity }` classifies to undefined) used to
+    // cache diamonds with no source animation behind them, so the collapsed row
+    // drew keyframes the expanded lanes couldn't render. Lane consumers do the
+    // group filtering themselves (animationContributesLane).
+    sourceAnimations.set(id, [...(sourceAnimations.get(id) ?? []), anim]);
 
     // Convert tween-relative percentages to clip-relative so diamonds
     // render at the correct position within the timeline clip.
@@ -51,28 +54,10 @@ export function updateKeyframeCacheFromParsed(
 
     const existing = merged.get(id);
     if (existing) {
-      const byPct = new Map<number, (typeof existing.keyframes)[0]>();
-      for (const kf of [...existing.keyframes, ...clipKeyframes]) {
-        const prev = byPct.get(kf.percentage);
-        if (prev) {
-          prev.properties = { ...prev.properties, ...kf.properties };
-          // Mirror deduplicateKeyframes: a same-% collision across different
-          // source animations is an ambiguous merged segment (the button can
-          // only target one arbitrary animation). Flag it so the collapsed row
-          // suppresses the inline ease button there.
-          if (
-            prev.animationId !== undefined &&
-            kf.animationId !== undefined &&
-            prev.animationId !== kf.animationId
-          ) {
-            prev.easeAmbiguous = true;
-          }
-          if (kf.ease) prev.ease = kf.ease;
-        } else {
-          byPct.set(kf.percentage, { ...kf, properties: { ...kf.properties } });
-        }
-      }
-      existing.keyframes = Array.from(byPct.values()).sort((a, b) => a.percentage - b.percentage);
+      // deduplicateKeyframes owns the same-% merge (including the easeAmbiguous
+      // flag downstream lanes read); a second copy of that rule here is how the
+      // two writers drift.
+      existing.keyframes = deduplicateKeyframes([...existing.keyframes, ...clipKeyframes]);
     } else {
       merged.set(id, {
         ...anim.keyframes,
diff --git a/packages/studio/src/hooks/useGsapTweenCache.ts b/packages/studio/src/hooks/useGsapTweenCache.ts
index 6a8e9d5481..feac2efacc 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.ts
@@ -329,9 +329,9 @@ export function useGsapAnimationsForElement(
   // fallow-ignore-next-line complexity
   useEffect(() => {
     if (!elementId) return;
+    // No property-group filter: ungrouped tweens are recorded here as well.
     const sourceAnimations = animations.filter(
-      (animation) =>
-        animation.propertyGroup && (animation.keyframes || synthesizeFlatTweenKeyframes(animation)),
+      (animation) => animation.keyframes || synthesizeFlatTweenKeyframes(animation),
     );
     if (sourceAnimations.length > 0)
       writeGsapAnimationsForElement(sourceFile, elementId, sourceAnimations);
@@ -493,10 +493,10 @@ export function usePopulateKeyframeCacheForFile(
         // group / descendant selectors, not just `#id`).
         for (const id of resolveSelectorElementIds(anim.targetSelector, doc)) {
           // kfData is already resolved (real keyframes OR a synthesized flat
-          // tween), so a grouped flat tween joins the store like a keyframed one.
-          if (anim.propertyGroup) {
-            sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
-          }
+          // tween), so a flat tween joins the store like a keyframed one. No
+          // property-group filter: this map must cover every tween the cache
+          // below records, or expanded lanes have nothing to render.
+          sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
           const { elStart, elDuration } = resolveClipTimingBasis(id, sf, elements, domClipChildren);
           const clipKeyframes = kfData.keyframes.map((kf) => {
             const absTime = toAbsoluteTime(tweenPos, tweenDur, kf.percentage);

From acf6766ed8bc80e5a309b4b034c528999eb011bb Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 00:51:19 +0200
Subject: [PATCH 064/125] refactor(studio): one owner for clip-relative
 keyframe rows

Each keyframe-cache writer re-derived a clip-relative percentage inline, and the
post-commit writer rounded to 0.1% while the others used 0.001%. Selection keys
embed that number, so a commit-time rewrite could orphan a live key.
toClipPercentage owns the rounding, toClipKeyframes owns the whole row (percentage
plus the tween percentage and animation identity the lanes read), and the parsed
write reuses elementCacheKeys instead of open-coding the three key variants.
---
 .../src/hooks/gsapKeyframeCacheHelpers.ts     | 28 +++-------
 packages/studio/src/hooks/gsapShared.test.ts  | 21 +++++++-
 packages/studio/src/hooks/gsapShared.ts       | 51 +++++++++++++++++++
 .../studio/src/hooks/useGsapTweenCache.ts     | 29 ++---------
 4 files changed, 82 insertions(+), 47 deletions(-)

diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index d65ef1b988..d6a1e3a82b 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -4,7 +4,7 @@
  */
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { usePlayerStore, type KeyframeCacheEntry } from "../player/store/playerStore";
-import { toAbsoluteTime } from "./gsapShared";
+import { toClipKeyframes } from "./gsapShared";
 import { deduplicateKeyframes, synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
 
 export function updateKeyframeCacheFromParsed(
@@ -32,25 +32,15 @@ export function updateKeyframeCacheFromParsed(
 
     // Convert tween-relative percentages to clip-relative so diamonds
     // render at the correct position within the timeline clip.
-    const tweenPos = anim.resolvedStart ?? (typeof anim.position === "number" ? anim.position : 0);
-    const tweenDur = anim.duration ?? 1;
     const timelineEl = elements.find(
       (el) => el.domId === id || (el.key ?? el.id) === `${targetPath}#${id}`,
     );
-    const elStart = timelineEl?.start ?? 0;
-    const elDuration = timelineEl?.duration ?? 1;
-    const clipKeyframes = kfSource.map((kf) => {
-      const absTime = toAbsoluteTime(tweenPos, tweenDur, kf.percentage);
-      const clipPct =
-        elDuration > 0 ? Math.round(((absTime - elStart) / elDuration) * 1000) / 10 : kf.percentage;
-      return {
-        ...kf,
-        percentage: clipPct,
-        tweenPercentage: kf.percentage,
-        propertyGroup: anim.propertyGroup,
-        animationId: anim.id,
-      };
-    });
+    const clipKeyframes = toClipKeyframes(
+      kfSource,
+      anim,
+      timelineEl?.start ?? 0,
+      timelineEl?.duration ?? 1,
+    );
 
     const existing = merged.get(id);
     if (existing) {
@@ -67,9 +57,7 @@ export function updateKeyframeCacheFromParsed(
     }
   }
   for (const [id, entry] of merged) {
-    setKeyframeCache(`${targetPath}#${id}`, entry);
-    setKeyframeCache(id, entry);
-    if (targetPath !== "index.html") setKeyframeCache(`index.html#${id}`, entry);
+    for (const key of elementCacheKeys(targetPath, id)) setKeyframeCache(key, entry);
     writeGsapAnimationsForElement(targetPath, id, sourceAnimations.get(id));
   }
   const targetId =
diff --git a/packages/studio/src/hooks/gsapShared.test.ts b/packages/studio/src/hooks/gsapShared.test.ts
index 30ed300a07..1d3fc8f360 100644
--- a/packages/studio/src/hooks/gsapShared.test.ts
+++ b/packages/studio/src/hooks/gsapShared.test.ts
@@ -1,6 +1,11 @@
 import { describe, it, expect } from "vitest";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
-import { idSelector, isInstantHold, parsePercentageKeyframes } from "./gsapShared";
+import {
+  idSelector,
+  isInstantHold,
+  parsePercentageKeyframes,
+  toClipPercentage,
+} from "./gsapShared";
 
 describe("isInstantHold", () => {
   const animation = (method: GsapAnimation["method"], duration?: number) =>
@@ -103,3 +108,17 @@ describe("idSelector", () => {
     }
   });
 });
+
+describe("toClipPercentage", () => {
+  // Selection keys embed this number, so every keyframe-cache writer has to round
+  // it identically: a coarser writer rewrites the cache with a different value and
+  // orphans the live selection key built from the finer one.
+  it("keeps three decimals so a beat-snapped keyframe lands on its beat", () => {
+    expect(toClipPercentage(1 / 3, 0, 1, 0)).toBe(33.333);
+    expect(toClipPercentage(2.5, 2, 4, 0)).toBe(12.5);
+  });
+
+  it("passes the tween percentage through for a zero-length clip", () => {
+    expect(toClipPercentage(5, 0, 0, 42)).toBe(42);
+  });
+});
diff --git a/packages/studio/src/hooks/gsapShared.ts b/packages/studio/src/hooks/gsapShared.ts
index 629e5976d1..fdfcc0aae9 100644
--- a/packages/studio/src/hooks/gsapShared.ts
+++ b/packages/studio/src/hooks/gsapShared.ts
@@ -216,3 +216,54 @@ export function parsePercentageKeyframes(
 export function toAbsoluteTime(tweenPos: number, tweenDur: number, percentage: number): number {
   return tweenPos + (percentage / 100) * tweenDur;
 }
+
+/**
+ * An absolute time as a percentage of a timeline clip, at the one precision every
+ * keyframe-cache writer must share. 0.001% keeps a beat-snapped keyframe centered
+ * on the beat dot, and because selection keys embed this number, a writer that
+ * rounds coarser would orphan a live selection the moment it rewrites the cache.
+ * A zero-length clip has no percentage to give, so the tween-% passes through.
+ */
+export function toClipPercentage(
+  absoluteTime: number,
+  clipStart: number,
+  clipDuration: number,
+  fallbackPercentage: number,
+): number {
+  if (clipDuration <= 0) return fallbackPercentage;
+  return Math.round(((absoluteTime - clipStart) / clipDuration) * 100000) / 1000;
+}
+
+/**
+ * One keyframe-cache row per tween keyframe: the percentage re-based onto the
+ * clip, the original tween percentage kept alongside it, and the animation
+ * identity every lane and selection key needs. Shared by the cache writers so
+ * they cannot drift in precision or in which identity fields they record.
+ */
+export function toClipKeyframes<T extends { percentage: number }>(
+  source: readonly T[],
+  anim: GsapAnimation,
+  clipStart: number,
+  clipDuration: number,
+): Array<
+  T & {
+    tweenPercentage: number;
+    propertyGroup: GsapAnimation["propertyGroup"];
+    animationId: string;
+  }
+> {
+  const tweenStart = anim.resolvedStart ?? (typeof anim.position === "number" ? anim.position : 0);
+  const tweenDuration = anim.duration ?? 1;
+  return source.map((keyframe) => ({
+    ...keyframe,
+    percentage: toClipPercentage(
+      toAbsoluteTime(tweenStart, tweenDuration, keyframe.percentage),
+      clipStart,
+      clipDuration,
+      keyframe.percentage,
+    ),
+    tweenPercentage: keyframe.percentage,
+    propertyGroup: anim.propertyGroup,
+    animationId: anim.id,
+  }));
+}
diff --git a/packages/studio/src/hooks/useGsapTweenCache.ts b/packages/studio/src/hooks/useGsapTweenCache.ts
index feac2efacc..766b0f39cc 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.ts
@@ -8,7 +8,7 @@ import {
   clearKeyframeCacheForFile,
   writeGsapAnimationsForElement,
 } from "./gsapKeyframeCacheHelpers";
-import { toAbsoluteTime } from "./gsapShared";
+import { toAbsoluteTime, toClipPercentage, toClipKeyframes } from "./gsapShared";
 import { deduplicateKeyframes, synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
 
 function extractIdFromSelector(selector: string): string | null {
@@ -378,12 +378,7 @@ export function useGsapAnimationsForElement(
       const tweenDur = anim.duration ?? elDuration;
       for (const k of kf.keyframes) {
         const absTime = toAbsoluteTime(tweenPos, tweenDur, k.percentage);
-        // 0.001% precision (was 0.1%) so a beat-snapped keyframe centers exactly
-        // on the beat dot, which is rendered at the true beat time.
-        const clipPct =
-          elDuration > 0
-            ? Math.round(((absTime - elStart) / elDuration) * 100000) / 1000
-            : k.percentage;
+        const clipPct = toClipPercentage(absTime, elStart, elDuration, k.percentage);
         allKeyframes.push({
           ...k,
           percentage: clipPct,
@@ -486,9 +481,6 @@ export function usePopulateKeyframeCacheForFile(
         }
         const kfData = anim.keyframes ?? synthesizeFlatTweenKeyframes(anim);
         if (!kfData) continue;
-        const tweenPos =
-          anim.resolvedStart ?? (typeof anim.position === "number" ? anim.position : 0);
-        const tweenDur = anim.duration ?? 1;
         // Attribute the tween to every element it animates (handles class /
         // group / descendant selectors, not just `#id`).
         for (const id of resolveSelectorElementIds(anim.targetSelector, doc)) {
@@ -498,22 +490,7 @@ export function usePopulateKeyframeCacheForFile(
           // below records, or expanded lanes have nothing to render.
           sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
           const { elStart, elDuration } = resolveClipTimingBasis(id, sf, elements, domClipChildren);
-          const clipKeyframes = kfData.keyframes.map((kf) => {
-            const absTime = toAbsoluteTime(tweenPos, tweenDur, kf.percentage);
-            // 0.001% precision (see useGsapAnimationsForElement) so a beat-snapped
-            // keyframe centers on the beat dot and both caches agree.
-            const clipPct =
-              elDuration > 0
-                ? Math.round(((absTime - elStart) / elDuration) * 100000) / 1000
-                : kf.percentage;
-            return {
-              ...kf,
-              percentage: clipPct,
-              tweenPercentage: kf.percentage,
-              propertyGroup: anim.propertyGroup,
-              animationId: anim.id, // parity with other cache writers; inline ease needs it
-            };
-          });
+          const clipKeyframes = toClipKeyframes(kfData.keyframes, anim, elStart, elDuration);
           const existing = mergedByElement.get(id);
           if (existing) {
             existing.keyframes = deduplicateKeyframes([...existing.keyframes, ...clipKeyframes]);

From d05ecb10910ec463370a3561d3b3868b5e94b287 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 02:13:38 +0200
Subject: [PATCH 065/125] fix(studio): scope the per-file keyframe-cache clear
 to its own keys

R3 review follow-ups on the keyframe cache:

- clearKeyframeCacheForFile collected ids from the index.html alias prefix
  too, so a re-scan of one composition file wiped rows a sibling file had
  just written (several files re-scan concurrently). Only the file's own
  prefixed keys name the ids now; clearKeyframeCacheForElement still takes
  the alias and bare key with them.
- toClipKeyframes fell back to a fixed 1s tween duration, which put a
  duration-less tween's keyframes at a percentage no edit path agreed with.
  It now spans the clip, matching resolveEditableTweenDuration.
- collectAnimatableKeyframeProperties takes `object` so call sites drop
  their `as Record<string, unknown>` casts.

Regression tests cover both fixes.
---
 .../hooks/gsapKeyframeCacheHelpers.test.ts    | 14 +++++++++++
 .../src/hooks/gsapKeyframeCacheHelpers.ts     | 20 ++++++++--------
 packages/studio/src/hooks/gsapShared.test.ts  | 24 +++++++++++++++++++
 packages/studio/src/hooks/gsapShared.ts       | 13 +++++-----
 4 files changed, 55 insertions(+), 16 deletions(-)

diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
index 7ac1ac2ce4..9bc45eec22 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
@@ -84,6 +84,20 @@ describe("clearKeyframeCacheForFile", () => {
     }
   });
 
+  // Several composition files re-scan concurrently, so a clear that walked the
+  // index.html alias would delete rows a sibling file had just written.
+  it("leaves an index.html-owned element alone when another file re-scans", () => {
+    seed("index.html#title");
+    seed("title");
+    seed("comp.html#a");
+
+    clearKeyframeCacheForFile("comp.html");
+
+    expect(cache().has("index.html#title")).toBe(true);
+    expect(cache().has("title")).toBe(true);
+    expect(cache().has("comp.html#a")).toBe(false);
+  });
+
   it("leaves entries that belong to a different source file", () => {
     seed("comp.html#a");
     seed("a");
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index d6a1e3a82b..f9953f9fcd 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -92,22 +92,22 @@ export function clearKeyframeCacheForElement(sourceFile: string, elementId: stri
 
 /**
  * Clear every cached element of `sourceFile` before a full re-scan repopulates
- * it. Collects the element ids that currently have a prefixed or index.html
- * fallback key for the file and drops each through clearKeyframeCacheForElement
- * so the bare key goes too — an element whose keyframes were removed (and so is
- * absent from the re-scan) leaves no stale bare entry behind.
+ * it. Only the file's OWN prefixed keys name the ids to clear: every write sets
+ * the prefixed key (see elementCacheKeys), so the file's elements are all
+ * reachable that way, and clearKeyframeCacheForElement then takes the
+ * index.html alias and the bare key with them — an element whose keyframes were
+ * removed (and so is absent from the re-scan) leaves no stale bare entry
+ * behind. Reading the alias prefix here instead would collect ids owned by
+ * OTHER files, and several files re-scan concurrently, so this file's clear
+ * would wipe the entries a sibling file had just written.
  */
 export function clearKeyframeCacheForFile(sourceFile: string): void {
   const { keyframeCache, gsapAnimations } = usePlayerStore.getState();
   const sfPrefix = `${sourceFile}#`;
-  const fallbackPrefix = "index.html#";
   const ids = new Set<string>();
   for (const key of [...keyframeCache.keys(), ...gsapAnimations.keys()]) {
-    const matchesFile =
-      key.startsWith(sfPrefix) || (sourceFile !== "index.html" && key.startsWith(fallbackPrefix));
-    if (!matchesFile) continue;
-    const hashIdx = key.indexOf("#");
-    if (hashIdx !== -1) ids.add(key.slice(hashIdx + 1));
+    if (!key.startsWith(sfPrefix)) continue;
+    ids.add(key.slice(sfPrefix.length));
   }
   for (const id of ids) {
     clearKeyframeCacheForElement(sourceFile, id);
diff --git a/packages/studio/src/hooks/gsapShared.test.ts b/packages/studio/src/hooks/gsapShared.test.ts
index 1d3fc8f360..144dcfb7c7 100644
--- a/packages/studio/src/hooks/gsapShared.test.ts
+++ b/packages/studio/src/hooks/gsapShared.test.ts
@@ -4,6 +4,7 @@ import {
   idSelector,
   isInstantHold,
   parsePercentageKeyframes,
+  toClipKeyframes,
   toClipPercentage,
 } from "./gsapShared";
 
@@ -122,3 +123,26 @@ describe("toClipPercentage", () => {
     expect(toClipPercentage(5, 0, 0, 42)).toBe(42);
   });
 });
+
+describe("toClipKeyframes", () => {
+  const durationless: GsapAnimation = {
+    id: "a1",
+    method: "to",
+    targetSelector: "#box",
+    vars: {},
+    resolvedStart: 0,
+  } as GsapAnimation;
+
+  // A tween with no duration spans its clip everywhere else in Studio
+  // (resolveEditableTweenDuration), so the cache rows have to agree: a fixed 1s
+  // basis put the end keyframe at 25% of a 4s clip instead of 100%.
+  it("spans the clip when the tween has no duration", () => {
+    const rows = toClipKeyframes([{ percentage: 0 }, { percentage: 100 }], durationless, 0, 4);
+    expect(rows.map((row) => row.percentage)).toEqual([0, 100]);
+  });
+
+  it("keeps the tween percentage and the animation identity on every row", () => {
+    const rows = toClipKeyframes([{ percentage: 50 }], durationless, 0, 4);
+    expect(rows[0]).toMatchObject({ tweenPercentage: 50, animationId: "a1" });
+  });
+});
diff --git a/packages/studio/src/hooks/gsapShared.ts b/packages/studio/src/hooks/gsapShared.ts
index fdfcc0aae9..4780d74074 100644
--- a/packages/studio/src/hooks/gsapShared.ts
+++ b/packages/studio/src/hooks/gsapShared.ts
@@ -145,9 +145,7 @@ export interface ParsedPercentageKeyframes {
   easeEach?: string;
 }
 
-function collectAnimatableKeyframeProperties(
-  entry: Record<string, unknown>,
-): Record<string, number | string> {
+function collectAnimatableKeyframeProperties(entry: object): Record<string, number | string> {
   const properties: Record<string, number | string> = {};
   for (const [property, value] of Object.entries(entry)) {
     if (property === "ease") continue;
@@ -185,7 +183,7 @@ export function parsePercentageKeyframes(
     steps.forEach((entry, i) => {
       if (!entry || typeof entry !== "object") return;
       const percentage = steps.length > 1 ? Math.round((i / (steps.length - 1)) * 1000) / 10 : 0;
-      const properties = collectAnimatableKeyframeProperties(entry as Record<string, unknown>);
+      const properties = collectAnimatableKeyframeProperties(entry);
       if (Object.keys(properties).length > 0) keyframes.push({ percentage, properties });
     });
     return keyframes.length > 0 ? { keyframes } : null;
@@ -199,7 +197,7 @@ export function parsePercentageKeyframes(
     const pctMatch = key.match(/^(\d+(?:\.\d+)?)%$/);
     if (!pctMatch || !val || typeof val !== "object") continue;
     const percentage = parseFloat(pctMatch[1]);
-    const properties = collectAnimatableKeyframeProperties(val as Record<string, unknown>);
+    const properties = collectAnimatableKeyframeProperties(val);
     if (Object.keys(properties).length > 0) {
       keyframes.push({ percentage, properties });
     }
@@ -253,7 +251,10 @@ export function toClipKeyframes<T extends { percentage: number }>(
   }
 > {
   const tweenStart = anim.resolvedStart ?? (typeof anim.position === "number" ? anim.position : 0);
-  const tweenDuration = anim.duration ?? 1;
+  // A duration-less tween spans the clip, the same rule the edit paths use
+  // (resolveEditableTweenDuration). A fixed 1s here put its keyframes at a
+  // percentage no editor agreed with.
+  const tweenDuration = anim.duration ?? clipDuration;
   return source.map((keyframe) => ({
     ...keyframe,
     percentage: toClipPercentage(

From 3c7400af890aae0140f7bf577bd002eb05050319 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 27 Jul 2026 19:02:21 +0200
Subject: [PATCH 066/125] fix(studio): close the review findings in this PR
 instead of at the stack tip

The R1/R3 residuals on this PR were fixed at the top of the stack, so they
only cleared once every branch above landed. They belong here, next to the
code they correct:

- `idFromSelector` inverts `idSelector` for both regex readers, so the
  post-commit cache refresh stops skipping the CSS-unsafe ids `idSelector`
  exists to support.
- `deduplicateKeyframes` drops `ease` when it is ambiguous; the flag was the
  only honest answer and the last-writer-wins curve belonged to an arbitrary
  colliding tween.
- `isStaticPositionHold` is now the single owner of the hold skip. The
  `sourceAnimations` filter and the `allKeyframes` filter had diverged on
  whether `immediateRender` counts as a property.
- The keyframe-cache setters no-op when the write changes nothing, instead of
  handing every subscriber a fresh Map.
- `reset()` clears `focusedEaseSegment`.
- The test hook `delete`s its window key rather than setting it to undefined,
  so feature detection still works.
- The `toClipKeyframes` fixture uses `as unknown as T` with the justification
  CONTRIBUTING.md asks for.
---
 .../src/hooks/gsapKeyframeCacheHelpers.ts     |  7 ++---
 packages/studio/src/hooks/gsapShared.test.ts  | 22 ++++++++++++--
 packages/studio/src/hooks/gsapShared.ts       | 21 +++++++++++++
 packages/studio/src/hooks/gsapTweenSynth.ts   | 26 +++++++++++++++-
 .../studio/src/hooks/useGsapTweenCache.ts     | 30 +++++--------------
 .../studio/src/hooks/useStudioTestHooks.ts    |  4 ++-
 .../studio/src/player/store/keyframeSlice.ts  | 13 ++++++++
 .../studio/src/player/store/playerStore.ts    |  1 +
 8 files changed, 93 insertions(+), 31 deletions(-)

diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index f9953f9fcd..1e806a0298 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -4,7 +4,7 @@
  */
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { usePlayerStore, type KeyframeCacheEntry } from "../player/store/playerStore";
-import { toClipKeyframes } from "./gsapShared";
+import { idFromSelector, toClipKeyframes } from "./gsapShared";
 import { deduplicateKeyframes, synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
 
 export function updateKeyframeCacheFromParsed(
@@ -18,7 +18,7 @@ export function updateKeyframeCacheFromParsed(
   const merged = new Map<string, KeyframeCacheEntry>();
   const sourceAnimations = new Map<string, GsapAnimation[]>();
   for (const anim of animations) {
-    const id = anim.targetSelector.match(/^#([\w-]+)/)?.[1];
+    const id = idFromSelector(anim.targetSelector);
     const kfSource =
       anim.keyframes?.keyframes ?? synthesizeFlatTweenKeyframes(anim)?.keyframes ?? [];
     if (!id || kfSource.length === 0) continue;
@@ -61,8 +61,7 @@ export function updateKeyframeCacheFromParsed(
     writeGsapAnimationsForElement(targetPath, id, sourceAnimations.get(id));
   }
   const targetId =
-    (mutation as { targetSelector?: string }).targetSelector?.match(/^#([\w-]+)/)?.[1] ??
-    selectionId;
+    idFromSelector((mutation as { targetSelector?: string }).targetSelector) ?? selectionId;
   if (targetId && !idsWithKeyframes.has(targetId)) {
     clearKeyframeCacheForElement(targetPath, targetId);
   }
diff --git a/packages/studio/src/hooks/gsapShared.test.ts b/packages/studio/src/hooks/gsapShared.test.ts
index 144dcfb7c7..0fb17bfb74 100644
--- a/packages/studio/src/hooks/gsapShared.test.ts
+++ b/packages/studio/src/hooks/gsapShared.test.ts
@@ -1,6 +1,7 @@
 import { describe, it, expect } from "vitest";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import {
+  idFromSelector,
   idSelector,
   isInstantHold,
   parsePercentageKeyframes,
@@ -125,13 +126,16 @@ describe("toClipPercentage", () => {
 });
 
 describe("toClipKeyframes", () => {
-  const durationless: GsapAnimation = {
+  // Fixture carries only the fields the function under test reads; the
+  // double-cast is the documented way to stand in for the full runtime shape
+  // (CONTRIBUTING.md).
+  const durationless = {
     id: "a1",
     method: "to",
     targetSelector: "#box",
     vars: {},
     resolvedStart: 0,
-  } as GsapAnimation;
+  } as unknown as GsapAnimation;
 
   // A tween with no duration spans its clip everywhere else in Studio
   // (resolveEditableTweenDuration), so the cache rows have to agree: a fixed 1s
@@ -146,3 +150,17 @@ describe("toClipKeyframes", () => {
     expect(rows[0]).toMatchObject({ tweenPercentage: 50, animationId: "a1" });
   });
 });
+
+describe("idFromSelector", () => {
+  it("round-trips every shape idSelector emits", () => {
+    for (const id of ["hero-word", "el_1", "01-hook-hero-word", "my.class", "1box", '1"x']) {
+      expect(idFromSelector(idSelector(id))).toBe(id);
+    }
+  });
+
+  it("returns null for a selector that does not address an id", () => {
+    expect(idFromSelector(".dot")).toBeNull();
+    expect(idFromSelector("[data-hf-id='x']")).toBeNull();
+    expect(idFromSelector(undefined)).toBeNull();
+  });
+});
diff --git a/packages/studio/src/hooks/gsapShared.ts b/packages/studio/src/hooks/gsapShared.ts
index 4780d74074..906b984196 100644
--- a/packages/studio/src/hooks/gsapShared.ts
+++ b/packages/studio/src/hooks/gsapShared.ts
@@ -80,6 +80,27 @@ export function idSelector(id: string): string {
   return SAFE_HASH_ID.test(id) ? `#${id}` : `[id="${id.replace(/(["\\])/g, "\\$1")}"]`;
 }
 
+/**
+ * Inverse of {@link idSelector}: the element id a target selector addresses, or
+ * null for a selector that is not id-based (a class, a tag, a descendant path).
+ *
+ * Both shapes have to be read back, not just `#id`. Every writer emits through
+ * `idSelector`, so a digit-leading, dotted or otherwise CSS-unsafe id lands in
+ * the source as `[id="01-hook-hero"]`. A reader that only matched `#id` saw no
+ * id at all for those elements and skipped them — which is how the post-commit
+ * keyframe-cache refresh silently stopped running for exactly the ids
+ * `idSelector` was added to support.
+ */
+export function idFromSelector(selector: string | undefined | null): string | null {
+  if (!selector) return null;
+  const hash = selector.match(/^#([\w-]+)/);
+  if (hash) return hash[1] ?? null;
+  const attribute = selector.match(/^\[id="((?:\\.|[^"\\])*)"\]/);
+  if (!attribute) return null;
+  // Undo the quote/backslash escaping idSelector applies.
+  return (attribute[1] ?? "").replace(/\\(["\\])/g, "$1");
+}
+
 export function selectorFromSelection(selection: DomEditSelection): string | null {
   if (selection.id) return idSelector(selection.id);
   if (selection.selector) return selection.selector;
diff --git a/packages/studio/src/hooks/gsapTweenSynth.ts b/packages/studio/src/hooks/gsapTweenSynth.ts
index 20daf0812f..a3b100be4d 100644
--- a/packages/studio/src/hooks/gsapTweenSynth.ts
+++ b/packages/studio/src/hooks/gsapTweenSynth.ts
@@ -5,6 +5,23 @@ import type {
 } from "@hyperframes/core/gsap-parser";
 import { PROPERTY_DEFAULTS } from "./gsapShared";
 
+/**
+ * A static position hold (only x/y, no real motion) is a `set`, not a keyframe —
+ * it must not synthesize a diamond. Covers both `tl.set(...)` and the
+ * `tl.to({ duration: 0, immediateRender: true })` hold that remove-all-keyframes
+ * collapses to (otherwise shown as a stray 0% keyframe).
+ *
+ * Single owner: the collapsed keyframe cache and the expanded property lanes'
+ * `gsapAnimations` map MUST agree on it, or a hold draws a phantom expanded lane
+ * with no matching collapsed diamond.
+ */
+export function isStaticPositionHold(anim: GsapAnimation): boolean {
+  if (anim.keyframes) return false;
+  if (anim.method !== "set" && (anim.duration ?? 0) !== 0) return false;
+  const propKeys = Object.keys(anim.properties).filter((k) => k !== "immediateRender");
+  return propKeys.length > 0 && propKeys.every((k) => k === "x" || k === "y");
+}
+
 export function deduplicateKeyframes<
   T extends GsapPercentageKeyframe & { animationId?: string; easeAmbiguous?: boolean },
 >(keyframes: T[]): T[] {
@@ -25,7 +42,14 @@ export function deduplicateKeyframes<
       ) {
         existing.easeAmbiguous = true;
       }
-      if (kf.ease) existing.ease = kf.ease;
+      // Whichever tween iterated last used to win `ease`, so the merged
+      // keyframe carried an arbitrary one of the colliding curves. Readers that
+      // do not check easeAmbiguous (drag readouts, lane hints) then showed a
+      // curve belonging to a different animation than the one an edit targets.
+      // Drop it instead: ambiguous means "no single ease", and the flag is the
+      // only honest answer.
+      if (existing.easeAmbiguous) delete existing.ease;
+      else if (kf.ease) existing.ease = kf.ease;
     } else {
       byPct.set(kf.percentage, { ...kf, properties: { ...kf.properties } });
     }
diff --git a/packages/studio/src/hooks/useGsapTweenCache.ts b/packages/studio/src/hooks/useGsapTweenCache.ts
index 766b0f39cc..c1ae295b45 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.ts
@@ -9,7 +9,11 @@ import {
   writeGsapAnimationsForElement,
 } from "./gsapKeyframeCacheHelpers";
 import { toAbsoluteTime, toClipPercentage, toClipKeyframes } from "./gsapShared";
-import { deduplicateKeyframes, synthesizeFlatTweenKeyframes } from "./gsapTweenSynth";
+import {
+  deduplicateKeyframes,
+  isStaticPositionHold,
+  synthesizeFlatTweenKeyframes,
+} from "./gsapTweenSynth";
 
 function extractIdFromSelector(selector: string): string | null {
   const match = selector.match(/^#([\w-]+)/);
@@ -357,18 +361,7 @@ export function useGsapAnimationsForElement(
     let ease: string | undefined;
     let easeEach: string | undefined;
     for (const anim of animations) {
-      // A static position hold (only x/y, no real motion) is a `set`, not a
-      // keyframe — don't synthesize a diamond for it. Covers both `tl.set(...)`
-      // and the `tl.to({ duration: 0, immediateRender: true })` hold that
-      // remove-all-keyframes collapses to (which is otherwise shown as a stray
-      // 0% keyframe).
-      if (
-        !anim.keyframes &&
-        Object.keys(anim.properties).length > 0 &&
-        Object.keys(anim.properties).every((k) => k === "x" || k === "y") &&
-        (anim.method === "set" || (anim.duration ?? 0) === 0)
-      )
-        continue;
+      if (isStaticPositionHold(anim)) continue;
       const kf = anim.keyframes ?? synthesizeFlatTweenKeyframes(anim);
       if (!kf) continue;
       // Convert tween-relative percentages to clip-relative so diamonds
@@ -469,16 +462,7 @@ export function usePopulateKeyframeCacheForFile(
       const sourceByElement = new Map<string, GsapAnimation[]>();
       for (const anim of parsed.animations) {
         if (anim.hasUnresolvedKeyframes) continue;
-        // Position-only static holds are not keyframed animations — skip them so
-        // they don't draw a timeline diamond. Covers both a `tl.set(...)` and the
-        // `tl.to({ duration: 0, immediateRender: true })` that remove-all-keyframes
-        // collapses a keyframed tween to.
-        if (!anim.keyframes && (anim.method === "set" || (anim.duration ?? 0) === 0)) {
-          const propKeys = Object.keys(anim.properties).filter((k) => k !== "immediateRender");
-          if (propKeys.length > 0 && propKeys.every((k) => k === "x" || k === "y")) {
-            continue;
-          }
-        }
+        if (isStaticPositionHold(anim)) continue;
         const kfData = anim.keyframes ?? synthesizeFlatTweenKeyframes(anim);
         if (!kfData) continue;
         // Attribute the tween to every element it animates (handles class /
diff --git a/packages/studio/src/hooks/useStudioTestHooks.ts b/packages/studio/src/hooks/useStudioTestHooks.ts
index a00e01a455..3453d0be8f 100644
--- a/packages/studio/src/hooks/useStudioTestHooks.ts
+++ b/packages/studio/src/hooks/useStudioTestHooks.ts
@@ -45,7 +45,9 @@ export function useStudioTestHooks({
     };
     (window as unknown as { __studioTest?: typeof api }).__studioTest = api;
     return () => {
-      (window as unknown as { __studioTest?: typeof api }).__studioTest = undefined;
+      // delete, not `= undefined`: an own key holding undefined keeps
+      // `"__studioTest" in window` true, which defeats feature detection.
+      delete (window as unknown as { __studioTest?: typeof api }).__studioTest;
     };
   }, [applyDomSelection, buildDomSelectionFromTarget, previewIframeRef]);
 }
diff --git a/packages/studio/src/player/store/keyframeSlice.ts b/packages/studio/src/player/store/keyframeSlice.ts
index f219983bce..7a97d986ce 100644
--- a/packages/studio/src/player/store/keyframeSlice.ts
+++ b/packages/studio/src/player/store/keyframeSlice.ts
@@ -92,6 +92,13 @@ export function createKeyframeSlice(set: StoreApi<KeyframeSlice>["setState"]): K
     keyframeCache: new Map(),
     setKeyframeCache: (elementId, data) =>
       set((state) => {
+        // A write that changes nothing must not emit a new Map: the cache has
+        // several hot writers (per-element effect, file populate, post-commit
+        // updater, delete) and every no-op re-rendered every subscriber.
+        if (
+          data ? state.keyframeCache.get(elementId) === data : !state.keyframeCache.has(elementId)
+        )
+          return state;
         const next = new Map(state.keyframeCache);
         if (data) next.set(elementId, data);
         else next.delete(elementId);
@@ -100,6 +107,12 @@ export function createKeyframeSlice(set: StoreApi<KeyframeSlice>["setState"]): K
     gsapAnimations: new Map(),
     setGsapAnimations: (elementId, animations) =>
       set((state) => {
+        if (
+          animations
+            ? state.gsapAnimations.get(elementId) === animations
+            : !state.gsapAnimations.has(elementId)
+        )
+          return state;
         const next = new Map(state.gsapAnimations);
         if (animations) next.set(elementId, animations);
         else next.delete(elementId);
diff --git a/packages/studio/src/player/store/playerStore.ts b/packages/studio/src/player/store/playerStore.ts
index faf3776b5a..e8c101c8fd 100644
--- a/packages/studio/src/player/store/playerStore.ts
+++ b/packages/studio/src/player/store/playerStore.ts
@@ -531,6 +531,7 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
       activeTool: "select",
       selectedKeyframes: new Set(),
       expandedClipIds: new Set(),
+      focusedEaseSegment: null,
       selectedElementIds: new Set(),
       clipRevealRequest: null,
       keyframeCache: new Map(),

From b386b55f735a0217751e26245fbf677c8ff5d303 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 27 Jul 2026 19:09:16 +0200
Subject: [PATCH 067/125] fix(studio): clamp the timeline scrub to 0 instead of
 dropping it

Dragging the playhead to the start of the composition needed a very slow
drag. The scrub surface begins GUTTER + TRACKS_LEFT_PAD px right of the
viewport edge, and both scrub paths bailed out when the pointer sat left of
that origin rather than clamping. So the last 80px of the drag toward zero
silently did nothing: the playhead stuck at whatever the last in-range sample
reported, and only a drag slow enough to sample inside the thin sliver before
the origin ever reached 0.

Both paths now share getTimelineScrubTime, which clamps to [0, duration]. One
owner, so the live-feedback path and the committed-seek path cannot disagree
about the edge again.
---
 .../player/components/timelineLayout.test.ts  | 44 +++++++++++++++++++
 .../src/player/components/timelineLayout.ts   | 23 ++++++++++
 .../player/components/useTimelinePlayhead.ts  | 11 +++--
 .../components/useTimelineRangeSelection.ts   | 16 ++++---
 4 files changed, 85 insertions(+), 9 deletions(-)

diff --git a/packages/studio/src/player/components/timelineLayout.test.ts b/packages/studio/src/player/components/timelineLayout.test.ts
index 3642dea953..dde3a5cfc8 100644
--- a/packages/studio/src/player/components/timelineLayout.test.ts
+++ b/packages/studio/src/player/components/timelineLayout.test.ts
@@ -7,6 +7,7 @@ import {
   GUTTER,
   TRACKS_LEFT_PAD,
   getTimelineRowTop,
+  getTimelineScrubTime,
   getTimelineRowFromY,
   getTimelineCanvasHeight,
   resolveTimelineAssetDrop,
@@ -105,3 +106,46 @@ describe("track-area breathing pad y-math", () => {
     });
   });
 });
+
+describe("getTimelineScrubTime", () => {
+  const at = (clientX: number, duration = 10) =>
+    getTimelineScrubTime({
+      clientX,
+      viewportLeft: 0,
+      scrollLeft: 0,
+      pixelsPerSecond: 100,
+      duration,
+    });
+  const origin = GUTTER + TRACKS_LEFT_PAD;
+
+  it("maps the content origin to t=0", () => {
+    expect(at(origin)).toBe(0);
+    expect(at(origin + 250)).toBe(2.5);
+  });
+
+  // The bug: a pointer left of the origin used to abort the scrub instead of
+  // clamping, so dragging the playhead to the start only worked if a sample
+  // happened to land in the few px before t=0.
+  it("clamps a pointer left of the origin to 0 instead of dropping the scrub", () => {
+    expect(at(origin - 1)).toBe(0);
+    expect(at(origin - 500)).toBe(0);
+    expect(at(0)).toBe(0);
+  });
+
+  it("clamps past the end to the duration", () => {
+    expect(at(origin + 5000)).toBe(10);
+  });
+
+  it("returns 0 for a degenerate zoom or duration", () => {
+    expect(
+      getTimelineScrubTime({
+        clientX: 500,
+        viewportLeft: 0,
+        scrollLeft: 0,
+        pixelsPerSecond: 0,
+        duration: 10,
+      }),
+    ).toBe(0);
+    expect(at(origin + 250, Number.NaN)).toBe(0);
+  });
+});
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index c2326734f3..9a1b51108e 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -321,6 +321,29 @@ export function getTimelinePlayheadLeft(time: number, pixelsPerSecond: number):
   );
 }
 
+/**
+ * Inverse of {@link getTimelinePlayheadLeft}: the scrub time under a viewport
+ * clientX. Clamped to [0, duration], NOT rejected — the scrub surface starts
+ * `GUTTER + TRACKS_LEFT_PAD` px right of the viewport edge, so any pointer left
+ * of t=0 maps to a negative offset. Callers used to bail on that instead of
+ * clamping, which made the last 80px of the drag to zero silently do nothing:
+ * the playhead stuck wherever the last in-range sample landed, and only a very
+ * slow drag that happened to sample inside the sliver before the origin reached
+ * 0. Every scrub path shares this so they cannot diverge on the edge again.
+ */
+export function getTimelineScrubTime(input: {
+  clientX: number;
+  viewportLeft: number;
+  scrollLeft: number;
+  pixelsPerSecond: number;
+  duration: number;
+}): number {
+  const { clientX, viewportLeft, scrollLeft, pixelsPerSecond, duration } = input;
+  if (!(pixelsPerSecond > 0) || !Number.isFinite(duration)) return 0;
+  const x = clientX - viewportLeft + scrollLeft - GUTTER - TRACKS_LEFT_PAD;
+  return Math.max(0, Math.min(duration, x / pixelsPerSecond));
+}
+
 export function getTimelineCanvasHeight(trackCount: number): number {
   // RULER_H + top pad + lanes + bottom pad. The old TIMELINE_SCROLL_BUFFER is
   // subsumed by TRACKS_BOTTOM_PAD (which is larger), so the drag-into-void space
diff --git a/packages/studio/src/player/components/useTimelinePlayhead.ts b/packages/studio/src/player/components/useTimelinePlayhead.ts
index 6706c0f7b3..f7c3ab6b30 100644
--- a/packages/studio/src/player/components/useTimelinePlayhead.ts
+++ b/packages/studio/src/player/components/useTimelinePlayhead.ts
@@ -6,6 +6,7 @@ import {
   GUTTER,
   TRACKS_LEFT_PAD,
   getTimelinePlayheadLeft,
+  getTimelineScrubTime,
   getTimelineScrollLeftForZoomTransition,
   getTimelineScrollLeftForZoomAnchor,
   shouldAutoScrollTimeline,
@@ -130,9 +131,13 @@ export function useTimelinePlayhead({
       const el = scrollRef.current;
       if (!el || effectiveDuration <= 0) return;
       const rect = el.getBoundingClientRect();
-      const x = clientX - rect.left + el.scrollLeft - GUTTER - TRACKS_LEFT_PAD;
-      if (x < 0) return;
-      const time = Math.max(0, Math.min(effectiveDuration, x / pps));
+      const time = getTimelineScrubTime({
+        clientX,
+        viewportLeft: rect.left,
+        scrollLeft: el.scrollLeft,
+        pixelsPerSecond: pps,
+        duration: effectiveDuration,
+      });
       liveTime.notify(time);
       onSeek?.(time);
     },
diff --git a/packages/studio/src/player/components/useTimelineRangeSelection.ts b/packages/studio/src/player/components/useTimelineRangeSelection.ts
index 1df2a74fee..6edc0ff443 100644
--- a/packages/studio/src/player/components/useTimelineRangeSelection.ts
+++ b/packages/studio/src/player/components/useTimelineRangeSelection.ts
@@ -7,7 +7,7 @@ import {
 } from "./timelineEditing";
 import type { TimelineElement } from "../store/playerStore";
 import { liveTime, usePlayerStore } from "../store/playerStore";
-import { GUTTER, TRACKS_LEFT_PAD } from "./timelineLayout";
+import { GUTTER, TRACKS_LEFT_PAD, getTimelineScrubTime } from "./timelineLayout";
 import {
   computeMarqueeSelection,
   getMarqueeRect,
@@ -286,11 +286,15 @@ export function useTimelineRangeSelection({
       const el = scrollRef.current;
       if (el) {
         const rect = el.getBoundingClientRect();
-        const x = clientX - rect.left + el.scrollLeft - GUTTER - TRACKS_LEFT_PAD;
-        if (x >= 0) {
-          const dur = el.scrollWidth / pps;
-          liveTime.notify(Math.max(0, Math.min(dur, x / pps)));
-        }
+        liveTime.notify(
+          getTimelineScrubTime({
+            clientX,
+            viewportLeft: rect.left,
+            scrollLeft: el.scrollLeft,
+            pixelsPerSecond: pps,
+            duration: el.scrollWidth / pps,
+          }),
+        );
       }
       if (!seekRafRef.current) {
         seekRafRef.current = requestAnimationFrame(() => {

From 521bba64370c54d3f7eb5bc435d694b51666e9b2 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 27 Jul 2026 19:51:51 +0200
Subject: [PATCH 068/125] refactor(studio): resolve tween selector ids through
 the shared reader

The local extractIdFromSelector duplicated the `#id`-only regex that
idFromSelector replaced, so both DOM-less paths in
resolveSelectorElementIds (no-iframe fallback and querySelectorAll-throw
recovery) read no id at all for the bracketed `[id="..."]` form writers
emit for CSS-unsafe ids. Deleted the duplicate and imported the shared
reader; both forms now resolve.
---
 .../studio/src/hooks/useGsapTweenCache.test.ts  | 16 ++++++++++++++++
 packages/studio/src/hooks/useGsapTweenCache.ts  | 17 +++++++----------
 2 files changed, 23 insertions(+), 10 deletions(-)

diff --git a/packages/studio/src/hooks/useGsapTweenCache.test.ts b/packages/studio/src/hooks/useGsapTweenCache.test.ts
index d9ff5d4a02..0492a1f501 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.test.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.test.ts
@@ -90,4 +90,20 @@ describe("resolveSelectorElementIds", () => {
     expect(resolveSelectorElementIds("#card .label", null)).toEqual(["card"]);
     expect(resolveSelectorElementIds(".dot", null)).toEqual([]);
   });
+
+  // The `[id="…"]` form is what writers emit for a CSS-unsafe id (digit-leading,
+  // dotted). The old local `#id`-only regex read no id at all for those, so they
+  // silently dropped out of both DOM-less paths.
+  it("falls back to a bracketed id when there is no DOM", () => {
+    expect(resolveSelectorElementIds('[id="01-hook"] .label', null)).toEqual(["01-hook"]);
+  });
+
+  it("falls back to a bracketed id when querySelectorAll rejects the selector", () => {
+    const doc = {
+      querySelectorAll: () => {
+        throw new SyntaxError("bad selector");
+      },
+    } as unknown as Document;
+    expect(resolveSelectorElementIds('[id="01-hook"]:has(>*)', doc)).toEqual(["01-hook"]);
+  });
 });
diff --git a/packages/studio/src/hooks/useGsapTweenCache.ts b/packages/studio/src/hooks/useGsapTweenCache.ts
index c1ae295b45..8ec8481738 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.ts
@@ -8,25 +8,22 @@ import {
   clearKeyframeCacheForFile,
   writeGsapAnimationsForElement,
 } from "./gsapKeyframeCacheHelpers";
-import { toAbsoluteTime, toClipPercentage, toClipKeyframes } from "./gsapShared";
+import { idFromSelector, toAbsoluteTime, toClipPercentage, toClipKeyframes } from "./gsapShared";
 import {
   deduplicateKeyframes,
   isStaticPositionHold,
   synthesizeFlatTweenKeyframes,
 } from "./gsapTweenSynth";
 
-function extractIdFromSelector(selector: string): string | null {
-  const match = selector.match(/^#([\w-]+)/);
-  return match ? match[1] : null;
-}
-
 /**
  * Resolve a tween's target selector to the ids of the element(s) it animates.
  * A bare `#id` resolves directly; anything else (a class like `.dot`, a group
  * `.a, .b`, or a descendant selector) is matched against the live preview DOM so
  * class/selector tweens (e.g. `gsap.from(".dot", {stagger})`) attribute to every
- * element they animate — not just one parsed from the string. Falls back to a
- * leading `#id` when there's no DOM (so the cache still populates pre-iframe).
+ * element they animate — not just one parsed from the string. Falls back to the
+ * leading id when there's no DOM (so the cache still populates pre-iframe);
+ * `idFromSelector` reads both `#id` and the `[id="…"]` form writers emit for
+ * CSS-unsafe ids, so those elements resolve pre-iframe too.
  */
 // fallow-ignore-next-line complexity
 export function resolveSelectorElementIds(
@@ -36,7 +33,7 @@ export function resolveSelectorElementIds(
   const bareId = selector.match(/^#([\w-]+)$/);
   if (bareId) return [bareId[1]];
   if (!doc) {
-    const lead = extractIdFromSelector(selector);
+    const lead = idFromSelector(selector);
     return lead ? [lead] : [];
   }
   const ids = new Set<string>();
@@ -48,7 +45,7 @@ export function resolveSelectorElementIds(
         if (el.id) ids.add(el.id);
       }
     } catch {
-      const lead = extractIdFromSelector(sel);
+      const lead = idFromSelector(sel);
       if (lead) ids.add(lead);
     }
   }

From d518972f8b2b5c163875cd5d99c4ef6f0fce2113 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 16:41:43 +0200
Subject: [PATCH 069/125] feat(studio): add variable timeline timing and layout

---
 packages/studio/src/App.tsx                   |  27 +--
 .../studio/src/hooks/timelineMoveAdapter.ts   |  11 +-
 .../src/hooks/useTimelineEditing.test.tsx     | 209 ++++++++++++++++--
 .../studio/src/hooks/useTimelineEditing.ts    |  75 ++++---
 .../src/hooks/useTimelineEditingTypes.ts      |   2 +
 .../src/hooks/useTimelineGroupEditing.ts      |  85 +++----
 .../timelineClipDragPreview.test.ts           |  53 ++++-
 .../components/timelineClipDragPreview.ts     |  52 +++--
 .../player/components/timelineCollision.ts    |  17 +-
 .../player/components/timelineLayout.test.ts  |  75 +++++++
 .../src/player/components/timelineLayout.ts   | 127 +++++++++--
 .../player/components/timelineMarquee.test.ts |  97 ++++++--
 .../src/player/components/timelineMarquee.ts  |  24 +-
 .../player/components/useTimelineClipDrag.ts  |   5 +-
 14 files changed, 671 insertions(+), 188 deletions(-)

diff --git a/packages/studio/src/App.tsx b/packages/studio/src/App.tsx
index ad131e3a62..eff75a40ea 100644
--- a/packages/studio/src/App.tsx
+++ b/packages/studio/src/App.tsx
@@ -1,7 +1,7 @@
 import { useState, useCallback, useRef, useMemo, useEffect, useLayoutEffect } from "react";
 import type { LeftSidebarHandle, SidebarTab } from "./components/sidebar/LeftSidebar";
 import { useRenderQueue } from "./components/renders/useRenderQueue";
-import { usePlayerStore, type TimelineElement } from "./player";
+import { usePlayerStore } from "./player";
 import { StudioOverlays } from "./components/StudioOverlays";
 import { SaveQueuePausedBanner } from "./components/SaveQueuePausedBanner";
 import { useCaptionStore } from "./captions/store";
@@ -12,9 +12,12 @@ import { useFileManager } from "./hooks/useFileManager";
 import { usePreviewPersistence } from "./hooks/usePreviewPersistence";
 import { usePreviewDocumentVersion } from "./hooks/usePreviewDocumentVersion";
 import { useTimelineEditing } from "./hooks/useTimelineEditing";
-import { persistTimelineMoveEditsAtomically } from "./hooks/timelineMoveAdapter";
+import {
+  persistTimelineMoveEditsAtomically,
+  type TimelineMoveEditsHandler,
+  type TimelineMoveOperation,
+} from "./hooks/timelineMoveAdapter";
 import type { TimelineZIndexReorderCommit } from "./hooks/useTimelineEditingTypes";
-import type { TimelineStackingReorderIntent } from "./player/components/timelineStacking";
 import type { BlockPreviewInfo } from "./components/sidebar/BlocksTab";
 import { useDomEditSession } from "./hooks/useDomEditSession";
 import { useSdkSelectionSync } from "./hooks/useSdkSelectionSync";
@@ -62,7 +65,6 @@ import {
 } from "./utils/studioUrlState";
 import { trackStudioSessionStart } from "./telemetry/events";
 import { hasFiredSessionStart, markSessionStartFired } from "./telemetry/config";
-type TimelineMoveOperation = Parameters<typeof persistTimelineMoveEditsAtomically>[2];
 // fallow-ignore-next-line complexity
 export function StudioApp() {
   const { projectId, resolving, waitingForServer } = useServerConnection();
@@ -154,6 +156,7 @@ export function StudioApp() {
     reloadPreview: () => setRefreshKey((k) => k + 1),
     pendingTimelineEditPathRef,
   });
+  const invalidateGsapCacheRef = useRef<() => void>(() => {});
   const timelineEditing = useTimelineEditing({
     projectId,
     activeCompPath,
@@ -171,20 +174,11 @@ export function StudioApp() {
     sdkSession: editFlowSdkSession,
     publishSdkSession: sdkHandle.publish,
     forceReloadSdkSession: sdkHandle.forceReload,
+    invalidateGsapCache: () => invalidateGsapCacheRef.current(),
     handleDomZIndexReorderCommitRef,
   });
-  const handleTimelineElementsMove = useCallback(
-    async (
-      edits: Array<{
-        element: TimelineElement;
-        updates: Pick<TimelineElement, "start" | "track"> & {
-          stackingReorder?: TimelineStackingReorderIntent | null;
-        };
-      }>,
-      coalesceKey?: string,
-      operation: TimelineMoveOperation = "timing",
-      coalesceMs?: number,
-    ) => {
+  const handleTimelineElementsMove: TimelineMoveEditsHandler = useCallback(
+    async (edits, coalesceKey, operation: TimelineMoveOperation = "timing", coalesceMs) => {
       const deps = { handleTimelineGroupMove: timelineEditing.handleTimelineGroupMove };
       await persistTimelineMoveEditsAtomically(edits, coalesceKey, operation, deps, coalesceMs);
     },
@@ -228,7 +222,6 @@ export function StudioApp() {
   const domEditDeleteBridge = (s: DomEditSelection) => handleDomEditElementDeleteRef.current(s);
   const resetKeyframesRef = useRef<() => boolean>(() => false);
   const deleteSelectedKeyframesRef = useRef<() => void>(() => {});
-  const invalidateGsapCacheRef = useRef<() => void>(() => {});
   const { handleCopy, handlePaste, handleCut } = useClipboard({
     projectId,
     activeCompPath,
diff --git a/packages/studio/src/hooks/timelineMoveAdapter.ts b/packages/studio/src/hooks/timelineMoveAdapter.ts
index f5b9b2fb65..ee7544e8ea 100644
--- a/packages/studio/src/hooks/timelineMoveAdapter.ts
+++ b/packages/studio/src/hooks/timelineMoveAdapter.ts
@@ -4,7 +4,7 @@ import type {
   TimelineGroupMoveChange,
 } from "./useTimelineGroupEditing";
 
-interface MoveEdit {
+export interface TimelineMoveEdit {
   element: TimelineElement;
   updates: Pick<TimelineElement, "start" | "track">;
 }
@@ -18,8 +18,15 @@ interface AtomicMoveDeps {
 
 export type TimelineMoveOperation = "timing" | "lane-reorder" | "track-insert";
 
+export type TimelineMoveEditsHandler = (
+  edits: TimelineMoveEdit[],
+  coalesceKey?: string,
+  operation?: TimelineMoveOperation,
+  coalesceMs?: number,
+) => Promise<void>;
+
 export function persistTimelineMoveEditsAtomically(
-  edits: MoveEdit[],
+  edits: TimelineMoveEdit[],
   coalesceKey: string | undefined,
   operation: TimelineMoveOperation,
   deps: AtomicMoveDeps,
diff --git a/packages/studio/src/hooks/useTimelineEditing.test.tsx b/packages/studio/src/hooks/useTimelineEditing.test.tsx
index bc88aca67d..18d81aa55d 100644
--- a/packages/studio/src/hooks/useTimelineEditing.test.tsx
+++ b/packages/studio/src/hooks/useTimelineEditing.test.tsx
@@ -10,6 +10,17 @@ import { jsonResponse, requestUrl } from "./fetchStubTestUtils";
 import { useElementLifecycleOps } from "./useElementLifecycleOps";
 import { useTimelineEditing } from "./useTimelineEditing";
 
+vi.mock("../components/editor/manualEditingAvailability", async (importOriginal) => {
+  const actual =
+    await importOriginal<typeof import("../components/editor/manualEditingAvailability")>();
+  return {
+    ...actual,
+    STUDIO_SDK_CUTOVER_ENABLED: true,
+    STUDIO_SDK_CUTOVER_FAMILIES: new Set(["timing"]),
+    STUDIO_SDK_RESOLVER_SHADOW_ENABLED: false,
+  };
+});
+
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
 type ZIndexEntry = {
@@ -108,7 +119,9 @@ function renderTimelineEditingHook(input: {
   }) => Promise<void>;
   reloadPreview?: () => void;
   sdkSession?: Awaited<ReturnType<typeof openComposition>> | null;
+  publishSdkSession?: NonNullable<Parameters<typeof useTimelineEditing>[0]["publishSdkSession"]>;
   forceReloadSdkSession?: () => void;
+  invalidateGsapCache?: () => void;
   showToast?: (message: string, kind?: string) => void;
 }): {
   move: ReturnType<typeof useTimelineEditing>["handleTimelineElementMove"];
@@ -140,7 +153,9 @@ function renderTimelineEditingHook(input: {
       pendingTimelineEditPathRef: { current: new Set<string>() },
       uploadProjectFiles: vi.fn(),
       sdkSession: input.sdkSession,
+      publishSdkSession: input.publishSdkSession,
       forceReloadSdkSession: input.forceReloadSdkSession,
+      invalidateGsapCache: input.invalidateGsapCache,
       handleDomZIndexReorderCommitRef: commitRef,
     });
     move = hook.handleTimelineElementMove;
@@ -163,6 +178,9 @@ function renderTimelineEditingHook(input: {
 type TimelineRecordEdit = NonNullable<
   Parameters<typeof renderTimelineEditingHook>[0]["recordEdit"]
 >;
+type TimelinePublishSdkSession = NonNullable<
+  Parameters<typeof renderTimelineEditingHook>[0]["publishSdkSession"]
+>;
 
 function renderTimelineEditingHookWithLifecycle(input: {
   timelineElements: TimelineElement[];
@@ -227,28 +245,41 @@ async function flushAsyncWork(): Promise<void> {
  * with `gsapBody`. Returns the mock for call inspection.
  */
 function stubProjectFetch(files: string | Record<string, string>, gsapBody?: unknown) {
-  // Keep this test server's capability, file-read, and mutation routes together;
-  // splitting the fixture would obscure the request sequence asserted by callers.
-  // fallow-ignore-next-line complexity
-  const fetchMock = vi.fn(async (input: Parameters<typeof fetch>[0]): Promise<Response> => {
-    const url = requestUrl(input);
-    if (url.includes("/api/projects/p1/gsap-mutation-capabilities")) {
-      return jsonResponse({ atomicOwnershipPairs: true });
-    }
-    if (url.includes("/api/projects/p1/files/")) {
-      if (typeof files === "string") return jsonResponse({ content: files });
-      const path = decodeURIComponent(url.split("/files/")[1] ?? "index.html");
-      return jsonResponse({ content: files[path] });
-    }
-    if (url.includes("/api/projects/p1/gsap-mutations/")) {
-      const path = decodeURIComponent(url.split("/gsap-mutations/")[1] ?? "index.html");
-      const content = typeof files === "string" ? files : (files[path] ?? "");
-      return jsonResponse(
-        gsapBody ?? { mutated: false, scriptText: null, before: content, after: content },
-      );
-    }
-    throw new Error(`Unexpected fetch: ${url}`);
-  });
+  const pathAfter = (url: string, marker: string) =>
+    decodeURIComponent(url.split(marker)[1] ?? "index.html");
+  const fileContent = (path: string) => (typeof files === "string" ? files : files[path]);
+  // One handler per route, so the mock itself stays a lookup: the request
+  // sequence callers assert on is still readable top to bottom.
+  const routes: Array<[marker: string, respond: (url: string) => Response]> = [
+    [
+      "/api/projects/p1/gsap-mutation-capabilities",
+      () => jsonResponse({ atomicOwnershipPairs: true }),
+    ],
+    [
+      "/api/projects/p1/files/",
+      (url) => jsonResponse({ content: fileContent(pathAfter(url, "/files/")) }),
+    ],
+    [
+      "/api/projects/p1/gsap-mutations/",
+      (url) => {
+        const content = fileContent(pathAfter(url, "/gsap-mutations/")) ?? "";
+        return jsonResponse(
+          gsapBody ?? { mutated: false, scriptText: null, before: content, after: content },
+        );
+      },
+    ],
+  ];
+  const fetchMock = vi.fn(
+    async (
+      input: Parameters<typeof fetch>[0],
+      _init?: Parameters<typeof fetch>[1],
+    ): Promise<Response> => {
+      const url = requestUrl(input);
+      const route = routes.find(([marker]) => url.includes(marker));
+      if (!route) throw new Error(`Unexpected fetch: ${url}`);
+      return route[1](url);
+    },
+  );
   vi.stubGlobal("fetch", fetchMock);
   return fetchMock;
 }
@@ -285,6 +316,39 @@ function setupSingleClipHarness(options?: {
   return { iframe, clip, commit, writeProjectFile, reloadPreview, fetchMock, ...hook };
 }
 
+const SDK_KEYFRAMED_SOURCE = [
+  `<div data-hf-id="hf-stage" data-hf-root data-composition-id="main" data-duration="10">`,
+  `  <div id="clip" data-hf-id="hf-clip" data-start="1" data-duration="2"></div>`,
+  `</div>`,
+  `<script>`,
+  `const tl = gsap.timeline({ paused: true });`,
+  `tl.to("#clip", { keyframes: [{ x: 0 }, { x: 100 }], duration: 2 }, 1);`,
+  `window.__timelines = [tl];`,
+  `</script>`,
+].join("\n");
+
+async function setupSdkKeyframedClipHarness() {
+  const iframe = createPreviewIframe([{ id: "clip", track: 0 }]);
+  const clip = timelineElement({ id: "clip", track: 0, zIndex: 0, start: 1 });
+  const sdkSession = await openComposition(SDK_KEYFRAMED_SOURCE);
+  const writeProjectFile = vi.fn<(...args: unknown[]) => Promise<void>>(async () => {});
+  const invalidateGsapCache = vi.fn();
+  const fetchMock = stubProjectFetch(SDK_KEYFRAMED_SOURCE);
+  usePlayerStore.getState().setDuration(10);
+  const hook = renderTimelineEditingHook({
+    timelineElements: [clip],
+    iframe,
+    onZIndexCommit: vi.fn().mockResolvedValue(undefined),
+    projectId: "p1",
+    writeProjectFile,
+    recordEdit: vi.fn(async () => {}),
+    sdkSession,
+    publishSdkSession: vi.fn<TimelinePublishSdkSession>(() => "published"),
+    invalidateGsapCache,
+  });
+  return { clip, fetchMock, hook, invalidateGsapCache, writeProjectFile };
+}
+
 /** Assert a lane write landed in both the live iframe DOM and the persisted file. */
 function expectLanePersisted(
   iframe: HTMLIFrameElement,
@@ -710,6 +774,58 @@ describe("useTimelineEditing timeline z-index reorder", () => {
     h.unmount();
   });
 
+  it("shifts authored GSAP positions after an SDK-backed clip move commits", async () => {
+    const { clip, fetchMock, hook, invalidateGsapCache, writeProjectFile } =
+      await setupSdkKeyframedClipHarness();
+
+    await act(async () => {
+      await hook.move(clip, { start: 2.25, track: clip.track });
+    });
+
+    expect(writeProjectFile.mock.calls[0]?.[1]).toContain('data-start="2.25"');
+    const mutationCall = fetchMock.mock.calls.find((call) =>
+      requestUrl(call[0]).includes("/gsap-mutations/"),
+    );
+    expect(mutationCall).toBeDefined();
+    const init = mutationCall?.[1] as RequestInit | undefined;
+    expect(JSON.parse(String(init?.body))).toEqual({
+      type: "shift-positions",
+      targetSelector: "#clip",
+      delta: 1.25,
+    });
+    expect(invalidateGsapCache).toHaveBeenCalledTimes(1);
+
+    hook.unmount();
+  });
+
+  it("scales authored GSAP positions after an SDK-backed clip resize commits", async () => {
+    const { clip, fetchMock, hook, invalidateGsapCache, writeProjectFile } =
+      await setupSdkKeyframedClipHarness();
+
+    await act(async () => {
+      await hook.resize(clip, { start: 2, duration: 4, playbackStart: undefined });
+    });
+
+    expect(writeProjectFile.mock.calls[0]?.[1]).toContain('data-start="2"');
+    expect(writeProjectFile.mock.calls[0]?.[1]).toContain('data-duration="4"');
+    const mutationCall = fetchMock.mock.calls.find((call) =>
+      requestUrl(call[0]).includes("/gsap-mutations/"),
+    );
+    expect(mutationCall).toBeDefined();
+    const init = mutationCall?.[1] as RequestInit | undefined;
+    expect(JSON.parse(String(init?.body))).toEqual({
+      type: "scale-positions",
+      targetSelector: "#clip",
+      oldStart: 1,
+      oldDuration: 2,
+      newStart: 2,
+      newDuration: 4,
+    });
+    expect(invalidateGsapCache).toHaveBeenCalledTimes(1);
+
+    hook.unmount();
+  });
+
   it("persists a vertical-only lane move (start unchanged) through the single-element fallback", async () => {
     // Regression: `if (!startChanged) return` ran BEFORE the file persist, so a
     // pure lane change routed through onMoveElement (no onMoveElements wired)
@@ -821,6 +937,55 @@ describe("useTimelineEditing timeline z-index reorder", () => {
     unmount();
   });
 
+  it("shifts every keyed clip and invalidates the cache after an SDK-backed group move", async () => {
+    const source = [
+      `<div data-hf-id="hf-stage" data-hf-root data-duration="10">`,
+      `  <div id="a" data-hf-id="hf-a" data-start="0" data-duration="1"></div>`,
+      `  <div id="b" data-hf-id="hf-b" data-start="1" data-duration="1"></div>`,
+      `</div>`,
+      `<script>`,
+      `const tl = gsap.timeline({ paused: true });`,
+      `tl.to("#a", { keyframes: [{ x: 0 }, { x: 100 }], duration: 1 }, 0);`,
+      `tl.to("#b", { keyframes: [{ x: 0 }, { x: 100 }], duration: 1 }, 1);`,
+      `window.__timelines = [tl];`,
+      `</script>`,
+    ].join("\n");
+    const { iframe, a, b } = makeTwoClipPair();
+    const sdkSession = await openComposition(source);
+    const fetchMock = stubProjectFetch(source);
+    const invalidateGsapCache = vi.fn();
+    usePlayerStore.getState().setDuration(10);
+    const hook = renderTimelineEditingHook({
+      timelineElements: [a, b],
+      iframe,
+      onZIndexCommit: vi.fn().mockResolvedValue(undefined),
+      projectId: "p1",
+      writeProjectFile: vi.fn<(...args: unknown[]) => Promise<void>>(async () => {}),
+      recordEdit: vi.fn(async () => {}),
+      sdkSession,
+      publishSdkSession: vi.fn<TimelinePublishSdkSession>(() => "published"),
+      invalidateGsapCache,
+    });
+
+    await act(async () => {
+      await hook.groupMove([
+        { element: a, start: 1 },
+        { element: b, start: 2 },
+      ]);
+    });
+
+    const mutations = fetchMock.mock.calls
+      .filter((call) => requestUrl(call[0]).includes("/gsap-mutations/"))
+      .map((call) => JSON.parse(String((call[1] as RequestInit | undefined)?.body)));
+    expect(mutations).toEqual([
+      { type: "shift-positions", targetSelector: "#a", delta: 1 },
+      { type: "shift-positions", targetSelector: "#b", delta: 1 },
+    ]);
+    expect(invalidateGsapCache).toHaveBeenCalledTimes(1);
+
+    hook.unmount();
+  });
+
   it("partitions a group move by source file while keeping one undo entry", async () => {
     const files: Record<string, string> = {
       "index.html": '<div id="a" data-start="0" data-duration="1"></div>',
diff --git a/packages/studio/src/hooks/useTimelineEditing.ts b/packages/studio/src/hooks/useTimelineEditing.ts
index 2c53299a20..bf846f06fe 100644
--- a/packages/studio/src/hooks/useTimelineEditing.ts
+++ b/packages/studio/src/hooks/useTimelineEditing.ts
@@ -58,6 +58,7 @@ export function useTimelineEditing({
   sdkSession,
   publishSdkSession,
   forceReloadSdkSession,
+  invalidateGsapCache,
   handleDomZIndexReorderCommitRef,
 }: UseTimelineEditingOptions) {
   const projectIdRef = useRef(projectId);
@@ -118,6 +119,7 @@ export function useTimelineEditing({
     domEditSaveTimestampRef,
     editQueueRef,
     forceReloadSdkSession,
+    invalidateGsapCache,
     isRecordingRef,
     pendingTimelineEditPathRef,
     previewIframeRef,
@@ -184,21 +186,24 @@ export function useTimelineEditing({
           );
         };
         const coalesceKey = `timeline-move:${element.hfId ?? element.id}`;
+        const finishMoveGsapSync = () =>
+          // Every timing writer converges the same GSAP positions after its
+          // durable clip-start commit. The SDK owns the attribute write; this
+          // sync owns only the dependent animation rewrite and preview refresh.
+          finishClipTimingFallback({
+            iframe: previewIframeRef.current,
+            reloadPreview,
+            projectId: projectIdRef.current,
+            targetPath,
+            domId: element.domId,
+            label: "Move timeline clip",
+            coalesceKey,
+            recordEdit,
+            edit: { kind: "shift", delta: updates.start - element.start },
+          }).finally(() => invalidateGsapCache?.());
         const moveFallback = () =>
-          enqueueEdit(element, "Move timeline clip", buildMovePatches, coalesceKey).then(() =>
-            // Soft-reload with the server's rewritten GSAP script — the timing-only move already patched
-            // DOM + store, so swapping the script avoids the all-clips flash; falls back to reloadPreview().
-            finishClipTimingFallback({
-              iframe: previewIframeRef.current,
-              reloadPreview,
-              projectId: projectIdRef.current,
-              targetPath,
-              domId: element.domId,
-              label: "Move timeline clip",
-              coalesceKey,
-              recordEdit,
-              edit: { kind: "shift", delta: updates.start - element.start },
-            }),
+          enqueueEdit(element, "Move timeline clip", buildMovePatches, coalesceKey).then(
+            finishMoveGsapSync,
           );
         return reorderDone
           .then(() => {
@@ -221,9 +226,10 @@ export function useTimelineEditing({
                   readProjectFile: (path) => readFileContent(projectIdRef.current ?? "", path),
                   publishSession: publishSdkSession,
                 },
-                { label: "Move timeline clip", coalesceKey },
+                { label: "Move timeline clip", coalesceKey, skipRefresh: true },
               ).then((result) => {
                 if (!cutoverCommittedOrThrow(result)) return moveFallback();
+                return finishMoveGsapSync();
               });
             }
             return moveFallback();
@@ -250,6 +256,7 @@ export function useTimelineEditing({
       timelineElements,
       handleDomZIndexReorderCommitRef,
       showToast,
+      invalidateGsapCache,
     ],
   );
 
@@ -287,23 +294,25 @@ export function useTimelineEditing({
       // script (timing-only resize) — same no-flash path as move; full reload is
       // the fallback.
       const coalesceKey = `timeline-resize:${element.hfId ?? element.id}`;
+      const finishResizeGsapSync = () =>
+        finishClipTimingFallback({
+          iframe: previewIframeRef.current,
+          reloadPreview,
+          projectId: projectIdRef.current,
+          targetPath,
+          domId: element.domId,
+          label: "Resize timeline clip",
+          coalesceKey,
+          recordEdit,
+          edit: {
+            kind: "scale",
+            from: { start: element.start, duration: element.duration },
+            to: { start: updates.start, duration: updates.duration },
+          },
+        }).finally(() => invalidateGsapCache?.());
       const resizeFallback = () =>
-        enqueueEdit(element, "Resize timeline clip", buildResizePatches, coalesceKey).then(() =>
-          finishClipTimingFallback({
-            iframe: previewIframeRef.current,
-            reloadPreview,
-            projectId: projectIdRef.current,
-            targetPath,
-            domId: element.domId,
-            label: "Resize timeline clip",
-            coalesceKey,
-            recordEdit,
-            edit: {
-              kind: "scale",
-              from: { start: element.start, duration: element.duration },
-              to: { start: updates.start, duration: updates.duration },
-            },
-          }),
+        enqueueEdit(element, "Resize timeline clip", buildResizePatches, coalesceKey).then(
+          finishResizeGsapSync,
         );
       const persistDone =
         sdkSession && element.hfId && !hasPbsAdjustment && !needsExtension
@@ -323,9 +332,10 @@ export function useTimelineEditing({
                 readProjectFile: (path) => readFileContent(projectIdRef.current ?? "", path),
                 publishSession: publishSdkSession,
               },
-              { label: "Resize timeline clip", coalesceKey },
+              { label: "Resize timeline clip", coalesceKey, skipRefresh: true },
             ).then((result) => {
               if (!cutoverCommittedOrThrow(result)) return resizeFallback();
+              return finishResizeGsapSync();
             })
           : resizeFallback();
       return persistDone.catch((error) => {
@@ -346,6 +356,7 @@ export function useTimelineEditing({
       reloadPreview,
       domEditSaveTimestampRef,
       showToast,
+      invalidateGsapCache,
     ],
   );
 
diff --git a/packages/studio/src/hooks/useTimelineEditingTypes.ts b/packages/studio/src/hooks/useTimelineEditingTypes.ts
index a391177064..bd3df209d8 100644
--- a/packages/studio/src/hooks/useTimelineEditingTypes.ts
+++ b/packages/studio/src/hooks/useTimelineEditingTypes.ts
@@ -46,6 +46,8 @@ export interface UseTimelineEditingOptions {
   publishSdkSession?: PublishSdkSession;
   /** Resync the SDK session after a server-authoritative timeline write. */
   forceReloadSdkSession?: () => void;
+  /** Reparse authored animations after a timing rewrite changes their positions. */
+  invalidateGsapCache?: () => void;
   handleDomZIndexReorderCommitRef?: MutableRefObject<TimelineZIndexReorderCommit | null>;
 }
 
diff --git a/packages/studio/src/hooks/useTimelineGroupEditing.ts b/packages/studio/src/hooks/useTimelineGroupEditing.ts
index 8a3fe83a81..2b6ac46e70 100644
--- a/packages/studio/src/hooks/useTimelineGroupEditing.ts
+++ b/packages/studio/src/hooks/useTimelineGroupEditing.ts
@@ -54,6 +54,7 @@ interface UseTimelineGroupEditingOptions {
   domEditSaveTimestampRef: MutableRefObject<number>;
   editQueueRef: MutableRefObject<Promise<unknown>>;
   forceReloadSdkSession?: () => void;
+  invalidateGsapCache?: () => void;
   isRecordingRef?: RefObject<boolean>;
   pendingTimelineEditPathRef: MutableRefObject<Set<string>>;
   previewIframeRef: RefObject<HTMLIFrameElement | null>;
@@ -110,6 +111,7 @@ export function useTimelineGroupEditing({
   domEditSaveTimestampRef,
   editQueueRef,
   forceReloadSdkSession,
+  invalidateGsapCache,
   isRecordingRef,
   pendingTimelineEditPathRef,
   previewIframeRef,
@@ -212,7 +214,12 @@ export function useTimelineGroupEditing({
           readProjectFile: (path) => readFileContent(projectIdRef.current ?? "", path),
           publishSession: publishSdkSession,
         },
-        { label: input.label, coalesceKey: input.coalesceKey, coalesceMs: input.coalesceMs },
+        {
+          label: input.label,
+          coalesceKey: input.coalesceKey,
+          coalesceMs: input.coalesceMs,
+          skipRefresh: true,
+        },
       );
       return cutoverCommittedOrThrow(result);
     },
@@ -282,25 +289,25 @@ export function useTimelineGroupEditing({
           coalesceKey,
           coalesceMs,
         });
-        if (handledBySdk) return;
-
-        await persistServerBatch(
-          projectId,
-          "Move timeline clips",
-          changes.map((change) => ({
-            element: change.element,
-            buildPatches: (original, target) =>
-              buildTimelineMoveTimingPatch(
-                original,
-                target,
-                change.start,
-                change.element.duration,
-                change.track,
-              ),
-          })),
-          coalesceKey,
-          coalesceMs,
-        );
+        if (!handledBySdk) {
+          await persistServerBatch(
+            projectId,
+            "Move timeline clips",
+            changes.map((change) => ({
+              element: change.element,
+              buildPatches: (original, target) =>
+                buildTimelineMoveTimingPatch(
+                  original,
+                  target,
+                  change.start,
+                  change.element.duration,
+                  change.track,
+                ),
+            })),
+            coalesceKey,
+            coalesceMs,
+          );
+        }
         // Track-only: no timing delta → no GSAP positions to shift and no
         // reload (see the trackOnly doc above). Mixed batches (any start
         // change) keep the full fallback below.
@@ -323,6 +330,7 @@ export function useTimelineGroupEditing({
             return shiftGsapPositions(projectId, changePath, domId, delta);
           },
         });
+        invalidateGsapCache?.();
       }).catch((error) => {
         // Failed persist: revert the optimistic duration readout + live root
         // alongside the gesture owner's store rollback.
@@ -340,6 +348,7 @@ export function useTimelineGroupEditing({
       reloadPreview,
       trySdkBatchPersist,
       showToast,
+      invalidateGsapCache,
     ],
   );
 
@@ -384,23 +393,23 @@ export function useTimelineGroupEditing({
           coalesceKey,
           coalesceMs,
         });
-        if (handledBySdk) return;
-
-        await persistServerBatch(
-          projectId,
-          "Resize timeline clips",
-          changes.map((change) => ({
-            element: change.element,
-            buildPatches: (original, target) =>
-              buildTimelineResizeTimingPatch(original, target, change.element, {
-                start: change.start,
-                duration: change.duration,
-                playbackStart: change.playbackStart,
-              }),
-          })),
-          coalesceKey,
-          coalesceMs,
-        );
+        if (!handledBySdk) {
+          await persistServerBatch(
+            projectId,
+            "Resize timeline clips",
+            changes.map((change) => ({
+              element: change.element,
+              buildPatches: (original, target) =>
+                buildTimelineResizeTimingPatch(original, target, change.element, {
+                  start: change.start,
+                  duration: change.duration,
+                  playbackStart: change.playbackStart,
+                }),
+            })),
+            coalesceKey,
+            coalesceMs,
+          );
+        }
         await finishGroupTimingGsapFallback({
           projectId,
           iframe: previewIframeRef.current,
@@ -428,6 +437,7 @@ export function useTimelineGroupEditing({
             );
           },
         });
+        invalidateGsapCache?.();
       }).catch((error) => {
         // Failed persist: revert the optimistic duration readout + live root
         // alongside the gesture owner's store rollback.
@@ -445,6 +455,7 @@ export function useTimelineGroupEditing({
       reloadPreview,
       trySdkBatchPersist,
       showToast,
+      invalidateGsapCache,
     ],
   );
 
diff --git a/packages/studio/src/player/components/timelineClipDragPreview.test.ts b/packages/studio/src/player/components/timelineClipDragPreview.test.ts
index 5f9bae4ef8..c71e9e73f6 100644
--- a/packages/studio/src/player/components/timelineClipDragPreview.test.ts
+++ b/packages/studio/src/player/components/timelineClipDragPreview.test.ts
@@ -6,7 +6,7 @@ import {
   type DragPreviewContext,
 } from "./timelineClipDragPreview";
 import type { DraggedClipState } from "./timelineClipDragTypes";
-import { RULER_H, TRACKS_TOP_PAD, TRACK_H } from "./timelineLayout";
+import { LANE_H, RULER_H, TRACKS_TOP_PAD, TRACK_H } from "./timelineLayout";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Regression bed for the live-reproduced BUG 1: a PLAIN HORIZONTAL drag of a clip
@@ -55,13 +55,17 @@ function fakeScroll(): HTMLDivElement {
   } as unknown as HTMLDivElement;
 }
 
-function ctx(): DragPreviewContext {
+function ctx(
+  rowHeights?: readonly number[],
+  elements: TimelineElement[] = fixtureElements,
+): DragPreviewContext {
   return {
     scroll: fakeScroll(),
     pps: PPS,
     duration: 44.5,
     trackOrder: [0, 1, 2],
-    elements: fixtureElements,
+    elements,
+    rowHeights,
     selectedKeys: new Set<string>(),
     buildSnapTargets: () => [],
     audioTracks: new Set<number>(),
@@ -145,6 +149,49 @@ describe("computeDragPreview — plain horizontal drag never arms a phantom inse
     const next = computeDragPreview(drag, originClientX, yForRow(-0.6), ctx());
     expect(next.insertRow).toBe(0); // a new TOP track will be created on drop
   });
+
+  it("keeps a horizontal drag in the body of an expanded row out of insert mode", () => {
+    const rowHeights = [TRACK_H + 2 * LANE_H, TRACK_H, TRACK_H];
+    const clientY = RULER_H + TRACKS_TOP_PAD + rowHeights[0] - 8;
+    const { drag, clientX } = horizontalDrag(moodboard, 0.5, 2);
+    const next = computeDragPreview(
+      { ...drag, originClientY: clientY, pointerClientY: clientY },
+      clientX,
+      clientY,
+      ctx(rowHeights),
+    );
+    expect(next.insertRow).toBeNull();
+    expect(next.previewTrack).toBe(0);
+  });
+
+  it("uses the expanded row midpoint when choosing the side for an automatic insert", () => {
+    const rowHeights = [TRACK_H + 2 * LANE_H, TRACK_H];
+    const dragged = clip("dragged", 0, 0, 1, 3);
+    const occupied = [dragged, clip("block-0", 0, 0, 1, 2), clip("block-1", 1, 0, 1, 1)];
+    const clientY = RULER_H + TRACKS_TOP_PAD + 30;
+    const drag: DraggedClipState = {
+      element: dragged,
+      originClientX: 0,
+      originClientY: clientY,
+      originScrollLeft: 0,
+      originScrollTop: 0,
+      pointerClientX: 0,
+      pointerClientY: clientY,
+      pointerOffsetX: 0,
+      pointerOffsetY: 0,
+      previewStart: 0,
+      previewTrack: 0,
+      insertRow: null,
+      snapTime: null,
+      snapType: null,
+      started: true,
+    };
+    const next = computeDragPreview(drag, 0, clientY, {
+      ...ctx(rowHeights, occupied),
+      trackOrder: [0, 1],
+    });
+    expect(next.insertRow).toBe(0);
+  });
 });
 
 describe("computeResizePreview — composition source continuity", () => {
diff --git a/packages/studio/src/player/components/timelineClipDragPreview.ts b/packages/studio/src/player/components/timelineClipDragPreview.ts
index 0e2d92b551..e5c054c035 100644
--- a/packages/studio/src/player/components/timelineClipDragPreview.ts
+++ b/packages/studio/src/player/components/timelineClipDragPreview.ts
@@ -1,6 +1,11 @@
 import { resolveTimelineMove, resolveTimelineResize } from "./timelineEditing";
 import type { TimelineElement } from "../store/playerStore";
-import { TRACK_H, getTimelineRowFromY, INSERT_BOUNDARY_BAND } from "./timelineLayout";
+import {
+  getTimelineInsertBoundaryBand,
+  getTimelineRowFromY,
+  getTimelineRowHeight,
+  getTimelineRowPositionFromY,
+} from "./timelineLayout";
 import { isMusicTrack, isAudioTimelineElement } from "../../utils/timelineInspector";
 import {
   TIMELINE_SNAP_PX,
@@ -27,6 +32,7 @@ export interface DragPreviewContext {
   pps: number;
   duration: number;
   trackOrder: number[];
+  rowHeights?: readonly number[];
   elements: TimelineElement[];
   selectedKeys: ReadonlySet<string>;
   buildSnapTargets: BuildSnapTargets;
@@ -81,20 +87,26 @@ function resolveDropPlacement(
   desiredTrack: number,
   ctx: DragPreviewContext,
 ): { track: number; insertRow: number | null } {
-  const { scroll, trackOrder, elements } = ctx;
+  const { scroll, trackOrder, rowHeights, elements } = ctx;
   // rowFloat = the pointer's position in track-heights from the top lane; a
   // near-boundary hover requests a deliberate new-track insert. Uses the
   // shared row→y inverse so the top breathing pad is subtracted consistently.
-  const rowFloat = scroll
-    ? getTimelineRowFromY(clientY - scroll.getBoundingClientRect().top + scroll.scrollTop)
-    : 0;
-  // Geometry-exact band (the clip inset) so an insert only arms in the visible
-  // gutter BETWEEN clip bodies — dragging over a clip body is a lane move, never a
-  // phantom insert (the plain-horizontal-drag misfire). See INSERT_BOUNDARY_BAND.
-  const rawInsertRow = resolveInsertRow(rowFloat, trackOrder.length, INSERT_BOUNDARY_BAND);
+  const rowPosition = scroll
+    ? getTimelineRowPositionFromY(
+        clientY - scroll.getBoundingClientRect().top + scroll.scrollTop,
+        rowHeights,
+      )
+    : { rowFloat: 0, row: 0, fraction: 0, rowHeight: getTimelineRowHeight(0, rowHeights) };
+  // Geometry-exact band (the clip inset divided by this row's actual height) so
+  // an insert only arms in the visible gutter between clip bodies.
+  const rawInsertRow = resolveInsertRow(
+    rowPosition.rowFloat,
+    trackOrder.length,
+    getTimelineInsertBoundaryBand(rowPosition.rowHeight),
+  );
   // Pointer sub-row half: when a drop must auto-create a track (aimed span
   // occupied, no free lane), open it on the side the pointer is nearer.
-  const preferInsertAbove = rowFloat - Math.floor(rowFloat) < 0.5;
+  const preferInsertAbove = rowPosition.fraction < 0.5;
   const audioTracks =
     ctx.audioTracks ?? new Set(elements.filter(isAudioTimelineElement).map((e) => e.track));
   return resolveZoneDropPlacement({
@@ -120,24 +132,34 @@ export function computeDragPreview(
 ): DraggedClipState {
   const { scroll, pps, duration, trackOrder, elements, selectedKeys, buildSnapTargets } = ctx;
   const dragMaxStart = resolveDragMaxStart(scroll, pps, duration);
+  const scrollTop = scroll?.scrollTop ?? drag.originScrollTop;
+  const scrollRectTop = scroll?.getBoundingClientRect().top ?? 0;
+  const originRow = getTimelineRowFromY(
+    drag.originClientY - scrollRectTop + drag.originScrollTop,
+    ctx.rowHeights,
+  );
+  const currentRow = getTimelineRowFromY(clientY - scrollRectTop + scrollTop, ctx.rowHeights);
+  // resolveTimelineMove's vertical axis is expressed in track-height units.
+  // Feeding cumulative row coordinates with a unit height preserves its existing
+  // threshold/create-track behavior while supporting variable pixel heights.
   const nextMove = resolveTimelineMove(
     {
       start: drag.element.start,
       track: drag.element.track,
       duration: drag.element.duration,
       originClientX: drag.originClientX,
-      originClientY: drag.originClientY,
+      originClientY: originRow,
       originScrollLeft: drag.originScrollLeft,
-      originScrollTop: drag.originScrollTop,
+      originScrollTop: 0,
       currentScrollLeft: scroll?.scrollLeft ?? drag.originScrollLeft,
-      currentScrollTop: scroll?.scrollTop ?? drag.originScrollTop,
+      currentScrollTop: 0,
       pixelsPerSecond: pps,
-      trackHeight: TRACK_H,
+      trackHeight: 1,
       maxStart: dragMaxStart,
       trackOrder,
     },
     clientX,
-    clientY,
+    currentRow,
   );
   // The music track defines the beats, so it must not snap to them —
   // but it still snaps to the playhead and other clip edges.
diff --git a/packages/studio/src/player/components/timelineCollision.ts b/packages/studio/src/player/components/timelineCollision.ts
index 1c9c6c5a59..c4f4c728e4 100644
--- a/packages/studio/src/player/components/timelineCollision.ts
+++ b/packages/studio/src/player/components/timelineCollision.ts
@@ -1,4 +1,5 @@
 import type { TimelineElement } from "../store/playerStore";
+import { INSERT_BOUNDARY_BAND } from "./timelineLayout";
 
 /**
  * Keep a landing track inside the dragged clip's kind-zone: visual clips stay in
@@ -139,28 +140,18 @@ export function resolveZoneDropPlacement(input: {
   return { track: placement.track, insertRow: null };
 }
 
-/**
- * Fallback half-width (fraction of a track height) of the insert band straddling
- * a lane boundary — used only when the caller passes no explicit band. Production
- * threads the geometry-exact `INSERT_BOUNDARY_BAND` (timelineLayout.ts, = the clip
- * inset `CLIP_Y / TRACK_H`) so the band matches the rendered inter-clip gutter and
- * NEVER reaches into a clip body. Kept in sync with that constant; do not widen it
- * back toward the old 0.32 (which armed an insert across ~64% of every row — the
- * misfire that turned a plain horizontal drag into a phantom track insert).
- */
-const INSERT_BAND = 3 / 48;
-
 /**
  * Decide whether a vertical drag is inserting a new track at a lane boundary.
  * `rowFloat` is the pointer's position in track-height units from the top of the
  * first lane (0 = top of lane 0). Returns the boundary row to insert at
  * (0 = above the top lane, `trackCount` = below the bottom), or null when the
- * pointer is over a lane's middle band (a normal move/target).
+ * pointer is over a lane's middle band (a normal move/target). The default band
+ * preserves collapsed-row behavior; production passes the concrete row's band.
  */
 export function resolveInsertRow(
   rowFloat: number,
   trackCount: number,
-  band: number = INSERT_BAND,
+  band: number = INSERT_BOUNDARY_BAND,
 ): number | null {
   if (trackCount === 0) return 0;
   if (rowFloat <= 0) return 0;
diff --git a/packages/studio/src/player/components/timelineLayout.test.ts b/packages/studio/src/player/components/timelineLayout.test.ts
index dde3a5cfc8..c21618faaf 100644
--- a/packages/studio/src/player/components/timelineLayout.test.ts
+++ b/packages/studio/src/player/components/timelineLayout.test.ts
@@ -2,6 +2,7 @@ import { describe, it, expect } from "vitest";
 import {
   RULER_H,
   TRACK_H,
+  LANE_H,
   TRACKS_TOP_PAD,
   TRACKS_BOTTOM_PAD,
   GUTTER,
@@ -9,10 +10,84 @@ import {
   getTimelineRowTop,
   getTimelineScrubTime,
   getTimelineRowFromY,
+  getTimelineRowOffsets,
   getTimelineCanvasHeight,
+  trackHeights,
   resolveTimelineAssetDrop,
 } from "./timelineLayout";
 
+describe("variable timeline row geometry", () => {
+  const tracks = [
+    [{ clipId: "a", laneCount: 0 }],
+    [{ clipId: "b", laneCount: 2 }],
+    [{ clipId: "c", laneCount: 1 }],
+  ];
+
+  it("resolves every row to the base height when no clip is expanded", () => {
+    expect(trackHeights(tracks)).toEqual([TRACK_H, TRACK_H, TRACK_H]);
+    expect(trackHeights(3)).toEqual([TRACK_H, TRACK_H, TRACK_H]);
+  });
+
+  it("adds one lane height per lane on an expanded clip", () => {
+    expect(trackHeights(tracks, new Set(["b"]))).toEqual([TRACK_H, TRACK_H + 2 * LANE_H, TRACK_H]);
+  });
+
+  it("derives row tops from cumulative offsets", () => {
+    const heights = trackHeights(tracks, new Set(["b"]));
+    expect(getTimelineRowOffsets(heights)).toEqual([
+      0,
+      TRACK_H,
+      2 * TRACK_H + 2 * LANE_H,
+      3 * TRACK_H + 2 * LANE_H,
+    ]);
+    expect(getTimelineRowTop(2, heights)).toBe(RULER_H + TRACKS_TOP_PAD + 2 * TRACK_H + 2 * LANE_H);
+  });
+
+  it("maps y inside an expanded lane region back to the expanded track", () => {
+    const heights = trackHeights(tracks, new Set(["b"]));
+    const yInSecondExpandedLane = getTimelineRowTop(1, heights) + TRACK_H + LANE_H * 1.5;
+    const row = getTimelineRowFromY(yInSecondExpandedLane, heights);
+    expect(Math.floor(row)).toBe(1);
+    expect(row).toBeGreaterThan(1.5);
+    expect(row).toBeLessThan(2);
+  });
+
+  it("sums resolved row heights into the canvas height", () => {
+    const heights = trackHeights(tracks, new Set(["b"]));
+    expect(getTimelineCanvasHeight(heights)).toBe(
+      RULER_H + TRACKS_TOP_PAD + 3 * TRACK_H + 2 * LANE_H + TRACKS_BOTTOM_PAD,
+    );
+  });
+});
+
+describe("collapsed timeline row geometry characterization", () => {
+  it.each([
+    [0, 74],
+    [1, 122],
+    [4, 266],
+  ])("keeps row %i at content y=%i", (row, expectedTop) => {
+    expect(getTimelineRowTop(row)).toBe(expectedTop);
+  });
+
+  it.each([
+    [74, 0],
+    [86, 0.25],
+    [146, 1.5],
+    [290, 4.5],
+  ])("maps content y=%i to fractional row %f", (contentY, expectedRow) => {
+    expect(getTimelineRowFromY(contentY)).toBe(expectedRow);
+  });
+
+  it.each([
+    [0, 146],
+    [1, 194],
+    [3, 290],
+    [5, 386],
+  ])("keeps the %i-track canvas height at %i", (trackCount, expectedHeight) => {
+    expect(getTimelineCanvasHeight(trackCount)).toBe(expectedHeight);
+  });
+});
+
 describe("track-area breathing pad y-math", () => {
   describe("getTimelineRowTop", () => {
     it("offsets the first lane below the ruler by the top pad", () => {
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 9a1b51108e..615df7d670 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -4,25 +4,20 @@ import type { ZoomMode } from "../store/playerStore";
 /* ── Layout constants ──────────────────────────────────────────────── */
 export const GUTTER = 32;
 export const TRACK_H = 48;
+export const LANE_H = 28;
 export const RULER_H = 24;
 export const CLIP_Y = 3;
 export const CLIP_HANDLE_W = 18;
+
 /**
- * Half-width (as a fraction of TRACK_H) of the new-track INSERT band that
- * straddles each lane boundary. Deliberately equals the clip's vertical inset
- * (`CLIP_Y / TRACK_H`): a clip body fills [CLIP_Y, TRACK_H − CLIP_Y] of its row,
- * so the ONLY region this band covers is the visible empty gutter between two
- * clip bodies (plus the top/bottom breathing pads, handled separately by the
- * rowFloat ≤ 0 / ≥ trackCount extremes). Aiming at a clip body is therefore a
- * move-to-that-lane; only the inter-clip gap arms an insert — see resolveInsertRow.
- * Threaded into resolveInsertRow by the drag preview so the hit band can never
- * drift from the rendered clip geometry.
+ * Collapsed-row characterization value for the new-track INSERT band. Runtime
+ * hit-testing uses getTimelineInsertBoundaryBand with the concrete row height.
  */
 export const INSERT_BOUNDARY_BAND = CLIP_Y / TRACK_H;
 /**
  * Breathing room INSIDE the scroll area (CapCut-style), threaded through every
  * track-row y computation via {@link getTimelineRowTop} — never inline a magic
- * offset; a track row's top is always `RULER_H + TRACKS_TOP_PAD + row*TRACK_H`.
+ * offset; a track row's top is always ruler + top pad + cumulative row heights.
  *
  * - TRACKS_TOP_PAD: empty space between the (sticky) ruler and the first track
  *   (~half a track height) so the first clip isn't jammed under the ruler.
@@ -50,17 +45,108 @@ export const TRACKS_LEFT_PAD = 48;
  * placeholder/insertion top and every pointer-y→row inversion goes through this
  * (or its inverse in {@link getTimelineRowFromY}) so the pad can never drift.
  */
-export function getTimelineRowTop(row: number): number {
-  return RULER_H + TRACKS_TOP_PAD + row * TRACK_H;
+interface TimelineTrackHeightClip {
+  clipId: string;
+  laneCount: number;
+}
+
+type TimelineTrackHeightInput = readonly (readonly TimelineTrackHeightClip[])[];
+
+/**
+ * Resolve each track's full height. Without expansion state every row is the
+ * legacy TRACK_H; if multiple clips in one track expand, the tallest one owns
+ * the shared row height.
+ */
+export function trackHeights(
+  tracks: number | TimelineTrackHeightInput,
+  expandedClipIds?: ReadonlySet<string>,
+): number[] {
+  if (typeof tracks === "number") {
+    return Array.from({ length: Math.max(0, Math.trunc(tracks)) }, () => TRACK_H);
+  }
+  return tracks.map((clips) => {
+    let laneCount = 0;
+    if (expandedClipIds) {
+      for (const clip of clips) {
+        if (expandedClipIds.has(clip.clipId)) laneCount = Math.max(laneCount, clip.laneCount);
+      }
+    }
+    return TRACK_H + Math.max(0, Math.trunc(laneCount)) * LANE_H;
+  });
+}
+
+function validRowHeight(height: number | undefined): number {
+  if (height === undefined || !Number.isFinite(height) || height <= 0) return TRACK_H;
+  return height;
+}
+
+/** Cumulative top offsets, including the final bottom boundary. */
+export function getTimelineRowOffsets(rowHeights: readonly number[]): number[] {
+  const offsets = [0];
+  for (const height of rowHeights) {
+    offsets.push((offsets[offsets.length - 1] ?? 0) + validRowHeight(height));
+  }
+  return offsets;
+}
+
+export function getTimelineRowHeight(row: number, rowHeights: readonly number[] = []): number {
+  return validRowHeight(rowHeights[row]);
+}
+
+function getTimelineRowOffset(row: number, rowHeights: readonly number[]): number {
+  if (rowHeights.length === 0) return row * TRACK_H;
+  const offsets = getTimelineRowOffsets(rowHeights);
+  if (row <= 0) return row * getTimelineRowHeight(0, rowHeights);
+  if (row >= rowHeights.length) {
+    return (offsets[rowHeights.length] ?? 0) + (row - rowHeights.length) * TRACK_H;
+  }
+  const wholeRow = Math.floor(row);
+  const fraction = row - wholeRow;
+  return (offsets[wholeRow] ?? 0) + fraction * getTimelineRowHeight(wholeRow, rowHeights);
+}
+
+export function getTimelineRowTop(row: number, rowHeights: readonly number[] = []): number {
+  return RULER_H + TRACKS_TOP_PAD + getTimelineRowOffset(row, rowHeights);
 }
 
 /**
  * Inverse of {@link getTimelineRowTop}: the fractional row index for a content-
- * space y (used for insert-row / drop-lane decisions). Subtracts the ruler and
- * top pad before dividing by the track height.
+ * space y (used for insert-row / drop-lane decisions). Locates the concrete row
+ * from cumulative offsets, then returns its local fractional position.
  */
-export function getTimelineRowFromY(contentY: number): number {
-  return (contentY - RULER_H - TRACKS_TOP_PAD) / TRACK_H;
+export function getTimelineRowFromY(contentY: number, rowHeights: readonly number[] = []): number {
+  const y = contentY - RULER_H - TRACKS_TOP_PAD;
+  if (rowHeights.length === 0) return y / TRACK_H;
+  if (y < 0) return y / getTimelineRowHeight(0, rowHeights);
+
+  const offsets = getTimelineRowOffsets(rowHeights);
+  for (let row = 0; row < rowHeights.length; row += 1) {
+    const bottom = offsets[row + 1] ?? 0;
+    if (y < bottom) {
+      const top = offsets[row] ?? 0;
+      return row + (y - top) / getTimelineRowHeight(row, rowHeights);
+    }
+  }
+  return rowHeights.length + (y - (offsets[rowHeights.length] ?? 0)) / TRACK_H;
+}
+
+export function getTimelineRowPositionFromY(
+  contentY: number,
+  rowHeights: readonly number[] = [],
+): { rowFloat: number; row: number; fraction: number; rowHeight: number } {
+  const rowFloat = getTimelineRowFromY(contentY, rowHeights);
+  const row = Math.floor(rowFloat);
+  return {
+    rowFloat,
+    row,
+    fraction: rowFloat - row,
+    rowHeight: getTimelineRowHeight(row, rowHeights),
+  };
+}
+
+/** Fractional insert band for the concrete row under a pointer. */
+export function getTimelineInsertBoundaryBand(rowHeight: number): number {
+  return CLIP_Y / validRowHeight(rowHeight);
 }
 /**
  * While a clip drag is live, the rendered timeline extends this far past the
@@ -344,11 +430,16 @@ export function getTimelineScrubTime(input: {
   return Math.max(0, Math.min(duration, x / pixelsPerSecond));
 }
 
-export function getTimelineCanvasHeight(trackCount: number): number {
+export function getTimelineCanvasHeight(trackCountOrHeights: number | readonly number[]): number {
   // RULER_H + top pad + lanes + bottom pad. The old TIMELINE_SCROLL_BUFFER is
   // subsumed by TRACKS_BOTTOM_PAD (which is larger), so the drag-into-void space
   // below the last lane is real scrollable surface, not a hidden buffer.
-  return RULER_H + TRACKS_TOP_PAD + Math.max(0, trackCount) * TRACK_H + TRACKS_BOTTOM_PAD;
+  const heights =
+    typeof trackCountOrHeights === "number"
+      ? trackHeights(trackCountOrHeights)
+      : trackCountOrHeights;
+  const rowsHeight = getTimelineRowOffsets(heights).at(-1) ?? 0;
+  return RULER_H + TRACKS_TOP_PAD + rowsHeight + TRACKS_BOTTOM_PAD;
 }
 
 /* ── UI helpers ───────────────────────────────────────────────────── */
diff --git a/packages/studio/src/player/components/timelineMarquee.test.ts b/packages/studio/src/player/components/timelineMarquee.test.ts
index 732076edb9..7c6673b552 100644
--- a/packages/studio/src/player/components/timelineMarquee.test.ts
+++ b/packages/studio/src/player/components/timelineMarquee.test.ts
@@ -9,6 +9,7 @@ import {
 } from "./timelineMarquee";
 import {
   GUTTER,
+  LANE_H,
   TRACK_H,
   RULER_H,
   CLIP_Y,
@@ -16,7 +17,9 @@ import {
   getTimelineRowTop,
 } from "./timelineLayout";
 
-// Canvas-space time origin: right edge of the sticky gutter + the left pad.
+// Canvas-space time origin used by the breathing-pad (default) test cases: right
+// edge of the sticky gutter + the left pad. Other cases pass GUTTER or LABEL_COL_W
+// directly as contentOrigin to test the plain/keyframe-label-column origins.
 const ORIGIN = GUTTER + TRACKS_LEFT_PAD;
 
 describe("isTimelineRulerPress", () => {
@@ -94,9 +97,9 @@ describe("getTimelineClipRect", () => {
   const trackOrder = [0, 2, 5];
 
   it("maps start/duration to x via pps and the track row to y via the shared row→y helper", () => {
-    const rect = getTimelineClipRect({ start: 2, duration: 3, track: 2 }, trackOrder, 100);
+    const rect = getTimelineClipRect({ start: 2, duration: 3, track: 2 }, trackOrder, 100, GUTTER);
     expect(rect).toEqual({
-      left: ORIGIN + 200,
+      left: GUTTER + 200,
       top: getTimelineRowTop(1) + CLIP_Y,
       width: 300,
       height: TRACK_H - CLIP_Y * 2,
@@ -104,25 +107,55 @@ describe("getTimelineClipRect", () => {
   });
 
   it("places the first visible track below the ruler + top breathing pad", () => {
-    const rect = getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, 50);
+    const rect = getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, 50, GUTTER);
     expect(rect?.top).toBe(getTimelineRowTop(0) + CLIP_Y);
-    expect(rect?.left).toBe(ORIGIN);
+    expect(rect?.left).toBe(GUTTER);
   });
 
   it("uses the row index in trackOrder, not the raw track number", () => {
-    const rect = getTimelineClipRect({ start: 0, duration: 1, track: 5 }, trackOrder, 50);
+    const rect = getTimelineClipRect({ start: 0, duration: 1, track: 5 }, trackOrder, 50, GUTTER);
     expect(rect?.top).toBe(getTimelineRowTop(2) + CLIP_Y);
   });
 
+  it("uses cumulative tops and the resolved height for an expanded row", () => {
+    const rowHeights = [TRACK_H + 2 * LANE_H, TRACK_H, TRACK_H];
+    const rect = getTimelineClipRect(
+      { start: 0, duration: 1, track: 0 },
+      trackOrder,
+      50,
+      GUTTER,
+      rowHeights,
+    );
+    expect(rect).toMatchObject({
+      top: getTimelineRowTop(0, rowHeights) + CLIP_Y,
+      height: rowHeights[0] - CLIP_Y * 2,
+    });
+    expect(
+      getTimelineClipRect({ start: 0, duration: 1, track: 2 }, trackOrder, 50, GUTTER, rowHeights)
+        ?.top,
+    ).toBe(getTimelineRowTop(1, rowHeights) + CLIP_Y);
+  });
+
   it("enforces the 4px minimum rendered width", () => {
-    const rect = getTimelineClipRect({ start: 0, duration: 0.01, track: 0 }, trackOrder, 10);
+    const rect = getTimelineClipRect(
+      { start: 0, duration: 0.01, track: 0 },
+      trackOrder,
+      10,
+      GUTTER,
+    );
     expect(rect?.width).toBe(4);
   });
 
   it("returns null for a track that is not displayed or an invalid pps", () => {
-    expect(getTimelineClipRect({ start: 0, duration: 1, track: 9 }, trackOrder, 100)).toBeNull();
-    expect(getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, 0)).toBeNull();
-    expect(getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, NaN)).toBeNull();
+    expect(
+      getTimelineClipRect({ start: 0, duration: 1, track: 9 }, trackOrder, 100, GUTTER),
+    ).toBeNull();
+    expect(
+      getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, 0, GUTTER),
+    ).toBeNull();
+    expect(
+      getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, NaN, GUTTER),
+    ).toBeNull();
   });
 });
 
@@ -140,29 +173,48 @@ describe("computeMarqueeSelection", () => {
 
   it("selects only the clips the marquee rect intersects", () => {
     const marquee = { left: ORIGIN, top: row0Top, width: 50, height: 10 };
-    const { ids, primaryId } = computeMarqueeSelection({ clips, trackOrder, pps, marquee });
+    const { ids, primaryId } = computeMarqueeSelection({
+      clips,
+      trackOrder,
+      pps,
+      contentOrigin: ORIGIN,
+      marquee,
+    });
     expect(ids).toEqual(new Set(["a"]));
     expect(primaryId).toBe("a");
   });
 
   it("selects across tracks when the rect spans multiple rows", () => {
     const marquee = { left: ORIGIN, top: row0Top, width: 60, height: row1Top - row0Top + 5 };
-    const { ids } = computeMarqueeSelection({ clips, trackOrder, pps, marquee });
+    const { ids } = computeMarqueeSelection({
+      clips,
+      trackOrder,
+      pps,
+      contentOrigin: ORIGIN,
+      marquee,
+    });
     expect(ids).toEqual(new Set(["a", "c"]));
   });
 
   it("excludes clips outside the rect horizontally", () => {
     const marquee = { left: ORIGIN + 140, top: row0Top, width: 50, height: 10 };
-    const { ids } = computeMarqueeSelection({ clips, trackOrder, pps, marquee });
+    const { ids } = computeMarqueeSelection({
+      clips,
+      trackOrder,
+      pps,
+      contentOrigin: ORIGIN,
+      marquee,
+    });
     expect(ids).toEqual(new Set());
   });
 
   it("returns null primaryId and keeps the base when nothing is hit (additive)", () => {
-    const marquee = { left: ORIGIN + 140, top: row0Top, width: 50, height: 10 };
+    const marquee = { left: GUTTER + 140, top: row0Top, width: 50, height: 10 };
     const { ids, primaryId } = computeMarqueeSelection({
       clips,
       trackOrder,
       pps,
+      contentOrigin: GUTTER,
       marquee,
       baseSelection: ["b"],
     });
@@ -171,11 +223,12 @@ describe("computeMarqueeSelection", () => {
   });
 
   it("unions additive base selection with new hits; primary comes from the marquee", () => {
-    const marquee = { left: ORIGIN, top: row1Top, width: 100, height: 10 };
+    const marquee = { left: GUTTER, top: row1Top, width: 100, height: 10 };
     const { ids, primaryId } = computeMarqueeSelection({
       clips,
       trackOrder,
       pps,
+      contentOrigin: GUTTER,
       marquee,
       baseSelection: ["b"],
     });
@@ -186,12 +239,13 @@ describe("computeMarqueeSelection", () => {
   it("shrinking the rect live drops clips it no longer covers", () => {
     const wide = { left: ORIGIN, top: row0Top, width: 320, height: 10 };
     const narrow = { left: ORIGIN, top: row0Top, width: 80, height: 10 };
-    expect(computeMarqueeSelection({ clips, trackOrder, pps, marquee: wide }).ids).toEqual(
-      new Set(["a", "b"]),
-    );
-    expect(computeMarqueeSelection({ clips, trackOrder, pps, marquee: narrow }).ids).toEqual(
-      new Set(["a"]),
-    );
+    expect(
+      computeMarqueeSelection({ clips, trackOrder, pps, contentOrigin: ORIGIN, marquee: wide }).ids,
+    ).toEqual(new Set(["a", "b"]));
+    expect(
+      computeMarqueeSelection({ clips, trackOrder, pps, contentOrigin: ORIGIN, marquee: narrow })
+        .ids,
+    ).toEqual(new Set(["a"]));
   });
 
   it("ignores clips on hidden/undisplayed tracks", () => {
@@ -200,6 +254,7 @@ describe("computeMarqueeSelection", () => {
       clips: [{ id: "x", start: 0, duration: 1, track: 7 }],
       trackOrder,
       pps,
+      contentOrigin: GUTTER,
       marquee,
     });
     expect(ids).toEqual(new Set());
diff --git a/packages/studio/src/player/components/timelineMarquee.ts b/packages/studio/src/player/components/timelineMarquee.ts
index 21c18913d1..9ddc02d9f3 100644
--- a/packages/studio/src/player/components/timelineMarquee.ts
+++ b/packages/studio/src/player/components/timelineMarquee.ts
@@ -1,9 +1,9 @@
 import {
   GUTTER,
-  TRACK_H,
   RULER_H,
   CLIP_Y,
   TRACKS_LEFT_PAD,
+  getTimelineRowHeight,
   getTimelineRowTop,
 } from "./timelineLayout";
 import { rectsOverlap, type Rect } from "../../utils/marqueeGeometry";
@@ -68,22 +68,24 @@ export function getMarqueeRect(
 
 /**
  * A clip's rendered rect in canvas/content coordinates (the same space the
- * marquee rect lives in): x from GUTTER + start * pps, y from the clip's row
- * index within the visible track order (RULER_H + row * TRACK_H + CLIP_Y).
+ * marquee rect lives in): x from the shared content origin + start * pps, y from the clip's row
+ * index within the visible track order (cumulative row top + CLIP_Y).
  * Returns null when the clip's track is not currently displayed.
  */
 export function getTimelineClipRect(
   clip: Pick<MarqueeClipInput, "start" | "duration" | "track">,
   trackOrder: number[],
   pps: number,
+  contentOrigin: number = GUTTER + TRACKS_LEFT_PAD,
+  rowHeights: readonly number[] = [],
 ): Rect | null {
   const row = trackOrder.indexOf(clip.track);
   if (row < 0 || !Number.isFinite(pps) || pps <= 0) return null;
   return {
-    left: GUTTER + TRACKS_LEFT_PAD + clip.start * pps,
-    top: getTimelineRowTop(row) + CLIP_Y,
+    left: contentOrigin + clip.start * pps,
+    top: getTimelineRowTop(row, rowHeights) + CLIP_Y,
     width: Math.max(clip.duration * pps, MIN_CLIP_W),
-    height: TRACK_H - CLIP_Y * 2,
+    height: getTimelineRowHeight(row, rowHeights) - CLIP_Y * 2,
   };
 }
 
@@ -103,13 +105,21 @@ export function computeMarqueeSelection(input: {
   clips: MarqueeClipInput[];
   trackOrder: number[];
   pps: number;
+  contentOrigin?: number;
   marquee: Rect;
   baseSelection?: Iterable<string>;
+  rowHeights?: readonly number[];
 }): MarqueeSelectionResult {
   const ids = new Set<string>(input.baseSelection ?? []);
   let primaryId: string | null = null;
   for (const clip of input.clips) {
-    const rect = getTimelineClipRect(clip, input.trackOrder, input.pps);
+    const rect = getTimelineClipRect(
+      clip,
+      input.trackOrder,
+      input.pps,
+      input.contentOrigin,
+      input.rowHeights,
+    );
     if (rect && rectsOverlap(rect, input.marquee)) {
       ids.add(clip.id);
       primaryId = clip.id;
diff --git a/packages/studio/src/player/components/useTimelineClipDrag.ts b/packages/studio/src/player/components/useTimelineClipDrag.ts
index 31050cccaa..90d4100813 100644
--- a/packages/studio/src/player/components/useTimelineClipDrag.ts
+++ b/packages/studio/src/player/components/useTimelineClipDrag.ts
@@ -48,6 +48,7 @@ interface UseTimelineClipDragInput {
   ppsRef: React.RefObject<number>;
   durationRef: React.RefObject<number>;
   trackOrderRef: React.RefObject<number[]>;
+  rowHeightsRef?: React.RefObject<readonly number[]>;
   onMoveElement?: (
     element: TimelineElement,
     updates: Pick<TimelineElement, "start" | "track">,
@@ -85,6 +86,7 @@ export function useTimelineClipDrag({
   ppsRef,
   durationRef,
   trackOrderRef,
+  rowHeightsRef,
   onMoveElement,
   onMoveElements,
   onResizeElement,
@@ -241,13 +243,14 @@ export function useTimelineClipDrag({
         pps: ppsRef.current,
         duration: durationRef.current,
         trackOrder: trackOrderRef.current,
+        rowHeights: rowHeightsRef?.current,
         elements: elementsRef.current,
         selectedKeys: usePlayerStore.getState().selectedElementIds,
         buildSnapTargets,
         audioTracks: dragAudioTracksRef.current,
       });
     },
-    [scrollRef, ppsRef, durationRef, trackOrderRef, buildSnapTargets],
+    [scrollRef, ppsRef, durationRef, trackOrderRef, rowHeightsRef, buildSnapTargets],
   );
 
   // Recompute the trim preview for a pointer x. Shared by the pointermove resize

From 95213d73536dfa29eae931672a8c875a22f5ff3e Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 00:54:23 +0200
Subject: [PATCH 070/125] refactor(studio): give resolveTimelineMove a
 row-based vertical axis

Rows stopped sharing one pixel height when lanes gained expansion, so the only
production caller was passing cumulative row coordinates with trackHeight 1 and
both scrollTops zeroed. The parameter names described units the values no longer
carried. The vertical axis is now a row index and the caller keeps ownership of
folding scroll and per-row heights into it.
---
 .../components/timelineClipDragPreview.ts     | 10 ++--
 .../player/components/timelineEditing.test.ts | 46 ++++++++-----------
 .../src/player/components/timelineEditing.ts  | 15 +++---
 3 files changed, 29 insertions(+), 42 deletions(-)

diff --git a/packages/studio/src/player/components/timelineClipDragPreview.ts b/packages/studio/src/player/components/timelineClipDragPreview.ts
index e5c054c035..982f42fbff 100644
--- a/packages/studio/src/player/components/timelineClipDragPreview.ts
+++ b/packages/studio/src/player/components/timelineClipDragPreview.ts
@@ -139,22 +139,18 @@ export function computeDragPreview(
     ctx.rowHeights,
   );
   const currentRow = getTimelineRowFromY(clientY - scrollRectTop + scrollTop, ctx.rowHeights);
-  // resolveTimelineMove's vertical axis is expressed in track-height units.
-  // Feeding cumulative row coordinates with a unit height preserves its existing
-  // threshold/create-track behavior while supporting variable pixel heights.
+  // resolveTimelineMove's vertical axis is row indices, which is why the pointer
+  // and scroll pixels are folded into originRow/currentRow above.
   const nextMove = resolveTimelineMove(
     {
       start: drag.element.start,
       track: drag.element.track,
       duration: drag.element.duration,
       originClientX: drag.originClientX,
-      originClientY: originRow,
+      originRow,
       originScrollLeft: drag.originScrollLeft,
-      originScrollTop: 0,
       currentScrollLeft: scroll?.scrollLeft ?? drag.originScrollLeft,
-      currentScrollTop: 0,
       pixelsPerSecond: pps,
-      trackHeight: 1,
       maxStart: dragMaxStart,
       trackOrder,
     },
diff --git a/packages/studio/src/player/components/timelineEditing.test.ts b/packages/studio/src/player/components/timelineEditing.test.ts
index f2c2913ead..fc5aa95533 100644
--- a/packages/studio/src/player/components/timelineEditing.test.ts
+++ b/packages/studio/src/player/components/timelineEditing.test.ts
@@ -27,14 +27,13 @@ describe("resolveTimelineMove", () => {
           track: 2,
           duration: 2,
           originClientX: 100,
-          originClientY: 200,
+          originRow: 0,
           pixelsPerSecond: 100,
-          trackHeight: 72,
           maxStart: 8,
           trackOrder: [0, 1, 2, 3, 4],
         },
         245,
-        200,
+        0,
       ),
     ).toEqual({ start: 2.7, track: 2 });
   });
@@ -47,14 +46,13 @@ describe("resolveTimelineMove", () => {
           track: 1,
           duration: 3,
           originClientX: 200,
-          originClientY: 200,
+          originRow: 0,
           pixelsPerSecond: 100,
-          trackHeight: 72,
           maxStart: 10,
           trackOrder: [0, 1, 5, 9],
         },
         150,
-        390,
+        190 / 72,
       ),
     ).toEqual({ start: 1.5, track: 9 });
   });
@@ -67,14 +65,13 @@ describe("resolveTimelineMove", () => {
           track: 0,
           duration: 4,
           originClientX: 300,
-          originClientY: 200,
+          originRow: 0,
           pixelsPerSecond: 100,
-          trackHeight: 72,
           maxStart: 6,
           trackOrder: [0, 10, 20],
         },
         -100,
-        -200,
+        -400 / 72,
       ),
     ).toEqual({ start: 0, track: -1 });
 
@@ -85,14 +82,13 @@ describe("resolveTimelineMove", () => {
           track: 10,
           duration: 4,
           originClientX: 300,
-          originClientY: 200,
+          originRow: 0,
           pixelsPerSecond: 100,
-          trackHeight: 72,
           maxStart: 6,
           trackOrder: [0, 10, 20],
         },
         500,
-        200,
+        0,
       ),
     ).toEqual({ start: 6, track: 10 });
   });
@@ -105,14 +101,13 @@ describe("resolveTimelineMove", () => {
           track: 0,
           duration: 2,
           originClientX: 100,
-          originClientY: 200,
+          originRow: 0,
           pixelsPerSecond: 100,
-          trackHeight: 72,
           maxStart: 8,
           trackOrder: [0, 10, 20],
         },
         100,
-        150,
+        -50 / 72,
       ),
     ).toEqual({ start: 1, track: -1 });
   });
@@ -125,19 +120,18 @@ describe("resolveTimelineMove", () => {
           track: 20,
           duration: 2,
           originClientX: 100,
-          originClientY: 200,
+          originRow: 0,
           pixelsPerSecond: 100,
-          trackHeight: 72,
           maxStart: 8,
           trackOrder: [0, 10, 20],
         },
         100,
-        250,
+        50 / 72,
       ),
     ).toEqual({ start: 1, track: 21 });
   });
 
-  it("accounts for scroll displacement while dragging", () => {
+  it("accounts for horizontal scroll displacement while dragging", () => {
     expect(
       resolveTimelineMove(
         {
@@ -145,18 +139,17 @@ describe("resolveTimelineMove", () => {
           track: 0,
           duration: 2,
           originClientX: 100,
-          originClientY: 200,
+          originRow: 0,
           originScrollLeft: 0,
-          originScrollTop: 0,
           currentScrollLeft: 100,
-          currentScrollTop: 144,
           pixelsPerSecond: 100,
-          trackHeight: 72,
           maxStart: 8,
+          // Vertical scroll never reaches here: the drag preview folds it into the
+          // row index it passes, because rows no longer share one pixel height.
           trackOrder: [0, 1, 2, 3],
         },
         100,
-        200,
+        2,
       ),
     ).toEqual({ start: 2, track: 2 });
   });
@@ -195,9 +188,8 @@ describe("resolveTimelineMove", () => {
         track: 1,
         duration: 2,
         originClientX: 0,
-        originClientY: 0,
+        originRow: 0,
         pixelsPerSecond: 100,
-        trackHeight: 72,
         maxStart: 8,
         trackOrder: [0, 1],
         layerOrder: layers.map((layer) => layer.id),
@@ -206,7 +198,7 @@ describe("resolveTimelineMove", () => {
         stackingElements,
       },
       0,
-      -72,
+      -1,
     );
 
     expect(result).toEqual({
diff --git a/packages/studio/src/player/components/timelineEditing.ts b/packages/studio/src/player/components/timelineEditing.ts
index 9b08a67ce6..f183807b08 100644
--- a/packages/studio/src/player/components/timelineEditing.ts
+++ b/packages/studio/src/player/components/timelineEditing.ts
@@ -46,13 +46,11 @@ export interface TimelineMoveInput {
   track: number;
   duration: number;
   originClientX: number;
-  originClientY: number;
+  /** Vertical position as a track-row index, not pixels: rows vary in height. */
+  originRow: number;
   originScrollLeft?: number;
-  originScrollTop?: number;
   currentScrollLeft?: number;
-  currentScrollTop?: number;
   pixelsPerSecond: number;
-  trackHeight: number;
   maxStart: number;
   trackOrder: number[];
   layerOrder?: TimelineLayerId[];
@@ -108,7 +106,7 @@ export function resolveTimelineAutoScroll(
 export function resolveTimelineMove(
   input: TimelineMoveInput,
   clientX: number,
-  clientY: number,
+  currentRow: number,
 ): {
   start: number;
   track: number;
@@ -117,11 +115,12 @@ export function resolveTimelineMove(
   stackingReorder?: TimelineStackingReorderIntent | null;
 } {
   const scrollDeltaX = (input.currentScrollLeft ?? 0) - (input.originScrollLeft ?? 0);
-  const scrollDeltaY = (input.currentScrollTop ?? 0) - (input.originScrollTop ?? 0);
   const deltaTime =
     (clientX - input.originClientX + scrollDeltaX) / Math.max(input.pixelsPerSecond, 1);
-  const trackDeltaRaw =
-    (clientY - input.originClientY + scrollDeltaY) / Math.max(input.trackHeight, 1);
+  // Rows, so vertical scroll and per-row heights are the caller's problem: rows
+  // have varied in height since lanes expand, and a single trackHeight can't
+  // describe them.
+  const trackDeltaRaw = currentRow - input.originRow;
   const deltaTrack = Math.round(trackDeltaRaw);
   const nextStart = clamp(
     roundToCentiseconds(input.start + deltaTime),

From 4c7703ff8f136b44db21e5e81061a79c959c2bd0 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 02:16:28 +0200
Subject: [PATCH 071/125] refactor(studio): drop the duplicated row-top
 docblock

The getTimelineRowTop docblock had a second copy sitting on
TimelineTrackHeightClip, where it describes nothing. Only the one on the
function stays.
---
 .../studio/src/player/components/timelineLayout.ts | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 615df7d670..2677bf3a45 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -38,13 +38,6 @@ export const TRACKS_BOTTOM_PAD = Math.round(TRACK_H * 1.5);
  */
 export const TRACKS_LEFT_PAD = 48;
 
-/**
- * The y (content-space) of the top edge of track ROW index `row` (0 = first
- * displayed lane). The single source of truth for row→y — the ruler height plus
- * the top breathing pad plus whole track lanes above it. Every clip/ghost/
- * placeholder/insertion top and every pointer-y→row inversion goes through this
- * (or its inverse in {@link getTimelineRowFromY}) so the pad can never drift.
- */
 interface TimelineTrackHeightClip {
   clipId: string;
   laneCount: number;
@@ -105,6 +98,13 @@ function getTimelineRowOffset(row: number, rowHeights: readonly number[]): numbe
   return (offsets[wholeRow] ?? 0) + fraction * getTimelineRowHeight(wholeRow, rowHeights);
 }
 
+/**
+ * The y (content-space) of the top edge of track ROW index `row` (0 = first
+ * displayed lane). The single source of truth for row→y — the ruler height plus
+ * the top breathing pad plus whole track lanes above it. Every clip/ghost/
+ * placeholder/insertion top and every pointer-y→row inversion goes through this
+ * (or its inverse in {@link getTimelineRowFromY}) so the pad can never drift.
+ */
 export function getTimelineRowTop(row: number, rowHeights: readonly number[] = []): number {
   return RULER_H + TRACKS_TOP_PAD + getTimelineRowOffset(row, rowHeights);
 }

From e36fb385bc71af52c16c7e6059305c4bc2da2b7a Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 16:46:58 +0200
Subject: [PATCH 072/125] feat(studio): add timeline keyframe retiming
 interactions

---
 .../components/editor/keyframeRetime.test.ts  |  11 +-
 .../src/components/editor/keyframeRetime.ts   |   3 +-
 .../nle/useTimelineEditCallbacks.ts           |   9 +-
 .../components/KeyframeDiamondContextMenu.tsx |  34 +-
 .../components/TimelineClipDiamonds.test.tsx  | 322 +++++++++++++++++-
 .../components/TimelineClipDiamonds.tsx       | 284 +++++++++++++--
 .../src/player/components/TimelineLanes.tsx   |   2 +-
 .../player/components/timelineCallbacks.ts    |   2 +-
 .../components/timelineKeyframeIdentity.ts    |  17 +
 .../useTimelineKeyframeHandlers.test.tsx      | 108 ++++++
 .../components/useTimelineKeyframeHandlers.ts |  57 +++-
 11 files changed, 772 insertions(+), 77 deletions(-)
 create mode 100644 packages/studio/src/player/components/timelineKeyframeIdentity.ts
 create mode 100644 packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx

diff --git a/packages/studio/src/components/editor/keyframeRetime.test.ts b/packages/studio/src/components/editor/keyframeRetime.test.ts
index 876c5129a5..fc8844e54d 100644
--- a/packages/studio/src/components/editor/keyframeRetime.test.ts
+++ b/packages/studio/src/components/editor/keyframeRetime.test.ts
@@ -1,3 +1,6 @@
+// Boundary cases share an arrange/assert shape on purpose: each case states its
+// own window, drag, and expected remap so a failure reads without cross-referencing.
+// fallow-ignore-file code-duplication
 import { describe, expect, it } from "vitest";
 import { resolveKeyframeRetime, type RetimeKeyframe } from "./keyframeRetime";
 
@@ -94,12 +97,12 @@ describe("resolveKeyframeRetime — resize (past the tween boundary)", () => {
     expect(r.kind).toBe("resize");
     expect(r.position).toBeCloseTo(2, 5); // start unchanged
     expect(r.duration).toBeCloseTo(6, 5); // 8 - 2
-    // abs 2/4/8 over the new [2,8] window → 0 / 33.3 / 100. pctRemap carries each
+    // abs 2/4/8 over the new [2,8] window → 0 / 33.333 / 100. pctRemap carries each
     // existing keyframe's old→new tween-%; the commit re-keys in place (value +
     // ease + _auto preserved by round-tripping the source node, not re-emitted here).
     expect(r.pctRemap).toEqual([
       { from: 0, to: 0 },
-      { from: 50, to: 33.3 },
+      { from: 50, to: 33.333 },
       { from: 100, to: 100 },
     ]);
   });
@@ -113,10 +116,10 @@ describe("resolveKeyframeRetime — resize (past the tween boundary)", () => {
     expect(r.kind).toBe("resize");
     expect(r.position).toBeCloseTo(0.5, 5);
     expect(r.duration).toBeCloseTo(5.5, 5); // 6 - 0.5
-    // abs 0.5/4/6 over [0.5,6] → 0 / 63.6 / 100.
+    // abs 0.5/4/6 over [0.5,6] → 0 / 63.636 / 100.
     expect(r.pctRemap).toEqual([
       { from: 0, to: 0 },
-      { from: 50, to: 63.6 },
+      { from: 50, to: 63.636 },
       { from: 100, to: 100 },
     ]);
   });
diff --git a/packages/studio/src/components/editor/keyframeRetime.ts b/packages/studio/src/components/editor/keyframeRetime.ts
index f235b418ed..f7fa1d1344 100644
--- a/packages/studio/src/components/editor/keyframeRetime.ts
+++ b/packages/studio/src/components/editor/keyframeRetime.ts
@@ -55,7 +55,6 @@ const EPSILON_TIME = 1e-4;
 const MIN_TWEEN_DURATION = 0.01;
 
 const round3 = (n: number) => Math.round(n * 1000) / 1000;
-const round1 = (n: number) => Math.round(n * 10) / 10; // 0.1% precision
 const clamp = (n: number, lo: number, hi: number) => Math.max(lo, Math.min(hi, n));
 
 /** Resolve timing for a flat tween's synthesized start/end diamond. */
@@ -153,7 +152,7 @@ export function resolveKeyframeRetime(opts: {
   const pctRemap: KeyframePctRemap[] = keyframes.map((kf, i) => {
     const absTime =
       i === draggedIdx ? dropAbsTime : tweenStart + (kf.percentage / 100) * tweenDuration;
-    return { from: kf.percentage, to: round1(((absTime - newStart) / newDuration) * 100) };
+    return { from: kf.percentage, to: round3(((absTime - newStart) / newDuration) * 100) };
   });
 
   return {
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index 76122eb47c..a1fa658521 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -152,13 +152,13 @@ export function useTimelineEditCallbacks({
       // resizes the tween — position/duration grow so the dragged keyframe lands at
       // the drop while every other keyframe keeps its absolute time (value+ease too).
       // fallow-ignore-next-line complexity
-      onMoveKeyframe: (_elId: string, fromClipPct: number, toClipPct: number) => {
+      onMoveKeyframe: async (_elId: string, fromClipPct: number, toClipPct: number) => {
         const target = resolveKeyframeTarget(fromClipPct);
         const sel = domEditSelection;
-        if (!target || !sel) return;
+        if (!target || !sel) return false;
         const anim = selectedGsapAnimations.find((a) => a.id === target.animId);
         const tweenStart = anim ? resolveTweenStart(anim) : null;
-        if (!anim || tweenStart === null) return;
+        if (!anim || tweenStart === null) return false;
         const tweenDuration = anim.duration ?? resolveTweenDuration(anim);
         const sourceFile = sel.sourceFile || activeCompPath || "index.html";
         const { elements, domClipChildren } = usePlayerStore.getState();
@@ -200,7 +200,10 @@ export function useTimelineEditCallbacks({
               duration: decision.duration,
             });
           }
+        } else {
+          return false;
         }
+        return true;
       },
       onChangeKeyframeEase: (_elId: string, _pct: number, ease: string) => {
         for (const anim of selectedGsapAnimations) {
diff --git a/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx b/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
index 34a1cc41ff..e40f0c295b 100644
--- a/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
+++ b/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
@@ -8,18 +8,32 @@ export interface KeyframeDiamondContextMenuState {
   elementId: string;
   percentage: number;
   tweenPercentage?: number;
+  propertyGroup?: string;
+  animationId?: string;
   currentEase?: string;
 }
 
 interface KeyframeDiamondContextMenuProps {
   state: KeyframeDiamondContextMenuState;
   onClose: () => void;
-  onDelete: (elementId: string, percentage: number) => void;
+  onDelete: (
+    elementId: string,
+    percentage: number,
+    propertyGroup?: string,
+    tweenPercentage?: number,
+    animationId?: string,
+  ) => void;
   onDeleteAll: (elementId: string) => void;
   onChangeEase?: (elementId: string, percentage: number, ease: string) => void;
   onCopyProperties?: (elementId: string, percentage: number) => void;
   /** Retime the keyframe to the current playhead, preserving its value + ease. */
-  onMoveToPlayhead?: (elementId: string, fromPercentage: number) => void;
+  onMoveToPlayhead?: (
+    elementId: string,
+    fromPercentage: number,
+    propertyGroup?: string,
+    tweenPercentage?: number,
+    animationId?: string,
+  ) => void;
 }
 
 export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMenu({
@@ -51,7 +65,13 @@ export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMe
             // Pass clip-% — resolveKeyframeTarget keys the cache lookup on clip-%
             // and returns the tween-% for the mutation. Passing tween-% here would
             // miss the lookup on any tween whose window is shorter than the clip.
-            onMoveToPlayhead(state.elementId, state.percentage);
+            onMoveToPlayhead(
+              state.elementId,
+              state.percentage,
+              state.propertyGroup,
+              state.tweenPercentage,
+              state.animationId,
+            );
             onClose();
           }}
         >
@@ -64,7 +84,13 @@ export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMe
         type="button"
         className="w-full flex items-center gap-2 px-3 py-1.5 text-xs text-red-400 hover:bg-neutral-800 cursor-pointer text-left"
         onClick={() => {
-          onDelete(state.elementId, state.percentage);
+          onDelete(
+            state.elementId,
+            state.percentage,
+            state.propertyGroup,
+            state.tweenPercentage,
+            state.animationId,
+          );
           onClose();
         }}
       >
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
index 254e5d6086..d22ac46a11 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
@@ -3,7 +3,7 @@
 import React, { act } from "react";
 import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
-import { TimelineClipDiamonds } from "./TimelineClipDiamonds";
+import { TimelineClipDiamonds, TimelineDiamondLane } from "./TimelineClipDiamonds";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
@@ -84,12 +84,24 @@ describe("TimelineClipDiamonds", () => {
     const root = createRoot(host);
     act(() => {
       root.render(
-        <TimelineClipDiamonds
+        <TimelineDiamondLane
           keyframesData={{
             format: "percentage",
             keyframes: [
-              { percentage: 0, properties: { x: 0 } },
-              { percentage: 50, properties: { x: 100 } },
+              {
+                percentage: 0,
+                tweenPercentage: 0,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 0 },
+              },
+              {
+                percentage: 50,
+                tweenPercentage: 100,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 100 },
+              },
             ],
           }}
           clipWidthPx={5000}
@@ -101,6 +113,7 @@ describe("TimelineClipDiamonds", () => {
           selectedKeyframes={new Set()}
           onClickKeyframe={onClickKeyframe}
           onMoveKeyframe={onMoveKeyframe}
+          groupAware
         />,
       );
     });
@@ -117,7 +130,12 @@ describe("TimelineClipDiamonds", () => {
       diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 104 }));
     });
 
-    expect(onClickKeyframe).toHaveBeenCalledWith(50);
+    expect(onClickKeyframe).toHaveBeenCalledWith({
+      percentage: 50,
+      tweenPercentage: 100,
+      propertyGroup: "position",
+      animationId: "anim-1",
+    });
     expect(onMoveKeyframe).not.toHaveBeenCalled();
     act(() => root.unmount());
   });
@@ -126,20 +144,39 @@ describe("TimelineClipDiamonds", () => {
   // keyframe) committed the move but never selected/parked on the result —
   // the diamond it was just dragged looked exactly like one nothing happened
   // to. Select it at its NEW position too.
-  it("selects the keyframe at its new position after a real drag-retime", () => {
+  it("reselects a retimed keyframe with its post-move tween percentage", () => {
     const onClickKeyframe = vi.fn();
-    const onMoveKeyframe = vi.fn();
+    const onMoveKeyframe = vi.fn().mockResolvedValue(true);
     const host = document.createElement("div");
     document.body.append(host);
     const root = createRoot(host);
     act(() => {
       root.render(
-        <TimelineClipDiamonds
+        <TimelineDiamondLane
           keyframesData={{
             format: "percentage",
             keyframes: [
-              { percentage: 0, properties: { x: 0 } },
-              { percentage: 50, properties: { x: 100 } },
+              {
+                percentage: 20,
+                tweenPercentage: 0,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 0 },
+              },
+              {
+                percentage: 40,
+                tweenPercentage: 50,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 100 },
+              },
+              {
+                percentage: 60,
+                tweenPercentage: 100,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 200 },
+              },
             ],
           }}
           clipWidthPx={200}
@@ -151,6 +188,81 @@ describe("TimelineClipDiamonds", () => {
           selectedKeyframes={new Set()}
           onClickKeyframe={onClickKeyframe}
           onMoveKeyframe={onMoveKeyframe}
+          groupAware
+        />,
+      );
+    });
+    const diamond = host.querySelector<HTMLButtonElement>('button[title="40%"]');
+    expect(diamond).not.toBeNull();
+
+    act(() => {
+      diamond!.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 80 }),
+      );
+      diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 100 }));
+    });
+
+    expect(onMoveKeyframe).toHaveBeenCalledWith(
+      {
+        percentage: 40,
+        tweenPercentage: 50,
+        propertyGroup: "position",
+        animationId: "anim-1",
+      },
+      50,
+    );
+    expect(onClickKeyframe).toHaveBeenCalledWith({
+      percentage: 50,
+      tweenPercentage: 75,
+      propertyGroup: "position",
+      animationId: "anim-1",
+    });
+    act(() => root.unmount());
+  });
+
+  it("composes a rapid second retime from the pending position", () => {
+    const onMoveKeyframe = vi.fn().mockResolvedValue(true);
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() => {
+      root.render(
+        <TimelineDiamondLane
+          keyframesData={{
+            format: "percentage",
+            keyframes: [
+              {
+                percentage: 0,
+                tweenPercentage: 0,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 0 },
+              },
+              {
+                percentage: 50,
+                tweenPercentage: 50,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 100 },
+              },
+              {
+                percentage: 100,
+                tweenPercentage: 100,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 200 },
+              },
+            ],
+          }}
+          clipWidthPx={200}
+          clipHeightPx={48}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={0}
+          elementId="clip-1"
+          selectedKeyframes={new Set()}
+          onMoveKeyframe={onMoveKeyframe}
+          groupAware
         />,
       );
     });
@@ -161,13 +273,109 @@ describe("TimelineClipDiamonds", () => {
       diamond!.dispatchEvent(
         pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100 }),
       );
-      // 4px at a 200px clip width is 2 clip-% — well past the no-op epsilon,
-      // a real retime.
-      diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 104 }));
+      diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 150 }));
+
+      // The cache still exposes 50%, but this second +10% drag starts at the
+      // pending 75% destination and must therefore land at 85%, not 60%.
+      diamond!.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 150 }),
+      );
+      diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 170 }));
+    });
+
+    // The second move must identify the FROM keyframe by the pending (already-
+    // moved) position 75%, not the stale rendered 50%; otherwise the serialized
+    // mutation can't locate the keyframe the first move relocated.
+    expect(onMoveKeyframe).toHaveBeenNthCalledWith(
+      2,
+      {
+        percentage: 75,
+        tweenPercentage: 75,
+        propertyGroup: "position",
+        animationId: "anim-1",
+      },
+      85,
+    );
+    act(() => root.unmount());
+  });
+
+  it.each([
+    ["returns false", () => Promise.resolve(false)],
+    ["rejects", () => Promise.reject(new Error("retime failed"))],
+  ])("clears a failed pending retime when the callback %s", async (_label, settle) => {
+    const onMoveKeyframe = vi.fn().mockImplementationOnce(settle).mockResolvedValue(true);
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() => {
+      root.render(
+        <TimelineDiamondLane
+          keyframesData={{
+            format: "percentage",
+            keyframes: [
+              {
+                percentage: 0,
+                tweenPercentage: 0,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 0 },
+              },
+              {
+                percentage: 50,
+                tweenPercentage: 50,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 100 },
+              },
+              {
+                percentage: 100,
+                tweenPercentage: 100,
+                propertyGroup: "position",
+                animationId: "anim-1",
+                properties: { x: 200 },
+              },
+            ],
+          }}
+          clipWidthPx={200}
+          clipHeightPx={48}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={0}
+          elementId="clip-1"
+          selectedKeyframes={new Set()}
+          onMoveKeyframe={onMoveKeyframe}
+          groupAware
+        />,
+      );
     });
+    const diamond = host.querySelector<HTMLButtonElement>('button[title="50%"]');
+    expect(diamond).not.toBeNull();
 
-    expect(onMoveKeyframe).toHaveBeenCalledWith("clip-1", 50, 52);
-    expect(onClickKeyframe).toHaveBeenCalledWith(52);
+    await act(async () => {
+      diamond!.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100 }),
+      );
+      diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 150 }));
+      await Promise.resolve();
+    });
+
+    act(() => {
+      diamond!.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100 }),
+      );
+      diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120 }));
+    });
+
+    expect(onMoveKeyframe).toHaveBeenNthCalledWith(
+      2,
+      {
+        percentage: 50,
+        tweenPercentage: 50,
+        propertyGroup: "position",
+        animationId: "anim-1",
+      },
+      60,
+    );
     act(() => root.unmount());
   });
 
@@ -212,4 +420,88 @@ describe("TimelineClipDiamonds", () => {
     expect(suppressClickRef.current).toBe(true);
     act(() => root.unmount());
   });
+
+  const renderSegmentLane = (lastAmbiguous: boolean) => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    const kf = (percentage: number, extra: Record<string, unknown> = {}) => ({
+      percentage,
+      tweenPercentage: percentage,
+      propertyGroup: "position",
+      animationId: "anim-1",
+      properties: { x: percentage },
+      ...extra,
+    });
+    act(() => {
+      root.render(
+        <TimelineDiamondLane
+          keyframesData={{
+            format: "percentage",
+            keyframes: [kf(0), kf(50), kf(100, { easeAmbiguous: lastAmbiguous })],
+          }}
+          clipWidthPx={200}
+          clipHeightPx={48}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={0}
+          elementId="clip-1"
+          selectedKeyframes={new Set()}
+          onSelectSegment={vi.fn()}
+          groupAware
+        />,
+      );
+    });
+    return { host, root };
+  };
+
+  it("hides the inline ease button on an ambiguous merged segment", () => {
+    // Segments 0->50 and 50->100; the 50->100 segment ends on the ambiguous
+    // keyframe, so its hover/ease-button area is not rendered.
+    const { host, root } = renderSegmentLane(true);
+    expect(host.querySelectorAll("[data-keyframe-ease-segment]").length).toBe(1);
+    act(() => root.unmount());
+  });
+
+  it("keeps the inline ease button on unambiguous merged segments", () => {
+    const { host, root } = renderSegmentLane(false);
+    expect(host.querySelectorAll("[data-keyframe-ease-segment]").length).toBe(2);
+    act(() => root.unmount());
+  });
+
+  it("hides the inline ease button on a segment with no source animation id", () => {
+    // A runtime-scanned keyframe has no animationId, so there is no tween to
+    // target; the segment ending on it must not render a (dead) ease button.
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    const kf = (percentage: number, animationId?: string) => ({
+      percentage,
+      tweenPercentage: percentage,
+      propertyGroup: "position",
+      ...(animationId ? { animationId } : {}),
+      properties: { x: percentage },
+    });
+    act(() => {
+      root.render(
+        <TimelineDiamondLane
+          keyframesData={{
+            format: "percentage",
+            keyframes: [kf(0, "anim-1"), kf(50, "anim-1"), kf(100)],
+          }}
+          clipWidthPx={200}
+          clipHeightPx={48}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={0}
+          elementId="clip-1"
+          selectedKeyframes={new Set()}
+          onSelectSegment={vi.fn()}
+          groupAware
+        />,
+      );
+    });
+    expect(host.querySelectorAll("[data-keyframe-ease-segment]").length).toBe(1);
+    act(() => root.unmount());
+  });
 });
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 129104dfb8..29fb6b9c77 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -1,22 +1,33 @@
-import { memo, useRef, useState } from "react";
+import { Fragment, memo, useEffect, useRef, useState } from "react";
 import { BEAT_BAND_H } from "./BeatStrip";
 import {
   KEYFRAME_DRAG_THRESHOLD_PX,
   previewClipPct,
   resolveKeyframeDrag,
 } from "../../components/editor/keyframeDrag";
-
-interface KeyframeEntry {
+import { MiniCurveSvg } from "../../components/editor/EaseCurveSection";
+import { clipToTweenPercentage } from "../../components/editor/KeyframeNavigation";
+import { LANE_H } from "./timelineLayout";
+import {
+  timelineKeyframeSelectionKey,
+  type TimelineKeyframeTarget,
+} from "./timelineKeyframeIdentity";
+interface TimelineDiamondKeyframe {
   percentage: number;
   /** Tween-relative percentage (the retime mutation keys on this, not clip %). */
   tweenPercentage?: number;
+  propertyGroup?: string;
+  animationId?: string;
   properties: Record<string, number | string>;
   ease?: string;
+  /** Set when 2+ source animations collide at this percentage (a single inline
+   *  ease button can't target one): the collapsed row hides the button here. */
+  easeAmbiguous?: boolean;
 }
 
 interface KeyframeCacheEntry {
   format: string;
-  keyframes: KeyframeEntry[];
+  keyframes: TimelineDiamondKeyframe[];
   ease?: string;
   easeEach?: string;
 }
@@ -32,7 +43,7 @@ interface TimelineClipDiamondsProps {
   isSelected: boolean;
   currentPercentage: number;
   elementId: string;
-  selectedKeyframes: Set<string>;
+  selectedKeyframes: ReadonlySet<string>;
   onClickKeyframe?: (percentage: number) => void;
   onShiftClickKeyframe?: (elementId: string, percentage: number) => void;
   onContextMenuKeyframe?: (e: React.MouseEvent, elementId: string, percentage: number) => void;
@@ -44,13 +55,33 @@ interface TimelineClipDiamondsProps {
     elementId: string,
     fromClipPercentage: number,
     toClipPercentage: number,
-  ) => void;
+  ) => Promise<boolean>;
+  /** Open the segment ease editor for the hovered mid-point button — available on
+   *  the inline clip row too, not just the expanded lanes. */
+  onSelectSegment?: (elementId: string, target: TimelineKeyframeTarget) => void;
   /** Set while resolving a diamond press so the ancestor clip's onClick (which
    *  toggles selection off when already selected) ignores the native "click"
    *  the browser auto-synthesizes after this button's pointerdown+pointerup. */
   suppressClickRef?: React.RefObject<boolean>;
 }
 
+interface TimelineDiamondLaneProps extends Omit<
+  TimelineClipDiamondsProps,
+  | "onClickKeyframe"
+  | "onShiftClickKeyframe"
+  | "onContextMenuKeyframe"
+  | "onMoveKeyframe"
+  | "onSelectSegment"
+> {
+  groupAware?: boolean;
+  globalEase?: string;
+  onSelectSegment?: (target: TimelineKeyframeTarget) => void;
+  onClickKeyframe?: (target: TimelineKeyframeTarget) => void;
+  onShiftClickKeyframe?: (target: TimelineKeyframeTarget) => void;
+  onContextMenuKeyframe?: (e: React.MouseEvent, target: TimelineKeyframeTarget) => void;
+  onMoveKeyframe?: (target: TimelineKeyframeTarget, toClipPercentage: number) => Promise<boolean>;
+}
+
 const DIAMOND_RATIO = 0.8;
 // Percentage tolerance for rendering keyframes near clip boundaries. Keyframes
 // slightly outside [0, 100] (from rounding or stale cache during the async
@@ -66,7 +97,21 @@ type DragState = {
   moved: boolean;
 };
 
-export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
+function keyframeTarget(
+  keyframe: TimelineDiamondKeyframe,
+  groupAware: boolean,
+): TimelineKeyframeTarget {
+  return groupAware
+    ? {
+        percentage: keyframe.percentage,
+        tweenPercentage: keyframe.tweenPercentage,
+        propertyGroup: keyframe.propertyGroup,
+        animationId: keyframe.animationId,
+      }
+    : { percentage: keyframe.percentage };
+}
+
+export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   keyframesData,
   clipWidthPx,
   clipHeightPx,
@@ -80,14 +125,35 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
   onShiftClickKeyframe,
   onContextMenuKeyframe,
   onMoveKeyframe,
+  onSelectSegment,
   suppressClickRef,
-}: TimelineClipDiamondsProps) {
+  groupAware = false,
+  globalEase = "none",
+}: TimelineDiamondLaneProps) {
   // Hooks must run before the early return below.
   const dragRef = useRef<DragState | null>(null);
+  // Pending retime destination (clip + tween %) per keyframe key, so a rapid
+  // second drag composes from where the first move left the keyframe (whose
+  // cache entry has not rebuilt yet) instead of the stale rendered value.
+  const pendingRetimeRef = useRef(new Map<string, { clipPct: number; tweenPct: number }>());
+  useEffect(() => {
+    // Clear a pending entry once the authoritative cache reflects a keyframe at
+    // ~its destination. Match by tolerance, not equality: cache writers round
+    // clip %s, so an exact check would leak an entry after every successful retime.
+    for (const [key, pending] of pendingRetimeRef.current) {
+      if (keyframesData.keyframes.some((k) => Math.abs(k.percentage - pending.clipPct) < 0.2)) {
+        pendingRetimeRef.current.delete(key);
+      }
+    }
+  }, [keyframesData.keyframes]);
   // Visual-only preview of the dragged diamond's clip-% — no runtime/GSAP hold
   // (that optimistic hold was the #1763 flake). The atomic move-keyframe commit
   // on drop re-keys the diamond from source.
   const [preview, setPreview] = useState<{ kfKey: string; clipPct: number } | null>(null);
+  // Index of the segment whose mid-point ease button is revealed on hover, like
+  // Figma. Null = no segment hovered → no button shown (resting state is just
+  // the connector line + diamonds).
+  const [hoveredSegment, setHoveredSegment] = useState<number | null>(null);
   // The button element can re-render (reposition/unmount) synchronously from
   // the state updates onClickKeyframe/onMoveKeyframe trigger, before the
   // browser gets to auto-synthesize the "click" event that normally follows
@@ -108,7 +174,12 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
 
   // When the beat strip occupies the top band, shrink the diamonds and center
   // them in the remaining bottom region so they don't collide with it.
-  const diamondSize = Math.round(clipHeightPx * (beatsActive ? 0.45 : DIAMOND_RATIO));
+  // One consistent keyframe-diamond size everywhere (clip bars + property lanes),
+  // matching the property-lane size (LANE_H · ratio). Beat-strip tracks still
+  // shrink to fit under the strip.
+  const diamondSize = beatsActive
+    ? Math.round(clipHeightPx * 0.45)
+    : Math.round(LANE_H * DIAMOND_RATIO);
   const half = diamondSize / 2;
   const centerY = beatsActive ? BEAT_BAND_H + (clipHeightPx - BEAT_BAND_H) / 2 : clipHeightPx / 2;
   const sorted = keyframesData.keyframes
@@ -141,32 +212,90 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
         const x1 = Math.max(0, Math.min(clipWidthPx, (prev.percentage / 100) * clipWidthPx));
         const x2 = Math.max(0, Math.min(clipWidthPx, (kf.percentage / 100) * clipWidthPx));
         if (x2 - x1 < 1) return null;
+        // Group-aware target for the ease button: the segment ease is
+        // per-keyframe (each keyframe carries its own animationId/tweenPercentage).
+        // On a merged inline row the button is hidden where the segment is
+        // ambiguous (two source animations collide at this % with different
+        // eases; see easeAmbiguous) or the keyframe has no source animation id
+        // (runtime-scanned) so there is no tween to target.
+        const target = keyframeTarget(kf, true);
+        const ease = kf.ease ?? globalEase;
         return (
-          <div
-            key={`line-${i}-${prev.percentage}-${kf.percentage}`}
-            className="absolute"
-            style={{
-              left: x1,
-              top: centerY,
-              width: x2 - x1,
-              height: 2,
-              transform: "translateY(-1px)",
-              background: baseColor,
-              opacity: baseOpacity,
-              borderRadius: 1,
-            }}
-          />
+          <Fragment key={`line-${i}-${prev.percentage}-${kf.percentage}`}>
+            <div
+              className="absolute"
+              data-keyframe-connector={groupAware ? "" : undefined}
+              style={{
+                left: x1,
+                top: centerY,
+                width: x2 - x1,
+                height: 2,
+                transform: "translateY(-1px)",
+                background: baseColor,
+                opacity: baseOpacity,
+                borderRadius: 1,
+              }}
+            />
+            {onSelectSegment && !kf.easeAmbiguous && kf.animationId !== undefined && (
+              <div
+                className="absolute"
+                data-keyframe-ease-segment=""
+                style={{
+                  left: x1,
+                  top: centerY,
+                  width: x2 - x1,
+                  height: 18,
+                  transform: "translateY(-50%)",
+                  pointerEvents: "auto",
+                }}
+                onMouseEnter={() => setHoveredSegment(i)}
+                onMouseLeave={() => setHoveredSegment((h) => (h === i ? null : h))}
+              >
+                {hoveredSegment === i && (
+                  <button
+                    type="button"
+                    data-keyframe-ease-button=""
+                    aria-label={`Edit ${ease} easing`}
+                    title={`Edit ${ease} easing`}
+                    className="absolute flex items-center justify-center rounded"
+                    style={{
+                      left: "50%",
+                      top: "50%",
+                      width: 16,
+                      height: 16,
+                      transform: "translate(-50%, -50%)",
+                      zIndex: 3,
+                      pointerEvents: "auto",
+                      padding: 0,
+                      border: "1px solid rgba(255, 255, 255, 0.14)",
+                      background: "#171717",
+                      cursor: "pointer",
+                    }}
+                    onPointerDown={(e) => e.stopPropagation()}
+                    onClick={(e) => {
+                      e.stopPropagation();
+                      onSelectSegment(target);
+                    }}
+                  >
+                    <MiniCurveSvg ease={ease} active size={12} />
+                  </button>
+                )}
+              </div>
+            )}
+          </Fragment>
         );
       })}
 
       {sorted.map((kf, i) => {
-        const kfKey = `${elementId}:${kf.percentage}`;
+        const target = keyframeTarget(kf, groupAware);
+        const kfKey = timelineKeyframeSelectionKey(elementId, target);
         // While dragging this diamond, render it at the live preview clip-%.
         const renderPct = preview?.kfKey === kfKey ? preview.clipPct : kf.percentage;
-        // Center the diamond ON its keyframe %: left = (% · width) − half so the
-        // diamond's midpoint sits exactly at the percentage. At 0% the midpoint
-        // is the clip's left edge (the left half overflows, which the
-        // overflow-visible clip shows) — NOT shifted fully inside.
+        // Center the diamond ON its keyframe %: left = (% · width) − half, so the
+        // diamond's midpoint sits exactly on the playhead/ruler x for that time.
+        // The 0% diamond's left half lands in the reserved left gutter (the
+        // content origin is inset past the label column, Figma-style) so it stays
+        // fully visible instead of being clipped by the sticky label column.
         const leftPx = (renderPct / 100) * clipWidthPx - half;
         const isKfSelected = selectedKeyframes.has(kfKey);
         const atPlayhead = isSelected && Math.abs(kf.percentage - currentPercentage) < 0.5;
@@ -181,7 +310,7 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
             dragRef.current = {
               kfKey,
               startX: e.clientX,
-              fromClipPct: kf.percentage,
+              fromClipPct: pendingRetimeRef.current.get(kfKey)?.clipPct ?? kf.percentage,
               moved: false,
             };
           }
@@ -212,8 +341,8 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
           if (!d || d.kfKey !== kfKey) {
             if (e.button !== 0) return;
             suppressNextClick();
-            if (e.shiftKey) onShiftClickKeyframe?.(elementId, kf.percentage);
-            else onClickKeyframe?.(kf.percentage);
+            if (e.shiftKey) onShiftClickKeyframe?.(target);
+            else onClickKeyframe?.(target);
             return;
           }
           e.stopPropagation();
@@ -235,14 +364,54 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
             // back onto ~the same position — no real retime, so treat it as the
             // click it was. Otherwise a normal click with a few px of mouse/
             // trackpad drift silently does nothing: no selection, no move.
-            if (e.shiftKey) onShiftClickKeyframe?.(elementId, kf.percentage);
-            else onClickKeyframe?.(kf.percentage);
+            if (e.shiftKey) onShiftClickKeyframe?.(target);
+            else onClickKeyframe?.(target);
           } else if (res.kind === "move" && res.toClipPct != null) {
-            onMoveKeyframe?.(elementId, d.fromClipPct, res.toClipPct);
+            const animKfs =
+              target.animationId === undefined
+                ? keyframesData.keyframes
+                : keyframesData.keyframes.filter((k) => k.animationId === target.animationId);
+            // Clamp to the mapped tween range: clipToTweenPercentage extrapolates
+            // linearly, so a boundary drag past the range would otherwise reselect
+            // an out-of-range tween % (e.g. 150%) even though the mutation clamps
+            // the moved endpoint back to the boundary.
+            const tweenPcts = animKfs
+              .map((k) => k.tweenPercentage)
+              .filter((v): v is number => typeof v === "number");
+            const clampTween = (v: number) =>
+              tweenPcts.length
+                ? Math.max(Math.min(...tweenPcts), Math.min(Math.max(...tweenPcts), v))
+                : v;
+            const newTweenPct = clampTween(clipToTweenPercentage(animKfs, res.toClipPct));
+            // For a rapid second retime the diamond still renders the stale cache
+            // position, so identify the FROM keyframe by the pending (already-moved)
+            // position; the mutation locates the source keyframe by this identity.
+            const pendingBefore = pendingRetimeRef.current.get(kfKey);
+            const fromTarget = pendingBefore
+              ? {
+                  ...target,
+                  percentage: pendingBefore.clipPct,
+                  tweenPercentage: pendingBefore.tweenPct,
+                }
+              : target;
+            const pending = { clipPct: res.toClipPct, tweenPct: newTweenPct };
+            pendingRetimeRef.current.set(kfKey, pending);
+            const clearPending = () => {
+              if (pendingRetimeRef.current.get(kfKey) === pending) {
+                pendingRetimeRef.current.delete(kfKey);
+              }
+            };
+            void onMoveKeyframe?.(fromTarget, res.toClipPct).then((committed) => {
+              if (!committed) clearPending();
+            }, clearPending);
             // A retime still targeted this exact diamond — park/select it at its
             // new position, same as a plain click, or a drag that actually moved
             // something looks identical to one that silently did nothing.
-            onClickKeyframe?.(res.toClipPct);
+            onClickKeyframe?.({
+              ...target,
+              percentage: res.toClipPct,
+              tweenPercentage: newTweenPct,
+            });
           }
         };
 
@@ -251,6 +420,10 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
             key={`${i}-${kf.percentage}`}
             type="button"
             className="absolute"
+            data-keyframe-group={groupAware ? kf.propertyGroup : undefined}
+            data-keyframe-percentage={
+              groupAware ? (kf.tweenPercentage ?? kf.percentage) : undefined
+            }
             style={{
               left: leftPx,
               top: centerY,
@@ -268,10 +441,19 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
             onPointerDown={onPointerDown}
             onPointerMove={onPointerMove}
             onPointerUp={onPointerUp}
+            onPointerCancel={(e) => {
+              // Browser/OS cancellation (or lost capture) ends the drag without a
+              // pointerup, so clear the armed drag and preview or a ghost diamond
+              // stays stuck at the last previewed position.
+              if (dragRef.current?.kfKey !== kfKey) return;
+              dragRef.current = null;
+              setPreview(null);
+              e.currentTarget.releasePointerCapture?.(e.pointerId);
+            }}
             onContextMenu={(e) => {
               e.preventDefault();
               e.stopPropagation();
-              onContextMenuKeyframe?.(e, elementId, kf.percentage);
+              onContextMenuKeyframe?.(e, target);
             }}
             title={`${kf.percentage}%`}
           >
@@ -297,3 +479,33 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds({
     </div>
   );
 });
+
+export const TimelineClipDiamonds = memo(function TimelineClipDiamonds(
+  props: TimelineClipDiamondsProps,
+) {
+  return (
+    <TimelineDiamondLane
+      {...props}
+      globalEase={props.keyframesData.ease}
+      onClickKeyframe={(target) => props.onClickKeyframe?.(target.percentage)}
+      onShiftClickKeyframe={(target) =>
+        props.onShiftClickKeyframe?.(props.elementId, target.percentage)
+      }
+      onContextMenuKeyframe={(e, target) =>
+        props.onContextMenuKeyframe?.(e, props.elementId, target.percentage)
+      }
+      onMoveKeyframe={
+        props.onMoveKeyframe
+          ? (target, toClipPercentage) =>
+              props.onMoveKeyframe?.(props.elementId, target.percentage, toClipPercentage) ??
+              Promise.resolve(false)
+          : undefined
+      }
+      onSelectSegment={
+        props.onSelectSegment
+          ? (target) => props.onSelectSegment?.(props.elementId, target)
+          : undefined
+      }
+    />
+  );
+});
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index 75069c1a0b..13707c05c7 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -78,7 +78,7 @@ export interface TimelineLaneBaseProps {
     elementId: string,
     fromClipPercentage: number,
     toClipPercentage: number,
-  ) => void;
+  ) => Promise<boolean>;
   onContextMenuClip?: (e: React.MouseEvent, element: TimelineElement) => void;
   /**
    * Right-click on EMPTY lane space (not on a clip — those preventDefault
diff --git a/packages/studio/src/player/components/timelineCallbacks.ts b/packages/studio/src/player/components/timelineCallbacks.ts
index 2ba62c5bd6..71db7d8637 100644
--- a/packages/studio/src/player/components/timelineCallbacks.ts
+++ b/packages/studio/src/player/components/timelineCallbacks.ts
@@ -70,6 +70,6 @@ export interface TimelineEditCallbacks {
     elementId: string,
     fromClipPercentage: number,
     toClipPercentage: number,
-  ) => void;
+  ) => Promise<boolean>;
   onToggleKeyframeAtPlayhead?: (element: TimelineElement) => void;
 }
diff --git a/packages/studio/src/player/components/timelineKeyframeIdentity.ts b/packages/studio/src/player/components/timelineKeyframeIdentity.ts
new file mode 100644
index 0000000000..8cf58d7118
--- /dev/null
+++ b/packages/studio/src/player/components/timelineKeyframeIdentity.ts
@@ -0,0 +1,17 @@
+export interface TimelineKeyframeTarget {
+  percentage: number;
+  tweenPercentage?: number;
+  propertyGroup?: string;
+  animationId?: string;
+}
+
+export function timelineKeyframeSelectionKey(
+  elementId: string,
+  target: TimelineKeyframeTarget,
+): string {
+  if (!target.propertyGroup) return `${elementId}:${target.percentage}`;
+  const groupKey = target.animationId
+    ? `${target.propertyGroup}:${target.animationId}`
+    : target.propertyGroup;
+  return `${elementId}:${groupKey}:${target.percentage}`;
+}
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
new file mode 100644
index 0000000000..0c10202dbf
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
@@ -0,0 +1,108 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { mountReactHarness } from "../../hooks/domSelectionTestHarness";
+import type { TimelineElement } from "../store/playerStore";
+import { usePlayerStore } from "../store/playerStore";
+import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
+import { useTimelineKeyframeHandlers } from "./useTimelineKeyframeHandlers";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+const trackStudioSegmentEaseEdit = vi.hoisted(() => vi.fn());
+vi.mock("../../telemetry/events", () => ({ trackStudioSegmentEaseEdit }));
+
+const ELEMENT: TimelineElement = {
+  id: "clip-1",
+  label: "Hero card",
+  tag: "div",
+  start: 1,
+  duration: 2,
+  track: 0,
+};
+
+const TARGET: TimelineKeyframeTarget = {
+  percentage: 50,
+  tweenPercentage: 50,
+  propertyGroup: "position",
+  animationId: "position-tween",
+};
+
+const FLAT_TWEEN_TARGET: TimelineKeyframeTarget = {
+  percentage: 100,
+  tweenPercentage: 100,
+  propertyGroup: "position",
+  animationId: "position-tween",
+};
+
+afterEach(() => {
+  document.body.innerHTML = "";
+  trackStudioSegmentEaseEdit.mockClear();
+  usePlayerStore.setState({ focusedEaseSegment: null });
+});
+
+describe("useTimelineKeyframeHandlers", () => {
+  it("tracks opening the segment ease editor when a timeline segment is selected", () => {
+    let onSelectSegment: ((elementId: string, target: TimelineKeyframeTarget) => void) | undefined;
+
+    function Harness() {
+      ({ onSelectSegment } = useTimelineKeyframeHandlers({
+        expandedElements: [ELEMENT],
+        keyframeCache: new Map(),
+        setSelectedElementId: vi.fn(),
+        setKfContextMenu: vi.fn(),
+        toggleSelectedKeyframe: vi.fn(),
+      }));
+      return null;
+    }
+
+    const root = mountReactHarness(<Harness />);
+    act(() => onSelectSegment?.(ELEMENT.id, TARGET));
+
+    expect(trackStudioSegmentEaseEdit).toHaveBeenCalledOnce();
+    expect(trackStudioSegmentEaseEdit).toHaveBeenCalledWith({ action: "open" });
+    act(() => root.unmount());
+  });
+
+  it("focuses a flat tween segment without seeking, while keyframe clicks still seek", () => {
+    const onSeek = vi.fn();
+    const onSelectElement = vi.fn();
+    const setSelectedElementId = vi.fn();
+    let onClickKeyframe:
+      | ((el: TimelineElement, target: TimelineKeyframeTarget) => void)
+      | undefined;
+    let onSelectSegment: ((elementId: string, target: TimelineKeyframeTarget) => void) | undefined;
+
+    function Harness() {
+      ({ onClickKeyframe, onSelectSegment } = useTimelineKeyframeHandlers({
+        expandedElements: [ELEMENT],
+        keyframeCache: new Map(),
+        onSelectElement,
+        onSeek,
+        setSelectedElementId,
+        setKfContextMenu: vi.fn(),
+        toggleSelectedKeyframe: vi.fn(),
+      }));
+      return null;
+    }
+
+    const root = mountReactHarness(<Harness />);
+
+    // Selecting a segment must NOT move the playhead.
+    act(() => onSelectSegment?.(ELEMENT.id, FLAT_TWEEN_TARGET));
+    expect(onSeek).not.toHaveBeenCalled();
+    expect(usePlayerStore.getState().focusedEaseSegment).toEqual({
+      animationId: "position-tween",
+      tweenPercentage: 100,
+      elementId: ELEMENT.id,
+    });
+    expect(setSelectedElementId).toHaveBeenCalledWith(ELEMENT.id);
+    expect(onSelectElement).toHaveBeenCalledWith(ELEMENT);
+
+    // Clicking the keyframe itself still seeks to it (start 1 + 50% of 2 = 2).
+    act(() => onClickKeyframe?.(ELEMENT, TARGET));
+    expect(onSeek).toHaveBeenCalledExactlyOnceWith(2);
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
index d9a91abd63..e697d49277 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
@@ -1,7 +1,12 @@
 import { useCallback, type MouseEvent as ReactMouseEvent } from "react";
+import { trackStudioSegmentEaseEdit } from "../../telemetry/events";
 import type { TimelineElement, KeyframeCacheEntry } from "../store/playerStore";
 import { usePlayerStore } from "../store/playerStore";
 import type { KeyframeDiamondContextMenuState } from "./KeyframeDiamondContextMenu";
+import {
+  timelineKeyframeSelectionKey,
+  type TimelineKeyframeTarget,
+} from "./timelineKeyframeIdentity";
 
 interface UseTimelineKeyframeHandlersInput {
   expandedElements: TimelineElement[];
@@ -23,42 +28,71 @@ export function useTimelineKeyframeHandlers({
   toggleSelectedKeyframe,
 }: UseTimelineKeyframeHandlersInput) {
   const onClickKeyframe = useCallback(
-    (el: TimelineElement, pct: number) => {
+    (el: TimelineElement, target: TimelineKeyframeTarget, options?: { seek?: boolean }) => {
       usePlayerStore.getState().clearSelectedKeyframes();
       const elKey = el.key ?? el.id;
       setSelectedElementId(elKey);
       onSelectElement?.(el);
-      toggleSelectedKeyframe(`${elKey}:${pct}`);
-      onSeek?.(el.start + (pct / 100) * el.duration);
+      toggleSelectedKeyframe(timelineKeyframeSelectionKey(elKey, target));
+      // Clicking a diamond seeks the playhead to it; selecting a segment to edit
+      // its ease (options.seek === false) must NOT move the playhead.
+      if (options?.seek !== false) {
+        onSeek?.(el.start + (target.percentage / 100) * el.duration);
+      }
       const kfData = keyframeCache.get(elKey);
-      const kf = kfData?.keyframes.find((item) => Math.abs(item.percentage - pct) < 0.5);
-      usePlayerStore.getState().setActiveKeyframePct(kf?.tweenPercentage ?? null);
+      const kf = kfData?.keyframes.find(
+        (item) => Math.abs(item.percentage - target.percentage) < 0.5,
+      );
+      usePlayerStore
+        .getState()
+        .setActiveKeyframePct(target.tweenPercentage ?? kf?.tweenPercentage ?? null);
     },
     [keyframeCache, onSeek, onSelectElement, setSelectedElementId, toggleSelectedKeyframe],
   );
 
   const onShiftClickKeyframe = useCallback(
-    (elId: string, pct: number) => {
-      toggleSelectedKeyframe(`${elId}:${pct}`);
+    (elId: string, target: TimelineKeyframeTarget) => {
+      toggleSelectedKeyframe(timelineKeyframeSelectionKey(elId, target));
     },
     [toggleSelectedKeyframe],
   );
 
+  const onSelectSegment = useCallback(
+    (elId: string, target: TimelineKeyframeTarget) => {
+      const el = expandedElements.find((item) => (item.key ?? item.id) === elId);
+      if (!el) return;
+      onClickKeyframe(el, target, { seek: false });
+      if (target.animationId !== undefined && target.tweenPercentage !== undefined) {
+        usePlayerStore.getState().setFocusedEaseSegment({
+          animationId: target.animationId,
+          tweenPercentage: target.tweenPercentage,
+          elementId: elId,
+        });
+        trackStudioSegmentEaseEdit({ action: "open" });
+      }
+    },
+    [expandedElements, onClickKeyframe],
+  );
+
   const onContextMenuKeyframe = useCallback(
-    (e: ReactMouseEvent, elId: string, pct: number) => {
+    (e: ReactMouseEvent, elId: string, target: TimelineKeyframeTarget) => {
       const el = expandedElements.find((item) => (item.key ?? item.id) === elId);
       if (el) {
         setSelectedElementId(elId);
         onSelectElement?.(el);
       }
       const kfData = keyframeCache.get(elId);
-      const kf = kfData?.keyframes.find((item) => Math.abs(item.percentage - pct) < 0.2);
+      const kf = kfData?.keyframes.find(
+        (item) => Math.abs(item.percentage - target.percentage) < 0.2,
+      );
       setKfContextMenu({
         x: e.clientX + 4,
         y: e.clientY + 2,
         elementId: elId,
-        percentage: pct,
-        tweenPercentage: kf?.tweenPercentage,
+        percentage: target.percentage,
+        tweenPercentage: target.tweenPercentage ?? kf?.tweenPercentage,
+        propertyGroup: target.propertyGroup,
+        animationId: target.animationId,
         currentEase: kf?.ease ?? kfData?.ease,
       });
     },
@@ -67,6 +101,7 @@ export function useTimelineKeyframeHandlers({
 
   return {
     onClickKeyframe,
+    onSelectSegment,
     onShiftClickKeyframe,
     onContextMenuKeyframe,
   };

From 706f537f33bcf182f6b294806384d377c1b1d747 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 22:53:14 +0200
Subject: [PATCH 073/125] fix(studio): let Escape cancel a keyframe retime and
 throttle its preview

Escape now ends an in-flight diamond drag the way it already ends clip
and element drags: the armed gesture is marked cancelled, the preview is
dropped, and the pointerup that follows is swallowed instead of falling
through to the click branch.

The preview also flushes once per animation frame instead of once per
pointermove, so a high-rate trackpad no longer re-renders every diamond
in the row several times a frame. Single-diamond retime stays the
documented scope; multi-select drag needs a batched mutation the script
ops do not express yet.
---
 .../components/TimelineClipDiamonds.test.tsx  | 47 +++++++++++++
 .../components/TimelineClipDiamonds.tsx       | 66 +++++++++++++++++--
 2 files changed, 106 insertions(+), 7 deletions(-)

diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
index d22ac46a11..7a6022a846 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
@@ -379,6 +379,53 @@ describe("TimelineClipDiamonds", () => {
     act(() => root.unmount());
   });
 
+  it("cancels an in-flight retime on Escape without committing or selecting", () => {
+    const onClickKeyframe = vi.fn();
+    const onMoveKeyframe = vi.fn().mockResolvedValue(true);
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() => {
+      root.render(
+        <TimelineDiamondLane
+          keyframesData={{
+            format: "percentage",
+            keyframes: [
+              { percentage: 20, tweenPercentage: 0, properties: { x: 0 } },
+              { percentage: 40, tweenPercentage: 50, properties: { x: 100 } },
+              { percentage: 60, tweenPercentage: 100, properties: { x: 200 } },
+            ],
+          }}
+          clipWidthPx={200}
+          clipHeightPx={48}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={0}
+          elementId="clip-1"
+          selectedKeyframes={new Set()}
+          onClickKeyframe={onClickKeyframe}
+          onMoveKeyframe={onMoveKeyframe}
+        />,
+      );
+    });
+    const diamond = host.querySelector<HTMLButtonElement>('button[title="40%"]');
+    expect(diamond).not.toBeNull();
+
+    act(() => {
+      diamond!.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 80 }),
+      );
+      document.dispatchEvent(new KeyboardEvent("keydown", { key: "Escape", bubbles: true }));
+      diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 100 }));
+    });
+
+    // Escape ends the gesture: no retime is written, and the release is not
+    // reinterpreted as a click that would park the playhead on the keyframe.
+    expect(onMoveKeyframe).not.toHaveBeenCalled();
+    expect(onClickKeyframe).not.toHaveBeenCalled();
+    act(() => root.unmount());
+  });
+
   // Regression: onClickKeyframe's state updates can re-render the diamond
   // button out from under the gesture before the browser auto-synthesizes the
   // "click" event that follows a button's pointerdown+pointerup. That orphaned
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 29fb6b9c77..37510955b0 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -95,6 +95,13 @@ type DragState = {
   startX: number;
   fromClipPct: number;
   moved: boolean;
+  /** Latest pointer x, flushed to the preview once per frame. */
+  lastX: number;
+  /** Index in the sorted row, needed by the neighbour clamp off the render path. */
+  index: number;
+  /** Escape was pressed: the drag is dead, and the pointerup that follows is
+   *  swallowed rather than falling through to the click branch. */
+  cancelled?: boolean;
 };
 
 function keyframeTarget(
@@ -150,6 +157,31 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   // (that optimistic hold was the #1763 flake). The atomic move-keyframe commit
   // on drop re-keys the diamond from source.
   const [preview, setPreview] = useState<{ kfKey: string; clipPct: number } | null>(null);
+  // One preview render per frame: a 120Hz trackpad fires pointermove far faster
+  // than the lane can repaint, and every diamond in the row re-evaluates its
+  // memo on each of those renders.
+  const previewFrameRef = useRef<number | null>(null);
+  const cancelPreviewFrame = () => {
+    if (previewFrameRef.current === null) return;
+    cancelAnimationFrame(previewFrameRef.current);
+    previewFrameRef.current = null;
+  };
+  // Escape backs out of an in-flight retime, the way clip and element drags
+  // already do. Nothing was written yet (the commit happens on pointerup), so
+  // dropping the preview is the whole undo.
+  useEffect(() => {
+    const onKeyDown = (event: KeyboardEvent) => {
+      if (event.key !== "Escape" || !dragRef.current || dragRef.current.cancelled) return;
+      dragRef.current.cancelled = true;
+      cancelPreviewFrame();
+      setPreview(null);
+    };
+    document.addEventListener("keydown", onKeyDown);
+    return () => {
+      document.removeEventListener("keydown", onKeyDown);
+      cancelPreviewFrame();
+    };
+  }, []);
   // Index of the segment whose mid-point ease button is revealed on hover, like
   // Figma. Null = no segment hovered → no button shown (resting state is just
   // the connector line + diamonds).
@@ -310,6 +342,8 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
             dragRef.current = {
               kfKey,
               startX: e.clientX,
+              lastX: e.clientX,
+              index: i,
               fromClipPct: pendingRetimeRef.current.get(kfKey)?.clipPct ?? kf.percentage,
               moved: false,
             };
@@ -317,26 +351,38 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         };
         const onPointerMove = (e: React.PointerEvent<HTMLButtonElement>) => {
           const d = dragRef.current;
-          if (!d || d.kfKey !== kfKey) return;
+          if (!d || d.kfKey !== kfKey || d.cancelled) return;
+          d.lastX = e.clientX;
           if (!d.moved && Math.abs(e.clientX - d.startX) >= KEYFRAME_DRAG_THRESHOLD_PX) {
             d.moved = true;
           }
-          if (d.moved) {
+          if (!d.moved || previewFrameRef.current !== null) return;
+          previewFrameRef.current = requestAnimationFrame(() => {
+            previewFrameRef.current = null;
+            const live = dragRef.current;
+            if (!live || live.kfKey !== kfKey || live.cancelled) return;
             setPreview({
               kfKey,
               clipPct: previewClipPct({
-                pointerDownX: d.startX,
-                pointerMoveX: e.clientX,
+                pointerDownX: live.startX,
+                pointerMoveX: live.lastX,
                 clipWidthPx,
-                draggedClipPct: d.fromClipPct,
-                draggedIndex: i,
+                draggedClipPct: live.fromClipPct,
+                draggedIndex: live.index,
                 sortedClipPcts,
               }),
             });
-          }
+          });
         };
         const onPointerUp = (e: React.PointerEvent<HTMLButtonElement>) => {
           const d = dragRef.current;
+          if (d?.kfKey === kfKey && d.cancelled) {
+            // Escape already ended this drag; the release is not a click.
+            dragRef.current = null;
+            e.currentTarget.releasePointerCapture?.(e.pointerId);
+            suppressNextClick();
+            return;
+          }
           // No drag armed (canDrag false / non-primary press) → treat as a click.
           if (!d || d.kfKey !== kfKey) {
             if (e.button !== 0) return;
@@ -347,9 +393,14 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
           }
           e.stopPropagation();
           dragRef.current = null;
+          cancelPreviewFrame();
           setPreview(null);
           e.currentTarget.releasePointerCapture?.(e.pointerId);
           suppressNextClick();
+          // Single-diamond retime by design: a multi-select drag would have to
+          // move every selected keyframe as one mutation, which the script ops
+          // do not express yet. Selecting several and dragging one moves only
+          // the dragged one.
           const res = resolveKeyframeDrag({
             pointerDownX: d.startX,
             pointerUpX: e.clientX,
@@ -447,6 +498,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               // stays stuck at the last previewed position.
               if (dragRef.current?.kfKey !== kfKey) return;
               dragRef.current = null;
+              cancelPreviewFrame();
               setPreview(null);
               e.currentTarget.releasePointerCapture?.(e.pointerId);
             }}

From 6e0118cb3f5adf43bec8ee08bac89a164b480328 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 00:57:53 +0200
Subject: [PATCH 074/125] refactor(studio): guard the diamond connector's
 previous keyframe

CONTRIBUTING.md asks for a guard clause rather than a non-null assertion outside
an already-checked path. The index check and the lookup are now the same guard.
---
 .../studio/src/player/components/TimelineClipDiamonds.tsx     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 37510955b0..a592a4db50 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -239,8 +239,8 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
       }}
     >
       {sorted.map((kf, i) => {
-        if (i === 0) return null;
-        const prev = sorted[i - 1]!;
+        const prev = sorted[i - 1];
+        if (!prev) return null;
         const x1 = Math.max(0, Math.min(clipWidthPx, (prev.percentage / 100) * clipWidthPx));
         const x2 = Math.max(0, Math.min(clipWidthPx, (kf.percentage / 100) * clipWidthPx));
         if (x2 - x1 < 1) return null;

From fed5e5b71df505b2598fe31522eba1710ea62c7c Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 16:51:46 +0200
Subject: [PATCH 075/125] feat(studio): add timeline property lanes

---
 .../components/TimelineClipDiamonds.tsx       |   2 +-
 .../components/TimelinePropertyLanes.test.tsx | 433 ++++++++++++++++++
 .../components/TimelinePropertyLanes.tsx      | 163 +++++++
 .../src/player/components/timelineLayout.ts   |   4 +
 .../useAutoExpandKeyframedClips.test.tsx      |  75 +++
 .../components/useAutoExpandKeyframedClips.ts |  36 ++
 6 files changed, 712 insertions(+), 1 deletion(-)
 create mode 100644 packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
 create mode 100644 packages/studio/src/player/components/TimelinePropertyLanes.tsx
 create mode 100644 packages/studio/src/player/components/useAutoExpandKeyframedClips.test.tsx
 create mode 100644 packages/studio/src/player/components/useAutoExpandKeyframedClips.ts

diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index a592a4db50..1a066d5d03 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -12,7 +12,7 @@ import {
   timelineKeyframeSelectionKey,
   type TimelineKeyframeTarget,
 } from "./timelineKeyframeIdentity";
-interface TimelineDiamondKeyframe {
+export interface TimelineDiamondKeyframe {
   percentage: number;
   /** Tween-relative percentage (the retime mutation keys on this, not clip %). */
   tweenPercentage?: number;
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
new file mode 100644
index 0000000000..475dbd1e96
--- /dev/null
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
@@ -0,0 +1,433 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import type { GsapAnimation, PropertyGroupName } from "@hyperframes/core/gsap-parser";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { TimelineClipDiamonds } from "./TimelineClipDiamonds";
+import {
+  getTimelinePropertyLanes,
+  TimelinePropertyLanes,
+  type TimelinePropertyLanesProps,
+} from "./TimelinePropertyLanes";
+import { timelineKeyframeSelectionKey } from "./timelineKeyframeIdentity";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+afterEach(() => {
+  document.body.innerHTML = "";
+});
+
+function animation(
+  id: string,
+  propertyGroup: PropertyGroupName,
+  keyframes: Array<{
+    percentage: number;
+    properties: Record<string, number | string>;
+    ease?: string;
+  }>,
+): GsapAnimation {
+  return {
+    id,
+    targetSelector: "#clip-1",
+    method: "to",
+    position: 0,
+    duration: 1,
+    properties: {},
+    propertyGroup,
+    keyframes: { format: "percentage", keyframes },
+  };
+}
+
+function flatAnimation(
+  id: string,
+  propertyGroup: PropertyGroupName,
+  properties: Record<string, number | string>,
+): GsapAnimation {
+  return {
+    id,
+    targetSelector: "#clip-1",
+    method: "to",
+    position: 0,
+    duration: 1,
+    properties,
+    propertyGroup,
+  };
+}
+
+function renderPropertyLanes(overrides: Partial<TimelinePropertyLanesProps> = {}): {
+  host: HTMLDivElement;
+  root: Root;
+} {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  act(() => {
+    root.render(
+      <TimelinePropertyLanes
+        animations={[]}
+        clipStart={0}
+        clipDuration={1}
+        clipLeftPx={0}
+        clipWidthPx={200}
+        accentColor="#4ba3d2"
+        isSelected
+        currentPercentage={-10}
+        elementId="clip-1"
+        selectedKeyframes={new Set()}
+        {...overrides}
+      />,
+    );
+  });
+  return { host, root };
+}
+
+function laneDiamonds(host: HTMLElement, group: string): HTMLButtonElement[] {
+  return Array.from(
+    host.querySelectorAll<HTMLButtonElement>(
+      `[data-property-group="${group}"] button[data-keyframe-percentage]`,
+    ),
+  );
+}
+
+function expectLanePercentages(host: HTMLElement, group: string, percentages: string[]) {
+  expect(laneDiamonds(host, group).map((diamond) => diamond.dataset.keyframePercentage)).toEqual(
+    percentages,
+  );
+}
+
+function laneEaseButtons(host: HTMLElement, group: string): HTMLButtonElement[] {
+  return Array.from(
+    host.querySelectorAll<HTMLButtonElement>(
+      `[data-property-group="${group}"] button[data-keyframe-ease-button]`,
+    ),
+  );
+}
+
+function laneEaseSegments(host: HTMLElement, group: string): HTMLElement[] {
+  return Array.from(
+    host.querySelectorAll<HTMLElement>(
+      `[data-property-group="${group}"] [data-keyframe-ease-segment]`,
+    ),
+  );
+}
+
+// The mid-segment ease button is revealed on hover (Figma parity), so tests must
+// hover the segment strip before its button exists. React derives onMouseEnter
+// from a bubbling mouseover, so dispatching that is what arms the hover.
+function revealEaseButton(segment: HTMLElement): HTMLButtonElement | null {
+  act(() => {
+    segment.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
+  });
+  return segment.querySelector<HTMLButtonElement>("button[data-keyframe-ease-button]");
+}
+
+const POSITION_SEGMENT_ANIMATION = animation("position-tween", "position", [
+  { percentage: 0, properties: { x: 0 } },
+  { percentage: 50, properties: { x: 50 } },
+]);
+
+describe("TimelinePropertyLanes", () => {
+  it("returns a position lane with synthesized endpoints for a flat tween", () => {
+    const lanes = getTimelinePropertyLanes(
+      [flatAnimation("position-tween", "position", { x: 420 })],
+      0,
+      1,
+    );
+
+    expect(lanes).toHaveLength(1);
+    expect(lanes[0]?.group).toBe("position");
+    expect(lanes[0]?.keyframes).toEqual([
+      {
+        percentage: 0,
+        tweenPercentage: 0,
+        properties: { x: 0 },
+        propertyGroup: "position",
+        animationId: "position-tween",
+      },
+      {
+        percentage: 100,
+        tweenPercentage: 100,
+        properties: { x: 420 },
+        propertyGroup: "position",
+        animationId: "position-tween",
+      },
+    ]);
+  });
+
+  it("returns both flat and authored keyframe property groups", () => {
+    const lanes = getTimelinePropertyLanes(
+      [
+        flatAnimation("position-tween", "position", { x: 420 }),
+        animation("visual-tween", "visual", [
+          { percentage: 0, properties: { opacity: 0 } },
+          { percentage: 100, properties: { opacity: 1 } },
+        ]),
+      ],
+      0,
+      1,
+    );
+
+    expect(lanes.map((lane) => lane.group)).toEqual(["position", "visual"]);
+    expect(lanes.map((lane) => lane.keyframes.map((keyframe) => keyframe.percentage))).toEqual([
+      [0, 100],
+      [0, 100],
+    ]);
+  });
+
+  it("renders each source property group at its independent keyframe positions", () => {
+    const animations = [
+      animation("position-tween", "position", [
+        { percentage: 0, properties: { x: 0, y: 0 } },
+        { percentage: 50, properties: { x: 100, y: 20 } },
+        { percentage: 100, properties: { x: 200, y: 40 } },
+      ]),
+      animation("visual-tween", "visual", [{ percentage: 25, properties: { opacity: 0.5 } }]),
+    ];
+
+    const { host, root } = renderPropertyLanes({ animations });
+    const position = laneDiamonds(host, "position");
+    const visual = laneDiamonds(host, "visual");
+
+    expect(position).toHaveLength(3);
+    expect(visual).toHaveLength(1);
+    // Diamonds are centered on their true keyframe time (0% at -half); the
+    // reserved left gutter (content origin inset, tested at the Timeline level)
+    // keeps the overflowing left half visible rather than clamping it inward.
+    expect(position.map((diamond) => diamond.style.left)).toEqual(["-11px", "89px", "189px"]);
+    expect(visual[0]?.style.left).toBe("39px");
+    expect(
+      host.querySelectorAll('[data-property-group="position"] [data-keyframe-connector]'),
+    ).toHaveLength(2);
+    act(() => root.unmount());
+  });
+
+  it("keeps both groups' diamonds when their source keyframes share 0% and 100%", () => {
+    const animations = [
+      animation("position-tween", "position", [
+        { percentage: 0, properties: { x: 0 } },
+        { percentage: 100, properties: { x: 100 } },
+      ]),
+      animation("visual-tween", "visual", [
+        { percentage: 0, properties: { opacity: 0 } },
+        { percentage: 100, properties: { opacity: 1 } },
+      ]),
+    ];
+
+    const { host, root } = renderPropertyLanes({ animations });
+
+    expectLanePercentages(host, "position", ["0", "100"]);
+    expectLanePercentages(host, "visual", ["0", "100"]);
+    act(() => root.unmount());
+  });
+
+  it("renders an authored hold keyframe whose value equals its predecessor", () => {
+    const animations = [
+      animation("position-tween", "position", [
+        { percentage: 0, properties: { x: 10 } },
+        { percentage: 50, properties: { x: 10 } },
+        { percentage: 100, properties: { x: 20 } },
+      ]),
+    ];
+
+    const { host, root } = renderPropertyLanes({ animations });
+
+    expectLanePercentages(host, "position", ["0", "50", "100"]);
+    act(() => root.unmount());
+  });
+
+  it("keeps Position@50% selection distinct from Opacity@50%", () => {
+    const onClickKeyframe = vi.fn();
+    const animations = [
+      animation("position-tween", "position", [{ percentage: 50, properties: { x: 50 } }]),
+      animation("visual-tween", "visual", [{ percentage: 50, properties: { opacity: 0.5 } }]),
+    ];
+    const { host, root } = renderPropertyLanes({ animations, onClickKeyframe });
+    const position = laneDiamonds(host, "position")[0]!;
+
+    act(() => {
+      position.dispatchEvent(new MouseEvent("pointerup", { bubbles: true, button: 0 }));
+    });
+
+    const target = onClickKeyframe.mock.calls[0]?.[0];
+    expect(target).toEqual({
+      animationId: "position-tween",
+      percentage: 50,
+      propertyGroup: "position",
+      tweenPercentage: 50,
+    });
+
+    act(() => {
+      root.render(
+        <TimelinePropertyLanes
+          animations={animations}
+          clipStart={0}
+          clipDuration={1}
+          clipLeftPx={0}
+          clipWidthPx={200}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={-10}
+          elementId="clip-1"
+          selectedKeyframes={new Set([timelineKeyframeSelectionKey("clip-1", target)])}
+        />,
+      );
+    });
+
+    const positionFill = laneDiamonds(host, "position")[0]?.querySelector("path:last-child");
+    const visualFill = laneDiamonds(host, "visual")[0]?.querySelector("path:last-child");
+    expect(positionFill?.getAttribute("fill")).toBe("#4ba3d2");
+    expect(visualFill?.getAttribute("fill")).toBe("#a3a3a3");
+    act(() => root.unmount());
+  });
+
+  it("reveals one midpoint ease button per segment on hover, regardless of selection", () => {
+    const animations = [
+      animation("position-tween", "position", [
+        { percentage: 0, properties: { x: 0 } },
+        { percentage: 50, properties: { x: 50 } },
+        { percentage: 100, properties: { x: 100 } },
+      ]),
+    ];
+    const { host, root } = renderPropertyLanes({ animations, onSelectSegment: vi.fn() });
+
+    const segments = laneEaseSegments(host, "position");
+    expect(segments).toHaveLength(2);
+    expect(segments.map((segment) => segment.style.left)).toEqual(["0px", "100px"]);
+    expect(laneDiamonds(host, "position")).toHaveLength(3);
+    // Resting state: no button until a segment is hovered.
+    expect(laneEaseButtons(host, "position")).toHaveLength(0);
+
+    // Hovering reveals exactly one button — the hovered segment's.
+    expect(revealEaseButton(segments[0]!)).not.toBeNull();
+    expect(laneEaseButtons(host, "position")).toHaveLength(1);
+
+    // The ease button is available on hover even when the element is NOT selected
+    // (a lane shows for the track's active/primary clip, not only the selected one).
+    act(() => {
+      root.render(
+        <TimelinePropertyLanes
+          animations={animations}
+          clipStart={0}
+          clipDuration={1}
+          clipLeftPx={0}
+          clipWidthPx={200}
+          accentColor="#4ba3d2"
+          isSelected={false}
+          currentPercentage={-10}
+          elementId="clip-1"
+          selectedKeyframes={new Set()}
+          onSelectSegment={vi.fn()}
+        />,
+      );
+    });
+    const unselectedSegments = laneEaseSegments(host, "position");
+    expect(unselectedSegments).toHaveLength(2);
+    expect(revealEaseButton(unselectedSegments[0]!)).not.toBeNull();
+    act(() => root.unmount());
+  });
+
+  it("reveals each segment's button with its destination keyframe ease curve", () => {
+    const animations = [
+      animation("position-tween", "position", [
+        { percentage: 0, properties: { x: 0 } },
+        { percentage: 33, properties: { x: 33 }, ease: "none" },
+        { percentage: 66, properties: { x: 66 }, ease: "power2.out" },
+        {
+          percentage: 100,
+          properties: { x: 100 },
+          ease: "custom(M0,0 C0.1,0.2 0.3,0.9 1,1)",
+        },
+      ]),
+    ];
+    const { host, root } = renderPropertyLanes({ animations, onSelectSegment: vi.fn() });
+
+    const segments = laneEaseSegments(host, "position");
+    expect(segments).toHaveLength(3);
+    const paths = segments.map((segment) =>
+      revealEaseButton(segment)?.querySelector("path")?.getAttribute("d"),
+    );
+    expect(paths).toHaveLength(3);
+    expect(new Set(paths).size).toBe(3);
+    act(() => root.unmount());
+  });
+
+  it("selects the destination keyframe when a hovered segment's ease button is clicked", () => {
+    const onSelectSegment = vi.fn();
+    const { host, root } = renderPropertyLanes({
+      animations: [POSITION_SEGMENT_ANIMATION],
+      onSelectSegment,
+    });
+
+    const button = revealEaseButton(laneEaseSegments(host, "position")[0]!);
+    act(() => button?.click());
+
+    expect(onSelectSegment).toHaveBeenCalledWith({
+      animationId: "position-tween",
+      percentage: 50,
+      propertyGroup: "position",
+      tweenPercentage: 50,
+    });
+    act(() => root.unmount());
+  });
+
+  it("routes a colliding Position segment to the Position animation", () => {
+    const onSelectSegment = vi.fn();
+    const animations = [
+      POSITION_SEGMENT_ANIMATION,
+      animation("visual-tween", "visual", [
+        { percentage: 0, properties: { opacity: 0 } },
+        { percentage: 50, properties: { opacity: 0.5 } },
+      ]),
+    ];
+    const { host, root } = renderPropertyLanes({ animations, onSelectSegment });
+
+    const button = revealEaseButton(laneEaseSegments(host, "position")[0]!);
+    act(() => button?.click());
+
+    expect(onSelectSegment.mock.calls[0]?.[0]).toMatchObject({
+      animationId: "position-tween",
+      propertyGroup: "position",
+    });
+    act(() => root.unmount());
+  });
+
+  it("keeps the collapsed TimelineClipDiamonds positions and callback contract unchanged", () => {
+    const onClickKeyframe = vi.fn();
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() => {
+      root.render(
+        <TimelineClipDiamonds
+          keyframesData={{
+            format: "percentage",
+            keyframes: [
+              { percentage: 0, properties: { x: 0 } },
+              { percentage: 50, properties: { x: 100 } },
+            ],
+          }}
+          clipWidthPx={200}
+          clipHeightPx={48}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={-10}
+          elementId="clip-1"
+          selectedKeyframes={new Set(["clip-1:50"])}
+          onClickKeyframe={onClickKeyframe}
+        />,
+      );
+    });
+    const diamonds = Array.from(host.querySelectorAll<HTMLButtonElement>("button"));
+
+    // Unified keyframe-diamond size (LANE_H·ratio ≈ 22px, half 11) on collapsed
+    // clips too, so 0% sits at -11px regardless of clip-bar height.
+    expect(diamonds.map((diamond) => diamond.style.left)).toEqual(["-11px", "89px"]);
+    expect(diamonds[1]?.querySelector("path:last-child")?.getAttribute("fill")).toBe("#4ba3d2");
+    act(() => {
+      diamonds[1]?.dispatchEvent(new MouseEvent("pointerup", { bubbles: true, button: 0 }));
+    });
+    expect(onClickKeyframe).toHaveBeenCalledWith(50);
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
new file mode 100644
index 0000000000..bd518e7727
--- /dev/null
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
@@ -0,0 +1,163 @@
+import type { MouseEvent as ReactMouseEvent, RefObject } from "react";
+import {
+  classifyPropertyGroup,
+  type GsapAnimation,
+  type PropertyGroupName,
+} from "@hyperframes/core/gsap-parser";
+import { toAbsoluteTime } from "../../hooks/gsapShared";
+import { synthesizeFlatTweenKeyframes } from "../../hooks/gsapTweenSynth";
+import { TimelineDiamondLane, type TimelineDiamondKeyframe } from "./TimelineClipDiamonds";
+import { LANE_H, getTimelineLaneTop } from "./timelineLayout";
+import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
+
+export interface TimelinePropertyLanesProps {
+  animations: readonly GsapAnimation[];
+  clipStart: number;
+  clipDuration: number;
+  clipLeftPx: number;
+  clipWidthPx: number;
+  accentColor: string;
+  isSelected: boolean;
+  currentPercentage: number;
+  elementId: string;
+  selectedKeyframes: ReadonlySet<string>;
+  onSelectSegment?: (target: TimelineKeyframeTarget) => void;
+  onClickKeyframe?: (target: TimelineKeyframeTarget) => void;
+  onShiftClickKeyframe?: (target: TimelineKeyframeTarget) => void;
+  onContextMenuKeyframe?: (e: ReactMouseEvent, target: TimelineKeyframeTarget) => void;
+  onMoveKeyframe?: (target: TimelineKeyframeTarget, toClipPercentage: number) => Promise<boolean>;
+  suppressClickRef?: RefObject<boolean>;
+}
+
+function hasGroupProperty(
+  properties: Record<string, number | string>,
+  group: PropertyGroupName,
+): boolean {
+  return Object.keys(properties).some((property) => classifyPropertyGroup(property) === group);
+}
+
+/** The tween's editable keyframes: its real keyframes, or the start→end pair
+ *  synthesized for a flat tween. Empty for a tween that animates nothing. */
+function animationKeyframes(animation: GsapAnimation) {
+  return animation.keyframes?.keyframes ?? synthesizeFlatTweenKeyframes(animation)?.keyframes ?? [];
+}
+
+/** A tween contributes a property lane when it has a group and at least one
+ *  editable keyframe (real or synthesized). */
+export function animationContributesLane(animation: GsapAnimation): boolean {
+  return !!animation.propertyGroup && animationKeyframes(animation).length > 0;
+}
+
+function sourceGroups(animations: readonly GsapAnimation[]) {
+  const groups = new Map<PropertyGroupName, GsapAnimation[]>();
+  for (const animation of animations) {
+    if (!animation.propertyGroup || !animationContributesLane(animation)) continue;
+    const groupAnimations = groups.get(animation.propertyGroup) ?? [];
+    groupAnimations.push(animation);
+    groups.set(animation.propertyGroup, groupAnimations);
+  }
+  return groups;
+}
+
+function groupKeyframes(
+  animations: readonly GsapAnimation[],
+  group: PropertyGroupName,
+  clipStart: number,
+  clipDuration: number,
+): TimelineDiamondKeyframe[] {
+  const keyframes: TimelineDiamondKeyframe[] = [];
+  for (const animation of animations) {
+    const tweenStart =
+      animation.resolvedStart ?? (typeof animation.position === "number" ? animation.position : 0);
+    const tweenDuration = animation.duration ?? clipDuration;
+    for (const keyframe of animationKeyframes(animation)) {
+      if (!hasGroupProperty(keyframe.properties, group)) continue;
+      const absoluteTime = toAbsoluteTime(tweenStart, tweenDuration, keyframe.percentage);
+      keyframes.push({
+        ...keyframe,
+        percentage: ((absoluteTime - clipStart) / clipDuration) * 100,
+        tweenPercentage: keyframe.percentage,
+        propertyGroup: group,
+        animationId: animation.id,
+      });
+    }
+  }
+  return keyframes;
+}
+
+export function getTimelinePropertyLanes(
+  animations: readonly GsapAnimation[],
+  clipStart: number,
+  clipDuration: number,
+) {
+  if (clipDuration <= 0) return [];
+  return Array.from(sourceGroups(animations), ([group, groupAnimations]) => ({
+    group,
+    animations: groupAnimations,
+    keyframes: groupKeyframes(groupAnimations, group, clipStart, clipDuration),
+  })).filter((lane) => lane.keyframes.length > 0);
+}
+
+export function TimelinePropertyLanes({
+  animations,
+  clipStart,
+  clipDuration,
+  clipLeftPx,
+  clipWidthPx,
+  accentColor,
+  isSelected,
+  currentPercentage,
+  elementId,
+  selectedKeyframes,
+  onSelectSegment,
+  onClickKeyframe,
+  onShiftClickKeyframe,
+  onContextMenuKeyframe,
+  onMoveKeyframe,
+  suppressClickRef,
+}: TimelinePropertyLanesProps) {
+  if (clipWidthPx < 20 || clipDuration <= 0) return null;
+  const lanes = getTimelinePropertyLanes(animations, clipStart, clipDuration);
+
+  if (lanes.length === 0) return null;
+  return (
+    <>
+      {lanes.map(({ group, animations: groupAnimations, keyframes }, laneIndex) => (
+        <div
+          key={group}
+          data-property-group={group}
+          data-timeline-property-lane=""
+          data-timeline-lane-top={getTimelineLaneTop(laneIndex)}
+          className="absolute"
+          style={{
+            left: clipLeftPx,
+            top: getTimelineLaneTop(laneIndex),
+            width: clipWidthPx,
+            height: LANE_H,
+          }}
+        >
+          <TimelineDiamondLane
+            keyframesData={{ format: "percentage", keyframes }}
+            globalEase={
+              groupAnimations[0]?.keyframes?.easeEach ?? groupAnimations[0]?.ease ?? "none"
+            }
+            clipWidthPx={clipWidthPx}
+            clipHeightPx={LANE_H}
+            accentColor={accentColor}
+            isSelected={isSelected}
+            currentPercentage={currentPercentage}
+            elementId={elementId}
+            selectedKeyframes={selectedKeyframes}
+            onSelectSegment={onSelectSegment}
+            onClickKeyframe={onClickKeyframe}
+            onShiftClickKeyframe={onShiftClickKeyframe}
+            onContextMenuKeyframe={onContextMenuKeyframe}
+            onMoveKeyframe={onMoveKeyframe}
+            suppressClickRef={suppressClickRef}
+            groupAware
+          />
+        </div>
+      ))}
+    </>
+  );
+}
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 2677bf3a45..74eda4efe0 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -9,6 +9,10 @@ export const RULER_H = 24;
 export const CLIP_Y = 3;
 export const CLIP_HANDLE_W = 18;
 
+export function getTimelineLaneTop(laneIndex: number): number {
+  return TRACK_H + Math.max(0, Math.trunc(laneIndex)) * LANE_H;
+}
+
 /**
  * Collapsed-row characterization value for the new-track INSERT band. Runtime
  * hit-testing uses getTimelineInsertBoundaryBand with the concrete row height.
diff --git a/packages/studio/src/player/components/useAutoExpandKeyframedClips.test.tsx b/packages/studio/src/player/components/useAutoExpandKeyframedClips.test.tsx
new file mode 100644
index 0000000000..fdf7ff5f08
--- /dev/null
+++ b/packages/studio/src/player/components/useAutoExpandKeyframedClips.test.tsx
@@ -0,0 +1,75 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { usePlayerStore } from "../store/playerStore";
+import { useAutoExpandKeyframedClips } from "./useAutoExpandKeyframedClips";
+
+const studioShell = vi.hoisted(() => ({ projectId: "project-a" }));
+vi.mock("../../contexts/StudioContext", () => ({
+  useStudioShellContextOptional: () => studioShell,
+}));
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+afterEach(() => {
+  document.body.innerHTML = "";
+  studioShell.projectId = "project-a";
+  usePlayerStore.getState().reset();
+});
+
+const animations = new Map<string, GsapAnimation[]>([
+  [
+    "clip-1",
+    [
+      {
+        id: "position-tween",
+        targetSelector: "#clip-1",
+        method: "to",
+        position: 0,
+        duration: 1,
+        properties: { x: 100 },
+        propertyGroup: "position",
+      },
+    ],
+  ],
+]);
+
+function AutoExpandHarness({ value }: { value: Map<string, GsapAnimation[]> }) {
+  useAutoExpandKeyframedClips(value);
+  return null;
+}
+
+describe("useAutoExpandKeyframedClips", () => {
+  it("preserves manual collapse within a project and expands again in a different project", () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    const render = (projectId: string, value = new Map(animations)) => {
+      studioShell.projectId = projectId;
+      act(() => root.render(<AutoExpandHarness value={value} />));
+    };
+
+    const projectAAnimations = new Map(animations);
+    render("project-a", projectAAnimations);
+    expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set(["clip-1"]));
+
+    act(() => usePlayerStore.getState().toggleClipExpanded("clip-1"));
+    expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set());
+
+    const refreshedProjectAAnimations = new Map(animations);
+    render("project-a", refreshedProjectAAnimations);
+    expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set());
+
+    render("project-b", refreshedProjectAAnimations);
+    expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set());
+
+    render("project-b", new Map());
+    render("project-b");
+    expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set(["clip-1"]));
+
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts b/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts
new file mode 100644
index 0000000000..1ff3e1d91c
--- /dev/null
+++ b/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts
@@ -0,0 +1,36 @@
+import { useEffect, useRef } from "react";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import { usePlayerStore } from "../store/playerStore";
+import { STUDIO_KEYFRAMES_ENABLED } from "../../components/editor/manualEditingAvailability";
+import { useStudioShellContextOptional } from "../../contexts/StudioContext";
+import { animationContributesLane } from "./TimelinePropertyLanes";
+
+/**
+ * Keyframed clips start expanded (AE/Figma default). Auto-expands each clip the
+ * first time it contributes a lane — real keyframes OR a synthesizable flat tween
+ * — tracked per-clip so a later user collapse sticks and never bounces back open
+ * (and clips added later still auto-expand).
+ */
+export function useAutoExpandKeyframedClips(gsapAnimations: Map<string, GsapAnimation[]>): void {
+  const expandClips = usePlayerStore((s) => s.expandClips);
+  const projectId = useStudioShellContextOptional()?.projectId ?? null;
+  const seen = useRef({ projectId, source: gsapAnimations, clips: new Set<string>() });
+  useEffect(() => {
+    if (!STUDIO_KEYFRAMES_ENABLED) return;
+    if (seen.current.projectId !== projectId) {
+      const sourceChanged = seen.current.source !== gsapAnimations;
+      seen.current = { projectId, source: gsapAnimations, clips: new Set() };
+      if (!sourceChanged) return;
+    } else {
+      seen.current.source = gsapAnimations;
+    }
+    const fresh: string[] = [];
+    for (const [key, animations] of gsapAnimations) {
+      if (seen.current.clips.has(key)) continue;
+      if (animations.some(animationContributesLane)) fresh.push(key);
+    }
+    if (fresh.length === 0) return;
+    for (const key of fresh) seen.current.clips.add(key);
+    expandClips(fresh);
+  }, [gsapAnimations, expandClips, projectId]);
+}

From 8bb31b3949ca7320242fbeb26451512deedae9cc Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 16:52:35 +0200
Subject: [PATCH 076/125] feat(studio): add keyframe track headers

---
 .../components/editor/KeyframeNavigation.tsx  |  48 +-
 .../player/components/LayerDisclosureRow.tsx  |  56 ++
 .../components/TimelineTrackHeader.test.tsx   | 262 +++++++++
 .../player/components/TimelineTrackHeader.tsx | 552 ++++++++++++++++++
 .../player/components/timelineCallbacks.ts    |  32 +-
 .../src/player/components/timelineLayout.ts   |   1 +
 6 files changed, 937 insertions(+), 14 deletions(-)
 create mode 100644 packages/studio/src/player/components/LayerDisclosureRow.tsx
 create mode 100644 packages/studio/src/player/components/TimelineTrackHeader.test.tsx
 create mode 100644 packages/studio/src/player/components/TimelineTrackHeader.tsx

diff --git a/packages/studio/src/components/editor/KeyframeNavigation.tsx b/packages/studio/src/components/editor/KeyframeNavigation.tsx
index c54047c305..b8016f1a6b 100644
--- a/packages/studio/src/components/editor/KeyframeNavigation.tsx
+++ b/packages/studio/src/components/editor/KeyframeNavigation.tsx
@@ -22,6 +22,36 @@ interface KeyframeNavigationProps {
 
 const TOLERANCE = 0.5;
 
+interface NavigableKeyframe {
+  percentage: number;
+  tweenPercentage?: number;
+  properties: Record<string, number | string>;
+}
+
+export function getKeyframeNavigationState<Keyframe extends NavigableKeyframe>(
+  keyframes: readonly Keyframe[],
+  currentPercentage: number,
+  property?: string,
+) {
+  const propertyKeyframes = property
+    ? keyframes.filter((keyframe) => property in keyframe.properties)
+    : keyframes;
+  return {
+    propertyKeyframes,
+    prevKeyframe:
+      propertyKeyframes
+        .filter((keyframe) => keyframe.percentage < currentPercentage - TOLERANCE)
+        .at(-1) ?? null,
+    nextKeyframe:
+      propertyKeyframes.find((keyframe) => keyframe.percentage > currentPercentage + TOLERANCE) ??
+      null,
+    currentKeyframe:
+      propertyKeyframes.find(
+        (keyframe) => Math.abs(keyframe.percentage - currentPercentage) <= TOLERANCE,
+      ) ?? null,
+  };
+}
+
 /**
  * Convert a clip-relative percentage (element lifetime, used for display/seek) to
  * the TWEEN-relative percentage the GSAP writer/runtime key on. The clip→tween
@@ -92,18 +122,12 @@ export const KeyframeNavigation = memo(function KeyframeNavigation({
   onRemoveKeyframe,
   onConvertToKeyframes,
 }: KeyframeNavigationProps) {
-  // Find keyframes that contain this property
-  const propertyKeyframes = keyframes?.filter((kf) => property in kf.properties) ?? [];
-
-  const prevKf =
-    propertyKeyframes.filter((kf) => kf.percentage < currentPercentage - TOLERANCE).at(-1) ?? null;
-
-  const nextKf =
-    propertyKeyframes.find((kf) => kf.percentage > currentPercentage + TOLERANCE) ?? null;
-
-  const atCurrent =
-    propertyKeyframes.find((kf) => Math.abs(kf.percentage - currentPercentage) <= TOLERANCE) ??
-    null;
+  const {
+    propertyKeyframes,
+    prevKeyframe: prevKf,
+    nextKeyframe: nextKf,
+    currentKeyframe: atCurrent,
+  } = getKeyframeNavigationState(keyframes ?? [], currentPercentage, property);
 
   // Diamond state
   let diamondState: DiamondState;
diff --git a/packages/studio/src/player/components/LayerDisclosureRow.tsx b/packages/studio/src/player/components/LayerDisclosureRow.tsx
new file mode 100644
index 0000000000..b630482d69
--- /dev/null
+++ b/packages/studio/src/player/components/LayerDisclosureRow.tsx
@@ -0,0 +1,56 @@
+import { CaretRight } from "@phosphor-icons/react";
+import type { TimelineElement } from "../store/playerStore";
+import { LABEL_COL_W, TRACK_H } from "./timelineLayout";
+
+// Layer row (Figma order: disclosure ▸/▾, diamond, name) — the disclosure lives
+// here, not on the clip bar, and re-expands a collapsed layer.
+export function LayerDisclosureRow({
+  keyframeClip,
+  isExpanded,
+  gutterBackground,
+  onToggleClipExpanded,
+}: {
+  keyframeClip: TimelineElement;
+  isExpanded: boolean;
+  gutterBackground: string;
+  onToggleClipExpanded: () => void;
+}) {
+  const name = keyframeClip.label ?? keyframeClip.domId ?? keyframeClip.id;
+  return (
+    <div
+      className="absolute left-0 top-0 flex items-center gap-1.5 overflow-hidden px-1.5 text-[11px]"
+      style={{
+        width: LABEL_COL_W,
+        height: TRACK_H,
+        color: "#ffffff",
+        background: gutterBackground,
+      }}
+    >
+      <button
+        type="button"
+        aria-label={`${isExpanded ? "Collapse" : "Expand"} ${name} keyframes`}
+        title={`${isExpanded ? "Collapse" : "Expand"} keyframe lanes`}
+        className="flex h-5 w-4 shrink-0 items-center justify-center rounded border-0 bg-transparent p-0 text-white/55 hover:text-white focus-visible:outline focus-visible:outline-1 focus-visible:outline-[#3CE6AC]"
+        onPointerDown={(event) => event.stopPropagation()}
+        onClick={(event) => {
+          event.stopPropagation();
+          onToggleClipExpanded();
+        }}
+      >
+        <CaretRight
+          size={11}
+          weight="bold"
+          aria-hidden="true"
+          style={{ transform: isExpanded ? "rotate(90deg)" : undefined }}
+        />
+      </button>
+      <span
+        aria-label="Layer keyframe indicator"
+        className="shrink-0 text-[13px] leading-none text-white/40"
+      >
+        ◇
+      </span>
+      <span className="min-w-0 flex-1 truncate font-medium">{name}</span>
+    </div>
+  );
+}
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
new file mode 100644
index 0000000000..57d6fb127c
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
@@ -0,0 +1,262 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import type { GsapAnimation, PropertyGroupName } from "@hyperframes/core/gsap-parser";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { TimelinePropertyLanes } from "./TimelinePropertyLanes";
+import { TimelineTrackHeader } from "./TimelineTrackHeader";
+import { defaultTimelineTheme } from "./timelineTheme";
+import type { TimelineElement } from "../store/playerStore";
+import type { TimelineEditCallbacks } from "./timelineCallbacks";
+import { LABEL_COL_W } from "./timelineLayout";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+afterEach(() => {
+  document.body.innerHTML = "";
+});
+
+const ELEMENT: TimelineElement = {
+  id: "clip-1",
+  label: "Hero card",
+  tag: "div",
+  start: 0,
+  duration: 2,
+  track: 0,
+};
+
+function animation(
+  id: string,
+  propertyGroup: PropertyGroupName,
+  keyframes: Array<{
+    percentage: number;
+    properties: Record<string, number | string>;
+  }>,
+): GsapAnimation {
+  return {
+    id,
+    targetSelector: "#clip-1",
+    method: "to",
+    position: 0,
+    duration: 2,
+    properties: {},
+    propertyGroup,
+    keyframes: { format: "percentage", keyframes },
+  };
+}
+
+const POSITION = animation("position-tween", "position", [
+  { percentage: 0, properties: { x: 0, y: 0 } },
+  { percentage: 50, properties: { x: 100, y: 50 } },
+  { percentage: 100, properties: { x: 200, y: 100 } },
+]);
+
+const OPACITY = animation("opacity-tween", "visual", [
+  { percentage: 0, properties: { opacity: 0 } },
+  { percentage: 50, properties: { opacity: 0.5 } },
+  { percentage: 100, properties: { opacity: 1 } },
+]);
+
+interface RenderHeaderOptions {
+  animations?: GsapAnimation[];
+  currentTime?: number;
+  expanded?: boolean;
+  onSeek?: (time: number) => void;
+  onTogglePropertyGroupKeyframe?: TimelineEditCallbacks["onTogglePropertyGroupKeyframe"];
+}
+
+function renderHeader(options: RenderHeaderOptions = {}): {
+  host: HTMLDivElement;
+  root: Root;
+  rerender: (next: RenderHeaderOptions) => void;
+} {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  const render = (next: RenderHeaderOptions) => {
+    act(() => {
+      root.render(
+        <TimelineTrackHeader
+          trackNumber={0}
+          trackLabel="Hero card"
+          contentOrigin={LABEL_COL_W}
+          keyframeClip={ELEMENT}
+          isExpanded={next.expanded !== false}
+          animations={next.animations ?? [POSITION, OPACITY]}
+          currentTime={next.currentTime ?? 0}
+          isTrackHidden={false}
+          isAudioTrack={false}
+          isActive
+          isHovered={false}
+          theme={defaultTimelineTheme}
+          onToggleClipExpanded={vi.fn()}
+          onToggleTrackHidden={vi.fn()}
+          onTogglePropertyGroupKeyframe={next.onTogglePropertyGroupKeyframe}
+          onSeek={next.onSeek}
+        />,
+      );
+    });
+  };
+  render(options);
+  return { host, root, rerender: render };
+}
+
+function click(host: HTMLElement, label: string) {
+  const button = host.querySelector<HTMLButtonElement>(`button[aria-label="${label}"]`);
+  expect(button).not.toBeNull();
+  act(() => button?.click());
+}
+
+describe("TimelineTrackHeader", () => {
+  it("adds and removes a keyframe on the explicitly targeted property-group tween", () => {
+    const onTogglePropertyGroupKeyframe = vi.fn();
+    const view = renderHeader({ currentTime: 0.5, onTogglePropertyGroupKeyframe });
+
+    click(view.host, "Toggle Opacity keyframe");
+    expect(onTogglePropertyGroupKeyframe).toHaveBeenLastCalledWith(
+      ELEMENT,
+      expect.objectContaining({
+        animationId: "opacity-tween",
+        propertyGroup: "visual",
+        tweenPercentage: 25,
+        properties: { opacity: 0.25 },
+        remove: false,
+      }),
+    );
+
+    view.rerender({ currentTime: 1, onTogglePropertyGroupKeyframe });
+    click(view.host, "Toggle Opacity keyframe");
+    expect(onTogglePropertyGroupKeyframe).toHaveBeenLastCalledWith(
+      ELEMENT,
+      expect.objectContaining({
+        animationId: "opacity-tween",
+        propertyGroup: "visual",
+        tweenPercentage: 50,
+        properties: { opacity: 0.5 },
+        remove: true,
+      }),
+    );
+    expect(onTogglePropertyGroupKeyframe).not.toHaveBeenCalledWith(
+      ELEMENT,
+      expect.objectContaining({ animationId: "position-tween" }),
+    );
+    act(() => view.root.unmount());
+  });
+
+  it("seeks only to the selected group's adjacent keyframes", () => {
+    const onSeek = vi.fn();
+    const view = renderHeader({
+      currentTime: 1,
+      animations: [
+        POSITION,
+        animation("opacity-tween", "visual", [
+          { percentage: 25, properties: { opacity: 0.25 } },
+          { percentage: 50, properties: { opacity: 0.5 } },
+          { percentage: 75, properties: { opacity: 0.75 } },
+        ]),
+      ],
+      onSeek,
+    });
+
+    click(view.host, "Next Position keyframe");
+    expect(onSeek).toHaveBeenLastCalledWith(2);
+    click(view.host, "Previous Position keyframe");
+    expect(onSeek).toHaveBeenLastCalledWith(0);
+    expect(onSeek).not.toHaveBeenCalledWith(1.5);
+    act(() => view.root.unmount());
+  });
+
+  it("fills the toggle diamond exactly at that group's keyframe", () => {
+    const view = renderHeader({ currentTime: 0.5 });
+    const positionToggle = view.host.querySelector<HTMLButtonElement>(
+      'button[aria-label="Toggle Position keyframe"]',
+    );
+    expect(positionToggle?.textContent).toBe("◇");
+
+    view.rerender({ currentTime: 1 });
+    expect(
+      view.host.querySelector<HTMLButtonElement>('button[aria-label="Toggle Position keyframe"]')
+        ?.textContent,
+    ).toBe("◆");
+    act(() => view.root.unmount());
+  });
+
+  it("updates formatted group values when the playhead moves", () => {
+    const view = renderHeader({ currentTime: 0.5 });
+    expect(view.host.querySelector('[data-property-group="position"]')?.textContent).toContain(
+      "50, 25",
+    );
+    expect(view.host.querySelector('[data-property-group="visual"]')?.textContent).toContain("25%");
+
+    view.rerender({ currentTime: 1.5 });
+    expect(view.host.querySelector('[data-property-group="position"]')?.textContent).toContain(
+      "150, 75",
+    );
+    expect(view.host.querySelector('[data-property-group="visual"]')?.textContent).toContain("75%");
+    act(() => view.root.unmount());
+  });
+
+  it("disables the previous chevron at or before the group's first keyframe", () => {
+    const view = renderHeader({ currentTime: 0 });
+    const prevAt0 = view.host.querySelector<HTMLButtonElement>(
+      'button[aria-label="Previous Position keyframe"]',
+    );
+    expect(prevAt0).not.toBeNull();
+    expect(prevAt0?.disabled).toBe(true);
+
+    view.rerender({ currentTime: 1 });
+    const prevAt1 = view.host.querySelector<HTMLButtonElement>(
+      'button[aria-label="Previous Position keyframe"]',
+    );
+    expect(prevAt1?.disabled).toBe(false);
+    act(() => view.root.unmount());
+  });
+
+  it("uses the same lane row offsets when collapsed, expanded once, and expanded multiple times", () => {
+    const view = renderHeader({ expanded: false });
+    expect(view.host.querySelectorAll("[data-timeline-lane-top]")).toHaveLength(0);
+
+    const assertAligned = (animations: GsapAnimation[]) => {
+      view.rerender({ animations });
+      const lanesHost = document.createElement("div");
+      document.body.append(lanesHost);
+      const lanesRoot = createRoot(lanesHost);
+      act(() => {
+        lanesRoot.render(
+          <TimelinePropertyLanes
+            animations={animations}
+            clipStart={0}
+            clipDuration={2}
+            clipLeftPx={120}
+            clipWidthPx={200}
+            accentColor="#3CE6AC"
+            isSelected
+            currentPercentage={0}
+            elementId="clip-1"
+            selectedKeyframes={new Set()}
+          />,
+        );
+      });
+      expect(
+        Array.from(view.host.querySelectorAll<HTMLElement>("[data-timeline-lane-top]")).map(
+          (row) => row.style.top,
+        ),
+      ).toEqual(
+        Array.from(lanesHost.querySelectorAll<HTMLElement>("[data-timeline-lane-top]")).map(
+          (row) => row.style.top,
+        ),
+      );
+      expect(
+        Array.from(lanesHost.querySelectorAll<HTMLElement>("[data-timeline-property-lane]")).map(
+          (row) => row.style.left,
+        ),
+      ).toEqual(animations.map(() => "120px"));
+      act(() => lanesRoot.unmount());
+    };
+
+    assertAligned([POSITION]);
+    assertAligned([POSITION, OPACITY]);
+    act(() => view.root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
new file mode 100644
index 0000000000..e27812aab9
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -0,0 +1,552 @@
+import { useState } from "react";
+import { Eye, EyeSlash } from "@phosphor-icons/react";
+import {
+  classifyPropertyGroup,
+  type GsapAnimation,
+  type PropertyGroupName,
+} from "@hyperframes/core/gsap-parser";
+import {
+  clipToTweenPercentage,
+  getKeyframeNavigationState,
+} from "../../components/editor/KeyframeNavigation";
+import { Music } from "../../icons/SystemIcons";
+import {
+  absoluteToPercentageForAnimation,
+  isTimeWithinTween,
+  resolveTweenDuration,
+  resolveTweenStart,
+} from "../../utils/globalTimeCompiler";
+import type { TimelineElement } from "../store/playerStore";
+import type {
+  TimelineEditCallbacks,
+  TimelinePropertyGroupKeyframeToggle,
+} from "./timelineCallbacks";
+import { getTimelinePropertyLanes } from "./TimelinePropertyLanes";
+import { LayerDisclosureRow } from "./LayerDisclosureRow";
+import { LABEL_COL_W, LANE_H, getTimelineLaneTop } from "./timelineLayout";
+import type { TimelineTheme } from "./timelineTheme";
+
+interface TimelineTrackHeaderProps {
+  trackNumber: number;
+  trackLabel: string;
+  contentOrigin: number;
+  /** The track's active keyframe clip (selected, else primary) — the one whose
+   *  disclosure + property rows this header shows, whether expanded or not. */
+  keyframeClip: TimelineElement | null;
+  isExpanded: boolean;
+  animations: readonly GsapAnimation[];
+  currentTime: number;
+  isTrackHidden: boolean;
+  isAudioTrack: boolean;
+  isActive: boolean;
+  isHovered: boolean;
+  theme: TimelineTheme;
+  onToggleClipExpanded: () => void;
+  onToggleTrackHidden: TimelineEditCallbacks["onToggleTrackHidden"];
+  onTogglePropertyGroupKeyframe?: TimelineEditCallbacks["onTogglePropertyGroupKeyframe"];
+  onSeek?: (time: number) => void;
+}
+
+function roundValue(value: number): string {
+  return String(Math.round(value * 100) / 100);
+}
+
+function propertyValueAt(
+  animation: GsapAnimation,
+  property: string,
+  tweenPercentage: number,
+): number | string | undefined {
+  const keyframes = animation.keyframes?.keyframes ?? [];
+  const values = keyframes
+    .filter((keyframe) => property in keyframe.properties)
+    .map((keyframe) => ({
+      percentage: keyframe.percentage,
+      value: keyframe.properties[property],
+    }));
+  const before = values.filter((value) => value.percentage <= tweenPercentage).at(-1);
+  const after = values.find((value) => value.percentage >= tweenPercentage);
+  if (!before) return after?.value;
+  if (!after) return before.value;
+  if (
+    typeof before.value !== "number" ||
+    typeof after.value !== "number" ||
+    before.percentage === after.percentage
+  ) {
+    return before.value;
+  }
+  const progress = (tweenPercentage - before.percentage) / (after.percentage - before.percentage);
+  return before.value + (after.value - before.value) * progress;
+}
+
+function valuesAt(
+  animation: GsapAnimation,
+  group: PropertyGroupName,
+  tweenPercentage: number,
+): Record<string, number | string> {
+  const propertyNames = new Set<string>();
+  for (const keyframe of animation.keyframes?.keyframes ?? []) {
+    for (const property of Object.keys(keyframe.properties)) {
+      if (classifyPropertyGroup(property) === group) propertyNames.add(property);
+    }
+  }
+  const values: Record<string, number | string> = {};
+  for (const property of propertyNames) {
+    const value = propertyValueAt(animation, property, tweenPercentage);
+    if (value !== undefined) values[property] = value;
+  }
+  return values;
+}
+
+function groupLabel(group: PropertyGroupName, properties: Record<string, number | string>): string {
+  if (group === "visual" && ("opacity" in properties || "autoAlpha" in properties)) {
+    return "Opacity";
+  }
+  if (group !== "other") return `${group[0]?.toUpperCase() ?? ""}${group.slice(1)}`;
+  const property = Object.keys(properties)[0];
+  return property ? `${property[0]?.toUpperCase() ?? ""}${property.slice(1)}` : "Other";
+}
+
+type LaneValues = Record<string, number | string>;
+
+function defaultValueReadout(values: LaneValues): string {
+  return Object.values(values)
+    .map((value) => (typeof value === "number" ? roundValue(value) : value))
+    .join(", ");
+}
+
+function positionValueReadout(values: LaneValues): string | null {
+  const x = values.x;
+  const y = values.y;
+  return typeof x === "number" && typeof y === "number"
+    ? `${roundValue(x)}, ${roundValue(y)}`
+    : null;
+}
+
+function rotationValueReadout(values: LaneValues): string | null {
+  return typeof values.rotation === "number" ? `${roundValue(values.rotation)}°` : null;
+}
+
+function visualValueReadout(values: LaneValues): string | null {
+  const opacity = values.opacity ?? values.autoAlpha;
+  return typeof opacity === "number"
+    ? `${roundValue(Math.abs(opacity) <= 1 ? opacity * 100 : opacity)}%`
+    : null;
+}
+
+const GROUP_VALUE_READOUTS: Partial<
+  Record<PropertyGroupName, (values: LaneValues) => string | null>
+> = {
+  position: positionValueReadout,
+  rotation: rotationValueReadout,
+  visual: visualValueReadout,
+};
+
+function valueReadout(group: PropertyGroupName, values: Record<string, number | string>): string {
+  return GROUP_VALUE_READOUTS[group]?.(values) ?? defaultValueReadout(values);
+}
+
+function VisibilityButton({
+  hidden,
+  trackNumber,
+  visible,
+  onToggle,
+}: {
+  hidden: boolean;
+  trackNumber: number;
+  visible: boolean;
+  onToggle: TimelineEditCallbacks["onToggleTrackHidden"];
+}) {
+  if (!visible) return <span aria-hidden="true" className="h-6 w-6 shrink-0" />;
+  const label = hidden ? `Show track ${trackNumber}` : `Hide track ${trackNumber}`;
+  return (
+    <button
+      type="button"
+      aria-label={label}
+      title={label}
+      className={`flex h-6 w-6 shrink-0 items-center justify-center rounded border-0 bg-transparent p-0 transition-colors focus-visible:outline focus-visible:outline-1 focus-visible:outline-offset-[-1px] focus-visible:outline-[#3CE6AC] ${
+        hidden ? "text-[#3CE6AC] hover:text-white" : "text-white/35 hover:text-white/75"
+      }`}
+      onPointerDown={(event) => event.stopPropagation()}
+      onClick={(event) => {
+        event.stopPropagation();
+        void onToggle?.(trackNumber, !hidden);
+      }}
+    >
+      {hidden ? (
+        <EyeSlash size={14} weight="bold" aria-hidden="true" />
+      ) : (
+        <Eye size={14} weight="bold" aria-hidden="true" />
+      )}
+    </button>
+  );
+}
+
+function LegacyTrackHeader({
+  trackNumber,
+  trackLabel,
+  showTrackLabel,
+  isTrackHidden,
+  isAudioTrack,
+  onToggleTrackHidden,
+}: Pick<
+  TimelineTrackHeaderProps,
+  "trackNumber" | "trackLabel" | "isTrackHidden" | "isAudioTrack" | "onToggleTrackHidden"
+> & { showTrackLabel: boolean }) {
+  return (
+    <>
+      {isAudioTrack && (
+        <Music size={12} weight="fill" aria-hidden="true" className="text-white/35" />
+      )}
+      {showTrackLabel && <span className="min-w-0 flex-1 truncate text-[11px]">{trackLabel}</span>}
+      <VisibilityButton
+        hidden={isTrackHidden}
+        trackNumber={trackNumber}
+        visible
+        onToggle={onToggleTrackHidden}
+      />
+    </>
+  );
+}
+
+type TimelinePropertyLane = ReturnType<typeof getTimelinePropertyLanes>[number];
+type KeyframeNavigationState = ReturnType<
+  typeof getKeyframeNavigationState<TimelinePropertyLane["keyframes"][number]>
+>;
+
+function findNearestLaneKeyframe(lane: TimelinePropertyLane, clipPercentage: number) {
+  return lane.keyframes.reduce<(typeof lane.keyframes)[number] | null>(
+    (nearest, keyframe) =>
+      !nearest ||
+      Math.abs(keyframe.percentage - clipPercentage) < Math.abs(nearest.percentage - clipPercentage)
+        ? keyframe
+        : nearest,
+    null,
+  );
+}
+
+function findAnimationAtTime(animations: TimelinePropertyLane["animations"], currentTime: number) {
+  return animations.find((candidate) => {
+    const start = resolveTweenStart(candidate);
+    return start !== null && isTimeWithinTween(currentTime, start, resolveTweenDuration(candidate));
+  });
+}
+
+function resolveLaneAnimation(
+  lane: TimelinePropertyLane,
+  navigation: KeyframeNavigationState,
+  nearestKeyframe: TimelinePropertyLane["keyframes"][number] | null,
+  animationAtPlayhead: GsapAnimation | undefined,
+) {
+  const animationId = navigation.currentKeyframe?.animationId ?? nearestKeyframe?.animationId;
+  return animationAtPlayhead ?? lane.animations.find((candidate) => candidate.id === animationId);
+}
+
+function resolveLaneTweenPercentage(
+  navigation: KeyframeNavigationState,
+  animation: GsapAnimation | undefined,
+  animationKeyframes: TimelinePropertyLane["keyframes"],
+  currentTime: number,
+  clipPercentage: number,
+) {
+  return (
+    navigation.currentKeyframe?.tweenPercentage ??
+    (animation ? absoluteToPercentageForAnimation(currentTime, animation) : null) ??
+    clipToTweenPercentage(animationKeyframes, clipPercentage)
+  );
+}
+
+function valuesForLaneAnimation(
+  animation: GsapAnimation | undefined,
+  lane: TimelinePropertyLane,
+  tweenPercentage: number,
+) {
+  return animation ? valuesAt(animation, lane.group, tweenPercentage) : {};
+}
+
+function createLaneToggleTarget(
+  animation: GsapAnimation | undefined,
+  lane: TimelinePropertyLane,
+  tweenPercentage: number,
+  values: LaneValues,
+  navigation: KeyframeNavigationState,
+): TimelinePropertyGroupKeyframeToggle | null {
+  return animation
+    ? {
+        animationId: animation.id,
+        propertyGroup: lane.group,
+        tweenPercentage,
+        properties: values,
+        remove: navigation.currentKeyframe !== null,
+      }
+    : null;
+}
+
+function resolveLaneHeaderState(
+  lane: TimelinePropertyLane,
+  currentTime: number,
+  clipPercentage: number,
+) {
+  const navigation = getKeyframeNavigationState(lane.keyframes, clipPercentage);
+  const nearestKeyframe = findNearestLaneKeyframe(lane, clipPercentage);
+  const animationAtPlayhead = findAnimationAtTime(lane.animations, currentTime);
+  const animation = resolveLaneAnimation(lane, navigation, nearestKeyframe, animationAtPlayhead);
+  const animationKeyframes = lane.keyframes.filter(
+    (keyframe) => keyframe.animationId === animation?.id,
+  );
+  const tweenPercentage = resolveLaneTweenPercentage(
+    navigation,
+    animation,
+    animationKeyframes,
+    currentTime,
+    clipPercentage,
+  );
+  const values = valuesForLaneAnimation(animation, lane, tweenPercentage);
+  const label = groupLabel(lane.group, values);
+  const toggleTarget = createLaneToggleTarget(animation, lane, tweenPercentage, values, navigation);
+
+  return {
+    navigation,
+    nearestKeyframe,
+    animationAtPlayhead,
+    animation,
+    animationKeyframes,
+    tweenPercentage,
+    values,
+    label,
+    toggleTarget,
+  };
+}
+
+// Figma layout: prev-keyframe ‹, the add/remove toggle (children), next ›.
+function PropertyGroupNavigation({
+  navigation,
+  label,
+  expandedElement,
+  onSeek,
+  children,
+}: {
+  navigation: KeyframeNavigationState;
+  label: string;
+  expandedElement: TimelineElement;
+  onSeek?: (time: number) => void;
+  children: React.ReactNode;
+}) {
+  const seekTo = (keyframe: { percentage: number } | null) => {
+    if (keyframe) {
+      onSeek?.(expandedElement.start + (keyframe.percentage / 100) * expandedElement.duration);
+    }
+  };
+  return (
+    <span className="flex shrink-0 items-center gap-0.5">
+      <button
+        type="button"
+        aria-label={`Previous ${label} keyframe`}
+        disabled={!navigation.prevKeyframe}
+        className="h-5 w-3 border-0 bg-transparent p-0 text-white/55 hover:text-white disabled:text-white/15"
+        onClick={() => seekTo(navigation.prevKeyframe)}
+      >
+        ‹
+      </button>
+      {children}
+      <button
+        type="button"
+        aria-label={`Next ${label} keyframe`}
+        disabled={!navigation.nextKeyframe}
+        className="h-5 w-3 border-0 bg-transparent p-0 text-white/55 hover:text-white disabled:text-white/15"
+        onClick={() => seekTo(navigation.nextKeyframe)}
+      >
+        ›
+      </button>
+    </span>
+  );
+}
+
+function PropertyGroupHeaderRow({
+  lane,
+  laneIndex,
+  isLastLane,
+  expandedElement,
+  currentTime,
+  clipPercentage,
+  hoveredGroup,
+  setHoveredGroup,
+  isActive,
+  isHovered,
+  isTrackHidden,
+  trackNumber,
+  gutterBackground,
+  onToggleTrackHidden,
+  onTogglePropertyGroupKeyframe,
+  onSeek,
+}: {
+  lane: TimelinePropertyLane;
+  laneIndex: number;
+  isLastLane: boolean;
+  expandedElement: TimelineElement;
+  currentTime: number;
+  clipPercentage: number;
+  hoveredGroup: PropertyGroupName | null;
+  setHoveredGroup: (group: PropertyGroupName | null) => void;
+  isActive: boolean;
+  isHovered: boolean;
+  isTrackHidden: boolean;
+  trackNumber: number;
+  gutterBackground: string;
+  onToggleTrackHidden: TimelineEditCallbacks["onToggleTrackHidden"];
+  onTogglePropertyGroupKeyframe?: TimelineEditCallbacks["onTogglePropertyGroupKeyframe"];
+  onSeek?: (time: number) => void;
+}) {
+  const { navigation, values, label, toggleTarget } = resolveLaneHeaderState(
+    lane,
+    currentTime,
+    clipPercentage,
+  );
+  const showEye =
+    hoveredGroup === lane.group ||
+    (hoveredGroup === null && laneIndex === 0 && (isActive || isHovered));
+
+  return (
+    <div
+      data-property-group={lane.group}
+      data-timeline-lane-top={getTimelineLaneTop(laneIndex)}
+      className="absolute left-0 flex items-center gap-1 px-1.5 text-[10px] text-white/65"
+      style={{
+        top: getTimelineLaneTop(laneIndex),
+        width: LABEL_COL_W,
+        height: LANE_H,
+        background: gutterBackground,
+      }}
+      onPointerEnter={() => setHoveredGroup(lane.group)}
+      onPointerLeave={() => setHoveredGroup(null)}
+    >
+      {/* Tree connector: vertical spine (top-half on the last lane) + branch tick. */}
+      <span className="relative h-full w-3 shrink-0" aria-hidden="true">
+        <span
+          className="absolute left-1.5 top-0 w-px bg-white/15"
+          style={{ height: isLastLane ? "50%" : "100%" }}
+        />
+        <span className="absolute left-1.5 top-1/2 h-px w-1.5 bg-white/15" />
+      </span>
+      <span className="w-[46px] shrink-0 truncate text-white">{label}</span>
+      <PropertyGroupNavigation
+        navigation={navigation}
+        label={label}
+        expandedElement={expandedElement}
+        onSeek={onSeek}
+      >
+        <button
+          type="button"
+          aria-label={`Toggle ${label} keyframe`}
+          title={`${navigation.currentKeyframe ? "Remove" : "Add"} ${label} keyframe`}
+          className="flex h-5 w-4 shrink-0 items-center justify-center border-0 bg-transparent p-0 text-[11px] text-[#3CE6AC] focus-visible:outline focus-visible:outline-1 focus-visible:outline-[#3CE6AC]"
+          onClick={() => {
+            if (expandedElement && toggleTarget) {
+              void onTogglePropertyGroupKeyframe?.(expandedElement, toggleTarget);
+            }
+          }}
+        >
+          {navigation.currentKeyframe ? "◆" : "◇"}
+        </button>
+      </PropertyGroupNavigation>
+      <span className="min-w-0 flex-1 truncate text-right tabular-nums text-white/45">
+        {valueReadout(lane.group, values)}
+      </span>
+      <VisibilityButton
+        hidden={isTrackHidden}
+        trackNumber={trackNumber}
+        visible={showEye}
+        onToggle={onToggleTrackHidden}
+      />
+    </div>
+  );
+}
+
+export function TimelineTrackHeader({
+  trackNumber,
+  trackLabel,
+  contentOrigin,
+  keyframeClip,
+  isExpanded,
+  animations,
+  currentTime,
+  isTrackHidden,
+  isAudioTrack,
+  isActive,
+  isHovered,
+  theme,
+  onToggleClipExpanded,
+  onToggleTrackHidden,
+  onTogglePropertyGroupKeyframe,
+  onSeek,
+}: TimelineTrackHeaderProps) {
+  const [hoveredGroup, setHoveredGroup] = useState<PropertyGroupName | null>(null);
+  const clipPercentage = keyframeClip
+    ? ((currentTime - keyframeClip.start) / keyframeClip.duration) * 100
+    : 0;
+  const lanes = keyframeClip
+    ? getTimelinePropertyLanes(animations, keyframeClip.start, keyframeClip.duration)
+    : [];
+  // Label mode = keyframe view; the label column stays LABEL_COL_W (Timeline.tsx
+  // owns the gutter past it, so a 0% diamond isn't clipped by this panel).
+  const showTrackLabel = contentOrigin >= LABEL_COL_W;
+  const isKeyframeLayer = !!keyframeClip && lanes.length > 0;
+
+  return (
+    <div
+      className={`sticky left-0 z-[12] shrink-0 ${
+        !isKeyframeLayer
+          ? showTrackLabel
+            ? "flex items-center gap-1 px-1.5 text-white/55"
+            : "flex flex-col items-center justify-center gap-0.5"
+          : ""
+      }`}
+      style={{
+        width: showTrackLabel ? LABEL_COL_W : contentOrigin,
+        background: theme.gutterBackground,
+        borderRight: `1px solid ${theme.gutterBorder}`,
+      }}
+    >
+      {!keyframeClip || lanes.length === 0 ? (
+        <LegacyTrackHeader
+          trackNumber={trackNumber}
+          trackLabel={trackLabel}
+          showTrackLabel={showTrackLabel}
+          isTrackHidden={isTrackHidden}
+          isAudioTrack={isAudioTrack}
+          onToggleTrackHidden={onToggleTrackHidden}
+        />
+      ) : (
+        <>
+          <LayerDisclosureRow
+            keyframeClip={keyframeClip}
+            isExpanded={isExpanded}
+            gutterBackground={theme.gutterBackground}
+            onToggleClipExpanded={onToggleClipExpanded}
+          />
+          {isExpanded &&
+            lanes.map((lane, laneIndex) => (
+              <PropertyGroupHeaderRow
+                key={lane.group}
+                lane={lane}
+                laneIndex={laneIndex}
+                isLastLane={laneIndex === lanes.length - 1}
+                expandedElement={keyframeClip}
+                currentTime={currentTime}
+                clipPercentage={clipPercentage}
+                hoveredGroup={hoveredGroup}
+                setHoveredGroup={setHoveredGroup}
+                isActive={isActive}
+                isHovered={isHovered}
+                isTrackHidden={isTrackHidden}
+                trackNumber={trackNumber}
+                gutterBackground={theme.gutterBackground}
+                onToggleTrackHidden={onToggleTrackHidden}
+                onTogglePropertyGroupKeyframe={onTogglePropertyGroupKeyframe}
+                onSeek={onSeek}
+              />
+            ))}
+        </>
+      )}
+    </div>
+  );
+}
diff --git a/packages/studio/src/player/components/timelineCallbacks.ts b/packages/studio/src/player/components/timelineCallbacks.ts
index 71db7d8637..ced618e716 100644
--- a/packages/studio/src/player/components/timelineCallbacks.ts
+++ b/packages/studio/src/player/components/timelineCallbacks.ts
@@ -3,6 +3,15 @@
 import type { TimelineElement } from "../store/playerStore";
 import type { TimelineMoveOperation } from "../../hooks/timelineMoveAdapter";
 import type { BlockedTimelineEditIntent } from "./timelineEditing";
+import type { PropertyGroupName } from "@hyperframes/core/gsap-parser";
+
+export interface TimelinePropertyGroupKeyframeToggle {
+  animationId: string;
+  propertyGroup: PropertyGroupName;
+  tweenPercentage: number;
+  properties: Record<string, number | string>;
+  remove: boolean;
+}
 
 /**
  * Shared callback signatures for timeline editing operations.
@@ -62,14 +71,33 @@ export interface TimelineEditCallbacks {
   onSplitElement?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
   onRazorSplit?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
   onRazorSplitAll?: (splitTime: number) => Promise<void> | void;
-  onDeleteKeyframe?: (elementId: string, percentage: number) => void;
+  onDeleteKeyframe?: (
+    elementId: string,
+    percentage: number,
+    propertyGroup?: string,
+    tweenPercentage?: number,
+    animationId?: string,
+  ) => void;
   onDeleteAllKeyframes?: (elementId: string) => void;
   onChangeKeyframeEase?: (elementId: string, percentage: number, ease: string) => void;
-  onMoveKeyframeToPlayhead?: (elementId: string, percentage: number) => void;
+  onMoveKeyframeToPlayhead?: (
+    elementId: string,
+    percentage: number,
+    propertyGroup?: string,
+    tweenPercentage?: number,
+    animationId?: string,
+  ) => void;
   onMoveKeyframe?: (
     elementId: string,
     fromClipPercentage: number,
     toClipPercentage: number,
+    propertyGroup?: string,
+    tweenPercentage?: number,
+    animationId?: string,
   ) => Promise<boolean>;
   onToggleKeyframeAtPlayhead?: (element: TimelineElement) => void;
+  onTogglePropertyGroupKeyframe?: (
+    element: TimelineElement,
+    target: TimelinePropertyGroupKeyframeToggle,
+  ) => Promise<void> | void;
 }
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 74eda4efe0..07790e7743 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -3,6 +3,7 @@ import type { ZoomMode } from "../store/playerStore";
 
 /* ── Layout constants ──────────────────────────────────────────────── */
 export const GUTTER = 32;
+export const LABEL_COL_W = 232;
 export const TRACK_H = 48;
 export const LANE_H = 28;
 export const RULER_H = 24;

From c264cf266f1c99f01f864587fcbb3e1dcc8ae763 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 22:57:20 +0200
Subject: [PATCH 077/125] fix(studio): stop lane-header clicks from reaching
 the track row

The prev/next keyframe chevrons and the group toggle diamond let their
click bubble to the ancestor track row, so seeking to a keyframe also
reselected the track. The disclosure caret and the eye already stop it;
these now match.

Truncated labels (layer name, track label, group label, value readout)
also carry a title so the full text is reachable on hover.
---
 .../player/components/LayerDisclosureRow.tsx  |  4 ++-
 .../components/TimelineTrackHeader.test.tsx   | 31 +++++++++++++++++++
 .../player/components/TimelineTrackHeader.tsx | 30 ++++++++++++++----
 3 files changed, 58 insertions(+), 7 deletions(-)

diff --git a/packages/studio/src/player/components/LayerDisclosureRow.tsx b/packages/studio/src/player/components/LayerDisclosureRow.tsx
index b630482d69..c061da300c 100644
--- a/packages/studio/src/player/components/LayerDisclosureRow.tsx
+++ b/packages/studio/src/player/components/LayerDisclosureRow.tsx
@@ -50,7 +50,9 @@ export function LayerDisclosureRow({
       >
         ◇
       </span>
-      <span className="min-w-0 flex-1 truncate font-medium">{name}</span>
+      <span className="min-w-0 flex-1 truncate font-medium" title={name}>
+        {name}
+      </span>
     </div>
   );
 }
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
index 57d6fb127c..094b54a5f6 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
@@ -167,6 +167,37 @@ describe("TimelineTrackHeader", () => {
     act(() => view.root.unmount());
   });
 
+  // The lane header sits inside the track row, whose own click handler selects
+  // the track. Every control in the label column has to own its click, or
+  // seeking to a keyframe also reselects whatever is behind the header.
+  it("keeps lane-header control clicks off the ancestor track row", () => {
+    const onAncestorClick = vi.fn();
+    const view = renderHeader({
+      currentTime: 1,
+      onSeek: vi.fn(),
+      onTogglePropertyGroupKeyframe: vi.fn(),
+    });
+    // React 18 delegates from the root container, so an ancestor of it is where
+    // a leaked click actually shows up.
+    document.body.addEventListener("click", onAncestorClick);
+
+    // Every control in the lane's label column, found by row rather than by
+    // label, so a wording change to one button can't silently drop it here.
+    const controls = view.host.querySelectorAll<HTMLButtonElement>(
+      '[data-property-group="position"] button',
+    );
+    expect(controls.length).toBeGreaterThanOrEqual(3);
+    for (const button of controls) {
+      act(() => {
+        button.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+      });
+    }
+
+    document.body.removeEventListener("click", onAncestorClick);
+    expect(onAncestorClick).not.toHaveBeenCalled();
+    act(() => view.root.unmount());
+  });
+
   it("fills the toggle diamond exactly at that group's keyframe", () => {
     const view = renderHeader({ currentTime: 0.5 });
     const positionToggle = view.host.querySelector<HTMLButtonElement>(
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index e27812aab9..c0fac5b494 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -197,7 +197,11 @@ function LegacyTrackHeader({
       {isAudioTrack && (
         <Music size={12} weight="fill" aria-hidden="true" className="text-white/35" />
       )}
-      {showTrackLabel && <span className="min-w-0 flex-1 truncate text-[11px]">{trackLabel}</span>}
+      {showTrackLabel && (
+        <span className="min-w-0 flex-1 truncate text-[11px]" title={trackLabel}>
+          {trackLabel}
+        </span>
+      )}
       <VisibilityButton
         hidden={isTrackHidden}
         trackNumber={trackNumber}
@@ -343,7 +347,10 @@ function PropertyGroupNavigation({
         aria-label={`Previous ${label} keyframe`}
         disabled={!navigation.prevKeyframe}
         className="h-5 w-3 border-0 bg-transparent p-0 text-white/55 hover:text-white disabled:text-white/15"
-        onClick={() => seekTo(navigation.prevKeyframe)}
+        onClick={(event) => {
+          event.stopPropagation();
+          seekTo(navigation.prevKeyframe);
+        }}
       >
         ‹
       </button>
@@ -353,7 +360,10 @@ function PropertyGroupNavigation({
         aria-label={`Next ${label} keyframe`}
         disabled={!navigation.nextKeyframe}
         className="h-5 w-3 border-0 bg-transparent p-0 text-white/55 hover:text-white disabled:text-white/15"
-        onClick={() => seekTo(navigation.nextKeyframe)}
+        onClick={(event) => {
+          event.stopPropagation();
+          seekTo(navigation.nextKeyframe);
+        }}
       >
         ›
       </button>
@@ -427,7 +437,9 @@ function PropertyGroupHeaderRow({
         />
         <span className="absolute left-1.5 top-1/2 h-px w-1.5 bg-white/15" />
       </span>
-      <span className="w-[46px] shrink-0 truncate text-white">{label}</span>
+      <span className="w-[46px] shrink-0 truncate text-white" title={label}>
+        {label}
+      </span>
       <PropertyGroupNavigation
         navigation={navigation}
         label={label}
@@ -439,7 +451,10 @@ function PropertyGroupHeaderRow({
           aria-label={`Toggle ${label} keyframe`}
           title={`${navigation.currentKeyframe ? "Remove" : "Add"} ${label} keyframe`}
           className="flex h-5 w-4 shrink-0 items-center justify-center border-0 bg-transparent p-0 text-[11px] text-[#3CE6AC] focus-visible:outline focus-visible:outline-1 focus-visible:outline-[#3CE6AC]"
-          onClick={() => {
+          onClick={(event) => {
+            // Same as the disclosure caret and the eye: a control in the label
+            // column owns its click, it does not also hit the track row behind it.
+            event.stopPropagation();
             if (expandedElement && toggleTarget) {
               void onTogglePropertyGroupKeyframe?.(expandedElement, toggleTarget);
             }
@@ -448,7 +463,10 @@ function PropertyGroupHeaderRow({
           {navigation.currentKeyframe ? "◆" : "◇"}
         </button>
       </PropertyGroupNavigation>
-      <span className="min-w-0 flex-1 truncate text-right tabular-nums text-white/45">
+      <span
+        className="min-w-0 flex-1 truncate text-right tabular-nums text-white/45"
+        title={valueReadout(lane.group, values)}
+      >
         {valueReadout(lane.group, values)}
       </span>
       <VisibilityButton

From 4ac57a5845ae17362f3f01106c07af0a5d66b860 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 01:05:30 +0200
Subject: [PATCH 078/125] refactor(studio): split the track header's lane math
 out of its JSX

The header file owned value sampling, readout formatting, lane-state
resolution and the JSX at once, so a formatting change and a layout change
edited the same file. Sampling and formatting now live in
trackHeaderLaneValues, lane-state resolution in trackHeaderLaneState, and
resolveLaneHeaderState returns only the four fields its caller reads.

Also shows the track's clip count next to the track identity, which the
header promised but never rendered.
---
 .../player/components/LayerDisclosureRow.tsx  |   4 +
 .../components/TimelineTrackHeader.test.tsx   |  13 +
 .../player/components/TimelineTrackHeader.tsx | 249 ++----------------
 .../src/player/components/TrackClipCount.tsx  |  17 ++
 .../player/components/trackHeaderLaneState.ts | 121 +++++++++
 .../components/trackHeaderLaneValues.ts       | 110 ++++++++
 6 files changed, 287 insertions(+), 227 deletions(-)
 create mode 100644 packages/studio/src/player/components/TrackClipCount.tsx
 create mode 100644 packages/studio/src/player/components/trackHeaderLaneState.ts
 create mode 100644 packages/studio/src/player/components/trackHeaderLaneValues.ts

diff --git a/packages/studio/src/player/components/LayerDisclosureRow.tsx b/packages/studio/src/player/components/LayerDisclosureRow.tsx
index c061da300c..52e345b86a 100644
--- a/packages/studio/src/player/components/LayerDisclosureRow.tsx
+++ b/packages/studio/src/player/components/LayerDisclosureRow.tsx
@@ -1,16 +1,19 @@
 import { CaretRight } from "@phosphor-icons/react";
 import type { TimelineElement } from "../store/playerStore";
 import { LABEL_COL_W, TRACK_H } from "./timelineLayout";
+import { TrackClipCount } from "./TrackClipCount";
 
 // Layer row (Figma order: disclosure ▸/▾, diamond, name) — the disclosure lives
 // here, not on the clip bar, and re-expands a collapsed layer.
 export function LayerDisclosureRow({
   keyframeClip,
+  clipCount,
   isExpanded,
   gutterBackground,
   onToggleClipExpanded,
 }: {
   keyframeClip: TimelineElement;
+  clipCount: number;
   isExpanded: boolean;
   gutterBackground: string;
   onToggleClipExpanded: () => void;
@@ -53,6 +56,7 @@ export function LayerDisclosureRow({
       <span className="min-w-0 flex-1 truncate font-medium" title={name}>
         {name}
       </span>
+      <TrackClipCount clipCount={clipCount} />
     </div>
   );
 }
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
index 094b54a5f6..96feb17947 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
@@ -60,6 +60,7 @@ const OPACITY = animation("opacity-tween", "visual", [
 
 interface RenderHeaderOptions {
   animations?: GsapAnimation[];
+  clipCount?: number;
   currentTime?: number;
   expanded?: boolean;
   onSeek?: (time: number) => void;
@@ -82,6 +83,7 @@ function renderHeader(options: RenderHeaderOptions = {}): {
           trackLabel="Hero card"
           contentOrigin={LABEL_COL_W}
           keyframeClip={ELEMENT}
+          clipCount={next.clipCount ?? 1}
           isExpanded={next.expanded !== false}
           animations={next.animations ?? [POSITION, OPACITY]}
           currentTime={next.currentTime ?? 0}
@@ -109,6 +111,17 @@ function click(host: HTMLElement, label: string) {
 }
 
 describe("TimelineTrackHeader", () => {
+  // The header shows one clip's lanes, so how many clips the track holds is
+  // otherwise invisible from the label column. A single-clip track stays silent.
+  it("shows the track's clip count only once the track holds more than one clip", () => {
+    const view = renderHeader({ clipCount: 1 });
+    expect(view.host.querySelector('[aria-label="1 clips"]')).toBeNull();
+
+    view.rerender({ clipCount: 3 });
+    expect(view.host.querySelector('[aria-label="3 clips"]')?.textContent).toBe("3");
+    act(() => view.root.unmount());
+  });
+
   it("adds and removes a keyframe on the explicitly targeted property-group tween", () => {
     const onTogglePropertyGroupKeyframe = vi.fn();
     const view = renderHeader({ currentTime: 0.5, onTogglePropertyGroupKeyframe });
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index c0fac5b494..4ef4c5db47 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -1,30 +1,20 @@
 import { useState } from "react";
 import { Eye, EyeSlash } from "@phosphor-icons/react";
-import {
-  classifyPropertyGroup,
-  type GsapAnimation,
-  type PropertyGroupName,
-} from "@hyperframes/core/gsap-parser";
-import {
-  clipToTweenPercentage,
-  getKeyframeNavigationState,
-} from "../../components/editor/KeyframeNavigation";
+import type { GsapAnimation, PropertyGroupName } from "@hyperframes/core/gsap-parser";
 import { Music } from "../../icons/SystemIcons";
-import {
-  absoluteToPercentageForAnimation,
-  isTimeWithinTween,
-  resolveTweenDuration,
-  resolveTweenStart,
-} from "../../utils/globalTimeCompiler";
 import type { TimelineElement } from "../store/playerStore";
-import type {
-  TimelineEditCallbacks,
-  TimelinePropertyGroupKeyframeToggle,
-} from "./timelineCallbacks";
+import type { TimelineEditCallbacks } from "./timelineCallbacks";
 import { getTimelinePropertyLanes } from "./TimelinePropertyLanes";
 import { LayerDisclosureRow } from "./LayerDisclosureRow";
+import { TrackClipCount } from "./TrackClipCount";
 import { LABEL_COL_W, LANE_H, getTimelineLaneTop } from "./timelineLayout";
 import type { TimelineTheme } from "./timelineTheme";
+import {
+  resolveLaneHeaderState,
+  type KeyframeNavigationState,
+  type TimelinePropertyLane,
+} from "./trackHeaderLaneState";
+import { valueReadout } from "./trackHeaderLaneValues";
 
 interface TimelineTrackHeaderProps {
   trackNumber: number;
@@ -33,6 +23,8 @@ interface TimelineTrackHeaderProps {
   /** The track's active keyframe clip (selected, else primary) — the one whose
    *  disclosure + property rows this header shows, whether expanded or not. */
   keyframeClip: TimelineElement | null;
+  /** Clips on this track, so the header can say how many the row holds. */
+  clipCount: number;
   isExpanded: boolean;
   animations: readonly GsapAnimation[];
   currentTime: number;
@@ -47,104 +39,6 @@ interface TimelineTrackHeaderProps {
   onSeek?: (time: number) => void;
 }
 
-function roundValue(value: number): string {
-  return String(Math.round(value * 100) / 100);
-}
-
-function propertyValueAt(
-  animation: GsapAnimation,
-  property: string,
-  tweenPercentage: number,
-): number | string | undefined {
-  const keyframes = animation.keyframes?.keyframes ?? [];
-  const values = keyframes
-    .filter((keyframe) => property in keyframe.properties)
-    .map((keyframe) => ({
-      percentage: keyframe.percentage,
-      value: keyframe.properties[property],
-    }));
-  const before = values.filter((value) => value.percentage <= tweenPercentage).at(-1);
-  const after = values.find((value) => value.percentage >= tweenPercentage);
-  if (!before) return after?.value;
-  if (!after) return before.value;
-  if (
-    typeof before.value !== "number" ||
-    typeof after.value !== "number" ||
-    before.percentage === after.percentage
-  ) {
-    return before.value;
-  }
-  const progress = (tweenPercentage - before.percentage) / (after.percentage - before.percentage);
-  return before.value + (after.value - before.value) * progress;
-}
-
-function valuesAt(
-  animation: GsapAnimation,
-  group: PropertyGroupName,
-  tweenPercentage: number,
-): Record<string, number | string> {
-  const propertyNames = new Set<string>();
-  for (const keyframe of animation.keyframes?.keyframes ?? []) {
-    for (const property of Object.keys(keyframe.properties)) {
-      if (classifyPropertyGroup(property) === group) propertyNames.add(property);
-    }
-  }
-  const values: Record<string, number | string> = {};
-  for (const property of propertyNames) {
-    const value = propertyValueAt(animation, property, tweenPercentage);
-    if (value !== undefined) values[property] = value;
-  }
-  return values;
-}
-
-function groupLabel(group: PropertyGroupName, properties: Record<string, number | string>): string {
-  if (group === "visual" && ("opacity" in properties || "autoAlpha" in properties)) {
-    return "Opacity";
-  }
-  if (group !== "other") return `${group[0]?.toUpperCase() ?? ""}${group.slice(1)}`;
-  const property = Object.keys(properties)[0];
-  return property ? `${property[0]?.toUpperCase() ?? ""}${property.slice(1)}` : "Other";
-}
-
-type LaneValues = Record<string, number | string>;
-
-function defaultValueReadout(values: LaneValues): string {
-  return Object.values(values)
-    .map((value) => (typeof value === "number" ? roundValue(value) : value))
-    .join(", ");
-}
-
-function positionValueReadout(values: LaneValues): string | null {
-  const x = values.x;
-  const y = values.y;
-  return typeof x === "number" && typeof y === "number"
-    ? `${roundValue(x)}, ${roundValue(y)}`
-    : null;
-}
-
-function rotationValueReadout(values: LaneValues): string | null {
-  return typeof values.rotation === "number" ? `${roundValue(values.rotation)}°` : null;
-}
-
-function visualValueReadout(values: LaneValues): string | null {
-  const opacity = values.opacity ?? values.autoAlpha;
-  return typeof opacity === "number"
-    ? `${roundValue(Math.abs(opacity) <= 1 ? opacity * 100 : opacity)}%`
-    : null;
-}
-
-const GROUP_VALUE_READOUTS: Partial<
-  Record<PropertyGroupName, (values: LaneValues) => string | null>
-> = {
-  position: positionValueReadout,
-  rotation: rotationValueReadout,
-  visual: visualValueReadout,
-};
-
-function valueReadout(group: PropertyGroupName, values: Record<string, number | string>): string {
-  return GROUP_VALUE_READOUTS[group]?.(values) ?? defaultValueReadout(values);
-}
-
 function VisibilityButton({
   hidden,
   trackNumber,
@@ -184,13 +78,19 @@ function VisibilityButton({
 function LegacyTrackHeader({
   trackNumber,
   trackLabel,
+  clipCount,
   showTrackLabel,
   isTrackHidden,
   isAudioTrack,
   onToggleTrackHidden,
 }: Pick<
   TimelineTrackHeaderProps,
-  "trackNumber" | "trackLabel" | "isTrackHidden" | "isAudioTrack" | "onToggleTrackHidden"
+  | "trackNumber"
+  | "trackLabel"
+  | "clipCount"
+  | "isTrackHidden"
+  | "isAudioTrack"
+  | "onToggleTrackHidden"
 > & { showTrackLabel: boolean }) {
   return (
     <>
@@ -202,6 +102,7 @@ function LegacyTrackHeader({
           {trackLabel}
         </span>
       )}
+      {showTrackLabel && <TrackClipCount clipCount={clipCount} />}
       <VisibilityButton
         hidden={isTrackHidden}
         trackNumber={trackNumber}
@@ -212,115 +113,6 @@ function LegacyTrackHeader({
   );
 }
 
-type TimelinePropertyLane = ReturnType<typeof getTimelinePropertyLanes>[number];
-type KeyframeNavigationState = ReturnType<
-  typeof getKeyframeNavigationState<TimelinePropertyLane["keyframes"][number]>
->;
-
-function findNearestLaneKeyframe(lane: TimelinePropertyLane, clipPercentage: number) {
-  return lane.keyframes.reduce<(typeof lane.keyframes)[number] | null>(
-    (nearest, keyframe) =>
-      !nearest ||
-      Math.abs(keyframe.percentage - clipPercentage) < Math.abs(nearest.percentage - clipPercentage)
-        ? keyframe
-        : nearest,
-    null,
-  );
-}
-
-function findAnimationAtTime(animations: TimelinePropertyLane["animations"], currentTime: number) {
-  return animations.find((candidate) => {
-    const start = resolveTweenStart(candidate);
-    return start !== null && isTimeWithinTween(currentTime, start, resolveTweenDuration(candidate));
-  });
-}
-
-function resolveLaneAnimation(
-  lane: TimelinePropertyLane,
-  navigation: KeyframeNavigationState,
-  nearestKeyframe: TimelinePropertyLane["keyframes"][number] | null,
-  animationAtPlayhead: GsapAnimation | undefined,
-) {
-  const animationId = navigation.currentKeyframe?.animationId ?? nearestKeyframe?.animationId;
-  return animationAtPlayhead ?? lane.animations.find((candidate) => candidate.id === animationId);
-}
-
-function resolveLaneTweenPercentage(
-  navigation: KeyframeNavigationState,
-  animation: GsapAnimation | undefined,
-  animationKeyframes: TimelinePropertyLane["keyframes"],
-  currentTime: number,
-  clipPercentage: number,
-) {
-  return (
-    navigation.currentKeyframe?.tweenPercentage ??
-    (animation ? absoluteToPercentageForAnimation(currentTime, animation) : null) ??
-    clipToTweenPercentage(animationKeyframes, clipPercentage)
-  );
-}
-
-function valuesForLaneAnimation(
-  animation: GsapAnimation | undefined,
-  lane: TimelinePropertyLane,
-  tweenPercentage: number,
-) {
-  return animation ? valuesAt(animation, lane.group, tweenPercentage) : {};
-}
-
-function createLaneToggleTarget(
-  animation: GsapAnimation | undefined,
-  lane: TimelinePropertyLane,
-  tweenPercentage: number,
-  values: LaneValues,
-  navigation: KeyframeNavigationState,
-): TimelinePropertyGroupKeyframeToggle | null {
-  return animation
-    ? {
-        animationId: animation.id,
-        propertyGroup: lane.group,
-        tweenPercentage,
-        properties: values,
-        remove: navigation.currentKeyframe !== null,
-      }
-    : null;
-}
-
-function resolveLaneHeaderState(
-  lane: TimelinePropertyLane,
-  currentTime: number,
-  clipPercentage: number,
-) {
-  const navigation = getKeyframeNavigationState(lane.keyframes, clipPercentage);
-  const nearestKeyframe = findNearestLaneKeyframe(lane, clipPercentage);
-  const animationAtPlayhead = findAnimationAtTime(lane.animations, currentTime);
-  const animation = resolveLaneAnimation(lane, navigation, nearestKeyframe, animationAtPlayhead);
-  const animationKeyframes = lane.keyframes.filter(
-    (keyframe) => keyframe.animationId === animation?.id,
-  );
-  const tweenPercentage = resolveLaneTweenPercentage(
-    navigation,
-    animation,
-    animationKeyframes,
-    currentTime,
-    clipPercentage,
-  );
-  const values = valuesForLaneAnimation(animation, lane, tweenPercentage);
-  const label = groupLabel(lane.group, values);
-  const toggleTarget = createLaneToggleTarget(animation, lane, tweenPercentage, values, navigation);
-
-  return {
-    navigation,
-    nearestKeyframe,
-    animationAtPlayhead,
-    animation,
-    animationKeyframes,
-    tweenPercentage,
-    values,
-    label,
-    toggleTarget,
-  };
-}
-
 // Figma layout: prev-keyframe ‹, the add/remove toggle (children), next ›.
 function PropertyGroupNavigation({
   navigation,
@@ -484,6 +276,7 @@ export function TimelineTrackHeader({
   trackLabel,
   contentOrigin,
   keyframeClip,
+  clipCount,
   isExpanded,
   animations,
   currentTime,
@@ -528,6 +321,7 @@ export function TimelineTrackHeader({
         <LegacyTrackHeader
           trackNumber={trackNumber}
           trackLabel={trackLabel}
+          clipCount={clipCount}
           showTrackLabel={showTrackLabel}
           isTrackHidden={isTrackHidden}
           isAudioTrack={isAudioTrack}
@@ -537,6 +331,7 @@ export function TimelineTrackHeader({
         <>
           <LayerDisclosureRow
             keyframeClip={keyframeClip}
+            clipCount={clipCount}
             isExpanded={isExpanded}
             gutterBackground={theme.gutterBackground}
             onToggleClipExpanded={onToggleClipExpanded}
diff --git a/packages/studio/src/player/components/TrackClipCount.tsx b/packages/studio/src/player/components/TrackClipCount.tsx
new file mode 100644
index 0000000000..aef7229f9b
--- /dev/null
+++ b/packages/studio/src/player/components/TrackClipCount.tsx
@@ -0,0 +1,17 @@
+/**
+ * How many clips the track holds, shown next to the track's identity so a
+ * multi-clip track reads as one at a glance. A single-clip track shows nothing:
+ * the clip bar already says "one", and the header stays low-density.
+ */
+export function TrackClipCount({ clipCount }: { clipCount: number }) {
+  if (clipCount < 2) return null;
+  return (
+    <span
+      aria-label={`${clipCount} clips`}
+      title={`${clipCount} clips`}
+      className="shrink-0 rounded-full bg-white/10 px-1 text-[9px] leading-[14px] tabular-nums text-white/55"
+    >
+      {clipCount}
+    </span>
+  );
+}
diff --git a/packages/studio/src/player/components/trackHeaderLaneState.ts b/packages/studio/src/player/components/trackHeaderLaneState.ts
new file mode 100644
index 0000000000..b86a4f94f8
--- /dev/null
+++ b/packages/studio/src/player/components/trackHeaderLaneState.ts
@@ -0,0 +1,121 @@
+/**
+ * Resolves what a property lane's header row shows at the current playhead:
+ * which animation owns the lane right now, where the playhead sits inside it,
+ * the sampled values, and the add/remove keyframe target. Pure state, no JSX, so
+ * the header component only renders what this returns.
+ */
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import {
+  clipToTweenPercentage,
+  getKeyframeNavigationState,
+} from "../../components/editor/KeyframeNavigation";
+import {
+  absoluteToPercentageForAnimation,
+  isTimeWithinTween,
+  resolveTweenDuration,
+  resolveTweenStart,
+} from "../../utils/globalTimeCompiler";
+import type { TimelinePropertyGroupKeyframeToggle } from "./timelineCallbacks";
+import { getTimelinePropertyLanes } from "./TimelinePropertyLanes";
+import { groupLabel, valuesAt, type LaneValues } from "./trackHeaderLaneValues";
+
+export type TimelinePropertyLane = ReturnType<typeof getTimelinePropertyLanes>[number];
+export type KeyframeNavigationState = ReturnType<
+  typeof getKeyframeNavigationState<TimelinePropertyLane["keyframes"][number]>
+>;
+
+function findNearestLaneKeyframe(lane: TimelinePropertyLane, clipPercentage: number) {
+  return lane.keyframes.reduce<(typeof lane.keyframes)[number] | null>(
+    (nearest, keyframe) =>
+      !nearest ||
+      Math.abs(keyframe.percentage - clipPercentage) < Math.abs(nearest.percentage - clipPercentage)
+        ? keyframe
+        : nearest,
+    null,
+  );
+}
+
+function findAnimationAtTime(animations: TimelinePropertyLane["animations"], currentTime: number) {
+  return animations.find((candidate) => {
+    const start = resolveTweenStart(candidate);
+    return start !== null && isTimeWithinTween(currentTime, start, resolveTweenDuration(candidate));
+  });
+}
+
+function resolveLaneAnimation(
+  lane: TimelinePropertyLane,
+  navigation: KeyframeNavigationState,
+  nearestKeyframe: TimelinePropertyLane["keyframes"][number] | null,
+  animationAtPlayhead: GsapAnimation | undefined,
+) {
+  const animationId = navigation.currentKeyframe?.animationId ?? nearestKeyframe?.animationId;
+  return animationAtPlayhead ?? lane.animations.find((candidate) => candidate.id === animationId);
+}
+
+function resolveLaneTweenPercentage(
+  navigation: KeyframeNavigationState,
+  animation: GsapAnimation | undefined,
+  animationKeyframes: TimelinePropertyLane["keyframes"],
+  currentTime: number,
+  clipPercentage: number,
+) {
+  return (
+    navigation.currentKeyframe?.tweenPercentage ??
+    (animation ? absoluteToPercentageForAnimation(currentTime, animation) : null) ??
+    clipToTweenPercentage(animationKeyframes, clipPercentage)
+  );
+}
+
+function createLaneToggleTarget(
+  animation: GsapAnimation | undefined,
+  lane: TimelinePropertyLane,
+  tweenPercentage: number,
+  values: LaneValues,
+  navigation: KeyframeNavigationState,
+): TimelinePropertyGroupKeyframeToggle | null {
+  return animation
+    ? {
+        animationId: animation.id,
+        propertyGroup: lane.group,
+        tweenPercentage,
+        properties: values,
+        remove: navigation.currentKeyframe !== null,
+      }
+    : null;
+}
+
+export interface LaneHeaderState {
+  navigation: KeyframeNavigationState;
+  values: LaneValues;
+  label: string;
+  toggleTarget: TimelinePropertyGroupKeyframeToggle | null;
+}
+
+export function resolveLaneHeaderState(
+  lane: TimelinePropertyLane,
+  currentTime: number,
+  clipPercentage: number,
+): LaneHeaderState {
+  const navigation = getKeyframeNavigationState(lane.keyframes, clipPercentage);
+  const nearestKeyframe = findNearestLaneKeyframe(lane, clipPercentage);
+  const animationAtPlayhead = findAnimationAtTime(lane.animations, currentTime);
+  const animation = resolveLaneAnimation(lane, navigation, nearestKeyframe, animationAtPlayhead);
+  const animationKeyframes = lane.keyframes.filter(
+    (keyframe) => keyframe.animationId === animation?.id,
+  );
+  const tweenPercentage = resolveLaneTweenPercentage(
+    navigation,
+    animation,
+    animationKeyframes,
+    currentTime,
+    clipPercentage,
+  );
+  const values = animation ? valuesAt(animation, lane.group, tweenPercentage) : {};
+
+  return {
+    navigation,
+    values,
+    label: groupLabel(lane.group, values),
+    toggleTarget: createLaneToggleTarget(animation, lane, tweenPercentage, values, navigation),
+  };
+}
diff --git a/packages/studio/src/player/components/trackHeaderLaneValues.ts b/packages/studio/src/player/components/trackHeaderLaneValues.ts
new file mode 100644
index 0000000000..180a29b63e
--- /dev/null
+++ b/packages/studio/src/player/components/trackHeaderLaneValues.ts
@@ -0,0 +1,110 @@
+/**
+ * Sampling and formatting for the property-lane readouts in the track header:
+ * what value a property holds at a given tween percentage, and how that value
+ * reads to a human. Kept apart from the header's JSX so a formatting change and
+ * a layout change never touch the same file.
+ */
+import {
+  classifyPropertyGroup,
+  type GsapAnimation,
+  type PropertyGroupName,
+} from "@hyperframes/core/gsap-parser";
+
+export type LaneValues = Record<string, number | string>;
+
+function roundValue(value: number): string {
+  return String(Math.round(value * 100) / 100);
+}
+
+function propertyValueAt(
+  animation: GsapAnimation,
+  property: string,
+  tweenPercentage: number,
+): number | string | undefined {
+  const keyframes = animation.keyframes?.keyframes ?? [];
+  const values = keyframes
+    .filter((keyframe) => property in keyframe.properties)
+    .map((keyframe) => ({
+      percentage: keyframe.percentage,
+      value: keyframe.properties[property],
+    }));
+  const before = values.filter((value) => value.percentage <= tweenPercentage).at(-1);
+  const after = values.find((value) => value.percentage >= tweenPercentage);
+  if (!before) return after?.value;
+  if (!after) return before.value;
+  if (
+    typeof before.value !== "number" ||
+    typeof after.value !== "number" ||
+    before.percentage === after.percentage
+  ) {
+    return before.value;
+  }
+  const progress = (tweenPercentage - before.percentage) / (after.percentage - before.percentage);
+  return before.value + (after.value - before.value) * progress;
+}
+
+/** Every property of `group` this animation touches, sampled at `tweenPercentage`. */
+export function valuesAt(
+  animation: GsapAnimation,
+  group: PropertyGroupName,
+  tweenPercentage: number,
+): LaneValues {
+  const propertyNames = new Set<string>();
+  for (const keyframe of animation.keyframes?.keyframes ?? []) {
+    for (const property of Object.keys(keyframe.properties)) {
+      if (classifyPropertyGroup(property) === group) propertyNames.add(property);
+    }
+  }
+  const values: LaneValues = {};
+  for (const property of propertyNames) {
+    const value = propertyValueAt(animation, property, tweenPercentage);
+    if (value !== undefined) values[property] = value;
+  }
+  return values;
+}
+
+export function groupLabel(group: PropertyGroupName, properties: LaneValues): string {
+  if (group === "visual" && ("opacity" in properties || "autoAlpha" in properties)) {
+    return "Opacity";
+  }
+  if (group !== "other") return `${group[0]?.toUpperCase() ?? ""}${group.slice(1)}`;
+  const property = Object.keys(properties)[0];
+  return property ? `${property[0]?.toUpperCase() ?? ""}${property.slice(1)}` : "Other";
+}
+
+function defaultValueReadout(values: LaneValues): string {
+  return Object.values(values)
+    .map((value) => (typeof value === "number" ? roundValue(value) : value))
+    .join(", ");
+}
+
+function positionValueReadout(values: LaneValues): string | null {
+  const x = values.x;
+  const y = values.y;
+  return typeof x === "number" && typeof y === "number"
+    ? `${roundValue(x)}, ${roundValue(y)}`
+    : null;
+}
+
+function rotationValueReadout(values: LaneValues): string | null {
+  return typeof values.rotation === "number" ? `${roundValue(values.rotation)}°` : null;
+}
+
+function visualValueReadout(values: LaneValues): string | null {
+  const opacity = values.opacity ?? values.autoAlpha;
+  return typeof opacity === "number"
+    ? `${roundValue(Math.abs(opacity) <= 1 ? opacity * 100 : opacity)}%`
+    : null;
+}
+
+const GROUP_VALUE_READOUTS: Partial<
+  Record<PropertyGroupName, (values: LaneValues) => string | null>
+> = {
+  position: positionValueReadout,
+  rotation: rotationValueReadout,
+  visual: visualValueReadout,
+};
+
+export function valueReadout(group: PropertyGroupName, values: LaneValues): string {
+  return GROUP_VALUE_READOUTS[group]?.(values) ?? defaultValueReadout(values);
+}

From f3ab4469e79a57060ae6639bc5401e8f41a79b52 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 01:08:48 +0200
Subject: [PATCH 079/125] refactor(studio): name the non-keyframe header for
 what it is

LegacyTrackHeader reads as deprecated code. It is the live path for every
track that has no keyframe clip to disclose, so call it PlainTrackHeader and
say so in a comment.
---
 .../studio/src/player/components/TimelineTrackHeader.tsx    | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index 4ef4c5db47..cc441cc74a 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -75,7 +75,9 @@ function VisibilityButton({
   );
 }
 
-function LegacyTrackHeader({
+// The header a track gets when it has no keyframe clip to disclose: label, clip
+// count, eye. Not deprecated — it is the live path for every track without lanes.
+function PlainTrackHeader({
   trackNumber,
   trackLabel,
   clipCount,
@@ -318,7 +320,7 @@ export function TimelineTrackHeader({
       }}
     >
       {!keyframeClip || lanes.length === 0 ? (
-        <LegacyTrackHeader
+        <PlainTrackHeader
           trackNumber={trackNumber}
           trackLabel={trackLabel}
           clipCount={clipCount}

From 555d7f7a5ce78a057d396564488aebaf0792827f Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 02:18:34 +0200
Subject: [PATCH 080/125] refactor(studio): drop the dead expandedElement guard

toggleTarget is derived from expandedElement, so it can only be set when
expandedElement is. The extra check read as if the two could disagree.
---
 packages/studio/src/player/components/TimelineTrackHeader.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index cc441cc74a..7364fb7c61 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -249,7 +249,7 @@ function PropertyGroupHeaderRow({
             // Same as the disclosure caret and the eye: a control in the label
             // column owns its click, it does not also hit the track row behind it.
             event.stopPropagation();
-            if (expandedElement && toggleTarget) {
+            if (toggleTarget) {
               void onTogglePropertyGroupKeyframe?.(expandedElement, toggleTarget);
             }
           }}

From 2d1b905a56c55286c3ab76b3271c277517cec496 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 16:53:29 +0200
Subject: [PATCH 081/125] feat(studio): consolidate timeline editor callbacks

---
 packages/studio/src/App.tsx                   |   1 +
 .../src/components/editor/AnimationCard.tsx   |  26 +-
 .../editor/GsapAddAnimationControl.tsx        |  68 ++++
 .../editor/GsapAnimationSection.tsx           | 175 ++--------
 .../components/editor/PropertyPanelFlat.tsx   |  67 ++--
 .../editor/gsapAnimationCallbacks.test.ts     | 122 +++++++
 .../editor/gsapAnimationCallbacks.ts          | 102 +++++-
 .../editor/propertyPanelFlatMotionSection.tsx | 164 ++--------
 .../nle/useTimelineEditCallbacks.test.ts      |  30 ++
 .../nle/useTimelineEditCallbacks.test.tsx     | 306 ++++++++++++++++++
 .../nle/useTimelineEditCallbacks.ts           | 129 +++++++-
 .../src/contexts/TimelineEditContext.tsx      |   1 +
 .../src/hooks/useStudioContextValue.test.ts   |  93 ++++++
 .../studio/src/hooks/useStudioContextValue.ts |  17 +-
 14 files changed, 959 insertions(+), 342 deletions(-)
 create mode 100644 packages/studio/src/components/editor/GsapAddAnimationControl.tsx
 create mode 100644 packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
 create mode 100644 packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
 create mode 100644 packages/studio/src/hooks/useStudioContextValue.test.ts

diff --git a/packages/studio/src/App.tsx b/packages/studio/src/App.tsx
index eff75a40ea..b661872d67 100644
--- a/packages/studio/src/App.tsx
+++ b/packages/studio/src/App.tsx
@@ -401,6 +401,7 @@ export function StudioApp() {
     panelLayout.rightInspectorPanes,
     panelLayout.rightCollapsed,
     isPlaying,
+    domEditSession.domEditSelection,
     gestureState === "recording",
   );
   useStudioUrlState({
diff --git a/packages/studio/src/components/editor/AnimationCard.tsx b/packages/studio/src/components/editor/AnimationCard.tsx
index 214d5b013d..0f071d3016 100644
--- a/packages/studio/src/components/editor/AnimationCard.tsx
+++ b/packages/studio/src/components/editor/AnimationCard.tsx
@@ -1,4 +1,4 @@
-import { memo, useCallback, useMemo, useState } from "react";
+import { memo, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { SUPPORTED_EASES, SUPPORTED_PROPS } from "@hyperframes/core/gsap-constants";
 import { trackStudioSegmentEaseEdit } from "../../telemetry/events";
@@ -23,6 +23,8 @@ interface AnimationCardProps extends GsapAnimationEditCallbacks {
   animation: GsapAnimation;
   defaultExpanded: boolean;
   flat?: boolean;
+  focusedSegment?: { tweenPercentage: number } | null;
+  onFocusSegmentConsumed?: () => void;
 }
 
 // fallow-ignore-next-line complexity
@@ -30,6 +32,8 @@ export const AnimationCard = memo(function AnimationCard({
   animation,
   defaultExpanded,
   flat,
+  focusedSegment,
+  onFocusSegmentConsumed,
   onUpdateProperty,
   onUpdateMeta,
   onDeleteAnimation,
@@ -50,6 +54,25 @@ export const AnimationCard = memo(function AnimationCard({
   const [addingProp, setAddingProp] = useState(false);
   const [addingFromProp, setAddingFromProp] = useState(false);
   const [expandedKfPct, setExpandedKfPct] = useState<number | null>(null);
+  const cardRef = useRef<HTMLDivElement>(null);
+  const pendingAutoScrollRef = useRef(false);
+
+  useEffect(() => {
+    if (!focusedSegment) return;
+    setExpanded(true);
+    pendingAutoScrollRef.current = true;
+    setExpandedKfPct(focusedSegment.tweenPercentage);
+    onFocusSegmentConsumed?.();
+  }, [focusedSegment, onFocusSegmentConsumed]);
+
+  useEffect(() => {
+    if (!pendingAutoScrollRef.current || expandedKfPct === null) return;
+    const segment = cardRef.current?.querySelector<HTMLElement>(
+      `[data-ease-segment-pct="${expandedKfPct}"]`,
+    );
+    segment?.scrollIntoView({ block: "nearest", behavior: "smooth" });
+    pendingAutoScrollRef.current = false;
+  }, [expandedKfPct]);
 
   const usedProps = useMemo(
     () => new Set(Object.keys(animation.properties)),
@@ -154,6 +177,7 @@ export const AnimationCard = memo(function AnimationCard({
 
   return (
     <div
+      ref={cardRef}
       data-flat-effect-card={flat ? "true" : undefined}
       className={
         flat
diff --git a/packages/studio/src/components/editor/GsapAddAnimationControl.tsx b/packages/studio/src/components/editor/GsapAddAnimationControl.tsx
new file mode 100644
index 0000000000..8447adba8f
--- /dev/null
+++ b/packages/studio/src/components/editor/GsapAddAnimationControl.tsx
@@ -0,0 +1,68 @@
+import { ADD_METHODS, ADD_METHOD_LABELS, METHOD_TOOLTIPS } from "./gsapAnimationConstants";
+
+const STYLES = {
+  classic: {
+    method:
+      "rounded-lg border border-neutral-700 bg-neutral-900 px-2.5 py-1.5 text-[11px] font-medium text-neutral-300 transition-colors hover:border-neutral-600 hover:text-white",
+    cancel: "px-1.5 text-[11px] text-neutral-500 hover:text-neutral-300",
+    trigger: "text-[11px] font-medium text-neutral-400 transition-colors hover:text-neutral-200",
+  },
+  flat: {
+    method:
+      "rounded-lg border border-panel-border-input bg-panel-input px-2.5 py-1.5 text-[11px] font-medium text-panel-text-2 transition-colors hover:border-panel-text-4 hover:text-panel-text-0",
+    cancel: "px-1.5 text-[11px] text-panel-text-3 hover:text-panel-text-1",
+    trigger: "text-[11px] font-medium text-panel-text-3 transition-colors hover:text-panel-text-1",
+  },
+};
+
+export function GsapAddAnimationControl({
+  open,
+  setOpen,
+  onAddAnimation,
+  track,
+  variant,
+}: {
+  open: boolean;
+  setOpen: (open: boolean) => void;
+  onAddAnimation: (method: "to" | "from" | "set" | "fromTo") => void;
+  track: (control: string, name: string) => void;
+  variant: keyof typeof STYLES;
+}) {
+  const styles = STYLES[variant];
+
+  return (
+    <div className="relative pt-1">
+      {open ? (
+        <div className="flex gap-1.5">
+          {ADD_METHODS.map((method) => (
+            <button
+              key={method}
+              type="button"
+              title={METHOD_TOOLTIPS[method]}
+              onClick={() => {
+                track("button", `Add ${method} animation`);
+                onAddAnimation(method);
+                setOpen(false);
+              }}
+              className={styles.method}
+            >
+              {ADD_METHOD_LABELS[method] ?? method}
+            </button>
+          ))}
+          <button type="button" onClick={() => setOpen(false)} className={styles.cancel}>
+            Cancel
+          </button>
+        </div>
+      ) : (
+        <button
+          type="button"
+          onClick={() => setOpen(true)}
+          className={styles.trigger}
+          title="Add a new animation effect to this element"
+        >
+          + Add effect
+        </button>
+      )}
+    </div>
+  );
+}
diff --git a/packages/studio/src/components/editor/GsapAnimationSection.tsx b/packages/studio/src/components/editor/GsapAnimationSection.tsx
index 33f6201b2f..1fac3972e9 100644
--- a/packages/studio/src/components/editor/GsapAnimationSection.tsx
+++ b/packages/studio/src/components/editor/GsapAnimationSection.tsx
@@ -2,13 +2,14 @@ import { memo, useState } from "react";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { Film } from "../../icons/SystemIcons";
 import { Section } from "./propertyPanelPrimitives";
-import { ADD_METHODS, ADD_METHOD_LABELS, METHOD_TOOLTIPS } from "./gsapAnimationConstants";
 import { AnimationCard } from "./AnimationCard";
 import {
-  trackAnimationMetaUpdate,
   type GsapAnimationEditCallbacks,
+  withTrackedGsapAnimationCallbacks,
 } from "./gsapAnimationCallbacks";
 import { useTrackDesignInput } from "../../contexts/DesignPanelInputContext";
+import { usePlayerStore } from "../../player";
+import { GsapAddAnimationControl } from "./GsapAddAnimationControl";
 
 interface GsapAnimationSectionProps extends GsapAnimationEditCallbacks {
   animations: GsapAnimation[];
@@ -21,41 +22,14 @@ export const GsapAnimationSection = memo(function GsapAnimationSection({
   animations,
   multipleTimelines,
   unsupportedTimelinePattern,
-  onUpdateProperty,
-  onUpdateMeta,
-  onDeleteAnimation,
-  onAddProperty,
-  onRemoveProperty,
-  onUpdateFromProperty,
-  onAddFromProperty,
-  onRemoveFromProperty,
   onAddAnimation,
-  onLivePreview,
-  onLivePreviewEnd,
-  onSetArcPath,
-  onUpdateArcSegment,
-  onUpdateKeyframeEase,
-  onSetAllKeyframeEases,
-  onUnroll,
+  ...callbacks
 }: GsapAnimationSectionProps) {
   const track = useTrackDesignInput();
   const [addMenuOpen, setAddMenuOpen] = useState(false);
-  const trackProperty = (property: string) => {
-    const control =
-      property === "visibility"
-        ? "toggle"
-        : property === "filter" || property === "clipPath"
-          ? "text"
-          : "metric";
-    track(control, property);
-  };
-  const updateMeta = (
-    animationId: string,
-    updates: { duration?: number; ease?: string; position?: number },
-  ) => {
-    trackAnimationMetaUpdate(track, updates);
-    onUpdateMeta(animationId, updates);
-  };
+  const trackedCallbacks = withTrackedGsapAnimationCallbacks(callbacks, track);
+  const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
+  const setFocusedEaseSegment = usePlayerStore((s) => s.setFocusedEaseSegment);
 
   return (
     <Section title="Animation" icon={<Film size={15} />}>
@@ -76,137 +50,24 @@ export const GsapAnimationSection = memo(function GsapAnimationSection({
         <div className="space-y-2">
           {animations.map((anim, index) => (
             <AnimationCard
+              {...trackedCallbacks}
               key={anim.id}
               animation={anim}
               defaultExpanded={index === 0}
-              onUpdateProperty={(animationId, property, value) => {
-                trackProperty(property);
-                onUpdateProperty(animationId, property, value);
-              }}
-              onUpdateMeta={updateMeta}
-              onDeleteAnimation={(animationId) => {
-                track("button", "Remove animation");
-                onDeleteAnimation(animationId);
-              }}
-              onAddProperty={(animationId, property) => {
-                track("select", "Add effect property");
-                onAddProperty(animationId, property);
-              }}
-              onRemoveProperty={(animationId, property) => {
-                track("button", `Remove ${property}`);
-                onRemoveProperty(animationId, property);
-              }}
-              onUpdateFromProperty={
-                onUpdateFromProperty
-                  ? (animationId, property, value) => {
-                      trackProperty(property);
-                      onUpdateFromProperty(animationId, property, value);
-                    }
-                  : undefined
-              }
-              onAddFromProperty={
-                onAddFromProperty
-                  ? (animationId, property) => {
-                      track("select", "Add from property");
-                      onAddFromProperty(animationId, property);
-                    }
-                  : undefined
-              }
-              onRemoveFromProperty={
-                onRemoveFromProperty
-                  ? (animationId, property) => {
-                      track("button", `Remove from ${property}`);
-                      onRemoveFromProperty(animationId, property);
-                    }
-                  : undefined
-              }
-              onLivePreview={onLivePreview}
-              onLivePreviewEnd={onLivePreviewEnd}
-              onSetArcPath={
-                onSetArcPath
-                  ? (animationId, config) => {
-                      track(
-                        "toggle",
-                        config.autoRotate !== undefined ? "Auto rotate" : "Arc motion",
-                      );
-                      onSetArcPath(animationId, config);
-                    }
-                  : undefined
-              }
-              onUpdateArcSegment={
-                onUpdateArcSegment
-                  ? (animationId, segmentIndex, update) => {
-                      if (update.curviness === undefined) {
-                        track("button", `Reset arc segment ${segmentIndex + 1}`);
-                      }
-                      onUpdateArcSegment(animationId, segmentIndex, update);
-                    }
-                  : undefined
-              }
-              onUpdateKeyframeEase={
-                onUpdateKeyframeEase
-                  ? (animationId, percentage, ease) => {
-                      track("select", "Keyframe ease");
-                      onUpdateKeyframeEase(animationId, percentage, ease);
-                    }
-                  : undefined
-              }
-              onSetAllKeyframeEases={
-                onSetAllKeyframeEases
-                  ? (animationId, ease) => {
-                      track("select", "All keyframe eases");
-                      onSetAllKeyframeEases(animationId, ease);
-                    }
-                  : undefined
-              }
-              onUnroll={
-                onUnroll
-                  ? (animationId) => {
-                      track("button", "Unroll animation");
-                      onUnroll(animationId);
-                    }
-                  : undefined
+              focusedSegment={
+                focusedEaseSegment?.animationId === anim.id ? focusedEaseSegment : null
               }
+              onFocusSegmentConsumed={() => setFocusedEaseSegment(null)}
             />
           ))}
 
-          <div className="relative pt-1">
-            {addMenuOpen ? (
-              <div className="flex gap-1.5">
-                {ADD_METHODS.map((method) => (
-                  <button
-                    key={method}
-                    type="button"
-                    title={METHOD_TOOLTIPS[method]}
-                    onClick={() => {
-                      track("button", `Add ${method} animation`);
-                      onAddAnimation(method);
-                      setAddMenuOpen(false);
-                    }}
-                    className="rounded-lg border border-neutral-700 bg-neutral-900 px-2.5 py-1.5 text-[11px] font-medium text-neutral-300 transition-colors hover:border-neutral-600 hover:text-white"
-                  >
-                    {ADD_METHOD_LABELS[method] ?? method}
-                  </button>
-                ))}
-                <button
-                  type="button"
-                  onClick={() => setAddMenuOpen(false)}
-                  className="px-1.5 text-[11px] text-neutral-500 hover:text-neutral-300"
-                >
-                  Cancel
-                </button>
-              </div>
-            ) : (
-              <button
-                type="button"
-                onClick={() => setAddMenuOpen(true)}
-                className="text-[11px] font-medium text-neutral-400 transition-colors hover:text-neutral-200"
-                title="Add a new animation effect to this element"
-              >
-                + Add effect
-              </button>
-            )}
-          </div>
+          <GsapAddAnimationControl
+            open={addMenuOpen}
+            setOpen={setAddMenuOpen}
+            onAddAnimation={onAddAnimation}
+            track={track}
+            variant="classic"
+          />
         </div>
       )}
     </Section>
diff --git a/packages/studio/src/components/editor/PropertyPanelFlat.tsx b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
index ef1393a60d..86900c1261 100644
--- a/packages/studio/src/components/editor/PropertyPanelFlat.tsx
+++ b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
@@ -19,6 +19,7 @@ import { createGsapLivePreview } from "./gsapLivePreview";
 import { formatTextFieldPreview } from "./propertyPanelSections";
 import { STUDIO_GSAP_PANEL_ENABLED } from "./manualEditingAvailability";
 import { useColorGradingController } from "./useColorGradingController";
+import { usePlayerStore } from "../../player";
 import {
   FlatColorGradingAccessory,
   FlatColorGradingSection,
@@ -231,7 +232,36 @@ export function PropertyPanelFlat({
           : "layout",
   );
 
-  // Animate only the groups that changed during this toggle cycle.
+  // Tracks which group(s) are actively transitioning this toggle cycle, so
+  // their header/body gets the fast entrance animation (hf-flat-group-enter)
+  // and no one else's does. Deliberately NOT derived from remounting alone:
+  // FlatGroupHeader instances are keyed by group id and React normally
+  // preserves them across re-renders, but toggling a non-adjacent group still
+  // shifts the untouched collapsed siblings between the before/after-open
+  // slices below, and Chromium restarts a CSS animation on that kind of
+  // position shift even though nothing about the sibling actually changed.
+  // Gating on these ids (cleared shortly after the 120ms CSS animation
+  // finishes) keeps the animation scoped to only the groups that actually
+  // just toggled. Two ids, not one: the clicked (newly-opening/closing) group
+  // AND whichever group was open immediately before the click and got
+  // implicitly closed by it — both freshly-mounted headers need to animate.
+  // When the inline timeline ease button focuses a segment on this element,
+  // force the Motion group open so its AnimationCard (which only mounts while
+  // the group is expanded) can consume the focus and reveal the ease editor.
+  const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
+  // Identity of the element THIS panel actually renders (not the store's
+  // selectedElementId, which flips synchronously on selection while the panel
+  // still renders the previous element during async DOM-selection resolution):
+  // a stale panel would otherwise consume a focus request meant for its
+  // successor when both share a class-selector animation id.
+  const renderedElementId = `${element.sourceFile}#${element.id}`;
+  useEffect(() => {
+    if (!focusedEaseSegment || focusedEaseSegment.elementId !== renderedElementId) return;
+    if (gsapAnimations.some((a) => a.id === focusedEaseSegment.animationId)) {
+      setOpenGroupId("motion");
+    }
+  }, [focusedEaseSegment, gsapAnimations, renderedElementId]);
+
   const [justToggledIds, setJustToggledIds] = useState<string[]>([]);
   const justToggledTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const panelBodyRef = useRef<HTMLDivElement>(null);
@@ -492,6 +522,17 @@ export function PropertyPanelFlat({
   const beforeOpen = openIndex === -1 ? groups : groups.slice(0, openIndex);
   const openGroup = openIndex === -1 ? null : groups[openIndex];
   const afterOpen = openIndex === -1 ? [] : groups.slice(openIndex + 1);
+  const renderClosedGroup = (group: FlatGroupDescriptor) => (
+    <DesignPanelInputProvider key={group.id} section={slugifyDesignInput(group.title)}>
+      <FlatGroupHeader
+        title={group.title}
+        isOpen={false}
+        onToggleOpen={() => toggleOpen(group.id)}
+        summary={group.summary}
+        animateEntrance={justToggledIds.includes(group.id)}
+      />
+    </DesignPanelInputProvider>
+  );
 
   return (
     <DesignPanelInputProvider ui="flat">
@@ -519,17 +560,7 @@ export function PropertyPanelFlat({
           data-flat-panel-body="true"
           className="flex min-h-0 flex-1 flex-col overflow-y-auto"
         >
-          {beforeOpen.map((g) => (
-            <DesignPanelInputProvider key={g.id} section={slugifyDesignInput(g.title)}>
-              <FlatGroupHeader
-                title={g.title}
-                isOpen={false}
-                onToggleOpen={() => toggleOpen(g.id)}
-                summary={g.summary}
-                animateEntrance={justToggledIds.includes(g.id)}
-              />
-            </DesignPanelInputProvider>
-          ))}
+          {beforeOpen.map(renderClosedGroup)}
           {openGroup && (
             <DesignPanelInputProvider section={slugifyDesignInput(openGroup.title)}>
               <div data-flat-group-open="true" className="flex min-h-[180px] flex-none flex-col">
@@ -548,17 +579,7 @@ export function PropertyPanelFlat({
               </div>
             </DesignPanelInputProvider>
           )}
-          {afterOpen.map((g) => (
-            <DesignPanelInputProvider key={g.id} section={slugifyDesignInput(g.title)}>
-              <FlatGroupHeader
-                title={g.title}
-                isOpen={false}
-                onToggleOpen={() => toggleOpen(g.id)}
-                summary={g.summary}
-                animateEntrance={justToggledIds.includes(g.id)}
-              />
-            </DesignPanelInputProvider>
-          ))}
+          {afterOpen.map(renderClosedGroup)}
         </div>
         <DesignPanelInputProvider section="footer">
           <PropertyPanelFlatFooter
diff --git a/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts b/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
new file mode 100644
index 0000000000..b68a1072a5
--- /dev/null
+++ b/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
@@ -0,0 +1,122 @@
+import { describe, expect, it, vi } from "vitest";
+import {
+  type GsapAnimationEditCallbacks,
+  withTrackedGsapAnimationCallbacks,
+} from "./gsapAnimationCallbacks";
+
+function requiredCallbacks(): GsapAnimationEditCallbacks {
+  return {
+    onUpdateProperty: vi.fn(),
+    onUpdateMeta: vi.fn(),
+    onDeleteAnimation: vi.fn(),
+    onAddProperty: vi.fn(),
+    onRemoveProperty: vi.fn(),
+  };
+}
+
+function requireCallback<T>(callback: T | undefined): T {
+  if (callback === undefined) throw new Error("expected callback to be present");
+  return callback;
+}
+
+describe("withTrackedGsapAnimationCallbacks", () => {
+  it("keeps absent optional callbacks absent and passes preview callbacks through unchanged", () => {
+    const callbacks = requiredCallbacks();
+    const onLivePreview = vi.fn();
+    const onLivePreviewEnd = vi.fn();
+    callbacks.onLivePreview = onLivePreview;
+    callbacks.onLivePreviewEnd = onLivePreviewEnd;
+
+    const tracked = withTrackedGsapAnimationCallbacks(callbacks, vi.fn());
+
+    expect(tracked.onUpdateFromProperty).toBeUndefined();
+    expect(tracked.onAddFromProperty).toBeUndefined();
+    expect(tracked.onRemoveFromProperty).toBeUndefined();
+    expect(tracked.onSetArcPath).toBeUndefined();
+    expect(tracked.onUpdateArcSegment).toBeUndefined();
+    expect(tracked.onUpdateKeyframeEase).toBeUndefined();
+    expect(tracked.onSetAllKeyframeEases).toBeUndefined();
+    expect(tracked.onUnroll).toBeUndefined();
+    expect(tracked.onLivePreview).toBe(onLivePreview);
+    expect(tracked.onLivePreviewEnd).toBe(onLivePreviewEnd);
+  });
+
+  it("tracks each edit once before invoking its mutation callback", () => {
+    const events: string[] = [];
+    const mutation = (name: string) => () => events.push(`mutate:${name}`);
+    const callbacks: GsapAnimationEditCallbacks = {
+      onUpdateProperty: mutation("update-property"),
+      onUpdateMeta: mutation("update-meta"),
+      onDeleteAnimation: mutation("delete"),
+      onAddProperty: mutation("add-property"),
+      onRemoveProperty: mutation("remove-property"),
+      onUpdateFromProperty: mutation("update-from"),
+      onAddFromProperty: mutation("add-from"),
+      onRemoveFromProperty: mutation("remove-from"),
+      onSetArcPath: mutation("arc-path"),
+      onUpdateArcSegment: mutation("arc-segment"),
+      onUpdateKeyframeEase: mutation("keyframe-ease"),
+      onSetAllKeyframeEases: mutation("all-eases"),
+      onUnroll: mutation("unroll"),
+    };
+    const tracked = withTrackedGsapAnimationCallbacks(callbacks, (control, name) => {
+      events.push(`track:${control}:${name}`);
+    });
+
+    tracked.onUpdateProperty("a1", "visibility", 1);
+    tracked.onUpdateProperty("a1", "filter", "blur(2px)");
+    tracked.onUpdateProperty("a1", "opacity", 0.5);
+    tracked.onUpdateMeta("a1", { duration: 2, ease: "none", position: 1 });
+    tracked.onDeleteAnimation("a1");
+    tracked.onAddProperty("a1", "scale");
+    tracked.onRemoveProperty("a1", "scale");
+    requireCallback(tracked.onUpdateFromProperty)("a1", "clipPath", "none");
+    requireCallback(tracked.onAddFromProperty)("a1", "x");
+    requireCallback(tracked.onRemoveFromProperty)("a1", "x");
+    requireCallback(tracked.onSetArcPath)("a1", { enabled: true });
+    requireCallback(tracked.onSetArcPath)("a1", { enabled: true, autoRotate: true });
+    requireCallback(tracked.onUpdateArcSegment)("a1", 1, {});
+    requireCallback(tracked.onUpdateArcSegment)("a1", 1, { curviness: 0.5 });
+    requireCallback(tracked.onUpdateKeyframeEase)("a1", 50, "power2.out");
+    requireCallback(tracked.onSetAllKeyframeEases)("a1", "none");
+    requireCallback(tracked.onUnroll)("a1");
+
+    expect(events).toEqual([
+      "track:toggle:visibility",
+      "mutate:update-property",
+      "track:text:filter",
+      "mutate:update-property",
+      "track:metric:opacity",
+      "mutate:update-property",
+      "track:metric:Length",
+      "track:select:Speed",
+      "track:metric:Starts at",
+      "mutate:update-meta",
+      "track:button:Remove animation",
+      "mutate:delete",
+      "track:select:Add effect property",
+      "mutate:add-property",
+      "track:button:Remove scale",
+      "mutate:remove-property",
+      "track:text:clipPath",
+      "mutate:update-from",
+      "track:select:Add from property",
+      "mutate:add-from",
+      "track:button:Remove from x",
+      "mutate:remove-from",
+      "track:toggle:Arc motion",
+      "mutate:arc-path",
+      "track:toggle:Auto rotate",
+      "mutate:arc-path",
+      "track:button:Reset arc segment 2",
+      "mutate:arc-segment",
+      "mutate:arc-segment",
+      "track:select:Keyframe ease",
+      "mutate:keyframe-ease",
+      "track:select:All keyframe eases",
+      "mutate:all-eases",
+      "track:button:Unroll animation",
+      "mutate:unroll",
+    ]);
+  });
+});
diff --git a/packages/studio/src/components/editor/gsapAnimationCallbacks.ts b/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
index c07d9c83b4..d35cf4479d 100644
--- a/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
+++ b/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
@@ -35,6 +35,18 @@ export interface GsapAnimationEditCallbacks {
   onUnroll?: (animationId: string) => void;
 }
 
+type TrackDesignInput = (control: string, name: string) => void;
+
+function trackAnimationProperty(track: TrackDesignInput, property: string): void {
+  const control =
+    property === "visibility"
+      ? "toggle"
+      : property === "filter" || property === "clipPath"
+        ? "text"
+        : "metric";
+  track(control, property);
+}
+
 // User-facing control label for each animation-meta field. The ease control is
 // labelled "Speed" in the card UI, so ease/easeEach map there.
 const ANIMATION_META_LABELS: Record<string, { control: string; name: string }> = {
@@ -51,13 +63,95 @@ const ANIMATION_META_LABELS: Record<string, { control: string; name: string }> =
  * added later is attributed honestly by its own key instead of poisoning another
  * control's usage count.
  */
-export function trackAnimationMetaUpdate(
-  track: (control: string, name: string) => void,
-  updates: Record<string, unknown>,
-): void {
+function trackAnimationMetaUpdate(track: TrackDesignInput, updates: Record<string, unknown>): void {
   for (const key of Object.keys(updates)) {
     const mapped = ANIMATION_META_LABELS[key];
     if (mapped) track(mapped.control, mapped.name);
     else track("select", key);
   }
 }
+
+/**
+ * Add design-input telemetry to the shared animation-edit callback surface.
+ * Optional callbacks remain absent, pass-through preview callbacks keep their
+ * original identity, and every tracked event fires once before its mutation.
+ */
+export function withTrackedGsapAnimationCallbacks(
+  callbacks: GsapAnimationEditCallbacks,
+  track: TrackDesignInput,
+): GsapAnimationEditCallbacks {
+  return {
+    onUpdateProperty: (animationId, property, value) => {
+      trackAnimationProperty(track, property);
+      callbacks.onUpdateProperty(animationId, property, value);
+    },
+    onUpdateMeta: (animationId, updates) => {
+      trackAnimationMetaUpdate(track, updates);
+      callbacks.onUpdateMeta(animationId, updates);
+    },
+    onDeleteAnimation: (animationId) => {
+      track("button", "Remove animation");
+      callbacks.onDeleteAnimation(animationId);
+    },
+    onAddProperty: (animationId, property) => {
+      track("select", "Add effect property");
+      callbacks.onAddProperty(animationId, property);
+    },
+    onRemoveProperty: (animationId, property) => {
+      track("button", `Remove ${property}`);
+      callbacks.onRemoveProperty(animationId, property);
+    },
+    onUpdateFromProperty: callbacks.onUpdateFromProperty
+      ? (animationId, property, value) => {
+          trackAnimationProperty(track, property);
+          callbacks.onUpdateFromProperty?.(animationId, property, value);
+        }
+      : undefined,
+    onAddFromProperty: callbacks.onAddFromProperty
+      ? (animationId, property) => {
+          track("select", "Add from property");
+          callbacks.onAddFromProperty?.(animationId, property);
+        }
+      : undefined,
+    onRemoveFromProperty: callbacks.onRemoveFromProperty
+      ? (animationId, property) => {
+          track("button", `Remove from ${property}`);
+          callbacks.onRemoveFromProperty?.(animationId, property);
+        }
+      : undefined,
+    onLivePreview: callbacks.onLivePreview,
+    onLivePreviewEnd: callbacks.onLivePreviewEnd,
+    onSetArcPath: callbacks.onSetArcPath
+      ? (animationId, config) => {
+          track("toggle", config.autoRotate !== undefined ? "Auto rotate" : "Arc motion");
+          callbacks.onSetArcPath?.(animationId, config);
+        }
+      : undefined,
+    onUpdateArcSegment: callbacks.onUpdateArcSegment
+      ? (animationId, segmentIndex, update) => {
+          if (update.curviness === undefined) {
+            track("button", `Reset arc segment ${segmentIndex + 1}`);
+          }
+          callbacks.onUpdateArcSegment?.(animationId, segmentIndex, update);
+        }
+      : undefined,
+    onUpdateKeyframeEase: callbacks.onUpdateKeyframeEase
+      ? (animationId, percentage, ease) => {
+          track("select", "Keyframe ease");
+          callbacks.onUpdateKeyframeEase?.(animationId, percentage, ease);
+        }
+      : undefined,
+    onSetAllKeyframeEases: callbacks.onSetAllKeyframeEases
+      ? (animationId, ease) => {
+          track("select", "All keyframe eases");
+          callbacks.onSetAllKeyframeEases?.(animationId, ease);
+        }
+      : undefined,
+    onUnroll: callbacks.onUnroll
+      ? (animationId) => {
+          track("button", "Unroll animation");
+          callbacks.onUnroll?.(animationId);
+        }
+      : undefined,
+  };
+}
diff --git a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
index 7458ad508a..c8edf195b5 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
@@ -6,12 +6,13 @@ import { formatTimingValue, RESPONSIVE_GRID } from "./propertyPanelHelpers";
 import { parseTimingValue } from "./propertyPanelTimingSection";
 import { CommitField } from "./propertyPanelPrimitives";
 import { AnimationCard } from "./AnimationCard";
-import { ADD_METHODS, ADD_METHOD_LABELS, METHOD_TOOLTIPS } from "./gsapAnimationConstants";
 import {
-  trackAnimationMetaUpdate,
   type GsapAnimationEditCallbacks,
+  withTrackedGsapAnimationCallbacks,
 } from "./gsapAnimationCallbacks";
 import { deriveElementTiming } from "./propertyPanelFlatTimingDerivation";
+import { usePlayerStore } from "../../player";
+import { GsapAddAnimationControl } from "./GsapAddAnimationControl";
 
 export function FlatTimingRow({
   element,
@@ -135,15 +136,18 @@ export function FlatMotionSection({
 } & GsapAnimationEditCallbacks) {
   const track = useTrackDesignInput();
   const [addMenuOpen, setAddMenuOpen] = useState(false);
-  const trackProperty = (property: string) => {
-    const control =
-      property === "visibility"
-        ? "toggle"
-        : property === "filter" || property === "clipPath"
-          ? "text"
-          : "metric";
-    track(control, property);
-  };
+  const trackedCallbacks = withTrackedGsapAnimationCallbacks(callbacks, track);
+  const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
+  const setFocusedEaseSegment = usePlayerStore((s) => s.setFocusedEaseSegment);
+  // Only consume a focus request aimed at the element THIS panel renders (not
+  // the store's selectedElementId, which flips synchronously during async
+  // selection resolution), so a shared class-selector animation id can't open
+  // the wrong element's editor.
+  const renderedElementId = `${element.sourceFile}#${element.id}`;
+  const focusedHere =
+    focusedEaseSegment && focusedEaseSegment.elementId === renderedElementId
+      ? focusedEaseSegment
+      : null;
 
   return (
     <div className="space-y-3">
@@ -172,140 +176,22 @@ export function FlatMotionSection({
             <div className="space-y-2">
               {animations.map((anim, index) => (
                 <AnimationCard
+                  {...trackedCallbacks}
                   key={anim.id}
                   animation={anim}
                   defaultExpanded={index === 0}
                   flat
-                  onUpdateProperty={(animationId, property, value) => {
-                    trackProperty(property);
-                    callbacks.onUpdateProperty(animationId, property, value);
-                  }}
-                  onUpdateMeta={(animationId, updates) => {
-                    trackAnimationMetaUpdate(track, updates);
-                    callbacks.onUpdateMeta(animationId, updates);
-                  }}
-                  onDeleteAnimation={(animationId) => {
-                    track("button", "Remove animation");
-                    callbacks.onDeleteAnimation(animationId);
-                  }}
-                  onAddProperty={(animationId, property) => {
-                    track("select", "Add effect property");
-                    callbacks.onAddProperty(animationId, property);
-                  }}
-                  onRemoveProperty={(animationId, property) => {
-                    track("button", `Remove ${property}`);
-                    callbacks.onRemoveProperty(animationId, property);
-                  }}
-                  onUpdateFromProperty={
-                    callbacks.onUpdateFromProperty
-                      ? (animationId, property, value) => {
-                          trackProperty(property);
-                          callbacks.onUpdateFromProperty?.(animationId, property, value);
-                        }
-                      : undefined
-                  }
-                  onAddFromProperty={
-                    callbacks.onAddFromProperty
-                      ? (animationId, property) => {
-                          track("select", "Add from property");
-                          callbacks.onAddFromProperty?.(animationId, property);
-                        }
-                      : undefined
-                  }
-                  onRemoveFromProperty={
-                    callbacks.onRemoveFromProperty
-                      ? (animationId, property) => {
-                          track("button", `Remove from ${property}`);
-                          callbacks.onRemoveFromProperty?.(animationId, property);
-                        }
-                      : undefined
-                  }
-                  onLivePreview={callbacks.onLivePreview}
-                  onLivePreviewEnd={callbacks.onLivePreviewEnd}
-                  onSetArcPath={
-                    callbacks.onSetArcPath
-                      ? (animationId, config) => {
-                          track(
-                            "toggle",
-                            config.autoRotate !== undefined ? "Auto rotate" : "Arc motion",
-                          );
-                          callbacks.onSetArcPath?.(animationId, config);
-                        }
-                      : undefined
-                  }
-                  onUpdateArcSegment={
-                    callbacks.onUpdateArcSegment
-                      ? (animationId, segmentIndex, update) => {
-                          if (update.curviness === undefined) {
-                            track("button", `Reset arc segment ${segmentIndex + 1}`);
-                          }
-                          callbacks.onUpdateArcSegment?.(animationId, segmentIndex, update);
-                        }
-                      : undefined
-                  }
-                  onUpdateKeyframeEase={
-                    callbacks.onUpdateKeyframeEase
-                      ? (animationId, percentage, ease) => {
-                          track("select", "Keyframe ease");
-                          callbacks.onUpdateKeyframeEase?.(animationId, percentage, ease);
-                        }
-                      : undefined
-                  }
-                  onSetAllKeyframeEases={
-                    callbacks.onSetAllKeyframeEases
-                      ? (animationId, ease) => {
-                          track("select", "All keyframe eases");
-                          callbacks.onSetAllKeyframeEases?.(animationId, ease);
-                        }
-                      : undefined
-                  }
-                  onUnroll={
-                    callbacks.onUnroll
-                      ? (animationId) => {
-                          track("button", "Unroll animation");
-                          callbacks.onUnroll?.(animationId);
-                        }
-                      : undefined
-                  }
+                  focusedSegment={focusedHere?.animationId === anim.id ? focusedHere : null}
+                  onFocusSegmentConsumed={() => setFocusedEaseSegment(null)}
                 />
               ))}
-              <div className="relative pt-1">
-                {addMenuOpen ? (
-                  <div className="flex gap-1.5">
-                    {ADD_METHODS.map((method) => (
-                      <button
-                        key={method}
-                        type="button"
-                        title={METHOD_TOOLTIPS[method]}
-                        onClick={() => {
-                          track("button", `Add ${method} animation`);
-                          onAddAnimation(method);
-                          setAddMenuOpen(false);
-                        }}
-                        className="rounded-lg border border-panel-border-input bg-panel-input px-2.5 py-1.5 text-[11px] font-medium text-panel-text-2 transition-colors hover:border-panel-text-4 hover:text-panel-text-0"
-                      >
-                        {ADD_METHOD_LABELS[method] ?? method}
-                      </button>
-                    ))}
-                    <button
-                      type="button"
-                      onClick={() => setAddMenuOpen(false)}
-                      className="px-1.5 text-[11px] text-panel-text-3 hover:text-panel-text-1"
-                    >
-                      Cancel
-                    </button>
-                  </div>
-                ) : (
-                  <button
-                    type="button"
-                    onClick={() => setAddMenuOpen(true)}
-                    className="text-[11px] font-medium text-panel-text-3 transition-colors hover:text-panel-text-1"
-                    title="Add a new animation effect to this element"
-                  >
-                    + Add effect
-                  </button>
-                )}
-              </div>
+              <GsapAddAnimationControl
+                open={addMenuOpen}
+                setOpen={setAddMenuOpen}
+                onAddAnimation={onAddAnimation}
+                track={track}
+                variant="flat"
+              />
             </div>
           )}
         </>
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.ts
index 662234daa0..361cfd615a 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.ts
@@ -40,6 +40,36 @@ describe("resolveTimelineKeyframeTarget", () => {
     ).toBeNull();
   });
 
+  it("uses the rendered animation identity to resolve a same-group collision", () => {
+    expect(
+      resolveTimelineKeyframeTarget(
+        50,
+        [
+          {
+            percentage: 50,
+            tweenPercentage: 25,
+            propertyGroup: "position",
+            animationId: "position-b",
+          },
+        ],
+        [
+          { id: "position-a", propertyGroup: "position" },
+          { id: "position-b", propertyGroup: "position" },
+        ],
+      ),
+    ).toEqual({ animId: "position-b", tweenPct: 25 });
+  });
+
+  it("rejects a rendered animation identity absent from the element", () => {
+    expect(
+      resolveTimelineKeyframeTarget(
+        50,
+        [{ percentage: 50, animationId: "stale-position" }],
+        [{ id: "position", propertyGroup: "position" }],
+      ),
+    ).toBeNull();
+  });
+
   it("keeps a keyframed and flat tween in the same property group unresolved", () => {
     expect(
       resolveTimelineKeyframeTarget(
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
new file mode 100644
index 0000000000..09ab781c90
--- /dev/null
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -0,0 +1,306 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import type { TimelineElement } from "../../player";
+import type { TimelineEditCallbacks } from "../../player/components/timelineCallbacks";
+import { usePlayerStore } from "../../player/store/playerStore";
+import { installReactActEnvironment, mountReactHarness } from "../../hooks/domSelectionTestHarness";
+
+installReactActEnvironment();
+
+const mocks = vi.hoisted(() => ({
+  actions: {
+    handleGsapRemoveKeyframe: vi.fn(),
+    handleGsapMoveKeyframeToPlayhead: vi.fn(),
+    handleGsapMoveKeyframe: vi.fn(),
+    handleGsapResizeKeyframedTween: vi.fn(),
+    handleGsapUpdateMeta: vi.fn(),
+    handleGsapAddKeyframe: vi.fn(),
+    handleGsapAddKeyframeBatch: vi.fn().mockResolvedValue(undefined),
+    handleGsapConvertToKeyframes: vi.fn(),
+    handleGsapRemoveAllKeyframes: vi.fn(),
+    handleGsapDeleteAnimation: vi.fn(),
+    buildDomSelectionForTimelineElement: vi.fn(),
+  },
+  selection: { id: "box", selector: "#box", sourceFile: "index.html" },
+  animations: Array<GsapAnimation>(),
+}));
+
+vi.mock("../../contexts/StudioContext", () => ({
+  useStudioShellContext: () => ({ projectId: "project", activeCompPath: "index.html" }),
+}));
+
+vi.mock("../../contexts/DomEditContext", () => ({
+  useDomEditActionsContext: () => mocks.actions,
+  useDomEditSelectionContext: () => ({
+    domEditSelection: mocks.selection,
+    selectedGsapAnimations: mocks.animations,
+  }),
+}));
+
+import { useTimelineEditCallbacks } from "./useTimelineEditCallbacks";
+
+const element: TimelineElement = {
+  id: "box",
+  key: "index.html#box",
+  domId: "box",
+  tag: "div",
+  start: 0,
+  duration: 1,
+  track: 0,
+  sourceFile: "index.html",
+};
+
+const flatAnimation: GsapAnimation = {
+  id: "box-to-0-position",
+  targetSelector: "#box",
+  method: "to",
+  position: 0,
+  resolvedStart: 0,
+  duration: 1,
+  properties: { x: 420 },
+  propertyGroup: "position",
+};
+
+const otherFlatAnimation: GsapAnimation = {
+  ...flatAnimation,
+  id: "circle-to-0-position",
+  targetSelector: "#circle",
+};
+
+const otherKeyframedAnimation: GsapAnimation = {
+  ...otherFlatAnimation,
+  keyframes: {
+    format: "percentage",
+    keyframes: [
+      { percentage: 0, properties: { x: 0 } },
+      { percentage: 100, properties: { x: 420 } },
+    ],
+  },
+};
+
+function authoredInteriorAnimation(): GsapAnimation {
+  return {
+    ...flatAnimation,
+    keyframes: {
+      format: "percentage",
+      keyframes: [
+        { percentage: 0, properties: { x: 0 } },
+        { percentage: 50, properties: { x: 210 } },
+        { percentage: 100, properties: { x: 420 } },
+      ],
+    },
+  };
+}
+
+function renderCallbacks(): { callbacks: TimelineEditCallbacks; unmount: () => void } {
+  let callbacks: TimelineEditCallbacks | null = null;
+  function Harness() {
+    callbacks = useTimelineEditCallbacks({
+      handleTimelineElementMove: vi.fn(),
+      handleTimelineElementsMove: vi.fn(),
+      handleTimelineElementResize: vi.fn(),
+      handleTimelineGroupResize: vi.fn(),
+      handleToggleTrackHidden: vi.fn(),
+      handleBlockedTimelineEdit: vi.fn(),
+      handleTimelineElementSplit: vi.fn(),
+      handleRazorSplit: vi.fn(),
+      handleRazorSplitAll: vi.fn(),
+    });
+    return null;
+  }
+  const root = mountReactHarness(<Harness />);
+  if (!callbacks) throw new Error("timeline callbacks did not initialize");
+  return { callbacks, unmount: () => act(() => root.unmount()) };
+}
+
+beforeEach(() => {
+  vi.clearAllMocks();
+  mocks.animations = [flatAnimation];
+  mocks.actions.buildDomSelectionForTimelineElement.mockResolvedValue(mocks.selection);
+  usePlayerStore.setState({
+    currentTime: 0.5,
+    elements: [element],
+    domClipChildren: [],
+    keyframeCache: new Map(),
+    gsapAnimations: new Map([["box", [flatAnimation]]]),
+  });
+});
+
+afterEach(() => {
+  usePlayerStore.setState({
+    elements: [],
+    domClipChildren: [],
+    keyframeCache: new Map(),
+    gsapAnimations: new Map(),
+  });
+});
+
+describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
+  it("adds an interior point through the add-keyframe persist boundary", async () => {
+    const view = renderCallbacks();
+
+    await act(async () => {
+      await view.callbacks.onTogglePropertyGroupKeyframe?.(element, {
+        animationId: flatAnimation.id,
+        propertyGroup: "position",
+        tweenPercentage: 50,
+        properties: { x: 210 },
+        remove: false,
+      });
+    });
+
+    expect(mocks.actions.handleGsapAddKeyframeBatch).toHaveBeenCalledWith(
+      flatAnimation.id,
+      50,
+      { x: 210 },
+      undefined,
+      mocks.selection,
+    );
+    expect(mocks.actions.handleGsapConvertToKeyframes).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("safely no-ops a boundary drag while the tween is still flat", () => {
+    const view = renderCallbacks();
+
+    act(() => {
+      view.callbacks.onMoveKeyframe?.("box", 0, 25, "position", 0, flatAnimation.id);
+    });
+
+    expect(mocks.actions.handleGsapMoveKeyframe).not.toHaveBeenCalled();
+    expect(mocks.actions.handleGsapResizeKeyframedTween).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("deletes a non-selected element flat boundary through the clicked element's selection", async () => {
+    const circle: TimelineElement = {
+      ...element,
+      id: "circle",
+      key: "scenes/main.html#circle",
+      domId: "circle",
+    };
+    usePlayerStore.setState({
+      elements: [element, circle],
+      gsapAnimations: new Map([["scenes/main.html#circle", [otherFlatAnimation]]]),
+    });
+    const view = renderCallbacks();
+
+    await act(async () => {
+      view.callbacks.onDeleteKeyframe?.(
+        "scenes/main.html#circle",
+        0,
+        "position",
+        0,
+        otherFlatAnimation.id,
+      );
+      await Promise.resolve();
+      await Promise.resolve();
+    });
+
+    // Persisted through the CLICKED element's own selection, not the current one.
+    expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(
+      otherFlatAnimation.id,
+      mocks.selection,
+    );
+    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("removes a non-selected element authored endpoint through the clicked element's selection", async () => {
+    const circle: TimelineElement = {
+      ...element,
+      id: "circle",
+      key: "scenes/main.html#circle",
+      domId: "circle",
+    };
+    usePlayerStore.setState({
+      elements: [element, circle],
+      gsapAnimations: new Map([["index.html#circle", [otherKeyframedAnimation]]]),
+    });
+    const view = renderCallbacks();
+
+    await act(async () => {
+      view.callbacks.onDeleteKeyframe?.(
+        "scenes/main.html#circle",
+        100,
+        "position",
+        100,
+        otherKeyframedAnimation.id,
+      );
+      await Promise.resolve();
+      await Promise.resolve();
+    });
+
+    expect(mocks.actions.handleGsapRemoveKeyframe).toHaveBeenCalledWith(
+      otherKeyframedAnimation.id,
+      100,
+      undefined,
+      mocks.selection,
+    );
+    expect(mocks.actions.handleGsapDeleteAnimation).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("keeps selected-element flat boundary deletion on the animation delete path", () => {
+    const view = renderCallbacks();
+
+    act(() => {
+      view.callbacks.onDeleteKeyframe?.("box", 0, "position", 0, flatAnimation.id);
+    });
+
+    expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(flatAnimation.id);
+    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("routes the flat lane-header remove toggle through the guarded delete path", async () => {
+    const view = renderCallbacks();
+
+    await act(async () => {
+      await view.callbacks.onTogglePropertyGroupKeyframe?.(element, {
+        animationId: flatAnimation.id,
+        propertyGroup: "position",
+        tweenPercentage: 100,
+        properties: { x: 420 },
+        remove: true,
+      });
+    });
+
+    expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(
+      flatAnimation.id,
+      mocks.selection,
+    );
+    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("keeps authored interior deletion on the per-keyframe path", () => {
+    mocks.animations = [authoredInteriorAnimation()];
+    usePlayerStore.setState({ gsapAnimations: new Map([["box", mocks.animations]]) });
+    const view = renderCallbacks();
+
+    act(() => {
+      view.callbacks.onDeleteKeyframe?.("box", 50, "position", 50, flatAnimation.id);
+    });
+
+    expect(mocks.actions.handleGsapRemoveKeyframe).toHaveBeenCalledWith(flatAnimation.id, 50);
+    expect(mocks.actions.handleGsapDeleteAnimation).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("keeps an authored interior drag on the per-keyframe move path", () => {
+    mocks.animations = [authoredInteriorAnimation()];
+    const view = renderCallbacks();
+
+    act(() => {
+      view.callbacks.onMoveKeyframe?.("box", 50, 75, "position", 50, flatAnimation.id);
+    });
+
+    expect(mocks.actions.handleGsapMoveKeyframe).toHaveBeenCalledWith(flatAnimation.id, 50, 75);
+    expect(mocks.actions.handleGsapResizeKeyframedTween).not.toHaveBeenCalled();
+    view.unmount();
+  });
+});
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index a1fa658521..c800528aee 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -1,4 +1,5 @@
 import { useCallback, useMemo } from "react";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import type { TimelineElement } from "../../player";
 import { usePlayerStore } from "../../player/store/playerStore";
 import type { BlockedTimelineEditIntent } from "../../player/components/timelineEditing";
@@ -11,6 +12,7 @@ import {
 import { resolveTweenStart, resolveTweenDuration } from "../../utils/globalTimeCompiler";
 import { resolveClipTimingBasis } from "../../hooks/useGsapTweenCache";
 import { resolveKeyframeRetime } from "../editor/keyframeRetime";
+import type { DomEditSelection } from "../editor/domEditingTypes";
 import type { TimelineMoveOperation } from "../../hooks/timelineMoveAdapter";
 
 export interface TimelineEditCallbackDeps {
@@ -46,15 +48,14 @@ interface TimelineCachedKeyframe {
   percentage: number;
   tweenPercentage?: number;
   propertyGroup?: string;
+  animationId?: string;
 }
 
 /**
  * Resolve a rendered timeline diamond back to the animation that authored it.
- * Flat tweens use synthesized diamonds, so a mixed flat tween may have neither
- * a property group nor real keyframes. The cache currently carries a property
- * group, not an animation id, so resolution is safe only when that group has a
- * single candidate. Ambiguous candidates remain unresolved rather than
- * retiming an arbitrary tween.
+ * Prefer the animation identity carried by the rendered keyframe. Legacy cache
+ * entries without one are safe only when their property group has one candidate;
+ * ambiguous candidates remain unresolved rather than retiming an arbitrary tween.
  */
 export function resolveTimelineKeyframeTarget(
   pct: number,
@@ -63,6 +64,14 @@ export function resolveTimelineKeyframeTarget(
 ): { animId: string; tweenPct: number } | null {
   const kf = keyframes.find((item) => Math.abs(item.percentage - pct) < 0.2);
   if (!kf) return null;
+  const identifiedAnimation = kf.animationId
+    ? animations.find((animation) => animation.id === kf.animationId)
+    : undefined;
+  if (kf.animationId) {
+    return identifiedAnimation
+      ? { animId: identifiedAnimation.id, tweenPct: kf.tweenPercentage ?? pct }
+      : null;
+  }
   const group = kf?.propertyGroup;
   const candidates = group
     ? animations.filter((animation) => animation.propertyGroup === group)
@@ -98,24 +107,76 @@ export function useTimelineEditCallbacks({
     handleGsapResizeKeyframedTween,
     handleGsapUpdateMeta,
     handleGsapAddKeyframe,
+    handleGsapAddKeyframeBatch,
     handleGsapConvertToKeyframes,
     handleGsapRemoveAllKeyframes,
+    handleGsapDeleteAnimation,
     buildDomSelectionForTimelineElement,
   } = useDomEditActionsContext();
 
+  const resolveElementAnimations = useCallback(
+    (elementKey: string): GsapAnimation[] => {
+      const { gsapAnimations } = usePlayerStore.getState();
+      const hashIndex = elementKey.lastIndexOf("#");
+      const elementId = hashIndex === -1 ? elementKey : elementKey.slice(hashIndex + 1);
+      const sourceFile =
+        hashIndex === -1 ? (activeCompPath ?? "index.html") : elementKey.slice(0, hashIndex);
+      return (
+        gsapAnimations.get(`${sourceFile}#${elementId}`) ??
+        gsapAnimations.get(`index.html#${elementId}`) ??
+        gsapAnimations.get(elementId) ??
+        []
+      );
+    },
+    [activeCompPath],
+  );
+
   // Resolve a timeline-diamond callback's clip-% to the keyframe's anim id + its
   // tween-relative percentage (shared by the delete/move keyframe callbacks): the
   // diamond reports a clip-% but the script ops key on the tween-%. Prefers the
   // anim in the keyframe's property group, falling back to the first keyframed one.
   const resolveKeyframeTarget = useCallback(
     // fallow-ignore-next-line complexity
-    (pct: number): { animId: string; tweenPct: number } | null => {
+    (
+      pct: number,
+      propertyGroup?: string,
+      tweenPercentage?: number,
+      animationId?: string,
+      animations: GsapAnimation[] = selectedGsapAnimations,
+    ): { animId: string; tweenPct: number } | null => {
+      const explicitTarget =
+        propertyGroup !== undefined || tweenPercentage !== undefined || animationId !== undefined
+          ? [{ percentage: pct, propertyGroup, tweenPercentage, animationId }]
+          : undefined;
       const cached = usePlayerStore.getState().keyframeCache.get(domEditSelection?.id ?? "");
-      return resolveTimelineKeyframeTarget(pct, cached?.keyframes ?? [], selectedGsapAnimations);
+      return resolveTimelineKeyframeTarget(
+        pct,
+        explicitTarget ?? cached?.keyframes ?? [],
+        animations,
+      );
     },
     [domEditSelection?.id, selectedGsapAnimations],
   );
 
+  const removeKeyframeTarget = useCallback(
+    (
+      animationId: string,
+      percentage: number,
+      animations: GsapAnimation[],
+      selectionOverride?: DomEditSelection | null,
+    ) => {
+      const animation = animations.find((candidate) => candidate.id === animationId);
+      if (animation && !animation.keyframes) {
+        if (selectionOverride === undefined) handleGsapDeleteAnimation(animationId);
+        else handleGsapDeleteAnimation(animationId, selectionOverride);
+        return;
+      }
+      if (selectionOverride === undefined) handleGsapRemoveKeyframe(animationId, percentage);
+      else handleGsapRemoveKeyframe(animationId, percentage, undefined, selectionOverride);
+    },
+    [handleGsapDeleteAnimation, handleGsapRemoveKeyframe],
+  );
+
   return useMemo(
     () => ({
       onMoveElement: handleTimelineElementMove,
@@ -135,13 +196,25 @@ export function useTimelineEditCallbacks({
         if (!anim) return;
         handleGsapRemoveAllKeyframes(anim.id);
       },
-      onDeleteKeyframe: (_elId: string, pct: number) => {
-        const target = resolveKeyframeTarget(pct);
-        if (target) handleGsapRemoveKeyframe(target.animId, target.tweenPct);
+      onDeleteKeyframe: (elId, pct, group, tweenPct, animationId) => {
+        const animations = resolveElementAnimations(elId);
+        const target = resolveKeyframeTarget(pct, group, tweenPct, animationId, animations);
+        if (!target) return;
+        const element = usePlayerStore.getState().elements.find((el) => (el.key ?? el.id) === elId);
+        if (!element) {
+          removeKeyframeTarget(target.animId, target.tweenPct, animations);
+          return;
+        }
+        // Persist through the CLICKED element's own selection so a deletion on a
+        // non-selected element (especially one in a different source file) commits
+        // against the right element instead of the current domEditSelection.
+        void buildDomSelectionForTimelineElement(element).then((selection) => {
+          removeKeyframeTarget(target.animId, target.tweenPct, animations, selection);
+        });
       },
       // Retime the keyframe to the playhead, preserving its value + ease.
-      onMoveKeyframeToPlayhead: (_elId: string, pct: number) => {
-        const target = resolveKeyframeTarget(pct);
+      onMoveKeyframeToPlayhead: (_elId, pct, group, tweenPct, animationId) => {
+        const target = resolveKeyframeTarget(pct, group, tweenPct, animationId);
         if (target) handleGsapMoveKeyframeToPlayhead(target.animId, target.tweenPct);
       },
       // Drag-to-retime. The diamond reports clip-%s; resolveKeyframeTarget gives
@@ -152,13 +225,17 @@ export function useTimelineEditCallbacks({
       // resizes the tween — position/duration grow so the dragged keyframe lands at
       // the drop while every other keyframe keeps its absolute time (value+ease too).
       // fallow-ignore-next-line complexity
-      onMoveKeyframe: async (_elId: string, fromClipPct: number, toClipPct: number) => {
-        const target = resolveKeyframeTarget(fromClipPct);
+      onMoveKeyframe: async (_elId, fromClipPct, toClipPct, group, tweenPct, animationId) => {
+        const target = resolveKeyframeTarget(fromClipPct, group, tweenPct, animationId);
         const sel = domEditSelection;
         if (!target || !sel) return false;
         const anim = selectedGsapAnimations.find((a) => a.id === target.animId);
         const tweenStart = anim ? resolveTweenStart(anim) : null;
         if (!anim || tweenStart === null) return false;
+        // Synthesized flat endpoints are clip boundaries, not authored keyframes.
+        // Boundary-to-clip resize wiring is intentionally deferred; ignore the
+        // drag rather than dispatching a free keyframe move that cannot be written.
+        if (!anim.keyframes) return false;
         const tweenDuration = anim.duration ?? resolveTweenDuration(anim);
         const sourceFile = sel.sourceFile || activeCompPath || "index.html";
         const { elements, domClipChildren } = usePlayerStore.getState();
@@ -230,6 +307,26 @@ export function useTimelineEditCallbacks({
           if (flatAnim) handleGsapConvertToKeyframes(flatAnim.id);
         }
       },
+      onTogglePropertyGroupKeyframe: async (element, target) => {
+        const selection = await buildDomSelectionForTimelineElement(element);
+        if (!selection) return;
+        if (target.remove) {
+          removeKeyframeTarget(
+            target.animationId,
+            target.tweenPercentage,
+            selectedGsapAnimations,
+            selection,
+          );
+          return;
+        }
+        await handleGsapAddKeyframeBatch(
+          target.animationId,
+          target.tweenPercentage,
+          target.properties,
+          undefined,
+          selection,
+        );
+      },
     }),
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [
@@ -243,14 +340,16 @@ export function useTimelineEditCallbacks({
       handleRazorSplit,
       handleRazorSplitAll,
       handleGsapRemoveAllKeyframes,
+      resolveElementAnimations,
       resolveKeyframeTarget,
+      removeKeyframeTarget,
       selectedGsapAnimations,
-      handleGsapRemoveKeyframe,
       handleGsapMoveKeyframeToPlayhead,
       handleGsapMoveKeyframe,
       handleGsapResizeKeyframedTween,
       handleGsapUpdateMeta,
       handleGsapAddKeyframe,
+      handleGsapAddKeyframeBatch,
       handleGsapConvertToKeyframes,
       buildDomSelectionForTimelineElement,
       projectId,
diff --git a/packages/studio/src/contexts/TimelineEditContext.tsx b/packages/studio/src/contexts/TimelineEditContext.tsx
index c2b6edc6ce..be7f4e9ad6 100644
--- a/packages/studio/src/contexts/TimelineEditContext.tsx
+++ b/packages/studio/src/contexts/TimelineEditContext.tsx
@@ -44,6 +44,7 @@ export function TimelineEditProvider({
       value.onMoveKeyframeToPlayhead,
       value.onMoveKeyframe,
       value.onToggleKeyframeAtPlayhead,
+      value.onTogglePropertyGroupKeyframe,
     ],
   );
   return <TimelineEditContext.Provider value={memoized}>{children}</TimelineEditContext.Provider>;
diff --git a/packages/studio/src/hooks/useStudioContextValue.test.ts b/packages/studio/src/hooks/useStudioContextValue.test.ts
new file mode 100644
index 0000000000..01228d92ed
--- /dev/null
+++ b/packages/studio/src/hooks/useStudioContextValue.test.ts
@@ -0,0 +1,93 @@
+// @vitest-environment happy-dom
+
+import React from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+import { describe, expect, it } from "vitest";
+import type { DomEditSelection } from "../components/editor/domEditing";
+import type { RightInspectorPanes } from "../utils/studioHelpers";
+import { makeSelection } from "./domSelectionTestHarness";
+import { useInspectorState, type InspectorState } from "./useStudioContextValue";
+
+interface HarnessProps {
+  rightPanelTab: string;
+  rightInspectorPanes: RightInspectorPanes;
+  rightCollapsed: boolean;
+  isPlaying: boolean;
+  isGestureRecording: boolean;
+  domEditSelection: DomEditSelection | null;
+}
+
+function renderInspectorState(props: HarnessProps): InspectorState {
+  let state: InspectorState | null = null;
+
+  function Harness() {
+    state = useInspectorState(
+      props.rightPanelTab,
+      props.rightInspectorPanes,
+      props.rightCollapsed,
+      props.isPlaying,
+      props.domEditSelection,
+      props.isGestureRecording,
+    );
+    return null;
+  }
+
+  renderToStaticMarkup(React.createElement(Harness));
+  if (!state) throw new Error("Expected inspector state");
+  return state;
+}
+
+function selectedProps(
+  overrides: Partial<HarnessProps> = {},
+): HarnessProps & { domEditSelection: DomEditSelection } {
+  const element = document.createElement("div");
+  return {
+    rightPanelTab: "renders",
+    rightInspectorPanes: { layers: false, design: false },
+    rightCollapsed: true,
+    isPlaying: false,
+    isGestureRecording: false,
+    domEditSelection: makeSelection("Selected", element),
+    ...overrides,
+  };
+}
+
+describe("useInspectorState", () => {
+  it("shows the motion path for pure selection with the inspector collapsed", () => {
+    expect(renderInspectorState(selectedProps()).shouldShowMotionPath).toBe(true);
+  });
+
+  it("hides the motion path without a selection", () => {
+    expect(
+      renderInspectorState({ ...selectedProps(), domEditSelection: null }).shouldShowMotionPath,
+    ).toBe(false);
+  });
+
+  it("hides the motion path during playback", () => {
+    expect(renderInspectorState(selectedProps({ isPlaying: true })).shouldShowMotionPath).toBe(
+      false,
+    );
+  });
+
+  it("hides the motion path during gesture recording", () => {
+    expect(
+      renderInspectorState(selectedProps({ isGestureRecording: true })).shouldShowMotionPath,
+    ).toBe(false);
+  });
+
+  it("keeps selected DOM bounds coupled to the inspector or variables panel", () => {
+    expect(renderInspectorState(selectedProps()).shouldShowSelectedDomBounds).toBe(false);
+    expect(
+      renderInspectorState(
+        selectedProps({
+          rightPanelTab: "design",
+          rightInspectorPanes: { layers: false, design: true },
+        }),
+      ).shouldShowSelectedDomBounds,
+    ).toBe(true);
+    expect(
+      renderInspectorState(selectedProps({ rightPanelTab: "variables" }))
+        .shouldShowSelectedDomBounds,
+    ).toBe(true);
+  });
+});
diff --git a/packages/studio/src/hooks/useStudioContextValue.ts b/packages/studio/src/hooks/useStudioContextValue.ts
index 460028bdfb..21ba371f73 100644
--- a/packages/studio/src/hooks/useStudioContextValue.ts
+++ b/packages/studio/src/hooks/useStudioContextValue.ts
@@ -1,5 +1,6 @@
 import { useCallback, useMemo, useRef, useState, type DragEvent } from "react";
 import { STUDIO_INSPECTOR_PANELS_ENABLED } from "../components/editor/manualEditingAvailability";
+import type { DomEditSelection } from "../components/editor/domEditing";
 import type { StudioContextValue } from "../contexts/StudioContext";
 import type { RightInspectorPanes } from "../utils/studioHelpers";
 import type { TimelineFileDropHandler } from "./useTimelineEditingTypes";
@@ -69,6 +70,7 @@ export interface InspectorState {
   designPanelActive: boolean;
   inspectorPanelActive: boolean;
   inspectorButtonActive: boolean;
+  shouldShowMotionPath: boolean;
   shouldShowSelectedDomBounds: boolean;
 }
 
@@ -77,6 +79,7 @@ export function useInspectorState(
   rightInspectorPanes: RightInspectorPanes,
   rightCollapsed: boolean,
   isPlaying: boolean,
+  domEditSelection: DomEditSelection | null,
   isGestureRecording?: boolean,
 ): InspectorState {
   // fallow-ignore-next-line complexity
@@ -93,8 +96,9 @@ export function useInspectorState(
       inspectorPanelActive,
       inspectorButtonActive:
         STUDIO_INSPECTOR_PANELS_ENABLED && !rightCollapsed && inspectorPanelActive,
-      // Keep the selection box + motion path drawn even when the Inspector is
-      // collapsed — closing the panel shouldn't visually deselect the element.
+      shouldShowMotionPath: !!domEditSelection && !isPlaying && !isGestureRecording,
+      // Keep the selection box drawn even when the Inspector is collapsed —
+      // closing the panel shouldn't visually deselect the element.
       // The Variables tab also works against the canvas selection (bind card),
       // so the selection outline stays visible there too.
       shouldShowSelectedDomBounds:
@@ -102,7 +106,14 @@ export function useInspectorState(
         !isPlaying &&
         !isGestureRecording,
     };
-  }, [rightPanelTab, rightInspectorPanes, rightCollapsed, isPlaying, isGestureRecording]);
+  }, [
+    rightPanelTab,
+    rightInspectorPanes,
+    rightCollapsed,
+    isPlaying,
+    isGestureRecording,
+    domEditSelection,
+  ]);
 }
 
 // fallow-ignore-next-line complexity

From ba8df2661c4af74897c734ad6376a0b1dc3fd5e2 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 23:09:13 +0200
Subject: [PATCH 082/125] fix(studio): resolve keyframe fallbacks against the
 clicked element

Three review follow-ups on the editor-callback consolidation.

The keyframe-target resolve now takes the clicked element's key and reads
that element's keyframe cache. The diamond context menu and move-to-playhead
pass no explicit target, so they fell through to the cache of whatever
element happened to be selected: opening the menu on a non-selected
element's diamond resolved against the wrong keyframes.

PropertyPanelFlat opens the Motion group by adjusting state during render
instead of in an effect, so the AnimationCard mounts on the same commit the
focus request arrives on rather than a frame later.

Both animation sections pass a module-level focus consumer instead of a
fresh inline arrow, so AnimationCard's focus effect stops re-running on
every parent render.
---
 .../editor/GsapAnimationSection.tsx           |  4 +-
 .../components/editor/PropertyPanelFlat.tsx   | 26 +++++----
 .../editor/gsapAnimationCallbacks.ts          | 10 ++++
 .../editor/propertyPanelFlatMotionSection.tsx |  4 +-
 .../nle/useTimelineEditCallbacks.test.tsx     | 53 +++++++++++++++++++
 .../nle/useTimelineEditCallbacks.ts           | 21 ++++++--
 6 files changed, 99 insertions(+), 19 deletions(-)

diff --git a/packages/studio/src/components/editor/GsapAnimationSection.tsx b/packages/studio/src/components/editor/GsapAnimationSection.tsx
index 1fac3972e9..2ced7b6a8e 100644
--- a/packages/studio/src/components/editor/GsapAnimationSection.tsx
+++ b/packages/studio/src/components/editor/GsapAnimationSection.tsx
@@ -6,6 +6,7 @@ import { AnimationCard } from "./AnimationCard";
 import {
   type GsapAnimationEditCallbacks,
   withTrackedGsapAnimationCallbacks,
+  clearFocusedEaseSegment,
 } from "./gsapAnimationCallbacks";
 import { useTrackDesignInput } from "../../contexts/DesignPanelInputContext";
 import { usePlayerStore } from "../../player";
@@ -29,7 +30,6 @@ export const GsapAnimationSection = memo(function GsapAnimationSection({
   const [addMenuOpen, setAddMenuOpen] = useState(false);
   const trackedCallbacks = withTrackedGsapAnimationCallbacks(callbacks, track);
   const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
-  const setFocusedEaseSegment = usePlayerStore((s) => s.setFocusedEaseSegment);
 
   return (
     <Section title="Animation" icon={<Film size={15} />}>
@@ -57,7 +57,7 @@ export const GsapAnimationSection = memo(function GsapAnimationSection({
               focusedSegment={
                 focusedEaseSegment?.animationId === anim.id ? focusedEaseSegment : null
               }
-              onFocusSegmentConsumed={() => setFocusedEaseSegment(null)}
+              onFocusSegmentConsumed={clearFocusedEaseSegment}
             />
           ))}
 
diff --git a/packages/studio/src/components/editor/PropertyPanelFlat.tsx b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
index 86900c1261..8947135233 100644
--- a/packages/studio/src/components/editor/PropertyPanelFlat.tsx
+++ b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
@@ -249,18 +249,22 @@ export function PropertyPanelFlat({
   // force the Motion group open so its AnimationCard (which only mounts while
   // the group is expanded) can consume the focus and reveal the ease editor.
   const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
-  // Identity of the element THIS panel actually renders (not the store's
-  // selectedElementId, which flips synchronously on selection while the panel
-  // still renders the previous element during async DOM-selection resolution):
-  // a stale panel would otherwise consume a focus request meant for its
-  // successor when both share a class-selector animation id.
+  // The element THIS panel renders, not the store's selectedElementId: that
+  // flips synchronously while the panel still renders its predecessor, so a
+  // stale panel would consume a request meant for its successor whenever the
+  // two share a class-selector animation id.
   const renderedElementId = `${element.sourceFile}#${element.id}`;
-  useEffect(() => {
-    if (!focusedEaseSegment || focusedEaseSegment.elementId !== renderedElementId) return;
-    if (gsapAnimations.some((a) => a.id === focusedEaseSegment.animationId)) {
-      setOpenGroupId("motion");
-    }
-  }, [focusedEaseSegment, gsapAnimations, renderedElementId]);
+  // Adjusted during render (not an effect) so the card mounts on the same
+  // commit the request lands on. Keyed on request identity: a group the user
+  // closes afterwards stays closed.
+  const [consumedFocus, setConsumedFocus] = useState(focusedEaseSegment);
+  if (focusedEaseSegment !== consumedFocus) {
+    setConsumedFocus(focusedEaseSegment);
+    const focusesThisPanel =
+      focusedEaseSegment?.elementId === renderedElementId &&
+      gsapAnimations.some((a) => a.id === focusedEaseSegment.animationId);
+    if (focusesThisPanel) setOpenGroupId("motion");
+  }
 
   const [justToggledIds, setJustToggledIds] = useState<string[]>([]);
   const justToggledTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
diff --git a/packages/studio/src/components/editor/gsapAnimationCallbacks.ts b/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
index d35cf4479d..bc5d783569 100644
--- a/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
+++ b/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
@@ -1,4 +1,5 @@
 import type { ArcPathSegment } from "@hyperframes/parsers/gsap-parser";
+import { usePlayerStore } from "../../player";
 
 /**
  * Edit callbacks shared by GsapAnimationSection and each AnimationCard it
@@ -155,3 +156,12 @@ export function withTrackedGsapAnimationCallbacks(
       : undefined,
   };
 }
+
+/**
+ * Stable consumer for the store's one-shot ease-focus request. Module-level on
+ * purpose: an inline arrow in the section components is a dep of AnimationCard's
+ * focus effect, so a fresh identity each render re-runs that effect every render.
+ */
+export function clearFocusedEaseSegment(): void {
+  usePlayerStore.getState().setFocusedEaseSegment(null);
+}
diff --git a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
index c8edf195b5..4823a995a2 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
@@ -9,6 +9,7 @@ import { AnimationCard } from "./AnimationCard";
 import {
   type GsapAnimationEditCallbacks,
   withTrackedGsapAnimationCallbacks,
+  clearFocusedEaseSegment,
 } from "./gsapAnimationCallbacks";
 import { deriveElementTiming } from "./propertyPanelFlatTimingDerivation";
 import { usePlayerStore } from "../../player";
@@ -138,7 +139,6 @@ export function FlatMotionSection({
   const [addMenuOpen, setAddMenuOpen] = useState(false);
   const trackedCallbacks = withTrackedGsapAnimationCallbacks(callbacks, track);
   const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
-  const setFocusedEaseSegment = usePlayerStore((s) => s.setFocusedEaseSegment);
   // Only consume a focus request aimed at the element THIS panel renders (not
   // the store's selectedElementId, which flips synchronously during async
   // selection resolution), so a shared class-selector animation id can't open
@@ -182,7 +182,7 @@ export function FlatMotionSection({
                   defaultExpanded={index === 0}
                   flat
                   focusedSegment={focusedHere?.animationId === anim.id ? focusedHere : null}
-                  onFocusSegmentConsumed={() => setFocusedEaseSegment(null)}
+                  onFocusSegmentConsumed={clearFocusedEaseSegment}
                 />
               ))}
               <GsapAddAnimationControl
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
index 09ab781c90..a06b18ece8 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -244,6 +244,59 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
+  // The diamond context menu opens on whatever diamond was clicked, which need
+  // not belong to the selected element, and it passes no explicit target — so
+  // the resolve falls back to the cache. Reading the SELECTED element's cache
+  // there resolves against the wrong element's keyframes.
+  it("resolves a cache fallback against the clicked element, not the selected one", () => {
+    const circle: TimelineElement = {
+      ...element,
+      id: "circle",
+      key: "scenes/main.html#circle",
+      domId: "circle",
+    };
+    usePlayerStore.setState({
+      elements: [element, circle],
+      gsapAnimations: new Map([["scenes/main.html#circle", [otherKeyframedAnimation]]]),
+      keyframeCache: new Map([
+        // Decoy at the same clip-% under the selected element's key.
+        [
+          "box",
+          {
+            format: "percentage",
+            keyframes: [{ percentage: 100, tweenPercentage: 100, properties: { x: 420 } }],
+          },
+        ],
+        [
+          "scenes/main.html#circle",
+          {
+            format: "percentage",
+            keyframes: [
+              {
+                percentage: 100,
+                tweenPercentage: 100,
+                propertyGroup: "position",
+                animationId: otherKeyframedAnimation.id,
+                properties: { x: 420 },
+              },
+            ],
+          },
+        ],
+      ]),
+    });
+    const view = renderCallbacks();
+
+    act(() => {
+      view.callbacks.onMoveKeyframeToPlayhead?.("scenes/main.html#circle", 100);
+    });
+
+    expect(mocks.actions.handleGsapMoveKeyframeToPlayhead).toHaveBeenCalledWith(
+      otherKeyframedAnimation.id,
+      100,
+    );
+    view.unmount();
+  });
+
   it("keeps selected-element flat boundary deletion on the animation delete path", () => {
     const view = renderCallbacks();
 
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index c800528aee..e72d4bc7bd 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -143,12 +143,18 @@ export function useTimelineEditCallbacks({
       tweenPercentage?: number,
       animationId?: string,
       animations: GsapAnimation[] = selectedGsapAnimations,
+      elementKey?: string,
     ): { animId: string; tweenPct: number } | null => {
       const explicitTarget =
         propertyGroup !== undefined || tweenPercentage !== undefined || animationId !== undefined
           ? [{ percentage: pct, propertyGroup, tweenPercentage, animationId }]
           : undefined;
-      const cached = usePlayerStore.getState().keyframeCache.get(domEditSelection?.id ?? "");
+      // The clicked element's own cache when the caller knows it: the diamond
+      // context menu can open on an element that is not the selected one, and
+      // reading the selection's cache there resolves against the wrong element.
+      const cached = usePlayerStore
+        .getState()
+        .keyframeCache.get(elementKey ?? domEditSelection?.id ?? "");
       return resolveTimelineKeyframeTarget(
         pct,
         explicitTarget ?? cached?.keyframes ?? [],
@@ -198,7 +204,7 @@ export function useTimelineEditCallbacks({
       },
       onDeleteKeyframe: (elId, pct, group, tweenPct, animationId) => {
         const animations = resolveElementAnimations(elId);
-        const target = resolveKeyframeTarget(pct, group, tweenPct, animationId, animations);
+        const target = resolveKeyframeTarget(pct, group, tweenPct, animationId, animations, elId);
         if (!target) return;
         const element = usePlayerStore.getState().elements.find((el) => (el.key ?? el.id) === elId);
         if (!element) {
@@ -213,8 +219,15 @@ export function useTimelineEditCallbacks({
         });
       },
       // Retime the keyframe to the playhead, preserving its value + ease.
-      onMoveKeyframeToPlayhead: (_elId, pct, group, tweenPct, animationId) => {
-        const target = resolveKeyframeTarget(pct, group, tweenPct, animationId);
+      onMoveKeyframeToPlayhead: (elId, pct, group, tweenPct, animationId) => {
+        const target = resolveKeyframeTarget(
+          pct,
+          group,
+          tweenPct,
+          animationId,
+          resolveElementAnimations(elId),
+          elId,
+        );
         if (target) handleGsapMoveKeyframeToPlayhead(target.animId, target.tweenPct);
       },
       // Drag-to-retime. The diamond reports clip-%s; resolveKeyframeTarget gives

From 3f93794fa669575985747f129fbfa3b6021cf786 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 00:06:20 +0200
Subject: [PATCH 083/125] fix(studio): resolve lane-header removal against the
 clicked element

The lane-header keyframe toggle fires on whichever element owns the lane,
which need not be the selected one. The remove path looked the animation up
in the selected element's animations, so a non-selected element's flat tween
missed and silently took the remove-one-keyframe branch, stranding the tween
instead of deleting it.
---
 .../nle/useTimelineEditCallbacks.test.tsx     | 35 +++++++++++++++++++
 .../nle/useTimelineEditCallbacks.ts           |  5 ++-
 2 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
index a06b18ece8..cf240afa9b 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -330,6 +330,41 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
+  // The lane-header toggle fires on whichever element owns the lane, which need
+  // not be the selected one. Looking the flat tween up in the selected element's
+  // animations misses, and the miss silently takes the remove-one-keyframe
+  // branch, which strands the flat tween instead of deleting it.
+  it("removes a non-selected element's flat tween through that element's own animations", async () => {
+    const circle: TimelineElement = {
+      ...element,
+      id: "circle",
+      key: "scenes/main.html#circle",
+      domId: "circle",
+    };
+    usePlayerStore.setState({
+      elements: [element, circle],
+      gsapAnimations: new Map([["scenes/main.html#circle", [otherFlatAnimation]]]),
+    });
+    const view = renderCallbacks();
+
+    await act(async () => {
+      await view.callbacks.onTogglePropertyGroupKeyframe?.(circle, {
+        animationId: otherFlatAnimation.id,
+        propertyGroup: "position",
+        tweenPercentage: 0,
+        properties: { x: 0 },
+        remove: true,
+      });
+    });
+
+    expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(
+      otherFlatAnimation.id,
+      mocks.selection,
+    );
+    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
   it("keeps authored interior deletion on the per-keyframe path", () => {
     mocks.animations = [authoredInteriorAnimation()];
     usePlayerStore.setState({ gsapAnimations: new Map([["box", mocks.animations]]) });
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index e72d4bc7bd..0ac9a32743 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -324,10 +324,13 @@ export function useTimelineEditCallbacks({
         const selection = await buildDomSelectionForTimelineElement(element);
         if (!selection) return;
         if (target.remove) {
+          // The clicked element's animations, not the selected element's: this
+          // lookup decides delete-the-flat-tween vs remove-one-keyframe, and a
+          // miss silently takes the keyframe branch, stranding the flat tween.
           removeKeyframeTarget(
             target.animationId,
             target.tweenPercentage,
-            selectedGsapAnimations,
+            resolveElementAnimations(element.key ?? element.id),
             selection,
           );
           return;

From 8f66b06d12e9deb25329e7aefe5054763df297b7 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 01:14:36 +0200
Subject: [PATCH 084/125] fix(studio): retime the dragged element's own
 keyframe

Drag-to-retime resolved the dragged diamond against the selected element's
animations and committed through the selected element's DOM selection, so
dragging a diamond on a non-selected clip retimed the wrong tween. It now
resolves against the clicked element's animations and commits through that
element's selection, matching the delete path.

The three diamond callbacks also take the TimelineKeyframeTarget they already
had instead of five positional fields, and the two copies of the
sourceFile#domId split share splitTimelineElementKey.
---
 .../nle/useTimelineEditCallbacks.test.tsx     | 121 ++++++++++++++----
 .../nle/useTimelineEditCallbacks.ts           |  75 ++++++-----
 .../components/TimelineClipDiamonds.tsx       |  11 +-
 .../src/player/components/TimelineLanes.tsx   |   3 +-
 .../player/components/TimelineOverlays.tsx    |   4 +-
 .../player/components/timelineCallbacks.ts    |  24 +---
 .../hooks/useExpandedTimelineElements.ts      |   9 +-
 .../src/player/lib/timelineElementHelpers.ts  |  14 ++
 8 files changed, 166 insertions(+), 95 deletions(-)

diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
index cf240afa9b..dec72f7b13 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -167,7 +167,16 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     const view = renderCallbacks();
 
     act(() => {
-      view.callbacks.onMoveKeyframe?.("box", 0, 25, "position", 0, flatAnimation.id);
+      view.callbacks.onMoveKeyframe?.(
+        "box",
+        {
+          percentage: 0,
+          propertyGroup: "position",
+          tweenPercentage: 0,
+          animationId: flatAnimation.id,
+        },
+        25,
+      );
     });
 
     expect(mocks.actions.handleGsapMoveKeyframe).not.toHaveBeenCalled();
@@ -189,13 +198,12 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     const view = renderCallbacks();
 
     await act(async () => {
-      view.callbacks.onDeleteKeyframe?.(
-        "scenes/main.html#circle",
-        0,
-        "position",
-        0,
-        otherFlatAnimation.id,
-      );
+      view.callbacks.onDeleteKeyframe?.("scenes/main.html#circle", {
+        percentage: 0,
+        propertyGroup: "position",
+        tweenPercentage: 0,
+        animationId: otherFlatAnimation.id,
+      });
       await Promise.resolve();
       await Promise.resolve();
     });
@@ -223,13 +231,12 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     const view = renderCallbacks();
 
     await act(async () => {
-      view.callbacks.onDeleteKeyframe?.(
-        "scenes/main.html#circle",
-        100,
-        "position",
-        100,
-        otherKeyframedAnimation.id,
-      );
+      view.callbacks.onDeleteKeyframe?.("scenes/main.html#circle", {
+        percentage: 100,
+        propertyGroup: "position",
+        tweenPercentage: 100,
+        animationId: otherKeyframedAnimation.id,
+      });
       await Promise.resolve();
       await Promise.resolve();
     });
@@ -287,7 +294,7 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     const view = renderCallbacks();
 
     act(() => {
-      view.callbacks.onMoveKeyframeToPlayhead?.("scenes/main.html#circle", 100);
+      view.callbacks.onMoveKeyframeToPlayhead?.("scenes/main.html#circle", { percentage: 100 });
     });
 
     expect(mocks.actions.handleGsapMoveKeyframeToPlayhead).toHaveBeenCalledWith(
@@ -301,7 +308,12 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     const view = renderCallbacks();
 
     act(() => {
-      view.callbacks.onDeleteKeyframe?.("box", 0, "position", 0, flatAnimation.id);
+      view.callbacks.onDeleteKeyframe?.("box", {
+        percentage: 0,
+        propertyGroup: "position",
+        tweenPercentage: 0,
+        animationId: flatAnimation.id,
+      });
     });
 
     expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(flatAnimation.id);
@@ -371,7 +383,12 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     const view = renderCallbacks();
 
     act(() => {
-      view.callbacks.onDeleteKeyframe?.("box", 50, "position", 50, flatAnimation.id);
+      view.callbacks.onDeleteKeyframe?.("box", {
+        percentage: 50,
+        propertyGroup: "position",
+        tweenPercentage: 50,
+        animationId: flatAnimation.id,
+      });
     });
 
     expect(mocks.actions.handleGsapRemoveKeyframe).toHaveBeenCalledWith(flatAnimation.id, 50);
@@ -379,16 +396,74 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
-  it("keeps an authored interior drag on the per-keyframe move path", () => {
-    mocks.animations = [authoredInteriorAnimation()];
+  it("keeps an authored interior drag on the per-keyframe move path", async () => {
+    const authored = authoredInteriorAnimation();
+    mocks.animations = [authored];
+    usePlayerStore.setState({ gsapAnimations: new Map([["box", [authored]]]) });
     const view = renderCallbacks();
 
-    act(() => {
-      view.callbacks.onMoveKeyframe?.("box", 50, 75, "position", 50, flatAnimation.id);
+    await act(async () => {
+      await view.callbacks.onMoveKeyframe?.(
+        "box",
+        {
+          percentage: 50,
+          propertyGroup: "position",
+          tweenPercentage: 50,
+          animationId: authored.id,
+        },
+        75,
+      );
     });
 
-    expect(mocks.actions.handleGsapMoveKeyframe).toHaveBeenCalledWith(flatAnimation.id, 50, 75);
+    expect(mocks.actions.handleGsapMoveKeyframe).toHaveBeenCalledWith(
+      authored.id,
+      50,
+      75,
+      mocks.selection,
+    );
     expect(mocks.actions.handleGsapResizeKeyframedTween).not.toHaveBeenCalled();
     view.unmount();
   });
+
+  // A drag starts on whatever diamond the pointer is over, which need not be the
+  // selected element. Resolving against the selection would retime the selected
+  // element's tween and commit it through the selected element's file.
+  it("retimes a non-selected element's keyframe through that element's own selection", async () => {
+    const circle: TimelineElement = {
+      ...element,
+      id: "circle",
+      key: "scenes/main.html#circle",
+      domId: "circle",
+      sourceFile: "scenes/main.html",
+    };
+    const circleSelection = { id: "circle", selector: "#circle", sourceFile: "scenes/main.html" };
+    const circleAnimation = { ...authoredInteriorAnimation(), id: "circle-to-0-position" };
+    usePlayerStore.setState({
+      elements: [element, circle],
+      gsapAnimations: new Map([["scenes/main.html#circle", [circleAnimation]]]),
+    });
+    mocks.actions.buildDomSelectionForTimelineElement.mockResolvedValue(circleSelection);
+    const view = renderCallbacks();
+
+    await act(async () => {
+      await view.callbacks.onMoveKeyframe?.(
+        "scenes/main.html#circle",
+        {
+          percentage: 50,
+          propertyGroup: "position",
+          tweenPercentage: 50,
+          animationId: circleAnimation.id,
+        },
+        75,
+      );
+    });
+
+    expect(mocks.actions.handleGsapMoveKeyframe).toHaveBeenCalledWith(
+      circleAnimation.id,
+      50,
+      75,
+      circleSelection,
+    );
+    view.unmount();
+  });
 });
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index 0ac9a32743..fa80561bb9 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -14,6 +14,8 @@ import { resolveClipTimingBasis } from "../../hooks/useGsapTweenCache";
 import { resolveKeyframeRetime } from "../editor/keyframeRetime";
 import type { DomEditSelection } from "../editor/domEditingTypes";
 import type { TimelineMoveOperation } from "../../hooks/timelineMoveAdapter";
+import { splitTimelineElementKey } from "../../player/lib/timelineElementHelpers";
+import type { TimelineKeyframeTarget } from "../../player/components/timelineKeyframeIdentity";
 
 export interface TimelineEditCallbackDeps {
   handleTimelineElementMove: (
@@ -117,14 +119,12 @@ export function useTimelineEditCallbacks({
   const resolveElementAnimations = useCallback(
     (elementKey: string): GsapAnimation[] => {
       const { gsapAnimations } = usePlayerStore.getState();
-      const hashIndex = elementKey.lastIndexOf("#");
-      const elementId = hashIndex === -1 ? elementKey : elementKey.slice(hashIndex + 1);
-      const sourceFile =
-        hashIndex === -1 ? (activeCompPath ?? "index.html") : elementKey.slice(0, hashIndex);
+      const { sourceFile, domId } = splitTimelineElementKey(elementKey);
+      const scope = sourceFile ?? activeCompPath ?? "index.html";
       return (
-        gsapAnimations.get(`${sourceFile}#${elementId}`) ??
-        gsapAnimations.get(`index.html#${elementId}`) ??
-        gsapAnimations.get(elementId) ??
+        gsapAnimations.get(`${scope}#${domId}`) ??
+        gsapAnimations.get(`index.html#${domId}`) ??
+        gsapAnimations.get(domId) ??
         []
       );
     },
@@ -136,19 +136,15 @@ export function useTimelineEditCallbacks({
   // diamond reports a clip-% but the script ops key on the tween-%. Prefers the
   // anim in the keyframe's property group, falling back to the first keyframed one.
   const resolveKeyframeTarget = useCallback(
-    // fallow-ignore-next-line complexity
     (
-      pct: number,
-      propertyGroup?: string,
-      tweenPercentage?: number,
-      animationId?: string,
+      target: TimelineKeyframeTarget,
       animations: GsapAnimation[] = selectedGsapAnimations,
       elementKey?: string,
     ): { animId: string; tweenPct: number } | null => {
-      const explicitTarget =
-        propertyGroup !== undefined || tweenPercentage !== undefined || animationId !== undefined
-          ? [{ percentage: pct, propertyGroup, tweenPercentage, animationId }]
-          : undefined;
+      const carriesIdentity =
+        target.propertyGroup !== undefined ||
+        target.tweenPercentage !== undefined ||
+        target.animationId !== undefined;
       // The clicked element's own cache when the caller knows it: the diamond
       // context menu can open on an element that is not the selected one, and
       // reading the selection's cache there resolves against the wrong element.
@@ -156,8 +152,8 @@ export function useTimelineEditCallbacks({
         .getState()
         .keyframeCache.get(elementKey ?? domEditSelection?.id ?? "");
       return resolveTimelineKeyframeTarget(
-        pct,
-        explicitTarget ?? cached?.keyframes ?? [],
+        target.percentage,
+        carriesIdentity ? [target] : (cached?.keyframes ?? []),
         animations,
       );
     },
@@ -202,9 +198,9 @@ export function useTimelineEditCallbacks({
         if (!anim) return;
         handleGsapRemoveAllKeyframes(anim.id);
       },
-      onDeleteKeyframe: (elId, pct, group, tweenPct, animationId) => {
+      onDeleteKeyframe: (elId, keyframe) => {
         const animations = resolveElementAnimations(elId);
-        const target = resolveKeyframeTarget(pct, group, tweenPct, animationId, animations, elId);
+        const target = resolveKeyframeTarget(keyframe, animations, elId);
         if (!target) return;
         const element = usePlayerStore.getState().elements.find((el) => (el.key ?? el.id) === elId);
         if (!element) {
@@ -219,15 +215,8 @@ export function useTimelineEditCallbacks({
         });
       },
       // Retime the keyframe to the playhead, preserving its value + ease.
-      onMoveKeyframeToPlayhead: (elId, pct, group, tweenPct, animationId) => {
-        const target = resolveKeyframeTarget(
-          pct,
-          group,
-          tweenPct,
-          animationId,
-          resolveElementAnimations(elId),
-          elId,
-        );
+      onMoveKeyframeToPlayhead: (elId, keyframe) => {
+        const target = resolveKeyframeTarget(keyframe, resolveElementAnimations(elId), elId);
         if (target) handleGsapMoveKeyframeToPlayhead(target.animId, target.tweenPct);
       },
       // Drag-to-retime. The diamond reports clip-%s; resolveKeyframeTarget gives
@@ -238,11 +227,17 @@ export function useTimelineEditCallbacks({
       // resizes the tween — position/duration grow so the dragged keyframe lands at
       // the drop while every other keyframe keeps its absolute time (value+ease too).
       // fallow-ignore-next-line complexity
-      onMoveKeyframe: async (_elId, fromClipPct, toClipPct, group, tweenPct, animationId) => {
-        const target = resolveKeyframeTarget(fromClipPct, group, tweenPct, animationId);
-        const sel = domEditSelection;
-        if (!target || !sel) return false;
-        const anim = selectedGsapAnimations.find((a) => a.id === target.animId);
+      onMoveKeyframe: async (elId, keyframe, toClipPct) => {
+        const animations = resolveElementAnimations(elId);
+        const target = resolveKeyframeTarget(keyframe, animations, elId);
+        if (!target) return false;
+        // The dragged diamond's OWN element, not the selected one: a drag on a
+        // non-selected clip has to read that clip's animations and commit
+        // through that clip's selection, or it retimes whatever is selected.
+        const element = usePlayerStore.getState().elements.find((el) => (el.key ?? el.id) === elId);
+        const sel = element ? await buildDomSelectionForTimelineElement(element) : domEditSelection;
+        if (!sel) return false;
+        const anim = animations.find((a) => a.id === target.animId);
         const tweenStart = anim ? resolveTweenStart(anim) : null;
         if (!anim || tweenStart === null) return false;
         // Synthesized flat endpoints are clip boundaries, not authored keyframes.
@@ -267,7 +262,7 @@ export function useTimelineEditCallbacks({
           dropAbsTime,
         });
         if (decision.kind === "move" && decision.toTweenPct != null) {
-          handleGsapMoveKeyframe(target.animId, target.tweenPct, decision.toTweenPct);
+          handleGsapMoveKeyframe(target.animId, target.tweenPct, decision.toTweenPct, sel);
         } else if (
           decision.kind === "resize" &&
           decision.pctRemap &&
@@ -280,15 +275,17 @@ export function useTimelineEditCallbacks({
               decision.position,
               decision.duration,
               decision.pctRemap,
+              sel,
             );
           } else {
             // resize-keyframed-tween requires an authored `keyframes` AST node
             // and intentionally no-ops for a flat tween. Update its real tween
             // window through the metadata writer (and SDK cutover path) instead.
-            handleGsapUpdateMeta(target.animId, {
-              position: decision.position,
-              duration: decision.duration,
-            });
+            handleGsapUpdateMeta(
+              target.animId,
+              { position: decision.position, duration: decision.duration },
+              sel,
+            );
           }
         } else {
           return false;
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 1a066d5d03..09320bdc57 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -48,12 +48,13 @@ interface TimelineClipDiamondsProps {
   onShiftClickKeyframe?: (elementId: string, percentage: number) => void;
   onContextMenuKeyframe?: (e: React.MouseEvent, elementId: string, percentage: number) => void;
   /** Drag-to-retime: move a keyframe to a new time, preserving its value + ease.
-   *  Both percentages are clip-relative: `fromClipPercentage` identifies the
-   *  dragged keyframe, `toClipPercentage` is the neighbour-clamped drop position.
-   *  The handler decides move (within the tween) vs resize (past its boundary). */
+   *  `keyframe` identifies the dragged keyframe (clip-relative percentage plus
+   *  whatever animation identity the row carries); `toClipPercentage` is the
+   *  neighbour-clamped drop position, also clip-relative. The handler decides
+   *  move (within the tween) vs resize (past its boundary). */
   onMoveKeyframe?: (
     elementId: string,
-    fromClipPercentage: number,
+    keyframe: TimelineKeyframeTarget,
     toClipPercentage: number,
   ) => Promise<boolean>;
   /** Open the segment ease editor for the hovered mid-point button — available on
@@ -549,7 +550,7 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds(
       onMoveKeyframe={
         props.onMoveKeyframe
           ? (target, toClipPercentage) =>
-              props.onMoveKeyframe?.(props.elementId, target.percentage, toClipPercentage) ??
+              props.onMoveKeyframe?.(props.elementId, target, toClipPercentage) ??
               Promise.resolve(false)
           : undefined
       }
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index 13707c05c7..8437bb64e3 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -3,6 +3,7 @@ import { Eye, EyeSlash } from "@phosphor-icons/react";
 import { BeatStrip, BeatBackgroundLines } from "./BeatStrip";
 import { TimelineClip } from "./TimelineClip";
 import { TimelineClipDiamonds } from "./TimelineClipDiamonds";
+import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
 import type { MusicBeatAnalysis } from "@hyperframes/core/beats";
 import { getTimelineEditCapabilities, resolveBlockedTimelineEditIntent } from "./timelineEditing";
 import type { TimelineTheme } from "./timelineTheme";
@@ -76,7 +77,7 @@ export interface TimelineLaneBaseProps {
   onContextMenuKeyframe?: (e: React.MouseEvent, elementId: string, percentage: number) => void;
   onMoveKeyframe?: (
     elementId: string,
-    fromClipPercentage: number,
+    keyframe: TimelineKeyframeTarget,
     toClipPercentage: number,
   ) => Promise<boolean>;
   onContextMenuClip?: (e: React.MouseEvent, element: TimelineElement) => void;
diff --git a/packages/studio/src/player/components/TimelineOverlays.tsx b/packages/studio/src/player/components/TimelineOverlays.tsx
index bd0896e0be..44e3120747 100644
--- a/packages/studio/src/player/components/TimelineOverlays.tsx
+++ b/packages/studio/src/player/components/TimelineOverlays.tsx
@@ -106,12 +106,12 @@ export function TimelineOverlays({
         <KeyframeDiamondContextMenu
           state={kfContextMenu}
           onClose={() => setKfContextMenu(null)}
-          onDelete={(elId, pct) => onDeleteKeyframe?.(elId, pct)}
+          onDelete={(elId, pct) => onDeleteKeyframe?.(elId, { percentage: pct })}
           onDeleteAll={(elId) => onDeleteAllKeyframes?.(elId)}
           onChangeEase={(elId, pct, ease) => onChangeKeyframeEase?.(elId, pct, ease)}
           onMoveToPlayhead={
             onMoveKeyframeToPlayhead
-              ? (elId, pct) => onMoveKeyframeToPlayhead(elId, pct)
+              ? (elId, pct) => onMoveKeyframeToPlayhead(elId, { percentage: pct })
               : undefined
           }
           onCopyProperties={(elId, pct) => {
diff --git a/packages/studio/src/player/components/timelineCallbacks.ts b/packages/studio/src/player/components/timelineCallbacks.ts
index ced618e716..204302e4bd 100644
--- a/packages/studio/src/player/components/timelineCallbacks.ts
+++ b/packages/studio/src/player/components/timelineCallbacks.ts
@@ -4,6 +4,7 @@ import type { TimelineElement } from "../store/playerStore";
 import type { TimelineMoveOperation } from "../../hooks/timelineMoveAdapter";
 import type { BlockedTimelineEditIntent } from "./timelineEditing";
 import type { PropertyGroupName } from "@hyperframes/core/gsap-parser";
+import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
 
 export interface TimelinePropertyGroupKeyframeToggle {
   animationId: string;
@@ -71,29 +72,16 @@ export interface TimelineEditCallbacks {
   onSplitElement?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
   onRazorSplit?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
   onRazorSplitAll?: (splitTime: number) => Promise<void> | void;
-  onDeleteKeyframe?: (
-    elementId: string,
-    percentage: number,
-    propertyGroup?: string,
-    tweenPercentage?: number,
-    animationId?: string,
-  ) => void;
+  onDeleteKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
   onDeleteAllKeyframes?: (elementId: string) => void;
   onChangeKeyframeEase?: (elementId: string, percentage: number, ease: string) => void;
-  onMoveKeyframeToPlayhead?: (
-    elementId: string,
-    percentage: number,
-    propertyGroup?: string,
-    tweenPercentage?: number,
-    animationId?: string,
-  ) => void;
+  onMoveKeyframeToPlayhead?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
+  /** Drag-to-retime: `keyframe` identifies the dragged keyframe (its percentage
+   *  is clip-relative), `toClipPercentage` is the neighbour-clamped drop. */
   onMoveKeyframe?: (
     elementId: string,
-    fromClipPercentage: number,
+    keyframe: TimelineKeyframeTarget,
     toClipPercentage: number,
-    propertyGroup?: string,
-    tweenPercentage?: number,
-    animationId?: string,
   ) => Promise<boolean>;
   onToggleKeyframeAtPlayhead?: (element: TimelineElement) => void;
   onTogglePropertyGroupKeyframe?: (
diff --git a/packages/studio/src/player/hooks/useExpandedTimelineElements.ts b/packages/studio/src/player/hooks/useExpandedTimelineElements.ts
index a5e31e71bb..d0ccaa2687 100644
--- a/packages/studio/src/player/hooks/useExpandedTimelineElements.ts
+++ b/packages/studio/src/player/hooks/useExpandedTimelineElements.ts
@@ -2,7 +2,7 @@ import { useMemo } from "react";
 import { usePlayerStore, type TimelineElement, type DomClipChild } from "../store/playerStore";
 import type { ClipManifestClip } from "../lib/playbackTypes";
 import { createTimelineElementFromManifestClip } from "../lib/timelineDOM";
-import { buildTimelineElementKey } from "../lib/timelineElementHelpers";
+import { buildTimelineElementKey, splitTimelineElementKey } from "../lib/timelineElementHelpers";
 
 function findTopLevelAncestor(id: string, parentMap: Map<string, string>): string | null {
   let current = parentMap.get(id);
@@ -19,18 +19,13 @@ function findTopLevelAncestor(id: string, parentMap: Map<string, string>): strin
   return current;
 }
 
-function extractDomId(key: string): string {
-  const hashIdx = key.lastIndexOf("#");
-  return hashIdx >= 0 ? key.slice(hashIdx + 1) : key;
-}
-
 function resolveRawId(
   selectedId: string | null,
   manifest: ClipManifestClip[],
   parentMap: Map<string, string>,
 ): string | null {
   if (!selectedId) return null;
-  const rawId = extractDomId(selectedId);
+  const rawId = splitTimelineElementKey(selectedId).domId;
   if (parentMap.has(rawId)) return rawId;
   if (parentMap.has(selectedId)) return selectedId;
   const clip = manifest.find((c) => c.label === selectedId || c.label === rawId);
diff --git a/packages/studio/src/player/lib/timelineElementHelpers.ts b/packages/studio/src/player/lib/timelineElementHelpers.ts
index b3d6482ae1..3232482917 100644
--- a/packages/studio/src/player/lib/timelineElementHelpers.ts
+++ b/packages/studio/src/player/lib/timelineElementHelpers.ts
@@ -298,6 +298,20 @@ export function buildTimelineElementKey(params: {
   return `${scope}:${params.id}:${params.fallbackIndex}`;
 }
 
+/**
+ * Inverse of {@link buildTimelineElementKey} for the `sourceFile#domId` form.
+ * A key with no `#` is a bare dom id and carries no source file of its own, so
+ * the caller supplies the scope it wants to look that id up in.
+ */
+export function splitTimelineElementKey(key: string): {
+  sourceFile: string | null;
+  domId: string;
+} {
+  const hashIndex = key.lastIndexOf("#");
+  if (hashIndex < 0) return { sourceFile: null, domId: key };
+  return { sourceFile: key.slice(0, hashIndex), domId: key.slice(hashIndex + 1) };
+}
+
 export function buildTimelineElementIdentity(params: {
   preferredId?: string | null;
   label: string;

From a423c9300eed506ae344f05c7bb86fb18e4fe85e Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 02:23:27 +0200
Subject: [PATCH 085/125] refactor(studio): read animation cache keys through
 their owner

The timeline-element animation lookup rebuilt the three cache-key variants
by hand. elementCacheKeys already owns that list for the writers, so this
reader takes it from there instead of drifting from it.
---
 .../src/components/nle/useTimelineEditCallbacks.ts | 14 ++++++++------
 .../studio/src/hooks/gsapKeyframeCacheHelpers.ts   |  3 ++-
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index fa80561bb9..f6e6f68f9e 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -11,6 +11,7 @@ import {
 } from "../../contexts/DomEditContext";
 import { resolveTweenStart, resolveTweenDuration } from "../../utils/globalTimeCompiler";
 import { resolveClipTimingBasis } from "../../hooks/useGsapTweenCache";
+import { elementCacheKeys } from "../../hooks/gsapKeyframeCacheHelpers";
 import { resolveKeyframeRetime } from "../editor/keyframeRetime";
 import type { DomEditSelection } from "../editor/domEditingTypes";
 import type { TimelineMoveOperation } from "../../hooks/timelineMoveAdapter";
@@ -121,12 +122,13 @@ export function useTimelineEditCallbacks({
       const { gsapAnimations } = usePlayerStore.getState();
       const { sourceFile, domId } = splitTimelineElementKey(elementKey);
       const scope = sourceFile ?? activeCompPath ?? "index.html";
-      return (
-        gsapAnimations.get(`${scope}#${domId}`) ??
-        gsapAnimations.get(`index.html#${domId}`) ??
-        gsapAnimations.get(domId) ??
-        []
-      );
+      // elementCacheKeys owns the key-variant list the writers use; reading it
+      // back by hand here is how the two sides drift.
+      for (const key of elementCacheKeys(scope, domId)) {
+        const animations = gsapAnimations.get(key);
+        if (animations) return animations;
+      }
+      return [];
     },
     [activeCompPath],
   );
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index 1e806a0298..efe0941df2 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -113,7 +113,8 @@ export function clearKeyframeCacheForFile(sourceFile: string): void {
   }
 }
 
-function elementCacheKeys(sourceFile: string, elementId: string): string[] {
+/** Every cache key a write for this element sets, in read-preference order. */
+export function elementCacheKeys(sourceFile: string, elementId: string): string[] {
   return sourceFile === "index.html"
     ? [`index.html#${elementId}`, elementId]
     : [`${sourceFile}#${elementId}`, `index.html#${elementId}`, elementId];

From be3b1e3d40c975fe784170be33299a78ef09cc0b Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 17:01:52 +0200
Subject: [PATCH 086/125] fix(studio): harden keyframe editing semantics

---
 .../studio-server/src/routes/files.test.ts    |  41 +++++
 packages/studio-server/src/routes/files.ts    |  15 ++
 .../src/components/TimelineToolbar.test.tsx   |  51 +++++-
 .../studio/src/components/TimelineToolbar.tsx | 123 ++++++++++----
 .../components/editor/MotionPathOverlay.tsx   |  10 +-
 .../components/editor/keyframeRetime.test.ts  |  36 ++---
 .../propertyPanelFlatTextSection.test.tsx     |  48 ++++--
 .../editor/propertyPanelFlatTextSection.tsx   |  28 +++-
 .../nle/useTimelineEditCallbacks.test.tsx     | 147 +++++++++++------
 .../nle/useTimelineEditCallbacks.ts           |  91 ++++++-----
 .../src/hooks/deleteSelectedKeyframes.ts      |  29 +++-
 .../src/hooks/gsapDragPositionCommit.ts       |  56 +++++++
 .../src/hooks/gsapRuntimeBridge.test.ts       | 100 ++++++++++++
 .../studio/src/hooks/gsapScriptCommitTypes.ts |   2 +
 packages/studio/src/hooks/gsapShared.test.ts  |  16 ++
 packages/studio/src/hooks/gsapShared.ts       |  22 ++-
 .../src/hooks/timelineEditingHelpers.test.ts  |  48 ++++++
 packages/studio/src/hooks/useDomEditWiring.ts |   4 +-
 .../src/hooks/useEnableKeyframes.test.ts      | 109 +++++++++++++
 .../studio/src/hooks/useEnableKeyframes.ts    | 152 ++++++++++++------
 .../src/hooks/useGsapKeyframeOps.test.tsx     |  70 +++++++-
 .../studio/src/hooks/useGsapKeyframeOps.ts    |  40 +++--
 .../src/hooks/useGsapScriptCommits.test.tsx   |  21 +++
 .../studio/src/hooks/useGsapScriptCommits.ts  |   2 +
 .../hooks/useGsapSelectionHandlers.test.tsx   |  23 ++-
 .../src/hooks/useGsapSelectionHandlers.ts     |  32 ++--
 .../studio/src/hooks/useStudioTestHooks.ts    |  16 +-
 .../components/KeyframeDiamondContextMenu.tsx |  10 +-
 .../studio/src/player/components/Timeline.tsx |  11 +-
 .../components/TimelineClipDiamonds.test.tsx  |  48 ++++++
 .../components/TimelineClipDiamonds.tsx       | 123 ++++++++------
 .../components/TimelinePropertyLanes.test.tsx |  23 ++-
 .../player/components/timelineCallbacks.ts    |   4 +-
 .../timelineKeyframeIdentity.test.ts          |  42 +++++
 .../components/timelineKeyframeIdentity.ts    |  50 +++++-
 .../components/useTimelineKeyframeHandlers.ts |   8 +-
 .../src/utils/globalTimeCompiler.test.ts      |  10 ++
 .../studio/src/utils/globalTimeCompiler.ts    |   6 +-
 .../src/utils/keyframeSelection.test.ts       |  45 ------
 .../studio/src/utils/keyframeSelection.ts     |  29 ----
 .../e2e/fixtures/design-panel-qa/index.html   |   2 +-
 41 files changed, 1312 insertions(+), 431 deletions(-)
 create mode 100644 packages/studio/src/player/components/timelineKeyframeIdentity.test.ts
 delete mode 100644 packages/studio/src/utils/keyframeSelection.test.ts
 delete mode 100644 packages/studio/src/utils/keyframeSelection.ts

diff --git a/packages/studio-server/src/routes/files.test.ts b/packages/studio-server/src/routes/files.test.ts
index f2db23a3d6..ffd9f61a8c 100644
--- a/packages/studio-server/src/routes/files.test.ts
+++ b/packages/studio-server/src/routes/files.test.ts
@@ -1830,6 +1830,47 @@ tl.to("#box", { opacity: 1, duration: 1 }, 0);
     expect(result.after).not.toContain("data-hf-studio-rotation");
   });
 
+  it("replace-with-keyframes preserves per-segment easing for exact temporal keyframes", async () => {
+    const projectDir = createProjectDir();
+    const PATH_COMP = `<!DOCTYPE html><html><body data-duration="32">
+<div id="box"></div>
+<script data-hyperframes-gsap>
+const tl = gsap.timeline();
+tl.to("#box", { motionPath: { path: [{ x: 0, y: 0 }, { x: 100, y: 100 }] }, duration: 16.055, ease: "power1.inOut" }, 12.17);
+</script>
+</body></html>`;
+    writeHtml(projectDir, "path.html", PATH_COMP);
+    const app = new Hono();
+    registerFileRoutes(app, createAdapter(projectDir));
+
+    const anim = await getFirstAnimation(app, "path.html");
+    const res = await app.request("http://localhost/projects/demo/gsap-mutations/path.html", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        type: "replace-with-keyframes",
+        animationId: anim.id,
+        targetSelector: "#box",
+        position: 12.17,
+        duration: 16.055,
+        keyframes: [
+          { percentage: 0, properties: { x: 0, y: 0 } },
+          { percentage: 23.2, properties: { x: 25, y: 30 } },
+          { percentage: 100, properties: { x: 100, y: 100 } },
+        ],
+        ease: "none",
+      }),
+    });
+    const result = (await res.json()) as { ok: boolean; after: string };
+
+    expect(res.status).toBe(200);
+    expect(result.ok).toBe(true);
+    expect(result.after).toContain('"23.2%"');
+    expect(result.after).toContain('easeEach: "power1.inOut"');
+    expect(result.after).toContain('ease: "none"');
+    expect(result.after).not.toContain("motionPath");
+  });
+
   it("edits a template-wrapped tween in place, preserving gsap.set and the IIFE", async () => {
     const projectDir = createProjectDir();
     writeComp(projectDir, "scene.html", TEMPLATE_COMP);
diff --git a/packages/studio-server/src/routes/files.ts b/packages/studio-server/src/routes/files.ts
index 01e7c3f841..3ec64bbff1 100644
--- a/packages/studio-server/src/routes/files.ts
+++ b/packages/studio-server/src/routes/files.ts
@@ -997,6 +997,7 @@ export type GsapMutationRequest =
         auto?: boolean;
       }>;
       ease?: string;
+      easeEach?: string;
     }
   | {
       type: "split-animations";
@@ -1052,6 +1053,18 @@ export type GsapMutationRequest =
 
 type GsapMutationResult = string | { script: string; skippedSelectors: string[] };
 
+function resolveReplacementEaseEach(
+  scriptText: string,
+  request: { animationId: string; easeEach?: string },
+): string | undefined {
+  if (request.easeEach !== undefined) return request.easeEach;
+  const original = parseGsapScriptAcorn(scriptText).animations.find(
+    (animation) => animation.id === request.animationId,
+  );
+  if (!original?.arcPath?.enabled) return undefined;
+  return original?.keyframes?.easeEach ?? original?.ease;
+}
+
 // Mutations that can change a position tween's first keyframe (value/existence/timing)
 // and therefore require the pre-keyframe hold-`set`s to be re-synced afterwards.
 // `syncPositionHoldsBeforeKeyframes` rebuilds all `hf-hold` sets from scratch: it acts
@@ -1507,6 +1520,7 @@ function executeGsapMutationAcorn(
         body.duration,
         body.keyframes,
         body.ease,
+        resolveReplacementEaseEach(block.scriptText, body),
       );
       return added.script;
     }
@@ -1877,6 +1891,7 @@ async function executeGsapMutationRecast(
         body.duration,
         body.keyframes,
         body.ease,
+        resolveReplacementEaseEach(block.scriptText, body),
       );
       return added.script;
     }
diff --git a/packages/studio/src/components/TimelineToolbar.test.tsx b/packages/studio/src/components/TimelineToolbar.test.tsx
index 0c21e5e043..0050dcfc95 100644
--- a/packages/studio/src/components/TimelineToolbar.test.tsx
+++ b/packages/studio/src/components/TimelineToolbar.test.tsx
@@ -2,8 +2,10 @@
 
 import React, { act } from "react";
 import { createRoot } from "react-dom/client";
-import { afterEach, describe, expect, it } from "vitest";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { usePlayerStore } from "../player/store/playerStore";
+import { makeSelection } from "../hooks/domSelectionTestHarness";
 import { TimelineToolbar } from "./TimelineToolbar";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
@@ -13,12 +15,14 @@ afterEach(() => {
   usePlayerStore.setState({ autoKeyframeEnabled: true });
 });
 
-function renderToolbar() {
+function renderToolbar(
+  domEditSession?: React.ComponentProps<typeof TimelineToolbar>["domEditSession"],
+) {
   const host = document.createElement("div");
   document.body.append(host);
   const root = createRoot(host);
   act(() => {
-    root.render(<TimelineToolbar />);
+    root.render(<TimelineToolbar domEditSession={domEditSession} />);
   });
   return { host, root };
 }
@@ -54,3 +58,44 @@ describe("TimelineToolbar — auto-keyframe toggle (#1808)", () => {
     act(() => root.unmount());
   });
 });
+describe("TimelineToolbar — motion path endpoints", () => {
+  it("does not advertise a destructive keyframe toggle for a required endpoint", () => {
+    usePlayerStore.setState({ currentTime: 10 });
+    const animation: GsapAnimation = {
+      id: "#el-to-0-position",
+      targetSelector: "#el",
+      method: "to",
+      position: 0,
+      duration: 10,
+      properties: {},
+      keyframes: {
+        format: "object-array",
+        keyframes: [
+          { percentage: 0, properties: { x: 0, y: 0 } },
+          { percentage: 100, properties: { x: 100, y: 0 } },
+        ],
+      },
+      arcPath: {
+        enabled: true,
+        autoRotate: false,
+        segments: [{ curviness: 1 }],
+      },
+    };
+    const element = document.createElement("div");
+    element.id = "el";
+    const session = {
+      domEditSelection: makeSelection("Element", element),
+      selectedGsapAnimations: [animation],
+      handleGsapAddAnimation: vi.fn(),
+      handleGsapConvertToKeyframes: vi.fn(),
+      handleGsapRemoveKeyframe: vi.fn(),
+    } satisfies NonNullable<React.ComponentProps<typeof TimelineToolbar>["domEditSession"]>;
+
+    const { host, root } = renderToolbar(session);
+    const button = host.querySelector<HTMLButtonElement>(
+      'button[aria-label="Motion path endpoint"]',
+    );
+    expect(button?.disabled).toBe(true);
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/components/TimelineToolbar.tsx b/packages/studio/src/components/TimelineToolbar.tsx
index 1e314ed4ef..43416414d5 100644
--- a/packages/studio/src/components/TimelineToolbar.tsx
+++ b/packages/studio/src/components/TimelineToolbar.tsx
@@ -36,6 +36,60 @@ interface TimelineToolbarProps {
   onSplitElement?: (element: TimelineElement, splitTime: number) => void;
 }
 
+interface KeyframeToggleState {
+  state: "active" | "inactive" | "none";
+  isMotionPath: boolean;
+  pathEndpoint: boolean;
+  willExtend: boolean;
+}
+
+const NO_KEYFRAME_TOGGLE: KeyframeToggleState = {
+  state: "none",
+  isMotionPath: false,
+  pathEndpoint: false,
+  willExtend: false,
+};
+
+function isMotionPathEndpoint(animation: GsapAnimation | undefined, percentage: number): boolean {
+  if (!animation?.keyframes) return false;
+  const keyframes = animation.keyframes.keyframes;
+  return (
+    Math.abs((keyframes[0]?.percentage ?? -Infinity) - percentage) <= 1 ||
+    Math.abs((keyframes.at(-1)?.percentage ?? Infinity) - percentage) <= 1
+  );
+}
+
+function resolveKeyframeToggleState(
+  session: DomEditSessionSlice | undefined,
+  currentTime: number,
+): KeyframeToggleState {
+  if (!session?.domEditSelection) return NO_KEYFRAME_TOGGLE;
+  const arcAnimation = session.selectedGsapAnimations.find(
+    (animation) => animation.arcPath && animation.keyframes,
+  );
+  const animation =
+    arcAnimation ??
+    session.selectedGsapAnimations.find((candidate) => candidate.keyframes && !candidate.arcPath);
+  if (!animation?.keyframes) return NO_KEYFRAME_TOGGLE;
+
+  const isMotionPath = Boolean(arcAnimation);
+  if (!isPlayheadWithinTween(animation, currentTime)) {
+    return { state: "inactive", isMotionPath, pathEndpoint: false, willExtend: true };
+  }
+
+  const percentage = computeElementPercentage(currentTime, session.domEditSelection, animation);
+  const pathEndpoint = isMotionPathEndpoint(arcAnimation, percentage);
+  const active = animation.keyframes.keyframes.some(
+    (keyframe) => Math.abs(keyframe.percentage - percentage) <= 1,
+  );
+  return {
+    state: pathEndpoint ? "none" : active ? "active" : "inactive",
+    isMotionPath,
+    pathEndpoint,
+    willExtend: false,
+  };
+}
+
 function useKeyframeToggle(session?: DomEditSessionSlice) {
   const currentTime = usePlayerStore((s) => s.currentTime);
   const sessionRef = useRef(session);
@@ -45,31 +99,12 @@ function useKeyframeToggle(session?: DomEditSessionSlice) {
     sessionRef as React.RefObject<EnableKeyframesSession | undefined>,
   );
 
-  if (!session) return { state: "none" as const, onToggle: undefined };
-
-  const sel = session.domEditSelection;
-  const anims = session.selectedGsapAnimations;
-  const kfAnim = anims.find((a) => a.keyframes);
-
-  let state: "active" | "inactive" | "none" = "none";
-  // Outside the tween, clicking extends the animation to the playhead rather than
-  // toggling a (clamped) edge keyframe — so the button stays an "add" affordance.
-  let willExtend = false;
-  if (kfAnim?.keyframes && sel) {
-    if (!isPlayheadWithinTween(kfAnim, currentTime)) {
-      state = "inactive";
-      willExtend = true;
-    } else {
-      // Tween-relative percentage (not the clip range) so the button state matches
-      // where the keyframe would actually land.
-      const pct = computeElementPercentage(currentTime, sel, kfAnim);
-      state = kfAnim.keyframes.keyframes.some((k) => Math.abs(k.percentage - pct) <= 1)
-        ? "active"
-        : "inactive";
-    }
-  }
+  const toggleState = resolveKeyframeToggleState(session, currentTime);
 
-  return { state, willExtend, onToggle: sel ? onToggle : undefined };
+  return {
+    ...toggleState,
+    onToggle: session?.domEditSelection && !toggleState.pathEndpoint ? onToggle : undefined,
+  };
 }
 
 // fallow-ignore-next-line complexity
@@ -91,6 +126,8 @@ export function TimelineToolbar({ domEditSession, onSplitElement }: TimelineTool
   const displayedTimelineZoomPercent = getTimelineZoomPercent(zoomMode, manualZoomPercent);
   const {
     state: keyframeState,
+    isMotionPath: keyframeIsMotionPath,
+    pathEndpoint: keyframePathEndpoint,
     willExtend: keyframeWillExtend,
     onToggle: onToggleKeyframe,
   } = useKeyframeToggle(domEditSession);
@@ -180,15 +217,23 @@ export function TimelineToolbar({ domEditSession, onSplitElement }: TimelineTool
             // toolbar layout never shifts.
             <Tooltip
               label={
-                !onToggleKeyframe
-                  ? "Select an animated element to add keyframes"
-                  : keyframeState === "active"
-                    ? "Remove keyframe at playhead (K)"
-                    : keyframeState === "inactive"
+                keyframePathEndpoint
+                  ? "Motion path endpoints cannot be removed"
+                  : !onToggleKeyframe
+                    ? "Select an animated element to add keyframes"
+                    : keyframeIsMotionPath
                       ? keyframeWillExtend
-                        ? "Add keyframe at playhead, extends animation (K)"
-                        : "Add keyframe at playhead (K)"
-                      : "Add keyframe (K)"
+                        ? "Extend motion path to playhead (K)"
+                        : keyframeState === "active"
+                          ? "Remove waypoint from motion path (K)"
+                          : "Add waypoint to motion path (K)"
+                      : keyframeState === "active"
+                        ? "Remove keyframe at playhead (K)"
+                        : keyframeState === "inactive"
+                          ? keyframeWillExtend
+                            ? "Add keyframe at playhead, extends animation (K)"
+                            : "Add keyframe at playhead (K)"
+                          : "Add keyframe (K)"
               }
             >
               <button
@@ -196,9 +241,17 @@ export function TimelineToolbar({ domEditSession, onSplitElement }: TimelineTool
                 disabled={!onToggleKeyframe}
                 onClick={onToggleKeyframe}
                 aria-label={
-                  keyframeState === "active"
-                    ? "Remove keyframe at playhead"
-                    : "Add keyframe at playhead"
+                  keyframePathEndpoint
+                    ? "Motion path endpoint"
+                    : keyframeIsMotionPath
+                      ? keyframeState === "active"
+                        ? "Remove motion path waypoint"
+                        : keyframeWillExtend
+                          ? "Extend motion path to playhead"
+                          : "Add motion path waypoint"
+                      : keyframeState === "active"
+                        ? "Remove keyframe at playhead"
+                        : "Add keyframe at playhead"
                 }
                 className={
                   !onToggleKeyframe
diff --git a/packages/studio/src/components/editor/MotionPathOverlay.tsx b/packages/studio/src/components/editor/MotionPathOverlay.tsx
index 1ed95b0ced..81a10a8d1b 100644
--- a/packages/studio/src/components/editor/MotionPathOverlay.tsx
+++ b/packages/studio/src/components/editor/MotionPathOverlay.tsx
@@ -88,6 +88,13 @@ export const MotionPathOverlay = memo(function MotionPathOverlay({
   // The keyframe % selected by clicking its node — highlighted, and the next drag
   // modifies it rather than adding a keyframe.
   const activeKeyframePct = usePlayerStore((s) => s.activeKeyframePct);
+  const timelineElement = usePlayerStore((state) => {
+    if (!selection) return undefined;
+    const sourceScopedId = `${selection.sourceFile || "index.html"}#${selection.id}`;
+    return state.elements.find(
+      (element) => (element.key ?? element.id) === sourceScopedId || element.id === selection.id,
+    );
+  });
   // Set-destination mode is armed from the preview toolbar (replaces the old
   // double-click-on-canvas UX). See createMode effects below.
   const armed = usePlayerStore((s) => s.motionPathArmed);
@@ -418,12 +425,13 @@ export const MotionPathOverlay = memo(function MotionPathOverlay({
   // Right-click a keyframe node → the timeline's keyframe context menu (delete
   // this keyframe / delete all), so motion-path keyframes are removable in place.
   const onNodeContextMenu = (e: React.MouseEvent, ref: MotionNodeRef) => {
-    if (ref.type !== "keyframe" || !animId || !elementId) return;
+    if (ref.type !== "keyframe" || !animId || !elementId || !timelineElement) return;
     e.preventDefault();
     e.stopPropagation();
     setKfMenu({
       x: e.clientX,
       y: e.clientY,
+      element: timelineElement,
       elementId,
       percentage: ref.pct,
       tweenPercentage: ref.pct,
diff --git a/packages/studio/src/components/editor/keyframeRetime.test.ts b/packages/studio/src/components/editor/keyframeRetime.test.ts
index fc8844e54d..4047d5c771 100644
--- a/packages/studio/src/components/editor/keyframeRetime.test.ts
+++ b/packages/studio/src/components/editor/keyframeRetime.test.ts
@@ -14,6 +14,22 @@ const KEYFRAMES: RetimeKeyframe[] = [
 const WINDOW = { tweenStart: 2, tweenDuration: 4 };
 const LEFT_BOUNDARY_DROP = { ...WINDOW, dropAbsTime: 0.5 };
 
+function expectLeftResize(
+  keyframes: RetimeKeyframe[],
+  draggedTweenPct: number,
+  pctRemap: Array<{ from: number; to: number }>,
+): void {
+  const result = resolveKeyframeRetime({
+    ...LEFT_BOUNDARY_DROP,
+    keyframes,
+    draggedTweenPct,
+  });
+  expect(result.kind).toBe("resize");
+  expect(result.position).toBeCloseTo(0.5, 5);
+  expect(result.duration).toBeCloseTo(5.5, 5);
+  expect(result.pctRemap).toEqual(pctRemap);
+}
+
 describe("resolveKeyframeRetime — move (within the tween window)", () => {
   it("re-keys an interior keyframe to the tween-% of the drop", () => {
     const r = resolveKeyframeRetime({
@@ -108,16 +124,8 @@ describe("resolveKeyframeRetime — resize (past the tween boundary)", () => {
   });
 
   it("extends the FIRST keyframe before the start, shifting position earlier", () => {
-    const r = resolveKeyframeRetime({
-      ...LEFT_BOUNDARY_DROP,
-      keyframes: KEYFRAMES,
-      draggedTweenPct: 0,
-    });
-    expect(r.kind).toBe("resize");
-    expect(r.position).toBeCloseTo(0.5, 5);
-    expect(r.duration).toBeCloseTo(5.5, 5); // 6 - 0.5
     // abs 0.5/4/6 over [0.5,6] → 0 / 63.636 / 100.
-    expect(r.pctRemap).toEqual([
+    expectLeftResize(KEYFRAMES, 0, [
       { from: 0, to: 0 },
       { from: 50, to: 63.636 },
       { from: 100, to: 100 },
@@ -142,15 +150,7 @@ describe("resolveKeyframeRetime — single keyframe (both first and last)", () =
   });
 
   it("resizes left before the start", () => {
-    const r = resolveKeyframeRetime({
-      ...LEFT_BOUNDARY_DROP,
-      keyframes: lone,
-      draggedTweenPct: 100,
-    });
-    expect(r.kind).toBe("resize");
-    expect(r.position).toBeCloseTo(0.5, 5);
-    expect(r.duration).toBeCloseTo(5.5, 5);
-    expect(r.pctRemap).toEqual([{ from: 100, to: 0 }]);
+    expectLeftResize(lone, 100, [{ from: 100, to: 0 }]);
   });
 });
 
diff --git a/packages/studio/src/components/editor/propertyPanelFlatTextSection.test.tsx b/packages/studio/src/components/editor/propertyPanelFlatTextSection.test.tsx
index 56a7714d7c..4dbe02cc0f 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatTextSection.test.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatTextSection.test.tsx
@@ -299,22 +299,17 @@ describe("FlatTextFieldEditor controls", () => {
 
 describe("FlatTextSection — multi-field", () => {
   it("shows the layer list, switches the active field's rows on selection, and has no doubled heading (this component never renders its own heading — the parent FlatGroup does)", () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    const root = createRoot(host);
-    act(() => {
-      root.render(
-        <FlatTextSection
-          element={makeMultiFieldElement()}
-          styles={{}}
-          fontAssets={[]}
-          onSetText={vi.fn()}
-          onSetTextFieldStyle={vi.fn()}
-          onAddTextField={vi.fn()}
-          onRemoveTextField={vi.fn()}
-        />,
-      );
-    });
+    const { host, root } = renderInto(
+      <FlatTextSection
+        element={makeMultiFieldElement()}
+        styles={{}}
+        fontAssets={[]}
+        onSetText={vi.fn()}
+        onSetTextFieldStyle={vi.fn()}
+        onAddTextField={vi.fn()}
+        onRemoveTextField={vi.fn()}
+      />,
+    );
     expect(host.textContent).toContain("Headline");
     expect(host.textContent).toContain("Subhead");
     // Active field's editor rows are visible (Font/Weight/etc. from FlatTextFieldEditor).
@@ -408,6 +403,27 @@ describe("FlatTextSection — multi-field", () => {
     act(() => root.unmount());
   });
 
+  it("does not steal canvas focus when a multi-field element is selected", () => {
+    const focusOwner = document.createElement("button");
+    document.body.append(focusOwner);
+    focusOwner.focus();
+
+    const { root } = renderInto(
+      <FlatTextSection
+        element={makeMultiFieldElement()}
+        styles={{}}
+        fontAssets={[]}
+        onSetText={vi.fn()}
+        onSetTextFieldStyle={vi.fn()}
+        onAddTextField={vi.fn()}
+        onRemoveTextField={vi.fn()}
+      />,
+    );
+
+    expect(document.activeElement).toBe(focusOwner);
+    act(() => root.unmount());
+  });
+
   it("auto-focuses the Content textarea when a new text field is added", async () => {
     let addResolved = false;
 
diff --git a/packages/studio/src/components/editor/propertyPanelFlatTextSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatTextSection.tsx
index ebabf758d3..636955de60 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatTextSection.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatTextSection.tsx
@@ -257,6 +257,7 @@ export function FlatTextSection({
   const [activeFieldKey, setActiveFieldKey] = useState<string | null>(
     element.textFields[0]?.key ?? null,
   );
+  const [autoFocusFieldKey, setAutoFocusFieldKey] = useState<string | null>(null);
 
   useEffect(() => {
     const nextFields = element.textFields;
@@ -266,6 +267,16 @@ export function FlatTextSection({
     });
   }, [element.id, element.selector, element.textFields]);
 
+  useEffect(() => {
+    setAutoFocusFieldKey(null);
+  }, [element.id, element.selector]);
+
+  useEffect(() => {
+    if (autoFocusFieldKey && autoFocusFieldKey === activeFieldKey) {
+      setAutoFocusFieldKey(null);
+    }
+  }, [activeFieldKey, autoFocusFieldKey]);
+
   if (!isTextEditableSelection(element)) return null;
   const textFields = element.textFields;
   const activeField = textFields.find((field) => field.key === activeFieldKey) ?? textFields[0];
@@ -278,10 +289,15 @@ export function FlatTextSection({
           fields={textFields}
           activeFieldKey={activeField.key}
           styles={styles}
-          onSelect={setActiveFieldKey}
+          onSelect={(fieldKey) => {
+            setAutoFocusFieldKey(null);
+            setActiveFieldKey(fieldKey);
+          }}
           onAdd={() =>
             void Promise.resolve(onAddTextField(activeField.key)).then((nextKey) => {
-              if (nextKey) setActiveFieldKey(nextKey);
+              if (!nextKey) return;
+              setAutoFocusFieldKey(nextKey);
+              setActiveFieldKey(nextKey);
             })
           }
           onRemove={onRemoveTextField}
@@ -295,7 +311,7 @@ export function FlatTextSection({
           onSetText={onSetText}
           onSetTextFieldStyle={onSetTextFieldStyle}
           onPreviewTextFieldStyle={onPreviewTextFieldStyle}
-          autoFocus
+          autoFocus={autoFocusFieldKey === activeField.key}
         />
       </div>
     );
@@ -316,7 +332,11 @@ export function FlatTextSection({
         type="button"
         onClick={() => {
           track("button", "Add text field");
-          void onAddTextField(activeField.key);
+          void Promise.resolve(onAddTextField(activeField.key)).then((nextKey) => {
+            if (!nextKey) return;
+            setAutoFocusFieldKey(nextKey);
+            setActiveFieldKey(nextKey);
+          });
         }}
         className="mt-0.5 flex items-center gap-[5px] text-[10px] text-panel-text-4 hover:text-panel-text-2"
       >
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
index dec72f7b13..a2156b4560 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -14,8 +14,8 @@ const mocks = vi.hoisted(() => ({
   actions: {
     handleGsapRemoveKeyframe: vi.fn(),
     handleGsapMoveKeyframeToPlayhead: vi.fn(),
-    handleGsapMoveKeyframe: vi.fn(),
-    handleGsapResizeKeyframedTween: vi.fn(),
+    handleGsapMoveKeyframe: vi.fn().mockResolvedValue(true),
+    handleGsapResizeKeyframedTween: vi.fn().mockResolvedValue(true),
     handleGsapUpdateMeta: vi.fn(),
     handleGsapAddKeyframe: vi.fn(),
     handleGsapAddKeyframeBatch: vi.fn().mockResolvedValue(undefined),
@@ -116,6 +116,27 @@ function renderCallbacks(): { callbacks: TimelineEditCallbacks; unmount: () => v
   return { callbacks, unmount: () => act(() => root.unmount()) };
 }
 
+function arrangeClickedCircle(): {
+  circle: TimelineElement;
+  selection: { id: string; selector: string; sourceFile: string };
+} {
+  const elementKey = "scenes/main.html#circle";
+  const circle: TimelineElement = {
+    ...element,
+    id: "circle",
+    key: elementKey,
+    domId: "circle",
+    sourceFile: "scenes/main.html",
+  };
+  const selection = { id: "circle", selector: "#circle", sourceFile: "scenes/main.html" };
+  usePlayerStore.setState({
+    elements: [element, circle],
+    gsapAnimations: new Map([[elementKey, [otherKeyframedAnimation]]]),
+  });
+  mocks.actions.buildDomSelectionForTimelineElement.mockResolvedValue(selection);
+  return { circle, selection };
+}
+
 beforeEach(() => {
   vi.clearAllMocks();
   mocks.animations = [flatAnimation];
@@ -163,10 +184,10 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
-  it("safely no-ops a boundary drag while the tween is still flat", () => {
+  it("settles false for a boundary drag while the tween is still flat", async () => {
     const view = renderCallbacks();
 
-    act(() => {
+    await expect(
       view.callbacks.onMoveKeyframe?.(
         "box",
         {
@@ -176,8 +197,8 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
           animationId: flatAnimation.id,
         },
         25,
-      );
-    });
+      ),
+    ).resolves.toBe(false);
 
     expect(mocks.actions.handleGsapMoveKeyframe).not.toHaveBeenCalled();
     expect(mocks.actions.handleGsapResizeKeyframedTween).not.toHaveBeenCalled();
@@ -251,55 +272,41 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
-  // The diamond context menu opens on whatever diamond was clicked, which need
-  // not belong to the selected element, and it passes no explicit target — so
-  // the resolve falls back to the cache. Reading the SELECTED element's cache
-  // there resolves against the wrong element's keyframes.
-  it("resolves a cache fallback against the clicked element, not the selected one", () => {
-    const circle: TimelineElement = {
-      ...element,
-      id: "circle",
-      key: "scenes/main.html#circle",
-      domId: "circle",
-    };
-    usePlayerStore.setState({
-      elements: [element, circle],
-      gsapAnimations: new Map([["scenes/main.html#circle", [otherKeyframedAnimation]]]),
-      keyframeCache: new Map([
-        // Decoy at the same clip-% under the selected element's key.
-        [
-          "box",
-          {
-            format: "percentage",
-            keyframes: [{ percentage: 100, tweenPercentage: 100, properties: { x: 420 } }],
-          },
-        ],
-        [
-          "scenes/main.html#circle",
-          {
-            format: "percentage",
-            keyframes: [
-              {
-                percentage: 100,
-                tweenPercentage: 100,
-                propertyGroup: "position",
-                animationId: otherKeyframedAnimation.id,
-                properties: { x: 420 },
-              },
-            ],
-          },
-        ],
-      ]),
+  it("deletes all keyframes through the clicked non-selected element's identity", async () => {
+    const { circle, selection } = arrangeClickedCircle();
+    const view = renderCallbacks();
+
+    await act(async () => {
+      view.callbacks.onDeleteAllKeyframes?.(circle);
+      await Promise.resolve();
     });
+
+    expect(mocks.actions.handleGsapRemoveAllKeyframes).toHaveBeenCalledWith(
+      otherKeyframedAnimation.id,
+      selection,
+    );
+    view.unmount();
+  });
+
+  it("moves a keyframe to the playhead through the clicked non-selected element's identity", async () => {
+    const { circle, selection } = arrangeClickedCircle();
     const view = renderCallbacks();
 
-    act(() => {
-      view.callbacks.onMoveKeyframeToPlayhead?.("scenes/main.html#circle", { percentage: 100 });
+    await act(async () => {
+      view.callbacks.onMoveKeyframeToPlayhead?.(circle, {
+        percentage: 100,
+        propertyGroup: "position",
+        tweenPercentage: 100,
+        animationId: otherKeyframedAnimation.id,
+      });
+      await Promise.resolve();
     });
 
     expect(mocks.actions.handleGsapMoveKeyframeToPlayhead).toHaveBeenCalledWith(
       otherKeyframedAnimation.id,
       100,
+      selection,
+      otherKeyframedAnimation,
     );
     view.unmount();
   });
@@ -402,8 +409,8 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     usePlayerStore.setState({ gsapAnimations: new Map([["box", [authored]]]) });
     const view = renderCallbacks();
 
-    await act(async () => {
-      await view.callbacks.onMoveKeyframe?.(
+    await expect(
+      view.callbacks.onMoveKeyframe?.(
         "box",
         {
           percentage: 50,
@@ -412,8 +419,8 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
           animationId: authored.id,
         },
         75,
-      );
-    });
+      ),
+    ).resolves.toBe(true);
 
     expect(mocks.actions.handleGsapMoveKeyframe).toHaveBeenCalledWith(
       authored.id,
@@ -466,4 +473,42 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     );
     view.unmount();
   });
+
+  it("uses the clip timing basis when retiming a duration-less tween", async () => {
+    const durationless = {
+      ...authoredInteriorAnimation(),
+      position: 3.2,
+      resolvedStart: 3.2,
+      duration: undefined,
+    };
+    const wideElement = { ...element, start: 10.94, duration: 16.26 };
+    mocks.animations = [durationless];
+    usePlayerStore.setState({
+      elements: [wideElement],
+      gsapAnimations: new Map([["box", [durationless]]]),
+    });
+    const view = renderCallbacks();
+
+    await expect(
+      view.callbacks.onMoveKeyframe?.(
+        "box",
+        {
+          percentage: 19.1,
+          propertyGroup: "position",
+          tweenPercentage: 50,
+          animationId: durationless.id,
+        },
+        40,
+      ),
+    ).resolves.toBe(true);
+
+    expect(mocks.actions.handleGsapMoveKeyframe).toHaveBeenCalledWith(
+      durationless.id,
+      50,
+      expect.any(Number),
+      mocks.selection,
+    );
+    expect(mocks.actions.handleGsapResizeKeyframedTween).not.toHaveBeenCalled();
+    view.unmount();
+  });
 });
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index f6e6f68f9e..01f64075ef 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -15,7 +15,10 @@ import { elementCacheKeys } from "../../hooks/gsapKeyframeCacheHelpers";
 import { resolveKeyframeRetime } from "../editor/keyframeRetime";
 import type { DomEditSelection } from "../editor/domEditingTypes";
 import type { TimelineMoveOperation } from "../../hooks/timelineMoveAdapter";
-import { splitTimelineElementKey } from "../../player/lib/timelineElementHelpers";
+import {
+  getTimelineElementIdentity,
+  splitTimelineElementKey,
+} from "../../player/lib/timelineElementHelpers";
 import type { TimelineKeyframeTarget } from "../../player/components/timelineKeyframeIdentity";
 
 export interface TimelineEditCallbackDeps {
@@ -139,27 +142,28 @@ export function useTimelineEditCallbacks({
   // anim in the keyframe's property group, falling back to the first keyframed one.
   const resolveKeyframeTarget = useCallback(
     (
+      elementKey: string,
       target: TimelineKeyframeTarget,
       animations: GsapAnimation[] = selectedGsapAnimations,
-      elementKey?: string,
     ): { animId: string; tweenPct: number } | null => {
       const carriesIdentity =
         target.propertyGroup !== undefined ||
         target.tweenPercentage !== undefined ||
         target.animationId !== undefined;
-      // The clicked element's own cache when the caller knows it: the diamond
-      // context menu can open on an element that is not the selected one, and
-      // reading the selection's cache there resolves against the wrong element.
-      const cached = usePlayerStore
-        .getState()
-        .keyframeCache.get(elementKey ?? domEditSelection?.id ?? "");
+      // The clicked element's own cache: the diamond context menu can open on an
+      // element that is not the selected one, and reading the selection's cache
+      // there resolves against the wrong element.
+      const keyframeCache = usePlayerStore.getState().keyframeCache;
+      const cached =
+        keyframeCache.get(elementKey) ??
+        keyframeCache.get(splitTimelineElementKey(elementKey).domId);
       return resolveTimelineKeyframeTarget(
         target.percentage,
         carriesIdentity ? [target] : (cached?.keyframes ?? []),
         animations,
       );
     },
-    [domEditSelection?.id, selectedGsapAnimations],
+    [selectedGsapAnimations],
   );
 
   const removeKeyframeTarget = useCallback(
@@ -192,17 +196,20 @@ export function useTimelineEditCallbacks({
       onSplitElement: handleTimelineElementSplit,
       onRazorSplit: handleRazorSplit,
       onRazorSplitAll: handleRazorSplitAll,
-      onDeleteAllKeyframes: () => {
+      onDeleteAllKeyframes: (element) => {
         // Hold the element where it is (collapse keyframes to a static set) rather
         // than deleting the whole animation — deleting strands a stale GSAP base
         // that the next drag adds to, flinging the element off-screen.
-        const anim = selectedGsapAnimations.find((a) => a.keyframes);
+        const elementKey = getTimelineElementIdentity(element);
+        const anim = resolveElementAnimations(elementKey).find((animation) => animation.keyframes);
         if (!anim) return;
-        handleGsapRemoveAllKeyframes(anim.id);
+        void buildDomSelectionForTimelineElement(element).then((selection) => {
+          if (selection) handleGsapRemoveAllKeyframes(anim.id, selection);
+        });
       },
       onDeleteKeyframe: (elId, keyframe) => {
         const animations = resolveElementAnimations(elId);
-        const target = resolveKeyframeTarget(keyframe, animations, elId);
+        const target = resolveKeyframeTarget(elId, keyframe, animations);
         if (!target) return;
         const element = usePlayerStore.getState().elements.find((el) => (el.key ?? el.id) === elId);
         if (!element) {
@@ -213,13 +220,24 @@ export function useTimelineEditCallbacks({
         // non-selected element (especially one in a different source file) commits
         // against the right element instead of the current domEditSelection.
         void buildDomSelectionForTimelineElement(element).then((selection) => {
-          removeKeyframeTarget(target.animId, target.tweenPct, animations, selection);
+          if (selection)
+            removeKeyframeTarget(target.animId, target.tweenPct, animations, selection);
         });
       },
       // Retime the keyframe to the playhead, preserving its value + ease.
-      onMoveKeyframeToPlayhead: (elId, keyframe) => {
-        const target = resolveKeyframeTarget(keyframe, resolveElementAnimations(elId), elId);
-        if (target) handleGsapMoveKeyframeToPlayhead(target.animId, target.tweenPct);
+      onMoveKeyframeToPlayhead: (element, keyframe) => {
+        const elementKey = getTimelineElementIdentity(element);
+        const animations = resolveElementAnimations(elementKey);
+        const target = resolveKeyframeTarget(elementKey, keyframe, animations);
+        const animation = target
+          ? animations.find((candidate) => candidate.id === target.animId)
+          : undefined;
+        if (!target || !animation) return;
+        void buildDomSelectionForTimelineElement(element).then((selection) => {
+          if (selection) {
+            handleGsapMoveKeyframeToPlayhead(target.animId, target.tweenPct, selection, animation);
+          }
+        });
       },
       // Drag-to-retime. The diamond reports clip-%s; resolveKeyframeTarget gives
       // the dragged keyframe's anim + tween-%. We convert the clip-% drop to an
@@ -231,7 +249,7 @@ export function useTimelineEditCallbacks({
       // fallow-ignore-next-line complexity
       onMoveKeyframe: async (elId, keyframe, toClipPct) => {
         const animations = resolveElementAnimations(elId);
-        const target = resolveKeyframeTarget(keyframe, animations, elId);
+        const target = resolveKeyframeTarget(elId, keyframe, animations);
         if (!target) return false;
         // The dragged diamond's OWN element, not the selected one: a drag on a
         // non-selected clip has to read that clip's animations and commit
@@ -241,12 +259,11 @@ export function useTimelineEditCallbacks({
         if (!sel) return false;
         const anim = animations.find((a) => a.id === target.animId);
         const tweenStart = anim ? resolveTweenStart(anim) : null;
-        if (!anim || tweenStart === null) return false;
+        if (!anim || tweenStart === null) return Promise.resolve(false);
         // Synthesized flat endpoints are clip boundaries, not authored keyframes.
         // Boundary-to-clip resize wiring is intentionally deferred; ignore the
         // drag rather than dispatching a free keyframe move that cannot be written.
-        if (!anim.keyframes) return false;
-        const tweenDuration = anim.duration ?? resolveTweenDuration(anim);
+        if (!anim.keyframes) return Promise.resolve(false);
         const sourceFile = sel.sourceFile || activeCompPath || "index.html";
         const { elements, domClipChildren } = usePlayerStore.getState();
         const { elStart, elDuration } = resolveClipTimingBasis(
@@ -255,6 +272,7 @@ export function useTimelineEditCallbacks({
           elements,
           domClipChildren,
         );
+        const tweenDuration = resolveTweenDuration(anim, elDuration);
         const dropAbsTime = elStart + (toClipPct / 100) * elDuration;
         const decision = resolveKeyframeRetime({
           keyframes: anim.keyframes?.keyframes ?? [],
@@ -264,35 +282,22 @@ export function useTimelineEditCallbacks({
           dropAbsTime,
         });
         if (decision.kind === "move" && decision.toTweenPct != null) {
-          handleGsapMoveKeyframe(target.animId, target.tweenPct, decision.toTweenPct, sel);
+          return handleGsapMoveKeyframe(target.animId, target.tweenPct, decision.toTweenPct, sel);
         } else if (
           decision.kind === "resize" &&
           decision.pctRemap &&
           decision.position != null &&
           decision.duration != null
         ) {
-          if (anim.keyframes) {
-            handleGsapResizeKeyframedTween(
-              target.animId,
-              decision.position,
-              decision.duration,
-              decision.pctRemap,
-              sel,
-            );
-          } else {
-            // resize-keyframed-tween requires an authored `keyframes` AST node
-            // and intentionally no-ops for a flat tween. Update its real tween
-            // window through the metadata writer (and SDK cutover path) instead.
-            handleGsapUpdateMeta(
-              target.animId,
-              { position: decision.position, duration: decision.duration },
-              sel,
-            );
-          }
-        } else {
-          return false;
+          return handleGsapResizeKeyframedTween(
+            target.animId,
+            decision.position,
+            decision.duration,
+            decision.pctRemap,
+            sel,
+          );
         }
-        return true;
+        return Promise.resolve(false);
       },
       onChangeKeyframeEase: (_elId: string, _pct: number, ease: string) => {
         for (const anim of selectedGsapAnimations) {
diff --git a/packages/studio/src/hooks/deleteSelectedKeyframes.ts b/packages/studio/src/hooks/deleteSelectedKeyframes.ts
index 20d5c9ff0d..79342aa04b 100644
--- a/packages/studio/src/hooks/deleteSelectedKeyframes.ts
+++ b/packages/studio/src/hooks/deleteSelectedKeyframes.ts
@@ -1,5 +1,5 @@
 import { usePlayerStore } from "../player/store/playerStore";
-import { selectedKeyframePercentagesForElement } from "../utils/keyframeSelection";
+import { timelineKeyframeTargetFromSelectionKey } from "../player/components/timelineKeyframeIdentity";
 import type { CommitMutationOptions } from "./gsapScriptCommitTypes";
 
 let deleteKeyframesCommitCounter = 0;
@@ -18,18 +18,31 @@ export function deleteSelectedKeyframes(session: {
   ) => void;
 }): void {
   const { selectedKeyframes, selectedElementId } = usePlayerStore.getState();
-  const animation = session.selectedGsapAnimations.find((anim) => anim.keyframes);
-  if (!animation) return;
-  // Only the active element's keyframes; a stale cross-element selection must not delete here.
-  const percentages = selectedKeyframePercentagesForElement(selectedKeyframes, selectedElementId);
+  if (!selectedElementId) return;
+  const keyframedAnimations = session.selectedGsapAnimations.filter((anim) => anim.keyframes);
+  const fallbackAnimation = keyframedAnimations[0];
+  const animationsById = new Map(keyframedAnimations.map((animation) => [animation.id, animation]));
+  const removals = new Map<string, { animationId: string; percentage: number }>();
+  for (const key of selectedKeyframes) {
+    const target = timelineKeyframeTargetFromSelectionKey(selectedElementId, key);
+    if (!target) continue;
+    const animation = target.animationId
+      ? animationsById.get(target.animationId)
+      : fallbackAnimation;
+    if (!animation) continue;
+    const percentage = target.tweenPercentage ?? target.percentage;
+    removals.set(`${animation.id}\0${percentage}`, { animationId: animation.id, percentage });
+  }
+  const targets = [...removals.values()];
+  if (targets.length === 0) return;
   const coalesceOptions = {
     coalesceKey: `delete-keyframes:${++deleteKeyframesCommitCounter}`,
     coalesceMs: Number.POSITIVE_INFINITY,
   };
-  for (const [index, pct] of percentages.entries()) {
-    session.handleGsapRemoveKeyframe(animation.id, pct, {
+  for (const [index, target] of targets.entries()) {
+    session.handleGsapRemoveKeyframe(target.animationId, target.percentage, {
       ...coalesceOptions,
-      ...(index === percentages.length - 1 ? { softReload: true } : { skipReload: true }),
+      ...(index === targets.length - 1 ? { softReload: true } : { skipReload: true }),
     });
   }
 }
diff --git a/packages/studio/src/hooks/gsapDragPositionCommit.ts b/packages/studio/src/hooks/gsapDragPositionCommit.ts
index ac1d760126..b54847dcad 100644
--- a/packages/studio/src/hooks/gsapDragPositionCommit.ts
+++ b/packages/studio/src/hooks/gsapDragPositionCommit.ts
@@ -11,6 +11,21 @@ import {
   materializeIfDynamic,
 } from "./gsapDragCommit";
 
+export function buildTemporalArcKeyframes(
+  anim: GsapAnimation,
+  percentage: number,
+  properties: Record<string, number>,
+) {
+  return [
+    ...(anim.keyframes?.keyframes ?? []).map((keyframe) => ({
+      percentage: keyframe.percentage,
+      properties: { ...keyframe.properties },
+      ...(keyframe.ease ? { ease: keyframe.ease } : {}),
+    })),
+    { percentage, properties },
+  ].sort((a, b) => a.percentage - b.percentage);
+}
+
 async function extendTweenAndAddKeyframe(
   selection: DomEditSelection,
   anim: GsapAnimation,
@@ -259,6 +274,47 @@ export async function commitGsapPositionFromDrag(
 
   const backfillDefaults: Record<string, number> = { x: baseGsapX, y: baseGsapY };
   const ct = usePlayerStore.getState().currentTime;
+  if (anim.arcPath?.enabled) {
+    const { activeKeyframePct, setActiveKeyframePct } = usePlayerStore.getState();
+    const pct = activeKeyframePct ?? computeCurrentPercentage(selection, anim);
+    const keyframes = anim.keyframes?.keyframes ?? [];
+    const pointIndex = keyframes.findIndex((kf) => Math.abs(kf.percentage - pct) < 0.05);
+    if (pointIndex >= 0) {
+      await callbacks.commitMutation(
+        selection,
+        {
+          type: "update-motion-path-point",
+          animationId: anim.id,
+          pointIndex,
+          x: newX,
+          y: newY,
+        },
+        { label: "Move layer (waypoint)", softReload: true, beforeReload: restoreOffset },
+      );
+      setActiveKeyframePct(null);
+      parkPlayheadOnKeyframe(anim, pct);
+      return;
+    }
+
+    const tweenStart = resolveTweenStart(anim);
+    const tweenDuration = resolveTweenDuration(anim);
+    if (tweenStart === null || tweenDuration <= 0 || keyframes.length < 2) return;
+    const temporalKeyframes = buildTemporalArcKeyframes(anim, pct, { x: newX, y: newY });
+    await callbacks.commitMutation(
+      selection,
+      {
+        type: "replace-with-keyframes",
+        animationId: anim.id,
+        targetSelector: anim.targetSelector,
+        position: roundTo3(tweenStart),
+        duration: roundTo3(tweenDuration),
+        keyframes: temporalKeyframes,
+        ease: "none",
+      },
+      { label: "Move layer (new keyframe)", softReload: true, beforeReload: restoreOffset },
+    );
+    return;
+  }
   if (anim.keyframes) {
     const newId = await materializeIfDynamic(anim, iframe, callbacks.commitMutation, selection);
     const effectiveAnim = newId ? { ...anim, id: newId } : anim;
diff --git a/packages/studio/src/hooks/gsapRuntimeBridge.test.ts b/packages/studio/src/hooks/gsapRuntimeBridge.test.ts
index 7c78c05872..de5c5ef78d 100644
--- a/packages/studio/src/hooks/gsapRuntimeBridge.test.ts
+++ b/packages/studio/src/hooks/gsapRuntimeBridge.test.ts
@@ -280,3 +280,103 @@ describe("tryGsapDragIntercept — autoKeyframeEnabled toggle (#1808)", () => {
     expect(types).not.toContain("replace-with-keyframes");
   });
 });
+
+describe("tryGsapDragIntercept — motion paths", () => {
+  const motionPathAnim = {
+    id: "#puck-b-to-12170-position",
+    targetSelector: "#puck-b",
+    propertyGroup: "position",
+    method: "to",
+    position: 12.17,
+    resolvedStart: 12.17,
+    duration: 16.055,
+    ease: "power1.inOut",
+    properties: {},
+    keyframes: {
+      keyframes: [
+        { percentage: 0, properties: { x: -184, y: 326 } },
+        { percentage: 50, properties: { x: 416, y: 804 } },
+        { percentage: 100, properties: { x: 796, y: 237 } },
+      ],
+    },
+    arcPath: {
+      enabled: true,
+      autoRotate: false,
+      segments: [{ curviness: 1 }, { curviness: 1 }],
+    },
+  } as unknown as GsapAnimation;
+  const liveTween = {
+    targets: () => [{ id: "puck-b" }],
+    vars: { motionPath: { path: [] }, duration: 16.055 },
+    duration: () => 16.055,
+    startTime: () => 12.17,
+  };
+
+  async function dragMotionPath(activeKeyframePct: number | null) {
+    usePlayerStore.setState({
+      autoKeyframeEnabled: true,
+      activeKeyframePct,
+      currentTime: 15.9,
+    });
+    const commitMutation = vi.fn();
+    const handled = await tryGsapDragIntercept(
+      selection,
+      { x: -50, y: 30 },
+      [motionPathAnim],
+      fakeIframe("puck-b", [liveTween]),
+      commitMutation,
+    );
+    return { commitMutation, handled };
+  }
+
+  afterEach(() => {
+    usePlayerStore.setState({ activeKeyframePct: null });
+  });
+
+  it("creates a temporal keyframe at the exact playhead instead of redistributing path waypoints", async () => {
+    const { commitMutation, handled } = await dragMotionPath(null);
+
+    expect(handled).toBe(true);
+    expect(commitMutation).toHaveBeenCalledWith(
+      selection,
+      {
+        type: "replace-with-keyframes",
+        animationId: motionPathAnim.id,
+        targetSelector: "#puck-b",
+        position: 12.17,
+        duration: 16.055,
+        keyframes: [
+          { percentage: 0, properties: { x: -184, y: 326 } },
+          { percentage: 23.233, properties: { x: -50, y: 30 } },
+          { percentage: 50, properties: { x: 416, y: 804 } },
+          { percentage: 100, properties: { x: 796, y: 237 } },
+        ],
+        ease: "none",
+      },
+      expect.objectContaining({ label: "Move layer (new keyframe)", softReload: true }),
+    );
+    expect(commitMutation.mock.calls.map(([, mutation]) => mutation.type)).not.toContain(
+      "add-motion-path-point",
+    );
+  });
+
+  it("keeps an explicitly selected path waypoint as a spatial edit", async () => {
+    const { commitMutation, handled } = await dragMotionPath(50);
+
+    expect(handled).toBe(true);
+    expect(commitMutation).toHaveBeenCalledWith(
+      selection,
+      {
+        type: "update-motion-path-point",
+        animationId: motionPathAnim.id,
+        pointIndex: 1,
+        x: -50,
+        y: 30,
+      },
+      expect.objectContaining({ label: "Move layer (waypoint)", softReload: true }),
+    );
+    expect(commitMutation.mock.calls.map(([, mutation]) => mutation.type)).not.toContain(
+      "replace-with-keyframes",
+    );
+  });
+});
diff --git a/packages/studio/src/hooks/gsapScriptCommitTypes.ts b/packages/studio/src/hooks/gsapScriptCommitTypes.ts
index 137dc2af18..929e79b8ec 100644
--- a/packages/studio/src/hooks/gsapScriptCommitTypes.ts
+++ b/packages/studio/src/hooks/gsapScriptCommitTypes.ts
@@ -16,6 +16,8 @@ export interface MutationResult {
 
 export interface CommitMutationOptions {
   label: string;
+  /** Observe the durable writer result without duplicating the request path. */
+  onResult?: (result: MutationResult) => void;
   coalesceKey?: string;
   coalesceMs?: number;
   softReload?: boolean;
diff --git a/packages/studio/src/hooks/gsapShared.test.ts b/packages/studio/src/hooks/gsapShared.test.ts
index 0fb17bfb74..0458d091b9 100644
--- a/packages/studio/src/hooks/gsapShared.test.ts
+++ b/packages/studio/src/hooks/gsapShared.test.ts
@@ -1,14 +1,30 @@
 import { describe, it, expect } from "vitest";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import type { DomEditSelection } from "../components/editor/domEditingTypes";
 import {
   idFromSelector,
   idSelector,
   isInstantHold,
   parsePercentageKeyframes,
+  resolveEditableTweenDuration,
   toClipKeyframes,
   toClipPercentage,
 } from "./gsapShared";
 
+describe("resolveEditableTweenDuration", () => {
+  const selection = { dataAttributes: { duration: "16.26" } } as DomEditSelection;
+
+  it("uses the owning clip duration when the tween omits an outer duration", () => {
+    expect(resolveEditableTweenDuration({ duration: undefined } as GsapAnimation, selection)).toBe(
+      16.26,
+    );
+  });
+
+  it("keeps an explicitly-authored tween duration", () => {
+    expect(resolveEditableTweenDuration({ duration: 4 } as GsapAnimation, selection)).toBe(4);
+  });
+});
+
 describe("isInstantHold", () => {
   const animation = (method: GsapAnimation["method"], duration?: number) =>
     ({ method, duration }) as unknown as GsapAnimation;
diff --git a/packages/studio/src/hooks/gsapShared.ts b/packages/studio/src/hooks/gsapShared.ts
index 906b984196..c77ddd645b 100644
--- a/packages/studio/src/hooks/gsapShared.ts
+++ b/packages/studio/src/hooks/gsapShared.ts
@@ -109,6 +109,22 @@ export function selectorFromSelection(selection: DomEditSelection): string | nul
 
 // ── Percentage computation ────────────────────────────────────────────────────
 
+/**
+ * Resolve the timing basis used by editor keyframes. The timeline renders a
+ * duration-less tween across its owning clip, so mutations must use that same
+ * duration instead of silently falling back to GSAP's 0.5s default.
+ */
+export function resolveEditableTweenDuration(
+  animation: GsapAnimation,
+  selection: DomEditSelection,
+): number {
+  const clipDuration = Number.parseFloat(selection.dataAttributes?.duration ?? "");
+  return resolveTweenDuration(
+    animation,
+    Number.isFinite(clipDuration) && clipDuration > 0 ? clipDuration : 0.5,
+  );
+}
+
 /**
  * Compute the current playback percentage within an element's animation range.
  * Uses the animation's resolved timing if available, otherwise falls back to
@@ -121,7 +137,7 @@ export function computeElementPercentage(
 ): number {
   if (animation) {
     const start = resolveTweenStart(animation);
-    const duration = resolveTweenDuration(animation);
+    const duration = resolveEditableTweenDuration(animation, selection);
     if (duration <= 0) return 0;
     if (start !== null) {
       return absoluteToPercentage(currentTime, start, duration);
@@ -129,9 +145,7 @@ export function computeElementPercentage(
   }
   const elStart = Number.parseFloat(selection.dataAttributes?.start ?? "0") || 0;
   const elDuration = Number.parseFloat(selection.dataAttributes?.duration ?? "1") || 1;
-  return elDuration > 0
-    ? Math.max(0, Math.min(100, Math.round(((currentTime - elStart) / elDuration) * 1000) / 10))
-    : 0;
+  return absoluteToPercentage(currentTime, elStart, elDuration);
 }
 
 // ── Iframe accessors ──────────────────────────────────────────────────────────
diff --git a/packages/studio/src/hooks/timelineEditingHelpers.test.ts b/packages/studio/src/hooks/timelineEditingHelpers.test.ts
index 5ac3b69204..03db5a2b9c 100644
--- a/packages/studio/src/hooks/timelineEditingHelpers.test.ts
+++ b/packages/studio/src/hooks/timelineEditingHelpers.test.ts
@@ -12,6 +12,7 @@ import {
 import type { TimelineElement } from "../player/store/playerStore";
 import { usePlayerStore } from "../player/store/playerStore";
 import type { CommitMutationOptions } from "./gsapScriptCommitTypes";
+import { timelineKeyframeSelectionKey } from "../player/components/timelineKeyframeIdentity";
 
 afterEach(() => {
   usePlayerStore.getState().reset();
@@ -342,4 +343,51 @@ describe("deleteSelectedKeyframes", () => {
     expect(options[1]).not.toHaveProperty("softReload");
     expect(options[2]).not.toHaveProperty("skipReload");
   });
+
+  it("deletes two expanded lanes through their own animation and tween percentages", () => {
+    usePlayerStore.setState({
+      selectedElementId: "card",
+      selectedKeyframes: new Set([
+        timelineKeyframeSelectionKey("card", {
+          percentage: 30,
+          tweenPercentage: 20,
+          propertyGroup: "position",
+          animationId: "card-position",
+        }),
+        timelineKeyframeSelectionKey("card", {
+          percentage: 70,
+          tweenPercentage: 80,
+          propertyGroup: "visual",
+          animationId: "card-visual",
+        }),
+      ]),
+    });
+    const handleGsapRemoveKeyframe =
+      vi.fn<(animId: string, pct: number, options?: Partial<CommitMutationOptions>) => void>();
+
+    deleteSelectedKeyframes({
+      selectedGsapAnimations: [
+        { id: "card-position", keyframes: {} },
+        { id: "card-visual", keyframes: {} },
+      ],
+      handleGsapRemoveKeyframe,
+    });
+
+    expect(handleGsapRemoveKeyframe).toHaveBeenCalledTimes(2);
+    expect(
+      handleGsapRemoveKeyframe.mock.calls.map(([animationId, percentage]) => [
+        animationId,
+        percentage,
+      ]),
+    ).toEqual([
+      ["card-position", 20],
+      ["card-visual", 80],
+    ]);
+    expect(handleGsapRemoveKeyframe.mock.calls[0]?.[2]).toEqual(
+      expect.objectContaining({ skipReload: true }),
+    );
+    expect(handleGsapRemoveKeyframe.mock.calls[1]?.[2]).toEqual(
+      expect.objectContaining({ softReload: true }),
+    );
+  });
 });
diff --git a/packages/studio/src/hooks/useDomEditWiring.ts b/packages/studio/src/hooks/useDomEditWiring.ts
index 19e21d29b6..b9468d510a 100644
--- a/packages/studio/src/hooks/useDomEditWiring.ts
+++ b/packages/studio/src/hooks/useDomEditWiring.ts
@@ -92,14 +92,14 @@ export interface UseDomEditWiringParams {
     animId: string,
     fromPercentage: number,
     toPercentage: number,
-  ) => void;
+  ) => Promise<boolean>;
   resizeKeyframedTween: (
     sel: DomEditSelection,
     animId: string,
     position: number,
     duration: number,
     pctRemap: Array<{ from: number; to: number }>,
-  ) => void;
+  ) => Promise<boolean>;
   convertToKeyframes: (
     sel: DomEditSelection,
     animId: string,
diff --git a/packages/studio/src/hooks/useEnableKeyframes.test.ts b/packages/studio/src/hooks/useEnableKeyframes.test.ts
index 3967edf518..6fc5a823cb 100644
--- a/packages/studio/src/hooks/useEnableKeyframes.test.ts
+++ b/packages/studio/src/hooks/useEnableKeyframes.test.ts
@@ -5,6 +5,7 @@ import { afterEach, describe, expect, it, vi } from "vitest";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import type { DomEditSelection } from "../components/editor/domEditingTypes";
 import {
+  applyArcKeyframeAtPlayhead,
   animatedProps,
   buildExtendedKeyframes,
   isPlayheadWithinTween,
@@ -219,6 +220,114 @@ describe("promoteSetToKeyframes — auto endpoint", () => {
   });
 });
 
+describe("applyArcKeyframeAtPlayhead", () => {
+  const arcAnim = anim({
+    id: "#el-to-0-position",
+    position: 0,
+    duration: 10,
+    keyframes: {
+      format: "object-array",
+      keyframes: [
+        { percentage: 0, properties: { x: 0, y: 0 } },
+        { percentage: 50, properties: { x: 50, y: 50 } },
+        { percentage: 100, properties: { x: 100, y: 0 } },
+      ],
+    },
+    arcPath: {
+      enabled: true,
+      autoRotate: false,
+      segments: [{ curviness: 1 }, { curviness: 1 }],
+    },
+  });
+
+  function arcFixture(x: number, y: number) {
+    const commitMutation = vi.fn(async () => undefined);
+    const session = { commitMutation } as unknown as EnableKeyframesSession;
+    const sel = {
+      id: "el",
+      selector: "#el",
+      element: { isConnected: true } as HTMLElement,
+      dataAttributes: { duration: "10" },
+    } as DomEditSelection;
+    const iframe = {
+      contentWindow: {
+        gsap: { getProperty: (_element: Element, property: string) => (property === "x" ? x : y) },
+      },
+    } as unknown as HTMLIFrameElement;
+    return { commitMutation, iframe, sel, session };
+  }
+
+  it("removes an existing interior stop without redistributing the remaining times", async () => {
+    const fixture = arcFixture(50, 50);
+    await applyArcKeyframeAtPlayhead(fixture.session, fixture.sel, arcAnim, 5, fixture.iframe);
+    expect(fixture.commitMutation).toHaveBeenCalledWith(
+      {
+        type: "replace-with-keyframes",
+        animationId: arcAnim.id,
+        targetSelector: "#el",
+        position: 0,
+        duration: 10,
+        keyframes: [
+          { percentage: 0, properties: { x: 0, y: 0 } },
+          { percentage: 100, properties: { x: 100, y: 0 } },
+        ],
+        ease: "none",
+      },
+      { label: "Remove keyframe", softReload: true },
+    );
+  });
+
+  it("preserves the path endpoints", async () => {
+    const fixture = arcFixture(0, 0);
+    await applyArcKeyframeAtPlayhead(fixture.session, fixture.sel, arcAnim, 0, fixture.iframe);
+    expect(fixture.commitMutation).not.toHaveBeenCalled();
+  });
+
+  it("adds a temporal keyframe at the exact playhead while preserving authored times", async () => {
+    const fixture = arcFixture(25, 25);
+    await applyArcKeyframeAtPlayhead(fixture.session, fixture.sel, arcAnim, 2.5, fixture.iframe);
+    expect(fixture.commitMutation).toHaveBeenCalledWith(
+      {
+        type: "replace-with-keyframes",
+        animationId: arcAnim.id,
+        targetSelector: "#el",
+        position: 0,
+        duration: 10,
+        keyframes: [
+          { percentage: 0, properties: { x: 0, y: 0 } },
+          { percentage: 25, properties: { x: 25, y: 25 } },
+          { percentage: 50, properties: { x: 50, y: 50 } },
+          { percentage: 100, properties: { x: 100, y: 0 } },
+        ],
+        ease: "none",
+      },
+      { label: "Add keyframe", softReload: true },
+    );
+  });
+
+  it("uses the owning clip duration when an arc omits its outer duration", async () => {
+    const fixture = arcFixture(25, 25);
+    const durationlessArc = { ...arcAnim, duration: undefined };
+
+    await applyArcKeyframeAtPlayhead(
+      fixture.session,
+      fixture.sel,
+      durationlessArc,
+      2.5,
+      fixture.iframe,
+    );
+
+    expect(fixture.commitMutation).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: "replace-with-keyframes",
+        duration: 10,
+        keyframes: expect.arrayContaining([{ percentage: 25, properties: { x: 25, y: 25 } }]),
+      }),
+      { label: "Add keyframe", softReload: true },
+    );
+  });
+});
+
 function renderEnableKeyframes(session: EnableKeyframesSession): () => Promise<void> {
   let enable: (() => Promise<void>) | null = null;
   function Probe() {
diff --git a/packages/studio/src/hooks/useEnableKeyframes.ts b/packages/studio/src/hooks/useEnableKeyframes.ts
index 805af7bcb6..f55a8e49dd 100644
--- a/packages/studio/src/hooks/useEnableKeyframes.ts
+++ b/packages/studio/src/hooks/useEnableKeyframes.ts
@@ -12,16 +12,22 @@ import type { GsapAnimation, GsapPercentageKeyframe } from "@hyperframes/core/gs
 import type { DomEditSelection } from "../components/editor/domEditingTypes";
 import { usePlayerStore } from "../player/store/playerStore";
 import { fetchParsedAnimations, getAnimationsForElement } from "./useGsapTweenCache";
-import { selectorFromSelection, computeElementPercentage, isInstantHold } from "./gsapShared";
 import {
+  selectorFromSelection,
+  computeElementPercentage,
+  isInstantHold,
+  resolveEditableTweenDuration,
+} from "./gsapShared";
+import {
+  absoluteToPercentage,
   resolveTweenStart,
   resolveTweenDuration,
   isTimeWithinTween,
 } from "../utils/globalTimeCompiler";
 import { POSITION_PROPS } from "./gsapRuntimeReaders";
 import { roundTo3 } from "../utils/rounding";
-import { nearestPointOnPath } from "../components/editor/motionPathGeometry";
 import type { CommitMutationOptions } from "./gsapScriptCommitTypes";
+import { buildTemporalArcKeyframes } from "./gsapDragPositionCommit";
 
 let enableKeyframesTransactionCounter = 0;
 
@@ -89,9 +95,10 @@ export function buildExtendedKeyframes(
   anim: GsapAnimation,
   currentTime: number,
   position: Record<string, number>,
+  sourceDuration = resolveTweenDuration(anim),
 ): { position: number; duration: number; keyframes: GsapPercentageKeyframe[] } {
   const oldStart = resolveTweenStart(anim) ?? 0;
-  const oldDuration = resolveTweenDuration(anim);
+  const oldDuration = sourceDuration;
   const newStart = Math.min(oldStart, currentTime);
   const newEnd = Math.max(oldStart + oldDuration, currentTime);
   const newDuration = roundTo3(newEnd - newStart);
@@ -222,6 +229,37 @@ async function fetchAnimationsForElement(sel: DomEditSelection): Promise<GsapAni
   return (await tryFetchAnimationsForElement(sel)) ?? [];
 }
 
+async function extendKeyframedTweenToPlayhead(
+  session: EnableKeyframesSession,
+  sel: DomEditSelection,
+  anim: GsapAnimation,
+  currentTime: number,
+  duration: number,
+  iframe: HTMLIFrameElement | null,
+  commitOverrides?: Partial<CommitMutationOptions>,
+): Promise<void> {
+  const selector = selectorFromSelection(sel);
+  const position = readElementPosition(iframe, sel, anim);
+  if (!selector || Object.keys(position).length === 0 || !session.commitMutation) return;
+  const extended = buildExtendedKeyframes(anim, currentTime, position, duration);
+  await session.commitMutation(
+    {
+      type: "replace-with-keyframes",
+      animationId: anim.id,
+      targetSelector: selector,
+      position: extended.position,
+      duration: extended.duration,
+      keyframes: extended.keyframes,
+      ease: anim.ease,
+    },
+    {
+      label: "Add keyframe",
+      softReload: true,
+      ...commitOverrides,
+    },
+  );
+}
+
 /**
  * Apply "add keyframe at playhead" to a tween that already has x/y keyframes:
  * toggle off an existing stop, add one at the playhead's tween-relative %, or —
@@ -237,31 +275,22 @@ async function applyKeyframeAtPlayhead(
   iframe: HTMLIFrameElement | null,
   commitOverrides?: Partial<CommitMutationOptions>,
 ): Promise<void> {
-  if (!isPlayheadWithinTween(kfAnim, t)) {
-    const position = readElementPosition(iframe, sel, kfAnim);
-    const selector = selectorFromSelection(sel);
-    if (selector && Object.keys(position).length > 0 && session.commitMutation) {
-      const extended = buildExtendedKeyframes(kfAnim, t, position);
-      await session.commitMutation(
-        {
-          type: "replace-with-keyframes",
-          animationId: kfAnim.id,
-          targetSelector: selector,
-          position: extended.position,
-          duration: extended.duration,
-          keyframes: extended.keyframes,
-          ease: kfAnim.ease,
-        },
-        {
-          label: "Add keyframe",
-          softReload: true,
-          ...commitOverrides,
-        },
-      );
-    }
+  const duration = resolveEditableTweenDuration(kfAnim, sel);
+  const start = resolveTweenStart(kfAnim);
+  if (start !== null && !isTimeWithinTween(t, start, duration)) {
+    await extendKeyframedTweenToPlayhead(
+      session,
+      sel,
+      kfAnim,
+      t,
+      duration,
+      iframe,
+      commitOverrides,
+    );
     return;
   }
-  const pct = computeElementPercentage(t, sel, kfAnim);
+  const pct =
+    start === null ? computeElementPercentage(t, sel) : absoluteToPercentage(t, start, duration);
   const existing = kfAnim.keyframes?.keyframes.find((k) => Math.abs(k.percentage - pct) <= 1);
   if (existing) {
     session.handleGsapRemoveKeyframe(kfAnim.id, existing.percentage);
@@ -332,14 +361,13 @@ export async function promoteSetToKeyframes(
 }
 
 /**
- * An arc (motionPath) tween — its waypoints are reconstructed onto `keyframes`, so
- * it must be edited as waypoints (not x/y keyframes, which would break the curve).
- * "Add keyframe at playhead" drops a waypoint where the element currently sits on
- * the path, inserted at the matching segment so the curve is preserved. Outside the
- * range, extend the duration so the motion reaches the playhead.
+ * Convert an arc (motionPath) tween to temporal x/y keyframes before toggling the
+ * playhead stop. A toolbar command named "Add keyframe at playhead" must preserve
+ * every authored stop's time; inserting a spatial waypoint instead redistributes
+ * the path and can silently compress the animation.
  */
 // fallow-ignore-next-line complexity
-async function applyArcWaypointAtPlayhead(
+export async function applyArcKeyframeAtPlayhead(
   session: EnableKeyframesSession,
   sel: DomEditSelection,
   arcAnim: GsapAnimation,
@@ -347,8 +375,11 @@ async function applyArcWaypointAtPlayhead(
   iframe: HTMLIFrameElement | null,
 ): Promise<void> {
   if (!session.commitMutation) return;
-  if (!isPlayheadWithinTween(arcAnim, t)) {
-    const start = resolveTweenStart(arcAnim) ?? 0;
+  const targetSelector = selectorFromSelection(sel);
+  if (!targetSelector) return;
+  const start = resolveTweenStart(arcAnim) ?? 0;
+  const duration = resolveEditableTweenDuration(arcAnim, sel);
+  if (!isTimeWithinTween(t, start, duration)) {
     if (t > start) {
       await session.commitMutation(
         {
@@ -361,30 +392,45 @@ async function applyArcWaypointAtPlayhead(
     }
     return;
   }
+  const nodes = arcAnim.keyframes?.keyframes ?? [];
+  const playheadPercentage = absoluteToPercentage(t, start, duration);
+  const timedNodeIndex = nodes.findIndex(
+    (node) => Math.abs(node.percentage - playheadPercentage) <= 1,
+  );
+  if (timedNodeIndex !== -1) {
+    if (timedNodeIndex > 0 && timedNodeIndex < nodes.length - 1) {
+      await session.commitMutation(
+        {
+          type: "replace-with-keyframes",
+          animationId: arcAnim.id,
+          targetSelector,
+          position: roundTo3(start),
+          duration: roundTo3(duration),
+          keyframes: nodes.filter((_, index) => index !== timedNodeIndex),
+          ease: "none",
+        },
+        { label: "Remove keyframe", softReload: true },
+      );
+    }
+    return;
+  }
+
   const live = readElementPosition(iframe, sel, arcAnim);
   if (typeof live.x !== "number" || typeof live.y !== "number") return;
-  const liveX = live.x;
-  const liveY = live.y;
-  const nodes = (arcAnim.keyframes?.keyframes ?? [])
-    .map((k) => ({ x: k.properties.x, y: k.properties.y }))
-    .filter(
-      (p): p is { x: number; y: number } => typeof p.x === "number" && typeof p.y === "number",
-    );
-  // Don't duplicate a waypoint that already sits where the element is (e.g. at the
-  // path endpoints).
-  const WAYPOINT_MERGE_PX = 6;
-  if (nodes.some((n) => Math.hypot(n.x - liveX, n.y - liveY) <= WAYPOINT_MERGE_PX)) return;
-  const proj = nearestPointOnPath(liveX, liveY, nodes);
-  if (!proj) return;
   await session.commitMutation(
     {
-      type: "add-motion-path-point",
+      type: "replace-with-keyframes",
       animationId: arcAnim.id,
-      index: proj.segIndex + 1,
-      x: liveX,
-      y: liveY,
+      targetSelector,
+      position: roundTo3(start),
+      duration: roundTo3(duration),
+      keyframes: buildTemporalArcKeyframes(arcAnim, playheadPercentage, {
+        x: live.x,
+        y: live.y,
+      }),
+      ease: "none",
     },
-    { label: "Add waypoint", softReload: true },
+    { label: "Add keyframe", softReload: true },
   );
 }
 
@@ -420,7 +466,7 @@ export function useEnableKeyframes(
     const flatAnim = anims.find((a) => !a.keyframes && !a.arcPath && !isInstantHold(a));
 
     if (arcAnim) {
-      await applyArcWaypointAtPlayhead(session, sel, arcAnim, t, iframe);
+      await applyArcKeyframeAtPlayhead(session, sel, arcAnim, t, iframe);
     } else if (kfAnim) {
       await applyKeyframeAtPlayhead(session, sel, kfAnim, t, iframe);
     } else if (setAnim) {
diff --git a/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx b/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
index 5e01b9e6da..6017353d08 100644
--- a/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
+++ b/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
@@ -20,7 +20,12 @@ afterEach(() => {
 const selection: DomEditSelection = { id: "box", selector: "#box" } as DomEditSelection;
 
 function successfulCommitMutation() {
-  return vi.fn<(...args: unknown[]) => Promise<unknown>>(async () => ({ ok: true }));
+  return vi.fn<(...args: unknown[]) => Promise<unknown>>(async (...args) => {
+    const options = args[2] as {
+      onResult?: (result: { ok: boolean; changed: boolean }) => void;
+    };
+    options.onResult?.({ ok: true, changed: true });
+  });
 }
 
 function renderKeyframeOps(over: {
@@ -54,6 +59,18 @@ function renderKeyframeOps(over: {
   return captured.api;
 }
 
+async function moveKeyframeWith(
+  commitMutation: (...args: unknown[]) => Promise<unknown>,
+): Promise<{ committed: boolean; trackGsapSaveFailure: ReturnType<typeof vi.fn> }> {
+  const trackGsapSaveFailure = vi.fn();
+  const api = renderKeyframeOps({ commitMutation, trackGsapSaveFailure });
+  let committed = true;
+  await act(async () => {
+    committed = await api.moveKeyframe(selection, "box-to-0-position", 50, 75);
+  });
+  return { committed, trackGsapSaveFailure };
+}
+
 describe("useGsapKeyframeOps — resizeKeyframedTween", () => {
   it("issues a resize-keyframed-tween mutation with the remap + window", async () => {
     const commitMutation = successfulCommitMutation();
@@ -64,8 +81,9 @@ describe("useGsapKeyframeOps — resizeKeyframedTween", () => {
       { from: 0, to: 0 },
       { from: 100, to: 100 },
     ];
+    let committed = false;
     await act(async () => {
-      api.resizeKeyframedTween(selection, "box-to-0-opacity", 0.2, 2, pctRemap);
+      committed = await api.resizeKeyframedTween(selection, "box-to-0-opacity", 0.2, 2, pctRemap);
     });
 
     expect(commitMutation).toHaveBeenCalledTimes(1);
@@ -79,6 +97,7 @@ describe("useGsapKeyframeOps — resizeKeyframedTween", () => {
       pctRemap,
     });
     expect(trackGsapSaveFailure).not.toHaveBeenCalled();
+    expect(committed).toBe(true);
   });
 
   it("routes a rejected commit to trackGsapSaveFailure (no unhandled rejection)", async () => {
@@ -89,10 +108,11 @@ describe("useGsapKeyframeOps — resizeKeyframedTween", () => {
     const trackGsapSaveFailure = vi.fn<(...args: unknown[]) => void>();
     const api = renderKeyframeOps({ commitMutation, trackGsapSaveFailure });
 
+    let committed = true;
     await act(async () => {
-      api.resizeKeyframedTween(selection, "box-to-0-opacity", 0.2, 2, [{ from: 100, to: 100 }]);
-      // let the rejected commit promise settle inside act
-      await Promise.resolve();
+      committed = await api.resizeKeyframedTween(selection, "box-to-0-opacity", 0.2, 2, [
+        { from: 100, to: 100 },
+      ]);
     });
 
     expect(trackGsapSaveFailure).toHaveBeenCalledTimes(1);
@@ -101,6 +121,46 @@ describe("useGsapKeyframeOps — resizeKeyframedTween", () => {
     expect(selArg).toBe(selection);
     expect((mutationArg as { type: string }).type).toBe("resize-keyframed-tween");
     expect(labelArg).toBe("Retime keyframe (resize tween)");
+    expect(committed).toBe(false);
+  });
+});
+
+describe("useGsapKeyframeOps — moveKeyframe settlement", () => {
+  it("returns false when the commit settles without a durable writer result", async () => {
+    const { committed, trackGsapSaveFailure } = await moveKeyframeWith(vi.fn(async () => {}));
+
+    expect(committed).toBe(false);
+    expect(trackGsapSaveFailure).not.toHaveBeenCalled();
+  });
+
+  it("returns false when the writer accepts but does not change the keyframe", async () => {
+    const commitMutation = vi.fn(async (...args: unknown[]) => {
+      const options = args[2] as { onResult?: (result: { ok: boolean; changed: boolean }) => void };
+      options.onResult?.({ ok: true, changed: false });
+    });
+    const { committed, trackGsapSaveFailure } = await moveKeyframeWith(commitMutation);
+
+    expect(committed).toBe(false);
+    expect(trackGsapSaveFailure).not.toHaveBeenCalled();
+  });
+
+  it("returns false and tracks a rejected move", async () => {
+    const error = new Error("write failed");
+    const commitMutation = vi.fn().mockRejectedValue(error);
+    const { committed, trackGsapSaveFailure } = await moveKeyframeWith(commitMutation);
+
+    expect(committed).toBe(false);
+    expect(trackGsapSaveFailure).toHaveBeenCalledExactlyOnceWith(
+      error,
+      selection,
+      {
+        type: "move-keyframe",
+        animationId: "box-to-0-position",
+        fromPercentage: 50,
+        toPercentage: 75,
+      },
+      "Move keyframe to 75%",
+    );
   });
 });
 
diff --git a/packages/studio/src/hooks/useGsapKeyframeOps.ts b/packages/studio/src/hooks/useGsapKeyframeOps.ts
index 69107c64bd..b2a9ee3ba9 100644
--- a/packages/studio/src/hooks/useGsapKeyframeOps.ts
+++ b/packages/studio/src/hooks/useGsapKeyframeOps.ts
@@ -236,7 +236,7 @@ export function useGsapKeyframeOps({
   );
 
   const moveKeyframe = useCallback(
-    (
+    async (
       selection: DomEditSelection,
       animationId: string,
       fromPercentage: number,
@@ -247,18 +247,26 @@ export function useGsapKeyframeOps({
       // updateKeyframeCacheFromParsed re-keys the diamond from the fresh parse, so no
       // optimistic cache write is needed (mapping the tween-% to clip-% here would
       // duplicate that math). softReload mirrors remove-keyframe.
-      void commitMutation(selection, mutation, {
-        label: `Move keyframe to ${toPercentage}%`,
-        softReload: true,
-      }).catch((error) => {
+      try {
+        let changed = false;
+        await commitMutation(selection, mutation, {
+          label: `Move keyframe to ${toPercentage}%`,
+          softReload: true,
+          onResult: (result) => {
+            changed = result.changed !== false;
+          },
+        });
+        return changed;
+      } catch (error) {
         trackGsapSaveFailure(error, selection, mutation, `Move keyframe to ${toPercentage}%`);
-      });
+        return false;
+      }
     },
     [commitMutation, trackGsapSaveFailure],
   );
 
   const resizeKeyframedTween = useCallback(
-    (
+    async (
       selection: DomEditSelection,
       animationId: string,
       position: number,
@@ -275,12 +283,20 @@ export function useGsapKeyframeOps({
       // Boundary drag-to-retime: the server re-keys keyframes in place + grows the
       // tween window, preserving _auto / per-keyframe ease / easeEach / outer ease.
       // softReload re-keys the diamonds from the fresh parse (mirrors moveKeyframe).
-      void commitMutation(selection, mutation, {
-        label: "Retime keyframe (resize tween)",
-        softReload: true,
-      }).catch((error) => {
+      try {
+        let changed = false;
+        await commitMutation(selection, mutation, {
+          label: "Retime keyframe (resize tween)",
+          softReload: true,
+          onResult: (result) => {
+            changed = result.changed !== false;
+          },
+        });
+        return changed;
+      } catch (error) {
         trackGsapSaveFailure(error, selection, mutation, "Retime keyframe (resize tween)");
-      });
+        return false;
+      }
     },
     [commitMutation, trackGsapSaveFailure],
   );
diff --git a/packages/studio/src/hooks/useGsapScriptCommits.test.tsx b/packages/studio/src/hooks/useGsapScriptCommits.test.tsx
index 869807eb8a..6236d032ab 100644
--- a/packages/studio/src/hooks/useGsapScriptCommits.test.tsx
+++ b/packages/studio/src/hooks/useGsapScriptCommits.test.tsx
@@ -298,6 +298,27 @@ describe("runCommit — instantPatch wiring", () => {
     expect(deps.showToast).toHaveBeenCalledWith("A keyframe already exists at that time", "info");
   });
 
+  it("publishes the server mutation outcome to callers", async () => {
+    mockFetchResult({ changed: false });
+    const deps = renderCommitHook();
+    let commitResult: MutationResult | undefined;
+
+    await act(async () => {
+      await deps.api.commitMutation(
+        selection,
+        { type: "move-keyframe", fromPercentage: 50, toPercentage: 75 },
+        {
+          label: "Move keyframe",
+          onResult: (result) => {
+            commitResult = result;
+          },
+        },
+      );
+    });
+
+    expect(commitResult).toEqual(expect.objectContaining({ ok: true, changed: false }));
+  });
+
   it("no-op commit with an instantPatch still patches the runtime (paired x/y commits)", async () => {
     patchRuntimeTweenInPlace.mockReturnValue(true);
     mockFetchResult({ changed: false });
diff --git a/packages/studio/src/hooks/useGsapScriptCommits.ts b/packages/studio/src/hooks/useGsapScriptCommits.ts
index f43d42e91b..566d2bc538 100644
--- a/packages/studio/src/hooks/useGsapScriptCommits.ts
+++ b/packages/studio/src/hooks/useGsapScriptCommits.ts
@@ -338,6 +338,7 @@ export function useGsapScriptCommits({ projectIdRef, activeCompPath, previewIfra
       mutateGsapScript(pid, targetPath, mutation),
     );
     if (!result) return;
+    options.onResult?.(result);
     await finalizeSuccessfulMutation(pid, compositionPath, selection, mutation, targetPath, result, options);
   }, [showToast, finalizeSuccessfulMutation]);
 
@@ -350,6 +351,7 @@ export function useGsapScriptCommits({ projectIdRef, activeCompPath, previewIfra
       mutateGsapScriptBatch(pid, targetPath, mutations),
     );
     if (!result) return;
+    options.onResult?.(result);
     await finalizeSuccessfulMutation(pid, compositionPath, last.selection, last.mutation, targetPath, result, options);
   }, [showToast, finalizeSuccessfulMutation]);
 
diff --git a/packages/studio/src/hooks/useGsapSelectionHandlers.test.tsx b/packages/studio/src/hooks/useGsapSelectionHandlers.test.tsx
index f1ae419ec9..3e4c8ea72a 100644
--- a/packages/studio/src/hooks/useGsapSelectionHandlers.test.tsx
+++ b/packages/studio/src/hooks/useGsapSelectionHandlers.test.tsx
@@ -37,8 +37,8 @@ function makeParams(overrides: Partial<Params> = {}): Params {
     addKeyframe: vi.fn(),
     addKeyframeBatch: resolved(),
     removeKeyframe: vi.fn(),
-    moveKeyframe: vi.fn(),
-    resizeKeyframedTween: vi.fn(),
+    moveKeyframe: vi.fn().mockResolvedValue(true),
+    resizeKeyframedTween: vi.fn().mockResolvedValue(true),
     convertToKeyframes: resolved(),
     removeAllKeyframes: resolved(),
     handleDomManualEditsReset: vi.fn(),
@@ -114,3 +114,22 @@ describe("useGsapSelectionHandlers save failures", () => {
     rendered.unmount();
   });
 });
+
+describe("useGsapSelectionHandlers retime settlement", () => {
+  it("returns false without a selection and forwards the mutation result with one", async () => {
+    const moveKeyframe = vi.fn().mockResolvedValue(true);
+    const withoutSelection = renderHandlers(makeParams({ domEditSelection: null, moveKeyframe }));
+    await expect(
+      withoutSelection.handlers().handleGsapMoveKeyframe("anim-1", 50, 75),
+    ).resolves.toBe(false);
+    expect(moveKeyframe).not.toHaveBeenCalled();
+    withoutSelection.unmount();
+
+    const withSelection = renderHandlers(makeParams({ moveKeyframe }));
+    await expect(withSelection.handlers().handleGsapMoveKeyframe("anim-1", 50, 75)).resolves.toBe(
+      true,
+    );
+    expect(moveKeyframe).toHaveBeenCalledOnce();
+    withSelection.unmount();
+  });
+});
diff --git a/packages/studio/src/hooks/useGsapSelectionHandlers.ts b/packages/studio/src/hooks/useGsapSelectionHandlers.ts
index efde12caa5..ca261cb11c 100644
--- a/packages/studio/src/hooks/useGsapSelectionHandlers.ts
+++ b/packages/studio/src/hooks/useGsapSelectionHandlers.ts
@@ -94,14 +94,14 @@ export function useGsapSelectionHandlers({
     animId: string,
     fromPercentage: number,
     toPercentage: number,
-  ) => void;
+  ) => Promise<boolean>;
   resizeKeyframedTween: (
     sel: DomEditSelection,
     animId: string,
     position: number,
     duration: number,
     pctRemap: Array<{ from: number; to: number }>,
-  ) => void;
+  ) => Promise<boolean>;
   convertToKeyframes: (
     sel: DomEditSelection,
     animId: string,
@@ -326,15 +326,20 @@ export function useGsapSelectionHandlers({
   );
 
   const handleGsapMoveKeyframeToPlayhead = useCallback(
-    (animId: string, fromPercentage: number, selectionOverride?: DomEditSelection | null) => {
+    (
+      animId: string,
+      fromPercentage: number,
+      selectionOverride?: DomEditSelection | null,
+      animationOverride?: GsapAnimation,
+    ) => {
       const sel = selectionOverride ?? domEditSelection ?? lastSelectionRef.current;
       if (!sel) return;
       // Retime the keyframe to the playhead, preserving its value + ease. The
       // playhead's tween-relative percentage is the move target.
-      const anim = selectedGsapAnimations.find((a) => a.id === animId);
+      const anim = animationOverride ?? selectedGsapAnimations.find((a) => a.id === animId);
       const toPercentage = computeCurrentPercentage(sel, anim);
       trackStudioEvent("keyframe", { action: "move_to_playhead" });
-      moveKeyframe(sel, animId, fromPercentage, toPercentage);
+      void moveKeyframe(sel, animId, fromPercentage, toPercentage);
     },
     [domEditSelection, selectedGsapAnimations, moveKeyframe],
   );
@@ -347,13 +352,13 @@ export function useGsapSelectionHandlers({
       selectionOverride?: DomEditSelection | null,
     ) => {
       const sel = selectionOverride ?? domEditSelection ?? lastSelectionRef.current;
-      if (!sel) return;
+      if (!sel) return Promise.resolve(false);
       // Atomic retime: preserves the keyframe's value + per-keyframe ease. Both
       // percentages are tween-relative (the drag handler converts the drop
       // position before calling). No optimistic runtime hold — the soft-reload
       // re-keys the diamond from source.
       trackStudioEvent("keyframe", { action: "retime" });
-      moveKeyframe(sel, animId, fromPercentage, toPercentage);
+      return moveKeyframe(sel, animId, fromPercentage, toPercentage);
     },
     [domEditSelection, moveKeyframe],
   );
@@ -367,11 +372,11 @@ export function useGsapSelectionHandlers({
       selectionOverride?: DomEditSelection | null,
     ) => {
       const sel = selectionOverride ?? domEditSelection ?? lastSelectionRef.current;
-      if (!sel) return;
+      if (!sel) return Promise.resolve(false);
       // Boundary drag-to-retime: grows/shifts the tween window + re-keys keyframes
       // in place. Distinct telemetry action so resize is separable from in-window move.
       trackStudioEvent("keyframe", { action: "retime_resize" });
-      resizeKeyframedTween(sel, animId, position, duration, pctRemap);
+      return resizeKeyframedTween(sel, animId, position, duration, pctRemap);
     },
     [domEditSelection, resizeKeyframedTween],
   );
@@ -403,11 +408,12 @@ export function useGsapSelectionHandlers({
   );
 
   const handleGsapRemoveAllKeyframes = useCallback(
-    (animId: string) => {
-      if (!domEditSelection) return;
+    (animId: string, selectionOverride?: DomEditSelection | null) => {
+      const selection = selectionOverride ?? domEditSelection ?? lastSelectionRef.current;
+      if (!selection) return;
       observeGsapMutation(
-        removeAllKeyframes(domEditSelection, animId),
-        domEditSelection,
+        removeAllKeyframes(selection, animId),
+        selection,
         "remove-all-keyframes",
         "Remove all keyframes",
       );
diff --git a/packages/studio/src/hooks/useStudioTestHooks.ts b/packages/studio/src/hooks/useStudioTestHooks.ts
index 3453d0be8f..a434677c4a 100644
--- a/packages/studio/src/hooks/useStudioTestHooks.ts
+++ b/packages/studio/src/hooks/useStudioTestHooks.ts
@@ -10,6 +10,16 @@ interface StudioTestHookDeps {
   ) => void;
 }
 
+interface StudioTestApi {
+  selectByDomId: (id: string) => Promise<boolean>;
+}
+
+declare global {
+  interface Window {
+    __studioTest?: StudioTestApi;
+  }
+}
+
 /**
  * Dev-only headless-QA shortcut. Selecting an element normally requires a
  * pixel-precise click inside the preview iframe, which automated verification
@@ -33,7 +43,7 @@ export function useStudioTestHooks({
       isDev = false;
     }
     if (!isDev || typeof window === "undefined") return;
-    const api = {
+    const api: StudioTestApi = {
       selectByDomId: async (id: string): Promise<boolean> => {
         const element = previewIframeRef.current?.contentDocument?.getElementById(id) ?? null;
         if (!element) return false;
@@ -43,11 +53,11 @@ export function useStudioTestHooks({
         return true;
       },
     };
-    (window as unknown as { __studioTest?: typeof api }).__studioTest = api;
+    window.__studioTest = api;
     return () => {
       // delete, not `= undefined`: an own key holding undefined keeps
       // `"__studioTest" in window` true, which defeats feature detection.
-      delete (window as unknown as { __studioTest?: typeof api }).__studioTest;
+      delete window.__studioTest;
     };
   }, [applyDomSelection, buildDomSelectionFromTarget, previewIframeRef]);
 }
diff --git a/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx b/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
index e40f0c295b..1e8275511b 100644
--- a/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
+++ b/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
@@ -1,10 +1,12 @@
 import { memo } from "react";
 import { createPortal } from "react-dom";
 import { useContextMenuDismiss } from "../../hooks/useContextMenuDismiss";
+import type { TimelineElement } from "../store/playerStore";
 
 export interface KeyframeDiamondContextMenuState {
   x: number;
   y: number;
+  element: TimelineElement;
   elementId: string;
   percentage: number;
   tweenPercentage?: number;
@@ -23,12 +25,12 @@ interface KeyframeDiamondContextMenuProps {
     tweenPercentage?: number,
     animationId?: string,
   ) => void;
-  onDeleteAll: (elementId: string) => void;
+  onDeleteAll: (element: TimelineElement) => void;
   onChangeEase?: (elementId: string, percentage: number, ease: string) => void;
   onCopyProperties?: (elementId: string, percentage: number) => void;
   /** Retime the keyframe to the current playhead, preserving its value + ease. */
   onMoveToPlayhead?: (
-    elementId: string,
+    element: TimelineElement,
     fromPercentage: number,
     propertyGroup?: string,
     tweenPercentage?: number,
@@ -66,7 +68,7 @@ export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMe
             // and returns the tween-% for the mutation. Passing tween-% here would
             // miss the lookup on any tween whose window is shorter than the clip.
             onMoveToPlayhead(
-              state.elementId,
+              state.element,
               state.percentage,
               state.propertyGroup,
               state.tweenPercentage,
@@ -101,7 +103,7 @@ export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMe
         type="button"
         className="w-full flex items-center gap-2 px-3 py-1.5 text-xs text-red-400 hover:bg-neutral-800 cursor-pointer text-left"
         onClick={() => {
-          onDeleteAll(state.elementId);
+          onDeleteAll(state.element);
           onClose();
         }}
       >
diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 0e847a3fab..037b0bac1c 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -435,6 +435,9 @@ export const Timeline = memo(function Timeline({
         onDragLeave={() => clearDropPreview()}
         onDrop={handleAssetDrop}
         onPointerDown={(e) => {
+          // Let interactive controls (keyframe nav/toggle, caret, inputs) handle
+          // their own clicks — scrubbing here would preventDefault and eat them.
+          if (e.target instanceof Element && e.target.closest("button, input, select, a")) return;
           if (activeTool === "razor" && e.shiftKey && e.button === 0 && scrollRef.current) {
             const rect = scrollRef.current.getBoundingClientRect();
             const x =
@@ -512,15 +515,15 @@ export const Timeline = memo(function Timeline({
           onMoveKeyframe={onMoveKeyframe}
           onContextMenuKeyframe={(e, elId, pct) => {
             const el = expandedElements.find((x) => (x.key ?? x.id) === elId);
-            if (el) {
-              setSelectedElementId(elId);
-              onSelectElement?.(el);
-            }
+            if (!el) return;
+            setSelectedElementId(elId);
+            onSelectElement?.(el);
             const kfData = keyframeCache.get(elId);
             const kf = kfData?.keyframes.find((k) => Math.abs(k.percentage - pct) < 0.2);
             setKfContextMenu({
               x: e.clientX + 4,
               y: e.clientY + 2,
+              element: el,
               elementId: elId,
               percentage: pct,
               tweenPercentage: kf?.tweenPercentage,
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
index 7a6022a846..2a41e78413 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
@@ -45,6 +45,42 @@ function renderDiamonds(onClickKeyframe = vi.fn()) {
 }
 
 describe("TimelineClipDiamonds", () => {
+  it("keeps dense keyframe hit regions and visuals from overlapping", () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() => {
+      root.render(
+        <TimelineDiamondLane
+          keyframesData={{
+            format: "percentage",
+            keyframes: [30, 60, 90].map((percentage) => ({
+              percentage,
+              propertyGroup: "position",
+              properties: { x: percentage },
+            })),
+          }}
+          clipWidthPx={36}
+          clipHeightPx={48}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={0}
+          elementId="clip-1"
+          selectedKeyframes={new Set()}
+          groupAware
+        />,
+      );
+    });
+
+    const diamonds = Array.from(host.querySelectorAll<HTMLButtonElement>("button[title]"));
+    expect(diamonds).toHaveLength(3);
+    for (const diamond of diamonds) {
+      expect(Number.parseFloat(diamond.style.width)).toBeCloseTo(10.8);
+      expect(Number(diamond.querySelector("svg")?.getAttribute("width"))).toBeCloseTo(8.8);
+    }
+    act(() => root.unmount());
+  });
+
   it("treats primary pointerup without drag as a keyframe click", () => {
     const { host, root, onClickKeyframe } = renderDiamonds();
     const diamond = host.querySelector<HTMLButtonElement>('button[title="50%"]');
@@ -516,6 +552,18 @@ describe("TimelineClipDiamonds", () => {
     act(() => root.unmount());
   });
 
+  it("keeps the ease button above nearby diamonds without blocking the segment", () => {
+    const { host, root } = renderSegmentLane(false);
+    const segment = host.querySelector<HTMLElement>("[data-keyframe-ease-segment]");
+    const ease = segment?.querySelector<HTMLButtonElement>("[data-keyframe-ease-button]");
+    const diamond = host.querySelector<HTMLButtonElement>('button[title="50%"]');
+
+    expect(segment?.style.pointerEvents).toBe("none");
+    expect(ease?.style.pointerEvents).toBe("auto");
+    expect(Number(segment?.style.zIndex)).toBeGreaterThan(Number(diamond?.style.zIndex));
+    act(() => root.unmount());
+  });
+
   it("hides the inline ease button on a segment with no source animation id", () => {
     // A runtime-scanned keyframe has no animationId, so there is no tween to
     // target; the segment ending on it must not render a (dead) ease button.
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 09320bdc57..10c58dfcf5 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -183,10 +183,6 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
       cancelPreviewFrame();
     };
   }, []);
-  // Index of the segment whose mid-point ease button is revealed on hover, like
-  // Figma. Null = no segment hovered → no button shown (resting state is just
-  // the connector line + diamonds).
-  const [hoveredSegment, setHoveredSegment] = useState<number | null>(null);
   // The button element can re-render (reposition/unmount) synchronously from
   // the state updates onClickKeyframe/onMoveKeyframe trigger, before the
   // browser gets to auto-synthesize the "click" event that normally follows
@@ -213,7 +209,6 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   const diamondSize = beatsActive
     ? Math.round(clipHeightPx * 0.45)
     : Math.round(LANE_H * DIAMOND_RATIO);
-  const half = diamondSize / 2;
   const centerY = beatsActive ? BEAT_BAND_H + (clipHeightPx - BEAT_BAND_H) / 2 : clipHeightPx / 2;
   const sorted = keyframesData.keyframes
     .filter((kf) => kf.percentage >= KF_MIN_PCT && kf.percentage <= KF_MAX_PCT)
@@ -221,6 +216,20 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   // Clip-%s of the sorted keyframes — the neighbour clamp (preview + drop) needs
   // the whole row to bound the dragged diamond between its immediate siblings.
   const sortedClipPcts = sorted.map((k) => k.percentage);
+  const sortedCenterXs = sorted.map((keyframe) =>
+    Math.max(0, Math.min(clipWidthPx, (keyframe.percentage / 100) * clipWidthPx)),
+  );
+  const markerMetrics = sortedCenterXs.map((centerX, index) => {
+    const previousGap = index > 0 ? centerX - sortedCenterXs[index - 1]! : Infinity;
+    const nextGap =
+      index < sortedCenterXs.length - 1 ? sortedCenterXs[index + 1]! - centerX : Infinity;
+    const nearestGap = Math.max(1, Math.min(previousGap, nextGap));
+    const hitWidth = Math.min(diamondSize, nearestGap);
+    return {
+      hitWidth,
+      visualSize: hitWidth === diamondSize ? diamondSize : Math.max(2, hitWidth - 2),
+    };
+  });
   const baseColor = isSelected ? accentColor : "#a3a3a3";
   const baseOpacity = isSelected ? 0.4 : 0.25;
   const canDrag = isSelected && !!onMoveKeyframe;
@@ -240,11 +249,14 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
       }}
     >
       {sorted.map((kf, i) => {
-        const prev = sorted[i - 1];
-        if (!prev) return null;
-        const x1 = Math.max(0, Math.min(clipWidthPx, (prev.percentage / 100) * clipWidthPx));
-        const x2 = Math.max(0, Math.min(clipWidthPx, (kf.percentage / 100) * clipWidthPx));
+        if (i === 0) return null;
+        const prev = sorted[i - 1]!;
+        const x1 = sortedCenterXs[i - 1]!;
+        const x2 = sortedCenterXs[i]!;
         if (x2 - x1 < 1) return null;
+        const connectorLeft = x1 + markerMetrics[i - 1]!.visualSize / 2;
+        const connectorWidth =
+          x2 - x1 - markerMetrics[i - 1]!.visualSize / 2 - markerMetrics[i]!.visualSize / 2;
         // Group-aware target for the ease button: the segment ease is
         // per-keyframe (each keyframe carries its own animationId/tweenPercentage).
         // On a merged inline row the button is hidden where the segment is
@@ -259,9 +271,9 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               className="absolute"
               data-keyframe-connector={groupAware ? "" : undefined}
               style={{
-                left: x1,
+                left: connectorLeft,
                 top: centerY,
-                width: x2 - x1,
+                width: Math.max(0, connectorWidth),
                 height: 2,
                 transform: "translateY(-1px)",
                 background: baseColor,
@@ -271,7 +283,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
             />
             {onSelectSegment && !kf.easeAmbiguous && kf.animationId !== undefined && (
               <div
-                className="absolute"
+                className="group absolute"
                 data-keyframe-ease-segment=""
                 style={{
                   left: x1,
@@ -279,40 +291,43 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
                   width: x2 - x1,
                   height: 18,
                   transform: "translateY(-50%)",
-                  pointerEvents: "auto",
+                  // Own a stacking context above the diamond buttons. At fit
+                  // zoom the 16px ease control can overlap its neighbouring
+                  // diamond; without a z-index here the later diamond wins the
+                  // hit test even though the child button has z-index 3.
+                  zIndex: 3,
+                  // Only the centered control is interactive. The transparent
+                  // segment wrapper must not swallow connector/clip gestures.
+                  pointerEvents: "none",
                 }}
-                onMouseEnter={() => setHoveredSegment(i)}
-                onMouseLeave={() => setHoveredSegment((h) => (h === i ? null : h))}
               >
-                {hoveredSegment === i && (
-                  <button
-                    type="button"
-                    data-keyframe-ease-button=""
-                    aria-label={`Edit ${ease} easing`}
-                    title={`Edit ${ease} easing`}
-                    className="absolute flex items-center justify-center rounded"
-                    style={{
-                      left: "50%",
-                      top: "50%",
-                      width: 16,
-                      height: 16,
-                      transform: "translate(-50%, -50%)",
-                      zIndex: 3,
-                      pointerEvents: "auto",
-                      padding: 0,
-                      border: "1px solid rgba(255, 255, 255, 0.14)",
-                      background: "#171717",
-                      cursor: "pointer",
-                    }}
-                    onPointerDown={(e) => e.stopPropagation()}
-                    onClick={(e) => {
-                      e.stopPropagation();
-                      onSelectSegment(target);
-                    }}
-                  >
-                    <MiniCurveSvg ease={ease} active size={12} />
-                  </button>
-                )}
+                <button
+                  type="button"
+                  data-keyframe-ease-button=""
+                  aria-label={`Edit ${ease} easing`}
+                  title={`Edit ${ease} easing`}
+                  className="absolute flex items-center justify-center rounded opacity-0 transition-opacity group-hover:opacity-100 focus-visible:opacity-100"
+                  style={{
+                    left: "50%",
+                    top: "50%",
+                    width: 16,
+                    height: 16,
+                    transform: "translate(-50%, -50%)",
+                    zIndex: 3,
+                    pointerEvents: "auto",
+                    padding: 0,
+                    border: "1px solid rgba(255, 255, 255, 0.14)",
+                    background: "#171717",
+                    cursor: "pointer",
+                  }}
+                  onPointerDown={(e) => e.stopPropagation()}
+                  onClick={(e) => {
+                    e.stopPropagation();
+                    onSelectSegment(target);
+                  }}
+                >
+                  <MiniCurveSvg ease={ease} active size={12} />
+                </button>
               </div>
             )}
           </Fragment>
@@ -324,12 +339,13 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         const kfKey = timelineKeyframeSelectionKey(elementId, target);
         // While dragging this diamond, render it at the live preview clip-%.
         const renderPct = preview?.kfKey === kfKey ? preview.clipPct : kf.percentage;
-        // Center the diamond ON its keyframe %: left = (% · width) − half, so the
-        // diamond's midpoint sits exactly on the playhead/ruler x for that time.
+        // Center the marker's non-overlapping hit region ON its keyframe %, so
+        // the diamond's midpoint sits exactly on the playhead/ruler x for that time.
         // The 0% diamond's left half lands in the reserved left gutter (the
         // content origin is inset past the label column, Figma-style) so it stays
         // fully visible instead of being clipped by the sticky label column.
-        const leftPx = (renderPct / 100) * clipWidthPx - half;
+        const marker = markerMetrics[i]!;
+        const leftPx = (renderPct / 100) * clipWidthPx - marker.hitWidth / 2;
         const isKfSelected = selectedKeyframes.has(kfKey);
         const atPlayhead = isSelected && Math.abs(kf.percentage - currentPercentage) < 0.5;
         const isHighlighted = isKfSelected || atPlayhead;
@@ -480,7 +496,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               left: leftPx,
               top: centerY,
               transform: "translateY(-50%)",
-              width: diamondSize,
+              width: marker.hitWidth,
               height: diamondSize,
               zIndex: isHighlighted ? 2 : 1,
               pointerEvents: "auto",
@@ -489,6 +505,10 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               cursor: canDrag ? "ew-resize" : "pointer",
               padding: 0,
               touchAction: "none",
+              display: "flex",
+              alignItems: "center",
+              justifyContent: "center",
+              overflow: "visible",
             }}
             onPointerDown={onPointerDown}
             onPointerMove={onPointerMove}
@@ -510,7 +530,12 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
             }}
             title={`${kf.percentage}%`}
           >
-            <svg width={diamondSize} height={diamondSize} viewBox="0 0 10 10">
+            <svg
+              width={marker.visualSize}
+              height={marker.visualSize}
+              viewBox="0 0 10 10"
+              style={{ flexShrink: 0, pointerEvents: "none" }}
+            >
               {isKfSelected && (
                 <path
                   d="M5 0L10 5L5 10L0 5Z"
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
index 475dbd1e96..200f25d8c1 100644
--- a/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
@@ -112,13 +112,7 @@ function laneEaseSegments(host: HTMLElement, group: string): HTMLElement[] {
   );
 }
 
-// The mid-segment ease button is revealed on hover (Figma parity), so tests must
-// hover the segment strip before its button exists. React derives onMouseEnter
-// from a bubbling mouseover, so dispatching that is what arms the hover.
 function revealEaseButton(segment: HTMLElement): HTMLButtonElement | null {
-  act(() => {
-    segment.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-  });
   return segment.querySelector<HTMLButtonElement>("button[data-keyframe-ease-button]");
 }
 
@@ -281,7 +275,7 @@ describe("TimelinePropertyLanes", () => {
     act(() => root.unmount());
   });
 
-  it("reveals one midpoint ease button per segment on hover, regardless of selection", () => {
+  it("keeps one accessible midpoint ease button per segment, regardless of selection", () => {
     const animations = [
       animation("position-tween", "position", [
         { percentage: 0, properties: { x: 0 } },
@@ -295,12 +289,15 @@ describe("TimelinePropertyLanes", () => {
     expect(segments).toHaveLength(2);
     expect(segments.map((segment) => segment.style.left)).toEqual(["0px", "100px"]);
     expect(laneDiamonds(host, "position")).toHaveLength(3);
-    // Resting state: no button until a segment is hovered.
-    expect(laneEaseButtons(host, "position")).toHaveLength(0);
-
-    // Hovering reveals exactly one button — the hovered segment's.
-    expect(revealEaseButton(segments[0]!)).not.toBeNull();
-    expect(laneEaseButtons(host, "position")).toHaveLength(1);
+    const buttons = laneEaseButtons(host, "position");
+    expect(buttons).toHaveLength(2);
+    expect(buttons.every((button) => button.classList.contains("opacity-0"))).toBe(true);
+    expect(buttons.every((button) => button.classList.contains("group-hover:opacity-100"))).toBe(
+      true,
+    );
+    expect(buttons.every((button) => button.classList.contains("focus-visible:opacity-100"))).toBe(
+      true,
+    );
 
     // The ease button is available on hover even when the element is NOT selected
     // (a lane shows for the track's active/primary clip, not only the selected one).
diff --git a/packages/studio/src/player/components/timelineCallbacks.ts b/packages/studio/src/player/components/timelineCallbacks.ts
index 204302e4bd..969cc0ab31 100644
--- a/packages/studio/src/player/components/timelineCallbacks.ts
+++ b/packages/studio/src/player/components/timelineCallbacks.ts
@@ -73,9 +73,9 @@ export interface TimelineEditCallbacks {
   onRazorSplit?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
   onRazorSplitAll?: (splitTime: number) => Promise<void> | void;
   onDeleteKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
-  onDeleteAllKeyframes?: (elementId: string) => void;
+  onDeleteAllKeyframes?: (element: TimelineElement) => void;
   onChangeKeyframeEase?: (elementId: string, percentage: number, ease: string) => void;
-  onMoveKeyframeToPlayhead?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
+  onMoveKeyframeToPlayhead?: (element: TimelineElement, keyframe: TimelineKeyframeTarget) => void;
   /** Drag-to-retime: `keyframe` identifies the dragged keyframe (its percentage
    *  is clip-relative), `toClipPercentage` is the neighbour-clamped drop. */
   onMoveKeyframe?: (
diff --git a/packages/studio/src/player/components/timelineKeyframeIdentity.test.ts b/packages/studio/src/player/components/timelineKeyframeIdentity.test.ts
new file mode 100644
index 0000000000..5b774715ae
--- /dev/null
+++ b/packages/studio/src/player/components/timelineKeyframeIdentity.test.ts
@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import {
+  timelineKeyframeSelectionKey,
+  timelineKeyframeTargetFromSelectionKey,
+} from "./timelineKeyframeIdentity";
+
+describe("timeline keyframe selection identity", () => {
+  it("round-trips an expanded lane with colon-bearing identities", () => {
+    const key = timelineKeyframeSelectionKey("comp#a:child", {
+      percentage: 75,
+      tweenPercentage: 40,
+      propertyGroup: "position",
+      animationId: "child:position",
+    });
+
+    expect(timelineKeyframeTargetFromSelectionKey("comp#a:child", key)).toEqual({
+      percentage: 75,
+      tweenPercentage: 40,
+      propertyGroup: "position",
+      animationId: "child:position",
+    });
+  });
+
+  it("does not confuse an expanded lane whose element id extends the active id", () => {
+    const key = timelineKeyframeSelectionKey("comp#a:child", {
+      percentage: 75,
+      tweenPercentage: 40,
+      propertyGroup: "position",
+      animationId: "child-position",
+    });
+
+    expect(timelineKeyframeTargetFromSelectionKey("comp#a", key)).toBeNull();
+  });
+
+  it("retains the collapsed key fallback and rejects malformed percentages", () => {
+    expect(timelineKeyframeTargetFromSelectionKey("comp#a", "comp#a:30")).toEqual({
+      percentage: 30,
+    });
+    expect(timelineKeyframeTargetFromSelectionKey("comp#a", "comp#a:NaN")).toBeNull();
+    expect(timelineKeyframeTargetFromSelectionKey("comp#a", "comp#b:30")).toBeNull();
+  });
+});
diff --git a/packages/studio/src/player/components/timelineKeyframeIdentity.ts b/packages/studio/src/player/components/timelineKeyframeIdentity.ts
index 8cf58d7118..c9b761784a 100644
--- a/packages/studio/src/player/components/timelineKeyframeIdentity.ts
+++ b/packages/studio/src/player/components/timelineKeyframeIdentity.ts
@@ -10,8 +10,50 @@ export function timelineKeyframeSelectionKey(
   target: TimelineKeyframeTarget,
 ): string {
   if (!target.propertyGroup) return `${elementId}:${target.percentage}`;
-  const groupKey = target.animationId
-    ? `${target.propertyGroup}:${target.animationId}`
-    : target.propertyGroup;
-  return `${elementId}:${groupKey}:${target.percentage}`;
+  return JSON.stringify([
+    elementId,
+    target.propertyGroup,
+    target.animationId ?? "",
+    target.percentage,
+    target.tweenPercentage ?? target.percentage,
+  ]);
+}
+
+export function timelineKeyframeTargetFromSelectionKey(
+  elementId: string,
+  key: string,
+): TimelineKeyframeTarget | null {
+  if (key.startsWith("[")) {
+    let decoded: unknown;
+    try {
+      decoded = JSON.parse(key);
+    } catch {
+      return null;
+    }
+    if (!Array.isArray(decoded) || decoded.length !== 5) return null;
+    const [selectedElementId, propertyGroup, animationId, percentage, tweenPercentage] = decoded;
+    if (
+      selectedElementId !== elementId ||
+      typeof propertyGroup !== "string" ||
+      propertyGroup.length === 0 ||
+      typeof animationId !== "string" ||
+      typeof percentage !== "number" ||
+      !Number.isFinite(percentage) ||
+      typeof tweenPercentage !== "number" ||
+      !Number.isFinite(tweenPercentage)
+    ) {
+      return null;
+    }
+    return {
+      propertyGroup,
+      animationId: animationId || undefined,
+      percentage,
+      tweenPercentage,
+    };
+  }
+
+  const separator = key.lastIndexOf(":");
+  if (separator < 0 || key.slice(0, separator) !== elementId) return null;
+  const percentage = Number(key.slice(separator + 1));
+  return Number.isFinite(percentage) ? { percentage } : null;
 }
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
index e697d49277..2d18bace17 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
@@ -77,10 +77,9 @@ export function useTimelineKeyframeHandlers({
   const onContextMenuKeyframe = useCallback(
     (e: ReactMouseEvent, elId: string, target: TimelineKeyframeTarget) => {
       const el = expandedElements.find((item) => (item.key ?? item.id) === elId);
-      if (el) {
-        setSelectedElementId(elId);
-        onSelectElement?.(el);
-      }
+      if (!el) return;
+      setSelectedElementId(elId);
+      onSelectElement?.(el);
       const kfData = keyframeCache.get(elId);
       const kf = kfData?.keyframes.find(
         (item) => Math.abs(item.percentage - target.percentage) < 0.2,
@@ -93,6 +92,7 @@ export function useTimelineKeyframeHandlers({
         tweenPercentage: target.tweenPercentage ?? kf?.tweenPercentage,
         propertyGroup: target.propertyGroup,
         animationId: target.animationId,
+        element: el,
         currentEase: kf?.ease ?? kfData?.ease,
       });
     },
diff --git a/packages/studio/src/utils/globalTimeCompiler.test.ts b/packages/studio/src/utils/globalTimeCompiler.test.ts
index 963968f09c..ddf85b82df 100644
--- a/packages/studio/src/utils/globalTimeCompiler.test.ts
+++ b/packages/studio/src/utils/globalTimeCompiler.test.ts
@@ -31,6 +31,12 @@ describe("absoluteToPercentage", () => {
     expect(absoluteToPercentage(1.0, 0.5, 1)).toBe(50);
   });
 
+  test("preserves playhead timing beyond tenths of a percent", () => {
+    const percentage = absoluteToPercentage(17, 12.17, 20);
+    expect(percentage).toBe(24.15);
+    expect(percentageToAbsolute(percentage, 12.17, 20)).toBe(17);
+  });
+
   test("clamps below tween start to 0%", () => {
     expect(absoluteToPercentage(-1, 0, 2)).toBe(0);
   });
@@ -106,6 +112,10 @@ describe("resolveTweenDuration", () => {
   test("missing duration defaults to GSAP default (0.5)", () => {
     expect(resolveTweenDuration(makeAnim({ duration: undefined }))).toBe(0.5);
   });
+
+  test("missing duration can use its editor timing basis", () => {
+    expect(resolveTweenDuration(makeAnim({ duration: undefined }), 16.26)).toBe(16.26);
+  });
 });
 
 describe("findTweenAtTime", () => {
diff --git a/packages/studio/src/utils/globalTimeCompiler.ts b/packages/studio/src/utils/globalTimeCompiler.ts
index 3f050f9250..5d158379f9 100644
--- a/packages/studio/src/utils/globalTimeCompiler.ts
+++ b/packages/studio/src/utils/globalTimeCompiler.ts
@@ -7,7 +7,7 @@ export function absoluteToPercentage(
 ): number {
   if (tweenDuration <= 0) return 0;
   const raw = ((time - tweenStart) / tweenDuration) * 100;
-  return Math.max(0, Math.min(100, Math.round(raw * 10) / 10));
+  return Math.max(0, Math.min(100, Math.round(raw * 1000) / 1000));
 }
 
 export function percentageToAbsolute(
@@ -34,8 +34,8 @@ export function resolveTweenStart(animation: GsapAnimation): number | null {
   return null;
 }
 
-export function resolveTweenDuration(animation: GsapAnimation): number {
-  return animation.duration ?? 0.5;
+export function resolveTweenDuration(animation: GsapAnimation, fallback = 0.5): number {
+  return animation.duration ?? fallback;
 }
 
 export function findTweenAtTime(
diff --git a/packages/studio/src/utils/keyframeSelection.test.ts b/packages/studio/src/utils/keyframeSelection.test.ts
deleted file mode 100644
index 6d8f91e774..0000000000
--- a/packages/studio/src/utils/keyframeSelection.test.ts
+++ /dev/null
@@ -1,45 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { selectedKeyframePercentagesForElement } from "./keyframeSelection";
-
-describe("selectedKeyframePercentagesForElement", () => {
-  it("returns the percentages of keyframes on the active element", () => {
-    const selected = new Set(["comp#a:25", "comp#a:75"]);
-    expect(selectedKeyframePercentagesForElement(selected, "comp#a")).toEqual([25, 75]);
-  });
-
-  it("drops keyframes that belong to other elements", () => {
-    // The bug: a stale shift-selection on `comp#b` would otherwise have its
-    // percentages applied to the now-active `comp#a`, deleting the wrong keyframes.
-    const selected = new Set(["comp#a:25", "comp#b:50", "comp#b:80"]);
-    expect(selectedKeyframePercentagesForElement(selected, "comp#a")).toEqual([25]);
-  });
-
-  it("returns nothing when no key belongs to the active element", () => {
-    const selected = new Set(["comp#b:50"]);
-    expect(selectedKeyframePercentagesForElement(selected, "comp#a")).toEqual([]);
-  });
-
-  it("returns nothing when there is no active element", () => {
-    const selected = new Set(["comp#a:25"]);
-    expect(selectedKeyframePercentagesForElement(selected, null)).toEqual([]);
-  });
-
-  it("returns nothing for an empty selection", () => {
-    expect(selectedKeyframePercentagesForElement(new Set(), "comp#a")).toEqual([]);
-  });
-
-  it("splits on the final colon so element ids containing ':' still match", () => {
-    const selected = new Set(["a:b:40"]);
-    expect(selectedKeyframePercentagesForElement(selected, "a:b")).toEqual([40]);
-  });
-
-  it("skips keys without a percentage separator", () => {
-    const selected = new Set(["comp#a"]);
-    expect(selectedKeyframePercentagesForElement(selected, "comp#a")).toEqual([]);
-  });
-
-  it("skips keys whose percentage is not a finite number", () => {
-    const selected = new Set(["comp#a:abc", "comp#a:NaN", "comp#a:30"]);
-    expect(selectedKeyframePercentagesForElement(selected, "comp#a")).toEqual([30]);
-  });
-});
diff --git a/packages/studio/src/utils/keyframeSelection.ts b/packages/studio/src/utils/keyframeSelection.ts
deleted file mode 100644
index 3ecaa36b91..0000000000
--- a/packages/studio/src/utils/keyframeSelection.ts
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * Resolves which keyframe percentages a bulk operation should act on.
- *
- * `selectedKeyframes` holds `"<elementId>:<percentage>"` keys and can contain
- * keyframes from more than one element — e.g. a shift-selection made before the
- * active element changed (via a keyframe click, a clip click, the layers panel,
- * or the keyframe context menu). A bulk delete only targets the active
- * element's animation, so keys belonging to other elements must be dropped;
- * otherwise their percentages get applied to the active element and remove
- * keyframes the user never selected on it.
- *
- * The element id is everything before the final `:` so element ids that happen
- * to contain `:` are handled correctly.
- */
-export function selectedKeyframePercentagesForElement(
-  selectedKeyframes: ReadonlySet<string>,
-  activeElementId: string | null,
-): number[] {
-  if (!activeElementId) return [];
-  const percentages: number[] = [];
-  for (const key of selectedKeyframes) {
-    const separator = key.lastIndexOf(":");
-    if (separator < 0) continue;
-    if (key.slice(0, separator) !== activeElementId) continue;
-    const percentage = Number(key.slice(separator + 1));
-    if (Number.isFinite(percentage)) percentages.push(percentage);
-  }
-  return percentages;
-}
diff --git a/packages/studio/tests/e2e/fixtures/design-panel-qa/index.html b/packages/studio/tests/e2e/fixtures/design-panel-qa/index.html
index b5e3754014..6e325b47fb 100644
--- a/packages/studio/tests/e2e/fixtures/design-panel-qa/index.html
+++ b/packages/studio/tests/e2e/fixtures/design-panel-qa/index.html
@@ -232,7 +232,7 @@ <h1 id="qa-headline" data-hf-id="qa-headline">Static Headline</h1>
       const tl = gsap.timeline({ paused: true });
       tl.to("#qa-tween-box", { x: 300, rotation: 90, duration: 2, ease: "power1.inOut" }, 0);
       tl.to(
-        "#qa-keyframe-box",
+        "#qa-zone-keyframe",
         {
           keyframes: [
             { x: 0, y: 0, duration: 1 },

From 14c10d9cd7a8c0a3745cc28202a8cf5c75ce163c Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 23:14:21 +0200
Subject: [PATCH 087/125] fix(studio): span the clip on the remaining
 duration-less tween paths

Two sibling call paths still answered from GSAP's 0.5s default while the
toggle path had moved to the clip-wide fallback.

isPlayheadWithinTween now takes the selection, so the toolbar stops
promising "extends animation" on a duration-less tween whose click actually
toggles an interior keyframe. The arc drag commit resolves its replacement
duration the same way its click-path sibling does, instead of authoring
duration 0.5 and collapsing the arc window.

The flat text section drops its two marker-clearing effects: the autofocus
marker is a ref now, read and cleared by the render that consumes it.
---
 .../studio/src/components/TimelineToolbar.tsx |  2 +-
 .../editor/propertyPanelFlatTextSection.tsx   | 28 ++++++++-----------
 .../src/hooks/gsapDragPositionCommit.ts       |  5 +++-
 .../src/hooks/useEnableKeyframes.test.ts      | 13 +++++++++
 .../studio/src/hooks/useEnableKeyframes.ts    | 15 ++++++++--
 .../components/timelineKeyframeIdentity.ts    |  7 +++++
 6 files changed, 50 insertions(+), 20 deletions(-)

diff --git a/packages/studio/src/components/TimelineToolbar.tsx b/packages/studio/src/components/TimelineToolbar.tsx
index 43416414d5..3b42013b83 100644
--- a/packages/studio/src/components/TimelineToolbar.tsx
+++ b/packages/studio/src/components/TimelineToolbar.tsx
@@ -73,7 +73,7 @@ function resolveKeyframeToggleState(
   if (!animation?.keyframes) return NO_KEYFRAME_TOGGLE;
 
   const isMotionPath = Boolean(arcAnimation);
-  if (!isPlayheadWithinTween(animation, currentTime)) {
+  if (!isPlayheadWithinTween(animation, currentTime, session.domEditSelection)) {
     return { state: "inactive", isMotionPath, pathEndpoint: false, willExtend: true };
   }
 
diff --git a/packages/studio/src/components/editor/propertyPanelFlatTextSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatTextSection.tsx
index 636955de60..a85670abea 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatTextSection.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatTextSection.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useState } from "react";
+import { useEffect, useRef, useState } from "react";
 import { useTrackDesignInput } from "../../contexts/DesignPanelInputContext";
 import { Plus, X } from "../../icons/SystemIcons";
 import { isTextEditableSelection, type DomEditSelection } from "./domEditing";
@@ -257,7 +257,10 @@ export function FlatTextSection({
   const [activeFieldKey, setActiveFieldKey] = useState<string | null>(
     element.textFields[0]?.key ?? null,
   );
-  const [autoFocusFieldKey, setAutoFocusFieldKey] = useState<string | null>(null);
+  // Armed by the add handler, read and cleared by the render that first shows
+  // the new field. A ref rather than state: the marker only has to survive one
+  // render, and clearing it afterwards would be a state-syncing effect.
+  const autoFocusFieldKeyRef = useRef<string | null>(null);
 
   useEffect(() => {
     const nextFields = element.textFields;
@@ -267,21 +270,14 @@ export function FlatTextSection({
     });
   }, [element.id, element.selector, element.textFields]);
 
-  useEffect(() => {
-    setAutoFocusFieldKey(null);
-  }, [element.id, element.selector]);
-
-  useEffect(() => {
-    if (autoFocusFieldKey && autoFocusFieldKey === activeFieldKey) {
-      setAutoFocusFieldKey(null);
-    }
-  }, [activeFieldKey, autoFocusFieldKey]);
-
   if (!isTextEditableSelection(element)) return null;
   const textFields = element.textFields;
   const activeField = textFields.find((field) => field.key === activeFieldKey) ?? textFields[0];
   if (!activeField) return null;
 
+  const autoFocusActiveField = autoFocusFieldKeyRef.current === activeField.key;
+  if (autoFocusActiveField) autoFocusFieldKeyRef.current = null;
+
   if (textFields.length > 1) {
     return (
       <div className="space-y-2.5">
@@ -290,13 +286,13 @@ export function FlatTextSection({
           activeFieldKey={activeField.key}
           styles={styles}
           onSelect={(fieldKey) => {
-            setAutoFocusFieldKey(null);
+            autoFocusFieldKeyRef.current = null;
             setActiveFieldKey(fieldKey);
           }}
           onAdd={() =>
             void Promise.resolve(onAddTextField(activeField.key)).then((nextKey) => {
               if (!nextKey) return;
-              setAutoFocusFieldKey(nextKey);
+              autoFocusFieldKeyRef.current = nextKey;
               setActiveFieldKey(nextKey);
             })
           }
@@ -311,7 +307,7 @@ export function FlatTextSection({
           onSetText={onSetText}
           onSetTextFieldStyle={onSetTextFieldStyle}
           onPreviewTextFieldStyle={onPreviewTextFieldStyle}
-          autoFocus={autoFocusFieldKey === activeField.key}
+          autoFocus={autoFocusActiveField}
         />
       </div>
     );
@@ -334,7 +330,7 @@ export function FlatTextSection({
           track("button", "Add text field");
           void Promise.resolve(onAddTextField(activeField.key)).then((nextKey) => {
             if (!nextKey) return;
-            setAutoFocusFieldKey(nextKey);
+            autoFocusFieldKeyRef.current = nextKey;
             setActiveFieldKey(nextKey);
           });
         }}
diff --git a/packages/studio/src/hooks/gsapDragPositionCommit.ts b/packages/studio/src/hooks/gsapDragPositionCommit.ts
index b54847dcad..c5a8c026ba 100644
--- a/packages/studio/src/hooks/gsapDragPositionCommit.ts
+++ b/packages/studio/src/hooks/gsapDragPositionCommit.ts
@@ -4,6 +4,7 @@ import { usePlayerStore } from "../player/store/playerStore";
 import { resolveTweenStart, resolveTweenDuration } from "../utils/globalTimeCompiler";
 import { roundTo3 } from "../utils/rounding";
 import { computeDraggedGsapPosition } from "./draggedGsapPosition";
+import { resolveEditableTweenDuration } from "./gsapShared";
 import {
   type GsapDragCommitCallbacks,
   computeCurrentPercentage,
@@ -297,7 +298,9 @@ export async function commitGsapPositionFromDrag(
     }
 
     const tweenStart = resolveTweenStart(anim);
-    const tweenDuration = resolveTweenDuration(anim);
+    // Clip-wide, same as applyArcKeyframeAtPlayhead: authoring GSAP's 0.5s
+    // default here would collapse a duration-less arc's window on drag.
+    const tweenDuration = resolveEditableTweenDuration(anim, selection);
     if (tweenStart === null || tweenDuration <= 0 || keyframes.length < 2) return;
     const temporalKeyframes = buildTemporalArcKeyframes(anim, pct, { x: newX, y: newY });
     await callbacks.commitMutation(
diff --git a/packages/studio/src/hooks/useEnableKeyframes.test.ts b/packages/studio/src/hooks/useEnableKeyframes.test.ts
index 6fc5a823cb..f9cac5e9ec 100644
--- a/packages/studio/src/hooks/useEnableKeyframes.test.ts
+++ b/packages/studio/src/hooks/useEnableKeyframes.test.ts
@@ -108,6 +108,19 @@ describe("isPlayheadWithinTween", () => {
   it("does not block when the start can't be resolved", () => {
     expect(isPlayheadWithinTween(anim({ position: "+=1" }), 99)).toBe(true);
   });
+
+  // The toolbar's "extends animation" tooltip has to agree with what the edit
+  // paths do. Those span a duration-less tween across its clip, so answering
+  // from GSAP's 0.5s default reported the playhead outside a window the click
+  // then treated as clip-wide.
+  it("spans the clip for a duration-less tween when given the selection", () => {
+    const durationless = anim({ position: 0 });
+    const selection = { dataAttributes: { duration: "16" } } as unknown as DomEditSelection;
+
+    expect(isPlayheadWithinTween(durationless, 5)).toBe(false);
+    expect(isPlayheadWithinTween(durationless, 5, selection)).toBe(true);
+    expect(isPlayheadWithinTween(durationless, 20, selection)).toBe(false);
+  });
 });
 
 describe("buildExtendedKeyframes", () => {
diff --git a/packages/studio/src/hooks/useEnableKeyframes.ts b/packages/studio/src/hooks/useEnableKeyframes.ts
index f55a8e49dd..16299b2bdd 100644
--- a/packages/studio/src/hooks/useEnableKeyframes.ts
+++ b/packages/studio/src/hooks/useEnableKeyframes.ts
@@ -77,11 +77,22 @@ export function animatedProps(anim: GsapAnimation | null): string[] {
  * Whether the playhead sits inside an animation's tween range. When the tween's
  * start can't be resolved we don't block (the percentage falls back to clip range,
  * preserving prior behavior for elements without explicit timing).
+ *
+ * Pass the selection whenever the caller has one: a duration-less tween spans
+ * its clip, and answering from GSAP's 0.5s default reports the playhead outside
+ * a window the edit paths treat as clip-wide.
  */
-export function isPlayheadWithinTween(anim: GsapAnimation, currentTime: number): boolean {
+export function isPlayheadWithinTween(
+  anim: GsapAnimation,
+  currentTime: number,
+  selection?: DomEditSelection | null,
+): boolean {
   const start = resolveTweenStart(anim);
   if (start === null) return true;
-  return isTimeWithinTween(currentTime, start, resolveTweenDuration(anim));
+  const duration = selection
+    ? resolveEditableTweenDuration(anim, selection)
+    : resolveTweenDuration(anim);
+  return isTimeWithinTween(currentTime, start, duration);
 }
 
 /**
diff --git a/packages/studio/src/player/components/timelineKeyframeIdentity.ts b/packages/studio/src/player/components/timelineKeyframeIdentity.ts
index c9b761784a..e016fe39b7 100644
--- a/packages/studio/src/player/components/timelineKeyframeIdentity.ts
+++ b/packages/studio/src/player/components/timelineKeyframeIdentity.ts
@@ -5,6 +5,13 @@ export interface TimelineKeyframeTarget {
   animationId?: string;
 }
 
+/**
+ * Note the asymmetry: `tweenPercentage` is optional here and defaults to
+ * `percentage`, but the reader treats both slots as authoritative. Callers must
+ * therefore keep the pair consistent — writing a new `tweenPercentage` without
+ * the matching `percentage` hashes two logically-equal selections to different
+ * keys.
+ */
 export function timelineKeyframeSelectionKey(
   elementId: string,
   target: TimelineKeyframeTarget,

From b8406e6d94b70e2d46e20a1bc239dc19c3aa3841 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 01:36:04 +0200
Subject: [PATCH 088/125] refactor(studio): give every keyframe diamond one
 identity

The collapsed clip row dropped a keyframe's property group and animation id
before handing it to a callback, so the same keyframe hashed to a different
selection key than the expanded property lane did. Selecting a diamond in one
view left it unselected in the other, and retime/delete on the collapsed row
lost the animation id they use to pick between two animations that collide at
one percentage.

Diamonds now always carry their full identity, the collapsed shim just curries
the element id, and Timeline reuses useTimelineKeyframeHandlers instead of its
own inline copy of the same three handlers.

Neighbour geometry moves into one marker record per diamond, which drops the
index-lookup non-null assertions the connector pass needed.
---
 .../studio/src/player/components/Timeline.tsx |  48 +++------
 .../components/TimelineClipDiamonds.test.tsx  |  53 ++++++++-
 .../components/TimelineClipDiamonds.tsx       | 101 ++++++++++--------
 .../src/player/components/TimelineLanes.tsx   |  14 ++-
 .../components/TimelinePropertyLanes.test.tsx |   5 +-
 5 files changed, 136 insertions(+), 85 deletions(-)

diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 037b0bac1c..38bef2479b 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -28,6 +28,7 @@ import { useResolvedTimelineEditCallbacks } from "./useResolvedTimelineEditCallb
 import type { TimelineProps } from "./TimelineTypes";
 import { useTrackGapMenu } from "./useTrackGapMenu";
 import { useTimelineGapHighlights } from "./useTimelineGapHighlights";
+import { useTimelineKeyframeHandlers } from "./useTimelineKeyframeHandlers";
 import { useStudioPlaybackContextOptional } from "../../contexts/StudioContext";
 
 // Re-export pure utilities so existing imports from "./Timeline" still resolve.
@@ -262,6 +263,17 @@ export const Timeline = memo(function Timeline({
   const selectedKeyframes = usePlayerStore((s) => s.selectedKeyframes);
   const toggleSelectedKeyframe = usePlayerStore((s) => s.toggleSelectedKeyframe);
 
+  const { onClickKeyframe, onShiftClickKeyframe, onContextMenuKeyframe } =
+    useTimelineKeyframeHandlers({
+      expandedElements,
+      keyframeCache,
+      onSelectElement,
+      onSeek,
+      setSelectedElementId,
+      setKfContextMenu,
+      toggleSelectedKeyframe,
+    });
+
   const selectedElement = useMemo(
     () =>
       expandedElements.find((element) => (element.key ?? element.id) === selectedElementId) ?? null,
@@ -496,40 +508,10 @@ export const Timeline = memo(function Timeline({
           selectedKeyframes={selectedKeyframes}
           currentTime={currentTime}
           beatAnalysis={adjustedBeatAnalysis}
-          onClickKeyframe={(el, pct) => {
-            usePlayerStore.getState().clearSelectedKeyframes();
-            const elKey = el.key ?? el.id;
-            setSelectedElementId(elKey);
-            onSelectElement?.(el);
-            // Select the clicked diamond (matches shift-click); cleared above so this single-selects.
-            toggleSelectedKeyframe(`${elKey}:${pct}`);
-            const absTime = el.start + (pct / 100) * el.duration;
-            onSeek?.(absTime);
-            const kfData = keyframeCache?.get(elKey);
-            const kf = kfData?.keyframes.find((k) => Math.abs(k.percentage - pct) < 0.5);
-            usePlayerStore.getState().setActiveKeyframePct(kf?.tweenPercentage ?? null);
-          }}
-          onShiftClickKeyframe={(elId, pct) => {
-            toggleSelectedKeyframe(`${elId}:${pct}`);
-          }}
+          onClickKeyframe={onClickKeyframe}
+          onShiftClickKeyframe={onShiftClickKeyframe}
           onMoveKeyframe={onMoveKeyframe}
-          onContextMenuKeyframe={(e, elId, pct) => {
-            const el = expandedElements.find((x) => (x.key ?? x.id) === elId);
-            if (!el) return;
-            setSelectedElementId(elId);
-            onSelectElement?.(el);
-            const kfData = keyframeCache.get(elId);
-            const kf = kfData?.keyframes.find((k) => Math.abs(k.percentage - pct) < 0.2);
-            setKfContextMenu({
-              x: e.clientX + 4,
-              y: e.clientY + 2,
-              element: el,
-              elementId: elId,
-              percentage: pct,
-              tweenPercentage: kf?.tweenPercentage,
-              currentEase: kf?.ease ?? kfData?.ease,
-            });
-          }}
+          onContextMenuKeyframe={onContextMenuKeyframe}
           onContextMenuClip={(e, el) => {
             e.preventDefault();
             setSelectedElementId(el.key ?? el.id);
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
index 2a41e78413..85804deb1a 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
@@ -4,6 +4,7 @@ import React, { act } from "react";
 import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { TimelineClipDiamonds, TimelineDiamondLane } from "./TimelineClipDiamonds";
+import { timelineKeyframeSelectionKey } from "./timelineKeyframeIdentity";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
@@ -90,7 +91,57 @@ describe("TimelineClipDiamonds", () => {
       diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0 }));
     });
 
-    expect(onClickKeyframe).toHaveBeenCalledWith(50);
+    expect(onClickKeyframe).toHaveBeenCalledWith(
+      "clip-1",
+      expect.objectContaining({ percentage: 50 }),
+    );
+    act(() => root.unmount());
+  });
+
+  // The collapsed clip row and the expanded property lanes read the same cache,
+  // so a keyframe that carries a property group has to hash to the same key in
+  // both — otherwise collapsing a track silently drops the selection.
+  it("keys a grouped keyframe the same way collapsed as expanded", () => {
+    const groupedKeyframe = {
+      percentage: 50,
+      tweenPercentage: 25,
+      propertyGroup: "position",
+      animationId: "anim-1",
+      properties: { x: 100 },
+    };
+    const sharedKey = timelineKeyframeSelectionKey("clip-1", groupedKeyframe);
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    const onClickKeyframe = vi.fn();
+    act(() => {
+      root.render(
+        <TimelineClipDiamonds
+          keyframesData={{ format: "percentage", keyframes: [groupedKeyframe] }}
+          clipWidthPx={200}
+          clipHeightPx={48}
+          accentColor="#4ba3d2"
+          isSelected
+          currentPercentage={-10}
+          elementId="clip-1"
+          selectedKeyframes={new Set([sharedKey])}
+          onClickKeyframe={onClickKeyframe}
+        />,
+      );
+    });
+    const diamond = host.querySelector<HTMLButtonElement>('button[title="50%"]');
+    // Highlighted from the shared key alone (the playhead is off-clip here).
+    expect(diamond?.querySelector("path:last-child")?.getAttribute("fill")).toBe("#4ba3d2");
+
+    act(() => {
+      diamond?.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0 }));
+    });
+    expect(onClickKeyframe).toHaveBeenCalledWith("clip-1", {
+      percentage: 50,
+      tweenPercentage: 25,
+      propertyGroup: "position",
+      animationId: "anim-1",
+    });
     act(() => root.unmount());
   });
 
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 10c58dfcf5..cf3c516a1c 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -44,9 +44,13 @@ interface TimelineClipDiamondsProps {
   currentPercentage: number;
   elementId: string;
   selectedKeyframes: ReadonlySet<string>;
-  onClickKeyframe?: (percentage: number) => void;
-  onShiftClickKeyframe?: (elementId: string, percentage: number) => void;
-  onContextMenuKeyframe?: (e: React.MouseEvent, elementId: string, percentage: number) => void;
+  onClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
+  onShiftClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
+  onContextMenuKeyframe?: (
+    e: React.MouseEvent,
+    elementId: string,
+    keyframe: TimelineKeyframeTarget,
+  ) => void;
   /** Drag-to-retime: move a keyframe to a new time, preserving its value + ease.
    *  `keyframe` identifies the dragged keyframe (clip-relative percentage plus
    *  whatever animation identity the row carries); `toClipPercentage` is the
@@ -105,18 +109,21 @@ type DragState = {
   cancelled?: boolean;
 };
 
-function keyframeTarget(
-  keyframe: TimelineDiamondKeyframe,
-  groupAware: boolean,
-): TimelineKeyframeTarget {
-  return groupAware
-    ? {
-        percentage: keyframe.percentage,
-        tweenPercentage: keyframe.tweenPercentage,
-        propertyGroup: keyframe.propertyGroup,
-        animationId: keyframe.animationId,
-      }
-    : { percentage: keyframe.percentage };
+/**
+ * The full identity of a diamond, used by every callback and by the selection
+ * key. Collapsed clip rows and expanded property lanes read the same cache, so
+ * they must hash a shared keyframe to the same key: dropping the group here for
+ * the collapsed row would leave a diamond selected in one view and unselected in
+ * the other, and would strip the animation id the retime/delete mutations use to
+ * pick between two animations that collide at one percentage.
+ */
+function keyframeTarget(keyframe: TimelineDiamondKeyframe): TimelineKeyframeTarget {
+  return {
+    percentage: keyframe.percentage,
+    tweenPercentage: keyframe.tweenPercentage,
+    propertyGroup: keyframe.propertyGroup,
+    animationId: keyframe.animationId,
+  };
 }
 
 export const TimelineDiamondLane = memo(function TimelineDiamondLane({
@@ -216,16 +223,21 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   // Clip-%s of the sorted keyframes — the neighbour clamp (preview + drop) needs
   // the whole row to bound the dragged diamond between its immediate siblings.
   const sortedClipPcts = sorted.map((k) => k.percentage);
-  const sortedCenterXs = sorted.map((keyframe) =>
-    Math.max(0, Math.min(clipWidthPx, (keyframe.percentage / 100) * clipWidthPx)),
-  );
-  const markerMetrics = sortedCenterXs.map((centerX, index) => {
-    const previousGap = index > 0 ? centerX - sortedCenterXs[index - 1]! : Infinity;
-    const nextGap =
-      index < sortedCenterXs.length - 1 ? sortedCenterXs[index + 1]! - centerX : Infinity;
+  const centerXOf = (percentage: number) =>
+    Math.max(0, Math.min(clipWidthPx, (percentage / 100) * clipWidthPx));
+  // One record per diamond, carrying its own geometry, so the connector and
+  // button passes below read neighbours as values instead of index lookups.
+  const markers = sorted.map((keyframe, index) => {
+    const centerX = centerXOf(keyframe.percentage);
+    const previous = sorted[index - 1];
+    const next = sorted[index + 1];
+    const previousGap = previous ? centerX - centerXOf(previous.percentage) : Infinity;
+    const nextGap = next ? centerXOf(next.percentage) - centerX : Infinity;
     const nearestGap = Math.max(1, Math.min(previousGap, nextGap));
     const hitWidth = Math.min(diamondSize, nearestGap);
     return {
+      keyframe,
+      centerX,
       hitWidth,
       visualSize: hitWidth === diamondSize ? diamondSize : Math.max(2, hitWidth - 2),
     };
@@ -248,25 +260,24 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         pointerEvents: "none",
       }}
     >
-      {sorted.map((kf, i) => {
-        if (i === 0) return null;
-        const prev = sorted[i - 1]!;
-        const x1 = sortedCenterXs[i - 1]!;
-        const x2 = sortedCenterXs[i]!;
+      {markers.map((marker, i) => {
+        const previous = markers[i - 1];
+        if (!previous) return null;
+        const kf = marker.keyframe;
+        const x1 = previous.centerX;
+        const x2 = marker.centerX;
         if (x2 - x1 < 1) return null;
-        const connectorLeft = x1 + markerMetrics[i - 1]!.visualSize / 2;
-        const connectorWidth =
-          x2 - x1 - markerMetrics[i - 1]!.visualSize / 2 - markerMetrics[i]!.visualSize / 2;
-        // Group-aware target for the ease button: the segment ease is
-        // per-keyframe (each keyframe carries its own animationId/tweenPercentage).
-        // On a merged inline row the button is hidden where the segment is
-        // ambiguous (two source animations collide at this % with different
-        // eases; see easeAmbiguous) or the keyframe has no source animation id
-        // (runtime-scanned) so there is no tween to target.
-        const target = keyframeTarget(kf, true);
+        const connectorLeft = x1 + previous.visualSize / 2;
+        const connectorWidth = x2 - x1 - previous.visualSize / 2 - marker.visualSize / 2;
+        // The ease button targets one segment, so it needs the keyframe's own
+        // animationId/tweenPercentage. On a merged inline row the button is
+        // hidden where the segment is ambiguous (two source animations collide
+        // at this % with different eases; see easeAmbiguous) or the keyframe has
+        // no source animation id (runtime-scanned) so there is no tween to target.
+        const target = keyframeTarget(kf);
         const ease = kf.ease ?? globalEase;
         return (
-          <Fragment key={`line-${i}-${prev.percentage}-${kf.percentage}`}>
+          <Fragment key={`line-${i}-${previous.keyframe.percentage}-${kf.percentage}`}>
             <div
               className="absolute"
               data-keyframe-connector={groupAware ? "" : undefined}
@@ -334,8 +345,9 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         );
       })}
 
-      {sorted.map((kf, i) => {
-        const target = keyframeTarget(kf, groupAware);
+      {markers.map((marker, i) => {
+        const kf = marker.keyframe;
+        const target = keyframeTarget(kf);
         const kfKey = timelineKeyframeSelectionKey(elementId, target);
         // While dragging this diamond, render it at the live preview clip-%.
         const renderPct = preview?.kfKey === kfKey ? preview.clipPct : kf.percentage;
@@ -344,7 +356,6 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         // The 0% diamond's left half lands in the reserved left gutter (the
         // content origin is inset past the label column, Figma-style) so it stays
         // fully visible instead of being clipped by the sticky label column.
-        const marker = markerMetrics[i]!;
         const leftPx = (renderPct / 100) * clipWidthPx - marker.hitWidth / 2;
         const isKfSelected = selectedKeyframes.has(kfKey);
         const atPlayhead = isSelected && Math.abs(kf.percentage - currentPercentage) < 0.5;
@@ -565,12 +576,10 @@ export const TimelineClipDiamonds = memo(function TimelineClipDiamonds(
     <TimelineDiamondLane
       {...props}
       globalEase={props.keyframesData.ease}
-      onClickKeyframe={(target) => props.onClickKeyframe?.(target.percentage)}
-      onShiftClickKeyframe={(target) =>
-        props.onShiftClickKeyframe?.(props.elementId, target.percentage)
-      }
+      onClickKeyframe={(target) => props.onClickKeyframe?.(props.elementId, target)}
+      onShiftClickKeyframe={(target) => props.onShiftClickKeyframe?.(props.elementId, target)}
       onContextMenuKeyframe={(e, target) =>
-        props.onContextMenuKeyframe?.(e, props.elementId, target.percentage)
+        props.onContextMenuKeyframe?.(e, props.elementId, target)
       }
       onMoveKeyframe={
         props.onMoveKeyframe
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index 8437bb64e3..4ee3afc531 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -72,9 +72,13 @@ export interface TimelineLaneBaseProps {
   keyframeCache?: Map<string, KeyframeCacheEntry>;
   selectedKeyframes: Set<string>;
   currentTime: number;
-  onClickKeyframe?: (element: TimelineElement, percentage: number) => void;
-  onShiftClickKeyframe?: (elementId: string, percentage: number) => void;
-  onContextMenuKeyframe?: (e: React.MouseEvent, elementId: string, percentage: number) => void;
+  onClickKeyframe?: (element: TimelineElement, keyframe: TimelineKeyframeTarget) => void;
+  onShiftClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
+  onContextMenuKeyframe?: (
+    e: React.MouseEvent,
+    elementId: string,
+    keyframe: TimelineKeyframeTarget,
+  ) => void;
   onMoveKeyframe?: (
     elementId: string,
     keyframe: TimelineKeyframeTarget,
@@ -474,7 +478,9 @@ export function TimelineLanes({
                             }
                             elementId={elementKey}
                             selectedKeyframes={selectedKeyframes}
-                            onClickKeyframe={(pct) => onClickKeyframe?.(previewElement, pct)}
+                            onClickKeyframe={(_elId, keyframe) =>
+                              onClickKeyframe?.(previewElement, keyframe)
+                            }
                             onShiftClickKeyframe={onShiftClickKeyframe}
                             onContextMenuKeyframe={onContextMenuKeyframe}
                             onMoveKeyframe={onMoveKeyframe}
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
index 200f25d8c1..387d845675 100644
--- a/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
@@ -424,7 +424,10 @@ describe("TimelinePropertyLanes", () => {
     act(() => {
       diamonds[1]?.dispatchEvent(new MouseEvent("pointerup", { bubbles: true, button: 0 }));
     });
-    expect(onClickKeyframe).toHaveBeenCalledWith(50);
+    expect(onClickKeyframe).toHaveBeenCalledWith(
+      "clip-1",
+      expect.objectContaining({ percentage: 50 }),
+    );
     act(() => root.unmount());
   });
 });

From 8c0d9a07ddbec632e191e55baf5a0e99b9aded6f Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 02:25:50 +0200
Subject: [PATCH 089/125] refactor(studio): split the diamond row's data
 contract into its own file

TimelineClipDiamonds.tsx had grown past the 600-line studio file gate, and
its keyframe/props types were declared a second time next to the ones the
lanes already share. The types, the render constants, and the keyframe
identity helper move to timelineDiamondTypes.ts; the rendering stays put.
---
 .../components/TimelineClipDiamonds.tsx       | 125 ++----------------
 .../player/components/timelineDiamondTypes.ts | 120 +++++++++++++++++
 2 files changed, 130 insertions(+), 115 deletions(-)
 create mode 100644 packages/studio/src/player/components/timelineDiamondTypes.ts

diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index cf3c516a1c..146aeb1fbc 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -8,123 +8,18 @@ import {
 import { MiniCurveSvg } from "../../components/editor/EaseCurveSection";
 import { clipToTweenPercentage } from "../../components/editor/KeyframeNavigation";
 import { LANE_H } from "./timelineLayout";
+import { timelineKeyframeSelectionKey } from "./timelineKeyframeIdentity";
 import {
-  timelineKeyframeSelectionKey,
-  type TimelineKeyframeTarget,
-} from "./timelineKeyframeIdentity";
-export interface TimelineDiamondKeyframe {
-  percentage: number;
-  /** Tween-relative percentage (the retime mutation keys on this, not clip %). */
-  tweenPercentage?: number;
-  propertyGroup?: string;
-  animationId?: string;
-  properties: Record<string, number | string>;
-  ease?: string;
-  /** Set when 2+ source animations collide at this percentage (a single inline
-   *  ease button can't target one): the collapsed row hides the button here. */
-  easeAmbiguous?: boolean;
-}
+  DIAMOND_RATIO,
+  KF_MAX_PCT,
+  KF_MIN_PCT,
+  keyframeTarget,
+  type DragState,
+  type TimelineClipDiamondsProps,
+  type TimelineDiamondLaneProps,
+} from "./timelineDiamondTypes";
 
-interface KeyframeCacheEntry {
-  format: string;
-  keyframes: TimelineDiamondKeyframe[];
-  ease?: string;
-  easeEach?: string;
-}
-
-interface TimelineClipDiamondsProps {
-  keyframesData: KeyframeCacheEntry;
-  clipWidthPx: number;
-  clipHeightPx: number;
-  /** Beat-dot strip is shown on this track → shrink diamonds + drop them into
-   *  the bottom half so they clear the strip at the top. */
-  beatsActive?: boolean;
-  accentColor: string;
-  isSelected: boolean;
-  currentPercentage: number;
-  elementId: string;
-  selectedKeyframes: ReadonlySet<string>;
-  onClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
-  onShiftClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
-  onContextMenuKeyframe?: (
-    e: React.MouseEvent,
-    elementId: string,
-    keyframe: TimelineKeyframeTarget,
-  ) => void;
-  /** Drag-to-retime: move a keyframe to a new time, preserving its value + ease.
-   *  `keyframe` identifies the dragged keyframe (clip-relative percentage plus
-   *  whatever animation identity the row carries); `toClipPercentage` is the
-   *  neighbour-clamped drop position, also clip-relative. The handler decides
-   *  move (within the tween) vs resize (past its boundary). */
-  onMoveKeyframe?: (
-    elementId: string,
-    keyframe: TimelineKeyframeTarget,
-    toClipPercentage: number,
-  ) => Promise<boolean>;
-  /** Open the segment ease editor for the hovered mid-point button — available on
-   *  the inline clip row too, not just the expanded lanes. */
-  onSelectSegment?: (elementId: string, target: TimelineKeyframeTarget) => void;
-  /** Set while resolving a diamond press so the ancestor clip's onClick (which
-   *  toggles selection off when already selected) ignores the native "click"
-   *  the browser auto-synthesizes after this button's pointerdown+pointerup. */
-  suppressClickRef?: React.RefObject<boolean>;
-}
-
-interface TimelineDiamondLaneProps extends Omit<
-  TimelineClipDiamondsProps,
-  | "onClickKeyframe"
-  | "onShiftClickKeyframe"
-  | "onContextMenuKeyframe"
-  | "onMoveKeyframe"
-  | "onSelectSegment"
-> {
-  groupAware?: boolean;
-  globalEase?: string;
-  onSelectSegment?: (target: TimelineKeyframeTarget) => void;
-  onClickKeyframe?: (target: TimelineKeyframeTarget) => void;
-  onShiftClickKeyframe?: (target: TimelineKeyframeTarget) => void;
-  onContextMenuKeyframe?: (e: React.MouseEvent, target: TimelineKeyframeTarget) => void;
-  onMoveKeyframe?: (target: TimelineKeyframeTarget, toClipPercentage: number) => Promise<boolean>;
-}
-
-const DIAMOND_RATIO = 0.8;
-// Percentage tolerance for rendering keyframes near clip boundaries. Keyframes
-// slightly outside [0, 100] (from rounding or stale cache during the async
-// persist → reload cycle) are still rendered (the clip is overflow-visible) at
-// their true position rather than hidden.
-const KF_MIN_PCT = -5;
-const KF_MAX_PCT = 105;
-
-type DragState = {
-  kfKey: string;
-  startX: number;
-  fromClipPct: number;
-  moved: boolean;
-  /** Latest pointer x, flushed to the preview once per frame. */
-  lastX: number;
-  /** Index in the sorted row, needed by the neighbour clamp off the render path. */
-  index: number;
-  /** Escape was pressed: the drag is dead, and the pointerup that follows is
-   *  swallowed rather than falling through to the click branch. */
-  cancelled?: boolean;
-};
-
-/**
- * The full identity of a diamond, used by every callback and by the selection
- * key. Collapsed clip rows and expanded property lanes read the same cache, so
- * they must hash a shared keyframe to the same key: dropping the group here for
- * the collapsed row would leave a diamond selected in one view and unselected in
- * the other, and would strip the animation id the retime/delete mutations use to
- * pick between two animations that collide at one percentage.
- */
-function keyframeTarget(keyframe: TimelineDiamondKeyframe): TimelineKeyframeTarget {
-  return {
-    percentage: keyframe.percentage,
-    tweenPercentage: keyframe.tweenPercentage,
-    propertyGroup: keyframe.propertyGroup,
-    animationId: keyframe.animationId,
-  };
-}
+export type { TimelineDiamondKeyframe } from "./timelineDiamondTypes";
 
 export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   keyframesData,
diff --git a/packages/studio/src/player/components/timelineDiamondTypes.ts b/packages/studio/src/player/components/timelineDiamondTypes.ts
new file mode 100644
index 0000000000..d5541a4181
--- /dev/null
+++ b/packages/studio/src/player/components/timelineDiamondTypes.ts
@@ -0,0 +1,120 @@
+/**
+ * The diamond row's data + prop contract, split out of TimelineClipDiamonds so
+ * that file stays under the 600-line studio gate. Types and the shared
+ * keyframe-identity helper live here; the rendering lives there.
+ */
+import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
+
+export interface TimelineDiamondKeyframe {
+  percentage: number;
+  /** Tween-relative percentage (the retime mutation keys on this, not clip %). */
+  tweenPercentage?: number;
+  propertyGroup?: string;
+  animationId?: string;
+  properties: Record<string, number | string>;
+  ease?: string;
+  /** Set when 2+ source animations collide at this percentage (a single inline
+   *  ease button can't target one): the collapsed row hides the button here. */
+  easeAmbiguous?: boolean;
+}
+
+interface KeyframeCacheEntry {
+  format: string;
+  keyframes: TimelineDiamondKeyframe[];
+  ease?: string;
+  easeEach?: string;
+}
+
+export interface TimelineClipDiamondsProps {
+  keyframesData: KeyframeCacheEntry;
+  clipWidthPx: number;
+  clipHeightPx: number;
+  /** Beat-dot strip is shown on this track → shrink diamonds + drop them into
+   *  the bottom half so they clear the strip at the top. */
+  beatsActive?: boolean;
+  accentColor: string;
+  isSelected: boolean;
+  currentPercentage: number;
+  elementId: string;
+  selectedKeyframes: ReadonlySet<string>;
+  onClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
+  onShiftClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
+  onContextMenuKeyframe?: (
+    e: React.MouseEvent,
+    elementId: string,
+    keyframe: TimelineKeyframeTarget,
+  ) => void;
+  /** Drag-to-retime: move a keyframe to a new time, preserving its value + ease.
+   *  `keyframe` identifies the dragged keyframe (clip-relative percentage plus
+   *  whatever animation identity the row carries); `toClipPercentage` is the
+   *  neighbour-clamped drop position, also clip-relative. The handler decides
+   *  move (within the tween) vs resize (past its boundary). */
+  onMoveKeyframe?: (
+    elementId: string,
+    keyframe: TimelineKeyframeTarget,
+    toClipPercentage: number,
+  ) => Promise<boolean>;
+  /** Open the segment ease editor for the hovered mid-point button — available on
+   *  the inline clip row too, not just the expanded lanes. */
+  onSelectSegment?: (elementId: string, target: TimelineKeyframeTarget) => void;
+  /** Set while resolving a diamond press so the ancestor clip's onClick (which
+   *  toggles selection off when already selected) ignores the native "click"
+   *  the browser auto-synthesizes after this button's pointerdown+pointerup. */
+  suppressClickRef?: React.RefObject<boolean>;
+}
+
+export interface TimelineDiamondLaneProps extends Omit<
+  TimelineClipDiamondsProps,
+  | "onClickKeyframe"
+  | "onShiftClickKeyframe"
+  | "onContextMenuKeyframe"
+  | "onMoveKeyframe"
+  | "onSelectSegment"
+> {
+  groupAware?: boolean;
+  globalEase?: string;
+  onSelectSegment?: (target: TimelineKeyframeTarget) => void;
+  onClickKeyframe?: (target: TimelineKeyframeTarget) => void;
+  onShiftClickKeyframe?: (target: TimelineKeyframeTarget) => void;
+  onContextMenuKeyframe?: (e: React.MouseEvent, target: TimelineKeyframeTarget) => void;
+  onMoveKeyframe?: (target: TimelineKeyframeTarget, toClipPercentage: number) => Promise<boolean>;
+}
+
+export const DIAMOND_RATIO = 0.8;
+// Percentage tolerance for rendering keyframes near clip boundaries. Keyframes
+// slightly outside [0, 100] (from rounding or stale cache during the async
+// persist → reload cycle) are still rendered (the clip is overflow-visible) at
+// their true position rather than hidden.
+export const KF_MIN_PCT = -5;
+export const KF_MAX_PCT = 105;
+
+export type DragState = {
+  kfKey: string;
+  startX: number;
+  fromClipPct: number;
+  moved: boolean;
+  /** Latest pointer x, flushed to the preview once per frame. */
+  lastX: number;
+  /** Index in the sorted row, needed by the neighbour clamp off the render path. */
+  index: number;
+  /** Escape was pressed: the drag is dead, and the pointerup that follows is
+   *  swallowed rather than falling through to the click branch. */
+  cancelled?: boolean;
+};
+
+/**
+ * The full identity of a diamond, used by every callback and by the selection
+ * key. Collapsed clip rows and expanded property lanes read the same cache, so
+ * they must hash a shared keyframe to the same key: dropping the group here for
+ * the collapsed row would leave a diamond selected in one view and unselected in
+ * the other, and would strip the animation id the retime/delete mutations use to
+ * pick between two animations that collide at one percentage.
+ */
+export function keyframeTarget(keyframe: TimelineDiamondKeyframe): TimelineKeyframeTarget {
+  return {
+    percentage: keyframe.percentage,
+    tweenPercentage: keyframe.tweenPercentage,
+    propertyGroup: keyframe.propertyGroup,
+    animationId: keyframe.animationId,
+  };
+}

From 2f5f9b1404019f37e39b9dce87d603f5bd5f3adc Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 17:07:30 +0200
Subject: [PATCH 090/125] feat(studio): wire expanded keyframe timeline lanes

---
 packages/studio/src/App.tsx                   |   2 +
 .../studio/src/components/EditorShell.tsx     |   3 +
 .../components/editor/MotionPathOverlay.tsx   |   8 +-
 .../src/components/nle/PreviewOverlays.tsx    |   4 +-
 .../components/KeyframeDiamondContextMenu.tsx |  41 +-
 .../src/player/components/Timeline.test.ts    | 504 +++++++++++++++---
 .../studio/src/player/components/Timeline.tsx | 107 ++--
 .../src/player/components/TimelineCanvas.tsx  |  49 +-
 .../src/player/components/TimelineClip.tsx    |   4 +-
 .../player/components/TimelineDragGhost.tsx   |  59 --
 .../src/player/components/TimelineLanes.tsx   | 230 +++++---
 .../player/components/TimelineOverlays.tsx    |   8 +-
 .../components/TimelineRazorInteraction.tsx   |  60 +++
 .../src/player/components/TimelineRuler.tsx   |  32 +-
 .../src/player/components/timelineDragDrop.ts |  11 +-
 .../player/components/timelineLayout.test.ts  |  13 +-
 .../src/player/components/timelineLayout.ts   |  84 ++-
 .../src/player/components/timelineMarquee.ts  |  13 +-
 .../player/components/useTimelineGeometry.ts  |   5 +-
 .../player/components/useTimelinePlayhead.ts  |  22 +-
 .../components/useTimelineRangeSelection.ts   |  35 +-
 .../components/useTimelineTrackLayout.test.ts |  53 ++
 .../components/useTimelineTrackLayout.ts      | 161 ++++++
 23 files changed, 1098 insertions(+), 410 deletions(-)
 delete mode 100644 packages/studio/src/player/components/TimelineDragGhost.tsx
 create mode 100644 packages/studio/src/player/components/TimelineRazorInteraction.tsx
 create mode 100644 packages/studio/src/player/components/useTimelineTrackLayout.test.ts
 create mode 100644 packages/studio/src/player/components/useTimelineTrackLayout.ts

diff --git a/packages/studio/src/App.tsx b/packages/studio/src/App.tsx
index b661872d67..7bdaafd5b1 100644
--- a/packages/studio/src/App.tsx
+++ b/packages/studio/src/App.tsx
@@ -395,6 +395,7 @@ export function StudioApp() {
     designPanelActive,
     inspectorPanelActive,
     inspectorButtonActive,
+    shouldShowMotionPath,
     shouldShowSelectedDomBounds,
   } = useInspectorState(
     panelLayout.rightPanelTab,
@@ -552,6 +553,7 @@ export function StudioApp() {
                     handleRazorSplitAll={timelineEditing.handleRazorSplitAll}
                     setCompIdToSrc={setCompIdToSrc}
                     setCompositionLoading={setCompositionLoading}
+                    shouldShowMotionPath={shouldShowMotionPath}
                     shouldShowSelectedDomBounds={shouldShowSelectedDomBounds}
                     isGestureRecording={gestureState === "recording"}
                     recordingState={gestureState}
diff --git a/packages/studio/src/components/EditorShell.tsx b/packages/studio/src/components/EditorShell.tsx
index a5724c12e0..fbf0688713 100644
--- a/packages/studio/src/components/EditorShell.tsx
+++ b/packages/studio/src/components/EditorShell.tsx
@@ -56,6 +56,7 @@ export interface EditorShellProps extends TimelineEditCallbackDeps {
   ) => Promise<void> | void;
   setCompIdToSrc: (map: Map<string, string>) => void;
   setCompositionLoading: (loading: boolean) => void;
+  shouldShowMotionPath: boolean;
   shouldShowSelectedDomBounds: boolean;
   blockPreview?: BlockPreviewInfo | null;
   isGestureRecording?: boolean;
@@ -90,6 +91,7 @@ export function EditorShell({
   handleRazorSplitAll,
   setCompIdToSrc,
   setCompositionLoading,
+  shouldShowMotionPath,
   shouldShowSelectedDomBounds,
   isGestureRecording,
   recordingState,
@@ -149,6 +151,7 @@ export function EditorShell({
             onDeleteElement={handleTimelineElementDelete}
             previewOverlay={
               <PreviewOverlays
+                shouldShowMotionPath={shouldShowMotionPath}
                 shouldShowSelectedDomBounds={shouldShowSelectedDomBounds}
                 blockPreview={blockPreview}
                 isGestureRecording={isGestureRecording}
diff --git a/packages/studio/src/components/editor/MotionPathOverlay.tsx b/packages/studio/src/components/editor/MotionPathOverlay.tsx
index 81a10a8d1b..5d29fab684 100644
--- a/packages/studio/src/components/editor/MotionPathOverlay.tsx
+++ b/packages/studio/src/components/editor/MotionPathOverlay.tsx
@@ -520,9 +520,13 @@ export const MotionPathOverlay = memo(function MotionPathOverlay({
         <KeyframeDiamondContextMenu
           state={kfMenu}
           onClose={() => setKfMenu(null)}
-          onDelete={(_elId, pct) => animId && handleGsapRemoveKeyframe(animId, pct)}
+          onDelete={(_elId, keyframe) =>
+            animId && handleGsapRemoveKeyframe(animId, keyframe.percentage)
+          }
           onDeleteAll={() => animId && handleGsapRemoveAllKeyframes(animId)}
-          onMoveToPlayhead={(_elId, pct) => animId && handleGsapMoveKeyframeToPlayhead(animId, pct)}
+          onMoveToPlayhead={(_element, keyframe) =>
+            animId && handleGsapMoveKeyframeToPlayhead(animId, keyframe.percentage)
+          }
         />
       )}
     </>
diff --git a/packages/studio/src/components/nle/PreviewOverlays.tsx b/packages/studio/src/components/nle/PreviewOverlays.tsx
index 2eeb4f6294..77781d9939 100644
--- a/packages/studio/src/components/nle/PreviewOverlays.tsx
+++ b/packages/studio/src/components/nle/PreviewOverlays.tsx
@@ -27,6 +27,7 @@ import type { GestureRecordingState } from "../editor/GestureRecordControl";
 import type { ReactNode } from "react";
 
 export interface PreviewOverlaysProps {
+  shouldShowMotionPath: boolean;
   shouldShowSelectedDomBounds: boolean;
   blockPreview?: BlockPreviewInfo | null;
   isGestureRecording?: boolean;
@@ -132,6 +133,7 @@ export function resolveZIndexEntries(
 
 // fallow-ignore-next-line complexity
 export function PreviewOverlays({
+  shouldShowMotionPath,
   shouldShowSelectedDomBounds,
   blockPreview,
   isGestureRecording,
@@ -274,7 +276,7 @@ export function PreviewOverlays({
       {STUDIO_KEYFRAMES_ENABLED && (
         <MotionPathOverlay
           iframeRef={previewIframeRef}
-          selection={shouldShowSelectedDomBounds ? domEditSelection : null}
+          selection={shouldShowMotionPath ? domEditSelection : null}
           compositionSize={compositionDimensions}
           isPlaying={isPlaying}
         />
diff --git a/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx b/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
index 1e8275511b..8bf5dce5c2 100644
--- a/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
+++ b/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
@@ -2,6 +2,7 @@ import { memo } from "react";
 import { createPortal } from "react-dom";
 import { useContextMenuDismiss } from "../../hooks/useContextMenuDismiss";
 import type { TimelineElement } from "../store/playerStore";
+import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
 
 export interface KeyframeDiamondContextMenuState {
   x: number;
@@ -18,24 +19,12 @@ export interface KeyframeDiamondContextMenuState {
 interface KeyframeDiamondContextMenuProps {
   state: KeyframeDiamondContextMenuState;
   onClose: () => void;
-  onDelete: (
-    elementId: string,
-    percentage: number,
-    propertyGroup?: string,
-    tweenPercentage?: number,
-    animationId?: string,
-  ) => void;
+  onDelete: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
   onDeleteAll: (element: TimelineElement) => void;
   onChangeEase?: (elementId: string, percentage: number, ease: string) => void;
   onCopyProperties?: (elementId: string, percentage: number) => void;
   /** Retime the keyframe to the current playhead, preserving its value + ease. */
-  onMoveToPlayhead?: (
-    element: TimelineElement,
-    fromPercentage: number,
-    propertyGroup?: string,
-    tweenPercentage?: number,
-    animationId?: string,
-  ) => void;
+  onMoveToPlayhead?: (element: TimelineElement, keyframe: TimelineKeyframeTarget) => void;
 }
 
 export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMenu({
@@ -46,6 +35,14 @@ export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMe
   onMoveToPlayhead,
 }: KeyframeDiamondContextMenuProps) {
   const menuRef = useContextMenuDismiss(onClose);
+  // The clicked diamond's identity, built once: the menu's two mutating entries
+  // both act on it, and they must not disagree about which keyframe was clicked.
+  const keyframe: TimelineKeyframeTarget = {
+    percentage: state.percentage,
+    tweenPercentage: state.tweenPercentage,
+    propertyGroup: state.propertyGroup,
+    animationId: state.animationId,
+  };
 
   const menuWidth = 200;
   const menuHeight = onMoveToPlayhead ? 100 : 70;
@@ -67,13 +64,7 @@ export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMe
             // Pass clip-% — resolveKeyframeTarget keys the cache lookup on clip-%
             // and returns the tween-% for the mutation. Passing tween-% here would
             // miss the lookup on any tween whose window is shorter than the clip.
-            onMoveToPlayhead(
-              state.element,
-              state.percentage,
-              state.propertyGroup,
-              state.tweenPercentage,
-              state.animationId,
-            );
+            onMoveToPlayhead(state.element, keyframe);
             onClose();
           }}
         >
@@ -86,13 +77,7 @@ export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMe
         type="button"
         className="w-full flex items-center gap-2 px-3 py-1.5 text-xs text-red-400 hover:bg-neutral-800 cursor-pointer text-left"
         onClick={() => {
-          onDelete(
-            state.elementId,
-            state.percentage,
-            state.propertyGroup,
-            state.tweenPercentage,
-            state.animationId,
-          );
+          onDelete(state.elementId, keyframe);
           onClose();
         }}
       >
diff --git a/packages/studio/src/player/components/Timeline.test.ts b/packages/studio/src/player/components/Timeline.test.ts
index e3db29f4a3..ed0310814e 100644
--- a/packages/studio/src/player/components/Timeline.test.ts
+++ b/packages/studio/src/player/components/Timeline.test.ts
@@ -19,8 +19,11 @@ import {
   shouldAutoScrollTimeline,
 } from "./Timeline";
 import {
+  CLIP_Y,
   FIT_ZOOM_HEADROOM,
   GUTTER,
+  LABEL_COL_W,
+  LANE_H,
   MIN_TIMELINE_EXTENT_S,
   PLAYHEAD_HEAD_W,
   RULER_H,
@@ -28,6 +31,7 @@ import {
   TRACKS_LEFT_PAD,
   getTimelineDisplayContentWidth,
   getTimelineFitPps,
+  getTimelineLaneTop,
 } from "./timelineLayout";
 import { formatTime } from "../lib/time";
 import { usePlayerStore } from "../store/playerStore";
@@ -40,52 +44,216 @@ afterEach(() => {
   usePlayerStore.getState().reset();
 });
 
-describe("Timeline provider boundary", () => {
-  // fallow-ignore-next-line code-duplication
-  it("renders the public Timeline export without TimelineEditProvider", () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    Object.defineProperty(host, "clientWidth", {
-      configurable: true,
-      value: 640,
-    });
+function getHorizontalGeometry(host: HTMLElement, clipId: string, tickLabel: string) {
+  const clip = host.querySelector<HTMLElement>(`[data-el-id="${clipId}"]`);
+  if (!clip) throw new Error(`Missing timeline clip ${clipId}`);
+  const trackContent = clip.parentElement;
+  if (!trackContent) throw new Error(`Missing content row for ${clipId}`);
+  const trackHeader = trackContent.previousElementSibling;
+  if (!(trackHeader instanceof HTMLElement)) throw new Error(`Missing track header for ${clipId}`);
+  const rulerTickLabel = Array.from(host.querySelectorAll("span")).find(
+    (node) => node.textContent === tickLabel,
+  );
+  const rulerTick = rulerTickLabel?.parentElement;
+  if (!rulerTick) throw new Error(`Missing ruler tick ${tickLabel}`);
+  const ruler = rulerTick.parentElement;
+  if (!ruler) throw new Error("Missing timeline ruler");
+  const rulerOrigin = ruler.previousElementSibling;
+  if (!(rulerOrigin instanceof HTMLElement)) throw new Error("Missing timeline ruler origin");
+  const playhead = Array.from(host.querySelectorAll<HTMLElement>("div")).find(
+    (node) => node.style.zIndex === "100",
+  );
+  if (!playhead) throw new Error("Missing timeline playhead");
+  return { clip, trackHeader, rulerTick, rulerOrigin, playhead };
+}
+
+function renderTimelineGeometry(clipId: string) {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  act(() => {
+    root.render(React.createElement(Timeline));
+  });
+  return { host, root, ...getHorizontalGeometry(host, clipId, "00:10") };
+}
+
+function createSizedTimelineHost(width: number): HTMLDivElement {
+  const host = document.createElement("div");
+  document.body.append(host);
+  Object.defineProperty(host, "clientWidth", { configurable: true, value: width });
+  return host;
+}
+
+function expectTrackExpansion(
+  row: HTMLElement | null | undefined,
+  expandedClipIds: string[],
+  height: number,
+) {
+  expect(usePlayerStore.getState().expandedClipIds).toEqual(new Set(expandedClipIds));
+  expect(row?.style.height).toBe(`${height}px`);
+}
+
+function renderBasicTimeline() {
+  const host = createSizedTimelineHost(640);
+  usePlayerStore.setState({
+    duration: 4,
+    timelineReady: true,
+    elements: [{ id: "clip-1", tag: "div", start: 0, duration: 2, track: 0 }],
+  });
+  const root = createRoot(host);
+  act(() => {
+    root.render(React.createElement(Timeline));
+  });
+  return { host, root };
+}
 
+describe("Timeline provider boundary", () => {
+  it("keeps all-collapsed horizontal positions at the 32px gutter", () => {
     usePlayerStore.setState({
-      duration: 4,
+      duration: 11,
       timelineReady: true,
-      elements: [{ id: "clip-1", tag: "div", start: 0, duration: 2, track: 0 }],
+      currentTime: 10,
+      zoomMode: "manual",
+      manualZoomPercent: 100,
+      elements: [{ id: "clip-1", tag: "div", start: 10, duration: 1, track: 0 }],
     });
 
-    const root = createRoot(host);
-
-    expect(() => {
-      act(() => {
-        root.render(React.createElement(Timeline));
-      });
-    }).not.toThrow();
+    const { root, clip, trackHeader, rulerTick, rulerOrigin, playhead } =
+      renderTimelineGeometry("clip-1");
+
+    expect(trackHeader.style.width).toBe("32px");
+    expect(clip.style.left).toBe("1000px");
+    expect(clip.style.height).toBe("");
+    expect(clip.style.bottom).toBe(`${CLIP_Y}px`);
+    expect(rulerOrigin.style.width).toBe("32px");
+    expect(rulerTick.style.left).toBe("999.5px");
+    expect(playhead.style.left).toBe(`${1032 - PLAYHEAD_HEAD_W / 2}px`);
+    expect(playhead.style.width).toBe(`${PLAYHEAD_HEAD_W}px`);
+    expect(
+      resolveTimelineAssetDrop(
+        {
+          rectLeft: 100,
+          rectTop: 0,
+          scrollLeft: 0,
+          scrollTop: 0,
+          contentOrigin: GUTTER,
+          pixelsPerSecond: 100,
+          duration: 60,
+          trackOrder: [0],
+        },
+        1132,
+        100,
+      ).start,
+    ).toBe(10);
+    expect(getTimelineFitPps(640, 11, GUTTER)).toBe(10.1);
 
     act(() => root.unmount());
   });
 
-  // fallow-ignore-next-line code-duplication
-  it("renders the gutter without legacy icons or hue dots", () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    Object.defineProperty(host, "clientWidth", {
-      configurable: true,
-      value: 640,
-    });
-
+  it("reserves the label column and keeps expanded keyframes aligned with ruler time", () => {
     usePlayerStore.setState({
-      duration: 4,
+      duration: 20,
       timelineReady: true,
-      elements: [{ id: "clip-1", tag: "div", start: 0, duration: 2, track: 0 }],
+      currentTime: 10,
+      zoomMode: "manual",
+      manualZoomPercent: 100,
+      selectedElementId: "clip-1",
+      expandedClipIds: new Set(["clip-1"]),
+      elements: [
+        { id: "clip-1", label: "Hero card", tag: "div", start: 0, duration: 20, track: 0 },
+        { id: "clip-2", label: "Outro", tag: "div", start: 2, duration: 1, track: 1 },
+      ],
+      gsapAnimations: new Map([
+        [
+          "clip-1",
+          [
+            {
+              id: "position-tween",
+              targetSelector: "#clip-1",
+              method: "to",
+              position: 0,
+              duration: 20,
+              properties: {},
+              propertyGroup: "position",
+              keyframes: {
+                format: "percentage",
+                keyframes: [{ percentage: 50, properties: { x: 100 } }],
+              },
+            },
+          ],
+        ],
+      ]),
     });
 
-    const root = createRoot(host);
-    act(() => {
-      root.render(React.createElement(Timeline));
-    });
+    const { host, root, clip, trackHeader, rulerTick, rulerOrigin, playhead } =
+      renderTimelineGeometry("clip-1");
+    const { trackHeader: collapsedHeader } = getHorizontalGeometry(host, "clip-2", "00:10");
+    const diamond = host.querySelector<HTMLElement>(
+      '[data-keyframe-group="position"][data-keyframe-percentage="50"]',
+    );
+    if (!diamond) throw new Error("Missing expanded position keyframe");
+    const propertyLane = diamond.closest<HTMLElement>("[data-timeline-property-lane]");
+    if (!propertyLane) throw new Error("Missing flat position property lane");
+    const headerLane = trackHeader.querySelector<HTMLElement>('[data-property-group="position"]');
+    if (!headerLane) throw new Error("Missing position property header");
+    // Absolute x rebuilds from the content origin (the ruler-origin spacer),
+    // which now insets a GUTTER past the LABEL_COL_W label column so a 0%
+    // diamond has room to its left. The content row reaches that same origin via
+    // header (LABEL_COL_W) + its gutter margin, so ruler tick and diamond still
+    // coincide on the shared time x.
+    const contentOrigin = Number.parseFloat(rulerOrigin.style.width);
+    const rulerX = contentOrigin + Number.parseFloat(rulerTick.style.left) + 0.5;
+    const diamondX =
+      contentOrigin +
+      Number.parseFloat(propertyLane.style.left) +
+      Number.parseFloat(diamond.style.left) +
+      Number.parseFloat(diamond.style.width) / 2;
+
+    expect(clip.contains(propertyLane)).toBe(false);
+    expect(clip.style.height).toBe(`${TRACK_H - 2 * CLIP_Y}px`);
+    expect(clip.style.bottom).toBe("");
+    expect(propertyLane.style.top).toBe(`${getTimelineLaneTop(0)}px`);
+    expect(propertyLane.style.top).toBe(headerLane.style.top);
+    expect(propertyLane.style.background).toBe("");
+    expect(propertyLane.style.border).toBe("");
+    expect(propertyLane.style.borderRadius).toBe("");
+    expect(trackHeader.style.width).toBe(`${LABEL_COL_W}px`);
+    expect(rulerOrigin.style.width).toBe(`${LABEL_COL_W + GUTTER}px`);
+    expect(playhead.style.left).toBe(`${LABEL_COL_W + GUTTER + 1000 - PLAYHEAD_HEAD_W / 2}px`);
+    expect(diamondX).toBe(rulerX);
+    expect(rulerX).toBe(LABEL_COL_W + GUTTER + 1000);
+    expect(collapsedHeader.textContent).toContain("Outro");
+    expect(getTimelineFitPps(640, 20, LABEL_COL_W + GUTTER)).toBeCloseTo(
+      (640 - (LABEL_COL_W + GUTTER) - 2) / MIN_TIMELINE_EXTENT_S,
+    );
+    expect(
+      resolveTimelineAssetDrop(
+        {
+          rectLeft: 100,
+          rectTop: 0,
+          scrollLeft: 0,
+          scrollTop: 0,
+          contentOrigin: LABEL_COL_W + GUTTER,
+          pixelsPerSecond: 100,
+          duration: 60,
+          trackOrder: [0],
+        },
+        100 + LABEL_COL_W + GUTTER + 1000,
+        100,
+      ).start,
+    ).toBe(10);
+
+    act(() => root.unmount());
+  });
+
+  it("renders the public Timeline export without TimelineEditProvider", () => {
+    const { root } = renderBasicTimeline();
+
+    act(() => root.unmount());
+  });
+
+  it("renders the gutter without legacy icons or hue dots", () => {
+    const { host, root } = renderBasicTimeline();
 
     const hueDot = Array.from(host.querySelectorAll("div")).find(
       (node) =>
@@ -99,14 +267,8 @@ describe("Timeline provider boundary", () => {
     act(() => root.unmount());
   });
 
-  // fallow-ignore-next-line code-duplication
   it("requests persisted track visibility from the gutter without seeking", () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    Object.defineProperty(host, "clientWidth", {
-      configurable: true,
-      value: 640,
-    });
+    const host = createSizedTimelineHost(640);
 
     usePlayerStore.setState({
       duration: 4,
@@ -153,8 +315,8 @@ describe("Timeline provider boundary", () => {
     });
 
     const row = button.parentElement?.parentElement;
-    // Row children: [sticky gutter, TRACKS_LEFT_PAD spacer, time-mapped content].
-    const trackContent = row?.children.item(2);
+    // Row children: [TimelineTrackHeader (sticky column), time-mapped content].
+    const trackContent = row?.children.item(1);
     expect(onToggleTrackHidden).toHaveBeenCalledWith(0, false);
     expect(trackContent).toBeInstanceOf(HTMLElement);
     if (!(trackContent instanceof HTMLElement)) {
@@ -165,14 +327,49 @@ describe("Timeline provider boundary", () => {
     act(() => root.unmount());
   });
 
-  it("opens the keyframe context menu without seeking to that keyframe", () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    Object.defineProperty(host, "clientWidth", {
-      configurable: true,
-      value: 720,
+  it("splits all tracks once when shift-clicking the timeline with the razor", () => {
+    const host = createSizedTimelineHost(640);
+    usePlayerStore.setState({
+      activeTool: "razor",
+      duration: 4,
+      timelineReady: true,
+      elements: [{ id: "clip-1", tag: "div", start: 0, duration: 2, track: 0 }],
+    });
+
+    const onRazorSplitAll = vi.fn();
+    const root = createRoot(host);
+    act(() => {
+      root.render(
+        React.createElement(
+          TimelineEditProvider,
+          { value: { onRazorSplitAll } },
+          React.createElement(Timeline),
+        ),
+      );
+    });
+
+    const viewport = host.querySelector('[aria-label="Timeline"]')?.firstElementChild;
+    expect(viewport).toBeInstanceOf(HTMLElement);
+    act(() => {
+      viewport?.dispatchEvent(
+        new MouseEvent("pointerdown", {
+          bubbles: true,
+          cancelable: true,
+          button: 0,
+          clientX: 240,
+          shiftKey: true,
+        }),
+      );
     });
 
+    expect(onRazorSplitAll).toHaveBeenCalledTimes(1);
+    expect(onRazorSplitAll).toHaveBeenCalledWith(expect.any(Number));
+    act(() => root.unmount());
+  });
+
+  it("opens the keyframe context menu without seeking to that keyframe", () => {
+    const host = createSizedTimelineHost(720);
+
     usePlayerStore.setState({
       duration: 4,
       timelineReady: true,
@@ -215,14 +412,101 @@ describe("Timeline provider boundary", () => {
     act(() => root.unmount());
   });
 
-  it("marks every clip in selectedElementIds as selected", () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    Object.defineProperty(host, "clientWidth", {
-      configurable: true,
-      value: 720,
+  it("shows a disclosure only for grouped keyframes and toggles the track height", () => {
+    const host = createSizedTimelineHost(720);
+
+    usePlayerStore.setState({
+      duration: 4,
+      timelineReady: true,
+      elements: [
+        { id: "clip-1", tag: "div", start: 0, duration: 2, track: 0 },
+        { id: "clip-2", tag: "div", start: 2, duration: 2, track: 1 },
+      ],
+      keyframeCache: new Map([
+        [
+          "clip-1",
+          {
+            format: "percentage",
+            keyframes: [
+              { percentage: 0, properties: { x: 0 }, propertyGroup: "position" },
+              { percentage: 50, properties: { x: 100 }, propertyGroup: "position" },
+              { percentage: 100, properties: { opacity: 0 }, propertyGroup: "visual" },
+            ],
+          },
+        ],
+      ]),
+      gsapAnimations: new Map([
+        [
+          "clip-1",
+          [
+            {
+              id: "clip-1-position",
+              targetSelector: "#clip-1",
+              method: "to",
+              position: 0,
+              duration: 2,
+              properties: {},
+              propertyGroup: "position",
+              keyframes: {
+                format: "percentage",
+                keyframes: [
+                  { percentage: 0, properties: { x: 0 } },
+                  { percentage: 50, properties: { x: 100 } },
+                ],
+              },
+            },
+            {
+              id: "clip-1-visual",
+              targetSelector: "#clip-1",
+              method: "to",
+              position: 0,
+              duration: 2,
+              properties: {},
+              propertyGroup: "visual",
+              keyframes: {
+                format: "percentage",
+                keyframes: [{ percentage: 100, properties: { opacity: 0 } }],
+              },
+            },
+          ],
+        ],
+      ]),
     });
 
+    const root = createRoot(host);
+    act(() => {
+      root.render(React.createElement(Timeline));
+    });
+
+    // Keyframed clip-1 is expanded by default (AE/Figma default); its disclosure
+    // lives in the left column. clip-2 has no keyframes so it never shows one.
+    const collapseButton = host.querySelector<HTMLButtonElement>(
+      'button[aria-label="Collapse clip-1 keyframes"]',
+    );
+    expect(collapseButton).not.toBeNull();
+    expect(host.querySelector('button[aria-label="Expand clip-2 keyframes"]')).toBeNull();
+    expect(host.querySelector('button[aria-label="Collapse clip-2 keyframes"]')).toBeNull();
+
+    const clip = host.querySelector<HTMLElement>('[data-el-id="clip-1"]');
+    const row = clip?.parentElement?.parentElement;
+    expectTrackExpansion(row, ["clip-1"], TRACK_H + 2 * LANE_H);
+
+    // Collapsing sticks (does not bounce back open via auto-expand).
+    act(() => collapseButton?.click());
+    expectTrackExpansion(row, [], TRACK_H);
+
+    const expandButton = host.querySelector<HTMLButtonElement>(
+      'button[aria-label="Expand clip-1 keyframes"]',
+    );
+    expect(expandButton).not.toBeNull();
+    act(() => expandButton?.click());
+    expectTrackExpansion(row, ["clip-1"], TRACK_H + 2 * LANE_H);
+    act(() => root.unmount());
+  });
+
+  it("marks every clip in selectedElementIds as selected", () => {
+    const host = createSizedTimelineHost(720);
+
     usePlayerStore.setState({
       duration: 6,
       timelineReady: true,
@@ -461,23 +745,29 @@ describe("getTimelineFitPps (min 60s extent + fit headroom)", () => {
   it("computes fit pps against the 60s floor for short compositions", () => {
     // A 10s comp maps 60s onto the viewport → the comp takes ~1/6 of the width.
     // (10 * 1.2 = 12s of headroom-padded content is still under the 60s floor.)
-    const pps = getTimelineFitPps(viewport, 10);
-    expect(pps).toBeCloseTo((viewport - GUTTER - TRACKS_LEFT_PAD - 2) / MIN_TIMELINE_EXTENT_S);
-    expect(10 * pps).toBeCloseTo((viewport - GUTTER - TRACKS_LEFT_PAD - 2) / 6);
+    const pps = getTimelineFitPps(viewport, 10, GUTTER + TRACKS_LEFT_PAD);
+    expect(pps).toBeCloseTo((viewport - (GUTTER + TRACKS_LEFT_PAD) - 2) / MIN_TIMELINE_EXTENT_S);
+    expect(10 * pps).toBeCloseTo((viewport - (GUTTER + TRACKS_LEFT_PAD) - 2) / 6);
   });
 
   it("fits duration * FIT_ZOOM_HEADROOM (not the bare duration) for long compositions", () => {
-    expect(getTimelineFitPps(viewport, 60)).toBeCloseTo(
-      (viewport - GUTTER - TRACKS_LEFT_PAD - 2) / (60 * FIT_ZOOM_HEADROOM),
+    expect(getTimelineFitPps(viewport, 60, GUTTER + TRACKS_LEFT_PAD)).toBeCloseTo(
+      (viewport - (GUTTER + TRACKS_LEFT_PAD) - 2) / (60 * FIT_ZOOM_HEADROOM),
     );
-    expect(getTimelineFitPps(viewport, 120)).toBeCloseTo(
-      (viewport - GUTTER - TRACKS_LEFT_PAD - 2) / (120 * FIT_ZOOM_HEADROOM),
+    expect(getTimelineFitPps(viewport, 120, GUTTER + TRACKS_LEFT_PAD)).toBeCloseTo(
+      (viewport - (GUTTER + TRACKS_LEFT_PAD) - 2) / (120 * FIT_ZOOM_HEADROOM),
+    );
+  });
+
+  it("subtracts the expanded keyframe label column before fitting headroom", () => {
+    expect(getTimelineFitPps(viewport, 120, LABEL_COL_W)).toBeCloseTo(
+      (viewport - LABEL_COL_W - 2) / (120 * FIT_ZOOM_HEADROOM),
     );
   });
 
   it("leaves CapCut-style trailing headroom: the comp ends at 1/1.2 of the usable width", () => {
-    const usable = viewport - GUTTER - TRACKS_LEFT_PAD - 2;
-    const pps = getTimelineFitPps(viewport, 120);
+    const usable = viewport - (GUTTER + TRACKS_LEFT_PAD) - 2;
+    const pps = getTimelineFitPps(viewport, 120, GUTTER + TRACKS_LEFT_PAD);
     // Composition content occupies usable/1.2 px; the remaining ~17% is empty
     // droppable ruler/lane surface past the end.
     expect(120 * pps).toBeCloseTo(usable / FIT_ZOOM_HEADROOM);
@@ -485,17 +775,17 @@ describe("getTimelineFitPps (min 60s extent + fit headroom)", () => {
   });
 
   it("falls back to 100 pps before the viewport is measured", () => {
-    expect(getTimelineFitPps(0, 10)).toBe(100);
-    expect(getTimelineFitPps(GUTTER + TRACKS_LEFT_PAD, 10)).toBe(100);
-    expect(getTimelineFitPps(Number.NaN, 10)).toBe(100);
+    expect(getTimelineFitPps(0, 10, GUTTER)).toBe(100);
+    expect(getTimelineFitPps(GUTTER, 10, GUTTER)).toBe(100);
+    expect(getTimelineFitPps(Number.NaN, 10, GUTTER)).toBe(100);
   });
 
   it("uses the floor for zero/invalid durations", () => {
-    expect(getTimelineFitPps(viewport, 0)).toBeCloseTo(
-      (viewport - GUTTER - TRACKS_LEFT_PAD - 2) / MIN_TIMELINE_EXTENT_S,
+    expect(getTimelineFitPps(viewport, 0, GUTTER + TRACKS_LEFT_PAD)).toBeCloseTo(
+      (viewport - (GUTTER + TRACKS_LEFT_PAD) - 2) / MIN_TIMELINE_EXTENT_S,
     );
-    expect(getTimelineFitPps(viewport, Number.NaN)).toBeCloseTo(
-      (viewport - GUTTER - TRACKS_LEFT_PAD - 2) / MIN_TIMELINE_EXTENT_S,
+    expect(getTimelineFitPps(viewport, Number.NaN, GUTTER + TRACKS_LEFT_PAD)).toBeCloseTo(
+      (viewport - (GUTTER + TRACKS_LEFT_PAD) - 2) / MIN_TIMELINE_EXTENT_S,
     );
   });
 });
@@ -504,14 +794,24 @@ describe("getTimelineDisplayContentWidth", () => {
   it("always spans at least MIN_TIMELINE_EXTENT_S seconds of content", () => {
     // 10s of content at 20 pps = 200px; the floor keeps 60s (1200px) rendered.
     expect(
-      getTimelineDisplayContentWidth({ trackContentWidth: 200, viewportWidth: 400, pps: 20 }),
+      getTimelineDisplayContentWidth({
+        trackContentWidth: 200,
+        viewportWidth: 400,
+        contentOrigin: GUTTER,
+        pps: 20,
+      }),
     ).toBe(MIN_TIMELINE_EXTENT_S * 20);
   });
 
   it("still fills the viewport when that is larger than the 60s floor", () => {
     expect(
-      getTimelineDisplayContentWidth({ trackContentWidth: 200, viewportWidth: 2000, pps: 5 }),
-    ).toBe(2000 - GUTTER - TRACKS_LEFT_PAD - 2);
+      getTimelineDisplayContentWidth({
+        trackContentWidth: 200,
+        viewportWidth: 2000,
+        contentOrigin: GUTTER + TRACKS_LEFT_PAD,
+        pps: 5,
+      }),
+    ).toBe(2000 - (GUTTER + TRACKS_LEFT_PAD) - 2);
   });
 
   it("tracks a drag ghost past every other bound (drag-to-extend)", () => {
@@ -519,6 +819,7 @@ describe("getTimelineDisplayContentWidth", () => {
       getTimelineDisplayContentWidth({
         trackContentWidth: 500,
         viewportWidth: 400,
+        contentOrigin: GUTTER,
         pps: 5,
         dragGhostEndPx: 5000,
       }),
@@ -530,6 +831,7 @@ describe("getTimelineDisplayContentWidth", () => {
       getTimelineDisplayContentWidth({
         trackContentWidth: 500,
         viewportWidth: 400,
+        contentOrigin: GUTTER,
         pps: 5,
         resizeGhostEndPx: 4200,
       }),
@@ -538,7 +840,12 @@ describe("getTimelineDisplayContentWidth", () => {
 
   it("keeps long content authoritative", () => {
     expect(
-      getTimelineDisplayContentWidth({ trackContentWidth: 9000, viewportWidth: 400, pps: 50 }),
+      getTimelineDisplayContentWidth({
+        trackContentWidth: 9000,
+        viewportWidth: 400,
+        contentOrigin: GUTTER,
+        pps: 50,
+      }),
     ).toBe(9000);
   });
 });
@@ -565,7 +872,7 @@ describe("getTimelineScrollLeftForZoomAnchor", () => {
       getTimelineScrollLeftForZoomAnchor({
         pointerX: 300,
         currentScrollLeft: 200,
-        gutter: 32,
+        contentOrigin: GUTTER,
         currentPixelsPerSecond: 10,
         nextPixelsPerSecond: 20,
         duration: 120,
@@ -578,7 +885,7 @@ describe("getTimelineScrollLeftForZoomAnchor", () => {
       getTimelineScrollLeftForZoomAnchor({
         pointerX: 300,
         currentScrollLeft: 0,
-        gutter: 32,
+        contentOrigin: GUTTER,
         currentPixelsPerSecond: 20,
         nextPixelsPerSecond: 5,
         duration: 120,
@@ -591,7 +898,7 @@ describe("getTimelineScrollLeftForZoomAnchor", () => {
       getTimelineScrollLeftForZoomAnchor({
         pointerX: 300,
         currentScrollLeft: 120,
-        gutter: 32,
+        contentOrigin: GUTTER,
         currentPixelsPerSecond: 0,
         nextPixelsPerSecond: 20,
         duration: 120,
@@ -601,28 +908,47 @@ describe("getTimelineScrollLeftForZoomAnchor", () => {
 });
 
 describe("getTimelinePlayheadLeft", () => {
-  it("offsets the wrapper by half the head width so the line CENTER = GUTTER + TRACKS_LEFT_PAD + t*pps", () => {
+  it("offsets the wrapper by half the head width so the line CENTER = contentOrigin + t*pps", () => {
     // Wrapper left + PLAYHEAD_HEAD_W/2 (where the 1px line is centered) must
-    // equal GUTTER + TRACKS_LEFT_PAD + t*pps at any zoom.
-    expect(getTimelinePlayheadLeft(4, 20) + PLAYHEAD_HEAD_W / 2).toBe(
+    // equal contentOrigin + t*pps at any zoom, for both the padded default
+    // origin and the plain gutter origin.
+    expect(getTimelinePlayheadLeft(4, 20, GUTTER + TRACKS_LEFT_PAD) + PLAYHEAD_HEAD_W / 2).toBe(
       GUTTER + TRACKS_LEFT_PAD + 4 * 20,
     );
-    expect(getTimelinePlayheadLeft(10, 7.5) + PLAYHEAD_HEAD_W / 2).toBe(
+    expect(getTimelinePlayheadLeft(10, 7.5, GUTTER + TRACKS_LEFT_PAD) + PLAYHEAD_HEAD_W / 2).toBe(
       GUTTER + TRACKS_LEFT_PAD + 75,
     );
+    expect(getTimelinePlayheadLeft(4, 20, GUTTER) + PLAYHEAD_HEAD_W / 2).toBe(GUTTER + 4 * 20);
+    expect(getTimelinePlayheadLeft(10, 7.5, GUTTER) + PLAYHEAD_HEAD_W / 2).toBe(GUTTER + 75);
+  });
+
+  it("uses the expanded keyframe label column as the playhead origin", () => {
+    expect(getTimelinePlayheadLeft(4, 20, LABEL_COL_W) + PLAYHEAD_HEAD_W / 2).toBe(
+      LABEL_COL_W + 4 * 20,
+    );
   });
 
   it("centers the line exactly on the left pad's end (the 00:00 tick) at t = 0", () => {
-    expect(getTimelinePlayheadLeft(0, 20) + PLAYHEAD_HEAD_W / 2).toBe(GUTTER + TRACKS_LEFT_PAD);
+    expect(getTimelinePlayheadLeft(0, 20, GUTTER + TRACKS_LEFT_PAD) + PLAYHEAD_HEAD_W / 2).toBe(
+      GUTTER + TRACKS_LEFT_PAD,
+    );
+  });
+
+  it("centers the line exactly on the gutter (the 00:00 tick) at t = 0", () => {
+    expect(getTimelinePlayheadLeft(0, 20, GUTTER) + PLAYHEAD_HEAD_W / 2).toBe(GUTTER);
   });
 
   it("guards invalid input", () => {
-    expect(getTimelinePlayheadLeft(Number.NaN, 20)).toBe(
+    expect(getTimelinePlayheadLeft(Number.NaN, 20, GUTTER + TRACKS_LEFT_PAD)).toBe(
       GUTTER + TRACKS_LEFT_PAD - PLAYHEAD_HEAD_W / 2,
     );
-    expect(getTimelinePlayheadLeft(4, Number.NaN)).toBe(
+    expect(getTimelinePlayheadLeft(4, Number.NaN, GUTTER + TRACKS_LEFT_PAD)).toBe(
       GUTTER + TRACKS_LEFT_PAD - PLAYHEAD_HEAD_W / 2,
     );
+    expect(getTimelinePlayheadLeft(Number.NaN, 20, GUTTER)).toBe(GUTTER - PLAYHEAD_HEAD_W / 2);
+    expect(getTimelinePlayheadLeft(4, Number.NaN, LABEL_COL_W)).toBe(
+      LABEL_COL_W - PLAYHEAD_HEAD_W / 2,
+    );
   });
 });
 
@@ -686,14 +1012,15 @@ describe("resolveTimelineAssetDrop", () => {
           rectTop: 200,
           scrollLeft: 0,
           scrollTop: 0,
+          contentOrigin: GUTTER,
           pixelsPerSecond: 100,
           duration: 10,
           trackHeight: 72,
           trackOrder: [0, 3, 7],
         },
-        480, // rectLeft(100) + GUTTER + TRACKS_LEFT_PAD + 3s*100pps
-        // clientY updated for TRACKS_TOP_PAD=72: rectTop(200) + RULER_H(24) +
-        // TRACKS_TOP_PAD(72) + TRACK_H(48) + TRACK_H/2(24) = 368 → row 1 → track 3.
+        432, // rectLeft(100) + GUTTER(32) + 3s*100pps  (contentOrigin = GUTTER)
+        // clientY: rectTop(200) + RULER_H(24) + TRACKS_TOP_PAD(72) + TRACK_H(48)
+        // + TRACK_H/2(24) = 368 → row 1 → track 3.
         368,
       ),
     ).toEqual({ start: 3, track: 3 });
@@ -707,12 +1034,13 @@ describe("resolveTimelineAssetDrop", () => {
           rectTop: 200,
           scrollLeft: 0,
           scrollTop: 0,
+          contentOrigin: GUTTER,
           pixelsPerSecond: 100,
           duration: 10,
           trackHeight: 72,
           trackOrder: [0, 3, 7],
         },
-        250 + TRACKS_LEFT_PAD,
+        250, // rectLeft(100) + GUTTER(32) + 1.18s*100pps  (contentOrigin = GUTTER)
         600,
       ),
     ).toEqual({ start: 1.18, track: 8 });
diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 38bef2479b..1e3f0719f9 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -9,7 +9,6 @@ import { defaultTimelineTheme } from "./timelineTheme";
 import { useTimelineRangeSelection } from "./useTimelineRangeSelection";
 import { useTimelinePlayhead } from "./useTimelinePlayhead";
 import { useTimelineActiveClips } from "./useTimelineActiveClips";
-import { getTrackStyle } from "./timelineIcons";
 import { useTimelineZoom } from "./useTimelineZoom";
 import { useTimelineAssetDrop } from "./timelineDragDrop";
 import { TimelineEmptyState } from "./TimelineEmptyState";
@@ -17,19 +16,27 @@ import { TimelineCanvas } from "./TimelineCanvas";
 import { type KeyframeDiamondContextMenuState } from "./KeyframeDiamondContextMenu";
 import { useTimelineClipDrag } from "./useTimelineClipDrag";
 import { TimelineOverlays } from "./TimelineOverlays";
+import { animationContributesLane } from "./TimelinePropertyLanes";
 import { useTimelineEditPinning } from "./useTimelineEditPinning";
 import { useTimelineStackingSync } from "./useTimelineStackingSync";
 import { useTimelineGeometry } from "./useTimelineGeometry";
-import { useTimelineTrackDerivations } from "./useTimelineTrackDerivations";
-import { GUTTER, TRACKS_LEFT_PAD, generateTicks, getTimelineCanvasHeight } from "./timelineLayout";
+import { useAutoExpandKeyframedClips } from "./useAutoExpandKeyframedClips";
+import { GUTTER, LABEL_COL_W, generateTicks } from "./timelineLayout";
 import { useTimelineScrollViewport } from "./useTimelineScrollViewport";
 import { STUDIO_PREVIEW_FPS } from "../lib/time";
 import { useResolvedTimelineEditCallbacks } from "./useResolvedTimelineEditCallbacks";
 import type { TimelineProps } from "./TimelineTypes";
+import {
+  getTrackStyle,
+  useTimelineDisplayLayout,
+  useTimelineTrackLayout,
+} from "./useTimelineTrackLayout";
+import { useTimelineKeyframeHandlers } from "./useTimelineKeyframeHandlers";
+import { STUDIO_KEYFRAMES_ENABLED } from "../../components/editor/manualEditingAvailability";
 import { useTrackGapMenu } from "./useTrackGapMenu";
 import { useTimelineGapHighlights } from "./useTimelineGapHighlights";
-import { useTimelineKeyframeHandlers } from "./useTimelineKeyframeHandlers";
 import { useStudioPlaybackContextOptional } from "../../contexts/StudioContext";
+import { TimelineRazorGuide, useTimelineRazorInteraction } from "./TimelineRazorInteraction";
 
 // Re-export pure utilities so existing imports from "./Timeline" still resolve.
 export {
@@ -107,6 +114,22 @@ export const Timeline = memo(function Timeline({
   const timelineReady = usePlayerStore((s) => s.timelineReady);
   const selectedElementId = usePlayerStore((s) => s.selectedElementId);
   const selectedElementIds = usePlayerStore((s) => s.selectedElementIds);
+  const gsapAnimations = usePlayerStore((s) => s.gsapAnimations);
+  // Label mode = comp has keyframed clips (not just when expanded): keeps the layer
+  // disclosure + property column visible and reserves a GUTTER before 0s (Figma).
+  const hasKeyframedClips = useMemo(
+    () =>
+      Array.from(gsapAnimations.values()).some((list) =>
+        // Same lane-contribution predicate the layout uses: real keyframes OR a
+        // synthesizable flat tween. Checking animation.keyframes alone left a
+        // flat-tween-only comp without its reserved label column.
+        list.some((animation) => animationContributesLane(animation)),
+      ),
+    [gsapAnimations],
+  );
+  const labelMode = STUDIO_KEYFRAMES_ENABLED && hasKeyframedClips;
+  const contentOrigin = labelMode ? LABEL_COL_W + GUTTER : GUTTER;
+  const contentGutter = labelMode ? GUTTER : 0;
   const setSelectedElementId = usePlayerStore((s) => s.setSelectedElementId);
   const currentTime = usePlayerStore((s) => s.currentTime);
   const { zoomMode, manualZoomPercent, setZoomMode, setManualZoomPercent } = useTimelineZoom();
@@ -118,7 +141,6 @@ export const Timeline = memo(function Timeline({
   const [hoveredClip, setHoveredClip] = useState<string | null>(null);
   const isDragging = useRef(false);
   const [shiftHeld, setShiftHeld] = useState(false);
-  const [razorGuideX, setRazorGuideX] = useState<number | null>(null);
 
   useMountEffect(() => {
     const key = (e: KeyboardEvent) => e.key === "Shift" && setShiftHeld(e.type === "keydown");
@@ -155,9 +177,10 @@ export const Timeline = memo(function Timeline({
     return Number.isFinite(result) ? result : safeDur;
   }, [rawElements, duration]);
 
-  const { tracks, trackStyles, trackOrder } = useTimelineTrackDerivations(expandedElements);
-  const trackOrderRef = useRef(trackOrder);
-  trackOrderRef.current = trackOrder;
+  const keyframeCache = usePlayerStore((s) => s.keyframeCache);
+  useAutoExpandKeyframedClips(gsapAnimations);
+  const { tracks, trackStyles, trackOrder, trackOrderRef, laneCounts, rowHeights, rowHeightsRef } =
+    useTimelineTrackLayout(expandedElements, gsapAnimations, selectedElementId, selectedElementIds);
   const expandedElementsRef = useRef(expandedElements);
   expandedElementsRef.current = expandedElements;
 
@@ -224,6 +247,7 @@ export const Timeline = memo(function Timeline({
     ppsRef,
     durationRef,
     trackOrderRef,
+    rowHeightsRef,
     onMoveElement: pinnedOnMoveElement,
     onMoveElements: pinnedOnMoveElements,
     onResizeElement: pinnedOnResizeElement,
@@ -242,28 +266,23 @@ export const Timeline = memo(function Timeline({
       ppsRef,
       durationRef,
       trackOrderRef,
+      rowHeightsRef,
+      contentOrigin,
       onFileDrop: pinnedOnFileDrop,
       onAssetDrop: pinnedOnAssetDrop,
       onBlockDrop: pinnedOnBlockDrop,
       onCompositionDrop: pinnedOnCompositionDrop,
     });
 
-  const displayTrackOrder = useMemo(() => {
-    if (!draggedClip?.started || trackOrder.includes(draggedClip.previewTrack)) return trackOrder;
-    return [...trackOrder, draggedClip.previewTrack].sort((a, b) => a - b);
-  }, [draggedClip, trackOrder]);
-
-  const totalH = getTimelineCanvasHeight(displayTrackOrder.length);
+  const displayLayout = useTimelineDisplayLayout(draggedClip, trackOrder, rowHeights);
   const { viewportWidth, showShortcutHint, setScrollRef } = useTimelineScrollViewport(scrollRef, [
     timelineReady,
     expandedElements.length,
-    totalH,
+    displayLayout.totalH,
   ]);
-  const keyframeCache = usePlayerStore((s) => s.keyframeCache);
   const selectedKeyframes = usePlayerStore((s) => s.selectedKeyframes);
   const toggleSelectedKeyframe = usePlayerStore((s) => s.toggleSelectedKeyframe);
-
-  const { onClickKeyframe, onShiftClickKeyframe, onContextMenuKeyframe } =
+  const { onClickKeyframe, onSelectSegment, onShiftClickKeyframe, onContextMenuKeyframe } =
     useTimelineKeyframeHandlers({
       expandedElements,
       keyframeCache,
@@ -303,6 +322,7 @@ export const Timeline = memo(function Timeline({
     isDragging,
     scrollRef,
     lastScrollLeftRef,
+    contentOrigin,
   });
 
   const laneGapStrips = useTimelineGapHighlights({
@@ -335,12 +355,21 @@ export const Timeline = memo(function Timeline({
     setZoomMode,
     setManualZoomPercent,
     onSeek,
+    contentOrigin,
   });
   useTimelineActiveClips({
     scrollRef,
     currentTime,
     clipStateVersion,
   });
+  const { razorGuideX, updateRazorGuide, clearRazorGuide, splitAllAtPointer } =
+    useTimelineRazorInteraction({
+      active: activeTool === "razor",
+      scrollRef,
+      contentOrigin,
+      pixelsPerSecond: pps,
+      onSplitAll: onRazorSplitAll,
+    });
 
   const {
     rangeSelection,
@@ -364,7 +393,9 @@ export const Timeline = memo(function Timeline({
     setShowPopover,
     elementsRef: expandedElementsRef,
     trackOrderRef,
+    rowHeightsRef,
     onSelectElement,
+    contentOrigin,
   });
   setRangeSelectionRef.current = setRangeSelection; // stable ref consumed by useTimelineClipDrag
 
@@ -423,13 +454,8 @@ export const Timeline = memo(function Timeline({
       ref={setContainerRef}
       aria-label="Timeline"
       className={`relative border-t select-none h-full overflow-hidden ${isDragOver ? "ring-1 ring-inset ring-studio-accent/60" : ""} ${activeTool === "razor" ? "cursor-crosshair" : shiftHeld ? "cursor-crosshair" : "cursor-default"}`}
-      onMouseMove={(e) => {
-        if (activeTool === "razor" && scrollRef.current) {
-          const rect = scrollRef.current.getBoundingClientRect();
-          setRazorGuideX(e.clientX - rect.left + scrollRef.current.scrollLeft);
-        }
-      }}
-      onMouseLeave={() => setRazorGuideX(null)}
+      onMouseMove={updateRazorGuide}
+      onMouseLeave={clearRazorGuide}
       style={{
         touchAction: "pan-x pan-y",
         background: theme.shellBackground,
@@ -450,14 +476,7 @@ export const Timeline = memo(function Timeline({
           // Let interactive controls (keyframe nav/toggle, caret, inputs) handle
           // their own clicks — scrubbing here would preventDefault and eat them.
           if (e.target instanceof Element && e.target.closest("button, input, select, a")) return;
-          if (activeTool === "razor" && e.shiftKey && e.button === 0 && scrollRef.current) {
-            const rect = scrollRef.current.getBoundingClientRect();
-            const x =
-              e.clientX - rect.left + scrollRef.current.scrollLeft - GUTTER - TRACKS_LEFT_PAD;
-            const splitTime = Math.max(0, x / pps);
-            onRazorSplitAll?.(splitTime);
-            return;
-          }
+          if (splitAllAtPointer(e)) return;
           handlePointerDown(e);
         }}
         onPointerMove={handlePointerMove}
@@ -468,18 +487,22 @@ export const Timeline = memo(function Timeline({
           major={major}
           minor={minor}
           pps={pps}
+          contentOrigin={contentOrigin}
+          contentGutter={contentGutter}
           trackContentWidth={displayContentWidth}
-          totalH={totalH}
+          totalH={displayLayout.totalH}
           effectiveDuration={effectiveDuration}
           majorTickInterval={majorTickInterval}
           rangeSelection={rangeSelection}
           marqueeRect={marqueeRect}
           laneGapStrips={laneGapStrips}
           theme={theme}
-          displayTrackOrder={displayTrackOrder}
+          displayTrackOrder={displayLayout.displayTrackOrder}
+          rowHeights={displayLayout.displayRowHeights}
           trackOrder={trackOrder}
           tracks={tracks}
           trackStyles={trackStyles}
+          laneCounts={laneCounts}
           selectedElementId={selectedElementId}
           selectedElementIds={selectedElementIds}
           hoveredClip={hoveredClip}
@@ -505,9 +528,12 @@ export const Timeline = memo(function Timeline({
           getPreviewElement={getPreviewElement}
           getTrackStyle={getTrackStyle}
           keyframeCache={keyframeCache}
+          gsapAnimations={gsapAnimations}
           selectedKeyframes={selectedKeyframes}
           currentTime={currentTime}
+          onSeek={onSeek}
           beatAnalysis={adjustedBeatAnalysis}
+          onSelectSegment={onSelectSegment}
           onClickKeyframe={onClickKeyframe}
           onShiftClickKeyframe={onShiftClickKeyframe}
           onMoveKeyframe={onMoveKeyframe}
@@ -525,16 +551,7 @@ export const Timeline = memo(function Timeline({
             openGapMenu({ x: e.clientX, y: e.clientY, track, time });
           }}
         />
-        {activeTool === "razor" && razorGuideX !== null && (
-          <div
-            className="absolute top-0 bottom-0 pointer-events-none z-10"
-            style={{
-              left: razorGuideX,
-              width: 1,
-              background: "rgba(239,68,68,0.7)",
-            }}
-          />
-        )}
+        {activeTool === "razor" && razorGuideX !== null && <TimelineRazorGuide x={razorGuideX} />}
       </div>
       <TimelineOverlays
         theme={theme}
diff --git a/packages/studio/src/player/components/TimelineCanvas.tsx b/packages/studio/src/player/components/TimelineCanvas.tsx
index 462acc2885..181ca290b8 100644
--- a/packages/studio/src/player/components/TimelineCanvas.tsx
+++ b/packages/studio/src/player/components/TimelineCanvas.tsx
@@ -4,16 +4,15 @@ import { PlayheadIndicator } from "./PlayheadIndicator";
 import { getTimelineEditCapabilities, type TimelineRangeSelection } from "./timelineEditing";
 import { getRenderedTimelineElement } from "./timelineTheme";
 import {
-  GUTTER,
-  TRACK_H,
   RULER_H,
   CLIP_Y,
   TRACKS_TOP_PAD,
   TRACKS_BOTTOM_PAD,
-  TRACKS_LEFT_PAD,
+  TRACK_H,
   PLAYHEAD_HEAD_W,
   getTimelinePlayheadLeft,
   getTimelineRowTop,
+  getTimelineRowHeight,
 } from "./timelineLayout";
 import { usePlayerStore } from "../store/playerStore";
 import type { ResizingClipState } from "./useTimelineClipDrag";
@@ -45,8 +44,17 @@ interface TimelineCanvasProps extends TimelineLaneBaseProps {
 
 export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvasProps) {
   const { draggedClip, scrollRef, selectedElementIds, displayTrackOrder } = props;
-  const { onResizeElement, onMoveElement, onToggleTrackHidden, onRazorSplit, onRazorSplitAll } =
-    useTimelineEditContextOptional();
+  const draggedRowIndex =
+    draggedClip?.started === true ? displayTrackOrder.indexOf(draggedClip.previewTrack) : -1;
+  const draggedRowHeight = getTimelineRowHeight(draggedRowIndex, props.rowHeights);
+  const {
+    onResizeElement,
+    onMoveElement,
+    onToggleTrackHidden,
+    onTogglePropertyGroupKeyframe,
+    onRazorSplit,
+    onRazorSplitAll,
+  } = useTimelineEditContextOptional();
   const beatDragging = usePlayerStore((s) => s.beatDragging);
   // Scroll a clip into view when the sidebar (asset card) requests a reveal.
   useTimelineRevealClip(scrollRef);
@@ -63,8 +71,6 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
   // The drag ghost follows the cursor freely (both axes) — CapCut-style. The
   // "magnetic" affordance is a highlight on the destination lane (draggedRowIndex),
   // which flips at the MAGNETIC_TRACK_THRESHOLD point; the clip drops into it.
-  const draggedRowIndex =
-    draggedClip?.started === true ? displayTrackOrder.indexOf(draggedClip.previewTrack) : -1;
   // Live multi-selection drag: while a selected clip is dragged, ALL selected
   // clips move together as one rigid formation. The GRABBED clip is the free
   // ghost below; its co-selected "passengers" slide by the SAME group-clamped
@@ -101,7 +107,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
   return (
     <div
       className="relative"
-      style={{ height: props.totalH, width: GUTTER + TRACKS_LEFT_PAD + props.trackContentWidth }}
+      style={{ height: props.totalH, width: props.contentOrigin + props.trackContentWidth }}
     >
       <TimelineRuler
         major={props.major}
@@ -113,6 +119,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
         majorTickInterval={props.majorTickInterval}
         theme={props.theme}
         beatAnalysis={props.beatAnalysis}
+        contentOrigin={props.contentOrigin}
       />
 
       {/* Breathing room between the sticky ruler and the first track lane — the
@@ -124,6 +131,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
         draggedElement={draggedElement}
         multiDragPreview={multiDragPreview}
         onToggleTrackHidden={onToggleTrackHidden}
+        onTogglePropertyGroupKeyframe={onTogglePropertyGroupKeyframe}
         onResizeElement={onResizeElement}
         onMoveElement={onMoveElement}
         onRazorSplit={onRazorSplit}
@@ -148,8 +156,8 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
             key={`gap-${strip.kind}-${strip.track}-${gap.start}`}
             className="pointer-events-none absolute"
             style={{
-              top: getTimelineRowTop(rowIndex) + CLIP_Y,
-              left: GUTTER + TRACKS_LEFT_PAD + gap.start * props.pps,
+              top: getTimelineRowTop(rowIndex, props.rowHeights) + CLIP_Y,
+              left: props.contentOrigin + gap.start * props.pps,
               width: Math.max((gap.end - gap.start) * props.pps, 2),
               height: TRACK_H - CLIP_Y * 2,
               background: loud ? "rgba(60,230,172,0.18)" : "rgba(60,230,172,0.055)",
@@ -166,10 +174,10 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
         <div
           className="absolute pointer-events-none"
           style={{
-            top: getTimelineRowTop(draggedRowIndex) + CLIP_Y,
-            left: GUTTER + TRACKS_LEFT_PAD + draggedClip.previewStart * props.pps,
+            top: getTimelineRowTop(draggedRowIndex, props.rowHeights) + CLIP_Y,
+            left: props.contentOrigin + draggedClip.previewStart * props.pps,
             width: Math.max(draggedClip.element.duration * props.pps, 4),
-            height: TRACK_H - CLIP_Y * 2,
+            height: draggedRowHeight - CLIP_Y * 2,
             border: "1px solid rgba(60,230,172,0.55)",
             background: "rgba(60,230,172,0.12)",
             borderRadius: 4,
@@ -184,8 +192,8 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
         <div
           className="absolute pointer-events-none"
           style={{
-            top: getTimelineRowTop(draggedClip.insertRow) - 0.5,
-            left: GUTTER + TRACKS_LEFT_PAD,
+            top: getTimelineRowTop(draggedClip.insertRow, props.rowHeights) - 0.5,
+            left: props.contentOrigin,
             width: props.trackContentWidth,
             height: 1,
             background: "#3CE6AC",
@@ -200,7 +208,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
         <div
           className="absolute pointer-events-none"
           style={{
-            left: GUTTER + TRACKS_LEFT_PAD + draggedClip.snapTime * props.pps,
+            left: props.contentOrigin + draggedClip.snapTime * props.pps,
             top: RULER_H,
             bottom: 0,
             width: 1,
@@ -222,7 +230,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
             top: activeDraggedPosition.top,
             left: activeDraggedPosition.left,
             width: Math.max(activeDraggedElement.duration * props.pps, 4),
-            height: TRACK_H - CLIP_Y * 2,
+            height: draggedRowHeight - CLIP_Y * 2,
             zIndex: 40,
           }}
         >
@@ -280,8 +288,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
           className="absolute pointer-events-none"
           style={{
             left:
-              GUTTER +
-              TRACKS_LEFT_PAD +
+              props.contentOrigin +
               Math.min(props.rangeSelection.start, props.rangeSelection.end) * props.pps,
             width: Math.abs(props.rangeSelection.end - props.rangeSelection.start) * props.pps,
             top: RULER_H,
@@ -297,13 +304,13 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
       {/* Playhead — hidden while dragging a beat so its guideline doesn't
           track the scrub and clutter the beat being moved. Explicit width +
           the half-head offset baked into getTimelinePlayheadLeft keep the
-          inner 1px line's CENTER exactly on GUTTER + t * pps (the ruler
+          inner 1px line's CENTER exactly on contentOrigin + t * pps (the ruler
           ticks' center), instead of relying on shrink-wrap sizing. */}
       <div
         ref={props.playheadRef}
         className="absolute top-0 bottom-0 pointer-events-none"
         style={{
-          left: `${getTimelinePlayheadLeft(0, 0)}px`,
+          left: `${getTimelinePlayheadLeft(0, 0, props.contentOrigin)}px`,
           width: PLAYHEAD_HEAD_W,
           zIndex: 100,
           display: beatDragging ? "none" : undefined,
diff --git a/packages/studio/src/player/components/TimelineClip.tsx b/packages/studio/src/player/components/TimelineClip.tsx
index 79abf1c39b..8ba1a24d1f 100644
--- a/packages/studio/src/player/components/TimelineClip.tsx
+++ b/packages/studio/src/player/components/TimelineClip.tsx
@@ -8,6 +8,7 @@ interface TimelineClipProps {
   el: TimelineElement;
   pps: number;
   clipY: number;
+  clipHeight?: number;
   isSelected: boolean;
   isHovered: boolean;
   isDragging?: boolean;
@@ -30,6 +31,7 @@ export const TimelineClip = memo(function TimelineClip({
   el,
   pps,
   clipY,
+  clipHeight,
   isSelected,
   isHovered,
   isDragging = false,
@@ -71,7 +73,7 @@ export const TimelineClip = memo(function TimelineClip({
     left: leftPx,
     width: widthPx,
     top: clipY,
-    bottom: clipY,
+    ...(clipHeight === undefined ? { bottom: clipY } : { height: clipHeight }),
     borderRadius: theme.clipRadius,
     zIndex: isDragging ? 20 : isSelected ? 10 : isHovered ? 5 : 1,
     // Regular cursor over clips (CapCut-style, user preference) — no grab hand.
diff --git a/packages/studio/src/player/components/TimelineDragGhost.tsx b/packages/studio/src/player/components/TimelineDragGhost.tsx
deleted file mode 100644
index 771bddb65d..0000000000
--- a/packages/studio/src/player/components/TimelineDragGhost.tsx
+++ /dev/null
@@ -1,59 +0,0 @@
-import type { ReactNode } from "react";
-import { TimelineClip } from "./TimelineClip";
-import { getTimelineEditCapabilities } from "./timelineEditing";
-import { CLIP_Y, TRACK_H } from "./timelineLayout";
-import type { TimelineTheme } from "./timelineTheme";
-import type { TimelineElement } from "../store/playerStore";
-
-interface TimelineDragGhostProps {
-  element: TimelineElement;
-  position: { left: number; top: number };
-  pps: number;
-  selectedElementId: string | null;
-  hasCustomContent: boolean;
-  theme: TimelineTheme;
-  children: ReactNode;
-}
-
-export function TimelineDragGhost({
-  element,
-  position,
-  pps,
-  selectedElementId,
-  hasCustomContent,
-  theme,
-  children,
-}: TimelineDragGhostProps) {
-  return (
-    <div
-      className="absolute pointer-events-none"
-      style={{
-        top: position.top,
-        left: position.left,
-        width: Math.max(element.duration * pps, 4),
-        height: TRACK_H - CLIP_Y * 2,
-        zIndex: 40,
-      }}
-    >
-      <TimelineClip
-        el={{ ...element, start: 0 }}
-        pps={pps}
-        clipY={0}
-        isSelected={selectedElementId === (element.key ?? element.id)}
-        isHovered={false}
-        isDragging={true}
-        hasCustomContent={hasCustomContent}
-        capabilities={getTimelineEditCapabilities(element)}
-        theme={theme}
-        isComposition={!!element.compositionSrc}
-        onHoverStart={() => {}}
-        onHoverEnd={() => {}}
-        onResizeStart={() => {}}
-        onClick={() => {}}
-        onDoubleClick={() => {}}
-      >
-        {children}
-      </TimelineClip>
-    </div>
-  );
-}
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index 4ee3afc531..3d9769afd5 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -1,13 +1,16 @@
 import { type ReactNode } from "react";
-import { Eye, EyeSlash } from "@phosphor-icons/react";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { BeatStrip, BeatBackgroundLines } from "./BeatStrip";
 import { TimelineClip } from "./TimelineClip";
 import { TimelineClipDiamonds } from "./TimelineClipDiamonds";
+import { TimelinePropertyLanes } from "./TimelinePropertyLanes";
+import { TimelineTrackHeader } from "./TimelineTrackHeader";
+import { resolveTrackKeyframeClip } from "./useTimelineTrackLayout";
 import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
 import type { MusicBeatAnalysis } from "@hyperframes/core/beats";
 import { getTimelineEditCapabilities, resolveBlockedTimelineEditIntent } from "./timelineEditing";
 import type { TimelineTheme } from "./timelineTheme";
-import { GUTTER, TRACK_H, TRACKS_LEFT_PAD, CLIP_Y, CLIP_HANDLE_W } from "./timelineLayout";
+import { CLIP_Y, CLIP_HANDLE_W, TRACK_H, getTimelineRowHeight } from "./timelineLayout";
 import {
   usePlayerStore,
   type TimelineElement,
@@ -22,9 +25,9 @@ import {
 import type { TrackVisualStyle } from "./timelineIcons";
 import type { TimelineEditCallbacks } from "./timelineCallbacks";
 import { STUDIO_KEYFRAMES_ENABLED } from "../../components/editor/manualEditingAvailability";
+import { trackStudioKeyframeLaneExpand } from "../../telemetry/events";
 import { SPLIT_BOUNDARY_EPSILON_S } from "../../utils/timelineElementSplit";
 import { isAudioTimelineElement, isMusicTrack } from "../../utils/timelineInspector";
-import { Music } from "../../icons/SystemIcons";
 import { renderClipChildren } from "./timelineClipChildren";
 
 /**
@@ -35,12 +38,16 @@ import { renderClipChildren } from "./timelineClipChildren";
  */
 export interface TimelineLaneBaseProps {
   pps: number;
+  contentOrigin: number;
+  contentGutter: number;
   trackContentWidth: number;
   theme: TimelineTheme;
   displayTrackOrder: number[];
+  rowHeights: readonly number[];
   trackOrder: number[];
   tracks: [number, TimelineElement[]][];
   trackStyles: Map<number, TrackVisualStyle>;
+  laneCounts: ReadonlyMap<string, number>;
   selectedElementId: string | null;
   selectedElementIds: Set<string>;
   hoveredClip: string | null;
@@ -70,19 +77,25 @@ export interface TimelineLaneBaseProps {
   getPreviewElement: (element: TimelineElement) => TimelineElement;
   getTrackStyle: (tag: string) => TrackVisualStyle;
   keyframeCache?: Map<string, KeyframeCacheEntry>;
+  gsapAnimations: Map<string, GsapAnimation[]>;
   selectedKeyframes: Set<string>;
   currentTime: number;
-  onClickKeyframe?: (element: TimelineElement, keyframe: TimelineKeyframeTarget) => void;
-  onShiftClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
+  onSeek?: (time: number) => void;
+  onSelectSegment?: (elementId: string, target: TimelineKeyframeTarget) => void;
+  onClickKeyframe?: (element: TimelineElement, target: TimelineKeyframeTarget) => void;
+  onShiftClickKeyframe?: (elementId: string, target: TimelineKeyframeTarget) => void;
   onContextMenuKeyframe?: (
     e: React.MouseEvent,
     elementId: string,
-    keyframe: TimelineKeyframeTarget,
+    target: TimelineKeyframeTarget,
   ) => void;
   onMoveKeyframe?: (
     elementId: string,
     keyframe: TimelineKeyframeTarget,
     toClipPercentage: number,
+    propertyGroup?: string,
+    tweenPercentage?: number,
+    animationId?: string,
   ) => Promise<boolean>;
   onContextMenuClip?: (e: React.MouseEvent, element: TimelineElement) => void;
   /**
@@ -99,6 +112,7 @@ interface TimelineLanesProps extends TimelineLaneBaseProps {
   draggedElement: TimelineElement | null;
   multiDragPreview: MultiDragPreviewInput | null;
   onToggleTrackHidden: TimelineEditCallbacks["onToggleTrackHidden"];
+  onTogglePropertyGroupKeyframe: TimelineEditCallbacks["onTogglePropertyGroupKeyframe"];
   onResizeElement: TimelineEditCallbacks["onResizeElement"];
   onMoveElement: TimelineEditCallbacks["onMoveElement"];
   onRazorSplit: TimelineEditCallbacks["onRazorSplit"];
@@ -107,12 +121,16 @@ interface TimelineLanesProps extends TimelineLaneBaseProps {
 
 export function TimelineLanes({
   pps,
+  contentOrigin,
+  contentGutter,
   trackContentWidth,
   theme,
   displayTrackOrder,
+  rowHeights,
   trackOrder,
   tracks,
   trackStyles,
+  laneCounts,
   selectedElementId,
   selectedElementIds,
   hoveredClip,
@@ -137,8 +155,11 @@ export function TimelineLanes({
   getPreviewElement,
   getTrackStyle,
   keyframeCache,
+  gsapAnimations,
   selectedKeyframes,
   currentTime,
+  onSeek,
+  onSelectSegment,
   onClickKeyframe,
   onShiftClickKeyframe,
   onContextMenuKeyframe,
@@ -147,11 +168,19 @@ export function TimelineLanes({
   onContextMenuLane,
   beatAnalysis,
   onToggleTrackHidden,
+  onTogglePropertyGroupKeyframe,
   onResizeElement,
   onMoveElement,
   onRazorSplit,
   onRazorSplitAll,
 }: TimelineLanesProps) {
+  const expandedClipIds = usePlayerStore((s) => s.expandedClipIds);
+  const toggleClipExpanded = usePlayerStore((s) => s.toggleClipExpanded);
+  const toggleClipExpandedTracked = (key: string) => {
+    const willExpand = !expandedClipIds.has(key);
+    trackStudioKeyframeLaneExpand({ expanded: willExpand });
+    toggleClipExpanded(key);
+  };
   return (
     <>
       {
@@ -161,7 +190,8 @@ export function TimelineLanes({
         // bounded and virtualization's complexity isn't worth it. TODO: revisit and swap
         // in a virtualizer if editorial workflows ever push very high clip counts.
         // fallow-ignore-next-line complexity
-        displayTrackOrder.map((trackNum) => {
+        displayTrackOrder.map((trackNum, row) => {
+          const rowHeight = getTimelineRowHeight(row, rowHeights);
           const els = tracks.find(([t]) => t === trackNum)?.[1] ?? [];
           const ts = trackStyles.get(trackNum) ?? getTrackStyle("");
           const isPendingTrack =
@@ -178,58 +208,55 @@ export function TimelineLanes({
               : els.some(isMusicTrack));
           const isTrackHidden = els.length > 0 && els.every((element) => element.hidden === true);
           const isAudioTrack = els.length > 0 && els.some(isAudioTimelineElement);
+          // The one keyframed element this track shows lanes for (selected, else
+          // most lanes). A track can hold several elements; scoping to one keeps
+          // their keyframes from cramming into a single row.
+          const keyframeClip = STUDIO_KEYFRAMES_ENABLED
+            ? resolveTrackKeyframeClip(els, laneCounts, selectedElementId, selectedElementIds)
+            : null;
+          const keyframeClipKey = keyframeClip?.key ?? keyframeClip?.id;
+          const keyframeClipExpanded =
+            keyframeClipKey != null && expandedClipIds.has(keyframeClipKey);
           return (
-            <div key={trackNum} className="relative flex" style={{ height: TRACK_H }}>
-              <div
-                className="sticky left-0 z-[12] flex-shrink-0 flex flex-col items-center justify-center gap-0.5"
-                style={{
-                  width: GUTTER,
-                  background: theme.gutterBackground,
-                  borderRight: `1px solid ${theme.gutterBorder}`,
-                  borderBottom: `1px solid ${theme.rowBorder}`,
+            <div
+              key={trackNum}
+              className="relative flex"
+              style={{
+                height: rowHeight,
+                background: rowBackground,
+                borderBottom: `1px solid ${theme.rowBorder}`,
+              }}
+            >
+              <TimelineTrackHeader
+                trackNumber={trackNum}
+                trackLabel={els[0]?.label ?? els[0]?.domId ?? els[0]?.id ?? `Track ${trackNum}`}
+                contentOrigin={contentOrigin}
+                keyframeClip={keyframeClip}
+                clipCount={els.length}
+                isExpanded={keyframeClipExpanded}
+                animations={keyframeClipKey ? (gsapAnimations.get(keyframeClipKey) ?? []) : []}
+                currentTime={currentTime}
+                isTrackHidden={isTrackHidden}
+                isAudioTrack={isAudioTrack}
+                isActive={
+                  keyframeClipKey != null &&
+                  (selectedElementId === keyframeClipKey || selectedElementIds.has(keyframeClipKey))
+                }
+                isHovered={keyframeClipKey != null && hoveredClip === keyframeClipKey}
+                theme={theme}
+                onToggleClipExpanded={() => {
+                  if (keyframeClipKey) {
+                    toggleClipExpandedTracked(keyframeClipKey);
+                  }
                 }}
-              >
-                {isAudioTrack && (
-                  <Music size={12} weight="fill" aria-hidden="true" className="text-white/35" />
-                )}
-                <button
-                  type="button"
-                  aria-label={isTrackHidden ? `Show track ${trackNum}` : `Hide track ${trackNum}`}
-                  title={isTrackHidden ? `Show track ${trackNum}` : `Hide track ${trackNum}`}
-                  className={`flex h-6 w-6 items-center justify-center rounded border-0 bg-transparent p-0 transition-colors focus-visible:outline focus-visible:outline-1 focus-visible:outline-offset-[-1px] focus-visible:outline-[#3CE6AC] ${
-                    isTrackHidden
-                      ? "text-[#3CE6AC] hover:text-white"
-                      : "text-white/35 hover:text-white/75"
-                  }`}
-                  onPointerDown={(e) => {
-                    e.stopPropagation();
-                  }}
-                  onClick={(e) => {
-                    e.stopPropagation();
-                    void onToggleTrackHidden?.(trackNum, !isTrackHidden);
-                  }}
-                >
-                  {isTrackHidden ? (
-                    <EyeSlash size={14} weight="bold" aria-hidden="true" />
-                  ) : (
-                    <Eye size={14} weight="bold" aria-hidden="true" />
-                  )}
-                </button>
-              </div>
-              {/* Left breathing pad — empty lane surface before t=0, scrolling
-                  with the content (the horizontal TRACKS_TOP_PAD). Sits OUTSIDE
-                  the time-mapped content div so clip/beat/menu math stays
-                  content-relative (clip left = t·pps). */}
-              <div
-                aria-hidden="true"
-                className="flex-shrink-0"
-                style={{ width: TRACKS_LEFT_PAD }}
+                onToggleTrackHidden={onToggleTrackHidden}
+                onTogglePropertyGroupKeyframe={onTogglePropertyGroupKeyframe}
+                onSeek={onSeek}
               />
               <div
                 style={{
                   width: trackContentWidth,
-                  background: rowBackground,
-                  borderBottom: `1px solid ${theme.rowBorder}`,
+                  marginLeft: contentGutter, // room for a 0% diamond left of t=0
                   opacity: isTrackHidden ? 0.35 : 1,
                   transition: "opacity 120ms ease",
                 }}
@@ -287,6 +314,13 @@ export function TimelineLanes({
                   els.map((el) => {
                     const clipStyle = getTrackStyle(el.tag);
                     const elementKey = el.key ?? el.id;
+                    // Only the track's active keyframe clip shows expanded lanes;
+                    // other clips (incl. siblings on a shared track) show compact
+                    // diamonds on their own bar instead.
+                    const showsLanes =
+                      STUDIO_KEYFRAMES_ENABLED &&
+                      elementKey === keyframeClipKey &&
+                      keyframeClipExpanded;
                     const capabilities = getTimelineEditCapabilities(el);
                     const isSelected =
                       selectedElementId === elementKey || selectedElementIds.has(elementKey);
@@ -320,6 +354,7 @@ export function TimelineLanes({
                         el={previewElement}
                         pps={pps}
                         clipY={CLIP_Y}
+                        clipHeight={showsLanes ? TRACK_H - 2 * CLIP_Y : undefined}
                         isSelected={isSelected}
                         isHovered={hoveredClip === clipKey}
                         isDragging={false}
@@ -462,34 +497,70 @@ export function TimelineLanes({
                           renderClipContent,
                           renderClipOverlay,
                         )}
-                        {STUDIO_KEYFRAMES_ENABLED && keyframeCache?.get(elementKey) && (
-                          <TimelineClipDiamonds
-                            keyframesData={keyframeCache.get(elementKey)!}
-                            clipWidthPx={Math.max(previewElement.duration * pps, 4)}
-                            clipHeightPx={TRACK_H - 2 * CLIP_Y}
-                            beatsActive={beatStripOnTrack}
-                            accentColor={clipStyle.accent}
-                            isSelected={isSelected}
-                            currentPercentage={
-                              previewElement.duration > 0
-                                ? ((currentTime - previewElement.start) / previewElement.duration) *
-                                  100
-                                : 0
-                            }
-                            elementId={elementKey}
-                            selectedKeyframes={selectedKeyframes}
-                            onClickKeyframe={(_elId, keyframe) =>
-                              onClickKeyframe?.(previewElement, keyframe)
-                            }
-                            onShiftClickKeyframe={onShiftClickKeyframe}
-                            onContextMenuKeyframe={onContextMenuKeyframe}
-                            onMoveKeyframe={onMoveKeyframe}
-                            suppressClickRef={suppressClickRef}
-                          />
-                        )}
+                        {STUDIO_KEYFRAMES_ENABLED &&
+                          !showsLanes &&
+                          keyframeCache?.get(elementKey) && (
+                            <TimelineClipDiamonds
+                              keyframesData={keyframeCache.get(elementKey)!}
+                              clipWidthPx={Math.max(previewElement.duration * pps, 4)}
+                              clipHeightPx={rowHeight - 2 * CLIP_Y}
+                              beatsActive={beatStripOnTrack}
+                              accentColor={clipStyle.accent}
+                              isSelected={isSelected}
+                              currentPercentage={
+                                previewElement.duration > 0
+                                  ? ((currentTime - previewElement.start) /
+                                      previewElement.duration) *
+                                    100
+                                  : 0
+                              }
+                              elementId={elementKey}
+                              selectedKeyframes={selectedKeyframes}
+                              onClickKeyframe={(_elId, target) =>
+                                onClickKeyframe?.(previewElement, target)
+                              }
+                              onShiftClickKeyframe={onShiftClickKeyframe}
+                              onContextMenuKeyframe={onContextMenuKeyframe}
+                              onMoveKeyframe={onMoveKeyframe}
+                              onSelectSegment={onSelectSegment}
+                              suppressClickRef={suppressClickRef}
+                            />
+                          )}
                       </TimelineClip>
                     );
-                    if (!isPassenger) return clip;
+                    const propertyLanes = showsLanes && (
+                      <TimelinePropertyLanes
+                        key={`${clipKey}-property-lanes`}
+                        animations={gsapAnimations.get(elementKey) ?? []}
+                        clipStart={previewElement.start}
+                        clipDuration={previewElement.duration}
+                        clipLeftPx={previewElement.start * pps}
+                        clipWidthPx={Math.max(previewElement.duration * pps, 4)}
+                        accentColor={clipStyle.accent}
+                        isSelected={isSelected}
+                        currentPercentage={
+                          previewElement.duration > 0
+                            ? ((currentTime - previewElement.start) / previewElement.duration) * 100
+                            : 0
+                        }
+                        elementId={elementKey}
+                        selectedKeyframes={selectedKeyframes}
+                        onSelectSegment={(target) => onSelectSegment?.(elementKey, target)}
+                        onClickKeyframe={(target) => onClickKeyframe?.(previewElement, target)}
+                        onShiftClickKeyframe={(target) =>
+                          onShiftClickKeyframe?.(elementKey, target)
+                        }
+                        onContextMenuKeyframe={(e, target) =>
+                          onContextMenuKeyframe?.(e, elementKey, target)
+                        }
+                        onMoveKeyframe={(target, toClipPercentage) =>
+                          onMoveKeyframe?.(elementKey, target, toClipPercentage) ??
+                          Promise.resolve(false)
+                        }
+                        suppressClickRef={suppressClickRef}
+                      />
+                    );
+                    if (!isPassenger) return [clip, propertyLanes];
                     return (
                       <div
                         key={clipKey}
@@ -502,6 +573,7 @@ export function TimelineLanes({
                         }}
                       >
                         {clip}
+                        {propertyLanes}
                       </div>
                     );
                   })
diff --git a/packages/studio/src/player/components/TimelineOverlays.tsx b/packages/studio/src/player/components/TimelineOverlays.tsx
index 44e3120747..76a309a4e4 100644
--- a/packages/studio/src/player/components/TimelineOverlays.tsx
+++ b/packages/studio/src/player/components/TimelineOverlays.tsx
@@ -106,13 +106,11 @@ export function TimelineOverlays({
         <KeyframeDiamondContextMenu
           state={kfContextMenu}
           onClose={() => setKfContextMenu(null)}
-          onDelete={(elId, pct) => onDeleteKeyframe?.(elId, { percentage: pct })}
-          onDeleteAll={(elId) => onDeleteAllKeyframes?.(elId)}
+          onDelete={(...args) => onDeleteKeyframe?.(...args)}
+          onDeleteAll={(element) => onDeleteAllKeyframes?.(element)}
           onChangeEase={(elId, pct, ease) => onChangeKeyframeEase?.(elId, pct, ease)}
           onMoveToPlayhead={
-            onMoveKeyframeToPlayhead
-              ? (elId, pct) => onMoveKeyframeToPlayhead(elId, { percentage: pct })
-              : undefined
+            onMoveKeyframeToPlayhead ? (...args) => onMoveKeyframeToPlayhead(...args) : undefined
           }
           onCopyProperties={(elId, pct) => {
             const kfData = keyframeCache.get(elId);
diff --git a/packages/studio/src/player/components/TimelineRazorInteraction.tsx b/packages/studio/src/player/components/TimelineRazorInteraction.tsx
new file mode 100644
index 0000000000..881daa07a8
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineRazorInteraction.tsx
@@ -0,0 +1,60 @@
+import { useCallback, useState, type MouseEvent, type PointerEvent, type RefObject } from "react";
+import { getTimelineContentXFromClient } from "./timelineLayout";
+
+interface TimelineRazorInteractionOptions {
+  active: boolean;
+  scrollRef: RefObject<HTMLDivElement | null>;
+  contentOrigin: number;
+  pixelsPerSecond: number;
+  onSplitAll?: (time: number) => void;
+}
+
+export function useTimelineRazorInteraction({
+  active,
+  scrollRef,
+  contentOrigin,
+  pixelsPerSecond,
+  onSplitAll,
+}: TimelineRazorInteractionOptions) {
+  const [razorGuideX, setRazorGuideX] = useState<number | null>(null);
+
+  const updateRazorGuide = useCallback(
+    (event: MouseEvent<HTMLDivElement>) => {
+      const scroll = scrollRef.current;
+      if (!active || !scroll) return;
+      const rect = scroll.getBoundingClientRect();
+      setRazorGuideX(event.clientX - rect.left + scroll.scrollLeft);
+    },
+    [active, scrollRef],
+  );
+
+  const clearRazorGuide = useCallback(() => setRazorGuideX(null), []);
+
+  const splitAllAtPointer = useCallback(
+    (event: PointerEvent<HTMLDivElement>) => {
+      const scroll = scrollRef.current;
+      if (!active || !event.shiftKey || event.button !== 0 || !scroll) return false;
+      const rect = scroll.getBoundingClientRect();
+      const x = getTimelineContentXFromClient({
+        clientX: event.clientX,
+        rectLeft: rect.left,
+        scrollLeft: scroll.scrollLeft,
+        contentOrigin,
+      });
+      onSplitAll?.(Math.max(0, x / pixelsPerSecond));
+      return true;
+    },
+    [active, contentOrigin, onSplitAll, pixelsPerSecond, scrollRef],
+  );
+
+  return { razorGuideX, updateRazorGuide, clearRazorGuide, splitAllAtPointer };
+}
+
+export function TimelineRazorGuide({ x }: { x: number }) {
+  return (
+    <div
+      className="absolute top-0 bottom-0 pointer-events-none z-10"
+      style={{ left: x, width: 1, background: "rgba(239,68,68,0.7)" }}
+    />
+  );
+}
diff --git a/packages/studio/src/player/components/TimelineRuler.tsx b/packages/studio/src/player/components/TimelineRuler.tsx
index fe8fac5f18..5356341bbe 100644
--- a/packages/studio/src/player/components/TimelineRuler.tsx
+++ b/packages/studio/src/player/components/TimelineRuler.tsx
@@ -1,6 +1,6 @@
 import { memo } from "react";
 import type { TimelineTheme } from "./timelineTheme";
-import { GUTTER, RULER_H, TRACKS_LEFT_PAD, formatTimelineTickLabel } from "./timelineLayout";
+import { RULER_H, formatTimelineTickLabel } from "./timelineLayout";
 import { usePlayerStore } from "../store/playerStore";
 import { secondsToFrame } from "../lib/time";
 import type { MusicBeatAnalysis } from "@hyperframes/core/beats";
@@ -15,6 +15,7 @@ interface TimelineRulerProps {
   majorTickInterval: number;
   theme: TimelineTheme;
   beatAnalysis?: MusicBeatAnalysis | null;
+  contentOrigin: number;
 }
 
 export const TimelineRuler = memo(function TimelineRuler({
@@ -27,6 +28,7 @@ export const TimelineRuler = memo(function TimelineRuler({
   majorTickInterval,
   theme,
   beatAnalysis,
+  contentOrigin,
 }: TimelineRulerProps) {
   const timeDisplayMode = usePlayerStore((s) => s.timeDisplayMode);
   const beatTimes = beatAnalysis?.beatTimes ?? [];
@@ -45,7 +47,7 @@ export const TimelineRuler = memo(function TimelineRuler({
           the ruler's own small ticks mark intervals (no full-height lines). */}
       <svg
         className="absolute pointer-events-none"
-        style={{ left: GUTTER + TRACKS_LEFT_PAD, width: trackContentWidth, zIndex: 0 }}
+        style={{ left: contentOrigin, width: trackContentWidth, zIndex: 0 }}
         height={totalH}
       >
         {showBeats &&
@@ -69,35 +71,23 @@ export const TimelineRuler = memo(function TimelineRuler({
       </svg>
 
       {/* Ruler — sticky so the timestamps stay visible while the tracks scroll
-          vertically. Opaque background (plus the gutter corner block) so clips
+          vertically. Opaque background (plus the label-column corner block) so clips
           scrolling underneath don't bleed through; z-index sits above the track
           rows and drag overlays but below the playhead (z 100). */}
       <div
         className="sticky top-0 flex"
-        style={{
-          height: RULER_H,
-          width: GUTTER + TRACKS_LEFT_PAD + trackContentWidth,
-          zIndex: 70,
-        }}
+        style={{ height: RULER_H, width: contentOrigin + trackContentWidth, zIndex: 70 }}
       >
         <div
           className="sticky left-0 z-[12] flex-shrink-0"
           style={{
-            width: GUTTER,
-            // Ruler corner uses the panel surface — same as the ruler strip
-            // itself, and NO right border: the ruler band stays completely
-            // clean until 00:00 (the header-boundary line belongs to the track
-            // rows below, not the ruler).
+            width: contentOrigin,
+            // Ruler corner uses the panel surface — same as the ruler strip itself.
             background: theme.shellBackground,
           }}
         />
-        {/* Left breathing pad — scrolls with the content, so 00:00 starts a
-            beat right of the gutter (see TRACKS_LEFT_PAD). */}
-        <div
-          aria-hidden="true"
-          className="flex-shrink-0"
-          style={{ width: TRACKS_LEFT_PAD, background: theme.shellBackground }}
-        />
+        {/* Breathing pad before 00:00 is folded into contentOrigin (see
+            Timeline.tsx: GUTTER + TRACKS_LEFT_PAD), so no separate pad div. */}
         <div
           className="relative overflow-hidden"
           style={{
@@ -110,7 +100,7 @@ export const TimelineRuler = memo(function TimelineRuler({
         >
           {/* Each 1px tick line is shifted -0.5px so its CENTER sits exactly on
               t * pps — matching the playhead line, which is also centered on
-              GUTTER + t * pps (see getTimelinePlayheadLeft). Without the shift
+              contentOrigin + t * pps (see getTimelinePlayheadLeft). Without the shift
               a tick spans [x, x+1) and its center is half a pixel right. */}
           {minor.map((t) => (
             <div key={`m-${t}`} className="absolute bottom-0" style={{ left: t * pps - 0.5 }}>
diff --git a/packages/studio/src/player/components/timelineDragDrop.ts b/packages/studio/src/player/components/timelineDragDrop.ts
index 3f4c70a9f4..0d3985b7a7 100644
--- a/packages/studio/src/player/components/timelineDragDrop.ts
+++ b/packages/studio/src/player/components/timelineDragDrop.ts
@@ -5,7 +5,7 @@ import {
   TIMELINE_COMPOSITION_MIME,
 } from "../../utils/timelineCompositionDrop";
 import { usePlayerStore } from "../store/playerStore";
-import { TRACK_H, resolveTimelineAssetDrop } from "./timelineLayout";
+import { resolveTimelineAssetDrop } from "./timelineLayout";
 import type { TimelineDropCallbacks } from "./timelineCallbacks";
 
 interface UseTimelineAssetDropOptions extends TimelineDropCallbacks {
@@ -13,6 +13,8 @@ interface UseTimelineAssetDropOptions extends TimelineDropCallbacks {
   ppsRef: RefObject<number>;
   durationRef: RefObject<number>;
   trackOrderRef: RefObject<number[]>;
+  rowHeightsRef: RefObject<readonly number[]>;
+  contentOrigin: number;
 }
 
 type TimelinePlacement = { start: number; track: number };
@@ -54,6 +56,8 @@ export function useTimelineAssetDrop({
   ppsRef,
   durationRef,
   trackOrderRef,
+  rowHeightsRef,
+  contentOrigin,
   onFileDrop,
   onAssetDrop,
   onBlockDrop,
@@ -85,10 +89,11 @@ export function useTimelineAssetDrop({
           rectTop: rect?.top ?? 0,
           scrollLeft: scroll?.scrollLeft ?? 0,
           scrollTop: scroll?.scrollTop ?? 0,
+          contentOrigin,
           pixelsPerSecond: ppsRef.current,
           duration: durationRef.current,
           clampStartToDuration: !usePointerStart,
-          trackHeight: TRACK_H,
+          rowHeights: rowHeightsRef.current,
           trackOrder: trackOrderRef.current,
         },
         clientX,
@@ -99,7 +104,7 @@ export function useTimelineAssetDrop({
         track: pointer.track,
       };
     },
-    [scrollRef, ppsRef, durationRef, trackOrderRef],
+    [scrollRef, ppsRef, durationRef, trackOrderRef, rowHeightsRef, contentOrigin],
   );
 
   const handleAssetDrop = useCallback(
diff --git a/packages/studio/src/player/components/timelineLayout.test.ts b/packages/studio/src/player/components/timelineLayout.test.ts
index c21618faaf..250345fffd 100644
--- a/packages/studio/src/player/components/timelineLayout.test.ts
+++ b/packages/studio/src/player/components/timelineLayout.test.ts
@@ -154,15 +154,16 @@ describe("track-area breathing pad y-math", () => {
       rectTop: 0,
       scrollLeft: 0,
       scrollTop: 0,
+      contentOrigin: GUTTER,
       pixelsPerSecond: 100,
       duration: 60,
-      trackHeight: TRACK_H,
+      rowHeights: trackHeights(3),
       trackOrder: [0, 1, 2],
     };
 
     it("drops onto lane 0 when the pointer is in the middle of the first lane", () => {
       const clientY = getTimelineRowTop(0) + TRACK_H / 2;
-      const clientX = GUTTER + TRACKS_LEFT_PAD + 100; // t = 1s
+      const clientX = GUTTER + 100; // t = 1s (contentOrigin = GUTTER)
       const { start, track } = resolveTimelineAssetDrop(base, clientX, clientY);
       expect(track).toBe(0);
       expect(start).toBe(1);
@@ -179,6 +180,13 @@ describe("track-area breathing pad y-math", () => {
       const { track } = resolveTimelineAssetDrop(base, GUTTER, clientY);
       expect(track).toBe(3); // max(trackOrder)+1
     });
+
+    it("keeps a drop in an expanded lane region on that track", () => {
+      const rowHeights = [TRACK_H + 2 * LANE_H, TRACK_H, TRACK_H];
+      const clientY = getTimelineRowTop(0, rowHeights) + TRACK_H + LANE_H;
+      const { track } = resolveTimelineAssetDrop({ ...base, rowHeights }, GUTTER, clientY);
+      expect(track).toBe(0);
+    });
   });
 });
 
@@ -188,6 +196,7 @@ describe("getTimelineScrubTime", () => {
       clientX,
       viewportLeft: 0,
       scrollLeft: 0,
+      contentOrigin: GUTTER + TRACKS_LEFT_PAD,
       pixelsPerSecond: 100,
       duration,
     });
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 07790e7743..c2f4b02003 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -13,7 +13,6 @@ export const CLIP_HANDLE_W = 18;
 export function getTimelineLaneTop(laneIndex: number): number {
   return TRACK_H + Math.max(0, Math.trunc(laneIndex)) * LANE_H;
 }
-
 /**
  * Collapsed-row characterization value for the new-track INSERT band. Runtime
  * hit-testing uses getTimelineInsertBoundaryBand with the concrete row height.
@@ -43,7 +42,7 @@ export const TRACKS_BOTTOM_PAD = Math.round(TRACK_H * 1.5);
  */
 export const TRACKS_LEFT_PAD = 48;
 
-interface TimelineTrackHeightClip {
+export interface TimelineTrackHeightClip {
   clipId: string;
   laneCount: number;
 }
@@ -307,12 +306,16 @@ export function formatTimelineTickLabel(time: number, duration: number, majorInt
  * remaining ruler runs to 1:00.
  * Manual zoom multiplies this base, so the floor only anchors the default.
  */
-export function getTimelineFitPps(viewportWidth: number, effectiveDuration: number): number {
+export function getTimelineFitPps(
+  viewportWidth: number,
+  effectiveDuration: number,
+  contentOrigin: number,
+): number {
   const safeDuration =
     Number.isFinite(effectiveDuration) && effectiveDuration > 0 ? effectiveDuration : 0;
   const span = Math.max(safeDuration * FIT_ZOOM_HEADROOM, MIN_TIMELINE_EXTENT_S);
-  if (!Number.isFinite(viewportWidth) || viewportWidth <= GUTTER + TRACKS_LEFT_PAD) return 100;
-  return (viewportWidth - GUTTER - TRACKS_LEFT_PAD - 2) / span;
+  if (!Number.isFinite(viewportWidth) || viewportWidth <= contentOrigin) return 100;
+  return (viewportWidth - contentOrigin - 2) / span;
 }
 
 /**
@@ -325,6 +328,7 @@ export function getTimelineFitPps(viewportWidth: number, effectiveDuration: numb
 export function getTimelineDisplayContentWidth(input: {
   trackContentWidth: number;
   viewportWidth: number;
+  contentOrigin: number;
   pps: number;
   dragGhostEndPx?: number;
   resizeGhostEndPx?: number;
@@ -332,7 +336,7 @@ export function getTimelineDisplayContentWidth(input: {
   const safePps = Number.isFinite(input.pps) ? Math.max(input.pps, 0) : 0;
   return Math.max(
     input.trackContentWidth,
-    input.viewportWidth - GUTTER - TRACKS_LEFT_PAD - 2,
+    input.viewportWidth - input.contentOrigin - 2,
     input.dragGhostEndPx ?? 0,
     input.resizeGhostEndPx ?? 0,
     MIN_TIMELINE_EXTENT_S * safePps,
@@ -340,6 +344,15 @@ export function getTimelineDisplayContentWidth(input: {
 }
 
 /* ── Scroll / zoom helpers ────────────────────────────────────────── */
+export function getTimelineContentXFromClient(input: {
+  clientX: number;
+  rectLeft: number;
+  scrollLeft: number;
+  contentOrigin: number;
+}): number {
+  return input.clientX - input.rectLeft + input.scrollLeft - input.contentOrigin;
+}
+
 export function shouldAutoScrollTimeline(
   zoomMode: ZoomMode,
   scrollWidth: number,
@@ -362,7 +375,7 @@ export function getTimelineScrollLeftForZoomTransition(
 export function getTimelineScrollLeftForZoomAnchor(input: {
   pointerX: number;
   currentScrollLeft: number;
-  gutter: number;
+  contentOrigin: number;
   currentPixelsPerSecond: number;
   nextPixelsPerSecond: number;
   duration: number;
@@ -379,9 +392,17 @@ export function getTimelineScrollLeftForZoomAnchor(input: {
   ) {
     return Math.max(0, input.currentScrollLeft);
   }
-  const timelineX = Math.max(0, input.currentScrollLeft + input.pointerX - input.gutter);
+  const timelineX = Math.max(
+    0,
+    getTimelineContentXFromClient({
+      clientX: input.pointerX,
+      rectLeft: 0,
+      scrollLeft: input.currentScrollLeft,
+      contentOrigin: input.contentOrigin,
+    }),
+  );
   const timeAtPointer = Math.max(0, Math.min(input.duration, timelineX / currentPps));
-  return Math.max(0, input.gutter + timeAtPointer * nextPps - input.pointerX);
+  return Math.max(0, input.contentOrigin + timeAtPointer * nextPps - input.pointerX);
 }
 
 /* ── Playhead / canvas ────────────────────────────────────────────── */
@@ -390,33 +411,32 @@ export function getTimelineScrollLeftForZoomAnchor(input: {
  * width, which the wrapper shrink-wraps to). The 1px vertical line inside
  * PlayheadIndicator is centered at 50% of this wrapper, so the wrapper must be
  * shifted LEFT by half this width for the line's center to land exactly on
- * `GUTTER + time * pps` — see {@link getTimelinePlayheadLeft}.
+ * `contentOrigin + time * pps` — see {@link getTimelinePlayheadLeft}.
  */
 export const PLAYHEAD_HEAD_W = 9;
 
 /**
  * The `left` for the playhead WRAPPER such that the vertical line's CENTER
- * sits exactly on `GUTTER + time * pps` (the same x the ruler ticks center
+ * sits exactly on `contentOrigin + time * pps` (the same x the ruler ticks center
  * on) at every zoom level. Without the half-head offset the line sat
  * `PLAYHEAD_HEAD_W / 2` px to the right of its ruler tick.
  */
-export function getTimelinePlayheadLeft(time: number, pixelsPerSecond: number): number {
+export function getTimelinePlayheadLeft(
+  time: number,
+  pixelsPerSecond: number,
+  contentOrigin: number,
+): number {
   if (!Number.isFinite(time) || !Number.isFinite(pixelsPerSecond)) {
-    return GUTTER + TRACKS_LEFT_PAD - PLAYHEAD_HEAD_W / 2;
+    return contentOrigin - PLAYHEAD_HEAD_W / 2;
   }
-  return (
-    GUTTER +
-    TRACKS_LEFT_PAD +
-    Math.max(0, time) * Math.max(0, pixelsPerSecond) -
-    PLAYHEAD_HEAD_W / 2
-  );
+  return contentOrigin + Math.max(0, time) * Math.max(0, pixelsPerSecond) - PLAYHEAD_HEAD_W / 2;
 }
 
 /**
  * Inverse of {@link getTimelinePlayheadLeft}: the scrub time under a viewport
  * clientX. Clamped to [0, duration], NOT rejected — the scrub surface starts
- * `GUTTER + TRACKS_LEFT_PAD` px right of the viewport edge, so any pointer left
- * of t=0 maps to a negative offset. Callers used to bail on that instead of
+ * `contentOrigin` px right of the viewport edge, so any pointer left of t=0
+ * maps to a negative offset. Callers used to bail on that instead of
  * clamping, which made the last 80px of the drag to zero silently do nothing:
  * the playhead stuck wherever the last in-range sample landed, and only a very
  * slow drag that happened to sample inside the sliver before the origin reached
@@ -426,12 +446,18 @@ export function getTimelineScrubTime(input: {
   clientX: number;
   viewportLeft: number;
   scrollLeft: number;
+  contentOrigin: number;
   pixelsPerSecond: number;
   duration: number;
 }): number {
-  const { clientX, viewportLeft, scrollLeft, pixelsPerSecond, duration } = input;
+  const { clientX, viewportLeft, scrollLeft, contentOrigin, pixelsPerSecond, duration } = input;
   if (!(pixelsPerSecond > 0) || !Number.isFinite(duration)) return 0;
-  const x = clientX - viewportLeft + scrollLeft - GUTTER - TRACKS_LEFT_PAD;
+  const x = getTimelineContentXFromClient({
+    clientX,
+    rectLeft: viewportLeft,
+    scrollLeft,
+    contentOrigin,
+  });
   return Math.max(0, Math.min(duration, x / pixelsPerSecond));
 }
 
@@ -500,16 +526,22 @@ export function resolveTimelineAssetDrop(
     rectTop: number;
     scrollLeft: number;
     scrollTop: number;
+    contentOrigin: number;
     pixelsPerSecond: number;
     duration: number;
     clampStartToDuration?: boolean;
-    trackHeight: number;
+    rowHeights?: readonly number[];
     trackOrder: number[];
   },
   clientX: number,
   clientY: number,
 ): { start: number; track: number } {
-  const x = clientX - input.rectLeft + input.scrollLeft - GUTTER - TRACKS_LEFT_PAD;
+  const x = getTimelineContentXFromClient({
+    clientX,
+    rectLeft: input.rectLeft,
+    scrollLeft: input.scrollLeft,
+    contentOrigin: input.contentOrigin,
+  });
   const contentY = clientY - input.rectTop + input.scrollTop;
   const pointerStart = Math.round((x / Math.max(input.pixelsPerSecond, 1)) * 100) / 100;
   const start = Math.max(
@@ -519,7 +551,7 @@ export function resolveTimelineAssetDrop(
   // Row from the shared row→y inverse so the top pad is honoured; a drop in the
   // pad above the first lane floors to row 0, a drop in the bottom pad rounds
   // past the last lane (getDefaultDroppedTrack then appends a new track).
-  const rowIndex = Math.floor(getTimelineRowFromY(contentY));
+  const rowIndex = Math.floor(getTimelineRowFromY(contentY, input.rowHeights));
   return {
     start,
     track: getDefaultDroppedTrack(input.trackOrder, rowIndex),
diff --git a/packages/studio/src/player/components/timelineMarquee.ts b/packages/studio/src/player/components/timelineMarquee.ts
index 9ddc02d9f3..23bffaf317 100644
--- a/packages/studio/src/player/components/timelineMarquee.ts
+++ b/packages/studio/src/player/components/timelineMarquee.ts
@@ -1,11 +1,4 @@
-import {
-  GUTTER,
-  RULER_H,
-  CLIP_Y,
-  TRACKS_LEFT_PAD,
-  getTimelineRowHeight,
-  getTimelineRowTop,
-} from "./timelineLayout";
+import { RULER_H, CLIP_Y, getTimelineRowHeight, getTimelineRowTop } from "./timelineLayout";
 import { rectsOverlap, type Rect } from "../../utils/marqueeGeometry";
 
 /** Pointer must travel at least this far (either axis) before a pointerdown on
@@ -76,7 +69,7 @@ export function getTimelineClipRect(
   clip: Pick<MarqueeClipInput, "start" | "duration" | "track">,
   trackOrder: number[],
   pps: number,
-  contentOrigin: number = GUTTER + TRACKS_LEFT_PAD,
+  contentOrigin: number,
   rowHeights: readonly number[] = [],
 ): Rect | null {
   const row = trackOrder.indexOf(clip.track);
@@ -105,7 +98,7 @@ export function computeMarqueeSelection(input: {
   clips: MarqueeClipInput[];
   trackOrder: number[];
   pps: number;
-  contentOrigin?: number;
+  contentOrigin: number;
   marquee: Rect;
   baseSelection?: Iterable<string>;
   rowHeights?: readonly number[];
diff --git a/packages/studio/src/player/components/useTimelineGeometry.ts b/packages/studio/src/player/components/useTimelineGeometry.ts
index fb18810902..6241cda973 100644
--- a/packages/studio/src/player/components/useTimelineGeometry.ts
+++ b/packages/studio/src/player/components/useTimelineGeometry.ts
@@ -21,6 +21,7 @@ interface UseTimelineGeometryInput {
   isDragging: RefObject<boolean>;
   scrollRef: RefObject<HTMLDivElement | null>;
   lastScrollLeftRef: RefObject<number>;
+  contentOrigin: number;
 }
 
 // Derive the timeline's horizontal geometry from the viewport, zoom, and any live
@@ -40,10 +41,11 @@ export function useTimelineGeometry({
   isDragging,
   scrollRef,
   lastScrollLeftRef,
+  contentOrigin,
 }: UseTimelineGeometryInput) {
   // Fit pps maps at least MIN_TIMELINE_EXTENT_S onto the viewport, so short
   // comps show a 60s ruler with usable empty space (see getTimelineFitPps).
-  const fitPps = getTimelineFitPps(viewportWidth, effectiveDuration);
+  const fitPps = getTimelineFitPps(viewportWidth, effectiveDuration, contentOrigin);
   const pps = getTimelinePixelsPerSecond(fitPps, zoomMode, manualZoomPercent);
   ppsRef.current = pps;
   const trackContentWidth = Math.max(0, effectiveDuration * pps);
@@ -70,6 +72,7 @@ export function useTimelineGeometry({
   const displayContentWidth = getTimelineDisplayContentWidth({
     trackContentWidth,
     viewportWidth,
+    contentOrigin,
     pps,
     dragGhostEndPx,
     resizeGhostEndPx,
diff --git a/packages/studio/src/player/components/useTimelinePlayhead.ts b/packages/studio/src/player/components/useTimelinePlayhead.ts
index f7c3ab6b30..23c547188b 100644
--- a/packages/studio/src/player/components/useTimelinePlayhead.ts
+++ b/packages/studio/src/player/components/useTimelinePlayhead.ts
@@ -3,8 +3,6 @@ import { liveTime, type ZoomMode } from "../store/playerStore";
 import { useMountEffect } from "../../hooks/useMountEffect";
 import { getPinchTimelineZoomPercent } from "./timelineZoom";
 import {
-  GUTTER,
-  TRACKS_LEFT_PAD,
   getTimelinePlayheadLeft,
   getTimelineScrubTime,
   getTimelineScrollLeftForZoomTransition,
@@ -32,6 +30,7 @@ interface UseTimelinePlayheadInput {
   setZoomMode: (mode: ZoomMode) => void;
   setManualZoomPercent: (percent: number) => void;
   onSeek?: (time: number) => void;
+  contentOrigin: number;
 }
 
 export function useTimelinePlayhead({
@@ -53,6 +52,7 @@ export function useTimelinePlayhead({
   setZoomMode,
   setManualZoomPercent,
   onSeek,
+  contentOrigin,
 }: UseTimelinePlayheadInput) {
   const dragScrollRaf = useRef(0);
   const previousZoomModeRef = useRef<ZoomMode | null>(zoomMode);
@@ -61,6 +61,8 @@ export function useTimelinePlayhead({
   // anchors at the cursor instead, so it opts out via `skipCenterAnchorRef`.
   const previousAnchorPpsRef = useRef(pps);
   const skipCenterAnchorRef = useRef(false);
+  const contentOriginRef = useRef(contentOrigin);
+  contentOriginRef.current = contentOrigin;
 
   useLayoutEffect(() => {
     const scroll = scrollRef.current;
@@ -75,21 +77,21 @@ export function useTimelinePlayhead({
     const nextScrollLeft = getTimelineScrollLeftForZoomAnchor({
       pointerX: scroll.clientWidth / 2,
       currentScrollLeft: scroll.scrollLeft,
-      gutter: GUTTER + TRACKS_LEFT_PAD,
+      contentOrigin,
       currentPixelsPerSecond: prevPps,
       nextPixelsPerSecond: pps,
       duration: durationRef.current,
     });
     const maxScrollLeft = Math.max(0, scroll.scrollWidth - scroll.clientWidth);
     scroll.scrollLeft = Math.max(0, Math.min(maxScrollLeft, nextScrollLeft));
-  }, [pps, scrollRef, durationRef]);
+  }, [pps, scrollRef, durationRef, contentOrigin]);
 
   const syncPlayheadPosition = useCallback(
     (time: number) => {
       if (!playheadRef.current || durationRef.current <= 0) return;
-      playheadRef.current.style.left = `${getTimelinePlayheadLeft(time, ppsRef.current)}px`;
+      playheadRef.current.style.left = `${getTimelinePlayheadLeft(time, ppsRef.current, contentOrigin)}px`;
     },
-    [playheadRef, durationRef, ppsRef],
+    [playheadRef, durationRef, ppsRef, contentOrigin],
   );
 
   useEffect(() => {
@@ -121,7 +123,7 @@ export function useTimelinePlayhead({
       if (!playheadRef.current || durationRef.current <= 0) return;
       // Playback deliberately does NOT scroll the viewport to chase the playhead —
       // the user's scroll position is theirs; the playhead may run off-screen.
-      playheadRef.current.style.left = `${getTimelinePlayheadLeft(t, ppsRef.current)}px`;
+      playheadRef.current.style.left = `${getTimelinePlayheadLeft(t, ppsRef.current, contentOriginRef.current)}px`;
     });
     return unsub;
   });
@@ -135,13 +137,14 @@ export function useTimelinePlayhead({
         clientX,
         viewportLeft: rect.left,
         scrollLeft: el.scrollLeft,
+        contentOrigin,
         pixelsPerSecond: pps,
         duration: effectiveDuration,
       });
       liveTime.notify(time);
       onSeek?.(time);
     },
-    [scrollRef, effectiveDuration, pps, onSeek],
+    [scrollRef, effectiveDuration, pps, onSeek, contentOrigin],
   );
 
   const autoScrollDuringDrag = useCallback(
@@ -191,7 +194,7 @@ export function useTimelinePlayhead({
       const nextScrollLeft = getTimelineScrollLeftForZoomAnchor({
         pointerX: e.clientX - rect.left,
         currentScrollLeft: scroll.scrollLeft,
-        gutter: GUTTER + TRACKS_LEFT_PAD,
+        contentOrigin,
         currentPixelsPerSecond: ppsRef.current,
         nextPixelsPerSecond: nextPps,
         duration: durationRef.current,
@@ -214,6 +217,7 @@ export function useTimelinePlayhead({
       manualZoomPercentRef,
       setManualZoomPercent,
       setZoomMode,
+      contentOrigin,
     ],
   );
 
diff --git a/packages/studio/src/player/components/useTimelineRangeSelection.ts b/packages/studio/src/player/components/useTimelineRangeSelection.ts
index 6edc0ff443..1a98e251c6 100644
--- a/packages/studio/src/player/components/useTimelineRangeSelection.ts
+++ b/packages/studio/src/player/components/useTimelineRangeSelection.ts
@@ -7,7 +7,7 @@ import {
 } from "./timelineEditing";
 import type { TimelineElement } from "../store/playerStore";
 import { liveTime, usePlayerStore } from "../store/playerStore";
-import { GUTTER, TRACKS_LEFT_PAD, getTimelineScrubTime } from "./timelineLayout";
+import { getTimelineScrubTime } from "./timelineLayout";
 import {
   computeMarqueeSelection,
   getMarqueeRect,
@@ -30,7 +30,9 @@ interface UseTimelineRangeSelectionInput {
   setShowPopover: (v: boolean) => void;
   elementsRef: React.RefObject<TimelineElement[]>;
   trackOrderRef: React.RefObject<number[]>;
+  rowHeightsRef: React.RefObject<readonly number[]>;
   onSelectElement?: (element: TimelineElement | null) => void;
+  contentOrigin: number;
 }
 
 interface MarqueeDragState {
@@ -72,12 +74,16 @@ function commitMarqueeSelection(
   marquee: MarqueeDragState,
   elements: TimelineElement[],
   trackOrder: number[],
+  rowHeights: readonly number[],
   pps: number,
+  contentOrigin: number,
 ): void {
   const { ids, primaryId } = computeMarqueeSelection({
     clips: toMarqueeClips(elements),
     trackOrder,
+    rowHeights,
     pps,
+    contentOrigin,
     marquee: rect,
     baseSelection: additive ? marquee.baseIds : undefined,
   });
@@ -101,7 +107,9 @@ export function useTimelineRangeSelection({
   setShowPopover,
   elementsRef,
   trackOrderRef,
+  rowHeightsRef,
   onSelectElement,
+  contentOrigin,
 }: UseTimelineRangeSelectionInput) {
   const isRangeSelecting = useRef(false);
   const rangeAnchorTime = useRef(0);
@@ -168,10 +176,12 @@ export function useTimelineRangeSelection({
         marquee,
         elementsRef.current ?? [],
         trackOrderRef.current ?? [],
+        rowHeightsRef.current,
         ppsRef.current,
+        contentOrigin,
       );
     },
-    [toContentPoint, elementsRef, trackOrderRef, ppsRef],
+    [toContentPoint, elementsRef, trackOrderRef, rowHeightsRef, ppsRef, contentOrigin],
   );
 
   const stopMarqueeAutoScroll = useCallback(() => {
@@ -228,14 +238,13 @@ export function useTimelineRangeSelection({
       setShowPopover(false);
       const rect = scrollRef.current?.getBoundingClientRect();
       if (rect) {
-        const x =
-          e.clientX - rect.left + (scrollRef.current?.scrollLeft ?? 0) - GUTTER - TRACKS_LEFT_PAD;
+        const x = e.clientX - rect.left + (scrollRef.current?.scrollLeft ?? 0) - contentOrigin;
         const time = Math.max(0, x / pps);
         rangeAnchorTime.current = time;
         setRangeSelection({ start: time, end: time, anchorX: e.clientX, anchorY: e.clientY });
       }
     },
-    [scrollRef, pps, setShowPopover],
+    [scrollRef, pps, setShowPopover, contentOrigin],
   );
 
   const handlePointerDown = useCallback(
@@ -291,6 +300,7 @@ export function useTimelineRangeSelection({
             clientX,
             viewportLeft: rect.left,
             scrollLeft: el.scrollLeft,
+            contentOrigin,
             pixelsPerSecond: pps,
             duration: el.scrollWidth / pps,
           }),
@@ -306,7 +316,7 @@ export function useTimelineRangeSelection({
         });
       }
     },
-    [scrollRef, pps, seekFromX, autoScrollDuringDrag, isDragging],
+    [scrollRef, pps, seekFromX, autoScrollDuringDrag, isDragging, contentOrigin],
   );
 
   const handlePointerMove = useCallback(
@@ -314,8 +324,7 @@ export function useTimelineRangeSelection({
       if (isRangeSelecting.current) {
         const rect = scrollRef.current?.getBoundingClientRect();
         if (rect) {
-          const x =
-            e.clientX - rect.left + (scrollRef.current?.scrollLeft ?? 0) - GUTTER - TRACKS_LEFT_PAD;
+          const x = e.clientX - rect.left + (scrollRef.current?.scrollLeft ?? 0) - contentOrigin;
           setRangeSelection((prev) =>
             prev
               ? { ...prev, end: Math.max(0, x / pps), anchorX: e.clientX, anchorY: e.clientY }
@@ -335,7 +344,15 @@ export function useTimelineRangeSelection({
       if (!isDragging.current) return;
       updateScrubDrag(e.clientX);
     },
-    [pps, scrollRef, isDragging, applyMarqueeAtClient, syncMarqueeAutoScroll, updateScrubDrag],
+    [
+      pps,
+      scrollRef,
+      isDragging,
+      applyMarqueeAtClient,
+      syncMarqueeAutoScroll,
+      updateScrubDrag,
+      contentOrigin,
+    ],
   );
 
   // Release of a shift time-range gesture: keep a real range (or a shift-click
diff --git a/packages/studio/src/player/components/useTimelineTrackLayout.test.ts b/packages/studio/src/player/components/useTimelineTrackLayout.test.ts
new file mode 100644
index 0000000000..e2d1b6d293
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineTrackLayout.test.ts
@@ -0,0 +1,53 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import { afterEach, describe, expect, it } from "vitest";
+import { usePlayerStore, type TimelineElement } from "../store/playerStore";
+import { LANE_H, TRACK_H } from "./timelineLayout";
+import { useTimelineTrackLayout } from "./useTimelineTrackLayout";
+
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+
+afterEach(() => {
+  usePlayerStore.getState().reset();
+});
+
+describe("useTimelineTrackLayout", () => {
+  it("counts a flat tween lane and reserves its expanded row height", () => {
+    const elements: TimelineElement[] = [
+      { id: "clip-1", tag: "div", start: 0, duration: 1, track: 0 },
+    ];
+    const animations = new Map<string, GsapAnimation[]>([
+      [
+        "clip-1",
+        [
+          {
+            id: "position-tween",
+            targetSelector: "#clip-1",
+            method: "to",
+            position: 0,
+            duration: 1,
+            properties: { x: 420 },
+            propertyGroup: "position",
+          },
+        ],
+      ],
+    ]);
+    usePlayerStore.setState({ expandedClipIds: new Set(["clip-1"]) });
+
+    let layout: ReturnType<typeof useTimelineTrackLayout> | undefined;
+    function Probe() {
+      layout = useTimelineTrackLayout(elements, animations, null, new Set());
+      return null;
+    }
+
+    const root = createRoot(document.createElement("div"));
+    act(() => root.render(React.createElement(Probe)));
+
+    expect(layout?.laneCounts.get("clip-1")).toBe(1);
+    expect(layout?.rowHeights).toEqual([TRACK_H + LANE_H]);
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useTimelineTrackLayout.ts b/packages/studio/src/player/components/useTimelineTrackLayout.ts
new file mode 100644
index 0000000000..af28964d16
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineTrackLayout.ts
@@ -0,0 +1,161 @@
+import { useMemo, useRef } from "react";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import { animationContributesLane } from "./TimelinePropertyLanes";
+import { usePlayerStore, type TimelineElement } from "../store/playerStore";
+import { STUDIO_KEYFRAMES_ENABLED } from "../../components/editor/manualEditingAvailability";
+import type { DraggedClipState } from "./timelineClipDragTypes";
+import { useTimelineTrackDerivations } from "./useTimelineTrackDerivations";
+import {
+  TRACK_H,
+  getTimelineCanvasHeight,
+  getTimelineRowHeight,
+  trackHeights,
+  type TimelineTrackHeightClip,
+} from "./timelineLayout";
+
+export { getTrackStyle } from "./timelineIcons";
+
+/**
+ * The single keyframed element whose property lanes a track shows when expanded.
+ * A track can hold several elements (same z-index is common), but keyframes are
+ * per-element, so we scope to ONE active element — the selected one if it's on
+ * this track, otherwise the element with the most lanes. Selecting a clip is how
+ * you switch which element you're keyframing. Returns null when no element on the
+ * track has keyframes.
+ */
+export function resolveTrackKeyframeClip(
+  elements: readonly TimelineElement[],
+  laneCounts: ReadonlyMap<string, number>,
+  selectedElementId: string | null,
+  selectedElementIds: ReadonlySet<string>,
+): TimelineElement | null {
+  const keyframed = elements.filter(
+    (element) => (laneCounts.get(element.key ?? element.id) ?? 0) >= 1,
+  );
+  if (keyframed.length === 0) return null;
+  const selected = keyframed.find((element) => {
+    const key = element.key ?? element.id;
+    return key === selectedElementId || selectedElementIds.has(key);
+  });
+  if (selected) return selected;
+  return [...keyframed].sort(
+    (a, b) => (laneCounts.get(b.key ?? b.id) ?? 0) - (laneCounts.get(a.key ?? a.id) ?? 0),
+  )[0]!;
+}
+
+/** Lanes per clip: the count of distinct property groups whose tween contributes
+ *  a lane (real keyframes or a synthesizable flat tween). */
+function computeLaneCounts(
+  tracks: [number, TimelineElement[]][],
+  gsapAnimations: Map<string, GsapAnimation[]>,
+): Map<string, number> {
+  const laneCounts = new Map<string, number>();
+  for (const [, elements] of tracks) {
+    for (const element of elements) {
+      const clipId = element.key ?? element.id;
+      const propertyGroups = new Set<string>();
+      for (const animation of gsapAnimations.get(clipId) ?? []) {
+        if (animation.propertyGroup && animationContributesLane(animation)) {
+          propertyGroups.add(animation.propertyGroup);
+        }
+      }
+      laneCounts.set(clipId, propertyGroups.size);
+    }
+  }
+  return laneCounts;
+}
+
+function useTimelineRowHeights(
+  tracks: [number, TimelineElement[]][],
+  gsapAnimations: Map<string, GsapAnimation[]>,
+  selectedElementId: string | null,
+  selectedElementIds: ReadonlySet<string>,
+) {
+  const expandedClipIds = usePlayerStore((s) => s.expandedClipIds);
+  const { laneCounts, rowHeights } = useMemo(() => {
+    const laneCounts = computeLaneCounts(tracks, gsapAnimations);
+    // Row height follows only the active keyframe clip, so a track with several
+    // keyframed elements never reserves empty lanes for the ones not shown.
+    const heightTracks: TimelineTrackHeightClip[][] = tracks.map(([, elements]) => {
+      const active = resolveTrackKeyframeClip(
+        elements,
+        laneCounts,
+        selectedElementId,
+        selectedElementIds,
+      );
+      if (!active) return [];
+      const clipId = active.key ?? active.id;
+      return [{ clipId, laneCount: laneCounts.get(clipId) ?? 0 }];
+    });
+    return {
+      laneCounts,
+      rowHeights: trackHeights(
+        heightTracks,
+        STUDIO_KEYFRAMES_ENABLED ? expandedClipIds : undefined,
+      ),
+    };
+  }, [expandedClipIds, gsapAnimations, tracks, selectedElementId, selectedElementIds]);
+  const rowHeightsRef = useRef<readonly number[]>(rowHeights);
+  rowHeightsRef.current = rowHeights;
+  return { laneCounts, rowHeights, rowHeightsRef };
+}
+
+export function useTimelineTrackLayout(
+  expandedElements: TimelineElement[],
+  gsapAnimations: Map<string, GsapAnimation[]>,
+  selectedElementId: string | null,
+  selectedElementIds: ReadonlySet<string>,
+) {
+  const { tracks, trackStyles, trackOrder } = useTimelineTrackDerivations(expandedElements);
+  const trackOrderRef = useRef(trackOrder);
+  trackOrderRef.current = trackOrder;
+  const { laneCounts, rowHeights, rowHeightsRef } = useTimelineRowHeights(
+    tracks,
+    gsapAnimations,
+    selectedElementId,
+    selectedElementIds,
+  );
+
+  return {
+    tracks,
+    trackStyles,
+    trackOrder,
+    trackOrderRef,
+    laneCounts,
+    rowHeights,
+    rowHeightsRef,
+  };
+}
+
+function useDisplayRowHeights(
+  displayTrackOrder: readonly number[],
+  trackOrder: readonly number[],
+  rowHeights: readonly number[],
+) {
+  return useMemo(
+    () =>
+      displayTrackOrder.map((track) => {
+        const row = trackOrder.indexOf(track);
+        return row < 0 ? TRACK_H : getTimelineRowHeight(row, rowHeights);
+      }),
+    [displayTrackOrder, trackOrder, rowHeights],
+  );
+}
+
+function useDisplayTrackOrder(draggedClip: DraggedClipState | null, trackOrder: number[]) {
+  return useMemo(() => {
+    if (!draggedClip?.started || trackOrder.includes(draggedClip.previewTrack)) return trackOrder;
+    return [...trackOrder, draggedClip.previewTrack].sort((a, b) => a - b);
+  }, [draggedClip, trackOrder]);
+}
+
+export function useTimelineDisplayLayout(
+  draggedClip: DraggedClipState | null,
+  trackOrder: number[],
+  rowHeights: readonly number[],
+) {
+  const displayTrackOrder = useDisplayTrackOrder(draggedClip, trackOrder);
+  const displayRowHeights = useDisplayRowHeights(displayTrackOrder, trackOrder, rowHeights);
+  const totalH = getTimelineCanvasHeight(displayRowHeights);
+  return { displayTrackOrder, displayRowHeights, totalH };
+}

From a6aeffb2608c479c9ec7bfd67ae1f578cdcf50b6 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 17:59:31 +0200
Subject: [PATCH 091/125] fix(studio): address family B timeline review
 findings

- revert diamond selection when a rejected retime leaves the source in place
- clear project-local ease focus and expansion on player store reset
- share one static-position-hold predicate across the tween cache
- invalidate the GSAP cache even when a group timing rewrite throws
- stamp each lane keyframe's ease from its own source tween
- memoize property lanes and row offsets so memo'd diamond lanes hold
- use the editable tween duration for drag position commits
- restore the pre-t=0 pad in the all-collapsed content origin
- clamp the drag ghost and drop placeholder to the collapsed clip height
- aria-expanded on the layer disclosure, aria-pressed plus state-specific
  labels on the keyframe toggle, 24px chevron targets, focus-visible parity
---
 .../components/editor/KeyframeEaseList.tsx    |   6 +-
 .../src/hooks/gsapDragPositionCommit.ts       |  10 +-
 .../src/hooks/timelineEditingHelpers.test.ts  |  32 ++++++
 .../studio/src/hooks/useGsapTweenCache.ts     |   9 +-
 .../studio/src/hooks/useStudioContextValue.ts |   3 +
 .../src/hooks/useTimelineGroupEditing.ts      | 107 ++++++++++--------
 .../player/components/LayerDisclosureRow.tsx  |   8 +-
 .../src/player/components/Timeline.test.ts    |   8 +-
 .../studio/src/player/components/Timeline.tsx |   7 +-
 .../src/player/components/TimelineCanvas.tsx  |   9 +-
 .../components/TimelineClipDiamonds.tsx       |  17 ++-
 .../components/TimelinePropertyLanes.tsx      |  42 +++++--
 .../components/TimelineTrackHeader.test.tsx   |  39 ++++++-
 .../player/components/TimelineTrackHeader.tsx |  15 ++-
 .../src/player/components/timelineLayout.ts   |  12 ++
 .../components/trackHeaderLaneValues.ts       |  63 ++++++++---
 16 files changed, 284 insertions(+), 103 deletions(-)

diff --git a/packages/studio/src/components/editor/KeyframeEaseList.tsx b/packages/studio/src/components/editor/KeyframeEaseList.tsx
index 4574433d7b..9e53dd6118 100644
--- a/packages/studio/src/components/editor/KeyframeEaseList.tsx
+++ b/packages/studio/src/components/editor/KeyframeEaseList.tsx
@@ -93,7 +93,11 @@ export function KeyframeEaseList({
           ? "Custom"
           : (EASE_LABELS[segEase] ?? segEase);
         return (
-          <div key={`${i}-${kf.percentage}`} className="rounded-md bg-neutral-900/50">
+          <div
+            key={`${i}-${kf.percentage}`}
+            data-ease-segment-pct={kf.percentage}
+            className="rounded-md bg-neutral-900/50"
+          >
             <button
               type="button"
               onClick={() => onToggle(isExpanded ? null : kf.percentage)}
diff --git a/packages/studio/src/hooks/gsapDragPositionCommit.ts b/packages/studio/src/hooks/gsapDragPositionCommit.ts
index c5a8c026ba..9ccf93503f 100644
--- a/packages/studio/src/hooks/gsapDragPositionCommit.ts
+++ b/packages/studio/src/hooks/gsapDragPositionCommit.ts
@@ -2,9 +2,9 @@ import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import type { DomEditSelection } from "../components/editor/domEditingTypes";
 import { usePlayerStore } from "../player/store/playerStore";
 import { resolveTweenStart, resolveTweenDuration } from "../utils/globalTimeCompiler";
+import { resolveEditableTweenDuration } from "./gsapShared";
 import { roundTo3 } from "../utils/rounding";
 import { computeDraggedGsapPosition } from "./draggedGsapPosition";
-import { resolveEditableTweenDuration } from "./gsapShared";
 import {
   type GsapDragCommitCallbacks,
   computeCurrentPercentage,
@@ -159,7 +159,7 @@ async function commitFlatViaKeyframes(
 ): Promise<void> {
   const ct = usePlayerStore.getState().currentTime;
   const ts = resolveTweenStart(anim);
-  const td = resolveTweenDuration(anim);
+  const td = resolveEditableTweenDuration(anim, selection);
   const { activeKeyframePct, setActiveKeyframePct } = usePlayerStore.getState();
   const outsideRange =
     activeKeyframePct == null && ts !== null && td > 0 && (ct < ts - 0.01 || ct > ts + td + 0.01);
@@ -324,7 +324,7 @@ export async function commitGsapPositionFromDrag(
     const dragProps: Record<string, number> = { x: newX, y: newY };
 
     const ts = resolveTweenStart(effectiveAnim);
-    const td = resolveTweenDuration(effectiveAnim);
+    const td = resolveEditableTweenDuration(effectiveAnim, selection);
     const outsideRange = ts !== null && td > 0 && (ct < ts - 0.01 || ct > ts + td + 0.01);
     const hasSelectedKeyframe = usePlayerStore.getState().activeKeyframePct != null;
     if (outsideRange && !hasSelectedKeyframe) {
@@ -352,7 +352,7 @@ export async function commitGsapPositionFromDrag(
   } else if (anim.method === "from" || anim.method === "fromTo") {
     const ct = usePlayerStore.getState().currentTime;
     const ts = resolveTweenStart(anim);
-    const td = resolveTweenDuration(anim);
+    const td = resolveEditableTweenDuration(anim, selection);
     const hasSelectedKeyframe = usePlayerStore.getState().activeKeyframePct != null;
     const outsideRange =
       !hasSelectedKeyframe && ts !== null && td > 0 && (ct < ts - 0.01 || ct > ts + td + 0.01);
@@ -372,7 +372,7 @@ export async function commitGsapPositionFromDrag(
 
       if (existingPosAnim?.keyframes) {
         const posTs = resolveTweenStart(existingPosAnim);
-        const posTd = resolveTweenDuration(existingPosAnim);
+        const posTd = resolveEditableTweenDuration(existingPosAnim, selection);
         if (posTs !== null) {
           await extendTweenAndAddKeyframe(
             selection,
diff --git a/packages/studio/src/hooks/timelineEditingHelpers.test.ts b/packages/studio/src/hooks/timelineEditingHelpers.test.ts
index 03db5a2b9c..7d0e799172 100644
--- a/packages/studio/src/hooks/timelineEditingHelpers.test.ts
+++ b/packages/studio/src/hooks/timelineEditingHelpers.test.ts
@@ -390,4 +390,36 @@ describe("deleteSelectedKeyframes", () => {
       expect.objectContaining({ softReload: true }),
     );
   });
+
+  it("drops keyframes that belong to other elements", () => {
+    // A stale selection from a previously active element must not delete
+    // anything on the element that is active now.
+    usePlayerStore.setState({
+      selectedElementId: "card",
+      selectedKeyframes: new Set([
+        timelineKeyframeSelectionKey("card", {
+          percentage: 30,
+          tweenPercentage: 20,
+          propertyGroup: "position",
+          animationId: "card-position",
+        }),
+        timelineKeyframeSelectionKey("other", {
+          percentage: 70,
+          tweenPercentage: 80,
+          propertyGroup: "position",
+          animationId: "card-position",
+        }),
+      ]),
+    });
+    const handleGsapRemoveKeyframe =
+      vi.fn<(animId: string, pct: number, options?: Partial<CommitMutationOptions>) => void>();
+
+    deleteSelectedKeyframes({
+      selectedGsapAnimations: [{ id: "card-position", keyframes: {} }],
+      handleGsapRemoveKeyframe,
+    });
+
+    expect(handleGsapRemoveKeyframe).toHaveBeenCalledTimes(1);
+    expect(handleGsapRemoveKeyframe.mock.calls[0]?.[1]).toBe(20);
+  });
 });
diff --git a/packages/studio/src/hooks/useGsapTweenCache.ts b/packages/studio/src/hooks/useGsapTweenCache.ts
index 8ec8481738..893dea73ce 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.ts
@@ -330,9 +330,14 @@ export function useGsapAnimationsForElement(
   // fallow-ignore-next-line complexity
   useEffect(() => {
     if (!elementId) return;
-    // No property-group filter: ungrouped tweens are recorded here as well.
+    // Same admission rule as the keyframe cache below (hold skip included) and
+    // no property-group filter: the two stores must agree, or a hold draws an
+    // expanded property lane with no collapsed diamond behind it and an
+    // ungrouped tween draws diamonds with no lane source.
     const sourceAnimations = animations.filter(
-      (animation) => animation.keyframes || synthesizeFlatTweenKeyframes(animation),
+      (animation) =>
+        !isStaticPositionHold(animation) &&
+        (animation.keyframes || synthesizeFlatTweenKeyframes(animation)),
     );
     if (sourceAnimations.length > 0)
       writeGsapAnimationsForElement(sourceFile, elementId, sourceAnimations);
diff --git a/packages/studio/src/hooks/useStudioContextValue.ts b/packages/studio/src/hooks/useStudioContextValue.ts
index 21ba371f73..08c4c21ed2 100644
--- a/packages/studio/src/hooks/useStudioContextValue.ts
+++ b/packages/studio/src/hooks/useStudioContextValue.ts
@@ -96,6 +96,9 @@ export function useInspectorState(
       inspectorPanelActive,
       inspectorButtonActive:
         STUDIO_INSPECTOR_PANELS_ENABLED && !rightCollapsed && inspectorPanelActive,
+      // Deliberately wider than shouldShowSelectedDomBounds: the on-canvas path
+      // handles ARE the arc-drag affordance, so gating them on an open Inspector
+      // would make keyframe path editing reachable only from a side panel.
       shouldShowMotionPath: !!domEditSelection && !isPlaying && !isGestureRecording,
       // Keep the selection box drawn even when the Inspector is collapsed —
       // closing the panel shouldn't visually deselect the element.
diff --git a/packages/studio/src/hooks/useTimelineGroupEditing.ts b/packages/studio/src/hooks/useTimelineGroupEditing.ts
index 2b6ac46e70..03abbb6930 100644
--- a/packages/studio/src/hooks/useTimelineGroupEditing.ts
+++ b/packages/studio/src/hooks/useTimelineGroupEditing.ts
@@ -312,25 +312,32 @@ export function useTimelineGroupEditing({
         // reload (see the trackOnly doc above). Mixed batches (any start
         // change) keep the full fallback below.
         if (trackOnly) return;
-        await finishGroupTimingGsapFallback({
-          projectId,
-          iframe: previewIframeRef.current,
-          reloadPreview,
-          label: "Move timeline clips",
-          errorLabel: "Failed to shift GSAP positions",
-          coalesceKey,
-          recordEdit,
-          activeCompPath,
-          changes,
-          resolveChangePath: (element) => targetPathFor(element, activeCompPath),
-          mutateChange: (change, changePath) => {
-            const delta = change.start - change.element.start;
-            const domId = change.element.domId;
-            if (delta === 0 || !domId) return null;
-            return shiftGsapPositions(projectId, changePath, domId, delta);
-          },
-        });
-        invalidateGsapCache?.();
+        // The timing persist above already committed to disk, so the cached
+        // GSAP read is stale whether or not the position rewrite succeeded —
+        // invalidate on the error path too (matches the single-element path's
+        // `.finally`), or a failed rewrite leaves the editor reading old tweens.
+        try {
+          await finishGroupTimingGsapFallback({
+            projectId,
+            iframe: previewIframeRef.current,
+            reloadPreview,
+            label: "Move timeline clips",
+            errorLabel: "Failed to shift GSAP positions",
+            coalesceKey,
+            recordEdit,
+            activeCompPath,
+            changes,
+            resolveChangePath: (element) => targetPathFor(element, activeCompPath),
+            mutateChange: (change, changePath) => {
+              const delta = change.start - change.element.start;
+              const domId = change.element.domId;
+              if (delta === 0 || !domId) return null;
+              return shiftGsapPositions(projectId, changePath, domId, delta);
+            },
+          });
+        } finally {
+          invalidateGsapCache?.();
+        }
       }).catch((error) => {
         // Failed persist: revert the optimistic duration readout + live root
         // alongside the gesture owner's store rollback.
@@ -410,34 +417,40 @@ export function useTimelineGroupEditing({
             coalesceMs,
           );
         }
-        await finishGroupTimingGsapFallback({
-          projectId,
-          iframe: previewIframeRef.current,
-          reloadPreview,
-          label: "Resize timeline clips",
-          errorLabel: "Failed to scale GSAP positions",
-          coalesceKey,
-          recordEdit,
-          activeCompPath,
-          changes,
-          resolveChangePath: (element) => targetPathFor(element, activeCompPath),
-          mutateChange: (change, changePath) => {
-            const domId = change.element.domId;
-            const timingChanged =
-              change.start !== change.element.start || change.duration !== change.element.duration;
-            if (!timingChanged || !domId) return null;
-            return scaleGsapPositions(
-              projectId,
-              changePath,
-              domId,
-              change.element.start,
-              change.element.duration,
-              change.start,
-              change.duration,
-            );
-          },
-        });
-        invalidateGsapCache?.();
+        // See the move path: the timing persist is already on disk, so the GSAP
+        // cache must be invalidated even when the position rewrite throws.
+        try {
+          await finishGroupTimingGsapFallback({
+            projectId,
+            iframe: previewIframeRef.current,
+            reloadPreview,
+            label: "Resize timeline clips",
+            errorLabel: "Failed to scale GSAP positions",
+            coalesceKey,
+            recordEdit,
+            activeCompPath,
+            changes,
+            resolveChangePath: (element) => targetPathFor(element, activeCompPath),
+            mutateChange: (change, changePath) => {
+              const domId = change.element.domId;
+              const timingChanged =
+                change.start !== change.element.start ||
+                change.duration !== change.element.duration;
+              if (!timingChanged || !domId) return null;
+              return scaleGsapPositions(
+                projectId,
+                changePath,
+                domId,
+                change.element.start,
+                change.element.duration,
+                change.start,
+                change.duration,
+              );
+            },
+          });
+        } finally {
+          invalidateGsapCache?.();
+        }
       }).catch((error) => {
         // Failed persist: revert the optimistic duration readout + live root
         // alongside the gesture owner's store rollback.
diff --git a/packages/studio/src/player/components/LayerDisclosureRow.tsx b/packages/studio/src/player/components/LayerDisclosureRow.tsx
index 52e345b86a..e9087e11a6 100644
--- a/packages/studio/src/player/components/LayerDisclosureRow.tsx
+++ b/packages/studio/src/player/components/LayerDisclosureRow.tsx
@@ -31,6 +31,7 @@ export function LayerDisclosureRow({
     >
       <button
         type="button"
+        aria-expanded={isExpanded}
         aria-label={`${isExpanded ? "Collapse" : "Expand"} ${name} keyframes`}
         title={`${isExpanded ? "Collapse" : "Expand"} keyframe lanes`}
         className="flex h-5 w-4 shrink-0 items-center justify-center rounded border-0 bg-transparent p-0 text-white/55 hover:text-white focus-visible:outline focus-visible:outline-1 focus-visible:outline-[#3CE6AC]"
@@ -47,10 +48,9 @@ export function LayerDisclosureRow({
           style={{ transform: isExpanded ? "rotate(90deg)" : undefined }}
         />
       </button>
-      <span
-        aria-label="Layer keyframe indicator"
-        className="shrink-0 text-[13px] leading-none text-white/40"
-      >
+      {/* Decorative: the disclosure button above already names the row's keyframe
+          state, and aria-label on a plain span is not exposed reliably anyway. */}
+      <span aria-hidden="true" className="shrink-0 text-[13px] leading-none text-white/40">
         ◇
       </span>
       <span className="min-w-0 flex-1 truncate font-medium" title={name}>
diff --git a/packages/studio/src/player/components/Timeline.test.ts b/packages/studio/src/player/components/Timeline.test.ts
index ed0310814e..b1978443d4 100644
--- a/packages/studio/src/player/components/Timeline.test.ts
+++ b/packages/studio/src/player/components/Timeline.test.ts
@@ -108,7 +108,7 @@ function renderBasicTimeline() {
 }
 
 describe("Timeline provider boundary", () => {
-  it("keeps all-collapsed horizontal positions at the 32px gutter", () => {
+  it("keeps all-collapsed horizontal positions at the gutter plus the pre-t=0 pad", () => {
     usePlayerStore.setState({
       duration: 11,
       timelineReady: true,
@@ -121,13 +121,13 @@ describe("Timeline provider boundary", () => {
     const { root, clip, trackHeader, rulerTick, rulerOrigin, playhead } =
       renderTimelineGeometry("clip-1");
 
-    expect(trackHeader.style.width).toBe("32px");
+    expect(trackHeader.style.width).toBe(`${GUTTER + TRACKS_LEFT_PAD}px`);
     expect(clip.style.left).toBe("1000px");
     expect(clip.style.height).toBe("");
     expect(clip.style.bottom).toBe(`${CLIP_Y}px`);
-    expect(rulerOrigin.style.width).toBe("32px");
+    expect(rulerOrigin.style.width).toBe(`${GUTTER + TRACKS_LEFT_PAD}px`);
     expect(rulerTick.style.left).toBe("999.5px");
-    expect(playhead.style.left).toBe(`${1032 - PLAYHEAD_HEAD_W / 2}px`);
+    expect(playhead.style.left).toBe(`${GUTTER + TRACKS_LEFT_PAD + 1000 - PLAYHEAD_HEAD_W / 2}px`);
     expect(playhead.style.width).toBe(`${PLAYHEAD_HEAD_W}px`);
     expect(
       resolveTimelineAssetDrop(
diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 1e3f0719f9..cab6e28855 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -21,7 +21,7 @@ import { useTimelineEditPinning } from "./useTimelineEditPinning";
 import { useTimelineStackingSync } from "./useTimelineStackingSync";
 import { useTimelineGeometry } from "./useTimelineGeometry";
 import { useAutoExpandKeyframedClips } from "./useAutoExpandKeyframedClips";
-import { GUTTER, LABEL_COL_W, generateTicks } from "./timelineLayout";
+import { GUTTER, LABEL_COL_W, TRACKS_LEFT_PAD, generateTicks } from "./timelineLayout";
 import { useTimelineScrollViewport } from "./useTimelineScrollViewport";
 import { STUDIO_PREVIEW_FPS } from "../lib/time";
 import { useResolvedTimelineEditCallbacks } from "./useResolvedTimelineEditCallbacks";
@@ -128,7 +128,10 @@ export const Timeline = memo(function Timeline({
     [gsapAnimations],
   );
   const labelMode = STUDIO_KEYFRAMES_ENABLED && hasKeyframedClips;
-  const contentOrigin = labelMode ? LABEL_COL_W + GUTTER : GUTTER;
+  // Without the label column the pre-t=0 breathing room is still TRACKS_LEFT_PAD
+  // (dropping it would jam clip 0 against the gutter on every non-keyframed
+  // composition); in label mode the 232px label column already provides it.
+  const contentOrigin = labelMode ? LABEL_COL_W + GUTTER : GUTTER + TRACKS_LEFT_PAD;
   const contentGutter = labelMode ? GUTTER : 0;
   const setSelectedElementId = usePlayerStore((s) => s.setSelectedElementId);
   const currentTime = usePlayerStore((s) => s.currentTime);
diff --git a/packages/studio/src/player/components/TimelineCanvas.tsx b/packages/studio/src/player/components/TimelineCanvas.tsx
index 181ca290b8..bdf63bbc5c 100644
--- a/packages/studio/src/player/components/TimelineCanvas.tsx
+++ b/packages/studio/src/player/components/TimelineCanvas.tsx
@@ -47,6 +47,11 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
   const draggedRowIndex =
     draggedClip?.started === true ? displayTrackOrder.indexOf(draggedClip.previewTrack) : -1;
   const draggedRowHeight = getTimelineRowHeight(draggedRowIndex, props.rowHeights);
+  // A clip bar in an EXPANDED row still renders at TRACK_H (the property lanes
+  // occupy the rest of the row — see TimelineLanes' clipHeight), so the drag
+  // ghost and drop placeholder must clamp to it or they stretch to the full
+  // expanded row height and stop matching the clip being dragged.
+  const draggedClipHeight = Math.min(draggedRowHeight, TRACK_H) - CLIP_Y * 2;
   const {
     onResizeElement,
     onMoveElement,
@@ -177,7 +182,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
             top: getTimelineRowTop(draggedRowIndex, props.rowHeights) + CLIP_Y,
             left: props.contentOrigin + draggedClip.previewStart * props.pps,
             width: Math.max(draggedClip.element.duration * props.pps, 4),
-            height: draggedRowHeight - CLIP_Y * 2,
+            height: draggedClipHeight,
             border: "1px solid rgba(60,230,172,0.55)",
             background: "rgba(60,230,172,0.12)",
             borderRadius: 4,
@@ -230,7 +235,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
             top: activeDraggedPosition.top,
             left: activeDraggedPosition.left,
             width: Math.max(activeDraggedElement.duration * props.pps, 4),
-            height: draggedRowHeight - CLIP_Y * 2,
+            height: draggedClipHeight,
             zIndex: 40,
           }}
         >
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 146aeb1fbc..b3007f979b 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -375,12 +375,23 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
                 pendingRetimeRef.current.delete(kfKey);
               }
             };
+            // A rejected drop (the destination time is already occupied) snaps
+            // the diamond back to its source position, so the pending entry AND
+            // the selection have to revert with it — parking on the ghost drop
+            // position strands the playhead + selection on a keyframe that does
+            // not exist there.
+            const revertRetime = () => {
+              clearPending();
+              onClickKeyframe?.(fromTarget);
+            };
             void onMoveKeyframe?.(fromTarget, res.toClipPct).then((committed) => {
-              if (!committed) clearPending();
-            }, clearPending);
+              if (!committed) revertRetime();
+            }, revertRetime);
             // A retime still targeted this exact diamond — park/select it at its
             // new position, same as a plain click, or a drag that actually moved
-            // something looks identical to one that silently did nothing.
+            // something looks identical to one that silently did nothing. Done
+            // optimistically so the gesture stays responsive; revertRetime puts
+            // it back if the move is rejected.
             onClickKeyframe?.({
               ...target,
               percentage: res.toClipPct,
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
index bd518e7727..6d9f028159 100644
--- a/packages/studio/src/player/components/TimelinePropertyLanes.tsx
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
@@ -1,4 +1,4 @@
-import type { MouseEvent as ReactMouseEvent, RefObject } from "react";
+import { useMemo, type MouseEvent as ReactMouseEvent, type RefObject } from "react";
 import {
   classifyPropertyGroup,
   type GsapAnimation,
@@ -59,6 +59,14 @@ function sourceGroups(animations: readonly GsapAnimation[]) {
   return groups;
 }
 
+/** Resolve the ease from THIS keyframe's own source tween. A lane can merge
+ *  several tweens, so a shared lane-level fallback would label a segment with a
+ *  different animation's ease than the one the ease editor targets (it routes
+ *  by animationId). */
+function keyframeEase(keyframe: { ease?: string }, animation: GsapAnimation): string | undefined {
+  return keyframe.ease ?? animation.keyframes?.easeEach ?? animation.ease;
+}
+
 function groupKeyframes(
   animations: readonly GsapAnimation[],
   group: PropertyGroupName,
@@ -79,6 +87,7 @@ function groupKeyframes(
         tweenPercentage: keyframe.percentage,
         propertyGroup: group,
         animationId: animation.id,
+        ease: keyframeEase(keyframe, animation),
       });
     }
   }
@@ -116,15 +125,33 @@ export function TimelinePropertyLanes({
   onMoveKeyframe,
   suppressClickRef,
 }: TimelinePropertyLanesProps) {
-  if (clipWidthPx < 20 || clipDuration <= 0) return null;
-  const lanes = getTimelinePropertyLanes(animations, clipStart, clipDuration);
+  // Memoized: TimelineDiamondLane is React.memo'd, and rebuilding the lanes (and
+  // a fresh keyframesData literal per lane) on every render would re-render every
+  // diamond in every expanded clip on each playhead tick.
+  const lanes = useMemo(
+    () =>
+      clipWidthPx < 20 || clipDuration <= 0
+        ? []
+        : getTimelinePropertyLanes(animations, clipStart, clipDuration),
+    [animations, clipStart, clipDuration, clipWidthPx],
+  );
+  const laneData = useMemo(
+    () =>
+      lanes.map((lane) => ({
+        ...lane,
+        keyframesData: { format: "percentage" as const, keyframes: lane.keyframes },
+      })),
+    [lanes],
+  );
 
-  if (lanes.length === 0) return null;
+  if (laneData.length === 0) return null;
   return (
     <>
-      {lanes.map(({ group, animations: groupAnimations, keyframes }, laneIndex) => (
+      {laneData.map(({ group, keyframesData }, laneIndex) => (
         <div
           key={group}
+          role="group"
+          aria-label={`${group} keyframes`}
           data-property-group={group}
           data-timeline-property-lane=""
           data-timeline-lane-top={getTimelineLaneTop(laneIndex)}
@@ -137,10 +164,7 @@ export function TimelinePropertyLanes({
           }}
         >
           <TimelineDiamondLane
-            keyframesData={{ format: "percentage", keyframes }}
-            globalEase={
-              groupAnimations[0]?.keyframes?.easeEach ?? groupAnimations[0]?.ease ?? "none"
-            }
+            keyframesData={keyframesData}
             clipWidthPx={clipWidthPx}
             clipHeightPx={LANE_H}
             accentColor={accentColor}
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
index 96feb17947..56a077cd06 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
@@ -32,6 +32,7 @@ function animation(
   keyframes: Array<{
     percentage: number;
     properties: Record<string, number | string>;
+    ease?: string;
   }>,
 ): GsapAnimation {
   return {
@@ -126,7 +127,7 @@ describe("TimelineTrackHeader", () => {
     const onTogglePropertyGroupKeyframe = vi.fn();
     const view = renderHeader({ currentTime: 0.5, onTogglePropertyGroupKeyframe });
 
-    click(view.host, "Toggle Opacity keyframe");
+    click(view.host, "Add Opacity keyframe");
     expect(onTogglePropertyGroupKeyframe).toHaveBeenLastCalledWith(
       ELEMENT,
       expect.objectContaining({
@@ -139,7 +140,7 @@ describe("TimelineTrackHeader", () => {
     );
 
     view.rerender({ currentTime: 1, onTogglePropertyGroupKeyframe });
-    click(view.host, "Toggle Opacity keyframe");
+    click(view.host, "Remove Opacity keyframe");
     expect(onTogglePropertyGroupKeyframe).toHaveBeenLastCalledWith(
       ELEMENT,
       expect.objectContaining({
@@ -214,13 +215,13 @@ describe("TimelineTrackHeader", () => {
   it("fills the toggle diamond exactly at that group's keyframe", () => {
     const view = renderHeader({ currentTime: 0.5 });
     const positionToggle = view.host.querySelector<HTMLButtonElement>(
-      'button[aria-label="Toggle Position keyframe"]',
+      'button[aria-label="Add Position keyframe"]',
     );
     expect(positionToggle?.textContent).toBe("◇");
 
     view.rerender({ currentTime: 1 });
     expect(
-      view.host.querySelector<HTMLButtonElement>('button[aria-label="Toggle Position keyframe"]')
+      view.host.querySelector<HTMLButtonElement>('button[aria-label="Remove Position keyframe"]')
         ?.textContent,
     ).toBe("◆");
     act(() => view.root.unmount());
@@ -241,6 +242,36 @@ describe("TimelineTrackHeader", () => {
     act(() => view.root.unmount());
   });
 
+  it("samples mid-segment values along the segment's ease, not linearly", () => {
+    // GSAP hangs a segment's ease on the keyframe it arrives at, so 0% -> 50%
+    // runs power2.in. Half way through that segment power2.in(0.5) = 0.125, so
+    // the readout is 12.5/6.25 and NOT the linear 50/25.
+    const eased = animation("eased-position", "position", [
+      { percentage: 0, properties: { x: 0, y: 0 } },
+      { percentage: 50, properties: { x: 100, y: 50 }, ease: "power2.in" },
+      { percentage: 100, properties: { x: 200, y: 100 }, ease: "power2.in" },
+    ]);
+    const onTogglePropertyGroupKeyframe = vi.fn();
+    const view = renderHeader({
+      animations: [eased],
+      currentTime: 0.5,
+      onTogglePropertyGroupKeyframe,
+    });
+
+    expect(view.host.querySelector('[data-property-group="position"]')?.textContent).toContain(
+      "12.5, 6.25",
+    );
+
+    // The same sampled value is what an added keyframe gets stamped with, so a
+    // header insert lands on the existing curve instead of deforming it.
+    click(view.host, "Add Position keyframe");
+    expect(onTogglePropertyGroupKeyframe).toHaveBeenCalledOnce();
+    expect(onTogglePropertyGroupKeyframe.mock.calls[0][1]).toMatchObject({
+      properties: { x: 12.5, y: 6.25 },
+    });
+    act(() => view.root.unmount());
+  });
+
   it("disables the previous chevron at or before the group's first keyframe", () => {
     const view = renderHeader({ currentTime: 0 });
     const prevAt0 = view.host.querySelector<HTMLButtonElement>(
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index 7364fb7c61..b808d8d219 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -129,6 +129,14 @@ function PropertyGroupNavigation({
   onSeek?: (time: number) => void;
   children: React.ReactNode;
 }) {
+  // The 12x20px glyph is all the lane row has room for, so the WCAG 24x24
+  // target is met with a centered transparent ::before overlay instead of a
+  // bigger box; focus-visible matches every other control in this header.
+  const CHEVRON_BUTTON_CLASS =
+    "relative h-5 w-3 border-0 bg-transparent p-0 text-white/55 hover:text-white disabled:text-white/15 " +
+    "focus-visible:outline focus-visible:outline-1 focus-visible:outline-[#3CE6AC] " +
+    "before:absolute before:left-1/2 before:top-1/2 before:h-6 before:w-6 " +
+    "before:-translate-x-1/2 before:-translate-y-1/2 before:content-['']";
   const seekTo = (keyframe: { percentage: number } | null) => {
     if (keyframe) {
       onSeek?.(expandedElement.start + (keyframe.percentage / 100) * expandedElement.duration);
@@ -140,7 +148,7 @@ function PropertyGroupNavigation({
         type="button"
         aria-label={`Previous ${label} keyframe`}
         disabled={!navigation.prevKeyframe}
-        className="h-5 w-3 border-0 bg-transparent p-0 text-white/55 hover:text-white disabled:text-white/15"
+        className={CHEVRON_BUTTON_CLASS}
         onClick={(event) => {
           event.stopPropagation();
           seekTo(navigation.prevKeyframe);
@@ -153,7 +161,7 @@ function PropertyGroupNavigation({
         type="button"
         aria-label={`Next ${label} keyframe`}
         disabled={!navigation.nextKeyframe}
-        className="h-5 w-3 border-0 bg-transparent p-0 text-white/55 hover:text-white disabled:text-white/15"
+        className={CHEVRON_BUTTON_CLASS}
         onClick={(event) => {
           event.stopPropagation();
           seekTo(navigation.nextKeyframe);
@@ -242,7 +250,8 @@ function PropertyGroupHeaderRow({
       >
         <button
           type="button"
-          aria-label={`Toggle ${label} keyframe`}
+          aria-pressed={!!navigation.currentKeyframe}
+          aria-label={`${navigation.currentKeyframe ? "Remove" : "Add"} ${label} keyframe`}
           title={`${navigation.currentKeyframe ? "Remove" : "Add"} ${label} keyframe`}
           className="flex h-5 w-4 shrink-0 items-center justify-center border-0 bg-transparent p-0 text-[11px] text-[#3CE6AC] focus-visible:outline focus-visible:outline-1 focus-visible:outline-[#3CE6AC]"
           onClick={(event) => {
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index c2f4b02003..4b045f743c 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -77,12 +77,24 @@ function validRowHeight(height: number | undefined): number {
   return height;
 }
 
+/**
+ * Memoized by the rowHeights array identity: a marquee/drag pointer tick calls
+ * getTimelineRowTop once per clip, and each call would otherwise rebuild the
+ * whole cumulative array (O(clips x rows) allocations per tick). rowHeights is
+ * itself memoized upstream (useTimelineTrackLayout), so the identity is stable
+ * for the life of a gesture. Callers must treat the result as read-only.
+ */
+const rowOffsetsCache = new WeakMap<readonly number[], number[]>();
+
 /** Cumulative top offsets, including the final bottom boundary. */
 export function getTimelineRowOffsets(rowHeights: readonly number[]): number[] {
+  const cached = rowOffsetsCache.get(rowHeights);
+  if (cached) return cached;
   const offsets = [0];
   for (const height of rowHeights) {
     offsets.push((offsets[offsets.length - 1] ?? 0) + validRowHeight(height));
   }
+  rowOffsetsCache.set(rowHeights, offsets);
   return offsets;
 }
 
diff --git a/packages/studio/src/player/components/trackHeaderLaneValues.ts b/packages/studio/src/player/components/trackHeaderLaneValues.ts
index 180a29b63e..2ae0fe7626 100644
--- a/packages/studio/src/player/components/trackHeaderLaneValues.ts
+++ b/packages/studio/src/player/components/trackHeaderLaneValues.ts
@@ -4,6 +4,7 @@
  * reads to a human. Kept apart from the header's JSX so a formatting change and
  * a layout change never touch the same file.
  */
+import gsap from "gsap";
 import {
   classifyPropertyGroup,
   type GsapAnimation,
@@ -16,31 +17,59 @@ function roundValue(value: number): string {
   return String(Math.round(value * 100) / 100);
 }
 
-function propertyValueAt(
-  animation: GsapAnimation,
-  property: string,
-  tweenPercentage: number,
-): number | string | undefined {
-  const keyframes = animation.keyframes?.keyframes ?? [];
-  const values = keyframes
+/** GSAP applies a keyframe's `ease` to the segment ARRIVING at it, so the curve
+ *  between two keyframes is named by the later one (with the tween-level
+ *  `easeEach`/`ease` as the fallback). Sampling linearly would report a value the
+ *  element never has at that time, and stamp that wrong value onto a keyframe
+ *  added from the track header. Unknown ease names parse to undefined -> linear. */
+function easedProgress(progress: number, animation: GsapAnimation, ease?: string): number {
+  const resolved = ease ?? animation.keyframes?.easeEach ?? animation.ease;
+  if (!resolved || resolved === "none") return progress;
+  return gsap.parseEase(resolved)?.(progress) ?? progress;
+}
+
+interface PropertyStop {
+  percentage: number;
+  value: number | string;
+  ease?: string;
+}
+
+function propertyStops(animation: GsapAnimation, property: string): PropertyStop[] {
+  return (animation.keyframes?.keyframes ?? [])
     .filter((keyframe) => property in keyframe.properties)
     .map((keyframe) => ({
       percentage: keyframe.percentage,
       value: keyframe.properties[property],
+      ease: keyframe.ease,
     }));
-  const before = values.filter((value) => value.percentage <= tweenPercentage).at(-1);
-  const after = values.find((value) => value.percentage >= tweenPercentage);
+}
+
+/** A pair only interpolates when both ends are numeric and actually span time;
+ *  string values (colors, keywords) and zero-width pairs hold the earlier value.
+ *  Returns the numeric ends so the caller needs no cast to use them. */
+function interpolableEnds(
+  before: PropertyStop,
+  after: PropertyStop,
+): { from: number; to: number } | null {
+  if (typeof before.value !== "number" || typeof after.value !== "number") return null;
+  if (before.percentage === after.percentage) return null;
+  return { from: before.value, to: after.value };
+}
+
+function propertyValueAt(
+  animation: GsapAnimation,
+  property: string,
+  tweenPercentage: number,
+): number | string | undefined {
+  const stops = propertyStops(animation, property);
+  const before = stops.filter((stop) => stop.percentage <= tweenPercentage).at(-1);
+  const after = stops.find((stop) => stop.percentage >= tweenPercentage);
   if (!before) return after?.value;
   if (!after) return before.value;
-  if (
-    typeof before.value !== "number" ||
-    typeof after.value !== "number" ||
-    before.percentage === after.percentage
-  ) {
-    return before.value;
-  }
+  const ends = interpolableEnds(before, after);
+  if (!ends) return before.value;
   const progress = (tweenPercentage - before.percentage) / (after.percentage - before.percentage);
-  return before.value + (after.value - before.value) * progress;
+  return ends.from + (ends.to - ends.from) * easedProgress(progress, animation, after.ease);
 }
 
 /** Every property of `group` this animation touches, sampled at `tweenPercentage`. */

From b8b9fadf654e071eab83f194fc1193c3294ebb6e Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 20:46:53 +0200
Subject: [PATCH 092/125] fix(studio): populate keyframe lanes for every
 timeline composition

The keyframe cache was fetched for a single source file: the selected
element's, else the active composition. On open nothing is selected, so
a project whose clips live in sub-compositions loaded only index.html
and every property lane rendered empty until a clip was clicked.

Load the cache for each composition file the timeline has rows for, so
keyframed clips are expanded on open as intended. The AST load path
moves to keyframeCacheAstLoad.ts to keep useGsapTweenCache.ts under the
600-line cap.
---
 .../studio/src/hooks/keyframeCacheAstLoad.ts  | 175 ++++++++++++++++++
 .../studio/src/hooks/useGsapTweenCache.ts     | 170 ++++-------------
 .../usePopulateKeyframeCacheForFile.test.tsx  |  68 +++++++
 3 files changed, 278 insertions(+), 135 deletions(-)
 create mode 100644 packages/studio/src/hooks/keyframeCacheAstLoad.ts
 create mode 100644 packages/studio/src/hooks/usePopulateKeyframeCacheForFile.test.tsx

diff --git a/packages/studio/src/hooks/keyframeCacheAstLoad.ts b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
new file mode 100644
index 0000000000..254cb20b65
--- /dev/null
+++ b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
@@ -0,0 +1,175 @@
+/**
+ * Reading a composition file's GSAP tweens into the keyframe cache: fetch,
+ * selector -> element id resolution, and the clip-relative timing basis.
+ * Split from useGsapTweenCache to keep that file under the 600-line limit.
+ */
+import type { GsapAnimation, GsapKeyframesData, ParsedGsap } from "@hyperframes/core/gsap-parser";
+import { isStudioHoldSet } from "@hyperframes/core/gsap-parser";
+import { usePlayerStore } from "../player/store/playerStore";
+import {
+  clearKeyframeCacheForFile,
+  writeGsapAnimationsForElement,
+} from "./gsapKeyframeCacheHelpers";
+import { toAbsoluteTime } from "./gsapShared";
+import {
+  deduplicateKeyframes,
+  isStaticPositionHold,
+  synthesizeFlatTweenKeyframes,
+} from "./gsapTweenSynth";
+
+function extractIdFromSelector(selector: string): string | null {
+  const match = selector.match(/^#([\w-]+)/);
+  return match ? match[1] : null;
+}
+
+/**
+ * Resolve a tween's target selector to the ids of the element(s) it animates.
+ * A bare `#id` resolves directly; anything else (a class like `.dot`, a group
+ * `.a, .b`, or a descendant selector) is matched against the live preview DOM so
+ * class/selector tweens (e.g. `gsap.from(".dot", {stagger})`) attribute to every
+ * element they animate — not just one parsed from the string. Falls back to a
+ * leading `#id` when there's no DOM (so the cache still populates pre-iframe).
+ */
+// fallow-ignore-next-line complexity
+export function resolveSelectorElementIds(
+  selector: string,
+  doc: Document | null | undefined,
+): string[] {
+  const bareId = selector.match(/^#([\w-]+)$/);
+  if (bareId) return [bareId[1]];
+  if (!doc) {
+    const lead = extractIdFromSelector(selector);
+    return lead ? [lead] : [];
+  }
+  const ids = new Set<string>();
+  for (const part of selector.split(",")) {
+    const sel = part.trim();
+    if (!sel) continue;
+    try {
+      for (const el of Array.from(doc.querySelectorAll(sel))) {
+        if (el.id) ids.add(el.id);
+      }
+    } catch {
+      const lead = extractIdFromSelector(sel);
+      if (lead) ids.add(lead);
+    }
+  }
+  return Array.from(ids);
+}
+export async function fetchParsedAnimations(
+  projectId: string,
+  sourceFile: string,
+): Promise<ParsedGsap | null> {
+  try {
+    const res = await fetch(
+      `/api/projects/${encodeURIComponent(projectId)}/gsap-animations/${encodeURIComponent(sourceFile)}`,
+      // Always re-read the freshly-parsed source; no per-call timestamp (which
+      // would defeat caching forever and is a deterministic-render no-no).
+      { cache: "no-store" },
+    );
+    if (!res.ok) return null;
+    const parsed = (await res.json()) as ParsedGsap;
+    // Studio-emitted pre-keyframe hold `set`s are an internal runtime detail (they
+    // hold an element's first keyframe before its tween). They must not surface as
+    // user animations — otherwise they pollute the keyframe cache / timeline diamonds.
+    return { ...parsed, animations: parsed.animations.filter((a) => !isStudioHoldSet(a)) };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Clip-relative timing basis for an element. Sub-composition internals (e.g. pills
+ * inside a scene) aren't timeline clips themselves — they're derived at expand time
+ * — so they're absent from `elements`. Without a basis, elDuration defaulted to 1
+ * and clip-relative keyframe percentages blew past 100% (rendering off the clip).
+ * Fall back to the sub-comp HOST's bounds, resolved via domClipChildren (the host's
+ * data-composition-src is stripped in the rendered DOM, so we can't query it).
+ */
+export function resolveClipTimingBasis(
+  elementId: string,
+  sourceFile: string,
+  elements: ReadonlyArray<{
+    domId?: string;
+    key?: string;
+    id: string;
+    start: number;
+    duration: number;
+  }>,
+  domClipChildren: ReadonlyArray<{ id: string; hostId: string }>,
+): { elStart: number; elDuration: number } {
+  const direct = elements.find(
+    (el) => el.domId === elementId || (el.key ?? el.id) === `${sourceFile}#${elementId}`,
+  );
+  if (direct) return { elStart: direct.start, elDuration: direct.duration };
+  const hostId = domClipChildren.find((c) => c.id === elementId)?.hostId;
+  const host = hostId
+    ? elements.find((el) => el.domId === hostId || (el.key ?? el.id) === `index.html#${hostId}`)
+    : undefined;
+  return { elStart: host?.start ?? 0, elDuration: host?.duration ?? 1 };
+}
+
+/**
+ * Read one composition file's tweens into the keyframe cache. Split out of the
+ * hook so the effect can run it per file without re-nesting the whole body.
+ */
+// fallow-ignore-next-line complexity
+export async function populateKeyframeCacheFromAst(
+  projectId: string,
+  sf: string,
+  doc: Document | null | undefined,
+): Promise<void> {
+  const parsed = await fetchParsedAnimations(projectId, sf);
+  if (!parsed) return;
+  const { setKeyframeCache } = usePlayerStore.getState();
+  clearKeyframeCacheForFile(sf);
+  const { elements, domClipChildren } = usePlayerStore.getState();
+  const mergedByElement = new Map<string, GsapKeyframesData>();
+  const sourceByElement = new Map<string, GsapAnimation[]>();
+  for (const anim of parsed.animations) {
+    if (anim.hasUnresolvedKeyframes) continue;
+    if (isStaticPositionHold(anim)) continue;
+    const kfData = anim.keyframes ?? synthesizeFlatTweenKeyframes(anim);
+    if (!kfData) continue;
+    const tweenPos = anim.resolvedStart ?? (typeof anim.position === "number" ? anim.position : 0);
+    const tweenDur = anim.duration ?? 1;
+    // Attribute the tween to every element it animates (handles class /
+    // group / descendant selectors, not just `#id`).
+    for (const id of resolveSelectorElementIds(anim.targetSelector, doc)) {
+      // kfData is already resolved (real keyframes OR a synthesized flat
+      // tween), so a grouped flat tween joins the store like a keyframed one.
+      if (anim.propertyGroup) {
+        sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
+      }
+      const { elStart, elDuration } = resolveClipTimingBasis(id, sf, elements, domClipChildren);
+      const clipKeyframes = kfData.keyframes.map((kf) => {
+        const absTime = toAbsoluteTime(tweenPos, tweenDur, kf.percentage);
+        // 0.001% precision (see useGsapAnimationsForElement) so a beat-snapped
+        // keyframe centers on the beat dot and both caches agree.
+        const clipPct =
+          elDuration > 0
+            ? Math.round(((absTime - elStart) / elDuration) * 100000) / 1000
+            : kf.percentage;
+        return {
+          ...kf,
+          percentage: clipPct,
+          tweenPercentage: kf.percentage,
+          propertyGroup: anim.propertyGroup,
+          animationId: anim.id, // parity with other cache writers; inline ease needs it
+        };
+      });
+      const existing = mergedByElement.get(id);
+      if (existing) {
+        existing.keyframes = deduplicateKeyframes([...existing.keyframes, ...clipKeyframes]);
+      } else {
+        mergedByElement.set(id, { ...kfData, keyframes: clipKeyframes });
+      }
+    }
+  }
+  for (const [id, kfData] of mergedByElement) {
+    setKeyframeCache(`${sf}#${id}`, kfData);
+    setKeyframeCache(id, kfData);
+    if (sf !== "index.html") setKeyframeCache(`index.html#${id}`, kfData);
+    writeGsapAnimationsForElement(sf, id, sourceByElement.get(id));
+  }
+}
diff --git a/packages/studio/src/hooks/useGsapTweenCache.ts b/packages/studio/src/hooks/useGsapTweenCache.ts
index 893dea73ce..daa22260bf 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.ts
@@ -1,56 +1,29 @@
 import { useEffect, useMemo, useRef, useState, useCallback } from "react";
-import type { GsapAnimation, GsapKeyframesData, ParsedGsap } from "@hyperframes/core/gsap-parser";
-import { isStudioHoldSet } from "@hyperframes/core/gsap-parser";
+import type { GsapAnimation, GsapKeyframesData } from "@hyperframes/core/gsap-parser";
 import { usePlayerStore } from "../player/store/playerStore";
 import { readRuntimeKeyframes, scanAllRuntimeKeyframes } from "./gsapRuntimeBridge";
 import {
   clearKeyframeCacheForElement,
-  clearKeyframeCacheForFile,
   writeGsapAnimationsForElement,
 } from "./gsapKeyframeCacheHelpers";
-import { idFromSelector, toAbsoluteTime, toClipPercentage, toClipKeyframes } from "./gsapShared";
+import { toAbsoluteTime, toClipPercentage } from "./gsapShared";
 import {
   deduplicateKeyframes,
   isStaticPositionHold,
   synthesizeFlatTweenKeyframes,
 } from "./gsapTweenSynth";
-
-/**
- * Resolve a tween's target selector to the ids of the element(s) it animates.
- * A bare `#id` resolves directly; anything else (a class like `.dot`, a group
- * `.a, .b`, or a descendant selector) is matched against the live preview DOM so
- * class/selector tweens (e.g. `gsap.from(".dot", {stagger})`) attribute to every
- * element they animate — not just one parsed from the string. Falls back to the
- * leading id when there's no DOM (so the cache still populates pre-iframe);
- * `idFromSelector` reads both `#id` and the `[id="…"]` form writers emit for
- * CSS-unsafe ids, so those elements resolve pre-iframe too.
- */
-// fallow-ignore-next-line complexity
-export function resolveSelectorElementIds(
-  selector: string,
-  doc: Document | null | undefined,
-): string[] {
-  const bareId = selector.match(/^#([\w-]+)$/);
-  if (bareId) return [bareId[1]];
-  if (!doc) {
-    const lead = idFromSelector(selector);
-    return lead ? [lead] : [];
-  }
-  const ids = new Set<string>();
-  for (const part of selector.split(",")) {
-    const sel = part.trim();
-    if (!sel) continue;
-    try {
-      for (const el of Array.from(doc.querySelectorAll(sel))) {
-        if (el.id) ids.add(el.id);
-      }
-    } catch {
-      const lead = idFromSelector(sel);
-      if (lead) ids.add(lead);
-    }
-  }
-  return Array.from(ids);
-}
+import {
+  fetchParsedAnimations,
+  populateKeyframeCacheFromAst,
+  resolveClipTimingBasis,
+} from "./keyframeCacheAstLoad";
+
+// Re-exported so callers keep importing the GSAP cache surface from one module.
+export {
+  fetchParsedAnimations,
+  resolveClipTimingBasis,
+  resolveSelectorElementIds,
+} from "./keyframeCacheAstLoad";
 
 /** The selected element's identity for matching tweens to it. */
 export interface GsapElementTarget {
@@ -100,59 +73,6 @@ export function getAnimationsForElement(
   );
 }
 
-export async function fetchParsedAnimations(
-  projectId: string,
-  sourceFile: string,
-): Promise<ParsedGsap | null> {
-  try {
-    const res = await fetch(
-      `/api/projects/${encodeURIComponent(projectId)}/gsap-animations/${encodeURIComponent(sourceFile)}`,
-      // Always re-read the freshly-parsed source; no per-call timestamp (which
-      // would defeat caching forever and is a deterministic-render no-no).
-      { cache: "no-store" },
-    );
-    if (!res.ok) return null;
-    const parsed = (await res.json()) as ParsedGsap;
-    // Studio-emitted pre-keyframe hold `set`s are an internal runtime detail (they
-    // hold an element's first keyframe before its tween). They must not surface as
-    // user animations — otherwise they pollute the keyframe cache / timeline diamonds.
-    return { ...parsed, animations: parsed.animations.filter((a) => !isStudioHoldSet(a)) };
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Clip-relative timing basis for an element. Sub-composition internals (e.g. pills
- * inside a scene) aren't timeline clips themselves — they're derived at expand time
- * — so they're absent from `elements`. Without a basis, elDuration defaulted to 1
- * and clip-relative keyframe percentages blew past 100% (rendering off the clip).
- * Fall back to the sub-comp HOST's bounds, resolved via domClipChildren (the host's
- * data-composition-src is stripped in the rendered DOM, so we can't query it).
- */
-export function resolveClipTimingBasis(
-  elementId: string,
-  sourceFile: string,
-  elements: ReadonlyArray<{
-    domId?: string;
-    key?: string;
-    id: string;
-    start: number;
-    duration: number;
-  }>,
-  domClipChildren: ReadonlyArray<{ id: string; hostId: string }>,
-): { elStart: number; elDuration: number } {
-  const direct = elements.find(
-    (el) => el.domId === elementId || (el.key ?? el.id) === `${sourceFile}#${elementId}`,
-  );
-  if (direct) return { elStart: direct.start, elDuration: direct.duration };
-  const hostId = domClipChildren.find((c) => c.id === elementId)?.hostId;
-  const host = hostId
-    ? elements.find((el) => el.domId === hostId || (el.key ?? el.id) === `index.html#${hostId}`)
-    : undefined;
-  return { elStart: host?.start ?? 0, elDuration: host?.duration ?? 1 };
-}
-
 export function useGsapAnimationsForElement(
   projectId: string | null,
   sourceFile: string,
@@ -426,6 +346,7 @@ export function useGsapCacheVersion() {
  * elements. Called from the Timeline component so diamonds show without
  * requiring a selection.
  */
+
 export function usePopulateKeyframeCacheForFile(
   projectId: string | null,
   sourceFile: string,
@@ -433,6 +354,16 @@ export function usePopulateKeyframeCacheForFile(
   iframeRef?: React.RefObject<HTMLIFrameElement | null>,
 ): void {
   const elementCount = usePlayerStore((s) => s.elements.length);
+  // Every sub-composition file the timeline shows rows for. The cache is loaded
+  // for all of them up front, so keyframe lanes are populated on open instead of
+  // only once a clip from that file is selected (which is what switches
+  // `sourceFile`). Only files reachable from the store's elements are covered;
+  // a composition nested inside another still loads on first selection.
+  const compositionSrcKey = usePlayerStore((s) =>
+    Array.from(new Set(s.elements.map((el) => el.compositionSrc).filter((src) => !!src)))
+      .sort()
+      .join("|"),
+  );
   // Re-run when sub-comp DOM children appear (they supply the host bounds the
   // clip-relative keyframe percentages are computed against; without this the
   // cache is computed once before they exist and the percentages stay wrong).
@@ -445,52 +376,21 @@ export function usePopulateKeyframeCacheForFile(
   const astFetchDoneRef = useRef("");
 
   useEffect(() => {
-    const fetchKey = `kf-cache:${projectId}:${sourceFile}:${version}:${elementCount}:${domClipChildrenKey}`;
+    const fetchKey = `kf-cache:${projectId}:${sourceFile}:${version}:${elementCount}:${domClipChildrenKey}:${compositionSrcKey}`;
     if (fetchKey === lastFetchKeyRef.current) return;
     lastFetchKeyRef.current = fetchKey;
     runtimeScanDoneRef.current = "";
     astFetchDoneRef.current = "";
     if (!projectId) return;
 
-    const sf = sourceFile;
-    // fallow-ignore-next-line complexity
-    fetchParsedAnimations(projectId, sf).then((parsed) => {
-      if (!parsed) return;
-      const { setKeyframeCache } = usePlayerStore.getState();
-      clearKeyframeCacheForFile(sf);
-      const { elements, domClipChildren } = usePlayerStore.getState();
-      const doc = iframeRef?.current?.contentDocument;
-      const mergedByElement = new Map<string, GsapKeyframesData>();
-      const sourceByElement = new Map<string, GsapAnimation[]>();
-      for (const anim of parsed.animations) {
-        if (anim.hasUnresolvedKeyframes) continue;
-        if (isStaticPositionHold(anim)) continue;
-        const kfData = anim.keyframes ?? synthesizeFlatTweenKeyframes(anim);
-        if (!kfData) continue;
-        // Attribute the tween to every element it animates (handles class /
-        // group / descendant selectors, not just `#id`).
-        for (const id of resolveSelectorElementIds(anim.targetSelector, doc)) {
-          // kfData is already resolved (real keyframes OR a synthesized flat
-          // tween), so a flat tween joins the store like a keyframed one. No
-          // property-group filter: this map must cover every tween the cache
-          // below records, or expanded lanes have nothing to render.
-          sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
-          const { elStart, elDuration } = resolveClipTimingBasis(id, sf, elements, domClipChildren);
-          const clipKeyframes = toClipKeyframes(kfData.keyframes, anim, elStart, elDuration);
-          const existing = mergedByElement.get(id);
-          if (existing) {
-            existing.keyframes = deduplicateKeyframes([...existing.keyframes, ...clipKeyframes]);
-          } else {
-            mergedByElement.set(id, { ...kfData, keyframes: clipKeyframes });
-          }
-        }
-      }
-      for (const [id, kfData] of mergedByElement) {
-        setKeyframeCache(`${sf}#${id}`, kfData);
-        setKeyframeCache(id, kfData);
-        if (sf !== "index.html") setKeyframeCache(`index.html#${id}`, kfData);
-        writeGsapAnimationsForElement(sf, id, sourceByElement.get(id));
-      }
+    // The active file first: it owns the selection, and each file clears only
+    // its own cache entries, so the order just decides who writes the bare
+    // `id` alias last.
+    const files = Array.from(
+      new Set([sourceFile, ...(compositionSrcKey ? compositionSrcKey.split("|") : [])]),
+    );
+    const doc = iframeRef?.current?.contentDocument;
+    Promise.all(files.map((sf) => populateKeyframeCacheFromAst(projectId, sf, doc))).then(() => {
       astFetchDoneRef.current = fetchKey;
     });
     // elementCount is in the deps because new timeline elements (e.g. after a
@@ -499,7 +399,7 @@ export function usePopulateKeyframeCacheForFile(
     // iframeRef is read for DOM selector resolution but intentionally not a dep
     // (it's a stable ref; the separate runtime-scan effect owns iframe timing).
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [projectId, sourceFile, version, elementCount, domClipChildrenKey]);
+  }, [projectId, sourceFile, version, elementCount, domClipChildrenKey, compositionSrcKey]);
 
   // Separate effect for runtime keyframe discovery — polls until the iframe
   // has loaded GSAP timelines, independent of the AST fetch lifecycle.
diff --git a/packages/studio/src/hooks/usePopulateKeyframeCacheForFile.test.tsx b/packages/studio/src/hooks/usePopulateKeyframeCacheForFile.test.tsx
new file mode 100644
index 0000000000..6d2f609b4f
--- /dev/null
+++ b/packages/studio/src/hooks/usePopulateKeyframeCacheForFile.test.tsx
@@ -0,0 +1,68 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { usePopulateKeyframeCacheForFile } from "./useGsapTweenCache";
+import { usePlayerStore } from "../player/store/playerStore";
+
+Reflect.set(globalThis, "IS_REACT_ACT_ENVIRONMENT", true);
+
+function HookHost() {
+  usePopulateKeyframeCacheForFile("demo", "index.html", 1);
+  return null;
+}
+
+let root: Root | null = null;
+let container: HTMLElement | null = null;
+
+beforeEach(() => {
+  usePlayerStore.setState({
+    elements: [
+      {
+        id: "lab",
+        tag: "div",
+        start: 0,
+        duration: 12,
+        track: 1,
+        compositionSrc: "compositions/keyframe-lab.html",
+      },
+    ] as never,
+  });
+});
+
+afterEach(() => {
+  if (root) {
+    act(() => root?.unmount());
+    root = null;
+  }
+  container?.remove();
+  vi.unstubAllGlobals();
+});
+
+describe("usePopulateKeyframeCacheForFile", () => {
+  it("loads every sub-composition file the timeline shows, not just the active one", async () => {
+    // Keyframe lanes must be populated when the project opens. Fetching only the
+    // active file left them empty until a clip from the sub-composition was
+    // selected (which is the only thing that switched `sourceFile`).
+    const urls: string[] = [];
+    const fetchMock = vi.fn((input: RequestInfo | URL) => {
+      urls.push(String(input));
+      return Promise.resolve({ ok: true, json: () => Promise.resolve({ animations: [] }) });
+    });
+    vi.stubGlobal("fetch", fetchMock);
+
+    act(() => {
+      container = document.createElement("div");
+      document.body.appendChild(container);
+      root = createRoot(container);
+      root.render(<HookHost />);
+    });
+    await act(async () => {
+      await Promise.resolve();
+    });
+
+    expect(urls.some((u) => u.endsWith("/index.html"))).toBe(true);
+    expect(urls.some((u) => u.includes("keyframe-lab.html"))).toBe(true);
+  });
+});

From 6c7370b05809610baff85393e0d0f6d9a4bc468d Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 21:06:23 +0200
Subject: [PATCH 093/125] fix(studio): keep sub-compositions expanded at the
 end of the timeline

Auto-expansion picks the composition whose clip window contains the
playhead, and those windows are half-open. With the playhead parked on
the last clip's end - where playback stops - it sat inside nothing, so
every expanded sub-composition row and its keyframe lanes collapsed to a
single host row.

Accept the closing boundary, but only when the strict pass matched
nothing, so a playhead on the seam between two adjacent clips still
expands the one that is starting.
---
 .../hooks/useExpandedTimelineElements.test.ts | 43 +++++++++++++++++++
 .../hooks/useExpandedTimelineElements.ts      | 24 ++++++++---
 2 files changed, 62 insertions(+), 5 deletions(-)

diff --git a/packages/studio/src/player/hooks/useExpandedTimelineElements.test.ts b/packages/studio/src/player/hooks/useExpandedTimelineElements.test.ts
index d0f078f17b..12adcd2cd3 100644
--- a/packages/studio/src/player/hooks/useExpandedTimelineElements.test.ts
+++ b/packages/studio/src/player/hooks/useExpandedTimelineElements.test.ts
@@ -278,6 +278,49 @@ describe("resolveTimelineExpansionRawId", () => {
     ).toBe("scene");
   });
 
+  it("THE BUG: keeps a composition expanded with the playhead parked on its end", () => {
+    // Clip windows are half-open, so at the very end of the timeline the
+    // playhead was inside nothing and every expanded row collapsed.
+    const manifest = [
+      clip({ id: "scene", start: 0, duration: 12 }),
+      clip({ id: "headline", start: 0, duration: 12 }),
+    ];
+    const parentMap = new Map([["headline", "scene"]]);
+
+    expect(
+      resolveTimelineExpansionRawId({
+        selectedElementId: null,
+        isPlaying: false,
+        currentTime: 12,
+        manifest,
+        parentMap,
+      }),
+    ).toBe("scene");
+  });
+
+  it("prefers the starting clip over the ending one on a shared seam", () => {
+    const manifest = [
+      clip({ id: "first", start: 0, duration: 5 }),
+      clip({ id: "first-child", start: 0, duration: 5 }),
+      clip({ id: "second", start: 5, duration: 5 }),
+      clip({ id: "second-child", start: 5, duration: 5 }),
+    ];
+    const parentMap = new Map([
+      ["first-child", "first"],
+      ["second-child", "second"],
+    ]);
+
+    expect(
+      resolveTimelineExpansionRawId({
+        selectedElementId: null,
+        isPlaying: false,
+        currentTime: 5,
+        manifest,
+        parentMap,
+      }),
+    ).toBe("second");
+  });
+
   it("auto-expands the innermost active nested composition when paused", () => {
     const manifest = [
       clip({ id: "outer", start: 0, duration: 10 }),
diff --git a/packages/studio/src/player/hooks/useExpandedTimelineElements.ts b/packages/studio/src/player/hooks/useExpandedTimelineElements.ts
index d0ccaa2687..7ce6c5d661 100644
--- a/packages/studio/src/player/hooks/useExpandedTimelineElements.ts
+++ b/packages/studio/src/player/hooks/useExpandedTimelineElements.ts
@@ -45,6 +45,11 @@ function clipContainsTime(clip: ClipManifestClip, time: number): boolean {
   return Number.isFinite(time) && time >= clip.start && time < clip.start + clip.duration;
 }
 
+/** Half-open containment plus the closing boundary — see the fallback below. */
+function clipTouchesTime(clip: ClipManifestClip, time: number): boolean {
+  return Number.isFinite(time) && time >= clip.start && time <= clip.start + clip.duration;
+}
+
 function getActiveParentDepth(id: string, parentMap: Map<string, string>, activeIds: Set<string>) {
   let depth = 0;
   let parent = parentMap.get(id);
@@ -65,11 +70,20 @@ function findActiveExpandableCompositionId(
   parentMap: Map<string, string>,
 ): string | null {
   const parentIds = new Set(parentMap.values());
-  const activeIds = new Set<string>();
-  for (const clip of manifest) {
-    if (!clip.id || !parentIds.has(clip.id) || !clipContainsTime(clip, currentTime)) continue;
-    activeIds.add(clip.id);
-  }
+  const collect = (matches: (clip: ClipManifestClip, time: number) => boolean) => {
+    const ids = new Set<string>();
+    for (const clip of manifest) {
+      if (clip.id && parentIds.has(clip.id) && matches(clip, currentTime)) ids.add(clip.id);
+    }
+    return ids;
+  };
+  // Clip windows are half-open, so a playhead parked exactly on a clip's end is
+  // inside nothing — at the end of the timeline that collapsed every expanded
+  // sub-composition row and its keyframe lanes. Only when the strict pass finds
+  // nothing do we accept the closing boundary, so a playhead landing on the seam
+  // between two adjacent clips still expands the one that is starting.
+  const strict = collect(clipContainsTime);
+  const activeIds = strict.size > 0 ? strict : collect(clipTouchesTime);
   let bestId: string | null = null;
   let bestDepth = -1;
   for (const id of activeIds) {

From e464327516b62f4ced673075b6a7250e6189782d Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 25 Jul 2026 22:50:34 +0200
Subject: [PATCH 094/125] fix(studio): drop the property-group gate in the AST
 cache load

Carries the gsapAnimations/keyframeCache symmetry fix into the extracted
AST loader: an ungrouped tween now lands in both stores, so the collapsed
row and the expanded lanes agree on what a clip animates.
---
 packages/studio/src/hooks/keyframeCacheAstLoad.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/studio/src/hooks/keyframeCacheAstLoad.ts b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
index 254cb20b65..6eb90b5174 100644
--- a/packages/studio/src/hooks/keyframeCacheAstLoad.ts
+++ b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
@@ -137,10 +137,10 @@ export async function populateKeyframeCacheFromAst(
     // group / descendant selectors, not just `#id`).
     for (const id of resolveSelectorElementIds(anim.targetSelector, doc)) {
       // kfData is already resolved (real keyframes OR a synthesized flat
-      // tween), so a grouped flat tween joins the store like a keyframed one.
-      if (anim.propertyGroup) {
-        sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
-      }
+      // tween), so a flat tween joins the store like a keyframed one. No
+      // property-group filter: this map must cover every tween the cache
+      // below records, or expanded lanes have nothing to render.
+      sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
       const { elStart, elDuration } = resolveClipTimingBasis(id, sf, elements, domClipChildren);
       const clipKeyframes = kfData.keyframes.map((kf) => {
         const absTime = toAbsoluteTime(tweenPos, tweenDur, kf.percentage);

From 029e4a1fb908621dd9955db70fdecf01b8cfe7e3 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sun, 26 Jul 2026 01:47:04 +0200
Subject: [PATCH 095/125] refactor(studio): tighten the expanded-lane cache and
 height helpers

Validate the parse response before reading `.animations` instead of casting
the JSON blind, and narrow the fetch's return type to the slice callers read.
Route the AST cache load through the shared clip-keyframe and cache-key
helpers so it can't drift from the other writer. Drop the unused numeric
track-count branches from `trackHeights`/`getTimelineCanvasHeight`, and pick
the widest keyframed clip with a reduce so there's no index assertion.
---
 .../studio/src/hooks/keyframeCacheAstLoad.ts  | 56 +++++++++++--------
 .../hooks/useGsapAnimationFetchFallback.ts    |  2 +-
 .../src/player/components/Timeline.test.ts    |  6 +-
 .../player/components/timelineLayout.test.ts  | 19 +++----
 .../src/player/components/timelineLayout.ts   | 13 +----
 .../components/useTimelineTrackLayout.ts      |  7 ++-
 6 files changed, 53 insertions(+), 50 deletions(-)

diff --git a/packages/studio/src/hooks/keyframeCacheAstLoad.ts b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
index 6eb90b5174..19eaacdcff 100644
--- a/packages/studio/src/hooks/keyframeCacheAstLoad.ts
+++ b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
@@ -8,9 +8,10 @@ import { isStudioHoldSet } from "@hyperframes/core/gsap-parser";
 import { usePlayerStore } from "../player/store/playerStore";
 import {
   clearKeyframeCacheForFile,
+  elementCacheKeys,
   writeGsapAnimationsForElement,
 } from "./gsapKeyframeCacheHelpers";
-import { toAbsoluteTime } from "./gsapShared";
+import { toClipKeyframes } from "./gsapShared";
 import {
   deduplicateKeyframes,
   isStaticPositionHold,
@@ -56,10 +57,35 @@ export function resolveSelectorElementIds(
   }
   return Array.from(ids);
 }
+/**
+ * The slice of the parse response callers actually read. The endpoint returns
+ * the full `ParsedGsap` (preamble/postamble and all), but nothing downstream of
+ * this fetch touches the source-text fields, so the guard below only has to
+ * vouch for what gets used.
+ */
+type ParsedGsapAnimations = Pick<
+  ParsedGsap,
+  "animations" | "multipleTimelines" | "unsupportedTimelinePattern"
+>;
+
+/**
+ * A proxy, an error page, or a stale server can answer 200 with something that
+ * has no `animations` array — the case where the old blind cast crashed on
+ * `.animations.filter`.
+ */
+function hasAnimations(value: unknown): value is ParsedGsapAnimations {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    "animations" in value &&
+    Array.isArray(value.animations)
+  );
+}
+
 export async function fetchParsedAnimations(
   projectId: string,
   sourceFile: string,
-): Promise<ParsedGsap | null> {
+): Promise<ParsedGsapAnimations | null> {
   try {
     const res = await fetch(
       `/api/projects/${encodeURIComponent(projectId)}/gsap-animations/${encodeURIComponent(sourceFile)}`,
@@ -68,7 +94,8 @@ export async function fetchParsedAnimations(
       { cache: "no-store" },
     );
     if (!res.ok) return null;
-    const parsed = (await res.json()) as ParsedGsap;
+    const parsed: unknown = await res.json();
+    if (!hasAnimations(parsed)) return null;
     // Studio-emitted pre-keyframe hold `set`s are an internal runtime detail (they
     // hold an element's first keyframe before its tween). They must not surface as
     // user animations — otherwise they pollute the keyframe cache / timeline diamonds.
@@ -131,8 +158,6 @@ export async function populateKeyframeCacheFromAst(
     if (isStaticPositionHold(anim)) continue;
     const kfData = anim.keyframes ?? synthesizeFlatTweenKeyframes(anim);
     if (!kfData) continue;
-    const tweenPos = anim.resolvedStart ?? (typeof anim.position === "number" ? anim.position : 0);
-    const tweenDur = anim.duration ?? 1;
     // Attribute the tween to every element it animates (handles class /
     // group / descendant selectors, not just `#id`).
     for (const id of resolveSelectorElementIds(anim.targetSelector, doc)) {
@@ -142,22 +167,7 @@ export async function populateKeyframeCacheFromAst(
       // below records, or expanded lanes have nothing to render.
       sourceByElement.set(id, [...(sourceByElement.get(id) ?? []), anim]);
       const { elStart, elDuration } = resolveClipTimingBasis(id, sf, elements, domClipChildren);
-      const clipKeyframes = kfData.keyframes.map((kf) => {
-        const absTime = toAbsoluteTime(tweenPos, tweenDur, kf.percentage);
-        // 0.001% precision (see useGsapAnimationsForElement) so a beat-snapped
-        // keyframe centers on the beat dot and both caches agree.
-        const clipPct =
-          elDuration > 0
-            ? Math.round(((absTime - elStart) / elDuration) * 100000) / 1000
-            : kf.percentage;
-        return {
-          ...kf,
-          percentage: clipPct,
-          tweenPercentage: kf.percentage,
-          propertyGroup: anim.propertyGroup,
-          animationId: anim.id, // parity with other cache writers; inline ease needs it
-        };
-      });
+      const clipKeyframes = toClipKeyframes(kfData.keyframes, anim, elStart, elDuration);
       const existing = mergedByElement.get(id);
       if (existing) {
         existing.keyframes = deduplicateKeyframes([...existing.keyframes, ...clipKeyframes]);
@@ -167,9 +177,7 @@ export async function populateKeyframeCacheFromAst(
     }
   }
   for (const [id, kfData] of mergedByElement) {
-    setKeyframeCache(`${sf}#${id}`, kfData);
-    setKeyframeCache(id, kfData);
-    if (sf !== "index.html") setKeyframeCache(`index.html#${id}`, kfData);
+    for (const key of elementCacheKeys(sf, id)) setKeyframeCache(key, kfData);
     writeGsapAnimationsForElement(sf, id, sourceByElement.get(id));
   }
 }
diff --git a/packages/studio/src/hooks/useGsapAnimationFetchFallback.ts b/packages/studio/src/hooks/useGsapAnimationFetchFallback.ts
index e1fcded7d2..4e6f6ef9bc 100644
--- a/packages/studio/src/hooks/useGsapAnimationFetchFallback.ts
+++ b/packages/studio/src/hooks/useGsapAnimationFetchFallback.ts
@@ -36,7 +36,7 @@ export type ElementAnimationsOutcome =
  * so the caller can apply the right retry budget to each.
  */
 export function selectElementAnimationsOrRetry(
-  parsed: ParsedGsap | null,
+  parsed: Pick<ParsedGsap, "animations"> | null,
   target: { id: string | null; selector: string | null },
 ): ElementAnimationsOutcome {
   if (!parsed) return { kind: "fetch-error" };
diff --git a/packages/studio/src/player/components/Timeline.test.ts b/packages/studio/src/player/components/Timeline.test.ts
index b1978443d4..81b095961e 100644
--- a/packages/studio/src/player/components/Timeline.test.ts
+++ b/packages/studio/src/player/components/Timeline.test.ts
@@ -954,11 +954,13 @@ describe("getTimelinePlayheadLeft", () => {
 
 describe("getTimelineCanvasHeight", () => {
   it("includes bottom scroll buffer below the last track", () => {
-    expect(getTimelineCanvasHeight(3)).toBeGreaterThan(RULER_H + 3 * TRACK_H);
+    expect(getTimelineCanvasHeight([TRACK_H, TRACK_H, TRACK_H])).toBeGreaterThan(
+      RULER_H + 3 * TRACK_H,
+    );
   });
 
   it("still keeps ruler space when there are no tracks", () => {
-    expect(getTimelineCanvasHeight(0)).toBeGreaterThan(24);
+    expect(getTimelineCanvasHeight([])).toBeGreaterThan(24);
   });
 });
 
diff --git a/packages/studio/src/player/components/timelineLayout.test.ts b/packages/studio/src/player/components/timelineLayout.test.ts
index 250345fffd..63f0c97feb 100644
--- a/packages/studio/src/player/components/timelineLayout.test.ts
+++ b/packages/studio/src/player/components/timelineLayout.test.ts
@@ -16,6 +16,9 @@ import {
   resolveTimelineAssetDrop,
 } from "./timelineLayout";
 
+/** N collapsed rows, the shape every caller passes when nothing is expanded. */
+const baseRows = (count: number) => Array.from({ length: count }, () => TRACK_H);
+
 describe("variable timeline row geometry", () => {
   const tracks = [
     [{ clipId: "a", laneCount: 0 }],
@@ -25,7 +28,7 @@ describe("variable timeline row geometry", () => {
 
   it("resolves every row to the base height when no clip is expanded", () => {
     expect(trackHeights(tracks)).toEqual([TRACK_H, TRACK_H, TRACK_H]);
-    expect(trackHeights(3)).toEqual([TRACK_H, TRACK_H, TRACK_H]);
+    expect(trackHeights([[], [], []])).toEqual([TRACK_H, TRACK_H, TRACK_H]);
   });
 
   it("adds one lane height per lane on an expanded clip", () => {
@@ -84,7 +87,7 @@ describe("collapsed timeline row geometry characterization", () => {
     [3, 290],
     [5, 386],
   ])("keeps the %i-track canvas height at %i", (trackCount, expectedHeight) => {
-    expect(getTimelineCanvasHeight(trackCount)).toBe(expectedHeight);
+    expect(getTimelineCanvasHeight(baseRows(trackCount))).toBe(expectedHeight);
   });
 });
 
@@ -129,20 +132,16 @@ describe("track-area breathing pad y-math", () => {
 
   describe("getTimelineCanvasHeight", () => {
     it("reserves ruler + top pad + lanes + bottom pad", () => {
-      expect(getTimelineCanvasHeight(0)).toBe(RULER_H + TRACKS_TOP_PAD + TRACKS_BOTTOM_PAD);
-      expect(getTimelineCanvasHeight(3)).toBe(
+      expect(getTimelineCanvasHeight([])).toBe(RULER_H + TRACKS_TOP_PAD + TRACKS_BOTTOM_PAD);
+      expect(getTimelineCanvasHeight(baseRows(3))).toBe(
         RULER_H + TRACKS_TOP_PAD + 3 * TRACK_H + TRACKS_BOTTOM_PAD,
       );
     });
 
-    it("clamps a negative track count to zero lanes", () => {
-      expect(getTimelineCanvasHeight(-4)).toBe(RULER_H + TRACKS_TOP_PAD + TRACKS_BOTTOM_PAD);
-    });
-
     it("leaves room below the last lane for a drag-into-void new track", () => {
       // The gap below the final lane must be at least a full track height so a
       // clip can be dropped there to create a new bottom track.
-      const oneLane = getTimelineCanvasHeight(1);
+      const oneLane = getTimelineCanvasHeight(baseRows(1));
       const lastLaneBottom = getTimelineRowTop(0) + TRACK_H;
       expect(oneLane - lastLaneBottom).toBeGreaterThanOrEqual(TRACK_H);
     });
@@ -157,7 +156,7 @@ describe("track-area breathing pad y-math", () => {
       contentOrigin: GUTTER,
       pixelsPerSecond: 100,
       duration: 60,
-      rowHeights: trackHeights(3),
+      rowHeights: baseRows(3),
       trackOrder: [0, 1, 2],
     };
 
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 4b045f743c..4db33c01c3 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -55,12 +55,9 @@ type TimelineTrackHeightInput = readonly (readonly TimelineTrackHeightClip[])[];
  * the shared row height.
  */
 export function trackHeights(
-  tracks: number | TimelineTrackHeightInput,
+  tracks: TimelineTrackHeightInput,
   expandedClipIds?: ReadonlySet<string>,
 ): number[] {
-  if (typeof tracks === "number") {
-    return Array.from({ length: Math.max(0, Math.trunc(tracks)) }, () => TRACK_H);
-  }
   return tracks.map((clips) => {
     let laneCount = 0;
     if (expandedClipIds) {
@@ -473,15 +470,11 @@ export function getTimelineScrubTime(input: {
   return Math.max(0, Math.min(duration, x / pixelsPerSecond));
 }
 
-export function getTimelineCanvasHeight(trackCountOrHeights: number | readonly number[]): number {
+export function getTimelineCanvasHeight(rowHeights: readonly number[]): number {
   // RULER_H + top pad + lanes + bottom pad. The old TIMELINE_SCROLL_BUFFER is
   // subsumed by TRACKS_BOTTOM_PAD (which is larger), so the drag-into-void space
   // below the last lane is real scrollable surface, not a hidden buffer.
-  const heights =
-    typeof trackCountOrHeights === "number"
-      ? trackHeights(trackCountOrHeights)
-      : trackCountOrHeights;
-  const rowsHeight = getTimelineRowOffsets(heights).at(-1) ?? 0;
+  const rowsHeight = getTimelineRowOffsets(rowHeights).at(-1) ?? 0;
   return RULER_H + TRACKS_TOP_PAD + rowsHeight + TRACKS_BOTTOM_PAD;
 }
 
diff --git a/packages/studio/src/player/components/useTimelineTrackLayout.ts b/packages/studio/src/player/components/useTimelineTrackLayout.ts
index af28964d16..4aad5a8761 100644
--- a/packages/studio/src/player/components/useTimelineTrackLayout.ts
+++ b/packages/studio/src/player/components/useTimelineTrackLayout.ts
@@ -38,9 +38,10 @@ export function resolveTrackKeyframeClip(
     return key === selectedElementId || selectedElementIds.has(key);
   });
   if (selected) return selected;
-  return [...keyframed].sort(
-    (a, b) => (laneCounts.get(b.key ?? b.id) ?? 0) - (laneCounts.get(a.key ?? a.id) ?? 0),
-  )[0]!;
+  // Most lanes wins, first one on a tie (same as the old stable sort), but as a
+  // reduce over the already non-empty list so there's no index to assert on.
+  const lanesOf = (element: TimelineElement) => laneCounts.get(element.key ?? element.id) ?? 0;
+  return keyframed.reduce((best, element) => (lanesOf(element) > lanesOf(best) ? element : best));
 }
 
 /** Lanes per clip: the count of distinct property groups whose tween contributes

From 4af9f1afaa1d6c3b4a8ea95d02edbc170a719168 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 27 Jul 2026 15:34:14 +0200
Subject: [PATCH 096/125] fix(studio): close the timeline regressions the QA
 triage attributed here
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The QA fleet's 295 findings were replayed against the merge-base. Most were
pre-existing, but these were caused by this stack:

Deleting one keyframe destroyed the whole tween. The lane-header remove toggle
escalated a flat tween to a whole-animation delete, which took the authored
`tl.to(...)` and its source comment with it on a single click. The base build
posts remove-keyframe and lets the writer refuse it; restore that.

A keyframed layer could not be hidden at all. The visibility eye had moved off
the always-mounted layer row onto a hover-gated property-group row, so it only
existed while the lanes were expanded AND the pointer was over that lane. A
keyboard-only user could reach no eye at all, and its label named a track its
row did not act on. It goes back on the layer row.

A drag from the centre of a clip bar did nothing, because the 16px inline ease
button sits exactly there and swallowed the press. It now lets the press through
to the clip and keeps only the click, dropped if the pointer travelled.

Dragging a diamond onto a neighbour silently discarded the retime. The clamp
bounded the dragged keyframe by the whole merged row, so two animations
colliding at one percentage pinned each other in place and the drag resolved
back to a click. Clamp against the dragged keyframe's own tween instead.

Also: floor the diamond hit box at 12px (the gap-derived size fell to ~7px at
the zoom floor), round the diamond tooltip percentage, and prune the keyframe
caches when a composition switch drops a file from the scan set — each file only
ever cleared its own entries, so the previous composition leaked every element
into both keyframeCache and gsapAnimations, with nothing to evict it.
---
 .../nle/useTimelineEditCallbacks.test.tsx     |  38 +++--
 .../nle/useTimelineEditCallbacks.ts           |  37 ++---
 .../hooks/gsapKeyframeCacheHelpers.test.ts    |  43 ++++++
 .../src/hooks/gsapKeyframeCacheHelpers.ts     |  28 ++++
 .../studio/src/hooks/useGsapTweenCache.ts     |   4 +
 .../player/components/LayerDisclosureRow.tsx  |   4 +
 .../components/TimelineClipDiamonds.test.tsx  |   7 +-
 .../components/TimelineClipDiamonds.tsx       | 143 ++++++-----------
 .../components/TimelineDiamondConnectors.tsx  | 145 ++++++++++++++++++
 .../src/player/components/TimelineLanes.tsx   |   5 -
 .../components/TimelineTrackHeader.test.tsx   |  13 +-
 .../player/components/TimelineTrackHeader.tsx |  54 ++-----
 12 files changed, 333 insertions(+), 188 deletions(-)
 create mode 100644 packages/studio/src/player/components/TimelineDiamondConnectors.tsx

diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
index a2156b4560..a24ceff84f 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -205,7 +205,7 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
-  it("deletes a non-selected element flat boundary through the clicked element's selection", async () => {
+  it("refuses a non-selected element flat boundary instead of deleting the tween", async () => {
     const circle: TimelineElement = {
       ...element,
       id: "circle",
@@ -229,12 +229,15 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
       await Promise.resolve();
     });
 
-    // Persisted through the CLICKED element's own selection, not the current one.
-    expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(
+    // Persisted through the CLICKED element's own selection, not the current one,
+    // and as a remove-keyframe the writer can refuse — never a whole-tween delete.
+    expect(mocks.actions.handleGsapRemoveKeyframe).toHaveBeenCalledWith(
       otherFlatAnimation.id,
+      0,
+      undefined,
       mocks.selection,
     );
-    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    expect(mocks.actions.handleGsapDeleteAnimation).not.toHaveBeenCalled();
     view.unmount();
   });
 
@@ -311,7 +314,7 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
-  it("keeps selected-element flat boundary deletion on the animation delete path", () => {
+  it("keeps a selected-element flat boundary on the remove-keyframe path", () => {
     const view = renderCallbacks();
 
     act(() => {
@@ -323,12 +326,12 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
       });
     });
 
-    expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(flatAnimation.id);
-    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    expect(mocks.actions.handleGsapRemoveKeyframe).toHaveBeenCalledWith(flatAnimation.id, 0);
+    expect(mocks.actions.handleGsapDeleteAnimation).not.toHaveBeenCalled();
     view.unmount();
   });
 
-  it("routes the flat lane-header remove toggle through the guarded delete path", async () => {
+  it("routes the flat lane-header remove toggle through the refusable remove path", async () => {
     const view = renderCallbacks();
 
     await act(async () => {
@@ -341,19 +344,20 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
       });
     });
 
-    expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(
+    expect(mocks.actions.handleGsapRemoveKeyframe).toHaveBeenCalledWith(
       flatAnimation.id,
+      100,
+      undefined,
       mocks.selection,
     );
-    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    expect(mocks.actions.handleGsapDeleteAnimation).not.toHaveBeenCalled();
     view.unmount();
   });
 
   // The lane-header toggle fires on whichever element owns the lane, which need
-  // not be the selected one. Looking the flat tween up in the selected element's
-  // animations misses, and the miss silently takes the remove-one-keyframe
-  // branch, which strands the flat tween instead of deleting it.
-  it("removes a non-selected element's flat tween through that element's own animations", async () => {
+  // not be the selected one. It must still commit through that element's own
+  // selection, and it must never escalate a flat tween to a whole-tween delete.
+  it("removes a non-selected element's flat tween through that element's own selection", async () => {
     const circle: TimelineElement = {
       ...element,
       id: "circle",
@@ -376,11 +380,13 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
       });
     });
 
-    expect(mocks.actions.handleGsapDeleteAnimation).toHaveBeenCalledWith(
+    expect(mocks.actions.handleGsapRemoveKeyframe).toHaveBeenCalledWith(
       otherFlatAnimation.id,
+      0,
+      undefined,
       mocks.selection,
     );
-    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    expect(mocks.actions.handleGsapDeleteAnimation).not.toHaveBeenCalled();
     view.unmount();
   });
 
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index 01f64075ef..4283f035b6 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -116,7 +116,6 @@ export function useTimelineEditCallbacks({
     handleGsapAddKeyframeBatch,
     handleGsapConvertToKeyframes,
     handleGsapRemoveAllKeyframes,
-    handleGsapDeleteAnimation,
     buildDomSelectionForTimelineElement,
   } = useDomEditActionsContext();
 
@@ -167,22 +166,17 @@ export function useTimelineEditCallbacks({
   );
 
   const removeKeyframeTarget = useCallback(
-    (
-      animationId: string,
-      percentage: number,
-      animations: GsapAnimation[],
-      selectionOverride?: DomEditSelection | null,
-    ) => {
-      const animation = animations.find((candidate) => candidate.id === animationId);
-      if (animation && !animation.keyframes) {
-        if (selectionOverride === undefined) handleGsapDeleteAnimation(animationId);
-        else handleGsapDeleteAnimation(animationId, selectionOverride);
-        return;
-      }
+    (animationId: string, percentage: number, selectionOverride?: DomEditSelection | null) => {
+      // A flat tween's two diamonds are SYNTHESIZED endpoints, not authored
+      // keyframes, so "remove keyframe" has nothing to remove. Escalating to a
+      // whole-animation delete here destroyed the authored tween and its source
+      // comment on a single click, with no undo beyond the editor's own stack.
+      // Always post remove-keyframe: the writer refuses it for a flat tween
+      // (`changed:false`, file untouched), which is the correct no-op.
       if (selectionOverride === undefined) handleGsapRemoveKeyframe(animationId, percentage);
       else handleGsapRemoveKeyframe(animationId, percentage, undefined, selectionOverride);
     },
-    [handleGsapDeleteAnimation, handleGsapRemoveKeyframe],
+    [handleGsapRemoveKeyframe],
   );
 
   return useMemo(
@@ -213,15 +207,14 @@ export function useTimelineEditCallbacks({
         if (!target) return;
         const element = usePlayerStore.getState().elements.find((el) => (el.key ?? el.id) === elId);
         if (!element) {
-          removeKeyframeTarget(target.animId, target.tweenPct, animations);
+          removeKeyframeTarget(target.animId, target.tweenPct);
           return;
         }
         // Persist through the CLICKED element's own selection so a deletion on a
         // non-selected element (especially one in a different source file) commits
         // against the right element instead of the current domEditSelection.
         void buildDomSelectionForTimelineElement(element).then((selection) => {
-          if (selection)
-            removeKeyframeTarget(target.animId, target.tweenPct, animations, selection);
+          if (selection) removeKeyframeTarget(target.animId, target.tweenPct, selection);
         });
       },
       // Retime the keyframe to the playhead, preserving its value + ease.
@@ -328,15 +321,7 @@ export function useTimelineEditCallbacks({
         const selection = await buildDomSelectionForTimelineElement(element);
         if (!selection) return;
         if (target.remove) {
-          // The clicked element's animations, not the selected element's: this
-          // lookup decides delete-the-flat-tween vs remove-one-keyframe, and a
-          // miss silently takes the keyframe branch, stranding the flat tween.
-          removeKeyframeTarget(
-            target.animationId,
-            target.tweenPercentage,
-            resolveElementAnimations(element.key ?? element.id),
-            selection,
-          );
+          removeKeyframeTarget(target.animationId, target.tweenPercentage, selection);
           return;
         }
         await handleGsapAddKeyframeBatch(
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
index 9bc45eec22..05e5c93da8 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
@@ -4,6 +4,7 @@ import { usePlayerStore, type KeyframeCacheEntry } from "../player/store/playerS
 import {
   clearKeyframeCacheForElement,
   clearKeyframeCacheForFile,
+  pruneKeyframeCacheToFiles,
   updateKeyframeCacheFromParsed,
 } from "./gsapKeyframeCacheHelpers";
 
@@ -111,6 +112,48 @@ describe("clearKeyframeCacheForFile", () => {
   });
 });
 
+describe("pruneKeyframeCacheToFiles", () => {
+  // Switching composition leaves the previous comp's elements cached with no
+  // owner left to clear them: each file only ever clears its own entries.
+  it("drops every element of a file the next scan no longer covers", () => {
+    seed("index.html#stress-1");
+    seed("stress-1");
+    seed("index.html#stress-2");
+    seed("stress-2");
+    seed("kf200.html#kf200");
+    seed("index.html#kf200");
+    seed("kf200");
+
+    pruneKeyframeCacheToFiles(["kf200.html"]);
+
+    for (const key of ["index.html#stress-1", "stress-1", "index.html#stress-2", "stress-2"]) {
+      expect(cache().has(key)).toBe(false);
+    }
+    expect(cache().has("kf200.html#kf200")).toBe(true);
+  });
+
+  it("prunes gsapAnimations alongside keyframeCache", () => {
+    usePlayerStore.getState().setGsapAnimations("index.html#stress-1", [animWithKeyframes("t")]);
+    usePlayerStore.getState().setGsapAnimations("kf200.html#kf200", [animWithKeyframes("u")]);
+
+    pruneKeyframeCacheToFiles(["kf200.html"]);
+
+    const animations = usePlayerStore.getState().gsapAnimations;
+    expect(animations.has("index.html#stress-1")).toBe(false);
+    expect(animations.has("kf200.html#kf200")).toBe(true);
+  });
+
+  it("keeps everything when every cached file is still covered", () => {
+    seed("index.html#hero");
+    seed("comp.html#a");
+
+    pruneKeyframeCacheToFiles(["index.html", "comp.html"]);
+
+    expect(cache().has("index.html#hero")).toBe(true);
+    expect(cache().has("comp.html#a")).toBe(true);
+  });
+});
+
 describe("updateKeyframeCacheFromParsed", () => {
   it("serializes a multi-keyframe tween with a stable shape and animation identity", () => {
     const animation: GsapAnimation = {
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index efe0941df2..929960a16d 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -113,6 +113,34 @@ export function clearKeyframeCacheForFile(sourceFile: string): void {
   }
 }
 
+/**
+ * Drop every cached element owned by a file that is no longer on screen. Each
+ * file only ever clears its OWN entries (see clearKeyframeCacheForFile), so
+ * switching composition left the previous composition's elements cached forever
+ * — 240 entries per switch on a 120-clip comp, in both keyframeCache and
+ * gsapAnimations, with nothing to evict them. Called once before a re-scan, with
+ * the full set of files that scan covers.
+ */
+export function pruneKeyframeCacheToFiles(files: readonly string[]): void {
+  const keep = new Set(files);
+  const { keyframeCache, gsapAnimations } = usePlayerStore.getState();
+  const stale = new Map<string, Set<string>>();
+  for (const key of [...keyframeCache.keys(), ...gsapAnimations.keys()]) {
+    const hash = key.indexOf("#");
+    // Bare-id aliases carry no owner; clearKeyframeCacheForElement takes them
+    // with their prefixed key, so skipping them here loses nothing.
+    if (hash < 0) continue;
+    const sourceFile = key.slice(0, hash);
+    if (keep.has(sourceFile)) continue;
+    const ids = stale.get(sourceFile) ?? new Set<string>();
+    ids.add(key.slice(hash + 1));
+    stale.set(sourceFile, ids);
+  }
+  for (const [sourceFile, ids] of stale) {
+    for (const id of ids) clearKeyframeCacheForElement(sourceFile, id);
+  }
+}
+
 /** Every cache key a write for this element sets, in read-preference order. */
 export function elementCacheKeys(sourceFile: string, elementId: string): string[] {
   return sourceFile === "index.html"
diff --git a/packages/studio/src/hooks/useGsapTweenCache.ts b/packages/studio/src/hooks/useGsapTweenCache.ts
index daa22260bf..0f89be655c 100644
--- a/packages/studio/src/hooks/useGsapTweenCache.ts
+++ b/packages/studio/src/hooks/useGsapTweenCache.ts
@@ -4,6 +4,7 @@ import { usePlayerStore } from "../player/store/playerStore";
 import { readRuntimeKeyframes, scanAllRuntimeKeyframes } from "./gsapRuntimeBridge";
 import {
   clearKeyframeCacheForElement,
+  pruneKeyframeCacheToFiles,
   writeGsapAnimationsForElement,
 } from "./gsapKeyframeCacheHelpers";
 import { toAbsoluteTime, toClipPercentage } from "./gsapShared";
@@ -390,6 +391,9 @@ export function usePopulateKeyframeCacheForFile(
       new Set([sourceFile, ...(compositionSrcKey ? compositionSrcKey.split("|") : [])]),
     );
     const doc = iframeRef?.current?.contentDocument;
+    // Everything the previous scan cached for a file this one no longer covers
+    // (the composition just switched away from) has no owner left to clear it.
+    pruneKeyframeCacheToFiles(files);
     Promise.all(files.map((sf) => populateKeyframeCacheFromAst(projectId, sf, doc))).then(() => {
       astFetchDoneRef.current = fetchKey;
     });
diff --git a/packages/studio/src/player/components/LayerDisclosureRow.tsx b/packages/studio/src/player/components/LayerDisclosureRow.tsx
index e9087e11a6..596abd197d 100644
--- a/packages/studio/src/player/components/LayerDisclosureRow.tsx
+++ b/packages/studio/src/player/components/LayerDisclosureRow.tsx
@@ -11,12 +11,15 @@ export function LayerDisclosureRow({
   isExpanded,
   gutterBackground,
   onToggleClipExpanded,
+  children,
 }: {
   keyframeClip: TimelineElement;
   clipCount: number;
   isExpanded: boolean;
   gutterBackground: string;
   onToggleClipExpanded: () => void;
+  /** Trailing controls that act on the LAYER (the visibility eye), not on a lane. */
+  children?: React.ReactNode;
 }) {
   const name = keyframeClip.label ?? keyframeClip.domId ?? keyframeClip.id;
   return (
@@ -57,6 +60,7 @@ export function LayerDisclosureRow({
         {name}
       </span>
       <TrackClipCount clipCount={clipCount} />
+      {children}
     </div>
   );
 }
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
index 85804deb1a..11c83585b3 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
@@ -46,7 +46,10 @@ function renderDiamonds(onClickKeyframe = vi.fn()) {
 }
 
 describe("TimelineClipDiamonds", () => {
-  it("keeps dense keyframe hit regions and visuals from overlapping", () => {
+  // Dense rows narrow the DIAMOND so neighbours stay individually readable, but
+  // the hit box floors at KF_MIN_HIT_W — a gap-sized target gets unusable
+  // (~7px) at the zoom floor.
+  it("narrows dense keyframe visuals while flooring their hit regions", () => {
     const host = document.createElement("div");
     document.body.append(host);
     const root = createRoot(host);
@@ -76,7 +79,7 @@ describe("TimelineClipDiamonds", () => {
     const diamonds = Array.from(host.querySelectorAll<HTMLButtonElement>("button[title]"));
     expect(diamonds).toHaveLength(3);
     for (const diamond of diamonds) {
-      expect(Number.parseFloat(diamond.style.width)).toBeCloseTo(10.8);
+      expect(Number.parseFloat(diamond.style.width)).toBeCloseTo(12);
       expect(Number(diamond.querySelector("svg")?.getAttribute("width"))).toBeCloseTo(8.8);
     }
     act(() => root.unmount());
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index b3007f979b..8509db2812 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -1,11 +1,11 @@
-import { Fragment, memo, useEffect, useRef, useState } from "react";
+import { memo, useEffect, useRef, useState } from "react";
 import { BEAT_BAND_H } from "./BeatStrip";
 import {
   KEYFRAME_DRAG_THRESHOLD_PX,
   previewClipPct,
   resolveKeyframeDrag,
 } from "../../components/editor/keyframeDrag";
-import { MiniCurveSvg } from "../../components/editor/EaseCurveSection";
+import { TimelineDiamondConnectors } from "./TimelineDiamondConnectors";
 import { clipToTweenPercentage } from "../../components/editor/KeyframeNavigation";
 import { LANE_H } from "./timelineLayout";
 import { timelineKeyframeSelectionKey } from "./timelineKeyframeIdentity";
@@ -16,11 +16,24 @@ import {
   keyframeTarget,
   type DragState,
   type TimelineClipDiamondsProps,
+  type TimelineDiamondKeyframe,
   type TimelineDiamondLaneProps,
 } from "./timelineDiamondTypes";
 
 export type { TimelineDiamondKeyframe } from "./timelineDiamondTypes";
 
+// Floor for a diamond's clickable width. The visual size still narrows to the
+// neighbour gap so packed diamonds stay individually readable, but the hit box
+// stops there: at the zoom floor the gap alone left a ~7px target, which is
+// neither hittable nor selectable with any accuracy. Boxes may overlap slightly
+// below this width; each diamond still owns the half-gap around its own centre.
+const KF_MIN_HIT_W = 12;
+
+/** A clip-% is a float division, so a raw tooltip reads `25.032499999999995%`. */
+function roundPct(percentage: number): number {
+  return Math.round(percentage * 1000) / 1000;
+}
+
 export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   keyframesData,
   clipWidthPx,
@@ -115,9 +128,15 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   const sorted = keyframesData.keyframes
     .filter((kf) => kf.percentage >= KF_MIN_PCT && kf.percentage <= KF_MAX_PCT)
     .sort((a, b) => a.percentage - b.percentage);
-  // Clip-%s of the sorted keyframes — the neighbour clamp (preview + drop) needs
-  // the whole row to bound the dragged diamond between its immediate siblings.
-  const sortedClipPcts = sorted.map((k) => k.percentage);
+  // The neighbour clamp bounds a dragged diamond between its immediate siblings
+  // so a retime can't reorder the tween. Siblings means "keyframes of the SAME
+  // tween": a merged row interleaves several animations, and two of them
+  // colliding at one percentage would otherwise pin each other's diamonds in
+  // place — the drag clamped back onto its own position and resolved to a click.
+  const siblingRowOf = (keyframe: TimelineDiamondKeyframe) =>
+    keyframe.animationId === undefined
+      ? sorted
+      : sorted.filter((k) => k.animationId === keyframe.animationId);
   const centerXOf = (percentage: number) =>
     Math.max(0, Math.min(clipWidthPx, (percentage / 100) * clipWidthPx));
   // One record per diamond, carrying its own geometry, so the connector and
@@ -129,12 +148,12 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
     const previousGap = previous ? centerX - centerXOf(previous.percentage) : Infinity;
     const nextGap = next ? centerXOf(next.percentage) - centerX : Infinity;
     const nearestGap = Math.max(1, Math.min(previousGap, nextGap));
-    const hitWidth = Math.min(diamondSize, nearestGap);
+    const gapWidth = Math.min(diamondSize, nearestGap);
     return {
       keyframe,
       centerX,
-      hitWidth,
-      visualSize: hitWidth === diamondSize ? diamondSize : Math.max(2, hitWidth - 2),
+      hitWidth: Math.max(KF_MIN_HIT_W, gapWidth),
+      visualSize: gapWidth === diamondSize ? diamondSize : Math.max(2, gapWidth - 2),
     };
   });
   const baseColor = isSelected ? accentColor : "#a3a3a3";
@@ -155,95 +174,25 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         pointerEvents: "none",
       }}
     >
-      {markers.map((marker, i) => {
-        const previous = markers[i - 1];
-        if (!previous) return null;
-        const kf = marker.keyframe;
-        const x1 = previous.centerX;
-        const x2 = marker.centerX;
-        if (x2 - x1 < 1) return null;
-        const connectorLeft = x1 + previous.visualSize / 2;
-        const connectorWidth = x2 - x1 - previous.visualSize / 2 - marker.visualSize / 2;
-        // The ease button targets one segment, so it needs the keyframe's own
-        // animationId/tweenPercentage. On a merged inline row the button is
-        // hidden where the segment is ambiguous (two source animations collide
-        // at this % with different eases; see easeAmbiguous) or the keyframe has
-        // no source animation id (runtime-scanned) so there is no tween to target.
-        const target = keyframeTarget(kf);
-        const ease = kf.ease ?? globalEase;
-        return (
-          <Fragment key={`line-${i}-${previous.keyframe.percentage}-${kf.percentage}`}>
-            <div
-              className="absolute"
-              data-keyframe-connector={groupAware ? "" : undefined}
-              style={{
-                left: connectorLeft,
-                top: centerY,
-                width: Math.max(0, connectorWidth),
-                height: 2,
-                transform: "translateY(-1px)",
-                background: baseColor,
-                opacity: baseOpacity,
-                borderRadius: 1,
-              }}
-            />
-            {onSelectSegment && !kf.easeAmbiguous && kf.animationId !== undefined && (
-              <div
-                className="group absolute"
-                data-keyframe-ease-segment=""
-                style={{
-                  left: x1,
-                  top: centerY,
-                  width: x2 - x1,
-                  height: 18,
-                  transform: "translateY(-50%)",
-                  // Own a stacking context above the diamond buttons. At fit
-                  // zoom the 16px ease control can overlap its neighbouring
-                  // diamond; without a z-index here the later diamond wins the
-                  // hit test even though the child button has z-index 3.
-                  zIndex: 3,
-                  // Only the centered control is interactive. The transparent
-                  // segment wrapper must not swallow connector/clip gestures.
-                  pointerEvents: "none",
-                }}
-              >
-                <button
-                  type="button"
-                  data-keyframe-ease-button=""
-                  aria-label={`Edit ${ease} easing`}
-                  title={`Edit ${ease} easing`}
-                  className="absolute flex items-center justify-center rounded opacity-0 transition-opacity group-hover:opacity-100 focus-visible:opacity-100"
-                  style={{
-                    left: "50%",
-                    top: "50%",
-                    width: 16,
-                    height: 16,
-                    transform: "translate(-50%, -50%)",
-                    zIndex: 3,
-                    pointerEvents: "auto",
-                    padding: 0,
-                    border: "1px solid rgba(255, 255, 255, 0.14)",
-                    background: "#171717",
-                    cursor: "pointer",
-                  }}
-                  onPointerDown={(e) => e.stopPropagation()}
-                  onClick={(e) => {
-                    e.stopPropagation();
-                    onSelectSegment(target);
-                  }}
-                >
-                  <MiniCurveSvg ease={ease} active size={12} />
-                </button>
-              </div>
-            )}
-          </Fragment>
-        );
-      })}
+      <TimelineDiamondConnectors
+        markers={markers}
+        centerY={centerY}
+        baseColor={baseColor}
+        baseOpacity={baseOpacity}
+        groupAware={groupAware}
+        globalEase={globalEase}
+        keyframeTarget={keyframeTarget}
+        onSelectSegment={onSelectSegment}
+      />
 
       {markers.map((marker, i) => {
         const kf = marker.keyframe;
         const target = keyframeTarget(kf);
         const kfKey = timelineKeyframeSelectionKey(elementId, target);
+        // Clamp against this keyframe's own tween, not the whole merged row.
+        const siblingRow = siblingRowOf(kf);
+        const siblingClipPcts = siblingRow.map((k) => k.percentage);
+        const siblingIndex = siblingRow.indexOf(kf);
         // While dragging this diamond, render it at the live preview clip-%.
         const renderPct = preview?.kfKey === kfKey ? preview.clipPct : kf.percentage;
         // Center the marker's non-overlapping hit region ON its keyframe %, so
@@ -266,7 +215,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               kfKey,
               startX: e.clientX,
               lastX: e.clientX,
-              index: i,
+              index: siblingIndex,
               fromClipPct: pendingRetimeRef.current.get(kfKey)?.clipPct ?? kf.percentage,
               moved: false,
             };
@@ -292,7 +241,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
                 clipWidthPx,
                 draggedClipPct: live.fromClipPct,
                 draggedIndex: live.index,
-                sortedClipPcts,
+                sortedClipPcts: siblingClipPcts,
               }),
             });
           });
@@ -329,8 +278,8 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
             pointerUpX: e.clientX,
             clipWidthPx,
             draggedClipPct: d.fromClipPct,
-            draggedIndex: i,
-            sortedClipPcts,
+            draggedIndex: siblingIndex,
+            sortedClipPcts: siblingClipPcts,
           });
           if (res.kind === "click" || res.kind === "noop") {
             // "noop" is a press with enough pointer jitter to arm a drag (canDrag
@@ -445,7 +394,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               e.stopPropagation();
               onContextMenuKeyframe?.(e, target);
             }}
-            title={`${kf.percentage}%`}
+            title={`${roundPct(kf.percentage)}%`}
           >
             <svg
               width={marker.visualSize}
diff --git a/packages/studio/src/player/components/TimelineDiamondConnectors.tsx b/packages/studio/src/player/components/TimelineDiamondConnectors.tsx
new file mode 100644
index 0000000000..a0689213dd
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineDiamondConnectors.tsx
@@ -0,0 +1,145 @@
+import { Fragment, useRef } from "react";
+import { KEYFRAME_DRAG_THRESHOLD_PX } from "../../components/editor/keyframeDrag";
+import { MiniCurveSvg } from "../../components/editor/EaseCurveSection";
+import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
+import type { TimelineDiamondKeyframe } from "./TimelineClipDiamonds";
+
+/** One diamond's geometry within its row, as computed by the lane. */
+export interface TimelineDiamondMarker {
+  keyframe: TimelineDiamondKeyframe;
+  centerX: number;
+  hitWidth: number;
+  visualSize: number;
+}
+
+/**
+ * The line between each pair of adjacent diamonds, plus the ease control that
+ * sits at the segment's midpoint. Split out of TimelineClipDiamonds only to keep
+ * that file inside the repo's file-size cap; it has no state of its own beyond
+ * the press-position guard below.
+ */
+export function TimelineDiamondConnectors({
+  markers,
+  centerY,
+  baseColor,
+  baseOpacity,
+  groupAware,
+  globalEase,
+  keyframeTarget,
+  onSelectSegment,
+}: {
+  markers: readonly TimelineDiamondMarker[];
+  centerY: number;
+  baseColor: string;
+  baseOpacity: number;
+  groupAware: boolean;
+  globalEase: string;
+  keyframeTarget: (keyframe: TimelineDiamondKeyframe) => TimelineKeyframeTarget;
+  onSelectSegment?: (target: TimelineKeyframeTarget) => void;
+}) {
+  // The ease button sits dead centre of its segment, which on a two-keyframe clip
+  // is the centre of the clip bar — the natural place to grab a clip and drag it.
+  // Swallowing pointerdown there made that grab a no-op. Instead the press falls
+  // through to the clip (so the drag starts normally) and the button keeps only
+  // the click, which we drop if the pointer actually travelled.
+  const pressXRef = useRef<number | null>(null);
+
+  return (
+    <>
+      {markers.map((marker, i) => {
+        const previous = markers[i - 1];
+        if (!previous) return null;
+        const kf = marker.keyframe;
+        const x1 = previous.centerX;
+        const x2 = marker.centerX;
+        if (x2 - x1 < 1) return null;
+        const connectorLeft = x1 + previous.visualSize / 2;
+        const connectorWidth = x2 - x1 - previous.visualSize / 2 - marker.visualSize / 2;
+        // The ease button targets one segment, so it needs the keyframe's own
+        // animationId/tweenPercentage. On a merged inline row the button is
+        // hidden where the segment is ambiguous (two source animations collide
+        // at this % with different eases; see easeAmbiguous) or the keyframe has
+        // no source animation id (runtime-scanned) so there is no tween to target.
+        const target = keyframeTarget(kf);
+        const ease = kf.ease ?? globalEase;
+        return (
+          <Fragment key={`line-${i}-${previous.keyframe.percentage}-${kf.percentage}`}>
+            <div
+              className="absolute"
+              data-keyframe-connector={groupAware ? "" : undefined}
+              style={{
+                left: connectorLeft,
+                top: centerY,
+                width: Math.max(0, connectorWidth),
+                height: 2,
+                transform: "translateY(-1px)",
+                background: baseColor,
+                opacity: baseOpacity,
+                borderRadius: 1,
+              }}
+            />
+            {onSelectSegment && !kf.easeAmbiguous && kf.animationId !== undefined && (
+              <div
+                className="group absolute"
+                data-keyframe-ease-segment=""
+                style={{
+                  left: x1,
+                  top: centerY,
+                  width: x2 - x1,
+                  height: 18,
+                  transform: "translateY(-50%)",
+                  // Own a stacking context above the diamond buttons. At fit
+                  // zoom the 16px ease control can overlap its neighbouring
+                  // diamond; without a z-index here the later diamond wins the
+                  // hit test even though the child button has z-index 3.
+                  zIndex: 3,
+                  // Only the centered control is interactive. The transparent
+                  // segment wrapper must not swallow connector/clip gestures.
+                  pointerEvents: "none",
+                }}
+              >
+                <button
+                  type="button"
+                  data-keyframe-ease-button=""
+                  aria-label={`Edit ${ease} easing`}
+                  title={`Edit ${ease} easing`}
+                  className="absolute flex items-center justify-center rounded opacity-0 transition-opacity group-hover:opacity-100 focus-visible:opacity-100"
+                  style={{
+                    left: "50%",
+                    top: "50%",
+                    width: 16,
+                    height: 16,
+                    transform: "translate(-50%, -50%)",
+                    zIndex: 3,
+                    pointerEvents: "auto",
+                    padding: 0,
+                    border: "1px solid rgba(255, 255, 255, 0.14)",
+                    background: "#171717",
+                    cursor: "pointer",
+                  }}
+                  onPointerDown={(e) => {
+                    pressXRef.current = e.clientX;
+                  }}
+                  onClick={(e) => {
+                    e.stopPropagation();
+                    const pressX = pressXRef.current;
+                    pressXRef.current = null;
+                    if (
+                      pressX !== null &&
+                      Math.abs(e.clientX - pressX) >= KEYFRAME_DRAG_THRESHOLD_PX
+                    ) {
+                      return;
+                    }
+                    onSelectSegment(target);
+                  }}
+                >
+                  <MiniCurveSvg ease={ease} active size={12} />
+                </button>
+              </div>
+            )}
+          </Fragment>
+        );
+      })}
+    </>
+  );
+}
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index 3d9769afd5..d8b622f2ca 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -238,11 +238,6 @@ export function TimelineLanes({
                 currentTime={currentTime}
                 isTrackHidden={isTrackHidden}
                 isAudioTrack={isAudioTrack}
-                isActive={
-                  keyframeClipKey != null &&
-                  (selectedElementId === keyframeClipKey || selectedElementIds.has(keyframeClipKey))
-                }
-                isHovered={keyframeClipKey != null && hoveredClip === keyframeClipKey}
                 theme={theme}
                 onToggleClipExpanded={() => {
                   if (keyframeClipKey) {
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
index 56a077cd06..46d4372b53 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.test.tsx
@@ -90,8 +90,6 @@ function renderHeader(options: RenderHeaderOptions = {}): {
           currentTime={next.currentTime ?? 0}
           isTrackHidden={false}
           isAudioTrack={false}
-          isActive
-          isHovered={false}
           theme={defaultTimelineTheme}
           onToggleClipExpanded={vi.fn()}
           onToggleTrackHidden={vi.fn()}
@@ -123,6 +121,17 @@ describe("TimelineTrackHeader", () => {
     act(() => view.root.unmount());
   });
 
+  // The eye acts on the layer, so it has to be reachable without a pointer and
+  // in every disclosure state — a hover-gated eye is unusable by keyboard.
+  it("keeps the visibility eye mounted whether the layer is expanded or collapsed", () => {
+    const view = renderHeader({ expanded: true });
+    expect(view.host.querySelector('button[aria-label="Hide track 0"]')).not.toBeNull();
+
+    view.rerender({ expanded: false });
+    expect(view.host.querySelector('button[aria-label="Hide track 0"]')).not.toBeNull();
+    act(() => view.root.unmount());
+  });
+
   it("adds and removes a keyframe on the explicitly targeted property-group tween", () => {
     const onTogglePropertyGroupKeyframe = vi.fn();
     const view = renderHeader({ currentTime: 0.5, onTogglePropertyGroupKeyframe });
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index b808d8d219..2052039015 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -1,6 +1,5 @@
-import { useState } from "react";
 import { Eye, EyeSlash } from "@phosphor-icons/react";
-import type { GsapAnimation, PropertyGroupName } from "@hyperframes/core/gsap-parser";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { Music } from "../../icons/SystemIcons";
 import type { TimelineElement } from "../store/playerStore";
 import type { TimelineEditCallbacks } from "./timelineCallbacks";
@@ -30,8 +29,6 @@ interface TimelineTrackHeaderProps {
   currentTime: number;
   isTrackHidden: boolean;
   isAudioTrack: boolean;
-  isActive: boolean;
-  isHovered: boolean;
   theme: TimelineTheme;
   onToggleClipExpanded: () => void;
   onToggleTrackHidden: TimelineEditCallbacks["onToggleTrackHidden"];
@@ -180,14 +177,7 @@ function PropertyGroupHeaderRow({
   expandedElement,
   currentTime,
   clipPercentage,
-  hoveredGroup,
-  setHoveredGroup,
-  isActive,
-  isHovered,
-  isTrackHidden,
-  trackNumber,
   gutterBackground,
-  onToggleTrackHidden,
   onTogglePropertyGroupKeyframe,
   onSeek,
 }: {
@@ -197,14 +187,7 @@ function PropertyGroupHeaderRow({
   expandedElement: TimelineElement;
   currentTime: number;
   clipPercentage: number;
-  hoveredGroup: PropertyGroupName | null;
-  setHoveredGroup: (group: PropertyGroupName | null) => void;
-  isActive: boolean;
-  isHovered: boolean;
-  isTrackHidden: boolean;
-  trackNumber: number;
   gutterBackground: string;
-  onToggleTrackHidden: TimelineEditCallbacks["onToggleTrackHidden"];
   onTogglePropertyGroupKeyframe?: TimelineEditCallbacks["onTogglePropertyGroupKeyframe"];
   onSeek?: (time: number) => void;
 }) {
@@ -213,9 +196,6 @@ function PropertyGroupHeaderRow({
     currentTime,
     clipPercentage,
   );
-  const showEye =
-    hoveredGroup === lane.group ||
-    (hoveredGroup === null && laneIndex === 0 && (isActive || isHovered));
 
   return (
     <div
@@ -228,8 +208,6 @@ function PropertyGroupHeaderRow({
         height: LANE_H,
         background: gutterBackground,
       }}
-      onPointerEnter={() => setHoveredGroup(lane.group)}
-      onPointerLeave={() => setHoveredGroup(null)}
     >
       {/* Tree connector: vertical spine (top-half on the last lane) + branch tick. */}
       <span className="relative h-full w-3 shrink-0" aria-hidden="true">
@@ -272,12 +250,6 @@ function PropertyGroupHeaderRow({
       >
         {valueReadout(lane.group, values)}
       </span>
-      <VisibilityButton
-        hidden={isTrackHidden}
-        trackNumber={trackNumber}
-        visible={showEye}
-        onToggle={onToggleTrackHidden}
-      />
     </div>
   );
 }
@@ -293,15 +265,12 @@ export function TimelineTrackHeader({
   currentTime,
   isTrackHidden,
   isAudioTrack,
-  isActive,
-  isHovered,
   theme,
   onToggleClipExpanded,
   onToggleTrackHidden,
   onTogglePropertyGroupKeyframe,
   onSeek,
 }: TimelineTrackHeaderProps) {
-  const [hoveredGroup, setHoveredGroup] = useState<PropertyGroupName | null>(null);
   const clipPercentage = keyframeClip
     ? ((currentTime - keyframeClip.start) / keyframeClip.duration) * 100
     : 0;
@@ -346,7 +315,19 @@ export function TimelineTrackHeader({
             isExpanded={isExpanded}
             gutterBackground={theme.gutterBackground}
             onToggleClipExpanded={onToggleClipExpanded}
-          />
+          >
+            {/* The eye belongs to the LAYER, so it lives on the always-mounted
+                layer row exactly like a plain track's. Hanging it off a lane row
+                (hover-gated, and only while expanded) left a keyframed track with
+                no way to be hidden at all by keyboard, and put the control on a
+                row it does not act on. */}
+            <VisibilityButton
+              hidden={isTrackHidden}
+              trackNumber={trackNumber}
+              visible
+              onToggle={onToggleTrackHidden}
+            />
+          </LayerDisclosureRow>
           {isExpanded &&
             lanes.map((lane, laneIndex) => (
               <PropertyGroupHeaderRow
@@ -357,14 +338,7 @@ export function TimelineTrackHeader({
                 expandedElement={keyframeClip}
                 currentTime={currentTime}
                 clipPercentage={clipPercentage}
-                hoveredGroup={hoveredGroup}
-                setHoveredGroup={setHoveredGroup}
-                isActive={isActive}
-                isHovered={isHovered}
-                isTrackHidden={isTrackHidden}
-                trackNumber={trackNumber}
                 gutterBackground={theme.gutterBackground}
-                onToggleTrackHidden={onToggleTrackHidden}
                 onTogglePropertyGroupKeyframe={onTogglePropertyGroupKeyframe}
                 onSeek={onSeek}
               />

From 7ec73dfd809d01ebe46cb718a867aaba3fcc1f0c Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 27 Jul 2026 15:46:59 +0200
Subject: [PATCH 097/125] fix(studio): retime flat tween boundaries and target
 the clicked keyframe's own tween

Two more regressions the QA triage attributed to this stack.

Dragging a flat tween's boundary diamond did nothing: the handler bailed on
`!anim.keyframes` even though resolveKeyframeRetime already resolves that case
to a position/duration resize. The empty remap now dispatches update-meta, which
moves the window without rewriting the authored flat tween into keyframes form
(what the keyframed-resize writer would do as a side effect).

The property panel's keyframe gutter guessed one animation per property group,
so clicking a keyframe authored by a sibling tween on a merged row named the
wrong tween and the writer silently removed nothing. The diamond now reports the
clicked keyframe's own animationId, with the group guess kept as the fallback for
cache rows that carry no identity.
---
 .../components/editor/KeyframeNavigation.tsx  | 12 +++-
 .../editor/KeyframeNavigationDiamond.test.tsx | 59 +++++++++++++++++++
 .../src/components/editor/PropertyPanel.tsx   | 20 +++++--
 .../editor/propertyPanelFlatLayoutSection.tsx |  4 +-
 .../nle/useTimelineEditCallbacks.test.tsx     | 11 +++-
 .../nle/useTimelineEditCallbacks.ts           | 17 ++++--
 6 files changed, 108 insertions(+), 15 deletions(-)
 create mode 100644 packages/studio/src/components/editor/KeyframeNavigationDiamond.test.tsx

diff --git a/packages/studio/src/components/editor/KeyframeNavigation.tsx b/packages/studio/src/components/editor/KeyframeNavigation.tsx
index b8016f1a6b..219e08d92e 100644
--- a/packages/studio/src/components/editor/KeyframeNavigation.tsx
+++ b/packages/studio/src/components/editor/KeyframeNavigation.tsx
@@ -11,12 +11,15 @@ interface KeyframeNavigationProps {
     tweenPercentage?: number;
     properties: Record<string, number | string>;
     ease?: string;
+    /** The tween that authored this keyframe, when the cache knows it. */
+    animationId?: string;
   }> | null;
   /** Current playhead percentage within the element's lifetime (0-100) */
   currentPercentage: number;
   onSeek: (percentage: number) => void;
   onAddKeyframe: (percentage: number) => void;
-  onRemoveKeyframe: (percentage: number) => void;
+  /** `animationId` is the clicked keyframe's OWN tween; see handleDiamondClick. */
+  onRemoveKeyframe: (percentage: number, animationId?: string) => void;
   onConvertToKeyframes: () => void;
 }
 
@@ -152,7 +155,12 @@ export const KeyframeNavigation = memo(function KeyframeNavigation({
     if (diamondState === "ghost") {
       onConvertToKeyframes();
     } else if (diamondState === "active" && atCurrent) {
-      onRemoveKeyframe(atCurrent.tweenPercentage ?? atCurrent.percentage);
+      // Report the keyframe's OWN tween. A merged gutter row shows the keyframes
+      // of every tween in the property group, so the caller's "the group's
+      // animation" guess names the wrong tween whenever the clicked keyframe
+      // belongs to a sibling — and the writer then finds no keyframe at that
+      // percentage and silently does nothing.
+      onRemoveKeyframe(atCurrent.tweenPercentage ?? atCurrent.percentage, atCurrent.animationId);
     } else {
       onAddKeyframe(clipToTweenPercentage(propertyKeyframes, currentPercentage));
     }
diff --git a/packages/studio/src/components/editor/KeyframeNavigationDiamond.test.tsx b/packages/studio/src/components/editor/KeyframeNavigationDiamond.test.tsx
new file mode 100644
index 0000000000..3cf0ddcd17
--- /dev/null
+++ b/packages/studio/src/components/editor/KeyframeNavigationDiamond.test.tsx
@@ -0,0 +1,59 @@
+// @vitest-environment happy-dom
+
+import { act } from "react";
+import { beforeAll, describe, expect, it, vi } from "vitest";
+import { installReactActEnvironment, mountReactHarness } from "../../hooks/domSelectionTestHarness";
+import { KeyframeNavigation } from "./KeyframeNavigation";
+
+beforeAll(installReactActEnvironment);
+
+/**
+ * Regression: a merged gutter row shows the keyframes of EVERY tween in the
+ * property group. The panel guesses "the group's animation" for the write, so a
+ * click on a keyframe authored by a sibling tween named the wrong animation and
+ * the writer silently found nothing to remove. The diamond now reports the
+ * clicked keyframe's own animationId.
+ */
+const MERGED_ROW = [
+  { percentage: 0, tweenPercentage: 0, properties: { x: 0 }, animationId: "delta-to-500-position" },
+  {
+    percentage: 50,
+    tweenPercentage: 25,
+    properties: { x: 120 },
+    animationId: "delta-to-4000-position",
+  },
+];
+
+function clickDiamond(currentPercentage: number, onRemoveKeyframe: (...args: never[]) => void) {
+  const root = mountReactHarness(
+    <KeyframeNavigation
+      property="x"
+      keyframes={MERGED_ROW}
+      currentPercentage={currentPercentage}
+      onSeek={vi.fn()}
+      onAddKeyframe={vi.fn()}
+      onRemoveKeyframe={onRemoveKeyframe as never}
+      onConvertToKeyframes={vi.fn()}
+    />,
+  );
+  const diamond = document.querySelector<HTMLElement>('[title="Remove x keyframe"]');
+  expect(diamond).not.toBeNull();
+  act(() => {
+    diamond?.click();
+  });
+  act(() => root.unmount());
+}
+
+describe("KeyframeNavigation diamond", () => {
+  it("reports the clicked keyframe's own animation on a merged row", () => {
+    const onRemoveKeyframe = vi.fn();
+    clickDiamond(50, onRemoveKeyframe);
+    expect(onRemoveKeyframe).toHaveBeenCalledWith(25, "delta-to-4000-position");
+  });
+
+  it("still reports the first tween's keyframe as its own", () => {
+    const onRemoveKeyframe = vi.fn();
+    clickDiamond(0, onRemoveKeyframe);
+    expect(onRemoveKeyframe).toHaveBeenCalledWith(0, "delta-to-500-position");
+  });
+});
diff --git a/packages/studio/src/components/editor/PropertyPanel.tsx b/packages/studio/src/components/editor/PropertyPanel.tsx
index 237d842695..0c9905e806 100644
--- a/packages/studio/src/components/editor/PropertyPanel.tsx
+++ b/packages/studio/src/components/editor/PropertyPanel.tsx
@@ -408,7 +408,9 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
                       onCommitAnimatedProperty &&
                       void onCommitAnimatedProperty(element, "x", displayX)
                     }
-                    onRemoveKeyframe={(pct) => onRemoveKeyframe?.(animIdForProp("x"), pct)}
+                    onRemoveKeyframe={(pct, animationId) =>
+                      onRemoveKeyframe?.(animationId ?? animIdForProp("x"), pct)
+                    }
                     onConvertToKeyframes={() => onConvertToKeyframes?.(animIdForProp("x"))}
                   />
                 )}
@@ -433,7 +435,9 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
                       onCommitAnimatedProperty &&
                       void onCommitAnimatedProperty(element, "y", displayY)
                     }
-                    onRemoveKeyframe={(pct) => onRemoveKeyframe?.(animIdForProp("y"), pct)}
+                    onRemoveKeyframe={(pct, animationId) =>
+                      onRemoveKeyframe?.(animationId ?? animIdForProp("y"), pct)
+                    }
                     onConvertToKeyframes={() => onConvertToKeyframes?.(animIdForProp("y"))}
                   />
                 )}
@@ -458,7 +462,9 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
                       onCommitAnimatedProperty &&
                       void onCommitAnimatedProperty(element, "width", displayW)
                     }
-                    onRemoveKeyframe={(pct) => onRemoveKeyframe?.(animIdForProp("width"), pct)}
+                    onRemoveKeyframe={(pct, animationId) =>
+                      onRemoveKeyframe?.(animationId ?? animIdForProp("width"), pct)
+                    }
                     onConvertToKeyframes={() => onConvertToKeyframes?.(animIdForProp("width"))}
                   />
                 )}
@@ -483,7 +489,9 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
                       onCommitAnimatedProperty &&
                       void onCommitAnimatedProperty(element, "height", displayH)
                     }
-                    onRemoveKeyframe={(pct) => onRemoveKeyframe?.(animIdForProp("height"), pct)}
+                    onRemoveKeyframe={(pct, animationId) =>
+                      onRemoveKeyframe?.(animationId ?? animIdForProp("height"), pct)
+                    }
                     onConvertToKeyframes={() => onConvertToKeyframes?.(animIdForProp("height"))}
                   />
                 )}
@@ -507,7 +515,9 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
                       onCommitAnimatedProperty &&
                       void onCommitAnimatedProperty(element, "rotation", displayR)
                     }
-                    onRemoveKeyframe={(pct) => onRemoveKeyframe?.(animIdForProp("rotation"), pct)}
+                    onRemoveKeyframe={(pct, animationId) =>
+                      onRemoveKeyframe?.(animationId ?? animIdForProp("rotation"), pct)
+                    }
                     onConvertToKeyframes={() => onConvertToKeyframes?.(animIdForProp("rotation"))}
                   />
                 )}
diff --git a/packages/studio/src/components/editor/propertyPanelFlatLayoutSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatLayoutSection.tsx
index da217814f5..a9c256a003 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatLayoutSection.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatLayoutSection.tsx
@@ -83,10 +83,10 @@ function KeyframeGutter({
           track("button", `Add ${property} keyframe`);
           void onCommitAnimatedProperty(element, property, displayValue);
         }}
-        onRemoveKeyframe={(pct) => {
+        onRemoveKeyframe={(pct, animationId) => {
           if (!onRemoveKeyframe) return;
           track("button", `Remove ${property} keyframe`);
-          onRemoveKeyframe(animIdForProp(property), pct);
+          onRemoveKeyframe(animationId ?? animIdForProp(property), pct);
         }}
         onConvertToKeyframes={() => {
           if (!onConvertToKeyframes) return;
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
index a24ceff84f..a07b8323e3 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -184,7 +184,7 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
-  it("settles false for a boundary drag while the tween is still flat", async () => {
+  it("retimes a flat tween's boundary through update-meta, not the keyframe writer", async () => {
     const view = renderCallbacks();
 
     await expect(
@@ -198,9 +198,16 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
         },
         25,
       ),
-    ).resolves.toBe(false);
+    ).resolves.toBe(true);
 
+    // The start boundary moved to 0.25s; the end stays put, so the window is 0.75s.
+    expect(mocks.actions.handleGsapUpdateMeta).toHaveBeenCalledWith(
+      flatAnimation.id,
+      { position: 0.25, duration: 0.75 },
+      mocks.selection,
+    );
     expect(mocks.actions.handleGsapMoveKeyframe).not.toHaveBeenCalled();
+    // resize-keyframed-tween would convert the flat tween to keyframes form.
     expect(mocks.actions.handleGsapResizeKeyframedTween).not.toHaveBeenCalled();
     view.unmount();
   });
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index 4283f035b6..78a078e34b 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -253,10 +253,6 @@ export function useTimelineEditCallbacks({
         const anim = animations.find((a) => a.id === target.animId);
         const tweenStart = anim ? resolveTweenStart(anim) : null;
         if (!anim || tweenStart === null) return Promise.resolve(false);
-        // Synthesized flat endpoints are clip boundaries, not authored keyframes.
-        // Boundary-to-clip resize wiring is intentionally deferred; ignore the
-        // drag rather than dispatching a free keyframe move that cannot be written.
-        if (!anim.keyframes) return Promise.resolve(false);
         const sourceFile = sel.sourceFile || activeCompPath || "index.html";
         const { elements, domClipChildren } = usePlayerStore.getState();
         const { elStart, elDuration } = resolveClipTimingBasis(
@@ -282,6 +278,19 @@ export function useTimelineEditCallbacks({
           decision.position != null &&
           decision.duration != null
         ) {
+          // An empty remap means a FLAT tween's synthesized boundary: there is no
+          // keyframe node to re-key, only the window to move. Sending it through
+          // the keyframed-resize writer would rewrite the authored flat tween into
+          // keyframes form as a side effect of a pure position/duration change, so
+          // dispatch update-meta and leave the tween as the author wrote it.
+          if (decision.pctRemap.length === 0) {
+            handleGsapUpdateMeta(
+              target.animId,
+              { position: decision.position, duration: decision.duration },
+              sel,
+            );
+            return true;
+          }
           return handleGsapResizeKeyframedTween(
             target.animId,
             decision.position,

From 48ea6422aa3688634a7467a2489953a35df59014 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 27 Jul 2026 16:43:56 +0200
Subject: [PATCH 098/125] fix(studio): close the review findings that survived
 the stack
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Selector reads now go through one inverse of `idSelector`. Every writer emits
`[id="01-hook-hero"]` for an id a `#id` selector can't address, but the readers
still matched `#id` only, so the post-commit keyframe-cache refresh, the AST
load and the remove-all-keyframes clear all silently skipped exactly the ids
`idSelector` was added to support.

A keyframe merged from two tweens with different eases kept whichever ease
iterated last. Readers that don't check `easeAmbiguous` showed a curve from a
different animation than an edit would target, so the ambiguous flag now clears
`ease` instead of leaving an arbitrary one behind.

One tolerance for "the playhead is on this keyframe". The motion-path drag used
0.05% while the toolbar and the playhead apply used 1%, so a drag that landed a
fraction of a percent off an authored waypoint skipped the update-point branch
and appended a near-duplicate. `buildTemporalArcKeyframes` now owns the
invariant and replaces any keyframe inside the tolerance, rather than trusting
each caller's own pre-check.

The pending-retime bookkeeping matches on keyframe identity, not just on
"something is near that percentage" — an evenly spaced row cleared the entry off
an unrelated sibling. The neighbour clamp composes pending destinations in
before sorting, so a second drag can't cross a neighbour that already moved.

Also: `keyframeCache`/`gsapAnimations` setters return the same state for a write
that changes nothing (every no-op re-rendered every subscriber), the auto-expand
set drops clips that left the source so an undo/paste under the same id expands
again, `invalidateGsapCache` has a stable identity instead of re-creating the
whole timeline edit context each render, the studio test hook deletes its window
key rather than leaving it enumerable as undefined, and the past-last-row
extrapolation documents why it uses TRACK_H where the pre-first-row branch uses
row 0's own height.

Covers `idFromSelector` round-trips, the insert boundary band across plain,
expanded and unusable row heights, and the collapsed selection key for a
colon-bearing element id.
---
 packages/studio/src/App.tsx                   |  5 +-
 .../studio/src/components/TimelineToolbar.tsx |  8 +--
 .../src/hooks/gsapDragPositionCommit.ts       | 29 +++++++---
 packages/studio/src/hooks/gsapShared.ts       |  9 +++
 .../studio/src/hooks/keyframeCacheAstLoad.ts  | 18 +++---
 .../studio/src/hooks/useEnableKeyframes.ts    |  7 ++-
 .../studio/src/hooks/useGsapKeyframeOps.ts    |  3 +-
 .../components/TimelineClipDiamonds.tsx       | 56 +++++++++++++------
 .../timelineKeyframeIdentity.test.ts          |  7 +++
 .../player/components/timelineLayout.test.ts  | 26 +++++++++
 .../src/player/components/timelineLayout.ts   |  4 ++
 .../components/useAutoExpandKeyframedClips.ts |  6 ++
 12 files changed, 136 insertions(+), 42 deletions(-)

diff --git a/packages/studio/src/App.tsx b/packages/studio/src/App.tsx
index 7bdaafd5b1..7921f28e98 100644
--- a/packages/studio/src/App.tsx
+++ b/packages/studio/src/App.tsx
@@ -157,6 +157,9 @@ export function StudioApp() {
     pendingTimelineEditPathRef,
   });
   const invalidateGsapCacheRef = useRef<() => void>(() => {});
+  // Stable identity — what the ref indirection is for. An inline arrow re-created
+  // the memoized timeline handlers (it is in their deps) on every render.
+  const invalidateGsapCache = useCallback(() => invalidateGsapCacheRef.current(), []);
   const timelineEditing = useTimelineEditing({
     projectId,
     activeCompPath,
@@ -174,7 +177,7 @@ export function StudioApp() {
     sdkSession: editFlowSdkSession,
     publishSdkSession: sdkHandle.publish,
     forceReloadSdkSession: sdkHandle.forceReload,
-    invalidateGsapCache: () => invalidateGsapCacheRef.current(),
+    invalidateGsapCache,
     handleDomZIndexReorderCommitRef,
   });
   const handleTimelineElementsMove: TimelineMoveEditsHandler = useCallback(
diff --git a/packages/studio/src/components/TimelineToolbar.tsx b/packages/studio/src/components/TimelineToolbar.tsx
index 3b42013b83..c745f087d1 100644
--- a/packages/studio/src/components/TimelineToolbar.tsx
+++ b/packages/studio/src/components/TimelineToolbar.tsx
@@ -5,7 +5,7 @@ import {
   isPlayheadWithinTween,
   type EnableKeyframesSession,
 } from "../hooks/useEnableKeyframes";
-import { computeElementPercentage } from "../hooks/gsapShared";
+import { computeElementPercentage, KEYFRAME_PCT_MATCH } from "../hooks/gsapShared";
 import { useKeyframeKeyboard } from "../hooks/useKeyframeKeyboard";
 import {
   getNextTimelineZoomPercent,
@@ -54,8 +54,8 @@ function isMotionPathEndpoint(animation: GsapAnimation | undefined, percentage:
   if (!animation?.keyframes) return false;
   const keyframes = animation.keyframes.keyframes;
   return (
-    Math.abs((keyframes[0]?.percentage ?? -Infinity) - percentage) <= 1 ||
-    Math.abs((keyframes.at(-1)?.percentage ?? Infinity) - percentage) <= 1
+    Math.abs((keyframes[0]?.percentage ?? -Infinity) - percentage) <= KEYFRAME_PCT_MATCH ||
+    Math.abs((keyframes.at(-1)?.percentage ?? Infinity) - percentage) <= KEYFRAME_PCT_MATCH
   );
 }
 
@@ -80,7 +80,7 @@ function resolveKeyframeToggleState(
   const percentage = computeElementPercentage(currentTime, session.domEditSelection, animation);
   const pathEndpoint = isMotionPathEndpoint(arcAnimation, percentage);
   const active = animation.keyframes.keyframes.some(
-    (keyframe) => Math.abs(keyframe.percentage - percentage) <= 1,
+    (keyframe) => Math.abs(keyframe.percentage - percentage) <= KEYFRAME_PCT_MATCH,
   );
   return {
     state: pathEndpoint ? "none" : active ? "active" : "inactive",
diff --git a/packages/studio/src/hooks/gsapDragPositionCommit.ts b/packages/studio/src/hooks/gsapDragPositionCommit.ts
index 9ccf93503f..28c437710f 100644
--- a/packages/studio/src/hooks/gsapDragPositionCommit.ts
+++ b/packages/studio/src/hooks/gsapDragPositionCommit.ts
@@ -2,7 +2,7 @@ import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import type { DomEditSelection } from "../components/editor/domEditingTypes";
 import { usePlayerStore } from "../player/store/playerStore";
 import { resolveTweenStart, resolveTweenDuration } from "../utils/globalTimeCompiler";
-import { resolveEditableTweenDuration } from "./gsapShared";
+import { KEYFRAME_PCT_MATCH, resolveEditableTweenDuration } from "./gsapShared";
 import { roundTo3 } from "../utils/rounding";
 import { computeDraggedGsapPosition } from "./draggedGsapPosition";
 import {
@@ -12,17 +12,27 @@ import {
   materializeIfDynamic,
 } from "./gsapDragCommit";
 
+/**
+ * The tween's keyframes with one inserted at `percentage`. Any existing keyframe
+ * within {@link KEYFRAME_PCT_MATCH} of the insert is REPLACED, not kept: the
+ * server takes a replace-with-keyframes list verbatim, so an append-only build
+ * could hand it two keyframes a fraction of a percent apart. The invariant lives
+ * here rather than in each caller's own pre-check, which is how the two callers
+ * ended up with different tolerances in the first place.
+ */
 export function buildTemporalArcKeyframes(
   anim: GsapAnimation,
   percentage: number,
   properties: Record<string, number>,
 ) {
   return [
-    ...(anim.keyframes?.keyframes ?? []).map((keyframe) => ({
-      percentage: keyframe.percentage,
-      properties: { ...keyframe.properties },
-      ...(keyframe.ease ? { ease: keyframe.ease } : {}),
-    })),
+    ...(anim.keyframes?.keyframes ?? [])
+      .filter((keyframe) => Math.abs(keyframe.percentage - percentage) > KEYFRAME_PCT_MATCH)
+      .map((keyframe) => ({
+        percentage: keyframe.percentage,
+        properties: { ...keyframe.properties },
+        ...(keyframe.ease ? { ease: keyframe.ease } : {}),
+      })),
     { percentage, properties },
   ].sort((a, b) => a.percentage - b.percentage);
 }
@@ -279,7 +289,12 @@ export async function commitGsapPositionFromDrag(
     const { activeKeyframePct, setActiveKeyframePct } = usePlayerStore.getState();
     const pct = activeKeyframePct ?? computeCurrentPercentage(selection, anim);
     const keyframes = anim.keyframes?.keyframes ?? [];
-    const pointIndex = keyframes.findIndex((kf) => Math.abs(kf.percentage - pct) < 0.05);
+    // Same tolerance as applyArcKeyframeAtPlayhead and isMotionPathEndpoint. A
+    // tighter one here meant a drag that landed a fraction of a percent off an
+    // authored waypoint skipped the update-point branch and appended instead.
+    const pointIndex = keyframes.findIndex(
+      (kf) => Math.abs(kf.percentage - pct) <= KEYFRAME_PCT_MATCH,
+    );
     if (pointIndex >= 0) {
       await callbacks.commitMutation(
         selection,
diff --git a/packages/studio/src/hooks/gsapShared.ts b/packages/studio/src/hooks/gsapShared.ts
index c77ddd645b..00c79ceda6 100644
--- a/packages/studio/src/hooks/gsapShared.ts
+++ b/packages/studio/src/hooks/gsapShared.ts
@@ -70,6 +70,15 @@ export function isInstantHold(animation: GsapAnimation): boolean {
 // `CSS.escape`, it needs no browser global (this runs in node tests too).
 const SAFE_HASH_ID = /^-?[A-Za-z_][\w-]*$/;
 
+/**
+ * How close (in tween-%) a playhead has to be to count as sitting ON an existing
+ * keyframe. Every "is there already a keyframe here?" test shares this: with two
+ * different tolerances in play, one path decided "no keyframe here, append one"
+ * while another decided "yes, edit that one", and a drag near a waypoint left two
+ * keyframes a fraction of a percent apart.
+ */
+export const KEYFRAME_PCT_MATCH = 1;
+
 export function idSelector(id: string): string {
   // A `#id` selector is only valid for a CSS identifier. IDs that start with a
   // digit (e.g. "01-hook-hero-word") make `document.querySelector("#01-...")` and
diff --git a/packages/studio/src/hooks/keyframeCacheAstLoad.ts b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
index 19eaacdcff..bca5f4b233 100644
--- a/packages/studio/src/hooks/keyframeCacheAstLoad.ts
+++ b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
@@ -11,18 +11,13 @@ import {
   elementCacheKeys,
   writeGsapAnimationsForElement,
 } from "./gsapKeyframeCacheHelpers";
-import { toClipKeyframes } from "./gsapShared";
+import { idFromSelector, toClipKeyframes } from "./gsapShared";
 import {
   deduplicateKeyframes,
   isStaticPositionHold,
   synthesizeFlatTweenKeyframes,
 } from "./gsapTweenSynth";
 
-function extractIdFromSelector(selector: string): string | null {
-  const match = selector.match(/^#([\w-]+)/);
-  return match ? match[1] : null;
-}
-
 /**
  * Resolve a tween's target selector to the ids of the element(s) it animates.
  * A bare `#id` resolves directly; anything else (a class like `.dot`, a group
@@ -36,10 +31,13 @@ export function resolveSelectorElementIds(
   selector: string,
   doc: Document | null | undefined,
 ): string[] {
-  const bareId = selector.match(/^#([\w-]+)$/);
-  if (bareId) return [bareId[1]];
+  // A whole-selector id match (either shape) addresses exactly one element.
+  const bareId = /^(#[\w-]+|\[id="(?:\\.|[^"\\])*"\])$/.test(selector)
+    ? idFromSelector(selector)
+    : null;
+  if (bareId) return [bareId];
   if (!doc) {
-    const lead = extractIdFromSelector(selector);
+    const lead = idFromSelector(selector);
     return lead ? [lead] : [];
   }
   const ids = new Set<string>();
@@ -51,7 +49,7 @@ export function resolveSelectorElementIds(
         if (el.id) ids.add(el.id);
       }
     } catch {
-      const lead = extractIdFromSelector(sel);
+      const lead = idFromSelector(sel);
       if (lead) ids.add(lead);
     }
   }
diff --git a/packages/studio/src/hooks/useEnableKeyframes.ts b/packages/studio/src/hooks/useEnableKeyframes.ts
index 16299b2bdd..38c8f50086 100644
--- a/packages/studio/src/hooks/useEnableKeyframes.ts
+++ b/packages/studio/src/hooks/useEnableKeyframes.ts
@@ -15,6 +15,7 @@ import { fetchParsedAnimations, getAnimationsForElement } from "./useGsapTweenCa
 import {
   selectorFromSelection,
   computeElementPercentage,
+  KEYFRAME_PCT_MATCH,
   isInstantHold,
   resolveEditableTweenDuration,
 } from "./gsapShared";
@@ -302,7 +303,9 @@ async function applyKeyframeAtPlayhead(
   }
   const pct =
     start === null ? computeElementPercentage(t, sel) : absoluteToPercentage(t, start, duration);
-  const existing = kfAnim.keyframes?.keyframes.find((k) => Math.abs(k.percentage - pct) <= 1);
+  const existing = kfAnim.keyframes?.keyframes.find(
+    (k) => Math.abs(k.percentage - pct) <= KEYFRAME_PCT_MATCH,
+  );
   if (existing) {
     session.handleGsapRemoveKeyframe(kfAnim.id, existing.percentage);
     return;
@@ -406,7 +409,7 @@ export async function applyArcKeyframeAtPlayhead(
   const nodes = arcAnim.keyframes?.keyframes ?? [];
   const playheadPercentage = absoluteToPercentage(t, start, duration);
   const timedNodeIndex = nodes.findIndex(
-    (node) => Math.abs(node.percentage - playheadPercentage) <= 1,
+    (node) => Math.abs(node.percentage - playheadPercentage) <= KEYFRAME_PCT_MATCH,
   );
   if (timedNodeIndex !== -1) {
     if (timedNodeIndex > 0 && timedNodeIndex < nodes.length - 1) {
diff --git a/packages/studio/src/hooks/useGsapKeyframeOps.ts b/packages/studio/src/hooks/useGsapKeyframeOps.ts
index b2a9ee3ba9..fe105e644f 100644
--- a/packages/studio/src/hooks/useGsapKeyframeOps.ts
+++ b/packages/studio/src/hooks/useGsapKeyframeOps.ts
@@ -15,6 +15,7 @@ import {
 } from "../utils/sdkCutover";
 import type { KeyframeCacheEntry } from "../player/store/playerStore";
 import { commitKeyframeAtTimeImpl } from "./gsapKeyframeCommit";
+import { idFromSelector } from "./gsapShared";
 import {
   clearKeyframeCacheForElement,
   readKeyframeSnapshot,
@@ -338,7 +339,7 @@ export function useGsapKeyframeOps({
       // remove-all-keyframes collapses the tween to a static hold and the commit
       // path doesn't return parsed animations, so the keyframe cache is never
       // refreshed — clear it here so the timeline diamonds disappear immediately.
-      const elementId = selection.id ?? selection.selector?.match(/^#([\w-]+)/)?.[1] ?? null;
+      const elementId = selection.id ?? idFromSelector(selection.selector);
       if (elementId) clearKeyframeCacheForElement(targetPath, elementId);
       if (sdkSession && sdkDeps) {
         const handled = await sdkGsapRemoveAllKeyframesPersist(
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 8509db2812..b7e2c63915 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -58,17 +58,29 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   // Pending retime destination (clip + tween %) per keyframe key, so a rapid
   // second drag composes from where the first move left the keyframe (whose
   // cache entry has not rebuilt yet) instead of the stale rendered value.
-  const pendingRetimeRef = useRef(new Map<string, { clipPct: number; tweenPct: number }>());
+  const pendingRetimeRef = useRef<Map<string, { clipPct: number; tweenPct: number }> | null>(null);
+  // Lazy: `useRef(new Map())` allocates a Map on every render and throws all but
+  // the first away, once per mounted lane.
+  pendingRetimeRef.current ??= new Map();
+  const pendingRetimes = pendingRetimeRef.current;
   useEffect(() => {
-    // Clear a pending entry once the authoritative cache reflects a keyframe at
-    // ~its destination. Match by tolerance, not equality: cache writers round
-    // clip %s, so an exact check would leak an entry after every successful retime.
-    for (const [key, pending] of pendingRetimeRef.current) {
-      if (keyframesData.keyframes.some((k) => Math.abs(k.percentage - pending.clipPct) < 0.2)) {
-        pendingRetimeRef.current.delete(key);
-      }
+    // Clear a pending entry once the authoritative cache reflects THAT keyframe
+    // at ~its destination. Match by tolerance, not equality: cache writers round
+    // clip %s, so an exact check would leak an entry after every successful
+    // retime. Match by identity too: a bare "some keyframe is near that %" test
+    // cleared the entry whenever an unrelated sibling happened to sit there,
+    // which is easy to hit on an evenly spaced row.
+    const pendingEntries = pendingRetimeRef.current;
+    if (!pendingEntries) return;
+    for (const [key, pending] of pendingEntries) {
+      const settled = keyframesData.keyframes.some(
+        (k) =>
+          timelineKeyframeSelectionKey(elementId, keyframeTarget(k)) === key &&
+          Math.abs(k.percentage - pending.clipPct) < 0.2,
+      );
+      if (settled) pendingEntries.delete(key);
     }
-  }, [keyframesData.keyframes]);
+  }, [keyframesData.keyframes, elementId]);
   // Visual-only preview of the dragged diamond's clip-% — no runtime/GSAP hold
   // (that optimistic hold was the #1763 flake). The atomic move-keyframe commit
   // on drop re-keys the diamond from source.
@@ -190,9 +202,19 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         const target = keyframeTarget(kf);
         const kfKey = timelineKeyframeSelectionKey(elementId, target);
         // Clamp against this keyframe's own tween, not the whole merged row.
-        const siblingRow = siblingRowOf(kf);
-        const siblingClipPcts = siblingRow.map((k) => k.percentage);
-        const siblingIndex = siblingRow.indexOf(kf);
+        // Compose each sibling's pending destination in first: clamping against
+        // cached positions while the dragged keyframe reads its pending one let
+        // a second drag cross a neighbour that had already moved past it.
+        const siblingRow = siblingRowOf(kf)
+          .map((k) => ({
+            keyframe: k,
+            clipPct:
+              pendingRetimes.get(timelineKeyframeSelectionKey(elementId, keyframeTarget(k)))
+                ?.clipPct ?? k.percentage,
+          }))
+          .sort((a, b) => a.clipPct - b.clipPct);
+        const siblingClipPcts = siblingRow.map((s) => s.clipPct);
+        const siblingIndex = siblingRow.findIndex((s) => s.keyframe === kf);
         // While dragging this diamond, render it at the live preview clip-%.
         const renderPct = preview?.kfKey === kfKey ? preview.clipPct : kf.percentage;
         // Center the marker's non-overlapping hit region ON its keyframe %, so
@@ -216,7 +238,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               startX: e.clientX,
               lastX: e.clientX,
               index: siblingIndex,
-              fromClipPct: pendingRetimeRef.current.get(kfKey)?.clipPct ?? kf.percentage,
+              fromClipPct: pendingRetimes.get(kfKey)?.clipPct ?? kf.percentage,
               moved: false,
             };
           }
@@ -309,7 +331,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
             // For a rapid second retime the diamond still renders the stale cache
             // position, so identify the FROM keyframe by the pending (already-moved)
             // position; the mutation locates the source keyframe by this identity.
-            const pendingBefore = pendingRetimeRef.current.get(kfKey);
+            const pendingBefore = pendingRetimes.get(kfKey);
             const fromTarget = pendingBefore
               ? {
                   ...target,
@@ -318,10 +340,10 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
                 }
               : target;
             const pending = { clipPct: res.toClipPct, tweenPct: newTweenPct };
-            pendingRetimeRef.current.set(kfKey, pending);
+            pendingRetimes.set(kfKey, pending);
             const clearPending = () => {
-              if (pendingRetimeRef.current.get(kfKey) === pending) {
-                pendingRetimeRef.current.delete(kfKey);
+              if (pendingRetimes.get(kfKey) === pending) {
+                pendingRetimes.delete(kfKey);
               }
             };
             // A rejected drop (the destination time is already occupied) snaps
diff --git a/packages/studio/src/player/components/timelineKeyframeIdentity.test.ts b/packages/studio/src/player/components/timelineKeyframeIdentity.test.ts
index 5b774715ae..78ea65a130 100644
--- a/packages/studio/src/player/components/timelineKeyframeIdentity.test.ts
+++ b/packages/studio/src/player/components/timelineKeyframeIdentity.test.ts
@@ -32,6 +32,13 @@ describe("timeline keyframe selection identity", () => {
     expect(timelineKeyframeTargetFromSelectionKey("comp#a", key)).toBeNull();
   });
 
+  // Timeline.tsx still writes the collapsed form for clip-lane shift-clicks, and
+  // an element id can itself contain a colon — the split has to be the LAST one.
+  it("splits the collapsed key at the last colon so a colon-bearing id survives", () => {
+    expect(timelineKeyframeTargetFromSelectionKey("a:b", "a:b:40")).toEqual({ percentage: 40 });
+    expect(timelineKeyframeTargetFromSelectionKey("a", "a:b:40")).toBeNull();
+  });
+
   it("retains the collapsed key fallback and rejects malformed percentages", () => {
     expect(timelineKeyframeTargetFromSelectionKey("comp#a", "comp#a:30")).toEqual({
       percentage: 30,
diff --git a/packages/studio/src/player/components/timelineLayout.test.ts b/packages/studio/src/player/components/timelineLayout.test.ts
index 63f0c97feb..4cd2fa14d4 100644
--- a/packages/studio/src/player/components/timelineLayout.test.ts
+++ b/packages/studio/src/player/components/timelineLayout.test.ts
@@ -1,5 +1,8 @@
 import { describe, it, expect } from "vitest";
 import {
+  CLIP_Y,
+  INSERT_BOUNDARY_BAND,
+  getTimelineInsertBoundaryBand,
   RULER_H,
   TRACK_H,
   LANE_H,
@@ -225,6 +228,7 @@ describe("getTimelineScrubTime", () => {
         clientX: 500,
         viewportLeft: 0,
         scrollLeft: 0,
+        contentOrigin: GUTTER + TRACKS_LEFT_PAD,
         pixelsPerSecond: 0,
         duration: 10,
       }),
@@ -232,3 +236,25 @@ describe("getTimelineScrubTime", () => {
     expect(at(origin + 250, Number.NaN)).toBe(0);
   });
 });
+
+// The only production hook keeping resolveInsertRow's band aligned with the
+// rendered clip inset once rows can be taller than TRACK_H. Pinned directly so a
+// change to CLIP_Y or the invalid-height fallback can't silently drift it.
+describe("getTimelineInsertBoundaryBand", () => {
+  it("matches the fixed band for a plain track row", () => {
+    expect(getTimelineInsertBoundaryBand(TRACK_H)).toBe(INSERT_BOUNDARY_BAND);
+    expect(getTimelineInsertBoundaryBand(TRACK_H)).toBe(CLIP_Y / TRACK_H);
+  });
+
+  it("shrinks as the row grows, so the band stays CLIP_Y pixels tall", () => {
+    const expanded = TRACK_H + 2 * LANE_H;
+    expect(getTimelineInsertBoundaryBand(expanded)).toBeCloseTo(CLIP_Y / expanded, 10);
+    expect(getTimelineInsertBoundaryBand(expanded)).toBeLessThan(INSERT_BOUNDARY_BAND);
+  });
+
+  it("falls back to the plain-track band for a height that is not usable", () => {
+    for (const height of [0, -10, Number.NaN]) {
+      expect(getTimelineInsertBoundaryBand(height)).toBe(INSERT_BOUNDARY_BAND);
+    }
+  });
+});
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 4db33c01c3..0ac3cb856a 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -104,6 +104,10 @@ function getTimelineRowOffset(row: number, rowHeights: readonly number[]): numbe
   const offsets = getTimelineRowOffsets(rowHeights);
   if (row <= 0) return row * getTimelineRowHeight(0, rowHeights);
   if (row >= rowHeights.length) {
+    // Deliberately TRACK_H, not the last row's height: rows past the end do not
+    // exist yet, and a row created by dropping there starts unexpanded. The
+    // pre-first-row branch above uses row 0's concrete height instead because
+    // that row DOES exist — the pointer is in the top pad above a real lane.
     return (offsets[rowHeights.length] ?? 0) + (row - rowHeights.length) * TRACK_H;
   }
   const wholeRow = Math.floor(row);
diff --git a/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts b/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts
index 1ff3e1d91c..33b0731af5 100644
--- a/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts
+++ b/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts
@@ -24,6 +24,12 @@ export function useAutoExpandKeyframedClips(gsapAnimations: Map<string, GsapAnim
     } else {
       seen.current.source = gsapAnimations;
     }
+    // Drop clips that are no longer in the source at all. Without this the set
+    // is append-only, so a clip deleted and reinserted under the same id (undo,
+    // paste) is remembered as already-expanded and never auto-expands again.
+    for (const key of seen.current.clips) {
+      if (!gsapAnimations.has(key)) seen.current.clips.delete(key);
+    }
     const fresh: string[] = [];
     for (const [key, animations] of gsapAnimations) {
       if (seen.current.clips.has(key)) continue;

From edbb6d102c1ba09c9b70e6388e6a646d81bfa3b2 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 27 Jul 2026 17:36:34 +0200
Subject: [PATCH 099/125] refactor(studio): double-cast test fixtures and split
 three dense functions

CONTRIBUTING.md allows `as unknown as T` with a justification, not a bare
`as T`; the gsapShared fixtures only carry the fields under test.

The fallow complexity gate flagged three functions on this branch. Each is
split at its natural seam rather than suppressed: the auto-expand scan moves
out of the effect, the four repeated attribute guards in
nodeMatchesManifestClip collapse into one table-driven check, and the
segment-% interpolation moves out of onPathDown.
---
 .../components/editor/MotionPathOverlay.tsx   | 24 ++++++++++-----
 packages/studio/src/hooks/gsapShared.test.ts  | 12 ++++----
 .../components/useAutoExpandKeyframedClips.ts | 30 ++++++++++++-------
 .../src/player/lib/timelineElementHelpers.ts  | 23 +++++++-------
 4 files changed, 55 insertions(+), 34 deletions(-)

diff --git a/packages/studio/src/components/editor/MotionPathOverlay.tsx b/packages/studio/src/components/editor/MotionPathOverlay.tsx
index 5d29fab684..6641404291 100644
--- a/packages/studio/src/components/editor/MotionPathOverlay.tsx
+++ b/packages/studio/src/components/editor/MotionPathOverlay.tsx
@@ -45,6 +45,19 @@ type DragState = {
   ref: MotionNodeRef;
 };
 
+/**
+ * Tween-% for a stop inserted at fraction `t` along the segment between two
+ * nodes. null when either end is not a keyframe (arc waypoints carry no %).
+ */
+function interpolatedKeyframePct(
+  a: MotionNodeRef | undefined,
+  b: MotionNodeRef | undefined,
+  t: number,
+): number | null {
+  if (a?.type !== "keyframe" || b?.type !== "keyframe") return null;
+  return Math.round((a.pct + (b.pct - a.pct) * t) * 1000) / 1000;
+}
+
 const NODE_PX = 6; // node radius in screen pixels (kept constant across zoom)
 // Click-vs-drag cutoff in SCREEN pixels. Below this the pointer-up is a click
 // (select the keyframe); at or above it the gesture commits a move. Screen-space
@@ -402,13 +415,10 @@ export const MotionPathOverlay = memo(function MotionPathOverlay({
       void commitAddWaypoint(animId, np.segIndex + 1, x, y, commitMutation);
     } else {
       // Linear keyframe path: interpolate the new stop's tween-% from the two
-      // keyframes bounding the clicked segment (np.t = fraction along it), then
-      // insert it. Lands ON the current line, so the dot doesn't jump — drag it
-      // after to bend the path.
-      const a = abs[np.segIndex]?.ref;
-      const b = abs[np.segIndex + 1]?.ref;
-      if (a?.type !== "keyframe" || b?.type !== "keyframe") return;
-      const pct = Math.round((a.pct + (b.pct - a.pct) * np.t) * 1000) / 1000;
+      // keyframes bounding the clicked segment, then insert it. Lands ON the
+      // current line, so the dot doesn't jump — drag it after to bend the path.
+      const pct = interpolatedKeyframePct(abs[np.segIndex]?.ref, abs[np.segIndex + 1]?.ref, np.t);
+      if (pct === null) return;
       e.stopPropagation();
       void commitAddKeyframe(animId, pct, x, y, commitMutation);
     }
diff --git a/packages/studio/src/hooks/gsapShared.test.ts b/packages/studio/src/hooks/gsapShared.test.ts
index 0458d091b9..604b93b694 100644
--- a/packages/studio/src/hooks/gsapShared.test.ts
+++ b/packages/studio/src/hooks/gsapShared.test.ts
@@ -11,17 +11,19 @@ import {
   toClipPercentage,
 } from "./gsapShared";
 
+// Fixtures carry only the fields the function under test reads; the double-cast
+// is the documented way to stand in for the full runtime shape (CONTRIBUTING.md).
+const tween = (duration: number | undefined) => ({ duration }) as unknown as GsapAnimation;
+
 describe("resolveEditableTweenDuration", () => {
-  const selection = { dataAttributes: { duration: "16.26" } } as DomEditSelection;
+  const selection = { dataAttributes: { duration: "16.26" } } as unknown as DomEditSelection;
 
   it("uses the owning clip duration when the tween omits an outer duration", () => {
-    expect(resolveEditableTweenDuration({ duration: undefined } as GsapAnimation, selection)).toBe(
-      16.26,
-    );
+    expect(resolveEditableTweenDuration(tween(undefined), selection)).toBe(16.26);
   });
 
   it("keeps an explicitly-authored tween duration", () => {
-    expect(resolveEditableTweenDuration({ duration: 4 } as GsapAnimation, selection)).toBe(4);
+    expect(resolveEditableTweenDuration(tween(4), selection)).toBe(4);
   });
 });
 
diff --git a/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts b/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts
index 33b0731af5..c5ba437e32 100644
--- a/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts
+++ b/packages/studio/src/player/components/useAutoExpandKeyframedClips.ts
@@ -11,6 +11,24 @@ import { animationContributesLane } from "./TimelinePropertyLanes";
  * — tracked per-clip so a later user collapse sticks and never bounces back open
  * (and clips added later still auto-expand).
  */
+/**
+ * Prunes clips that left the source, then returns the ones that newly contribute
+ * a lane. The prune matters because the set is otherwise append-only: a clip
+ * deleted and reinserted under the same id (undo, paste) would be remembered as
+ * already-expanded and never auto-expand again.
+ */
+function freshLaneClips(gsapAnimations: Map<string, GsapAnimation[]>, clips: Set<string>) {
+  for (const key of clips) {
+    if (!gsapAnimations.has(key)) clips.delete(key);
+  }
+  const fresh: string[] = [];
+  for (const [key, animations] of gsapAnimations) {
+    if (clips.has(key)) continue;
+    if (animations.some(animationContributesLane)) fresh.push(key);
+  }
+  return fresh;
+}
+
 export function useAutoExpandKeyframedClips(gsapAnimations: Map<string, GsapAnimation[]>): void {
   const expandClips = usePlayerStore((s) => s.expandClips);
   const projectId = useStudioShellContextOptional()?.projectId ?? null;
@@ -24,17 +42,7 @@ export function useAutoExpandKeyframedClips(gsapAnimations: Map<string, GsapAnim
     } else {
       seen.current.source = gsapAnimations;
     }
-    // Drop clips that are no longer in the source at all. Without this the set
-    // is append-only, so a clip deleted and reinserted under the same id (undo,
-    // paste) is remembered as already-expanded and never auto-expands again.
-    for (const key of seen.current.clips) {
-      if (!gsapAnimations.has(key)) seen.current.clips.delete(key);
-    }
-    const fresh: string[] = [];
-    for (const [key, animations] of gsapAnimations) {
-      if (seen.current.clips.has(key)) continue;
-      if (animations.some(animationContributesLane)) fresh.push(key);
-    }
+    const fresh = freshLaneClips(gsapAnimations, seen.current.clips);
     if (fresh.length === 0) return;
     for (const key of fresh) seen.current.clips.add(key);
     expandClips(fresh);
diff --git a/packages/studio/src/player/lib/timelineElementHelpers.ts b/packages/studio/src/player/lib/timelineElementHelpers.ts
index 3232482917..fc403f9b2f 100644
--- a/packages/studio/src/player/lib/timelineElementHelpers.ts
+++ b/packages/studio/src/player/lib/timelineElementHelpers.ts
@@ -380,20 +380,21 @@ function numbersNearlyEqual(a: number, b: number): boolean {
   return Math.abs(a - b) < 0.001;
 }
 
+const MANIFEST_CLIP_ATTRS: ReadonlyArray<[string, (clip: ClipManifestClip) => number]> = [
+  ["data-start", (clip) => clip.start],
+  ["data-duration", (clip) => clip.duration],
+  ["data-track-index", (clip) => clip.track],
+];
+
 function nodeMatchesManifestClip(node: Element, clip: ClipManifestClip): boolean {
   const tagName = clip.tagName?.toLowerCase();
   if (tagName && node.tagName.toLowerCase() !== tagName) return false;
-
-  const start = Number.parseFloat(node.getAttribute("data-start") ?? "");
-  if (Number.isFinite(start) && !numbersNearlyEqual(start, clip.start)) return false;
-
-  const duration = Number.parseFloat(node.getAttribute("data-duration") ?? "");
-  if (Number.isFinite(duration) && !numbersNearlyEqual(duration, clip.duration)) return false;
-
-  const track = Number.parseInt(node.getAttribute("data-track-index") ?? "", 10);
-  if (Number.isFinite(track) && track !== clip.track) return false;
-
-  return true;
+  // An attribute only constrains the match when it parses to a finite number:
+  // missing or garbled reads as "unknown", not "mismatch".
+  return MANIFEST_CLIP_ATTRS.every(([attr, expected]) => {
+    const actual = Number.parseFloat(node.getAttribute(attr) ?? "");
+    return !Number.isFinite(actual) || numbersNearlyEqual(actual, expected(clip));
+  });
 }
 
 function findTimelineDomNode(doc: Document, id: string): Element | null {

From 910ef2649a063ce404b20949bfacbe1f44987f2a Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 27 Jul 2026 21:10:40 +0200
Subject: [PATCH 100/125] refactor(studio): share keyframe clip-% precision
 across lane writers

Review follow-ups on the expanded-lanes tip:

- TimelinePropertyLanes.groupKeyframes re-derived the clip-relative
  percentage inline and skipped toClipKeyframes' rounding, the one
  precision every keyframe-cache writer has to agree on (selection keys
  embed the number). It now loops the shared helper per animation with
  the group filter and only overrides the lane's own group and ease.
- TimelineClipDiamonds rebuilt and re-sorted each tween's sibling row
  inside the marker loop, so a row of N diamonds allocated N sorted
  copies of itself on every playhead tick. Built once per render instead,
  keyed by animation id.
- Add the missing symmetry test at the real callback boundary: the
  diamond test mocks onMoveKeyframe, so nothing proved the rapid-second
  retime resolves a pending clip-% the keyframe cache has not caught up
  to. The new test asserts the identity-carrying target retimes and that
  the same drag without identity fields cannot.
---
 .../nle/useTimelineEditCallbacks.test.tsx     | 57 +++++++++++++++++++
 .../components/TimelineClipDiamonds.tsx       | 39 ++++++++-----
 .../components/TimelinePropertyLanes.tsx      | 24 ++++----
 3 files changed, 97 insertions(+), 23 deletions(-)

diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
index a07b8323e3..c8eb9b0088 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -487,6 +487,63 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
     view.unmount();
   });
 
+  // The diamond's rapid-second-retime path reports the PENDING clip-% (where the
+  // first drag put the keyframe), which the keyframe cache has not caught up to.
+  // TimelineClipDiamonds' own test mocks onMoveKeyframe, so only this one proves
+  // the real callback resolves that stale-cache position off the identity fields
+  // instead of failing the lookup.
+  it("retimes from a pending position the keyframe cache has not caught up to", async () => {
+    const authored = authoredInteriorAnimation();
+    mocks.animations = [authored];
+    usePlayerStore.setState({
+      elements: [element],
+      gsapAnimations: new Map([["index.html#box", [authored]]]),
+      // Still the pre-drag positions: 75% is not in here.
+      keyframeCache: new Map([
+        [
+          "index.html#box",
+          {
+            format: "percentage" as const,
+            keyframes: [
+              { percentage: 0, properties: { x: 0 } },
+              { percentage: 50, properties: { x: 210 } },
+              { percentage: 100, properties: { x: 420 } },
+            ],
+          },
+        ],
+      ]),
+    });
+    const view = renderCallbacks();
+
+    await expect(
+      view.callbacks.onMoveKeyframe?.(
+        "index.html#box",
+        {
+          percentage: 75,
+          propertyGroup: "position",
+          tweenPercentage: 50,
+          animationId: authored.id,
+        },
+        85,
+      ),
+    ).resolves.toBe(true);
+    expect(mocks.actions.handleGsapMoveKeyframe).toHaveBeenCalledWith(
+      authored.id,
+      50,
+      85,
+      mocks.selection,
+    );
+
+    // Control: the same drag WITHOUT the identity fields falls back to the cache
+    // lookup, finds nothing at 75%, and cannot retime.
+    mocks.actions.handleGsapMoveKeyframe.mockClear();
+    await expect(
+      view.callbacks.onMoveKeyframe?.("index.html#box", { percentage: 75 }, 85),
+    ).resolves.toBe(false);
+    expect(mocks.actions.handleGsapMoveKeyframe).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
   it("uses the clip timing basis when retiming a duration-less tween", async () => {
     const durationless = {
       ...authoredInteriorAnimation(),
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index b7e2c63915..47e17b22d4 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -149,6 +149,29 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
     keyframe.animationId === undefined
       ? sorted
       : sorted.filter((k) => k.animationId === keyframe.animationId);
+  // Compose each sibling's pending destination in first: clamping against
+  // cached positions while the dragged keyframe reads its pending one let a
+  // second drag cross a neighbour that had already moved past it. Built once
+  // per render, keyed by tween: every diamond of a row needs the same row, and
+  // rebuilding + re-sorting it inside the marker loop below made this
+  // O(keyframes squared) allocations on every playhead tick.
+  const pendingClipPctOf = (keyframe: TimelineDiamondKeyframe) =>
+    pendingRetimes.get(timelineKeyframeSelectionKey(elementId, keyframeTarget(keyframe)))
+      ?.clipPct ?? keyframe.percentage;
+  const siblingRows = new Map<
+    string | undefined,
+    { keyframes: TimelineDiamondKeyframe[]; clipPcts: number[] }
+  >();
+  for (const keyframe of sorted) {
+    if (siblingRows.has(keyframe.animationId)) continue;
+    const row = siblingRowOf(keyframe)
+      .map((k) => ({ keyframe: k, clipPct: pendingClipPctOf(k) }))
+      .sort((a, b) => a.clipPct - b.clipPct);
+    siblingRows.set(keyframe.animationId, {
+      keyframes: row.map((s) => s.keyframe),
+      clipPcts: row.map((s) => s.clipPct),
+    });
+  }
   const centerXOf = (percentage: number) =>
     Math.max(0, Math.min(clipWidthPx, (percentage / 100) * clipWidthPx));
   // One record per diamond, carrying its own geometry, so the connector and
@@ -202,19 +225,9 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         const target = keyframeTarget(kf);
         const kfKey = timelineKeyframeSelectionKey(elementId, target);
         // Clamp against this keyframe's own tween, not the whole merged row.
-        // Compose each sibling's pending destination in first: clamping against
-        // cached positions while the dragged keyframe reads its pending one let
-        // a second drag cross a neighbour that had already moved past it.
-        const siblingRow = siblingRowOf(kf)
-          .map((k) => ({
-            keyframe: k,
-            clipPct:
-              pendingRetimes.get(timelineKeyframeSelectionKey(elementId, keyframeTarget(k)))
-                ?.clipPct ?? k.percentage,
-          }))
-          .sort((a, b) => a.clipPct - b.clipPct);
-        const siblingClipPcts = siblingRow.map((s) => s.clipPct);
-        const siblingIndex = siblingRow.findIndex((s) => s.keyframe === kf);
+        const siblingRow = siblingRows.get(kf.animationId);
+        const siblingClipPcts = siblingRow?.clipPcts ?? [];
+        const siblingIndex = siblingRow?.keyframes.indexOf(kf) ?? -1;
         // While dragging this diamond, render it at the live preview clip-%.
         const renderPct = preview?.kfKey === kfKey ? preview.clipPct : kf.percentage;
         // Center the marker's non-overlapping hit region ON its keyframe %, so
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
index 6d9f028159..018aa4f8a0 100644
--- a/packages/studio/src/player/components/TimelinePropertyLanes.tsx
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
@@ -4,7 +4,7 @@ import {
   type GsapAnimation,
   type PropertyGroupName,
 } from "@hyperframes/core/gsap-parser";
-import { toAbsoluteTime } from "../../hooks/gsapShared";
+import { toClipKeyframes } from "../../hooks/gsapShared";
 import { synthesizeFlatTweenKeyframes } from "../../hooks/gsapTweenSynth";
 import { TimelineDiamondLane, type TimelineDiamondKeyframe } from "./TimelineClipDiamonds";
 import { LANE_H, getTimelineLaneTop } from "./timelineLayout";
@@ -67,6 +67,13 @@ function keyframeEase(keyframe: { ease?: string }, animation: GsapAnimation): st
   return keyframe.ease ?? animation.keyframes?.easeEach ?? animation.ease;
 }
 
+/**
+ * One lane row per keyframe of `group`. The clip-% re-basing goes through the
+ * shared toClipKeyframes so lane rows land on the exact same percentage the
+ * keyframe cache writes: this file used to derive it inline and skipped that
+ * helper's rounding, which is the one precision every keyframe-cache writer has
+ * to agree on (selection keys embed the number).
+ */
 function groupKeyframes(
   animations: readonly GsapAnimation[],
   group: PropertyGroupName,
@@ -75,18 +82,15 @@ function groupKeyframes(
 ): TimelineDiamondKeyframe[] {
   const keyframes: TimelineDiamondKeyframe[] = [];
   for (const animation of animations) {
-    const tweenStart =
-      animation.resolvedStart ?? (typeof animation.position === "number" ? animation.position : 0);
-    const tweenDuration = animation.duration ?? clipDuration;
-    for (const keyframe of animationKeyframes(animation)) {
-      if (!hasGroupProperty(keyframe.properties, group)) continue;
-      const absoluteTime = toAbsoluteTime(tweenStart, tweenDuration, keyframe.percentage);
+    const inGroup = animationKeyframes(animation).filter((keyframe) =>
+      hasGroupProperty(keyframe.properties, group),
+    );
+    for (const keyframe of toClipKeyframes(inGroup, animation, clipStart, clipDuration)) {
       keyframes.push({
         ...keyframe,
-        percentage: ((absoluteTime - clipStart) / clipDuration) * 100,
-        tweenPercentage: keyframe.percentage,
+        // The LANE's group, not the tween's own classification: a mixed-property
+        // tween classifies to undefined yet still feeds every group it touches.
         propertyGroup: group,
-        animationId: animation.id,
         ease: keyframeEase(keyframe, animation),
       });
     }

From 1c92c811119ae8093ffeb97407ee44d799567e22 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 18:21:00 +0200
Subject: [PATCH 101/125] fix(studio): target colliding keyframes exactly

---
 .../hooks/gsapKeyframeCacheHelpers.test.ts    | 38 +++++++++
 .../src/hooks/gsapKeyframeCacheHelpers.ts     |  6 +-
 .../studio/src/hooks/gsapTweenSynth.test.ts   | 85 +++++++++++++++----
 packages/studio/src/hooks/gsapTweenSynth.ts   | 61 ++++++++-----
 .../components/TimelineClipDiamonds.test.tsx  | 24 ++++--
 .../components/TimelineDiamondConnectors.tsx  | 12 +--
 .../player/components/timelineDiamondTypes.ts |  7 +-
 .../components/timelineKeyframeIdentity.ts    |  3 +
 .../useTimelineKeyframeHandlers.test.tsx      | 38 +++++++++
 .../components/useTimelineKeyframeHandlers.ts |  1 +
 .../studio/src/player/store/keyframeSlice.ts  | 20 +++--
 11 files changed, 236 insertions(+), 59 deletions(-)

diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
index 05e5c93da8..f2c7b3e755 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
@@ -155,6 +155,44 @@ describe("pruneKeyframeCacheToFiles", () => {
 });
 
 describe("updateKeyframeCacheFromParsed", () => {
+  it("records colliding animation targets with their own tween percentages", () => {
+    const animation = (
+      id: string,
+      propertyGroup: string,
+      properties: Record<string, number>,
+      percentage: number,
+      resolvedStart: number,
+    ): GsapAnimation => ({
+      ...animWithKeyframes(id),
+      targetSelector: "#hero",
+      propertyGroup,
+      resolvedStart,
+      keyframes: { format: "percentage", keyframes: [{ percentage, properties }] },
+    });
+
+    usePlayerStore.setState({
+      elements: [{ id: "hero", domId: "hero", tag: "div", start: 0, duration: 4, track: 0 }],
+    });
+
+    updateKeyframeCacheFromParsed(
+      [
+        animation("hero-position", "position", { x: 100 }, 50, 0.5),
+        animation("hero-visual", "visual", { opacity: 1 }, 80, 0.2),
+        animation("hero-position", "position", { y: 50 }, 25, 0.75),
+        animation("hero-scale", "scale", { scale: 2 }, 60, 0.4),
+      ],
+      "scene.html",
+      "hero",
+      {},
+    );
+
+    expect(cache().get("scene.html#hero")?.keyframes[0]?.collidingAnimationTargets).toEqual([
+      { animationId: "hero-position", tweenPercentage: 50 },
+      { animationId: "hero-visual", tweenPercentage: 80 },
+      { animationId: "hero-scale", tweenPercentage: 60 },
+    ]);
+  });
+
   it("serializes a multi-keyframe tween with a stable shape and animation identity", () => {
     const animation: GsapAnimation = {
       ...animWithKeyframes("hero"),
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index 929960a16d..08e471e2aa 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -44,9 +44,9 @@ export function updateKeyframeCacheFromParsed(
 
     const existing = merged.get(id);
     if (existing) {
-      // deduplicateKeyframes owns the same-% merge (including the easeAmbiguous
-      // flag downstream lanes read); a second copy of that rule here is how the
-      // two writers drift.
+      // deduplicateKeyframes owns the same-% merge (including the colliding
+      // animation targets downstream lanes read); a second copy of that rule
+      // here is how the two writers drift.
       existing.keyframes = deduplicateKeyframes([...existing.keyframes, ...clipKeyframes]);
     } else {
       merged.set(id, {
diff --git a/packages/studio/src/hooks/gsapTweenSynth.test.ts b/packages/studio/src/hooks/gsapTweenSynth.test.ts
index b5474cf1de..e4b58b4bea 100644
--- a/packages/studio/src/hooks/gsapTweenSynth.test.ts
+++ b/packages/studio/src/hooks/gsapTweenSynth.test.ts
@@ -54,31 +54,86 @@ describe("synthesizeFlatTweenKeyframes", () => {
   });
 });
 
-describe("deduplicateKeyframes ease ambiguity", () => {
-  it("flags a same-% collision from different animations (different eases)", () => {
+describe("deduplicateKeyframes colliding animation targets", () => {
+  it("records each animation's tween percentage in first-seen order", () => {
     const merged = deduplicateKeyframes([
-      { percentage: 45, properties: { x: 10 }, ease: "power2.in", animationId: "#a-position" },
-      { percentage: 45, properties: { opacity: 1 }, ease: "power2.out", animationId: "#a-visual" },
+      {
+        percentage: 45,
+        tweenPercentage: 20,
+        properties: { x: 10 },
+        ease: "power2.in",
+        animationId: "#a-position",
+      },
+      {
+        percentage: 45,
+        tweenPercentage: 80,
+        properties: { opacity: 1 },
+        ease: "power2.out",
+        animationId: "#a-visual",
+      },
     ]);
     const kf = merged.find((k) => k.percentage === 45);
-    expect(kf?.easeAmbiguous).toBe(true);
+    expect(kf?.collidingAnimationTargets).toEqual([
+      { animationId: "#a-position", tweenPercentage: 20 },
+      { animationId: "#a-visual", tweenPercentage: 80 },
+    ]);
   });
 
-  it("flags a cross-animation collision even when the raw eases match", () => {
-    // The button can still only target one arbitrary animation, and each may
-    // inherit a different easeEach/animation ease that raw comparison misses.
+  it("deduplicates three colliding animations while preserving first-seen order", () => {
     const merged = deduplicateKeyframes([
-      { percentage: 45, properties: { x: 10 }, ease: "power2.in", animationId: "#a-position" },
-      { percentage: 45, properties: { opacity: 1 }, ease: "power2.in", animationId: "#a-visual" },
+      {
+        percentage: 45,
+        tweenPercentage: 20,
+        properties: { x: 10 },
+        ease: "power2.in",
+        animationId: "#a-position",
+      },
+      {
+        percentage: 45,
+        tweenPercentage: 80,
+        properties: { opacity: 1 },
+        ease: "power2.in",
+        animationId: "#a-visual",
+      },
+      {
+        percentage: 45,
+        tweenPercentage: 40,
+        properties: { y: 20 },
+        ease: "power2.out",
+        animationId: "#a-position",
+      },
+      {
+        percentage: 45,
+        tweenPercentage: 60,
+        properties: { scale: 2 },
+        ease: "power2.in",
+        animationId: "#a-scale",
+      },
+    ]);
+    expect(merged.find((k) => k.percentage === 45)?.collidingAnimationTargets).toEqual([
+      { animationId: "#a-position", tweenPercentage: 20 },
+      { animationId: "#a-visual", tweenPercentage: 80 },
+      { animationId: "#a-scale", tweenPercentage: 60 },
     ]);
-    expect(merged.find((k) => k.percentage === 45)?.easeAmbiguous).toBe(true);
   });
 
-  it("does not flag a same-% collision within a single animation", () => {
+  it("leaves the collision set undefined within a single animation", () => {
     const merged = deduplicateKeyframes([
-      { percentage: 45, properties: { x: 10 }, ease: "power2.in", animationId: "#a-position" },
-      { percentage: 45, properties: { y: 20 }, ease: "power2.out", animationId: "#a-position" },
+      {
+        percentage: 45,
+        tweenPercentage: 20,
+        properties: { x: 10 },
+        ease: "power2.in",
+        animationId: "#a-position",
+      },
+      {
+        percentage: 45,
+        tweenPercentage: 80,
+        properties: { y: 20 },
+        ease: "power2.out",
+        animationId: "#a-position",
+      },
     ]);
-    expect(merged.find((k) => k.percentage === 45)?.easeAmbiguous).toBeFalsy();
+    expect(merged.find((k) => k.percentage === 45)?.collidingAnimationTargets).toBeUndefined();
   });
 });
diff --git a/packages/studio/src/hooks/gsapTweenSynth.ts b/packages/studio/src/hooks/gsapTweenSynth.ts
index a3b100be4d..a07bc3cf16 100644
--- a/packages/studio/src/hooks/gsapTweenSynth.ts
+++ b/packages/studio/src/hooks/gsapTweenSynth.ts
@@ -22,34 +22,53 @@ export function isStaticPositionHold(anim: GsapAnimation): boolean {
   return propKeys.length > 0 && propKeys.every((k) => k === "x" || k === "y");
 }
 
+export interface AnimationKeyframeTarget {
+  animationId: string;
+  tweenPercentage: number;
+}
+
+export function accumulateCollidingAnimationTargets(
+  keyframe: {
+    animationId?: string;
+    tweenPercentage?: number;
+    collidingAnimationTargets?: AnimationKeyframeTarget[];
+  },
+  incoming: { animationId?: string; tweenPercentage?: number },
+): void {
+  const primaryId = keyframe.animationId;
+  if (
+    primaryId === undefined ||
+    keyframe.tweenPercentage === undefined ||
+    incoming.animationId === undefined ||
+    incoming.tweenPercentage === undefined ||
+    primaryId === incoming.animationId
+  ) {
+    return;
+  }
+  const collisionTargets = keyframe.collidingAnimationTargets;
+  if (collisionTargets?.some((target) => target.animationId === incoming.animationId)) return;
+  keyframe.collidingAnimationTargets = [
+    ...(collisionTargets === undefined || collisionTargets.length === 0
+      ? [{ animationId: primaryId, tweenPercentage: keyframe.tweenPercentage }]
+      : collisionTargets),
+    { animationId: incoming.animationId, tweenPercentage: incoming.tweenPercentage },
+  ];
+}
+
 export function deduplicateKeyframes<
-  T extends GsapPercentageKeyframe & { animationId?: string; easeAmbiguous?: boolean },
+  T extends GsapPercentageKeyframe & {
+    animationId?: string;
+    tweenPercentage?: number;
+    collidingAnimationTargets?: AnimationKeyframeTarget[];
+  },
 >(keyframes: T[]): T[] {
   const byPct = new Map<number, T>();
   for (const kf of keyframes) {
     const existing = byPct.get(kf.percentage);
     if (existing) {
       existing.properties = { ...existing.properties, ...kf.properties };
-      // Two DIFFERENT source animations with a keyframe at the same clip %: a
-      // single inline ease button can only target one of them, and which one is
-      // arbitrary (each may also inherit a different easeEach/animation ease, so
-      // comparing raw keyframe eases isn't enough). Flag it so the collapsed row
-      // hides the button there and the user edits per-lane instead.
-      if (
-        existing.animationId !== undefined &&
-        kf.animationId !== undefined &&
-        existing.animationId !== kf.animationId
-      ) {
-        existing.easeAmbiguous = true;
-      }
-      // Whichever tween iterated last used to win `ease`, so the merged
-      // keyframe carried an arbitrary one of the colliding curves. Readers that
-      // do not check easeAmbiguous (drag readouts, lane hints) then showed a
-      // curve belonging to a different animation than the one an edit targets.
-      // Drop it instead: ambiguous means "no single ease", and the flag is the
-      // only honest answer.
-      if (existing.easeAmbiguous) delete existing.ease;
-      else if (kf.ease) existing.ease = kf.ease;
+      accumulateCollidingAnimationTargets(existing, kf);
+      if (kf.ease) existing.ease = kf.ease;
     } else {
       byPct.set(kf.percentage, { ...kf, properties: { ...kf.properties } });
     }
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
index 11c83585b3..14f1c18f82 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
@@ -575,7 +575,18 @@ describe("TimelineClipDiamonds", () => {
         <TimelineDiamondLane
           keyframesData={{
             format: "percentage",
-            keyframes: [kf(0), kf(50), kf(100, { easeAmbiguous: lastAmbiguous })],
+            keyframes: [
+              kf(0),
+              kf(50),
+              kf(100, {
+                collidingAnimationTargets: lastAmbiguous
+                  ? [
+                      { animationId: "anim-1", tweenPercentage: 100 },
+                      { animationId: "anim-2", tweenPercentage: 75 },
+                    ]
+                  : undefined,
+              }),
+            ],
           }}
           clipWidthPx={200}
           clipHeightPx={48}
@@ -592,15 +603,16 @@ describe("TimelineClipDiamonds", () => {
     return { host, root };
   };
 
-  it("hides the inline ease button on an ambiguous merged segment", () => {
-    // Segments 0->50 and 50->100; the 50->100 segment ends on the ambiguous
-    // keyframe, so its hover/ease-button area is not rendered.
+  it("shows the inline ease button on a colliding merged segment (bulk edit)", () => {
+    // Both segments (0->50, 50->100) render their ease button; the 50->100
+    // segment ends on a keyframe shared by two animations and the button now
+    // bulk-edits both rather than being hidden.
     const { host, root } = renderSegmentLane(true);
-    expect(host.querySelectorAll("[data-keyframe-ease-segment]").length).toBe(1);
+    expect(host.querySelectorAll("[data-keyframe-ease-segment]").length).toBe(2);
     act(() => root.unmount());
   });
 
-  it("keeps the inline ease button on unambiguous merged segments", () => {
+  it("shows the inline ease button on single-animation merged segments", () => {
     const { host, root } = renderSegmentLane(false);
     expect(host.querySelectorAll("[data-keyframe-ease-segment]").length).toBe(2);
     act(() => root.unmount());
diff --git a/packages/studio/src/player/components/TimelineDiamondConnectors.tsx b/packages/studio/src/player/components/TimelineDiamondConnectors.tsx
index a0689213dd..c6934006a5 100644
--- a/packages/studio/src/player/components/TimelineDiamondConnectors.tsx
+++ b/packages/studio/src/player/components/TimelineDiamondConnectors.tsx
@@ -55,11 +55,11 @@ export function TimelineDiamondConnectors({
         if (x2 - x1 < 1) return null;
         const connectorLeft = x1 + previous.visualSize / 2;
         const connectorWidth = x2 - x1 - previous.visualSize / 2 - marker.visualSize / 2;
-        // The ease button targets one segment, so it needs the keyframe's own
-        // animationId/tweenPercentage. On a merged inline row the button is
-        // hidden where the segment is ambiguous (two source animations collide
-        // at this % with different eases; see easeAmbiguous) or the keyframe has
-        // no source animation id (runtime-scanned) so there is no tween to target.
+        // The ease button needs the keyframe's own animationId/tweenPercentage.
+        // On a merged inline row it edits the ease of every animation colliding
+        // at this percentage at once (the collapsed row is the element's unified
+        // motion), so it is only hidden when the keyframe has no source animation
+        // id (runtime-scanned) and there is no tween to target.
         const target = keyframeTarget(kf);
         const ease = kf.ease ?? globalEase;
         return (
@@ -78,7 +78,7 @@ export function TimelineDiamondConnectors({
                 borderRadius: 1,
               }}
             />
-            {onSelectSegment && !kf.easeAmbiguous && kf.animationId !== undefined && (
+            {onSelectSegment && kf.animationId !== undefined && (
               <div
                 className="group absolute"
                 data-keyframe-ease-segment=""
diff --git a/packages/studio/src/player/components/timelineDiamondTypes.ts b/packages/studio/src/player/components/timelineDiamondTypes.ts
index d5541a4181..0e3c34bc0a 100644
--- a/packages/studio/src/player/components/timelineDiamondTypes.ts
+++ b/packages/studio/src/player/components/timelineDiamondTypes.ts
@@ -4,6 +4,7 @@
  * keyframe-identity helper live here; the rendering lives there.
  */
 import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 export interface TimelineDiamondKeyframe {
   percentage: number;
@@ -13,9 +14,8 @@ export interface TimelineDiamondKeyframe {
   animationId?: string;
   properties: Record<string, number | string>;
   ease?: string;
-  /** Set when 2+ source animations collide at this percentage (a single inline
-   *  ease button can't target one): the collapsed row hides the button here. */
-  easeAmbiguous?: boolean;
+  /** Source animation/keyframe targets that collide at this clip percentage. */
+  collidingAnimationTargets?: AnimationKeyframeTarget[];
 }
 
 interface KeyframeCacheEntry {
@@ -116,5 +116,6 @@ export function keyframeTarget(keyframe: TimelineDiamondKeyframe): TimelineKeyfr
     tweenPercentage: keyframe.tweenPercentage,
     propertyGroup: keyframe.propertyGroup,
     animationId: keyframe.animationId,
+    collidingAnimationTargets: keyframe.collidingAnimationTargets,
   };
 }
diff --git a/packages/studio/src/player/components/timelineKeyframeIdentity.ts b/packages/studio/src/player/components/timelineKeyframeIdentity.ts
index e016fe39b7..07ca0fdff0 100644
--- a/packages/studio/src/player/components/timelineKeyframeIdentity.ts
+++ b/packages/studio/src/player/components/timelineKeyframeIdentity.ts
@@ -1,8 +1,11 @@
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
+
 export interface TimelineKeyframeTarget {
   percentage: number;
   tweenPercentage?: number;
   propertyGroup?: string;
   animationId?: string;
+  collidingAnimationTargets?: AnimationKeyframeTarget[];
 }
 
 /**
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
index 0c10202dbf..4dcee4bad5 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
@@ -36,6 +36,14 @@ const FLAT_TWEEN_TARGET: TimelineKeyframeTarget = {
   animationId: "position-tween",
 };
 
+const COLLIDING_TARGET: TimelineKeyframeTarget = {
+  ...FLAT_TWEEN_TARGET,
+  collidingAnimationTargets: [
+    { animationId: "position-tween", tweenPercentage: 100 },
+    { animationId: "scale-tween", tweenPercentage: 75 },
+  ],
+};
+
 afterEach(() => {
   document.body.innerHTML = "";
   trackStudioSegmentEaseEdit.mockClear();
@@ -65,6 +73,35 @@ describe("useTimelineKeyframeHandlers", () => {
     act(() => root.unmount());
   });
 
+  it("focuses a merged segment with its colliding animation targets", () => {
+    let onSelectSegment: ((elementId: string, target: TimelineKeyframeTarget) => void) | undefined;
+
+    function Harness() {
+      ({ onSelectSegment } = useTimelineKeyframeHandlers({
+        expandedElements: [ELEMENT],
+        keyframeCache: new Map(),
+        setSelectedElementId: vi.fn(),
+        setKfContextMenu: vi.fn(),
+        toggleSelectedKeyframe: vi.fn(),
+      }));
+      return null;
+    }
+
+    const root = mountReactHarness(<Harness />);
+    act(() => onSelectSegment?.(ELEMENT.id, COLLIDING_TARGET));
+
+    expect(usePlayerStore.getState().focusedEaseSegment).toEqual({
+      animationId: "position-tween",
+      collidingAnimationTargets: [
+        { animationId: "position-tween", tweenPercentage: 100 },
+        { animationId: "scale-tween", tweenPercentage: 75 },
+      ],
+      tweenPercentage: 100,
+      elementId: ELEMENT.id,
+    });
+    act(() => root.unmount());
+  });
+
   it("focuses a flat tween segment without seeking, while keyframe clicks still seek", () => {
     const onSeek = vi.fn();
     const onSelectElement = vi.fn();
@@ -97,6 +134,7 @@ describe("useTimelineKeyframeHandlers", () => {
       tweenPercentage: 100,
       elementId: ELEMENT.id,
     });
+    expect(usePlayerStore.getState().focusedEaseSegment?.collidingAnimationTargets).toBeUndefined();
     expect(setSelectedElementId).toHaveBeenCalledWith(ELEMENT.id);
     expect(onSelectElement).toHaveBeenCalledWith(ELEMENT);
 
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
index 2d18bace17..657aac930a 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
@@ -65,6 +65,7 @@ export function useTimelineKeyframeHandlers({
       if (target.animationId !== undefined && target.tweenPercentage !== undefined) {
         usePlayerStore.getState().setFocusedEaseSegment({
           animationId: target.animationId,
+          collidingAnimationTargets: target.collidingAnimationTargets,
           tweenPercentage: target.tweenPercentage,
           elementId: elId,
         });
diff --git a/packages/studio/src/player/store/keyframeSlice.ts b/packages/studio/src/player/store/keyframeSlice.ts
index 7a97d986ce..9ee447e62d 100644
--- a/packages/studio/src/player/store/keyframeSlice.ts
+++ b/packages/studio/src/player/store/keyframeSlice.ts
@@ -1,5 +1,6 @@
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import type { StoreApi } from "zustand";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 /** Minimal keyframe cache types — mirrors GsapKeyframesData without pulling in Node-only gsap-parser. */
 export interface KeyframeCacheEntry {
@@ -14,9 +15,8 @@ export interface KeyframeCacheEntry {
     animationId?: string;
     properties: Record<string, number | string>;
     ease?: string;
-    /** Set when 2+ source animations collide at this percentage (a single inline
-     *  ease button can't target one): the collapsed row hides the button here. */
-    easeAmbiguous?: boolean;
+    /** Source animation/keyframe targets that collide at this clip percentage. */
+    collidingAnimationTargets?: AnimationKeyframeTarget[];
   }>;
   ease?: string;
   easeEach?: string;
@@ -37,9 +37,19 @@ export interface KeyframeSlice {
 
   /** elementId scopes the request to one element so a shared (class-selector)
    * animation id can't open the ease editor on the wrong element. */
-  focusedEaseSegment: { animationId: string; tweenPercentage: number; elementId: string } | null;
+  focusedEaseSegment: {
+    animationId: string;
+    collidingAnimationTargets?: AnimationKeyframeTarget[];
+    tweenPercentage: number;
+    elementId: string;
+  } | null;
   setFocusedEaseSegment: (
-    target: { animationId: string; tweenPercentage: number; elementId: string } | null,
+    target: {
+      animationId: string;
+      collidingAnimationTargets?: AnimationKeyframeTarget[];
+      tweenPercentage: number;
+      elementId: string;
+    } | null,
   ) => void;
 
   /** Keyframe data per element id, populated from parsed GSAP animations. */

From 463429b973a3468c391cdd8c83d301b3f154183b Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 18:33:09 +0200
Subject: [PATCH 102/125] feat(studio): bulk-edit easing for merged keyframes

---
 .../src/components/StudioRightPanel.tsx       |   3 +-
 .../components/editor/AnimationCard.test.tsx  | 200 ++++++++++++++++--
 .../src/components/editor/AnimationCard.tsx   |  27 ++-
 .../editor/EaseCurveSection.test.tsx          |  38 +++-
 .../components/editor/EaseCurveSection.tsx    |   8 +
 .../editor/GsapAnimationSection.test.tsx      | 102 +++++++++
 .../editor/GsapAnimationSection.tsx           |   7 +-
 .../components/editor/KeyframeEaseList.tsx    |   4 +
 .../src/components/editor/PropertyPanel.tsx   |   3 +
 .../components/editor/PropertyPanelFlat.tsx   |   3 +
 .../editor/gsapAnimationCallbacks.test.ts     |   3 +
 .../editor/gsapAnimationCallbacks.ts          |   3 +
 .../propertyPanelFlatMotionSection.test.tsx   |  67 ++++++
 .../components/editor/propertyPanelTypes.ts   |   2 +
 .../studio/src/contexts/DomEditContext.tsx    |   4 +
 packages/studio/src/hooks/gsapTweenSynth.ts   |   2 +-
 .../src/hooks/useDomEditSession.test.tsx      | 142 ++++++++++++-
 .../studio/src/hooks/useDomEditSession.ts     |  56 +++--
 18 files changed, 622 insertions(+), 52 deletions(-)
 create mode 100644 packages/studio/src/components/editor/GsapAnimationSection.test.tsx

diff --git a/packages/studio/src/components/StudioRightPanel.tsx b/packages/studio/src/components/StudioRightPanel.tsx
index fc96e3605c..02437e7001 100644
--- a/packages/studio/src/components/StudioRightPanel.tsx
+++ b/packages/studio/src/components/StudioRightPanel.tsx
@@ -19,7 +19,6 @@ import type { EditHistoryKind } from "../utils/editHistory";
 import { useSlideshowPersist, type UseSlideshowPersistParams } from "../hooks/useSlideshowPersist";
 import { useSlideshowTabState } from "../hooks/useSlideshowTabState";
 import { DesignPanelPromoteProvider } from "./DesignPanelPromoteProvider";
-
 import { useStudioPlaybackContext, useStudioShellContext } from "../contexts/StudioContext";
 import { usePanelLayoutContext } from "../contexts/PanelLayoutContext";
 import { useFileManagerContext } from "../contexts/FileManagerContext";
@@ -156,6 +155,7 @@ export function StudioRightPanel({
     handleUpdateArcSegment,
     handleUnroll,
     handleUpdateKeyframeEase,
+    handleUpdateSegmentEase,
     handleSetAllKeyframeEases,
     handleGsapAddKeyframe,
     handleGsapRemoveKeyframe,
@@ -406,6 +406,7 @@ export function StudioRightPanel({
         onUnroll={handleUnroll}
         onUpdateKeyframeEase={handleUpdateKeyframeEase}
         onSetAllKeyframeEases={handleSetAllKeyframeEases}
+        onUpdateSegmentEase={handleUpdateSegmentEase}
         recordingState={recordingState}
         recordingDuration={recordingDuration}
         onToggleRecording={onToggleRecording}
diff --git a/packages/studio/src/components/editor/AnimationCard.test.tsx b/packages/studio/src/components/editor/AnimationCard.test.tsx
index ea51978c9a..19b455724f 100644
--- a/packages/studio/src/components/editor/AnimationCard.test.tsx
+++ b/packages/studio/src/components/editor/AnimationCard.test.tsx
@@ -2,34 +2,88 @@
 
 import React, { act } from "react";
 import { createRoot } from "react-dom/client";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { AnimationCard } from "./AnimationCard";
-import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { EASE_PRESETS } from "./easePresetLibrary";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 const trackStudioSegmentEaseEdit = vi.hoisted(() => vi.fn());
 vi.mock("../../telemetry/events", () => ({ trackStudioSegmentEaseEdit }));
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
+const ANIMATION: GsapAnimation = {
+  id: "position-tween",
+  targetSelector: "#clip-1",
+  method: "to",
+  position: 0,
+  duration: 2,
+  ease: "power1.out",
+  properties: { x: 200 },
+  keyframes: {
+    format: "percentage",
+    keyframes: [
+      { percentage: 0, properties: { x: 0 } },
+      { percentage: 50, properties: { x: 100 } },
+      { percentage: 100, properties: { x: 200 } },
+    ],
+  },
+};
+
+const FLAT_ANIMATION: GsapAnimation = {
+  ...ANIMATION,
+  id: "flat-position-tween",
+  keyframes: undefined,
+};
+
 afterEach(() => {
   document.body.innerHTML = "";
   trackStudioSegmentEaseEdit.mockClear();
 });
 
-function baseAnimation(overrides: Partial<GsapAnimation> = {}): GsapAnimation {
-  return {
-    id: "anim-1",
-    method: "to",
-    position: 0.8,
-    duration: 1.2,
-    ease: "power2.out",
-    properties: { opacity: 1 },
-    ...overrides,
-  } as GsapAnimation;
+function renderFocusCard(
+  focusedSegment: {
+    tweenPercentage: number;
+    collidingAnimationTargets?: AnimationKeyframeTarget[];
+  } | null,
+  onEaseCommit = vi.fn(),
+  defaultExpanded = false,
+  animation = ANIMATION,
+  onUpdateMeta = vi.fn(),
+  onUpdateSegmentEase = vi.fn(),
+) {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  const render = (nextFocusedSegment: { tweenPercentage: number } | null) => {
+    act(() => {
+      root.render(
+        <AnimationCard
+          animation={animation}
+          defaultExpanded={defaultExpanded}
+          focusedSegment={nextFocusedSegment}
+          onFocusSegmentConsumed={vi.fn()}
+          onUpdateProperty={vi.fn()}
+          onUpdateMeta={onUpdateMeta}
+          onDeleteAnimation={vi.fn()}
+          onAddProperty={vi.fn()}
+          onRemoveProperty={vi.fn()}
+          onUpdateKeyframeEase={onEaseCommit}
+          onUpdateSegmentEase={onUpdateSegmentEase}
+        />,
+      );
+    });
+  };
+  render(focusedSegment);
+  return { host, root, render };
 }
 
-const noop = () => {};
+function findButton(host: HTMLElement, text: string): HTMLButtonElement | undefined {
+  return Array.from(host.querySelectorAll("button")).find((button) =>
+    button.textContent?.includes(text),
+  );
+}
 
 function selectPreset(host: HTMLElement, presetId: string): string {
   const presetConfig = EASE_PRESETS.find((candidate) => candidate.id === presetId);
@@ -45,6 +99,8 @@ function selectPreset(host: HTMLElement, presetId: string): string {
   return presetConfig.ease;
 }
 
+const noop = () => {};
+
 /** Every test mounts the same card; only expansion, flat mode, and the spies differ. */
 function renderCard({
   animation = baseAnimation(),
@@ -82,6 +138,126 @@ function renderCard({
   return { host, root };
 }
 
+function restoreScrollIntoView(descriptor: PropertyDescriptor | undefined): void {
+  if (descriptor) Object.defineProperty(HTMLElement.prototype, "scrollIntoView", descriptor);
+  else Reflect.deleteProperty(HTMLElement.prototype, "scrollIntoView");
+}
+
+describe("AnimationCard", () => {
+  it("scrolls a focused segment into view but not a manually toggled segment", () => {
+    const originalScrollIntoView = Object.getOwnPropertyDescriptor(
+      HTMLElement.prototype,
+      "scrollIntoView",
+    );
+    const scrollIntoView = vi.fn();
+    Object.defineProperty(HTMLElement.prototype, "scrollIntoView", {
+      configurable: true,
+      value: scrollIntoView,
+    });
+
+    const view = renderFocusCard({ tweenPercentage: 50 });
+    try {
+      expect(scrollIntoView).toHaveBeenCalledOnce();
+      expect(scrollIntoView).toHaveBeenCalledWith({ block: "nearest", behavior: "smooth" });
+
+      view.render(null);
+      const manualToggle = findButton(view.host, "50% → 100%");
+      expect(manualToggle).toBeDefined();
+      act(() => manualToggle?.click());
+      expect(scrollIntoView).toHaveBeenCalledOnce();
+    } finally {
+      act(() => view.root.unmount());
+      restoreScrollIntoView(originalScrollIntoView);
+    }
+  });
+
+  it("tracks a committed segment ease alongside the existing update", () => {
+    const onEaseCommit = vi.fn();
+    const view = renderFocusCard(null, onEaseCommit, true);
+    const segment = findButton(view.host, "0% → 50%");
+    expect(segment).toBeDefined();
+    act(() => segment?.click());
+    const ease = selectPreset(view.host, "quad-out");
+
+    expect(onEaseCommit).toHaveBeenCalledWith(ANIMATION.id, 50, ease);
+    expect(trackStudioSegmentEaseEdit).toHaveBeenCalledWith({ action: "commit", ease });
+    act(() => view.root.unmount());
+  });
+
+  it("commits a focused multi-id segment ease through the bulk callback", () => {
+    const onUpdateKeyframeEase = vi.fn();
+    const onUpdateSegmentEase = vi.fn();
+    const collidingAnimationTargets = [
+      { animationId: ANIMATION.id, tweenPercentage: 50 },
+      { animationId: "scale-tween", tweenPercentage: 75 },
+      { animationId: "opacity-tween", tweenPercentage: 25 },
+    ];
+    const view = renderFocusCard(
+      { tweenPercentage: 50, collidingAnimationTargets },
+      onUpdateKeyframeEase,
+      false,
+      ANIMATION,
+      vi.fn(),
+      onUpdateSegmentEase,
+    );
+    const ease = selectPreset(view.host, "quad-out");
+
+    expect(onUpdateSegmentEase).toHaveBeenCalledExactlyOnceWith(collidingAnimationTargets, ease);
+    expect(onUpdateKeyframeEase).not.toHaveBeenCalled();
+    act(() => view.root.unmount());
+  });
+
+  it("keeps a focused single-id segment ease on the single callback", () => {
+    const onUpdateKeyframeEase = vi.fn();
+    const onUpdateSegmentEase = vi.fn();
+    const view = renderFocusCard(
+      {
+        tweenPercentage: 50,
+        collidingAnimationTargets: [{ animationId: ANIMATION.id, tweenPercentage: 50 }],
+      },
+      onUpdateKeyframeEase,
+      false,
+      ANIMATION,
+      vi.fn(),
+      onUpdateSegmentEase,
+    );
+
+    const ease = selectPreset(view.host, "quad-out");
+
+    expect(onUpdateKeyframeEase).toHaveBeenCalledExactlyOnceWith(ANIMATION.id, 50, ease);
+    expect(onUpdateSegmentEase).not.toHaveBeenCalled();
+    act(() => view.root.unmount());
+  });
+
+  it("commits a focused flat tween segment ease through tween metadata", () => {
+    const onUpdateMeta = vi.fn();
+    const onUpdateKeyframeEase = vi.fn();
+    const view = renderFocusCard(
+      { tweenPercentage: 100 },
+      onUpdateKeyframeEase,
+      false,
+      FLAT_ANIMATION,
+      onUpdateMeta,
+    );
+    const ease = selectPreset(view.host, "quad-out");
+
+    expect(onUpdateMeta).toHaveBeenCalledExactlyOnceWith(FLAT_ANIMATION.id, { ease });
+    expect(onUpdateKeyframeEase).not.toHaveBeenCalled();
+    act(() => view.root.unmount());
+  });
+});
+
+function baseAnimation(overrides: Partial<GsapAnimation> = {}): GsapAnimation {
+  return {
+    id: "anim-1",
+    method: "to",
+    position: 0.8,
+    duration: 1.2,
+    ease: "power2.out",
+    properties: { opacity: 1 },
+    ...overrides,
+  } as GsapAnimation;
+}
 describe("AnimationCard ease editing", () => {
   it("commits one preset change to the selected keyframe segment", () => {
     const onUpdateKeyframeEase = vi.fn();
diff --git a/packages/studio/src/components/editor/AnimationCard.tsx b/packages/studio/src/components/editor/AnimationCard.tsx
index 0f071d3016..97e4a4f5b7 100644
--- a/packages/studio/src/components/editor/AnimationCard.tsx
+++ b/packages/studio/src/components/editor/AnimationCard.tsx
@@ -18,12 +18,16 @@ import {
   parseNumericOrString,
   BOOLEAN_PROPS,
 } from "./AnimationCardParts";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 interface AnimationCardProps extends GsapAnimationEditCallbacks {
   animation: GsapAnimation;
   defaultExpanded: boolean;
   flat?: boolean;
-  focusedSegment?: { tweenPercentage: number } | null;
+  focusedSegment?: {
+    tweenPercentage: number;
+    collidingAnimationTargets?: AnimationKeyframeTarget[];
+  } | null;
   onFocusSegmentConsumed?: () => void;
 }
 
@@ -47,6 +51,7 @@ export const AnimationCard = memo(function AnimationCard({
   onSetArcPath,
   onUpdateArcSegment,
   onUpdateKeyframeEase,
+  onUpdateSegmentEase,
   onSetAllKeyframeEases,
   onUnroll,
 }: AnimationCardProps) {
@@ -54,6 +59,9 @@ export const AnimationCard = memo(function AnimationCard({
   const [addingProp, setAddingProp] = useState(false);
   const [addingFromProp, setAddingFromProp] = useState(false);
   const [expandedKfPct, setExpandedKfPct] = useState<number | null>(null);
+  const [focusedCollidingAnimationTargets, setFocusedCollidingAnimationTargets] = useState<
+    AnimationKeyframeTarget[] | undefined
+  >();
   const cardRef = useRef<HTMLDivElement>(null);
   const pendingAutoScrollRef = useRef(false);
 
@@ -62,6 +70,7 @@ export const AnimationCard = memo(function AnimationCard({
     setExpanded(true);
     pendingAutoScrollRef.current = true;
     setExpandedKfPct(focusedSegment.tweenPercentage);
+    setFocusedCollidingAnimationTargets(focusedSegment.collidingAnimationTargets);
     onFocusSegmentConsumed?.();
   }, [focusedSegment, onFocusSegmentConsumed]);
 
@@ -288,9 +297,21 @@ export const AnimationCard = memo(function AnimationCard({
                     keyframes={animation.keyframes.keyframes}
                     globalEase={animation.keyframes.easeEach ?? animation.ease ?? "none"}
                     expandedPct={expandedKfPct}
-                    onToggle={setExpandedKfPct}
+                    collidingAnimationTargets={focusedCollidingAnimationTargets}
+                    onToggle={(pct) => {
+                      setExpandedKfPct(pct);
+                      setFocusedCollidingAnimationTargets(undefined);
+                    }}
                     onEaseCommit={(pct, ease) => {
-                      onUpdateKeyframeEase(animation.id, pct, ease);
+                      if (
+                        focusedCollidingAnimationTargets &&
+                        focusedCollidingAnimationTargets.length > 1 &&
+                        onUpdateSegmentEase
+                      ) {
+                        onUpdateSegmentEase(focusedCollidingAnimationTargets, ease);
+                      } else {
+                        onUpdateKeyframeEase(animation.id, pct, ease);
+                      }
                       trackStudioSegmentEaseEdit({ action: "commit", ease });
                     }}
                     onApplyAll={
diff --git a/packages/studio/src/components/editor/EaseCurveSection.test.tsx b/packages/studio/src/components/editor/EaseCurveSection.test.tsx
index f25aac0c31..0cb7879335 100644
--- a/packages/studio/src/components/editor/EaseCurveSection.test.tsx
+++ b/packages/studio/src/components/editor/EaseCurveSection.test.tsx
@@ -4,6 +4,7 @@ import React, { act, useState } from "react";
 import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { EaseCurveSection, MiniCurveSvg } from "./EaseCurveSection";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
@@ -11,12 +12,22 @@ afterEach(() => {
   document.body.innerHTML = "";
 });
 
-function renderSection(ease = "none", onCustomEaseCommit = vi.fn()) {
+function renderSection(
+  ease = "none",
+  onCustomEaseCommit = vi.fn(),
+  collidingAnimationTargets?: AnimationKeyframeTarget[],
+) {
   const host = document.createElement("div");
   document.body.append(host);
   const root = createRoot(host);
   act(() => {
-    root.render(<EaseCurveSection ease={ease} onCustomEaseCommit={onCustomEaseCommit} />);
+    root.render(
+      <EaseCurveSection
+        ease={ease}
+        onCustomEaseCommit={onCustomEaseCommit}
+        collidingAnimationTargets={collidingAnimationTargets}
+      />,
+    );
   });
   return { host, root, onCustomEaseCommit };
 }
@@ -82,6 +93,29 @@ function editorLabel(host: HTMLElement): string | null {
 }
 
 describe("EaseCurveSection preset grid", () => {
+  it("shows the number of properties for a multi-id segment", () => {
+    const { host, root } = renderSection("power2.out", vi.fn(), [
+      { animationId: "move-x", tweenPercentage: 20 },
+      { animationId: "move-y", tweenPercentage: 50 },
+      { animationId: "fade", tweenPercentage: 80 },
+    ]);
+
+    expect(host.textContent).toContain("Applies to 3 properties");
+
+    act(() => root.unmount());
+  });
+
+  it.each([undefined, [{ animationId: "move-x", tweenPercentage: 20 }]])(
+    "does not show a property count for a non-colliding segment",
+    (collidingAnimationTargets) => {
+      const { host, root } = renderSection("power2.out", vi.fn(), collidingAnimationTargets);
+
+      expect(host.textContent).not.toContain("Applies to");
+
+      act(() => root.unmount());
+    },
+  );
+
   it.each([
     ["curve", "none", "linear", ["flow-7", "spring-bouncy"]],
     ["spring", "spring(0.42)", "spring-bouncy", ["linear", "flow-7"]],
diff --git a/packages/studio/src/components/editor/EaseCurveSection.tsx b/packages/studio/src/components/editor/EaseCurveSection.tsx
index 015ec6b5a1..a59fa957cb 100644
--- a/packages/studio/src/components/editor/EaseCurveSection.tsx
+++ b/packages/studio/src/components/editor/EaseCurveSection.tsx
@@ -10,6 +10,7 @@ import { holdCurvePath, MiniCurveSvg, sampledPath } from "./easeCurveSvg";
 import { EaseBezierField, SpringBounceField, WiggleField } from "./EaseParamFields";
 import { EASE_CURVES, EASE_LABELS, resolveEaseCurveTuple } from "./gsapAnimationConstants";
 import { roundToCenti } from "../../utils/rounding";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 export { MiniCurveSvg } from "./easeCurveSvg";
 
@@ -323,9 +324,11 @@ function EaseParameterField({
 export function EaseCurveSection({
   ease,
   onCustomEaseCommit,
+  collidingAnimationTargets,
 }: {
   ease: string;
   onCustomEaseCommit: (ease: string) => void;
+  collidingAnimationTargets?: AnimationKeyframeTarget[];
 }) {
   const springBounce = parseSpringBounce(ease);
   const isSpring = springBounce !== null;
@@ -419,6 +422,11 @@ export function EaseCurveSection({
   return (
     <div className="rounded-lg bg-neutral-900/50 p-2">
       <EaseTypeDropdown kind={mode} ease={ease} label={label} onSelect={onCustomEaseCommit} />
+      {collidingAnimationTargets && collidingAnimationTargets.length > 1 && (
+        <p className="mb-1 text-[9px] text-neutral-500">
+          Applies to {collidingAnimationTargets.length} properties
+        </p>
+      )}
       <EaseModeToggle mode={mode} onCommit={onCustomEaseCommit} />
       <span className="sr-only" aria-live="polite">
         {MODE_LABELS[mode]} ease editor selected
diff --git a/packages/studio/src/components/editor/GsapAnimationSection.test.tsx b/packages/studio/src/components/editor/GsapAnimationSection.test.tsx
new file mode 100644
index 0000000000..7d299e158a
--- /dev/null
+++ b/packages/studio/src/components/editor/GsapAnimationSection.test.tsx
@@ -0,0 +1,102 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import { DesignPanelInputProvider } from "../../contexts/DesignPanelInputContext";
+import { usePlayerStore } from "../../player";
+import { GsapAnimationSection } from "./GsapAnimationSection";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+vi.mock("./AnimationCard", () => ({
+  AnimationCard: ({
+    animation,
+    focusedSegment,
+    onFocusSegmentConsumed,
+  }: {
+    animation: GsapAnimation;
+    focusedSegment: { tweenPercentage: number } | null;
+    onFocusSegmentConsumed: () => void;
+  }) => (
+    <button
+      type="button"
+      data-testid={`animation-${animation.id}`}
+      data-focused={focusedSegment ? String(focusedSegment.tweenPercentage) : ""}
+      // Mirrors the real card: the consume callback only fires from the effect
+      // that runs when this card actually received a focusedSegment.
+      onClick={() => focusedSegment && onFocusSegmentConsumed()}
+    />
+  ),
+}));
+
+vi.mock("./GsapAddAnimationControl", () => ({ GsapAddAnimationControl: () => null }));
+
+afterEach(() => {
+  document.body.innerHTML = "";
+  usePlayerStore.getState().reset();
+});
+
+const sharedAnimation: GsapAnimation = {
+  id: "shared-animation",
+  targetSelector: ".shared",
+  method: "to",
+  position: 0,
+  properties: { x: 100 },
+};
+
+const requiredCallbacks = {
+  onAddAnimation: vi.fn(),
+  onUpdateProperty: vi.fn(),
+  onUpdateMeta: vi.fn(),
+  onDeleteAnimation: vi.fn(),
+  onAddProperty: vi.fn(),
+  onRemoveProperty: vi.fn(),
+};
+
+function renderSection(elementId: string) {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  const render = (nextElementId: string) => {
+    act(() => {
+      root.render(
+        <DesignPanelInputProvider section="test">
+          <GsapAnimationSection
+            {...requiredCallbacks}
+            elementId={nextElementId}
+            animations={[sharedAnimation]}
+          />
+        </DesignPanelInputProvider>,
+      );
+    });
+  };
+  render(elementId);
+  return { host, root, render };
+}
+
+describe("GsapAnimationSection", () => {
+  it("consumes a shared animation id only for the focused element", () => {
+    usePlayerStore.getState().setFocusedEaseSegment({
+      elementId: "index.html#second",
+      animationId: sharedAnimation.id,
+      tweenPercentage: 50,
+    });
+    const view = renderSection("index.html#first");
+    const card = view.host.querySelector<HTMLButtonElement>(
+      "[data-testid='animation-shared-animation']",
+    );
+    if (!card) throw new Error("expected animation card");
+
+    expect(card.dataset.focused).toBe("");
+    act(() => card.click());
+    expect(usePlayerStore.getState().focusedEaseSegment?.elementId).toBe("index.html#second");
+
+    view.render("index.html#second");
+    expect(card.dataset.focused).toBe("50");
+    act(() => card.click());
+    expect(usePlayerStore.getState().focusedEaseSegment).toBeNull();
+    act(() => view.root.unmount());
+  });
+});
diff --git a/packages/studio/src/components/editor/GsapAnimationSection.tsx b/packages/studio/src/components/editor/GsapAnimationSection.tsx
index 2ced7b6a8e..13e2d2758a 100644
--- a/packages/studio/src/components/editor/GsapAnimationSection.tsx
+++ b/packages/studio/src/components/editor/GsapAnimationSection.tsx
@@ -13,6 +13,7 @@ import { usePlayerStore } from "../../player";
 import { GsapAddAnimationControl } from "./GsapAddAnimationControl";
 
 interface GsapAnimationSectionProps extends GsapAnimationEditCallbacks {
+  elementId: string;
   animations: GsapAnimation[];
   multipleTimelines?: boolean;
   unsupportedTimelinePattern?: boolean;
@@ -21,6 +22,7 @@ interface GsapAnimationSectionProps extends GsapAnimationEditCallbacks {
 
 export const GsapAnimationSection = memo(function GsapAnimationSection({
   animations,
+  elementId,
   multipleTimelines,
   unsupportedTimelinePattern,
   onAddAnimation,
@@ -55,7 +57,10 @@ export const GsapAnimationSection = memo(function GsapAnimationSection({
               animation={anim}
               defaultExpanded={index === 0}
               focusedSegment={
-                focusedEaseSegment?.animationId === anim.id ? focusedEaseSegment : null
+                focusedEaseSegment?.elementId === elementId &&
+                focusedEaseSegment.animationId === anim.id
+                  ? focusedEaseSegment
+                  : null
               }
               onFocusSegmentConsumed={clearFocusedEaseSegment}
             />
diff --git a/packages/studio/src/components/editor/KeyframeEaseList.tsx b/packages/studio/src/components/editor/KeyframeEaseList.tsx
index 9e53dd6118..ea940efc88 100644
--- a/packages/studio/src/components/editor/KeyframeEaseList.tsx
+++ b/packages/studio/src/components/editor/KeyframeEaseList.tsx
@@ -1,6 +1,7 @@
 import type { GsapPercentageKeyframe } from "@hyperframes/core/gsap-parser";
 import { EASE_LABELS } from "./gsapAnimationConstants";
 import { EaseCurveSection } from "./EaseCurveSection";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 // The full GSAP easing vocabulary offered by the "Set all…" bulk control —
 // every standard family in in/out/inOut, so authors aren't limited to a curated
@@ -44,6 +45,7 @@ export function KeyframeEaseList({
   keyframes,
   globalEase,
   expandedPct,
+  collidingAnimationTargets,
   onToggle,
   onEaseCommit,
   onApplyAll,
@@ -51,6 +53,7 @@ export function KeyframeEaseList({
   keyframes: GsapPercentageKeyframe[];
   globalEase: string;
   expandedPct: number | null;
+  collidingAnimationTargets?: AnimationKeyframeTarget[];
   onToggle: (pct: number | null) => void;
   onEaseCommit: (pct: number, ease: string) => void;
   /** Apply one ease to every segment at once (clears per-segment overrides). */
@@ -119,6 +122,7 @@ export function KeyframeEaseList({
               <div className="px-2 pb-2">
                 <EaseCurveSection
                   ease={segEase}
+                  collidingAnimationTargets={collidingAnimationTargets}
                   onCustomEaseCommit={(ease) => onEaseCommit(kf.percentage, ease)}
                 />
               </div>
diff --git a/packages/studio/src/components/editor/PropertyPanel.tsx b/packages/studio/src/components/editor/PropertyPanel.tsx
index 0c9905e806..f95dbcca1f 100644
--- a/packages/studio/src/components/editor/PropertyPanel.tsx
+++ b/packages/studio/src/components/editor/PropertyPanel.tsx
@@ -101,6 +101,7 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
     onUpdateArcSegment,
     onUnroll,
     onUpdateKeyframeEase,
+    onUpdateSegmentEase,
     onSetAllKeyframeEases,
     onAddKeyframe,
     onRemoveKeyframe,
@@ -560,6 +561,7 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
           onAddGsapProperty &&
           onAddGsapAnimation && (
             <GsapAnimationSection
+              elementId={`${element.sourceFile || "index.html"}#${element.id}`}
               animations={gsapAnimations}
               multipleTimelines={gsapMultipleTimelines}
               unsupportedTimelinePattern={gsapUnsupportedTimelinePattern}
@@ -577,6 +579,7 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
               onUnroll={onUnroll}
               onUpdateKeyframeEase={onUpdateKeyframeEase}
               onSetAllKeyframeEases={onSetAllKeyframeEases}
+              onUpdateSegmentEase={onUpdateSegmentEase}
             />
           )}
 
diff --git a/packages/studio/src/components/editor/PropertyPanelFlat.tsx b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
index 8947135233..00949baf8b 100644
--- a/packages/studio/src/components/editor/PropertyPanelFlat.tsx
+++ b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
@@ -135,6 +135,7 @@ export function PropertyPanelFlat({
   onUpdateArcSegment,
   onUnroll,
   onUpdateKeyframeEase,
+  onUpdateSegmentEase,
   onSetAllKeyframeEases,
 }: Pick<
   PropertyPanelProps,
@@ -180,6 +181,7 @@ export function PropertyPanelFlat({
   | "onUnroll"
   | "onUpdateKeyframeEase"
   | "onSetAllKeyframeEases"
+  | "onUpdateSegmentEase"
   | "recordingState"
   | "recordingDuration"
   | "onToggleRecording"
@@ -330,6 +332,7 @@ export function PropertyPanelFlat({
           onUpdateArcSegment,
           onUnroll,
           onUpdateKeyframeEase,
+          onUpdateSegmentEase,
           onSetAllKeyframeEases,
         }
       : null;
diff --git a/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts b/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
index b68a1072a5..1707b92c00 100644
--- a/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
+++ b/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
@@ -24,9 +24,11 @@ describe("withTrackedGsapAnimationCallbacks", () => {
     const callbacks = requiredCallbacks();
     const onLivePreview = vi.fn();
     const onLivePreviewEnd = vi.fn();
+    const onUpdateSegmentEase = vi.fn();
     callbacks.onLivePreview = onLivePreview;
     callbacks.onLivePreviewEnd = onLivePreviewEnd;
 
+    callbacks.onUpdateSegmentEase = onUpdateSegmentEase;
     const tracked = withTrackedGsapAnimationCallbacks(callbacks, vi.fn());
 
     expect(tracked.onUpdateFromProperty).toBeUndefined();
@@ -39,6 +41,7 @@ describe("withTrackedGsapAnimationCallbacks", () => {
     expect(tracked.onUnroll).toBeUndefined();
     expect(tracked.onLivePreview).toBe(onLivePreview);
     expect(tracked.onLivePreviewEnd).toBe(onLivePreviewEnd);
+    expect(tracked.onUpdateSegmentEase).toBe(onUpdateSegmentEase);
   });
 
   it("tracks each edit once before invoking its mutation callback", () => {
diff --git a/packages/studio/src/components/editor/gsapAnimationCallbacks.ts b/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
index bc5d783569..fa12105dc8 100644
--- a/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
+++ b/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
@@ -1,5 +1,6 @@
 import type { ArcPathSegment } from "@hyperframes/parsers/gsap-parser";
 import { usePlayerStore } from "../../player";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 /**
  * Edit callbacks shared by GsapAnimationSection and each AnimationCard it
@@ -30,6 +31,7 @@ export interface GsapAnimationEditCallbacks {
     update: Partial<ArcPathSegment>,
   ) => void;
   onUpdateKeyframeEase?: (animationId: string, percentage: number, ease: string) => void;
+  onUpdateSegmentEase?: (targets: AnimationKeyframeTarget[], ease: string) => void;
   /** Apply one ease to every keyframe segment at once (clears per-segment overrides). */
   onSetAllKeyframeEases?: (animationId: string, ease: string) => void;
   /** Unroll a computed (helper/loop) tween into literal tweens so it edits directly. */
@@ -122,6 +124,7 @@ export function withTrackedGsapAnimationCallbacks(
       : undefined,
     onLivePreview: callbacks.onLivePreview,
     onLivePreviewEnd: callbacks.onLivePreviewEnd,
+    onUpdateSegmentEase: callbacks.onUpdateSegmentEase,
     onSetArcPath: callbacks.onSetArcPath
       ? (animationId, config) => {
           track("toggle", config.autoRotate !== undefined ? "Auto rotate" : "Arc motion");
diff --git a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.test.tsx b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.test.tsx
index 60eb2458af..fa14727290 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.test.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.test.tsx
@@ -5,12 +5,14 @@ import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { FlatMotionSection, FlatTimingRow } from "./propertyPanelFlatMotionSection";
 import type { DomEditSelection } from "./domEditing";
+import { usePlayerStore } from "../../player";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
 afterEach(() => {
   document.body.innerHTML = "";
 });
+usePlayerStore.getState().reset();
 
 function baseElement(overrides: Partial<DomEditSelection> = {}): DomEditSelection {
   return {
@@ -270,3 +272,68 @@ describe("FlatMotionSection", () => {
     act(() => root.unmount());
   });
 });
+
+it("forwards focused bulk segment easing through the flat animation card", () => {
+  const onUpdateKeyframeEase = vi.fn();
+  const onUpdateSegmentEase = vi.fn();
+  usePlayerStore.setState({
+    focusedEaseSegment: {
+      elementId: "index.html#hero",
+      animationId: "a1",
+      tweenPercentage: 50,
+      collidingAnimationTargets: [
+        { animationId: "a1", tweenPercentage: 50 },
+        { animationId: "a2", tweenPercentage: 75 },
+      ],
+    },
+  });
+  const { host, root } = renderInto(
+    <FlatMotionSection
+      element={baseElement()}
+      animations={[
+        {
+          id: "a1",
+          method: "to",
+          position: 0,
+          duration: 1,
+          properties: { x: 100 },
+          keyframes: {
+            format: "percentage",
+            keyframes: [
+              { percentage: 0, properties: { x: 0 } },
+              { percentage: 50, properties: { x: 100 } },
+            ],
+          },
+        } as never,
+      ]}
+      showTiming={false}
+      showEffects
+      onSetAttribute={vi.fn()}
+      onAddAnimation={vi.fn()}
+      onUpdateProperty={vi.fn()}
+      onUpdateMeta={vi.fn()}
+      onDeleteAnimation={vi.fn()}
+      onAddProperty={vi.fn()}
+      onRemoveProperty={vi.fn()}
+      onUpdateKeyframeEase={onUpdateKeyframeEase}
+      onUpdateSegmentEase={onUpdateSegmentEase}
+    />,
+  );
+
+  const dropdown = host.querySelector<HTMLButtonElement>("[data-ease-type-dropdown]");
+  expect(dropdown).not.toBeNull();
+  act(() => dropdown?.click());
+  const preset = host.querySelector<HTMLButtonElement>('[data-ease-preset-id="quad-out"]');
+  expect(preset).not.toBeNull();
+  act(() => preset?.click());
+
+  expect(onUpdateSegmentEase).toHaveBeenCalledExactlyOnceWith(
+    [
+      { animationId: "a1", tweenPercentage: 50 },
+      { animationId: "a2", tweenPercentage: 75 },
+    ],
+    "power2.out",
+  );
+  expect(onUpdateKeyframeEase).not.toHaveBeenCalled();
+  act(() => root.unmount());
+});
diff --git a/packages/studio/src/components/editor/propertyPanelTypes.ts b/packages/studio/src/components/editor/propertyPanelTypes.ts
index e50a011c4b..4bb9ed6c10 100644
--- a/packages/studio/src/components/editor/propertyPanelTypes.ts
+++ b/packages/studio/src/components/editor/propertyPanelTypes.ts
@@ -2,6 +2,7 @@ import type { RefObject } from "react";
 import type { ArcPathSegment, GsapAnimation } from "@hyperframes/parsers/gsap-parser";
 import type { DomEditSelection } from "./domEditing";
 import type { ImportedFontAsset } from "./fontAssets";
+import type { GsapAnimationEditCallbacks } from "./gsapAnimationCallbacks";
 
 export interface BackgroundRemovalProgress {
   status: "processing" | "complete" | "failed";
@@ -123,6 +124,7 @@ export interface PropertyPanelProps {
   onRemoveKeyframe?: (animationId: string, percentage: number) => void;
   onUpdateKeyframeEase?: (animationId: string, percentage: number, ease: string) => void;
   onSetAllKeyframeEases?: (animationId: string, ease: string) => void;
+  onUpdateSegmentEase?: NonNullable<GsapAnimationEditCallbacks["onUpdateSegmentEase"]>;
   onConvertToKeyframes?: (animationId: string, duration?: number) => void;
   onCommitAnimatedProperty?: (
     selection: DomEditSelection,
diff --git a/packages/studio/src/contexts/DomEditContext.tsx b/packages/studio/src/contexts/DomEditContext.tsx
index 37d461608a..53a9039e5f 100644
--- a/packages/studio/src/contexts/DomEditContext.tsx
+++ b/packages/studio/src/contexts/DomEditContext.tsx
@@ -71,6 +71,7 @@ export interface DomEditActionsValue extends Pick<
   | "commitMutation"
   | "applyMarqueeSelection"
   | "handleUpdateKeyframeEase"
+  | "handleUpdateSegmentEase"
   | "handleSetAllKeyframeEases"
 > {}
 
@@ -200,6 +201,7 @@ export function DomEditProvider({
     applyMarqueeSelection,
     handleUpdateKeyframeEase,
     handleSetAllKeyframeEases,
+    handleUpdateSegmentEase,
   },
   children,
 }: {
@@ -281,6 +283,7 @@ export function DomEditProvider({
       commitMutation: stableCommitMutation,
       applyMarqueeSelection,
       handleUpdateKeyframeEase,
+      handleUpdateSegmentEase,
       handleSetAllKeyframeEases,
     }),
     [
@@ -349,6 +352,7 @@ export function DomEditProvider({
       stableCommitMutation,
       applyMarqueeSelection,
       handleUpdateKeyframeEase,
+      handleUpdateSegmentEase,
       handleSetAllKeyframeEases,
     ],
   );
diff --git a/packages/studio/src/hooks/gsapTweenSynth.ts b/packages/studio/src/hooks/gsapTweenSynth.ts
index a07bc3cf16..275f122a36 100644
--- a/packages/studio/src/hooks/gsapTweenSynth.ts
+++ b/packages/studio/src/hooks/gsapTweenSynth.ts
@@ -27,7 +27,7 @@ export interface AnimationKeyframeTarget {
   tweenPercentage: number;
 }
 
-export function accumulateCollidingAnimationTargets(
+function accumulateCollidingAnimationTargets(
   keyframe: {
     animationId?: string;
     tweenPercentage?: number;
diff --git a/packages/studio/src/hooks/useDomEditSession.test.tsx b/packages/studio/src/hooks/useDomEditSession.test.tsx
index 57b4751f42..c2b58e718e 100644
--- a/packages/studio/src/hooks/useDomEditSession.test.tsx
+++ b/packages/studio/src/hooks/useDomEditSession.test.tsx
@@ -5,6 +5,7 @@ import { describe, expect, it, vi } from "vitest";
 import { shouldUseSdkCutover } from "../utils/sdkCutover";
 import type { PatchOperation } from "../utils/sourcePatcher";
 import type { Composition } from "@hyperframes/sdk";
+import type { DomEditSelection } from "../components/editor/domEditingTypes";
 import type { UseDomEditSessionParams } from "./useDomEditSession";
 
 const styleOp = (property: string, value: string): PatchOperation => ({
@@ -57,6 +58,8 @@ const capturedOnReorderShadow: { fn: ((targets: string[]) => void) | undefined }
   fn: undefined,
 };
 
+const domEditSelectionRef: { current: DomEditSelection | null } = { current: null };
+const gsapCommitMutation = Object.assign(vi.fn(), { batch: vi.fn() });
 vi.mock("../utils/sdkResolverShadow", () => ({
   runResolverShadow: vi.fn(),
   recordResolverParity: (...args: unknown[]) => recordResolverParity(...args),
@@ -83,11 +86,11 @@ vi.mock("./useDomEditCommits", () => ({
 }));
 vi.mock("./useDomSelection", () => ({
   useDomSelection: () => ({
-    domEditSelection: null,
+    domEditSelection: domEditSelectionRef.current,
     domEditGroupSelections: [],
     domEditHoverSelection: null,
     activeGroupElement: null,
-    domEditSelectionRef: { current: null },
+    domEditSelectionRef,
     domEditGroupSelectionsRef: { current: [] },
     setActiveGroupElement: vi.fn(),
     applyDomSelection: vi.fn(),
@@ -123,7 +126,7 @@ vi.mock("./useGsapTweenCache", () => ({
 }));
 vi.mock("./useGsapScriptCommits", () => ({
   useGsapScriptCommits: () => ({
-    commitMutation: vi.fn(),
+    commitMutation: gsapCommitMutation,
     updateGsapProperty: vi.fn(),
     updateGsapMeta: vi.fn(),
     deleteGsapAnimation: vi.fn(),
@@ -277,3 +280,136 @@ describe("onReorderShadow source filter", () => {
     }
   });
 });
+
+describe("bulk segment ease commits", () => {
+  it("uses one ordered batch for many ids and sane paths for one or no ids", async () => {
+    const { useDomEditSession } = await import("./useDomEditSession");
+    const selection: DomEditSelection = {
+      id: "hero",
+      element: document.createElement("div"),
+      label: "Hero",
+      tagName: "DIV",
+      sourceFile: "index.html",
+      compositionPath: "index.html",
+      isCompositionHost: false,
+      isInsideLockedComposition: false,
+      boundingBox: { x: 0, y: 0, width: 100, height: 100 },
+      textContent: null,
+      dataAttributes: {},
+      inlineStyles: {},
+      computedStyles: {},
+      textFields: [],
+      capabilities: {
+        canSelect: true,
+        canEditStyles: true,
+        canCrop: true,
+        canMove: true,
+        canResize: true,
+        canApplyManualOffset: true,
+        canApplyManualSize: true,
+        canApplyManualRotation: true,
+      },
+    };
+    domEditSelectionRef.current = selection;
+    gsapCommitMutation.mockClear();
+    gsapCommitMutation.batch.mockClear();
+    let updateSegmentEase:
+      | ((targets: Array<{ animationId: string; tweenPercentage: number }>, ease: string) => void)
+      | undefined;
+
+    function Probe() {
+      const params: UseDomEditSessionParams = {
+        projectId: "proj-1",
+        activeCompPath: "index.html",
+        isMasterView: false,
+        compIdToSrc: new Map(),
+        captionEditMode: false,
+        compositionLoading: false,
+        previewIframeRef: { current: null },
+        timelineElements: [],
+        setSelectedTimelineElementId: vi.fn(),
+        setRightCollapsed: vi.fn(),
+        setRightPanelTab: vi.fn(),
+        showToast: vi.fn(),
+        refreshPreviewDocumentVersion: vi.fn(),
+        queueDomEditSave: async <T,>(save: () => Promise<T>) => save(),
+        readProjectFile: async () => "",
+        writeProjectFile: async () => {},
+        updateEditingFileContent: vi.fn(),
+        domEditSaveTimestampRef: { current: 0 },
+        editHistory: { recordEdit: async () => {} },
+        fileTree: [],
+        importedFontAssetsRef: { current: [] },
+        projectDir: null,
+        projectIdRef: { current: "proj-1" },
+        previewIframe: null,
+        refreshKey: 0,
+        previewDocumentVersion: 0,
+        rightPanelTab: "design",
+        applyStudioManualEditsToPreviewRef: { current: async () => {} },
+        syncPreviewHistoryHotkey: vi.fn(),
+        reloadPreview: vi.fn(),
+        setRefreshKey: vi.fn(),
+      };
+      updateSegmentEase = useDomEditSession(params).handleUpdateSegmentEase;
+      return null;
+    }
+
+    const container = document.createElement("div");
+    const root = createRoot(container);
+    act(() => root.render(<Probe />));
+    try {
+      expect(updateSegmentEase).toBeTypeOf("function");
+      if (!updateSegmentEase) return;
+      const options = { label: "Update segment ease", softReload: true };
+      const targets = [
+        { animationId: "move-x", tweenPercentage: 20 },
+        { animationId: "move-y", tweenPercentage: 50 },
+        { animationId: "fade", tweenPercentage: 80 },
+      ];
+      updateSegmentEase(targets, "power2.inOut");
+
+      expect(gsapCommitMutation).not.toHaveBeenCalled();
+      expect(gsapCommitMutation.batch).toHaveBeenCalledTimes(1);
+      expect(gsapCommitMutation.batch).toHaveBeenCalledWith(
+        targets.map(({ animationId, tweenPercentage }) => ({
+          selection,
+          mutation: {
+            type: "update-keyframe",
+            animationId,
+            percentage: tweenPercentage,
+            properties: {},
+            ease: "power2.inOut",
+          },
+          options,
+        })),
+        options,
+      );
+
+      gsapCommitMutation.mockClear();
+      gsapCommitMutation.batch.mockClear();
+      updateSegmentEase([{ animationId: "fade", tweenPercentage: 25 }], "none");
+      expect(gsapCommitMutation).toHaveBeenCalledTimes(1);
+      expect(gsapCommitMutation).toHaveBeenCalledWith(
+        selection,
+        {
+          type: "update-keyframe",
+          animationId: "fade",
+          percentage: 25,
+          properties: {},
+          ease: "none",
+        },
+        { label: "Update keyframe ease", softReload: true },
+      );
+      expect(gsapCommitMutation.batch).not.toHaveBeenCalled();
+
+      gsapCommitMutation.mockClear();
+      updateSegmentEase([], "linear");
+      expect(gsapCommitMutation).not.toHaveBeenCalled();
+      expect(gsapCommitMutation.batch).not.toHaveBeenCalled();
+    } finally {
+      domEditSelectionRef.current = null;
+      act(() => root.unmount());
+    }
+  });
+});
diff --git a/packages/studio/src/hooks/useDomEditSession.ts b/packages/studio/src/hooks/useDomEditSession.ts
index e4f978c210..40566d8d95 100644
--- a/packages/studio/src/hooks/useDomEditSession.ts
+++ b/packages/studio/src/hooks/useDomEditSession.ts
@@ -19,8 +19,7 @@ import { useGsapCacheVersion } from "./useGsapTweenCache";
 import { useDomEditWiring } from "./useDomEditWiring";
 import { useGsapAwareEditing } from "./useGsapAwareEditing";
 import { useStudioSelectionPublisher } from "./useStudioSelectionPublisher";
-
-// ── Types ──
+import type { AnimationKeyframeTarget } from "./gsapTweenSynth";
 
 interface RecordEditInput {
   label: string;
@@ -71,8 +70,6 @@ export interface UseDomEditSessionParams {
   forceReloadSdkSession?: () => void;
 }
 
-// ── Hook ──
-
 export function useDomEditSession({
   projectId,
   activeCompPath,
@@ -113,8 +110,6 @@ export function useDomEditSession({
   forceReloadSdkSession,
 }: UseDomEditSessionParams) {
   void _setRefreshKey;
-  // ── Selection ──
-
   const {
     domEditSelection,
     domEditGroupSelections,
@@ -149,8 +144,6 @@ export function useDomEditSession({
     rightPanelTab,
   });
 
-  // ── Agent modal ──
-
   const {
     agentModalOpen,
     agentModalAnchorPoint,
@@ -423,9 +416,6 @@ export function useDomEditSession({
     removeAllKeyframes,
     handleDomManualEditsReset,
   });
-
-  // ── Preview interaction ──
-
   const {
     handlePreviewCanvasMouseDown,
     handlePreviewCanvasPointerMove,
@@ -444,9 +434,6 @@ export function useDomEditSession({
     setActiveGroupElement,
     onClickToSource,
   });
-
-  // ── GSAP-aware geometry intercepts + animated property commit ──
-
   const {
     handleGsapAwarePathOffsetCommit,
     handleGsapAwareGroupPathOffsetCommit,
@@ -473,28 +460,39 @@ export function useDomEditSession({
     setArcPath,
     updateArcSegment,
   });
-
-  const handleUpdateKeyframeEase = useCallback(
-    (animationId: string, percentage: number, ease: string) => {
-      const sel = domEditSelectionRef.current;
-      if (!sel) return;
-      gsapCommitMutation(
-        sel,
-        {
+  const handleUpdateSegmentEase = useCallback(
+    (targets: AnimationKeyframeTarget[], ease: string) => {
+      const selection = domEditSelectionRef.current;
+      if (!selection || targets.length === 0) return;
+      const options = {
+        label: targets.length === 1 ? "Update keyframe ease" : "Update segment ease",
+        softReload: true,
+      };
+      const calls = targets.map(({ animationId, tweenPercentage }) => ({
+        selection,
+        mutation: {
           type: "update-keyframe",
           animationId,
-          percentage,
+          percentage: tweenPercentage,
           properties: {},
           ease,
         },
-        { label: "Update keyframe ease", softReload: true },
-      );
+        options,
+      }));
+      if (calls.length === 1) {
+        const call = calls[0];
+        if (call) void gsapCommitMutation(call.selection, call.mutation, call.options);
+        return;
+      }
+      void gsapCommitMutation.batch?.(calls, options);
     },
     [gsapCommitMutation, domEditSelectionRef],
   );
-
-  // Apply one ease to every segment at once (AE select-all + F9): set easeEach
-  // and strip per-keyframe overrides in a single mutation.
+  const handleUpdateKeyframeEase = useCallback(
+    (animationId: string, percentage: number, ease: string) =>
+      handleUpdateSegmentEase([{ animationId, tweenPercentage: percentage }], ease),
+    [handleUpdateSegmentEase],
+  );
   const handleSetAllKeyframeEases = useCallback(
     (animationId: string, ease: string) => {
       const sel = domEditSelectionRef.current;
@@ -511,7 +509,6 @@ export function useDomEditSession({
     },
     [gsapCommitMutation, domEditSelectionRef],
   );
-
   return {
     // State
     domEditSelection,
@@ -591,6 +588,7 @@ export function useDomEditSession({
     commitAnimatedProperty,
     commitAnimatedProperties,
     handleSetArcPath,
+    handleUpdateSegmentEase,
     handleUpdateArcSegment,
     handleUnroll,
     invalidateGsapCache: bumpGsapCache,

From 899af39ebd9d4808cf0ca934d713e3d4a4baf50d Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 18:49:28 +0200
Subject: [PATCH 103/125] fix(studio): publish keyframe cache refresh
 atomically

---
 .../hooks/gsapKeyframeCacheHelpers.test.ts    | 56 +++++++++++++++++++
 .../src/hooks/gsapKeyframeCacheHelpers.ts     | 44 ++++++++++++++-
 .../studio/src/hooks/keyframeCacheAstLoad.ts  | 13 +----
 3 files changed, 99 insertions(+), 14 deletions(-)

diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
index f2c7b3e755..469b4eb12b 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.test.ts
@@ -5,6 +5,7 @@ import {
   clearKeyframeCacheForElement,
   clearKeyframeCacheForFile,
   pruneKeyframeCacheToFiles,
+  replaceKeyframeCacheForFile,
   updateKeyframeCacheFromParsed,
 } from "./gsapKeyframeCacheHelpers";
 
@@ -154,6 +155,61 @@ describe("pruneKeyframeCacheToFiles", () => {
   });
 });
 
+describe("replaceKeyframeCacheForFile", () => {
+  it("publishes complete keyframe and animation maps in one notification", () => {
+    const staleEntry = entry();
+    const otherEntry = entry();
+    const staleAnimation = animWithKeyframes("stale");
+    const freshAnimation = animWithKeyframes("fresh");
+    usePlayerStore.setState({
+      keyframeCache: new Map([
+        ["scene.html#stale", staleEntry],
+        ["index.html#stale", staleEntry],
+        ["stale", staleEntry],
+        ["other.html#other", otherEntry],
+        ["other", otherEntry],
+      ]),
+      gsapAnimations: new Map([
+        ["scene.html#stale", [staleAnimation]],
+        ["index.html#stale", [staleAnimation]],
+        ["stale", [staleAnimation]],
+        ["other.html#other", [staleAnimation]],
+        ["other", [staleAnimation]],
+      ]),
+    });
+    const snapshots: Array<{ cacheKeys: string[]; animationKeys: string[] }> = [];
+    const unsubscribe = usePlayerStore.subscribe((state) => {
+      snapshots.push({
+        cacheKeys: [...state.keyframeCache.keys()].sort(),
+        animationKeys: [...state.gsapAnimations.keys()].sort(),
+      });
+    });
+
+    replaceKeyframeCacheForFile(
+      "scene.html",
+      new Map([["fresh", entry()]]),
+      new Map([["fresh", [freshAnimation]]]),
+    );
+    unsubscribe();
+
+    expect(snapshots).toEqual([
+      {
+        cacheKeys: ["fresh", "index.html#fresh", "other", "other.html#other", "scene.html#fresh"],
+        animationKeys: [
+          "fresh",
+          "index.html#fresh",
+          "other",
+          "other.html#other",
+          "scene.html#fresh",
+        ],
+      },
+    ]);
+    expect(usePlayerStore.getState().gsapAnimations.get("scene.html#fresh")).toEqual([
+      freshAnimation,
+    ]);
+  });
+});
+
 describe("updateKeyframeCacheFromParsed", () => {
   it("records colliding animation targets with their own tween percentages", () => {
     const animation = (
diff --git a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
index 08e471e2aa..4303f22b90 100644
--- a/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
+++ b/packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts
@@ -102,15 +102,24 @@ export function clearKeyframeCacheForElement(sourceFile: string, elementId: stri
  */
 export function clearKeyframeCacheForFile(sourceFile: string): void {
   const { keyframeCache, gsapAnimations } = usePlayerStore.getState();
+  const ids = cachedElementIdsForFile(sourceFile, keyframeCache, gsapAnimations);
+  for (const id of ids) {
+    clearKeyframeCacheForElement(sourceFile, id);
+  }
+}
+
+function cachedElementIdsForFile(
+  sourceFile: string,
+  keyframeCache: ReadonlyMap<string, KeyframeCacheEntry>,
+  gsapAnimations: ReadonlyMap<string, GsapAnimation[]>,
+): Set<string> {
   const sfPrefix = `${sourceFile}#`;
   const ids = new Set<string>();
   for (const key of [...keyframeCache.keys(), ...gsapAnimations.keys()]) {
     if (!key.startsWith(sfPrefix)) continue;
     ids.add(key.slice(sfPrefix.length));
   }
-  for (const id of ids) {
-    clearKeyframeCacheForElement(sourceFile, id);
-  }
+  return ids;
 }
 
 /**
@@ -148,6 +157,35 @@ export function elementCacheKeys(sourceFile: string, elementId: string): string[
     : [`${sourceFile}#${elementId}`, `index.html#${elementId}`, elementId];
 }
 
+/** Replace one file's complete cache snapshot with one atomic store publish. */
+export function replaceKeyframeCacheForFile(
+  sourceFile: string,
+  entries: ReadonlyMap<string, KeyframeCacheEntry>,
+  animationsByElement: ReadonlyMap<string, GsapAnimation[]>,
+): void {
+  const { keyframeCache, gsapAnimations } = usePlayerStore.getState();
+  const nextKeyframeCache = new Map(keyframeCache);
+  const nextGsapAnimations = new Map(gsapAnimations);
+  for (const id of cachedElementIdsForFile(sourceFile, keyframeCache, gsapAnimations)) {
+    for (const key of elementCacheKeys(sourceFile, id)) {
+      nextKeyframeCache.delete(key);
+      nextGsapAnimations.delete(key);
+    }
+  }
+  for (const [id, entry] of entries) {
+    const animations = animationsByElement.get(id);
+    for (const key of elementCacheKeys(sourceFile, id)) {
+      nextKeyframeCache.set(key, entry);
+      if (animations) nextGsapAnimations.set(key, animations);
+      else nextGsapAnimations.delete(key);
+    }
+  }
+  usePlayerStore.setState({
+    keyframeCache: nextKeyframeCache,
+    gsapAnimations: nextGsapAnimations,
+  });
+}
+
 export function writeGsapAnimationsForElement(
   sourceFile: string,
   elementId: string,
diff --git a/packages/studio/src/hooks/keyframeCacheAstLoad.ts b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
index bca5f4b233..1873de449f 100644
--- a/packages/studio/src/hooks/keyframeCacheAstLoad.ts
+++ b/packages/studio/src/hooks/keyframeCacheAstLoad.ts
@@ -6,11 +6,7 @@
 import type { GsapAnimation, GsapKeyframesData, ParsedGsap } from "@hyperframes/core/gsap-parser";
 import { isStudioHoldSet } from "@hyperframes/core/gsap-parser";
 import { usePlayerStore } from "../player/store/playerStore";
-import {
-  clearKeyframeCacheForFile,
-  elementCacheKeys,
-  writeGsapAnimationsForElement,
-} from "./gsapKeyframeCacheHelpers";
+import { replaceKeyframeCacheForFile } from "./gsapKeyframeCacheHelpers";
 import { idFromSelector, toClipKeyframes } from "./gsapShared";
 import {
   deduplicateKeyframes,
@@ -146,8 +142,6 @@ export async function populateKeyframeCacheFromAst(
 ): Promise<void> {
   const parsed = await fetchParsedAnimations(projectId, sf);
   if (!parsed) return;
-  const { setKeyframeCache } = usePlayerStore.getState();
-  clearKeyframeCacheForFile(sf);
   const { elements, domClipChildren } = usePlayerStore.getState();
   const mergedByElement = new Map<string, GsapKeyframesData>();
   const sourceByElement = new Map<string, GsapAnimation[]>();
@@ -174,8 +168,5 @@ export async function populateKeyframeCacheFromAst(
       }
     }
   }
-  for (const [id, kfData] of mergedByElement) {
-    for (const key of elementCacheKeys(sf, id)) setKeyframeCache(key, kfData);
-    writeGsapAnimationsForElement(sf, id, sourceByElement.get(id));
-  }
+  replaceKeyframeCacheForFile(sf, mergedByElement, sourceByElement);
 }

From c9e12e8f8716f0b66646f894adcc3c3cd27d4d86 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 18:50:18 +0200
Subject: [PATCH 104/125] fix(studio): switch keyframe ease modes
 optimistically

---
 .../components/editor/AnimationCard.test.tsx  | 51 +++++++++++++---
 .../editor/EaseCurveSection.test.tsx          | 61 +++++++++++++++++++
 .../components/editor/EaseCurveSection.tsx    | 42 ++++++++-----
 .../components/editor/holdEaseSeek.test.ts    | 34 +++++++++++
 4 files changed, 163 insertions(+), 25 deletions(-)
 create mode 100644 packages/studio/src/components/editor/holdEaseSeek.test.ts

diff --git a/packages/studio/src/components/editor/AnimationCard.test.tsx b/packages/studio/src/components/editor/AnimationCard.test.tsx
index 19b455724f..65cf0658b6 100644
--- a/packages/studio/src/components/editor/AnimationCard.test.tsx
+++ b/packages/studio/src/components/editor/AnimationCard.test.tsx
@@ -85,10 +85,15 @@ function findButton(host: HTMLElement, text: string): HTMLButtonElement | undefi
   );
 }
 
+function openSegment(host: HTMLElement, label: string): void {
+  const segment = findButton(host, label);
+  expect(segment).toBeDefined();
+  act(() => segment?.click());
+}
+
 function selectPreset(host: HTMLElement, presetId: string): string {
   const presetConfig = EASE_PRESETS.find((candidate) => candidate.id === presetId);
   if (!presetConfig) throw new Error(`Missing ease preset: ${presetId}`);
-
   const dropdown = host.querySelector<HTMLButtonElement>("[data-ease-type-dropdown]");
   expect(dropdown).not.toBeNull();
   act(() => dropdown?.click());
@@ -174,9 +179,7 @@ describe("AnimationCard", () => {
   it("tracks a committed segment ease alongside the existing update", () => {
     const onEaseCommit = vi.fn();
     const view = renderFocusCard(null, onEaseCommit, true);
-    const segment = findButton(view.host, "0% → 50%");
-    expect(segment).toBeDefined();
-    act(() => segment?.click());
+    openSegment(view.host, "0% → 50%");
     const ease = selectPreset(view.host, "quad-out");
 
     expect(onEaseCommit).toHaveBeenCalledWith(ANIMATION.id, 50, ease);
@@ -221,7 +224,6 @@ describe("AnimationCard", () => {
       vi.fn(),
       onUpdateSegmentEase,
     );
-
     const ease = selectPreset(view.host, "quad-out");
 
     expect(onUpdateKeyframeEase).toHaveBeenCalledExactlyOnceWith(ANIMATION.id, 50, ease);
@@ -258,7 +260,40 @@ function baseAnimation(overrides: Partial<GsapAnimation> = {}): GsapAnimation {
     ...overrides,
   } as GsapAnimation;
 }
+
 describe("AnimationCard ease editing", () => {
+  it.each([
+    ["spring", "power2.out", "spring(0.42)", "Spring bounce"],
+    ["wiggle", "power2.out", "wiggle(3,easeInOut,0.12)", "Wiggle count"],
+    ["curve", "spring(0.6)", "custom(M0,0 C0.16,1 0.3,1 1,1)", "Cubic bezier control points"],
+  ] as const)(
+    "commits and immediately displays the %s default when a keyframe segment switches mode",
+    (mode, currentEase, ease, fieldLabel) => {
+      const onUpdateKeyframeEase = vi.fn();
+      const animation = baseAnimation({
+        keyframes: {
+          format: "percentage",
+          keyframes: [
+            { percentage: 0, properties: { opacity: 0 } },
+            { percentage: 50, properties: { opacity: 0.5 }, ease: currentEase },
+            { percentage: 100, properties: { opacity: 1 } },
+          ],
+        },
+      });
+      const view = renderFocusCard(null, onUpdateKeyframeEase, true, animation);
+
+      openSegment(view.host, "0% → 50%");
+      const modeButton = view.host.querySelector<HTMLButtonElement>(`[data-ease-mode="${mode}"]`);
+      expect(modeButton).not.toBeNull();
+      act(() => modeButton?.click());
+
+      expect(onUpdateKeyframeEase).toHaveBeenCalledExactlyOnceWith(animation.id, 50, ease);
+      expect(modeButton?.getAttribute("aria-checked")).toBe("true");
+      expect(view.host.querySelector(`[aria-label="${fieldLabel}"]`)).not.toBeNull();
+      act(() => view.root.unmount());
+    },
+  );
+
   it("commits one preset change to the selected keyframe segment", () => {
     const onUpdateKeyframeEase = vi.fn();
     const animation = baseAnimation({
@@ -273,11 +308,7 @@ describe("AnimationCard ease editing", () => {
     });
     const view = renderCard({ animation, onUpdateKeyframeEase });
 
-    const segment = Array.from(view.host.querySelectorAll("button")).find((button) =>
-      button.textContent?.includes("0% → 50%"),
-    );
-    expect(segment).toBeDefined();
-    act(() => segment?.click());
+    openSegment(view.host, "0% → 50%");
     const ease = selectPreset(view.host, "quad-out");
 
     expect(onUpdateKeyframeEase).toHaveBeenCalledExactlyOnceWith(animation.id, 50, ease);
diff --git a/packages/studio/src/components/editor/EaseCurveSection.test.tsx b/packages/studio/src/components/editor/EaseCurveSection.test.tsx
index 0cb7879335..c9fb705abd 100644
--- a/packages/studio/src/components/editor/EaseCurveSection.test.tsx
+++ b/packages/studio/src/components/editor/EaseCurveSection.test.tsx
@@ -3,7 +3,10 @@
 import React, { act, useState } from "react";
 import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
+import { parseSpringBounce } from "@hyperframes/core/spring-ease";
+import { parseWiggleEase } from "@hyperframes/core/wiggle-ease";
 import { EaseCurveSection, MiniCurveSvg } from "./EaseCurveSection";
+import { resolveEaseCurveTuple } from "./gsapAnimationConstants";
 import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
@@ -76,6 +79,19 @@ function renderStatefulSection(initialEase = "none", onCustomEaseCommit = vi.fn(
   return { host, root, onCustomEaseCommit };
 }
 
+function renderControlledSection(initialEase = "none", onCustomEaseCommit = vi.fn()) {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  const renderEase = (ease: string) => {
+    act(() =>
+      root.render(<EaseCurveSection ease={ease} onCustomEaseCommit={onCustomEaseCommit} />),
+    );
+  };
+  renderEase(initialEase);
+  return { host, root, onCustomEaseCommit, renderEase };
+}
+
 function clickMode(host: HTMLElement, mode: "curve" | "spring" | "wiggle"): void {
   const toggle = host.querySelector<HTMLButtonElement>(`[data-ease-mode="${mode}"]`);
   expect(toggle).not.toBeNull();
@@ -291,12 +307,57 @@ describe("EaseCurveSection preset grid", () => {
 
     clickMode(host, "spring");
     expect(onCustomEaseCommit).toHaveBeenLastCalledWith("spring(0.42)");
+    expect(parseSpringBounce(onCustomEaseCommit.mock.lastCall![0])).toBe(0.42);
 
     clickMode(host, "curve");
     expect(onCustomEaseCommit).toHaveBeenLastCalledWith("custom(M0,0 C0.16,1 0.3,1 1,1)");
+    expect(resolveEaseCurveTuple(onCustomEaseCommit.mock.lastCall![0])).toEqual([0.16, 1, 0.3, 1]);
 
     clickMode(host, "wiggle");
     expect(onCustomEaseCommit).toHaveBeenLastCalledWith("wiggle(3,easeInOut,0.12)");
+    expect(parseWiggleEase(onCustomEaseCommit.mock.lastCall![0])).toEqual({
+      wiggles: 3,
+      type: "easeInOut",
+      amplitude: 0.12,
+    });
+    expect(onCustomEaseCommit).toHaveBeenCalledTimes(3);
+
+    act(() => root.unmount());
+  });
+
+  it("keeps an optimistic mode visible through its canonical prop round-trip", () => {
+    const { host, root, onCustomEaseCommit, renderEase } = renderControlledSection();
+
+    clickMode(host, "spring");
+    expect(host.querySelector('[data-ease-mode="spring"]')?.getAttribute("aria-checked")).toBe(
+      "true",
+    );
+    expect(host.querySelector('[aria-label="Spring bounce"]')).not.toBeNull();
+
+    renderEase("spring(0.42)");
+    expect(host.querySelector('[data-ease-mode="spring"]')?.getAttribute("aria-checked")).toBe(
+      "true",
+    );
+    expect(host.querySelector('[aria-label="Spring bounce"]')).not.toBeNull();
+    expect(onCustomEaseCommit).toHaveBeenCalledExactlyOnceWith("spring(0.42)");
+
+    act(() => root.unmount());
+  });
+
+  it("replaces an optimistic mode when the canonical prop changes externally", () => {
+    const { host, root, renderEase } = renderControlledSection();
+
+    clickMode(host, "spring");
+    renderEase("wiggle(2,uniform,0.3)");
+
+    expect(host.querySelector('[data-ease-mode="spring"]')?.getAttribute("aria-checked")).toBe(
+      "false",
+    );
+    expect(host.querySelector('[data-ease-mode="wiggle"]')?.getAttribute("aria-checked")).toBe(
+      "true",
+    );
+    expect(host.querySelector('[aria-label="Wiggle count"]')).not.toBeNull();
+    expect(host.querySelector('[aria-label="Spring bounce"]')).toBeNull();
 
     act(() => root.unmount());
   });
diff --git a/packages/studio/src/components/editor/EaseCurveSection.tsx b/packages/studio/src/components/editor/EaseCurveSection.tsx
index a59fa957cb..0893de8a36 100644
--- a/packages/studio/src/components/editor/EaseCurveSection.tsx
+++ b/packages/studio/src/components/editor/EaseCurveSection.tsx
@@ -330,12 +330,14 @@ export function EaseCurveSection({
   onCustomEaseCommit: (ease: string) => void;
   collidingAnimationTargets?: AnimationKeyframeTarget[];
 }) {
-  const springBounce = parseSpringBounce(ease);
+  const [pendingEase, setPendingEase] = useState<{ source: string; value: string } | null>(null);
+  const displayedEase = pendingEase?.source === ease ? pendingEase.value : ease;
+  const springBounce = parseSpringBounce(displayedEase);
   const isSpring = springBounce !== null;
-  const wiggleConfig = parseWiggleEase(ease);
+  const wiggleConfig = parseWiggleEase(displayedEase);
   const isWiggle = wiggleConfig !== null;
   const mode: EaseMode = isSpring ? "spring" : isWiggle ? "wiggle" : "curve";
-  const curve = resolveEditableCurve(ease, springBounce);
+  const curve = resolveEditableCurve(displayedEase, springBounce);
 
   const [draft, setDraft] = useState<Pts | null>(null);
   const [hover, setHover] = useState<"p1" | "p2" | null>(null);
@@ -349,8 +351,14 @@ export function EaseCurveSection({
   // `ease` changes, `curve` already equals the draft, so the handoff is seamless.
   useEffect(() => {
     setDraft(null);
+    setPendingEase(null);
   }, [ease]);
 
+  const commitEase = (nextEase: string) => {
+    setPendingEase({ source: ease, value: nextEase });
+    onCustomEaseCommit(nextEase);
+  };
+
   const activeTuple = draft ?? curve;
   const displayTuple = activeTuple ?? DEFAULT_CURVE;
   const [x1, y1, x2, y2] = displayTuple;
@@ -361,8 +369,12 @@ export function EaseCurveSection({
   const a1 = { x: xToSvg(1), y: yToSvg(1) };
   const p1 = { x: xToSvg(x1), y: yToSvg(clampView(y1)) };
   const p2 = { x: xToSvg(x2), y: yToSvg(clampView(y2)) };
-  const curvePath = curvePathFor(ease, springBounce, wiggleConfig, displayTuple);
-  const showGraph = activeTuple !== null || isWiggle || ease === "hold";
+  // Read the OPTIMISTIC ease everywhere the graph is derived, so a mode switch
+  // paints immediately instead of waiting for the committed prop to come back.
+  const curvePath = curvePathFor(displayedEase, springBounce, wiggleConfig, displayTuple);
+  const showGraph = activeTuple !== null || isWiggle || displayedEase === "hold";
+  // `curve !== null` is what keeps Hold handle-free: it draws a graph (a flat
+  // step) but has no editable control points to drag.
   const showHandles = curve !== null && !isSpring && !isWiggle;
 
   const handlePointerDown = (handle: "p1" | "p2", e: React.PointerEvent) => {
@@ -397,10 +409,9 @@ export function EaseCurveSection({
     if (!draggingRef.current || !draft) return;
     draggingRef.current = null;
     const path = `M0,0 C${draft[0]},${draft[1]} ${draft[2]},${draft[3]} 1,1`;
-    // Clear after the synchronous parent commit settles. This also clears a
-    // same-string commit, where the `ease` dependency effect would not run.
-    onCustomEaseCommit(`custom(${path})`);
-    queueMicrotask(() => setDraft(null));
+    // Commit only — the draft stays on screen and is cleared by the effect above
+    // once the committed `ease` prop comes back, so the curve never flickers.
+    commitEase(`custom(${path})`);
   };
 
   const handleKeyDown = (handle: "p1" | "p2", event: React.KeyboardEvent<SVGCircleElement>) => {
@@ -409,25 +420,26 @@ export function EaseCurveSection({
     event.preventDefault();
     event.stopPropagation();
     setDraft(next);
-    onCustomEaseCommit(`custom(M0,0 C${next[0]},${next[1]} ${next[2]},${next[3]} 1,1)`);
-    queueMicrotask(() => setDraft(null));
+    // Same no-flicker contract as the pointer path: commit and let the effect
+    // clear the draft, rather than dropping it on the next microtask.
+    commitEase(`custom(M0,0 C${next[0]},${next[1]} ${next[2]},${next[3]} 1,1)`);
   };
 
   const top = yToSvg(1);
   const bottom = yToSvg(0);
   const left = xToSvg(0);
   const right = xToSvg(1);
-  const label = resolveEditorLabel(ease, springBounce, isWiggle);
+  const label = resolveEditorLabel(displayedEase, springBounce, isWiggle);
 
   return (
     <div className="rounded-lg bg-neutral-900/50 p-2">
-      <EaseTypeDropdown kind={mode} ease={ease} label={label} onSelect={onCustomEaseCommit} />
+      <EaseTypeDropdown kind={mode} ease={displayedEase} label={label} onSelect={commitEase} />
       {collidingAnimationTargets && collidingAnimationTargets.length > 1 && (
         <p className="mb-1 text-[9px] text-neutral-500">
           Applies to {collidingAnimationTargets.length} properties
         </p>
       )}
-      <EaseModeToggle mode={mode} onCommit={onCustomEaseCommit} />
+      <EaseModeToggle mode={mode} onCommit={commitEase} />
       <span className="sr-only" aria-live="polite">
         {MODE_LABELS[mode]} ease editor selected
       </span>
@@ -568,7 +580,7 @@ export function EaseCurveSection({
             springBounce={springBounce}
             wiggleConfig={wiggleConfig}
             tuple={displayTuple}
-            onCommit={onCustomEaseCommit}
+            onCommit={commitEase}
           />
         </>
       ) : (
diff --git a/packages/studio/src/components/editor/holdEaseSeek.test.ts b/packages/studio/src/components/editor/holdEaseSeek.test.ts
new file mode 100644
index 0000000000..2245f51d12
--- /dev/null
+++ b/packages/studio/src/components/editor/holdEaseSeek.test.ts
@@ -0,0 +1,34 @@
+import { installStudioCustomEase } from "../../../../core/src/runtime/customEase";
+import { gsap } from "gsap";
+import { describe, expect, it } from "vitest";
+
+describe("Studio hold ease", () => {
+  it("holds the start value under seek until the destination time", () => {
+    const runtimeGsap = { parseEase: gsap.parseEase.bind(gsap) };
+    expect(installStudioCustomEase(runtimeGsap)).toBe(true);
+    const hold = runtimeGsap.parseEase("hold");
+    expect(hold).toBeTypeOf("function");
+    if (typeof hold !== "function") return;
+
+    const target = { value: 0 };
+    const timeline = gsap.timeline({ paused: true }).to(
+      target,
+      {
+        value: 100,
+        duration: 2,
+        ease: hold,
+      },
+      0,
+    );
+
+    timeline.seek(0.5);
+    expect(target.value).toBe(0);
+    timeline.seek(1);
+    expect(target.value).toBe(0);
+    timeline.seek(1.99);
+    expect(target.value).toBe(0);
+    timeline.seek(2);
+    expect(target.value).toBe(100);
+    timeline.kill();
+  });
+});

From fa190d8ed20dde737a183b682399078cc55a1b65 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 19:20:43 +0200
Subject: [PATCH 105/125] perf(studio): define timeline viewport budgets and
 fixtures

---
 .../src/hooks/useStudioTestHooks.test.tsx     | 125 ++++++++++++++
 .../studio/src/hooks/useStudioTestHooks.ts    |  36 ++++
 .../timelinePerformanceDiagnostics.test.ts    |  85 ++++++++++
 .../lib/timelinePerformanceDiagnostics.ts     | 115 +++++++++++++
 .../player/lib/timelinePerformanceFixture.ts  | 157 ++++++++++++++++++
 .../lib/timelineViewportBudgets.test.ts       |  48 ++++++
 .../src/player/lib/timelineViewportBudgets.ts | 125 ++++++++++++++
 7 files changed, 691 insertions(+)
 create mode 100644 packages/studio/src/hooks/useStudioTestHooks.test.tsx
 create mode 100644 packages/studio/src/player/lib/timelinePerformanceDiagnostics.test.ts
 create mode 100644 packages/studio/src/player/lib/timelinePerformanceDiagnostics.ts
 create mode 100644 packages/studio/src/player/lib/timelinePerformanceFixture.ts
 create mode 100644 packages/studio/src/player/lib/timelineViewportBudgets.test.ts
 create mode 100644 packages/studio/src/player/lib/timelineViewportBudgets.ts

diff --git a/packages/studio/src/hooks/useStudioTestHooks.test.tsx b/packages/studio/src/hooks/useStudioTestHooks.test.tsx
new file mode 100644
index 0000000000..847ccfd53b
--- /dev/null
+++ b/packages/studio/src/hooks/useStudioTestHooks.test.tsx
@@ -0,0 +1,125 @@
+// @vitest-environment happy-dom
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { usePlayerStore } from "../player/store/playerStore";
+import {
+  createTimelinePerformanceFixture,
+  type TimelinePerformanceFixtureProfile,
+} from "../player/lib/timelinePerformanceFixture";
+import { useStudioTestHooks } from "./useStudioTestHooks";
+
+Reflect.set(globalThis, "IS_REACT_ACT_ENVIRONMENT", true);
+
+const PROFILES: readonly TimelinePerformanceFixtureProfile[] = [
+  "dense-short",
+  "long-overlap",
+  "keyframe-heavy-expanded",
+  "composition-heavy",
+  "remote-unsupported",
+];
+
+function Probe(): null {
+  useStudioTestHooks({
+    previewIframeRef: { current: null },
+    buildDomSelectionFromTarget: vi.fn(),
+    applyDomSelection: vi.fn(),
+  });
+  return null;
+}
+
+describe("timeline performance fixture", () => {
+  afterEach(() => {
+    window.__studioTest = undefined;
+    usePlayerStore.getState().reset();
+  });
+
+  it("generates stable 50k identities, counts, distribution, and duration", () => {
+    const first = createTimelinePerformanceFixture({
+      elementCount: 50_000,
+      profile: "dense-short",
+    });
+    const second = createTimelinePerformanceFixture({
+      elementCount: 50_000,
+      profile: "dense-short",
+    });
+
+    expect(first.summary).toEqual(second.summary);
+    expect(first.summary).toEqual({
+      elementCount: 50_000,
+      profile: "dense-short",
+      duration: 120,
+      trackCount: 1_000,
+      keyframedElementCount: 0,
+      expandedElementCount: 0,
+    });
+    expect(new Set(first.elements.map((element) => element.track)).size).toBe(1_000);
+    const perTrack = new Map<number, number>();
+    for (const element of first.elements) {
+      perTrack.set(element.track, (perTrack.get(element.track) ?? 0) + 1);
+    }
+    expect(Math.max(...perTrack.values())).toBeLessThanOrEqual(128);
+    expect(first.elements.slice(0, 3)).toEqual(second.elements.slice(0, 3));
+    expect(first.elements.at(-1)).toEqual(second.elements.at(-1));
+  });
+
+  it.each(PROFILES)("builds the %s 1k scale profile", (profile) => {
+    const fixture = createTimelinePerformanceFixture({ elementCount: 1_000, profile });
+    expect(fixture.elements).toHaveLength(1_000);
+    expect(fixture.summary.elementCount).toBe(1_000);
+    expect(fixture.summary.duration).toBeGreaterThan(0);
+    expect(new Set(fixture.elements.map((element) => element.key)).size).toBe(1_000);
+    if (profile === "keyframe-heavy-expanded") {
+      expect(fixture.keyframeCache.size).toBe(1_000);
+      expect(fixture.gsapAnimations.size).toBe(1_000);
+      expect(fixture.expandedClipIds.size).toBe(1_000);
+    }
+  });
+
+  it("publishes one dev-only loader that replaces fixture state atomically", () => {
+    const host = document.createElement("div");
+    const root = createRoot(host);
+    act(() => root.render(<Probe />));
+    const api = window.__studioTest;
+    expect(api).toBeDefined();
+    if (!api) throw new Error("Expected dev Studio test API");
+    let notifications = 0;
+    const unsubscribe = usePlayerStore.subscribe(() => {
+      notifications += 1;
+    });
+
+    const summary = api.loadTimelinePerformanceFixture({
+      elementCount: 1_000,
+      profile: "keyframe-heavy-expanded",
+    });
+
+    expect(summary.elementCount).toBe(1_000);
+    expect(notifications).toBe(1);
+    expect(usePlayerStore.getState()).toMatchObject({
+      duration: 600,
+      timelineReady: true,
+    });
+    expect(usePlayerStore.getState().elements).toHaveLength(1_000);
+    expect(usePlayerStore.getState().expandedClipIds.size).toBe(1_000);
+    unsubscribe();
+    act(() => root.unmount());
+    expect(window.__studioTest).toBeUndefined();
+  });
+
+  it("does not mutate state when the fixture request is invalid", () => {
+    const host = document.createElement("div");
+    const root = createRoot(host);
+    act(() => root.render(<Probe />));
+    const api = window.__studioTest;
+    if (!api) throw new Error("Expected dev Studio test API");
+    const before = usePlayerStore.getState().elements;
+
+    expect(() =>
+      Reflect.apply(api.loadTimelinePerformanceFixture, api, [
+        { elementCount: 999, profile: "dense-short" },
+      ]),
+    ).toThrow("elementCount must be 1000 or 50000");
+    expect(usePlayerStore.getState().elements).toBe(before);
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/hooks/useStudioTestHooks.ts b/packages/studio/src/hooks/useStudioTestHooks.ts
index a434677c4a..7e7d822e88 100644
--- a/packages/studio/src/hooks/useStudioTestHooks.ts
+++ b/packages/studio/src/hooks/useStudioTestHooks.ts
@@ -1,5 +1,16 @@
 import { useEffect } from "react";
 import type { DomEditSelection } from "../components/editor/domEditing";
+import { usePlayerStore } from "../player/store/playerStore";
+import {
+  readTimelinePerformanceDiagnostics,
+  type TimelinePerformanceDiagnostics,
+} from "../player/lib/timelinePerformanceDiagnostics";
+import {
+  createTimelinePerformanceFixture,
+  type TimelinePerformanceFixtureSpec,
+  type TimelinePerformanceFixtureSummary,
+} from "../player/lib/timelinePerformanceFixture";
+import { TIMELINE_VIEWPORT_BUDGETS } from "../player/lib/timelineViewportBudgets";
 
 interface StudioTestHookDeps {
   previewIframeRef: React.MutableRefObject<HTMLIFrameElement | null>;
@@ -12,6 +23,11 @@ interface StudioTestHookDeps {
 
 interface StudioTestApi {
   selectByDomId: (id: string) => Promise<boolean>;
+  loadTimelinePerformanceFixture: (
+    spec: TimelinePerformanceFixtureSpec,
+  ) => TimelinePerformanceFixtureSummary;
+  readTimelinePerformanceDiagnostics: () => Readonly<TimelinePerformanceDiagnostics>;
+  timelineViewportBudgets: typeof TIMELINE_VIEWPORT_BUDGETS;
 }
 
 declare global {
@@ -52,6 +68,26 @@ export function useStudioTestHooks({
         applyDomSelection(selection, { revealPanel: true });
         return true;
       },
+      loadTimelinePerformanceFixture: (spec) => {
+        const fixture = createTimelinePerformanceFixture(spec);
+        usePlayerStore.setState({
+          currentTime: 0,
+          duration: fixture.summary.duration,
+          timelineReady: true,
+          zoomMode: "manual",
+          manualZoomPercent: 2_000,
+          elements: fixture.elements,
+          selectedElementId: null,
+          selectedElementIds: new Set(),
+          selectedKeyframes: new Set(),
+          keyframeCache: fixture.keyframeCache,
+          gsapAnimations: fixture.gsapAnimations,
+          expandedClipIds: fixture.expandedClipIds,
+        });
+        return fixture.summary;
+      },
+      readTimelinePerformanceDiagnostics: () => readTimelinePerformanceDiagnostics(),
+      timelineViewportBudgets: TIMELINE_VIEWPORT_BUDGETS,
     };
     window.__studioTest = api;
     return () => {
diff --git a/packages/studio/src/player/lib/timelinePerformanceDiagnostics.test.ts b/packages/studio/src/player/lib/timelinePerformanceDiagnostics.test.ts
new file mode 100644
index 0000000000..8e2f44741b
--- /dev/null
+++ b/packages/studio/src/player/lib/timelinePerformanceDiagnostics.test.ts
@@ -0,0 +1,85 @@
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it } from "vitest";
+import {
+  getTimelineResourceBudgetStatus,
+  readTimelinePerformanceDiagnostics,
+  resolveTimelineScrollStrategy,
+} from "./timelinePerformanceDiagnostics";
+import { resolveTimelineViewportBudgets } from "./timelineViewportBudgets";
+
+describe("timeline performance diagnostics", () => {
+  afterEach(() => {
+    document.body.replaceChildren();
+  });
+
+  it("reads mounted resources without mutating the timeline", () => {
+    document.body.innerHTML = `
+      <div aria-label="Timeline" data-timeline-scheduler-queued="3"
+           data-timeline-scheduler-active="2" data-timeline-cache-bytes="4096">
+        <div data-timeline-row><div data-clip="true"></div><div data-clip="true"></div></div>
+        <div data-timeline-row><div data-clip="true"></div></div>
+        <div data-timeline-grid-cell></div><div data-timeline-grid-cell></div>
+        <div data-timeline-poster-state="ready"></div>
+        <div data-timeline-poster-state="error"></div>
+      </div>`;
+    const before = document.body.innerHTML;
+
+    expect(readTimelinePerformanceDiagnostics()).toMatchObject({
+      timelineRoots: 1,
+      mountedRows: 2,
+      mountedClipRoots: 3,
+      maxMountedClipRootsInOneRow: 2,
+      mountedTimeGridCells: 2,
+      schedulerQueued: 3,
+      schedulerActive: 2,
+      cacheBytes: 4096,
+      posterStates: { idle: 0, loading: 0, ready: 1, fallback: 0, error: 1 },
+    });
+    expect(document.body.innerHTML).toBe(before);
+  });
+
+  it("returns the zero baseline after unmount or reset removes the DOM", () => {
+    document.body.innerHTML = '<div aria-label="Timeline"><div data-clip="true"></div></div>';
+    expect(readTimelinePerformanceDiagnostics().mountedClipRoots).toBe(1);
+
+    document.body.replaceChildren();
+
+    expect(readTimelinePerformanceDiagnostics()).toEqual({
+      timelineRoots: 0,
+      mountedRows: 0,
+      mountedClipRoots: 0,
+      maxMountedClipRootsInOneRow: 0,
+      mountedTimeGridCells: 0,
+      mountedTimelineDescendants: 0,
+      schedulerQueued: 0,
+      schedulerActive: 0,
+      cacheBytes: 0,
+      posterStates: { idle: 0, loading: 0, ready: 0, fallback: 0, error: 0 },
+    });
+  });
+
+  it("checks the DOM ceilings including the strict descendant boundary", () => {
+    const budgets = resolveTimelineViewportBudgets({
+      maxMountedClipRoots: 2,
+      maxMountedClipRootsPerRow: 1,
+      maxMountedTimelineDescendants: 4,
+    });
+    expect(
+      getTimelineResourceBudgetStatus(
+        {
+          ...readTimelinePerformanceDiagnostics(),
+          mountedClipRoots: 2,
+          maxMountedClipRootsInOneRow: 2,
+          mountedTimelineDescendants: 4,
+        },
+        budgets,
+      ),
+    ).toEqual({ clipRoots: true, clipRootsPerRow: false, descendants: false });
+  });
+
+  it("selects direct scrolling only through the configured safety envelope", () => {
+    expect(resolveTimelineScrollStrategy(8_000_000)).toBe("direct");
+    expect(resolveTimelineScrollStrategy(8_000_001)).toBe("segmented");
+    expect(() => resolveTimelineScrollStrategy(Number.NaN)).toThrow("content width");
+  });
+});
diff --git a/packages/studio/src/player/lib/timelinePerformanceDiagnostics.ts b/packages/studio/src/player/lib/timelinePerformanceDiagnostics.ts
new file mode 100644
index 0000000000..e1f2f5964b
--- /dev/null
+++ b/packages/studio/src/player/lib/timelinePerformanceDiagnostics.ts
@@ -0,0 +1,115 @@
+import { TIMELINE_VIEWPORT_BUDGETS, type TimelineViewportBudgets } from "./timelineViewportBudgets";
+
+export type TimelinePosterState = "idle" | "loading" | "ready" | "fallback" | "error";
+
+export interface TimelinePerformanceDiagnostics {
+  timelineRoots: number;
+  mountedRows: number;
+  mountedClipRoots: number;
+  maxMountedClipRootsInOneRow: number;
+  mountedTimeGridCells: number;
+  mountedTimelineDescendants: number;
+  schedulerQueued: number;
+  schedulerActive: number;
+  cacheBytes: number;
+  posterStates: Readonly<Record<TimelinePosterState, number>>;
+}
+
+export interface TimelineResourceBudgetStatus {
+  clipRoots: boolean;
+  clipRootsPerRow: boolean;
+  descendants: boolean;
+}
+
+function readNonNegativeNumber(value: string | undefined): number {
+  const number = Number(value);
+  return Number.isFinite(number) && number >= 0 ? number : 0;
+}
+
+function countPosters(root: ParentNode): Readonly<Record<TimelinePosterState, number>> {
+  const counts: Record<TimelinePosterState, number> = {
+    idle: 0,
+    loading: 0,
+    ready: 0,
+    fallback: 0,
+    error: 0,
+  };
+  for (const node of root.querySelectorAll<HTMLElement>("[data-timeline-poster-state]")) {
+    const state = node.dataset.timelinePosterState;
+    if (state && state in counts) counts[state as TimelinePosterState] += 1;
+  }
+  return Object.freeze(counts);
+}
+
+function maxClipsInOneRow(root: ParentNode): number {
+  const byRow = new Map<Element | null, number>();
+  for (const clip of root.querySelectorAll<HTMLElement>('[data-clip="true"]')) {
+    const row = clip.closest("[data-timeline-row]");
+    byRow.set(row, (byRow.get(row) ?? 0) + 1);
+  }
+  return Math.max(0, ...byRow.values());
+}
+
+function sumDataAttribute(root: ParentNode, selector: string, dataKey: string): number {
+  let total = 0;
+  for (const node of root.querySelectorAll<HTMLElement>(selector)) {
+    total += readNonNegativeNumber(node.dataset[dataKey]);
+  }
+  return total;
+}
+
+/**
+ * Read current timeline costs directly from the mounted DOM. No counters are
+ * retained, so an unmount or project reset is reflected as a zero baseline on
+ * the next read rather than depending on cleanup ordering.
+ */
+export function readTimelinePerformanceDiagnostics(
+  root: ParentNode = document,
+): Readonly<TimelinePerformanceDiagnostics> {
+  const timelineRoots = root.querySelectorAll<HTMLElement>('[aria-label="Timeline"]');
+  let mountedTimelineDescendants = 0;
+  for (const timelineRoot of timelineRoots) {
+    mountedTimelineDescendants += timelineRoot.querySelectorAll("*").length;
+  }
+  return Object.freeze({
+    timelineRoots: timelineRoots.length,
+    mountedRows: root.querySelectorAll("[data-timeline-row]").length,
+    mountedClipRoots: root.querySelectorAll('[data-clip="true"]').length,
+    maxMountedClipRootsInOneRow: maxClipsInOneRow(root),
+    mountedTimeGridCells: root.querySelectorAll("[data-timeline-grid-cell]").length,
+    mountedTimelineDescendants,
+    schedulerQueued: sumDataAttribute(
+      root,
+      "[data-timeline-scheduler-queued]",
+      "timelineSchedulerQueued",
+    ),
+    schedulerActive: sumDataAttribute(
+      root,
+      "[data-timeline-scheduler-active]",
+      "timelineSchedulerActive",
+    ),
+    cacheBytes: sumDataAttribute(root, "[data-timeline-cache-bytes]", "timelineCacheBytes"),
+    posterStates: countPosters(root),
+  });
+}
+
+export function getTimelineResourceBudgetStatus(
+  diagnostics: TimelinePerformanceDiagnostics,
+  budgets: Readonly<TimelineViewportBudgets> = TIMELINE_VIEWPORT_BUDGETS,
+): Readonly<TimelineResourceBudgetStatus> {
+  return Object.freeze({
+    clipRoots: diagnostics.mountedClipRoots <= budgets.maxMountedClipRoots,
+    clipRootsPerRow: diagnostics.maxMountedClipRootsInOneRow <= budgets.maxMountedClipRootsPerRow,
+    descendants: diagnostics.mountedTimelineDescendants < budgets.maxMountedTimelineDescendants,
+  });
+}
+
+export function resolveTimelineScrollStrategy(
+  contentWidthPx: number,
+  budgets: Readonly<TimelineViewportBudgets> = TIMELINE_VIEWPORT_BUDGETS,
+): "direct" | "segmented" {
+  if (!Number.isFinite(contentWidthPx) || contentWidthPx < 0) {
+    throw new RangeError("Timeline content width must be a finite non-negative number");
+  }
+  return contentWidthPx <= budgets.directScrollSafetyPx ? "direct" : "segmented";
+}
diff --git a/packages/studio/src/player/lib/timelinePerformanceFixture.ts b/packages/studio/src/player/lib/timelinePerformanceFixture.ts
new file mode 100644
index 0000000000..12707ea33c
--- /dev/null
+++ b/packages/studio/src/player/lib/timelinePerformanceFixture.ts
@@ -0,0 +1,157 @@
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import type { KeyframeCacheEntry, TimelineElement } from "../store/playerStore";
+
+export type TimelinePerformanceFixtureProfile =
+  | "dense-short"
+  | "long-overlap"
+  | "keyframe-heavy-expanded"
+  | "composition-heavy"
+  | "remote-unsupported";
+
+export interface TimelinePerformanceFixtureSpec {
+  elementCount: 1_000 | 50_000;
+  profile: TimelinePerformanceFixtureProfile;
+}
+
+export interface TimelinePerformanceFixtureSummary extends TimelinePerformanceFixtureSpec {
+  duration: number;
+  trackCount: number;
+  keyframedElementCount: number;
+  expandedElementCount: number;
+}
+
+export interface TimelinePerformanceFixture {
+  summary: Readonly<TimelinePerformanceFixtureSummary>;
+  elements: TimelineElement[];
+  keyframeCache: Map<string, KeyframeCacheEntry>;
+  gsapAnimations: Map<string, GsapAnimation[]>;
+  expandedClipIds: Set<string>;
+}
+
+const TRACK_COUNT = 1_000;
+const PROFILE_GEOMETRY: Readonly<
+  Record<TimelinePerformanceFixtureProfile, { duration: number; clipDuration: number }>
+> = Object.freeze({
+  "dense-short": { duration: 120, clipDuration: 1.5 },
+  "long-overlap": { duration: 7_200, clipDuration: 120 },
+  "keyframe-heavy-expanded": { duration: 600, clipDuration: 8 },
+  "composition-heavy": { duration: 900, clipDuration: 12 },
+  "remote-unsupported": { duration: 900, clipDuration: 12 },
+});
+
+function validateFixtureSpec(spec: TimelinePerformanceFixtureSpec) {
+  if (spec.elementCount !== 1_000 && spec.elementCount !== 50_000) {
+    throw new RangeError("Timeline performance fixture elementCount must be 1000 or 50000");
+  }
+  const geometry = PROFILE_GEOMETRY[spec.profile];
+  if (!geometry) {
+    throw new RangeError(`Unknown timeline performance fixture profile: ${spec.profile}`);
+  }
+  return geometry;
+}
+
+function fixtureTrack(index: number, spec: TimelinePerformanceFixtureSpec): number {
+  if (index < TRACK_COUNT) return index;
+  if (spec.profile !== "dense-short") return index % TRACK_COUNT;
+  // Keep the dense profile inside the declared 128-roots-per-row envelope while
+  // still representing every one of the 1,000 logical tracks.
+  const denseTrackCount = Math.ceil((spec.elementCount - TRACK_COUNT) / 127);
+  return (index - TRACK_COUNT) % Math.max(1, denseTrackCount);
+}
+
+function fixtureStart(
+  index: number,
+  profile: TimelinePerformanceFixtureProfile,
+  duration: number,
+  clipDuration: number,
+): number {
+  const available = Math.max(0, duration - clipDuration);
+  if (profile === "dense-short") return (index % 128) * 0.5;
+  if (profile === "long-overlap") return (index * 37) % Math.max(1, available);
+  return (index * 17) % Math.max(1, available);
+}
+
+function keyframeData(): KeyframeCacheEntry {
+  return {
+    format: "percentage",
+    keyframes: [0, 33, 66, 100].map((percentage) => ({
+      percentage,
+      propertyGroup: "position",
+      properties: { x: percentage },
+      ease: "power2.inOut",
+    })),
+  };
+}
+
+function fixtureAnimation(id: string, start: number, duration: number): GsapAnimation {
+  return {
+    id: `animation-${id}`,
+    targetSelector: `#${id}`,
+    method: "to",
+    position: start,
+    resolvedStart: start,
+    duration,
+    propertyGroup: "position",
+    fromProperties: { x: 0 },
+    properties: { x: 100 },
+    ease: "power2.inOut",
+  };
+}
+
+/** Pure deterministic generator; the dev test hook performs the one store mutation. */
+export function createTimelinePerformanceFixture(
+  spec: TimelinePerformanceFixtureSpec,
+): TimelinePerformanceFixture {
+  const geometry = validateFixtureSpec(spec);
+  const elements: TimelineElement[] = [];
+  const keyframeCache = new Map<string, KeyframeCacheEntry>();
+  const gsapAnimations = new Map<string, GsapAnimation[]>();
+  const expandedClipIds = new Set<string>();
+
+  for (let index = 0; index < spec.elementCount; index += 1) {
+    const id = `perf-${spec.profile}-${spec.elementCount}-${index}`;
+    const start = fixtureStart(index, spec.profile, geometry.duration, geometry.clipDuration);
+    const track = fixtureTrack(index, spec);
+    const element: TimelineElement = {
+      id,
+      key: id,
+      domId: id,
+      selector: `#${id}`,
+      label: `Fixture ${index + 1}`,
+      tag: spec.profile === "remote-unsupported" && index % 2 === 0 ? "video" : "div",
+      start,
+      duration: geometry.clipDuration,
+      track,
+      authoredTrack: track,
+    };
+
+    if (spec.profile === "composition-heavy") {
+      element.compositionSrc = `compositions/perf-${index % 32}.html`;
+    } else if (spec.profile === "remote-unsupported") {
+      element.src =
+        index % 2 === 0
+          ? `https://media.invalid/perf-${index % 32}.mp4`
+          : `assets/perf-${index % 32}.unsupported`;
+    }
+    if (spec.profile === "keyframe-heavy-expanded") {
+      keyframeCache.set(id, keyframeData());
+      gsapAnimations.set(id, [fixtureAnimation(id, start, geometry.clipDuration)]);
+      expandedClipIds.add(id);
+    }
+    elements.push(element);
+  }
+
+  return {
+    summary: Object.freeze({
+      ...spec,
+      duration: geometry.duration,
+      trackCount: TRACK_COUNT,
+      keyframedElementCount: keyframeCache.size,
+      expandedElementCount: expandedClipIds.size,
+    }),
+    elements,
+    keyframeCache,
+    gsapAnimations,
+    expandedClipIds,
+  };
+}
diff --git a/packages/studio/src/player/lib/timelineViewportBudgets.test.ts b/packages/studio/src/player/lib/timelineViewportBudgets.test.ts
new file mode 100644
index 0000000000..a2f1bcf018
--- /dev/null
+++ b/packages/studio/src/player/lib/timelineViewportBudgets.test.ts
@@ -0,0 +1,48 @@
+import { describe, expect, it } from "vitest";
+import {
+  TIMELINE_VIEWPORT_BUDGETS,
+  resolveTimelineViewportBudgets,
+} from "./timelineViewportBudgets";
+
+describe("timeline viewport budgets", () => {
+  it("owns the agreed direct-scroll, DOM, media, and measurement ceilings", () => {
+    expect(TIMELINE_VIEWPORT_BUDGETS).toMatchObject({
+      directScrollSafetyPx: 8_000_000,
+      maxMountedClipRoots: 512,
+      maxMountedClipRootsPerRow: 128,
+      maxMountedTimelineDescendants: 5_000,
+      thumbnailCacheBytes: 64 * 1024 * 1024,
+      waveformCacheBytes: 16 * 1024 * 1024,
+      interactionP95Ms: 50,
+      constrainedInteractionP95Ms: 75,
+      posterCoverageRatio: 0.9,
+      supportedFixtureFallbackRatio: 0.02,
+      warmupRuns: 3,
+      measuredRuns: 5,
+      requiredPassingRuns: 4,
+    });
+    expect(Object.isFrozen(TIMELINE_VIEWPORT_BUDGETS)).toBe(true);
+  });
+
+  it("creates an immutable test override without changing production defaults", () => {
+    const resolved = resolveTimelineViewportBudgets({
+      directScrollSafetyPx: 256,
+      measuredRuns: 1,
+      requiredPassingRuns: 1,
+    });
+
+    expect(resolved.directScrollSafetyPx).toBe(256);
+    expect(resolved.maxMountedClipRoots).toBe(512);
+    expect(TIMELINE_VIEWPORT_BUDGETS.directScrollSafetyPx).toBe(8_000_000);
+    expect(Object.isFrozen(resolved)).toBe(true);
+  });
+
+  it.each([
+    [{ maxMountedClipRoots: -1 }, "maxMountedClipRoots"],
+    [{ frameIntervalP95Ms: Number.NaN }, "frameIntervalP95Ms"],
+    [{ measuredRuns: 4, requiredPassingRuns: 5 }, "requiredPassingRuns"],
+    [{ posterCoverageRatio: 1.1 }, "posterCoverageRatio"],
+  ] as const)("rejects an invalid override %#", (overrides, message) => {
+    expect(() => resolveTimelineViewportBudgets(overrides)).toThrow(message);
+  });
+});
diff --git a/packages/studio/src/player/lib/timelineViewportBudgets.ts b/packages/studio/src/player/lib/timelineViewportBudgets.ts
new file mode 100644
index 0000000000..178bb3f4b7
--- /dev/null
+++ b/packages/studio/src/player/lib/timelineViewportBudgets.ts
@@ -0,0 +1,125 @@
+export interface TimelineViewportBudgets {
+  directScrollSafetyPx: number;
+  rowOverscanPerSide: number;
+  timeOverscanViewportRatio: number;
+  maxMountedClipRoots: number;
+  maxMountedClipRootsPerRow: number;
+  maxMountedTimelineDescendants: number;
+  posterMaxPhysicalWidth: number;
+  posterMaxPhysicalHeight: number;
+  posterDprCap: number;
+  richPreviewFrameCount: number;
+  concurrentVideoDecodes: number;
+  concurrentMetadataJobs: number;
+  concurrentCompositionFetches: number;
+  concurrentServerPages: number;
+  thumbnailCacheBytes: number;
+  thumbnailCacheEntries: number;
+  thumbnailCacheEntriesPerProject: number;
+  metadataRegistryEntries: number;
+  metadataFailureTtlMs: number;
+  waveformCacheBytes: number;
+  waveformCacheEntries: number;
+  compositionDiskCacheBytes: number;
+  compositionDiskCacheMaxAgeMs: number;
+  interactionP95Ms: number;
+  frameIntervalP95Ms: number;
+  constrainedInteractionP95Ms: number;
+  constrainedFrameIntervalP95Ms: number;
+  longTaskLimitMs: number;
+  memoryReturnToleranceRatio: number;
+  posterColdP95Ms: number;
+  posterCachedP95Ms: number;
+  constrainedPosterColdP95Ms: number;
+  constrainedPosterCachedP95Ms: number;
+  posterCoverageRatio: number;
+  posterCoverageSettleMs: number;
+  constrainedPosterCoverageSettleMs: number;
+  richPreviewP95Ms: number;
+  constrainedRichPreviewP95Ms: number;
+  supportedFixtureFallbackRatio: number;
+  warmupRuns: number;
+  measuredRuns: number;
+  requiredPassingRuns: number;
+}
+
+const MEBIBYTE = 1024 * 1024;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+/**
+ * The sole default budget owner for timeline viewport and media virtualization.
+ * Consumers may resolve an immutable per-test override; production defaults are
+ * never mutated globally.
+ */
+export const TIMELINE_VIEWPORT_BUDGETS: Readonly<TimelineViewportBudgets> = Object.freeze({
+  directScrollSafetyPx: 8_000_000,
+  rowOverscanPerSide: 4,
+  timeOverscanViewportRatio: 0.5,
+  maxMountedClipRoots: 512,
+  maxMountedClipRootsPerRow: 128,
+  maxMountedTimelineDescendants: 5_000,
+  posterMaxPhysicalWidth: 240,
+  posterMaxPhysicalHeight: 135,
+  posterDprCap: 1.5,
+  richPreviewFrameCount: 6,
+  concurrentVideoDecodes: 2,
+  concurrentMetadataJobs: 4,
+  concurrentCompositionFetches: 2,
+  concurrentServerPages: 1,
+  thumbnailCacheBytes: 64 * MEBIBYTE,
+  thumbnailCacheEntries: 256,
+  thumbnailCacheEntriesPerProject: 96,
+  metadataRegistryEntries: 512,
+  metadataFailureTtlMs: 30_000,
+  waveformCacheBytes: 16 * MEBIBYTE,
+  waveformCacheEntries: 256,
+  compositionDiskCacheBytes: 512 * MEBIBYTE,
+  compositionDiskCacheMaxAgeMs: 14 * DAY_MS,
+  interactionP95Ms: 50,
+  frameIntervalP95Ms: 33.3,
+  constrainedInteractionP95Ms: 75,
+  constrainedFrameIntervalP95Ms: 50,
+  longTaskLimitMs: 50,
+  memoryReturnToleranceRatio: 0.15,
+  posterColdP95Ms: 750,
+  posterCachedP95Ms: 250,
+  constrainedPosterColdP95Ms: 1_200,
+  constrainedPosterCachedP95Ms: 400,
+  posterCoverageRatio: 0.9,
+  posterCoverageSettleMs: 1_500,
+  constrainedPosterCoverageSettleMs: 2_500,
+  richPreviewP95Ms: 750,
+  constrainedRichPreviewP95Ms: 1_200,
+  supportedFixtureFallbackRatio: 0.02,
+  warmupRuns: 3,
+  measuredRuns: 5,
+  requiredPassingRuns: 4,
+});
+
+function assertValidBudget(name: keyof TimelineViewportBudgets, value: number): void {
+  if (!Number.isFinite(value) || value < 0) {
+    throw new RangeError(`Timeline viewport budget ${name} must be a finite non-negative number`);
+  }
+}
+
+export function resolveTimelineViewportBudgets(
+  overrides: Partial<TimelineViewportBudgets> = {},
+): Readonly<TimelineViewportBudgets> {
+  for (const [name, value] of Object.entries(overrides)) {
+    assertValidBudget(name as keyof TimelineViewportBudgets, value);
+  }
+  const resolved = { ...TIMELINE_VIEWPORT_BUDGETS, ...overrides };
+  if (resolved.requiredPassingRuns > resolved.measuredRuns) {
+    throw new RangeError("Timeline viewport budget requiredPassingRuns cannot exceed measuredRuns");
+  }
+  for (const name of [
+    "memoryReturnToleranceRatio",
+    "posterCoverageRatio",
+    "supportedFixtureFallbackRatio",
+  ] as const) {
+    if (resolved[name] > 1) {
+      throw new RangeError(`Timeline viewport budget ${name} cannot exceed 1`);
+    }
+  }
+  return Object.freeze(resolved);
+}

From bad5a54e56ee86ad473df4e1947ea20369494712 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 19:23:44 +0200
Subject: [PATCH 106/125] test(studio): gate timeline viewport performance in
 Chromium

---
 packages/studio/package.json                  |   1 +
 .../timeline-virtualization/hyperframes.json  |   8 +
 .../timeline-virtualization/index.html        |  39 +++
 .../tests/e2e/timeline-virtualization.mjs     | 298 ++++++++++++++++++
 4 files changed, 346 insertions(+)
 create mode 100644 packages/studio/tests/e2e/fixtures/timeline-virtualization/hyperframes.json
 create mode 100644 packages/studio/tests/e2e/fixtures/timeline-virtualization/index.html
 create mode 100644 packages/studio/tests/e2e/timeline-virtualization.mjs

diff --git a/packages/studio/package.json b/packages/studio/package.json
index 23c32e91e4..398c2c9c57 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -49,6 +49,7 @@
     "build": "vite build && tsup",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
+    "test:timeline-virtualization": "node tests/e2e/timeline-virtualization.mjs",
     "test:watch": "vitest",
     "report:sdk-cutover": "bun src/utils/sdkCutoverPolicy.report.ts"
   },
diff --git a/packages/studio/tests/e2e/fixtures/timeline-virtualization/hyperframes.json b/packages/studio/tests/e2e/fixtures/timeline-virtualization/hyperframes.json
new file mode 100644
index 0000000000..c4816b5eaa
--- /dev/null
+++ b/packages/studio/tests/e2e/fixtures/timeline-virtualization/hyperframes.json
@@ -0,0 +1,8 @@
+{
+  "$schema": "https://hyperframes.heygen.com/schema/hyperframes.json",
+  "paths": {
+    "blocks": "compositions",
+    "components": "compositions/components",
+    "assets": "assets"
+  }
+}
diff --git a/packages/studio/tests/e2e/fixtures/timeline-virtualization/index.html b/packages/studio/tests/e2e/fixtures/timeline-virtualization/index.html
new file mode 100644
index 0000000000..2846170bf5
--- /dev/null
+++ b/packages/studio/tests/e2e/fixtures/timeline-virtualization/index.html
@@ -0,0 +1,39 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Timeline virtualization QA fixture</title>
+    <style>
+      html,
+      body {
+        width: 1920px;
+        height: 1080px;
+        margin: 0;
+        overflow: hidden;
+        background: #0a0a0b;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="timeline-virtualization-anchor"
+      class="clip"
+      data-composition-id="timeline-virtualization"
+      data-width="1920"
+      data-height="1080"
+      data-start="0"
+      data-duration="60"
+      data-fps="30"
+      data-track-index="0"
+      style="position: absolute; inset: 0"
+    ></div>
+    <script>
+      window.__timelines = window.__timelines || {};
+      window.__timelines["timeline-virtualization"] = {
+        pause() {},
+        seek() {},
+      };
+    </script>
+  </body>
+</html>
diff --git a/packages/studio/tests/e2e/timeline-virtualization.mjs b/packages/studio/tests/e2e/timeline-virtualization.mjs
new file mode 100644
index 0000000000..de44a88a95
--- /dev/null
+++ b/packages/studio/tests/e2e/timeline-virtualization.mjs
@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+/**
+ * Reproducible timeline viewport gate against a running Studio preview of the
+ * adjacent fixture. The script prints machine-readable evidence; it never
+ * substitutes synthetic timings for a browser run.
+ *
+ * STUDIO_URL=http://127.0.0.1:5190/#project/timeline-virtualization \
+ *   node packages/studio/tests/e2e/timeline-virtualization.mjs
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { homedir, platform, arch } from "node:os";
+import { join } from "node:path";
+import puppeteer from "puppeteer-core";
+
+const STUDIO_URL = process.env.STUDIO_URL;
+const PROFILE = process.env.TIMELINE_PROFILE || "dense-short";
+const ELEMENT_COUNT = Number(process.env.TIMELINE_ELEMENT_COUNT || 50_000);
+const TIER = process.env.TIMELINE_TIER || "primary";
+const EXPECTED_CHROME_MAJOR = process.env.TIMELINE_CHROME_MAJOR
+  ? Number(process.env.TIMELINE_CHROME_MAJOR)
+  : null;
+
+if (!STUDIO_URL) {
+  console.error("STUDIO_URL is required and must point at the timeline-virtualization fixture");
+  process.exit(2);
+}
+if (
+  ![1_000, 50_000].includes(ELEMENT_COUNT) ||
+  !["primary", "low-resource", "high-dpr"].includes(TIER)
+) {
+  console.error(
+    "TIMELINE_ELEMENT_COUNT must be 1000 or 50000; " +
+      "TIMELINE_TIER must be primary, low-resource, or high-dpr",
+  );
+  process.exit(2);
+}
+
+function resolveChromeExecutable() {
+  const chromeRoot = join(homedir(), ".cache", "puppeteer", "chrome");
+  const builds = existsSync(chromeRoot) ? readdirSync(chromeRoot).sort().reverse() : [];
+  const installedCandidates = builds.flatMap((build) =>
+    [
+      "chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing",
+      "chrome-mac-x64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing",
+      "chrome-linux64/chrome",
+    ].map((relative) => join(chromeRoot, build, relative)),
+  );
+  return [
+    process.env.PUPPETEER_EXECUTABLE_PATH,
+    process.env.CHROME_PATH,
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/usr/bin/google-chrome",
+    "/usr/bin/chromium",
+    ...installedCandidates,
+  ].find((candidate) => candidate && existsSync(candidate));
+}
+
+function percentile(values, ratio) {
+  if (values.length === 0) return 0;
+  const sorted = [...values].sort((a, b) => a - b);
+  return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * ratio) - 1)];
+}
+
+async function collectHeapBytes(client) {
+  const usage = await client.send("Runtime.getHeapUsage");
+  return usage.usedSize;
+}
+
+async function collectRun(page) {
+  return page.evaluate(async () => {
+    const longTasks = [];
+    const scroller = findTimelineScroller();
+    const observer = observeLongTasks(longTasks);
+    const { interactions, frameIntervals } = await measureScrollInteractions(scroller);
+    observer?.disconnect();
+    return {
+      interactionP95Ms: percentileInPage(interactions, 0.95),
+      frameIntervalP95Ms: percentileInPage(frameIntervals, 0.95),
+      longestTaskMs: Math.max(0, ...longTasks),
+      scrollWidth: scroller.scrollWidth,
+      scrollHeight: scroller.scrollHeight,
+      diagnostics: window.__studioTest.readTimelinePerformanceDiagnostics(),
+    };
+
+    function percentileInPage(values, ratio) {
+      if (values.length === 0) return 0;
+      const sorted = [...values].sort((a, b) => a - b);
+      return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * ratio) - 1)];
+    }
+
+    function findTimelineScroller() {
+      const root = document.querySelector('[aria-label="Timeline"]');
+      if (!(root instanceof HTMLElement)) throw new Error("Timeline root not mounted");
+      const scroller = Array.from(root.querySelectorAll("div")).find(
+        (node) => node.scrollWidth > node.clientWidth || node.scrollHeight > node.clientHeight,
+      );
+      if (!(scroller instanceof HTMLElement)) throw new Error("Timeline scroller not mounted");
+      return scroller;
+    }
+
+    function observeLongTasks(longTaskDurations) {
+      if (
+        typeof PerformanceObserver !== "function" ||
+        !PerformanceObserver.supportedEntryTypes.includes("longtask")
+      ) {
+        return null;
+      }
+      const performanceObserver = new PerformanceObserver((list) => {
+        for (const entry of list.getEntries()) longTaskDurations.push(entry.duration);
+      });
+      performanceObserver.observe({ entryTypes: ["longtask"] });
+      return performanceObserver;
+    }
+
+    async function measureScrollInteractions(timelineScroller) {
+      const interactions = [];
+      const frameIntervals = [];
+      const nextFrame = () => new Promise((resolve) => requestAnimationFrame(resolve));
+      for (const ratio of [0, 0.25, 0.5, 0.75, 1, 0.5, 0]) {
+        const started = performance.now();
+        timelineScroller.scrollLeft = Math.round(
+          (timelineScroller.scrollWidth - timelineScroller.clientWidth) * ratio,
+        );
+        timelineScroller.scrollTop = Math.round(
+          (timelineScroller.scrollHeight - timelineScroller.clientHeight) * ratio,
+        );
+        const firstFrame = await nextFrame();
+        const secondFrame = await nextFrame();
+        interactions.push(secondFrame - started);
+        frameIntervals.push(secondFrame - firstFrame);
+      }
+      return { interactions, frameIntervals };
+    }
+  });
+}
+
+async function measureMaximumReliableScrollWidth(page) {
+  return page.evaluate(() => {
+    const viewportWidth = 320;
+    const container = document.createElement("div");
+    const content = document.createElement("div");
+    container.style.cssText = `position:fixed;left:-10000px;top:0;width:${viewportWidth}px;height:1px;overflow:auto`;
+    content.style.height = "1px";
+    container.append(content);
+    document.body.append(container);
+    const reliable = (width) => {
+      content.style.width = `${width}px`;
+      container.scrollLeft = width;
+      const expected = width - viewportWidth;
+      return container.scrollWidth >= width - 1 && container.scrollLeft >= expected - 1;
+    };
+    let low = 0;
+    let high = 64_000_000;
+    while (low + 1 < high) {
+      const middle = Math.floor((low + high) / 2);
+      if (reliable(middle)) low = middle;
+      else high = middle;
+    }
+    container.remove();
+    return low;
+  });
+}
+
+const executablePath = resolveChromeExecutable();
+if (!executablePath) {
+  console.error("No Chrome executable found; set PUPPETEER_EXECUTABLE_PATH");
+  process.exit(2);
+}
+
+const browser = await puppeteer.launch({
+  executablePath,
+  headless: true,
+  args: ["--no-sandbox", "--disable-dev-shm-usage"],
+});
+let exitCode = 1;
+try {
+  const version = await browser.version();
+  const chromeMajor = Number(/(?:Chrome|Chromium)\/(\d+)/.exec(version)?.[1]);
+  if (EXPECTED_CHROME_MAJOR !== null && chromeMajor !== EXPECTED_CHROME_MAJOR) {
+    throw new Error(
+      `Pinned Chrome ${EXPECTED_CHROME_MAJOR} required, received ${version}. ` +
+        "Override TIMELINE_CHROME_MAJOR only when intentionally recording a new baseline.",
+    );
+  }
+  const page = await browser.newPage();
+  await page.setViewport({
+    width: 1440,
+    height: 900,
+    deviceScaleFactor: TIER === "high-dpr" ? 2 : 1,
+  });
+  const client = await page.createCDPSession();
+  if (TIER === "low-resource") {
+    await client.send("Emulation.setCPUThrottlingRate", { rate: 4 });
+  }
+  await page.goto(STUDIO_URL, { waitUntil: "domcontentloaded", timeout: 60_000 });
+  await page.waitForFunction(
+    () => typeof window.__studioTest?.loadTimelinePerformanceFixture === "function",
+    { timeout: 30_000 },
+  );
+
+  await page.evaluate((profile) => {
+    window.__studioTest.loadTimelinePerformanceFixture({ elementCount: 1_000, profile });
+  }, PROFILE);
+  await client.send("HeapProfiler.collectGarbage");
+  const baselineHeapBytes = await collectHeapBytes(client);
+
+  const summary = await page.evaluate(
+    ({ elementCount, profile }) =>
+      window.__studioTest.loadTimelinePerformanceFixture({ elementCount, profile }),
+    { elementCount: ELEMENT_COUNT, profile: PROFILE },
+  );
+  await page.waitForFunction(() => document.querySelector('[aria-label="Timeline"]'));
+  const budgets = await page.evaluate(() => window.__studioTest.timelineViewportBudgets);
+  const measuredMaxReliableScrollWidth = await measureMaximumReliableScrollWidth(page);
+
+  const runs = [];
+  const interactionLimitMs =
+    TIER === "primary" ? budgets.interactionP95Ms : budgets.constrainedInteractionP95Ms;
+  const frameIntervalLimitMs =
+    TIER === "primary" ? budgets.frameIntervalP95Ms : budgets.constrainedFrameIntervalP95Ms;
+  for (let index = 0; index < budgets.warmupRuns + budgets.measuredRuns; index += 1) {
+    const run = await collectRun(page);
+    if (index >= budgets.warmupRuns) runs.push(run);
+  }
+  for (const run of runs) {
+    run.passed =
+      run.interactionP95Ms <= interactionLimitMs &&
+      run.frameIntervalP95Ms <= frameIntervalLimitMs &&
+      run.longestTaskMs <= budgets.longTaskLimitMs &&
+      run.diagnostics.mountedClipRoots <= budgets.maxMountedClipRoots &&
+      run.diagnostics.maxMountedClipRootsInOneRow <= budgets.maxMountedClipRootsPerRow &&
+      run.diagnostics.mountedTimelineDescendants < budgets.maxMountedTimelineDescendants;
+  }
+
+  await page.evaluate((profile) => {
+    window.__studioTest.loadTimelinePerformanceFixture({ elementCount: 1_000, profile });
+  }, PROFILE);
+  await client.send("HeapProfiler.collectGarbage");
+  const returnedHeapBytes = await collectHeapBytes(client);
+  const memoryReturned =
+    returnedHeapBytes <= baselineHeapBytes * (1 + budgets.memoryReturnToleranceRatio);
+  const passingRuns = runs.filter((run) => run.passed).length;
+  const maxTimelineContentWidthPx = Math.max(0, ...runs.map((run) => run.scrollWidth));
+  const directScrollGate = {
+    safetyEnvelopePx: budgets.directScrollSafetyPx,
+    maxTimelineContentWidthPx,
+    measuredMaxReliableScrollWidth,
+    decision:
+      maxTimelineContentWidthPx <= budgets.directScrollSafetyPx &&
+      measuredMaxReliableScrollWidth >= maxTimelineContentWidthPx
+        ? "approved"
+        : "rejected",
+  };
+  const evidence = {
+    environment: {
+      browser: version,
+      executablePath,
+      os: platform(),
+      architecture: arch(),
+      viewport: { width: 1440, height: 900 },
+      deviceScaleFactor: TIER === "high-dpr" ? 2 : 1,
+      cpuThrottleRate: TIER === "low-resource" ? 4 : 1,
+      tier: TIER,
+      fixture: summary,
+      runProtocol: {
+        warmups: budgets.warmupRuns,
+        measured: budgets.measuredRuns,
+        requiredPassing: budgets.requiredPassingRuns,
+      },
+    },
+    directScrollGate,
+    runs,
+    aggregate: {
+      interactionP95Ms: percentile(
+        runs.map((run) => run.interactionP95Ms),
+        0.95,
+      ),
+      frameIntervalP95Ms: percentile(
+        runs.map((run) => run.frameIntervalP95Ms),
+        0.95,
+      ),
+      passingRuns,
+      baselineHeapBytes,
+      returnedHeapBytes,
+      memoryReturned,
+    },
+  };
+  console.log(JSON.stringify(evidence, null, 2));
+  exitCode =
+    directScrollGate.decision === "approved" &&
+    passingRuns >= budgets.requiredPassingRuns &&
+    memoryReturned
+      ? 0
+      : 1;
+} finally {
+  await browser.close();
+}
+process.exit(exitCode);

From 5e024270903c7caeb5b77e14a4b11f00af1e907b Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 19:24:46 +0200
Subject: [PATCH 107/125] refactor(studio): isolate clip drag lifecycle

---
 .../timelineClipDragGestureLifecycle.ts       | 259 ++++++++++++++++++
 .../player/components/useTimelineClipDrag.ts  | 244 ++---------------
 2 files changed, 287 insertions(+), 216 deletions(-)
 create mode 100644 packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts

diff --git a/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts b/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts
new file mode 100644
index 0000000000..f9432dd1d2
--- /dev/null
+++ b/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts
@@ -0,0 +1,259 @@
+import type { Dispatch, RefObject, SetStateAction } from "react";
+import { resolveTimelineDragEscape } from "./timelineEditing";
+import { commitDraggedClipMove } from "./timelineClipDragCommit";
+import type {
+  BlockedClipState,
+  DraggedClipState,
+  ResizingClipState,
+} from "./timelineClipDragTypes";
+import type { TimelineGroupResizeSession } from "./timelineGroupEditing";
+import { commitTimelineGroupResize } from "./timelineGroupResizeCommit";
+import {
+  beginTimelineOptimisticGesture,
+  rollbackLatestTimelineOptimisticGesture,
+} from "./timelineOptimisticRevision";
+import type { TimelineEditCallbacks } from "./timelineCallbacks";
+import type { StackingPatch } from "./timelineStackingSync";
+import { usePlayerStore, type TimelineElement } from "../store/playerStore";
+
+type UpdateElement = ReturnType<typeof usePlayerStore.getState>["updateElement"];
+
+interface TimelineClipDragGestureLifecycleInput {
+  draggedClipRef: RefObject<DraggedClipState | null>;
+  resizingClipRef: RefObject<ResizingClipState | null>;
+  blockedClipRef: RefObject<BlockedClipState | null>;
+  groupResizeRef: RefObject<TimelineGroupResizeSession | null>;
+  suppressClickRef: RefObject<boolean>;
+  elementsRef: RefObject<TimelineElement[]>;
+  trackOrderRef: RefObject<number[]>;
+  setDraggedClip: Dispatch<SetStateAction<DraggedClipState | null>>;
+  setResizingClip: Dispatch<SetStateAction<ResizingClipState | null>>;
+  setShowPopover: (show: boolean) => void;
+  setRangeSelectionRef: RefObject<((selection: null) => void) | null>;
+  applyResizePointerRef: RefObject<(resize: ResizingClipState, clientX: number) => void>;
+  syncClipDragAutoScrollRef: RefObject<(clientX: number, clientY: number) => void>;
+  stopClipDragAutoScrollRef: RefObject<() => void>;
+  updateDraggedClipPreviewRef: RefObject<
+    (drag: DraggedClipState, clientX: number, clientY: number) => DraggedClipState
+  >;
+  restoreGroupResizeMembers: (session: TimelineGroupResizeSession, all?: boolean) => void;
+  updateElement: UpdateElement;
+  onMoveElementRef: RefObject<TimelineEditCallbacks["onMoveElement"]>;
+  onMoveElementsRef: RefObject<TimelineEditCallbacks["onMoveElements"]>;
+  onResizeElementRef: RefObject<TimelineEditCallbacks["onResizeElement"]>;
+  onResizeElementsRef: RefObject<TimelineEditCallbacks["onResizeElements"]>;
+  onBlockedEditAttemptRef: RefObject<
+    ((element: TimelineElement, intent: BlockedClipState["intent"]) => void) | undefined
+  >;
+  readZIndexRef: RefObject<((element: TimelineElement) => number) | undefined>;
+  onStackingPatchesRef: RefObject<
+    ((patches: StackingPatch[]) => Promise<unknown> | void) | undefined
+  >;
+  refreshAfterLaneMoveRef: RefObject<(() => void) | undefined>;
+}
+
+export function mountTimelineClipDragGestureLifecycle({
+  draggedClipRef,
+  resizingClipRef,
+  blockedClipRef,
+  groupResizeRef,
+  suppressClickRef,
+  elementsRef,
+  trackOrderRef,
+  setDraggedClip,
+  setResizingClip,
+  setShowPopover,
+  setRangeSelectionRef,
+  applyResizePointerRef,
+  syncClipDragAutoScrollRef,
+  stopClipDragAutoScrollRef,
+  updateDraggedClipPreviewRef,
+  restoreGroupResizeMembers,
+  updateElement,
+  onMoveElementRef,
+  onMoveElementsRef,
+  onResizeElementRef,
+  onResizeElementsRef,
+  onBlockedEditAttemptRef,
+  readZIndexRef,
+  onStackingPatchesRef,
+  refreshAfterLaneMoveRef,
+}: TimelineClipDragGestureLifecycleInput): () => void {
+  const clearSuppressedClick = () => {
+    requestAnimationFrame(() => {
+      suppressClickRef.current = false;
+    });
+  };
+
+  const handleResizePointerMove = (event: PointerEvent, resize: ResizingClipState) => {
+    const distance = Math.abs(event.clientX - resize.originClientX);
+    if (!resize.started && distance < 2) return;
+    setShowPopover(false);
+    setRangeSelectionRef.current?.(null);
+    applyResizePointerRef.current(resize, event.clientX);
+    syncClipDragAutoScrollRef.current(event.clientX, event.clientY);
+  };
+
+  const handleBlockedPointerMove = (event: PointerEvent, blocked: BlockedClipState) => {
+    const distance = Math.hypot(
+      event.clientX - blocked.originClientX,
+      event.clientY - blocked.originClientY,
+    );
+    const threshold = blocked.intent === "move" ? 4 : 2;
+    if (!blocked.started && distance < threshold) return;
+    if (!blocked.started) {
+      blocked.started = true;
+      blockedClipRef.current = blocked;
+      suppressClickRef.current = true;
+      setShowPopover(false);
+      setRangeSelectionRef.current?.(null);
+      onBlockedEditAttemptRef.current?.(blocked.element, blocked.intent);
+    }
+  };
+
+  const handleDragPointerMove = (event: PointerEvent, drag: DraggedClipState) => {
+    const distance = Math.hypot(
+      event.clientX - drag.originClientX,
+      event.clientY - drag.originClientY,
+    );
+    if (!drag.started && distance < 4) return;
+    setShowPopover(false);
+    setRangeSelectionRef.current?.(null);
+    setDraggedClip((previous) =>
+      previous
+        ? updateDraggedClipPreviewRef.current(previous, event.clientX, event.clientY)
+        : previous,
+    );
+    syncClipDragAutoScrollRef.current(event.clientX, event.clientY);
+  };
+
+  const handleWindowPointerMove = (event: PointerEvent) => {
+    const resize = resizingClipRef.current;
+    if (resize) return handleResizePointerMove(event, resize);
+    const blocked = blockedClipRef.current;
+    if (blocked) return handleBlockedPointerMove(event, blocked);
+    const drag = draggedClipRef.current;
+    if (drag) handleDragPointerMove(event, drag);
+  };
+
+  const commitResizePointerUp = (resize: ResizingClipState) => {
+    resizingClipRef.current = null;
+    setResizingClip(null);
+    const groupSession = groupResizeRef.current;
+    groupResizeRef.current = null;
+    if (!resize.started) {
+      if (groupSession) restoreGroupResizeMembers(groupSession);
+      return;
+    }
+    suppressClickRef.current = true;
+    clearSuppressedClick();
+    if (groupSession) {
+      commitTimelineGroupResize(groupSession, updateElement, onResizeElementsRef.current);
+      return;
+    }
+    const hasChanged =
+      resize.previewStart !== resize.element.start ||
+      resize.previewDuration !== resize.element.duration ||
+      resize.previewPlaybackStart !== resize.element.playbackStart;
+    if (!hasChanged) return;
+
+    const resizeKey = resize.element.key ?? resize.element.id;
+    const revision = beginTimelineOptimisticGesture(updateElement, [resizeKey]);
+    updateElement(resizeKey, {
+      start: resize.previewStart,
+      duration: resize.previewDuration,
+      playbackStart: resize.previewPlaybackStart,
+    });
+    Promise.resolve(
+      onResizeElementRef.current?.(resize.element, {
+        start: resize.previewStart,
+        duration: resize.previewDuration,
+        playbackStart: resize.previewPlaybackStart,
+      }),
+    ).catch((error) => {
+      rollbackLatestTimelineOptimisticGesture(updateElement, revision, [
+        {
+          key: resizeKey,
+          updates: {
+            start: resize.element.start,
+            duration: resize.element.duration,
+            playbackStart: resize.element.playbackStart,
+          },
+        },
+      ]);
+      console.error("[Timeline] Failed to persist clip resize", error);
+    });
+  };
+
+  const finishBlockedPointerUp = (blocked: BlockedClipState) => {
+    blockedClipRef.current = null;
+    if (blocked.started) clearSuppressedClick();
+  };
+
+  const commitDragPointerUp = (drag: DraggedClipState) => {
+    draggedClipRef.current = null;
+    setDraggedClip(null);
+    if (!drag.started) return;
+    suppressClickRef.current = true;
+    clearSuppressedClick();
+    commitDraggedClipMove(drag, {
+      elements: elementsRef.current,
+      trackOrder: trackOrderRef.current,
+      updateElement,
+      onMoveElement: onMoveElementRef.current,
+      onMoveElements: onMoveElementsRef.current,
+      selectedKeys: usePlayerStore.getState().selectedElementIds,
+      readZIndex: readZIndexRef.current,
+      onStackingPatches: onStackingPatchesRef.current,
+      refreshAfterLaneMove: refreshAfterLaneMoveRef.current,
+    });
+  };
+
+  const handleWindowPointerUp = () => {
+    stopClipDragAutoScrollRef.current();
+    const resize = resizingClipRef.current;
+    if (resize) return commitResizePointerUp(resize);
+    const blocked = blockedClipRef.current;
+    if (blocked) return finishBlockedPointerUp(blocked);
+    const drag = draggedClipRef.current;
+    if (!drag) {
+      if (suppressClickRef.current) clearSuppressedClick();
+      return;
+    }
+    commitDragPointerUp(drag);
+  };
+
+  const handleWindowKeyDown = (event: KeyboardEvent) => {
+    const decision = resolveTimelineDragEscape({
+      key: event.key,
+      drag: draggedClipRef.current,
+      resize: resizingClipRef.current,
+      blocked: blockedClipRef.current,
+    });
+    if (!decision.cancel) return;
+    event.preventDefault();
+    event.stopPropagation();
+    stopClipDragAutoScrollRef.current();
+    draggedClipRef.current = null;
+    setDraggedClip(null);
+    resizingClipRef.current = null;
+    setResizingClip(null);
+    const groupSession = groupResizeRef.current;
+    groupResizeRef.current = null;
+    if (groupSession) restoreGroupResizeMembers(groupSession);
+    blockedClipRef.current = null;
+    if (decision.suppressClick) suppressClickRef.current = true;
+  };
+
+  window.addEventListener("pointermove", handleWindowPointerMove);
+  window.addEventListener("pointerup", handleWindowPointerUp);
+  window.addEventListener("pointercancel", handleWindowPointerUp);
+  window.addEventListener("keydown", handleWindowKeyDown, true);
+  return () => {
+    stopClipDragAutoScrollRef.current();
+    window.removeEventListener("pointermove", handleWindowPointerMove);
+    window.removeEventListener("pointerup", handleWindowPointerUp);
+    window.removeEventListener("pointercancel", handleWindowPointerUp);
+    window.removeEventListener("keydown", handleWindowKeyDown, true);
+  };
+}
diff --git a/packages/studio/src/player/components/useTimelineClipDrag.ts b/packages/studio/src/player/components/useTimelineClipDrag.ts
index 90d4100813..da366e6bdb 100644
--- a/packages/studio/src/player/components/useTimelineClipDrag.ts
+++ b/packages/studio/src/player/components/useTimelineClipDrag.ts
@@ -3,7 +3,6 @@ import { useMountEffect } from "../../hooks/useMountEffect";
 import {
   applyTimelineAutoScrollStep,
   resolveTimelineAutoScrollLoopAction,
-  resolveTimelineDragEscape,
 } from "./timelineEditing";
 import { usePlayerStore } from "../store/playerStore";
 import type { TimelineElement } from "../store/playerStore";
@@ -14,7 +13,6 @@ import {
   type TimelineGroupResizeSession,
 } from "./timelineGroupEditing";
 import { collectTimelineSnapTargets, type TimelineSnapTarget } from "./timelineSnapping";
-import { commitDraggedClipMove } from "./timelineClipDragCommit";
 import type { StackingPatch } from "./timelineStackingSync";
 import type { TimelineEditCallbacks } from "./timelineCallbacks";
 import {
@@ -28,11 +26,7 @@ import type {
   ResizingClipState,
   BlockedClipState,
 } from "./timelineClipDragTypes";
-import {
-  beginTimelineOptimisticGesture,
-  rollbackLatestTimelineOptimisticGesture,
-} from "./timelineOptimisticRevision";
-import { commitTimelineGroupResize } from "./timelineGroupResizeCommit";
+import { mountTimelineClipDragGestureLifecycle } from "./timelineClipDragGestureLifecycle";
 
 export type {
   DraggedClipState,
@@ -363,215 +357,33 @@ export function useTimelineClipDrag({
   stopClipDragAutoScrollRef.current = stopClipDragAutoScroll;
 
   useMountEffect(() => {
-    const clearSuppressedClick = () => {
-      requestAnimationFrame(() => {
-        suppressClickRef.current = false;
-      });
-    };
-
-    /* ── pointermove branch handlers (dispatched by drag/resize/blocked) ── */
-    const handleResizePointerMove = (e: PointerEvent, resize: ResizingClipState) => {
-      const distance = Math.abs(e.clientX - resize.originClientX);
-      if (!resize.started && distance < 2) return;
-
-      setShowPopover(false);
-      setRangeSelectionRef.current?.(null);
-
-      applyResizePointerRef.current(resize, e.clientX);
-      // Edge auto-scroll during a trim, exactly like the move branch — lets a
-      // right-edge trim keep extending past the current viewport (the stepper
-      // re-runs the scroll-compensated preview each frame).
-      syncClipDragAutoScrollRef.current(e.clientX, e.clientY);
-    };
-
-    const handleBlockedPointerMove = (e: PointerEvent, blocked: BlockedClipState) => {
-      const distance = Math.hypot(
-        e.clientX - blocked.originClientX,
-        e.clientY - blocked.originClientY,
-      );
-      const threshold = blocked.intent === "move" ? 4 : 2;
-      if (!blocked.started && distance < threshold) return;
-      if (!blocked.started) {
-        blocked.started = true;
-        blockedClipRef.current = blocked;
-        suppressClickRef.current = true;
-        setShowPopover(false);
-        setRangeSelectionRef.current?.(null);
-        onBlockedEditAttemptRef.current?.(blocked.element, blocked.intent);
-      }
-    };
-
-    const handleDragPointerMove = (e: PointerEvent, drag: DraggedClipState) => {
-      const distance = Math.hypot(e.clientX - drag.originClientX, e.clientY - drag.originClientY);
-      if (!drag.started && distance < 4) return;
-
-      setShowPopover(false);
-      setRangeSelectionRef.current?.(null);
-
-      setDraggedClip((prev) =>
-        prev ? updateDraggedClipPreviewRef.current(prev, e.clientX, e.clientY) : prev,
-      );
-      syncClipDragAutoScrollRef.current(e.clientX, e.clientY);
-    };
-
-    const handleWindowPointerMove = (e: PointerEvent) => {
-      const resize = resizingClipRef.current;
-      if (resize) return handleResizePointerMove(e, resize);
-      const blocked = blockedClipRef.current;
-      if (blocked) return handleBlockedPointerMove(e, blocked);
-      const drag = draggedClipRef.current;
-      if (drag) handleDragPointerMove(e, drag);
-    };
-
-    /* ── pointerup commit handlers (dispatched by drag/resize/blocked) ──── */
-    const commitResizePointerUp = (resize: ResizingClipState) => {
-      resizingClipRef.current = null;
-      setResizingClip(null);
-      const groupSession = groupResizeRef.current;
-      groupResizeRef.current = null;
-      if (!resize.started) {
-        // No preview ran, so no group store-mutation to undo; guard is defensive.
-        if (groupSession) restoreGroupResizeMembers(groupSession);
-        return;
-      }
-
-      suppressClickRef.current = true;
-      clearSuppressedClick();
-
-      if (groupSession) {
-        commitTimelineGroupResize(groupSession, updateElement, onResizeElementsRef.current);
-        return;
-      }
-
-      const hasChanged =
-        resize.previewStart !== resize.element.start ||
-        resize.previewDuration !== resize.element.duration ||
-        resize.previewPlaybackStart !== resize.element.playbackStart;
-      if (!hasChanged) return;
-
-      const resizeKey = resize.element.key ?? resize.element.id;
-      const revision = beginTimelineOptimisticGesture(updateElement, [resizeKey]);
-      updateElement(resizeKey, {
-        start: resize.previewStart,
-        duration: resize.previewDuration,
-        playbackStart: resize.previewPlaybackStart,
-      });
-
-      Promise.resolve(
-        onResizeElementRef.current?.(resize.element, {
-          start: resize.previewStart,
-          duration: resize.previewDuration,
-          playbackStart: resize.previewPlaybackStart,
-        }),
-      ).catch((error) => {
-        rollbackLatestTimelineOptimisticGesture(updateElement, revision, [
-          {
-            key: resizeKey,
-            updates: {
-              start: resize.element.start,
-              duration: resize.element.duration,
-              playbackStart: resize.element.playbackStart,
-            },
-          },
-        ]);
-        console.error("[Timeline] Failed to persist clip resize", error);
-      });
-    };
-
-    const finishBlockedPointerUp = (blocked: BlockedClipState) => {
-      blockedClipRef.current = null;
-      if (!blocked.started) return;
-      clearSuppressedClick();
-    };
-
-    const commitDragPointerUp = (drag: DraggedClipState) => {
-      draggedClipRef.current = null;
-      setDraggedClip(null);
-      if (!drag.started) return;
-
-      suppressClickRef.current = true;
-      clearSuppressedClick();
-
-      // Commit the drag — insert (new track), main-track ripple (reflow contiguous),
-      // a plain single-clip move, or a multi-selection move (every selected clip
-      // shifts by the dragged clip's time delta). See timelineClipDragCommit.
-      commitDraggedClipMove(drag, {
-        elements: elementsRef.current,
-        trackOrder: trackOrderRef.current,
-        updateElement,
-        onMoveElement: onMoveElementRef.current,
-        onMoveElements: onMoveElementsRef.current,
-        selectedKeys: usePlayerStore.getState().selectedElementIds,
-        // Lane ↔ stacking: engages only when the timeline layer provisions both
-        // deps (Timeline.tsx). Absent → commitDraggedClipMove skips the z-sync.
-        readZIndex: readZIndexRef.current,
-        onStackingPatches: onStackingPatchesRef.current,
-        refreshAfterLaneMove: refreshAfterLaneMoveRef.current,
-      });
-    };
-
-    const handleWindowPointerUp = () => {
-      stopClipDragAutoScrollRef.current();
-
-      const resize = resizingClipRef.current;
-      if (resize) return commitResizePointerUp(resize);
-
-      const blocked = blockedClipRef.current;
-      if (blocked) return finishBlockedPointerUp(blocked);
-
-      const drag = draggedClipRef.current;
-      if (!drag) {
-        // Escape-cancel leaves the click suppressor armed so the click this
-        // pointerup generates can't act on the clip; disarm it right after.
-        if (suppressClickRef.current) clearSuppressedClick();
-        return;
-      }
-      commitDragPointerUp(drag);
-    };
-
-    // Escape cancels the in-progress gesture: no commit, no undo entry. The
-    // previews live only in the drag/resize state (the store is untouched
-    // until the pointerup commit), so clearing them restores the pre-drag
-    // timeline. Clip drags never take pointer capture (all tracking runs on
-    // these window listeners), so there is no capture to release; the null
-    // refs make the remaining pointermove/pointerup a no-op.
-    const handleWindowKeyDown = (e: KeyboardEvent) => {
-      const decision = resolveTimelineDragEscape({
-        key: e.key,
-        drag: draggedClipRef.current,
-        resize: resizingClipRef.current,
-        blocked: blockedClipRef.current,
-      });
-      if (!decision.cancel) return;
-      e.preventDefault();
-      e.stopPropagation();
-      stopClipDragAutoScrollRef.current();
-      draggedClipRef.current = null;
-      setDraggedClip(null);
-      resizingClipRef.current = null;
-      setResizingClip(null);
-      // Undo any group-resize preview store-mutation (non-grabbed members) so the
-      // cancelled gesture restores the pre-drag timeline, like the single-clip path.
-      const groupSession = groupResizeRef.current;
-      groupResizeRef.current = null;
-      if (groupSession) restoreGroupResizeMembers(groupSession);
-      blockedClipRef.current = null;
-      // The pointer is usually still down; keep the suppressor armed until the
-      // eventual pointerup (which disarms it) so its click can't reselect.
-      if (decision.suppressClick) suppressClickRef.current = true;
-    };
-
-    window.addEventListener("pointermove", handleWindowPointerMove);
-    window.addEventListener("pointerup", handleWindowPointerUp);
-    window.addEventListener("pointercancel", handleWindowPointerUp);
-    window.addEventListener("keydown", handleWindowKeyDown, true);
-    return () => {
-      stopClipDragAutoScrollRef.current();
-      window.removeEventListener("pointermove", handleWindowPointerMove);
-      window.removeEventListener("pointerup", handleWindowPointerUp);
-      window.removeEventListener("pointercancel", handleWindowPointerUp);
-      window.removeEventListener("keydown", handleWindowKeyDown, true);
-    };
+    return mountTimelineClipDragGestureLifecycle({
+      draggedClipRef,
+      resizingClipRef,
+      blockedClipRef,
+      groupResizeRef,
+      suppressClickRef,
+      elementsRef,
+      trackOrderRef,
+      setDraggedClip,
+      setResizingClip,
+      setShowPopover,
+      setRangeSelectionRef,
+      applyResizePointerRef,
+      syncClipDragAutoScrollRef,
+      stopClipDragAutoScrollRef,
+      updateDraggedClipPreviewRef,
+      restoreGroupResizeMembers,
+      updateElement,
+      onMoveElementRef,
+      onMoveElementsRef,
+      onResizeElementRef,
+      onResizeElementsRef,
+      onBlockedEditAttemptRef,
+      readZIndexRef,
+      onStackingPatchesRef,
+      refreshAfterLaneMoveRef,
+    });
   });
 
   return {

From ecf76d70fa774856acccc94bb1f5803ab61fa175 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 19:27:41 +0200
Subject: [PATCH 108/125] refactor(studio): extract timeline render contracts

---
 .../studio/src/player/components/Timeline.tsx |  92 +++-----------
 .../src/player/components/TimelineCanvas.tsx  |   3 +-
 .../player/components/TimelineLaneTypes.ts    |  85 +++++++++++++
 .../src/player/components/TimelineLanes.tsx   |  91 +------------
 .../src/player/components/timelineLayout.ts   | 120 +-----------------
 .../components/timelineRulerGeometry.ts       | 105 +++++++++++++++
 .../player/components/timelineViewModel.ts    |  43 +++++++
 .../useTimelineSelectionLifecycle.ts          |  27 ++++
 .../components/useTimelineShiftModifier.ts    |  20 +++
 .../src/player/components/useTimelineTicks.ts |  16 +++
 .../src/player/hooks/timelinePlayerSync.ts    |  20 +++
 .../src/player/hooks/useTimelinePlayer.ts     |  21 +--
 12 files changed, 344 insertions(+), 299 deletions(-)
 create mode 100644 packages/studio/src/player/components/TimelineLaneTypes.ts
 create mode 100644 packages/studio/src/player/components/timelineRulerGeometry.ts
 create mode 100644 packages/studio/src/player/components/timelineViewModel.ts
 create mode 100644 packages/studio/src/player/components/useTimelineSelectionLifecycle.ts
 create mode 100644 packages/studio/src/player/components/useTimelineShiftModifier.ts
 create mode 100644 packages/studio/src/player/components/useTimelineTicks.ts
 create mode 100644 packages/studio/src/player/hooks/timelinePlayerSync.ts

diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index cab6e28855..79f487ce2c 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -1,10 +1,9 @@
-import { useRef, useMemo, useCallback, useState, useEffect, memo } from "react";
+import { useRef, useMemo, useCallback, useState, memo } from "react";
 import { useMusicBeatAnalysis } from "../../hooks/useMusicBeatAnalysis";
 import { isMusicTrack } from "../../utils/timelineInspector";
 import { remapBeatAnalysisToComposition } from "../../utils/beatEditActions";
 import { usePlayerStore, type TimelineElement } from "../store/playerStore";
 import { useExpandedTimelineElements } from "../hooks/useExpandedTimelineElements";
-import { useMountEffect } from "../../hooks/useMountEffect";
 import { defaultTimelineTheme } from "./timelineTheme";
 import { useTimelineRangeSelection } from "./useTimelineRangeSelection";
 import { useTimelinePlayhead } from "./useTimelinePlayhead";
@@ -16,14 +15,12 @@ import { TimelineCanvas } from "./TimelineCanvas";
 import { type KeyframeDiamondContextMenuState } from "./KeyframeDiamondContextMenu";
 import { useTimelineClipDrag } from "./useTimelineClipDrag";
 import { TimelineOverlays } from "./TimelineOverlays";
-import { animationContributesLane } from "./TimelinePropertyLanes";
 import { useTimelineEditPinning } from "./useTimelineEditPinning";
 import { useTimelineStackingSync } from "./useTimelineStackingSync";
 import { useTimelineGeometry } from "./useTimelineGeometry";
 import { useAutoExpandKeyframedClips } from "./useAutoExpandKeyframedClips";
-import { GUTTER, LABEL_COL_W, TRACKS_LEFT_PAD, generateTicks } from "./timelineLayout";
+import { GUTTER, LABEL_COL_W, TRACKS_LEFT_PAD } from "./timelineLayout";
 import { useTimelineScrollViewport } from "./useTimelineScrollViewport";
-import { STUDIO_PREVIEW_FPS } from "../lib/time";
 import { useResolvedTimelineEditCallbacks } from "./useResolvedTimelineEditCallbacks";
 import type { TimelineProps } from "./TimelineTypes";
 import {
@@ -37,6 +34,14 @@ import { useTrackGapMenu } from "./useTrackGapMenu";
 import { useTimelineGapHighlights } from "./useTimelineGapHighlights";
 import { useStudioPlaybackContextOptional } from "../../contexts/StudioContext";
 import { TimelineRazorGuide, useTimelineRazorInteraction } from "./TimelineRazorInteraction";
+import {
+  getEffectiveTimelineDuration,
+  getTimelinePreviewElement,
+  hasKeyframedTimelineClips,
+} from "./timelineViewModel";
+import { useTimelineSelectionLifecycle } from "./useTimelineSelectionLifecycle";
+import { useTimelineShiftModifier } from "./useTimelineShiftModifier";
+import { useTimelineTicks } from "./useTimelineTicks";
 
 // Re-export pure utilities so existing imports from "./Timeline" still resolve.
 export {
@@ -118,13 +123,7 @@ export const Timeline = memo(function Timeline({
   // Label mode = comp has keyframed clips (not just when expanded): keeps the layer
   // disclosure + property column visible and reserves a GUTTER before 0s (Figma).
   const hasKeyframedClips = useMemo(
-    () =>
-      Array.from(gsapAnimations.values()).some((list) =>
-        // Same lane-contribution predicate the layout uses: real keyframes OR a
-        // synthesizable flat tween. Checking animation.keyframes alone left a
-        // flat-tween-only comp without its reserved label column.
-        list.some((animation) => animationContributesLane(animation)),
-      ),
+    () => hasKeyframedTimelineClips(gsapAnimations),
     [gsapAnimations],
   );
   const labelMode = STUDIO_KEYFRAMES_ENABLED && hasKeyframedClips;
@@ -143,20 +142,7 @@ export const Timeline = memo(function Timeline({
   const activeTool = usePlayerStore((s) => s.activeTool);
   const [hoveredClip, setHoveredClip] = useState<string | null>(null);
   const isDragging = useRef(false);
-  const [shiftHeld, setShiftHeld] = useState(false);
-
-  useMountEffect(() => {
-    const key = (e: KeyboardEvent) => e.key === "Shift" && setShiftHeld(e.type === "keydown");
-    const blur = () => setShiftHeld(false);
-    window.addEventListener("keydown", key);
-    window.addEventListener("keyup", key);
-    window.addEventListener("blur", blur);
-    return () => {
-      window.removeEventListener("keydown", key);
-      window.removeEventListener("keyup", key);
-      window.removeEventListener("blur", blur);
-    };
-  });
+  const shiftHeld = useTimelineShiftModifier();
 
   const [showPopover, setShowPopover] = useState(false);
   const [kfContextMenu, setKfContextMenu] = useState<KeyframeDiamondContextMenuState | null>(null);
@@ -173,12 +159,10 @@ export const Timeline = memo(function Timeline({
   // Last horizontal scroll offset, restored across the post-edit iframe reload (pinned zoom).
   const lastScrollLeftRef = useRef(0);
 
-  const effectiveDuration = useMemo(() => {
-    const safeDur = Number.isFinite(duration) ? duration : 0;
-    if (rawElements.length === 0) return safeDur;
-    const result = Math.max(safeDur, ...rawElements.map((el) => el.start + el.duration));
-    return Number.isFinite(result) ? result : safeDur;
-  }, [rawElements, duration]);
+  const effectiveDuration = useMemo(
+    () => getEffectiveTimelineDuration(duration, rawElements),
+    [duration, rawElements],
+  );
 
   const keyframeCache = usePlayerStore((s) => s.keyframeCache);
   useAutoExpandKeyframedClips(gsapAnimations);
@@ -296,14 +280,6 @@ export const Timeline = memo(function Timeline({
       toggleSelectedKeyframe,
     });
 
-  const selectedElement = useMemo(
-    () =>
-      expandedElements.find((element) => (element.key ?? element.id) === selectedElementId) ?? null,
-    [expandedElements, selectedElementId],
-  );
-  const selectedElementRef = useRef<TimelineElement | null>(selectedElement);
-  selectedElementRef.current = selectedElement;
-
   const {
     pps,
     fitPps,
@@ -402,41 +378,15 @@ export const Timeline = memo(function Timeline({
   });
   setRangeSelectionRef.current = setRangeSelection; // stable ref consumed by useTimelineClipDrag
 
-  const prevSelectedRef = useRef(selectedElementRef.current);
-  // eslint-disable-next-line no-restricted-syntax, react-hooks/exhaustive-deps
-  useEffect(() => {
-    const prev = prevSelectedRef.current;
-    const curr = selectedElementRef.current;
-    prevSelectedRef.current = curr;
-    if (prev && !curr) {
-      setShowPopover(false);
-      setRangeSelection(null);
-    }
-  });
-
-  // Frame display mode labels ruler ticks as frame numbers — pass the fps so ticks snap to frames.
-  const tickFps = timeDisplayMode === "frame" ? STUDIO_PREVIEW_FPS : undefined;
-  const { major, minor } = useMemo(
-    () => generateTicks(displayDuration, pps, tickFps),
-    [displayDuration, pps, tickFps],
+  useTimelineSelectionLifecycle(expandedElements, selectedElementId, setShowPopover, () =>
+    setRangeSelection(null),
   );
+
+  const { major, minor } = useTimelineTicks(displayDuration, pps, timeDisplayMode);
   const majorTickInterval = major.length >= 2 ? major[1] - major[0] : effectiveDuration;
 
   const getPreviewElement = useCallback(
-    (element: TimelineElement): TimelineElement => {
-      if (
-        resizingClip &&
-        (resizingClip.element.key ?? resizingClip.element.id) === (element.key ?? element.id)
-      ) {
-        return {
-          ...element,
-          start: resizingClip.previewStart,
-          duration: resizingClip.previewDuration,
-          playbackStart: resizingClip.previewPlaybackStart,
-        };
-      }
-      return element;
-    },
+    (element: TimelineElement): TimelineElement => getTimelinePreviewElement(element, resizingClip),
     [resizingClip],
   );
 
diff --git a/packages/studio/src/player/components/TimelineCanvas.tsx b/packages/studio/src/player/components/TimelineCanvas.tsx
index bdf63bbc5c..a13d0849da 100644
--- a/packages/studio/src/player/components/TimelineCanvas.tsx
+++ b/packages/studio/src/player/components/TimelineCanvas.tsx
@@ -20,7 +20,8 @@ import { type MultiDragPreviewInput } from "./timelineMultiDragPreview";
 import { useTimelineEditContextOptional } from "../../contexts/TimelineEditContext";
 import type { Rect } from "../../utils/marqueeGeometry";
 import { TimelineClip } from "./TimelineClip";
-import { TimelineLanes, type TimelineLaneBaseProps } from "./TimelineLanes";
+import { TimelineLanes } from "./TimelineLanes";
+import type { TimelineLaneBaseProps } from "./TimelineLaneTypes";
 import { renderClipChildren } from "./timelineClipChildren";
 import { useTimelineRevealClip } from "./useTimelineRevealClip";
 import type { TimelineLaneGapStrips } from "./useTimelineGapHighlights";
diff --git a/packages/studio/src/player/components/TimelineLaneTypes.ts b/packages/studio/src/player/components/TimelineLaneTypes.ts
new file mode 100644
index 0000000000..4dc0f7746b
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineLaneTypes.ts
@@ -0,0 +1,85 @@
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import type { MusicBeatAnalysis } from "@hyperframes/core/beats";
+import type { ReactNode } from "react";
+import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
+import type { TimelineTheme } from "./timelineTheme";
+import type { BlockedClipState, DraggedClipState, ResizingClipState } from "./useTimelineClipDrag";
+import type { TrackVisualStyle } from "./timelineIcons";
+import type { KeyframeCacheEntry, TimelineElement } from "../store/playerStore";
+
+/**
+ * Props shared by the scroll container ({@link TimelineCanvas}) and its lane
+ * renderer. TimelineCanvas passes these straight through via spread, so
+ * they are declared once here and both prop types compose from this base — no
+ * duplicated prop list.
+ */
+export interface TimelineLaneBaseProps {
+  pps: number;
+  contentOrigin: number;
+  contentGutter: number;
+  trackContentWidth: number;
+  theme: TimelineTheme;
+  displayTrackOrder: number[];
+  rowHeights: readonly number[];
+  trackOrder: number[];
+  tracks: [number, TimelineElement[]][];
+  trackStyles: Map<number, TrackVisualStyle>;
+  laneCounts: ReadonlyMap<string, number>;
+  selectedElementId: string | null;
+  selectedElementIds: Set<string>;
+  hoveredClip: string | null;
+  draggedClip: DraggedClipState | null;
+  blockedClipRef: React.RefObject<BlockedClipState | null>;
+  suppressClickRef: React.RefObject<boolean>;
+  scrollRef: React.RefObject<HTMLDivElement | null>;
+  renderClipContent?: (
+    element: TimelineElement,
+    style: { clip: string; label: string },
+  ) => ReactNode;
+  renderClipOverlay?: (element: TimelineElement) => ReactNode;
+  onDrillDown?: (element: TimelineElement) => void;
+  onSelectElement?: (element: TimelineElement | null) => void;
+  setHoveredClip: (key: string | null) => void;
+  setShowPopover: (v: boolean) => void;
+  setRangeSelection: (v: null) => void;
+  setResizingClip: (v: ResizingClipState | null) => void;
+  setDraggedClip: (v: DraggedClipState | null) => void;
+  setSelectedElementId: (id: string | null) => void;
+  syncClipDragAutoScroll: (x: number, y: number) => void;
+  shiftClickClipRef: React.RefObject<{
+    element: TimelineElement;
+    anchorX: number;
+    anchorY: number;
+  } | null>;
+  getPreviewElement: (element: TimelineElement) => TimelineElement;
+  getTrackStyle: (tag: string) => TrackVisualStyle;
+  keyframeCache?: Map<string, KeyframeCacheEntry>;
+  gsapAnimations: Map<string, GsapAnimation[]>;
+  selectedKeyframes: Set<string>;
+  currentTime: number;
+  onSeek?: (time: number) => void;
+  onSelectSegment?: (elementId: string, target: TimelineKeyframeTarget) => void;
+  onClickKeyframe?: (element: TimelineElement, target: TimelineKeyframeTarget) => void;
+  onShiftClickKeyframe?: (elementId: string, target: TimelineKeyframeTarget) => void;
+  onContextMenuKeyframe?: (
+    e: React.MouseEvent,
+    elementId: string,
+    target: TimelineKeyframeTarget,
+  ) => void;
+  onMoveKeyframe?: (
+    elementId: string,
+    keyframe: TimelineKeyframeTarget,
+    toClipPercentage: number,
+    propertyGroup?: string,
+    tweenPercentage?: number,
+    animationId?: string,
+  ) => Promise<boolean>;
+  onContextMenuClip?: (e: React.MouseEvent, element: TimelineElement) => void;
+  /**
+   * Right-click on EMPTY lane space (not on a clip — those preventDefault
+   * before this fires — not the gutter/ruler, not below the lanes). `time` is
+   * the timeline time (seconds) under the pointer on that lane.
+   */
+  onContextMenuLane?: (e: React.MouseEvent, track: number, time: number) => void;
+  beatAnalysis?: MusicBeatAnalysis | null;
+}
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index d8b622f2ca..1d7fd965b1 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -1,111 +1,24 @@
-import { type ReactNode } from "react";
-import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { BeatStrip, BeatBackgroundLines } from "./BeatStrip";
 import { TimelineClip } from "./TimelineClip";
 import { TimelineClipDiamonds } from "./TimelineClipDiamonds";
 import { TimelinePropertyLanes } from "./TimelinePropertyLanes";
 import { TimelineTrackHeader } from "./TimelineTrackHeader";
 import { resolveTrackKeyframeClip } from "./useTimelineTrackLayout";
-import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
-import type { MusicBeatAnalysis } from "@hyperframes/core/beats";
 import { getTimelineEditCapabilities, resolveBlockedTimelineEditIntent } from "./timelineEditing";
-import type { TimelineTheme } from "./timelineTheme";
 import { CLIP_Y, CLIP_HANDLE_W, TRACK_H, getTimelineRowHeight } from "./timelineLayout";
-import {
-  usePlayerStore,
-  type TimelineElement,
-  type KeyframeCacheEntry,
-} from "../store/playerStore";
-import type { DraggedClipState, ResizingClipState, BlockedClipState } from "./useTimelineClipDrag";
+import { usePlayerStore, type TimelineElement } from "../store/playerStore";
 import {
   isMultiDragPassenger,
   multiDragPassengerOffsetPx,
   type MultiDragPreviewInput,
 } from "./timelineMultiDragPreview";
-import type { TrackVisualStyle } from "./timelineIcons";
 import type { TimelineEditCallbacks } from "./timelineCallbacks";
 import { STUDIO_KEYFRAMES_ENABLED } from "../../components/editor/manualEditingAvailability";
 import { trackStudioKeyframeLaneExpand } from "../../telemetry/events";
 import { SPLIT_BOUNDARY_EPSILON_S } from "../../utils/timelineElementSplit";
 import { isAudioTimelineElement, isMusicTrack } from "../../utils/timelineInspector";
 import { renderClipChildren } from "./timelineClipChildren";
-
-/**
- * Props shared by the scroll container ({@link TimelineCanvas}) and the lane
- * renderer below. TimelineCanvas passes these straight through via spread, so
- * they are declared once here and both prop types compose from this base — no
- * duplicated prop list.
- */
-export interface TimelineLaneBaseProps {
-  pps: number;
-  contentOrigin: number;
-  contentGutter: number;
-  trackContentWidth: number;
-  theme: TimelineTheme;
-  displayTrackOrder: number[];
-  rowHeights: readonly number[];
-  trackOrder: number[];
-  tracks: [number, TimelineElement[]][];
-  trackStyles: Map<number, TrackVisualStyle>;
-  laneCounts: ReadonlyMap<string, number>;
-  selectedElementId: string | null;
-  selectedElementIds: Set<string>;
-  hoveredClip: string | null;
-  draggedClip: DraggedClipState | null;
-  blockedClipRef: React.RefObject<BlockedClipState | null>;
-  suppressClickRef: React.RefObject<boolean>;
-  scrollRef: React.RefObject<HTMLDivElement | null>;
-  renderClipContent?: (
-    element: TimelineElement,
-    style: { clip: string; label: string },
-  ) => ReactNode;
-  renderClipOverlay?: (element: TimelineElement) => ReactNode;
-  onDrillDown?: (element: TimelineElement) => void;
-  onSelectElement?: (element: TimelineElement | null) => void;
-  setHoveredClip: (key: string | null) => void;
-  setShowPopover: (v: boolean) => void;
-  setRangeSelection: (v: null) => void;
-  setResizingClip: (v: ResizingClipState | null) => void;
-  setDraggedClip: (v: DraggedClipState | null) => void;
-  setSelectedElementId: (id: string | null) => void;
-  syncClipDragAutoScroll: (x: number, y: number) => void;
-  shiftClickClipRef: React.RefObject<{
-    element: TimelineElement;
-    anchorX: number;
-    anchorY: number;
-  } | null>;
-  getPreviewElement: (element: TimelineElement) => TimelineElement;
-  getTrackStyle: (tag: string) => TrackVisualStyle;
-  keyframeCache?: Map<string, KeyframeCacheEntry>;
-  gsapAnimations: Map<string, GsapAnimation[]>;
-  selectedKeyframes: Set<string>;
-  currentTime: number;
-  onSeek?: (time: number) => void;
-  onSelectSegment?: (elementId: string, target: TimelineKeyframeTarget) => void;
-  onClickKeyframe?: (element: TimelineElement, target: TimelineKeyframeTarget) => void;
-  onShiftClickKeyframe?: (elementId: string, target: TimelineKeyframeTarget) => void;
-  onContextMenuKeyframe?: (
-    e: React.MouseEvent,
-    elementId: string,
-    target: TimelineKeyframeTarget,
-  ) => void;
-  onMoveKeyframe?: (
-    elementId: string,
-    keyframe: TimelineKeyframeTarget,
-    toClipPercentage: number,
-    propertyGroup?: string,
-    tweenPercentage?: number,
-    animationId?: string,
-  ) => Promise<boolean>;
-  onContextMenuClip?: (e: React.MouseEvent, element: TimelineElement) => void;
-  /**
-   * Right-click on EMPTY lane space (not on a clip — those preventDefault
-   * before this fires — not the gutter/ruler, not below the lanes). `time` is
-   * the timeline time (seconds) under the pointer on that lane.
-   */
-  onContextMenuLane?: (e: React.MouseEvent, track: number, time: number) => void;
-  beatAnalysis?: MusicBeatAnalysis | null;
-}
+import type { TimelineLaneBaseProps } from "./TimelineLaneTypes";
 
 interface TimelineLanesProps extends TimelineLaneBaseProps {
   /** Live-derived by TimelineCanvas from {@link TimelineLaneBaseProps.draggedClip}. */
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 0ac3cb856a..9c1c765990 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -1,6 +1,7 @@
-import { formatTime } from "../lib/time";
 import type { ZoomMode } from "../store/playerStore";
 
+export { formatTimelineTickLabel, generateTicks } from "./timelineRulerGeometry";
+
 /* ── Layout constants ──────────────────────────────────────────────── */
 export const GUTTER = 32;
 export const LABEL_COL_W = 232;
@@ -193,123 +194,6 @@ export const MIN_TIMELINE_EXTENT_S = 60;
 export const FIT_ZOOM_HEADROOM = 1.2;
 
 /* ── Tick generation ──────────────────────────────────────────────── */
-// fallow-ignore-next-line complexity
-function getMajorTickInterval(
-  duration: number,
-  pixelsPerSecond?: number,
-  frameRate?: number,
-): number {
-  // "Nice" NLE steps: 1-2-5 sub-second decades, then 1s/2s/5s/10s/15s/30s,
-  // minute multiples, and 15m/30m/1h so ultra-zoomed-out long comps still get
-  // readable (non-colliding) labels instead of the old 10m fallback everywhere.
-  const zoomIntervals = [
-    0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 15, 30, 60, 120, 300, 600, 900, 1800, 3600,
-  ];
-  let interval: number;
-  if (Number.isFinite(pixelsPerSecond) && (pixelsPerSecond ?? 0) > 0) {
-    const targetMajorPx = 88;
-    interval =
-      zoomIntervals.find((candidate) => candidate * (pixelsPerSecond ?? 0) >= targetMajorPx) ??
-      3600;
-  } else {
-    const durationIntervals = [0.25, 0.5, 1, 2, 5, 10, 15, 30, 60];
-    const target = duration / 6;
-    interval = durationIntervals.find((candidate) => candidate >= target) ?? 60;
-  }
-  // Frame display mode: labels are frame numbers, so a major step must be a
-  // WHOLE number of frames — sub-frame steps produce duplicate/uneven labels
-  // (e.g. 0.02s at 30fps is 0.6 frames → "0, 1, 1, 2, 2…"). Snap UP (ceil) so
-  // the label spacing never drops below the readability target.
-  if (Number.isFinite(frameRate) && (frameRate ?? 0) > 0) {
-    const fps = frameRate ?? 0;
-    return Math.max(1, Math.ceil(interval * fps - 1e-6)) / fps;
-  }
-  return interval;
-}
-
-// How many equal parts to split each major interval into for minor ticks. Prefer
-// quarters (4) so the midpoint stays a minor tick; fall back to halves (2) then
-// none (0) as ticks get too dense to read (< ~8px apart). In frame display mode
-// the subdivision must also keep minor ticks on WHOLE frames (a minor tick at a
-// sub-frame time is not a seekable position), so only divisors of the major
-// step's frame count qualify — quarters, then fifths (15/30-frame majors),
-// thirds, halves.
-// fallow-ignore-next-line complexity
-function getMinorSubdivisions(
-  majorInterval: number,
-  pixelsPerSecond?: number,
-  frameRate?: number,
-): number {
-  const pps = Number.isFinite(pixelsPerSecond) ? (pixelsPerSecond ?? 0) : 0;
-  if (pps <= 0) return 4; // no zoom info (duration-fit mode): quarter ticks
-  const fps = Number.isFinite(frameRate) ? (frameRate ?? 0) : 0;
-  const majorFrames = fps > 0 ? Math.round(majorInterval * fps) : 0;
-  const candidates = fps > 0 ? [4, 5, 3, 2] : [4, 2];
-  for (const parts of candidates) {
-    if (fps > 0 && majorFrames % parts !== 0) continue;
-    if ((majorInterval / parts) * pps >= 8) return parts;
-  }
-  return 0;
-}
-
-// Ticks are exact multiples of the interval (multiplied per index, never
-// accumulated with `+=`, so long rulers don't drift), then rounded to 1µs to
-// keep values/keys clean without disturbing frame-exact positions like 2/30s.
-function roundTickValue(t: number): number {
-  return Math.round(t * 1e6) / 1e6;
-}
-
-export function generateTicks(
-  duration: number,
-  pixelsPerSecond?: number,
-  frameRate?: number,
-): { major: number[]; minor: number[] } {
-  if (duration <= 0 || !Number.isFinite(duration) || duration > 14400)
-    return { major: [], minor: [] };
-  const majorInterval = getMajorTickInterval(duration, pixelsPerSecond, frameRate);
-  const subdivisions = getMinorSubdivisions(majorInterval, pixelsPerSecond, frameRate);
-  const minorInterval = subdivisions > 0 ? majorInterval / subdivisions : 0;
-  const major: number[] = [];
-  const minor: number[] = [];
-  const maxTicks = 2000; // Safety cap to prevent runaway tick generation
-  for (let i = 0; major.length < maxTicks; i++) {
-    const t = i * majorInterval;
-    if (t > duration + 0.001) break;
-    major.push(roundTickValue(t));
-    // Emit the (subdivisions - 1) minor ticks between this major and the next.
-    for (let k = 1; k < subdivisions && major.length + minor.length < maxTicks; k++) {
-      const m = t + k * minorInterval;
-      if (m <= duration + 0.001) minor.push(roundTickValue(m));
-    }
-  }
-  return { major, minor };
-}
-
-export function formatTimelineTickLabel(time: number, duration: number, majorInterval: number) {
-  if (!Number.isFinite(time)) return "00:00";
-  const safeTime = Math.max(0, time);
-  if (majorInterval < 0.1) {
-    const totalHundredths = Math.round(safeTime * 100);
-    const wholeSeconds = Math.floor(totalHundredths / 100);
-    const hundredth = totalHundredths % 100;
-    return `${formatTime(wholeSeconds)}.${hundredth.toString().padStart(2, "0")}`;
-  }
-  if (majorInterval < 1) {
-    const totalTenths = Math.round(safeTime * 10);
-    const wholeSeconds = Math.floor(totalTenths / 10);
-    const tenth = totalTenths % 10;
-    return `${formatTime(wholeSeconds)}.${tenth}`;
-  }
-  if (duration >= 3600 || safeTime >= 3600) {
-    const totalSeconds = Math.floor(safeTime);
-    const hours = Math.floor(totalSeconds / 3600);
-    const minutes = Math.floor((totalSeconds % 3600) / 60);
-    const seconds = totalSeconds % 60;
-    return `${hours}:${minutes.toString().padStart(2, "0")}:${seconds.toString().padStart(2, "0")}`;
-  }
-  return formatTime(safeTime);
-}
-
 /* ── Width / duration derivation ──────────────────────────────────── */
 /**
  * Fit-mode pixels-per-second: fill the viewport with the composition plus
diff --git a/packages/studio/src/player/components/timelineRulerGeometry.ts b/packages/studio/src/player/components/timelineRulerGeometry.ts
new file mode 100644
index 0000000000..59d1c4794c
--- /dev/null
+++ b/packages/studio/src/player/components/timelineRulerGeometry.ts
@@ -0,0 +1,105 @@
+import { formatTime } from "../lib/time";
+
+// fallow-ignore-next-line complexity
+function getTimelineMajorTickInterval(
+  duration: number,
+  pixelsPerSecond?: number,
+  frameRate?: number,
+): number {
+  const zoomIntervals = [
+    0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 15, 30, 60, 120, 300, 600, 900, 1800, 3600,
+  ];
+  let interval: number;
+  if (Number.isFinite(pixelsPerSecond) && (pixelsPerSecond ?? 0) > 0) {
+    const targetMajorPx = 88;
+    interval =
+      zoomIntervals.find((candidate) => candidate * (pixelsPerSecond ?? 0) >= targetMajorPx) ??
+      3600;
+  } else {
+    const durationIntervals = [0.25, 0.5, 1, 2, 5, 10, 15, 30, 60];
+    const target = duration / 6;
+    interval = durationIntervals.find((candidate) => candidate >= target) ?? 60;
+  }
+  if (Number.isFinite(frameRate) && (frameRate ?? 0) > 0) {
+    const fps = frameRate ?? 0;
+    return Math.max(1, Math.ceil(interval * fps - 1e-6)) / fps;
+  }
+  return interval;
+}
+
+// fallow-ignore-next-line complexity
+function getMinorSubdivisions(
+  majorInterval: number,
+  pixelsPerSecond?: number,
+  frameRate?: number,
+): number {
+  const pps = Number.isFinite(pixelsPerSecond) ? (pixelsPerSecond ?? 0) : 0;
+  if (pps <= 0) return 4;
+  const fps = Number.isFinite(frameRate) ? (frameRate ?? 0) : 0;
+  const majorFrames = fps > 0 ? Math.round(majorInterval * fps) : 0;
+  const candidates = fps > 0 ? [4, 5, 3, 2] : [4, 2];
+  for (const parts of candidates) {
+    if (fps > 0 && majorFrames % parts !== 0) continue;
+    if ((majorInterval / parts) * pps >= 8) return parts;
+  }
+  return 0;
+}
+
+function roundTickValue(time: number): number {
+  return Math.round(time * 1e6) / 1e6;
+}
+
+export function generateTicks(
+  duration: number,
+  pixelsPerSecond?: number,
+  frameRate?: number,
+): { major: number[]; minor: number[] } {
+  if (duration <= 0 || !Number.isFinite(duration) || duration > 14400) {
+    return { major: [], minor: [] };
+  }
+  const majorInterval = getTimelineMajorTickInterval(duration, pixelsPerSecond, frameRate);
+  const subdivisions = getMinorSubdivisions(majorInterval, pixelsPerSecond, frameRate);
+  const minorInterval = subdivisions > 0 ? majorInterval / subdivisions : 0;
+  const major: number[] = [];
+  const minor: number[] = [];
+  const maxTicks = 2000;
+  for (let index = 0; major.length < maxTicks; index++) {
+    const time = index * majorInterval;
+    if (time > duration + 0.001) break;
+    major.push(roundTickValue(time));
+    for (let part = 1; part < subdivisions && major.length + minor.length < maxTicks; part++) {
+      const minorTime = time + part * minorInterval;
+      if (minorTime <= duration + 0.001) minor.push(roundTickValue(minorTime));
+    }
+  }
+  return { major, minor };
+}
+
+export function formatTimelineTickLabel(
+  time: number,
+  duration: number,
+  majorInterval: number,
+): string {
+  if (!Number.isFinite(time)) return "00:00";
+  const safeTime = Math.max(0, time);
+  if (majorInterval < 0.1) {
+    const totalHundredths = Math.round(safeTime * 100);
+    const wholeSeconds = Math.floor(totalHundredths / 100);
+    const hundredth = totalHundredths % 100;
+    return `${formatTime(wholeSeconds)}.${hundredth.toString().padStart(2, "0")}`;
+  }
+  if (majorInterval < 1) {
+    const totalTenths = Math.round(safeTime * 10);
+    const wholeSeconds = Math.floor(totalTenths / 10);
+    const tenth = totalTenths % 10;
+    return `${formatTime(wholeSeconds)}.${tenth}`;
+  }
+  if (duration >= 3600 || safeTime >= 3600) {
+    const totalSeconds = Math.floor(safeTime);
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    return `${hours}:${minutes.toString().padStart(2, "0")}:${seconds.toString().padStart(2, "0")}`;
+  }
+  return formatTime(safeTime);
+}
diff --git a/packages/studio/src/player/components/timelineViewModel.ts b/packages/studio/src/player/components/timelineViewModel.ts
new file mode 100644
index 0000000000..86b1860399
--- /dev/null
+++ b/packages/studio/src/player/components/timelineViewModel.ts
@@ -0,0 +1,43 @@
+import type { TimelineElement } from "../store/playerStore";
+import type { ResizingClipState } from "./timelineClipDragTypes";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import { animationContributesLane } from "./TimelinePropertyLanes";
+
+export function hasKeyframedTimelineClips(
+  animationsByElement: ReadonlyMap<string, readonly GsapAnimation[]>,
+): boolean {
+  return Array.from(animationsByElement.values()).some((animations) =>
+    animations.some(animationContributesLane),
+  );
+}
+
+export function getEffectiveTimelineDuration(
+  duration: number,
+  elements: readonly TimelineElement[],
+): number {
+  const safeDuration = Number.isFinite(duration) ? duration : 0;
+  if (elements.length === 0) return safeDuration;
+  const result = Math.max(
+    safeDuration,
+    ...elements.map((element) => element.start + element.duration),
+  );
+  return Number.isFinite(result) ? result : safeDuration;
+}
+
+export function getTimelinePreviewElement(
+  element: TimelineElement,
+  resizingClip: ResizingClipState | null,
+): TimelineElement {
+  if (
+    resizingClip &&
+    (resizingClip.element.key ?? resizingClip.element.id) === (element.key ?? element.id)
+  ) {
+    return {
+      ...element,
+      start: resizingClip.previewStart,
+      duration: resizingClip.previewDuration,
+      playbackStart: resizingClip.previewPlaybackStart,
+    };
+  }
+  return element;
+}
diff --git a/packages/studio/src/player/components/useTimelineSelectionLifecycle.ts b/packages/studio/src/player/components/useTimelineSelectionLifecycle.ts
new file mode 100644
index 0000000000..3781c87b2f
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineSelectionLifecycle.ts
@@ -0,0 +1,27 @@
+import { useEffect, useMemo, useRef } from "react";
+import type { TimelineElement } from "../store/playerStore";
+
+export function useTimelineSelectionLifecycle(
+  elements: TimelineElement[],
+  selectedElementId: string | null,
+  setShowPopover: (show: boolean) => void,
+  clearRangeSelection: () => void,
+): void {
+  const selectedElement = useMemo(
+    () => elements.find((element) => (element.key ?? element.id) === selectedElementId) ?? null,
+    [elements, selectedElementId],
+  );
+  const selectedElementRef = useRef<TimelineElement | null>(selectedElement);
+  selectedElementRef.current = selectedElement;
+  const previousSelectedRef = useRef(selectedElementRef.current);
+  // eslint-disable-next-line no-restricted-syntax, react-hooks/exhaustive-deps
+  useEffect(() => {
+    const previous = previousSelectedRef.current;
+    const current = selectedElementRef.current;
+    previousSelectedRef.current = current;
+    if (previous && !current) {
+      setShowPopover(false);
+      clearRangeSelection();
+    }
+  });
+}
diff --git a/packages/studio/src/player/components/useTimelineShiftModifier.ts b/packages/studio/src/player/components/useTimelineShiftModifier.ts
new file mode 100644
index 0000000000..7c334e4989
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineShiftModifier.ts
@@ -0,0 +1,20 @@
+import { useState } from "react";
+import { useMountEffect } from "../../hooks/useMountEffect";
+
+export function useTimelineShiftModifier(): boolean {
+  const [shiftHeld, setShiftHeld] = useState(false);
+  useMountEffect(() => {
+    const handleKey = (event: KeyboardEvent) =>
+      event.key === "Shift" && setShiftHeld(event.type === "keydown");
+    const handleBlur = () => setShiftHeld(false);
+    window.addEventListener("keydown", handleKey);
+    window.addEventListener("keyup", handleKey);
+    window.addEventListener("blur", handleBlur);
+    return () => {
+      window.removeEventListener("keydown", handleKey);
+      window.removeEventListener("keyup", handleKey);
+      window.removeEventListener("blur", handleBlur);
+    };
+  });
+  return shiftHeld;
+}
diff --git a/packages/studio/src/player/components/useTimelineTicks.ts b/packages/studio/src/player/components/useTimelineTicks.ts
new file mode 100644
index 0000000000..86c1caad56
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineTicks.ts
@@ -0,0 +1,16 @@
+import { useMemo } from "react";
+import { STUDIO_PREVIEW_FPS } from "../lib/time";
+import { generateTicks } from "./timelineLayout";
+
+export function useTimelineTicks(
+  duration: number,
+  pixelsPerSecond: number,
+  timeDisplayMode: "time" | "frame",
+): { major: number[]; minor: number[] } {
+  const frameRate = timeDisplayMode === "frame" ? STUDIO_PREVIEW_FPS : undefined;
+  const { major, minor } = useMemo(
+    () => generateTicks(duration, pixelsPerSecond, frameRate),
+    [duration, frameRate, pixelsPerSecond],
+  );
+  return { major, minor };
+}
diff --git a/packages/studio/src/player/hooks/timelinePlayerSync.ts b/packages/studio/src/player/hooks/timelinePlayerSync.ts
new file mode 100644
index 0000000000..cf937f8882
--- /dev/null
+++ b/packages/studio/src/player/hooks/timelinePlayerSync.ts
@@ -0,0 +1,20 @@
+import type { TimelineElement } from "../store/playerStore";
+
+/** Whether a derived timeline changes any field that affects rendering. */
+export function timelineElementsChanged(
+  previous: TimelineElement[],
+  next: TimelineElement[],
+): boolean {
+  if (next.length !== previous.length) return true;
+  return next.some((element, index) => {
+    const prior = previous[index];
+    return (
+      !prior ||
+      element.id !== prior.id ||
+      element.start !== prior.start ||
+      element.duration !== prior.duration ||
+      element.track !== prior.track ||
+      element.sourceDuration !== prior.sourceDuration
+    );
+  });
+}
diff --git a/packages/studio/src/player/hooks/useTimelinePlayer.ts b/packages/studio/src/player/hooks/useTimelinePlayer.ts
index 39be707e68..726b64b3d6 100644
--- a/packages/studio/src/player/hooks/useTimelinePlayer.ts
+++ b/packages/studio/src/player/hooks/useTimelinePlayer.ts
@@ -43,26 +43,7 @@ import { applyCachedSourceDurations, probeMissingSourceDurations } from "../lib/
 import { shouldResumeForwardPlaybackAfterSeek, shouldStopAfterSeek } from "../lib/playbackSeek";
 import { applyPreviewVariablesToUrl } from "../../hooks/previewVariablesStore";
 import { acceptStudioRuntimeMessage } from "../lib/runtimeProtocol";
-
-/**
- * Whether the derived elements differ from the current ones in any field that
- * affects rendering (identity, timing, track, or source length) — used to skip
- * redundant store writes.
- */
-function timelineElementsChanged(prev: TimelineElement[], next: TimelineElement[]): boolean {
-  if (next.length !== prev.length) return true;
-  return next.some((el, i) => {
-    const p = prev[i];
-    return (
-      !p ||
-      el.id !== p.id ||
-      el.start !== p.start ||
-      el.duration !== p.duration ||
-      el.track !== p.track ||
-      el.sourceDuration !== p.sourceDuration
-    );
-  });
-}
+import { timelineElementsChanged } from "./timelinePlayerSync";
 
 export function useTimelinePlayer() {
   const iframeRef = useRef<HTMLIFrameElement | null>(null);

From 13367e5c6925d8e7599e47ad911b448b620346b0 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 19:28:52 +0200
Subject: [PATCH 109/125] perf(studio): centralize timeline viewport geometry

---
 .../studio/src/components/nle/NLEContext.tsx  |   5 +-
 .../src/components/nle/TimelinePane.tsx       |   2 +
 .../src/hooks/useStudioTestHooks.test.tsx     |   5 +
 .../studio/src/hooks/useStudioTestHooks.ts    |   3 +
 .../src/player/components/Timeline.test.ts    |  22 +++
 .../studio/src/player/components/Timeline.tsx |  79 ++++++--
 .../src/player/components/TimelineTypes.ts    |   2 +
 .../src/player/components/timelineDragDrop.ts |  10 +-
 .../player/components/timelineLayout.test.ts  |  20 ++
 .../src/player/components/timelineLayout.ts   | 178 ++++++++++++------
 .../components/timelineViewportGeometry.ts    |  31 +++
 .../components/useTimelineActiveClips.ts      |   2 +-
 .../player/components/useTimelineClipDrag.ts  |  26 ++-
 .../player/components/useTimelineGeometry.ts  |  15 +-
 .../components/useTimelineRangeSelection.ts   |   9 +-
 .../useTimelineScrollViewport.test.tsx        |  78 ++++++++
 .../components/useTimelineScrollViewport.ts   |  89 ++++++++-
 .../components/useTimelineTrackLayout.test.ts |   2 +
 .../components/useTimelineTrackLayout.ts      |  57 ++++--
 .../src/player/hooks/useTimelinePlayer.ts     |   4 +
 .../studio/src/player/lib/playbackScrub.ts    |   4 +-
 .../player/lib/timelineElementIndexes.test.ts |  31 +++
 .../src/player/lib/timelineElementIndexes.ts  |  43 +++++
 .../player/lib/timelinePerformanceFixture.ts  |  10 +
 .../src/player/store/playerStore.test.ts      |  15 ++
 .../studio/src/player/store/playerStore.ts    |  81 +++++---
 .../timeline-virtualization/index.html        |   1 +
 .../tests/e2e/timeline-virtualization.mjs     |  67 +++++--
 28 files changed, 705 insertions(+), 186 deletions(-)
 create mode 100644 packages/studio/src/player/components/timelineViewportGeometry.ts
 create mode 100644 packages/studio/src/player/components/useTimelineScrollViewport.test.tsx
 create mode 100644 packages/studio/src/player/lib/timelineElementIndexes.test.ts
 create mode 100644 packages/studio/src/player/lib/timelineElementIndexes.ts

diff --git a/packages/studio/src/components/nle/NLEContext.tsx b/packages/studio/src/components/nle/NLEContext.tsx
index 5bdece6459..8874acb80e 100644
--- a/packages/studio/src/components/nle/NLEContext.tsx
+++ b/packages/studio/src/components/nle/NLEContext.tsx
@@ -48,6 +48,7 @@ export interface NLEContextValue {
   compositionLoading: boolean;
   setCompositionLoading: (loading: boolean) => void;
   timelineDisabled: boolean;
+  timelineSessionEpoch: number;
   hasLoadedOnceRef: React.MutableRefObject<boolean>;
   // preview composition size (for preview block drop)
   previewCompositionSize: { width: number; height: number } | null;
@@ -103,7 +104,7 @@ export function NLEProvider({
   // project would otherwise keep rendering (and re-fetching from) the old project
   // after switching.
   useEffect(() => {
-    usePlayerStore.getState().reset();
+    usePlayerStore.getState().beginTimelineSession(projectId);
     useAssetPreviewStore.getState().clearPreviewAsset();
   }, [projectId]);
 
@@ -289,6 +290,7 @@ export function NLEProvider({
     setCompositionLoadingRaw(loading);
   }, []);
   const timelineDisabled = shouldDisableTimelineWhileCompositionLoading(compositionLoading);
+  const timelineSessionEpoch = usePlayerStore((state) => state.timelineSessionEpoch);
 
   useEffect(() => {
     onCompositionLoadingChange?.(compositionLoading);
@@ -319,6 +321,7 @@ export function NLEProvider({
     compositionLoading,
     setCompositionLoading,
     timelineDisabled,
+    timelineSessionEpoch,
     hasLoadedOnceRef,
     previewCompositionSize,
     setPreviewCompositionSize,
diff --git a/packages/studio/src/components/nle/TimelinePane.tsx b/packages/studio/src/components/nle/TimelinePane.tsx
index 52f10ae87d..ca40802056 100644
--- a/packages/studio/src/components/nle/TimelinePane.tsx
+++ b/packages/studio/src/components/nle/TimelinePane.tsx
@@ -127,6 +127,7 @@ export function TimelinePane({
     persistTimelineH,
     containerRef,
     timelineDisabled,
+    timelineSessionEpoch,
   } = useNLEContext();
 
   // Move/resize/split come from the timeline edit context, not props — the
@@ -271,6 +272,7 @@ export function TimelinePane({
         >
           <div className="flex-shrink-0">{timelineToolbar}</div>
           <Timeline
+            sessionEpoch={timelineSessionEpoch}
             onSeek={seek}
             onDrillDown={handleDrillDown}
             renderClipContent={renderClipContent}
diff --git a/packages/studio/src/hooks/useStudioTestHooks.test.tsx b/packages/studio/src/hooks/useStudioTestHooks.test.tsx
index 847ccfd53b..17e81da6c7 100644
--- a/packages/studio/src/hooks/useStudioTestHooks.test.tsx
+++ b/packages/studio/src/hooks/useStudioTestHooks.test.tsx
@@ -5,6 +5,8 @@ import { afterEach, describe, expect, it, vi } from "vitest";
 import { usePlayerStore } from "../player/store/playerStore";
 import {
   createTimelinePerformanceFixture,
+  hasTimelinePerformanceFixtureLease,
+  setTimelinePerformanceFixtureLease,
   type TimelinePerformanceFixtureProfile,
 } from "../player/lib/timelinePerformanceFixture";
 import { useStudioTestHooks } from "./useStudioTestHooks";
@@ -30,6 +32,7 @@ function Probe(): null {
 
 describe("timeline performance fixture", () => {
   afterEach(() => {
+    setTimelinePerformanceFixtureLease(false);
     window.__studioTest = undefined;
     usePlayerStore.getState().reset();
   });
@@ -101,9 +104,11 @@ describe("timeline performance fixture", () => {
     });
     expect(usePlayerStore.getState().elements).toHaveLength(1_000);
     expect(usePlayerStore.getState().expandedClipIds.size).toBe(1_000);
+    expect(hasTimelinePerformanceFixtureLease()).toBe(true);
     unsubscribe();
     act(() => root.unmount());
     expect(window.__studioTest).toBeUndefined();
+    expect(hasTimelinePerformanceFixtureLease()).toBe(false);
   });
 
   it("does not mutate state when the fixture request is invalid", () => {
diff --git a/packages/studio/src/hooks/useStudioTestHooks.ts b/packages/studio/src/hooks/useStudioTestHooks.ts
index 7e7d822e88..09796a25b2 100644
--- a/packages/studio/src/hooks/useStudioTestHooks.ts
+++ b/packages/studio/src/hooks/useStudioTestHooks.ts
@@ -7,6 +7,7 @@ import {
 } from "../player/lib/timelinePerformanceDiagnostics";
 import {
   createTimelinePerformanceFixture,
+  setTimelinePerformanceFixtureLease,
   type TimelinePerformanceFixtureSpec,
   type TimelinePerformanceFixtureSummary,
 } from "../player/lib/timelinePerformanceFixture";
@@ -70,6 +71,7 @@ export function useStudioTestHooks({
       },
       loadTimelinePerformanceFixture: (spec) => {
         const fixture = createTimelinePerformanceFixture(spec);
+        setTimelinePerformanceFixtureLease(true);
         usePlayerStore.setState({
           currentTime: 0,
           duration: fixture.summary.duration,
@@ -91,6 +93,7 @@ export function useStudioTestHooks({
     };
     window.__studioTest = api;
     return () => {
+      setTimelinePerformanceFixtureLease(false);
       // delete, not `= undefined`: an own key holding undefined keeps
       // `"__studioTest" in window` true, which defeats feature detection.
       delete window.__studioTest;
diff --git a/packages/studio/src/player/components/Timeline.test.ts b/packages/studio/src/player/components/Timeline.test.ts
index 81b095961e..194c4851ad 100644
--- a/packages/studio/src/player/components/Timeline.test.ts
+++ b/packages/studio/src/player/components/Timeline.test.ts
@@ -17,6 +17,8 @@ import {
   shouldShowTimelineShortcutHint,
   shouldHandleTimelineDeleteKey,
   shouldAutoScrollTimeline,
+  getTimelineVisibleTimeRange,
+  getTimelineScrollTopForGeometryChange,
 } from "./Timeline";
 import {
   CLIP_Y,
@@ -32,6 +34,7 @@ import {
   getTimelineDisplayContentWidth,
   getTimelineFitPps,
   getTimelineLaneTop,
+  createTimelineRowGeometry,
 } from "./timelineLayout";
 import { formatTime } from "../lib/time";
 import { usePlayerStore } from "../store/playerStore";
@@ -44,6 +47,25 @@ afterEach(() => {
   usePlayerStore.getState().reset();
 });
 
+describe("timeline viewport geometry", () => {
+  it("derives a clamped visible time range from the raw viewport", () => {
+    expect(
+      getTimelineVisibleTimeRange({ scrollLeft: 300, clientWidth: 500 }, 100, 200, 20),
+    ).toEqual({ start: 1, end: 6 });
+    expect(getTimelineVisibleTimeRange({ scrollLeft: 0, clientWidth: 100 }, 100, 200, 20)).toEqual({
+      start: 0,
+      end: 0,
+    });
+  });
+
+  it("keeps the same row anchored when a row above it expands", () => {
+    const previous = createTimelineRowGeometry([1, 2, 3], [48, 48, 48]);
+    const next = createTimelineRowGeometry([1, 2, 3], [104, 48, 48]);
+    const scrollTop = previous.getRowTop(2) - RULER_H + 6;
+    expect(getTimelineScrollTopForGeometryChange(previous, next, scrollTop)).toBe(scrollTop + 56);
+  });
+});
+
 function getHorizontalGeometry(host: HTMLElement, clipId: string, tickLabel: string) {
   const clip = host.querySelector<HTMLElement>(`[data-el-id="${clipId}"]`);
   if (!clip) throw new Error(`Missing timeline clip ${clipId}`);
diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 79f487ce2c..7a4e61d135 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -1,6 +1,5 @@
-import { useRef, useMemo, useCallback, useState, memo } from "react";
+import { useRef, useMemo, useCallback, useState, useLayoutEffect, memo } from "react";
 import { useMusicBeatAnalysis } from "../../hooks/useMusicBeatAnalysis";
-import { isMusicTrack } from "../../utils/timelineInspector";
 import { remapBeatAnalysisToComposition } from "../../utils/beatEditActions";
 import { usePlayerStore, type TimelineElement } from "../store/playerStore";
 import { useExpandedTimelineElements } from "../hooks/useExpandedTimelineElements";
@@ -42,6 +41,8 @@ import {
 import { useTimelineSelectionLifecycle } from "./useTimelineSelectionLifecycle";
 import { useTimelineShiftModifier } from "./useTimelineShiftModifier";
 import { useTimelineTicks } from "./useTimelineTicks";
+import { getTimelineElementIndexes } from "../lib/timelineElementIndexes";
+import { getTimelineScrollTopForGeometryChange } from "./timelineViewportGeometry";
 
 // Re-export pure utilities so existing imports from "./Timeline" still resolve.
 export {
@@ -58,6 +59,11 @@ export {
   getDefaultDroppedTrack,
 } from "./timelineLayout";
 
+export {
+  getTimelineScrollTopForGeometryChange,
+  getTimelineVisibleTimeRange,
+} from "./timelineViewportGeometry";
+
 export const Timeline = memo(function Timeline({
   onSeek,
   onDrillDown,
@@ -76,6 +82,7 @@ export const Timeline = memo(function Timeline({
   onSplitElement: onSplitElementOverride,
   onSelectElement,
   theme: themeOverrides,
+  sessionEpoch = 0,
 }: TimelineProps = {}) {
   const {
     onMoveElement,
@@ -108,7 +115,7 @@ export const Timeline = memo(function Timeline({
   const rawElements = usePlayerStore((s) => s.elements);
   const expandedElements = useExpandedTimelineElements();
   const beatAnalysis = usePlayerStore((s) => s.beatAnalysis);
-  const musicElement = usePlayerStore((s) => s.elements.find(isMusicTrack) ?? null);
+  const musicElement = usePlayerStore((s) => getTimelineElementIndexes(s.elements).musicElement);
   const beatEdits = usePlayerStore((s) => s.beatEdits);
   const adjustedBeatAnalysis = useMemo(
     () => remapBeatAnalysisToComposition(beatAnalysis, musicElement, beatEdits),
@@ -166,8 +173,20 @@ export const Timeline = memo(function Timeline({
 
   const keyframeCache = usePlayerStore((s) => s.keyframeCache);
   useAutoExpandKeyframedClips(gsapAnimations);
-  const { tracks, trackStyles, trackOrder, trackOrderRef, laneCounts, rowHeights, rowHeightsRef } =
-    useTimelineTrackLayout(expandedElements, gsapAnimations, selectedElementId, selectedElementIds);
+  const {
+    tracks,
+    trackStyles,
+    trackOrder,
+    trackOrderRef,
+    laneCounts,
+    rowGeometry,
+    rowGeometryRef,
+  } = useTimelineTrackLayout(
+    expandedElements,
+    gsapAnimations,
+    selectedElementId,
+    selectedElementIds,
+  );
   const expandedElementsRef = useRef(expandedElements);
   expandedElementsRef.current = expandedElements;
 
@@ -234,7 +253,7 @@ export const Timeline = memo(function Timeline({
     ppsRef,
     durationRef,
     trackOrderRef,
-    rowHeightsRef,
+    rowGeometryRef,
     onMoveElement: pinnedOnMoveElement,
     onMoveElements: pinnedOnMoveElements,
     onResizeElement: pinnedOnResizeElement,
@@ -253,7 +272,7 @@ export const Timeline = memo(function Timeline({
       ppsRef,
       durationRef,
       trackOrderRef,
-      rowHeightsRef,
+      rowGeometryRef,
       contentOrigin,
       onFileDrop: pinnedOnFileDrop,
       onAssetDrop: pinnedOnAssetDrop,
@@ -261,12 +280,39 @@ export const Timeline = memo(function Timeline({
       onCompositionDrop: pinnedOnCompositionDrop,
     });
 
-  const displayLayout = useTimelineDisplayLayout(draggedClip, trackOrder, rowHeights);
-  const { viewportWidth, showShortcutHint, setScrollRef } = useTimelineScrollViewport(scrollRef, [
-    timelineReady,
-    expandedElements.length,
-    displayLayout.totalH,
-  ]);
+  const displayLayout = useTimelineDisplayLayout(draggedClip, trackOrder, rowGeometry);
+  const { viewport, showShortcutHint, setScrollRef, syncScrollViewport } =
+    useTimelineScrollViewport(scrollRef, [
+      timelineReady,
+      expandedElements.length,
+      displayLayout.totalH,
+    ]);
+  const previousLayoutRef = useRef(displayLayout.rowGeometry);
+  const previousSessionEpochRef = useRef(sessionEpoch);
+  useLayoutEffect(() => {
+    const scroll = scrollRef.current;
+    const previousGeometry = previousLayoutRef.current;
+    if (previousSessionEpochRef.current !== sessionEpoch) {
+      previousSessionEpochRef.current = sessionEpoch;
+      lastScrollLeftRef.current = 0;
+      if (scroll) {
+        scroll.scrollLeft = 0;
+        scroll.scrollTop = 0;
+        syncScrollViewport(scroll);
+      }
+    } else if (scroll && previousGeometry !== displayLayout.rowGeometry) {
+      const nextScrollTop = getTimelineScrollTopForGeometryChange(
+        previousGeometry,
+        displayLayout.rowGeometry,
+        scroll.scrollTop,
+      );
+      if (nextScrollTop !== scroll.scrollTop) {
+        scroll.scrollTop = nextScrollTop;
+        syncScrollViewport(scroll);
+      }
+    }
+    previousLayoutRef.current = displayLayout.rowGeometry;
+  }, [displayLayout.rowGeometry, sessionEpoch, syncScrollViewport]);
   const selectedKeyframes = usePlayerStore((s) => s.selectedKeyframes);
   const toggleSelectedKeyframe = usePlayerStore((s) => s.toggleSelectedKeyframe);
   const { onClickKeyframe, onSelectSegment, onShiftClickKeyframe, onContextMenuKeyframe } =
@@ -289,7 +335,7 @@ export const Timeline = memo(function Timeline({
     zoomModeRef,
     manualZoomPercentRef,
   } = useTimelineGeometry({
-    viewportWidth,
+    viewportWidth: viewport.clientWidth,
     effectiveDuration,
     zoomMode,
     manualZoomPercent,
@@ -372,7 +418,7 @@ export const Timeline = memo(function Timeline({
     setShowPopover,
     elementsRef: expandedElementsRef,
     trackOrderRef,
-    rowHeightsRef,
+    rowGeometryRef,
     onSelectElement,
     contentOrigin,
   });
@@ -406,6 +452,7 @@ export const Timeline = memo(function Timeline({
     <div
       ref={setContainerRef}
       aria-label="Timeline"
+      data-timeline-element-count={expandedElements.length}
       className={`relative border-t select-none h-full overflow-hidden ${isDragOver ? "ring-1 ring-inset ring-studio-accent/60" : ""} ${activeTool === "razor" ? "cursor-crosshair" : shiftHeld ? "cursor-crosshair" : "cursor-default"}`}
       onMouseMove={updateRazorGuide}
       onMouseLeave={clearRazorGuide}
@@ -417,10 +464,12 @@ export const Timeline = memo(function Timeline({
     >
       <div
         ref={setScrollRef}
+        data-timeline-scroll-viewport
         tabIndex={-1}
         className={`${zoomMode === "fit" ? "overflow-x-hidden" : "overflow-x-auto"} overflow-y-auto h-full outline-none`}
         onScroll={(e) => {
           lastScrollLeftRef.current = e.currentTarget.scrollLeft; // restored across post-edit reload
+          syncScrollViewport(e.currentTarget, true);
         }}
         onDragOver={handleAssetDragOver}
         onDragLeave={() => clearDropPreview()}
diff --git a/packages/studio/src/player/components/TimelineTypes.ts b/packages/studio/src/player/components/TimelineTypes.ts
index 95313d617f..0838e8dccb 100644
--- a/packages/studio/src/player/components/TimelineTypes.ts
+++ b/packages/studio/src/player/components/TimelineTypes.ts
@@ -5,6 +5,8 @@ import type { TimelineTheme } from "./timelineTheme";
 import type { TimelineEditOverrides } from "./useResolvedTimelineEditCallbacks";
 
 export interface TimelineProps extends TimelineDropCallbacks, TimelineEditOverrides {
+  /** Project-scoped reset boundary; soft source refreshes retain the same epoch. */
+  sessionEpoch?: number;
   onSeek?: (time: number) => void;
   onDrillDown?: (element: TimelineElement) => void;
   renderClipContent?: (
diff --git a/packages/studio/src/player/components/timelineDragDrop.ts b/packages/studio/src/player/components/timelineDragDrop.ts
index 0d3985b7a7..8cd2bfbe78 100644
--- a/packages/studio/src/player/components/timelineDragDrop.ts
+++ b/packages/studio/src/player/components/timelineDragDrop.ts
@@ -5,7 +5,7 @@ import {
   TIMELINE_COMPOSITION_MIME,
 } from "../../utils/timelineCompositionDrop";
 import { usePlayerStore } from "../store/playerStore";
-import { resolveTimelineAssetDrop } from "./timelineLayout";
+import { resolveTimelineAssetDrop, type TimelineRowGeometry } from "./timelineLayout";
 import type { TimelineDropCallbacks } from "./timelineCallbacks";
 
 interface UseTimelineAssetDropOptions extends TimelineDropCallbacks {
@@ -13,7 +13,7 @@ interface UseTimelineAssetDropOptions extends TimelineDropCallbacks {
   ppsRef: RefObject<number>;
   durationRef: RefObject<number>;
   trackOrderRef: RefObject<number[]>;
-  rowHeightsRef: RefObject<readonly number[]>;
+  rowGeometryRef: RefObject<TimelineRowGeometry>;
   contentOrigin: number;
 }
 
@@ -56,7 +56,7 @@ export function useTimelineAssetDrop({
   ppsRef,
   durationRef,
   trackOrderRef,
-  rowHeightsRef,
+  rowGeometryRef,
   contentOrigin,
   onFileDrop,
   onAssetDrop,
@@ -93,7 +93,7 @@ export function useTimelineAssetDrop({
           pixelsPerSecond: ppsRef.current,
           duration: durationRef.current,
           clampStartToDuration: !usePointerStart,
-          rowHeights: rowHeightsRef.current,
+          rowHeights: rowGeometryRef.current.rowHeights,
           trackOrder: trackOrderRef.current,
         },
         clientX,
@@ -104,7 +104,7 @@ export function useTimelineAssetDrop({
         track: pointer.track,
       };
     },
-    [scrollRef, ppsRef, durationRef, trackOrderRef, rowHeightsRef, contentOrigin],
+    [scrollRef, ppsRef, durationRef, trackOrderRef, rowGeometryRef, contentOrigin],
   );
 
   const handleAssetDrop = useCallback(
diff --git a/packages/studio/src/player/components/timelineLayout.test.ts b/packages/studio/src/player/components/timelineLayout.test.ts
index 4cd2fa14d4..488d0662b4 100644
--- a/packages/studio/src/player/components/timelineLayout.test.ts
+++ b/packages/studio/src/player/components/timelineLayout.test.ts
@@ -15,6 +15,8 @@ import {
   getTimelineRowFromY,
   getTimelineRowOffsets,
   getTimelineCanvasHeight,
+  createTimelineRowGeometry,
+  getTimelineRowGeometry,
   trackHeights,
   resolveTimelineAssetDrop,
 } from "./timelineLayout";
@@ -64,6 +66,24 @@ describe("variable timeline row geometry", () => {
       RULER_H + TRACKS_TOP_PAD + 3 * TRACK_H + 2 * LANE_H + TRACKS_BOTTOM_PAD,
     );
   });
+
+  it("reuses one immutable geometry snapshot for one height array", () => {
+    const heights = trackHeights(tracks, new Set(["b"]));
+    const first = getTimelineRowGeometry(heights);
+    expect(getTimelineRowGeometry(heights)).toBe(first);
+    expect(Object.isFrozen(first)).toBe(true);
+    expect(Object.isFrozen(first.rowOffsets)).toBe(true);
+  });
+
+  it("looks up row boundaries through the precomputed geometry", () => {
+    const geometry = createTimelineRowGeometry([4, 8, 12], [48, 104, 76]);
+    expect(getTimelineRowGeometry(geometry.rowHeights)).toBe(geometry);
+    expect(geometry.getRowIndex(8)).toBe(1);
+    expect(geometry.getRowFromY(geometry.getRowTop(1))).toBe(1);
+    expect(geometry.getRowFromY(geometry.getRowTop(2) - 0.001)).toBeLessThan(2);
+    expect(geometry.getRowFromY(geometry.getRowTop(2))).toBe(2);
+    expect(geometry.canvasHeight).toBe(RULER_H + TRACKS_TOP_PAD + 228 + TRACKS_BOTTOM_PAD);
+  });
 });
 
 describe("collapsed timeline row geometry characterization", () => {
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 9c1c765990..345b0d32f2 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -75,55 +75,134 @@ function validRowHeight(height: number | undefined): number {
   return height;
 }
 
-/**
- * Memoized by the rowHeights array identity: a marquee/drag pointer tick calls
- * getTimelineRowTop once per clip, and each call would otherwise rebuild the
- * whole cumulative array (O(clips x rows) allocations per tick). rowHeights is
- * itself memoized upstream (useTimelineTrackLayout), so the identity is stable
- * for the life of a gesture. Callers must treat the result as read-only.
- */
-const rowOffsetsCache = new WeakMap<readonly number[], number[]>();
+export interface TimelineRowGeometry {
+  readonly rowKeys: readonly number[];
+  readonly rowHeights: readonly number[];
+  /** Cumulative row boundaries, including the final bottom boundary. */
+  readonly rowOffsets: readonly number[];
+  readonly rowsHeight: number;
+  readonly canvasHeight: number;
+  getRowIndex(rowKey: number): number;
+  getRowHeight(row: number): number;
+  getRowTop(row: number): number;
+  getRowFromY(contentY: number): number;
+  getRowPositionFromY(contentY: number): {
+    rowFloat: number;
+    row: number;
+    fraction: number;
+    rowHeight: number;
+  };
+}
+
+const rowGeometryCache = new WeakMap<readonly number[], TimelineRowGeometry>();
+const EMPTY_ROW_HEIGHTS: readonly number[] = Object.freeze([]);
+
+/** Build the immutable row snapshot shared by rendering and hit testing. */
+export function createTimelineRowGeometry(
+  rowKeys: readonly number[],
+  rowHeights: readonly number[],
+): TimelineRowGeometry {
+  const heights = Object.freeze(rowHeights.map(validRowHeight));
+  const keys = Object.freeze(
+    heights.map((_, row) => {
+      const key = rowKeys[row];
+      return key !== undefined && Number.isFinite(key) ? key : row;
+    }),
+  );
+  const offsets = [0];
+  for (const height of heights) offsets.push((offsets.at(-1) ?? 0) + height);
+  Object.freeze(offsets);
+  const rowIndexByKey = new Map(keys.map((key, row) => [key, row]));
+
+  const getRowHeight = (row: number) => validRowHeight(heights[row]);
+  const getRowOffset = (row: number) => {
+    if (heights.length === 0) return row * TRACK_H;
+    if (row <= 0) return row * getRowHeight(0);
+    if (row >= heights.length) {
+      return (offsets[heights.length] ?? 0) + (row - heights.length) * TRACK_H;
+    }
+    const wholeRow = Math.floor(row);
+    return (offsets[wholeRow] ?? 0) + (row - wholeRow) * getRowHeight(wholeRow);
+  };
+  const getRowFromY = (contentY: number) => {
+    const y = contentY - RULER_H - TRACKS_TOP_PAD;
+    if (heights.length === 0) return y / TRACK_H;
+    if (y < 0) return y / getRowHeight(0);
+    const rowsHeight = offsets[heights.length] ?? 0;
+    if (y >= rowsHeight) return heights.length + (y - rowsHeight) / TRACK_H;
+
+    // First boundary strictly greater than y. Unlike the old linear scan this
+    // stays logarithmic for large timelines and uses the precomputed offsets.
+    let low = 1;
+    let high = heights.length;
+    while (low < high) {
+      const mid = Math.floor((low + high) / 2);
+      if ((offsets[mid] ?? 0) > y) high = mid;
+      else low = mid + 1;
+    }
+    const row = low - 1;
+    return row + (y - (offsets[row] ?? 0)) / getRowHeight(row);
+  };
+  const geometry: TimelineRowGeometry = {
+    rowKeys: keys,
+    rowHeights: heights,
+    rowOffsets: offsets,
+    rowsHeight: offsets.at(-1) ?? 0,
+    canvasHeight: RULER_H + TRACKS_TOP_PAD + (offsets.at(-1) ?? 0) + TRACKS_BOTTOM_PAD,
+    getRowIndex: (rowKey) => rowIndexByKey.get(rowKey) ?? -1,
+    getRowHeight,
+    getRowTop: (row) => RULER_H + TRACKS_TOP_PAD + getRowOffset(row),
+    getRowFromY,
+    getRowPositionFromY: (contentY) => {
+      const rowFloat = getRowFromY(contentY);
+      const row = Math.floor(rowFloat);
+      return { rowFloat, row, fraction: rowFloat - row, rowHeight: getRowHeight(row) };
+    },
+  };
+  const frozenGeometry = Object.freeze(geometry);
+  rowGeometryCache.set(heights, frozenGeometry);
+  return frozenGeometry;
+}
+
+/** Compatibility accessor; repeated calls for one height-array reuse one snapshot. */
+export function getTimelineRowGeometry(rowHeights: readonly number[]): TimelineRowGeometry {
+  const cached = rowGeometryCache.get(rowHeights);
+  if (cached) return cached;
+  const geometry = createTimelineRowGeometry(
+    rowHeights.map((_, row) => row),
+    rowHeights,
+  );
+  rowGeometryCache.set(rowHeights, geometry);
+  return geometry;
+}
 
 /** Cumulative top offsets, including the final bottom boundary. */
 export function getTimelineRowOffsets(rowHeights: readonly number[]): number[] {
-  const cached = rowOffsetsCache.get(rowHeights);
-  if (cached) return cached;
-  const offsets = [0];
-  for (const height of rowHeights) {
-    offsets.push((offsets[offsets.length - 1] ?? 0) + validRowHeight(height));
-  }
-  rowOffsetsCache.set(rowHeights, offsets);
-  return offsets;
+  return [...getTimelineRowGeometry(rowHeights).rowOffsets];
 }
 
-export function getTimelineRowHeight(row: number, rowHeights: readonly number[] = []): number {
+export function getTimelineRowHeight(
+  row: number,
+  rowHeights: readonly number[] = EMPTY_ROW_HEIGHTS,
+): number {
   return validRowHeight(rowHeights[row]);
 }
 
 function getTimelineRowOffset(row: number, rowHeights: readonly number[]): number {
-  if (rowHeights.length === 0) return row * TRACK_H;
-  const offsets = getTimelineRowOffsets(rowHeights);
-  if (row <= 0) return row * getTimelineRowHeight(0, rowHeights);
-  if (row >= rowHeights.length) {
-    // Deliberately TRACK_H, not the last row's height: rows past the end do not
-    // exist yet, and a row created by dropping there starts unexpanded. The
-    // pre-first-row branch above uses row 0's concrete height instead because
-    // that row DOES exist — the pointer is in the top pad above a real lane.
-    return (offsets[rowHeights.length] ?? 0) + (row - rowHeights.length) * TRACK_H;
-  }
-  const wholeRow = Math.floor(row);
-  const fraction = row - wholeRow;
-  return (offsets[wholeRow] ?? 0) + fraction * getTimelineRowHeight(wholeRow, rowHeights);
+  return getTimelineRowGeometry(rowHeights).getRowTop(row) - RULER_H - TRACKS_TOP_PAD;
 }
 
 /**
  * The y (content-space) of the top edge of track ROW index `row` (0 = first
- * displayed lane). The single source of truth for row→y — the ruler height plus
+ * displayed lane). The single source of truth for row->y: the ruler height plus
  * the top breathing pad plus whole track lanes above it. Every clip/ghost/
- * placeholder/insertion top and every pointer-y→row inversion goes through this
+ * placeholder/insertion top and every pointer-y->row inversion goes through this
  * (or its inverse in {@link getTimelineRowFromY}) so the pad can never drift.
  */
-export function getTimelineRowTop(row: number, rowHeights: readonly number[] = []): number {
+export function getTimelineRowTop(
+  row: number,
+  rowHeights: readonly number[] = EMPTY_ROW_HEIGHTS,
+): number {
   return RULER_H + TRACKS_TOP_PAD + getTimelineRowOffset(row, rowHeights);
 }
 
@@ -132,34 +211,18 @@ export function getTimelineRowTop(row: number, rowHeights: readonly number[] = [
  * space y (used for insert-row / drop-lane decisions). Locates the concrete row
  * from cumulative offsets, then returns its local fractional position.
  */
-export function getTimelineRowFromY(contentY: number, rowHeights: readonly number[] = []): number {
-  const y = contentY - RULER_H - TRACKS_TOP_PAD;
-  if (rowHeights.length === 0) return y / TRACK_H;
-  if (y < 0) return y / getTimelineRowHeight(0, rowHeights);
-
-  const offsets = getTimelineRowOffsets(rowHeights);
-  for (let row = 0; row < rowHeights.length; row += 1) {
-    const bottom = offsets[row + 1] ?? 0;
-    if (y < bottom) {
-      const top = offsets[row] ?? 0;
-      return row + (y - top) / getTimelineRowHeight(row, rowHeights);
-    }
-  }
-  return rowHeights.length + (y - (offsets[rowHeights.length] ?? 0)) / TRACK_H;
+export function getTimelineRowFromY(
+  contentY: number,
+  rowHeights: readonly number[] = EMPTY_ROW_HEIGHTS,
+): number {
+  return getTimelineRowGeometry(rowHeights).getRowFromY(contentY);
 }
 
 export function getTimelineRowPositionFromY(
   contentY: number,
-  rowHeights: readonly number[] = [],
+  rowHeights: readonly number[] = EMPTY_ROW_HEIGHTS,
 ): { rowFloat: number; row: number; fraction: number; rowHeight: number } {
-  const rowFloat = getTimelineRowFromY(contentY, rowHeights);
-  const row = Math.floor(rowFloat);
-  return {
-    rowFloat,
-    row,
-    fraction: rowFloat - row,
-    rowHeight: getTimelineRowHeight(row, rowHeights),
-  };
+  return getTimelineRowGeometry(rowHeights).getRowPositionFromY(contentY);
 }
 
 /** Fractional insert band for the concrete row under a pointer. */
@@ -362,8 +425,7 @@ export function getTimelineCanvasHeight(rowHeights: readonly number[]): number {
   // RULER_H + top pad + lanes + bottom pad. The old TIMELINE_SCROLL_BUFFER is
   // subsumed by TRACKS_BOTTOM_PAD (which is larger), so the drag-into-void space
   // below the last lane is real scrollable surface, not a hidden buffer.
-  const rowsHeight = getTimelineRowOffsets(rowHeights).at(-1) ?? 0;
-  return RULER_H + TRACKS_TOP_PAD + rowsHeight + TRACKS_BOTTOM_PAD;
+  return getTimelineRowGeometry(rowHeights).canvasHeight;
 }
 
 /* ── UI helpers ───────────────────────────────────────────────────── */
diff --git a/packages/studio/src/player/components/timelineViewportGeometry.ts b/packages/studio/src/player/components/timelineViewportGeometry.ts
new file mode 100644
index 0000000000..ee86f834fa
--- /dev/null
+++ b/packages/studio/src/player/components/timelineViewportGeometry.ts
@@ -0,0 +1,31 @@
+import { RULER_H, type TimelineRowGeometry } from "./timelineLayout";
+import type { TimelineScrollViewportSnapshot } from "./useTimelineScrollViewport";
+
+export function getTimelineVisibleTimeRange(
+  viewport: Pick<TimelineScrollViewportSnapshot, "scrollLeft" | "clientWidth">,
+  pixelsPerSecond: number,
+  contentOrigin: number,
+  duration: number,
+): { start: number; end: number } {
+  if (!(pixelsPerSecond > 0) || !(duration > 0)) return { start: 0, end: 0 };
+  const start = Math.max(0, (viewport.scrollLeft - contentOrigin) / pixelsPerSecond);
+  const end = Math.min(
+    duration,
+    Math.max(start, (viewport.scrollLeft + viewport.clientWidth - contentOrigin) / pixelsPerSecond),
+  );
+  return { start: Math.min(start, duration), end };
+}
+
+export function getTimelineScrollTopForGeometryChange(
+  previous: TimelineRowGeometry,
+  next: TimelineRowGeometry,
+  scrollTop: number,
+): number {
+  const anchor = previous.getRowPositionFromY(scrollTop + RULER_H);
+  if (anchor.row < 0 || anchor.row >= previous.rowKeys.length) return scrollTop;
+  const anchorKey = previous.rowKeys[anchor.row];
+  if (anchorKey === undefined) return scrollTop;
+  const nextRow = next.getRowIndex(anchorKey);
+  if (nextRow < 0) return scrollTop;
+  return Math.max(0, scrollTop + next.getRowTop(nextRow) - previous.getRowTop(anchor.row));
+}
diff --git a/packages/studio/src/player/components/useTimelineActiveClips.ts b/packages/studio/src/player/components/useTimelineActiveClips.ts
index 4971b88402..071ed267e4 100644
--- a/packages/studio/src/player/components/useTimelineActiveClips.ts
+++ b/packages/studio/src/player/components/useTimelineActiveClips.ts
@@ -13,7 +13,7 @@ interface ActiveClipRecord {
 interface UseTimelineActiveClipsInput {
   scrollRef: React.RefObject<HTMLDivElement | null>;
   currentTime: number;
-  clipStateVersion: string;
+  clipStateVersion: unknown;
 }
 
 function readFiniteNumber(value: string | undefined): number | null {
diff --git a/packages/studio/src/player/components/useTimelineClipDrag.ts b/packages/studio/src/player/components/useTimelineClipDrag.ts
index da366e6bdb..86ce7173e2 100644
--- a/packages/studio/src/player/components/useTimelineClipDrag.ts
+++ b/packages/studio/src/player/components/useTimelineClipDrag.ts
@@ -6,7 +6,6 @@ import {
 } from "./timelineEditing";
 import { usePlayerStore } from "../store/playerStore";
 import type { TimelineElement } from "../store/playerStore";
-import { isMusicTrack, isAudioTimelineElement } from "../../utils/timelineInspector";
 import { mergeUserBeats } from "../../utils/beatEditing";
 import {
   buildTimelineGroupResizeMembers,
@@ -27,6 +26,8 @@ import type {
   BlockedClipState,
 } from "./timelineClipDragTypes";
 import { mountTimelineClipDragGestureLifecycle } from "./timelineClipDragGestureLifecycle";
+import { getTimelineElementIndexes } from "../lib/timelineElementIndexes";
+import type { TimelineRowGeometry } from "./timelineLayout";
 
 export type {
   DraggedClipState,
@@ -42,7 +43,7 @@ interface UseTimelineClipDragInput {
   ppsRef: React.RefObject<number>;
   durationRef: React.RefObject<number>;
   trackOrderRef: React.RefObject<number[]>;
-  rowHeightsRef?: React.RefObject<readonly number[]>;
+  rowGeometryRef?: React.RefObject<TimelineRowGeometry>;
   onMoveElement?: (
     element: TimelineElement,
     updates: Pick<TimelineElement, "start" | "track">,
@@ -80,7 +81,7 @@ export function useTimelineClipDrag({
   ppsRef,
   durationRef,
   trackOrderRef,
-  rowHeightsRef,
+  rowGeometryRef,
   onMoveElement,
   onMoveElements,
   onResizeElement,
@@ -96,12 +97,11 @@ export function useTimelineClipDrag({
   const rawBeatTimes = usePlayerStore((s) => s.beatAnalysis?.beatTimes ?? EMPTY_BEAT_TIMES);
   const rawBeatStrengths = usePlayerStore((s) => s.beatAnalysis?.beatStrengths ?? EMPTY_BEAT_TIMES);
   const beatEdits = usePlayerStore((s) => s.beatEdits);
-  const musicStart = usePlayerStore((s) => s.elements.find(isMusicTrack)?.start ?? 0);
-  const musicPlaybackStart = usePlayerStore(
-    (s) => s.elements.find(isMusicTrack)?.playbackStart ?? 0,
-  );
-  const musicDuration = usePlayerStore((s) => s.elements.find(isMusicTrack)?.duration ?? 0);
-  const musicSrc = usePlayerStore((s) => s.elements.find(isMusicTrack)?.src ?? null);
+  const musicElement = usePlayerStore((s) => getTimelineElementIndexes(s.elements).musicElement);
+  const musicStart = musicElement?.start ?? 0;
+  const musicPlaybackStart = musicElement?.playbackStart ?? 0;
+  const musicDuration = musicElement?.duration ?? 0;
+  const musicSrc = musicElement?.src ?? null;
 
   const adjustedBeatTimes = useMemo(() => {
     if (rawBeatTimes === EMPTY_BEAT_TIMES || musicDuration === 0) return EMPTY_BEAT_TIMES;
@@ -228,23 +228,21 @@ export function useTimelineClipDrag({
       // Build the audio-track set once per gesture (see snapTargetsCacheRef): it
       // only feeds zone-aware drop placement and is frozen while dragging.
       if (!dragAudioTracksRef.current) {
-        dragAudioTracksRef.current = new Set(
-          elementsRef.current.filter(isAudioTimelineElement).map((e) => e.track),
-        );
+        dragAudioTracksRef.current = getTimelineElementIndexes(elementsRef.current).audioTracks;
       }
       return computeDragPreview(drag, clientX, clientY, {
         scroll: scrollRef.current,
         pps: ppsRef.current,
         duration: durationRef.current,
         trackOrder: trackOrderRef.current,
-        rowHeights: rowHeightsRef?.current,
+        rowHeights: rowGeometryRef?.current.rowHeights,
         elements: elementsRef.current,
         selectedKeys: usePlayerStore.getState().selectedElementIds,
         buildSnapTargets,
         audioTracks: dragAudioTracksRef.current,
       });
     },
-    [scrollRef, ppsRef, durationRef, trackOrderRef, rowHeightsRef, buildSnapTargets],
+    [scrollRef, ppsRef, durationRef, trackOrderRef, rowGeometryRef, buildSnapTargets],
   );
 
   // Recompute the trim preview for a pointer x. Shared by the pointermove resize
diff --git a/packages/studio/src/player/components/useTimelineGeometry.ts b/packages/studio/src/player/components/useTimelineGeometry.ts
index 6241cda973..3c147718c3 100644
--- a/packages/studio/src/player/components/useTimelineGeometry.ts
+++ b/packages/studio/src/player/components/useTimelineGeometry.ts
@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useRef, type RefObject } from "react";
+import { useEffect, useRef, type RefObject } from "react";
 import { usePlayerStore, type TimelineElement, type ZoomMode } from "../store/playerStore";
 import { getTimelinePixelsPerSecond } from "./timelineZoom";
 import {
@@ -78,13 +78,6 @@ export function useTimelineGeometry({
     resizeGhostEndPx,
   });
   const displayDuration = pps > 0 ? displayContentWidth / pps : effectiveDuration;
-  const clipStateVersion = useMemo(
-    () =>
-      expandedElements
-        .map((el) => `${el.key ?? el.id}:${el.start}:${el.duration}:${el.track}`)
-        .join("|"),
-    [expandedElements],
-  );
   const zoomModeRef = useRef(zoomMode);
   zoomModeRef.current = zoomMode;
   const manualZoomPercentRef = useRef(manualZoomPercent);
@@ -92,7 +85,7 @@ export function useTimelineGeometry({
   fitPpsRef.current = fitPps;
 
   // Restore the horizontal scroll offset after an edit re-derives the elements
-  // (clipStateVersion changes) so the reload doesn't jump the view. Only in manual
+  // (the immutable element snapshot changes) so the reload doesn't jump the view. Only in manual
   // (pinned) mode — fit mode hides the x-scrollbar (scrollLeft is always 0) — and
   // never mid-drag (auto-scroll owns the offset then). rAF waits for the new layout
   // so the clamp reads the post-resync scrollWidth. zoomMode is a legitimate dep:
@@ -109,7 +102,7 @@ export function useTimelineGeometry({
     });
     return () => cancelAnimationFrame(raf);
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [clipStateVersion, zoomMode]);
+  }, [expandedElements, zoomMode]);
   // Publish the live scale so edit handlers OUTSIDE <Timeline> (the keyboard-delete
   // path) can pin the zoom via pinTimelineZoomToCurrent without threading geometry.
   // In a useEffect (not the render body) so React-18 concurrent replay — Suspense
@@ -125,7 +118,7 @@ export function useTimelineGeometry({
     fitPps,
     displayContentWidth,
     displayDuration,
-    clipStateVersion,
+    clipStateVersion: expandedElements,
     zoomModeRef,
     manualZoomPercentRef,
   };
diff --git a/packages/studio/src/player/components/useTimelineRangeSelection.ts b/packages/studio/src/player/components/useTimelineRangeSelection.ts
index 1a98e251c6..849b52dcaf 100644
--- a/packages/studio/src/player/components/useTimelineRangeSelection.ts
+++ b/packages/studio/src/player/components/useTimelineRangeSelection.ts
@@ -16,6 +16,7 @@ import {
   type MarqueeClipInput,
 } from "./timelineMarquee";
 import type { Rect } from "../../utils/marqueeGeometry";
+import type { TimelineRowGeometry } from "./timelineLayout";
 
 interface UseTimelineRangeSelectionInput {
   scrollRef: React.RefObject<HTMLDivElement | null>;
@@ -30,7 +31,7 @@ interface UseTimelineRangeSelectionInput {
   setShowPopover: (v: boolean) => void;
   elementsRef: React.RefObject<TimelineElement[]>;
   trackOrderRef: React.RefObject<number[]>;
-  rowHeightsRef: React.RefObject<readonly number[]>;
+  rowGeometryRef: React.RefObject<TimelineRowGeometry>;
   onSelectElement?: (element: TimelineElement | null) => void;
   contentOrigin: number;
 }
@@ -107,7 +108,7 @@ export function useTimelineRangeSelection({
   setShowPopover,
   elementsRef,
   trackOrderRef,
-  rowHeightsRef,
+  rowGeometryRef,
   onSelectElement,
   contentOrigin,
 }: UseTimelineRangeSelectionInput) {
@@ -176,12 +177,12 @@ export function useTimelineRangeSelection({
         marquee,
         elementsRef.current ?? [],
         trackOrderRef.current ?? [],
-        rowHeightsRef.current,
+        rowGeometryRef.current.rowHeights,
         ppsRef.current,
         contentOrigin,
       );
     },
-    [toContentPoint, elementsRef, trackOrderRef, rowHeightsRef, ppsRef, contentOrigin],
+    [toContentPoint, elementsRef, trackOrderRef, rowGeometryRef, ppsRef, contentOrigin],
   );
 
   const stopMarqueeAutoScroll = useCallback(() => {
diff --git a/packages/studio/src/player/components/useTimelineScrollViewport.test.tsx b/packages/studio/src/player/components/useTimelineScrollViewport.test.tsx
new file mode 100644
index 0000000000..f62c8e7ac0
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineScrollViewport.test.tsx
@@ -0,0 +1,78 @@
+// @vitest-environment happy-dom
+
+import React, { act, useRef } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useTimelineScrollViewport } from "./useTimelineScrollViewport";
+
+(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+let resizeCallback: ResizeObserverCallback | null = null;
+class MockResizeObserver {
+  constructor(callback: ResizeObserverCallback) {
+    resizeCallback = callback;
+  }
+  observe() {}
+  disconnect() {}
+}
+
+const originalResizeObserver = globalThis.ResizeObserver;
+
+beforeEach(() => {
+  vi.useFakeTimers();
+  globalThis.ResizeObserver = MockResizeObserver as unknown as typeof ResizeObserver;
+});
+
+afterEach(() => {
+  vi.useRealTimers();
+  globalThis.ResizeObserver = originalResizeObserver;
+  resizeCallback = null;
+  document.body.innerHTML = "";
+});
+
+describe("useTimelineScrollViewport", () => {
+  it("publishes resize, scroll, and settled snapshots", () => {
+    let hook: ReturnType<typeof useTimelineScrollViewport> | undefined;
+    function Probe() {
+      hook = useTimelineScrollViewport(useRef<HTMLDivElement>(null), []);
+      return null;
+    }
+
+    const root = createRoot(document.createElement("div"));
+    act(() => root.render(React.createElement(Probe)));
+    const element = document.createElement("div");
+    const values = {
+      left: 0,
+      top: 0,
+      width: 640,
+      height: 240,
+      scrollWidth: 1200,
+      scrollHeight: 800,
+    };
+    Object.defineProperties(element, {
+      scrollLeft: { configurable: true, get: () => values.left },
+      scrollTop: { configurable: true, get: () => values.top },
+      clientWidth: { configurable: true, get: () => values.width },
+      clientHeight: { configurable: true, get: () => values.height },
+      scrollWidth: { configurable: true, get: () => values.scrollWidth },
+      scrollHeight: { configurable: true, get: () => values.scrollHeight },
+    });
+
+    act(() => hook?.setScrollRef(element));
+    expect(hook?.viewport.clientWidth).toBe(640);
+
+    values.width = 800;
+    act(() => resizeCallback?.([], {} as ResizeObserver));
+    expect(hook?.viewport.clientWidth).toBe(800);
+
+    values.left = 120;
+    values.top = 48;
+    act(() => hook?.syncScrollViewport(element, true));
+    act(() => vi.advanceTimersByTime(16));
+    expect(hook?.viewport).toMatchObject({ scrollLeft: 120, scrollTop: 48, isScrolling: true });
+
+    act(() => vi.advanceTimersByTime(100));
+    expect(hook?.viewport.isScrolling).toBe(false);
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useTimelineScrollViewport.ts b/packages/studio/src/player/components/useTimelineScrollViewport.ts
index 55d5e9a2df..f08f558968 100644
--- a/packages/studio/src/player/components/useTimelineScrollViewport.ts
+++ b/packages/studio/src/player/components/useTimelineScrollViewport.ts
@@ -2,6 +2,44 @@ import { useCallback, useEffect, useRef, useState, type RefObject } from "react"
 import { useMountEffect } from "../../hooks/useMountEffect";
 import { shouldShowTimelineShortcutHint } from "./timelineLayout";
 
+export interface TimelineScrollViewportSnapshot {
+  readonly scrollLeft: number;
+  readonly scrollTop: number;
+  readonly clientWidth: number;
+  readonly clientHeight: number;
+  readonly scrollWidth: number;
+  readonly scrollHeight: number;
+  readonly isScrolling: boolean;
+}
+
+const EMPTY_VIEWPORT: TimelineScrollViewportSnapshot = Object.freeze({
+  scrollLeft: 0,
+  scrollTop: 0,
+  clientWidth: 0,
+  clientHeight: 0,
+  scrollWidth: 0,
+  scrollHeight: 0,
+  isScrolling: false,
+});
+
+function readTimelineScrollViewport(
+  element: Pick<
+    HTMLElement,
+    "scrollLeft" | "scrollTop" | "clientWidth" | "clientHeight" | "scrollWidth" | "scrollHeight"
+  >,
+  isScrolling: boolean,
+): TimelineScrollViewportSnapshot {
+  return {
+    scrollLeft: element.scrollLeft,
+    scrollTop: element.scrollTop,
+    clientWidth: element.clientWidth,
+    clientHeight: element.clientHeight,
+    scrollWidth: element.scrollWidth,
+    scrollHeight: element.scrollHeight,
+    isScrolling,
+  };
+}
+
 /**
  * The timeline scroll container's viewport plumbing — extracted verbatim from
  * Timeline.tsx (600-line studio cap): the ResizeObserver-backed viewport width,
@@ -14,14 +52,40 @@ export function useTimelineScrollViewport(
   scrollRef: RefObject<HTMLDivElement | null>,
   resyncShortcutHintOn: ReadonlyArray<unknown>,
 ): {
-  viewportWidth: number;
+  viewport: TimelineScrollViewportSnapshot;
   showShortcutHint: boolean;
   setScrollRef: (el: HTMLDivElement | null) => void;
+  syncScrollViewport: (el: HTMLDivElement, isScrolling?: boolean) => void;
 } {
-  const [viewportWidth, setViewportWidth] = useState(0);
+  const [viewport, setViewport] = useState<TimelineScrollViewportSnapshot>(EMPTY_VIEWPORT);
   const [showShortcutHint, setShowShortcutHint] = useState(true);
   const roRef = useRef<ResizeObserver | null>(null);
   const shortcutHintRafRef = useRef(0);
+  const viewportRafRef = useRef(0);
+  const scrollSettledTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const scrollingRef = useRef(false);
+
+  const syncScrollViewport = useCallback((el: HTMLDivElement, isScrolling = false) => {
+    scrollingRef.current = isScrolling;
+    const publish = () => {
+      viewportRafRef.current = 0;
+      setViewport(readTimelineScrollViewport(el, scrollingRef.current));
+    };
+    if (isScrolling) {
+      if (!viewportRafRef.current) viewportRafRef.current = requestAnimationFrame(publish);
+    } else {
+      if (viewportRafRef.current) cancelAnimationFrame(viewportRafRef.current);
+      publish();
+      return;
+    }
+    if (scrollSettledTimerRef.current) clearTimeout(scrollSettledTimerRef.current);
+    scrollSettledTimerRef.current = setTimeout(() => {
+      scrollSettledTimerRef.current = null;
+      scrollingRef.current = false;
+      if (viewportRafRef.current) cancelAnimationFrame(viewportRafRef.current);
+      publish();
+    }, 100);
+  }, []);
 
   const syncShortcutHintVisibility = useCallback(() => {
     const scroll = scrollRef.current;
@@ -45,23 +109,30 @@ export function useTimelineScrollViewport(
         roRef.current = null;
       }
       scrollRef.current = el;
-      if (!el) return;
+      if (!el) {
+        if (scrollSettledTimerRef.current) clearTimeout(scrollSettledTimerRef.current);
+        scrollSettledTimerRef.current = null;
+        scrollingRef.current = false;
+        return;
+      }
 
-      const syncScrollViewport = () => {
-        setViewportWidth(el.clientWidth);
+      const syncResize = () => {
+        syncScrollViewport(el, scrollingRef.current);
         scheduleShortcutHintVisibilitySync();
       };
 
-      syncScrollViewport();
-      roRef.current = new ResizeObserver(syncScrollViewport);
+      syncResize();
+      roRef.current = new ResizeObserver(syncResize);
       roRef.current.observe(el);
     },
-    [scrollRef, scheduleShortcutHintVisibilitySync],
+    [scrollRef, scheduleShortcutHintVisibilitySync, syncScrollViewport],
   );
 
   useMountEffect(() => () => {
     roRef.current?.disconnect();
     if (shortcutHintRafRef.current) cancelAnimationFrame(shortcutHintRafRef.current);
+    if (viewportRafRef.current) cancelAnimationFrame(viewportRafRef.current);
+    if (scrollSettledTimerRef.current) clearTimeout(scrollSettledTimerRef.current);
   });
 
   useEffect(() => {
@@ -69,5 +140,5 @@ export function useTimelineScrollViewport(
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [syncShortcutHintVisibility, ...resyncShortcutHintOn]);
 
-  return { viewportWidth, showShortcutHint, setScrollRef };
+  return { viewport, showShortcutHint, setScrollRef, syncScrollViewport };
 }
diff --git a/packages/studio/src/player/components/useTimelineTrackLayout.test.ts b/packages/studio/src/player/components/useTimelineTrackLayout.test.ts
index e2d1b6d293..af54b970bf 100644
--- a/packages/studio/src/player/components/useTimelineTrackLayout.test.ts
+++ b/packages/studio/src/player/components/useTimelineTrackLayout.test.ts
@@ -48,6 +48,8 @@ describe("useTimelineTrackLayout", () => {
 
     expect(layout?.laneCounts.get("clip-1")).toBe(1);
     expect(layout?.rowHeights).toEqual([TRACK_H + LANE_H]);
+    expect(layout?.rowGeometry.rowKeys).toEqual([0]);
+    expect(layout?.rowGeometry.canvasHeight).toBeGreaterThan(TRACK_H + LANE_H);
     act(() => root.unmount());
   });
 });
diff --git a/packages/studio/src/player/components/useTimelineTrackLayout.ts b/packages/studio/src/player/components/useTimelineTrackLayout.ts
index 4aad5a8761..5cb17802a4 100644
--- a/packages/studio/src/player/components/useTimelineTrackLayout.ts
+++ b/packages/studio/src/player/components/useTimelineTrackLayout.ts
@@ -7,8 +7,8 @@ import type { DraggedClipState } from "./timelineClipDragTypes";
 import { useTimelineTrackDerivations } from "./useTimelineTrackDerivations";
 import {
   TRACK_H,
-  getTimelineCanvasHeight,
-  getTimelineRowHeight,
+  createTimelineRowGeometry,
+  type TimelineRowGeometry,
   trackHeights,
   type TimelineTrackHeightClip,
 } from "./timelineLayout";
@@ -73,7 +73,7 @@ function useTimelineRowHeights(
   selectedElementIds: ReadonlySet<string>,
 ) {
   const expandedClipIds = usePlayerStore((s) => s.expandedClipIds);
-  const { laneCounts, rowHeights } = useMemo(() => {
+  const { laneCounts, rowGeometry } = useMemo(() => {
     const laneCounts = computeLaneCounts(tracks, gsapAnimations);
     // Row height follows only the active keyframe clip, so a track with several
     // keyframed elements never reserves empty lanes for the ones not shown.
@@ -88,17 +88,26 @@ function useTimelineRowHeights(
       const clipId = active.key ?? active.id;
       return [{ clipId, laneCount: laneCounts.get(clipId) ?? 0 }];
     });
+    const rowHeights = trackHeights(
+      heightTracks,
+      STUDIO_KEYFRAMES_ENABLED ? expandedClipIds : undefined,
+    );
     return {
       laneCounts,
-      rowHeights: trackHeights(
-        heightTracks,
-        STUDIO_KEYFRAMES_ENABLED ? expandedClipIds : undefined,
+      rowGeometry: createTimelineRowGeometry(
+        tracks.map(([track]) => track),
+        rowHeights,
       ),
     };
   }, [expandedClipIds, gsapAnimations, tracks, selectedElementId, selectedElementIds]);
-  const rowHeightsRef = useRef<readonly number[]>(rowHeights);
-  rowHeightsRef.current = rowHeights;
-  return { laneCounts, rowHeights, rowHeightsRef };
+  const rowGeometryRef = useRef<TimelineRowGeometry>(rowGeometry);
+  rowGeometryRef.current = rowGeometry;
+  return {
+    laneCounts,
+    rowGeometry,
+    rowGeometryRef,
+    rowHeights: rowGeometry.rowHeights,
+  };
 }
 
 export function useTimelineTrackLayout(
@@ -110,7 +119,7 @@ export function useTimelineTrackLayout(
   const { tracks, trackStyles, trackOrder } = useTimelineTrackDerivations(expandedElements);
   const trackOrderRef = useRef(trackOrder);
   trackOrderRef.current = trackOrder;
-  const { laneCounts, rowHeights, rowHeightsRef } = useTimelineRowHeights(
+  const { laneCounts, rowGeometry, rowGeometryRef, rowHeights } = useTimelineRowHeights(
     tracks,
     gsapAnimations,
     selectedElementId,
@@ -123,23 +132,23 @@ export function useTimelineTrackLayout(
     trackOrder,
     trackOrderRef,
     laneCounts,
+    rowGeometry,
+    rowGeometryRef,
     rowHeights,
-    rowHeightsRef,
   };
 }
 
 function useDisplayRowHeights(
   displayTrackOrder: readonly number[],
-  trackOrder: readonly number[],
-  rowHeights: readonly number[],
+  rowGeometry: TimelineRowGeometry,
 ) {
   return useMemo(
     () =>
       displayTrackOrder.map((track) => {
-        const row = trackOrder.indexOf(track);
-        return row < 0 ? TRACK_H : getTimelineRowHeight(row, rowHeights);
+        const row = rowGeometry.getRowIndex(track);
+        return row < 0 ? TRACK_H : rowGeometry.getRowHeight(row);
       }),
-    [displayTrackOrder, trackOrder, rowHeights],
+    [displayTrackOrder, rowGeometry],
   );
 }
 
@@ -153,10 +162,18 @@ function useDisplayTrackOrder(draggedClip: DraggedClipState | null, trackOrder:
 export function useTimelineDisplayLayout(
   draggedClip: DraggedClipState | null,
   trackOrder: number[],
-  rowHeights: readonly number[],
+  rowGeometry: TimelineRowGeometry,
 ) {
   const displayTrackOrder = useDisplayTrackOrder(draggedClip, trackOrder);
-  const displayRowHeights = useDisplayRowHeights(displayTrackOrder, trackOrder, rowHeights);
-  const totalH = getTimelineCanvasHeight(displayRowHeights);
-  return { displayTrackOrder, displayRowHeights, totalH };
+  const displayRowHeights = useDisplayRowHeights(displayTrackOrder, rowGeometry);
+  const displayRowGeometry = useMemo(
+    () => createTimelineRowGeometry(displayTrackOrder, displayRowHeights),
+    [displayTrackOrder, displayRowHeights],
+  );
+  return {
+    displayTrackOrder,
+    displayRowHeights: displayRowGeometry.rowHeights,
+    rowGeometry: displayRowGeometry,
+    totalH: displayRowGeometry.canvasHeight,
+  };
 }
diff --git a/packages/studio/src/player/hooks/useTimelinePlayer.ts b/packages/studio/src/player/hooks/useTimelinePlayer.ts
index 726b64b3d6..9c17d60c50 100644
--- a/packages/studio/src/player/hooks/useTimelinePlayer.ts
+++ b/packages/studio/src/player/hooks/useTimelinePlayer.ts
@@ -39,6 +39,7 @@ import {
 import { normalizeToZones } from "../components/timelineZones";
 import { setPreviewMediaMuted, setPreviewPlaybackRate } from "../lib/timelineIframeHelpers";
 import { scrubMusicAtSeek, stopScrubPreviewAudio } from "../lib/playbackScrub";
+import { hasTimelinePerformanceFixtureLease } from "../lib/timelinePerformanceFixture";
 import { applyCachedSourceDurations, probeMissingSourceDurations } from "../lib/mediaProbe";
 import { shouldResumeForwardPlaybackAfterSeek, shouldStopAfterSeek } from "../lib/playbackSeek";
 import { applyPreviewVariablesToUrl } from "../../hooks/previewVariablesStore";
@@ -62,8 +63,11 @@ export function useTimelinePlayer() {
   const { setIsPlaying, setCurrentTime, setDuration, setTimelineReady, setElements } =
     usePlayerStore.getState();
 
+  // The fixture lease belongs at this shared synchronization boundary so every
+  // iframe discovery path has the same owner for deciding whether it may write.
   const syncTimelineElements = useCallback(
     (elements: TimelineElement[], nextDuration?: number) => {
+      if (hasTimelinePerformanceFixtureLease()) return;
       const state = usePlayerStore.getState();
       const resolvedDuration = nextDuration ?? state.duration;
       // applyCachedSourceDurations re-applies the cached probe duration: re-derived
diff --git a/packages/studio/src/player/lib/playbackScrub.ts b/packages/studio/src/player/lib/playbackScrub.ts
index 227c2a78c1..ae789e410e 100644
--- a/packages/studio/src/player/lib/playbackScrub.ts
+++ b/packages/studio/src/player/lib/playbackScrub.ts
@@ -1,6 +1,6 @@
 import { usePlayerStore } from "../store/playerStore";
-import { isMusicTrack } from "../../utils/timelineInspector";
 import { scrubPreviewAudio, stopScrubPreviewAudio } from "./timelineIframeHelpers";
+import { getTimelineElementIndexes } from "./timelineElementIndexes";
 
 export { stopScrubPreviewAudio };
 
@@ -8,7 +8,7 @@ export { stopScrubPreviewAudio };
 // Skipped when audio is muted or the time falls outside the music clip.
 export function scrubMusicAtSeek(iframe: HTMLIFrameElement | null, nextTime: number): void {
   const s = usePlayerStore.getState();
-  const music = s.elements.find(isMusicTrack);
+  const music = getTimelineElementIndexes(s.elements).musicElement;
   if (!music || s.audioMuted) return;
   const rel = nextTime - music.start;
   const audioFileTime = rel >= 0 && rel <= music.duration ? (music.playbackStart ?? 0) + rel : null;
diff --git a/packages/studio/src/player/lib/timelineElementIndexes.test.ts b/packages/studio/src/player/lib/timelineElementIndexes.test.ts
new file mode 100644
index 0000000000..c1c088352f
--- /dev/null
+++ b/packages/studio/src/player/lib/timelineElementIndexes.test.ts
@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import { getTimelineElementIndexes } from "./timelineElementIndexes";
+
+describe("getTimelineElementIndexes", () => {
+  const elements: TimelineElement[] = [
+    { id: "hero", tag: "img", src: "hero.png", start: 0, duration: 2, track: 0 },
+    {
+      id: "bgm",
+      tag: "audio",
+      src: "music.wav",
+      start: 0,
+      duration: 10,
+      track: 3,
+      timelineRole: "music",
+    },
+  ];
+
+  it("indexes media and music identities", () => {
+    const indexes = getTimelineElementIndexes(elements);
+    expect(indexes.byKey.get("hero")).toBe(elements[0]);
+    expect(indexes.musicElement).toBe(elements[1]);
+    expect(indexes.mediaElements).toEqual(elements);
+    expect(indexes.audioTracks).toEqual(new Set([3]));
+  });
+
+  it("reuses one index for the same immutable array snapshot", () => {
+    expect(getTimelineElementIndexes(elements)).toBe(getTimelineElementIndexes(elements));
+    expect(getTimelineElementIndexes([...elements])).not.toBe(getTimelineElementIndexes(elements));
+  });
+});
diff --git a/packages/studio/src/player/lib/timelineElementIndexes.ts b/packages/studio/src/player/lib/timelineElementIndexes.ts
new file mode 100644
index 0000000000..9def5b73b4
--- /dev/null
+++ b/packages/studio/src/player/lib/timelineElementIndexes.ts
@@ -0,0 +1,43 @@
+import { isAudioTimelineElement, isMusicTrack } from "../../utils/timelineInspector";
+import type { TimelineElement } from "../store/playerStore";
+
+export interface TimelineElementIndexes {
+  readonly byKey: ReadonlyMap<string, TimelineElement>;
+  readonly musicElement: TimelineElement | null;
+  readonly mediaElements: readonly TimelineElement[];
+  readonly audioTracks: ReadonlySet<number>;
+}
+
+const indexCache = new WeakMap<readonly TimelineElement[], TimelineElementIndexes>();
+
+/**
+ * Index a store element snapshot once. Playback-only Zustand updates keep the
+ * same array identity, so selectors can reuse this object without rescanning a
+ * large timeline or triggering a component render.
+ */
+export function getTimelineElementIndexes(
+  elements: readonly TimelineElement[],
+): TimelineElementIndexes {
+  const cached = indexCache.get(elements);
+  if (cached) return cached;
+
+  const byKey = new Map<string, TimelineElement>();
+  const mediaElements: TimelineElement[] = [];
+  const audioTracks = new Set<number>();
+  let musicElement: TimelineElement | null = null;
+  for (const element of elements) {
+    byKey.set(element.key ?? element.id, element);
+    if (element.src) mediaElements.push(element);
+    if (isAudioTimelineElement(element)) audioTracks.add(element.track);
+    if (!musicElement && isMusicTrack(element)) musicElement = element;
+  }
+
+  const indexes = Object.freeze({
+    byKey,
+    musicElement,
+    mediaElements: Object.freeze(mediaElements),
+    audioTracks,
+  });
+  indexCache.set(elements, indexes);
+  return indexes;
+}
diff --git a/packages/studio/src/player/lib/timelinePerformanceFixture.ts b/packages/studio/src/player/lib/timelinePerformanceFixture.ts
index 12707ea33c..8aed51bf01 100644
--- a/packages/studio/src/player/lib/timelinePerformanceFixture.ts
+++ b/packages/studio/src/player/lib/timelinePerformanceFixture.ts
@@ -29,6 +29,7 @@ export interface TimelinePerformanceFixture {
 }
 
 const TRACK_COUNT = 1_000;
+let fixtureLeaseActive = false;
 const PROFILE_GEOMETRY: Readonly<
   Record<TimelinePerformanceFixtureProfile, { duration: number; clipDuration: number }>
 > = Object.freeze({
@@ -39,6 +40,15 @@ const PROFILE_GEOMETRY: Readonly<
   "remote-unsupported": { duration: 900, clipDuration: 12 },
 });
 
+/** Prevent live iframe discovery from replacing an explicitly loaded dev fixture. */
+export function setTimelinePerformanceFixtureLease(active: boolean): void {
+  fixtureLeaseActive = active;
+}
+
+export function hasTimelinePerformanceFixtureLease(): boolean {
+  return fixtureLeaseActive;
+}
+
 function validateFixtureSpec(spec: TimelinePerformanceFixtureSpec) {
   if (spec.elementCount !== 1_000 && spec.elementCount !== 50_000) {
     throw new RangeError("Timeline performance fixture elementCount must be 1000 or 50000");
diff --git a/packages/studio/src/player/store/playerStore.test.ts b/packages/studio/src/player/store/playerStore.test.ts
index 1eb3f72c56..b9b1157b22 100644
--- a/packages/studio/src/player/store/playerStore.test.ts
+++ b/packages/studio/src/player/store/playerStore.test.ts
@@ -441,6 +441,21 @@ describe("usePlayerStore", () => {
   });
 
   describe("reset", () => {
+    it("increments the session epoch only for a hard project switch", () => {
+      usePlayerStore.getState().beginTimelineSession("project-a");
+      const firstEpoch = usePlayerStore.getState().timelineSessionEpoch;
+
+      usePlayerStore.getState().reset();
+      expect(usePlayerStore.getState().timelineSessionEpoch).toBe(firstEpoch);
+
+      usePlayerStore.getState().beginTimelineSession("project-a");
+      expect(usePlayerStore.getState().timelineSessionEpoch).toBe(firstEpoch);
+
+      usePlayerStore.getState().beginTimelineSession("project-b");
+      expect(usePlayerStore.getState().timelineSessionEpoch).toBe(firstEpoch + 1);
+      expect(usePlayerStore.getState().timelineProjectId).toBe("project-b");
+    });
+
     it("resets all state to defaults", () => {
       // Mutate everything
       const store = usePlayerStore.getState();
diff --git a/packages/studio/src/player/store/playerStore.ts b/packages/studio/src/player/store/playerStore.ts
index e8c101c8fd..2fd3268f94 100644
--- a/packages/studio/src/player/store/playerStore.ts
+++ b/packages/studio/src/player/store/playerStore.ts
@@ -101,6 +101,10 @@ interface PlayerState extends KeyframeSlice {
   currentTime: number;
   duration: number;
   timelineReady: boolean;
+  /** Increments exactly once when the Studio switches to a different project. */
+  timelineSessionEpoch: number;
+  /** Project owning the current timeline session; null outside a project-scoped reset. */
+  timelineProjectId: string | null;
   /** True while a beat dot is being dragged — hides the playhead guideline. */
   beatDragging: boolean;
   elements: TimelineElement[];
@@ -201,6 +205,9 @@ interface PlayerState extends KeyframeSlice {
   bumpZEditVersion: () => void;
   setInPoint: (time: number | null) => void;
   setOutPoint: (time: number | null) => void;
+  /** Owns the hard project boundary; repeated calls for one project are no-ops. */
+  beginTimelineSession: (projectId: string) => void;
+  /** Clears project data without creating a new hard-project session. */
   reset: () => void;
 
   /**
@@ -283,11 +290,43 @@ export const liveTime = {
   },
 };
 
+function createTimelineResetState() {
+  return {
+    isPlaying: false,
+    currentTime: 0,
+    duration: 0,
+    timelineReady: false,
+    beatDragging: false,
+    elements: [],
+    selectedElementId: null,
+    inPoint: null,
+    outPoint: null,
+    activeTool: "select" as const,
+    selectedKeyframes: new Set<string>(),
+    expandedClipIds: new Set<string>(),
+    focusedEaseSegment: null,
+    selectedElementIds: new Set<string>(),
+    clipRevealRequest: null,
+    keyframeCache: new Map(),
+    gsapAnimations: new Map(),
+    beatAnalysis: null,
+    beatEdits: null,
+    beatUndo: [],
+    beatRedo: [],
+    beatPersist: null,
+    clipManifest: null,
+    clipParentMap: new Map<string, string>(),
+    domClipChildren: [],
+  };
+}
+
 export const usePlayerStore = create<PlayerState>((set, get) => ({
   isPlaying: false,
   currentTime: 0,
   duration: 0,
   timelineReady: false,
+  timelineSessionEpoch: 0,
+  timelineProjectId: null,
   beatDragging: false,
   elements: [],
   selectedElementId: null,
@@ -514,37 +553,19 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
         (el.key ?? el.id) === elementId ? { ...el, ...updates } : el,
       ),
     })),
-  // Resets project-specific state when switching compositions.
-  // playbackRate, audioMuted, loopEnabled, zoomMode, and manualZoomPercent are intentionally preserved
-  // because they are user preferences that should survive project switches.
-  reset: () =>
-    set({
-      isPlaying: false,
-      currentTime: 0,
-      duration: 0,
-      timelineReady: false,
-      beatDragging: false,
-      elements: [],
-      selectedElementId: null,
-      inPoint: null,
-      outPoint: null,
-      activeTool: "select",
-      selectedKeyframes: new Set(),
-      expandedClipIds: new Set(),
-      focusedEaseSegment: null,
-      selectedElementIds: new Set(),
-      clipRevealRequest: null,
-      keyframeCache: new Map(),
-      gsapAnimations: new Map(),
-      beatAnalysis: null,
-      beatEdits: null,
-      beatUndo: [],
-      beatRedo: [],
-      beatPersist: null,
-      clipManifest: null,
-      clipParentMap: new Map(),
-      domClipChildren: [],
+  // playbackRate, audioMuted, loopEnabled, zoomMode, and manualZoomPercent are
+  // intentionally absent from createTimelineResetState because they are user
+  // preferences that survive both source refreshes and project switches.
+  beginTimelineSession: (projectId) =>
+    set((state) => {
+      if (state.timelineProjectId === projectId) return state;
+      return {
+        ...createTimelineResetState(),
+        timelineSessionEpoch: state.timelineSessionEpoch + 1,
+        timelineProjectId: projectId,
+      };
     }),
+  reset: () => set(createTimelineResetState()),
 }));
 
 // Bug-bash aid: expose the store so a reproduction can dump live state from the
diff --git a/packages/studio/tests/e2e/fixtures/timeline-virtualization/index.html b/packages/studio/tests/e2e/fixtures/timeline-virtualization/index.html
index 2846170bf5..5363b13f5c 100644
--- a/packages/studio/tests/e2e/fixtures/timeline-virtualization/index.html
+++ b/packages/studio/tests/e2e/fixtures/timeline-virtualization/index.html
@@ -17,6 +17,7 @@
   </head>
   <body>
     <div
+      data-hf-id="hf-biny"
       id="timeline-virtualization-anchor"
       class="clip"
       data-composition-id="timeline-virtualization"
diff --git a/packages/studio/tests/e2e/timeline-virtualization.mjs b/packages/studio/tests/e2e/timeline-virtualization.mjs
index de44a88a95..e12c7af8b6 100644
--- a/packages/studio/tests/e2e/timeline-virtualization.mjs
+++ b/packages/studio/tests/e2e/timeline-virtualization.mjs
@@ -91,9 +91,7 @@ async function collectRun(page) {
     function findTimelineScroller() {
       const root = document.querySelector('[aria-label="Timeline"]');
       if (!(root instanceof HTMLElement)) throw new Error("Timeline root not mounted");
-      const scroller = Array.from(root.querySelectorAll("div")).find(
-        (node) => node.scrollWidth > node.clientWidth || node.scrollHeight > node.clientHeight,
-      );
+      const scroller = root.querySelector("[data-timeline-scroll-viewport]");
       if (!(scroller instanceof HTMLElement)) throw new Error("Timeline scroller not mounted");
       return scroller;
     }
@@ -192,24 +190,18 @@ try {
   if (TIER === "low-resource") {
     await client.send("Emulation.setCPUThrottlingRate", { rate: 4 });
   }
-  await page.goto(STUDIO_URL, { waitUntil: "domcontentloaded", timeout: 60_000 });
+  await page.goto(STUDIO_URL, { waitUntil: "networkidle0", timeout: 60_000 });
   await page.waitForFunction(
     () => typeof window.__studioTest?.loadTimelinePerformanceFixture === "function",
     { timeout: 30_000 },
   );
+  await waitForStudioTestHookSettle(page);
 
-  await page.evaluate((profile) => {
-    window.__studioTest.loadTimelinePerformanceFixture({ elementCount: 1_000, profile });
-  }, PROFILE);
+  await loadFixtureAndWait(page, 1_000, PROFILE);
   await client.send("HeapProfiler.collectGarbage");
   const baselineHeapBytes = await collectHeapBytes(client);
 
-  const summary = await page.evaluate(
-    ({ elementCount, profile }) =>
-      window.__studioTest.loadTimelinePerformanceFixture({ elementCount, profile }),
-    { elementCount: ELEMENT_COUNT, profile: PROFILE },
-  );
-  await page.waitForFunction(() => document.querySelector('[aria-label="Timeline"]'));
+  const summary = await loadFixtureAndWait(page, ELEMENT_COUNT, PROFILE);
   const budgets = await page.evaluate(() => window.__studioTest.timelineViewportBudgets);
   const measuredMaxReliableScrollWidth = await measureMaximumReliableScrollWidth(page);
 
@@ -232,9 +224,7 @@ try {
       run.diagnostics.mountedTimelineDescendants < budgets.maxMountedTimelineDescendants;
   }
 
-  await page.evaluate((profile) => {
-    window.__studioTest.loadTimelinePerformanceFixture({ elementCount: 1_000, profile });
-  }, PROFILE);
+  await loadFixtureAndWait(page, 1_000, PROFILE);
   await client.send("HeapProfiler.collectGarbage");
   const returnedHeapBytes = await collectHeapBytes(client);
   const memoryReturned =
@@ -296,3 +286,48 @@ try {
   await browser.close();
 }
 process.exit(exitCode);
+
+async function waitForFixtureRender(page, elementCount) {
+  const deadline = Date.now() + 60_000;
+  let observed = null;
+  while (Date.now() < deadline) {
+    observed = await page.evaluate(() => ({
+      modelCount: window.__playerStore?.getState().elements.length ?? null,
+      renderedCount:
+        document
+          .querySelector('[aria-label="Timeline"]')
+          ?.getAttribute("data-timeline-element-count") ?? null,
+    }));
+    if (observed.renderedCount === String(elementCount)) {
+      await page.evaluate(() => new Promise((resolve) => requestAnimationFrame(() => resolve())));
+      return;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 50));
+  }
+  throw new Error(`Timeline fixture ${elementCount} did not render: ${JSON.stringify(observed)}`);
+}
+
+async function loadFixtureAndWait(page, elementCount, profile) {
+  const summary = await page.evaluate(
+    ({ count, fixtureProfile }) =>
+      window.__studioTest.loadTimelinePerformanceFixture({
+        elementCount: count,
+        profile: fixtureProfile,
+      }),
+    { count: elementCount, fixtureProfile: profile },
+  );
+  await waitForFixtureRender(page, elementCount);
+  return summary;
+}
+
+async function waitForStudioTestHookSettle(page) {
+  await page.evaluate(async () => {
+    const nextFrame = () => new Promise((resolve) => requestAnimationFrame(resolve));
+    for (;;) {
+      const candidate = window.__studioTest;
+      await nextFrame();
+      await nextFrame();
+      if (candidate === window.__studioTest) return;
+    }
+  });
+}

From 9b91ca5192eb135b3d8a4630790de69d4ce4de0b Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 19:32:57 +0200
Subject: [PATCH 110/125] perf(studio): follow playhead across virtualized rows

---
 bun.lock                                      |   5 +
 packages/studio/package.json                  |   1 +
 .../src/player/components/Timeline.test.ts    |  78 ++++++++
 .../studio/src/player/components/Timeline.tsx |  51 +++--
 .../Timeline.virtualization.test.tsx          | 107 +++++++++++
 .../src/player/components/TimelineCanvas.tsx  |   4 +-
 .../player/components/TimelineLaneTypes.ts    |   5 +
 .../src/player/components/TimelineLanes.tsx   |  46 +++--
 .../player/components/TimelineTrackRow.tsx    |  46 +++++
 .../player/components/timelineEditing.test.ts |  32 ++++
 .../src/player/components/timelineEditing.ts  |  52 +++++-
 .../components/timelineFocusIdentity.test.ts  |  21 +++
 .../components/timelineFocusIdentity.ts       |  21 +++
 .../src/player/components/timelineLayout.ts   |  40 ++++
 .../player/components/useTimelinePlayhead.ts  |  43 +++--
 .../useTimelineRowVirtualization.ts           | 135 ++++++++++++++
 .../useTimelineVirtualRows.test.tsx           | 174 ++++++++++++++++++
 .../components/useTimelineVirtualRows.ts      | 110 +++++++++++
 18 files changed, 902 insertions(+), 69 deletions(-)
 create mode 100644 packages/studio/src/player/components/Timeline.virtualization.test.tsx
 create mode 100644 packages/studio/src/player/components/TimelineTrackRow.tsx
 create mode 100644 packages/studio/src/player/components/timelineFocusIdentity.test.ts
 create mode 100644 packages/studio/src/player/components/timelineFocusIdentity.ts
 create mode 100644 packages/studio/src/player/components/useTimelineRowVirtualization.ts
 create mode 100644 packages/studio/src/player/components/useTimelineVirtualRows.test.tsx
 create mode 100644 packages/studio/src/player/components/useTimelineVirtualRows.ts

diff --git a/bun.lock b/bun.lock
index f277c12249..d885f4fd98 100644
--- a/bun.lock
+++ b/bun.lock
@@ -329,6 +329,7 @@
         "@hyperframes/sdk": "workspace:*",
         "@hyperframes/studio-server": "workspace:*",
         "@phosphor-icons/react": "^2.1.10",
+        "@tanstack/react-virtual": "^3.14.6",
         "bpm-detective": "^2.0.5",
         "dompurify": "^3.2.4",
         "gsap": "^3.13.0",
@@ -1107,6 +1108,10 @@
 
     "@swc/helpers": ["@swc/helpers@0.5.21", "", { "dependencies": { "tslib": "^2.8.0" } }, "sha512-jI/VAmtdjB/RnI8GTnokyX7Ug8c+g+ffD6QRLa6XQewtnGyukKkKSk3wLTM3b5cjt1jNh9x0jfVlagdN2gDKQg=="],
 
+    "@tanstack/react-virtual": ["@tanstack/react-virtual@3.14.6", "", { "dependencies": { "@tanstack/virtual-core": "3.17.4" }, "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-4+Uq8m0/gzO4kMCHUEpTtGX1RnONK0C+g88b2ltwPMWUBiaVarBuWKoPJaz7gj1cKCVRAdyu+U8GcKhwCc2beA=="],
+
+    "@tanstack/virtual-core": ["@tanstack/virtual-core@3.17.4", "", {}, "sha512-nGm5KteqxasUdThLc2izl6dHUqLv0LQj7Nuyo5gYalTPf/U8a9ermvsl7reT+6ioBW1l8WfpP/mcU338nLXpqw=="],
+
     "@tootallnate/once": ["@tootallnate/once@2.0.1", "", {}, "sha512-HqmEUIGRJ5fSXchkVgR5F7qn48bDBzv0kWj/Kfu5e6uci4UlEeng4331LnBkWffb++Ei3FOVLxo8JJWMFBDMeQ=="],
 
     "@tootallnate/quickjs-emscripten": ["@tootallnate/quickjs-emscripten@0.23.0", "", {}, "sha512-C5Mc6rdnsaJDjO3UpGW/CQTHtCKaYlScZTly4JIu97Jxo/odCiH0ITnDXSJPTOrEKk/ycSZ0AOgTmkDtkOsvIA=="],
diff --git a/packages/studio/package.json b/packages/studio/package.json
index 398c2c9c57..795ec166ca 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -71,6 +71,7 @@
     "@hyperframes/sdk": "workspace:*",
     "@hyperframes/studio-server": "workspace:*",
     "@phosphor-icons/react": "^2.1.10",
+    "@tanstack/react-virtual": "^3.14.6",
     "bpm-detective": "^2.0.5",
     "dompurify": "^3.2.4",
     "gsap": "^3.13.0",
diff --git a/packages/studio/src/player/components/Timeline.test.ts b/packages/studio/src/player/components/Timeline.test.ts
index 194c4851ad..1ff193d858 100644
--- a/packages/studio/src/player/components/Timeline.test.ts
+++ b/packages/studio/src/player/components/Timeline.test.ts
@@ -12,6 +12,7 @@ import {
   getTimelineCanvasHeight,
   resolveTimelineAssetDrop,
   getTimelinePlayheadLeft,
+  getTimelinePlaybackFollowScrollLeft,
   getTimelineScrollLeftForZoomAnchor,
   getTimelineScrollLeftForZoomTransition,
   shouldShowTimelineShortcutHint,
@@ -274,6 +275,33 @@ describe("Timeline provider boundary", () => {
     act(() => root.unmount());
   });
 
+  it("renders the complete track list while row virtualization is gated off", () => {
+    const host = createSizedTimelineHost(640);
+    usePlayerStore.setState({
+      duration: 4,
+      timelineReady: true,
+      elements: Array.from({ length: 12 }, (_, track) => ({
+        id: `clip-${track}`,
+        tag: "div",
+        start: 0,
+        duration: 2,
+        track,
+      })),
+    });
+    const root = createRoot(host);
+    act(() => root.render(React.createElement(Timeline)));
+
+    const list = host.querySelector<HTMLElement>('[role="list"]');
+    const rows = list?.querySelectorAll('[role="listitem"]') ?? [];
+    expect(rows).toHaveLength(12);
+    expect(rows[0]?.getAttribute("aria-posinset")).toBe("1");
+    expect(rows[0]?.getAttribute("aria-setsize")).toBe("12");
+    expect(rows[11]?.getAttribute("aria-posinset")).toBe("12");
+
+    act(() => root.unmount());
+  });
+
+  // fallow-ignore-next-line code-duplication
   it("renders the gutter without legacy icons or hue dots", () => {
     const { host, root } = renderBasicTimeline();
 
@@ -974,6 +1002,56 @@ describe("getTimelinePlayheadLeft", () => {
   });
 });
 
+describe("getTimelinePlaybackFollowScrollLeft", () => {
+  it("holds the viewport still while the playhead remains inside the comfort area", () => {
+    expect(
+      getTimelinePlaybackFollowScrollLeft({
+        playheadX: 700,
+        currentScrollLeft: 100,
+        viewportWidth: 1000,
+        contentOrigin: 264,
+        maxScrollLeft: 2000,
+      }),
+    ).toBe(100);
+  });
+
+  it("follows forward playback at the right-side comfort line", () => {
+    expect(
+      getTimelinePlaybackFollowScrollLeft({
+        playheadX: 1200,
+        currentScrollLeft: 100,
+        viewportWidth: 1000,
+        contentOrigin: 264,
+        maxScrollLeft: 2000,
+      }),
+    ).toBe(384);
+  });
+
+  it("returns to the matching earlier viewport after a playback loop", () => {
+    expect(
+      getTimelinePlaybackFollowScrollLeft({
+        playheadX: 264,
+        currentScrollLeft: 900,
+        viewportWidth: 1000,
+        contentOrigin: 264,
+        maxScrollLeft: 2000,
+      }),
+    ).toBe(0);
+  });
+
+  it("clamps at the end of the scrollable timeline", () => {
+    expect(
+      getTimelinePlaybackFollowScrollLeft({
+        playheadX: 5000,
+        currentScrollLeft: 100,
+        viewportWidth: 1000,
+        contentOrigin: 264,
+        maxScrollLeft: 1500,
+      }),
+    ).toBe(1500);
+  });
+});
+
 describe("getTimelineCanvasHeight", () => {
   it("includes bottom scroll buffer below the last track", () => {
     expect(getTimelineCanvasHeight([TRACK_H, TRACK_H, TRACK_H])).toBeGreaterThan(
diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 7a4e61d135..ef904a1e09 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -1,4 +1,4 @@
-import { useRef, useMemo, useCallback, useState, useLayoutEffect, memo } from "react";
+import { useRef, useMemo, useCallback, useState, memo } from "react";
 import { useMusicBeatAnalysis } from "../../hooks/useMusicBeatAnalysis";
 import { remapBeatAnalysisToComposition } from "../../utils/beatEditActions";
 import { usePlayerStore, type TimelineElement } from "../store/playerStore";
@@ -42,7 +42,7 @@ import { useTimelineSelectionLifecycle } from "./useTimelineSelectionLifecycle";
 import { useTimelineShiftModifier } from "./useTimelineShiftModifier";
 import { useTimelineTicks } from "./useTimelineTicks";
 import { getTimelineElementIndexes } from "../lib/timelineElementIndexes";
-import { getTimelineScrollTopForGeometryChange } from "./timelineViewportGeometry";
+import { useTimelineRowVirtualization } from "./useTimelineRowVirtualization";
 
 // Re-export pure utilities so existing imports from "./Timeline" still resolve.
 export {
@@ -51,6 +51,7 @@ export {
   shouldAutoScrollTimeline,
   getTimelineScrollLeftForZoomTransition,
   getTimelineScrollLeftForZoomAnchor,
+  getTimelinePlaybackFollowScrollLeft,
   getTimelinePlayheadLeft,
   getTimelineCanvasHeight,
   shouldShowTimelineShortcutHint,
@@ -126,6 +127,7 @@ export const Timeline = memo(function Timeline({
   const timelineReady = usePlayerStore((s) => s.timelineReady);
   const selectedElementId = usePlayerStore((s) => s.selectedElementId);
   const selectedElementIds = usePlayerStore((s) => s.selectedElementIds);
+  const clipRevealRequest = usePlayerStore((s) => s.clipRevealRequest);
   const gsapAnimations = usePlayerStore((s) => s.gsapAnimations);
   // Label mode = comp has keyframed clips (not just when expanded): keeps the layer
   // disclosure + property column visible and reserves a GUTTER before 0s (Figma).
@@ -287,32 +289,21 @@ export const Timeline = memo(function Timeline({
       expandedElements.length,
       displayLayout.totalH,
     ]);
-  const previousLayoutRef = useRef(displayLayout.rowGeometry);
-  const previousSessionEpochRef = useRef(sessionEpoch);
-  useLayoutEffect(() => {
-    const scroll = scrollRef.current;
-    const previousGeometry = previousLayoutRef.current;
-    if (previousSessionEpochRef.current !== sessionEpoch) {
-      previousSessionEpochRef.current = sessionEpoch;
-      lastScrollLeftRef.current = 0;
-      if (scroll) {
-        scroll.scrollLeft = 0;
-        scroll.scrollTop = 0;
-        syncScrollViewport(scroll);
-      }
-    } else if (scroll && previousGeometry !== displayLayout.rowGeometry) {
-      const nextScrollTop = getTimelineScrollTopForGeometryChange(
-        previousGeometry,
-        displayLayout.rowGeometry,
-        scroll.scrollTop,
-      );
-      if (nextScrollTop !== scroll.scrollTop) {
-        scroll.scrollTop = nextScrollTop;
-        syncScrollViewport(scroll);
-      }
-    }
-    previousLayoutRef.current = displayLayout.rowGeometry;
-  }, [displayLayout.rowGeometry, sessionEpoch, syncScrollViewport]);
+  const { enabled: rowVirtualizationActive, virtualRows } = useTimelineRowVirtualization({
+    scrollRef,
+    viewport,
+    rowGeometry: displayLayout.rowGeometry,
+    sessionEpoch,
+    elements: expandedElements,
+    selectedElementId,
+    revealElementId: clipRevealRequest?.elementId ?? null,
+    draggedRowKey: draggedClip?.started ? draggedClip.previewTrack : undefined,
+    resizingRowKey: resizingClip?.element.track,
+    clipContextMenuRowKey: clipContextMenu?.element.track,
+    keyframeContextMenuRowKey: kfContextMenu?.element.track,
+    lastScrollLeftRef,
+    syncScrollViewport,
+  });
   const selectedKeyframes = usePlayerStore((s) => s.selectedKeyframes);
   const toggleSelectedKeyframe = usePlayerStore((s) => s.toggleSelectedKeyframe);
   const { onClickKeyframe, onSelectSegment, onShiftClickKeyframe, onContextMenuKeyframe } =
@@ -465,6 +456,7 @@ export const Timeline = memo(function Timeline({
       <div
         ref={setScrollRef}
         data-timeline-scroll-viewport
+        data-timeline-auto-scroll-left-inset={labelMode ? LABEL_COL_W : 0}
         tabIndex={-1}
         className={`${zoomMode === "fit" ? "overflow-x-hidden" : "overflow-x-auto"} overflow-y-auto h-full outline-none`}
         onScroll={(e) => {
@@ -501,6 +493,9 @@ export const Timeline = memo(function Timeline({
           theme={theme}
           displayTrackOrder={displayLayout.displayTrackOrder}
           rowHeights={displayLayout.displayRowHeights}
+          rowGeometry={displayLayout.rowGeometry}
+          virtualRows={virtualRows}
+          rowsVirtualized={rowVirtualizationActive}
           trackOrder={trackOrder}
           tracks={tracks}
           trackStyles={trackStyles}
diff --git a/packages/studio/src/player/components/Timeline.virtualization.test.tsx b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
new file mode 100644
index 0000000000..cfe1ec491e
--- /dev/null
+++ b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
@@ -0,0 +1,107 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
+
+(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+class MockResizeObserver {
+  constructor(private readonly callback: ResizeObserverCallback) {}
+  observe(target: Element) {
+    this.callback(
+      [
+        {
+          target,
+          borderBoxSize: [{ inlineSize: target.clientWidth, blockSize: target.clientHeight }],
+        } as unknown as ResizeObserverEntry,
+      ],
+      this as unknown as ResizeObserver,
+    );
+  }
+  unobserve() {}
+  disconnect() {}
+}
+
+const originalResizeObserver = globalThis.ResizeObserver;
+const originalClientWidth = Object.getOwnPropertyDescriptor(HTMLElement.prototype, "clientWidth");
+const originalClientHeight = Object.getOwnPropertyDescriptor(HTMLElement.prototype, "clientHeight");
+
+beforeAll(() => {
+  vi.stubEnv("VITE_STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED", "1");
+  globalThis.ResizeObserver = MockResizeObserver as unknown as typeof ResizeObserver;
+  Object.defineProperty(HTMLElement.prototype, "clientWidth", {
+    configurable: true,
+    get: () => 900,
+  });
+  Object.defineProperty(HTMLElement.prototype, "clientHeight", {
+    configurable: true,
+    get: () => 240,
+  });
+});
+
+afterAll(() => {
+  vi.unstubAllEnvs();
+  globalThis.ResizeObserver = originalResizeObserver;
+  if (originalClientWidth)
+    Object.defineProperty(HTMLElement.prototype, "clientWidth", originalClientWidth);
+  if (originalClientHeight)
+    Object.defineProperty(HTMLElement.prototype, "clientHeight", originalClientHeight);
+  document.body.innerHTML = "";
+});
+
+describe("Timeline row virtualization", () => {
+  it("mounts a bounded list range over the full geometry height", async () => {
+    const [{ Timeline }, { usePlayerStore }, { getTimelineCanvasHeight, TRACK_H }] =
+      await Promise.all([
+        import("./Timeline"),
+        import("../store/playerStore"),
+        import("./timelineLayout"),
+      ]);
+    usePlayerStore.setState({
+      duration: 60,
+      timelineReady: true,
+      elements: Array.from({ length: 1_000 }, (_, track) => ({
+        id: `clip-${track}`,
+        tag: "div",
+        start: 0,
+        duration: 1,
+        track,
+      })),
+    });
+
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    await act(async () => root.render(React.createElement(Timeline, { sessionEpoch: 3 })));
+    await act(async () => {});
+
+    const list = host.querySelector<HTMLElement>('[role="list"]');
+    const rows = list?.querySelectorAll('[role="listitem"]') ?? [];
+    expect(rows.length).toBeGreaterThan(0);
+    expect(rows.length).toBeLessThanOrEqual(16);
+    expect(rows[0]?.getAttribute("aria-posinset")).toBe("1");
+    expect(rows[0]?.getAttribute("aria-setsize")).toBe("1000");
+    expect(list?.parentElement?.style.height).toBe(
+      `${getTimelineCanvasHeight(Array.from({ length: 1_000 }, () => TRACK_H))}px`,
+    );
+
+    const firstRow = rows[0] as HTMLElement;
+    const focusedControl = firstRow.querySelector<HTMLButtonElement>("button");
+    expect(focusedControl).not.toBeNull();
+    act(() => focusedControl?.focus());
+    const scroller = host.querySelector<HTMLElement>("[data-timeline-scroll-viewport]");
+    expect(scroller).not.toBeNull();
+    if (scroller) {
+      scroller.scrollTop = 500 * 48;
+      await act(async () => {
+        scroller.dispatchEvent(new Event("scroll"));
+      });
+    }
+    expect(list?.querySelector('[data-timeline-row-key="0"]')).not.toBeNull();
+    expect(document.activeElement).toBe(focusedControl);
+
+    act(() => root.unmount());
+    usePlayerStore.getState().reset();
+  }, 10_000);
+});
diff --git a/packages/studio/src/player/components/TimelineCanvas.tsx b/packages/studio/src/player/components/TimelineCanvas.tsx
index a13d0849da..90451194fe 100644
--- a/packages/studio/src/player/components/TimelineCanvas.tsx
+++ b/packages/studio/src/player/components/TimelineCanvas.tsx
@@ -130,7 +130,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
 
       {/* Breathing room between the sticky ruler and the first track lane — the
           top half of the CapCut-style padding (see TRACKS_TOP_PAD). */}
-      <div aria-hidden="true" style={{ height: TRACKS_TOP_PAD }} />
+      <div aria-hidden="true" style={{ height: props.rowsVirtualized ? 0 : TRACKS_TOP_PAD }} />
 
       <TimelineLanes
         {...props}
@@ -147,7 +147,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
       {/* Breathing room below the last track lane (~1.5 track heights) — a real
           scrollable surface, so a clip can be dragged into the void to create a
           new bottom track comfortably (see TRACKS_BOTTOM_PAD / getTimelineCanvasHeight). */}
-      <div aria-hidden="true" style={{ height: TRACKS_BOTTOM_PAD }} />
+      <div aria-hidden="true" style={{ height: props.rowsVirtualized ? 0 : TRACKS_BOTTOM_PAD }} />
 
       {/* Gap strips — loud dashed fill for the gap(s) a hovered "Close gap(s)"
           menu row would collapse; a quiet tint for every gap on the selected
diff --git a/packages/studio/src/player/components/TimelineLaneTypes.ts b/packages/studio/src/player/components/TimelineLaneTypes.ts
index 4dc0f7746b..a910c11634 100644
--- a/packages/studio/src/player/components/TimelineLaneTypes.ts
+++ b/packages/studio/src/player/components/TimelineLaneTypes.ts
@@ -6,6 +6,8 @@ import type { TimelineTheme } from "./timelineTheme";
 import type { BlockedClipState, DraggedClipState, ResizingClipState } from "./useTimelineClipDrag";
 import type { TrackVisualStyle } from "./timelineIcons";
 import type { KeyframeCacheEntry, TimelineElement } from "../store/playerStore";
+import type { TimelineRowGeometry } from "./timelineLayout";
+import type { TimelineVirtualRow } from "./useTimelineVirtualRows";
 
 /**
  * Props shared by the scroll container ({@link TimelineCanvas}) and its lane
@@ -21,6 +23,9 @@ export interface TimelineLaneBaseProps {
   theme: TimelineTheme;
   displayTrackOrder: number[];
   rowHeights: readonly number[];
+  rowGeometry: TimelineRowGeometry;
+  virtualRows: readonly TimelineVirtualRow[];
+  rowsVirtualized: boolean;
   trackOrder: number[];
   tracks: [number, TimelineElement[]][];
   trackStyles: Map<number, TrackVisualStyle>;
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index 1d7fd965b1..dc5185a120 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -5,7 +5,7 @@ import { TimelinePropertyLanes } from "./TimelinePropertyLanes";
 import { TimelineTrackHeader } from "./TimelineTrackHeader";
 import { resolveTrackKeyframeClip } from "./useTimelineTrackLayout";
 import { getTimelineEditCapabilities, resolveBlockedTimelineEditIntent } from "./timelineEditing";
-import { CLIP_Y, CLIP_HANDLE_W, TRACK_H, getTimelineRowHeight } from "./timelineLayout";
+import { CLIP_Y, CLIP_HANDLE_W, TRACK_H } from "./timelineLayout";
 import { usePlayerStore, type TimelineElement } from "../store/playerStore";
 import {
   isMultiDragPassenger,
@@ -19,6 +19,7 @@ import { SPLIT_BOUNDARY_EPSILON_S } from "../../utils/timelineElementSplit";
 import { isAudioTimelineElement, isMusicTrack } from "../../utils/timelineInspector";
 import { renderClipChildren } from "./timelineClipChildren";
 import type { TimelineLaneBaseProps } from "./TimelineLaneTypes";
+import { TimelineTrackRow } from "./TimelineTrackRow";
 
 interface TimelineLanesProps extends TimelineLaneBaseProps {
   /** Live-derived by TimelineCanvas from {@link TimelineLaneBaseProps.draggedClip}. */
@@ -39,7 +40,9 @@ export function TimelineLanes({
   trackContentWidth,
   theme,
   displayTrackOrder,
-  rowHeights,
+  rowGeometry,
+  virtualRows,
+  rowsVirtualized,
   trackOrder,
   tracks,
   trackStyles,
@@ -95,16 +98,17 @@ export function TimelineLanes({
     toggleClipExpanded(key);
   };
   return (
-    <>
+    <div
+      role="list"
+      aria-label="Timeline tracks"
+      className={rowsVirtualized ? "absolute inset-0" : undefined}
+    >
       {
-        // NOTE (deliberate no-virtualization): lanes and their clips render via a
-        // plain `.map()` inside the scroll container rather than a windowing/virtualized
-        // list. NLE clip counts are small (dozens to low hundreds), so the DOM cost is
-        // bounded and virtualization's complexity isn't worth it. TODO: revisit and swap
-        // in a virtualizer if editorial workflows ever push very high clip counts.
         // fallow-ignore-next-line complexity
-        displayTrackOrder.map((trackNum, row) => {
-          const rowHeight = getTimelineRowHeight(row, rowHeights);
+        virtualRows.map(({ index: row, rowKey }) => {
+          const trackNum = displayTrackOrder[row];
+          if (trackNum === undefined) return null;
+          const rowHeight = rowGeometry.getRowHeight(row);
           const els = tracks.find(([t]) => t === trackNum)?.[1] ?? [];
           const ts = trackStyles.get(trackNum) ?? getTrackStyle("");
           const isPendingTrack =
@@ -131,14 +135,16 @@ export function TimelineLanes({
           const keyframeClipExpanded =
             keyframeClipKey != null && expandedClipIds.has(keyframeClipKey);
           return (
-            <div
-              key={trackNum}
-              className="relative flex"
-              style={{
-                height: rowHeight,
-                background: rowBackground,
-                borderBottom: `1px solid ${theme.rowBorder}`,
-              }}
+            <TimelineTrackRow
+              key={rowKey}
+              index={row}
+              rowKey={rowKey}
+              rowCount={displayTrackOrder.length}
+              top={rowGeometry.getRowTop(row)}
+              height={rowHeight}
+              virtualized={rowsVirtualized}
+              background={rowBackground}
+              borderColor={theme.rowBorder}
             >
               <TimelineTrackHeader
                 trackNumber={trackNum}
@@ -487,10 +493,10 @@ export function TimelineLanes({
                   })
                 }
               </div>
-            </div>
+            </TimelineTrackRow>
           );
         })
       }
-    </>
+    </div>
   );
 }
diff --git a/packages/studio/src/player/components/TimelineTrackRow.tsx b/packages/studio/src/player/components/TimelineTrackRow.tsx
new file mode 100644
index 0000000000..de1865a416
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineTrackRow.tsx
@@ -0,0 +1,46 @@
+import type { ReactNode } from "react";
+
+interface TimelineTrackRowProps {
+  index: number;
+  rowKey: number;
+  rowCount: number;
+  top: number;
+  height: number;
+  virtualized: boolean;
+  background: string;
+  borderColor: string;
+  children: ReactNode;
+}
+
+/** Accessible row shell; edit geometry owns its exact top and height. */
+export function TimelineTrackRow({
+  index,
+  rowKey,
+  rowCount,
+  top,
+  height,
+  virtualized,
+  background,
+  borderColor,
+  children,
+}: TimelineTrackRowProps) {
+  return (
+    <div
+      role="listitem"
+      aria-posinset={index + 1}
+      aria-setsize={rowCount}
+      data-index={index}
+      data-timeline-row={index}
+      data-timeline-row-key={rowKey}
+      className={`${virtualized ? "absolute left-0 right-0" : "relative"} flex`}
+      style={{
+        top: virtualized ? top : undefined,
+        height,
+        background,
+        borderBottom: `1px solid ${borderColor}`,
+      }}
+    >
+      {children}
+    </div>
+  );
+}
diff --git a/packages/studio/src/player/components/timelineEditing.test.ts b/packages/studio/src/player/components/timelineEditing.test.ts
index fc5aa95533..50b749c153 100644
--- a/packages/studio/src/player/components/timelineEditing.test.ts
+++ b/packages/studio/src/player/components/timelineEditing.test.ts
@@ -669,6 +669,38 @@ describe("resolveTimelineAutoScroll", () => {
       ),
     ).toEqual({ x: 9, y: 6 });
   });
+
+  it("uses the time-grid edge instead of the viewport edge when labels are sticky", () => {
+    expect(
+      resolveTimelineAutoScroll(
+        {
+          left: 100,
+          top: 100,
+          right: 700,
+          bottom: 400,
+        },
+        340,
+        250,
+        232,
+      ),
+    ).toEqual({ x: -10, y: 0 });
+  });
+
+  it("caps auto-scroll speed when the pointer moves inside the sticky labels", () => {
+    expect(
+      resolveTimelineAutoScroll(
+        {
+          left: 100,
+          top: 100,
+          right: 700,
+          bottom: 400,
+        },
+        120,
+        250,
+        232,
+      ),
+    ).toEqual({ x: -12, y: 0 });
+  });
 });
 
 describe("buildTimelineAgentPrompt", () => {
diff --git a/packages/studio/src/player/components/timelineEditing.ts b/packages/studio/src/player/components/timelineEditing.ts
index f183807b08..5ceb30c2bc 100644
--- a/packages/studio/src/player/components/timelineEditing.ts
+++ b/packages/studio/src/player/components/timelineEditing.ts
@@ -84,21 +84,24 @@ export function resolveTimelineAutoScroll(
   bounds: TimelineAutoScrollBounds,
   clientX: number,
   clientY: number,
+  leftInset = 0,
 ): { x: number; y: number } {
   const getAxisDelta = (start: number, end: number, pointer: number) => {
     if (pointer < start + AUTO_SCROLL_EDGE_ZONE) {
-      const proximity = Math.max(0, 1 - (pointer - start) / AUTO_SCROLL_EDGE_ZONE);
+      const proximity = Math.min(1, Math.max(0, 1 - (pointer - start) / AUTO_SCROLL_EDGE_ZONE));
       return -Math.round(AUTO_SCROLL_MAX_SPEED * proximity);
     }
     if (pointer > end - AUTO_SCROLL_EDGE_ZONE) {
-      const proximity = Math.max(0, 1 - (end - pointer) / AUTO_SCROLL_EDGE_ZONE);
+      const proximity = Math.min(1, Math.max(0, 1 - (end - pointer) / AUTO_SCROLL_EDGE_ZONE));
       return Math.round(AUTO_SCROLL_MAX_SPEED * proximity);
     }
     return 0;
   };
 
+  const horizontalStart = Math.min(bounds.right, bounds.left + Math.max(0, leftInset));
+
   return {
-    x: getAxisDelta(bounds.left, bounds.right, clientX),
+    x: getAxisDelta(horizontalStart, bounds.right, clientX),
     y: getAxisDelta(bounds.top, bounds.bottom, clientY),
   };
 }
@@ -485,7 +488,41 @@ export function applyTimelineAutoScrollStep(
   clientX: number,
   clientY: number,
 ): boolean {
-  const delta = resolveTimelineAutoScroll(scroll.getBoundingClientRect(), clientX, clientY);
+  return applyTimelineAutoScrollDelta(
+    scroll,
+    resolveTimelineAutoScroll(
+      scroll.getBoundingClientRect(),
+      clientX,
+      clientY,
+      getTimelineAutoScrollLeftInset(scroll),
+    ),
+  );
+}
+
+/** Apply one horizontal edge-scroll step while scrubbing the ruler/playhead. */
+export function applyTimelineHorizontalAutoScrollStep(
+  scroll: HTMLElement,
+  clientX: number,
+): boolean {
+  const bounds = scroll.getBoundingClientRect();
+  const delta = resolveTimelineAutoScroll(
+    bounds,
+    clientX,
+    bounds.top + (bounds.bottom - bounds.top) / 2,
+    getTimelineAutoScrollLeftInset(scroll),
+  );
+  return applyTimelineAutoScrollDelta(scroll, { x: delta.x, y: 0 });
+}
+
+function getTimelineAutoScrollLeftInset(scroll: HTMLElement): number {
+  const inset = Number(scroll.dataset.timelineAutoScrollLeftInset);
+  return Number.isFinite(inset) ? Math.max(0, inset) : 0;
+}
+
+function applyTimelineAutoScrollDelta(
+  scroll: HTMLElement,
+  delta: { x: number; y: number },
+): boolean {
   if (delta.x === 0 && delta.y === 0) return false;
   const maxScrollLeft = Math.max(0, scroll.scrollWidth - scroll.clientWidth);
   const maxScrollTop = Math.max(0, scroll.scrollHeight - scroll.clientHeight);
@@ -510,7 +547,12 @@ export function resolveTimelineAutoScrollLoopAction(
   rafActive: boolean,
 ): "start" | "stop" | "none" {
   if (!scroll) return "none";
-  const delta = resolveTimelineAutoScroll(scroll.getBoundingClientRect(), clientX, clientY);
+  const delta = resolveTimelineAutoScroll(
+    scroll.getBoundingClientRect(),
+    clientX,
+    clientY,
+    getTimelineAutoScrollLeftInset(scroll),
+  );
   if (delta.x === 0 && delta.y === 0) return rafActive ? "stop" : "none";
   return rafActive ? "none" : "start";
 }
diff --git a/packages/studio/src/player/components/timelineFocusIdentity.test.ts b/packages/studio/src/player/components/timelineFocusIdentity.test.ts
new file mode 100644
index 0000000000..edd7f4f176
--- /dev/null
+++ b/packages/studio/src/player/components/timelineFocusIdentity.test.ts
@@ -0,0 +1,21 @@
+import { describe, expect, it } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import { resolveTimelineFocusIdentity } from "./timelineFocusIdentity";
+
+describe("timeline focus identity", () => {
+  const elements: TimelineElement[] = [
+    { id: "clip/a", key: "stable:key", tag: "div", start: 0, duration: 1, track: 7.5 },
+  ];
+
+  it("resolves a stable element id and fractional display row from model identity", () => {
+    expect(resolveTimelineFocusIdentity(elements, "stable:key")).toEqual({
+      elementId: "stable:key",
+      rowKey: 7.5,
+    });
+  });
+
+  it("does not invent focus for a missing or cleared identity", () => {
+    expect(resolveTimelineFocusIdentity(elements, "missing")).toBeNull();
+    expect(resolveTimelineFocusIdentity(elements, null)).toBeNull();
+  });
+});
diff --git a/packages/studio/src/player/components/timelineFocusIdentity.ts b/packages/studio/src/player/components/timelineFocusIdentity.ts
new file mode 100644
index 0000000000..0f1f24e5a4
--- /dev/null
+++ b/packages/studio/src/player/components/timelineFocusIdentity.ts
@@ -0,0 +1,21 @@
+import type { TimelineElement } from "../store/playerStore";
+import { getTimelineElementIndexes } from "../lib/timelineElementIndexes";
+
+export interface TimelineFocusIdentity {
+  readonly elementId: string;
+  readonly rowKey: number;
+}
+
+/** Resolve logical focus from model identity; mount state is deliberately irrelevant. */
+export function resolveTimelineFocusIdentity(
+  elements: readonly TimelineElement[],
+  elementId: string | null,
+): TimelineFocusIdentity | null {
+  if (!elementId) return null;
+  const element = getTimelineElementIndexes(elements).byKey.get(elementId);
+  if (!element) return null;
+  return {
+    elementId,
+    rowKey: element.track,
+  };
+}
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index 345b0d32f2..b8d5579826 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -420,6 +420,46 @@ export function getTimelineScrubTime(input: {
   });
   return Math.max(0, Math.min(duration, x / pixelsPerSecond));
 }
+const PLAYBACK_FOLLOW_POSITION = 0.75;
+
+/**
+ * Keep a playing timeline calm until the playhead crosses the right-side
+ * comfort line, then advance the viewport just enough to hold it there. A
+ * loop/reverse jump that leaves the playhead behind the sticky labels restores
+ * the matching earlier viewport instead.
+ */
+export function getTimelinePlaybackFollowScrollLeft(input: {
+  playheadX: number;
+  currentScrollLeft: number;
+  viewportWidth: number;
+  contentOrigin: number;
+  maxScrollLeft: number;
+}): number {
+  const current = Number.isFinite(input.currentScrollLeft)
+    ? Math.max(0, input.currentScrollLeft)
+    : 0;
+  const max = Number.isFinite(input.maxScrollLeft) ? Math.max(0, input.maxScrollLeft) : 0;
+  const visibleTimelineWidth = input.viewportWidth - input.contentOrigin;
+  if (
+    !Number.isFinite(input.playheadX) ||
+    !Number.isFinite(input.contentOrigin) ||
+    !Number.isFinite(visibleTimelineWidth) ||
+    visibleTimelineWidth <= 0 ||
+    max <= 0
+  ) {
+    return Math.min(max, current);
+  }
+
+  const visibleStart = current + input.contentOrigin;
+  const followLine = visibleStart + visibleTimelineWidth * PLAYBACK_FOLLOW_POSITION;
+  let next = current;
+  if (input.playheadX > followLine) {
+    next = input.playheadX - input.contentOrigin - visibleTimelineWidth * PLAYBACK_FOLLOW_POSITION;
+  } else if (input.playheadX < visibleStart) {
+    next = input.playheadX - input.contentOrigin;
+  }
+  return Math.max(0, Math.min(max, next));
+}
 
 export function getTimelineCanvasHeight(rowHeights: readonly number[]): number {
   // RULER_H + top pad + lanes + bottom pad. The old TIMELINE_SCROLL_BUFFER is
diff --git a/packages/studio/src/player/components/useTimelinePlayhead.ts b/packages/studio/src/player/components/useTimelinePlayhead.ts
index 23c547188b..5d11e0c512 100644
--- a/packages/studio/src/player/components/useTimelinePlayhead.ts
+++ b/packages/studio/src/player/components/useTimelinePlayhead.ts
@@ -1,14 +1,16 @@
 import { useRef, useCallback, useEffect, useLayoutEffect } from "react";
-import { liveTime, type ZoomMode } from "../store/playerStore";
+import { liveTime, usePlayerStore, type ZoomMode } from "../store/playerStore";
 import { useMountEffect } from "../../hooks/useMountEffect";
 import { getPinchTimelineZoomPercent } from "./timelineZoom";
 import {
+  getTimelinePlaybackFollowScrollLeft,
   getTimelinePlayheadLeft,
   getTimelineScrubTime,
   getTimelineScrollLeftForZoomTransition,
   getTimelineScrollLeftForZoomAnchor,
   shouldAutoScrollTimeline,
 } from "./timelineLayout";
+import { applyTimelineHorizontalAutoScrollStep } from "./timelineEditing";
 
 interface UseTimelinePlayheadInput {
   playheadRef: React.RefObject<HTMLDivElement | null>;
@@ -121,9 +123,31 @@ export function useTimelinePlayhead({
   useMountEffect(() => {
     const unsub = liveTime.subscribe((t) => {
       if (!playheadRef.current || durationRef.current <= 0) return;
-      // Playback deliberately does NOT scroll the viewport to chase the playhead —
-      // the user's scroll position is theirs; the playhead may run off-screen.
-      playheadRef.current.style.left = `${getTimelinePlayheadLeft(t, ppsRef.current, contentOriginRef.current)}px`;
+      const playheadX = contentOriginRef.current + Math.max(0, t) * ppsRef.current;
+      playheadRef.current.style.left = `${getTimelinePlayheadLeft(
+        t,
+        ppsRef.current,
+        contentOriginRef.current,
+      )}px`;
+      const scroll = scrollRef.current;
+      if (
+        !scroll ||
+        !usePlayerStore.getState().isPlaying ||
+        isDragging.current ||
+        zoomModeRef.current === "fit"
+      ) {
+        return;
+      }
+      const nextScrollLeft = getTimelinePlaybackFollowScrollLeft({
+        playheadX,
+        currentScrollLeft: scroll.scrollLeft,
+        viewportWidth: scroll.clientWidth,
+        contentOrigin: contentOriginRef.current,
+        maxScrollLeft: scroll.scrollWidth - scroll.clientWidth,
+      });
+      if (Math.abs(nextScrollLeft - scroll.scrollLeft) >= 0.5) {
+        scroll.scrollLeft = nextScrollLeft;
+      }
     });
     return unsub;
   });
@@ -157,16 +181,7 @@ export function useTimelinePlayhead({
         !shouldAutoScrollTimeline(zoomModeRef.current, el.scrollWidth, el.clientWidth)
       )
         return;
-      const rect = el.getBoundingClientRect();
-      const edgeZone = 40;
-      const maxSpeed = 12;
-      let scrollDelta = 0;
-      if (clientX < rect.left + edgeZone)
-        scrollDelta = -maxSpeed * Math.max(0, 1 - (clientX - rect.left) / edgeZone);
-      else if (clientX > rect.right - edgeZone)
-        scrollDelta = maxSpeed * Math.max(0, 1 - (rect.right - clientX) / edgeZone);
-      if (scrollDelta !== 0) {
-        el.scrollLeft += scrollDelta;
+      if (applyTimelineHorizontalAutoScrollStep(el, clientX)) {
         seekFromX(clientX);
         dragScrollRaf.current = requestAnimationFrame(() => autoScrollDuringDrag(clientX));
       }
diff --git a/packages/studio/src/player/components/useTimelineRowVirtualization.ts b/packages/studio/src/player/components/useTimelineRowVirtualization.ts
new file mode 100644
index 0000000000..5bebda0861
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineRowVirtualization.ts
@@ -0,0 +1,135 @@
+import { useEffect, useLayoutEffect, useMemo, useRef, useState, type RefObject } from "react";
+import type { TimelineElement } from "../store/playerStore";
+import { resolveTimelineFocusIdentity } from "./timelineFocusIdentity";
+import { getTimelineScrollTopForGeometryChange } from "./timelineViewportGeometry";
+import type { TimelineRowGeometry } from "./timelineLayout";
+import type { TimelineScrollViewportSnapshot } from "./useTimelineScrollViewport";
+import {
+  STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED,
+  useTimelineVirtualRows,
+} from "./useTimelineVirtualRows";
+
+interface UseTimelineRowVirtualizationInput {
+  scrollRef: RefObject<HTMLDivElement | null>;
+  viewport: TimelineScrollViewportSnapshot;
+  rowGeometry: TimelineRowGeometry;
+  sessionEpoch: number;
+  elements: TimelineElement[];
+  selectedElementId: string | null;
+  revealElementId: string | null;
+  draggedRowKey?: number;
+  resizingRowKey?: number;
+  clipContextMenuRowKey?: number;
+  keyframeContextMenuRowKey?: number;
+  lastScrollLeftRef: RefObject<number>;
+  syncScrollViewport: (element: HTMLDivElement, isScrolling?: boolean) => void;
+}
+
+function getFocusedTimelineRowKey(target: EventTarget | null): number | undefined {
+  if (!(target instanceof Element)) return undefined;
+  const value = target.closest<HTMLElement>("[data-timeline-row-key]")?.dataset.timelineRowKey;
+  if (value === undefined) return undefined;
+  const rowKey = Number(value);
+  return Number.isFinite(rowKey) ? rowKey : undefined;
+}
+
+export function useTimelineRowVirtualization({
+  scrollRef,
+  viewport,
+  rowGeometry,
+  sessionEpoch,
+  elements,
+  selectedElementId,
+  revealElementId,
+  draggedRowKey,
+  resizingRowKey,
+  clipContextMenuRowKey,
+  keyframeContextMenuRowKey,
+  lastScrollLeftRef,
+  syncScrollViewport,
+}: UseTimelineRowVirtualizationInput) {
+  const enabled =
+    STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED &&
+    viewport.clientWidth > 0 &&
+    viewport.clientHeight > 0;
+  const [domFocusedRowKey, setDomFocusedRowKey] = useState<number>();
+  useEffect(() => {
+    const scroll = scrollRef.current;
+    if (!scroll) return;
+    const handleFocusIn = (event: FocusEvent) => {
+      setDomFocusedRowKey(getFocusedTimelineRowKey(event.target));
+    };
+    const handleFocusOut = (event: FocusEvent) => {
+      setDomFocusedRowKey(getFocusedTimelineRowKey(event.relatedTarget));
+    };
+    scroll.addEventListener("focusin", handleFocusIn);
+    scroll.addEventListener("focusout", handleFocusOut);
+    return () => {
+      scroll.removeEventListener("focusin", handleFocusIn);
+      scroll.removeEventListener("focusout", handleFocusOut);
+    };
+  }, [scrollRef, sessionEpoch]);
+  const focusIdentity = useMemo(
+    () => resolveTimelineFocusIdentity(elements, selectedElementId),
+    [elements, selectedElementId],
+  );
+  const revealIdentity = useMemo(
+    () => resolveTimelineFocusIdentity(elements, revealElementId),
+    [elements, revealElementId],
+  );
+  const pinnedRowKeys = useMemo(
+    () =>
+      [
+        draggedRowKey,
+        resizingRowKey,
+        revealIdentity?.rowKey,
+        clipContextMenuRowKey,
+        keyframeContextMenuRowKey,
+      ].filter((rowKey): rowKey is number => rowKey !== undefined),
+    [
+      clipContextMenuRowKey,
+      draggedRowKey,
+      keyframeContextMenuRowKey,
+      resizingRowKey,
+      revealIdentity,
+    ],
+  );
+  const virtualRows = useTimelineVirtualRows({
+    enabled,
+    scrollRef,
+    viewport,
+    rowGeometry,
+    sessionEpoch,
+    pinnedRowKeys,
+    focusedRowKey: domFocusedRowKey ?? focusIdentity?.rowKey,
+  });
+
+  const previousLayoutRef = useRef(rowGeometry);
+  const previousSessionEpochRef = useRef(sessionEpoch);
+  useLayoutEffect(() => {
+    const scroll = scrollRef.current;
+    const previousGeometry = previousLayoutRef.current;
+    if (previousSessionEpochRef.current !== sessionEpoch) {
+      previousSessionEpochRef.current = sessionEpoch;
+      lastScrollLeftRef.current = 0;
+      if (scroll) {
+        scroll.scrollLeft = 0;
+        scroll.scrollTop = 0;
+        syncScrollViewport(scroll);
+      }
+    } else if (scroll && previousGeometry !== rowGeometry) {
+      const nextScrollTop = getTimelineScrollTopForGeometryChange(
+        previousGeometry,
+        rowGeometry,
+        scroll.scrollTop,
+      );
+      if (nextScrollTop !== scroll.scrollTop) {
+        scroll.scrollTop = nextScrollTop;
+        syncScrollViewport(scroll);
+      }
+    }
+    previousLayoutRef.current = rowGeometry;
+  }, [lastScrollLeftRef, rowGeometry, scrollRef, sessionEpoch, syncScrollViewport]);
+
+  return { enabled, virtualRows };
+}
diff --git a/packages/studio/src/player/components/useTimelineVirtualRows.test.tsx b/packages/studio/src/player/components/useTimelineVirtualRows.test.tsx
new file mode 100644
index 0000000000..582fbfeeb0
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineVirtualRows.test.tsx
@@ -0,0 +1,174 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import { createTimelineRowGeometry, RULER_H, TRACKS_TOP_PAD } from "./timelineLayout";
+import { extractTimelineVirtualRowRange, useTimelineVirtualRows } from "./useTimelineVirtualRows";
+import type { TimelineScrollViewportSnapshot } from "./useTimelineScrollViewport";
+
+(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+class MockResizeObserver {
+  constructor(private readonly callback: ResizeObserverCallback) {}
+  observe(target: Element) {
+    const { width, height } = target.getBoundingClientRect();
+    this.callback(
+      [
+        {
+          target,
+          borderBoxSize: [{ inlineSize: width, blockSize: height }],
+        } as unknown as ResizeObserverEntry,
+      ],
+      this as unknown as ResizeObserver,
+    );
+  }
+  unobserve() {}
+  disconnect() {}
+}
+
+const originalResizeObserver = globalThis.ResizeObserver;
+
+beforeAll(() => {
+  globalThis.ResizeObserver = MockResizeObserver as unknown as typeof ResizeObserver;
+});
+
+afterAll(() => {
+  globalThis.ResizeObserver = originalResizeObserver;
+});
+
+afterEach(() => {
+  document.body.innerHTML = "";
+});
+
+function createScrollElement(scrollTop: number, width = 800, height = 192): HTMLDivElement {
+  const element = document.createElement("div");
+  document.body.append(element);
+  Object.defineProperties(element, {
+    scrollTop: { configurable: true, writable: true, value: scrollTop },
+    scrollLeft: { configurable: true, writable: true, value: 0 },
+    clientWidth: { configurable: true, value: width },
+    clientHeight: { configurable: true, value: height },
+    scrollWidth: { configurable: true, value: width },
+    scrollHeight: { configurable: true, value: 60_000 },
+  });
+  element.getBoundingClientRect = () =>
+    ({ width, height, top: 0, left: 0, right: width, bottom: height, x: 0, y: 0 }) as DOMRect;
+  return element;
+}
+
+function viewport(element: HTMLDivElement): TimelineScrollViewportSnapshot {
+  return {
+    scrollLeft: element.scrollLeft,
+    scrollTop: element.scrollTop,
+    clientWidth: element.clientWidth,
+    clientHeight: element.clientHeight,
+    scrollWidth: element.scrollWidth,
+    scrollHeight: element.scrollHeight,
+    isScrolling: false,
+  };
+}
+
+function createLargeGeometry(keyOffset = 0) {
+  const keys = Array.from({ length: 1_000 }, (_, index) => index + keyOffset);
+  return createTimelineRowGeometry(
+    keys,
+    keys.map(() => 48),
+  );
+}
+
+describe("extractTimelineVirtualRowRange", () => {
+  it("unions visible overscan with unique actor pins", () => {
+    expect(
+      extractTimelineVirtualRowRange(
+        { startIndex: 10, endIndex: 12, overscan: 2, count: 100 },
+        [0, 11, 99, 99, -1, 100],
+      ),
+    ).toEqual([0, 8, 9, 10, 11, 12, 13, 14, 99]);
+  });
+});
+
+describe("useTimelineVirtualRows", () => {
+  it("mounts a bounded vertical range plus the focused row", () => {
+    const geometry = createLargeGeometry(0.5);
+    const scroll = createScrollElement(RULER_H + TRACKS_TOP_PAD + 500 * 48);
+    const scrollRef = { current: scroll };
+    let rows: ReturnType<typeof useTimelineVirtualRows> = [];
+
+    function Probe() {
+      rows = useTimelineVirtualRows({
+        enabled: true,
+        scrollRef,
+        viewport: viewport(scroll),
+        rowGeometry: geometry,
+        sessionEpoch: 1,
+        pinnedRowKeys: [],
+        focusedRowKey: 900.5,
+      });
+      return null;
+    }
+
+    const root = createRoot(document.createElement("div"));
+    act(() => root.render(React.createElement(Probe)));
+    act(() => {});
+
+    expect(rows.length).toBeGreaterThan(0);
+    expect(rows.length).toBeLessThanOrEqual(16);
+    expect(rows.some((row) => row.index === 500)).toBe(true);
+    expect(rows.some((row) => row.rowKey === 900.5)).toBe(true);
+    act(() => root.unmount());
+  });
+
+  it("keeps compatibility rendering complete while the gate is disabled", () => {
+    const geometry = createTimelineRowGeometry([10, 5.5, 20], [48, 76, 48]);
+    const scroll = createScrollElement(0);
+    let rows: ReturnType<typeof useTimelineVirtualRows> = [];
+
+    function Probe() {
+      rows = useTimelineVirtualRows({
+        enabled: false,
+        scrollRef: { current: scroll },
+        viewport: viewport(scroll),
+        rowGeometry: geometry,
+        sessionEpoch: 1,
+        pinnedRowKeys: [],
+      });
+      return null;
+    }
+
+    const root = createRoot(document.createElement("div"));
+    act(() => root.render(React.createElement(Probe)));
+    expect(rows.map((row) => row.rowKey)).toEqual([10, 5.5, 20]);
+    act(() => root.unmount());
+  });
+
+  it("observes Timeline's authoritative scroll reset when the session epoch changes", () => {
+    const geometry = createLargeGeometry();
+    const scroll = createScrollElement(RULER_H + TRACKS_TOP_PAD + 500 * 48);
+    const scrollRef = { current: scroll };
+    let rows: ReturnType<typeof useTimelineVirtualRows> = [];
+
+    function Probe({ sessionEpoch }: { sessionEpoch: number }) {
+      rows = useTimelineVirtualRows({
+        enabled: true,
+        scrollRef,
+        viewport: viewport(scroll),
+        rowGeometry: geometry,
+        sessionEpoch,
+        pinnedRowKeys: [],
+      });
+      return null;
+    }
+
+    const root = createRoot(document.createElement("div"));
+    act(() => root.render(React.createElement(Probe, { sessionEpoch: 1 })));
+    expect(rows.some((row) => row.index === 500)).toBe(true);
+
+    scroll.scrollTop = 0;
+    act(() => root.render(React.createElement(Probe, { sessionEpoch: 2 })));
+    expect(rows.some((row) => row.index === 0)).toBe(true);
+    expect(rows.some((row) => row.index === 500)).toBe(false);
+
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useTimelineVirtualRows.ts b/packages/studio/src/player/components/useTimelineVirtualRows.ts
new file mode 100644
index 0000000000..d891474059
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineVirtualRows.ts
@@ -0,0 +1,110 @@
+import { useCallback, useEffect, useMemo, type RefObject } from "react";
+import { defaultRangeExtractor, useVirtualizer, type Range } from "@tanstack/react-virtual";
+import { TIMELINE_VIEWPORT_BUDGETS } from "../lib/timelineViewportBudgets";
+import type { TimelineScrollViewportSnapshot } from "./useTimelineScrollViewport";
+import { RULER_H, TRACKS_TOP_PAD, type TimelineRowGeometry } from "./timelineLayout";
+
+/** Disabled until horizontal windowing and stable gesture lifetime land. */
+export const STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED =
+  import.meta.env.DEV === true &&
+  import.meta.env.VITE_STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED === "1";
+
+export interface TimelineVirtualRow {
+  readonly index: number;
+  readonly rowKey: number;
+}
+
+export function extractTimelineVirtualRowRange(
+  range: Range,
+  pinnedRowIndexes: readonly number[],
+): number[] {
+  const indexes = new Set(defaultRangeExtractor(range));
+  for (const index of pinnedRowIndexes) {
+    if (index >= 0 && index < range.count) indexes.add(index);
+  }
+  return [...indexes].sort((left, right) => left - right);
+}
+
+interface UseTimelineVirtualRowsInput {
+  enabled: boolean;
+  scrollRef: RefObject<HTMLDivElement | null>;
+  viewport: TimelineScrollViewportSnapshot;
+  rowGeometry: TimelineRowGeometry;
+  sessionEpoch: number;
+  pinnedRowKeys: readonly number[];
+  focusedRowKey?: number;
+}
+
+export function useTimelineVirtualRows({
+  enabled,
+  scrollRef,
+  viewport,
+  rowGeometry,
+  sessionEpoch,
+  pinnedRowKeys,
+  focusedRowKey,
+}: UseTimelineVirtualRowsInput): readonly TimelineVirtualRow[] {
+  const pinnedRowIndexes = useMemo(
+    () => [
+      ...new Set(
+        [...pinnedRowKeys, ...(focusedRowKey === undefined ? [] : [focusedRowKey])].map((key) =>
+          rowGeometry.getRowIndex(key),
+        ),
+      ),
+    ],
+    [focusedRowKey, pinnedRowKeys, rowGeometry],
+  );
+  const estimateSize = useCallback(
+    (index: number) => rowGeometry.getRowHeight(index),
+    [rowGeometry],
+  );
+  const getItemKey = useCallback(
+    (index: number) => rowGeometry.rowKeys[index] ?? index,
+    [rowGeometry],
+  );
+  const rangeExtractor = useCallback(
+    (range: Range) => extractTimelineVirtualRowRange(range, pinnedRowIndexes),
+    [pinnedRowIndexes],
+  );
+  const initialOffset = useCallback(() => viewport.scrollTop, [viewport.scrollTop]);
+  const virtualizer = useVirtualizer({
+    enabled,
+    useFlushSync: false,
+    count: rowGeometry.rowKeys.length,
+    getScrollElement: () => scrollRef.current,
+    estimateSize,
+    getItemKey,
+    overscan: TIMELINE_VIEWPORT_BUDGETS.rowOverscanPerSide,
+    rangeExtractor,
+    scrollMargin: RULER_H + TRACKS_TOP_PAD,
+    initialRect: { width: viewport.clientWidth, height: viewport.clientHeight },
+    initialOffset,
+  });
+
+  useEffect(() => {
+    if (!enabled) return;
+    virtualizer.measure();
+    // Timeline owns the epoch reset. This event only makes the virtualizer
+    // observe the authoritative DOM offset after that reset; it never writes
+    // scrollTop itself.
+    scrollRef.current?.dispatchEvent(new Event("scroll"));
+  }, [enabled, scrollRef, sessionEpoch, virtualizer]);
+
+  const focusedRowIndex = focusedRowKey === undefined ? -1 : rowGeometry.getRowIndex(focusedRowKey);
+  const focusedRowHeight = focusedRowIndex < 0 ? 0 : rowGeometry.getRowHeight(focusedRowIndex);
+  useEffect(() => {
+    if (enabled && focusedRowIndex >= 0) {
+      virtualizer.resizeItem(focusedRowIndex, focusedRowHeight);
+    }
+  }, [enabled, focusedRowHeight, focusedRowIndex, sessionEpoch, virtualizer]);
+
+  const allRows = useMemo(
+    () => rowGeometry.rowKeys.map((rowKey, index) => ({ index, rowKey })),
+    [rowGeometry],
+  );
+  if (!enabled) return allRows;
+  return virtualizer.getVirtualItems().map(({ index }) => ({
+    index,
+    rowKey: rowGeometry.rowKeys[index] ?? index,
+  }));
+}

From 6883a5e926ceffe9233e695c35653b1042d63bda Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 19:33:49 +0200
Subject: [PATCH 111/125] perf(studio): index timeline clip windows

---
 .../src/player/components/BeatStrip.tsx       |  26 +++-
 .../src/player/components/TimelineRuler.tsx   |  25 +++-
 .../player/components/timelineLayout.test.ts  |  40 ++++++
 .../src/player/components/timelineLayout.ts   |  48 ++++++-
 .../components/timelineRulerGeometry.ts       |  49 +++++--
 .../components/timelineViewportGeometry.ts    |  20 +++
 .../src/player/lib/timelineClipIndex.test.ts  |  90 +++++++++++++
 .../src/player/lib/timelineClipIndex.ts       | 123 ++++++++++++++++++
 8 files changed, 399 insertions(+), 22 deletions(-)
 create mode 100644 packages/studio/src/player/lib/timelineClipIndex.test.ts
 create mode 100644 packages/studio/src/player/lib/timelineClipIndex.ts

diff --git a/packages/studio/src/player/components/BeatStrip.tsx b/packages/studio/src/player/components/BeatStrip.tsx
index 0caa0e3263..a7558d56a8 100644
--- a/packages/studio/src/player/components/BeatStrip.tsx
+++ b/packages/studio/src/player/components/BeatStrip.tsx
@@ -1,7 +1,8 @@
 import { memo, useRef, useState } from "react";
 import { moveBeatCompositionTime, deleteBeatAtCompositionTime } from "../../utils/beatEditActions";
 import { usePlayerStore } from "../store/playerStore";
-import { CLIP_Y } from "./timelineLayout";
+import { CLIP_Y, getTimelineBeatEntries } from "./timelineLayout";
+import type { TimelineTimeRange } from "../lib/timelineClipIndex";
 
 export const BEAT_BAND_H = 14; // dark band height at top of track
 const BEAT_HIT_W = 12; // grab width per beat (px)
@@ -24,23 +25,30 @@ export const BeatBackgroundLines = memo(function BeatBackgroundLines({
   beatStrengths,
   pps,
   highlightTime,
+  renderTimeRange,
 }: {
   beatTimes: number[] | undefined;
   beatStrengths: number[] | undefined;
   pps: number;
   /** Snap guide time — drawn as a bright line even when it is not a beat. */
   highlightTime?: number | null;
+  renderTimeRange?: TimelineTimeRange;
 }) {
   const visibleBeatTimes = beatTimes && !beatsTooDense(beatTimes, pps) ? beatTimes : null;
   const highlightIsBeat =
     highlightTime != null &&
     visibleBeatTimes?.some((t) => Math.abs(t - highlightTime) < 1e-3) === true;
   if (!visibleBeatTimes && highlightTime == null) return null;
+  const beatEntries = getTimelineBeatEntries(
+    visibleBeatTimes ?? undefined,
+    beatStrengths,
+    renderTimeRange,
+  );
   return (
     <div className="absolute inset-0 pointer-events-none" style={{ zIndex: 0 }}>
-      {visibleBeatTimes?.map((t, i) => {
+      {beatEntries.map(({ time: t, index: i, strength: beatStrength }) => {
         const isHighlight = highlightTime != null && Math.abs(t - highlightTime) < 1e-3;
-        const strength = Math.pow(Math.min(1, beatStrengths?.[i] ?? 0.5), 2.2);
+        const strength = Math.pow(Math.min(1, beatStrength ?? 0.5), 2.2);
         const opacity = isHighlight ? 1 : 0.06 + strength * 0.16;
         return (
           <div
@@ -81,10 +89,12 @@ export const BeatStrip = memo(function BeatStrip({
   beatTimes,
   beatStrengths,
   pps,
+  renderTimeRange,
 }: {
   beatTimes: number[] | undefined;
   beatStrengths: number[] | undefined;
   pps: number;
+  renderTimeRange?: TimelineTimeRange;
 }) {
   // Active drag: which beat and how far (px) it's been dragged.
   const [drag, setDrag] = useState<{ index: number; dx: number } | null>(null);
@@ -92,15 +102,21 @@ export const BeatStrip = memo(function BeatStrip({
 
   if (!beatTimes || beatsTooDense(beatTimes, pps)) return null;
   const cy = BEAT_BAND_H / 2;
+  const beatEntries = getTimelineBeatEntries(
+    beatTimes,
+    beatStrengths,
+    renderTimeRange,
+    drag ? new Set([drag.index]) : undefined,
+  );
 
   return (
     <div
       className="absolute left-0 right-0 pointer-events-none"
       style={{ top: CLIP_Y, height: BEAT_BAND_H, background: "rgba(0,0,0,0.28)", zIndex: 11 }}
     >
-      {beatTimes.map((t, i) => {
+      {beatEntries.map(({ time: t, index: i, strength: beatStrength }) => {
         // Louder beats → larger, brighter dot. Gamma curve widens the contrast.
-        const strength = Math.pow(Math.min(1, beatStrengths?.[i] ?? 0.5), 2.2);
+        const strength = Math.pow(Math.min(1, beatStrength ?? 0.5), 2.2);
         const r = 1.5 + strength * 2.5;
         const opacity = 0.25 + strength * 0.75;
         const dxPx = drag?.index === i ? drag.dx : 0;
diff --git a/packages/studio/src/player/components/TimelineRuler.tsx b/packages/studio/src/player/components/TimelineRuler.tsx
index 5356341bbe..206b64a4db 100644
--- a/packages/studio/src/player/components/TimelineRuler.tsx
+++ b/packages/studio/src/player/components/TimelineRuler.tsx
@@ -1,9 +1,10 @@
 import { memo } from "react";
 import type { TimelineTheme } from "./timelineTheme";
-import { RULER_H, formatTimelineTickLabel } from "./timelineLayout";
+import { RULER_H, formatTimelineTickLabel, getTimelineBeatEntries } from "./timelineLayout";
 import { usePlayerStore } from "../store/playerStore";
 import { secondsToFrame } from "../lib/time";
 import type { MusicBeatAnalysis } from "@hyperframes/core/beats";
+import type { TimelineTimeRange } from "../lib/timelineClipIndex";
 
 interface TimelineRulerProps {
   major: number[];
@@ -16,6 +17,7 @@ interface TimelineRulerProps {
   theme: TimelineTheme;
   beatAnalysis?: MusicBeatAnalysis | null;
   contentOrigin: number;
+  renderTimeRange?: TimelineTimeRange;
 }
 
 export const TimelineRuler = memo(function TimelineRuler({
@@ -29,10 +31,12 @@ export const TimelineRuler = memo(function TimelineRuler({
   theme,
   beatAnalysis,
   contentOrigin,
+  renderTimeRange,
 }: TimelineRulerProps) {
   const timeDisplayMode = usePlayerStore((s) => s.timeDisplayMode);
   const beatTimes = beatAnalysis?.beatTimes ?? [];
   const beatStrengths = beatAnalysis?.beatStrengths ?? [];
+  const beatEntries = getTimelineBeatEntries(beatTimes, beatStrengths, renderTimeRange);
 
   // Only draw beat lines when they'd be at least 5px apart
   const avgBeatInterval =
@@ -51,13 +55,14 @@ export const TimelineRuler = memo(function TimelineRuler({
         height={totalH}
       >
         {showBeats &&
-          beatTimes.map((t, i) => {
+          beatEntries.map(({ time: t, index: i, strength: beatStrength }) => {
             const x = t * pps;
             // Louder beats → brighter line. Gamma curve widens the contrast.
-            const strength = Math.pow(Math.min(1, beatStrengths[i] ?? 0.5), 2.2);
+            const strength = Math.pow(Math.min(1, beatStrength ?? 0.5), 2.2);
             const opacity = 0.08 + strength * 0.62;
             return (
               <line
+                data-timeline-grid-cell="beat"
                 key={`b-${t}-${i}`}
                 x1={x}
                 y1={0}
@@ -103,13 +108,23 @@ export const TimelineRuler = memo(function TimelineRuler({
               contentOrigin + t * pps (see getTimelinePlayheadLeft). Without the shift
               a tick spans [x, x+1) and its center is half a pixel right. */}
           {minor.map((t) => (
-            <div key={`m-${t}`} className="absolute bottom-0" style={{ left: t * pps - 0.5 }}>
+            <div
+              key={`m-${t}`}
+              data-timeline-grid-cell="minor"
+              className="absolute bottom-0"
+              style={{ left: t * pps - 0.5 }}
+            >
               <div className="w-px h-2" style={{ background: theme.tickMinor }} />
             </div>
           ))}
 
           {major.map((t) => (
-            <div key={`M-${t}`} className="absolute top-0" style={{ left: t * pps - 0.5 }}>
+            <div
+              key={`M-${t}`}
+              data-timeline-grid-cell="major"
+              className="absolute top-0"
+              style={{ left: t * pps - 0.5 }}
+            >
               <span
                 className="absolute font-mono tabular-nums leading-none whitespace-nowrap"
                 style={{
diff --git a/packages/studio/src/player/components/timelineLayout.test.ts b/packages/studio/src/player/components/timelineLayout.test.ts
index 488d0662b4..960eacf02b 100644
--- a/packages/studio/src/player/components/timelineLayout.test.ts
+++ b/packages/studio/src/player/components/timelineLayout.test.ts
@@ -19,7 +19,47 @@ import {
   getTimelineRowGeometry,
   trackHeights,
   resolveTimelineAssetDrop,
+  generateTicks,
+  getTimelineBeatEntries,
+  getTimelineMajorTickInterval,
 } from "./timelineLayout";
+import { getTimelineRenderTimeRange } from "./timelineViewportGeometry";
+
+describe("horizontal timeline window", () => {
+  it("adds the shared half-viewport overscan on each side and clamps to duration", () => {
+    expect(getTimelineRenderTimeRange({ scrollLeft: 300, clientWidth: 500 }, 100, 200, 20)).toEqual(
+      { start: 0, end: 8.5 },
+    );
+    expect(
+      getTimelineRenderTimeRange({ scrollLeft: 1_900, clientWidth: 500 }, 100, 200, 20),
+    ).toEqual({ start: 14.5, end: 20 });
+  });
+
+  it("generates globally aligned ticks directly inside the bounded window", () => {
+    const ticks = generateTicks(10_000, 100, undefined, { start: 500.2, end: 501.8 });
+    const interval = getTimelineMajorTickInterval(10_000, 100);
+    expect(ticks.major.every((time) => time >= 500.2 && time <= 501.8)).toBe(true);
+    expect(
+      ticks.major.every((time) => Math.abs(time / interval - Math.round(time / interval)) < 1e-6),
+    ).toBe(true);
+    expect(ticks.major.length + ticks.minor.length).toBeLessThan(100);
+  });
+
+  it("slices beat records with original strength indexes and unions a pinned beat", () => {
+    expect(
+      getTimelineBeatEntries(
+        [0, 1, 2, 3],
+        [0.1, 0.2, 0.3, 0.4],
+        { start: 1, end: 3 },
+        new Set([3]),
+      ),
+    ).toEqual([
+      { index: 1, time: 1, strength: 0.2 },
+      { index: 2, time: 2, strength: 0.3 },
+      { index: 3, time: 3, strength: 0.4 },
+    ]);
+  });
+});
 
 /** N collapsed rows, the shape every caller passes when nothing is expanded. */
 const baseRows = (count: number) => Array.from({ length: count }, () => TRACK_H);
diff --git a/packages/studio/src/player/components/timelineLayout.ts b/packages/studio/src/player/components/timelineLayout.ts
index b8d5579826..9c6fcd8c22 100644
--- a/packages/studio/src/player/components/timelineLayout.ts
+++ b/packages/studio/src/player/components/timelineLayout.ts
@@ -1,6 +1,11 @@
 import type { ZoomMode } from "../store/playerStore";
+import type { TimelineTimeRange } from "../lib/timelineClipIndex";
 
-export { formatTimelineTickLabel, generateTicks } from "./timelineRulerGeometry";
+export {
+  formatTimelineTickLabel,
+  generateTicks,
+  getTimelineMajorTickInterval,
+} from "./timelineRulerGeometry";
 
 /* ── Layout constants ──────────────────────────────────────────────── */
 export const GUTTER = 32;
@@ -11,6 +16,47 @@ export const RULER_H = 24;
 export const CLIP_Y = 3;
 export const CLIP_HANDLE_W = 18;
 
+export interface TimelineBeatEntry {
+  readonly index: number;
+  readonly time: number;
+  readonly strength: number | undefined;
+}
+
+function findFirstTimeAtOrAfter(times: readonly number[], target: number): number {
+  let low = 0;
+  let high = times.length;
+  while (low < high) {
+    const mid = Math.floor((low + high) / 2);
+    if ((times[mid] ?? Number.POSITIVE_INFINITY) < target) low = mid + 1;
+    else high = mid;
+  }
+  return low;
+}
+
+/** Slice sorted beat data without allocating entries outside the render window. */
+export function getTimelineBeatEntries(
+  beatTimes: readonly number[] | undefined,
+  beatStrengths: readonly number[] | undefined,
+  range: TimelineTimeRange | undefined,
+  pinnedIndexes: ReadonlySet<number> = new Set(),
+): readonly TimelineBeatEntry[] {
+  if (!beatTimes?.length) return [];
+  const start = range?.start ?? Number.NEGATIVE_INFINITY;
+  const end = range?.end ?? Number.POSITIVE_INFINITY;
+  const selected = new Set<number>();
+  for (let index = findFirstTimeAtOrAfter(beatTimes, start); index < beatTimes.length; index++) {
+    const time = beatTimes[index];
+    if (time === undefined || time >= end) break;
+    selected.add(index);
+  }
+  for (const index of pinnedIndexes) {
+    if (index >= 0 && index < beatTimes.length) selected.add(index);
+  }
+  return [...selected]
+    .sort((left, right) => left - right)
+    .map((index) => ({ index, time: beatTimes[index]!, strength: beatStrengths?.[index] }));
+}
+
 export function getTimelineLaneTop(laneIndex: number): number {
   return TRACK_H + Math.max(0, Math.trunc(laneIndex)) * LANE_H;
 }
diff --git a/packages/studio/src/player/components/timelineRulerGeometry.ts b/packages/studio/src/player/components/timelineRulerGeometry.ts
index 59d1c4794c..32ccc50ac5 100644
--- a/packages/studio/src/player/components/timelineRulerGeometry.ts
+++ b/packages/studio/src/player/components/timelineRulerGeometry.ts
@@ -1,7 +1,8 @@
 import { formatTime } from "../lib/time";
+import type { TimelineTimeRange } from "../lib/timelineClipIndex";
 
 // fallow-ignore-next-line complexity
-function getTimelineMajorTickInterval(
+export function getTimelineMajorTickInterval(
   duration: number,
   pixelsPerSecond?: number,
   frameRate?: number,
@@ -49,28 +50,54 @@ function roundTickValue(time: number): number {
   return Math.round(time * 1e6) / 1e6;
 }
 
+function isSupportedTickDuration(duration: number): boolean {
+  return duration > 0 && Number.isFinite(duration) && duration <= 14400;
+}
+
+function getTickRange(duration: number, range?: TimelineTimeRange): TimelineTimeRange {
+  return {
+    start: Math.max(0, range?.start ?? 0),
+    end: Math.min(duration, range?.end ?? duration),
+  };
+}
+
+function appendMinorTicks(
+  minor: number[],
+  majorTime: number,
+  minorInterval: number,
+  subdivisions: number,
+  range: TimelineTimeRange,
+  maxTicks: number,
+  majorCount: number,
+): void {
+  for (let part = 1; part < subdivisions && majorCount + minor.length < maxTicks; part++) {
+    const time = majorTime + part * minorInterval;
+    if (time >= range.start - 0.001 && time <= range.end + 0.001) {
+      minor.push(roundTickValue(time));
+    }
+  }
+}
+
 export function generateTicks(
   duration: number,
   pixelsPerSecond?: number,
   frameRate?: number,
+  range?: TimelineTimeRange,
 ): { major: number[]; minor: number[] } {
-  if (duration <= 0 || !Number.isFinite(duration) || duration > 14400) {
-    return { major: [], minor: [] };
-  }
+  if (!isSupportedTickDuration(duration)) return { major: [], minor: [] };
   const majorInterval = getTimelineMajorTickInterval(duration, pixelsPerSecond, frameRate);
   const subdivisions = getMinorSubdivisions(majorInterval, pixelsPerSecond, frameRate);
   const minorInterval = subdivisions > 0 ? majorInterval / subdivisions : 0;
   const major: number[] = [];
   const minor: number[] = [];
   const maxTicks = 2000;
-  for (let index = 0; major.length < maxTicks; index++) {
+  const tickRange = getTickRange(duration, range);
+  const firstMajorIndex = Math.max(0, Math.floor(tickRange.start / majorInterval));
+  for (let index = firstMajorIndex; major.length < maxTicks; index++) {
     const time = index * majorInterval;
-    if (time > duration + 0.001) break;
-    major.push(roundTickValue(time));
-    for (let part = 1; part < subdivisions && major.length + minor.length < maxTicks; part++) {
-      const minorTime = time + part * minorInterval;
-      if (minorTime <= duration + 0.001) minor.push(roundTickValue(minorTime));
-    }
+    if (time > tickRange.end + 0.001) break;
+    if (time >= tickRange.start - 0.001) major.push(roundTickValue(time));
+    appendMinorTicks(minor, time, minorInterval, subdivisions, tickRange, maxTicks, major.length);
   }
   return { major, minor };
 }
diff --git a/packages/studio/src/player/components/timelineViewportGeometry.ts b/packages/studio/src/player/components/timelineViewportGeometry.ts
index ee86f834fa..db0a964232 100644
--- a/packages/studio/src/player/components/timelineViewportGeometry.ts
+++ b/packages/studio/src/player/components/timelineViewportGeometry.ts
@@ -1,6 +1,26 @@
 import { RULER_H, type TimelineRowGeometry } from "./timelineLayout";
+import { TIMELINE_VIEWPORT_BUDGETS } from "../lib/timelineViewportBudgets";
+import type { TimelineTimeRange } from "../lib/timelineClipIndex";
 import type { TimelineScrollViewportSnapshot } from "./useTimelineScrollViewport";
 
+export function getTimelineRenderTimeRange(
+  viewport: Pick<TimelineScrollViewportSnapshot, "scrollLeft" | "clientWidth">,
+  pixelsPerSecond: number,
+  contentOrigin: number,
+  duration: number,
+): TimelineTimeRange {
+  if (!(pixelsPerSecond > 0) || !(duration > 0) || !(viewport.clientWidth > 0)) {
+    return { start: 0, end: 0 };
+  }
+  const overscanPx = viewport.clientWidth * TIMELINE_VIEWPORT_BUDGETS.timeOverscanViewportRatio;
+  const startPx = viewport.scrollLeft - contentOrigin - overscanPx;
+  const endPx = viewport.scrollLeft + viewport.clientWidth - contentOrigin + overscanPx;
+  return {
+    start: Math.min(duration, Math.max(0, startPx / pixelsPerSecond)),
+    end: Math.min(duration, Math.max(0, endPx / pixelsPerSecond)),
+  };
+}
+
 export function getTimelineVisibleTimeRange(
   viewport: Pick<TimelineScrollViewportSnapshot, "scrollLeft" | "clientWidth">,
   pixelsPerSecond: number,
diff --git a/packages/studio/src/player/lib/timelineClipIndex.test.ts b/packages/studio/src/player/lib/timelineClipIndex.test.ts
new file mode 100644
index 0000000000..eb0d5d4337
--- /dev/null
+++ b/packages/studio/src/player/lib/timelineClipIndex.test.ts
@@ -0,0 +1,90 @@
+import { describe, expect, it } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import { createTimelineClipIndex, queryTimelineClipIndex } from "./timelineClipIndex";
+
+function clip(
+  id: string,
+  start: number,
+  duration: number,
+  track = 1,
+  hidden = false,
+): TimelineElement {
+  return { id, tag: "div", start, duration, track, hidden };
+}
+
+function ids(elements: readonly TimelineElement[]): string[] {
+  return elements.map((element) => element.key ?? element.id);
+}
+
+describe("timelineClipIndex", () => {
+  it("finds a long predecessor spanning the window", () => {
+    const index = createTimelineClipIndex([[1, [clip("long", 0, 100), clip("late", 80, 1)]]]);
+    expect(ids(queryTimelineClipIndex(index, 1, { start: 50, end: 51 }))).toEqual(["long"]);
+  });
+
+  it("uses half-open render boundaries and retains zero-duration points", () => {
+    const index = createTimelineClipIndex([
+      [
+        1,
+        [
+          clip("left", 0, 2),
+          clip("right", 2, 2),
+          clip("point", 3, 0),
+          clip("negative", 3.5, -2),
+          clip("micro", 4, 1e-9),
+        ],
+      ],
+    ]);
+    expect(ids(queryTimelineClipIndex(index, 1, { start: 2, end: 4 }))).toEqual([
+      "right",
+      "point",
+      "negative",
+    ]);
+    expect(ids(queryTimelineClipIndex(index, 1, { start: 4, end: 5 }))).toEqual(["micro"]);
+  });
+
+  it("preserves projection order after overlap and pin union", () => {
+    const index = createTimelineClipIndex([
+      [1, [clip("pinned", 10, 1), clip("visible-b", 2, 1), clip("visible-a", 1, 3)]],
+    ]);
+    expect(
+      ids(queryTimelineClipIndex(index, 1, { start: 1.5, end: 2.5 }, new Set(["pinned"]))),
+    ).toEqual(["pinned", "visible-b", "visible-a"]);
+  });
+
+  it("keeps duplicate identities deterministic and ignores stale pins", () => {
+    const index = createTimelineClipIndex([
+      [1, [clip("duplicate", 10, 1), clip("duplicate", 20, 1), clip("hidden", 30, 1, 1, true)]],
+      [2, [clip("duplicate", 40, 1, 2)]],
+    ]);
+    expect(
+      ids(queryTimelineClipIndex(index, 1, { start: 0, end: 1 }, new Set(["duplicate", "stale"]))),
+    ).toEqual(["duplicate", "duplicate"]);
+    expect(
+      ids(queryTimelineClipIndex(index, 2, { start: 0, end: 1 }, new Set(["duplicate"]))),
+    ).toEqual(["duplicate"]);
+  });
+
+  it("keeps an immutable interval snapshot when the source projection array changes", () => {
+    const source = [clip("first", 0, 2), clip("second", 5, 2)];
+    const index = createTimelineClipIndex([[1, source]]);
+    source.splice(0, source.length, clip("replacement", 0, 20));
+    expect(ids(queryTimelineClipIndex(index, 1, { start: 0, end: 1 }))).toEqual(["first"]);
+  });
+
+  it("excludes clips with non-finite timing", () => {
+    const index = createTimelineClipIndex([
+      [1, [clip("bad-start", Number.NaN, 1), clip("bad-duration", 0, Number.POSITIVE_INFINITY)]],
+    ]);
+    expect(ids(queryTimelineClipIndex(index, 1, { start: 0, end: 1 }))).toEqual([]);
+  });
+
+  it("indexes synthetic fractional display rows independently", () => {
+    const index = createTimelineClipIndex([
+      [1, [clip("host", 0, 1)]],
+      [1.5, [clip("child", 10, 1, 1.5)]],
+    ]);
+    expect(ids(queryTimelineClipIndex(index, 1.5, { start: 10, end: 11 }))).toEqual(["child"]);
+    expect(ids(queryTimelineClipIndex(index, 1, { start: 10, end: 11 }))).toEqual([]);
+  });
+});
diff --git a/packages/studio/src/player/lib/timelineClipIndex.ts b/packages/studio/src/player/lib/timelineClipIndex.ts
new file mode 100644
index 0000000000..5d56311c12
--- /dev/null
+++ b/packages/studio/src/player/lib/timelineClipIndex.ts
@@ -0,0 +1,123 @@
+import type { TimelineElement } from "../store/playerStore";
+
+export interface TimelineTimeRange {
+  readonly start: number;
+  readonly end: number;
+}
+
+interface TimelineClipInterval {
+  readonly element: TimelineElement;
+  readonly identity: string;
+  readonly ordinal: number;
+  readonly start: number;
+  readonly end: number;
+}
+
+interface TimelineClipRowIndex {
+  readonly byStart: readonly TimelineClipInterval[];
+  readonly prefixMaxEnd: readonly number[];
+  readonly byIdentity: ReadonlyMap<string, readonly TimelineClipInterval[]>;
+}
+
+export interface TimelineClipIndex {
+  readonly rows: ReadonlyMap<number, TimelineClipRowIndex>;
+}
+
+function clipIdentity(element: TimelineElement): string {
+  return element.key ?? element.id;
+}
+
+function clipInterval(element: TimelineElement, ordinal: number): TimelineClipInterval | null {
+  if (!Number.isFinite(element.start) || !Number.isFinite(element.duration)) return null;
+  const duration = Math.max(0, element.duration);
+  return Object.freeze({
+    element,
+    identity: clipIdentity(element),
+    ordinal,
+    start: element.start,
+    end: element.start + duration,
+  });
+}
+
+/** Immutable render index for the exact display-track projection. */
+export function createTimelineClipIndex(
+  tracks: readonly (readonly [number, readonly TimelineElement[]])[],
+): TimelineClipIndex {
+  const rows = new Map<number, TimelineClipRowIndex>();
+  for (const [rowKey, elements] of tracks) {
+    const intervals = elements
+      .map(clipInterval)
+      .filter((interval): interval is TimelineClipInterval => interval !== null);
+    const byStart = Object.freeze(
+      [...intervals].sort(
+        (left, right) => left.start - right.start || left.ordinal - right.ordinal,
+      ),
+    );
+    let maxEnd = Number.NEGATIVE_INFINITY;
+    const prefixMaxEnd = Object.freeze(
+      byStart.map((interval) => {
+        maxEnd = Math.max(maxEnd, interval.end);
+        return maxEnd;
+      }),
+    );
+    const mutableByIdentity = new Map<string, TimelineClipInterval[]>();
+    for (const interval of intervals) {
+      const matches = mutableByIdentity.get(interval.identity) ?? [];
+      matches.push(interval);
+      mutableByIdentity.set(interval.identity, matches);
+    }
+    const byIdentity = new Map(
+      [...mutableByIdentity].map(([identity, matches]) => [identity, Object.freeze(matches)]),
+    );
+    rows.set(rowKey, Object.freeze({ byStart, prefixMaxEnd, byIdentity }));
+  }
+  return Object.freeze({ rows });
+}
+
+function upperBoundStart(intervals: readonly TimelineClipInterval[], end: number): number {
+  let low = 0;
+  let high = intervals.length;
+  while (low < high) {
+    const mid = Math.floor((low + high) / 2);
+    if ((intervals[mid]?.start ?? Number.POSITIVE_INFINITY) < end) low = mid + 1;
+    else high = mid;
+  }
+  return low;
+}
+
+function overlaps(interval: TimelineClipInterval, range: TimelineTimeRange): boolean {
+  if (interval.end <= interval.start)
+    return interval.start >= range.start && interval.start < range.end;
+  return interval.start < range.end && interval.end > range.start;
+}
+
+/**
+ * Query one display row. The overlap set and explicit actor pins are returned
+ * in the row's original projection order, so windowing never changes z/DOM order.
+ */
+export function queryTimelineClipIndex(
+  index: TimelineClipIndex,
+  rowKey: number,
+  range: TimelineTimeRange,
+  pinnedIdentities: ReadonlySet<string> = new Set(),
+): readonly TimelineElement[] {
+  const row = index.rows.get(rowKey);
+  if (!row) return Object.freeze([]);
+  const selected = new Set<TimelineClipInterval>();
+  if (range.end > range.start) {
+    let cursor = upperBoundStart(row.byStart, range.end) - 1;
+    while (cursor >= 0 && (row.prefixMaxEnd[cursor] ?? Number.NEGATIVE_INFINITY) >= range.start) {
+      const interval = row.byStart[cursor];
+      if (interval && overlaps(interval, range)) selected.add(interval);
+      cursor -= 1;
+    }
+  }
+  for (const identity of pinnedIdentities) {
+    for (const interval of row.byIdentity.get(identity) ?? []) selected.add(interval);
+  }
+  return Object.freeze(
+    [...selected]
+      .sort((left, right) => left.ordinal - right.ordinal)
+      .map((interval) => interval.element),
+  );
+}

From b7a9c067ca245e27616e63246cc6372bcd9481f3 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 19:36:50 +0200
Subject: [PATCH 112/125] perf(studio): virtualize timeline clip windows

---
 .../studio/src/player/components/Timeline.tsx |  86 ++++----
 .../Timeline.virtualization.test.tsx          | 154 ++++++++++++++-
 .../src/player/components/TimelineCanvas.tsx  |  14 +-
 .../src/player/components/TimelineClip.tsx    |   4 +
 .../player/components/TimelineLaneTypes.ts    |   4 +
 .../src/player/components/TimelineLanes.tsx   |  33 +++-
 .../timelineClipDragGestureLifecycle.ts       |   2 +
 .../components/useTimelineActiveClips.test.ts | 161 +++++++--------
 .../components/useTimelineActiveClips.ts      | 102 +++++-----
 .../components/useTimelineClipRenderWindow.ts |  87 +++++++++
 .../components/useTimelineRevealClip.test.tsx |  87 +++++++++
 .../components/useTimelineRevealClip.ts       | 184 +++++++++++++-----
 .../src/player/components/useTimelineTicks.ts |  17 +-
 .../hooks/useTimelinePlayer.seek.test.ts      |  61 ++++++
 .../src/player/hooks/useTimelinePlayer.ts     |   3 +
 15 files changed, 771 insertions(+), 228 deletions(-)
 create mode 100644 packages/studio/src/player/components/useTimelineClipRenderWindow.ts
 create mode 100644 packages/studio/src/player/components/useTimelineRevealClip.test.tsx

diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index ef904a1e09..52b891c940 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -6,7 +6,6 @@ import { useExpandedTimelineElements } from "../hooks/useExpandedTimelineElement
 import { defaultTimelineTheme } from "./timelineTheme";
 import { useTimelineRangeSelection } from "./useTimelineRangeSelection";
 import { useTimelinePlayhead } from "./useTimelinePlayhead";
-import { useTimelineActiveClips } from "./useTimelineActiveClips";
 import { useTimelineZoom } from "./useTimelineZoom";
 import { useTimelineAssetDrop } from "./timelineDragDrop";
 import { TimelineEmptyState } from "./TimelineEmptyState";
@@ -43,8 +42,9 @@ import { useTimelineShiftModifier } from "./useTimelineShiftModifier";
 import { useTimelineTicks } from "./useTimelineTicks";
 import { getTimelineElementIndexes } from "../lib/timelineElementIndexes";
 import { useTimelineRowVirtualization } from "./useTimelineRowVirtualization";
+import { useTimelineClipRenderWindow } from "./useTimelineClipRenderWindow";
+import { useTimelineActiveClips } from "./useTimelineActiveClips";
 
-// Re-export pure utilities so existing imports from "./Timeline" still resolve.
 export {
   generateTicks,
   formatTimelineTickLabel,
@@ -128,9 +128,8 @@ export const Timeline = memo(function Timeline({
   const selectedElementId = usePlayerStore((s) => s.selectedElementId);
   const selectedElementIds = usePlayerStore((s) => s.selectedElementIds);
   const clipRevealRequest = usePlayerStore((s) => s.clipRevealRequest);
+  const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
   const gsapAnimations = usePlayerStore((s) => s.gsapAnimations);
-  // Label mode = comp has keyframed clips (not just when expanded): keeps the layer
-  // disclosure + property column visible and reserves a GUTTER before 0s (Figma).
   const hasKeyframedClips = useMemo(
     () => hasKeyframedTimelineClips(gsapAnimations),
     [gsapAnimations],
@@ -165,7 +164,6 @@ export const Timeline = memo(function Timeline({
     containerRef.current = el;
   }, []);
 
-  // Last horizontal scroll offset, restored across the post-edit iframe reload (pinned zoom).
   const lastScrollLeftRef = useRef(0);
 
   const effectiveDuration = useMemo(
@@ -317,28 +315,46 @@ export const Timeline = memo(function Timeline({
       toggleSelectedKeyframe,
     });
 
-  const {
-    pps,
-    fitPps,
-    displayContentWidth,
-    displayDuration,
-    clipStateVersion,
-    zoomModeRef,
-    manualZoomPercentRef,
-  } = useTimelineGeometry({
-    viewportWidth: viewport.clientWidth,
-    effectiveDuration,
-    zoomMode,
-    manualZoomPercent,
-    ppsRef,
-    fitPpsRef,
-    draggedClip,
-    resizingClip,
-    expandedElements,
-    isDragging,
-    scrollRef,
-    lastScrollLeftRef,
+  const { pps, fitPps, displayContentWidth, displayDuration, zoomModeRef, manualZoomPercentRef } =
+    useTimelineGeometry({
+      viewportWidth: viewport.clientWidth,
+      effectiveDuration,
+      zoomMode,
+      manualZoomPercent,
+      ppsRef,
+      fitPpsRef,
+      draggedClip,
+      resizingClip,
+      expandedElements,
+      isDragging,
+      scrollRef,
+      lastScrollLeftRef,
+      contentOrigin,
+    });
+  const { clipIndex, renderTimeRange, pinnedClipIdentities } = useTimelineClipRenderWindow({
+    tracks,
+    viewport,
+    pixelsPerSecond: pps,
     contentOrigin,
+    duration: displayDuration,
+    selectedElementId: selectedElementId ?? undefined,
+    draggedElementId: draggedClip?.element.key ?? draggedClip?.element.id,
+    resizingElementId: resizingClip?.element.key ?? resizingClip?.element.id,
+    revealElementId: clipRevealRequest?.elementId,
+    focusedEaseElementId: focusedEaseSegment?.elementId,
+    clipContextMenuElementId: clipContextMenu?.element.key ?? clipContextMenu?.element.id,
+    keyframeContextMenuElementId: kfContextMenu?.element.key ?? kfContextMenu?.element.id,
+    scrollRef,
+    elements: expandedElements,
+    rowGeometry: displayLayout.rowGeometry,
+    allowHorizontalReveal: zoomMode === "manual",
+    sessionEpoch,
+  });
+  useTimelineActiveClips({
+    scrollRef,
+    currentTime,
+    clipStateVersion: renderTimeRange,
+    elementStateVersion: expandedElements,
   });
 
   const laneGapStrips = useTimelineGapHighlights({
@@ -373,11 +389,6 @@ export const Timeline = memo(function Timeline({
     onSeek,
     contentOrigin,
   });
-  useTimelineActiveClips({
-    scrollRef,
-    currentTime,
-    clipStateVersion,
-  });
   const { razorGuideX, updateRazorGuide, clearRazorGuide, splitAllAtPointer } =
     useTimelineRazorInteraction({
       active: activeTool === "razor",
@@ -419,8 +430,12 @@ export const Timeline = memo(function Timeline({
     setRangeSelection(null),
   );
 
-  const { major, minor } = useTimelineTicks(displayDuration, pps, timeDisplayMode);
-  const majorTickInterval = major.length >= 2 ? major[1] - major[0] : effectiveDuration;
+  const { major, minor, majorTickInterval } = useTimelineTicks(
+    displayDuration,
+    pps,
+    timeDisplayMode,
+    rowVirtualizationActive ? renderTimeRange : undefined,
+  );
 
   const getPreviewElement = useCallback(
     (element: TimelineElement): TimelineElement => getTimelinePreviewElement(element, resizingClip),
@@ -496,6 +511,9 @@ export const Timeline = memo(function Timeline({
           rowGeometry={displayLayout.rowGeometry}
           virtualRows={virtualRows}
           rowsVirtualized={rowVirtualizationActive}
+          clipIndex={clipIndex}
+          renderTimeRange={renderTimeRange}
+          pinnedClipIdentities={pinnedClipIdentities}
           trackOrder={trackOrder}
           tracks={tracks}
           trackStyles={trackStyles}
@@ -509,7 +527,7 @@ export const Timeline = memo(function Timeline({
           blockedClipRef={blockedClipRef}
           suppressClickRef={suppressClickRef}
           scrollRef={scrollRef}
-          renderClipContent={renderClipContent}
+          renderClipContent={viewport.isScrolling ? undefined : renderClipContent}
           renderClipOverlay={renderClipOverlay}
           playheadRef={playheadRef}
           onDrillDown={onDrillDown}
diff --git a/packages/studio/src/player/components/Timeline.virtualization.test.tsx b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
index cfe1ec491e..85e406bd09 100644
--- a/packages/studio/src/player/components/Timeline.virtualization.test.tsx
+++ b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
@@ -50,7 +50,78 @@ afterAll(() => {
   document.body.innerHTML = "";
 });
 
-describe("Timeline row virtualization", () => {
+/**
+ * The virtualized list only mounts rows/clips after its ResizeObserver and the
+ * follow-up layout effect have both flushed, which is more than one React tick.
+ * A fixed number of flushes is a coin flip once the rest of the suite is
+ * competing for workers, so wait for the DOM the assertions actually need.
+ */
+async function settleUntil(predicate: () => boolean, tries = 60): Promise<void> {
+  for (let attempt = 0; attempt < tries; attempt++) {
+    if (predicate()) return;
+    await act(async () => {
+      await new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));
+    });
+  }
+}
+
+// Every test here mounts 500-1000 timeline elements and settles the virtualizer,
+// which lands right on the 5s default once the rest of the suite is competing
+// for workers. The generous ceiling is a flake guard, not an expected runtime.
+describe("Timeline row virtualization", { timeout: 30_000 }, () => {
+  it("defers rich clip content while scrolling without replacing the clip shell", async () => {
+    const [{ Timeline }, { usePlayerStore }] = await Promise.all([
+      import("./Timeline"),
+      import("../store/playerStore"),
+    ]);
+    usePlayerStore.setState({
+      duration: 60,
+      timelineReady: true,
+      selectedElementId: "clip-0",
+      elements: [{ id: "clip-0", label: "Clip 0", tag: "div", start: 0, duration: 10, track: 0 }],
+    });
+
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    try {
+      await act(async () =>
+        root.render(
+          React.createElement(Timeline, {
+            renderClipContent: () => React.createElement("span", { "data-rich-content": true }),
+          }),
+        ),
+      );
+      await act(async () => {});
+      await act(async () => {
+        await new Promise((resolve) => setTimeout(resolve, 110));
+      });
+
+      const scroller = host.querySelector<HTMLElement>("[data-timeline-scroll-viewport]");
+      const clip = host.querySelector<HTMLElement>('[data-el-id="clip-0"]');
+      expect(scroller).not.toBeNull();
+      expect(clip).not.toBeNull();
+      expect(clip?.title).toBe("Clip 0 • 0.0s – 10.0s");
+      expect(host.querySelector("[data-rich-content]")).not.toBeNull();
+
+      await act(async () => {
+        scroller?.dispatchEvent(new Event("scroll"));
+        await new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));
+      });
+      expect(host.querySelector('[data-el-id="clip-0"]')).toBe(clip);
+      expect(host.querySelector("[data-rich-content]")).toBeNull();
+
+      await act(async () => {
+        await new Promise((resolve) => setTimeout(resolve, 110));
+      });
+      expect(host.querySelector('[data-el-id="clip-0"]')).toBe(clip);
+      expect(host.querySelector("[data-rich-content]")).not.toBeNull();
+    } finally {
+      act(() => root.unmount());
+      usePlayerStore.getState().reset();
+    }
+  });
+
   it("mounts a bounded list range over the full geometry height", async () => {
     const [{ Timeline }, { usePlayerStore }, { getTimelineCanvasHeight, TRACK_H }] =
       await Promise.all([
@@ -61,6 +132,8 @@ describe("Timeline row virtualization", () => {
     usePlayerStore.setState({
       duration: 60,
       timelineReady: true,
+      // Repeated fixture shape intentionally contrasts row and clip windowing scales.
+      // fallow-ignore-next-line code-duplication
       elements: Array.from({ length: 1_000 }, (_, track) => ({
         id: `clip-${track}`,
         tag: "div",
@@ -76,6 +149,11 @@ describe("Timeline row virtualization", () => {
     await act(async () => root.render(React.createElement(Timeline, { sessionEpoch: 3 })));
     await act(async () => {});
 
+    await settleUntil(
+      () =>
+        (host.querySelector('[role="list"]')?.querySelectorAll('[role="listitem"]').length ?? 0) >
+        0,
+    );
     const list = host.querySelector<HTMLElement>('[role="list"]');
     const rows = list?.querySelectorAll('[role="listitem"]') ?? [];
     expect(rows.length).toBeGreaterThan(0);
@@ -103,5 +181,77 @@ describe("Timeline row virtualization", () => {
 
     act(() => root.unmount());
     usePlayerStore.getState().reset();
-  }, 10_000);
+  });
+
+  it("windows clips and ruler cells while retaining an off-window selected clip", async () => {
+    const [{ Timeline }, { usePlayerStore }, { TIMELINE_VIEWPORT_BUDGETS }] = await Promise.all([
+      import("./Timeline"),
+      import("../store/playerStore"),
+      import("../lib/timelineViewportBudgets"),
+    ]);
+    usePlayerStore.setState({
+      duration: 1_000,
+      timelineReady: true,
+      zoomMode: "manual",
+      manualZoomPercent: 2_000,
+      selectedElementId: "clip-490",
+      selectedElementIds: new Set(["clip-490"]),
+      // Repeated fixture shape intentionally contrasts row and clip windowing scales.
+      // fallow-ignore-next-line code-duplication
+      elements: Array.from({ length: 500 }, (_, index) => ({
+        id: `clip-${index}`,
+        tag: "div",
+        start: index * 2,
+        duration: 1,
+        track: 0,
+      })),
+    });
+
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    await act(async () => root.render(React.createElement(Timeline, { sessionEpoch: 4 })));
+    await act(async () => {});
+
+    await settleUntil(() => host.querySelectorAll("[data-clip]").length > 1);
+    const initialClips = [...host.querySelectorAll<HTMLElement>("[data-clip]")];
+    const initialGridCells = host.querySelectorAll("[data-timeline-grid-cell]");
+    expect(initialClips.length).toBeGreaterThan(1);
+    expect(initialClips.length).toBeLessThanOrEqual(
+      TIMELINE_VIEWPORT_BUDGETS.maxMountedClipRootsPerRow + 1,
+    );
+    expect(initialGridCells.length).toBeLessThan(100);
+    expect(host.querySelector('[data-el-id="clip-490"]')).not.toBeNull();
+    const initialWindowIds = initialClips.map((clip) => clip.dataset.elId);
+
+    const scroller = host.querySelector<HTMLElement>("[data-timeline-scroll-viewport]");
+    expect(scroller).not.toBeNull();
+    if (scroller) {
+      scroller.scrollLeft = 8_000;
+      await act(async () => {
+        scroller.dispatchEvent(new Event("scroll"));
+        await new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));
+      });
+    }
+
+    const scrolledClips = [...host.querySelectorAll<HTMLElement>("[data-clip]")];
+    expect(scrolledClips.map((clip) => clip.dataset.elId)).not.toEqual(initialWindowIds);
+    expect(scrolledClips.length).toBeLessThanOrEqual(
+      TIMELINE_VIEWPORT_BUDGETS.maxMountedClipRootsPerRow + 1,
+    );
+    expect(host.querySelector('[data-el-id="clip-490"]')).not.toBeNull();
+    expect(host.querySelectorAll("[data-timeline-grid-cell]").length).toBeLessThan(100);
+
+    await act(async () => usePlayerStore.getState().requestClipReveal("clip-300"));
+    await act(async () => {
+      await new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));
+    });
+    await act(async () => {});
+    expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
+    expect(document.activeElement?.getAttribute("data-el-id")).toBe("clip-300");
+    expect(host.querySelector('[data-el-id="clip-490"]')).not.toBeNull();
+
+    act(() => root.unmount());
+    usePlayerStore.getState().reset();
+  });
 });
diff --git a/packages/studio/src/player/components/TimelineCanvas.tsx b/packages/studio/src/player/components/TimelineCanvas.tsx
index 90451194fe..89b66a2fb9 100644
--- a/packages/studio/src/player/components/TimelineCanvas.tsx
+++ b/packages/studio/src/player/components/TimelineCanvas.tsx
@@ -23,8 +23,8 @@ import { TimelineClip } from "./TimelineClip";
 import { TimelineLanes } from "./TimelineLanes";
 import type { TimelineLaneBaseProps } from "./TimelineLaneTypes";
 import { renderClipChildren } from "./timelineClipChildren";
-import { useTimelineRevealClip } from "./useTimelineRevealClip";
 import type { TimelineLaneGapStrips } from "./useTimelineGapHighlights";
+import { isTimelineClipActive } from "./useTimelineActiveClips";
 
 interface TimelineCanvasProps extends TimelineLaneBaseProps {
   major: number[];
@@ -62,8 +62,6 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
     onRazorSplitAll,
   } = useTimelineEditContextOptional();
   const beatDragging = usePlayerStore((s) => s.beatDragging);
-  // Scroll a clip into view when the sidebar (asset card) requests a reveal.
-  useTimelineRevealClip(scrollRef);
   const draggedElement = draggedClip?.element ?? null;
   const activeDraggedElement =
     draggedClip?.started === true && draggedElement
@@ -126,6 +124,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
         theme={props.theme}
         beatAnalysis={props.beatAnalysis}
         contentOrigin={props.contentOrigin}
+        renderTimeRange={props.rowsVirtualized ? props.renderTimeRange : undefined}
       />
 
       {/* Breathing room between the sticky ruler and the first track lane — the
@@ -157,7 +156,13 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
         const rowIndex = displayTrackOrder.indexOf(strip.track);
         if (rowIndex < 0) return null;
         const loud = strip.kind === "hover";
-        return strip.intervals.map((gap) => (
+        const visibleIntervals = props.rowsVirtualized
+          ? strip.intervals.filter(
+              (gap) =>
+                gap.start < props.renderTimeRange.end && gap.end > props.renderTimeRange.start,
+            )
+          : strip.intervals;
+        return visibleIntervals.map((gap) => (
           <div
             key={`gap-${strip.kind}-${strip.track}-${gap.start}`}
             className="pointer-events-none absolute"
@@ -249,6 +254,7 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
             }
             isHovered={false}
             isDragging={true}
+            isActive={isTimelineClipActive(activeDraggedElement, props.currentTime)}
             hasCustomContent={!!props.renderClipContent}
             capabilities={getTimelineEditCapabilities(activeDraggedElement)}
             theme={props.theme}
diff --git a/packages/studio/src/player/components/TimelineClip.tsx b/packages/studio/src/player/components/TimelineClip.tsx
index 8ba1a24d1f..e471a2f1a9 100644
--- a/packages/studio/src/player/components/TimelineClip.tsx
+++ b/packages/studio/src/player/components/TimelineClip.tsx
@@ -12,6 +12,7 @@ interface TimelineClipProps {
   isSelected: boolean;
   isHovered: boolean;
   isDragging?: boolean;
+  isActive?: boolean;
   hasCustomContent: boolean;
   capabilities: TimelineEditCapabilities;
   theme?: TimelineTheme;
@@ -35,6 +36,7 @@ export const TimelineClip = memo(function TimelineClip({
   isSelected,
   isHovered,
   isDragging = false,
+  isActive = false,
   hasCustomContent,
   capabilities,
   theme = defaultTimelineTheme,
@@ -88,6 +90,8 @@ export const TimelineClip = memo(function TimelineClip({
       data-clip-start={el.start}
       data-clip-end={el.start + el.duration}
       data-clip-hidden={el.hidden ? "true" : undefined}
+      data-active={isActive ? "" : undefined}
+      tabIndex={-1}
       className={clipClassName}
       style={style}
       title={
diff --git a/packages/studio/src/player/components/TimelineLaneTypes.ts b/packages/studio/src/player/components/TimelineLaneTypes.ts
index a910c11634..41a6b6e5f6 100644
--- a/packages/studio/src/player/components/TimelineLaneTypes.ts
+++ b/packages/studio/src/player/components/TimelineLaneTypes.ts
@@ -6,6 +6,7 @@ import type { TimelineTheme } from "./timelineTheme";
 import type { BlockedClipState, DraggedClipState, ResizingClipState } from "./useTimelineClipDrag";
 import type { TrackVisualStyle } from "./timelineIcons";
 import type { KeyframeCacheEntry, TimelineElement } from "../store/playerStore";
+import type { TimelineClipIndex, TimelineTimeRange } from "../lib/timelineClipIndex";
 import type { TimelineRowGeometry } from "./timelineLayout";
 import type { TimelineVirtualRow } from "./useTimelineVirtualRows";
 
@@ -26,6 +27,9 @@ export interface TimelineLaneBaseProps {
   rowGeometry: TimelineRowGeometry;
   virtualRows: readonly TimelineVirtualRow[];
   rowsVirtualized: boolean;
+  clipIndex: TimelineClipIndex;
+  renderTimeRange: TimelineTimeRange;
+  pinnedClipIdentities: ReadonlySet<string>;
   trackOrder: number[];
   tracks: [number, TimelineElement[]][];
   trackStyles: Map<number, TrackVisualStyle>;
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index dc5185a120..0f24760c4c 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -20,6 +20,8 @@ import { isAudioTimelineElement, isMusicTrack } from "../../utils/timelineInspec
 import { renderClipChildren } from "./timelineClipChildren";
 import type { TimelineLaneBaseProps } from "./TimelineLaneTypes";
 import { TimelineTrackRow } from "./TimelineTrackRow";
+import { isTimelineClipActive } from "./useTimelineActiveClips";
+import { queryTimelineClipIndex } from "../lib/timelineClipIndex";
 
 interface TimelineLanesProps extends TimelineLaneBaseProps {
   /** Live-derived by TimelineCanvas from {@link TimelineLaneBaseProps.draggedClip}. */
@@ -43,6 +45,9 @@ export function TimelineLanes({
   rowGeometry,
   virtualRows,
   rowsVirtualized,
+  clipIndex,
+  renderTimeRange,
+  pinnedClipIdentities,
   trackOrder,
   tracks,
   trackStyles,
@@ -110,6 +115,29 @@ export function TimelineLanes({
           if (trackNum === undefined) return null;
           const rowHeight = rowGeometry.getRowHeight(row);
           const els = tracks.find(([t]) => t === trackNum)?.[1] ?? [];
+          const indexedRenderElements = rowsVirtualized
+            ? queryTimelineClipIndex(clipIndex, trackNum, renderTimeRange, pinnedClipIdentities)
+            : els;
+          const indexedRenderSet = new Set(indexedRenderElements);
+          const renderElements = rowsVirtualized
+            ? els.filter((element) => {
+                if (indexedRenderSet.has(element)) return true;
+                if (
+                  !multiDragPreview ||
+                  !isMultiDragPassenger(element.key ?? element.id, multiDragPreview)
+                ) {
+                  return false;
+                }
+                const previewStart =
+                  element.start +
+                  multiDragPassengerOffsetPx(element.key ?? element.id, pps, multiDragPreview) /
+                    pps;
+                const previewEnd = previewStart + Math.max(0, element.duration);
+                return previewEnd <= previewStart
+                  ? previewStart >= renderTimeRange.start && previewStart < renderTimeRange.end
+                  : previewStart < renderTimeRange.end && previewEnd > renderTimeRange.start;
+              })
+            : els;
           const ts = trackStyles.get(trackNum) ?? getTrackStyle("");
           const isPendingTrack =
             draggedClip?.started === true && !trackOrder.includes(trackNum) && els.length === 0;
@@ -198,6 +226,7 @@ export function TimelineLanes({
                       ? draggedClip.snapTime
                       : null
                   }
+                  renderTimeRange={rowsVirtualized ? renderTimeRange : undefined}
                 />
                 {/* Beat dots on the active track (the one holding the selection),
                     falling back to the music track when nothing is selected. */}
@@ -206,6 +235,7 @@ export function TimelineLanes({
                     beatTimes={beatAnalysis?.beatTimes}
                     beatStrengths={beatAnalysis?.beatStrengths}
                     pps={pps}
+                    renderTimeRange={rowsVirtualized ? renderTimeRange : undefined}
                   />
                 )}
                 {isPendingTrack && (
@@ -225,7 +255,7 @@ export function TimelineLanes({
                 )}
                 {
                   // fallow-ignore-next-line complexity
-                  els.map((el) => {
+                  renderElements.map((el) => {
                     const clipStyle = getTrackStyle(el.tag);
                     const elementKey = el.key ?? el.id;
                     // Only the track's active keyframe clip shows expanded lanes;
@@ -272,6 +302,7 @@ export function TimelineLanes({
                         isSelected={isSelected}
                         isHovered={hoveredClip === clipKey}
                         isDragging={false}
+                        isActive={isTimelineClipActive(previewElement, currentTime)}
                         hasCustomContent={!!renderClipContent}
                         capabilities={capabilities}
                         theme={theme}
diff --git a/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts b/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts
index f9432dd1d2..c9fc2b42b0 100644
--- a/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts
+++ b/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts
@@ -53,6 +53,8 @@ interface TimelineClipDragGestureLifecycleInput {
 }
 
 export function mountTimelineClipDragGestureLifecycle({
+  // The explicit destructuring mirrors the single call site's dependency object by design.
+  // fallow-ignore-next-line code-duplication
   draggedClipRef,
   resizingClipRef,
   blockedClipRef,
diff --git a/packages/studio/src/player/components/useTimelineActiveClips.test.ts b/packages/studio/src/player/components/useTimelineActiveClips.test.ts
index a7ab44e5ea..af1fe4adaf 100644
--- a/packages/studio/src/player/components/useTimelineActiveClips.test.ts
+++ b/packages/studio/src/player/components/useTimelineActiveClips.test.ts
@@ -1,113 +1,116 @@
 // @vitest-environment happy-dom
 
+import React, { act, useRef } from "react";
+import { createRoot } from "react-dom/client";
 import { describe, expect, it } from "vitest";
-import { updateTimelineActiveClipClasses } from "./useTimelineActiveClips";
+import { liveTime, type TimelineElement } from "../store/playerStore";
+import {
+  isTimelineClipActive,
+  updateTimelineActiveClipClasses,
+  useTimelineActiveClips,
+} from "./useTimelineActiveClips";
 
-function appendClip(container: HTMLElement, id: string, start: string, end: string): HTMLElement {
-  const clip = document.createElement("div");
-  clip.dataset.clip = "true";
-  clip.dataset.elId = id;
-  clip.dataset.clipStart = start;
-  clip.dataset.clipEnd = end;
-  container.append(clip);
-  return clip;
-}
+Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
 
-describe("updateTimelineActiveClipClasses", () => {
-  it("toggles data-active only for clips containing the current time", () => {
-    const container = document.createElement("div");
-    const intro = appendClip(container, "intro", "0", "2");
-    const hero = appendClip(container, "hero", "2", "5");
-    const outro = appendClip(container, "outro", "5", "8");
-    const previous = new Set<string>();
+function clip(id: string, start: number, duration: number, hidden = false): TimelineElement {
+  return { id, tag: "div", start, duration, track: 1, hidden };
+}
 
-    updateTimelineActiveClipClasses(container, previous, 2.25);
+function appendClip(container: HTMLElement, id: string, start: string, end: string): HTMLElement {
+  const element = document.createElement("div");
+  element.dataset.clip = "true";
+  element.dataset.elId = id;
+  element.dataset.clipStart = start;
+  element.dataset.clipEnd = end;
+  container.append(element);
+  return element;
+}
 
-    expect(intro.hasAttribute("data-active")).toBe(false);
-    expect(hero.hasAttribute("data-active")).toBe(true);
-    expect(outro.hasAttribute("data-active")).toBe(false);
-    expect(previous).toEqual(new Set(["hero"]));
+function Harness({ version, heroStart = 2 }: { version: number; heroStart?: number }) {
+  const scrollRef = useRef<HTMLDivElement>(null);
+  useTimelineActiveClips({
+    scrollRef,
+    currentTime: 0,
+    clipStateVersion: 0,
+    elementStateVersion: version,
   });
+  return React.createElement(
+    "div",
+    { ref: scrollRef },
+    React.createElement("div", {
+      "data-clip": "true",
+      "data-el-id": "intro",
+      "data-clip-start": "0",
+      "data-clip-end": "1",
+    }),
+    React.createElement("div", {
+      "data-clip": "true",
+      "data-el-id": "hero",
+      "data-clip-start": String(heroStart),
+      "data-clip-end": String(heroStart + 1),
+    }),
+  );
+}
 
-  it("never marks hidden clips active inside their time window", () => {
-    const container = document.createElement("div");
-    const hidden = appendClip(container, "hidden", "0", "5");
-    const visible = appendClip(container, "visible", "0", "5");
-    hidden.dataset.clipHidden = "true";
-    const previous = new Set<string>();
-
-    updateTimelineActiveClipClasses(container, previous, 2);
-
-    expect(hidden.hasAttribute("data-active")).toBe(false);
-    expect(visible.hasAttribute("data-active")).toBe(true);
-    expect(previous).toEqual(new Set(["visible"]));
+describe("timeline active clips", () => {
+  it("uses model timing and keeps the end boundary inclusive", () => {
+    const element = clip("hero", 2, 3);
+    expect(isTimelineClipActive(element, 2)).toBe(true);
+    expect(isTimelineClipActive(element, 5)).toBe(true);
+    expect(isTimelineClipActive(element, 5.001)).toBe(false);
   });
 
-  it("diffs against the previous active set", () => {
-    const container = document.createElement("div");
-    const intro = appendClip(container, "intro", "0", "2");
-    const hero = appendClip(container, "hero", "2", "5");
-    const previous = new Set(["intro"]);
-    intro.toggleAttribute("data-active", true);
-
-    updateTimelineActiveClipClasses(container, previous, 2);
-
-    expect(intro.hasAttribute("data-active")).toBe(true);
-    expect(hero.hasAttribute("data-active")).toBe(true);
-    expect(previous).toEqual(new Set(["intro", "hero"]));
+  it("never activates hidden or invalid clips", () => {
+    expect(isTimelineClipActive(clip("hidden", 0, 5, true), 2)).toBe(false);
+    expect(isTimelineClipActive(clip("invalid", Number.NaN, 5), 2)).toBe(false);
   });
 
-  it("keeps a clip active through its inclusive end boundary", () => {
+  it("synchronizes mounted clip attributes", () => {
     const container = document.createElement("div");
     const intro = appendClip(container, "intro", "0", "2");
+    const hero = appendClip(container, "hero", "2", "5");
     const previous = new Set<string>();
 
-    updateTimelineActiveClipClasses(container, previous, 0);
-
-    expect(intro.hasAttribute("data-active")).toBe(true);
-    expect(previous).toEqual(new Set(["intro"]));
-
-    updateTimelineActiveClipClasses(container, previous, 2);
-
-    expect(intro.hasAttribute("data-active")).toBe(true);
-    expect(previous).toEqual(new Set(["intro"]));
-
-    updateTimelineActiveClipClasses(container, previous, 2.001);
+    updateTimelineActiveClipClasses(container, previous, 2.25);
 
     expect(intro.hasAttribute("data-active")).toBe(false);
-    expect(previous).toEqual(new Set());
+    expect(hero.hasAttribute("data-active")).toBe(true);
+    expect(previous).toEqual(new Set(["hero"]));
   });
 
-  it("re-applies data-active to a fresh DOM node that stayed active across a re-render", () => {
-    // A clip that moves lanes on a reorder remounts as a new element. It stays
-    // in the previous active set, so the plain diff would skip it and leave the
-    // new node without data-active. syncAll must force the attribute on.
+  it("re-applies active state when a clip remounts inside the current window", () => {
     const container = document.createElement("div");
     appendClip(container, "hero", "0", "5");
     const previous = new Set<string>();
     updateTimelineActiveClipClasses(container, previous, 2);
-    expect(previous).toEqual(new Set(["hero"]));
 
-    // Simulate a remount: replace the hero clip's DOM node (no data-active).
     container.replaceChildren();
-    const heroReborn = appendClip(container, "hero", "0", "5");
-    expect(heroReborn.hasAttribute("data-active")).toBe(false);
-
-    // Diff-only would skip it (still active → unchanged); syncAll re-applies.
+    const remounted = appendClip(container, "hero", "0", "5");
     updateTimelineActiveClipClasses(container, previous, 2, true);
-    expect(heroReborn.hasAttribute("data-active")).toBe(true);
+
+    expect(remounted.hasAttribute("data-active")).toBe(true);
   });
 
-  it("ignores clips with invalid timing data", () => {
-    const container = document.createElement("div");
-    const missingId = appendClip(container, "", "0", "2");
-    const missingTiming = appendClip(container, "bad", "", "2");
-    const previous = new Set<string>();
+  it("moves active state with live playback without changing store time", async () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    await act(async () => root.render(React.createElement(Harness, { version: 0 })));
+
+    const intro = host.querySelector<HTMLElement>('[data-el-id="intro"]');
+    const hero = host.querySelector<HTMLElement>('[data-el-id="hero"]');
+    expect(intro?.hasAttribute("data-active")).toBe(true);
+    expect(hero?.hasAttribute("data-active")).toBe(false);
+
+    act(() => liveTime.notify(2.5));
+    expect(intro?.hasAttribute("data-active")).toBe(false);
+    expect(hero?.hasAttribute("data-active")).toBe(true);
 
-    updateTimelineActiveClipClasses(container, previous, 1);
+    await act(async () => root.render(React.createElement(Harness, { version: 1, heroStart: 4 })));
+    act(() => liveTime.notify(2.5));
+    expect(host.querySelector('[data-el-id="hero"]')?.hasAttribute("data-active")).toBe(false);
 
-    expect(missingId.hasAttribute("data-active")).toBe(false);
-    expect(missingTiming.hasAttribute("data-active")).toBe(false);
-    expect(previous).toEqual(new Set());
+    await act(async () => root.unmount());
+    host.remove();
   });
 });
diff --git a/packages/studio/src/player/components/useTimelineActiveClips.ts b/packages/studio/src/player/components/useTimelineActiveClips.ts
index 071ed267e4..e0db293ce8 100644
--- a/packages/studio/src/player/components/useTimelineActiveClips.ts
+++ b/packages/studio/src/player/components/useTimelineActiveClips.ts
@@ -1,5 +1,5 @@
 import { useCallback, useLayoutEffect, useRef } from "react";
-import { liveTime } from "../store/playerStore";
+import { liveTime, type TimelineElement } from "../store/playerStore";
 import { useMountEffect } from "../../hooks/useMountEffect";
 
 interface ActiveClipRecord {
@@ -14,6 +14,33 @@ interface UseTimelineActiveClipsInput {
   scrollRef: React.RefObject<HTMLDivElement | null>;
   currentTime: number;
   clipStateVersion: unknown;
+  elementStateVersion: unknown;
+}
+
+function isTimelineIntervalActive(
+  interval: Pick<ActiveClipRecord, "start" | "end" | "hidden">,
+  time: number,
+): boolean {
+  return (
+    Number.isFinite(time) &&
+    !interval.hidden &&
+    Number.isFinite(interval.start) &&
+    Number.isFinite(interval.end) &&
+    time >= interval.start &&
+    time <= interval.end
+  );
+}
+
+/** Model-first active state. Rendered nodes receive this on their first mount. */
+export function isTimelineClipActive(element: TimelineElement, time: number): boolean {
+  return isTimelineIntervalActive(
+    {
+      start: element.start,
+      end: element.start + Math.max(0, element.duration),
+      hidden: element.hidden === true,
+    },
+    time,
+  );
 }
 
 function readFiniteNumber(value: string | undefined): number | null {
@@ -27,66 +54,37 @@ function readClipRecord(element: Element): ActiveClipRecord | null {
   const id = element.dataset.elId;
   const start = readFiniteNumber(element.dataset.clipStart);
   const end = readFiniteNumber(element.dataset.clipEnd);
-  const hidden = element.dataset.clipHidden === "true";
   if (!id || start === null || end === null) return null;
-  return { id, start, end, hidden, element };
+  return { id, start, end, hidden: element.dataset.clipHidden === "true", element };
 }
 
 function collectTimelineClipRecords(container: HTMLElement): ActiveClipRecord[] {
-  const records: ActiveClipRecord[] = [];
-  for (const element of container.querySelectorAll('[data-clip="true"]')) {
-    const record = readClipRecord(element);
-    if (record) records.push(record);
-  }
-  return records;
-}
-
-function indexClipRecordsById(records: ActiveClipRecord[]): Map<string, ActiveClipRecord> {
-  const recordsById = new Map<string, ActiveClipRecord>();
-  for (const record of records) recordsById.set(record.id, record);
-  return recordsById;
+  return [...container.querySelectorAll('[data-clip="true"]')]
+    .map(readClipRecord)
+    .filter((record): record is ActiveClipRecord => record !== null);
 }
 
 function getActiveClipIds(records: ActiveClipRecord[], time: number): Set<string> {
-  const next = new Set<string>();
-  if (!Number.isFinite(time)) return next;
-  for (const record of records) {
-    if (record.hidden) continue;
-    if (time >= record.start && time <= record.end) next.add(record.id);
-  }
-  return next;
-}
-
-function setsMatch(left: Set<string>, right: Set<string>): boolean {
-  if (left.size !== right.size) return false;
-  for (const value of left) {
-    if (!right.has(value)) return false;
-  }
-  return true;
+  return new Set(
+    records.filter((record) => isTimelineIntervalActive(record, time)).map((record) => record.id),
+  );
 }
 
 function applyActiveClipDiff(
   records: ActiveClipRecord[],
   previous: Set<string>,
   time: number,
-  // Force every record's attribute to match its active state instead of only
-  // touching clips whose active-state changed. Required whenever `records` were
-  // freshly re-queried after a render: a clip that stayed active but got a new
-  // DOM node (e.g. moved lanes on a reorder) would otherwise be skipped by the
-  // diff and render without `data-active` despite still being at the playhead.
   syncAll = false,
-) {
+): void {
   const next = getActiveClipIds(records, time);
-  const changed = !setsMatch(previous, next);
   for (const record of records) {
-    const wasActive = previous.has(record.id);
     const isActive = next.has(record.id);
-    if (!syncAll && wasActive === isActive) continue;
-    record.element.toggleAttribute("data-active", isActive);
+    if (syncAll || previous.has(record.id) !== isActive) {
+      record.element.toggleAttribute("data-active", isActive);
+    }
   }
   previous.clear();
   for (const id of next) previous.add(id);
-  return changed;
 }
 
 export function updateTimelineActiveClipClasses(
@@ -94,30 +92,28 @@ export function updateTimelineActiveClipClasses(
   previous: Set<string>,
   time: number,
   syncAll = false,
-) {
+): void {
   applyActiveClipDiff(collectTimelineClipRecords(container), previous, time, syncAll);
 }
 
+/** Keeps the currently mounted clip window synchronized with the RAF playback clock. */
 export function useTimelineActiveClips({
   scrollRef,
   currentTime,
   clipStateVersion,
-}: UseTimelineActiveClipsInput) {
+  elementStateVersion,
+}: UseTimelineActiveClipsInput): void {
   const recordsRef = useRef<ActiveClipRecord[]>([]);
-  const recordsByIdRef = useRef(new Map<string, ActiveClipRecord>());
   const previousActiveIdsRef = useRef(new Set<string>());
-
   const refreshRecords = useCallback(
     (time: number) => {
       const scroll = scrollRef.current;
       if (!scroll) {
         recordsRef.current = [];
-        recordsByIdRef.current.clear();
         previousActiveIdsRef.current.clear();
         return;
       }
       recordsRef.current = collectTimelineClipRecords(scroll);
-      recordsByIdRef.current = indexClipRecordsById(recordsRef.current);
       applyActiveClipDiff(recordsRef.current, previousActiveIdsRef.current, time, true);
     },
     [scrollRef],
@@ -125,12 +121,10 @@ export function useTimelineActiveClips({
 
   useLayoutEffect(() => {
     refreshRecords(currentTime);
-  }, [currentTime, clipStateVersion, refreshRecords]);
-
-  useMountEffect(() => {
-    const unsub = liveTime.subscribe((time) => {
+  }, [clipStateVersion, currentTime, elementStateVersion, refreshRecords]);
+  useMountEffect(() =>
+    liveTime.subscribe((time) => {
       applyActiveClipDiff(recordsRef.current, previousActiveIdsRef.current, time);
-    });
-    return unsub;
-  });
+    }),
+  );
 }
diff --git a/packages/studio/src/player/components/useTimelineClipRenderWindow.ts b/packages/studio/src/player/components/useTimelineClipRenderWindow.ts
new file mode 100644
index 0000000000..01522bd49e
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineClipRenderWindow.ts
@@ -0,0 +1,87 @@
+import { useMemo, type RefObject } from "react";
+import { createTimelineClipIndex } from "../lib/timelineClipIndex";
+import type { TimelineElement } from "../store/playerStore";
+import { getTimelineRenderTimeRange } from "./timelineViewportGeometry";
+import type { TimelineRowGeometry } from "./timelineLayout";
+import type { TimelineScrollViewportSnapshot } from "./useTimelineScrollViewport";
+import { useTimelineRevealClip } from "./useTimelineRevealClip";
+
+interface UseTimelineClipRenderWindowInput {
+  tracks: Parameters<typeof createTimelineClipIndex>[0];
+  viewport: TimelineScrollViewportSnapshot;
+  pixelsPerSecond: number;
+  contentOrigin: number;
+  duration: number;
+  selectedElementId?: string;
+  draggedElementId?: string;
+  resizingElementId?: string;
+  revealElementId?: string;
+  focusedEaseElementId?: string;
+  clipContextMenuElementId?: string;
+  keyframeContextMenuElementId?: string;
+  scrollRef: RefObject<HTMLDivElement | null>;
+  elements: readonly TimelineElement[];
+  rowGeometry: TimelineRowGeometry;
+  allowHorizontalReveal: boolean;
+  sessionEpoch: number;
+}
+
+export function useTimelineClipRenderWindow({
+  tracks,
+  viewport,
+  pixelsPerSecond,
+  contentOrigin,
+  duration,
+  selectedElementId,
+  draggedElementId,
+  resizingElementId,
+  revealElementId,
+  focusedEaseElementId,
+  clipContextMenuElementId,
+  keyframeContextMenuElementId,
+  scrollRef,
+  elements,
+  rowGeometry,
+  allowHorizontalReveal,
+  sessionEpoch,
+}: UseTimelineClipRenderWindowInput) {
+  const clipIndex = useMemo(() => createTimelineClipIndex(tracks), [tracks]);
+  const renderTimeRange = useMemo(
+    () => getTimelineRenderTimeRange(viewport, pixelsPerSecond, contentOrigin, duration),
+    [contentOrigin, duration, pixelsPerSecond, viewport],
+  );
+  const pinnedClipIdentities = useMemo(
+    () =>
+      new Set(
+        [
+          selectedElementId,
+          draggedElementId,
+          resizingElementId,
+          revealElementId,
+          focusedEaseElementId,
+          clipContextMenuElementId,
+          keyframeContextMenuElementId,
+        ].filter((identity): identity is string => identity !== undefined),
+      ),
+    [
+      clipContextMenuElementId,
+      draggedElementId,
+      focusedEaseElementId,
+      keyframeContextMenuElementId,
+      resizingElementId,
+      revealElementId,
+      selectedElementId,
+    ],
+  );
+  useTimelineRevealClip({
+    scrollRef,
+    elements,
+    rowGeometry,
+    pixelsPerSecond,
+    contentOrigin,
+    allowHorizontal: allowHorizontalReveal,
+    viewportVersion: viewport,
+    sessionEpoch,
+  });
+  return { clipIndex, renderTimeRange, pinnedClipIdentities };
+}
diff --git a/packages/studio/src/player/components/useTimelineRevealClip.test.tsx b/packages/studio/src/player/components/useTimelineRevealClip.test.tsx
new file mode 100644
index 0000000000..43b812d3be
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineRevealClip.test.tsx
@@ -0,0 +1,87 @@
+// @vitest-environment happy-dom
+
+import React, { act, useRef } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import { usePlayerStore } from "../store/playerStore";
+import { createTimelineRowGeometry } from "./timelineLayout";
+import { useTimelineRevealClip } from "./useTimelineRevealClip";
+
+Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
+
+const element: TimelineElement = {
+  id: "hero",
+  tag: "div",
+  start: 20,
+  duration: 2,
+  track: 1,
+};
+const geometry = createTimelineRowGeometry([1], [48]);
+
+function Harness({ mounted, version }: { mounted: boolean; version: number }) {
+  const scrollRef = useRef<HTMLDivElement>(null);
+  useTimelineRevealClip({
+    scrollRef,
+    elements: [element],
+    rowGeometry: geometry,
+    pixelsPerSecond: 100,
+    contentOrigin: 32,
+    allowHorizontal: true,
+    viewportVersion: version,
+    sessionEpoch: 1,
+  });
+  return (
+    <div
+      ref={(node) => {
+        scrollRef.current = node;
+        if (node) {
+          Object.defineProperty(node, "clientWidth", { configurable: true, value: 300 });
+          Object.defineProperty(node, "clientHeight", { configurable: true, value: 100 });
+        }
+      }}
+    >
+      {mounted && <div data-el-id="hero" tabIndex={-1} />}
+    </div>
+  );
+}
+
+afterEach(() => {
+  usePlayerStore.getState().reset();
+  document.body.replaceChildren();
+});
+
+describe("useTimelineRevealClip", () => {
+  it("scrolls from model coordinates, then consumes only after the clip mounts", async () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    usePlayerStore.getState().requestClipReveal("hero");
+
+    await act(async () => root.render(<Harness mounted={false} version={0} />));
+    const scroll = host.firstElementChild as HTMLDivElement;
+    expect(scroll.scrollLeft).toBe(1_944);
+    expect(usePlayerStore.getState().clipRevealRequest?.elementId).toBe("hero");
+
+    await act(async () => root.render(<Harness mounted version={1} />));
+    expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
+    expect(document.activeElement?.getAttribute("data-el-id")).toBe("hero");
+
+    scroll.scrollLeft = 0;
+    await act(async () => usePlayerStore.getState().requestClipReveal("hero"));
+    await act(async () => root.render(<Harness mounted version={2} />));
+    expect(scroll.scrollLeft).toBe(1_944);
+    expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
+    await act(async () => root.unmount());
+  });
+
+  it("consumes an invalid target without scrolling", async () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    usePlayerStore.getState().requestClipReveal("missing");
+    await act(async () => root.render(<Harness mounted={false} version={0} />));
+    expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
+    await act(async () => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useTimelineRevealClip.ts b/packages/studio/src/player/components/useTimelineRevealClip.ts
index 1c67654b24..b507c15047 100644
--- a/packages/studio/src/player/components/useTimelineRevealClip.ts
+++ b/packages/studio/src/player/components/useTimelineRevealClip.ts
@@ -1,56 +1,144 @@
-/**
- * Consumes playerStore.clipRevealRequest: when another surface (the sidebar
- * asset card / audio row) asks for a clip to be revealed, smooth-scroll the
- * timeline's scroll container so that clip is visible — horizontally to its
- * time and vertically to its lane.
- *
- * The request is consumed (cleared) whether or not the clip node is found, so
- * a stale request can never replay a scroll later. Respects zoom mode: in
- * "fit" the timeline disables horizontal scrolling (overflow-x-hidden), so
- * only the vertical axis is scrolled there.
- */
-import { useEffect } from "react";
+import { useEffect, useRef } from "react";
+import type { TimelineElement } from "../store/playerStore";
 import { usePlayerStore } from "../store/playerStore";
-import { GUTTER, RULER_H } from "./timelineLayout";
+import { CLIP_Y, RULER_H, type TimelineRowGeometry } from "./timelineLayout";
 import { computeRevealScroll } from "./timelineRevealScroll";
 
-export function useTimelineRevealClip(scrollRef: React.RefObject<HTMLDivElement | null>): void {
-  const revealRequest = usePlayerStore((s) => s.clipRevealRequest);
+interface UseTimelineRevealClipInput {
+  scrollRef: React.RefObject<HTMLDivElement | null>;
+  elements: readonly TimelineElement[];
+  rowGeometry: TimelineRowGeometry;
+  pixelsPerSecond: number;
+  contentOrigin: number;
+  allowHorizontal: boolean;
+  viewportVersion: unknown;
+  sessionEpoch: number;
+}
 
-  useEffect(() => {
-    if (!revealRequest) return;
-    // Consume the request first — reveal is one-shot, even when the clip node
-    // isn't currently rendered (e.g. drilled into a different composition).
-    usePlayerStore.getState().clearClipRevealRequest();
+function escapeSelectorValue(value: string): string {
+  return typeof CSS !== "undefined" && typeof CSS.escape === "function"
+    ? CSS.escape(value)
+    : value.replace(/["\\]/g, "\\$&");
+}
+
+function scrollToTimelineElement(
+  container: HTMLDivElement,
+  element: TimelineElement,
+  row: number,
+  rowGeometry: TimelineRowGeometry,
+  pixelsPerSecond: number,
+  contentOrigin: number,
+  allowHorizontal: boolean,
+): void {
+  const clipLeft = contentOrigin + element.start * pixelsPerSecond;
+  const target = computeRevealScroll({
+    scrollLeft: container.scrollLeft,
+    scrollTop: container.scrollTop,
+    viewportWidth: container.clientWidth,
+    viewportHeight: container.clientHeight,
+    clipLeft,
+    clipRight: clipLeft + Math.max(element.duration * pixelsPerSecond, 4),
+    clipTop: rowGeometry.getRowTop(row) + CLIP_Y,
+    clipBottom: rowGeometry.getRowTop(row) + rowGeometry.getRowHeight(row) - CLIP_Y,
+    stickyLeft: contentOrigin,
+    stickyTop: RULER_H,
+    allowHorizontal,
+  });
+  if (target.left !== null) container.scrollLeft = target.left;
+  if (target.top !== null) container.scrollTop = target.top;
+  if (target.left !== null || target.top !== null) container.dispatchEvent(new Event("scroll"));
+}
+
+function focusRevealedElement(container: HTMLDivElement, elementId: string): boolean {
+  const clip = container.querySelector(`[data-el-id="${escapeSelectorValue(elementId)}"]`);
+  if (!(clip instanceof HTMLElement)) return false;
+  clip.setAttribute("data-reveal-highlight", "true");
+  clip.focus({ preventScroll: true });
+  if (document.activeElement !== clip) {
+    clip.removeAttribute("data-reveal-highlight");
+    return false;
+  }
+  clip.addEventListener("blur", () => clip.removeAttribute("data-reveal-highlight"), {
+    once: true,
+  });
+  return true;
+}
 
+function resolveRevealTarget(
+  elements: readonly TimelineElement[],
+  rowGeometry: TimelineRowGeometry,
+  elementId: string,
+): { element: TimelineElement; row: number } | null {
+  const element = elements.find((candidate) => (candidate.key ?? candidate.id) === elementId);
+  if (!element) return null;
+  const row = rowGeometry.getRowIndex(element.track);
+  return row < 0 ? null : { element, row };
+}
+
+function shouldScrollReveal(
+  previous: { request: { elementId: string; nonce: number }; sessionEpoch: number } | null,
+  request: { elementId: string; nonce: number },
+  sessionEpoch: number,
+): boolean {
+  return previous?.request !== request || previous.sessionEpoch !== sessionEpoch;
+}
+
+/** Coordinate-first reveal; the request remains pinned until its clip mounts. */
+export function useTimelineRevealClip({
+  scrollRef,
+  elements,
+  rowGeometry,
+  pixelsPerSecond,
+  contentOrigin,
+  allowHorizontal,
+  viewportVersion,
+  sessionEpoch,
+}: UseTimelineRevealClipInput): void {
+  const revealRequest = usePlayerStore((state) => state.clipRevealRequest);
+  const scrolledRequestRef = useRef<{
+    request: { elementId: string; nonce: number };
+    sessionEpoch: number;
+  } | null>(null);
+
+  useEffect(() => {
+    if (!revealRequest) {
+      scrolledRequestRef.current = null;
+      return;
+    }
+    const target = resolveRevealTarget(elements, rowGeometry, revealRequest.elementId);
+    if (!target) {
+      usePlayerStore.getState().clearClipRevealRequest();
+      return;
+    }
     const container = scrollRef.current;
     if (!container) return;
-    const clip = container.querySelector(`[data-el-id="${CSS.escape(revealRequest.elementId)}"]`);
-    if (!(clip instanceof HTMLElement)) return;
-
-    const containerRect = container.getBoundingClientRect();
-    const clipRect = clip.getBoundingClientRect();
-    const clipLeft = clipRect.left - containerRect.left + container.scrollLeft;
-    const clipTop = clipRect.top - containerRect.top + container.scrollTop;
-
-    const target = computeRevealScroll({
-      scrollLeft: container.scrollLeft,
-      scrollTop: container.scrollTop,
-      viewportWidth: container.clientWidth,
-      viewportHeight: container.clientHeight,
-      clipLeft,
-      clipRight: clipLeft + clipRect.width,
-      clipTop,
-      clipBottom: clipTop + clipRect.height,
-      stickyLeft: GUTTER,
-      stickyTop: RULER_H,
-      allowHorizontal: usePlayerStore.getState().zoomMode === "manual",
-    });
-    if (target.left === null && target.top === null) return;
-    container.scrollTo({
-      left: target.left ?? container.scrollLeft,
-      top: target.top ?? container.scrollTop,
-      behavior: "smooth",
-    });
-  }, [revealRequest, scrollRef]);
+
+    if (shouldScrollReveal(scrolledRequestRef.current, revealRequest, sessionEpoch)) {
+      scrolledRequestRef.current = { request: revealRequest, sessionEpoch };
+      scrollToTimelineElement(
+        container,
+        target.element,
+        target.row,
+        rowGeometry,
+        pixelsPerSecond,
+        contentOrigin,
+        allowHorizontal,
+      );
+    }
+
+    if (!focusRevealedElement(container, revealRequest.elementId)) return;
+    if (usePlayerStore.getState().clipRevealRequest === revealRequest) {
+      usePlayerStore.getState().clearClipRevealRequest();
+    }
+  }, [
+    allowHorizontal,
+    contentOrigin,
+    elements,
+    pixelsPerSecond,
+    revealRequest,
+    rowGeometry,
+    scrollRef,
+    sessionEpoch,
+    viewportVersion,
+  ]);
 }
diff --git a/packages/studio/src/player/components/useTimelineTicks.ts b/packages/studio/src/player/components/useTimelineTicks.ts
index 86c1caad56..412a05384c 100644
--- a/packages/studio/src/player/components/useTimelineTicks.ts
+++ b/packages/studio/src/player/components/useTimelineTicks.ts
@@ -1,16 +1,21 @@
 import { useMemo } from "react";
 import { STUDIO_PREVIEW_FPS } from "../lib/time";
-import { generateTicks } from "./timelineLayout";
+import { generateTicks, getTimelineMajorTickInterval } from "./timelineLayout";
+import type { TimelineTimeRange } from "../lib/timelineClipIndex";
 
 export function useTimelineTicks(
   duration: number,
   pixelsPerSecond: number,
   timeDisplayMode: "time" | "frame",
-): { major: number[]; minor: number[] } {
+  renderTimeRange?: TimelineTimeRange,
+) {
   const frameRate = timeDisplayMode === "frame" ? STUDIO_PREVIEW_FPS : undefined;
-  const { major, minor } = useMemo(
-    () => generateTicks(duration, pixelsPerSecond, frameRate),
-    [duration, frameRate, pixelsPerSecond],
+  const ticks = useMemo(
+    () => generateTicks(duration, pixelsPerSecond, frameRate, renderTimeRange),
+    [duration, frameRate, pixelsPerSecond, renderTimeRange],
   );
-  return { major, minor };
+  return {
+    ...ticks,
+    majorTickInterval: getTimelineMajorTickInterval(duration, pixelsPerSecond, frameRate),
+  };
 }
diff --git a/packages/studio/src/player/hooks/useTimelinePlayer.seek.test.ts b/packages/studio/src/player/hooks/useTimelinePlayer.seek.test.ts
index cdafb4596b..c23d9086cd 100644
--- a/packages/studio/src/player/hooks/useTimelinePlayer.seek.test.ts
+++ b/packages/studio/src/player/hooks/useTimelinePlayer.seek.test.ts
@@ -5,6 +5,7 @@ import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { useTimelinePlayer } from "./useTimelinePlayer";
 import { liveTime, usePlayerStore } from "../store/playerStore";
+import { setTimelinePerformanceFixtureLease } from "../lib/timelinePerformanceFixture";
 
 globalThis.IS_REACT_ACT_ENVIRONMENT = true;
 
@@ -40,6 +41,7 @@ function renderTimelinePlayerHarness() {
 }
 
 afterEach(() => {
+  setTimelinePerformanceFixtureLease(false);
   document.body.innerHTML = "";
   resetPlayerStore();
 });
@@ -73,6 +75,8 @@ function attachIframeAdapter(
     value: {
       __player: adapter,
       __timelines: options.timelines,
+      // Shared iframe contract is repeated here to keep this helper's adapter state local.
+      // fallow-ignore-next-line code-duplication
       postMessage: options.postMessage ?? (() => {}),
       scrollTo: () => {},
       addEventListener: () => {},
@@ -129,6 +133,61 @@ function expectStorePlaybackState(
 }
 
 describe("useTimelinePlayer seek hydration", () => {
+  it("ignores runtime timeline work while the performance fixture lease is active", () => {
+    const { api, root } = renderTimelinePlayerHarness();
+    attachIframeAdapter(api);
+    const iframeWindow = api.iframeRef.current?.contentWindow;
+    const iframeDocument = api.iframeRef.current?.contentDocument;
+    if (!iframeWindow || !iframeDocument) throw new Error("iframe did not attach");
+    const querySelector = vi.spyOn(iframeDocument, "querySelector");
+    const clips = [
+      {
+        id: "runtime-clip",
+        label: "Runtime clip",
+        start: 0,
+        duration: 1,
+        track: 0,
+        kind: "element",
+        tagName: "div",
+        compositionId: null,
+        parentCompositionId: null,
+        compositionSrc: null,
+        assetUrl: null,
+      },
+    ];
+    const dispatchTimeline = () =>
+      window.dispatchEvent(
+        new MessageEvent("message", {
+          source: iframeWindow,
+          data: {
+            source: "hf-preview",
+            type: "timeline",
+            clips,
+            durationInFrames: 30,
+            fps: 30,
+          },
+        }),
+      );
+    try {
+      act(() => {
+        usePlayerStore.setState({ clipManifest: null });
+        setTimelinePerformanceFixtureLease(true);
+        dispatchTimeline();
+      });
+      expect(usePlayerStore.getState().clipManifest).toBeNull();
+      expect(querySelector).not.toHaveBeenCalled();
+
+      act(() => {
+        setTimelinePerformanceFixtureLease(false);
+        dispatchTimeline();
+      });
+      expect(usePlayerStore.getState().clipManifest).toEqual(clips);
+      expect(querySelector).toHaveBeenCalled();
+    } finally {
+      unmountWithAct(root);
+    }
+  });
+
   it("keeps an external seek request until the iframe adapter is ready", () => {
     const observedTimes: number[] = [];
     const unsubscribe = liveTime.subscribe((time) => {
@@ -364,6 +423,8 @@ describe("useTimelinePlayer RAF loop wrap-around", () => {
     Object.defineProperty(iframe, "contentWindow", {
       value: {
         __player: adapter,
+        // This playback-specific adapter intentionally repeats the shared iframe contract.
+        // fallow-ignore-next-line code-duplication
         postMessage: () => {},
         scrollTo: () => {},
         addEventListener: () => {},
diff --git a/packages/studio/src/player/hooks/useTimelinePlayer.ts b/packages/studio/src/player/hooks/useTimelinePlayer.ts
index 9c17d60c50..23972c1c0d 100644
--- a/packages/studio/src/player/hooks/useTimelinePlayer.ts
+++ b/packages/studio/src/player/hooks/useTimelinePlayer.ts
@@ -66,6 +66,8 @@ export function useTimelinePlayer() {
   // The fixture lease belongs at this shared synchronization boundary so every
   // iframe discovery path has the same owner for deciding whether it may write.
   const syncTimelineElements = useCallback(
+    // The lease guard adds one deliberate branch at the shared synchronization boundary.
+    // fallow-ignore-next-line complexity
     (elements: TimelineElement[], nextDuration?: number) => {
       if (hasTimelinePerformanceFixtureLease()) return;
       const state = usePlayerStore.getState();
@@ -465,6 +467,7 @@ export function useTimelinePlayer() {
     // Pre-existing message-router complexity — surfaced by line shifts, not new logic.
     // fallow-ignore-next-line complexity
     const handleMessage = (e: MessageEvent) => {
+      if (hasTimelinePerformanceFixtureLease()) return;
       const data = e.data;
       const ourIframe = iframeRef.current;
       if (e.source && ourIframe && e.source !== ourIframe.contentWindow) {

From 059dc304b83ff77e7157759e3ded1d2a9ed5b6e7 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 18 Jul 2026 20:51:04 +0200
Subject: [PATCH 113/125] perf(studio): stabilize virtualized clip gestures

---
 .../studio/src/player/components/Timeline.tsx |   7 +-
 .../src/player/components/TimelineCanvas.tsx  |  85 ++-----
 .../src/player/components/TimelineClip.tsx    |   9 +-
 .../TimelineGestureOverlay.test.tsx           |  89 +++++++
 .../components/TimelineGestureOverlay.tsx     |  96 +++++++
 .../player/components/TimelineLaneTypes.ts    |   1 -
 .../src/player/components/TimelineLanes.tsx   |   5 +-
 .../timelineClipDragGestureLifecycle.ts       | 237 ++++++++++++++----
 .../timelineClipDragPreview.test.ts           |  30 +++
 .../components/timelineClipDragPreview.ts     |  30 ++-
 .../components/timelineClipDragTypes.ts       |  12 +
 .../player/components/timelineViewModel.ts    |   8 +-
 .../useTimelineClipDrag.resize.test.tsx       | 195 ++++++++++++--
 .../player/components/useTimelineClipDrag.ts  | 183 ++++++++------
 .../components/useTimelineClipRenderWindow.ts |   8 +-
 15 files changed, 762 insertions(+), 233 deletions(-)
 create mode 100644 packages/studio/src/player/components/TimelineGestureOverlay.test.tsx
 create mode 100644 packages/studio/src/player/components/TimelineGestureOverlay.tsx

diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 52b891c940..c0c56b5ab5 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -247,7 +247,6 @@ export const Timeline = memo(function Timeline({
     setResizingClip,
     blockedClipRef,
     suppressClickRef,
-    syncClipDragAutoScroll,
   } = useTimelineClipDrag({
     scrollRef,
     ppsRef,
@@ -264,6 +263,7 @@ export const Timeline = memo(function Timeline({
     readZIndex: zSyncEnabled ? readClipZIndex : undefined,
     onStackingPatches: zSyncEnabled ? applyStackingPatches : undefined,
     refreshAfterLaneMove,
+    sessionEpoch,
   });
 
   const { isDragOver, handleAssetDragOver, handleAssetDrop, clearDropPreview } =
@@ -339,7 +339,9 @@ export const Timeline = memo(function Timeline({
     duration: displayDuration,
     selectedElementId: selectedElementId ?? undefined,
     draggedElementId: draggedClip?.element.key ?? draggedClip?.element.id,
-    resizingElementId: resizingClip?.element.key ?? resizingClip?.element.id,
+    resizingElementIds:
+      resizingClip?.groupPreview?.map((change) => change.key) ??
+      (resizingClip ? [resizingClip.element.key ?? resizingClip.element.id] : undefined),
     revealElementId: clipRevealRequest?.elementId,
     focusedEaseElementId: focusedEaseSegment?.elementId,
     clipContextMenuElementId: clipContextMenu?.element.key ?? clipContextMenu?.element.id,
@@ -538,7 +540,6 @@ export const Timeline = memo(function Timeline({
           setResizingClip={setResizingClip}
           setDraggedClip={setDraggedClip}
           setSelectedElementId={setSelectedElementId}
-          syncClipDragAutoScroll={syncClipDragAutoScroll}
           shiftClickClipRef={shiftClickClipRef}
           getPreviewElement={getPreviewElement}
           getTrackStyle={getTrackStyle}
diff --git a/packages/studio/src/player/components/TimelineCanvas.tsx b/packages/studio/src/player/components/TimelineCanvas.tsx
index 89b66a2fb9..3402ab3acb 100644
--- a/packages/studio/src/player/components/TimelineCanvas.tsx
+++ b/packages/studio/src/player/components/TimelineCanvas.tsx
@@ -1,8 +1,7 @@
 import { memo } from "react";
 import { TimelineRuler } from "./TimelineRuler";
 import { PlayheadIndicator } from "./PlayheadIndicator";
-import { getTimelineEditCapabilities, type TimelineRangeSelection } from "./timelineEditing";
-import { getRenderedTimelineElement } from "./timelineTheme";
+import type { TimelineRangeSelection } from "./timelineEditing";
 import {
   RULER_H,
   CLIP_Y,
@@ -19,12 +18,10 @@ import type { ResizingClipState } from "./useTimelineClipDrag";
 import { type MultiDragPreviewInput } from "./timelineMultiDragPreview";
 import { useTimelineEditContextOptional } from "../../contexts/TimelineEditContext";
 import type { Rect } from "../../utils/marqueeGeometry";
-import { TimelineClip } from "./TimelineClip";
 import { TimelineLanes } from "./TimelineLanes";
 import type { TimelineLaneBaseProps } from "./TimelineLaneTypes";
-import { renderClipChildren } from "./timelineClipChildren";
 import type { TimelineLaneGapStrips } from "./useTimelineGapHighlights";
-import { isTimelineClipActive } from "./useTimelineActiveClips";
+import { TimelineGestureOverlay } from "./TimelineGestureOverlay";
 
 interface TimelineCanvasProps extends TimelineLaneBaseProps {
   major: number[];
@@ -63,15 +60,6 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
   } = useTimelineEditContextOptional();
   const beatDragging = usePlayerStore((s) => s.beatDragging);
   const draggedElement = draggedClip?.element ?? null;
-  const activeDraggedElement =
-    draggedClip?.started === true && draggedElement
-      ? getRenderedTimelineElement({
-          element: draggedElement,
-          draggedElementId: draggedElement.key ?? draggedElement.id,
-          previewStart: draggedClip.previewStart,
-          previewTrack: draggedClip.previewTrack,
-        })
-      : null;
   // The drag ghost follows the cursor freely (both axes) — CapCut-style. The
   // "magnetic" affordance is a highlight on the destination lane (draggedRowIndex),
   // which flips at the MAGNETIC_TRACK_THRESHOLD point; the clip drops into it.
@@ -92,22 +80,6 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
           selectedKeys: selectedElementIds,
         }
       : null;
-  const activeDraggedPosition =
-    draggedClip?.started === true && activeDraggedElement && scrollRef.current
-      ? {
-          left:
-            draggedClip.pointerClientX -
-            scrollRef.current.getBoundingClientRect().left +
-            scrollRef.current.scrollLeft -
-            draggedClip.pointerOffsetX,
-          top:
-            draggedClip.pointerClientY -
-            scrollRef.current.getBoundingClientRect().top +
-            scrollRef.current.scrollTop -
-            draggedClip.pointerOffsetY,
-        }
-      : null;
-
   return (
     <div
       className="relative"
@@ -233,47 +205,18 @@ export const TimelineCanvas = memo(function TimelineCanvas(props: TimelineCanvas
         />
       )}
 
-      {/* Drag ghost */}
-      {activeDraggedElement && activeDraggedPosition && (
-        <div
-          className="absolute pointer-events-none"
-          style={{
-            top: activeDraggedPosition.top,
-            left: activeDraggedPosition.left,
-            width: Math.max(activeDraggedElement.duration * props.pps, 4),
-            height: draggedClipHeight,
-            zIndex: 40,
-          }}
-        >
-          <TimelineClip
-            el={{ ...activeDraggedElement, start: 0 }}
-            pps={props.pps}
-            clipY={0}
-            isSelected={
-              props.selectedElementId === (activeDraggedElement.key ?? activeDraggedElement.id)
-            }
-            isHovered={false}
-            isDragging={true}
-            isActive={isTimelineClipActive(activeDraggedElement, props.currentTime)}
-            hasCustomContent={!!props.renderClipContent}
-            capabilities={getTimelineEditCapabilities(activeDraggedElement)}
-            theme={props.theme}
-            isComposition={!!activeDraggedElement.compositionSrc}
-            onHoverStart={() => {}}
-            onHoverEnd={() => {}}
-            onResizeStart={() => {}}
-            onClick={() => {}}
-            onDoubleClick={() => {}}
-          >
-            {renderClipChildren(
-              activeDraggedElement,
-              props.getTrackStyle(activeDraggedElement.tag),
-              props.renderClipContent,
-              props.renderClipOverlay,
-            )}
-          </TimelineClip>
-        </div>
-      )}
+      <TimelineGestureOverlay
+        drag={draggedClip}
+        scrollRef={scrollRef}
+        pixelsPerSecond={props.pps}
+        rowHeight={draggedClipHeight}
+        selectedElementId={props.selectedElementId}
+        currentTime={props.currentTime}
+        theme={props.theme}
+        getTrackStyle={props.getTrackStyle}
+        renderClipContent={props.renderClipContent}
+        renderClipOverlay={props.renderClipOverlay}
+      />
 
       {/* Marquee (rubber-band) multi-select rectangle — mirrors the canvas
           MarqueeOverlay look: semi-transparent accent fill + dashed border. */}
diff --git a/packages/studio/src/player/components/TimelineClip.tsx b/packages/studio/src/player/components/TimelineClip.tsx
index e471a2f1a9..40410b565f 100644
--- a/packages/studio/src/player/components/TimelineClip.tsx
+++ b/packages/studio/src/player/components/TimelineClip.tsx
@@ -12,6 +12,7 @@ interface TimelineClipProps {
   isSelected: boolean;
   isHovered: boolean;
   isDragging?: boolean;
+  isGestureActor?: boolean;
   isActive?: boolean;
   hasCustomContent: boolean;
   capabilities: TimelineEditCapabilities;
@@ -36,6 +37,7 @@ export const TimelineClip = memo(function TimelineClip({
   isSelected,
   isHovered,
   isDragging = false,
+  isGestureActor = false,
   isActive = false,
   hasCustomContent,
   capabilities,
@@ -85,13 +87,14 @@ export const TimelineClip = memo(function TimelineClip({
 
   return (
     <div
-      data-clip="true"
-      data-el-id={el.key ?? el.id}
+      data-clip={isGestureActor ? undefined : "true"}
+      data-el-id={isGestureActor ? undefined : (el.key ?? el.id)}
       data-clip-start={el.start}
       data-clip-end={el.start + el.duration}
       data-clip-hidden={el.hidden ? "true" : undefined}
       data-active={isActive ? "" : undefined}
-      tabIndex={-1}
+      aria-hidden={isGestureActor ? "true" : undefined}
+      tabIndex={isGestureActor ? undefined : -1}
       className={clipClassName}
       style={style}
       title={
diff --git a/packages/studio/src/player/components/TimelineGestureOverlay.test.tsx b/packages/studio/src/player/components/TimelineGestureOverlay.test.tsx
new file mode 100644
index 0000000000..3774a667cb
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineGestureOverlay.test.tsx
@@ -0,0 +1,89 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it } from "vitest";
+import { defaultTimelineTheme } from "./timelineTheme";
+import { TimelineGestureOverlay } from "./TimelineGestureOverlay";
+import type { DraggedClipState } from "./timelineClipDragTypes";
+import { getTrackStyle } from "./useTimelineTrackLayout";
+
+Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
+
+const drag: DraggedClipState = {
+  element: { id: "hero", tag: "div", start: 2, duration: 3, track: 1 },
+  originClientX: 100,
+  originClientY: 100,
+  originScrollLeft: 0,
+  originScrollTop: 0,
+  pointerClientX: 350,
+  pointerClientY: 240,
+  pointerOffsetX: 20,
+  pointerOffsetY: 10,
+  previewStart: 4,
+  previewTrack: 2,
+  insertRow: null,
+  snapTime: null,
+  snapType: null,
+  started: true,
+};
+
+afterEach(() => document.body.replaceChildren());
+
+describe("TimelineGestureOverlay", () => {
+  it("keeps the drag actor mounted without a source-row node", () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    const scroll = {
+      scrollLeft: 500,
+      scrollTop: 300,
+      getBoundingClientRect: () => ({ left: 50, top: 40 }),
+    } as HTMLDivElement;
+    act(() => {
+      root.render(
+        <TimelineGestureOverlay
+          drag={drag}
+          scrollRef={{ current: scroll }}
+          pixelsPerSecond={100}
+          rowHeight={42}
+          selectedElementId="hero"
+          currentTime={4}
+          theme={defaultTimelineTheme}
+          getTrackStyle={getTrackStyle}
+        />,
+      );
+    });
+    const actor = host.querySelector<HTMLElement>('[data-timeline-gesture-actor="hero"]');
+    expect(actor?.style.left).toBe("780px");
+    expect(actor?.style.top).toBe("490px");
+    expect(actor?.querySelector(".timeline-clip")).not.toBeNull();
+    expect(actor?.querySelector("[data-el-id]")).toBeNull();
+    expect(actor?.querySelector("[data-clip]")).toBeNull();
+    expect(host.querySelector("[data-source-row]")).toBeNull();
+    act(() => root.unmount());
+  });
+
+  it("keeps the stable overlay host after terminal cleanup", () => {
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    act(() => {
+      root.render(
+        <TimelineGestureOverlay
+          drag={null}
+          scrollRef={{ current: null }}
+          pixelsPerSecond={100}
+          rowHeight={42}
+          selectedElementId={null}
+          currentTime={0}
+          theme={defaultTimelineTheme}
+          getTrackStyle={getTrackStyle}
+        />,
+      );
+    });
+    expect(host.querySelector("[data-timeline-gesture-overlay]")).not.toBeNull();
+    expect(host.querySelector("[data-timeline-gesture-actor]")).toBeNull();
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/TimelineGestureOverlay.tsx b/packages/studio/src/player/components/TimelineGestureOverlay.tsx
new file mode 100644
index 0000000000..500d2c0ea2
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineGestureOverlay.tsx
@@ -0,0 +1,96 @@
+import { memo, type ReactNode } from "react";
+import type { TimelineElement } from "../store/playerStore";
+import type { TimelineTheme } from "./timelineTheme";
+import { getRenderedTimelineElement } from "./timelineTheme";
+import { TimelineClip } from "./TimelineClip";
+import { getTimelineEditCapabilities } from "./timelineEditing";
+import { renderClipChildren } from "./timelineClipChildren";
+import { getTimelineDragOverlayPosition } from "./timelineClipDragPreview";
+import type { DraggedClipState } from "./timelineClipDragTypes";
+import type { TrackVisualStyle } from "./timelineIcons";
+import { isTimelineClipActive } from "./useTimelineActiveClips";
+
+interface TimelineGestureOverlayProps {
+  drag: DraggedClipState | null;
+  scrollRef: React.RefObject<HTMLDivElement | null>;
+  pixelsPerSecond: number;
+  rowHeight: number;
+  selectedElementId: string | null;
+  currentTime: number;
+  theme: TimelineTheme;
+  getTrackStyle: (tag: string) => TrackVisualStyle;
+  renderClipContent?: (
+    element: TimelineElement,
+    style: { clip: string; label: string },
+  ) => ReactNode;
+  renderClipOverlay?: (element: TimelineElement) => ReactNode;
+}
+
+/** Stable canvas child that owns the live drag actor independently of source rows. */
+export const TimelineGestureOverlay = memo(function TimelineGestureOverlay({
+  drag,
+  scrollRef,
+  pixelsPerSecond,
+  rowHeight,
+  selectedElementId,
+  currentTime,
+  theme,
+  getTrackStyle,
+  renderClipContent,
+  renderClipOverlay,
+}: TimelineGestureOverlayProps) {
+  const element =
+    drag?.started === true
+      ? getRenderedTimelineElement({
+          element: drag.element,
+          draggedElementId: drag.element.key ?? drag.element.id,
+          previewStart: drag.previewStart,
+          previewTrack: drag.previewTrack,
+        })
+      : null;
+  const position = drag ? getTimelineDragOverlayPosition(drag, scrollRef.current) : null;
+  return (
+    <div data-timeline-gesture-overlay className="absolute inset-0 pointer-events-none">
+      {element && position && (
+        <div
+          data-timeline-gesture-actor={element.key ?? element.id}
+          className="absolute"
+          style={{
+            top: position.top,
+            left: position.left,
+            width: Math.max(element.duration * pixelsPerSecond, 4),
+            height: rowHeight,
+            zIndex: 40,
+          }}
+        >
+          <TimelineClip
+            el={{ ...element, start: 0 }}
+            pps={pixelsPerSecond}
+            clipY={0}
+            isSelected={selectedElementId === (element.key ?? element.id)}
+            isHovered={false}
+            isDragging
+            isGestureActor
+            isActive={isTimelineClipActive(element, currentTime)}
+            hasCustomContent={!!renderClipContent}
+            capabilities={getTimelineEditCapabilities(element)}
+            theme={theme}
+            isComposition={!!element.compositionSrc}
+            onHoverStart={() => {}}
+            onHoverEnd={() => {}}
+            onResizeStart={() => {}}
+            onClick={() => {}}
+            onDoubleClick={() => {}}
+          >
+            {renderClipChildren(
+              element,
+              getTrackStyle(element.tag),
+              renderClipContent,
+              renderClipOverlay,
+            )}
+          </TimelineClip>
+        </div>
+      )}
+    </div>
+  );
+});
diff --git a/packages/studio/src/player/components/TimelineLaneTypes.ts b/packages/studio/src/player/components/TimelineLaneTypes.ts
index 41a6b6e5f6..5cb2d479b7 100644
--- a/packages/studio/src/player/components/TimelineLaneTypes.ts
+++ b/packages/studio/src/player/components/TimelineLaneTypes.ts
@@ -54,7 +54,6 @@ export interface TimelineLaneBaseProps {
   setResizingClip: (v: ResizingClipState | null) => void;
   setDraggedClip: (v: DraggedClipState | null) => void;
   setSelectedElementId: (id: string | null) => void;
-  syncClipDragAutoScroll: (x: number, y: number) => void;
   shiftClickClipRef: React.RefObject<{
     element: TimelineElement;
     anchorX: number;
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index 0f24760c4c..e26ffd5df7 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -71,7 +71,6 @@ export function TimelineLanes({
   setResizingClip,
   setDraggedClip,
   setSelectedElementId,
-  syncClipDragAutoScroll,
   shiftClickClipRef,
   getPreviewElement,
   getTrackStyle,
@@ -320,6 +319,7 @@ export function TimelineLanes({
                             setShowPopover(false);
                             setRangeSelection(null);
                             setResizingClip({
+                              pointerId: e.pointerId,
                               element: el,
                               edge,
                               originClientX: e.clientX,
@@ -358,6 +358,7 @@ export function TimelineLanes({
                                 (blockedIntent !== "move" && onResizeElement))
                             ) {
                               blockedClipRef.current = {
+                                pointerId: e.pointerId,
                                 element: el,
                                 intent: blockedIntent,
                                 originClientX: e.clientX,
@@ -371,6 +372,7 @@ export function TimelineLanes({
                             setShowPopover(false);
                             setRangeSelection(null);
                             setDraggedClip({
+                              pointerId: e.pointerId,
                               element: el,
                               originClientX: e.clientX,
                               originClientY: e.clientY,
@@ -388,7 +390,6 @@ export function TimelineLanes({
                               snapType: null,
                               started: false,
                             });
-                            syncClipDragAutoScroll(e.clientX, e.clientY);
                           }
                         }
                         onClick={
diff --git a/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts b/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts
index c9fc2b42b0..3cb8785f89 100644
--- a/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts
+++ b/packages/studio/src/player/components/timelineClipDragGestureLifecycle.ts
@@ -14,20 +14,44 @@ import {
 } from "./timelineOptimisticRevision";
 import type { TimelineEditCallbacks } from "./timelineCallbacks";
 import type { StackingPatch } from "./timelineStackingSync";
-import { usePlayerStore, type TimelineElement } from "../store/playerStore";
+import type { TimelineElement, usePlayerStore } from "../store/playerStore";
+
+export type TimelineGestureKind = "drag" | "resize";
+type TimelineGesturePhase = "active" | "committing" | "cancelled" | "complete";
+
+export interface TimelineGestureLifecycle {
+  kind: TimelineGestureKind | null;
+  phase: TimelineGesturePhase;
+  pointerId: number | null;
+  sessionEpoch: number;
+}
+
+interface TimelineGestureCommit {
+  kind: TimelineGestureKind;
+  drag: DraggedClipState | null;
+  resize: ResizingClipState | null;
+  groupResize: TimelineGroupResizeSession | null;
+}
 
 type UpdateElement = ReturnType<typeof usePlayerStore.getState>["updateElement"];
 
 interface TimelineClipDragGestureLifecycleInput {
+  lifecycleRef: RefObject<TimelineGestureLifecycle>;
+  sessionEpochRef: RefObject<number>;
+  cancelGestureRef: RefObject<
+    (options?: { updateReact?: boolean; suppressClick?: boolean }) => boolean
+  >;
+  scrollRef: RefObject<HTMLDivElement | null>;
   draggedClipRef: RefObject<DraggedClipState | null>;
   resizingClipRef: RefObject<ResizingClipState | null>;
   blockedClipRef: RefObject<BlockedClipState | null>;
   groupResizeRef: RefObject<TimelineGroupResizeSession | null>;
   suppressClickRef: RefObject<boolean>;
+  gestureSelectedKeysRef: RefObject<ReadonlySet<string>>;
   elementsRef: RefObject<TimelineElement[]>;
   trackOrderRef: RefObject<number[]>;
-  setDraggedClip: Dispatch<SetStateAction<DraggedClipState | null>>;
-  setResizingClip: Dispatch<SetStateAction<ResizingClipState | null>>;
+  setDraggedClipState: Dispatch<SetStateAction<DraggedClipState | null>>;
+  setResizingClipState: Dispatch<SetStateAction<ResizingClipState | null>>;
   setShowPopover: (show: boolean) => void;
   setRangeSelectionRef: RefObject<((selection: null) => void) | null>;
   applyResizePointerRef: RefObject<(resize: ResizingClipState, clientX: number) => void>;
@@ -36,7 +60,7 @@ interface TimelineClipDragGestureLifecycleInput {
   updateDraggedClipPreviewRef: RefObject<
     (drag: DraggedClipState, clientX: number, clientY: number) => DraggedClipState
   >;
-  restoreGroupResizeMembers: (session: TimelineGroupResizeSession, all?: boolean) => void;
+  publishDraggedClip: (next: DraggedClipState | null) => void;
   updateElement: UpdateElement;
   onMoveElementRef: RefObject<TimelineEditCallbacks["onMoveElement"]>;
   onMoveElementsRef: RefObject<TimelineEditCallbacks["onMoveElements"]>;
@@ -55,22 +79,27 @@ interface TimelineClipDragGestureLifecycleInput {
 export function mountTimelineClipDragGestureLifecycle({
   // The explicit destructuring mirrors the single call site's dependency object by design.
   // fallow-ignore-next-line code-duplication
+  lifecycleRef,
+  sessionEpochRef,
+  cancelGestureRef,
+  scrollRef,
   draggedClipRef,
   resizingClipRef,
   blockedClipRef,
   groupResizeRef,
   suppressClickRef,
+  gestureSelectedKeysRef,
   elementsRef,
   trackOrderRef,
-  setDraggedClip,
-  setResizingClip,
+  setDraggedClipState,
+  setResizingClipState,
   setShowPopover,
   setRangeSelectionRef,
   applyResizePointerRef,
   syncClipDragAutoScrollRef,
   stopClipDragAutoScrollRef,
   updateDraggedClipPreviewRef,
-  restoreGroupResizeMembers,
+  publishDraggedClip,
   updateElement,
   onMoveElementRef,
   onMoveElementsRef,
@@ -87,9 +116,65 @@ export function mountTimelineClipDragGestureLifecycle({
     });
   };
 
+  const pointerMatchesGesture = (event: PointerEvent): boolean => {
+    const pointerId = lifecycleRef.current.pointerId;
+    return pointerId === null || event.pointerId === pointerId;
+  };
+
+  const releasePointerCapture = (pointerId: number | null) => {
+    if (pointerId === null) return;
+    const scroll = scrollRef.current;
+    try {
+      if (scroll?.hasPointerCapture(pointerId)) scroll.releasePointerCapture(pointerId);
+    } catch {
+      // Window listeners are authoritative when native capture is unavailable.
+    }
+  };
+
+  const capturePointer = (pointerId: number | null) => {
+    if (pointerId === null) return;
+    try {
+      scrollRef.current?.setPointerCapture(pointerId);
+    } catch {
+      // Window listeners remain authoritative when native capture is unavailable.
+    }
+  };
+
+  const clearGestureProjection = (updateReact: boolean) => {
+    draggedClipRef.current = null;
+    resizingClipRef.current = null;
+    groupResizeRef.current = null;
+    if (updateReact) {
+      setDraggedClipState(null);
+      setResizingClipState(null);
+    }
+  };
+
+  const cancelGesture = ({
+    updateReact = true,
+    suppressClick = false,
+  }: {
+    updateReact?: boolean;
+    suppressClick?: boolean;
+  } = {}): boolean => {
+    const lifecycle = lifecycleRef.current;
+    if (lifecycle.phase !== "active") return false;
+    lifecycle.phase = "cancelled";
+    stopClipDragAutoScrollRef.current();
+    clearGestureProjection(updateReact);
+    releasePointerCapture(lifecycle.pointerId);
+    if (suppressClick) suppressClickRef.current = true;
+    lifecycle.kind = null;
+    lifecycle.pointerId = null;
+    lifecycle.phase = "complete";
+    return true;
+  };
+  cancelGestureRef.current = cancelGesture;
+
   const handleResizePointerMove = (event: PointerEvent, resize: ResizingClipState) => {
     const distance = Math.abs(event.clientX - resize.originClientX);
     if (!resize.started && distance < 2) return;
+    if (!resize.started) capturePointer(resize.pointerId ?? null);
     setShowPopover(false);
     setRangeSelectionRef.current?.(null);
     applyResizePointerRef.current(resize, event.clientX);
@@ -106,6 +191,7 @@ export function mountTimelineClipDragGestureLifecycle({
     if (!blocked.started) {
       blocked.started = true;
       blockedClipRef.current = blocked;
+      capturePointer(blocked.pointerId ?? null);
       suppressClickRef.current = true;
       setShowPopover(false);
       setRangeSelectionRef.current?.(null);
@@ -119,34 +205,33 @@ export function mountTimelineClipDragGestureLifecycle({
       event.clientY - drag.originClientY,
     );
     if (!drag.started && distance < 4) return;
+    if (!drag.started) capturePointer(drag.pointerId ?? null);
     setShowPopover(false);
     setRangeSelectionRef.current?.(null);
-    setDraggedClip((previous) =>
-      previous
-        ? updateDraggedClipPreviewRef.current(previous, event.clientX, event.clientY)
-        : previous,
-    );
+    publishDraggedClip(updateDraggedClipPreviewRef.current(drag, event.clientX, event.clientY));
     syncClipDragAutoScrollRef.current(event.clientX, event.clientY);
   };
 
   const handleWindowPointerMove = (event: PointerEvent) => {
     const resize = resizingClipRef.current;
-    if (resize) return handleResizePointerMove(event, resize);
+    if (resize) {
+      if (!pointerMatchesGesture(event)) return;
+      return handleResizePointerMove(event, resize);
+    }
     const blocked = blockedClipRef.current;
-    if (blocked) return handleBlockedPointerMove(event, blocked);
+    if (blocked) {
+      if (blocked.pointerId !== undefined && blocked.pointerId !== event.pointerId) return;
+      return handleBlockedPointerMove(event, blocked);
+    }
     const drag = draggedClipRef.current;
-    if (drag) handleDragPointerMove(event, drag);
+    if (drag && pointerMatchesGesture(event)) handleDragPointerMove(event, drag);
   };
 
-  const commitResizePointerUp = (resize: ResizingClipState) => {
-    resizingClipRef.current = null;
-    setResizingClip(null);
-    const groupSession = groupResizeRef.current;
-    groupResizeRef.current = null;
-    if (!resize.started) {
-      if (groupSession) restoreGroupResizeMembers(groupSession);
-      return;
-    }
+  const commitResizePointerUp = (
+    resize: ResizingClipState,
+    groupSession: TimelineGroupResizeSession | null,
+  ) => {
+    if (!resize.started) return;
     suppressClickRef.current = true;
     clearSuppressedClick();
     if (groupSession) {
@@ -193,8 +278,6 @@ export function mountTimelineClipDragGestureLifecycle({
   };
 
   const commitDragPointerUp = (drag: DraggedClipState) => {
-    draggedClipRef.current = null;
-    setDraggedClip(null);
     if (!drag.started) return;
     suppressClickRef.current = true;
     clearSuppressedClick();
@@ -204,25 +287,90 @@ export function mountTimelineClipDragGestureLifecycle({
       updateElement,
       onMoveElement: onMoveElementRef.current,
       onMoveElements: onMoveElementsRef.current,
-      selectedKeys: usePlayerStore.getState().selectedElementIds,
+      selectedKeys: gestureSelectedKeysRef.current,
       readZIndex: readZIndexRef.current,
       onStackingPatches: onStackingPatchesRef.current,
       refreshAfterLaneMove: refreshAfterLaneMoveRef.current,
     });
   };
 
-  const handleWindowPointerUp = () => {
+  const gestureSourcesStillExist = (): boolean => {
+    const gestureElements = groupResizeRef.current?.members.map((member) => member.element) ?? [
+      resizingClipRef.current?.element ?? draggedClipRef.current?.element,
+    ];
+    const liveKeys = new Set(elementsRef.current.map((element) => element.key ?? element.id));
+    return gestureElements.every(
+      (element) => element === undefined || liveKeys.has(element.key ?? element.id),
+    );
+  };
+
+  const claimActiveGesture = (event: PointerEvent): TimelineGestureCommit | "ignored" | null => {
+    const lifecycle = lifecycleRef.current;
+    if (lifecycle.phase !== "active") return null;
+    if (!pointerMatchesGesture(event)) return "ignored";
+    if (lifecycle.sessionEpoch !== sessionEpochRef.current) {
+      cancelGesture();
+      return "ignored";
+    }
+    if (!gestureSourcesStillExist()) {
+      cancelGesture();
+      return "ignored";
+    }
+    lifecycle.phase = "committing";
+    const claimed = lifecycle.kind
+      ? {
+          kind: lifecycle.kind,
+          drag: draggedClipRef.current,
+          resize: resizingClipRef.current,
+          groupResize: groupResizeRef.current,
+        }
+      : "ignored";
     stopClipDragAutoScrollRef.current();
-    const resize = resizingClipRef.current;
-    if (resize) return commitResizePointerUp(resize);
+    clearGestureProjection(true);
+    releasePointerCapture(lifecycle.pointerId);
+    if (claimed === "ignored") lifecycle.phase = "complete";
+    return claimed;
+  };
+
+  const commitClaimedGesture = (gesture: TimelineGestureCommit) => {
+    try {
+      if (gesture.kind === "resize" && gesture.resize) {
+        commitResizePointerUp(gesture.resize, gesture.groupResize);
+      } else if (gesture.kind === "drag" && gesture.drag) {
+        commitDragPointerUp(gesture.drag);
+      }
+    } finally {
+      const lifecycle = lifecycleRef.current;
+      lifecycle.kind = null;
+      lifecycle.pointerId = null;
+      lifecycle.phase = "complete";
+    }
+  };
+
+  const handleWindowPointerUp = (event: PointerEvent) => {
+    const claimed = claimActiveGesture(event);
+    if (claimed === "ignored") return;
+    if (claimed) {
+      commitClaimedGesture(claimed);
+      return;
+    }
     const blocked = blockedClipRef.current;
     if (blocked) return finishBlockedPointerUp(blocked);
-    const drag = draggedClipRef.current;
-    if (!drag) {
-      if (suppressClickRef.current) clearSuppressedClick();
-      return;
+    if (suppressClickRef.current) clearSuppressedClick();
+  };
+
+  const handleWindowPointerCancel = (event: PointerEvent) => {
+    if (lifecycleRef.current.phase === "active" && pointerMatchesGesture(event)) {
+      if (cancelGesture({ suppressClick: true })) clearSuppressedClick();
+    }
+    blockedClipRef.current = null;
+    if (suppressClickRef.current) clearSuppressedClick();
+  };
+
+  const handleLostPointerCapture = (event: PointerEvent) => {
+    if (lifecycleRef.current.phase === "active" && pointerMatchesGesture(event)) {
+      if (cancelGesture({ suppressClick: true })) clearSuppressedClick();
     }
-    commitDragPointerUp(drag);
   };
 
   const handleWindowKeyDown = (event: KeyboardEvent) => {
@@ -235,27 +383,22 @@ export function mountTimelineClipDragGestureLifecycle({
     if (!decision.cancel) return;
     event.preventDefault();
     event.stopPropagation();
-    stopClipDragAutoScrollRef.current();
-    draggedClipRef.current = null;
-    setDraggedClip(null);
-    resizingClipRef.current = null;
-    setResizingClip(null);
-    const groupSession = groupResizeRef.current;
-    groupResizeRef.current = null;
-    if (groupSession) restoreGroupResizeMembers(groupSession);
     blockedClipRef.current = null;
-    if (decision.suppressClick) suppressClickRef.current = true;
+    cancelGesture({ suppressClick: decision.suppressClick });
   };
 
   window.addEventListener("pointermove", handleWindowPointerMove);
   window.addEventListener("pointerup", handleWindowPointerUp);
-  window.addEventListener("pointercancel", handleWindowPointerUp);
+  window.addEventListener("pointercancel", handleWindowPointerCancel);
+  window.addEventListener("lostpointercapture", handleLostPointerCapture);
   window.addEventListener("keydown", handleWindowKeyDown, true);
   return () => {
-    stopClipDragAutoScrollRef.current();
+    cancelGesture({ updateReact: false });
+    cancelGestureRef.current = () => false;
     window.removeEventListener("pointermove", handleWindowPointerMove);
     window.removeEventListener("pointerup", handleWindowPointerUp);
-    window.removeEventListener("pointercancel", handleWindowPointerUp);
+    window.removeEventListener("pointercancel", handleWindowPointerCancel);
+    window.removeEventListener("lostpointercapture", handleLostPointerCapture);
     window.removeEventListener("keydown", handleWindowKeyDown, true);
   };
 }
diff --git a/packages/studio/src/player/components/timelineClipDragPreview.test.ts b/packages/studio/src/player/components/timelineClipDragPreview.test.ts
index c71e9e73f6..596cbb3532 100644
--- a/packages/studio/src/player/components/timelineClipDragPreview.test.ts
+++ b/packages/studio/src/player/components/timelineClipDragPreview.test.ts
@@ -3,6 +3,7 @@ import type { TimelineElement } from "../store/playerStore";
 import {
   computeDragPreview,
   computeResizePreview,
+  getTimelineDragOverlayPosition,
   type DragPreviewContext,
 } from "./timelineClipDragPreview";
 import type { DraggedClipState } from "./timelineClipDragTypes";
@@ -221,3 +222,32 @@ describe("computeResizePreview — composition source continuity", () => {
     });
   });
 });
+
+describe("getTimelineDragOverlayPosition", () => {
+  it("keeps the gesture actor under the pointer across two-axis autoscroll", () => {
+    const { drag } = horizontalDrag(moodboard, 0.5, 2);
+    const scroll = {
+      scrollLeft: 500,
+      scrollTop: 300,
+      getBoundingClientRect: () => ({ left: 20, top: 40 }),
+    } as Pick<HTMLDivElement, "scrollLeft" | "scrollTop" | "getBoundingClientRect">;
+    expect(
+      getTimelineDragOverlayPosition(
+        {
+          ...drag,
+          pointerClientX: 900,
+          pointerClientY: 700,
+          pointerOffsetX: 25,
+          pointerOffsetY: 10,
+        },
+        scroll,
+      ),
+    ).toEqual({ left: 1_355, top: 950 });
+  });
+
+  it("does not mount an actor before threshold or without the stable viewport", () => {
+    const { drag } = horizontalDrag(moodboard, 0.5, 2);
+    expect(getTimelineDragOverlayPosition({ ...drag, started: false }, fakeScroll())).toBeNull();
+    expect(getTimelineDragOverlayPosition(drag, null)).toBeNull();
+  });
+});
diff --git a/packages/studio/src/player/components/timelineClipDragPreview.ts b/packages/studio/src/player/components/timelineClipDragPreview.ts
index 982f42fbff..935878205d 100644
--- a/packages/studio/src/player/components/timelineClipDragPreview.ts
+++ b/packages/studio/src/player/components/timelineClipDragPreview.ts
@@ -45,6 +45,19 @@ export interface DragPreviewContext {
   audioTracks?: ReadonlySet<number>;
 }
 
+/** Content-space position for the stable viewport drag actor. */
+export function getTimelineDragOverlayPosition(
+  drag: DraggedClipState,
+  scroll: Pick<HTMLDivElement, "scrollLeft" | "scrollTop" | "getBoundingClientRect"> | null,
+): { left: number; top: number } | null {
+  if (!drag.started || !scroll) return null;
+  const rect = scroll.getBoundingClientRect();
+  return {
+    left: drag.pointerClientX - rect.left + scroll.scrollLeft - drag.pointerOffsetX,
+    top: drag.pointerClientY - rect.top + scroll.scrollTop - drag.pointerOffsetY,
+  };
+}
+
 /**
  * Max start a drag may reach. Allow dragging past the current content into the
  * rendered timeline extent (the viewport-fill keeps that ≥ the viewport width).
@@ -328,29 +341,22 @@ export function computeResizePreview(
 
 /**
  * Apply a rigid group-resize preview: fold the grabbed clip's raw delta into the
- * session, preview every non-grabbed member through the store (`updateElement`),
- * and set the grabbed clip's preview state (it renders from resizingClip state, so
- * its store value stays pristine until commit — like the single-clip path).
+ * session and publish a coordinator-owned projection. Canonical elements stay
+ * pristine until the exactly-once commit.
  */
 export function previewGroupResize(
   session: TimelineGroupResizeSession,
   next: ResizePreviewResult,
-  grabbedKey: string,
-  updateElement: (
-    key: string,
-    patch: { start: number; duration: number; playbackStart?: number },
+  setResizeState: (
+    v: ResizePreviewResult & { groupPreview: TimelineGroupResizeSession["changes"] },
   ) => void,
-  setResizeState: (v: ResizePreviewResult) => void,
 ): void {
   const grabbedChange = applyTimelineGroupResizePreview(session, next);
-  for (const c of session.changes) {
-    if (c.key === grabbedKey) continue;
-    updateElement(c.key, { start: c.start, duration: c.duration, playbackStart: c.playbackStart });
-  }
   setResizeState({
     originScrollLeft: next.originScrollLeft,
     previewStart: grabbedChange?.start ?? next.previewStart,
     previewDuration: grabbedChange?.duration ?? next.previewDuration,
     previewPlaybackStart: grabbedChange?.playbackStart ?? next.previewPlaybackStart,
+    groupPreview: session.changes,
   });
 }
diff --git a/packages/studio/src/player/components/timelineClipDragTypes.ts b/packages/studio/src/player/components/timelineClipDragTypes.ts
index 8ac36c9a68..96cdadaac7 100644
--- a/packages/studio/src/player/components/timelineClipDragTypes.ts
+++ b/packages/studio/src/player/components/timelineClipDragTypes.ts
@@ -4,6 +4,8 @@ import type { BlockedTimelineEditIntent } from "./timelineEditing";
 
 /* ── Shared clip-drag state types ───────────────────────────────── */
 export interface DraggedClipState {
+  /** Pointer captured by the stable viewport coordinator for this gesture. */
+  pointerId?: number;
   element: TimelineElement;
   originClientX: number;
   originClientY: number;
@@ -39,6 +41,8 @@ export interface DraggedClipState {
 }
 
 export interface ResizingClipState {
+  /** Pointer captured by the stable viewport coordinator for this gesture. */
+  pointerId?: number;
   element: TimelineElement;
   edge: "start" | "end";
   originClientX: number;
@@ -53,10 +57,18 @@ export interface ResizingClipState {
   previewStart: number;
   previewDuration: number;
   previewPlaybackStart?: number;
+  /** Coordinator-owned group projection; canonical elements change only on commit. */
+  groupPreview?: readonly {
+    key: string;
+    start: number;
+    duration: number;
+    playbackStart?: number;
+  }[];
   started: boolean;
 }
 
 export interface BlockedClipState {
+  pointerId?: number;
   element: TimelineElement;
   intent: BlockedTimelineEditIntent;
   originClientX: number;
diff --git a/packages/studio/src/player/components/timelineViewModel.ts b/packages/studio/src/player/components/timelineViewModel.ts
index 86b1860399..7ed364a213 100644
--- a/packages/studio/src/player/components/timelineViewModel.ts
+++ b/packages/studio/src/player/components/timelineViewModel.ts
@@ -28,10 +28,10 @@ export function getTimelinePreviewElement(
   element: TimelineElement,
   resizingClip: ResizingClipState | null,
 ): TimelineElement {
-  if (
-    resizingClip &&
-    (resizingClip.element.key ?? resizingClip.element.id) === (element.key ?? element.id)
-  ) {
+  const elementKey = element.key ?? element.id;
+  const groupPreview = resizingClip?.groupPreview?.find((change) => change.key === elementKey);
+  if (groupPreview) return { ...element, ...groupPreview };
+  if (resizingClip && (resizingClip.element.key ?? resizingClip.element.id) === elementKey) {
     return {
       ...element,
       start: resizingClip.previewStart,
diff --git a/packages/studio/src/player/components/useTimelineClipDrag.resize.test.tsx b/packages/studio/src/player/components/useTimelineClipDrag.resize.test.tsx
index 33ebd8ff47..b7dcc6bf75 100644
--- a/packages/studio/src/player/components/useTimelineClipDrag.resize.test.tsx
+++ b/packages/studio/src/player/components/useTimelineClipDrag.resize.test.tsx
@@ -4,7 +4,7 @@ import React, { act } from "react";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { TimelineElement } from "../store/playerStore";
 import { usePlayerStore } from "../store/playerStore";
-import type { ResizingClipState } from "./useTimelineClipDrag";
+import type { DraggedClipState, ResizingClipState } from "./useTimelineClipDrag";
 import { useTimelineClipDrag } from "./useTimelineClipDrag";
 import { mountReactHarness } from "../../hooks/domSelectionTestHarness";
 
@@ -38,38 +38,59 @@ function renderResizeHarness(
   usePlayerStore.getState().setSelectedElementIds(new Set(selected));
 
   const scroll = document.createElement("div");
+  const setPointerCapture = vi.fn();
+  scroll.setPointerCapture = setPointerCapture;
   document.body.append(scroll);
   const onResizeElement = vi.fn();
+  const onMoveElement = vi.fn();
   const onResizeElements = vi.fn().mockResolvedValue(undefined);
   let setResizingClip: ((s: ResizingClipState | null) => void) | null = null;
+  let setDraggedClip: ((s: DraggedClipState | null) => void) | null = null;
+  let resizingClip: ResizingClipState | null = null;
+  let epoch = 0;
 
-  function Harness() {
+  function Harness({ sessionEpoch }: { sessionEpoch: number }) {
     const hook = useTimelineClipDrag({
       scrollRef: { current: scroll },
       ppsRef: { current: 100 },
       durationRef: { current: 100 },
       trackOrderRef: { current: [0, 1] },
       onResizeElement,
+      onMoveElement,
       onResizeElements: options.wireGroupResize === false ? undefined : onResizeElements,
       setShowPopover: vi.fn(),
       setRangeSelectionRef: { current: vi.fn() },
+      sessionEpoch,
     });
     setResizingClip = hook.setResizingClip;
+    setDraggedClip = hook.setDraggedClip;
+    resizingClip = hook.resizingClip;
     return null;
   }
 
-  const root = mountReactHarness(<Harness />);
+  const root = mountReactHarness(<Harness sessionEpoch={epoch} />);
   const apply = setResizingClip!;
+  const dispatchPointer = (type: string, clientX: number, pointerId?: number) => {
+    const event = new MouseEvent(type, { bubbles: true, clientX, clientY: 0 });
+    if (pointerId !== undefined) Object.defineProperty(event, "pointerId", { value: pointerId });
+    window.dispatchEvent(event);
+  };
 
   return {
     onResizeElement,
+    onMoveElement,
     onResizeElements,
+    setPointerCapture,
     storeById(id: string) {
       return usePlayerStore.getState().elements.find((e) => e.id === id)!;
     },
-    startResize(element: TimelineElement, edge: "start" | "end") {
+    getResizeProjection() {
+      return resizingClip?.groupPreview ?? [];
+    },
+    startResize(element: TimelineElement, edge: "start" | "end", pointerId?: number) {
       act(() => {
         apply({
+          pointerId,
           element,
           edge,
           originClientX: 0,
@@ -80,16 +101,54 @@ function renderResizeHarness(
         });
       });
     },
-    movePointer(clientX: number) {
+    startDrag(element: TimelineElement, pointerId?: number) {
+      act(() =>
+        setDraggedClip?.({
+          pointerId,
+          element,
+          originClientX: 0,
+          originClientY: 0,
+          originScrollLeft: 0,
+          originScrollTop: 0,
+          pointerClientX: 0,
+          pointerClientY: 0,
+          pointerOffsetX: 0,
+          pointerOffsetY: 0,
+          previewStart: element.start,
+          previewTrack: element.track,
+          insertRow: null,
+          snapTime: null,
+          snapType: null,
+          started: false,
+        }),
+      );
+    },
+    movePointer(clientX: number, pointerId?: number) {
       act(() => {
-        window.dispatchEvent(new MouseEvent("pointermove", { bubbles: true, clientX, clientY: 0 }));
+        dispatchPointer("pointermove", clientX, pointerId);
       });
     },
-    async dropPointer() {
+    async dropPointer(pointerId?: number) {
       await act(async () => {
-        window.dispatchEvent(new MouseEvent("pointerup", { bubbles: true }));
+        dispatchPointer("pointerup", 0, pointerId);
       });
     },
+    async moveAndDropPointer(clientX: number, pointerId?: number) {
+      await act(async () => {
+        dispatchPointer("pointermove", clientX, pointerId);
+        dispatchPointer("pointerup", clientX, pointerId);
+      });
+    },
+    cancelPointer(pointerId?: number) {
+      act(() => dispatchPointer("pointercancel", 0, pointerId));
+    },
+    losePointerCapture(pointerId?: number) {
+      act(() => dispatchPointer("lostpointercapture", 0, pointerId));
+    },
+    setSessionEpoch(next: number) {
+      epoch = next;
+      act(() => root.render(<Harness sessionEpoch={epoch} />));
+    },
     pressEscape() {
       act(() => {
         window.dispatchEvent(new KeyboardEvent("keydown", { key: "Escape", bubbles: true }));
@@ -161,14 +220,113 @@ describe("useTimelineClipDrag — single-clip resize (unchanged path)", () => {
   });
 });
 
+describe("useTimelineClipDrag — gesture lifecycle", () => {
+  it("does not capture a stationary click before the drag threshold", () => {
+    const a = el("a", { duration: 2 });
+    const h = renderResizeHarness([a], []);
+    h.startDrag(a, 7);
+    expect(h.setPointerCapture).not.toHaveBeenCalled();
+
+    h.movePointer(3, 7);
+    expect(h.setPointerCapture).not.toHaveBeenCalled();
+
+    h.movePointer(5, 7);
+    expect(h.setPointerCapture).toHaveBeenCalledOnce();
+    expect(h.setPointerCapture).toHaveBeenCalledWith(7);
+    h.unmount();
+  });
+
+  it("commits the final drag position exactly once", async () => {
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
+    const a = el("a", { duration: 2 });
+    const h = renderResizeHarness([a], []);
+    h.startDrag(a, 7);
+    await h.moveAndDropPointer(50, 7);
+    await h.dropPointer(7);
+    expect(h.onMoveElement).toHaveBeenCalledTimes(1);
+    expect(h.onMoveElement).toHaveBeenCalledWith(a, expect.objectContaining({ start: 0.5 }));
+    warnSpy.mockRestore();
+    h.unmount();
+  });
+
+  it("commits the final same-turn pointer move exactly once", async () => {
+    const a = el("a", { duration: 2 });
+    const h = renderResizeHarness([a], []);
+    h.startResize(a, "end", 7);
+    await h.moveAndDropPointer(75, 7);
+    await h.dropPointer(7);
+    expect(h.onResizeElement).toHaveBeenCalledTimes(1);
+    expect(h.onResizeElement).toHaveBeenCalledWith(a, expect.objectContaining({ duration: 2.75 }));
+    h.unmount();
+  });
+
+  it("ignores another pointer and cancels without committing", async () => {
+    const a = el("a", { duration: 2 });
+    const h = renderResizeHarness([a], []);
+    h.startResize(a, "end", 7);
+    h.movePointer(50, 8);
+    await h.dropPointer(8);
+    expect(h.onResizeElement).not.toHaveBeenCalled();
+    h.cancelPointer(7);
+    await h.dropPointer(7);
+    expect(h.onResizeElement).not.toHaveBeenCalled();
+    expect(h.storeById("a").duration).toBe(2);
+    h.unmount();
+  });
+
+  it("cancels an active projection when the project epoch changes", () => {
+    const a = el("a", { duration: 2 });
+    const h = renderResizeHarness([a], []);
+    h.startResize(a, "end", 7);
+    h.movePointer(50, 7);
+    h.setSessionEpoch(1);
+    expect(h.getResizeProjection()).toHaveLength(0);
+    expect(h.onResizeElement).not.toHaveBeenCalled();
+    expect(h.storeById("a").duration).toBe(2);
+    h.unmount();
+  });
+
+  it("does not commit a stale clip deleted during the gesture", async () => {
+    const a = el("a", { duration: 2 });
+    const h = renderResizeHarness([a], []);
+    h.startResize(a, "end", 7);
+    h.movePointer(50, 7);
+    act(() => usePlayerStore.getState().setElements([]));
+    await h.dropPointer(7);
+    expect(h.onResizeElement).not.toHaveBeenCalled();
+    expect(usePlayerStore.getState().elements).toEqual([]);
+    h.unmount();
+  });
+
+  it("treats lost capture and unmount as cancellation", async () => {
+    const a = el("a", { duration: 2 });
+    const lost = renderResizeHarness([a], []);
+    lost.startResize(a, "end", 7);
+    lost.movePointer(50, 7);
+    lost.losePointerCapture(7);
+    await lost.dropPointer(7);
+    expect(lost.onResizeElement).not.toHaveBeenCalled();
+    lost.unmount();
+
+    const unmounted = renderResizeHarness([a], []);
+    unmounted.startResize(a, "end", 9);
+    unmounted.movePointer(50, 9);
+    unmounted.unmount();
+    expect(unmounted.onResizeElement).not.toHaveBeenCalled();
+    expect(usePlayerStore.getState().elements[0]?.duration).toBe(2);
+  });
+});
+
 describe("useTimelineClipDrag — multi-select group resize (restored)", () => {
-  it("previews the non-grabbed member through the store, grabbed stays out until commit", () => {
+  it("previews every member without mutating canonical elements", () => {
     const { h } = startGroupResize(); // grabbed asks +0.5
 
-    // Non-grabbed member is previewed in the store; the grabbed clip renders from
-    // resizingClip state, so its store value is still the original until commit.
-    expect(h.storeById("b").duration).toBe(3.5);
+    expect(h.getResizeProjection()).toEqual([
+      expect.objectContaining({ key: "a", duration: 2.5 }),
+      expect.objectContaining({ key: "b", duration: 3.5 }),
+    ]);
     expect(h.storeById("a").duration).toBe(2);
+    expect(h.storeById("b").duration).toBe(3);
     h.unmount();
   });
 
@@ -186,6 +344,7 @@ describe("useTimelineClipDrag — multi-select group resize (restored)", () => {
       { coalesceKey: expect.stringMatching(/^clip-group-resize:/) },
     );
     expect(h.storeById("a").duration).toBe(2.5);
+    expect(h.getResizeProjection()).toHaveLength(0);
     expect(h.storeById("b").duration).toBe(3.5);
     h.unmount();
   });
@@ -213,7 +372,10 @@ describe("useTimelineClipDrag — multi-select group resize (restored)", () => {
     });
     h.startResize(a, "end");
     h.movePointer(50);
-    expect(h.storeById("b").duration).toBe(3.5);
+    expect(h.getResizeProjection()).toEqual(
+      expect.arrayContaining([expect.objectContaining({ key: "b", duration: 3.5 })]),
+    );
+    expect(h.storeById("b").duration).toBe(3);
 
     await h.dropPointer();
     expect(h.storeById("a").duration).toBe(2);
@@ -229,12 +391,13 @@ describe("useTimelineClipDrag — multi-select group resize (restored)", () => {
     h.unmount();
   });
 
-  it("Escape rolls back the previewed non-grabbed member and persists nothing", () => {
+  it("Escape discards the projection and persists nothing", () => {
     const { h } = startGroupResize();
-    expect(h.storeById("b").duration).toBe(3.5); // previewed
+    expect(h.getResizeProjection()).toHaveLength(2);
 
     h.pressEscape();
-    expect(h.storeById("b").duration).toBe(3); // restored
+    expect(h.getResizeProjection()).toHaveLength(0);
+    expect(h.storeById("b").duration).toBe(3);
     expect(h.onResizeElement).not.toHaveBeenCalled();
     h.unmount();
   });
diff --git a/packages/studio/src/player/components/useTimelineClipDrag.ts b/packages/studio/src/player/components/useTimelineClipDrag.ts
index 86ce7173e2..237f1fa264 100644
--- a/packages/studio/src/player/components/useTimelineClipDrag.ts
+++ b/packages/studio/src/player/components/useTimelineClipDrag.ts
@@ -1,4 +1,4 @@
-import { useRef, useState, useCallback, useMemo } from "react";
+import { useRef, useState, useCallback, useMemo, useEffect } from "react";
 import { useMountEffect } from "../../hooks/useMountEffect";
 import {
   applyTimelineAutoScrollStep,
@@ -25,9 +25,13 @@ import type {
   ResizingClipState,
   BlockedClipState,
 } from "./timelineClipDragTypes";
-import { mountTimelineClipDragGestureLifecycle } from "./timelineClipDragGestureLifecycle";
 import { getTimelineElementIndexes } from "../lib/timelineElementIndexes";
 import type { TimelineRowGeometry } from "./timelineLayout";
+import {
+  mountTimelineClipDragGestureLifecycle,
+  type TimelineGestureKind,
+  type TimelineGestureLifecycle,
+} from "./timelineClipDragGestureLifecycle";
 
 export type {
   DraggedClipState,
@@ -74,6 +78,7 @@ interface UseTimelineClipDragInput {
   readZIndex?: (element: TimelineElement) => number;
   onStackingPatches?: (patches: StackingPatch[]) => Promise<unknown> | void;
   refreshAfterLaneMove?: () => void;
+  sessionEpoch?: number;
 }
 
 export function useTimelineClipDrag({
@@ -92,6 +97,7 @@ export function useTimelineClipDrag({
   readZIndex,
   onStackingPatches,
   refreshAfterLaneMove,
+  sessionEpoch = 0,
 }: UseTimelineClipDragInput) {
   const updateElement = usePlayerStore((s) => s.updateElement);
   const rawBeatTimes = usePlayerStore((s) => s.beatAnalysis?.beatTimes ?? EMPTY_BEAT_TIMES);
@@ -162,41 +168,73 @@ export function useTimelineClipDrag({
     [],
   );
 
-  const [draggedClip, setDraggedClip] = useState<DraggedClipState | null>(null);
+  const [draggedClip, setDraggedClipState] = useState<DraggedClipState | null>(null);
   const draggedClipRef = useRef<DraggedClipState | null>(null);
-  draggedClipRef.current = draggedClip;
+  const publishDraggedClip = useCallback((next: DraggedClipState | null) => {
+    draggedClipRef.current = next;
+    setDraggedClipState(next);
+  }, []);
 
-  const [resizingClip, setResizingClip] = useState<ResizingClipState | null>(null);
+  const [resizingClip, setResizingClipState] = useState<ResizingClipState | null>(null);
   const resizingClipRef = useRef<ResizingClipState | null>(null);
-  resizingClipRef.current = resizingClip;
+  const publishResizingClip = useCallback((next: ResizingClipState | null) => {
+    resizingClipRef.current = next;
+    setResizingClipState(next);
+  }, []);
+
+  const lifecycleRef = useRef<TimelineGestureLifecycle>({
+    kind: null,
+    phase: "complete",
+    pointerId: null,
+    sessionEpoch,
+  });
+  const sessionEpochRef = useRef(sessionEpoch);
+  sessionEpochRef.current = sessionEpoch;
+  const gestureSelectedKeysRef = useRef<ReadonlySet<string>>(new Set());
+  const cancelGestureRef = useRef<
+    (options?: { updateReact?: boolean; suppressClick?: boolean }) => boolean
+  >(() => false);
+  const beginGesture = useCallback((kind: TimelineGestureKind, pointerId?: number) => {
+    if (lifecycleRef.current.phase === "active") cancelGestureRef.current();
+    const stablePointerId = Number.isFinite(pointerId) ? (pointerId ?? null) : null;
+    lifecycleRef.current = {
+      kind,
+      phase: "active",
+      pointerId: stablePointerId,
+      sessionEpoch: sessionEpochRef.current,
+    };
+    gestureSelectedKeysRef.current = new Set(usePlayerStore.getState().selectedElementIds);
+  }, []);
+  const setDraggedClip = useCallback(
+    (next: DraggedClipState | null) => {
+      if (!next) {
+        cancelGestureRef.current();
+        return;
+      }
+      beginGesture("drag", next.pointerId);
+      publishDraggedClip(next);
+    },
+    [beginGesture, publishDraggedClip],
+  );
+  const setResizingClip = useCallback(
+    (next: ResizingClipState | null) => {
+      if (!next) {
+        cancelGestureRef.current();
+        return;
+      }
+      beginGesture("resize", next.pointerId);
+      publishResizingClip(next);
+    },
+    [beginGesture, publishResizingClip],
+  );
 
   const blockedClipRef = useRef<BlockedClipState | null>(null);
   const suppressClickRef = useRef(false);
 
-  // Active multi-select group-resize session (restored from main 36413da7f): set
-  // lazily on the first resize pointermove when the grabbed clip is part of a
-  // capability-clean multi-selection (null ⇒ single-clip resize). Holds the
-  // pre-gesture snapshot so the non-grabbed members (previewed through the store)
-  // roll back on escape / cancel / failed persist.
+  // Active multi-select group-resize session, created lazily on first movement.
+  // It owns a projection only; canonical store timing changes at commit.
   const groupResizeRef = useRef<TimelineGroupResizeSession | null>(null);
 
-  // Restore the non-grabbed group members to their pre-gesture timing (the
-  // grabbed clip renders from resizingClip state, so it is never written during
-  // preview). `all` also restores the grabbed clip after a committed persist fails.
-  const restoreGroupResizeMembers = useCallback(
-    (session: TimelineGroupResizeSession, all = false) => {
-      for (const m of session.members) {
-        if (!all && m.key === session.grabbedKey) continue;
-        updateElement(m.key, {
-          start: m.start,
-          duration: m.duration,
-          playbackStart: m.playbackStart,
-        });
-      }
-    },
-    [updateElement],
-  );
-
   const onMoveElementRef = useRef(onMoveElement);
   onMoveElementRef.current = onMoveElement;
   const onMoveElementsRef = useRef(onMoveElements);
@@ -237,7 +275,7 @@ export function useTimelineClipDrag({
         trackOrder: trackOrderRef.current,
         rowHeights: rowGeometryRef?.current.rowHeights,
         elements: elementsRef.current,
-        selectedKeys: usePlayerStore.getState().selectedElementIds,
+        selectedKeys: gestureSelectedKeysRef.current,
         buildSnapTargets,
         audioTracks: dragAudioTracksRef.current,
       });
@@ -256,18 +294,19 @@ export function useTimelineClipDrag({
         buildSnapTargets,
       });
       const setResizeState = (v: ResizePreviewResult) =>
-        setResizingClip((prev) => (prev ? { ...prev, started: true, ...v } : prev));
+        publishResizingClip(
+          resizingClipRef.current ? { ...resizingClipRef.current, started: true, ...v } : null,
+        );
 
       // Group resize: a capability-clean multi-selection resizes rigidly by one
       // shared, member-clamped delta (legacy main 36413da7f). The grabbed clip
-      // drives the raw delta and renders from resizingClip state; non-grabbed
-      // members preview through the store (their store value stays pristine).
+      // drives the raw delta; every member renders from the coordinator projection.
       const grabbedKey = resize.element.key ?? resize.element.id;
       let session = groupResizeRef.current;
       if (!session || session.grabbedKey !== grabbedKey || session.edge !== resize.edge) {
         const members = buildTimelineGroupResizeMembers(
           elementsRef.current,
-          usePlayerStore.getState().selectedElementIds,
+          gestureSelectedKeysRef.current,
           grabbedKey,
           resize.edge,
         );
@@ -287,9 +326,9 @@ export function useTimelineClipDrag({
         setResizeState(next);
         return;
       }
-      previewGroupResize(session, next, grabbedKey, updateElement, setResizeState);
+      previewGroupResize(session, next, setResizeState);
     },
-    [scrollRef, ppsRef, buildSnapTargets, updateElement],
+    [scrollRef, ppsRef, buildSnapTargets, publishResizingClip],
   );
   const applyResizePointerRef = useRef(applyResizePointer);
   applyResizePointerRef.current = applyResizePointer;
@@ -300,9 +339,7 @@ export function useTimelineClipDrag({
       cancelAnimationFrame(clipDragScrollRaf.current);
       clipDragScrollRaf.current = 0;
     }
-    // Gesture teardown: drop the frozen-per-gesture perf caches so the next drag
-    // rebuilds them against fresh store state (see snapTargetsCacheRef). Does NOT
-    // touch groupResizeRef — commit reads it after this runs.
+    // Gesture teardown: drop frozen caches so the next gesture reads fresh state.
     snapTargetsCacheRef.current.clear();
     dragAudioTracksRef.current = null;
   }, []);
@@ -317,16 +354,14 @@ export function useTimelineClipDrag({
     if (!applyTimelineAutoScrollStep(scroll, pointer.clientX, pointer.clientY)) return;
 
     if (drag) {
-      setDraggedClip((prev) =>
-        prev ? updateDraggedClipPreview(prev, pointer.clientX, pointer.clientY) : prev,
-      );
+      publishDraggedClip(updateDraggedClipPreview(drag, pointer.clientX, pointer.clientY));
     } else if (resize) {
       // Re-run the trim preview so the edge keeps tracking while the content
       // scrolls under the stationary pointer (scroll-compensated pointer x).
       applyResizePointerRef.current(resize, pointer.clientX);
     }
     clipDragScrollRaf.current = requestAnimationFrame(stepClipDragAutoScroll);
-  }, [scrollRef, updateDraggedClipPreview]);
+  }, [publishDraggedClip, scrollRef, updateDraggedClipPreview]);
 
   const syncClipDragAutoScroll = useCallback(
     (clientX: number, clientY: number) => {
@@ -354,35 +389,44 @@ export function useTimelineClipDrag({
   const stopClipDragAutoScrollRef = useRef(stopClipDragAutoScroll);
   stopClipDragAutoScrollRef.current = stopClipDragAutoScroll;
 
-  useMountEffect(() => {
-    return mountTimelineClipDragGestureLifecycle({
-      draggedClipRef,
-      resizingClipRef,
-      blockedClipRef,
-      groupResizeRef,
-      suppressClickRef,
-      elementsRef,
-      trackOrderRef,
-      setDraggedClip,
-      setResizingClip,
-      setShowPopover,
-      setRangeSelectionRef,
-      applyResizePointerRef,
-      syncClipDragAutoScrollRef,
-      stopClipDragAutoScrollRef,
-      updateDraggedClipPreviewRef,
-      restoreGroupResizeMembers,
-      updateElement,
-      onMoveElementRef,
-      onMoveElementsRef,
-      onResizeElementRef,
-      onResizeElementsRef,
-      onBlockedEditAttemptRef,
-      readZIndexRef,
+  useMountEffect(() =>
+    mountTimelineClipDragGestureLifecycle({
       onStackingPatchesRef,
       refreshAfterLaneMoveRef,
-    });
-  });
+      readZIndexRef,
+      onBlockedEditAttemptRef,
+      onResizeElementsRef,
+      onResizeElementRef,
+      onMoveElementsRef,
+      onMoveElementRef,
+      updateElement,
+      publishDraggedClip,
+      updateDraggedClipPreviewRef,
+      stopClipDragAutoScrollRef,
+      syncClipDragAutoScrollRef,
+      applyResizePointerRef,
+      setRangeSelectionRef,
+      setShowPopover,
+      setResizingClipState,
+      setDraggedClipState,
+      trackOrderRef,
+      elementsRef,
+      gestureSelectedKeysRef,
+      suppressClickRef,
+      groupResizeRef,
+      blockedClipRef,
+      resizingClipRef,
+      draggedClipRef,
+      scrollRef,
+      cancelGestureRef,
+      sessionEpochRef,
+      lifecycleRef,
+    }),
+  );
+
+  useEffect(() => {
+    cancelGestureRef.current();
+  }, [sessionEpoch]);
 
   return {
     draggedClip,
@@ -391,7 +435,6 @@ export function useTimelineClipDrag({
     setResizingClip,
     blockedClipRef,
     suppressClickRef,
-    syncClipDragAutoScroll,
     stopClipDragAutoScroll,
   };
 }
diff --git a/packages/studio/src/player/components/useTimelineClipRenderWindow.ts b/packages/studio/src/player/components/useTimelineClipRenderWindow.ts
index 01522bd49e..808d02436e 100644
--- a/packages/studio/src/player/components/useTimelineClipRenderWindow.ts
+++ b/packages/studio/src/player/components/useTimelineClipRenderWindow.ts
@@ -14,7 +14,7 @@ interface UseTimelineClipRenderWindowInput {
   duration: number;
   selectedElementId?: string;
   draggedElementId?: string;
-  resizingElementId?: string;
+  resizingElementIds?: readonly string[];
   revealElementId?: string;
   focusedEaseElementId?: string;
   clipContextMenuElementId?: string;
@@ -34,7 +34,7 @@ export function useTimelineClipRenderWindow({
   duration,
   selectedElementId,
   draggedElementId,
-  resizingElementId,
+  resizingElementIds,
   revealElementId,
   focusedEaseElementId,
   clipContextMenuElementId,
@@ -56,7 +56,7 @@ export function useTimelineClipRenderWindow({
         [
           selectedElementId,
           draggedElementId,
-          resizingElementId,
+          ...(resizingElementIds ?? []),
           revealElementId,
           focusedEaseElementId,
           clipContextMenuElementId,
@@ -68,7 +68,7 @@ export function useTimelineClipRenderWindow({
       draggedElementId,
       focusedEaseElementId,
       keyframeContextMenuElementId,
-      resizingElementId,
+      resizingElementIds,
       revealElementId,
       selectedElementId,
     ],

From 1575a4f249e37c83d28a1dc3c83bd0d421fdbb15 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 18 Jul 2026 21:03:29 +0200
Subject: [PATCH 114/125] perf(studio): stabilize virtualized keyframe retiming

---
 .../components/TimelineClipDiamonds.test.tsx  | 267 +++++++++++-
 .../components/TimelineClipDiamonds.tsx       | 268 +++---------
 .../player/components/timelineDiamondTypes.ts |   6 +-
 .../useTimelineKeyframeHandlers.test.tsx      |   9 +-
 .../components/useTimelineKeyframeHandlers.ts | 399 +++++++++++++++++-
 5 files changed, 724 insertions(+), 225 deletions(-)

diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
index 14f1c18f82..ec56aedde9 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
@@ -3,6 +3,8 @@
 import React, { act } from "react";
 import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import { usePlayerStore } from "../store/playerStore";
 import { TimelineClipDiamonds, TimelineDiamondLane } from "./TimelineClipDiamonds";
 import { timelineKeyframeSelectionKey } from "./timelineKeyframeIdentity";
 
@@ -10,16 +12,36 @@ import { timelineKeyframeSelectionKey } from "./timelineKeyframeIdentity";
 
 afterEach(() => {
   document.body.innerHTML = "";
+  usePlayerStore.setState({ elements: [], timelineSessionEpoch: 0 });
 });
 
+const RETIME_ELEMENT: TimelineElement = {
+  id: "clip-1",
+  label: "Clip",
+  tag: "div",
+  start: 0,
+  duration: 10,
+  track: 0,
+};
+
 function pointerEvent(type: string, init: PointerEventInit): Event {
-  if (typeof PointerEvent === "function") return new PointerEvent(type, init);
-  return new MouseEvent(type, init);
+  const event =
+    typeof PointerEvent === "function" ? new PointerEvent(type, init) : new MouseEvent(type, init);
+  if (!("pointerId" in event)) {
+    Object.defineProperty(event, "pointerId", { value: init.pointerId ?? 0 });
+  }
+  return event;
 }
 
-function renderDiamonds(onClickKeyframe = vi.fn()) {
+function createTimelineHost() {
   const host = document.createElement("div");
+  host.setAttribute("data-timeline-scroll-viewport", "");
   document.body.append(host);
+  return host;
+}
+
+function renderDiamonds(onClickKeyframe = vi.fn()) {
+  const host = createTimelineHost();
   const root = createRoot(host);
   act(() => {
     root.render(
@@ -45,6 +67,59 @@ function renderDiamonds(onClickKeyframe = vi.fn()) {
   return { host, root, onClickKeyframe };
 }
 
+function renderRetimeLane(onMoveKeyframe = vi.fn().mockResolvedValue(true), strict = false) {
+  usePlayerStore.setState({ elements: [RETIME_ELEMENT] });
+  const host = createTimelineHost();
+  const root = createRoot(host);
+  const onClickKeyframe = vi.fn();
+  const lane = (
+    <TimelineDiamondLane
+      keyframesData={{
+        format: "percentage",
+        keyframes: [
+          {
+            percentage: 0,
+            tweenPercentage: 0,
+            propertyGroup: "position",
+            animationId: "anim-1",
+            properties: { x: 0 },
+          },
+          {
+            percentage: 50,
+            tweenPercentage: 50,
+            propertyGroup: "position",
+            animationId: "anim-1",
+            properties: { x: 100 },
+          },
+          {
+            percentage: 100,
+            tweenPercentage: 100,
+            propertyGroup: "position",
+            animationId: "anim-1",
+            properties: { x: 200 },
+          },
+        ],
+      }}
+      clipWidthPx={200}
+      clipHeightPx={48}
+      accentColor="#4ba3d2"
+      isSelected
+      currentPercentage={0}
+      elementId="clip-1"
+      selectedKeyframes={new Set()}
+      onClickKeyframe={onClickKeyframe}
+      onMoveKeyframe={onMoveKeyframe}
+      groupAware
+    />
+  );
+  act(() => {
+    root.render(strict ? <React.StrictMode>{lane}</React.StrictMode> : lane);
+  });
+  const diamond = host.querySelector<HTMLButtonElement>('button[title="50%"]');
+  expect(diamond).not.toBeNull();
+  return { diamond: diamond!, host, onClickKeyframe, onMoveKeyframe, root };
+}
+
 describe("TimelineClipDiamonds", () => {
   // Dense rows narrow the DIAMOND so neighbours stay individually readable, but
   // the hit box floors at KF_MIN_HIT_W — a gap-sized target gets unusable
@@ -85,6 +160,23 @@ describe("TimelineClipDiamonds", () => {
     act(() => root.unmount());
   });
 
+  it("publishes retime previews after StrictMode effect replay", () => {
+    const { diamond, host, root } = renderRetimeLane(undefined, true);
+    const initialLeft = diamond.style.left;
+    act(() => {
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 7 }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointermove", { bubbles: true, clientX: 120, pointerId: 7 }),
+      );
+    });
+    expect(host.querySelector<HTMLButtonElement>('button[title="50%"]')?.style.left).not.toBe(
+      initialLeft,
+    );
+    act(() => root.unmount());
+  });
+
   it("treats primary pointerup without drag as a keyframe click", () => {
     const { host, root, onClickKeyframe } = renderDiamonds();
     const diamond = host.querySelector<HTMLButtonElement>('button[title="50%"]');
@@ -169,8 +261,7 @@ describe("TimelineClipDiamonds", () => {
   it("treats a drag-armed press that resolves to a no-op move as a click", () => {
     const onClickKeyframe = vi.fn();
     const onMoveKeyframe = vi.fn();
-    const host = document.createElement("div");
-    document.body.append(host);
+    const host = createTimelineHost();
     const root = createRoot(host);
     act(() => {
       root.render(
@@ -237,8 +328,7 @@ describe("TimelineClipDiamonds", () => {
   it("reselects a retimed keyframe with its post-move tween percentage", () => {
     const onClickKeyframe = vi.fn();
     const onMoveKeyframe = vi.fn().mockResolvedValue(true);
-    const host = document.createElement("div");
-    document.body.append(host);
+    const host = createTimelineHost();
     const root = createRoot(host);
     act(() => {
       root.render(
@@ -312,8 +402,7 @@ describe("TimelineClipDiamonds", () => {
 
   it("composes a rapid second retime from the pending position", () => {
     const onMoveKeyframe = vi.fn().mockResolvedValue(true);
-    const host = document.createElement("div");
-    document.body.append(host);
+    const host = createTimelineHost();
     const root = createRoot(host);
     act(() => {
       root.render(
@@ -386,6 +475,19 @@ describe("TimelineClipDiamonds", () => {
       },
       85,
     );
+
+    act(() => {
+      usePlayerStore.setState({ timelineSessionEpoch: 1 });
+      diamond!.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100 }),
+      );
+      diamond!.dispatchEvent(pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120 }));
+    });
+    expect(onMoveKeyframe).toHaveBeenNthCalledWith(
+      3,
+      expect.objectContaining({ percentage: 50 }),
+      60,
+    );
     act(() => root.unmount());
   });
 
@@ -394,8 +496,7 @@ describe("TimelineClipDiamonds", () => {
     ["rejects", () => Promise.reject(new Error("retime failed"))],
   ])("clears a failed pending retime when the callback %s", async (_label, settle) => {
     const onMoveKeyframe = vi.fn().mockImplementationOnce(settle).mockResolvedValue(true);
-    const host = document.createElement("div");
-    document.body.append(host);
+    const host = createTimelineHost();
     const root = createRoot(host);
     act(() => {
       root.render(
@@ -516,6 +617,141 @@ describe("TimelineClipDiamonds", () => {
     act(() => root.unmount());
   });
 
+  it("commits once from the stable viewport after the source lane unmounts", () => {
+    const { diamond, onMoveKeyframe, root } = renderRetimeLane();
+
+    act(() => {
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 7 }),
+      );
+      root.unmount();
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120, pointerId: 7 }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 140, pointerId: 7 }),
+      );
+    });
+
+    expect(onMoveKeyframe).toHaveBeenCalledExactlyOnceWith(
+      {
+        percentage: 50,
+        tweenPercentage: 50,
+        propertyGroup: "position",
+        animationId: "anim-1",
+      },
+      60,
+    );
+  });
+
+  it("includes horizontal viewport scrolling in the retime destination", () => {
+    const { diamond, host, onMoveKeyframe, root } = renderRetimeLane();
+
+    act(() => {
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 7 }),
+      );
+      host.scrollLeft = 20;
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 100, pointerId: 7 }),
+      );
+    });
+
+    expect(onMoveKeyframe).toHaveBeenCalledExactlyOnceWith(expect.any(Object), 60);
+    act(() => root.unmount());
+  });
+
+  it("ignores another pointer and lets the owning pointer finish", () => {
+    const { diamond, onMoveKeyframe, root } = renderRetimeLane();
+
+    act(() => {
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 7 }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 140, pointerId: 8 }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120, pointerId: 7 }),
+      );
+    });
+
+    expect(onMoveKeyframe).toHaveBeenCalledOnce();
+    act(() => root.unmount());
+  });
+
+  it("cancels without mutation on pointer cancel or Escape and allows the next retime", () => {
+    const { diamond, onMoveKeyframe, root } = renderRetimeLane();
+
+    act(() => {
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 7 }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointercancel", {
+          bubbles: true,
+          button: 0,
+          clientX: 120,
+          pointerId: 7,
+        }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120, pointerId: 7 }),
+      );
+
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 9 }),
+      );
+      window.dispatchEvent(new KeyboardEvent("keydown", { bubbles: true, key: "Escape" }));
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120, pointerId: 9 }),
+      );
+
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 11 }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120, pointerId: 11 }),
+      );
+    });
+
+    expect(onMoveKeyframe).toHaveBeenCalledOnce();
+    act(() => root.unmount());
+  });
+
+  it("cancels on project switch or source removal without poisoning the next gesture", () => {
+    const { diamond, onMoveKeyframe, root } = renderRetimeLane();
+
+    act(() => {
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 7 }),
+      );
+      usePlayerStore.setState({ timelineSessionEpoch: 1 });
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120, pointerId: 7 }),
+      );
+
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 9 }),
+      );
+      usePlayerStore.setState({ elements: [] });
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120, pointerId: 9 }),
+      );
+
+      usePlayerStore.setState({ elements: [RETIME_ELEMENT] });
+      diamond.dispatchEvent(
+        pointerEvent("pointerdown", { bubbles: true, button: 0, clientX: 100, pointerId: 11 }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", { bubbles: true, button: 0, clientX: 120, pointerId: 11 }),
+      );
+    });
+
+    expect(onMoveKeyframe).toHaveBeenCalledOnce();
+    act(() => root.unmount());
+  });
+
   // Regression: onClickKeyframe's state updates can re-render the diamond
   // button out from under the gesture before the browser auto-synthesizes the
   // "click" event that follows a button's pointerdown+pointerup. That orphaned
@@ -525,8 +761,7 @@ describe("TimelineClipDiamonds", () => {
   // own clip. suppressClickRef lets that ancestor ignore the stray click.
   it("arms suppressClickRef synchronously on a keyframe click", () => {
     const suppressClickRef = { current: false };
-    const host = document.createElement("div");
-    document.body.append(host);
+    const host = createTimelineHost();
     const root = createRoot(host);
     act(() => {
       root.render(
@@ -559,8 +794,7 @@ describe("TimelineClipDiamonds", () => {
   });
 
   const renderSegmentLane = (lastAmbiguous: boolean) => {
-    const host = document.createElement("div");
-    document.body.append(host);
+    const host = createTimelineHost();
     const root = createRoot(host);
     const kf = (percentage: number, extra: Record<string, unknown> = {}) => ({
       percentage,
@@ -633,8 +867,7 @@ describe("TimelineClipDiamonds", () => {
   it("hides the inline ease button on a segment with no source animation id", () => {
     // A runtime-scanned keyframe has no animationId, so there is no tween to
     // target; the segment ending on it must not render a (dead) ease button.
-    const host = document.createElement("div");
-    document.body.append(host);
+    const host = createTimelineHost();
     const root = createRoot(host);
     const kf = (percentage: number, animationId?: string) => ({
       percentage,
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index 47e17b22d4..bb6b684fe6 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -1,20 +1,18 @@
 import { memo, useEffect, useRef, useState } from "react";
 import { BEAT_BAND_H } from "./BeatStrip";
-import {
-  KEYFRAME_DRAG_THRESHOLD_PX,
-  previewClipPct,
-  resolveKeyframeDrag,
-} from "../../components/editor/keyframeDrag";
 import { TimelineDiamondConnectors } from "./TimelineDiamondConnectors";
-import { clipToTweenPercentage } from "../../components/editor/KeyframeNavigation";
 import { LANE_H } from "./timelineLayout";
 import { timelineKeyframeSelectionKey } from "./timelineKeyframeIdentity";
+import {
+  beginTimelineKeyframeRetime,
+  readPendingTimelineKeyframeRetimes,
+  type TimelineKeyframeRetimeHandle,
+} from "./useTimelineKeyframeHandlers";
 import {
   DIAMOND_RATIO,
   KF_MAX_PCT,
   KF_MIN_PCT,
   keyframeTarget,
-  type DragState,
   type TimelineClipDiamondsProps,
   type TimelineDiamondKeyframe,
   type TimelineDiamondLaneProps,
@@ -54,62 +52,26 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   globalEase = "none",
 }: TimelineDiamondLaneProps) {
   // Hooks must run before the early return below.
-  const dragRef = useRef<DragState | null>(null);
-  // Pending retime destination (clip + tween %) per keyframe key, so a rapid
-  // second drag composes from where the first move left the keyframe (whose
-  // cache entry has not rebuilt yet) instead of the stale rendered value.
-  const pendingRetimeRef = useRef<Map<string, { clipPct: number; tweenPct: number }> | null>(null);
-  // Lazy: `useRef(new Map())` allocates a Map on every render and throws all but
-  // the first away, once per mounted lane.
-  pendingRetimeRef.current ??= new Map();
-  const pendingRetimes = pendingRetimeRef.current;
+  // The retime itself lives on the stable scroll viewport (beginTimelineKeyframeRetime),
+  // so a row unmounted by virtualization mid-drag does not drop the gesture.
+  // This lane only arms it and renders the preview it publishes.
+  const rootRef = useRef<HTMLDivElement>(null);
+  const mountedRef = useRef(true);
+  const retimeHandleRef = useRef<TimelineKeyframeRetimeHandle | null>(null);
   useEffect(() => {
-    // Clear a pending entry once the authoritative cache reflects THAT keyframe
-    // at ~its destination. Match by tolerance, not equality: cache writers round
-    // clip %s, so an exact check would leak an entry after every successful
-    // retime. Match by identity too: a bare "some keyframe is near that %" test
-    // cleared the entry whenever an unrelated sibling happened to sit there,
-    // which is easy to hit on an evenly spaced row.
-    const pendingEntries = pendingRetimeRef.current;
-    if (!pendingEntries) return;
-    for (const [key, pending] of pendingEntries) {
-      const settled = keyframesData.keyframes.some(
-        (k) =>
-          timelineKeyframeSelectionKey(elementId, keyframeTarget(k)) === key &&
-          Math.abs(k.percentage - pending.clipPct) < 0.2,
-      );
-      if (settled) pendingEntries.delete(key);
-    }
-  }, [keyframesData.keyframes, elementId]);
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+  // Retime destinations already dispatched but not yet in the keyframe cache, so
+  // a rapid second drag composes from where the first move left the keyframe
+  // instead of the stale rendered value.
+  const pendingRetimes = readPendingTimelineKeyframeRetimes(rootRef.current);
   // Visual-only preview of the dragged diamond's clip-% — no runtime/GSAP hold
   // (that optimistic hold was the #1763 flake). The atomic move-keyframe commit
   // on drop re-keys the diamond from source.
   const [preview, setPreview] = useState<{ kfKey: string; clipPct: number } | null>(null);
-  // One preview render per frame: a 120Hz trackpad fires pointermove far faster
-  // than the lane can repaint, and every diamond in the row re-evaluates its
-  // memo on each of those renders.
-  const previewFrameRef = useRef<number | null>(null);
-  const cancelPreviewFrame = () => {
-    if (previewFrameRef.current === null) return;
-    cancelAnimationFrame(previewFrameRef.current);
-    previewFrameRef.current = null;
-  };
-  // Escape backs out of an in-flight retime, the way clip and element drags
-  // already do. Nothing was written yet (the commit happens on pointerup), so
-  // dropping the preview is the whole undo.
-  useEffect(() => {
-    const onKeyDown = (event: KeyboardEvent) => {
-      if (event.key !== "Escape" || !dragRef.current || dragRef.current.cancelled) return;
-      dragRef.current.cancelled = true;
-      cancelPreviewFrame();
-      setPreview(null);
-    };
-    document.addEventListener("keydown", onKeyDown);
-    return () => {
-      document.removeEventListener("keydown", onKeyDown);
-      cancelPreviewFrame();
-    };
-  }, []);
   // The button element can re-render (reposition/unmount) synchronously from
   // the state updates onClickKeyframe/onMoveKeyframe trigger, before the
   // browser gets to auto-synthesize the "click" event that normally follows
@@ -157,7 +119,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   // O(keyframes squared) allocations on every playhead tick.
   const pendingClipPctOf = (keyframe: TimelineDiamondKeyframe) =>
     pendingRetimes.get(timelineKeyframeSelectionKey(elementId, keyframeTarget(keyframe)))
-      ?.clipPct ?? keyframe.percentage;
+      ?.clipPercentage ?? keyframe.percentage;
   const siblingRows = new Map<
     string | undefined,
     { keyframes: TimelineDiamondKeyframe[]; clipPcts: number[] }
@@ -197,6 +159,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
 
   return (
     <div
+      ref={rootRef}
       className="absolute inset-0"
       style={{
         // Above the clip's trim-handle strips (TimelineClip.tsx, z-index 4) so
@@ -244,144 +207,47 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         const onPointerDown = (e: React.PointerEvent<HTMLButtonElement>) => {
           if (e.button !== 0) return;
           e.stopPropagation();
-          if (canDrag) {
-            e.currentTarget.setPointerCapture?.(e.pointerId);
-            dragRef.current = {
-              kfKey,
-              startX: e.clientX,
-              lastX: e.clientX,
-              index: siblingIndex,
-              fromClipPct: pendingRetimes.get(kfKey)?.clipPct ?? kf.percentage,
-              moved: false,
-            };
-          }
-        };
-        const onPointerMove = (e: React.PointerEvent<HTMLButtonElement>) => {
-          const d = dragRef.current;
-          if (!d || d.kfKey !== kfKey || d.cancelled) return;
-          d.lastX = e.clientX;
-          if (!d.moved && Math.abs(e.clientX - d.startX) >= KEYFRAME_DRAG_THRESHOLD_PX) {
-            d.moved = true;
-          }
-          if (!d.moved || previewFrameRef.current !== null) return;
-          previewFrameRef.current = requestAnimationFrame(() => {
-            previewFrameRef.current = null;
-            const live = dragRef.current;
-            if (!live || live.kfKey !== kfKey || live.cancelled) return;
-            setPreview({
-              kfKey,
-              clipPct: previewClipPct({
-                pointerDownX: live.startX,
-                pointerMoveX: live.lastX,
-                clipWidthPx,
-                draggedClipPct: live.fromClipPct,
-                draggedIndex: live.index,
-                sortedClipPcts: siblingClipPcts,
-              }),
-            });
+          if (!canDrag) return;
+          retimeHandleRef.current = beginTimelineKeyframeRetime({
+            event: e,
+            elementId,
+            keyframeKey: kfKey,
+            target,
+            keyframes: keyframesData.keyframes,
+            clipWidthPx,
+            // Clamp against this keyframe's own tween, not the whole merged row:
+            // a merged row interleaves several animations, and two colliding at
+            // one percentage would otherwise pin each other's diamonds in place.
+            draggedIndex: siblingIndex,
+            sortedClipPercentages: siblingClipPcts,
+            keyframeKeyOf: (keyframe) =>
+              timelineKeyframeSelectionKey(elementId, keyframeTarget(keyframe)),
+            onPreview: (clipPercentage) => {
+              if (!mountedRef.current) return;
+              setPreview(clipPercentage === null ? null : { kfKey, clipPct: clipPercentage });
+            },
+            onMove: (fromTarget, toClipPercentage) =>
+              onMoveKeyframe?.(fromTarget, toClipPercentage) ?? Promise.resolve(false),
+            onSelect: (nextTarget, additive) => {
+              if (additive) onShiftClickKeyframe?.(nextTarget);
+              else onClickKeyframe?.(nextTarget);
+            },
+            suppressNextClick,
           });
         };
         const onPointerUp = (e: React.PointerEvent<HTMLButtonElement>) => {
-          const d = dragRef.current;
-          if (d?.kfKey === kfKey && d.cancelled) {
-            // Escape already ended this drag; the release is not a click.
-            dragRef.current = null;
-            e.currentTarget.releasePointerCapture?.(e.pointerId);
-            suppressNextClick();
-            return;
-          }
-          // No drag armed (canDrag false / non-primary press) → treat as a click.
-          if (!d || d.kfKey !== kfKey) {
-            if (e.button !== 0) return;
-            suppressNextClick();
-            if (e.shiftKey) onShiftClickKeyframe?.(target);
-            else onClickKeyframe?.(target);
+          // The viewport coordinator owns an armed retime; this local path is
+          // only for diamonds that cannot be dragged.
+          if (canDrag) {
+            retimeHandleRef.current?.commit(e);
+            retimeHandleRef.current = null;
+            e.stopPropagation();
             return;
           }
-          e.stopPropagation();
-          dragRef.current = null;
-          cancelPreviewFrame();
-          setPreview(null);
-          e.currentTarget.releasePointerCapture?.(e.pointerId);
+          if (e.button !== 0) return;
           suppressNextClick();
-          // Single-diamond retime by design: a multi-select drag would have to
-          // move every selected keyframe as one mutation, which the script ops
-          // do not express yet. Selecting several and dragging one moves only
-          // the dragged one.
-          const res = resolveKeyframeDrag({
-            pointerDownX: d.startX,
-            pointerUpX: e.clientX,
-            clipWidthPx,
-            draggedClipPct: d.fromClipPct,
-            draggedIndex: siblingIndex,
-            sortedClipPcts: siblingClipPcts,
-          });
-          if (res.kind === "click" || res.kind === "noop") {
-            // "noop" is a press with enough pointer jitter to arm a drag (canDrag
-            // is on for every diamond once the clip is selected) that resolved
-            // back onto ~the same position — no real retime, so treat it as the
-            // click it was. Otherwise a normal click with a few px of mouse/
-            // trackpad drift silently does nothing: no selection, no move.
-            if (e.shiftKey) onShiftClickKeyframe?.(target);
-            else onClickKeyframe?.(target);
-          } else if (res.kind === "move" && res.toClipPct != null) {
-            const animKfs =
-              target.animationId === undefined
-                ? keyframesData.keyframes
-                : keyframesData.keyframes.filter((k) => k.animationId === target.animationId);
-            // Clamp to the mapped tween range: clipToTweenPercentage extrapolates
-            // linearly, so a boundary drag past the range would otherwise reselect
-            // an out-of-range tween % (e.g. 150%) even though the mutation clamps
-            // the moved endpoint back to the boundary.
-            const tweenPcts = animKfs
-              .map((k) => k.tweenPercentage)
-              .filter((v): v is number => typeof v === "number");
-            const clampTween = (v: number) =>
-              tweenPcts.length
-                ? Math.max(Math.min(...tweenPcts), Math.min(Math.max(...tweenPcts), v))
-                : v;
-            const newTweenPct = clampTween(clipToTweenPercentage(animKfs, res.toClipPct));
-            // For a rapid second retime the diamond still renders the stale cache
-            // position, so identify the FROM keyframe by the pending (already-moved)
-            // position; the mutation locates the source keyframe by this identity.
-            const pendingBefore = pendingRetimes.get(kfKey);
-            const fromTarget = pendingBefore
-              ? {
-                  ...target,
-                  percentage: pendingBefore.clipPct,
-                  tweenPercentage: pendingBefore.tweenPct,
-                }
-              : target;
-            const pending = { clipPct: res.toClipPct, tweenPct: newTweenPct };
-            pendingRetimes.set(kfKey, pending);
-            const clearPending = () => {
-              if (pendingRetimes.get(kfKey) === pending) {
-                pendingRetimes.delete(kfKey);
-              }
-            };
-            // A rejected drop (the destination time is already occupied) snaps
-            // the diamond back to its source position, so the pending entry AND
-            // the selection have to revert with it — parking on the ghost drop
-            // position strands the playhead + selection on a keyframe that does
-            // not exist there.
-            const revertRetime = () => {
-              clearPending();
-              onClickKeyframe?.(fromTarget);
-            };
-            void onMoveKeyframe?.(fromTarget, res.toClipPct).then((committed) => {
-              if (!committed) revertRetime();
-            }, revertRetime);
-            // A retime still targeted this exact diamond — park/select it at its
-            // new position, same as a plain click, or a drag that actually moved
-            // something looks identical to one that silently did nothing. Done
-            // optimistically so the gesture stays responsive; revertRetime puts
-            // it back if the move is rejected.
-            onClickKeyframe?.({
-              ...target,
-              percentage: res.toClipPct,
-              tweenPercentage: newTweenPct,
-            });
-          }
+          if (e.shiftKey) onShiftClickKeyframe?.(target);
+          else onClickKeyframe?.(target);
         };
 
         return (
@@ -412,18 +278,16 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               overflow: "visible",
             }}
             onPointerDown={onPointerDown}
-            onPointerMove={onPointerMove}
+            onPointerMove={canDrag ? (e) => retimeHandleRef.current?.update(e) : undefined}
             onPointerUp={onPointerUp}
-            onPointerCancel={(e) => {
-              // Browser/OS cancellation (or lost capture) ends the drag without a
-              // pointerup, so clear the armed drag and preview or a ghost diamond
-              // stays stuck at the last previewed position.
-              if (dragRef.current?.kfKey !== kfKey) return;
-              dragRef.current = null;
-              cancelPreviewFrame();
-              setPreview(null);
-              e.currentTarget.releasePointerCapture?.(e.pointerId);
-            }}
+            onPointerCancel={
+              canDrag
+                ? (e) => {
+                    retimeHandleRef.current?.cancel(e);
+                    retimeHandleRef.current = null;
+                  }
+                : undefined
+            }
             onContextMenu={(e) => {
               e.preventDefault();
               e.stopPropagation();
diff --git a/packages/studio/src/player/components/timelineDiamondTypes.ts b/packages/studio/src/player/components/timelineDiamondTypes.ts
index 0e3c34bc0a..9b2fedab1f 100644
--- a/packages/studio/src/player/components/timelineDiamondTypes.ts
+++ b/packages/studio/src/player/components/timelineDiamondTypes.ts
@@ -110,7 +110,11 @@ export type DragState = {
  * the other, and would strip the animation id the retime/delete mutations use to
  * pick between two animations that collide at one percentage.
  */
-export function keyframeTarget(keyframe: TimelineDiamondKeyframe): TimelineKeyframeTarget {
+export function keyframeTarget(
+  // The identity fields only, so callers holding a narrower keyframe row (the
+  // retime coordinator's) build the same key instead of re-listing the shape.
+  keyframe: Omit<TimelineDiamondKeyframe, "properties">,
+): TimelineKeyframeTarget {
   return {
     percentage: keyframe.percentage,
     tweenPercentage: keyframe.tweenPercentage,
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
index 4dcee4bad5..f1060933a8 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
@@ -5,14 +5,12 @@ import { afterEach, describe, expect, it, vi } from "vitest";
 import { mountReactHarness } from "../../hooks/domSelectionTestHarness";
 import type { TimelineElement } from "../store/playerStore";
 import { usePlayerStore } from "../store/playerStore";
+import * as telemetry from "../../telemetry/events";
 import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
 import { useTimelineKeyframeHandlers } from "./useTimelineKeyframeHandlers";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
-const trackStudioSegmentEaseEdit = vi.hoisted(() => vi.fn());
-vi.mock("../../telemetry/events", () => ({ trackStudioSegmentEaseEdit }));
-
 const ELEMENT: TimelineElement = {
   id: "clip-1",
   label: "Hero card",
@@ -46,12 +44,15 @@ const COLLIDING_TARGET: TimelineKeyframeTarget = {
 
 afterEach(() => {
   document.body.innerHTML = "";
-  trackStudioSegmentEaseEdit.mockClear();
+  vi.restoreAllMocks();
   usePlayerStore.setState({ focusedEaseSegment: null });
 });
 
 describe("useTimelineKeyframeHandlers", () => {
   it("tracks opening the segment ease editor when a timeline segment is selected", () => {
+    const trackStudioSegmentEaseEdit = vi
+      .spyOn(telemetry, "trackStudioSegmentEaseEdit")
+      .mockImplementation(() => {});
     let onSelectSegment: ((elementId: string, target: TimelineKeyframeTarget) => void) | undefined;
 
     function Harness() {
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
index 657aac930a..270b17f697 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
@@ -1,13 +1,410 @@
-import { useCallback, type MouseEvent as ReactMouseEvent } from "react";
+import {
+  useCallback,
+  type MouseEvent as ReactMouseEvent,
+  type PointerEvent as ReactPointerEvent,
+} from "react";
+import { clipToTweenPercentage } from "../../components/editor/KeyframeNavigation";
+import {
+  KEYFRAME_DRAG_THRESHOLD_PX,
+  previewClipPct,
+  resolveKeyframeDrag,
+} from "../../components/editor/keyframeDrag";
 import { trackStudioSegmentEaseEdit } from "../../telemetry/events";
+import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 import type { TimelineElement, KeyframeCacheEntry } from "../store/playerStore";
 import { usePlayerStore } from "../store/playerStore";
 import type { KeyframeDiamondContextMenuState } from "./KeyframeDiamondContextMenu";
+import {
+  applyTimelineAutoScrollStep,
+  resolveTimelineAutoScrollLoopAction,
+} from "./timelineEditing";
 import {
   timelineKeyframeSelectionKey,
   type TimelineKeyframeTarget,
 } from "./timelineKeyframeIdentity";
 
+interface TimelineRetimeKeyframe {
+  percentage: number;
+  tweenPercentage?: number;
+  propertyGroup?: string;
+  animationId?: string;
+  collidingAnimationTargets?: AnimationKeyframeTarget[];
+}
+
+interface TimelineKeyframeRetimeInput {
+  event: ReactPointerEvent<HTMLElement>;
+  elementId: string;
+  keyframeKey: string;
+  target: TimelineKeyframeTarget;
+  keyframes: readonly TimelineRetimeKeyframe[];
+  clipWidthPx: number;
+  draggedIndex: number;
+  sortedClipPercentages: readonly number[];
+  onPreview: (clipPercentage: number | null) => void;
+  onMove: (target: TimelineKeyframeTarget, toClipPercentage: number) => Promise<boolean>;
+  onSelect: (target: TimelineKeyframeTarget, additive: boolean) => void;
+  suppressNextClick: () => void;
+  /**
+   * Selection key of a cache keyframe, used to retire a pending entry once the
+   * authoritative cache reflects THAT keyframe at its destination. Without it a
+   * bare "some keyframe is near that %" test retires the entry whenever an
+   * unrelated sibling happens to sit there, which is easy to hit on an evenly
+   * spaced row.
+   */
+  keyframeKeyOf: (keyframe: TimelineRetimeKeyframe) => string;
+}
+
+interface PendingTimelineKeyframeRetime {
+  elementId: string;
+  clipPercentage: number;
+  tweenPercentage: number;
+  sessionEpoch: number;
+}
+
+interface TimelineKeyframeRetimeActor extends TimelineKeyframeRetimeInput {
+  phase: "active" | "committing" | "cancelled" | "complete";
+  pointerId: number | null;
+  pointerDownX: number;
+  lastClientX: number;
+  lastClientY: number;
+  originScrollLeft: number;
+  fromClipPercentage: number;
+  moved: boolean;
+  sessionEpoch: number;
+  sourceWasPresent: boolean;
+  scrollRaf: number;
+  unsubscribeStore: (() => void) | null;
+  teardownListeners: (() => void) | null;
+}
+
+interface TimelineKeyframeRetimeCoordinator {
+  actor: TimelineKeyframeRetimeActor | null;
+  pending: Map<string, PendingTimelineKeyframeRetime>;
+}
+
+type TimelineRetimePointerEvent = Pick<
+  PointerEvent,
+  "clientX" | "clientY" | "pointerId" | "shiftKey"
+>;
+
+const keyframeRetimeCoordinators = new WeakMap<EventTarget, TimelineKeyframeRetimeCoordinator>();
+
+function getRetimeOwner(target: HTMLElement): EventTarget {
+  return target.closest<HTMLElement>("[data-timeline-scroll-viewport]") ?? target.ownerDocument;
+}
+
+function getRetimeCoordinator(owner: EventTarget): TimelineKeyframeRetimeCoordinator {
+  const existing = keyframeRetimeCoordinators.get(owner);
+  if (existing) return existing;
+  const coordinator: TimelineKeyframeRetimeCoordinator = { actor: null, pending: new Map() };
+  keyframeRetimeCoordinators.set(owner, coordinator);
+  return coordinator;
+}
+
+function stablePointerId(pointerId: number): number | null {
+  return Number.isFinite(pointerId) ? pointerId : null;
+}
+
+/**
+ * The retime destinations already dispatched from `source`'s viewport but not
+ * yet reflected in the keyframe cache. A renderer clamping a drag against its
+ * neighbours has to compose these in, or a second drag can cross a neighbour
+ * that already moved past it.
+ */
+export function readPendingTimelineKeyframeRetimes(
+  source: HTMLElement | null | undefined,
+): ReadonlyMap<string, { clipPercentage: number; tweenPercentage: number }> {
+  if (!source) return EMPTY_PENDING_RETIMES;
+  return keyframeRetimeCoordinators.get(getRetimeOwner(source))?.pending ?? EMPTY_PENDING_RETIMES;
+}
+
+const EMPTY_PENDING_RETIMES: ReadonlyMap<
+  string,
+  { clipPercentage: number; tweenPercentage: number }
+> = new Map();
+
+export interface TimelineKeyframeRetimeHandle {
+  update: (event: ReactPointerEvent<HTMLElement>) => void;
+  commit: (event: ReactPointerEvent<HTMLElement>) => void;
+  cancel: (event: ReactPointerEvent<HTMLElement>) => void;
+}
+
+/**
+ * Starts a keyframe retime on the stable timeline viewport. The row/button is
+ * only an entry point: window listeners own the gesture through virtualization.
+ */
+export function beginTimelineKeyframeRetime(
+  input: TimelineKeyframeRetimeInput,
+): TimelineKeyframeRetimeHandle {
+  const source = input.event.currentTarget;
+  const owner = getRetimeOwner(source);
+  const viewport = owner instanceof HTMLElement ? owner : null;
+  const coordinator = getRetimeCoordinator(owner);
+  const sessionEpoch = usePlayerStore.getState().timelineSessionEpoch;
+
+  const cancel = (actor: TimelineKeyframeRetimeActor) => {
+    if (actor.phase !== "active") return;
+    actor.phase = "cancelled";
+    actor.onPreview(null);
+    if (actor.scrollRaf) cancelAnimationFrame(actor.scrollRaf);
+    actor.unsubscribeStore?.();
+    actor.teardownListeners?.();
+    if (viewport && actor.pointerId !== null) {
+      try {
+        viewport.releasePointerCapture(actor.pointerId);
+      } catch {
+        // Window listeners remain the native fallback when capture is unavailable.
+      }
+    }
+    if (coordinator.actor === actor) {
+      coordinator.actor = null;
+    }
+    actor.phase = "complete";
+  };
+
+  if (coordinator.actor) cancel(coordinator.actor);
+
+  for (const [key, pending] of coordinator.pending) {
+    if (pending.sessionEpoch !== sessionEpoch) coordinator.pending.delete(key);
+  }
+
+  for (const [key, pending] of coordinator.pending) {
+    // Tolerance, not equality: cache writers round clip %s, so an exact check
+    // would leak an entry after every successful retime.
+    if (
+      pending.elementId === input.elementId &&
+      input.keyframes.some(
+        (keyframe) =>
+          input.keyframeKeyOf(keyframe) === key &&
+          Math.abs(keyframe.percentage - pending.clipPercentage) < 0.2,
+      )
+    ) {
+      coordinator.pending.delete(key);
+    }
+  }
+
+  const pending = coordinator.pending.get(input.keyframeKey);
+  const actor: TimelineKeyframeRetimeActor = {
+    ...input,
+    phase: "active",
+    pointerId: stablePointerId(input.event.pointerId),
+    pointerDownX: input.event.clientX,
+    lastClientX: input.event.clientX,
+    lastClientY: input.event.clientY,
+    originScrollLeft: viewport?.scrollLeft ?? 0,
+    fromClipPercentage: pending?.clipPercentage ?? input.target.percentage,
+    moved: false,
+    sessionEpoch,
+    sourceWasPresent: usePlayerStore
+      .getState()
+      .elements.some((element) => (element.key ?? element.id) === input.elementId),
+    scrollRaf: 0,
+    unsubscribeStore: null,
+    teardownListeners: null,
+  };
+  coordinator.actor = actor;
+
+  const matchesPointer = (event: TimelineRetimePointerEvent) =>
+    actor.pointerId === null || event.pointerId === actor.pointerId;
+  const pointerXWithScroll = () =>
+    actor.lastClientX + (viewport?.scrollLeft ?? 0) - actor.originScrollLeft;
+  const publishPreview = () => {
+    actor.onPreview(
+      previewClipPct({
+        pointerDownX: actor.pointerDownX,
+        pointerMoveX: pointerXWithScroll(),
+        clipWidthPx: actor.clipWidthPx,
+        draggedClipPct: actor.fromClipPercentage,
+        draggedIndex: actor.draggedIndex,
+        sortedClipPcts: actor.sortedClipPercentages,
+      }),
+    );
+  };
+  const stopAutoScroll = () => {
+    if (actor.scrollRaf) cancelAnimationFrame(actor.scrollRaf);
+    actor.scrollRaf = 0;
+  };
+  const stepAutoScroll = () => {
+    actor.scrollRaf = 0;
+    if (
+      actor.phase !== "active" ||
+      !viewport ||
+      !applyTimelineAutoScrollStep(viewport, actor.lastClientX, actor.lastClientY)
+    ) {
+      return;
+    }
+    publishPreview();
+    actor.scrollRaf = requestAnimationFrame(stepAutoScroll);
+  };
+  const syncAutoScroll = () => {
+    if (!viewport || !actor.moved) return;
+    const action = resolveTimelineAutoScrollLoopAction(
+      viewport,
+      actor.lastClientX,
+      actor.lastClientY,
+      actor.scrollRaf !== 0,
+    );
+    if (action === "stop") stopAutoScroll();
+    else if (action === "start") actor.scrollRaf = requestAnimationFrame(stepAutoScroll);
+  };
+  const teardown = () => {
+    stopAutoScroll();
+    actor.unsubscribeStore?.();
+    actor.unsubscribeStore = null;
+    actor.teardownListeners?.();
+    actor.teardownListeners = null;
+  };
+  const releaseCapture = () => {
+    if (!viewport || actor.pointerId === null) return;
+    try {
+      viewport.releasePointerCapture(actor.pointerId);
+    } catch {
+      // Capture may already have been released by the browser.
+    }
+  };
+  const finishCommit = (event: TimelineRetimePointerEvent) => {
+    if (actor.phase !== "active" || !matchesPointer(event)) return;
+    if (actor.sessionEpoch !== usePlayerStore.getState().timelineSessionEpoch) {
+      cancel(actor);
+      return;
+    }
+    actor.phase = "committing";
+    actor.lastClientX = event.clientX;
+    actor.lastClientY = event.clientY;
+    teardown();
+    releaseCapture();
+    actor.onPreview(null);
+    if (coordinator.actor === actor) {
+      coordinator.actor = null;
+    }
+    actor.suppressNextClick();
+
+    const result = resolveKeyframeDrag({
+      pointerDownX: actor.pointerDownX,
+      pointerUpX: pointerXWithScroll(),
+      clipWidthPx: actor.clipWidthPx,
+      draggedClipPct: actor.fromClipPercentage,
+      draggedIndex: actor.draggedIndex,
+      sortedClipPcts: actor.sortedClipPercentages,
+    });
+    if (result.kind === "click" || result.kind === "noop") {
+      actor.onSelect(actor.target, event.shiftKey);
+    } else if (result.kind === "move" && result.toClipPct !== undefined) {
+      const animationKeyframes =
+        actor.target.animationId === undefined
+          ? actor.keyframes
+          : actor.keyframes.filter((keyframe) => keyframe.animationId === actor.target.animationId);
+      const tweenPercentages = animationKeyframes
+        .map((keyframe) => keyframe.tweenPercentage)
+        .filter((value): value is number => typeof value === "number");
+      const mappedTweenPercentage = clipToTweenPercentage(animationKeyframes, result.toClipPct);
+      const newTweenPercentage = tweenPercentages.length
+        ? Math.max(
+            Math.min(...tweenPercentages),
+            Math.min(Math.max(...tweenPercentages), mappedTweenPercentage),
+          )
+        : mappedTweenPercentage;
+      const pendingBefore = coordinator.pending.get(actor.keyframeKey);
+      const fromTarget = pendingBefore
+        ? {
+            ...actor.target,
+            percentage: pendingBefore.clipPercentage,
+            tweenPercentage: pendingBefore.tweenPercentage,
+          }
+        : actor.target;
+      const nextPending = {
+        elementId: actor.elementId,
+        clipPercentage: result.toClipPct,
+        tweenPercentage: newTweenPercentage,
+        sessionEpoch: actor.sessionEpoch,
+      };
+      coordinator.pending.set(actor.keyframeKey, nextPending);
+      const clearPending = () => {
+        if (coordinator.pending.get(actor.keyframeKey) === nextPending) {
+          coordinator.pending.delete(actor.keyframeKey);
+        }
+      };
+      // A rejected drop (the destination time is already occupied) snaps the
+      // diamond back to its source position, so the pending entry AND the
+      // selection have to revert with it: parking on the ghost drop position
+      // strands the playhead + selection on a keyframe that is not there.
+      const revertRetime = () => {
+        clearPending();
+        actor.onSelect(fromTarget, false);
+      };
+      void actor.onMove(fromTarget, result.toClipPct).then((committed) => {
+        if (!committed) revertRetime();
+      }, revertRetime);
+      actor.onSelect(
+        {
+          ...actor.target,
+          percentage: result.toClipPct,
+          tweenPercentage: newTweenPercentage,
+        },
+        false,
+      );
+    }
+    actor.phase = "complete";
+  };
+  const onPointerMove = (event: TimelineRetimePointerEvent) => {
+    if (actor.phase !== "active" || !matchesPointer(event)) return;
+    actor.lastClientX = event.clientX;
+    actor.lastClientY = event.clientY;
+    if (
+      !actor.moved &&
+      Math.abs(pointerXWithScroll() - actor.pointerDownX) >= KEYFRAME_DRAG_THRESHOLD_PX
+    ) {
+      actor.moved = true;
+    }
+    if (actor.moved) publishPreview();
+    syncAutoScroll();
+  };
+  const onPointerUp = (event: TimelineRetimePointerEvent) => finishCommit(event);
+  const onPointerCancel = (event: TimelineRetimePointerEvent) => {
+    if (actor.phase === "active" && matchesPointer(event)) cancel(actor);
+  };
+  const onLostPointerCapture = (event: PointerEvent) => {
+    if (actor.phase === "active" && matchesPointer(event)) cancel(actor);
+  };
+  const onKeyDown = (event: KeyboardEvent) => {
+    if (event.key === "Escape") cancel(actor);
+  };
+
+  window.addEventListener("pointermove", onPointerMove, true);
+  window.addEventListener("pointerup", onPointerUp, true);
+  window.addEventListener("pointercancel", onPointerCancel, true);
+  window.addEventListener("keydown", onKeyDown);
+  viewport?.addEventListener("lostpointercapture", onLostPointerCapture);
+  actor.teardownListeners = () => {
+    window.removeEventListener("pointermove", onPointerMove, true);
+    window.removeEventListener("pointerup", onPointerUp, true);
+    window.removeEventListener("pointercancel", onPointerCancel, true);
+    window.removeEventListener("keydown", onKeyDown);
+    viewport?.removeEventListener("lostpointercapture", onLostPointerCapture);
+  };
+  actor.unsubscribeStore = usePlayerStore.subscribe((state) => {
+    const sourceStillPresent = state.elements.some(
+      (element) => (element.key ?? element.id) === actor.elementId,
+    );
+    if (
+      state.timelineSessionEpoch !== actor.sessionEpoch ||
+      (actor.sourceWasPresent && !sourceStillPresent)
+    ) {
+      coordinator.pending.clear();
+      cancel(actor);
+    }
+  });
+
+  if (viewport && actor.pointerId !== null) {
+    try {
+      viewport.setPointerCapture(actor.pointerId);
+    } catch {
+      // Window listeners are the native fallback when capture is unavailable.
+    }
+  }
+  return { update: onPointerMove, commit: onPointerUp, cancel: onPointerCancel };
+}
+
 interface UseTimelineKeyframeHandlersInput {
   expandedElements: TimelineElement[];
   keyframeCache: Map<string, KeyframeCacheEntry>;

From 41c39e139129e43e35402b58f6dd28944a93c3f9 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 18 Jul 2026 21:12:39 +0200
Subject: [PATCH 115/125] perf(studio): stabilize virtualized timeline drops

---
 .../studio/src/player/components/Timeline.tsx |  42 ++---
 .../components/timelineDragDrop.test.tsx      | 163 ++++++++++++++++++
 .../src/player/components/timelineDragDrop.ts | 162 ++++++++++++++---
 3 files changed, 322 insertions(+), 45 deletions(-)
 create mode 100644 packages/studio/src/player/components/timelineDragDrop.test.tsx

diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index c0c56b5ab5..0d0707b4b6 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -266,19 +266,19 @@ export const Timeline = memo(function Timeline({
     sessionEpoch,
   });
 
-  const { isDragOver, handleAssetDragOver, handleAssetDrop, clearDropPreview } =
-    useTimelineAssetDrop({
-      scrollRef,
-      ppsRef,
-      durationRef,
-      trackOrderRef,
-      rowGeometryRef,
-      contentOrigin,
-      onFileDrop: pinnedOnFileDrop,
-      onAssetDrop: pinnedOnAssetDrop,
-      onBlockDrop: pinnedOnBlockDrop,
-      onCompositionDrop: pinnedOnCompositionDrop,
-    });
+  const assetDrop = useTimelineAssetDrop({
+    scrollRef,
+    ppsRef,
+    durationRef,
+    trackOrderRef,
+    rowGeometryRef,
+    contentOrigin,
+    onFileDrop: pinnedOnFileDrop,
+    onAssetDrop: pinnedOnAssetDrop,
+    onBlockDrop: pinnedOnBlockDrop,
+    onCompositionDrop: pinnedOnCompositionDrop,
+    sessionEpoch,
+  });
 
   const displayLayout = useTimelineDisplayLayout(draggedClip, trackOrder, rowGeometry);
   const { viewport, showShortcutHint, setScrollRef, syncScrollViewport } =
@@ -447,11 +447,11 @@ export const Timeline = memo(function Timeline({
   if (!timelineReady || expandedElements.length === 0) {
     return (
       <TimelineEmptyState
-        isDragOver={isDragOver}
+        isDragOver={assetDrop.isDragOver}
         onFileDrop={!!onFileDrop}
-        onDragOver={handleAssetDragOver}
-        onDragLeave={() => clearDropPreview()}
-        onDrop={handleAssetDrop}
+        onDragOver={assetDrop.handleAssetDragOver}
+        onDragLeave={assetDrop.handleAssetDragLeave}
+        onDrop={assetDrop.handleAssetDrop}
       />
     );
   }
@@ -461,7 +461,7 @@ export const Timeline = memo(function Timeline({
       ref={setContainerRef}
       aria-label="Timeline"
       data-timeline-element-count={expandedElements.length}
-      className={`relative border-t select-none h-full overflow-hidden ${isDragOver ? "ring-1 ring-inset ring-studio-accent/60" : ""} ${activeTool === "razor" ? "cursor-crosshair" : shiftHeld ? "cursor-crosshair" : "cursor-default"}`}
+      className={`relative border-t select-none h-full overflow-hidden ${assetDrop.isDragOver ? "ring-1 ring-inset ring-studio-accent/60" : ""} ${activeTool === "razor" ? "cursor-crosshair" : shiftHeld ? "cursor-crosshair" : "cursor-default"}`}
       onMouseMove={updateRazorGuide}
       onMouseLeave={clearRazorGuide}
       style={{
@@ -480,9 +480,9 @@ export const Timeline = memo(function Timeline({
           lastScrollLeftRef.current = e.currentTarget.scrollLeft; // restored across post-edit reload
           syncScrollViewport(e.currentTarget, true);
         }}
-        onDragOver={handleAssetDragOver}
-        onDragLeave={() => clearDropPreview()}
-        onDrop={handleAssetDrop}
+        onDragOver={assetDrop.handleAssetDragOver}
+        onDragLeave={assetDrop.handleAssetDragLeave}
+        onDrop={assetDrop.handleAssetDrop}
         onPointerDown={(e) => {
           // Let interactive controls (keyframe nav/toggle, caret, inputs) handle
           // their own clicks — scrubbing here would preventDefault and eat them.
diff --git a/packages/studio/src/player/components/timelineDragDrop.test.tsx b/packages/studio/src/player/components/timelineDragDrop.test.tsx
new file mode 100644
index 0000000000..63d0f0bc60
--- /dev/null
+++ b/packages/studio/src/player/components/timelineDragDrop.test.tsx
@@ -0,0 +1,163 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { TIMELINE_ASSET_MIME } from "../../utils/timelineAssetDrop";
+import { usePlayerStore } from "../store/playerStore";
+import { createTimelineRowGeometry } from "./timelineLayout";
+import { useTimelineAssetDrop } from "./timelineDragDrop";
+
+(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+interface DropTransfer {
+  types: string[];
+  files: File[];
+  dropEffect: DataTransfer["dropEffect"];
+  getData: (type: string) => string;
+}
+
+function dragEvent(transfer: DropTransfer, clientX: number, clientY: number): React.DragEvent {
+  return {
+    clientX,
+    clientY,
+    dataTransfer: transfer,
+    preventDefault: vi.fn(),
+  } as unknown as React.DragEvent;
+}
+
+function assetTransfer(payload: string): DropTransfer {
+  return {
+    types: [TIMELINE_ASSET_MIME],
+    files: [],
+    dropEffect: "none",
+    getData: (type) => (type === TIMELINE_ASSET_MIME ? payload : ""),
+  };
+}
+
+function renderHarness(onAssetDrop: ReturnType<typeof vi.fn>, sessionEpoch = 1) {
+  const tracks = Array.from({ length: 100 }, (_, index) => index);
+  const geometry = createTimelineRowGeometry(
+    tracks,
+    tracks.map(() => 48),
+  );
+  const scroll = document.createElement("div");
+  scroll.getBoundingClientRect = () =>
+    ({ left: 0, top: 0, right: 800, bottom: 240, width: 800, height: 240 }) as DOMRect;
+  Object.defineProperties(scroll, {
+    scrollLeft: { configurable: true, writable: true, value: 0 },
+    scrollTop: { configurable: true, writable: true, value: 0 },
+    scrollWidth: { configurable: true, value: 10_000 },
+    scrollHeight: { configurable: true, value: geometry.canvasHeight },
+    clientWidth: { configurable: true, value: 800 },
+    clientHeight: { configurable: true, value: 240 },
+  });
+  document.body.append(scroll);
+  const root = createRoot(document.createElement("div"));
+  let api: ReturnType<typeof useTimelineAssetDrop> | null = null;
+
+  function Probe({ epoch }: { epoch: number }) {
+    api = useTimelineAssetDrop({
+      scrollRef: { current: scroll },
+      ppsRef: { current: 40 },
+      durationRef: { current: 120 },
+      trackOrderRef: { current: tracks },
+      rowGeometryRef: { current: geometry },
+      contentOrigin: 0,
+      sessionEpoch: epoch,
+      onAssetDrop,
+    });
+    return null;
+  }
+
+  act(() => root.render(<Probe epoch={sessionEpoch} />));
+  return {
+    scroll,
+    root,
+    get api() {
+      if (!api) throw new Error("drop harness did not render");
+      return api;
+    },
+    rerender(epoch: number) {
+      act(() => root.render(<Probe epoch={epoch} />));
+    },
+  };
+}
+
+afterEach(() => {
+  vi.restoreAllMocks();
+  usePlayerStore.getState().reset();
+  document.body.innerHTML = "";
+});
+
+describe("useTimelineAssetDrop", () => {
+  it("edge-autoscrolls the sole timeline viewport while a supported asset is held", () => {
+    let frame: FrameRequestCallback | null = null;
+    vi.spyOn(globalThis, "requestAnimationFrame").mockImplementation((callback) => {
+      frame = callback;
+      return 1;
+    });
+    vi.spyOn(globalThis, "cancelAnimationFrame").mockImplementation(() => undefined);
+    const view = renderHarness(vi.fn());
+
+    act(() => view.api.handleAssetDragOver(dragEvent(assetTransfer("{}"), 790, 120)));
+    expect(view.api.isDragOver).toBe(true);
+    expect(frame).not.toBeNull();
+    act(() => frame?.(0));
+    expect(view.scroll.scrollLeft).toBeGreaterThan(0);
+    expect(view.scroll.scrollTop).toBe(0);
+
+    act(() => view.api.clearDropPreview());
+    expect(view.api.isDragOver).toBe(false);
+    act(() => view.root.unmount());
+  });
+
+  it("keeps the drop actor while moving between descendants", () => {
+    const view = renderHarness(vi.fn());
+    const parent = document.createElement("div");
+    const child = document.createElement("div");
+    parent.append(child);
+    act(() => view.api.handleAssetDragOver(dragEvent(assetTransfer("{}"), 400, 100)));
+    act(() =>
+      view.api.handleAssetDragLeave({
+        relatedTarget: child,
+        currentTarget: parent,
+      } as unknown as React.DragEvent),
+    );
+    expect(view.api.isDragOver).toBe(true);
+    act(() => view.root.unmount());
+  });
+
+  it("drops once on a model row outside the mounted window and appends below the last row", () => {
+    const onAssetDrop = vi.fn();
+    const view = renderHarness(onAssetDrop);
+    usePlayerStore.getState().setCurrentTime(12.5);
+    view.scroll.scrollTop = view.scroll.scrollHeight - view.scroll.clientHeight;
+    const transfer = assetTransfer(JSON.stringify({ path: "/media/hero.mp4" }));
+
+    act(() => {
+      view.api.handleAssetDragOver(dragEvent(transfer, 400, 239));
+      view.api.handleAssetDrop(dragEvent(transfer, 400, 239));
+    });
+
+    expect(onAssetDrop).toHaveBeenCalledTimes(1);
+    expect(onAssetDrop).toHaveBeenCalledWith("/media/hero.mp4", { start: 12.5, track: 100 });
+    expect(view.api.isDragOver).toBe(false);
+    act(() => view.root.unmount());
+  });
+
+  it("ignores malformed payloads and clears the actor on project reset", () => {
+    const onAssetDrop = vi.fn();
+    const view = renderHarness(onAssetDrop, 1);
+    const transfer = assetTransfer("not-json");
+
+    act(() => view.api.handleAssetDragOver(dragEvent(transfer, 400, 100)));
+    expect(view.api.isDragOver).toBe(true);
+    view.rerender(2);
+    expect(view.api.isDragOver).toBe(false);
+
+    act(() => view.api.handleAssetDrop(dragEvent(transfer, 400, 100)));
+    expect(onAssetDrop).not.toHaveBeenCalled();
+    act(() => view.root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/timelineDragDrop.ts b/packages/studio/src/player/components/timelineDragDrop.ts
index 8cd2bfbe78..82f2a296eb 100644
--- a/packages/studio/src/player/components/timelineDragDrop.ts
+++ b/packages/studio/src/player/components/timelineDragDrop.ts
@@ -1,4 +1,4 @@
-import { useCallback, useState, type RefObject } from "react";
+import { useCallback, useEffect, useRef, useState, type RefObject } from "react";
 import { TIMELINE_ASSET_MIME, TIMELINE_BLOCK_MIME } from "../../utils/timelineAssetDrop";
 import {
   parseTimelineCompositionPayload,
@@ -7,6 +7,10 @@ import {
 import { usePlayerStore } from "../store/playerStore";
 import { resolveTimelineAssetDrop, type TimelineRowGeometry } from "./timelineLayout";
 import type { TimelineDropCallbacks } from "./timelineCallbacks";
+import {
+  applyTimelineAutoScrollStep,
+  resolveTimelineAutoScrollLoopAction,
+} from "./timelineEditing";
 
 interface UseTimelineAssetDropOptions extends TimelineDropCallbacks {
   scrollRef: RefObject<HTMLDivElement | null>;
@@ -15,6 +19,7 @@ interface UseTimelineAssetDropOptions extends TimelineDropCallbacks {
   trackOrderRef: RefObject<number[]>;
   rowGeometryRef: RefObject<TimelineRowGeometry>;
   contentOrigin: number;
+  sessionEpoch: number;
 }
 
 type TimelinePlacement = { start: number; track: number };
@@ -29,12 +34,22 @@ function applyJsonDropPayload(
   pick: (parsed: Record<string, string | undefined>) => string | undefined,
   apply: (value: string, placement: TimelinePlacement) => void,
   placement: TimelinePlacement,
-): void {
+): boolean {
   try {
     const value = pick(JSON.parse(raw) as Record<string, string | undefined>);
-    if (value) apply(value, placement);
+    if (!value) return false;
+    apply(value, placement);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function invokeDropCallback(callback: () => Promise<void> | void): void {
+  try {
+    void Promise.resolve(callback()).catch(() => undefined);
   } catch {
-    /* ignore malformed drag payloads */
+    // A rejected external producer never keeps a timeline drop actor alive.
   }
 }
 
@@ -62,22 +77,84 @@ export function useTimelineAssetDrop({
   onAssetDrop,
   onBlockDrop,
   onCompositionDrop,
+  sessionEpoch,
 }: UseTimelineAssetDropOptions) {
   const [isDragOver, setIsDragOver] = useState(false);
+  const dragPointerRef = useRef<{ clientX: number; clientY: number; sessionEpoch: number } | null>(
+    null,
+  );
+  const autoScrollRafRef = useRef(0);
+  const activeDropEpochRef = useRef<number | null>(null);
 
-  const handleAssetDragOver = useCallback((e: React.DragEvent) => {
-    const types = Array.from(e.dataTransfer.types);
-    const hasFiles = types.includes("Files");
-    const hasAsset = types.includes(TIMELINE_ASSET_MIME);
-    const hasBlock = types.includes(TIMELINE_BLOCK_MIME);
-    const hasComposition = types.includes(TIMELINE_COMPOSITION_MIME);
-    if (!hasFiles && !hasAsset && !hasBlock && !hasComposition) return;
-    e.preventDefault();
-    e.dataTransfer.dropEffect = "copy";
-    setIsDragOver(true);
+  const stopAutoScroll = useCallback(() => {
+    dragPointerRef.current = null;
+    if (autoScrollRafRef.current) cancelAnimationFrame(autoScrollRafRef.current);
+    autoScrollRafRef.current = 0;
   }, []);
 
-  const clearDropPreview = useCallback(() => setIsDragOver(false), []);
+  const stepAutoScroll = useCallback(
+    function stepAutoScroll() {
+      autoScrollRafRef.current = 0;
+      const pointer = dragPointerRef.current;
+      const scroll = scrollRef.current;
+      if (!pointer || pointer.sessionEpoch !== sessionEpoch || !scroll) return;
+      if (!applyTimelineAutoScrollStep(scroll, pointer.clientX, pointer.clientY)) return;
+      autoScrollRafRef.current = requestAnimationFrame(stepAutoScroll);
+    },
+    [scrollRef, sessionEpoch],
+  );
+
+  const syncAutoScroll = useCallback(
+    (clientX: number, clientY: number) => {
+      dragPointerRef.current = { clientX, clientY, sessionEpoch };
+      const scroll = scrollRef.current;
+      const action = resolveTimelineAutoScrollLoopAction(
+        scroll,
+        clientX,
+        clientY,
+        autoScrollRafRef.current !== 0,
+      );
+      if (action === "stop") {
+        cancelAnimationFrame(autoScrollRafRef.current);
+        autoScrollRafRef.current = 0;
+      } else if (action === "start") {
+        autoScrollRafRef.current = requestAnimationFrame(stepAutoScroll);
+      }
+    },
+    [scrollRef, sessionEpoch, stepAutoScroll],
+  );
+
+  const handleAssetDragOver = useCallback(
+    (e: React.DragEvent) => {
+      const types = Array.from(e.dataTransfer.types);
+      const hasFiles = types.includes("Files");
+      const hasAsset = types.includes(TIMELINE_ASSET_MIME);
+      const hasBlock = types.includes(TIMELINE_BLOCK_MIME);
+      const hasComposition = types.includes(TIMELINE_COMPOSITION_MIME);
+      if (!hasFiles && !hasAsset && !hasBlock && !hasComposition) return;
+      e.preventDefault();
+      e.dataTransfer.dropEffect = "copy";
+      activeDropEpochRef.current = sessionEpoch;
+      setIsDragOver(true);
+      syncAutoScroll(e.clientX, e.clientY);
+    },
+    [sessionEpoch, syncAutoScroll],
+  );
+
+  const clearDropPreview = useCallback(() => {
+    activeDropEpochRef.current = null;
+    stopAutoScroll();
+    setIsDragOver(false);
+  }, [stopAutoScroll]);
+
+  const handleAssetDragLeave = useCallback(
+    (e: React.DragEvent) => {
+      const related = e.relatedTarget;
+      if (related instanceof Node && e.currentTarget.contains(related)) return;
+      clearDropPreview();
+    },
+    [clearDropPreview],
+  );
 
   const resolveDropPlacement = useCallback(
     (clientX: number, clientY: number, usePointerStart = false): TimelinePlacement => {
@@ -110,33 +187,70 @@ export function useTimelineAssetDrop({
   const handleAssetDrop = useCallback(
     (e: React.DragEvent) => {
       e.preventDefault();
-      setIsDragOver(false);
+      const canCommit = activeDropEpochRef.current === sessionEpoch;
+      clearDropPreview();
+      if (!canCommit) return;
       const compositionPayload = parseTimelineCompositionPayload(
         e.dataTransfer.getData(TIMELINE_COMPOSITION_MIME),
       );
       if (compositionPayload && onCompositionDrop) {
         const placement = resolveDropPlacement(e.clientX, e.clientY, true);
-        void onCompositionDrop(compositionPayload.sourcePath, placement);
+        invokeDropCallback(() => onCompositionDrop(compositionPayload.sourcePath, placement));
         return;
       }
       const placement = resolveDropPlacement(e.clientX, e.clientY);
 
       if (onFileDrop && e.dataTransfer.files.length > 0) {
-        void onFileDrop(Array.from(e.dataTransfer.files), placement);
+        invokeDropCallback(() => onFileDrop(Array.from(e.dataTransfer.files), placement));
         return;
       }
+      const types = Array.from(e.dataTransfer.types);
       const assetPayload = e.dataTransfer.getData(TIMELINE_ASSET_MIME);
-      if (assetPayload && onAssetDrop) {
-        applyJsonDropPayload(assetPayload, (p) => p.path, onAssetDrop, placement);
+      if (types.includes(TIMELINE_ASSET_MIME)) {
+        if (assetPayload && onAssetDrop) {
+          applyJsonDropPayload(
+            assetPayload,
+            (p) => p.path,
+            (path, nextPlacement) => invokeDropCallback(() => onAssetDrop(path, nextPlacement)),
+            placement,
+          );
+        }
         return;
       }
       const blockPayload = e.dataTransfer.getData(TIMELINE_BLOCK_MIME);
-      if (blockPayload && onBlockDrop) {
-        applyJsonDropPayload(blockPayload, (p) => p.name, onBlockDrop, placement);
+      if (types.includes(TIMELINE_BLOCK_MIME)) {
+        if (blockPayload && onBlockDrop) {
+          applyJsonDropPayload(
+            blockPayload,
+            (p) => p.name,
+            (name, nextPlacement) => invokeDropCallback(() => onBlockDrop(name, nextPlacement)),
+            placement,
+          );
+        }
       }
     },
-    [resolveDropPlacement, onFileDrop, onAssetDrop, onBlockDrop, onCompositionDrop],
+    [
+      clearDropPreview,
+      onAssetDrop,
+      onBlockDrop,
+      onCompositionDrop,
+      onFileDrop,
+      resolveDropPlacement,
+      sessionEpoch,
+    ],
   );
 
-  return { isDragOver, handleAssetDragOver, handleAssetDrop, clearDropPreview };
+  useEffect(() => clearDropPreview, [clearDropPreview]);
+  useEffect(() => {
+    stopAutoScroll();
+    setIsDragOver(false);
+  }, [sessionEpoch, stopAutoScroll]);
+
+  return {
+    isDragOver,
+    handleAssetDragOver,
+    handleAssetDragLeave,
+    handleAssetDrop,
+    clearDropPreview,
+  };
 }

From 09d085d6e172c2afc0a811a42e43b11b741af9a5 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 18 Jul 2026 21:26:50 +0200
Subject: [PATCH 116/125] perf(studio): virtualize timeline marquee selection

---
 .../studio/src/player/components/Timeline.tsx |   7 +-
 .../player/components/timelineMarquee.test.ts |  98 +++++---
 .../src/player/components/timelineMarquee.ts  |  60 +++--
 .../useTimelineRangeSelection.test.tsx        | 212 ++++++++++++++++++
 .../components/useTimelineRangeSelection.ts   | 193 ++++++++++++----
 5 files changed, 481 insertions(+), 89 deletions(-)
 create mode 100644 packages/studio/src/player/components/useTimelineRangeSelection.test.tsx

diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 0d0707b4b6..8a8ec501b1 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -409,6 +409,7 @@ export const Timeline = memo(function Timeline({
     handlePointerDown,
     handlePointerMove,
     handlePointerUp,
+    handlePointerCancel,
   } = useTimelineRangeSelection({
     scrollRef,
     ppsRef,
@@ -421,10 +422,11 @@ export const Timeline = memo(function Timeline({
     isDragging,
     setShowPopover,
     elementsRef: expandedElementsRef,
-    trackOrderRef,
+    clipIndex,
     rowGeometryRef,
     onSelectElement,
     contentOrigin,
+    sessionEpoch,
   });
   setRangeSelectionRef.current = setRangeSelection; // stable ref consumed by useTimelineClipDrag
 
@@ -492,7 +494,8 @@ export const Timeline = memo(function Timeline({
         }}
         onPointerMove={handlePointerMove}
         onPointerUp={handlePointerUp}
-        onLostPointerCapture={handlePointerUp}
+        onPointerCancel={handlePointerCancel}
+        onLostPointerCapture={handlePointerCancel}
       >
         <TimelineCanvas
           major={major}
diff --git a/packages/studio/src/player/components/timelineMarquee.test.ts b/packages/studio/src/player/components/timelineMarquee.test.ts
index 7c6673b552..d82ecbf8c0 100644
--- a/packages/studio/src/player/components/timelineMarquee.test.ts
+++ b/packages/studio/src/player/components/timelineMarquee.test.ts
@@ -5,8 +5,11 @@ import {
   isTimelineRulerPress,
   getMarqueeRect,
   getTimelineClipRect,
+  getMarqueeClipCandidates,
   computeMarqueeSelection,
 } from "./timelineMarquee";
+import { createTimelineClipIndex } from "../lib/timelineClipIndex";
+import type { TimelineElement } from "../store/playerStore";
 import {
   GUTTER,
   LANE_H,
@@ -14,6 +17,7 @@ import {
   RULER_H,
   CLIP_Y,
   TRACKS_LEFT_PAD,
+  createTimelineRowGeometry,
   getTimelineRowTop,
 } from "./timelineLayout";
 
@@ -95,9 +99,13 @@ describe("getMarqueeRect", () => {
 
 describe("getTimelineClipRect", () => {
   const trackOrder = [0, 2, 5];
+  const geometry = createTimelineRowGeometry(
+    trackOrder,
+    trackOrder.map(() => TRACK_H),
+  );
 
   it("maps start/duration to x via pps and the track row to y via the shared row→y helper", () => {
-    const rect = getTimelineClipRect({ start: 2, duration: 3, track: 2 }, trackOrder, 100, GUTTER);
+    const rect = getTimelineClipRect({ start: 2, duration: 3, track: 2 }, geometry, 100, GUTTER);
     expect(rect).toEqual({
       left: GUTTER + 200,
       top: getTimelineRowTop(1) + CLIP_Y,
@@ -107,54 +115,48 @@ describe("getTimelineClipRect", () => {
   });
 
   it("places the first visible track below the ruler + top breathing pad", () => {
-    const rect = getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, 50, GUTTER);
+    const rect = getTimelineClipRect({ start: 0, duration: 1, track: 0 }, geometry, 50, GUTTER);
     expect(rect?.top).toBe(getTimelineRowTop(0) + CLIP_Y);
     expect(rect?.left).toBe(GUTTER);
   });
 
   it("uses the row index in trackOrder, not the raw track number", () => {
-    const rect = getTimelineClipRect({ start: 0, duration: 1, track: 5 }, trackOrder, 50, GUTTER);
+    const rect = getTimelineClipRect({ start: 0, duration: 1, track: 5 }, geometry, 50, GUTTER);
     expect(rect?.top).toBe(getTimelineRowTop(2) + CLIP_Y);
   });
 
   it("uses cumulative tops and the resolved height for an expanded row", () => {
     const rowHeights = [TRACK_H + 2 * LANE_H, TRACK_H, TRACK_H];
+    const expandedGeometry = createTimelineRowGeometry(trackOrder, rowHeights);
     const rect = getTimelineClipRect(
       { start: 0, duration: 1, track: 0 },
-      trackOrder,
+      expandedGeometry,
       50,
       GUTTER,
-      rowHeights,
     );
     expect(rect).toMatchObject({
       top: getTimelineRowTop(0, rowHeights) + CLIP_Y,
-      height: rowHeights[0] - CLIP_Y * 2,
+      height: TRACK_H - CLIP_Y * 2,
     });
     expect(
-      getTimelineClipRect({ start: 0, duration: 1, track: 2 }, trackOrder, 50, GUTTER, rowHeights)
-        ?.top,
+      getTimelineClipRect({ start: 0, duration: 1, track: 2 }, expandedGeometry, 50, GUTTER)?.top,
     ).toBe(getTimelineRowTop(1, rowHeights) + CLIP_Y);
   });
 
   it("enforces the 4px minimum rendered width", () => {
-    const rect = getTimelineClipRect(
-      { start: 0, duration: 0.01, track: 0 },
-      trackOrder,
-      10,
-      GUTTER,
-    );
+    const rect = getTimelineClipRect({ start: 0, duration: 0.01, track: 0 }, geometry, 10, GUTTER);
     expect(rect?.width).toBe(4);
   });
 
   it("returns null for a track that is not displayed or an invalid pps", () => {
     expect(
-      getTimelineClipRect({ start: 0, duration: 1, track: 9 }, trackOrder, 100, GUTTER),
+      getTimelineClipRect({ start: 0, duration: 1, track: 9 }, geometry, 100, GUTTER),
     ).toBeNull();
     expect(
-      getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, 0, GUTTER),
+      getTimelineClipRect({ start: 0, duration: 1, track: 0 }, geometry, 0, GUTTER),
     ).toBeNull();
     expect(
-      getTimelineClipRect({ start: 0, duration: 1, track: 0 }, trackOrder, NaN, GUTTER),
+      getTimelineClipRect({ start: 0, duration: 1, track: 0 }, geometry, NaN, GUTTER),
     ).toBeNull();
   });
 });
@@ -162,6 +164,10 @@ describe("getTimelineClipRect", () => {
 describe("computeMarqueeSelection", () => {
   // Two visible tracks: row 0 = track 0, row 1 = track 1. pps 100.
   const trackOrder = [0, 1];
+  const rowGeometry = createTimelineRowGeometry(
+    trackOrder,
+    trackOrder.map(() => TRACK_H),
+  );
   const pps = 100;
   const clips = [
     { id: "a", start: 0, duration: 1, track: 0 }, // x [32,132], row 0
@@ -175,7 +181,7 @@ describe("computeMarqueeSelection", () => {
     const marquee = { left: ORIGIN, top: row0Top, width: 50, height: 10 };
     const { ids, primaryId } = computeMarqueeSelection({
       clips,
-      trackOrder,
+      rowGeometry,
       pps,
       contentOrigin: ORIGIN,
       marquee,
@@ -188,7 +194,7 @@ describe("computeMarqueeSelection", () => {
     const marquee = { left: ORIGIN, top: row0Top, width: 60, height: row1Top - row0Top + 5 };
     const { ids } = computeMarqueeSelection({
       clips,
-      trackOrder,
+      rowGeometry,
       pps,
       contentOrigin: ORIGIN,
       marquee,
@@ -200,7 +206,7 @@ describe("computeMarqueeSelection", () => {
     const marquee = { left: ORIGIN + 140, top: row0Top, width: 50, height: 10 };
     const { ids } = computeMarqueeSelection({
       clips,
-      trackOrder,
+      rowGeometry,
       pps,
       contentOrigin: ORIGIN,
       marquee,
@@ -212,7 +218,7 @@ describe("computeMarqueeSelection", () => {
     const marquee = { left: GUTTER + 140, top: row0Top, width: 50, height: 10 };
     const { ids, primaryId } = computeMarqueeSelection({
       clips,
-      trackOrder,
+      rowGeometry,
       pps,
       contentOrigin: GUTTER,
       marquee,
@@ -226,7 +232,7 @@ describe("computeMarqueeSelection", () => {
     const marquee = { left: GUTTER, top: row1Top, width: 100, height: 10 };
     const { ids, primaryId } = computeMarqueeSelection({
       clips,
-      trackOrder,
+      rowGeometry,
       pps,
       contentOrigin: GUTTER,
       marquee,
@@ -240,10 +246,11 @@ describe("computeMarqueeSelection", () => {
     const wide = { left: ORIGIN, top: row0Top, width: 320, height: 10 };
     const narrow = { left: ORIGIN, top: row0Top, width: 80, height: 10 };
     expect(
-      computeMarqueeSelection({ clips, trackOrder, pps, contentOrigin: ORIGIN, marquee: wide }).ids,
+      computeMarqueeSelection({ clips, rowGeometry, pps, contentOrigin: ORIGIN, marquee: wide })
+        .ids,
     ).toEqual(new Set(["a", "b"]));
     expect(
-      computeMarqueeSelection({ clips, trackOrder, pps, contentOrigin: ORIGIN, marquee: narrow })
+      computeMarqueeSelection({ clips, rowGeometry, pps, contentOrigin: ORIGIN, marquee: narrow })
         .ids,
     ).toEqual(new Set(["a"]));
   });
@@ -252,7 +259,7 @@ describe("computeMarqueeSelection", () => {
     const marquee = { left: 0, top: 0, width: 10000, height: 10000 };
     const { ids } = computeMarqueeSelection({
       clips: [{ id: "x", start: 0, duration: 1, track: 7 }],
-      trackOrder,
+      rowGeometry,
       pps,
       contentOrigin: GUTTER,
       marquee,
@@ -260,3 +267,44 @@ describe("computeMarqueeSelection", () => {
     expect(ids).toEqual(new Set());
   });
 });
+
+describe("getMarqueeClipCandidates", () => {
+  it("queries only the intersecting rows and time span", () => {
+    const rowGeometry = createTimelineRowGeometry([0, 1, 2], [TRACK_H, TRACK_H, TRACK_H]);
+    const near: TimelineElement = { id: "near", tag: "div", start: 1, duration: 1, track: 1 };
+    const wrongTime: TimelineElement = {
+      id: "wrong-time",
+      tag: "div",
+      start: 20,
+      duration: 1,
+      track: 1,
+    };
+    const wrongRow: TimelineElement = {
+      id: "wrong-row",
+      tag: "div",
+      start: 1,
+      duration: 1,
+      track: 2,
+    };
+    const clipIndex = createTimelineClipIndex([
+      [0, []],
+      [1, [near, wrongTime]],
+      [2, [wrongRow]],
+    ]);
+
+    expect(
+      getMarqueeClipCandidates({
+        clipIndex,
+        rowGeometry,
+        marquee: {
+          left: ORIGIN + 100,
+          top: getTimelineRowTop(1),
+          width: 100,
+          height: TRACK_H - 1,
+        },
+        pps: 100,
+        contentOrigin: ORIGIN,
+      }),
+    ).toEqual([near]);
+  });
+});
diff --git a/packages/studio/src/player/components/timelineMarquee.ts b/packages/studio/src/player/components/timelineMarquee.ts
index 23bffaf317..1b792a4211 100644
--- a/packages/studio/src/player/components/timelineMarquee.ts
+++ b/packages/studio/src/player/components/timelineMarquee.ts
@@ -1,5 +1,7 @@
-import { RULER_H, CLIP_Y, getTimelineRowHeight, getTimelineRowTop } from "./timelineLayout";
+import { RULER_H, CLIP_Y, TRACK_H, type TimelineRowGeometry } from "./timelineLayout";
 import { rectsOverlap, type Rect } from "../../utils/marqueeGeometry";
+import { queryTimelineClipIndex, type TimelineClipIndex } from "../lib/timelineClipIndex";
+import type { TimelineElement } from "../store/playerStore";
 
 /** Pointer must travel at least this far (either axis) before a pointerdown on
  *  the empty timeline body becomes a marquee drag instead of a plain click. */
@@ -62,23 +64,22 @@ export function getMarqueeRect(
 /**
  * A clip's rendered rect in canvas/content coordinates (the same space the
  * marquee rect lives in): x from the shared content origin + start * pps, y from the clip's row
- * index within the visible track order (cumulative row top + CLIP_Y).
+ * index within the canonical row geometry (cumulative row top + CLIP_Y).
  * Returns null when the clip's track is not currently displayed.
  */
 export function getTimelineClipRect(
   clip: Pick<MarqueeClipInput, "start" | "duration" | "track">,
-  trackOrder: number[],
+  rowGeometry: TimelineRowGeometry,
   pps: number,
   contentOrigin: number,
-  rowHeights: readonly number[] = [],
 ): Rect | null {
-  const row = trackOrder.indexOf(clip.track);
+  const row = rowGeometry.getRowIndex(clip.track);
   if (row < 0 || !Number.isFinite(pps) || pps <= 0) return null;
   return {
     left: contentOrigin + clip.start * pps,
-    top: getTimelineRowTop(row, rowHeights) + CLIP_Y,
+    top: rowGeometry.getRowTop(row) + CLIP_Y,
     width: Math.max(clip.duration * pps, MIN_CLIP_W),
-    height: getTimelineRowHeight(row, rowHeights) - CLIP_Y * 2,
+    height: TRACK_H - CLIP_Y * 2,
   };
 }
 
@@ -90,29 +91,56 @@ export interface MarqueeSelectionResult {
   primaryId: string | null;
 }
 
+/** Narrow a marquee hit test to the intersecting logical rows and time span. */
+export function getMarqueeClipCandidates(input: {
+  clipIndex: TimelineClipIndex;
+  rowGeometry: TimelineRowGeometry;
+  marquee: Rect;
+  pps: number;
+  contentOrigin: number;
+}): readonly TimelineElement[] {
+  if (!(input.pps > 0) || input.marquee.width <= 0 || input.marquee.height <= 0) return [];
+  const lastRow = input.rowGeometry.rowKeys.length - 1;
+  const first = Math.max(0, Math.floor(input.rowGeometry.getRowFromY(input.marquee.top)));
+  const last = Math.min(
+    lastRow,
+    Math.floor(input.rowGeometry.getRowFromY(input.marquee.top + input.marquee.height)),
+  );
+  if (first > last) return [];
+  const paddingSeconds = MIN_CLIP_W / input.pps;
+  const start = Math.max(
+    0,
+    (input.marquee.left - input.contentOrigin) / input.pps - paddingSeconds,
+  );
+  const end =
+    (input.marquee.left + input.marquee.width - input.contentOrigin) / input.pps + paddingSeconds;
+  if (end <= start) return [];
+
+  const candidates: TimelineElement[] = [];
+  for (let row = first; row <= last; row += 1) {
+    const rowKey = input.rowGeometry.rowKeys[row];
+    if (rowKey === undefined) continue;
+    candidates.push(...queryTimelineClipIndex(input.clipIndex, rowKey, { start, end }));
+  }
+  return candidates;
+}
+
 /**
  * Live marquee selection: every clip whose rendered rect intersects the marquee.
  * `baseSelection` (shift/cmd-additive) is unioned in but never affects primaryId.
  */
 export function computeMarqueeSelection(input: {
   clips: MarqueeClipInput[];
-  trackOrder: number[];
+  rowGeometry: TimelineRowGeometry;
   pps: number;
   contentOrigin: number;
   marquee: Rect;
   baseSelection?: Iterable<string>;
-  rowHeights?: readonly number[];
 }): MarqueeSelectionResult {
   const ids = new Set<string>(input.baseSelection ?? []);
   let primaryId: string | null = null;
   for (const clip of input.clips) {
-    const rect = getTimelineClipRect(
-      clip,
-      input.trackOrder,
-      input.pps,
-      input.contentOrigin,
-      input.rowHeights,
-    );
+    const rect = getTimelineClipRect(clip, input.rowGeometry, input.pps, input.contentOrigin);
     if (rect && rectsOverlap(rect, input.marquee)) {
       ids.add(clip.id);
       primaryId = clip.id;
diff --git a/packages/studio/src/player/components/useTimelineRangeSelection.test.tsx b/packages/studio/src/player/components/useTimelineRangeSelection.test.tsx
new file mode 100644
index 0000000000..5ac3145c1a
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineRangeSelection.test.tsx
@@ -0,0 +1,212 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { usePlayerStore, type TimelineElement } from "../store/playerStore";
+import { createTimelineRowGeometry, getTimelineRowTop } from "./timelineLayout";
+import { createTimelineClipIndex } from "../lib/timelineClipIndex";
+import { useTimelineRangeSelection } from "./useTimelineRangeSelection";
+
+(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+const elements: TimelineElement[] = [
+  { id: "first", tag: "div", start: 1, duration: 1, track: 0 },
+  { id: "offscreen", tag: "div", start: 2, duration: 1, track: 50 },
+  { id: "base", tag: "div", start: 8, duration: 1, track: 99 },
+];
+const tracks = Array.from({ length: 100 }, (_, index) => index);
+const geometry = createTimelineRowGeometry(
+  tracks,
+  tracks.map(() => 48),
+);
+const clipIndex = createTimelineClipIndex(
+  tracks.map((track) => [track, elements.filter((element) => element.track === track)]),
+);
+
+function pointer(
+  currentTarget: HTMLElement,
+  pointerId: number,
+  clientX: number,
+  clientY: number,
+  init: Partial<React.PointerEvent> = {},
+): React.PointerEvent {
+  return {
+    button: 0,
+    clientX,
+    clientY,
+    ctrlKey: false,
+    metaKey: false,
+    shiftKey: false,
+    pointerId,
+    currentTarget,
+    target: currentTarget,
+    ...init,
+  } as React.PointerEvent;
+}
+
+function renderHarness(sessionEpoch = 1) {
+  usePlayerStore.setState({ timelineSessionEpoch: sessionEpoch });
+  const host = document.createElement("div");
+  const scroll = document.createElement("div");
+  scroll.setPointerCapture = vi.fn();
+  scroll.getBoundingClientRect = () =>
+    ({ left: 0, top: 0, right: 800, bottom: 240, width: 800, height: 240 }) as DOMRect;
+  Object.defineProperties(scroll, {
+    scrollLeft: { configurable: true, writable: true, value: 0 },
+    scrollTop: { configurable: true, writable: true, value: 0 },
+    scrollWidth: { configurable: true, value: 10_000 },
+    scrollHeight: { configurable: true, value: geometry.canvasHeight },
+    clientWidth: { configurable: true, value: 800 },
+    clientHeight: { configurable: true, value: 240 },
+  });
+  host.append(scroll);
+  document.body.append(host);
+  const root = createRoot(host);
+  let api: ReturnType<typeof useTimelineRangeSelection> | null = null;
+  const ppsRef = { current: 100 };
+  const dragScrollRaf = { current: 0 };
+  const isDragging = { current: false };
+  const elementsRef = { current: elements };
+  const rowGeometryRef = { current: geometry };
+  const seekFromX = vi.fn();
+
+  function Probe({ epoch }: { epoch: number }) {
+    api = useTimelineRangeSelection({
+      scrollRef: { current: scroll },
+      ppsRef,
+      effectiveDuration: 60,
+      pps: 100,
+      seekFromX,
+      autoScrollDuringDrag: vi.fn(),
+      dragScrollRaf,
+      isDragging,
+      setShowPopover: vi.fn(),
+      elementsRef,
+      clipIndex,
+      rowGeometryRef,
+      contentOrigin: 0,
+      sessionEpoch: epoch,
+    });
+    return null;
+  }
+
+  act(() => root.render(<Probe epoch={sessionEpoch} />));
+  return {
+    scroll,
+    root,
+    get api() {
+      if (!api) throw new Error("selection harness did not render");
+      return api;
+    },
+    rerender(epoch: number) {
+      usePlayerStore.setState({ timelineSessionEpoch: epoch });
+      act(() => root.render(<Probe epoch={epoch} />));
+    },
+    seekFromX,
+  };
+}
+
+afterEach(() => {
+  usePlayerStore.getState().reset();
+  document.body.innerHTML = "";
+});
+
+describe("useTimelineRangeSelection", () => {
+  it("marquee-selects model clips across unmounted virtual rows", () => {
+    const view = renderHarness();
+    const y0 = getTimelineRowTop(0) + 4;
+    const y50 = getTimelineRowTop(50) + 40;
+
+    act(() => {
+      view.api.handlePointerDown(pointer(view.scroll, 7, 0, y0));
+      view.api.handlePointerMove(pointer(view.scroll, 7, 400, y50));
+    });
+
+    expect(document.querySelectorAll("[data-clip]")).toHaveLength(0);
+    expect(usePlayerStore.getState().selectedElementIds).toEqual(new Set(["first", "offscreen"]));
+    act(() => view.root.unmount());
+  });
+
+  it("ignores another pointer and restores the pre-drag selection on cancellation", () => {
+    usePlayerStore.getState().setSelectedElementId("base");
+    const view = renderHarness();
+    const y0 = getTimelineRowTop(0) + 4;
+    const y50 = getTimelineRowTop(50) + 40;
+
+    act(() => {
+      view.api.handlePointerDown(pointer(view.scroll, 7, 0, y0));
+      view.api.handlePointerMove(pointer(view.scroll, 7, 400, y50));
+      view.api.handlePointerUp(pointer(view.scroll, 8, 400, y50));
+    });
+    expect(usePlayerStore.getState().selectedElementIds).toEqual(new Set(["first", "offscreen"]));
+
+    act(() => view.api.handlePointerCancel(pointer(view.scroll, 7, 400, y50)));
+    expect(usePlayerStore.getState().selectedElementId).toBe("base");
+    expect(usePlayerStore.getState().selectedElementIds).toEqual(new Set(["base"]));
+    act(() => view.root.unmount());
+  });
+
+  it("keeps the original pointer owner when a second pointer presses", () => {
+    const view = renderHarness();
+    const y0 = getTimelineRowTop(0) + 4;
+    const y50 = getTimelineRowTop(50) + 40;
+
+    act(() => {
+      view.api.handlePointerDown(pointer(view.scroll, 7, 0, y0));
+      view.api.handlePointerDown(pointer(view.scroll, 8, 500, y0));
+      view.api.handlePointerMove(pointer(view.scroll, 7, 400, y50));
+      view.api.handlePointerUp(pointer(view.scroll, 7, 400, y50));
+    });
+
+    expect(usePlayerStore.getState().selectedElementIds).toEqual(new Set(["first", "offscreen"]));
+    act(() => view.root.unmount());
+  });
+
+  it("commits a ruler click at its pointerdown position without requiring pointer movement", () => {
+    const view = renderHarness();
+
+    act(() => {
+      view.api.handlePointerDown(pointer(view.scroll, 7, 375, 5));
+      view.api.handlePointerUp(pointer(view.scroll, 7, 375, 5));
+    });
+
+    expect(view.seekFromX).toHaveBeenNthCalledWith(1, 375);
+    expect(view.seekFromX).toHaveBeenNthCalledWith(2, 375);
+    act(() => view.root.unmount());
+  });
+
+  it("does not clear a finalized range when capture is lost after pointerup", () => {
+    const view = renderHarness();
+
+    act(() => {
+      view.api.handlePointerDown(pointer(view.scroll, 7, 100, 80, { shiftKey: true }));
+      view.api.handlePointerMove(pointer(view.scroll, 7, 300, 80, { shiftKey: true }));
+      view.api.handlePointerUp(pointer(view.scroll, 7, 300, 80, { shiftKey: true }));
+    });
+    const finalized = view.api.rangeSelection;
+    expect(finalized).toMatchObject({ start: 1, end: 3 });
+
+    act(() => view.api.handlePointerCancel(pointer(view.scroll, 7, 300, 80)));
+    expect(view.api.rangeSelection).toEqual(finalized);
+    act(() => view.root.unmount());
+  });
+
+  it("cancels a live marquee when the project session changes", () => {
+    usePlayerStore.getState().setSelectedElementId("base");
+    const view = renderHarness(1);
+    const y0 = getTimelineRowTop(0) + 4;
+    const y50 = getTimelineRowTop(50) + 40;
+
+    act(() => {
+      view.api.handlePointerDown(pointer(view.scroll, 7, 0, y0));
+      view.api.handlePointerMove(pointer(view.scroll, 7, 400, y50));
+    });
+    usePlayerStore.getState().setSelectedElementId("base");
+    view.rerender(2);
+
+    expect(usePlayerStore.getState().selectedElementId).toBe("base");
+    expect(usePlayerStore.getState().selectedElementIds).toEqual(new Set(["base"]));
+    act(() => view.root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useTimelineRangeSelection.ts b/packages/studio/src/player/components/useTimelineRangeSelection.ts
index 849b52dcaf..7f28b9d773 100644
--- a/packages/studio/src/player/components/useTimelineRangeSelection.ts
+++ b/packages/studio/src/player/components/useTimelineRangeSelection.ts
@@ -10,6 +10,7 @@ import { liveTime, usePlayerStore } from "../store/playerStore";
 import { getTimelineScrubTime } from "./timelineLayout";
 import {
   computeMarqueeSelection,
+  getMarqueeClipCandidates,
   getMarqueeRect,
   isMarqueeDrag,
   isTimelineRulerPress,
@@ -17,6 +18,7 @@ import {
 } from "./timelineMarquee";
 import type { Rect } from "../../utils/marqueeGeometry";
 import type { TimelineRowGeometry } from "./timelineLayout";
+import type { TimelineClipIndex } from "../lib/timelineClipIndex";
 
 interface UseTimelineRangeSelectionInput {
   scrollRef: React.RefObject<HTMLDivElement | null>;
@@ -30,10 +32,11 @@ interface UseTimelineRangeSelectionInput {
   isDragging: React.RefObject<boolean>;
   setShowPopover: (v: boolean) => void;
   elementsRef: React.RefObject<TimelineElement[]>;
-  trackOrderRef: React.RefObject<number[]>;
+  clipIndex: TimelineClipIndex;
   rowGeometryRef: React.RefObject<TimelineRowGeometry>;
   onSelectElement?: (element: TimelineElement | null) => void;
   contentOrigin: number;
+  sessionEpoch: number;
 }
 
 interface MarqueeDragState {
@@ -73,16 +76,21 @@ function commitMarqueeSelection(
   rect: Rect,
   additive: boolean,
   marquee: MarqueeDragState,
-  elements: TimelineElement[],
-  trackOrder: number[],
-  rowHeights: readonly number[],
+  clipIndex: TimelineClipIndex,
+  rowGeometry: TimelineRowGeometry,
   pps: number,
   contentOrigin: number,
 ): void {
+  const candidates = getMarqueeClipCandidates({
+    clipIndex,
+    rowGeometry,
+    marquee: rect,
+    pps,
+    contentOrigin,
+  });
   const { ids, primaryId } = computeMarqueeSelection({
-    clips: toMarqueeClips(elements),
-    trackOrder,
-    rowHeights,
+    clips: toMarqueeClips([...candidates]),
+    rowGeometry,
     pps,
     contentOrigin,
     marquee: rect,
@@ -107,10 +115,11 @@ export function useTimelineRangeSelection({
   isDragging,
   setShowPopover,
   elementsRef,
-  trackOrderRef,
+  clipIndex,
   rowGeometryRef,
   onSelectElement,
   contentOrigin,
+  sessionEpoch,
 }: UseTimelineRangeSelectionInput) {
   const isRangeSelecting = useRef(false);
   const rangeAnchorTime = useRef(0);
@@ -126,6 +135,17 @@ export function useTimelineRangeSelection({
 
   const seekRafRef = useRef(0);
   const pendingClientXRef = useRef(0);
+  const activePointerIdRef = useRef<number | null>(null);
+  const gestureEpochRef = useRef<number | null>(null);
+  const sessionEpochRef = useRef(sessionEpoch);
+  sessionEpochRef.current = sessionEpoch;
+
+  const isGestureSessionCurrent = useCallback(
+    () =>
+      gestureEpochRef.current === sessionEpochRef.current &&
+      gestureEpochRef.current === usePlayerStore.getState().timelineSessionEpoch,
+    [],
+  );
 
   // Marquee (rubber-band) multi-select on the empty timeline body.
   const marqueeRef = useRef<MarqueeDragState | null>(null);
@@ -159,7 +179,7 @@ export function useTimelineRangeSelection({
   const applyMarqueeAtClient = useCallback(
     (clientX: number, clientY: number, shiftKey: boolean) => {
       const marquee = marqueeRef.current;
-      if (!marquee) return;
+      if (!marquee || !isGestureSessionCurrent()) return;
       const point = toContentPoint(clientX, clientY);
       if (!point) return;
       if (!marquee.active && !isMarqueeDrag(marquee.originX, marquee.originY, point.x, point.y)) {
@@ -175,14 +195,13 @@ export function useTimelineRangeSelection({
         rect,
         additive,
         marquee,
-        elementsRef.current ?? [],
-        trackOrderRef.current ?? [],
-        rowGeometryRef.current.rowHeights,
+        clipIndex,
+        rowGeometryRef.current,
         ppsRef.current,
         contentOrigin,
       );
     },
-    [toContentPoint, elementsRef, trackOrderRef, rowGeometryRef, ppsRef, contentOrigin],
+    [toContentPoint, isGestureSessionCurrent, clipIndex, rowGeometryRef, ppsRef, contentOrigin],
   );
 
   const stopMarqueeAutoScroll = useCallback(() => {
@@ -203,14 +222,16 @@ export function useTimelineRangeSelection({
     const marquee = marqueeRef.current;
     const pointer = marqueePointerRef.current;
     const scroll = scrollRef.current;
-    if (!marquee || !pointer || !scroll) return;
+    if (!marquee || !pointer || !scroll || !isGestureSessionCurrent()) {
+      return;
+    }
     if (!applyTimelineAutoScrollStep(scroll, pointer.clientX, pointer.clientY)) return;
 
     // Re-run at the SAME client point: toContentPoint folds in the new scroll, so
     // the marquee's moving corner tracks the revealed content.
     applyMarqueeAtClient(pointer.clientX, pointer.clientY, pointer.shiftKey);
     marqueeScrollRaf.current = requestAnimationFrame(stepMarqueeAutoScroll);
-  }, [scrollRef, applyMarqueeAtClient]);
+  }, [scrollRef, applyMarqueeAtClient, isGestureSessionCurrent]);
 
   const syncMarqueeAutoScroll = useCallback(
     (clientX: number, clientY: number, shiftKey: boolean) => {
@@ -235,6 +256,8 @@ export function useTimelineRangeSelection({
   const beginRangeSelection = useCallback(
     (e: React.PointerEvent) => {
       (e.currentTarget as HTMLElement).setPointerCapture(e.pointerId);
+      activePointerIdRef.current = e.pointerId;
+      gestureEpochRef.current = sessionEpochRef.current;
       isRangeSelecting.current = true;
       setShowPopover(false);
       const rect = scrollRef.current?.getBoundingClientRect();
@@ -250,7 +273,8 @@ export function useTimelineRangeSelection({
 
   const handlePointerDown = useCallback(
     (e: React.PointerEvent) => {
-      if (e.button !== 0) return;
+      if (e.button !== 0 || activePointerIdRef.current !== null) return;
+      if (sessionEpochRef.current !== usePlayerStore.getState().timelineSessionEpoch) return;
       if (e.shiftKey) {
         beginRangeSelection(e);
         return;
@@ -258,6 +282,8 @@ export function useTimelineRangeSelection({
       shiftClickClipRef.current = null;
       if ((e.target as HTMLElement).closest("[data-clip]")) return;
       (e.currentTarget as HTMLElement).setPointerCapture(e.pointerId);
+      activePointerIdRef.current = e.pointerId;
+      gestureEpochRef.current = sessionEpochRef.current;
       setRangeSelection(null);
       setShowPopover(false);
       const point = toContentPoint(e.clientX, e.clientY);
@@ -269,6 +295,7 @@ export function useTimelineRangeSelection({
       if (!point || !scrollRect || isTimelineRulerPress(e.clientY, scrollRect.top)) {
         isDragging.current = true;
         setIsScrubbing(true);
+        pendingClientXRef.current = e.clientX;
         seekFromX(e.clientX);
         return;
       }
@@ -322,6 +349,8 @@ export function useTimelineRangeSelection({
 
   const handlePointerMove = useCallback(
     (e: React.PointerEvent) => {
+      if (!isGestureSessionCurrent()) return;
+      if (activePointerIdRef.current !== null && e.pointerId !== activePointerIdRef.current) return;
       if (isRangeSelecting.current) {
         const rect = scrollRef.current?.getBoundingClientRect();
         if (rect) {
@@ -352,6 +381,7 @@ export function useTimelineRangeSelection({
       applyMarqueeAtClient,
       syncMarqueeAutoScroll,
       updateScrubDrag,
+      isGestureSessionCurrent,
       contentOrigin,
     ],
   );
@@ -398,26 +428,86 @@ export function useTimelineRangeSelection({
     [stopMarqueeAutoScroll, elementsRef, onSelectElement],
   );
 
-  const handlePointerUp = useCallback(() => {
-    if (isRangeSelecting.current) {
-      finishRangeSelection();
-      return;
-    }
-    const marquee = marqueeRef.current;
-    if (marquee) {
-      finishMarquee(marquee);
-      return;
-    }
-    if (!isDragging.current) return;
-    if (seekRafRef.current) {
-      cancelAnimationFrame(seekRafRef.current);
-      seekRafRef.current = 0;
-    }
-    seekFromX(pendingClientXRef.current);
-    isDragging.current = false;
-    setIsScrubbing(false);
-    cancelAnimationFrame(dragScrollRaf.current);
-  }, [isDragging, dragScrollRaf, seekFromX, finishRangeSelection, finishMarquee]);
+  const handlePointerUp = useCallback(
+    (e?: React.PointerEvent) => {
+      if (activePointerIdRef.current === null) return;
+      if (e && activePointerIdRef.current !== null && e.pointerId !== activePointerIdRef.current) {
+        return;
+      }
+      if (!isGestureSessionCurrent()) return;
+      activePointerIdRef.current = null;
+      gestureEpochRef.current = null;
+      if (isRangeSelecting.current) {
+        finishRangeSelection();
+        return;
+      }
+      const marquee = marqueeRef.current;
+      if (marquee) {
+        finishMarquee(marquee);
+        return;
+      }
+      if (!isDragging.current) return;
+      if (seekRafRef.current) {
+        cancelAnimationFrame(seekRafRef.current);
+        seekRafRef.current = 0;
+      }
+      seekFromX(pendingClientXRef.current);
+      isDragging.current = false;
+      setIsScrubbing(false);
+      cancelAnimationFrame(dragScrollRaf.current);
+    },
+    [
+      isDragging,
+      dragScrollRaf,
+      seekFromX,
+      finishRangeSelection,
+      finishMarquee,
+      isGestureSessionCurrent,
+    ],
+  );
+
+  const cancelActiveGesture = useCallback(
+    (updateUi: boolean, restoreSelection: boolean) => {
+      activePointerIdRef.current = null;
+      gestureEpochRef.current = null;
+      isRangeSelecting.current = false;
+      isDragging.current = false;
+      stopMarqueeAutoScroll();
+      if (seekRafRef.current) {
+        cancelAnimationFrame(seekRafRef.current);
+        seekRafRef.current = 0;
+      }
+      cancelAnimationFrame(dragScrollRaf.current);
+      dragScrollRaf.current = 0;
+
+      const marquee = marqueeRef.current;
+      marqueeRef.current = null;
+      if (restoreSelection && marquee?.active) {
+        const store = usePlayerStore.getState();
+        store.setSelectedElementId(marquee.basePrimary);
+        store.setSelectedElementIds(marquee.baseIds);
+      }
+      if (updateUi) {
+        setMarqueeRect(null);
+        setRangeSelection(null);
+        setIsScrubbing(false);
+      }
+    },
+    [dragScrollRaf, isDragging, stopMarqueeAutoScroll],
+  );
+
+  const handlePointerCancel = useCallback(
+    (e?: React.PointerEvent) => {
+      if (
+        activePointerIdRef.current === null ||
+        (e && activePointerIdRef.current !== null && e.pointerId !== activePointerIdRef.current)
+      ) {
+        return;
+      }
+      cancelActiveGesture(true, isGestureSessionCurrent());
+    },
+    [cancelActiveGesture, isGestureSessionCurrent],
+  );
 
   // Escape: cancel an in-flight marquee (restores the pre-drag selection);
   // otherwise clear any lingering multi-selection.
@@ -427,15 +517,11 @@ export function useTimelineRangeSelection({
       const store = usePlayerStore.getState();
       const marquee = marqueeRef.current;
       if (marquee) {
-        marqueeRef.current = null;
-        stopMarqueeAutoScroll();
-        setMarqueeRect(null);
-        if (marquee.active) {
-          // Primary FIRST (see commitMarqueeSelection): it collapses the set, so
-          // restore the pre-drag primary before repopulating the base ids.
-          store.setSelectedElementId(marquee.basePrimary);
-          store.setSelectedElementIds(marquee.baseIds);
-        }
+        cancelActiveGesture(true, true);
+        return;
+      }
+      if (isRangeSelecting.current || isDragging.current) {
+        cancelActiveGesture(true, true);
         return;
       }
       // Escape with no marquee clears the whole selection — primary AND set.
@@ -446,7 +532,21 @@ export function useTimelineRangeSelection({
     };
     window.addEventListener("keydown", onKeyDown);
     return () => window.removeEventListener("keydown", onKeyDown);
-  }, [stopMarqueeAutoScroll]);
+  }, [cancelActiveGesture, isDragging]);
+
+  const previousSessionEpochRef = useRef(sessionEpoch);
+  useEffect(() => {
+    if (previousSessionEpochRef.current === sessionEpoch) return;
+    previousSessionEpochRef.current = sessionEpoch;
+    cancelActiveGesture(true, false);
+  }, [cancelActiveGesture, sessionEpoch]);
+
+  useEffect(
+    () => () => {
+      cancelActiveGesture(false, isGestureSessionCurrent());
+    },
+    [cancelActiveGesture, isGestureSessionCurrent],
+  );
 
   return {
     rangeSelection,
@@ -457,5 +557,6 @@ export function useTimelineRangeSelection({
     handlePointerDown,
     handlePointerMove,
     handlePointerUp,
+    handlePointerCancel,
   };
 }

From dd1a8a4e7ccbaab88a9d7451608cb8de3a4f3af2 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 18 Jul 2026 21:37:18 +0200
Subject: [PATCH 117/125] fix(studio): scope timeline context targets

---
 .../nle/useTimelineEditCallbacks.test.tsx     |  92 ++++++++++++-
 .../nle/useTimelineEditCallbacks.ts           |   7 +-
 .../src/hooks/useGsapKeyframeOps.test.tsx     |  40 +++++-
 .../studio/src/hooks/useGsapKeyframeOps.ts    |  14 +-
 .../KeyframeDiamondContextMenu.test.tsx       |  53 ++++++++
 .../components/KeyframeDiamondContextMenu.tsx |   6 +-
 .../studio/src/player/components/Timeline.tsx |  20 +--
 .../components/TimelineOverlays.test.ts       |  54 ++++++++
 .../player/components/TimelineOverlays.tsx    | 121 ++++++++++++++++--
 .../player/components/timelineCallbacks.ts    |   2 +-
 .../useTimelineKeyframeHandlers.test.tsx      |  37 +++++-
 .../components/useTimelineKeyframeHandlers.ts |   3 +-
 .../components/useTrackGapMenu.test.tsx       |  64 +++++++++
 .../src/player/components/useTrackGapMenu.ts  |  41 ++++--
 14 files changed, 499 insertions(+), 55 deletions(-)
 create mode 100644 packages/studio/src/player/components/KeyframeDiamondContextMenu.test.tsx
 create mode 100644 packages/studio/src/player/components/TimelineOverlays.test.ts
 create mode 100644 packages/studio/src/player/components/useTrackGapMenu.test.tsx

diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
index c8eb9b0088..efcd11b5be 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.test.tsx
@@ -283,21 +283,105 @@ describe("useTimelineEditCallbacks — flat tween keyframe lanes", () => {
   });
 
   it("deletes all keyframes through the clicked non-selected element's identity", async () => {
-    const { circle, selection } = arrangeClickedCircle();
+    const circle: TimelineElement = {
+      ...element,
+      id: "circle",
+      key: "scenes/main.html#circle",
+      domId: "circle",
+      sourceFile: "scenes/main.html",
+    };
+    const circleSelection = { id: "circle", selector: "#circle", sourceFile: "scenes/main.html" };
+    const scaleAnimation: GsapAnimation = {
+      ...otherKeyframedAnimation,
+      id: "circle-to-0-scale",
+      properties: {},
+      propertyGroup: "scale",
+      keyframes: {
+        format: "percentage",
+        keyframes: [
+          { percentage: 0, properties: { scale: 1 } },
+          { percentage: 100, properties: { scale: 2 } },
+        ],
+      },
+    };
+    usePlayerStore.setState({
+      elements: [element, circle],
+      gsapAnimations: new Map([
+        ["scenes/main.html#circle", [otherKeyframedAnimation, scaleAnimation]],
+      ]),
+    });
+    mocks.actions.buildDomSelectionForTimelineElement.mockResolvedValue(circleSelection);
     const view = renderCallbacks();
 
     await act(async () => {
-      view.callbacks.onDeleteAllKeyframes?.(circle);
+      view.callbacks.onDeleteAllKeyframes?.(circle, scaleAnimation.id);
       await Promise.resolve();
     });
 
     expect(mocks.actions.handleGsapRemoveAllKeyframes).toHaveBeenCalledWith(
-      otherKeyframedAnimation.id,
-      selection,
+      scaleAnimation.id,
+      circleSelection,
     );
     view.unmount();
   });
 
+  it("does not delete a different lane when an explicit animation identity is stale", async () => {
+    const circle: TimelineElement = {
+      ...element,
+      id: "circle",
+      key: "scenes/main.html#circle",
+      domId: "circle",
+      sourceFile: "scenes/main.html",
+    };
+    usePlayerStore.setState({
+      elements: [element, circle],
+      gsapAnimations: new Map([["scenes/main.html#circle", [otherKeyframedAnimation]]]),
+    });
+    const view = renderCallbacks();
+
+    await act(async () => {
+      view.callbacks.onDeleteAllKeyframes?.(circle, "missing-animation-id");
+      await Promise.resolve();
+    });
+
+    expect(mocks.actions.handleGsapRemoveAllKeyframes).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("does not delete a different keyframe when its explicit animation identity is stale", () => {
+    const view = renderCallbacks();
+
+    act(() => {
+      view.callbacks.onDeleteKeyframe?.("box", {
+        percentage: 100,
+        propertyGroup: "position",
+        tweenPercentage: 100,
+        animationId: "missing-animation-id",
+      });
+    });
+
+    expect(mocks.actions.handleGsapDeleteAnimation).not.toHaveBeenCalled();
+    expect(mocks.actions.handleGsapRemoveKeyframe).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
+  it("does not move a different keyframe when its explicit animation identity is stale", async () => {
+    const view = renderCallbacks();
+
+    await act(async () => {
+      view.callbacks.onMoveKeyframeToPlayhead?.(element, {
+        percentage: 100,
+        propertyGroup: "position",
+        tweenPercentage: 100,
+        animationId: "missing-animation-id",
+      });
+      await Promise.resolve();
+    });
+
+    expect(mocks.actions.handleGsapMoveKeyframeToPlayhead).not.toHaveBeenCalled();
+    view.unmount();
+  });
+
   it("moves a keyframe to the playhead through the clicked non-selected element's identity", async () => {
     const { circle, selection } = arrangeClickedCircle();
     const view = renderCallbacks();
diff --git a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
index 78a078e34b..e32afc54e8 100644
--- a/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
+++ b/packages/studio/src/components/nle/useTimelineEditCallbacks.ts
@@ -190,12 +190,15 @@ export function useTimelineEditCallbacks({
       onSplitElement: handleTimelineElementSplit,
       onRazorSplit: handleRazorSplit,
       onRazorSplitAll: handleRazorSplitAll,
-      onDeleteAllKeyframes: (element) => {
+      onDeleteAllKeyframes: (element, animationId) => {
         // Hold the element where it is (collapse keyframes to a static set) rather
         // than deleting the whole animation — deleting strands a stale GSAP base
         // that the next drag adds to, flinging the element off-screen.
         const elementKey = getTimelineElementIdentity(element);
-        const anim = resolveElementAnimations(elementKey).find((animation) => animation.keyframes);
+        const animations = resolveElementAnimations(elementKey);
+        const anim = animationId
+          ? animations.find((animation) => animation.id === animationId)
+          : animations.find((animation) => animation.keyframes);
         if (!anim) return;
         void buildDomSelectionForTimelineElement(element).then((selection) => {
           if (selection) handleGsapRemoveAllKeyframes(anim.id, selection);
diff --git a/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx b/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
index 6017353d08..09d403c678 100644
--- a/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
+++ b/packages/studio/src/hooks/useGsapKeyframeOps.test.tsx
@@ -7,6 +7,8 @@ import { afterEach, describe, expect, it, vi } from "vitest";
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
 import type { DomEditSelection } from "../components/editor/domEditingTypes";
+import type { KeyframeCacheEntry } from "../player/store/playerStore";
+import { usePlayerStore } from "../player/store/playerStore";
 import { useGsapKeyframeOps } from "./useGsapKeyframeOps";
 
 type HookApi = ReturnType<typeof useGsapKeyframeOps>;
@@ -30,6 +32,7 @@ function successfulCommitMutation() {
 
 function renderKeyframeOps(over: {
   commitMutation: (...args: unknown[]) => Promise<unknown>;
+  commitMutationSafely?: (...args: unknown[]) => Promise<void>;
   trackGsapSaveFailure: (...args: unknown[]) => void;
 }) {
   const captured: { api: HookApi | null } = { api: null };
@@ -41,7 +44,7 @@ function renderKeyframeOps(over: {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any -- test doubles
       commitMutation: over.commitMutation as any,
       // eslint-disable-next-line @typescript-eslint/no-explicit-any -- test doubles
-      commitMutationSafely: (() => {}) as any,
+      commitMutationSafely: (over.commitMutationSafely ?? (async () => {})) as any,
       // eslint-disable-next-line @typescript-eslint/no-explicit-any -- test doubles
       trackGsapSaveFailure: over.trackGsapSaveFailure as any,
       sdkSession: null,
@@ -203,6 +206,41 @@ describe("useGsapKeyframeOps — keyframe transaction options", () => {
     );
   });
 
+  it("lets the successful commit refresh own delete-all cache invalidation", async () => {
+    let finishCommit: (() => void) | undefined;
+    const commitMutationSafely = vi.fn(
+      () =>
+        new Promise<void>((resolve) => {
+          finishCommit = resolve;
+        }),
+    );
+    const api = renderKeyframeOps({
+      commitMutation: successfulCommitMutation(),
+      commitMutationSafely,
+      trackGsapSaveFailure: vi.fn(),
+    });
+    const cached: KeyframeCacheEntry = {
+      format: "percentage",
+      keyframes: [
+        { percentage: 0, properties: { x: 0 } },
+        { percentage: 100, properties: { x: 200 } },
+      ],
+    };
+    usePlayerStore.setState({ keyframeCache: new Map([["index.html#box", cached]]) });
+
+    const pending = api.removeAllKeyframes(selection, "box-to-0-position");
+    expect(commitMutationSafely).toHaveBeenCalledWith(
+      selection,
+      { type: "remove-all-keyframes", animationId: "box-to-0-position" },
+      { label: "Remove all keyframes", softReload: true },
+    );
+    expect(usePlayerStore.getState().keyframeCache.get("index.html#box")).toBe(cached);
+
+    finishCommit?.();
+    await pending;
+    expect(usePlayerStore.getState().keyframeCache.get("index.html#box")).toBe(cached);
+  });
+
   it("threads one coalesce key through skipped convert reload and terminal batch edit", async () => {
     const commitMutation = successfulCommitMutation();
     const api = renderKeyframeOps({ commitMutation, trackGsapSaveFailure: vi.fn() });
diff --git a/packages/studio/src/hooks/useGsapKeyframeOps.ts b/packages/studio/src/hooks/useGsapKeyframeOps.ts
index fe105e644f..c24d4fd488 100644
--- a/packages/studio/src/hooks/useGsapKeyframeOps.ts
+++ b/packages/studio/src/hooks/useGsapKeyframeOps.ts
@@ -15,12 +15,7 @@ import {
 } from "../utils/sdkCutover";
 import type { KeyframeCacheEntry } from "../player/store/playerStore";
 import { commitKeyframeAtTimeImpl } from "./gsapKeyframeCommit";
-import { idFromSelector } from "./gsapShared";
-import {
-  clearKeyframeCacheForElement,
-  readKeyframeSnapshot,
-  writeKeyframeCache,
-} from "./gsapKeyframeCacheHelpers";
+import { readKeyframeSnapshot, writeKeyframeCache } from "./gsapKeyframeCacheHelpers";
 import type {
   CommitMutation,
   CommitMutationOptions,
@@ -336,11 +331,6 @@ export function useGsapKeyframeOps({
   const removeAllKeyframes = useCallback(
     async (selection: DomEditSelection, animationId: string) => {
       const targetPath = selection.sourceFile || activeCompPath || "index.html";
-      // remove-all-keyframes collapses the tween to a static hold and the commit
-      // path doesn't return parsed animations, so the keyframe cache is never
-      // refreshed — clear it here so the timeline diamonds disappear immediately.
-      const elementId = selection.id ?? idFromSelector(selection.selector);
-      if (elementId) clearKeyframeCacheForElement(targetPath, elementId);
       if (sdkSession && sdkDeps) {
         const handled = await sdkGsapRemoveAllKeyframesPersist(
           targetPath,
@@ -351,7 +341,7 @@ export function useGsapKeyframeOps({
         );
         if (cutoverCommittedOrThrow(handled)) return;
       }
-      commitMutationSafely(
+      await commitMutationSafely(
         selection,
         { type: "remove-all-keyframes", animationId },
         { label: "Remove all keyframes", softReload: true },
diff --git a/packages/studio/src/player/components/KeyframeDiamondContextMenu.test.tsx b/packages/studio/src/player/components/KeyframeDiamondContextMenu.test.tsx
new file mode 100644
index 0000000000..f1317d84af
--- /dev/null
+++ b/packages/studio/src/player/components/KeyframeDiamondContextMenu.test.tsx
@@ -0,0 +1,53 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import { KeyframeDiamondContextMenu } from "./KeyframeDiamondContextMenu";
+
+Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
+
+afterEach(() => {
+  document.body.innerHTML = "";
+});
+
+describe("KeyframeDiamondContextMenu", () => {
+  it("deletes all keyframes from the animation that opened the menu", () => {
+    const element: TimelineElement = {
+      id: "box",
+      tag: "div",
+      start: 0,
+      duration: 2,
+      track: 0,
+    };
+    const onDeleteAll = vi.fn();
+    const root = createRoot(document.createElement("div"));
+
+    act(() => {
+      root.render(
+        <KeyframeDiamondContextMenu
+          state={{
+            x: 10,
+            y: 10,
+            element,
+            elementId: "box",
+            percentage: 50,
+            animationId: "box-scale",
+          }}
+          onClose={vi.fn()}
+          onDelete={vi.fn()}
+          onDeleteAll={onDeleteAll}
+        />,
+      );
+    });
+
+    const deleteAll = [...document.querySelectorAll("button")].find(
+      (button) => button.textContent === "Delete All Keyframes",
+    );
+    act(() => deleteAll?.click());
+
+    expect(onDeleteAll).toHaveBeenCalledExactlyOnceWith(element, "box-scale");
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx b/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
index 8bf5dce5c2..e5bf0a7812 100644
--- a/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
+++ b/packages/studio/src/player/components/KeyframeDiamondContextMenu.tsx
@@ -7,6 +7,8 @@ import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
 export interface KeyframeDiamondContextMenuState {
   x: number;
   y: number;
+  /** Timeline project session that created this portaled target. */
+  sessionEpoch?: number;
   element: TimelineElement;
   elementId: string;
   percentage: number;
@@ -20,7 +22,7 @@ interface KeyframeDiamondContextMenuProps {
   state: KeyframeDiamondContextMenuState;
   onClose: () => void;
   onDelete: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
-  onDeleteAll: (element: TimelineElement) => void;
+  onDeleteAll: (element: TimelineElement, animationId?: string) => void;
   onChangeEase?: (elementId: string, percentage: number, ease: string) => void;
   onCopyProperties?: (elementId: string, percentage: number) => void;
   /** Retime the keyframe to the current playhead, preserving its value + ease. */
@@ -88,7 +90,7 @@ export const KeyframeDiamondContextMenu = memo(function KeyframeDiamondContextMe
         type="button"
         className="w-full flex items-center gap-2 px-3 py-1.5 text-xs text-red-400 hover:bg-neutral-800 cursor-pointer text-left"
         onClick={() => {
-          onDeleteAll(state.element);
+          onDeleteAll(state.element, state.animationId);
           onClose();
         }}
       >
diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 8a8ec501b1..5dd1dc0247 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -12,7 +12,7 @@ import { TimelineEmptyState } from "./TimelineEmptyState";
 import { TimelineCanvas } from "./TimelineCanvas";
 import { type KeyframeDiamondContextMenuState } from "./KeyframeDiamondContextMenu";
 import { useTimelineClipDrag } from "./useTimelineClipDrag";
-import { TimelineOverlays } from "./TimelineOverlays";
+import { TimelineOverlays, type ClipContextMenuState } from "./TimelineOverlays";
 import { useTimelineEditPinning } from "./useTimelineEditPinning";
 import { useTimelineStackingSync } from "./useTimelineStackingSync";
 import { useTimelineGeometry } from "./useTimelineGeometry";
@@ -151,19 +151,12 @@ export const Timeline = memo(function Timeline({
   const [hoveredClip, setHoveredClip] = useState<string | null>(null);
   const isDragging = useRef(false);
   const shiftHeld = useTimelineShiftModifier();
-
   const [showPopover, setShowPopover] = useState(false);
   const [kfContextMenu, setKfContextMenu] = useState<KeyframeDiamondContextMenuState | null>(null);
-  const [clipContextMenu, setClipContextMenu] = useState<{
-    x: number;
-    y: number;
-    element: TimelineElement;
-  } | null>(null);
-
+  const [clipContextMenu, setClipContextMenu] = useState<ClipContextMenuState | null>(null);
   const setContainerRef = useCallback((el: HTMLDivElement | null) => {
     containerRef.current = el;
   }, []);
-
   const lastScrollLeftRef = useRef(0);
 
   const effectiveDuration = useMemo(
@@ -562,7 +555,12 @@ export const Timeline = memo(function Timeline({
             setSelectedElementId(el.key ?? el.id);
             onSelectElement?.(el);
             dismissGapMenu();
-            setClipContextMenu({ x: e.clientX, y: e.clientY, element: el });
+            setClipContextMenu({
+              x: e.clientX,
+              y: e.clientY,
+              element: el,
+              sessionEpoch: usePlayerStore.getState().timelineSessionEpoch,
+            });
           }}
           onContextMenuLane={(e, track, time) => {
             if (draggedClip?.started || resizingClip) return;
@@ -573,6 +571,8 @@ export const Timeline = memo(function Timeline({
         {activeTool === "razor" && razorGuideX !== null && <TimelineRazorGuide x={razorGuideX} />}
       </div>
       <TimelineOverlays
+        elements={expandedElements}
+        elementsRef={expandedElementsRef}
         theme={theme}
         showShortcutHint={showShortcutHint}
         showPopover={showPopover}
diff --git a/packages/studio/src/player/components/TimelineOverlays.test.ts b/packages/studio/src/player/components/TimelineOverlays.test.ts
new file mode 100644
index 0000000000..67d1c4c971
--- /dev/null
+++ b/packages/studio/src/player/components/TimelineOverlays.test.ts
@@ -0,0 +1,54 @@
+import { describe, expect, it } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import { resolveTimelineContextElement } from "./TimelineOverlays";
+
+const captured: TimelineElement = {
+  id: "child",
+  key: "parent::child",
+  tag: "div",
+  start: 1,
+  duration: 2,
+  track: 3,
+};
+
+describe("resolveTimelineContextElement", () => {
+  it("returns the current expanded model instead of the captured snapshot", () => {
+    const current = { ...captured, start: 4, track: 7 };
+
+    expect(
+      resolveTimelineContextElement({
+        capturedElement: captured,
+        targetSessionEpoch: 2,
+        sessionEpoch: 2,
+        selectedElementId: "parent::child",
+        elements: [current],
+      }),
+    ).toBe(current);
+  });
+
+  it("resolves synthetic expanded children that are absent from raw store elements", () => {
+    expect(
+      resolveTimelineContextElement({
+        capturedElement: captured,
+        targetSessionEpoch: 2,
+        sessionEpoch: 2,
+        selectedElementId: "parent::child",
+        elements: [captured],
+      }),
+    ).toBe(captured);
+  });
+
+  it("rejects stale sessions, changed selection, and removed elements", () => {
+    const input = {
+      capturedElement: captured,
+      targetSessionEpoch: 2,
+      sessionEpoch: 2,
+      selectedElementId: "parent::child",
+      elements: [captured],
+    };
+
+    expect(resolveTimelineContextElement({ ...input, sessionEpoch: 3 })).toBeNull();
+    expect(resolveTimelineContextElement({ ...input, selectedElementId: "other" })).toBeNull();
+    expect(resolveTimelineContextElement({ ...input, elements: [] })).toBeNull();
+  });
+});
diff --git a/packages/studio/src/player/components/TimelineOverlays.tsx b/packages/studio/src/player/components/TimelineOverlays.tsx
index 76a309a4e4..de8f4bf626 100644
--- a/packages/studio/src/player/components/TimelineOverlays.tsx
+++ b/packages/studio/src/player/components/TimelineOverlays.tsx
@@ -1,4 +1,6 @@
+import { useEffect, type MutableRefObject } from "react";
 import type { KeyframeCacheEntry, TimelineElement } from "../store/playerStore";
+import { usePlayerStore } from "../store/playerStore";
 import type { TimelineTheme } from "./timelineTheme";
 import type { TimelineRangeSelection } from "./timelineEditing";
 import type { TimelineEditCallbacks } from "./timelineCallbacks";
@@ -11,10 +13,11 @@ import { ClipContextMenu } from "./ClipContextMenu";
 import { TrackGapContextMenu } from "./TrackGapContextMenu";
 import { TimelineShortcutHint } from "./TimelineShortcutHint";
 
-interface ClipContextMenuState {
+export interface ClipContextMenuState {
   x: number;
   y: number;
   element: TimelineElement;
+  sessionEpoch: number;
 }
 
 /** Resolved model for the empty-lane-space (track gap) context menu. */
@@ -28,6 +31,8 @@ interface TrackGapContextMenuState {
 }
 
 interface TimelineOverlaysProps {
+  elements: readonly TimelineElement[];
+  elementsRef: MutableRefObject<readonly TimelineElement[]>;
   theme: TimelineTheme;
   showShortcutHint: boolean;
   showPopover: boolean;
@@ -54,10 +59,49 @@ interface TimelineOverlaysProps {
   onHoverGapAction: (action: "close-gap" | "close-all" | null) => void;
 }
 
+interface TimelineContextTargetInput {
+  capturedElement: TimelineElement;
+  targetSessionEpoch: number | undefined;
+  sessionEpoch: number;
+  selectedElementId: string | null;
+  elements: readonly TimelineElement[];
+}
+
+/** The captured project session and current selection jointly own a context target. */
+export function resolveTimelineContextElement({
+  capturedElement,
+  targetSessionEpoch,
+  sessionEpoch,
+  selectedElementId,
+  elements,
+}: TimelineContextTargetInput): TimelineElement | null {
+  const identity = capturedElement.key ?? capturedElement.id;
+  if (targetSessionEpoch !== sessionEpoch) return null;
+  if (selectedElementId !== identity) return null;
+  return elements.find((element) => (element.key ?? element.id) === identity) ?? null;
+}
+
+function readTimelineContextElement(
+  capturedElement: TimelineElement,
+  targetSessionEpoch: number | undefined,
+  elements: readonly TimelineElement[],
+): TimelineElement | null {
+  const state = usePlayerStore.getState();
+  return resolveTimelineContextElement({
+    capturedElement,
+    targetSessionEpoch,
+    sessionEpoch: state.timelineSessionEpoch,
+    selectedElementId: state.selectedElementId,
+    elements,
+  });
+}
+
 // The timeline's floating overlays, rendered as siblings above the scroll area:
 // the shortcut hint, the range-edit popover, the keyframe-diamond context menu,
 // and the clip context menu.
 export function TimelineOverlays({
+  elements,
+  elementsRef,
   theme,
   showShortcutHint,
   showPopover,
@@ -83,6 +127,39 @@ export function TimelineOverlays({
   onCloseAllTrackGaps,
   onHoverGapAction,
 }: TimelineOverlaysProps) {
+  const selectedElementId = usePlayerStore((state) => state.selectedElementId);
+  const sessionEpoch = usePlayerStore((state) => state.timelineSessionEpoch);
+  const kfTargetSessionEpoch = kfContextMenu?.sessionEpoch;
+  const clipTargetSessionEpoch = clipContextMenu?.sessionEpoch;
+  const keyframeElement = kfContextMenu
+    ? resolveTimelineContextElement({
+        capturedElement: kfContextMenu.element,
+        targetSessionEpoch: kfTargetSessionEpoch,
+        sessionEpoch,
+        selectedElementId,
+        elements,
+      })
+    : null;
+  const clipElement = clipContextMenu
+    ? resolveTimelineContextElement({
+        capturedElement: clipContextMenu.element,
+        targetSessionEpoch: clipTargetSessionEpoch,
+        sessionEpoch,
+        selectedElementId,
+        elements,
+      })
+    : null;
+  const readCurrentElement = (element: TimelineElement, targetSessionEpoch: number | undefined) =>
+    readTimelineContextElement(element, targetSessionEpoch, elementsRef.current);
+
+  useEffect(() => {
+    if (kfContextMenu && !keyframeElement) setKfContextMenu(null);
+  }, [keyframeElement, kfContextMenu, setKfContextMenu]);
+
+  useEffect(() => {
+    if (clipContextMenu && !clipElement) setClipContextMenu(null);
+  }, [clipContextMenu, clipElement, setClipContextMenu]);
+
   return (
     <>
       {showShortcutHint && !showPopover && !rangeSelection && (
@@ -102,17 +179,32 @@ export function TimelineOverlays({
         />
       )}
 
-      {kfContextMenu && (
+      {kfContextMenu && keyframeElement && (
         <KeyframeDiamondContextMenu
-          state={kfContextMenu}
+          state={{ ...kfContextMenu, element: keyframeElement }}
           onClose={() => setKfContextMenu(null)}
-          onDelete={(...args) => onDeleteKeyframe?.(...args)}
-          onDeleteAll={(element) => onDeleteAllKeyframes?.(element)}
-          onChangeEase={(elId, pct, ease) => onChangeKeyframeEase?.(elId, pct, ease)}
+          onDelete={(...args) => {
+            if (!readCurrentElement(keyframeElement, kfTargetSessionEpoch)) return;
+            onDeleteKeyframe?.(...args);
+          }}
+          onDeleteAll={(_element, animationId) => {
+            const element = readCurrentElement(keyframeElement, kfTargetSessionEpoch);
+            if (element) onDeleteAllKeyframes?.(element, animationId);
+          }}
+          onChangeEase={(elId, pct, ease) => {
+            if (!readCurrentElement(keyframeElement, kfTargetSessionEpoch)) return;
+            onChangeKeyframeEase?.(elId, pct, ease);
+          }}
           onMoveToPlayhead={
-            onMoveKeyframeToPlayhead ? (...args) => onMoveKeyframeToPlayhead(...args) : undefined
+            onMoveKeyframeToPlayhead
+              ? (_element, ...args) => {
+                  const element = readCurrentElement(keyframeElement, kfTargetSessionEpoch);
+                  if (element) onMoveKeyframeToPlayhead(element, ...args);
+                }
+              : undefined
           }
           onCopyProperties={(elId, pct) => {
+            if (!readCurrentElement(keyframeElement, kfTargetSessionEpoch)) return;
             const kfData = keyframeCache.get(elId);
             const kf = kfData?.keyframes.find((k) => k.percentage === pct);
             if (kf) {
@@ -122,17 +214,22 @@ export function TimelineOverlays({
         />
       )}
 
-      {clipContextMenu && (
+      {clipContextMenu && clipElement && (
         <ClipContextMenu
           x={clipContextMenu.x}
           y={clipContextMenu.y}
-          element={clipContextMenu.element}
+          element={clipElement}
           currentTime={currentTime}
           onClose={() => setClipContextMenu(null)}
-          onSplit={(el, time) => onSplitElement?.(el, time)}
-          onDelete={(el) => {
+          onSplit={(_element, time) => {
+            const element = readCurrentElement(clipElement, clipTargetSessionEpoch);
+            if (element) onSplitElement?.(element, time);
+          }}
+          onDelete={() => {
+            const element = readCurrentElement(clipElement, clipTargetSessionEpoch);
+            if (!element) return;
             pinZoomBeforeEdit();
-            onDeleteElement?.(el);
+            onDeleteElement?.(element);
           }}
         />
       )}
diff --git a/packages/studio/src/player/components/timelineCallbacks.ts b/packages/studio/src/player/components/timelineCallbacks.ts
index 969cc0ab31..9533b17456 100644
--- a/packages/studio/src/player/components/timelineCallbacks.ts
+++ b/packages/studio/src/player/components/timelineCallbacks.ts
@@ -73,7 +73,7 @@ export interface TimelineEditCallbacks {
   onRazorSplit?: (element: TimelineElement, splitTime: number) => Promise<void> | void;
   onRazorSplitAll?: (splitTime: number) => Promise<void> | void;
   onDeleteKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
-  onDeleteAllKeyframes?: (element: TimelineElement) => void;
+  onDeleteAllKeyframes?: (element: TimelineElement, animationId?: string) => void;
   onChangeKeyframeEase?: (elementId: string, percentage: number, ease: string) => void;
   onMoveKeyframeToPlayhead?: (element: TimelineElement, keyframe: TimelineKeyframeTarget) => void;
   /** Drag-to-retime: `keyframe` identifies the dragged keyframe (its percentage
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
index f1060933a8..f2cdca96a5 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
@@ -45,7 +45,7 @@ const COLLIDING_TARGET: TimelineKeyframeTarget = {
 afterEach(() => {
   document.body.innerHTML = "";
   vi.restoreAllMocks();
-  usePlayerStore.setState({ focusedEaseSegment: null });
+  usePlayerStore.setState({ focusedEaseSegment: null, timelineSessionEpoch: 0 });
 });
 
 describe("useTimelineKeyframeHandlers", () => {
@@ -144,4 +144,39 @@ describe("useTimelineKeyframeHandlers", () => {
     expect(onSeek).toHaveBeenCalledExactlyOnceWith(2);
     act(() => root.unmount());
   });
+
+  it("scopes a keyframe context target to the opening timeline session", () => {
+    const setKfContextMenu = vi.fn();
+    usePlayerStore.setState({ timelineSessionEpoch: 4 });
+
+    function Harness() {
+      const { onContextMenuKeyframe } = useTimelineKeyframeHandlers({
+        expandedElements: [ELEMENT],
+        keyframeCache: new Map(),
+        setSelectedElementId: vi.fn(),
+        setKfContextMenu,
+        toggleSelectedKeyframe: vi.fn(),
+      });
+      return (
+        <button
+          type="button"
+          onContextMenu={(event) => onContextMenuKeyframe(event, ELEMENT.id, TARGET)}
+        />
+      );
+    }
+
+    const root = mountReactHarness(<Harness />);
+    const button = document.querySelector("button");
+    expect(button).not.toBeNull();
+    act(() => {
+      button?.dispatchEvent(
+        new MouseEvent("contextmenu", { bubbles: true, clientX: 10, clientY: 20 }),
+      );
+    });
+
+    expect(setKfContextMenu).toHaveBeenCalledWith(
+      expect.objectContaining({ elementId: ELEMENT.id, sessionEpoch: 4, x: 14, y: 22 }),
+    );
+    act(() => root.unmount());
+  });
 });
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
index 270b17f697..b112e85388 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.ts
@@ -485,12 +485,13 @@ export function useTimelineKeyframeHandlers({
       setKfContextMenu({
         x: e.clientX + 4,
         y: e.clientY + 2,
+        sessionEpoch: usePlayerStore.getState().timelineSessionEpoch,
+        element: el,
         elementId: elId,
         percentage: target.percentage,
         tweenPercentage: target.tweenPercentage ?? kf?.tweenPercentage,
         propertyGroup: target.propertyGroup,
         animationId: target.animationId,
-        element: el,
         currentEase: kf?.ease ?? kfData?.ease,
       });
     },
diff --git a/packages/studio/src/player/components/useTrackGapMenu.test.tsx b/packages/studio/src/player/components/useTrackGapMenu.test.tsx
new file mode 100644
index 0000000000..611f47f5a8
--- /dev/null
+++ b/packages/studio/src/player/components/useTrackGapMenu.test.tsx
@@ -0,0 +1,64 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { usePlayerStore, type TimelineElement } from "../store/playerStore";
+import { useTrackGapMenu } from "./useTrackGapMenu";
+
+(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+const lane: TimelineElement[] = [
+  { id: "first", tag: "div", start: 0, duration: 1, track: 0 },
+  { id: "second", tag: "div", start: 3, duration: 1, track: 0 },
+];
+
+afterEach(() => {
+  usePlayerStore.getState().reset();
+  document.body.innerHTML = "";
+});
+
+describe("useTrackGapMenu", () => {
+  it("does not commit an anchor captured in a previous project session", () => {
+    usePlayerStore.setState({ elements: lane, timelineSessionEpoch: 1 });
+    const host = document.createElement("div");
+    document.body.append(host);
+    const root = createRoot(host);
+    const onMoveElement = vi.fn();
+    const onMoveElements = vi.fn();
+    let api: ReturnType<typeof useTrackGapMenu> | null = null;
+
+    function getApi(): ReturnType<typeof useTrackGapMenu> {
+      if (!api) throw new Error("gap menu harness did not render");
+      return api;
+    }
+
+    function Probe() {
+      api = useTrackGapMenu({
+        tracks: [[0, lane]],
+        expandedElementsRef: { current: lane },
+        trackOrderRef: { current: [0] },
+        onMoveElement,
+        onMoveElements,
+      });
+      return null;
+    }
+
+    act(() => root.render(<Probe />));
+    act(() => getApi().openGapMenu({ x: 10, y: 20, track: 0, time: 2 }));
+    expect(getApi().gapMenuModel).not.toBeNull();
+    const staleCloseTrackGap = getApi().closeTrackGap;
+    const staleCloseAllTrackGaps = getApi().closeAllTrackGaps;
+
+    act(() => {
+      usePlayerStore.setState({ timelineSessionEpoch: 2 });
+      staleCloseTrackGap();
+      staleCloseAllTrackGaps();
+    });
+    expect(getApi().gapMenuModel).toBeNull();
+
+    expect(onMoveElement).not.toHaveBeenCalled();
+    expect(onMoveElements).not.toHaveBeenCalled();
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useTrackGapMenu.ts b/packages/studio/src/player/components/useTrackGapMenu.ts
index 7339171ee3..453d52ba7b 100644
--- a/packages/studio/src/player/components/useTrackGapMenu.ts
+++ b/packages/studio/src/player/components/useTrackGapMenu.ts
@@ -1,4 +1,4 @@
-import { useCallback, useMemo, useState, type MutableRefObject } from "react";
+import { useCallback, useEffect, useMemo, useState, type MutableRefObject } from "react";
 import { usePlayerStore, type TimelineElement } from "../store/playerStore";
 import type { DragCommitDeps } from "./timelineClipDragCommit";
 import {
@@ -21,6 +21,7 @@ interface TrackGapMenuAnchor {
   y: number;
   track: number;
   time: number;
+  sessionEpoch: number;
 }
 
 /** Gap strips to paint on one lane while a menu row is hovered. */
@@ -32,9 +33,9 @@ export interface TrackGapHighlight {
 /**
  * Track-gap context menu (right-click on empty lane space) — state, the
  * derived menu model, and the two commit actions. Extracted from Timeline.tsx
- * as a cohesive unit (600-line studio cap); behavior identical.
+ * as a cohesive unit (600-line studio cap).
  *
- * Only the ANCHOR (and the hovered row) is state; the menu model (gap under
+ * Only the session-stamped ANCHOR (and the hovered row) is state; the menu model (gap under
  * the pointer, compaction, movability) derives from live `tracks` so an open
  * menu reflects concurrent edits. `gapHighlight` — the strips TimelineCanvas
  * paints while "Close gap" / "Close all gaps" is hovered — derives the same
@@ -55,12 +56,16 @@ export function useTrackGapMenu({
   onMoveElements: DragCommitDeps["onMoveElements"];
 }) {
   const updateElement = usePlayerStore((s) => s.updateElement);
+  const sessionEpoch = usePlayerStore((s) => s.timelineSessionEpoch);
   const [gapContextMenu, setGapContextMenu] = useState<TrackGapMenuAnchor | null>(null);
   const [hoveredGapAction, setHoveredGapAction] = useState<"close-gap" | "close-all" | null>(null);
 
   const gapMenuLaneElements = useMemo(
-    () => (gapContextMenu ? (tracks.find(([t]) => t === gapContextMenu.track)?.[1] ?? []) : null),
-    [gapContextMenu, tracks],
+    () =>
+      gapContextMenu?.sessionEpoch === sessionEpoch
+        ? (tracks.find(([t]) => t === gapContextMenu.track)?.[1] ?? [])
+        : null,
+    [gapContextMenu, sessionEpoch, tracks],
   );
   const gapMenuModel = useMemo(() => {
     if (!gapContextMenu || !gapMenuLaneElements) return null;
@@ -99,7 +104,12 @@ export function useTrackGapMenu({
   }, [gapContextMenu, gapMenuLaneElements, hoveredGapAction]);
 
   const closeTrackGap = useCallback(() => {
-    if (!gapContextMenu || !gapMenuLaneElements) return;
+    if (
+      !gapContextMenu ||
+      !gapMenuLaneElements ||
+      gapContextMenu.sessionEpoch !== usePlayerStore.getState().timelineSessionEpoch
+    )
+      return;
     commitCloseTrackGap(gapMenuLaneElements, gapContextMenu.time, {
       elements: expandedElementsRef.current,
       trackOrder: trackOrderRef.current,
@@ -117,7 +127,12 @@ export function useTrackGapMenu({
     onMoveElements,
   ]);
   const closeAllTrackGaps = useCallback(() => {
-    if (!gapMenuLaneElements) return;
+    if (
+      !gapContextMenu ||
+      !gapMenuLaneElements ||
+      gapContextMenu.sessionEpoch !== usePlayerStore.getState().timelineSessionEpoch
+    )
+      return;
     commitCloseAllTrackGaps(gapMenuLaneElements, {
       elements: expandedElementsRef.current,
       trackOrder: trackOrderRef.current,
@@ -126,6 +141,7 @@ export function useTrackGapMenu({
       onMoveElements,
     });
   }, [
+    gapContextMenu,
     gapMenuLaneElements,
     expandedElementsRef,
     trackOrderRef,
@@ -134,15 +150,22 @@ export function useTrackGapMenu({
     onMoveElements,
   ]);
 
-  const openGapMenu = useCallback((anchor: TrackGapMenuAnchor) => {
+  const openGapMenu = useCallback((anchor: Omit<TrackGapMenuAnchor, "sessionEpoch">) => {
     setHoveredGapAction(null);
-    setGapContextMenu(anchor);
+    setGapContextMenu({
+      ...anchor,
+      sessionEpoch: usePlayerStore.getState().timelineSessionEpoch,
+    });
   }, []);
   const dismissGapMenu = useCallback(() => {
     setHoveredGapAction(null);
     setGapContextMenu(null);
   }, []);
 
+  useEffect(() => {
+    if (gapContextMenu && gapContextMenu.sessionEpoch !== sessionEpoch) dismissGapMenu();
+  }, [dismissGapMenu, gapContextMenu, sessionEpoch]);
+
   return {
     gapMenuModel,
     gapHighlight,

From fd5591940893d544c83f4828ac52c6d2ddd72ac4 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Sat, 18 Jul 2026 21:50:17 +0200
Subject: [PATCH 118/125] perf(studio): stabilize virtualized beat gestures

---
 .../src/player/components/BeatStrip.test.tsx  | 315 ++++++++++++++++++
 .../src/player/components/BeatStrip.tsx       | 290 ++++++++++++++--
 2 files changed, 570 insertions(+), 35 deletions(-)
 create mode 100644 packages/studio/src/player/components/BeatStrip.test.tsx

diff --git a/packages/studio/src/player/components/BeatStrip.test.tsx b/packages/studio/src/player/components/BeatStrip.test.tsx
new file mode 100644
index 0000000000..e29eed3f5f
--- /dev/null
+++ b/packages/studio/src/player/components/BeatStrip.test.tsx
@@ -0,0 +1,315 @@
+// @vitest-environment happy-dom
+
+import React, { act } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import { usePlayerStore } from "../store/playerStore";
+import { BeatStrip } from "./BeatStrip";
+
+(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+const roots: Root[] = [];
+const requestSeek = vi.fn();
+const commitBeatEdits = usePlayerStore.getState().commitBeatEdits;
+const commitBeatEditsSpy = vi.fn((...args: Parameters<typeof commitBeatEdits>) =>
+  commitBeatEdits(...args),
+);
+const MUSIC_ELEMENT: TimelineElement = {
+  id: "background-music",
+  label: "Music",
+  tag: "audio",
+  src: "music.mp3",
+  start: 0,
+  duration: 10,
+  track: 0,
+  timelineRole: "music",
+};
+const BEAT_ANALYSIS = {
+  beatTimes: [1, 3],
+  beatStrengths: [0.5, 0.8],
+  bpm: 120,
+  bpmConfidence: "high" as const,
+  channelData: null,
+  sampleRate: 48_000,
+  peak: 1,
+};
+
+function pointerEvent(type: string, init: PointerEventInit): Event {
+  if (typeof PointerEvent === "function") return new PointerEvent(type, init);
+  const event = new MouseEvent(type, init);
+  Object.defineProperty(event, "pointerId", { value: init.pointerId ?? 0 });
+  return event;
+}
+
+function mountBeatStrip(renderTimeRange?: { start: number; end: number }) {
+  const viewport = document.createElement("div");
+  viewport.dataset.timelineScrollViewport = "";
+  Object.defineProperties(viewport, {
+    clientWidth: { configurable: true, value: 500 },
+    clientHeight: { configurable: true, value: 300 },
+    scrollWidth: { configurable: true, value: 2_000 },
+    scrollHeight: { configurable: true, value: 2_000 },
+  });
+  viewport.getBoundingClientRect = () =>
+    ({ left: 0, right: 1_000, top: 0, bottom: 500, width: 1_000, height: 500 }) as DOMRect;
+  Object.assign(viewport, {
+    setPointerCapture: vi.fn(),
+    hasPointerCapture: vi.fn(() => true),
+    releasePointerCapture: vi.fn(),
+  });
+  document.body.appendChild(viewport);
+  const root = createRoot(viewport);
+  roots.push(root);
+  act(() => {
+    root.render(
+      <BeatStrip
+        beatTimes={[1, 3]}
+        beatStrengths={[0.5, 0.8]}
+        pps={100}
+        renderTimeRange={renderTimeRange}
+      />,
+    );
+  });
+  return { root, viewport };
+}
+
+function firstBeat(): HTMLDivElement {
+  const beat = document.querySelector<HTMLDivElement>(
+    '[title="Drag to move · double-click to delete"]',
+  );
+  if (!beat) throw new Error("Expected a beat handle");
+  return beat;
+}
+
+function startBeatDrag(clientX = 100, pointerId = 1): void {
+  act(() => {
+    firstBeat().dispatchEvent(
+      pointerEvent("pointerdown", { bubbles: true, button: 0, clientX, clientY: 100, pointerId }),
+    );
+  });
+  expect(usePlayerStore.getState().beatDragging).toBe(true);
+}
+
+beforeEach(() => {
+  commitBeatEditsSpy.mockClear();
+  requestSeek.mockReset();
+  usePlayerStore.setState({
+    timelineSessionEpoch: 1,
+    timelineProjectId: "project-a",
+    beatDragging: false,
+    requestSeek,
+    elements: [MUSIC_ELEMENT],
+    beatAnalysis: BEAT_ANALYSIS,
+    beatEdits: null,
+    commitBeatEdits: commitBeatEditsSpy,
+  });
+});
+
+afterEach(() => {
+  act(() => window.dispatchEvent(new Event("blur")));
+  for (const root of roots.splice(0)) act(() => root.unmount());
+  document.body.innerHTML = "";
+  vi.unstubAllGlobals();
+});
+
+describe("BeatStrip gesture ownership", () => {
+  it("commits once after its source row unmounts", () => {
+    const { root } = mountBeatStrip();
+    startBeatDrag();
+    act(() => root.render(null));
+    expect(usePlayerStore.getState().beatDragging).toBe(true);
+
+    act(() => {
+      window.dispatchEvent(
+        pointerEvent("pointermove", {
+          bubbles: true,
+          clientX: 140,
+          clientY: 100,
+          pointerId: 1,
+        }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", {
+          bubbles: true,
+          clientX: 140,
+          clientY: 100,
+          pointerId: 1,
+        }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", {
+          bubbles: true,
+          clientX: 160,
+          clientY: 100,
+          pointerId: 1,
+        }),
+      );
+    });
+
+    expect(commitBeatEditsSpy).toHaveBeenCalledExactlyOnceWith(expect.anything(), "move beat");
+    expect(usePlayerStore.getState().beatEdits?.added[0]?.time).toBe(1.4);
+    expect(usePlayerStore.getState().beatDragging).toBe(false);
+  });
+
+  it("includes viewport scrolling in the final beat time", () => {
+    const { viewport } = mountBeatStrip();
+    startBeatDrag(100);
+    viewport.scrollLeft = 50;
+
+    act(() => {
+      window.dispatchEvent(
+        pointerEvent("pointerup", {
+          bubbles: true,
+          clientX: 110,
+          clientY: 100,
+          pointerId: 1,
+        }),
+      );
+    });
+
+    expect(commitBeatEditsSpy).toHaveBeenCalledExactlyOnceWith(expect.anything(), "move beat");
+    expect(usePlayerStore.getState().beatEdits?.added[0]?.time).toBe(1.6);
+  });
+
+  it("cancels without mutation on pointer cancel, Escape, and project switch", () => {
+    mountBeatStrip();
+    startBeatDrag();
+    act(() => {
+      window.dispatchEvent(pointerEvent("pointercancel", { pointerId: 1 }));
+      window.dispatchEvent(pointerEvent("pointerup", { clientX: 140, clientY: 100, pointerId: 1 }));
+    });
+
+    startBeatDrag();
+    act(() => window.dispatchEvent(new KeyboardEvent("keydown", { key: "Escape" })));
+
+    startBeatDrag();
+    act(() => usePlayerStore.getState().beginTimelineSession("project-b"));
+    act(() => {
+      window.dispatchEvent(pointerEvent("pointerup", { clientX: 140, clientY: 100, pointerId: 1 }));
+    });
+
+    expect(commitBeatEditsSpy).not.toHaveBeenCalled();
+    expect(usePlayerStore.getState().beatDragging).toBe(false);
+  });
+
+  it("cancels without mutation when the captured music source disappears", () => {
+    mountBeatStrip();
+    startBeatDrag();
+    act(() => usePlayerStore.setState({ elements: [] }));
+    act(() => {
+      window.dispatchEvent(pointerEvent("pointerup", { clientX: 140, clientY: 100, pointerId: 1 }));
+    });
+
+    expect(commitBeatEditsSpy).not.toHaveBeenCalled();
+    expect(usePlayerStore.getState().beatDragging).toBe(false);
+  });
+
+  it("cancels when the captured beat disappears during the gesture", () => {
+    mountBeatStrip();
+    startBeatDrag();
+    act(() => {
+      usePlayerStore.setState({
+        beatAnalysis: { ...BEAT_ANALYSIS, beatTimes: [3], beatStrengths: [0.8] },
+      });
+      window.dispatchEvent(pointerEvent("pointerup", { clientX: 140, clientY: 100, pointerId: 1 }));
+    });
+
+    expect(commitBeatEditsSpy).not.toHaveBeenCalled();
+    expect(usePlayerStore.getState().beatDragging).toBe(false);
+  });
+
+  it("releases the actor when the owning timeline viewport unmounts", async () => {
+    const { viewport } = mountBeatStrip();
+    startBeatDrag();
+
+    await act(async () => {
+      viewport.remove();
+      await Promise.resolve();
+    });
+    act(() => {
+      window.dispatchEvent(pointerEvent("pointerup", { clientX: 140, clientY: 100, pointerId: 1 }));
+    });
+
+    expect(commitBeatEditsSpy).not.toHaveBeenCalled();
+    expect(usePlayerStore.getState().beatDragging).toBe(false);
+  });
+
+  it("ignores unrelated pointers and keeps the active beat rendered outside the time window", () => {
+    const { root } = mountBeatStrip();
+    startBeatDrag();
+    act(() => {
+      window.dispatchEvent(
+        pointerEvent("pointermove", {
+          bubbles: true,
+          clientX: 150,
+          clientY: 100,
+          pointerId: 2,
+        }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", {
+          bubbles: true,
+          clientX: 150,
+          clientY: 100,
+          pointerId: 2,
+        }),
+      );
+      root.render(
+        <BeatStrip
+          beatTimes={[1, 3]}
+          beatStrengths={[0.5, 0.8]}
+          pps={100}
+          renderTimeRange={{ start: 2.5, end: 3.5 }}
+        />,
+      );
+    });
+
+    expect(
+      document.querySelectorAll('[title="Drag to move · double-click to delete"]'),
+    ).toHaveLength(2);
+    expect(commitBeatEditsSpy).not.toHaveBeenCalled();
+
+    act(() => {
+      window.dispatchEvent(
+        pointerEvent("pointerup", {
+          bubbles: true,
+          clientX: 150,
+          clientY: 100,
+          pointerId: 1,
+        }),
+      );
+    });
+    expect(commitBeatEditsSpy).toHaveBeenCalledOnce();
+  });
+
+  it("does not autoscroll or mutate below the drag threshold", () => {
+    const requestAnimationFrame = vi.fn(() => 1);
+    vi.stubGlobal("requestAnimationFrame", requestAnimationFrame);
+    vi.stubGlobal("cancelAnimationFrame", vi.fn());
+    mountBeatStrip();
+    startBeatDrag(990);
+
+    act(() => {
+      window.dispatchEvent(
+        pointerEvent("pointermove", {
+          bubbles: true,
+          clientX: 991,
+          clientY: 100,
+          pointerId: 1,
+        }),
+      );
+      window.dispatchEvent(
+        pointerEvent("pointerup", {
+          bubbles: true,
+          clientX: 991,
+          clientY: 100,
+          pointerId: 1,
+        }),
+      );
+    });
+
+    expect(requestAnimationFrame).not.toHaveBeenCalled();
+    expect(commitBeatEditsSpy).not.toHaveBeenCalled();
+  });
+});
diff --git a/packages/studio/src/player/components/BeatStrip.tsx b/packages/studio/src/player/components/BeatStrip.tsx
index a7558d56a8..03fad4daa4 100644
--- a/packages/studio/src/player/components/BeatStrip.tsx
+++ b/packages/studio/src/player/components/BeatStrip.tsx
@@ -1,12 +1,250 @@
-import { memo, useRef, useState } from "react";
-import { moveBeatCompositionTime, deleteBeatAtCompositionTime } from "../../utils/beatEditActions";
+import { memo, useSyncExternalStore } from "react";
+import {
+  deleteBeatAtCompositionTime,
+  moveBeatCompositionTime,
+  remapBeatAnalysisToComposition,
+} from "../../utils/beatEditActions";
 import { usePlayerStore } from "../store/playerStore";
 import { CLIP_Y, getTimelineBeatEntries } from "./timelineLayout";
 import type { TimelineTimeRange } from "../lib/timelineClipIndex";
+import {
+  applyTimelineAutoScrollStep,
+  resolveTimelineAutoScrollLoopAction,
+} from "./timelineEditing";
+import { getTimelineElementIndexes } from "../lib/timelineElementIndexes";
 
 export const BEAT_BAND_H = 14; // dark band height at top of track
 const BEAT_HIT_W = 12; // grab width per beat (px)
 
+interface BeatDragActor {
+  readonly pointerId: number;
+  readonly index: number;
+  readonly startX: number;
+  readonly clientX: number;
+  readonly clientY: number;
+  readonly originalTime: number;
+  readonly pixelsPerSecond: number;
+  readonly startScrollLeft: number;
+  readonly dx: number;
+  readonly started: boolean;
+  readonly sessionEpoch: number;
+  readonly projectId: string | null;
+  readonly musicElement: NonNullable<ReturnType<typeof getTimelineElementIndexes>["musicElement"]>;
+  readonly musicKey: string;
+  readonly musicSrc: string;
+  readonly scroll: HTMLElement;
+}
+
+let beatDragActor: BeatDragActor | null = null;
+let beatDragRaf = 0;
+let unsubscribeBeatDragSession: (() => void) | null = null;
+let beatDragViewportObserver: MutationObserver | null = null;
+const beatDragSubscribers = new Set<() => void>();
+
+function publishBeatDrag(next: BeatDragActor | null): void {
+  beatDragActor = next;
+  for (const subscriber of beatDragSubscribers) subscriber();
+}
+
+function subscribeBeatDrag(subscriber: () => void): () => void {
+  beatDragSubscribers.add(subscriber);
+  return () => beatDragSubscribers.delete(subscriber);
+}
+
+function getBeatDragSnapshot(): BeatDragActor | null {
+  return beatDragActor;
+}
+
+function releaseBeatDragResources(actor: BeatDragActor): void {
+  if (beatDragRaf !== 0) {
+    cancelAnimationFrame(beatDragRaf);
+    beatDragRaf = 0;
+  }
+  unsubscribeBeatDragSession?.();
+  unsubscribeBeatDragSession = null;
+  beatDragViewportObserver?.disconnect();
+  beatDragViewportObserver = null;
+  window.removeEventListener("pointermove", handleBeatDragPointerMove);
+  window.removeEventListener("pointerup", handleBeatDragPointerUp);
+  window.removeEventListener("pointercancel", handleBeatDragPointerCancel);
+  window.removeEventListener("lostpointercapture", handleBeatDragPointerCancel);
+  window.removeEventListener("keydown", handleBeatDragKeyDown, true);
+  window.removeEventListener("blur", cancelBeatDrag);
+  try {
+    if (actor.scroll.hasPointerCapture?.(actor.pointerId)) {
+      actor.scroll.releasePointerCapture(actor.pointerId);
+    }
+  } catch {
+    // Window listeners retain terminal ownership when pointer capture is unavailable.
+  }
+  usePlayerStore.getState().setBeatDragging(false);
+}
+
+/** Claiming clears the shared actor before cleanup, so later terminal events are no-ops. */
+function claimBeatDrag(pointerId?: number): BeatDragActor | null {
+  const actor = beatDragActor;
+  if (!actor || (pointerId !== undefined && actor.pointerId !== pointerId)) return null;
+  publishBeatDrag(null);
+  releaseBeatDragResources(actor);
+  return actor;
+}
+
+function cancelBeatDrag(): void {
+  claimBeatDrag();
+}
+
+function beatDragTime(actor: BeatDragActor): number {
+  return Math.max(0, actor.originalTime + actor.dx / actor.pixelsPerSecond);
+}
+
+function isBeatDragSourceCurrent(
+  actor: BeatDragActor,
+  state: ReturnType<typeof usePlayerStore.getState>,
+): boolean {
+  const currentMusic = getTimelineElementIndexes(state.elements).musicElement;
+  if (
+    !actor.scroll.isConnected ||
+    state.timelineSessionEpoch !== actor.sessionEpoch ||
+    state.timelineProjectId !== actor.projectId ||
+    currentMusic !== actor.musicElement ||
+    (currentMusic.key ?? currentMusic.id) !== actor.musicKey ||
+    currentMusic.src !== actor.musicSrc
+  ) {
+    return false;
+  }
+  const analysis = remapBeatAnalysisToComposition(
+    state.beatAnalysis,
+    currentMusic,
+    state.beatEdits,
+  );
+  return analysis?.beatTimes.some((time) => Math.abs(time - actor.originalTime) < 1e-3) === true;
+}
+
+function updateBeatDrag(clientX: number, clientY: number): BeatDragActor | null {
+  const actor = beatDragActor;
+  if (!actor) return null;
+  const pointerDx = clientX - actor.startX;
+  const next = {
+    ...actor,
+    clientX,
+    clientY,
+    dx: pointerDx + actor.scroll.scrollLeft - actor.startScrollLeft,
+    started: actor.started || Math.abs(pointerDx) > 2,
+  };
+  publishBeatDrag(next);
+  usePlayerStore.getState().requestSeek(beatDragTime(next));
+  return next;
+}
+
+function stepBeatDragAutoScroll(): void {
+  beatDragRaf = 0;
+  const actor = beatDragActor;
+  if (!actor?.started) return;
+  if (!applyTimelineAutoScrollStep(actor.scroll, actor.clientX, actor.clientY)) return;
+  updateBeatDrag(actor.clientX, actor.clientY);
+  beatDragRaf = requestAnimationFrame(stepBeatDragAutoScroll);
+}
+
+function syncBeatDragAutoScroll(actor: BeatDragActor): void {
+  const action = resolveTimelineAutoScrollLoopAction(
+    actor.scroll,
+    actor.clientX,
+    actor.clientY,
+    beatDragRaf !== 0,
+  );
+  if (action === "start" && actor.started) {
+    beatDragRaf = requestAnimationFrame(stepBeatDragAutoScroll);
+  } else if (action === "stop" && beatDragRaf !== 0) {
+    cancelAnimationFrame(beatDragRaf);
+    beatDragRaf = 0;
+  }
+}
+
+function handleBeatDragPointerMove(event: PointerEvent): void {
+  if (event.pointerId !== beatDragActor?.pointerId) return;
+  event.preventDefault();
+  const actor = updateBeatDrag(event.clientX, event.clientY);
+  if (actor) syncBeatDragAutoScroll(actor);
+}
+
+function handleBeatDragPointerUp(event: PointerEvent): void {
+  if (event.pointerId !== beatDragActor?.pointerId) return;
+  const latest = updateBeatDrag(event.clientX, event.clientY);
+  const actor = claimBeatDrag(event.pointerId);
+  if (!actor || !latest?.started) return;
+  const store = usePlayerStore.getState();
+  if (!isBeatDragSourceCurrent(actor, store)) return;
+  const newTime = beatDragTime(latest);
+  moveBeatCompositionTime(actor.originalTime, newTime);
+  store.requestSeek(newTime);
+}
+
+function handleBeatDragPointerCancel(event: PointerEvent): void {
+  claimBeatDrag(event.pointerId);
+}
+
+function handleBeatDragKeyDown(event: KeyboardEvent): void {
+  if (event.key !== "Escape" || !beatDragActor) return;
+  event.preventDefault();
+  event.stopPropagation();
+  cancelBeatDrag();
+}
+
+function beginBeatDrag(
+  event: React.PointerEvent<HTMLDivElement>,
+  index: number,
+  originalTime: number,
+  pixelsPerSecond: number,
+): void {
+  if (event.button !== 0 || !(pixelsPerSecond > 0)) return;
+  const scroll = event.currentTarget.closest<HTMLElement>("[data-timeline-scroll-viewport]");
+  if (!scroll) return;
+  cancelBeatDrag();
+  const store = usePlayerStore.getState();
+  const musicElement = getTimelineElementIndexes(store.elements).musicElement;
+  if (!musicElement?.src) return;
+  const actor: BeatDragActor = {
+    pointerId: event.pointerId,
+    index,
+    startX: event.clientX,
+    clientX: event.clientX,
+    clientY: event.clientY,
+    originalTime,
+    pixelsPerSecond,
+    startScrollLeft: scroll.scrollLeft,
+    dx: 0,
+    started: false,
+    sessionEpoch: store.timelineSessionEpoch,
+    projectId: store.timelineProjectId,
+    musicElement,
+    musicKey: musicElement.key ?? musicElement.id,
+    musicSrc: musicElement.src,
+    scroll,
+  };
+  if (!isBeatDragSourceCurrent(actor, store)) return;
+  publishBeatDrag(actor);
+  window.addEventListener("pointermove", handleBeatDragPointerMove);
+  window.addEventListener("pointerup", handleBeatDragPointerUp);
+  window.addEventListener("pointercancel", handleBeatDragPointerCancel);
+  window.addEventListener("lostpointercapture", handleBeatDragPointerCancel);
+  window.addEventListener("keydown", handleBeatDragKeyDown, true);
+  window.addEventListener("blur", cancelBeatDrag);
+  unsubscribeBeatDragSession = usePlayerStore.subscribe((state) => {
+    if (!isBeatDragSourceCurrent(actor, state)) cancelBeatDrag();
+  });
+  beatDragViewportObserver = new MutationObserver(() => {
+    if (!actor.scroll.isConnected) cancelBeatDrag();
+  });
+  beatDragViewportObserver.observe(document, { childList: true, subtree: true });
+  try {
+    scroll.setPointerCapture?.(event.pointerId);
+  } catch {
+    // Window listeners retain terminal ownership when pointer capture is unavailable.
+  }
+  store.setBeatDragging(true);
+  store.requestSeek(Math.max(0, originalTime));
+}
+
 /** Hide both layers when beats are packed tighter than this (px) — too dense to read. */
 function beatsTooDense(beatTimes: number[], pps: number): boolean {
   if (beatTimes.length < 2) return true;
@@ -96,11 +334,22 @@ export const BeatStrip = memo(function BeatStrip({
   pps: number;
   renderTimeRange?: TimelineTimeRange;
 }) {
-  // Active drag: which beat and how far (px) it's been dragged.
-  const [drag, setDrag] = useState<{ index: number; dx: number } | null>(null);
-  const dragRef = useRef<{ index: number; startX: number; origTime: number } | null>(null);
+  const activeActor = useSyncExternalStore(
+    subscribeBeatDrag,
+    getBeatDragSnapshot,
+    getBeatDragSnapshot,
+  );
+  const sessionEpoch = usePlayerStore((state) => state.timelineSessionEpoch);
+  const projectId = usePlayerStore((state) => state.timelineProjectId);
 
   if (!beatTimes || beatsTooDense(beatTimes, pps)) return null;
+  const drag =
+    activeActor &&
+    activeActor.sessionEpoch === sessionEpoch &&
+    activeActor.projectId === projectId &&
+    Math.abs((beatTimes[activeActor.index] ?? Number.NaN) - activeActor.originalTime) < 1e-3
+      ? activeActor
+      : null;
   const cy = BEAT_BAND_H / 2;
   const beatEntries = getTimelineBeatEntries(
     beatTimes,
@@ -141,36 +390,7 @@ export const BeatStrip = memo(function BeatStrip({
               // selection (which otherwise "selects" the whole panel mid-drag).
               e.preventDefault();
               e.stopPropagation();
-              e.currentTarget.setPointerCapture(e.pointerId);
-              dragRef.current = { index: i, startX: e.clientX, origTime: t };
-              setDrag({ index: i, dx: 0 });
-              usePlayerStore.getState().setBeatDragging(true); // hide the playhead guideline
-              usePlayerStore.getState().requestSeek(Math.max(0, t)); // scrub audio at beat
-            }}
-            onPointerMove={(e) => {
-              const d = dragRef.current;
-              if (!d || d.index !== i) return;
-              e.preventDefault();
-              const dx = e.clientX - d.startX;
-              setDrag({ index: i, dx });
-              // Scrub the audio (and move the playhead) to follow the dragged beat.
-              usePlayerStore.getState().requestSeek(Math.max(0, d.origTime + dx / pps));
-            }}
-            onPointerUp={(e) => {
-              const d = dragRef.current;
-              dragRef.current = null;
-              setDrag(null);
-              usePlayerStore.getState().setBeatDragging(false);
-              if (e.currentTarget.hasPointerCapture?.(e.pointerId)) {
-                e.currentTarget.releasePointerCapture(e.pointerId);
-              }
-              if (!d || d.index !== i) return;
-              const dx = e.clientX - d.startX;
-              if (Math.abs(dx) > 2) {
-                const newTime = Math.max(0, d.origTime + dx / pps);
-                moveBeatCompositionTime(d.origTime, newTime);
-                usePlayerStore.getState().requestSeek(newTime); // park scrubber at new beat
-              }
+              beginBeatDrag(e, i, t, pps);
             }}
             onDoubleClick={(e) => {
               e.stopPropagation();

From cb93b069191461d0187bead66f9665c53c99d61e Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 23:33:16 +0200
Subject: [PATCH 119/125] fix(studio): scope timeline ease focus lifecycle

---
 .../src/components/StudioRightPanel.tsx       |   2 +-
 .../editor/GsapAnimationSection.test.tsx      |  94 +++++++++++++--
 .../editor/GsapAnimationSection.tsx           |  35 ++++--
 .../src/components/editor/PropertyPanel.tsx   |   2 +-
 .../components/editor/PropertyPanelFlat.tsx   |  54 ++++-----
 .../editor/gsapAnimationCallbacks.test.ts     |   2 +-
 .../editor/gsapAnimationCallbacks.ts          |  10 --
 .../editor/propertyPanelFlatDescriptors.ts    |  23 ++++
 .../propertyPanelFlatMotionSection.test.tsx   | 113 +++++++++---------
 .../editor/propertyPanelFlatMotionSection.tsx |  21 +++-
 .../components/editor/propertyPanelTypes.ts   |   2 +-
 .../studio/src/contexts/DomEditContext.tsx    |   2 +-
 .../src/hooks/useDomEditSession.test.tsx      |   2 +-
 .../studio/src/hooks/useDomEditSession.ts     |   2 +-
 .../src/player/components/Timeline.test.ts    |   5 +-
 .../useTimelineKeyframeHandlers.test.tsx      |   4 +-
 .../studio/src/player/store/keyframeSlice.ts  |  74 +++++++++---
 .../src/player/store/playerStore.test.ts      |  76 ++++++++++++
 .../studio/src/player/store/playerStore.ts    |  19 +--
 19 files changed, 386 insertions(+), 156 deletions(-)
 create mode 100644 packages/studio/src/components/editor/propertyPanelFlatDescriptors.ts

diff --git a/packages/studio/src/components/StudioRightPanel.tsx b/packages/studio/src/components/StudioRightPanel.tsx
index 02437e7001..972be8382b 100644
--- a/packages/studio/src/components/StudioRightPanel.tsx
+++ b/packages/studio/src/components/StudioRightPanel.tsx
@@ -405,8 +405,8 @@ export function StudioRightPanel({
         onUpdateArcSegment={handleUpdateArcSegment}
         onUnroll={handleUnroll}
         onUpdateKeyframeEase={handleUpdateKeyframeEase}
-        onSetAllKeyframeEases={handleSetAllKeyframeEases}
         onUpdateSegmentEase={handleUpdateSegmentEase}
+        onSetAllKeyframeEases={handleSetAllKeyframeEases}
         recordingState={recordingState}
         recordingDuration={recordingDuration}
         onToggleRecording={onToggleRecording}
diff --git a/packages/studio/src/components/editor/GsapAnimationSection.test.tsx b/packages/studio/src/components/editor/GsapAnimationSection.test.tsx
index 7d299e158a..240ae98625 100644
--- a/packages/studio/src/components/editor/GsapAnimationSection.test.tsx
+++ b/packages/studio/src/components/editor/GsapAnimationSection.test.tsx
@@ -5,11 +5,15 @@ import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
 import { DesignPanelInputProvider } from "../../contexts/DesignPanelInputContext";
-import { usePlayerStore } from "../../player";
+import { usePlayerStore } from "../../player/store/playerStore";
 import { GsapAnimationSection } from "./GsapAnimationSection";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
+const animationCardMock = vi.hoisted(() => ({
+  consumers: [] as Array<{ tweenPercentage: number | null; consume: () => void }>,
+}));
+
 vi.mock("./AnimationCard", () => ({
   AnimationCard: ({
     animation,
@@ -19,22 +23,27 @@ vi.mock("./AnimationCard", () => ({
     animation: GsapAnimation;
     focusedSegment: { tweenPercentage: number } | null;
     onFocusSegmentConsumed: () => void;
-  }) => (
-    <button
-      type="button"
-      data-testid={`animation-${animation.id}`}
-      data-focused={focusedSegment ? String(focusedSegment.tweenPercentage) : ""}
-      // Mirrors the real card: the consume callback only fires from the effect
-      // that runs when this card actually received a focusedSegment.
-      onClick={() => focusedSegment && onFocusSegmentConsumed()}
-    />
-  ),
+  }) => {
+    animationCardMock.consumers.push({
+      tweenPercentage: focusedSegment?.tweenPercentage ?? null,
+      consume: onFocusSegmentConsumed,
+    });
+    return (
+      <button
+        type="button"
+        data-testid={`animation-${animation.id}`}
+        data-focused={focusedSegment ? String(focusedSegment.tweenPercentage) : ""}
+        onClick={onFocusSegmentConsumed}
+      />
+    );
+  },
 }));
 
 vi.mock("./GsapAddAnimationControl", () => ({ GsapAddAnimationControl: () => null }));
 
 afterEach(() => {
   document.body.innerHTML = "";
+  animationCardMock.consumers = [];
   usePlayerStore.getState().reset();
 });
 
@@ -78,6 +87,8 @@ function renderSection(elementId: string) {
 
 describe("GsapAnimationSection", () => {
   it("consumes a shared animation id only for the focused element", () => {
+    usePlayerStore.getState().beginTimelineSession("project-a");
+    usePlayerStore.getState().setSelectedElementId("index.html#second");
     usePlayerStore.getState().setFocusedEaseSegment({
       elementId: "index.html#second",
       animationId: sharedAnimation.id,
@@ -99,4 +110,65 @@ describe("GsapAnimationSection", () => {
     expect(usePlayerStore.getState().focusedEaseSegment).toBeNull();
     act(() => view.root.unmount());
   });
+
+  it("does not let an older consumer clear a newer request", () => {
+    const store = usePlayerStore.getState();
+    store.beginTimelineSession("project-a");
+    store.setSelectedElementId("index.html#first");
+    store.setFocusedEaseSegment({
+      elementId: "index.html#first",
+      animationId: sharedAnimation.id,
+      tweenPercentage: 25,
+    });
+    const view = renderSection("index.html#first");
+    const staleConsumer = animationCardMock.consumers.at(-1)?.consume;
+    if (!staleConsumer) throw new Error("expected first focus consumer");
+
+    act(() => {
+      store.setFocusedEaseSegment({
+        elementId: "index.html#first",
+        animationId: sharedAnimation.id,
+        tweenPercentage: 75,
+      });
+    });
+    const current = usePlayerStore.getState().focusedEaseSegment;
+    if (!current) throw new Error("expected replacement request");
+
+    act(() => staleConsumer());
+    expect(usePlayerStore.getState().focusedEaseSegment).toBe(current);
+
+    const currentConsumer = animationCardMock.consumers.at(-1)?.consume;
+    if (!currentConsumer) throw new Error("expected replacement focus consumer");
+    act(() => currentConsumer());
+    expect(usePlayerStore.getState().focusedEaseSegment).toBeNull();
+    act(() => view.root.unmount());
+  });
+
+  it("rejects a request from an earlier project session", () => {
+    const store = usePlayerStore.getState();
+    store.beginTimelineSession("project-a");
+    store.setSelectedElementId("index.html#first");
+    store.setFocusedEaseSegment({
+      elementId: "index.html#first",
+      animationId: sharedAnimation.id,
+      tweenPercentage: 50,
+    });
+    const staleRequest = usePlayerStore.getState().focusedEaseSegment;
+    if (!staleRequest) throw new Error("expected request");
+
+    const view = renderSection("index.html#first");
+
+    act(() => {
+      store.beginTimelineSession("project-b");
+      store.setSelectedElementId("index.html#first");
+      usePlayerStore.setState({ focusedEaseSegment: staleRequest });
+    });
+
+    const card = view.host.querySelector<HTMLButtonElement>(
+      "[data-testid='animation-shared-animation']",
+    );
+    expect(card?.dataset.focused).toBe("");
+    expect(usePlayerStore.getState().focusedEaseSegment).toBe(staleRequest);
+    act(() => view.root.unmount());
+  });
 });
diff --git a/packages/studio/src/components/editor/GsapAnimationSection.tsx b/packages/studio/src/components/editor/GsapAnimationSection.tsx
index 13e2d2758a..391742e14e 100644
--- a/packages/studio/src/components/editor/GsapAnimationSection.tsx
+++ b/packages/studio/src/components/editor/GsapAnimationSection.tsx
@@ -6,10 +6,10 @@ import { AnimationCard } from "./AnimationCard";
 import {
   type GsapAnimationEditCallbacks,
   withTrackedGsapAnimationCallbacks,
-  clearFocusedEaseSegment,
 } from "./gsapAnimationCallbacks";
 import { useTrackDesignInput } from "../../contexts/DesignPanelInputContext";
 import { usePlayerStore } from "../../player";
+import { isFocusedEaseRequestCurrent } from "../../player/store/keyframeSlice";
 import { GsapAddAnimationControl } from "./GsapAddAnimationControl";
 
 interface GsapAnimationSectionProps extends GsapAnimationEditCallbacks {
@@ -21,8 +21,8 @@ interface GsapAnimationSectionProps extends GsapAnimationEditCallbacks {
 }
 
 export const GsapAnimationSection = memo(function GsapAnimationSection({
-  animations,
   elementId,
+  animations,
   multipleTimelines,
   unsupportedTimelinePattern,
   onAddAnimation,
@@ -32,6 +32,24 @@ export const GsapAnimationSection = memo(function GsapAnimationSection({
   const [addMenuOpen, setAddMenuOpen] = useState(false);
   const trackedCallbacks = withTrackedGsapAnimationCallbacks(callbacks, track);
   const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
+  const clearFocusedEaseSegment = usePlayerStore((s) => s.clearFocusedEaseSegment);
+  const timelineProjectId = usePlayerStore((s) => s.timelineProjectId);
+  const timelineSessionEpoch = usePlayerStore((s) => s.timelineSessionEpoch);
+  const selectedElementId = usePlayerStore((s) => s.selectedElementId);
+  const focusedRequestIsCurrent =
+    focusedEaseSegment !== null &&
+    isFocusedEaseRequestCurrent(focusedEaseSegment, {
+      timelineProjectId,
+      timelineSessionEpoch,
+      selectedElementId,
+    });
+  const focusedAnimationExists =
+    focusedEaseSegment !== null &&
+    animations.some((animation) => animation.id === focusedEaseSegment.animationId);
+  const focusedHere =
+    focusedRequestIsCurrent && focusedEaseSegment.elementId === elementId && focusedAnimationExists
+      ? focusedEaseSegment
+      : null;
 
   return (
     <Section title="Animation" icon={<Film size={15} />}>
@@ -56,13 +74,12 @@ export const GsapAnimationSection = memo(function GsapAnimationSection({
               key={anim.id}
               animation={anim}
               defaultExpanded={index === 0}
-              focusedSegment={
-                focusedEaseSegment?.elementId === elementId &&
-                focusedEaseSegment.animationId === anim.id
-                  ? focusedEaseSegment
-                  : null
-              }
-              onFocusSegmentConsumed={clearFocusedEaseSegment}
+              focusedSegment={focusedHere?.animationId === anim.id ? focusedHere : null}
+              onFocusSegmentConsumed={() => {
+                if (focusedHere?.animationId === anim.id) {
+                  clearFocusedEaseSegment(focusedHere.nonce);
+                }
+              }}
             />
           ))}
 
diff --git a/packages/studio/src/components/editor/PropertyPanel.tsx b/packages/studio/src/components/editor/PropertyPanel.tsx
index f95dbcca1f..1be446ffbe 100644
--- a/packages/studio/src/components/editor/PropertyPanel.tsx
+++ b/packages/studio/src/components/editor/PropertyPanel.tsx
@@ -578,8 +578,8 @@ export const PropertyPanel = memo(function PropertyPanel(props: PropertyPanelPro
               onUpdateArcSegment={onUpdateArcSegment}
               onUnroll={onUnroll}
               onUpdateKeyframeEase={onUpdateKeyframeEase}
-              onSetAllKeyframeEases={onSetAllKeyframeEases}
               onUpdateSegmentEase={onUpdateSegmentEase}
+              onSetAllKeyframeEases={onSetAllKeyframeEases}
             />
           )}
 
diff --git a/packages/studio/src/components/editor/PropertyPanelFlat.tsx b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
index 00949baf8b..6eb32d2717 100644
--- a/packages/studio/src/components/editor/PropertyPanelFlat.tsx
+++ b/packages/studio/src/components/editor/PropertyPanelFlat.tsx
@@ -1,5 +1,4 @@
-import { type ReactNode, useEffect, useRef, useState } from "react";
-import { resolveEditingSections } from "@hyperframes/core/editing";
+import { useEffect, useRef, useState } from "react";
 import { DesignPanelInputProvider } from "../../contexts/DesignPanelInputContext";
 import { slugifyDesignInput } from "../../utils/designInputTracking";
 import type { DomEditSelection } from "./domEditing";
@@ -20,6 +19,7 @@ import { formatTextFieldPreview } from "./propertyPanelSections";
 import { STUDIO_GSAP_PANEL_ENABLED } from "./manualEditingAvailability";
 import { useColorGradingController } from "./useColorGradingController";
 import { usePlayerStore } from "../../player";
+import { isFocusedEaseRequestCurrent } from "../../player/store/keyframeSlice";
 import {
   FlatColorGradingAccessory,
   FlatColorGradingSection,
@@ -33,26 +33,11 @@ import {
   deriveMediaOverlayPlacement,
   FlatOverlaysSection,
 } from "./propertyPanelFlatOverlaysSection";
-
-type EditingSections = ReturnType<typeof resolveEditingSections>;
-
-type FlatGroupDescriptor = {
-  id: string;
-  title: string;
-  summary?: string;
-  accessory?: ReactNode;
-  content: ReactNode;
-};
-
-// Required callback shape for the gated-off Motion effect list.
-const EMPTY_GSAP_EFFECT_HANDLERS = {
-  onAddAnimation: () => {},
-  onUpdateProperty: () => {},
-  onUpdateMeta: () => {},
-  onDeleteAnimation: () => {},
-  onAddProperty: () => {},
-  onRemoveProperty: () => {},
-};
+import {
+  EMPTY_GSAP_EFFECT_HANDLERS,
+  type EditingSections,
+  type FlatGroupDescriptor,
+} from "./propertyPanelFlatDescriptors";
 
 /** The flat inspector shell with one shared open-group state. */
 // fallow-ignore-next-line complexity
@@ -180,8 +165,8 @@ export function PropertyPanelFlat({
   | "onUpdateArcSegment"
   | "onUnroll"
   | "onUpdateKeyframeEase"
-  | "onSetAllKeyframeEases"
   | "onUpdateSegmentEase"
+  | "onSetAllKeyframeEases"
   | "recordingState"
   | "recordingDuration"
   | "onToggleRecording"
@@ -251,10 +236,13 @@ export function PropertyPanelFlat({
   // force the Motion group open so its AnimationCard (which only mounts while
   // the group is expanded) can consume the focus and reveal the ease editor.
   const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
-  // The element THIS panel renders, not the store's selectedElementId: that
-  // flips synchronously while the panel still renders its predecessor, so a
-  // stale panel would consume a request meant for its successor whenever the
-  // two share a class-selector animation id.
+  const timelineProjectId = usePlayerStore((s) => s.timelineProjectId);
+  const timelineSessionEpoch = usePlayerStore((s) => s.timelineSessionEpoch);
+  // Identity of the element THIS panel actually renders (not the store's
+  // selectedElementId, which flips synchronously on selection while the panel
+  // still renders the previous element during async DOM-selection resolution):
+  // a stale panel would otherwise consume a focus request meant for its
+  // successor when both share a class-selector animation id.
   const renderedElementId = `${element.sourceFile}#${element.id}`;
   // Adjusted during render (not an effect) so the card mounts on the same
   // commit the request lands on. Keyed on request identity: a group the user
@@ -263,8 +251,16 @@ export function PropertyPanelFlat({
   if (focusedEaseSegment !== consumedFocus) {
     setConsumedFocus(focusedEaseSegment);
     const focusesThisPanel =
-      focusedEaseSegment?.elementId === renderedElementId &&
-      gsapAnimations.some((a) => a.id === focusedEaseSegment.animationId);
+      focusedEaseSegment !== null &&
+      // A request from a previous project/session/selection is stale: it must
+      // not reopen Motion on whichever panel happens to be mounted now.
+      isFocusedEaseRequestCurrent(focusedEaseSegment, {
+        timelineProjectId,
+        timelineSessionEpoch,
+        selectedElementId,
+      }) &&
+      focusedEaseSegment.elementId === renderedElementId &&
+      gsapAnimations.some((animation) => animation.id === focusedEaseSegment.animationId);
     if (focusesThisPanel) setOpenGroupId("motion");
   }
 
diff --git a/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts b/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
index 1707b92c00..c76f0e7be3 100644
--- a/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
+++ b/packages/studio/src/components/editor/gsapAnimationCallbacks.test.ts
@@ -27,8 +27,8 @@ describe("withTrackedGsapAnimationCallbacks", () => {
     const onUpdateSegmentEase = vi.fn();
     callbacks.onLivePreview = onLivePreview;
     callbacks.onLivePreviewEnd = onLivePreviewEnd;
-
     callbacks.onUpdateSegmentEase = onUpdateSegmentEase;
+
     const tracked = withTrackedGsapAnimationCallbacks(callbacks, vi.fn());
 
     expect(tracked.onUpdateFromProperty).toBeUndefined();
diff --git a/packages/studio/src/components/editor/gsapAnimationCallbacks.ts b/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
index fa12105dc8..d86dfb9e3f 100644
--- a/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
+++ b/packages/studio/src/components/editor/gsapAnimationCallbacks.ts
@@ -1,5 +1,4 @@
 import type { ArcPathSegment } from "@hyperframes/parsers/gsap-parser";
-import { usePlayerStore } from "../../player";
 import type { AnimationKeyframeTarget } from "../../hooks/gsapTweenSynth";
 
 /**
@@ -159,12 +158,3 @@ export function withTrackedGsapAnimationCallbacks(
       : undefined,
   };
 }
-
-/**
- * Stable consumer for the store's one-shot ease-focus request. Module-level on
- * purpose: an inline arrow in the section components is a dep of AnimationCard's
- * focus effect, so a fresh identity each render re-runs that effect every render.
- */
-export function clearFocusedEaseSegment(): void {
-  usePlayerStore.getState().setFocusedEaseSegment(null);
-}
diff --git a/packages/studio/src/components/editor/propertyPanelFlatDescriptors.ts b/packages/studio/src/components/editor/propertyPanelFlatDescriptors.ts
new file mode 100644
index 0000000000..df1742c6da
--- /dev/null
+++ b/packages/studio/src/components/editor/propertyPanelFlatDescriptors.ts
@@ -0,0 +1,23 @@
+import type { ReactNode } from "react";
+import type { resolveEditingSections } from "@hyperframes/core/editing";
+
+export type EditingSections = ReturnType<typeof resolveEditingSections>;
+
+export type FlatGroupDescriptor = {
+  id: string;
+  title: string;
+  summary?: string;
+  accessory?: ReactNode;
+  content: ReactNode;
+};
+
+// FlatMotionSection never calls these while effect cards are hidden; they only
+// provide its required callback shape on the gated-off path.
+export const EMPTY_GSAP_EFFECT_HANDLERS = {
+  onAddAnimation: () => {},
+  onUpdateProperty: () => {},
+  onUpdateMeta: () => {},
+  onDeleteAnimation: () => {},
+  onAddProperty: () => {},
+  onRemoveProperty: () => {},
+};
diff --git a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.test.tsx b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.test.tsx
index fa14727290..6864307a0a 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.test.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.test.tsx
@@ -11,8 +11,8 @@ import { usePlayerStore } from "../../player";
 
 afterEach(() => {
   document.body.innerHTML = "";
+  usePlayerStore.getState().reset();
 });
-usePlayerStore.getState().reset();
 
 function baseElement(overrides: Partial<DomEditSelection> = {}): DomEditSelection {
   return {
@@ -271,13 +271,14 @@ describe("FlatMotionSection", () => {
     expect(buttons().some((b) => b.textContent === "+ Add effect")).toBe(true);
     act(() => root.unmount());
   });
-});
 
-it("forwards focused bulk segment easing through the flat animation card", () => {
-  const onUpdateKeyframeEase = vi.fn();
-  const onUpdateSegmentEase = vi.fn();
-  usePlayerStore.setState({
-    focusedEaseSegment: {
+  it("forwards focused bulk segment easing through the flat animation card", () => {
+    const onUpdateKeyframeEase = vi.fn();
+    const onUpdateSegmentEase = vi.fn();
+    const store = usePlayerStore.getState();
+    store.beginTimelineSession("project-a");
+    store.setSelectedElementId("index.html#hero");
+    store.setFocusedEaseSegment({
       elementId: "index.html#hero",
       animationId: "a1",
       tweenPercentage: 50,
@@ -285,55 +286,55 @@ it("forwards focused bulk segment easing through the flat animation card", () =>
         { animationId: "a1", tweenPercentage: 50 },
         { animationId: "a2", tweenPercentage: 75 },
       ],
-    },
-  });
-  const { host, root } = renderInto(
-    <FlatMotionSection
-      element={baseElement()}
-      animations={[
-        {
-          id: "a1",
-          method: "to",
-          position: 0,
-          duration: 1,
-          properties: { x: 100 },
-          keyframes: {
-            format: "percentage",
-            keyframes: [
-              { percentage: 0, properties: { x: 0 } },
-              { percentage: 50, properties: { x: 100 } },
-            ],
-          },
-        } as never,
-      ]}
-      showTiming={false}
-      showEffects
-      onSetAttribute={vi.fn()}
-      onAddAnimation={vi.fn()}
-      onUpdateProperty={vi.fn()}
-      onUpdateMeta={vi.fn()}
-      onDeleteAnimation={vi.fn()}
-      onAddProperty={vi.fn()}
-      onRemoveProperty={vi.fn()}
-      onUpdateKeyframeEase={onUpdateKeyframeEase}
-      onUpdateSegmentEase={onUpdateSegmentEase}
-    />,
-  );
+    });
+    const { host, root } = renderInto(
+      <FlatMotionSection
+        element={baseElement()}
+        animations={[
+          {
+            id: "a1",
+            method: "to",
+            position: 0,
+            duration: 1,
+            properties: { x: 100 },
+            keyframes: {
+              format: "percentage",
+              keyframes: [
+                { percentage: 0, properties: { x: 0 } },
+                { percentage: 50, properties: { x: 100 } },
+              ],
+            },
+          } as never,
+        ]}
+        showTiming={false}
+        showEffects
+        onSetAttribute={vi.fn()}
+        onAddAnimation={vi.fn()}
+        onUpdateProperty={vi.fn()}
+        onUpdateMeta={vi.fn()}
+        onDeleteAnimation={vi.fn()}
+        onAddProperty={vi.fn()}
+        onRemoveProperty={vi.fn()}
+        onUpdateKeyframeEase={onUpdateKeyframeEase}
+        onUpdateSegmentEase={onUpdateSegmentEase}
+      />,
+    );
 
-  const dropdown = host.querySelector<HTMLButtonElement>("[data-ease-type-dropdown]");
-  expect(dropdown).not.toBeNull();
-  act(() => dropdown?.click());
-  const preset = host.querySelector<HTMLButtonElement>('[data-ease-preset-id="quad-out"]');
-  expect(preset).not.toBeNull();
-  act(() => preset?.click());
+    const dropdown = host.querySelector<HTMLButtonElement>("[data-ease-type-dropdown]");
+    expect(dropdown).not.toBeNull();
+    act(() => dropdown?.click());
+    const preset = host.querySelector<HTMLButtonElement>('[data-ease-preset-id="quad-out"]');
+    expect(preset).not.toBeNull();
+    act(() => preset?.click());
 
-  expect(onUpdateSegmentEase).toHaveBeenCalledExactlyOnceWith(
-    [
-      { animationId: "a1", tweenPercentage: 50 },
-      { animationId: "a2", tweenPercentage: 75 },
-    ],
-    "power2.out",
-  );
-  expect(onUpdateKeyframeEase).not.toHaveBeenCalled();
-  act(() => root.unmount());
+    expect(onUpdateSegmentEase).toHaveBeenCalledExactlyOnceWith(
+      [
+        { animationId: "a1", tweenPercentage: 50 },
+        { animationId: "a2", tweenPercentage: 75 },
+      ],
+      "power2.out",
+    );
+    expect(onUpdateKeyframeEase).not.toHaveBeenCalled();
+    act(() => root.unmount());
+  });
 });
diff --git a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
index 4823a995a2..b53cfbf7f0 100644
--- a/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
+++ b/packages/studio/src/components/editor/propertyPanelFlatMotionSection.tsx
@@ -9,10 +9,10 @@ import { AnimationCard } from "./AnimationCard";
 import {
   type GsapAnimationEditCallbacks,
   withTrackedGsapAnimationCallbacks,
-  clearFocusedEaseSegment,
 } from "./gsapAnimationCallbacks";
 import { deriveElementTiming } from "./propertyPanelFlatTimingDerivation";
 import { usePlayerStore } from "../../player";
+import { isFocusedEaseRequestCurrent } from "../../player/store/keyframeSlice";
 import { GsapAddAnimationControl } from "./GsapAddAnimationControl";
 
 export function FlatTimingRow({
@@ -139,13 +139,24 @@ export function FlatMotionSection({
   const [addMenuOpen, setAddMenuOpen] = useState(false);
   const trackedCallbacks = withTrackedGsapAnimationCallbacks(callbacks, track);
   const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
+  const clearFocusedEaseSegment = usePlayerStore((s) => s.clearFocusedEaseSegment);
+  const timelineProjectId = usePlayerStore((s) => s.timelineProjectId);
+  const timelineSessionEpoch = usePlayerStore((s) => s.timelineSessionEpoch);
+  const selectedElementId = usePlayerStore((s) => s.selectedElementId);
   // Only consume a focus request aimed at the element THIS panel renders (not
   // the store's selectedElementId, which flips synchronously during async
   // selection resolution), so a shared class-selector animation id can't open
   // the wrong element's editor.
   const renderedElementId = `${element.sourceFile}#${element.id}`;
   const focusedHere =
-    focusedEaseSegment && focusedEaseSegment.elementId === renderedElementId
+    focusedEaseSegment &&
+    focusedEaseSegment.elementId === renderedElementId &&
+    isFocusedEaseRequestCurrent(focusedEaseSegment, {
+      timelineProjectId,
+      timelineSessionEpoch,
+      selectedElementId,
+    }) &&
+    animations.some((animation) => animation.id === focusedEaseSegment.animationId)
       ? focusedEaseSegment
       : null;
 
@@ -182,7 +193,11 @@ export function FlatMotionSection({
                   defaultExpanded={index === 0}
                   flat
                   focusedSegment={focusedHere?.animationId === anim.id ? focusedHere : null}
-                  onFocusSegmentConsumed={clearFocusedEaseSegment}
+                  onFocusSegmentConsumed={() => {
+                    if (focusedHere?.animationId === anim.id) {
+                      clearFocusedEaseSegment(focusedHere.nonce);
+                    }
+                  }}
                 />
               ))}
               <GsapAddAnimationControl
diff --git a/packages/studio/src/components/editor/propertyPanelTypes.ts b/packages/studio/src/components/editor/propertyPanelTypes.ts
index 4bb9ed6c10..935ceb3f67 100644
--- a/packages/studio/src/components/editor/propertyPanelTypes.ts
+++ b/packages/studio/src/components/editor/propertyPanelTypes.ts
@@ -123,8 +123,8 @@ export interface PropertyPanelProps {
   ) => void;
   onRemoveKeyframe?: (animationId: string, percentage: number) => void;
   onUpdateKeyframeEase?: (animationId: string, percentage: number, ease: string) => void;
-  onSetAllKeyframeEases?: (animationId: string, ease: string) => void;
   onUpdateSegmentEase?: NonNullable<GsapAnimationEditCallbacks["onUpdateSegmentEase"]>;
+  onSetAllKeyframeEases?: (animationId: string, ease: string) => void;
   onConvertToKeyframes?: (animationId: string, duration?: number) => void;
   onCommitAnimatedProperty?: (
     selection: DomEditSelection,
diff --git a/packages/studio/src/contexts/DomEditContext.tsx b/packages/studio/src/contexts/DomEditContext.tsx
index 53a9039e5f..f89e27e915 100644
--- a/packages/studio/src/contexts/DomEditContext.tsx
+++ b/packages/studio/src/contexts/DomEditContext.tsx
@@ -200,8 +200,8 @@ export function DomEditProvider({
     commitMutation,
     applyMarqueeSelection,
     handleUpdateKeyframeEase,
-    handleSetAllKeyframeEases,
     handleUpdateSegmentEase,
+    handleSetAllKeyframeEases,
   },
   children,
 }: {
diff --git a/packages/studio/src/hooks/useDomEditSession.test.tsx b/packages/studio/src/hooks/useDomEditSession.test.tsx
index c2b58e718e..ab84bf915c 100644
--- a/packages/studio/src/hooks/useDomEditSession.test.tsx
+++ b/packages/studio/src/hooks/useDomEditSession.test.tsx
@@ -57,9 +57,9 @@ const recordResolverParity = vi.fn<(...args: unknown[]) => Promise<void>>(async
 const capturedOnReorderShadow: { fn: ((targets: string[]) => void) | undefined } = {
   fn: undefined,
 };
-
 const domEditSelectionRef: { current: DomEditSelection | null } = { current: null };
 const gsapCommitMutation = Object.assign(vi.fn(), { batch: vi.fn() });
+
 vi.mock("../utils/sdkResolverShadow", () => ({
   runResolverShadow: vi.fn(),
   recordResolverParity: (...args: unknown[]) => recordResolverParity(...args),
diff --git a/packages/studio/src/hooks/useDomEditSession.ts b/packages/studio/src/hooks/useDomEditSession.ts
index 40566d8d95..57e8297d86 100644
--- a/packages/studio/src/hooks/useDomEditSession.ts
+++ b/packages/studio/src/hooks/useDomEditSession.ts
@@ -584,11 +584,11 @@ export function useDomEditSession({
     handleGsapRemoveAllKeyframes,
     handleResetSelectedElementKeyframes,
     handleUpdateKeyframeEase,
+    handleUpdateSegmentEase,
     handleSetAllKeyframeEases,
     commitAnimatedProperty,
     commitAnimatedProperties,
     handleSetArcPath,
-    handleUpdateSegmentEase,
     handleUpdateArcSegment,
     handleUnroll,
     invalidateGsapCache: bumpGsapCache,
diff --git a/packages/studio/src/player/components/Timeline.test.ts b/packages/studio/src/player/components/Timeline.test.ts
index 1ff193d858..74cc1b700a 100644
--- a/packages/studio/src/player/components/Timeline.test.ts
+++ b/packages/studio/src/player/components/Timeline.test.ts
@@ -301,7 +301,6 @@ describe("Timeline provider boundary", () => {
     act(() => root.unmount());
   });
 
-  // fallow-ignore-next-line code-duplication
   it("renders the gutter without legacy icons or hue dots", () => {
     const { host, root } = renderBasicTimeline();
 
@@ -398,8 +397,8 @@ describe("Timeline provider boundary", () => {
       );
     });
 
-    const viewport = host.querySelector('[aria-label="Timeline"]')?.firstElementChild;
-    expect(viewport).toBeInstanceOf(HTMLElement);
+    const viewport = host.querySelector<HTMLElement>("[data-timeline-scroll-viewport]");
+    expect(viewport).not.toBeNull();
     act(() => {
       viewport?.dispatchEvent(
         new MouseEvent("pointerdown", {
diff --git a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
index f2cdca96a5..dc6f8919e3 100644
--- a/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
+++ b/packages/studio/src/player/components/useTimelineKeyframeHandlers.test.tsx
@@ -91,7 +91,7 @@ describe("useTimelineKeyframeHandlers", () => {
     const root = mountReactHarness(<Harness />);
     act(() => onSelectSegment?.(ELEMENT.id, COLLIDING_TARGET));
 
-    expect(usePlayerStore.getState().focusedEaseSegment).toEqual({
+    expect(usePlayerStore.getState().focusedEaseSegment).toMatchObject({
       animationId: "position-tween",
       collidingAnimationTargets: [
         { animationId: "position-tween", tweenPercentage: 100 },
@@ -130,7 +130,7 @@ describe("useTimelineKeyframeHandlers", () => {
     // Selecting a segment must NOT move the playhead.
     act(() => onSelectSegment?.(ELEMENT.id, FLAT_TWEEN_TARGET));
     expect(onSeek).not.toHaveBeenCalled();
-    expect(usePlayerStore.getState().focusedEaseSegment).toEqual({
+    expect(usePlayerStore.getState().focusedEaseSegment).toMatchObject({
       animationId: "position-tween",
       tweenPercentage: 100,
       elementId: ELEMENT.id,
diff --git a/packages/studio/src/player/store/keyframeSlice.ts b/packages/studio/src/player/store/keyframeSlice.ts
index 9ee447e62d..66b093254a 100644
--- a/packages/studio/src/player/store/keyframeSlice.ts
+++ b/packages/studio/src/player/store/keyframeSlice.ts
@@ -22,6 +22,34 @@ export interface KeyframeCacheEntry {
   easeEach?: string;
 }
 
+export interface FocusedEaseSegment {
+  animationId: string;
+  collidingAnimationTargets?: AnimationKeyframeTarget[];
+  tweenPercentage: number;
+  elementId: string;
+  projectId: string | null;
+  sessionEpoch: number;
+  nonce: number;
+}
+
+type FocusedEaseSegmentTarget = Omit<FocusedEaseSegment, "projectId" | "sessionEpoch" | "nonce">;
+
+interface TimelineSessionIdentity {
+  timelineProjectId: string | null;
+  timelineSessionEpoch: number;
+}
+
+export function isFocusedEaseRequestCurrent(
+  request: FocusedEaseSegment,
+  state: TimelineSessionIdentity & { selectedElementId: string | null },
+): boolean {
+  return (
+    request.projectId === state.timelineProjectId &&
+    request.sessionEpoch === state.timelineSessionEpoch &&
+    request.elementId === state.selectedElementId
+  );
+}
+
 export interface KeyframeSlice {
   /** Selected collapsed (`element:pct`) or expanded (`element:group:animation:clipPct`) diamonds. */
   selectedKeyframes: Set<string>;
@@ -35,22 +63,11 @@ export interface KeyframeSlice {
   /** Union-expand clips (keyframed clips are expanded by default on load). */
   expandClips: (ids: readonly string[]) => void;
 
-  /** elementId scopes the request to one element so a shared (class-selector)
-   * animation id can't open the ease editor on the wrong element. */
-  focusedEaseSegment: {
-    animationId: string;
-    collidingAnimationTargets?: AnimationKeyframeTarget[];
-    tweenPercentage: number;
-    elementId: string;
-  } | null;
-  setFocusedEaseSegment: (
-    target: {
-      animationId: string;
-      collidingAnimationTargets?: AnimationKeyframeTarget[];
-      tweenPercentage: number;
-      elementId: string;
-    } | null,
-  ) => void;
+  /** Project/session/element-scoped request. Its nonce makes stale consumers harmless. */
+  focusedEaseSegment: FocusedEaseSegment | null;
+  focusedEaseRequestNonce: number;
+  setFocusedEaseSegment: (target: FocusedEaseSegmentTarget) => void;
+  clearFocusedEaseSegment: (nonce: number) => void;
 
   /** Keyframe data per element id, populated from parsed GSAP animations. */
   keyframeCache: Map<string, KeyframeCacheEntry>;
@@ -60,7 +77,10 @@ export interface KeyframeSlice {
   setKeyframeCache: (elementId: string, data: KeyframeCacheEntry | undefined) => void;
 }
 
-export function createKeyframeSlice(set: StoreApi<KeyframeSlice>["setState"]): KeyframeSlice {
+export function createKeyframeSlice(
+  set: StoreApi<KeyframeSlice>["setState"],
+  getTimelineSessionIdentity: () => TimelineSessionIdentity,
+): KeyframeSlice {
   return {
     selectedKeyframes: new Set(),
     toggleSelectedKeyframe: (key) =>
@@ -97,7 +117,25 @@ export function createKeyframeSlice(set: StoreApi<KeyframeSlice>["setState"]): K
       }),
 
     focusedEaseSegment: null,
-    setFocusedEaseSegment: (target) => set({ focusedEaseSegment: target }),
+    focusedEaseRequestNonce: 0,
+    setFocusedEaseSegment: (target) =>
+      set((state) => {
+        const nonce = state.focusedEaseRequestNonce + 1;
+        const { timelineProjectId, timelineSessionEpoch } = getTimelineSessionIdentity();
+        return {
+          focusedEaseRequestNonce: nonce,
+          focusedEaseSegment: {
+            ...target,
+            projectId: timelineProjectId,
+            sessionEpoch: timelineSessionEpoch,
+            nonce,
+          },
+        };
+      }),
+    clearFocusedEaseSegment: (nonce) =>
+      set((state) =>
+        state.focusedEaseSegment?.nonce === nonce ? { focusedEaseSegment: null } : state,
+      ),
 
     keyframeCache: new Map(),
     setKeyframeCache: (elementId, data) =>
diff --git a/packages/studio/src/player/store/playerStore.test.ts b/packages/studio/src/player/store/playerStore.test.ts
index b9b1157b22..8adfd77eeb 100644
--- a/packages/studio/src/player/store/playerStore.test.ts
+++ b/packages/studio/src/player/store/playerStore.test.ts
@@ -53,6 +53,82 @@ describe("usePlayerStore", () => {
     });
   });
 
+  describe("focused ease requests", () => {
+    it("stamps the current project session and only lets its nonce clear it", () => {
+      const store = usePlayerStore.getState();
+      store.beginTimelineSession("project-a");
+      store.setSelectedElementId("index.html#hero");
+      store.setFocusedEaseSegment({
+        elementId: "index.html#hero",
+        animationId: "animation-a",
+        tweenPercentage: 50,
+      });
+      const first = usePlayerStore.getState().focusedEaseSegment;
+      if (!first) throw new Error("expected focused ease request");
+      expect(first.projectId).toBe("project-a");
+      expect(first.sessionEpoch).toBeGreaterThan(0);
+      expect(first.nonce).toBeGreaterThan(0);
+
+      store.setFocusedEaseSegment({
+        elementId: "index.html#hero",
+        animationId: "animation-a",
+        tweenPercentage: 75,
+      });
+      const second = usePlayerStore.getState().focusedEaseSegment;
+      if (!second) throw new Error("expected replacement request");
+      expect(second.nonce).toBe(first.nonce + 1);
+
+      store.clearFocusedEaseSegment(first.nonce);
+      expect(usePlayerStore.getState().focusedEaseSegment).toBe(second);
+      store.clearFocusedEaseSegment(second.nonce);
+      expect(usePlayerStore.getState().focusedEaseSegment).toBeNull();
+    });
+
+    it("clears a pending request when the project session changes", () => {
+      const store = usePlayerStore.getState();
+      store.beginTimelineSession("project-a");
+      store.setFocusedEaseSegment({
+        elementId: "index.html#hero",
+        animationId: "animation-a",
+        tweenPercentage: 50,
+      });
+
+      store.beginTimelineSession("project-b");
+      expect(usePlayerStore.getState().focusedEaseSegment).toBeNull();
+    });
+
+    it("does not revive an old request after selecting away and back", () => {
+      const store = usePlayerStore.getState();
+      store.setSelectedElementId("index.html#a");
+      store.setFocusedEaseSegment({
+        elementId: "index.html#a",
+        animationId: "animation-a",
+        tweenPercentage: 50,
+      });
+
+      store.setSelectedElementId("index.html#b");
+      expect(usePlayerStore.getState().focusedEaseSegment).toBeNull();
+      store.setSelectedElementId("index.html#a");
+      expect(usePlayerStore.getState().focusedEaseSegment).toBeNull();
+    });
+
+    it("invalidates on a genuine selection-anchor change but not a same-anchor echo", () => {
+      const store = usePlayerStore.getState();
+      store.setSelection(new Set(["index.html#a", "index.html#b"]), "index.html#a");
+      store.setFocusedEaseSegment({
+        elementId: "index.html#a",
+        animationId: "animation-a",
+        tweenPercentage: 50,
+      });
+      const request = usePlayerStore.getState().focusedEaseSegment;
+
+      store.setSelectionAnchor("index.html#a");
+      expect(usePlayerStore.getState().focusedEaseSegment).toBe(request);
+      store.setSelectionAnchor("index.html#b");
+      expect(usePlayerStore.getState().focusedEaseSegment).toBeNull();
+    });
+  });
+
   describe("setIsPlaying", () => {
     it("sets isPlaying to true", () => {
       usePlayerStore.getState().setIsPlaying(true);
diff --git a/packages/studio/src/player/store/playerStore.ts b/packages/studio/src/player/store/playerStore.ts
index 2fd3268f94..d617455879 100644
--- a/packages/studio/src/player/store/playerStore.ts
+++ b/packages/studio/src/player/store/playerStore.ts
@@ -344,7 +344,7 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
   activeTool: "select",
   setActiveTool: (tool) => set({ activeTool: tool }),
 
-  ...createKeyframeSlice(set),
+  ...createKeyframeSlice(set, get),
 
   activeKeyframePct: null,
   setActiveKeyframePct: (pct) => set({ activeKeyframePct: pct }),
@@ -534,6 +534,7 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
             selectedElementIds,
             activeKeyframePct: null,
             motionPathArmed: false,
+            focusedEaseSegment: null,
           }
         : { selectedElementId: id, selectedElementIds };
     }),
@@ -543,9 +544,16 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
   setSelectionAnchor: (id) =>
     set((s) => {
       if (id != null && s.selectedElementIds.size > 1 && s.selectedElementIds.has(id)) {
-        return { selectedElementId: id };
+        return {
+          selectedElementId: id,
+          focusedEaseSegment: id === s.selectedElementId ? s.focusedEaseSegment : null,
+        };
       }
-      return { selectedElementId: id, selectedElementIds: id ? new Set([id]) : new Set<string>() };
+      return {
+        selectedElementId: id,
+        selectedElementIds: id ? new Set([id]) : new Set<string>(),
+        focusedEaseSegment: id === s.selectedElementId ? s.focusedEaseSegment : null,
+      };
     }),
   updateElement: (elementId, updates) =>
     set((state) => ({
@@ -568,11 +576,6 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
   reset: () => set(createTimelineResetState()),
 }));
 
-// Bug-bash aid: expose the store so a reproduction can dump live state from the
-// console, e.g. `__playerStore.getState().selectedElementId`. Harmless read
-// handle; no behavioural effect.
-// Only in dev. `import.meta.env` may be undefined in non-Vite bundlers (Next.js
-// Turbopack), so guard the access like the telemetry client does.
 function isDevBuild(): boolean {
   try {
     return import.meta.env.DEV === true;

From 5b22e39a8f923f8cb1b3b6bdd1d87a37bac4280b Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 21:32:03 +0200
Subject: [PATCH 120/125] refactor(studio): extract live timeline clock

---
 packages/studio/src/player/store/liveTime.ts    | 11 +++++++++++
 packages/studio/src/player/store/playerStore.ts | 14 +-------------
 2 files changed, 12 insertions(+), 13 deletions(-)
 create mode 100644 packages/studio/src/player/store/liveTime.ts

diff --git a/packages/studio/src/player/store/liveTime.ts b/packages/studio/src/player/store/liveTime.ts
new file mode 100644
index 0000000000..8025986f93
--- /dev/null
+++ b/packages/studio/src/player/store/liveTime.ts
@@ -0,0 +1,11 @@
+// Lightweight pub-sub avoids React re-renders on every playback frame.
+type TimeListener = (time: number) => void;
+const timeListeners = new Set<TimeListener>();
+
+export const liveTime = {
+  notify: (time: number) => timeListeners.forEach((listener) => listener(time)),
+  subscribe: (listener: TimeListener) => {
+    timeListeners.add(listener);
+    return () => timeListeners.delete(listener);
+  },
+};
diff --git a/packages/studio/src/player/store/playerStore.ts b/packages/studio/src/player/store/playerStore.ts
index d617455879..2652859217 100644
--- a/packages/studio/src/player/store/playerStore.ts
+++ b/packages/studio/src/player/store/playerStore.ts
@@ -7,6 +7,7 @@ import { computePinnedZoomPercent } from "../components/timelineZoom";
 import { createKeyframeSlice, type KeyframeSlice } from "./keyframeSlice";
 
 export type { KeyframeCacheEntry } from "./keyframeSlice";
+export { liveTime } from "./liveTime";
 
 export interface TimelineElement {
   id: string;
@@ -277,19 +278,6 @@ interface BeatHistoryEntry {
   label: string;
 }
 
-// Lightweight pub-sub for current time during playback.
-// Bypasses React state so the RAF loop can update the playhead/time display
-// without triggering re-renders on every frame.
-type TimeListener = (time: number) => void;
-const _timeListeners = new Set<TimeListener>();
-export const liveTime = {
-  notify: (t: number) => _timeListeners.forEach((cb) => cb(t)),
-  subscribe: (cb: TimeListener) => {
-    _timeListeners.add(cb);
-    return () => _timeListeners.delete(cb);
-  },
-};
-
 function createTimelineResetState() {
   return {
     isPlaying: false,

From 2d0f39ef1d9c3d51369b2fa1f1f02c0c98af5c61 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 21:34:43 +0200
Subject: [PATCH 121/125] feat(studio): model logical timeline navigation

---
 .../timelineKeyboardNavigation.test.ts        | 263 ++++++++++++++
 .../components/timelineKeyboardNavigation.ts  | 329 ++++++++++++++++++
 2 files changed, 592 insertions(+)
 create mode 100644 packages/studio/src/player/components/timelineKeyboardNavigation.test.ts
 create mode 100644 packages/studio/src/player/components/timelineKeyboardNavigation.ts

diff --git a/packages/studio/src/player/components/timelineKeyboardNavigation.test.ts b/packages/studio/src/player/components/timelineKeyboardNavigation.test.ts
new file mode 100644
index 0000000000..099735544a
--- /dev/null
+++ b/packages/studio/src/player/components/timelineKeyboardNavigation.test.ts
@@ -0,0 +1,263 @@
+import type { GsapAnimation, PropertyGroupName } from "@hyperframes/core/gsap-parser";
+import { describe, expect, it } from "vitest";
+import type { TimelineElement } from "../store/playerStore";
+import {
+  buildTimelineLogicalRows,
+  resolveTimelineFocusFallback,
+  resolveTimelineNavigationTarget,
+  timelineClipFocusId,
+  timelineTrackRowId,
+} from "./timelineKeyboardNavigation";
+
+function clip(id: string, track: number, start: number, duration = 2): TimelineElement {
+  return { id, track, start, duration, tag: "div" };
+}
+
+function animation(
+  id: string,
+  group: PropertyGroupName,
+  percentages: readonly number[],
+  resolvedStart = 10,
+): GsapAnimation {
+  return {
+    id,
+    targetSelector: "#active",
+    method: "to",
+    position: 0,
+    resolvedStart,
+    duration: 10,
+    properties: {},
+    propertyGroup: group,
+    keyframes: {
+      format: "percentage",
+      keyframes: percentages.map((percentage) => ({
+        percentage,
+        properties: group === "position" ? { x: percentage } : { opacity: percentage / 100 },
+      })),
+    },
+  };
+}
+
+function model(overrides: Partial<Parameters<typeof buildTimelineLogicalRows>[0]> = {}) {
+  const active = clip("active", 1, 10, 10);
+  return buildTimelineLogicalRows({
+    tracks: [
+      [1, [clip("late", 1, 20), active, clip("early", 1, 0)]],
+      [2, []],
+      [3, [clip("right", 3, 18), clip("left", 3, 2)]],
+    ],
+    displayTrackOrder: [1, 2, 3],
+    laneCounts: new Map([["active", 2]]),
+    selectedElementId: "active",
+    selectedElementIds: new Set(),
+    expandedClipIds: new Set(["active"]),
+    gsapAnimations: new Map([
+      [
+        "active",
+        [animation("position", "position", [0, 50, 100]), animation("visual", "visual", [25, 75])],
+      ],
+    ]),
+    ...overrides,
+  });
+}
+
+describe("buildTimelineLogicalRows", () => {
+  it("projects tracks, empty tracks, and expanded property rows with continuous indices", () => {
+    const rows = model();
+
+    expect(
+      rows.map(({ physicalTrackKey, logicalIndex, level, parentId }) => ({
+        physicalTrackKey,
+        logicalIndex,
+        level,
+        parentId,
+      })),
+    ).toEqual([
+      { physicalTrackKey: 1, logicalIndex: 0, level: 1, parentId: null },
+      { physicalTrackKey: 1, logicalIndex: 1, level: 2, parentId: timelineTrackRowId(1) },
+      { physicalTrackKey: 1, logicalIndex: 2, level: 2, parentId: timelineTrackRowId(1) },
+      { physicalTrackKey: 2, logicalIndex: 3, level: 1, parentId: null },
+      { physicalTrackKey: 3, logicalIndex: 4, level: 1, parentId: null },
+    ]);
+    expect(rows[0]?.expanded).toBe(true);
+    expect(rows[3]?.items).toEqual([]);
+    expect(rows[0]?.items.map((item) => item.elementId)).toEqual(["early", "active", "late"]);
+  });
+
+  it("orders keyframes and their segment ease controls deterministically", () => {
+    const rows = model({
+      gsapAnimations: new Map([
+        [
+          "active",
+          [
+            animation("z-animation", "position", [100, 0, 50]),
+            animation("a-animation", "position", [50]),
+          ],
+        ],
+      ]),
+    });
+    const position = rows.find((row) => row.propertyGroup === "position")!;
+
+    expect(
+      position.items.map((item) => [item.kind, item.time, item.keyframeTarget?.animationId]),
+    ).toEqual([
+      ["keyframe", 10, "z-animation"],
+      ["ease", 12.5, "a-animation"],
+      ["keyframe", 15, "a-animation"],
+      ["keyframe", 15, "z-animation"],
+      ["ease", 17.5, "z-animation"],
+      ["keyframe", 20, "z-animation"],
+    ]);
+  });
+
+  it("uses the selected keyframed clip as the sole expanded-lane owner", () => {
+    const other = clip("other", 1, 0, 4);
+    const rows = model({
+      tracks: [[1, [other, clip("active", 1, 10, 10)]]],
+      displayTrackOrder: [1],
+      laneCounts: new Map([
+        ["active", 1],
+        ["other", 1],
+      ]),
+      selectedElementId: "other",
+      expandedClipIds: new Set(["other", "active"]),
+      gsapAnimations: new Map([
+        ["active", [animation("active-position", "position", [0, 100])]],
+        ["other", [animation("other-visual", "visual", [0, 100], 0)]],
+      ]),
+    });
+
+    expect(rows.map((row) => row.propertyGroup).filter(Boolean)).toEqual(["visual"]);
+  });
+});
+
+describe("resolveTimelineNavigationTarget", () => {
+  it("navigates horizontal items plus row Home and End", () => {
+    const rows = model();
+    const activeId = timelineClipFocusId("active");
+
+    expect(resolveTimelineNavigationTarget(rows, activeId, "ArrowLeft")?.id).toBe(
+      timelineClipFocusId("early"),
+    );
+    expect(resolveTimelineNavigationTarget(rows, activeId, "ArrowRight")?.id).toBe(
+      timelineClipFocusId("late"),
+    );
+    expect(resolveTimelineNavigationTarget(rows, activeId, "Home")?.id).toBe(timelineTrackRowId(1));
+    expect(resolveTimelineNavigationTarget(rows, timelineTrackRowId(1), "End")?.id).toBe(
+      timelineClipFocusId("late"),
+    );
+  });
+
+  it("navigates every logical row including properties and empty tracks", () => {
+    const rows = model();
+    const activeId = timelineClipFocusId("active");
+    const propertyTarget = resolveTimelineNavigationTarget(rows, activeId, "ArrowDown")!;
+
+    expect(propertyTarget.kind).toBe("keyframe");
+    expect(propertyTarget.time).toBe(15);
+    expect(
+      resolveTimelineNavigationTarget(rows, propertyTarget.id, "PageDown", { pageSize: 2 })?.id,
+    ).toBe(timelineTrackRowId(2));
+    expect(resolveTimelineNavigationTarget(rows, timelineTrackRowId(2), "ArrowDown")?.id).toBe(
+      timelineTrackRowId(3),
+    );
+  });
+
+  it("uses a caller-supplied page size and ignores invalid page commands", () => {
+    const rows = model();
+    const current = timelineTrackRowId(1);
+
+    expect(resolveTimelineNavigationTarget(rows, current, "PageDown")?.id).toBe(current);
+    expect(resolveTimelineNavigationTarget(rows, current, "PageDown", { pageSize: 3 })?.id).toBe(
+      timelineTrackRowId(2),
+    );
+  });
+
+  it("supports modified Home and End across the whole logical model", () => {
+    const rows = model();
+    const current = timelineTrackRowId(2);
+
+    expect(
+      resolveTimelineNavigationTarget(rows, current, "Home", { timelineBoundary: true })?.id,
+    ).toBe(timelineTrackRowId(1));
+    expect(
+      resolveTimelineNavigationTarget(rows, current, "End", { timelineBoundary: true })?.id,
+    ).toBe(timelineClipFocusId("right"));
+  });
+
+  it("breaks equal-distance vertical ties by time then stable identity", () => {
+    const rows = buildTimelineLogicalRows({
+      tracks: [
+        [1, [clip("current", 1, 9, 2)]],
+        [2, [clip("later", 2, 14, 2), clip("earlier-z", 2, 4, 2), clip("earlier-a", 2, 4, 2)]],
+      ],
+      displayTrackOrder: [1, 2],
+      laneCounts: new Map(),
+      selectedElementId: null,
+      selectedElementIds: new Set(),
+      expandedClipIds: new Set(),
+      gsapAnimations: new Map(),
+    });
+
+    expect(
+      resolveTimelineNavigationTarget(rows, timelineClipFocusId("current"), "ArrowDown")?.id,
+    ).toBe(timelineClipFocusId("earlier-a"));
+  });
+});
+
+describe("resolveTimelineFocusFallback", () => {
+  it("chooses previous, then next, then the containing row after deletion", () => {
+    const before = model({ expandedClipIds: new Set() });
+    const withoutActive = model({
+      expandedClipIds: new Set(),
+      tracks: [
+        [1, [clip("early", 1, 0), clip("late", 1, 20)]],
+        [2, []],
+        [3, [clip("right", 3, 18), clip("left", 3, 2)]],
+      ],
+    });
+    expect(
+      resolveTimelineFocusFallback(before, withoutActive, timelineClipFocusId("active"))?.id,
+    ).toBe(timelineClipFocusId("early"));
+
+    const onlyNext = model({
+      expandedClipIds: new Set(),
+      tracks: [
+        [1, [clip("late", 1, 20)]],
+        [2, []],
+        [3, [clip("right", 3, 18), clip("left", 3, 2)]],
+      ],
+    });
+    expect(resolveTimelineFocusFallback(before, onlyNext, timelineClipFocusId("active"))?.id).toBe(
+      timelineClipFocusId("late"),
+    );
+
+    const onlyActive = model({
+      expandedClipIds: new Set(),
+      tracks: [[1, [clip("active", 1, 10, 10)]]],
+      displayTrackOrder: [1],
+    });
+    const empty = model({
+      expandedClipIds: new Set(),
+      tracks: [[1, []]],
+      displayTrackOrder: [1],
+    });
+    expect(resolveTimelineFocusFallback(onlyActive, empty, timelineClipFocusId("active"))?.id).toBe(
+      timelineTrackRowId(1),
+    );
+  });
+
+  it("falls back from a collapsed property row to its parent track", () => {
+    const before = model();
+    const property = before.find((row) => row.propertyGroup === "position")!;
+    const after = model({ expandedClipIds: new Set() });
+
+    expect(resolveTimelineFocusFallback(before, after, property.items[0]!.id)?.id).toBe(
+      timelineTrackRowId(1),
+    );
+  });
+
+  it("returns null for an identity absent from the previous model", () => {
+    expect(resolveTimelineFocusFallback(model(), model(), "missing")).toBeNull();
+  });
+});
diff --git a/packages/studio/src/player/components/timelineKeyboardNavigation.ts b/packages/studio/src/player/components/timelineKeyboardNavigation.ts
new file mode 100644
index 0000000000..60588eabd5
--- /dev/null
+++ b/packages/studio/src/player/components/timelineKeyboardNavigation.ts
@@ -0,0 +1,329 @@
+import type { GsapAnimation, PropertyGroupName } from "@hyperframes/core/gsap-parser";
+import type { TimelineElement } from "../store/playerStore";
+import { getTimelinePropertyLanes } from "./TimelinePropertyLanes";
+import {
+  timelineKeyframeSelectionKey,
+  type TimelineKeyframeTarget,
+} from "./timelineKeyframeIdentity";
+import { resolveTrackKeyframeClip } from "./useTimelineTrackLayout";
+
+export type TimelineNavigationKey =
+  | "ArrowLeft"
+  | "ArrowRight"
+  | "ArrowUp"
+  | "ArrowDown"
+  | "Home"
+  | "End"
+  | "PageUp"
+  | "PageDown";
+
+const NAVIGATION_KEYS: ReadonlySet<string> = new Set<TimelineNavigationKey>([
+  "ArrowLeft",
+  "ArrowRight",
+  "ArrowUp",
+  "ArrowDown",
+  "Home",
+  "End",
+  "PageUp",
+  "PageDown",
+]);
+
+export function isTimelineNavigationKey(key: string): key is TimelineNavigationKey {
+  return NAVIGATION_KEYS.has(key);
+}
+
+export interface TimelineLogicalItem {
+  id: string;
+  kind: "clip" | "keyframe" | "ease";
+  rowId: string;
+  elementId: string;
+  /** The item's time anchor. Clips use their midpoint; ease controls use the segment midpoint. */
+  time: number;
+  keyframeTarget?: TimelineKeyframeTarget;
+}
+
+export interface TimelineLogicalRow {
+  id: string;
+  kind: "row";
+  physicalTrackKey: number;
+  logicalIndex: number;
+  level: 1 | 2;
+  parentId: string | null;
+  expanded: boolean;
+  propertyGroup?: PropertyGroupName;
+  items: readonly TimelineLogicalItem[];
+}
+
+export type TimelineLogicalTarget = TimelineLogicalRow | TimelineLogicalItem;
+
+interface BuildTimelineLogicalRowsInput {
+  tracks: readonly (readonly [number, readonly TimelineElement[]])[];
+  displayTrackOrder: readonly number[];
+  laneCounts: ReadonlyMap<string, number>;
+  selectedElementId: string | null;
+  selectedElementIds: ReadonlySet<string>;
+  expandedClipIds: ReadonlySet<string>;
+  gsapAnimations: ReadonlyMap<string, readonly GsapAnimation[]>;
+}
+
+export interface TimelineNavigationOptions {
+  /** Supplied by the viewport actor; the model never guesses a fixed page size. */
+  pageSize?: number;
+  /** Ctrl/Meta + Home/End moves to the first/last logical row. */
+  timelineBoundary?: boolean;
+}
+
+function stableId(kind: string, ...parts: Array<string | number>): string {
+  return JSON.stringify(["timeline", kind, ...parts]);
+}
+
+export function timelineTrackRowId(track: number): string {
+  return stableId("track", track);
+}
+
+export function timelinePropertyRowId(elementId: string, group: PropertyGroupName): string {
+  return stableId("property", elementId, group);
+}
+
+export function timelineClipFocusId(elementId: string): string {
+  return stableId("clip", elementId);
+}
+
+export function timelineKeyframeFocusId(elementId: string, target: TimelineKeyframeTarget): string {
+  return stableId("keyframe", timelineKeyframeSelectionKey(elementId, target));
+}
+
+export function timelineEaseFocusId(elementId: string, target: TimelineKeyframeTarget): string {
+  return stableId("ease", timelineKeyframeSelectionKey(elementId, target));
+}
+
+function elementId(element: TimelineElement): string {
+  return element.key ?? element.id;
+}
+
+function clipItems(rowId: string, elements: readonly TimelineElement[]): TimelineLogicalItem[] {
+  return [...elements]
+    .sort(
+      (left, right) =>
+        left.start - right.start ||
+        left.start + left.duration - (right.start + right.duration) ||
+        elementId(left).localeCompare(elementId(right)),
+    )
+    .map((element) => {
+      const id = elementId(element);
+      return {
+        id: timelineClipFocusId(id),
+        kind: "clip",
+        rowId,
+        elementId: id,
+        time: element.start + element.duration / 2,
+      };
+    });
+}
+
+function keyframeTarget(
+  keyframe: ReturnType<typeof getTimelinePropertyLanes>[number]["keyframes"][number],
+): TimelineKeyframeTarget {
+  return {
+    percentage: keyframe.percentage,
+    tweenPercentage: keyframe.tweenPercentage,
+    propertyGroup: keyframe.propertyGroup,
+    animationId: keyframe.animationId,
+    collidingAnimationTargets: keyframe.collidingAnimationTargets,
+  };
+}
+
+function propertyItems(
+  rowId: string,
+  clip: TimelineElement,
+  keyframes: ReturnType<typeof getTimelinePropertyLanes>[number]["keyframes"],
+): TimelineLogicalItem[] {
+  const id = elementId(clip);
+  const unique = new Map<string, { target: TimelineKeyframeTarget; time: number }>();
+  for (const keyframe of keyframes) {
+    const target = keyframeTarget(keyframe);
+    const key = timelineKeyframeSelectionKey(id, target);
+    if (!unique.has(key)) {
+      unique.set(key, {
+        target,
+        time: clip.start + (keyframe.percentage / 100) * clip.duration,
+      });
+    }
+  }
+  const ordered = [...unique.entries()].sort(
+    ([leftKey, left], [rightKey, right]) =>
+      left.time - right.time || leftKey.localeCompare(rightKey),
+  );
+  const items: TimelineLogicalItem[] = [];
+  for (let index = 0; index < ordered.length; index += 1) {
+    const [, current] = ordered[index]!;
+    const previous = ordered[index - 1]?.[1];
+    if (previous && current.time > previous.time && current.target.animationId !== undefined) {
+      items.push({
+        id: timelineEaseFocusId(id, current.target),
+        kind: "ease",
+        rowId,
+        elementId: id,
+        time: previous.time + (current.time - previous.time) / 2,
+        keyframeTarget: current.target,
+      });
+    }
+    items.push({
+      id: timelineKeyframeFocusId(id, current.target),
+      kind: "keyframe",
+      rowId,
+      elementId: id,
+      time: current.time,
+      keyframeTarget: current.target,
+    });
+  }
+  return items;
+}
+
+/** Canonical model of the treegrid, independent of which virtual rows or clips are mounted. */
+export function buildTimelineLogicalRows({
+  tracks,
+  displayTrackOrder,
+  laneCounts,
+  selectedElementId,
+  selectedElementIds,
+  expandedClipIds,
+  gsapAnimations,
+}: BuildTimelineLogicalRowsInput): TimelineLogicalRow[] {
+  const trackMap = new Map(tracks);
+  const rows: TimelineLogicalRow[] = [];
+  for (const track of displayTrackOrder) {
+    const elements = trackMap.get(track) ?? [];
+    const trackId = timelineTrackRowId(track);
+    const activeClip = resolveTrackKeyframeClip(
+      elements,
+      laneCounts,
+      selectedElementId,
+      selectedElementIds,
+    );
+    const activeId = activeClip ? elementId(activeClip) : null;
+    const lanes = activeClip
+      ? getTimelinePropertyLanes(
+          gsapAnimations.get(elementId(activeClip)) ?? [],
+          activeClip.start,
+          activeClip.duration,
+        )
+      : [];
+    const expanded = activeId !== null && expandedClipIds.has(activeId) && lanes.length > 0;
+    rows.push({
+      id: trackId,
+      kind: "row",
+      physicalTrackKey: track,
+      logicalIndex: rows.length,
+      level: 1,
+      parentId: null,
+      expanded,
+      items: clipItems(trackId, elements),
+    });
+    if (!expanded || !activeClip) continue;
+    for (const lane of lanes) {
+      const rowId = timelinePropertyRowId(activeId, lane.group);
+      rows.push({
+        id: rowId,
+        kind: "row",
+        physicalTrackKey: track,
+        logicalIndex: rows.length,
+        level: 2,
+        parentId: trackId,
+        expanded: false,
+        propertyGroup: lane.group,
+        items: propertyItems(rowId, activeClip, lane.keyframes),
+      });
+    }
+  }
+  return rows;
+}
+
+function locateTarget(rows: readonly TimelineLogicalRow[], id: string) {
+  for (let rowIndex = 0; rowIndex < rows.length; rowIndex += 1) {
+    const row = rows[rowIndex]!;
+    if (row.id === id) return { row, rowIndex, itemIndex: -1, target: row };
+    const itemIndex = row.items.findIndex((item) => item.id === id);
+    if (itemIndex >= 0) return { row, rowIndex, itemIndex, target: row.items[itemIndex]! };
+  }
+  return null;
+}
+
+function nearestTarget(row: TimelineLogicalRow, time: number): TimelineLogicalTarget {
+  return (
+    [...row.items].sort(
+      (left, right) =>
+        Math.abs(left.time - time) - Math.abs(right.time - time) ||
+        left.time - right.time ||
+        left.id.localeCompare(right.id),
+    )[0] ?? row
+  );
+}
+
+export function resolveTimelineNavigationTarget(
+  rows: readonly TimelineLogicalRow[],
+  currentId: string,
+  key: TimelineNavigationKey,
+  options: TimelineNavigationOptions = {},
+): TimelineLogicalTarget | null {
+  const current = locateTarget(rows, currentId);
+  if (!current) return null;
+  const { row, rowIndex, itemIndex, target } = current;
+
+  if (key === "Home" || key === "End") {
+    const boundaryRow = options.timelineBoundary ? (key === "Home" ? rows[0] : rows.at(-1)) : row;
+    if (!boundaryRow) return target;
+    return key === "Home" ? boundaryRow : (boundaryRow.items.at(-1) ?? boundaryRow);
+  }
+  if (key === "ArrowLeft") {
+    if (itemIndex < 0) return row;
+    return itemIndex === 0 ? row : row.items[itemIndex - 1]!;
+  }
+  if (key === "ArrowRight") {
+    if (itemIndex < 0) return row.items[0] ?? row;
+    return row.items[itemIndex + 1] ?? target;
+  }
+
+  const direction = key === "ArrowUp" || key === "PageUp" ? -1 : 1;
+  const pageKey = key === "PageUp" || key === "PageDown";
+  const pageSize = options.pageSize;
+  if (pageKey && (pageSize === undefined || !Number.isFinite(pageSize) || pageSize < 1)) {
+    return target;
+  }
+  const distance = pageKey ? Math.floor(pageSize!) : 1;
+  const destinationIndex = Math.max(0, Math.min(rows.length - 1, rowIndex + direction * distance));
+  const destination = rows[destinationIndex];
+  if (!destination || destinationIndex === rowIndex) return target;
+  return target.kind === "row" ? destination : nearestTarget(destination, target.time);
+}
+
+/** Preserve focus when possible, then choose previous, next, parent, or nearest surviving row. */
+export function resolveTimelineFocusFallback(
+  previousRows: readonly TimelineLogicalRow[],
+  nextRows: readonly TimelineLogicalRow[],
+  currentId: string,
+): TimelineLogicalTarget | null {
+  const unchanged = locateTarget(nextRows, currentId);
+  if (unchanged) return unchanged.target;
+  const previous = locateTarget(previousRows, currentId);
+  if (!previous) return null;
+
+  if (previous.itemIndex >= 0) {
+    for (let index = previous.itemIndex - 1; index >= 0; index -= 1) {
+      const candidate = locateTarget(nextRows, previous.row.items[index]!.id);
+      if (candidate) return candidate.target;
+    }
+    for (let index = previous.itemIndex + 1; index < previous.row.items.length; index += 1) {
+      const candidate = locateTarget(nextRows, previous.row.items[index]!.id);
+      if (candidate) return candidate.target;
+    }
+  }
+
+  const survivingRow = locateTarget(nextRows, previous.row.id);
+  if (survivingRow) return survivingRow.target;
+  if (previous.row.parentId) {
+    const parent = locateTarget(nextRows, previous.row.parentId);
+    if (parent) return parent.target;
+  }
+  return nextRows[previous.rowIndex] ?? nextRows[previous.rowIndex - 1] ?? null;
+}

From 11d12c1b2c29ee29816b782821a99f83a96c3a8b Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 21:38:08 +0200
Subject: [PATCH 122/125] feat(studio): expose timeline treegrid semantics

---
 .../src/player/components/Timeline.test.ts    | 29 +++++++++--
 .../Timeline.virtualization.test.tsx          | 15 +++---
 .../src/player/components/TimelineLanes.tsx   | 39 ++++++++++++++-
 .../components/TimelinePropertyLanes.tsx      |  2 +
 .../player/components/TimelineTrackHeader.tsx |  6 +++
 .../player/components/TimelineTrackRow.tsx    | 49 ++++++++++++++++---
 .../timelineKeyboardNavigation.test.ts        | 28 ++++++++---
 .../components/timelineKeyboardNavigation.ts  | 34 ++++---------
 .../components/timelineNavigationIdentity.ts  | 33 +++++++++++++
 9 files changed, 181 insertions(+), 54 deletions(-)
 create mode 100644 packages/studio/src/player/components/timelineNavigationIdentity.ts

diff --git a/packages/studio/src/player/components/Timeline.test.ts b/packages/studio/src/player/components/Timeline.test.ts
index 74cc1b700a..398a777914 100644
--- a/packages/studio/src/player/components/Timeline.test.ts
+++ b/packages/studio/src/player/components/Timeline.test.ts
@@ -240,6 +240,25 @@ describe("Timeline provider boundary", () => {
     expect(propertyLane.style.background).toBe("");
     expect(propertyLane.style.border).toBe("");
     expect(propertyLane.style.borderRadius).toBe("");
+    const treegrid = host.querySelector<HTMLElement>('[role="treegrid"]');
+    const semanticRows = treegrid?.querySelectorAll<HTMLElement>('[role="row"]') ?? [];
+    expect(treegrid?.getAttribute("aria-rowcount")).toBe("3");
+    expect([...semanticRows].map((row) => row.getAttribute("aria-rowindex"))).toEqual([
+      "1",
+      "2",
+      "3",
+    ]);
+    expect(semanticRows[0]?.getAttribute("aria-level")).toBe("1");
+    expect(semanticRows[0]?.getAttribute("aria-expanded")).toBe("true");
+    expect(semanticRows[1]?.getAttribute("aria-level")).toBe("2");
+    expect(semanticRows[1]?.textContent).toContain("position");
+    expect(semanticRows[1]?.querySelector('[role="rowheader"]')?.getAttribute("aria-owns")).toBe(
+      headerLane.id,
+    );
+    expect(semanticRows[1]?.querySelector('[role="gridcell"]')?.getAttribute("aria-owns")).toBe(
+      propertyLane.id,
+    );
+    expect(semanticRows[2]?.hasAttribute("aria-expanded")).toBe(false);
     expect(trackHeader.style.width).toBe(`${LABEL_COL_W}px`);
     expect(rulerOrigin.style.width).toBe(`${LABEL_COL_W + GUTTER}px`);
     expect(playhead.style.left).toBe(`${LABEL_COL_W + GUTTER + 1000 - PLAYHEAD_HEAD_W / 2}px`);
@@ -291,12 +310,12 @@ describe("Timeline provider boundary", () => {
     const root = createRoot(host);
     act(() => root.render(React.createElement(Timeline)));
 
-    const list = host.querySelector<HTMLElement>('[role="list"]');
-    const rows = list?.querySelectorAll('[role="listitem"]') ?? [];
+    const treegrid = host.querySelector<HTMLElement>('[role="treegrid"]');
+    const rows = treegrid?.querySelectorAll('[role="row"]') ?? [];
     expect(rows).toHaveLength(12);
-    expect(rows[0]?.getAttribute("aria-posinset")).toBe("1");
-    expect(rows[0]?.getAttribute("aria-setsize")).toBe("12");
-    expect(rows[11]?.getAttribute("aria-posinset")).toBe("12");
+    expect(treegrid?.getAttribute("aria-rowcount")).toBe("12");
+    expect(rows[0]?.getAttribute("aria-rowindex")).toBe("1");
+    expect(rows[11]?.getAttribute("aria-rowindex")).toBe("12");
 
     act(() => root.unmount());
   });
diff --git a/packages/studio/src/player/components/Timeline.virtualization.test.tsx b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
index 85e406bd09..ab1bdc5735 100644
--- a/packages/studio/src/player/components/Timeline.virtualization.test.tsx
+++ b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
@@ -151,16 +151,15 @@ describe("Timeline row virtualization", { timeout: 30_000 }, () => {
 
     await settleUntil(
       () =>
-        (host.querySelector('[role="list"]')?.querySelectorAll('[role="listitem"]').length ?? 0) >
-        0,
+        (host.querySelector('[role="treegrid"]')?.querySelectorAll('[role="row"]').length ?? 0) > 0,
     );
-    const list = host.querySelector<HTMLElement>('[role="list"]');
-    const rows = list?.querySelectorAll('[role="listitem"]') ?? [];
+    const treegrid = host.querySelector<HTMLElement>('[role="treegrid"]');
+    const rows = treegrid?.querySelectorAll('[role="row"]') ?? [];
     expect(rows.length).toBeGreaterThan(0);
     expect(rows.length).toBeLessThanOrEqual(16);
-    expect(rows[0]?.getAttribute("aria-posinset")).toBe("1");
-    expect(rows[0]?.getAttribute("aria-setsize")).toBe("1000");
-    expect(list?.parentElement?.style.height).toBe(
+    expect(rows[0]?.getAttribute("aria-rowindex")).toBe("1");
+    expect(treegrid?.getAttribute("aria-rowcount")).toBe("1000");
+    expect(treegrid?.parentElement?.style.height).toBe(
       `${getTimelineCanvasHeight(Array.from({ length: 1_000 }, () => TRACK_H))}px`,
     );
 
@@ -176,7 +175,7 @@ describe("Timeline row virtualization", { timeout: 30_000 }, () => {
         scroller.dispatchEvent(new Event("scroll"));
       });
     }
-    expect(list?.querySelector('[data-timeline-row-key="0"]')).not.toBeNull();
+    expect(treegrid?.querySelector('[data-timeline-row-key="0"]')).not.toBeNull();
     expect(document.activeElement).toBe(focusedControl);
 
     act(() => root.unmount());
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index e26ffd5df7..d2112cfee7 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -1,3 +1,4 @@
+import { useMemo } from "react";
 import { BeatStrip, BeatBackgroundLines } from "./BeatStrip";
 import { TimelineClip } from "./TimelineClip";
 import { TimelineClipDiamonds } from "./TimelineClipDiamonds";
@@ -22,6 +23,7 @@ import type { TimelineLaneBaseProps } from "./TimelineLaneTypes";
 import { TimelineTrackRow } from "./TimelineTrackRow";
 import { isTimelineClipActive } from "./useTimelineActiveClips";
 import { queryTimelineClipIndex } from "../lib/timelineClipIndex";
+import { buildTimelineLogicalRows, type TimelineLogicalRow } from "./timelineKeyboardNavigation";
 
 interface TimelineLanesProps extends TimelineLaneBaseProps {
   /** Live-derived by TimelineCanvas from {@link TimelineLaneBaseProps.draggedClip}. */
@@ -96,6 +98,32 @@ export function TimelineLanes({
 }: TimelineLanesProps) {
   const expandedClipIds = usePlayerStore((s) => s.expandedClipIds);
   const toggleClipExpanded = usePlayerStore((s) => s.toggleClipExpanded);
+  const { logicalRows, logicalRowsByTrack } = useMemo(() => {
+    const rows = buildTimelineLogicalRows({
+      tracks,
+      displayTrackOrder,
+      laneCounts,
+      selectedElementId,
+      selectedElementIds,
+      expandedClipIds: STUDIO_KEYFRAMES_ENABLED ? expandedClipIds : new Set(),
+      gsapAnimations,
+    });
+    const byTrack = new Map<number, TimelineLogicalRow[]>();
+    for (const logicalRow of rows) {
+      const trackRows = byTrack.get(logicalRow.physicalTrackKey) ?? [];
+      trackRows.push(logicalRow);
+      byTrack.set(logicalRow.physicalTrackKey, trackRows);
+    }
+    return { logicalRows: rows, logicalRowsByTrack: byTrack };
+  }, [
+    displayTrackOrder,
+    expandedClipIds,
+    gsapAnimations,
+    laneCounts,
+    selectedElementId,
+    selectedElementIds,
+    tracks,
+  ]);
   const toggleClipExpandedTracked = (key: string) => {
     const willExpand = !expandedClipIds.has(key);
     trackStudioKeyframeLaneExpand({ expanded: willExpand });
@@ -103,8 +131,10 @@ export function TimelineLanes({
   };
   return (
     <div
-      role="list"
+      role="treegrid"
       aria-label="Timeline tracks"
+      aria-multiselectable="true"
+      aria-rowcount={logicalRows.length}
       className={rowsVirtualized ? "absolute inset-0" : undefined}
     >
       {
@@ -112,6 +142,9 @@ export function TimelineLanes({
         virtualRows.map(({ index: row, rowKey }) => {
           const trackNum = displayTrackOrder[row];
           if (trackNum === undefined) return null;
+          const trackLogicalRows = logicalRowsByTrack.get(trackNum) ?? [];
+          const logicalRow = trackLogicalRows[0];
+          if (!logicalRow) return null;
           const rowHeight = rowGeometry.getRowHeight(row);
           const els = tracks.find(([t]) => t === trackNum)?.[1] ?? [];
           const indexedRenderElements = rowsVirtualized
@@ -166,7 +199,8 @@ export function TimelineLanes({
               key={rowKey}
               index={row}
               rowKey={rowKey}
-              rowCount={displayTrackOrder.length}
+              logicalRow={logicalRow}
+              propertyRows={trackLogicalRows.slice(1)}
               top={rowGeometry.getRowTop(row)}
               height={rowHeight}
               virtualized={rowsVirtualized}
@@ -195,6 +229,7 @@ export function TimelineLanes({
                 onSeek={onSeek}
               />
               <div
+                role="gridcell"
                 style={{
                   width: trackContentWidth,
                   marginLeft: contentGutter, // room for a 0% diamond left of t=0
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
index 018aa4f8a0..13965cc39e 100644
--- a/packages/studio/src/player/components/TimelinePropertyLanes.tsx
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
@@ -9,6 +9,7 @@ import { synthesizeFlatTweenKeyframes } from "../../hooks/gsapTweenSynth";
 import { TimelineDiamondLane, type TimelineDiamondKeyframe } from "./TimelineClipDiamonds";
 import { LANE_H, getTimelineLaneTop } from "./timelineLayout";
 import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
+import { timelineLogicalRowCellId, timelinePropertyRowId } from "./timelineNavigationIdentity";
 
 export interface TimelinePropertyLanesProps {
   animations: readonly GsapAnimation[];
@@ -154,6 +155,7 @@ export function TimelinePropertyLanes({
       {laneData.map(({ group, keyframesData }, laneIndex) => (
         <div
           key={group}
+          id={timelineLogicalRowCellId(timelinePropertyRowId(elementId, group), "content")}
           role="group"
           aria-label={`${group} keyframes`}
           data-property-group={group}
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index 2052039015..18bf8e694f 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -14,6 +14,7 @@ import {
   type TimelinePropertyLane,
 } from "./trackHeaderLaneState";
 import { valueReadout } from "./trackHeaderLaneValues";
+import { timelineLogicalRowCellId, timelinePropertyRowId } from "./timelineNavigationIdentity";
 
 interface TimelineTrackHeaderProps {
   trackNumber: number;
@@ -199,6 +200,10 @@ function PropertyGroupHeaderRow({
 
   return (
     <div
+      id={timelineLogicalRowCellId(
+        timelinePropertyRowId(expandedElement.key ?? expandedElement.id, lane.group),
+        "header",
+      )}
       data-property-group={lane.group}
       data-timeline-lane-top={getTimelineLaneTop(laneIndex)}
       className="absolute left-0 flex items-center gap-1 px-1.5 text-[10px] text-white/65"
@@ -284,6 +289,7 @@ export function TimelineTrackHeader({
 
   return (
     <div
+      role="rowheader"
       className={`sticky left-0 z-[12] shrink-0 ${
         !isKeyframeLayer
           ? showTrackLabel
diff --git a/packages/studio/src/player/components/TimelineTrackRow.tsx b/packages/studio/src/player/components/TimelineTrackRow.tsx
index de1865a416..bb099581bf 100644
--- a/packages/studio/src/player/components/TimelineTrackRow.tsx
+++ b/packages/studio/src/player/components/TimelineTrackRow.tsx
@@ -1,9 +1,12 @@
 import type { ReactNode } from "react";
+import { timelineLogicalRowCellId } from "./timelineNavigationIdentity";
+import type { TimelineLogicalRow } from "./timelineKeyboardNavigation";
 
 interface TimelineTrackRowProps {
   index: number;
   rowKey: number;
-  rowCount: number;
+  logicalRow: TimelineLogicalRow;
+  propertyRows: readonly TimelineLogicalRow[];
   top: number;
   height: number;
   virtualized: boolean;
@@ -16,7 +19,8 @@ interface TimelineTrackRowProps {
 export function TimelineTrackRow({
   index,
   rowKey,
-  rowCount,
+  logicalRow,
+  propertyRows,
   top,
   height,
   virtualized,
@@ -26,13 +30,11 @@ export function TimelineTrackRow({
 }: TimelineTrackRowProps) {
   return (
     <div
-      role="listitem"
-      aria-posinset={index + 1}
-      aria-setsize={rowCount}
+      role="rowgroup"
       data-index={index}
       data-timeline-row={index}
       data-timeline-row-key={rowKey}
-      className={`${virtualized ? "absolute left-0 right-0" : "relative"} flex`}
+      className={virtualized ? "absolute left-0 right-0" : "relative"}
       style={{
         top: virtualized ? top : undefined,
         height,
@@ -40,7 +42,40 @@ export function TimelineTrackRow({
         borderBottom: `1px solid ${borderColor}`,
       }}
     >
-      {children}
+      <div
+        role="row"
+        aria-rowindex={logicalRow.logicalIndex + 1}
+        aria-level={logicalRow.level}
+        aria-expanded={logicalRow.expandable ? logicalRow.expanded : undefined}
+        data-timeline-logical-row-id={logicalRow.id}
+        className="flex"
+        style={{ height }}
+      >
+        {children}
+      </div>
+      {propertyRows.map((row) => {
+        const group = row.propertyGroup;
+        const keyframeCount = row.items.filter((item) => item.kind === "keyframe").length;
+        const easeCount = row.items.filter((item) => item.kind === "ease").length;
+        return (
+          <div
+            key={row.id}
+            role="row"
+            aria-rowindex={row.logicalIndex + 1}
+            aria-level={row.level}
+            data-property-group={group}
+            data-timeline-logical-row-id={row.id}
+            className="sr-only"
+          >
+            <div role="rowheader" aria-owns={timelineLogicalRowCellId(row.id, "header")}>
+              {group}
+            </div>
+            <div role="gridcell" aria-owns={timelineLogicalRowCellId(row.id, "content")}>
+              {keyframeCount} keyframes, {easeCount} ease controls
+            </div>
+          </div>
+        );
+      })}
     </div>
   );
 }
diff --git a/packages/studio/src/player/components/timelineKeyboardNavigation.test.ts b/packages/studio/src/player/components/timelineKeyboardNavigation.test.ts
index 099735544a..d567ccebe4 100644
--- a/packages/studio/src/player/components/timelineKeyboardNavigation.test.ts
+++ b/packages/studio/src/player/components/timelineKeyboardNavigation.test.ts
@@ -5,9 +5,8 @@ import {
   buildTimelineLogicalRows,
   resolveTimelineFocusFallback,
   resolveTimelineNavigationTarget,
-  timelineClipFocusId,
-  timelineTrackRowId,
 } from "./timelineKeyboardNavigation";
+import { timelineClipFocusId, timelineTrackRowId } from "./timelineNavigationIdentity";
 
 function clip(id: string, track: number, start: number, duration = 2): TimelineElement {
   return { id, track, start, duration, tag: "div" };
@@ -66,18 +65,31 @@ describe("buildTimelineLogicalRows", () => {
     const rows = model();
 
     expect(
-      rows.map(({ physicalTrackKey, logicalIndex, level, parentId }) => ({
+      rows.map(({ physicalTrackKey, logicalIndex, level, parentId, expandable }) => ({
         physicalTrackKey,
         logicalIndex,
         level,
         parentId,
+        expandable,
       })),
     ).toEqual([
-      { physicalTrackKey: 1, logicalIndex: 0, level: 1, parentId: null },
-      { physicalTrackKey: 1, logicalIndex: 1, level: 2, parentId: timelineTrackRowId(1) },
-      { physicalTrackKey: 1, logicalIndex: 2, level: 2, parentId: timelineTrackRowId(1) },
-      { physicalTrackKey: 2, logicalIndex: 3, level: 1, parentId: null },
-      { physicalTrackKey: 3, logicalIndex: 4, level: 1, parentId: null },
+      { physicalTrackKey: 1, logicalIndex: 0, level: 1, parentId: null, expandable: true },
+      {
+        physicalTrackKey: 1,
+        logicalIndex: 1,
+        level: 2,
+        parentId: timelineTrackRowId(1),
+        expandable: false,
+      },
+      {
+        physicalTrackKey: 1,
+        logicalIndex: 2,
+        level: 2,
+        parentId: timelineTrackRowId(1),
+        expandable: false,
+      },
+      { physicalTrackKey: 2, logicalIndex: 3, level: 1, parentId: null, expandable: false },
+      { physicalTrackKey: 3, logicalIndex: 4, level: 1, parentId: null, expandable: false },
     ]);
     expect(rows[0]?.expanded).toBe(true);
     expect(rows[3]?.items).toEqual([]);
diff --git a/packages/studio/src/player/components/timelineKeyboardNavigation.ts b/packages/studio/src/player/components/timelineKeyboardNavigation.ts
index 60588eabd5..c86e98ee96 100644
--- a/packages/studio/src/player/components/timelineKeyboardNavigation.ts
+++ b/packages/studio/src/player/components/timelineKeyboardNavigation.ts
@@ -5,6 +5,13 @@ import {
   timelineKeyframeSelectionKey,
   type TimelineKeyframeTarget,
 } from "./timelineKeyframeIdentity";
+import {
+  timelineClipFocusId,
+  timelineEaseFocusId,
+  timelineKeyframeFocusId,
+  timelinePropertyRowId,
+  timelineTrackRowId,
+} from "./timelineNavigationIdentity";
 import { resolveTrackKeyframeClip } from "./useTimelineTrackLayout";
 
 export type TimelineNavigationKey =
@@ -49,6 +56,7 @@ export interface TimelineLogicalRow {
   logicalIndex: number;
   level: 1 | 2;
   parentId: string | null;
+  expandable: boolean;
   expanded: boolean;
   propertyGroup?: PropertyGroupName;
   items: readonly TimelineLogicalItem[];
@@ -73,30 +81,6 @@ export interface TimelineNavigationOptions {
   timelineBoundary?: boolean;
 }
 
-function stableId(kind: string, ...parts: Array<string | number>): string {
-  return JSON.stringify(["timeline", kind, ...parts]);
-}
-
-export function timelineTrackRowId(track: number): string {
-  return stableId("track", track);
-}
-
-export function timelinePropertyRowId(elementId: string, group: PropertyGroupName): string {
-  return stableId("property", elementId, group);
-}
-
-export function timelineClipFocusId(elementId: string): string {
-  return stableId("clip", elementId);
-}
-
-export function timelineKeyframeFocusId(elementId: string, target: TimelineKeyframeTarget): string {
-  return stableId("keyframe", timelineKeyframeSelectionKey(elementId, target));
-}
-
-export function timelineEaseFocusId(elementId: string, target: TimelineKeyframeTarget): string {
-  return stableId("ease", timelineKeyframeSelectionKey(elementId, target));
-}
-
 function elementId(element: TimelineElement): string {
   return element.key ?? element.id;
 }
@@ -217,6 +201,7 @@ export function buildTimelineLogicalRows({
       logicalIndex: rows.length,
       level: 1,
       parentId: null,
+      expandable: lanes.length > 0,
       expanded,
       items: clipItems(trackId, elements),
     });
@@ -230,6 +215,7 @@ export function buildTimelineLogicalRows({
         logicalIndex: rows.length,
         level: 2,
         parentId: trackId,
+        expandable: false,
         expanded: false,
         propertyGroup: lane.group,
         items: propertyItems(rowId, activeClip, lane.keyframes),
diff --git a/packages/studio/src/player/components/timelineNavigationIdentity.ts b/packages/studio/src/player/components/timelineNavigationIdentity.ts
new file mode 100644
index 0000000000..4624ea9578
--- /dev/null
+++ b/packages/studio/src/player/components/timelineNavigationIdentity.ts
@@ -0,0 +1,33 @@
+import type { PropertyGroupName } from "@hyperframes/core/gsap-parser";
+import {
+  timelineKeyframeSelectionKey,
+  type TimelineKeyframeTarget,
+} from "./timelineKeyframeIdentity";
+
+function stableId(kind: string, ...parts: Array<string | number>): string {
+  return JSON.stringify(["timeline", kind, ...parts]);
+}
+
+export function timelineTrackRowId(track: number): string {
+  return stableId("track", track);
+}
+
+export function timelinePropertyRowId(elementId: string, group: PropertyGroupName): string {
+  return stableId("property", elementId, group);
+}
+
+export function timelineLogicalRowCellId(rowId: string, cell: "header" | "content"): string {
+  return `${rowId}:${cell}`;
+}
+
+export function timelineClipFocusId(elementId: string): string {
+  return stableId("clip", elementId);
+}
+
+export function timelineKeyframeFocusId(elementId: string, target: TimelineKeyframeTarget): string {
+  return stableId("keyframe", timelineKeyframeSelectionKey(elementId, target));
+}
+
+export function timelineEaseFocusId(elementId: string, target: TimelineKeyframeTarget): string {
+  return stableId("ease", timelineKeyframeSelectionKey(elementId, target));
+}

From 8b6adc44e01e77ebd398d5dab116e050b4b81d86 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 21:41:28 +0200
Subject: [PATCH 123/125] feat(studio): coordinate logical timeline focus

---
 .../src/components/sidebar/AssetCard.tsx      |   7 +-
 .../src/components/sidebar/AudioRow.tsx       |   7 +-
 .../studio/src/player/components/Timeline.tsx |  78 +++----
 .../Timeline.virtualization.test.tsx          |   9 +-
 .../src/player/components/TimelineClip.tsx    |   2 +
 .../player/components/TimelineLaneTypes.ts    |   2 +
 .../src/player/components/TimelineLanes.tsx   |  28 +--
 .../components/TimelinePropertyLanes.tsx      |   1 +
 .../player/components/TimelineTrackHeader.tsx |   9 +-
 .../player/components/TimelineTrackRow.tsx    |   2 +
 .../components/timelineKeyboardNavigation.ts  |  19 +-
 .../components/useTimelineClipRenderWindow.ts |  33 +--
 .../useTimelineFocusCoordinator.test.tsx      | 138 ++++++++++++
 .../components/useTimelineFocusCoordinator.ts | 211 ++++++++++++++++++
 .../components/useTimelineLogicalFocus.ts     |  92 ++++++++
 .../components/useTimelineRevealClip.test.tsx |  87 --------
 .../components/useTimelineRevealClip.ts       | 144 ------------
 .../useTimelineRowVirtualization.ts           |  20 +-
 .../src/player/store/playerStore.test.ts      |  51 +++--
 .../studio/src/player/store/playerStore.ts    |  38 ++--
 .../src/player/store/timelineFocusState.ts    |  15 ++
 21 files changed, 605 insertions(+), 388 deletions(-)
 create mode 100644 packages/studio/src/player/components/useTimelineFocusCoordinator.test.tsx
 create mode 100644 packages/studio/src/player/components/useTimelineFocusCoordinator.ts
 create mode 100644 packages/studio/src/player/components/useTimelineLogicalFocus.ts
 delete mode 100644 packages/studio/src/player/components/useTimelineRevealClip.test.tsx
 delete mode 100644 packages/studio/src/player/components/useTimelineRevealClip.ts
 create mode 100644 packages/studio/src/player/store/timelineFocusState.ts

diff --git a/packages/studio/src/components/sidebar/AssetCard.tsx b/packages/studio/src/components/sidebar/AssetCard.tsx
index e6eaeca96c..6ebf6fcb91 100644
--- a/packages/studio/src/components/sidebar/AssetCard.tsx
+++ b/packages/studio/src/components/sidebar/AssetCard.tsx
@@ -8,6 +8,7 @@ import { VIDEO_EXT, IMAGE_EXT } from "../../utils/mediaTypes";
 import { TIMELINE_ASSET_MIME } from "../../utils/timelineAssetDrop";
 import { ContextMenu } from "./AssetContextMenu";
 import { usePlayerStore } from "../../player/store/playerStore";
+import { timelineClipFocusId } from "../../player/components/timelineNavigationIdentity";
 import { useAssetPreviewStore } from "../../utils/assetPreviewStore";
 import { findClipForAsset, isPointerClick } from "../../utils/assetClickBehavior";
 import { basename, ext, truncateMiddle, formatDuration } from "./assetHelpers";
@@ -133,7 +134,7 @@ export function AssetCard({
   const pointerDownRef = useRef<{ x: number; y: number } | null>(null);
 
   const setSelectedElementId = usePlayerStore((s) => s.setSelectedElementId);
-  const requestClipReveal = usePlayerStore((s) => s.requestClipReveal);
+  const requestTimelineFocus = usePlayerStore((s) => s.requestTimelineFocus);
   const elements = usePlayerStore((s) => s.elements);
   const setPreviewAsset = useAssetPreviewStore((s) => s.setPreviewAsset);
   const clearPreviewAsset = useAssetPreviewStore((s) => s.clearPreviewAsset);
@@ -158,7 +159,7 @@ export function AssetCard({
           const clipKey = clip.key ?? clip.id;
           setSelectedElementId(clipKey);
           // Scroll the timeline so the selected clip is actually visible.
-          requestClipReveal(clipKey);
+          requestTimelineFocus(timelineClipFocusId(clipKey));
           return;
         }
       }
@@ -171,7 +172,7 @@ export function AssetCard({
       asset,
       projectId,
       setSelectedElementId,
-      requestClipReveal,
+      requestTimelineFocus,
       setPreviewAsset,
       clearPreviewAsset,
     ],
diff --git a/packages/studio/src/components/sidebar/AudioRow.tsx b/packages/studio/src/components/sidebar/AudioRow.tsx
index 5df7d59801..7b0fff0a2c 100644
--- a/packages/studio/src/components/sidebar/AudioRow.tsx
+++ b/packages/studio/src/components/sidebar/AudioRow.tsx
@@ -6,6 +6,7 @@ import { usePlayerStore } from "../../player/store/playerStore";
 import { useAssetPreviewStore } from "../../utils/assetPreviewStore";
 import { findClipForAsset, isPointerClick } from "../../utils/assetClickBehavior";
 import { resolveMediaPreviewUrl } from "../../player/components/thumbnailUtils";
+import { timelineClipFocusId } from "../../player/components/timelineNavigationIdentity";
 
 export function AudioRow({
   projectId,
@@ -43,7 +44,7 @@ export function AudioRow({
   // CapCut-style click behavior: drag-threshold gate.
   const pointerDownRef = useRef<{ x: number; y: number } | null>(null);
   const setSelectedElementId = usePlayerStore((s) => s.setSelectedElementId);
-  const requestClipReveal = usePlayerStore((s) => s.requestClipReveal);
+  const requestTimelineFocus = usePlayerStore((s) => s.requestTimelineFocus);
   const elements = usePlayerStore((s) => s.elements);
   const setPreviewAsset = useAssetPreviewStore((s) => s.setPreviewAsset);
   const clearPreviewAsset = useAssetPreviewStore((s) => s.clearPreviewAsset);
@@ -67,7 +68,7 @@ export function AudioRow({
           const clipKey = clip.key ?? clip.id;
           setSelectedElementId(clipKey);
           // Scroll the timeline so the selected clip is actually visible.
-          requestClipReveal(clipKey);
+          requestTimelineFocus(timelineClipFocusId(clipKey));
           return;
         }
       }
@@ -80,7 +81,7 @@ export function AudioRow({
       asset,
       projectId,
       setSelectedElementId,
-      requestClipReveal,
+      requestTimelineFocus,
       setPreviewAsset,
       clearPreviewAsset,
     ],
diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 5dd1dc0247..81dcddbc8f 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -41,9 +41,9 @@ import { useTimelineSelectionLifecycle } from "./useTimelineSelectionLifecycle";
 import { useTimelineShiftModifier } from "./useTimelineShiftModifier";
 import { useTimelineTicks } from "./useTimelineTicks";
 import { getTimelineElementIndexes } from "../lib/timelineElementIndexes";
-import { useTimelineRowVirtualization } from "./useTimelineRowVirtualization";
 import { useTimelineClipRenderWindow } from "./useTimelineClipRenderWindow";
 import { useTimelineActiveClips } from "./useTimelineActiveClips";
+import { useTimelineLogicalFocus } from "./useTimelineLogicalFocus";
 
 export {
   generateTicks,
@@ -127,7 +127,6 @@ export const Timeline = memo(function Timeline({
   const timelineReady = usePlayerStore((s) => s.timelineReady);
   const selectedElementId = usePlayerStore((s) => s.selectedElementId);
   const selectedElementIds = usePlayerStore((s) => s.selectedElementIds);
-  const clipRevealRequest = usePlayerStore((s) => s.clipRevealRequest);
   const focusedEaseSegment = usePlayerStore((s) => s.focusedEaseSegment);
   const gsapAnimations = usePlayerStore((s) => s.gsapAnimations);
   const hasKeyframedClips = useMemo(
@@ -186,7 +185,6 @@ export const Timeline = memo(function Timeline({
   const ppsRef = useRef(100);
   const durationRef = useRef(effectiveDuration);
   durationRef.current = effectiveDuration;
-  // Declared before the fitPps derivation so the edit-pin wrappers can close over it.
   const fitPpsRef = useRef(100);
 
   const {
@@ -280,34 +278,6 @@ export const Timeline = memo(function Timeline({
       expandedElements.length,
       displayLayout.totalH,
     ]);
-  const { enabled: rowVirtualizationActive, virtualRows } = useTimelineRowVirtualization({
-    scrollRef,
-    viewport,
-    rowGeometry: displayLayout.rowGeometry,
-    sessionEpoch,
-    elements: expandedElements,
-    selectedElementId,
-    revealElementId: clipRevealRequest?.elementId ?? null,
-    draggedRowKey: draggedClip?.started ? draggedClip.previewTrack : undefined,
-    resizingRowKey: resizingClip?.element.track,
-    clipContextMenuRowKey: clipContextMenu?.element.track,
-    keyframeContextMenuRowKey: kfContextMenu?.element.track,
-    lastScrollLeftRef,
-    syncScrollViewport,
-  });
-  const selectedKeyframes = usePlayerStore((s) => s.selectedKeyframes);
-  const toggleSelectedKeyframe = usePlayerStore((s) => s.toggleSelectedKeyframe);
-  const { onClickKeyframe, onSelectSegment, onShiftClickKeyframe, onContextMenuKeyframe } =
-    useTimelineKeyframeHandlers({
-      expandedElements,
-      keyframeCache,
-      onSelectElement,
-      onSeek,
-      setSelectedElementId,
-      setKfContextMenu,
-      toggleSelectedKeyframe,
-    });
-
   const { pps, fitPps, displayContentWidth, displayDuration, zoomModeRef, manualZoomPercentRef } =
     useTimelineGeometry({
       viewportWidth: viewport.clientWidth,
@@ -324,6 +294,41 @@ export const Timeline = memo(function Timeline({
       lastScrollLeftRef,
       contentOrigin,
     });
+  const { logicalRows, pinnedElementId, rowVirtualizationActive, virtualRows } =
+    useTimelineLogicalFocus({
+      scrollRef,
+      tracks,
+      layout: displayLayout,
+      laneCounts,
+      selectedElementId,
+      selectedElementIds,
+      gsapAnimations,
+      elements: expandedElements,
+      pixelsPerSecond: pps,
+      contentOrigin,
+      allowHorizontal: zoomMode === "manual",
+      viewport,
+      sessionEpoch,
+      draggedRowKey: draggedClip?.started ? draggedClip.previewTrack : undefined,
+      resizingRowKey: resizingClip?.element.track,
+      clipContextMenuRowKey: clipContextMenu?.element.track,
+      keyframeContextMenuRowKey: kfContextMenu?.element.track,
+      lastScrollLeftRef,
+      syncScrollViewport,
+    });
+  const selectedKeyframes = usePlayerStore((s) => s.selectedKeyframes);
+  const toggleSelectedKeyframe = usePlayerStore((s) => s.toggleSelectedKeyframe);
+  const { onClickKeyframe, onSelectSegment, onShiftClickKeyframe, onContextMenuKeyframe } =
+    useTimelineKeyframeHandlers({
+      expandedElements,
+      keyframeCache,
+      onSelectElement,
+      onSeek,
+      setSelectedElementId,
+      setKfContextMenu,
+      toggleSelectedKeyframe,
+    });
+
   const { clipIndex, renderTimeRange, pinnedClipIdentities } = useTimelineClipRenderWindow({
     tracks,
     viewport,
@@ -335,15 +340,10 @@ export const Timeline = memo(function Timeline({
     resizingElementIds:
       resizingClip?.groupPreview?.map((change) => change.key) ??
       (resizingClip ? [resizingClip.element.key ?? resizingClip.element.id] : undefined),
-    revealElementId: clipRevealRequest?.elementId,
+    focusedElementId: pinnedElementId,
     focusedEaseElementId: focusedEaseSegment?.elementId,
     clipContextMenuElementId: clipContextMenu?.element.key ?? clipContextMenu?.element.id,
     keyframeContextMenuElementId: kfContextMenu?.element.key ?? kfContextMenu?.element.id,
-    scrollRef,
-    elements: expandedElements,
-    rowGeometry: displayLayout.rowGeometry,
-    allowHorizontalReveal: zoomMode === "manual",
-    sessionEpoch,
   });
   useTimelineActiveClips({
     scrollRef,
@@ -479,8 +479,7 @@ export const Timeline = memo(function Timeline({
         onDragLeave={assetDrop.handleAssetDragLeave}
         onDrop={assetDrop.handleAssetDrop}
         onPointerDown={(e) => {
-          // Let interactive controls (keyframe nav/toggle, caret, inputs) handle
-          // their own clicks — scrubbing here would preventDefault and eat them.
+          // Interactive controls own their clicks; scrubbing would preventDefault and eat them.
           if (e.target instanceof Element && e.target.closest("button, input, select, a")) return;
           if (splitAllAtPointer(e)) return;
           handlePointerDown(e);
@@ -508,6 +507,7 @@ export const Timeline = memo(function Timeline({
           rowHeights={displayLayout.displayRowHeights}
           rowGeometry={displayLayout.rowGeometry}
           virtualRows={virtualRows}
+          logicalRows={logicalRows}
           rowsVirtualized={rowVirtualizationActive}
           clipIndex={clipIndex}
           renderTimeRange={renderTimeRange}
diff --git a/packages/studio/src/player/components/Timeline.virtualization.test.tsx b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
index ab1bdc5735..230e118a50 100644
--- a/packages/studio/src/player/components/Timeline.virtualization.test.tsx
+++ b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
@@ -191,6 +191,8 @@ describe("Timeline row virtualization", { timeout: 30_000 }, () => {
     usePlayerStore.setState({
       duration: 1_000,
       timelineReady: true,
+      timelineProjectId: "project-a",
+      timelineSessionEpoch: 4,
       zoomMode: "manual",
       manualZoomPercent: 2_000,
       selectedElementId: "clip-490",
@@ -241,12 +243,15 @@ describe("Timeline row virtualization", { timeout: 30_000 }, () => {
     expect(host.querySelector('[data-el-id="clip-490"]')).not.toBeNull();
     expect(host.querySelectorAll("[data-timeline-grid-cell]").length).toBeLessThan(100);
 
-    await act(async () => usePlayerStore.getState().requestClipReveal("clip-300"));
+    const { timelineClipFocusId } = await import("./timelineNavigationIdentity");
+    await act(async () =>
+      usePlayerStore.getState().requestTimelineFocus(timelineClipFocusId("clip-300")),
+    );
     await act(async () => {
       await new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));
     });
     await act(async () => {});
-    expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe(timelineClipFocusId("clip-300"));
     expect(document.activeElement?.getAttribute("data-el-id")).toBe("clip-300");
     expect(host.querySelector('[data-el-id="clip-490"]')).not.toBeNull();
 
diff --git a/packages/studio/src/player/components/TimelineClip.tsx b/packages/studio/src/player/components/TimelineClip.tsx
index 40410b565f..5ad9cedbe4 100644
--- a/packages/studio/src/player/components/TimelineClip.tsx
+++ b/packages/studio/src/player/components/TimelineClip.tsx
@@ -3,6 +3,7 @@ import type { TimelineElement } from "../store/playerStore";
 import { defaultTimelineTheme, getClipHandleOpacity, type TimelineTheme } from "./timelineTheme";
 import type { TimelineEditCapabilities } from "./timelineEditing";
 import { isAudioTimelineElement } from "../../utils/timelineInspector";
+import { timelineClipFocusId } from "./timelineNavigationIdentity";
 
 interface TimelineClipProps {
   el: TimelineElement;
@@ -89,6 +90,7 @@ export const TimelineClip = memo(function TimelineClip({
     <div
       data-clip={isGestureActor ? undefined : "true"}
       data-el-id={isGestureActor ? undefined : (el.key ?? el.id)}
+      data-timeline-focus-id={isGestureActor ? undefined : timelineClipFocusId(el.key ?? el.id)}
       data-clip-start={el.start}
       data-clip-end={el.start + el.duration}
       data-clip-hidden={el.hidden ? "true" : undefined}
diff --git a/packages/studio/src/player/components/TimelineLaneTypes.ts b/packages/studio/src/player/components/TimelineLaneTypes.ts
index 5cb2d479b7..c13344704f 100644
--- a/packages/studio/src/player/components/TimelineLaneTypes.ts
+++ b/packages/studio/src/player/components/TimelineLaneTypes.ts
@@ -9,6 +9,7 @@ import type { KeyframeCacheEntry, TimelineElement } from "../store/playerStore";
 import type { TimelineClipIndex, TimelineTimeRange } from "../lib/timelineClipIndex";
 import type { TimelineRowGeometry } from "./timelineLayout";
 import type { TimelineVirtualRow } from "./useTimelineVirtualRows";
+import type { TimelineLogicalRow } from "./timelineKeyboardNavigation";
 
 /**
  * Props shared by the scroll container ({@link TimelineCanvas}) and its lane
@@ -26,6 +27,7 @@ export interface TimelineLaneBaseProps {
   rowHeights: readonly number[];
   rowGeometry: TimelineRowGeometry;
   virtualRows: readonly TimelineVirtualRow[];
+  logicalRows: readonly TimelineLogicalRow[];
   rowsVirtualized: boolean;
   clipIndex: TimelineClipIndex;
   renderTimeRange: TimelineTimeRange;
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index d2112cfee7..64d43408f5 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -23,7 +23,7 @@ import type { TimelineLaneBaseProps } from "./TimelineLaneTypes";
 import { TimelineTrackRow } from "./TimelineTrackRow";
 import { isTimelineClipActive } from "./useTimelineActiveClips";
 import { queryTimelineClipIndex } from "../lib/timelineClipIndex";
-import { buildTimelineLogicalRows, type TimelineLogicalRow } from "./timelineKeyboardNavigation";
+import type { TimelineLogicalRow } from "./timelineKeyboardNavigation";
 
 interface TimelineLanesProps extends TimelineLaneBaseProps {
   /** Live-derived by TimelineCanvas from {@link TimelineLaneBaseProps.draggedClip}. */
@@ -46,6 +46,7 @@ export function TimelineLanes({
   displayTrackOrder,
   rowGeometry,
   virtualRows,
+  logicalRows,
   rowsVirtualized,
   clipIndex,
   renderTimeRange,
@@ -98,32 +99,15 @@ export function TimelineLanes({
 }: TimelineLanesProps) {
   const expandedClipIds = usePlayerStore((s) => s.expandedClipIds);
   const toggleClipExpanded = usePlayerStore((s) => s.toggleClipExpanded);
-  const { logicalRows, logicalRowsByTrack } = useMemo(() => {
-    const rows = buildTimelineLogicalRows({
-      tracks,
-      displayTrackOrder,
-      laneCounts,
-      selectedElementId,
-      selectedElementIds,
-      expandedClipIds: STUDIO_KEYFRAMES_ENABLED ? expandedClipIds : new Set(),
-      gsapAnimations,
-    });
+  const logicalRowsByTrack = useMemo(() => {
     const byTrack = new Map<number, TimelineLogicalRow[]>();
-    for (const logicalRow of rows) {
+    for (const logicalRow of logicalRows) {
       const trackRows = byTrack.get(logicalRow.physicalTrackKey) ?? [];
       trackRows.push(logicalRow);
       byTrack.set(logicalRow.physicalTrackKey, trackRows);
     }
-    return { logicalRows: rows, logicalRowsByTrack: byTrack };
-  }, [
-    displayTrackOrder,
-    expandedClipIds,
-    gsapAnimations,
-    laneCounts,
-    selectedElementId,
-    selectedElementIds,
-    tracks,
-  ]);
+    return byTrack;
+  }, [logicalRows]);
   const toggleClipExpandedTracked = (key: string) => {
     const willExpand = !expandedClipIds.has(key);
     trackStudioKeyframeLaneExpand({ expanded: willExpand });
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
index 13965cc39e..847e4be8f3 100644
--- a/packages/studio/src/player/components/TimelinePropertyLanes.tsx
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
@@ -159,6 +159,7 @@ export function TimelinePropertyLanes({
           role="group"
           aria-label={`${group} keyframes`}
           data-property-group={group}
+          data-timeline-element-id={elementId}
           data-timeline-property-lane=""
           data-timeline-lane-top={getTimelineLaneTop(laneIndex)}
           className="absolute"
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index 18bf8e694f..80cf8f1f46 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -192,6 +192,7 @@ function PropertyGroupHeaderRow({
   onTogglePropertyGroupKeyframe?: TimelineEditCallbacks["onTogglePropertyGroupKeyframe"];
   onSeek?: (time: number) => void;
 }) {
+  const elementId = expandedElement.key ?? expandedElement.id;
   const { navigation, values, label, toggleTarget } = resolveLaneHeaderState(
     lane,
     currentTime,
@@ -200,10 +201,10 @@ function PropertyGroupHeaderRow({
 
   return (
     <div
-      id={timelineLogicalRowCellId(
-        timelinePropertyRowId(expandedElement.key ?? expandedElement.id, lane.group),
-        "header",
-      )}
+      id={timelineLogicalRowCellId(timelinePropertyRowId(elementId, lane.group), "header")}
+      data-timeline-focus-id={timelinePropertyRowId(elementId, lane.group)}
+      data-timeline-element-id={elementId}
+      tabIndex={-1}
       data-property-group={lane.group}
       data-timeline-lane-top={getTimelineLaneTop(laneIndex)}
       className="absolute left-0 flex items-center gap-1 px-1.5 text-[10px] text-white/65"
diff --git a/packages/studio/src/player/components/TimelineTrackRow.tsx b/packages/studio/src/player/components/TimelineTrackRow.tsx
index bb099581bf..582db57fda 100644
--- a/packages/studio/src/player/components/TimelineTrackRow.tsx
+++ b/packages/studio/src/player/components/TimelineTrackRow.tsx
@@ -48,6 +48,8 @@ export function TimelineTrackRow({
         aria-level={logicalRow.level}
         aria-expanded={logicalRow.expandable ? logicalRow.expanded : undefined}
         data-timeline-logical-row-id={logicalRow.id}
+        data-timeline-focus-id={logicalRow.id}
+        tabIndex={-1}
         className="flex"
         style={{ height }}
       >
diff --git a/packages/studio/src/player/components/timelineKeyboardNavigation.ts b/packages/studio/src/player/components/timelineKeyboardNavigation.ts
index c86e98ee96..b2d88354be 100644
--- a/packages/studio/src/player/components/timelineKeyboardNavigation.ts
+++ b/packages/studio/src/player/components/timelineKeyboardNavigation.ts
@@ -56,6 +56,7 @@ export interface TimelineLogicalRow {
   logicalIndex: number;
   level: 1 | 2;
   parentId: string | null;
+  elementId: string | null;
   expandable: boolean;
   expanded: boolean;
   propertyGroup?: PropertyGroupName;
@@ -201,6 +202,7 @@ export function buildTimelineLogicalRows({
       logicalIndex: rows.length,
       level: 1,
       parentId: null,
+      elementId: null,
       expandable: lanes.length > 0,
       expanded,
       items: clipItems(trackId, elements),
@@ -215,6 +217,7 @@ export function buildTimelineLogicalRows({
         logicalIndex: rows.length,
         level: 2,
         parentId: trackId,
+        elementId: activeId,
         expandable: false,
         expanded: false,
         propertyGroup: lane.group,
@@ -225,7 +228,7 @@ export function buildTimelineLogicalRows({
   return rows;
 }
 
-function locateTarget(rows: readonly TimelineLogicalRow[], id: string) {
+export function locateTimelineLogicalTarget(rows: readonly TimelineLogicalRow[], id: string) {
   for (let rowIndex = 0; rowIndex < rows.length; rowIndex += 1) {
     const row = rows[rowIndex]!;
     if (row.id === id) return { row, rowIndex, itemIndex: -1, target: row };
@@ -252,7 +255,7 @@ export function resolveTimelineNavigationTarget(
   key: TimelineNavigationKey,
   options: TimelineNavigationOptions = {},
 ): TimelineLogicalTarget | null {
-  const current = locateTarget(rows, currentId);
+  const current = locateTimelineLogicalTarget(rows, currentId);
   if (!current) return null;
   const { row, rowIndex, itemIndex, target } = current;
 
@@ -289,26 +292,26 @@ export function resolveTimelineFocusFallback(
   nextRows: readonly TimelineLogicalRow[],
   currentId: string,
 ): TimelineLogicalTarget | null {
-  const unchanged = locateTarget(nextRows, currentId);
+  const unchanged = locateTimelineLogicalTarget(nextRows, currentId);
   if (unchanged) return unchanged.target;
-  const previous = locateTarget(previousRows, currentId);
+  const previous = locateTimelineLogicalTarget(previousRows, currentId);
   if (!previous) return null;
 
   if (previous.itemIndex >= 0) {
     for (let index = previous.itemIndex - 1; index >= 0; index -= 1) {
-      const candidate = locateTarget(nextRows, previous.row.items[index]!.id);
+      const candidate = locateTimelineLogicalTarget(nextRows, previous.row.items[index]!.id);
       if (candidate) return candidate.target;
     }
     for (let index = previous.itemIndex + 1; index < previous.row.items.length; index += 1) {
-      const candidate = locateTarget(nextRows, previous.row.items[index]!.id);
+      const candidate = locateTimelineLogicalTarget(nextRows, previous.row.items[index]!.id);
       if (candidate) return candidate.target;
     }
   }
 
-  const survivingRow = locateTarget(nextRows, previous.row.id);
+  const survivingRow = locateTimelineLogicalTarget(nextRows, previous.row.id);
   if (survivingRow) return survivingRow.target;
   if (previous.row.parentId) {
-    const parent = locateTarget(nextRows, previous.row.parentId);
+    const parent = locateTimelineLogicalTarget(nextRows, previous.row.parentId);
     if (parent) return parent.target;
   }
   return nextRows[previous.rowIndex] ?? nextRows[previous.rowIndex - 1] ?? null;
diff --git a/packages/studio/src/player/components/useTimelineClipRenderWindow.ts b/packages/studio/src/player/components/useTimelineClipRenderWindow.ts
index 808d02436e..b173dc2217 100644
--- a/packages/studio/src/player/components/useTimelineClipRenderWindow.ts
+++ b/packages/studio/src/player/components/useTimelineClipRenderWindow.ts
@@ -1,10 +1,7 @@
-import { useMemo, type RefObject } from "react";
+import { useMemo } from "react";
 import { createTimelineClipIndex } from "../lib/timelineClipIndex";
-import type { TimelineElement } from "../store/playerStore";
 import { getTimelineRenderTimeRange } from "./timelineViewportGeometry";
-import type { TimelineRowGeometry } from "./timelineLayout";
 import type { TimelineScrollViewportSnapshot } from "./useTimelineScrollViewport";
-import { useTimelineRevealClip } from "./useTimelineRevealClip";
 
 interface UseTimelineClipRenderWindowInput {
   tracks: Parameters<typeof createTimelineClipIndex>[0];
@@ -15,15 +12,10 @@ interface UseTimelineClipRenderWindowInput {
   selectedElementId?: string;
   draggedElementId?: string;
   resizingElementIds?: readonly string[];
-  revealElementId?: string;
+  focusedElementId?: string;
   focusedEaseElementId?: string;
   clipContextMenuElementId?: string;
   keyframeContextMenuElementId?: string;
-  scrollRef: RefObject<HTMLDivElement | null>;
-  elements: readonly TimelineElement[];
-  rowGeometry: TimelineRowGeometry;
-  allowHorizontalReveal: boolean;
-  sessionEpoch: number;
 }
 
 export function useTimelineClipRenderWindow({
@@ -35,15 +27,10 @@ export function useTimelineClipRenderWindow({
   selectedElementId,
   draggedElementId,
   resizingElementIds,
-  revealElementId,
+  focusedElementId,
   focusedEaseElementId,
   clipContextMenuElementId,
   keyframeContextMenuElementId,
-  scrollRef,
-  elements,
-  rowGeometry,
-  allowHorizontalReveal,
-  sessionEpoch,
 }: UseTimelineClipRenderWindowInput) {
   const clipIndex = useMemo(() => createTimelineClipIndex(tracks), [tracks]);
   const renderTimeRange = useMemo(
@@ -57,7 +44,7 @@ export function useTimelineClipRenderWindow({
           selectedElementId,
           draggedElementId,
           ...(resizingElementIds ?? []),
-          revealElementId,
+          focusedElementId,
           focusedEaseElementId,
           clipContextMenuElementId,
           keyframeContextMenuElementId,
@@ -69,19 +56,9 @@ export function useTimelineClipRenderWindow({
       focusedEaseElementId,
       keyframeContextMenuElementId,
       resizingElementIds,
-      revealElementId,
+      focusedElementId,
       selectedElementId,
     ],
   );
-  useTimelineRevealClip({
-    scrollRef,
-    elements,
-    rowGeometry,
-    pixelsPerSecond,
-    contentOrigin,
-    allowHorizontal: allowHorizontalReveal,
-    viewportVersion: viewport,
-    sessionEpoch,
-  });
   return { clipIndex, renderTimeRange, pinnedClipIdentities };
 }
diff --git a/packages/studio/src/player/components/useTimelineFocusCoordinator.test.tsx b/packages/studio/src/player/components/useTimelineFocusCoordinator.test.tsx
new file mode 100644
index 0000000000..b4951207fb
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineFocusCoordinator.test.tsx
@@ -0,0 +1,138 @@
+// @vitest-environment happy-dom
+
+import React, { act, useRef } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { usePlayerStore } from "../store/playerStore";
+import { createTimelineRowGeometry } from "./timelineLayout";
+import type { TimelineLogicalRow } from "./timelineKeyboardNavigation";
+import { timelineClipFocusId, timelineTrackRowId } from "./timelineNavigationIdentity";
+import { useTimelineFocusCoordinator } from "./useTimelineFocusCoordinator";
+
+Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
+
+const element = { id: "hero", tag: "div", start: 20, duration: 2, track: 1 };
+const clipId = timelineClipFocusId("hero");
+const rowId = timelineTrackRowId(1);
+const geometry = createTimelineRowGeometry([1], [48]);
+const rows: readonly TimelineLogicalRow[] = [
+  {
+    id: rowId,
+    kind: "row",
+    physicalTrackKey: 1,
+    logicalIndex: 0,
+    level: 1,
+    parentId: null,
+    elementId: null,
+    expandable: false,
+    expanded: false,
+    items: [{ id: clipId, kind: "clip", rowId, elementId: "hero", time: 21 }],
+  },
+];
+
+function Harness({
+  mountedId,
+  logicalRows = rows,
+  projectId = "project-a",
+}: {
+  mountedId?: string;
+  logicalRows?: readonly TimelineLogicalRow[];
+  projectId?: string;
+}) {
+  const scrollRef = useRef<HTMLDivElement>(null);
+  const focus = useTimelineFocusCoordinator({
+    scrollRef,
+    logicalRows,
+    elements: [element],
+    rowGeometry: geometry,
+    pixelsPerSecond: 100,
+    contentOrigin: 32,
+    allowHorizontal: true,
+    viewportVersion: logicalRows,
+    projectId,
+    sessionEpoch: 1,
+    syncScrollViewport: () => {},
+  });
+  return (
+    <div
+      ref={(node) => {
+        scrollRef.current = node;
+        if (node) {
+          Object.defineProperty(node, "clientWidth", { configurable: true, value: 300 });
+          Object.defineProperty(node, "clientHeight", { configurable: true, value: 100 });
+        }
+      }}
+      data-focus={`${focus.focusedRowKey}:${focus.pinnedElementId}`}
+    >
+      {mountedId && <div data-timeline-focus-id={mountedId} tabIndex={-1} />}
+    </div>
+  );
+}
+
+let host: HTMLDivElement;
+let root: Root;
+beforeEach(() => {
+  usePlayerStore.setState({ timelineProjectId: "project-a", timelineSessionEpoch: 1 });
+  host = document.createElement("div");
+  document.body.append(host);
+  root = createRoot(host);
+});
+afterEach(() => {
+  act(() => root.unmount());
+  usePlayerStore.getState().reset();
+  document.body.replaceChildren();
+});
+
+describe("useTimelineFocusCoordinator", () => {
+  it("pins and scrolls from model coordinates until mount, then permits repeat reveal", async () => {
+    usePlayerStore.getState().requestTimelineFocus(clipId);
+    await act(async () => root.render(<Harness />));
+    const scroll = host.firstElementChild as HTMLDivElement;
+    expect(scroll.scrollLeft).toBe(1_944);
+    expect(scroll.dataset.focus).toBe("1:hero");
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe(clipId);
+
+    await act(async () => root.render(<Harness mountedId={clipId} />));
+    const firstNonce = usePlayerStore.getState().timelineFocus?.nonce;
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe(clipId);
+    expect(document.activeElement?.getAttribute("data-timeline-focus-id")).toBe(clipId);
+
+    scroll.scrollLeft = 0;
+    await act(async () => usePlayerStore.getState().requestTimelineFocus(clipId));
+    await act(async () => root.render(<Harness mountedId={clipId} />));
+    expect(scroll.scrollLeft).toBe(1_944);
+    expect(usePlayerStore.getState().timelineFocus?.nonce).toBe((firstNonce ?? 0) + 1);
+  });
+
+  it("focuses the latest request when it replaces an unmounted request", async () => {
+    usePlayerStore.getState().requestTimelineFocus(rowId);
+    usePlayerStore.getState().requestTimelineFocus(clipId);
+
+    await act(async () => root.render(<Harness mountedId={clipId} />));
+    expect(document.activeElement?.getAttribute("data-timeline-focus-id")).toBe(clipId);
+  });
+
+  it("ignores stale scope and never queries outside its own viewport", async () => {
+    usePlayerStore.getState().requestTimelineFocus(clipId);
+    await act(async () => root.render(<Harness mountedId={clipId} projectId="project-b" />));
+    expect(document.activeElement).not.toBe(host.querySelector("[data-timeline-focus-id]"));
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe(clipId);
+
+    const externalTarget = document.createElement("div");
+    externalTarget.dataset.timelineFocusId = clipId;
+    externalTarget.tabIndex = -1;
+    document.body.append(externalTarget);
+    await act(async () => root.render(<Harness />));
+    expect(document.activeElement).not.toBe(externalTarget);
+  });
+
+  it("persists a deterministic parent-row fallback when a focused clip disappears", async () => {
+    usePlayerStore.getState().requestTimelineFocus(clipId);
+    await act(async () => root.render(<Harness />));
+
+    const collapsedRows: readonly TimelineLogicalRow[] = [{ ...rows[0]!, items: [] }];
+    await act(async () => root.render(<Harness logicalRows={collapsedRows} mountedId={rowId} />));
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe(rowId);
+    expect(document.activeElement?.getAttribute("data-timeline-focus-id")).toBe(rowId);
+  });
+});
diff --git a/packages/studio/src/player/components/useTimelineFocusCoordinator.ts b/packages/studio/src/player/components/useTimelineFocusCoordinator.ts
new file mode 100644
index 0000000000..b8141e871e
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineFocusCoordinator.ts
@@ -0,0 +1,211 @@
+import { useEffect, useLayoutEffect, useRef, type RefObject } from "react";
+import type { TimelineElement } from "../store/playerStore";
+import { usePlayerStore } from "../store/playerStore";
+import type { TimelineFocusRequest } from "../store/timelineFocusState";
+import type { TimelineRowGeometry } from "./timelineLayout";
+import { CLIP_Y, RULER_H } from "./timelineLayout";
+import {
+  locateTimelineLogicalTarget,
+  resolveTimelineFocusFallback,
+  type TimelineLogicalRow,
+  type TimelineLogicalTarget,
+} from "./timelineKeyboardNavigation";
+import { computeRevealScroll } from "./timelineRevealScroll";
+
+interface TimelineFocusCoordinatorInput {
+  scrollRef: RefObject<HTMLDivElement | null>;
+  logicalRows: readonly TimelineLogicalRow[];
+  elements: readonly TimelineElement[];
+  rowGeometry: TimelineRowGeometry;
+  pixelsPerSecond: number;
+  contentOrigin: number;
+  allowHorizontal: boolean;
+  viewportVersion: unknown;
+  projectId: string | null;
+  sessionEpoch: number;
+  syncScrollViewport: (element: HTMLDivElement) => void;
+}
+
+export interface TimelineFocusCoordinatorState {
+  focusedTargetId: string | null;
+  focusedRowKey: number | undefined;
+  pinnedElementId: string | undefined;
+}
+
+interface ResolvedFocus {
+  target: TimelineLogicalTarget;
+  row: TimelineLogicalRow;
+}
+
+function isCurrentRequest(
+  request: TimelineFocusRequest | null,
+  projectId: string | null,
+  sessionEpoch: number,
+): request is TimelineFocusRequest {
+  return (
+    request !== null && request.projectId === projectId && request.sessionEpoch === sessionEpoch
+  );
+}
+
+function focusElement(container: HTMLDivElement, targetId: string): boolean {
+  const target = [...container.querySelectorAll<HTMLElement>("[data-timeline-focus-id]")].find(
+    (candidate) => candidate.dataset.timelineFocusId === targetId,
+  );
+  if (!target) return false;
+  if (target.ownerDocument.activeElement === target) return true;
+  target.setAttribute("data-reveal-highlight", "true");
+  target.focus({ preventScroll: true });
+  if (target.ownerDocument.activeElement !== target) {
+    target.removeAttribute("data-reveal-highlight");
+    return false;
+  }
+  target.addEventListener("blur", () => target.removeAttribute("data-reveal-highlight"), {
+    once: true,
+  });
+  return true;
+}
+
+function scrollToTarget(
+  container: HTMLDivElement,
+  resolution: ResolvedFocus,
+  elements: readonly TimelineElement[],
+  rowGeometry: TimelineRowGeometry,
+  pixelsPerSecond: number,
+  contentOrigin: number,
+  allowHorizontal: boolean,
+): boolean {
+  const rowIndex = rowGeometry.getRowIndex(resolution.row.physicalTrackKey);
+  if (rowIndex < 0) return false;
+  const elementId =
+    resolution.target.kind === "row" ? resolution.row.elementId : resolution.target.elementId;
+  const element = elementId
+    ? elements.find((candidate) => (candidate.key ?? candidate.id) === elementId)
+    : undefined;
+  const pointTime = resolution.target.kind === "row" ? null : resolution.target.time;
+  const left = element && resolution.target.kind === "clip" ? element.start : pointTime;
+  const right =
+    element && resolution.target.kind === "clip" ? element.start + element.duration : pointTime;
+  const rowTop = rowGeometry.getRowTop(rowIndex);
+  const target = computeRevealScroll({
+    scrollLeft: container.scrollLeft,
+    scrollTop: container.scrollTop,
+    viewportWidth: container.clientWidth,
+    viewportHeight: container.clientHeight,
+    clipLeft: contentOrigin + (left ?? 0) * pixelsPerSecond,
+    clipRight: contentOrigin + (right ?? 0) * pixelsPerSecond,
+    clipTop: rowTop + CLIP_Y,
+    clipBottom: rowTop + rowGeometry.getRowHeight(rowIndex) - CLIP_Y,
+    stickyLeft: contentOrigin,
+    stickyTop: RULER_H,
+    allowHorizontal: allowHorizontal && left !== null,
+  });
+  if (target.left !== null) container.scrollLeft = target.left;
+  if (target.top !== null) container.scrollTop = target.top;
+  return target.left !== null || target.top !== null;
+}
+
+/** Model-first focus actor; mounting is a consequence of its returned pins. */
+export function useTimelineFocusCoordinator({
+  scrollRef,
+  logicalRows,
+  elements,
+  rowGeometry,
+  pixelsPerSecond,
+  contentOrigin,
+  allowHorizontal,
+  viewportVersion,
+  projectId,
+  sessionEpoch,
+  syncScrollViewport,
+}: TimelineFocusCoordinatorInput): TimelineFocusCoordinatorState {
+  const request = usePlayerStore((state) => state.timelineFocus);
+  const previousRowsRef = useRef(logicalRows);
+  const resolvedRef = useRef<{ nonce: number; id: string } | null>(null);
+  const appliedRef = useRef<{ nonce: number; id: string } | null>(null);
+  let resolution: ResolvedFocus | null = null;
+
+  if (isCurrentRequest(request, projectId, sessionEpoch)) {
+    if (resolvedRef.current?.nonce !== request.nonce) {
+      resolvedRef.current = { nonce: request.nonce, id: request.id };
+    }
+    const resolvedId = resolvedRef.current.id;
+    let located = locateTimelineLogicalTarget(logicalRows, resolvedId);
+    if (!located) {
+      const fallback = resolveTimelineFocusFallback(
+        previousRowsRef.current,
+        logicalRows,
+        resolvedId,
+      );
+      if (fallback) {
+        resolvedRef.current = { nonce: request.nonce, id: fallback.id };
+        located = locateTimelineLogicalTarget(logicalRows, fallback.id);
+      }
+    }
+    if (located) resolution = { target: located.target, row: located.row };
+  } else {
+    resolvedRef.current = null;
+  }
+
+  useLayoutEffect(() => {
+    previousRowsRef.current = logicalRows;
+  }, [logicalRows]);
+
+  useEffect(() => {
+    if (!isCurrentRequest(request, projectId, sessionEpoch)) return;
+    if (!resolution) {
+      usePlayerStore.getState().clearTimelineFocus(request.nonce);
+      return;
+    }
+    if (resolution.target.id !== request.id) {
+      usePlayerStore.getState().requestTimelineFocus(resolution.target.id);
+      return;
+    }
+    if (
+      appliedRef.current?.nonce === request.nonce &&
+      appliedRef.current.id === resolution.target.id
+    ) {
+      return;
+    }
+    const container = scrollRef.current;
+    if (!container) return;
+    if (
+      scrollToTarget(
+        container,
+        resolution,
+        elements,
+        rowGeometry,
+        pixelsPerSecond,
+        contentOrigin,
+        allowHorizontal,
+      )
+    ) {
+      syncScrollViewport(container);
+    }
+    if (!focusElement(container, resolution.target.id)) return;
+    appliedRef.current = { nonce: request.nonce, id: resolution.target.id };
+  }, [
+    allowHorizontal,
+    contentOrigin,
+    elements,
+    pixelsPerSecond,
+    projectId,
+    request,
+    resolution,
+    rowGeometry,
+    scrollRef,
+    sessionEpoch,
+    syncScrollViewport,
+    viewportVersion,
+  ]);
+
+  const pinnedElementId = resolution
+    ? resolution.target.kind === "row"
+      ? (resolution.row.elementId ?? undefined)
+      : resolution.target.elementId
+    : undefined;
+  return {
+    focusedTargetId: resolution?.target.id ?? null,
+    focusedRowKey: resolution?.row.physicalTrackKey,
+    pinnedElementId,
+  };
+}
diff --git a/packages/studio/src/player/components/useTimelineLogicalFocus.ts b/packages/studio/src/player/components/useTimelineLogicalFocus.ts
new file mode 100644
index 0000000000..0bdc489ecb
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineLogicalFocus.ts
@@ -0,0 +1,92 @@
+import { useMemo, type RefObject } from "react";
+import type { GsapAnimation } from "@hyperframes/core/gsap-parser";
+import type { TimelineElement } from "../store/playerStore";
+import type { TimelineRowGeometry } from "./timelineLayout";
+import { buildTimelineLogicalRows } from "./timelineKeyboardNavigation";
+import type { TimelineScrollViewportSnapshot } from "./useTimelineScrollViewport";
+import { useTimelineFocusCoordinator } from "./useTimelineFocusCoordinator";
+import { usePlayerStore } from "../store/playerStore";
+import { STUDIO_KEYFRAMES_ENABLED } from "../../components/editor/manualEditingAvailability";
+import { useTimelineRowVirtualization } from "./useTimelineRowVirtualization";
+
+interface TimelineLogicalFocusInput {
+  scrollRef: RefObject<HTMLDivElement | null>;
+  tracks: readonly (readonly [number, readonly TimelineElement[]])[];
+  layout: { displayTrackOrder: readonly number[]; rowGeometry: TimelineRowGeometry };
+  laneCounts: ReadonlyMap<string, number>;
+  selectedElementId: string | null;
+  selectedElementIds: ReadonlySet<string>;
+  gsapAnimations: ReadonlyMap<string, readonly GsapAnimation[]>;
+  elements: readonly TimelineElement[];
+  pixelsPerSecond: number;
+  contentOrigin: number;
+  allowHorizontal: boolean;
+  viewport: TimelineScrollViewportSnapshot;
+  sessionEpoch: number;
+  draggedRowKey?: number;
+  resizingRowKey?: number;
+  clipContextMenuRowKey?: number;
+  keyframeContextMenuRowKey?: number;
+  lastScrollLeftRef: RefObject<number>;
+  syncScrollViewport: (element: HTMLDivElement) => void;
+}
+
+export function useTimelineLogicalFocus(input: TimelineLogicalFocusInput) {
+  const expandedClipIds = usePlayerStore((state) => state.expandedClipIds);
+  const projectId = usePlayerStore((state) => state.timelineProjectId);
+  const logicalRows = useMemo(
+    () =>
+      buildTimelineLogicalRows({
+        tracks: input.tracks,
+        displayTrackOrder: input.layout.displayTrackOrder,
+        laneCounts: input.laneCounts,
+        selectedElementId: input.selectedElementId,
+        selectedElementIds: input.selectedElementIds,
+        expandedClipIds: STUDIO_KEYFRAMES_ENABLED ? expandedClipIds : new Set(),
+        gsapAnimations: input.gsapAnimations,
+      }),
+    [
+      expandedClipIds,
+      input.gsapAnimations,
+      input.laneCounts,
+      input.selectedElementId,
+      input.selectedElementIds,
+      input.tracks,
+      input.layout.displayTrackOrder,
+    ],
+  );
+  const focus = useTimelineFocusCoordinator({
+    scrollRef: input.scrollRef,
+    logicalRows,
+    elements: input.elements,
+    rowGeometry: input.layout.rowGeometry,
+    pixelsPerSecond: input.pixelsPerSecond,
+    contentOrigin: input.contentOrigin,
+    allowHorizontal: input.allowHorizontal,
+    viewportVersion: input.viewport,
+    projectId,
+    sessionEpoch: input.sessionEpoch,
+    syncScrollViewport: input.syncScrollViewport,
+  });
+  const rows = useTimelineRowVirtualization({
+    scrollRef: input.scrollRef,
+    viewport: input.viewport,
+    rowGeometry: input.layout.rowGeometry,
+    sessionEpoch: input.sessionEpoch,
+    elements: input.elements,
+    selectedElementId: input.selectedElementId,
+    focusedRowKey: focus.focusedRowKey,
+    draggedRowKey: input.draggedRowKey,
+    resizingRowKey: input.resizingRowKey,
+    clipContextMenuRowKey: input.clipContextMenuRowKey,
+    keyframeContextMenuRowKey: input.keyframeContextMenuRowKey,
+    lastScrollLeftRef: input.lastScrollLeftRef,
+    syncScrollViewport: input.syncScrollViewport,
+  });
+  return {
+    logicalRows,
+    ...focus,
+    rowVirtualizationActive: rows.enabled,
+    virtualRows: rows.virtualRows,
+  };
+}
diff --git a/packages/studio/src/player/components/useTimelineRevealClip.test.tsx b/packages/studio/src/player/components/useTimelineRevealClip.test.tsx
deleted file mode 100644
index 43b812d3be..0000000000
--- a/packages/studio/src/player/components/useTimelineRevealClip.test.tsx
+++ /dev/null
@@ -1,87 +0,0 @@
-// @vitest-environment happy-dom
-
-import React, { act, useRef } from "react";
-import { createRoot } from "react-dom/client";
-import { afterEach, describe, expect, it } from "vitest";
-import type { TimelineElement } from "../store/playerStore";
-import { usePlayerStore } from "../store/playerStore";
-import { createTimelineRowGeometry } from "./timelineLayout";
-import { useTimelineRevealClip } from "./useTimelineRevealClip";
-
-Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
-
-const element: TimelineElement = {
-  id: "hero",
-  tag: "div",
-  start: 20,
-  duration: 2,
-  track: 1,
-};
-const geometry = createTimelineRowGeometry([1], [48]);
-
-function Harness({ mounted, version }: { mounted: boolean; version: number }) {
-  const scrollRef = useRef<HTMLDivElement>(null);
-  useTimelineRevealClip({
-    scrollRef,
-    elements: [element],
-    rowGeometry: geometry,
-    pixelsPerSecond: 100,
-    contentOrigin: 32,
-    allowHorizontal: true,
-    viewportVersion: version,
-    sessionEpoch: 1,
-  });
-  return (
-    <div
-      ref={(node) => {
-        scrollRef.current = node;
-        if (node) {
-          Object.defineProperty(node, "clientWidth", { configurable: true, value: 300 });
-          Object.defineProperty(node, "clientHeight", { configurable: true, value: 100 });
-        }
-      }}
-    >
-      {mounted && <div data-el-id="hero" tabIndex={-1} />}
-    </div>
-  );
-}
-
-afterEach(() => {
-  usePlayerStore.getState().reset();
-  document.body.replaceChildren();
-});
-
-describe("useTimelineRevealClip", () => {
-  it("scrolls from model coordinates, then consumes only after the clip mounts", async () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    const root = createRoot(host);
-    usePlayerStore.getState().requestClipReveal("hero");
-
-    await act(async () => root.render(<Harness mounted={false} version={0} />));
-    const scroll = host.firstElementChild as HTMLDivElement;
-    expect(scroll.scrollLeft).toBe(1_944);
-    expect(usePlayerStore.getState().clipRevealRequest?.elementId).toBe("hero");
-
-    await act(async () => root.render(<Harness mounted version={1} />));
-    expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
-    expect(document.activeElement?.getAttribute("data-el-id")).toBe("hero");
-
-    scroll.scrollLeft = 0;
-    await act(async () => usePlayerStore.getState().requestClipReveal("hero"));
-    await act(async () => root.render(<Harness mounted version={2} />));
-    expect(scroll.scrollLeft).toBe(1_944);
-    expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
-    await act(async () => root.unmount());
-  });
-
-  it("consumes an invalid target without scrolling", async () => {
-    const host = document.createElement("div");
-    document.body.append(host);
-    const root = createRoot(host);
-    usePlayerStore.getState().requestClipReveal("missing");
-    await act(async () => root.render(<Harness mounted={false} version={0} />));
-    expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
-    await act(async () => root.unmount());
-  });
-});
diff --git a/packages/studio/src/player/components/useTimelineRevealClip.ts b/packages/studio/src/player/components/useTimelineRevealClip.ts
deleted file mode 100644
index b507c15047..0000000000
--- a/packages/studio/src/player/components/useTimelineRevealClip.ts
+++ /dev/null
@@ -1,144 +0,0 @@
-import { useEffect, useRef } from "react";
-import type { TimelineElement } from "../store/playerStore";
-import { usePlayerStore } from "../store/playerStore";
-import { CLIP_Y, RULER_H, type TimelineRowGeometry } from "./timelineLayout";
-import { computeRevealScroll } from "./timelineRevealScroll";
-
-interface UseTimelineRevealClipInput {
-  scrollRef: React.RefObject<HTMLDivElement | null>;
-  elements: readonly TimelineElement[];
-  rowGeometry: TimelineRowGeometry;
-  pixelsPerSecond: number;
-  contentOrigin: number;
-  allowHorizontal: boolean;
-  viewportVersion: unknown;
-  sessionEpoch: number;
-}
-
-function escapeSelectorValue(value: string): string {
-  return typeof CSS !== "undefined" && typeof CSS.escape === "function"
-    ? CSS.escape(value)
-    : value.replace(/["\\]/g, "\\$&");
-}
-
-function scrollToTimelineElement(
-  container: HTMLDivElement,
-  element: TimelineElement,
-  row: number,
-  rowGeometry: TimelineRowGeometry,
-  pixelsPerSecond: number,
-  contentOrigin: number,
-  allowHorizontal: boolean,
-): void {
-  const clipLeft = contentOrigin + element.start * pixelsPerSecond;
-  const target = computeRevealScroll({
-    scrollLeft: container.scrollLeft,
-    scrollTop: container.scrollTop,
-    viewportWidth: container.clientWidth,
-    viewportHeight: container.clientHeight,
-    clipLeft,
-    clipRight: clipLeft + Math.max(element.duration * pixelsPerSecond, 4),
-    clipTop: rowGeometry.getRowTop(row) + CLIP_Y,
-    clipBottom: rowGeometry.getRowTop(row) + rowGeometry.getRowHeight(row) - CLIP_Y,
-    stickyLeft: contentOrigin,
-    stickyTop: RULER_H,
-    allowHorizontal,
-  });
-  if (target.left !== null) container.scrollLeft = target.left;
-  if (target.top !== null) container.scrollTop = target.top;
-  if (target.left !== null || target.top !== null) container.dispatchEvent(new Event("scroll"));
-}
-
-function focusRevealedElement(container: HTMLDivElement, elementId: string): boolean {
-  const clip = container.querySelector(`[data-el-id="${escapeSelectorValue(elementId)}"]`);
-  if (!(clip instanceof HTMLElement)) return false;
-  clip.setAttribute("data-reveal-highlight", "true");
-  clip.focus({ preventScroll: true });
-  if (document.activeElement !== clip) {
-    clip.removeAttribute("data-reveal-highlight");
-    return false;
-  }
-  clip.addEventListener("blur", () => clip.removeAttribute("data-reveal-highlight"), {
-    once: true,
-  });
-  return true;
-}
-
-function resolveRevealTarget(
-  elements: readonly TimelineElement[],
-  rowGeometry: TimelineRowGeometry,
-  elementId: string,
-): { element: TimelineElement; row: number } | null {
-  const element = elements.find((candidate) => (candidate.key ?? candidate.id) === elementId);
-  if (!element) return null;
-  const row = rowGeometry.getRowIndex(element.track);
-  return row < 0 ? null : { element, row };
-}
-
-function shouldScrollReveal(
-  previous: { request: { elementId: string; nonce: number }; sessionEpoch: number } | null,
-  request: { elementId: string; nonce: number },
-  sessionEpoch: number,
-): boolean {
-  return previous?.request !== request || previous.sessionEpoch !== sessionEpoch;
-}
-
-/** Coordinate-first reveal; the request remains pinned until its clip mounts. */
-export function useTimelineRevealClip({
-  scrollRef,
-  elements,
-  rowGeometry,
-  pixelsPerSecond,
-  contentOrigin,
-  allowHorizontal,
-  viewportVersion,
-  sessionEpoch,
-}: UseTimelineRevealClipInput): void {
-  const revealRequest = usePlayerStore((state) => state.clipRevealRequest);
-  const scrolledRequestRef = useRef<{
-    request: { elementId: string; nonce: number };
-    sessionEpoch: number;
-  } | null>(null);
-
-  useEffect(() => {
-    if (!revealRequest) {
-      scrolledRequestRef.current = null;
-      return;
-    }
-    const target = resolveRevealTarget(elements, rowGeometry, revealRequest.elementId);
-    if (!target) {
-      usePlayerStore.getState().clearClipRevealRequest();
-      return;
-    }
-    const container = scrollRef.current;
-    if (!container) return;
-
-    if (shouldScrollReveal(scrolledRequestRef.current, revealRequest, sessionEpoch)) {
-      scrolledRequestRef.current = { request: revealRequest, sessionEpoch };
-      scrollToTimelineElement(
-        container,
-        target.element,
-        target.row,
-        rowGeometry,
-        pixelsPerSecond,
-        contentOrigin,
-        allowHorizontal,
-      );
-    }
-
-    if (!focusRevealedElement(container, revealRequest.elementId)) return;
-    if (usePlayerStore.getState().clipRevealRequest === revealRequest) {
-      usePlayerStore.getState().clearClipRevealRequest();
-    }
-  }, [
-    allowHorizontal,
-    contentOrigin,
-    elements,
-    pixelsPerSecond,
-    revealRequest,
-    rowGeometry,
-    scrollRef,
-    sessionEpoch,
-    viewportVersion,
-  ]);
-}
diff --git a/packages/studio/src/player/components/useTimelineRowVirtualization.ts b/packages/studio/src/player/components/useTimelineRowVirtualization.ts
index 5bebda0861..cae1cf0f64 100644
--- a/packages/studio/src/player/components/useTimelineRowVirtualization.ts
+++ b/packages/studio/src/player/components/useTimelineRowVirtualization.ts
@@ -14,9 +14,9 @@ interface UseTimelineRowVirtualizationInput {
   viewport: TimelineScrollViewportSnapshot;
   rowGeometry: TimelineRowGeometry;
   sessionEpoch: number;
-  elements: TimelineElement[];
+  elements: readonly TimelineElement[];
   selectedElementId: string | null;
-  revealElementId: string | null;
+  focusedRowKey?: number;
   draggedRowKey?: number;
   resizingRowKey?: number;
   clipContextMenuRowKey?: number;
@@ -40,7 +40,7 @@ export function useTimelineRowVirtualization({
   sessionEpoch,
   elements,
   selectedElementId,
-  revealElementId,
+  focusedRowKey,
   draggedRowKey,
   resizingRowKey,
   clipContextMenuRowKey,
@@ -69,29 +69,27 @@ export function useTimelineRowVirtualization({
       scroll.removeEventListener("focusout", handleFocusOut);
     };
   }, [scrollRef, sessionEpoch]);
-  const focusIdentity = useMemo(
+  const selectedIdentity = useMemo(
     () => resolveTimelineFocusIdentity(elements, selectedElementId),
     [elements, selectedElementId],
   );
-  const revealIdentity = useMemo(
-    () => resolveTimelineFocusIdentity(elements, revealElementId),
-    [elements, revealElementId],
-  );
   const pinnedRowKeys = useMemo(
     () =>
       [
         draggedRowKey,
         resizingRowKey,
-        revealIdentity?.rowKey,
+        selectedIdentity?.rowKey,
+        focusedRowKey,
         clipContextMenuRowKey,
         keyframeContextMenuRowKey,
       ].filter((rowKey): rowKey is number => rowKey !== undefined),
     [
       clipContextMenuRowKey,
       draggedRowKey,
+      focusedRowKey,
       keyframeContextMenuRowKey,
       resizingRowKey,
-      revealIdentity,
+      selectedIdentity,
     ],
   );
   const virtualRows = useTimelineVirtualRows({
@@ -101,7 +99,7 @@ export function useTimelineRowVirtualization({
     rowGeometry,
     sessionEpoch,
     pinnedRowKeys,
-    focusedRowKey: domFocusedRowKey ?? focusIdentity?.rowKey,
+    focusedRowKey: domFocusedRowKey ?? focusedRowKey,
   });
 
   const previousLayoutRef = useRef(rowGeometry);
diff --git a/packages/studio/src/player/store/playerStore.test.ts b/packages/studio/src/player/store/playerStore.test.ts
index 8adfd77eeb..bc5d588cac 100644
--- a/packages/studio/src/player/store/playerStore.test.ts
+++ b/packages/studio/src/player/store/playerStore.test.ts
@@ -490,29 +490,36 @@ describe("usePlayerStore", () => {
     });
   });
 
-  describe("clipRevealRequest", () => {
-    it("starts null and carries the requested element id", () => {
-      expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
-      usePlayerStore.getState().requestClipReveal("el-1");
-      expect(usePlayerStore.getState().clipRevealRequest?.elementId).toBe("el-1");
-    });
-
-    it("bumps the nonce on repeat requests for the same clip", () => {
-      usePlayerStore.getState().requestClipReveal("el-1");
-      const first = usePlayerStore.getState().clipRevealRequest;
-      usePlayerStore.getState().requestClipReveal("el-1");
-      const second = usePlayerStore.getState().clipRevealRequest;
-      expect(second?.nonce).not.toBe(first?.nonce);
-    });
-
-    it("clears via clearClipRevealRequest and on reset", () => {
-      usePlayerStore.getState().requestClipReveal("el-1");
-      usePlayerStore.getState().clearClipRevealRequest();
-      expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
+  describe("timelineFocus", () => {
+    it("stamps project scope and carries the requested logical id", () => {
+      usePlayerStore.getState().beginTimelineSession("project-a");
+      usePlayerStore.getState().requestTimelineFocus("clip:el-1");
+      expect(usePlayerStore.getState().timelineFocus).toMatchObject({
+        id: "clip:el-1",
+        projectId: "project-a",
+        sessionEpoch: usePlayerStore.getState().timelineSessionEpoch,
+      });
+      const store = usePlayerStore.getState();
+      store.requestTimelineFocus("clip:el-1");
+      const first = usePlayerStore.getState().timelineFocus;
+      if (!first) throw new Error("expected timeline focus request");
+      store.clearTimelineFocus(first.nonce);
+      store.reset();
+      store.requestTimelineFocus("clip:el-1");
+      const second = usePlayerStore.getState().timelineFocus;
+      expect(second?.nonce).toBe(first.nonce + 1);
 
-      usePlayerStore.getState().requestClipReveal("el-2");
-      usePlayerStore.getState().reset();
-      expect(usePlayerStore.getState().clipRevealRequest).toBeNull();
+      store.beginTimelineSession("project-a");
+      store.requestTimelineFocus("clip:el-1");
+      const stale = usePlayerStore.getState().timelineFocus;
+      if (!stale) throw new Error("expected timeline focus request");
+      store.requestTimelineFocus("clip:el-2");
+      const replacement = usePlayerStore.getState().timelineFocus;
+      if (!replacement) throw new Error("expected replacement timeline focus request");
+      store.clearTimelineFocus(stale.nonce);
+      expect(usePlayerStore.getState().timelineFocus).toBe(replacement);
+      store.beginTimelineSession("project-b");
+      expect(usePlayerStore.getState().timelineFocus).toBeNull();
     });
   });
 
diff --git a/packages/studio/src/player/store/playerStore.ts b/packages/studio/src/player/store/playerStore.ts
index 2652859217..4809ae6b8a 100644
--- a/packages/studio/src/player/store/playerStore.ts
+++ b/packages/studio/src/player/store/playerStore.ts
@@ -5,6 +5,7 @@ import type { ClipManifestClip } from "../lib/playbackTypes";
 import { readStudioUiPreferences, writeStudioUiPreferences } from "../../utils/studioUiPreferences";
 import { computePinnedZoomPercent } from "../components/timelineZoom";
 import { createKeyframeSlice, type KeyframeSlice } from "./keyframeSlice";
+import { createTimelineFocusRequest, type TimelineFocusRequest } from "./timelineFocusState";
 
 export type { KeyframeCacheEntry } from "./keyframeSlice";
 export { liveTime } from "./liveTime";
@@ -219,15 +220,10 @@ interface PlayerState extends KeyframeSlice {
   requestSeek: (time: number) => void;
   clearSeekRequest: () => void;
 
-  /**
-   * Request the timeline to scroll a clip into view (e.g. clicking an
-   * already-added asset card in the sidebar). Consumed and cleared by
-   * useTimelineRevealClip. The nonce makes repeat requests for the same
-   * clip observable so a second click re-reveals after the user scrolls away.
-   */
-  clipRevealRequest: { elementId: string; nonce: number } | null;
-  requestClipReveal: (elementId: string) => void;
-  clearClipRevealRequest: () => void;
+  timelineFocus: TimelineFocusRequest | null;
+  timelineFocusNonce: number;
+  requestTimelineFocus: (id: string) => void;
+  clearTimelineFocus: (nonce: number) => void;
 
   lintFindingsByElement: Map<string, { count: number; messages: string[] }>;
   setLintFindingsByElement: (map: Map<string, { count: number; messages: string[] }>) => void;
@@ -295,6 +291,7 @@ function createTimelineResetState() {
     focusedEaseSegment: null,
     selectedElementIds: new Set<string>(),
     clipRevealRequest: null,
+    timelineFocus: null,
     keyframeCache: new Map(),
     gsapAnimations: new Map(),
     beatAnalysis: null,
@@ -364,12 +361,23 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
   requestSeek: (time) => set({ requestedSeekTime: time }),
   clearSeekRequest: () => set({ requestedSeekTime: null }),
 
-  clipRevealRequest: null,
-  requestClipReveal: (elementId) =>
-    set((s) => ({
-      clipRevealRequest: { elementId, nonce: (s.clipRevealRequest?.nonce ?? 0) + 1 },
-    })),
-  clearClipRevealRequest: () => set({ clipRevealRequest: null }),
+  timelineFocus: null,
+  timelineFocusNonce: 0,
+  requestTimelineFocus: (id) =>
+    set((s) => {
+      const nonce = s.timelineFocusNonce + 1;
+      return {
+        timelineFocusNonce: nonce,
+        timelineFocus: createTimelineFocusRequest(
+          id,
+          s.timelineProjectId,
+          s.timelineSessionEpoch,
+          nonce,
+        ),
+      };
+    }),
+  clearTimelineFocus: (nonce) =>
+    set((s) => (s.timelineFocus?.nonce === nonce ? { timelineFocus: null } : s)),
 
   lintFindingsByElement: new Map(),
   setLintFindingsByElement: (map) => set({ lintFindingsByElement: map }),
diff --git a/packages/studio/src/player/store/timelineFocusState.ts b/packages/studio/src/player/store/timelineFocusState.ts
new file mode 100644
index 0000000000..739d5ad052
--- /dev/null
+++ b/packages/studio/src/player/store/timelineFocusState.ts
@@ -0,0 +1,15 @@
+export interface TimelineFocusRequest {
+  id: string;
+  projectId: string | null;
+  sessionEpoch: number;
+  nonce: number;
+}
+
+export function createTimelineFocusRequest(
+  id: string,
+  projectId: string | null,
+  sessionEpoch: number,
+  nonce: number,
+): TimelineFocusRequest {
+  return { id, projectId, sessionEpoch, nonce };
+}

From ef7ffbed89a8156a12f6dca8f3491aad86c7bf87 Mon Sep 17 00:00:00 2001
From: Miguel Angel Simon Sierra <miguel.sierra@heygen.com>
Date: Mon, 20 Jul 2026 21:43:36 +0200
Subject: [PATCH 124/125] feat(studio): add timeline keyboard controls

---
 .../player/components/LayerDisclosureRow.tsx  |   1 +
 .../studio/src/player/components/Timeline.tsx |   4 +-
 .../Timeline.virtualization.test.tsx          |   2 +
 .../player/components/TimelineClip.test.tsx   |  19 +-
 .../src/player/components/TimelineClip.tsx    |  16 +-
 .../components/TimelineClipDiamonds.test.tsx  | 104 ++++++++++-
 .../components/TimelineClipDiamonds.tsx       |  74 ++++++--
 .../components/TimelineDiamondConnectors.tsx  |  17 +-
 .../player/components/TimelineLaneTypes.ts    |   1 +
 .../src/player/components/TimelineLanes.tsx   | 104 +++++++----
 .../components/TimelinePropertyLanes.test.tsx |   2 +-
 .../components/TimelinePropertyLanes.tsx      |   5 +
 .../player/components/TimelineTrackHeader.tsx |   7 +-
 .../player/components/TimelineTrackRow.tsx    |   4 +-
 .../player/components/timelineDiamondTypes.ts |  11 +-
 .../components/timelineKeyboardNavigation.ts  |   2 +-
 .../useTimelineKeyboardActor.test.tsx         | 166 ++++++++++++++++++
 .../components/useTimelineKeyboardActor.ts    | 109 ++++++++++++
 18 files changed, 569 insertions(+), 79 deletions(-)
 create mode 100644 packages/studio/src/player/components/useTimelineKeyboardActor.test.tsx
 create mode 100644 packages/studio/src/player/components/useTimelineKeyboardActor.ts

diff --git a/packages/studio/src/player/components/LayerDisclosureRow.tsx b/packages/studio/src/player/components/LayerDisclosureRow.tsx
index 596abd197d..6c9410f66e 100644
--- a/packages/studio/src/player/components/LayerDisclosureRow.tsx
+++ b/packages/studio/src/player/components/LayerDisclosureRow.tsx
@@ -34,6 +34,7 @@ export function LayerDisclosureRow({
     >
       <button
         type="button"
+        tabIndex={-1}
         aria-expanded={isExpanded}
         aria-label={`${isExpanded ? "Collapse" : "Expand"} ${name} keyframes`}
         title={`${isExpanded ? "Collapse" : "Expand"} keyframe lanes`}
diff --git a/packages/studio/src/player/components/Timeline.tsx b/packages/studio/src/player/components/Timeline.tsx
index 81dcddbc8f..423e77ed02 100644
--- a/packages/studio/src/player/components/Timeline.tsx
+++ b/packages/studio/src/player/components/Timeline.tsx
@@ -294,7 +294,7 @@ export const Timeline = memo(function Timeline({
       lastScrollLeftRef,
       contentOrigin,
     });
-  const { logicalRows, pinnedElementId, rowVirtualizationActive, virtualRows } =
+  const { logicalRows, focusedTargetId, pinnedElementId, rowVirtualizationActive, virtualRows } =
     useTimelineLogicalFocus({
       scrollRef,
       tracks,
@@ -479,7 +479,6 @@ export const Timeline = memo(function Timeline({
         onDragLeave={assetDrop.handleAssetDragLeave}
         onDrop={assetDrop.handleAssetDrop}
         onPointerDown={(e) => {
-          // Interactive controls own their clicks; scrubbing would preventDefault and eat them.
           if (e.target instanceof Element && e.target.closest("button, input, select, a")) return;
           if (splitAllAtPointer(e)) return;
           handlePointerDown(e);
@@ -508,6 +507,7 @@ export const Timeline = memo(function Timeline({
           rowGeometry={displayLayout.rowGeometry}
           virtualRows={virtualRows}
           logicalRows={logicalRows}
+          focusedTargetId={focusedTargetId}
           rowsVirtualized={rowVirtualizationActive}
           clipIndex={clipIndex}
           renderTimeRange={renderTimeRange}
diff --git a/packages/studio/src/player/components/Timeline.virtualization.test.tsx b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
index 230e118a50..6bbd36e775 100644
--- a/packages/studio/src/player/components/Timeline.virtualization.test.tsx
+++ b/packages/studio/src/player/components/Timeline.virtualization.test.tsx
@@ -159,6 +159,8 @@ describe("Timeline row virtualization", { timeout: 30_000 }, () => {
     expect(rows.length).toBeLessThanOrEqual(16);
     expect(rows[0]?.getAttribute("aria-rowindex")).toBe("1");
     expect(treegrid?.getAttribute("aria-rowcount")).toBe("1000");
+    expect(treegrid?.hasAttribute("aria-multiselectable")).toBe(false);
+    expect(treegrid?.querySelectorAll('[data-timeline-focus-id][tabindex="0"]')).toHaveLength(1);
     expect(treegrid?.parentElement?.style.height).toBe(
       `${getTimelineCanvasHeight(Array.from({ length: 1_000 }, () => TRACK_H))}px`,
     );
diff --git a/packages/studio/src/player/components/TimelineClip.test.tsx b/packages/studio/src/player/components/TimelineClip.test.tsx
index 0ec5c6340a..c5c0ec5be4 100644
--- a/packages/studio/src/player/components/TimelineClip.test.tsx
+++ b/packages/studio/src/player/components/TimelineClip.test.tsx
@@ -36,6 +36,7 @@ function renderClip({
   const host = document.createElement("div");
   document.body.append(host);
   const root = createRoot(host);
+  const onClick = vi.fn();
 
   act(() => {
     root.render(
@@ -50,7 +51,7 @@ function renderClip({
         isComposition={false}
         onHoverStart={vi.fn()}
         onHoverEnd={vi.fn()}
-        onClick={vi.fn()}
+        onClick={onClick}
         onDoubleClick={vi.fn()}
       >
         <div data-custom-content="true" />
@@ -58,7 +59,7 @@ function renderClip({
     );
   });
 
-  return { host, root };
+  return { host, onClick, root };
 }
 
 describe("TimelineClip", () => {
@@ -113,4 +114,18 @@ describe("TimelineClip", () => {
 
     act(() => root.unmount());
   });
+
+  it("is a roving native button with explicit selection semantics", () => {
+    const { host, onClick, root } = renderClip({
+      element: { id: "hero", label: "Hero", tag: "div", start: 1, duration: 2, track: 0 },
+      isSelected: true,
+    });
+    const clip = host.querySelector<HTMLButtonElement>(".timeline-clip")!;
+    expect(clip.type).toBe("button");
+    expect(clip.tabIndex).toBe(-1);
+    expect(clip.getAttribute("aria-pressed")).toBe("true");
+    act(() => clip.click());
+    expect(onClick).toHaveBeenCalledOnce();
+    act(() => root.unmount());
+  });
 });
diff --git a/packages/studio/src/player/components/TimelineClip.tsx b/packages/studio/src/player/components/TimelineClip.tsx
index 5ad9cedbe4..b8279c3823 100644
--- a/packages/studio/src/player/components/TimelineClip.tsx
+++ b/packages/studio/src/player/components/TimelineClip.tsx
@@ -19,6 +19,7 @@ interface TimelineClipProps {
   capabilities: TimelineEditCapabilities;
   theme?: TimelineTheme;
   isComposition: boolean;
+  tabIndex?: 0 | -1;
   onHoverStart: () => void;
   onHoverEnd: () => void;
   onPointerDown?: (e: React.PointerEvent) => void;
@@ -44,6 +45,7 @@ export const TimelineClip = memo(function TimelineClip({
   capabilities,
   theme = defaultTimelineTheme,
   isComposition,
+  tabIndex = -1,
   onHoverStart,
   onHoverEnd,
   onPointerDown,
@@ -83,11 +85,17 @@ export const TimelineClip = memo(function TimelineClip({
     zIndex: isDragging ? 20 : isSelected ? 10 : isHovered ? 5 : 1,
     // Regular cursor over clips (CapCut-style, user preference) — no grab hand.
     cursor: "default",
+    appearance: "none",
+    color: "inherit",
+    font: "inherit",
+    padding: 0,
+    textAlign: "left",
     transform: isDragging ? "translateY(-1px)" : undefined,
   };
 
   return (
-    <div
+    <button
+      type="button"
       data-clip={isGestureActor ? undefined : "true"}
       data-el-id={isGestureActor ? undefined : (el.key ?? el.id)}
       data-timeline-focus-id={isGestureActor ? undefined : timelineClipFocusId(el.key ?? el.id)}
@@ -96,7 +104,9 @@ export const TimelineClip = memo(function TimelineClip({
       data-clip-hidden={el.hidden ? "true" : undefined}
       data-active={isActive ? "" : undefined}
       aria-hidden={isGestureActor ? "true" : undefined}
-      tabIndex={isGestureActor ? undefined : -1}
+      tabIndex={isGestureActor ? undefined : tabIndex}
+      aria-label={`${displayLabel}, ${startLabel} to ${endLabel} seconds`}
+      aria-pressed={isGestureActor ? undefined : isSelected}
       className={clipClassName}
       style={style}
       title={
@@ -178,6 +188,6 @@ export const TimelineClip = memo(function TimelineClip({
         </span>
       )}
       {children}
-    </div>
+    </button>
   );
 });
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
index ec56aedde9..0badf5b1b6 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.test.tsx
@@ -40,7 +40,7 @@ function createTimelineHost() {
   return host;
 }
 
-function renderDiamonds(onClickKeyframe = vi.fn()) {
+function renderDiamonds(onClickKeyframe = vi.fn(), onShiftClickKeyframe = vi.fn()) {
   const host = createTimelineHost();
   const root = createRoot(host);
   act(() => {
@@ -59,14 +59,56 @@ function renderDiamonds(onClickKeyframe = vi.fn()) {
         isSelected
         currentPercentage={0}
         elementId="clip-1"
+        clipStart={10}
+        clipDuration={10}
         selectedKeyframes={new Set()}
         onClickKeyframe={onClickKeyframe}
+        onShiftClickKeyframe={onShiftClickKeyframe}
       />,
     );
   });
-  return { host, root, onClickKeyframe };
+  return { host, root, onClickKeyframe, onShiftClickKeyframe };
 }
 
+it("pins authored keyframes outside the clip to an inspectable boundary marker", () => {
+  const host = createTimelineHost();
+  const root = createRoot(host);
+  act(() => {
+    root.render(
+      <TimelineDiamondLane
+        keyframesData={{
+          format: "percentage",
+          keyframes: [
+            { percentage: -40, properties: { x: 0 }, propertyGroup: "position" },
+            { percentage: -20, properties: { x: 25 }, propertyGroup: "position" },
+            { percentage: 5, properties: { x: 50 }, propertyGroup: "position" },
+            { percentage: 120, properties: { x: 100 }, propertyGroup: "position" },
+          ],
+        }}
+        clipWidthPx={200}
+        clipHeightPx={48}
+        accentColor="#4ba3d2"
+        isSelected
+        currentPercentage={5}
+        elementId="clip-1"
+        clipStart={10}
+        clipDuration={10}
+        selectedKeyframes={new Set()}
+      />,
+    );
+  });
+
+  const before = host.querySelectorAll<HTMLButtonElement>('[data-keyframe-outside-clip="before"]');
+  const after = host.querySelector<HTMLButtonElement>('[data-keyframe-outside-clip="after"]');
+  expect(Array.from(before, (marker) => marker.style.left)).toEqual(["-35px", "-23px"]);
+  expect(before[0]?.getAttribute("aria-label")).toBe("position keyframe at 6s (before clip)");
+  expect(after?.style.left).toBe("201px");
+  expect(after?.getAttribute("aria-label")).toBe("position keyframe at 22s (after clip)");
+  expect(host.querySelectorAll('button[aria-label*="keyframe at"]')).toHaveLength(4);
+
+  act(() => root.unmount());
+});
+
 function renderRetimeLane(onMoveKeyframe = vi.fn().mockResolvedValue(true), strict = false) {
   usePlayerStore.setState({ elements: [RETIME_ELEMENT] });
   const host = createTimelineHost();
@@ -160,6 +202,33 @@ describe("TimelineClipDiamonds", () => {
     act(() => root.unmount());
   });
 
+  it("gives keyframes time-based names and native keyboard selection semantics", () => {
+    const { host, root, onClickKeyframe } = renderDiamonds();
+    const diamond = host.querySelector<HTMLButtonElement>('button[title="50%"]')!;
+    expect(diamond.getAttribute("aria-label")).toBe("Motion keyframe at 15s");
+    expect(diamond.getAttribute("aria-pressed")).toBe("false");
+    act(() => diamond.dispatchEvent(new MouseEvent("click", { bubbles: true, detail: 0 })));
+    expect(onClickKeyframe).toHaveBeenCalledWith(
+      "clip-1",
+      expect.objectContaining({ percentage: 50 }),
+    );
+    act(() => root.unmount());
+  });
+
+  it("uses Shift+Space's native click for additive keyframe selection", () => {
+    const { host, root, onClickKeyframe, onShiftClickKeyframe } = renderDiamonds();
+    const diamond = host.querySelector<HTMLButtonElement>('button[title="50%"]')!;
+    act(() =>
+      diamond.dispatchEvent(new MouseEvent("click", { bubbles: true, detail: 0, shiftKey: true })),
+    );
+    expect(onShiftClickKeyframe).toHaveBeenCalledWith(
+      "clip-1",
+      expect.objectContaining({ percentage: 50 }),
+    );
+    expect(onClickKeyframe).not.toHaveBeenCalled();
+    act(() => root.unmount());
+  });
+
   it("publishes retime previews after StrictMode effect replay", () => {
     const { diamond, host, root } = renderRetimeLane(undefined, true);
     const initialLeft = diamond.style.left;
@@ -755,10 +824,9 @@ describe("TimelineClipDiamonds", () => {
   // Regression: onClickKeyframe's state updates can re-render the diamond
   // button out from under the gesture before the browser auto-synthesizes the
   // "click" event that follows a button's pointerdown+pointerup. That orphaned
-  // click then bubbles to the ancestor clip's onClick, which toggles selection
-  // off whenever the clip is already selected — the state a diamond click
-  // always happens in — so every keyframe click immediately deselected its
-  // own clip. suppressClickRef lets that ancestor ignore the stray click.
+  // click then bubbles to the ancestor clip's onClick. That stray click can
+  // replace keyframe focus or collapse a marquee selection, so suppressClickRef
+  // lets the ancestor ignore it.
   it("arms suppressClickRef synchronously on a keyframe click", () => {
     const suppressClickRef = { current: false };
     const host = createTimelineHost();
@@ -796,6 +864,7 @@ describe("TimelineClipDiamonds", () => {
   const renderSegmentLane = (lastAmbiguous: boolean) => {
     const host = createTimelineHost();
     const root = createRoot(host);
+    const onSelectSegment = vi.fn();
     const kf = (percentage: number, extra: Record<string, unknown> = {}) => ({
       percentage,
       tweenPercentage: percentage,
@@ -828,13 +897,15 @@ describe("TimelineClipDiamonds", () => {
           isSelected
           currentPercentage={0}
           elementId="clip-1"
+          clipStart={10}
+          clipDuration={10}
           selectedKeyframes={new Set()}
-          onSelectSegment={vi.fn()}
+          onSelectSegment={onSelectSegment}
           groupAware
         />,
       );
     });
-    return { host, root };
+    return { host, onSelectSegment, root };
   };
 
   it("shows the inline ease button on a colliding merged segment (bulk edit)", () => {
@@ -847,8 +918,23 @@ describe("TimelineClipDiamonds", () => {
   });
 
   it("shows the inline ease button on single-animation merged segments", () => {
-    const { host, root } = renderSegmentLane(false);
+    const { host, onSelectSegment, root } = renderSegmentLane(false);
     expect(host.querySelectorAll("[data-keyframe-ease-segment]").length).toBe(2);
+    const ease = host.querySelector<HTMLButtonElement>("[data-keyframe-ease-button]")!;
+    expect(ease.getAttribute("aria-label")).toBe("Edit none easing after 10s");
+    expect(ease.classList.contains("opacity-0")).toBe(true);
+    act(() => ease.click());
+    expect(onSelectSegment).toHaveBeenCalledOnce();
+    expect(usePlayerStore.getState().requestedSeekTime).toBeNull();
+    act(() => root.unmount());
+  });
+
+  it("ends connectors at the diamond boundaries", () => {
+    const { host, root } = renderSegmentLane(false);
+    const connectors = host.querySelectorAll<HTMLElement>("[data-keyframe-connector]");
+
+    expect(Array.from(connectors, (connector) => connector.style.left)).toEqual(["11px", "111px"]);
+    expect(Array.from(connectors, (connector) => connector.style.width)).toEqual(["78px", "78px"]);
     act(() => root.unmount());
   });
 
diff --git a/packages/studio/src/player/components/TimelineClipDiamonds.tsx b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
index bb6b684fe6..99cf8d027f 100644
--- a/packages/studio/src/player/components/TimelineClipDiamonds.tsx
+++ b/packages/studio/src/player/components/TimelineClipDiamonds.tsx
@@ -8,10 +8,9 @@ import {
   readPendingTimelineKeyframeRetimes,
   type TimelineKeyframeRetimeHandle,
 } from "./useTimelineKeyframeHandlers";
+import { timelineKeyframeFocusId } from "./timelineNavigationIdentity";
 import {
   DIAMOND_RATIO,
-  KF_MAX_PCT,
-  KF_MIN_PCT,
   keyframeTarget,
   type TimelineClipDiamondsProps,
   type TimelineDiamondKeyframe,
@@ -32,6 +31,15 @@ function roundPct(percentage: number): number {
   return Math.round(percentage * 1000) / 1000;
 }
 
+/** Absolute time of a keyframe, for the screen-reader label. */
+export function keyframeTimeLabel(
+  clipStart: number,
+  clipDuration: number,
+  percentage: number,
+): string {
+  return `${Number((clipStart + (clipDuration * percentage) / 100).toFixed(2))}s`;
+}
+
 export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   keyframesData,
   clipWidthPx,
@@ -41,7 +49,10 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
   isSelected,
   currentPercentage,
   elementId,
+  clipStart = 0,
+  clipDuration = 0,
   selectedKeyframes,
+  rovingTargetId = null,
   onClickKeyframe,
   onShiftClickKeyframe,
   onContextMenuKeyframe,
@@ -99,9 +110,14 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
     ? Math.round(clipHeightPx * 0.45)
     : Math.round(LANE_H * DIAMOND_RATIO);
   const centerY = beatsActive ? BEAT_BAND_H + (clipHeightPx - BEAT_BAND_H) / 2 : clipHeightPx / 2;
-  const sorted = keyframesData.keyframes
-    .filter((kf) => kf.percentage >= KF_MIN_PCT && kf.percentage <= KF_MAX_PCT)
-    .sort((a, b) => a.percentage - b.percentage);
+  // Keyframes authored outside the element's visible clip window are parked at
+  // the boundary rather than hidden: dropping them made the lane's count
+  // disagree with its diamonds and left users unable to inspect or remove state
+  // that still affects the clip once it appears.
+  const sorted = [...keyframesData.keyframes].sort((a, b) => a.percentage - b.percentage);
+  const beforeClip = sorted.filter((keyframe) => keyframe.percentage < 0);
+  const afterClip = sorted.filter((keyframe) => keyframe.percentage > 100);
+  const boundaryStep = Math.max(6, Math.round(diamondSize * 0.55));
   // The neighbour clamp bounds a dragged diamond between its immediate siblings
   // so a retime can't reorder the tween. Siblings means "keyframes of the SAME
   // tween": a merged row interleaves several animations, and two of them
@@ -134,16 +150,30 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
       clipPcts: row.map((s) => s.clipPct),
     });
   }
-  const centerXOf = (percentage: number) =>
-    Math.max(0, Math.min(clipWidthPx, (percentage / 100) * clipWidthPx));
+  const centerXOf = (keyframe: TimelineDiamondKeyframe, percentage = keyframe.percentage) => {
+    if (percentage < 0) {
+      const rank = beforeClip.indexOf(keyframe);
+      return -(beforeClip.length - Math.max(0, rank)) * boundaryStep;
+    }
+    if (percentage > 100) {
+      const rank = afterClip.indexOf(keyframe);
+      return clipWidthPx + (Math.max(0, rank) + 1) * boundaryStep;
+    }
+    return (percentage / 100) * clipWidthPx;
+  };
   // One record per diamond, carrying its own geometry, so the connector and
   // button passes below read neighbours as values instead of index lookups.
   const markers = sorted.map((keyframe, index) => {
-    const centerX = centerXOf(keyframe.percentage);
+    const centerX = centerXOf(keyframe);
+    // Parked diamonds sit on their own boundary spacing, so the in-clip
+    // neighbour-gap shrink would only make them unreadable.
+    if (keyframe.percentage < 0 || keyframe.percentage > 100) {
+      return { keyframe, centerX, hitWidth: diamondSize, visualSize: diamondSize };
+    }
     const previous = sorted[index - 1];
     const next = sorted[index + 1];
-    const previousGap = previous ? centerX - centerXOf(previous.percentage) : Infinity;
-    const nextGap = next ? centerXOf(next.percentage) - centerX : Infinity;
+    const previousGap = previous ? centerX - centerXOf(previous) : Infinity;
+    const nextGap = next ? centerXOf(next) - centerX : Infinity;
     const nearestGap = Math.max(1, Math.min(previousGap, nextGap));
     const gapWidth = Math.min(diamondSize, nearestGap);
     return {
@@ -175,6 +205,10 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
       <TimelineDiamondConnectors
         markers={markers}
         centerY={centerY}
+        elementId={elementId}
+        clipStart={clipStart}
+        clipDuration={clipDuration}
+        rovingTargetId={rovingTargetId}
         baseColor={baseColor}
         baseOpacity={baseOpacity}
         groupAware={groupAware}
@@ -186,7 +220,9 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
       {markers.map((marker, i) => {
         const kf = marker.keyframe;
         const target = keyframeTarget(kf);
+        const focusId = timelineKeyframeFocusId(elementId, target);
         const kfKey = timelineKeyframeSelectionKey(elementId, target);
+        const boundary = kf.percentage < 0 ? "before" : kf.percentage > 100 ? "after" : null;
         // Clamp against this keyframe's own tween, not the whole merged row.
         const siblingRow = siblingRows.get(kf.animationId);
         const siblingClipPcts = siblingRow?.clipPcts ?? [];
@@ -198,7 +234,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
         // The 0% diamond's left half lands in the reserved left gutter (the
         // content origin is inset past the label column, Figma-style) so it stays
         // fully visible instead of being clipped by the sticky label column.
-        const leftPx = (renderPct / 100) * clipWidthPx - marker.hitWidth / 2;
+        const leftPx = centerXOf(kf, renderPct) - marker.hitWidth / 2;
         const isKfSelected = selectedKeyframes.has(kfKey);
         const atPlayhead = isSelected && Math.abs(kf.percentage - currentPercentage) < 0.5;
         const isHighlighted = isKfSelected || atPlayhead;
@@ -255,10 +291,15 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
             key={`${i}-${kf.percentage}`}
             type="button"
             className="absolute"
+            data-timeline-focus-id={focusId}
             data-keyframe-group={groupAware ? kf.propertyGroup : undefined}
             data-keyframe-percentage={
               groupAware ? (kf.tweenPercentage ?? kf.percentage) : undefined
             }
+            data-keyframe-outside-clip={boundary ?? undefined}
+            tabIndex={focusId === rovingTargetId ? 0 : -1}
+            aria-label={`${kf.propertyGroup ?? "Motion"} keyframe at ${keyframeTimeLabel(clipStart, clipDuration, kf.percentage)}${boundary ? ` (${boundary} clip)` : ""}`}
+            aria-pressed={isKfSelected}
             style={{
               left: leftPx,
               top: centerY,
@@ -280,6 +321,15 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
             onPointerDown={onPointerDown}
             onPointerMove={canDrag ? (e) => retimeHandleRef.current?.update(e) : undefined}
             onPointerUp={onPointerUp}
+            // Keyboard activation only (detail 0): pointer presses already
+            // resolve through the pointerup path above.
+            onClick={(e) => {
+              if (e.detail !== 0) return;
+              e.stopPropagation();
+              suppressNextClick();
+              if (e.shiftKey) onShiftClickKeyframe?.(target);
+              else onClickKeyframe?.(target);
+            }}
             onPointerCancel={
               canDrag
                 ? (e) => {
@@ -293,7 +343,7 @@ export const TimelineDiamondLane = memo(function TimelineDiamondLane({
               e.stopPropagation();
               onContextMenuKeyframe?.(e, target);
             }}
-            title={`${roundPct(kf.percentage)}%`}
+            title={`${roundPct(kf.percentage)}%${boundary ? ` · ${boundary} clip` : ""}`}
           >
             <svg
               width={marker.visualSize}
diff --git a/packages/studio/src/player/components/TimelineDiamondConnectors.tsx b/packages/studio/src/player/components/TimelineDiamondConnectors.tsx
index c6934006a5..d30d46b6d1 100644
--- a/packages/studio/src/player/components/TimelineDiamondConnectors.tsx
+++ b/packages/studio/src/player/components/TimelineDiamondConnectors.tsx
@@ -2,7 +2,8 @@ import { Fragment, useRef } from "react";
 import { KEYFRAME_DRAG_THRESHOLD_PX } from "../../components/editor/keyframeDrag";
 import { MiniCurveSvg } from "../../components/editor/EaseCurveSection";
 import type { TimelineKeyframeTarget } from "./timelineKeyframeIdentity";
-import type { TimelineDiamondKeyframe } from "./TimelineClipDiamonds";
+import { keyframeTimeLabel, type TimelineDiamondKeyframe } from "./TimelineClipDiamonds";
+import { timelineEaseFocusId } from "./timelineNavigationIdentity";
 
 /** One diamond's geometry within its row, as computed by the lane. */
 export interface TimelineDiamondMarker {
@@ -21,6 +22,10 @@ export interface TimelineDiamondMarker {
 export function TimelineDiamondConnectors({
   markers,
   centerY,
+  elementId,
+  clipStart,
+  clipDuration,
+  rovingTargetId,
   baseColor,
   baseOpacity,
   groupAware,
@@ -30,6 +35,11 @@ export function TimelineDiamondConnectors({
 }: {
   markers: readonly TimelineDiamondMarker[];
   centerY: number;
+  elementId: string;
+  clipStart: number;
+  clipDuration: number;
+  /** Focus id of the one timeline control currently in the tab order. */
+  rovingTargetId: string | null;
   baseColor: string;
   baseOpacity: number;
   groupAware: boolean;
@@ -62,6 +72,7 @@ export function TimelineDiamondConnectors({
         // id (runtime-scanned) and there is no tween to target.
         const target = keyframeTarget(kf);
         const ease = kf.ease ?? globalEase;
+        const focusId = timelineEaseFocusId(elementId, target);
         return (
           <Fragment key={`line-${i}-${previous.keyframe.percentage}-${kf.percentage}`}>
             <div
@@ -101,7 +112,9 @@ export function TimelineDiamondConnectors({
                 <button
                   type="button"
                   data-keyframe-ease-button=""
-                  aria-label={`Edit ${ease} easing`}
+                  data-timeline-focus-id={focusId}
+                  tabIndex={focusId === rovingTargetId ? 0 : -1}
+                  aria-label={`Edit ${ease} easing after ${keyframeTimeLabel(clipStart, clipDuration, previous.keyframe.percentage)}`}
                   title={`Edit ${ease} easing`}
                   className="absolute flex items-center justify-center rounded opacity-0 transition-opacity group-hover:opacity-100 focus-visible:opacity-100"
                   style={{
diff --git a/packages/studio/src/player/components/TimelineLaneTypes.ts b/packages/studio/src/player/components/TimelineLaneTypes.ts
index c13344704f..55ddf41cef 100644
--- a/packages/studio/src/player/components/TimelineLaneTypes.ts
+++ b/packages/studio/src/player/components/TimelineLaneTypes.ts
@@ -28,6 +28,7 @@ export interface TimelineLaneBaseProps {
   rowGeometry: TimelineRowGeometry;
   virtualRows: readonly TimelineVirtualRow[];
   logicalRows: readonly TimelineLogicalRow[];
+  focusedTargetId: string | null;
   rowsVirtualized: boolean;
   clipIndex: TimelineClipIndex;
   renderTimeRange: TimelineTimeRange;
diff --git a/packages/studio/src/player/components/TimelineLanes.tsx b/packages/studio/src/player/components/TimelineLanes.tsx
index 64d43408f5..852e98e5da 100644
--- a/packages/studio/src/player/components/TimelineLanes.tsx
+++ b/packages/studio/src/player/components/TimelineLanes.tsx
@@ -24,6 +24,8 @@ import { TimelineTrackRow } from "./TimelineTrackRow";
 import { isTimelineClipActive } from "./useTimelineActiveClips";
 import { queryTimelineClipIndex } from "../lib/timelineClipIndex";
 import type { TimelineLogicalRow } from "./timelineKeyboardNavigation";
+import { timelineClipFocusId } from "./timelineNavigationIdentity";
+import { useTimelineKeyboardActor } from "./useTimelineKeyboardActor";
 
 interface TimelineLanesProps extends TimelineLaneBaseProps {
   /** Live-derived by TimelineCanvas from {@link TimelineLaneBaseProps.draggedClip}. */
@@ -47,6 +49,7 @@ export function TimelineLanes({
   rowGeometry,
   virtualRows,
   logicalRows,
+  focusedTargetId,
   rowsVirtualized,
   clipIndex,
   renderTimeRange,
@@ -113,12 +116,22 @@ export function TimelineLanes({
     trackStudioKeyframeLaneExpand({ expanded: willExpand });
     toggleClipExpanded(key);
   };
+  const keyboard = useTimelineKeyboardActor({
+    logicalRows,
+    focusedTargetId,
+    rowGeometry,
+    scrollRef,
+    onToggleRow: (row) => {
+      if (row.elementId) toggleClipExpandedTracked(row.elementId);
+    },
+  });
   return (
     <div
       role="treegrid"
       aria-label="Timeline tracks"
-      aria-multiselectable="true"
       aria-rowcount={logicalRows.length}
+      onFocus={keyboard.onFocus}
+      onKeyDown={keyboard.onKeyDown}
       className={rowsVirtualized ? "absolute inset-0" : undefined}
     >
       {
@@ -190,6 +203,7 @@ export function TimelineLanes({
               virtualized={rowsVirtualized}
               background={rowBackground}
               borderColor={theme.rowBorder}
+              rovingTargetId={keyboard.rovingTargetId}
             >
               <TimelineTrackHeader
                 trackNumber={trackNum}
@@ -211,6 +225,7 @@ export function TimelineLanes({
                 onToggleTrackHidden={onToggleTrackHidden}
                 onTogglePropertyGroupKeyframe={onTogglePropertyGroupKeyframe}
                 onSeek={onSeek}
+                rovingTargetId={keyboard.rovingTargetId}
               />
               <div
                 role="gridcell"
@@ -287,20 +302,12 @@ export function TimelineLanes({
                     const isSelected =
                       selectedElementId === elementKey || selectedElementIds.has(elementKey);
                     const isComposition = !!el.compositionSrc;
-                    // elementKey (el.key ?? el.id) is already unique per clip; do NOT
-                    // fold in the map index, or a splice/reorder remounts every clip
-                    // at/after the change (DOM flash, drag interruption).
                     const clipKey = elementKey;
                     const isDraggingClip =
                       draggedClip?.started === true &&
                       (draggedElement?.key ?? draggedElement?.id) === elementKey;
                     if (isDraggingClip) return null;
                     const previewElement = getPreviewElement(el);
-                    // Passenger of a live multi-drag: slide by the SAME formation
-                    // delta (the grabbed clip's group-clamped delta) via a
-                    // compositor transform on a same-geometry wrapper (absolute
-                    // inset-0 → identical offset parent, so the clip's own
-                    // left/top are preserved), plus the ghost's elevated z/opacity.
                     const isPassenger =
                       multiDragPreview != null && isMultiDragPassenger(clipKey, multiDragPreview);
                     const passengerOffsetPx = isPassenger
@@ -325,6 +332,9 @@ export function TimelineLanes({
                         capabilities={capabilities}
                         theme={theme}
                         isComposition={isComposition}
+                        tabIndex={
+                          keyboard.rovingTargetId === timelineClipFocusId(elementKey) ? 0 : -1
+                        }
                         onHoverStart={() => setHoveredClip(clipKey)}
                         onHoverEnd={() => setHoveredClip(null)}
                         onResizeStart={
@@ -462,37 +472,51 @@ export function TimelineLanes({
                           renderClipContent,
                           renderClipOverlay,
                         )}
-                        {STUDIO_KEYFRAMES_ENABLED &&
-                          !showsLanes &&
-                          keyframeCache?.get(elementKey) && (
-                            <TimelineClipDiamonds
-                              keyframesData={keyframeCache.get(elementKey)!}
-                              clipWidthPx={Math.max(previewElement.duration * pps, 4)}
-                              clipHeightPx={rowHeight - 2 * CLIP_Y}
-                              beatsActive={beatStripOnTrack}
-                              accentColor={clipStyle.accent}
-                              isSelected={isSelected}
-                              currentPercentage={
-                                previewElement.duration > 0
-                                  ? ((currentTime - previewElement.start) /
-                                      previewElement.duration) *
-                                    100
-                                  : 0
-                              }
-                              elementId={elementKey}
-                              selectedKeyframes={selectedKeyframes}
-                              onClickKeyframe={(_elId, target) =>
-                                onClickKeyframe?.(previewElement, target)
-                              }
-                              onShiftClickKeyframe={onShiftClickKeyframe}
-                              onContextMenuKeyframe={onContextMenuKeyframe}
-                              onMoveKeyframe={onMoveKeyframe}
-                              onSelectSegment={onSelectSegment}
-                              suppressClickRef={suppressClickRef}
-                            />
-                          )}
                       </TimelineClip>
                     );
+                    const compactDiamonds = STUDIO_KEYFRAMES_ENABLED &&
+                      !showsLanes &&
+                      keyframeCache?.get(elementKey) && (
+                        <div
+                          key={`${clipKey}-diamonds`}
+                          className="absolute pointer-events-none"
+                          style={{
+                            left: previewElement.start * pps,
+                            top: CLIP_Y,
+                            width: Math.max(previewElement.duration * pps, 4),
+                            height: rowHeight - 2 * CLIP_Y,
+                            zIndex: isSelected ? 11 : 6,
+                          }}
+                        >
+                          <TimelineClipDiamonds
+                            keyframesData={keyframeCache.get(elementKey)!}
+                            clipWidthPx={Math.max(previewElement.duration * pps, 4)}
+                            clipHeightPx={rowHeight - 2 * CLIP_Y}
+                            beatsActive={beatStripOnTrack}
+                            accentColor={clipStyle.accent}
+                            isSelected={isSelected}
+                            currentPercentage={
+                              previewElement.duration > 0
+                                ? ((currentTime - previewElement.start) / previewElement.duration) *
+                                  100
+                                : 0
+                            }
+                            elementId={elementKey}
+                            clipStart={previewElement.start}
+                            clipDuration={previewElement.duration}
+                            selectedKeyframes={selectedKeyframes}
+                            rovingTargetId={keyboard.rovingTargetId}
+                            onClickKeyframe={(_elId, target) =>
+                              onClickKeyframe?.(previewElement, target)
+                            }
+                            onShiftClickKeyframe={onShiftClickKeyframe}
+                            onContextMenuKeyframe={onContextMenuKeyframe}
+                            onMoveKeyframe={onMoveKeyframe}
+                            onSelectSegment={onSelectSegment}
+                            suppressClickRef={suppressClickRef}
+                          />
+                        </div>
+                      );
                     const propertyLanes = showsLanes && (
                       <TimelinePropertyLanes
                         key={`${clipKey}-property-lanes`}
@@ -510,6 +534,7 @@ export function TimelineLanes({
                         }
                         elementId={elementKey}
                         selectedKeyframes={selectedKeyframes}
+                        rovingTargetId={keyboard.rovingTargetId}
                         onSelectSegment={(target) => onSelectSegment?.(elementKey, target)}
                         onClickKeyframe={(target) => onClickKeyframe?.(previewElement, target)}
                         onShiftClickKeyframe={(target) =>
@@ -525,7 +550,7 @@ export function TimelineLanes({
                         suppressClickRef={suppressClickRef}
                       />
                     );
-                    if (!isPassenger) return [clip, propertyLanes];
+                    if (!isPassenger) return [clip, compactDiamonds, propertyLanes];
                     return (
                       <div
                         key={clipKey}
@@ -538,6 +563,7 @@ export function TimelineLanes({
                         }}
                       >
                         {clip}
+                        {compactDiamonds}
                         {propertyLanes}
                       </div>
                     );
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
index 387d845675..1b5b1e24df 100644
--- a/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.test.tsx
@@ -320,7 +320,7 @@ describe("TimelinePropertyLanes", () => {
     });
     const unselectedSegments = laneEaseSegments(host, "position");
     expect(unselectedSegments).toHaveLength(2);
-    expect(revealEaseButton(unselectedSegments[0]!)).not.toBeNull();
+    expect(laneEaseButtons(host, "position")).toHaveLength(2);
     act(() => root.unmount());
   });
 
diff --git a/packages/studio/src/player/components/TimelinePropertyLanes.tsx b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
index 847e4be8f3..df48525966 100644
--- a/packages/studio/src/player/components/TimelinePropertyLanes.tsx
+++ b/packages/studio/src/player/components/TimelinePropertyLanes.tsx
@@ -22,6 +22,7 @@ export interface TimelinePropertyLanesProps {
   currentPercentage: number;
   elementId: string;
   selectedKeyframes: ReadonlySet<string>;
+  rovingTargetId?: string | null;
   onSelectSegment?: (target: TimelineKeyframeTarget) => void;
   onClickKeyframe?: (target: TimelineKeyframeTarget) => void;
   onShiftClickKeyframe?: (target: TimelineKeyframeTarget) => void;
@@ -123,6 +124,7 @@ export function TimelinePropertyLanes({
   currentPercentage,
   elementId,
   selectedKeyframes,
+  rovingTargetId = null,
   onSelectSegment,
   onClickKeyframe,
   onShiftClickKeyframe,
@@ -178,7 +180,10 @@ export function TimelinePropertyLanes({
             isSelected={isSelected}
             currentPercentage={currentPercentage}
             elementId={elementId}
+            clipStart={clipStart}
+            clipDuration={clipDuration}
             selectedKeyframes={selectedKeyframes}
+            rovingTargetId={rovingTargetId}
             onSelectSegment={onSelectSegment}
             onClickKeyframe={onClickKeyframe}
             onShiftClickKeyframe={onShiftClickKeyframe}
diff --git a/packages/studio/src/player/components/TimelineTrackHeader.tsx b/packages/studio/src/player/components/TimelineTrackHeader.tsx
index 80cf8f1f46..25cb9c6fbb 100644
--- a/packages/studio/src/player/components/TimelineTrackHeader.tsx
+++ b/packages/studio/src/player/components/TimelineTrackHeader.tsx
@@ -30,6 +30,7 @@ interface TimelineTrackHeaderProps {
   currentTime: number;
   isTrackHidden: boolean;
   isAudioTrack: boolean;
+  rovingTargetId?: string | null;
   theme: TimelineTheme;
   onToggleClipExpanded: () => void;
   onToggleTrackHidden: TimelineEditCallbacks["onToggleTrackHidden"];
@@ -181,6 +182,7 @@ function PropertyGroupHeaderRow({
   gutterBackground,
   onTogglePropertyGroupKeyframe,
   onSeek,
+  rovingTargetId = null,
 }: {
   lane: TimelinePropertyLane;
   laneIndex: number;
@@ -191,6 +193,7 @@ function PropertyGroupHeaderRow({
   gutterBackground: string;
   onTogglePropertyGroupKeyframe?: TimelineEditCallbacks["onTogglePropertyGroupKeyframe"];
   onSeek?: (time: number) => void;
+  rovingTargetId: string | null;
 }) {
   const elementId = expandedElement.key ?? expandedElement.id;
   const { navigation, values, label, toggleTarget } = resolveLaneHeaderState(
@@ -204,7 +207,7 @@ function PropertyGroupHeaderRow({
       id={timelineLogicalRowCellId(timelinePropertyRowId(elementId, lane.group), "header")}
       data-timeline-focus-id={timelinePropertyRowId(elementId, lane.group)}
       data-timeline-element-id={elementId}
-      tabIndex={-1}
+      tabIndex={rovingTargetId === timelinePropertyRowId(elementId, lane.group) ? 0 : -1}
       data-property-group={lane.group}
       data-timeline-lane-top={getTimelineLaneTop(laneIndex)}
       className="absolute left-0 flex items-center gap-1 px-1.5 text-[10px] text-white/65"
@@ -276,6 +279,7 @@ export function TimelineTrackHeader({
   onToggleTrackHidden,
   onTogglePropertyGroupKeyframe,
   onSeek,
+  rovingTargetId = null,
 }: TimelineTrackHeaderProps) {
   const clipPercentage = keyframeClip
     ? ((currentTime - keyframeClip.start) / keyframeClip.duration) * 100
@@ -348,6 +352,7 @@ export function TimelineTrackHeader({
                 gutterBackground={theme.gutterBackground}
                 onTogglePropertyGroupKeyframe={onTogglePropertyGroupKeyframe}
                 onSeek={onSeek}
+                rovingTargetId={rovingTargetId}
               />
             ))}
         </>
diff --git a/packages/studio/src/player/components/TimelineTrackRow.tsx b/packages/studio/src/player/components/TimelineTrackRow.tsx
index 582db57fda..b60f11eb03 100644
--- a/packages/studio/src/player/components/TimelineTrackRow.tsx
+++ b/packages/studio/src/player/components/TimelineTrackRow.tsx
@@ -12,6 +12,7 @@ interface TimelineTrackRowProps {
   virtualized: boolean;
   background: string;
   borderColor: string;
+  rovingTargetId?: string | null;
   children: ReactNode;
 }
 
@@ -26,6 +27,7 @@ export function TimelineTrackRow({
   virtualized,
   background,
   borderColor,
+  rovingTargetId = null,
   children,
 }: TimelineTrackRowProps) {
   return (
@@ -49,7 +51,7 @@ export function TimelineTrackRow({
         aria-expanded={logicalRow.expandable ? logicalRow.expanded : undefined}
         data-timeline-logical-row-id={logicalRow.id}
         data-timeline-focus-id={logicalRow.id}
-        tabIndex={-1}
+        tabIndex={rovingTargetId === logicalRow.id ? 0 : -1}
         className="flex"
         style={{ height }}
       >
diff --git a/packages/studio/src/player/components/timelineDiamondTypes.ts b/packages/studio/src/player/components/timelineDiamondTypes.ts
index 9b2fedab1f..5abe3c2ca0 100644
--- a/packages/studio/src/player/components/timelineDiamondTypes.ts
+++ b/packages/studio/src/player/components/timelineDiamondTypes.ts
@@ -36,7 +36,12 @@ export interface TimelineClipDiamondsProps {
   isSelected: boolean;
   currentPercentage: number;
   elementId: string;
+  /** Absolute clip bounds, used only to voice a keyframe's time in its label. */
+  clipStart?: number;
+  clipDuration?: number;
   selectedKeyframes: ReadonlySet<string>;
+  /** Focus id of the one timeline control currently in the tab order. */
+  rovingTargetId?: string | null;
   onClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
   onShiftClickKeyframe?: (elementId: string, keyframe: TimelineKeyframeTarget) => void;
   onContextMenuKeyframe?: (
@@ -81,12 +86,6 @@ export interface TimelineDiamondLaneProps extends Omit<
 }
 
 export const DIAMOND_RATIO = 0.8;
-// Percentage tolerance for rendering keyframes near clip boundaries. Keyframes
-// slightly outside [0, 100] (from rounding or stale cache during the async
-// persist → reload cycle) are still rendered (the clip is overflow-visible) at
-// their true position rather than hidden.
-export const KF_MIN_PCT = -5;
-export const KF_MAX_PCT = 105;
 
 export type DragState = {
   kfKey: string;
diff --git a/packages/studio/src/player/components/timelineKeyboardNavigation.ts b/packages/studio/src/player/components/timelineKeyboardNavigation.ts
index b2d88354be..62cad46a36 100644
--- a/packages/studio/src/player/components/timelineKeyboardNavigation.ts
+++ b/packages/studio/src/player/components/timelineKeyboardNavigation.ts
@@ -202,7 +202,7 @@ export function buildTimelineLogicalRows({
       logicalIndex: rows.length,
       level: 1,
       parentId: null,
-      elementId: null,
+      elementId: activeId,
       expandable: lanes.length > 0,
       expanded,
       items: clipItems(trackId, elements),
diff --git a/packages/studio/src/player/components/useTimelineKeyboardActor.test.tsx b/packages/studio/src/player/components/useTimelineKeyboardActor.test.tsx
new file mode 100644
index 0000000000..6a4f64cb1e
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineKeyboardActor.test.tsx
@@ -0,0 +1,166 @@
+// @vitest-environment happy-dom
+
+import React, { act, useRef } from "react";
+import { createRoot } from "react-dom/client";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { usePlayerStore } from "../store/playerStore";
+import { createTimelineRowGeometry } from "./timelineLayout";
+import type { TimelineLogicalRow } from "./timelineKeyboardNavigation";
+import { useTimelineKeyboardActor } from "./useTimelineKeyboardActor";
+
+Object.defineProperty(globalThis, "IS_REACT_ACT_ENVIRONMENT", {
+  configurable: true,
+  value: true,
+});
+
+const rows: readonly TimelineLogicalRow[] = [
+  {
+    id: "track-1",
+    kind: "row",
+    physicalTrackKey: 1,
+    logicalIndex: 0,
+    level: 1,
+    parentId: null,
+    elementId: "clip-1",
+    expandable: true,
+    expanded: false,
+    items: [{ id: "clip-1", kind: "clip", rowId: "track-1", elementId: "clip-1", time: 1 }],
+  },
+  {
+    id: "track-2",
+    kind: "row",
+    physicalTrackKey: 2,
+    logicalIndex: 1,
+    level: 1,
+    parentId: null,
+    elementId: "clip-2",
+    expandable: false,
+    expanded: false,
+    items: [{ id: "clip-2", kind: "clip", rowId: "track-2", elementId: "clip-2", time: 2 }],
+  },
+  {
+    id: "track-3",
+    kind: "row",
+    physicalTrackKey: 3,
+    logicalIndex: 2,
+    level: 1,
+    parentId: null,
+    elementId: null,
+    expandable: false,
+    expanded: false,
+    items: [],
+  },
+];
+
+interface HarnessProps {
+  focusedTargetId?: string | null;
+  onToggleRow?: (target: TimelineLogicalRow) => void;
+}
+
+function Harness({ focusedTargetId = null, onToggleRow = vi.fn() }: HarnessProps) {
+  const scrollRef = useRef<HTMLDivElement>(null);
+  const keyboard = useTimelineKeyboardActor({
+    logicalRows: rows,
+    focusedTargetId,
+    rowGeometry: createTimelineRowGeometry([1, 2, 3], [48, 48, 48]),
+    scrollRef,
+    onToggleRow,
+  });
+  return (
+    <div ref={scrollRef} onFocus={keyboard.onFocus} onKeyDown={keyboard.onKeyDown}>
+      {rows
+        .flatMap((row) => [row, ...row.items])
+        .map((target) => (
+          <button
+            key={target.id}
+            data-timeline-focus-id={target.id}
+            tabIndex={target.id === keyboard.rovingTargetId ? 0 : -1}
+          >
+            {target.id}
+          </button>
+        ))}
+    </div>
+  );
+}
+
+function renderHarness(props: React.ComponentProps<typeof Harness> = {}) {
+  const host = document.createElement("div");
+  document.body.append(host);
+  const root = createRoot(host);
+  act(() => root.render(<Harness {...props} />));
+  return { host, root };
+}
+
+function key(target: Element, value: string, init: KeyboardEventInit = {}) {
+  const event = new KeyboardEvent("keydown", {
+    bubbles: true,
+    cancelable: true,
+    key: value,
+    ...init,
+  });
+  act(() => target.dispatchEvent(event));
+  return event;
+}
+
+afterEach(() => {
+  document.body.innerHTML = "";
+  usePlayerStore.setState({ timelineFocus: null, timelineFocusNonce: 0 });
+});
+
+describe("useTimelineKeyboardActor", () => {
+  it("exposes exactly one roving target and persists focused logical identity", () => {
+    const { host, root } = renderHarness({ focusedTargetId: "clip-2" });
+    expect(host.querySelectorAll('[tabindex="0"]')).toHaveLength(1);
+    const target = host.querySelector<HTMLElement>('[data-timeline-focus-id="track-3"]')!;
+    act(() => target.focus());
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe("track-3");
+    act(() => root.unmount());
+  });
+
+  it("requests navigation focus without clicking or seeking", () => {
+    const { host, root } = renderHarness({ focusedTargetId: "clip-1" });
+    const target = host.querySelector<HTMLElement>('[data-timeline-focus-id="clip-1"]')!;
+    const click = vi.fn();
+    target.addEventListener("click", click);
+    const event = key(target, "ArrowDown");
+    expect(event.defaultPrevented).toBe(true);
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe("clip-2");
+    expect(usePlayerStore.getState().requestedSeekTime).toBeNull();
+    expect(click).not.toHaveBeenCalled();
+    act(() => root.unmount());
+  });
+
+  it("supports modified timeline boundaries and viewport-sized paging", () => {
+    const { host, root } = renderHarness({ focusedTargetId: "clip-2" });
+    const viewport = host.firstElementChild as HTMLDivElement;
+    Object.defineProperty(viewport, "clientHeight", { configurable: true, value: 48 });
+    const target = host.querySelector<HTMLElement>('[data-timeline-focus-id="clip-2"]')!;
+    key(target, "End", { metaKey: true });
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe("track-3");
+    key(target, "PageUp");
+    expect(usePlayerStore.getState().timelineFocus?.id).toBe("clip-1");
+    act(() => root.unmount());
+  });
+
+  it("toggles expandable rows but leaves native control activation to the control", () => {
+    const onToggleRow = vi.fn();
+    const { host, root } = renderHarness({ focusedTargetId: "track-1", onToggleRow });
+    const row = host.querySelector<HTMLElement>('[data-timeline-focus-id="track-1"]')!;
+    const clip = host.querySelector<HTMLElement>('[data-timeline-focus-id="clip-1"]')!;
+    expect(key(row, " ").defaultPrevented).toBe(true);
+    expect(onToggleRow).toHaveBeenCalledWith(rows[0]);
+    expect(key(clip, "Enter").defaultPrevented).toBe(false);
+    expect(onToggleRow).toHaveBeenCalledOnce();
+    act(() => root.unmount());
+  });
+
+  it("dispatches the existing scoped context-menu callback", () => {
+    const { host, root } = renderHarness({ focusedTargetId: "clip-1" });
+    const target = host.querySelector<HTMLElement>('[data-timeline-focus-id="clip-1"]')!;
+    const context = vi.fn((event: Event) => event.preventDefault());
+    target.addEventListener("contextmenu", context);
+    key(target, "F10", { shiftKey: true });
+    expect(context).toHaveBeenCalledOnce();
+    act(() => root.unmount());
+  });
+});
diff --git a/packages/studio/src/player/components/useTimelineKeyboardActor.ts b/packages/studio/src/player/components/useTimelineKeyboardActor.ts
new file mode 100644
index 0000000000..9fe6fdfcf6
--- /dev/null
+++ b/packages/studio/src/player/components/useTimelineKeyboardActor.ts
@@ -0,0 +1,109 @@
+import { useCallback, type FocusEvent, type KeyboardEvent, type RefObject } from "react";
+import { usePlayerStore } from "../store/playerStore";
+import type { TimelineRowGeometry } from "./timelineLayout";
+import {
+  isTimelineNavigationKey,
+  locateTimelineLogicalTarget,
+  resolveTimelineNavigationTarget,
+  type TimelineLogicalRow,
+} from "./timelineKeyboardNavigation";
+
+interface TimelineKeyboardActorInput {
+  logicalRows: readonly TimelineLogicalRow[];
+  focusedTargetId: string | null;
+  rowGeometry: TimelineRowGeometry;
+  scrollRef: RefObject<HTMLDivElement | null>;
+  onToggleRow: (target: TimelineLogicalRow) => void;
+}
+
+function eventTarget(event: FocusEvent | KeyboardEvent): HTMLElement | null {
+  if (!(event.target instanceof Element)) return null;
+  const target = event.target.closest<HTMLElement>("[data-timeline-focus-id]");
+  return target && event.currentTarget.contains(target) ? target : null;
+}
+
+function viewportPageSize(
+  rows: readonly TimelineLogicalRow[],
+  geometry: TimelineRowGeometry,
+  viewport: HTMLDivElement | null,
+): number {
+  if (!viewport || rows.length === 0) return 1;
+  const first = Math.max(0, Math.floor(geometry.getRowFromY(viewport.scrollTop)));
+  const last = Math.min(
+    geometry.rowKeys.length - 1,
+    Math.floor(geometry.getRowFromY(viewport.scrollTop + viewport.clientHeight)),
+  );
+  const visibleTracks = new Set(geometry.rowKeys.slice(first, last + 1));
+  return Math.max(1, rows.filter((row) => visibleTracks.has(row.physicalTrackKey)).length);
+}
+
+function openContextMenu(target: HTMLElement): void {
+  const bounds = target.getBoundingClientRect();
+  target.dispatchEvent(
+    new MouseEvent("contextmenu", {
+      bubbles: true,
+      cancelable: true,
+      clientX: bounds.left + bounds.width / 2,
+      clientY: bounds.top + bounds.height / 2,
+    }),
+  );
+}
+
+/** The timeline's sole keyboard actor; controls only describe their logical identity. */
+export function useTimelineKeyboardActor({
+  logicalRows,
+  focusedTargetId,
+  rowGeometry,
+  scrollRef,
+  onToggleRow,
+}: TimelineKeyboardActorInput) {
+  const rovingTargetId =
+    (focusedTargetId && locateTimelineLogicalTarget(logicalRows, focusedTargetId)?.target.id) ??
+    logicalRows[0]?.id ??
+    null;
+
+  const onFocus = useCallback(
+    (event: FocusEvent<HTMLElement>) => {
+      const id = eventTarget(event)?.dataset.timelineFocusId;
+      if (id && id !== focusedTargetId) usePlayerStore.getState().requestTimelineFocus(id);
+    },
+    [focusedTargetId],
+  );
+
+  const onKeyDown = useCallback(
+    (event: KeyboardEvent<HTMLElement>) => {
+      const targetElement = eventTarget(event);
+      const id = targetElement?.dataset.timelineFocusId;
+      if (!targetElement || !id) return;
+      const located = locateTimelineLogicalTarget(logicalRows, id);
+      if (!located) return;
+
+      if (isTimelineNavigationKey(event.key)) {
+        const next = resolveTimelineNavigationTarget(logicalRows, id, event.key, {
+          pageSize: viewportPageSize(logicalRows, rowGeometry, scrollRef.current),
+          timelineBoundary: event.ctrlKey || event.metaKey,
+        });
+        event.preventDefault();
+        if (next && next.id !== id) usePlayerStore.getState().requestTimelineFocus(next.id);
+        return;
+      }
+      if (event.key === "ContextMenu" || (event.key === "F10" && event.shiftKey)) {
+        event.preventDefault();
+        openContextMenu(targetElement);
+        return;
+      }
+      if (
+        (event.key !== "Enter" && event.key !== " ") ||
+        located.target.kind !== "row" ||
+        !located.target.expandable
+      ) {
+        return;
+      }
+      event.preventDefault();
+      onToggleRow(located.target);
+    },
+    [logicalRows, onToggleRow, rowGeometry, scrollRef],
+  );
+
+  return { rovingTargetId, onFocus, onKeyDown };
+}

From d791bacdb3c60507734e8530a9f5b1a575844b6c Mon Sep 17 00:00:00 2001
From: Codex <codex@local>
Date: Mon, 20 Jul 2026 21:44:01 +0200
Subject: [PATCH 125/125] perf(studio): schedule adaptive timeline thumbnails

---
 .../src/components/TimelineToolbar.test.tsx   |  21 +-
 .../studio/src/components/TimelineToolbar.tsx |  30 +-
 .../src/hooks/useRenderClipContent.test.ts    |   5 +-
 .../studio/src/hooks/useRenderClipContent.ts  |  13 +-
 .../src/player/lib/thumbnailPolicy.test.ts    |  14 +
 .../studio/src/player/lib/thumbnailPolicy.ts  |  21 +
 .../src/player/lib/thumbnailScheduler.test.ts | 281 ++++++++++++
 .../src/player/lib/thumbnailScheduler.ts      | 425 ++++++++++++++++++
 .../studio/src/player/store/playerStore.ts    |   8 +
 .../src/utils/studioUiPreferences.test.ts     |  14 +
 .../studio/src/utils/studioUiPreferences.ts   |   6 +
 11 files changed, 834 insertions(+), 4 deletions(-)
 create mode 100644 packages/studio/src/player/lib/thumbnailPolicy.test.ts
 create mode 100644 packages/studio/src/player/lib/thumbnailPolicy.ts
 create mode 100644 packages/studio/src/player/lib/thumbnailScheduler.test.ts
 create mode 100644 packages/studio/src/player/lib/thumbnailScheduler.ts

diff --git a/packages/studio/src/components/TimelineToolbar.test.tsx b/packages/studio/src/components/TimelineToolbar.test.tsx
index 0050dcfc95..2e7900e826 100644
--- a/packages/studio/src/components/TimelineToolbar.test.tsx
+++ b/packages/studio/src/components/TimelineToolbar.test.tsx
@@ -12,7 +12,7 @@ import { TimelineToolbar } from "./TimelineToolbar";
 
 afterEach(() => {
   document.body.innerHTML = "";
-  usePlayerStore.setState({ autoKeyframeEnabled: true });
+  usePlayerStore.setState({ autoKeyframeEnabled: true, thumbnailMode: "adaptive" });
 });
 
 function renderToolbar(
@@ -58,6 +58,25 @@ describe("TimelineToolbar — auto-keyframe toggle (#1808)", () => {
     act(() => root.unmount());
   });
 });
+
+describe("TimelineToolbar — adaptive thumbnails", () => {
+  it("keeps a user-controlled hidden mode as the rollback path", () => {
+    const { host, root } = renderToolbar();
+    const button = host.querySelector<HTMLButtonElement>(
+      'button[aria-label="Hide thumbnails — labels only"]',
+    );
+    if (!button) throw new Error("thumbnail toggle not rendered");
+
+    act(() => button.click());
+
+    expect(usePlayerStore.getState().thumbnailMode).toBe("hidden");
+    expect(button.getAttribute("aria-label")).toBe(
+      "Show thumbnails — posters stay visible; richer previews appear on interaction",
+    );
+    act(() => root.unmount());
+  });
+});
+
 describe("TimelineToolbar — motion path endpoints", () => {
   it("does not advertise a destructive keyframe toggle for a required endpoint", () => {
     usePlayerStore.setState({ currentTime: 10 });
diff --git a/packages/studio/src/components/TimelineToolbar.tsx b/packages/studio/src/components/TimelineToolbar.tsx
index c745f087d1..feb93b103c 100644
--- a/packages/studio/src/components/TimelineToolbar.tsx
+++ b/packages/studio/src/components/TimelineToolbar.tsx
@@ -1,5 +1,5 @@
 import { useEffect, useRef } from "react";
-import { Magnet, MagnifyingGlassMinus, MagnifyingGlassPlus } from "@phosphor-icons/react";
+import { Image, Magnet, MagnifyingGlassMinus, MagnifyingGlassPlus } from "@phosphor-icons/react";
 import {
   useEnableKeyframes,
   isPlayheadWithinTween,
@@ -115,6 +115,9 @@ export function TimelineToolbar({ domEditSession, onSplitElement }: TimelineTool
   const setTimelineSnapEnabled = usePlayerStore((s) => s.setTimelineSnapEnabled);
   const autoKeyframeEnabled = usePlayerStore((s) => s.autoKeyframeEnabled);
   const setAutoKeyframeEnabled = usePlayerStore((s) => s.setAutoKeyframeEnabled);
+  const thumbnailMode = usePlayerStore((s) => s.thumbnailMode);
+  const setThumbnailMode = usePlayerStore((s) => s.setThumbnailMode);
+  const thumbnailsVisible = thumbnailMode === "adaptive";
   // Subscribe so the add-beat button reacts to playhead movement and analysis load.
   const currentTime = usePlayerStore((s) => s.currentTime);
   const beatAnalysisReady = usePlayerStore((s) => s.beatAnalysis !== null);
@@ -410,6 +413,31 @@ export function TimelineToolbar({ domEditSession, onSplitElement }: TimelineTool
           })()}
         </div>
         <div className="flex items-center gap-0.5">
+          <Tooltip
+            label={
+              thumbnailsVisible
+                ? "Hide thumbnails — labels only"
+                : "Show thumbnails — posters stay visible; richer previews appear on interaction"
+            }
+          >
+            <button
+              type="button"
+              aria-label={
+                thumbnailsVisible
+                  ? "Hide thumbnails — labels only"
+                  : "Show thumbnails — posters stay visible; richer previews appear on interaction"
+              }
+              aria-pressed={thumbnailsVisible}
+              onClick={() => setThumbnailMode(thumbnailsVisible ? "hidden" : "adaptive")}
+              className={`h-7 px-2 rounded-md text-[11px] font-medium transition-colors ${
+                thumbnailsVisible
+                  ? "bg-studio-accent/10 text-studio-accent"
+                  : "text-neutral-400 hover:bg-white/[0.06] hover:text-neutral-200"
+              }`}
+            >
+              <Image size={16} aria-hidden="true" />
+            </button>
+          </Tooltip>
           <Tooltip label="Fit timeline to width">
             <button
               type="button"
diff --git a/packages/studio/src/hooks/useRenderClipContent.test.ts b/packages/studio/src/hooks/useRenderClipContent.test.ts
index 057cf04824..2c33e27909 100644
--- a/packages/studio/src/hooks/useRenderClipContent.test.ts
+++ b/packages/studio/src/hooks/useRenderClipContent.test.ts
@@ -5,13 +5,14 @@ import { createRoot } from "react-dom/client";
 import { afterEach, describe, expect, it } from "vitest";
 import { CompositionThumbnail, VideoThumbnail } from "../player";
 import { AudioWaveform } from "../player/components/AudioWaveform";
-import type { TimelineElement } from "../player/store/playerStore";
+import { usePlayerStore, type TimelineElement } from "../player/store/playerStore";
 import { normalizeCompositionSrc } from "./useRenderClipContent";
 import { useRenderClipContent } from "./useRenderClipContent";
 
 (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
 afterEach(() => {
+  usePlayerStore.setState({ thumbnailMode: "hidden" });
   document.body.innerHTML = "";
 });
 
@@ -106,6 +107,8 @@ describe("useRenderClipContent", () => {
   });
 
   it("passes empty labels to thumbnail content so TimelineClip owns clip names", () => {
+    usePlayerStore.setState({ thumbnailMode: "adaptive" });
+
     const cases: Array<{ content: ReactNode; type: unknown }> = [
       {
         content: renderClipContent({
diff --git a/packages/studio/src/hooks/useRenderClipContent.ts b/packages/studio/src/hooks/useRenderClipContent.ts
index 0e01c381fa..3cc7a56b88 100644
--- a/packages/studio/src/hooks/useRenderClipContent.ts
+++ b/packages/studio/src/hooks/useRenderClipContent.ts
@@ -5,6 +5,8 @@ import type { TimelineElement } from "../player";
 import { AudioWaveform } from "../player/components/AudioWaveform";
 import { ImageThumbnail } from "../player/components/ImageThumbnail";
 import { encodePreviewPath, resolveMediaPreviewUrl } from "../player/components/thumbnailUtils";
+import { usePlayerStore } from "../player/store/playerStore";
+import { effectiveThumbnailMode } from "../player/lib/thumbnailPolicy";
 
 export function normalizeCompositionSrc(
   compSrc: string,
@@ -87,6 +89,9 @@ export function useRenderClipContent({
   activePreviewUrl,
   effectiveTimelineDuration,
 }: UseRenderClipContentOptions) {
+  // Self-sourced so the adaptive policy gates thumbnail generation without App plumbing.
+  const thumbnailMode = usePlayerStore((s) => s.thumbnailMode);
+  const effectiveMode = effectiveThumbnailMode(thumbnailMode);
   return useCallback(
     // Pre-existing clip-content dispatcher; reduced by extracting renderAudioClip.
     // fallow-ignore-next-line complexity
@@ -94,6 +99,12 @@ export function useRenderClipContent({
       const pid = projectIdRef.current;
       if (!pid) return null;
 
+      // Thumbnail generation disabled (perf) -> plain clip bars. Audio still shows
+      // its waveform (cheap, not a frame thumbnail). Toggle: timeline toolbar.
+      if (effectiveMode === "hidden") {
+        return el.tag === "audio" ? renderAudioClip(el, pid, style.label) : null;
+      }
+
       let compSrc = el.compositionSrc;
       if (compSrc) {
         compSrc = normalizeCompositionSrc(compSrc, pid, window.location.origin);
@@ -182,6 +193,6 @@ export function useRenderClipContent({
 
       return null;
     },
-    [projectIdRef, compIdToSrc, activePreviewUrl, effectiveTimelineDuration],
+    [projectIdRef, compIdToSrc, activePreviewUrl, effectiveTimelineDuration, effectiveMode],
   );
 }
diff --git a/packages/studio/src/player/lib/thumbnailPolicy.test.ts b/packages/studio/src/player/lib/thumbnailPolicy.test.ts
new file mode 100644
index 0000000000..675a49140e
--- /dev/null
+++ b/packages/studio/src/player/lib/thumbnailPolicy.test.ts
@@ -0,0 +1,14 @@
+import { describe, expect, it } from "vitest";
+import { defaultThumbnailMode, effectiveThumbnailMode } from "./thumbnailPolicy";
+
+describe("thumbnail runtime policy", () => {
+  it("defaults missing preferences adaptively after activation", () => {
+    expect(defaultThumbnailMode(undefined, "follow-preference")).toBe("adaptive");
+    expect(defaultThumbnailMode(undefined, "legacy-default")).toBe("hidden");
+  });
+
+  it("forces the safe renderer without overwriting user intent", () => {
+    expect(effectiveThumbnailMode("adaptive", "force-hidden")).toBe("hidden");
+    expect(effectiveThumbnailMode("adaptive", "follow-preference")).toBe("adaptive");
+  });
+});
diff --git a/packages/studio/src/player/lib/thumbnailPolicy.ts b/packages/studio/src/player/lib/thumbnailPolicy.ts
new file mode 100644
index 0000000000..2953e4990c
--- /dev/null
+++ b/packages/studio/src/player/lib/thumbnailPolicy.ts
@@ -0,0 +1,21 @@
+export type ThumbnailMode = "adaptive" | "hidden";
+export type ThumbnailRuntimePolicy = "follow-preference" | "force-hidden" | "legacy-default";
+
+const rawPolicy = import.meta.env.VITE_STUDIO_TIMELINE_THUMBNAIL_POLICY;
+
+const studioThumbnailRuntimePolicy: ThumbnailRuntimePolicy =
+  rawPolicy === "force-hidden" || rawPolicy === "legacy-default" ? rawPolicy : "follow-preference";
+
+export function defaultThumbnailMode(
+  storedMode: ThumbnailMode | undefined,
+  policy: ThumbnailRuntimePolicy = studioThumbnailRuntimePolicy,
+): ThumbnailMode {
+  return storedMode ?? (policy === "legacy-default" ? "hidden" : "adaptive");
+}
+
+export function effectiveThumbnailMode(
+  preferredMode: ThumbnailMode,
+  policy: ThumbnailRuntimePolicy = studioThumbnailRuntimePolicy,
+): ThumbnailMode {
+  return policy === "force-hidden" ? "hidden" : preferredMode;
+}
diff --git a/packages/studio/src/player/lib/thumbnailScheduler.test.ts b/packages/studio/src/player/lib/thumbnailScheduler.test.ts
new file mode 100644
index 0000000000..a9e1b678dc
--- /dev/null
+++ b/packages/studio/src/player/lib/thumbnailScheduler.test.ts
@@ -0,0 +1,281 @@
+import { describe, expect, it, vi } from "vitest";
+import { resolveTimelineViewportBudgets } from "./timelineViewportBudgets";
+import {
+  createThumbnailKey,
+  ThumbnailScheduler,
+  type ThumbnailLoadedResult,
+  type ThumbnailPriority,
+  type ThumbnailRequest,
+} from "./thumbnailScheduler";
+
+function deferred<T>() {
+  let resolve!: (value: T) => void;
+  let reject!: (reason?: unknown) => void;
+  const promise = new Promise<T>((accept, fail) => {
+    resolve = accept;
+    reject = fail;
+  });
+  return { promise, resolve, reject };
+}
+
+function result(name: string, weight = 1, dispose = vi.fn()): ThumbnailLoadedResult {
+  return { value: { kind: "image", url: name, aspect: 1 }, weight, dispose };
+}
+
+function request(
+  key: string,
+  load: ThumbnailRequest["load"],
+  priority: ThumbnailPriority = "visible",
+  overrides: Partial<ThumbnailRequest> = {},
+): ThumbnailRequest {
+  return {
+    key,
+    projectId: "project-a",
+    sessionEpoch: 1,
+    kind: "image",
+    priority,
+    load,
+    ...overrides,
+  };
+}
+
+async function flush(): Promise<void> {
+  await Promise.resolve();
+  await Promise.resolve();
+}
+
+describe("ThumbnailScheduler", () => {
+  it("deduplicates identical requests and releases subscribers independently", async () => {
+    const scheduler = new ThumbnailScheduler();
+    const pending = deferred<ThumbnailLoadedResult>();
+    const load = vi.fn(() => pending.promise);
+    const listenerA = vi.fn();
+    const listenerB = vi.fn();
+
+    const leaseA = scheduler.acquire(request("same", load), listenerA);
+    const leaseB = scheduler.acquire(request("same", load), listenerB);
+    expect(load).toHaveBeenCalledTimes(1);
+
+    leaseA.release();
+    listenerA.mockClear();
+    pending.resolve(result("poster"));
+    await flush();
+    expect(scheduler.getSnapshot(request("same", load))).toMatchObject({
+      status: "ready",
+      value: { url: "poster" },
+    });
+    expect(listenerA).not.toHaveBeenCalled();
+    expect(listenerB).toHaveBeenCalled();
+
+    leaseB.release();
+    expect(scheduler.getDiagnostics().leases).toBe(0);
+  });
+
+  it("keeps snapshots referentially stable and supports independent leases sharing a callback", async () => {
+    const scheduler = new ThumbnailScheduler();
+    const listener = vi.fn();
+    const shared = request("stable", async () => result("stable"));
+    const first = scheduler.acquire(shared, listener);
+    const second = scheduler.acquire(shared, listener);
+    await flush();
+    expect(scheduler.getSnapshot(shared)).toBe(scheduler.getSnapshot(shared));
+    listener.mockClear();
+    first.release();
+    scheduler.invalidateProject("project-a");
+    expect(listener).toHaveBeenCalledTimes(1);
+    second.release();
+  });
+
+  it("orders interaction before visible before overscan when a slot opens", async () => {
+    const scheduler = new ThumbnailScheduler(
+      resolveTimelineViewportBudgets({ concurrentMetadataJobs: 1 }),
+    );
+    const first = deferred<ThumbnailLoadedResult>();
+    const starts: string[] = [];
+    const load = (name: string, pending?: ReturnType<typeof deferred<ThumbnailLoadedResult>>) =>
+      vi.fn(() => {
+        starts.push(name);
+        return pending?.promise ?? Promise.resolve(result(name));
+      });
+
+    scheduler.acquire(request("first", load("first", first)), vi.fn());
+    scheduler.acquire(request("overscan", load("overscan"), "overscan"), vi.fn());
+    scheduler.acquire(request("visible", load("visible"), "visible"), vi.fn());
+    scheduler.acquire(request("interaction", load("interaction"), "interaction"), vi.fn());
+    expect(starts).toEqual(["first"]);
+
+    first.resolve(result("first"));
+    await vi.waitFor(() => {
+      expect(starts).toEqual(["first", "interaction", "visible", "overscan"]);
+    });
+  });
+
+  it("suspends new rich work while scrolling but lets posters proceed", async () => {
+    const scheduler = new ThumbnailScheduler();
+    const richLoad = vi.fn(async () => result("rich"));
+    const posterLoad = vi.fn(async () => result("poster"));
+    scheduler.setScrolling(true);
+
+    scheduler.acquire(request("rich", richLoad, "interaction", { rich: true }), vi.fn());
+    scheduler.acquire(request("poster", posterLoad), vi.fn());
+    await flush();
+    expect(richLoad).not.toHaveBeenCalled();
+    expect(posterLoad).toHaveBeenCalledTimes(1);
+
+    scheduler.setScrolling(false);
+    await flush();
+    expect(richLoad).toHaveBeenCalledTimes(1);
+  });
+
+  it("aborts queued and active jobs after the final release", async () => {
+    const scheduler = new ThumbnailScheduler(
+      resolveTimelineViewportBudgets({ concurrentVideoDecodes: 1 }),
+    );
+    const active = deferred<ThumbnailLoadedResult>();
+    let activeSignal: AbortSignal | undefined;
+    const activeLease = scheduler.acquire(
+      request(
+        "active",
+        (signal) => {
+          activeSignal = signal;
+          return active.promise;
+        },
+        "visible",
+        { kind: "video" },
+      ),
+      vi.fn(),
+    );
+    const queuedLoad = vi.fn(async () => result("queued"));
+    const queuedLease = scheduler.acquire(
+      request("queued", queuedLoad, "visible", { kind: "video" }),
+      vi.fn(),
+    );
+
+    queuedLease.release();
+    activeLease.release();
+    expect(activeSignal?.aborted).toBe(true);
+    expect(queuedLoad).not.toHaveBeenCalled();
+    active.reject(new DOMException("aborted", "AbortError"));
+    await flush();
+    expect(scheduler.getDiagnostics()).toMatchObject({ queued: 0, active: 0, leases: 0 });
+  });
+
+  it("disposes a late result exactly once after project invalidation", async () => {
+    const scheduler = new ThumbnailScheduler();
+    const pending = deferred<ThumbnailLoadedResult>();
+    const dispose = vi.fn();
+    scheduler.acquire(
+      request("late", () => pending.promise),
+      vi.fn(),
+    );
+
+    scheduler.invalidateProject("project-a");
+    pending.resolve(result("late", 1, dispose));
+    await flush();
+    expect(dispose).toHaveBeenCalledTimes(1);
+    expect(scheduler.getSnapshot(request("late", () => pending.promise))).toEqual({
+      status: "idle",
+    });
+  });
+
+  it("isolates late results by session epoch", async () => {
+    const scheduler = new ThumbnailScheduler();
+    const old = deferred<ThumbnailLoadedResult>();
+    const oldRequest = request("poster", () => old.promise, "visible", { sessionEpoch: 1 });
+    const nextRequest = request("poster", async () => result("next"), "visible", {
+      sessionEpoch: 2,
+    });
+    scheduler.acquire(oldRequest, vi.fn());
+    scheduler.acquire(nextRequest, vi.fn());
+    await flush();
+    old.resolve(result("old"));
+    await flush();
+    expect(scheduler.getSnapshot(nextRequest)).toMatchObject({
+      status: "ready",
+      value: { url: "next" },
+    });
+  });
+
+  it("turns synchronous loader errors into bounded failure snapshots", async () => {
+    const scheduler = new ThumbnailScheduler();
+    const bad = request("throws", () => {
+      throw new Error("sync failure");
+    });
+    const lease = scheduler.acquire(bad, vi.fn());
+    await flush();
+    expect(scheduler.getSnapshot(bad)).toMatchObject({ status: "error" });
+    expect(scheduler.getDiagnostics().active).toBe(0);
+    lease.release();
+  });
+
+  it("disposes uncached results after the final lease and tolerates broken disposers", async () => {
+    const scheduler = new ThumbnailScheduler(
+      resolveTimelineViewportBudgets({ thumbnailCacheBytes: 1 }),
+    );
+    const dispose = vi.fn(() => {
+      throw new Error("cleanup failure");
+    });
+    const oversized = request("oversized", async () => result("large", 2, dispose));
+    const lease = scheduler.acquire(oversized, vi.fn());
+    await flush();
+    expect(scheduler.getSnapshot(oversized).status).toBe("ready");
+    expect(() => lease.release()).not.toThrow();
+    expect(dispose).toHaveBeenCalledTimes(1);
+    expect(scheduler.getSnapshot(oversized).status).toBe("idle");
+  });
+
+  it("evicts least-recently-used unleased values by bytes, count, and project count", async () => {
+    const scheduler = new ThumbnailScheduler(
+      resolveTimelineViewportBudgets({
+        thumbnailCacheBytes: 6,
+        thumbnailCacheEntries: 2,
+        thumbnailCacheEntriesPerProject: 2,
+      }),
+    );
+    const disposals = [vi.fn(), vi.fn(), vi.fn()];
+    for (let index = 0; index < 3; index++) {
+      const lease = scheduler.acquire(
+        request(`key-${index}`, async () => result(`url-${index}`, 3, disposals[index])),
+        vi.fn(),
+      );
+      await flush();
+      lease.release();
+    }
+
+    expect(scheduler.getDiagnostics()).toMatchObject({ cacheEntries: 2, cacheBytes: 6 });
+    expect(disposals[0]).toHaveBeenCalledTimes(1);
+    expect(disposals[1]).not.toHaveBeenCalled();
+    expect(disposals[2]).not.toHaveBeenCalled();
+  });
+
+  it("keeps failed requests quiet until the TTL expires", async () => {
+    vi.useFakeTimers();
+    const scheduler = new ThumbnailScheduler(
+      resolveTimelineViewportBudgets({ metadataFailureTtlMs: 100 }),
+    );
+    const load = vi.fn(async () => {
+      throw new Error("unsupported");
+    });
+
+    const first = scheduler.acquire(request("failed", load), vi.fn());
+    await flush();
+    first.release();
+    const second = scheduler.acquire(request("failed", load), vi.fn());
+    expect(load).toHaveBeenCalledTimes(1);
+    second.release();
+
+    vi.advanceTimersByTime(101);
+    scheduler.acquire(request("failed", load), vi.fn());
+    await flush();
+    expect(load).toHaveBeenCalledTimes(2);
+    vi.useRealTimers();
+  });
+});
+
+describe("createThumbnailKey", () => {
+  it("normalizes field order and preserves sentinel zero values", () => {
+    expect(createThumbnailKey({ source: "clip a", time: 0, missing: undefined })).toBe(
+      createThumbnailKey({ time: 0, source: "clip a" }),
+    );
+  });
+});
diff --git a/packages/studio/src/player/lib/thumbnailScheduler.ts b/packages/studio/src/player/lib/thumbnailScheduler.ts
new file mode 100644
index 0000000000..75ad9f9348
--- /dev/null
+++ b/packages/studio/src/player/lib/thumbnailScheduler.ts
@@ -0,0 +1,425 @@
+import { TIMELINE_VIEWPORT_BUDGETS, type TimelineViewportBudgets } from "./timelineViewportBudgets";
+
+export type ThumbnailPriority = "overscan" | "visible" | "interaction";
+export type ThumbnailJobKind = "video" | "image" | "composition" | "waveform";
+
+export type ThumbnailValue =
+  | { kind: "image"; url: string; aspect: number }
+  | { kind: "filmstrip"; urls: readonly string[]; aspect: number }
+  | { kind: "waveform"; peaks: readonly number[] };
+
+export interface ThumbnailLoadedResult {
+  value: ThumbnailValue;
+  /** Estimated decoded/object-URL bytes retained by this result. */
+  weight: number;
+  dispose?: () => void;
+}
+
+export interface ThumbnailRequest {
+  key: string;
+  projectId: string;
+  sessionEpoch: number;
+  kind: ThumbnailJobKind;
+  priority: ThumbnailPriority;
+  /** Rich work is paused while the timeline is fast-scrolling. */
+  rich?: boolean;
+  load: (signal: AbortSignal) => Promise<ThumbnailLoadedResult>;
+}
+
+export type ThumbnailSnapshot =
+  | { status: "idle" | "queued" | "loading" }
+  | { status: "ready"; value: ThumbnailValue }
+  | { status: "error"; error: Error };
+
+export interface ThumbnailLease {
+  updatePriority(priority: ThumbnailPriority): void;
+  release(): void;
+}
+
+export interface ThumbnailSchedulerDiagnostics {
+  queued: number;
+  active: number;
+  leases: number;
+  cacheEntries: number;
+  cacheBytes: number;
+  waveformCacheEntries: number;
+  waveformCacheBytes: number;
+  activeByKind: Readonly<Record<ThumbnailJobKind, number>>;
+}
+
+type EntryState = "queued" | "loading" | "ready" | "error";
+
+interface ThumbnailEntry {
+  request: ThumbnailRequest;
+  scopedKey: string;
+  state: EntryState;
+  leases: Map<number, ThumbnailPriority>;
+  listeners: Map<number, () => void>;
+  controller: AbortController | null;
+  value?: ThumbnailValue;
+  error?: Error;
+  failedAt?: number;
+  weight: number;
+  dispose?: () => void;
+  disposed: boolean;
+  cached: boolean;
+  lastAccess: number;
+  snapshot: ThumbnailSnapshot;
+}
+
+const PRIORITY_SCORE: Readonly<Record<ThumbnailPriority, number>> = {
+  overscan: 0,
+  visible: 1,
+  interaction: 2,
+};
+
+const EMPTY_SNAPSHOT: ThumbnailSnapshot = Object.freeze({ status: "idle" });
+
+function concurrencyBucket(kind: ThumbnailJobKind): "video" | "composition" | "general" {
+  if (kind === "video") return "video";
+  if (kind === "composition") return "composition";
+  return "general";
+}
+
+function errorFrom(reason: unknown): Error {
+  return reason instanceof Error ? reason : new Error(String(reason));
+}
+
+export function createThumbnailKey(parts: Readonly<Record<string, string | number | undefined>>) {
+  return Object.entries(parts)
+    .filter((entry): entry is [string, string | number] => entry[1] !== undefined)
+    .sort(([left], [right]) => left.localeCompare(right))
+    .map(([name, value]) => `${encodeURIComponent(name)}=${encodeURIComponent(String(value))}`)
+    .join("&");
+}
+
+/** Sole client owner for thumbnail work, cached resources, and cleanup. */
+export class ThumbnailScheduler {
+  private readonly entries = new Map<string, ThumbnailEntry>();
+  private readonly budgets: Readonly<TimelineViewportBudgets>;
+  private nextLeaseId = 1;
+  private nextSequence = 1;
+  private scrolling = false;
+  private cacheBytes = 0;
+  private waveformCacheBytes = 0;
+  private readonly activeByBucket = { video: 0, composition: 0, general: 0 };
+  private readonly activeByKind: Record<ThumbnailJobKind, number> = {
+    video: 0,
+    image: 0,
+    composition: 0,
+    waveform: 0,
+  };
+  private readonly now: () => number;
+
+  constructor(
+    budgets: Readonly<TimelineViewportBudgets> = TIMELINE_VIEWPORT_BUDGETS,
+    now: () => number = Date.now,
+  ) {
+    this.budgets = budgets;
+    this.now = now;
+  }
+
+  acquire(request: ThumbnailRequest, listener: () => void): ThumbnailLease {
+    const scopedKey = this.scopedKey(request);
+    let entry = this.entries.get(scopedKey);
+    if (
+      entry?.state === "error" &&
+      entry.failedAt !== undefined &&
+      this.now() - entry.failedAt >= this.budgets.metadataFailureTtlMs
+    ) {
+      this.deleteEntry(scopedKey, entry);
+      entry = undefined;
+    }
+    if (!entry) {
+      entry = {
+        request,
+        scopedKey,
+        state: "queued",
+        leases: new Map(),
+        listeners: new Map(),
+        controller: null,
+        weight: 0,
+        disposed: false,
+        cached: false,
+        lastAccess: this.nextSequence++,
+        snapshot: Object.freeze({ status: "queued" }),
+      };
+      this.entries.set(scopedKey, entry);
+    } else if (
+      entry.request.kind !== request.kind ||
+      Boolean(entry.request.rich) !== Boolean(request.rich)
+    ) {
+      throw new Error(`Thumbnail key collision for ${request.key}`);
+    }
+
+    const leaseId = this.nextLeaseId++;
+    entry.leases.set(leaseId, request.priority);
+    entry.listeners.set(leaseId, listener);
+    entry.lastAccess = this.nextSequence++;
+    this.pump();
+
+    let released = false;
+    return {
+      updatePriority: (priority) => {
+        const current = this.entries.get(scopedKey);
+        if (!current || !current.leases.has(leaseId)) return;
+        current.leases.set(leaseId, priority);
+        current.lastAccess = this.nextSequence++;
+        this.pump();
+      },
+      release: () => {
+        if (released) return;
+        released = true;
+        const current = this.entries.get(scopedKey);
+        if (!current) return;
+        current.leases.delete(leaseId);
+        current.listeners.delete(leaseId);
+        if (current.leases.size === 0) {
+          if (current.state === "queued") {
+            this.deleteEntry(scopedKey, current);
+          } else if (current.state === "loading") {
+            current.controller?.abort();
+            this.deleteEntry(scopedKey, current);
+          } else if (current.state === "ready" && !current.cached) {
+            this.deleteEntry(scopedKey, current);
+          }
+        }
+        this.evict();
+      },
+    };
+  }
+
+  getSnapshot(
+    request: Pick<ThumbnailRequest, "key" | "projectId" | "sessionEpoch">,
+  ): ThumbnailSnapshot {
+    const entry = this.entries.get(this.scopedKey(request));
+    if (!entry) return EMPTY_SNAPSHOT;
+    return entry.snapshot;
+  }
+
+  setScrolling(scrolling: boolean): void {
+    if (this.scrolling === scrolling) return;
+    this.scrolling = scrolling;
+    if (!scrolling) this.pump();
+  }
+
+  invalidateProject(projectId: string): void {
+    for (const [key, entry] of this.entries) {
+      if (entry.request.projectId !== projectId) continue;
+      entry.controller?.abort();
+      this.deleteEntry(key, entry);
+    }
+  }
+
+  clear(): void {
+    for (const [key, entry] of this.entries) {
+      entry.controller?.abort();
+      this.deleteEntry(key, entry);
+    }
+  }
+
+  getDiagnostics(): ThumbnailSchedulerDiagnostics {
+    let queued = 0;
+    let active = 0;
+    let leases = 0;
+    let cacheEntries = 0;
+    let waveformCacheEntries = 0;
+    for (const entry of this.entries.values()) {
+      if (entry.state === "queued") queued++;
+      if (entry.state === "loading") active++;
+      if (entry.cached) {
+        if (entry.request.kind === "waveform") waveformCacheEntries++;
+        else cacheEntries++;
+      }
+      leases += entry.leases.size;
+    }
+    return {
+      queued,
+      active,
+      leases,
+      cacheEntries,
+      cacheBytes: this.cacheBytes,
+      waveformCacheEntries,
+      waveformCacheBytes: this.waveformCacheBytes,
+      activeByKind: { ...this.activeByKind },
+    };
+  }
+
+  private pump(): void {
+    const queued = Array.from(this.entries.values())
+      .filter((entry) => entry.state === "queued" && entry.leases.size > 0)
+      .sort((left, right) => {
+        const priorityDelta = this.entryPriority(right) - this.entryPriority(left);
+        return priorityDelta || left.lastAccess - right.lastAccess;
+      });
+
+    for (const entry of queued) {
+      if (this.scrolling && entry.request.rich) continue;
+      const bucket = concurrencyBucket(entry.request.kind);
+      if (this.activeByBucket[bucket] >= this.bucketLimit(bucket)) continue;
+      this.start(entry, bucket);
+    }
+  }
+
+  private start(entry: ThumbnailEntry, bucket: "video" | "composition" | "general"): void {
+    entry.state = "loading";
+    entry.snapshot = Object.freeze({ status: "loading" });
+    const controller = new AbortController();
+    entry.controller = controller;
+    this.activeByBucket[bucket]++;
+    this.activeByKind[entry.request.kind]++;
+    this.notify(entry);
+
+    let pending: Promise<ThumbnailLoadedResult>;
+    try {
+      pending = entry.request.load(controller.signal);
+    } catch (reason) {
+      pending = Promise.reject(reason);
+    }
+    void pending
+      .then((result) => {
+        if (controller.signal.aborted || this.entries.get(entry.scopedKey) !== entry) {
+          this.safeDispose(result.dispose);
+          return;
+        }
+        if (!Number.isFinite(result.weight) || result.weight < 0) {
+          this.safeDispose(result.dispose);
+          throw new RangeError("Thumbnail result weight must be finite and non-negative");
+        }
+        entry.state = "ready";
+        entry.value = result.value;
+        entry.weight = Math.max(0, result.weight);
+        entry.dispose = result.dispose;
+        const isWaveform = entry.request.kind === "waveform";
+        const cacheBudget = isWaveform
+          ? this.budgets.waveformCacheBytes
+          : this.budgets.thumbnailCacheBytes;
+        entry.cached = entry.weight <= cacheBudget;
+        if (entry.cached) {
+          if (isWaveform) this.waveformCacheBytes += entry.weight;
+          else this.cacheBytes += entry.weight;
+        }
+        entry.snapshot = Object.freeze({ status: "ready", value: result.value });
+        this.notify(entry);
+        this.evict();
+        if (!entry.cached && entry.leases.size === 0) this.deleteEntry(entry.scopedKey, entry);
+      })
+      .catch((reason: unknown) => {
+        if (this.entries.get(entry.scopedKey) !== entry) return;
+        if (controller.signal.aborted && entry.leases.size === 0) {
+          this.deleteEntry(entry.scopedKey, entry);
+          return;
+        }
+        entry.state = "error";
+        entry.error = errorFrom(reason);
+        entry.failedAt = this.now();
+        entry.snapshot = Object.freeze({ status: "error", error: entry.error });
+        this.notify(entry);
+        this.evictFailures();
+      })
+      .finally(() => {
+        if (entry.controller === controller) entry.controller = null;
+        this.activeByBucket[bucket]--;
+        this.activeByKind[entry.request.kind]--;
+        this.pump();
+      });
+  }
+
+  private entryPriority(entry: ThumbnailEntry): number {
+    let score = -1;
+    for (const priority of entry.leases.values()) {
+      score = Math.max(score, PRIORITY_SCORE[priority]);
+    }
+    return score;
+  }
+
+  private bucketLimit(bucket: "video" | "composition" | "general"): number {
+    if (bucket === "video") return this.budgets.concurrentVideoDecodes;
+    if (bucket === "composition") return this.budgets.concurrentCompositionFetches;
+    return this.budgets.concurrentMetadataJobs;
+  }
+
+  private evict(): void {
+    this.evictPartition(false);
+    this.evictPartition(true);
+  }
+
+  private evictPartition(waveform: boolean): void {
+    const cached = Array.from(this.entries.values()).filter(
+      (entry) => entry.cached && (entry.request.kind === "waveform") === waveform,
+    );
+    const perProject = new Map<string, number>();
+    for (const entry of cached) {
+      perProject.set(entry.request.projectId, (perProject.get(entry.request.projectId) ?? 0) + 1);
+    }
+    cached.sort((left, right) => left.lastAccess - right.lastAccess);
+
+    let cacheEntries = cached.length;
+    for (const entry of cached) {
+      const projectEntries = perProject.get(entry.request.projectId) ?? 0;
+      const overBudget =
+        cacheEntries >
+          (waveform ? this.budgets.waveformCacheEntries : this.budgets.thumbnailCacheEntries) ||
+        (waveform ? this.waveformCacheBytes : this.cacheBytes) >
+          (waveform ? this.budgets.waveformCacheBytes : this.budgets.thumbnailCacheBytes) ||
+        (!waveform && projectEntries > this.budgets.thumbnailCacheEntriesPerProject);
+      if (!overBudget) continue;
+      entry.cached = false;
+      if (waveform) this.waveformCacheBytes -= entry.weight;
+      else this.cacheBytes -= entry.weight;
+      cacheEntries--;
+      perProject.set(entry.request.projectId, projectEntries - 1);
+      if (entry.leases.size === 0) this.deleteEntry(entry.scopedKey, entry);
+    }
+  }
+
+  private notify(entry: ThumbnailEntry): void {
+    for (const listener of new Set(entry.listeners.values())) listener();
+  }
+
+  private deleteEntry(key: string, entry: ThumbnailEntry): void {
+    if (this.entries.get(key) !== entry) return;
+    entry.snapshot = EMPTY_SNAPSHOT;
+    this.notify(entry);
+    this.entries.delete(key);
+    if (entry.cached) {
+      entry.cached = false;
+      if (entry.request.kind === "waveform") this.waveformCacheBytes -= entry.weight;
+      else this.cacheBytes -= entry.weight;
+    }
+    if (!entry.disposed) {
+      entry.disposed = true;
+      this.safeDispose(entry.dispose);
+    }
+    entry.listeners.clear();
+    entry.leases.clear();
+  }
+
+  private evictFailures(): void {
+    const failed = Array.from(this.entries.values())
+      .filter((entry) => entry.state === "error" && entry.leases.size === 0)
+      .sort((left, right) => left.lastAccess - right.lastAccess);
+    const overflow = failed.length - this.budgets.thumbnailCacheEntries;
+    for (const entry of failed.slice(0, Math.max(0, overflow))) {
+      this.deleteEntry(entry.scopedKey, entry);
+    }
+  }
+
+  private safeDispose(dispose: (() => void) | undefined): void {
+    try {
+      dispose?.();
+    } catch {
+      // Cleanup is best-effort; one broken resource must not block the remaining cleanup.
+    }
+  }
+
+  private scopedKey(request: Pick<ThumbnailRequest, "key" | "projectId" | "sessionEpoch">) {
+    return createThumbnailKey({
+      project: request.projectId,
+      session: request.sessionEpoch,
+      request: request.key,
+    });
+  }
+}
+
+export const thumbnailScheduler = new ThumbnailScheduler();
diff --git a/packages/studio/src/player/store/playerStore.ts b/packages/studio/src/player/store/playerStore.ts
index 4809ae6b8a..7529c15c9a 100644
--- a/packages/studio/src/player/store/playerStore.ts
+++ b/packages/studio/src/player/store/playerStore.ts
@@ -6,6 +6,7 @@ import { readStudioUiPreferences, writeStudioUiPreferences } from "../../utils/s
 import { computePinnedZoomPercent } from "../components/timelineZoom";
 import { createKeyframeSlice, type KeyframeSlice } from "./keyframeSlice";
 import { createTimelineFocusRequest, type TimelineFocusRequest } from "./timelineFocusState";
+import { defaultThumbnailMode, type ThumbnailMode } from "../lib/thumbnailPolicy";
 
 export type { KeyframeCacheEntry } from "./keyframeSlice";
 export { liveTime } from "./liveTime";
@@ -109,6 +110,7 @@ interface PlayerState extends KeyframeSlice {
   timelineProjectId: string | null;
   /** True while a beat dot is being dragged — hides the playhead guideline. */
   beatDragging: boolean;
+  thumbnailMode: ThumbnailMode;
   elements: TimelineElement[];
   selectedElementId: string | null;
   playbackRate: number;
@@ -187,6 +189,7 @@ interface PlayerState extends KeyframeSlice {
   setPlaybackRate: (rate: number) => void;
   setAudioMuted: (muted: boolean) => void;
   setLoopEnabled: (enabled: boolean) => void;
+  setThumbnailMode: (mode: ThumbnailMode) => void;
   setTimelineReady: (ready: boolean) => void;
   setBeatDragging: (dragging: boolean) => void;
   setElements: (elements: TimelineElement[]) => void;
@@ -313,6 +316,7 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
   timelineSessionEpoch: 0,
   timelineProjectId: null,
   beatDragging: false,
+  thumbnailMode: defaultThumbnailMode(readStudioUiPreferences().thumbnailMode),
   elements: [],
   selectedElementId: null,
   playbackRate: readStudioUiPreferences().playbackRate ?? 1,
@@ -446,6 +450,10 @@ export const usePlayerStore = create<PlayerState>((set, get) => ({
     set({ audioMuted: muted });
   },
   setLoopEnabled: (enabled) => set({ loopEnabled: enabled }),
+  setThumbnailMode: (mode) => {
+    writeStudioUiPreferences({ thumbnailMode: mode });
+    set({ thumbnailMode: mode });
+  },
   setZoomMode: (mode) => set({ zoomMode: mode }),
   clearSelectedElementIds: () => set({ selectedElementIds: new Set() }),
   setSelectedElementIds: (ids: Set<string>) => set({ selectedElementIds: new Set(ids) }),
diff --git a/packages/studio/src/utils/studioUiPreferences.test.ts b/packages/studio/src/utils/studioUiPreferences.test.ts
index 982a10bc61..39b4c5ec3d 100644
--- a/packages/studio/src/utils/studioUiPreferences.test.ts
+++ b/packages/studio/src/utils/studioUiPreferences.test.ts
@@ -70,6 +70,20 @@ describe("timelineSnapEnabled preference", () => {
   });
 });
 
+describe("thumbnailMode preference", () => {
+  it("round-trips the adaptive mode", () => {
+    const storage = createStorage();
+    writeStudioUiPreferences({ thumbnailMode: "adaptive" }, storage);
+    expect(readStudioUiPreferences(storage).thumbnailMode).toBe("adaptive");
+  });
+
+  it("migrates the legacy boolean without retaining two owners", () => {
+    const storage = createStorage();
+    storage.setItem("hf-studio-ui-preferences", JSON.stringify({ thumbnailsEnabled: false }));
+    expect(readStudioUiPreferences(storage).thumbnailMode).toBe("hidden");
+  });
+});
+
 describe("timeline zoom pin persistence", () => {
   it("round-trips a pinned manual zoom (survives the post-edit reload)", () => {
     const storage = createStorage();
diff --git a/packages/studio/src/utils/studioUiPreferences.ts b/packages/studio/src/utils/studioUiPreferences.ts
index c2bfe7a537..9faf1acf42 100644
--- a/packages/studio/src/utils/studioUiPreferences.ts
+++ b/packages/studio/src/utils/studioUiPreferences.ts
@@ -12,6 +12,7 @@ export interface StudioUiPreferences {
   timelineHeight?: number;
   playbackRate?: number;
   audioMuted?: boolean;
+  thumbnailMode?: "adaptive" | "hidden";
   previewZoom?: StoredPreviewZoomState;
   recentBlocks?: string[];
   snapEnabled?: boolean;
@@ -78,6 +79,11 @@ function readStorage(storage: Storage | null): StudioUiPreferences {
     if (typeof parsed.audioMuted === "boolean") {
       preferences.audioMuted = parsed.audioMuted;
     }
+    if (parsed.thumbnailMode === "adaptive" || parsed.thumbnailMode === "hidden") {
+      preferences.thumbnailMode = parsed.thumbnailMode;
+    } else if (typeof parsed.thumbnailsEnabled === "boolean") {
+      preferences.thumbnailMode = parsed.thumbnailsEnabled ? "adaptive" : "hidden";
+    }
     if (isRecord(parsed.previewZoom)) {
       const { zoomPercent, panX, panY } = parsed.previewZoom;
       if (