@webqit/observer 1.7.6 → 2.0.0

package/src/actors/proxy.js

@@ -1,59 +0,0 @@
-
-/**
- * @imports
- */
-import {
-    _isClass, _isFunction, _isTypeObject,
-    _getType, _internals,
-} from '@webqit/util/js/index.js';
-import apply from '../actions/apply.js';
-import construct from '../actions/construct.js';
-import defineProperty from '../actions/defineProperty.js';
-import deleteProperty from '../actions/deleteProperty.js';
-import get from '../actions/get.js';
-import getOwnPropertyDescriptor from '../actions/getOwnPropertyDescriptor.js';
-import getPrototypeOf from '../actions/getPrototypeOf.js';
-import has from '../actions/has.js';
-import isExtensible from '../actions/isExtensible.js';
-import ownKeys from '../actions/ownKeys.js';
-import preventExtensions from '../actions/preventExtensions.js';
-import set from '../actions/set.js';
-import setPrototypeOf from '../actions/setPrototypeOf.js';
-
-/**
- * Returns an object as a proxy and binds all instance methods
- * to the proxy instead of the object itself.
- *
- * @param Object|Array		target
- * @param Object		    params
- *
- * @return Proxy
- */
-export default function(target, params = {}) {
-	if (!_isTypeObject(target)) {
-		throw new Error('Object must be of type target; "' + _getType(target) + '" given!');
-    }
-    var proxy = new Proxy(target, {
-        apply:  (target, thisArgument, argumentsList) => apply(target, thisArgument, argumentsList, params),
-        construct:  (target, argumentsList, newTarget = null) => construct(target, argumentsList, newTarget, params),
-        defineProperty:  (target, propertyKey, attributes) => defineProperty(target, propertyKey, attributes, params),
-        deleteProperty: (target, propertyKey) => deleteProperty(target, propertyKey, params),
-        get: (target, propertyKey, receiver = null) => {
-            var val = get(target, propertyKey, receiver, params);
-            if (params.proxyAutoBinding !== false && _isFunction(val) && !_isClass(val)) {
-                return val.bind(proxy);
-            }
-            return val;
-        },
-        getOwnPropertyDescriptor: (target, propertyKey) => getOwnPropertyDescriptor(target, propertyKey, params),
-        getPrototypeOf: target => getPrototypeOf(target, params),
-        has: (target, propertyKey) => has(target, propertyKey, params),
-        isExtensible: target => isExtensible(target, params),
-        ownKeys: target => ownKeys(target, params),
-        preventExtensions: target => preventExtensions(target, params),
-        set: (target, propertyKey, value, receiver = null) => set(target, propertyKey, value, receiver, params),
-        setPrototypeOf: (target, prototype) => setPrototypeOf(target, prototype, params),
-    });
-    _internals(proxy).set(proxy, target);
-	return proxy;
-}

package/src/actors/unaccessorize.js

@@ -1,26 +0,0 @@
-
-/**
- * @imports
- */
-import { _isArray, _isObject, _internals } from '@webqit/util/js/index.js';
-import { _from as _arrFrom } from '@webqit/util/arr/index.js';
-
-/**
- * Removes previously initialized "Reflxive getter/setter" traps from the target.
- *
- * @param array|object	target
- * @param string|array	keys
- * @param object		params
- *
- * @return bool|array
- */
-export default function(target, keys = [], params = {}) {
-	params = _isObject(keys) ? keys : params;
-	var successFlags = (arguments.length === 1 ? Object.keys(target) : _arrFrom(keys)).map(key => {
-		if (_internals(target, 'accessorizedProps', false).has(key)) {
-			return _internals(target, 'accessorizedProps').get(key).restore();
-		}
-		return true;
-	});
-	return _isArray(keys) ? successFlags : successFlags[0];
-}

package/src/actors/unproxy.js

@@ -1,17 +0,0 @@
-
-/**
- * @imports
- */
-import { _internals } from '@webqit/util/js/index.js';
-
-/**
- * Returns the original object earlier proxied by proxy().
- *
- * @param Proxy|Any		target
- *
- * @return Any
- */
-export default function(target) {
-    // Proxy targets are mapped to their own instances internally
-    return _internals(target, false).get(target) || target;
-}

package/src/browser-entry.js

@@ -1,11 +0,0 @@
-
-/**
- * @imports
- */
-import Observer from './index.js';
-
-// As globals
-if (!window.WebQit) {
-	window.WebQit = {};
-}
-window.WebQit.Observer = Observer;

package/src/connectors/build.js

@@ -1,64 +0,0 @@
-
-/**
- * @imports
- */
-import { _isTypeObject } from '@webqit/util/js/index.js';
-import { _from as _arrFrom } from '@webqit/util/arr/index.js';
-import { _before, _after } from '@webqit/util/str/index.js';
-import { paths2D } from '../core/utils.js';
-import Observers from '../core/Observers.js';
-import _get from '../actions/get.js';
-import link from './link.js';
-
-/**
- * Recursively "connects" an object's members to the object
- * for observer actions.
- *
- * @param array|object	target
- * @param string|array	paths
- * @param bool			subtree
- * @param String		namespace
- *
- * @return void
- */
-export default function build(target, paths = null, subtree = false, namespace = null) {
-	if (!target || !_isTypeObject(target)) {
-		throw new Error('Target must be of type object!');
-	}
-	var observers = Observers.getFirebase(target, true, namespace);
-	if (!observers || observers.build) {
-		return;
-	}
-	observers.build = subtree;
-	// ---------------------------------
-	// For paths2D, refer to the comments at class Observer.
-	var _paths2D = paths2D(paths);
-	// If any path starts with a dot, (a wild card path), all keys at this level is implied
-	var rootLevelKeysToObserve = !_paths2D.length || _paths2D.filter(path => /*Starts with an empty segment*/!path[0] && path[0] !== 0).length
-		? Object.keys(target)
-		: _paths2D.map(path => path[0]);
-	var subLevelKeysToObserve = _paths2D.length ? _paths2D.map(path => path.slice(1)).filter(p => p.length) : null;
-	observers.subBuild = subLevelKeysToObserve && subLevelKeysToObserve.length ? subLevelKeysToObserve : null;
-	rootLevelKeysToObserve.forEach(key => {
-		var value = _get(target, key, null, { namespace });
-		try {
-			if (_isTypeObject(value)) {
-				link(target, key, value, null, params);
-				if ((observers.subBuild && isUserObject(value)) 
-				|| (_isFunction(subtree) ? subtree(value) : (subtree && isUserObject(value)))) {
-					build(value, observers.subBuild, subtree, namespace);
-				}
-			}
-		} catch(e) {/* instanceof-ing certain primitives may throw */}
-	});
-}
-
-/**
- * Tells if an object if a User Object.
- * 
- * @param Object value
- * 
- * @return Bool
- */
-export const isUserObject = value => ((value instanceof Object) || (value instanceof Array) || (value instanceof Function))
-	&& (typeof window === 'undefined' || value !== window);

package/src/connectors/link.js

@@ -1,76 +0,0 @@
-
-/**
- * @imports
- */
-import { _each, _merge } from '@webqit/util/obj/index.js';
-import { _isObject } from '@webqit/util/js/index.js';
-import Mutation from '../core/Mutation.js';
-import Observers from '../core/Observers.js';
-import observe from '../reactions/observe.js';
-
-/**
- * Bubble helper
- *
- * @param array|object	target
- * @param string		field
- * @param array|object	value
- * @param object		event
- * @param object		params
- *
- * @return void
- */
-export default function(target, field, value, event = null, params = {}) {
-	if (target === value) {
-		return;
-	}
-	var observers;
-	observe(value, (changes, eventObject) => {
-		if (observers = Observers.getFirebase(target, false, params.namespace)) {
-			var _changes = changes.map(delta => {
-				// ------------
-				// Recursive events must not propagate
-				// ------------
-				var d = delta;
-				do {
-					if (d.target === target) {
-						return;
-					}
-				} while(d = d.src);
-				// ------------
-				// Create propagation
-				// ------------
-				var dfn = {}; _each(delta, (key, value) => {
-					if (key !== 'target' && key !== 'name' && key !== 'path' && key !== 'src') {
-						dfn[key] = value;
-					}
-				});
-				dfn.name = field;
-				dfn.path = [field].concat(delta.path);
-				dfn.originalSubject = delta.originalSubject;
-				dfn.src = delta;
-				return new Mutation(target, dfn);
-			}).filter(c => c);
-			if (_changes.length) {
-				return observers.fire(_changes, eventObject.cancellable);
-			}
-		}
-	}, {subtree: true, ...params, unique: true, tags: [linkTag, field, target]});
-	if (_isObject(event) && (observers = Observers.getFirebase(target, false, params.namespace))) {
-		// The event object
-		var _event = _merge({
-			name: field,
-			type: 'set',
-			value,
-			related: [field],
-		}, event);
-		let eventObject = observers.fire(_event, params.cancellable);
-		if (params.eventTypeReturn) {
-			return eventObject;
-		}
-	}
-}
-
-/**
- * @var object
- */
-export const linkTag = {};

package/src/connectors/unlink.js

@@ -1,35 +0,0 @@
-
-/**
- * @imports
- */
-import { _merge } from '@webqit/util/obj/index.js';
-import { _isObject } from '@webqit/util/js/index.js';
-import Observers from '../core/Observers.js';
-import unobserve from '../reactions/unobserve.js';
-import { linkTag } from './link.js';
-
-/**
- * Unbubble helper
- *
- * @param array|object	target
- * @param string		field
- * @param array|object	object
- * @param object		event
- * @param object		params
- *
- * @return void
- */
-export default function(target, field, value, event = null, params = {}) {
-	unobserve(value, null, null, {...params, tags:[linkTag, field, target]});
-	var observers;
-	if (_isObject(event) && (observers = Observers.getFirebase(target, false, params.namespace))) {
-		// The event object
-		var _event = _merge({
-			name: field,
-			type: 'del',
-			oldValue: value,
-			related: [field],
-		}, event);
-		observers.fire(_event, params.cancellable);
-	}
-}

package/src/core/Action.js

@@ -1,33 +0,0 @@
-
-/**
- * @imports
- */
-import { _each } from '@webqit/util/obj/index.js';
-
-/**
- * ---------------------------
- * The QueryEvent class
- * ---------------------------
- */
-
-export default class Action {
-	
-	/**
-	 * Initializes the instance.
-	 *
-	 * @param array|object	target
-	 * @param object		dfn
-	 *
-	 * @return void
-	 */
-	constructor(target, dfn) {
-		this.target = target;
-		if (!dfn.type) {
-			throw new Error('Action type must be given in definition!');
-		}
-		_each(dfn, (key, value) => {
-			Object.defineProperty(this, key, {value, enumerable:true});
-		});
-		Object.seal(this);
-	}
-}

package/src/core/Delta.js

@@ -1,46 +0,0 @@
-
-/**
- * @imports
- */
-import _each from '@webqit/util/obj/each.js';
-import { DotSafePath } from './utils.js';
-
-/**
- * ---------------------------
- * The QueryEvent class
- * ---------------------------
- */
-
-export default class Delta {
-	
-	/**
-	 * Initializes the instance.
-	 *
-	 * @param array|object	target
-	 * @param object		dfn
-	 *
-	 * @return void
-	 */
-	constructor(target, dfn) {
-		this.target = target;
-		if (!dfn.originalSubject) {
-			this.originalSubject = target;
-		}
-		if (!('type' in dfn)) {
-			throw new Error('Delta type must be given in definition!');
-		}
-		if (!('name' in dfn)) {
-			throw new Error('Property name must be given in definition!');
-		}
-		_each(dfn, (key, value) => {
-			if (key === 'path') {
-				value = DotSafePath.resolve(value);
-			}
-			Object.defineProperty(this, key, {value, enumerable:true});
-		});
-		if (!this.path) {
-			Object.defineProperty(this, 'path', {value: DotSafePath.resolve([dfn.name]), enumerable:true});
-		}
-		Object.seal(this);
-	}
-}

package/src/core/Event.js

@@ -1,141 +0,0 @@
-
-/**
- * @imports
- */
-import { _isUndefined, _isObject } from '@webqit/util/js/index.js';
-import { _each } from '@webqit/util/obj/index.js';
-
-/**
- * ---------------------------
- * The Event class
- * ---------------------------
- */
-
-export default class Event {
-	
-	/**
-	 * Initializes the instance.
-	 *
-	 * @param array|object		target
-	 * @param bool				cancellable
-	 *
-	 * @return void
-	 */
-	constructor(target, cancellable = false) {
-		this._ = {};
-		this._.target = target;
-		this._.cancellable = cancellable;
-		this._.propagationStopped = false;
-		this._.defaultPrevented = false;
-		this._.promisesInstance = null;
-		this._.promises = [];
-	}
-
-	/**
-	 * Gets the "target" object.
-	 *
-	 * @return array|object
-	 */
-	get target() {
-		return this._.target;
-	}
-
-	/**
-	 * Gets the "cancellable" flag.
-	 *
-	 * @return bool
-	 */
-	get cancellable() {
-		return this._.cancellable;
-	}
-
-	/**
-	 * -----------------------
-	 * RESPONSE HANDLERS
-	 * -----------------------
-	 */
-
-	/**
-	 * Stops the evnt from reaching other listeners.
-	 *
-	 * @return bool
-	 */
-	stopPropagation() {
-		this._.propagationStopped = true;
-	}
-		
-	/**
-	 * (Readonly) tells if stopPropagation() has been called.
-	 *
-	 * @return bool
-	 */
-	get propagationStopped() {
-		return this._.propagationStopped;
-	}
-		
-	/**
-	 * Sets a disposition that asks event initiator not to
-	 * proceed with default action.
-	 *
-	 * @return void
-	 */
-	preventDefault() {
-		this._.defaultPrevented = true;
-	}
-		
-	/**
-	 * (Readonly) tells if preventDefault() has been called.
-	 *
-	 * @return bool
-	 */
-	get defaultPrevented() {
-		return this._.defaultPrevented;
-	}
-		
-	/**
-	 * Sets a Promise disposition.
-	 *
-	 * @param Promise	promise
-	 *
-	 * @return void
-	 */
-	waitUntil(promise) {
-		if (promise instanceof Promise) {
-			this._.promises.push(promise);
-			this._.promisesInstance = null;
-		}
-	}
-		
-	/**
-	 * (Readonly) returns all promises.
-	 *
-	 * @return Promise|null
-	 */
-	get promises() {
-		if (!this._.promisesInstance && this._.promises.length) {
-			this._.promisesInstance = Promise.all(this._.promises);
-		}
-		return this._.promisesInstance;
-	}
-		
-	/**
-	 * Evaluates the given disposition value and
-	 * calls an appropriate disposition method.
-	 *
-	 * @params mixed 	rspns
-	 *
-	 * @return void
-	 */
-	respondWith(rspns) {
-		var proms;
-		var isEvent = _isObject(rspns) && !_isUndefined(rspns.propagationStopped) && !_isUndefined(rspns.defaultPrevented)
-		if ((rspns === false) || (isEvent && rspns.propagationStopped)) {
-			this.stopPropagation();
-		} else if ((rspns === false) || (isEvent && rspns.defaultPrevented)) {
-			this.preventDefault();
-		} else if ((rspns instanceof Promise && (proms = rspns))
-		|| (isEvent && (proms = rspns.promises))) {
-			this.waitUntil(proms);
-		}
-	}
-}

package/src/core/Fireable.js

@@ -1,34 +0,0 @@
-
-/**
- * ---------------------------
- * The Fireable class
- * ---------------------------
- */
-
-export default class Fireable {
-	
-	/**
-	 * Initializes the instance.
-	 *
-	 * @param object|array		target
-	 * @param object			dfn
-	 *
-	 * @return void
-	 */
-	constructor(target, dfn) {
-		this.target = target;
-		this.handler = dfn.handler;
-		this.filter = dfn.filter;
-		this.params = dfn.params;
-
-	}
-
-	/**
-	 * Sets a "disconnected" flag on the Fireable.
-	 *
-	 * @return void
-	 */
-	disconnect() {
-		this.disconnected = true;
-	}
-}

package/src/core/Firebase.js

@@ -1,136 +0,0 @@
-
-/**
- * @imports
- */
-import { _isTypeObject, _isFunction, _getType, _internals } from '@webqit/util/js/index.js';
-import { _from as _arrFrom, _intersect, _equals as _arrEquals } from '@webqit/util/arr/index.js';
-import { paths2D } from './utils.js'
-
-/**
- * ---------------------------
- * The Firebase class
- * ---------------------------
- */
-
-export default class Firebase {
-	
-	/**
-	 * Initializes the instance.
-	 *
-	 * @param object	target
-	 * 
-	 * @return void
-	 */
-	constructor(target) {
-		this.target = target;
-		this.fireables = [];
-		this.currentlyFiring = [];
-	}
-	
-	/**
-	 * Adds an Fireable instance
-	 * with optional tags.
-	 *
-	 * @param Fireable			fireable
-	 *
-	 * @return Fireable
-	 */
-	add(fireable) {
-		this.fireables.push(fireable);
-		return fireable;
-	}
-	
-	/**
-	 * Removes fireables by instance.
-	 *
-	 * @param Fireable			fireable
-	 *
-	 * @return void
-	 */
-	remove(fireable) {
-		this.fireables = this.fireables.filter(_fireable => _fireable !== fireable);
-	}
-	
-	/**
-	 * Removes fireables by definition.
-	 *
-	 * @param object			dfn
-	 *
-	 * @return void
-	 */
-	removeMatches(dfn) {
-		this.match(dfn).forEach(fireable => {
-			this.fireables = this.fireables.filter(_fireable => _fireable !== fireable);
-		});
-	}
-	
-	/**
-	 * Finds fireables by definition.
-	 *
-	 * @param object			dfn
-	 *
-	 * @return array
-	 */
-	match(dfn) {
-		return this.fireables.filter(fireable => {
-			var fireableFilter = paths2D(fireable.filter);
-			var fireableTags = _arrFrom((fireable.params || {}).tags);
-			// -----------------------
-			var dfnFilter = paths2D(dfn.filter);
-			var dfnTags = _arrFrom((dfn.params || {}).tags);
-			// -----------------------
-			return (!dfn.originalHandler || fireable.handler === dfn.originalHandler)
-				&& (!dfnFilter.length || _arrEquals(dfnFilter, fireableFilter))
-				&& (!dfnTags.length || (dfnTags.length === fireableTags.length && _intersect(fireableTags, dfnTags).length === dfnTags.length));
-		});
-	}
-		
-	/**
-	 * Returns a observer-specific object embedded on an element.
-	 *
-	 * @param string		type
-	 * @param array|object	target
-	 * @param bool      	createIfNotExists
-	 * @param string      	namespace
-	 *
-	 * @return Firebase
-	 */
-	static _getFirebase(type, target, createIfNotExists = true, namespace = this.__namespace) {
-		if (!_isTypeObject(target)) {
-			throw new Error('Subject must be of type object; "' + _getType(target) + '" given!');
-		}
-		var ImplementationClass = this;
-		if (namespace && globalThis.WebQitObserverNamespaceRegistry.has(type + '-' + namespace)) {
-			ImplementationClass = globalThis.WebQitObserverNamespaceRegistry.get(type + '-' + namespace);
-			type += '-' + namespace
-		}
-		if (!_internals(target, 'firebases').has(type) && createIfNotExists) {
-			_internals(target, 'firebases').set(type, new ImplementationClass(target));
-		}
-		return _internals(target, 'firebases').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 globalThis.WebQitObserverNamespaceRegistry.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}.`);
-		}
-		globalThis.WebQitObserverNamespaceRegistry.set(type, ImplementationClass);
-		ImplementationClass.__namespace = namespace;
-	}
-}
-
-if (!globalThis.WebQitObserverNamespaceRegistry) {
-	globalThis.WebQitObserverNamespaceRegistry = new Map();
-}