alea-deck

Uniform and weighted shuffling and sampling, just like
deck, but utilizing
Alea instead of Math.random.

Example

`` javascript
var deck = require('alea-deck');

deck.shuffle([1, 2, 3, 4]);
// => [1, 4, 2, 3]

deck.pick([1, 2, 3, 4]);
// => 2

deck.shuffle({
a: 10,
b: 8,
c: 2,
d: 1,
e: 1
});
// => ['b', 'a', 'c', 'd', 'e']

deck.pick({
a: 10,
b: 8,
c: 2,
d: 1,
e: 1
});
// => a
`

Installation

` bash
$ npm install alea-deck
`

API

` javascript
var deck = require('alea-deck');
`

$3

If collection is an _Array_, returns a new shuffled _Array_ based on a unifrom
distributionm without mutating the original _Array_.

Otherwise, if collection is an _Object_, returns a new shuffled _Array_ of
collection's visible keys based on the value weights of collection.

$3

Samples collection without mutating collection.

If collection is an _Array_, returns a random element from collection with a
uniform distribution.

Otherwise, if collection is an _Object_, returns a random key from
collection biased by its normalized value.

$3

Return a new obj _Object_ where the values have been divided by the sum of all
the values such that the sum of all the values in the returned _Object_ is 1.

If any weights are < 0`, an _Error_ is thrown.