バカラアプリ仕様書インデックス
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 baccaratnode scripts/html-build/bundle.mjs --project baccaratnode scripts/html-build/verify.mjs --project baccaratnode public/tools/baccarat/tests/test.mjsnode public/tools/baccarat/tests/game.test.mjsCDN 依存の扱い(落とし穴)
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(名前空間)は除去後に未定義になるため、名前を直接参照する形へ書き換えた(@importdirective に全名を列挙)。- 同名トップレベル宣言は
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点だけ受け取れば、他ファイルの実装を見ずに自分の担当ファイルを完成させられる:
- Core 分冊(2026-09-26-baccarat-spec-core と 2026-09-26-baccarat-spec-types)
- 担当モジュールの分冊
分冊一覧
共通(全セッションに渡す)
- 2026-09-26-baccarat-spec-core — スタック、ディレクトリ、命名、依存方向、状態機械、エラー方針
- 2026-09-26-baccarat-spec-types — 全データ型定義(TypeScript 風、実行しない)
モジュール別(担当セッションに渡す)
| # | 分冊 | 生成ファイル | 純不純 |
|---|---|---|---|
| 1 | 2026-09-26-baccarat-spec-rules | rules.js | 純関数 |
| 2 | 2026-09-26-baccarat-spec-shoe | shoe.js | 副作用あり(乱数) |
| 3 | 2026-09-26-baccarat-spec-game | game.js | 状態機械 |
| 4 | 2026-09-26-baccarat-spec-roadmap | roadmap.js | 純関数 |
| 5 | 2026-09-26-baccarat-spec-persist | persist.js | localStorage 副作用 |
| 6 | 2026-09-26-baccarat-spec-sound | sound.js | Web Audio 副作用 |
| 7 | 2026-09-26-baccarat-spec-dom | (DOM 骨格仕様、複数ファイル共有) | ─ |
| 8 | 2026-09-26-baccarat-spec-styles | styles.css | ─ |
| 9 | 2026-09-26-baccarat-spec-ui-table | ui-table.js | Alpine コンポーネント |
| 10 | 2026-09-26-baccarat-spec-ui-controls | ui-controls.js | Alpine コンポーネント |
| 11 | 2026-09-26-baccarat-spec-main | main.js | 結線 |
| 12 | 2026-09-26-baccarat-spec-index-html | index.html | ─ |
セッション実行順序
理論上 S1〜S12 は並列可能だが、逐次で回すなら以下順序を推奨:
- Core + Types(S0、既にこの仕様書群として完成)
- rules → shoe → roadmap → persist → sound(純度高い順、独立)
- game(上記に依存)
- DOM + styles(見た目、独立)
- ui-table + ui-controls(game と DOM に依存)
- 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 不使用)
```markdown---date: 2026-09-26title: バカラ仕様 - Core(共通規約)description: バカラアプリ全ファイルに共通する規約。スタック、ディレクトリ、命名、依存方向、状態機械、エラー方針、UI言語規約を定める。全実装セッションに必ず渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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=確認---date: 2026-09-26title: バカラ仕様 - Types(データ型定義)description: バカラアプリ全モジュールで共有される型定義。TypeScript 風記法で書くが実装は素の JavaScript。全実装セッションに必ず渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 2026-09-26-baccarat-spec-index - 2026-09-26-baccarat-spec-core---
## 型定義の扱い
- 全て JSDoc コメントで表現、実行時型チェックは行わない- 型は本仕様書が SSOT、各ファイルは JSDoc で再宣言してよい- オブジェクトの形状は本仕様に厳密に従う(プロパティの追加・省略禁止)
## 基本型
### CardCard = { 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 として扱う)。
### HandHand = { cards: Card[], // 2 または 3 枚 total: number // (cards.value の合計) mod 10、0-9 }
### BetAreaBetArea = ‘player’ | ‘banker’ | ‘tie’
### BetBet = { on: BetArea, amount: number // 正の整数、MIN_BET 以上、MAX_BET 以下 }
### RoundResultRoundResult = { 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、没収されない)
### HistoryEntryHistoryEntry = { index: number, // 1 始まり、シュー内通し番号 winner: BetArea, playerTotal: number, // 0-9 bankerTotal: number, // 0-9 natural: boolean, bets: Bet[], // このラウンドで置かれたベット(表示用) net: number // このラウンドの純損益(+/-の整数) }
### ShoeShoe = { cards: Card[], // 残りカード、末尾から draw する drawn: number, // draw 済み枚数 total: number, // 初期総枚数(DECKS_PER_SHOE * 52) needsShuffle: boolean // cards.length <= CUT_CARD_POSITION で true }
破壊的更新(`drawCard` が cards.pop する)。
### GameStateGameState = { 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 }
### SettingsSettings = { soundEnabled: boolean, // デフォルト true showBigRoad: boolean, // デフォルト true showBeadPlate: boolean // デフォルト true }
### PersistedDataPersistedData = { 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` のみで使用、他は空値表現を優先---date: 2026-09-26title: バカラ仕様 - rules.js(Punto Banco ルール)description: Punto Banco の 3rd カードルールを含むゲームロジック純関数群。乱数・DOM 非依存。担当セッションに Core + Types と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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
### cardValueexport function cardValue(rank: Card[‘rank’]): number
- 事前: rank は Card の rank として正当- 事後: 0..9 の整数を返す- 仕様: 'A' → 1、'2'..'9' → 数値、'10'/'J'/'Q'/'K' → 0
### handTotalexport function handTotal(cards: Card[]): number
- 事前: cards は 0..3 枚- 事後: 0..9 の整数- 仕様: cards の value 合計を 10 で割った余り
### isNaturalexport function isNatural(playerCards: Card[], bankerCards: Card[]): boolean
- 事前: それぞれ 2 枚ちょうど- 事後: player または banker の handTotal が 8 か 9 なら true
### shouldPlayerDrawexport function shouldPlayerDraw(playerTotal: number): boolean
- 事前: 0 <= playerTotal <= 9- 事後: playerTotal <= 5 なら true、それ以外 false- 注意: この関数はナチュラル判定(8/9 で止まる)を含まない。呼び出し側でナチュラルチェックを先に行うこと
### shouldBankerDrawexport 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倍)
- winner === ‘player’:
検証ケース(実装後に手動確認する)
cardValue('A') === 1cardValue('9') === 9cardValue('10') === 0cardValue('K') === 0
handTotal([{value:5},{value:5}]) === 0handTotal([{value:7},{value:8}]) === 5handTotal([{value:1},{value:9},{value:3}]) === 3
isNatural([{value:8},{value:0}], [{value:5},{value:3}]) === trueisNatural([{value:5},{value:3}], [{value:5},{value:3}]) === false
shouldPlayerDraw(5) === trueshouldPlayerDraw(6) === falseshouldPlayerDraw(0) === true
shouldBankerDraw(3, {value:8}) === falseshouldBankerDraw(3, {value:7}) === trueshouldBankerDraw(6, {value:6}) === trueshouldBankerDraw(6, {value:5}) === falseshouldBankerDraw(7, {value:0}) === falseshouldBankerDraw(2, null) === trueshouldBankerDraw(6, null) === false
// calcPayoutscalcPayouts({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 行以内。テーブル定義とシンプルな関数のみ。
```markdown---date: 2026-09-26title: バカラ仕様 - shoe.js(シュー管理)description: 8デッキシューの生成・シャッフル・draw を担当。乱数を持つ唯一のロジックモジュール。担当セッションに Core + Types と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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
### createShoeexport function createShoe(deckCount: number = 8): Shoe
- 事前: deckCount は 1 以上の整数- 事後: シャッフル済みの新しい Shoe を返す- 仕様: - deckCount * 52 枚のカードを生成 - Fisher-Yates でシャッフル - `{ cards, drawn: 0, total: deckCount*52, needsShuffle: false }`
### drawCardexport 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')`
### shoeRemainingexport function shoeRemaining(shoe: Shoe): number
- 事後: shoe.cards.length を返す
### shoeProgressexport function shoeProgress(shoe: Shoe): number
- 事後: 0.0〜1.0 の実数(drawn / total)
## 実装詳細
### CARD_VALUES 表
```javascriptconst 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 === 416shoe.total === 416shoe.drawn === 0shoe.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
// drawconst c = drawCard(shoe);c.rank !== undefinedc.suit !== undefinedc.value === CARD_VALUES[c.rank]shoe.cards.length === 415shoe.drawn === 1
// カット位置まで drawwhile (shoe.cards.length > 14) drawCard(shoe);shoe.needsShuffle === true
// 空 draw エラーwhile (shoe.cards.length > 0) drawCard(shoe);try { drawCard(shoe); } catch(e) { /* エラー確認 */ }想定行数
80 行以内。
```markdown---date: 2026-09-26title: バカラ仕様 - game.js(状態機械)description: バカラのゲーム状態機械。ベット受付・カード配布・3rd カード判定・精算・履歴管理を統括。UI からの唯一の入り口。担当セッションに Core + Types + rules 仕様 + shoe 仕様と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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:
```javascriptexport 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 行以内に収める。
```markdown---date: 2026-09-26title: バカラ仕様 - roadmap.js(罫線計算)description: バカラの Bead Plate(珠盤路)と Big Road(大路)の履歴→グリッド変換純関数。派生罫線(Big Eye Boy 等)は含めない。担当セッションに Core + Types と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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
### buildBeadPlateexport 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}`
### buildBigRoadexport 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 骨格)
```javascriptexport 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] === nullbr[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 行以内。
```markdown---date: 2026-09-26title: バカラ仕様 - persist.js(localStorage)description: GameState と Settings の localStorage 永続化。スキーマバージョン管理を含む。担当セッションに Core + Types と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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
### saveStateexport function saveState(state: GameState): void
- 事後: `{version: 1, state, savedAt: new Date().toISOString()}` を JSON.stringify して STATE_KEY に保存- try/catch で保存失敗を握りつぶす(quota exceeded 等、致命的でない)
### loadStateexport function loadState(): PersistedData | null
- 事後: - localStorage.getItem(STATE_KEY) が null → null 返す - JSON.parse 成功かつ version === 1 → PersistedData 返す - それ以外 → null 返す(バージョン不一致は破棄)
### saveSettingsexport function saveSettings(settings: Settings): void
### loadSettingsexport function loadSettings(): Settings
- 事後: - 存在しない or 破損 → デフォルト `{soundEnabled: true, showBigRoad: true, showBeadPlate: true}` - 存在すれば読み込んだ Settings
### clearAllexport function clearAll(): void
- 事後: STATE_KEY と SETTINGS_KEY を削除
## 実装例
```javascriptconst 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 行以内。
```markdown---date: 2026-09-26title: バカラ仕様 - sound.js(Web Audio 効果音)description: 外部ファイル不使用で Web Audio API のオシレータ合成による効果音を提供。カード配布・チップ・勝敗の3種類。担当セッションに Core + Types と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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
### initSoundexport function initSound(): void
- 事後: 内部 AudioContext を作成(未作成なら)- ユーザー操作イベント(click 等)内から呼ぶ想定- 2回目以降は no-op
### setEnabledexport function setEnabled(enabled: boolean): void
- 事後: 有効/無効フラグをセット
### playCardDealexport function playCardDeal(): void
- 事後: カード配布音を再生(短いノイズバースト、~50ms)- enabled が false または context 未初期化なら no-op
### playChipexport function playChip(): void
- 事後: チップ音(コイン風の高音、~80ms)
### playWinexport function playWin(): void
- 事後: 勝利音(明るい三和音、~400ms)
### playLoseexport function playLose(): void
- 事後: 敗北音(暗い下降音、~300ms)
### playTieexport function playTie(): void
- 事後: Tie 音(中立的な短音、~200ms)
## 実装方針
### カード配布音(ホワイトノイズ短バースト)
```javascriptfunction 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 行以内。
```markdown---date: 2026-09-26title: バカラ仕様 - DOM 構造(骨格)description: index.html のボディ内 DOM 構造と、ui-table.js/ui-controls.js が前提とするクラス名・data 属性の SSOT。担当セッションに Core + Types と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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-side | player / banker | ハンド識別 |
data-bcr-suit | S / H / D / C | カードスート(CSS で色分け) |
data-bcr-rank | A / 2〜10 / J〜K | カード ランク |
data-bcr-area | player / banker / tie | ベットエリア識別 |
data-bcr-chip | 1 / 5 / 25 / 100 / 500 | チップ額面 |
data-bcr-roadmap | bead / big | ロードマップ種別 |
Alpine コンポーネント名
- ルート:
baccaratApp(ui-controls.jsでwindow.baccaratApp = function() {...}として global に置く)
クラス命名一覧(styles.css の SSOT)
bcr-appbcr-headerbcr-balancebcr-shoe-infobcr-settingsbcr-tablebcr-handsbcr-handbcr-hand--playerbcr-hand--bankerbcr-hand-headerbcr-hand-totalbcr-hand-cardsbcr-cardbcr-card-rankbcr-card-suitbcr-card--dealt(アニメ用)bcr-result-bannerbcr-result-winnerbcr-result-naturalbcr-bet-areasbcr-bet-areabcr-bet-area--playerbcr-bet-area--bankerbcr-bet-area--tiebcr-bet-area--activebcr-bet-area--winnerbcr-bet-labelbcr-bet-payoutbcr-bet-amountbcr-controlsbcr-chipsbcr-chipbcr-chip--selectedbcr-actionsbcr-roadmapbcr-bead-platebcr-big-roadbcr-roadmap-titlebcr-bead-gridbcr-big-gridbcr-bead-cellbcr-big-cellbcr-bead-cell--playerbcr-bead-cell--bankerbcr-bead-cell--tiebcr-big-cell--playerbcr-big-cell--bankerbcr-big-cell--tie-markbcr-labelbcr-label--playerbcr-label--bankerbcr-en
キーボード操作契約
ui-controls.js が window に keydown リスナを付ける:
| キー | 動作 |
|---|---|
| Space | Deal(betting phase 時) |
| Esc | Clear |
| 1 | 1 チップ選択 |
| 2 | 5 チップ選択 |
| 3 | 25 チップ選択 |
| 4 | 100 チップ選択 |
| 5 | 500 チップ選択 |
| p | Player エリアにベット |
| b | Banker エリアにベット |
| t | Tie エリアにベット |
```markdown---date: 2026-09-26title: バカラ仕様 - styles.cssdescription: バカラアプリの全 CSS。テーブル・カード・チップ・ロードマップ・アニメーションを定義。DOM 骨格分冊と対で使う。担当セッションに Core + DOM 骨格と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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 行以内。
```markdown---date: 2026-09-26title: バカラ仕様 - ui-table.js(テーブル描画とロードマップ描画)description: Alpine コンポーネントのうち、テーブル本体(カード表示・結果バナー)とロードマップ描画を担当。担当セッションに Core + Types + game 仕様(API のみ)+ roadmap 仕様 + DOM 骨格と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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 APIexport 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 実装方針
```javascriptimport { 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 行以内。
```markdown---date: 2026-09-26title: バカラ仕様 - ui-controls.js(Alpine コンポーネント + 入力)description: Alpine ルートコンポーネント baccaratApp を定義し、ベット・チップ・Deal・キーボード操作の入力を受ける。担当セッションに Core + Types + game 仕様 + persist 仕様 + sound 仕様 + DOM 骨格と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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 APIexport function registerBaccaratApp(state, settings): void
- 事前: state は GameState、settings は Settings(main.js が用意)- 事後: `window.baccaratApp = function() { return { ...alpineData... } }` を登録
## Alpine コンポーネントデータ
```javascriptimport * 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 行以内。
```markdown---date: 2026-09-26title: バカラ仕様 - main.js(結線エントリポイント)description: index.html から読み込まれる ES Module エントリ。state 初期化・各モジュール結線・自動保存フック設定のみ。担当セッションに Core + Types + persist 仕様 + ui-table 仕様 + ui-controls 仕様と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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`
## 実装
```javascriptimport { 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 行以内。
```markdown---date: 2026-09-26title: バカラ仕様 - index.htmldescription: バカラアプリのエントリ HTML。Shoelace/Alpine/Pico の CDN 読み込みと body 骨格を定義。DOM 骨格分冊をそのまま body に配置する。担当セッションに Core + DOM 骨格と共に渡す分冊。type: referencetags: [apps, games, baccarat, spec]status: growingrelated: - 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文字も逸脱しないこと。 曖昧な点があれば実装せず質問せよ。