[IMP] hooks: add onWillPatch and onPatched

This commit also changes the behaviour of willPatch and patched: they no
longer transfer data from one to the other, because it can be done
cleanly by hooks and a closure.

closes #307

doc/component.md

@@ -329,9 +329,6 @@ before an actual DOM patch, and is only intended to be used to save some local
 DOM state. Also, it will not be called if the component is not in the DOM (this can
 happen with components with `t-keepalive`).
 
-The return value of this method will be given as the first argument of the
-corresponding `patched` call.
-
 #### `patched(snapshot)`
 
 This hook is called whenever a component did actually update its DOM (most
@@ -342,8 +339,6 @@ with the DOM (for example, through an external library) whenever the
 component was patched. Note that this hook will not be called if the compoent is
 not in the DOM (this can happen with components with `t-keepalive`).
 
-The `snapshot` parameter is the result of the previous `willPatch` call.
-
 Updating the compoent state in this hook is possible, but not encouraged.
 One need to be careful, because updates here will cause rerender, which in
 turn will cause other calls to patched. So, we need to be particularly
@@ -1219,7 +1214,7 @@ class Node extends Component {
             </t>
         </g>
     `;
-    static components = { Node };
+  static components = { Node };
 }
 
 class RootNode extends Component {
@@ -1230,12 +1225,12 @@ class RootNode extends Component {
     `;
   static components = { Node };
   graph = {
-      label: "a",
-      children: [
-          {label: "b"},
-          {label: "c", children: [{label: "d"}, {label: "e"}]},
-          {label: "f", children: [{label: "g"}]},
-      ]
+    label: "a",
+    children: [
+      { label: "b" },
+      { label: "c", children: [{ label: "d" }, { label: "e" }] },
+      { label: "f", children: [{ label: "g" }] }
+    ]
   };
 }
 ```
@@ -1247,4 +1242,4 @@ here: the `Node` component uses itself as a subcomponent.
 Note that since SVG needs to be handled in a specific way (its namespace needs
 to be properly set), there is a small constraint for Owl components: if an owl
 component is supposed to be a part of an svg graph, then its root node needs to
-be a `g` tag, so Owl can properly set the namespace.
+be a `g` tag, so Owl can properly set the namespace.