refactor: align component check with ember-cli#2724 canonical (lists + scope)

Replace the inline PascalCase-regex isComponentInvocation heuristic with
the lists + scope pattern established by @NullVoxPopuli in ember-cli#2689 and
canonicalised by ember-cli#2724. The new lib/utils/is-native-element.js mirrors
ember-cli#2724's util byte-for-byte so the two PRs can land in either order
without conflict — whichever lands first introduces the file; the other
rebases to a no-op on it.

Heuristic approaches (PascalCase regex, `tag.includes('.')`, etc.) were
explicitly rejected in ember-cli#2689 because lowercase tags CAN be components in
GJS/GTS when the name is shadowed by a scope binding
(`const div = MyComponent; <div />`). Scope analysis catches this;
regex heuristics don't.

Call site now uses `!isNativeElement(node, sourceCode)` directly to
match the canonical usage pattern in ember-cli#2724's migrated rules.

Author: johanrd

lib/rules/template-no-noninteractive-tabindex.js

@@ -1,5 +1,5 @@
 const { dom, roles } = require('aria-query');
-const { isComponentInvocation } = require('../utils/is-component-invocation');
+const { isNativeElement } = require('../utils/is-native-element');
 const { isNativeInteractive } = require('../utils/native-interactive-elements');
 
 // Interactive ARIA roles (widget/command/composite/input/range subtypes) —
@@ -100,18 +100,20 @@ module.exports = {
   },
 
   create(context) {
+    const sourceCode = context.sourceCode || context.getSourceCode();
     return {
       GlimmerElementNode(node) {
         const tabindex = findAttr(node, 'tabindex');
         if (!tabindex) {
           return;
         }
 
-        // Skip component invocations (PascalCase, named-arg, this-path,
-        // dot-path, named-block). Fixes the <Article tabindex={{0}}> FP where
-        // a PascalCase component name collided with a native tag after
+        // Only native HTML / SVG / MathML elements are in scope. Authoritative
+        // tag lists (html-tags + svg-tags + mathml-tag-names) plus scope-
+        // shadowing detection. Fixes the <Article tabindex={{0}}> FP where a
+        // PascalCase component name collided with a native tag after
         // lowercasing.
-        if (isComponentInvocation(node)) {
+        if (!isNativeElement(node, sourceCode)) {
           return;
         }
 

lib/utils/is-component-invocation.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const htmlTags = require('html-tags');
+const svgTags = require('svg-tags');
+const { mathmlTagNames } = require('mathml-tag-names');
+
+// Authoritative set of native element tag names. Mirrors the approach
+// established by #2689 (template-no-block-params-for-html-elements), which
+// the maintainer requires for component-vs-element discrimination in this
+// plugin. Heuristic approaches (PascalCase detection, etc.) were explicitly
+// rejected there because a lowercase tag CAN be a component in GJS/GTS when
+// the name is bound in scope (e.g. `const div = MyComponent; <div />`).
+const ELEMENT_TAGS = new Set([...htmlTags, ...svgTags, ...mathmlTagNames]);
+
+/**
+ * Returns true if the Glimmer element node is a native HTML / SVG / MathML
+ * element — i.e. the tag name is in the authoritative list AND is not
+ * shadowed by an in-scope binding.
+ *
+ * Returns false for:
+ *  - components (PascalCase, dotted, @-prefixed, this.-prefixed, ::-namespaced —
+ *    none of these tag names appear in the HTML/SVG/MathML lists)
+ *  - custom elements (`<my-widget>`) — accepted false negative; the web-
+ *    components namespace is open and can't be enumerated
+ *  - scope-bound identifiers (`<div>` when `div` is a local `let` / `const` /
+ *    import / block-param in the enclosing scope)
+ *
+ * @param {object} node - GlimmerElementNode
+ * @param {object} [sourceCode] - ESLint SourceCode, for scope lookup. When
+ *   omitted, the scope check is skipped (the result is then list-based only —
+ *   suitable for unit tests).
+ */
+function isNativeElement(node, sourceCode) {
+  if (!node || typeof node.tag !== 'string') {
+    return false;
+  }
+  if (!ELEMENT_TAGS.has(node.tag)) {
+    return false;
+  }
+  if (!sourceCode || !node.parent) {
+    return true;
+  }
+  const scope = sourceCode.getScope(node.parent);
+  const firstPart = node.parts && node.parts[0];
+  if (firstPart && scope.references.some((ref) => ref.identifier === firstPart)) {
+    return false;
+  }
+  return true;
+}
+
+/**
+ * Inverse of {@link isNativeElement}. Returns true when the node should NOT
+ * be treated as a native HTML element — either because it's a component
+ * invocation (PascalCase, dotted, @-prefixed, this.-prefixed, custom element)
+ * OR a tag name that's shadowed by a scope binding.
+ */
+function isComponentInvocation(node, sourceCode) {
+  return !isNativeElement(node, sourceCode);
+}
+
+module.exports = { isNativeElement, isComponentInvocation, ELEMENT_TAGS };

lib/utils/is-native-element.js

@@ -0,0 +1,91 @@
+'use strict';
+
+const { isNativeElement, ELEMENT_TAGS } = require('../../../lib/utils/is-native-element');
+
+// Tests exercise the list-lookup path only. Scope-based shadowing is covered
+// by the rule-level test suites (see tests/lib/rules/template-no-block-params-
+// for-html-elements.js and siblings) because it requires a real ESLint
+// SourceCode / scope manager that's only built up by the rule tester.
+
+describe('isNativeElement — list-only behavior (no sourceCode)', () => {
+  it('returns true for lowercase HTML tag names', () => {
+    expect(isNativeElement({ tag: 'div' })).toBe(true);
+    expect(isNativeElement({ tag: 'article' })).toBe(true);
+    expect(isNativeElement({ tag: 'h1' })).toBe(true);
+    expect(isNativeElement({ tag: 'button' })).toBe(true);
+    expect(isNativeElement({ tag: 'form' })).toBe(true);
+    expect(isNativeElement({ tag: 'section' })).toBe(true);
+  });
+
+  it('returns true for SVG tag names', () => {
+    expect(isNativeElement({ tag: 'svg' })).toBe(true);
+    expect(isNativeElement({ tag: 'circle' })).toBe(true);
+    expect(isNativeElement({ tag: 'path' })).toBe(true);
+  });
+
+  it('returns true for MathML tag names', () => {
+    expect(isNativeElement({ tag: 'mfrac' })).toBe(true);
+    expect(isNativeElement({ tag: 'math' })).toBe(true);
+  });
+
+  it('returns false for PascalCase component tags', () => {
+    expect(isNativeElement({ tag: 'Button' })).toBe(false);
+    expect(isNativeElement({ tag: 'MyWidget' })).toBe(false);
+    // Native-tag names in PascalCase — the core bug case.
+    expect(isNativeElement({ tag: 'Article' })).toBe(false);
+    expect(isNativeElement({ tag: 'Form' })).toBe(false);
+    expect(isNativeElement({ tag: 'Main' })).toBe(false);
+    expect(isNativeElement({ tag: 'Nav' })).toBe(false);
+    expect(isNativeElement({ tag: 'Section' })).toBe(false);
+    expect(isNativeElement({ tag: 'Table' })).toBe(false);
+  });
+
+  it('returns false for named-arg invocations', () => {
+    expect(isNativeElement({ tag: '@heading' })).toBe(false);
+    expect(isNativeElement({ tag: '@tag.foo' })).toBe(false);
+  });
+
+  it('returns false for this-path invocations', () => {
+    expect(isNativeElement({ tag: 'this.myComponent' })).toBe(false);
+    expect(isNativeElement({ tag: 'this.comp.sub' })).toBe(false);
+  });
+
+  it('returns false for dot-path invocations', () => {
+    expect(isNativeElement({ tag: 'foo.bar' })).toBe(false);
+    expect(isNativeElement({ tag: 'ns.widget' })).toBe(false);
+  });
+
+  it('returns false for named-block / namespaced invocations', () => {
+    expect(isNativeElement({ tag: 'foo::bar' })).toBe(false);
+    expect(isNativeElement({ tag: 'Foo::Bar' })).toBe(false);
+  });
+
+  it('returns false for custom elements (accepted false negative)', () => {
+    // Custom elements aren't in the html-tags/svg-tags/mathml-tag-names
+    // allowlists. They're treated as "not a native element" so downstream
+    // rules skip them — matches the convention established in PR #2689.
+    expect(isNativeElement({ tag: 'my-element' })).toBe(false);
+    expect(isNativeElement({ tag: 'x-foo' })).toBe(false);
+  });
+
+  it('returns false for empty / missing / non-string tag', () => {
+    expect(isNativeElement({ tag: '' })).toBe(false);
+    expect(isNativeElement({ tag: undefined })).toBe(false);
+    expect(isNativeElement({ tag: null })).toBe(false);
+    expect(isNativeElement({ tag: 123 })).toBe(false);
+    expect(isNativeElement({})).toBe(false);
+    expect(isNativeElement()).toBe(false);
+    expect(isNativeElement(null)).toBe(false);
+  });
+});
+
+describe('ELEMENT_TAGS', () => {
+  it('includes all HTML, SVG, and MathML tag names', () => {
+    // Sanity check — if this ever drops below a reasonable size, one of the
+    // underlying packages has changed contract.
+    expect(ELEMENT_TAGS.size).toBeGreaterThan(200);
+    expect(ELEMENT_TAGS.has('div')).toBe(true);
+    expect(ELEMENT_TAGS.has('circle')).toBe(true);
+    expect(ELEMENT_TAGS.has('mfrac')).toBe(true);
+  });
+});