README.md

@@ -40,7 +40,7 @@ Since single file components in Vue are not plain JavaScript, the default parser
 
 To know more about certain nodes in produced ASTs, go here:
 - [ESTree docs](https://github.com/estree/estree)
-- [vue-eslint-parser AST docs](https://github.com/mysticatea/vue-eslint-parser/blob/master/docs/ast.md)
+- [vue-eslint-parser AST docs](https://github.com/vuejs/vue-eslint-parser/blob/master/docs/ast.md)
 
 The `vue-eslint-parser` provides a few useful parser services that help traverse the produced AST and access tokens of the template:
 - `context.parserServices.defineTemplateBodyVisitor(visitor, scriptVisitor)`

docs/.vuepress/components/eslint-code-block.vue

@@ -124,11 +124,11 @@ export default {
     // Load linter.
     const [
       { default: Linter },
-      { default: noUndefRule },
+      { default: coreRules },
       { parseForESLint }
     ] = await Promise.all([
       import('eslint4b/dist/linter'),
-      import('eslint/lib/rules/no-undef'),
+      import('eslint4b/dist/core-rules'),
       import('espree').then(() => import('vue-eslint-parser'))
     ])
 
@@ -137,7 +137,7 @@ export default {
     for (const ruleId of Object.keys(rules)) {
       linter.defineRule(`vue/${ruleId}`, rules[ruleId])
     }
-    linter.defineRule('no-undef', noUndefRule)
+    linter.defineRule('no-undef', coreRules['no-undef'])
 
     linter.defineParser('vue-eslint-parser', { parseForESLint })
   }

docs/.vuepress/config.js

@@ -5,6 +5,7 @@
 'use strict'
 
 const rules = require('../../tools/lib/rules')
+const path = require('path')
 
 const uncategorizedRules = rules.filter(
   (rule) =>
@@ -122,7 +123,8 @@ module.exports = {
     return {
       resolve: {
         alias: {
-          module: require.resolve('./shim/module')
+          module: require.resolve('./shim/module'),
+          eslint: path.resolve(__dirname, './shim/eslint')
         }
       }
     }

docs/.vuepress/shim/eslint/index.js

@@ -0,0 +1,2 @@
+const Linter = require('eslint4b')
+module.exports = { Linter }

docs/developer-guide/README.md

@@ -39,7 +39,7 @@ Since single file components in Vue are not plain JavaScript, we can't use the d
 
 To know more about certain nodes in produced ASTs, go here:
 - [ESTree docs](https://github.com/estree/estree)
-- [vue-eslint-parser AST docs](https://github.com/mysticatea/vue-eslint-parser/blob/master/docs/ast.md)
+- [vue-eslint-parser AST docs](https://github.com/vuejs/vue-eslint-parser/blob/master/docs/ast.md)
 
 The `vue-eslint-parser` provides few useful parser services, to help traverse the produced AST and access tokens of the template:
 - `context.parserServices.defineTemplateBodyVisitor(visitor, scriptVisitor)`

docs/rules/README.md

@@ -281,13 +281,14 @@ For example:
 ```json
 {
   "rules": {
-    "vue/component-name-in-template-casing": "error"
+    "vue/block-tag-newline": "error"
   }
 }
 ```
 
 | Rule ID | Description |    |
 |:--------|:------------|:---|
+| [vue/block-tag-newline](./block-tag-newline.md) | enforce line breaks after opening and before closing block-level tags | :wrench: |
 | [vue/component-name-in-template-casing](./component-name-in-template-casing.md) | enforce specific casing for the component naming style in template | :wrench: |
 | [vue/html-comment-content-newline](./html-comment-content-newline.md) | enforce unified line brake in HTML comments | :wrench: |
 | [vue/html-comment-content-spacing](./html-comment-content-spacing.md) | enforce unified spacing in HTML comments | :wrench: |
@@ -325,6 +326,7 @@ The following rules extend the rules provided by ESLint itself and apply them to
 
 | Rule ID | Description |    |
 |:--------|:------------|:---|
+| [vue/array-bracket-newline](./array-bracket-newline.md) | enforce linebreaks after opening and before closing array brackets | :wrench: |
 | [vue/array-bracket-spacing](./array-bracket-spacing.md) | enforce consistent spacing inside array brackets | :wrench: |
 | [vue/arrow-spacing](./arrow-spacing.md) | enforce consistent spacing before and after the arrow in arrow functions | :wrench: |
 | [vue/block-spacing](./block-spacing.md) | disallow or enforce spaces inside of blocks after opening block and before closing block | :wrench: |

docs/rules/array-bracket-newline.md

@@ -0,0 +1,25 @@
+---
+pageClass: rule-details
+sidebarDepth: 0
+title: vue/array-bracket-newline
+description: enforce linebreaks after opening and before closing array brackets
+---
+# vue/array-bracket-newline
+> enforce linebreaks after opening and before closing array brackets
+
+- :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
+
+This rule is the same rule as core [array-bracket-newline] rule but it applies to the expressions in `<template>`.
+
+## :books: Further Reading
+
+- [array-bracket-newline]
+
+[array-bracket-newline]: https://eslint.org/docs/rules/array-bracket-newline
+
+## :mag: Implementation
+
+- [Rule source](https://github.com/vuejs/eslint-plugin-vue/blob/master/lib/rules/array-bracket-newline.js)
+- [Test source](https://github.com/vuejs/eslint-plugin-vue/blob/master/tests/lib/rules/array-bracket-newline.js)
+
+<sup>Taken with ❤️ [from ESLint core](https://eslint.org/docs/rules/array-bracket-newline)</sup>

docs/rules/block-tag-newline.md

@@ -0,0 +1,161 @@
+---
+pageClass: rule-details
+sidebarDepth: 0
+title: vue/block-tag-newline
+description: enforce line breaks after opening and before closing block-level tags
+---
+# vue/block-tag-newline
+> enforce line breaks after opening and before closing block-level tags
+
+- :wrench: The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
+
+## :book: Rule Details
+
+This rule enforces a line break (or no line break) after opening and before closing block tags.
+
+<eslint-code-block fix :rules="{'vue/block-tag-newline': ['error']}">
+
+```vue
+<!-- ✓ GOOD -->
+<template><input></template>
+
+<script>
+export default {}
+</script>
+```
+
+</eslint-code-block>
+
+<eslint-code-block fix :rules="{'vue/block-tag-newline': ['error']}">
+
+```vue
+<!-- ✗ BAD -->
+<template>
+<input></template>
+
+<script>
+export default {}</script>
+```
+
+</eslint-code-block>
+
+## :wrench: Options
+
+```json
+{
+  "vue/block-tag-newline": ["error", {
+    "singleline": "always" | "never" | "consistent" | "ignore",
+    "multiline": "always" | "never" | "consistent" | "ignore",
+    "maxEmptyLines": 0,
+    "blocks": {
+      "template": {
+        "singleline": "always" | "never" | "consistent" | "ignore",
+        "multiline": "always" | "never" | "consistent" | "ignore",
+        "maxEmptyLines": 0,
+      },
+      "script": {
+        "singleline": "always" | "never" | "consistent" | "ignore",
+        "multiline": "always" | "never" | "consistent" | "ignore",
+        "maxEmptyLines": 0,
+      },
+      "my-block": {
+        "singleline": "always" | "never" | "consistent" | "ignore",
+        "multiline": "always" | "never" | "consistent" | "ignore",
+        "maxEmptyLines": 0,
+      }
+    }
+  }]
+}
+```
+
+- `singleline` ... the configuration for single-line blocks.
+  - `"consistent"` ... (default) requires consistent usage of line breaks for each pair of tags. It reports an error if one tag in the pair has a linebreak inside it and the other tag does not.
+  - `"always"` ... require one line break after opening and before closing block tags.
+  - `"never"` ... disallow line breaks after opening and before closing block tags.
+- `multiline` ... the configuration for multi-line blocks.
+  - `"consistent"` ... requires consistent usage of line breaks for each pair of tags. It reports an error if one tag in the pair has a linebreak inside it and the other tag does not.
+  - `"always"` ... (default) require one line break after opening and before closing block tags.
+  - `"never"` ... disallow line breaks after opening and before closing block tags.
+- `maxEmptyLines` ... specifies the maximum number of empty lines allowed. default 0.
+- `blocks` ... specifies for each block name.
+
+### `{ "singleline": "never", "multiline": "always" }`
+
+<eslint-code-block fix :rules="{'vue/block-tag-newline': ['error', { 'singleline': 'never', 'multiline': 'always' }]}">
+
+```vue
+<!-- ✓ GOOD -->
+<template><input></template>
+
+<script>
+export default {
+}
+</script>
+```
+
+</eslint-code-block>
+
+<eslint-code-block fix :rules="{'vue/block-tag-newline': ['error', { 'singleline': 'never', 'multiline': 'always' }]}">
+
+```vue
+<!-- ✗ BAD -->
+<template>
+<input>
+</template>
+
+<script>export default {
+}</script>
+```
+
+</eslint-code-block>
+
+### `{ "singleline": "always", "multiline": "always", "maxEmptyLines": 1 }`
+
+<eslint-code-block fix :rules="{'vue/block-tag-newline': ['error', { 'singleline': 'always', 'multiline': 'always', 'maxEmptyLines': 1 }]}">
+
+```vue
+<!-- ✓ GOOD -->
+<template>
+
+<input>
+
+</template>
+
+<script>
+
+export default {
+}
+
+</script>
+```
+
+</eslint-code-block>
+
+<eslint-code-block fix :rules="{'vue/block-tag-newline': ['error', { 'singleline': 'always', 'multiline': 'always', 'maxEmptyLines': 1 }]}">
+
+```vue
+<!-- ✗ BAD -->
+<template>
+
+
+<input>
+
+
+</template>
+
+<script>
+
+
+export default {
+}
+
+
+</script>
+```
+
+</eslint-code-block>
+
+## :mag: Implementation
+
+- [Rule source](https://github.com/vuejs/eslint-plugin-vue/blob/master/lib/rules/block-tag-newline.js)
+- [Test source](https://github.com/vuejs/eslint-plugin-vue/blob/master/tests/lib/rules/block-tag-newline.js)

docs/rules/custom-event-name-casing.md

@@ -49,7 +49,47 @@ export default {
 
 ## :wrench: Options
 
-Nothing.
+
+```json
+{
+  "vue/custom-event-name-casing": ["error", {
+    "ignores": []
+  }]
+}
+```
+- `ignores` (`string[]`) ... The event names to ignore. Sets the event name to allow. For example, custom event names, Vue components event with special name, or Vue library component event name. You can set the regexp by writing it like `"/^name/"` or `click:row` or `fooBar`.
+
+### `"ignores": ["fooBar", "/^[a-z]+(?:-[a-z]+)*:[a-z]+(?:-[a-z]+)*$/u"]`
+
+<eslint-code-block :rules="{'vue/custom-event-name-casing': ['error', {ignores:'/^[a-z]+(?:-[a-z]+)*:[a-z]+(?:-[a-z]+)*$/u'}]}">
+
+```vue
+<template>
+  <!-- ✓ GOOD -->
+  <button @click="$emit('click:row')" />
+  <button @click="$emit('fooBar')" />
+
+  <!-- ✗ BAD -->
+  <button @click="$emit('myEvent')" />
+</template>
+<script>
+export default {
+  methods: {
+    onClick () {
+      /* ✓ GOOD */
+      this.$emit('click:row')
+      this.$emit('fooBar')
+
+      /* ✗ BAD */
+      this.$emit('myEvent')
+    }
+  }
+}
+</script>
+```
+
+</eslint-code-block>
+
 
 ## :books: Further Reading
 

docs/rules/html-indent.md

@@ -82,7 +82,7 @@ This rule enforces a consistent indentation style in `<template>`. The default s
   - `closeBracket.endTag` (`integer`) ... The multiplier of indentation for right brackets of end tags (`</div>`). Default is `0`.
   - `closeBracket.selfClosingTag` (`integer`) ... The multiplier of indentation for right brackets of start tags (`<div/>`). Default is `0`.
 - `alignAttributesVertically` (`boolean`) ... Condition for whether attributes should be vertically aligned to the first attribute in multiline case or not. Default is `true`
-- `ignores` (`string[]`) ... The selector to ignore nodes. The AST spec is [here](https://github.com/mysticatea/vue-eslint-parser/blob/master/docs/ast.md). You can use [esquery](https://github.com/estools/esquery#readme) to select nodes. Default is an empty array.
+- `ignores` (`string[]`) ... The selector to ignore nodes. The AST spec is [here](https://github.com/vuejs/vue-eslint-parser/blob/master/docs/ast.md). You can use [esquery](https://github.com/estools/esquery#readme) to select nodes. Default is an empty array.
 
 ### `2, {"attribute": 1, "closeBracket": 1}`
 

docs/rules/no-restricted-syntax.md

@@ -46,8 +46,8 @@ Forbids call expressions inside mustache interpolation.
 
 [no-restricted-syntax]: https://eslint.org/docs/rules/no-restricted-syntax
 [ESTree]: https://github.com/estree/estree
-[vue-eslint-parser]: https://github.com/mysticatea/vue-eslint-parser
-[vue-eslint-parser - AST docs]: https://github.com/mysticatea/vue-eslint-parser/blob/master/docs/ast.md
+[vue-eslint-parser]: https://github.com/vuejs/vue-eslint-parser
+[vue-eslint-parser - AST docs]: https://github.com/vuejs/vue-eslint-parser/blob/master/docs/ast.md
 
 ## :mag: Implementation
 

docs/rules/no-textarea-mustache.md

@@ -27,11 +27,15 @@ This rule reports mustaches in `<textarea>`.
 
 </eslint-code-block>
 
+<div v-pre>
+
 ::: warning Note
 Interpolation on textareas (`<textarea>{{text}}</textarea>`) won't work. Use `v-model` instead.
 [https://v3.vuejs.org/guide/forms.html#multiline-text](https://v3.vuejs.org/guide/forms.html#multiline-text)
 :::
 
+</div>
+
 ## :wrench: Options
 
 Nothing.

docs/rules/no-unused-vars.md

@@ -33,7 +33,7 @@ This rule report variable definitions of v-for directives or scope attributes if
 
 ## :wrench: Options
 
-```js
+```json
 {
     "vue/no-unused-vars": ["error", {
         "ignorePattern": "^_"

docs/rules/script-indent.md

@@ -59,7 +59,7 @@ This rule has some options.
 - `TYPE` (`number | "tab"`) ... The type of indentation. Default is `2`. If this is a number, it's the number of spaces for one indent. If this is `"tab"`, it uses one tab for one indent.
 - `baseIndent` (`integer`) ... The multiplier of indentation for top-level statements. Default is `0`.
 - `switchCase` (`integer`) ... The multiplier of indentation for `case`/`default` clauses. Default is `0`.
-- `ignores` (`string[]`) ... The selector to ignore nodes. The AST spec is [here](https://github.com/mysticatea/vue-eslint-parser/blob/master/docs/ast.md). You can use [esquery](https://github.com/estools/esquery#readme) to select nodes. Default is an empty array.
+- `ignores` (`string[]`) ... The selector to ignore nodes. The AST spec is [here](https://github.com/vuejs/vue-eslint-parser/blob/master/docs/ast.md). You can use [esquery](https://github.com/estools/esquery#readme) to select nodes. Default is an empty array.
 
 ::: warning Note
 This rule only checks `.vue` files and does not interfere with other `.js` files. Unfortunately the default `indent` rule when turned on will try to lint both, so in order to make them complementary you can use `overrides` setting and disable `indent` rule on `.vue` files: