From 5ab0de620ce66a78231931d27b4a12751c0c8521 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 00:10:25 +0800
Subject: [PATCH 01/14] feat: add vue/no-undef-directives rule

---
 docs/rules/index.md                          |   2 +
 docs/rules/no-undef-directives.md            |  78 ++++
 lib/plugin.js                                |   1 +
 lib/rules/no-undef-directives.js             | 277 ++++++++++++
 tests/lib/rules/no-undef-directives-repro.js |   0
 tests/lib/rules/no-undef-directives.js       | 435 +++++++++++++++++++
 6 files changed, 793 insertions(+)
 create mode 100644 docs/rules/no-undef-directives.md
 create mode 100644 lib/rules/no-undef-directives.js
 create mode 100644 tests/lib/rules/no-undef-directives-repro.js
 create mode 100644 tests/lib/rules/no-undef-directives.js

diff --git a/docs/rules/index.md b/docs/rules/index.md
index 5d8deaf00..9d7b783b7 100644
--- a/docs/rules/index.md
+++ b/docs/rules/index.md
@@ -258,6 +258,7 @@ For example:
 | [vue/no-template-target-blank] | disallow target="_blank" attribute without rel="noopener noreferrer" | :bulb: | :warning: |
 | [vue/no-this-in-before-route-enter] | disallow `this` usage in a `beforeRouteEnter` method |  | :warning: |
 | [vue/no-undef-components] | disallow use of undefined components in `<template>` |  | :hammer: |
+| [vue/no-undef-directives] | disallow use of undefined custom directives |  | :warning: |
 | [vue/no-undef-properties] | disallow undefined properties |  | :hammer: |
 | [vue/no-unsupported-features] | disallow unsupported Vue.js syntax on the specified version | :wrench: | :hammer: |
 | [vue/no-unused-emit-declarations] | disallow unused emit declarations |  | :hammer: |
@@ -521,6 +522,7 @@ The following rules extend the rules provided by ESLint itself and apply them to
 [vue/no-textarea-mustache]: ./no-textarea-mustache.md
 [vue/no-this-in-before-route-enter]: ./no-this-in-before-route-enter.md
 [vue/no-undef-components]: ./no-undef-components.md
+[vue/no-undef-directives]: ./no-undef-directives.md
 [vue/no-undef-properties]: ./no-undef-properties.md
 [vue/no-unsupported-features]: ./no-unsupported-features.md
 [vue/no-unused-components]: ./no-unused-components.md
diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
new file mode 100644
index 000000000..c8f89d71d
--- /dev/null
+++ b/docs/rules/no-undef-directives.md
@@ -0,0 +1,78 @@
+---
+pageClass: rule-details
+sidebarDepth: 0
+title: vue/no-undef-directives
+description: disallow use of undefined custom directives
+---
+
+# vue/no-undef-directives
+
+> disallow use of undefined custom directives
+
+- :exclamation: <badge text="This rule has not been released yet." vertical="middle" type="error"> _**This rule has not been released yet.**_ </badge>
+
+## :book: Rule Details
+
+This rule reports use of undefined custom directives in `<template>`.
+
+<eslint-code-block :rules="{'vue/no-undef-directives': ['error']}">
+
+```vue
+<template>
+  <!-- ✗ BAD -->
+  <input v-focus>
+  <div v-foo></div>
+</template>
+
+<script setup>
+// vFocus is not imported
+</script>
+```
+
+</eslint-code-block>
+
+<eslint-code-block :rules="{'vue/no-undef-directives': ['error']}">
+
+```vue
+<template>
+  <!-- ✓ GOOD -->
+  <input v-focus>
+  <div v-foo></div>
+</template>
+
+<script setup>
+import vFocus from './vFocus';
+const vFoo = {}
+</script>
+```
+
+</eslint-code-block>
+
+## :wrench: Options
+
+```json
+{
+  "vue/no-undef-directives": ["error", {
+    "ignorePatterns": ["foo"]
+  }]
+}
+```
+
+- `ignorePatterns` (`string[]`) ... An array of regex pattern strings to ignore.
+
+### `ignorePatterns`
+
+<eslint-code-block :rules="{'vue/no-undef-directives': ['error', {ignorePatterns: ['foo']}]}">
+
+```vue
+<template>
+  <div v-foo></div>
+</template>
+```
+
+</eslint-code-block>
+
+## :mag: Implementation
+
+- [Rule source](https://github.com/vuejs/eslint-plugin-vue/blob/master/lib/rules/no-undef-directives.js)
+- [Test source](https://github.com/vuejs/eslint-plugin-vue/blob/master/tests/lib/rules/no-undef-directives.js)
diff --git a/lib/plugin.js b/lib/plugin.js
index 7bedbbdf5..df835735e 100644
--- a/lib/plugin.js
+++ b/lib/plugin.js
@@ -151,6 +151,7 @@ const plugin = {
     'no-textarea-mustache': require('./rules/no-textarea-mustache'),
     'no-this-in-before-route-enter': require('./rules/no-this-in-before-route-enter'),
     'no-undef-components': require('./rules/no-undef-components'),
+    'no-undef-directives': require('./rules/no-undef-directives'),
     'no-undef-properties': require('./rules/no-undef-properties'),
     'no-unsupported-features': require('./rules/no-unsupported-features'),
     'no-unused-components': require('./rules/no-unused-components'),
diff --git a/lib/rules/no-undef-directives.js b/lib/rules/no-undef-directives.js
new file mode 100644
index 000000000..bfc559789
--- /dev/null
+++ b/lib/rules/no-undef-directives.js
@@ -0,0 +1,277 @@
+/**
+ * @author rzzf
+ * See LICENSE file in root directory for full license.
+ */
+'use strict'
+
+const utils = require('../utils')
+const casing = require('../utils/casing')
+
+/**
+ * @param {string} str
+ * @returns {string}
+ */
+function camelize(str) {
+  return str.replace(/-(\w)/g, (_, c) => (c ? c.toUpperCase() : ''))
+}
+
+/**
+ * @param {ObjectExpression} componentObject
+ * @returns { { node: Property, name: string }[] } Array of ASTNodes
+ */
+function getRegisteredDirectives(componentObject) {
+  const directivesNode = componentObject.properties.find(
+    (p) =>
+      p.type === 'Property' &&
+      utils.getStaticPropertyName(p) === 'directives' &&
+      p.value.type === 'ObjectExpression'
+  )
+
+  if (
+    !directivesNode ||
+    directivesNode.type !== 'Property' ||
+    directivesNode.value.type !== 'ObjectExpression'
+  ) {
+    return []
+  }
+
+  return directivesNode.value.properties
+    .filter(
+      /**
+       * @param {Property | SpreadElement} node
+       * @returns {node is Property}
+       */
+      (node) => node.type === 'Property'
+    )
+    .map((node) => {
+      const name = utils.getStaticPropertyName(node)
+      return name ? { node, name } : null
+    })
+    .filter(
+      /**
+       * @param {{node: Property, name: string} | null} res
+       * @returns {res is {node: Property, name: string}}
+       */
+      (res) => res !== null
+    )
+}
+
+class DefinedInSetupDirectives {
+  constructor() {
+    /**
+     * Directive names
+     * @type {Set<string>}
+     */
+    this.names = new Set()
+  }
+
+  /**
+   * @param {string[]} names
+   */
+  addName(...names) {
+    for (const name of names) {
+      this.names.add(name)
+    }
+  }
+
+  /**
+   * @param {string} rawName
+   */
+  isDefinedDirective(rawName) {
+    const camelName = camelize(rawName)
+    const variableName = `v${casing.capitalize(camelName)}`
+    if (this.names.has(variableName)) {
+      return true
+    }
+    return false
+  }
+}
+
+class DefinedInOptionDirectives {
+  constructor() {
+    /**
+     * Directive names
+     * @type {Set<string>}
+     */
+    this.names = new Set()
+  }
+
+  /**
+   * @param {string[]} names
+   */
+  addName(...names) {
+    for (const name of names) {
+      this.names.add(name)
+    }
+  }
+
+  /**
+   * @param {string} rawName
+   */
+  isDefinedDirective(rawName) {
+    const camelName = camelize(rawName)
+    if (this.names.has(rawName) || this.names.has(camelName)) {
+      return true
+    }
+
+    // allow case-insensitive ONLY when the directive name itself contains capitalized letters
+    for (const name of this.names) {
+      if (
+        name.toLowerCase() === camelName.toLowerCase() &&
+        name !== name.toLowerCase()
+      ) {
+        return true
+      }
+    }
+
+    return false
+  }
+}
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'disallow use of undefined custom directives',
+      categories: undefined,
+      url: 'https://eslint.vuejs.org/rules/no-undef-directives.html'
+    },
+    fixable: null,
+    schema: [
+      {
+        type: 'object',
+        properties: {
+          ignorePatterns: {
+            type: 'array',
+            items: {
+              type: 'string'
+            },
+            uniqueItems: true
+          }
+        },
+        additionalProperties: true
+      }
+    ],
+    messages: {
+      undef: "The 'v-{{name}}' directive has been used, but not defined."
+    }
+  },
+  /** @param {RuleContext} context */
+  create(context) {
+    const options = context.options[0] || {}
+    /** @type {string[]} */
+    const ignorePatterns = options.ignorePatterns || []
+
+    /**
+     * Check whether the given directive name is a verify target or not.
+     *
+     * @param {string} rawName The directive name.
+     * @returns {boolean}
+     */
+    function isVerifyTargetDirective(rawName) {
+      if (utils.isBuiltInDirectiveName(rawName)) {
+        return false
+      }
+
+      const ignored = ignorePatterns.some((pattern) =>
+        new RegExp(pattern).test(rawName)
+      )
+      return !ignored
+    }
+
+    /** @type { (rawName:string, reportNode: ASTNode) => void } */
+    let verifyName
+    /** @type {RuleListener} */
+    let scriptVisitor = {}
+    /** @type {TemplateListener} */
+    const templateBodyVisitor = {
+      /** @param {VDirective} node */
+      'VAttribute[directive=true]'(node) {
+        const name = node.key.name.name
+        if (utils.isBuiltInDirectiveName(name)) {
+          return
+        }
+        verifyName(node.key.name.rawName || name, node.key)
+      }
+    }
+
+    if (utils.isScriptSetup(context)) {
+      // For <script setup>
+      const definedInSetupDirectives = new DefinedInSetupDirectives()
+      const definedInOptionDirectives = new DefinedInOptionDirectives()
+
+      const globalScope = context.sourceCode.scopeManager.globalScope
+      if (globalScope) {
+        for (const variable of globalScope.variables) {
+          definedInSetupDirectives.addName(variable.name)
+        }
+        const moduleScope = globalScope.childScopes.find(
+          (scope) => scope.type === 'module'
+        )
+        for (const variable of (moduleScope && moduleScope.variables) || []) {
+          definedInSetupDirectives.addName(variable.name)
+        }
+      }
+
+      scriptVisitor = utils.defineVueVisitor(context, {
+        onVueObjectEnter(node) {
+          for (const directive of getRegisteredDirectives(node)) {
+            definedInOptionDirectives.addName(directive.name)
+          }
+        }
+      })
+
+      verifyName = (rawName, reportNode) => {
+        if (!isVerifyTargetDirective(rawName)) {
+          return
+        }
+        if (definedInSetupDirectives.isDefinedDirective(rawName)) {
+          return
+        }
+        if (definedInOptionDirectives.isDefinedDirective(rawName)) {
+          return
+        }
+
+        context.report({
+          node: reportNode,
+          messageId: 'undef',
+          data: {
+            name: rawName
+          }
+        })
+      }
+    } else {
+      // For Options API
+      const definedInOptionDirectives = new DefinedInOptionDirectives()
+
+      scriptVisitor = utils.executeOnVue(context, (obj) => {
+        for (const directive of getRegisteredDirectives(obj)) {
+          definedInOptionDirectives.addName(directive.name)
+        }
+      })
+
+      verifyName = (rawName, reportNode) => {
+        if (!isVerifyTargetDirective(rawName)) {
+          return
+        }
+        if (definedInOptionDirectives.isDefinedDirective(rawName)) {
+          return
+        }
+
+        context.report({
+          node: reportNode,
+          messageId: 'undef',
+          data: {
+            name: rawName
+          }
+        })
+      }
+    }
+
+    return utils.defineTemplateBodyVisitor(
+      context,
+      templateBodyVisitor,
+      scriptVisitor
+    )
+  }
+}
diff --git a/tests/lib/rules/no-undef-directives-repro.js b/tests/lib/rules/no-undef-directives-repro.js
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/lib/rules/no-undef-directives.js b/tests/lib/rules/no-undef-directives.js
new file mode 100644
index 000000000..5b674e092
--- /dev/null
+++ b/tests/lib/rules/no-undef-directives.js
@@ -0,0 +1,435 @@
+/**
+ * @author rzzf
+ * See LICENSE file in root directory for full license.
+ */
+'use strict'
+
+const RuleTester = require('../../eslint-compat').RuleTester
+const rule = require('../../../lib/rules/no-undef-directives')
+
+const tester = new RuleTester({
+  languageOptions: {
+    parser: require('vue-eslint-parser'),
+    ecmaVersion: 2020,
+    sourceType: 'module'
+  }
+})
+
+tester.run('no-undef-directives', rule, {
+  valid: [
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-text="text"></div>
+        <div v-html="html"></div>
+        <div v-show="true"></div>
+        <div v-if="true"></div>
+        <div v-else-if="true"></div>
+        <div v-else></div>
+        <div v-for="item in items"></div>
+        <div v-bind:id="id"></div>
+        <div :id="id"></div>
+        <div v-on:click="click"></div>
+        <div @click="click"></div>
+        <div v-model="value"></div>
+        <div v-pre></div>
+        <div v-cloak></div>
+        <div v-once></div>
+        <div v-memo="[value]"></div>
+        <slot v-bind="item"></slot>
+        <component v-bind:is="'div'"></component>
+        <template v-slot:default></template>
+        <template #default></template>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vFocus from './vFocus'
+      const vFoo = {}
+      </script>
+      <template>
+        <div v-focus>
+        <div v-foo></div>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vFocus from './vFocus'
+      </script>
+      <template>
+        <div v-Focus>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vFocus from './vFocus'
+      </script>
+      <template>
+        <div v-focus.foo>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vFocus from './vFocus'
+      </script>
+      <template>
+        <div v-focus:foo>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vFocus from './vFocus'
+      </script>
+      <template>
+        <div v-focus:foo.bar>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vFocus from './vFocus'
+      </script>
+      <template>
+        <div v-focus:[arg]>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import {focus as vFocus} from './vFocus'
+      </script>
+      <template>
+        <div v-focus.foo>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vClickOutside from './vClickOutside'
+      </script>
+      <template>
+        <div v-click-outside>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vClickOutside from './vClickOutside'
+      </script>
+      <template>
+        <div v-clickOutside>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script>
+      export default {
+        directives: {
+          focus: {},
+        }
+      }
+      </script>
+      <template>
+        <div v-focus>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script>
+      export default {
+        directives: {
+          fooBar: {}
+        }
+      }
+      </script>
+      <template>
+        <div v-foo-bar></div>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script>
+      export default {
+        directives: {
+          fooBar: {}
+        }
+      }
+      </script>
+      <template>
+        <div v-fooBar></div>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script>
+      export default {
+        directives: {
+          'foo-bar': {}
+        }
+      }
+      </script>
+      <template>
+        <div v-foo-bar></div>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script>
+      export default {
+        directives: {
+          Focus: {}
+        }
+      }
+      </script>
+      <template>
+        <div v-focus>
+      </template>
+      `
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-foo></div>
+      </template>
+      `,
+      options: [{ ignorePatterns: ['foo'] }]
+    }
+  ],
+  invalid: [
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-focus>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-focus' directive has been used, but not defined.",
+          line: 3
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      const vfocus = {} // should be vFocus
+      </script>
+      <template>
+        <div v-focus>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-focus' directive has been used, but not defined.",
+          line: 6
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import { foo as bar } from './foo'
+      </script>
+      <template>
+        <div v-foo></div>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-foo' directive has been used, but not defined.",
+          line: 6
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import focus from './focus'
+      </script>
+      <template>
+        <div v-focus>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-focus' directive has been used, but not defined.",
+          line: 6
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vClickOutside from './vClickOutside'
+      </script>
+      <template>
+        <div v-clickoutside>
+      </template>
+      `,
+      errors: [
+        {
+          message:
+            "The 'v-clickoutside' directive has been used, but not defined.",
+          line: 6
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script setup>
+      import vClickoutside from './vClickOutside'
+      </script>
+      <template>
+        <div v-click-outside>
+      </template>
+      `,
+      errors: [
+        {
+          message:
+            "The 'v-click-outside' directive has been used, but not defined.",
+          line: 6
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-foo:[arg]></div>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-foo' directive has been used, but not defined.",
+          line: 3
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-foo.bar></div>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-foo' directive has been used, but not defined.",
+          line: 3
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-foo:bar.baz></div>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-foo' directive has been used, but not defined.",
+          line: 3
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script>
+      export default {
+        directives: {
+          focus: {}
+        }
+      }
+      </script>
+      <template>
+        <div v-Focus>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-Focus' directive has been used, but not defined.",
+          line: 10
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <script>
+      export default {
+        directives: {
+          foobar: {}
+        }
+      }
+      </script>
+      <template>
+        <div v-foo-bar></div>
+      </template>
+      `,
+      errors: [
+        {
+          message: "The 'v-foo-bar' directive has been used, but not defined.",
+          line: 10
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-foo-bar></div>
+      </template>
+      `,
+      options: [{ ignorePatterns: ['baz'] }],
+      errors: [
+        {
+          message: "The 'v-foo-bar' directive has been used, but not defined.",
+          line: 3
+        }
+      ]
+    }
+  ]
+})

From f46ad2011698cc1bd53db4b910104f7394cfaede Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 00:11:47 +0800
Subject: [PATCH 02/14] docs: update

---
 docs/rules/no-undef-directives.md            | 27 ++++++++++++++------
 tests/lib/rules/no-undef-directives-repro.js |  0
 2 files changed, 19 insertions(+), 8 deletions(-)
 delete mode 100644 tests/lib/rules/no-undef-directives-repro.js

diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
index c8f89d71d..e9ddb1685 100644
--- a/docs/rules/no-undef-directives.md
+++ b/docs/rules/no-undef-directives.md
@@ -13,20 +13,24 @@ description: disallow use of undefined custom directives
 
 ## :book: Rule Details
 
-This rule reports use of undefined custom directives in `<template>`.
+This rule reports directives that are used in the `<template>`, but that are not registered in the `<script setup>` or the Options API's `directives` section.
+
+Undefined directives will be resolved from globally registered directives. However, if you are not using global directives, you can use this rule to prevent run-time errors.
 
 <eslint-code-block :rules="{'vue/no-undef-directives': ['error']}">
 
 ```vue
+<script setup>
+import vFocus from './vFocus';
+</script>
+
 <template>
-  <!-- ✗ BAD -->
+  <!-- ✓ GOOD -->
   <input v-focus>
+
+  <!-- ✗ BAD -->
   <div v-foo></div>
 </template>
-
-<script setup>
-// vFocus is not imported
-</script>
 ```
 
 </eslint-code-block>
@@ -37,12 +41,19 @@ This rule reports use of undefined custom directives in `<template>`.
 <template>
   <!-- ✓ GOOD -->
   <input v-focus>
+
+  <!-- ✗ BAD -->
   <div v-foo></div>
 </template>
 
-<script setup>
+<script>
 import vFocus from './vFocus';
-const vFoo = {}
+
+export default {
+  directives: {
+    focus: vFocus
+  }
+}
 </script>
 ```
 
diff --git a/tests/lib/rules/no-undef-directives-repro.js b/tests/lib/rules/no-undef-directives-repro.js
deleted file mode 100644
index e69de29bb..000000000

From 93e277195aab48b6a390ddb5a68c787862a3ffe6 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 10:20:17 +0800
Subject: [PATCH 03/14] chore: cleanup and update tests

---
 lib/rules/no-undef-directives.js       | 41 ++++++------------
 tests/lib/rules/no-undef-directives.js | 60 ++++++++++++++++++++------
 2 files changed, 60 insertions(+), 41 deletions(-)

diff --git a/lib/rules/no-undef-directives.js b/lib/rules/no-undef-directives.js
index bfc559789..91bf0c26e 100644
--- a/lib/rules/no-undef-directives.js
+++ b/lib/rules/no-undef-directives.js
@@ -36,24 +36,12 @@ function getRegisteredDirectives(componentObject) {
   }
 
   return directivesNode.value.properties
-    .filter(
-      /**
-       * @param {Property | SpreadElement} node
-       * @returns {node is Property}
-       */
-      (node) => node.type === 'Property'
-    )
+    .filter((node) => node.type === 'Property')
     .map((node) => {
       const name = utils.getStaticPropertyName(node)
       return name ? { node, name } : null
     })
-    .filter(
-      /**
-       * @param {{node: Property, name: string} | null} res
-       * @returns {res is {node: Property, name: string}}
-       */
-      (res) => res !== null
-    )
+    .filter((res) => !!res)
 }
 
 class DefinedInSetupDirectives {
@@ -80,10 +68,7 @@ class DefinedInSetupDirectives {
   isDefinedDirective(rawName) {
     const camelName = camelize(rawName)
     const variableName = `v${casing.capitalize(camelName)}`
-    if (this.names.has(variableName)) {
-      return true
-    }
-    return false
+    return this.names.has(variableName)
   }
 }
 
@@ -222,13 +207,11 @@ module.exports = {
       })
 
       verifyName = (rawName, reportNode) => {
-        if (!isVerifyTargetDirective(rawName)) {
-          return
-        }
-        if (definedInSetupDirectives.isDefinedDirective(rawName)) {
-          return
-        }
-        if (definedInOptionDirectives.isDefinedDirective(rawName)) {
+        if (
+          !isVerifyTargetDirective(rawName) ||
+          definedInSetupDirectives.isDefinedDirective(rawName) ||
+          definedInOptionDirectives.isDefinedDirective(rawName)
+        ) {
           return
         }
 
@@ -251,10 +234,10 @@ module.exports = {
       })
 
       verifyName = (rawName, reportNode) => {
-        if (!isVerifyTargetDirective(rawName)) {
-          return
-        }
-        if (definedInOptionDirectives.isDefinedDirective(rawName)) {
+        if (
+          !isVerifyTargetDirective(rawName) ||
+          definedInOptionDirectives.isDefinedDirective(rawName)
+        ) {
           return
         }
 
diff --git a/tests/lib/rules/no-undef-directives.js b/tests/lib/rules/no-undef-directives.js
index 5b674e092..11bdd95d2 100644
--- a/tests/lib/rules/no-undef-directives.js
+++ b/tests/lib/rules/no-undef-directives.js
@@ -241,7 +241,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-focus' directive has been used, but not defined.",
-          line: 3
+          line: 3,
+          column: 14,
+          endLine: 3,
+          endColumn: 21
         }
       ]
     },
@@ -258,7 +261,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-focus' directive has been used, but not defined.",
-          line: 6
+          line: 6,
+          column: 14,
+          endLine: 6,
+          endColumn: 21
         }
       ]
     },
@@ -275,7 +281,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-foo' directive has been used, but not defined.",
-          line: 6
+          line: 6,
+          column: 14,
+          endLine: 6,
+          endColumn: 19
         }
       ]
     },
@@ -292,7 +301,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-focus' directive has been used, but not defined.",
-          line: 6
+          line: 6,
+          column: 14,
+          endLine: 6,
+          endColumn: 21
         }
       ]
     },
@@ -310,7 +322,10 @@ tester.run('no-undef-directives', rule, {
         {
           message:
             "The 'v-clickoutside' directive has been used, but not defined.",
-          line: 6
+          line: 6,
+          column: 14,
+          endLine: 6,
+          endColumn: 28
         }
       ]
     },
@@ -328,7 +343,10 @@ tester.run('no-undef-directives', rule, {
         {
           message:
             "The 'v-click-outside' directive has been used, but not defined.",
-          line: 6
+          line: 6,
+          column: 14,
+          endLine: 6,
+          endColumn: 29
         }
       ]
     },
@@ -342,7 +360,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-foo' directive has been used, but not defined.",
-          line: 3
+          line: 3,
+          column: 14,
+          endLine: 3,
+          endColumn: 25
         }
       ]
     },
@@ -356,7 +377,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-foo' directive has been used, but not defined.",
-          line: 3
+          line: 3,
+          column: 14,
+          endLine: 3,
+          endColumn: 23
         }
       ]
     },
@@ -370,7 +394,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-foo' directive has been used, but not defined.",
-          line: 3
+          line: 3,
+          column: 14,
+          endLine: 3,
+          endColumn: 27
         }
       ]
     },
@@ -391,7 +418,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-Focus' directive has been used, but not defined.",
-          line: 10
+          line: 10,
+          column: 14,
+          endLine: 10,
+          endColumn: 21
         }
       ]
     },
@@ -412,7 +442,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-foo-bar' directive has been used, but not defined.",
-          line: 10
+          line: 10,
+          column: 14,
+          endLine: 10,
+          endColumn: 23
         }
       ]
     },
@@ -427,7 +460,10 @@ tester.run('no-undef-directives', rule, {
       errors: [
         {
           message: "The 'v-foo-bar' directive has been used, but not defined.",
-          line: 3
+          line: 3,
+          column: 14,
+          endLine: 3,
+          endColumn: 23
         }
       ]
     }

From 7644d32a8500a26f53e0734190c9018a286b932f Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 20:55:32 +0800
Subject: [PATCH 04/14] Update docs/rules/no-undef-directives.md

Co-authored-by: Flo Edelmann <git@flo-edelmann.de>
---
 docs/rules/no-undef-directives.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
index e9ddb1685..6b300d298 100644
--- a/docs/rules/no-undef-directives.md
+++ b/docs/rules/no-undef-directives.md
@@ -15,7 +15,7 @@ description: disallow use of undefined custom directives
 
 This rule reports directives that are used in the `<template>`, but that are not registered in the `<script setup>` or the Options API's `directives` section.
 
-Undefined directives will be resolved from globally registered directives. However, if you are not using global directives, you can use this rule to prevent run-time errors.
+Undefined directives will be resolved from globally registered directives. However, if you are not using global directives, you can use this rule to prevent runtime errors.
 
 <eslint-code-block :rules="{'vue/no-undef-directives': ['error']}">
 

From 30b3a9ad6e65812be6ed04498a72a00b9918daa7 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 20:55:42 +0800
Subject: [PATCH 05/14] Update docs/rules/no-undef-directives.md

Co-authored-by: Flo Edelmann <git@flo-edelmann.de>
---
 docs/rules/no-undef-directives.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
index 6b300d298..c676ae2fc 100644
--- a/docs/rules/no-undef-directives.md
+++ b/docs/rules/no-undef-directives.md
@@ -71,7 +71,7 @@ export default {
 
 - `ignorePatterns` (`string[]`) ... An array of regex pattern strings to ignore.
 
-### `ignorePatterns`
+### "ignorePatterns": ["foo"]
 
 <eslint-code-block :rules="{'vue/no-undef-directives': ['error', {ignorePatterns: ['foo']}]}">
 

From a5dad270dd19e8d41caaa2d191fe31e2b641d37c Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 20:55:56 +0800
Subject: [PATCH 06/14] Update tests/lib/rules/no-undef-directives.js

Co-authored-by: Flo Edelmann <git@flo-edelmann.de>
---
 tests/lib/rules/no-undef-directives.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/lib/rules/no-undef-directives.js b/tests/lib/rules/no-undef-directives.js
index 11bdd95d2..944ee27bf 100644
--- a/tests/lib/rules/no-undef-directives.js
+++ b/tests/lib/rules/no-undef-directives.js
@@ -225,6 +225,7 @@ tester.run('no-undef-directives', rule, {
       code: `
       <template>
         <div v-foo></div>
+        <div v-barfoobaz></div>
       </template>
       `,
       options: [{ ignorePatterns: ['foo'] }]

From 17c56ceb512d39d826871a658c91bc00e4794021 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 20:56:16 +0800
Subject: [PATCH 07/14] Update tests/lib/rules/no-undef-directives.js

Co-authored-by: Flo Edelmann <git@flo-edelmann.de>
---
 tests/lib/rules/no-undef-directives.js | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/tests/lib/rules/no-undef-directives.js b/tests/lib/rules/no-undef-directives.js
index 944ee27bf..6d468ce2a 100644
--- a/tests/lib/rules/no-undef-directives.js
+++ b/tests/lib/rules/no-undef-directives.js
@@ -229,6 +229,16 @@ tester.run('no-undef-directives', rule, {
       </template>
       `,
       options: [{ ignorePatterns: ['foo'] }]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-fooBar></div>
+        <div v-foo-bar></div>
+      </template>
+      `,
+      options: [{ ignorePatterns: ['foo-bar'] }]
     }
   ],
   invalid: [

From 0a2720e176825ee6bba995c459b4be9d744d5fd7 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 20:56:25 +0800
Subject: [PATCH 08/14] Update lib/rules/no-undef-directives.js

Co-authored-by: Flo Edelmann <git@flo-edelmann.de>
---
 lib/rules/no-undef-directives.js | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/lib/rules/no-undef-directives.js b/lib/rules/no-undef-directives.js
index 91bf0c26e..bfb8fe48b 100644
--- a/lib/rules/no-undef-directives.js
+++ b/lib/rules/no-undef-directives.js
@@ -54,12 +54,10 @@ class DefinedInSetupDirectives {
   }
 
   /**
-   * @param {string[]} names
+   * @param {string} name
    */
-  addName(...names) {
-    for (const name of names) {
-      this.names.add(name)
-    }
+  addName(name) {
+    this.names.add(name)
   }
 
   /**

From ead454609c14e68ea23ef61dae37a99e7e5fe4c0 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 20:56:49 +0800
Subject: [PATCH 09/14] Update lib/rules/no-undef-directives.js

Co-authored-by: Flo Edelmann <git@flo-edelmann.de>
---
 lib/rules/no-undef-directives.js | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/lib/rules/no-undef-directives.js b/lib/rules/no-undef-directives.js
index bfb8fe48b..f65b9a652 100644
--- a/lib/rules/no-undef-directives.js
+++ b/lib/rules/no-undef-directives.js
@@ -80,12 +80,10 @@ class DefinedInOptionDirectives {
   }
 
   /**
-   * @param {string[]} names
+   * @param {string} name
    */
-  addName(...names) {
-    for (const name of names) {
-      this.names.add(name)
-    }
+  addName(name) {
+    this.names.add(name)
   }
 
   /**

From b5fe00476ccc1710e2a5777d52e24d1d4693f09d Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 21:45:59 +0800
Subject: [PATCH 10/14] Apply suggestion from @FloEdelmann

Co-authored-by: Flo Edelmann <git@flo-edelmann.de>
---
 docs/rules/no-undef-directives.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
index c676ae2fc..4870c8de6 100644
--- a/docs/rules/no-undef-directives.md
+++ b/docs/rules/no-undef-directives.md
@@ -71,7 +71,7 @@ export default {
 
 - `ignorePatterns` (`string[]`) ... An array of regex pattern strings to ignore.
 
-### "ignorePatterns": ["foo"]
+### `"ignorePatterns": ["foo"]`
 
 <eslint-code-block :rules="{'vue/no-undef-directives': ['error', {ignorePatterns: ['foo']}]}">
 

From 5d4734d9594da166c7eb652abb52a08acb318c54 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 22:27:43 +0800
Subject: [PATCH 11/14] refactor: apply suggest

---
 docs/rules/no-undef-directives.md      |   8 +-
 lib/rules/no-undef-directives.js       | 213 ++++++++++---------------
 tests/lib/rules/no-undef-directives.js |  44 ++++-
 3 files changed, 132 insertions(+), 133 deletions(-)

diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
index 4870c8de6..eb8fa65ef 100644
--- a/docs/rules/no-undef-directives.md
+++ b/docs/rules/no-undef-directives.md
@@ -64,16 +64,16 @@ export default {
 ```json
 {
   "vue/no-undef-directives": ["error", {
-    "ignorePatterns": ["foo"]
+    "ignore": ["foo"]
   }]
 }
 ```
 
-- `ignorePatterns` (`string[]`) ... An array of regex pattern strings to ignore.
+- `ignore` (`string[]`) An array of tags or regular expression patterns (e.g. `"/^custom-/"`) that ignore these rules. This option will check both kebab-case and PascalCase versions of the given tag names. Default is empty.
 
-### `"ignorePatterns": ["foo"]`
+### `"ignore": ["foo"]`
 
-<eslint-code-block :rules="{'vue/no-undef-directives': ['error', {ignorePatterns: ['foo']}]}">
+<eslint-code-block :rules="{'vue/no-undef-directives': ['error', {ignore: ['foo']}]}">
 
 ```vue
 <template>
diff --git a/lib/rules/no-undef-directives.js b/lib/rules/no-undef-directives.js
index f65b9a652..9fc3a9fe4 100644
--- a/lib/rules/no-undef-directives.js
+++ b/lib/rules/no-undef-directives.js
@@ -6,6 +6,7 @@
 
 const utils = require('../utils')
 const casing = require('../utils/casing')
+const regexp = require('../utils/regexp')
 
 /**
  * @param {string} str
@@ -44,69 +45,37 @@ function getRegisteredDirectives(componentObject) {
     .filter((res) => !!res)
 }
 
-class DefinedInSetupDirectives {
-  constructor() {
-    /**
-     * Directive names
-     * @type {Set<string>}
-     */
-    this.names = new Set()
-  }
-
-  /**
-   * @param {string} name
-   */
-  addName(name) {
-    this.names.add(name)
-  }
-
-  /**
-   * @param {string} rawName
-   */
-  isDefinedDirective(rawName) {
-    const camelName = camelize(rawName)
-    const variableName = `v${casing.capitalize(camelName)}`
-    return this.names.has(variableName)
-  }
+/**
+ * @param {string} rawName
+ * @param {Set<string>} definedNames
+ */
+function isDefinedInSetup(rawName, definedNames) {
+  const camelName = camelize(rawName)
+  const variableName = `v${casing.capitalize(camelName)}`
+  return definedNames.has(variableName)
 }
 
-class DefinedInOptionDirectives {
-  constructor() {
-    /**
-     * Directive names
-     * @type {Set<string>}
-     */
-    this.names = new Set()
-  }
-
-  /**
-   * @param {string} name
-   */
-  addName(name) {
-    this.names.add(name)
+/**
+ * @param {string} rawName
+ * @param {Set<string>} definedNames
+ */
+function isDefinedInOptions(rawName, definedNames) {
+  const camelName = camelize(rawName)
+  if (definedNames.has(rawName) || definedNames.has(camelName)) {
+    return true
   }
 
-  /**
-   * @param {string} rawName
-   */
-  isDefinedDirective(rawName) {
-    const camelName = camelize(rawName)
-    if (this.names.has(rawName) || this.names.has(camelName)) {
+  // allow case-insensitive only when the directive name itself contains capitalized letters
+  for (const name of definedNames) {
+    if (
+      name.toLowerCase() === camelName.toLowerCase() &&
+      name !== name.toLowerCase()
+    ) {
       return true
     }
-
-    // allow case-insensitive ONLY when the directive name itself contains capitalized letters
-    for (const name of this.names) {
-      if (
-        name.toLowerCase() === camelName.toLowerCase() &&
-        name !== name.toLowerCase()
-      ) {
-        return true
-      }
-    }
-
-    return false
   }
+
+  return false
 }
 
 module.exports = {
@@ -122,11 +91,9 @@ module.exports = {
       {
         type: 'object',
         properties: {
-          ignorePatterns: {
+          ignore: {
             type: 'array',
-            items: {
-              type: 'string'
-            },
+            items: { type: 'string' },
             uniqueItems: true
           }
         },
@@ -140,8 +107,8 @@ module.exports = {
   /** @param {RuleContext} context */
   create(context) {
     const options = context.options[0] || {}
-    /** @type {string[]} */
-    const ignorePatterns = options.ignorePatterns || []
+    const { ignore = [] } = options
+    const isAnyIgnored = regexp.toRegExpGroupMatcher(ignore)
 
     /**
      * Check whether the given directive name is a verify target or not.
@@ -150,107 +117,101 @@ module.exports = {
      * @returns {boolean}
      */
     function isVerifyTargetDirective(rawName) {
-      if (utils.isBuiltInDirectiveName(rawName)) {
+      const kebabName = casing.kebabCase(rawName)
+      if (
+        utils.isBuiltInDirectiveName(rawName) ||
+        isAnyIgnored(rawName, kebabName)
+      ) {
         return false
       }
-
-      const ignored = ignorePatterns.some((pattern) =>
-        new RegExp(pattern).test(rawName)
-      )
-      return !ignored
+      return true
     }
 
-    /** @type { (rawName:string, reportNode: ASTNode) => void } */
-    let verifyName
-    /** @type {RuleListener} */
-    let scriptVisitor = {}
-    /** @type {TemplateListener} */
-    const templateBodyVisitor = {
-      /** @param {VDirective} node */
-      'VAttribute[directive=true]'(node) {
-        const name = node.key.name.name
-        if (utils.isBuiltInDirectiveName(name)) {
-          return
+    /**
+     * @param {(rawName: string) => boolean} isDefined
+     * @returns {TemplateListener}
+     */
+    function createTemplateBodyVisitor(isDefined) {
+      return {
+        /** @param {VDirective} node */
+        'VAttribute[directive=true]'(node) {
+          const name = node.key.name.name
+          if (utils.isBuiltInDirectiveName(name)) {
+            return
+          }
+          const rawName = node.key.name.rawName || name
+          if (isVerifyTargetDirective(rawName) && !isDefined(rawName)) {
+            context.report({
+              node: node.key,
+              messageId: 'undef',
+              data: {
+                name: rawName
+              }
+            })
+          }
         }
-        verifyName(node.key.name.rawName || name, node.key)
       }
     }
 
     if (utils.isScriptSetup(context)) {
       // For <script setup>
-      const definedInSetupDirectives = new DefinedInSetupDirectives()
-      const definedInOptionDirectives = new DefinedInOptionDirectives()
+      /** @type {Set<string>} */
+      const definedInSetupDirectives = new Set()
+      /** @type {Set<string>} */
+      const definedInOptionDirectives = new Set()
 
       const globalScope = context.sourceCode.scopeManager.globalScope
       if (globalScope) {
         for (const variable of globalScope.variables) {
-          definedInSetupDirectives.addName(variable.name)
+          definedInSetupDirectives.add(variable.name)
         }
         const moduleScope = globalScope.childScopes.find(
           (scope) => scope.type === 'module'
         )
         for (const variable of (moduleScope && moduleScope.variables) || []) {
-          definedInSetupDirectives.addName(variable.name)
+          definedInSetupDirectives.add(variable.name)
         }
       }
 
-      scriptVisitor = utils.defineVueVisitor(context, {
+      const scriptVisitor = utils.defineVueVisitor(context, {
         onVueObjectEnter(node) {
           for (const directive of getRegisteredDirectives(node)) {
-            definedInOptionDirectives.addName(directive.name)
+            definedInOptionDirectives.add(directive.name)
           }
         }
       })
 
-      verifyName = (rawName, reportNode) => {
-        if (
-          !isVerifyTargetDirective(rawName) ||
-          definedInSetupDirectives.isDefinedDirective(rawName) ||
-          definedInOptionDirectives.isDefinedDirective(rawName)
-        ) {
-          return
-        }
+      const templateBodyVisitor = createTemplateBodyVisitor(
+        (rawName) =>
+          isDefinedInSetup(rawName, definedInSetupDirectives) ||
+          isDefinedInOptions(rawName, definedInOptionDirectives)
+      )
 
-        context.report({
-          node: reportNode,
-          messageId: 'undef',
-          data: {
-            name: rawName
-          }
-        })
-      }
+      return utils.defineTemplateBodyVisitor(
+        context,
+        templateBodyVisitor,
+        scriptVisitor
+      )
     } else {
       // For Options API
-      const definedInOptionDirectives = new DefinedInOptionDirectives()
+      /** @type {Set<string>} */
+      const definedInOptionDirectives = new Set()
 
-      scriptVisitor = utils.executeOnVue(context, (obj) => {
+      const scriptVisitor = utils.executeOnVue(context, (obj) => {
         for (const directive of getRegisteredDirectives(obj)) {
-          definedInOptionDirectives.addName(directive.name)
+          definedInOptionDirectives.add(directive.name)
         }
       })
 
-      verifyName = (rawName, reportNode) => {
-        if (
-          !isVerifyTargetDirective(rawName) ||
-          definedInOptionDirectives.isDefinedDirective(rawName)
-        ) {
-          return
-        }
+      const templateBodyVisitor = createTemplateBodyVisitor((rawName) =>
+        isDefinedInOptions(rawName, definedInOptionDirectives)
+      )
 
-        context.report({
-          node: reportNode,
-          messageId: 'undef',
-          data: {
-            name: rawName
-          }
-        })
-      }
+      return utils.defineTemplateBodyVisitor(
+        context,
+        templateBodyVisitor,
+        scriptVisitor
+      )
     }
-
-    return utils.defineTemplateBodyVisitor(
-      context,
-      templateBodyVisitor,
-      scriptVisitor
-    )
   }
 }
diff --git a/tests/lib/rules/no-undef-directives.js b/tests/lib/rules/no-undef-directives.js
index 6d468ce2a..26b643ec6 100644
--- a/tests/lib/rules/no-undef-directives.js
+++ b/tests/lib/rules/no-undef-directives.js
@@ -228,7 +228,7 @@ tester.run('no-undef-directives', rule, {
         <div v-barfoobaz></div>
       </template>
       `,
-      options: [{ ignorePatterns: ['foo'] }]
+      options: [{ ignore: ['/foo/'] }]
     },
     {
       filename: 'test.vue',
@@ -238,7 +238,7 @@ tester.run('no-undef-directives', rule, {
         <div v-foo-bar></div>
       </template>
       `,
-      options: [{ ignorePatterns: ['foo-bar'] }]
+      options: [{ ignore: ['foo-bar'] }]
     }
   ],
   invalid: [
@@ -467,7 +467,7 @@ tester.run('no-undef-directives', rule, {
         <div v-foo-bar></div>
       </template>
       `,
-      options: [{ ignorePatterns: ['baz'] }],
+      options: [{ ignore: ['baz'] }],
       errors: [
         {
           message: "The 'v-foo-bar' directive has been used, but not defined.",
@@ -477,6 +477,44 @@ tester.run('no-undef-directives', rule, {
           endColumn: 23
         }
       ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-foo-bar></div>
+      </template>
+      `,
+      options: [{ ignore: ['/^bar/'] }],
+      errors: [
+        {
+          message: "The 'v-foo-bar' directive has been used, but not defined.",
+          line: 3,
+          column: 14,
+          endLine: 3,
+          endColumn: 23
+        }
+      ]
+    },
+    {
+      filename: 'test.vue',
+      code: `
+      <template>
+        <div v-foo></div>
+        <div v-barfoobaz></div>
+      </template>
+      `,
+      options: [{ ignore: ['foo'] }],
+      errors: [
+        {
+          message:
+            "The 'v-barfoobaz' directive has been used, but not defined.",
+          line: 4,
+          column: 14,
+          endLine: 4,
+          endColumn: 25
+        }
+      ]
     }
   ]
 })

From bdbb46cd5ebbc0ad79fb64626aced3190b9d1b10 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 22:34:53 +0800
Subject: [PATCH 12/14] docs: update

---
 docs/rules/no-undef-directives.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
index eb8fa65ef..ac11f33f0 100644
--- a/docs/rules/no-undef-directives.md
+++ b/docs/rules/no-undef-directives.md
@@ -69,7 +69,7 @@ export default {
 }
 ```
 
-- `ignore` (`string[]`) An array of tags or regular expression patterns (e.g. `"/^custom-/"`) that ignore these rules. This option will check both kebab-case and PascalCase versions of the given tag names. Default is empty.
+- `"ignore"` (`string[]`) An array of tags or regular expression patterns (e.g. `"/^custom-/"`) that ignore these rules. This option will check both kebab-case and PascalCase versions of the given tag names. Default is empty.
 
 ### `"ignore": ["foo"]`
 

From f589ad7468bd3aba1cf1150f4a2dcfe562ee8133 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Thu, 11 Dec 2025 22:41:02 +0800
Subject: [PATCH 13/14] docs: update

---
 docs/rules/no-undef-directives.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
index ac11f33f0..bfcf86c3e 100644
--- a/docs/rules/no-undef-directives.md
+++ b/docs/rules/no-undef-directives.md
@@ -77,6 +77,7 @@ export default {
 
 ```vue
 <template>
+  <!-- ✓ GOOD -->
   <div v-foo></div>
 </template>
 ```

From b3bef9971ed9416b898bf2f9fdc12ae885eabae8 Mon Sep 17 00:00:00 2001
From: rzzf <cszhjh@gmail.com>
Date: Fri, 12 Dec 2025 00:49:21 +0800
Subject: [PATCH 14/14] refactor: apply suggest

---
 docs/rules/no-undef-directives.md |  2 +-
 lib/rules/no-undef-directives.js  | 68 +++++++++++++------------------
 2 files changed, 30 insertions(+), 40 deletions(-)

diff --git a/docs/rules/no-undef-directives.md b/docs/rules/no-undef-directives.md
index bfcf86c3e..f71e791c6 100644
--- a/docs/rules/no-undef-directives.md
+++ b/docs/rules/no-undef-directives.md
@@ -69,7 +69,7 @@ export default {
 }
 ```
 
-- `"ignore"` (`string[]`) An array of tags or regular expression patterns (e.g. `"/^custom-/"`) that ignore these rules. This option will check both kebab-case and PascalCase versions of the given tag names. Default is empty.
+- `"ignore"` (`string[]`) An array of directive names or regular expression patterns (e.g. `"/^custom-/"`) that ignore these rules. This option will check both kebab-case and PascalCase versions of the given directive names. Default is empty.
 
 ### `"ignore": ["foo"]`
 
diff --git a/lib/rules/no-undef-directives.js b/lib/rules/no-undef-directives.js
index 9fc3a9fe4..ba7628fb1 100644
--- a/lib/rules/no-undef-directives.js
+++ b/lib/rules/no-undef-directives.js
@@ -8,14 +8,6 @@ const utils = require('../utils')
 const casing = require('../utils/casing')
 const regexp = require('../utils/regexp')
 
-/**
- * @param {string} str
- * @returns {string}
- */
-function camelize(str) {
-  return str.replace(/-(\w)/g, (_, c) => (c ? c.toUpperCase() : ''))
-}
-
 /**
  * @param {ObjectExpression} componentObject
  * @returns { { node: Property, name: string }[] } Array of ASTNodes
@@ -36,13 +28,12 @@ function getRegisteredDirectives(componentObject) {
     return []
   }
 
-  return directivesNode.value.properties
-    .filter((node) => node.type === 'Property')
-    .map((node) => {
-      const name = utils.getStaticPropertyName(node)
-      return name ? { node, name } : null
-    })
-    .filter((res) => !!res)
+  // @ts-ignore
+  return directivesNode.value.properties.flatMap((node) => {
+    const name =
+      node.type === 'Property' ? utils.getStaticPropertyName(node) : null
+    return name ? [{ node, name }] : []
+  })
 }
 
 /**
@@ -50,7 +41,7 @@ function getRegisteredDirectives(componentObject) {
  * @param {Set<string>} definedNames
  */
 function isDefinedInSetup(rawName, definedNames) {
-  const camelName = camelize(rawName)
+  const camelName = casing.camelCase(rawName)
   const variableName = `v${casing.capitalize(camelName)}`
   return definedNames.has(variableName)
 }
@@ -60,8 +51,9 @@ function isDefinedInSetup(rawName, definedNames) {
  * @param {Set<string>} definedNames
  */
 function isDefinedInOptions(rawName, definedNames) {
-  const camelName = camelize(rawName)
-  if (definedNames.has(rawName) || definedNames.has(camelName)) {
+  const camelName = casing.camelCase(rawName)
+
+  if (definedNames.has(rawName)) {
     return true
   }
 
@@ -153,12 +145,13 @@ module.exports = {
       }
     }
 
+    /** @type {Set<string>} */
+    const definedInOptionDirectives = new Set()
+
     if (utils.isScriptSetup(context)) {
       // For <script setup>
       /** @type {Set<string>} */
       const definedInSetupDirectives = new Set()
-      /** @type {Set<string>} */
-      const definedInOptionDirectives = new Set()
 
       const globalScope = context.sourceCode.scopeManager.globalScope
       if (globalScope) {
@@ -168,7 +161,7 @@ module.exports = {
         const moduleScope = globalScope.childScopes.find(
           (scope) => scope.type === 'module'
         )
-        for (const variable of (moduleScope && moduleScope.variables) || []) {
+        for (const variable of moduleScope?.variables ?? []) {
           definedInSetupDirectives.add(variable.name)
         }
       }
@@ -192,26 +185,23 @@ module.exports = {
         templateBodyVisitor,
         scriptVisitor
       )
-    } else {
-      // For Options API
-      /** @type {Set<string>} */
-      const definedInOptionDirectives = new Set()
+    }
 
-      const scriptVisitor = utils.executeOnVue(context, (obj) => {
-        for (const directive of getRegisteredDirectives(obj)) {
-          definedInOptionDirectives.add(directive.name)
-        }
-      })
+    // For Options API
+    const scriptVisitor = utils.executeOnVue(context, (obj) => {
+      for (const directive of getRegisteredDirectives(obj)) {
+        definedInOptionDirectives.add(directive.name)
+      }
+    })
 
-      const templateBodyVisitor = createTemplateBodyVisitor((rawName) =>
-        isDefinedInOptions(rawName, definedInOptionDirectives)
-      )
+    const templateBodyVisitor = createTemplateBodyVisitor((rawName) =>
+      isDefinedInOptions(rawName, definedInOptionDirectives)
+    )
 
-      return utils.defineTemplateBodyVisitor(
-        context,
-        templateBodyVisitor,
-        scriptVisitor
-      )
-    }
+    return utils.defineTemplateBodyVisitor(
+      context,
+      templateBodyVisitor,
+      scriptVisitor
+    )
   }
 }