docs: first pass at auto-generating API docs for props

2026-06-07 07:12:23 +03:00 · 2019-11-19 11:10:49 -08:00
parent 764856f729
commit 54c97c6c87
6 changed files with 184 additions and 664 deletions
@@ -1,13 +1,173 @@
 <template>
-  $END$
+  <div>
+    <h1>Vue Select Props</h1>
+
+    <div class="search-box">
+      <input id="props-search" type="search" v-model="query" placeholder="Search for props...">
+    </div>
+
+    <ul>
+      <li v-for="prop in filtered">
+        <h2 :id="prop.name">
+          <a :href="`#${prop.name}`" aria-hidden="true" class="header-anchor">#</a>
+          {{ prop.name }}
+
+          <small><code>{{ prop.type }}</code></small>
+
+          <template v-if="prop.since.hasOwnProperty('version')">
+            <a :href="prop.since.link">
+              <Badge :text="`+${prop.since.version}`" />
+            </a>
+          </template>
+        </h2>
+
+        <div v-html="markdown(prop.description)"></div>
+
+        <ul v-if="prop.see">
+          <li v-for="see in prop.see"><a :href="see">{{ see }}</a></li>
+        </ul>
+
+        <pre><code v-html="prop.defaultRendered"></code></pre>
+
+        <Content :slot-key="prop.name"></Content>
+      </li>
+    </ul>
+  </div>
 </template>

 <script>
+import documentation from '@dynamic/api'
+import { highlight, languages } from 'prismjs';
+import Markdown from 'markdown-it';
+
+const md = new Markdown();
+
 export default {
-  name: "ApiDocs"
+  name: "ApiDocs",
+  methods: {
+    markdown: snippet => md.render(snippet),
+    highlight: snippet => highlight(snippet, languages.javascript, 'javascript'),
+    /**
+     * @param tag
+     * @return {Object}
+     */
+    formatTag (tag, type) {
+      let rendered = `@${tag.title}`;
+      if (tag.hasOwnProperty('type')) {
+        rendered += ' {' + tag.type.name + '}'
+      }
+      if (tag.hasOwnProperty('name')) {
+        rendered += ` ${tag.name} `
+      }
+      if (tag.hasOwnProperty('description')) {
+        rendered += ` ${tag.description}`
+      }
+      return rendered;
+    },
+    getSince (tags) {
+      const since = {};
+      if (tags.hasOwnProperty('since')) {
+        since.version = tags.since[0].description;
+        since.link = `https://github.com/sagalbot/vue-select/releases/tag/v${tags.since[0].description}`
+      }
+      return since;
+    },
+    getSee (tags) {
+      const since = [];
+      if (tags.hasOwnProperty('see')) {
+        tags.see.forEach(({description}) => since.push(description));
+      }
+      return since;
+    },
+    getParams (tags) {
+      const params = [];
+      if (tags.hasOwnProperty('params')) {
+        tags.params.forEach((tag) => params.push(this.formatTag(tag)));
+      }
+      return params;
+    },
+    getType (prop) {
+      if (prop.hasOwnProperty('type')) {
+        let type = prop.type.name;
+        if (type === 'func') {
+          type = 'function';
+        }
+        return type.charAt(0).toUpperCase() + type.slice(1)
+      }
+      return 'mixed';
+    },
+    getDefaultVal (prop, params) {
+      let declaration = '';
+      let returnDeclaration = '';
+
+      if (prop.tags.hasOwnProperty('return')) {
+        console.log(prop.tags);
+        returnDeclaration = prop.tags.return[0];
+      }
+
+      if (params.length || returnDeclaration.length) {
+        declaration += '/*\n';
+        params.forEach(param => declaration += ' * ' + param + '\n');
+        declaration += ` * @return ${returnDeclaration}\n`;
+        declaration += ' */ \n';
+      }
+
+      if (prop.hasOwnProperty('defaultValue')) {
+        declaration += 'default: ' + prop.defaultValue.value;
+      }
+
+      return this.highlight(declaration);
+    }
+  },
+  data () {
+    return {
+      query: ''
+    }
+  },
+  computed: {
+    filtered () {
+      return this.props.filter(prop => this.query.length ? prop.name.includes(this.query) : true);
+    },
+    props () {
+      return documentation.props.map(prop => {
+        const since = this.getSince(prop.tags);
+        const see = this.getSee(prop.tags);
+        const params = this.getParams(prop.tags);
+        const type = this.getType(prop);
+        const defaultRendered = this.getDefaultVal(prop, params);
+
+        return {
+          ...prop,
+          since,
+          see,
+          params,
+          type,
+          defaultRendered
+        }
+      }).sort((a, b) => a.name > b.name);
+    },
+  },
 }
 </script>

 <style scoped>
+  h2 {
+    margin-top: -3.1rem;
+    padding-top: 4.6rem;
+    margin-bottom: 0;
+  }

+  ul {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+  }
+
+  .search-box {
+    width: 100%;
+  }
+
+  .search-box [type=search] {
+    width: 100%;
+  }
 </style>
@@ -1,391 +1 @@
-## value
-
-Contains the currently selected value. Very similar to a
-`value` attribute on an `<input>`. You can listen for changes
-using 'change' event using v-on.
-
-```js
-value: {
-	default: null
-},
-```
-
-## options
-
-An array of strings or objects to be used as dropdown choices.
-If you are using an array of objects, vue-select will look for
-a `label` key (ex. `[{label: 'Canada', value: 'CA'}]`). A
-custom label key can be set with the `label` prop.
-
-```js
-options: {
-	type: Array,
-	default() {
-		return [];
-	}
-},
-```
-
-## disabled
-
-Disable the entire component.
-
-```js
-disabled: {
-	type: Boolean,
-	default: false
-},
-```
-
-## clearable
-
-Can the user clear the selected property?
-
-```js
-clearable: {
-	type: Boolean,
-	default: true
-},
-```
-
-## maxHeight
-
-::: warning Deprecated in `v2.x` & Removed in `v3.0`
-This prop was removed in `v3.0`. You can use the `$vs-dropdown-max-height`
-SCSS variable to adjust this setting in `v3.x`.
-:::
-
-Sets the max-height property on the dropdown list.
-
-```js
-maxHeight: {
-	type: String,
-	default: "400px"
-},
-```
-
-## searchable
-
-Enable/disable filtering the options.
-
-```js
-searchable: {
-	type: Boolean,
-	default: true
-},
-```
-
-## multiple
-
-Equivalent to the `multiple` attribute on a `<select>` input.
-
-```js
-multiple: {
-	type: Boolean,
-	default: false
-},
-```
-
-## placeholder
-
-Equivalent to the `placeholder` attribute on an `<input>`.
-
-```js
-placeholder: {
-	type: String,
-	default: ""
-},
-```
-
-## transition
-
-Sets a Vue transition property on the `.dropdown-menu`. vue-select
-does not include CSS for transitions, you'll need to add them yourself.
-
-```js
-transition: {
-	type: String,
-	default: "fade"
-},
-```
-
-## clearSearchOnSelect
-
-Enables/disables clearing the search text when an option is selected.
-
-```js
-clearSearchOnSelect: {
-	type: Boolean,
-	default: true
-},
-```
-
-## closeOnSelect
-
-Close a dropdown when an option is chosen. Set to false to keep the dropdown
-open (useful when combined with multi-select, for example)
-
-```js
-closeOnSelect: {
-	type: Boolean,
-	default: true
-},
-```
-
-## label
-
-Tells vue-select what key to use when generating option
-labels when each `option` is an object.
-
-```js
-label: {
-	type: String,
-	default: "label"
-},
-```
-
-## reduce
-
-When working with objects, the reduce
-prop allows you to transform a given
-object to only the information you
-want passed to a v-model binding
-or @input event.
-
-```js
-reduce: {
-  type: Function,
-  default: option => option,
-},
-```
-
-## getOptionLabel
-
-Callback to generate the label text. If `{option}`
-is an object, returns `option[this.label]` by default.
-
-Label text is used for filtering comparison and
-displaying. If you only need to adjust the
-display, you should use the `option` and
-`selected-option` slots.
-
-```js
-getOptionLabel: {
-  type: Function,
-  default(option) {
-    if (typeof option === 'object') {
-      if (!option.hasOwnProperty(this.label)) {
-        return console.warn(
-          `[vue-select warn]: Label key "option.${this.label}" does not` +
-          ` exist in options object ${JSON.stringify(option)}.\n` +
-          'https://vue-select.org/api/props.html#getoptionlabel'
-        )
-      }
-      return option[this.label]
-    }
-    return option;
-  }
-},
-```
-
-## getOptionKey
-
-Callback to get an option key. If `option`
-is an object and has an `id`, returns `option.id`
-by default, otherwise tries to serialize `option`
-to JSON.
-
-The key must be unique for an option.
-
-```js
-getOptionKey: {
-  type: Function,
-  default(option) {
-    if (typeof option === 'object' && option.id) {
-      return option.id
-    } else {
-      try {
-        return JSON.stringify(option)
-      } catch(e) {
-        return console.warn(
-          `[vue-select warn]: Could not stringify option ` +
-          `to generate unique key. Please provide 'getOptionKey' prop ` +
-          `to return a unique key for each option.\n` +
-          'https://vue-select.org/api/props.html#getoptionkey'
-        )
-        return null
-      }
-    }
-  }
-},
-```
-
-## onTab
-
-Select the current value if `selectOnTab` is enabled
-
-```js
-onTab: {
-	type: Function,
-	default: function() {
-		if (this.selectOnTab) {
-			this.typeAheadSelect();
-		}
-	}
-},
-```
-
-## taggable
-
-Enable/disable creating options from searchInput.
-
-```js
-taggable: {
-	type: Boolean,
-	default: false
-},
-```
-
-## tabindex
-
-Set the tabindex for the input field.
-
-```js
-tabindex: {
-	type: Number,
-	default: null
-},
-```
-
-## pushTags
-
-When true, newly created tags will be added to
-the options list.
-
-```js
-pushTags: {
-	type: Boolean,
-	default: false
-},
-```
-
-## filterable
-
-When true, existing options will be filtered
-by the search text. Should not be used in conjunction
-with taggable.
-
-```js
-filterable: {
-	type: Boolean,
-	default: true
-},
-```
-
-## filterBy
-
-Callback to determine if the provided option should
-match the current search text. Used to determine
-if the option should be displayed.
-
-```js
-filterBy: {
-	type: Function,
-	default(option, label, search) {
-		return (label | "").toLowerCase().indexOf(search.toLowerCase()) > -1;
-	}
-},
-```
-
-## filter
-
-Callback to filter results when search text
-is provided. Default implementation loops
-each option, and returns the result of
-this.filterBy.
-
-```js
-filter: {
-	type: Function,
-	default(options, search) {
-		return options.filter(option => {
-			let label = this.getOptionLabel(option);
-			if (typeof label === "number") {
-				label = label.toString();
-			}
-			return this.filterBy(option, label, search);
-		});
-	}
-},
-```
-
-## createOption
-
-User defined function for adding Options
-
-```js
-createOption: {
-  type: Function,
-  default(newOption) {
-    if (typeof this.optionList[0] === 'object') {
-      newOption = {[this.label]: newOption}
-    }
-
-    this.$emit('option:created', newOption)
-    return newOption
-  }
-},
-```
-
-## resetOnOptionsChange
-
-When false, updating the options will not reset the select value
-
-```js
-resetOnOptionsChange: {
-	type: Boolean,
-	default: false
-},
-```
-
-## noDrop
-
-Disable the dropdown entirely.
-
-```js
-noDrop: {
-	type: Boolean,
-	default: false
-},
-```
-
-## inputId
-
-Sets the id of the input element.
-
-```js
-inputId: {
-	type: String
-},
-```
-
-## dir
-
-Sets RTL support. Accepts `ltr`, `rtl`, `auto`.
-
-```js
-dir: {
-	type: String,
-	default: "auto"
-},
-```
-
-## selectOnTab
-
-When true, hitting the 'tab' key will select the current select value
-
-```js
-selectOnTab: {
-	type: Boolean,
-	default: false
-}
+<ApiDocs type="props" />
@@ -17,7 +17,9 @@
    "cross-env": "^5.2.0",
    "fuse.js": "^3.4.4",
    "gh-pages": "^0.11.0",
+    "markdown-it": "^10.0.0",
    "node-sass": "^4.12.0",
+    "prismjs": "^1.17.1",
    "sass-loader": "^7.1.0",
    "vue": "^2.6.10",
    "vuepress": "^1.0.0-alpha.47",
@@ -2891,7 +2891,7 @@ entities@^1.1.1, entities@~1.1.1:
  resolved "https://registry.yarnpkg.com/entities/-/entities-1.1.2.tgz#bdfa735299664dfafd34529ed4f8522a275fea56"
  integrity sha512-f2LZMYl1Fzu7YSBKg+RoROelpOaNrcGmE9AZubeDfrCEia483oW4MI4VyFd5VNHIgQ/7qm1I0wUHK1eJnn2y2w==

-entities@^2.0.0:
+entities@^2.0.0, entities@~2.0.0:
  version "2.0.0"
  resolved "https://registry.yarnpkg.com/entities/-/entities-2.0.0.tgz#68d6084cab1b079767540d80e56a39b423e4abf4"
  integrity sha512-D9f7V0JSRwIxlRI2mjMqufDrRDnx8p+eEOz7aUM9SuvF8gsBzra0/6tbjl1m8eQHrZlYj6PxqE00hZ1SAIKPLw==
@@ -4701,6 +4701,17 @@ markdown-it-table-of-contents@^0.4.0:
  resolved "https://registry.yarnpkg.com/markdown-it-table-of-contents/-/markdown-it-table-of-contents-0.4.4.tgz#3dc7ce8b8fc17e5981c77cc398d1782319f37fbc"
  integrity sha512-TAIHTHPwa9+ltKvKPWulm/beozQU41Ab+FIefRaQV1NRnpzwcV9QOe6wXQS5WLivm5Q/nlo0rl6laGkMDZE7Gw==

+markdown-it@^10.0.0:
+  version "10.0.0"
+  resolved "https://registry.yarnpkg.com/markdown-it/-/markdown-it-10.0.0.tgz#abfc64f141b1722d663402044e43927f1f50a8dc"
+  integrity sha512-YWOP1j7UbDNz+TumYP1kpwnP0aEa711cJjrAQrzd0UXlbJfc5aAq0F/PZHjiioqDC1NKgvIMX+o+9Bk7yuM2dg==
+  dependencies:
+    argparse "^1.0.7"
+    entities "~2.0.0"
+    linkify-it "^2.0.0"
+    mdurl "^1.0.1"
+    uc.micro "^1.0.5"
+
 markdown-it@^8.4.1:
  version "8.4.2"
  resolved "https://registry.yarnpkg.com/markdown-it/-/markdown-it-8.4.2.tgz#386f98998dc15a37722aa7722084f4020bdd9b54"
@@ -6063,7 +6074,7 @@ pretty-time@^1.1.0:
  resolved "https://registry.yarnpkg.com/pretty-time/-/pretty-time-1.1.0.tgz#ffb7429afabb8535c346a34e41873adf3d74dd0e"
  integrity sha512-28iF6xPQrP8Oa6uxE6a1biz+lWeTOAPKggvjB8HAs6nVMKZwf5bG++632Dx614hIWgUPkgivRfG+a8uAXGTIbA==

-prismjs@^1.13.0:
+prismjs@^1.13.0, prismjs@^1.17.1:
  version "1.17.1"
  resolved "https://registry.yarnpkg.com/prismjs/-/prismjs-1.17.1.tgz#e669fcbd4cdd873c35102881c33b14d0d68519be"
  integrity sha512-PrEDJAFdUGbOP6xK/UsfkC5ghJsPJviKgnQOoxaDbBjwc8op68Quupwt1DeAFoG8GImPhiKXAvvsH7wDSLsu1Q==
@@ -58,7 +58,6 @@
    "terser-webpack-plugin": "^1.2.3",
    "url-loader": "^1.1.2",
    "vue": "^2.6.10",
-    "vue-docgen-api": "^4.0.1",
    "vue-html-loader": "^1.2.4",
    "vue-jest": "^3.0.4",
    "vue-loader": "^15.7.0",
@@ -218,11 +218,6 @@
  resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.5.5.tgz#02f077ac8817d3df4a832ef59de67565e71cca4b"
  integrity sha512-E5BN68cqR7dhKan1SfqgPGhQ178bkVKpXTPEXnFJBrEt8/DKRZlybmy+IgYLTeN7tp1R5Ccmbm2rBk17sHYU3g==

-"@babel/parser@^7.2.3":
-  version "7.7.3"
-  resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.7.3.tgz#5fad457c2529de476a248f75b0f090b3060af043"
-  integrity sha512-bqv+iCo9i+uLVbI0ILzKkvMorqxouI+GbV13ivcARXn9NNEabi2IEz912IgNpT/60BNXac5dgcfjb94NjsF33A==
-
 "@babel/plugin-proposal-async-generator-functions@^7.2.0":
  version "7.2.0"
  resolved "https://registry.yarnpkg.com/@babel/plugin-proposal-async-generator-functions/-/plugin-proposal-async-generator-functions-7.2.0.tgz#b289b306669dce4ad20b0252889a15768c9d417e"
@@ -816,11 +811,6 @@
    "@types/istanbul-reports" "^1.1.1"
    "@types/yargs" "^13.0.0"

-"@types/babel-types@*", "@types/babel-types@^7.0.0":
-  version "7.0.7"
-  resolved "https://registry.yarnpkg.com/@types/babel-types/-/babel-types-7.0.7.tgz#667eb1640e8039436028055737d2b9986ee336e3"
-  integrity sha512-dBtBbrc+qTHy1WdfHYjBwRln4+LWqASWakLHsWHR2NWHIFkv4W3O070IGoGLEBrJBvct3r0L1BUPuvURi7kYUQ==
-
 "@types/babel__core@^7.1.0":
  version "7.1.2"
  resolved "https://registry.yarnpkg.com/@types/babel__core/-/babel__core-7.1.2.tgz#608c74f55928033fce18b99b213c16be4b3d114f"
@@ -854,13 +844,6 @@
  dependencies:
    "@babel/types" "^7.3.0"

-"@types/babylon@^6.16.2":
-  version "6.16.5"
-  resolved "https://registry.yarnpkg.com/@types/babylon/-/babylon-6.16.5.tgz#1c5641db69eb8cdf378edd25b4be7754beeb48b4"
-  integrity sha512-xH2e58elpj1X4ynnKp9qSnWlsRTIs6n3tgLGNfwAGHwePw0mulHQllV34n0T25uYSu1k0hRKkWXF890B1yS47w==
-  dependencies:
-    "@types/babel-types" "*"
-
 "@types/events@*":
  version "3.0.0"
  resolved "https://registry.yarnpkg.com/@types/events/-/events-3.0.0.tgz#2862f3f58a9a7f7c3e78d79f130dd4d71c25c2a7"
@@ -1134,13 +1117,6 @@ accepts@~1.3.4, accepts@~1.3.5, accepts@~1.3.7:
    mime-types "~2.1.24"
    negotiator "0.6.2"

-acorn-globals@^3.0.0:
-  version "3.1.0"
-  resolved "https://registry.yarnpkg.com/acorn-globals/-/acorn-globals-3.1.0.tgz#fd8270f71fbb4996b004fa880ee5d46573a731bf"
-  integrity sha1-/YJw9x+7SZawBPqIDuXUZXOnMb8=
-  dependencies:
-    acorn "^4.0.4"
-
 acorn-globals@^4.1.0:
  version "4.3.3"
  resolved "https://registry.yarnpkg.com/acorn-globals/-/acorn-globals-4.3.3.tgz#a86f75b69680b8780d30edd21eee4e0ea170c05e"
@@ -1154,16 +1130,6 @@ acorn-walk@^6.0.1:
  resolved "https://registry.yarnpkg.com/acorn-walk/-/acorn-walk-6.2.0.tgz#123cb8f3b84c2171f1f7fb252615b1c78a6b1a8c"
  integrity sha512-7evsyfH1cLOCdAzZAd43Cic04yKydNx0cF+7tiA19p1XnLLPU4dpCQOqpjqwokFe//vS0QqfqqjCS2JkiIs0cA==

-acorn@^3.1.0:
-  version "3.3.0"
-  resolved "https://registry.yarnpkg.com/acorn/-/acorn-3.3.0.tgz#45e37fb39e8da3f25baee3ff5369e2bb5f22017a"
-  integrity sha1-ReN/s56No/JbruP/U2niu18iAXo=
-
-acorn@^4.0.4, acorn@~4.0.2:
-  version "4.0.13"
-  resolved "https://registry.yarnpkg.com/acorn/-/acorn-4.0.13.tgz#105495ae5361d697bd195c825192e1ad7f253787"
-  integrity sha1-EFSVrlNh1pe9GVyCUZLhrX8lN4c=
-
 acorn@^5.5.3:
  version "5.7.3"
  resolved "https://registry.yarnpkg.com/acorn/-/acorn-5.7.3.tgz#67aa231bf8812974b85235a96771eb6bd07ea279"
@@ -1335,11 +1301,6 @@ array-unique@^0.3.2:
  resolved "https://registry.yarnpkg.com/array-unique/-/array-unique-0.3.2.tgz#a894b75d4bc4f6cd679ef3244a9fd8f46ae2d428"
  integrity sha1-qJS3XUvE9s1nnvMkSp/Y9Gri1Cg=

-asap@~2.0.3:
-  version "2.0.6"
-  resolved "https://registry.yarnpkg.com/asap/-/asap-2.0.6.tgz#e50347611d7e690943208bbdafebcbc2fb866d46"
-  integrity sha1-5QNHYR1+aQlDIIu9r+vLwvuGbUY=
-
 asn1.js@^4.0.0:
  version "4.10.1"
  resolved "https://registry.yarnpkg.com/asn1.js/-/asn1.js-4.10.1.tgz#b9c2bf5805f1e64aadeed6df3a2bfafb5a73f5a0"
@@ -1374,11 +1335,6 @@ assign-symbols@^1.0.0:
  resolved "https://registry.yarnpkg.com/assign-symbols/-/assign-symbols-1.0.0.tgz#59667f41fadd4f20ccbc2bb96b8d4f7f78ec0367"
  integrity sha1-WWZ/QfrdTyDMvCu5a41Pf3jsA2c=

-ast-types@0.12.4, ast-types@^0.12.2:
-  version "0.12.4"
-  resolved "https://registry.yarnpkg.com/ast-types/-/ast-types-0.12.4.tgz#71ce6383800f24efc9a1a3308f3a6e420a0974d1"
-  integrity sha512-ky/YVYCbtVAS8TdMIaTiPFHwEpRB5z1hctepJplTr3UW5q8TDrpIMCILyk8pmLxGtn2KCtC/lSn7zOsaI7nzDw==
-
 ast-types@0.9.6:
  version "0.9.6"
  resolved "https://registry.yarnpkg.com/ast-types/-/ast-types-0.9.6.tgz#102c9e9e9005d3e7e3829bf0c4fa24ee862ee9b9"
@@ -2043,13 +1999,6 @@ change-case@3.0.x:
    upper-case "^1.1.1"
    upper-case-first "^1.1.0"

-character-parser@^2.1.1:
-  version "2.2.0"
-  resolved "https://registry.yarnpkg.com/character-parser/-/character-parser-2.2.0.tgz#c7ce28f36d4bcd9744e5ffc2c5fcde1c73261fc0"
-  integrity sha1-x84o821LzZdE5f/CxfzeHHMmH8A=
-  dependencies:
-    is-regex "^1.0.3"
-
 chokidar@^2.0.2, chokidar@^2.1.5, chokidar@^2.1.6:
  version "2.1.8"
  resolved "https://registry.yarnpkg.com/chokidar/-/chokidar-2.1.8.tgz#804b3a7b6a99358c3c5c61e71d8728f041cff917"
@@ -2112,7 +2061,7 @@ clean-css@3.4.x:
    commander "2.8.x"
    source-map "0.4.x"

-clean-css@4.2.x, clean-css@^4.1.11:
+clean-css@4.2.x:
  version "4.2.1"
  resolved "https://registry.yarnpkg.com/clean-css/-/clean-css-4.2.1.tgz#2d411ef76b8569b6d0c84068dabe85b0aa5e5c17"
  integrity sha512-4ZxI6dy4lrY6FHzfiy1aEOXgu4LIsW2MhwG0VBKdcoGoH/XLFgaHSdLTGr4O8Be6A8r3MOphEiI8Gc1n0ecf3g==
@@ -2364,16 +2313,6 @@ constant-case@^2.0.0:
    snake-case "^2.1.0"
    upper-case "^1.1.1"

-constantinople@^3.0.1, constantinople@^3.1.2:
-  version "3.1.2"
-  resolved "https://registry.yarnpkg.com/constantinople/-/constantinople-3.1.2.tgz#d45ed724f57d3d10500017a7d3a889c1381ae647"
-  integrity sha512-yePcBqEFhLOqSBtwYOGGS1exHo/s1xjekXiinh4itpNQGCu4KA1euPh1fg07N2wMITZXQkBz75Ntdt1ctGZouw==
-  dependencies:
-    "@types/babel-types" "^7.0.0"
-    "@types/babylon" "^6.16.2"
-    babel-types "^6.26.0"
-    babylon "^6.18.0"
-
 constants-browserify@^1.0.0:
  version "1.0.0"
  resolved "https://registry.yarnpkg.com/constants-browserify/-/constants-browserify-1.0.0.tgz#c20b96d8c617748aaf1c16021760cd27fcb8cb75"
@@ -2957,11 +2896,6 @@ dns-txt@^2.0.2:
  dependencies:
    buffer-indexof "^1.0.0"

-doctypes@^1.1.0:
-  version "1.1.0"
-  resolved "https://registry.yarnpkg.com/doctypes/-/doctypes-1.1.0.tgz#ea80b106a87538774e8a3a4a5afe293de489e0a9"
-  integrity sha1-6oCxBqh1OHdOijpKWv4pPeSJ4Kk=
-
 dom-converter@^0.2:
  version "0.2.0"
  resolved "https://registry.yarnpkg.com/dom-converter/-/dom-converter-0.2.0.tgz#6721a9daee2e293682955b6afe416771627bb768"
@@ -3220,7 +3154,7 @@ esprima@^3.1.3, esprima@~3.1.0:
  resolved "https://registry.yarnpkg.com/esprima/-/esprima-3.1.3.tgz#fdca51cee6133895e3c88d535ce49dbff62a4633"
  integrity sha1-/cpRzuYTOJXjyI1TXOSdv/YqRjM=

-esprima@^4.0.0, esprima@~4.0.0:
+esprima@^4.0.0:
  version "4.0.1"
  resolved "https://registry.yarnpkg.com/esprima/-/esprima-4.0.1.tgz#13b04cdb3e6c5d19df91ab6987a8695619b0aa71"
  integrity sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==
@@ -4433,14 +4367,6 @@ is-directory@^0.3.1:
  resolved "https://registry.yarnpkg.com/is-directory/-/is-directory-0.3.1.tgz#61339b6f2475fc772fd9c9d83f5c8575dc154ae1"
  integrity sha1-YTObbyR1/Hcv2cnYP1yFddwVSuE=

-is-expression@^3.0.0:
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/is-expression/-/is-expression-3.0.0.tgz#39acaa6be7fd1f3471dc42c7416e61c24317ac9f"
-  integrity sha1-Oayqa+f9HzRx3ELHQW5hwkMXrJ8=
-  dependencies:
-    acorn "~4.0.2"
-    object-assign "^4.0.1"
-
 is-extendable@^0.1.0, is-extendable@^0.1.1:
  version "0.1.1"
  resolved "https://registry.yarnpkg.com/is-extendable/-/is-extendable-0.1.1.tgz#62b110e289a471418e3ec36a617d472e301dfc89"
@@ -4541,12 +4467,7 @@ is-plain-object@^2.0.3, is-plain-object@^2.0.4:
  dependencies:
    isobject "^3.0.1"

-is-promise@^2.0.0:
-  version "2.1.0"
-  resolved "https://registry.yarnpkg.com/is-promise/-/is-promise-2.1.0.tgz#79a2a9ece7f096e80f36d2b2f3bc16c1ff4bf3fa"
-  integrity sha1-eaKp7OfwlugPNtKy87wWwf9L8/o=
-
-is-regex@^1.0.3, is-regex@^1.0.4:
+is-regex@^1.0.4:
  version "1.0.4"
  resolved "https://registry.yarnpkg.com/is-regex/-/is-regex-1.0.4.tgz#5517489b547091b0930e095654ced25ee97e9491"
  integrity sha1-VRdIm1RwkbCTDglWVM7SXul+lJE=
@@ -5068,11 +4989,6 @@ js-levenshtein@^1.1.3:
  resolved "https://registry.yarnpkg.com/js-levenshtein/-/js-levenshtein-1.1.6.tgz#c6cee58eb3550372df8deb85fad5ce66ce01d59d"
  integrity sha512-X2BB11YZtrRqY4EnQcLX5Rh373zbK4alC1FW7D7MBhL2gtcC17cTnr6DmfHZeS0s2rTHjUTMMHfG7gO8SSdw+g==

-js-stringify@^1.0.1:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/js-stringify/-/js-stringify-1.0.2.tgz#1736fddfd9724f28a3682adc6230ae7e4e9679db"
-  integrity sha1-Fzb939lyTyijaCrcYjCufk6Weds=
-
 "js-tokens@^3.0.0 || ^4.0.0", js-tokens@^4.0.0:
  version "4.0.0"
  resolved "https://registry.yarnpkg.com/js-tokens/-/js-tokens-4.0.0.tgz#19203fb59991df98e3a287050d4647cdeaf32499"
@@ -5197,14 +5113,6 @@ jsprim@^1.2.2:
    json-schema "0.2.3"
    verror "1.10.0"

-jstransformer@1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/jstransformer/-/jstransformer-1.0.0.tgz#ed8bf0921e2f3f1ed4d5c1a44f68709ed24722c3"
-  integrity sha1-7Yvwkh4vPx7U1cGkT2hwntJHIsM=
-  dependencies:
-    is-promise "^2.0.0"
-    promise "^7.0.1"
-
 killable@^1.0.1:
  version "1.0.1"
  resolved "https://registry.yarnpkg.com/killable/-/killable-1.0.1.tgz#4c8ce441187a061c7474fb87ca08e2a638194892"
@@ -6904,7 +6812,7 @@ pretty@2.0.0:
    extend-shallow "^2.0.1"
    js-beautify "^1.6.12"

-private@^0.1.6, private@^0.1.8, private@~0.1.5:
+private@^0.1.6, private@~0.1.5:
  version "0.1.8"
  resolved "https://registry.yarnpkg.com/private/-/private-0.1.8.tgz#2381edb3689f7a53d653190060fcf822d2f368ff"
  integrity sha512-VvivMrbvd2nKkiG38qjULzlc+4Vx4wm/whI9pQD35YrARNnhxeiRktSOhSukRLFNlzg6Br/cJPet5J/u19r/mg==
@@ -6924,13 +6832,6 @@ promise-inflight@^1.0.1:
  resolved "https://registry.yarnpkg.com/promise-inflight/-/promise-inflight-1.0.1.tgz#98472870bf228132fcbdd868129bad12c3c029e3"
  integrity sha1-mEcocL8igTL8vdhoEputEsPAKeM=

-promise@^7.0.1:
-  version "7.3.1"
-  resolved "https://registry.yarnpkg.com/promise/-/promise-7.3.1.tgz#064b72602b18f90f29192b8b1bc418ffd1ebd3bf"
-  integrity sha512-nolQXZ/4L+bP/UGlkfaIujX9BKxGwmQ9OT4mOt5yvy8iK1h3wqTEJCijzGANTCCl9nWjY41juyAn2K3Q1hLLTg==
-  dependencies:
-    asap "~2.0.3"
-
 prompts@^2.0.1:
  version "2.2.1"
  resolved "https://registry.yarnpkg.com/prompts/-/prompts-2.2.1.tgz#f901dd2a2dfee080359c0e20059b24188d75ad35"
@@ -6979,111 +6880,6 @@ public-encrypt@^4.0.0:
    randombytes "^2.0.1"
    safe-buffer "^5.1.2"

-pug-attrs@^2.0.4:
-  version "2.0.4"
-  resolved "https://registry.yarnpkg.com/pug-attrs/-/pug-attrs-2.0.4.tgz#b2f44c439e4eb4ad5d4ef25cac20d18ad28cc336"
-  integrity sha512-TaZ4Z2TWUPDJcV3wjU3RtUXMrd3kM4Wzjbe3EWnSsZPsJ3LDI0F3yCnf2/W7PPFF+edUFQ0HgDL1IoxSz5K8EQ==
-  dependencies:
-    constantinople "^3.0.1"
-    js-stringify "^1.0.1"
-    pug-runtime "^2.0.5"
-
-pug-code-gen@^2.0.2:
-  version "2.0.2"
-  resolved "https://registry.yarnpkg.com/pug-code-gen/-/pug-code-gen-2.0.2.tgz#ad0967162aea077dcf787838d94ed14acb0217c2"
-  integrity sha512-kROFWv/AHx/9CRgoGJeRSm+4mLWchbgpRzTEn8XCiwwOy6Vh0gAClS8Vh5TEJ9DBjaP8wCjS3J6HKsEsYdvaCw==
-  dependencies:
-    constantinople "^3.1.2"
-    doctypes "^1.1.0"
-    js-stringify "^1.0.1"
-    pug-attrs "^2.0.4"
-    pug-error "^1.3.3"
-    pug-runtime "^2.0.5"
-    void-elements "^2.0.1"
-    with "^5.0.0"
-
-pug-error@^1.3.3:
-  version "1.3.3"
-  resolved "https://registry.yarnpkg.com/pug-error/-/pug-error-1.3.3.tgz#f342fb008752d58034c185de03602dd9ffe15fa6"
-  integrity sha512-qE3YhESP2mRAWMFJgKdtT5D7ckThRScXRwkfo+Erqga7dyJdY3ZquspprMCj/9sJ2ijm5hXFWQE/A3l4poMWiQ==
-
-pug-filters@^3.1.1:
-  version "3.1.1"
-  resolved "https://registry.yarnpkg.com/pug-filters/-/pug-filters-3.1.1.tgz#ab2cc82db9eeccf578bda89130e252a0db026aa7"
-  integrity sha512-lFfjNyGEyVWC4BwX0WyvkoWLapI5xHSM3xZJFUhx4JM4XyyRdO8Aucc6pCygnqV2uSgJFaJWW3Ft1wCWSoQkQg==
-  dependencies:
-    clean-css "^4.1.11"
-    constantinople "^3.0.1"
-    jstransformer "1.0.0"
-    pug-error "^1.3.3"
-    pug-walk "^1.1.8"
-    resolve "^1.1.6"
-    uglify-js "^2.6.1"
-
-pug-lexer@^4.1.0:
-  version "4.1.0"
-  resolved "https://registry.yarnpkg.com/pug-lexer/-/pug-lexer-4.1.0.tgz#531cde48c7c0b1fcbbc2b85485c8665e31489cfd"
-  integrity sha512-i55yzEBtjm0mlplW4LoANq7k3S8gDdfC6+LThGEvsK4FuobcKfDAwt6V4jKPH9RtiE3a2Akfg5UpafZ1OksaPA==
-  dependencies:
-    character-parser "^2.1.1"
-    is-expression "^3.0.0"
-    pug-error "^1.3.3"
-
-pug-linker@^3.0.6:
-  version "3.0.6"
-  resolved "https://registry.yarnpkg.com/pug-linker/-/pug-linker-3.0.6.tgz#f5bf218b0efd65ce6670f7afc51658d0f82989fb"
-  integrity sha512-bagfuHttfQOpANGy1Y6NJ+0mNb7dD2MswFG2ZKj22s8g0wVsojpRlqveEQHmgXXcfROB2RT6oqbPYr9EN2ZWzg==
-  dependencies:
-    pug-error "^1.3.3"
-    pug-walk "^1.1.8"
-
-pug-load@^2.0.12:
-  version "2.0.12"
-  resolved "https://registry.yarnpkg.com/pug-load/-/pug-load-2.0.12.tgz#d38c85eb85f6e2f704dea14dcca94144d35d3e7b"
-  integrity sha512-UqpgGpyyXRYgJs/X60sE6SIf8UBsmcHYKNaOccyVLEuT6OPBIMo6xMPhoJnqtB3Q3BbO4Z3Bjz5qDsUWh4rXsg==
-  dependencies:
-    object-assign "^4.1.0"
-    pug-walk "^1.1.8"
-
-pug-parser@^5.0.1:
-  version "5.0.1"
-  resolved "https://registry.yarnpkg.com/pug-parser/-/pug-parser-5.0.1.tgz#03e7ada48b6840bd3822f867d7d90f842d0ffdc9"
-  integrity sha512-nGHqK+w07p5/PsPIyzkTQfzlYfuqoiGjaoqHv1LjOv2ZLXmGX1O+4Vcvps+P4LhxZ3drYSljjq4b+Naid126wA==
-  dependencies:
-    pug-error "^1.3.3"
-    token-stream "0.0.1"
-
-pug-runtime@^2.0.5:
-  version "2.0.5"
-  resolved "https://registry.yarnpkg.com/pug-runtime/-/pug-runtime-2.0.5.tgz#6da7976c36bf22f68e733c359240d8ae7a32953a"
-  integrity sha512-P+rXKn9un4fQY77wtpcuFyvFaBww7/91f3jHa154qU26qFAnOe6SW1CbIDcxiG5lLK9HazYrMCCuDvNgDQNptw==
-
-pug-strip-comments@^1.0.4:
-  version "1.0.4"
-  resolved "https://registry.yarnpkg.com/pug-strip-comments/-/pug-strip-comments-1.0.4.tgz#cc1b6de1f6e8f5931cf02ec66cdffd3f50eaf8a8"
-  integrity sha512-i5j/9CS4yFhSxHp5iKPHwigaig/VV9g+FgReLJWWHEHbvKsbqL0oP/K5ubuLco6Wu3Kan5p7u7qk8A4oLLh6vw==
-  dependencies:
-    pug-error "^1.3.3"
-
-pug-walk@^1.1.8:
-  version "1.1.8"
-  resolved "https://registry.yarnpkg.com/pug-walk/-/pug-walk-1.1.8.tgz#b408f67f27912f8c21da2f45b7230c4bd2a5ea7a"
-  integrity sha512-GMu3M5nUL3fju4/egXwZO0XLi6fW/K3T3VTgFQ14GxNi8btlxgT5qZL//JwZFm/2Fa64J/PNS8AZeys3wiMkVA==
-
-pug@^2.0.3:
-  version "2.0.4"
-  resolved "https://registry.yarnpkg.com/pug/-/pug-2.0.4.tgz#ee7682ec0a60494b38d48a88f05f3b0ac931377d"
-  integrity sha512-XhoaDlvi6NIzL49nu094R2NA6P37ijtgMDuWE+ofekDChvfKnzFal60bhSdiy8y2PBO6fmz3oMEIcfpBVRUdvw==
-  dependencies:
-    pug-code-gen "^2.0.2"
-    pug-filters "^3.1.1"
-    pug-lexer "^4.1.0"
-    pug-linker "^3.0.6"
-    pug-load "^2.0.12"
-    pug-parser "^5.0.1"
-    pug-runtime "^2.0.5"
-    pug-strip-comments "^1.0.4"
-
 pump@^2.0.0:
  version "2.0.1"
  resolved "https://registry.yarnpkg.com/pump/-/pump-2.0.1.tgz#12399add6e4cf7526d973cbc8b5ce2e2908b3909"
@@ -7279,16 +7075,6 @@ realpath-native@^1.1.0:
  dependencies:
    util.promisify "^1.0.0"

-recast@^0.17.3:
-  version "0.17.6"
-  resolved "https://registry.yarnpkg.com/recast/-/recast-0.17.6.tgz#64ae98d0d2dfb10ff92ff5fb9ffb7371823b69fa"
-  integrity sha512-yoQRMRrK1lszNtbkGyM4kN45AwylV5hMiuEveUBlxytUViWevjvX6w+tzJt1LH4cfUhWt4NZvy3ThIhu6+m5wQ==
-  dependencies:
-    ast-types "0.12.4"
-    esprima "~4.0.0"
-    private "^0.1.8"
-    source-map "~0.6.1"
-
 recast@~0.11.12:
  version "0.11.23"
  resolved "https://registry.yarnpkg.com/recast/-/recast-0.11.23.tgz#451fd3004ab1e4df9b4e4b66376b2a21912462d3"
@@ -7510,7 +7296,7 @@ resolve@1.1.7:
  resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.1.7.tgz#203114d82ad2c5ed9e8e0411b3932875e889e97b"
  integrity sha1-IDEU2CrSxe2ejgQRs5ModeiJ6Xs=

-resolve@^1.1.6, resolve@^1.10.0, resolve@^1.2.0, resolve@^1.3.2, resolve@^1.8.1:
+resolve@^1.10.0, resolve@^1.2.0, resolve@^1.3.2, resolve@^1.8.1:
  version "1.12.0"
  resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.12.0.tgz#3fc644a35c84a48554609ff26ec52b66fa577df6"
  integrity sha512-B/dOmuoAik5bKcD6s6nXDCjzUKnaDvdkRyAk6rsmsKLipWj4797iothd7jmmUhWTfinVMU+wc56rYKsit2Qy4w==
@@ -8408,11 +8194,6 @@ toidentifier@1.0.0:
  resolved "https://registry.yarnpkg.com/toidentifier/-/toidentifier-1.0.0.tgz#7e1be3470f1e77948bc43d94a3c8f4d7752ba553"
  integrity sha512-yaOH/Pk/VEhBWWTlhI+qXxDFXlejDGcQipMlyxda9nthulaxLZUNcUqFxokp0vcYnvteJln5FNQDRrxj3YcbVw==

-token-stream@0.0.1:
-  version "0.0.1"
-  resolved "https://registry.yarnpkg.com/token-stream/-/token-stream-0.0.1.tgz#ceeefc717a76c4316f126d0b9dbaa55d7e7df01a"
-  integrity sha1-zu78cXp2xDFvEm0LnbqlXX598Bo=
-
 toposort@^1.0.0:
  version "1.0.7"
  resolved "https://registry.yarnpkg.com/toposort/-/toposort-1.0.7.tgz#2e68442d9f64ec720b8cc89e6443ac6caa950029"
@@ -8458,11 +8239,6 @@ trim-right@^1.0.1:
  dependencies:
    glob "^7.1.2"

-ts-map@^1.0.3:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/ts-map/-/ts-map-1.0.3.tgz#1c4d218dec813d2103b7e04e4bcf348e1471c1ff"
-  integrity sha512-vDWbsl26LIcPGmDpoVzjEP6+hvHZkBkLW7JpvwbCv/5IYPJlsbzCVXY3wsCeAxAUeTclNOUZxnLdGh3VBD/J6w==
-
 tsconfig@^7.0.0:
  version "7.0.0"
  resolved "https://registry.yarnpkg.com/tsconfig/-/tsconfig-7.0.0.tgz#84538875a4dc216e5c4a5432b3a4dec3d54e91b7"
@@ -8533,16 +8309,6 @@ uglify-js@3.4.x:
    commander "~2.19.0"
    source-map "~0.6.1"

-uglify-js@^2.6.1:
-  version "2.8.29"
-  resolved "https://registry.yarnpkg.com/uglify-js/-/uglify-js-2.8.29.tgz#29c5733148057bb4e1f75df35b7a9cb72e6a59dd"
-  integrity sha1-KcVzMUgFe7Th913zW3qcty5qWd0=
-  dependencies:
-    source-map "~0.5.1"
-    yargs "~3.10.0"
-  optionalDependencies:
-    uglify-to-browserify "~1.0.0"
-
 uglify-js@^3.1.4:
  version "3.6.0"
  resolved "https://registry.yarnpkg.com/uglify-js/-/uglify-js-3.6.0.tgz#704681345c53a8b2079fb6cec294b05ead242ff5"
@@ -8769,26 +8535,6 @@ vm-browserify@^1.0.1:
  resolved "https://registry.yarnpkg.com/vm-browserify/-/vm-browserify-1.1.0.tgz#bd76d6a23323e2ca8ffa12028dc04559c75f9019"
  integrity sha512-iq+S7vZJE60yejDYM0ek6zg308+UZsdtPExWP9VZoCFCz1zkJoXFnAX7aZfd/ZwrkidzdUZL0C/ryW+JwAiIGw==

-void-elements@^2.0.1:
-  version "2.0.1"
-  resolved "https://registry.yarnpkg.com/void-elements/-/void-elements-2.0.1.tgz#c066afb582bb1cb4128d60ea92392e94d5e9dbec"
-  integrity sha1-wGavtYK7HLQSjWDqkjkulNXp2+w=
-
-vue-docgen-api@^4.0.1:
-  version "4.0.1"
-  resolved "https://registry.yarnpkg.com/vue-docgen-api/-/vue-docgen-api-4.0.1.tgz#14fe0e6844c3155b4fc47fb394139a4d9f36d6a4"
-  integrity sha512-FZr42ArWOzkjXoeflbRCTYKF30mjt3mcyuERte3wn0T8gJw7dNlwaczas7OTRXLpVAei5d81dZRRJk8PqODLGw==
-  dependencies:
-    "@babel/parser" "^7.2.3"
-    "@babel/types" "^7.0.0"
-    ast-types "^0.12.2"
-    hash-sum "^1.0.2"
-    lru-cache "^4.1.5"
-    pug "^2.0.3"
-    recast "^0.17.3"
-    ts-map "^1.0.3"
-    vue-template-compiler "^2.0.0"
-
 vue-hot-reload-api@^2.3.0:
  version "2.3.3"
  resolved "https://registry.yarnpkg.com/vue-hot-reload-api/-/vue-hot-reload-api-2.3.3.tgz#2756f46cb3258054c5f4723de8ae7e87302a1ccf"
@@ -8854,7 +8600,7 @@ vue-style-loader@^4.1.0, vue-style-loader@^4.1.2:
    hash-sum "^1.0.2"
    loader-utils "^1.0.2"

-vue-template-compiler@^2.0.0, vue-template-compiler@^2.6.10:
+vue-template-compiler@^2.6.10:
  version "2.6.10"
  resolved "https://registry.yarnpkg.com/vue-template-compiler/-/vue-template-compiler-2.6.10.tgz#323b4f3495f04faa3503337a82f5d6507799c9cc"
  integrity sha512-jVZkw4/I/HT5ZMvRnhv78okGusqe0+qH2A0Em0Cp8aq78+NK9TII263CDVz2QXZsIT+yyV/gZc/j/vlwa+Epyg==
@@ -9099,14 +8845,6 @@ window-size@0.1.0:
  resolved "https://registry.yarnpkg.com/window-size/-/window-size-0.1.0.tgz#5438cd2ea93b202efa3a19fe8887aee7c94f9c9d"
  integrity sha1-VDjNLqk7IC76Ohn+iIeu58lPnJ0=

-with@^5.0.0:
-  version "5.1.1"
-  resolved "https://registry.yarnpkg.com/with/-/with-5.1.1.tgz#fa4daa92daf32c4ea94ed453c81f04686b575dfe"
-  integrity sha1-+k2qktrzLE6pTtRTyB8EaGtXXf4=
-  dependencies:
-    acorn "^3.1.0"
-    acorn-globals "^3.0.0"
-
 wordwrap@0.0.2:
  version "0.0.2"
  resolved "https://registry.yarnpkg.com/wordwrap/-/wordwrap-0.0.2.tgz#b79669bb42ecb409f83d583cad52ca17eaa1643f"