@miragon/mcp-toolkit-ui 0.10.1

package/dist/hooks/use-tool-query.d.ts

@@ -0,0 +1,21 @@
+export interface UseToolQueryOptions<TData = unknown, TSelected = TData> {
+    enabled?: boolean;
+    select?: (data: TData) => TSelected;
+}
+/**
+ * Loads data from a widget tool via TanStack Query.
+ *
+ * `args` is appended to the effective query key so two callers that share
+ * the supplied `queryKey` but pass different `args` get separate cache
+ * entries (otherwise the second caller silently reads stale data from the
+ * first — the classic queryKey-vs-args trap). `select` transforms data on
+ * each read without mutating the cache.
+ */
+export declare function useToolQuery<TData = unknown, TSelected = TData>(queryKey: unknown[], toolName: string, args: object, opts?: UseToolQueryOptions<TData, TSelected>): import("@tanstack/react-query").UseQueryResult<NoInfer<TSelected>, Error>;
+/**
+ * Executes a mutation via a widget tool and invalidates configured query keys.
+ */
+export declare function useToolMutation<TData = unknown>(toolName: string, opts?: {
+    invalidateKeys?: unknown[][];
+}): import("@tanstack/react-query").UseMutationResult<TData, Error, Record<string, unknown>, unknown>;
+//# sourceMappingURL=use-tool-query.d.ts.map

package/dist/hooks/use-tool-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tool-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-tool-query.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB,CAAC,KAAK,GAAG,OAAO,EAAE,SAAS,GAAG,KAAK;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAA;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAG,OAAO,EAAE,SAAS,GAAG,KAAK,EAC7D,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,6EAc7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAG,OAAO,EAC7C,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE,CAAA;CAAE,qGAmBxC"}

package/dist/hooks/use-tool-query.js

@@ -0,0 +1,47 @@
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { useCallTool } from "../providers/query-provider.js";
+import { parseToolResult } from "../lib/parse-tool-result.js";
+/**
+ * Loads data from a widget tool via TanStack Query.
+ *
+ * `args` is appended to the effective query key so two callers that share
+ * the supplied `queryKey` but pass different `args` get separate cache
+ * entries (otherwise the second caller silently reads stale data from the
+ * first — the classic queryKey-vs-args trap). `select` transforms data on
+ * each read without mutating the cache.
+ */
+export function useToolQuery(queryKey, toolName, args, opts) {
+    const callTool = useCallTool();
+    return useQuery({
+        queryKey: [...queryKey, args],
+        queryFn: async () => {
+            if (!callTool)
+                throw new Error("callTool not available");
+            const result = await callTool(toolName, args);
+            return parseToolResult(result);
+        },
+        select: opts?.select,
+        enabled: !!callTool && (opts?.enabled ?? true),
+    });
+}
+/**
+ * Executes a mutation via a widget tool and invalidates configured query keys.
+ */
+export function useToolMutation(toolName, opts) {
+    const callTool = useCallTool();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (args) => {
+            if (!callTool)
+                throw new Error("callTool not available");
+            const result = await callTool(toolName, args);
+            return parseToolResult(result);
+        },
+        onSuccess: async () => {
+            if (opts?.invalidateKeys) {
+                await Promise.all(opts.invalidateKeys.map((key) => queryClient.refetchQueries({ queryKey: key })));
+            }
+        },
+    });
+}
+//# sourceMappingURL=use-tool-query.js.map

package/dist/hooks/use-tool-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tool-query.js","sourceRoot":"","sources":["../../src/hooks/use-tool-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAO7D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAmB,EACnB,QAAgB,EAChB,IAAY,EACZ,IAA4C;IAE5C,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAE9B,OAAO,QAAQ,CAA0B;QACvC,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,IAAI,CAAC;QAC7B,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;YACxD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YAC7C,OAAO,eAAe,CAAQ,MAAM,CAAC,CAAA;QACvC,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,MAAM;QACpB,OAAO,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC;KAC/C,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,IAAuC;IAEvC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IAEpC,OAAO,WAAW,CAAwC;QACxD,UAAU,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;YAClD,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;YACxD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YAC7C,OAAO,eAAe,CAAQ,MAAM,CAAC,CAAA;QACvC,CAAC;QACD,SAAS,EAAE,KAAK,IAAI,EAAE;YACpB,IAAI,IAAI,EAAE,cAAc,EAAE,CAAC;gBACzB,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAChF,CAAA;YACH,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/hooks/use-tool-result-recovery.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Recovery for hosts that deliver the `ui/notifications/tool-result`
+ * notification without `structuredContent` (observed on claude.ai and Claude
+ * Desktop, which forward only the model-facing `content` blocks). The
+ * mcp-use bridge then hands the widget an empty props object and the shell
+ * would idle on its loading skeleton forever.
+ *
+ * When the result is ready but the payload is invalid, the hook re-executes
+ * the originating tool once via the host bridge's official `callTool` —
+ * tool-call RESPONSES carry `structuredContent` intact on those hosts — and
+ * exposes the decoded payload. Spec-conforming hosts (e.g. the mcp-use
+ * inspector) deliver a valid payload up front, so the recovery never fires
+ * there.
+ *
+ * Assumes the originating tool is a read-only render pipeline (true for all
+ * toolkit `render-view`/`show_*` tools) — the re-execution must be safe to
+ * repeat.
+ */
+export interface ToolResultRecoveryOptions {
+    /** `!isPending` from `useWidget` — the host reported a finished tool call. */
+    resultReady: boolean;
+    /** The props the host delivered (`useWidget().props`). */
+    props: unknown;
+    /**
+     * Validates a candidate payload. MUST be referentially stable (module-level
+     * function or memoised) — it is an effect dependency.
+     */
+    isValid: (value: unknown) => boolean;
+    /** The tool arguments from `ui/notifications/tool-input` (`useWidget().toolInput`). */
+    toolInput: Record<string, unknown> | null | undefined;
+    /** Raw host context (`useWidget().hostContext`); `toolInfo` names the originating tool. */
+    hostContext: Record<string, unknown> | null | undefined;
+    /** The bridge's `callTool` (`useWidget().callTool`). */
+    callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+}
+export interface ToolResultRecoveryState<T> {
+    /** The recovered payload, `null` until the re-execution resolved (or when it failed). */
+    data: T | null;
+    /** `true` when the single recovery attempt failed — the shell keeps its skeleton, no retry loop. */
+    failed: boolean;
+}
+/**
+ * Resolves the originating tool name from the host context's `toolInfo`.
+ * Reads the SEP-1865 shape first (`toolInfo.tool.name`), then the flattened
+ * variants some hosts send (`toolInfo.name`, `toolInfo.toolName`).
+ */
+export declare function resolveRecoveryToolName(hostContext: unknown): string | undefined;
+/**
+ * Decodes a re-executed tool result and validates it. Exposed for tests;
+ * the hook uses it on the `callTool` response.
+ */
+export declare function decodeRecoveredResult<T>(result: unknown, isValid: (value: unknown) => boolean): T | null;
+export declare function useToolResultRecovery<T>(options: ToolResultRecoveryOptions): ToolResultRecoveryState<T>;
+//# sourceMappingURL=use-tool-result-recovery.d.ts.map

package/dist/hooks/use-tool-result-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tool-result-recovery.d.ts","sourceRoot":"","sources":["../../src/hooks/use-tool-result-recovery.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAA;IACpB,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;IACpC,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;IACrD,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAA;IACvD,wDAAwD;IACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5E;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,yFAAyF;IACzF,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,oGAAoG;IACpG,MAAM,EAAE,OAAO,CAAA;CAChB;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAehF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GACnC,CAAC,GAAG,IAAI,CAQV;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,yBAAyB,GACjC,uBAAuB,CAAC,CAAC,CAAC,CAqD5B"}

package/dist/hooks/use-tool-result-recovery.js

@@ -0,0 +1,93 @@
+import { useEffect, useRef, useState } from "react";
+import { parseToolResult } from "../lib/parse-tool-result.js";
+const IDLE = { data: null, failed: false };
+/**
+ * Resolves the originating tool name from the host context's `toolInfo`.
+ * Reads the SEP-1865 shape first (`toolInfo.tool.name`), then the flattened
+ * variants some hosts send (`toolInfo.name`, `toolInfo.toolName`).
+ */
+export function resolveRecoveryToolName(hostContext) {
+    if (!hostContext || typeof hostContext !== "object")
+        return undefined;
+    const info = hostContext.toolInfo;
+    if (!info || typeof info !== "object")
+        return undefined;
+    const rec = info;
+    const tool = rec.tool;
+    const candidates = [
+        tool && typeof tool === "object" ? tool.name : undefined,
+        rec.name,
+        rec.toolName,
+    ];
+    for (const candidate of candidates) {
+        if (typeof candidate === "string" && candidate.length > 0)
+            return candidate;
+    }
+    return undefined;
+}
+/**
+ * Decodes a re-executed tool result and validates it. Exposed for tests;
+ * the hook uses it on the `callTool` response.
+ */
+export function decodeRecoveredResult(result, isValid) {
+    let decoded;
+    try {
+        decoded = parseToolResult(result);
+    }
+    catch {
+        return null;
+    }
+    return decoded !== null && isValid(decoded) ? decoded : null;
+}
+export function useToolResultRecovery(options) {
+    const { resultReady, props, isValid, toolInput, hostContext, callTool } = options;
+    const [state, setState] = useState(IDLE);
+    // Single-flight: the promise ref survives StrictMode's dev-mode
+    // effect re-run (cleanup + setup on the same instance), so the re-run
+    // re-subscribes to the SAME in-flight call instead of firing a second one.
+    const flightRef = useRef(null);
+    const flightInputRef = useRef(null);
+    const toolName = resolveRecoveryToolName(hostContext);
+    useEffect(() => {
+        // A new tool run (result no longer ready, or fresh tool-input identity)
+        // invalidates any previous recovery attempt and re-arms the single-flight.
+        if (flightRef.current && (!resultReady || flightInputRef.current !== toolInput)) {
+            flightRef.current = null;
+            setState((prev) => (prev.data === null && !prev.failed ? prev : IDLE));
+        }
+        // Never fire on conforming hosts (valid payload) or before the
+        // originating tool is known.
+        if (!resultReady || isValid(props) || toolName === undefined)
+            return;
+        if (!flightRef.current) {
+            flightInputRef.current = toolInput;
+            flightRef.current = (async () => {
+                try {
+                    const result = await callTool(toolName, toolInput ?? {});
+                    const data = decodeRecoveredResult(result, isValid);
+                    if (data !== null)
+                        return { data, failed: false };
+                    console.warn(`[mcp-toolkit] tool-result recovery: re-executing "${toolName}" returned no usable payload`);
+                    return { data: null, failed: true };
+                }
+                catch (err) {
+                    console.warn(`[mcp-toolkit] tool-result recovery for "${toolName}" failed:`, err);
+                    return { data: null, failed: true };
+                }
+            })();
+        }
+        const flight = flightRef.current;
+        let stale = false;
+        void flight.then((outcome) => {
+            // Drop the outcome when this subscription was superseded or the flight
+            // was invalidated by a newer tool run.
+            if (!stale && flightRef.current === flight)
+                setState(outcome);
+        });
+        return () => {
+            stale = true;
+        };
+    }, [resultReady, props, isValid, toolName, toolInput, callTool]);
+    return state;
+}
+//# sourceMappingURL=use-tool-result-recovery.js.map

package/dist/hooks/use-tool-result-recovery.js.map

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

package/dist/hooks/use-view-data.d.ts

@@ -0,0 +1,19 @@
+export interface ViewDataResult<T> {
+    data: T | null;
+    /** True while self-fetching with no data yet — the first paint of a cockpit cell. */
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * The seam that lets one widget component serve both modes without a duplicate UI.
+ *
+ * Standalone (a `*_show_*` widget) the agent's tool result is handed in via
+ * `initialData` (from the view's stepData, e.g. through `adaptDataWidget`) and
+ * returned verbatim. Embedded in a self-fetching cockpit only scope params are
+ * passed, so the component fetches `tool` with `args` under `key` — disabled
+ * unless data is absent AND `ready` (i.e. the required id/key is present).
+ * Sibling widgets sharing `key` dedupe to a single call, so a composed view of
+ * N widgets over one data feed fetches once.
+ */
+export declare function useViewData<T>(initialData: T | null | undefined, key: ReadonlyArray<unknown>, tool: string, args: Record<string, unknown>, ready: boolean): ViewDataResult<T>;
+//# sourceMappingURL=use-view-data.d.ts.map

package/dist/hooks/use-view-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-view-data.d.ts","sourceRoot":"","sources":["../../src/hooks/use-view-data.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,qFAAqF;IACrF,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,WAAW,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EACjC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,EAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,OAAO,GACb,cAAc,CAAC,CAAC,CAAC,CAInB"}

package/dist/hooks/use-view-data.js

@@ -0,0 +1,18 @@
+import { useToolQuery } from "./use-tool-query.js";
+/**
+ * The seam that lets one widget component serve both modes without a duplicate UI.
+ *
+ * Standalone (a `*_show_*` widget) the agent's tool result is handed in via
+ * `initialData` (from the view's stepData, e.g. through `adaptDataWidget`) and
+ * returned verbatim. Embedded in a self-fetching cockpit only scope params are
+ * passed, so the component fetches `tool` with `args` under `key` — disabled
+ * unless data is absent AND `ready` (i.e. the required id/key is present).
+ * Sibling widgets sharing `key` dedupe to a single call, so a composed view of
+ * N widgets over one data feed fetches once.
+ */
+export function useViewData(initialData, key, tool, args, ready) {
+    const query = useToolQuery([...key], tool, args, { enabled: !initialData && ready });
+    const data = initialData ?? query.data ?? null;
+    return { data, loading: !data && ready && !query.isError, error: query.error ?? null };
+}
+//# sourceMappingURL=use-view-data.js.map

package/dist/hooks/use-view-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-view-data.js","sourceRoot":"","sources":["../../src/hooks/use-view-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AASlD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,WAAiC,EACjC,GAA2B,EAC3B,IAAY,EACZ,IAA6B,EAC7B,KAAc;IAEd,MAAM,KAAK,GAAG,YAAY,CAAI,CAAC,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,IAAI,KAAK,EAAE,CAAC,CAAA;IACvF,MAAM,IAAI,GAAG,WAAW,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAA;IAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,CAAA;AACxF,CAAC"}

package/dist/hooks/use-view-tool-query.d.ts

@@ -0,0 +1,18 @@
+import { type UseQueryResult } from "@tanstack/react-query";
+export interface UseViewToolQueryOptions {
+    enabled?: boolean;
+}
+/**
+ * Self-fetch hook for `*_show_*` widget tools — the envelope-unwrapping sibling
+ * of {@link useToolQuery}. A widget tool's text channel carries only a model
+ * summary and its `structuredContent` is the full view envelope, so decoding
+ * with the plain {@link parseToolResult} would hand the widget the whole
+ * envelope; this hook decodes via {@link parseViewToolResult} (single-step →
+ * flat data, multi-step → keyed by step id) instead.
+ *
+ * `args` is appended to the effective query key — same queryKey-vs-args
+ * contract as {@link useToolQuery}, so sibling widgets sharing a query key
+ * collapse to a single deduped tool call.
+ */
+export declare function useViewToolQuery<T = unknown>(queryKey: unknown[], toolName: string, args: object, opts?: UseViewToolQueryOptions): UseQueryResult<T, Error>;
+//# sourceMappingURL=use-view-tool-query.d.ts.map

package/dist/hooks/use-view-tool-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-view-tool-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-view-tool-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAIrE,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,uBAAuB,GAC7B,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAY1B"}

package/dist/hooks/use-view-tool-query.js

@@ -0,0 +1,29 @@
+import { useQuery } from "@tanstack/react-query";
+import { useCallTool } from "../providers/query-provider.js";
+import { parseViewToolResult } from "../lib/parse-tool-result.js";
+/**
+ * Self-fetch hook for `*_show_*` widget tools — the envelope-unwrapping sibling
+ * of {@link useToolQuery}. A widget tool's text channel carries only a model
+ * summary and its `structuredContent` is the full view envelope, so decoding
+ * with the plain {@link parseToolResult} would hand the widget the whole
+ * envelope; this hook decodes via {@link parseViewToolResult} (single-step →
+ * flat data, multi-step → keyed by step id) instead.
+ *
+ * `args` is appended to the effective query key — same queryKey-vs-args
+ * contract as {@link useToolQuery}, so sibling widgets sharing a query key
+ * collapse to a single deduped tool call.
+ */
+export function useViewToolQuery(queryKey, toolName, args, opts) {
+    const callTool = useCallTool();
+    return useQuery({
+        queryKey: [...queryKey, args],
+        queryFn: async () => {
+            if (!callTool)
+                throw new Error("callTool not available");
+            const result = await callTool(toolName, args);
+            return parseViewToolResult(result);
+        },
+        enabled: !!callTool && (opts?.enabled ?? true),
+    });
+}
+//# sourceMappingURL=use-view-tool-query.js.map

package/dist/hooks/use-view-tool-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-view-tool-query.js","sourceRoot":"","sources":["../../src/hooks/use-view-tool-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAuB,MAAM,uBAAuB,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAMjE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAmB,EACnB,QAAgB,EAChB,IAAY,EACZ,IAA8B;IAE9B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAE9B,OAAO,QAAQ,CAAW;QACxB,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,IAAI,CAAC;QAC7B,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;YACxD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YAC7C,OAAO,mBAAmB,CAAI,MAAM,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC;KAC/C,CAAC,CAAA;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent, } from "./primitives/card.js";
+export { Badge, badgeVariants } from "./primitives/badge.js";
+export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption, } from "./primitives/table.js";
+export { Separator } from "./primitives/separator.js";
+export { Skeleton } from "./primitives/skeleton.js";
+export { Tabs, TabsList, TabsTrigger, TabsContent } from "./primitives/tabs.js";
+export { Button, buttonVariants } from "./primitives/button.js";
+export { Input } from "./primitives/input.js";
+export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, } from "./primitives/select.js";
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, } from "./primitives/dialog.js";
+export { Alert, AlertDescription, AlertTitle } from "./primitives/alert.js";
+export { Switch } from "./primitives/switch.js";
+export { ScrollArea, ScrollBar } from "./primitives/scroll-area.js";
+export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, } from "./primitives/sheet.js";
+export { useIsMobile } from "./hooks/use-mobile.js";
+export { useToolQuery, useToolMutation } from "./hooks/use-tool-query.js";
+export type { UseToolQueryOptions } from "./hooks/use-tool-query.js";
+export { useDebouncedValue } from "./hooks/use-debounced-value.js";
+export { TONE_SOFT, TONE_DOT, TONE_TEXT } from "./lib/tone-utils.js";
+export type { ToneVariant } from "./lib/tone-utils.js";
+export { GridLayout, GridItem } from "./components/GridLayout.js";
+export type { GridLayoutProps, GridItemProps } from "./components/GridLayout.js";
+export { KpiGrid } from "./components/KpiGrid.js";
+export type { KpiGridProps, KpiGridHeader, KpiCell } from "./components/KpiGrid.js";
+export { LivePill, CountPill } from "./components/Pills.js";
+export type { LivePillProps, CountPillProps } from "./components/Pills.js";
+export { SectionHeading } from "./components/SectionHeading.js";
+export type { SectionHeadingProps } from "./components/SectionHeading.js";
+export { WidgetHeader } from "./components/WidgetHeader.js";
+export type { WidgetHeaderProps } from "./components/WidgetHeader.js";
+export { GroupCard } from "./components/GroupCard.js";
+export type { GroupCardProps } from "./components/GroupCard.js";
+export { FilterBar } from "./components/FilterBar.js";
+export type { FilterBarProps, FilterChip } from "./components/FilterBar.js";
+export { DrillButton } from "./components/DrillButton.js";
+export type { DrillButtonProps } from "./components/DrillButton.js";
+export { ListFooter } from "./components/ListFooter.js";
+export type { ListFooterProps } from "./components/ListFooter.js";
+export { AppQueryProvider, useCallTool, queryClient } from "./providers/query-provider.js";
+export { createTheme, ThemeProvider, useTheme, themePresets } from "./theme/index.js";
+export type { ThemeTokens, ThemeDefinition, ThemeVars, CreateThemeOptions, ThemeMode, ThemeContextValue, ThemeProviderProps, ThemePresetId, } from "./theme/index.js";
+export { LocaleProvider, useLocale, useTranslate } from "./locale/index.js";
+export type { LocaleContextValue, LocaleProviderProps, BoundTranslate } from "./locale/index.js";
+export { cn } from "./lib/utils.js";
+export { parseToolResult, parseViewToolResult } from "./lib/parse-tool-result.js";
+export type { ParseToolResultOptions } from "./lib/parse-tool-result.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,56 @@
+// shadcn base primitives
+export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent, } from "./primitives/card.js";
+export { Badge, badgeVariants } from "./primitives/badge.js";
+export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption, } from "./primitives/table.js";
+export { Separator } from "./primitives/separator.js";
+export { Skeleton } from "./primitives/skeleton.js";
+export { Tabs, TabsList, TabsTrigger, TabsContent } from "./primitives/tabs.js";
+export { Button, buttonVariants } from "./primitives/button.js";
+export { Input } from "./primitives/input.js";
+export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, } from "./primitives/select.js";
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, } from "./primitives/dialog.js";
+export { Alert, AlertDescription, AlertTitle } from "./primitives/alert.js";
+export { Switch } from "./primitives/switch.js";
+export { ScrollArea, ScrollBar } from "./primitives/scroll-area.js";
+export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, } from "./primitives/sheet.js";
+// Hooks
+// NOTE: the view-tool hooks (`useViewToolQuery`, `useViewData`) are exported
+// from the `./hooks` subpath only — see `packages/ui/src/hooks/index.ts`.
+export { useIsMobile } from "./hooks/use-mobile.js";
+export { useToolQuery, useToolMutation } from "./hooks/use-tool-query.js";
+export { useDebouncedValue } from "./hooks/use-debounced-value.js";
+// Tone token system — the semantic status tones (ToneVariant + TONE_* maps)
+// behind the tone-aware components below. Pure data + class strings.
+export { TONE_SOFT, TONE_DOT, TONE_TEXT } from "./lib/tone-utils.js";
+// Composed components — focused widget building blocks assembled from the
+// primitives. Pure (React + primitives + cn), so they live in the root barrel.
+export { GridLayout, GridItem } from "./components/GridLayout.js";
+export { KpiGrid } from "./components/KpiGrid.js";
+export { LivePill, CountPill } from "./components/Pills.js";
+export { SectionHeading } from "./components/SectionHeading.js";
+export { WidgetHeader } from "./components/WidgetHeader.js";
+export { GroupCard } from "./components/GroupCard.js";
+export { FilterBar } from "./components/FilterBar.js";
+export { DrillButton } from "./components/DrillButton.js";
+export { ListFooter } from "./components/ListFooter.js";
+// Providers
+export { AppQueryProvider, useCallTool, queryClient } from "./providers/query-provider.js";
+// Theming / white-label token system. Browser-safe (React + DOM only, no
+// `mcp-use/react`), so it belongs in this root barrel: a consumer can re-skin
+// the toolkit's primitives from a single switch without pulling in the host
+// runtime. See packages/ui/src/theme/ and docs/guides/white-labeling.md.
+export { createTheme, ThemeProvider, useTheme, themePresets } from "./theme/index.js";
+// i18n / localization. Browser-safe (React only, no `mcp-use/react`), so it
+// belongs in this root barrel: a consumer wraps its widget tree in
+// <LocaleProvider locale=… translator=…> and reads the active locale with
+// useLocale/useTranslate. Pairs with `createTranslator` from
+// `@miragon/mcp-toolkit-core`. See packages/ui/src/locale/.
+export { LocaleProvider, useLocale, useTranslate } from "./locale/index.js";
+// NOTE: MCP App shell (McpAppView, WidgetRenderer) is exported from the
+// `./app` subpath only. Keeping it out of the main barrel prevents consumers
+// that only need primitives (e.g. an admin portal) from pulling `mcp-use/react`
+// and its langchain transitive peer into their Vite bundle.
+// Utils
+export { cn } from "./lib/utils.js";
+export { parseToolResult, parseViewToolResult } from "./lib/parse-tool-result.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EACL,IAAI,EACJ,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,WAAW,GACZ,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EACL,KAAK,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,GACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EACL,MAAM,EACN,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,MAAM,EACN,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,EACL,KAAK,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,uBAAuB,CAAA;AAE9B,QAAQ;AACR,6EAA6E;AAC7E,0EAA0E;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAElE,4EAA4E;AAC5E,qEAAqE;AACrE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpE,0EAA0E;AAC1E,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAGvD,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAE1F,yEAAyE;AACzE,8EAA8E;AAC9E,4EAA4E;AAC5E,yEAAyE;AACzE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAYrF,4EAA4E;AAC5E,mEAAmE;AACnE,0EAA0E;AAC1E,6DAA6D;AAC7D,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAG3E,wEAAwE;AACxE,6EAA6E;AAC7E,gFAAgF;AAChF,4DAA4D;AAE5D,QAAQ;AACR,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA"}

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

@@ -0,0 +1,39 @@
+export interface ParseToolResultOptions {
+    /**
+     * Which channel to read first when both are present.
+     *
+     * - `"structured"` (default): `structuredContent`-first. Since the widget-tool
+     *   "text-channel diet" the text block carries only a short model-facing
+     *   summary, while the data payload lives in `structuredContent` (the view
+     *   builders and `*_data` feeds always set it). The text channel remains a
+     *   fallback for plain results from other servers.
+     * - `"text"`: text-first (the pre-0.4 behaviour) — JSON-decode the first text
+     *   block, then fall back to `structuredContent`. Kept for callers that
+     *   deliberately prefer a tool's human-readable text payload.
+     */
+    prefer?: "structured" | "text";
+}
+/**
+ * Decodes an MCP tool result down to its data payload.
+ *
+ * Default (`prefer: "structured"`): `isError` → throw 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.
+ *
+ * This is **structured-first** — a deliberate, observable change from the
+ * pre-0.4 text-first parsing: tools that return BOTH a text summary and
+ * `structuredContent` now yield the structured payload, not the summary
+ * string. `useToolQuery`/`useToolMutation` and the MCP App shell all decode
+ * through this one parser so the convention is uniform.
+ */
+export declare function parseToolResult<T = unknown>(result: unknown, opts?: ParseToolResultOptions): T;
+/**
+ * Decodes a `*_show_*` widget-tool result down to the widget's flat data
+ * payload. `buildSingleWidgetView`/`buildComposedView` wrap the data in the
+ * `McpAppView` envelope (`context.stepData[<id>].data`); this unwraps it:
+ * single-step views yield the step's data directly, multi-step composed views
+ * yield an object keyed by step id. Non-envelope results (e.g. `*_data`
+ * feeds) pass through {@link parseToolResult} unchanged.
+ */
+export declare function parseViewToolResult<T = unknown>(result: unknown): T;
+//# sourceMappingURL=parse-tool-result.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,66 @@
+/**
+ * Decodes an MCP tool result down to its data payload.
+ *
+ * Default (`prefer: "structured"`): `isError` → throw 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.
+ *
+ * This is **structured-first** — a deliberate, observable change from the
+ * pre-0.4 text-first parsing: tools that return BOTH a text summary and
+ * `structuredContent` now yield the structured payload, not the summary
+ * string. `useToolQuery`/`useToolMutation` and the MCP App shell all decode
+ * through this one parser so the convention is uniform.
+ */
+export function parseToolResult(result, opts) {
+    const r = result;
+    if (r?.isError)
+        throw new Error(r.content?.[0]?.text ?? "Tool call failed");
+    const fromStructured = () => r?.structuredContent != null ? r.structuredContent : undefined;
+    const fromText = () => {
+        const text = r?.content?.[0]?.text;
+        if (text == null)
+            return undefined;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    };
+    if (opts?.prefer === "text") {
+        const text = fromText();
+        if (text !== undefined)
+            return text;
+        const structured = fromStructured();
+        if (structured !== undefined)
+            return structured;
+        return r;
+    }
+    const structured = fromStructured();
+    if (structured !== undefined)
+        return structured;
+    const text = fromText();
+    if (text !== undefined)
+        return text;
+    return r;
+}
+/**
+ * Decodes a `*_show_*` widget-tool result down to the widget's flat data
+ * payload. `buildSingleWidgetView`/`buildComposedView` wrap the data in the
+ * `McpAppView` envelope (`context.stepData[<id>].data`); this unwraps it:
+ * single-step views yield the step's data directly, multi-step composed views
+ * yield an object keyed by step id. Non-envelope results (e.g. `*_data`
+ * feeds) pass through {@link parseToolResult} unchanged.
+ */
+export function parseViewToolResult(result) {
+    const parsed = parseToolResult(result);
+    const ctx = parsed?.context;
+    const stepIds = ctx?.stepIds;
+    if (ctx?.stepData && Array.isArray(stepIds) && stepIds.length > 0) {
+        if (stepIds.length === 1)
+            return ctx.stepData[stepIds[0] ?? ""]?.data;
+        return Object.fromEntries(stepIds.map((id) => [id, ctx.stepData[id]?.data]));
+    }
+    return parsed;
+}
+//# sourceMappingURL=parse-tool-result.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,18 @@
+/**
+ * Single source of truth for the semantic "tones" used across the tone-aware
+ * components (`Pills`, `KpiGrid`, `WidgetHeader`, …).
+ *
+ * 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.
+ */
+export type ToneVariant = "neutral" | "info" | "success" | "warning" | "danger";
+/** Tinted background + readable foreground — badges, icon tiles, pills. */
+export declare const TONE_SOFT: Record<ToneVariant, string>;
+/** Solid dot color — status dots next to a label. */
+export declare const TONE_DOT: Record<ToneVariant, string>;
+/** Foreground-only color — metric values, inline emphasis. */
+export declare const TONE_TEXT: Record<ToneVariant, string>;
+//# sourceMappingURL=tone-utils.d.ts.map

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

@@ -0,0 +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"}