@miragon/mcp-toolkit-ui 2.6.0 → 2.8.0

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

@@ -1,19 +1,67 @@
+import { type UseToolQueryOptions } from "../lib/tool-query.js";
 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;
+    /**
+     * Fetch `tool` again now: the retry of an error state
+     * (`<ErrorState onRetry={refetch} … />`) or a manual refresh — a new read
+     * even while a failed fetch still waits on its retry backoff. In `"static"`
+     * mode host-pushed data, when present, stays what `data` returns.
+     */
+    refetch: () => void;
+    /** Failed attempts of the current fetch (0 once it succeeds). */
+    failureCount: number;
+    /**
+     * The current fetch's last failed attempt — set from the first failure on,
+     * while the query still retries (`error` waits for the last retry).
+     */
+    failureReason: Error | null;
+    /** A fetch is in flight (the first one or a refetch). */
+    isFetching: boolean;
+    /**
+     * `data` is a placeholder (`placeholderData`, e.g. `keepPreviousData`):
+     * the previous args' answer while the current args' fetch runs or failed.
+     */
+    isPlaceholderData: boolean;
 }
+/**
+ * How {@link useViewData} treats host-pushed `initialData`.
+ *
+ * - `"static"` (default): returned verbatim; the feed query stays off while
+ *   it is present.
+ * - `"seed"`: it becomes the feed query's cached answer, and the query stays
+ *   live (once `ready`): an invalidation after a write, a `refetch` or a
+ *   retry re-reads the feed. A fresh seed is not refetched on mount (it is
+ *   younger than `staleTime`); a payload delivered anew (content not seeded
+ *   for the key before) replaces the cached answer, while a re-rendered or
+ *   remounted old one never rolls a refetched answer back.
+ */
+export type ViewDataMode = "static" | "seed";
+/**
+ * Options of {@link useViewData}: TanStack's query options for the feed
+ * (`retry`, `retryDelay`, `staleTime`, `placeholderData` /
+ * `keepPreviousData`, `enabled` as an extra gate next to `ready`, …),
+ * plus how host data seeds it.
+ */
+export type UseViewDataOptions<T> = Omit<UseToolQueryOptions<T>, "initialData" | "select"> & {
+    initialDataMode?: ViewDataMode;
+};
 /**
  * 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.
+ * `initialData` (from the view's stepData, e.g. through `adaptDataWidget`).
+ * Embedded in a self-fetching cockpit only scope params are passed, so the
+ * component fetches `tool` with `args` under `key`, gated on `ready` (i.e.
+ * the required id/key is present). Sibling widgets sharing `key` and `args`
+ * dedupe to a single call, so a composed view of N widgets over one data
+ * feed fetches once.
+ *
+ * By default host data is returned verbatim and switches the query off;
+ * `initialDataMode: "seed"` keeps the query live over it instead (see
+ * {@link ViewDataMode}). `options` passes TanStack's query options through.
  */
-export declare function useViewData<T>(initialData: T | null | undefined, key: ReadonlyArray<unknown>, tool: string, args: Record<string, unknown>, ready: boolean): ViewDataResult<T>;
+export declare function useViewData<T>(initialData: T | null | undefined, key: ReadonlyArray<unknown>, tool: string, args: Record<string, unknown>, ready: boolean, options?: UseViewDataOptions<T>): ViewDataResult<T>;
 //# sourceMappingURL=use-view-data.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"use-view-data.d.ts","sourceRoot":"","sources":["../../src/hooks/use-view-data.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG9E,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;IACnB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,aAAa,EAAE,KAAK,GAAG,IAAI,CAAA;IAC3B,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC,GAAG;IAC3F,eAAe,CAAC,EAAE,YAAY,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;;;GAcG;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,EACd,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,cAAc,CAAC,CAAC,CAAC,CA0BnB"}

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

@@ -1,18 +1,88 @@
-import { useToolQuery } from "./use-tool-query.js";
+import { useCallback, useState } from "react";
+import { hashKey, useQueryClient } from "@tanstack/react-query";
+import { seedToolQuery } from "../lib/tool-query.js";
+import { useToolQuery, useToolQueryKey } 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.
+ * `initialData` (from the view's stepData, e.g. through `adaptDataWidget`).
+ * Embedded in a self-fetching cockpit only scope params are passed, so the
+ * component fetches `tool` with `args` under `key`, gated on `ready` (i.e.
+ * the required id/key is present). Sibling widgets sharing `key` and `args`
+ * dedupe to a single call, so a composed view of N widgets over one data
+ * feed fetches once.
+ *
+ * By default host data is returned verbatim and switches the query off;
+ * `initialDataMode: "seed"` keeps the query live over it instead (see
+ * {@link ViewDataMode}). `options` passes TanStack's query options through.
+ */
+export function useViewData(initialData, key, tool, args, ready, options) {
+    const { initialDataMode = "static", enabled, ...queryOptions } = options ?? {};
+    const seeding = initialDataMode === "seed";
+    const cacheKey = useStableKey(useToolQueryKey(key, tool, args));
+    useSeed(seeding ? initialData : null, cacheKey, queryOptions.initialDataUpdatedAt);
+    const active = ready && enabled !== false;
+    const fetches = active && (seeding || !initialData);
+    const query = useToolQuery([...key], tool, args, {
+        ...queryOptions,
+        enabled: typeof enabled === "function" ? (q) => fetches && enabled(q) : fetches,
+    });
+    const data = seeding ? (query.data ?? initialData) : (initialData ?? query.data);
+    const refetch = useFreshRefetch(cacheKey, query.refetch);
+    return {
+        data: data ?? null,
+        // The query's own verdict: a function `enabled` that returns false idles
+        // like `enabled: false`, never an endless skeleton.
+        loading: !data && query.isEnabled && !query.isError,
+        error: query.error,
+        refetch,
+        failureCount: query.failureCount,
+        failureReason: query.failureReason,
+        isFetching: query.isFetching,
+        isPlaceholderData: query.isPlaceholderData,
+    };
+}
+/** `key`, kept by content: callers build `key`/`args` anew every render. */
+function useStableKey(key) {
+    const id = hashKey(key);
+    const [stable, setStable] = useState({ id, key });
+    if (stable.id !== id)
+        setStable({ id, key });
+    return stable.id === id ? stable.key : key;
+}
+/**
+ * `"seed"` mode: write the host's payload into the feed's cache entry in the
+ * render phase, before the query's observer reads the cache — what TanStack's
+ * own `initialData` does (see {@link seedToolQuery} for when it wins over a
+ * cached answer). The last processed seed skips the content check while the
+ * same object comes in render after render.
+ */
+function useSeed(seed, cacheKey, updatedAt) {
+    const client = useQueryClient();
+    const keyId = hashKey(cacheKey);
+    const [seen, setSeen] = useState(null);
+    if (seed == null || (seen?.seed === seed && seen.keyId === keyId))
+        return;
+    const at = typeof updatedAt === "function" ? updatedAt() : updatedAt;
+    const written = seedToolQuery(client, cacheKey, seed, at);
+    // Only a real change re-renders: an equal new object per render must not loop.
+    if (written || seen?.keyId !== keyId)
+        setSeen({ seed, keyId });
+}
+/**
+ * A refetch that reads anew at once. TanStack restarts an in-flight fetch only
+ * over data (`cancelRefetch`); a key without data joins the running retry
+ * chain and waits out its backoff. So cancel that chain first, then read.
  */
-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 };
+function useFreshRefetch(cacheKey, refetchQuery) {
+    const client = useQueryClient();
+    return useCallback(() => {
+        if (client.getQueryData(cacheKey) !== undefined) {
+            void refetchQuery();
+            return;
+        }
+        void client.cancelQueries({ queryKey: cacheKey, exact: true }).then(() => refetchQuery());
+    }, [client, cacheKey, refetchQuery]);
 }
 //# sourceMappingURL=use-view-data.js.map

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

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

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

@@ -1,7 +1,11 @@
 import { type UseQueryResult } from "@tanstack/react-query";
-export interface UseViewToolQueryOptions {
-    enabled?: boolean;
-}
+import { type UseToolQueryOptions } from "../lib/tool-query.js";
+/**
+ * Options of {@link useViewToolQuery}: TanStack's query options, passed
+ * through like `useToolQuery`'s (`enabled`, `retry`, `staleTime`,
+ * `placeholderData`, `initialData`, …).
+ */
+export type UseViewToolQueryOptions<T = unknown> = UseToolQueryOptions<T>;
 /**
  * Self-fetch hook for `*_show_*` widget tools — the envelope-unwrapping sibling
  * of {@link useToolQuery}. A widget tool's text channel carries only a model
@@ -10,9 +14,10 @@ export interface UseViewToolQueryOptions {
  * 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.
+ * Same key and options contract as {@link useToolQuery}: the effective key is
+ * `[...queryKey, args]` (`[...queryKey, toolName, args]` under an
+ * `AppQueryProvider` with `toolNameInQueryKey`), so sibling widgets sharing a
+ * query key and args collapse to a single deduped tool call.
  */
-export declare function useViewToolQuery<T = unknown>(queryKey: unknown[], toolName: string, args: object, opts?: UseViewToolQueryOptions): UseQueryResult<T, Error>;
+export declare function useViewToolQuery<T = unknown>(queryKey: readonly unknown[], toolName: string, args: object, opts?: UseViewToolQueryOptions<T>): UseQueryResult<T, Error>;
 //# sourceMappingURL=use-view-tool-query.d.ts.map

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

@@ -1 +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"}
+{"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;AAGrE,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAGjF;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,GAAG,OAAO,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAA;AAEzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAY1B"}

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

@@ -1,6 +1,8 @@
 import { useQuery } from "@tanstack/react-query";
-import { useCallTool } from "../providers/query-provider.js";
+import { useCallTool, useToolNameInQueryKey } from "../providers/query-provider.js";
 import { parseViewToolResult } from "../lib/parse-tool-result.js";
+import { toolQueryOptions } from "../lib/tool-query.js";
+import { useRefetchOnTransport, useToolKeyGuard } from "./use-tool-query.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
@@ -9,21 +11,20 @@ import { parseViewToolResult } from "../lib/parse-tool-result.js";
  * 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.
+ * Same key and options contract as {@link useToolQuery}: the effective key is
+ * `[...queryKey, args]` (`[...queryKey, toolName, args]` under an
+ * `AppQueryProvider` with `toolNameInQueryKey`), so sibling widgets sharing a
+ * query key and args 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),
-    });
+    const toolNameInKey = useToolNameInQueryKey();
+    useToolKeyGuard(queryKey, toolName, args);
+    const query = useQuery(toolQueryOptions(queryKey, toolName, args, callTool, opts, {
+        decode: parseViewToolResult,
+        toolNameInKey,
+    }));
+    useRefetchOnTransport(callTool, query);
+    return query;
 }
 //# sourceMappingURL=use-view-tool-query.js.map

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

@@ -1 +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"}
+{"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,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAA4B,MAAM,sBAAsB,CAAA;AACjF,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAS5E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA4B,EAC5B,QAAgB,EAChB,IAAY,EACZ,IAAiC;IAEjC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,aAAa,GAAG,qBAAqB,EAAE,CAAA;IAC7C,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,QAAQ,CACpB,gBAAgB,CAAI,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5D,MAAM,EAAE,mBAAmB;QAC3B,aAAa;KACd,CAAC,CACH,CAAA;IACD,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IACtC,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -13,21 +13,27 @@ 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 { useToolQuery, useToolQueryKey, useToolMutation } from "./hooks/use-tool-query.js";
+export type { UseToolQueryOptions, UseToolMutationOptions } from "./hooks/use-tool-query.js";
+export { toolQueryKey, shouldRetryToolCall } from "./lib/tool-query.js";
+export { ToolResultError, isToolError } from "./lib/parse-tool-result.js";
+export { keepPreviousData } from "@tanstack/react-query";
 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 { TONE_VARIANTS, TONE_ALIASES, resolveTone, isToneVariant, TONE_SOFT, TONE_TINT, TONE_DOT, TONE_INK, TONE_TEXT, TONE_BORDER, TONE_ICON, } from "./lib/tone-utils.js";
+export type { ToneVariant, ToneAlias, ToneName } from "./lib/tone-utils.js";
+export { TYPE_SCALE, TYPE_STEPS, TYPE_FLOOR_PX, MICRO_LABEL } from "./lib/typography.js";
+export type { TypeStep } from "./lib/typography.js";
+export { FOCUS_RING, FOCUS_RING_INSET } from "./lib/focus-ring.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 { KpiGrid, KpiGridSkeleton } from "./components/KpiGrid.js";
+export type { KpiGridProps, KpiGridHeader, KpiCell, KpiGridSkeletonProps, } from "./components/KpiGrid.js";
+export { LivePill, CountPill, StatusBadge } from "./components/Pills.js";
+export type { LivePillProps, CountPillProps, StatusBadgeProps, StatusBadgeText, } 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 type { WidgetHeaderProps, WidgetHeadingLevel } from "./components/WidgetHeader.js";
 export { GroupCard } from "./components/GroupCard.js";
 export type { GroupCardProps } from "./components/GroupCard.js";
 export { FilterBar } from "./components/FilterBar.js";
@@ -36,11 +42,19 @@ 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 { PagedListFooter } from "./components/PagedListFooter.js";
+export type { PagedListFooterProps, PagedListState } from "./components/PagedListFooter.js";
+export { ToastProvider, useToast } from "./components/Toast.js";
+export type { ToastApi, ToastOptions, ToastTone } from "./components/Toast.js";
+export { EmptyState } from "./components/EmptyState.js";
+export type { EmptyStateProps, StateHeadingLevel } from "./components/EmptyState.js";
+export { ErrorState } from "./components/ErrorState.js";
+export type { ErrorStateProps, ErrorStateTone } from "./components/ErrorState.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 { createTheme, resolveThemeVars, ROLE_TOKENS, ThemeProvider, useTheme, usePortalContainer, themePresets, CD_TOKENS, CD_TOKENS_VERSION, fontFaces, GEIST_FONT_FILES, adoptHostFontVariables, HOST_FONT_VARIABLES, } from "./theme/index.js";
+export type { ThemeTokens, ThemeDefinition, ThemeVars, CreateThemeOptions, ThemeMode, ThemeContextValue, ThemeProviderProps, ThemePresetId, CdTokenName, FontFacesOptions, InlineStyleTarget, } from "./theme/index.js";
+export { LocaleProvider, useLocale, useTranslate, useToolkitMessages, TOOLKIT_MESSAGES, formatCount, resolveToolkitMessages, } from "./locale/index.js";
+export type { LocaleContextValue, LocaleProviderProps, BoundTranslate, BuilderMessages, CommonMessages, FilterBarMessages, ListFooterMessages, PropsSheetMessages, RendererMessages, ToolkitLocale, ToolkitMessages, ToolkitMessagesOverride, ViewMessages, } 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";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -17,35 +17,57 @@ export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHe
 // 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 { useToolQuery, useToolQueryKey, useToolMutation } from "./hooks/use-tool-query.js";
+// The query layer's contract: the effective cache key, the opt-in retry
+// policy (no retry of a tool's own isError answer), and TanStack's
+// keepPreviousData for `placeholderData`, so a consumer needs no direct
+// @tanstack/react-query import for the common options.
+export { toolQueryKey, shouldRetryToolCall } from "./lib/tool-query.js";
+export { ToolResultError, isToolError } from "./lib/parse-tool-result.js";
+export { keepPreviousData } from "@tanstack/react-query";
 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";
+// behind the tone-aware components below. Pure data + class strings. ONE
+// vocabulary (TONE_VARIANTS; retired names map through resolveTone). Three
+// roles per tone: colour (TONE_DOT/TONE_BORDER/TONE_ICON), tint (TONE_SOFT,
+// foreground text on it; TONE_TINT alone), text on a plain surface (TONE_INK,
+// the -ink role; TONE_TEXT is its deprecated name).
+export { TONE_VARIANTS, TONE_ALIASES, resolveTone, isToneVariant, TONE_SOFT, TONE_TINT, TONE_DOT, TONE_INK, TONE_TEXT, TONE_BORDER, TONE_ICON, } from "./lib/tone-utils.js";
+// The type scale (CI §4): text-title/section/body/dense/small utilities, 13 px floor.
+export { TYPE_SCALE, TYPE_STEPS, TYPE_FLOOR_PX, MICRO_LABEL } from "./lib/typography.js";
+// The kit's opaque focus ring as class strings, for custom controls.
+export { FOCUS_RING, FOCUS_RING_INSET } from "./lib/focus-ring.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 { KpiGrid, KpiGridSkeleton } from "./components/KpiGrid.js";
+export { LivePill, CountPill, StatusBadge } 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";
+export { PagedListFooter } from "./components/PagedListFooter.js";
+// Feedback and states — one pattern each for toasts, empty and error states.
+export { ToastProvider, useToast } from "./components/Toast.js";
+export { EmptyState } from "./components/EmptyState.js";
+export { ErrorState } from "./components/ErrorState.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";
+// The defaults are the Miragon theme (theme.css over the vendored --cd-*
+// corporate-design tokens); a brand overrides the ROLE_TOKENS only.
+export { createTheme, resolveThemeVars, ROLE_TOKENS, ThemeProvider, useTheme, usePortalContainer, themePresets, CD_TOKENS, CD_TOKENS_VERSION, fontFaces, GEIST_FONT_FILES, adoptHostFontVariables, HOST_FONT_VARIABLES, } 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";
+export { LocaleProvider, useLocale, useTranslate, useToolkitMessages, TOOLKIT_MESSAGES, formatCount, resolveToolkitMessages, } 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`

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-return.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Focus return for the kit's dialogs and sheets (CI §12: focus goes back to
+ * where it came from).
+ *
+ * A Radix dialog returns the focus only to its `Trigger`. The kit's overlays
+ * mostly open from React state, without one (the builder's Save, Discard and
+ * Catalogue, a cell's props sheet), and Radix then cancels its focus scope's
+ * own restore and focuses nothing: closing them by keyboard left the focus on
+ * the document body. `DialogContent` and `SheetContent` therefore note the
+ * element that has the focus as they open and hand the focus back to it when
+ * they close and the focus went with them, while that element is still in the
+ * document. A consumer's own `onCloseAutoFocus` that calls `preventDefault()`
+ * keeps full control.
+ */
+/** The part of an element the hand-back needs (structural, so it tests without a DOM). */
+export interface FocusReturnTarget {
+    readonly isConnected: boolean;
+    focus: () => void;
+}
+/** The part of Radix's auto-focus events the hand-back reads. */
+export interface AutoFocusEventLike {
+    readonly defaultPrevented: boolean;
+    preventDefault: () => void;
+}
+/** One overlay's hand-back, from {@link createFocusReturn}. */
+export interface FocusReturn {
+    /**
+     * Notes the element that has the focus as the overlay opens. The document
+     * body is no target: a pointer that opened it without focusing anything
+     * (Safari does not focus a clicked button) leaves Radix's default in place.
+     */
+    capture: (active: FocusReturnTarget | null, body: unknown) => void;
+    /**
+     * Hands the focus back to the noted element when the overlay closes and the
+     * focus went with it (`focusLost`: it sits on the body). It leaves the focus
+     * where it is when a handler before it prevented that, when the focus
+     * already sits elsewhere (a click outside a non-modal overlay, a hand-off
+     * that moved it) or when the element left the document (an Apply or
+     * Discard that unmounted the builder). Forgets the element either way.
+     */
+    restore: (event: AutoFocusEventLike, focusLost: boolean) => void;
+}
+/** A {@link FocusReturn} with nothing noted yet. */
+export declare function createFocusReturn(): FocusReturn;
+/**
+ * The `onOpenAutoFocus` / `onCloseAutoFocus` pair of a Radix dialog content
+ * with the focus hand-back of {@link createFocusReturn} composed in: it notes
+ * the opener BEFORE the consumer's open handler runs (that one may move the
+ * focus) and hands it back AFTER the consumer's close handler (whose
+ * `preventDefault()` keeps it out). Radix fires the open event only when the
+ * focus is outside the content as it mounts, so an element inside it must not
+ * take the focus itself (`autoFocus`): Radix focuses the first one anyway.
+ */
+export declare function useFocusReturn<E extends AutoFocusEventLike>(handlers: {
+    onOpenAutoFocus?: (event: E) => void;
+    onCloseAutoFocus?: (event: E) => void;
+}): {
+    onOpenAutoFocus: (event: E) => void;
+    onCloseAutoFocus: (event: E) => void;
+};
+//# sourceMappingURL=focus-return.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focus-return.d.ts","sourceRoot":"","sources":["../../src/lib/focus-return.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,0FAA0F;AAC1F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;IAClC,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B;AAED,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAClE;;;;;;;OAOG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CACjE;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,IAAI,WAAW,CAc/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,kBAAkB,EAAE,QAAQ,EAAE;IACrE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;IACpC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;CACtC,GAAG;IAAE,eAAe,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;CAAE,CAahF"}

package/dist/lib/focus-return.js

@@ -0,0 +1,46 @@
+import { useState } from "react";
+/** A {@link FocusReturn} with nothing noted yet. */
+export function createFocusReturn() {
+    let opener = null;
+    return {
+        capture: (active, body) => {
+            opener = active === body ? null : active;
+        },
+        restore: (event, focusLost) => {
+            const target = opener;
+            opener = null;
+            if (event.defaultPrevented || !focusLost || target === null || !target.isConnected)
+                return;
+            event.preventDefault();
+            target.focus();
+        },
+    };
+}
+/**
+ * The `onOpenAutoFocus` / `onCloseAutoFocus` pair of a Radix dialog content
+ * with the focus hand-back of {@link createFocusReturn} composed in: it notes
+ * the opener BEFORE the consumer's open handler runs (that one may move the
+ * focus) and hands it back AFTER the consumer's close handler (whose
+ * `preventDefault()` keeps it out). Radix fires the open event only when the
+ * focus is outside the content as it mounts, so an element inside it must not
+ * take the focus itself (`autoFocus`): Radix focuses the first one anyway.
+ */
+export function useFocusReturn(handlers) {
+    const [focusReturn] = useState(createFocusReturn);
+    return {
+        onOpenAutoFocus: (event) => {
+            focusReturn.capture(activeElementOf(document), document.body);
+            handlers.onOpenAutoFocus?.(event);
+        },
+        onCloseAutoFocus: (event) => {
+            handlers.onCloseAutoFocus?.(event);
+            const active = document.activeElement;
+            focusReturn.restore(event, active === null || active === document.body);
+        },
+    };
+}
+function activeElementOf(doc) {
+    const active = doc.activeElement;
+    return active && "focus" in active ? active : null;
+}
+//# sourceMappingURL=focus-return.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focus-return.js","sourceRoot":"","sources":["../../src/lib/focus-return.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAgDhC,oDAAoD;AACpD,MAAM,UAAU,iBAAiB;IAC/B,IAAI,MAAM,GAA6B,IAAI,CAAA;IAC3C,OAAO;QACL,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YACxB,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;QAC1C,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,MAAM,CAAA;YACrB,MAAM,GAAG,IAAI,CAAA;YACb,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;gBAAE,OAAM;YAC1F,KAAK,CAAC,cAAc,EAAE,CAAA;YACtB,MAAM,CAAC,KAAK,EAAE,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAA+B,QAG5D;IACC,MAAM,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IACjD,OAAO;QACL,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;YACzB,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC7D,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,CAAA;QACnC,CAAC;QACD,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAA;YAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAA;YACrC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAA;QACzE,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,GAAa;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAA;IAChC,OAAO,MAAM,IAAI,OAAO,IAAI,MAAM,CAAC,CAAC,CAAE,MAAsB,CAAC,CAAC,CAAC,IAAI,CAAA;AACrE,CAAC"}

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"}