@jsenv/navi 0.29.360 → 0.29.362

package/docs/interactions.md

@@ -154,12 +154,18 @@ of — which is how a menu is opened at the point the press happened.
 ## Reaching the control
 
 Everything goes through the interaction gate of the **nearest control** — itself,
-an ancestor, or a descendant, in that order. So a disabled, read-only or busy
-control answers a swipe the way it answers a click: it says why, where the
+an ancestor, or the one control it wraps, in that order. So a disabled, read-only
+or busy control answers a swipe the way it answers a click: it says why, where the
 interaction happened, and nothing runs. A `Box` with no control anywhere near it
 still answers a callback; only `"request_action"` has nothing to ask, and says so
 in dev.
 
+A `Box` that lays out **several** controls — a row of badges, a toolbar — belongs
+to none of them: its interactions are its own, answered with no gate, exactly as
+a `Box` with no control near it. A click on its empty part is the box's, and a
+click on one of the controls reaches the box too, the way any click bubbles;
+the callback reads `event.target` when it has to tell them apart.
+
 The one thing the gate weighs besides the control's state is what the
 interaction would do to it. Everything writes unless it says otherwise; an
 interaction that only shows what is already there declares `intent: "read"`, and

package/docs/scroll.md

@@ -157,6 +157,12 @@ picked up then. When it is still not the box you mean, say so explicitly with
   `open`/`defaultOpen` elsewhere in navi. The list goes back there every time it
   changes, even after the user scrolled.
 - **`onScrolledChange`** gives `{id, index, offset}` as the user scrolls.
+- A list with an `id` **comes back where it was** when its screen is left and
+  come back to, the way the page does: the position is kept under the list's
+  `id` and the page's url, for the session, and put back by name the way
+  `defaultScrolled={{id, offset}}` is. A fresh arrival at the page still opens
+  at `defaultScrolled`. **`scrollResetOnNavigation`** opts out: the list then
+  opens the same way every time.
 
 ### A search moves the list, and gives it back
 

package/package.json

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