SB-6.1-PRE

2021-02-02 13:50:53 +00:00
1 parent 690169a409
commit 358a25f522
@@ -0,0 +1 @@
+chancejs.com
@@ -0,0 +1,127 @@
+* [Chance](intro.md)
+* Usage
+  * [bower](usage/bower.md)
+  * [browser](usage/browser.md)
+  * [cli](usage/cli.md)
+  * [node](usage/node.md)
+  * [requirejs](usage/requirejs.md)
+  * [seed](usage/seed.md)
+  * [function](usage/function.md)
+* Basics
+  * [bool](basics/bool.md)
+  * [falsy](basics/falsy.md)
+  * [character](basics/character.md)
+  * [floating](basics/floating.md)
+  * [integer](basics/integer.md)
+  * [letter](basics/letter.md)
+  * [natural](basics/natural.md)
+  * [prime](basics/prime.md)
+  * [string](basics/string.md)
+  * [template](basics/template.md)
+* Text
+  * [paragraph](text/paragraph.md)
+  * [sentence](text/sentence.md)
+  * [syllable](text/syllable.md)
+  * [word](text/word.md)
+* Person
+  * [age](person/age.md)
+  * [birthday](person/birthday.md)
+  * [cf](person/cf.md)
+  * [cpf](person/cpf.md)
+  * [first](person/first.md)
+  * [gender](person/gender.md)
+  * [last](person/last.md)
+  * [name](person/name.md)
+  * [prefix](person/prefix.md)
+  * [ssn](person/ssn.md)
+  * [suffix](person/suffix.md)
+* Thing
+  * [animal](thing/animal.md)
+* Mobile
+  * [android_id](mobile/android_id.md)
+  * [apple_token](mobile/apple_token.md)
+  * [bb_pin](mobile/bb_pin.md)
+  * [wp7_anid](mobile/wp7_anid.md)
+  * [wp8_anid2](mobile/wp8_anid2.md)
+* Web
+  * [avatar](web/avatar.md)
+  * [color](web/color.md)
+  * [company](web/company.md)
+  * [domain](web/domain.md)
+  * [email](web/email.md)
+  * [fbid](web/fbid.md)
+  * [google_analytics](web/google_analytics.md)
+  * [hashtag](web/hashtag.md)
+  * [ip](web/ip.md)
+  * [ipv6](web/ipv6.md)
+  * [klout](web/klout.md)
+  * [profession](web/profession.md)
+  * [tld](web/tld.md)
+  * [twitter](web/twitter.md)
+  * [url](web/url.md)
+* Location
+  * [address](location/address.md)
+  * [altitude](location/altitude.md)
+  * [areacode](location/areacode.md)
+  * [city](location/city.md)
+  * [coordinates](location/coordinates.md)
+  * [country](location/country.md)
+  * [depth](location/depth.md)
+  * [geohash](location/geohash.md)
+  * [latitude](location/latitude.md)
+  * [locale](location/locale.md)
+  * [longitude](location/longitude.md)
+  * [phone](location/phone.md)
+  * [postal](location/postal.md)
+  * [postcode](location/postcode.md)
+  * [province](location/province.md)
+  * [state](location/state.md)
+  * [street](location/street.md)
+  * [zip](location/zip.md)
+* Time
+  * [ampm](time/ampm.md)
+  * [date](time/date.md)
+  * [hammertime](time/hammertime.md)
+  * [hour](time/hour.md)
+  * [millisecond](time/millisecond.md)
+  * [minute](time/minute.md)
+  * [month](time/month.md)
+  * [second](time/second.md)
+  * [timestamp](time/timestamp.md)
+  * [timezone](time/timezone.md)
+  * [weekday](time/weekday.md)
+  * [year](time/year.md)
+* Finance
+  * [cc](finance/cc.md)
+  * [cc_type](finance/cc_type.md)
+  * [currency](finance/currency.md)
+  * [currency_pair](finance/currency_pair.md)
+  * [dollar](finance/dollar.md)
+  * [euro](finance/euro.md)
+  * [exp](finance/exp.md)
+  * [exp_month](finance/exp_month.md)
+  * [exp_year](finance/exp_year.md)
+* Helpers
+  * [capitalize](helpers/capitalize.md)
+  * [mixin](helpers/mixin.md)
+  * [pad](helpers/pad.md)
+  * [pick](helpers/pick.md)
+  * [pickone](helpers/pickone.md)
+  * [pickset](helpers/pickset.md)
+  * [set](helpers/set.md)
+  * [shuffle](helpers/shuffle.md)
+* Miscellaneous
+  * [coin](miscellaneous/coin.md)
+  * [dice](miscellaneous/dice.md)
+  * [guid](miscellaneous/guid.md)
+  * [hash](miscellaneous/hash.md)
+  * [hidden](miscellaneous/hidden.md)
+  * [n](miscellaneous/n.md)
+  * [normal](miscellaneous/normal.md)
+  * [radio](miscellaneous/radio.md)
+  * [rpg](miscellaneous/rpg.md)
+  * [tv](miscellaneous/tv.md)
+  * [unique](miscellaneous/unique.md)
+  * [weighted](miscellaneous/weighted.md)
+
+<script type="text/javascript" src="chance.js"></script>
@@ -0,0 +1,3 @@
+window.analytics=window.analytics||[],window.analytics.methods=["identify","group","track","page","pageview","alias","ready","on","once","off","trackLink","trackForm","trackClick","trackSubmit"],window.analytics.factory=function(t){return function(){var a=Array.prototype.slice.call(arguments);return a.unshift(t),window.analytics.push(a),window.analytics}};for(var i=0;i<window.analytics.methods.length;i++){var key=window.analytics.methods[i];window.analytics[key]=window.analytics.factory(key)}window.analytics.load=function(t){if(!document.getElementById("analytics-js")){var a=document.createElement("script");a.type="text/javascript",a.id="analytics-js",a.async=!0,a.src=("https:"===document.location.protocol?"https://":"http://")+"cdn.segment.io/analytics.js/v1/"+t+"/analytics.min.js";var n=document.getElementsByTagName("script")[0];n.parentNode.insertBefore(a,n)}},window.analytics.SNIPPET_VERSION="2.0.9",
+window.analytics.load("5u8961mhro");
+window.analytics.page();
@@ -0,0 +1,24 @@
+# bool
+
+```js
+    // usages
+    chance.bool()
+    chance.bool({ likelihood: 30 })
+```
+Return a random boolean value (`true` or `false`).
+
+```js
+chance.bool();
+=> true
+```
+
+The default likelihood of success (returning `true`) is 50%.
+Can optionally specify the likelihood in percent:
+
+```js
+chance.bool({likelihood: 30});
+=> false
+```
+
+In this case only a 30% likelihood of `true`, and a 70% likelihood of `false`.
+
@@ -0,0 +1,65 @@
+# character
+
+```js
+// usages
+chance.character()
+chance.character({ pool: 'abcde' })
+chance.character({ alpha: true })
+chance.character({ numeric: true })
+chance.character({ casing: 'lower' })
+chance.character({ symbols: true })
+```
+
+Return a random character.
+
+```js
+chance.character();
+=> 'v'
+```
+
+By default it will return a string with random character from the following
+pool.
+
+```js
+'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()'
+```
+
+Optionally specify a pool and the character will be generated with characters
+only from that pool.
+
+```js
+chance.character({ pool: 'abcde' });
+=> 'c'
+```
+
+Optionally specify alpha for an alphabetic character.
+
+```js
+chance.character({ alpha: true });
+=> 'N'
+```
+
+Optionally specify numeric for a numeric character.
+
+```js
+chance.character({ numeric: true });
+=> '8'
+```
+
+Default includes both upper and lower case. It's possible to specify one or the
+other.
+
+```js
+chance.character({ casing: 'lower' });
+=> 'j'
+```
+
+*Note, wanted to call this key just ```case``` but unfortunately that's a
+reserved word in JavaScript for use in a switch statement*
+
+Optionally return only symbols
+
+```js
+chance.character({ symbols: true });
+=> '%'
+```
@@ -0,0 +1,22 @@
+# falsy
+
+```js
+// usages
+chance.falsy()
+chance.falsy({ pool: [ NaN, undefined ] })
+```
+Return a random falsy value (`false`, `null`, `undefined`, `0`, `NaN`, `''`).
+
+```js
+chance.falsy();
+=> false
+```
+
+The default pool can be changed to better meet the needs:
+
+```js
+chance.falsy({ pool: [ NaN, undefined ] });
+=> NaN
+```
+
+
@@ -0,0 +1,44 @@
+# floating
+
+```js
+// usages
+chance.floating()
+chance.floating({ fixed: 7 })
+chance.floating({ min: 0, max: 100 })
+```
+<p class="pullquote">I wanted to use float or double as the method name but both are JS reserved words even though they aren't really used...</p>
+
+Return a random floating point number.
+
+```js
+chance.floating();
+=> -211920142886.5024
+```
+
+By default it will return a fixed number of at most 4 digits after the decimal.
+
+Note: *at most* 4 digits. This because, unless we returned trailing zeroes
+(which aren't allowed on the JavaScript float) we can't guarantee 4 digits after
+the decimal. So if random chance comes back with `82383854.2000` then
+`82383854.2` is what will be returned.
+
+To retrieve a set number of fixed digits after the decimal, provide it as an option.
+
+```js
+chance.floating({ fixed: 7 });
+=> -749512327.7447168
+```
+
+As with other number functions, can include a min and/or max.
+
+```js
+chance.floating({ min: 0, max: 100 });
+=> 31.9021
+```
+
+Or combine them.
+
+```js
+chance.floating({ min: 0, max: 100, fixed: 8 });
+=> 45.92367599
+```
@@ -0,0 +1,42 @@
+# integer
+
+```js
+// usage
+chance.integer()
+chance.integer({ min: -20, max: 20 })
+```
+
+<p class="pullquote">9007199254740991 is 2^53 - 1 and is the largest number value in JavaScript</p>
+
+Return a random integer.
+
+_range: -9007199254740991 to 9007199254740991_
+
+See: [Largest number in JavaScript](http://vq.io/16qnIYj)
+
+```js
+chance.integer();
+=> -1293235
+```
+
+Can optionally provide min and max.
+
+```js
+chance.integer({ min: -20, max: 20 })
+=> -7
+```
+
+
+These min and max are inclusive, so they are included in the range. This means
+```js
+chance.integer({ min: -2, max: 2 })
+``` 
+would return either -2, -1, 0, 1, or 2.
+
+```js
+// Specific case
+-2 <= random number <= 2
+
+// General case
+min <= random number <= max
+```
@@ -0,0 +1,25 @@
+# letter
+
+```js
+// usage
+chance.letter()
+chance.letter({ casing: 'lower' })
+```
+
+Return a random letter.
+
+```js
+chance.letter();
+=> 'p'
+```
+
+By default it will return a random lowercase letter.
+
+<p class="pullquote">Note, wanted to call this option just <strong>case</strong> instead of <strong>casing</strong> but unfortunately that's a reserved word in JavaScript for use in a switch statement</p>
+
+It's possible to specify upper case
+
+```js
+chance.letter({casing: 'upper'});
+=> 'A'
+```
@@ -0,0 +1,47 @@
+# natural
+
+```js
+// usage
+chance.natural()
+chance.natural({ min: 1, max: 20 })
+```
+
+Return a natural number.
+
+_range: 0 to 9007199254740991_
+
+```js
+  chance.natural();
+  => 125019392395
+```
+
+Can optionally provide min and max.
+
+```js
+chance.natural({min: 1, max: 20});
+=> 14
+```
+
+Can optionally provide numbers you wish to exclude.
+
+```js
+chance.natural({min: 1, max: 5, exclude: [1, 3]});
+=> 2
+```
+
+These are inclusive, so they are included in the range. This means
+```chance.natural({min: 1, max: 3});``` would return either 1, 2, or 3 or:
+
+```js
+// Specific case
+1 <= random number <= 3
+
+// General case
+min <= random number <= max
+```
+
+
+[Natural Number on Wikipedia][natural]
+
+[natural]: https://en.wikipedia.org/wiki/Natural_number
+
@@ -0,0 +1,41 @@
+# prime
+
+```js
+// usage
+chance.prime()
+chance.prime({ min: 1, max: 20 })
+```
+
+Return a prime number.
+
+_default range: 0 to 10000_
+
+```js
+  chance.prime();
+  => 929
+```
+
+Can optionally provide min and max.
+
+```js
+chance.prime({min: 1, max: 20});
+=> 13
+```
+
+
+These are inclusive, so they are included in the range. This means
+```chance.prime({min: 2, max: 5});``` would return either 2, 3, or 5 or:
+
+```js
+// Specific case
+2 <= random number <= 5
+
+// General case
+min <= random number <= max
+```
+
+
+[Prime Number on Wikipedia][prime]
+
+[prime]: https://en.wikipedia.org/wiki/Prime_number
+
@@ -0,0 +1,76 @@
+# string
+
+```js
+// usage
+chance.string()
+chance.string({ length: 5 })
+chance.string({ min: 5 })
+chance.string({ max: 50 })
+chance.string({ min: 5, max: 20 })
+chance.string({ pool: 'abcde' })
+chance.string({ alpha: true })
+chance.string({ casing: 'lower' })
+chance.string({ symbols: true })
+```
+
+Return a random string.
+
+```js
+  chance.string();
+  => 'Z&Q78&fqkPq'
+```
+
+By default it will return a string with random length of 5-20 characters and
+will contain any of the following characters.
+
+```js
+  'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()[]'
+```
+
+Can optionally specify a length and the string will be exactly that length.
+
+```js
+  chance.string({ length: 5 });
+  => 'YN%fG'
+```
+
+Can optionally specify a min and the string will have a minimum length
+
+```js
+  chance.string({ min: 5 });
+  => '6(Ow1wF)qjUm%W)B2[Q]'
+```
+
+Can optionally specify a max and the string will have a maximum length
+
+```js
+  chance.string({ max: 20 });
+  => 'k7fubkfMS@gs#E'
+```
+
+Can optionally specify a pool and the string will be generated with characters
+only from that pool.
+
+```js
+  chance.string({ pool: 'abcde' });
+  => 'cccdeeabedebb'
+```
+
+Of course these options can also be combined, using length or min and max.
+
+```js
+  chance.string({ length: 5, pool: 'abcde' });
+  => 'cbbdc'
+```
+
+```js
+  chance.string({ min: 5, max: 20, pool: 'abcde' });
+  => 'ebddceaaceeda'
+```
+
+All the options for [chance.character()](./character.md) are supported:
+
+```js
+  chance.string({ length: 8, casing: 'upper', alpha: true, numeric: true });
+  => '3THK7GB1'
+```
@@ -0,0 +1,27 @@
+# template
+
+Return a random string matching the given template.
+
+```js
+// usage
+chance.template('{AA####}')
+=> 'ZQ7803'
+chance.template('{Aa}-{##}')
+=> 'Vr-78'
+chance.template('{####}:{####}:{####}')
+=> '1628:5987:7803'
+```
+
+The template consists of any number of "character replacement" and "character
+literal" sequences. A "character replacement" sequence starts with a left
+brace, has any number of special replacement characters, and ends with a right
+brace. A character literal can be any character except a brace or a backslash.
+A literal brace or backslash character can be included in the output by
+escaping with a backslash.
+
+The following replacement characters can be used in a replacement sequence:
+
+   * "#": a random digit
+   * "a": a random lower case letter
+   * "A": a random upper case letter
+
@@ -0,0 +1,108 @@
+.markdown-body a {
+    color: #c0392b;
+}
+
+.menu {
+    background-color: #c0392b;
+}
+
+.-menu-visible .menu-toggle {
+    background-color: #c0392b;
+}
+
+.menu-toggle {
+    color: #fff;
+    background-color: #c0392b;
+}
+
+.toc-menu .link.-active, .toc-menu .hlink.-active {
+    box-shadow: inset -2px 0 #fff;
+}
+
+.toc-menu .-level-1.-parent > .title {
+    color: #fff;
+}
+
+.toc-menu .-level-1:first-child > .title {
+    color: #fff;
+}
+
+ul.heading-list .hlink, ul.heading-list .hlink:visited {
+    color: #fff;
+}
+
+.toc-menu .link, .toc-menu .link:visited {
+    color: #fff;
+}
+
+ul.heading-list .hlink::before {
+    background: #fff;
+}
+
+.footer-nav a {
+    color: #c0392b;
+}
+
+.footer-nav .label, .footer-nav .left .title {
+    color: #c0392b;
+}
+
+.header-nav.-expanded .icon {
+    color: #fff;
+}
+
+.pullquote {
+    display: block;
+    float: right;
+    padding: 0 0 0 10px;
+    margin: 0 0 10px 10px;
+    width: 15.0em;
+    font-size: 1.0em;
+    line-height: 1.4em;
+    color: #666;
+    border-left: 3px solid #ccc;
+}
+
+.markdown-body pre {
+    background-color: #fdf6e3;
+    border-radius: 12px;
+}
+
+.markdown-body pre code {
+    background-color: #fdf6e3;
+}
+
+a.download {
+  -webkit-user-select: none;
+  background: #fff;
+  background-image: -webkit-gradient(linear, left top, left bottom, from(rgba(0,0,32,0.01)), to(rgba(0,0,32,0.08)));
+  background-image: -moz-linear-gradient(rgba(0,0,32,0.01), rgba(0,0,32,0.08));
+  -webkit-border-radius: 6px;
+  -moz-border-radius: 6px;
+  border-radius: 6px;
+  color: #202028;
+  padding: 4px 10px;
+  border: 1px solid #a8a8af;
+  text-decoration: none !important;
+  text-shadow: 0 1px 1px rgba(255,255,255,0.9);
+  font-size: 14px;
+  line-height: 19px;
+  font-family: helvetica, arial, sans-serif;
+  display: inline-block;
+  cursor: pointer;
+  font-weight: bold;
+}
+
+a.download:hover {
+  color: #202028;
+  background-image: -webkit-gradient(linear, left top, left bottom, from(rgba(0,0,32,0.01)), to(rgba(0,0,32,0.16)));
+  background-image: -moz-linear-gradient(rgba(0,0,32,0.01), rgba(0,0,32,0.16));
+  border-color: #707078;
+}
+
+a.download:active {
+  background-color: rgba(0,0,32,0.05);
+  background-image: -webkit-gradient(linear, left top, left bottom, from(rgba(0,0,32,0.16)), to(rgba(0,0,32,0.01)));
+  background-image: -moz-linear-gradient(rgba(0,0,32,0.16), rgba(0,0,32,0.01));
+  box-shadow: inset 0 2px 2px rgba(0,0,0,0.1);
+}
@@ -0,0 +1,5 @@
+!function(){function a(b){if(!(this instanceof a))return null==b?new a:new a(b);if("function"==typeof b)return this.random=b,this;arguments.length&&(this.seed=0);for(var c=0;c<arguments.length;c++){var d=0;if("[object String]"===Object.prototype.toString.call(arguments[c]))for(var e=0;e<arguments[c].length;e++){for(var f=0,g=0;g<arguments[c].length;g++)f=arguments[c].charCodeAt(g)+(f<<6)+(f<<16)-f;d+=f}else d=arguments[c];this.seed+=(arguments.length-c)*d}return this.mt=this.mersenne_twister(this.seed),this.bimd5=this.blueimp_md5(),this.random=function(){return this.mt.random(this.seed)},this}function b(a,b){if(a||(a={}),b)for(var c in b)"undefined"==typeof a[c]&&(a[c]=b[c]);return a}function c(a,b){if(a)throw new RangeError(b)}function d(a){return function(){return this.natural(a)}}function e(a,b){for(var c,d=r(a),e=0,f=d.length;f>e;e++)c=d[e],b[c]=a[c]||b[c]}function f(a,b){for(var c=0,d=a.length;d>c;c++)b[c]=a[c]}function g(a,b){var c=Array.isArray(a),d=b||(c?new Array(a.length):{});return c?f(a,d):e(a,d),d}var h=9007199254740992,i=-h,j="0123456789",k="abcdefghijklmnopqrstuvwxyz",l=k.toUpperCase(),m=j+"abcdef",n=Array.prototype.slice;a.prototype.VERSION="1.0.4";var o=function(){throw new Error("No Base64 encoder available.")};!function(){"function"==typeof btoa?o=btoa:"function"==typeof Buffer&&(o=function(a){return new Buffer(a).toString("base64")})}(),a.prototype.bool=function(a){return a=b(a,{likelihood:50}),c(a.likelihood<0||a.likelihood>100,"Chance: Likelihood accepts values from 0 to 100."),100*this.random()<a.likelihood},a.prototype.character=function(a){a=b(a),c(a.alpha&&a.symbols,"Chance: Cannot specify both alpha and symbols.");var d,e,f="!@#$%^&*()[]";return d="lower"===a.casing?k:"upper"===a.casing?l:k+l,e=a.pool?a.pool:a.alpha?d:a.symbols?f:d+j+f,e.charAt(this.natural({max:e.length-1}))},a.prototype.floating=function(a){a=b(a,{fixed:4}),c(a.fixed&&a.precision,"Chance: Cannot specify both fixed and precision.");var d,e=Math.pow(10,a.fixed),f=h/e,g=-f;c(a.min&&a.fixed&&a.min<g,"Chance: Min specified is out of range with fixed. Min should be, at least, "+g),c(a.max&&a.fixed&&a.max>f,"Chance: Max specified is out of range with fixed. Max should be, at most, "+f),a=b(a,{min:g,max:f}),d=this.integer({min:a.min*e,max:a.max*e});var i=(d/e).toFixed(a.fixed);return parseFloat(i)},a.prototype.integer=function(a){return a=b(a,{min:i,max:h}),c(a.min>a.max,"Chance: Min cannot be greater than Max."),Math.floor(this.random()*(a.max-a.min+1)+a.min)},a.prototype.natural=function(a){return a=b(a,{min:0,max:h}),c(a.min<0,"Chance: Min cannot be less than zero."),this.integer(a)},a.prototype.string=function(a){a=b(a,{length:this.natural({min:5,max:20})}),c(a.length<0,"Chance: Length cannot be less than zero.");var d=a.length,e=this.n(this.character,d,a);return e.join("")},a.prototype.capitalize=function(a){return a.charAt(0).toUpperCase()+a.substr(1)},a.prototype.mixin=function(b){for(var c in b)a.prototype[c]=b[c];return this},a.prototype.unique=function(a,b,d){c("function"!=typeof a,"Chance: The first argument must be a function.");var e=function(a,b){return-1!==a.indexOf(b)};d&&(e=d.comparator||e);for(var f,g=[],h=0,i=50*b,j=n.call(arguments,2);g.length<b;){var k=JSON.parse(JSON.stringify(j));if(f=a.apply(this,k),e(g,f)||(g.push(f),h=0),++h>i)throw new RangeError("Chance: num is likely too large for sample set")}return g},a.prototype.n=function(a,b){c("function"!=typeof a,"Chance: The first argument must be a function."),"undefined"==typeof b&&(b=1);var d=b,e=[],f=n.call(arguments,2);for(d=Math.max(0,d),null;d--;null)e.push(a.apply(this,f));return e},a.prototype.pad=function(a,b,c){return c=c||"0",a+="",a.length>=b?a:new Array(b-a.length+1).join(c)+a},a.prototype.pick=function(a,b){if(0===a.length)throw new RangeError("Chance: Cannot pick() from an empty array");return b&&1!==b?this.shuffle(a).slice(0,b):a[this.natural({max:a.length-1})]},a.prototype.pickone=function(a){if(0===a.length)throw new RangeError("Chance: Cannot pickone() from an empty array");return a[this.natural({max:a.length-1})]},a.prototype.pickset=function(a,b){if(0===b)return[];if(0===a.length)throw new RangeError("Chance: Cannot pickset() from an empty array");if(0>b)throw new RangeError("Chance: count must be positive number");return b&&1!==b?this.shuffle(a).slice(0,b):[this.pickone(a)]},a.prototype.shuffle=function(a){for(var b=a.slice(0),c=[],d=0,e=Number(b.length),f=0;e>f;f++)d=this.natural({max:b.length-1}),c[f]=b[d],b.splice(d,1);return c},a.prototype.weighted=function(a,b,c){if(a.length!==b.length)throw new RangeError("Chance: length of array and weights must match");for(var d,e=0,f=0;f<b.length;++f)d=b[f],d>0&&(e+=d);if(0===e)throw new RangeError("Chance: no valid entries in array weights");var g,h=this.random()*e,i=0,j=-1;for(f=0;f<b.length;++f){if(d=b[f],i+=d,d>0){if(i>=h){g=f;break}j=f}f===b.length-1&&(g=j)}var k=a[g];return c="undefined"==typeof c?!1:c,c&&(a.splice(g,1),b.splice(g,1)),k},a.prototype.paragraph=function(a){a=b(a);Line truncated
+b+"."+c;if(d.extentions){if(Array.isArray(d.extentions))return c=this.pickone(d.extentions),b+"."+c;if(d.extentions.constructor===Object){var g=d.extentions,h=Object.keys(g);return c=this.pickone(g[this.pickone(h)]),b+"."+c}throw new Error("Expect collection of type Array or Object to be passed as an argument ")}if(d.fileType){var i=d.fileType;if(-1!==f.indexOf(i))return c=this.pickone(this.get(e)[i]),b+"."+c;throw new Error("Expect file type value to be 'raster', 'vector', '3d' or 'document' ")}return c=this.pickone(this.get(e)[this.pickone(f)]),b+"."+c};var p={firstNames:{male:{en:["James","John","Robert","Michael","William","David","Richard","Joseph","Charles","Thomas","Christopher","Daniel","Matthew","George","Donald","Anthony","Paul","Mark","Edward","Steven","Kenneth","Andrew","Brian","Joshua","Kevin","Ronald","Timothy","Jason","Jeffrey","Frank","Gary","Ryan","Nicholas","Eric","Stephen","Jacob","Larry","Jonathan","Scott","Raymond","Justin","Brandon","Gregory","Samuel","Benjamin","Patrick","Jack","Henry","Walter","Dennis","Jerry","Alexander","Peter","Tyler","Douglas","Harold","Aaron","Jose","Adam","Arthur","Zachary","Carl","Nathan","Albert","Kyle","Lawrence","Joe","Willie","Gerald","Roger","Keith","Jeremy","Terry","Harry","Ralph","Sean","Jesse","Roy","Louis","Billy","Austin","Bruce","Eugene","Christian","Bryan","Wayne","Russell","Howard","Fred","Ethan","Jordan","Philip","Alan","Juan","Randy","Vincent","Bobby","Dylan","Johnny","Phillip","Victor","Clarence","Ernest","Martin","Craig","Stanley","Shawn","Travis","Bradley","Leonard","Earl","Gabriel","Jimmy","Francis","Todd","Noah","Danny","Dale","Cody","Carlos","Allen","Frederick","Logan","Curtis","Alex","Joel","Luis","Norman","Marvin","Glenn","Tony","Nathaniel","Rodney","Melvin","Alfred","Steve","Cameron","Chad","Edwin","Caleb","Evan","Antonio","Lee","Herbert","Jeffery","Isaac","Derek","Ricky","Marcus","Theodore","Elijah","Luke","Jesus","Eddie","Troy","Mike","Dustin","Ray","Adrian","Bernard","Leroy","Angel","Randall","Wesley","Ian","Jared","Mason","Hunter","Calvin","Oscar","Clifford","Jay","Shane","Ronnie","Barry","Lucas","Corey","Manuel","Leo","Tommy","Warren","Jackson","Isaiah","Connor","Don","Dean","Jon","Julian","Miguel","Bill","Lloyd","Charlie","Mitchell","Leon","Jerome","Darrell","Jeremiah","Alvin","Brett","Seth","Floyd","Jim","Blake","Micheal","Gordon","Trevor","Lewis","Erik","Edgar","Vernon","Devin","Gavin","Jayden","Chris","Clyde","Tom","Derrick","Mario","Brent","Marc","Herman","Chase","Dominic","Ricardo","Franklin","Maurice","Max","Aiden","Owen","Lester","Gilbert","Elmer","Gene","Francisco","Glen","Cory","Garrett","Clayton","Sam","Jorge","Chester","Alejandro","Jeff","Harvey","Milton","Cole","Ivan","Andre","Duane","Landon"],it:["Adolfo","Alberto","Aldo","Alessandro","Alessio","Alfredo","Alvaro","Andrea","Angelo","Angiolo","Antonino","Antonio","Attilio","Benito","Bernardo","Bruno","Carlo","Cesare","Christian","Claudio","Corrado","Cosimo","Cristian","Cristiano","Daniele","Dario","David","Davide","Diego","Dino","Domenico","Duccio","Edoardo","Elia","Elio","Emanuele","Emiliano","Emilio","Enrico","Enzo","Ettore","Fabio","Fabrizio","Federico","Ferdinando","Fernando","Filippo","Francesco","Franco","Gabriele","Giacomo","Giampaolo","Giampiero","Giancarlo","Gianfranco","Gianluca","Gianmarco","Gianni","Gino","Giorgio","Giovanni","Giuliano","Giulio","Giuseppe","Graziano","Gregorio","Guido","Iacopo","Jacopo","Lapo","Leonardo","Lorenzo","Luca","Luciano","Luigi","Manuel","Marcello","Marco","Marino","Mario","Massimiliano","Massimo","Matteo","Mattia","Maurizio","Mauro","Michele","Mirko","Mohamed","Nello","Neri","Niccolò","Nicola","Osvaldo","Otello","Paolo","Pier Luigi","Piero","Pietro","Raffaele","Remo","Renato","Renzo","Riccardo","Roberto","Rolando","Romano","Salvatore","Samuele","Sandro","Sergio","Silvano","Simone","Stefano","Thomas","Tommaso","Ubaldo","Ugo","Umberto","Valerio","Valter","Vasco","Vincenzo","Vittorio"]},female:{en:["Mary","Emma","Elizabeth","Minnie","Margaret","Ida","Alice","Bertha","Sarah","Annie","Clara","Ella","Florence","Cora","Martha","Laura","Nellie","Grace","Carrie","Maude","Mabel","Bessie","Jennie","Gertrude","Julia","Hattie","Edith","Mattie","Rose","Catherine","Lillian","Ada","Lillie","Helen","Jessie","Louise","Ethel","Lula","Myrtle","Eva","Frances","Lena","Lucy","Edna","Maggie","Pearl","Daisy","Fannie","Josephine","Dora","Rosa","Katherine","Agnes","Marie","Nora","May","Mamie","Blanche","Stella","Ellen","Nancy","Effie","Sallie","Nettie","Della","Lizzie","Flora","Susie","Maud","Mae","Etta","Harriet","Sadie","Caroline","Katie","Lydia","Elsie","Kate","Susan","Mollie","Alma","Addie","Georgia","Eliza","Lulu","Nannie","Lottie","Amanda","Belle","Charlotte","Rebecca","Ruth","Viola","Olive","Amelia","Hannah","Jane","Virginia","Emily","Matilda","Irene","Kathryn","Esther","Willie","Henrietta","Ollie","Amy","Rachel","Sara","Estella","Theresa","Augusta","Ora","Pauline","Josie","Lola","Sophia","Leona","Anne","Mildred","Ann","Beulah","Callie","Lou","DeliLine truncated
+name:"Cheshire East"},{name:"Cheshire West and Chester"},{name:"Cornwall"},{name:"County Durham"},{name:"Cumbria"},{name:"Darlington"},{name:"Derby"},{name:"Derbyshire"},{name:"Devon"},{name:"Dorset"},{name:"East Riding of Yorkshire"},{name:"East Sussex"},{name:"Essex"},{name:"Gloucestershire"},{name:"Greater London"},{name:"Greater Manchester"},{name:"Halton"},{name:"Hampshire"},{name:"Hartlepool"},{name:"Herefordshire"},{name:"Hertfordshire"},{name:"Hull"},{name:"Isle of Wight"},{name:"Isles of Scilly"},{name:"Kent"},{name:"Lancashire"},{name:"Leicester"},{name:"Leicestershire"},{name:"Lincolnshire"},{name:"Luton"},{name:"Medway"},{name:"Merseyside"},{name:"Middlesbrough"},{name:"Milton Keynes"},{name:"Norfolk"},{name:"North East Lincolnshire"},{name:"North Lincolnshire"},{name:"North Somerset"},{name:"North Yorkshire"},{name:"Northamptonshire"},{name:"Northumberland"},{name:"Nottingham"},{name:"Nottinghamshire"},{name:"Oxfordshire"},{name:"Peterborough"},{name:"Plymouth"},{name:"Poole"},{name:"Portsmouth"},{name:"Reading"},{name:"Redcar and Cleveland"},{name:"Rutland"},{name:"Shropshire"},{name:"Slough"},{name:"Somerset"},{name:"South Gloucestershire"},{name:"South Yorkshire"},{name:"Southampton"},{name:"Southend-on-Sea"},{name:"Staffordshire"},{name:"Stockton-on-Tees"},{name:"Stoke-on-Trent"},{name:"Suffolk"},{name:"Surrey"},{name:"Swindon"},{name:"Telford and Wrekin"},{name:"Thurrock"},{name:"Torbay"},{name:"Tyne and Wear"},{name:"Warrington"},{name:"Warwickshire"},{name:"West Berkshire"},{name:"West Midlands"},{name:"West Sussex"},{name:"West Yorkshire"},{name:"Wiltshire"},{name:"Windsor and Maidenhead"},{name:"Wokingham"},{name:"Worcestershire"},{name:"York"}]},provinces:{ca:[{name:"Alberta",abbreviation:"AB"},{name:"British Columbia",abbreviation:"BC"},{name:"Manitoba",abbreviation:"MB"},{name:"New Brunswick",abbreviation:"NB"},{name:"Newfoundland and Labrador",abbreviation:"NL"},{name:"Nova Scotia",abbreviation:"NS"},{name:"Ontario",abbreviation:"ON"},{name:"Prince Edward Island",abbreviation:"PE"},{name:"Quebec",abbreviation:"QC"},{name:"Saskatchewan",abbreviation:"SK"},{name:"Northwest Territories",abbreviation:"NT"},{name:"Nunavut",abbreviation:"NU"},{name:"Yukon",abbreviation:"YT"}],it:[{name:"Agrigento",abbreviation:"AG",code:84},{name:"Alessandria",abbreviation:"AL",code:6},{name:"Ancona",abbreviation:"AN",code:42},{name:"Aosta",abbreviation:"AO",code:7},{name:"L'Aquila",abbreviation:"AQ",code:66},{name:"Arezzo",abbreviation:"AR",code:51},{name:"Ascoli-Piceno",abbreviation:"AP",code:44},{name:"Asti",abbreviation:"AT",code:5},{name:"Avellino",abbreviation:"AV",code:64},{name:"Bari",abbreviation:"BA",code:72},{name:"Barletta-Andria-Trani",abbreviation:"BT",code:72},{name:"Belluno",abbreviation:"BL",code:25},{name:"Benevento",abbreviation:"BN",code:62},{name:"Bergamo",abbreviation:"BG",code:16},{name:"Biella",abbreviation:"BI",code:96},{name:"Bologna",abbreviation:"BO",code:37},{name:"Bolzano",abbreviation:"BZ",code:21},{name:"Brescia",abbreviation:"BS",code:17},{name:"Brindisi",abbreviation:"BR",code:74},{name:"Cagliari",abbreviation:"CA",code:92},{name:"Caltanissetta",abbreviation:"CL",code:85},{name:"Campobasso",abbreviation:"CB",code:70},{name:"Carbonia Iglesias",abbreviation:"CI",code:70},{name:"Caserta",abbreviation:"CE",code:61},{name:"Catania",abbreviation:"CT",code:87},{name:"Catanzaro",abbreviation:"CZ",code:79},{name:"Chieti",abbreviation:"CH",code:69},{name:"Como",abbreviation:"CO",code:13},{name:"Cosenza",abbreviation:"CS",code:78},{name:"Cremona",abbreviation:"CR",code:19},{name:"Crotone",abbreviation:"KR",code:101},{name:"Cuneo",abbreviation:"CN",code:4},{name:"Enna",abbreviation:"EN",code:86},{name:"Fermo",abbreviation:"FM",code:86},{name:"Ferrara",abbreviation:"FE",code:38},{name:"Firenze",abbreviation:"FI",code:48},{name:"Foggia",abbreviation:"FG",code:71},{name:"Forli-Cesena",abbreviation:"FC",code:71},{name:"Frosinone",abbreviation:"FR",code:60},{name:"Genova",abbreviation:"GE",code:10},{name:"Gorizia",abbreviation:"GO",code:31},{name:"Grosseto",abbreviation:"GR",code:53},{name:"Imperia",abbreviation:"IM",code:8},{name:"Isernia",abbreviation:"IS",code:94},{name:"La-Spezia",abbreviation:"SP",code:66},{name:"Latina",abbreviation:"LT",code:59},{name:"Lecce",abbreviation:"LE",code:75},{name:"Lecco",abbreviation:"LC",code:97},{name:"Livorno",abbreviation:"LI",code:49},{name:"Lodi",abbreviation:"LO",code:98},{name:"Lucca",abbreviation:"LU",code:46},{name:"Macerata",abbreviation:"MC",code:43},{name:"Mantova",abbreviation:"MN",code:20},{name:"Massa-Carrara",abbreviation:"MS",code:45},{name:"Matera",abbreviation:"MT",code:77},{name:"Medio Campidano",abbreviation:"VS",code:77},{name:"Messina",abbreviation:"ME",code:83},{name:"Milano",abbreviation:"MI",code:15},{name:"Modena",abbreviation:"MO",code:36},{name:"Monza-Brianza",abbreviation:"MB",code:36},{name:"Napoli",abbreviation:"NA",code:63},{name:"Novara",abbreviation:"NO",code:3},{name:"Nuoro",abbreviation:"NU",code:91},{name:"OgliasLine truncated
+},{name:"Pacific SA Standard Time",abbr:"PSST",offset:-4,isdst:!1,text:"(UTC-04:00) Santiago",utc:["America/Santiago","Antarctica/Palmer"]},{name:"Newfoundland Standard Time",abbr:"NDT",offset:-2.5,isdst:!0,text:"(UTC-03:30) Newfoundland",utc:["America/St_Johns"]},{name:"E. South America Standard Time",abbr:"ESAST",offset:-3,isdst:!1,text:"(UTC-03:00) Brasilia",utc:["America/Sao_Paulo"]},{name:"Argentina Standard Time",abbr:"AST",offset:-3,isdst:!1,text:"(UTC-03:00) Buenos Aires",utc:["America/Argentina/La_Rioja","America/Argentina/Rio_Gallegos","America/Argentina/Salta","America/Argentina/San_Juan","America/Argentina/San_Luis","America/Argentina/Tucuman","America/Argentina/Ushuaia","America/Buenos_Aires","America/Catamarca","America/Cordoba","America/Jujuy","America/Mendoza"]},{name:"SA Eastern Standard Time",abbr:"SEST",offset:-3,isdst:!1,text:"(UTC-03:00) Cayenne, Fortaleza",utc:["America/Araguaina","America/Belem","America/Cayenne","America/Fortaleza","America/Maceio","America/Paramaribo","America/Recife","America/Santarem","Antarctica/Rothera","Atlantic/Stanley","Etc/GMT+3"]},{name:"Greenland Standard Time",abbr:"GDT",offset:-2,isdst:!0,text:"(UTC-03:00) Greenland",utc:["America/Godthab"]},{name:"Montevideo Standard Time",abbr:"MST",offset:-3,isdst:!1,text:"(UTC-03:00) Montevideo",utc:["America/Montevideo"]},{name:"Bahia Standard Time",abbr:"BST",offset:-3,isdst:!1,text:"(UTC-03:00) Salvador",utc:["America/Bahia"]},{name:"UTC-02",abbr:"U",offset:-2,isdst:!1,text:"(UTC-02:00) Coordinated Universal Time-02",utc:["America/Noronha","Atlantic/South_Georgia","Etc/GMT+2"]},{name:"Mid-Atlantic Standard Time",abbr:"MDT",offset:-1,isdst:!0,text:"(UTC-02:00) Mid-Atlantic - Old"},{name:"Azores Standard Time",abbr:"ADT",offset:0,isdst:!0,text:"(UTC-01:00) Azores",utc:["America/Scoresbysund","Atlantic/Azores"]},{name:"Cape Verde Standard Time",abbr:"CVST",offset:-1,isdst:!1,text:"(UTC-01:00) Cape Verde Is.",utc:["Atlantic/Cape_Verde","Etc/GMT+1"]},{name:"Morocco Standard Time",abbr:"MDT",offset:1,isdst:!0,text:"(UTC) Casablanca",utc:["Africa/Casablanca","Africa/El_Aaiun"]},{name:"UTC",abbr:"CUT",offset:0,isdst:!1,text:"(UTC) Coordinated Universal Time",utc:["America/Danmarkshavn","Etc/GMT"]},{name:"GMT Standard Time",abbr:"GDT",offset:1,isdst:!0,text:"(UTC) Dublin, Edinburgh, Lisbon, London",utc:["Atlantic/Canary","Atlantic/Faeroe","Atlantic/Madeira","Europe/Dublin","Europe/Guernsey","Europe/Isle_of_Man","Europe/Jersey","Europe/Lisbon","Europe/London"]},{name:"Greenwich Standard Time",abbr:"GST",offset:0,isdst:!1,text:"(UTC) Monrovia, Reykjavik",utc:["Africa/Abidjan","Africa/Accra","Africa/Bamako","Africa/Banjul","Africa/Bissau","Africa/Conakry","Africa/Dakar","Africa/Freetown","Africa/Lome","Africa/Monrovia","Africa/Nouakchott","Africa/Ouagadougou","Africa/Sao_Tome","Atlantic/Reykjavik","Atlantic/St_Helena"]},{name:"W. Europe Standard Time",abbr:"WEDT",offset:2,isdst:!0,text:"(UTC+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna",utc:["Arctic/Longyearbyen","Europe/Amsterdam","Europe/Andorra","Europe/Berlin","Europe/Busingen","Europe/Gibraltar","Europe/Luxembourg","Europe/Malta","Europe/Monaco","Europe/Oslo","Europe/Rome","Europe/San_Marino","Europe/Stockholm","Europe/Vaduz","Europe/Vatican","Europe/Vienna","Europe/Zurich"]},{name:"Central Europe Standard Time",abbr:"CEDT",offset:2,isdst:!0,text:"(UTC+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague",utc:["Europe/Belgrade","Europe/Bratislava","Europe/Budapest","Europe/Ljubljana","Europe/Podgorica","Europe/Prague","Europe/Tirane"]},{name:"Romance Standard Time",abbr:"RDT",offset:2,isdst:!0,text:"(UTC+01:00) Brussels, Copenhagen, Madrid, Paris",utc:["Africa/Ceuta","Europe/Brussels","Europe/Copenhagen","Europe/Madrid","Europe/Paris"]},{name:"Central European Standard Time",abbr:"CEDT",offset:2,isdst:!0,text:"(UTC+01:00) Sarajevo, Skopje, Warsaw, Zagreb",utc:["Europe/Sarajevo","Europe/Skopje","Europe/Warsaw","Europe/Zagreb"]},{name:"W. Central Africa Standard Time",abbr:"WCAST",offset:1,isdst:!1,text:"(UTC+01:00) West Central Africa",utc:["Africa/Algiers","Africa/Bangui","Africa/Brazzaville","Africa/Douala","Africa/Kinshasa","Africa/Lagos","Africa/Libreville","Africa/Luanda","Africa/Malabo","Africa/Ndjamena","Africa/Niamey","Africa/Porto-Novo","Africa/Tunis","Etc/GMT-1"]},{name:"Namibia Standard Time",abbr:"NST",offset:1,isdst:!1,text:"(UTC+01:00) Windhoek",utc:["Africa/Windhoek"]},{name:"GTB Standard Time",abbr:"GDT",offset:3,isdst:!0,text:"(UTC+02:00) Athens, Bucharest",utc:["Asia/Nicosia","Europe/Athens","Europe/Bucharest","Europe/Chisinau"]},{name:"Middle East Standard Time",abbr:"MEDT",offset:3,isdst:!0,text:"(UTC+02:00) Beirut",utc:["Asia/Beirut"]},{name:"Egypt Standard Time",abbr:"EST",offset:2,isdst:!1,text:"(UTC+02:00) Cairo",utc:["Africa/Cairo"]},{name:"Syria Standard Time",abbr:"SDT",offset:3,isdst:!0,text:"(UTC+02:00) Damascus",utc:["Asia/Damascus"]},{name:"E. Europe Standard Time",abbr:"EEDT",offset:3,isdst:!0,text:"(UTC+02:00) E. Europe"},{Line truncated
+//# sourceMappingURL=chance.min.js.map
@@ -0,0 +1 @@
+{"version":3,"file":"chance.min.js","sources":["../chance.js"],"names":["Chance","seed","this","random","arguments","length","i","seedling","Object","prototype","toString","call","j","hash","k","charCodeAt","mt","mersenne_twister","bimd5","blueimp_md5","initOptions","options","defaults","testRange","test","errorMessage","RangeError","diceFn","range","natural","_copyObject","source","target","key","keys","o_keys","l","_copyArray","copyObject","_target","isArray","Array","MAX_INT","MIN_INT","NUMBERS","CHARS_LOWER","CHARS_UPPER","toUpperCase","HEX_POOL","slice","VERSION","base64","Error","btoa","Buffer","input","bool","likelihood","character","alpha","symbols","letters","pool","casing","charAt","max","floating","fixed","precision","num","Math","pow","min","integer","num_fixed","toFixed","parseFloat","floor","string","text","n","join","capitalize","word","substr","mixin","obj","func_name","unique","fn","comparator","arr","val","indexOf","result","count","MAX_DUPLICATES","params","clonedParams","JSON","parse","stringify","apply","push","pad","number","width","pick","shuffle","pickone","pickset","old_array","new_array","Number","splice","weighted","weights","trim","sum","weightIndex","chosenIdx","selected","total","lastGoodIdx","chosen","paragraph","sentences","sentence_array","sentence","words","punctuation","word_array","syllable","chr","consonants","vowels","all","syllables","substring","age","ageRange","type","birthday","currentYear","Date","getFullYear","setFullYear","year","date","cpf","formatted","d1","d2","replace","cnpj","first","gender","nationality","get","toLowerCase","extraGenders","concat","last","israelId","x","y","thisDigit","parseInt","mrz","checkDigit","split","multipliers","runningTotal","forEach","idx","pos","generate","opts","issuer","passportNumber","dob","expiry","that","getMonth","getDate","name","middle","middle_initial","prefix","suffix","name_prefixes","prefixes","abbreviation","name_prefix","full","HIDN","idn_pool","idn_chrs","idn","ssn","ssnFour","dashes","ssn_pool","dash","name_suffixes","suffixes","name_suffix","nationalities","android_id","apple_token","wp8_anid2","wp7_anid","guid","bb_pin","avatar","url","URL_BASE","PROTOCOLS","http","https","FILE_TYPES","bmp","gif","jpg","png","FALLBACKS","404","mm","identicon","monsterid","wavatar","retro","blank","RATINGS","g","pg","r","protocol","email","fileExtension","size","fallback","rating","constructor","md5","color","gray","value","delimiter","rgb","hasAlpha","rgbValue","alphaChanal","colorValue","hex","start","end","withHash","simbol","expression","isGrayscale","format","grayscale","domain","tld","fbid","google_analytics","account","property","hashtag","ip","ipv6","ip_addr","klout","semver","include_prerelease","prerelease","rpg","tlds","twitter","domain_prefix","path","extensions","extension","port","address","street","altitude","areacode","parens","city","coordinates","latitude","longitude","countries","country","depth","geohash","geojson","phone","numPick","self","ukNum","parts","section","sections","area","mobile","match","exchange","subscriber","postal","pd","fsa","ldu","counties","county","provinces","province","state","states","us_states_and_dc","territories","armed_forces","short_suffix","street_suffix","street_suffixes","zip","plusfour","ampm","date_string","american","getTime","m","month","raw","daysInMonth","days","numeric","day","hour","twentyfour","minute","second","millisecond","hammertime","months","timestamp","weekday","weekday_only","weekdays","cc","to_generate","cc_type","luhn_calculate","cc_types","types","short_name","currency_types","currency","timezones","timezone","currency_pair","returnAsString","currencies","reduce","acc","item","code","dollar","cents","undefined","euro","toLocaleString","exp","exp_year","exp_month","future","month_int","curMonth","curYear","vat","it_vat","cf","name_generator","isLast","temp","return_value","map","c","date_generator","lettermonths","checkdigit_generator","range1","range2","evens","odds","digit","pl_pesel","controlNumber","pl_nip","pl_regon","d4","d6","d8","d10","d12","d20","d30","d100","thrown","bits","rolls","p","version","guid_pool","variant_pool","luhn_check","str","digits","reverse","file","fileName","fileExtention","fileOptions","poolCollectionKey","typeRange","extention","extentions","extentionObjectCollection","fileType","data","firstNames","male","en","it","female","lastNames","uk","ca","country_regions","us","colorNames","raster","vector","3d","document","abbr","offset","isdst","utc","o_hasOwnProperty","hasOwnProperty","mac_address","separator","networkVersion","mac_pool","mac","normal","mean","dev","normal_pool","s","u","v","norm","sqrt","log","performanceCounter","round","radio","side","fl","set","values","tv","MersenneTwister","BlueImpMD5","N","M","MATRIX_A","UPPER_MASK","LOWER_MASK","mti","init_genrand","init_by_array","init_key","key_length","genrand_int32","mag01","kk","genrand_int31","genrand_real1","genrand_real3","genrand_res53","a","b","safe_add","lsw","msw"Line truncated
@@ -0,0 +1,37 @@
+# cc
+
+```js
+// usage
+chance.cc()
+chance.cc({type: 'Mastercard'})
+```
+
+<p class="pullquote" data-pullquote='Somewhat obvious warning: Do not use this to hit live payment gateways...' markdown="1"></p>
+
+Generate a random credit card number. This card number will pass the
+[Luhn algorithm][Luhn] so it looks like a legit card.
+
+```js
+chance.cc();
+=> '6304038511073827'
+```
+
+Optionally specify a particular type of card to return:
+
+```js
+chance.cc({type: 'Mastercard'});
+=> '5171206237468496'
+```
+
+The type can be specified by the long name, or by the short name:
+
+```js
+chance.cc({type: 'mc'});
+=> '5103820202214116'
+```
+
+
+The [types][types] are enumerated below.
+
+[Luhn]: http://en.wikipedia.org/wiki/Luhn_algorithm
+[types]: #cc_type
@@ -0,0 +1,42 @@
+# cc_type
+
+```js
+// usage
+chance.cc_type()
+chance.cc_type({raw: true})
+```
+
+Return a random credit card type.
+
+```js
+chance.cc_type();
+=> 'Visa'
+```
+
+Default returns just the name. To return the entire object (consisting of name,
+short name, numeric prefix, and length), specify so with the raw flag.
+
+```js
+chance.cc_type({raw: true});
+=> {name: 'Discover Card', short_name: 'discover', prefix: '6011', length: 16}
+```
+
+The available types are (name - *short_name*):
+
+* American Express - *amex*
+* Bankcard - *bankcard*
+* China UnionPay - *chinaunion*
+* Diners Club Carte Blanche - *dccarte*
+* Diners Club enRoute - *dcenroute*
+* Diners Club International - *dcintl*
+* Diners Club United States & Canada - *dcusc*
+* Discover Card - *discover*
+* InstaPayment - *instapay*
+* JCB - *jcb*
+* Laser - *laser*
+* Maestro - *maestro*
+* Mastercard - *mc*
+* Solo - *solo*
+* Switch - *switch*
+* Visa - *visa*
+* Visa Electron - *electron*
@@ -0,0 +1,13 @@
+# currency
+
+```js
+// usage
+chance.currency()
+```
+
+Generate a random currency.
+
+```js
+chance.currency();
+=> { code: "TVD", name: "Tuvalu Dollar" }
+```
@@ -0,0 +1,13 @@
+# currency_pair
+
+```js
+// usage
+chance.currency_pair()
+```
+
+Generate a currency pair. Handy for simulating currency conversions. Guaranteed to return a unique pair (and not the same currency twice).
+
+```js
+chance.currency_pair();
+=> [{ code: "ALL", name: "Albania Lek" }, { code: "ZWD", name: "Zimbabwe Dollar" }]
+```
@@ -0,0 +1,30 @@
+# dollar
+
+```js
+// usage
+chance.dollar()
+chance.dollar({max: 250})
+```
+
+<p class="pullquote" data-pullquote="Dolla, dolla, bill ya'll" markdown="1"></p>
+
+Return a random dollar amount.
+
+```js
+chance.dollar();
+=> "$2560.27"
+
+chance.dollar();
+=> "$750.99"
+```
+
+By default returns dollar amount no larger than 10000. Optionally specify
+the max to make it larger (or smaller).
+
+```js
+chance.dollar({max: 20});
+=> "$15.23"
+
+chance.dollar({max: 10000000})
+=> "$5051205.49"
+```
@@ -0,0 +1,28 @@
+# euro
+
+```js
+// usage
+chance.euro()
+chance.euro({max: 250})
+```
+
+Return a random euro amount. Formatting depends on the current locale (samples are displayed with european formatting)
+
+```js
+chance.euro();
+=> "2.560,27€"
+
+chance.euro();
+=> "750.99€"
+```
+
+By default returns euro amount no larger than 10000. Optionally specify
+the max to make it larger (or smaller).
+
+```js
+chance.euro({max: 20});
+=> "15,23€"
+
+chance.euro({max: 10000000})
+=> "5.051.205,49€"
+```
@@ -0,0 +1,21 @@
+# exp
+
+```js
+// usage
+chance.exp()
+chance.exp({raw: true})
+```
+
+Generate a random credit card expiration.
+
+```js
+chance.exp();
+=> '10/2020'
+```
+
+Optionally specify that a raw object be returned rather than a string
+
+```js
+chance.exp({raw: true});
+=> {month: '11', year: '2017'}
+```
@@ -0,0 +1,28 @@
+# exp_month
+
+```js
+// usage
+chance.exp_month()
+chance.exp_month({future: true})
+```
+
+Generate a random credit card expiration month.
+
+```js
+chance.exp_month();
+=> '01'
+```
+
+Optionally specify that it must be a later month than the current month.
+
+```js
+chance.exp_month({future: true});
+=> '10'
+```
+
+So if called in June, this would return a random month from July - Dec. If
+called in October, would return November or December.
+
+This because many credit card sandboxes require an expiration date later
+than the current date so it's necessary when generating an expiration with the
+current year to generate a month later than the current month.
@@ -0,0 +1,15 @@
+# exp_year
+
+```js
+// usage
+chance.exp_year()
+```
+
+Generate a random credit card expiration year.
+
+```js
+chance.exp_year();
+=> '2018'
+```
+
+Returns a random year between today and 10 years in the future.
@@ -0,0 +1,13 @@
+# capitalize
+
+```js
+// usage
+chance.capitalize(string)
+```
+
+Capitalize the first letter of a word
+
+```js
+chance.capitalize('bread')
+=> 'Bread'
+```
@@ -0,0 +1,90 @@
+# mixin
+
+```js
+// usage
+chance.mixin(<Object>)
+```
+
+Mixins are a very powerful way to extend **Chance** to fit the needs of your
+specific application.
+
+First, if you are thinking of using a mixin for **Chance**, please consider first
+whether your use is something from which others may benefit. If so, please
+submit a [pull request][PR] rather than using a mixin!
+
+Spread the love and give everyone the benefit of your awesome generator :)
+
+Now, that said, there are bound to be times when you want to generate something
+random that is specific to your application but not widely applicable. Enter
+mixins!
+
+**Chance** mixins allow you to add one-off methods to **Chance** which you can
+use later.
+
+For example, let's say I have a user object which consists of first, last,
+and email.
+
+```js
+
+var user = {
+first: 'John',
+last: 'Smith',
+email: 'john@aol.com'
+};
+
+```
+
+Let's say I want to be able to randomly generate these user objects.
+
+This is not the type of thing which would be widely applicable as it's specific
+to my application so it's perfect for a mixin!
+
+To create a mixin, build an object whose keys are the names of the methods, and
+whose values are the functions to be called.
+
+Note: Within each function, you will have access to `chance` itself!
+
+For example, to create a `user` mixin:
+
+```js
+chance.mixin({
+'user': function() {
+return {
+first: chance.first(),
+last: chance.last(),
+email: chance.email()
+};
+}
+});
+
+// Then you can call your mixin
+chance.user();
+
+=> {first: 'Eli', last: 'Benson', email: 'gembibuj@dugesan.com'}
+```
+
+Mixins can even include other mixins!
+
+For example, to "extend" the user object:
+```js
+chance.mixin({
+'user': function () {
+return {
+first: chance.first(),
+last: chance.last(),
+email: chance.email()
+};
+},
+'social_user': function () {
+var user = chance.user();
+user.network = chance.pick(['facebook', 'twitter']);
+return user;
+}
+});
+```
+
+So we have a second mixin here, `social_user` which is using the `user` mixin
+and adding to it! Note, these mixins can be defined in any order on the object
+if both declared at once.
+
+[PR]: https://github.com/victorquinn/chancejs/pulls
@@ -0,0 +1,40 @@
+# pad
+
+```js
+// usage
+chance.pad(number, width)
+chance.pad(number, width, padder)
+```
+
+Pad a number with some string until it reaches a desired width.
+
+By default, `chance.pad()` will pad with zeroes. For example, to zero-pad
+numbers such that the outcome width is 5, do the following.
+
+```js
+chance.pad(45, 5)
+=> '00045'
+
+chance.pad(284, 5)
+=> '00284'
+
+chance.pad(82843, 5)
+=> '82843'
+```
+
+Notice how every item returned is a string with leading zeroes until the width
+is 5 for each one.
+
+Can optionally specify a character if the desire is to pad with something other
+than zero.
+
+```js
+chance.pad(81, 5, 'Z')
+=> 'ZZZ81'
+
+chance.pad(692, 5, 'Z')
+=> 'ZZ692'
+
+chance.pad(52859, 5)
+=> '52859'
+```
@@ -0,0 +1,9 @@
+# pick
+
+```js
+// usage
+chance.pick(array)
+chance.pick(array, count)
+```
+
+**`pick()` is now deprecated in favor of `pickone()` and `pickset()`**
@@ -0,0 +1,13 @@
+# pickone
+
+```js
+// usage
+chance.pickone(array)
+```
+
+Given an array, pick a random element and return it
+
+```js
+chance.pickone(['alpha', 'bravo', 'charlie', 'delta', 'echo']);
+=> 'delta'
+```
@@ -0,0 +1,20 @@
+# pickset
+
+```js
+// usage
+chance.pickset(array, quantity)
+```
+
+Given an array, pick some random elements and return them in a new array
+
+```js
+chance.pickset(['alpha', 'bravo', 'charlie', 'delta', 'echo'], 3);
+=> ['echo', 'alpha', 'bravo']
+```
+
+Optionally omit the quantity to retrieve a set with length 1
+
+```js
+chance.pickset(['alpha', 'bravo', 'charlie', 'delta', 'echo']);
+=> ['delta']
+```
@@ -0,0 +1,23 @@
+# set
+
+```js
+// usage
+chance.set(key, value)
+```
+
+Used for overriding the default data used by Chance.
+
+For example, if instead of the default set of last names (which were pulled from the U.S. census data and therefore obviously American biased), you could replace the data for the first names with something more suited to your task. For example, if you want instead to pick from last names of houses in *A Song of Ice and Fire*, you could do something like:
+
+```js
+chance.set('lastNames', ['Arryn', 'Baratheon', 'Bolton', 'Frey', 'Greyjoy', 'Lannister', 'Martell', 'Stark', 'Targaryen', 'Tully', 'Tyrell']);
+
+// then
+chance.last()
+=> 'Lannister'
+```
+
+This is very handy for internationalization.
+
+Available keys for datasets to override: `firstNames`, `lastNames`, `provinces`, `us_states_and_dc`, `territories`, `armed_forces`, `street_suffixes`, `months`, `cc_types`, `currency_types`
+
@@ -0,0 +1,13 @@
+# shuffle
+
+```js
+// usage
+chance.shuffle(array)
+```
+
+Given an array, scramble the order and return it.
+
+```js
+chance.shuffle(['alpha', 'bravo', 'charlie', 'delta', 'echo']);
+=> ['echo', 'delta', 'alpha', 'charlie', 'bravo']
+```
@@ -0,0 +1,56 @@
+# ![Chance](./logo.png)
+
+**Chance** is a minimalist generator of random <a href="#true-random">[1]</a>
+strings, numbers, etc. to help reduce some monotony particularly while writing
+automated tests or anywhere else you need anything random.
+
+**Chance** is open source software and is released under the developer and
+business-friendly [MIT License](http://en.wikipedia.org/wiki/MIT_License)
+
+**Chance** is loaded on this site so you can just open the console on your
+browser and play!
+
+![Chance Web Inspector](./inspector.png)
+
+<a class="twitter-share-button"
+    href="https://twitter.com/share"
+    data-size="large"
+    data-text="Chance - Utility library to generate random things for JavaScript"
+    data-hashtags="chancejs,javascript"
+    data-url="http://chancejs.com/"
+    data-count="horizontal"
+    data-via="victorquinn">
+    Tweet
+</a>
+
+<iframe src="https://ghbtns.com/github-btn.html?user=chancejs&repo=chancejs&type=star&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="170px" height="20px"></iframe>
+
+Written by [Victor Quinn](https://www.victorquinn.com)
+
+[![Chance on NPM](https://nodei.co/npm/chance.png?downloads=true)](https://nodei.co/npm/chance/)
+
+<ul class=downloads>
+    <li>
+      <a href="chance.js" class="download" download="chance.js">chance.js (for development)</a>
+      - <i>95KB uncompressed</i>
+    </li>
+    <li>
+      <a href="chance.min.js" class="download">chance.min.js (for production)</a>
+      – <i>55KB, 17KB when gzipped</i>
+    </li>
+  </ul>
+
+Or move on to the [Usage](usage/bower.md) section for many other ways to get and use Chance.
+
+## Acknowledgements & Thanks
+
+Thank you to [Sean McCullough](https://github.com/banksean) for your [Mersenne Twister gist](https://gist.github.com/banksean/300494) on which almost the entirety of this library is dependent. And to Takuji Nishimura and Makoto Matsumoto who wrote the original C version on which Sean's JavaScript gist is based.
+
+And of course a monster thank you to all of the [Contributors](https://github.com/chancejs/chancejs/graphs/contributors) to this project!
+
+<small>© 2013 [Victor Quinn](https://www.victorquinn.com)
+Chance and this documentation are released under the terms of the [MIT license](http://opensource.org/licenses/MIT).</small>
+
+<a id="true-random">[1]</a> Of course true mathematicians out there would say that this ought to be considered as only generating pseudo-random things, not true random. For that we'd need some external entropy, not depending on a Mersenne Twister, blah, blah, blah. However, for most practical uses of this library for which it was created and intended, such as generating random names and addresses for automated tests, our random is good enough. But it should probably NOT be used for any cryptographic applications requiring true-random. See [Wikipedia's article](http://vq.io/12hBd84) for more info.
+
+<a href="https://www.gosquared.com/analytics/?utm_campaign=badge"><img src="https://stats.gs/badge" alt="Analytics by GoSquared" /></a>
@@ -0,0 +1,21 @@
+# address
+
+```js
+// usage
+chance.address()
+chance.address({short_suffix: true})
+```
+
+Generate a random street address
+
+```js
+chance.address();
+=> '5447 Bazpe Lane'
+```
+
+Optionally mandate that it return a short suffix
+
+```js
+chance.address({short_suffix: true});
+=> '536 Baner Rd'
+```
@@ -0,0 +1,29 @@
+# altitude
+
+```js
+// usage
+chance.altitude()
+chance.altitude({ fixed: 7 })
+chance.altitude({ max: 1000 })
+```
+
+Generate a random altitude, in meters.
+
+```js
+chance.altitude()
+=> 1863.21417
+```
+
+By default, includes 5 digits of accuracy after the decimal. Can override with the `fixed` option.
+
+```js
+chance.altitude({ fixed: 7 })
+=> 6897.8978386
+```
+
+By default, max of 8848m (height of Mount Everest), but this can be overridden with the `max` option.
+
+```js
+chance.altitude({ max: 1000 })
+=> 890.20665
+```
@@ -0,0 +1,16 @@
+# areacode
+
+```js
+// usage
+chance.areacode()
+```
+
+Generate a random area code
+
+```js
+chance.areacode()
+=> '(526)'
+```
+
+*Note, this is a US area code, we have little support for internationalization
+at this time. Hope to fix that in the future!*
@@ -0,0 +1,13 @@
+# city
+
+```js
+// usage
+chance.city()
+```
+
+Generate a random city name
+
+```js
+chance.city();
+=> 'Cowotba'
+```
@@ -0,0 +1,34 @@
+# coordinates
+
+```js
+// usage
+chance.coordinates()
+chance.coordinates({fixed: 2})
+chance.coordinates({format: 'dms'})
+```
+
+Generate random coordinates, which are latitude and longitude, comma separated.
+
+```js
+chance.coordinates();
+=> "-29.52974, 24.52815"
+```
+
+By default includes 5 fixed digits after decimal, can specify otherwise.
+
+```js
+chance.coordinates({fixed: 2});
+=> "-49.16, 68.81"
+```
+
+By default cooridnates' format is dd, can specify otherwise.
+
+```js
+chance.coordinates({format: 'ddm'});
+=> "41°44.9592, 25°56.2622"
+```
+
+```js
+chance.coordinates({format: 'dms'});
+=> "56°2’9.8187”, 79°55’40.6812”"
+```
@@ -0,0 +1,23 @@
+# country
+
+```js
+// usage
+chance.country()
+chance.country({ full: true })
+```
+
+Return a random country.
+
+```js
+chance.country();
+=> 'LT'
+```
+
+By default, returns only the 2 letter ISO 3166-1 code for the country.
+
+Optionally specify that it ought to return a full country name.
+
+```js
+chance.country({ full: true });
+=> 'Venezuela'
+```
@@ -0,0 +1,29 @@
+# depth
+
+```js
+// usage
+chance.depth()
+chance.depth({ fixed: 2 })
+chance.depth({ min: -1000 })
+```
+
+Generate a random depth, in meters. Depths are always negative
+
+```js
+chance.depth()
+=> -2126.95039
+```
+
+By default, includes 5 digits of accuracy after the decimal. Can override with the `fixed` option.
+
+```js
+chance.depth({ fixed: 2 })
+=> -1542.11
+```
+
+By default, maximum (or minimum depending on your frame of reference) depth of -2550 (depth of the Mariana Trench), but this can be overridden with the `min` option.
+
+```js
+chance.depth({ min: -1000 })
+=> -718.41976
+```
@@ -0,0 +1,21 @@
+# geohash
+
+```js
+// usage
+chance.geohash()
+chance.geohash({ length: 5 })
+```
+
+Generate a random geohash. [More details on what a geohash is](http://en.wikipedia.org/wiki/Geohash).
+
+```js
+chance.geohash()
+=> 'h9xhn7y'
+```
+
+By default, includes 7 characters of accuracy. Can override with the `length` option.
+
+```js
+chance.geohash({ length: 5 })
+=> 'dr0kr'
+```
@@ -0,0 +1,43 @@
+# latitude
+
+```js
+// usage
+chance.latitude()
+chance.latitude({fixed: 7})
+chance.latitude({format: 'dms'})
+```
+
+Generate a random latitude.
+
+```js
+chance.latitude();
+=> 57.99514
+```
+
+_range: -90 to 90_
+
+By default includes 5 fixed digits after decimal, can specify otherwise.
+
+```js
+chance.latitude({fixed: 7});
+=> -29.6443133
+```
+
+By default includes entire range of allowed latitudes, can specify a min and/or max to bound it
+
+```js
+chance.latitude({min: 38.7, max: 38.9});
+=> 38.82358
+```
+
+By default latitudes' format is dd, can specify otherwise.
+
+```js
+chance.latitude({format: 'ddm'});
+=> "41°44.9592"
+```
+
+```js
+chance.latitude({format: 'dms'});
+=> "56°2’9.8187”"
+```
@@ -0,0 +1,25 @@
+# locale
+
+```js
+// usage
+chance.locale()
+chance.locale({region: true})
+```
+
+Generate a random ISO-639-1 language code
+
+```js
+chance.locale();
+=> 'ca'
+```
+
+Generate a random IETF region code
+
+```js
+chance.locale({region: true});
+=> 'es-EA'
+```
+
+
+_Note, the language codes comes from the [ISO-639-1 spec](http://www.loc.gov/standards/iso639-2/php/code_list.php)
+and the region codes come from [IETF standard](http://data.okfn.org/data/core/language-codes#resource-language-codes-full)_
@@ -0,0 +1,43 @@
+# longitude
+
+```js
+// usage
+chance.longitude()
+chance.longitude({fixed: 7})
+chance.longitude({format: 'dms'})
+```
+
+Generate a random longitude.
+
+```js
+chance.longitude();
+=> 149.41549
+```
+
+_range: -180 to 180_
+
+By default includes 5 fixed digits after decimal, can specify otherwise.
+
+```js
+chance.longitude({fixed: 7});
+=> 51.4549925
+```
+
+By default includes entire range of allowed longitudes, can specify a min and/or max to bound it
+
+```js
+chance.longitude({min: -78, max: -77});
+=> -77.22644
+```
+
+By default longitude' format is dd, can specify otherwise.
+
+```js
+chance.longitude({format: 'ddm'});
+=> "41°44.9592"
+```
+
+```js
+chance.longitude({format: 'dms'});
+=> "56°2’9.8187”"
+```
@@ -0,0 +1,41 @@
+# phone
+
+```js
+// usage
+chance.phone()
+chance.phone({ formatted: false })
+chance.phone({ country: "fr" })
+chance.phone({ country: "fr", mobile: true })
+```
+
+Generate a random phone
+
+```js
+chance.phone();
+=> '(494) 927-2152'
+```
+
+By default conforms to [NANP](http://en.wikipedia.org/wiki/North_American_Numbering_Plan) for a proper US phone number.
+
+Optionally disable formatting.
+
+```js
+chance.phone({ formatted: false });
+=> '2617613391'
+```
+
+Optionally specify a country.
+
+```js
+chance.phone({ country: 'fr' });
+=> '01 60 44 92 67'
+```
+
+Note, at current we only have support for `'us'`, `'uk'`, or `'fr'` for countries.
+
+For `uk` and `fr`, optionally specify a mobile phone.
+
+```js
+chance.phone({ country: 'uk', mobile: true });
+=> '07624 321221'
+```
@@ -0,0 +1,13 @@
+# postal
+
+```js
+// usage
+chance.postal()
+```
+
+Return a Canadian Postal code. Returned postal code is valid with respect to the Postal District (first character) and format only.
+
+```js
+chance.postal();
+=> 'R1S 3F4'
+```
@@ -0,0 +1,13 @@
+# postcode
+
+```js
+// usage
+chance.postcode()
+```
+
+Generate a random (U.K.) postcode. Returned postcode is valid with respect to the Postcode Area (first characters) and format only.
+
+```js
+chance.postcode();
+=> 'W6 9PF'
+```
@@ -0,0 +1,33 @@
+# province
+
+```js
+// usage
+chance.province()
+chance.province({full: true})
+chance.province({full: true})
+```
+
+Return a random province.
+
+```js
+chance.province();
+=> 'ON'
+```
+
+By default, returns only the 2 letter abbreviation for province.
+
+Optionally specify that it ought to return a full province name.
+
+```js
+chance.province({full: true});
+=> 'Nova Scotia'
+```
+
+Optionally specify the country from which it should return the province name.
+
+```js
+chance.province({country: 'it', full: true});
+=> 'Vicenza'
+```
+
+Note, currently support for country is limited to: `'ca', 'it'`.
@@ -0,0 +1,62 @@
+# state
+
+```js
+// usage
+chance.state()
+chance.state({ full: true })
+chance.state({ territories: true })
+chance.state({ armed_forces: true })
+chance.state({ us_states_and_dc: false })
+chance.state({ country: 'us' })
+```
+
+Return a random state.
+
+```js
+chance.state();
+=> 'AK'
+```
+
+By default, returns only the 2 letter abbreviation for state.
+
+Optionally specify that it ought to return a full state name.
+
+```js
+chance.state({ full: true });
+=> 'Florida'
+```
+
+Optionally add U.S. Territories ('American Samoa', 'Federated States of Micronesia', 'Guam', 'Marshall Islands', 'Northern Mariana Islands', 'Puerto Rico', 'Virgin Islands, U.S.') to the mix of randomly selected items:
+
+```js
+chance.state({ territories: true, full: true })
+=> 'Guam'
+```
+
+Optionally add Armed Forces to the list as well:
+
+```js
+chance.state({ armed_forces: true, full: true })
+=> 'Armed Forces Pacific'
+```
+
+For all U.S. states, territories, and armed forces, specify all of them:
+
+```js
+chance.state({ armed_forces: true, territories: true })
+=> 'NY'
+```
+
+For just territories or armed forces, specify that it ought not return U.S. states:
+
+```js
+chance.state({ territories: true, us_states_and_dc: false })
+=> 'PR'
+```
+
+Optionally specify a country (US specific options are ignored if country is specified and different from `'us'`):
+
+```js
+chance.state({ country: 'it', full: true })
+=> 'Toscana'
+```
@@ -0,0 +1,37 @@
+# street
+
+```js
+// usage
+chance.street()
+chance.street({country:it})
+```
+
+Generate a random street
+
+```js
+chance.street();
+=> 'Tesca Circle'
+```
+
+Optionally mandate that it returns a short suffix
+
+```js
+chance.street({short_suffix: true});
+=> 'Jiled St'
+```
+
+Optionally specify the number of syllables used to generate the street name
+
+```js
+chance.street({syllables: 8});
+=> 'Teniefitinusewjircor Junction'
+```
+
+Optionally specify a country to localize street prefixes
+
+```js
+chance.street({country: 'it'});
+=> 'Via Nefba'
+```
+
+Note, currently support for country is limited to: `'us', 'it'`.
@@ -0,0 +1,23 @@
+# zip
+
+```js
+// usage
+chance.zip()
+chance.zip({plusfour: true})
+```
+
+Generate a random (U.S.) zip code.
+
+```js
+chance.zip();
+=> '90210'
+```
+
+Can optionally specify that it ought to return a [Zip+4][zip+4]:
+
+```js
+chance.zip({plusfour: true});
+=> '01035-1838'
+```
+
+[zip+4]: http://vq.io/19rzsve
@@ -0,0 +1,16 @@
+# coin
+
+```js
+// usage
+chance.coin()
+```
+
+Flip a coin!
+
+```js
+chance.coin();
+=> 'heads'
+
+chance.coin();
+=> 'tails'
+```
@@ -0,0 +1,29 @@
+# dice
+
+```js
+// usage
+chance.d4()
+chance.d6()
+chance.d8()
+chance.d10()
+chance.d12()
+chance.d20()
+chance.d30()
+chance.d100()
+```
+
+<p class="pullquote" data-pullquote='"Any dungeon master worth his weight in geldings goes nowhere without his 20 sided die."' markdown="1"></p>
+
+Return a value equal to the roll of a die.
+
+```js
+chance.d20();
+=> 13
+
+chance.d6();
+=> 4
+```
+
+These are just wrappers around natural() but are convenient for use by games.
+
+They return values between 1 and the number after the `d`, so `chance.d4()` returns 1, 2, 3, or 4, just like a 4 sided die would.
@@ -0,0 +1,16 @@
+# guid
+
+```js
+// usage
+chance.guid()
+chance.guid({version: 5})
+```
+
+Return a random guid, version 5 by default.
+
+```js
+chance.guid();
+=> 'f0d8368d-85e2-54fb-73c4-2d60374295e3'
+chance.guid({version: 4});
+=> 'c71f58e3-34af-43c0-b405-2764d6947d21'
+```
@@ -0,0 +1,35 @@
+# hash
+
+```js
+// usage
+chance.hash()
+chance.hash({length: 25})
+chance.hash({casing: 'upper'})
+```
+
+Return a random hex hash
+
+```js
+chance.hash()
+=> 'e5162f27da96ed8e1ae51def1ba643b91d2581d8'
+```
+
+By default, the hash is lowercase and 40 hex characters long (same as a git
+commit hash).
+
+Optionally specify a length
+
+```js
+chance.hash({length: 15})
+=> 'c28f57cb599ada4'
+```
+
+Optionally specify casing to get a hash with only uppercase letters
+rather than the default lowercase
+
+```js
+chance.hash({casing: 'upper'})
+=> '3F2EB3FB85D88984C1EC4F46A3DBE740B5E0E56E'
+```
+
+
@@ -0,0 +1,59 @@
+# hidden
+
+```js
+// usage
+chance.cc_types()
+chance.mersenne_twister()
+chance.mersenne_twister(12345)
+chance.months()
+chance.name_prefixes()
+chance.provinces()
+chance.states()
+chance.street_suffix()
+chance.street_suffixes()
+```
+
+These aren't really hidden per se, but just utility methods intended to be used
+internally but exposed externally in case they're useful to anyone.
+
+```js
+
+// Return the list of cc types
+chance.cc_types()
+=> [{name: "American Express", short_name: 'amex', prefix: '34', length: 15}, ...]
+
+// Return a new Mersenne Twister
+chance.mersenne_twister()
+=> [object Object] // An instance of a Mersenne Twister
+
+// Optionally provide a seed for that twister
+chance.mersenne_twister(12345)
+=> [object Object] // An instance of a twister with seed 12345
+
+// Return our list of name prefixes
+chance.months();
+=> [{name: 'January', short_name 'Jan', numeric: '01'}, ...]
+
+// Return our list of name prefixes
+chance.name_prefixes();
+=> [{name: 'Doctor', abbreviation: 'Dr.'}, {name: 'Miss', abbreviation: 'Miss'}, ...]
+
+// Return the list of provinces
+chance.provinces();
+=> [{name: 'Alberta', abbreviation: 'AB'}, {name: 'British Columbia', abbreviation: 'BC'}, ...]
+
+// Return the list of states
+chance.states();
+=> [{name: 'Alabama', abbreviation: 'AL'}, {name: 'Alaska', abbreviation: 'AK'}, ...]
+
+// Return a random street suffix
+chance.street_suffix();
+=> {name: 'Street', abbreviation: 'St'}
+
+// Return the list of street suffixes
+chance.street_suffixes();
+=> [{name: 'Avenue', abbreviation: 'Ave'}, {name: 'Boulevard', abbreviation: 'Blvd'}, ...]
+
+```
+
+
@@ -0,0 +1,35 @@
+# n
+
+```js
+// usage
+chance.n(chance.email, 5)
+chance.n(chance.email, 5, { domain: "socialradar.com" })
+```
+
+Provide any function that generates random stuff (usually another **Chance** function) and a number and `n()` will generate an array of items with a length matching the length you specified.
+
+For example, to generate 5 email addresses:
+
+```js
+chance.n(chance.email, 5);
+=> [ 'nese@me.gov',
+'tukvogi@novew.co.uk',
+'worzi@jotok.edu',
+'wicumafom@lalu.edu',
+'hifebwo@abecusa.com' ]
+```
+
+Any options that would be sent to the random function can be added following the number.
+
+For example, `chance.email()` has options which can be specified, so you can generate 5 emails with a known domain as follows:
+
+```js
+chance.n(chance.email, 5, { domain: "socialradar.com" })
+=> [ 'nuvvu@socialradar.com',
+'icolul@socialradar.com',
+'rig@socialradar.com',
+'ca@socialradar.com',
+'uc@socialradar.com' ]
+```
+
+Note, these items are not guaranteed to be unique. If that is the intent, see [`chance.unique()`](http://chancejs.com/#unique)
@@ -0,0 +1,35 @@
+# normal
+
+```js
+// usage
+chance.normal()
+chance.normal({mean: 100})
+chance.normal({mean: 100, dev: 15})
+```
+
+Return a normally-distributed random variate.
+
+```js
+chance.normal()
+=> 0.4244767651300604
+```
+
+By default this starts with a mean of `0` and a standard deviation of `1` which
+is the standard normal distribution.
+
+Optionally specify a mean and/or deviation.
+
+```js
+// Notice, since no deviation was specified, using the default of `1`
+chance.normal({mean: 100})
+=> 99.68352269988522
+
+// For example, to get a random IQ (which by definition has a mean of 100
+// and a standard deviation of 15)
+chance.normal({mean: 100, dev: 15})
+=> 85.11040121833615
+```
+
+Used in combination with the above generators, this can be an extremely powerful
+way to get more realistic results as often "pure random" results fail to
+approximate the real world.
@@ -0,0 +1,27 @@
+# radio
+
+```js
+// usage
+chance.radio()
+```
+
+<p class="pullquote" data-pullquote='Broadcast call signs start with a W if east of the Mississippi River and K if west.' markdown="1"></p>
+
+Generate a random radio call sign.
+
+```js
+chance.radio();
+=> 'KCXW'
+```
+
+Optionally specify a side of the Mississippi River to limit stations to that side.
+
+See [K and W](http://en.wikipedia.org/wiki/Call_signs_in_North_America#K_and_W) for more details
+
+```js
+chance.radio({side: 'east'});
+=> 'WKOQ'
+
+chance.radio({side: 'east'});
+=> 'WNOW'
+```
@@ -0,0 +1,25 @@
+# rpg
+
+```js
+// usage
+chance.rpg('#d#')
+chance.rpg('#d#', {sum: true})
+```
+
+Given an input looking like #d#, where the first # is the number of dice to
+roll and the second # is the max of each die, returns an array of dice values.
+
+```js
+chance.rpg('3d10');
+=> [1, 6, 9]
+
+chance.rpg('5d6');
+=> [3, 1, 2, 5, 2]
+```
+
+Optionally specify a sum be returned rather than an array of dice.
+
+```js
+chance.rpg('3d10', {sum: true});
+=> 14
+```
@@ -0,0 +1,25 @@
+# tv
+
+```js
+// usage
+chance.tv()
+chance.tv({side: 'west'})
+```
+
+Generate a TV station call sign. This is an alias for `radio()` since they both
+follow the same rules.
+
+```js
+chance.radio();
+=> 'WXTY'
+```
+
+Optionally specify a side of the Mississippi River to limit stations to that side.
+
+```js
+chance.radio({side: 'west'});
+=> 'KCYL'
+
+chance.radio({side: 'west'});
+=> 'KQDV'
+```
@@ -0,0 +1,47 @@
+# unique
+
+```js
+// usage
+chance.unique(chance.state, 5)
+chance.unique(chance.state, 5, { comparator: func })
+```
+
+Provide any function that generates random stuff (usually another **Chance** function) and a number and `unique()` will generate a random array of unique (not repeating) items with a length matching the one you specified.
+
+```js
+chance.unique(chance.state, 5);
+=> ["SC", "WA", "CO", "TX", "ND"]
+```
+
+This is helpful when there are a limited number of options and you want a bunch but want to ensure each is different.
+
+Optionally specify the comparator used to determine whether a generated item is in the list of already generated items. By default the comparator just checks to see if the newly generated item is in the array of already generated items. This works for most simple cases (such as `chance.state()`) but will not work if the generated item is an object (because the `Array.prototype.indexOf()` method will not work on an object since 2 objects will not be strictly equal, `===`, unless they are references to the same object).
+
+```js
+chance.unique(chance.currency, 2, {
+comparator: function(arr, val) {
+return arr.reduce(function(acc, item) {
+return acc || (item.code === val.code);
+}, false);
+}
+});
+=> [{ code: "KYF", name: "Cayman Islands Dollar" }, { code: "CDF", name: "Congo/Kinshasa Franc" }]
+```
+
+You can also specify any arbitrary options in this third argument and they'll be passed along to the method you specify as the first.
+
+For example, let's say you want to retrieve 10 unique integers between 0 and 100. This is easily achievable by specifying `chance.integer` as hte function, 10 as the number to retrieve, and a min/max in the options.
+
+```js
+chance.unique(chance.integer, 10, {min: 0, max: 100});
+=> [78, 49, 7, 87, 59, 89, 84, 62, 60, 63]
+```
+
+Note, there could be cases where it is impossible to generate the unique number. For example, if you choose `chance.state` as shown above as the random function and want say, 55 uniques, **Chance** will throw a RangeError because it is impossible to generate 55 uniques because there are only 51 states in the available pool (50 states plus the District of Columbia).
+
+```js
+chance.unique(chance.state, 55);
+=> RangeError: Chance: num is likely too large for sample set
+```
+
+
@@ -0,0 +1,55 @@
+# weighted
+
+```js
+// usage
+chance.weighted(['a', 'b'], [100, 1])
+chance.weighted(['a', 'b', 'c', 'd'], [1, 2, 3, 4])
+```
+
+Provide an array of items, and another array of items specifying the relative weights and **Chance** will select one of those items, obeying the specified weight.
+
+For example, the following code:
+
+```js
+chance.weighted(['a', 'b'], [100, 1]);
+=> 'a'
+```
+
+Will generate `'a'` 100 times more often than `'b'` but still choose one or the other randomly.
+
+The weights are all relative, so if you have more than just two it will ensure that all items are generated relative to all of the weights.
+
+For example, the following code:
+
+```js
+chance.weighted(['a', 'b', 'c', 'd'], [1, 2, 3, 4]);
+=> 'c'
+```
+
+Will generate a letter from the array but will pick `'b'` twice as often as it picks `'a'` and will pick `'c'` three times as often as it picks `'a'` and will pick `'d'` four times as often as it will pick `'a'` and will pick `'d'` two times as often as it will pick `'b'`.
+
+The weights can be whole numbers as shown above or fractions.
+
+```js
+chance.weighted(['a', 'b', 'c', 'd'], [0.1, 0.2, 0.3, 0.4]);
+=> 'd'
+```
+
+There is no requirement that the weights sum to anything in particular, they are all compared relative to each other so all of the following are equivalent:
+
+```js
+chance.weighted(['a', 'b', 'c', 'd'], [1, 2, 3, 4]);
+chance.weighted(['a', 'b', 'c', 'd'], [0.1, 0.2, 0.3, 0.4]);
+chance.weighted(['a', 'b', 'c', 'd'], [100, 200, 300, 400]);
+chance.weighted(['a', 'b', 'c', 'd'], [17, 34, 51, 68]);
+chance.weighted(['a', 'b', 'c', 'd'], [0.17, 0.34, 0.51, 0.68]);
+```
+
+Recall JavaScript has first class functions so you could do something like the following:
+
+```js
+chance.weighted([chance.fbid, chance.twitter, chance.ip], [10, 5, 1])();
+=> 10000345166213
+```
+
+That will pick one of the **Chance** methods with the relative weights specified and then immediately invoke it, so it will return a random fbid twice as often as it will return a twitter handle (because 10/5 is 2) and an fbid 10 times more often than it will return a random ip address (because 10/1 is 10). It will return a random twitter handle 5 times more often than it will return an ip address (because 5/1 is 5).
@@ -0,0 +1,13 @@
+# android_id
+
+```js
+// usage
+chance.android_id()
+```
+
+Return a random GCM registration ID.
+
+```js
+chance.android_id()
+=> 'APA91HHQyPlWqV2Nu61LRs41eE4vrR4bHLKTs0-Dh5nDLopcWZotLw77NEoJyADNJiq6cwY0jMM02y8aacLs6fe2_ynweFjZJVVevKON-32826v-EFoayyThU3-42YEUY9pCScU_n73yRNSOlTk5W6iPtrDkQ3a6_BvOxRbSYi3E6QEY0ZuIQF0'
+```
@@ -0,0 +1,13 @@
+# apple_token
+
+```js
+// usage
+chance.apple_token()
+```
+
+Return a random Apple Push Token
+
+```js
+chance.apple_token()
+=> 'b50edac575bfba07dd019b28b2af7189a3ddda17c806ef14a9abbfd00533f67e'
+```
@@ -0,0 +1,13 @@
+# bb_pin
+
+```js
+// usage
+chance.bb_pin()
+```
+
+Return a random BlackBerry Device PIN
+
+```js
+chance.bb_pin()
+=> '985de771'
+```
@@ -0,0 +1,13 @@
+# wp7_anid
+
+```js
+// usage
+chance.wp7_anid()
+```
+
+Return a random Windows Phone 7 ANID
+
+```js
+chance.wp7_anid()
+=> 'A=3FC2491A0E0C5AB7824B2F60DCE4DB02&E=4e7&W=6'
+```
@@ -0,0 +1,13 @@
+# wp8_anid2
+
+```js
+// usage
+chance.wp8_anid2()
+```
+
+Return a random Windows Phone 8 ANID2
+
+```js
+chance.wp8_anid2()
+=> 'OGI5ODk0MmNkZGI2OGE3YzAwODE1Y2NiYTc4MzEzZjM='
+```
@@ -0,0 +1,33 @@
+# note
+
+```js
+// usage
+chance.note();
+chance.note({ notes: 'flatkey' });
+```
+
+Return a note. 🎵
+
+```js
+chance.note();
+=> 'B'
+
+chance.note();
+=> 'E♭'
+```
+
+Options
+flatKey - chromatic scale with flat notes (default)
+sharpKey - chromatic scale with sharp notes
+flats - just flat notes
+sharps - just sharp notes
+naturals - just natural notes
+all - naturals, sharps and flats
+
+```js
+chance.note({notes: 'flats' });
+=> 'A'
+
+chance.note({notes: 'sharps' });
+=> 'F♯'
+```
@@ -0,0 +1,24 @@
+# tempo
+
+```js
+// usage
+chance.tempo(); //default between 40 to 320
+chance.tempo({ min: 60, max: 120 });
+```
+
+Return a tempo. 🎵
+
+```js
+chance.tempo();
+=> 58
+
+chance.tempo();
+=> 281
+
+chance.tempo({ max: 80 });
+=> 45
+
+chance.tempo({ min: 120 });
+=> 172
+
+```
@@ -0,0 +1,31 @@
+# aadhar
+
+_Aadhar_ (English: Foundation) is a 12-digit unique identity number that can be obtained by residents of India, based on their biometric and demographic data.
+
+```js
+// usage
+chance.aadhar()
+chance.aadhar({ onlyLastFour: true }) // false by default
+chance.aadhar({ separatedByWhiteSpace: false }) // true by default
+```
+
+Generate a random aadhar.
+
+```js
+chance.aadhar();
+=> '8506 7820 9696'
+```
+
+Optionally provide option of getting only the last four
+
+```js
+chance.aadhar({ onlyLastFour: true });
+=> '1851'
+```
+
+Optionally specify dashes be removed
+
+```js
+chance.aadhar({ separatedByWhiteSpace: false });
+'873300307032'
+```
@@ -0,0 +1,25 @@
+# age
+
+```js
+// usage
+chance.age()
+chance.age({ type: 'child' })
+```
+
+Generate a random age
+
+```js
+chance.age();
+=> 45
+```
+
+Default range is between 1 and 120
+
+Optionally specify one of a handful of enumerated age types:
+
+```js
+chance.age({type: 'child'});
+=> 9
+```
+
+Allowed types are: `child`, `teen`, `adult`, `senior`
@@ -0,0 +1,55 @@
+# birthday
+
+```js
+// usage
+chance.birthday()
+chance.birthday({ string: true })
+chance.birthday({ type: 'child' })
+```
+
+Generate a random birthday
+
+```js
+chance.birthday();
+=> Fri Aug 16 1985 00:00:00 GMT-0400 (EDT)
+```
+
+By default, returns an actual JavaScript [Date][Date] object.
+
+Optionally specify it be returned as a string.
+
+```js
+chance.birthday({string: true});
+=> '4/1/1968'
+```
+
+By default returns in MM/DD/YYYY format. Can specify DD/MM/YYYY as follows:
+
+```js
+chance.birthday({string: true, american: false});
+=> '28/6/1993'
+```
+
+For more complex date formats, use the [Moment][Moment] library.
+
+Can also specify the type, same types as with [age](#age).
+
+```js
+chance.birthday({type: 'child'});
+=> Sat Sep 08 2001 00:00:00 GMT-0400 (EDT)
+```
+
+You can also compose with `chance.year` for interesting combinations. For example, let's say we want to get the birthdays of some renaissance artists (born between 1450 and 1500). We can generate a year and then get a birthday from that year:
+
+```js
+var year = chance.year({ min: 1450, max: 1500 });
+chance.birthday({ year: year });
+=> Wed Aug 27 1484 11:24:14 GMT-0400 (EDT)
+
+// Could be simplified down to one line
+chance.birthday({ year: chance.year({ min: 1450, max: 1500 }) });
+=> Fri Nov 26 1469 09:17:13 GMT-0500 (EST)
+```
+
+[Date]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date
+[Moment]: http://momentjs.com
@@ -0,0 +1,23 @@
+# cf
+
+```js
+// usage
+chance.cf()
+```
+Generate a random Italian social security number (Codice Fiscale).
+
+```js
+chance.cf();
+=> 'BRSMRT87S49A988X'
+```
+
+Optionally specify any or all components: first name, last name, gender, birth date, place of birth (using ISTAT geocodes for Italian cities).
+
+```js
+chance.cf({first: 'Sergio', last: 'Leone'});
+=> 'LNESRG93P28F067V'
+
+chance.cf({first: 'Sophia', last: 'Loren', gender: 'Female', birthday: new Date(1934,8,20), city: 'h501'});
+
+=> 'LRNSPH34P60H501G'
+```
@@ -0,0 +1,13 @@
+# cpf
+
+```js
+// usage
+chance.cpf()
+```
+
+Generate a random Brazilian tax id.
+
+```js
+chance.cpf();
+=> '607.116.899-62'
+```
@@ -0,0 +1,31 @@
+# first
+
+```js
+// usage
+chance.first()
+chance.first({ nationality: 'us' })
+```
+
+Generate a random first name
+
+```js
+Chance.first();
+=> 'Leila'
+```
+
+Optionally specify a gender to limit first names to that gender
+
+```js
+Chance.first({ gender: "female" });
+=> 'Emma'
+```
+
+Optionally specify a nationality to limit first names to those most common of that nationality
+
+```js
+Chance.first({ nationality: "it" });
+=> 'Alberto'
+```
+
+Note, currently support for nationality is limited to: `'us', 'it'`.
+
@@ -0,0 +1,21 @@
+# gender
+
+```js
+// usage
+chance.gender()
+```
+
+Generate a random gender
+
+```js
+  Chance.gender();
+  => 'Female'
+```
+
+Extra genders can be provided using the `extraGenders` key in the optional options argument:
+
+```js
+  Chance.gender({
+    extraGenders: ['Agender', 'Genderqueer', 'Trans', 'Pangender']
+  });
+```
@@ -0,0 +1,23 @@
+# last
+
+```js
+// usage
+chance.last()
+chance.last({ nationality: 'en' })
+```
+
+Generate a random last name
+
+```js
+Chance.last();
+=> 'Mago'
+```
+
+Optionally specify a nationality to limit first names to those most common of that nationality
+
+```js
+Chance.last({ nationality: 'it' });
+=> 'Giovannini'
+```
+
+Note, currently support for nationality is limited to: `'en', 'it', 'nl', 'uk', 'de', 'jp', 'es', 'fr'`.
@@ -0,0 +1,63 @@
+# name
+
+```js
+// usage
+chance.name()
+chance.name({ middle: true })
+chance.name({ middle_initial: true })
+chance.name({ prefix: true })
+chance.name({ nationality: 'en' })
+```
+
+Generate a random name
+
+```js
+  chance.name();
+  => 'Dafi Vatemi'
+```
+
+Optionally include the middle name
+
+```js
+  chance.name({ middle: true });
+  => 'Nelgatwu Powuku Heup'
+```
+
+
+Optionally include the middle initial
+
+```js
+  chance.name({ middle_initial: true });
+  => 'Ezme I Iza'
+```
+
+Optionally include the prefix
+
+```js
+  chance.name({ prefix: true });
+  => 'Doctor Suosat Am'
+```
+
+Optionally include the suffix
+
+```js
+  chance.name({ suffix: true });
+  => 'Fanny Baker Esq.'
+```
+
+Optionally specify a gender
+
+```js
+  chance.name({ gender: 'male' });
+  => "Patrick Copeland"
+```
+
+Optionally specify a nationality
+
+```js
+  chance.name({ nationality: 'it' });
+  => "Roberta Mazzetti"
+```
+
+Note, currently support for nationality is limited to: `'en', 'it'`.
+
@@ -0,0 +1,35 @@
+# prefix
+
+```js
+// usage
+chance.prefix()
+chance.prefix({ full: true })
+```
+
+Generate a random name prefix
+
+```js
+chance.prefix();
+=> 'Mrs.'
+```
+
+By default, returns the shorter version.
+
+Optionally get back the full version.
+
+```js
+chance.prefix({ full: true });
+=> 'Mister'
+```
+
+Optionally specify a gender. Valid options are `male`, `female`, or `all` (the default).
+
+```js
+chance.prefix({ gender: "male" });
+=> 'Mr.'
+
+chance.prefix({ gender: "female" });
+=> 'Miss'
+```
+
+*To maintain legacy support, this also responds to chance.name_prefix().*
@@ -0,0 +1,29 @@
+# ssn
+
+```js
+// usage
+chance.ssn()
+chance.ssn({ ssnFour: true })
+chance.ssn({ dashes: false })
+```
+
+Generate a random social security number.
+
+```js
+chance.ssn();
+=> '411-90-0070'
+```
+
+Optionally provide option of getting only the last four
+
+```js
+chance.ssn({ ssnFour: true });
+=> '2938'
+```
+
+Optionally specify dashes be removed
+
+```js
+chance.ssn({ dashes: false });
+=> '293839295'
+```
@@ -0,0 +1,25 @@
+# suffix
+
+```js
+// usage
+chance.suffix()
+chance.suffix({ full: true })
+```
+
+Generate a random name suffix
+
+```js
+chance.suffix();
+=> 'Sr.'
+```
+
+By default, returns the shorter version.
+
+Optionally get back the full version.
+
+```js
+chance.suffix({ full: true });
+=> 'Juris Doctor'
+```
+
+*To maintain legacy support, this also responds to chance.name_suffix().*
@@ -0,0 +1,39 @@
+# paragraph
+
+```js
+// usage
+chance.paragraph()
+chance.paragraph({ sentences: 1 })
+chance.paragraph({ linebreak: true })
+```
+
+Return a random paragraph generated from sentences populated by semi-pronounceable
+random (nonsense) words.
+
+```js
+  chance.paragraph();
+  => 'Lel fi huepe jupu akse zej ire vesik kojvulom zon is biwuwkef pa. Uv hokivej voh ebu numdogi akolo hik uwlez ta vacev ofdaimi acunetum suvet uhdab ir soglazo ju pafbeb. Pub cezeh fuc kebamnul he ok luumoabi rawkig me fov pin zup biv risugra. Ralpunad apkomgib alnirciw akel wa lus wahfum burog buol vecotihe abadahoj ugolo wovki ucojal fec.'
+```
+
+Default is a paragraph with a random number of sentences from 3 to 7.
+
+Optionally specify the number of sentences in the paragraph.
+
+```js
+  chance.paragraph({ sentences: 1 });
+  => 'Idefeulo foc omoemowa wahteze liv juvde puguprof epehuji upuga zige odfe igo sit pilamhul oto ukurecef.'
+```
+
+Optionally specify if each sentence in the paragraph should start a new line.
+
+```js
+  chance.paragraph({ linebreak: true });
+  => `
+      Moku kazkubib adi apo bebiw movarne rab tusa vura nok ji iv otukib dewut.
+      Tiwlo orojel vuhhet emluliv loha ma rulical fokuv re dob fabup bit.
+      Veza ermethit osgues dohjeci pezlal su ibi cib zerezci bode ca hopmub gigwosut culhoca nubu.
+     `
+```
+
+
+
@@ -0,0 +1,28 @@
+# sentence
+
+```js
+// usage
+chance.sentence()
+chance.sentence({ words: 5 })
+```
+
+Return a random sentence populated by semi-pronounceable random (nonsense) words.
+
+```js
+  chance.sentence();
+  => 'Witpevze mappos isoletu fo res bi geow pofin mu rupoho revzi utva ne.'
+```
+
+The sentence starts with a capital letter, and ends with a period.
+
+Default is a sentence with a random number of words from 12 to 18.
+
+*This length is chosen as the default as it works out to the average English
+sentence is in that range.*
+
+Optionally specify the number of words in the sentence.
+
+```js
+  chance.sentence({ words: 5 });
+  => 'Waddik jeasmov cakgilta ficub up.'
+```
@@ -0,0 +1,18 @@
+# syllable
+
+```js
+// usage
+chance.syllable()
+```
+
+Return a semi-speakable syllable, 2 or 3 letters
+
+```js
+chance.syllable();
+=> 'fop'
+```
+
+The syllable is returned in all lower case.
+
+A syllable generally alternates between vowel and consonant and is used as the
+core building block for a word.
@@ -0,0 +1,54 @@
+# word
+
+```js
+// usage
+chance.word()
+chance.word({ syllables: 3 })
+chance.word({ length: 5 })
+```
+
+Return a semi-pronounceable random (nonsense) word.
+
+```js
+  chance.word();
+  => 'bappada'
+```
+
+The word is returned in all lower case.
+
+Default is a word with a random number of syllables from 1 to 3.
+
+<p class="pullquote">This length is chosen as it works out to the average word length of ~5-6 chars
+which seems about right.</p>
+
+Can optionally specify a number of syllables which the word will have.
+
+Note these are not syllables in the strict language definition of the word, but
+syllables as we've defined here which is 2 or 3 characters, mostly alternating
+between vowel and consanant. This is the about the best we can do with purely
+random generation.
+
+```js
+  chance.word({ syllables: 3 });
+  => 'tavnamgi'
+```
+
+Can optionally specify a length and the word will obey that bounding.
+
+```js
+  chance.word({ length: 5 });
+  => 'ralve'
+```
+
+In this case these 2 options are mutually exclusive, that is they cannot be
+combined as they often make no sense. It wouldn't be possible to have a word
+with 7 syllables and a length of 5 or a length of 30 but 2 syllables.
+
+Therefore, if both are specified, an Exception will be thrown so the Developer
+can handle their broken case.
+
+```js
+  chance.word({ length: 5, syllables: 20 });
+  => new RangeError("Chance: Cannot specify both syllables AND length.");
+```
+
@@ -0,0 +1,25 @@
+# animal
+
+```js
+// usage
+chance.animal()
+chance.animal({type: 'zoo'})
+```
+
+Generate a random animal
+
+```js
+chance.animal();
+=> 'Cobra'
+```
+
+Default is any type of animal.
+
+Optionally specify a specific type of animal
+
+```js
+chance.animal({type: 'zoo'});
+=> 'Lion'
+```
+
+Allowed types are: `ocean`, `desert`, `grassland`, `forest`, `farm`, `pet`, and `zoo`
@@ -0,0 +1,13 @@
+# ampm
+
+```js
+// usage
+chance.ampm()
+```
+
+Return am or pm. Very simple.
+
+```js
+chance.ampm();
+=> 'am'
+```
@@ -0,0 +1,67 @@
+# date
+
+```js
+// usage
+chance.date()
+chance.date({string: true})
+chance.date({string: true, american: false})
+chance.date({year: 1983})
+```
+
+Generate a random date
+
+```js
+chance.date();
+=> Sat Apr 09 2072 00:00:00 GMT-0400 (EDT)
+```
+
+By default, returns an actual [Date][Date] object
+
+Can optionally specify that a date be returned as a string
+
+```js
+chance.date({string: true});
+=> "5/27/2078"
+```
+
+This will return a date string of the format MM/DD/YYYY.
+
+Now of course MM/DD/YYYY is the "American" date method, but it's the default
+because there isn't much support for internationalization here yet. Further,
+it's the format used by [Facebook][FB] and other services for birthdays and
+other non-Date object dates.
+
+However, we support returning dates in DD/MM/YYYY format as well when requesting
+a date by a string and passing `american: false`.
+
+```js
+chance.date({string: true, american: false});
+=> "13/2/2017"
+```
+
+If you want richer control over date format, strongly suggest using the
+[Moment][Moment] library. Our formatting is very minimalist, and it's out of our
+core competency to offer dates in a myriad of formats.
+
+Can optionally specify defaults for any of day, month, or year.
+
+```js
+chance.date({year: 1983});
+=> Wed May 04 1983 00:00:00 GMT-0400 (EDT)
+
+chance.date({month: 0});
+=> Tue Jan 18 2084 00:00:00 GMT-0500 (EST)
+
+chance.date({day: 21});
+=> Sun Oct 21 2103 00:00:00 GMT-0400 (EDT)
+```
+
+A random date is generated, but the default you specify is kept constant.
+
+Note, month is 0-indexed. This is a carryover from the core JavaScript
+[Date][Date] object which we use internally to generate the date. We
+considered
+
+[Date]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date
+[FB]: https://developers.facebook.com/docs/reference/api/user/
+[Moment]: http://momentjs.com
@@ -0,0 +1,25 @@
+# hammertime
+
+```js
+// usage
+chance.hammertime()
+```
+
+<p class="pullquote" data-pullquote='Stop. Hammertime.' markdown="1"></p>
+
+Generate a random hammertime.
+
+```js
+chance.hammertime();
+=> 2273327300317
+```
+
+Hammertime is the name given to a [Unix time](http://en.wikipedia.org/wiki/Unix_time) with
+milliseconds. Which is the same as saying the number of milliseconds since 1970. It has
+finer granularity than a normal Unix timestamp and thus is often used in realtime
+applications.
+
+According to startup lore, Hammertime was coined by a startup whose founder had an
+interesting interaction with M.C. Hammer. There was no name given to "Unix time with
+milliseconds" and while brainstorming ideas (because Unix time with milliseconds is
+a confusing mouthful), someone suggested Hammertime and it stuck.
@@ -0,0 +1,27 @@
+# hour
+
+```js
+// usage
+chance.hour()
+chance.hour({twentyfour: true})
+```
+
+Generate a random hour
+
+```js
+chance.hour();
+=> 9
+```
+
+By default, returns an hour from 1 to 12 for a standard [12-hour clock][12h].
+
+Can optionally specify a full twenty-four.
+
+```js
+chance.hour({twentyfour: true});
+=> 21
+```
+
+This will return an hour from 1 to 24.
+
+[12h]: https://en.wikipedia.org/wiki/12-hour_clock
@@ -0,0 +1,15 @@
+# millisecond
+
+```js
+// usage
+chance.millisecond()
+```
+
+Generate a random millisecond
+
+```js
+chance.millisecond();
+=> 729
+```
+
+By default, returns a millisecond from 0 to 999. Idea is for generating a clock time.
@@ -0,0 +1,15 @@
+# minute
+
+```js
+// usage
+chance.minute()
+```
+
+Generate a random minute
+
+```js
+chance.minute();
+=> 35
+```
+
+By default, returns a minute from 0 to 59. Idea is for generating a clock time.
@@ -0,0 +1,23 @@
+# month
+
+```js
+// usage
+chance.month()
+```
+
+Generate a random month.
+
+```js
+chance.month();
+=> 'January'
+```
+
+By default, returns just the full name.
+
+Optionally specify raw to get the whole month object consisting of name,
+short_name, and numeric.
+
+```js
+chance.month({raw: true});
+=> {name: 'October', short_name: 'Oct', numeric: '10'}
+```
@@ -0,0 +1,15 @@
+# second
+
+```js
+// usage
+chance.second()
+```
+
+Generate a random second
+
+```js
+chance.second();
+=> 19
+```
+
+By default, returns a second from 0 to 59. Idea is for generating a clock time.
@@ -0,0 +1,14 @@
+# timestamp
+
+```js
+// usage
+chance.timestamp()
+```
+
+Generate a random timestamp. This is a standard Unix time, so a random number of
+seconds since January 1, 1970.
+
+```js
+chance.timestamp();
+=> 576556683
+```
				`@@ -0,0 +1 @@`
				{"version":3,"file":"chance.min.js","sources":["../chance.js"],"names":["Chance","seed","this","random","arguments","length","i","seedling","Object","prototype","toString","call","j","hash","k","charCodeAt","mt","mersenne_twister","bimd5","blueimp_md5","initOptions","options","defaults","testRange","test","errorMessage","RangeError","diceFn","range","natural","_copyObject","source","target","key","keys","o_keys","l","_copyArray","copyObject","_target","isArray","Array","MAX_INT","MIN_INT","NUMBERS","CHARS_LOWER","CHARS_UPPER","toUpperCase","HEX_POOL","slice","VERSION","base64","Error","btoa","Buffer","input","bool","likelihood","character","alpha","symbols","letters","pool","casing","charAt","max","floating","fixed","precision","num","Math","pow","min","integer","num_fixed","toFixed","parseFloat","floor","string","text","n","join","capitalize","word","substr","mixin","obj","func_name","unique","fn","comparator","arr","val","indexOf","result","count","MAX_DUPLICATES","params","clonedParams","JSON","parse","stringify","apply","push","pad","number","width","pick","shuffle","pickone","pickset","old_array","new_array","Number","splice","weighted","weights","trim","sum","weightIndex","chosenIdx","selected","total","lastGoodIdx","chosen","paragraph","sentences","sentence_array","sentence","words","punctuation","word_array","syllable","chr","consonants","vowels","all","syllables","substring","age","ageRange","type","birthday","currentYear","Date","getFullYear","setFullYear","year","date","cpf","formatted","d1","d2","replace","cnpj","first","gender","nationality","get","toLowerCase","extraGenders","concat","last","israelId","x","y","thisDigit","parseInt","mrz","checkDigit","split","multipliers","runningTotal","forEach","idx","pos","generate","opts","issuer","passportNumber","dob","expiry","that","getMonth","getDate","name","middle","middle_initial","prefix","suffix","name_prefixes","prefixes","abbreviation","name_prefix","full","HIDN","idn_pool","idn_chrs","idn","ssn","ssnFour","dashes","ssn_pool","dash","name_suffixes","suffixes","name_suffix","nationalities","android_id","apple_token","wp8_anid2","wp7_anid","guid","bb_pin","avatar","url","URL_BASE","PROTOCOLS","http","https","FILE_TYPES","bmp","gif","jpg","png","FALLBACKS","404","mm","identicon","monsterid","wavatar","retro","blank","RATINGS","g","pg","r","protocol","email","fileExtension","size","fallback","rating","constructor","md5","color","gray","value","delimiter","rgb","hasAlpha","rgbValue","alphaChanal","colorValue","hex","start","end","withHash","simbol","expression","isGrayscale","format","grayscale","domain","tld","fbid","google_analytics","account","property","hashtag","ip","ipv6","ip_addr","klout","semver","include_prerelease","prerelease","rpg","tlds","twitter","domain_prefix","path","extensions","extension","port","address","street","altitude","areacode","parens","city","coordinates","latitude","longitude","countries","country","depth","geohash","geojson","phone","numPick","self","ukNum","parts","section","sections","area","mobile","match","exchange","subscriber","postal","pd","fsa","ldu","counties","county","provinces","province","state","states","us_states_and_dc","territories","armed_forces","short_suffix","street_suffix","street_suffixes","zip","plusfour","ampm","date_string","american","getTime","m","month","raw","daysInMonth","days","numeric","day","hour","twentyfour","minute","second","millisecond","hammertime","months","timestamp","weekday","weekday_only","weekdays","cc","to_generate","cc_type","luhn_calculate","cc_types","types","short_name","currency_types","currency","timezones","timezone","currency_pair","returnAsString","currencies","reduce","acc","item","code","dollar","cents","undefined","euro","toLocaleString","exp","exp_year","exp_month","future","month_int","curMonth","curYear","vat","it_vat","cf","name_generator","isLast","temp","return_value","map","c","date_generator","lettermonths","checkdigit_generator","range1","range2","evens","odds","digit","pl_pesel","controlNumber","pl_nip","pl_regon","d4","d6","d8","d10","d12","d20","d30","d100","thrown","bits","rolls","p","version","guid_pool","variant_pool","luhn_check","str","digits","reverse","file","fileName","fileExtention","fileOptions","poolCollectionKey","typeRange","extention","extentions","extentionObjectCollection","fileType","data","firstNames","male","en","it","female","lastNames","uk","ca","country_regions","us","colorNames","raster","vector","3d","document","abbr","offset","isdst","utc","o_hasOwnProperty","hasOwnProperty","mac_address","separator","networkVersion","mac_pool","mac","normal","mean","dev","normal_pool","s","u","v","norm","sqrt","log","performanceCounter","round","radio","side","fl","set","values","tv","MersenneTwister","BlueImpMD5","N","M","MATRIX_A","UPPER_MASK","LOWER_MASK","mti","init_genrand","init_by_array","init_key","key_length","genrand_int32","mag01","kk","genrand_int31","genrand_real1","genrand_real3","genrand_res53","a","b","safe_add","lsw","msw"Line truncated