@jsenv/navi 0.29.50 → 0.29.52

package/docs/drag_to_travel.md

@@ -94,6 +94,8 @@ are read before the box moves:
    scrolls sideways inside a page still scrolls sideways.
 3. **Another travelling box in between.** The innermost one takes the axes it
    walks, and leaves the ones it does not to whoever is above it.
+4. **A surface in the top layer in between.** Nothing above it gets the gesture
+   at all — see [A surface in the top layer](#a-surface-in-the-top-layer).
 
 ### Boxes inside boxes
 
@@ -115,6 +117,21 @@ last slide does not hand the gesture over mid-drag: it leans on its wall, the wa
 it does when it is alone. Travelling the box around it means starting the gesture
 outside it.
 
+### A surface in the top layer
+
+A popover, a modal `<dialog>`, an element gone fullscreen: it is written inside
+whatever opened it — a slide, a page that travels — and the browser paints it
+over the whole screen. The DOM says "inside", the eye says "on top of", and the
+gesture belongs to what the eye sees: a drag across a full-screen dialog opened
+from a slide is not a drag on the slides, and nothing about it should reach
+them.
+
+So every walk up from the pointer stops there. The boxes above the surface get
+no axis, and a scroller above it gets nothing either — it is painted behind the
+surface, and behind is not under the finger. `showModal()` does not do this on
+its own: the rest of the document is made inert, but the press still bubbles out
+of the (not inert) dialog to a listener that sits above it.
+
 ### The browser also wants to answer the gesture
 
 A gesture that is already answered — something is being dragged — must not be

package/docs/scroll.md

@@ -158,6 +158,11 @@ picked up then. When it is still not the box you mean, say so explicitly with
   it asks for the row BY NAME, then puts it back by MEASURING it, so it lands
   where it was even if rows were inserted before it, and whatever the screen it
   was saved on. That is "reopen a thread where I left it", already provided.
+  `offset` is counted from where the row lands on its own — past the scroller's
+  `scroll-padding` (the room a fixed bar publishes) and the row's own
+  `scroll-margin` (the sticky header, the group label above it) — so `offset: 0`
+  is exactly where `scrollIntoView()` would put it and none of that room has to
+  be restated as a number.
 - **`scrolled`** is the controlled form of the same thing — same pair as
   `open`/`defaultOpen` elsewhere in navi. The list goes back there every time it
   changes, even after the user scrolled.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/navi",
-  "version": "0.29.50",
+  "version": "0.29.52",
   "type": "module",
   "description": "Library of components including navigation to create frontend applications",
   "repository": {
@@ -29,7 +29,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@jsenv/dom": "0.17.16",
+    "@jsenv/dom": "0.17.17",
     "@jsenv/humanize": "1.7.8",
     "@jsenv/validity": "0.4.2"
   },