From 7afc9503f43b700c8d62a8dcdf07a4b542072a4c Mon Sep 17 00:00:00 2001
From: Anne van Kesteren <annevk@annevk.nl>
Date: Tue, 18 Oct 2022 11:18:10 +0200
Subject: [PATCH] Make adoption account for DocumentFragment nodes with hosts

Tests: https://github.com/web-platform-tests/wpt/pull/22504.

Corresponding HTML PR: https://github.com/whatwg/html/pull/5413.

Closes #813 and closes #814.
---
 dom.bs | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/dom.bs b/dom.bs
index 7fc68016..5af3f8fc 100644
--- a/dom.bs
+++ b/dom.bs
@@ -5329,8 +5329,8 @@ method steps are:
 algorithm is passed <var>node</var> and <var>oldDocument</var>, as indicated in the <a>adopt</a>
 algorithm.
 
-<p>To <dfn export id=concept-node-adopt>adopt</dfn> a <var>node</var> into a <var>document</var>, run
-these steps:
+<p>To <dfn export id=concept-node-adopt>adopt</dfn> a <var>node</var> into a <var>document</var>,
+with an optional <var>forceDocumentFragmentAdoption</var> (default false):
 
 <ol>
  <li><p>Let <var>oldDocument</var> be <var>node</var>'s <a for=Node>node document</a>.
@@ -5347,6 +5347,16 @@ these steps:
     <a>shadow-including inclusive descendants</a>:
 
     <ol>
+     <li>
+      <p>If <var>forceDocumentFragmentAdoption</var> is false, <var>inclusiveDescendant</var> is a
+      {{DocumentFragment}} <a for=/>node</a>, <var>inclusiveDescendant</var> is <var>node</var>, and
+      <var>node</var>'s <a for=DocumentFragment>host</a> is non-null, then
+      <a for=iteration>continue</a>.
+
+      <p class=note>This is only reasonable as long as all <a>adopt</a> callers remove the children
+      of <var>node</var>. HTML's <{template}> element passes true for
+      <var>forceDocumentFragmentAdoption</var>.
+
      <li><p>Set <var>inclusiveDescendant</var>'s <a for=Node>node document</a> to <var>document</var>.
 
      <li><p>If <var>inclusiveDescendant</var> is an <a for=/>element</a>, then set the
@@ -5375,6 +5385,12 @@ these steps:
  <li><p>If <var>node</var> is a <a for=/>shadow root</a>, then <a>throw</a> a
  "{{HierarchyRequestError!!exception}}" {{DOMException}}.
 
+ <li>
+  <p>If <var>node</var> is a {{DocumentFragment}} <a for=/>node</a> and its
+  <a for=DocumentFragment>host</a> is non-null, then return <var>node</var>.
+
+  <p class=note>Unfortunately this does not throw for web compatibility.
+
  <li><p><a>Adopt</a> <var>node</var> into <a>this</a>.
 
  <li><p>Return <var>node</var>.