@ashley-shrok/viewmodel-shell 5.2.0 → 6.1.0

package/dist/browser.js

@@ -954,8 +954,8 @@ export class BrowserAdapter {
         parent.appendChild(el);
     }
     list(n, parent, on) {
-        const ul = document.createElement("ul");
-        ul.className = "vms-list";
+        const ul = document.createElement(n.ordered ? "ol" : "ul");
+        ul.className = `vms-list${n.ordered ? " vms-list--ordered" : ""}`;
         if (n.id)
             ul.id = n.id;
         this.kids(n.children, ul, on);
@@ -2880,10 +2880,12 @@ export class BrowserAdapter {
         bar.className = "vms-stat-bar";
         n.stats.forEach(stat => {
             const item = document.createElement("div");
-            item.className = "vms-stat-bar__item";
+            item.className = stat.tone
+                ? `vms-stat-bar__item vms-stat-bar__item--toned vms-stat-bar__item--tone-${stat.tone}`
+                : "vms-stat-bar__item";
             const val = document.createElement("span");
             val.className = "vms-stat-bar__value";
-            val.textContent = String(stat.value);
+            val.textContent = stat.value;
             const lbl = document.createElement("span");
             lbl.className = "vms-stat-bar__label";
             lbl.textContent = stat.label;
@@ -3405,7 +3407,9 @@ export class BrowserAdapter {
         n.steps.forEach((step, i) => {
             const state = i < n.current ? "done" : i === n.current ? "current" : "upcoming";
             const li = document.createElement("li");
-            li.className = `vms-steps__step vms-steps__step--${state}`;
+            li.className = step.tone
+                ? `vms-steps__step vms-steps__step--${state} vms-steps__step--toned vms-steps__step--tone-${step.tone}`
+                : `vms-steps__step vms-steps__step--${state}`;
             if (state === "current")
                 li.setAttribute("aria-current", "step");
             // Connector — CSS-drawn line marker-center to marker-center, behind the

package/dist/index.d.ts

@@ -233,6 +233,14 @@ export interface SectionNode {
 export interface ListNode {
     type: "list";
     id?: string;
+    /** When true, this is an ORDERED list — renders `<ol>` (numbered) instead of
+     *  `<ul>`. The semantic element gives real ordinal meaning (a11y: screen
+     *  readers announce position/count; agent-legibility: the order is structural,
+     *  not baked into item text). The visible "1." / "2." markers come from a CSS
+     *  counter (`.vms-list--ordered`), not native list markers, because `.vms-list`
+     *  is a flex column with `list-style:none` — so numbering survives the styled
+     *  list-item layout. Omitted/false = `<ul>` (byte-identical to today). */
+    ordered?: boolean;
     children: ViewNode[];
 }
 export interface ListItemNode {
@@ -722,7 +730,21 @@ export interface StatBarNode {
     type: "stat-bar";
     stats: Array<{
         label: string;
-        value: string | number;
+        /** The stat's value. Typed `string` (not `string | number`) so the TS and
+         *  .NET backends emit BYTE-IDENTICAL wire — a bare number would serialize as
+         *  JSON `12` in TS but the .NET twin's `string Value` can only emit `"12"`,
+         *  a real cross-backend drift the parity suite never exercised. Format the
+         *  number server-side (`String(n)`, `n.toFixed(2)`, `$${n}`) — the value is
+         *  display text, and any formatting an app wants is richer than a bare
+         *  number anyway. (Narrowed in 6.0.0 — see CHANGELOG; the field was unused.) */
+        value: string;
+        /** Optional semantic status tone for this tile — the universal status color
+         *  axis (same closed set as Section/Button/ListItem/TableRow). Renders the
+         *  tile as a subtly tinted chip (surface tint + colored border, reusing the
+         *  --vms-error/-warning/-success/-info tokens), so an unhealthy stat reads at
+         *  a glance rather than via one small line of text. Omitted = today's neutral
+         *  inline stat. Closed union. */
+        tone?: "danger" | "warning" | "success" | "info";
     }>;
 }
 export interface TabsNode {
@@ -993,6 +1015,16 @@ export interface StepItem {
     label: string;
     /** Optional one-line supporting text shown beside/under the label. */
     description?: string;
+    /** Optional semantic status tone for this step — the universal status color
+     *  axis (same closed set as Section/Button/ListItem/TableRow). ORTHOGONAL to
+     *  the done/current/upcoming state the framework DERIVES from `current`: tone
+     *  overlays a semantic color onto the marker (e.g. a failed/blocked stage read
+     *  as `danger`, a stage needing attention as `warning`) regardless of its
+     *  position in the sequence. Omitted = the derived state's default appearance
+     *  (accent for done/current, muted for upcoming). Because tone is app-authored
+     *  status reinforced by the step's own label text, it is NOT color-only (same
+     *  posture as Section tone). Closed union. */
+    tone?: "danger" | "warning" | "success" | "info";
 }
 /** A discrete step / stepper / wizard progress indicator — an ordered list of
  *  stages with a single 0-based `current` index. Per-step status DERIVES from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ashley-shrok/viewmodel-shell",
-  "version": "5.2.0",
+  "version": "6.1.0",
   "description": "A server-driven UI framework where the wire format is structured enough that agents can build full-stack apps without ever opening a browser and all UI tests are pure unit tests with no browser runtime. Server returns a JSON tree of typed nodes; a thin TypeScript adapter renders it to DOM. Backend-agnostic \u2014 a .NET reference backend ships with the repo, but any language can produce the JSON contract.",
   "type": "module",
   "license": "MIT",
@@ -31,6 +31,8 @@
   "scripts": {
     "build": "tsc -b tsconfig.tui.json",
     "check:core-globals": "node scripts/check-core-platform-globals.mjs",
+    "check:test-types": "tsc -p tsconfig.test.json --noEmit",
+    "check:demo-types": "node scripts/check-demo-types.mjs",
     "check:aa-contrast": "node scripts/check-aa-contrast.mjs",
     "check:no-demo-style": "node scripts/check-no-demo-style.mjs",
     "check:theme-byte-identity": "node scripts/check-theme-byte-identity.mjs",

package/styles/default.css

@@ -29,6 +29,21 @@
   --vms-error:       #c2453d;
   --vms-error-glow:  rgba(194, 69, 61, 0.10);
   --vms-warning:       #8a630d;
+  /* Warning is the ONE tone with a polarity split. --vms-warning is deliberately
+     DARK on light themes because it doubles as a TEXT/border color (.vms-text--warning,
+     button/badge outline) and warning-colored TEXT on a light surface must be dark to
+     clear WCAG-AA — a bright yellow text on white is unreadable. But a warning FILL has
+     no such constraint: the standard design-system pattern (Bootstrap/Material) is a
+     BRIGHT yellow fill with a DARK foreground. --vms-warning-fill + --vms-on-warning-fill
+     are that pair — used on every SOLID warning fill (toast, primary badge/button, the
+     toned steps marker) so warning actually reads as a yellow that grabs attention on
+     light themes, while staying AA (dark #2a2205 on #e0a823 = 7.37:1). Theme-independent
+     (a solid amber fill reads the same on any page surface); dark themes need no override
+     — their --vms-warning is already #e0a823, so this ALSO fixes the white-on-bright-amber
+     fill that failed AA on dark themes (2.14:1). Tints (section/table/chip) keep the base
+     --vms-warning as their own consistent family. */
+  --vms-warning-fill:    #e0a823;
+  --vms-on-warning-fill: #2a2205;
   --vms-priority-high: #d76410;
   --vms-success:       #2da359;
   --vms-info:          #2277dd;
@@ -473,6 +488,32 @@ body:has(.vms-page--fill) { margin: 0; }
   text-transform: uppercase;
   letter-spacing: 0.05em;
 }
+/* Per-tile tone (StatItem.tone) — a toned stat becomes a subtly tinted chip
+   (surface tint + colored border, the SAME color-mix formula as Section tone, so
+   it inherits that surface's already-AA-cleared text contrast) so an unhealthy
+   stat reads at a glance. Only toned items get the chip surface; neutral items
+   stay byte-identical to today's inline stat. --_tone resolves per tone below. */
+.vms-stat-bar__item--tone-danger  { --_tone: var(--vms-error); }
+.vms-stat-bar__item--tone-warning { --_tone: var(--vms-warning); }
+.vms-stat-bar__item--tone-success { --_tone: var(--vms-success); }
+.vms-stat-bar__item--tone-info    { --_tone: var(--vms-info); }
+.vms-stat-bar__item--toned {
+  align-items: center;
+  gap: var(--vms-space-2xs);
+  padding: var(--vms-space-2xs) var(--vms-space-sm);
+  border: 1px solid var(--_tone);
+  border-radius: var(--vms-radius-md);
+  background: color-mix(in srgb, var(--_tone) 14%, var(--vms-surface));
+}
+/* The tint + border carry the status (the Section-tone model); the value + label
+   stay NEUTRAL and readable rather than tone-colored — tone text on its own 14%
+   tint fails WCAG-AA (success bottomed at 2.79:1 across the light themes), while
+   neutral text on the tint clears it exactly as Section tone's neutral text does. */
+.vms-stat-bar__item--toned .vms-stat-bar__value { color: var(--vms-text); }
+/* Label strengthens from muted to full text on a toned chip: muted on the 14%
+   tint bottoms at 4.21:1 (just under the 4.5 AA-text bar), and an emphasized chip
+   reads better with a solid label anyway. Full text on the tint is 11.14:1. */
+.vms-stat-bar__item--toned .vms-stat-bar__label { color: var(--vms-text); }
 
 /* ── Form ── */
 .vms-form { display: flex; flex-direction: column; gap: var(--vms-space-sm); align-items: stretch; }
@@ -875,6 +916,16 @@ select.vms-field__input  { cursor: pointer; padding-right: var(--vms-space-xl);
   border-color: var(--_btn-tone);
   color: #fff;
 }
+/* Warning is the polarity exception: a filled warning button uses the bright fill +
+   dark label (white on warning fails AA — 3.2/2.14:1 light/dark; see --vms-warning-fill).
+   Border matches the fill (no rim) — same as every other primary tone, which is the
+   conventional filled-warning look (cf. Bootstrap .btn-warning). The dark label + filled
+   shape identify the control; a dark rim read as out-of-place next to danger/success/info. */
+.vms-button--warning.vms-button--primary {
+  background: var(--vms-warning-fill);
+  border-color: var(--vms-warning-fill);
+  color: var(--vms-on-warning-fill);
+}
 .vms-button--primary:hover { filter: brightness(1.1); }
 .vms-button--secondary {
   background: transparent;
@@ -992,6 +1043,22 @@ select.vms-field__input  { cursor: pointer; padding-right: var(--vms-space-xl);
 .vms-list-item--success:hover { border-left-color: var(--vms-success); }
 .vms-list-item--info:hover    { border-left-color: var(--vms-info); }
 
+/* Ordered list — <ol>. `.vms-list` sets list-style:none for the styled
+   flex-column layout, so native markers never show; a CSS counter supplies the
+   number as the first flex child of each item (spaced by the item's own gap).
+   tabular-nums + right-aligned min-width keeps multi-digit numbers aligned. */
+.vms-list--ordered { counter-reset: vms-li; }
+.vms-list--ordered > .vms-list-item { counter-increment: vms-li; }
+.vms-list--ordered > .vms-list-item::before {
+  content: counter(vms-li) ".";
+  flex: 0 0 auto;
+  min-width: 1.5em;
+  text-align: right;
+  font-variant-numeric: tabular-nums;
+  font-weight: 600;
+  color: var(--vms-text-muted);
+}
+
 /* Selection state for master-detail / list-detail patterns (D-27). The
    currently-selected row. Stronger than the semantic hints (selection is
    the primary state) and stable through hover. Themable: uses only seam
@@ -1328,7 +1395,10 @@ select.vms-field__input  { cursor: pointer; padding-right: var(--vms-space-xl);
    success/info are deepened (color-mix w/ black) so white at 14px also clears
    4.5:1 (their pure tokens sit at 3.2 / 4.4:1). */
 .vms-toast--danger  { background: var(--vms-error);   color: #fff; }
-.vms-toast--warning { background: var(--vms-warning); color: #fff; }
+/* Warning uses the bright fill + dark foreground (see --vms-warning-fill): white on
+   the dark #8a630d was muddy on light and white on the bright #e0a823 fails AA on dark
+   (2.14:1). Dark text on the bright fill is 7.37:1 and reads as an attention-grabbing yellow. */
+.vms-toast--warning { background: var(--vms-warning-fill); color: var(--vms-on-warning-fill); }
 .vms-toast--success { background: color-mix(in srgb, var(--vms-success) 80%, #000); color: #fff; }
 .vms-toast--info    { background: color-mix(in srgb, var(--vms-info) 88%, #000);    color: #fff; }
 /* fade-out applied just before removal. */
@@ -1403,6 +1473,14 @@ select.vms-field__input  { cursor: pointer; padding-right: var(--vms-space-xl);
   border-color: var(--_badge-tone);
   color: #fff;
 }
+/* Warning polarity exception: a filled warning badge uses the bright fill + dark text
+   (white on warning fails AA; see --vms-warning-fill). Border matches the fill (no rim),
+   like every other primary tone. */
+.vms-badge--warning.vms-badge--primary {
+  background: var(--vms-warning-fill);
+  border-color: var(--vms-warning-fill);
+  color: var(--vms-on-warning-fill);
+}
 .vms-badge--secondary {
   background: transparent;
   border-color: var(--_badge-tone);
@@ -1530,6 +1608,52 @@ button.vms-breadcrumb__link {
 }
 .vms-steps__label { color: var(--vms-text); font-weight: 600; }
 .vms-steps__description { color: var(--vms-text-muted); font-size: var(--vms-text-xs); }
+/* Per-step tone (StepItem.tone) — overlays the universal status color onto the
+   marker, ORTHOGONAL to the derived done/current/upcoming treatment: the tone
+   recolors whatever the state already does (filled states fill in the tone;
+   upcoming stays outlined but in the tone), so a failed/blocked stage reads red
+   without losing the reached/not-reached distinction. Two-class selectors
+   outspecify the base state rules. The knockout glyph stays --vms-surface
+   (polarity-adaptive, >=3:1 on the filled tone tokens across all themes — a
+   graphical indicator whose state also rides aria-label + glyph + label text). */
+.vms-steps__step--tone-danger  { --_tone: var(--vms-error); }
+.vms-steps__step--tone-warning { --_tone: var(--vms-warning); }
+.vms-steps__step--tone-success { --_tone: var(--vms-success); }
+.vms-steps__step--tone-info    { --_tone: var(--vms-info); }
+/* Tone recolors the DERIVED treatment: filled states (done/current) fill in the tone;
+   upcoming stays outlined but in the tone — preserving the reached/not-reached read while
+   overlaying status color. Two-class selectors outspecify the base state rules. */
+.vms-steps__step--toned.vms-steps__step--done .vms-steps__marker,
+.vms-steps__step--toned.vms-steps__step--current .vms-steps__marker {
+  background: var(--_tone);
+  border-color: var(--_tone);
+  color: var(--vms-surface);
+}
+.vms-steps__step--toned.vms-steps__step--upcoming .vms-steps__marker {
+  border-color: var(--_tone);
+  color: var(--_tone);
+}
+.vms-steps__step--toned.vms-steps__step--current .vms-steps__marker {
+  box-shadow: 0 0 0 4px color-mix(in srgb, var(--_tone) 30%, transparent);
+}
+/* Warning FILLED (done/current): bright fill + dark glyph, no rim (see --vms-warning-fill). */
+.vms-steps__step--tone-warning.vms-steps__step--done .vms-steps__marker,
+.vms-steps__step--tone-warning.vms-steps__step--current .vms-steps__marker {
+  background: var(--vms-warning-fill);
+  border-color: var(--vms-warning-fill);
+  color: var(--vms-on-warning-fill);
+}
+/* Warning UPCOMING (outline): try the BRIGHT amber for the ring + number rather than the
+   dark --vms-warning. Bright amber as a line/digit on white is ~2.14:1 (below the strict
+   bar), so this is a judgment call on visual legibility — the step's state is multi-channel
+   (aria-label + number + position), so color is not its sole carrier. */
+.vms-steps__step--tone-warning.vms-steps__step--upcoming .vms-steps__marker {
+  border-color: var(--vms-warning-fill);
+  color: var(--vms-warning-fill);
+}
+.vms-steps__step--tone-warning.vms-steps__step--current .vms-steps__marker {
+  box-shadow: 0 0 0 4px color-mix(in srgb, var(--vms-warning-fill) 35%, transparent);
+}
 
 /* Connector — the OUTGOING segment from this marker toward the next (hidden on
    the last step). Colored by the step's own state: accent once the step is done,