@biunow/agent-biuart 0.0.0-stage → 0.1.1

package/engine/eras_style_studies.js

@@ -0,0 +1,20 @@
+window.SCENE_LIBS=['lib/three.min.js'];window.PUNCH=0;window.ERAS=[
+{id:"38_giotto",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("乔托",50,1034);c.restore();}}},
+{id:"39_piero",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("皮耶罗",50,1034);c.restore();}}},
+{id:"40_raphael",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("拉斐尔",50,1034);c.restore();}}},
+{id:"41_michelangelo",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("米开朗基罗",50,1034);c.restore();}}},
+{id:"42_guardi",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("瓜尔迪",50,1034);c.restore();}}},
+{id:"43_lorenzetti",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("洛伦采蒂",50,1034);c.restore();}}},
+{id:"44_cortona",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("科尔托纳",50,1034);c.restore();}}},
+{id:"45_renoir",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("雷诺阿",50,1034);c.restore();}}},
+{id:"46_pissarro",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("毕沙罗",50,1034);c.restore();}}},
+{id:"47_sisley",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("西斯莱",50,1034);c.restore();}}},
+{id:"48_gauguin",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("高更",50,1034);c.restore();}}},
+{id:"49_chagall",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("夏加尔",50,1034);c.restore();}}},
+{id:"50_ma_yuan",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("马远",50,1034);c.restore();}}},
+{id:"51_persian_miniature",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("波斯细密画",50,1034);c.restore();}}},
+{id:"52_south_park",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("南方公园",50,1034);c.restore();}}},
+{id:"54_ghibli_lab",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("吉卜力方向",50,1034);c.restore();}}},
+{id:"53_pixar",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("皮克斯方向",50,1034);c.restore();}}},
+{id:"55_dunhuang",dur:6,counter:{draw(c){c.save();c.font='25px sans-serif';c.textAlign='left';c.fillStyle='rgba(25,28,23,.75)';c.fillRect(34,1002,230,46);c.fillStyle='#fff9e9';c.fillText("敦煌壁画",50,1034);c.restore();}}}
+];

package/engine/examples/t1_3b1b.json

@@ -0,0 +1,19 @@
+{
+  "grammar": "t1_3b1b",
+  "duration": 10,
+  "fps": 30,
+  "width": 1920,
+  "height": 1080,
+  "theme": "ink",
+  "cues": [
+    { "at": 0.0, "kind": "line", "text": "损失 L(θ)", "data": { "values": [9, 5.8, 3.4, 1.8, 1.0, 0.8, 1.0, 1.8, 3.4, 5.8, 9], "color": "BLUE_C" } },
+    { "at": 1.8, "kind": "equation", "data": { "tokens": [
+      { "s": "L", "it": true, "col": "BLUE_C" }, { "s": "(", "gap": 4 }, { "s": "θ", "it": true, "col": "YELLOW", "gap": 4 }, { "s": ")" } ] } },
+    { "at": 3.4, "kind": "equation", "data": { "tokens": [
+      { "s": "θ", "it": true, "col": "YELLOW" }, { "s": "←", "gap": 18 }, { "s": "θ", "it": true, "col": "YELLOW", "gap": 14 },
+      { "s": "−", "gap": 14 }, { "s": "η", "it": true, "col": "GREEN_C", "gap": 8 }, { "s": "∇", "gap": 4 }, { "s": "L", "it": true, "col": "BLUE_C" } ] } },
+    { "at": 5.0, "kind": "point", "text": "沿坡度反方向走一小步" },
+    { "at": 6.4, "kind": "line", "text": "训练中的损失", "data": { "values": [9, 6.2, 4.4, 3.2, 2.4, 1.9, 1.55, 1.3, 1.15, 1.05, 1.0], "color": "TEAL_C" } },
+    { "at": 8.2, "kind": "highlight", "data": { "target": "equation" } }
+  ]
+}

package/engine/examples/t2_fullbleed_pulse.json

@@ -0,0 +1,15 @@
+{
+  "grammar": "t2_keynote_ui",
+  "duration": 8,
+  "fps": 30,
+  "width": 1920,
+  "height": 1080,
+  "theme": "ink",
+  "cues": [
+    { "at": 0.0, "kind": "card", "text": "for 循环累加", "sub": "一百万个整数", "image": "assets/终端_for循环求和.png" },
+    { "at": 1.4, "kind": "highlight", "text": "318 毫秒", "data": { "rect": [0.292, 0.212, 0.115, 0.07] } },
+    { "at": 3.2, "kind": "card", "text": "换成 sum()", "image": "assets/终端_sum求和.png" },
+    { "at": 4.3, "kind": "highlight", "text": "20.9 毫秒", "data": { "rect": [0.292, 0.153, 0.128, 0.07] } },
+    { "at": 6.4, "kind": "number", "text": "同一件事快了", "data": { "value": 15.2, "decimals": 1, "suffix": " 倍", "over": true } }
+  ]
+}

package/engine/examples/t2_keynote_ui.json

@@ -0,0 +1,15 @@
+{
+  "grammar": "t2_keynote_ui",
+  "duration": 10,
+  "fps": 30,
+  "width": 1920,
+  "height": 1080,
+  "theme": "navy",
+  "cues": [
+    { "at": 0.0, "kind": "card", "text": "一份 JSON 出的图", "sub": "数据：英伟达 10-K 年报", "image": "assets/财经图表_横屏.png" },
+    { "at": 1.8, "kind": "highlight", "data": { "rect": [0.648, 0.245, 0.104, 0.105] } },
+    { "at": 4.0, "kind": "card", "text": "竖屏换一套排版", "sub": "同一份数据", "image": "assets/营收图_竖屏.png" },
+    { "at": 6.6, "kind": "number", "text": "可换的动画语法", "data": { "value": 8, "suffix": " 种" } },
+    { "at": 8.0, "kind": "card", "text": "时长精确到帧", "sub": "帧数 = 时长 × 帧率", "data": { "icon": "clock" } }
+  ]
+}

package/engine/examples/t3_finance_chart.json

@@ -0,0 +1,29 @@
+{
+  "grammar": "t3_finance_chart",
+  "duration": 7,
+  "fps": 30,
+  "width": 1920,
+  "height": 1080,
+  "theme": "paper",
+  "data": {
+    "title": "英伟达营收涨到 7.8 倍",
+    "unit": "年营收，十亿美元（2021–2025 财年）",
+    "source": "来源：英伟达 2021–2025 财年 10-K 年报（财年截至次年 1 月）",
+    "chart": "bar",
+    "decimals": 1,
+    "series": [
+      { "label": "FY2021", "value": 16.68 },
+      { "label": "FY2022", "value": 26.91 },
+      { "label": "FY2023", "value": 26.97 },
+      { "label": "FY2024", "value": 60.92 },
+      { "label": "FY2025", "value": 130.50 }
+    ],
+    "highlight": { "index": 4, "text": "7.8 倍", "sub": "130.5 ÷ 16.7" }
+  },
+  "cues": [
+    { "at": 0.3, "kind": "bar", "data": { "index": [0, 1, 2] } },
+    { "at": 1.7, "kind": "bar", "data": { "index": 3 } },
+    { "at": 2.7, "kind": "bar", "data": { "index": 4 } },
+    { "at": 4.4, "kind": "highlight" }
+  ]
+}

package/engine/examples/y1_kurzgesagt.json

@@ -0,0 +1,16 @@
+{
+  "grammar": "y1_kurzgesagt",
+  "duration": 8,
+  "fps": 30,
+  "width": 1920,
+  "height": 1080,
+  "theme": "navy",
+  "data": { "center": "一滴海水" },
+  "cues": [
+    { "at": 0.3, "kind": "point", "text": "浮游生物" },
+    { "at": 1.3, "kind": "enter", "text": "一只硅藻", "data": { "index": 0 } },
+    { "at": 3.3, "kind": "point", "text": "硅质外壳" },
+    { "at": 4.3, "kind": "point", "text": "叶绿体" },
+    { "at": 5.6, "kind": "highlight", "data": { "index": 1 } }
+  ]
+}

package/engine/examples/y2_vox.json

@@ -0,0 +1,14 @@
+{
+  "grammar": "y2_vox",
+  "duration": 9,
+  "fps": 30,
+  "width": 1920,
+  "height": 1080,
+  "theme": "wood",
+  "cues": [
+    { "at": 0.0, "kind": "image", "image": "assets/K线图_横屏.png", "text": "日 K 线·示意数据" },
+    { "at": 1.8, "kind": "highlight", "data": { "rect": [0.74, 0.22, 0.22, 0.11] } },
+    { "at": 4.2, "kind": "image", "image": "assets/营收图_竖屏.png", "text": "同一图表的竖屏版" },
+    { "at": 6.6, "kind": "title", "text": "两张图都是代码画的" }
+  ]
+}

package/engine/examples/y3_whiteboard.json

@@ -0,0 +1,17 @@
+{
+  "grammar": "y3_whiteboard",
+  "duration": 10,
+  "fps": 30,
+  "width": 1920,
+  "height": 1080,
+  "theme": "chalk",
+  "cues": [
+    { "at": 0.0, "kind": "draw", "text": "25 分钟", "data": { "icon": "clock" } },
+    { "at": 1.5, "kind": "point", "text": "这段时间只做一件事" },
+    { "at": 2.8, "kind": "draw", "text": "不切换", "data": { "icon": "target" } },
+    { "at": 4.1, "kind": "point", "text": "铃响就休息 5 分钟" },
+    { "at": 5.4, "kind": "draw", "text": "换口气", "data": { "icon": "bulb" } },
+    { "at": 6.8, "kind": "point", "text": "四轮后长休一次" },
+    { "at": 8.2, "kind": "highlight", "data": { "target": "draw", "index": 0 } }
+  ]
+}

package/engine/examples/y4_storytime.json

@@ -0,0 +1,52 @@
+{
+ "grammar": "y4_storytime",
+ "duration": 8.5,
+ "fps": 30,
+ "width": 1920,
+ "height": 1080,
+ "theme": "snow",
+ "data": {
+  "character": {
+   "frames": {
+    "rest": "../../../角色帧库/<你的角色>/rest.png",
+    "talk": "../../../角色帧库/<你的角色>/talk.png",
+    "point": "../../../角色帧库/<你的角色>/point.png",
+    "shrug": "../../../角色帧库/<你的角色>/shrug.png"
+   }
+  }
+ },
+ "cues": [
+  {
+   "at": 0.1,
+   "kind": "insert",
+   "text": "3000行",
+   "sub": "帮我做个网站",
+   "data": {
+    "hit": 1.6,
+    "count": 3000,
+    "unit": "行"
+   }
+  },
+  {
+   "at": 2.8,
+   "kind": "react"
+  },
+  {
+   "at": 4.1,
+   "kind": "point",
+   "text": "第一次让 AI 写代码，",
+   "sub": "这些……贴哪儿？",
+   "data": {
+    "pose": "point"
+   }
+  },
+  {
+   "at": 6.6,
+   "kind": "highlight",
+   "data": {
+    "mark": "？"
+   }
+  }
+ ],
+ "_note": "y4 必须用你自己的角色帧库（AI 生帧，见 references/10-角色.md 与 角色精细度.md）。把 <你的角色> 换成你的帧库；没有生图能力就别用 y4。"
+}

package/engine/examples/y5_kinetic_type.json

@@ -0,0 +1,14 @@
+{
+  "grammar": "y5_kinetic_type",
+  "duration": 7.5,
+  "fps": 30,
+  "width": 1920,
+  "height": 1080,
+  "theme": "poster",
+  "cues": [
+    { "at": 0.7, "kind": "number", "text": "一句话换来的代码", "data": { "value": 3000, "suffix": " 行" } },
+    { "at": 2.6, "kind": "point", "text": "补全", "sub": "以前它补一行", "data": { "label": "从前", "key": "一行" } },
+    { "at": 4.3, "kind": "point", "text": "代理", "sub": "现在它做完整件事", "data": { "label": "现在", "key": "整件事" } },
+    { "at": 5.6, "kind": "highlight", "data": { "word": "代理" } }
+  ]
+}

package/engine/index.html

@@ -0,0 +1,42 @@
+<!doctype html>
+<html><head><meta charset="utf-8"><title>Art History Speedrun · 复刻</title>
+<style>
+html,body{margin:0;background:#111;overflow:hidden}
+canvas{display:block;width:100vw;height:auto;max-width:1920px}
+#ui{position:fixed;left:8px;bottom:8px;color:#ddd;font:12px monospace}
+body.render #ui{display:none}
+</style></head>
+<body>
+<canvas id="c" width="1920" height="1080"></canvas>
+<div id="ui"><input id="scrub" type="range" min="0" max="60" step="0.0166667" value="0" style="width:600px"> <span id="tt"></span> <button id="play">play</button></div>
+<script src="lib/fonts.js"></script>
+<script src="lib/util.js"></script>
+<script src="lib/paint.js"></script>
+<script src="lib/brush.js"></script>
+<script src="lib/render.js"></script>
+<script src="lib/post.js"></script>
+<script src="lib/rig.js"></script>
+<script src="lib/rig_huashu.js"></script>
+<script src="lib/kit.js"></script>
+<script src="lib/medium.js"></script>
+<!-- YouTube 解说语法库（references/09）：动效时间、相机、图解形变、文字、图表、发布会界面、拼贴、卡通 -->
+<script src="lib/motion.js"></script>
+<script src="lib/camera.js"></script>
+<script src="lib/diagram.js"></script>
+<script src="lib/typo.js"></script>
+<script src="lib/chart.js"></script>
+<script src="lib/ui.js"></script>
+<script src="lib/collage.js"></script>
+<script src="lib/media.js"></script>
+<script src="lib/toon.js"></script>
+<script>
+// 选片子：默认 eras.js；?film=<名> → eras_<名>.js（如 ?film=gallery = 35 种风格样片）；?film=demos/<名> → demos/<名>/eras.js（8 种 YouTube 语法示范）。
+// render.py / qa.py 用 --film 传。
+(() => { const f = new URLSearchParams(location.search).get('film');
+  const src = f && /^demos\/[a-z0-9_]+$/.test(f) ? `${f}/eras.js` : f && /^[a-z0-9_]+$/.test(f) ? `eras_${f}.js` : 'eras.js';
+  document.write(`<script src="${src}"><\/script>`); })();
+</script>
+<script src="transitions.js"></script>
+<script src="scenes/index.js"></script>
+<script src="engine.js"></script>
+</body></html>

package/engine/lib/THREE_LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright © 2010-2023 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/engine/lib/brush.js

@@ -0,0 +1,149 @@
+// 笔与水：毛笔飞白、两头尖单笔、墨晕晕染、长弯流线笔、水彩洗染、厚涂鬃毛笔、剪刀折线。全部挂在 PAINT（P）上。
+// 来源：迁移测试 A（水墨/蒙克）、B（吉卜力）、C（马蒂斯）、D（伦勃朗）。确定性：所有随机都走种子。
+//   P.brush(c, pts, opt)            毛笔：笔压起收＋湿笔芯＋逐根笔毛飞白，可按 reveal 写出（水墨、书法、白描衣纹）
+//   P.leaf(c, x, y, ang, L, w)      两头尖的单笔（竹叶、兰叶、鸟翅、虾尾）
+//   P.inkWash(c, key, grow, fn, o)  墨晕：形状先画到 scratch，再「外晕＋本体」两遍模糊 multiply 到纸上，grow 0→1 是洇开
+//   P.flowSeeds / P.flowLines       长弯流线笔：种子沿随时间扭动的方向场积分成 200–300px 的长笔（蒙克，不是梵高的短笔）
+//   P.deform / P.watercolor         水彩洗染：中点位移变形多边形 × 多层低 α multiply ＋ 每层淡描边＝水痕边（吉卜力背景）
+//   P.rectPts / P.ellipsePts        洗染常用的多边形点列
+//   P.impasto(c, pts, w, col, hi)   厚涂鬃毛笔：一笔＝若干平行细鬃（伦勃朗高光、梵高厚涂补笔）
+//   P.cut(pts, seed, step, amp)     剪刀折线：沿轮廓每 step px 取点＋抖动、直线相连（马蒂斯剪纸、剪影、木刻）
+(() => {
+let W = 1920, H = 1080; U.onStage((w, h) => { W = w; H = h; });   // 画布尺寸跟 U.setStage 走（默认 1920×1080）
+const P = window.PAINT;
+const { clamp, lerp, rng, ss } = U;
+
+// ---------- 毛笔 ----------
+// pts 控制点（会 Catmull-Rom 加密再按 4px 等弧长重采样——不重采样的话飞白噪声频率随笔画长短变）
+// w 最大宽；tone 墨色透明度（焦 .9／浓 .8／重 .6／淡 .35／清 .15）；dry 0..1 飞白程度（越到笔尾越干）；reveal 0..1 写出比例
+// head/tail 起笔/收笔占比；bristles 笔毛数；col 墨色 [r,g,b]；per 加密倍数
+// 坑：笔毛必须每根一条连续 path（butt 头）；按小段单独 stroke＋round 头，接头处会叠出一节节深点，像竹节/麻绳。
+P.brush = (c, pts, { w = 10, tone = 0.85, dry = 0.45, seed = 1, reveal = 1, bristles = 8, col = [16, 14, 12], head = 0.12, tail = 0.4, per = 5 } = {}) => {
+  if (reveal <= 0) return;
+  const D = KIT.resample(KIT.densify(pts, per), 4), n = D.length, m = Math.max(2, Math.ceil(n * clamp(reveal)));
+  const r = rng(seed * 7919);
+  const prof = q => ss(0, head, q) * (1 - 0.7 * ss(1 - tail, 1, q)) * (0.85 + 0.15 * P.noise(seed * 3.3, q * 6)) + 0.08;
+  c.save(); c.lineCap = 'butt'; c.lineJoin = 'round';
+  const N = [];
+  for (let i = 0; i < n; i++) { const A = D[Math.max(0, i - 1)], B = D[Math.min(n - 1, i + 1)]; let dx = B[0] - A[0], dy = B[1] - A[1]; const d = Math.hypot(dx, dy) || 1; N.push([-dy / d, dx / d]); }
+  const core = q => w * prof(q) * (1 - dry * 0.85 * Math.pow(q, 0.8));
+  // 湿的笔芯：整笔都有，越往后越细越淡（墨在用完）
+  c.fillStyle = `rgba(${col[0]},${col[1]},${col[2]},${tone * 0.72})`; c.fill(KIT.ribbon(D.slice(0, m), (q, i) => core(i / (n - 1))));
+  // 笔毛：每根一条连续线，按噪声断开（飞白＝笔毛之间露出的纸），越到笔尾断得越多
+  for (let k = 0; k < bristles; k++) {
+    const off = (k / (bristles - 1) - 0.5) * 0.95, bw = w / bristles * (0.9 + r() * 0.9), ph = r() * 50;
+    c.strokeStyle = `rgba(${col[0]},${col[1]},${col[2]},${tone * (0.45 + r() * 0.35)})`; c.lineWidth = Math.max(0.7, bw);
+    c.beginPath(); let on = false;
+    for (let i = 0; i < m; i++) {
+      const q = i / (n - 1), dryness = dry * Math.pow(q, 1.2);
+      const vis = P.noise(k * 1.9 + ph, i * 0.09) * 0.5 + 0.5 > dryness * 0.95 + 0.05;
+      const o = off * w * prof(q), x = D[i][0] + N[i][0] * o, y = D[i][1] + N[i][1] * o;
+      if (vis) { on ? c.lineTo(x, y) : c.moveTo(x, y); on = true; } else on = false;
+    }
+    c.stroke();
+  }
+  c.restore();
+};
+// 两头尖的单笔（个字竹叶、兰叶描、鸟翅）：沿 ang 方向长 L，最宽 wmax，微弯
+P.leaf = (c, x, y, ang, L, wmax, tone = 0.88, col = [16, 14, 12]) => {
+  if (!Array.isArray(col)) col = [16, 14, 12];
+  const pts = []; for (let i = 0; i <= 10; i++) { const q = i / 10, bend = Math.sin(q * Math.PI) * 0.08 * L; pts.push([x + Math.cos(ang) * L * q - Math.sin(ang) * bend, y + Math.sin(ang) * L * q + Math.cos(ang) * bend]); }
+  c.fillStyle = `rgba(${col[0]},${col[1]},${col[2]},${tone})`; c.fill(KIT.ribbon(pts, q => wmax * Math.pow(Math.sin(Math.PI * Math.min(1, q * 1.1)), 0.7) + 0.6));
+};
+
+// ---------- 墨晕 / 晕染层 ----------
+// fn(g) 在 scratch 上画形状（实色即可）；grow 0..1 控制洇开：外晕 blur 随 grow 变宽，本体 blur 随 grow 收紧。
+// halo 外晕模糊半径、haloA 外晕透明度、blur 本体模糊、alpha 整体透明度。返回 scratch（可再拿来做留白挖洞）。
+// 坑：multiply 是透明的，背后的墨线会透过晕染（窗台线透过猫耳）。先在剪影里补一层纸色（clip 后 drawImage 纸）再上晕染＝「先留出这块地方」。
+P.inkWash = (c, key, grow, fn, { blur = 2, halo = 10, haloA = 0.22, alpha = 1 } = {}) => {
+  const S = P.scratch('inkw_' + key), g = S.getContext('2d'); g.reset(); fn(g);
+  c.save(); c.globalCompositeOperation = 'multiply';
+  if (grow > 0) {
+    c.globalAlpha = haloA * alpha * grow; c.filter = `blur(${(halo * (0.4 + grow)).toFixed(2)}px)`; c.drawImage(S, 0, 0);
+    c.globalAlpha = alpha * ss(0, 0.6, grow); c.filter = `blur(${(blur * (1.6 - grow * 0.6)).toFixed(2)}px)`; c.drawImage(S, 0, 0);
+  }
+  c.filter = 'none'; c.restore();
+  return S;
+};
+
+// ---------- 长弯流线笔（蒙克《呐喊》式表现主义） ----------
+// 种子：cell 抖动网格，每个种子带两个随机数 [x, y, r1, r2]
+P.flowSeeds = (cell = 24, seed = 5) => { const r = rng(seed), o = []; for (let y = -10; y < H + 10; y += cell) for (let x = -10; x < W + 10; x += cell) o.push([x + (r() - .5) * cell, y + (r() - .5) * cell, r(), r()]); return o; };
+// 每个种子：region(x,y,t) 判区 → 取该区参数 params[reg] = [steps, step, width, alpha] → 沿 angle(x,y,t,reg) 积分；越出本区就停（区域边界干净）。
+// color(reg, sx, sy, r1, t) 返回 [r,g,b]。不描边、半透明叠色——蒙克是薄涂长笔；照搬梵高的深色描边会变成一节节毛毛虫短笔。
+// 底下先铺同色系平涂，笔缝里露出的是同色而不是黑。长度：steps 26–42、step 6–8，一根笔走 200–300px。
+P.flowLines = (c, seeds, { t = 0, region, angle, color, params, extraSteps = 8 }) => {
+  c.lineCap = 'round'; c.lineJoin = 'round';
+  for (const [sx, sy, r1, r2] of seeds) {
+    const reg = region(sx, sy, t); const pr = params[reg]; if (!pr) continue; const [steps, step, width, alpha] = pr;
+    const col = color(reg, sx, sy, r1, t);
+    let x = sx, y = sy; c.beginPath(); c.moveTo(x, y);
+    const n = steps + ((r2 * extraSteps) | 0);
+    for (let i = 0; i < n; i++) { const a = angle(x, y, t, reg); x += Math.cos(a) * step; y += Math.sin(a) * step; if (region(x, y, t) !== reg) break; c.lineTo(x, y); }
+    c.strokeStyle = P.rgb(col, alpha); c.lineWidth = width * (0.7 + r2 * 0.6); c.stroke();
+  }
+};
+
+// ---------- 水彩洗染（吉卜力式背景美术） ----------
+// 中点位移：每轮在每条边中点沿法向推一个近似高斯量（3 个均匀数相加），幅度与边长成比例，每轮 amp×0.6
+P.deform = (pts, depth, amp, r) => {
+  let out = pts;
+  for (let d = 0; d < depth; d++) {
+    const n = [];
+    for (let i = 0; i < out.length; i++) {
+      const a = out[i], b = out[(i + 1) % out.length], len = Math.hypot(b[0] - a[0], b[1] - a[1]);
+      const g = (r() + r() + r() - 1.5) * amp * Math.min(1, len / 80), nx = -(b[1] - a[1]) / (len || 1), ny = (b[0] - a[0]) / (len || 1);
+      n.push(a, [(a[0] + b[0]) / 2 + nx * g, (a[1] + b[1]) / 2 + ny * g]);
+    }
+    out = n; amp *= 0.6;
+  }
+  return out;
+};
+const fillPts = (g, pts) => { g.beginPath(); pts.forEach((q, i) => i ? g.lineTo(q[0], q[1]) : g.moveTo(q[0], q[1])); g.closePath(); };
+// 一次洗染：基形 deform 3 轮；每层再 deform 2 轮、低 α 填（multiply = 透明颜料叠色）、α=edge 描 1.6px 同色边（颜料在边缘沉积 = 水痕边）。
+// fill 可传渐变；不透明的白（窗框、云、桌布）用 blend:'source-over'、alpha .9。
+// 常用：大墙 layers5 α.4 amp12；色晕 layers3 α.045 amp40；木板 layers3 α.5 amp3 edge.14。
+// 坑：暗部用大幅变形多边形（amp 60），别用矩形拼——矩形接缝处会出硬边。色晕 α 别超 .05×3 层，否则房间像发霉的羊皮纸。
+P.watercolor = (g, pts, color, { layers = 7, alpha = 0.13, amp = 10, seed = 1, edge = 0.1, blend = 'multiply', fill } = {}) => {
+  const r = rng(seed * 7919 + 13), base = P.deform(pts, 3, amp, r);
+  g.save(); g.globalCompositeOperation = blend; g.lineJoin = 'round';
+  for (let k = 0; k < layers; k++) {
+    const q = P.deform(base, 2, amp * 0.55, r);
+    fillPts(g, q); g.globalAlpha = alpha; g.fillStyle = fill || color; g.fill();
+    if (edge) { g.globalAlpha = edge; g.strokeStyle = color; g.lineWidth = 1.6; g.stroke(); }
+  }
+  g.restore();
+};
+P.rectPts = (x, y, w, h) => [[x, y], [x + w, y], [x + w, y + h], [x, y + h]];
+P.ellipsePts = (cx, cy, rx, ry, n = 18) => Array.from({ length: n }, (_, i) => [cx + Math.cos(i / n * Math.PI * 2) * rx, cy + Math.sin(i / n * Math.PI * 2) * ry]);
+
+// ---------- 厚涂鬃毛笔 ----------
+// 一笔 = round(w/1.3) 条平行细鬃（亮度各自 ±17 抖、两端随机缩 0–25%）＋下侧一条淡投影＋上侧零星亮点 → 读成「被刷开的一坨厚颜料」。
+// 只用在受光处（金发、领口、瓷器、珍珠、白毛）。坑：画成「暗影＋主笔＋亮脊」三条整齐的线会读成白色贴纸/创可贴。
+P.impasto = (c, pts, w, col, hi) => {
+  const base = col.startsWith('#') ? P.hex(col) : [240, 230, 210];
+  const A = pts[0], B = pts[pts.length - 1], ang = Math.atan2(B[1] - A[1], B[0] - A[0]), nx = -Math.sin(ang), ny = Math.cos(ang);
+  const r = rng((A[0] * 13 + A[1] * 7) | 0), nb = Math.max(3, Math.round(w / 1.3));
+  c.save(); c.lineCap = 'round';
+  c.strokeStyle = 'rgba(40,18,6,.28)'; c.lineWidth = w * 0.9; c.beginPath(); pts.forEach((p, i) => i ? c.lineTo(p[0] + nx * w * 0.45 + 1, p[1] + ny * w * 0.45 + 1.5) : c.moveTo(p[0] + nx * w * 0.45 + 1, p[1] + ny * w * 0.45 + 1.5)); c.stroke();
+  for (let k = 0; k < nb; k++) {
+    const o = (k / (nb - 1) - 0.5) * w, s0 = r() * 0.25, s1 = 1 - r() * 0.25, sh = (r() - 0.5) * 34 + (k < nb / 2 ? 14 : -10);
+    c.strokeStyle = P.rgb([base[0] + sh, base[1] + sh, base[2] + sh * 0.8], 0.55 + r() * 0.4); c.lineWidth = 1.4 + r() * 1.2; c.beginPath();
+    const n = pts.length - 1; for (let i = 0; i <= 8; i++) { const q = lerp(s0, s1, i / 8), j = Math.min(n - 1, Math.floor(q * n)), f = q * n - j, x = lerp(pts[j][0], pts[j + 1][0], f) + nx * o, y = lerp(pts[j][1], pts[j + 1][1], f) + ny * o; i ? c.lineTo(x, y) : c.moveTo(x, y); }
+    c.stroke();
+  }
+  c.fillStyle = hi || 'rgba(255,250,232,.7)'; for (let k = 0; k < 2 + w / 3; k++) { const q = r(), x = lerp(A[0], B[0], q) - nx * w * 0.3, y = lerp(A[1], B[1], q) - ny * w * 0.3; c.beginPath(); c.arc(x, y, 0.9 + r(), 0, Math.PI * 2); c.fill(); }
+  c.restore();
+};
+
+// ---------- 剪刀折线 ----------
+// 把一圈（闭合）点列按 step 重采样，每点加 ±amp 种子抖动，直线相连 → 手剪纸的边。RIG 部件可用 path.pts 喂进来重剪。
+P.cut = (pts, seed, step = 18, amp = 2.5) => {
+  const r = rng(seed), out = [];
+  for (let i = 0; i < pts.length; i++) {
+    const a = pts[i], b = pts[(i + 1) % pts.length], L = Math.hypot(b[0] - a[0], b[1] - a[1]), n = Math.max(1, Math.round(L / step));
+    for (let k = 0; k < n; k++) { const q = k / n; out.push([lerp(a[0], b[0], q) + (r() - 0.5) * amp * 2, lerp(a[1], b[1], q) + (r() - 0.5) * amp * 2]); }
+  }
+  return U.poly(out);
+};
+})();

package/engine/lib/camera.js

@@ -0,0 +1,99 @@
+// 世界相机 CAM：解说片不是「一段段画＋转场」，而是「一张连续的世界画布＋一台相机」。
+// 铁律：相机只由全片时间（或本段时间）算出来，场景每帧按相机矢量重画——缩放转场永远清楚，不会把 1920 的位图放大 20 倍糊掉；
+//       引擎在转场窗口里会把上一段继续按 t 画进 A 缓冲，所以「上一镜的相机继续推」天然成立（live 推进）。
+// cam = { x, y, z, r }：世界点 (x,y) 落在画面中心，缩放 z（>1 推近），绕中心旋转 r（弧度）。缺省 x=960,y=540,z=1,r=0。
+(() => {
+let W = 1920, H = 1080; U.onStage((w, h) => { W = w; H = h; });   // 画布尺寸跟 U.setStage 走（默认 1920×1080）
+const { clamp, lerp } = U;
+const CAM = window.CAM = {};
+const n = cam => ({ x: cam.x ?? W / 2, y: cam.y ?? H / 2, z: cam.z ?? 1, r: cam.r || 0 });
+
+// 把相机变换作用到 c 上（不 save/restore，调用方负责）
+CAM.apply = (c, cam) => { const k = n(cam); c.translate(W / 2, H / 2); if (k.r) c.rotate(k.r); c.scale(k.z, k.z); c.translate(-k.x, -k.y); };
+// 在相机下画 fn(c)，自动 save/restore
+CAM.with = (c, cam, fn) => { c.save(); CAM.apply(c, cam); fn(c); c.restore(); };
+// 世界 → 屏幕 / 屏幕 → 世界
+CAM.toScreen = (cam, x, y) => { const k = n(cam); let dx = (x - k.x) * k.z, dy = (y - k.y) * k.z; if (k.r) { const cs = Math.cos(k.r), sn = Math.sin(k.r); [dx, dy] = [dx * cs - dy * sn, dx * sn + dy * cs]; } return [W / 2 + dx, H / 2 + dy]; };
+CAM.toWorld = (cam, sx, sy) => { const k = n(cam); let dx = sx - W / 2, dy = sy - H / 2; if (k.r) { const cs = Math.cos(-k.r), sn = Math.sin(-k.r); [dx, dy] = [dx * cs - dy * sn, dx * sn + dy * cs]; } return [k.x + dx / k.z, k.y + dy / k.z]; };
+
+// ---------- 缩放 ----------
+// 对数插值：z0→z1 每帧放大同样的倍数，观众感到「匀速穿越尺度」；线性插值会前慢后猛。所有推拉缩放都用它。
+CAM.zlerp = (z0, z1, e) => z0 * Math.pow(z1 / z0, e);
+// 「从一个半径 r 的圆形开口穿进去，开口要在转场结束前盖满屏」需要的最小放大倍数 = 开口中心到最远屏幕角的距离 / r。
+// 开口在画面中心时 ≈ 1101/r（卡片里写的「放大倍数 ≥ 1100/半径」）。小了，最后一帧开口没盖满会跳。
+CAM.coverZoom = (r, cx = W / 2, cy = H / 2) => Math.max(Math.hypot(cx, cy), Math.hypot(W - cx, cy), Math.hypot(cx, H - cy), Math.hypot(W - cx, H - cy)) / r;
+// 让世界点 (wx,wy) 在缩放 z 下出现在屏幕 (sx,sy)：返回相机。推近某物时让它平滑移到画面中心就靠它。
+CAM.anchor = (wx, wy, z, sx, sy) => ({ x: wx - (sx - W / 2) / z, y: wy - (sy - H / 2) / z, z });
+// 推进某个世界点：从 base 相机出发，缩放按对数插值到 Z（进度 e）；该点在屏幕上从原位置移向画面中心（进度 k，默认 = e；k=0 = 绕它原地推）。
+// 用于「钻进镜头」（y1）、「推满照片再硬切」（y2）、「推进最新数据点」（t3，k=0）。
+CAM.pushTo = (base, wx, wy, Z, e, k = e, to = [W / 2, H / 2]) => {
+  const s0 = CAM.toScreen(base, wx, wy), z = CAM.zlerp(n(base).z, Z, e);
+  return CAM.anchor(wx, wy, z, lerp(s0[0], to[0], k), lerp(s0[1], to[1], k));
+};
+
+// ---------- 关键帧 ----------
+// keys = [{t, x, y, z, r, ease}]；ease 作用在「从上一键到这一键」，默认 cubicInOut；z 用对数插值。
+// 沿路径平移（Vox 桌面、白板上的平移/甩镜）就是一串关键帧：平滑移动用 sineInOut，远跳用 cubicInOut＋运动模糊，沿线追用 MO.longTail。
+CAM.at = (keys, t) => {
+  if (t <= keys[0].t) return { ...keys[0] };
+  for (let i = 1; i < keys.length; i++) {
+    const a = keys[i - 1], b = keys[i];
+    if (t <= b.t) { const e = (b.ease || MO.cubicInOut)(MO.seg(t, a.t, b.t));
+      return { x: lerp(a.x, b.x, e), y: lerp(a.y, b.y, e), z: CAM.zlerp(a.z, b.z, e), r: lerp(a.r || 0, b.r || 0, e), v: e }; }
+  }
+  return { ...keys[keys.length - 1] };
+};
+
+// ---------- 镜头动作表（解说片用它；什么时候用哪一种见 references/镜头语言.md） ----------
+// 默认是过渡类动作：缓推 push、找下一件 glide、拉远 pull（0.6–1.5s，sineInOut / 长尾）；重音类：快推 punch、快移 pan、砸入 slam，
+// 留给揭晓、数字、反转。时长在 MO.PULSE。一支片子里推近要有来有回：推进去之后用 pull、glide 或硬切换开，别一镜接一镜只往里推。
+// CAM.track(base, events, t) → cam：base 是起始相机 {x, y, z}；events 是按时间排的镜头动作，相机只由 t 算出来（确定性，可跳帧）。
+// 每个动作从「上一个动作结束时的相机」出发，到 at + dur 落定；两个动作挨太近（上一个没走完下一个就开始）时，下一个从上一个此刻的位置接着走。
+//   {at, kind: 'push', k?, x?, y?, dur?}    缓推（不写 kind 就是它）：z 乘以 (1+k)（k 默认 0.2），0.9s sineInOut；给 x, y 就同时把这个世界点移到画面中心。
+//   {at, kind: 'pull', k?, x?, y?, z?, dur?} 拉远：z 乘以 (1+k)（k 默认 -1/6，正好抵消一次默认缓推；回全貌最稳是写 z: base.z），1.1s 长尾。推进去之后回到全貌、段落收束用它。
+//   {at, kind: 'glide', x, y, dur?}         找下一件：缩放不变，画面中心平滑移到世界点 (x, y)，0.7s sineInOut。同一面墙上从一件移到下一件。
+//   {at, kind: 'to', x?, y?, z?, dur?, ease?} 推到指定相机（推近截图上的一块：z 用 MD.zoomFor 算）；默认 0.9s sineInOut，写 dur: MO.PULSE.punch 就是重音。
+//   {at, kind: 'punch', k?, x?, y?, dur?}   快推（重音）：0.28s cubicInOut，k 默认 0.25（0.18–0.32）。k 可以写负数（快拉）。
+//   {at, kind: 'pan', x, y, dur?}            快移（重音）：同倍率 0.30s。视线突然转移、喜剧节奏用。
+//   {at, kind: 'slam', dur?, from?}          整帧砸入：z 额外乘 MO.slamK（1.55→0.94→1.0，0.17s）。大字、数字、盖章落下那一帧用。
+//   {at, kind: 'shake', amp?, dur?}          震镜：dur（默认 4 帧 ≈ 0.13s）内上下抖 amp 像素（默认 14），和砸入、盖章同帧用，一支片子别超过两次。
+//   {at, kind: 'cut', x?, y?, z?}            硬切到这台相机（不过渡）。换景别不一定要运镜，跳近一档就是硬切。
+// 返回的 cam 带 moving: true/false（这一刻是否在运动），给运动模糊、标签显隐用。
+CAM.track = (base, events, t) => {
+  let cam = { x: base.x ?? W / 2, y: base.y ?? H / 2, z: base.z ?? 1 }, zMul = 1, dy = 0, moving = false;
+  const evs = [...events].sort((a, b) => a.at - b.at);
+  for (const e of evs) {
+    if (t < e.at) break;
+    const P = MO.PULSE, kind = e.kind || 'push';
+    if (kind === 'cut') { cam = { x: e.x ?? cam.x, y: e.y ?? cam.y, z: e.z ?? cam.z }; continue; }
+    if (kind === 'slam') { const d = e.dur || P.slam, k = (t - e.at) / d; if (k < 1) { zMul *= MO.slamK(k, e.from); moving = true; } continue; }
+    if (kind === 'shake') { const d = e.dur || 4 / 30, k = (t - e.at) / d; if (k < 1) { dy += (e.amp ?? 14) * Math.sin(k * Math.PI * 4) * (1 - k) / cam.z; moving = true; } continue; }
+    const D = { pan: P.pan, punch: P.punch, glide: P.glide, pull: P.pull, push: P.push, to: P.push }[kind] ?? P.push;
+    const E = kind === 'punch' || kind === 'pan' || (e.dur && e.dur <= 0.35) ? MO.cubicInOut : kind === 'pull' ? MO.longTail : MO.sineInOut;   // 写了重音时长的 to 也用快推的曲线
+    const d = e.dur || D, p = (e.ease || E)(clamp((t - e.at) / d));
+    let to;
+    if (kind === 'pan' || kind === 'glide') to = { x: e.x ?? cam.x, y: e.y ?? cam.y, z: cam.z };
+    else if (kind === 'to') to = { x: e.x ?? cam.x, y: e.y ?? cam.y, z: e.z ?? cam.z };
+    else if (kind === 'pull') to = { x: e.x ?? cam.x, y: e.y ?? cam.y, z: e.z ?? cam.z * (1 + (e.k ?? -1 / 6)) };   // 默认 ×5/6，正好抵消一次默认缓推（×1.2）
+    else to = { x: e.x ?? cam.x, y: e.y ?? cam.y, z: cam.z * (1 + (e.k ?? (kind === 'push' ? 0.2 : P.k))) };
+    if (p < 1) moving = true;
+    cam = { x: lerp(cam.x, to.x, p), y: lerp(cam.y, to.y, p), z: CAM.zlerp(cam.z, to.z, p) };
+  }
+  return { x: cam.x, y: cam.y + dy, z: cam.z * zMul, moving };
+};
+
+// ---------- 视差 ----------
+// d=1 是主体平面，d<1 远、d>1 近。远层位移按 d 线性、缩放按 z^d：深推时远景几乎不动，这就是景深感（Kurzgesagt 5 层视差）。
+CAM.layer = (c, cam, d, fn) => { const k = n(cam); c.save(); CAM.apply(c, { x: lerp(W / 2, k.x, d), y: lerp(H / 2, k.y, d), z: Math.pow(k.z, d) }); fn(c); c.restore(); };
+
+// ---------- 运动 ----------
+// 相机在屏幕上的瞬时速度（像素/帧，60fps）：camFn(t) → cam。给 motionBlur 用。
+CAM.velocity = (camFn, t, dt = 1 / 60) => { const a = camFn(t), b = camFn(t - dt); const z = n(a).z; return [(n(a).x - n(b).x) * z, (n(a).y - n(b).y) * z]; };
+// 动态模糊：沿速度方向把整帧叠 n 次（快摇/甩镜用；速度 <1.5px 自动退化成一次绘制）。模糊长度应短于相机位移（PremiumBeat）。
+CAM.motionBlur = (c, src, vx, vy, k = 7) => {
+  const sp = Math.hypot(vx, vy); if (sp < 1.5) { c.drawImage(src, 0, 0); return; }
+  c.save(); for (let i = 0; i < k; i++) { const q = i / (k - 1) - 0.5; c.globalAlpha = i === 0 ? 1 : 1 / (i + 1); c.drawImage(src, -vx * q, -vy * q); } c.restore();
+};
+// 手持感微漂：两路不同周期的正弦（连续时间，不闪），返回 [dx, dy] 像素。只给艺术风格画面和纯氛围镜头；解说镜头停住时就停住，不加微漂
+CAM.drift = (t, amp = 6, seed = 0) => [amp * Math.sin(t * 0.9 + seed) + amp * 0.4 * Math.sin(t * 2.3 + seed * 2), amp * 0.7 * Math.sin(t * 1.1 + seed * 3)];
+})();