|
| 1 | +<!doctype html> |
| 2 | +<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>New-track membership contract</title><style> |
| 3 | +:root{color-scheme:light dark; |
| 4 | + --bg:#fbfbfa;--card:#ffffff;--line:#e6e4df;--ink:#1c1c1a;--dim:#6b6b66;--faint:#9a9a94; |
| 5 | + --go:#178a5a;--go-bg:#e8f6ee;--warn:#a6690a;--warn-bg:#fbf1dc;--bad:#c0392b;--bad-bg:#fbe7e4;--info:#2a5db0;--info-bg:#e8eefb; |
| 6 | + --mono:ui-monospace,SFMono-Regular,Menlo,monospace;--sans:-apple-system,BlinkMacSystemFont,"Segoe UI",Inter,sans-serif} |
| 7 | +@media (prefers-color-scheme:dark){:root{--bg:#111213;--card:#191b1d;--line:#2a2d31;--ink:#ecebe8;--dim:#a2a29c;--faint:#6f6f6a; |
| 8 | + --go:#5fd39a;--go-bg:#12291f;--warn:#e6b35a;--warn-bg:#2b2311;--bad:#ff7b6b;--bad-bg:#2d1714;--info:#7fa9ff;--info-bg:#15203a}} |
| 9 | +*{box-sizing:border-box} |
| 10 | +body{margin:0;background:var(--bg);color:var(--ink);font:16px/1.55 var(--sans)} |
| 11 | +.wrap{max-width:900px;margin:0 auto;padding:56px 24px 96px} |
| 12 | +header h1{font-size:30px;line-height:1.15;letter-spacing:-.4px;margin:0 0 10px} |
| 13 | +header .what{font-size:18px;color:var(--dim);margin:0 0 18px;max-width:70ch} |
| 14 | +.strip{display:flex;gap:10px;flex-wrap:wrap;align-items:center;font:13px var(--mono);color:var(--faint)} |
| 15 | +.strip .sep{opacity:.5} |
| 16 | +.pill{display:inline-flex;align-items:center;gap:6px;font:600 12px/1 var(--mono);padding:6px 10px;border-radius:999px;white-space:nowrap} |
| 17 | +.pill.go{color:var(--go);background:var(--go-bg)}.pill.warn{color:var(--warn);background:var(--warn-bg)} |
| 18 | +.pill.bad{color:var(--bad);background:var(--bad-bg)}.pill.info{color:var(--info);background:var(--info-bg)} |
| 19 | +.pill b{font-size:13px} |
| 20 | +section{margin-top:56px} |
| 21 | +h2{font-size:22px;letter-spacing:-.3px;margin:0 0 6px} |
| 22 | +.sub{color:var(--dim);margin:0 0 18px;font-size:15px} |
| 23 | +.card{background:var(--card);border:1px solid var(--line);border-radius:14px;padding:20px 22px;margin:14px 0} |
| 24 | +.breath{border-left:4px solid var(--go);font-size:18px;line-height:1.5} |
| 25 | +.breath b{color:var(--go)} |
| 26 | +.plain{color:var(--dim);font-size:15px;margin:0 0 10px} |
| 27 | +.plain::before{content:"In plain words ";font:600 11px var(--mono);letter-spacing:1px;color:var(--faint);text-transform:uppercase} |
| 28 | +pre{background:var(--bg);border:1px solid var(--line);border-radius:10px;padding:14px 16px;overflow:auto;font:13px/1.55 var(--mono);margin:10px 0} |
| 29 | +code{font:13px var(--mono);background:var(--bg);border:1px solid var(--line);border-radius:5px;padding:1px 6px} |
| 30 | +.cite{font:12px var(--mono);color:var(--faint);margin-top:8px;display:block} |
| 31 | +.states{display:flex;gap:8px;margin:12px 0 4px;flex-wrap:wrap} |
| 32 | +table{width:100%;border-collapse:collapse;margin:10px 0;font-size:14.5px} |
| 33 | +th{text-align:left;font:600 11px/1.4 var(--mono);text-transform:uppercase;letter-spacing:.7px;color:var(--faint);border-bottom:1px solid var(--line);padding:8px 10px} |
| 34 | +td{padding:10px;border-bottom:1px solid var(--line);vertical-align:top} |
| 35 | +tr:last-child td{border-bottom:0} |
| 36 | +td.k{font:13px var(--mono);white-space:nowrap} |
| 37 | +.decision{border-left:4px solid var(--info)} |
| 38 | +.decision h3{margin:0 0 8px;font-size:17px} |
| 39 | +.decision .ask{color:var(--info);font-weight:600} |
| 40 | +blockquote{margin:12px 0;padding:8px 0 8px 16px;border-left:2px solid var(--line);color:var(--dim);font-style:italic;font-size:14.5px} |
| 41 | +blockquote .src{display:block;font-style:normal;font:12px var(--mono);color:var(--faint);margin-top:6px} |
| 42 | +ul,ol{padding-left:22px}li{margin:6px 0} |
| 43 | +.flow{display:flex;flex-wrap:wrap;gap:10px;align-items:center;background:var(--card);border:1px solid var(--line);border-radius:14px;padding:18px;margin:14px 0;overflow:auto} |
| 44 | +.flow span{border:1px solid var(--line);padding:12px;border-radius:8px} |
| 45 | +footer{margin-top:72px;padding-top:16px;border-top:1px solid var(--line);font:12px/1.7 var(--mono);color:var(--faint)} |
| 46 | +</style></head><body><main class="wrap"><header><h1>New-track drops leave an audio group</h1><p class="what">A clip lands exactly where the ghost showed. One undo restores its track and membership.</p><div class="strip"><span class="pill go">audited 5</span><span class="pill warn">trusting 0</span><span class="pill bad">not exercised 1</span><span class="pill info">open decisions 0</span><span>hyperframes @ de13693179f53c3f625b7b501f1f5fc7b083b6c9, working changes, 2026-10-02</span></div></header> |
| 47 | +<section><div class="card breath"><b>In one breath.</b> At the audited base, the move transaction saved track and timing but dropped membership before persistence. Detachment must travel through that transaction, rather than become a second save.</div></section> |
| 48 | +<section><h2>Where the value travels</h2><div class="flow" aria-label="One transaction carries drop fields into undo"><span>Drop edits</span> → <span>Move adapter</span> → <span>Source patch</span> → <span>File + history</span> → <span>Undo restore</span></div></section> |
| 49 | +<section><h2>The contract, per boundary</h2> |
| 50 | +<div class="card"><h3>Move payload</h3><p class="plain">At the audited base, membership was absent from the move payload. The adapter explicitly selects only these fields.</p><pre>edits.map(({ element, updates }) => ({ |
| 51 | + element, |
| 52 | + start: updates.start, |
| 53 | + track: operation === "timing" ? undefined : updates.track, |
| 54 | +}))</pre><span class="cite">producer src/player/components/timelineClipDragCommit.ts:153; consumer src/hooks/timelineMoveAdapter.ts:37. Paths relative to packages/studio.</span><div class="states"><span class="pill bad">membership: absent</span><span class="pill bad">reachable: no</span><span class="pill bad">written: no</span></div></div> |
| 55 | +<div class="card"><h3>Atomic source edit</h3><p class="plain">The group move turns all clip changes into source patches inside one queued file transaction. Track changes bypass the timing-only SDK path.</p><pre>buildTimelineMoveTimingPatch( |
| 56 | + original, |
| 57 | + target, |
| 58 | + toAuthoredStart(change.element, change.start), |
| 59 | + change.element.duration, |
| 60 | + change.track, |
| 61 | +)</pre><span class="cite">producer src/hooks/useTimelineGroupEditing.ts:311; consumer src/hooks/timelineEditingHelpers.ts:235. SDK eligibility src/hooks/useTimelineGroupEditing.ts:299.</span><div class="states"><span class="pill go">track: exists</span><span class="pill go">reachable</span><span class="pill go">written</span></div></div> |
| 62 | +<div class="card"><h3>Undo owns whole-file snapshots</h3><p class="plain">One transaction records the complete before and after source. Including membership in the same patch gives undo its original value.</p><pre>snapshots[path] = { before, after }; |
| 63 | +await recordEdit({ label, coalesceKey, coalesceMs, files: snapshots });</pre><span class="cite">producer src/utils/studioFileHistory.ts:128,144; undo consumer src/hooks/usePersistentEditHistory.ts:81,99; preview sync consumer src/hooks/useEditHistoryActions.ts:112.</span><div class="states"><span class="pill go">snapshots: exist</span><span class="pill go">reachable</span><span class="pill go">written and restored</span></div></div></section> |
| 64 | +<section><h2>How it says no</h2><table><tr><th>Signal</th><th>Meaning and response</th></tr><tr><td>Locked shifted clip</td><td>Insertion returns without persistence. Existing permission rules remain the owner.</td></tr><tr><td>Save rejection</td><td>The file transaction restores already-written snapshots and rethrows. The optimistic clip rollback must restore membership alongside timing and track.</td></tr><tr><td>Undo content mismatch</td><td>History refuses to overwrite a file changed since the edit and reports the conflict.</td></tr></table></section> |
| 65 | +<section><h2>Decision already supplied</h2><div class="card decision">New tracks outside a group detach the dragged clip. Drops onto member tracks retain existing behavior. Cmd+Z restores membership. There is no open product decision.</div></section> |
| 66 | +<section><h2>Coverage, honestly</h2><table><tr><th>Label</th><th>Coverage</th></tr><tr><td>Audited</td><td>Drop edits, adapter, group move, source patch, snapshot and undo consumers opened at the named base.</td></tr><tr><td>Not exercised</td><td>This page records the pre-implementation audit. Runtime proof is reported separately against the implementation head.</td></tr></table></section> |
| 67 | +<section><h2>What would prove this page wrong</h2><p>Drop a grouped clip at a group edge, reload the file, then Cmd+Z. The clip must lose membership after the drop, occupy the promised lane, and regain its original track and membership in one undo. A member-track drop must retain membership.</p></section></main></body></html> |
0 commit comments