dsh-drawai 0.4.2 → 0.4.4

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

@@ -1,66 +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）
+---
+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

@@ -1,38 +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 可换文案）
+---
+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

@@ -1,66 +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）
+---
+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

@@ -1,58 +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
+---
+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

@@ -1,61 +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
+---
+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