add explanatory comments

Author: JoCa96

lib/rules/no-shadow-native-events.js

@@ -60,8 +60,6 @@ module.exports = {
       categories: undefined,
       url: 'https://eslint.vuejs.org/rules/no-shadow-native-events.html'
     },
-    fixable: null,
-    hasSuggestions: false,
     schema: [],
     messages: {
       violation:
@@ -73,7 +71,10 @@ module.exports = {
     /** @type {Map<ObjectExpression | Program, { contextReferenceIds: Set<Identifier>, emitReferenceIds: Set<Identifier> }>} */
     const setupContexts = new Map()
 
-    /** @type {Set<string>} */
+    /**
+     * Tracks violating emit definitions, so that calls of this emit are not reported additionally.
+     * @type {Set<string>}
+     *  */
     const definedAndReportedEmits = new Set()
 
     /**
@@ -95,6 +96,7 @@ module.exports = {
     }
 
     /**
+     * Verify if an emit call violates the rule of not using a native dom event name.
      * @param {NameWithLoc} nameWithLoc
      */
     function verifyEmit(nameWithLoc) {
@@ -111,6 +113,25 @@ module.exports = {
       })
     }
 
+    /**
+     * Verify if an emit declaration violates the rule of not using a native dom event name.
+     * @param {ComponentEmit[]} emits
+     */
+    const verifyEmitDeclaration = (emits) => {
+      for (const { node, emitName } of emits) {
+        if (!node || !emitName || !domEvents.includes(emitName.toLowerCase())) {
+          continue
+        }
+
+        definedAndReportedEmits.add(emitName)
+        context.report({
+          messageId: 'violation',
+          data: { name: emitName },
+          loc: node.loc
+        })
+      }
+    }
+
     const callVisitor = {
       /**
        * @param {CallExpression} node
@@ -162,23 +183,6 @@ module.exports = {
         }
       }
     }
-    /**
-     * @param {ComponentEmit[]} emits
-     */
-    const verifyEmitDeclaration = (emits) => {
-      for (const { node, emitName } of emits) {
-        if (!node || !emitName || !domEvents.includes(emitName.toLowerCase())) {
-          continue
-        }
-
-        definedAndReportedEmits.add(emitName)
-        context.report({
-          messageId: 'violation',
-          data: { name: emitName },
-          loc: node.loc
-        })
-      }
-    }
 
     return utils.compositingVisitors(
       utils.defineTemplateBodyVisitor(