Add a new attribute called writingsuggestions to control UA-provided writing assistance

source

@@ -11710,6 +11710,7 @@ interface <dfn interface>HTMLElement</dfn> : <span>Element</span> {
   readonly attribute DOMString <span data-x="dom-accessKeyLabel">accessKeyLabel</span>;
   [<span>CEReactions</span>] attribute boolean <span data-x="dom-draggable">draggable</span>;
   [<span>CEReactions</span>] attribute boolean <span data-x="dom-spellcheck">spellcheck</span>;
+  [<span>CEReactions</span>] attribute boolean <span data-x="dom-writingsuggestions">writingsuggestions</span>;
   [<span>CEReactions</span>] attribute DOMString <span data-x="dom-autocapitalize">autocapitalize</span>;
 
   [<span>CEReactions</span>] attribute [<span>LegacyNullToEmptyString</span>] DOMString <span data-x="dom-innerText">innerText</span>;
@@ -12979,6 +12980,7 @@ https://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20HTML%3E%
    <li><code data-x="attr-tabindex">tabindex</code></li>
    <li><code data-x="attr-title">title</code></li>
    <li><code data-x="attr-translate">translate</code></li>
+   <li><code data-x="attr-writingsuggestions">writingsuggestions</code></li>
   </ul>
 
   <div w-nodev>
@@ -80813,6 +80815,157 @@ body { display:none }
   checkers. A user agent could offer on-demand checking, could perform continuous checking while the
   checking is enabled, or could use other interfaces.</p>
 
+  <h4>Writing suggestions</h4>
+
+  <div w-nodev>
+
+  <p>User agents may offer writing suggestions as users type into editable regions, either in form
+  controls (ex. the <code>textarea</code> element) or in elements in an <span  data-x="editing host">
+  editing host</span>.</p>
+
+  <p>For each element, user agents must establish a <dfn data-x="concept-writingsuggestions-default">default
+   behavior</dfn> from amongst the following behaviors:</p>
+
+  <dl>
+   <dt><dfn data-x="concept-writingsuggestions-default-on">on</dfn>
+
+   <dd>The user agent may offer writing suggestions on this element.
+
+   <dt><dfn data-x="concept-writingsuggestions-default-off">off</dfn>
+
+   <dd>The user agent must not offer writing suggestions on this element.
+
+   <dt><dfn data-x="concept-writingsuggestions-state-inherit">inherit</dfn>
+
+   <dd>The element's default writing suggestions state is the same as its parent element's.
+    Elements that have no parent element cannot have this as their default state.
+  </dl>
+
+  <p>The <dfn element-attr for="html-global"><code
+   data-x="attr-writingsuggestions">writingsuggestions</code></dfn> content attribute is an
+   <span>enumerated attribute</span> with the following keywords and states:</p>
+
+   <table>
+    <thead>
+     <tr>
+      <th>Keyword
+      <th>State
+      <th>Brief description
+    <tbody>
+     <tr>
+      <td><dfn attr-value for="html-global/writingsuggestions"><code
+      data-x="attr-writingsuggestions-on">on</code></dfn>
+      <td rowspan="2"><dfn data-x="attr-writingsuggestions-on-state">on</dfn>
+      <td rowspan="2">The user agent may offer writing suggestions on this element.
+     </tr>
+     <tr>
+      <td>(The empty string)
+     <tr>
+      <td><dfn attr-value for="html-global/writingsuggestions"><code
+       data-x="attr-writingsuggestions-off">off</code></dfn>
+      <td><dfn data-x="attr-writingsuggestions-off-state">off</dfn>
+      <td>The user agent must not offer writing suggestions on this element.
+     </tr>
+   </table>
+
+  <p>The attribute's <i data-x="missing value default">missing value default</i> and <i
+   data-x="invalid value default">invalid value default</i> are both the <dfn
+   data-x="attr-writingsuggestions-default-state">default</dfn> state. The default state
+   indicates that the element is to act according to its established
+   <span data-x="concept-writingsuggestions-default">default behavior</span>.</p>
+
+  <dl class="domintro">
+   <dt><code data-x=""><var>element</var>.<span subdfn data-x="dom-writingsuggestions">writingsuggestions</span> [ = <var>value</var> ]</code></dt>
+
+   <dd>
+    <p>Returns the keyword value corresponding to the writing suggestions state for the current <var>element</var>.</p>
+
+    <p>Can be set, to override the default and set the <code
+    data-x="attr-writingsuggestions">writingsuggestions</code> content attribute.</p>
+   </dd>
+  </dl>
+
+  <p>The <dfn attribute for="HTMLElement"><code data-x="dom-writingsuggestions">writingsuggestions</code></dfn> IDL
+   attribute, on getting, must return "on" if the element's <code data-x="attr-writingsuggestions">writingsuggestions</code> content attribute
+   is in the <i>on</i> state, or if the element's <code data-x="attr-writingsuggestions">writingsuggestions</code> content attribute is in the
+   <i>default</i> state and the element's <span data-x="concept-writingsuggestions-default">default behavior</span> is
+   <span data-x="concept-writingsuggestions-default-on">on</span>, or if the element's <code data-x="attr-writingsuggestions">
+   writingsuggestions</code> content attribute is in the <i>default</i> state and the element's
+   <span data-x="concept-writingsuggestions-default">default behavior</span> is <span data-x="concept-writingsuggestions-state-inherit">
+   inherit-by-default</span> and the element's parent element's <code data-x="dom-writingsuggestions">writingsuggestions</code> IDL attribute
+   would return "on"; otherwise, if none of those conditions applies, then the attribute must instead return "off".</p>
+
+  <p class="note">The <code data-x="dom-writingsuggestions">writingsuggestions</code> IDL attribute
+   is not affected by user preferences that override the <code data-x="attr-writingsuggestions">writingsuggestions</code> content
+   attribute, and therefore might not reflect the actual writing suggestions state.</p>
+
+  <p>On setting, if the new state is "on", then the element's <code data-x="attr-writingsuggestions">writingsuggestions</code>
+   content attribute must be set to the literal string "<code data-x="attr-writingsuggestions-on-state">on</code>", otherwise it must be set to the literal string
+   "<code data-x="attr-writingsuggestions-off-state">off</code>".
+
+  <p>User agents may only offer writing suggestions within the scope of the following element types.</p>
+
+  <ul>
+
+   <li><code>input</code> elements whose <code data-x="attr-input-type">type</code> attributes are in the
+    <span data-x="attr-input-type-text">Text</span>, <span data-x="attr-input-type-search">Search</span>,
+    <span data-x="attr-input-type-url">URL</span>, or <span data-x="attr-input-type-email">Email</span> states
+    and that are <i data-x="concept-fe-mutable">mutable</i> (i.e. that do not have the <code
+    data-x="attr-input-readonly">readonly</code> attribute specified and that are not <span
+    data-x="concept-fe-disabled">disabled</span>).</li>
+
+   <li><code>textarea</code> elements that do not have a <code data-x="attr-textarea-readonly">readonly</code>
+    attribute and that are not <span data-x="concept-fe-disabled">disabled</span>.</li>
+
+   <li><span data-x="editing host">Editing hosts</span> or <span>editable</span> elements.</li>
+
+  </ul>
+
+  <p>To determine if writing suggestions may be provided within a given element's scope, the user agent must use
+   the following algorithm:</p>
+
+  <ol>
+   <!-- user override -->
+
+   <li>If the user has disabled writing suggestions for this element, then writing suggestions must be disabled.</li>
+
+   <!-- content attribute: on, off -->
+
+   <li>Otherwise, if the element has a <code data-x="attr-writingsuggestions">writingsuggestions</code> content
+    attribute, then: if that attribute is in the <i>on</i> state, then writing suggestions may be enabled;
+    otherwise, if that attribute is in the <i>off</i> state, then writing suggestions must be disabled.</li>
+
+   <!-- inherit, if there is one to inherit from -->
+
+   <li>Otherwise, if there is an ancestor element with a <code data-x="attr-writingsuggestions">
+    writingsuggestions</code> content attribute that is not in the <i>default</i> state, then: if the
+    nearest such ancestor's <code data-x="attr-writingsuggestions">writingsuggestions</code> content
+    attribute is in the <i>on</i> state, then writing suggestions may be enabled; otherwise, if the
+    nearest such ancestor's <code data-x="attr-writingsuggestions">writingsuggestions</code> content
+    attribute is in the <i>off</i> state, then writing suggestions must be disabled.</li>
+
+   <!-- default -->
+
+   <li>Otherwise, if the element's <span data-x="concept-writingsuggestions-default">default behavior</span>
+   is <span data-x="concept-writingsuggestions-default-on">on</span>, then writing suggestions may be
+   enabled.</li>
+
+   <li>Otherwise, if the element's <span data-x="concept-writingsuggestions-default">default behavior</span>
+   is <span data-x="concept-writingsuggestions-default-off">off</span>, then writing suggestions must be
+   disabled.</li>
+
+   <!-- default inheritance -->
+
+   <li>Otherwise, if the element's parent element has writing suggestions enabled within <em>its</em> scope,
+    then writing suggestions may be enabled within this element's scope too.</li>
+
+   <li>Otherwise, writing suggestions must be disabled within this element's scope.</li>
+  </ol>
+
+  <p class="note">This specification does not define the user interface for writing suggestions.
+  A user agent could offer on-demand suggestions, continuous suggestions as the user types, inline
+  suggestions, autofill-like suggestions in a popup, or could use other interfaces.</p>
+
   <h4>Autocapitalization</h4>
 
   <p>Some methods of entering text, for example virtual keyboards on mobile devices, and also voice
@@ -138722,6 +138875,11 @@ interface <dfn interface>External</dfn> {
      <td> How the value of the form control is to be wrapped for <span>form submission</span>
      <td> "<code data-x="attr-textarea-wrap-soft">soft</code>";
           "<code data-x="attr-textarea-wrap-hard">hard</code>"
+    <tr>
+     <th> <code data-x="">writingsuggestions</code>
+     <td> <span data-x="attr-writingsuggestions">HTML elements</span>
+     <td> Whether the element can offer writing suggestions or not.
+     <td> "<code data-x="attr-writingsuggestions-on">on</code>"; "<code data-x="attr-writingsuggestions-off">off</code>"
   </table>
 
   <p class="tablenote"><small>An asterisk (*) in a cell indicates that the actual rules are more
@@ -141751,6 +141909,7 @@ INSERT INTERFACES HERE
   Samy Kamkar,
   Sander van Lambalgen,
   Sanjoy Pal,
+  Sanket Joshi,
   Sarah Gebauer,
   Sarven Capadisli,
   Satrujit Behera,