AI Chess Assistant

src/
├── types/          # TypeScript type definitions
│   ├── chess.types.ts      # FEN, moves, scores
│   ├── engine.types.ts     # Engine communication
│   └── ui.types.ts         # UI component types
├── services/       # Core services
│   ├── board.service.ts    # Board state & FEN generation
│   └── engine.service.ts   # Stockfish WebWorker
├── components/     # UI components
│   ├── panel.component.ts  # Main control panel
│   └── highlights.component.ts  # Move highlighting
├── core/           # Business logic
│   ├── analysis.manager.ts # Analysis state management
│   └── autoplay.manager.ts # Automated move execution
└── content/        # Entry point
    └── assistant.ts        # Main orchestrator

src/
├── types/          # Définitions de types TypeScript
│   ├── chess.types.ts      # FEN, coups, scores
│   ├── engine.types.ts     # Communication moteur
│   └── ui.types.ts         # Types des composants UI
├── services/       # Services principaux
│   ├── board.service.ts    # État de l'échiquier & génération FEN
│   └── engine.service.ts   # WebWorker Stockfish
├── components/     # Composants UI
│   ├── panel.component.ts  # Panneau de contrôle principal
│   └── highlights.component.ts  # Surbrillance des coups
├── core/           # Logique métier
│   ├── analysis.manager.ts # Gestion de l'état d'analyse
│   └── autoplay.manager.ts # Exécution automatique des coups
└── content/        # Point d'entrée
    └── assistant.ts        # Orchestrateur principal

• Service Pattern - Encapsulated services for board and engine interaction
• Observer Pattern - Event-based engine updates with subscription model
• Singleton Pattern - Single instance services for state consistency
• Facade Pattern - ChessAssistant class orchestrates all subsystems

• Service Pattern - Services encapsulés pour l'interaction avec l'échiquier et le moteur
• Observer Pattern - Mises à jour du moteur basées sur les événements avec modèle d'abonnement
• Singleton Pattern - Services à instance unique pour la cohérence de l'état
• Facade Pattern - La classe ChessAssistant orchestre tous les sous-systèmes

FEN Generation

public generateFEN(): FENString {
  // Iterates through board squares
  // Maps CSS classes to piece symbols
  // Returns standard FEN string
}

Engine Communication

public analyze(fen: FENString, depth?: Depth): void {
  this.worker.postMessage(`position fen ${fen}`);
  this.worker.postMessage(`go depth ${depth}`);
}

Event-Driven Updates

engine.subscribe((event: EngineEvent) => {
  if (event.type === 'bestmove') {
    // Handle best move found
  }
});

Génération FEN

public generateFEN(): FENString {
  // Itère à travers les cases de l'échiquier
  // Mappe les classes CSS aux symboles de pièces
  // Retourne une chaîne FEN standard
}

Communication avec le Moteur

public analyze(fen: FENString, depth?: Depth): void {
  this.worker.postMessage(`position fen ${fen}`);
  this.worker.postMessage(`go depth ${depth}`);
}

Mises à Jour Événementielles

engine.subscribe((event: EngineEvent) => {
  if (event.type === 'bestmove') {
    // Traitement du meilleur coup trouvé
  }
});

• Compact Design - 260px width, minimal footprint
• Draggable Panel - Position anywhere on screen
• Minimizable - Collapse to small "+" button at 50% opacity
• Color Selection - Analyze from White or Black's perspective
• Move History - Color-coded ratings (Excellent/Good/OK/Poor)

• Design Compact - 260px de largeur, empreinte minimale
• Panneau Déplaçable - Positionnable n'importe où sur l'écran
• Minimisable - Se réduit en un petit bouton "+" à 50% d'opacité
• Sélection de Couleur - Analyse du point de vue des Blancs ou des Noirs
• Historique des Coups - Évaluations colorées (Excellent/Bon/Correct/Faible)