# 影片簡報的視覺元件(圖表、流程圖、動畫)

每章可放 `chNN.visuals.json`(與 `chNN.narration.json` 同資料夾),`tools/build-course-videos.sh` 會自動帶入 `--visuals=`。
格式:`{ "<簡報 key>": <spec>, … }`,key 是講稿 JSON 的 byKey 鍵(`單元標題#序號`),可用 `node tools/make-video2.mjs <章.php> x.mp4 --dump` 查看。

## 規格
共同欄位:`type`、`reveal`(陣列;第 i 個講稿項目〔0=標題〕播到時已揭露幾個單元,未給則均分)。
數字與文字只能取自該頁簡報/講義/講稿,不可自編。

| type | 內容 | 單元(reveal 的計數) |
|---|---|---|
| flow | nodes[{label,sub,color,kind:'end'}], layout row/snake/cycle/col | 節點 |
| bar | labels, values, unit, highlight | 長條 |
| line | x[], series[{name,y[],color}], min, max, markers[{x,y,label,at}] | 資料點 |
| funnel | stages[{label,value,rate}] | 階段 |
| table | head, rows, widths | 列 |
| cards | cards[{title,points,value}] | 卡片 |
| canvas | fill{格名→文字}, order[] | 格子(商業模式九宮格) |
| waterfall | items[{label,value,kind:'total'}], unit | 步驟 |
| pie | labels, values | 扇形 |

動畫:單元數改變時插入約 0.45 秒過場(淡入、長條長高、線條畫出)。標籤勿過長(流程圖節點約 6 字一行,最多兩行)。
範例:database/seeders/courses/biz-model-design/ch06.visuals.json。
