From 3686d71cf70b4e396c75979cdc74abe37801a2f6 Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner <jackalmage@gmail.com>
Date: Fri, 25 Oct 2024 15:50:59 -0700
Subject: [PATCH 1/6] Call out that <wpt> path prefixes can be overridden, and
 do so in the example to make it clearer.

---
 docs/index.bs   | 14 ++++++++++-
 docs/index.html | 65 ++++++++++++++++++++++++++++---------------------
 2 files changed, 50 insertions(+), 29 deletions(-)

diff --git a/docs/index.bs b/docs/index.bs
index a1ba084508..116a09349c 100644
--- a/docs/index.bs
+++ b/docs/index.bs
@@ -1478,7 +1478,8 @@ There are several additional optional keys:
 		You can set a different `crossorigin` value manually on the element,
 		or skip the element entirely by putting `nocrossorigin` on it or an ancestor.
 	* <dfn>WPT Path Prefix</dfn> is a partial URL path
-		that specifies a common path prefix for all of the tests in your <{wpt}> elements.
+		that specifies a default path prefix for all of the tests in your <{wpt}> elements.
+		(This can be overridden on an individual <{wpt}> element.)
 	* <dfn>WPT Display</dfn> takes the values "none", "closed", "open", or "inline",
 		and specifies whether and how <{wpt}> elements display anything in the output document.
 	* <dfn>Tracking Vector Class</dfn> is the HTML `class` attribute value used on the link inserted in elements annotated with the `tracking-vector` attribute.
@@ -3882,6 +3883,17 @@ and will override the metadata if specified.
 			no-foo-when-no-bar.html
 		</wpt>
 	</xmp>
+
+	Alternately, the path prefix could be indicated just on the one block:
+
+	<xmp highlight=html>
+		Implementations must FOO whenever they would also BAR.
+
+		<wpt pathprefix="/foo-spec/">
+			foo-whenever-you-bar.html
+			no-foo-when-no-bar.html
+		</wpt>
+	</xmp>
 </div>
 
 For debugging purposes,
diff --git a/docs/index.html b/docs/index.html
index b3e6543cd7..1c6a02b2b9 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1488,9 +1488,9 @@
 		}
 	}
 </style>
-  <meta content="Bikeshed version 296e6fd70, updated Mon Oct 21 15:52:55 2024 -0700" name="generator">
+  <meta content="Bikeshed version e716a693a, updated Mon Oct 21 15:59:55 2024 -0700" name="generator">
   <link href="https://speced.github.io/bikeshed/" rel="canonical">
-  <meta content="296e6fd70c6cb8c8a7c774cc980601c21b793e45" name="revision">
+  <meta content="e716a693ae20f5d13bce97741ac3cabcd4970a84" name="revision">
   <meta content="dark light" name="color-scheme">
 <style>/* Boilerplate: style-autolinks */
 .css.css, .property.property, .descriptor.descriptor {
@@ -2299,7 +2299,7 @@
   <div class="head">
    <p data-fill-with="logo"></p>
    <h1 class="p-name no-ref" id="title">Bikeshed Documentation</h1>
-   <h2 class="no-num no-toc no-ref heading settled" id="profile-and-date"><span class="content">Living Standard, <time class="dt-updated" datetime="2024-10-21">21 October 2024</time></span></h2>
+   <h2 class="no-num no-toc no-ref heading settled" id="profile-and-date"><span class="content">Living Standard, <time class="dt-updated" datetime="2024-10-25">25 October 2024</time></span></h2>
    <div data-fill-with="spec-metadata">
     <dl>
      <dt>This version:
@@ -2314,7 +2314,7 @@ <h2 class="no-num no-toc no-ref heading settled" id="profile-and-date"><span cla
    <div data-fill-with="warning"></div>
    <p class="copyright" data-fill-with="copyright"><a href="http://creativecommons.org/publicdomain/zero/1.0/" rel="license"><img alt="CC0" height="15" src="https://licensebuttons.net/p/zero/1.0/80x15.png" width="80"></a> To the extent possible under law, the editors have waived all copyright
 and related or neighboring rights to this work.
-In addition, as of 21 October 2024,
+In addition, as of 25 October 2024,
 the editors have made this specification available under the <a href="https://www.openwebfoundation.org/the-agreements/the-owf-1-0-agreements-granted-claims/owfa-1-0" rel="license">Open Web Foundation Agreement Version 1.0</a>,
 which is available at https://www.openwebfoundation.org/the-agreements/the-owf-1-0-agreements-granted-claims/owfa-1-0.
 Parts of this work may be from another specification document.  If so, those parts are instead covered by the license of that specification document. </p>
@@ -3884,10 +3884,11 @@ <h2 class="heading settled" data-level="4" id="metadata"><span class="secno">4.
 or skip the element entirely by putting <code>nocrossorigin</code> on it or an ancestor.</p>
     <li data-md>
      <p><dfn class="dfn-paneled" data-dfn-for="metadata" data-dfn-type="dfn" data-export id="metadata-wpt-path-prefix">WPT Path Prefix</dfn> is a partial URL path
-that specifies a common path prefix for all of the tests in your <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element">wpt</a></code> elements.</p>
+that specifies a default path prefix for all of the tests in your <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element">wpt</a></code> elements.
+(This can be overridden on an individual <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①">wpt</a></code> element.)</p>
     <li data-md>
      <p><dfn class="dfn-paneled" data-dfn-for="metadata" data-dfn-type="dfn" data-export id="metadata-wpt-display">WPT Display</dfn> takes the values "none", "closed", "open", or "inline",
-and specifies whether and how <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①">wpt</a></code> elements display anything in the output document.</p>
+and specifies whether and how <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②">wpt</a></code> elements display anything in the output document.</p>
     <li data-md>
      <p><dfn class="dfn-paneled" data-dfn-for="metadata" data-dfn-type="dfn" data-export id="metadata-tracking-vector-class">Tracking Vector Class</dfn> is the HTML <code>class</code> attribute value used on the link inserted in elements annotated with the <code>tracking-vector</code> attribute.</p>
     <li data-md>
@@ -5829,17 +5830,17 @@ <h2 class="heading settled" data-level="11" id="testing"><span class="secno">11.
 the canonical way to test new features and ensure interoperability
 is to contribute the testsuite to the <a href="https://wpt.fyi/about">Web Platform Tests</a> project.
 Bikeshed has some useful tools to interact with WPT information.</p>
-   <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data-level="11.1" data-lt="wpt" id="wpt-element"><span class="secno">11.1. </span><span class="content"> Annotating Specs with Tests: the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②">wpt</a></code> element</span><a class="self-link" href="#wpt-element" id="ref-for-wpt-element②①"></a></h3>
+   <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data-level="11.1" data-lt="wpt" id="wpt-element"><span class="secno">11.1. </span><span class="content"> Annotating Specs with Tests: the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element③">wpt</a></code> element</span><a class="self-link" href="#wpt-element" id="ref-for-wpt-element②②"></a></h3>
    <p>When writing tests,
 you can sometimes link to the section of the spec that you’re testing,
 to make it easier to review.
 But when you’re actually reading (or updating!) the spec,
 you can’t tell what sections are tested or untested,
 or what tests might need to be updated due to a change you’re making.
-The <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element③">wpt</a></code> element lets you easily link to your WPT testcases inline,
+The <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element④">wpt</a></code> element lets you easily link to your WPT testcases inline,
 right next to the text they’re testing,
 and helps make sure that the testsuite and the spec are kept in-sync.</p>
-   <p>The <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element④">wpt</a></code> element is a block-level element for parsing purposes;
+   <p>The <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑤">wpt</a></code> element is a block-level element for parsing purposes;
 place it after or between paragraphs/etc.
 The contents of the element are line-based:
 each line contains a single test path
@@ -5862,9 +5863,9 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
 An explicit <dfn class="dfn-paneled" data-dfn-for="wpt, wpt-rest" data-dfn-type="element-attr" data-export id="element-attrdef-wpt-pathprefix"><code>pathprefix</code></dfn> attribute
 can also provide the path prefix,
 and will override the metadata if specified.</p>
-   <div class="example" id="example-9b56e275">
-    <a class="self-link" href="#example-9b56e275"></a> If the preceding example used <a data-link-type="dfn" href="#metadata-wpt-path-prefix" id="ref-for-metadata-wpt-path-prefix①">WPT Path Prefix</a>,
-	the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑤">wpt</a></code> element could be shorter: 
+   <div class="example" id="example-123bb00c">
+    <a class="self-link" href="#example-123bb00c"></a> If the preceding example used <a data-link-type="dfn" href="#metadata-wpt-path-prefix" id="ref-for-metadata-wpt-path-prefix①">WPT Path Prefix</a>,
+	the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑥">wpt</a></code> element could be shorter: 
 <pre class="highlight"><c- p>&lt;</c-><c- f>pre</c-> <c- e>class</c-><c- o>=</c-><c- s>metadata</c-><c- p>></c->
 WPT Display: open
 WPT Path Prefix: /foo-spec/
@@ -5878,60 +5879,68 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
   foo-whenever-you-bar.html
   no-foo-when-no-bar.html
 <c- p>&lt;/</c-><c- f>wpt</c-><c- p>></c->
+</pre>
+    <p>Alternately, the path prefix could be indicated just on the one block:</p>
+<pre class="highlight">Implementations must FOO whenever they would also BAR.
+
+<c- p>&lt;</c-><c- f>wpt</c-> <c- e>pathprefix</c-><c- o>=</c-><c- s>"/foo-spec/"</c-><c- p>></c->
+  foo-whenever-you-bar.html
+  no-foo-when-no-bar.html
+<c- p>&lt;/</c-><c- f>wpt</c-><c- p>></c->
 </pre>
    </div>
    <p>For debugging purposes,
 a single <dfn class="dfn-paneled" data-dfn-type="element" data-export data-lt="wpt-rest" id="elementdef-wpt-rest"><code>&lt;wpt-rest></code></dfn> element can be used in a spec,
-which will act like a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑥">wpt</a></code> element containing all the tests under the current path prefix
-that aren’t already specified in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑦">wpt</a></code> element.
+which will act like a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑦">wpt</a></code> element containing all the tests under the current path prefix
+that aren’t already specified in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑧">wpt</a></code> element.
 As this defeats Bikeshed’s ability to tell you when you’re missing any tests,
 Bikeshed will emit a warning as long as a <code><a data-link-type="element" href="#elementdef-wpt-rest" id="ref-for-elementdef-wpt-rest">wpt-rest</a></code> element is in use.</p>
    <p>Bikeshed’s knowledge of valid tests allows some useful checks:</p>
    <ul>
     <li data-md>
      <p>If <a data-link-type="dfn" href="#metadata-wpt-path-prefix" id="ref-for-metadata-wpt-path-prefix②">WPT Path Prefix</a> is specified,
-then any tests under that prefix that aren’t specified in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑧">wpt</a></code> element
+then any tests under that prefix that aren’t specified in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑨">wpt</a></code> element
 will trigger a fatal error,
 so you’ll be alerted when new tests are added.</p>
     <li data-md>
      <p>If you specify a path that doesn’t exist
 (or <em>no longer</em> exists due to tests being moved or deleted),
 it will trigger a fatal error.</p>
-     <p>This check can be disabled for a given <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑨">wpt</a></code> element
+     <p>This check can be disabled for a given <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⓪">wpt</a></code> element
 by giving it the <dfn class="dfn-paneled idl-code" data-dfn-for="wpt" data-dfn-type="attribute" data-export id="dom-wpt-skip-existence-check"><code>skip-existence-check</code></dfn> boolean attribute.
 This allows you to point to private tests,
 such as those in browser-specific repos,
 without receiving errors about those tests missing
 from the main WPT repository.</p>
    </ul>
-   <p>By default, <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⓪">wpt</a></code> elements don’t display in the output document;
+   <p>By default, <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①①">wpt</a></code> elements don’t display in the output document;
 they’re intended to annotate the source file to help with spec authoring,
 and trigger Bikeshed’s checks.
 If you want to produce a test-annotated version of the output,
 specify the <a data-link-type="dfn" href="#metadata-wpt-display" id="ref-for-metadata-wpt-display">WPT Display</a> metadata with the value "open" or "closed";
-all of the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①①">wpt</a></code> elements will become usefully-formatted lists of their contained tests,
+all of the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①②">wpt</a></code> elements will become usefully-formatted lists of their contained tests,
 with links to <a href="https://wpt.fyi">wpt.fyi</a>,
 the live test on <a href="https://w3c-test.org">w3c-test.org</a>,
 and the source code on <a href="https://github.com/web-platform-tests/wpt">GitHub</a>.
 The difference between "open" and "closed" is that
-with the former, all <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①②">wpt</a></code> elements are initially displayed in a collapsed state
+with the former, all <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①③">wpt</a></code> elements are initially displayed in a collapsed state
 to avoid getting in the way of reading the document,
 while "open" causes them to be expanded initially.
 In either case, the use can interactively collapse or expand each element.</p>
    <figure>
      <img height="195" src="images/wpt-display-open.png" srcset="images/wpt-display-open.png 2x" width="600"> 
     <figcaption> When <code>WPT Display: open</code> is set,
-		the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①③">wpt</a></code> element turns into a "TESTS" block. </figcaption>
+		the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①④">wpt</a></code> element turns into a "TESTS" block. </figcaption>
    </figure>
    <figure>
      <img height="104" src="images/wpt-display-closed.png" srcset="images/wpt-display-closed.png 2x" width="600"> 
     <figcaption> When <code>WPT Display: closed</code> is set,
-		the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①④">wpt</a></code> element also turns into a "TESTS" block,
+		the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑤">wpt</a></code> element also turns into a "TESTS" block,
 		but it is initially collapsed. </figcaption>
    </figure>
    <p class="note" role="note"><span class="marker">Note:</span> For compatibility with earlier versions of Bikshed,
 "inline" is accepted as a synonym of "open".</p>
-   <p>When the <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/interaction.html#attr-hidden" id="ref-for-attr-hidden">hidden</a> attribute is set on the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑤">wpt</a></code> element,
+   <p>When the <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/interaction.html#attr-hidden" id="ref-for-attr-hidden">hidden</a> attribute is set on the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑥">wpt</a></code> element,
 Bikeshed will take the tests listed in that element into account,
 but exclude them from the output,
 even when producing a test-annotated version.</p>
@@ -5944,12 +5953,12 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
 In such cases,
 listing the tests in a <code class="highlight"><c- p>&lt;</c-><c- f>wpt</c-> <c- e>hidden</c-><c- p>></c-></code> element silences the warnings,
 without adding anything irrelevant to the output.</p>
-   <p>Information about a set of tests described in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑥">wpt</a></code> element
+   <p>Information about a set of tests described in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑦">wpt</a></code> element
 can be provided to the reader
-by writing it in the <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-title" id="ref-for-attr-title">title</a> attribute of the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑦">wpt</a></code> element.
+by writing it in the <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-title" id="ref-for-attr-title">title</a> attribute of the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑧">wpt</a></code> element.
 This will be inserted in the output as an introductory paragraph
 before the test list.
-A <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-lang" id="ref-for-attr-lang">lang</a> or <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-dir" id="ref-for-attr-dir">dir</a> set on the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑧">wpt</a></code> element
+A <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-lang" id="ref-for-attr-lang">lang</a> or <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-dir" id="ref-for-attr-dir">dir</a> set on the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑨">wpt</a></code> element
 will apply to the introductory paragraph if there is one.</p>
    <div class="example" id="example-1076be64">
     <a class="self-link" href="#example-1076be64"></a> 
@@ -5968,7 +5977,7 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
     <p>The test block in the example above would be rendered as follows:</p>
     <figure> <img alt="A WPT element with a list of tests, preceded by an introductory paragraph" height="168" src="images/tests-with-intro.png" srcset="images/tests-with-intro.png 2x" width="624"> </figure>
    </div>
-   <p>If multiple <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑨">wpt</a></code> follow each other in the source,
+   <p>If multiple <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②⓪">wpt</a></code> follow each other in the source,
 with nothing between them other than whitespace,
 they will be fused together in the output,
 visually taking less space than if they remained as separate elements.
@@ -5976,7 +5985,7 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
 if they have different <a data-link-type="element-attr" href="#element-attrdef-wpt-pathprefix" id="ref-for-element-attrdef-wpt-pathprefix">pathprefix</a> or <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-title" id="ref-for-attr-title①">title</a> attributes.
 When merging elements with <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-title" id="ref-for-attr-title②">title</a> attributes,
 the tests listed in each element will be preceded by the relevant introductory paragraph,
-and visually separated from tests listed in different <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②⓪">wpt</a></code> elements.</p>
+and visually separated from tests listed in different <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②①">wpt</a></code> elements.</p>
    <p class="note" role="note"><span class="marker">Note:</span> More tools and options for integrating with WPT will be developed in the future.</p>
    <h3 class="heading settled" data-level="11.2" id="updating-tests"><span class="secno">11.2. </span><span class="content">Updating Lists of Tests</span><a class="self-link" href="#updating-tests"></a></h3>
    <p>If Bikeshed reports that a test doesn’t exist,
@@ -7488,7 +7497,7 @@ <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content
 "railroad-terminal": {"dfnID":"railroad-terminal","dfnText":"Terminal","external":false,"refSections":[],"url":"#railroad-terminal"},
 "railroad-zeroormore": {"dfnID":"railroad-zeroormore","dfnText":"ZeroOrMore","external":false,"refSections":[{"refs":[{"id":"ref-for-railroad-zeroormore"}],"title":"13.1. The Diagram Language"}],"url":"#railroad-zeroormore"},
 "soft-boolish": {"dfnID":"soft-boolish","dfnText":"soft boolish","external":false,"refSections":[{"refs":[{"id":"ref-for-soft-boolish"},{"id":"ref-for-soft-boolish\u2460"}],"title":"4. Metadata"}],"url":"#soft-boolish"},
-"wpt-element": {"dfnID":"wpt-element","dfnText":"11.1. \nAnnotating Specs with Tests: the wpt element","external":false,"refSections":[{"refs":[{"id":"ref-for-wpt-element"},{"id":"ref-for-wpt-element\u2460"}],"title":"4. Metadata"},{"refs":[{"id":"ref-for-wpt-element\u2461"},{"id":"ref-for-wpt-element"},{"id":"ref-for-wpt-element\u2462"},{"id":"ref-for-wpt-element\u2463"},{"id":"ref-for-wpt-element\u2464"},{"id":"ref-for-wpt-element\u2465"},{"id":"ref-for-wpt-element\u2466"},{"id":"ref-for-wpt-element\u2467"},{"id":"ref-for-wpt-element\u2468"},{"id":"ref-for-wpt-element\u2460\u24ea"},{"id":"ref-for-wpt-element\u2460\u2460"},{"id":"ref-for-wpt-element\u2460\u2461"},{"id":"ref-for-wpt-element\u2460\u2462"},{"id":"ref-for-wpt-element\u2460\u2463"},{"id":"ref-for-wpt-element\u2460\u2464"},{"id":"ref-for-wpt-element\u2460\u2465"},{"id":"ref-for-wpt-element\u2460\u2466"},{"id":"ref-for-wpt-element\u2460\u2467"},{"id":"ref-for-wpt-element\u2460\u2468"},{"id":"ref-for-wpt-element\u2461\u24ea"}],"title":"11.1. \nAnnotating Specs with Tests: the wpt element"}],"url":"#wpt-element"},
+"wpt-element": {"dfnID":"wpt-element","dfnText":"11.1. \nAnnotating Specs with Tests: the wpt element","external":false,"refSections":[{"refs":[{"id":"ref-for-wpt-element"},{"id":"ref-for-wpt-element\u2460"},{"id":"ref-for-wpt-element\u2461"}],"title":"4. Metadata"},{"refs":[{"id":"ref-for-wpt-element\u2462"},{"id":"ref-for-wpt-element"},{"id":"ref-for-wpt-element\u2463"},{"id":"ref-for-wpt-element\u2464"},{"id":"ref-for-wpt-element\u2465"},{"id":"ref-for-wpt-element\u2466"},{"id":"ref-for-wpt-element\u2467"},{"id":"ref-for-wpt-element\u2468"},{"id":"ref-for-wpt-element\u2460\u24ea"},{"id":"ref-for-wpt-element\u2460\u2460"},{"id":"ref-for-wpt-element\u2460\u2461"},{"id":"ref-for-wpt-element\u2460\u2462"},{"id":"ref-for-wpt-element\u2460\u2463"},{"id":"ref-for-wpt-element\u2460\u2464"},{"id":"ref-for-wpt-element\u2460\u2465"},{"id":"ref-for-wpt-element\u2460\u2466"},{"id":"ref-for-wpt-element\u2460\u2467"},{"id":"ref-for-wpt-element\u2460\u2468"},{"id":"ref-for-wpt-element\u2461\u24ea"},{"id":"ref-for-wpt-element\u2461\u2460"}],"title":"11.1. \nAnnotating Specs with Tests: the wpt element"}],"url":"#wpt-element"},
 };
 
 document.addEventListener("DOMContentLoaded", ()=>{

From 57df606b3cb807131e32593c0e7e036e7ef48dc4 Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner <jackalmage@gmail.com>
Date: Mon, 28 Oct 2024 14:43:31 -0700
Subject: [PATCH 2/6] Allow <<boolean[<<foo>>]>> to be parsed. Also fix some
 new things from the ruff update.

---
 bikeshed/Spec.py                     |  2 +-
 bikeshed/cli.py                      |  8 ++++----
 bikeshed/doctypes/manager.py         |  2 +-
 bikeshed/h/dom.py                    |  4 ++--
 bikeshed/h/parser/parser.py          | 30 ++++++++++++++++++++--------
 bikeshed/h/parser/preds.py           |  4 ++--
 bikeshed/h/serializer.py             |  2 +-
 bikeshed/shorthands/oldShorthands.py | 29 +++++++++++++++++++++++----
 bikeshed/stylescript/manager.py      |  2 +-
 pyproject.toml                       |  1 +
 10 files changed, 60 insertions(+), 24 deletions(-)

diff --git a/bikeshed/Spec.py b/bikeshed/Spec.py
index 65956526eb..acec16ee29 100644
--- a/bikeshed/Spec.py
+++ b/bikeshed/Spec.py
@@ -490,7 +490,7 @@ def printTargets(self) -> None:
     def isOpaqueElement(self, el: t.ElementT) -> bool:
         if el.tag in self.md.opaqueElements:
             return True
-        if el.get("data-opaque") is not None or el.get("bs-opaque") is not None:  # noqa needless-bool
+        if el.get("data-opaque") is not None or el.get("bs-opaque") is not None:  # needless-bool
             return True
         return False
 
diff --git a/bikeshed/cli.py b/bikeshed/cli.py
index 56510a53b9..464d73e501 100644
--- a/bikeshed/cli.py
+++ b/bikeshed/cli.py
@@ -693,12 +693,12 @@ def handleProfile(options: argparse.Namespace) -> None:
     root = f'--root="{options.root}"' if options.root else ""
     leaf = f'--leaf="{options.leaf}"' if options.leaf else ""
     if options.svgFile:
-        os.system(  # noqa s605
-            f"time python -m cProfile -o stat.prof -m bikeshed -f spec && gprof2dot -f pstats --skew=.0001 {root} {leaf} stat.prof | dot -Tsvg -o {options.svgFile} && rm stat.prof",
+        os.system(
+            f"time python -m cProfile -o stat.prof -m bikeshed -f spec && gprof2dot -f pstats --skew=.0001 {root} {leaf} stat.prof | dot -Tsvg -o {options.svgFile} && rm stat.prof",  # noqa: S605
         )
     else:
-        os.system(  # noqa s605
-            f"time python -m cProfile -o /tmp/stat.prof -m bikeshed -f spec && gprof2dot -f pstats --skew=.0001 {root} {leaf} /tmp/stat.prof | xdot &",
+        os.system(
+            f"time python -m cProfile -o /tmp/stat.prof -m bikeshed -f spec && gprof2dot -f pstats --skew=.0001 {root} {leaf} /tmp/stat.prof | xdot &",  # noqa: S605
         )
 
 
diff --git a/bikeshed/doctypes/manager.py b/bikeshed/doctypes/manager.py
index 74b1e416c5..7cf03c9956 100644
--- a/bikeshed/doctypes/manager.py
+++ b/bikeshed/doctypes/manager.py
@@ -166,7 +166,7 @@ def looselyMatch(self, rawStatus: str) -> bool:
         orgName, statusName = utils.splitOrg(rawStatus)
         if statusName and self.name.upper() != statusName.upper():
             return False
-        if orgName and self.org.name != orgName.upper():  # noqa needless-bool
+        if orgName and self.org.name != orgName.upper():  # needless-bool
             return False
         return True
 
diff --git a/bikeshed/h/dom.py b/bikeshed/h/dom.py
index 16015e6908..9bc196b0bf 100644
--- a/bikeshed/h/dom.py
+++ b/bikeshed/h/dom.py
@@ -102,7 +102,7 @@ def validUrlUnit(char: str) -> bool:
     else:
         if 0xD800 <= c <= 0xDFFF or 0xFDD0 <= c <= 0xFDEF:
             return False
-        if (c % 0xFFFF) in [0xFFFE, 0xFFFF]:  # noqa needless-bool
+        if (c % 0xFFFF) in [0xFFFE, 0xFFFF]:  # needless-bool
             # Last two bytes are FFFE or FFFF
             return False
         return True
@@ -737,7 +737,7 @@ def isOddNode(node: t.Any) -> bool:
     # Something other than an element node or string.
     if isinstance(node, str):
         return False
-    if isElement(node):  # noqa needless-bool
+    if isElement(node):  # needless-bool
         return False
     return True
 
diff --git a/bikeshed/h/parser/parser.py b/bikeshed/h/parser/parser.py
index 246b8ebfde..8b6c9f7e16 100644
--- a/bikeshed/h/parser/parser.py
+++ b/bikeshed/h/parser/parser.py
@@ -13,6 +13,7 @@
     ParserNode,
     RawElement,
     RawText,
+    SafeText,
     SelfClosedTag,
     StartTag,
     escapeAttr,
@@ -704,18 +705,31 @@ def parseCSSProduction(s: Stream, start: int) -> Result[list[ParserNode]]:
     if text is None:
         m.die("Saw the start of a CSS production (like <<foo>>), but couldn't find the end.", lineNum=s.loc(start))
         return Result.fail(start)
-    if "\n" in text:
+    elif "\n" in text:
         m.die(
             "Saw the start of a CSS production (like <<foo>>), but couldn't find the end on the same line.",
             lineNum=s.loc(start),
         )
         return Result.fail(start)
-    if "<" in text or ">" in text:
-        m.die(
-            "It seems like you wrote a CSS production (like <<foo>>), but there's more markup inside of it, or you didn't close it properly.",
-            lineNum=s.loc(start),
-        )
-        return Result.fail(start)
+    elif "<" in text or ">" in text:
+        # Allow <<boolean [<<foo>>]>>
+        if "[" in text:
+            endOfArg = s.skipTo(textEnd, "]").i
+            newTextEnd = s.skipTo(endOfArg, ">>").i
+            if endOfArg == textEnd or newTextEnd == endOfArg:  # noqa: PLR1714
+                m.die(
+                    "It seems like you wrote a CSS production with an argument (like <<foo [<<bar>>]>>), but either included more [] in the argument, or otherwise messed up the syntax.",
+                    lineNum=s.loc(start),
+                )
+                return Result.fail(start)
+            textEnd = newTextEnd
+            text = s[textStart:textEnd]
+        else:
+            m.die(
+                "It seems like you wrote a CSS production (like <<foo>>), but there's more markup inside of it, or you didn't close it properly.",
+                lineNum=s.loc(start),
+            )
+            return Result.fail(start)
     nodeEnd = textEnd + 2
 
     startTag = StartTag(
@@ -724,7 +738,7 @@ def parseCSSProduction(s: Stream, start: int) -> Result[list[ParserNode]]:
         tag="fake-production-placeholder",
         attrs={"bs-autolink-syntax": s[start:nodeEnd], "class": "production", "bs-opaque": ""},
     ).finalize()
-    contents = RawText(
+    contents = SafeText(
         line=s.line(textStart),
         endLine=s.line(textEnd),
         text=text,
diff --git a/bikeshed/h/parser/preds.py b/bikeshed/h/parser/preds.py
index ad81c0015a..a000805e26 100644
--- a/bikeshed/h/parser/preds.py
+++ b/bikeshed/h/parser/preds.py
@@ -248,7 +248,7 @@ def isTagnameChar(ch: str) -> bool:
         return True
     if 0xFDF0 <= cp <= 0xFFFD:
         return True
-    if 0x10000 <= cp <= 0xEFFFF:  # noqa needless-bool
+    if 0x10000 <= cp <= 0xEFFFF:  # needless-bool
         return True
     return False
 
@@ -256,7 +256,7 @@ def isTagnameChar(ch: str) -> bool:
 def isAttrNameChar(ch: str) -> bool:
     if len(ch) != 1:
         return False
-    if isWhitespace(ch) or ch in "/<>=\"'" or ord(ch) == 0:  # noqa needless-bool
+    if isWhitespace(ch) or ch in "/<>=\"'" or ord(ch) == 0:  # needless-bool
         return False
     return True
 
diff --git a/bikeshed/h/serializer.py b/bikeshed/h/serializer.py
index 6626044563..cc359cdf17 100644
--- a/bikeshed/h/serializer.py
+++ b/bikeshed/h/serializer.py
@@ -187,7 +187,7 @@ def needsEndTag(self, el: t.ElementT, nextEl: Nodes | None = None) -> bool:
         if el.tag in ["dt", "dd"]:
             if nextEl is None:
                 return False
-            if self.isElement(nextEl) and nextEl.tag in ["dt", "dd"]:  # noqa needless-bool
+            if self.isElement(nextEl) and nextEl.tag in ["dt", "dd"]:  # needless-bool
                 return False
             return True
         return False
diff --git a/bikeshed/shorthands/oldShorthands.py b/bikeshed/shorthands/oldShorthands.py
index e35a9e2422..b6439f5cf2 100644
--- a/bikeshed/shorthands/oldShorthands.py
+++ b/bikeshed/shorthands/oldShorthands.py
@@ -24,11 +24,20 @@ def transformProductionPlaceholders(doc: t.SpecT) -> None:
         """,
         re.X,
     )
+    typeWithArgsRe = re.compile(
+        r"""
+        ^(?:(\S*)/)?
+        (\S+)
+        \s*\[([^\]]+)\]\s*$
+        """,
+        re.X,
+    )
     for el in h.findAll("fake-production-placeholder", doc):
         addLineNumber(el)
         text = h.textContent(el)
         h.clearContents(el)
-        match = propdescRe.match(text)
+        lt = text
+        match = propdescRe.match(lt)
         if match:
             linkFor, lt, linkType = match.groups()
             if linkFor == "":
@@ -55,7 +64,7 @@ def transformProductionPlaceholders(doc: t.SpecT) -> None:
                 el.set("for", linkFor)
             el.text = "<'" + lt + "'>"
             continue
-        match = funcRe.match(text)
+        match = funcRe.match(lt)
         if match:
             el.tag = "a"
             el.set("data-link-type", "function")
@@ -64,7 +73,7 @@ def transformProductionPlaceholders(doc: t.SpecT) -> None:
                 el.set("for", match.group(1))
             el.text = "<" + match.group(2) + ">"
             continue
-        match = atruleRe.match(text)
+        match = atruleRe.match(lt)
         if match:
             el.tag = "a"
             el.set("data-link-type", "at-rule")
@@ -73,7 +82,7 @@ def transformProductionPlaceholders(doc: t.SpecT) -> None:
                 el.set("for", match.group(1))
             el.text = "<" + match.group(2) + ">"
             continue
-        match = typeRe.match(text)
+        match = typeRe.match(lt)
         if match:
             for_, term, rangeStart, rangeEnd = match.groups()
             el.tag = "a"
@@ -98,6 +107,18 @@ def transformProductionPlaceholders(doc: t.SpecT) -> None:
             else:
                 el.text = f"<{term}>"
             continue
+        match = typeWithArgsRe.match(lt)
+        if match:
+            for_, term, arg = match.groups()
+            el.tag = "a"
+            el.set("data-lt", f"<{term}>")
+            el.set("data-link-type", "type")
+            if "<<" in arg:
+                arg = arg.replace("<<", "<").replace(">>", ">")
+            el.text = f"<{term}[{arg}]>"
+            if for_ is not None:
+                el.set("for", for_)
+            continue
         m.die(f"Shorthand <<{text}>> does not match any recognized shorthand grammar.", el=el)
         el.tag = "span"
         el.text = el.get("bs-autolink-syntax")
diff --git a/bikeshed/stylescript/manager.py b/bikeshed/stylescript/manager.py
index dbd6381e6b..b76808888f 100644
--- a/bikeshed/stylescript/manager.py
+++ b/bikeshed/stylescript/manager.py
@@ -182,7 +182,7 @@ def insertable(self, allowList: t.BoolSet) -> bool:
             return False
         if self.data is None:
             return True
-        if self.data[1]:  # noqa needless-bool
+        if self.data[1]:  # needless-bool
             return True
         return False
 
diff --git a/pyproject.toml b/pyproject.toml
index 0f9777225a..9b338a6736 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -9,6 +9,7 @@ disable = [
     "c-extension-no-member",             # seems to be weird false pos
     "consider-iterating-dictionary",     # lol no
     "consider-using-f-string",           # don't care
+    "consider-using-in",                 # ruff does this
     "duplicate-code",                    # dont' care
     "eval-used",                         # needed
     "exec-used",                         # needed

From 1ac0f576f828b34814609d6cc94075954bc04478 Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner <jackalmage@gmail.com>
Date: Mon, 28 Oct 2024 14:44:03 -0700
Subject: [PATCH 3/6] Bump semver to 4.2.2

---
 bikeshed/semver.txt                              | 2 +-
 bikeshed/spec-data/readonly/bikeshed-version.txt | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/bikeshed/semver.txt b/bikeshed/semver.txt
index d87edbfc10..078bf8b7dd 100644
--- a/bikeshed/semver.txt
+++ b/bikeshed/semver.txt
@@ -1 +1 @@
-4.2.1
\ No newline at end of file
+4.2.2
\ No newline at end of file
diff --git a/bikeshed/spec-data/readonly/bikeshed-version.txt b/bikeshed/spec-data/readonly/bikeshed-version.txt
index ddef59f61e..b3f17cab91 100644
--- a/bikeshed/spec-data/readonly/bikeshed-version.txt
+++ b/bikeshed/spec-data/readonly/bikeshed-version.txt
@@ -1 +1 @@
-Bikeshed version 44fb9b41e, updated Mon Oct 21 15:57:35 2024 -0700
\ No newline at end of file
+Bikeshed version 57df606b3, updated Mon Oct 28 14:43:31 2024 -0700
\ No newline at end of file

From 9e4e5f0f6a9bbb25cca20296d411ad890ea3d6d3 Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner <jackalmage@gmail.com>
Date: Mon, 28 Oct 2024 14:51:59 -0700
Subject: [PATCH 4/6] Allow an empty type arg

---
 bikeshed/shorthands/oldShorthands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bikeshed/shorthands/oldShorthands.py b/bikeshed/shorthands/oldShorthands.py
index b6439f5cf2..d450400bf1 100644
--- a/bikeshed/shorthands/oldShorthands.py
+++ b/bikeshed/shorthands/oldShorthands.py
@@ -28,7 +28,7 @@ def transformProductionPlaceholders(doc: t.SpecT) -> None:
         r"""
         ^(?:(\S*)/)?
         (\S+)
-        \s*\[([^\]]+)\]\s*$
+        \s*\[([^\]]*)\]\s*$
         """,
         re.X,
     )

From 78c2626830ab899a8d2d67058765683c0707b9a1 Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner <jackalmage@gmail.com>
Date: Mon, 28 Oct 2024 14:52:34 -0700
Subject: [PATCH 5/6] Bump semver to 4.2.3

---
 bikeshed/semver.txt                              | 2 +-
 bikeshed/spec-data/readonly/bikeshed-version.txt | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/bikeshed/semver.txt b/bikeshed/semver.txt
index 078bf8b7dd..ec87108d82 100644
--- a/bikeshed/semver.txt
+++ b/bikeshed/semver.txt
@@ -1 +1 @@
-4.2.2
\ No newline at end of file
+4.2.3
\ No newline at end of file
diff --git a/bikeshed/spec-data/readonly/bikeshed-version.txt b/bikeshed/spec-data/readonly/bikeshed-version.txt
index b3f17cab91..82be94c794 100644
--- a/bikeshed/spec-data/readonly/bikeshed-version.txt
+++ b/bikeshed/spec-data/readonly/bikeshed-version.txt
@@ -1 +1 @@
-Bikeshed version 57df606b3, updated Mon Oct 28 14:43:31 2024 -0700
\ No newline at end of file
+Bikeshed version 9e4e5f0f6, updated Mon Oct 28 14:51:59 2024 -0700
\ No newline at end of file

From 6cae8cff86870b0dfa311a9ed0e8c2b73c35436d Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner <jackalmage@gmail.com>
Date: Fri, 25 Oct 2024 15:54:20 -0700
Subject: [PATCH 6/6] rephrase

---
 docs/index.bs   |  7 +++++--
 docs/index.html | 48 +++++++++++++++++++++++++-----------------------
 2 files changed, 30 insertions(+), 25 deletions(-)

diff --git a/docs/index.bs b/docs/index.bs
index 116a09349c..0fde4a6e8a 100644
--- a/docs/index.bs
+++ b/docs/index.bs
@@ -3860,9 +3860,12 @@ pointing to the test covering some nearby text.
 If all or most of your tests have a common path prefix,
 you can specify it in [=WPT Path Prefix=] metadata,
 and then leave it off of all the individual test lines.
+This also triggers Bikeshed to complain if it knows of any tests under that prefix
+that don't show up in your spec.
+
 An explicit <dfn element-attr for="wpt, wpt-rest">pathprefix</dfn> attribute
-can also provide the path prefix,
-and will override the metadata if specified.
+can also provide the path prefix for a single <{wpt}> block,
+overriding the metadata if specified.
 
 <div class=example>
 	If the preceding example used [=WPT Path Prefix=],
diff --git a/docs/index.html b/docs/index.html
index 1c6a02b2b9..1b83525b6c 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1488,9 +1488,9 @@
 		}
 	}
 </style>
-  <meta content="Bikeshed version e716a693a, updated Mon Oct 21 15:59:55 2024 -0700" name="generator">
+  <meta content="Bikeshed version 3686d71cf, updated Fri Oct 25 15:50:59 2024 -0700" name="generator">
   <link href="https://speced.github.io/bikeshed/" rel="canonical">
-  <meta content="e716a693ae20f5d13bce97741ac3cabcd4970a84" name="revision">
+  <meta content="3686d71cf70b4e396c75979cdc74abe37801a2f6" name="revision">
   <meta content="dark light" name="color-scheme">
 <style>/* Boilerplate: style-autolinks */
 .css.css, .property.property, .descriptor.descriptor {
@@ -5830,7 +5830,7 @@ <h2 class="heading settled" data-level="11" id="testing"><span class="secno">11.
 the canonical way to test new features and ensure interoperability
 is to contribute the testsuite to the <a href="https://wpt.fyi/about">Web Platform Tests</a> project.
 Bikeshed has some useful tools to interact with WPT information.</p>
-   <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data-level="11.1" data-lt="wpt" id="wpt-element"><span class="secno">11.1. </span><span class="content"> Annotating Specs with Tests: the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element③">wpt</a></code> element</span><a class="self-link" href="#wpt-element" id="ref-for-wpt-element②②"></a></h3>
+   <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data-level="11.1" data-lt="wpt" id="wpt-element"><span class="secno">11.1. </span><span class="content"> Annotating Specs with Tests: the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element③">wpt</a></code> element</span><a class="self-link" href="#wpt-element" id="ref-for-wpt-element②③"></a></h3>
    <p>When writing tests,
 you can sometimes link to the section of the spec that you’re testing,
 to make it easier to review.
@@ -5860,12 +5860,14 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
    <p>If all or most of your tests have a common path prefix,
 you can specify it in <a data-link-type="dfn" href="#metadata-wpt-path-prefix" id="ref-for-metadata-wpt-path-prefix">WPT Path Prefix</a> metadata,
 and then leave it off of all the individual test lines.
-An explicit <dfn class="dfn-paneled" data-dfn-for="wpt, wpt-rest" data-dfn-type="element-attr" data-export id="element-attrdef-wpt-pathprefix"><code>pathprefix</code></dfn> attribute
-can also provide the path prefix,
-and will override the metadata if specified.</p>
+This also triggers Bikeshed to complain if it knows of any tests under that prefix
+that don’t show up in your spec.</p>
+   <p>An explicit <dfn class="dfn-paneled" data-dfn-for="wpt, wpt-rest" data-dfn-type="element-attr" data-export id="element-attrdef-wpt-pathprefix"><code>pathprefix</code></dfn> attribute
+can also provide the path prefix for a single <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑥">wpt</a></code> block,
+overriding the metadata if specified.</p>
    <div class="example" id="example-123bb00c">
     <a class="self-link" href="#example-123bb00c"></a> If the preceding example used <a data-link-type="dfn" href="#metadata-wpt-path-prefix" id="ref-for-metadata-wpt-path-prefix①">WPT Path Prefix</a>,
-	the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑥">wpt</a></code> element could be shorter: 
+	the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑦">wpt</a></code> element could be shorter: 
 <pre class="highlight"><c- p>&lt;</c-><c- f>pre</c-> <c- e>class</c-><c- o>=</c-><c- s>metadata</c-><c- p>></c->
 WPT Display: open
 WPT Path Prefix: /foo-spec/
@@ -5891,56 +5893,56 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
    </div>
    <p>For debugging purposes,
 a single <dfn class="dfn-paneled" data-dfn-type="element" data-export data-lt="wpt-rest" id="elementdef-wpt-rest"><code>&lt;wpt-rest></code></dfn> element can be used in a spec,
-which will act like a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑦">wpt</a></code> element containing all the tests under the current path prefix
-that aren’t already specified in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑧">wpt</a></code> element.
+which will act like a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑧">wpt</a></code> element containing all the tests under the current path prefix
+that aren’t already specified in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑨">wpt</a></code> element.
 As this defeats Bikeshed’s ability to tell you when you’re missing any tests,
 Bikeshed will emit a warning as long as a <code><a data-link-type="element" href="#elementdef-wpt-rest" id="ref-for-elementdef-wpt-rest">wpt-rest</a></code> element is in use.</p>
    <p>Bikeshed’s knowledge of valid tests allows some useful checks:</p>
    <ul>
     <li data-md>
      <p>If <a data-link-type="dfn" href="#metadata-wpt-path-prefix" id="ref-for-metadata-wpt-path-prefix②">WPT Path Prefix</a> is specified,
-then any tests under that prefix that aren’t specified in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element⑨">wpt</a></code> element
+then any tests under that prefix that aren’t specified in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⓪">wpt</a></code> element
 will trigger a fatal error,
 so you’ll be alerted when new tests are added.</p>
     <li data-md>
      <p>If you specify a path that doesn’t exist
 (or <em>no longer</em> exists due to tests being moved or deleted),
 it will trigger a fatal error.</p>
-     <p>This check can be disabled for a given <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⓪">wpt</a></code> element
+     <p>This check can be disabled for a given <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①①">wpt</a></code> element
 by giving it the <dfn class="dfn-paneled idl-code" data-dfn-for="wpt" data-dfn-type="attribute" data-export id="dom-wpt-skip-existence-check"><code>skip-existence-check</code></dfn> boolean attribute.
 This allows you to point to private tests,
 such as those in browser-specific repos,
 without receiving errors about those tests missing
 from the main WPT repository.</p>
    </ul>
-   <p>By default, <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①①">wpt</a></code> elements don’t display in the output document;
+   <p>By default, <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①②">wpt</a></code> elements don’t display in the output document;
 they’re intended to annotate the source file to help with spec authoring,
 and trigger Bikeshed’s checks.
 If you want to produce a test-annotated version of the output,
 specify the <a data-link-type="dfn" href="#metadata-wpt-display" id="ref-for-metadata-wpt-display">WPT Display</a> metadata with the value "open" or "closed";
-all of the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①②">wpt</a></code> elements will become usefully-formatted lists of their contained tests,
+all of the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①③">wpt</a></code> elements will become usefully-formatted lists of their contained tests,
 with links to <a href="https://wpt.fyi">wpt.fyi</a>,
 the live test on <a href="https://w3c-test.org">w3c-test.org</a>,
 and the source code on <a href="https://github.com/web-platform-tests/wpt">GitHub</a>.
 The difference between "open" and "closed" is that
-with the former, all <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①③">wpt</a></code> elements are initially displayed in a collapsed state
+with the former, all <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①④">wpt</a></code> elements are initially displayed in a collapsed state
 to avoid getting in the way of reading the document,
 while "open" causes them to be expanded initially.
 In either case, the use can interactively collapse or expand each element.</p>
    <figure>
      <img height="195" src="images/wpt-display-open.png" srcset="images/wpt-display-open.png 2x" width="600"> 
     <figcaption> When <code>WPT Display: open</code> is set,
-		the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①④">wpt</a></code> element turns into a "TESTS" block. </figcaption>
+		the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑤">wpt</a></code> element turns into a "TESTS" block. </figcaption>
    </figure>
    <figure>
      <img height="104" src="images/wpt-display-closed.png" srcset="images/wpt-display-closed.png 2x" width="600"> 
     <figcaption> When <code>WPT Display: closed</code> is set,
-		the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑤">wpt</a></code> element also turns into a "TESTS" block,
+		the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑥">wpt</a></code> element also turns into a "TESTS" block,
 		but it is initially collapsed. </figcaption>
    </figure>
    <p class="note" role="note"><span class="marker">Note:</span> For compatibility with earlier versions of Bikshed,
 "inline" is accepted as a synonym of "open".</p>
-   <p>When the <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/interaction.html#attr-hidden" id="ref-for-attr-hidden">hidden</a> attribute is set on the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑥">wpt</a></code> element,
+   <p>When the <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/interaction.html#attr-hidden" id="ref-for-attr-hidden">hidden</a> attribute is set on the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑦">wpt</a></code> element,
 Bikeshed will take the tests listed in that element into account,
 but exclude them from the output,
 even when producing a test-annotated version.</p>
@@ -5953,12 +5955,12 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
 In such cases,
 listing the tests in a <code class="highlight"><c- p>&lt;</c-><c- f>wpt</c-> <c- e>hidden</c-><c- p>></c-></code> element silences the warnings,
 without adding anything irrelevant to the output.</p>
-   <p>Information about a set of tests described in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑦">wpt</a></code> element
+   <p>Information about a set of tests described in a <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑧">wpt</a></code> element
 can be provided to the reader
-by writing it in the <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-title" id="ref-for-attr-title">title</a> attribute of the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑧">wpt</a></code> element.
+by writing it in the <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-title" id="ref-for-attr-title">title</a> attribute of the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑨">wpt</a></code> element.
 This will be inserted in the output as an introductory paragraph
 before the test list.
-A <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-lang" id="ref-for-attr-lang">lang</a> or <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-dir" id="ref-for-attr-dir">dir</a> set on the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element①⑨">wpt</a></code> element
+A <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-lang" id="ref-for-attr-lang">lang</a> or <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-dir" id="ref-for-attr-dir">dir</a> set on the <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②⓪">wpt</a></code> element
 will apply to the introductory paragraph if there is one.</p>
    <div class="example" id="example-1076be64">
     <a class="self-link" href="#example-1076be64"></a> 
@@ -5977,7 +5979,7 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
     <p>The test block in the example above would be rendered as follows:</p>
     <figure> <img alt="A WPT element with a list of tests, preceded by an introductory paragraph" height="168" src="images/tests-with-intro.png" srcset="images/tests-with-intro.png 2x" width="624"> </figure>
    </div>
-   <p>If multiple <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②⓪">wpt</a></code> follow each other in the source,
+   <p>If multiple <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②①">wpt</a></code> follow each other in the source,
 with nothing between them other than whitespace,
 they will be fused together in the output,
 visually taking less space than if they remained as separate elements.
@@ -5985,7 +5987,7 @@ <h3 class="heading settled dfn-paneled" data-dfn-type="element" data-export data
 if they have different <a data-link-type="element-attr" href="#element-attrdef-wpt-pathprefix" id="ref-for-element-attrdef-wpt-pathprefix">pathprefix</a> or <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-title" id="ref-for-attr-title①">title</a> attributes.
 When merging elements with <a data-link-type="element-attr" href="https://html.spec.whatwg.org/multipage/dom.html#attr-title" id="ref-for-attr-title②">title</a> attributes,
 the tests listed in each element will be preceded by the relevant introductory paragraph,
-and visually separated from tests listed in different <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②①">wpt</a></code> elements.</p>
+and visually separated from tests listed in different <code><a data-link-type="element" href="#wpt-element" id="ref-for-wpt-element②②">wpt</a></code> elements.</p>
    <p class="note" role="note"><span class="marker">Note:</span> More tools and options for integrating with WPT will be developed in the future.</p>
    <h3 class="heading settled" data-level="11.2" id="updating-tests"><span class="secno">11.2. </span><span class="content">Updating Lists of Tests</span><a class="self-link" href="#updating-tests"></a></h3>
    <p>If Bikeshed reports that a test doesn’t exist,
@@ -7497,7 +7499,7 @@ <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content
 "railroad-terminal": {"dfnID":"railroad-terminal","dfnText":"Terminal","external":false,"refSections":[],"url":"#railroad-terminal"},
 "railroad-zeroormore": {"dfnID":"railroad-zeroormore","dfnText":"ZeroOrMore","external":false,"refSections":[{"refs":[{"id":"ref-for-railroad-zeroormore"}],"title":"13.1. The Diagram Language"}],"url":"#railroad-zeroormore"},
 "soft-boolish": {"dfnID":"soft-boolish","dfnText":"soft boolish","external":false,"refSections":[{"refs":[{"id":"ref-for-soft-boolish"},{"id":"ref-for-soft-boolish\u2460"}],"title":"4. Metadata"}],"url":"#soft-boolish"},
-"wpt-element": {"dfnID":"wpt-element","dfnText":"11.1. \nAnnotating Specs with Tests: the wpt element","external":false,"refSections":[{"refs":[{"id":"ref-for-wpt-element"},{"id":"ref-for-wpt-element\u2460"},{"id":"ref-for-wpt-element\u2461"}],"title":"4. Metadata"},{"refs":[{"id":"ref-for-wpt-element\u2462"},{"id":"ref-for-wpt-element"},{"id":"ref-for-wpt-element\u2463"},{"id":"ref-for-wpt-element\u2464"},{"id":"ref-for-wpt-element\u2465"},{"id":"ref-for-wpt-element\u2466"},{"id":"ref-for-wpt-element\u2467"},{"id":"ref-for-wpt-element\u2468"},{"id":"ref-for-wpt-element\u2460\u24ea"},{"id":"ref-for-wpt-element\u2460\u2460"},{"id":"ref-for-wpt-element\u2460\u2461"},{"id":"ref-for-wpt-element\u2460\u2462"},{"id":"ref-for-wpt-element\u2460\u2463"},{"id":"ref-for-wpt-element\u2460\u2464"},{"id":"ref-for-wpt-element\u2460\u2465"},{"id":"ref-for-wpt-element\u2460\u2466"},{"id":"ref-for-wpt-element\u2460\u2467"},{"id":"ref-for-wpt-element\u2460\u2468"},{"id":"ref-for-wpt-element\u2461\u24ea"},{"id":"ref-for-wpt-element\u2461\u2460"}],"title":"11.1. \nAnnotating Specs with Tests: the wpt element"}],"url":"#wpt-element"},
+"wpt-element": {"dfnID":"wpt-element","dfnText":"11.1. \nAnnotating Specs with Tests: the wpt element","external":false,"refSections":[{"refs":[{"id":"ref-for-wpt-element"},{"id":"ref-for-wpt-element\u2460"},{"id":"ref-for-wpt-element\u2461"}],"title":"4. Metadata"},{"refs":[{"id":"ref-for-wpt-element\u2462"},{"id":"ref-for-wpt-element"},{"id":"ref-for-wpt-element\u2463"},{"id":"ref-for-wpt-element\u2464"},{"id":"ref-for-wpt-element\u2465"},{"id":"ref-for-wpt-element\u2466"},{"id":"ref-for-wpt-element\u2467"},{"id":"ref-for-wpt-element\u2468"},{"id":"ref-for-wpt-element\u2460\u24ea"},{"id":"ref-for-wpt-element\u2460\u2460"},{"id":"ref-for-wpt-element\u2460\u2461"},{"id":"ref-for-wpt-element\u2460\u2462"},{"id":"ref-for-wpt-element\u2460\u2463"},{"id":"ref-for-wpt-element\u2460\u2464"},{"id":"ref-for-wpt-element\u2460\u2465"},{"id":"ref-for-wpt-element\u2460\u2466"},{"id":"ref-for-wpt-element\u2460\u2467"},{"id":"ref-for-wpt-element\u2460\u2468"},{"id":"ref-for-wpt-element\u2461\u24ea"},{"id":"ref-for-wpt-element\u2461\u2460"},{"id":"ref-for-wpt-element\u2461\u2461"}],"title":"11.1. \nAnnotating Specs with Tests: the wpt element"}],"url":"#wpt-element"},
 };
 
 document.addEventListener("DOMContentLoaded", ()=>{