[added] default context

README.md

@@ -412,6 +412,11 @@ Returns the DOM nodes for a component instance, if it exists.
 
 Compiles a selector into a function that matches a node
 
+##### `$.defaultContext(context: ?object) => (node) => bool`
+
+You can globally set a context object to be used for each and all renders,
+shallow or otherwise. This is helpful for context that is available to all
+levels of the application, like the `router`, i18n context, or a Redux Store.
 
 ##### `$.fn.length`
 

src/defaults.js

@@ -0,0 +1,5 @@
+
+
+export default {
+  context: null
+};

src/element.js

@@ -8,6 +8,7 @@ import {
 } from './utils';
 
 import { createNode } from 'bill/node';
+import defaults from './defaults';
 import invariant from 'invariant';
 
 let createCallback = (collection, fn) => ()=> fn.call(collection, collection)
@@ -64,7 +65,12 @@ Object.assign($.fn, {
     if (intoDocument)
       document.body.appendChild(mount)
 
-    let { instance, wrapper } = render(element, mount, { context })
+    if (defaults.context && context)
+      context = { ...defaults.context, ...context }
+
+    let { instance, wrapper } = render(element, mount, {
+      context: context || defaults.context
+    })
 
     let collection = iQuery(instance);
 
@@ -87,7 +93,10 @@ Object.assign($.fn, {
 
     let renderer = ReactTestUtils.createRenderer()
 
-    renderer.render(element, context);
+    if (defaults.context && context)
+      context = { ...defaults.context, ...context }
+
+    renderer.render(element, context || defaults.context);
 
     let collection = $(getShallowTreeWithRoot(renderer));
 

src/index.js

@@ -2,9 +2,11 @@ import ElementCollection from './element'
 import InstanceCollection from './instance'
 import commonPrototype from './common';
 import warning from 'warning';
+import invariant from 'invariant';
 import { compile,  selector, registerPseudo } from 'bill';
 import { createNode, NODE_TYPES } from 'bill/node';
 import { qsa, matches } from './utils';
+import defaults from './defaults';
 
 import * as utils from './utils';
 
@@ -72,4 +74,15 @@ $.createPseudo('textContent', text => node => {
   return (!text && !!textContent) || text === textContent
 })
 
+$.defaultContext = (obj) => {
+  invariant(typeof obj === 'object',
+    '[teaspoon]: Default context must be an object or null.'
+  );
+
+  if (!obj || Object.keys(obj) === 0)
+    obj = null;
+
+  defaults.context = obj
+};
+
 module.exports = $

src/utils.js

@@ -50,9 +50,8 @@ export function render(element, mount, { props, context }, renderFn) {
     element = node.element;
   }
 
-  if (props) {
+  if (props)
     element = React.cloneElement(element, props);
-  }
 
   if (context) {
     wrapper = element = wrapElement(element, context, prevWrapper)

test/common.js

@@ -36,6 +36,10 @@ describe('common', ()=> {
     }
   })
 
+  afterEach(() => {
+    $.defaultContext(null);
+  })
+
   it('should create collection', ()=>{
     $(<div/>).length.should.equal(1)
     $(<div/>)[0].type.should.equal('div')
@@ -364,6 +368,18 @@ describe('common', ()=> {
             .should.throw('the method `context()` found no matching elements')
         })
 
+        it('should use default context', ()=> {
+          let context = { question: ', who dis?'};
+
+          $.defaultContext(context);
+
+          render(<Example />)
+            .context('question').should.equal(context.question)
+
+          render(<Example />)
+            .context().should.eql(context)
+        })
+
         it('should not reuse nodes on rerenders', ()=> {
           let Component = (props) => (
             <div>

test/dom.js

@@ -35,7 +35,7 @@ describe('DOM rendering specific', ()=> {
     }
   }
 
-  it.only('should wrap existing mounted component', ()=> {
+  it('should wrap existing mounted component', ()=> {
     class Div extends React.Component {
       render(){ return <div {...this.props} /> }
     }