Add feature for moveBefore() DOM methods (and group some DOM features) (#2660)

* Add `moveBefore()` feature

* Add DOM group

* Revise description

Co-authored-by: Patrick Brosset <[email protected]>

* Use PR URL for moveBefore spec instead of issue

Co-authored-by: Philip Jägenstedt <[email protected]>

* Fix wording on spec exception

Co-authored-by: Patrick Brosset <[email protected]>

* Make spec URL consistent

* Fix typo

* Undo putting DOM Geometry into the DOM group

Surprising, but correct.

* Undo adding structured-clone to DOM

It's a more generic operation.

Co-authored-by: Philip Jägenstedt <[email protected]>

* Change ID from movebefore to move-before

---------

Co-authored-by: Patrick Brosset <[email protected]>
Co-authored-by: Philip Jägenstedt <[email protected]>

Author: 3 people

features/declarative-shadow-dom.yml

@@ -3,6 +3,7 @@ description: The `shadowrootmode` attribute on `<template>` creates a shadow roo
 spec: https://html.spec.whatwg.org/multipage/scripting.html#attr-template-shadowrootmode
 group:
   - html
+  - dom
   - web-components
 caniuse: declarative-shadow-dom
 status:

features/dom.yml

@@ -1,6 +1,7 @@
 name: DOM
 description: The DOM (Document Object Model) API represents HTML and XML documents as trees of nodes. You can use the API to inspect and modify the structure and content of a document.
 spec: https://dom.spec.whatwg.org/
+group: dom
 status:
   compute_from: api.Document
 compat_features:

features/gethtml.yml

@@ -1,6 +1,7 @@
 name: getHTML()
 description: The `getHTML()` method of `Element` and `ShadowRoot` objects serializes an element's DOM to an HTML string.
 spec: https://html.spec.whatwg.org/multipage/dynamic-markup-insertion.html#html-serialization-methods
+group: dom
 compat_features:
   - api.Element.getHTML
   - api.ShadowRoot.getHTML

features/move-before.yml

@@ -0,0 +1,8 @@
+name: moveBefore()
+description: The `moveBefore()` DOM method relocates a node while preserving its state. For example, you can move the active element without losing focus, move an animated element without resetting the animation, or move an iframe without reloading its content.
+spec: https://github.com/whatwg/dom/pull/1307
+group: dom
+compat_features:
+  - api.Document.moveBefore
+  - api.DocumentFragment.moveBefore
+  - api.Element.moveBefore

features/move-before.yml.dist

@@ -0,0 +1,13 @@
+# Generated from: move-before.yml
+# Do not edit this file by hand. Edit the source file instead!
+
+status:
+  baseline: false
+  support:
+    chrome: "133"
+    chrome_android: "133"
+    edge: "133"
+compat_features:
+  - api.Document.moveBefore
+  - api.DocumentFragment.moveBefore
+  - api.Element.moveBefore

features/mutation-events.yml

@@ -2,6 +2,7 @@ name: Mutation events
 description: Mutation events like `DOMSubtreeModified`, `DOMNodeInserted`, or `DOMNodeRemoved` fire when DOM changes occur.
 # The latest spec doesn't mention them at all anymore.
 spec: https://w3c.github.io/uievents/
+group: dom
 discouraged:
   according_to:
     - https://www.w3.org/TR/2024/WD-uievents-20240906/#legacy-mutationevent-events

features/mutationobserver.yml

@@ -1,6 +1,7 @@
 name: MutationObserver
 description: The `MutationObserver` API watches for changes to the DOM tree and calls a callback function when DOM changes occur.
 spec: https://dom.spec.whatwg.org/#interface-mutationobserver
+group: dom
 compat_features:
   - api.MutationObserver
   - api.MutationObserver.MutationObserver

features/shadow-dom.yml

@@ -2,7 +2,9 @@ name: Shadow DOM
 description: Shadow DOM allows you to attach encapsulated "shadow" DOM trees to elements. A shadow DOM tree is a separate component, isolated from the scripts and styles in other parts of the document. This is a part of Web Components.
 spec: https://dom.spec.whatwg.org/#shadow-trees
 caniuse: shadowdomv1
-group: web-components
+group:
+  - dom
+  - web-components
 status:
   compute_from: api.Element.attachShadow
 compat_features:

groups/dom.yml

@@ -0,0 +1,2 @@
+# Features that manipulate the tree of nodes that make up a document.
+name: DOM

scripts/specs.ts

@@ -120,6 +120,10 @@ const defaultAllowlist: allowlistItem[] = [
     [
         "https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/DocumentSubtitle/explainer.md",
         "Allowed because this is where the application-title meta tag is spec'd at the moment. Remove when https://github.com/whatwg/html/issues/8909 is fixed."
+    ],
+    [
+        "https://github.com/whatwg/dom/pull/1307",
+        "This is only place moveBefore() is spec'd. Remove this exception when https://github.com/whatwg/dom/pull/1307 merges."
     ]
 ];