eidotter 0.38.1 → 0.40.0

package/dist/components/VitalsStrip/components/VitalsStrip.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { cn } from '../../../utils/cn.js';
+import { Skeleton } from '../../Skeleton/index.js';
+import { formatValue, isKnown, resolveBand, resolveLabels } from '../../../utils/health/index.js';
+const sizeClasses = {
+    sm: 'eidotter-vitals-strip--sm gap-1 text-dos-text-xs',
+    md: 'eidotter-vitals-strip--md gap-2 text-dos-text-sm',
+    lg: 'eidotter-vitals-strip--lg gap-2 text-dos-text-md',
+};
+const valueSizeClasses = {
+    sm: 'text-dos-display-xs',
+    md: 'text-dos-display-sm',
+    lg: 'text-dos-display-md',
+};
+const toneClasses = {
+    neutral: 'eidotter-tone--neutral',
+    info: 'eidotter-tone--info',
+    success: 'eidotter-tone--success',
+    warning: 'eidotter-tone--warning',
+    critical: 'eidotter-tone--critical',
+};
+const statusClasses = {
+    ok: '',
+    loading: 'eidotter-vitals-strip__tile--loading',
+    empty: 'eidotter-vitals-strip__tile--empty',
+    stale: 'eidotter-vitals-strip__tile--stale',
+    unknown: 'eidotter-vitals-strip__tile--unknown',
+};
+/** Replacement text for a tile with no value: loading, then offline, then unknown; else null. */
+function tileStateText(flags, labels) {
+    if (flags.loading)
+        return labels.unknown;
+    if (flags.offline)
+        return labels.offline;
+    if (flags.unknown)
+        return labels.unknown;
+    return null;
+}
+/**
+ * Monitor strip of vital tiles. Tiles are rendered here with Stat's size and
+ * text token classes rather than by importing Stat, which is a client
+ * component (KTD4). Presentational and hook-free, so it stays server-safe.
+ */
+export const VitalsStrip = forwardRef(({ tiles, size = 'md', locale = 'en', labels: labelOverrides, className, ...props }, ref) => {
+    const labels = resolveLabels(labelOverrides);
+    return (_jsx("div", { ref: ref, className: cn('eidotter-vitals-strip eidotter-health flex flex-wrap w-full font-dos', sizeClasses[size] ?? sizeClasses.md, className), ...props, children: tiles.map((t) => {
+            const status = t.status ?? 'ok';
+            const loading = status === 'loading';
+            const raw = t.pair ? t.pair[0] : t.value;
+            const known = t.pair ? isKnown(t.pair[0]) && isKnown(t.pair[1]) : isKnown(t.value);
+            const offline = status === 'empty' || (status === 'ok' && !t.pair && t.value === null);
+            const unknown = offline || status === 'unknown' || !known;
+            const stale = status === 'stale' && !unknown;
+            const resolved = resolveBand(unknown ? null : raw, t.bands, t.unit);
+            const tone = t.tone ?? resolved.tone;
+            const valueText = unknown
+                ? null
+                : t.pair
+                    ? formatValue(t.pair[0], { locale, max: t.pair[1] }).text
+                    : formatValue(t.value, { locale }).text;
+            const stateText = tileStateText({ loading, offline, unknown }, labels);
+            const name = [
+                `${t.label}: ${stateText ?? [valueText, t.unit].filter(Boolean).join(' ')}`,
+                stale && labels.stale,
+            ]
+                .filter(Boolean)
+                .join(', ');
+            return (_jsxs("div", { role: "group", "aria-label": name, "aria-busy": loading || undefined, className: cn('eidotter-vitals-strip__tile flex flex-col gap-0.5 border border-dos-border-default p-2', toneClasses[tone], statusClasses[status], tone === 'critical' &&
+                    'eidotter-vitals-strip__marker border-l-4 border-dos-border-error'), children: [_jsxs("span", { className: "flex items-center gap-1 text-dos-text-brand uppercase tracking-wider leading-tight", children: [tone === 'critical' && (_jsx("span", { "aria-hidden": "true", className: "text-dos-text-error", children: "\u25B2" })), _jsx("span", { className: "truncate", title: t.label, children: t.label })] }), loading ? (_jsx("div", { "aria-hidden": "true", className: "w-full overflow-hidden", children: _jsx(Skeleton, { variant: "figure", lines: 1, animated: false }) })) : (_jsxs("span", { className: cn('eidotter-vitals-strip__value text-dos-text-accent leading-none tabular-nums', valueSizeClasses[size] ?? valueSizeClasses.md), children: [stale ? _jsx("span", { className: "opacity-60", children: valueText }) : (stateText ?? valueText), valueText && t.unit && (_jsx("span", { className: "eidotter-vitals-strip__unit ml-1 text-[0.5em] text-dos-text-brand", children: t.unit }))] })), stale && _jsx("span", { className: "eidotter-vitals-strip__stale", children: labels.stale }), t.secondary && !unknown && (_jsx("span", { className: "eidotter-vitals-strip__secondary text-dos-text-muted leading-tight", children: t.secondary })), resolved.label && (_jsx("span", { className: "eidotter-vitals-strip__band text-dos-text-brand leading-tight", children: resolved.label }))] }, t.id));
+        }) }));
+});
+VitalsStrip.displayName = 'VitalsStrip';

package/dist/components/VitalsStrip/components/index.d.ts

@@ -0,0 +1,2 @@
+export { VitalsStrip } from './VitalsStrip.js';
+export type { VitalsStripProps, VitalTile } from './VitalsStrip.js';

package/dist/components/VitalsStrip/components/index.js

@@ -0,0 +1 @@
+export { VitalsStrip } from './VitalsStrip.js';

package/dist/components/VitalsStrip/index.d.ts

@@ -0,0 +1,2 @@
+export { VitalsStrip } from './components/index.js';
+export type { VitalsStripProps, VitalTile } from './components/index.js';

package/dist/components/VitalsStrip/index.js

@@ -0,0 +1 @@
+export { VitalsStrip } from './components/index.js';

package/dist/components/registry.d.ts

@@ -1,4 +1,4 @@
-export type ProjectId = 'eidotter' | 'spacewar' | 'rizomorf' | 'pomodoke-calendar' | 'keepcoin' | 'steuerdash' | 'sella' | 'lifelines' | 'betamorf' | 'dmnctech' | 'tracker';
+export type ProjectId = 'eidotter' | 'spacewar' | 'rizomorf' | 'pomodoke-calendar' | 'keepcoin' | 'steuerdash' | 'sella' | 'lifelines' | 'betamorf' | 'dmnctech' | 'tracker' | 'doctor-portal' | 'dosbts';
 export interface ProjectInfo {
     displayName: string;
     url?: string;

package/dist/components/registry.js

@@ -10,6 +10,8 @@ export const projects = {
     betamorf: { displayName: 'betamorf' },
     dmnctech: { displayName: 'dmnc.tech', url: 'https://dmnc.tech' },
     tracker: { displayName: 'Tracker', url: 'https://tracker.dmnc.tech' },
+    'doctor-portal': { displayName: 'Doctor Portal' },
+    dosbts: { displayName: 'DOSBTS' },
 };
 // ---------------------------------------------------------------------------
 // Registry data
@@ -106,6 +108,7 @@ export const componentRegistry = {
             swiftui: { status: 'planned' },
         },
         changelog: [
+            { version: '0.39.0', type: 'changed', description: 'Sanitize href via shared isSafeHref — unsafe schemes (javascript:, data:, …) render the label without an anchor' },
             { version: '0.16.0', type: 'changed', description: 'Migrate to Tailwind-first (Wave 2 — Separator, Stat, Breadcrumb, Progress)' },
             { version: '0.9.0', type: 'changed', description: 'Fix trail links invisible on dark backgrounds' },
             { version: '0.3.0', type: 'added', description: 'Initial Breadcrumb — trail array, currentLabel, separator, showBackArrow' },
@@ -350,6 +353,7 @@ export const componentRegistry = {
             swiftui: { status: 'planned' },
         },
         changelog: [
+            { version: '0.40.0', type: 'changed', description: 'Add optional unit, note and target slots (additive; existing consumers unchanged)' },
             { version: '0.19.0', type: 'changed', description: 'Replace hardcoded font-size pixels with V.37 dos tokens' },
             { version: '0.16.0', type: 'changed', description: 'Migrate to Tailwind-first (Wave 2); deprecate size aliases; add size:sm/lg' },
             { version: '0.3.0', type: 'added', description: 'Initial Stat — label, value, trend, trendValue, scramble prop' },
@@ -506,6 +510,7 @@ export const componentRegistry = {
             react: { path: 'src/components/InlineExpand', status: 'canonical' },
         },
         changelog: [
+            { version: '0.40.0', type: 'changed', description: 'True inline-flow expanded state — marker-pen wrap, trailing collapse control, inline favicon-only sources; conditional render; data-ai-skip on content + legible trigger inside AI-marked prose (DMNC-1316)' },
             { version: '0.30.0', type: 'changed', description: 'Fix behavioral bugs — double-toggle edge case (DMNC-1063)' },
             { version: '0.18.0', type: 'changed', description: 'Migrate BEM to Tailwind-first' },
             { version: '0.8.0', type: 'added', description: 'sources prop — citation links with Google Favicons API fallback' },
@@ -573,8 +578,27 @@ export const componentRegistry = {
     ChatInput: { origin: 'eidotter', consumers: [], originNote: 'Multiline DOS-styled textarea with Enter-to-send' },
     ChatContainer: { origin: 'eidotter', consumers: [], originNote: 'Composes ChatHistory + ChatInput into a complete chat interface' },
     // Layout components
-    Header: { origin: 'eidotter', consumers: [], originNote: 'Sticky site header composing branding link + Nav — retro/modern variants' },
-    Footer: { origin: 'eidotter', consumers: [], originNote: 'DOS-themed footer with default legal links (Impressum + Datenschutz) for German compliance' },
+    Header: {
+        origin: 'eidotter',
+        consumers: [],
+        originNote: 'Sticky site header composing branding link + Nav — retro/modern variants; optional context row (category badge row + returnTo pill) for cross-site shells (DMNC-1326)',
+        variants: {
+            'context:categories': { description: 'Category badge row below the main row — measurable DOM target (stable eidotter-header__categories / __category classes + data-category-key) for the Mark arm-connector (DMNC-1325)', since: '0.39.0' },
+            'context:returnTo': { description: 'Breadcrumb return pill — same-tab via linkComponent by default; reuseTab navigates via window.open(href, "rizomorf-shell") named-tab reuse', since: '0.39.0' },
+        },
+        changelog: [
+            { version: '0.39.0', type: 'added', description: 'Optional `context` prop — category badge row + returnTo breadcrumb pill with reuseTab named-tab navigation (DMNC-1326)' },
+            { version: '0.39.0', type: 'changed', description: 'Sanitize brandHref via shared isSafeHref — unsafe schemes fall back to "/" (nav-item links guarded in Nav)' },
+        ],
+    },
+    Footer: {
+        origin: 'eidotter',
+        consumers: [],
+        originNote: 'DOS-themed footer with default legal links (Impressum + Datenschutz) for German compliance',
+        changelog: [
+            { version: '0.39.0', type: 'changed', description: 'Sanitize link hrefs via shared isSafeHref — unsafe schemes (javascript:, data:, …) render the label without an anchor' },
+        ],
+    },
     // Imported from April 2026 design handoff (v0.20.0)
     InlineLink: {
         origin: 'rizomorf',
@@ -583,6 +607,7 @@ export const componentRegistry = {
         originNote: 'In-flow navigational anchor — dotted amber underline, phosphor-invert hover, trailing `▸` / `↗`. Distinct from InlineExpand (destination vs disclosure). Closes rizomorf parity gap #03.',
         platforms: { react: { path: 'src/components/InlineLink', status: 'canonical' } },
         changelog: [
+            { version: '0.39.0', type: 'changed', description: 'sanitizeHref now delegates to the shared isSafeHref util (extraSchemes tel/ftp/sms); behavior unchanged' },
             { version: '0.20.0', type: 'added', description: 'Initial InlineLink — internal + external variants, tabnabbing guard when consumer passes target="_blank"' },
         ],
     },
@@ -614,6 +639,7 @@ export const componentRegistry = {
         originNote: '16-segment quantized progress ring (SVG). Powers Tracker’s hold-to-complete feedback ring.',
         platforms: { react: { path: 'src/components/ProgressRing', status: 'canonical' } },
         changelog: [
+            { version: '0.40.0', type: 'changed', description: 'Add additive decorative prop (aria-hidden, no progressbar role) so Gauge owns meter semantics' },
             { version: '0.37.0', type: 'added', description: 'Initial ProgressRing — discrete quantized segment arcs, phosphor glow, centre label, currentColor theming' },
         ],
     },
@@ -637,6 +663,232 @@ export const componentRegistry = {
             { version: '0.37.0', type: 'added', description: 'Initial HoldToComplete — rAF hold animation with accelerating ease, onHoldProgress hook, Enter/Space to complete' },
         ],
     },
+    Mark: {
+        origin: 'rizomorf',
+        consumers: ['rizomorf'],
+        since: '0.39.0',
+        originNote: 'Morphing organic avatar mark (a.k.a. RizomorfAvatar) with runtime-measured quadratic-bezier arm connectors to Header nav badges (DMNC-1325; Header badge row: DMNC-1326).',
+        variants: {
+            'morph:true': { description: 'Border-radius morph loop (~6s ease-in-out), disabled under prefers-reduced-motion', since: '0.39.0' },
+            'morph:false': { description: 'Static organic silhouette', since: '0.39.0' },
+        },
+        platforms: { react: { path: 'src/components/Brand', status: 'canonical' } },
+        changelog: [
+            { version: '0.39.0', type: 'added', description: 'Initial Mark — soft-radial egg-yolk fill + CSS border-radius morph + SVG arm connectors with alternating control-point offsets' },
+        ],
+    },
+    Connector: {
+        origin: 'eidotter',
+        consumers: [],
+        since: '0.39.0',
+        originNote: 'Organic tapered-ribbon SVG overlay (DMNC-1388) — filled variable-width paths from a source node (the Mark) to N anchors, amber→category gradient, stop-at-edge attach, ResizeObserver/MutationObserver re-flow + rAF idle sway (reduced-motion safe). Decorative/aria-hidden; content lives in the DOM underneath.',
+        variants: {
+            'weight:delicate': { description: 'Thin near-straight product-chrome thread (default)', since: '0.39.0' },
+            'weight:medium': { description: 'Bolder ribbon for large surfaces', since: '0.39.0' },
+        },
+        platforms: { react: { path: 'src/components/Connector', status: 'canonical' } },
+        changelog: [
+            { version: '0.39.0', type: 'added', description: 'Initial Connector — tapered filled-path ribbons, per-target amber→category gradient, attach-at-edge geometry, idle sway' },
+        ],
+    },
+    TimelineFeed: {
+        origin: 'eidotter',
+        consumers: [],
+        since: '0.39.0',
+        originNote: 'Dense product-grade feed (the "J" layout) — category dot · date · title · outlined kind-tag rows threaded by a thin amber spine, with a category chip row that culls the list. Shares the TimelineEntryData model with TimelineContainer.',
+        platforms: { react: { path: 'src/components/TimelineFeed', status: 'canonical' } },
+        changelog: [
+            { version: '0.39.0', type: 'added', description: 'Initial TimelineFeed — dense category-dotted rows, amber-mono, controllable category filter' },
+        ],
+    },
+    TimelinePage: {
+        origin: 'eidotter',
+        consumers: [],
+        since: '0.39.0',
+        originNote: 'Bret-Victor-style blog timeline (the "K2" layout) — year-grouped, amber-only spine + dots, neutral dates, big titles + description, right-hand hover preview panel, optional Mark brand slot + category filter. Shares the TimelineEntryData model with TimelineContainer.',
+        platforms: { react: { path: 'src/components/TimelinePage', status: 'canonical' } },
+        changelog: [
+            { version: '0.39.0', type: 'added', description: 'Initial TimelinePage — grouped blog timeline with hover-preview panel and category filter' },
+        ],
+    },
+    Gauge: {
+        origin: 'eidotter',
+        consumers: ['doctor-portal', 'dosbts'],
+        since: '0.40.0',
+        originNote: 'Ring gauge for one metabolic value. Carries the SCUM metabolism-screen dial pattern (value, target, provenance) as used in diabetes apps. Intended consumers: doctor-portal, dosbts (not yet adopted). Figma: none yet.',
+        variants: {
+            'size:sm': { description: 'Compact gauge', since: '0.40.0' },
+            'size:md': { description: 'Standard gauge', since: '0.40.0' },
+            'size:lg': { description: 'Hero gauge', since: '0.40.0' },
+            'tone:neutral': { description: 'Unfilled/neutral reading with no judgement', since: '0.40.0' },
+            'tone:info': { description: 'Informational reading (solid fill)', since: '0.40.0' },
+            'tone:success': { description: 'In-target reading (dither fill)', since: '0.40.0' },
+            'tone:warning': { description: 'Needs attention (hatch fill)', since: '0.40.0' },
+            'tone:critical': { description: 'Out-of-range reading (dotted fill)', since: '0.40.0' },
+            'status:ok': { description: 'Live value rendered normally', since: '0.40.0' },
+            'status:loading': { description: 'Value is being fetched', since: '0.40.0' },
+            'status:empty': { description: 'No data available', since: '0.40.0' },
+            'status:stale': { description: 'Value is older than expected', since: '0.40.0' },
+            'status:unknown': { description: 'Value could not be determined', since: '0.40.0' },
+        },
+        platforms: {
+            react: { path: 'src/components/Gauge', status: 'canonical' },
+            swiftui: { status: 'planned' },
+        },
+        changelog: [
+            { version: '0.40.0', type: 'added', description: 'Initial Gauge (health metabolism family)' },
+        ],
+    },
+    Meter: {
+        origin: 'eidotter',
+        consumers: ['dosbts'],
+        since: '0.40.0',
+        originNote: 'Single labelled meter bar with tick and tone/pattern pairing. Carries the SCUM stat-bar pattern (food, water, energy) for diabetes values such as carbs on board. Intended consumer: dosbts (not yet adopted). Figma: none yet.',
+        variants: {
+            'orientation:vertical': { description: 'Vertical bar with label beneath', since: '0.40.0' },
+            'orientation:horizontal': { description: 'Horizontal bar with label alongside', since: '0.40.0' },
+            'size:xs': { description: 'Extra-compact meter', since: '0.40.0' },
+            'size:sm': { description: 'Compact meter', since: '0.40.0' },
+            'size:md': { description: 'Standard meter', since: '0.40.0' },
+            'tone:neutral': { description: 'Unfilled/neutral reading with no judgement', since: '0.40.0' },
+            'tone:info': { description: 'Informational reading (solid fill)', since: '0.40.0' },
+            'tone:success': { description: 'In-target reading (dither fill)', since: '0.40.0' },
+            'tone:warning': { description: 'Needs attention (hatch fill)', since: '0.40.0' },
+            'tone:critical': { description: 'Out-of-range reading (dotted fill)', since: '0.40.0' },
+            'pattern:solid': { description: 'Solid fill', since: '0.40.0' },
+            'pattern:dither': { description: 'Dither fill', since: '0.40.0' },
+            'pattern:hatch': { description: 'Hatch fill', since: '0.40.0' },
+            'pattern:dotted': { description: 'Dotted fill', since: '0.40.0' },
+        },
+        platforms: {
+            react: { path: 'src/components/Meter', status: 'canonical' },
+            swiftui: { status: 'planned' },
+        },
+        changelog: [
+            { version: '0.40.0', type: 'added', description: 'Initial Meter (health metabolism family)' },
+        ],
+    },
+    MeterGroup: {
+        origin: 'eidotter',
+        consumers: ['dosbts'],
+        since: '0.40.0',
+        originNote: 'Layout wrapper for several Meters. Carries the SCUM metabolism-screen stat cluster pattern. Intended consumer: dosbts (not yet adopted). Figma: none yet.',
+        variants: {
+            'layout:row': { description: 'Meters in a single row', since: '0.40.0' },
+            'layout:grid': { description: 'Meters in a wrapping grid', since: '0.40.0' },
+        },
+        platforms: {
+            react: { path: 'src/components/Meter', status: 'canonical' },
+            swiftui: { status: 'planned' },
+        },
+        changelog: [
+            { version: '0.40.0', type: 'added', description: 'Initial MeterGroup (health metabolism family)' },
+        ],
+    },
+    RangeBar: {
+        origin: 'eidotter',
+        consumers: ['doctor-portal', 'dosbts'],
+        since: '0.40.0',
+        originNote: 'Banded range bar showing where a value sits against target segments, as in diabetes time-in-range displays. Carries the SCUM condition-bar pattern. Intended consumers: doctor-portal, dosbts (not yet adopted). Figma: none yet.',
+        variants: {
+            'orientation:vertical': { description: 'Vertical track', since: '0.40.0' },
+            'orientation:horizontal': { description: 'Horizontal track', since: '0.40.0' },
+            'size:sm': { description: 'Compact track', since: '0.40.0' },
+            'size:md': { description: 'Standard track', since: '0.40.0' },
+            'size:lg': { description: 'Large track', since: '0.40.0' },
+            'tone:neutral': { description: 'Unfilled/neutral reading with no judgement', since: '0.40.0' },
+            'tone:info': { description: 'Informational reading (solid fill)', since: '0.40.0' },
+            'tone:success': { description: 'In-target reading (dither fill)', since: '0.40.0' },
+            'tone:warning': { description: 'Needs attention (hatch fill)', since: '0.40.0' },
+            'tone:critical': { description: 'Out-of-range reading (dotted fill)', since: '0.40.0' },
+            'pattern:none': { description: 'No fill pattern', since: '0.40.0' },
+            'pattern:solid': { description: 'Solid fill', since: '0.40.0' },
+            'pattern:dither': { description: 'Dither fill', since: '0.40.0' },
+            'pattern:hatch': { description: 'Hatch fill', since: '0.40.0' },
+            'pattern:dotted': { description: 'Dotted fill', since: '0.40.0' },
+        },
+        platforms: {
+            react: { path: 'src/components/RangeBar', status: 'canonical' },
+            swiftui: { status: 'planned' },
+        },
+        changelog: [
+            { version: '0.40.0', type: 'added', description: 'Initial RangeBar (health metabolism family)' },
+        ],
+    },
+    SeriesBars: {
+        origin: 'eidotter',
+        consumers: ['doctor-portal'],
+        since: '0.40.0',
+        originNote: 'Bar series for per-period values such as daily carbs or time-in-range, as in diabetes reports. Carries the SCUM history-chart pattern. Intended consumer: doctor-portal (not yet adopted). Figma: none yet.',
+        variants: {
+            'size:sm': { description: 'Short plot', since: '0.40.0' },
+            'size:md': { description: 'Standard plot', since: '0.40.0' },
+            'size:lg': { description: 'Tall plot', since: '0.40.0' },
+            'tone:neutral': { description: 'Unfilled/neutral reading with no judgement', since: '0.40.0' },
+            'tone:info': { description: 'Informational reading (solid fill)', since: '0.40.0' },
+            'tone:success': { description: 'In-target reading (dither fill)', since: '0.40.0' },
+            'tone:warning': { description: 'Needs attention (hatch fill)', since: '0.40.0' },
+            'tone:critical': { description: 'Out-of-range reading (dotted fill)', since: '0.40.0' },
+        },
+        platforms: {
+            react: { path: 'src/components/SeriesBars', status: 'canonical' },
+            swiftui: { status: 'planned' },
+        },
+        changelog: [
+            { version: '0.40.0', type: 'added', description: 'Initial SeriesBars (health metabolism family)' },
+        ],
+    },
+    DecayStrip: {
+        origin: 'eidotter',
+        consumers: ['dosbts'],
+        since: '0.40.0',
+        originNote: 'Stepped block strip of consumer-supplied remaining-amount samples with a now marker (active-on-board curve in diabetes apps). Carries the SCUM timed-effect pattern; no absorption math. Intended consumer: dosbts (not yet adopted). Figma: none yet.',
+        variants: {
+            'size:sm': { description: 'Compact strip', since: '0.40.0' },
+            'size:md': { description: 'Standard strip', since: '0.40.0' },
+            'size:lg': { description: 'Large strip', since: '0.40.0' },
+            'tone:neutral': { description: 'Unfilled/neutral reading with no judgement', since: '0.40.0' },
+            'tone:info': { description: 'Informational reading', since: '0.40.0' },
+            'tone:success': { description: 'In-target reading', since: '0.40.0' },
+            'tone:warning': { description: 'Needs attention', since: '0.40.0' },
+            'tone:critical': { description: 'Out-of-range reading', since: '0.40.0' },
+        },
+        platforms: {
+            react: { path: 'src/components/DecayStrip', status: 'canonical' },
+            swiftui: { status: 'planned' },
+        },
+        changelog: [
+            { version: '0.40.0', type: 'added', description: 'Initial DecayStrip (health metabolism family)' },
+        ],
+    },
+    VitalsStrip: {
+        origin: 'eidotter',
+        consumers: ['doctor-portal', 'dosbts'],
+        since: '0.40.0',
+        originNote: 'Server-safe row of vitals tiles with value, unit, secondary text and bands, and status. Carries the SCUM vitals header pattern for diabetes summaries. Intended consumers: doctor-portal, dosbts (not yet adopted). Figma: none yet.',
+        variants: {
+            'size:sm': { description: 'Compact tiles', since: '0.40.0' },
+            'size:md': { description: 'Standard tiles', since: '0.40.0' },
+            'size:lg': { description: 'Large tiles', since: '0.40.0' },
+            'tone:neutral': { description: 'Unfilled/neutral reading with no judgement', since: '0.40.0' },
+            'tone:info': { description: 'Informational reading', since: '0.40.0' },
+            'tone:success': { description: 'In-target reading', since: '0.40.0' },
+            'tone:warning': { description: 'Needs attention', since: '0.40.0' },
+            'tone:critical': { description: 'Out-of-range reading', since: '0.40.0' },
+            'status:ok': { description: 'Live value rendered normally', since: '0.40.0' },
+            'status:loading': { description: 'Value is being fetched', since: '0.40.0' },
+            'status:empty': { description: 'No data available', since: '0.40.0' },
+            'status:stale': { description: 'Value is older than expected', since: '0.40.0' },
+            'status:unknown': { description: 'Value could not be determined', since: '0.40.0' },
+        },
+        platforms: {
+            react: { path: 'src/components/VitalsStrip', status: 'canonical' },
+            swiftui: { status: 'planned' },
+        },
+        changelog: [
+            { version: '0.40.0', type: 'added', description: 'Initial VitalsStrip (health metabolism family)' },
+        ],
+    },
 };
 // ---------------------------------------------------------------------------
 // Utility functions