Kingdomino CLI

██╗  ██╗██╗███╗   ██╗ ██████╗ ██████╗  ██████╗ ███╗   ███╗██╗███╗   ██╗ ██████╗
██║ ██╔╝██║████╗  ██║██╔════╝ ██╔══██╗██╔═══██╗████╗ ████║██║████╗  ██║██╔═══██╗
█████╔╝ ██║██╔██╗ ██║██║  ███╗██║  ██║██║   ██║██╔████╔██║██║██╔██╗ ██║██║   ██║
██╔═██╗ ██║██║╚██╗██║██║   ██║██║  ██║██║   ██║██║╚██╔╝██║██║██║╚██╗██║██║   ██║
██║  ██╗██║██║ ╚████║╚██████╔╝██████╔╝╚██████╔╝██║ ╚═╝ ██║██║██║ ╚████║╚██████╔╝
╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚═════╝  ╚═════╝ ╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝ ╚═════╝

Build your kingdom, one domino at a time.

Un jeu Kingdomino complet dans votre terminal ! Jouez seul contre des bots ou entre amis, directement depuis la ligne de commande.

Fonctionnalites

• 2 a 4 joueurs — humains et/ou bots
• 4 niveaux de bots — random, greedy, advanced, expert
• Rendu riche en Unicode — terrains emoji (🏰 🌾 🌲 🌊 🌿 🏚 ⛏), couronnes (👑), couleurs
• Interface interactive — navigation clavier, curseur de placement, ghost preview
• Regles extras — configurables dynamiquement selon le mode et le nombre de joueurs
• Ecran de resultats — classement avec medailles 🥇🥈🥉, score anime, mini-royaumes
• Transitions animees — overlay entre joueurs, flash de placement, pulsation du titre
• Replay immediat — rejouez directement depuis l'ecran de resultats

Installation

# Via npx (pas d'installation)
npx @pompidup/kingdomino-cli

# Ou installation globale
npm install -g @pompidup/kingdomino-cli
kingdomino

Utilisation

kingdomino [options]

Options

| Option | Description | |--------|-------------| | --help, -h | Affiche l'aide | | --version, -v | Affiche la version | | --debug | Mode debug (logging verbose du moteur) |

Controles

| Ecran | Touches | Action | |-------|---------|--------| | Titre | Enter | Demarrer | | Config | Tab | Naviguer entre les champs | | | ↑ ↓ | Changer les valeurs | | | Espace | Activer/desactiver les regles extras | | | Enter | Lancer la partie | | Jeu — Pick | ↑ ↓ | Selectionner un domino | | | Enter | Choisir le domino | | Jeu — Place | ← ↑ ↓ → | Deplacer le curseur | | | R | Rotation (0° → 90° → 180° → 270°) | | | Enter | Placer le domino | | | D | Defausser (si aucun placement valide) | | | Tab | Voir les royaumes des autres joueurs | | Resultats | Enter | Rejouer | | | Q | Quitter | | Global | Ctrl+C | Quitter |

Architecture

Le projet suit une Clean Architecture (Ports & Adapters) :

src/
├── domain/          # Types metier, ports (interfaces)
│   ├── types.ts         # AppState, ScreenName, GameConfig, CursorState
│   └── ports/           # GamePort, BotPort, StatePort, UIPort
├── application/     # Use cases, orchestration
│   ├── state-manager.ts     # Gestion d'etat (dispatch/subscribe)
│   ├── selectors.ts         # Selecteurs purs derives du state
│   ├── game-orchestrator.ts # Setup de partie
│   ├── config-validator.ts  # Validation de config
│   └── error-feedback.ts    # Mapping erreurs → feedback UI
├── infrastructure/  # Adapters concrets
│   ├── engine-adapter.ts    # Wraps @pompidup/kingdomino-engine
│   └── bot-adapter.ts       # Wraps les strategies bot
├── presentation/    # Fonctions de rendu pures → RenderLine[]
│   ├── terrain.ts               # Tuiles, symboles, couleurs
│   ├── kingdom-grid.ts          # Grille 9x9 avec ghost preview
│   ├── draft-column.ts          # Colonne de selection de dominos
│   ├── turn-info.ts             # Barre d'info du tour
│   ├── status-bar.ts            # Raccourcis clavier / erreurs
│   ├── transition-overlay.ts    # Overlay transition joueur
│   ├── results-screen-render.ts # Ecran de resultats
│   └── ...
├── screens/         # Ecrans interactifs (App + key handlers)
│   ├── title-screen.ts
│   ├── config-screen.ts
│   ├── game-screen.ts
│   └── results-screen.ts
├── cli.ts           # Parsing des arguments CLI
└── index.ts         # Point d'entree, wiring DI

Principes cles

• Result Pattern — Les adapters retournent { ok, value } | { ok, error }, jamais de throw
• Immutabilite — Chaque dispatch produit un nouvel etat
• Separation UI/logique — Les composants ne connaissent que leurs props
• Dependency Injection — Tous les adapters sont injectes dans les ecrans

Developpement

Prerequis

• Node.js >= 18
• pnpm >= 10

Installation

pnpm install

Scripts

pnpm build        # Build avec tsup
pnpm dev          # Build en mode watch
pnpm start        # Lancer le jeu (apres build)
pnpm test         # Tests unitaires et integration (vitest)
pnpm lint         # Type-check (tsc --noEmit)
pnpm lint:check   # ESLint
pnpm format       # Formatter avec Prettier
pnpm format:check # Verifier le formatage

Stack technique

| Outil | Role | |-------|------| | TypeScript | Langage | | tsup | Bundler | | Vitest | Tests | | ESLint | Linting | | Prettier | Formatage | | @pompidup/kingdomino-engine | Moteur de jeu | | @pompidup/cligrid | Framework TUI |

Terrains

| Terrain | Emoji | Couleur | |---------|-------|---------| | Chateau | 🏰 | Gris | | Ble | 🌾 | Jaune | | Foret | 🌲 | Vert fonce | | Mer | 🌊 | Bleu | | Prairie | 🌿 | Vert clair | | Marais | 🏚 | Marron | | Mine | ⛏ | Gris fonce |

Licence

MIT - voir LICENSE