ig-types 6.24.0 → 6.24.2

package/Promise.js

@@ -795,6 +795,34 @@ object.Constructor('ProxyPromise', Promise, {
 
 //---------------------------------------------------------------------
 
+var syncAllProxy = 
+function(name){
+	return function(lst){
+		var sync = true
+		for(var e of lst){
+			if(e instanceof Promise 
+					&& !(e instanceof SyncPromise)){
+				sync = false
+				break } }
+		return sync ?
+			this.resolve(lst)
+			: Promise[name](lst) } }
+
+// XXX REVISE/TEST...
+var syncAnyProxy =
+function(name){
+	return function(lst){
+		for(var e of lst){
+			if(e instanceof SyncPromise 
+					&& !('error' in e)){
+				return e }
+			if(!(e instanceof Promise)){
+				return this.resolve(e) } }
+		return Promise[name](list) } }
+
+
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
+
 // XXX EXPEREMENTAL...
 // XXX DOCS...
 // XXX like promise but if a value can be generated sync then this will 
@@ -803,6 +831,17 @@ object.Constructor('ProxyPromise', Promise, {
 var SyncPromise =
 module.SyncPromise =
 object.Constructor('SyncPromise', Promise, {
+	// NOTE: we need to overload these as the builtin versions sneak-in 
+	// 		async-ness before we can catch it in .__new__(..)
+	resolve: function(value){
+		return new this(function(resolve){ resolve(value) }) },
+	reject: function(error){
+		return new this(function(_, reject){ reject(error) }) },
+	all: syncAllProxy('all'),
+	allSettled: syncAllProxy('allSettled'),
+	any: syncAnyProxy('any'),
+	race: syncAnyProxy('race'),
+},{
 	//value: undefined,
 	//error: undefined,
 
@@ -821,14 +860,14 @@ object.Constructor('SyncPromise', Promise, {
 	// NOTE: if func calls resolve(..) with a promise then this will return
 	// 		that promise...
 	__new__: function(context, func){
-		var result
+		var value
 		var resolve = function(res){
-			result = res }
+			return (value = res) }
 		var rejected
 		var error
 		var reject = function(err){
 			rejected = true
-			error = err }
+			return (error = err) }
 		// call...
 		try{
 			func(resolve, reject)
@@ -836,12 +875,12 @@ object.Constructor('SyncPromise', Promise, {
 			reject(err) }
 		// async...
 		if(!error 
-				&& result instanceof Promise){
-			return result }
+				&& value instanceof Promise){
+			return value }
 		// sync...
-		var obj = Promise.resolve(result)
+		var obj = Promise.resolve(value)
 		obj.__proto__ = this.prototype
-		obj.value = result
+		obj.value = value
 		rejected
 			&& (obj.error = error)
 		return obj },

package/README.md

@@ -95,8 +95,10 @@ Library of JavaScript type extensions, types and utilities.
       - [`<promise>.as(..)`](#promiseas)
       - [`<promise-proxy>.<method>(..)`](#promise-proxymethod)
     - [Sync/async promise](#syncasync-promise)
-      - [`Promise.maybe(..)` / `promise.MaybePromice(..)`](#promisemaybe--promisemaybepromice)
-      - [`<maybe-promise>.value` / `<maybe-promise>.error`](#maybe-promisevalue--maybe-promiseerror)
+      - [`Promise.sync(..)` / `promise.SyncPromice(..)`](#promisesync--promisesyncpromice)
+      - [`<promise>.sync(..)`](#promisesync)
+      - [`<sync-promise>.value` / `<sync-promise>.error`](#sync-promisevalue--sync-promiseerror)
+      - [`Promise.sync.all(..)` / `Promise.sync.allSettled(..)` / `Promise.sync.any(..)` / `Promise.sync.race(..)`](promisesyncall--promisesyncallsettled--promisesyncany--promisesyncrace`)
     - [Promise utilities](#promise-utilities)
       - [`Promise.awaitOrRun(..)`](#promiseawaitorrun)
   - [Generator extensions and utilities](#generator-extensions-and-utilities)
@@ -2009,15 +2011,46 @@ the main `<promise>` is resolved.
 
 #### `Promise.sync(..)` / `promise.SyncPromice(..)`
 
-XXX
+```dnf
+Promise.sync(<func>)
+	-> <sync-promise>
 
-#### `<sync-promise>.value` / `<sync-promise>.error`
+<func>(<resolve>, <reject>)
+
+<resolve>(<value>)
+
+<reject>(<error>)
+```
+
+Implements the full `Promise` protocol but does it in a sync manner, but
+the execution of `<func>` is done synchronously. If the value passed to 
+`<resolve>(..)` is a promise this will return that and continue asynchronously
+otherwise all the promise API (`.then(..)`/`.catch(..)`/...) is run in sync.
+
+<!--
+Example:
+```javascript
+```
+-->
 
-XXX
 
 #### `<promise>.sync()`
 
-XXX
+Synchronously return the resolved value if `<sync-promise>` resolved, and
+if it _rejected_ then re-throw the `<error>`.
+
+
+#### `<sync-promise>.value` / `<sync-promise>.error`
+
+`<sync-promise>` attributes that provide access the resolved `.value` and/or
+rejection `.error`.
+
+
+#### `Promise.sync.all(..)` / `Promise.sync.allSettled(..)` / `Promise.sync.any(..)` / `Promise.sync.race(..)`
+
+Equivalents to `Promise`'s version but will run sync if the relevant 
+items in the input are either non-promises or `<sync-promise>`s.
+
 
 
 ### Promise utilities

package/package.json

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