UI de Combate Padrão A - Implementação de Painel Dividido
Esta skill orienta a implementação da Interface de Combate com Painel Dividido, transformando o modo teatro vertical em um layout de confronto horizontal.
Visão Geral da Arquitetura
┌───────────────────────────────────────────────────┐
│ INDICADOR DE TURNO │ PIPELINE DE FASE │ MODIFICADORES │ ← PhaseHeader
├──────────────────┴───────┬───────────┴────────────┤
│ │ │
│ PAINEL DO JOGADOR │ PAINEL DO INIMIGO │ ← ConfrontationZone
│ (CharacterPanel) │ (CharacterPanel) │
│ │ │
├──────────────────────────┴────────────────────────┤
│ AÇÕES RÁPIDAS (LATERAL/ALTERNAR) │ AÇÕES PRINCIPAIS │ ← ActionDock
└───────────────────────────────┴───────────────────┘
Hierarquia de Componentes
Combat.tsx (orquestrador de cena)
├── CombatLayout.tsx (contêiner CSS Grid)
│ ├── PhaseHeader.tsx (barra de status superior)
│ │ ├── TurnIndicator
│ │ ├── PhasePipeline
│ │ ├── SideActionCounter
│ │ └── ApproachModifier
│ │
│ ├── ConfrontationZone.tsx (área de batalha)
│ │ ├── CharacterPanel.tsx (variante do jogador)
│ │ │ ├── CharacterSprite
│ │ │ ├── IdentityBar
│ │ │ ├── ResourceBars (HP/CP)
│ │ │ └── BuffBar
│ │ │
│ │ ├── VSDivider.tsx (emblema central)
│ │ │
│ │ └── CharacterPanel.tsx (variante do inimigo)
│ │ ├── CharacterSprite
│ │ ├── IdentityBar (nome, nível, elemento)
│ │ ├── HealthBar
│ │ ├── DefenseStats
│ │ └── BuffBar
│ │
│ └── ActionDock.tsx (barra de habilidades)
│ ├── QuickActionsSection
│ │ ├── QuickActionCard (habilidades LATERAIS)
│ │ └── QuickActionCard (habilidades ALTERNAR)
│ ├── MainActionsSection
│ │ └── MainActionCard (habilidades PRINCIPAIS)
│ └── ControlButtons (Auto, Finalizar Turno)
│
└── FloatingTextLayer (z-50, inalterado)
Estrutura de Arquivos
src/components/combat/
├── index.ts # Exportação barrel
├── CombatLayout.tsx # Contêiner Grid
├── PhaseHeader.tsx # Barra de status superior
├── ConfrontationZone.tsx # Área Jogador vs Inimigo
├── CharacterPanel.tsx # Exibição reutilizável de personagem
├── VSDivider.tsx # Emblema VS central
├── ActionDock.tsx # Barra de habilidades inferior
├── QuickActionCard.tsx # Cartão compacto LATERAL/ALTERNAR
└── MainActionCard.tsx # Cartão grande de habilidade PRINCIPAL
Fluxo de Trabalho de Implementação
Etapa 1: Identificar Componente Alvo
Pergunte ao usuário qual componente implementar:
- CombatLayout - Comece aqui para nova implementação
- PhaseHeader - Barra de status superior
- ConfrontationZone - Área de batalha com ambos os painéis
- CharacterPanel - Exibição individual de personagem
- VSDivider - Emblema central e efeitos
- ActionDock - Barra de habilidades inferior
- QuickActionCard - Variante compacta de cartão de habilidade
- MainActionCard - Variante grande de cartão de habilidade
Etapa 2: Carregar Referência do Componente
Com base na seleção, carregue a referência apropriada:
- Layout/Estrutura: Veja layout-specs.md
- Props do Componente: Veja component-interfaces.md
- Guia de Estilo: Veja styling-tokens.md
- Especificações de Animação: Veja animations.md
Etapa 3: Gerar Código do Componente
Siga o padrão de template do componente:
import React from 'react';
import { cn } from '@/lib/utils'; // se estiver usando utilitário cn
interface ComponentNameProps {
// Props de component-interfaces.md
}
export const ComponentName: React.FC<ComponentNameProps> = ({
// props desestruturadas
}) => {
return (
<div className={cn(
// Estilos base de styling-tokens.md
// Estilos condicionais
)}>
{/* Conteúdo do componente */}
</div>
);
};
Etapa 4: Conectar ao Combat.tsx
Após a criação do componente:
- Exporte de
components/combat/index.ts - Importe em
Combat.tsx - Substitua a seção correspondente
- Passe as props necessárias do estado existente
Comandos Rápidos de Implementação
Criar Todos os Arquivos (Estrutura Inicial)
# Criar diretório
mkdir -p src/components/combat
# Criar todos os arquivos de componente
touch src/components/combat/{index,CombatLayout,PhaseHeader,ConfrontationZone,CharacterPanel,VSDivider,ActionDock,QuickActionCard,MainActionCard}.tsx
Template de Exportação Barrel
// 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';
Mapeamento de Props do Código Existente
De App.tsx → Combat.tsx (inalterado)
player: Player
enemy: Enemy
turnState: 'PLAYER' | 'ENEMY_TURN'
turnPhase: TurnPhaseState
combatState: CombatState
onUseSkill: (skill: Skill) => void
onPassTurn: () => void
onToggleAutoCombat: () => void
autoCombatEnabled: boolean
Combat.tsx → Novos Componentes
// PhaseHeader
turnState, turnPhase, combatState.approach
// ConfrontationZone
player, enemy, playerStats, enemyStats
// CharacterPanel (jogador)
character: player, stats: playerStats, variant: 'player'
// CharacterPanel (inimigo)
character: enemy, stats: enemyStats, variant: 'enemy'
// ActionDock
skills: player.skills, turnPhase, onUseSkill, onPassTurn
Estratégia de Migração
Fase 1: Fundação do Layout
- Crie
CombatLayout.tsxcom CSS Grid - Crie componentes placeholder
- Adicione flag de funcionalidade em Combat.tsx
Fase 2: Extração de Componentes
- Implemente
CharacterPanel(extraído de PlayerHUD + CinematicViewscreen) - Implemente
ActionDock(extraído de grades de habilidades) - Implemente
PhaseHeader(extraído de indicadores inline)
Fase 3: Polimento Visual
- Adicione
VSDividercom efeitos - Implemente animações
- Ajuste posições de texto flutuante
Fase 4: Limpeza
- Remova código antigo do modo teatro
- Remova flag de funcionalidade
- Atualize testes
Arquivos de Referência
- layout-specs.md - Estrutura CSS Grid, breakpoints responsivos
- component-interfaces.md - Interfaces TypeScript para todos os componentes
- styling-tokens.md - Tokens de cores, espaçamento, tipografia
- animations.md - Keyframes e transições de animação
Formato de Saída
Gere componentes React TypeScript com:
- Interface TypeScript para props
- Tailwind CSS para estilização (combinando com o código base existente)
- Classes responsivas (fallback para vertical no mobile)
- Memoização onde apropriado (React.memo para cartões)
- Atributos de acessibilidade (aria-labels, roles)
Referências de Código Existente
Ao implementar, faça referência a estes arquivos existentes:
| Novo Componente | Referência de |
|---|---|
| CharacterPanel (jogador) | src/components/PlayerHUD.tsx |
| CharacterPanel (inimigo) | src/scenes/Combat.tsx linhas 113-305 |
| ActionDock | src/scenes/Combat.tsx linhas 308-607 |
| QuickActionCard | src/components/SkillCard.tsx |
| MainActionCard | src/components/SkillCard.tsx |
| PhaseHeader | src/scenes/Combat.tsx linhas 311-328 |