Barajar una baraja con semilla

Si utiliza de nuevo la misma semilla, recibirá el mismo orden, lo que facilita revisar y compartir simulaciones, pruebas, ejercicios y partidas reproducibles. El resultado usa códigos compactos de valor y palo, contiene cada carta una sola vez y se genera sin red, hora actual ni aleatoriedad oculta. Semillas distintas producen normalmente órdenes distintos, pero conservan la construcción y el procedimiento documentados.

Cree una mezcla repetible con un solo entero

Indique un entero en el campo <code>seed</code>. La capacidad construye primero una baraja estándar de 52 cartas en un orden canónico fijo: picas, corazones, diamantes y tréboles, y cada palo desde el as hasta el rey. Después aplica una secuencia seudoaleatoria sembrada a una mezcla de Fisher-Yates. Como todas las entradas del proceso son fijas, el orden resultante también lo es. La semilla 42 produce hoy exactamente la misma respuesta que la semilla 42 en otra solicitud, entorno o prueba. Esa repetibilidad es la finalidad principal de la herramienta. Permite incluir una baraja mezclada en una prueba sin guardar 52 valores, distribuir un ejercicio común o registrar la semilla necesaria para reconstruir un reparto inicial. La respuesta también devuelve la semilla para que los resultados guardados se expliquen por sí solos. Solo se aceptan enteros JSON seguros; se rechazan decimales, cadenas numéricas, valores ausentes, infinitos y enteros fuera del rango exacto de JavaScript, sin redondearlos ni reinterpretarlos silenciosamente.

Interprete correctamente el orden devuelto

El arreglo <code>deck</code> contiene exactamente 52 cadenas únicas en orden de extracción. Cada cadena une un valor con un código de palo de una letra. Los valores son <code>A</code>, del <code>2</code> al <code>10</code>, <code>J</code>, <code>Q</code> y <code>K</code>. Los palos son <code>S</code> para picas, <code>H</code> para corazones, <code>D</code> para diamantes y <code>C</code> para tréboles. Por tanto, <code>AS</code> representa el as de picas y <code>10D</code> el diez de diamantes. El primer elemento es la carta superior; después aparecen la segunda carta que se roba y las siguientes. La capacidad no reparte manos, añade comodines, clasifica jugadas de póquer ni modifica el orden tras devolverlo. Esas decisiones corresponden a la aplicación que la llama. Para repartir cinco cartas a cuatro jugadores, por ejemplo, consuma las primeras veinte entradas según el patrón elegido. Una salida primitiva y explícita evita imponer reglas de mesa y permite copiar, comparar, serializar o enviar fácilmente la permutación completa a un simulador.

Utilice la mezcla determinista con responsabilidad

Una mezcla determinista está pensada para reproducirse, no para mantener secretos. Quien conozca la semilla y el algoritmo puede reconstruir la baraja completa; por eso resulta adecuada para pruebas, demostraciones, simulaciones, rompecabezas con semillas publicadas y juegos donde importa más repetir que ocultar. No debe utilizarse para apuestas, premios, decisiones de seguridad ni situaciones en las que anticipar cartas dé ventaja. En esos casos, emplee una fuente aleatoria criptográficamente segura y mantenga su estado confidencial. Dentro del uso previsto, una semilla simplifica mucho la depuración: inclúyala en el informe de una prueba fallida, repita localmente el mismo reparto y compare el comportamiento carta por carta. También puede ejecutar lotes con semillas consecutivas para obtener situaciones estables sin almacenar grandes archivos de datos en el repositorio. La implementación no usa red, reloj, estado global mutable, <code>Math.random</code> ni datos externos. Su definición fija de la baraja y sus 51 intercambios acotados facilitan auditar tanto el tiempo de ejecución como la salida.