ig-types 6.23.0 → 6.24.1

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,9 +94,10 @@ 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)
-      - [`Promise.maybe(..)` / `promise.MaybePromice(..)`](#promisemaybe--promisemaybepromice)
-      - [`<maybe-promise>.value` / `<maybe-promise>.error`](#maybe-promisevalue--maybe-promiseerror)
+    - [Sync/async promise](#syncasync-promise)
+      - [`Promise.sync(..)` / `promise.SyncPromice(..)`](#promisesync--promisesyncpromice)
+      - [`<promise>.sync(..)`](#promisesync)
+      - [`<sync-promise>.value` / `<sync-promise>.error`](#sync-promisevalue--sync-promiseerror)
     - [Promise utilities](#promise-utilities)
       - [`Promise.awaitOrRun(..)`](#promiseawaitorrun)
   - [Generator extensions and utilities](#generator-extensions-and-utilities)
@@ -2007,13 +2008,42 @@ the main `<promise>` is resolved.
 ### Sync/async promise
 
 
-#### `Promise.maybe(..)` / `promise.MaybePromice(..)`
+#### `Promise.sync(..)` / `promise.SyncPromice(..)`
 
-XXX
+```dnf
+Promise.sync(<func>)
+	-> <sync-promise>
 
-#### `<maybe-promise>.value` / `<maybe-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
+```
+-->
+
+
+#### `<promise>.sync()`
+
+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`.
 
-XXX
 
 
 ### Promise utilities

package/package.json

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