Add docs and spec

Author: Alex Gabriel

docs/index.md

@@ -195,18 +195,18 @@ ranges: Object
 Default:
 ```javascript
 {
-  'Last 30 days': [moment().subtract(29, 'days'), moment()]
-  'Last 90 days': [moment().subtract(89, 'days'), moment()]
-  'Last Year': [moment().subtract(1, 'year').add(1,'day'), moment()]
-  'All Time': 'all-time' // [minDate, maxDate]
+  'Last 30 days': [moment().subtract(29, 'days'), moment()],
+  'Last 90 days': [moment().subtract(89, 'days'), moment()],
+  'Last Year': [moment().subtract(1, 'year').add(1,'day'), moment()],
+  'All Time': 'all-time' // [minDate, maxDate],
   'Custom Range': 'custom'
 }
 ```
 
 Examples:
 ```javascript
 ranges: {
-  'Last 245 Days': [moment().subtract(244, 'days'), moment()]
+  'Last 245 Days': [moment().subtract(244, 'days'), moment()],
   'Last 3 Years': [moment().subtract(3, 'years').add(1, 'day'), moment()]
 }
 ```
@@ -235,6 +235,22 @@ Array of available _periods_. Period selector disappears if only one period spec
 periods: String[]
 ```
 
+### customPeriodRanges
+
+Similar to ranges except they are appended to the period row across the top of the picker.
+
+```javascript
+ranges: Object
+```
+
+Examples:
+```javascript
+customPeriodRanges: {
+  'Last Year': [moment().subtract(1, 'year').add(1,'day'), moment()],
+  'All Time': 'all-time' // [minDate, maxDate]
+}
+```
+
 ### single
 ```javascript
 single: Boolean

test/config.coffee

@@ -104,6 +104,23 @@ describe 'Config', ->
         })
       , /Missing end date/)
 
+  describe 'customPeriodRanges', ->
+    it 'works with a valid object', () ->
+      new Config({
+        customPeriodRanges: {
+          "Test Range": ['2015-05-14', moment()]
+        }
+      })
+
+    it 'fails with a object value that is not an array', () ->
+      assert.throw( ->
+        new Config({
+          ranges: {
+            'Test Range': '2015-05-14'
+          }
+        })
+      , /Value should be an array/)
+
   describe '_dateObservable', ->
     describe '#fit()', ->
       describe 'minDate = 2015-05-14, period = month', ->