Interfaz de Combate Patrón A - Implementación de Panel Dividido
Esta habilidad guía la implementación de la Interfaz de Combate de Panel Dividido, transformando la vertical modalidad teatro en un diseño de confrontación horizontal.
Resumen de Arquitectura
┌───────────────────────────────────────────────────┐
│ INDICADOR DE TURNO │ TUBERÍA DE FASE │ MODIFICADORES │ ← PhaseHeader
├──────────────────┴───────┬───────────┴────────────┤
│ │ │
│ PANEL JUGADOR │ PANEL ENEMIGO │ ← ConfrontationZone
│ (CharacterPanel) │ (CharacterPanel) │
│ │ │
├──────────────────────────┴────────────────────────┤
│ ACCIONES RÁPIDAS (LATERAL/ALTERNAR) │ ACCIONES PRINCIPALES │ ← ActionDock
└───────────────────────────────┴───────────────────┘
Jerarquía de Componentes
Combat.tsx (orquestador de escena)
├── CombatLayout.tsx (contenedor CSS Grid)
│ ├── PhaseHeader.tsx (barra de estado superior)
│ │ ├── TurnIndicator
│ │ ├── PhasePipeline
│ │ ├── SideActionCounter
│ │ └── ApproachModifier
│ │
│ ├── ConfrontationZone.tsx (área de batalla)
│ │ ├── CharacterPanel.tsx (variante jugador)
│ │ │ ├── CharacterSprite
│ │ │ ├── IdentityBar
│ │ │ ├── ResourceBars (HP/CP)
│ │ │ └── BuffBar
│ │ │
│ │ ├── VSDivider.tsx (emblema central)
│ │ │
│ │ └── CharacterPanel.tsx (variante enemigo)
│ │ ├── CharacterSprite
│ │ ├── IdentityBar (nombre, nivel, elemento)
│ │ ├── HealthBar
│ │ ├── DefenseStats
│ │ └── BuffBar
│ │
│ └── ActionDock.tsx (barra de habilidades)
│ ├── QuickActionsSection
│ │ ├── QuickActionCard (habilidades LATERALES)
│ │ └── QuickActionCard (habilidades ALTERNAR)
│ ├── MainActionsSection
│ │ └── MainActionCard (habilidades PRINCIPALES)
│ └── ControlButtons (Auto, Finalizar Turno)
│
└── FloatingTextLayer (z-50, sin cambios)
Estructura de Archivos
src/components/combat/
├── index.ts # Exportaciones de barril
├── CombatLayout.tsx # Contenedor Grid
├── PhaseHeader.tsx # Barra de estado superior
├── ConfrontationZone.tsx # Área de Jugador vs Enemigo
├── CharacterPanel.tsx # Pantalla de personaje reutilizable
├── VSDivider.tsx # Emblema central VS
├── ActionDock.tsx # Barra de habilidades inferior
├── QuickActionCard.tsx # Tarjeta compacta LATERAL/ALTERNAR
└── MainActionCard.tsx # Tarjeta grande de habilidad PRINCIPAL
Flujo de Trabajo de Implementación
Paso 1: Identificar Componente Objetivo
Preguntar al usuario qué componente implementar:
- CombatLayout - Comenzar aquí para nueva implementación
- PhaseHeader - Barra de estado superior
- ConfrontationZone - Área de batalla con ambos paneles
- CharacterPanel - Pantalla de personaje individual
- VSDivider - Emblema central y efectos
- ActionDock - Barra de habilidades inferior
- QuickActionCard - Tarjeta de habilidad compacta variante
- MainActionCard - Tarjeta de habilidad grande variante
Paso 2: Cargar Referencia de Componente
Basado en la selección, cargar la referencia apropiada:
- Diseño/Estructura: Ver layout-specs.md
- Props de Componente: Ver component-interfaces.md
- Guía de Estilo: Ver styling-tokens.md
- Especificaciones de Animación: Ver animations.md
Paso 3: Generar Código del Componente
Seguir el patrón de plantilla de componente:
import React from 'react';
import { cn } from '@/lib/utils'; // si se usa utilidad cn
interface ComponentNameProps {
// Props de component-interfaces.md
}
export const ComponentName: React.FC<ComponentNameProps> = ({
// props desestructurados
}) => {
return (
<div className={cn(
// Estilos base de styling-tokens.md
// Estilos condicionales
)}>
{/* Contenido del componente */}
</div>
);
};
Paso 4: Conectar a Combat.tsx
Después de la creación del componente:
- Exportar desde
components/combat/index.ts - Importar en
Combat.tsx - Reemplazar la sección correspondiente
- Pasar las props requeridas desde el estado existente
Comandos Rápidos de Implementación
Crear Todos los Archivos (Andamio)
# Crear directorio
mkdir -p src/components/combat
# Crear todos los archivos de componentes
touch src/components/combat/{index,CombatLayout,PhaseHeader,ConfrontationZone,CharacterPanel,VSDivider,ActionDock,QuickActionCard,MainActionCard}.tsx
Plantilla de Exportación de Barril
// 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';
Mapeo de Props desde Código Existente
Desde App.tsx → Combat.tsx (sin cambios)
player: Player
enemy: Enemy
turnState: 'PLAYER' | 'ENEMY_TURN'
turnPhase: TurnPhaseState
combatState: CombatState
onUseSkill: (skill: Skill) => void
onPassTurn: () => void
onToggleAutoCombat: () => void
autoCombatEnabled: boolean
Combat.tsx → Nuevos Componentes
// PhaseHeader
turnState, turnPhase, combatState.approach
// ConfrontationZone
player, enemy, playerStats, enemyStats
// CharacterPanel (jugador)
character: player, stats: playerStats, variant: 'player'
// CharacterPanel (enemigo)
character: enemy, stats: enemyStats, variant: 'enemy'
// ActionDock
skills: player.skills, turnPhase, onUseSkill, onPassTurn
Estrategia de Migración
Fase 1: Base de Diseño
- Crear
CombatLayout.tsxcon CSS Grid - Crear componentes placeholder
- Agregar indicador de funcionalidad en Combat.tsx
Fase 2: Extracción de Componentes
- Implementar
CharacterPanel(extraer de PlayerHUD + CinematicViewscreen) - Implementar
ActionDock(extraer de cuadrículas de habilidades) - Implementar
PhaseHeader(extraer de indicadores en línea)
Fase 3: Pulido Visual
- Agregar
VSDividercon efectos - Implementar animaciones
- Ajustar posiciones de texto flotante
Fase 4: Limpieza
- Eliminar código antiguo de modalidad teatro
- Eliminar indicador de funcionalidad
- Actualizar pruebas
Archivos de Referencia
- layout-specs.md - Estructura CSS Grid, puntos de interrupción responsivos
- component-interfaces.md - Interfaces TypeScript para todos los componentes
- styling-tokens.md - Tokens de colores, espaciado, tipografía
- animations.md - Fotogramas clave de animación y transiciones
Formato de Salida
Generar componentes React TypeScript con:
- Interfaz TypeScript para props
- Tailwind CSS para estilos (coincidiendo con la base de código existente)
- Clases responsivas (retroceso móvil a vertical)
- Memoización donde sea apropiado (React.memo para tarjetas)
- Atributos de accesibilidad (aria-labels, roles)
Referencias de Código Existente
Al implementar, hacer referencia a estos archivos existentes:
| Nuevo Componente | Referencia Desde |
|---|---|
| CharacterPanel (jugador) | src/components/PlayerHUD.tsx |
| CharacterPanel (enemigo) | src/scenes/Combat.tsx líneas 113-305 |
| ActionDock | src/scenes/Combat.tsx líneas 308-607 |
| QuickActionCard | src/components/SkillCard.tsx |
| MainActionCard | src/components/SkillCard.tsx |
| PhaseHeader | src/scenes/Combat.tsx líneas 311-328 |