From d3e1a9d98822897513a8613cd24103fc793d1e65 Mon Sep 17 00:00:00 2001
From: zzmp <zmp@umich.edu>
Date: Wed, 17 Sep 2014 17:06:53 -0700
Subject: [PATCH 1/3] documented m.deps

---
 docs/layout/api.html |  1 +
 docs/mithril.deps.md | 61 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 62 insertions(+)
 create mode 100644 docs/mithril.deps.md

diff --git a/docs/layout/api.html b/docs/layout/api.html
index 20d3dda1..2cb1c1fa 100644
--- a/docs/layout/api.html
+++ b/docs/layout/api.html
@@ -36,6 +36,7 @@
 										<li><a href="mithril.redraw.html#strategy">m.redraw.strategy(strategy)</a></li>
 									</ul>
 								</li>
+								<li><a href="mithril.deps.html">m.deps</a></li>
 							</ul>
 							<h3 id="routing">Routing</h3>
 							<ul>
diff --git a/docs/mithril.deps.md b/docs/mithril.deps.md
new file mode 100644
index 00000000..109b73ba
--- /dev/null
+++ b/docs/mithril.deps.md
@@ -0,0 +1,61 @@
+## m.deps
+
+---
+
+[Usage](#usage)
+[Signature](#signature)
+
+---
+
+This is a testing method to set the `window` object in an environment that does not have it (such as the server).
+It will normally _not_ be used in an application, as `window` is already available to Mithril.
+For normal (client-side) use of mithril, this method will not be used.
+
+It is used in Mithril's testing suite, and can be used to supply a mock `window` for browserless testing.
+
+---
+
+### Usage
+
+Call it at the beginning of your test file to supply a mock `window`:
+
+```javascript
+function testMithril(mockWindow) {
+	window = m.deps(mockWindow);
+
+	// Your tests here...
+}
+```
+
+---
+
+### Signature
+
+[How to read signatures](how-to-read-signatures.md)
+
+```clike
+Window m.deps(Object window)
+
+where:
+	Window :: Object<any>
+```
+
+-	**Object Window**
+
+	This should be a mock of the `window` object.
+
+	Mithril uses certain `window` methods that will need to be made available for complete test coverage, depending on your application:
+
+	- `window.document`
+	 - Mithril also uses certain methods on the DOM node object
+	- `window.requestAnimationFrame`/`window.cancelAnimationFrame`
+	 - Falls back to `window.setTimeout`/`window.clearTimeout`
+	- `window.location`
+	- `window.history`
+	- `window.scrollTo`
+	- `window.XMLHttpRequest`
+
+-	**returns** Window
+
+	The returned window is the same as that passed in.
+

From ab92e0e05f387ae2208e5a3e9b8800f5f0ff0578 Mon Sep 17 00:00:00 2001
From: zzmp <zmp@umich.edu>
Date: Wed, 17 Sep 2014 17:07:39 -0700
Subject: [PATCH 2/3] added typescript definition of m.deps

---
 mithril.d.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/mithril.d.ts b/mithril.d.ts
index 9f61b49e..ece7944a 100644
--- a/mithril.d.ts
+++ b/mithril.d.ts
@@ -20,6 +20,7 @@ interface MithrilStatic {
 	sync(promises: MithrilPromise[]): MithrilPromise;
 	startComputation(): void;
 	endComputation(): void;
+	deps(window: any): any;
 }
 
 interface MithrilVirtualElement {

From b94f7c220688bd3fb12739e7f1455bf44d5dbce2 Mon Sep 17 00:00:00 2001
From: zzmp <zmp@umich.edu>
Date: Wed, 17 Sep 2014 17:12:03 -0700
Subject: [PATCH 3/3] add mithril.deps to Gruntfile

---
 Gruntfile.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Gruntfile.js b/Gruntfile.js
index 5578d29b..3779622b 100644
--- a/Gruntfile.js
+++ b/Gruntfile.js
@@ -37,6 +37,7 @@ module.exports = function(grunt) {
 		"mithril.prop",
 		"mithril.redraw",
 		"mithril.render",
+		"mithril.deps",
 		"mithril.request",
 		"mithril.route",
 		"mithril.sync",