referenceupdated v2growing

バカラアプリ仕様書インデックス

public/tools/baccarat/ に配置する Punto Banco バカラの仕様書群のインデックス。各実装セッションはこの索引から必要な分冊を参照する。

更新(2026-10-03)— split/bundle 規約へ再構築 + owner 指示-4 の UI 修正

この節が現行構成の正典。 初版が前提としたフラット構成(index.html + styles.css + フラットな *.js)は廃止し、 public/tools/baccarat/ を HTML Split/Bundle 規約 の split/bundle 規約に従う構成へ再構築した。 本節より下の「ファイル一覧」「依存図」「分冊一覧の生成ファイル名」は初版時点の履歴として読むこと (状態機械・ルール・入出力契約などの記述内容そのものは現行実装でも有効)。

現行のファイル構成

public/tools/baccarat/
├── manifest.json # ビルド用(scripts/html-build/* が読む)
├── pwa.webmanifest # PWA 用(旧 manifest.json。ビルド用と分離)
├── index.html # dev 形式テンプレート(split が再生成する)
├── js/NN-*.js # 10 本(entry = js/90-main.js)
├── styles/NN-*.css # 7 本
├── bundle/index.html # 生成物(追跡する)
├── tests/ # Node 実行の検証(js/*.js ではないので audit 対象外)
└── tmp/ # verify の一時領域(gitignore)

対応: rules.js→js/20-rules.js / shoe.js→js/10-shoe.js / game.js→js/50-game.js / roadmap.js→js/30-roadmap.js / persist.js→js/40-persist.js / sound.js→js/60-sound.js / ui-table.js→js/70-ui-table.js / ui-controls.js→js/80-ui-controls.js / main.js→js/90-main.js / css-vars.js→js/00-css-vars.js。styles.css は styles/10-base〜60-responsive.css に分割。 rules.html は sl-dialog.bcr-rules-dialog に統合して削除した。

検証コマンド(すべて exit 0 を確認済み):

node scripts/html-build/audit-imports.mjs --project baccarat
node scripts/html-build/bundle.mjs --project baccarat
node scripts/html-build/verify.mjs --project baccarat
node public/tools/baccarat/tests/test.mjs
node public/tools/baccarat/tests/game.test.mjs

CDN 依存の扱い(落とし穴)

bundle.mjs は <link rel="stylesheet"> をすべて除去する。したがって Pico.css / Shoelace dark theme の CDN 読み込みは <link> をやめ、styles/00-vendor.css の @import url(...) に移した(bundle 後は <style> の先頭に来る)。shoelace-autoloader.js(CDN の module script)は、ローカル entry の <script type="module" src> を先頭に置くことで、bundle が先頭 1 個だけを置換する性質を利用して温存している。

単一スコープ衝突の回避

bundle.mjs は相対 import を除去して全ファイルを 1 スコープに連結する。よって次が必要だった:

  • ui-controls.js の import * as G / import * as Sound(名前空間)は除去後に未定義になるため、名前を直接参照する形へ書き換えた(@import directive に全名を列挙)。
  • 同名トップレベル宣言は const 再宣言エラーになる。shoe.js の CUT_CARD_POSITION は SHOE_CUT_CARD_POSITION に改名した(game.js が同名を export しているため)。
  • Alpine メソッド名 shoeProgress は shoe.js の export と衝突して audit の [missing] を誘発するため shoeProgressRatio に改名した。

owner 指示-4(2026-10-03)の UI 修正

#指示対応
1手元のチップの文字がはみ出す.bcr-chip に display:grid; place-items:center; padding:0; line-height:1(Pico の button padding が円から文字を押し出していた)
2場のカードがカード枚数で横長長方形になる.bcr-card { flex:0 0 auto; aspect-ratio:56/80 } + .bcr-hand-cards { align-items:flex-start; align-content:flex-start }(flex 既定の stretch で縦横に伸縮していた)
3a路の「隠す」ボタンが無意味/小型表示+クリックで詳細ヘッダーの路トグルを撤去。section.bcr-roadmap を珠盤路・大路の小型プレビュー 2 枚にし、タップで sl-dialog.bcr-roadmap-dialog(詳細+派生路)を開く。ui-table.js は 1 回の計算で小型・詳細の両方へ描く([data-bcr-roadmap-mini] を追加)
3b設定・鍵盤操作に日本語がある繁体字 + 英語のみへ統一(ディーラーコール→荷官呼叫/チップ選択→籌碼選擇/ベット→下注/ドラッグ→拖曳/ヘルプ→說明/閉じる→關閉 等)
3c鍵盤操作が白背景 × 白文字で読めないsl-dialog.<class>::part(panel) の背景を明示(Shoelace ダークテーマ CDN が効かない環境でも読める)。対象は全 bcr ダイアログ

副次: .bcr-app { max-width: 560px }(スマホ特化の縦長を標準に)。大路のタイ数バッジは インライン style を .bcr-big-cell-tie-count クラスへ移した。


目的

public/tools/baccarat/ に配置する Punto Banco バカラの実装を、複数の独立セッションで並列生成するための仕様書群。

各実装セッションは以下2点だけ受け取れば、他ファイルの実装を見ずに自分の担当ファイルを完成させられる:

  1. Core 分冊(2026-09-26-baccarat-spec-core と 2026-09-26-baccarat-spec-types)
  2. 担当モジュールの分冊

分冊一覧

共通(全セッションに渡す)

  • 2026-09-26-baccarat-spec-core — スタック、ディレクトリ、命名、依存方向、状態機械、エラー方針
  • 2026-09-26-baccarat-spec-types — 全データ型定義(TypeScript 風、実行しない)

モジュール別(担当セッションに渡す)

#分冊生成ファイル純不純
12026-09-26-baccarat-spec-rulesrules.js純関数
22026-09-26-baccarat-spec-shoeshoe.js副作用あり(乱数)
32026-09-26-baccarat-spec-gamegame.js状態機械
42026-09-26-baccarat-spec-roadmaproadmap.js純関数
52026-09-26-baccarat-spec-persistpersist.jslocalStorage 副作用
62026-09-26-baccarat-spec-soundsound.jsWeb Audio 副作用
72026-09-26-baccarat-spec-dom(DOM 骨格仕様、複数ファイル共有)─
82026-09-26-baccarat-spec-stylesstyles.css─
92026-09-26-baccarat-spec-ui-tableui-table.jsAlpine コンポーネント
102026-09-26-baccarat-spec-ui-controlsui-controls.jsAlpine コンポーネント
112026-09-26-baccarat-spec-mainmain.js結線
122026-09-26-baccarat-spec-index-htmlindex.html─

セッション実行順序

理論上 S1〜S12 は並列可能だが、逐次で回すなら以下順序を推奨:

  1. Core + Types(S0、既にこの仕様書群として完成)
  2. rules → shoe → roadmap → persist → sound(純度高い順、独立)
  3. game(上記に依存)
  4. DOM + styles(見た目、独立)
  5. ui-table + ui-controls(game と DOM に依存)
  6. main + index.html(結線)

品質基準

  • 1ファイル 500 行以内
  • Punto Banco ルール完全準拠(2026-09-26-baccarat-spec-rules の 3rd カード表参照)
  • UI は繁体字中文主・英語小さく併記、切替機構なし
  • リロード後も残高・履歴・シュー状態が復元される
  • キーボード操作対応(Space=Deal、数字キー=チップ選択)
  • Chrome/Edge/Firefox/Safari 最新版で動作(File System Access API 不使用)
src/content/ja/reference/2026-09-26-baccarat-spec-core.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - Core(共通規約)
description: バカラアプリ全ファイルに共通する規約。スタック、ディレクトリ、命名、依存方向、状態機械、エラー方針、UI言語規約を定める。全実装セッションに必ず渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-types
---
## 1. スタック
CDN 読み込みのみ。ビルド不要。バージョン固定。
| 用途 | ライブラリ | バージョン | 用途 |
|---|---|---|---|
| UI コンポーネント | Shoelace | 2 系 | ダイアログ、ボタン、ドロップダウン |
| 状態管理 | Alpine.js | 3 系 | 宣言的 UI |
| ベーススタイル | Pico.css | 2 系 | classless ベース |
| フォント | Noto Sans TC | ─ | OS フォールバック可、CDN 不使用 |
Dexie / File System Access API は本アプリでは使わない(localStorage で足りる)。
## 2. ディレクトリと配置

public/tools/baccarat/ ├── index.html ├── styles.css ├── main.js ├── rules.js ├── shoe.js ├── game.js ├── roadmap.js ├── persist.js ├── sound.js ├── ui-table.js └── ui-controls.js

URL: `/tools/baccarat/`
## 3. モジュール規約
- 全 JS ファイルは ES Modules(`<script type="module">`)
- 相対パスで import(`import { ... } from './rules.js'`)
- 拡張子 `.js` を必ず付ける
- 名前付き export のみ(default export 禁止)
- 1 ファイル 500 行以内
## 4. 依存方向(一方向、循環禁止)

index.html └─ main.js ├─ ui-table.js │ └─ game.js ├─ ui-controls.js │ ├─ game.js │ └─ persist.js ├─ persist.js ├─ sound.js └─ game.js ├─ rules.js ├─ shoe.js └─ roadmap.js

- `rules.js` `roadmap.js` は純関数のみ、他モジュール import 禁止
- `shoe.js` は乱数を持つが他モジュール非依存
- `game.js` は rules/shoe/roadmap のみ依存、DOM 非依存
- UI 層(ui-*.js)は game/persist/sound を呼ぶが、rules/shoe/roadmap を直接呼ばない
- `persist.js` `sound.js` は独立、他モジュール非依存
## 5. 命名規約
### JS
- 関数・変数: `camelCase`
- 定数: `UPPER_SNAKE_CASE`
- 型(JSDoc 内のみ): `PascalCase`
### CSS クラス
- prefix `bcr-` 固定
- 例: `bcr-table`, `bcr-card`, `bcr-chip`, `bcr-hand--player`
### data 属性
- prefix `data-bcr-`
- 例: `data-bcr-slot="p1"`, `data-bcr-side="banker"`
### CSS 変数
- prefix `--bcr-`
- 例: `--bcr-deal-duration`, `--bcr-color-player`
### localStorage キー
- prefix `bcr:`
- 例: `bcr:state:v1`, `bcr:settings:v1`
## 6. 状態機械(game.js の phase)

idle ↓ (startBetting) betting ───(clearBets)──→ betting ↓ (deal, ベット額 > 0) dealing ← 初期2枚ずつ配布、アニメ約1.6秒 ↓ (auto) third_card ← rules.js の draw 判定、必要ならカード追加 ↓ (auto) reveal ← 結果ハイライト、約1秒 ↓ (auto) settling ← 残高更新、履歴追加、ロードマップ更新 ↓ (auto) idle ← シュー切れなら shuffling へ ↓ shuffling ← 新シュー生成、カット表示、約1秒 ↓ (auto) idle

- 遷移は必ず `game.js` が発火する
- UI 層は phase を読むだけ、直接書き換え禁止
- 各遷移は `document` に `bcr:phase-change` カスタムイベントを dispatch する
## 7. 定数
`game.js` 内で export される定数:
| 名前 | 値 | 意味 |
|---|---|---|
| `INITIAL_BALANCE` | 1000 | 初期残高 |
| `MIN_BET` | 1 | 最小ベット単位 |
| `MAX_BET` | 500 | 1エリアあたり最大ベット |
| `DECKS_PER_SHOE` | 8 | 1シュー内のデッキ数 |
| `CUT_CARD_POSITION` | 14 | シュー末尾からこの枚数でシュー切れ扱い |
| `PAYOUT_PLAYER` | 1.0 | Player 配当倍率(元返し + 1倍) |
| `PAYOUT_BANKER` | 0.95 | Banker 配当倍率(コミッション5%) |
| `PAYOUT_TIE` | 8.0 | Tie 配当倍率 |
| `HISTORY_MAX` | 100 | 履歴保持数 |
## 8. アニメーション時間(CSS 変数、単一の真実の源)
`styles.css` の `:root` で定義:
| 変数 | 値 | 用途 |
|---|---|---|
| `--bcr-deal-duration` | `400ms` | カード1枚配布時間 |
| `--bcr-deal-interval` | `200ms` | カード配布間隔 |
| `--bcr-flip-duration` | `300ms` | カードめくり時間 |
| `--bcr-reveal-duration` | `1000ms` | 結果ハイライト時間 |
| `--bcr-shuffle-duration` | `1000ms` | シャッフル演出時間 |
JS 側は `getComputedStyle(document.documentElement).getPropertyValue('--bcr-deal-duration')` で読み、`parseInt` して setTimeout に渡す。ヘルパー `getCssMs(name)` を `game.js` に置く。
## 9. UI 言語規約
- 主表記: 繁体字中文
- 副表記: 英語(小さく併記、`<span class="bcr-en">Player</span>` 形式)
- CSS: `.bcr-en { font-size: 0.65em; opacity: 0.6; margin-left: 0.3em; }`
- 切替機構なし、全てハードコード
### 用語対訳表
| 中文 | 英語 | 用途 |
|---|---|---|
| 閒 | Player | ベットエリア |
| 莊 | Banker | ベットエリア |
| 和 | Tie | ベットエリア |
| 發牌 | Deal | ボタン |
| 下注 | Bet | 汎用 |
| 取消 | Clear | ボタン |
| 餘額 | Balance | 表示 |
| 賭注 | Stake | 現在の総ベット |
| 派彩 | Payout | 精算表示 |
| 佣金 | Commission | Banker 5% 説明 |
| 天牌 | Natural | 8/9 のナチュラル |
| 補牌 | Draw | 3枚目 |
| 例牌 | Stand | 追加なし |
| 靴 | Shoe | カード束 |
| 洗牌 | Shuffle | シャッフル |
| 珠盤路 | Bead Plate | ロードマップ |
| 大路 | Big Road | ロードマップ |
| 破產 | Bust | 残高0 |
| 重新開始 | Restart | ボタン |
## 10. エラー方針
- LLM 実装は `try/catch` を最小限に留める(バグを隠す原因になる)
- 事前条件違反は `throw new Error('bcr: ...')` で即座に停止
- ユーザー入力起因(残高不足等)は `game.js` が false を返し、UI が Shoelace の `<sl-alert>` で通知
## 11. 禁止事項(全ファイル共通)
- `console.log` を残さない(デバッグ時のみ、コミット前に削除)
- `setTimeout` に生の数値を書かない(必ず CSS 変数経由)
- `Math.random` を `shoe.js` 以外で使わない
- グローバル変数を作らない(module scope のみ)
- jQuery 等の追加ライブラリを import しない
- CSS の `!important` を使わない
- インライン `style=""` を使わない(CSS 変数の設定を除く)
## 12. アクセシビリティ最低ライン
- ベットエリアは `<button>` 要素
- カード領域は `role="region" aria-label="..."`
- 残高・ベット額は `aria-live="polite"` で読み上げ対応
- キーボード操作: Space=Deal、Esc=Clear、数字1-5=チップ選択、Enter=確認
src/content/ja/reference/2026-09-26-baccarat-spec-types.md
---
date: 2026-09-26
title: バカラ仕様 - Types(データ型定義)
description: バカラアプリ全モジュールで共有される型定義。TypeScript 風記法で書くが実装は素の JavaScript。全実装セッションに必ず渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
---
## 型定義の扱い
- 全て JSDoc コメントで表現、実行時型チェックは行わない
- 型は本仕様書が SSOT、各ファイルは JSDoc で再宣言してよい
- オブジェクトの形状は本仕様に厳密に従う(プロパティの追加・省略禁止)
## 基本型
### Card

Card = { rank: ‘A’ | ‘2’ | ‘3’ | ‘4’ | ‘5’ | ‘6’ | ‘7’ | ‘8’ | ‘9’ | ‘10’ | ‘J’ | ‘Q’ | ‘K’, suit: ‘S’ | ‘H’ | ‘D’ | ‘C’, // Spade, Heart, Diamond, Club value: number // バカラでの価値: A=1, 2-9=額面, 10/J/Q/K=0 }

生成時に `value` を確定させる。以降変更不可(immutable として扱う)。
### Hand

Hand = { cards: Card[], // 2 または 3 枚 total: number // (cards.value の合計) mod 10、0-9 }

### BetArea

BetArea = ‘player’ | ‘banker’ | ‘tie’

### Bet

Bet = { on: BetArea, amount: number // 正の整数、MIN_BET 以上、MAX_BET 以下 }

### RoundResult

RoundResult = { winner: BetArea, // 勝ちエリア player: Hand, // 確定した Player ハンド banker: Hand, // 確定した Banker ハンド natural: boolean, // 初期2枚で 8/9 が出たか payouts: { // 各ベットに対する支払い(賭け金含む戻り総額) player: number, banker: number, tie: number } }

- winner が `player` の時: player ベットは元金 + 元金、banker ベットは没収、tie ベットは没収
- winner が `banker` の時: banker ベットは元金 + 元金×0.95(floor)、player ベットは没収、tie ベットは没収
- winner が `tie` の時: tie ベットは元金 + 元金×8、player/banker ベットは**返却**(Push、没収されない)
### HistoryEntry

HistoryEntry = { index: number, // 1 始まり、シュー内通し番号 winner: BetArea, playerTotal: number, // 0-9 bankerTotal: number, // 0-9 natural: boolean, bets: Bet[], // このラウンドで置かれたベット(表示用) net: number // このラウンドの純損益(+/-の整数) }

### Shoe

Shoe = { cards: Card[], // 残りカード、末尾から draw する drawn: number, // draw 済み枚数 total: number, // 初期総枚数(DECKS_PER_SHOE * 52) needsShuffle: boolean // cards.length <= CUT_CARD_POSITION で true }

破壊的更新(`drawCard` が cards.pop する)。
### GameState

GameState = { phase: ‘idle’ | ‘betting’ | ‘dealing’ | ‘third_card’ | ‘reveal’ | ‘settling’ | ‘shuffling’, balance: number, // 現在残高 currentBets: { // ベット中の額(confirm 済み) player: number, banker: number, tie: number }, selectedChip: number, // 現在選択中のチップ額面、CHIP_VALUES のいずれか playerHand: Hand, // 現在のラウンドの player 手(配布中は途中経過) bankerHand: Hand, // 同 banker shoe: Shoe, history: HistoryEntry[], // 新しいものが末尾、長さ HISTORY_MAX まで lastResult: RoundResult | null,// 直近ラウンドの結果、settling 後にセット totalRounds: number, // このシュー内の通しラウンド番号 bankrupt: boolean // 残高0かつベット不能で true }

### Settings

Settings = { soundEnabled: boolean, // デフォルト true showBigRoad: boolean, // デフォルト true showBeadPlate: boolean // デフォルト true }

### PersistedData

PersistedData = { version: 1, // スキーマバージョン state: GameState, // 一部フィールドは復元時に再初期化される(下記参照) settings: Settings, savedAt: string // ISO 8601 日時 }

**復元時の再初期化**:
- `phase` は必ず `'idle'` に戻す(保存中の中間状態を復元しない)
- `playerHand` `bankerHand` は空 Hand `{cards:[], total:0}` にリセット
- `currentBets` はゼロクリア
- `lastResult` は null
- 残す: `balance`, `shoe`, `history`, `totalRounds`, `selectedChip`, `bankrupt`
## 定数値

CHIP_VALUES = [1, 5, 25, 100, 500] // ui-controls.js が使う

## 空値の慣習
- 空 Hand: `{ cards: [], total: 0 }`
- 空ベット: `{ player: 0, banker: 0, tie: 0 }`
- null は `lastResult` のみで使用、他は空値表現を優先
src/content/ja/reference/2026-09-26-baccarat-spec-rules.md
---
date: 2026-09-26
title: バカラ仕様 - rules.js(Punto Banco ルール)
description: Punto Banco の 3rd カードルールを含むゲームロジック純関数群。乱数・DOM 非依存。担当セッションに Core + Types と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
---
## ファイル
`public/tools/baccarat/rules.js`
## 責務
- カード価値計算
- ハンド合計計算
- Player / Banker の 3rd カード draw 判定
- 勝敗判定
- 配当計算
## 禁止事項
- 乱数を使わない(`Math.random` 禁止)
- DOM を触らない
- 他モジュールから import しない
- console.log を残さない
- 副作用のある処理を書かない(引数を破壊的変更しない)
## Export API
### cardValue

export function cardValue(rank: Card[‘rank’]): number

- 事前: rank は Card の rank として正当
- 事後: 0..9 の整数を返す
- 仕様: 'A' → 1、'2'..'9' → 数値、'10'/'J'/'Q'/'K' → 0
### handTotal

export function handTotal(cards: Card[]): number

- 事前: cards は 0..3 枚
- 事後: 0..9 の整数
- 仕様: cards の value 合計を 10 で割った余り
### isNatural

export function isNatural(playerCards: Card[], bankerCards: Card[]): boolean

- 事前: それぞれ 2 枚ちょうど
- 事後: player または banker の handTotal が 8 か 9 なら true
### shouldPlayerDraw

export function shouldPlayerDraw(playerTotal: number): boolean

- 事前: 0 <= playerTotal <= 9
- 事後: playerTotal <= 5 なら true、それ以外 false
- 注意: この関数はナチュラル判定(8/9 で止まる)を含まない。呼び出し側でナチュラルチェックを先に行うこと
### shouldBankerDraw

export function shouldBankerDraw(bankerTotal: number, playerThirdCard: Card | null): boolean

- 事前: 0 <= bankerTotal <= 9
- 事後: 3rd カードルールに従う真偽値
**実装方針**: if 文の入れ子で書かず、テーブル参照で書く。
**Punto Banco 3rd カード ルール表**(Banker 側):
Player が 3枚目を引かなかった場合(Player 6 か 7 で stand):
- Banker total 0-5: draw
- Banker total 6-7: stand
Player が 3枚目を引いた場合、Player 3rd カードの value による表:
| Banker Total | Player 3rd card value | Banker action |
|---|---|---|
| 0, 1, 2 | 任意 | draw |
| 3 | 0, 1, 2, 3, 4, 5, 6, 7, 9 | draw |
| 3 | 8 | stand |
| 4 | 2, 3, 4, 5, 6, 7 | draw |
| 4 | 0, 1, 8, 9 | stand |
| 5 | 4, 5, 6, 7 | draw |
| 5 | 0, 1, 2, 3, 8, 9 | stand |
| 6 | 6, 7 | draw |
| 6 | 0, 1, 2, 3, 4, 5, 8, 9 | stand |
| 7 | 任意 | stand |
| 8, 9 | ─ | ナチュラル、この関数は呼ばれない |
**実装例(テーブル駆動)**:
```javascript
// bankerTotal を index、Player 3rd card value (0..9) を index とする 2次元配列
// true = draw, false = stand
// Player が引かなかった場合は playerThirdCard === null で分岐
const BANKER_DRAW_TABLE = [
// 0 1 2 3 4 5 6 7 8 9 ← player 3rd value
[true, true, true, true, true, true, true, true, true, true], // banker 0
[true, true, true, true, true, true, true, true, true, true], // banker 1
[true, true, true, true, true, true, true, true, true, true], // banker 2
[true, true, true, true, true, true, true, true, false, true], // banker 3
[false,false,true, true, true, true, true, true, false,false], // banker 4
[false,false,false,false,true, true, true, true, false,false], // banker 5
[false,false,false,false,false,false,true, true, false,false], // banker 6
[false,false,false,false,false,false,false,false,false,false], // banker 7
];

Player が引かなかった場合の判定は別途 if で分岐:

if (playerThirdCard === null) {
return bankerTotal <= 5;
}
return BANKER_DRAW_TABLE[bankerTotal][playerThirdCard.value];

resolve

export function resolve(player: Hand, banker: Hand): { winner: BetArea, natural: boolean }
  • 事前: player.cards.length は 2 または 3、banker も同様、total は再計算済み
  • 事後: winner と natural(初期2枚時点でナチュラルだったか)を返す
  • 仕様:
    • player.total > banker.total → winner = ‘player’
    • banker.total > player.total → winner = ‘banker’
    • 同点 → winner = ‘tie’
    • natural は最終ハンドが 8/9 で決まったかつ 2枚のみで確定した場合 true

calcPayouts

export function calcPayouts(bets: {player:number, banker:number, tie:number}, winner: BetArea): {player:number, banker:number, tie:number}
  • 事前: bets の各値は 0 以上の整数
  • 事後: 各エリアに戻される金額(賭け金含む総額)
  • 仕様:
    • winner === ‘player’: {player: bets.player*2, banker: 0, tie: 0}
    • winner === ‘banker’: {player: 0, banker: bets.banker + Math.floor(bets.banker * 0.95), tie: 0}
    • winner === ‘tie’: {player: bets.player, banker: bets.banker, tie: bets.tie * 9} (player/banker は Push で元金返却、tie は 8:1 なので元金+8倍=9倍)

検証ケース(実装後に手動確認する)

cardValue('A') === 1
cardValue('9') === 9
cardValue('10') === 0
cardValue('K') === 0
handTotal([{value:5},{value:5}]) === 0
handTotal([{value:7},{value:8}]) === 5
handTotal([{value:1},{value:9},{value:3}]) === 3
isNatural([{value:8},{value:0}], [{value:5},{value:3}]) === true
isNatural([{value:5},{value:3}], [{value:5},{value:3}]) === false
shouldPlayerDraw(5) === true
shouldPlayerDraw(6) === false
shouldPlayerDraw(0) === true
shouldBankerDraw(3, {value:8}) === false
shouldBankerDraw(3, {value:7}) === true
shouldBankerDraw(6, {value:6}) === true
shouldBankerDraw(6, {value:5}) === false
shouldBankerDraw(7, {value:0}) === false
shouldBankerDraw(2, null) === true
shouldBankerDraw(6, null) === false
// calcPayouts
calcPayouts({player:100,banker:0,tie:0}, 'player') → {player:200, banker:0, tie:0}
calcPayouts({player:0,banker:100,tie:0}, 'banker') → {player:0, banker:195, tie:0}
calcPayouts({player:100,banker:100,tie:50}, 'tie') → {player:100, banker:100, tie:450}

ファイル冒頭に置くコメント例

// rules.js — Punto Banco ルール純関数群
// 依存なし。乱数・DOM 使用禁止。
// 仕様: baccarat-spec-rules を参照。

想定行数

150 行以内。テーブル定義とシンプルな関数のみ。

src/content/ja/reference/2026-09-26-baccarat-spec-shoe.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - shoe.js(シュー管理)
description: 8デッキシューの生成・シャッフル・draw を担当。乱数を持つ唯一のロジックモジュール。担当セッションに Core + Types と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
---
## ファイル
`public/tools/baccarat/shoe.js`
## 責務
- 8デッキ(416枚)のシュー生成
- Fisher-Yates シャッフル
- カード draw
- シュー切れ判定
## 禁止事項
- DOM を触らない
- 他モジュールから import しない
- console.log を残さない
- `array.sort(() => Math.random() - 0.5)` は禁止(偏る)
- Card オブジェクトの value を手計算せず、下記 CARD_VALUES 表を使う
## Export API
### createShoe

export function createShoe(deckCount: number = 8): Shoe

- 事前: deckCount は 1 以上の整数
- 事後: シャッフル済みの新しい Shoe を返す
- 仕様:
- deckCount * 52 枚のカードを生成
- Fisher-Yates でシャッフル
- `{ cards, drawn: 0, total: deckCount*52, needsShuffle: false }`
### drawCard

export function drawCard(shoe: Shoe): Card

- 事前: shoe.cards.length > 0
- 事後: shoe.cards の末尾から 1 枚取り出して返す
- 破壊的: shoe.cards は length が 1 減る、shoe.drawn は 1 増える、cards.length <= CUT_CARD_POSITION なら needsShuffle = true
- 事前条件違反時は `throw new Error('bcr: shoe empty')`
### shoeRemaining

export function shoeRemaining(shoe: Shoe): number

- 事後: shoe.cards.length を返す
### shoeProgress

export function shoeProgress(shoe: Shoe): number

- 事後: 0.0〜1.0 の実数(drawn / total)
## 実装詳細
### CARD_VALUES 表
```javascript
const CARD_VALUES = {
'A': 1, '2': 2, '3': 3, '4': 4, '5': 5,
'6': 6, '7': 7, '8': 8, '9': 9,
'10': 0, 'J': 0, 'Q': 0, 'K': 0
};
const RANKS = ['A','2','3','4','5','6','7','8','9','10','J','Q','K'];
const SUITS = ['S','H','D','C'];

Fisher-Yates(正しい実装)

function shuffle(array) {
for (let i = array.length - 1; i > 0; i--) {
const j = Math.floor(Math.random() * (i + 1));
[array[i], array[j]] = [array[j], array[i]];
}
return array;
}

CUT_CARD_POSITION

Core §7 で定義される定数 CUT_CARD_POSITION = 14 を使うが、shoe.js 内では他モジュール依存禁止のため、shoe.js 内に定数として再宣言する:

const CUT_CARD_POSITION = 14;

Core を変更したら shoe.js も追随する運用。両方で同じ値を維持する責任は保守者にある。

検証ケース

const shoe = createShoe(8);
shoe.cards.length === 416
shoe.total === 416
shoe.drawn === 0
shoe.needsShuffle === false
// 全カードの構成確認
const counts = {};
for (const c of shoe.cards) {
const key = c.rank + c.suit;
counts[key] = (counts[key] || 0) + 1;
}
// 各 rank×suit = 8 枚のはず(8デッキなので)
Object.values(counts).every(v => v === 8) === true
// draw
const c = drawCard(shoe);
c.rank !== undefined
c.suit !== undefined
c.value === CARD_VALUES[c.rank]
shoe.cards.length === 415
shoe.drawn === 1
// カット位置まで draw
while (shoe.cards.length > 14) drawCard(shoe);
shoe.needsShuffle === true
// 空 draw エラー
while (shoe.cards.length > 0) drawCard(shoe);
try { drawCard(shoe); } catch(e) { /* エラー確認 */ }

想定行数

80 行以内。

src/content/ja/reference/2026-09-26-baccarat-spec-game.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - game.js(状態機械)
description: バカラのゲーム状態機械。ベット受付・カード配布・3rd カード判定・精算・履歴管理を統括。UI からの唯一の入り口。担当セッションに Core + Types + rules 仕様 + shoe 仕様と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
- 2026-09-26-baccarat-spec-rules
- 2026-09-26-baccarat-spec-shoe
---
## ファイル
`public/tools/baccarat/game.js`
## 責務
- GameState の生成・保持・更新
- 状態機械の遷移制御
- ベット受付・検証
- rules.js を呼んでカード判定
- shoe.js を呼んでカード draw
- 履歴 HistoryEntry の追加
- カスタムイベント dispatch
- 定数 export
## 依存
- `./rules.js`
- `./shoe.js`
- `./roadmap.js`(履歴を渡す関係で参照するが、game.js 側は roadmap 計算結果を持たない)
roadmap.js への依存は最小限(型のみ)。実際の roadmap 描画は ui 層が行う。
## 禁止事項
- DOM を触らない
- localStorage を触らない(persist.js の責務)
- 音を鳴らさない(sound.js の責務)
- setTimeout の数値を直書きしない(getCssMs 経由)
## Export
### 定数
Core §7 の定数をすべて export:
```javascript
export const INITIAL_BALANCE = 1000;
export const MIN_BET = 1;
export const MAX_BET = 500;
export const DECKS_PER_SHOE = 8;
export const CUT_CARD_POSITION = 14;
export const PAYOUT_PLAYER = 1.0;
export const PAYOUT_BANKER = 0.95;
export const PAYOUT_TIE = 8.0;
export const HISTORY_MAX = 100;
export const CHIP_VALUES = [1, 5, 25, 100, 500];

ヘルパー

export function getCssMs(name: string): number
  • 事前: name は --bcr- 始まりの CSS 変数名
  • 事後: ms 単位の数値、取得失敗時は 0
  • 実装: getComputedStyle(document.documentElement).getPropertyValue(name).trim() を parseInt

状態生成

export function createInitialState(): GameState
  • 事後: 新規ゲームの GameState(balance = INITIAL_BALANCE、新シュー、履歴空)
export function restoreState(persisted: PersistedData | null): GameState
  • 事前: persisted は null または PersistedData
  • 事後: null なら createInitialState、そうでなければ persisted.state を Core Types §PersistedData 復元規則に従って再初期化した GameState
  • shoe.cards が空配列で保存されていた場合、新シューを作る

状態機械 API

すべての UI 操作はこの API 経由。各関数は state を破壊的更新し、必要に応じてカスタムイベントを dispatch する。

export function startBetting(state: GameState): void
  • 事前: state.phase === ‘idle’
  • 事後: state.phase = ‘betting’、currentBets ゼロクリア、playerHand/bankerHand 空、lastResult = null
  • dispatch: bcr:phase-change {detail:{phase:'betting'}}
export function selectChip(state: GameState, chipValue: number): boolean
  • 事前: chipValue は CHIP_VALUES のいずれか
  • 事後: state.selectedChip = chipValue、true 返す
  • 事前条件違反時 false
export function placeBet(state: GameState, area: BetArea): boolean
  • 事前: state.phase === ‘betting’
  • 事後(成功時):
    • state.currentBets[area] += state.selectedChip
    • state.balance -= state.selectedChip
    • true 返す
    • dispatch: bcr:bet-placed {detail:{area, chip: state.selectedChip}}
  • 失敗条件:
    • phase が betting でない
    • state.balance < state.selectedChip
    • state.currentBets[area] + state.selectedChip > MAX_BET
  • 失敗時: state 変更なし、false 返す
export function clearBets(state: GameState): boolean
  • 事前: state.phase === ‘betting’
  • 事後:
    • state.balance += (currentBets.player + currentBets.banker + currentBets.tie)
    • currentBets ゼロクリア
    • true 返す
    • dispatch: bcr:bets-cleared
export function totalBet(state: GameState): number
  • 事後: currentBets の3エリア合計
export function deal(state: GameState): boolean
  • 事前: state.phase === ‘betting’ かつ totalBet(state) > 0
  • 事後:
    • state.phase = ‘dealing’
    • dispatch: bcr:phase-change {detail:{phase:'dealing'}}
    • 内部で setTimeout チェーンでカード配布 → third_card → reveal → settling → idle と自動遷移
    • 各カード配布時に bcr:card-dealt {detail:{side, card, index}} dispatch
    • reveal 時に bcr:reveal {detail:{result: RoundResult}} dispatch
    • settling 完了時に bcr:settled {detail:{result, net}} dispatch
  • 失敗時: false

deal の内部フロー(詳細)

擬似コード:

function deal(state) {
if (state.phase !== 'betting') return false;
if (totalBet(state) === 0) return false;
state.phase = 'dealing';
dispatchPhase('dealing');
const dealInterval = getCssMs('--bcr-deal-interval');
const dealDuration = getCssMs('--bcr-deal-duration');
const revealDuration = getCssMs('--bcr-reveal-duration');
// 配布順: P1, B1, P2, B2(バカラの通常順)
const timeline = [
{ side: 'player', delay: 0 },
{ side: 'banker', delay: dealInterval + dealDuration },
{ side: 'player', delay: (dealInterval + dealDuration) * 2 },
{ side: 'banker', delay: (dealInterval + dealDuration) * 3 },
];
timeline.forEach(({side, delay}, i) => {
setTimeout(() => {
const card = drawCard(state.shoe);
if (side === 'player') state.playerHand.cards.push(card);
else state.bankerHand.cards.push(card);
// total 再計算
const hand = side === 'player' ? state.playerHand : state.bankerHand;
hand.total = handTotal(hand.cards);
document.dispatchEvent(new CustomEvent('bcr:card-dealt', {
detail: {side, card, index: i}
}));
}, delay);
});
// 4枚配布後、third_card 判定
const afterInitial = (dealInterval + dealDuration) * 4;
setTimeout(() => resolveThirdCards(state), afterInitial);
return true;
}
function resolveThirdCards(state) {
state.phase = 'third_card';
dispatchPhase('third_card');
const p = state.playerHand;
const b = state.bankerHand;
const dealInterval = getCssMs('--bcr-deal-interval');
const dealDuration = getCssMs('--bcr-deal-duration');
// ナチュラルなら 3rd カードなし、即 reveal
if (isNatural(p.cards, b.cards)) {
setTimeout(() => enterReveal(state), 100);
return;
}
let delay = 0;
let playerThirdCard = null;
// Player draw?
if (shouldPlayerDraw(p.total)) {
setTimeout(() => {
const card = drawCard(state.shoe);
p.cards.push(card);
p.total = handTotal(p.cards);
playerThirdCard = card;
document.dispatchEvent(new CustomEvent('bcr:card-dealt', {
detail: {side: 'player', card, index: 4}
}));
}, delay);
delay += dealInterval + dealDuration;
}
// Banker draw?(player 3rd 決定後に判定するため setTimeout チェーン)
setTimeout(() => {
// player3rd が引かれていれば p.cards[2]、なければ null
const p3 = p.cards.length === 3 ? p.cards[2] : null;
if (shouldBankerDraw(b.total, p3)) {
const card = drawCard(state.shoe);
b.cards.push(card);
b.total = handTotal(b.cards);
document.dispatchEvent(new CustomEvent('bcr:card-dealt', {
detail: {side: 'banker', card, index: 5}
}));
setTimeout(() => enterReveal(state), dealDuration);
} else {
enterReveal(state);
}
}, delay);
}
function enterReveal(state) {
state.phase = 'reveal';
const result = buildResult(state);
state.lastResult = result;
document.dispatchEvent(new CustomEvent('bcr:phase-change', {detail:{phase:'reveal'}}));
document.dispatchEvent(new CustomEvent('bcr:reveal', {detail:{result}}));
const revealDuration = getCssMs('--bcr-reveal-duration');
setTimeout(() => settle(state, result), revealDuration);
}
function buildResult(state) {
const { winner, natural } = resolve(state.playerHand, state.bankerHand);
const payouts = calcPayouts(state.currentBets, winner);
return {
winner,
player: { ...state.playerHand },
banker: { ...state.bankerHand },
natural,
payouts
};
}
function settle(state, result) {
state.phase = 'settling';
const totalReturn = result.payouts.player + result.payouts.banker + result.payouts.tie;
const totalStaked = state.currentBets.player + state.currentBets.banker + state.currentBets.tie;
const net = totalReturn - totalStaked;
state.balance += totalReturn;
state.totalRounds += 1;
const entry = {
index: state.totalRounds,
winner: result.winner,
playerTotal: state.playerHand.total,
bankerTotal: state.bankerHand.total,
natural: result.natural,
bets: [...], // currentBets の非ゼロエントリを Bet[] に変換
net
};
state.history.push(entry);
if (state.history.length > HISTORY_MAX) state.history.shift();
document.dispatchEvent(new CustomEvent('bcr:settled', {detail:{result, net, entry}}));
// 破産チェック
if (state.balance < MIN_BET) {
state.bankrupt = true;
state.phase = 'idle';
document.dispatchEvent(new CustomEvent('bcr:bankrupt'));
return;
}
// シュー切れなら shuffling へ
if (state.shoe.needsShuffle) {
state.phase = 'shuffling';
document.dispatchEvent(new CustomEvent('bcr:phase-change', {detail:{phase:'shuffling'}}));
const shuffleDuration = getCssMs('--bcr-shuffle-duration');
setTimeout(() => {
state.shoe = createShoe(DECKS_PER_SHOE);
state.totalRounds = 0;
state.phase = 'idle';
document.dispatchEvent(new CustomEvent('bcr:phase-change', {detail:{phase:'idle'}}));
document.dispatchEvent(new CustomEvent('bcr:new-shoe'));
}, shuffleDuration);
} else {
state.phase = 'idle';
document.dispatchEvent(new CustomEvent('bcr:phase-change', {detail:{phase:'idle'}}));
}
}

その他 API

export function restart(state: GameState): void
  • 事後: state を createInitialState() の内容で全上書き(破産リセット用)
  • dispatch: bcr:restart
export function canBet(state: GameState, amount: number): boolean
  • 事後: state.phase === ‘betting’ && state.balance >= amount

カスタムイベント一覧

すべて document に dispatch。冒頭 prefix bcr: 固定。

イベント名detail発火タイミング
bcr:phase-change{phase}phase が変わる度
bcr:bet-placed{area, chip}placeBet 成功時
bcr:bets-cleared─clearBets 成功時
bcr:card-dealt{side, card, index}カード配布毎
bcr:reveal{result}reveal phase 開始時
bcr:settled{result, net, entry}settling 完了時
bcr:bankrupt─破産時
bcr:new-shoe─シャッフル完了時
bcr:restart─restart 時

想定行数

400 行前後。分岐が多いが 500 行以内に収める。

src/content/ja/reference/2026-09-26-baccarat-spec-roadmap.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - roadmap.js(罫線計算)
description: バカラの Bead Plate(珠盤路)と Big Road(大路)の履歴→グリッド変換純関数。派生罫線(Big Eye Boy 等)は含めない。担当セッションに Core + Types と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
---
## ファイル
`public/tools/baccarat/roadmap.js`
## 責務
- 履歴(HistoryEntry[])を Bead Plate 用グリッドに変換
- 履歴を Big Road 用グリッドに変換
## 実装スコープ
- 珠盤路(Bead Plate)
- 大路(Big Road)
- **Big Eye Boy / Small Road / Cockroach Pig は実装しない**(8セッション予算優先)
## 禁止事項
- DOM を触らない
- 他モジュールから import しない
- 副作用禁止(引数の history を破壊的変更しない)
## 型定義(roadmap.js 内で使用)

CellColor = ‘player’ | ‘banker’ | ‘tie’ | null

BeadCell = { color: CellColor, playerTotal: number | null, bankerTotal: number | null, natural: boolean }

BigRoadCell = { color: ‘player’ | ‘banker’, // Big Road では tie 単独セルは作らず、直前セルに tie マーク付与 tieCount: number // このセルまでに発生した連続 tie の数 }

## Export API
### buildBeadPlate

export function buildBeadPlate(history: HistoryEntry[], rows: number = 6, cols: number = 12): BeadCell[][]

- 事前: rows, cols は正の整数
- 事後: rows × cols の 2次元配列(列優先充填)
- 仕様:
- 履歴を左上から縦に並べる(1列目上から下、埋まったら次列)
- history の長さが rows*cols を超える場合、古いものを切り捨てて最新 rows*cols 件を表示
- 空セルは `{color: null, playerTotal: null, bankerTotal: null, natural: false}`
### buildBigRoad

export function buildBigRoad(history: HistoryEntry[], rows: number = 6, cols: number = 30): BigRoadCell[][]

- 事前: rows, cols は正の整数
- 事後: rows × cols の 2次元配列(列優先充填)
- 仕様:
- Tie は独立セルを作らず、直前の non-tie セルに `tieCount++`
- 履歴先頭の Tie は最初の non-tie セルに繰り越し(保留カウンタ)
- 同色連続 → 縦に伸ばす
- 色変わり → 次列の1行目から
- 縦が rows に達したら、それ以上は横に折り返す(同じ行を右に伸ばす)
- 折り返し中に色変わり → 折り返し行の下(縦位置は元列の次列先頭)ではなく、標準の次列先頭に戻る
- **簡略実装**: 折り返しの正確な本場ルールは複雑なため、以下で近似:
- 同色連続で縦最下段に達したら、その行を右に伸ばす(下段固定)
- 色変わりで次列先頭に戻る
- cols を超えた古い列は左から切り捨て
### 実装例(buildBeadPlate 骨格)
```javascript
export function buildBeadPlate(history, rows = 6, cols = 12) {
const grid = Array.from({length: rows}, () =>
Array.from({length: cols}, () => ({
color: null, playerTotal: null, bankerTotal: null, natural: false
}))
);
const capacity = rows * cols;
const start = Math.max(0, history.length - capacity);
const visible = history.slice(start);
for (let i = 0; i < visible.length; i++) {
const col = Math.floor(i / rows);
const row = i % rows;
const h = visible[i];
grid[row][col] = {
color: h.winner,
playerTotal: h.playerTotal,
bankerTotal: h.bankerTotal,
natural: h.natural
};
}
return grid;
}

実装例(buildBigRoad 骨格)

export function buildBigRoad(history, rows = 6, cols = 30) {
const grid = Array.from({length: rows}, () =>
Array.from({length: cols}, () => null)
);
let col = 0;
let row = 0;
let currentColor = null;
let pendingTies = 0;
let lastPlacedRow = -1;
let lastPlacedCol = -1;
for (const h of history) {
if (h.winner === 'tie') {
// 直前セルに tie を加算、なければ pending
if (lastPlacedRow >= 0) {
grid[lastPlacedRow][lastPlacedCol].tieCount += 1;
} else {
pendingTies += 1;
}
continue;
}
if (currentColor === null || currentColor !== h.winner) {
// 新しい列
if (currentColor !== null) col += 1;
row = 0;
currentColor = h.winner;
} else {
// 同色連続、縦に伸ばす
if (row + 1 < rows) {
row += 1;
} else {
// 最下段、右に折り返す
col += 1;
// row は変わらず
}
}
if (col >= cols) {
// スクロール: 左を1列捨てる
for (let r = 0; r < rows; r++) {
for (let c = 0; c < cols - 1; c++) {
grid[r][c] = grid[r][c+1];
}
grid[r][cols-1] = null;
}
col -= 1;
lastPlacedCol -= 1;
}
grid[row][col] = {
color: h.winner,
tieCount: pendingTies
};
pendingTies = 0;
lastPlacedRow = row;
lastPlacedCol = col;
}
return grid;
}

検証ケース

// Bead Plate: 3件で3セル埋まる
const h = [
{winner:'player', playerTotal:8, bankerTotal:5, natural:true, ...},
{winner:'banker', playerTotal:3, bankerTotal:7, natural:false, ...},
{winner:'tie', playerTotal:5, bankerTotal:5, natural:false, ...}
];
const bp = buildBeadPlate(h);
bp[0][0].color === 'player'
bp[1][0].color === 'banker'
bp[2][0].color === 'tie'
bp[3][0].color === null
// Big Road: 同色連続で縦に伸びる
const h2 = [
{winner:'player',...}, {winner:'player',...}, {winner:'player',...},
{winner:'banker',...},
{winner:'tie',...}
];
const br = buildBigRoad(h2);
br[0][0].color === 'player'
br[1][0].color === 'player'
br[2][0].color === 'player'
br[3][0] === null
br[0][1].color === 'banker'
br[0][1].tieCount === 1
// Tie 先行
const h3 = [{winner:'tie',...}, {winner:'player',...}];
const br3 = buildBigRoad(h3);
br3[0][0].color === 'player'
br3[0][0].tieCount === 1

想定行数

150 行以内。

src/content/ja/reference/2026-09-26-baccarat-spec-persist.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - persist.js(localStorage)
description: GameState と Settings の localStorage 永続化。スキーマバージョン管理を含む。担当セッションに Core + Types と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
---
## ファイル
`public/tools/baccarat/persist.js`
## 責務
- GameState と Settings を localStorage に保存
- リロード時に読み込み・バージョン検証
- 破損時は null を返して呼び出し側で新規開始
## 禁止事項
- 他モジュールから import しない
- DOM を触らない
- 復元時の型変換や再初期化は行わない(それは game.js の restoreState の責務)
## localStorage キー

const STATE_KEY = ‘bcr:state:v1’; const SETTINGS_KEY = ‘bcr:settings:v1’; const SCHEMA_VERSION = 1;

## Export API
### saveState

export function saveState(state: GameState): void

- 事後: `{version: 1, state, savedAt: new Date().toISOString()}` を JSON.stringify して STATE_KEY に保存
- try/catch で保存失敗を握りつぶす(quota exceeded 等、致命的でない)
### loadState

export function loadState(): PersistedData | null

- 事後:
- localStorage.getItem(STATE_KEY) が null → null 返す
- JSON.parse 成功かつ version === 1 → PersistedData 返す
- それ以外 → null 返す(バージョン不一致は破棄)
### saveSettings

export function saveSettings(settings: Settings): void

### loadSettings

export function loadSettings(): Settings

- 事後:
- 存在しない or 破損 → デフォルト `{soundEnabled: true, showBigRoad: true, showBeadPlate: true}`
- 存在すれば読み込んだ Settings
### clearAll

export function clearAll(): void

- 事後: STATE_KEY と SETTINGS_KEY を削除
## 実装例
```javascript
const STATE_KEY = 'bcr:state:v1';
const SETTINGS_KEY = 'bcr:settings:v1';
const SCHEMA_VERSION = 1;
const DEFAULT_SETTINGS = {
soundEnabled: true,
showBigRoad: true,
showBeadPlate: true
};
export function saveState(state) {
try {
const payload = {
version: SCHEMA_VERSION,
state,
savedAt: new Date().toISOString()
};
localStorage.setItem(STATE_KEY, JSON.stringify(payload));
} catch {
// quota exceeded 等、無視
}
}
export function loadState() {
try {
const raw = localStorage.getItem(STATE_KEY);
if (!raw) return null;
const parsed = JSON.parse(raw);
if (parsed.version !== SCHEMA_VERSION) return null;
return parsed;
} catch {
return null;
}
}
// saveSettings / loadSettings / clearAll も同様のパターン

自動保存の呼び出し方(参考、実装は main.js)

main.js 側で以下を仕込む想定:

// game.js のイベントで発火
document.addEventListener('bcr:settled', () => saveState(state));
document.addEventListener('bcr:new-shoe', () => saveState(state));
document.addEventListener('bcr:restart', () => saveState(state));

想定行数

70 行以内。

src/content/ja/reference/2026-09-26-baccarat-spec-sound.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - sound.js(Web Audio 効果音)
description: 外部ファイル不使用で Web Audio API のオシレータ合成による効果音を提供。カード配布・チップ・勝敗の3種類。担当セッションに Core + Types と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
---
## ファイル
`public/tools/baccarat/sound.js`
## 責務
- Web Audio API を使った効果音再生
- 音声ファイル不使用(オシレータ・ノイズ合成のみ)
- ユーザー操作前の AudioContext resume 対策
## 禁止事項
- 外部音声ファイルの読み込み
- 他モジュールから import しない
- DOM を触らない(内部の AudioContext のみ)
## Export API
### initSound

export function initSound(): void

- 事後: 内部 AudioContext を作成(未作成なら)
- ユーザー操作イベント(click 等)内から呼ぶ想定
- 2回目以降は no-op
### setEnabled

export function setEnabled(enabled: boolean): void

- 事後: 有効/無効フラグをセット
### playCardDeal

export function playCardDeal(): void

- 事後: カード配布音を再生(短いノイズバースト、~50ms)
- enabled が false または context 未初期化なら no-op
### playChip

export function playChip(): void

- 事後: チップ音(コイン風の高音、~80ms)
### playWin

export function playWin(): void

- 事後: 勝利音(明るい三和音、~400ms)
### playLose

export function playLose(): void

- 事後: 敗北音(暗い下降音、~300ms)
### playTie

export function playTie(): void

- 事後: Tie 音(中立的な短音、~200ms)
## 実装方針
### カード配布音(ホワイトノイズ短バースト)
```javascript
function playCardDeal() {
if (!enabled || !ctx) return;
const bufferSize = ctx.sampleRate * 0.05;
const buffer = ctx.createBuffer(1, bufferSize, ctx.sampleRate);
const data = buffer.getChannelData(0);
for (let i = 0; i < bufferSize; i++) {
data[i] = (Math.random() * 2 - 1) * (1 - i/bufferSize); // フェードアウト
}
const src = ctx.createBufferSource();
src.buffer = buffer;
const gain = ctx.createGain();
gain.gain.value = 0.15;
src.connect(gain).connect(ctx.destination);
src.start();
}

チップ音(短い正弦波)

function playChip() {
playTone(880, 0.08, 'sine', 0.2);
}
function playTone(freq, duration, type = 'sine', volume = 0.2) {
if (!enabled || !ctx) return;
const osc = ctx.createOscillator();
const gain = ctx.createGain();
osc.type = type;
osc.frequency.value = freq;
gain.gain.setValueAtTime(volume, ctx.currentTime);
gain.gain.exponentialRampToValueAtTime(0.001, ctx.currentTime + duration);
osc.connect(gain).connect(ctx.destination);
osc.start();
osc.stop(ctx.currentTime + duration);
}

勝利音(三和音 C-E-G)

function playWin() {
playTone(523.25, 0.4, 'sine', 0.2); // C5
setTimeout(() => playTone(659.25, 0.4, 'sine', 0.2), 80); // E5
setTimeout(() => playTone(783.99, 0.4, 'sine', 0.2), 160); // G5
}

敗北音(下降)

function playLose() {
playTone(392, 0.15, 'triangle', 0.15); // G4
setTimeout(() => playTone(293.66, 0.2, 'triangle', 0.15), 100); // D4
}

Tie 音

function playTie() {
playTone(440, 0.2, 'sine', 0.15); // A4
}

AudioContext の作成タイミング

ブラウザは user gesture 前の AudioContext.createOscillator を制限するため、initSound() は最初のユーザー操作(ボタンクリック等)内から呼ぶ。main.js 側で document.addEventListener('click', initSound, {once: true}) を仕込む想定。

想定行数

120 行以内。

src/content/ja/reference/2026-09-26-baccarat-spec-dom.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - DOM 構造(骨格)
description: index.html のボディ内 DOM 構造と、ui-table.js/ui-controls.js が前提とするクラス名・data 属性の SSOT。担当セッションに Core + Types と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
- 2026-09-26-baccarat-spec-styles
- 2026-09-26-baccarat-spec-ui-table
- 2026-09-26-baccarat-spec-ui-controls
---
## 目的
`index.html` の body 内構造と、CSS・JS が共有する骨格をここで固定する。この分冊は styles.css、ui-table.js、ui-controls.js、index.html の担当セッションすべてに渡す。
## 全体構造
```html
<body>
<main class="bcr-app" x-data="baccaratApp()">
<!-- ヘッダー: 残高・シュー進捗・設定 -->
<header class="bcr-header">
<div class="bcr-balance">
<span class="bcr-label">餘額<span class="bcr-en">Balance</span></span>
<span class="bcr-balance-value" x-text="state.balance"></span>
</div>
<div class="bcr-shoe-info">
<span class="bcr-label">靴<span class="bcr-en">Shoe</span></span>
<span class="bcr-shoe-remaining" x-text="shoeRemainingText()"></span>
<progress class="bcr-shoe-progress" :value="shoeProgress()" max="1"></progress>
</div>
<div class="bcr-settings">
<sl-icon-button name="gear" label="設定" @click="openSettings()"></sl-icon-button>
</div>
</header>
<!-- テーブル本体 -->
<section class="bcr-table" aria-label="バカラテーブル">
<!-- カード領域 -->
<div class="bcr-hands">
<div class="bcr-hand bcr-hand--player" data-bcr-side="player">
<div class="bcr-hand-header">
<span class="bcr-label bcr-label--player">閒<span class="bcr-en">Player</span></span>
<span class="bcr-hand-total" x-text="state.playerHand.total"></span>
</div>
<div class="bcr-hand-cards">
<template x-for="(card, i) in state.playerHand.cards" :key="i">
<div class="bcr-card" :data-bcr-suit="card.suit" :data-bcr-rank="card.rank">
<span class="bcr-card-rank" x-text="card.rank"></span>
<span class="bcr-card-suit" x-text="suitSymbol(card.suit)"></span>
</div>
</template>
</div>
</div>
<div class="bcr-hand bcr-hand--banker" data-bcr-side="banker">
<div class="bcr-hand-header">
<span class="bcr-label bcr-label--banker">莊<span class="bcr-en">Banker</span></span>
<span class="bcr-hand-total" x-text="state.bankerHand.total"></span>
</div>
<div class="bcr-hand-cards">
<template x-for="(card, i) in state.bankerHand.cards" :key="i">
<div class="bcr-card" :data-bcr-suit="card.suit" :data-bcr-rank="card.rank">
<span class="bcr-card-rank" x-text="card.rank"></span>
<span class="bcr-card-suit" x-text="suitSymbol(card.suit)"></span>
</div>
</template>
</div>
</div>
</div>
<!-- 結果バナー(reveal phase で表示) -->
<div class="bcr-result-banner" x-show="state.phase === 'reveal' || state.phase === 'settling'" x-transition>
<span class="bcr-result-winner" x-text="winnerLabel()"></span>
<span class="bcr-result-natural" x-show="state.lastResult?.natural">天牌<span class="bcr-en">Natural</span></span>
</div>
<!-- ベットエリア -->
<div class="bcr-bet-areas">
<button class="bcr-bet-area bcr-bet-area--player"
data-bcr-area="player"
:class="{'bcr-bet-area--active': state.currentBets.player > 0}"
:disabled="state.phase !== 'betting'"
@click="onBetClick('player')">
<span class="bcr-bet-label">閒<span class="bcr-en">Player</span></span>
<span class="bcr-bet-payout">1 : 1</span>
<span class="bcr-bet-amount" x-text="state.currentBets.player" x-show="state.currentBets.player > 0"></span>
</button>
<button class="bcr-bet-area bcr-bet-area--tie"
data-bcr-area="tie"
:class="{'bcr-bet-area--active': state.currentBets.tie > 0}"
:disabled="state.phase !== 'betting'"
@click="onBetClick('tie')">
<span class="bcr-bet-label">和<span class="bcr-en">Tie</span></span>
<span class="bcr-bet-payout">8 : 1</span>
<span class="bcr-bet-amount" x-text="state.currentBets.tie" x-show="state.currentBets.tie > 0"></span>
</button>
<button class="bcr-bet-area bcr-bet-area--banker"
data-bcr-area="banker"
:class="{'bcr-bet-area--active': state.currentBets.banker > 0}"
:disabled="state.phase !== 'betting'"
@click="onBetClick('banker')">
<span class="bcr-bet-label">莊<span class="bcr-en">Banker</span></span>
<span class="bcr-bet-payout">1 : 0.95</span>
<span class="bcr-bet-amount" x-text="state.currentBets.banker" x-show="state.currentBets.banker > 0"></span>
</button>
</div>
</section>
<!-- コントロール: チップ選択・アクション -->
<section class="bcr-controls">
<div class="bcr-chips">
<template x-for="chip in CHIP_VALUES" :key="chip">
<button class="bcr-chip"
:data-bcr-chip="chip"
:class="{'bcr-chip--selected': state.selectedChip === chip}"
:disabled="state.balance < chip"
@click="onChipSelect(chip)">
<span x-text="chip"></span>
</button>
</template>
</div>
<div class="bcr-actions">
<sl-button variant="default" @click="onClear()" :disabled="state.phase !== 'betting' || totalBet() === 0">
取消 <span class="bcr-en">Clear</span>
</sl-button>
<sl-button variant="primary" size="large" @click="onDeal()" :disabled="state.phase !== 'betting' || totalBet() === 0">
發牌 <span class="bcr-en">Deal</span>
</sl-button>
</div>
</section>
<!-- ロードマップ -->
<section class="bcr-roadmap" aria-label="路單">
<div class="bcr-bead-plate" x-show="settings.showBeadPlate">
<h3 class="bcr-roadmap-title">珠盤路<span class="bcr-en">Bead Plate</span></h3>
<div class="bcr-bead-grid" data-bcr-roadmap="bead"></div>
</div>
<div class="bcr-big-road" x-show="settings.showBigRoad">
<h3 class="bcr-roadmap-title">大路<span class="bcr-en">Big Road</span></h3>
<div class="bcr-big-grid" data-bcr-roadmap="big"></div>
</div>
</section>
<!-- 設定ダイアログ -->
<sl-dialog label="設定 Settings" class="bcr-settings-dialog">
<sl-switch x-model="settings.soundEnabled">音效 Sound</sl-switch>
<sl-switch x-model="settings.showBeadPlate">珠盤路 Bead Plate</sl-switch>
<sl-switch x-model="settings.showBigRoad">大路 Big Road</sl-switch>
<sl-button slot="footer" variant="danger" @click="onRestart()">重新開始 Restart</sl-button>
<sl-button slot="footer" variant="primary" @click="closeSettings()">確定 OK</sl-button>
</sl-dialog>
<!-- 破産ダイアログ -->
<sl-dialog label="破產 Bankrupt" class="bcr-bankrupt-dialog" :open="state.bankrupt" no-header>
<p>餘額不足,遊戲結束。<br>Your balance is depleted.</p>
<sl-button slot="footer" variant="primary" @click="onRestart()">重新開始 Restart</sl-button>
</sl-dialog>
<!-- Toast 通知エリア(Shoelace が自動配置) -->
</main>
</body>

data 属性契約

属性値用途
data-bcr-sideplayer / bankerハンド識別
data-bcr-suitS / H / D / Cカードスート(CSS で色分け)
data-bcr-rankA / 2〜10 / J〜Kカード ランク
data-bcr-areaplayer / banker / tieベットエリア識別
data-bcr-chip1 / 5 / 25 / 100 / 500チップ額面
data-bcr-roadmapbead / bigロードマップ種別

Alpine コンポーネント名

  • ルート: baccaratApp (ui-controls.js で window.baccaratApp = function() {...} として global に置く)

クラス命名一覧(styles.css の SSOT)

  • bcr-app bcr-header bcr-balance bcr-shoe-info bcr-settings
  • bcr-table bcr-hands bcr-hand bcr-hand--player bcr-hand--banker
  • bcr-hand-header bcr-hand-total bcr-hand-cards
  • bcr-card bcr-card-rank bcr-card-suit bcr-card--dealt(アニメ用)
  • bcr-result-banner bcr-result-winner bcr-result-natural
  • bcr-bet-areas bcr-bet-area bcr-bet-area--player bcr-bet-area--banker bcr-bet-area--tie bcr-bet-area--active bcr-bet-area--winner
  • bcr-bet-label bcr-bet-payout bcr-bet-amount
  • bcr-controls bcr-chips bcr-chip bcr-chip--selected bcr-actions
  • bcr-roadmap bcr-bead-plate bcr-big-road bcr-roadmap-title
  • bcr-bead-grid bcr-big-grid bcr-bead-cell bcr-big-cell
  • bcr-bead-cell--player bcr-bead-cell--banker bcr-bead-cell--tie
  • bcr-big-cell--player bcr-big-cell--banker bcr-big-cell--tie-mark
  • bcr-label bcr-label--player bcr-label--banker bcr-en

キーボード操作契約

ui-controls.js が window に keydown リスナを付ける:

キー動作
SpaceDeal(betting phase 時)
EscClear
11 チップ選択
25 チップ選択
325 チップ選択
4100 チップ選択
5500 チップ選択
pPlayer エリアにベット
bBanker エリアにベット
tTie エリアにベット
src/content/ja/reference/2026-09-26-baccarat-spec-styles.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - styles.css
description: バカラアプリの全 CSS。テーブル・カード・チップ・ロードマップ・アニメーションを定義。DOM 骨格分冊と対で使う。担当セッションに Core + DOM 骨格と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-dom
---
## ファイル
`public/tools/baccarat/styles.css`
## 責務
- カジノらしい落ち着いた見た目(深緑テーブル、金枠、赤/青カード)
- レスポンシブ(スマホでも遊べる、~360px 幅まで)
- カード配布・チップ操作のアニメーション
- Shoelace のトークンと衝突しない
## 禁止事項
- `!important` の使用
- 外部フォント CDN の追加
- 画像ファイルの参照(絵柄はテキスト+CSS のみ)
## デザイントークン(:root)
```css
:root {
/* アニメーション時間(JS からも読む、SSOT) */
--bcr-deal-duration: 400ms;
--bcr-deal-interval: 200ms;
--bcr-flip-duration: 300ms;
--bcr-reveal-duration: 1000ms;
--bcr-shuffle-duration: 1000ms;
/* 配色 */
--bcr-color-table: #0a5c3a; /* テーブル深緑 */
--bcr-color-table-edge: #1a7a52; /* テーブル縁明るめ */
--bcr-color-gold: #d4af37; /* 金枠 */
--bcr-color-player: #1e88e5; /* 閒 青 */
--bcr-color-banker: #e53935; /* 莊 赤 */
--bcr-color-tie: #43a047; /* 和 緑 */
--bcr-color-card-bg: #fefefe;
--bcr-color-card-red: #c62828; /* Heart/Diamond */
--bcr-color-card-black: #212121; /* Spade/Club */
--bcr-color-chip-1: #ffffff;
--bcr-color-chip-5: #e53935;
--bcr-color-chip-25: #43a047;
--bcr-color-chip-100: #212121;
--bcr-color-chip-500: #7b1fa2;
--bcr-color-text: #f5f5f5;
--bcr-color-text-dim: #b0b0b0;
/* フォント */
--bcr-font-family: "Noto Sans TC", "Hiragino Sans", "Yu Gothic", system-ui, sans-serif;
--bcr-font-family-num: "SF Mono", "Menlo", monospace;
}

レイアウト構造

body {
margin: 0;
background: #1a1a1a;
color: var(--bcr-color-text);
font-family: var(--bcr-font-family);
}
.bcr-app {
max-width: 900px;
margin: 0 auto;
padding: 1rem;
display: grid;
gap: 1rem;
}
.bcr-header {
display: flex;
justify-content: space-between;
align-items: center;
padding: 0.5rem 1rem;
background: rgba(0,0,0,0.4);
border-radius: 0.5rem;
}
.bcr-table {
background: radial-gradient(ellipse at center, var(--bcr-color-table-edge), var(--bcr-color-table));
border: 3px solid var(--bcr-color-gold);
border-radius: 1rem;
padding: 2rem 1rem;
display: grid;
gap: 1.5rem;
min-height: 320px;
position: relative;
}

カード

.bcr-hands {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 1rem;
}
.bcr-hand {
display: grid;
gap: 0.5rem;
}
.bcr-hand--player .bcr-hand-header {
border-bottom: 2px solid var(--bcr-color-player);
}
.bcr-hand--banker .bcr-hand-header {
border-bottom: 2px solid var(--bcr-color-banker);
}
.bcr-hand-header {
display: flex;
justify-content: space-between;
padding-bottom: 0.25rem;
}
.bcr-hand-total {
font-family: var(--bcr-font-family-num);
font-size: 2rem;
font-weight: bold;
}
.bcr-hand-cards {
display: flex;
gap: 0.25rem;
min-height: 80px;
}
.bcr-card {
width: 56px;
height: 80px;
background: var(--bcr-color-card-bg);
border-radius: 0.25rem;
display: grid;
place-items: center;
grid-template-rows: 1fr 1fr;
padding: 0.25rem;
box-shadow: 0 2px 4px rgba(0,0,0,0.4);
animation: bcr-deal-in var(--bcr-deal-duration) ease-out;
}
.bcr-card[data-bcr-suit="H"],
.bcr-card[data-bcr-suit="D"] {
color: var(--bcr-color-card-red);
}
.bcr-card[data-bcr-suit="S"],
.bcr-card[data-bcr-suit="C"] {
color: var(--bcr-color-card-black);
}
.bcr-card-rank {
font-size: 1.4rem;
font-weight: bold;
}
.bcr-card-suit {
font-size: 1.2rem;
}
@keyframes bcr-deal-in {
from {
transform: translateY(-30px) rotateY(90deg);
opacity: 0;
}
to {
transform: none;
opacity: 1;
}
}

ベットエリア

.bcr-bet-areas {
display: grid;
grid-template-columns: 1fr 0.6fr 1fr;
gap: 0.5rem;
}
.bcr-bet-area {
padding: 1rem 0.5rem;
border: 2px solid transparent;
border-radius: 0.5rem;
color: var(--bcr-color-text);
cursor: pointer;
display: grid;
gap: 0.25rem;
place-items: center;
transition: transform 0.1s, border-color 0.2s;
font-family: inherit;
}
.bcr-bet-area:hover:not(:disabled) {
transform: translateY(-2px);
}
.bcr-bet-area:disabled {
opacity: 0.6;
cursor: not-allowed;
}
.bcr-bet-area--player {
background: rgba(30,136,229,0.3);
border-color: var(--bcr-color-player);
}
.bcr-bet-area--banker {
background: rgba(229,57,53,0.3);
border-color: var(--bcr-color-banker);
}
.bcr-bet-area--tie {
background: rgba(67,160,71,0.3);
border-color: var(--bcr-color-tie);
}
.bcr-bet-area--active {
box-shadow: 0 0 0 3px var(--bcr-color-gold);
}
.bcr-bet-area--winner {
animation: bcr-winner-pulse var(--bcr-reveal-duration) ease-in-out;
}
@keyframes bcr-winner-pulse {
0%, 100% { box-shadow: 0 0 0 3px var(--bcr-color-gold); }
50% { box-shadow: 0 0 0 10px var(--bcr-color-gold); }
}
.bcr-bet-label {
font-size: 1.2rem;
font-weight: bold;
}
.bcr-bet-payout {
font-size: 0.75rem;
opacity: 0.7;
}
.bcr-bet-amount {
font-family: var(--bcr-font-family-num);
font-size: 1.4rem;
font-weight: bold;
color: var(--bcr-color-gold);
}

チップ

.bcr-chips {
display: flex;
gap: 0.5rem;
justify-content: center;
}
.bcr-chip {
width: 56px;
height: 56px;
border-radius: 50%;
border: 3px dashed rgba(255,255,255,0.6);
font-weight: bold;
cursor: pointer;
font-family: var(--bcr-font-family-num);
transition: transform 0.1s;
}
.bcr-chip[data-bcr-chip="1"] { background: var(--bcr-color-chip-1); color: #000; }
.bcr-chip[data-bcr-chip="5"] { background: var(--bcr-color-chip-5); color: #fff; }
.bcr-chip[data-bcr-chip="25"] { background: var(--bcr-color-chip-25); color: #fff; }
.bcr-chip[data-bcr-chip="100"] { background: var(--bcr-color-chip-100); color: #fff; border-color: rgba(255,255,255,0.8); }
.bcr-chip[data-bcr-chip="500"] { background: var(--bcr-color-chip-500); color: #fff; }
.bcr-chip--selected {
transform: translateY(-6px);
box-shadow: 0 0 0 3px var(--bcr-color-gold);
}
.bcr-chip:disabled {
opacity: 0.4;
cursor: not-allowed;
}

ロードマップ

.bcr-roadmap {
display: grid;
gap: 0.5rem;
background: rgba(255,255,255,0.05);
padding: 0.5rem;
border-radius: 0.5rem;
}
.bcr-roadmap-title {
font-size: 0.85rem;
margin: 0 0 0.25rem;
color: var(--bcr-color-text-dim);
}
.bcr-bead-grid {
display: grid;
grid-template-rows: repeat(6, 1fr);
grid-auto-flow: column;
grid-auto-columns: 1fr;
gap: 2px;
aspect-ratio: 12 / 6;
}
.bcr-big-grid {
display: grid;
grid-template-rows: repeat(6, 1fr);
grid-auto-flow: column;
grid-auto-columns: 1fr;
gap: 2px;
aspect-ratio: 30 / 6;
}
.bcr-bead-cell, .bcr-big-cell {
aspect-ratio: 1;
border: 1px solid rgba(255,255,255,0.1);
display: grid;
place-items: center;
font-size: 0.7rem;
border-radius: 50%;
position: relative;
}
.bcr-bead-cell--player { background: var(--bcr-color-player); color: #fff; }
.bcr-bead-cell--banker { background: var(--bcr-color-banker); color: #fff; }
.bcr-bead-cell--tie { background: var(--bcr-color-tie); color: #fff; }
.bcr-big-cell--player {
border: 2px solid var(--bcr-color-player);
background: transparent;
border-radius: 50%;
}
.bcr-big-cell--banker {
border: 2px solid var(--bcr-color-banker);
background: transparent;
border-radius: 50%;
}
.bcr-big-cell--tie-mark::after {
content: "";
position: absolute;
width: 140%;
height: 2px;
background: var(--bcr-color-tie);
transform: rotate(-45deg);
}

結果バナー

.bcr-result-banner {
position: absolute;
top: 50%;
left: 50%;
transform: translate(-50%, -50%);
background: rgba(0,0,0,0.8);
border: 2px solid var(--bcr-color-gold);
border-radius: 0.5rem;
padding: 1rem 2rem;
font-size: 2rem;
font-weight: bold;
display: flex;
gap: 1rem;
align-items: baseline;
z-index: 10;
}
.bcr-result-natural {
font-size: 1rem;
color: var(--bcr-color-gold);
}

英語併記共通

.bcr-en {
font-size: 0.65em;
opacity: 0.6;
margin-left: 0.3em;
font-weight: normal;
}

レスポンシブ

@media (max-width: 480px) {
.bcr-card {
width: 44px;
height: 64px;
}
.bcr-chip {
width: 44px;
height: 44px;
font-size: 0.85rem;
}
.bcr-hand-total {
font-size: 1.5rem;
}
.bcr-bet-label {
font-size: 1rem;
}
}

モーション削減

@media (prefers-reduced-motion: reduce) {
* {
animation-duration: 0.01ms !important;
transition-duration: 0.01ms !important;
}
}

(このルールに限り !important を許可する。ユーザー設定尊重のため)

想定行数

400 行前後。500 行以内。

src/content/ja/reference/2026-09-26-baccarat-spec-ui-table.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - ui-table.js(テーブル描画とロードマップ描画)
description: Alpine コンポーネントのうち、テーブル本体(カード表示・結果バナー)とロードマップ描画を担当。担当セッションに Core + Types + game 仕様(API のみ)+ roadmap 仕様 + DOM 骨格と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
- 2026-09-26-baccarat-spec-game
- 2026-09-26-baccarat-spec-roadmap
- 2026-09-26-baccarat-spec-dom
---
## ファイル
`public/tools/baccarat/ui-table.js`
## 責務
- ロードマップ(Bead Plate と Big Road)の DOM 再描画
- 結果バナーの winner ラベル計算
- スートの記号変換(S→♠ 等)
- ベットエリアの winner ハイライト付与・解除
## 依存
- `./game.js` の phase 参照のみ(game.js の関数は呼ばない)
- `./roadmap.js` の buildBeadPlate / buildBigRoad
## 禁止事項
- game.js の state を直接書き換えない
- localStorage を触らない
- 音を鳴らさない
## Export API

export function initTableUi(state, settings): void

- 事前: state は GameState、settings は Settings
- 事後: DOM イベントリスナを設定する。以下を購読:
- `bcr:settled` → ロードマップ再描画、winner ハイライト付与
- `bcr:phase-change` → phase === 'betting' でハイライト解除
- `bcr:new-shoe` → ロードマップ全消去
- `bcr:restart` → ロードマップ全消去
- 初回呼び出し時にロードマップを一度描画する

export function renderRoadmaps(history: HistoryEntry[]): void

- 事後: `[data-bcr-roadmap="bead"]` と `[data-bcr-roadmap="big"]` の DOM を再構築

export function suitSymbol(suit: ‘S’|‘H’|‘D’|‘C’): string

- 事後: `S`→`♠`, `H`→`♥`, `D`→`♦`, `C`→`♣`

export function winnerLabel(result: RoundResult | null): string

- 事後: null → 空文字、winner === 'player' → '閒 勝 Player Wins'、'banker' → '莊 勝 Banker Wins'、'tie' → '和 Tie'
## renderRoadmaps 実装方針
```javascript
import { buildBeadPlate, buildBigRoad } from './roadmap.js';
export function renderRoadmaps(history) {
const beadEl = document.querySelector('[data-bcr-roadmap="bead"]');
const bigEl = document.querySelector('[data-bcr-roadmap="big"]');
if (beadEl) renderBeadPlate(beadEl, buildBeadPlate(history));
if (bigEl) renderBigRoad(bigEl, buildBigRoad(history));
}
function renderBeadPlate(container, grid) {
const rows = grid.length;
const cols = grid[0].length;
const frag = document.createDocumentFragment();
// 列優先: DOM 上は 1列目上→下、2列目上→下 の順で追加
for (let c = 0; c < cols; c++) {
for (let r = 0; r < rows; r++) {
const cell = document.createElement('div');
cell.className = 'bcr-bead-cell';
const data = grid[r][c];
if (data.color) {
cell.classList.add(`bcr-bead-cell--${data.color}`);
// 中の数字表示: Tie 以外は winner 側の合計
if (data.color === 'player') cell.textContent = data.playerTotal;
else if (data.color === 'banker') cell.textContent = data.bankerTotal;
else cell.textContent = 'T';
}
frag.appendChild(cell);
}
}
container.replaceChildren(frag);
// CSS の grid-auto-flow: column に任せるため、順序が正しい
}
function renderBigRoad(container, grid) {
const rows = grid.length;
const cols = grid[0].length;
const frag = document.createDocumentFragment();
for (let c = 0; c < cols; c++) {
for (let r = 0; r < rows; r++) {
const cell = document.createElement('div');
cell.className = 'bcr-big-cell';
const data = grid[r][c];
if (data) {
cell.classList.add(`bcr-big-cell--${data.color}`);
if (data.tieCount > 0) {
cell.classList.add('bcr-big-cell--tie-mark');
if (data.tieCount > 1) {
const span = document.createElement('span');
span.textContent = data.tieCount;
span.style.fontSize = '0.6em';
span.style.position = 'absolute';
span.style.top = '0';
span.style.right = '0';
cell.appendChild(span);
}
}
}
frag.appendChild(cell);
}
}
container.replaceChildren(frag);
}

initTableUi 実装方針

export function initTableUi(state, settings) {
renderRoadmaps(state.history);
document.addEventListener('bcr:settled', (e) => {
renderRoadmaps(state.history);
highlightWinner(e.detail.result.winner);
});
document.addEventListener('bcr:phase-change', (e) => {
if (e.detail.phase === 'betting') {
clearWinnerHighlight();
}
});
document.addEventListener('bcr:new-shoe', () => renderRoadmaps(state.history));
document.addEventListener('bcr:restart', () => renderRoadmaps(state.history));
}
function highlightWinner(area) {
const el = document.querySelector(`.bcr-bet-area[data-bcr-area="${area}"]`);
if (el) el.classList.add('bcr-bet-area--winner');
}
function clearWinnerHighlight() {
document.querySelectorAll('.bcr-bet-area--winner').forEach(el => {
el.classList.remove('bcr-bet-area--winner');
});
}

想定行数

180 行以内。

src/content/ja/reference/2026-09-26-baccarat-spec-ui-controls.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - ui-controls.js(Alpine コンポーネント + 入力)
description: Alpine ルートコンポーネント baccaratApp を定義し、ベット・チップ・Deal・キーボード操作の入力を受ける。担当セッションに Core + Types + game 仕様 + persist 仕様 + sound 仕様 + DOM 骨格と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
- 2026-09-26-baccarat-spec-game
- 2026-09-26-baccarat-spec-persist
- 2026-09-26-baccarat-spec-sound
- 2026-09-26-baccarat-spec-dom
---
## ファイル
`public/tools/baccarat/ui-controls.js`
## 責務
- Alpine コンポーネント `baccaratApp` の定義
- ベット・チップ・Deal・Clear・Restart のイベントハンドラ
- キーボードショートカット
- 設定ダイアログ制御
- Shoelace Toast による通知
- 音の再生タイミング決定
## 依存
- `./game.js`(全 API)
- `./persist.js`(saveState / saveSettings)
- `./sound.js`(initSound / setEnabled / play*)
- `./ui-table.js`(initTableUi, suitSymbol, winnerLabel)
## Export API

export function registerBaccaratApp(state, settings): void

- 事前: state は GameState、settings は Settings(main.js が用意)
- 事後: `window.baccaratApp = function() { return { ...alpineData... } }` を登録
## Alpine コンポーネントデータ
```javascript
import * as G from './game.js';
import { saveState, saveSettings } from './persist.js';
import * as Sound from './sound.js';
import { suitSymbol, winnerLabel } from './ui-table.js';
export function registerBaccaratApp(state, settings) {
window.baccaratApp = function() {
return {
state,
settings,
CHIP_VALUES: G.CHIP_VALUES,
init() {
// 初期化時に betting phase を開始
if (state.phase === 'idle' && !state.bankrupt) {
G.startBetting(state);
}
// Settings 変更を保存
this.$watch('settings.soundEnabled', (v) => {
Sound.setEnabled(v);
saveSettings(settings);
});
this.$watch('settings.showBigRoad', () => saveSettings(settings));
this.$watch('settings.showBeadPlate', () => saveSettings(settings));
// キーボード
window.addEventListener('keydown', (e) => this.onKeydown(e));
// AudioContext 初期化(初回クリック)
document.addEventListener('click', () => Sound.initSound(), {once: true});
Sound.setEnabled(settings.soundEnabled);
},
// 計算プロパティ
totalBet() {
return G.totalBet(state);
},
shoeRemainingText() {
return `${state.shoe.cards.length} / ${state.shoe.total}`;
},
shoeProgress() {
return state.shoe.drawn / state.shoe.total;
},
suitSymbol,
winnerLabel() {
return winnerLabel(state.lastResult);
},
// ハンドラ
onChipSelect(chip) {
if (G.selectChip(state, chip)) Sound.playChip();
},
onBetClick(area) {
if (G.placeBet(state, area)) {
Sound.playChip();
} else {
this.showToast('無法下注 Cannot place bet', 'warning');
}
},
onClear() {
G.clearBets(state);
},
onDeal() {
if (!G.deal(state)) {
this.showToast('請先下注 Place a bet first', 'warning');
}
},
onRestart() {
G.restart(state);
saveState(state);
G.startBetting(state);
this.closeSettings();
},
onKeydown(e) {
if (e.target.tagName === 'INPUT' || e.target.tagName === 'TEXTAREA') return;
switch (e.key) {
case ' ':
e.preventDefault();
if (state.phase === 'betting' && this.totalBet() > 0) this.onDeal();
break;
case 'Escape':
if (state.phase === 'betting') this.onClear();
break;
case '1': this.onChipSelect(1); break;
case '2': this.onChipSelect(5); break;
case '3': this.onChipSelect(25); break;
case '4': this.onChipSelect(100); break;
case '5': this.onChipSelect(500); break;
case 'p': case 'P': this.onBetClick('player'); break;
case 'b': case 'B': this.onBetClick('banker'); break;
case 't': case 'T': this.onBetClick('tie'); break;
}
},
openSettings() {
document.querySelector('.bcr-settings-dialog').show();
},
closeSettings() {
document.querySelector('.bcr-settings-dialog').hide();
},
showToast(message, variant = 'primary') {
const toast = Object.assign(document.createElement('sl-alert'), {
variant, closable: true, duration: 2500,
innerHTML: `<sl-icon slot="icon" name="info-circle"></sl-icon>${message}`
});
document.body.appendChild(toast);
toast.toast();
}
};
};
}

イベント購読で音を鳴らす

registerBaccaratApp 内、または init() 内で以下を仕込む:

document.addEventListener('bcr:card-dealt', () => Sound.playCardDeal());
document.addEventListener('bcr:settled', (e) => {
const net = e.detail.net;
if (net > 0) Sound.playWin();
else if (net < 0) Sound.playLose();
else Sound.playTie();
});
document.addEventListener('bcr:bankrupt', () => {
// 破産ダイアログは x-show 側で開くので、ここでは通知のみ
});
document.addEventListener('bcr:phase-change', (e) => {
// idle に戻ったら自動的に betting を開始
if (e.detail.phase === 'idle' && !state.bankrupt) {
setTimeout(() => G.startBetting(state), 500);
}
});

Shoelace 依存

  • sl-button, sl-icon-button, sl-dialog, sl-switch, sl-alert, sl-icon
  • 全て HTML 側で使う、JS からは通常の DOM 操作(.show() .hide() .toast())

想定行数

250 行以内。

src/content/ja/reference/2026-09-26-baccarat-spec-main.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - main.js(結線エントリポイント)
description: index.html から読み込まれる ES Module エントリ。state 初期化・各モジュール結線・自動保存フック設定のみ。担当セッションに Core + Types + persist 仕様 + ui-table 仕様 + ui-controls 仕様と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-types
- 2026-09-26-baccarat-spec-persist
- 2026-09-26-baccarat-spec-ui-table
- 2026-09-26-baccarat-spec-ui-controls
---
## ファイル
`public/tools/baccarat/main.js`
## 責務
- state と settings の初期化(persist から復元)
- ui-table と ui-controls の登録
- 自動保存フック
- グローバル露出は最小限(Alpine が要求する `window.baccaratApp` のみ、ui-controls が担当)
## 依存
- `./game.js`
- `./persist.js`
- `./ui-table.js`
- `./ui-controls.js`
## 実装
```javascript
import { restoreState, startBetting } from './game.js';
import { loadState, loadSettings, saveState } from './persist.js';
import { initTableUi } from './ui-table.js';
import { registerBaccaratApp } from './ui-controls.js';
// 1. データ復元
const persisted = loadState();
const state = restoreState(persisted);
const settings = loadSettings();
// 2. UI 登録
registerBaccaratApp(state, settings);
initTableUi(state, settings);
// 3. 自動保存フック
document.addEventListener('bcr:settled', () => saveState(state));
document.addEventListener('bcr:new-shoe', () => saveState(state));
document.addEventListener('bcr:bets-cleared', () => saveState(state));
window.addEventListener('beforeunload', () => saveState(state));

想定行数

30 行以内。

src/content/ja/reference/2026-09-26-baccarat-spec-index-html.md
```markdown
---
date: 2026-09-26
title: バカラ仕様 - index.html
description: バカラアプリのエントリ HTML。Shoelace/Alpine/Pico の CDN 読み込みと body 骨格を定義。DOM 骨格分冊をそのまま body に配置する。担当セッションに Core + DOM 骨格と共に渡す分冊。
type: reference
tags: [apps, games, baccarat, spec]
status: growing
related:
- 2026-09-26-baccarat-spec-index
- 2026-09-26-baccarat-spec-core
- 2026-09-26-baccarat-spec-dom
---
## ファイル
`public/tools/baccarat/index.html`
## 責務
- HTML5 骨格
- CDN 読み込み(Shoelace 2 系、Alpine 3 系、Pico 2 系)
- `styles.css` と `main.js` の読み込み
- body 内は DOM 骨格分冊の内容を貼る
## CDN URL(バージョン固定)
- Shoelace CSS: `https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2/cdn/themes/dark.css`
- Shoelace JS: `https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2/cdn/shoelace-autoloader.js`
- Alpine: `https://cdn.jsdelivr.net/npm/alpinejs@3/dist/cdn.min.js`
- Pico: `https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css`
## 骨格
```html
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0">
<meta name="theme-color" content="#0a5c3a">
<title>百家樂 Baccarat</title>
<!-- Pico ベース -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">
<!-- Shoelace ダークテーマ -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2/cdn/themes/dark.css">
<script type="module" src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2/cdn/shoelace-autoloader.js"></script>
<!-- Alpine(defer 必須) -->
<script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3/dist/cdn.min.js"></script>
<!-- 本アプリ -->
<link rel="stylesheet" href="./styles.css">
<script type="module" src="./main.js"></script>
</head>
<body class="sl-theme-dark">
<!-- ここに DOM 骨格分冊の <main class="bcr-app">...</main> を貼る -->
</body>
</html>

注意

  • <html lang="zh-Hant"> 固定(繁体字中文主体)
  • Alpine は defer、Shoelace autoloader は type="module"
  • body に sl-theme-dark クラスを付ける(Shoelace ダーク適用)
  • main.js は type="module" で読み込む(ES Modules 使用のため)
  • viewport は maximum-scale=1.0 でモバイル時のダブルタップズームを抑制

想定行数

body の DOM を含めて 150 行以内。

以上で仕様書群が完成。実装セッションは以下のようにプロンプトを組む:

以下2つの分冊を熟読し、次の1ファイルを完成させよ:

  • [Core 全文]
  • [Types 全文]
  • [rules 分冊全文]

出力: public/tools/baccarat/rules.js のみ。 仕様書に書かれた API・型・禁止事項を1文字も逸脱しないこと。 曖昧な点があれば実装せず質問せよ。