@miragon/mcp-toolkit-ui 2.7.0 → 2.8.0

package/dist/components/DrillButton.d.ts

@@ -4,19 +4,22 @@ export interface DrillButtonProps {
     children: ReactNode;
     /** Drill/navigation handler — wire to in-widget navigation (e.g. `showWidget`). */
     onDrill: () => void;
-    /** Optional leading glyph (e.g. a domain icon). The trailing → is always rendered. */
+    /**
+     * Optional leading icon — a Lucide icon of the domain, never a typed glyph.
+     * Decorative (`aria-hidden`). The trailing arrow is always rendered.
+     */
     icon?: ReactNode;
     /** `sm` for table rows, `md` for surface headers. Default `"sm"`. */
     size?: "sm" | "md";
-    /** Accessible label when the visible text is terse. */
+    /** Accessible label when the visible text is terse; keep the visible text in it (WCAG 2.5.3). */
     ariaLabel?: string;
 }
 /**
  * The single, deterministic in-widget navigation control: a neutral outline
- * button with a trailing → that drills into a detail/sub-view. Use it for
- * every in-app drill (row "Open", header nav) so they read identically and stay
- * visually quieter than primary/agentic actions. Decoupled from any host — pass
- * an `onDrill` callback (e.g. wrapping `useHostActions().showWidget`).
+ * button with a trailing Lucide arrow that drills into a detail/sub-view. Use
+ * it for every in-app drill (row "Open", header nav) so they read identically
+ * and stay visually quieter than primary/agentic actions. Decoupled from any
+ * host — pass an `onDrill` callback (e.g. wrapping `useHostActions().showWidget`).
  */
 export declare function DrillButton({ children, onDrill, icon, size, ariaLabel }: DrillButtonProps): import("react").JSX.Element;
 //# sourceMappingURL=DrillButton.d.ts.map

package/dist/components/DrillButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DrillButton.d.ts","sourceRoot":"","sources":["../../src/components/DrillButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,QAAQ,EAAE,SAAS,CAAA;IACnB,mFAAmF;IACnF,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,sFAAsF;IACtF,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,qEAAqE;IACrE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAW,EAAE,SAAS,EAAE,EAAE,gBAAgB,+BAchG"}
+{"version":3,"file":"DrillButton.d.ts","sourceRoot":"","sources":["../../src/components/DrillButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,QAAQ,EAAE,SAAS,CAAA;IACnB,mFAAmF;IACnF,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,qEAAqE;IACrE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAW,EAAE,SAAS,EAAE,EAAE,gBAAgB,+BAsBhG"}

package/dist/components/DrillButton.js

@@ -1,14 +1,16 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ArrowRight } from "lucide-react";
 import { FOCUS_RING } from "../lib/focus-ring.js";
+import { cn } from "../lib/utils.js";
 /**
  * The single, deterministic in-widget navigation control: a neutral outline
- * button with a trailing → that drills into a detail/sub-view. Use it for
- * every in-app drill (row "Open", header nav) so they read identically and stay
- * visually quieter than primary/agentic actions. Decoupled from any host — pass
- * an `onDrill` callback (e.g. wrapping `useHostActions().showWidget`).
+ * button with a trailing Lucide arrow that drills into a detail/sub-view. Use
+ * it for every in-app drill (row "Open", header nav) so they read identically
+ * and stay visually quieter than primary/agentic actions. Decoupled from any
+ * host — pass an `onDrill` callback (e.g. wrapping `useHostActions().showWidget`).
  */
 export function DrillButton({ children, onDrill, icon, size = "sm", ariaLabel }) {
-    const pad = size === "md" ? "px-3 py-1.5 text-sm" : "px-2.5 py-1 text-xs";
-    return (_jsxs("button", { type: "button", onClick: onDrill, "aria-label": ariaLabel, className: `border-border text-foreground hover:border-focus hover:bg-accent hover:text-accent-foreground inline-flex items-center gap-1 rounded-md border font-medium transition-colors ${FOCUS_RING} ${pad}`, children: [icon && _jsx("span", { "aria-hidden": "true", children: icon }), children, _jsx("span", { "aria-hidden": "true", children: "\u2192" })] }));
+    const pad = size === "md" ? "px-3 py-1.5 text-dense" : "px-2.5 py-1 text-small";
+    return (_jsxs("button", { type: "button", onClick: onDrill, "aria-label": ariaLabel, className: cn("border-border text-foreground hover:border-focus hover:bg-accent hover:text-accent-foreground inline-flex items-center gap-1 rounded-md border font-medium transition-colors [&_svg:not([class*='size-'])]:size-4", FOCUS_RING, pad), children: [icon && (_jsx("span", { "aria-hidden": "true", className: "inline-flex", children: icon })), children, _jsx(ArrowRight, { "aria-hidden": "true", className: "size-4 shrink-0" })] }));
 }
 //# sourceMappingURL=DrillButton.js.map

package/dist/components/DrillButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"DrillButton.js","sourceRoot":"","sources":["../../src/components/DrillButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAejD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,SAAS,EAAoB;IAC/F,MAAM,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,CAAA;IACzE,OAAO,CACL,kBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,OAAO,gBACJ,SAAS,EACrB,SAAS,EAAE,gLAAgL,UAAU,IAAI,GAAG,EAAE,aAE7M,IAAI,IAAI,8BAAkB,MAAM,YAAE,IAAI,GAAQ,EAC9C,QAAQ,EACT,8BAAkB,MAAM,uBAAS,IAC1B,CACV,CAAA;AACH,CAAC"}
+{"version":3,"file":"DrillButton.js","sourceRoot":"","sources":["../../src/components/DrillButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AAkBpC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,SAAS,EAAoB;IAC/F,MAAM,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,wBAAwB,CAAA;IAC/E,OAAO,CACL,kBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,OAAO,gBACJ,SAAS,EACrB,SAAS,EAAE,EAAE,CACX,mNAAmN,EACnN,UAAU,EACV,GAAG,CACJ,aAEA,IAAI,IAAI,CACP,8BAAkB,MAAM,EAAC,SAAS,EAAC,aAAa,YAC7C,IAAI,GACA,CACR,EACA,QAAQ,EACT,KAAC,UAAU,mBAAa,MAAM,EAAC,SAAS,EAAC,iBAAiB,GAAG,IACtD,CACV,CAAA;AACH,CAAC"}

package/dist/components/EmptyState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../src/components/EmptyState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,CAAA;AAExD,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,yFAAyF;IACzF,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC5B,2DAA2D;IAC3D,KAAK,EAAE,SAAS,CAAA;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,gFAAgF;IAChF,eAAe,CAAC,EAAE,SAAS,CAAA;IAC3B,oFAAoF;IACpF,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAQD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,IAAgB,EAChB,KAAK,EACL,WAAW,EACX,MAAM,EACN,eAAe,EACf,OAAO,EAAE,KAAY,EACrB,SAAS,GACV,EAAE,eAAe,+BA6BjB"}
+{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../src/components/EmptyState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,CAAA;AAExD,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,yFAAyF;IACzF,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC5B,2DAA2D;IAC3D,KAAK,EAAE,SAAS,CAAA;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,gFAAgF;IAChF,eAAe,CAAC,EAAE,SAAS,CAAA;IAC3B,oFAAoF;IACpF,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAQD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,IAAgB,EAChB,KAAK,EACL,WAAW,EACX,MAAM,EACN,eAAe,EACf,OAAO,EAAE,KAAY,EACrB,SAAS,GACV,EAAE,eAAe,+BA+BjB"}

package/dist/components/EmptyState.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { TONE_ICON } from "../lib/tone-utils.js";
+import { resolveTone, TONE_ICON } from "../lib/tone-utils.js";
 import { cn } from "../lib/utils.js";
 /** The icon slot in the tone's icon colour (`TONE_ICON`): quiet, or the success tone. */
 const ICON_TONE = {
@@ -12,6 +12,8 @@ const ICON_TONE = {
  * live region): it replaces content, it does not announce a change.
  */
 export function EmptyState({ icon, tone = "neutral", title, description, action, secondaryAction, titleAs: Title = "h3", className, }) {
-    return (_jsxs("div", { "data-slot": "empty-state", className: cn("flex flex-col items-center gap-2 px-4 py-8 text-center", className), children: [icon && (_jsx("div", { "aria-hidden": "true", className: cn("mb-1 flex items-center justify-center [&_svg:not([class*='size-'])]:size-6", ICON_TONE[tone]), children: icon })), _jsx(Title, { className: "text-foreground text-base font-semibold", children: title }), description && (_jsx("p", { className: "text-muted-foreground max-w-prose text-sm text-balance", children: description })), (action || secondaryAction) && (_jsxs("div", { className: "mt-2 flex flex-wrap items-center justify-center gap-2", children: [action, secondaryAction] }))] }));
+    // An untyped tone resolves (`ok` → success); anything else stays quiet.
+    const iconTone = resolveTone(tone) === "success" ? "success" : "neutral";
+    return (_jsxs("div", { "data-slot": "empty-state", className: cn("flex flex-col items-center gap-2 px-4 py-8 text-center", className), children: [icon && (_jsx("div", { "aria-hidden": "true", className: cn("mb-1 flex items-center justify-center [&_svg:not([class*='size-'])]:size-6", ICON_TONE[iconTone]), children: icon })), _jsx(Title, { className: "text-foreground text-body font-semibold", children: title }), description && (_jsx("p", { className: "text-muted-foreground text-body max-w-prose text-balance", children: description })), (action || secondaryAction) && (_jsxs("div", { className: "mt-2 flex flex-wrap items-center justify-center gap-2", children: [action, secondaryAction] }))] }));
 }
 //# sourceMappingURL=EmptyState.js.map

package/dist/components/EmptyState.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmptyState.js","sourceRoot":"","sources":["../../src/components/EmptyState.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AA6BpC,yFAAyF;AACzF,MAAM,SAAS,GAAyD;IACtE,OAAO,EAAE,SAAS,CAAC,OAAO;IAC1B,OAAO,EAAE,SAAS,CAAC,OAAO;CAC3B,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,IAAI,EACJ,IAAI,GAAG,SAAS,EAChB,KAAK,EACL,WAAW,EACX,MAAM,EACN,eAAe,EACf,OAAO,EAAE,KAAK,GAAG,IAAI,EACrB,SAAS,GACO;IAChB,OAAO,CACL,4BACY,aAAa,EACvB,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,aAEjF,IAAI,IAAI,CACP,6BACc,MAAM,EAClB,SAAS,EAAE,EAAE,CACX,4EAA4E,EAC5E,SAAS,CAAC,IAAI,CAAC,CAChB,YAEA,IAAI,GACD,CACP,EACD,KAAC,KAAK,IAAC,SAAS,EAAC,yCAAyC,YAAE,KAAK,GAAS,EACzE,WAAW,IAAI,CACd,YAAG,SAAS,EAAC,wDAAwD,YAAE,WAAW,GAAK,CACxF,EACA,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAC9B,eAAK,SAAS,EAAC,uDAAuD,aACnE,MAAM,EACN,eAAe,IACZ,CACP,IACG,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"EmptyState.js","sourceRoot":"","sources":["../../src/components/EmptyState.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AA6BpC,yFAAyF;AACzF,MAAM,SAAS,GAAyD;IACtE,OAAO,EAAE,SAAS,CAAC,OAAO;IAC1B,OAAO,EAAE,SAAS,CAAC,OAAO;CAC3B,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,IAAI,EACJ,IAAI,GAAG,SAAS,EAChB,KAAK,EACL,WAAW,EACX,MAAM,EACN,eAAe,EACf,OAAO,EAAE,KAAK,GAAG,IAAI,EACrB,SAAS,GACO;IAChB,wEAAwE;IACxE,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;IACxE,OAAO,CACL,4BACY,aAAa,EACvB,SAAS,EAAE,EAAE,CAAC,wDAAwD,EAAE,SAAS,CAAC,aAEjF,IAAI,IAAI,CACP,6BACc,MAAM,EAClB,SAAS,EAAE,EAAE,CACX,4EAA4E,EAC5E,SAAS,CAAC,QAAQ,CAAC,CACpB,YAEA,IAAI,GACD,CACP,EACD,KAAC,KAAK,IAAC,SAAS,EAAC,yCAAyC,YAAE,KAAK,GAAS,EACzE,WAAW,IAAI,CACd,YAAG,SAAS,EAAC,0DAA0D,YAAE,WAAW,GAAK,CAC1F,EACA,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAC9B,eAAK,SAAS,EAAC,uDAAuD,aACnE,MAAM,EACN,eAAe,IACZ,CACP,IACG,CACP,CAAA;AACH,CAAC"}

package/dist/components/ErrorState.d.ts

@@ -21,7 +21,10 @@ export interface ErrorStateProps {
     retryLabel?: string;
     /** Further actions after the retry button (e.g. a link to another view). */
     actions?: ReactNode;
-    /** Default `"danger"`. `"warning"` for partial failures, `"info"` for notices. */
+    /**
+     * Default `"danger"`. `"warning"` for partial failures, `"info"` for
+     * notices. An untyped retired name still resolves (`error` → `danger`).
+     */
     tone?: ErrorStateTone;
     /** Replace the tone's default Lucide icon. */
     icon?: LucideIcon;
@@ -46,5 +49,5 @@ export interface ErrorStateProps {
  * and a retry. `inline` is the alert form above content that still renders
  * (failed data steps); `block` replaces a whole view or widget body.
  */
-export declare function ErrorState({ title, description, details, detailsLabel, onRetry, retryLabel, actions, tone, icon, variant, role, titleAs, className, }: ErrorStateProps): import("react").JSX.Element;
+export declare function ErrorState({ title, description, details, detailsLabel, onRetry, retryLabel, actions, tone: toneProp, icon, variant, role, titleAs, className, }: ErrorStateProps): import("react").JSX.Element;
 //# sourceMappingURL=ErrorState.d.ts.map

package/dist/components/ErrorState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorState.d.ts","sourceRoot":"","sources":["../../src/components/ErrorState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAA+C,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAM3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAE1D,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,KAAK,EAAE,SAAS,CAAA;IAChB,gFAAgF;IAChF,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,kFAAkF;IAClF,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IAClC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAmCD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,WAAW,EACX,OAAO,EACP,YAAY,EACZ,OAAO,EACP,UAAU,EACV,OAAO,EACP,IAAe,EACf,IAAI,EACJ,OAAiB,EACjB,IAAc,EACd,OAAO,EACP,SAAS,GACV,EAAE,eAAe,+BAmCjB"}
+{"version":3,"file":"ErrorState.d.ts","sourceRoot":"","sources":["../../src/components/ErrorState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAA+C,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAM3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAE1D,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,KAAK,EAAE,SAAS,CAAA;IAChB,gFAAgF;IAChF,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IAClC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAqDD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,WAAW,EACX,OAAO,EACP,YAAY,EACZ,OAAO,EACP,UAAU,EACV,OAAO,EACP,IAAI,EAAE,QAAQ,EACd,IAAI,EACJ,OAAiB,EACjB,IAAc,EACd,OAAO,EACP,SAAS,GACV,EAAE,eAAe,+BAoCjB"}

package/dist/components/ErrorState.js

@@ -3,26 +3,42 @@ import { CircleAlert, Info, RefreshCw, TriangleAlert } from "lucide-react";
 import { useToolkitMessages } from "../locale/locale-provider.js";
 import { Button } from "../primitives/button.js";
 import { FOCUS_RING } from "../lib/focus-ring.js";
-import { TONE_BORDER, TONE_ICON, TONE_SOFT } from "../lib/tone-utils.js";
+import { resolveTone, TONE_BORDER, TONE_ICON, TONE_SOFT } from "../lib/tone-utils.js";
 import { cn } from "../lib/utils.js";
 const STATE_ICON = {
     danger: CircleAlert,
     warning: TriangleAlert,
     info: Info,
 };
-/** Per-variant geometry: `block` replaces a surface, `inline` sits above content. */
+/**
+ * The state's tone from whatever arrives: its three tones as is, a retired
+ * name through `resolveTone` (`error` → `danger`, `notice` → `info`), any
+ * other tone or unknown name as the default `danger`. A tone from untyped
+ * data (plain JS, the wire) never crashes the view on a missing icon.
+ */
+function stateTone(name) {
+    const tone = resolveTone(name, "danger");
+    return tone === "warning" || tone === "info" ? tone : "danger";
+}
+/**
+ * Per-variant geometry: `block` replaces a surface and reads as running text
+ * (16 px), `inline` is the compact alert box above content that still renders
+ * (14 px, the dense-controls exception of the type scale).
+ */
 const VARIANT = {
     block: {
         box: "gap-4 p-4",
         icon: "size-5",
-        title: "text-base",
+        title: "text-body",
+        description: "text-body",
         defaultTitleAs: "h2",
         retry: "default",
     },
     inline: {
-        box: "gap-3 px-4 py-3 text-sm",
+        box: "gap-3 px-4 py-3 text-dense",
         icon: "size-4",
-        title: "text-sm",
+        title: "text-dense",
+        description: "text-dense",
         defaultTitleAs: "p",
         retry: "outline",
     },
@@ -33,14 +49,15 @@ const VARIANT = {
  * and a retry. `inline` is the alert form above content that still renders
  * (failed data steps); `block` replaces a whole view or widget body.
  */
-export function ErrorState({ title, description, details, detailsLabel, onRetry, retryLabel, actions, tone = "danger", icon, variant = "block", role = "alert", titleAs, className, }) {
+export function ErrorState({ title, description, details, detailsLabel, onRetry, retryLabel, actions, tone: toneProp, icon, variant = "block", role = "alert", titleAs, className, }) {
+    const tone = stateTone(toneProp);
     const style = VARIANT[variant];
     const Icon = icon ?? STATE_ICON[tone];
     const Title = titleAs ?? style.defaultTitleAs;
     // The status colour as rim, tint and icon; every word on the tint is the
     // foreground (TONE_SOFT, CI §3.3). On dark the tint is transparent and the
     // rim carries the tone.
-    return (_jsxs("div", { "data-slot": "error-state", "data-variant": variant, "data-tone": tone, role: role === "none" ? undefined : role, className: cn("flex items-start rounded-md border", style.box, TONE_SOFT[tone], TONE_BORDER[tone], className), children: [_jsx(Icon, { "aria-hidden": "true", className: cn("mt-0.5 shrink-0", style.icon, TONE_ICON[tone]) }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [_jsx(Title, { className: cn("font-semibold", style.title), children: title }), description && _jsx("div", { className: "text-sm break-words", children: description }), details && _jsx(ErrorDetails, { label: detailsLabel, children: details }), _jsx(ErrorActions, { onRetry: onRetry, retryLabel: retryLabel, retryVariant: style.retry, actions: actions })] })] }));
+    return (_jsxs("div", { "data-slot": "error-state", "data-variant": variant, "data-tone": tone, role: role === "none" ? undefined : role, className: cn("flex items-start rounded-md border", style.box, TONE_SOFT[tone], TONE_BORDER[tone], className), children: [_jsx(Icon, { "aria-hidden": "true", className: cn("mt-0.5 shrink-0", style.icon, TONE_ICON[tone]) }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [_jsx(Title, { className: cn("font-semibold", style.title), children: title }), description && _jsx("div", { className: cn("break-words", style.description), children: description }), details && _jsx(ErrorDetails, { label: detailsLabel, children: details }), _jsx(ErrorActions, { onRetry: onRetry, retryLabel: retryLabel, retryVariant: style.retry, actions: actions })] })] }));
 }
 /**
  * The raw reason, collapsed: a native disclosure (keyboard + screen-reader
@@ -49,7 +66,7 @@ export function ErrorState({ title, description, details, detailsLabel, onRetry,
  */
 function ErrorDetails({ label, children }) {
     const messages = useToolkitMessages();
-    return (_jsxs("details", { className: "text-xs", children: [_jsx("summary", { className: `w-fit cursor-pointer rounded-sm py-0.5 select-none ${FOCUS_RING}`, children: label ?? messages.common.details }), _jsx("pre", { className: "mt-1 font-mono break-words whitespace-pre-wrap", children: children })] }));
+    return (_jsxs("details", { className: "text-small", children: [_jsx("summary", { className: `w-fit cursor-pointer rounded-sm py-0.5 select-none ${FOCUS_RING}`, children: label ?? messages.common.details }), _jsx("pre", { className: "mt-1 font-mono break-words whitespace-pre-wrap", children: children })] }));
 }
 function ErrorActions({ onRetry, retryLabel, retryVariant, actions, }) {
     const messages = useToolkitMessages();

package/dist/components/ErrorState.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorState.js","sourceRoot":"","sources":["../../src/components/ErrorState.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ErrorState.js","sourceRoot":"","sources":["../../src/components/ErrorState.tsx"],"names":[],"mappings":"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"}

package/dist/components/FilterBar.d.ts

@@ -1,11 +1,11 @@
 export interface FilterChip {
     /** Stable id passed back to `onChipToggle`. */
     id: string;
-    /** Visible chip label. */
+    /** Visible chip label (its accessible name, with the count). */
     label: string;
     /** Optional count rendered after the label. */
     count?: number | string;
-    /** Whether the chip is currently active. */
+    /** Whether the chip is currently active (`aria-pressed`). */
     active?: boolean;
 }
 export interface FilterBarProps {
@@ -13,16 +13,27 @@ export interface FilterBarProps {
     search: string;
     /** Placeholder for the search input. Default: the locale's "Filter…". */
     searchPlaceholder?: string;
+    /**
+     * Accessible name of the search input. Default: the locale's "Filter" — a
+     * placeholder is no label (it disappears while you type).
+     */
+    searchAriaLabel?: string;
     /** Called with the new search text on every keystroke. */
     onSearchChange: (next: string) => void;
     /** Filter chips rendered to the right of the search input. */
     chips: FilterChip[];
     /** Called with a chip id when it is toggled. */
     onChipToggle: (id: string) => void;
+    /** Names the chip row (`role="group"`). Default: the locale's "Filters". */
+    chipsAriaLabel?: string;
+    className?: string;
 }
 /**
  * Search input + toggleable chip row for filtering a list/table of widget
- * items. Pair with `useDebouncedValue` to avoid re-querying on every keystroke.
+ * items. The input is labelled; every chip is a toggle button whose state is
+ * `aria-pressed`. An active chip is a selection in the CI pattern: the info
+ * tint and edge around foreground text. Pair with `useDebouncedValue` to
+ * avoid re-querying on every keystroke.
  */
-export declare function FilterBar({ search, searchPlaceholder, onSearchChange, chips, onChipToggle, }: FilterBarProps): import("react").JSX.Element;
+export declare function FilterBar({ search, searchPlaceholder, searchAriaLabel, onSearchChange, chips, onChipToggle, chipsAriaLabel, className, }: FilterBarProps): import("react").JSX.Element;
 //# sourceMappingURL=FilterBar.d.ts.map

package/dist/components/FilterBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBar.d.ts","sourceRoot":"","sources":["../../src/components/FilterBar.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,0DAA0D;IAC1D,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,8DAA8D;IAC9D,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,gDAAgD;IAChD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,KAAK,EACL,YAAY,GACb,EAAE,cAAc,+BAgChB"}
+{"version":3,"file":"FilterBar.d.ts","sourceRoot":"","sources":["../../src/components/FilterBar.tsx"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAA;IACV,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0DAA0D;IAC1D,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,8DAA8D;IAC9D,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,gDAAgD;IAChD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,KAAK,EACL,YAAY,EACZ,cAAc,EACd,SAAS,GACV,EAAE,cAAc,+BA0ChB"}

package/dist/components/FilterBar.js

@@ -1,15 +1,20 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { FOCUS_RING } from "../lib/focus-ring.js";
+import { TONE_BORDER, TONE_SOFT } from "../lib/tone-utils.js";
+import { cn } from "../lib/utils.js";
 import { useToolkitMessages } from "../locale/locale-provider.js";
 import { Input } from "../primitives/input.js";
 /**
  * Search input + toggleable chip row for filtering a list/table of widget
- * items. Pair with `useDebouncedValue` to avoid re-querying on every keystroke.
+ * items. The input is labelled; every chip is a toggle button whose state is
+ * `aria-pressed`. An active chip is a selection in the CI pattern: the info
+ * tint and edge around foreground text. Pair with `useDebouncedValue` to
+ * avoid re-querying on every keystroke.
  */
-export function FilterBar({ search, searchPlaceholder, onSearchChange, chips, onChipToggle, }) {
-    const messages = useToolkitMessages();
-    return (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Input, { type: "search", value: search, onChange: (e) => onSearchChange(e.target.value), placeholder: searchPlaceholder ?? messages.filterBar.searchPlaceholder, className: "h-9 min-w-[220px] flex-1 text-sm" }), _jsx("div", { className: "flex flex-wrap gap-1.5", children: chips.map((chip) => (_jsxs("button", { type: "button", onClick: () => onChipToggle(chip.id), className: `inline-flex items-center gap-1.5 rounded-sm border px-2.5 py-1 text-xs font-medium transition-colors ${FOCUS_RING} ${chip.active
-                        ? "bg-accent border-focus text-accent-foreground font-semibold"
-                        : "border-border bg-background text-muted-foreground hover:bg-muted hover:text-foreground"}`, children: [chip.label, chip.count !== undefined && chip.count !== "" && (_jsx("span", { className: "font-normal tabular-nums", children: chip.count }))] }, chip.id))) })] }));
+export function FilterBar({ search, searchPlaceholder, searchAriaLabel, onSearchChange, chips, onChipToggle, chipsAriaLabel, className, }) {
+    const { filterBar } = useToolkitMessages();
+    return (_jsxs("div", { "data-slot": "filter-bar", className: cn("flex flex-wrap items-center gap-2", className), children: [_jsx(Input, { type: "search", value: search, onChange: (e) => onSearchChange(e.target.value), placeholder: searchPlaceholder ?? filterBar.searchPlaceholder, "aria-label": searchAriaLabel ?? filterBar.searchLabel, className: "text-dense md:text-dense h-9 min-w-[220px] flex-1" }), chips.length > 0 && (_jsx("div", { role: "group", "aria-label": chipsAriaLabel ?? filterBar.chipsLabel, className: "flex flex-wrap gap-1.5", children: chips.map((chip) => (_jsxs("button", { type: "button", onClick: () => onChipToggle(chip.id), "aria-pressed": Boolean(chip.active), className: cn("text-small inline-flex items-center gap-1.5 rounded-sm border px-2.5 py-1 font-medium transition-colors", FOCUS_RING, chip.active
+                        ? cn(TONE_SOFT.info, TONE_BORDER.info, "font-semibold")
+                        : "border-border bg-background text-muted-foreground hover:bg-muted hover:text-foreground"), children: [chip.label, chip.count !== undefined && chip.count !== "" && (_jsx("span", { className: "font-normal tabular-nums", children: chip.count }))] }, chip.id))) }))] }));
 }
 //# sourceMappingURL=FilterBar.js.map

package/dist/components/FilterBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBar.js","sourceRoot":"","sources":["../../src/components/FilterBar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AA0B9C;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,KAAK,EACL,YAAY,GACG;IACf,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;IACrC,OAAO,CACL,eAAK,SAAS,EAAC,mCAAmC,aAChD,KAAC,KAAK,IACJ,IAAI,EAAC,QAAQ,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAC/C,WAAW,EAAE,iBAAiB,IAAI,QAAQ,CAAC,SAAS,CAAC,iBAAiB,EACtE,SAAS,EAAC,kCAAkC,GAC5C,EACF,cAAK,SAAS,EAAC,wBAAwB,YACpC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,kBACE,IAAI,EAAC,QAAQ,EAEb,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EACpC,SAAS,EAAE,wGAAwG,UAAU,IAC3H,IAAI,CAAC,MAAM;wBACT,CAAC,CAAC,6DAA6D;wBAC/D,CAAC,CAAC,wFACN,EAAE,aAED,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,CAChD,eAAM,SAAS,EAAC,0BAA0B,YAAE,IAAI,CAAC,KAAK,GAAQ,CAC/D,KAXI,IAAI,CAAC,EAAE,CAYL,CACV,CAAC,GACE,IACF,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"FilterBar.js","sourceRoot":"","sources":["../../src/components/FilterBar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAkC9C;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,KAAK,EACL,YAAY,EACZ,cAAc,EACd,SAAS,GACM;IACf,MAAM,EAAE,SAAS,EAAE,GAAG,kBAAkB,EAAE,CAAA;IAC1C,OAAO,CACL,4BAAe,YAAY,EAAC,SAAS,EAAE,EAAE,CAAC,mCAAmC,EAAE,SAAS,CAAC,aACvF,KAAC,KAAK,IACJ,IAAI,EAAC,QAAQ,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAC/C,WAAW,EAAE,iBAAiB,IAAI,SAAS,CAAC,iBAAiB,gBACjD,eAAe,IAAI,SAAS,CAAC,WAAW,EACpD,SAAS,EAAC,mDAAmD,GAC7D,EACD,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CACnB,cACE,IAAI,EAAC,OAAO,gBACA,cAAc,IAAI,SAAS,CAAC,UAAU,EAClD,SAAS,EAAC,wBAAwB,YAEjC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,kBACE,IAAI,EAAC,QAAQ,EAEb,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,kBACtB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAClC,SAAS,EAAE,EAAE,CACX,yGAAyG,EACzG,UAAU,EACV,IAAI,CAAC,MAAM;wBACT,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC;wBACvD,CAAC,CAAC,wFAAwF,CAC7F,aAEA,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,CAChD,eAAM,SAAS,EAAC,0BAA0B,YAAE,IAAI,CAAC,KAAK,GAAQ,CAC/D,KAdI,IAAI,CAAC,EAAE,CAeL,CACV,CAAC,GACE,CACP,IACG,CACP,CAAA;AACH,CAAC"}

package/dist/components/KpiGrid.d.ts

@@ -1,50 +1,95 @@
-import type { ReactNode } from "react";
-import { type ToneVariant } from "../lib/tone-utils.js";
+import { type ReactNode } from "react";
+import { type ToneName } from "../lib/tone-utils.js";
+type TrendDirection = "up" | "down" | "flat";
 export interface KpiCell {
-    /** Caption shown above the value. */
+    /** Caption shown above the value. Part of the cell's accessible name. */
     label: ReactNode;
     /** The headline figure. Pre-format numbers for locale/currency. */
     value: ReactNode;
     /** Small fraction shown next to the value, e.g. ` /14`. */
     fraction?: ReactNode;
-    /** Optional trend line under the value (e.g. `"+12% vs last week"`). */
+    /** Optional trend line under the value (e.g. `"+12% vs last week"`); its words stay neutral. */
     trend?: ReactNode;
     /**
-     * Tones the trend line's dot. `up` reads as bad (danger), `down` as good
-     * (success); the trend text itself stays in the foreground.
+     * Draws a Lucide direction icon (TrendingUp / TrendingDown / Minus) before
+     * the trend line, in the trend's tone: `up` reads as bad (danger), `down`
+     * as good (success) unless {@link KpiCell.trendTone} says otherwise.
      */
-    trendDirection?: "up" | "down" | "flat";
+    trendDirection?: TrendDirection;
     /**
-     * Status of the metric (e.g. `"danger"` for a breached one), shown as a dot
-     * before the label. The figure itself stays in the foreground colour.
+     * Explicit tone of the trend — overrides the direction's default. Shown as
+     * the direction icon's colour, or as a dot when there is no direction.
      */
-    tone?: ToneVariant;
+    trendTone?: ToneName;
+    /**
+     * The state the figure stands for (e.g. `"danger"` for a breached metric),
+     * shown as a dot next to the label (strip) or as the card's tint and edge
+     * (`variant="soft"`). The figure itself stays in the foreground colour.
+     */
+    tone?: ToneName;
     /** When set, the cell renders as a button — turns a metric into a nav entry point. */
     onClick?: () => void;
-    /** Accessible label for the clickable cell (recommended when `onClick` is set). */
+    /**
+     * What activating the cell does ("Opens the incidents dashboard"). Read as
+     * the button's DESCRIPTION (`aria-describedby`), so its accessible name
+     * stays the visible label and value (WCAG 2.5.3, label in name).
+     */
+    actionHint?: string;
+    /**
+     * @deprecated Replaces the accessible name with text a voice-control user
+     * cannot see (WCAG 2.5.3). Say what the click does in
+     * {@link KpiCell.actionHint}; the visible label and value name the cell.
+     */
     ariaLabel?: string;
 }
+/** The responsive column classes for `count` cells (clamped to 1–6). */
+export declare function kpiColumns(count: number): string;
 export interface KpiGridHeader {
-    /** Group label, rendered uppercase in the strip header. */
+    /** Group label of the strip header (13 px semibold, normal case). */
     label: ReactNode;
     /** Optional muted badge to the right of the label. */
     badge?: ReactNode;
 }
 export interface KpiGridProps {
-    /** The metric cells, flowed as columns (1–6, clamped). */
+    /** The metric cells, flowed as columns (1–6; more wrap onto further rows). */
     cells: KpiCell[];
     /** Wrap the strip in a bordered card with an optional group `header`. Default `false`. */
     boxed?: boolean;
-    /** Group header shown above the strip when `boxed`. */
+    /** Group header above the strip (strip variant), usually with `boxed`. */
     header?: KpiGridHeader;
+    /**
+     * `"strip"` (default): one bordered strip, the tone as a dot next to the
+     * label. `"soft"`: one card per cell in its tone's tint and edge (`boxed`
+     * and `header` don't apply).
+     */
+    variant?: "strip" | "soft";
+    /** Names the group of metrics (`role="group"`); omit when a heading right above names it. */
+    ariaLabel?: string;
+    className?: string;
+}
+/**
+ * A row of headline metrics — the canonical way to show KPIs in a widget
+ * (replaces the single-metric KPICard). Cells flow as columns (1–6), falling
+ * back to 2 columns in narrow frames. A cell's `tone` shows as a dot next to
+ * its label (or as a soft card's tint and edge); figures stay in the
+ * foreground colour. A clickable cell is a button whose accessible name is
+ * its visible label and value; `actionHint` describes what the click does.
+ */
+export declare function KpiGrid({ cells, boxed, header, variant, ariaLabel, className, }: KpiGridProps): import("react").JSX.Element;
+export interface KpiGridSkeletonProps {
+    /** How many cells the loaded grid will have. */
+    cells: number;
+    /** The loaded grid's variant. Default `"strip"`. */
+    variant?: "strip" | "soft";
+    /** The loaded grid's `boxed`. Default `false`. */
+    boxed?: boolean;
+    className?: string;
 }
 /**
- * Bordered strip of KPI cells — the canonical way to show a row of headline
- * metrics in a widget (replaces the single-metric KPICard). Cells flow as
- * columns (1–6) and can be made clickable to drill into a detail view. Use
- * `boxed` + `header` for a labelled metric block; unboxed (default) renders the
- * lighter `border-y` strip. A cell's `tone` shows as a status dot next to its
- * label; figures stay in the foreground colour.
+ * Loading placeholder with {@link KpiGrid}'s geometry (same wrapper, grid and
+ * cell padding in both variants), so the layout doesn't jump when the data
+ * arrives. `aria-busy`; pair it with a status line if the wait is long.
  */
-export declare function KpiGrid({ cells, boxed, header }: KpiGridProps): import("react").JSX.Element;
+export declare function KpiGridSkeleton({ cells, variant, boxed, className, }: KpiGridSkeletonProps): import("react").JSX.Element;
+export {};
 //# sourceMappingURL=KpiGrid.d.ts.map

package/dist/components/KpiGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KpiGrid.d.ts","sourceRoot":"","sources":["../../src/components/KpiGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAYjE,MAAM,WAAW,OAAO;IACtB,qCAAqC;IACrC,KAAK,EAAE,SAAS,CAAA;IAChB,mEAAmE;IACnE,KAAK,EAAE,SAAS,CAAA;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IACvC;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAWD,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,KAAK,EAAE,SAAS,CAAA;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAsDD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,KAAa,EAAE,MAAM,EAAE,EAAE,YAAY,+BAwCrE"}
+{"version":3,"file":"KpiGrid.d.ts","sourceRoot":"","sources":["../../src/components/KpiGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAG7C,OAAO,EAML,KAAK,QAAQ,EAEd,MAAM,sBAAsB,CAAA;AAK7B,KAAK,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;AAmB5C,MAAM,WAAW,OAAO;IACtB,yEAAyE;IACzE,KAAK,EAAE,SAAS,CAAA;IAChB,mEAAmE;IACnE,KAAK,EAAE,SAAS,CAAA;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,gGAAgG;IAChG,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAA;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAgBD,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,KAAK,EAAE,SAAS,CAAA;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,0EAA0E;IAC1E,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAqJD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,KAAa,EACb,MAAM,EACN,OAAiB,EACjB,SAAS,EACT,SAAS,GACV,EAAE,YAAY,+BAiCd;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,OAAiB,EACjB,KAAa,EACb,SAAS,GACV,EAAE,oBAAoB,+BAgCtB"}