Proyectos de Subversion Moodle

YUI.add('attribute-core', function (Y, NAME) {

    /**

     * The State class maintains state for a collection of named items, with

     * a varying number of properties defined.

     *

     * It avoids the need to create a separate class for the item, and separate instances

     * of these classes for each item, by storing the state in a 2 level hash table,

     * improving performance when the number of items is likely to be large.

     *

     * @constructor

     * @class State

     */

    Y.State = function() {

        /**

         * Hash of attributes

         * @property data

         */

        this.data = {};

    };

    Y.State.prototype = {

        /**

         * Adds a property to an item.

         *

         * @method add

         * @param name {String} The name of the item.

         * @param key {String} The name of the property.

         * @param val {Any} The value of the property.

         */

        add: function(name, key, val) {

            var item = this.data[name];

            if (!item) {

                item = this.data[name] = {};

            }

            item[key] = val;

        },

        /**

         * Adds multiple properties to an item.

         *

         * @method addAll

         * @param name {String} The name of the item.

         * @param obj {Object} A hash of property/value pairs.

         */

        addAll: function(name, obj) {

            var item = this.data[name],

                key;

            if (!item) {

                item = this.data[name] = {};

            }

            for (key in obj) {

                if (obj.hasOwnProperty(key)) {

                    item[key] = obj[key];

                }

            }

        },

        /**

         * Removes a property from an item.

         *

         * @method remove

         * @param name {String} The name of the item.

         * @param key {String} The property to remove.

         */

        remove: function(name, key) {

            var item = this.data[name];

            if (item) {

                delete item[key];

            }

        },

        /**

         * Removes multiple properties from an item, or removes the item completely.

         *

         * @method removeAll

         * @param name {String} The name of the item.

         * @param obj {Object|Array} Collection of properties to delete. If not provided, the entire item is removed.

         */

        removeAll: function(name, obj) {

            var data;

            if (!obj) {

                data = this.data;

                if (name in data) {

                    delete data[name];

                }

            } else {

                Y.each(obj, function(value, key) {

                    this.remove(name, typeof key === 'string' ? key : value);

                }, this);

            }

        },

        /**

         * For a given item, returns the value of the property requested, or undefined if not found.

         *

         * @method get

         * @param name {String} The name of the item

         * @param key {String} Optional. The property value to retrieve.

         * @return {Any} The value of the supplied property.

         */

        get: function(name, key) {

            var item = this.data[name];

            if (item) {

                return item[key];

            }

        },

        /**

         * For the given item, returns an object with all of the

         * item's property/value pairs. By default the object returned

         * is a shallow copy of the stored data, but passing in true

         * as the second parameter will return a reference to the stored

         * data.

         *

         * @method getAll

         * @param name {String} The name of the item

         * @param reference {boolean} true, if you want a reference to the stored

         * object

         * @return {Object} An object with property/value pairs for the item.

         */

        getAll : function(name, reference) {

            var item = this.data[name],

                key, obj;

            if (reference) {

                obj = item;

            } else if (item) {

                obj = {};

                for (key in item) {

                    if (item.hasOwnProperty(key)) {

                        obj[key] = item[key];

                    }

                }

            }

            return obj;

        }

    };

    /*For log lines*/

    /*jshint maxlen:200*/

    /**

     * The attribute module provides an augmentable Attribute implementation, which

     * adds configurable attributes and attribute change events to the class being

     * augmented. It also provides a State class, which is used internally by Attribute,

     * but can also be used independently to provide a name/property/value data structure to

     * store state.

     *

     * @module attribute

     */

    /**

     * The attribute-core submodule provides the lightest level of attribute handling support

     * without Attribute change events, or lesser used methods such as reset(), modifyAttrs(),

     * and removeAttr().

     *

     * @module attribute

     * @submodule attribute-core

     */

    var O = Y.Object,

        Lang = Y.Lang,

        DOT = ".",

        // Externally configurable props

        GETTER = "getter",

        SETTER = "setter",

        READ_ONLY = "readOnly",

        WRITE_ONCE = "writeOnce",

        INIT_ONLY = "initOnly",

        VALIDATOR = "validator",

        VALUE = "value",

        VALUE_FN = "valueFn",

        LAZY_ADD = "lazyAdd",

        // Used for internal state management

        ADDED = "added",

        BYPASS_PROXY = "_bypassProxy",

        INIT_VALUE = "initValue",

        LAZY = "lazy",

        INVALID_VALUE;

    /**

     * <p>

     * AttributeCore provides the lightest level of configurable attribute support. It is designed to be

     * augmented on to a host class, and provides the host with the ability to configure

     * attributes to store and retrieve state, <strong>but without support for attribute change events</strong>.

     * </p>

     * <p>For example, attributes added to the host can be configured:</p>

     * <ul>

     *     <li>As read only.</li>

     *     <li>As write once.</li>

     *     <li>With a setter function, which can be used to manipulate

     *     values passed to Attribute's <a href="#method_set">set</a> method, before they are stored.</li>

     *     <li>With a getter function, which can be used to manipulate stored values,

     *     before they are returned by Attribute's <a href="#method_get">get</a> method.</li>

     *     <li>With a validator function, to validate values before they are stored.</li>

     * </ul>

     *

     * <p>See the <a href="#method_addAttr">addAttr</a> method, for the complete set of configuration

     * options available for attributes.</p>

     *

     * <p>Object/Classes based on AttributeCore can augment <a href="AttributeObservable.html">AttributeObservable</a>

     * (with true for overwrite) and <a href="AttributeExtras.html">AttributeExtras</a> to add attribute event and

     * additional, less commonly used attribute methods, such as `modifyAttr`, `removeAttr` and `reset`.</p>

     *

     * @class AttributeCore

     * @param attrs {Object} The attributes to add during construction (passed through to <a href="#method_addAttrs">addAttrs</a>).

     *        These can also be defined on the constructor being augmented with Attribute by defining the ATTRS property on the constructor.

     * @param values {Object} The initial attribute values to apply (passed through to <a href="#method_addAttrs">addAttrs</a>).

     *        These are not merged/cloned. The caller is responsible for isolating user provided values if required.

     * @param lazy {boolean} Whether or not to add attributes lazily (passed through to <a href="#method_addAttrs">addAttrs</a>).

     */

    function AttributeCore(attrs, values, lazy) {

        // HACK: Fix #2531929

        // Complete hack, to make sure the first clone of a node value in IE doesn't doesn't hurt state - maintains 3.4.1 behavior.

        // Too late in the release cycle to do anything about the core problem.

        // The root issue is that cloning a Y.Node instance results in an object which barfs in IE, when you access it's properties (since 3.3.0).

        this._yuievt = null;

        this._initAttrHost(attrs, values, lazy);

    }

    /**

     * <p>The value to return from an attribute setter in order to prevent the set from going through.</p>

     *

     * <p>You can return this value from your setter if you wish to combine validator and setter

     * functionality into a single setter function, which either returns the massaged value to be stored or

     * AttributeCore.INVALID_VALUE to prevent invalid values from being stored.</p>

     *

     * @property INVALID_VALUE

     * @type Object

     * @static

     * @final

     */

    AttributeCore.INVALID_VALUE = {};

    INVALID_VALUE = AttributeCore.INVALID_VALUE;

    /**

     * The list of properties which can be configured for

     * each attribute (e.g. setter, getter, writeOnce etc.).

     *

     * This property is used internally as a whitelist for faster

     * Y.mix operations.

     *

     * @property _ATTR_CFG

     * @type Array

     * @static

     * @protected

     */

    AttributeCore._ATTR_CFG = [SETTER, GETTER, VALIDATOR, VALUE, VALUE_FN, WRITE_ONCE, READ_ONLY, LAZY_ADD, BYPASS_PROXY];

    /**

     * Utility method to protect an attribute configuration hash, by merging the

     * entire object and the individual attr config objects.

     *

     * @method protectAttrs

     * @static

     * @param {Object} attrs A hash of attribute to configuration object pairs.

     * @return {Object} A protected version of the `attrs` argument.

     */

    AttributeCore.protectAttrs = function (attrs) {

        if (attrs) {

            attrs = Y.merge(attrs);

            for (var attr in attrs) {

                if (attrs.hasOwnProperty(attr)) {

                    attrs[attr] = Y.merge(attrs[attr]);

                }

            }

        }

        return attrs;

    };

    AttributeCore.prototype = {

        /**

         * Constructor logic for attributes. Initializes the host state, and sets up the inital attributes passed to the

         * constructor.

         *

         * @method _initAttrHost

         * @param attrs {Object} The attributes to add during construction (passed through to <a href="#method_addAttrs">addAttrs</a>).

         *        These can also be defined on the constructor being augmented with Attribute by defining the ATTRS property on the constructor.

         * @param values {Object} The initial attribute values to apply (passed through to <a href="#method_addAttrs">addAttrs</a>).

         *        These are not merged/cloned. The caller is responsible for isolating user provided values if required.

         * @param lazy {boolean} Whether or not to add attributes lazily (passed through to <a href="#method_addAttrs">addAttrs</a>).

         * @private

         */

        _initAttrHost : function(attrs, values, lazy) {

            this._state = new Y.State();

            this._initAttrs(attrs, values, lazy);

        },

        /**

         * <p>

         * Adds an attribute with the provided configuration to the host object.

         * </p>

         * <p>

         * The config argument object supports the following properties:

         * </p>

         *

         * <dl>

         *    <dt>value &#60;Any&#62;</dt>

         *    <dd>The initial value to set on the attribute</dd>

         *

         *    <dt>valueFn &#60;Function | String&#62;</dt>

         *    <dd>

         *    <p>A function, which will return the initial value to set on the attribute. This is useful

         *    for cases where the attribute configuration is defined statically, but needs to

         *    reference the host instance ("this") to obtain an initial value. If both the value and valueFn properties are defined,

         *    the value returned by the valueFn has precedence over the value property, unless it returns undefined, in which

         *    case the value property is used.</p>

         *

         *    <p>valueFn can also be set to a string, representing the name of the instance method to be used to retrieve the value.</p>

         *    </dd>

         *

         *    <dt>readOnly &#60;boolean&#62;</dt>

         *    <dd>Whether or not the attribute is read only. Attributes having readOnly set to true

         *        cannot be modified by invoking the set method.</dd>

         *

         *    <dt>writeOnce &#60;boolean&#62; or &#60;string&#62;</dt>

         *    <dd>

         *        Whether or not the attribute is "write once". Attributes having writeOnce set to true,

         *        can only have their values set once, be it through the default configuration,

         *        constructor configuration arguments, or by invoking set.

         *        <p>The writeOnce attribute can also be set to the string "initOnly",

         *         in which case the attribute can only be set during initialization

         *        (when used with Base, this means it can only be set during construction)</p>

         *    </dd>

         *

         *    <dt>setter &#60;Function | String&#62;</dt>

         *    <dd>

         *    <p>The setter function used to massage or normalize the value passed to the set method for the attribute.

         *    The value returned by the setter will be the final stored value. Returning

         *    <a href="#property_Attribute.INVALID_VALUE">Attribute.INVALID_VALUE</a>, from the setter will prevent

         *    the value from being stored.

         *    </p>

         *

         *    <p>setter can also be set to a string, representing the name of the instance method to be used as the setter function.</p>

         *    </dd>

         *

         *    <dt>getter &#60;Function | String&#62;</dt>

         *    <dd>

         *    <p>

         *    The getter function used to massage or normalize the value returned by the get method for the attribute.

         *    The value returned by the getter function is the value which will be returned to the user when they

         *    invoke get.

         *    </p>

         *

         *    <p>getter can also be set to a string, representing the name of the instance method to be used as the getter function.</p>

         *    </dd>

         *

         *    <dt>validator &#60;Function | String&#62;</dt>

         *    <dd>

         *    <p>

         *    The validator function invoked prior to setting the stored value. Returning

         *    false from the validator function will prevent the value from being stored.

         *    </p>

         *

         *    <p>validator can also be set to a string, representing the name of the instance method to be used as the validator function.</p>

         *    </dd>

         *

         *    <dt>lazyAdd &#60;boolean&#62;</dt>

         *    <dd>Whether or not to delay initialization of the attribute until the first call to get/set it.

         *    This flag can be used to over-ride lazy initialization on a per attribute basis, when adding multiple attributes through

         *    the <a href="#method_addAttrs">addAttrs</a> method.</dd>

         *

         * </dl>

         *

         * <p>The setter, getter and validator are invoked with the value and name passed in as the first and second arguments, and with

         * the context ("this") set to the host object.</p>

         *

         * <p>Configuration properties outside of the list mentioned above are considered private properties used internally by attribute,

         * and are not intended for public use.</p>

         *

         * @method addAttr

         *

         * @param {String} name The name of the attribute.

         * @param {Object} config An object with attribute configuration property/value pairs, specifying the configuration for the attribute.

         *

         * <p>

         * <strong>NOTE:</strong> The configuration object is modified when adding an attribute, so if you need

         * to protect the original values, you will need to merge the object.

         * </p>

         *

         * @param {boolean} lazy (optional) Whether or not to add this attribute lazily (on the first call to get/set).

         *

         * @return {Object} A reference to the host object.

         *

         * @chainable

         */

        addAttr : function(name, config, lazy) {

            var host = this, // help compression

                state = host._state,

                data = state.data,

                value,

                added,

                hasValue;

            config = config || {};

            if (LAZY_ADD in config) {

                lazy = config[LAZY_ADD];

            }

            added = state.get(name, ADDED);

            if (lazy && !added) {

                state.data[name] = {

                    lazy : config,

                    added : true

                };

            } else {

                if (!added || config.isLazyAdd) {

                    hasValue = (VALUE in config);

                    if (hasValue) {

                        // We'll go through set, don't want to set value in config directly

                        // PERF TODO: VALIDATE: See if setting this to undefined is sufficient. We use to delete before.

                        // In certain code paths/use cases, undefined may not be the same as not present.

                        // If not, we can set it to some known fixed value (like INVALID_VALUE, say INITIALIZING_VALUE) for performance,

                        // to avoid a delete which seems to help a lot.

                        value = config.value;

                        config.value = undefined;

                    }

                    config.added = true;

                    config.initializing = true;

                    data[name] = config;

                    if (hasValue) {

                        // Go through set, so that raw values get normalized/validated

                        host.set(name, value);

                    }

                    config.initializing = false;

                }

            }

            return host;

        },

        /**

         * Checks if the given attribute has been added to the host

         *

         * @method attrAdded

         * @param {String} name The name of the attribute to check.

         * @return {boolean} true if an attribute with the given name has been added, false if it hasn't.

         *         This method will return true for lazily added attributes.

         */

        attrAdded: function(name) {

            return !!(this._state.get(name, ADDED));

        },

        /**

         * Returns the current value of the attribute. If the attribute

         * has been configured with a 'getter' function, this method will delegate

         * to the 'getter' to obtain the value of the attribute.

         *

         * @method get

         *

         * @param {String} name The name of the attribute. If the value of the attribute is an Object,

         * dot notation can be used to obtain the value of a property of the object (e.g. <code>get("x.y.z")</code>)

         *

         * @return {Any} The value of the attribute

         */

        get : function(name) {

            return this._getAttr(name);

        },

        /**

         * Checks whether or not the attribute is one which has been

         * added lazily and still requires initialization.

         *

         * @method _isLazyAttr

         * @private

         * @param {String} name The name of the attribute

         * @return {boolean} true if it's a lazily added attribute, false otherwise.

         */

        _isLazyAttr: function(name) {

            return this._state.get(name, LAZY);

        },

        /**

         * Finishes initializing an attribute which has been lazily added.

         *

         * @method _addLazyAttr

         * @private

         * @param {Object} name The name of the attribute

         * @param {Object} [lazyCfg] Optional config hash for the attribute. This is added for performance

         * along the critical path, where the calling method has already obtained lazy config from state.

         */

        _addLazyAttr: function(name, lazyCfg) {

            var state = this._state;

            lazyCfg = lazyCfg || state.get(name, LAZY);

            if (lazyCfg) {

                // PERF TODO: For App's id override, otherwise wouldn't be

                // needed. It expects to find it in the cfg for it's

                // addAttr override. Would like to remove, once App override is

                // removed.

                state.data[name].lazy = undefined;

                lazyCfg.isLazyAdd = true;

                this.addAttr(name, lazyCfg);

            }

        },

        /**

         * Sets the value of an attribute.

         *

         * @method set

         * @chainable

         *

         * @param {String} name The name of the attribute. If the

         * current value of the attribute is an Object, dot notation can be used

         * to set the value of a property within the object (e.g. <code>set("x.y.z", 5)</code>).

         * @param {Any} value The value to set the attribute to.

         * @param {Object} [opts] Optional data providing the circumstances for the change.

         * @return {Object} A reference to the host object.

         */

        set : function(name, val, opts) {

            return this._setAttr(name, val, opts);

        },

        /**

         * Allows setting of readOnly/writeOnce attributes. See <a href="#method_set">set</a> for argument details.

         *

         * @method _set

         * @protected

         * @chainable

         *

         * @param {String} name The name of the attribute.

         * @param {Any} val The value to set the attribute to.

         * @param {Object} [opts] Optional data providing the circumstances for the change.

         * @return {Object} A reference to the host object.

         */

        _set : function(name, val, opts) {

            return this._setAttr(name, val, opts, true);

        },

        /**

         * Provides the common implementation for the public set and protected _set methods.

         *

         * See <a href="#method_set">set</a> for argument details.

         *

         * @method _setAttr

         * @protected

         * @chainable

         *

         * @param {String} name The name of the attribute.

         * @param {Any} value The value to set the attribute to.

         * @param {Object} [opts] Optional data providing the circumstances for the change.

         * @param {boolean} force If true, allows the caller to set values for

         * readOnly or writeOnce attributes which have already been set.

         *

         * @return {Object} A reference to the host object.

         */

        _setAttr : function(name, val, opts, force)  {

            var allowSet = true,

                state = this._state,

                stateProxy = this._stateProxy,

                tCfgs = this._tCfgs,

                cfg,

                initialSet,

                strPath,

                path,

                currVal,

                writeOnce,

                initializing;

            if (name.indexOf(DOT) !== -1) {

                strPath = name;

                path = name.split(DOT);

                name = path.shift();

            }

            // On Demand - Should be rare - handles out of order valueFn, setter, getter references

            if (tCfgs && tCfgs[name]) {

                this._addOutOfOrder(name, tCfgs[name]);

            }

            cfg = state.data[name] || {};

            if (cfg.lazy) {

                cfg = cfg.lazy;

                this._addLazyAttr(name, cfg);

            }

            initialSet = (cfg.value === undefined);

            if (stateProxy && name in stateProxy && !cfg._bypassProxy) {

                // TODO: Value is always set for proxy. Can we do any better? Maybe take a snapshot as the initial value for the first call to set?

                initialSet = false;

            }

            writeOnce = cfg.writeOnce;

            initializing = cfg.initializing;

            if (!initialSet && !force) {

                if (writeOnce) {

                    allowSet = false;

                }

                if (cfg.readOnly) {

                    allowSet = false;

                }

            }

            if (!initializing && !force && writeOnce === INIT_ONLY) {

                allowSet = false;

            }

            if (allowSet) {

                // Don't need currVal if initialSet (might fail in custom getter if it always expects a non-undefined/non-null value)

                if (!initialSet) {

                    currVal =  this.get(name);

                }

                if (path) {

                   val = O.setValue(Y.clone(currVal), path, val);

                   if (val === undefined) {

                       allowSet = false;

                   }

                }

                if (allowSet) {

                    if (!this._fireAttrChange || initializing) {

                        this._setAttrVal(name, strPath, currVal, val, opts, cfg);

                    } else {

                        // HACK - no real reason core needs to know about _fireAttrChange, but

                        // it adds fn hops if we want to break it out. Not sure it's worth it for this critical path

                        this._fireAttrChange(name, strPath, currVal, val, opts, cfg);

                    }

                }

            }

            return this;

        },

        /**

         * Utility method used by get/set to add attributes

         * encountered out of order when calling addAttrs().

         *

         * For example, if:

         *

         *     this.addAttrs({

         *          foo: {

         *              setter: function() {

         *                 // make sure this bar is available when foo is added

         *                 this.get("bar");

         *              }

         *          },

         *          bar: {

         *              value: ...

         *          }

         *     });

         *

         * @method _addOutOfOrder

         * @private

         * @param name {String} attribute name

         * @param cfg {Object} attribute configuration

         */

        _addOutOfOrder : function(name, cfg) {

            var attrs = {};

            attrs[name] = cfg;

            delete this._tCfgs[name];

            // TODO: The original code went through addAttrs, so

            // sticking with it for this pass. Seems like we could

            // just jump straight to _addAttr() and get some perf

            // improvement.

            this._addAttrs(attrs, this._tVals);

        },

        /**

         * Provides the common implementation for the public get method,

         * allowing Attribute hosts to over-ride either method.

         *

         * See <a href="#method_get">get</a> for argument details.

         *

         * @method _getAttr

         * @protected

         * @chainable

         *

         * @param {String} name The name of the attribute.

         * @return {Any} The value of the attribute.

         */

        _getAttr : function(name) {

            var fullName = name,

                tCfgs = this._tCfgs,

                path,

                getter,

                val,

                attrCfg;

            if (name.indexOf(DOT) !== -1) {

                path = name.split(DOT);

                name = path.shift();

            }

            // On Demand - Should be rare - handles out of

            // order valueFn, setter, getter references

            if (tCfgs && tCfgs[name]) {

                this._addOutOfOrder(name, tCfgs[name]);

            }

            attrCfg = this._state.data[name] || {};

            // Lazy Init

            if (attrCfg.lazy) {

                attrCfg = attrCfg.lazy;

                this._addLazyAttr(name, attrCfg);

            }

            val = this._getStateVal(name, attrCfg);

            getter = attrCfg.getter;

            if (getter && !getter.call) {

                getter = this[getter];

            }

            val = (getter) ? getter.call(this, val, fullName) : val;

            val = (path) ? O.getValue(val, path) : val;

            return val;

        },

        /**

         * Gets the stored value for the attribute, from either the

         * internal state object, or the state proxy if it exits

         *

         * @method _getStateVal

         * @private

         * @param {String} name The name of the attribute

         * @param {Object} [cfg] Optional config hash for the attribute. This is added for performance along the critical path,

         * where the calling method has already obtained the config from state.

         *

         * @return {Any} The stored value of the attribute

         */

        _getStateVal : function(name, cfg) {

            var stateProxy = this._stateProxy;

            if (!cfg) {

                cfg = this._state.getAll(name) || {};

            }

            return (stateProxy && (name in stateProxy) && !(cfg._bypassProxy)) ? stateProxy[name] : cfg.value;

        },

        /**

         * Sets the stored value for the attribute, in either the

         * internal state object, or the state proxy if it exits

         *

         * @method _setStateVal

         * @private

         * @param {String} name The name of the attribute

         * @param {Any} value The value of the attribute

         */

        _setStateVal : function(name, value) {

            var stateProxy = this._stateProxy;

            if (stateProxy && (name in stateProxy) && !this._state.get(name, BYPASS_PROXY)) {

                stateProxy[name] = value;

            } else {

                this._state.add(name, VALUE, value);

            }

        },

        /**

         * Updates the stored value of the attribute in the privately held State object,

         * if validation and setter passes.

         *

         * @method _setAttrVal

         * @private

         * @param {String} attrName The attribute name.

         * @param {String} subAttrName The sub-attribute name, if setting a sub-attribute property ("x.y.z").

         * @param {Any} prevVal The currently stored value of the attribute.

         * @param {Any} newVal The value which is going to be stored.

         * @param {Object} [opts] Optional data providing the circumstances for the change.

         * @param {Object} [attrCfg] Optional config hash for the attribute. This is added for performance along the critical path,

         * where the calling method has already obtained the config from state.

         *

         * @return {Boolean} true if the new attribute value was stored, false if not.

         */

        _setAttrVal : function(attrName, subAttrName, prevVal, newVal, opts, attrCfg) {

            var host = this,

                allowSet = true,

                cfg = attrCfg || this._state.data[attrName] || {},

                validator = cfg.validator,

                setter = cfg.setter,

                initializing = cfg.initializing,

                prevRawVal = this._getStateVal(attrName, cfg),

                name = subAttrName || attrName,

                retVal,

                valid;

            if (validator) {

                if (!validator.call) {

                    // Assume string - trying to keep critical path tight, so avoiding Lang check

                    validator = this[validator];

                }

                if (validator) {

                    valid = validator.call(host, newVal, name, opts);

                    if (!valid && initializing) {

                        newVal = cfg.defaultValue;

                        valid = true; // Assume it's valid, for perf.

                    }

                }

            }

            if (!validator || valid) {

                if (setter) {

                    if (!setter.call) {

                        // Assume string - trying to keep critical path tight, so avoiding Lang check

                        setter = this[setter];

                    }

                    if (setter) {

                        retVal = setter.call(host, newVal, name, opts);

                        if (retVal === INVALID_VALUE) {

                            if (initializing) {

                                newVal = cfg.defaultValue;

                            } else {

                                allowSet = false;

                            }

                        } else if (retVal !== undefined){

                            newVal = retVal;

                        }

                    }

                }

                if (allowSet) {

                    if(!subAttrName && (newVal === prevRawVal) && !Lang.isObject(newVal)) {

                        allowSet = false;

                    } else {

                        // Store value

                        if (!(INIT_VALUE in cfg)) {

                            cfg.initValue = newVal;

                        }

                        host._setStateVal(attrName, newVal);

                    }

                }

            } else {

                allowSet = false;

            }

            return allowSet;

        },

        /**

         * Sets multiple attribute values.

         *

         * @method setAttrs

         * @param {Object} attrs  An object with attributes name/value pairs.

         * @param {Object} [opts] Optional data providing the circumstances for the change.

         * @return {Object} A reference to the host object.

         * @chainable

         */

        setAttrs : function(attrs, opts) {

            return this._setAttrs(attrs, opts);

        },

        /**

         * Implementation behind the public setAttrs method, to set multiple attribute values.

         *

         * @method _setAttrs

         * @protected

         * @param {Object} attrs  An object with attributes name/value pairs.

         * @param {Object} [opts] Optional data providing the circumstances for the change

         * @return {Object} A reference to the host object.

         * @chainable

         */

        _setAttrs : function(attrs, opts) {

            var attr;

            for (attr in attrs) {

                if ( attrs.hasOwnProperty(attr) ) {

                    this.set(attr, attrs[attr], opts);

                }

            }

            return this;

        },

        /**

         * Gets multiple attribute values.

         *

         * @method getAttrs

         * @param {String[]|Boolean} attrs Optional. An array of attribute names. If omitted, all attribute values are

         * returned. If set to true, all attributes modified from their initial values are returned.

         * @return {Object} An object with attribute name/value pairs.

         */

        getAttrs : function(attrs) {

            return this._getAttrs(attrs);

        },

        /**

         * Implementation behind the public getAttrs method, to get multiple attribute values.

         *

         * @method _getAttrs

         * @protected

         * @param {String[]|Boolean} attrs Optional. An array of attribute names. If omitted, all attribute values are

         * returned. If set to true, all attributes modified from their initial values are returned.

         * @return {Object} An object with attribute name/value pairs.

         */

        _getAttrs : function(attrs) {

            var obj = {},

                attr, i, len,

                modifiedOnly = (attrs === true);

            // TODO - figure out how to get all "added"

            if (!attrs || modifiedOnly) {

                attrs = O.keys(this._state.data);

            }

            for (i = 0, len = attrs.length; i < len; i++) {

                attr = attrs[i];

                if (!modifiedOnly || this._getStateVal(attr) != this._state.get(attr, INIT_VALUE)) {

                    // Go through get, to honor cloning/normalization

                    obj[attr] = this.get(attr);

                }

            }

            return obj;

        },

        /**

         * Configures a group of attributes, and sets initial values.

         *

         * <p>

         * <strong>NOTE:</strong> This method does not isolate the configuration object by merging/cloning.

         * The caller is responsible for merging/cloning the configuration object if required.

         * </p>

         *

         * @method addAttrs

         * @chainable

         *

         * @param {Object} cfgs An object with attribute name/configuration pairs.

         * @param {Object} values An object with attribute name/value pairs, defining the initial values to apply.

         * Values defined in the cfgs argument will be over-written by values in this argument unless defined as read only.

         * @param {boolean} lazy Whether or not to delay the intialization of these attributes until the first call to get/set.

         * Individual attributes can over-ride this behavior by defining a lazyAdd configuration property in their configuration.

         * See <a href="#method_addAttr">addAttr</a>.

         *

         * @return {Object} A reference to the host object.

         */

        addAttrs : function(cfgs, values, lazy) {

            if (cfgs) {

                this._tCfgs = cfgs;

                this._tVals = (values) ? this._normAttrVals(values) : null;

                this._addAttrs(cfgs, this._tVals, lazy);

                this._tCfgs = this._tVals = null;

            }

            return this;

        },

        /**

         * Implementation behind the public addAttrs method.

         *

         * This method is invoked directly by get if it encounters a scenario

         * in which an attribute's valueFn attempts to obtain the

         * value an attribute in the same group of attributes, which has not yet

         * been added (on demand initialization).

         *

         * @method _addAttrs

         * @private

         * @param {Object} cfgs An object with attribute name/configuration pairs.

         * @param {Object} values An object with attribute name/value pairs, defining the initial values to apply.