戦闘UI パターンA - スプリットパネル実装
このスキルは、スプリットパネル戦闘UIの実装をガイドし、縦型シアターモードを水平対決レイアウトに変換します。
アーキテクチャ概要
┌───────────────────────────────────────────────────┐
│ ターンインジケーター │ フェーズパイプライン │ モディファイア │ ← PhaseHeader
├──────────────────┴───────┬───────────┴────────────┤
│ │ │
│ プレイヤーパネル │ 敵パネル │ ← ConfrontationZone
│ (CharacterPanel) │ (CharacterPanel) │
│ │ │
├──────────────────────────┴────────────────────────┤
│ クイックアクション (サイド/トグル) │ メインアクション │ ← ActionDock
└───────────────────────────────┴───────────────────┘
コンポーネント階層
Combat.tsx (シーンオーケストレーター)
├── CombatLayout.tsx (CSSグリッドコンテナ)
│ ├── PhaseHeader.tsx (上部ステータスバー)
│ │ ├── TurnIndicator
│ │ ├── PhasePipeline
│ │ ├── SideActionCounter
│ │ └── ApproachModifier
│ │
│ ├── ConfrontationZone.tsx (戦闘エリア)
│ │ ├── CharacterPanel.tsx (プレイヤーバリアント)
│ │ │ ├── CharacterSprite
│ │ │ ├── IdentityBar
│ │ │ ├── ResourceBars (HP/CP)
│ │ │ └── BuffBar
│ │ │
│ │ ├── VSDivider.tsx (中央エンブレム)
│ │ │
│ │ └── CharacterPanel.tsx (敵バリアント)
│ │ ├── CharacterSprite
│ │ ├── IdentityBar (名前、ティア、属性)
│ │ ├── HealthBar
│ │ ├── DefenseStats
│ │ └── BuffBar
│ │
│ └── ActionDock.tsx (スキルバー)
│ ├── QuickActionsSection
│ │ ├── QuickActionCard (サイドスキル)
│ │ └── QuickActionCard (トグルスキル)
│ ├── MainActionsSection
│ │ └── MainActionCard (メインスキル)
│ └── ControlButtons (オート、ターン終了)
│
└── FloatingTextLayer (z-50、変更なし)
ファイル構成
src/components/combat/
├── index.ts # バレルエクスポート
├── CombatLayout.tsx # グリッドコンテナ
├── PhaseHeader.tsx # 上部ステータスバー
├── ConfrontationZone.tsx # プレイヤー vs 敵エリア
├── CharacterPanel.tsx # 再利用可能なキャラクター表示
├── VSDivider.tsx # 中央VSエンブレム
├── ActionDock.tsx # 下部スキルバー
├── QuickActionCard.tsx # コンパクトなサイド/トグルカード
└── MainActionCard.tsx # 大型のメインスキルカード
実装ワークフロー
ステップ1: ターゲットコンポーネントの特定
ユーザーに実装するコンポーネントを尋ねます:
- CombatLayout - 新しい実装はここから開始
- PhaseHeader - 上部ステータスバー
- ConfrontationZone - 両パネルを含む戦闘エリア
- CharacterPanel - 個別キャラクター表示
- VSDivider - 中央エンブレムとエフェクト
- ActionDock - 下部スキルバー
- QuickActionCard - コンパクトなスキルカードバリアント
- MainActionCard - 大型スキルカードバリアント
ステップ2: コンポーネントリファレンスの読み込み
選択に基づいて、適切なリファレンスを読み込みます:
- レイアウト/構造: layout-specs.md を参照
- コンポーネントプロップス: component-interfaces.md を参照
- スタイリングガイド: styling-tokens.md を参照
- アニメーション仕様: animations.md を参照
ステップ3: コンポーネントコードの生成
コンポーネントテンプレートパターンに従います:
import React from 'react';
import { cn } from '@/lib/utils'; // cnユーティリティを使用する場合
interface ComponentNameProps {
// component-interfaces.md からのプロップス
}
export const ComponentName: React.FC<ComponentNameProps> = ({
// 分割代入されたプロップス
}) => {
return (
<div className={cn(
// styling-tokens.md からのベーススタイル
// 条件付きスタイル
)}>
{/* コンポーネント内容 */}
</div>
);
};
ステップ4: Combat.tsx への配線
コンポーネント作成後:
components/combat/index.tsからエクスポートCombat.tsxにインポート- 対応するセクションを置き換え
- 既存の状態から必要なプロップスを渡す
クイック実装コマンド
全ファイル作成 (スキャフォールディング)
# ディレクトリ作成
mkdir -p src/components/combat
# 全コンポーネントファイル作成
touch src/components/combat/{index,CombatLayout,PhaseHeader,ConfrontationZone,CharacterPanel,VSDivider,ActionDock,QuickActionCard,MainActionCard}.tsx
バレルエクスポートテンプレート
// src/components/combat/index.ts
export { CombatLayout } from './CombatLayout';
export { PhaseHeader } from './PhaseHeader';
export { ConfrontationZone } from './ConfrontationZone';
export { CharacterPanel } from './CharacterPanel';
export { VSDivider } from './VSDivider';
export { ActionDock } from './ActionDock';
export { QuickActionCard } from './QuickActionCard';
export { MainActionCard } from './MainActionCard';
既存コードからのプロップマッピング
App.tsx → Combat.tsx (変更なし)
player: Player
enemy: Enemy
turnState: 'PLAYER' | 'ENEMY_TURN'
turnPhase: TurnPhaseState
combatState: CombatState
onUseSkill: (skill: Skill) => void
onPassTurn: () => void
onToggleAutoCombat: () => void
autoCombatEnabled: boolean
Combat.tsx → 新コンポーネント
// PhaseHeader
turnState, turnPhase, combatState.approach
// ConfrontationZone
player, enemy, playerStats, enemyStats
// CharacterPanel (プレイヤー)
character: player, stats: playerStats, variant: 'player'
// CharacterPanel (敵)
character: enemy, stats: enemyStats, variant: 'enemy'
// ActionDock
skills: player.skills, turnPhase, onUseSkill, onPassTurn
移行戦略
フェーズ1: レイアウト基盤
- CSSグリッドで
CombatLayout.tsxを作成 - プレースホルダーコンポーネントを作成
- Combat.tsx にフィーチャーフラグを追加
フェーズ2: コンポーネント抽出
CharacterPanelを実装(PlayerHUD + CinematicViewscreen から抽出)ActionDockを実装(スキルグリッドから抽出)PhaseHeaderを実装(インラインインジケーターから抽出)
フェーズ3: ビジュアルポリッシュ
- エフェクト付き
VSDividerを追加 - アニメーションを実装
- フローティングテキストの位置を調整
フェーズ4: クリーンアップ
- 古いシアターモードコードを削除
- フィーチャーフラグを削除
- テストを更新
参照ファイル
- layout-specs.md - CSSグリッド構造、レスポンシブブレークポイント
- component-interfaces.md - 全コンポーネントのTypeScriptインターフェース
- styling-tokens.md - 色、スペーシング、タイポグラフィトークン
- animations.md - アニメーションキーフレームとトランジション
出力形式
以下の要素を含むTypeScript Reactコンポーネントを生成します:
- プロップス用の TypeScriptインターフェース
- スタイリング用の Tailwind CSS(既存コードベースに準拠)
- レスポンシブクラス(モバイルは縦型にフォールバック)
- 適切な箇所での メモ化(カードには React.memo)
- アクセシビリティ属性(aria-labels、roles)
既存コード参照
実装時には、これらの既存ファイルを参照します:
| 新コンポーネント | 参照元 |
|---|---|
| CharacterPanel (プレイヤー) | src/components/PlayerHUD.tsx |
| CharacterPanel (敵) | src/scenes/Combat.tsx 113-305行 |
| ActionDock | src/scenes/Combat.tsx 308-607行 |
| QuickActionCard | src/components/SkillCard.tsx |
| MainActionCard | src/components/SkillCard.tsx |
| PhaseHeader | src/scenes/Combat.tsx 311-328行 |