ig-types 6.15.0 → 6.16.0

package/Array.js

@@ -12,6 +12,7 @@
 /*********************************************************************/
 
 var object = require('ig-object')
+var stoppable = require('ig-stoppable')
 
 var generator = require('./generator')
 
@@ -22,8 +23,7 @@ var generator = require('./generator')
 // NOTE: this is used in a similar fashion to Python's StopIteration...
 var STOP =
 module.STOP =
-	object.STOP
-
+	stoppable.STOP
 
 
 //---------------------------------------------------------------------
@@ -212,8 +212,12 @@ object.Mixin('ArrayMixin', 'soft', {
 			// done...
 			: [] },
 
-	iter: function*(lst=[]){
-		yield* lst.iter() },
+	// XXX not sure about the handler API here yet... 
+	iter: function*(lst=[], handler=undefined){
+		yield* lst.iter(
+			...(handler ? 
+				[handler] 
+				: [])) },
 })
 
 
@@ -488,8 +492,22 @@ object.Mixin('ArrayProtoMixin', 'soft', {
 	//		-> iterator
 	//
 	// XXX should this take an argument and be like map??
-	iter: function*(){
-		yield* this },
+	// XXX this should handle throwing STOP!!!
+	// 		...might also ne a good idea to isolate the STOP mechanics 
+	// 		into a spearate module/package...
+	iter: stoppable(function*(handler=undefined){
+		if(handler){
+			var i = 0
+			for(var e of this){
+				var res = handler.call(this, e, i++) 
+				// treat non-iterables as single elements...
+				if(typeof(res) == 'object' 
+						&& Symbol.iterator in res){
+					yield* res
+				} else {
+					yield res } } 
+		} else {
+			yield* this }}),
 
 
 	// Stoppable iteration...

package/Function.js

@@ -0,0 +1,18 @@
+/**********************************************************************
+* 
+*
+*
+**********************************************/  /* c8 ignore next 2 */
+((typeof define)[0]=='u'?function(f){module.exports=f(require)}:define)
+(function(require){ var module={} // make module AMD/node compatible...
+/*********************************************************************/
+
+
+var AsyncFunction =
+module.AsyncFunction =
+	(async function(){}).constructor
+
+
+
+/**********************************************************************
+* vim:set ts=4 sw=4 :                               */ return module })

package/Promise.js

@@ -5,8 +5,7 @@
 * 	Promise.iter(seq)
 * 	<promise>.iter()
 * 		Iterable promise object.
-* 		Similar to Promise.all(..) but adds basic iterator/generator
-* 		API and will resolve the items as they are ready (resolved).
+* 		Similar to Promise.all(..) but adds basic iterator API.
 *
 * 	Promise.interactive(handler)
 * 		Interactive promise object.
@@ -31,6 +30,8 @@
 
 var object = require('ig-object')
 
+//var generator = require('./generator')
+
 
 
 //---------------------------------------------------------------------
@@ -39,16 +40,6 @@ var object = require('ig-object')
 // Like Promise.all(..) but adds ability to iterate through results
 // via generators .map(..)/.reduce(..) and friends...
 // 
-// NOTE: it would be nice to support throwing STOP from the iterable 
-// 		promise but...
-// 		- this is more complicated than simply using .smap(..) instead 
-// 			of .map(..) because the list can contain async promises...
-// 			...would need to wrap each .then(..) call in try-catch and
-// 			manually handle the stop...
-// 			...then there's a question of derivative iterators etc.
-// 		- another issue here is that the stop would happen in order of 
-// 			execution and not order of elements...
-// 		XXX EXPEREMENTAL: STOP...
 // NOTE: the following can not be implemented here:
 // 			.splice(..)				- can't both modify and return
 // 									  a result...
@@ -68,18 +59,19 @@ var object = require('ig-object')
 // 		back to the complex IterablePromise...
 // 		
 // XXX how do we handle errors/rejections???
+// 		...mostly the current state is OK, but need more testing...
+// XXX add support for async generators...
 // 		
 
-// XXX should these be exported???
 var iterPromiseProxy = 
-//module.iterPromiseProxy = 
+module.iterPromiseProxy = 
 function(name){
 	return function(...args){
 		return this.constructor(
 			this.then(function(lst){
 				return lst[name](...args) })) } }
 var promiseProxy =
-//module.promiseProxy =
+module.promiseProxy =
 function(name){
 	return async function(...args){
 		return (await this)[name](...args) } }
@@ -87,7 +79,6 @@ function(name){
 var IterablePromise =
 module.IterablePromise =
 object.Constructor('IterablePromise', Promise, {
-	// XXX EXPEREMENTAL: STOP...
 	get STOP(){
 		return Array.STOP },
 
@@ -129,6 +120,11 @@ object.Constructor('IterablePromise', Promise, {
 	// 		stop will stop the handlers not yet run and not the next 
 	// 		handlers in sequence.
 	// 		XXX EXPEREMENTAL: STOP...
+	// XXX add support for async generators...
+	// 		...an async generator is not "parallel", i.e. intil one 
+	// 		returned promise is resolved the generator blocks (will not 
+	// 		advance)...
+	// 		...can we feed out a results one by one???
 	__pack: function(list, handler=undefined){
 		var that = this
 		// handle iterable promise list...
@@ -237,8 +233,9 @@ object.Constructor('IterablePromise', Promise, {
 					that.__pack(elem, handler)
 				: elem instanceof Promise ?
 					that.__pack(elem, handler)
-						.then(function(elem){
-							return elem.flat() })
+						//.then(function(elem){
+						.then(function([elem]){
+							return elem })
 				: [handler(elem)] })
    			.flat() },
 	// unpack array (async)...
@@ -297,6 +294,8 @@ object.Constructor('IterablePromise', Promise, {
 			.then(function(){ 
 				return res }) },
 
+	// XXX .chain(..) -- see generator.chain(..)
+
 	flat: function(depth=1){
 		return this.constructor(this, 
 			function(e){ 
@@ -367,6 +366,7 @@ object.Constructor('IterablePromise', Promise, {
 		var list = this.__packed
 		return ((i != 0 && i != -1)
 					|| list instanceof Promise
+					// XXX not sure if this is correct...
 					|| list.at(i) instanceof Promise) ?
 				(await this).at(i)
 			// NOTE: we can only reason about first/last explicit elements, 
@@ -384,7 +384,6 @@ object.Constructor('IterablePromise', Promise, {
 	// NOTE: unlike .reduce(..) this needs the parent fully resolved 
 	// 		to be able to iterate from the end.
 	// XXX is it faster to do .reverse().reduce(..) ???
-	// XXX ???
 	reduceRight: promiseProxy('reduceRight'),
 
 	// NOTE: there is no way we can do a sync generator returning 
@@ -465,6 +464,17 @@ object.Constructor('IterablePromise', Promise, {
 	every: promiseProxy('every'),
 
 
+	join: async function(){
+		return [...(await this)]
+			.join(...arguments) },
+
+
+	// this is defined globally as Promise.prototype.iter(..)
+	//
+	// for details see: PromiseMixin(..) below...
+	//iter: function(handler=undefined){ ... },
+
+
 	// promise api...
 	//
 	// Overload .then(..), .catch(..) and .finally(..) to return a plain 
@@ -492,12 +502,6 @@ object.Constructor('IterablePromise', Promise, {
 			: p },
 
 
-	// this is defined globally as Promise.prototype.iter(.,)
-	//
-	// for details see: PromiseMixin(..) below...
-	//iter: function(handler=undefined){ ... },
-
-
 	// constructor...
 	//
 	//	Promise.iter([ .. ])
@@ -518,6 +522,7 @@ object.Constructor('IterablePromise', Promise, {
 	// 		items...
 	// 		XXX we can make the index a promise, then if the client needs
 	// 			the value they can wait for it...
+	// 			...this may be quite an overhead...
 	//
 	//
 	// Special cases useful for extending this constructor...
@@ -654,6 +659,7 @@ object.Constructor('InteractivePromise', Promise, {
 // Cooperative promise...
 // 
 // A promise that can be resolved/rejected externally.
+//
 // NOTE: normally this has no internal resolver logic...
 // 
 

package/README.md

@@ -13,6 +13,8 @@ Library of JavaScript type extensions, types and utilities.
     - [`Object.matchPartial(..)`](#objectmatchpartial)
     - [`<object>.run(..)`](#objectrun)
     - [`Object.sort(..)`](#objectsort)
+  - [`Function`](#function)
+    - [`func.AsyncFunction`](#funcasyncfunction)
   - [`Array`](#array)
     - [`<array>.first(..)` / `<array>.last(..)`](#arrayfirst--arraylast)
     - [`<array>.rol(..)`](#arrayrol)
@@ -94,7 +96,7 @@ Library of JavaScript type extensions, types and utilities.
       - [`generator.iter(..)`](#generatoriter)
       - [`generator.STOP`](#generatorstop)
     - [Generator instance iteration](#generator-instance-iteration)
-      - [`<generator>.iter()`](#generatoriter-1)
+      - [`<generator>.iter(..)`](#generatoriter-1)
       - [`<generator>.map(..)` / `<generator>.filter(..)`](#generatormap--generatorfilter)
       - [`<generator>.reduce(..)` / `<generator>.greduce(..)`](#generatorreduce--generatorgreduce)
       - [`<generator>.slice(..)`](#generatorslice)
@@ -102,7 +104,6 @@ Library of JavaScript type extensions, types and utilities.
       - [`<generator>.flat(..)`](#generatorflat)
       - [`<generator>.shift()` / `<generator>.pop()` / `<generator>.gshift()` / `<generator>.gpop()`](#generatorshift--generatorpop--generatorgshift--generatorgpop)
       - [`<generator>.unshift(..)` / `<generator>.push(..)`](#generatorunshift--generatorpush)
-      - [`<generator>.promise()`](#generatorpromise)
       - [`<generator>.then(..)` / `<generator>.catch(..)` / `<generator>.finally(..)`](#generatorthen--generatorcatch--generatorfinally)
       - [`<generator>.toArray()`](#generatortoarray)
     - [Treating iterators the same as generators](#treating-iterators-the-same-as-generators)
@@ -124,6 +125,15 @@ Library of JavaScript type extensions, types and utilities.
       - [`generator.produce(..)`](#generatorproduce)
     - [Generator helpers](#generator-helpers)
       - [`generator.stoppable(..)`](#generatorstoppable)
+  - [Async generator extensions](#async-generator-extensions)
+      - [`generator.AsyncGenerator`](#generatorasyncgenerator)
+      - [`<async-generator>.then(..)` / `<async-generator>.catch(..)` / `<async-generator>.finally(..)`](#async-generatorthen--async-generatorcatch--async-generatorfinally)
+      - [`<async-generator>.iter(..)`](#async-generatoriter)
+      - [`<async-generator>.map(..)` / `<async-generator>.filter(..)` / `<async-generator>.reduce(..)`](#async-generatormap--async-generatorfilter--async-generatorreduce)
+      - [`<async-generator>.chain(..)`](#async-generatorchain)
+      - [`<async-generator>.flat(..)`](#async-generatorflat)
+      - [`<async-generator>.concat(..)`](#async-generatorconcat)
+      - [`<async-generator>.push(..)` / `<async-generator>.unshift(..)`](#async-generatorpush--async-generatorunshift)
   - [Containers](#containers)
     - [`containers.UniqueKeyMap()` (`Map`)](#containersuniquekeymap-map)
       - [`<unique-key-map>.set(..)`](#unique-key-mapset)
@@ -446,6 +456,30 @@ Object.keys(Object.sort(o, ['x', 'a', '100']))
 This is similar to [`<map>.sort(..)`](#mapsort) and [`<ser>.sort(..)`](#setsort).
 
 
+## `Function`
+
+```javascript
+var func = require('ig-types/Function')
+```
+
+### `func.AsyncFunction`
+
+The async function constructor.
+
+This enables us to test if an object is an instance of an async function. 
+
+```javascript
+var a = async function(){
+    // ...
+}
+
+a instanceof func.AsyncFunction // -> true
+```
+
+This is hidden by JavaScript by default.
+
+
+
 ## `Array`
 
 ```javascript
@@ -2023,7 +2057,7 @@ Chained generators handle items depth-first, i.e. the items are passed as they
 are yielded down the generator chain.
 
 
-#### `<generator>.iter()`
+#### `<generator>.iter(..)`
 
 Iterate over the generator.
 ```bnf
@@ -2031,7 +2065,24 @@ Iterate over the generator.
     -> <generator>
 ```
 
-This is here mainly for compatibility with [`<array>`'s `.iter()`](#arrayiter--arrayiter).
+XXX move this to `generator.iter(..)`
+
+Compatible with [`<array>`'s `.iter()`](#arrayiter--arrayiter).
+
+`.iter(..)` also supports a handler function
+```bnf
+<generator>.iter(<handler>)
+    -> <generator>
+
+
+<handler>(<elem>, <index>)
+    -> <elem>
+    -> [<elem>, ..]
+    -> []
+```
+
+Note that the iterables returned by `<handler>(..)` will be expanded, to prevent 
+this wrap them in an array.
 
 
 #### `<generator>.map(..)` / `<generator>.filter(..)` 
@@ -2156,30 +2207,29 @@ Value added by `.unshift(..)` will be yielded by `<generator>` "first", i.e. on
 _next_ call to `.next()`, regardless of the current generator state.
 
 
-#### `<generator>.promise()`
+#### `<generator>.then(..)` / `<generator>.catch(..)` / `<generator>.finally(..)`
+
+Return a promise and resolve it with the generator value.
 
 ```bnf
-<generator>.promise()
+<generator>.then()
     -> <promise>
 ```
-Return a promise and resolve it with the generator value.
-
-Note that this will deplete the generator.
 
-
-#### `<generator>.then(..)` / `<generator>.catch(..)` / `<generator>.finally(..)`
+Adding handlers to the promise
 
 ```bnf
 <generator>.then(<resolve>, <reject>)
     -> <promise>
 
-<generator>.then(<reject>)
+<generator>.then(<resolve>)
     -> <promise>
 
 <generator>.finally(<handler>)
     -> <promise>
 ```
-Shorthands to `<generator>.promise().then(..)` / `<generator>.promise().catch(..)` / `<generator>.promise().finally(..)`
+
+Note that this will deplete the generator.
 
 These are the same as equivalent `Promise` methods, for more info see:  
 https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
@@ -2483,6 +2533,26 @@ stoppable(<generator>)
 
 <!-- XXX example? -->
 
+## Async generator extensions
+
+XXX EXPERIMENTAL
+
+#### `generator.AsyncGenerator`
+
+#### `<async-generator>.then(..)` / `<async-generator>.catch(..)` / `<async-generator>.finally(..)`
+
+#### `<async-generator>.iter(..)`
+
+#### `<async-generator>.map(..)` / `<async-generator>.filter(..)` / `<async-generator>.reduce(..)`
+
+#### `<async-generator>.chain(..)`
+
+#### `<async-generator>.flat(..)`
+
+#### `<async-generator>.concat(..)`
+
+#### `<async-generator>.push(..)` / `<async-generator>.unshift(..)`
+
 
 
 ## Containers

package/event.js

@@ -343,14 +343,14 @@ module.EventDocMixin = object.Mixin('EventDocMixin', {
 		return object.deepKeys(this)
 			.filter(function(n){ 
 				// avoid triggering props...
-				return !object.values(this, n, function(){ return object.STOP }, true)[0].get
+				return !object.values(this, n, true).next().value.get
 					// XXX this is too strict...
 					&& (this[n] || {}).constructor === Eventful}.bind(this)) },
 	get events(){
 		return object.deepKeys(this)
 			.filter(function(n){ 
 				// avoid triggering props...
-				return !object.values(this, n, function(){ return object.STOP }, true)[0].get
+				return !object.values(this, n, true).next().value.get
 					// XXX this is too strict...
 					&& (this[n] || {}).constructor === Event }.bind(this)) },
 })

package/generator.js

@@ -8,6 +8,7 @@
 /*********************************************************************/
 
 var object = require('ig-object')
+var stoppable = require('ig-stoppable')
 
 
 
@@ -16,7 +17,7 @@ var object = require('ig-object')
 // NOTE: this is used in a similar fashion to Python's StopIteration...
 var STOP =
 module.STOP =
-	object.STOP
+	stoppable.STOP
 
 
 //---------------------------------------------------------------------
@@ -38,11 +39,11 @@ module.STOP =
 // of each of them.
 // So, below we will define:
 //
-// 	GeneratorPrototype 
+// 	Generator.prototype 
 // 		prototype of the generator constructors (i.e. Iter(..) from the 
 // 		above example)
 //
-// 	GeneratorPrototype.prototype
+// 	Generator.prototype.prototype
 // 		generator instance prototype (i.e. iter for the above code)
 //
 //
@@ -58,13 +59,14 @@ module.STOP =
 //
 //---------------------------------------------------------------------
 
-var GeneratorPrototype =
-	(function*(){}).constructor.prototype
-
 var Generator = 
 module.Generator =
 	(function*(){}).constructor
 
+var AsyncGenerator =
+module.AsyncGenerator =
+	(async function*(){}).constructor
+
 
 // base iterator prototypes...
 var ITERATOR_PROTOTYPES = [
@@ -77,19 +79,44 @@ var ITERATOR_PROTOTYPES = [
 
 
 //---------------------------------------------------------------------
-
 // generic generator wrapper...
+
+// helper...
+var __iter = 
+module.__iter =
+function*(lst=[]){
+	if(typeof(lst) == 'object' 
+			&& Symbol.iterator in lst){
+		yield* lst 
+	} else {
+		yield lst } }
+
+// XXX updatae Array.js' version for compatibility...
+// XXX DOCS!!!
 var iter = 
 module.iter = 
 Generator.iter =
-	function*(lst=[]){
-		for(var e of lst){
-			yield e } }
+	stoppable(function(lst=[]){
+		// handler -> generator-constructor...
+		if(typeof(lst) == 'function'){
+			// we need to be callable...
+			var that = this instanceof Function ?
+				this
+				// generic root generator...
+				: module.__iter
+			return function*(){
+				yield* that(...arguments).iter(lst) } }
+		// no handler -> generator instance...
+		return module.__iter(lst) })
+
+// NOTE: we need .iter(..) to both return generators if passed an iterable
+// 		and genereator constructos if passed a function...
+iter.__proto__ = Generator.prototype
 
 
 
 //---------------------------------------------------------------------
-// GeneratorPrototype "class" methods...
+// Generator.prototype "class" methods...
 //
 // the following are effectively the same:
 // 	1) Wrapper
@@ -113,9 +140,11 @@ Generator.iter =
 
 //
 // 	makeGenerator(<name>)
+// 	makeGenerator(<name>, <handler>)
 // 		-> <func>
 //
-// 	makeGenerator(<name>, <handler>)
+// 	makeGenerator('async', <name>)
+// 	makeGenerator('async', <name>, <handler>)
 // 		-> <func>
 //
 //
@@ -132,14 +161,26 @@ Generator.iter =
 // XXX this needs to be of the correct type... (???)
 // XXX need to accept generators as handlers...
 var makeGenerator = function(name, pre){
+	var sync = true
+	if(name == 'async'){
+		sync = false
+		var [name, pre] = [...arguments].slice(1) }
 	return function(...args){
 		var that = this
 		return Object.assign(
-			function*(){
-				var a = pre ? 
-					pre.call(this, args, ...arguments)
-					: args
-				yield* that(...arguments)[name](...a) }, 
+			// NOTE: the two branches here are identical, the only 
+			// 		difference is the async keyword...
+			sync ?
+				function*(){
+					var a = pre ? 
+						pre.call(this, args, ...arguments)
+						: args
+					yield* that(...arguments)[name](...a) }
+				: async function*(){
+					var a = pre ? 
+						pre.call(this, args, ...arguments)
+						: args
+					yield* that(...arguments)[name](...a) }, 
 			{ toString: function(){
 				return [
 					that.toString(), 
@@ -155,34 +196,6 @@ var makePromise = function(name){
 			return that(...arguments)[name](func) } } }
 
 
-var stoppable = 
-module.stoppable =
-function(func){
-	return Object.assign(
-		func instanceof Generator ?
-			function*(){
-				try{
-					yield* func.call(this, ...arguments)
-				} catch(err){
-					if(err === STOP){
-						return
-					} else if(err instanceof STOP){
-						yield err.value
-						return }
-					throw err } }
-			: function(){
-				try{
-					return func.call(this, ...arguments)
-				} catch(err){
-					if(err === STOP){
-						return
-					} else if(err instanceof STOP){
-						return err.value }
-					throw err } },
-		{ toString: function(){
-			return func.toString() }, }) }
-
-
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 var GeneratorMixin =
@@ -190,9 +203,7 @@ module.GeneratorMixin =
 object.Mixin('GeneratorMixin', 'soft', {
 	STOP: object.STOP,
 
-	// NOTE: this is here for compatibility with Array.iter(..)
-	iter: function*(lst=[]){
-		yield* module.iter(lst) },
+	iter: module.iter,
 
 	gat: makeGenerator('gat'),
 	at: function(i){
@@ -221,7 +232,7 @@ object.Mixin('GeneratorMixin', 'soft', {
 				return that(...arguments).toArray() },
 			{ toString: function(){
 				return that.toString() 
-					+ '\n    .toString()'}, }) },
+					+ '\n    .toArray()'}, }) },
 	gpop: makeGenerator('gpop'),
 	pop: function(){
 		var that = this
@@ -231,7 +242,7 @@ object.Mixin('GeneratorMixin', 'soft', {
 				return that(...arguments).pop() },
 			{ toString: function(){
 				return that.toString() 
-					+ '\n    .gpop()'}, }) },
+					+ '\n    .pop()'}, }) },
 	push: makeGenerator('push'),
 	gshift: makeGenerator('gshift'),
 	shift: function(){
@@ -242,7 +253,7 @@ object.Mixin('GeneratorMixin', 'soft', {
 				return that(...arguments).shift() }, 
 			{ toString: function(){
 				return that.toString() 
-					+ '\n    .gshift()'}, }) },
+					+ '\n    .shift()'}, }) },
 	unshift: makeGenerator('unshift'),
 
 	// promises...
@@ -264,15 +275,43 @@ object.Mixin('GeneratorMixin', 'soft', {
 						e(...args)
 						: e }) }),
 	//zip: makeGenerator('zip'),
+	
+	enumerate: makeGenerator('enumerate'),
+
+	// XXX should this have a .gjoin(..) companion...
+	join: function(){
+		var args = [...arguments]
+		var that = this
+		return Object.assign(
+			function(){
+				//return that(...arguments).toArray().shift() }, 
+				return that(...arguments).join(...args) }, 
+			{ toString: function(){
+				return that.toString() 
+					+ '\n    .join()'}, }) },
 })
 
 
 var GeneratorProtoMixin =
 module.GeneratorProtoMixin =
 object.Mixin('GeneratorProtoMixin', 'soft', {
-	// NOTE: this is here for compatibility with [..].iter()
-	iter: function*(){ 
-		yield* this },
+	// XXX use module.iter(..) ???
+	iter: stoppable(function*(handler){ 
+		if(handler){
+			var i = 0
+			for(var elem of this){
+				var res = handler.call(this, elem, i) 
+				// expand iterables...
+				if(typeof(res) == 'object' 
+						&& Symbol.iterator in res){
+					yield* res
+				// as-is...
+				} else {
+					yield res }}
+		// no handler...
+		} else {
+			yield* this } }),
+	//*/
 
 	at: function(i){
 		return this.gat(i).next().value },
@@ -382,17 +421,19 @@ object.Mixin('GeneratorProtoMixin', 'soft', {
 
 	// promises...
 	//
-	// XXX how do we handle reject(..) / .catch(..)???
-	promise: function(){
+	then: function(onresolve, onreject){
 		var that = this
-		return new Promise(function(resolve){
-				resolve([...that]) }) },
-	then: function(func){
-		return this.promise().then(func) },
+		var p = new Promise(
+			function(resolve){
+				resolve([...that]) }) 
+		p = (onresolve || onreject) ?
+			p.then(...arguments)
+			: p
+		return p },
 	catch: function(func){
-		return this.promise().catch(func) },
+		return this.then().catch(func) },
 	finally: function(func){
-		return this.promise().finally(func) },
+		return this.then().finally(func) },
 
 	// combinators...
 	//
@@ -415,11 +456,20 @@ object.Mixin('GeneratorProtoMixin', 'soft', {
 		// XXX
 	},
 	//*/
+
+	enumerate: function*(){
+		var i = 0
+		for(var e of this){
+			yield [i++, e] } },
+
+	join: function(){
+		return [...this]
+			.join(...arguments) },
 })
 
 
-GeneratorMixin(GeneratorPrototype)
-GeneratorProtoMixin(GeneratorPrototype.prototype)
+GeneratorMixin(Generator.prototype)
+GeneratorProtoMixin(Generator.prototype.prototype)
 
 
 // Extend base iterators...
@@ -428,6 +478,111 @@ ITERATOR_PROTOTYPES
 		GeneratorProtoMixin(proto) })
 
 
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
+// XXX EXPERIMENTAL...
+
+var AsyncGeneratorMixin =
+module.AsyncGeneratorMixin =
+object.Mixin('AsyncGeneratorMixin', 'soft', {
+	// XXX TEST...
+	iter: makeGenerator('async', 'iter'),
+
+	map: makeGenerator('async', 'map'),
+	filter: makeGenerator('async', 'filter'),
+	reduce: makeGenerator('async', 'reduce'),
+})
+
+var AsyncGeneratorProtoMixin =
+module.AsyncGeneratorProtoMixin =
+object.Mixin('AsyncGeneratorProtoMixin', 'soft', {
+	// promise...
+	//
+	// NOTE: this will unwind the generator...
+	// XXX create an iterator promise???
+	// XXX should we unwind???
+	then: function(resolve, reject){
+		var that = this
+		var p = new Promise(async function(_resolve, _reject){
+			var res = []
+			for await(var elem of that){
+				res.push(elem) }
+			_resolve(res) }) 
+		p = (resolve || reject) ?
+			p.then(...arguments)
+			: p
+		return p },
+	catch: function(func){
+		return this.then().catch(func) },
+	finally: function(){
+		return this.then().finally(func) },
+
+	// XXX might be a good idea to use this approach above...
+	iter: stoppable(async function*(handler=undefined){
+		var i = 0
+		if(handler){
+			for await(var e of this){
+				var res = handler.call(this, e, i++)
+				if(typeof(res) == 'object' 
+						&& Symbol.iterator in res){
+					yield* res
+				} else {
+					yield res } }
+		} else {
+			yield* this } }),
+
+	map: async function*(func){
+		yield* this.iter(function(elem, i){
+			return [func.call(this, elem, i)] }) },
+	filter: async function*(func){
+		yield* this.iter(function(elem, i){
+			return func.call(this, elem, i) ?
+	   			[elem]
+				: [] }) },
+	// NOTE: there is not much point in .reduceRight(..) in an async 
+	// 		generator as we'll need to fully unwind it then go from the 
+	// 		end...
+	reduce: async function(func, state){
+		this.iter(function(elem, i){
+			state = func.call(this, state, elem, i) 
+			return [] })
+		return state },
+
+	// XXX TEST...
+	chain: async function*(...next){
+		yield* next
+			.reduce(function(cur, next){
+				return next(cur) }, this) },
+
+	flat: async function*(){
+		for await(var e of this){
+			if(e instanceof Array){
+				yield* e
+			} else {
+				yield e }}},
+
+	concat: async function*(other){
+		yield* this
+		yield* other },
+	push: async function*(elem){
+		yield* this
+		yield elem },
+	unsift: async function*(elem){
+		yield elem 
+		yield* this },
+
+	join: async function(){
+		return [...(await this)]
+			.join(...arguments) },
+
+	// XXX
+	// 	slice -- not sure if we need this...
+	// 	...
+})
+
+AsyncGeneratorMixin(AsyncGenerator.prototype)
+AsyncGeneratorProtoMixin(AsyncGenerator.prototype.prototype)
+
+
 
 //---------------------------------------------------------------------
 // Generators...

package/main.js

@@ -22,6 +22,7 @@ module.patchDate = require('./Date').patchDate
 
 // Additional types...
 module.containers = require('./containers')
+module.func = require('./Function')
 module.generator = require('./generator')
 module.event = require('./event')
 module.runner = require('./runner')
@@ -31,7 +32,9 @@ module.runner = require('./runner')
 module.STOP = object.STOP
 
 // frequently used stuff...
+module.AsyncFunction = module.func.AsyncFunction
 module.Generator = module.generator.Generator
+module.AsyncGenerator = module.generator.AsyncGenerator
 // XXX doc...
 module.iter = module.generator.iter
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ig-types",
-  "version": "6.15.0",
+  "version": "6.16.0",
   "description": "Generic JavaScript types and type extensions...",
   "main": "main.js",
   "scripts": {
@@ -23,7 +23,8 @@
   },
   "homepage": "https://github.com/flynx/types.js#readme",
   "dependencies": {
-    "ig-object": "^5.4.16",
+    "ig-object": "^6.0.0",
+    "ig-stoppable": "^2.0.0",
     "object-run": "^1.0.1"
   },
   "devDependencies": {