Merge remote-tracking branch 'upstream/main' into add-invoke

whatwg · foolip · Feb 19, 2025 · Oct 5, 2023 · Nov 8, 2024 · Nov 8, 2024
commit 7d69572ae25f44acae94a1fab519c2b2c734cf2e
diff --git a/source b/source
@@ -53744,19 +53744,6 @@ interface <dfn interface>HTMLButtonElement</dfn> : <span>HTMLElement</span> {
   data-x="attr-button-type">type</code> attribute is not in the <span
   data-x="attr-button-type-submit-state">Submit Button</span> state.</p>
 
-  <p>The <dfn element-attr for="button"><code data-x="attr-button-value">value</code></dfn>
-  attribute gives the element's value for the purposes of form submission. The element's <span
-  data-x="concept-fe-value">value</span> is the value of the element's <code
-  data-x="attr-button-value">value</code> attribute, if there is one, or the empty string
-  otherwise.</p>
-
-  <p class="note">A button (and its value) is only included in the form submission if the button
-  itself was used to initiate the form submission.</p>
-
-  <hr>
-
-  <div w-nodev>
-
   <p>The <dfn attribute for="HTMLButtonElement"><code
   data-x="dom-button-commandForElement">commandForElement</code></dfn> IDL attribute must
   <span>reflect</span> the element's <code data-x="attr-button-commandfor">commandfor</code>
@@ -53799,25 +53786,25 @@ interface <dfn interface>HTMLButtonElement</dfn> : <span>HTMLElement</span> {
   <p>The <code data-x="dom-button-command">command</code> setter steps are to set the <code
   data-x="attr-button-command">command</code> content attribute to the given value.</p>
 
-  <p>The <dfn attribute for="HTMLButtonElement"><code data-x="dom-button-value">value</code></dfn>
-  IDL attribute must <span>reflect</span> the content attribute of the same name.</p>
+  <p>The <dfn element-attr for="button"><code data-x="attr-button-value">value</code></dfn>
+  attribute gives the element's value for the purposes of form submission. The element's <span
+  data-x="concept-fe-value">value</span> is the value of the element's <code
+  data-x="attr-button-value">value</code> attribute, if there is one, or the empty string
+  otherwise.</p>
 
-  <p>The <dfn attribute for="HTMLButtonElement"><code data-x="dom-button-type">type</code></dfn>
-  getter steps are:</p>
+  <p class="note">A button (and its value) is only included in the form submission if the button
+  itself was used to initiate the form submission.</p>
 
-  <ol>
-   <li><p>If <span>this</span> is a <span data-x="concept-submit-button">submit button</span>, then
-   return "<code data-x="">submit</code>".</p></li>
+  <hr>
 
-   <li><p>If <span>this</span>'s <span data-x="attr-button-type">type</span> attribute is in the
-   <span data-x="attr-button-type-reset-state">Reset</span> state, then return "<code
-   data-x="">reset</code>".</p></li>
+  <div w-nodev>
 
-   <li><p>Return "<code data-x="">button</code>".</p></li>
-  </ol>
+  <p>The <dfn attribute for="HTMLButtonElement"><code data-x="dom-button-value">value</code></dfn>
+  IDL attribute must <span>reflect</span> the content attribute of the same name.</p>
 
-  <p>The <code data-x="dom-button-type">type</code> setter steps are to set the <code
-  data-x="attr-button-type">type</code> content attribute to the given value.</p>
+  <p>The <dfn attribute for="HTMLButtonElement"><code data-x="dom-button-type">type</code></dfn> IDL
+  attribute must <span>reflect</span> the content attribute of the same name, <span>limited to only
+  known values</span>.</p>
 
   <p>The <code data-x="dom-cva-willValidate">willValidate</code>, <code
   data-x="dom-cva-validity">validity</code>, and <code
@@ -62261,13 +62248,13 @@ interface <dfn interface>HTMLDialogElement</dfn> : <span>HTMLElement</span> {
 
   <ol>
    <li><p>If <var>subject</var> has an <code data-x="attr-dialog-open">open</code> attribute and
-   the <span>is modal</span> flag of <var>subject</var> is true, then return.</p></li>
+   <span>is modal</span> of <var>subject</var> is true, then return.</p></li>
 
    <li><p>If <var>subject</var> has an <code data-x="attr-dialog-open">open</code> attribute, then
    throw an <span>"<code>InvalidStateError</code>"</span> <code>DOMException</code>.</p></li>
 
-   <li><p>If <var>subject</var>'s <span>node document</span> is not <span>fully active</span>,
-   then throw an <span>"<code>InvalidStateError</code>"</span> <code>DOMException</code>.</p></li>
+   <li><p>If <var>subject</var>'s <span>node document</span> is not <span>fully active</span>, then
+   throw an <span>"<code>InvalidStateError</code>"</span> <code>DOMException</code>.</p></li>
 
    <li><p>If <var>subject</var> is not <span>connected</span>, then throw an
    <span>"<code>InvalidStateError</code>"</span> <code>DOMException</code>.</p></li>
@@ -62298,7 +62285,14 @@ interface <dfn interface>HTMLDialogElement</dfn> : <span>HTMLElement</span> {
    <li><p>Add an <code data-x="attr-dialog-open">open</code> attribute to <var>subject</var>, whose
    value is the empty string.</p></li>
 
-   <li><p>Set the <span>is modal</span> flag of <var>subject</var> to true.</p></li>
+   <li><p>Set <span>is modal</span> of <var>subject</var> to true.</p></li>
+
+   <li><p><span>Assert</span>: <var>subject</var>'s <span>node document</span>'s <span>open
+   dialogs list</span> does not <span data-x="list contains">contain</span>
+   <var>subject</var>.</p></li>
+
+   <li><p>Add <var>subject</var> to <var>subject</var>'s <span>node document</span>'s <span>open
+   dialogs list</span>.</p></li>
 
    <li>
     <p>Let <var>subject</var>'s <span>node document</span> be <span data-x="blocked by a modal
@@ -62316,39 +62310,114 @@ interface <dfn interface>HTMLDialogElement</dfn> : <span>HTMLElement</span> {
    already <span data-x="list contains">contain</span> <var>subject</var>, then <span>add an element
    to the top layer</span> given <var>subject</var>.</p></li>
 
-   <li id="canceling-dialogs">
-    <p>Set <var>subject</var>'s <span data-x="dialog-close-watcher">close watcher</span> to the
+   <li><p><span>Set the dialog close watcher</span> with <var>subject</var>.</p></li>
+
+   <li><p>Set <var>subject</var>'s <span>previously focused element</span> to the
+   <span>focused</span> element.</p></li>
+
+   <li><p>Let <var>document</var> be <var>subject</var>'s <span>node document</span>.</p></li>
+
+   <li><p>Let <var>hideUntil</var> be the result of running <span>topmost popover ancestor</span>
+   given <var>subject</var>, <var>document</var>'s <span>showing hint popover list</span>, null, and
+   false.</p></li>
+
+   <li><p>If <var>hideUntil</var> is null, then set <var>hideUntil</var> to the result of running
+   <span>topmost popover ancestor</span> given <var>subject</var>, <var>document</var>'s
+   <span>showing auto popover list</span>, null, and false.</p></li>
+
+   <li><p>If <var>hideUntil</var> is null, then set <var>hideUntil</var> to
+   <var>document</var>.</p></li>
+
+   <li><p>Run <span data-x="hide-all-popovers-until">hide all popovers until</span> given
+   <var>hideUntil</var>, false, and true.</p></li>
+
+   <li><p>Run the <span>dialog focusing steps</span> given <var>subject</var>.</p></li>
+  </ol>
+
+  <p>The <dfn method for="HTMLDialogElement"><code
+  data-x="dom-dialog-close">close(<var>returnValue</var>)</code></dfn> method steps are:
+
+  <ol>
+   <li><p>If <var>returnValue</var> is not given, then set it to null.</p></li>
+
+   <li><p><span>Close the dialog</span> <span>this</span> with <var>returnValue</var>.</p></li>
+  </ol>
+
+  <p>The <dfn method for="HTMLDialogElement"><code
+  data-x="dom-dialog-requestClose">requestClose(<var>returnValue</var>)</code></dfn> method steps
+  are:</p>
+
+  <ol>
+   <li><p>If <var>this</var> does not have an <code data-x="attr-dialog-open">open</code>
+   attribute, then return.</p></li>
+
+   <li><p><span>Assert</span>: <var>this</var>'s <span data-x="dialog-close-watcher">close
+   watcher</span> is not null.</p></li>
+
+   <li><p>Set <var>dialog</var>'s <span>enable close watcher for <code
+   data-x="dom-dialog-requestClose">requestClose()</code></span> to true.</p></li>
+
+   <li><p>If <var>returnValue</var> is not given, then set it to null.</p></li>
+
+   <li><p>Set <var>this</var>'s <span>request close return value</span> to
+   <var>returnValue</var>.</p></li>
+
+   <li><p><span data-x="close-watcher-request-close">Request to close</span> <var>dialog</var>'s
+   <span data-x="dialog-close-watcher">close watcher</span> with false.</p></li>
+
+   <li><p>Set <var>dialog</var>'s <span>enable close watcher for <code
+   data-x="dom-dialog-requestClose">requestClose()</code></span> to false.</p></li>
+  </ol>
+
+
+  <p id="canceling-dialogs">To <dfn>set the dialog close watcher</dfn>, given a <code>dialog</code>
+  element <var>dialog</var>:</p>
+
+  <ol>
+   <li>
+    <p>Set <var>dialog</var>'s <span data-x="dialog-close-watcher">close watcher</span> to the
     result of <span data-x="establish a close watcher">establishing a close watcher</span> given
-    <var>subject</var>'s <span>relevant global object</span>, with:</p>
+    <var>dialog</var>'s <span>relevant global object</span>, with:</p>
 
     <ul>
      <li><p><i data-x="create-close-watcher-cancelAction">cancelAction</i> given
      <var>canPreventClose</var> being to return the result of <span
      data-x="concept-event-fire">firing an event</span> named <code
-     data-x="event-cancel">cancel</code> at <var>subject</var>, with the <code
+     data-x="event-cancel">cancel</code> at <var>dialog</var>, with the <code
      data-x="dom-Event-cancelable">cancelable</code> attribute initialized to
      <var>canPreventClose</var>.</p></li>
 
      <li><p><i data-x="create-close-watcher-closeAction">closeAction</i> being to <span>close the
-     dialog</span> given <var>subject</var> and null.</p></li>
+     dialog</span> given <var>dialog</var> and <var>dialog</var>'s <span>request close return
+     value</span>.</p></li>
+
+     <li><p><i data-x="create-close-watcher-getEnabledState">getEnabledState</i> being to return
+     true if <var>dialog</var>'s <span>enable close watcher for <code
+     data-x="dom-dialog-requestClose">requestClose()</code></span> is true or <var>dialog</var>'s
+     <span>computed closed-by state</span> is not <span
+     data-x="attr-dialog-closedby-none-state">None</span>; otherwise false.</p></li>
     </ul>
    </li>
   </ol>
 
-   <li><p>Set <var>subject</var>'s <span>previously focused element</span> to the
-   <span>focused</span> element.</p></li>
+  <p>To retrieve a dialog's <dfn>computed closed-by state</dfn>, given a <code>dialog</code>
+  <var>dialog</var>:
 
-   <li><p>Let <var>hideUntil</var> be the result of running <span>topmost popover ancestor</span>
-   given <var>subject</var>, null, and false.</p></li>
+  <ol>
+   <li>
+    <p>If the state of <var>dialog</var>'s <code data-x="attr-dialog-closedby">closedby</code>
+    attribute is <span data-x="attr-dialog-closedby-auto-state">Auto</span>:</p>
 
-   <li><p>If <var>hideUntil</var> is null, then set <var>hideUntil</var> to <var>subject</var>'s
-   <span>node document</span>.</p></li>
+    <ol>
+     <li><p>If <var>dialog</var>'s <span>is modal</span> is true, then return <span
+     data-x="attr-dialog-closedby-closerequest-state">Close Request</span>.</p></li>
 
      <li><p>Return <span data-x="attr-dialog-closedby-none-state">None</span>.</p></li>
     </ol>
    </li>
 
-   <li><p>Run the <span>dialog focusing steps</span> given <var>subject</var>.</p></li>
+   <li><p>Return the state of <var>dialog</var>'s <code
+   data-x="attr-dialog-closedby">closedby</code> attribute.</p></li>
   </ol>
 
   <p>The <dfn>dialog focusing steps</dfn>, given a <code>dialog</code> element <var>subject</var>,
@@ -80155,7 +80224,6 @@ dictionary <dfn dictionary>CommandEventInit</dfn> : <span>EventInit</span> {
   Currently an event attribute initialized to a value cannot also have a getter, and so an internal
   slot (or map of additional fields) is required to properly specify this.</p>
 
-
   <h3>Focus</h3>
 
   <!-- https://software.hixie.ch/utilities/js/live-dom-viewer/?saved=2807 -->