@jsenv/navi 0.29.482 → 0.29.484

package/docs/typography.md

@@ -158,6 +158,23 @@ where a separator would leave a stray gap next to something invisible; and
 `preventSpaceUnderlines`, which `Link` sets, so an underline stops at the text
 instead of running under the spaces.
 
+## Faces
+
+The document writes in the browser's control face: navi sets it as
+`font-family` on `:root`, in its layer, so a page that says nothing gets its
+text and its buttons in one face, and the app's own `font-family` there wins.
+
+Controls carry no face of their own: they write in `inherit`, so what a
+container says reaches the button, the field and the picker inside it. To give
+them one, set `--navi-control-font-family` — on `:root` for the whole app, or
+on a subtree. A `Button` reads `--button-font-family`, which defaults to that
+token; a bare or text `Picker` writes in its container's face whatever the
+token says, its drawing being the caller's.
+
+A popup keeps the face of what opened it — a picker's popup, the picker's — so
+a menu needs no font of its own (see
+[what reaches a popup from its opener](./css_architecture.md#a-surface-is-a-new-paper-what-reaches-a-popup-from-its-opener)).
+
 ## Emoji
 
 **An emoji is not a character the layout can absorb.** The system emoji fonts

package/docs/view_transitions.md

@@ -6,6 +6,19 @@ document. An app that starts a transition of its own runs into a handful of
 browser facts no component can absorb for it; they are collected here so that
 they are met once.
 
+Two of them are absorbed by the function navi starts its own with, and an app
+starts its own with it too. `ensureDocumentStartViewTransition()` installs
+`document.startViewTransition` where the browser has none and returns the
+function to call: it runs the update whatever happens, and swallows the
+rejection a skipped transition leaves behind (see
+[below](#ready-rejects-when-the-transition-is-skipped-finished-when-the-update-fails)).
+Ending it still takes both ways of `finished`:
+
+```js
+const startViewTransition = ensureDocumentStartViewTransition();
+startViewTransition(() => setItems(next)).finished.then(done, done);
+```
+
 - [A name is unique per document](#a-name-is-unique-per-document)
 - [Nested groups, and the fallback fade](#nested-groups-and-the-fallback-fade)
 - [Rendering is suspended for the whole callback](#rendering-is-suspended-for-the-whole-callback)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/navi",
-  "version": "0.29.482",
+  "version": "0.29.484",
   "type": "module",
   "description": "Library of components including navigation to create frontend applications",
   "repository": {
@@ -34,8 +34,8 @@
     "preact": "^11.0.0-rc.2"
   },
   "dependencies": {
-    "@jsenv/dom": "0.17.95",
-    "@jsenv/humanize": "1.8.9",
+    "@jsenv/dom": "0.17.96",
+    "@jsenv/humanize": "1.8.10",
     "@jsenv/validity": "0.4.7"
   },
   "devDependencies": {