{"id":20889,"plugin_id":"plugins_6aa93d4d067c8191bdd2a1969bee8916","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:16:38.165Z","digest":"9ac3770885d863230dd3907244c7abdbedee9580e66df01c0821ddab3cd68288","against":null,"payload":{"description":"Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.","included_files":[],"name":"seam-craft","skill_md_contents":"---\nname: seam-craft\ndescription: Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.\n---\n\n> Modified by Juicy Lucy AI, UAB for JuicyLucy Ads: CLI invocation, the review-approval reference and/or frontmatter (description layout, upstream-only metadata) adjusted at build time. See the plugin root NOTICE for details.\n\n\n# Seam Craft — render prerequisites for scene-to-scene transitions\n\nThis is the **render-correctness doctrine** for PLV scene-to-scene seams: the\nprerequisites and master-timeline mechanics that make any transition composite\ncorrectly, independent of which specific transition is chosen. The per-transition\ncatalog (crossfade, push-slide, zoom-through, cut-the-curve, …) lives in the\ntransition registry — this page is the doctrine that sits underneath all of them.\n\nThe transitions this doctrine governs are **Tier-B-ready**: pure transform / opacity /\nfilter on the two scene **clip wrappers** (`#el-`), no injected overlay DOM, no\nper-scene cooperation. Overlay families (staggered blocks, blinds, light leak, grid\ndissolve, page burn) and shader transitions are deferred to later phases.\n\n## Stage ground prerequisite (white-flash guard)\n\nSeveral templates open a window where the two wrappers' summed opacity < 1 (the\ncut-the-curve mid-window cut, zoom-through's 0.15 floor, plain crossfade's\npower-curve dip). Whatever is BEHIND the wrappers shows through during that\nwindow. If the assembled `index.html` `#root` has no opaque background, the\nrenderer composites the dip over its default **white** page → a white flash at\nevery seam, glaring on dark films (observed on two Spotify runs before the fix).\n**The assembler must paint the stage:** `#root { background:\nvar(--canvas-deep, var(--canvas, #000)) }` — `assemble-index.mjs` now emits this;\nany other consumer of these templates owns the same guarantee.\n\n## How the injector applies a transition\n\nAt a `break` boundary between scene _i_ (`from`) and scene _i+1_ (`to`), the\ninjector:\n\n1. Extends `#el-` wrapper `data-duration` by `duration_s` (holds its final\n frame — verified: `core/src/runtime/init.ts:1393-1410` external-slot branch).\n2. Pulls `#el-` wrapper `data-start` earlier by `duration_s` (creates the\n overlap window).\n3. Reassigns **all** clip `data-track-index` as a 0/1 ping-pong so the two\n overlapping wrappers never share a track (same-track overlap is illegal —\n `core/src/lint/rules/composition.ts`). Higher track composites on top.\n4. Stamps the `gsap_template` into `window.__timelines[\"main\"]` at `T = overlap-start`.\n\nVerified by prototype render (2026-05-31): the master-timeline wrapper tween is\nseeked and rendered (no double-seek with the sub-comp's own paused timeline —\nthe runtime drives them independently), the extended wrapper holds scene _i_'s\nfinal frame, and the higher-track incoming wrapper composites over + blends with\nthe outgoing one.\n\n## Template placeholders\n\nThe injector substitutes these tokens in each `gsap_template` line:\n\n| Token | Meaning |\n| ---------------------------------- | ------------------------------------------------------------------------ |\n| `__OLD__` | `\"#el-\"` — outgoing clip wrapper selector (quoted) |\n| `__NEW__` | `\"#el-\"` — incoming clip wrapper selector (quoted) |\n| `__T__` | overlap-start time in seconds (master clock) |\n| `__DUR__` | `duration_s` for this boundary |\n| `__DX__` | horizontal travel for directional types: `-1920` (LEFT) / `1920` (RIGHT) |\n| `__DY__` | vertical travel: `-1080` (UP) / `1080` (DOWN) |\n| `__ORIGIN_OUT__` / `__ORIGIN_IN__` | transformOrigin pair for `squeeze` |\n\n`filter` / `scaleX` / `transformOrigin` are lint-clean on the master timeline\n(verified: `core/src/lint/rules/gsap.ts` has no per-property whitelist and scopes\nits checks to `data-composition-id` ranges; the x/y/scale/rotation/opacity\nwhitelist is a _scene-worker_ prompt rule only — it does not bind index.html).\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}