---
name: list-handoff
description: Animate a shared preparation list into one destination with an editable SVG connection and GSAP timeline.
version: 1.0.0
---
# List Handoff
Use this parameterized renderer for preparation, readiness and handover explanations. It produces one seven-second 1920×1080 shot. Multiple rows remain inside one enclosure; a single bridge grows from that enclosure, then a destination emblem arrives and the relationship holds for reading.

Install Node.js 22 and run `npm ci` in this directory. Create a UTF-8 JSON brief with `heading`, `group`, `entries`, `outcome`, `caption`, `emblem` and `palette`. Entries must contain 2–6 non-empty strings. Count each Chinese character as two units and other characters as one: entries allow 30 units, heading 48, group 40, outcome and caption 20. These limits reserve space for reading and connector geometry. Choose emblem `shore`, `observatory` or `muster`; choose palette `tidal`, `orbit`, `kiln` or `mono`. Additional subject glyphs require authoring an SVG path in the generator.

Run `node scripts/compose.mjs brief.json output/film`. Render with `npx hyperframes render output/film --output output/film.mp4 --fps 30 --quality high --strict`. HyperFrames 0.8.30 and GSAP 3.13.0 are pinned. Browser and FFmpeg availability remain runtime prerequisites. Dependency installation needs npm registry access. Generated projects bundle their own JS and Noto Sans SC font files.

The output is editable HTML/SVG. Change the brief rather than hardcoding subject copy into the runtime. Preview with the HyperFrames tools. The registered GSAP timeline supports absolute seeking; `window.seek(seconds)` is available for diagnostics. Rows finish before the bridge grows. The endpoint is outside the destination circle so that the arrow has breathing space. No independent edges connect individual rows.

The default output has no audio. Add licensed or original audio through a separate editable audio workflow if required; silent output does not establish soundtrack quality. Validate all changed content at native resolution, test CJK and maximum row counts, compare forward/backward/repeated seeks, and watch the final encoded movie at 1×. Inspect the installed dependency licenses before redistribution. This is a bounded diagram renderer, not an automatic authoring tool for arbitrary films.