text: /**
      @module "montage/ui/native/select.reel"
  */
  
  var Bindings = require("montage/core/bindings").Bindings,
      RangeController = require("montage/core/range-controller").RangeController,
      NativeControl = require("ui/native-control").NativeControl,
      PressComposer = require("montage/composer/press-composer").PressComposer;
  
  /**
      Wraps the a &lt;select&gt; element with binding support for the element's
      standard attributes. Uses an ArrayController instance to manage the
      element's contents and selection.
      @class module:"montage/ui/native/select.reel".Select
      @extends module:montage/ui/native-control.NativeControl
      @summary
      If the &lt;select&gt; markup contains <option> is provided in the markup
      and <code>contentController</code> is not, the
      <code>contentController</code> collection is populated with the options
      from the markup. If <code>contentController</code> is present, any options
      in the markup are overwritten by the values from the
      <code>contentController</code> when they are available.
   */
  var Select = exports.Select =  NativeControl.specialize(/** @lends module:"montage/ui/native/select.reel".Select */ {
  
      _fromInput: {value: null},
      _synching: {value: null},
      //_internalSet: {value: null},
  
      _selectedIndexes: {
          value: null
      },
  
      selectedIndexes: {
          get: function() {
              return this._selectedIndexes;
          },
          set: function(selectedIndexes) {
              var content = this.content,
                  values = [];
  
              for (var i = 0, ii = selectedIndexes.length; i < ii; i++) {
                  values.push(content[selectedIndexes[i]][this.valuePropertyPath || 'value']);
              }
  
              // values should be automatically created by a binding
              if (selectedIndexes.length <= 1) {
                  this.value = values[0];
              } else {
                  this.values = values;
              }
          }
      },
  
      constructor: {
          value: function Select() {
              this.super();
  
              this._selectedIndexes = [];
              this._selectedIndexes.addRangeChangeListener(this, "selectedIndexes");
          }
      },
  
      handleSelectedIndexesRangeChange: {
          value: function() {
              if(this.needsDraw === false) {
                  this.needsDraw = this._synching || !this._fromInput;
              }
          }
      },
  
      _setContentControllerSelectedIndexes: {
          value: function(selectedIndexes) {
              var content = this.content,
                  selection = this._contentController.selection,
                  ix;
  
              for (var i = 0, ii = content.length; i < ii; i++) {
                  if (selectedIndexes.indexOf(i) >= 0) {
                      // If the item was selected in the Select then add it
                      // to the controller selection if it isn't there.
                      if (selection.indexOf(content[i]) === -1) {
                          selection.push(content[i]);
                      }
                  } else {
                      ix = selection.indexOf(content[i]);
                      // If the item is deselected in the Select then remove it
                      // from the controller selection if it is there.
                      if (ix >= 0) {
                          selection.splice(ix, 1);
                      }
                  }
              }
          }
      },
  
      //-----------------------
      // Public API
      //-----------------------
  
      _content: {value: null, enumerable: false},
  /**
      An array of items to to assign to the component's
      <code>contentController</code> property, which is a RangeController.
  */
      content: {
          set: function(value) {
              //if(!Array.isArray(value)) {
              //    value = [value];
              //}
              this._content = value;
  
              if(!this.contentController) {
                  var contentController = new RangeController();
                  contentController.content = value;
                  contentController.selection = [];
                  this.contentController = contentController;
              }
  
              this.needsDraw = true;
          },
          get: function() {
              return this._content;
          }
      },
  
      // If a <code>contentController</code> is provided, this allows the developer to specify
      // which property in each element provides the "value" part of <option>
      /**
          Specifies the property belonging to the component's <code>contentController</code> to use as the "value" part of the <option>.
      */
      valuePropertyPath: {
          value: null
      },
  
      /**
          Specifies the property belonging to the component's <code>contentController</code> to use as the text content of the <option>.
      */
      textPropertyPath: {
          value: null
      },
  
  
      _contentController: {
          value: null
      },
  
  /**
      An ArrayController instance used to manage the content and selection of the select input control.
      @default null
  */
      contentController: {
          get: function() {
              return this._contentController;
          },
          set: function(value) {
              if (this._contentController === value) {
                  return;
              }
  
              this._contentController = value;
              value.multiSelect = this.multiple;
  
              Bindings.defineBindings(this, {
                  "content": {"<-": "_contentController.organizedContent"},
                  "_selection": {"<-": "_contentController.selection"},
                  "_selectedIndexes.rangeContent()": {
                      "<-": "content.enumerate().filter{$_selection.has(.1)}.map{.0}"
                  }
              });
          }
      },
  
      _getSelectedValuesFromIndexes: {
          value: function() {
              var selectedIndexes = this._selectedIndexes,
                  content = this._content,
                  arr,
                  length = selectedIndexes.length,
                  valuePath;
  
              if(length > 0) {
                  arr = [];
                  valuePath = this.valuePropertyPath || 'value';
  
                  for (var i = 0; i < length; i++) {
                      if (content[selectedIndexes[i]][valuePath]) {
                          arr.push(content[selectedIndexes[i]][valuePath]);
                      }
                  }
              }
  
              return arr;
          }
      },
  
      _synchValues: {
          value: function() {
              if(!this._synching) {
                  this._synching = true;
                  this.values = this._getSelectedValuesFromIndexes();
                  this.value = ((this.values && this.values.length > 0) ? this.values[0] : null);
                  this._synching = false;
              }
          }
      },
  
  
      // TODO: values could be automatically created by
      // iterations.selections.map{value}
      _values: {value: null},
      values: {
          get: function() {
              return this._values;
          },
          set: function(valuesArray) {
              var content = this.content;
  
              if(valuesArray && content) {
                  this._values = valuesArray;
  
                  if(!this._synching) {
                      var selectedIndexes = [];
                      var i=0, len = this._values.length, index;
  
                      for(; i<len; i++) {
                          index = this._indexOf(this._values[i]);
                          if(index >= 0) {
                              selectedIndexes.push(index);
                          }
                      }
  
                      this._synching = true;
                      this._setContentControllerSelectedIndexes(selectedIndexes);
                      this._synching = false;
                  }
              }
          }
          //dependencies: ["_selectedIndexes"]
      },
  
      // TODO: values could be automatically created by
      // selection.0.value
      _value: {value: null},
      value: {
          get: function() {
              return this._value;
          },
          set: function(value) {
              this._value = value;
  
              if(!this._synching) {
                  if(value == null) {
                      this.values = [];
                  } else {
                      this.values = [value];
                  }
              }
  
  
          }
          //dependencies: ["_selectedIndexes"]
      },
  
      // HTMLSelectElement methods
  
      // add() and remove() deliberately omitted. Use the contentController instead
      blur: { value: function() { this._element.blur(); } },
      focus: { value: function() { this._element.focus(); } },
  
      // -------------------
      // Montage Callbacks
      // --------------------
  
      _addOptionsFromMarkup: {
          value: function() {
  
              var el = this.element, options = el.querySelectorAll('option');
              // @todo: if contentController is provided, should we just ignore the <option>
              // from the markup ?
  
              // create a new RangeController if one is not provided
              // add options to contentController
              // look for selected options in the markup and mark these as selected
              if(!this.contentController) {
                  var contentController = new RangeController();
                  var selection = [];
                  var content = [];
  
                  if(options && options.length > 0) {
                      var i=0, len = options.length, selected;
                      for(; i< len; i++) {
                          selected = options[i].getAttribute('selected');
                          var object = {
                              value: options[i].value,
                              text: options[i].textContent
                          };
                          if (selected) {
                              selection.push(object);
                          }
                          content.push(object);
                      }
  
                      if (selection.length === 0 && len > 0) {
                          // nothing is marked as selected by default. Select the
                          // first one (gh-122)
                          selection.push(content[0]);
                      }
                      this._fromInput = true;
                      this.contentController = contentController;
                      contentController.content = content;
                      contentController.selection = selection;
                  }
              }
  
          }
      },
  
  
      deserializedFromTemplate: {
          value: function() {
  
              /*
              1) If <option> is provided in the markup but contentController is not,
              fill the contentController with the options from the markup
              2) If contentController is present, options from markup will be overwritten
              by the values from contentController when they are available
              */
              this._addOptionsFromMarkup();
          }
      },
  
  
      _removeAll: {
          value: function(elem) {
              // remove all existing options
              while (elem.firstChild ) {
                  elem.removeChild( elem.firstChild );
              }
          }
      },
  
      _refreshOptions: {
          value: function() {
              var arr = this.content||[], len = arr.length, i, option;
              var text, value;
              for(i=0; i< len; i++) {
                  option = document.createElement('option');
                  if(typeof arr[i] === "string") {
                      text = value = arr[i];
                  } else {
                      text = arr[i][this.textPropertyPath || 'text'];
                      value = arr[i][this.valuePropertyPath  || 'value'];
                  }
  
                  option.value = value;
                  option.textContent = text || value;
  
                  if (this._selectedIndexes && this._selectedIndexes.length > 0) {
                      if(this._selectedIndexes.indexOf(i) >= 0) {
                          option.setAttribute("selected", "true");
                      }
                  }
                  this.element.appendChild(option);
              }
  
              // Make sure we have the model synchronized with the changes in the
              // DOM.
              if (this._selectedIndexes.length === 0 &&
                  this.element.selectedIndex >= 0) {
                  this._selectedIndexes[0] = this.element.selectedIndex;
              }
          }
      },
  
      /**
      Description TODO
      @function
      */
      enterDocument: {
          value: function(firstTime) {
              if (firstTime) {
                  this.element.addEventListener("focus", this);
                  this.element.addEventListener('change', this);
              }
          }
      },
  
      prepareForActivationEvents: {
          value: function() {
              // add pressComposer to handle the claimPointer related work
              var pressComposer = new PressComposer();
              this.addComposer(pressComposer);
          }
      },
  
      /**
      Description TODO
      @function
      */
      draw: {
          enumerable: false,
          value: function() {
              var elem = this.element;
  
              this._fromInput = false;
              this._synching = false;
  
              this._removeAll(elem);
              this._refreshOptions();
  
              this.super();
          }
      },
  
      didDraw: {
          value: function() {
              this._synchValues();
          }
      },
  
  
  
      // find the index of the object with the specified value in the _content array
      _indexOf: {
          value: function(val) {
              var arr = this.content||[], len = arr.length, i;
              var text, value;
              for(i=0; i< len; i++) {
                  if(typeof arr[i] === "string") {
                      value = arr[i];
                  } else {
                      value = arr[i][this.valuePropertyPath  || 'value'];
                  }
                  if(value && value === val) {
                      return i;
                  }
              }
              return -1;
          }
      },
  
      _getSelectedOptions: {
          value: function(selectEl) {
              var options = selectEl.querySelectorAll('option');
              // TODO: looks like querySelectorAll('option[selected]') only returns the default selected
              // value
              var i, len = options.length, arr = [];
              for(i=0; i< len; i++) {
                  if(options[i].selected) {
                      arr.push(options[i]);
                  }
              }
              return arr;
          }
      },
  
      _getSelectedOptionsIndexes: {
          value: function(selectEl) {
              var options = selectEl.querySelectorAll('option');
              // TODO: looks like querySelectorAll('option[selected]') only
              // returns the default selected value
              var i, len = options.length, arr = [];
              for(i=0; i< len; i++) {
                  if(options[i].selected) {
                      arr.push(i);
                  }
              }
              return arr;
          }
      },
  
      handleChange: {
          value: function(e) {
              // get selected values and set it on the contentController
              //var selectedOptions = this.element.selectedOptions || [];
              // select.selectedOptions does not work on Chrome !
  
              var arr = this._getSelectedOptionsIndexes(this.element);
  
              if(arr.length > 0) {
                  this._fromInput = true;
                  this._synching = false;
                  this._setContentControllerSelectedIndexes(arr);
                  this._synchValues();
              }
              this._dispatchActionEvent();
          }
      }
  
  
  });
  
  //http://www.w3.org/TR/html5/the-button-element.html#the-select-element
  
  Select.addAttributes( /** @lends module:"montage/ui/native/select.reel".Select */ {
  /**
      Specifies whether the element should be focused as soon as the page is loaded.
      @type {boolean}
      @default false
  */
          autofocus: {dataType: 'boolean'},
  
  /**
      When true, the select control is disabled to user input and "disabled" is added to its CSS class list.
      @type {boolean}
      @default false
  */
          disabled: {dataType: 'boolean'},
  
  /**
      The value of the <code>id</code> attribute of the form with which to associate the component's element.
      @type string}
      @default null
  */
          form: null,
  /**
      Specifies if multiple selections are enabled on the select element.
      @type {boolean}
      @default false
  */
          multiple: {dataType: 'boolean'},
  
  /**
      The name associated with the select input element.
      @type {string}
      @default null
  */
          name: null,
  
  /**
      When true, the user will be required to select a value from the control before submitting the form.
      @type {string}
      @default false
  */
          required: {dataType: 'boolean'},
  
  /**
     The number of options from the select element to display to the user.
     @type {number}
     @default 1
  */
          size: {dataType: 'number', value: '1'}
  });
  
  