From 90d0bd058d9f043b71bff42fe5fc38b5811962c4 Mon Sep 17 00:00:00 2001
From: NullVoxPopuli <199018+NullVoxPopuli@users.noreply.github.com>
Date: Tue, 17 Feb 2026 15:45:36 -0500
Subject: [PATCH] Extract rule: template-link-href-attributes

---
 README.md                                     |  6 ++
 docs/rules/template-link-href-attributes.md   | 59 +++++++++++++++++++
 lib/rules/template-link-href-attributes.js    | 38 ++++++++++++
 .../rules/template-link-href-attributes.js    | 33 +++++++++++
 4 files changed, 136 insertions(+)
 create mode 100644 docs/rules/template-link-href-attributes.md
 create mode 100644 lib/rules/template-link-href-attributes.js
 create mode 100644 tests/lib/rules/template-link-href-attributes.js

diff --git a/README.md b/README.md
index 1997fcd7ea..99e9bed2f3 100644
--- a/README.md
+++ b/README.md
@@ -174,6 +174,12 @@ rules in templates can be disabled with eslint directives with mustache or html
 🔧 Automatically fixable by the [`--fix` CLI option](https://eslint.org/docs/user-guide/command-line-interface#--fix).\
 💡 Manually fixable by [editor suggestions](https://eslint.org/docs/latest/use/core-concepts#rule-suggestions).
 
+### Accessibility
+
+| Name                                                                         | Description                             | 💼 | 🔧 | 💡 |
+| :--------------------------------------------------------------------------- | :-------------------------------------- | :- | :- | :- |
+| [template-link-href-attributes](docs/rules/template-link-href-attributes.md) | require href attribute on link elements |    |    |    |
+
 ### Best Practices
 
 | Name                                                       | Description                        | 💼 | 🔧 | 💡 |
diff --git a/docs/rules/template-link-href-attributes.md b/docs/rules/template-link-href-attributes.md
new file mode 100644
index 0000000000..f681172039
--- /dev/null
+++ b/docs/rules/template-link-href-attributes.md
@@ -0,0 +1,59 @@
+# ember/template-link-href-attributes
+
+<!-- end auto-generated rule header -->
+
+Requires `href` attribute on `<a>` elements.
+
+Anchor elements should have an `href` attribute to be properly recognized as links by browsers and assistive technologies. If an element is meant to be interactive but not navigate, use a `<button>` instead.
+
+## Rule Details
+
+This rule ensures that all `<a>` elements have an `href` attribute.
+
+## Examples
+
+Examples of **incorrect** code for this rule:
+
+```gjs
+<template>
+  <a>Link</a>
+</template>
+```
+
+```gjs
+<template>
+  <a onclick={{this.handleClick}}>Click me</a>
+</template>
+```
+
+```gjs
+<template>
+  <a role="button">Action</a>
+</template>
+```
+
+Examples of **correct** code for this rule:
+
+```gjs
+<template>
+  <a href="/about">About Us</a>
+</template>
+```
+
+```gjs
+<template>
+  <a href="https://example.com">External Link</a>
+</template>
+```
+
+```gjs
+<template>
+  <button {{on "click" this.handleClick}}>Click me</button>
+</template>
+```
+
+## References
+
+- [MDN: The Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a)
+- [WebAIM: Links and Hypertext](https://webaim.org/techniques/hypertext/)
+- [ember-template-lint link-href-attributes](https://github.com/ember-template-lint/ember-template-lint/blob/master/docs/rule/link-href-attributes.md)
diff --git a/lib/rules/template-link-href-attributes.js b/lib/rules/template-link-href-attributes.js
new file mode 100644
index 0000000000..d42d111452
--- /dev/null
+++ b/lib/rules/template-link-href-attributes.js
@@ -0,0 +1,38 @@
+/** @type {import('eslint').Rule.RuleModule} */
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'require href attribute on link elements',
+      category: 'Accessibility',
+      strictGjs: true,
+      strictGts: true,
+      url: 'https://github.com/ember-cli/eslint-plugin-ember/tree/master/docs/rules/template-link-href-attributes.md',
+    },
+    fixable: null,
+    schema: [],
+    messages: {
+      missingHref:
+        '<a> elements must have an href attribute. Use <button> for clickable elements that are not links.',
+    },
+  },
+
+  create(context) {
+    return {
+      GlimmerElementNode(node) {
+        if (node.tag !== 'a') {
+          return;
+        }
+
+        const hasHref = node.attributes?.some((attr) => attr.name === 'href');
+
+        if (!hasHref) {
+          context.report({
+            node,
+            messageId: 'missingHref',
+          });
+        }
+      },
+    };
+  },
+};
diff --git a/tests/lib/rules/template-link-href-attributes.js b/tests/lib/rules/template-link-href-attributes.js
new file mode 100644
index 0000000000..3a064302b7
--- /dev/null
+++ b/tests/lib/rules/template-link-href-attributes.js
@@ -0,0 +1,33 @@
+const rule = require('../../../lib/rules/template-link-href-attributes');
+const RuleTester = require('eslint').RuleTester;
+
+const ruleTester = new RuleTester({
+  parser: require.resolve('ember-eslint-parser'),
+  parserOptions: { ecmaVersion: 2022, sourceType: 'module' },
+});
+
+ruleTester.run('template-link-href-attributes', rule, {
+  valid: [
+    '<template><a href="/about">About</a></template>',
+    '<template><a href="https://example.com">External</a></template>',
+    '<template><button>Click me</button></template>',
+  ],
+
+  invalid: [
+    {
+      code: '<template><a>Link</a></template>',
+      output: null,
+      errors: [{ messageId: 'missingHref' }],
+    },
+    {
+      code: '<template><a onclick="doSomething()">Click</a></template>',
+      output: null,
+      errors: [{ messageId: 'missingHref' }],
+    },
+    {
+      code: '<template><a role="button">Action</a></template>',
+      output: null,
+      errors: [{ messageId: 'missingHref' }],
+    },
+  ],
+});