Embaralhar baralho com semente

Ao usar a mesma semente novamente, você recebe a mesma sequência, o que facilita analisar e compartilhar simulações, testes, exercícios e partidas reproduzíveis. O resultado usa códigos compactos de valor e naipe, inclui cada carta exatamente uma vez e é criado sem rede, relógio ou aleatoriedade oculta. Sementes diferentes normalmente geram ordens diferentes, mantendo a mesma construção de baralho e o mesmo procedimento documentado.

Crie um embaralhamento repetível com um inteiro

Informe um número inteiro no campo <code>seed</code>. A capacidade monta primeiro um baralho padrão de 52 cartas em uma ordem canônica fixa: espadas, copas, ouros e paus, com cada naipe indo do ás ao rei. Em seguida, aplica uma sequência pseudoaleatória iniciada pela semente ao algoritmo de Fisher-Yates. Como todas as entradas desse processo são fixas, a ordem resultante também é fixa. A semente 42 produz hoje exatamente a mesma resposta que produzirá em outra solicitação, ambiente ou execução de teste. Essa repetibilidade é o objetivo central da ferramenta. Ela permite colocar um baralho embaralhado em um fixture sem armazenar 52 valores, distribuir um exercício comum ou registrar a semente necessária para reconstruir a distribuição inicial de uma partida. A resposta inclui a semente para que resultados salvos sejam autodescritivos. Somente inteiros JSON seguros são aceitos; decimais, strings numéricas, valores ausentes, infinitos e inteiros fora da faixa exata do JavaScript são rejeitados, sem arredondamento ou reinterpretação silenciosa.

Entenda corretamente a ordem retornada

O array <code>deck</code> contém exatamente 52 strings únicas na ordem de compra. Cada string combina um valor com um código de naipe de uma letra. Os valores são <code>A</code>, de <code>2</code> a <code>10</code>, <code>J</code>, <code>Q</code> e <code>K</code>. Os naipes são <code>S</code> para espadas, <code>H</code> para copas, <code>D</code> para ouros e <code>C</code> para paus. Assim, <code>AS</code> é o ás de espadas e <code>10D</code> é o dez de ouros. O primeiro item do array é a carta do topo, seguido pela segunda carta a comprar e assim por diante. A capacidade não distribui mãos, adiciona curingas, classifica combinações de pôquer nem altera a ordem depois da resposta. Essas decisões cabem ao aplicativo chamador. Para dar cinco cartas a quatro jogadores, por exemplo, consuma as primeiras vinte entradas conforme o padrão de distribuição escolhido. Uma saída simples e explícita evita impor regras de mesa e torna a permutação completa fácil de copiar, comparar, serializar ou enviar a um simulador.

Use o embaralhamento determinístico com responsabilidade

Um embaralhamento determinístico foi feito para reprodução, não para sigilo. Qualquer pessoa que conheça a semente e o algoritmo consegue reconstruir o baralho inteiro. Portanto, esta capacidade é adequada para testes, demonstrações, simulações, quebra-cabeças com sementes publicadas e jogos em que repetir uma sessão importa mais do que esconder o estado. Não a use em apostas, prêmios, decisões de segurança ou situações nas quais prever cartas futuras criaria vantagem. Nesses casos, use uma fonte de aleatoriedade criptograficamente segura e mantenha o estado confidencial. No escopo correto, a semente simplifica muito a depuração: inclua-a no relatório de um teste com falha, repita localmente a mesma distribuição e compare o comportamento carta por carta. Também é possível executar lotes com sementes consecutivas para obter cenários estáveis sem versionar arquivos enormes de fixtures. A implementação não usa rede, relógio, estado global mutável, <code>Math.random</code> nem dados externos. A definição fixa e as 51 trocas limitadas tornam a execução e a saída fáceis de auditar.