Interface de Combat Pattern A - Implémentation à Panneaux Fractionnés
Cette compétence guide l'implémentation de l'interface de combat à panneaux fractionnés, transformant le mode théâtre vertical en une disposition de confrontation horizontale.
Aperçu de l'Architecture
┌───────────────────────────────────────────────────┐
│ INDICATEUR DE TOUR │ PIPELINE DE PHASE │ MODIFICATEURS │ ← PhaseHeader
├──────────────────┴───────┬───────────┴────────────┤
│ │ │
│ PANNEAU JOUEUR │ PANNEAU ENNEMI │ ← ConfrontationZone
│ (CharacterPanel) │ (CharacterPanel) │
│ │ │
├──────────────────────────┴────────────────────────┤
│ ACTIONS RAPIDES (CÔTÉ/BASCULE) │ ACTIONS PRINCIPALES │ ← ActionDock
└───────────────────────────────┴───────────────────┘
Hiérarchie des Composants
Combat.tsx (orchestrateur de scène)
├── CombatLayout.tsx (conteneur CSS Grid)
│ ├── PhaseHeader.tsx (barre d'état supérieure)
│ │ ├── TurnIndicator
│ │ ├── PhasePipeline
│ │ ├── SideActionCounter
│ │ └── ApproachModifier
│ │
│ ├── ConfrontationZone.tsx (zone de combat)
│ │ ├── CharacterPanel.tsx (variante joueur)
│ │ │ ├── CharacterSprite
│ │ │ ├── IdentityBar
│ │ │ ├── ResourceBars (HP/CP)
│ │ │ └── BuffBar
│ │ │
│ │ ├── VSDivider.tsx (emblème central)
│ │ │
│ │ └── CharacterPanel.tsx (variante ennemi)
│ │ ├── CharacterSprite
│ │ ├── IdentityBar (nom, rang, élément)
│ │ ├── HealthBar
│ │ ├── DefenseStats
│ │ └── BuffBar
│ │
│ └── ActionDock.tsx (barre de compétences)
│ ├── QuickActionsSection
│ │ ├── QuickActionCard (compétences CÔTÉ)
│ │ └── QuickActionCard (compétences BASCULE)
│ ├── MainActionsSection
│ │ └── MainActionCard (compétences PRINCIPALES)
│ └── ControlButtons (Auto, Fin de tour)
│
└── FloatingTextLayer (z-50, inchangé)
Structure des Fichiers
src/components/combat/
├── index.ts # Exportations groupées
├── CombatLayout.tsx # Conteneur Grid
├── PhaseHeader.tsx # Barre d'état supérieure
├── ConfrontationZone.tsx # Zone Joueur vs Ennemi
├── CharacterPanel.tsx # Affichage réutilisable des personnages
├── VSDivider.tsx # Emblème central VS
├── ActionDock.tsx # Barre de compétences inférieure
├── QuickActionCard.tsx # Carte compacte CÔTÉ/BASCULE
└── MainActionCard.tsx # Grande carte de compétence PRINCIPALE
Workflow d'Implémentation
Étape 1 : Identifier le Composant Cible
Demander à l'utilisateur quel composant implémenter :
- CombatLayout - Commencer ici pour une nouvelle implémentation
- PhaseHeader - Barre d'état supérieure
- ConfrontationZone - Zone de combat avec les deux panneaux
- CharacterPanel - Affichage individuel du personnage
- VSDivider - Emblème central et effets
- ActionDock - Barre de compétences inférieure
- QuickActionCard - Variante de carte compacte
- MainActionCard - Variante de grande carte de compétence
Étape 2 : Charger la Référence du Composant
En fonction de la sélection, charger la référence appropriée :
- Disposition/Structure : Voir layout-specs.md
- Props des Composants : Voir component-interfaces.md
- Guide de Style : Voir styling-tokens.md
- Spécifications d'Animation : Voir animations.md
Étape 3 : Générer le Code du Composant
Suivre le modèle de composant :
import React from 'react';
import { cn } from '@/lib/utils'; // si utilisation de l'utilitaire cn
interface ComponentNameProps {
// Props provenant de component-interfaces.md
}
export const ComponentName: React.FC<ComponentNameProps> = ({
// props déstructurées
}) => {
return (
<div className={cn(
// Styles de base provenant de styling-tokens.md
// Styles conditionnels
)}>
{/* Contenu du composant */}
</div>
);
};
Étape 4 : Intégrer à Combat.tsx
Après la création du composant :
- Exporter depuis
components/combat/index.ts - Importer dans
Combat.tsx - Remplacer la section correspondante
- Passer les props requises depuis l'état existant
Commandes d'Implémentation Rapide
Créer Tous les Fichiers (Échafaudage)
# Créer le répertoire
mkdir -p src/components/combat
# Créer tous les fichiers de composants
touch src/components/combat/{index,CombatLayout,PhaseHeader,ConfrontationZone,CharacterPanel,VSDivider,ActionDock,QuickActionCard,MainActionCard}.tsx
Modèle d'Exportation Groupée
// 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';
Mappage des Props depuis le Code Existant
Depuis App.tsx → Combat.tsx (inchangé)
player: Player
enemy: Enemy
turnState: 'PLAYER' | 'ENEMY_TURN'
turnPhase: TurnPhaseState
combatState: CombatState
onUseSkill: (skill: Skill) => void
onPassTurn: () => void
onToggleAutoCombat: () => void
autoCombatEnabled: boolean
Combat.tsx → Nouveaux Composants
// PhaseHeader
turnState, turnPhase, combatState.approach
// ConfrontationZone
player, enemy, playerStats, enemyStats
// CharacterPanel (joueur)
character: player, stats: playerStats, variant: 'player'
// CharacterPanel (ennemi)
character: enemy, stats: enemyStats, variant: 'enemy'
// ActionDock
skills: player.skills, turnPhase, onUseSkill, onPassTurn
Stratégie de Migration
Phase 1 : Fondation de la Disposition
- Créer
CombatLayout.tsxavec CSS Grid - Créer des composants factices
- Ajouter un indicateur de fonctionnalité dans Combat.tsx
Phase 2 : Extraction des Composants
- Implémenter
CharacterPanel(extraire de PlayerHUD + CinematicViewscreen) - Implémenter
ActionDock(extraire des grilles de compétences) - Implémenter
PhaseHeader(extraire des indicateurs en ligne)
Phase 3 : Polissage Visuel
- Ajouter
VSDivideravec effets - Implémenter les animations
- Ajuster les positions des textes flottants
Phase 4 : Nettoyage
- Supprimer l'ancien code du mode théâtre
- Supprimer l'indicateur de fonctionnalité
- Mettre à jour les tests
Fichiers de Référence
- layout-specs.md - Structure CSS Grid, points de rupture responsifs
- component-interfaces.md - Interfaces TypeScript pour tous les composants
- styling-tokens.md - Couleurs, espacements, jetons typographiques
- animations.md - Images clés et transitions d'animation
Format de Sortie
Générer des composants React TypeScript avec :
- Interface TypeScript pour les props
- Tailwind CSS pour le style (correspondant à la base de code existante)
- Classes responsives (repli mobile en vertical)
- Mémoïsation si approprié (React.memo pour les cartes)
- Attributs d'accessibilité (aria-labels, rôles)
Références de Code Existant
Lors de l'implémentation, référencer ces fichiers existants :
| Nouveau Composant | Référence depuis |
|---|---|
| CharacterPanel (joueur) | src/components/PlayerHUD.tsx |
| CharacterPanel (ennemi) | src/scenes/Combat.tsx lignes 113-305 |
| ActionDock | src/scenes/Combat.tsx lignes 308-607 |
| QuickActionCard | src/components/SkillCard.tsx |
| MainActionCard | src/components/SkillCard.tsx |
| PhaseHeader | src/scenes/Combat.tsx lignes 311-328 |