@webqit/observer 2.0.7 → 2.1.0

package/src/core/ListenerRegistry.js

@@ -1,71 +1,74 @@
-
-/**
- * @imports
- */
-import ListenerRegistration from './ListenerRegistration.js';
-import Registry from './Registry.js';
-
-/**
- * ---------------------------
- * The ListenerRegistry class
- * ---------------------------
- */
-
-export default class ListenerRegistry extends Registry {
-
-	static getInstance( target, createIfNotExists = true, namespace = null ) {
-		return super._getInstance( 'listeners', ...arguments );
-	}
-
-	static namespace( namespace, ImplementationClass = null ) {
-		return super._namespace( 'listeners', ...arguments );
-	}
-
-	/**
-	 * @constructor
-	 */
-	constructor( target ) {
-		super( target );
-		this.batches = [];
-	}
-	
-	/**
-	 * @addRegistration
-	 */
-	addRegistration( filter, handler, params ) {
-		return super.addRegistration( new ListenerRegistration( this, { filter, handler, params } ) );
-	}
-	
-	/**
-	 * Fires all observers with the given evt (change).
-	 *
-	 * @param Arrayn events
-	 *
-	 * @return Void
-	 */
-	emit( events ) {
-		if ( this.batches.length ) {
-			this.batches[ 0 ].events.push( ...events );
-			return
-		}
-		this.entries.forEach( listener => listener.fire( events ) );
-	}
-
-	/**
-	 * Fires all observers with the given evt (change).
-	 *
-	 * @param Arrayn events
-	 *
-	 * @return Void
-	 */
-	batch( callback ) {
-		this.batches.unshift( { entries: [ ...this.entries ], events: [] } );
-		const returnValue = callback();
-		const batch = this.batches.shift();
-		if ( batch.events.length ) {
-			batch.entries.forEach( listener => listener.fire( batch.events ) );
-		}
-		return returnValue;
-	}
-
+
+/**
+ * @imports
+ */
+import ListenerRegistration from './ListenerRegistration.js';
+import Registry from './Registry.js';
+import { _await } from '../util.js';
+
+/**
+ * ---------------------------
+ * The ListenerRegistry class
+ * ---------------------------
+ */
+
+export default class ListenerRegistry extends Registry {
+
+	static getInstance( target, createIfNotExists = true, namespace = null ) {
+		return super._getInstance( 'listeners', ...arguments );
+	}
+
+	static namespace( namespace, ImplementationClass = null ) {
+		return super._namespace( 'listeners', ...arguments );
+	}
+
+	/**
+	 * @constructor
+	 */
+	constructor( target ) {
+		super( target );
+		this.batches = [];
+	}
+	
+	/**
+	 * @addRegistration
+	 */
+	addRegistration( filter, handler, params ) {
+		return super.addRegistration( new ListenerRegistration( this, { filter, handler, params } ) );
+	}
+	
+	/**
+	 * Fires all observers with the given evt (change).
+	 *
+	 * @param Arrayn events
+	 *
+	 * @return Void
+	 */
+	emit( events ) {
+		if ( this.batches.length ) {
+			this.batches[ 0 ].events.push( ...events );
+			return
+		}
+		this.entries.forEach( listener => listener.fire( events ) );
+	}
+
+	/**
+	 * Fires all observers with the given evt (change).
+	 *
+	 * @param Arrayn events
+	 *
+	 * @return Void
+	 */
+	batch( callback ) {
+		this.batches.unshift( { entries: [ ...this.entries ], events: [] } );
+		const returnValue = callback();
+		return _await( returnValue, returnValue => {
+			const batch = this.batches.shift();
+			if ( batch.events.length ) {
+				batch.entries.forEach( listener => listener.fire( batch.events ) );
+			}
+			return returnValue;
+		} )
+	}
+
 }

package/src/core/Registration.js

@@ -1,35 +1,35 @@
-
-/**
- * ---------------------------
- * The Registration class
- * ---------------------------
- */
-
-export default class Registration {
-	
-	/**
-	 * Initializes the instance.
-	 *
-	 * @param Registry			registry
-	 * @param object			dfn
-	 *
-	 * @return void
-	 */
-	constructor( registry, dfn ) {
-		this.registry = registry;
-		Object.assign( this, { ...dfn, target: registry.target } );
-		if ( this.params.signal ) {
-			this.params.signal.addEventListener( 'abort', () => this.remove() );
-		}
-	}
-
-	/**
-	 * Sets a "disconnected" flag on the Registration.
-	 *
-	 * @return void
-	 */
-	remove() {
-		this.removed = true;
-		return this.registry.removeRegistration( this );
-	}
+
+/**
+ * ---------------------------
+ * The Registration class
+ * ---------------------------
+ */
+
+export default class Registration {
+	
+	/**
+	 * Initializes the instance.
+	 *
+	 * @param Registry			registry
+	 * @param object			dfn
+	 *
+	 * @return void
+	 */
+	constructor( registry, dfn ) {
+		this.registry = registry;
+		Object.assign( this, { ...dfn, target: registry.target } );
+		if ( this.params.signal ) {
+			this.params.signal.addEventListener( 'abort', () => this.remove() );
+		}
+	}
+
+	/**
+	 * Sets a "disconnected" flag on the Registration.
+	 *
+	 * @return void
+	 */
+	remove() {
+		this.removed = true;
+		return this.registry.removeRegistration( this );
+	}
 }

package/src/core/Registry.js

@@ -1,93 +1,93 @@
-
-/**
- * @imports
- */
-import { _isTypeObject, _getType } from '@webqit/util/js/index.js';
-import { _from as _arrFrom, _intersect, _equals as _arrEquals } from '@webqit/util/arr/index.js';
-import { _ } from '../util.js';
-
-/**
- * ---------------------------
- * The Registry class
- * ---------------------------
- */
-
-export default class Registry {
-	
-	/**
-	 * Initializes the instance.
-	 *
-	 * @param object	target
-	 * 
-	 * @return void
-	 */
-	constructor( target ) {
-		this.target = target;
-		this.entries = [];
-	}
-	
-	/**
-	 * Adds an Registration instance
-	 * with optional tags.
-	 *
-	 * @param Registration		registration
-	 *
-	 * @return Registration
-	 */
-	addRegistration( registration ) {
-		this.entries.push( registration );
-		return registration;
-	}
-	
-	/**
-	 * Removes registrations by reference.
-	 *
-	 * @param Registration		registration
-	 *
-	 * @return void
-	 */
-	removeRegistration( registration ) {
-		this.entries = this.entries.filter( _entry => _entry !== registration );
-	}
-		
-	/**
-	 * Returns a observer-specific object embedded on an element.
-	 *
-	 * @param string		type
-	 * @param array|object	target
-	 * @param bool      	createIfNotExists
-	 * @param string      	namespace
-	 *
-	 * @return Registry
-	 */
-	static _getInstance( type, target, createIfNotExists = true, namespace = this.__namespace ) {
-		if ( !_isTypeObject( target ) ) throw new Error( `Subject must be of type object; "${ _getType( target ) }" given!` );
-		let ImplementationClass = this;
-		if ( namespace && _( 'namespaces' ).has( type + '-' + namespace ) ) {
-			ImplementationClass = _( 'namespaces' ).get( type + '-' + namespace );
-			type += '-' + namespace
-		}
-		if ( !_( target, 'registry' ).has( type ) && createIfNotExists ) {
-			_( target, 'registry' ).set( type, new ImplementationClass( target ) );
-		}
-		return _( target, 'registry' ).get( type );
-	}
-
-	/**
-	 * Extend a Fireable Class with a namespace.
-	 *
-	 * @param string		namespace
-	 * @param class      	ImplementationClass
-	 *
-	 * @return void|class
-	 */
-	static _namespace( type, namespace, ImplementationClass = null ) {
-		type += '-' + namespace;
-		if ( arguments.length === 2 ) return _( 'namespaces' ).get( type );
-		if ( !( ImplementationClass.prototype instanceof this ) ) {
-			throw new Error( `The implementation of the namespace ${ this.name }.${ namespace } must be a subclass of ${ this.name }.` );
-		}
-		_( 'namespaces' ).set( type, ImplementationClass );
-		ImplementationClass.__namespace = namespace;
-	}
+
+/**
+ * @imports
+ */
+import { _isTypeObject, _getType } from '@webqit/util/js/index.js';
+import { _from as _arrFrom, _intersect, _equals as _arrEquals } from '@webqit/util/arr/index.js';
+import { _ } from '../util.js';
+
+/**
+ * ---------------------------
+ * The Registry class
+ * ---------------------------
+ */
+
+export default class Registry {
+	
+	/**
+	 * Initializes the instance.
+	 *
+	 * @param object	target
+	 * 
+	 * @return void
+	 */
+	constructor( target ) {
+		this.target = target;
+		this.entries = [];
+	}
+	
+	/**
+	 * Adds an Registration instance
+	 * with optional tags.
+	 *
+	 * @param Registration		registration
+	 *
+	 * @return Registration
+	 */
+	addRegistration( registration ) {
+		this.entries.push( registration );
+		return registration;
+	}
+	
+	/**
+	 * Removes registrations by reference.
+	 *
+	 * @param Registration		registration
+	 *
+	 * @return void
+	 */
+	removeRegistration( registration ) {
+		this.entries = this.entries.filter( _entry => _entry !== registration );
+	}
+		
+	/**
+	 * Returns a observer-specific object embedded on an element.
+	 *
+	 * @param string		type
+	 * @param array|object	target
+	 * @param bool      	createIfNotExists
+	 * @param string      	namespace
+	 *
+	 * @return Registry
+	 */
+	static _getInstance( type, target, createIfNotExists = true, namespace = this.__namespace ) {
+		if ( !_isTypeObject( target ) ) throw new Error( `Subject must be of type object; "${ _getType( target ) }" given!` );
+		let ImplementationClass = this;
+		if ( namespace && _( 'namespaces' ).has( type + '-' + namespace ) ) {
+			ImplementationClass = _( 'namespaces' ).get( type + '-' + namespace );
+			type += '-' + namespace
+		}
+		if ( !_( target, 'registry' ).has( type ) && createIfNotExists ) {
+			_( target, 'registry' ).set( type, new ImplementationClass( target ) );
+		}
+		return _( target, 'registry' ).get( type );
+	}
+
+	/**
+	 * Extend a Fireable Class with a namespace.
+	 *
+	 * @param string		namespace
+	 * @param class      	ImplementationClass
+	 *
+	 * @return void|class
+	 */
+	static _namespace( type, namespace, ImplementationClass = null ) {
+		type += '-' + namespace;
+		if ( arguments.length === 2 ) return _( 'namespaces' ).get( type );
+		if ( !( ImplementationClass.prototype instanceof this ) ) {
+			throw new Error( `The implementation of the namespace ${ this.name }.${ namespace } must be a subclass of ${ this.name }.` );
+		}
+		_( 'namespaces' ).set( type, ImplementationClass );
+		ImplementationClass.__namespace = namespace;
+	}
 }

package/src/core/TrapsRegistration.js

@@ -1,35 +1,35 @@
-
-/**
- * @imports
- */
-import Registration from './Registration.js';
-
-/**
- * ---------------------------
- * The TrapsRegistration class
- * ---------------------------
- */
-
-export default class TrapsRegistration extends Registration {
-	
-	/**
-	 * Calls the observer's handler function
-	 * on matching with the descriptor's fields.
-	 *
-	 * @param Descriptor			 	descriptor
-	 * @param function					next
-	 * @param mixed					 	recieved
-	 *
-	 * @return void
-	 */
-	exec( descriptor, next, recieved ) {
-		if ( this.running || !this.traps[ descriptor.type ] ) {
-			return next( ...Array.prototype.slice.call( arguments, 2 ) );
-		}
-		this.running = true;
-		return this.traps[ descriptor.type ]( descriptor, recieved, ( ...args ) => {
-			this.running = false;
-			return next( ...args );
-		} );
-	}
+
+/**
+ * @imports
+ */
+import Registration from './Registration.js';
+
+/**
+ * ---------------------------
+ * The TrapsRegistration class
+ * ---------------------------
+ */
+
+export default class TrapsRegistration extends Registration {
+	
+	/**
+	 * Calls the observer's handler function
+	 * on matching with the descriptor's fields.
+	 *
+	 * @param Descriptor			 	descriptor
+	 * @param function					next
+	 * @param mixed					 	recieved
+	 *
+	 * @return void
+	 */
+	exec( descriptor, next, recieved ) {
+		if ( this.running || !this.traps[ descriptor.type ] ) {
+			return next( ...Array.prototype.slice.call( arguments, 2 ) );
+		}
+		this.running = true;
+		return this.traps[ descriptor.type ]( descriptor, recieved, ( ...args ) => {
+			this.running = false;
+			return next( ...args );
+		} );
+	}
 }

package/src/core/TrapsRegistry.js

@@ -1,51 +1,51 @@
-
-/**
- * @imports
- */
-import TrapsRegistration from './TrapsRegistration.js';
-import Registry from './Registry.js';
-
-/**
- * ---------------------------
- * The TrapsRegistry class
- * ---------------------------
- */
-
-export default class TrapsRegistry extends Registry {
-
-	static getInstance( target, createIfNotExists = true, namespace = null ) {
-		return super._getInstance( 'traps', ...arguments );
-	}
-
-	static namespace( namespace, ImplementationClass = null ) {
-		return super._namespace( 'traps', ...arguments );
-	}
-	
-	/**
-	 * @inheritdoc
-	 */
-	addRegistration( dfn ) {
-		return super.addRegistration( new TrapsRegistration( this, dfn ) );
-	}
-
-	/**
-	 * Fires all interceptors with the given action.
-	 *
-	 * @param Descriptor		descriptor
-	 * @param function			defaultHandler
-	 *
-	 * @return mixed
-	 */
-	emit( descriptor, defaultHandler = null ) {
-		const $this = this;
-		return ( function next( index, ..._args ) {
-			const registration = $this.entries[ index ];
-			if ( registration ) {
-				return registration.exec( descriptor, ( ...args ) => {
-					return next( index + 1, ...args );
-				}/*next*/, ..._args );
-			}
-			return defaultHandler ? defaultHandler( descriptor, ..._args ) : _args[ 0 ];
-		} )( 0 );
-	}
+
+/**
+ * @imports
+ */
+import TrapsRegistration from './TrapsRegistration.js';
+import Registry from './Registry.js';
+
+/**
+ * ---------------------------
+ * The TrapsRegistry class
+ * ---------------------------
+ */
+
+export default class TrapsRegistry extends Registry {
+
+	static getInstance( target, createIfNotExists = true, namespace = null ) {
+		return super._getInstance( 'traps', ...arguments );
+	}
+
+	static namespace( namespace, ImplementationClass = null ) {
+		return super._namespace( 'traps', ...arguments );
+	}
+	
+	/**
+	 * @inheritdoc
+	 */
+	addRegistration( dfn ) {
+		return super.addRegistration( new TrapsRegistration( this, dfn ) );
+	}
+
+	/**
+	 * Fires all interceptors with the given action.
+	 *
+	 * @param Descriptor		descriptor
+	 * @param function			defaultHandler
+	 *
+	 * @return mixed
+	 */
+	emit( descriptor, defaultHandler = null ) {
+		const $this = this;
+		return ( function next( index, ..._args ) {
+			const registration = $this.entries[ index ];
+			if ( registration ) {
+				return registration.exec( descriptor, ( ...args ) => {
+					return next( index + 1, ...args );
+				}/*next*/, ..._args );
+			}
+			return defaultHandler ? defaultHandler( descriptor, ..._args ) : _args[ 0 ];
+		} )( 0 );
+	}
 }

package/src/index.js

@@ -1,10 +1,10 @@
-
-/**
- * @imports
- */
-import * as main from './main.js';
-import * as actors from './actors.js';
-
-const Observer = { ...main, ...actors };
-
+
+/**
+ * @imports
+ */
+import * as main from './main.js';
+import * as actors from './actors.js';
+
+const Observer = { ...main, ...actors };
+
 export default Observer;