@usableapp/cardds 0.7.42 → 0.7.44

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 > For: a project that consumes `@usableapp/cardds` and its AI — what changed between versions, written as before → after, so a screen can be brought up to date without reading the source. Newest first. A consumer never edits cardds; if something here leaves you without a way to do what you did before, report the gap.
 
+## 0.7.44 — 2026-10-02
+
+### Added
+- **The signal set is the standard** (Lh 2026-10-02): four colours, four meanings, in every project and in the wireframe — `--signal-ok` green (it went right) · `--signal-warn` yellow (look out) · `--signal-error` red (it went wrong) · `--signal-info` blue (for your information). A theme may retune a shade in its `theme.css`, never a meaning. New: `--signal-ok-soft` · `--signal-warn-soft` · `--signal-error-soft` · `--signal-info-soft` — the light ground of each (the signal washed 14% into the surface); it follows the shade you set. Never the colour alone: an icon or words say it too.
+- **`Dot tone`** and **`Chip dot`**: `ok` · `warn` · `error` · `info` — `<Chip dot="ok">พร้อม</Chip>`. `dot="a"` / `"b"` are unchanged. Story `Dot · Tones`.
+
+### Changed
+- **`Snackbar` stands on the ok signal**: its ground is `--signal-ok-soft` with no border (was white with a border), and its glyph is `check` in `--signal-ok` by default — before, no `icon` meant no glyph; now pass `icon={false}` for none. New knob `--snackbar-icon-ink`. A screen that passed `icon="check"` needs no change.
+
+## 0.7.43 — 2026-10-02
+
+### Added
+- **`Snackbar` — a quick good-news line over the screen** (Lh 2026-10-02): something went well, said in passing; a warning or a question stays a `Modal`. A child of the `Screen`: `<Snackbar icon="check" onClosed={…}>ส่งคำขอแล้ว</Snackbar>` slides in from the top, stays `duration` (4000 ms; 0 = until the app closes it), slides out and calls `onClosed` — unmount it there. `open` + `onOpenChange(open, 'timeout' | 'tap')` or `defaultOpen`; `caption` = a second small line; `bottom` = at the foot, above the bottom layer; `onTap` = it can be tapped (open the notification it tells about). One at a time — the queue and the notification list are the app's. Knobs `--snackbar-*` (docs/knobs.md). Stories `Snackbar · Success` · `Controlled` · `Bottom` · `LongWords`.
+
 ## 0.7.42 — 2026-10-02
 
 ### Added

package/README.md

@@ -306,6 +306,16 @@ whose markup has rules, because the sheet's box is the step itself:
   opened, a `SheetStack` sheet opened, a `Modal` arrived. Once it has settled: the field marked `data-autofocus`, else its
   first field, else its heading (a step's title, a modal's question) or, for a sheet come onto the screen, its handle. A field
   that already has the cursor keeps it. One mechanic for all of them (`focusWhenActive`, src/state.ts); an app writes no focus code.
+- **The signal set — four colours, four meanings, everywhere** (Lh 2026-10-02): `--signal-ok` green (it went right) ·
+  `--signal-warn` yellow (look out) · `--signal-error` red (it went wrong) · `--signal-info` blue (for your information).
+  The wireframe has them too. A theme may retune a shade, never a meaning. Each is dark enough for words and edges;
+  `--signal-*-soft` is its light ground (the signal washed 14% into the surface). Never the colour alone: an icon or
+  words say it too. Read by: `Field`/`Pin`/`FormNote` error, `Dot tone` / `Chip dot="ok|warn|error|info"`, `Snackbar` (ok).
+- **Good news is a `Snackbar`, a warning or a question is a `Modal`** (Lh 2026-10-02): a `Snackbar` is a quick line over the
+  screen — something went well, said in passing. A child of the `Screen`; it slides in from the top (or `bottom`, above the
+  bottom layer), stays `duration` (4 s), slides out, never takes the cursor, never stops the member. `open` +
+  `onOpenChange(open, reason)` or `defaultOpen`; unmount it in `onClosed`. One at a time: the queue and the notification
+  list are the app's — the app shows its newest notification in it, `onTap` opens that notification.
 - **cardds names its own controls, in the page's language** (Lh 2026-09-29): a handle, a back button, a Pin's cells… read
   their name from `src/words.ts` by `<html lang>` (en, th ship; `setWords(lang, {…})` adds one). An app passes no label that
   only repeats these words; a prop still wins.
@@ -618,7 +628,7 @@ That file is where a project's look lives. Bases and roles:
 | the size **of** things | `--tap-base` (3rem = 48) | `--tap*`, `--btn-h`, `--chip-h`, `--bar-h`, `--header-h`, `--fab`, `--icon*`, `--avatar*`, `--dot*`, `--ring*`, `--tile-*`. `--tap*` never under `--tap-floor` (44px) |
 | faces | `--font-ui`, `--font-display` | |
 | colour | `--color-surface`, `--color-ink`, `--color-paper`, `--color-brand`, `--color-on-brand` — no default: unset = the wireframe | every role: surface / words, the three card tones (paper · the brand washed 14% into the surface · the brand), the muted inks (the ink washed into their ground), accent, neutral actions, `--dot-a` |
-| colour roles (the escape hatch) | `--surface`, `--on-surface(-muted)`, `--card-{1,2,3}-{bg,ink}`, `--card-border`, `--card-muted`, `--card-2-muted`, `--accent`, `--on-accent`, `--action-{bg,ink,border}`, `--pos`, `--neg`, `--dot-{a,b}` | a role set directly wins over its derivation; the tints derive from the roles |
+| colour roles (the escape hatch) | `--surface`, `--on-surface(-muted)`, `--card-{1,2,3}-{bg,ink}`, `--card-border`, `--card-muted`, `--card-2-muted`, `--accent`, `--on-accent`, `--action-{bg,ink,border}`, `--pos`, `--neg`, `--dot-{a,b}`, `--signal-{ok,warn,error,info}` | a role set directly wins over its derivation; the tints derive from the roles |
 
 Rules:
 

package/css/actions.css

@@ -179,6 +179,11 @@
    The drop: a line box is centred on its ascender room (Thai marks), the letters beside the dot sit lower — the dot rides down to the
    letters' own middle, in em so it follows the text size (Lh 2026-09-22: "ตัวหนังสือกับไฟเสมอกัน") */
 .dot--b { background: var(--dot-b); }
+/* the signal set on a dot (Lh 2026-10-02): the words beside it say what — never the colour alone */
+.dot--ok { background: var(--signal-ok); }
+.dot--warn { background: var(--signal-warn); }
+.dot--error { background: var(--signal-error); }
+.dot--info { background: var(--signal-info); }
 .chip--on { background: var(--chip-on-bg, var(--accent)); color: var(--chip-on-ink, var(--on-accent)); border-color: transparent; }
 /* muted: an untouched default — the words wash out, the edge stays; emphasis is the difference from the neighbours (README 13) */
 .chip--muted { color: var(--chip-muted-ink, var(--card-muted)); }
@@ -359,7 +364,7 @@
    pointer, no press, --off. Zero specificity everywhere: a component's own rule always wins. A NEW control joins a list here. */
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item) {
+  a.avatar, button.avatar, .menu__item, button.snackbar__body) {
   cursor: pointer;
   touch-action: manipulation;
   transition: scale var(--motion-press) ease-out;
@@ -378,7 +383,7 @@
 }
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item):active:not(:disabled, [aria-disabled="true"], :has(:disabled)) { scale: var(--press-scale); }
+  a.avatar, button.avatar, .menu__item, button.snackbar__body):active:not(:disabled, [aria-disabled="true"], :has(:disabled)) { scale: var(--press-scale); }
 :where(a.row, button.row, label.row, .row-expand > summary, .banner__summary, a.card, label.card, .toggle-field):active:not([aria-disabled="true"], :has(:disabled)) { opacity: var(--press-dim); }
 .sheet-step:has(> .sheet-step__go:active) { opacity: var(--press-dim); } /* the step bar's button is invisible over it: the bar answers */
 /* SHADE — what has something BEHIND it (a peeked sheet over the pile, a postcard's face over its back) must not turn see-through:
@@ -388,17 +393,17 @@
 /* the focus ring: on the control, or on the label that wraps a hidden input (chip, tile, file button, a row that is a label) */
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item):focus-visible,
+  a.avatar, button.avatar, .menu__item, button.snackbar__body):focus-visible,
 :where(.chip--pick, .tile--pick, label.btn, label.row, .toggle-field):has(:focus-visible) { outline: var(--focus); outline-offset: var(--sp-1); }
 :where(a.row, button.row, label.row, .row-expand > summary, .banner__summary, a.card, label.card, .toggle-field):not(label, .toggle-field):focus-visible { outline: var(--focus); outline-offset: var(--sp-1); }
 /* disabled: no pointer anywhere; a control fades (a link and a row keep their own muted look) */
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item, a.row, button.row, label.row, .row-expand > summary, .banner__summary, a.card, label.card, .toggle-field):is(:disabled, [aria-disabled="true"]),
+  a.avatar, button.avatar, .menu__item, button.snackbar__body, a.row, button.row, label.row, .row-expand > summary, .banner__summary, a.card, label.card, .toggle-field):is(:disabled, [aria-disabled="true"]),
 :where(.chip--pick, .tile--pick, .mood__opt, .toggle-field, label.btn, label.row):has(:disabled) { cursor: default; }
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item):not(.link):is(:disabled, [aria-disabled="true"]),
+  a.avatar, button.avatar, .menu__item, button.snackbar__body):not(.link):is(:disabled, [aria-disabled="true"]),
 :where(.chip--pick, .tile--pick, .mood__opt, .toggle-field, label.btn):has(:disabled) { opacity: var(--off); }
 .sheet-stack--tap > .card > .card__head > :is(h1, h2, h3):focus-visible { outline: var(--focus); outline-offset: var(--sp-1); } /* the keyboard's way into a stack sheet */
 @media (prefers-reduced-motion: reduce) { :root { --press-scale: 1; } } /* the give goes; the dim, the shade and the focus ring stay */

package/css/layover.css

@@ -308,3 +308,38 @@
 .splash__mark > * { display: block; width: 100%; height: auto; }
 .splash__text { margin: 0; font: var(--type-body); color: var(--splash-text-ink, var(--on-surface-muted)); }
 @media (prefers-reduced-motion: reduce) { .splash { transition: none; } }
+/* ---- snackbar: a quick good-news line over the screen — slides in, stays a moment, slides out (Lh 2026-10-02) ----
+   <div class="snackbar snackbar--open" role="status"><div class="snackbar__body"><svg class="icon"/>
+     <span class="snackbar__words"><span class="snackbar__text">…</span><span class="snackbar__caption">…</span></span></div></div>
+   A LAYER of the screen (its child), over the top bar; --bottom = at the foot, above the screen's bottom layer (--bottom-h).
+   Its ground is the OK signal's soft ground (--signal-ok-soft), its glyph the signal itself: the sign that it went right. Rigid like a sheet: `translate` only. `button.snackbar__body` = it can be tapped. Never a warning — that is a Modal. */
+.snackbar {
+  --_out: -1;
+  position: fixed; inset-inline: 0; top: calc(var(--sp-3) + var(--safe-top));
+  max-width: var(--screen-w); margin-inline: auto; padding-inline: var(--screen-pad, var(--sp-4));
+  display: grid; justify-items: center;
+  z-index: calc(var(--z-top) + 1);
+  pointer-events: none; visibility: hidden;
+  translate: 0 calc(var(--_out) * (100% + var(--sp-8) + var(--safe-top)));
+  transition: translate var(--motion-sheet) ease, visibility 0s var(--motion-sheet);
+}
+.screen--fill > .snackbar, .sheet-stage > .snackbar { position: absolute; }
+.snackbar--bottom { --_out: 1; top: auto; bottom: calc(var(--sp-3) + var(--bottom-h, 0px) + max(var(--safe-bottom), var(--kb, 0px))); }
+.snackbar--open { translate: 0; visibility: visible; transition-delay: 0s; }
+.snackbar__body {
+  display: flex; align-items: center; gap: var(--snackbar-gap, var(--sp-3));
+  max-width: 100%; min-height: var(--snackbar-min-h, var(--tap));
+  padding: var(--snackbar-pad-y, var(--sp-2)) var(--snackbar-pad-x, var(--sp-5));
+  border: var(--border-w) solid var(--snackbar-border, transparent);
+  border-radius: var(--snackbar-radius, var(--r-card));
+  background: var(--snackbar-bg, var(--signal-ok-soft));
+  color: var(--snackbar-ink, var(--on-surface));
+  box-shadow: var(--snackbar-shadow, var(--shadow-float));
+  font: inherit; text-align: start;
+  pointer-events: auto;
+}
+.snackbar__body > .icon { flex: none; color: var(--snackbar-icon-ink, var(--signal-ok)); }
+.snackbar__words { display: grid; min-width: 0; overflow-wrap: anywhere; }
+.snackbar__text { font: var(--snackbar-text-font, var(--type-body)); }
+.snackbar__caption { font: var(--snackbar-caption-font, var(--type-caption)); opacity: var(--dim); }
+@media (prefers-reduced-motion: reduce) { .snackbar { transition: none; } }

package/css/theme.template.css

@@ -49,5 +49,7 @@
      --card-border  --card-muted  --card-2-muted
      --accent --on-accent  --action-bg --action-ink --action-border
      --pos --neg  --dot-a --dot-b
+     --signal-ok --signal-warn --signal-error --signal-info   (the signal set: green · yellow · red · blue — retune the shade,
+       keep the meaning; dark enough for words. --signal-*-soft, the light ground of each, follows by itself)
      --dim (0.7: how far secondary words fade on a dark card, a drawer, a tile's sub line — one share for all) */
 }

package/css/tokens.css

@@ -210,12 +210,15 @@
   --neg: #3d3d3d;
   --dot-a: var(--color-brand, #141414);
   --dot-b: #8a8a8a;
-  --signal-warn: #8a6d00;   /* the full signal set (Lh 2026-09-25): error · warn · ok · info — each with an icon and words */
+  /* THE SIGNAL SET (Lh 2026-09-25; the standard, Lh 2026-10-02): ok (green) · warn (yellow) · error (red) · info (blue) — the same four
+     meanings in every project, wireframe included; a theme may retune the shade, never the meaning. Each is dark enough for words and
+     edges and comes with an icon and words, never the colour alone. `--signal-*-soft` (below :root) = its light ground. */
+  --signal-warn: #8a6d00;
   --signal-ok: #2e7d32;
   --signal-info: #2f5f9e;
   /* highlights (Lh 2026-09-25): four atmosphere colours a palette may set for decoration — a count, a mark, a chart dot; the wireframe keeps them grey */
   --highlight-1: #3d3d3d;  --highlight-2: #8a8a8a;  --highlight-3: #5f5f5f;  --highlight-4: #b0b0b0;
-  --signal-error: #c62828;  /* the ONE colour in the wireframe (Lh 2026-09-24): something went wrong — a field's edge, the words that say what. Always with an icon and words, never the colour alone */
+  --signal-error: #c62828;  /* something went wrong — a field's edge, the words that say what */
 
   /* derived tints — read the element's own ink, so they work on any slot */
   --outline: var(--action-border);                                 /* control edges (palette.css softens) */
@@ -244,6 +247,14 @@
    bars take over the page when the app runs edge to edge (viewport-fit=cover: Android Chrome, an iPhone home-screen app).
    PUBLISHED: backgrounds still run to the edge; what the member reads or taps stands clear of them. 0 without cover.
    --_safe-b-open = the bottom inset the keyboard does NOT already cover (a keyboard up hides the gesture bar). */
+/* a signal's SOFT ground: the signal washed 14% into the surface (tone 2's formula) — what a Snackbar stands on. Re-derived where a
+   palette is set, so a palette's own signal shade gives its own soft */
+:root, [data-palette] {
+  --signal-ok-soft: color-mix(in srgb, var(--signal-ok) 14%, var(--surface));
+  --signal-warn-soft: color-mix(in srgb, var(--signal-warn) 14%, var(--surface));
+  --signal-error-soft: color-mix(in srgb, var(--signal-error) 14%, var(--surface));
+  --signal-info-soft: color-mix(in srgb, var(--signal-info) 14%, var(--surface));
+}
 :root { --safe-top: env(safe-area-inset-top, 0px); --safe-bottom: env(safe-area-inset-bottom, 0px); }
 * { --_safe-b-open: max(0px, var(--safe-bottom) - var(--kb, 0px)); }
 

package/dist/actions/Chip.d.ts

@@ -1,11 +1,12 @@
 import { type ComponentProps, type ReactNode } from 'react';
+import { type DotTone } from './Dot.js';
 export interface ChipProps extends ComponentProps<'span'> {
     /** filled accent: the selected / live state */
     on?: boolean;
     /** quiet: an untouched default value — muted words, the thin edge, nothing to find the eye (README rule 13) */
     muted?: boolean;
-    /** a leading signal dot: `a` (the accent signal) or `b` (the secondary) */
-    dot?: 'a' | 'b';
+    /** a leading signal dot: `a` (the accent signal), `b` (the secondary), or one of the signal set — ok · warn · error · info */
+    dot?: 'a' | 'b' | DotTone;
     /** the element: span (default), a link, or a button */
     as?: 'span' | 'a' | 'button';
     href?: string;

package/dist/actions/Chip.js

@@ -5,7 +5,7 @@ import { Dot } from './Dot.js';
 /** Chip — a status or attribute tag (with an optional signal Dot), or a small tap target; `on` when it is the live one. For a choice use ChipPick (`sign` for the +/× interest picker). */
 export function Chip({ on, muted, dot, as, href, className, children, ...rest }) {
     const el = as ?? (href ? 'a' : 'span');
-    return createElement(el, { href, type: el === 'button' ? 'button' : undefined, className: cx('chip', on && 'chip--on', muted && 'chip--muted', className), ...rest }, dot && _jsx(Dot, { b: dot === 'b' }), children);
+    return createElement(el, { href, type: el === 'button' ? 'button' : undefined, className: cx('chip', on && 'chip--on', muted && 'chip--muted', className), ...rest }, dot && _jsx(Dot, { b: dot === 'b', tone: dot === 'a' || dot === 'b' ? undefined : dot }), children);
 }
 /** ChipPick — a chip that is a choice: full-width in a ChipGrid (9:00 · 9:30 · …), or `sign` on a ChipRow (+ off, × on — the
  *  interest picker); the picked one fills with accent. A native radio/checkbox inside the label carries the state. */

package/dist/actions/Dot.d.ts

@@ -1,7 +1,10 @@
 import type { ComponentProps } from 'react';
+export type DotTone = 'ok' | 'warn' | 'error' | 'info';
 export interface DotProps extends ComponentProps<'span'> {
     /** the secondary signal colour */
     b?: boolean;
+    /** a signal from the standard set: ok (green) · warn (yellow) · error (red) · info (blue) — the words beside it say what */
+    tone?: DotTone;
 }
 /** Dot — the signal dot in chips, legends and row metas. */
-export declare function Dot({ b, className, ...rest }: DotProps): import("react").JSX.Element;
+export declare function Dot({ b, tone, className, ...rest }: DotProps): import("react").JSX.Element;

package/dist/actions/Dot.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cx } from '../cx.js';
 /** Dot — the signal dot in chips, legends and row metas. */
-export function Dot({ b, className, ...rest }) {
-    return _jsx("span", { className: cx('dot', b && 'dot--b', className), ...rest });
+export function Dot({ b, tone, className, ...rest }) {
+    return _jsx("span", { className: cx('dot', b && 'dot--b', tone && `dot--${tone}`, className), ...rest });
 }

package/dist/cardds.css

@@ -251,12 +251,15 @@
   --neg: #3d3d3d;
   --dot-a: var(--color-brand, #141414);
   --dot-b: #8a8a8a;
-  --signal-warn: #8a6d00;   /* the full signal set (Lh 2026-09-25): error · warn · ok · info — each with an icon and words */
+  /* THE SIGNAL SET (Lh 2026-09-25; the standard, Lh 2026-10-02): ok (green) · warn (yellow) · error (red) · info (blue) — the same four
+     meanings in every project, wireframe included; a theme may retune the shade, never the meaning. Each is dark enough for words and
+     edges and comes with an icon and words, never the colour alone. `--signal-*-soft` (below :root) = its light ground. */
+  --signal-warn: #8a6d00;
   --signal-ok: #2e7d32;
   --signal-info: #2f5f9e;
   /* highlights (Lh 2026-09-25): four atmosphere colours a palette may set for decoration — a count, a mark, a chart dot; the wireframe keeps them grey */
   --highlight-1: #3d3d3d;  --highlight-2: #8a8a8a;  --highlight-3: #5f5f5f;  --highlight-4: #b0b0b0;
-  --signal-error: #c62828;  /* the ONE colour in the wireframe (Lh 2026-09-24): something went wrong — a field's edge, the words that say what. Always with an icon and words, never the colour alone */
+  --signal-error: #c62828;  /* something went wrong — a field's edge, the words that say what */
 
   /* derived tints — read the element's own ink, so they work on any slot */
   --outline: var(--action-border);                                 /* control edges (palette.css softens) */
@@ -285,6 +288,14 @@
    bars take over the page when the app runs edge to edge (viewport-fit=cover: Android Chrome, an iPhone home-screen app).
    PUBLISHED: backgrounds still run to the edge; what the member reads or taps stands clear of them. 0 without cover.
    --_safe-b-open = the bottom inset the keyboard does NOT already cover (a keyboard up hides the gesture bar). */
+/* a signal's SOFT ground: the signal washed 14% into the surface (tone 2's formula) — what a Snackbar stands on. Re-derived where a
+   palette is set, so a palette's own signal shade gives its own soft */
+:root, [data-palette] {
+  --signal-ok-soft: color-mix(in srgb, var(--signal-ok) 14%, var(--surface));
+  --signal-warn-soft: color-mix(in srgb, var(--signal-warn) 14%, var(--surface));
+  --signal-error-soft: color-mix(in srgb, var(--signal-error) 14%, var(--surface));
+  --signal-info-soft: color-mix(in srgb, var(--signal-info) 14%, var(--surface));
+}
 :root { --safe-top: env(safe-area-inset-top, 0px); --safe-bottom: env(safe-area-inset-bottom, 0px); }
 * { --_safe-b-open: max(0px, var(--safe-bottom) - var(--kb, 0px)); }
 
@@ -2234,6 +2245,11 @@ button:enabled { cursor: pointer; } /* a disabled one keeps the arrow */
    The drop: a line box is centred on its ascender room (Thai marks), the letters beside the dot sit lower — the dot rides down to the
    letters' own middle, in em so it follows the text size (Lh 2026-09-22: "ตัวหนังสือกับไฟเสมอกัน") */
 .dot--b { background: var(--dot-b); }
+/* the signal set on a dot (Lh 2026-10-02): the words beside it say what — never the colour alone */
+.dot--ok { background: var(--signal-ok); }
+.dot--warn { background: var(--signal-warn); }
+.dot--error { background: var(--signal-error); }
+.dot--info { background: var(--signal-info); }
 .chip--on { background: var(--chip-on-bg, var(--accent)); color: var(--chip-on-ink, var(--on-accent)); border-color: transparent; }
 /* muted: an untouched default — the words wash out, the edge stays; emphasis is the difference from the neighbours (README 13) */
 .chip--muted { color: var(--chip-muted-ink, var(--card-muted)); }
@@ -2414,7 +2430,7 @@ button:enabled { cursor: pointer; } /* a disabled one keeps the arrow */
    pointer, no press, --off. Zero specificity everywhere: a component's own rule always wins. A NEW control joins a list here. */
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item) {
+  a.avatar, button.avatar, .menu__item, button.snackbar__body) {
   cursor: pointer;
   touch-action: manipulation;
   transition: scale var(--motion-press) ease-out;
@@ -2433,7 +2449,7 @@ button:enabled { cursor: pointer; } /* a disabled one keeps the arrow */
 }
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item):active:not(:disabled, [aria-disabled="true"], :has(:disabled)) { scale: var(--press-scale); }
+  a.avatar, button.avatar, .menu__item, button.snackbar__body):active:not(:disabled, [aria-disabled="true"], :has(:disabled)) { scale: var(--press-scale); }
 :where(a.row, button.row, label.row, .row-expand > summary, .banner__summary, a.card, label.card, .toggle-field):active:not([aria-disabled="true"], :has(:disabled)) { opacity: var(--press-dim); }
 .sheet-step:has(> .sheet-step__go:active) { opacity: var(--press-dim); } /* the step bar's button is invisible over it: the bar answers */
 /* SHADE — what has something BEHIND it (a peeked sheet over the pile, a postcard's face over its back) must not turn see-through:
@@ -2443,17 +2459,17 @@ button:enabled { cursor: pointer; } /* a disabled one keeps the arrow */
 /* the focus ring: on the control, or on the label that wraps a hidden input (chip, tile, file button, a row that is a label) */
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item):focus-visible,
+  a.avatar, button.avatar, .menu__item, button.snackbar__body):focus-visible,
 :where(.chip--pick, .tile--pick, label.btn, label.row, .toggle-field):has(:focus-visible) { outline: var(--focus); outline-offset: var(--sp-1); }
 :where(a.row, button.row, label.row, .row-expand > summary, .banner__summary, a.card, label.card, .toggle-field):not(label, .toggle-field):focus-visible { outline: var(--focus); outline-offset: var(--sp-1); }
 /* disabled: no pointer anywhere; a control fades (a link and a row keep their own muted look) */
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item, a.row, button.row, label.row, .row-expand > summary, .banner__summary, a.card, label.card, .toggle-field):is(:disabled, [aria-disabled="true"]),
+  a.avatar, button.avatar, .menu__item, button.snackbar__body, a.row, button.row, label.row, .row-expand > summary, .banner__summary, a.card, label.card, .toggle-field):is(:disabled, [aria-disabled="true"]),
 :where(.chip--pick, .tile--pick, .mood__opt, .toggle-field, label.btn, label.row):has(:disabled) { cursor: default; }
 :where(.btn, .icon-btn, .link, a.chip, button.chip, .chip--pick, a.tile, button.tile, .tile--pick, .day, .segment__item, .calendar__day,
   .float-bar__item, .avatar-pick__item, .add-row, .picker__item, .dropdown__btn, .appbar__who, .check, .toggle, .mood__opt, .sheet__handle,
-  a.avatar, button.avatar, .menu__item):not(.link):is(:disabled, [aria-disabled="true"]),
+  a.avatar, button.avatar, .menu__item, button.snackbar__body):not(.link):is(:disabled, [aria-disabled="true"]),
 :where(.chip--pick, .tile--pick, .mood__opt, .toggle-field, label.btn):has(:disabled) { opacity: var(--off); }
 .sheet-stack--tap > .card > .card__head > :is(h1, h2, h3):focus-visible { outline: var(--focus); outline-offset: var(--sp-1); } /* the keyboard's way into a stack sheet */
 @media (prefers-reduced-motion: reduce) { :root { --press-scale: 1; } } /* the give goes; the dim, the shade and the focus ring stay */
@@ -3935,4 +3951,39 @@ button:enabled { cursor: pointer; } /* a disabled one keeps the arrow */
 .splash__mark > * { display: block; width: 100%; height: auto; }
 .splash__text { margin: 0; font: var(--type-body); color: var(--splash-text-ink, var(--on-surface-muted)); }
 @media (prefers-reduced-motion: reduce) { .splash { transition: none; } }
+/* ---- snackbar: a quick good-news line over the screen — slides in, stays a moment, slides out (Lh 2026-10-02) ----
+   <div class="snackbar snackbar--open" role="status"><div class="snackbar__body"><svg class="icon"/>
+     <span class="snackbar__words"><span class="snackbar__text">…</span><span class="snackbar__caption">…</span></span></div></div>
+   A LAYER of the screen (its child), over the top bar; --bottom = at the foot, above the screen's bottom layer (--bottom-h).
+   Its ground is the OK signal's soft ground (--signal-ok-soft), its glyph the signal itself: the sign that it went right. Rigid like a sheet: `translate` only. `button.snackbar__body` = it can be tapped. Never a warning — that is a Modal. */
+.snackbar {
+  --_out: -1;
+  position: fixed; inset-inline: 0; top: calc(var(--sp-3) + var(--safe-top));
+  max-width: var(--screen-w); margin-inline: auto; padding-inline: var(--screen-pad, var(--sp-4));
+  display: grid; justify-items: center;
+  z-index: calc(var(--z-top) + 1);
+  pointer-events: none; visibility: hidden;
+  translate: 0 calc(var(--_out) * (100% + var(--sp-8) + var(--safe-top)));
+  transition: translate var(--motion-sheet) ease, visibility 0s var(--motion-sheet);
+}
+.screen--fill > .snackbar, .sheet-stage > .snackbar { position: absolute; }
+.snackbar--bottom { --_out: 1; top: auto; bottom: calc(var(--sp-3) + var(--bottom-h, 0px) + max(var(--safe-bottom), var(--kb, 0px))); }
+.snackbar--open { translate: 0; visibility: visible; transition-delay: 0s; }
+.snackbar__body {
+  display: flex; align-items: center; gap: var(--snackbar-gap, var(--sp-3));
+  max-width: 100%; min-height: var(--snackbar-min-h, var(--tap));
+  padding: var(--snackbar-pad-y, var(--sp-2)) var(--snackbar-pad-x, var(--sp-5));
+  border: var(--border-w) solid var(--snackbar-border, transparent);
+  border-radius: var(--snackbar-radius, var(--r-card));
+  background: var(--snackbar-bg, var(--signal-ok-soft));
+  color: var(--snackbar-ink, var(--on-surface));
+  box-shadow: var(--snackbar-shadow, var(--shadow-float));
+  font: inherit; text-align: start;
+  pointer-events: auto;
+}
+.snackbar__body > .icon { flex: none; color: var(--snackbar-icon-ink, var(--signal-ok)); }
+.snackbar__words { display: grid; min-width: 0; overflow-wrap: anywhere; }
+.snackbar__text { font: var(--snackbar-text-font, var(--type-body)); }
+.snackbar__caption { font: var(--snackbar-caption-font, var(--type-caption)); opacity: var(--dim); }
+@media (prefers-reduced-motion: reduce) { .snackbar { transition: none; } }
 

package/dist/index.d.ts

@@ -79,6 +79,7 @@ export * from './media/Tile.js';
 export * from './media/Mosaic.js';
 export * from './layover/Banner.js';
 export * from './layover/Callout.js';
+export * from './layover/Snackbar.js';
 export * from './journey/Route.js';
 export * from './journey/TileBadge.js';
 export * from './journey/NoteRow.js';

package/dist/index.js

@@ -83,6 +83,7 @@ export * from './media/Tile.js';
 export * from './media/Mosaic.js';
 export * from './layover/Banner.js';
 export * from './layover/Callout.js';
+export * from './layover/Snackbar.js';
 export * from './journey/Route.js';
 export * from './journey/TileBadge.js';
 export * from './journey/NoteRow.js';

package/dist/layover/Snackbar.d.ts

@@ -0,0 +1,30 @@
+import { type ComponentProps, type ReactNode } from 'react';
+import type { IconName } from '../type/icons.js';
+export type SnackbarReason = 'timeout' | 'tap';
+export interface SnackbarProps extends Omit<ComponentProps<'div'>, 'onClick'> {
+    /** CONTROLLED: in sight — with `onOpenChange`; or `defaultOpen` */
+    open?: boolean;
+    /** UNCONTROLLED: starts in sight (default true — mounting it is showing it) */
+    defaultOpen?: boolean;
+    /** it asks to leave: its time is up (`timeout`) or it was tapped (`tap`) */
+    onOpenChange?: (open: boolean, reason: SnackbarReason) => void;
+    /** how long it stays, in ms (default 4000); 0 = until the app closes it */
+    duration?: number;
+    /** the glyph before the words — `check` by default (it went right); `false` = none */
+    icon?: IconName | false;
+    /** a second, smaller line under the words */
+    caption?: ReactNode;
+    /** at the screen's foot, above its bottom layer, instead of the top */
+    bottom?: boolean;
+    /** the member tapped it (the app opens what it tells about — its notification); it then asks to leave */
+    onTap?: () => void;
+    /** it has slid out: the app unmounts it now, or shows the next one */
+    onClosed?: () => void;
+}
+/**
+ * Snackbar — a quick GOOD-NEWS line laid over the screen: something went well, said in passing: a check and the words on the soft tone. It slides in from the screen's top
+ * (or `bottom`), stays `duration`, slides out, never takes the cursor and never stops the member. Not for a warning or a question —
+ * that is a `Modal`. A child of the `Screen`. Controlled like an input: `open` + `onOpenChange(open, reason)`, or `defaultOpen`;
+ * ONE at a time — the queue is the app's (what it shows is the app's own notification, kept in the app's list; a tap = `onTap`).
+ */
+export declare function Snackbar({ open, defaultOpen, onOpenChange, duration, icon, caption, bottom, onTap, onClosed, className, children, ...rest }: SnackbarProps): import("react").JSX.Element;

package/dist/layover/Snackbar.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { cx } from '../cx.js';
+import { Icon } from '../type/Icon.js';
+import { reducedMotion, useControlled, useLatest } from '../state.js';
+/**
+ * Snackbar — a quick GOOD-NEWS line laid over the screen: something went well, said in passing: a check and the words on the soft tone. It slides in from the screen's top
+ * (or `bottom`), stays `duration`, slides out, never takes the cursor and never stops the member. Not for a warning or a question —
+ * that is a `Modal`. A child of the `Screen`. Controlled like an input: `open` + `onOpenChange(open, reason)`, or `defaultOpen`;
+ * ONE at a time — the queue is the app's (what it shows is the app's own notification, kept in the app's list; a tap = `onTap`).
+ */
+export function Snackbar({ open, defaultOpen = true, onOpenChange, duration = 4000, icon = 'check', caption, bottom, onTap, onClosed, className, children, ...rest }) {
+    const [shown, request] = useControlled(open, defaultOpen, onOpenChange);
+    const [entered, setEntered] = useState(false); // its first frame is out of sight, so one mounted open slides in
+    const closed = useLatest(onClosed);
+    const up = shown && entered;
+    useEffect(() => { const f = requestAnimationFrame(() => setEntered(true)); return () => cancelAnimationFrame(f); }, []);
+    useEffect(() => {
+        if (!up || !duration)
+            return;
+        const t = setTimeout(() => request(false, 'timeout'), duration);
+        return () => clearTimeout(t);
+    }, [up, duration, request]);
+    useEffect(() => {
+        if (shown || !entered)
+            return;
+        const ms = reducedMotion() ? 0 : parseFloat(getComputedStyle(document.documentElement).getPropertyValue('--motion-sheet')) * 1000 || 350;
+        const t = setTimeout(() => closed.current?.(), ms);
+        return () => clearTimeout(t);
+    }, [shown, entered]);
+    const words = (_jsxs(_Fragment, { children: [icon && _jsx(Icon, { name: icon }), _jsxs("span", { className: "snackbar__words", children: [_jsx("span", { className: "snackbar__text", children: children }), caption != null && _jsx("span", { className: "snackbar__caption", children: caption })] })] }));
+    return (_jsx("div", { className: cx('snackbar', bottom && 'snackbar--bottom', up && 'snackbar--open', className), role: "status", "aria-live": "polite", inert: !up, ...rest, children: onTap
+            ? _jsx("button", { type: "button", className: "snackbar__body", onClick: () => { onTap(); request(false, 'tap'); }, children: words })
+            : _jsx("div", { className: "snackbar__body", children: words }) }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usableapp/cardds",
-  "version": "0.7.42",
+  "version": "0.7.44",
   "license": "UNLICENSED",
   "type": "module",
   "description": "card-first mobile design system, React-first: the components in src/ are thin wrappers over the CSS contract (css/*.css stays the only truth); gallery/ shows every story live (npm run dev), tests/ measures the geometry.",