@usableapp/cardds 0.7.43 → 0.7.44

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 > 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

package/README.md

@@ -306,6 +306,11 @@ 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` +
@@ -623,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)); }

package/css/layover.css

@@ -312,7 +312,7 @@
    <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).
-   Rigid like a sheet: `translate` only. `button.snackbar__body` = it can be tapped. Never a warning — that is a Modal. */
+   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));
@@ -330,15 +330,15 @@
   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, var(--action-border));
+  border: var(--border-w) solid var(--snackbar-border, transparent);
   border-radius: var(--snackbar-radius, var(--r-card));
-  background: var(--snackbar-bg, var(--action-bg));
-  color: var(--snackbar-ink, var(--action-ink));
+  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; }
+.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); }

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)); }
@@ -3939,7 +3955,7 @@ button:enabled { cursor: pointer; } /* a disabled one keeps the arrow */
    <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).
-   Rigid like a sheet: `translate` only. `button.snackbar__body` = it can be tapped. Never a warning — that is a Modal. */
+   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));
@@ -3957,15 +3973,15 @@ button:enabled { cursor: pointer; } /* a disabled one keeps the arrow */
   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, var(--action-border));
+  border: var(--border-w) solid var(--snackbar-border, transparent);
   border-radius: var(--snackbar-radius, var(--r-card));
-  background: var(--snackbar-bg, var(--action-bg));
-  color: var(--snackbar-ink, var(--action-ink));
+  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; }
+.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); }

package/dist/layover/Snackbar.d.ts

@@ -10,8 +10,8 @@ export interface SnackbarProps extends Omit<ComponentProps<'div'>, 'onClick'> {
     onOpenChange?: (open: boolean, reason: SnackbarReason) => void;
     /** how long it stays, in ms (default 4000); 0 = until the app closes it */
     duration?: number;
-    /** a glyph before the words */
-    icon?: IconName;
+    /** 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 */
@@ -22,7 +22,7 @@ export interface SnackbarProps extends Omit<ComponentProps<'div'>, 'onClick'> {
     onClosed?: () => void;
 }
 /**
- * Snackbar — a quick GOOD-NEWS line laid over the screen: something went well, said in passing. It slides in from the screen's top
+ * 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`).

package/dist/layover/Snackbar.js

@@ -4,12 +4,12 @@ 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. It slides in from the screen's top
+ * 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, caption, bottom, onTap, onClosed, className, children, ...rest }) {
+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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usableapp/cardds",
-  "version": "0.7.43",
+  "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.",