@synopackageland/ui 0.20.17 → 0.20.18

package/docs/callout.md

@@ -51,6 +51,33 @@ otherwise the first toolbar (`AppToolbar`) or page header (`PageHeader`)
 shows one while a callout is closed, and none when nothing is. There is
 never a second icon, wherever the App puts the callout.
 
+**A notice about a passing state closes for that appearance only.** For a
+state that comes and goes (reconnecting, an error, a stalled capture), show
+the Callout with `v-if` while the state lasts and set
+`dismiss-scope="occurrence"`. Closing hides this appearance: nothing is
+stored, and the dismissal is forgotten when the Callout unmounts, so the next
+time the state starts the notice shows again. `persistent` (the default) is
+the behaviour above.
+
+```vue
+<Callout v-if="reconnecting" tone="warning" dismiss-key="reconnecting" dismiss-scope="occurrence">
+  Reconnecting… Notes are saved on this device until the connection is back.
+</Callout>
+```
+
+To show a closed callout again from code (its condition ended while it stays
+mounted, or a setting was reset), forget its dismissal by its `dismissKey`:
+
+```ts
+import { dismissalKey, forgetDismissal } from '@synopackageland/ui'
+
+forgetDismissal(dismissalKey('reconnecting'))
+```
+
+`dismissalKey(dismissKey)` is the storage key of the callout with that
+`dismissKey`; `forgetDismissal(key)` removes it from this page load and from
+`localStorage`, and a mounted callout under that key shows again.
+
 Storage is read and written inside `try`/`catch`: without it (a private
 window, blocked site data) a callout shows as usual, and closing it lasts for
 the page load.
@@ -160,6 +187,18 @@ and without an action, light and dark, and on a settings page:
   toast.success('Settings applied', 'Added port 6690')
   ```
 
+  `useToast()` needs a `<ToastProvider>` ancestor (the App puts one around
+  its shell) and
+  throws without it. A component that also mounts without the App shell (in
+  a unit test or a preview) asks for `useToast({ optional: true })`: without a
+  provider it gets a controller that shows nothing (its calls return -1,
+  `update` returns false). A test that wants to see the toasts provides its
+  own controller under the exported `toastControllerKey`:
+
+  ```ts
+  mount(Component, { global: { provide: { [toastControllerKey]: fakeToast } } })
+  ```
+
 - Work in progress keeps one toast id from start to result. A pending toast
   shows only if the work takes longer than 300 ms, has no timer, and turns
   into its result in place; an error's Retry can turn it back into pending:
@@ -197,6 +236,7 @@ and without an action, light and dark, and on a settings page:
 | `#details` + `v-model:expanded` | Longer text behind a "Learn more" toggle (`moreLabel`, `lessLabel`); in a hint, the tooltip of the whole line (`moreLabel` is not used) |
 | `code` | A machine error code, shown quieter after the message |
 | `dismissible` (default `true`), `dismissKey`, `closeLabel`, `@close` | The close button. Closing is remembered (a `danger` callout for this page load only) until the text changes; `dismissKey` is the callout's stable id within the App. `false` only for a state that must stay in view |
+| `dismissScope` | `persistent` (default): closing is remembered as above. `occurrence`: this appearance only, forgotten when the Callout unmounts |
 | `fill` | Deprecated: a Callout spans its container by default |
 
 Theme hooks (`data-tone`, `data-variant`, `data-fill`, `data-dismissible`, the `data-ui-callout-*`

package/docs/mobile-native.md

@@ -192,6 +192,13 @@ narrower; a row's last item has no neighbour to share room with), and on the
 InputSteppers presets button (shifted towards the text, same size). Unset,
 the box grows evenly as above.
 
+A scroller cuts off the part of a box outside it on every side. A control on
+a scroller's start edge loses that part too, so a scroller that holds page
+content keeps the page gutter as its own padding: on touch a `SettingsPage`
+body reaches over the gutter and pads its content by it. Tags in a select
+field keep `--ui-tap-gap` between them on touch, so a tag's remove button
+(44px box) never reaches the next tag.
+
 `check:mobile` exempts a link set in a sentence (inline, with text beside it
 in the same parent): WCAG 2.5.8 lets the line of text decide its size. A link
 alone on its line still needs 44px.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synopackageland/ui",
-  "version": "0.20.17",
+  "version": "0.20.18",
   "description": "Shared Vue 3 UI component library with a DSM 7 inspired application theme",
   "license": "MIT",
   "type": "module",