@miragon/mcp-toolkit-ui 2.7.0 → 2.8.0

package/dist/providers/query-provider.d.ts

@@ -2,10 +2,41 @@ import { type ReactNode } from "react";
 import { QueryClient } from "@tanstack/react-query";
 type CallToolFn = (name: string, args: object) => Promise<unknown>;
 declare const queryClient: QueryClient;
-export declare function AppQueryProvider({ children, callTool, }: {
+/**
+ * The query client and tool transport of the toolkit's data hooks.
+ *
+ * `callTool` is how `useToolQuery` & co. reach the server; without it they
+ * fall back to the nearest `HostBridgeProvider`'s bridge (toolkit#176 N25).
+ * `client` replaces the shared module-level client, e.g. one per mount;
+ * omitted, a nested provider keeps its parent's client (as `McpAppView`'s
+ * own provider does), and the outermost one shares the toolkit's client
+ * (`queryClient`). `toolNameInQueryKey` puts the tool name into the hooks'
+ * cache keys (`[...queryKey, toolName, args]`, see `toolQueryKey`), so two
+ * tools never share an entry; omitted, a nested provider keeps its parent's
+ * setting, and the outermost one uses the 2.x key `[...queryKey, args]`. The
+ * next major makes the tool name the default.
+ */
+export declare function AppQueryProvider({ children, callTool, client, toolNameInQueryKey, }: {
     children: ReactNode;
     callTool?: CallToolFn;
+    client?: QueryClient;
+    toolNameInQueryKey?: boolean;
 }): import("react").JSX.Element;
+/**
+ * The client an `AppQueryProvider` without `client` uses at this point: the
+ * nearest `AppQueryProvider`'s, else the toolkit's shared `queryClient`. A
+ * plain TanStack `QueryClientProvider` does not count.
+ */
+export declare function useAppQueryClient(): QueryClient;
+/**
+ * Whether the nearest `AppQueryProvider` puts the tool name into the data
+ * hooks' cache keys (`toolNameInQueryKey`); `false` outside one.
+ */
+export declare function useToolNameInQueryKey(): boolean;
+/**
+ * The tool transport of the data hooks: `AppQueryProvider`'s `callTool`,
+ * else the nearest `HostBridgeProvider`'s `callTool`, else `undefined`.
+ */
 export declare function useCallTool(): CallToolFn | undefined;
 export { queryClient };
 //# sourceMappingURL=query-provider.d.ts.map

package/dist/providers/query-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-provider.d.ts","sourceRoot":"","sources":["../../src/providers/query-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACjE,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAA;AAKxE,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAIlE,QAAA,MAAM,WAAW,aAOf,CAAA;AAEF,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAA;IACnB,QAAQ,CAAC,EAAE,UAAU,CAAA;CACtB,+BAMA;AAED,wBAAgB,WAAW,IAAI,UAAU,GAAG,SAAS,CAEpD;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"query-provider.d.ts","sourceRoot":"","sources":["../../src/providers/query-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAA;AAMxE,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAOlE,QAAA,MAAM,WAAW,aAOf,CAAA;AAKF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,kBAAkB,GACnB,EAAE;IACD,QAAQ,EAAE,SAAS,CAAA;IACnB,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,+BAeA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,UAAU,GAAG,SAAS,CAQpD;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/providers/query-provider.js

@@ -1,7 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext } from "react";
+import { createContext, useContext, useMemo } from "react";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { useHostBridgeOrNull } from "../app/host-bridge.js";
 const CallToolContext = createContext(undefined);
+/** Whether the data hooks put the tool name into their cache keys (`toolQueryKey`). */
+const ToolNameInQueryKeyContext = createContext(false);
 const queryClient = new QueryClient({
     defaultOptions: {
         queries: {
@@ -10,11 +13,57 @@ const queryClient = new QueryClient({
         },
     },
 });
-export function AppQueryProvider({ children, callTool, }) {
-    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(CallToolContext.Provider, { value: callTool, children: children }) }));
+/** The client of the nearest `AppQueryProvider`, which a nested one without `client` keeps. */
+const AppQueryClientContext = createContext(queryClient);
+/**
+ * The query client and tool transport of the toolkit's data hooks.
+ *
+ * `callTool` is how `useToolQuery` & co. reach the server; without it they
+ * fall back to the nearest `HostBridgeProvider`'s bridge (toolkit#176 N25).
+ * `client` replaces the shared module-level client, e.g. one per mount;
+ * omitted, a nested provider keeps its parent's client (as `McpAppView`'s
+ * own provider does), and the outermost one shares the toolkit's client
+ * (`queryClient`). `toolNameInQueryKey` puts the tool name into the hooks'
+ * cache keys (`[...queryKey, toolName, args]`, see `toolQueryKey`), so two
+ * tools never share an entry; omitted, a nested provider keeps its parent's
+ * setting, and the outermost one uses the 2.x key `[...queryKey, args]`. The
+ * next major makes the tool name the default.
+ */
+export function AppQueryProvider({ children, callTool, client, toolNameInQueryKey, }) {
+    const inheritedClient = useAppQueryClient();
+    const inherited = useContext(ToolNameInQueryKeyContext);
+    const effective = client ?? inheritedClient;
+    return (_jsx(AppQueryClientContext.Provider, { value: effective, children: _jsx(QueryClientProvider, { client: effective, children: _jsx(CallToolContext.Provider, { value: callTool, children: _jsx(ToolNameInQueryKeyContext.Provider, { value: toolNameInQueryKey ?? inherited, children: children }) }) }) }));
 }
+/**
+ * The client an `AppQueryProvider` without `client` uses at this point: the
+ * nearest `AppQueryProvider`'s, else the toolkit's shared `queryClient`. A
+ * plain TanStack `QueryClientProvider` does not count.
+ */
+export function useAppQueryClient() {
+    return useContext(AppQueryClientContext);
+}
+/**
+ * Whether the nearest `AppQueryProvider` puts the tool name into the data
+ * hooks' cache keys (`toolNameInQueryKey`); `false` outside one.
+ */
+export function useToolNameInQueryKey() {
+    return useContext(ToolNameInQueryKeyContext);
+}
+/**
+ * The tool transport of the data hooks: `AppQueryProvider`'s `callTool`,
+ * else the nearest `HostBridgeProvider`'s `callTool`, else `undefined`.
+ */
 export function useCallTool() {
-    return useContext(CallToolContext);
+    const explicit = useContext(CallToolContext);
+    const bridge = useHostBridgeOrNull();
+    return useMemo(() => {
+        if (explicit)
+            return explicit;
+        if (!bridge)
+            return undefined;
+        return (name, args) => bridge.callTool(name, args);
+    }, [explicit, bridge]);
 }
 export { queryClient };
 //# sourceMappingURL=query-provider.js.map

package/dist/providers/query-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-provider.js","sourceRoot":"","sources":["../../src/providers/query-provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAOxE,MAAM,eAAe,GAAG,aAAa,CAAyB,SAAS,CAAC,CAAA;AAExE,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;IAClC,cAAc,EAAE;QACd,OAAO,EAAE;YACP,SAAS,EAAE,MAAM;YACjB,oBAAoB,EAAE,KAAK;SAC5B;KACF;CACF,CAAC,CAAA;AAEF,MAAM,UAAU,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAQ,GAIT;IACC,OAAO,CACL,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAAG,QAAQ,GAA4B,GAC5D,CACvB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,eAAe,CAAC,CAAA;AACpC,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"query-provider.js","sourceRoot":"","sources":["../../src/providers/query-provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAO3D,MAAM,eAAe,GAAG,aAAa,CAAyB,SAAS,CAAC,CAAA;AAExE,uFAAuF;AACvF,MAAM,yBAAyB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;AAEtD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;IAClC,cAAc,EAAE;QACd,OAAO,EAAE;YACP,SAAS,EAAE,MAAM;YACjB,oBAAoB,EAAE,KAAK;SAC5B;KACF;CACF,CAAC,CAAA;AAEF,+FAA+F;AAC/F,MAAM,qBAAqB,GAAG,aAAa,CAAc,WAAW,CAAC,CAAA;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,kBAAkB,GAMnB;IACC,MAAM,eAAe,GAAG,iBAAiB,EAAE,CAAA;IAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAA;IACvD,MAAM,SAAS,GAAG,MAAM,IAAI,eAAe,CAAA;IAC3C,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,SAAS,YAC9C,KAAC,mBAAmB,IAAC,MAAM,EAAE,SAAS,YACpC,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YACvC,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,kBAAkB,IAAI,SAAS,YACvE,QAAQ,GAC0B,GACZ,GACP,GACS,CAClC,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAA;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAA;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;IAC5C,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAA;IACpC,OAAO,OAAO,CAAyB,GAAG,EAAE;QAC1C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;QAC7B,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QAC7B,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAA+B,CAAC,CAAA;IAC/E,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;AACxB,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/render-cases-primitives.js

@@ -67,7 +67,7 @@ export const PRIMITIVE_RENDER_CASES = [
     {
         name: "Alert",
         marker: "RC:Alert",
-        render: () => (_jsxs(Alert, { variant: "destructive", children: [_jsx(AlertTitle, { children: "RC:Alert" }), _jsx(AlertDescription, { children: "The engine rejected the job." })] })),
+        render: () => (_jsxs(Alert, { variant: "danger", children: [_jsx(AlertTitle, { children: "RC:Alert" }), _jsx(AlertDescription, { children: "The engine rejected the job." })] })),
     },
     {
         name: "ScrollArea",

package/dist/render-cases-primitives.js.map

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

package/dist/render-cases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-cases.d.ts","sourceRoot":"","sources":["../src/render-cases.tsx"],"names":[],"mappings":"AA0BA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAEtF,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAwC9D,eAAO,MAAM,YAAY,EAAE,UAAU,EAsNpC,CAAA"}
+{"version":3,"file":"render-cases.d.ts","sourceRoot":"","sources":["../src/render-cases.tsx"],"names":[],"mappings":"AA6BA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAEtF,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAwC9D,eAAO,MAAM,YAAY,EAAE,UAAU,EAmPpC,CAAA"}

package/dist/render-cases.js

@@ -1,8 +1,8 @@
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { Inbox } from "lucide-react";
-import { Button, CountPill, DrillButton, EmptyState, ErrorState, FilterBar, GridItem, GridLayout, GroupCard, KpiGrid, ListFooter, LivePill, LocaleProvider, SectionHeading, ThemeProvider, themePresets, ToastProvider, useLocale, WidgetHeader, } from "./index.js";
+import { ExternalLink, Inbox } from "lucide-react";
+import { Button, CountPill, DrillButton, EmptyState, ErrorState, FilterBar, GridItem, GridLayout, GroupCard, KpiGrid, KpiGridSkeleton, ListFooter, LivePill, LocaleProvider, PagedListFooter, SectionHeading, StatusBadge, ThemeProvider, themePresets, ToastProvider, useLocale, WidgetHeader, } from "./index.js";
 import { createStandaloneHostBridge, HostBridgeProvider, useHostBridge } from "./app/host-bridge.js";
-import { HostModelContext } from "./app/adapt-data-widget.js";
+import { HostModelContext } from "./app/model-context.js";
 import { WidgetFixtureHost } from "./app/widget-fixture.js";
 import { PRIMITIVE_RENDER_CASES } from "./render-cases-primitives.js";
 /**
@@ -62,9 +62,15 @@ export const RENDER_CASES = [
                     trendDirection: "up",
                 },
                 { label: "Done", value: 12, fraction: "/19", tone: "success" },
-                { label: "Total", value: 19, onClick: noop, ariaLabel: "Show all" },
+                { label: "Total", value: 19, onClick: noop, actionHint: "Shows all orders" },
             ] })),
     },
+    {
+        // A skeleton has no text; the marker is its busy state.
+        name: "KpiGridSkeleton",
+        marker: 'aria-busy="true"',
+        render: () => _jsx(KpiGridSkeleton, { cells: 4, boxed: true }),
+    },
     {
         name: "LivePill",
         marker: "RC:LivePill",
@@ -75,6 +81,11 @@ export const RENDER_CASES = [
         marker: "RC:CountPill",
         render: () => _jsx(CountPill, { tone: "warning", children: "RC:CountPill" }),
     },
+    {
+        name: "StatusBadge",
+        marker: "RC:StatusBadge",
+        render: () => _jsx(StatusBadge, { tone: "warning", children: "RC:StatusBadge" }),
+    },
     {
         name: "SectionHeading",
         marker: "RC:SectionHeading",
@@ -83,7 +94,7 @@ export const RENDER_CASES = [
     {
         name: "WidgetHeader",
         marker: "RC:WidgetHeader",
-        render: () => (_jsx(WidgetHeader, { icon: "\u2713", iconTone: "info", title: "RC:WidgetHeader", sub: _jsx(LivePill, { children: "Live" }), actions: _jsx(Button, { size: "sm", variant: "ghost", onClick: noop, children: "Refresh" }) })),
+        render: () => (_jsx(WidgetHeader, { as: "h2", title: "RC:WidgetHeader", badge: _jsx(StatusBadge, { tone: "info", children: "Running" }), sub: _jsx(LivePill, { children: "Live" }), actions: _jsx(Button, { size: "sm", variant: "ghost", onClick: noop, children: "Refresh" }) })),
     },
     {
         name: "GroupCard",
@@ -102,13 +113,26 @@ export const RENDER_CASES = [
     {
         name: "DrillButton",
         marker: "RC:DrillButton",
-        render: () => (_jsx(DrillButton, { onDrill: noop, icon: "\u2197", size: "sm", ariaLabel: "Open order o-1001", children: "RC:DrillButton" })),
+        render: () => (_jsx(DrillButton, { onDrill: noop, icon: _jsx(ExternalLink, {}), size: "sm", ariaLabel: "Open order o-1001", children: "RC:DrillButton" })),
     },
     {
         name: "ListFooter",
         marker: "of 42 tasks",
         render: () => _jsx(ListFooter, { shown: 8, total: 42, hasMore: true, onLoadMore: noop, noun: "tasks" }),
     },
+    {
+        name: "PagedListFooter",
+        marker: "of 3 orders",
+        render: () => (_jsx(PagedListFooter, { paged: {
+                items: ["o-1", "o-2"],
+                total: 3,
+                hasMore: true,
+                loadMore: noop,
+                refreshing: true,
+                firstPage: {},
+                loadMoreError: new Error("HTTP 503"),
+            }, noun: "orders" })),
+    },
     // ── Feedback and states ──
     {
         // The provider renders its children plus the (empty) live region.

package/dist/render-cases.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-cases.js","sourceRoot":"","sources":["../src/render-cases.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"render-cases.js","sourceRoot":"","sources":["../src/render-cases.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EACL,MAAM,EACN,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,EACP,eAAe,EACf,UAAU,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAsB,MAAM,yBAAyB,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAmB,MAAM,8BAA8B,CAAA;AAItF;;;;;;;;;;;GAWG;AAEH,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAA;AAE3B,mFAAmF;AACnF,MAAM,WAAW,GAAG,0BAA0B,CAAC;IAC7C,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM;CACd,CAAC,CAAA;AAEF,kFAAkF;AAClF,SAAS,gBAAgB;IACvB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAC9B,OAAO,qDAA6B,MAAM,CAAC,KAAK,IAAI,OAAO,IAAQ,CAAA;AACrE,CAAC;AAED,8EAA8E;AAC9E,SAAS,WAAW;IAClB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,OAAO,iDAAyB,MAAM,IAAQ,CAAA;AAChD,CAAC;AAED,sEAAsE;AACtE,SAAS,kBAAkB,CAAC,EAAE,IAAI,EAAwC;IACxE,OAAO,mDAA2B,IAAI,EAAE,KAAK,IAAI,YAAY,IAAO,CAAA;AACtE,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,GAAG,sBAAsB;IAEzB,4BAA4B;IAC5B;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,MAAC,UAAU,eACT,KAAC,QAAQ,IAAC,IAAI,EAAE,CAAC,YACf,0CAAwB,GACf,EACX,KAAC,QAAQ,IAAC,IAAI,EAAE,CAAC,YACf,sCAAoB,GACX,IACA,CACd;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,UAAU,cACT,KAAC,QAAQ,IAAC,IAAI,EAAE,CAAC,YACf,wCAAsB,GACb,GACA,CACd;KACF;IACD;QACE,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,OAAO,IACN,KAAK,QACL,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,EAC9C,KAAK,EAAE;gBACL;oBACE,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,CAAC;oBACR,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,iBAAiB;oBACxB,cAAc,EAAE,IAAI;iBACrB;gBACD,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC9D,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAE;aAC7E,GACD,CACH;KACF;IACD;QACE,wDAAwD;QACxD,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,eAAe,IAAC,KAAK,EAAE,CAAC,EAAE,KAAK,SAAG;KAClD;IACD;QACE,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,QAAQ,IAAC,IAAI,EAAC,SAAS,4BAAuB;KAC9D;IACD;QACE,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,SAAS,IAAC,IAAI,EAAC,SAAS,6BAAyB;KACjE;IACD;QACE,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,WAAW,IAAC,IAAI,EAAC,SAAS,+BAA6B;KACvE;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,cAAc,IAAC,KAAK,EAAC,mBAAmB,EAAC,IAAI,EAAC,SAAS,GAAG;KAC1E;IACD;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,YAAY,IACX,EAAE,EAAC,IAAI,EACP,KAAK,EAAC,iBAAiB,EACvB,KAAK,EAAE,KAAC,WAAW,IAAC,IAAI,EAAC,MAAM,wBAAsB,EACrD,GAAG,EAAE,KAAC,QAAQ,uBAAgB,EAC9B,OAAO,EACL,KAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,OAAO,EAAC,OAAO,EAAE,IAAI,wBAEtC,GAEX,CACH;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,SAAS,IAAC,QAAQ,QAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,yCAAuB,YAClE,8CAA4B,GAClB,CACb;KACF;IACD;QACE,0DAA0D;QAC1D,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,SAAS,IACR,MAAM,EAAC,cAAc,EACrB,iBAAiB,EAAC,oBAAe,EACjC,cAAc,EAAE,IAAI,EACpB,KAAK,EAAE;gBACL,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;gBACrD,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;aAC5B,EACD,YAAY,EAAE,IAAI,GAClB,CACH;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,WAAW,IAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAC,YAAY,KAAG,EAAE,IAAI,EAAC,IAAI,EAAC,SAAS,EAAC,mBAAmB,+BAE7E,CACf;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAC,UAAU,IAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,QAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAC,OAAO,GAAG;KACzF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,eAAe,IACd,KAAK,EAAE;gBACL,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;gBACrB,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,IAAI;gBAChB,SAAS,EAAE,EAAE;gBACb,aAAa,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC;aACrC,EACD,IAAI,EAAC,QAAQ,GACb,CACH;KACF;IAED,4BAA4B;IAC5B;QACE,kEAAkE;QAClE,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,aAAa,cACZ,6CAA2B,GACb,CACjB;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,UAAU,IACT,IAAI,EAAE,KAAC,KAAK,KAAG,EACf,KAAK,EAAC,eAAe,EACrB,WAAW,EAAC,2BAA2B,EACvC,MAAM,EACJ,KAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,IAAI,0BAEtB,GAEX,CACH;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,UAAU,IACT,KAAK,EAAC,eAAe,EACrB,WAAW,EAAC,qCAAqC,EACjD,OAAO,EAAC,8BAA8B,EACtC,OAAO,EAAE,IAAI,GACb,CACH;KACF;IAED,8BAA8B;IAC9B;QACE,IAAI,EAAE,oBAAoB;QAC1B,MAAM,EAAE,4BAA4B;QACpC,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,kBAAkB,IAAC,MAAM,EAAE,WAAW,YACrC,KAAC,gBAAgB,KAAG,GACD,CACtB;KACF;IACD;QACE,yEAAyE;QACzE,iEAAiE;QACjE,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,kBAAkB,IAAC,MAAM,EAAE,WAAW,YACrC,KAAC,gBAAgB,IAAC,OAAO,EAAC,0BAA0B,YAClD,gDAA8B,GACb,GACA,CACtB;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,aAAa,IAAC,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,IAAI,EAAC,MAAM,YACrD,6CAA2B,GACb,CACjB;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,cAAc,IAAC,MAAM,EAAC,IAAI,YACzB,KAAC,WAAW,KAAG,GACA,CAClB;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,mCAAmC;QAC3C,MAAM,EAAE,GAAG,EAAE,CAAC,CACZ,KAAC,iBAAiB,IAChB,MAAM,EAAE,kBAAmC,EAC3C,IAAI,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAC/B,CACH;KACF;CACF,CAAA"}

package/dist/render-effects.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Effect-running renders for the WIRING tests SSR cannot see: effects,
+ * subscriptions and timers of the view lifecycle and the data hooks
+ * (toolkit#176 review). `react-dom/client` + `act` in a test file that opts
+ * into a DOM with `// @vitest-environment happy-dom`. Not an interaction kit:
+ * the house render path stays SSR (`renderToStaticMarkup`), and these tests
+ * drive hooks through their inputs; a `click()` only where the wiring starts
+ * at a button.
+ */
+import { type ReactNode } from "react";
+/**
+ * Run `work` in an ASYNC act scope: the promises it starts (a tool call that
+ * resolves, a state update after it) settle, and their renders commit,
+ * before the scope ends.
+ */
+export declare function inAct(work: () => unknown): Promise<void>;
+export interface EffectRender {
+    container: HTMLElement;
+    /** Render `node` into the same root (a new host state, new props). */
+    rerender: (node: ReactNode) => Promise<void>;
+    /** Unmount and run the cleanups; a second call does nothing. */
+    unmount: () => Promise<void>;
+}
+/** Mount `node` and run its effects. */
+export declare function renderWithEffects(node: ReactNode): Promise<EffectRender>;
+/**
+ * Settle pending promises and the effects and renders they cause, with real
+ * timers: TanStack Query notifies its observers on a 0 ms timer, so each
+ * round lets one land (under fake timers use {@link advanceTimers}).
+ */
+export declare function flushEffects(rounds?: number): Promise<void>;
+/** Advance fake timers by `ms` inside act, so the renders they cause commit. */
+export declare function advanceTimers(advance: (ms: number) => unknown, ms: number): Promise<void>;
+/**
+ * Renders `useValue` in a probe and keeps its latest committed value: read
+ * `current` after a render or flush.
+ */
+export declare function hookProbe<T>(useValue: () => T): {
+    Probe: () => null;
+    current: () => T;
+};
+//# sourceMappingURL=render-effects.d.ts.map

package/dist/render-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-effects.d.ts","sourceRoot":"","sources":["../src/render-effects.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxD;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,WAAW,CAAA;IACtB,sEAAsE;IACtE,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,gEAAgE;IAChE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wCAAwC;AACxC,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAgB9E;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG;IAC/C,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,OAAO,EAAE,MAAM,CAAC,CAAA;CACjB,CAgBA"}

package/dist/render-effects.js

@@ -0,0 +1,81 @@
+/**
+ * Effect-running renders for the WIRING tests SSR cannot see: effects,
+ * subscriptions and timers of the view lifecycle and the data hooks
+ * (toolkit#176 review). `react-dom/client` + `act` in a test file that opts
+ * into a DOM with `// @vitest-environment happy-dom`. Not an interaction kit:
+ * the house render path stays SSR (`renderToStaticMarkup`), and these tests
+ * drive hooks through their inputs; a `click()` only where the wiring starts
+ * at a button.
+ */
+import { act, useEffect } from "react";
+import { createRoot } from "react-dom/client";
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+/**
+ * Run `work` in an ASYNC act scope: the promises it starts (a tool call that
+ * resolves, a state update after it) settle, and their renders commit,
+ * before the scope ends.
+ */
+export function inAct(work) {
+    return act(() => {
+        work();
+        return Promise.resolve();
+    });
+}
+/** Mount `node` and run its effects. */
+export async function renderWithEffects(node) {
+    const container = document.createElement("div");
+    document.body.append(container);
+    const root = createRoot(container);
+    await inAct(() => root.render(node));
+    let mounted = true;
+    return {
+        container,
+        rerender: (next) => inAct(() => root.render(next)),
+        unmount: async () => {
+            if (!mounted)
+                return;
+            mounted = false;
+            await inAct(() => root.unmount());
+            container.remove();
+        },
+    };
+}
+/**
+ * Settle pending promises and the effects and renders they cause, with real
+ * timers: TanStack Query notifies its observers on a 0 ms timer, so each
+ * round lets one land (under fake timers use {@link advanceTimers}).
+ */
+export async function flushEffects(rounds = 3) {
+    for (let round = 0; round < rounds; round++) {
+        await act(async () => {
+            await new Promise((resolve) => setTimeout(resolve, 0));
+        });
+    }
+}
+/** Advance fake timers by `ms` inside act, so the renders they cause commit. */
+export function advanceTimers(advance, ms) {
+    return inAct(() => advance(ms));
+}
+/**
+ * Renders `useValue` in a probe and keeps its latest committed value: read
+ * `current` after a render or flush.
+ */
+export function hookProbe(useValue) {
+    const box = {};
+    function Probe() {
+        const value = useValue();
+        useEffect(() => {
+            box.value = { current: value };
+        });
+        return null;
+    }
+    return {
+        Probe,
+        current: () => {
+            if (!box.value)
+                throw new Error("the probe has not committed yet");
+            return box.value.current;
+        },
+    };
+}
+//# sourceMappingURL=render-effects.js.map

package/dist/render-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-effects.js","sourceRoot":"","sources":["../src/render-effects.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAG5C;AAAC,UAAqD,CAAC,wBAAwB,GAAG,IAAI,CAAA;AAEvF;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,IAAmB;IACvC,OAAO,GAAG,CAAC,GAAG,EAAE;QACd,IAAI,EAAE,CAAA;QACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC;AAUD,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAe;IACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC/C,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAClC,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACpC,IAAI,OAAO,GAAG,IAAI,CAAA;IAClB,OAAO;QACL,SAAS;QACT,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,OAAO,GAAG,KAAK,CAAA;YACf,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;YACjC,SAAS,CAAC,MAAM,EAAE,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAM,GAAG,CAAC;IAC3C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACnB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;QACxD,CAAC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,OAAgC,EAAE,EAAU;IACxE,OAAO,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAI,QAAiB;IAI5C,MAAM,GAAG,GAA+B,EAAE,CAAA;IAC1C,SAAS,KAAK;QACZ,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAA;QACxB,SAAS,CAAC,GAAG,EAAE;YACb,GAAG,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QAChC,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO;QACL,KAAK;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;YAClE,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/theme/create-theme.d.ts

@@ -133,6 +133,19 @@ export interface ThemeTokens {
     fontMono?: string;
     /** Heading font-family list. Maps to `--font-heading`. */
     fontHeading?: string;
+    /** Page title size (CI h2, 28 px). Maps to `--text-title` (`text-title`). */
+    textTitle?: string;
+    /** Section title size (CI h3, 21 px). Maps to `--text-section` (`text-section`). */
+    textSection?: string;
+    /** Running text size (16 px). Maps to `--text-body` (`text-body`). */
+    textBody?: string;
+    /** Dense tables and controls (14 px), never running text. Maps to `--text-dense` (`text-dense`). */
+    textDense?: string;
+    /**
+     * Captions, labels and hints: the smallest text the kit renders (13 px;
+     * keep it at 13 px or more). Maps to `--text-small` (`text-small`).
+     */
+    textSmall?: string;
 }
 /** The CSS custom-property name a {@link ThemeTokens} field resolves to. */
 type CssVarName = `--${string}`;
@@ -191,6 +204,11 @@ export declare const TOKEN_TO_CSS_VAR: {
     readonly fontSans: "--font-sans";
     readonly fontMono: "--font-mono";
     readonly fontHeading: "--font-heading";
+    readonly textTitle: "--text-title";
+    readonly textSection: "--text-section";
+    readonly textBody: "--text-body";
+    readonly textDense: "--text-dense";
+    readonly textSmall: "--text-small";
 };
 /**
  * The role-token contract: every variable the toolkit defines for components
@@ -198,7 +216,7 @@ export declare const TOKEN_TO_CSS_VAR: {
  * package, and in apps built on it, style through these names only, never
  * through raw colours or Tailwind palette classes.
  */
-export declare const ROLE_TOKENS: readonly ["--background", "--card", "--popover", "--muted", "--secondary", "--foreground", "--muted-foreground", "--border", "--input", "--primary", "--primary-foreground", "--primary-hover", "--link", "--ring", "--focus", "--success", "--warning", "--danger", "--info", "--success-soft", "--warning-soft", "--danger-soft", "--info-soft", "--success-ink", "--warning-ink", "--danger-ink", "--info-ink", "--destructive", "--radius-sm", "--radius-md", "--radius-lg", "--radius-pill", "--shadow-1", "--shadow-2", "--shadow-3", "--scrim", "--motion-fast", "--motion-base", "--motion-slow", "--ease", "--font-sans", "--font-mono"];
+export declare const ROLE_TOKENS: readonly ["--background", "--card", "--popover", "--muted", "--secondary", "--foreground", "--muted-foreground", "--border", "--input", "--primary", "--primary-foreground", "--primary-hover", "--link", "--ring", "--focus", "--success", "--warning", "--danger", "--info", "--success-soft", "--warning-soft", "--danger-soft", "--info-soft", "--success-ink", "--warning-ink", "--danger-ink", "--info-ink", "--destructive", "--radius-sm", "--radius-md", "--radius-lg", "--radius-pill", "--shadow-1", "--shadow-2", "--shadow-3", "--scrim", "--motion-fast", "--motion-base", "--motion-slow", "--ease", "--font-sans", "--font-mono", "--text-title", "--text-section", "--text-body", "--text-dense", "--text-small"];
 /**
  * Variables whose toolkit value is the same in light and dark (theme.css
  * declares them once, or identically in both modes). A theme's LIGHT value for

package/dist/theme/create-theme.d.ts.map

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

package/dist/theme/create-theme.js

@@ -53,6 +53,11 @@ export const TOKEN_TO_CSS_VAR = {
     fontSans: "--font-sans",
     fontMono: "--font-mono",
     fontHeading: "--font-heading",
+    textTitle: "--text-title",
+    textSection: "--text-section",
+    textBody: "--text-body",
+    textDense: "--text-dense",
+    textSmall: "--text-small",
 };
 /**
  * The role-token contract: every variable the toolkit defines for components
@@ -103,6 +108,11 @@ export const ROLE_TOKENS = [
     "--ease",
     "--font-sans",
     "--font-mono",
+    "--text-title",
+    "--text-section",
+    "--text-body",
+    "--text-dense",
+    "--text-small",
 ];
 /**
  * Variables whose toolkit value is the same in light and dark (theme.css
@@ -136,6 +146,11 @@ export const MODE_INVARIANT_VARS = new Set([
     "--font-sans",
     "--font-mono",
     "--font-heading",
+    "--text-title",
+    "--text-section",
+    "--text-body",
+    "--text-dense",
+    "--text-small",
 ]);
 /**
  * Map a {@link ThemeTokens} object to its CSS variables. Empty/partial token

package/dist/theme/create-theme.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@miragon/mcp-toolkit-ui",
-  "version": "2.7.0",
-  "description": "React UI for MCP servers: shadcn primitives, composite components, TanStack Query hooks, and the MCP App shell (McpAppView + WidgetRenderer).",
+  "version": "2.8.0",
+  "description": "React UI for MCP servers in the Miragon design system (white-label through role tokens): primitives, composite components, TanStack Query hooks, and the MCP App shell (McpAppView + WidgetRenderer).",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Miragon/mcp-toolkit.git",
@@ -45,7 +45,7 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "tailwindcss": "^4.3.0",
-    "@miragon/mcp-toolkit-core": "~2.7.0"
+    "@miragon/mcp-toolkit-core": "~2.8.0"
   },
   "dependencies": {
     "@base-ui/react": "1.8.0",
@@ -67,13 +67,14 @@
     "@types/react-dom": "19.3.0",
     "@vitest/coverage-v8": "4.1.11",
     "fast-check": "4.10.2",
+    "happy-dom": "20.14.5",
     "mcp-use": "2.7.3",
     "react": "19.3.0",
     "react-dom": "19.3.0",
     "tailwindcss": "4.3.3",
     "typescript": "6.0.3",
     "vitest": "4.1.11",
-    "@miragon/mcp-toolkit-core": "2.7.0"
+    "@miragon/mcp-toolkit-core": "2.8.0"
   },
   "engines": {
     "node": ">=22.22.2"

package/src/app/adapt-data-widget.tsx

@@ -1,8 +1,6 @@
-import { useEffect, type ComponentType, type ReactNode } from "react"
-import { ModelContext } from "mcp-use/react"
+import type { ComponentType } from "react"
 import type { WidgetProps } from "@miragon/mcp-toolkit-core"
-import { useHostBridgeOrNull } from "./host-bridge.js"
-import { useIsInsideMcpUseView } from "./mcp-use-host-bridge.js"
+import { HostModelContext } from "./model-context.js"
 import type { WidgetComponent } from "./widget-renderer.js"
 
 /**
@@ -16,44 +14,6 @@ export type DescribeForModel<T> = (
   props: Readonly<Record<string, unknown>>,
 ) => string
 
-/**
- * Model-context reporting that works on every host — the host-portable
- * replacement for rendering `mcp-use/react`'s `ModelContext` directly.
- *
- * mcp-use 2.x's `ModelContext` registers with the view runtime and THROWS
- * outside a `bootstrapView` mount, so it is only rendered inside an mcp-use
- * view (where it aggregates nested nodes into one tree). Everywhere else —
- * ChatGPT via `createChatGptHostBridge`, the `WidgetFixtureHost` harness,
- * standalone apps — the description flows through the bridge's
- * `setModelContext` instead (last-writer-wins; fine for the single-widget
- * mounts those hosts render).
- *
- * Widgets that self-fetch and report their own context (cockpit views like
- * `TasksBoard`) must use this instead of importing `ModelContext` from
- * `mcp-use/react` — the direct import crashes the widget in every non-view
- * mount, starting with the widget playground.
- */
-export function HostModelContext({
-  content,
-  children,
-}: {
-  content: string
-  children: ReactNode
-}): ReactNode {
-  const insideView = useIsInsideMcpUseView()
-  if (insideView) return <ModelContext content={content}>{children}</ModelContext>
-  return <BridgeModelContext content={content}>{children}</BridgeModelContext>
-}
-
-function BridgeModelContext({ content, children }: { content: string; children: ReactNode }) {
-  const bridge = useHostBridgeOrNull()
-  const setModelContext = bridge?.setModelContext
-  useEffect(() => {
-    setModelContext?.(content)
-  }, [setModelContext, content])
-  return children
-}
-
 /**
  * Wraps a "single-data" widget component (signature `({ data }: { data: T | null })`)
  * so it can be registered as a framework {@link WidgetComponent} (which receives