@jsenv/navi 0.29.209 → 0.29.211

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/pan_zoom.md CHANGED
@@ -90,6 +90,22 @@ It asks again only after a press has landed away from it, which is the hand
90
90
  saying it has moved on; navi watches for that press itself, so nothing on your
91
91
  side listens to the window.
92
92
 
93
+ The paid wait is a state to draw — the map answers on contact now, and the user
94
+ has to be told — so the surface says it: `[data-hand-kept]`, for as long as it
95
+ holds the hand, a finger on it or not.
96
+
97
+ ```css
98
+ .plan[data-hand-kept] {
99
+ box-shadow: 0 0 0 100vmax rgb(9 12 20 / 22%);
100
+ }
101
+ ```
102
+
103
+ Only a `"kept"` surface ever carries it: one that answers on contact was never
104
+ given anything to keep. `[data-grabbed]` is the narrower word — a hand on it at
105
+ this instant — and the two are drawn together or apart as you like
106
+ (`[data-hand-kept]:not([data-grabbed])` is the surface waiting, held, for the
107
+ next finger).
108
+
93
109
  ### A wheel that does not steal the page's scroll
94
110
 
95
111
  A wheel over a surface in a page means to scroll that page nine times out of ten
@@ -164,9 +180,10 @@ says (`grab`, `release`) and the same attribute:
164
180
  }
165
181
  ```
166
182
 
167
- `[data-grabbed]` is on the element for as long as the surface holds the hand, so
183
+ `[data-grabbed]` is on the element for as long as a hand is on the surface, so
168
184
  a contour, a veil or a raised shadow needs no listener — which is what this is
169
- usually for. `grab` and `release` are for the rest: a vibration, a state kept
185
+ usually for. (`[data-hand-kept]` is the other one, and it outlasts the finger:
186
+ see [`data-pan-after-hold`](#a-surface-that-scrolls-past-data-pan-after-hold).) `grab` and `release` are for the rest: a vibration, a state kept
170
187
  elsewhere. Their detail is `{ pointerType }`; like a drag's, they **report and do
171
188
  not ask**, and declared without `pan` or `zoom` they are a drag's words again,
172
189
  which is what the dev warning says.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jsenv/navi",
3
- "version": "0.29.209",
3
+ "version": "0.29.211",
4
4
  "type": "module",
5
5
  "description": "Library of components including navigation to create frontend applications",
6
6
  "repository": {
@@ -34,7 +34,7 @@
34
34
  "preact": "^11.0.0-beta.2"
35
35
  },
36
36
  "dependencies": {
37
- "@jsenv/dom": "0.17.57",
37
+ "@jsenv/dom": "0.17.58",
38
38
  "@jsenv/humanize": "1.8.1",
39
39
  "@jsenv/validity": "0.4.3"
40
40
  },