ig-types 6.23.0 → 6.24.0

package/Promise.js

@@ -799,24 +799,27 @@ object.Constructor('ProxyPromise', Promise, {
 // XXX DOCS...
 // XXX like promise but if a value can be generated sync then this will 
 // 		run in sync otherwise it will fall back to being a promise...
-// XXX potential problem is recursion (depth) on the sync stage...
-// XXX should we throw errors in sync mode???
-var MaybePromise =
-module.MaybePromise =
-object.Constructor('MaybePromise', Promise, {
-	//error: undefined,
+// XXX should we throw errors in sync mode??? ...option???
+var SyncPromise =
+module.SyncPromise =
+object.Constructor('SyncPromise', Promise, {
 	//value: undefined,
+	//error: undefined,
 
+	// NOTE: if this is called it means that .__new__(..) returned in sync 
+	// 		mode and thus set .value and possibly .error, soe there is no 
+	// 		need to check for .value...
 	then: function(resolve, reject){
 		if(this.hasOwnProperty('error')){
 			return this.constructor.reject(
 				reject ?
 					reject(this.error)
 					: this.error) }
-		if(this.hasOwnProperty('value')){
-			return this.constructor.resolve(
-				resolve(this.value)) } },
+		return this.constructor.resolve(
+			resolve(this.value)) },
 
+	// NOTE: if func calls resolve(..) with a promise then this will return
+	// 		that promise...
 	__new__: function(context, func){
 		var result
 		var resolve = function(res){
@@ -854,7 +857,7 @@ object.Mixin('PromiseMixin', 'soft', {
 	interactive: InteractivePromise,
 	cooperative: CooperativePromise,
 	// XXX EXPEREMENTAL...
-	maybe: MaybePromise,
+	sync: SyncPromise,
 	
 	// XXX need error support...
 	awaitOrRun: function(data, func){
@@ -901,6 +904,13 @@ object.Mixin('PromiseProtoMixin', 'soft', {
 	as: ProxyPromise,
 	iter: function(handler=undefined){
 		return IterablePromise(this, handler) },
+	// XXX revise...
+	sync: function(){
+		if(this instanceof SyncPromise){
+			if('error' in this){
+				throw this.error }
+			return this.value }
+		return this },
 })
 
 PromiseProtoMixin(Promise.prototype)

package/README.md

@@ -94,7 +94,7 @@ Library of JavaScript type extensions, types and utilities.
     - [Promise proxies](#promise-proxies)
       - [`<promise>.as(..)`](#promiseas)
       - [`<promise-proxy>.<method>(..)`](#promise-proxymethod)
-    - [Sync/Async promise](#syncasync-promise)
+    - [Sync/async promise](#syncasync-promise)
       - [`Promise.maybe(..)` / `promise.MaybePromice(..)`](#promisemaybe--promisemaybepromice)
       - [`<maybe-promise>.value` / `<maybe-promise>.error`](#maybe-promisevalue--maybe-promiseerror)
     - [Promise utilities](#promise-utilities)
@@ -2007,11 +2007,15 @@ the main `<promise>` is resolved.
 ### Sync/async promise
 
 
-#### `Promise.maybe(..)` / `promise.MaybePromice(..)`
+#### `Promise.sync(..)` / `promise.SyncPromice(..)`
 
 XXX
 
-#### `<maybe-promise>.value` / `<maybe-promise>.error`
+#### `<sync-promise>.value` / `<sync-promise>.error`
+
+XXX
+
+#### `<promise>.sync()`
 
 XXX
 

package/package.json

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