@jsenv/navi 0.29.506 → 0.29.507

package/docs/drag_to_travel.md

@@ -122,6 +122,10 @@ So an inner box sitting on its last slide does not hand the gesture over
 mid-drag: it leans on its wall, the way it does when it is alone. Travelling the
 box around it means starting the gesture outside it.
 
+When the boxes say ONE place between them — a row of titles in each slide of a
+column of levels, the address naming a title — they bind one state: see
+[state_binding.md](./state_binding.md#a-control-that-shows-part-of-a-bigger-answer).
+
 ### Something being carried inside a box
 
 A drag (`interactions={{ move, reorder, land, toss, leave }}`, see

package/docs/state_binding.md

@@ -184,6 +184,34 @@ went on is still chosen when it goes off: nothing cleared it). A control binds
 the state whose values it can show; a state holding more than that is more than
 one question.
 
+The opposite case is ONE answer drawn by two controls nested in each other: a
+column of tournament levels with a row of titles in each, the address saying
+which title (`?cup=P100:2`). The level is not a second question — nothing ever
+chooses a level without landing on one of its titles, so it is read from the
+title. Both containers bind the SAME signal, and nothing is wired between them:
+
+```jsx
+const cupSignal = stateSignal(undefined, { id: "cup" });
+
+<SlideContainer layout="column" signal={cupSignal}>
+  {levels.map((level) => (
+    <Slide area={level.name}>
+      <SlideContainer signal={cupSignal} defaultCurrent={level.entryKey}>
+        {level.titles.map((title) => (
+          <Slide area={title.key}>…</Slide>
+        ))}
+      </SlideContainer>
+    </Slide>
+  ))}
+</SlideContainer>;
+```
+
+The column shows the level holding the title the state names, a row off screen
+keeps the title it was left on, and changing level writes that title. Not
+`current` + `onCurrentChange` on each, ignoring `cause: "state"` and keeping a
+map of where each row was left: that is the state held a second time, by hand.
+What each part does is in `SlideContainer`'s JSDoc (`signal`).
+
 ## When there is no binding
 
 Sometimes the state being wired by hand has no prop for it. That is not a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/navi",
-  "version": "0.29.506",
+  "version": "0.29.507",
   "type": "module",
   "description": "Library of components including navigation to create frontend applications",
   "repository": {