# ケースJSONの書式

1本の発表 = 1つの JSON。`cases/` に置きます。
`node tools/check.mjs` で検査、`node tools/build.mjs` で1枚HTMLに焼きます。

`text` 系のフィールドは **HTMLを書けます**（`<b>` `<em>` `<br>` `<span class="hit">`）。
ケースは自分で書くものなので、そのまま描画します。

---

## 全体

```jsonc
{
  "meta":     { ... },   // 作品情報とトンマナ
  "cast":     { ... },   // 登場人物
  "evidence": [ ... ],   // 証拠品
  "scenes":   [ ... ]    // 進行
}
```

## meta

| キー | 既定 | 意味 |
|---|---|---|
| `title` | — | 作品名。ブラウザのタイトルにもなる |
| `subtitle` | — | 画面右上の小さい文字 |
| `theme` | `court` | `court` / `lab` / `startup` / `warm` |
| `mode` | `story` | 進行形式。`story` / `quiz`（下記） |
| `lifeMax` | `5` | ライフの数。`0` でライフ表示なし。`story` では非表示 |
| `typeSpeed` | `22` | 文字送りのms。`0` で即時 |
| `startEvidence` | `[]` | 最初から持っている証拠のid |
| `allEvidenceFromStart` | `false` | 全部最初から持たせる |
| `learning.goal` | — | 何を学ばせたいか。**書くと自分が助かる** |
| `minutes` | — | 想定の尺。一覧に出る |

### 進行形式 — `story` と `quiz`

| | `story`（既定） | `quiz` |
|---|---|---|
| 証言 | **一本道。`→` だけで進む** | ループする。何度でも聞き直せる |
| ゆさぶり | 証言の次に**自動で流れる** | `P` で掘る |
| つきつけ | **自動。証拠を大きく出してから「異議あり！」** | 聴衆が `E` から選ぶ |
| ライフ | 出ない | 出る。お手つきで減る |
| 向く場面 | **発表・講演** | 研修・ワークショップ・テスト |

**既定を `story` にしているのは、本番のテンポのためです。**
30人の前で正解の証拠を探させると、そこで場が止まります。
一方で、研修として回すなら選ばせたほうが圧倒的に残る。だから**同じケースを両方で回せます。**

切り替えは3通り。**ケースを書き直す必要はありません。**

```
Q キー                               …… 発表中でも切り替わる
Esc → 目次の「クイズ形式に切り替え」
?mode=quiz                           …… URLで固定する
```

> `story` でも**つきつける瞬間は省きません。** 証拠を大きく出してから叫びに入ります。
> ここを飛ばすと、学びの核がどの根拠で崩れたのか分からないまま進んでしまいます。

## cast

```jsonc
"hero": {
  "name": "弁護人 ミライ",     // 名前プレートに出る文字
  "art":  "hero",              // 立ち絵のプリセット
  "side": "left",              // left / center / right
  "img":  "../assets/mirai.png",  // 画像（art より優先。無くてもよい）
  "poses": {                       // ポーズ単位で差し替え。1枚からでも効く
    "confident": "../assets/mirai-confident.png",
    "point": { "src": "../assets/mirai-point.png", "flip": true }  // 左右反転
  },
  "outfit": "#1d3a8f", "hairColor": "#1a1a22",
  "tie": "#d33", "skin": "#f6d5b8", "hair": "spike"
}
```

`art` プリセット: `hero` `prosecutor` `witness` `judge` `assistant` `expert` `detective`
`hair`: `spike` `slick` `bob` `long` `short` `messy` `beard` `none`

## evidence

```jsonc
{ "id": "ev-logical", "name": "論理量子ビットの値段",
  "icon": "chart",                  // doc chart photo quote code thing
  "desc": "一覧に出る短い説明",
  "detail": "つきつける前に読ませたい中身",
  "img": "assets/chart.png" }       // あれば icon より優先
```

## カメラ（画角）— 原作の芯はここ

**重要な指摘のとき、検討のときに、見ている角度が変わる。** それをやらないと、
同じ台詞でも紙芝居に落ちます。既定では**書かなくても自動で決まります**が、
決めの瞬間だけは明示すると効きます。

```jsonc
{ "who":"hero", "pose":"point", "text":"…",
  "shot":"point",        // 画角
  "angle":"defense",     // どの席から見ているか
  "move":"punch",        // 寄り方
  "dutch":-3,            // 追加で傾ける（度）
  "cinematic":true,      // 上下に黒帯を入れる
  "whip":true }          // 強制的に切り返す（通常は自動）
```

| `shot` | 画 | 使いどころ |
|---|---|---|
| `wide` | 全景 | シーンの頭、引いて状況を見せる |
| `mid` | バストアップ（既定） | 普通の会話 |
| `close` | 寄り | 重要な指摘 |
| `extreme` | 極寄り | 叫びの瞬間 |
| `low` | 煽り（下から） | 追い詰める、ゆさぶる |
| `high` | 俯瞰 | 突き放す、裁定する |
| `think` | やや寄り＋傾き | 検討している |
| `stare` | 中距離で止める | 睨み合い、ためる |
| `gallery` | 傍聴席 | 「ざわ……」 |
| **`point`** | **指差しの煽り** | **決め。最重要メッセージ** |
| **`slam`** | **机バンの煽り** | **決め。断言する** |
| `shock` | 真っ直ぐ寄る | ガーン（ダメージ） |

| `angle` | 視点 |
|---|---|
| `front` | 正面 |
| `defense` | 弁護席の側から法廷を見る |
| `prosecution` | 検察席の側から |
| `witness` | 証言台の正面 |
| `judge` | 裁判長席 |
| `gallery` | 傍聴席 |

| `move` | 寄り方 |
|---|---|
| `cut` | 瞬間的に切り替える |
| `snap` | 既定。素早く決まる |
| `punch` | 一気に寄る（決めの瞬間） |
| `push` | 喋りながらじわ寄り |
| `pull` | 引く |
| `drift` | ほぼ気づかない移動 |

### 自動でかかるもの（書かなくていい）

- **立ち位置が左右で入れ替わると、切り返し（ホイップパン）が入る**
- `pose` から画角が決まる（`point`→指差しの煽り、`damage`→ガーン、`think`→検討）
- `shout` があれば極寄り＋ダッチ角＋フラッシュ
- 喋っている間、気づかない速さで少しずつ詰める（静止画に見せない）
- `prefers-reduced-motion` が有効な環境では、動きを止める

> **絵の角度は、カメラでは作れません。** 指差しの煽りは「そういう角度で描かれた絵」が要ります。
> 生成プロンプトは [ILLUSTRATION-PROMPTS.md](ILLUSTRATION-PROMPTS.md) に用途ごとに置いてあります。

> **画像のパスは、ケースJSONから見た相対で書きます。** ケースは `cases/` にあるので
> リポジトリ直下の `assets/` へは `../assets/...`。取り込みは `npm run art -- <画像> <スロット> <ポーズ>`
> （マゼンタ背景の除去と余白の切り詰めまで自動）。詳しくは
> [ILLUSTRATION-PROMPTS.md](ILLUSTRATION-PROMPTS.md)。

## lines（セリフの並び）— 共通

```jsonc
{ "who": "hero",            // cast のキー。省略するとナレーション
  "text": "話す内容",
  "pose": "confident",      // normal talk confident shock think sweat damage point slam
  "side": "left",
  "bg": "courtroom",        // courtroom stand lobby dark white gallery
  "sfx": "gavel",           // gavel objection breakthrough wrong damage evidence
                            // press select move open close fanfare reveal
  "shot": "point",          // 画角（上の表。省略すると pose から自動）
  "angle": "defense",       // 視点
  "move": "punch",          // 寄り方
  "cinematic": true,        // 上下に黒帯
  "shout": "異議あり！",     // 叫び演出を挟んでから喋る
  "flash": true, "shake": true,
  "style": "testimony",     // testimony=緑 / press=水色
  "speed": 0,               // この行だけ文字送り速度を変える
  "note": "発表者ノート（H キーで表示）",
  "hideActor": true }
```

---

## シーン

### `title` — 表紙
```jsonc
{ "type":"title", "chapter":"開廷", "kicker":"CASE 001",
  "title":"争点を一行で", "sub":"副題", "cta":"Space で開廷" }
```

### `dialogue` — 会話
```jsonc
{ "type":"dialogue", "chapter":"導入", "bg":"courtroom", "lines":[ ... ] }
```

### `slide` — 講義パート（休廷）
```jsonc
{ "type":"slide", "chapter":"物理と論理", "kicker":"RECESS",
  "title":"見出し", "big":"でかい一言",
  "bullets":["1","2","3"],            // 5行まで
  "image": { "src":"assets/x.png", "caption":"出典" },
  "html":"<自由なHTML>", "footnote":"出典",
  "lines":[ ... ] }                   // スライドの後に会話を続けられる
```

### `evidence` — 証拠品を配る
```jsonc
{ "type":"evidence", "chapter":"証拠の開示",
  "give":["ev-1","ev-2"], "lines":[ ... ] }
```
**証拠は、つきつける場面より前に配ること。** `check.mjs` が検査します。

### `testimony` — 証言（本体）
```jsonc
{ "type":"testimony", "chapter":"証人ハイプの証言",
  "banner":"証言 — もう時間がない", "bg":"stand",
  "witness":"hype", "penalty":1, "shout":"異議あり！",
  "intro":[ ... ],
  "statements":[
    { "text":"証言1行", "pose":"confident", "note":"発表者ノート",
      "press":[ ... ],                    // P キーで掘る
      "weak":{                            // ★ムジュン
        "evidence":"ev-logical",
        "onCorrect":[ ... ],
        "onWrong":[ ... ] } }
  ] }
```
- `weak` を複数の証言に置ける。**全部突くまで次のシーンに進みません**
- 証言は `→` でループします。何度でも聞き直せます

### `choice` — 聴衆に選ばせる
```jsonc
{ "type":"choice", "chapter":"最終弁論", "question":"問い", "penalty":1,
  "options":[
    { "text":"外れ", "correct":false, "reply":[ ... ] },
    { "text":"正解", "correct":true, "shout":"異議なし！", "reply":[ ... ] } ] }
```

### `verdict` — 判決（回収）
```jsonc
{ "type":"verdict", "chapter":"判決", "kicker":"VERDICT",
  "title":"本日の認定事実",
  "takeaways":["持ち帰り1","2","3"], "cta":"R でもう一度" }
```

---

## 操作キー

| キー | 動作 |
|---|---|
| `Space` `→` `PageDown` クリック | 進む |
| `←` `PageUp` 右クリック | 戻る |
| `E` | 法廷記録（証言中は数字キーでつきつけ） |
| `P` | ゆさぶる |
| `Q` | 進行形式の切り替え（ストーリー ⇄ クイズ） |
| `Esc` | 目次（章ジャンプ） |
| `H` | 発表者ノート |
| `T` | タイマー / `M` 消音 / `F` 全画面 / `R` 最初から |

**クリッカーの `→` `←` だけで最後まで通せます。**
証拠をつきつける場面だけは、手元で数字キーかクリックが要ります。

## URL パラメータ

```
player/index.html?case=../cases/x.json&mode=quiz&scene=4&notes=1&timer=1&mute=1
```
`#4` のように hash でもシーンを指定できます（進むと自動で更新されます）。