dsh-drawai 0.4.1 → 0.4.3

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

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

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

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

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

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