added license

Author: brucou

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Andre Medeiros, Tylor Steinberger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

notes/slots.md

@@ -0,0 +1,43 @@
+mergeDOMbySlots (parentDomSink, childrenDomSinks, settings) {
+  // @type {Array<String>} slots
+  const {slots} = settings;
+  
+  // deal with null sinks etc.
+  $.combineLatest(flatten(parentDomSink, childrenDomSinks))
+    .map(vNodeTreeArray => {
+      // reorder according to slots (use ramda sort)
+      return sortBy (vTree => getSlotIndex(getSlot(vTree), slots), vTreeArray)
+    })
+    .map(div) // unless only one
+}
+
+
+put the slots in the settings of the child component
+
+# Example
+```
+m({}, {}, [
+  Navigation({slots : ['', 'navigation-section']}, [Header, [
+    SomeContent,
+    InSlot({slot : ''navigation-section'}, [NavigationSection()],
+    InSlot({slot : ''navigation-section'}, [NavigationSection()],
+    OtherContent
+  ]])
+])
+```
+
+# InSlot
+`InSlot` set the `vNode.data.slot` property to `settings.slot`
+`InSlot` should not pass its settings!, at least not its slot settings
+
+# getSlot :: vTree -> String
+`return vNodeTree.data.slot`
+or someting like that, must return undefined is no slot set up
+
+# getSlotIndex :: String -> Slots -> Number
+- `Slots :: Array<String>`
+
+function getSlotIndex(slotToFind, slots){
+  return findIndex(equals(slotToFind || undefined), slots)
+}
+

src/TODO.js

@@ -22,3 +22,5 @@
 // TODO DOC: update doc (types componentTree) for Switch, Route, ForEach, List
 // TODO : tabbed component? + demo?
 // TODO : remove most runTestScenario, see how to publish it separately (...monorepo...)
+// TODO : for all components, decide if I pass the settings of the combinator downstream!!
+// - for instance, sinkNames is good to pass downstream, but slot would not be