From 742746a4ff2d6a9699e947fdeebc361e6e590d01 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@users.noreply.github.com>
Date: Tue, 8 Oct 2024 13:42:58 -0400
Subject: [PATCH 1/2] Clarifications for HTML's autocomplete and
 aria-autocomplete

---
 html-aam/index.html | 50 ++++++++++++++++++++++++++++-----------------
 1 file changed, 31 insertions(+), 19 deletions(-)

diff --git a/html-aam/index.html b/html-aam/index.html
index ca3f951e6..0f1922e5f 100644
--- a/html-aam/index.html
+++ b/html-aam/index.html
@@ -8538,8 +8538,7 @@ <h4 id="att-autocomplete-form">`autocomplete`</h4>
             <tr>
               <th>[[WAI-ARIA-1.2]]</th>
               <td>
-                <p><a class="core-mapping" href="#ariaAutocompleteInlineListBoth">`aria-autocomplete`</a></p>
-                <div class="note"><strong>Note:</strong> the ARIA attribute and the HTML attribute have disparate features.</div>
+                <div class="general">Not mapped</div>
               </td>
             </tr>
             <tr>
@@ -8547,10 +8546,7 @@ <h4 id="att-autocomplete-form">`autocomplete`</h4>
                 <a href="https://msdn.microsoft.com/en-us/library/dd373608%28v=VS.85%29.aspx">MSAA</a> + <a href="http://accessibility.linuxfoundation.org/a11yspecs/ia2/docs/html/">IAccessible2</a>
               </th>
               <td>
-                <div class="states">
-                  <span class="type">States:</span>
-                  `STATE_SUPPORTS_AUTOCOMPLETION` on text form controls until the value is overridden by control
-                </div>
+                <div class="general">Not mapped</div>
               </td>
             </tr>
             <tr>
@@ -8562,10 +8558,7 @@ <h4 id="att-autocomplete-form">`autocomplete`</h4>
             <tr>
               <th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
               <td>
-                <div class="states">
-                  <span class="type">States:</span>
-                  `ATK_STATE_SUPPORTS_AUTOCOMPLETION` on text form controls until the value is overridden by control
-                </div>
+                <div class="general">Not mapped</div>
               </td>
             </tr>
             <tr>
@@ -8577,8 +8570,16 @@ <h4 id="att-autocomplete-form">`autocomplete`</h4>
             <tr>
               <th>Comments</th>
               <td>
-                If the element includes both `autocomplete` and `aria-autocomplete` attributes with valid values, User Agents MUST expose only the `autocomplete` attribute value. The
-                `aria-autocomplete` attribute is not valid on a `form` element.
+                <p class="note">
+                  <strong>Note:</strong> the `aria-autocomplete` attribute and the HTML `autocomplete` attribute have disparate features.
+                  The `aria-autocomplete` attribute is not supported on the HTML `form` element or elements with an explicit ARIA `form` role.
+                </p>
+                <p class="note">
+                  When used on a `form` element, the `autocomplete` attribute identifies whether form controls owned by the form
+                  will have their <a data-cite="html/form-control-infrastructure.html#autofill-field-name">autofill field name</a> 
+                  set to "`on`" or "`off`" by default. See <a href="#att-autocomplete">`autocomplete` for `input`, `select`, `textarea`</a> for 
+                  control mappings.  
+                </p>
               </td>
             </tr>
           </tbody>
@@ -8599,8 +8600,14 @@ <h4 id="att-autocomplete">`autocomplete`</h4>
             <tr>
               <th>[[WAI-ARIA-1.2]]</th>
               <td>
-                <p><a class="core-mapping" href="#ariaAutocompleteInlineListBoth">`aria-autocomplete`</a></p>
-                <div class="note"><strong>Note:</strong> the ARIA attribute and the HTML attribute have disparate features.</div>
+                <div class="general">
+                  <p>If specivied `autocomplete=off` or the control is owned by a `form` with `autocomplete=off` - <a class="core-mapping" href="#ariaAutocompleteNone">`aria-autocomplete=none`</a></p>
+                  <p>Otherwise, <a class="core-mapping" href="#ariaAutocompleteInlineListBoth">`aria-autocomplete`</a></p>
+                </div>
+                <div class="note">
+                  <p><strong>Note:</strong> the `aria-autocomplete` attribute and the HTML `autocomplete` attribute have disparate features, but they overlap 
+                  as mechanisms for user agents to expose the control's support for autocompletion.</p>
+                </div>
               </td>
             </tr>
             <tr>
@@ -8608,30 +8615,35 @@ <h4 id="att-autocomplete">`autocomplete`</h4>
                 <a href="https://msdn.microsoft.com/en-us/library/dd373608%28v=VS.85%29.aspx">MSAA</a> + <a href="http://accessibility.linuxfoundation.org/a11yspecs/ia2/docs/html/">IAccessible2</a>
               </th>
               <td>
-                <div class="states"><span class="type">States:</span> `STATE_SUPPORTS_AUTOCOMPLETION`</div>
+                <div class="general">Use WAI-ARIA mapping</div>
               </td>
             </tr>
             <tr>
               <th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
               <td>
-                <div class="general">Not mapped</div>
+                <div class="general">Use WAI-ARIA mapping</div>
               </td>
             </tr>
             <tr>
               <th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
               <td>
-                <div class="states"><span class="type">States:</span> `ATK_STATE_SUPPORTS_AUTOCOMPLETION`</div>
+                <div class="general">Use WAI-ARIA mapping</div>
               </td>
             </tr>
             <tr>
               <th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
               <td>
-                <div class="general">Not mapped</div>
+                <div class="general">Use WAI-ARIA mapping</div>
               </td>
             </tr>
             <tr>
               <th>Comments</th>
-              <td>If the element includes both `autocomplete` and `aria-autocomplete` attributes with valid values, User Agents MUST expose only the `autocomplete` attribute value.</td>
+              <td>
+                <p>
+                  If the form control has been specified as both `autocomplete=off` (whether due to explicit use of the attribute, or from inheriting the `off` state from a parent `form` element with `autocomplete=off`) and with an `aria-autocomplete` attribute with a valid value, user agents MUST expose only the `aria-autocomplete` attribute value.
+                </p>
+                <p>Otherwise, if the form control has an `autocomplete` attribute specified with a valid token value, and an `aria-autocomplete` attribute, then user agents MUST expose only the `autocomplete` attribute value.</p>
+              </td>
             </tr>
           </tbody>
         </table>

From aa8f5f3b855ca9c04f6746f64c9b19e59e1beeb3 Mon Sep 17 00:00:00 2001
From: scottaohara <scottaohara@users.noreply.github.com>
Date: Tue, 8 Oct 2024 17:48:18 +0000
Subject: [PATCH 2/2] chore: prettier

---
 html-aam/index.html | 25 +++++++++++++++----------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/html-aam/index.html b/html-aam/index.html
index 0f1922e5f..1a386e44a 100644
--- a/html-aam/index.html
+++ b/html-aam/index.html
@@ -8571,14 +8571,13 @@ <h4 id="att-autocomplete-form">`autocomplete`</h4>
               <th>Comments</th>
               <td>
                 <p class="note">
-                  <strong>Note:</strong> the `aria-autocomplete` attribute and the HTML `autocomplete` attribute have disparate features.
-                  The `aria-autocomplete` attribute is not supported on the HTML `form` element or elements with an explicit ARIA `form` role.
+                  <strong>Note:</strong> the `aria-autocomplete` attribute and the HTML `autocomplete` attribute have disparate features. The `aria-autocomplete` attribute is not supported on the HTML
+                  `form` element or elements with an explicit ARIA `form` role.
                 </p>
                 <p class="note">
-                  When used on a `form` element, the `autocomplete` attribute identifies whether form controls owned by the form
-                  will have their <a data-cite="html/form-control-infrastructure.html#autofill-field-name">autofill field name</a> 
-                  set to "`on`" or "`off`" by default. See <a href="#att-autocomplete">`autocomplete` for `input`, `select`, `textarea`</a> for 
-                  control mappings.  
+                  When used on a `form` element, the `autocomplete` attribute identifies whether form controls owned by the form will have their
+                  <a data-cite="html/form-control-infrastructure.html#autofill-field-name">autofill field name</a> set to "`on`" or "`off`" by default. See
+                  <a href="#att-autocomplete">`autocomplete` for `input`, `select`, `textarea`</a> for control mappings.
                 </p>
               </td>
             </tr>
@@ -8605,8 +8604,10 @@ <h4 id="att-autocomplete">`autocomplete`</h4>
                   <p>Otherwise, <a class="core-mapping" href="#ariaAutocompleteInlineListBoth">`aria-autocomplete`</a></p>
                 </div>
                 <div class="note">
-                  <p><strong>Note:</strong> the `aria-autocomplete` attribute and the HTML `autocomplete` attribute have disparate features, but they overlap 
-                  as mechanisms for user agents to expose the control's support for autocompletion.</p>
+                  <p>
+                    <strong>Note:</strong> the `aria-autocomplete` attribute and the HTML `autocomplete` attribute have disparate features, but they overlap as mechanisms for user agents to expose the
+                    control's support for autocompletion.
+                  </p>
                 </div>
               </td>
             </tr>
@@ -8640,9 +8641,13 @@ <h4 id="att-autocomplete">`autocomplete`</h4>
               <th>Comments</th>
               <td>
                 <p>
-                  If the form control has been specified as both `autocomplete=off` (whether due to explicit use of the attribute, or from inheriting the `off` state from a parent `form` element with `autocomplete=off`) and with an `aria-autocomplete` attribute with a valid value, user agents MUST expose only the `aria-autocomplete` attribute value.
+                  If the form control has been specified as both `autocomplete=off` (whether due to explicit use of the attribute, or from inheriting the `off` state from a parent `form` element with
+                  `autocomplete=off`) and with an `aria-autocomplete` attribute with a valid value, user agents MUST expose only the `aria-autocomplete` attribute value.
+                </p>
+                <p>
+                  Otherwise, if the form control has an `autocomplete` attribute specified with a valid token value, and an `aria-autocomplete` attribute, then user agents MUST expose only the
+                  `autocomplete` attribute value.
                 </p>
-                <p>Otherwise, if the form control has an `autocomplete` attribute specified with a valid token value, and an `aria-autocomplete` attribute, then user agents MUST expose only the `autocomplete` attribute value.</p>
               </td>
             </tr>
           </tbody>