naipes

Juegos de cartas españolas en línea de comandos. La versión 0.1.0 incluye brisca. Futuras versiones añadirán tute, mus y más, bajo el mismo paquete.

Instalación

npm install -g naipes

Uso

naipes                       # ayuda
naipes list                  # lista juegos disponibles
naipes rules brisca          # reglas resumidas
naipes play brisca           # jugar contra la IA
naipes play brisca --seed 42 --ai-level easy

Comandos durante la partida: 1, 2, 3 para jugar una carta de tu mano; q para salir; ? para ver ayuda.

Determinismo cross-port

naipes usa un PRNG xorshift64* con valores idénticos en todas las implementaciones del proyecto (Python, TypeScript/JavaScript, Ruby, Rust, etc.). Misma semilla = misma partida exacta, en cualquier lenguaje.

naipes play brisca --seed 42 --ai-level normal

Esta partida produce el mismo desarrollo carta por carta en los diez ports de naipes. Esto se garantiza por test vectors compartidos en spec/vectors/ que todos los ports deben pasar.

Uso programático

import { replay, brisca } from "naipes";

const result = replay(42n, "normal", [1, 1, 1, /* ... 20 plays ... */]);
console.log(result.humanScore, result.aiScore, result.outcome);

// O construir un estado manualmente:
const state = brisca.GameState.new(42n);
state.playCard("human", 0);

Requisitos

• Node.js 20 o superior.

Especificación

Las reglas exactas, el protocolo CLI y los vectores de prueba están en spec/SPEC.md. Todos los ports deben pasar el mismo conjunto de vectores.

Licencia

MIT © Manuel Harguindey