dsh-drawai 0.3.3 → 0.4.0

package/lib/motion/shotcraft/upstream/references/shots/typography/outline-word-fill.md

@@ -0,0 +1,66 @@
+---
+name: outline-word-fill
+一句话: 空心词（细暖灰描边、500 字重）从 3.2 倍急缓收缩落位，虚线大圆随后从 2.8 倍收到字周围并缓慢自转，左右水平虚线从画框边缘内伸；描边先微微增亮，实心白热字在一帧内硬切点亮，一闪辉光即定格
+适用: 单词式利益点/口号的重锤一拍；节奏卡点上的"钉子"镜；深底品牌片的强调帧
+时长: 约 3.0s（90f@30fps，短促单拍 + 36f 落定）
+能量: 高（3.2 倍收缩 + 瞬时点亮，短时高冲击）
+---
+
+## 意图
+一个词要打成钉子，靠的不是慢慢淡入而是**两次落定**：先是巨大空心字
+急速收缩到位（这是尺寸的落定），再是描边在一帧内变实心白（这是质感的
+落定）。中间那 1.5s 的虚线圆收缩与水平虚线内伸是"瞄准"过程——技术
+制图语汇，让点亮那一下读作"确认"。填充**必须是瞬时**的：慢扫填充会把
+钉子变成缓慢的美化动画。
+
+## 动效核心
+（demo 以 1920×1080 原生坐标、帧号标定；look = ember 暖黑 · 橙）
+- 空心字急缓收缩：`scale = mix(3.2, 1, ramp(f, 2, 11, EASE.snappy))`，2–8f 淡入——
+  **收缩窗只 11f**，快到几乎是一次冲击；按 scale 速度给瞬时失焦（停稳归零）
+- 双层字：`outline`（`color:transparent` + `-webkit-text-stroke:2px` 暖灰）与 `solid`
+  （白热 #fff5ee，初始 opacity 0）叠放，220px / **500 字重** Helvetica Neue
+  （中等字重，不是标题的 800——空心字太粗会糊成块）
+- 虚线大圆（r=410、`dasharray 22 18`）+ 内圈 72 格刻度环（每 30° 一根长刻度，反向慢转）+ 四个套准刻度：
+  8–18f 淡入，`scale 2.8 → 1` 在 8–52f 慢收（EASE.out，**44f，全片最慢的一条曲线**）；主圈 0.22°/f 自转，
+  点亮那一刻刹停（"锁定"），内圈继续慢转让 hold 段画面仍在呼吸
+- 左右水平虚线（`dasharray 14 12`）：28–46f 从画框边缘内伸到圆边外 28px，线端带准星点；
+  线上方 mono 读数「BEFORE 1 week」/「AFTER 4 hrs」——把"更快"讲成一组前后对比数据（手 K 一周 vs video-shotcraft 一下午出片）
+- 描边预热：44–53f 暖灰 → 亮橙白并带一点外发光，给硬切一个"充能"前奏
+- **瞬时填充**：第 54 帧 `lit = frame >= 54 ? 1 : 0`，solid 与 outline 透明度硬切，不存在中间态；
+  同帧圆 / 水平线锁定成橙色、右侧读数变橙
+- 一闪即逝的辉光：`flash = lit · (1 − ramp(f, 54, 8))`，白 14px + 橙 60px 两层 text-shadow，8f 衰完后
+  只留极弱橙晕；一道冲击环从圆边外扩 160px、14f 消散（只此一次）；舞台主光同步脉冲一下
+- 落定：56–70f 圆内眉题（小号 video-shotcraft 标志 + 全小写 mono 字标）/ 副行（40px，"One prompt to a finished promo."）升起，70–90f hold，全程极缓推进 1→1.015
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 收缩 | `scale 3.2 → 1`，窗 11f，snappy | 3.2 倍是"从脸前退开"的量；<2 倍读作普通缩放；窗 >20f 就成了缓慢 zoom，冲击全失 |
+| 字重字号 | 220px / **500**，占画宽约三分之一 | 空心字上 700+ 会让细描边包住一大块空白，读作气球字；500 是空心字的甜点 |
+| 描边 | 2px 暖灰（138,118,104），点亮前预热到亮橙白 | 细描边是"制图"语汇；>4px 变涂鸦；预热那一档删了硬切显得没由来 |
+| 虚线圆 | r=410、`dash 22 18`、scale 2.8→1（44f）、0.22°/f 自转，点亮时刹停 | 44f 慢收缩是全片的"呼吸"，与 11f 的字收缩形成快慢对比；窗压到 20f 两者撞在一起 |
+| 水平虚线 | `dash 14 12`，28–46f 内伸到圆边外 28px | 内伸终点要停在圆边外（不进圆内）；伸满全宽读作十字准星，过头了 |
+| 瞬时填充 | 第 54 帧硬切（按帧判断，不用归一化时间窗） | **这一下是全卡的目的**：任何形式的慢扫（>3f）都会把钉子降级成美化动画 |
+| 辉光 | 白 14px + 橙 60px，8f 衰完；冲击环 14f | 一闪即逝才像"点亮"；持续辉光读作发光字体，质感立刻廉价 |
+| 时长 | 90f（3.0s）：点亮后 hold 36f | 点亮后 <20f 观众来不及读副行与读数 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **只适合单个短词（demo `Faster`，6 字母）**：字号 220 与虚线圆 r=410 是写死的
+  一组坐标，字一长就顶穿圆、水平虚线内伸终点也会压到字上——换成
+  两个词或中文四字须同步调 `SIZE` / `R` / 内伸终点三处
+- `-webkit-text-stroke` 是前缀属性，Chromium/WebKit 才生效；Firefox 下
+  outline 层是全透明（词直到点亮帧才突然出现）。Remotion 走 Chromium 无碍
+- 瞬时填充必须按**帧**硬切（demo `frame >= POP`）。早期版本用归一化时间窗 `seg(0.742, 0.762)`，
+  片长一拉长这个窗就会变成几帧的可见渐变——改时长时只挪 `POP` 帧号
+- 深底专用：暖黑底 + 细描边 + 辉光是效果的全部；浅底上空心字
+  几乎不可见，需整套重配
+- 声音强依赖：点亮那一帧必须有一记短促重音（金属/开关/低频撞击），
+  这是本卡"钉子"感的一半，配法纪律见 sound-design.md；与
+  word-relay-geometry 分工：那卡是三词接力（本卡是它第一段的独立化 +
+  升级版），同片二者不并置
+
+## 参考实现
+demos/typography/outline-word-fill/
+（OutlineWordFill.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/paper-title-card.md

@@ -0,0 +1,38 @@
+---
+name: paper-title-card
+一句话: 一句话逐词压印上纸、一个词标强调色斜体、短划线收束
+适用: 章节转场/价值主张字卡；重要功能出场前的引导卡；全片呼吸位
+时长: 1.7–1.8s（50–55f）
+能量: 低（呼吸位，隔开两段高能镜头）
+标签: transition、rhythm
+---
+
+## 意图
+在两段产品画面之间给观众一句话的喘息：说清"接下来看什么、它值什么"。letterpress 压印质感让字卡与纸墨风格的产品画面同属一个世界。
+
+## 动效核心
+- 单句文案逐词入场：scale 从大压到 1 + blur→0 + opacity（letterpress 压印配方）；demo 文案为 video-shotcraft 口号
+  "Direct the film. / Let the agent shoot it."（强调词 *shoot*），词表可标 `br` 强制换行，两行长度接近、不留孤词
+- 每句恰好一个重点词：italic + 强调色（模板片为琥珀）
+- 强调色短下划线 scaleX 0→1 收束
+- 尾部整卡淡出交棒；可挂 mono 小字副行 + DigitRoll 数字
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 逐词入场 | 第 i 词 delay = 4 + i·4、9f，bezier(0.2,0.75,0.3,1)；scale 1.28→1 + blur 7px→0 + opacity | scale 起点 1.28 是"压印"读感的甜点——对照暗场版 TitleCard 用 40px 上移+blur 10，同配方明暗两版 |
+| 重点词 | italic + 强调色 oklch(52% 0.115 65)，一句恰好一个 accent | 两个 accent 等于没有 accent；重点词选功能名/收益词（C2） |
+| 下划线 | 16→34f scaleX 0→1，220×6px 强调色 | 下划线是收束信号，出现即预告本卡快结束 |
+| 时长 | 全片 4 张字卡均 50–55f（≈1.8s） | 字卡时长定式化——观众读一句话的时间，长了拖节奏短了读不完 |
+| 版式 | 字号 116/serif；纸底 oklch(97.5% 0.008 82) + 中心暖光 radial；尾部 8f 淡出 | 纸底+暖光与产品画面同色系，字卡才不像广告插播 |
+| 副行 | mono 小字 + DigitRoll（demo "12 shots rendered today"）；digit-roll 参数见 list-stack-press 卡计数器行 | 副行给具体数字最有说服力；数字滚动必须在本卡淡出前落定（教训）——排节拍从本卡淡出帧倒推 |
+
+## 声音
+字卡出场统一钉 swoosh-quick（模板片四张字卡钉在 f220/565/725/885 同音）——同类元素同音是词汇表纪律（S2）；字卡本身无落地重音，能量留给前后镜头。
+
+## 已知坑
+- 文案要具体：带产品功能名+具体收益，抽象隐喻词被用户逐字改掉（C2——"one board"→"one place to go"、加 "Paper Radar"）；文案在画面锁定后按最终镜头重写一遍（C1）
+- 重要功能出场前要有引导字卡（C2 判例：文档镜头前应加一句引导，如 "Every project, linked to your weekly report"）——字卡不是装饰，是章节路标
+
+## 参考实现
+demos/typography/paper-title-card/PaperTitleCard.tsx（原 template/src/aifl/PaperTitleCard.tsx，参数化：words/sub/subDigits 可换文案）

package/lib/motion/shotcraft/upstream/references/shots/typography/pill-chip-slot-cycle-handled.md

@@ -0,0 +1,66 @@
+---
+name: pill-chip-slot-cycle-handled
+一句话: 白底句式 "Your `chip` Handled" 里深色胶囊内词竖向滚轮轮换，胶囊宽度按预量文本宽插值平滑伸缩、两侧文字被自然挤开收拢，胶囊上下露出 13% 透明度的灰色幽灵项
+适用: "我们替你搞定 ___" 这类句式卖点；SaaS 功能列举的一句话收口；浅底品牌片主视觉一拍
+时长: 约 5.0s（150f@30fps：静置 → 3 次切换（0.25/0.47/0.69）→ 尾部静置）
+能量: 中（三拍稳定节拍，宽度伸缩是唯一的连续运动）
+---
+
+## 意图
+词槽轮换有两派：让句子躲开变化（宽度固定的滚轮），或者让句子**接受**
+变化（胶囊撑宽、两侧文字被挤开）。这卡是后者，代价是必须把宽度算准，
+回报是句子读起来活的——"Your" 和 "Handled" 被推着走，观众感到胶囊里
+的词有分量。上下露出的灰色幽灵项是第二个记号：它明示"这是个可以滚的
+列表"，让观众预期还有下一个词。
+
+## 动效核心
+- 宽度预量：setup 期用隐藏 `<span>` 逐词量 `offsetWidth`，各加 74px 内边距
+  存成 `widths[]`（带 `o.w.length·13` 兜底，防 setup 时未挂载量不到）
+- 位置量 `pos` 由 3 段窗累加：切换点 `[0.25, 0.47, 0.69]`，每窗 0.12
+  （≈18f），缓动 `E.inOutCubic`——**两头都缓**，对应"滚轮起步与停稳"
+- 内列 `colIn` 竖移 `-pos·48`px（行高 48 = 胶囊高）；胶囊宽度取
+  `lerp(frac, widths[ci], widths[ci+1])`，**帧内插值**所以伸缩是连续的，
+  两侧 `flex:none` 的文字被 flex 布局自然挤开
+- 幽灵项在胶囊外（chipWrap 内）上 -38px / 下 58px，取 `near = round(pos)`
+  的前后邻居文本，随滚动微移 `(pos-near)·48·0.5`（**半速视差**，比胶囊内
+  的词慢一半，才像"外圈"）
+- 幽灵项透明度 `0.13 · (0.4 + settle·0.6)`，`settle = 1 - min(1, |pos-near|·3)`
+  ——滚动中途更淡、落定时最清楚
+- 每行内是 emoji + 词的两段结构（emoji 18px、词 700 22px 白字），
+  胶囊 `#1a1c24` 底 + `0 8px 24px rgba(20,22,40,.22)` 投影 + `overflow:hidden`
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 词表 | 4 词 + emoji（Shots/Camera/Sound/Renders——video-shotcraft 包办的镜头/运镜/音效/渲染），3 次切换 | 词长差决定挤开幅度的观感：demo 最短 5 字母最长 7 字母；差 >2 倍胶囊跳变太猛，句子重心左右甩 |
+| 切换点 | `[0.25, 0.47, 0.69]`，窗 0.12（≈18f） | 段间约 0.10（≈15f）静置读词；起手 0.25 前的静置让观众先认出句式 |
+| 缓动 | `E.inOutCubic` | 两头缓才像滚轮起停；outCubic（只后缓）读作被甩上来，胶囊宽度也会跟着突变 |
+| 胶囊 | 高 48px、圆角 99、`#1a1c24`、宽 = 文本宽 + 74 | +74 是左右内边距 + emoji 位；<50 词贴边，>100 胶囊胖成按钮 |
+| 幽灵项 | 上 -38 / 下 58px，基础透明度 0.13 | 0.13 是"看得见但不抢"的甜点；>0.25 读作三行并列文字，不是幽灵；删了列表暗示就没了 |
+| 幽灵视差 | `(pos-near)·48·0.5`（半速） | 半速是"外圈更远"的立体感来源；同速则三行像一整块滑动，幽灵失去意义 |
+| 句子字号 | 两侧 30px/800、胶囊内 22px/700 | 胶囊内比句子小是正确层级（徽章依附句子）；等大或更大就读作两个标题打架 |
+| 配色 | 底 `#fbfbfd`、句子 `#15171d`、胶囊白字 | 浅底 + 单一深色块是本卡的身份证；深底版会让胶囊消失，需整套重配 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **宽度靠 setup 期 `offsetWidth` 实测**：字体没加载完时量到的是回退字体
+  的宽度，胶囊会偏窄或偏宽——移植时须确保 webfont 就绪后再量，或改用
+  离屏 canvas `measureText`；`length·13` 那条兜底只保证不崩，不保证准
+- 词长差要控制在 2 倍内：宽度自适应是本卡的卖点也是风险，
+  5→8 字母（如 `Sales`→`Workflow`）这一跳已经是可接受上限，再大句子两侧甩得晃眼
+- 两侧文字必须 `flex:none`：不然 flex 会去压缩它们而不是移动它们，
+  "挤开"变成"字被压扁"
+- 幽灵项文本取 `round(pos)` 的邻居，所以在切换的正中间（pos=x.5）会
+  **跳一次文本**——被 `settle` 压到最淡时发生，肉眼基本不可察；但若把
+  透明度调高到 0.25+，这一跳就会露出来
+- emoji 在不同平台字形宽度不一（尤其 `⚙️` 带变体选择符），会让实测宽度
+  漂移几像素；实战建议换成项目自己的单色图标，别依赖系统 emoji
+- 与 vertical-word-roll-blur-cycle 分工：那卡宽度固定、裸词、带滚筒 blur
+  （词是句子成分），本卡宽度自适应、深色胶囊、带幽灵项（词是徽章）——
+  同片只留一个；声音上三次落定是三个节奏点，配轻质开关/胶囊贴合音，
+  连发交替双样本，配法纪律见 sound-design.md
+
+## 参考实现
+demos/typography/pill-chip-slot-cycle-handled/
+（PillChipSlotCycleHandled.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/pill-slot-cycle.md

@@ -0,0 +1,58 @@
+---
+name: pill-slot-cycle
+一句话: 句中词槽轮换——固定句干钉死不动，句尾 pill 徽章每 ~0.7s 老虎机滚一格（旧的上飞加速淡出、新的从下带模糊滑入），连换 N 个功能词后落成完整句子收束
+适用: "功能列举"类文案的最优雅解法（比逐条列表快、比字符级滚动有语义）；一句话卖点 + 多个动词短语的段落
+时长: 入场 12f + 每拍 21f × 词数 + 收束 14f + hold；6 词约 6.7s（demo 200f，含 48f 完整句 hold）
+能量: 中（稳定节拍器，无峰值）
+---
+
+## 意图
+罗列六个功能，列表要六行、逐条淡入要六拍还占满屏。词槽轮换把它们
+塞进**一句话的一个槽位**里：句干 "One skill to ___"（demo 讲 video-shotcraft：Storyboard it → Capture the page →
+Move the camera → Cut on the beat → Design the sound → Render the film）是承诺，槽里
+滚过的每个 pill 是证据，最后 pill 飞走、"do it all." 落位——证据
+列举完毕，结论盖章。结构自带三幕：承诺→列举→收束。命门是句干
+**纹丝不动**：观众的眼睛全程钉在槽位上，句干一晃列举感就散。
+
+## 动效核心
+- 句干绝对定位左端锚死——**不能用 flex 居中**，pill 宽度变化会带着
+  句干重排（首轮踩过的坑，已是判例）
+- 每拍 21f（~0.7s），前 8f 完成换位、后 13f 静置——静置段是给观众
+  读词的，读不完的拍子等于没换
+- 入场：translateY 120→0 + blur 14→4→0，Easing.out(cubic)；
+  离场：translateY 0→-130 + blur 0→10，Easing.in(cubic) 加速飞出
+  ——新来的减速落定、旧的加速逃走，方向感是"向上翻页"
+- 槽内用隐形占位 pill（visibility hidden）撑宽度，新旧两枚绝对定位
+  叠放——槽宽随当前词自然变化但不抖
+- 收束拍：末 pill 上飞（7f ease-in），"do it all." 从下 90px 带
+  Easing.back(1.4) 过冲落位——全片唯一一次过冲，留给结论；落位后整行用 smooth 26f 缓缓居中
+  （列举期间句干仍左锚死，只在结论句完整后才移动），"to do" 之间收回普通词距
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 拍长 | 21f/词，5–7 词 | <16f 读不完短语；>28f 节拍器感散掉；8+ 词观众开始数数 |
+| 换位窗 | 拍内前 8f | 拉长到 12f+ 新旧同屏太久，读作两个 pill 打架 |
+| 飞行距离 | 入 +120 / 出 -130px | <80px 读作原地闪换；入出不对称（出略远）让离场更决绝 |
+| 运动模糊 | 入 ≤14 / 出 ≤12px 竖向 blur，按真实速度计算（静止为 0）；入 rotateX -38°→0、出 0→34° 绕滚筒翻页 | 去掉 blur 换位读作硬弹；>20px 中间帧糊成色块 |
+| 收束过冲 | Easing.back(1.4)，14f | >2 结论落位像卡通；无过冲结论与列举没有档次差 |
+| 收尾 hold | 完整句静置 ≥45f | 这句话是全段目的，不 hold 等于白列举 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 本卡是整词级 pill 轮换且嵌在活句子里（不是字符/数位级机械滚动）——文案是
+  "句干+动词短语"结构才用本卡，纯数字/纯标题词别硬套
+- 与 typewriter-moves 分工：打字机是"一个字一个字造句"，本卡是
+  "句子造好了换零件"——同片可共存但别在同一句文案上连用
+- 与 type-rhythm-sync 分工：那是既有文字随音轨变属性（不换内容），
+  本卡换内容——绑音轨时本卡拍点对鼓点即可，别再叠字重脉冲
+- pill 短语长度要接近（demo 最长 "Capture the page" / "Design the sound"）——长短差 >2 倍
+  槽宽跳变太猛，句子重心左右甩
+- 收束句与句干字号字重必须完全一致（demo 都是 96px/800）——
+  "do it all." 若比句干大，读作新标题而非句子补完
+
+## 参考实现
+demos/typography/pill-slot-cycle/
+（PillSlotCycle.tsx）
+原片出处：notion-ai 4.5–8.5s

package/lib/motion/shotcraft/upstream/references/shots/typography/text-column-converge.md

@@ -0,0 +1,61 @@
+---
+name: text-column-converge
+一句话: 双词对峙合拢——左"NEW"右特性词钉死在等屏边距两侧硬切轮换、全程零收缩，换到最后一词才唯一一次 ease-in-out 滑到居中咬合成短语，下方小字近乎硬切浮现；收尾揭晓型文字卡
+适用: 特性清单收束到产品名/口号的段落（"NEW × 一串特性 → NEW <产品名>"式）；发布会式 recap、版本号揭晓
+时长: 轮换 7–16f/词 × 8–9 词 + 合拢 ~36f + 小字后静置；全段约 5–6s
+能量: 中低（机器节奏、小字规格清单气质，不是砸字）
+标签: outro
+---
+
+## 意图
+两词分踞左右像目录页对峙，观众以为只是轮换字幕；直到最后一词
+停稳才发现左右其实是同一句话的两半——唯一一次连续合拢把整段
+轮换追认为"悬念铺垫"。命门是**钉死**：轮换期两词位置一像素不动、
+左右屏边距完全相等（原片实测 412 vs 413@1280），任何渐进收缩都会
+提前剧透合拢、把揭晓稀释成进度条。合拢只许发生一次，且必须在
+最后一词之后——这是收尾揭晓，不是持续动效。
+
+## 动效核心
+- 左词左缘、右词右缘各自钉死在等屏边距处（原片实测 412/413px
+  @1280，×1.5 → 618/1302@1920）；右词换长换短一律右缘定位
+- 词轮换纯硬切，停留帧数不均（16/12/9/8/7/8/10/12f，机器节奏
+  带人味）；轮换全程间距零收缩（判例：渐进收缩版被用户驳回重做）
+- **唯一一次合拢**：末词停稳 ~10f 后，~1.2s（36f）ease-in-out
+  （cubic）连续滑动，两词滑到以屏幕中线居中定格
+- 合拢终点按等宽字体实际步进算（0.6em+letterSpacing × 字符数），
+  两词恰好一空格咬合，无重叠无缝隙；无 stamp 缩放、无二次补偿移动
+  （demo：video-shotcraft 八个特性词轮换，末词为全小写字标 video-shotcraft，终点按 `NEW ` + 字标字符数算；
+  小字为品牌短句后半 "CRAFT THE SHOT."）
+- 定格 ~18f 后斜体小字近乎硬切浮现（4f 快淡、零位移），与整行
+  同左缘、字号同正文
+- 质感：冷色深底 + 极淡顶光 + 暗角/颗粒；词换瞬间 1 帧提亮；NEW 轮换期为次级灰、
+  合拢中随进度提亮到主色；合拢滑动按速度加水平运动模糊（≤4px，静止为 0）；
+  demo 全长 180f（导出 `TEXT_COLUMN_CONVERGE_DURATION`）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 屏边距 | 618px@1920（**原片实测** 412/413@1280 ×1.5） | 左右差 >2px 读作没对齐；边距是本卡身份，别改成黄金分割 |
+| 词停留 | 7–16f 不均 | 均匀停留读作节拍器；<7f 读不完词 |
+| 合拢触发 | 末词停稳 +10f（原片 32.4→32.7s 实测） | 停稳期太短，观众没意识到"这词不换了"就开始滑 |
+| 合拢时长 | 36f ease-in-out cubic（**原片实测** ~1.2s 连续滑动） | <24f 读作弹跳归位；>50f 读作拖 |
+| 咬合步进 | 0.6em+letterSpacing/字符，等宽字体 | 非等宽字体步进不可预测，会重叠或漏缝 |
+| 字号 | 42@1080p（**原片实测**字高 ~20/720） | 这段是小字规格清单气质，放大到 60+ 就成了砸字（单词重锤去用 outline-word-fill） |
+| 小字浮现 | 定格 +18f，4f 快淡零位移（原片 34.4→34.6s 间直接出现） | 加滑入/长淡入就抢了合拢的戏 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 type-rhythm-sync（字属性节拍）/beat-cut-moves（硬切节拍）撞
+  领域：那两张是"轮换本身即内容"；本卡命门是**位置钉死 + 末次合拢**
+  的收尾揭晓，轮换只是铺垫。若段落没有"合拢揭晓"就别用本卡
+- 合拢只许一次——每切一词收一档的渐进收缩版已被原片对照证伪并
+  删除，别复活
+- 必须等宽字体（demo 用 SF Mono）；比例字体下咬合终点算不准
+- 原片词换瞬间带 1 帧亮度闪烁（打字机换行感），demo 已加回 1f 提亮；
+  闪烁 >1f 会读作故障
+
+## 参考实现
+demos/typography/text-column-converge/
+（TextColumnConverge.tsx）
+原片出处：raycast-teams.mp4 28–36s

package/lib/motion/shotcraft/upstream/references/shots/typography/title-demote-to-label.md

@@ -0,0 +1,64 @@
+---
+name: title-demote-to-label
+一句话: 大标题降格为节标签两式——A 大标题居中显影站稳一拍后连续缩小 0.3x 平移到左上角落成小节标签、内容区在其下生长；B 同套路但登场时带文本选中态高亮块扫入再撤掉
+适用: 章节开场（标题先当主角再让位给内容）；教程/功能演示片的小节交接；B 式给"文字/编辑"类产品加身份暗示
+时长: A ~3.7s（112f）/ B ~4.5s（134f）；demo 两式串播 246f
+能量: 低中（版式变换型，氛围镜头）
+标签: transition
+---
+
+## 意图
+章节标题的常规命运是"出现→消失→内容登场"，标题和内容互不认识。
+本卡让标题**降格而不退场**：居中大字站稳一拍宣告主题，然后一次连续
+补间缩到 0.3x 飞到左上角，落成这一节的栏目标签——它还在屏幕上，
+只是从主角变成了门牌。观众获得免费的空间记忆：刚才那个大词就是
+现在左上角那个小词，本节讲的就是它。内容骨架在降格进行中就开始
+生长，交接零空档。
+
+## 动效核心
+- 降格是**单次连续补间**，26f 不对称 in-out（bezier(0.6,0,0.18,1)：起步果断、落点很软）：
+  scale 1→0.22（220px 标题 → ≈48px 标签）+ 位置 (960,540)→(216,196) 同一条曲线——分两段（先缩后飞）读作两个动作
+- transform-origin 左中；居中修正量 translate(-50%) 随补间同步归零
+  （`translate(${-(1-dem)*50}%, -50%)`）——不归零终点会偏一个半宽
+- 登场显影：标题逐字从遮罩线下升起（rise，16f/字、1.6f 错峰），朱红句点晚 10f 过冲弹出；
+  mono 眉题「CHAPTER 01」字距由宽收紧。显影后必须站稳 ≥18f 再降格（demo 20f，期间 1.5% 极缓推近）——
+  没站稳就缩，宣告拍被吃掉。眉题随起飞 6f 淡出，落位前标签前缀「01 /」从左擦入接班
+- 内容错峰生长（demo 为 video-shotcraft 的分镜工作台页，两节标题取品牌短句「Frame.」「Craft.」：
+  A = 60px 导语 + 三张卡（镜头配方卡 / 用户评价 / 卡点节拍）；B = 58px 分镜脚本 + 句内选区 → 连线 → 旁注匹配镜头卡）：每块裁切从左揭开（宽 0.3→1，字不压扁）+ 上移 30px 淡入，
+  先密后疏错峰；生长起点在降格进行到 12f 时，标题还在飞内容已在长——这个重叠是"交接无空档"的来源。
+  横跨全宽的分隔线晚几帧再画，别让它在标题飞行路径上同帧生长
+- B 式选中高亮：左缘/宽度两个百分比分别补间——扫入时宽度 0→100%
+  （盖住，10f），撤掉时左缘 0→100%（从左让开，8f）；高亮撤净后再起降格
+- 降格飞行按位置差分速度加方向性运动模糊（静止为 0）；B 式选区用强调色 20% 透明 + 跟随右缘的插入光标
+- 两式串播不再白闪：共用一个舞台，A 内容 ease-in 上移 12f 退场 → B 大标题原地显影；
+  B 降格前 A 标签上移一行、缩到 0.7、变灰成"上一节"，B 标签落进同一个槽位（多节连用不叠放的做法）
+  （demo 导出 `TITLE_DEMOTE_TO_LABEL_DURATION` = 246f，look = paper）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 降格补间 | 26f 不对称 in-out，scale→0.22（落成 ≈48px） | <14f 读作标题被弹走；终点 >0.45 标签太大压内容；标签 <40px 不可读 |
+| 站稳拍 | 显影后 ≥18f 静置 | 省掉这拍，观众没读完标题它就跑了，降格白做 |
+| 内容错峰 | 先密后疏，块 18–22f，宽 0.3→1 | 全部同时长出读作页面刷新而非"生长" |
+| 生长起点 | 降格开始后 +12f | 等标题完全落位才生长会空 8f 冷场 |
+| 选中高亮 | 扫入 10f / hold 10f / 撤 8f，强调色 20% 透明 | 高亮 hold <5f 读作闪烁 bug；不撤干净就降格，色块跟着飞很脏 |
+| 两节交接 | 旧内容 exit 12f 上移退场；旧标签 16f 上移一行变灰 | 旧标签不让位，新标签落在它身上 = 标签坟场 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与"标题钉进 3D 空间随相机透视变形"的场景锁定拍法（已退役）分工
+  （空间型），本卡是 2D 版式层级的连续降格（版式型）——要"标题住进
+  产品空间"用那卡，要"标题变栏目名"用本卡，同片选一
+- 降格路径上不许有其他元素动——标题飞行是全屏唯一焦点，骨架生长
+  在它落点下方不抢（起点错开），但弹窗/光标类同帧入场必抢
+- 多节连用（每节一次降格）时左上角标签要**换行不叠放**：新标签落位
+  旧标签上移让位，否则第二节起左上角变成标签坟场
+- B 式的选中高亮是"文字可被选中"的产品暗示，非编辑器/文档类产品
+  用了语义空转，别为了好看加
+- 标题文案 ≤3 个词——降格到 0.3x 后还要当可读标签，长句缩完就是一条灰线
+
+## 参考实现
+demos/typography/title-demote-to-label/
+（TitleDemoteToLabel.tsx）
+原片出处：perplexity-promo 16–18.5s；B 式变体源自 framer text-selection-title

package/lib/motion/shotcraft/upstream/references/shots/typography/type-assembly-moves.md

@@ -0,0 +1,45 @@
+---
+name: type-assembly-moves
+一句话: 文字集结三式——split-text-stagger 逐字裂升、letterform-drift-assembly 漂移合拢、text-on-path 沿线流入
+适用: 大标题/标语的入场；与 type-entrance-moves、document-typewriter-reveal 同属标题入场大品类，全片 ≤2 种
+时长: 单式 4–5.5s（动作段 A ~56f / B ~104f / C ~110f；demo 全长含 hold：A 130f / B 150f / C 160f，各自导出 `*_DURATION`）
+能量: A 中 / B 中高 / C 中
+---
+
+## 意图
+标题入场已有"原位变形系"（字符坠落/打字机——字在原地换形态）。本卡补"集结系"：字符从别处**汇聚成**标题，运动轨迹
+本身有戏。A 琴键式——每字从看不见的裁切线下滑升，理性利落，通用度
+最高；B 片头式——字符四散带模糊漂入、逐个锁定加深，Stranger Things
+的仪式感，适合品牌名亮相；C 语义式——字符沿一条上升曲线鱼贯流入
+再摆正，曲线可以正好描着图表增长线走，文字与数据同框叙事。
+
+## 三式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A split-text-stagger 裂升 | 每字 overflow 盒内 translateY(115%→0) 带 10% 过冲，delay i×2f，基线同步生长（demo：亮场 136px 品牌短句「FRAME MOTION.」） | 通用默认；利落理性 |
+| B drift-assembly 漂移合拢 | 字符 seed 方向 ±260–360px + blur 8px + 旋转 ±24° + 纵深 1.22 漂入错峰归位，锁定帧加深脉冲，合体后整词呼吸 1.04（demo：亮场 148px 品牌名「Shotcraft」） | 品牌名/片头级亮相 |
+| C text-on-path 沿线流入 | 整串字按真实步进沿弧长刚性推进（末字领跑、切线角旋转，行进中可读），到达后逐字沿弧线抬升到左上标题位（demo：midnight 暗场营收增长线 + 数值牌） | 曲线有语义时（增长线/流程线） |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 过冲 | 10%（14f out-cubic 升到 −10% 再 6f 回落；原案 6% 可测不可感，实渲加码） | 正常速度要看得见回落那一下；升起快段按竖向速度加 y 向模糊 |
+| B 锁定脉冲 | 字色深到 #000 + 描边 0→3px→0 / 8f | 白底上加深+描边，不用发光（判例） |
+| B 漂移绑定 | 位移 (1−p)、旋转、纵深缩放、blur 8(1−p)、opacity 0.35→1 共用一条 p（Easing.out(cubic)，每字 45f、错峰 3f） | 分曲线走，字会"到了还糊着" |
+| C 摆正 | 到达停 8f 再从左到右 1.1f 错峰、18f 抬升：y 用带 ~4% 过冲的快曲线、x 用 in-out、旋转晚 2f 收敛 → 轨迹是弧；终位按实测字宽排版 | 不摆正就永远是"挂在线上"，读不出标题；抬升行程大时过冲 >5% 会顶进眉题 |
+| C 曲线 | evolve（dashoffset 按弧长比例）随车头字符同步生长；demo 做成图表增长线（电光蓝 5px 描边 + 外发光 + 线下渐变面积 + 青色车头光点与到顶脉冲 + 网格刻度 + 季度标记） | 曲线先画完字再走，读作两个动画 |
+| 收尾 | 全员落定真静止 ≥30f | R1 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 标题入场大品类现已五式（本卡三式 + type-entrance-moves + document-typewriter-reveal），
+  **同片 ≤2 种**（P4）铁律不变
+- B 式与 C 式都是高注意力入场，别再叠相机动作——字在飞的时候镜头必须稳
+- C 式别让字符各自起跑：后面的字要追越前面的字，曲线低段必然挤成一团（原版踩过）；
+  按弧长刚性推进、字间距取真实步进才读得出整句；字号 >80px 时曲线拐弯处字会互相啃角，
+  大字改用更平缓的曲线或减字数
+
+## 参考实现
+demos/typography/type-assembly-moves/
+（LetterformDriftAssembly.tsx / SplitTextStagger.tsx / TextOnPath.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/type-entrance-moves.md

@@ -0,0 +1,41 @@
+---
+name: type-entrance-moves
+一句话: 标题文字入场一式——letter-drop-physics 字符坠落（重力砸落、弹跳、歪斜站定，最后一拍集体立正归位）
+适用: 大标题/章节字卡的入场；与 type-assembly-moves（集结系）、document-typewriter-reveal（打字机）同品类互斥选用
+时长: 单式 5s（含 hold 与静止收尾；动作段 ~116f，demo 150f）
+能量: 中高（物理趣味）
+---
+
+## 意图
+标题入场库内已有打字机（沉稳文档感）和集结系（字从别处汇聚），本卡补
+物理喜剧感——字符从天而降、砸地弹跳、歪歪扭扭站定，最后一拍
+集体立正归位，适合轻松调性的开场破冰（demo 让品牌名「Shotcraft」砸落站定，
+副标题「Every shot lands on the beat.」随归位一拍浮出）。标题入场同片 ≤2 种（P4）。
+
+## 做法
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A letter-drop-physics 字符坠落 | 字符错峰从顶砸落，重力加速+两次衰减弹跳+落地歪斜站定，最后一拍全体齐整回正 | 轻松调性开场；"活物感"的标题破冰 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 坠落 | 第 i 字符帧 4+36·(1−(1−i/(n−1))^1.5) 起跳（首末字固定在 4f / 40f，间隔越来越密；demo 9 字符 6.5→1.6f）；y = −DROP + DROP·(t/24)²（重力）→ 4u(1−u) 抛物线弹跳 30% → 二跳 9% | 弹跳衰减比 30%/9% 是"有弹性但不闹"的甜点；三跳以上读作果冻 |
+| 歪斜 | 落地瞬间 rotate 到 seed hash ±6° 并保持 | 歪角是"物理感"的一半；全体笔直落地读作普通位移入场 |
+| 归位一拍 | 全员落定后（如帧 110）6f ease-out 集体 rotate→0 + scale 1.06→1 | 集体归位是句号——错峰归位会把"立正"的仪式感拆散 |
+| 收尾 | 动作完毕真静止 ≥20f | R1：静止期所有属性锁死（含歪角归零后） |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 落地砸声是声音强依赖候选位（sound-design §4.5）：逐字钉帧会让重量感翻倍，
+  无声版也成立但少一半劲
+- 字符间不做真实碰撞（demo 为各字符独立轨迹）——字距排开即可；
+  想要"互相撞歪"需预烘焙轨迹，成本高收益薄
+- 选词避开带下行笔画的字母（g/j/p/q/y）或按字形单独校地面——demo 按基线贴地，
+  下行笔画会"插进"地面
+- 标题入场自带高注意力——别和其他高能量入场同帧抢戏
+
+## 参考实现
+demos/typography/type-entrance-moves/
+（LetterDropPhysics.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/type-rhythm-sync.md

@@ -0,0 +1,51 @@
+---
+name: type-rhythm-sync
+一句话: 文字随声同步两式——font-weight-pump 字重脉冲（笔画随鼓点变粗弹回）与 karaoke-fill-sync 卡拉OK填色（词随旁白逐个点亮）
+适用: 标题/标语与音轨强绑定的段落；A 绑节拍（鼓点），B 绑语音（旁白逐词）
+时长: A FontWeightPump 165f / B KaraokeFillSync 150f；A 128 BPM 每拍 14f、衰减窗 9–13f，B 每词按语速 18–33f
+能量: A 高（蹦迪感）/ B 中（跟读引导）
+标签: rhythm
+---
+
+## 意图
+文字动效库内此前全是"入场怎么进"，没有词管"在场的字怎么跟着声音活"。
+这两式补上：A 让标题变成节奏器官——笔画随低音鼓抽动变粗又弹回，
+文字在蹦迪，适合高能段落的视觉低音炮；B 让标语变成跟读字幕——
+旁白读到哪个词哪个词从左到右填色点亮，视线被牵着走，适合口播/
+标语强调段。共同点是**字不动、属性动**：无位移、无入退场，
+纯粹是字重/颜色在声音的拍点上呼吸。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A font-weight-pump 字重脉冲 | 命中帧细体字瞬间撑成黑体（可变字重连续插值），9–13f 衰减弹回；重音拍额外撑宽 6%；第 2 小节长出上下描边回声行跟拍，drop 拍落定成粗体渐变海报 | 音乐驱动的高能段；标题当低音炮 |
+| B karaoke-fill-sync 填色随读 | 浅底两行标语（demo「FRAME MOTION / CRAFT SHOTS」），每词从左到右柔边填亮，进度跟语速，正在读的词填强调色、读完退成主墨色并保持；活跃词下带读指下划线 | 旁白/口播强调段；多词标语的视线引导 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 脉冲包络 | `env=(1−t/D)^0.8`（t=命中后帧数；demo 逐字中心 9f→边缘 13f 错开回弹，≥D 精确归 0）；fontWeight `250+650·env` 连续插值（SF Pro 可变字重）；每个字钉在 **900 字重**排好的槽位里——静止时细体字间留缝、命中时笔画撑满槽位"合拢"，整行不重排；无可变字体时退回 env>0.15 窗口 300↔900 跳变 + `-webkit-text-stroke` 连续衰减补过渡 | 槽位按最粗字重排是关键：按常规字重排，峰值时字会互相挤压重叠 |
+| A 节拍 | 128 BPM 每 14f 一拍（16/30/…/114）+ 第 9 拍 drop（128f）；每小节第 1 拍重音 `scaleX = 1+0.06·env` 并染粉；drop 冲到 900 后不回细，~16f 回落定格在 780 字重 + 紫→粉逐字渐变 + 一道横向光带 | 拍距必须 > 最长衰减窗（14>13），两拍重叠读作抽搐 |
+| A 回声行 | 第 2 小节起上下各一行 2px 描边同字，晚 2f 跟拍脉冲、每拍被推开 26px（drop 推开 60px 后归位） | 递进靠"加层"而不是加大幅度；第 1 小节就上回声，后面没牌可打 |
+| A 节拍参照物 | 画面下方 8+1 格步进音序器（两小节 + DROP 格），命中哪拍哪格亮起放大 12%，已过的格保留暗亮 | 静音环境（预览/静帧）没有这排格子就读不出"在跟拍"；只让格子和字动，不做整画面逐拍泵 |
+| B 词级时间表 | 逐词 [start,end] 帧区间，词内 linear 填充；词间留 4–10f 停顿（换气） | 时间戳实战来自旁白打点表；均匀分配读作机器朗读 |
+| B 词级时间表（demo） | FRAME 20–38、MOTION 42–75（长词慢读）、CRAFT 85–103、SHOTS 107–130；0–19f 预备、130–149f 真静止 | 长词给更长的读窗，读作真人语速 |
+| B 填色实现 | 每词双层同文本叠放：底层浅灰（13% 透明墨色）+ 上层按进度揭开：`mask-image: linear-gradient(90deg, #000 e−4%, transparent e+4%)`，e=p·108−4（±4% 柔边前沿；硬切可用 `clipPath: inset(0 (1−p)·100% 0 0)`）；正在读的词填强调色，读完 10f 退成主墨色 | 逐词独立叠层免量测词宽占比；整行单层 clip 需精确像素表、易漂 |
+| B 读指 | 活跃词下 8px 圆角下划线（demo 用强调色），宽度 = p·100%；读完 6f 从左往右收掉 | 4px 浅灰在 1080p 缩略下不可见（本批实渲踩坑）；读完的词不留线 |
+| B 旁白参照物 | 标语下方 48 根竖条旁白波形：读词处起伏、换气处回落，已播部分染强调色 | 静音预览/静帧没有这条波形就读不出"在跟读" |
+| 收尾 | A 末拍衰减归零后 / B 末词填完后真静止 ≥20f | R1 呼吸判例 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 两式都是**声音强依赖**手法：A 命中帧必须与鼓点同帧、B 填色区间必须
+  跟旁白词边界（钉帧走 sound-design §4.5 相对起点）——无声上片则 A 读作
+  抽风、B 读作莫名变色，别在无音轨段落用
+- A 式依赖系统可变字体（macOS SF Pro）做 wght 连续插值；换字体或在无可变字体的渲染机上
+  会退成几档跳变，先确认字体加载与渲染器支持，不行就走 stroke+跳变兜底
+- A 式全片 ≤1 段（P4）——标题蹦迪是抢戏大户，两段同片互相拆台
+- B 式词数 ≤6/屏：更多词时填色进度读不过来，拆行或拆镜
+
+## 参考实现
+demos/typography/type-rhythm-sync/
+（FontWeightPump.tsx / KaraokeFillSync.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/typewriter-moves.md

@@ -0,0 +1,42 @@
+---
+name: typewriter-moves
+一句话: 打字机 error-retype——误删重打的"改口"三幕剧：打出平庸词 → 犹豫 → 退格删掉 → 更快打出卖点词
+适用: slogan/卖点字卡、否定式文案；文字自带时间性的入场
+时长: ~5.3s（160f）
+能量: 中低
+标签: opening
+---
+
+## 意图
+打字是唯一自带时间性的文字入场——字符一个个到来本身就是节奏，
+不需要额外动效。A 式把打字当**独白**：逐字打出平庸词
+（demo 眉题 Introducing video-shotcraft 下的 "just a slideshow"）→ 停顿犹豫
+→ 退格删掉 → 更快打出卖点词（"your cinematic crew"），犹豫-否定-宣言的
+三幕剧，戏全在三档速度差里。
+
+## 式
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A error-retype | 打 2f/字符 → 停顿 16f 光标闪两下 → 退 1.5f/字符 → 重打 1.5f/字符无犹豫；光标打删常亮、停顿才闪 | slogan 字卡的"改口"戏；否定式文案 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 字符节奏 | substring(0, floor((f-起点)/步长))，帧确定无插值 | 任何缓动打字都读作加载动画 |
+| 三档速度 | 打 2f/字符、删 1.5f、重打 1.5f 且零犹豫 | 三档差必须可感——等速改口读作 bug 不是戏，命门 |
+| 光标三态 | 打删常亮＝果断；停顿 4f 半周期闪两下＝犹豫；完稿闪两下后条件摘除 | 光标就是演员的脸，全程等速闪就没有"犹豫" |
+| 排版 | 逐字符固定宽 span（60px 等宽槽），左缘锚定 | 变宽字体/整串测宽会逐帧重排抖动 |
+| 收尾 | 静止 ≥50f | 光标残留 0.05 opacity 都毁真静止 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 声音强依赖：键击声逐字符对齐、退格音调更低（sound-design
+  §4.5）——无声打字机只剩字幕机
+- 全片 ≤1 次——改口是一次性的戏剧转折，改两次口是口吃
+- 等宽字体或逐字符 span 二选一必须占一个，否则字符到来时
+  整行重排，打字变成抽搐
+
+## 参考实现
+demos/typography/typewriter-moves/
+（TypewriterErrorRetype.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/vertical-word-roll-blur-cycle.md

@@ -0,0 +1,63 @@
+---
+name: vertical-word-roll-blur-cycle
+一句话: 句尾词换成竖向滚轮，3 次换词各 0.55s（outQuint 七成 + outBack 三成，前快后极慢带微过冲），相邻行按距离上垂直 blur 与灰度，中心词落定瞬间从灰染成强调色
+适用: "Crafted for ___" / "Built for ___" 这类句干 + 受众/对象列举的一句话卖点；浅底品牌片的干净一拍
+时长: 约 5.0s（150f@30fps：静置 → 3 次换词 → 尾部整组淡出）
+能量: 中（稳定三拍，无峰值）
+---
+
+## 意图
+句尾换词的最优解是滚轮而不是淡入淡出：滚轮自带**方向**（往上翻页），
+观众知道"还有下一个"。这卡的两个身份记号是相邻行的**垂直 blur**
+（滚轮景深，模拟机械转筒的失焦）和落定时的**染色**（灰→强调色，
+"这个才是答案"）。句干（demo `Crafted for`）全程纹丝不动——眼睛钉在滚轮上，
+句干一晃列举感就散。
+
+## 动效核心
+- 位置量 `p` 由 3 段窗累加：`STEPS = [0.16, 0.36, 0.56]`，每段窗 0.11
+  （≈16f，约 0.55s），段间留 0.09 静置给观众读词
+- 每段缓动是**混合曲线**：`0.7·E.outQuint(u) + 0.3·E.outBack(u)`——
+  outQuint 给"前快后极慢"的机械减速，outBack 那三成给落定的微过冲回落
+- reel 定位 `translateY(ROW - p·ROW)`，ROW=44px，mask 高 `ROW·3`=132px
+  （露三行）——中心行恒定是 mask 第二行
+- 距离驱动的三通道，`d = |i - p|`：
+  - blur：`d<1` 时 `3d`，`d≥1` 时 `3 + 2·min(d-1,1)`（最远 5px）；demo 用 SVG
+    `feGaussianBlur stdDeviation="0 b"` 只糊纵向，转动时再按滚轮速度叠 ≤4px 纵向运动模糊（静止为 0）
+  - opacity：`d<1` 时 `1 - 0.65d`，否则 `max(0.1, 0.35 - 0.23(d-1))`
+  - 颜色：`mixHex(ACCENT_DIM, ACCENT, clamp01(1 - 2.4d))` —— **d>0.42 就完全
+    是暗色**，所以只有真正落定的那一刻才是强调色，滚动中途全程灰
+- 收尾 `seg(t, 0.9, 0.985)` 整组（句干 + 滚轮）淡出，不留残影给下一镜
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 词表 | 4 词（Launches→Demos→Promos→Every Shot），3 次换词 | 末词是结论（最宽那个词），前三个是例子；>5 词观众开始数，<3 词读不出"列举" |
+| 拍点 | `[0.16, 0.36, 0.56]`，窗 0.11（≈16f） | 段间 0.09（≈13f）静置是给读词的，读不完的拍子等于没换；窗 >0.18 新旧同屏太久 |
+| 缓动配方 | `0.7·outQuint + 0.3·outBack` | outQuint 是机械减速的来源；outBack 那三成给落定"咔"一下，纯 outQuint 读作电子屏滑动 |
+| 行高/视窗 | ROW 44px、mask `44×3`px、词宽 190px | 露三行才有滚筒感（露一行读作淡入淡出）；宽度写死 190 是为不挤句干，词更长要同步加 |
+| 相邻行 blur | 邻行 3px，最远 5px，**仅垂直向感知** | blur 是"滚筒景深"的身份证，删了退化成词条平移；>8px 邻行糊成灰条看不出是字 |
+| 落定染色 | `1 - 2.4d` 映射 ACCENT_DIM→ACCENT | 系数 2.4 让染色只发生在落定瞬间；<1.5 滚动中途就上色，答案感散掉 |
+| 字号字重 | 句干与滚轮同为 30px/800、`letter-spacing:-.5px` | 必须完全一致——滚轮词比句干大就读作两个元素，不是一句话 |
+| 收尾淡出 | `seg(t, 0.9, 0.985)` 整组 | 末词落定后约 40f 静置再淡出；不 hold 等于白列举 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **mask 宽度写死 190px**：换词表时最长词（demo `Every Shot`，带空格的词组要 `white-space: nowrap`）必须能装进去，
+  否则被裁字；反之词都很短则右侧留大片空白，句子重心偏左——换词表必须
+  重量一次宽度
+- 词长差别不宜过大：mask 宽度是固定的（本卡不做宽度自适应，那是
+  pill-chip-slot-cycle-handled 的活），词长差 >2 倍时短词在框里显得孤立
+- 句干必须钉死：demo 用 `flex + gap:14px` 是因为 mask 宽度恒定不会推挤
+  句干——一旦改成宽度自适应的滚轮，就必须换成绝对定位锚左端，
+  否则句干随词宽左右甩
+- `p` 是三段窗**累加**出来的，所以三段窗不能重叠：重叠会让 p 在一帧内
+  跨越一整行，滚轮"跳格"
+- 与 pill-chip-slot-cycle-handled 分工：那卡是深色胶囊 + 宽度自适应挤开
+  （词是徽章），本卡是裸词滚轮（词是句子成分）——同片只留一个
+- 声音：每次落定是一个节奏点，配轻机械/开关音；三连发要交替双样本
+  防机枪感，配法纪律见 sound-design.md
+
+## 参考实现
+demos/typography/vertical-word-roll-blur-cycle/
+（VerticalWordRollBlurCycle.tsx）