Sync with ember-template-lint

Author: NullVoxPopuli

docs/rules/template-require-context-role.md

@@ -2,23 +2,9 @@
 
 <!-- end auto-generated rule header -->
 
-Requires certain ARIA roles to be used in appropriate context.
-
-Some ARIA roles must be contained within specific parent roles to be meaningful and accessible. For example, a `role="listitem"` must be inside an element with `role="list"`.
-
-## Rule Details
-
-This rule checks that context-dependent ARIA roles are used within the appropriate parent roles.
-
-Roles requiring context:
+## `<* role><* role /></*>`
 
-- `listitem` → must be in `list`
-- `option` → must be in `listbox`
-- `tab` → must be in `tablist`
-- `menuitem`, `menuitemcheckbox`, `menuitemradio` → must be in `menu` or `menubar`
-- `treeitem` → must be in `tree`
-- `row` → must be in `table`, `grid`, `treegrid`, or `rowgroup`
-- And more...
+The required context role defines the owning container where this role is allowed. If a role has a required context, authors MUST ensure that an element with the role is contained inside (or owned by) an element with the required context role. For example, an element with `role="listitem"` is only meaningful when contained inside (or owned by) an element with `role="list"`. You may place intermediate elements with `role="presentation"` or `role="none"` to remove their semantic meaning.
 
 ## Roles to check
 
@@ -37,65 +23,60 @@ Format: role | required context role
 - tab | tablist
 - treeitem | group or tree
 
-## `<* role><* role /></*>`
-
-The required context role defines the owning container where this role is allowed. If a role has a required context, authors MUST ensure that an element with the role is contained inside (or owned by) an element with the required context role. For example, an element with `role="listitem"` is only meaningful when contained inside (or owned by) an element with `role="list"`. You may place intermediate elements with `role="presentation"` or `role="none"` to remove their semantic meaning.
-
 ## Examples
 
-Examples of **incorrect** code for this rule:
+This rule **allows** the following:
 
-```gjs
-<template>
-  <div>
-    <span role="listitem">Item</span>
-  </div>
-</template>
+```hbs
+<div role='list'>
+  <div role='listitem'>Item One</div>
+  <div role='listitem'>Item Two</div>
+</div>
 ```
 
-```gjs
-<template>
-  <div>
-    <span role="tab">Tab 1</span>
+```hbs
+<div role='menu'>
+  <div role='presentation'>
+    <a role='menuitem'>Item One</a>
   </div>
-</template>
-```
-
-```gjs
-<template>
-  <div>
-    <span role="menuitem">Item</span>
+  <div role='presentation'>
+    <a role='menuitem'>Item Two</a>
   </div>
-</template>
+</div>
 ```
 
-Examples of **correct** code for this rule:
+This rule **forbids** the following:
 
-```gjs
-<template>
-  <ul role="list">
-    <li role="listitem">Item</li>
-  </ul>
-</template>
+```hbs
+<div>
+  <div role='listitem'>Item One</div>
+  <div role='listitem'>Item Two</div>
+</div>
 ```
 
-```gjs
-<template>
-  <div role="tablist">
-    <div role="tab">Tab 1</div>
+```hbs
+<div role='menu'>
+  <div role='button'>
+    <a role='menuitem'>Item One</a>
   </div>
-</template>
-```
-
-```gjs
-<template>
-  <div role="menu">
-    <div role="menuitem">Item</div>
+  <div>
+    <a role='menuitem'>Item Two</a>
   </div>
-</template>
+</div>
 ```
 
-## References
-
-- [eslint-plugin-ember template-require-context-role](https://github.com/ember-cli/eslint-plugin-ember/blob/master/docs/rules/template-require-context-role.md)
-- [WAI-ARIA - Required Context Roles](https://www.w3.org/TR/wai-aria-1.2/#scope)
+### References
+
+1. <https://www.w3.org/TR/wai-aria-1.1/#scope>
+1. <https://www.w3.org/TR/wai-aria-1.1/#columnheader>
+1. <https://www.w3.org/TR/wai-aria-1.1/#gridcell>
+1. <https://www.w3.org/TR/wai-aria-1.1/#listitem>
+1. <https://www.w3.org/TR/wai-aria-1.1/#menuitem>
+1. <https://www.w3.org/TR/wai-aria-1.1/#menuitemcheckbox>
+1. <https://www.w3.org/TR/wai-aria-1.1/#menuitemradio>
+1. <https://www.w3.org/TR/wai-aria-1.1/#option>
+1. <https://www.w3.org/TR/wai-aria-1.1/#row>
+1. <https://www.w3.org/TR/wai-aria-1.1/#rowgroup>
+1. <https://www.w3.org/TR/wai-aria-1.1/#rowheader>
+1. <https://www.w3.org/TR/wai-aria-1.1/#tab>
+1. <https://www.w3.org/TR/wai-aria-1.1/#treeitem>

tests/lib/rules/template-require-context-role.js

@@ -195,8 +195,7 @@ ruleTester.run('template-require-context-role', rule, {
       output: null,
       errors: [
         {
-          message:
-            'Role "option" must be contained in an element with one of these roles: listbox',
+          message: 'Role "option" must be contained in an element with one of these roles: listbox',
         },
       ],
     },
@@ -225,7 +224,8 @@ ruleTester.run('template-require-context-role', rule, {
       output: null,
       errors: [
         {
-          message: 'Role "rowheader" must be contained in an element with one of these roles: grid, row',
+          message:
+            'Role "rowheader" must be contained in an element with one of these roles: grid, row',
         },
       ],
     },
@@ -402,8 +402,7 @@ hbsRuleTester.run('template-require-context-role', rule, {
       output: null,
       errors: [
         {
-          message:
-            'Role "option" must be contained in an element with one of these roles: listbox',
+          message: 'Role "option" must be contained in an element with one of these roles: listbox',
         },
       ],
     },
@@ -432,7 +431,8 @@ hbsRuleTester.run('template-require-context-role', rule, {
       output: null,
       errors: [
         {
-          message: 'Role "rowheader" must be contained in an element with one of these roles: grid, row',
+          message:
+            'Role "rowheader" must be contained in an element with one of these roles: grid, row',
         },
       ],
     },