update elements and fix some bugs

lib/src/iron-iconset/iron-iconset.html

 <!--
 @license
 Copyright (c) 2015 The Polymer Project Authors. All rights reserved.
 This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE.txt
 The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt
 The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS.txt
 Code distributed by Google as part of the polymer project is also
 subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt
 -->
 
@@ skipping 41 matching lines @@
 Then a themed icon can be applied like this:
 
     iconset.applyIcon(iconNode, 'car', 'special');
 
 @element iron-iconset
 @demo demo/index.html
 -->
 
 <script>
 
+  /**
+   * @implements {Polymer.Iconset}
+   */
   Polymer({
 
     is: 'iron-iconset',
 
     properties: {
 
       /**
        * The URL of the iconset image.
-       *
-       * @attribute src
-       * @type string
-       * @default ''
        */
       src: {
         type: String,
         observer: '_srcChanged'
       },
 
       /**
        * The name of the iconset.
-       *
-       * @attribute name
-       * @type string
-       * @default 'no-name'
        */
       name: {
         type: String,
         observer: '_nameChanged'
       },
 
       /**
        * The width of the iconset image. This must only be specified if the
        * icons are arranged into separate rows inside the image.
        *
        * @attribute width
        * @type number
        * @default 0
        */
       width: {
         type: Number,
         value: 0
       },
 
       /**
        * A space separated list of names corresponding to icons in the iconset
        * image file. This list must be ordered the same as the icon images
        * in the image file.
-       *
-       * @attribute icons
-       * @type string
-       * @default ''
        */
       icons: {
         type: String
       },
 
       /**
        * The size of an individual icon. Note that icons must be square.
-       *
-       * @attribute size
-       * @type number
-       * @default 24
        */
       size: {
         type: Number,
         value: 24
       },
 
       /**
        * The horizontal offset of the icon images in the inconset src image.
        * This is typically used if the image resource contains additional images
        * beside those intended for the iconset.
-       *
-       * @attribute offset-x
-       * @type number
-       * @default 0
        */
       _offsetX: {
         type: Number,
         value: 0
       },
 
       /**
        * The vertical offset of the icon images in the inconset src image.
        * This is typically used if the image resource contains additional images
        * beside those intended for the iconset.
-       *
-       * @attribute offset-y
-       * @type number
-       * @default 0
        */
       _offsetY: {
         type: Number,
         value: 0
       },
 
       /**
        * Array of fully-qualified names of icons in this set.
        */
       iconNames: {
@@ skipping 11 matching lines @@
     ready: function() {
       // theme data must exist at ready-time
       this._themes = this._mapThemes();
     },
 
     /**
      * Applies an icon to the given element as a css background image. This
      * method does not size the element, and it's usually necessary to set
      * the element's height and width so that the background image is visible.
      *
-     * @method applyIcon
      * @param {Element} element The element to which the icon is applied.
-     * @param {String|Number} icon The name or index of the icon to apply.
-     * @param {String} theme (optional) The name or index of the icon to apply.
-     * @param {Number} scale (optional, defaults to 1) Icon scaling factor.
+     * @param {string|number} icon The name or index of the icon to apply.
+     * @param {string=} theme (optional) The name or index of the icon to apply.
+     * @param {number=} scale (optional, defaults to 1) Icon scaling factor.
      */
     applyIcon: function(element, icon, theme, scale) {
       this._validateIconMap();
       var offset = this._getThemedOffset(icon, theme);
       if (element && offset) {
         this._addIconStyles(element, this._srcUrl, offset, scale || 1,
           this.size, this.width);
       }
     },
 
@@ skipping 31 matching lines @@
         ? this.resolveUrl(src) : src;
       this._prepareIconset();
     },
 
     _nameChanged: function(name) {
       this._prepareIconset();
     },
 
     _prepareIconset: function() {
       new Polymer.IronMeta({type: 'iconset', key: this.name, value: this});
+      this.async(function() {
+        this.fire('iron-iconset-added', this, {node: window});
+      });
     },
 
     _invalidateIconMap: function() {
       this._iconMapValid = false;
     },
 
     _validateIconMap: function() {
       if (!this._iconMapValid) {
         this._recomputeIconMap();
         this._iconMapValid = true;
@@ skipping 30 matching lines @@
       return iconMap;
     },
 
     /**
      * Returns an object containing `offsetX` and `offsetY` properties which
      * specify the pixel location in the iconset's src file for the given
      * `icon` and `theme`. It's uncommon to call this method. It is useful,
      * for example, to manually position a css backgroundImage to the proper
      * offset. It's more common to use the `applyIcon` method.
      *
-     * @method getThemedOffset
-     * @param {String|Number} identifier The name of the icon or the index of
+     * @param {string|number} identifier The name of the icon or the index of
      * the icon within in the icon image.
-     * @param {String} theme The name of the theme.
-     * @returns {Object} An object specifying the offset of the given icon
-     * within the icon resource file; `offsetX` is the horizontal offset and
-     * `offsetY` is the vertical offset. Both values are in pixel units.
+     * @param {string=} theme The name of the theme.
+     * @returns {?{offsetX: number, offsetY: number}} An object specifying the
+     *     offset of the given icon within the icon resource file; `offsetX` is
+     *     the horizontal offset and `offsetY` is the vertical offset. Both
+     *     values are in pixel units.
      */
     _getThemedOffset: function(identifier, theme) {
       var iconOffset = this._getIconOffset(identifier);
       var themeOffset = this._themes[theme];
       if (iconOffset && themeOffset) {
         return {
           offsetX: iconOffset.offsetX + themeOffset.offsetX,
           offsetY: iconOffset.offsetY + themeOffset.offsetY
         };
       }
@@ skipping 21 matching lines @@
       element.setAttribute('role', 'img');
     },
 
     _removeIconStyles: function(style) {
       style.background = '';
     }
 
   });
 
 </script>