Merge branch 'master' into feature/#2465_autofix_in_define-props-declaration

Author: mpiniarski

docs/.vitepress/build-system/build.mts

@@ -2,7 +2,7 @@
  * Pre-build cjs packages that cannot be bundled well.
  */
 import esbuild from 'esbuild'
-import path from 'path'
+import path from 'pathe'
 import fs from 'fs'
 import { fileURLToPath } from 'url'
 

docs/.vitepress/config.mts

@@ -1,6 +1,6 @@
 import type { DefaultTheme } from 'vitepress'
 import { defineConfig } from 'vitepress'
-import path from 'path'
+import path from 'pathe'
 import { fileURLToPath } from 'url'
 import { viteCommonjs, vitePluginRequireResolve } from './vite-plugin.mjs'
 
@@ -214,6 +214,10 @@ export default async () => {
         ]
       },
 
+      outline: {
+        level: 'deep'
+      },
+
       algolia: {
         appId: '2L4MGZSULB',
         apiKey: 'fdf57932b27a6c230d01a890492ab76d',

docs/.vitepress/vite-plugin.mts

@@ -1,5 +1,5 @@
 import type { UserConfig } from 'vitepress'
-import path from 'path'
+import path from 'pathe'
 import { fileURLToPath } from 'url'
 import esbuild from 'esbuild'
 type Plugin = Extract<

docs/rules/object-curly-newline.md

@@ -36,4 +36,4 @@ This rule was introduced in eslint-plugin-vue v7.0.0
 - [Rule source](https://github.com/vuejs/eslint-plugin-vue/blob/master/lib/rules/object-curly-newline.js)
 - [Test source](https://github.com/vuejs/eslint-plugin-vue/blob/master/tests/lib/rules/object-curly-newline.js)
 
-<sup>Taken with ❤️ [from ESLint Stylistic](https://eslint.style/rules/js/object-curly-newline)</sup>
+<sup>Taken with ❤️ [from ESLint Stylistic](https://eslint.style/rules/ts/object-curly-newline)</sup>

docs/rules/object-property-newline.md

@@ -36,4 +36,4 @@ This rule was introduced in eslint-plugin-vue v7.0.0
 - [Rule source](https://github.com/vuejs/eslint-plugin-vue/blob/master/lib/rules/object-property-newline.js)
 - [Test source](https://github.com/vuejs/eslint-plugin-vue/blob/master/tests/lib/rules/object-property-newline.js)
 
-<sup>Taken with ❤️ [from ESLint Stylistic](https://eslint.style/rules/js/object-property-newline)</sup>
+<sup>Taken with ❤️ [from ESLint Stylistic](https://eslint.style/rules/ts/object-property-newline)</sup>

docs/user-guide/index.md

@@ -146,6 +146,48 @@ If you want to use custom parsers such as [@babel/eslint-parser](https://www.npm
   }
 ```
 
+Full example:
+
+::: code-group
+
+```json [.eslintrc]
+{
+  "root": true,
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:vue/vue3-recommended"
+  ],
+  "parser": "vue-eslint-parser",
+  "parserOptions": {
+    "parser": "@typescript-eslint/parser"
+  }
+}
+```
+
+```js [eslint.config.js]
+import js from '@eslint/js'
+import eslintPluginVue from 'eslint-plugin-vue'
+import ts from 'typescript-eslint'
+
+export default ts.config(
+  js.configs.recommended,
+  ...ts.configs.recommended,
+  ...eslintPluginVue.configs['flat/recommended'],
+  {
+    files: ['*.vue', '**/*.vue'],
+    languageOptions: {
+      parserOptions: {
+        parser: '@typescript-eslint/parser'
+      }
+    }
+  }
+)
+```
+
+:::
+
 The `parserOptions.parser` option can also specify an object to specify multiple parsers. See [vue-eslint-parser README](https://github.com/vuejs/vue-eslint-parser#readme) for more details.
 
 ### How does ESLint detect components?
@@ -441,8 +483,7 @@ In [Nuxt 3](https://nuxt.com/) or with [`unplugin-auto-import`](https://github.c
 
 ::: code-group
 
-```json [Legacy Config]
-// .eslintrc
+```json [.eslintrc]
 {
   "globals": {
     "ref": "readonly",
@@ -454,8 +495,7 @@ In [Nuxt 3](https://nuxt.com/) or with [`unplugin-auto-import`](https://github.c
 }
 ```
 
-```js [Flat Config]
-// eslint.config.js
+```js [eslint.config.js]
 export default [
   {
     languageOptions: {

eslint.config.js

@@ -1,15 +1,12 @@
 'use strict'
 
 const globals = require('globals')
-const { FlatCompat } = require('@eslint/eslintrc')
 const eslintPluginEslintPlugin = require('eslint-plugin-eslint-plugin/configs/all')
+const eslintPluginJsonc = require('eslint-plugin-jsonc')
+const eslintPluginNodeDependencies = require('eslint-plugin-node-dependencies')
 const eslintPluginPrettierRecommended = require('eslint-plugin-prettier/recommended')
 const eslintPluginUnicorn = require('eslint-plugin-unicorn')
 
-const eslintrc = new FlatCompat({
-  baseDirectory: __dirname
-})
-
 module.exports = [
   {
     ignores: [
@@ -30,10 +27,8 @@ module.exports = [
   },
   eslintPluginEslintPlugin,
   eslintPluginUnicorn.configs['flat/recommended'],
-  ...eslintrc.extends(
-    'plugin:node-dependencies/recommended',
-    'plugin:jsonc/recommended-with-jsonc'
-  ),
+  ...eslintPluginNodeDependencies.configs['flat/recommended'],
+  ...eslintPluginJsonc.configs['flat/recommended-with-jsonc'],
   eslintPluginPrettierRecommended,
   {
     plugins: {
@@ -144,6 +139,7 @@ module.exports = [
       'prefer-const': 2,
 
       'prettier/prettier': 'error',
+      'eslint-plugin/require-meta-docs-recommended': 'off', // use `categories` instead
       'eslint-plugin/require-meta-fixable': [
         'error',
         { catchNoFixerButFixableProperty: true }

lib/configs/flat/base.js

@@ -6,6 +6,7 @@
 const globals = require('globals')
 module.exports = [
   {
+    name: 'vue:base:setup',
     plugins: {
       get vue() {
         return require('../../index')
@@ -17,6 +18,7 @@ module.exports = [
     }
   },
   {
+    name: 'vue:base:setup-for-vue',
     files: ['*.vue', '**/*.vue'],
     plugins: {
       get vue() {

lib/configs/flat/vue2-essential.js

@@ -9,6 +9,7 @@ const config = require('./base.js')
 module.exports = [
   ...config,
   {
+    name: 'vue:vue2-essential:rules',
     rules: {
       'vue/multi-word-component-names': 'error',
       'vue/no-arrow-functions-in-watch': 'error',

lib/configs/flat/vue2-recommended.js

@@ -9,6 +9,7 @@ const config = require('./vue2-strongly-recommended.js')
 module.exports = [
   ...config,
   {
+    name: 'vue:vue2-recommended:rules',
     rules: {
       'vue/attributes-order': 'warn',
       'vue/component-tags-order': 'warn',