Clarify the direction predicates for cursor iteration (#457)

SHA: 95f98c0
Reason: push, by inexorabletash

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: stelar7

index.html

@@ -8,7 +8,7 @@
   <meta content="Bikeshed version b25686b9f, updated Fri Mar 14 14:15:20 2025 -0700" name="generator">
   <link href="https://www.w3.org/TR/IndexedDB/" rel="canonical">
   <link href="logo-db.svg" rel="icon">
-  <meta content="91642aac63ceb9352236d31c023f8d4098969659" name="revision">
+  <meta content="95f98c0c0f8e046542c3f3c7c62cf34a8f0ffc62" name="revision">
   <meta content="dark light" name="color-scheme">
   <link href="https://www.w3.org/StyleSheets/TR/2021/dark.css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css">
 <style>
@@ -5524,14 +5524,33 @@ <h3 class="heading settled" data-level="6.7" id="cursor-iteration-operation"><sp
   satisfy all of the following requirements:</p>
           <ul>
            <li data-md>
-            <p>If <var>key</var> is defined, the record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①③">greater than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①④">equal to</a> <var>key</var>.</p>
+            <p>If <var>key</var> is defined:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①③">greater than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①④">equal to</a> <var>key</var>.</p>
+            </ul>
            <li data-md>
-            <p>If <var>primaryKey</var> is defined, the record’s key is <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑤">equal to</a> <var>key</var> and the record’s value is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①④">greater than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑥">equal to</a> <var>primaryKey</var>, or the
-  record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑤">greater than</a> <var>key</var>.</p>
+            <p>If <var>primaryKey</var> is defined:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑤">equal to</a> <var>key</var> and the record’s value is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①④">greater than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑥">equal to</a> <var>primaryKey</var></p>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑤">greater than</a> <var>key</var>.</p>
+            </ul>
            <li data-md>
-            <p>If <var>position</var> is defined, and <var>source</var> is an <a data-link-type="dfn" href="#object-store" id="ref-for-object-store①⓪④">object store</a>, the record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑥">greater than</a> <var>position</var>.</p>
+            <p>If <var>position</var> is defined and <var>source</var> is an <a data-link-type="dfn" href="#object-store" id="ref-for-object-store①⓪④">object store</a>:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑥">greater than</a> <var>position</var>.</p>
+            </ul>
            <li data-md>
-            <p>If <var>position</var> is defined, and <var>source</var> is an <a data-link-type="dfn" href="#index-concept" id="ref-for-index-concept⑤①">index</a>, the record’s key is <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑦">equal to</a> <var>position</var> and the record’s value is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑦">greater than</a> <var>object store position</var> or the record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑧">greater than</a> <var>position</var>.</p>
+            <p>If <var>position</var> is defined and <var>source</var> is an <a data-link-type="dfn" href="#index-concept" id="ref-for-index-concept⑤①">index</a>:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑦">equal to</a> <var>position</var> and the record’s value is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑦">greater than</a> <var>object store position</var></p>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑧">greater than</a> <var>position</var>.</p>
+            </ul>
            <li data-md>
             <p>The record’s key is <a data-link-type="dfn" href="#in" id="ref-for-in①③">in</a> <var>range</var>.</p>
           </ul>
@@ -5541,9 +5560,17 @@ <h3 class="heading settled" data-level="6.7" id="cursor-iteration-operation"><sp
   satisfy all of the following requirements:</p>
           <ul>
            <li data-md>
-            <p>If <var>key</var> is defined, the record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑨">greater than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑧">equal to</a> <var>key</var>.</p>
+            <p>If <var>key</var> is defined:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than①⑨">greater than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑧">equal to</a> <var>key</var>.</p>
+            </ul>
            <li data-md>
-            <p>If <var>position</var> is defined, the record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than②⓪">greater than</a> <var>position</var>.</p>
+            <p>If <var>position</var> is defined:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#greater-than" id="ref-for-greater-than②⓪">greater than</a> <var>position</var>.</p>
+            </ul>
            <li data-md>
             <p>The record’s key is <a data-link-type="dfn" href="#in" id="ref-for-in①④">in</a> <var>range</var>.</p>
           </ul>
@@ -5553,13 +5580,33 @@ <h3 class="heading settled" data-level="6.7" id="cursor-iteration-operation"><sp
   satisfy all of the following requirements:</p>
           <ul>
            <li data-md>
-            <p>If <var>key</var> is defined, the record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑤">less than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑨">equal to</a> <var>key</var>.</p>
+            <p>If <var>key</var> is defined:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑤">less than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to①⑨">equal to</a> <var>key</var>.</p>
+            </ul>
            <li data-md>
-            <p>If <var>primaryKey</var> is defined, the record’s key is <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to②⓪">equal to</a> <var>key</var> and the record’s value is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑥">less than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to②①">equal to</a> <var>primaryKey</var>, or the record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑦">less than</a> <var>key</var>.</p>
+            <p>If <var>primaryKey</var> is defined:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to②⓪">equal to</a> <var>key</var> and the record’s value is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑥">less than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to②①">equal to</a> <var>primaryKey</var></p>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑦">less than</a> <var>key</var>.</p>
+            </ul>
            <li data-md>
-            <p>If <var>position</var> is defined, and <var>source</var> is an <a data-link-type="dfn" href="#object-store" id="ref-for-object-store①⓪⑤">object store</a>, the record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑧">less than</a> <var>position</var>.</p>
+            <p>If <var>position</var> is defined and <var>source</var> is an <a data-link-type="dfn" href="#object-store" id="ref-for-object-store①⓪⑤">object store</a>:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑧">less than</a> <var>position</var>.</p>
+            </ul>
            <li data-md>
-            <p>If <var>position</var> is defined, and <var>source</var> is an <a data-link-type="dfn" href="#index-concept" id="ref-for-index-concept⑤②">index</a>, the record’s key is <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to②②">equal to</a> <var>position</var> and the record’s value is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑨">less than</a> <var>object store position</var> or the record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than①⓪">less than</a> <var>position</var>.</p>
+            <p>If <var>position</var> is defined and <var>source</var> is an <a data-link-type="dfn" href="#index-concept" id="ref-for-index-concept⑤②">index</a>:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to②②">equal to</a> <var>position</var> and the record’s value is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than⑨">less than</a> <var>object store position</var></p>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than①⓪">less than</a> <var>position</var>.</p>
+            </ul>
            <li data-md>
             <p>The record’s key is <a data-link-type="dfn" href="#in" id="ref-for-in①⑤">in</a> <var>range</var>.</p>
           </ul>
@@ -5568,9 +5615,17 @@ <h3 class="heading settled" data-level="6.7" id="cursor-iteration-operation"><sp
           <p>Let <var>temp record</var> be the last record in <var>records</var> which satisfy all of the following requirements:</p>
           <ul>
            <li data-md>
-            <p>If <var>key</var> is defined, the record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than①①">less than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to②③">equal to</a> <var>key</var>.</p>
+            <p>If <var>key</var> is defined:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than①①">less than</a> or <a data-link-type="dfn" href="#equal-to" id="ref-for-equal-to②③">equal to</a> <var>key</var>.</p>
+            </ul>
            <li data-md>
-            <p>If <var>position</var> is defined, the record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than①②">less than</a> <var>position</var>.</p>
+            <p>If <var>position</var> is defined:</p>
+            <ul>
+             <li data-md>
+              <p>The record’s key is <a data-link-type="dfn" href="#less-than" id="ref-for-less-than①②">less than</a> <var>position</var>.</p>
+            </ul>
            <li data-md>
             <p>The record’s key is <a data-link-type="dfn" href="#in" id="ref-for-in①⑥">in</a> <var>range</var>.</p>
           </ul>
@@ -6248,6 +6303,8 @@ <h2 class="heading settled" data-level="11" id="revision-history"><span class="s
      <p>Define <a data-link-type="dfn" href="#queue-a-database-task" id="ref-for-queue-a-database-task①⑤">Queue a database task</a> and replace <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#queue-a-task" id="ref-for-queue-a-task①">Queue a task</a> with it (<a href="https://github.com/w3c/IndexedDB/issues/421">issue #421</a>)</p>
     <li data-md>
      <p>Add missing parallel step to <code class="idl"><a data-link-type="idl" href="#dom-idbfactory-databases" id="ref-for-dom-idbfactory-databases⑤">databases</a></code>() (<a href="https://github.com/w3c/IndexedDB/issues/421">issue #421</a>)</p>
+    <li data-md>
+     <p>Clarify cursor iteration predicates (<a href="https://github.com/w3c/IndexedDB/issues/450">issue #450</a>)</p>
    </ul>
    <h2 class="heading settled" data-level="12" id="acknowledgements"><span class="secno">12. </span><span class="content">Acknowledgements</span><a class="self-link" href="#acknowledgements"></a></h2>
    <p><em>This section is non-normative.</em></p>