SOURCE CODE: Uize.Widget.Dialog.Picker.Palette.Selector

/*______________
|       ______  |   U I Z E    J A V A S C R I P T    F R A M E W O R K
|     /      /  |   ---------------------------------------------------
|    /    O /   |    MODULE : Uize.Widget.Dialog.Picker.Palette.Selector
|   /    / /    |
|  /    / /  /| |    ONLINE : http://uize.com
| /____/ /__/_| | COPYRIGHT : (c)2011-2014 UIZE
|          /___ |   LICENSE : Available under MIT License or GNU General Public License
|_______________|             http://uize.com/license.html
*/

/* Module Meta Data
  type: Class
  importance: 4
  codeCompleteness: 50
  docCompleteness: 0
*/

/*?
  Introduction
    The =Uize.Widget.Dialog.Picker.Palette.Selector= widget lets the user select a value from a modal dialog containing a set of options (i.e. a droplist).

    *DEVELOPERS:* `Ben Ilegbodu`, original code contributed by `Zazzle Inc.`
*/

Uize.module ({
  name:'Uize.Widget.Dialog.Picker.Palette.Selector',
  required:[
    'Uize.Widget.Options.Selector',
    'Uize.Util.Coupler'
  ],
  builder:function (_superclass) {
    'use strict';

    /*** Private Instance Methods ***/
      function _fireSubmissionComplete (_propertiesChanged) {
        this.fireSubmissionComplete (true, _propertiesChanged);
      }

    return _superclass.subclass ({
      omegastructor:function () {
        var
          m = this,
          _valueWidget = m.children.value
        ;
        m.wire(
          'After Show',
          function () { _valueWidget.updateUi() }
        );
        Uize.Util.Coupler({
          instances:[m, _valueWidget],
          properties:['valueNo', 'tentativeValueNo']
        });
      },

      stateProperties:{
        _tentativeValueNo:{
          name:'tentativeValueNo',  // read-only
          onChange:_fireSubmissionComplete,
          value:-1
        },
        _valueNo:{
          name:'valueNo',  // read-only
          onChange:_fireSubmissionComplete,
          value:-1
        },
        _values:{
          name:'values',
          value:[]
        }
      },

      set:{
        pipedProperties:['values'],
        valueWidgetClass:Uize.Widget.Options.Selector,
        shieldOpacity:.01
      }
    });
  }
});