cards

Node.js library for dealing with playing cards of all types

https://github.com/kbjr/node-cards

Fully extensible, you can create custom versions of any component to make different types of deck, including support for custom decks, suits, ranks, and cards.

Version 2

Version 2 has now been released. Short list of some of the notable changes:

• Rewrite in TypeScript
• New customizable randomization source
  • The previous options related to RNG have been removed, and a new RandomGenerator interface exists to enable providing a custom RNG implementation.
  • Built-in implementations are provided for Math.random() and the node.js crypto module's pseudoRandomBytes() as randomization sources.
• Some thing have moved around to new locations
• With TypeScript came a switch to using TypeDoc for documentation generation, so docs look different now
• Now has no runtime dependencies (check the package.json)

Install

$ npm install cards

Features

• Ability to create decks of cards of various configurations
  • Shuffle the deck
  • Draw cards and discard cards
• Card types
  • Standard suits and values
    • Suits: spades, hearts, diamonds, clubs
    • Values: 2 - 10, Jack, Queen, King, Ace
  • Trump suit / Fool card
  • Minor Arcana
    • Suits: coins, wands, cups, swords
    • Values: 2 - 10, Page, Knight / Cavalier, Queen, King, Ace
  • Major Arcana (Tarot cards)
  • Jokers
• Deck types
  • Standard 52 card deck
  • 78 card tarot deck
  • 24 card euchre deck
  • 48 card pinochel deck
  • 32 card piquet deck
  • 40 card baraja deck
  • 22 card major arcana deck
  • Support for creating custom decks
• Supports unicode playing card characters where available
• TypeScript definitions provided

Examples

import { decks } from 'cards';

// Create a standard 52 card deck + 2 jokers
const deck = new decks.StandardDeck({ jokers: 2 });

// Shuffle the deck
deck.shuffleAll();

// Draw a hand of five cards from the deck
const hand = deck.draw(5);

// Pull 2 cards out of the hand to exchange
const toExchange = hand.splice(2, 2);

// Discard those 2 cards
deck.discard(toExchange);

// Draw 2 new ones from the deck
hand.push(...deck.draw(2));

Custom Randomization Source

import { RandomGenerator, decks } from 'cards';

// Create a new RandomGenerator implementation
class MyRNG implements RandomGenerator {
  // The `int` method should return a random integer between 0 and `max`
  int(max: number) : number {
    return (Math.random() * max) | 0;
  }
}

// You can pass an instance of RNG implemenation to any `Deck` class, and
// it will be used for any randomization requiring tasks (i.e. shuffling)
const deck = new decks.StandardDeck({ rng: new MyRNG() });

TODO

• Finish building out poker hand evaluation logic

---

Like my work?