@miragon/pulse-widget-shell 0.24.1 → 0.25.0

package/dist/ui/open-in-cockpit-link.d.ts

@@ -1,28 +1,9 @@
-/**
- * The single, consistent "jump to the engine's own web app" affordance (the
- * vendor's cockpit, which leaves this app in a new tab). A secondary button
- * of the view's one action size (the toolkit's `buttonVariants` outline,
- * `sm`: 32 px, 14 px, 600, like the chat hand-offs beside it), since it is
- * deterministic navigation, not AI. It belongs in the view's action group,
- * never in the meta line.
- * Named after the vendor ("In CIB seven öffnen" / "Open in CIB seven"), not
- * "Cockpit", which is this app's own name; the accessible name adds that it
- * opens a new tab. Owns the host bridge call, so callers pass only the URL.
- * `variant="menuitem"` makes it an entry of a row's action menu
- * ({@link MENU_ITEM}, `role="menuitem"`, its icon in front like the menu's
- * other entries).
- */
+/** Named after the vendor, not "Cockpit", which is this app's own name. */
 export declare function OpenInCockpitLink({ url, vendor, label, variant, }: {
     url: string;
-    /**
-     * The engine product's display name from the provider branding
-     * (`provider.branding.displayName`: "CIB seven", "Camunda 7", "Operaton").
-     * Without it the link reads "Im Engine-Cockpit öffnen" / "Open in engine cockpit".
-     */
+    /** `provider.branding.displayName`. */
     vendor?: string;
-    /** Visible text override for a narrower target, e.g. "Instanz in CIB seven öffnen". */
     label?: string;
-    /** `outline` (default): a link on its own; `menuitem`: an entry of an action menu. */
     variant?: "outline" | "menuitem";
 }): import("react").JSX.Element;
 //# sourceMappingURL=open-in-cockpit-link.d.ts.map

package/dist/ui/open-in-cockpit-link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-in-cockpit-link.d.ts","sourceRoot":"","sources":["../../src/ui/open-in-cockpit-link.tsx"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,GAAG,EACH,MAAM,EACN,KAAK,EACL,OAAmB,GACpB,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sFAAsF;IACtF,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CACjC,+BA4BA"}
+{"version":3,"file":"open-in-cockpit-link.d.ts","sourceRoot":"","sources":["../../src/ui/open-in-cockpit-link.tsx"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,EAChC,GAAG,EACH,MAAM,EACN,KAAK,EACL,OAAmB,GACpB,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CACjC,+BA4BA"}

package/dist/ui/open-in-cockpit-link.js

@@ -1,26 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { buttonVariants, useLocale } from "@miragon/mcp-toolkit-ui";
+import { buttonVariants, useLocale, Icon, MENU_ITEM } from "@miragon/pulse-ui";
 import { ExternalLink } from "lucide-react";
-import { useHostActions } from "@miragon/mcp-toolkit-ui/app";
-import { Icon } from "./icon.js";
 import { kitLabels } from "./kit-labels.js";
-import { MENU_ITEM } from "./menu-item.js";
-/**
- * The single, consistent "jump to the engine's own web app" affordance (the
- * vendor's cockpit, which leaves this app in a new tab). A secondary button
- * of the view's one action size (the toolkit's `buttonVariants` outline,
- * `sm`: 32 px, 14 px, 600, like the chat hand-offs beside it), since it is
- * deterministic navigation, not AI. It belongs in the view's action group,
- * never in the meta line.
- * Named after the vendor ("In CIB seven öffnen" / "Open in CIB seven"), not
- * "Cockpit", which is this app's own name; the accessible name adds that it
- * opens a new tab. Owns the host bridge call, so callers pass only the URL.
- * `variant="menuitem"` makes it an entry of a row's action menu
- * ({@link MENU_ITEM}, `role="menuitem"`, its icon in front like the menu's
- * other entries).
- */
+import { useViewHost } from "./view-host.js";
+/** Named after the vendor, not "Cockpit", which is this app's own name. */
 export function OpenInCockpitLink({ url, vendor, label, variant = "outline", }) {
-    const host = useHostActions();
+    const { openExternal } = useViewHost();
     const labels = kitLabels(useLocale());
     const text = label ?? labels.openInVendor(vendor);
     const link = {
@@ -29,7 +14,7 @@ export function OpenInCockpitLink({ url, vendor, label, variant = "outline", })
         rel: "noopener noreferrer",
         onClick: (e) => {
             e.preventDefault();
-            host.openLink(url);
+            openExternal(url);
         },
         "aria-label": labels.opensInNewTab(text),
     };

package/dist/ui/open-in-cockpit-link.js.map

@@ -1 +1 @@
-{"version":3,"file":"open-in-cockpit-link.js","sourceRoot":"","sources":["../../src/ui/open-in-cockpit-link.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,GAAG,EACH,MAAM,EACN,KAAK,EACL,OAAO,GAAG,SAAS,GAapB;IACC,MAAM,IAAI,GAAG,cAAc,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,qBAAqB;QAC1B,OAAO,EAAE,CAAC,CAAgC,EAAE,EAAE;YAC5C,CAAC,CAAC,cAAc,EAAE,CAAA;YAClB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACpB,CAAC;QACD,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC;KACzC,CAAA;IACD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,CACL,gBAAO,IAAI,EAAE,IAAI,EAAC,UAAU,EAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,aAC7D,KAAC,IAAI,IAAC,IAAI,EAAE,YAAY,EAAE,KAAK,SAAG,EACjC,IAAI,IACH,CACL,CAAA;IACH,CAAC;IACD,OAAO,CACL,gBAAO,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,aACvE,IAAI,EACL,KAAC,IAAI,IAAC,IAAI,EAAE,YAAY,EAAE,KAAK,SAAG,IAChC,CACL,CAAA;AACH,CAAC"}
+{"version":3,"file":"open-in-cockpit-link.js","sourceRoot":"","sources":["../../src/ui/open-in-cockpit-link.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,EAChC,GAAG,EACH,MAAM,EACN,KAAK,EACL,OAAO,GAAG,SAAS,GAOpB;IACC,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAAA;IACtC,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,qBAAqB;QAC1B,OAAO,EAAE,CAAC,CAAgC,EAAE,EAAE;YAC5C,CAAC,CAAC,cAAc,EAAE,CAAA;YAClB,YAAY,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;QACD,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC;KACzC,CAAA;IACD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,CACL,gBAAO,IAAI,EAAE,IAAI,EAAC,UAAU,EAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,aAC7D,KAAC,IAAI,IAAC,IAAI,EAAE,YAAY,EAAE,KAAK,SAAG,EACjC,IAAI,IACH,CACL,CAAA;IACH,CAAC;IACD,OAAO,CACL,gBAAO,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,aACvE,IAAI,EACL,KAAC,IAAI,IAAC,IAAI,EAAE,YAAY,EAAE,KAAK,SAAG,IAChC,CACL,CAAA;AACH,CAAC"}

package/dist/ui/paged-rows.d.ts

@@ -1,23 +1,12 @@
 import type { ReactNode } from "react";
 import type { PagedViewData } from "./use-paged-view-data.js";
 /**
- * The rows of a paged list — its table (or row cards) and empty state —
- * marked while they are the PREVIOUS result (`paged.stale`: a new search or
- * filter is in flight or has failed) and `aria-busy` while a page 0 is in
- * flight. The mark is a bar along the left edge in the tone of the state
- * (info while the new page loads, warning once it failed), not a dimming:
- * faded rows push muted text under 4.5:1. Pairs with the toolkit's
- * `PagedListFooter` (`paged` passes as is), whose live count line says in
- * words what the bar marks ("Updating…", the failure above it), so old rows
- * under a new search never read as its answer. The toolkit did not lift this
- * piece: it is the kit's own. Its rows are already the inline head
- * (`usePagedViewData`, #396), so a `ListTable` inside does not cap them again
- * and hands its body to the list's fit; without a table, the wrapper's
- * children (row cards) are the rows the fit measures.
+ * Marks PREVIOUS-result rows with an edge bar, not a dimming: faded rows push
+ * muted text under 4.5:1. The footer says in words what the bar marks, so old
+ * rows never read as the new search's answer.
  */
 export declare function PagedRows<TItem, TData>({ paged, className, children, }: {
     paged: PagedViewData<TItem, TData>;
-    /** Merged into the wrapper (e.g. the `flex flex-col gap-2` of a card list). */
     className?: string;
     children: ReactNode;
 }): import("react").JSX.Element;

package/dist/ui/paged-rows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paged-rows.d.ts","sourceRoot":"","sources":["../../src/ui/paged-rows.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,EACtC,KAAK,EACL,SAAS,EACT,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAClC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAwBA"}
+{"version":3,"file":"paged-rows.d.ts","sourceRoot":"","sources":["../../src/ui/paged-rows.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,EACtC,KAAK,EACL,SAAS,EACT,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAwBA"}

package/dist/ui/paged-rows.js

@@ -1,20 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { cn, TONE_DOT } from "@miragon/mcp-toolkit-ui";
+import { cn, TONE_DOT } from "@miragon/pulse-ui";
 import { RowsBudgeted } from "./inline-budget.js";
 /**
- * The rows of a paged list — its table (or row cards) and empty state —
- * marked while they are the PREVIOUS result (`paged.stale`: a new search or
- * filter is in flight or has failed) and `aria-busy` while a page 0 is in
- * flight. The mark is a bar along the left edge in the tone of the state
- * (info while the new page loads, warning once it failed), not a dimming:
- * faded rows push muted text under 4.5:1. Pairs with the toolkit's
- * `PagedListFooter` (`paged` passes as is), whose live count line says in
- * words what the bar marks ("Updating…", the failure above it), so old rows
- * under a new search never read as its answer. The toolkit did not lift this
- * piece: it is the kit's own. Its rows are already the inline head
- * (`usePagedViewData`, #396), so a `ListTable` inside does not cap them again
- * and hands its body to the list's fit; without a table, the wrapper's
- * children (row cards) are the rows the fit measures.
+ * Marks PREVIOUS-result rows with an edge bar, not a dimming: faded rows push
+ * muted text under 4.5:1. The footer says in words what the bar marks, so old
+ * rows never read as the new search's answer.
  */
 export function PagedRows({ paged, className, children, }) {
     const tone = paged.refreshing ? "info" : "warning";

package/dist/ui/paged-rows.js.map

@@ -1 +1 @@
-{"version":3,"file":"paged-rows.js","sourceRoot":"","sources":["../../src/ui/paged-rows.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAe,EACtC,KAAK,EACL,SAAS,EACT,QAAQ,GAMT;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IAClD,2EAA2E;IAC3E,MAAM,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC,GAAG,CAAA;IACpC,OAAO,CACL,eACE,GAAG,EAAE,cAAc,eACR,KAAK,CAAC,UAAU,gBACf,KAAK,CAAC,KAAK,IAAI,SAAS,EACpC,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,aAEnC,KAAK,CAAC,KAAK,IAAI,CACd,8BACc,MAAM,eACP,IAAI,EACf,SAAS,EAAE,EAAE,CACX,wEAAwE,EACxE,QAAQ,CAAC,IAAI,CAAC,CACf,GACD,CACH,EACD,KAAC,YAAY,IAAC,IAAI,EAAE,KAAK,CAAC,GAAG,YAAG,QAAQ,GAAgB,IACpD,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"paged-rows.js","sourceRoot":"","sources":["../../src/ui/paged-rows.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGjD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAe,EACtC,KAAK,EACL,SAAS,EACT,QAAQ,GAKT;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IAClD,2EAA2E;IAC3E,MAAM,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC,GAAG,CAAA;IACpC,OAAO,CACL,eACE,GAAG,EAAE,cAAc,eACR,KAAK,CAAC,UAAU,gBACf,KAAK,CAAC,KAAK,IAAI,SAAS,EACpC,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,aAEnC,KAAK,CAAC,KAAK,IAAI,CACd,8BACc,MAAM,eACP,IAAI,EACf,SAAS,EAAE,EAAE,CACX,wEAAwE,EACxE,QAAQ,CAAC,IAAI,CAAC,CACf,GACD,CACH,EACD,KAAC,YAAY,IAAC,IAAI,EAAE,KAAK,CAAC,GAAG,YAAG,QAAQ,GAAgB,IACpD,CACP,CAAA;AACH,CAAC"}

package/dist/ui/query-fallback.d.ts

@@ -1,27 +1,13 @@
 import type { ReactNode } from "react";
-/**
- * Fallback for self-fetching widgets while their query has no data yet: the
- * skeleton under a polite loading status while loading, and the toolkit's
- * `ErrorState` once the query errored — the branch several dashboard widgets
- * forgot, leaving them on an eternal skeleton after a failed fetch.
- *
- * The error says what happened and what you can do ({@link describeError}:
- * "Die Engine prod ist nicht erreichbar (HTTP 503)", "Prüf, ob die Engine
- * läuft …"), keeps the raw reason collapsed under "Details" and always
- * offers the retry. `errorTitle` names what failed to load in the caller's
- * words; it heads an error the kit cannot classify.
- */
+/** The error branch several widgets forgot, leaving them on an eternal skeleton. */
 export declare function QueryFallback({ isError, error, onRetry, errorTitle, loadingText, skeleton, }: {
     isError: boolean;
     error?: unknown;
-    /** Re-run the failed query (its refetch). */
     onRetry: () => void;
-    /** Caller-localized headline for an unclassified error: what failed, one line. */
+    /** Heads an error the kit cannot classify. */
     errorTitle?: string;
-    /** The loading status for screen readers (default: the active locale's "Loading view…"). */
     loadingText?: string;
     skeleton: ReactNode;
 }): import("react").JSX.Element;
-/** The dashboards' standard table placeholder (bordered card + two bars). */
 export declare function TableSkeleton(): import("react").JSX.Element;
 //# sourceMappingURL=query-fallback.d.ts.map

package/dist/ui/query-fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-fallback.d.ts","sourceRoot":"","sources":["../../src/ui/query-fallback.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,OAAO,EACP,UAAU,EACV,WAAW,EACX,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAcA;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,gCAO5B"}
+{"version":3,"file":"query-fallback.d.ts","sourceRoot":"","sources":["../../src/ui/query-fallback.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,OAAO,EACP,UAAU,EACV,WAAW,EACX,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAcA;AAED,wBAAgB,aAAa,gCAO5B"}

package/dist/ui/query-fallback.js

@@ -1,20 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { ErrorState, Skeleton, useLocale } from "@miragon/mcp-toolkit-ui";
+import { ErrorState, Skeleton, useLocale } from "@miragon/pulse-ui";
 import { describeError } from "./describe-error.js";
 import { kitLabels } from "./kit-labels.js";
 import { LoadingStatus } from "./view-data-state.js";
-/**
- * Fallback for self-fetching widgets while their query has no data yet: the
- * skeleton under a polite loading status while loading, and the toolkit's
- * `ErrorState` once the query errored — the branch several dashboard widgets
- * forgot, leaving them on an eternal skeleton after a failed fetch.
- *
- * The error says what happened and what you can do ({@link describeError}:
- * "Die Engine prod ist nicht erreichbar (HTTP 503)", "Prüf, ob die Engine
- * läuft …"), keeps the raw reason collapsed under "Details" and always
- * offers the retry. `errorTitle` names what failed to load in the caller's
- * words; it heads an error the kit cannot classify.
- */
+/** The error branch several widgets forgot, leaving them on an eternal skeleton. */
 export function QueryFallback({ isError, error, onRetry, errorTitle, loadingText, skeleton, }) {
     const locale = useLocale();
     if (isError) {
@@ -23,7 +12,6 @@ export function QueryFallback({ isError, error, onRetry, errorTitle, loadingText
     }
     return _jsx(LoadingStatus, { text: loadingText ?? kitLabels(locale).loadingView, skeleton: skeleton });
 }
-/** The dashboards' standard table placeholder (bordered card + two bars). */
 export function TableSkeleton() {
     return (_jsxs("div", { className: "rounded-lg border p-4", children: [_jsx(Skeleton, { className: "mb-3 h-5 w-40" }), _jsx(Skeleton, { className: "h-32 w-full" })] }));
 }

package/dist/ui/query-fallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-fallback.js","sourceRoot":"","sources":["../../src/ui/query-fallback.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,OAAO,EACP,UAAU,EACV,WAAW,EACX,QAAQ,GAWT;IACC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAA;QAC7E,OAAO,CACL,KAAC,UAAU,IACT,KAAK,EAAE,SAAS,CAAC,KAAK,EACtB,WAAW,EAAE,SAAS,CAAC,IAAI,EAC3B,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,EACvC,OAAO,EAAE,OAAO,GAChB,CACH,CAAA;IACH,CAAC;IACD,OAAO,KAAC,aAAa,IAAC,IAAI,EAAE,WAAW,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAI,CAAA;AAClG,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa;IAC3B,OAAO,CACL,eAAK,SAAS,EAAC,uBAAuB,aACpC,KAAC,QAAQ,IAAC,SAAS,EAAC,eAAe,GAAG,EACtC,KAAC,QAAQ,IAAC,SAAS,EAAC,aAAa,GAAG,IAChC,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"query-fallback.js","sourceRoot":"","sources":["../../src/ui/query-fallback.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,oFAAoF;AACpF,MAAM,UAAU,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,OAAO,EACP,UAAU,EACV,WAAW,EACX,QAAQ,GAST;IACC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAA;QAC7E,OAAO,CACL,KAAC,UAAU,IACT,KAAK,EAAE,SAAS,CAAC,KAAK,EACtB,WAAW,EAAE,SAAS,CAAC,IAAI,EAC3B,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,EACvC,OAAO,EAAE,OAAO,GAChB,CACH,CAAA;IACH,CAAC;IACD,OAAO,KAAC,aAAa,IAAC,IAAI,EAAE,WAAW,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAI,CAAA;AAClG,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,CACL,eAAK,SAAS,EAAC,uBAAuB,aACpC,KAAC,QAAQ,IAAC,SAAS,EAAC,eAAe,GAAG,EACtC,KAAC,QAAQ,IAAC,SAAS,EAAC,aAAa,GAAG,IAChC,CACP,CAAA;AACH,CAAC"}

package/dist/ui/shell-host.d.ts

@@ -1,46 +1,36 @@
 import { type ReactNode } from "react";
-import { type EffectiveTheme, type HostStyleVariables } from "./host-context.js";
+import type { EffectiveTheme, HostStyleVariables } from "./host-context.js";
 /**
- * What the shell reads from the host (SEP-1865 `hostContext`), as REPORTED —
- * no fallbacks folded in, so "the host said nothing" stays distinguishable
- * from "the host said light/en-US". mcp-use's hooks only work under
- * `bootstrapView`; the value is provided once from the bundle root
- * ({@link ViewHostBridge}) and reads as "no host" everywhere else (unit
- * renders, fixtures, standalone embeds).
+ * As REPORTED, no fallbacks, so "the host said nothing" stays distinguishable. The mcp-use
+ * adapter (`McpUseViewHost`) provides it in production, `TestViewHost` in tests.
  */
 export interface ShellHost {
     /** The bridge is connected; until then every other field is unknown. */
     connected: boolean;
     theme?: EffectiveTheme;
-    /** BCP 47 tag, e.g. `de-DE`. */
     locale?: string;
-    /** IANA time zone, e.g. `Europe/Berlin`. */
     timeZone?: string;
     /** SEP-1865 `styles.variables` (`--color-*`, `--font-*`, …). */
     styleVariables?: HostStyleVariables;
-    /** SEP-1865 `styles.css.fonts` — `@font-face`/`@import` CSS for the host font. */
+    /** SEP-1865 `styles.css.fonts`: `@font-face`/`@import` CSS for the host font. */
     fontCss?: string;
     displayMode: string;
-    /** Modes the view may request: the host's offer ∩ the view config. */
     availableDisplayModes: readonly string[];
     /** Vertical budget in px from `containerDimensions`; `undefined` = unbounded. */
     maxHeight?: number;
-    /** The tool that rendered this view (SEP-1865 `toolInfo`), when the host names it. */
-    toolName?: string;
+    /** Mobile safe-area insets in px. */
+    safeArea?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** The serving MCP server's public asset base (empty outside a served view document). */
+    publicBase?: string;
 }
-/** Provide a host description to the shell (the bundle root, or a test/fixture). */
 export declare function ShellHostProvider({ host, children }: {
     host: ShellHost;
     children: ReactNode;
 }): import("react").JSX.Element;
-/** The host as reported to this view — "no host" outside {@link ViewHostBridge}. */
 export declare function useShellHost(): ShellHost;
-/**
- * Bridges the view-scoped host context and display mode (mcp-use hooks, legal
- * only under `bootstrapView`) into the host-agnostic contexts the shell and
- * the widgets read: {@link useShellHost} and `useHostDisplayMode`.
- */
-export declare function ViewHostBridge({ children }: {
-    children: ReactNode;
-}): import("react").JSX.Element;
 //# sourceMappingURL=shell-host.d.ts.map

package/dist/ui/shell-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell-host.d.ts","sourceRoot":"","sources":["../../src/ui/shell-host.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAG1E,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAU7F;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAMD,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAE7F;AAED,oFAAoF;AACpF,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAiDnE"}
+{"version":3,"file":"shell-host.d.ts","sourceRoot":"","sources":["../../src/ui/shell-host.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3E;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACvE,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAMD,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAE7F;AAED,wBAAgB,YAAY,IAAI,SAAS,CAExC"}

package/dist/ui/shell-host.js

@@ -1,56 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext, useMemo } from "react";
-import { useDisplayMode, useHostContext } from "mcp-use/react";
-import { resolveRecoveryToolName } from "@miragon/mcp-toolkit-ui/hooks";
-import { hostThemeOf } from "./host-context.js";
-import { INLINE_DIAGRAM_MAX_HEIGHT, InlineBudgetProvider, NO_INLINE_BUDGET, } from "./inline-budget.js";
-import { DisplayModeControlProvider } from "./display-mode-toggle.js";
-import { DisplayModeProvider } from "./widget-shell.js";
+import { createContext, useContext } from "react";
 const NO_HOST = { connected: true, displayMode: "inline", availableDisplayModes: [] };
 const ShellHostContext = createContext(NO_HOST);
-/** Provide a host description to the shell (the bundle root, or a test/fixture). */
 export function ShellHostProvider({ host, children }) {
     return _jsx(ShellHostContext.Provider, { value: host, children: children });
 }
-/** The host as reported to this view — "no host" outside {@link ViewHostBridge}. */
 export function useShellHost() {
     return useContext(ShellHostContext);
 }
-/**
- * Bridges the view-scoped host context and display mode (mcp-use hooks, legal
- * only under `bootstrapView`) into the host-agnostic contexts the shell and
- * the widgets read: {@link useShellHost} and `useHostDisplayMode`.
- */
-export function ViewHostBridge({ children }) {
-    const { hostContext, isAvailable, maxHeight } = useHostContext();
-    const { displayMode, availableDisplayModes, requestDisplayMode } = useDisplayMode();
-    const host = useMemo(() => ({
-        connected: isAvailable,
-        theme: hostThemeOf(hostContext?.theme),
-        locale: hostContext?.locale,
-        timeZone: hostContext?.timeZone,
-        styleVariables: hostContext?.styles?.variables,
-        fontCss: hostContext?.styles?.css?.fonts,
-        displayMode,
-        availableDisplayModes,
-        maxHeight,
-        toolName: resolveRecoveryToolName(hostContext),
-    }), [hostContext, isAvailable, maxHeight, displayMode, availableDisplayModes]);
-    // Inline, the view is a card in the chat: lists show the head of their rows
-    // (as many as fit, `HostDocument`'s measured fit) and "show more" asks for
-    // fullscreen where the host offers it (#396).
-    const canExpand = availableDisplayModes.includes("fullscreen");
-    const budget = useMemo(() => displayMode === "inline"
-        ? {
-            diagramMaxHeight: INLINE_DIAGRAM_MAX_HEIGHT,
-            expand: canExpand ? () => void requestDisplayMode({ mode: "fullscreen" }) : null,
-        }
-        : NO_INLINE_BUDGET, [displayMode, canExpand, requestDisplayMode]);
-    const control = useMemo(() => ({
-        displayMode,
-        canFullscreen: canExpand,
-        request: (mode) => void requestDisplayMode({ mode }),
-    }), [displayMode, canExpand, requestDisplayMode]);
-    return (_jsx(ShellHostProvider, { host: host, children: _jsx(DisplayModeProvider, { mode: displayMode, children: _jsx(DisplayModeControlProvider, { control: control, children: _jsx(InlineBudgetProvider, { budget: budget, children: children }) }) }) }));
-}
 //# sourceMappingURL=shell-host.js.map

package/dist/ui/shell-host.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-host.js","sourceRoot":"","sources":["../../src/ui/shell-host.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"shell-host.js","sourceRoot":"","sources":["../../src/ui/shell-host.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AA2BjE,MAAM,OAAO,GAAc,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,qBAAqB,EAAE,EAAE,EAAE,CAAA;AAEhG,MAAM,gBAAgB,GAAG,aAAa,CAAY,OAAO,CAAC,CAAA;AAE1D,MAAM,UAAU,iBAAiB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAA4C;IAC5F,OAAO,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAAG,QAAQ,GAA6B,CAAA;AACvF,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,gBAAgB,CAAC,CAAA;AACrC,CAAC"}

package/dist/ui/test-view-host.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Renders a widget WITHOUT a host: fake tools, a log of what it asked the host to do and the
+ * model context it reported. It mounts the same host contexts as the mcp-use adapter
+ * (`HostContexts`: display mode, fullscreen switch, inline budget, view host), a query client,
+ * the host widgets, the icon stroke and toasts, so a widget test needs no `bootstrapView`. Not
+ * mounted: `HostDocument` (theme, fonts, the measured inline fit) and `LocaleGate` (pass
+ * `locale` instead).
+ */
+import { type ReactNode } from "react";
+import { type QueryClient } from "@tanstack/react-query";
+import { type HostWidgets } from "./host-widgets.js";
+import type { ShellHost } from "./shell-host.js";
+export type HostAction = {
+    type: "callTool";
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: "sendFollowUp";
+    prompt: string;
+} | {
+    type: "openExternal";
+    url: string;
+} | {
+    type: "requestDisplayMode";
+    mode: string;
+};
+export interface TestViewHostProps {
+    /**
+     * Fake tools by name. A function gets the args (may be async; a throw or reject is a transport
+     * failure); a value with `structuredContent`/`content`/`isError` is returned as it is; any other
+     * value is wrapped as `{ structuredContent: v, content: [{ type: "text", text }] }`. A missing
+     * tool rejects with `[TestViewHost] no fake for tool "<name>"`.
+     */
+    tools?: Readonly<Record<string, unknown>>;
+    /** Every tool call, follow-up, link and display-mode request, in order. */
+    onHostAction?: (action: HostAction) => void;
+    /** Each mounted `HostModelContext` reports its content (last writer wins). */
+    onModelContext?: (text: string) => void;
+    /** Merged over `{ connected: true, displayMode: "inline", availableDisplayModes: [] }`. */
+    host?: Partial<ShellHost>;
+    hostWidgets?: HostWidgets;
+    /** Default: `createTestQueryClient()`, once per mount. */
+    client?: QueryClient;
+    /** Wraps a `LocaleProvider` only when given, so an outer one wins. */
+    locale?: string;
+    children: ReactNode;
+}
+/** The view's defaults without retries, so a failing fake fails at once. */
+export declare function createTestQueryClient(): QueryClient;
+export declare function TestViewHost({ tools, onHostAction, onModelContext, host, hostWidgets, client, locale, children, }: TestViewHostProps): import("react").JSX.Element;
+//# sourceMappingURL=test-view-host.d.ts.map

package/dist/ui/test-view-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-view-host.d.ts","sourceRoot":"","sources":["../../src/ui/test-view-host.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AACd,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAK7E,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAIhD,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhD,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACzC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAC3C,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,2FAA2F;IAC3F,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IACzB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,IAAI,WAAW,CAQnD;AAmDD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,YAAY,EACZ,cAAc,EACd,IAAI,EACJ,WAAW,EACX,MAAM,EACN,MAAM,EACN,QAAQ,GACT,EAAE,iBAAiB,+BAsBnB"}

package/dist/ui/test-view-host.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Renders a widget WITHOUT a host: fake tools, a log of what it asked the host to do and the
+ * model context it reported. It mounts the same host contexts as the mcp-use adapter
+ * (`HostContexts`: display mode, fullscreen switch, inline budget, view host), a query client,
+ * the host widgets, the icon stroke and toasts, so a widget test needs no `bootstrapView`. Not
+ * mounted: `HostDocument` (theme, fonts, the measured inline fit) and `LocaleGate` (pass
+ * `locale` instead).
+ */
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
+import { QueryClientProvider } from "@tanstack/react-query";
+import { LocaleProvider, ToastProvider, ICON_STROKE } from "@miragon/pulse-ui";
+import { LucideProvider } from "lucide-react";
+import { HostContexts } from "./host-contexts.js";
+import { HostWidgetsProvider } from "./host-widgets.js";
+import { createViewQueryClient } from "./tool-query.js";
+/** The view's defaults without retries, so a failing fake fails at once. */
+export function createTestQueryClient() {
+    const client = createViewQueryClient();
+    client.setDefaultOptions({
+        ...client.getDefaultOptions(),
+        queries: { ...client.getDefaultOptions().queries, retry: false },
+        mutations: { retry: false },
+    });
+    return client;
+}
+function isResult(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        ("structuredContent" in value || "content" in value || "isError" in value));
+}
+function toResult(value) {
+    if (isResult(value))
+        return value;
+    const text = typeof value === "string" ? value : JSON.stringify(value);
+    return { structuredContent: value, content: [{ type: "text", text: text ?? "" }] };
+}
+const NO_HOST = { connected: true, displayMode: "inline", availableDisplayModes: [] };
+const NO_WIDGETS = {};
+const ModelContextSinkContext = createContext(undefined);
+function FakeModelContext({ content, children }) {
+    const report = useContext(ModelContextSinkContext);
+    useEffect(() => {
+        report?.(content);
+    }, [report, content]);
+    return children;
+}
+function createFakeHost(tools = {}, record = () => undefined) {
+    return {
+        callTool: async (name, args = {}) => {
+            const callArgs = args;
+            record({ type: "callTool", name, args: callArgs });
+            if (!Object.hasOwn(tools, name))
+                throw new Error(`[TestViewHost] no fake for tool "${name}"`);
+            const fake = tools[name];
+            const value = typeof fake === "function" ? await fake(callArgs) : fake;
+            return toResult(value);
+        },
+        sendFollowUp: (prompt) => record({ type: "sendFollowUp", prompt }),
+        openExternal: (url) => record({ type: "openExternal", url }),
+        ModelContext: FakeModelContext,
+    };
+}
+export function TestViewHost({ tools, onHostAction, onModelContext, host, hostWidgets, client, locale, children, }) {
+    const fake = useMemo(() => createFakeHost(tools, onHostAction), [tools, onHostAction]);
+    const [ownClient] = useState(createTestQueryClient);
+    const shell = useMemo(() => ({ ...NO_HOST, ...host }), [host]);
+    const request = useCallback((mode) => onHostAction?.({ type: "requestDisplayMode", mode }), [onHostAction]);
+    const tree = (_jsx(ModelContextSinkContext.Provider, { value: onModelContext, children: _jsx(HostContexts, { shell: shell, host: fake, requestDisplayMode: request, children: _jsx(QueryClientProvider, { client: client ?? ownClient, children: _jsx(HostWidgetsProvider, { widgets: hostWidgets ?? NO_WIDGETS, children: _jsx(LucideProvider, { strokeWidth: ICON_STROKE, children: _jsx(ToastProvider, { children: children }) }) }) }) }) }));
+    return locale === undefined ? tree : _jsx(LocaleProvider, { locale: locale, children: tree });
+}
+//# sourceMappingURL=test-view-host.js.map

package/dist/ui/test-view-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-view-host.js","sourceRoot":"","sources":["../../src/ui/test-view-host.tsx"],"names":[],"mappings":"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"}

package/dist/ui/tool-query.d.ts

@@ -0,0 +1,41 @@
+import { QueryClient, type UseMutationResult, type UseQueryOptions, type UseQueryResult } from "@tanstack/react-query";
+export { useQueryClient, type QueryClient } from "@tanstack/react-query";
+/** Reads stay fresh for 30 s; TanStack's default retry (3) rides out a transient failure. */
+export declare function createViewQueryClient(): QueryClient;
+/** TanStack's query options; the key and the fetcher come from the tool and its args. */
+export type ToolQueryOptions<TData> = Omit<UseQueryOptions<TData, Error, TData>, "queryKey" | "queryFn">;
+/** Reads `tool` with `args`; the cache key is `[...key, args]`. An `isError` answer fails the query. */
+export declare function useToolQuery<TData>(key: readonly unknown[], tool: string, args: object, options?: ToolQueryOptions<TData>): UseQueryResult<TData, Error>;
+export interface ToolMutationOptions {
+    /** Query key prefixes to invalidate after a successful call (active readers refetch). */
+    invalidateKeys?: readonly (readonly unknown[])[];
+}
+/** Calls `tool` as a write; on success it invalidates `invalidateKeys` before resolving. */
+export declare function useToolMutation<TData = unknown, TArgs extends object = Record<string, unknown>>(tool: string, options?: ToolMutationOptions): UseMutationResult<TData, Error, TArgs>;
+export interface ViewDataOptions<T> {
+    /** An extra gate next to `ready`. */
+    enabled?: boolean;
+    placeholderData?: ToolQueryOptions<T>["placeholderData"];
+}
+export interface ViewDataResult<T> {
+    data: T | null;
+    /** No data yet and the feed is fetching: the first paint of a self-fetching widget. */
+    loading: boolean;
+    error: Error | null;
+    /** A new read at once, also while a failed fetch waits on its retry backoff. */
+    refetch: () => void;
+    failureCount: number;
+    /** Set from the first failed attempt, while the query still retries. */
+    failureReason: Error | null;
+    isFetching: boolean;
+    /** `data` is the previous args' answer while the current args' fetch runs or failed. */
+    isPlaceholderData: boolean;
+}
+/**
+ * One widget serves a standalone view and a self-fetching page. The show tool's data SEEDS the
+ * feed's cache entry, and the query stays live once `ready`: a write's invalidation, a retry or a
+ * refresh re-reads the feed. Embedded (no `initialData`) it fetches `tool` with `args` under `key`.
+ * A remounted old payload never rolls a refetched answer back; a new delivery replaces it.
+ */
+export declare function useViewData<T>(initialData: T | null | undefined, key: readonly unknown[], tool: string, args: object, ready: boolean, options?: ViewDataOptions<T>): ViewDataResult<T>;
+//# sourceMappingURL=tool-query.d.ts.map

package/dist/ui/tool-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-query.d.ts","sourceRoot":"","sources":["../../src/ui/tool-query.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,WAAW,EAIX,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAA;AAI9B,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExE,6FAA6F;AAC7F,wBAAgB,qBAAqB,IAAI,WAAW,CAInD;AAED,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,CAAC,KAAK,IAAI,IAAI,CACxC,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EACpC,UAAU,GAAG,SAAS,CACvB,CAAA;AAED,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,KAAK,EAChC,GAAG,EAAE,SAAS,OAAO,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAChC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAO9B;AAED,MAAM,WAAW,mBAAmB;IAClC,yFAAyF;IACzF,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAA;CACjD;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7F,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAWxC;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAA;CACzD;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,gFAAgF;IAChF,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,aAAa,EAAE,KAAK,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,OAAO,CAAA;IACnB,wFAAwF;IACxF,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,WAAW,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EACjC,GAAG,EAAE,SAAS,OAAO,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAC/B,cAAc,CAAC,CAAC,CAAC,CAmBnB"}