--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cm/media/js/lib/yui/yui_3.10.3/build/event-custom-base/event-custom-base-debug.js Tue Jul 16 14:29:46 2013 +0200
@@ -0,0 +1,2480 @@
+/*
+YUI 3.10.3 (build 2fb5187)
+Copyright 2013 Yahoo! Inc. All rights reserved.
+Licensed under the BSD License.
+http://yuilibrary.com/license/
+*/
+
+YUI.add('event-custom-base', function (Y, NAME) {
+
+/**
+ * Custom event engine, DOM event listener abstraction layer, synthetic DOM
+ * events.
+ * @module event-custom
+ */
+
+Y.Env.evt = {
+ handles: {},
+ plugins: {}
+};
+
+
+/**
+ * Custom event engine, DOM event listener abstraction layer, synthetic DOM
+ * events.
+ * @module event-custom
+ * @submodule event-custom-base
+ */
+
+/**
+ * Allows for the insertion of methods that are executed before or after
+ * a specified method
+ * @class Do
+ * @static
+ */
+
+var DO_BEFORE = 0,
+ DO_AFTER = 1,
+
+DO = {
+
+ /**
+ * Cache of objects touched by the utility
+ * @property objs
+ * @static
+ * @deprecated Since 3.6.0. The `_yuiaop` property on the AOP'd object
+ * replaces the role of this property, but is considered to be private, and
+ * is only mentioned to provide a migration path.
+ *
+ * If you have a use case which warrants migration to the _yuiaop property,
+ * please file a ticket to let us know what it's used for and we can see if
+ * we need to expose hooks for that functionality more formally.
+ */
+ objs: null,
+
+ /**
+ * <p>Execute the supplied method before the specified function. Wrapping
+ * function may optionally return an instance of the following classes to
+ * further alter runtime behavior:</p>
+ * <dl>
+ * <dt></code>Y.Do.Halt(message, returnValue)</code></dt>
+ * <dd>Immediatly stop execution and return
+ * <code>returnValue</code>. No other wrapping functions will be
+ * executed.</dd>
+ * <dt></code>Y.Do.AlterArgs(message, newArgArray)</code></dt>
+ * <dd>Replace the arguments that the original function will be
+ * called with.</dd>
+ * <dt></code>Y.Do.Prevent(message)</code></dt>
+ * <dd>Don't execute the wrapped function. Other before phase
+ * wrappers will be executed.</dd>
+ * </dl>
+ *
+ * @method before
+ * @param fn {Function} the function to execute
+ * @param obj the object hosting the method to displace
+ * @param sFn {string} the name of the method to displace
+ * @param c The execution context for fn
+ * @param arg* {mixed} 0..n additional arguments to supply to the subscriber
+ * when the event fires.
+ * @return {string} handle for the subscription
+ * @static
+ */
+ before: function(fn, obj, sFn, c) {
+ // Y.log('Do before: ' + sFn, 'info', 'event');
+ var f = fn, a;
+ if (c) {
+ a = [fn, c].concat(Y.Array(arguments, 4, true));
+ f = Y.rbind.apply(Y, a);
+ }
+
+ return this._inject(DO_BEFORE, f, obj, sFn);
+ },
+
+ /**
+ * <p>Execute the supplied method after the specified function. Wrapping
+ * function may optionally return an instance of the following classes to
+ * further alter runtime behavior:</p>
+ * <dl>
+ * <dt></code>Y.Do.Halt(message, returnValue)</code></dt>
+ * <dd>Immediatly stop execution and return
+ * <code>returnValue</code>. No other wrapping functions will be
+ * executed.</dd>
+ * <dt></code>Y.Do.AlterReturn(message, returnValue)</code></dt>
+ * <dd>Return <code>returnValue</code> instead of the wrapped
+ * method's original return value. This can be further altered by
+ * other after phase wrappers.</dd>
+ * </dl>
+ *
+ * <p>The static properties <code>Y.Do.originalRetVal</code> and
+ * <code>Y.Do.currentRetVal</code> will be populated for reference.</p>
+ *
+ * @method after
+ * @param fn {Function} the function to execute
+ * @param obj the object hosting the method to displace
+ * @param sFn {string} the name of the method to displace
+ * @param c The execution context for fn
+ * @param arg* {mixed} 0..n additional arguments to supply to the subscriber
+ * @return {string} handle for the subscription
+ * @static
+ */
+ after: function(fn, obj, sFn, c) {
+ var f = fn, a;
+ if (c) {
+ a = [fn, c].concat(Y.Array(arguments, 4, true));
+ f = Y.rbind.apply(Y, a);
+ }
+
+ return this._inject(DO_AFTER, f, obj, sFn);
+ },
+
+ /**
+ * Execute the supplied method before or after the specified function.
+ * Used by <code>before</code> and <code>after</code>.
+ *
+ * @method _inject
+ * @param when {string} before or after
+ * @param fn {Function} the function to execute
+ * @param obj the object hosting the method to displace
+ * @param sFn {string} the name of the method to displace
+ * @param c The execution context for fn
+ * @return {string} handle for the subscription
+ * @private
+ * @static
+ */
+ _inject: function(when, fn, obj, sFn) {
+ // object id
+ var id = Y.stamp(obj), o, sid;
+
+ if (!obj._yuiaop) {
+ // create a map entry for the obj if it doesn't exist, to hold overridden methods
+ obj._yuiaop = {};
+ }
+
+ o = obj._yuiaop;
+
+ if (!o[sFn]) {
+ // create a map entry for the method if it doesn't exist
+ o[sFn] = new Y.Do.Method(obj, sFn);
+
+ // re-route the method to our wrapper
+ obj[sFn] = function() {
+ return o[sFn].exec.apply(o[sFn], arguments);
+ };
+ }
+
+ // subscriber id
+ sid = id + Y.stamp(fn) + sFn;
+
+ // register the callback
+ o[sFn].register(sid, fn, when);
+
+ return new Y.EventHandle(o[sFn], sid);
+ },
+
+ /**
+ * Detach a before or after subscription.
+ *
+ * @method detach
+ * @param handle {string} the subscription handle
+ * @static
+ */
+ detach: function(handle) {
+ if (handle.detach) {
+ handle.detach();
+ }
+ }
+};
+
+Y.Do = DO;
+
+//////////////////////////////////////////////////////////////////////////
+
+/**
+ * Contains the return value from the wrapped method, accessible
+ * by 'after' event listeners.
+ *
+ * @property originalRetVal
+ * @static
+ * @since 3.2.0
+ */
+
+/**
+ * Contains the current state of the return value, consumable by
+ * 'after' event listeners, and updated if an after subscriber
+ * changes the return value generated by the wrapped function.
+ *
+ * @property currentRetVal
+ * @static
+ * @since 3.2.0
+ */
+
+//////////////////////////////////////////////////////////////////////////
+
+/**
+ * Wrapper for a displaced method with aop enabled
+ * @class Do.Method
+ * @constructor
+ * @param obj The object to operate on
+ * @param sFn The name of the method to displace
+ */
+DO.Method = function(obj, sFn) {
+ this.obj = obj;
+ this.methodName = sFn;
+ this.method = obj[sFn];
+ this.before = {};
+ this.after = {};
+};
+
+/**
+ * Register a aop subscriber
+ * @method register
+ * @param sid {string} the subscriber id
+ * @param fn {Function} the function to execute
+ * @param when {string} when to execute the function
+ */
+DO.Method.prototype.register = function (sid, fn, when) {
+ if (when) {
+ this.after[sid] = fn;
+ } else {
+ this.before[sid] = fn;
+ }
+};
+
+/**
+ * Unregister a aop subscriber
+ * @method delete
+ * @param sid {string} the subscriber id
+ * @param fn {Function} the function to execute
+ * @param when {string} when to execute the function
+ */
+DO.Method.prototype._delete = function (sid) {
+ // Y.log('Y.Do._delete: ' + sid, 'info', 'Event');
+ delete this.before[sid];
+ delete this.after[sid];
+};
+
+/**
+ * <p>Execute the wrapped method. All arguments are passed into the wrapping
+ * functions. If any of the before wrappers return an instance of
+ * <code>Y.Do.Halt</code> or <code>Y.Do.Prevent</code>, neither the wrapped
+ * function nor any after phase subscribers will be executed.</p>
+ *
+ * <p>The return value will be the return value of the wrapped function or one
+ * provided by a wrapper function via an instance of <code>Y.Do.Halt</code> or
+ * <code>Y.Do.AlterReturn</code>.
+ *
+ * @method exec
+ * @param arg* {any} Arguments are passed to the wrapping and wrapped functions
+ * @return {any} Return value of wrapped function unless overwritten (see above)
+ */
+DO.Method.prototype.exec = function () {
+
+ var args = Y.Array(arguments, 0, true),
+ i, ret, newRet,
+ bf = this.before,
+ af = this.after,
+ prevented = false;
+
+ // execute before
+ for (i in bf) {
+ if (bf.hasOwnProperty(i)) {
+ ret = bf[i].apply(this.obj, args);
+ if (ret) {
+ switch (ret.constructor) {
+ case DO.Halt:
+ return ret.retVal;
+ case DO.AlterArgs:
+ args = ret.newArgs;
+ break;
+ case DO.Prevent:
+ prevented = true;
+ break;
+ default:
+ }
+ }
+ }
+ }
+
+ // execute method
+ if (!prevented) {
+ ret = this.method.apply(this.obj, args);
+ }
+
+ DO.originalRetVal = ret;
+ DO.currentRetVal = ret;
+
+ // execute after methods.
+ for (i in af) {
+ if (af.hasOwnProperty(i)) {
+ newRet = af[i].apply(this.obj, args);
+ // Stop processing if a Halt object is returned
+ if (newRet && newRet.constructor === DO.Halt) {
+ return newRet.retVal;
+ // Check for a new return value
+ } else if (newRet && newRet.constructor === DO.AlterReturn) {
+ ret = newRet.newRetVal;
+ // Update the static retval state
+ DO.currentRetVal = ret;
+ }
+ }
+ }
+
+ return ret;
+};
+
+//////////////////////////////////////////////////////////////////////////
+
+/**
+ * Return an AlterArgs object when you want to change the arguments that
+ * were passed into the function. Useful for Do.before subscribers. An
+ * example would be a service that scrubs out illegal characters prior to
+ * executing the core business logic.
+ * @class Do.AlterArgs
+ * @constructor
+ * @param msg {String} (optional) Explanation of the altered return value
+ * @param newArgs {Array} Call parameters to be used for the original method
+ * instead of the arguments originally passed in.
+ */
+DO.AlterArgs = function(msg, newArgs) {
+ this.msg = msg;
+ this.newArgs = newArgs;
+};
+
+/**
+ * Return an AlterReturn object when you want to change the result returned
+ * from the core method to the caller. Useful for Do.after subscribers.
+ * @class Do.AlterReturn
+ * @constructor
+ * @param msg {String} (optional) Explanation of the altered return value
+ * @param newRetVal {any} Return value passed to code that invoked the wrapped
+ * function.
+ */
+DO.AlterReturn = function(msg, newRetVal) {
+ this.msg = msg;
+ this.newRetVal = newRetVal;
+};
+
+/**
+ * Return a Halt object when you want to terminate the execution
+ * of all subsequent subscribers as well as the wrapped method
+ * if it has not exectued yet. Useful for Do.before subscribers.
+ * @class Do.Halt
+ * @constructor
+ * @param msg {String} (optional) Explanation of why the termination was done
+ * @param retVal {any} Return value passed to code that invoked the wrapped
+ * function.
+ */
+DO.Halt = function(msg, retVal) {
+ this.msg = msg;
+ this.retVal = retVal;
+};
+
+/**
+ * Return a Prevent object when you want to prevent the wrapped function
+ * from executing, but want the remaining listeners to execute. Useful
+ * for Do.before subscribers.
+ * @class Do.Prevent
+ * @constructor
+ * @param msg {String} (optional) Explanation of why the termination was done
+ */
+DO.Prevent = function(msg) {
+ this.msg = msg;
+};
+
+/**
+ * Return an Error object when you want to terminate the execution
+ * of all subsequent method calls.
+ * @class Do.Error
+ * @constructor
+ * @param msg {String} (optional) Explanation of the altered return value
+ * @param retVal {any} Return value passed to code that invoked the wrapped
+ * function.
+ * @deprecated use Y.Do.Halt or Y.Do.Prevent
+ */
+DO.Error = DO.Halt;
+
+
+//////////////////////////////////////////////////////////////////////////
+
+/**
+ * Custom event engine, DOM event listener abstraction layer, synthetic DOM
+ * events.
+ * @module event-custom
+ * @submodule event-custom-base
+ */
+
+
+// var onsubscribeType = "_event:onsub",
+var YArray = Y.Array,
+
+ AFTER = 'after',
+ CONFIGS = [
+ 'broadcast',
+ 'monitored',
+ 'bubbles',
+ 'context',
+ 'contextFn',
+ 'currentTarget',
+ 'defaultFn',
+ 'defaultTargetOnly',
+ 'details',
+ 'emitFacade',
+ 'fireOnce',
+ 'async',
+ 'host',
+ 'preventable',
+ 'preventedFn',
+ 'queuable',
+ 'silent',
+ 'stoppedFn',
+ 'target',
+ 'type'
+ ],
+
+ CONFIGS_HASH = YArray.hash(CONFIGS),
+
+ nativeSlice = Array.prototype.slice,
+
+ YUI3_SIGNATURE = 9,
+ YUI_LOG = 'yui:log',
+
+ mixConfigs = function(r, s, ov) {
+ var p;
+
+ for (p in s) {
+ if (CONFIGS_HASH[p] && (ov || !(p in r))) {
+ r[p] = s[p];
+ }
+ }
+
+ return r;
+ };
+
+/**
+ * The CustomEvent class lets you define events for your application
+ * that can be subscribed to by one or more independent component.
+ *
+ * @param {String} type The type of event, which is passed to the callback
+ * when the event fires.
+ * @param {object} defaults configuration object.
+ * @class CustomEvent
+ * @constructor
+ */
+
+ /**
+ * The type of event, returned to subscribers when the event fires
+ * @property type
+ * @type string
+ */
+
+/**
+ * By default all custom events are logged in the debug build, set silent
+ * to true to disable debug outpu for this event.
+ * @property silent
+ * @type boolean
+ */
+
+Y.CustomEvent = function(type, defaults) {
+
+ this._kds = Y.CustomEvent.keepDeprecatedSubs;
+
+ this.id = Y.guid();
+
+ this.type = type;
+ this.silent = this.logSystem = (type === YUI_LOG);
+
+ if (this._kds) {
+ /**
+ * The subscribers to this event
+ * @property subscribers
+ * @type Subscriber {}
+ * @deprecated
+ */
+
+ /**
+ * 'After' subscribers
+ * @property afters
+ * @type Subscriber {}
+ * @deprecated
+ */
+ this.subscribers = {};
+ this.afters = {};
+ }
+
+ if (defaults) {
+ mixConfigs(this, defaults, true);
+ }
+};
+
+/**
+ * Static flag to enable population of the <a href="#property_subscribers">`subscribers`</a>
+ * and <a href="#property_subscribers">`afters`</a> properties held on a `CustomEvent` instance.
+ *
+ * These properties were changed to private properties (`_subscribers` and `_afters`), and
+ * converted from objects to arrays for performance reasons.
+ *
+ * Setting this property to true will populate the deprecated `subscribers` and `afters`
+ * properties for people who may be using them (which is expected to be rare). There will
+ * be a performance hit, compared to the new array based implementation.
+ *
+ * If you are using these deprecated properties for a use case which the public API
+ * does not support, please file an enhancement request, and we can provide an alternate
+ * public implementation which doesn't have the performance cost required to maintiain the
+ * properties as objects.
+ *
+ * @property keepDeprecatedSubs
+ * @static
+ * @for CustomEvent
+ * @type boolean
+ * @default false
+ * @deprecated
+ */
+Y.CustomEvent.keepDeprecatedSubs = false;
+
+Y.CustomEvent.mixConfigs = mixConfigs;
+
+Y.CustomEvent.prototype = {
+
+ constructor: Y.CustomEvent,
+
+ /**
+ * Monitor when an event is attached or detached.
+ *
+ * @property monitored
+ * @type boolean
+ */
+
+ /**
+ * If 0, this event does not broadcast. If 1, the YUI instance is notified
+ * every time this event fires. If 2, the YUI instance and the YUI global
+ * (if event is enabled on the global) are notified every time this event
+ * fires.
+ * @property broadcast
+ * @type int
+ */
+
+ /**
+ * Specifies whether this event should be queued when the host is actively
+ * processing an event. This will effect exectution order of the callbacks
+ * for the various events.
+ * @property queuable
+ * @type boolean
+ * @default false
+ */
+
+ /**
+ * This event has fired if true
+ *
+ * @property fired
+ * @type boolean
+ * @default false;
+ */
+
+ /**
+ * An array containing the arguments the custom event
+ * was last fired with.
+ * @property firedWith
+ * @type Array
+ */
+
+ /**
+ * This event should only fire one time if true, and if
+ * it has fired, any new subscribers should be notified
+ * immediately.
+ *
+ * @property fireOnce
+ * @type boolean
+ * @default false;
+ */
+
+ /**
+ * fireOnce listeners will fire syncronously unless async
+ * is set to true
+ * @property async
+ * @type boolean
+ * @default false
+ */
+
+ /**
+ * Flag for stopPropagation that is modified during fire()
+ * 1 means to stop propagation to bubble targets. 2 means
+ * to also stop additional subscribers on this target.
+ * @property stopped
+ * @type int
+ */
+
+ /**
+ * Flag for preventDefault that is modified during fire().
+ * if it is not 0, the default behavior for this event
+ * @property prevented
+ * @type int
+ */
+
+ /**
+ * Specifies the host for this custom event. This is used
+ * to enable event bubbling
+ * @property host
+ * @type EventTarget
+ */
+
+ /**
+ * The default function to execute after event listeners
+ * have fire, but only if the default action was not
+ * prevented.
+ * @property defaultFn
+ * @type Function
+ */
+
+ /**
+ * The function to execute if a subscriber calls
+ * stopPropagation or stopImmediatePropagation
+ * @property stoppedFn
+ * @type Function
+ */
+
+ /**
+ * The function to execute if a subscriber calls
+ * preventDefault
+ * @property preventedFn
+ * @type Function
+ */
+
+ /**
+ * The subscribers to this event
+ * @property _subscribers
+ * @type Subscriber []
+ * @private
+ */
+
+ /**
+ * 'After' subscribers
+ * @property _afters
+ * @type Subscriber []
+ * @private
+ */
+
+ /**
+ * If set to true, the custom event will deliver an EventFacade object
+ * that is similar to a DOM event object.
+ * @property emitFacade
+ * @type boolean
+ * @default false
+ */
+
+ /**
+ * Supports multiple options for listener signatures in order to
+ * port YUI 2 apps.
+ * @property signature
+ * @type int
+ * @default 9
+ */
+ signature : YUI3_SIGNATURE,
+
+ /**
+ * The context the the event will fire from by default. Defaults to the YUI
+ * instance.
+ * @property context
+ * @type object
+ */
+ context : Y,
+
+ /**
+ * Specifies whether or not this event's default function
+ * can be cancelled by a subscriber by executing preventDefault()
+ * on the event facade
+ * @property preventable
+ * @type boolean
+ * @default true
+ */
+ preventable : true,
+
+ /**
+ * Specifies whether or not a subscriber can stop the event propagation
+ * via stopPropagation(), stopImmediatePropagation(), or halt()
+ *
+ * Events can only bubble if emitFacade is true.
+ *
+ * @property bubbles
+ * @type boolean
+ * @default true
+ */
+ bubbles : true,
+
+ /**
+ * Returns the number of subscribers for this event as the sum of the on()
+ * subscribers and after() subscribers.
+ *
+ * @method hasSubs
+ * @return Number
+ */
+ hasSubs: function(when) {
+ var s = 0,
+ a = 0,
+ subs = this._subscribers,
+ afters = this._afters,
+ sib = this.sibling;
+
+ if (subs) {
+ s = subs.length;
+ }
+
+ if (afters) {
+ a = afters.length;
+ }
+
+ if (sib) {
+ subs = sib._subscribers;
+ afters = sib._afters;
+
+ if (subs) {
+ s += subs.length;
+ }
+
+ if (afters) {
+ a += afters.length;
+ }
+ }
+
+ if (when) {
+ return (when === 'after') ? a : s;
+ }
+
+ return (s + a);
+ },
+
+ /**
+ * Monitor the event state for the subscribed event. The first parameter
+ * is what should be monitored, the rest are the normal parameters when
+ * subscribing to an event.
+ * @method monitor
+ * @param what {string} what to monitor ('detach', 'attach', 'publish').
+ * @return {EventHandle} return value from the monitor event subscription.
+ */
+ monitor: function(what) {
+ this.monitored = true;
+ var type = this.id + '|' + this.type + '_' + what,
+ args = nativeSlice.call(arguments, 0);
+ args[0] = type;
+ return this.host.on.apply(this.host, args);
+ },
+
+ /**
+ * Get all of the subscribers to this event and any sibling event
+ * @method getSubs
+ * @return {Array} first item is the on subscribers, second the after.
+ */
+ getSubs: function() {
+
+ var sibling = this.sibling,
+ subs = this._subscribers,
+ afters = this._afters,
+ siblingSubs,
+ siblingAfters;
+
+ if (sibling) {
+ siblingSubs = sibling._subscribers;
+ siblingAfters = sibling._afters;
+ }
+
+ if (siblingSubs) {
+ if (subs) {
+ subs = subs.concat(siblingSubs);
+ } else {
+ subs = siblingSubs.concat();
+ }
+ } else {
+ if (subs) {
+ subs = subs.concat();
+ } else {
+ subs = [];
+ }
+ }
+
+ if (siblingAfters) {
+ if (afters) {
+ afters = afters.concat(siblingAfters);
+ } else {
+ afters = siblingAfters.concat();
+ }
+ } else {
+ if (afters) {
+ afters = afters.concat();
+ } else {
+ afters = [];
+ }
+ }
+
+ return [subs, afters];
+ },
+
+ /**
+ * Apply configuration properties. Only applies the CONFIG whitelist
+ * @method applyConfig
+ * @param o hash of properties to apply.
+ * @param force {boolean} if true, properties that exist on the event
+ * will be overwritten.
+ */
+ applyConfig: function(o, force) {
+ mixConfigs(this, o, force);
+ },
+
+ /**
+ * Create the Subscription for subscribing function, context, and bound
+ * arguments. If this is a fireOnce event, the subscriber is immediately
+ * notified.
+ *
+ * @method _on
+ * @param fn {Function} Subscription callback
+ * @param [context] {Object} Override `this` in the callback
+ * @param [args] {Array} bound arguments that will be passed to the callback after the arguments generated by fire()
+ * @param [when] {String} "after" to slot into after subscribers
+ * @return {EventHandle}
+ * @protected
+ */
+ _on: function(fn, context, args, when) {
+
+ if (!fn) { this.log('Invalid callback for CE: ' + this.type); }
+
+ var s = new Y.Subscriber(fn, context, args, when);
+
+ if (this.fireOnce && this.fired) {
+ if (this.async) {
+ setTimeout(Y.bind(this._notify, this, s, this.firedWith), 0);
+ } else {
+ this._notify(s, this.firedWith);
+ }
+ }
+
+ if (when === AFTER) {
+ if (!this._afters) {
+ this._afters = [];
+ this._hasAfters = true;
+ }
+ this._afters.push(s);
+ } else {
+ if (!this._subscribers) {
+ this._subscribers = [];
+ this._hasSubs = true;
+ }
+ this._subscribers.push(s);
+ }
+
+ if (this._kds) {
+ if (when === AFTER) {
+ this.afters[s.id] = s;
+ } else {
+ this.subscribers[s.id] = s;
+ }
+ }
+
+ return new Y.EventHandle(this, s);
+ },
+
+ /**
+ * Listen for this event
+ * @method subscribe
+ * @param {Function} fn The function to execute.
+ * @return {EventHandle} Unsubscribe handle.
+ * @deprecated use on.
+ */
+ subscribe: function(fn, context) {
+ Y.log('ce.subscribe deprecated, use "on"', 'warn', 'deprecated');
+ var a = (arguments.length > 2) ? nativeSlice.call(arguments, 2) : null;
+ return this._on(fn, context, a, true);
+ },
+
+ /**
+ * Listen for this event
+ * @method on
+ * @param {Function} fn The function to execute.
+ * @param {object} context optional execution context.
+ * @param {mixed} arg* 0..n additional arguments to supply to the subscriber
+ * when the event fires.
+ * @return {EventHandle} An object with a detach method to detch the handler(s).
+ */
+ on: function(fn, context) {
+ var a = (arguments.length > 2) ? nativeSlice.call(arguments, 2) : null;
+
+ if (this.monitored && this.host) {
+ this.host._monitor('attach', this, {
+ args: arguments
+ });
+ }
+ return this._on(fn, context, a, true);
+ },
+
+ /**
+ * Listen for this event after the normal subscribers have been notified and
+ * the default behavior has been applied. If a normal subscriber prevents the
+ * default behavior, it also prevents after listeners from firing.
+ * @method after
+ * @param {Function} fn The function to execute.
+ * @param {object} context optional execution context.
+ * @param {mixed} arg* 0..n additional arguments to supply to the subscriber
+ * when the event fires.
+ * @return {EventHandle} handle Unsubscribe handle.
+ */
+ after: function(fn, context) {
+ var a = (arguments.length > 2) ? nativeSlice.call(arguments, 2) : null;
+ return this._on(fn, context, a, AFTER);
+ },
+
+ /**
+ * Detach listeners.
+ * @method detach
+ * @param {Function} fn The subscribed function to remove, if not supplied
+ * all will be removed.
+ * @param {Object} context The context object passed to subscribe.
+ * @return {int} returns the number of subscribers unsubscribed.
+ */
+ detach: function(fn, context) {
+ // unsubscribe handle
+ if (fn && fn.detach) {
+ return fn.detach();
+ }
+
+ var i, s,
+ found = 0,
+ subs = this._subscribers,
+ afters = this._afters;
+
+ if (subs) {
+ for (i = subs.length; i >= 0; i--) {
+ s = subs[i];
+ if (s && (!fn || fn === s.fn)) {
+ this._delete(s, subs, i);
+ found++;
+ }
+ }
+ }
+
+ if (afters) {
+ for (i = afters.length; i >= 0; i--) {
+ s = afters[i];
+ if (s && (!fn || fn === s.fn)) {
+ this._delete(s, afters, i);
+ found++;
+ }
+ }
+ }
+
+ return found;
+ },
+
+ /**
+ * Detach listeners.
+ * @method unsubscribe
+ * @param {Function} fn The subscribed function to remove, if not supplied
+ * all will be removed.
+ * @param {Object} context The context object passed to subscribe.
+ * @return {int|undefined} returns the number of subscribers unsubscribed.
+ * @deprecated use detach.
+ */
+ unsubscribe: function() {
+ return this.detach.apply(this, arguments);
+ },
+
+ /**
+ * Notify a single subscriber
+ * @method _notify
+ * @param {Subscriber} s the subscriber.
+ * @param {Array} args the arguments array to apply to the listener.
+ * @protected
+ */
+ _notify: function(s, args, ef) {
+
+ this.log(this.type + '->' + 'sub: ' + s.id);
+
+ var ret;
+
+ ret = s.notify(args, this);
+
+ if (false === ret || this.stopped > 1) {
+ this.log(this.type + ' cancelled by subscriber');
+ return false;
+ }
+
+ return true;
+ },
+
+ /**
+ * Logger abstraction to centralize the application of the silent flag
+ * @method log
+ * @param {string} msg message to log.
+ * @param {string} cat log category.
+ */
+ log: function(msg, cat) {
+ if (!this.silent) { Y.log(this.id + ': ' + msg, cat || 'info', 'event'); }
+ },
+
+ /**
+ * Notifies the subscribers. The callback functions will be executed
+ * from the context specified when the event was created, and with the
+ * following parameters:
+ * <ul>
+ * <li>The type of event</li>
+ * <li>All of the arguments fire() was executed with as an array</li>
+ * <li>The custom object (if any) that was passed into the subscribe()
+ * method</li>
+ * </ul>
+ * @method fire
+ * @param {Object*} arguments an arbitrary set of parameters to pass to
+ * the handler.
+ * @return {boolean} false if one of the subscribers returned false,
+ * true otherwise.
+ *
+ */
+ fire: function() {
+
+ // push is the fastest way to go from arguments to arrays
+ // for most browsers currently
+ // http://jsperf.com/push-vs-concat-vs-slice/2
+
+ var args = [];
+ args.push.apply(args, arguments);
+
+ return this._fire(args);
+ },
+
+ /**
+ * Private internal implementation for `fire`, which is can be used directly by
+ * `EventTarget` and other event module classes which have already converted from
+ * an `arguments` list to an array, to avoid the repeated overhead.
+ *
+ * @method _fire
+ * @private
+ * @param {Array} args The array of arguments passed to be passed to handlers.
+ * @return {boolean} false if one of the subscribers returned false, true otherwise.
+ */
+ _fire: function(args) {
+
+ if (this.fireOnce && this.fired) {
+ this.log('fireOnce event: ' + this.type + ' already fired');
+ return true;
+ } else {
+
+ // this doesn't happen if the event isn't published
+ // this.host._monitor('fire', this.type, args);
+
+ this.fired = true;
+
+ if (this.fireOnce) {
+ this.firedWith = args;
+ }
+
+ if (this.emitFacade) {
+ return this.fireComplex(args);
+ } else {
+ return this.fireSimple(args);
+ }
+ }
+ },
+
+ /**
+ * Set up for notifying subscribers of non-emitFacade events.
+ *
+ * @method fireSimple
+ * @param args {Array} Arguments passed to fire()
+ * @return Boolean false if a subscriber returned false
+ * @protected
+ */
+ fireSimple: function(args) {
+ this.stopped = 0;
+ this.prevented = 0;
+ if (this.hasSubs()) {
+ var subs = this.getSubs();
+ this._procSubs(subs[0], args);
+ this._procSubs(subs[1], args);
+ }
+ if (this.broadcast) {
+ this._broadcast(args);
+ }
+ return this.stopped ? false : true;
+ },
+
+ // Requires the event-custom-complex module for full funcitonality.
+ fireComplex: function(args) {
+ this.log('Missing event-custom-complex needed to emit a facade for: ' + this.type);
+ args[0] = args[0] || {};
+ return this.fireSimple(args);
+ },
+
+ /**
+ * Notifies a list of subscribers.
+ *
+ * @method _procSubs
+ * @param subs {Array} List of subscribers
+ * @param args {Array} Arguments passed to fire()
+ * @param ef {}
+ * @return Boolean false if a subscriber returns false or stops the event
+ * propagation via e.stopPropagation(),
+ * e.stopImmediatePropagation(), or e.halt()
+ * @private
+ */
+ _procSubs: function(subs, args, ef) {
+ var s, i, l;
+
+ for (i = 0, l = subs.length; i < l; i++) {
+ s = subs[i];
+ if (s && s.fn) {
+ if (false === this._notify(s, args, ef)) {
+ this.stopped = 2;
+ }
+ if (this.stopped === 2) {
+ return false;
+ }
+ }
+ }
+
+ return true;
+ },
+
+ /**
+ * Notifies the YUI instance if the event is configured with broadcast = 1,
+ * and both the YUI instance and Y.Global if configured with broadcast = 2.
+ *
+ * @method _broadcast
+ * @param args {Array} Arguments sent to fire()
+ * @private
+ */
+ _broadcast: function(args) {
+ if (!this.stopped && this.broadcast) {
+
+ var a = args.concat();
+ a.unshift(this.type);
+
+ if (this.host !== Y) {
+ Y.fire.apply(Y, a);
+ }
+
+ if (this.broadcast === 2) {
+ Y.Global.fire.apply(Y.Global, a);
+ }
+ }
+ },
+
+ /**
+ * Removes all listeners
+ * @method unsubscribeAll
+ * @return {int} The number of listeners unsubscribed.
+ * @deprecated use detachAll.
+ */
+ unsubscribeAll: function() {
+ return this.detachAll.apply(this, arguments);
+ },
+
+ /**
+ * Removes all listeners
+ * @method detachAll
+ * @return {int} The number of listeners unsubscribed.
+ */
+ detachAll: function() {
+ return this.detach();
+ },
+
+ /**
+ * Deletes the subscriber from the internal store of on() and after()
+ * subscribers.
+ *
+ * @method _delete
+ * @param s subscriber object.
+ * @param subs (optional) on or after subscriber array
+ * @param index (optional) The index found.
+ * @private
+ */
+ _delete: function(s, subs, i) {
+ var when = s._when;
+
+ if (!subs) {
+ subs = (when === AFTER) ? this._afters : this._subscribers;
+ }
+
+ if (subs) {
+ i = YArray.indexOf(subs, s, 0);
+
+ if (s && subs[i] === s) {
+ subs.splice(i, 1);
+
+ if (subs.length === 0) {
+ if (when === AFTER) {
+ this._hasAfters = false;
+ } else {
+ this._hasSubs = false;
+ }
+ }
+ }
+ }
+
+ if (this._kds) {
+ if (when === AFTER) {
+ delete this.afters[s.id];
+ } else {
+ delete this.subscribers[s.id];
+ }
+ }
+
+ if (this.monitored && this.host) {
+ this.host._monitor('detach', this, {
+ ce: this,
+ sub: s
+ });
+ }
+
+ if (s) {
+ s.deleted = true;
+ }
+ }
+};
+/**
+ * Stores the subscriber information to be used when the event fires.
+ * @param {Function} fn The wrapped function to execute.
+ * @param {Object} context The value of the keyword 'this' in the listener.
+ * @param {Array} args* 0..n additional arguments to supply the listener.
+ *
+ * @class Subscriber
+ * @constructor
+ */
+Y.Subscriber = function(fn, context, args, when) {
+
+ /**
+ * The callback that will be execute when the event fires
+ * This is wrapped by Y.rbind if obj was supplied.
+ * @property fn
+ * @type Function
+ */
+ this.fn = fn;
+
+ /**
+ * Optional 'this' keyword for the listener
+ * @property context
+ * @type Object
+ */
+ this.context = context;
+
+ /**
+ * Unique subscriber id
+ * @property id
+ * @type String
+ */
+ this.id = Y.guid();
+
+ /**
+ * Additional arguments to propagate to the subscriber
+ * @property args
+ * @type Array
+ */
+ this.args = args;
+
+ this._when = when;
+
+ /**
+ * Custom events for a given fire transaction.
+ * @property events
+ * @type {EventTarget}
+ */
+ // this.events = null;
+
+ /**
+ * This listener only reacts to the event once
+ * @property once
+ */
+ // this.once = false;
+
+};
+
+Y.Subscriber.prototype = {
+ constructor: Y.Subscriber,
+
+ _notify: function(c, args, ce) {
+ if (this.deleted && !this.postponed) {
+ if (this.postponed) {
+ delete this.fn;
+ delete this.context;
+ } else {
+ delete this.postponed;
+ return null;
+ }
+ }
+ var a = this.args, ret;
+ switch (ce.signature) {
+ case 0:
+ ret = this.fn.call(c, ce.type, args, c);
+ break;
+ case 1:
+ ret = this.fn.call(c, args[0] || null, c);
+ break;
+ default:
+ if (a || args) {
+ args = args || [];
+ a = (a) ? args.concat(a) : args;
+ ret = this.fn.apply(c, a);
+ } else {
+ ret = this.fn.call(c);
+ }
+ }
+
+ if (this.once) {
+ ce._delete(this);
+ }
+
+ return ret;
+ },
+
+ /**
+ * Executes the subscriber.
+ * @method notify
+ * @param args {Array} Arguments array for the subscriber.
+ * @param ce {CustomEvent} The custom event that sent the notification.
+ */
+ notify: function(args, ce) {
+ var c = this.context,
+ ret = true;
+
+ if (!c) {
+ c = (ce.contextFn) ? ce.contextFn() : ce.context;
+ }
+
+ // only catch errors if we will not re-throw them.
+ if (Y.config && Y.config.throwFail) {
+ ret = this._notify(c, args, ce);
+ } else {
+ try {
+ ret = this._notify(c, args, ce);
+ } catch (e) {
+ Y.error(this + ' failed: ' + e.message, e);
+ }
+ }
+
+ return ret;
+ },
+
+ /**
+ * Returns true if the fn and obj match this objects properties.
+ * Used by the unsubscribe method to match the right subscriber.
+ *
+ * @method contains
+ * @param {Function} fn the function to execute.
+ * @param {Object} context optional 'this' keyword for the listener.
+ * @return {boolean} true if the supplied arguments match this
+ * subscriber's signature.
+ */
+ contains: function(fn, context) {
+ if (context) {
+ return ((this.fn === fn) && this.context === context);
+ } else {
+ return (this.fn === fn);
+ }
+ },
+
+ valueOf : function() {
+ return this.id;
+ }
+
+};
+/**
+ * Return value from all subscribe operations
+ * @class EventHandle
+ * @constructor
+ * @param {CustomEvent} evt the custom event.
+ * @param {Subscriber} sub the subscriber.
+ */
+Y.EventHandle = function(evt, sub) {
+
+ /**
+ * The custom event
+ *
+ * @property evt
+ * @type CustomEvent
+ */
+ this.evt = evt;
+
+ /**
+ * The subscriber object
+ *
+ * @property sub
+ * @type Subscriber
+ */
+ this.sub = sub;
+};
+
+Y.EventHandle.prototype = {
+ batch: function(f, c) {
+ f.call(c || this, this);
+ if (Y.Lang.isArray(this.evt)) {
+ Y.Array.each(this.evt, function(h) {
+ h.batch.call(c || h, f);
+ });
+ }
+ },
+
+ /**
+ * Detaches this subscriber
+ * @method detach
+ * @return {int} the number of detached listeners
+ */
+ detach: function() {
+ var evt = this.evt, detached = 0, i;
+ if (evt) {
+ // Y.log('EventHandle.detach: ' + this.sub, 'info', 'Event');
+ if (Y.Lang.isArray(evt)) {
+ for (i = 0; i < evt.length; i++) {
+ detached += evt[i].detach();
+ }
+ } else {
+ evt._delete(this.sub);
+ detached = 1;
+ }
+
+ }
+
+ return detached;
+ },
+
+ /**
+ * Monitor the event state for the subscribed event. The first parameter
+ * is what should be monitored, the rest are the normal parameters when
+ * subscribing to an event.
+ * @method monitor
+ * @param what {string} what to monitor ('attach', 'detach', 'publish').
+ * @return {EventHandle} return value from the monitor event subscription.
+ */
+ monitor: function(what) {
+ return this.evt.monitor.apply(this.evt, arguments);
+ }
+};
+
+/**
+ * Custom event engine, DOM event listener abstraction layer, synthetic DOM
+ * events.
+ * @module event-custom
+ * @submodule event-custom-base
+ */
+
+/**
+ * EventTarget provides the implementation for any object to
+ * publish, subscribe and fire to custom events, and also
+ * alows other EventTargets to target the object with events
+ * sourced from the other object.
+ * EventTarget is designed to be used with Y.augment to wrap
+ * EventCustom in an interface that allows events to be listened to
+ * and fired by name. This makes it possible for implementing code to
+ * subscribe to an event that either has not been created yet, or will
+ * not be created at all.
+ * @class EventTarget
+ * @param opts a configuration object
+ * @config emitFacade {boolean} if true, all events will emit event
+ * facade payloads by default (default false)
+ * @config prefix {String} the prefix to apply to non-prefixed event names
+ */
+
+var L = Y.Lang,
+ PREFIX_DELIMITER = ':',
+ CATEGORY_DELIMITER = '|',
+ AFTER_PREFIX = '~AFTER~',
+ WILD_TYPE_RE = /(.*?)(:)(.*?)/,
+
+ _wildType = Y.cached(function(type) {
+ return type.replace(WILD_TYPE_RE, "*$2$3");
+ }),
+
+ /**
+ * If the instance has a prefix attribute and the
+ * event type is not prefixed, the instance prefix is
+ * applied to the supplied type.
+ * @method _getType
+ * @private
+ */
+ _getType = function(type, pre) {
+
+ if (!pre || type.indexOf(PREFIX_DELIMITER) > -1) {
+ return type;
+ }
+
+ return pre + PREFIX_DELIMITER + type;
+ },
+
+ /**
+ * Returns an array with the detach key (if provided),
+ * and the prefixed event name from _getType
+ * Y.on('detachcategory| menu:click', fn)
+ * @method _parseType
+ * @private
+ */
+ _parseType = Y.cached(function(type, pre) {
+
+ var t = type, detachcategory, after, i;
+
+ if (!L.isString(t)) {
+ return t;
+ }
+
+ i = t.indexOf(AFTER_PREFIX);
+
+ if (i > -1) {
+ after = true;
+ t = t.substr(AFTER_PREFIX.length);
+ }
+
+ i = t.indexOf(CATEGORY_DELIMITER);
+
+ if (i > -1) {
+ detachcategory = t.substr(0, (i));
+ t = t.substr(i+1);
+ if (t === '*') {
+ t = null;
+ }
+ }
+
+ // detach category, full type with instance prefix, is this an after listener, short type
+ return [detachcategory, (pre) ? _getType(t, pre) : t, after, t];
+ }),
+
+ ET = function(opts) {
+
+ var etState = this._yuievt,
+ etConfig;
+
+ if (!etState) {
+ etState = this._yuievt = {
+ events: {}, // PERF: Not much point instantiating lazily. We're bound to have events
+ targets: null, // PERF: Instantiate lazily, if user actually adds target,
+ config: {
+ host: this,
+ context: this
+ },
+ chain: Y.config.chain
+ };
+ }
+
+ etConfig = etState.config;
+
+ if (opts) {
+ mixConfigs(etConfig, opts, true);
+
+ if (opts.chain !== undefined) {
+ etState.chain = opts.chain;
+ }
+
+ if (opts.prefix) {
+ etConfig.prefix = opts.prefix;
+ }
+ }
+ };
+
+ET.prototype = {
+
+ constructor: ET,
+
+ /**
+ * Listen to a custom event hosted by this object one time.
+ * This is the equivalent to <code>on</code> except the
+ * listener is immediatelly detached when it is executed.
+ * @method once
+ * @param {String} type The name of the event
+ * @param {Function} fn The callback to execute in response to the event
+ * @param {Object} [context] Override `this` object in callback
+ * @param {Any} [arg*] 0..n additional arguments to supply to the subscriber
+ * @return {EventHandle} A subscription handle capable of detaching the
+ * subscription
+ */
+ once: function() {
+ var handle = this.on.apply(this, arguments);
+ handle.batch(function(hand) {
+ if (hand.sub) {
+ hand.sub.once = true;
+ }
+ });
+ return handle;
+ },
+
+ /**
+ * Listen to a custom event hosted by this object one time.
+ * This is the equivalent to <code>after</code> except the
+ * listener is immediatelly detached when it is executed.
+ * @method onceAfter
+ * @param {String} type The name of the event
+ * @param {Function} fn The callback to execute in response to the event
+ * @param {Object} [context] Override `this` object in callback
+ * @param {Any} [arg*] 0..n additional arguments to supply to the subscriber
+ * @return {EventHandle} A subscription handle capable of detaching that
+ * subscription
+ */
+ onceAfter: function() {
+ var handle = this.after.apply(this, arguments);
+ handle.batch(function(hand) {
+ if (hand.sub) {
+ hand.sub.once = true;
+ }
+ });
+ return handle;
+ },
+
+ /**
+ * Takes the type parameter passed to 'on' and parses out the
+ * various pieces that could be included in the type. If the
+ * event type is passed without a prefix, it will be expanded
+ * to include the prefix one is supplied or the event target
+ * is configured with a default prefix.
+ * @method parseType
+ * @param {String} type the type
+ * @param {String} [pre=this._yuievt.config.prefix] the prefix
+ * @since 3.3.0
+ * @return {Array} an array containing:
+ * * the detach category, if supplied,
+ * * the prefixed event type,
+ * * whether or not this is an after listener,
+ * * the supplied event type
+ */
+ parseType: function(type, pre) {
+ return _parseType(type, pre || this._yuievt.config.prefix);
+ },
+
+ /**
+ * Subscribe a callback function to a custom event fired by this object or
+ * from an object that bubbles its events to this object.
+ *
+ * Callback functions for events published with `emitFacade = true` will
+ * receive an `EventFacade` as the first argument (typically named "e").
+ * These callbacks can then call `e.preventDefault()` to disable the
+ * behavior published to that event's `defaultFn`. See the `EventFacade`
+ * API for all available properties and methods. Subscribers to
+ * non-`emitFacade` events will receive the arguments passed to `fire()`
+ * after the event name.
+ *
+ * To subscribe to multiple events at once, pass an object as the first
+ * argument, where the key:value pairs correspond to the eventName:callback,
+ * or pass an array of event names as the first argument to subscribe to
+ * all listed events with the same callback.
+ *
+ * Returning `false` from a callback is supported as an alternative to
+ * calling `e.preventDefault(); e.stopPropagation();`. However, it is
+ * recommended to use the event methods whenever possible.
+ *
+ * @method on
+ * @param {String} type The name of the event
+ * @param {Function} fn The callback to execute in response to the event
+ * @param {Object} [context] Override `this` object in callback
+ * @param {Any} [arg*] 0..n additional arguments to supply to the subscriber
+ * @return {EventHandle} A subscription handle capable of detaching that
+ * subscription
+ */
+ on: function(type, fn, context) {
+
+ var yuievt = this._yuievt,
+ parts = _parseType(type, yuievt.config.prefix), f, c, args, ret, ce,
+ detachcategory, handle, store = Y.Env.evt.handles, after, adapt, shorttype,
+ Node = Y.Node, n, domevent, isArr;
+
+ // full name, args, detachcategory, after
+ this._monitor('attach', parts[1], {
+ args: arguments,
+ category: parts[0],
+ after: parts[2]
+ });
+
+ if (L.isObject(type)) {
+
+ if (L.isFunction(type)) {
+ return Y.Do.before.apply(Y.Do, arguments);
+ }
+
+ f = fn;
+ c = context;
+ args = nativeSlice.call(arguments, 0);
+ ret = [];
+
+ if (L.isArray(type)) {
+ isArr = true;
+ }
+
+ after = type._after;
+ delete type._after;
+
+ Y.each(type, function(v, k) {
+
+ if (L.isObject(v)) {
+ f = v.fn || ((L.isFunction(v)) ? v : f);
+ c = v.context || c;
+ }
+
+ var nv = (after) ? AFTER_PREFIX : '';
+
+ args[0] = nv + ((isArr) ? v : k);
+ args[1] = f;
+ args[2] = c;
+
+ ret.push(this.on.apply(this, args));
+
+ }, this);
+
+ return (yuievt.chain) ? this : new Y.EventHandle(ret);
+ }
+
+ detachcategory = parts[0];
+ after = parts[2];
+ shorttype = parts[3];
+
+ // extra redirection so we catch adaptor events too. take a look at this.
+ if (Node && Y.instanceOf(this, Node) && (shorttype in Node.DOM_EVENTS)) {
+ args = nativeSlice.call(arguments, 0);
+ args.splice(2, 0, Node.getDOMNode(this));
+ // Y.log("Node detected, redirecting with these args: " + args);
+ return Y.on.apply(Y, args);
+ }
+
+ type = parts[1];
+
+ if (Y.instanceOf(this, YUI)) {
+
+ adapt = Y.Env.evt.plugins[type];
+ args = nativeSlice.call(arguments, 0);
+ args[0] = shorttype;
+
+ if (Node) {
+ n = args[2];
+
+ if (Y.instanceOf(n, Y.NodeList)) {
+ n = Y.NodeList.getDOMNodes(n);
+ } else if (Y.instanceOf(n, Node)) {
+ n = Node.getDOMNode(n);
+ }
+
+ domevent = (shorttype in Node.DOM_EVENTS);
+
+ // Captures both DOM events and event plugins.
+ if (domevent) {
+ args[2] = n;
+ }
+ }
+
+ // check for the existance of an event adaptor
+ if (adapt) {
+ Y.log('Using adaptor for ' + shorttype + ', ' + n, 'info', 'event');
+ handle = adapt.on.apply(Y, args);
+ } else if ((!type) || domevent) {
+ handle = Y.Event._attach(args);
+ }
+
+ }
+
+ if (!handle) {
+ ce = yuievt.events[type] || this.publish(type);
+ handle = ce._on(fn, context, (arguments.length > 3) ? nativeSlice.call(arguments, 3) : null, (after) ? 'after' : true);
+
+ // TODO: More robust regex, accounting for category
+ if (type.indexOf("*:") !== -1) {
+ this._hasSiblings = true;
+ }
+ }
+
+ if (detachcategory) {
+ store[detachcategory] = store[detachcategory] || {};
+ store[detachcategory][type] = store[detachcategory][type] || [];
+ store[detachcategory][type].push(handle);
+ }
+
+ return (yuievt.chain) ? this : handle;
+
+ },
+
+ /**
+ * subscribe to an event
+ * @method subscribe
+ * @deprecated use on
+ */
+ subscribe: function() {
+ Y.log('EventTarget subscribe() is deprecated, use on()', 'warn', 'deprecated');
+ return this.on.apply(this, arguments);
+ },
+
+ /**
+ * Detach one or more listeners the from the specified event
+ * @method detach
+ * @param type {string|Object} Either the handle to the subscriber or the
+ * type of event. If the type
+ * is not specified, it will attempt to remove
+ * the listener from all hosted events.
+ * @param fn {Function} The subscribed function to unsubscribe, if not
+ * supplied, all subscribers will be removed.
+ * @param context {Object} The custom object passed to subscribe. This is
+ * optional, but if supplied will be used to
+ * disambiguate multiple listeners that are the same
+ * (e.g., you subscribe many object using a function
+ * that lives on the prototype)
+ * @return {EventTarget} the host
+ */
+ detach: function(type, fn, context) {
+
+ var evts = this._yuievt.events,
+ i,
+ Node = Y.Node,
+ isNode = Node && (Y.instanceOf(this, Node));
+
+ // detachAll disabled on the Y instance.
+ if (!type && (this !== Y)) {
+ for (i in evts) {
+ if (evts.hasOwnProperty(i)) {
+ evts[i].detach(fn, context);
+ }
+ }
+ if (isNode) {
+ Y.Event.purgeElement(Node.getDOMNode(this));
+ }
+
+ return this;
+ }
+
+ var parts = _parseType(type, this._yuievt.config.prefix),
+ detachcategory = L.isArray(parts) ? parts[0] : null,
+ shorttype = (parts) ? parts[3] : null,
+ adapt, store = Y.Env.evt.handles, detachhost, cat, args,
+ ce,
+
+ keyDetacher = function(lcat, ltype, host) {
+ var handles = lcat[ltype], ce, i;
+ if (handles) {
+ for (i = handles.length - 1; i >= 0; --i) {
+ ce = handles[i].evt;
+ if (ce.host === host || ce.el === host) {
+ handles[i].detach();
+ }
+ }
+ }
+ };
+
+ if (detachcategory) {
+
+ cat = store[detachcategory];
+ type = parts[1];
+ detachhost = (isNode) ? Y.Node.getDOMNode(this) : this;
+
+ if (cat) {
+ if (type) {
+ keyDetacher(cat, type, detachhost);
+ } else {
+ for (i in cat) {
+ if (cat.hasOwnProperty(i)) {
+ keyDetacher(cat, i, detachhost);
+ }
+ }
+ }
+
+ return this;
+ }
+
+ // If this is an event handle, use it to detach
+ } else if (L.isObject(type) && type.detach) {
+ type.detach();
+ return this;
+ // extra redirection so we catch adaptor events too. take a look at this.
+ } else if (isNode && ((!shorttype) || (shorttype in Node.DOM_EVENTS))) {
+ args = nativeSlice.call(arguments, 0);
+ args[2] = Node.getDOMNode(this);
+ Y.detach.apply(Y, args);
+ return this;
+ }
+
+ adapt = Y.Env.evt.plugins[shorttype];
+
+ // The YUI instance handles DOM events and adaptors
+ if (Y.instanceOf(this, YUI)) {
+ args = nativeSlice.call(arguments, 0);
+ // use the adaptor specific detach code if
+ if (adapt && adapt.detach) {
+ adapt.detach.apply(Y, args);
+ return this;
+ // DOM event fork
+ } else if (!type || (!adapt && Node && (type in Node.DOM_EVENTS))) {
+ args[0] = type;
+ Y.Event.detach.apply(Y.Event, args);
+ return this;
+ }
+ }
+
+ // ce = evts[type];
+ ce = evts[parts[1]];
+ if (ce) {
+ ce.detach(fn, context);
+ }
+
+ return this;
+ },
+
+ /**
+ * detach a listener
+ * @method unsubscribe
+ * @deprecated use detach
+ */
+ unsubscribe: function() {
+Y.log('EventTarget unsubscribe() is deprecated, use detach()', 'warn', 'deprecated');
+ return this.detach.apply(this, arguments);
+ },
+
+ /**
+ * Removes all listeners from the specified event. If the event type
+ * is not specified, all listeners from all hosted custom events will
+ * be removed.
+ * @method detachAll
+ * @param type {String} The type, or name of the event
+ */
+ detachAll: function(type) {
+ return this.detach(type);
+ },
+
+ /**
+ * Removes all listeners from the specified event. If the event type
+ * is not specified, all listeners from all hosted custom events will
+ * be removed.
+ * @method unsubscribeAll
+ * @param type {String} The type, or name of the event
+ * @deprecated use detachAll
+ */
+ unsubscribeAll: function() {
+Y.log('EventTarget unsubscribeAll() is deprecated, use detachAll()', 'warn', 'deprecated');
+ return this.detachAll.apply(this, arguments);
+ },
+
+ /**
+ * Creates a new custom event of the specified type. If a custom event
+ * by that name already exists, it will not be re-created. In either
+ * case the custom event is returned.
+ *
+ * @method publish
+ *
+ * @param type {String} the type, or name of the event
+ * @param opts {object} optional config params. Valid properties are:
+ *
+ * <ul>
+ * <li>
+ * 'broadcast': whether or not the YUI instance and YUI global are notified when the event is fired (false)
+ * </li>
+ * <li>
+ * 'bubbles': whether or not this event bubbles (true)
+ * Events can only bubble if emitFacade is true.
+ * </li>
+ * <li>
+ * 'context': the default execution context for the listeners (this)
+ * </li>
+ * <li>
+ * 'defaultFn': the default function to execute when this event fires if preventDefault was not called
+ * </li>
+ * <li>
+ * 'emitFacade': whether or not this event emits a facade (false)
+ * </li>
+ * <li>
+ * 'prefix': the prefix for this targets events, e.g., 'menu' in 'menu:click'
+ * </li>
+ * <li>
+ * 'fireOnce': if an event is configured to fire once, new subscribers after
+ * the fire will be notified immediately.
+ * </li>
+ * <li>
+ * 'async': fireOnce event listeners will fire synchronously if the event has already
+ * fired unless async is true.
+ * </li>
+ * <li>
+ * 'preventable': whether or not preventDefault() has an effect (true)
+ * </li>
+ * <li>
+ * 'preventedFn': a function that is executed when preventDefault is called
+ * </li>
+ * <li>
+ * 'queuable': whether or not this event can be queued during bubbling (false)
+ * </li>
+ * <li>
+ * 'silent': if silent is true, debug messages are not provided for this event.
+ * </li>
+ * <li>
+ * 'stoppedFn': a function that is executed when stopPropagation is called
+ * </li>
+ *
+ * <li>
+ * 'monitored': specifies whether or not this event should send notifications about
+ * when the event has been attached, detached, or published.
+ * </li>
+ * <li>
+ * 'type': the event type (valid option if not provided as the first parameter to publish)
+ * </li>
+ * </ul>
+ *
+ * @return {CustomEvent} the custom event
+ *
+ */
+ publish: function(type, opts) {
+
+ var ret,
+ etState = this._yuievt,
+ etConfig = etState.config,
+ pre = etConfig.prefix;
+
+ if (typeof type === "string") {
+ if (pre) {
+ type = _getType(type, pre);
+ }
+ ret = this._publish(type, etConfig, opts);
+ } else {
+ ret = {};
+
+ Y.each(type, function(v, k) {
+ if (pre) {
+ k = _getType(k, pre);
+ }
+ ret[k] = this._publish(k, etConfig, v || opts);
+ }, this);
+
+ }
+
+ return ret;
+ },
+
+ /**
+ * Returns the fully qualified type, given a short type string.
+ * That is, returns "foo:bar" when given "bar" if "foo" is the configured prefix.
+ *
+ * NOTE: This method, unlike _getType, does no checking of the value passed in, and
+ * is designed to be used with the low level _publish() method, for critical path
+ * implementations which need to fast-track publish for performance reasons.
+ *
+ * @method _getFullType
+ * @private
+ * @param {String} type The short type to prefix
+ * @return {String} The prefixed type, if a prefix is set, otherwise the type passed in
+ */
+ _getFullType : function(type) {
+
+ var pre = this._yuievt.config.prefix;
+
+ if (pre) {
+ return pre + PREFIX_DELIMITER + type;
+ } else {
+ return type;
+ }
+ },
+
+ /**
+ * The low level event publish implementation. It expects all the massaging to have been done
+ * outside of this method. e.g. the `type` to `fullType` conversion. It's designed to be a fast
+ * path publish, which can be used by critical code paths to improve performance.
+ *
+ * @method _publish
+ * @private
+ * @param {String} fullType The prefixed type of the event to publish.
+ * @param {Object} etOpts The EventTarget specific configuration to mix into the published event.
+ * @param {Object} ceOpts The publish specific configuration to mix into the published event.
+ * @return {CustomEvent} The published event. If called without `etOpts` or `ceOpts`, this will
+ * be the default `CustomEvent` instance, and can be configured independently.
+ */
+ _publish : function(fullType, etOpts, ceOpts) {
+
+ var ce,
+ etState = this._yuievt,
+ etConfig = etState.config,
+ host = etConfig.host,
+ context = etConfig.context,
+ events = etState.events;
+
+ ce = events[fullType];
+
+ // PERF: Hate to pull the check out of monitor, but trying to keep critical path tight.
+ if ((etConfig.monitored && !ce) || (ce && ce.monitored)) {
+ this._monitor('publish', fullType, {
+ args: arguments
+ });
+ }
+
+ if (!ce) {
+ // Publish event
+ ce = events[fullType] = new Y.CustomEvent(fullType, etOpts);
+
+ if (!etOpts) {
+ ce.host = host;
+ ce.context = context;
+ }
+ }
+
+ if (ceOpts) {
+ mixConfigs(ce, ceOpts, true);
+ }
+
+ return ce;
+ },
+
+ /**
+ * This is the entry point for the event monitoring system.
+ * You can monitor 'attach', 'detach', 'fire', and 'publish'.
+ * When configured, these events generate an event. click ->
+ * click_attach, click_detach, click_publish -- these can
+ * be subscribed to like other events to monitor the event
+ * system. Inividual published events can have monitoring
+ * turned on or off (publish can't be turned off before it
+ * it published) by setting the events 'monitor' config.
+ *
+ * @method _monitor
+ * @param what {String} 'attach', 'detach', 'fire', or 'publish'
+ * @param eventType {String|CustomEvent} The prefixed name of the event being monitored, or the CustomEvent object.
+ * @param o {Object} Information about the event interaction, such as
+ * fire() args, subscription category, publish config
+ * @private
+ */
+ _monitor: function(what, eventType, o) {
+ var monitorevt, ce, type;
+
+ if (eventType) {
+ if (typeof eventType === "string") {
+ type = eventType;
+ ce = this.getEvent(eventType, true);
+ } else {
+ ce = eventType;
+ type = eventType.type;
+ }
+
+ if ((this._yuievt.config.monitored && (!ce || ce.monitored)) || (ce && ce.monitored)) {
+ monitorevt = type + '_' + what;
+ o.monitored = what;
+ this.fire.call(this, monitorevt, o);
+ }
+ }
+ },
+
+ /**
+ * Fire a custom event by name. The callback functions will be executed
+ * from the context specified when the event was created, and with the
+ * following parameters.
+ *
+ * If the custom event object hasn't been created, then the event hasn't
+ * been published and it has no subscribers. For performance sake, we
+ * immediate exit in this case. This means the event won't bubble, so
+ * if the intention is that a bubble target be notified, the event must
+ * be published on this object first.
+ *
+ * The first argument is the event type, and any additional arguments are
+ * passed to the listeners as parameters. If the first of these is an
+ * object literal, and the event is configured to emit an event facade,
+ * that object is mixed into the event facade and the facade is provided
+ * in place of the original object.
+ *
+ * @method fire
+ * @param type {String|Object} The type of the event, or an object that contains
+ * a 'type' property.
+ * @param arguments {Object*} an arbitrary set of parameters to pass to
+ * the handler. If the first of these is an object literal and the event is
+ * configured to emit an event facade, the event facade will replace that
+ * parameter after the properties the object literal contains are copied to
+ * the event facade.
+ * @return {EventTarget} the event host
+ */
+ fire: function(type) {
+
+ var typeIncluded = (typeof type === "string"),
+ argCount = arguments.length,
+ t = type,
+ yuievt = this._yuievt,
+ etConfig = yuievt.config,
+ pre = etConfig.prefix,
+ ret,
+ ce,
+ ce2,
+ args;
+
+ if (typeIncluded && argCount <= 3) {
+
+ // PERF: Try to avoid slice/iteration for the common signatures
+
+ // Most common
+ if (argCount === 2) {
+ args = [arguments[1]]; // fire("foo", {})
+ } else if (argCount === 3) {
+ args = [arguments[1], arguments[2]]; // fire("foo", {}, opts)
+ } else {
+ args = []; // fire("foo")
+ }
+
+ } else {
+ args = nativeSlice.call(arguments, ((typeIncluded) ? 1 : 0));
+ }
+
+ if (!typeIncluded) {
+ t = (type && type.type);
+ }
+
+ if (pre) {
+ t = _getType(t, pre);
+ }
+
+ ce = yuievt.events[t];
+
+ if (this._hasSiblings) {
+ ce2 = this.getSibling(t, ce);
+
+ if (ce2 && !ce) {
+ ce = this.publish(t);
+ }
+ }
+
+ // PERF: trying to avoid function call, since this is a critical path
+ if ((etConfig.monitored && (!ce || ce.monitored)) || (ce && ce.monitored)) {
+ this._monitor('fire', (ce || t), {
+ args: args
+ });
+ }
+
+ // this event has not been published or subscribed to
+ if (!ce) {
+ if (yuievt.hasTargets) {
+ return this.bubble({ type: t }, args, this);
+ }
+
+ // otherwise there is nothing to be done
+ ret = true;
+ } else {
+
+ if (ce2) {
+ ce.sibling = ce2;
+ }
+
+ ret = ce._fire(args);
+ }
+
+ return (yuievt.chain) ? this : ret;
+ },
+
+ getSibling: function(type, ce) {
+ var ce2;
+
+ // delegate to *:type events if there are subscribers
+ if (type.indexOf(PREFIX_DELIMITER) > -1) {
+ type = _wildType(type);
+ ce2 = this.getEvent(type, true);
+ if (ce2) {
+ ce2.applyConfig(ce);
+ ce2.bubbles = false;
+ ce2.broadcast = 0;
+ }
+ }
+
+ return ce2;
+ },
+
+ /**
+ * Returns the custom event of the provided type has been created, a
+ * falsy value otherwise
+ * @method getEvent
+ * @param type {String} the type, or name of the event
+ * @param prefixed {String} if true, the type is prefixed already
+ * @return {CustomEvent} the custom event or null
+ */
+ getEvent: function(type, prefixed) {
+ var pre, e;
+
+ if (!prefixed) {
+ pre = this._yuievt.config.prefix;
+ type = (pre) ? _getType(type, pre) : type;
+ }
+ e = this._yuievt.events;
+ return e[type] || null;
+ },
+
+ /**
+ * Subscribe to a custom event hosted by this object. The
+ * supplied callback will execute after any listeners add
+ * via the subscribe method, and after the default function,
+ * if configured for the event, has executed.
+ *
+ * @method after
+ * @param {String} type The name of the event
+ * @param {Function} fn The callback to execute in response to the event
+ * @param {Object} [context] Override `this` object in callback
+ * @param {Any} [arg*] 0..n additional arguments to supply to the subscriber
+ * @return {EventHandle} A subscription handle capable of detaching the
+ * subscription
+ */
+ after: function(type, fn) {
+
+ var a = nativeSlice.call(arguments, 0);
+
+ switch (L.type(type)) {
+ case 'function':
+ return Y.Do.after.apply(Y.Do, arguments);
+ case 'array':
+ // YArray.each(a[0], function(v) {
+ // v = AFTER_PREFIX + v;
+ // });
+ // break;
+ case 'object':
+ a[0]._after = true;
+ break;
+ default:
+ a[0] = AFTER_PREFIX + type;
+ }
+
+ return this.on.apply(this, a);
+
+ },
+
+ /**
+ * Executes the callback before a DOM event, custom event
+ * or method. If the first argument is a function, it
+ * is assumed the target is a method. For DOM and custom
+ * events, this is an alias for Y.on.
+ *
+ * For DOM and custom events:
+ * type, callback, context, 0-n arguments
+ *
+ * For methods:
+ * callback, object (method host), methodName, context, 0-n arguments
+ *
+ * @method before
+ * @return detach handle
+ */
+ before: function() {
+ return this.on.apply(this, arguments);
+ }
+
+};
+
+Y.EventTarget = ET;
+
+// make Y an event target
+Y.mix(Y, ET.prototype);
+ET.call(Y, { bubbles: false });
+
+YUI.Env.globalEvents = YUI.Env.globalEvents || new ET();
+
+/**
+ * Hosts YUI page level events. This is where events bubble to
+ * when the broadcast config is set to 2. This property is
+ * only available if the custom event module is loaded.
+ * @property Global
+ * @type EventTarget
+ * @for YUI
+ */
+Y.Global = YUI.Env.globalEvents;
+
+// @TODO implement a global namespace function on Y.Global?
+
+/**
+`Y.on()` can do many things:
+
+<ul>
+ <li>Subscribe to custom events `publish`ed and `fire`d from Y</li>
+ <li>Subscribe to custom events `publish`ed with `broadcast` 1 or 2 and
+ `fire`d from any object in the YUI instance sandbox</li>
+ <li>Subscribe to DOM events</li>
+ <li>Subscribe to the execution of a method on any object, effectively
+ treating that method as an event</li>
+</ul>
+
+For custom event subscriptions, pass the custom event name as the first argument
+and callback as the second. The `this` object in the callback will be `Y` unless
+an override is passed as the third argument.
+
+ Y.on('io:complete', function () {
+ Y.MyApp.updateStatus('Transaction complete');
+ });
+
+To subscribe to DOM events, pass the name of a DOM event as the first argument
+and a CSS selector string as the third argument after the callback function.
+Alternately, the third argument can be a `Node`, `NodeList`, `HTMLElement`,
+array, or simply omitted (the default is the `window` object).
+
+ Y.on('click', function (e) {
+ e.preventDefault();
+
+ // proceed with ajax form submission
+ var url = this.get('action');
+ ...
+ }, '#my-form');
+
+The `this` object in DOM event callbacks will be the `Node` targeted by the CSS
+selector or other identifier.
+
+`on()` subscribers for DOM events or custom events `publish`ed with a
+`defaultFn` can prevent the default behavior with `e.preventDefault()` from the
+event object passed as the first parameter to the subscription callback.
+
+To subscribe to the execution of an object method, pass arguments corresponding to the call signature for
+<a href="../classes/Do.html#methods_before">`Y.Do.before(...)`</a>.
+
+NOTE: The formal parameter list below is for events, not for function
+injection. See `Y.Do.before` for that signature.
+
+@method on
+@param {String} type DOM or custom event name
+@param {Function} fn The callback to execute in response to the event
+@param {Object} [context] Override `this` object in callback
+@param {Any} [arg*] 0..n additional arguments to supply to the subscriber
+@return {EventHandle} A subscription handle capable of detaching the
+ subscription
+@see Do.before
+@for YUI
+**/
+
+/**
+Listen for an event one time. Equivalent to `on()`, except that
+the listener is immediately detached when executed.
+
+See the <a href="#methods_on">`on()` method</a> for additional subscription
+options.
+
+@see on
+@method once
+@param {String} type DOM or custom event name
+@param {Function} fn The callback to execute in response to the event
+@param {Object} [context] Override `this` object in callback
+@param {Any} [arg*] 0..n additional arguments to supply to the subscriber
+@return {EventHandle} A subscription handle capable of detaching the
+ subscription
+@for YUI
+**/
+
+/**
+Listen for an event one time. Equivalent to `once()`, except, like `after()`,
+the subscription callback executes after all `on()` subscribers and the event's
+`defaultFn` (if configured) have executed. Like `after()` if any `on()` phase
+subscriber calls `e.preventDefault()`, neither the `defaultFn` nor the `after()`
+subscribers will execute.
+
+The listener is immediately detached when executed.
+
+See the <a href="#methods_on">`on()` method</a> for additional subscription
+options.
+
+@see once
+@method onceAfter
+@param {String} type The custom event name
+@param {Function} fn The callback to execute in response to the event
+@param {Object} [context] Override `this` object in callback
+@param {Any} [arg*] 0..n additional arguments to supply to the subscriber
+@return {EventHandle} A subscription handle capable of detaching the
+ subscription
+@for YUI
+**/
+
+/**
+Like `on()`, this method creates a subscription to a custom event or to the
+execution of a method on an object.
+
+For events, `after()` subscribers are executed after the event's
+`defaultFn` unless `e.preventDefault()` was called from an `on()` subscriber.
+
+See the <a href="#methods_on">`on()` method</a> for additional subscription
+options.
+
+NOTE: The subscription signature shown is for events, not for function
+injection. See <a href="../classes/Do.html#methods_after">`Y.Do.after`</a>
+for that signature.
+
+@see on
+@see Do.after
+@method after
+@param {String} type The custom event name
+@param {Function} fn The callback to execute in response to the event
+@param {Object} [context] Override `this` object in callback
+@param {Any} [args*] 0..n additional arguments to supply to the subscriber
+@return {EventHandle} A subscription handle capable of detaching the
+ subscription
+@for YUI
+**/
+
+
+}, '3.10.3', {"requires": ["oop"]});