@miragon/mcp-toolkit-ui 2.6.0 → 2.8.0

package/dist/lib/focus-ring.js

@@ -0,0 +1,18 @@
+/**
+ * The toolkit's focus indicator as Tailwind classes: an opaque 2px ring in the
+ * `--focus` role (blau-link on light, blau-hell on dark — 3:1 or more against
+ * every surface, see `theme/theme-css.test.ts`), offset from the control so it
+ * reads on any fill. Every interactive kit control uses it; spread it into a
+ * custom control's `className` so keyboard focus looks the same everywhere.
+ * (`theme.css` also gives every element without its own ring an opaque
+ * `:focus-visible` outline in the same colour.)
+ *
+ * The ring is a box-shadow, which forced-colors mode (Windows High Contrast)
+ * drops. `outline-hidden` — never `outline-none` — hides the outline only
+ * outside that mode and keeps a transparent 2px outline in it, which the
+ * browser paints in the system colour, so focus stays visible there too.
+ */
+export const FOCUS_RING = "outline-hidden focus-visible:ring-2 focus-visible:ring-focus focus-visible:ring-offset-2 focus-visible:ring-offset-background";
+/** {@link FOCUS_RING} drawn inside the element — for cells and rows flush with a container edge. */
+export const FOCUS_RING_INSET = "outline-hidden focus-visible:ring-2 focus-visible:ring-focus focus-visible:ring-inset";
+//# sourceMappingURL=focus-ring.js.map

package/dist/lib/focus-ring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-ring.js","sourceRoot":"","sources":["../../src/lib/focus-ring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,UAAU,GACrB,+HAA+H,CAAA;AAEjI,oGAAoG;AACpG,MAAM,CAAC,MAAM,gBAAgB,GAC3B,uFAAuF,CAAA"}

package/dist/lib/icon-stroke.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Lucide stroke widths of the toolkit's chrome (CI §11, on the 24 px grid).
+ * Set once through `LucideProvider`: `McpAppView` applies {@link ICON_STROKE}
+ * to everything it renders (its toast stack included), dense bars narrow it
+ * to {@link DENSE_ICON_STROKE}. Icons of a consumer's own `lucide-react` follow
+ * the provider only when they resolve to the same module instance (dedupe it).
+ */
+/** Default stroke of the toolkit's icons. */
+export declare const ICON_STROKE = 2.5;
+/** Stroke in dense chrome bars (the view toolbar, the builder's bars). */
+export declare const DENSE_ICON_STROKE = 2;
+//# sourceMappingURL=icon-stroke.d.ts.map

package/dist/lib/icon-stroke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-stroke.d.ts","sourceRoot":"","sources":["../../src/lib/icon-stroke.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,WAAW,MAAM,CAAA;AAE9B,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,IAAI,CAAA"}

package/dist/lib/icon-stroke.js

@@ -0,0 +1,12 @@
+/**
+ * Lucide stroke widths of the toolkit's chrome (CI §11, on the 24 px grid).
+ * Set once through `LucideProvider`: `McpAppView` applies {@link ICON_STROKE}
+ * to everything it renders (its toast stack included), dense bars narrow it
+ * to {@link DENSE_ICON_STROKE}. Icons of a consumer's own `lucide-react` follow
+ * the provider only when they resolve to the same module instance (dedupe it).
+ */
+/** Default stroke of the toolkit's icons. */
+export const ICON_STROKE = 2.5;
+/** Stroke in dense chrome bars (the view toolbar, the builder's bars). */
+export const DENSE_ICON_STROKE = 2;
+//# sourceMappingURL=icon-stroke.js.map

package/dist/lib/icon-stroke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-stroke.js","sourceRoot":"","sources":["../../src/lib/icon-stroke.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA;AAE9B,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAA"}

package/dist/lib/parse-tool-result.d.ts

@@ -13,10 +13,32 @@ export interface ParseToolResultOptions {
      */
     prefer?: "structured" | "text";
 }
+/**
+ * A tool answered with an `isError` result: a deterministic failure of the
+ * call itself (a validation error, an engine 404), not of the transport.
+ * Thrown by {@link parseToolResult}. The query hooks retry it like any
+ * failure by default (the client's `retry`); pass `retry: shouldRetryToolCall`
+ * to stop that, since repeating the call repeats the answer. Still an `Error`
+ * with the tool's first text block as its message.
+ */
+export declare class ToolResultError extends Error {
+    /** The `isError` result as the tool returned it. */
+    readonly result: unknown;
+    constructor(message: string, result: unknown);
+}
+/**
+ * Whether `error` is a tool's own `isError` answer: a {@link ToolResultError},
+ * or mcp-use's `ToolError` (how `useDynamicTool` rejects an `isError` result
+ * inside a view), recognised by its name and result so the root barrel never
+ * imports `mcp-use/react`. Transport failures (a lost connection, a JSON-RPC
+ * error such as an unknown tool) are not tool errors.
+ */
+export declare function isToolError(error: unknown): boolean;
 /**
  * Decodes an MCP tool result down to its data payload.
  *
- * Default (`prefer: "structured"`): `isError` → throw the first text block,
+ * Default (`prefer: "structured"`): `isError` → throw a
+ * {@link ToolResultError} with the first text block,
  * then `structuredContent` (if non-null), then JSON-decode the first text
  * block (verbatim string if it isn't JSON), then the raw result.
  *

package/dist/lib/parse-tool-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-tool-result.d.ts","sourceRoot":"","sources":["../../src/lib/parse-tool-result.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,CAAC,CAmC9F;AAKD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CASnE"}
+{"version":3,"file":"parse-tool-result.d.ts","sourceRoot":"","sources":["../../src/lib/parse-tool-result.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;CAK7C;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,CAAC,CAmC9F;AAKD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CASnE"}

package/dist/lib/parse-tool-result.js

@@ -1,7 +1,43 @@
+/**
+ * A tool answered with an `isError` result: a deterministic failure of the
+ * call itself (a validation error, an engine 404), not of the transport.
+ * Thrown by {@link parseToolResult}. The query hooks retry it like any
+ * failure by default (the client's `retry`); pass `retry: shouldRetryToolCall`
+ * to stop that, since repeating the call repeats the answer. Still an `Error`
+ * with the tool's first text block as its message.
+ */
+export class ToolResultError extends Error {
+    /** The `isError` result as the tool returned it. */
+    result;
+    constructor(message, result) {
+        super(message);
+        this.name = "ToolResultError";
+        this.result = result;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+/**
+ * Whether `error` is a tool's own `isError` answer: a {@link ToolResultError},
+ * or mcp-use's `ToolError` (how `useDynamicTool` rejects an `isError` result
+ * inside a view), recognised by its name and result so the root barrel never
+ * imports `mcp-use/react`. Transport failures (a lost connection, a JSON-RPC
+ * error such as an unknown tool) are not tool errors.
+ */
+export function isToolError(error) {
+    if (error instanceof ToolResultError)
+        return true;
+    if (!(error instanceof Error) || error.name !== "ToolError")
+        return false;
+    const result = error.result;
+    return isRecord(result) && result.isError === true;
+}
 /**
  * Decodes an MCP tool result down to its data payload.
  *
- * Default (`prefer: "structured"`): `isError` → throw the first text block,
+ * Default (`prefer: "structured"`): `isError` → throw a
+ * {@link ToolResultError} with the first text block,
  * then `structuredContent` (if non-null), then JSON-decode the first text
  * block (verbatim string if it isn't JSON), then the raw result.
  *
@@ -14,7 +50,7 @@
 export function parseToolResult(result, opts) {
     const r = result;
     if (r?.isError)
-        throw new Error(r.content?.[0]?.text ?? "Tool call failed");
+        throw new ToolResultError(r.content?.[0]?.text ?? "Tool call failed", result);
     const fromStructured = () => r?.structuredContent != null ? r.structuredContent : undefined;
     const fromText = () => {
         const text = r?.content?.[0]?.text;

package/dist/lib/parse-tool-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-tool-result.js","sourceRoot":"","sources":["../../src/lib/parse-tool-result.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAc,MAAe,EAAE,IAA6B;IACzF,MAAM,CAAC,GAAG,MAMG,CAAA;IACb,IAAI,CAAC,EAAE,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,kBAAkB,CAAC,CAAA;IAE3E,MAAM,cAAc,GAAG,GAAkB,EAAE,CACzC,CAAC,EAAE,iBAAiB,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,iBAAuB,CAAC,CAAC,CAAC,SAAS,CAAA;IACvE,MAAM,QAAQ,GAAG,GAAkB,EAAE;QACnC,MAAM,IAAI,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAA;QAClC,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,SAAS,CAAA;QAClC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAA;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAS,CAAA;QAClB,CAAC;IACH,CAAC,CAAA;IAED,IAAI,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;QACvB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QACnC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAA;QACnC,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO,UAAU,CAAA;QAC/C,OAAO,CAAM,CAAA;IACf,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,EAAE,CAAA;IACnC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAA;IAC/C,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;IACvB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,CAAM,CAAA;AACf,CAAC;AAKD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAc,MAAe;IAC9D,MAAM,MAAM,GAAG,eAAe,CAAU,MAAM,CAAC,CAAA;IAC/C,MAAM,GAAG,GAAI,MAA8B,EAAE,OAAO,CAAA;IACpD,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,CAAA;IAC5B,IAAI,GAAG,EAAE,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,IAAS,CAAA;QAC1E,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAM,CAAA;IACnF,CAAC;IACD,OAAO,MAAW,CAAA;AACpB,CAAC"}
+{"version":3,"file":"parse-tool-result.js","sourceRoot":"","sources":["../../src/lib/parse-tool-result.ts"],"names":[],"mappings":"AAkBA;;;;;;;GAOG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,oDAAoD;IAC3C,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,eAAe;QAAE,OAAO,IAAI,CAAA;IACjD,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IACzE,MAAM,MAAM,GAAa,KAAsC,CAAC,MAAM,CAAA;IACtE,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,CAAA;AACpD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAc,MAAe,EAAE,IAA6B;IACzF,MAAM,CAAC,GAAG,MAMG,CAAA;IACb,IAAI,CAAC,EAAE,OAAO;QAAE,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,CAAC,CAAA;IAE7F,MAAM,cAAc,GAAG,GAAkB,EAAE,CACzC,CAAC,EAAE,iBAAiB,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,iBAAuB,CAAC,CAAC,CAAC,SAAS,CAAA;IACvE,MAAM,QAAQ,GAAG,GAAkB,EAAE;QACnC,MAAM,IAAI,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAA;QAClC,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,SAAS,CAAA;QAClC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAA;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAS,CAAA;QAClB,CAAC;IACH,CAAC,CAAA;IAED,IAAI,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;QACvB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QACnC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAA;QACnC,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO,UAAU,CAAA;QAC/C,OAAO,CAAM,CAAA;IACf,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,EAAE,CAAA;IACnC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAA;IAC/C,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;IACvB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,CAAM,CAAA;AACf,CAAC;AAKD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAc,MAAe;IAC9D,MAAM,MAAM,GAAG,eAAe,CAAU,MAAM,CAAC,CAAA;IAC/C,MAAM,GAAG,GAAI,MAA8B,EAAE,OAAO,CAAA;IACpD,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,CAAA;IAC5B,IAAI,GAAG,EAAE,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,IAAS,CAAA;QAC1E,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAM,CAAA;IACnF,CAAC;IACD,OAAO,MAAW,CAAA;AACpB,CAAC"}

package/dist/lib/toast-model.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Pure model behind `ToastProvider` / `useToast`: the toast list as a reducer
+ * plus the timing rules, so both are testable without a DOM (the house path,
+ * FITNESS.md) and the component stays a thin view over them.
+ */
+/** Status tone of a toast — the four status roles (`--success` … `--info`). */
+export type ToastTone = "success" | "warning" | "danger" | "info";
+/**
+ * The toast tone of any tone name: the four status tones as is, a retired
+ * name through `resolveTone` (`error` → `danger`), and `neutral` or anything
+ * unknown as `info`. Keeps a toast whose tone arrives untyped (plain JS, wire
+ * data) on the screen instead of crashing the view on a missing icon.
+ */
+export declare function resolveToastTone(name: unknown): ToastTone;
+/** What a caller passes to `useToast().show(...)`. */
+export interface ToastOptions {
+    /**
+     * Status tone; drives the edge, the icon and the default duration. Default
+     * `"info"`. An untyped retired name still resolves ({@link resolveToastTone}).
+     */
+    tone?: ToastTone;
+    /** The message. Say what happened, in one short sentence ("Job retried."). */
+    title: string;
+    /** Optional second line (what you can do next, or the affected object). */
+    description?: string;
+    /** Auto-dismiss after this many ms. Defaults per {@link toastDuration}. */
+    duration?: number;
+}
+/** A toast as it sits in the list. */
+export interface ToastItem {
+    id: number;
+    tone: ToastTone;
+    title: string;
+    description?: string;
+    duration: number;
+}
+/** Default lifetime of a toast (CI §8: about 2.8 s). */
+export declare const TOAST_DURATION_MS = 2800;
+/** Lifetime of an error toast (CI §8: about 5 s) — long enough to read the reason. */
+export declare const TOAST_ERROR_DURATION_MS = 5000;
+/** At most this many toasts stack; the oldest leaves first. */
+export declare const MAX_VISIBLE_TOASTS = 3;
+/** The lifetime of a toast: an explicit positive duration, else the tone's default. */
+export declare function toastDuration(tone: ToastTone, explicit?: number): number;
+/** Normalise caller options into a list item. */
+export declare function createToast(id: number, options: ToastOptions): ToastItem;
+export type ToastAction = {
+    type: "add";
+    toast: ToastItem;
+} | {
+    type: "dismiss";
+    id: number;
+};
+/** Add appends (dropping the oldest beyond {@link MAX_VISIBLE_TOASTS}); dismiss removes by id. */
+export declare function toastReducer(state: readonly ToastItem[], action: ToastAction): ToastItem[];
+/**
+ * The clock a {@link createToastTimer} runs on. The default reads the global
+ * timers at call time, so fake timers installed in a test take effect.
+ */
+export interface ToastClock {
+    now: () => number;
+    setTimeout: (callback: () => void, ms: number) => unknown;
+    clearTimeout: (handle: unknown) => void;
+}
+/** The countdown of one toast (see {@link createToastTimer}). */
+export interface ToastTimer {
+    /**
+     * Hold the toast for `reason` (`"pointer"`, `"focus"`): the countdown
+     * pauses and keeps the time that was left.
+     */
+    hold: (reason: string) => void;
+    /** Release `reason`; once nothing holds the toast, it resumes with the time that was left. */
+    release: (reason: string) => void;
+    /** The time left in ms — frozen while held. */
+    remaining: () => number;
+    /** Stop for good (the toast left early or unmounted); `onExpire` never fires afterwards. */
+    cancel: () => void;
+}
+/**
+ * A pausable countdown: starts at once, pauses while anything holds it
+ * (hover, keyboard focus — so a reader can finish), and on release RESUMES
+ * WITH THE REMAINING TIME instead of restarting the full duration. Fires
+ * `onExpire` once.
+ */
+export declare function createToastTimer(duration: number, onExpire: () => void, clock?: ToastClock): ToastTimer;
+//# sourceMappingURL=toast-model.d.ts.map

package/dist/lib/toast-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-model.d.ts","sourceRoot":"","sources":["../../src/lib/toast-model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEjE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAGzD;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,OAAO,CAAA;AACrC,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAC3C,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,CASxE;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7F,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,CAI1F;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,MAAM,CAAA;IACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IACzD,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;CACxC;AAQD,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,8FAA8F;IAC9F,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,MAAM,CAAA;IACvB,4FAA4F;IAC5F,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,IAAI,EACpB,KAAK,GAAE,UAAyB,GAC/B,UAAU,CA2CZ"}

package/dist/lib/toast-model.js

@@ -0,0 +1,102 @@
+/**
+ * Pure model behind `ToastProvider` / `useToast`: the toast list as a reducer
+ * plus the timing rules, so both are testable without a DOM (the house path,
+ * FITNESS.md) and the component stays a thin view over them.
+ */
+import { resolveTone } from "./tone-utils.js";
+/**
+ * The toast tone of any tone name: the four status tones as is, a retired
+ * name through `resolveTone` (`error` → `danger`), and `neutral` or anything
+ * unknown as `info`. Keeps a toast whose tone arrives untyped (plain JS, wire
+ * data) on the screen instead of crashing the view on a missing icon.
+ */
+export function resolveToastTone(name) {
+    const tone = resolveTone(name, "info");
+    return tone === "neutral" ? "info" : tone;
+}
+/** Default lifetime of a toast (CI §8: about 2.8 s). */
+export const TOAST_DURATION_MS = 2800;
+/** Lifetime of an error toast (CI §8: about 5 s) — long enough to read the reason. */
+export const TOAST_ERROR_DURATION_MS = 5000;
+/** At most this many toasts stack; the oldest leaves first. */
+export const MAX_VISIBLE_TOASTS = 3;
+/** The lifetime of a toast: an explicit positive duration, else the tone's default. */
+export function toastDuration(tone, explicit) {
+    if (explicit !== undefined && Number.isFinite(explicit) && explicit > 0)
+        return explicit;
+    return tone === "danger" ? TOAST_ERROR_DURATION_MS : TOAST_DURATION_MS;
+}
+/** Normalise caller options into a list item. */
+export function createToast(id, options) {
+    const tone = resolveToastTone(options.tone);
+    return {
+        id,
+        tone,
+        title: options.title,
+        ...(options.description ? { description: options.description } : {}),
+        duration: toastDuration(tone, options.duration),
+    };
+}
+/** Add appends (dropping the oldest beyond {@link MAX_VISIBLE_TOASTS}); dismiss removes by id. */
+export function toastReducer(state, action) {
+    if (action.type === "add")
+        return [...state, action.toast].slice(-MAX_VISIBLE_TOASTS);
+    const next = state.filter((t) => t.id !== action.id);
+    return next.length === state.length ? state : next;
+}
+const SYSTEM_CLOCK = {
+    now: () => Date.now(),
+    setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),
+    clearTimeout: (handle) => globalThis.clearTimeout(handle),
+};
+/**
+ * A pausable countdown: starts at once, pauses while anything holds it
+ * (hover, keyboard focus — so a reader can finish), and on release RESUMES
+ * WITH THE REMAINING TIME instead of restarting the full duration. Fires
+ * `onExpire` once.
+ */
+export function createToastTimer(duration, onExpire, clock = SYSTEM_CLOCK) {
+    let left = Math.max(duration, 0);
+    let startedAt = 0;
+    let handle;
+    let running = false;
+    let finished = false;
+    const holds = new Set();
+    const elapsed = () => (running ? clock.now() - startedAt : 0);
+    const start = () => {
+        if (finished || running || holds.size > 0)
+            return;
+        running = true;
+        startedAt = clock.now();
+        handle = clock.setTimeout(() => {
+            running = false;
+            finished = true;
+            left = 0;
+            onExpire();
+        }, left);
+    };
+    const pause = () => {
+        if (!running)
+            return;
+        left = Math.max(left - elapsed(), 0);
+        running = false;
+        clock.clearTimeout(handle);
+    };
+    start();
+    return {
+        hold: (reason) => {
+            holds.add(reason);
+            pause();
+        },
+        release: (reason) => {
+            holds.delete(reason);
+            start();
+        },
+        remaining: () => Math.max(left - elapsed(), 0),
+        cancel: () => {
+            pause();
+            finished = true;
+        },
+    };
+}
+//# sourceMappingURL=toast-model.js.map

package/dist/lib/toast-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-model.js","sourceRoot":"","sources":["../../src/lib/toast-model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAK7C;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACtC,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AAC3C,CAAC;AA0BD,wDAAwD;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAA;AACrC,sFAAsF;AACtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAA;AAC3C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAEnC,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,QAAiB;IAC9D,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAA;IACxF,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,iBAAiB,CAAA;AACxE,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,WAAW,CAAC,EAAU,EAAE,OAAqB;IAC3D,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO;QACL,EAAE;QACF,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,QAAQ,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC;KAChD,CAAA;AACH,CAAC;AAID,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAAC,KAA2B,EAAE,MAAmB;IAC3E,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,CAAA;IACrF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAA;IACpD,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,KAAqB,CAAC,CAAC,CAAC,IAAI,CAAA;AACrE,CAAC;AAYD,MAAM,YAAY,GAAe;IAC/B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;IACjE,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,MAAuC,CAAC;CAC3F,CAAA;AAiBD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,QAAoB,EACpB,QAAoB,YAAY;IAEhC,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IAChC,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,IAAI,MAAe,CAAA;IACnB,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAE/B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,QAAQ,IAAI,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;YAAE,OAAM;QACjD,OAAO,GAAG,IAAI,CAAA;QACd,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;QACvB,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE;YAC7B,OAAO,GAAG,KAAK,CAAA;YACf,QAAQ,GAAG,IAAI,CAAA;YACf,IAAI,GAAG,CAAC,CAAA;YACR,QAAQ,EAAE,CAAA;QACZ,CAAC,EAAE,IAAI,CAAC,CAAA;IACV,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;QACpC,OAAO,GAAG,KAAK,CAAA;QACf,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,KAAK,EAAE,CAAA;IACP,OAAO;QACL,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACf,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACjB,KAAK,EAAE,CAAA;QACT,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YAClB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACpB,KAAK,EAAE,CAAA;QACT,CAAC;QACD,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,EAAE,GAAG,EAAE;YACX,KAAK,EAAE,CAAA;YACP,QAAQ,GAAG,IAAI,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/lib/tone-utils.d.ts

@@ -1,18 +1,104 @@
 /**
  * Single source of truth for the semantic "tones" used across the tone-aware
- * components (`Pills`, `KpiGrid`, `WidgetHeader`, …).
+ * components (`Pills`, `StatusBadge`, `KpiGrid`, `Badge`, …).
  *
- * Each tone maps to the status tokens defined in `globals.css`
- * (`--danger`, `--warning`, `--success`, `--info`) plus the shadcn neutral ramp
- * for the `neutral` tone. All tokens carry light + dark values, so these class
- * strings re-theme automatically — change a tone in one place instead of
- * hand-rolling `tone === "x" ? "…" : "…"` ternaries at every call site.
+ * ONE vocabulary: `success | warning | danger | info | neutral`
+ * ({@link TONE_VARIANTS}). Retired or foreign names (`critical`, `error`,
+ * `destructive`, …) map onto it through {@link resolveTone}, so a tone that
+ * arrives as data (a server-built KPI cell) never renders without a colour.
+ *
+ * Every status tone has THREE roles (Miragon CI §3.3), each its own token in
+ * `theme.css` with light and dark values:
+ *
+ * | Role                         | Token           | Map            |
+ * | ---------------------------- | --------------- | -------------- |
+ * | fill, dot, border, icon      | `--<tone>`      | `TONE_DOT`, `TONE_BORDER`, `TONE_ICON` |
+ * | tint (badge/banner surface)  | `--<tone>-soft` | `TONE_SOFT`, `TONE_TINT` (text on it: the foreground) |
+ * | text on a plain surface      | `--<tone>-ink`  | `TONE_INK`     |
+ *
+ * Status is never text in its own colour: success and warning reach only
+ * 1.67:1 / 1.83:1 on white, so their ink is the foreground and the tone shows
+ * as a dot, icon or border NEXT to the text. On a tint the text is always the
+ * foreground (CI §3.3: "-soft: Text darauf --cd-schwarz, Rand in der
+ * Statusfarbe"), so pair `TONE_SOFT` with `TONE_BORDER`. `TONE_INK` is for
+ * a tone's words on a plain surface (a field error); figures — counts, KPI
+ * values, trends — never take it: they stay in the foreground next to a
+ * `TONE_DOT`. In dark mode the colours are the `-hell` values and the tints
+ * are transparent (no tinted fills on dark). The `neutral` tone reuses the
+ * muted ramp.
+ *
+ * Change a tone here, in one place, instead of hand-rolling
+ * `tone === "x" ? "…" : "…"` ternaries at every call site.
  */
 export type ToneVariant = "neutral" | "info" | "success" | "warning" | "danger";
-/** Tinted background + readable foreground — badges, icon tiles, pills. */
+/** Every tone, in severity order (for loops, pickers and validation). */
+export declare const TONE_VARIANTS: readonly ToneVariant[];
+/**
+ * Retired or foreign tone names and the tone each one means. One red and one
+ * amber (CI §3.3): `critical`, `error` and `destructive` are `danger`; there
+ * is no separate severity above it. The names on the left are deprecated:
+ * write the {@link ToneVariant} on the right. The map stays so data written
+ * against an older vocabulary (a widget-shell `critical`, a shadcn
+ * `destructive`) keeps its colour.
+ */
+export declare const TONE_ALIASES: {
+    readonly critical: "danger";
+    readonly error: "danger";
+    readonly destructive: "danger";
+    readonly failure: "danger";
+    readonly warn: "warning";
+    readonly ok: "success";
+    readonly positive: "success";
+    readonly notice: "info";
+    readonly default: "neutral";
+    readonly muted: "neutral";
+    readonly secondary: "neutral";
+};
+/** A name {@link resolveTone} maps onto a tone (see {@link TONE_ALIASES}). */
+export type ToneAlias = keyof typeof TONE_ALIASES;
+/**
+ * What a tone-aware component accepts: a {@link ToneVariant}, or a retired
+ * name that {@link resolveTone} maps onto one.
+ */
+export type ToneName = ToneVariant | ToneAlias;
+/** Whether `value` is one of the five tones (a type guard for data from the wire). */
+export declare function isToneVariant(value: unknown): value is ToneVariant;
+/**
+ * Map any tone name onto the vocabulary: a {@link ToneVariant} as is, a
+ * retired name ({@link TONE_ALIASES}, case-insensitive) onto its tone, and
+ * anything else — unknown, empty, not a string — onto `fallback` (default
+ * `"neutral"`, the tone without a state).
+ */
+export declare function resolveTone(name: unknown, fallback?: ToneVariant): ToneVariant;
+/**
+ * Tinted surface + its text (the foreground: CI §3.3) — badges, pills,
+ * banners. Pair it with {@link TONE_BORDER}: the rim carries the tone, and in
+ * dark mode (no tints) it is all that does. The neutral tint is the muted
+ * surface, its text the foreground too (a count on it is a figure).
+ */
 export declare const TONE_SOFT: Record<ToneVariant, string>;
-/** Solid dot color — status dots next to a label. */
+/** The tint alone, for a surface that sets its text itself (a soft KPI card). */
+export declare const TONE_TINT: Record<ToneVariant, string>;
+/** Solid dot colour — a status dot next to a label, a bar, a meter fill. */
 export declare const TONE_DOT: Record<ToneVariant, string>;
-/** Foreground-only color — metric values, inline emphasis. */
+/**
+ * The tone's TEXT colour (its `-ink` role) for words on a plain surface — a
+ * field error, a "missing" label. Success and warning resolve to the
+ * foreground on light: pair the text with a {@link TONE_DOT} or
+ * {@link TONE_ICON} to show the tone. Never on a tint (use {@link TONE_SOFT})
+ * and never for figures (they stay in the foreground next to a dot).
+ */
+export declare const TONE_INK: Record<ToneVariant, string>;
+/**
+ * @deprecated Renamed to {@link TONE_INK} after the role it maps onto
+ * (`--<tone>-ink`); the same object, kept for existing imports.
+ */
 export declare const TONE_TEXT: Record<ToneVariant, string>;
+/** Border colour in the tone — the rim of a tinted badge, banner or toast. */
+export declare const TONE_BORDER: Record<ToneVariant, string>;
+/**
+ * Icon colour in the tone (SVG `currentColor`). For icons only — never for
+ * text: an icon next to its label carries the tone, the label stays readable.
+ */
+export declare const TONE_ICON: Record<ToneVariant, string>;
 //# sourceMappingURL=tone-utils.d.ts.map

package/dist/lib/tone-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tone-utils.d.ts","sourceRoot":"","sources":["../../src/lib/tone-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE/E,2EAA2E;AAC3E,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMjD,CAAA;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMhD,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMjD,CAAA"}
+{"version":3,"file":"tone-utils.d.ts","sourceRoot":"","sources":["../../src/lib/tone-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE/E,yEAAyE;AACzE,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAM/C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;CAYuB,CAAA;AAEhD,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,YAAY,CAAA;AAEjD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;AAI9C,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,GAAE,WAAuB,GAAG,WAAW,CAKzF;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMjD,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMjD,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMhD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMhD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAY,CAAA;AAE9D,8EAA8E;AAC9E,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMnD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMjD,CAAA"}

package/dist/lib/tone-utils.js

@@ -1,12 +1,73 @@
-/** Tinted background + readable foreground — badges, icon tiles, pills. */
+/** Every tone, in severity order (for loops, pickers and validation). */
+export const TONE_VARIANTS = [
+    "danger",
+    "warning",
+    "success",
+    "info",
+    "neutral",
+];
+/**
+ * Retired or foreign tone names and the tone each one means. One red and one
+ * amber (CI §3.3): `critical`, `error` and `destructive` are `danger`; there
+ * is no separate severity above it. The names on the left are deprecated:
+ * write the {@link ToneVariant} on the right. The map stays so data written
+ * against an older vocabulary (a widget-shell `critical`, a shadcn
+ * `destructive`) keeps its colour.
+ */
+export const TONE_ALIASES = {
+    critical: "danger",
+    error: "danger",
+    destructive: "danger",
+    failure: "danger",
+    warn: "warning",
+    ok: "success",
+    positive: "success",
+    notice: "info",
+    default: "neutral",
+    muted: "neutral",
+    secondary: "neutral",
+};
+const TONE_SET = new Set(TONE_VARIANTS);
+/** Whether `value` is one of the five tones (a type guard for data from the wire). */
+export function isToneVariant(value) {
+    return typeof value === "string" && TONE_SET.has(value);
+}
+/**
+ * Map any tone name onto the vocabulary: a {@link ToneVariant} as is, a
+ * retired name ({@link TONE_ALIASES}, case-insensitive) onto its tone, and
+ * anything else — unknown, empty, not a string — onto `fallback` (default
+ * `"neutral"`, the tone without a state).
+ */
+export function resolveTone(name, fallback = "neutral") {
+    if (typeof name !== "string")
+        return fallback;
+    const key = name.trim().toLowerCase();
+    if (TONE_SET.has(key))
+        return key;
+    return Object.hasOwn(TONE_ALIASES, key) ? TONE_ALIASES[key] : fallback;
+}
+/**
+ * Tinted surface + its text (the foreground: CI §3.3) — badges, pills,
+ * banners. Pair it with {@link TONE_BORDER}: the rim carries the tone, and in
+ * dark mode (no tints) it is all that does. The neutral tint is the muted
+ * surface, its text the foreground too (a count on it is a figure).
+ */
 export const TONE_SOFT = {
-    neutral: "bg-muted text-muted-foreground",
-    info: "bg-info-soft text-info",
-    success: "bg-success-soft text-success",
-    warning: "bg-warning-soft text-warning",
-    danger: "bg-danger-soft text-danger",
+    neutral: "bg-muted text-foreground",
+    info: "bg-info-soft text-foreground",
+    success: "bg-success-soft text-foreground",
+    warning: "bg-warning-soft text-foreground",
+    danger: "bg-danger-soft text-foreground",
+};
+/** The tint alone, for a surface that sets its text itself (a soft KPI card). */
+export const TONE_TINT = {
+    neutral: "bg-muted",
+    info: "bg-info-soft",
+    success: "bg-success-soft",
+    warning: "bg-warning-soft",
+    danger: "bg-danger-soft",
 };
-/** Solid dot color — status dots next to a label. */
+/** Solid dot colour — a status dot next to a label, a bar, a meter fill. */
 export const TONE_DOT = {
     neutral: "bg-muted-foreground",
     info: "bg-info",
@@ -14,9 +75,39 @@ export const TONE_DOT = {
     warning: "bg-warning",
     danger: "bg-danger",
 };
-/** Foreground-only color — metric values, inline emphasis. */
-export const TONE_TEXT = {
+/**
+ * The tone's TEXT colour (its `-ink` role) for words on a plain surface — a
+ * field error, a "missing" label. Success and warning resolve to the
+ * foreground on light: pair the text with a {@link TONE_DOT} or
+ * {@link TONE_ICON} to show the tone. Never on a tint (use {@link TONE_SOFT})
+ * and never for figures (they stay in the foreground next to a dot).
+ */
+export const TONE_INK = {
     neutral: "text-foreground",
+    info: "text-info-ink",
+    success: "text-success-ink",
+    warning: "text-warning-ink",
+    danger: "text-danger-ink",
+};
+/**
+ * @deprecated Renamed to {@link TONE_INK} after the role it maps onto
+ * (`--<tone>-ink`); the same object, kept for existing imports.
+ */
+export const TONE_TEXT = TONE_INK;
+/** Border colour in the tone — the rim of a tinted badge, banner or toast. */
+export const TONE_BORDER = {
+    neutral: "border-border",
+    info: "border-info",
+    success: "border-success",
+    warning: "border-warning",
+    danger: "border-danger",
+};
+/**
+ * Icon colour in the tone (SVG `currentColor`). For icons only — never for
+ * text: an icon next to its label carries the tone, the label stays readable.
+ */
+export const TONE_ICON = {
+    neutral: "text-muted-foreground",
     info: "text-info",
     success: "text-success",
     warning: "text-warning",

package/dist/lib/tone-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"tone-utils.js","sourceRoot":"","sources":["../../src/lib/tone-utils.ts"],"names":[],"mappings":"AAYA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,OAAO,EAAE,gCAAgC;IACzC,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,8BAA8B;IACvC,OAAO,EAAE,8BAA8B;IACvC,MAAM,EAAE,4BAA4B;CACrC,CAAA;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAgC;IACnD,OAAO,EAAE,qBAAqB;IAC9B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,OAAO,EAAE,iBAAiB;IAC1B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,aAAa;CACtB,CAAA"}
+{"version":3,"file":"tone-utils.js","sourceRoot":"","sources":["../../src/lib/tone-utils.ts"],"names":[],"mappings":"AAkCA,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,QAAQ;IACR,SAAS;IACT,SAAS;IACT,MAAM;IACN,SAAS;CACV,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,QAAQ;IAClB,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,SAAS;IACf,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;CAC0B,CAAA;AAWhD,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,aAAa,CAAC,CAAA;AAE5D,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,WAAwB,SAAS;IAC1E,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACrC,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,GAAkB,CAAA;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAgB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AACrF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,OAAO,EAAE,0BAA0B;IACnC,IAAI,EAAE,8BAA8B;IACpC,OAAO,EAAE,iCAAiC;IAC1C,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,gCAAgC;CACzC,CAAA;AAED,iFAAiF;AACjF,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,gBAAgB;CACzB,CAAA;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,QAAQ,GAAgC;IACnD,OAAO,EAAE,qBAAqB;IAC9B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAgC;IACnD,OAAO,EAAE,iBAAiB;IAC1B,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,kBAAkB;IAC3B,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,iBAAiB;CAC1B,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgC,QAAQ,CAAA;AAE9D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAgC;IACtD,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,gBAAgB;IACzB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,eAAe;CACxB,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,OAAO,EAAE,uBAAuB;IAChC,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,aAAa;CACtB,CAAA"}