Regenerate spec from bikeshed

Author: frivoal

index.html

@@ -1212,8 +1212,9 @@
 		}
 	}
 </style>
-  <meta content="Bikeshed version 018be3f805d3272ce699a232398d6e3902d1ea8d" name="generator">
+  <meta content="Bikeshed version abdace79009f95c8aedf382594a19cef590a24a9" name="generator">
   <link href="http://wicg.github.io/spatial-navigation" rel="canonical">
+  <meta content="954d081b25bacda896c5737573ca61f5b36b5477" name="document-revision">
 <style>
 code.key {
     border: solid 1px;
@@ -1515,7 +1516,7 @@
   <div class="head">
    <p data-fill-with="logo"></p>
    <h1 class="p-name no-ref" id="title">Spatial Navigation</h1>
-   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2018-10-14">14 October 2018</time></span></h2>
+   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2018-10-18">18 October 2018</time></span></h2>
    <div data-fill-with="spec-metadata">
     <dl>
      <dt>This version:
@@ -1537,7 +1538,7 @@ <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="cont
    <h2 class="no-num no-toc no-ref heading settled" id="abstract"><span class="content">Abstract</span></h2>
    <p>This specification defines a general model for navigating the focus using the arrow keys,
 
-    as well as related CSS and JavaScript features.</p>
+as well as related CSS and JavaScript features.</p>
   </div>
   <div data-fill-with="at-risk"></div>
   <h2 class="no-num no-toc no-ref heading settled" id="status"><span class="content">Status of this document</span></h2>
@@ -1864,11 +1865,23 @@ <h2 class="heading settled" data-level="4" id="triggering"><span class="secno">4
    <div class="api">
     <h2 class="heading settled" data-level="5" id="js-api"><span class="secno">5. </span><span class="content"> JavaScript API</span><a class="self-link" href="#js-api"></a></h2>
     <h3 class="heading settled" data-level="5.1" id="high-level-api"><span class="secno">5.1. </span><span class="content"> Triggering Navigation Programmatically</span><a class="self-link" href="#high-level-api"></a></h3>
-    <p class="issue" id="issue-7f028784"><a class="self-link" href="#issue-7f028784"></a> This API is clearly useful for testing purposes.
-It may also be useful for authors,
-but the use cases are less strong.
-Maybe this should be moved to WebDriver and be a testing-only API.
-Maybe it is fine as is.</p>
+    <p>The <code class="idl"><a data-link-type="idl" href="#dom-window-navigate" id="ref-for-dom-window-navigate">navigate()</a></code> method enables the author to trigger spatial navigation programatically,
+as if the user had done so manually
+(for instance, by pressing the arrow keys in a browser where that is the way to trigger spatial navigation).</p>
+    <p class="note" role="note"><span>Note:</span> As this triggers the same processing model as a manual navigation,
+all the same results should be expected:
+the same chain of events will be fired and
+the same element will be scrolled or focused.</p>
+    <p class="note" role="note"><span>Note:</span> Authors can use this to trigger spatial navigation
+based on a different UI mechanism than the one assigned by the UA,
+such as mapping to different keys,
+or triggering spatial navigation from a clickable on-screen directional pad.
+or in reaction to other events than UI ones.
+It could also be used when an author wants to interrupt navigation to do some asynchronous operation
+(e.g. load more content in an infinite scroller) then resume where they cancelled.</p>
+    <p class="note" role="note"><span>Note:</span> This API is also useful for testing purposes,
+as there is no other way to trigger spatial navigation
+that does not depend on vendor specific UI conventions.</p>
 <pre class="idl highlight def"><c- b>enum</c-> <dfn class="dfn-paneled idl-code" data-dfn-type="enum" data-export id="enumdef-spatialnavigationdirection"><code><c- g>SpatialNavigationDirection</c-></code></dfn> {
     <dfn class="idl-code" data-dfn-for="SpatialNavigationDirection" data-dfn-type="enum-value" data-export id="dom-spatialnavigationdirection-up"><code><c- s>"up"</c-></code><a class="self-link" href="#dom-spatialnavigationdirection-up"></a></dfn>,
     <dfn class="idl-code" data-dfn-for="SpatialNavigationDirection" data-dfn-type="enum-value" data-export id="dom-spatialnavigationdirection-down"><code><c- s>"down"</c-></code><a class="self-link" href="#dom-spatialnavigationdirection-down"></a></dfn>,
@@ -1881,7 +1894,7 @@ <h3 class="heading settled" data-level="5.1" id="high-level-api"><span class="se
 };
 </pre>
     <div class="algorithm" data-algorithm="windowNavigate steps">
-      The <code class="idl"><a data-link-type="idl" href="#dom-window-navigate" id="ref-for-dom-window-navigate">navigate()</a></code> method must follow these steps: 
+      The <code class="idl"><a data-link-type="idl" href="#dom-window-navigate" id="ref-for-dom-window-navigate①">navigate()</a></code> method must follow these steps: 
      <p>If <var>dir</var> is <code>"up"</code>, <code>"down"</code>, <code>"left"</code>, or <code>"right"</code>,
 run the <a data-link-type="dfn" href="#spatial-navigation-steps" id="ref-for-spatial-navigation-steps③">spatial navigation steps</a> in direction <var>dir</var>.</p>
     </div>
@@ -3646,11 +3659,6 @@ <h2 class="no-num no-ref heading settled" id="idl-index"><span class="content">I
 </pre>
   <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content">Issues Index</span><a class="self-link" href="#issues-index"></a></h2>
   <div style="counter-reset:issue">
-   <div class="issue"> This API is clearly useful for testing purposes.
-It may also be useful for authors,
-but the use cases are less strong.
-Maybe this should be moved to WebDriver and be a testing-only API.
-Maybe it is fine as is.<a href="#issue-7f028784"> ↵ </a></div>
    <div class="issue"> The following currently does not account
 for <a href="https://github.com/WICG/overscroll-behavior">the proposed overscroll-behavior specification</a>. <a href="https://github.com/wicg/spatial-navigation/issues/19">&lt;https://github.com/wicg/spatial-navigation/issues/19></a><a href="#issue-e8431aa1"> ↵ </a></div>
    <div class="issue"> The following does not take shadow dom into account. <a href="https://github.com/wicg/spatial-navigation/issues/21">&lt;https://github.com/wicg/spatial-navigation/issues/21></a><a href="#issue-e0cc24e0"> ↵ </a></div>
@@ -3693,7 +3701,7 @@ <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content
    <b><a href="#dom-window-navigate">#dom-window-navigate</a></b><b>Referenced in:</b>
    <ul>
     <li><a href="#ref-for-dom-window-navigate">5.1. 
-Triggering Navigation Programmatically</a>
+Triggering Navigation Programmatically</a> <a href="#ref-for-dom-window-navigate①">(2)</a>
    </ul>
   </aside>
   <aside class="dfn-panel" data-for="enumdef-focusableareasearchmode">