From 66cc3cebc670a1c0a68948645c2aefd768f2a69f Mon Sep 17 00:00:00 2001
From: Anne van Kesteren <annevk@annevk.nl>
Date: Fri, 28 Nov 2025 15:29:42 +0100
Subject: [PATCH 1/2] Editorial: modernize mutation observers

Mainly adding <div algorithm>.
---
 dom.bs | 33 ++++++++++++++++++++++++---------
 1 file changed, 24 insertions(+), 9 deletions(-)

diff --git a/dom.bs b/dom.bs
index 32c0b71c..be8f496f 100644
--- a/dom.bs
+++ b/dom.bs
@@ -3906,9 +3906,9 @@ must return null.
 <dfn id=mutation-observer-list>pending mutation observers</dfn> (a <a for=/>set</a> of zero or more
 {{MutationObserver}} objects), which is initially empty.
 
+<div algorithm>
 <p>To
-<dfn noexport id=queue-a-mutation-observer-compound-microtask>queue a mutation observer microtask</dfn>,
-run these steps:
+<dfn id=queue-a-mutation-observer-compound-microtask>queue a mutation observer microtask</dfn>:
 
 <ol>
  <li><p>If the <a>surrounding agent</a>'s <a>mutation observer microtask queued</a> is true, then
@@ -3918,8 +3918,10 @@ run these steps:
 
  <li><p><a lt="queue a microtask">Queue</a> a <a>microtask</a> to <a>notify mutation observers</a>.
 </ol>
+</div>
 
-<p>To <dfn export>notify mutation observers</dfn>, run these steps:
+<div algorithm>
+<p>To <dfn export>notify mutation observers</dfn>:
 
 <ol>
  <li><p>Set the <a>surrounding agent</a>'s <a>mutation observer microtask queued</a> to false.
@@ -3957,6 +3959,7 @@ run these steps:
  <dfn event for=HTMLSlotElement>slotchange</dfn>, with its {{Event/bubbles}} attribute set to true,
  at <var>slot</var>.
 </ol>
+</div>
 
 <hr>
 
@@ -4088,11 +4091,14 @@ dictionary MutationObserverInit {
  returns what was in there.
 </dl>
 
+<div algorithm>
 <p>The
 <dfn constructor for=MutationObserver lt=MutationObserver(callback)><code>new MutationObserver(<var>callback</var>)</code></dfn>
 constructor steps are to set <a>this</a>'s <a for=MutationObserver>callback</a> to
 <var>callback</var>.
+</div>
 
+<div algorithm>
 <p>The
 <dfn method for=MutationObserver><code>observe(<var>target</var>, <var>options</var>)</code></dfn>
 method steps are:
@@ -4153,7 +4159,9 @@ method steps are:
    <a for=MutationObserver>node list</a>.
   </ol>
 </ol>
+</div>
 
+<div algorithm>
 <p>The <dfn method for=MutationObserver><code>disconnect()</code></dfn> method steps are:
 
 <ol>
@@ -4164,7 +4172,9 @@ method steps are:
 
  <li><p><a for=queue>Empty</a> <a>this</a>'s <a for=MutationObserver>record queue</a>.
 </ol>
+</div>
 
+<div algorithm>
 <p>The <dfn method for=MutationObserver><code>takeRecords()</code></dfn> method steps are:
 
 <ol>
@@ -4175,13 +4185,15 @@ method steps are:
 
  <li><p>Return <var>records</var>.
 </ol>
+</div>
 
 
 <h4 id=queueing-a-mutation-record>Queuing a mutation record</h4>
 
-<p>To <dfn noexport>queue a mutation record</dfn> of <var>type</var> for <var>target</var> with
+<div algorithm>
+<p>To <dfn>queue a mutation record</dfn> of <var>type</var> for <var>target</var> with
 <var>name</var>, <var>namespace</var>, <var>oldValue</var>, <var>addedNodes</var>,
-<var>removedNodes</var>, <var>previousSibling</var>, and <var>nextSibling</var>, run these steps:
+<var>removedNodes</var>, <var>previousSibling</var>, and <var>nextSibling</var>:
 
 <ol>
  <li><p>Let <var>interestedObservers</var> be an empty <a for=/>map</a>.
@@ -4259,18 +4271,21 @@ method steps are:
 
  <li><p><a>Queue a mutation observer microtask</a>.
 </ol>
+</div>
 
-<p>To <dfn noexport>queue a tree mutation record</dfn> for <var>target</var> with
-<var>addedNodes</var>, <var>removedNodes</var>, <var>previousSibling</var>, and
-<var>nextSibling</var>, run these steps:
+<div algorithm>
+<p>To <dfn>queue a tree mutation record</dfn> for <var>target</var> with <var>addedNodes</var>,
+<var>removedNodes</var>, <var>previousSibling</var>, and <var>nextSibling</var>:
 
 <ol>
- <li><p>Assert: either <var>addedNodes</var> or <var>removedNodes</var> <a for=set>is not empty</a>.
+ <li><p><a for=/>Assert</a>: either <var>addedNodes</var> or <var>removedNodes</var>
+ <a for=set>is not empty</a>.
 
  <li><p><a>Queue a mutation record</a> of "<code>childList</code>" for <var>target</var> with
  null, null, null, <var>addedNodes</var>, <var>removedNodes</var>, <var>previousSibling</var>,
  and <var>nextSibling</var>.
 </ol>
+</div>
 
 
 <h4 id=interface-mutationrecord>Interface {{MutationRecord}}</h4>

From 33f43ac7181ef8e90be3eba12ae7caf7e2da302b Mon Sep 17 00:00:00 2001
From: Anne van Kesteren <annevk@annevk.nl>
Date: Fri, 28 Nov 2025 15:32:07 +0100
Subject: [PATCH 2/2] Update dom.bs

---
 dom.bs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dom.bs b/dom.bs
index be8f496f..dfc0d365 100644
--- a/dom.bs
+++ b/dom.bs
@@ -3920,7 +3920,7 @@ must return null.
 </ol>
 </div>
 
-<div algorithm>
+<div algorithm="notify mutation observers">
 <p>To <dfn export>notify mutation observers</dfn>:
 
 <ol>