@miragon/mcp-toolkit-ui 2.5.0 → 2.7.0

package/dist/index.js.map

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

package/dist/lib/focus-ring.d.ts

@@ -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 declare 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 declare const FOCUS_RING_INSET = "outline-hidden focus-visible:ring-2 focus-visible:ring-focus focus-visible:ring-inset";
+//# sourceMappingURL=focus-ring.d.ts.map

package/dist/lib/focus-ring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-ring.d.ts","sourceRoot":"","sources":["../../src/lib/focus-ring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,kIAC0G,CAAA;AAEjI,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,0FAC4D,CAAA"}

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/toast-model.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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";
+/** What a caller passes to `useToast().show(...)`. */
+export interface ToastOptions {
+    /** Status tone; drives the edge, the icon and the default duration. Default `"info"`. */
+    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[];
+//# 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;AAEH,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEjE,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,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"}

package/dist/lib/toast-model.js

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ */
+/** 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 = options.tone ?? "info";
+    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;
+}
+//# 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;AA0BH,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,OAAO,CAAC,IAAI,IAAI,MAAM,CAAA;IACnC,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"}

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

@@ -1,18 +1,52 @@
 /**
  * Single source of truth for the semantic "tones" used across the tone-aware
- * components (`Pills`, `KpiGrid`, `WidgetHeader`, …).
+ * components (`Pills`, `KpiGrid`, `WidgetHeader`, `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.
+ * 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` (text on it: the foreground) |
+ * | text on a plain surface      | `--<tone>-ink`  | `TONE_TEXT`    |
+ *
+ * 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_TEXT` 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. */
+/**
+ * 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.
+ */
 export declare const TONE_SOFT: Record<ToneVariant, string>;
-/** Solid dot color — status dots next to a label. */
+/** Solid dot colour — a status dot next to a label. */
 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_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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE/E;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMjD,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMhD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAMjD,CAAA;AAED,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,16 @@
-/** Tinted background + readable foreground — badges, icon tiles, pills. */
+/**
+ * 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.
+ */
 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",
+    info: "bg-info-soft text-foreground",
+    success: "bg-success-soft text-foreground",
+    warning: "bg-warning-soft text-foreground",
+    danger: "bg-danger-soft text-foreground",
 };
-/** Solid dot color — status dots next to a label. */
+/** Solid dot colour — a status dot next to a label. */
 export const TONE_DOT = {
     neutral: "bg-muted-foreground",
     info: "bg-info",
@@ -14,9 +18,34 @@ export const TONE_DOT = {
     warning: "bg-warning",
     danger: "bg-danger",
 };
-/** 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 const TONE_TEXT = {
     neutral: "text-foreground",
+    info: "text-info-ink",
+    success: "text-success-ink",
+    warning: "text-warning-ink",
+    danger: "text-danger-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":"AA6BA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,OAAO,EAAE,gCAAgC;IACzC,IAAI,EAAE,8BAA8B;IACpC,OAAO,EAAE,iCAAiC;IAC1C,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,gCAAgC;CACzC,CAAA;AAED,uDAAuD;AACvD,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,SAAS,GAAgC;IACpD,OAAO,EAAE,iBAAiB;IAC1B,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,kBAAkB;IAC3B,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,iBAAiB;CAC1B,CAAA;AAED,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"}

package/dist/locale/index.d.ts

@@ -1,3 +1,5 @@
-export { LocaleProvider, useLocale, useTranslate } from "./locale-provider.js";
+export { LocaleProvider, useLocale, useTranslate, useToolkitMessages } from "./locale-provider.js";
 export type { LocaleContextValue, LocaleProviderProps, BoundTranslate } from "./locale-provider.js";
+export { TOOLKIT_MESSAGES, formatCount, resolveToolkitMessages } from "./toolkit-messages.js";
+export type { BuilderMessages, CommonMessages, ListFooterMessages, PropsSheetMessages, RendererMessages, ToolkitLocale, ToolkitMessages, ToolkitMessagesOverride, ViewMessages, } from "./toolkit-messages.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/locale/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locale/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC9E,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locale/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAClG,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACnG,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC7F,YAAY,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,YAAY,GACb,MAAM,uBAAuB,CAAA"}

package/dist/locale/index.js

@@ -3,5 +3,6 @@
 // <LocaleProvider> and reads the active locale with useLocale/useTranslate,
 // without pulling in the host runtime. Pairs with `createTranslator` from
 // `@miragon/mcp-toolkit-core`.
-export { LocaleProvider, useLocale, useTranslate } from "./locale-provider.js";
+export { LocaleProvider, useLocale, useTranslate, useToolkitMessages } from "./locale-provider.js";
+export { TOOLKIT_MESSAGES, formatCount, resolveToolkitMessages } from "./toolkit-messages.js";
 //# sourceMappingURL=index.js.map

package/dist/locale/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/locale/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yEAAyE;AACzE,4EAA4E;AAC5E,0EAA0E;AAC1E,+BAA+B;AAC/B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/locale/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yEAAyE;AACzE,4EAA4E;AAC5E,0EAA0E;AAC1E,+BAA+B;AAC/B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAElG,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/locale/locale-provider.d.ts

@@ -1,5 +1,6 @@
 import { type ReactNode } from "react";
 import type { Translate } from "@miragon/mcp-toolkit-core";
+import { type ToolkitMessages, type ToolkitMessagesOverride } from "./toolkit-messages.js";
 /**
  * A locale-bound translate: the active locale is already applied, so call sites
  * only pass a key (+ params). Obtained from {@link useTranslate}.
@@ -11,6 +12,14 @@ export interface LocaleContextValue {
     locale: string;
     /** Translate a key in the active locale. */
     t: BoundTranslate;
+    /**
+     * The toolkit's own strings for the active locale (its shipped `en`/`de`
+     * catalog, English for any other locale) with the provider's
+     * `toolkitMessages` override applied. Read it with {@link useToolkitMessages}.
+     * Optional on the type (a hand-built value may omit it); `LocaleProvider`
+     * always sets it.
+     */
+    messages?: ToolkitMessages;
 }
 /** Read the active locale tag from the nearest {@link LocaleProvider}. */
 export declare function useLocale(): string;
@@ -20,6 +29,32 @@ export declare function useLocale(): string;
  * render their keys instead of throwing.
  */
 export declare function useTranslate(): BoundTranslate;
+/**
+ * The toolkit's own UI strings for the nearest {@link LocaleProvider}'s locale
+ * (English outside a provider). Every toolkit component reads its captions,
+ * labels and accessible names here, so a German locale renders no English
+ * toolkit chrome.
+ */
+export declare function useToolkitMessages(): ToolkitMessages;
+/**
+ * The locale the toolkit's own text is in: the nearest {@link LocaleProvider}'s,
+ * else a {@link ToolkitLocaleFallback}'s (the host's, inside `McpAppView`),
+ * else `"en"`. Toolkit components format their numbers with it, so a count
+ * always matches the language of the sentence around it. Internal: consumer
+ * widgets read {@link useLocale}.
+ */
+export declare function useToolkitLocale(): string;
+/**
+ * Binds ONLY the toolkit's own strings and number format to `locale` for a
+ * subtree — the fallback `McpAppView` mounts with the host's locale. It is not
+ * a {@link LocaleProvider}: {@link useLocale} and {@link useTranslate} keep
+ * their outside-a-provider behaviour (`"en"`, echoed keys) for consumer
+ * widgets, and any `LocaleProvider` above or below wins over it.
+ */
+export declare function ToolkitLocaleFallback({ locale, children, }: {
+    locale: string;
+    children: ReactNode;
+}): ReactNode;
 export interface LocaleProviderProps {
     /** The active locale tag (e.g. `"en"`, `"de"`). */
     locale: string;
@@ -29,6 +64,12 @@ export interface LocaleProviderProps {
      * consumer wires the locale before any catalog exists.
      */
     translator?: Translate;
+    /**
+     * Override individual toolkit strings for this subtree, per catalog section
+     * (e.g. `{ listFooter: { loadMore: "Show more" } }`). Omitted entries keep the
+     * shipped `en`/`de` catalog of `locale`.
+     */
+    toolkitMessages?: ToolkitMessagesOverride;
     children: ReactNode;
 }
 /**
@@ -46,5 +87,5 @@ export interface LocaleProviderProps {
  *   <YourWidget />
  * </LocaleProvider>
  */
-export declare function LocaleProvider({ locale, translator, children }: LocaleProviderProps): ReactNode;
+export declare function LocaleProvider({ locale, translator, toolkitMessages, children, }: LocaleProviderProps): ReactNode;
 //# sourceMappingURL=locale-provider.d.ts.map

package/dist/locale/locale-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locale-provider.d.ts","sourceRoot":"","sources":["../../src/locale/locale-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;AAEtF,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,CAAC,EAAE,cAAc,CAAA;CAClB;AAeD,0EAA0E;AAC1E,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,cAAc,CAE7C;AAED,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,SAAS,CAS/F"}
+{"version":3,"file":"locale-provider.d.ts","sourceRoot":"","sources":["../../src/locale/locale-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAA;AAE9B;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;AAEtF,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,CAAC,EAAE,cAAc,CAAA;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AA2BD,0EAA0E;AAC1E,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,cAAc,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,SAAS,CAAA;CACpB,GAAG,SAAS,CAUZ;AAED,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,UAAU,EACV,eAAe,EACf,QAAQ,GACT,EAAE,mBAAmB,GAAG,SAAS,CAUjC"}

package/dist/locale/locale-provider.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useMemo } from "react";
+import { resolveToolkitMessages, } from "./toolkit-messages.js";
 const DEFAULT_LOCALE = "en";
 /**
  * Default used when a widget renders *outside* a {@link LocaleProvider} (e.g. a
@@ -8,8 +9,13 @@ const DEFAULT_LOCALE = "en";
  * missing wrapper echoes the key (visible + greppable) instead of crashing a
  * widget that is perfectly renderable in English.
  */
-const DEFAULT_VALUE = { locale: DEFAULT_LOCALE, t: (key) => key };
+const DEFAULT_VALUE = {
+    locale: DEFAULT_LOCALE,
+    t: (key) => key,
+    messages: resolveToolkitMessages(DEFAULT_LOCALE),
+};
 const LocaleContext = createContext(null);
+const ToolkitLocaleFallbackContext = createContext(null);
 /** Read the active locale tag from the nearest {@link LocaleProvider}. */
 export function useLocale() {
     return useContext(LocaleContext)?.locale ?? DEFAULT_VALUE.locale;
@@ -22,6 +28,40 @@ export function useLocale() {
 export function useTranslate() {
     return useContext(LocaleContext)?.t ?? DEFAULT_VALUE.t;
 }
+/**
+ * The toolkit's own UI strings for the nearest {@link LocaleProvider}'s locale
+ * (English outside a provider). Every toolkit component reads its captions,
+ * labels and accessible names here, so a German locale renders no English
+ * toolkit chrome.
+ */
+export function useToolkitMessages() {
+    const provided = useContext(LocaleContext);
+    const fallback = useContext(ToolkitLocaleFallbackContext);
+    return provided?.messages ?? fallback?.messages ?? DEFAULT_VALUE.messages;
+}
+/**
+ * The locale the toolkit's own text is in: the nearest {@link LocaleProvider}'s,
+ * else a {@link ToolkitLocaleFallback}'s (the host's, inside `McpAppView`),
+ * else `"en"`. Toolkit components format their numbers with it, so a count
+ * always matches the language of the sentence around it. Internal: consumer
+ * widgets read {@link useLocale}.
+ */
+export function useToolkitLocale() {
+    const provided = useContext(LocaleContext);
+    const fallback = useContext(ToolkitLocaleFallbackContext);
+    return provided?.locale ?? fallback?.locale ?? DEFAULT_VALUE.locale;
+}
+/**
+ * Binds ONLY the toolkit's own strings and number format to `locale` for a
+ * subtree — the fallback `McpAppView` mounts with the host's locale. It is not
+ * a {@link LocaleProvider}: {@link useLocale} and {@link useTranslate} keep
+ * their outside-a-provider behaviour (`"en"`, echoed keys) for consumer
+ * widgets, and any `LocaleProvider` above or below wins over it.
+ */
+export function ToolkitLocaleFallback({ locale, children, }) {
+    const value = useMemo(() => ({ locale, messages: resolveToolkitMessages(locale) }), [locale]);
+    return (_jsx(ToolkitLocaleFallbackContext.Provider, { value: value, children: children }));
+}
 /**
  * Provide the active locale (and an optional translator) to a subtree. Widgets
  * read it with {@link useLocale} / {@link useTranslate}. Pure React (no
@@ -37,11 +77,12 @@ export function useTranslate() {
  *   <YourWidget />
  * </LocaleProvider>
  */
-export function LocaleProvider({ locale, translator, children }) {
+export function LocaleProvider({ locale, translator, toolkitMessages, children, }) {
     const value = useMemo(() => ({
         locale,
         t: translator ? (key, params) => translator(locale, key, params) : (key) => key,
-    }), [locale, translator]);
+        messages: resolveToolkitMessages(locale, toolkitMessages),
+    }), [locale, translator, toolkitMessages]);
     return _jsx(LocaleContext.Provider, { value: value, children: children });
 }
 //# sourceMappingURL=locale-provider.js.map

package/dist/locale/locale-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"locale-provider.js","sourceRoot":"","sources":["../../src/locale/locale-provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAA;AAiB1E,MAAM,cAAc,GAAG,IAAI,CAAA;AAE3B;;;;;;GAMG;AACH,MAAM,aAAa,GAAuB,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAA;AAErF,MAAM,aAAa,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAA;AAEpE,0EAA0E;AAC1E,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,aAAa,CAAC,MAAM,CAAA;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,CAAC,CAAA;AACxD,CAAC;AAcD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAuB;IAClF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;KAChF,CAAC,EACF,CAAC,MAAM,EAAE,UAAU,CAAC,CACrB,CAAA;IACD,OAAO,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA0B,CAAA;AAClF,CAAC"}
+{"version":3,"file":"locale-provider.js","sourceRoot":"","sources":["../../src/locale/locale-provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAA;AAE1E,OAAO,EACL,sBAAsB,GAGvB,MAAM,uBAAuB,CAAA;AAwB9B,MAAM,cAAc,GAAG,IAAI,CAAA;AAE3B;;;;;;GAMG;AACH,MAAM,aAAa,GAAG;IACpB,MAAM,EAAE,cAAc;IACtB,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;IACf,QAAQ,EAAE,sBAAsB,CAAC,cAAc,CAAC;CACV,CAAA;AAExC,MAAM,aAAa,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAA;AAQpE,MAAM,4BAA4B,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAA;AAEnF,0EAA0E;AAC1E,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,CAAC,aAAa,CAAC,EAAE,MAAM,IAAI,aAAa,CAAC,MAAM,CAAA;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,CAAC,CAAA;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,4BAA4B,CAAC,CAAA;IACzD,OAAO,QAAQ,EAAE,QAAQ,IAAI,QAAQ,EAAE,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAA;AAC3E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,4BAA4B,CAAC,CAAA;IACzD,OAAO,QAAQ,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,IAAI,aAAa,CAAC,MAAM,CAAA;AACrE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,MAAM,EACN,QAAQ,GAIT;IACC,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,EAC5D,CAAC,MAAM,CAAC,CACT,CAAA;IACD,OAAO,CACL,KAAC,4BAA4B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAChD,QAAQ,GAC6B,CACzC,CAAA;AACH,CAAC;AAoBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,UAAU,EACV,eAAe,EACf,QAAQ,GACY;IACpB,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;QAC/E,QAAQ,EAAE,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC;KAC1D,CAAC,EACF,CAAC,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,CACtC,CAAA;IACD,OAAO,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA0B,CAAA;AAClF,CAAC"}