feat: prepare for TS defs generation (#41)

Author: web-padawan

bower.json

@@ -26,9 +26,9 @@
   ],
   "dependencies": {
     "polymer": "^2.0.0",
-    "vaadin-themable-mixin": "vaadin/vaadin-themable-mixin#^1.2.0",
-    "vaadin-element-mixin": "vaadin/vaadin-element-mixin#^2.3.0",
-    "vaadin-details": "vaadin/vaadin-details#^1.1.0",
+    "vaadin-themable-mixin": "vaadin/vaadin-themable-mixin#^1.6.1",
+    "vaadin-element-mixin": "vaadin/vaadin-element-mixin#^2.4.1",
+    "vaadin-details": "vaadin/vaadin-details#^1.2.0-alpha1",
     "vaadin-lumo-styles": "vaadin/vaadin-lumo-styles#^1.4.1",
     "vaadin-material-styles": "vaadin/vaadin-material-styles#^1.2.0"
   },

gen-tsd.json

@@ -0,0 +1,9 @@
+{
+  "excludeFiles": [
+    "wct.conf.js",
+    "index.html",
+    "demo/**/*",
+    "test/**/*",
+    "theme/**/*"
+  ]
+}

magi-p3-post.js

@@ -0,0 +1,11 @@
+module.exports = {
+  files: [
+    'vaadin-accordion.js'
+  ],
+  from: [
+    /import '\.\/theme\/lumo\/vaadin-(.+)\.js';/
+  ],
+  to: [
+    `import './theme/lumo/vaadin-$1.js';\nexport * from './src/vaadin-$1.js';`
+  ]
+};

package.json

@@ -18,6 +18,7 @@
   },
   "homepage": "https://vaadin.com/components",
   "files": [
+    "vaadin-*.d.ts",
     "vaadin-*.js",
     "src",
     "theme"

src/vaadin-accordion-panel.html

@@ -35,7 +35,7 @@
      *
      * See [ThemableMixin – how to apply styles for shadow parts](https://github.com/vaadin/vaadin-themable-mixin/wiki)
      *
-     * @memberof Vaadin
+     * @extends Vaadin.DetailsElement
      */
     class AccordionPanelElement extends Vaadin.DetailsElement {
       static get is() {

src/vaadin-accordion.html

@@ -89,6 +89,7 @@
              * The index of currently opened panel. First panel is opened by
              * default. Only one panel can be opened at the same time.
              * Setting null or undefined closes all the accordion panels.
+             * @type {number}
              */
             opened: {
               type: Number,
@@ -101,6 +102,7 @@
              * The list of `<vaadin-accordion-panel>` child elements.
              * It is populated from the elements passed to the light DOM,
              * and updated dynamically when adding or removing panels.
+             * @type {!Array<!AccordionPanelElement>}
              */
             items: {
               type: Array,
@@ -122,6 +124,7 @@
         }
 
         /**
+         * @return {Element | null}
          * @protected
          */
         get focused() {
@@ -155,10 +158,16 @@
           });
         }
 
+        /**
+         * @param {!Array<!Element>} array
+         * @return {!Array<!AccordionPanelElement>}
+         * @protected
+         */
         _filterItems(array) {
           return array.filter(el => el instanceof Vaadin.AccordionPanelElement);
         }
 
+        /** @private */
         _updateItems(items, opened) {
           if (items) {
             const itemToOpen = items[opened];
@@ -168,6 +177,10 @@
           }
         }
 
+        /**
+         * @param {!KeyboardEvent} event
+         * @protected
+         */
         _onKeydown(event) {
           // only check keyboard events on details toggle buttons
           const item = event.composedPath()[0];
@@ -211,6 +224,12 @@
           }
         }
 
+        /**
+         * @param {number} index
+         * @param {number} increment
+         * @return {number}
+         * @protected
+         */
         _getAvailableIndex(index, increment) {
           const totalItems = this.items.length;
           let idx = index;
@@ -229,6 +248,7 @@
           return -1;
         }
 
+        /** @private */
         _updateOpened(e) {
           const target = this._filterItems(e.composedPath())[0];
           const idx = this.items.indexOf(target);