Merge pull request #5300 from Polymer/2.x-typescript

Updates to Polymer 2.x for latest type generator changes
Polymer · Jul 27, 2018 · d59546d · d59546d
2 parents 654f904 + 7f68ab5
commit d59546d
Show file tree

Hide file tree

Showing 33 changed files with 9,003 additions and 7,118 deletions.
diff --git a/externs/closure-types.js b/externs/closure-types.js
@@ -246,7 +246,7 @@ Polymer_TemplateStamp.prototype._addMethodEventListenerToNode = function(node, e
 */
 Polymer_TemplateStamp.prototype._addEventListenerToNode = function(node, eventName, handler){};
 /**
-* @param {Node} node Node to remove event listener from
+* @param {!Node} node Node to remove event listener from
 * @param {string} eventName Name of event
 * @param {function (!Event): void} handler Listener function to remove
 * @return {void}

diff --git a/lib/elements/array-selector.html b/lib/elements/array-selector.html
@@ -43,6 +43,7 @@
      * @constructor
      * @extends {superClass}
      * @implements {Polymer_ElementMixin}
+     * @private
      */
     let elementBase = Polymer.ElementMixin(superClass);
 
@@ -347,6 +348,7 @@
    * @constructor
    * @extends {Polymer.Element}
    * @implements {Polymer_ArraySelectorMixin}
+   * @private
    */
   let baseArraySelector = ArraySelectorMixin(Polymer.Element);
 

diff --git a/lib/elements/dom-bind.html b/lib/elements/dom-bind.html
@@ -24,6 +24,7 @@
      * @implements {Polymer_PropertyEffects}
      * @implements {Polymer_OptionalMutableData}
      * @implements {Polymer_GestureEventListeners}
+     * @private
      */
     const domBindBase =
       Polymer.GestureEventListeners(

diff --git a/lib/elements/dom-repeat.html b/lib/elements/dom-repeat.html
@@ -24,6 +24,7 @@
    * @constructor
    * @implements {Polymer_OptionalMutableData}
    * @extends {Polymer.Element}
+   * @private
    */
   const domRepeatBase = Polymer.OptionalMutableData(Polymer.Element);
 

diff --git a/lib/legacy/class.html b/lib/legacy/class.html
@@ -142,6 +142,7 @@
      */
     function GenerateClassFromInfo(info, Base) {
 
+      /** @private */
       class PolymerGenerated extends Base {
 
         static get properties() {

diff --git a/lib/legacy/legacy-element-mixin.html b/lib/legacy/legacy-element-mixin.html
@@ -48,6 +48,7 @@
      * @implements {Polymer_ElementMixin}
      * @implements {Polymer_GestureEventListeners}
      * @implements {Polymer_DirMixin}
+     * @private
      */
     const legacyElementBase = Polymer.DirMixin(Polymer.GestureEventListeners(Polymer.ElementMixin(base)));
 

diff --git a/lib/mixins/dir-mixin.html b/lib/mixins/dir-mixin.html
@@ -90,6 +90,7 @@
        * @constructor
        * @extends {base}
        * @implements {Polymer_PropertyAccessors}
+       * @private
        */
       const elementBase = Polymer.PropertyAccessors(base);
 

diff --git a/lib/mixins/disable-upgrade-mixin.html b/lib/mixins/disable-upgrade-mixin.html
@@ -45,8 +45,10 @@
      * @constructor
      * @extends {base}
      * @implements {Polymer_ElementMixin}
+     * @private
      */
     const superClass = Polymer.ElementMixin(base);
+
     /**
      * @polymer
      * @mixinClass

diff --git a/lib/mixins/element-mixin.html b/lib/mixins/element-mixin.html
@@ -98,6 +98,7 @@
      * @extends {base}
      * @implements {Polymer_PropertyEffects}
      * @implements {Polymer_PropertiesMixin}
+     * @private
      */
     const polymerElementBase = Polymer.PropertiesMixin(Polymer.PropertyEffects(base));
 

diff --git a/lib/mixins/properties-mixin.html b/lib/mixins/properties-mixin.html
@@ -58,6 +58,7 @@
      * @constructor
      * @extends {superClass}
      * @implements {Polymer_PropertiesChanged}
+     * @private
      */
     const base = Polymer.PropertiesChanged(superClass);
 

diff --git a/lib/mixins/property-accessors.html b/lib/mixins/property-accessors.html
@@ -105,6 +105,7 @@
      * @extends {superClass}
      * @implements {Polymer_PropertiesChanged}
      * @unrestricted
+     * @private
      */
      const base = Polymer.PropertiesChanged(superClass);
 

diff --git a/lib/mixins/property-effects.html b/lib/mixins/property-effects.html
@@ -1122,6 +1122,7 @@
      * @implements {Polymer_PropertyAccessors}
      * @implements {Polymer_TemplateStamp}
      * @unrestricted
+     * @private
      */
     const propertyEffectsBase = Polymer.TemplateStamp(Polymer.PropertyAccessors(superClass));
 

diff --git a/lib/mixins/strict-binding-parser.html b/lib/mixins/strict-binding-parser.html
@@ -126,6 +126,7 @@
      * @constructor
      * @extends {base}
      * @implements {Polymer_PropertyEffects}
+     * @private
      */
     const elementBase = Polymer.PropertyEffects(base);
 

diff --git a/lib/mixins/template-stamp.html b/lib/mixins/template-stamp.html
@@ -472,7 +472,7 @@
       /**
        * Override point for adding custom or simulated event handling.
        *
-       * @param {Node} node Node to remove event listener from
+       * @param {!Node} node Node to remove event listener from
        * @param {string} eventName Name of event
        * @param {function(!Event):void} handler Listener function to remove
        * @return {void}

diff --git a/lib/utils/mixin.html b/lib/utils/mixin.html
@@ -22,6 +22,7 @@
   /**
    * @constructor
    * @extends {Function}
+   * @private
    */
   function MixinFunction(){}
   /** @type {(WeakMap | undefined)} */

diff --git a/lib/utils/templatize.html b/lib/utils/templatize.html
@@ -21,9 +21,11 @@
     // class only because Babel (incorrectly) requires super() in the class
     // constructor even though no `this` is used and it returns an instance.
     let newInstance = null;
+
     /**
      * @constructor
      * @extends {HTMLTemplateElement}
+     * @private
      */
     function HTMLTemplateElementExtension() { return newInstance; }
     HTMLTemplateElementExtension.prototype = Object.create(HTMLTemplateElement.prototype, {
@@ -32,16 +34,20 @@
         writable: true
       }
     });
+
     /**
      * @constructor
      * @implements {Polymer_PropertyEffects}
      * @extends {HTMLTemplateElementExtension}
+     * @private
      */
     const DataTemplate = Polymer.PropertyEffects(HTMLTemplateElementExtension);
+
     /**
      * @constructor
      * @implements {Polymer_MutableData}
      * @extends {DataTemplate}
+     * @private
      */
     const MutableDataTemplate = Polymer.MutableData(DataTemplate);
 
@@ -53,10 +59,11 @@
       newInstance = null;
     }
 
-    // Base class for TemplateInstance's
     /**
+     * Base class for TemplateInstance.
      * @constructor
      * @implements {Polymer_PropertyEffects}
+     * @private
      */
     const base = Polymer.PropertyEffects(class {});
 
@@ -268,6 +275,7 @@
      * @constructor
      * @extends {TemplateInstanceBase}
      * @implements {Polymer_MutableData}
+     * @private
      */
     const MutableTemplateInstanceBase = Polymer.MutableData(TemplateInstanceBase);
 
@@ -311,6 +319,7 @@
         let klass = templateInfo.templatizeTemplateClass;
         if (!klass) {
           let base = options.mutableData ? MutableDataTemplate : DataTemplate;
+          /** @private */
           klass = templateInfo.templatizeTemplateClass =
             class TemplatizedTemplate extends base {};
           // Add template - >instances effects