ig-types 6.21.0 → 6.22.0

package/Promise.js

@@ -801,6 +801,22 @@ object.Mixin('PromiseMixin', 'soft', {
 	iter: IterablePromise,
 	interactive: InteractivePromise,
 	cooperative: CooperativePromise,
+
+	awaitOrRun: function(data, func){
+		data = [...arguments]
+		func = data.pop()
+		// ceck if we need to await...
+		return data
+				.reduce(function(res, e){
+					return res 
+						|| e instanceof Promise }, false) ?
+			// NOTE: we will not reach this on empty data...
+			(data.length > 1 ?
+				Promise.all(data)
+					.then(function(res){ 
+						return func(...res) })
+				: data[0].then(func))
+			: func(...data) },
 })
 
 PromiseMixin(Promise)

package/README.md

@@ -94,6 +94,8 @@ Library of JavaScript type extensions, types and utilities.
     - [Promise proxies](#promise-proxies)
       - [`<promise>.as(..)`](#promiseas)
       - [`<promise-proxy>.<method>(..)`](#promise-proxymethod)
+    - [Promise utilities](#promise-utilities)
+      - [`Promise.awaitOrRun(..)`](#promiseawaitorrun)
   - [Generator extensions and utilities](#generator-extensions-and-utilities)
     - [The basics](#the-basics)
       - [`generator.Generator`](#generatorgenerator)
@@ -636,11 +638,17 @@ Compare to arrays ignoring element order and count.
 Sort array as a different array.
 ```bnf
 <array>.sortAs(<other>)
+<array>.sortAs(<other>, 'head')
+    -> <array>
+
+<array>.sortAs(<other>, 'tail')
     -> <array>
 ```
 
 Elements not present in `<other>` retain their relative order and are
-placed after the sorted elements.
+placed after the sorted elements if `'head'` (i.e. _"sorted at head of 
+array"_) is passed as second argument (default) and before them if 
+`'tail'` (_"sorted at tail"_) is passed.
 
 Example:
 ```javascript
@@ -1993,6 +2001,22 @@ the main `<promise>` is resolved.
 
 
 
+### Promise utilities
+
+#### `Promise.awaitOrRun(..)`
+
+Await for inputs if any of them is a promise and then run a function with 
+the results, otherwise run the function in sync.
+
+```dnf
+Promise.awaitOrRun(<value>, <func>)
+Promise.awaitOrRun(<value>, .. , <func>)
+	-> <promise(value)>
+	-> <value>
+```
+
+
+
 ## Generator extensions and utilities
 
 ```javascript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ig-types",
-  "version": "6.21.0",
+  "version": "6.22.0",
   "description": "Generic JavaScript types and type extensions...",
   "main": "main.js",
   "scripts": {