@miragon/pulse-widget-shell 0.24.1 → 0.25.0

package/dist/ui/use-detail-view.d.ts

@@ -1,41 +1,19 @@
 import type { ReactElement, ReactNode } from "react";
 /**
- * The dual-mode detail scaffold every detail widget repeats: the toolkit's
- * `useViewData` in seed mode (handed-in `initialData` as the seed standalone,
- * self-fetch of `tool` in the cockpit) plus the shell-wrapped
- * loading/error/empty guard ({@link ViewDataState}: a skeleton under a
- * polite status, the described error with its retry). `guard` is null once
- * data is present, so a widget body reduces to:
- *
- *   const { data, guard, notice } = useDetailView<XData>({ … })
- *   if (guard) return guard
- *   // render with non-null data, `notice` on top
- *
- * `notice` is the other half: a REFETCH that failed while data is shown (a
- * write's invalidation, a refresh) — the data may be stale, so the view says
- * so in an inline warning (`ErrorState`: what failed and why, the raw reason
- * under "Details", the retry); null otherwise. `refreshError` is the same
- * fact for the view's own decisions (e.g. offering no state-changing action
- * on a state it cannot confirm), from the refetch's first failed attempt
- * ({@link viewRefreshState}). `loadError` is the failure behind the guard
- * while no data is shown — a section on a composed page hides itself when it
- * says the feed's tool is not on this server (`classifyError(…).kind`).
+ * `notice` reports a failed REFETCH over shown data, which may be stale.
+ * `loadError` lets a section on a composed page hide itself when the feed's
+ * tool is not on this server.
  */
 export declare function useDetailView<TData>(opts: {
     initialData: TData | null | undefined;
-    /** Stable cache-key (e.g. ["camunda7:instance-detail", engine, id]). */
+    /** Stable cache-key (e.g. ["engine:instance-detail", engine, id]). */
     key: ReadonlyArray<unknown>;
     tool: string;
     args: Record<string, unknown>;
-    /** Gate the self-fetch until the required scope (id/key) is present. */
     ready: boolean;
-    /** What is missing when the load finished without data. */
     emptyText: string;
-    /** The loading status for screen readers (default: the active locale's "Loading view…"). */
     loadingText?: string;
-    /** Shown while loading, shaped like the result (default: a heading bar and a block). */
     skeleton?: ReactNode;
-    /** The retry label (default: the active locale's). */
     retryText?: string;
     /** Title of the stale-data notice (default: the active locale's "Couldn't refresh this view"). */
     refreshErrorTitle?: string;

package/dist/ui/use-detail-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-detail-view.d.ts","sourceRoot":"","sources":["../../src/ui/use-detail-view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAepD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE;IACzC,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IACrC,wEAAwE;IACxE,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAA;IACd,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kGAAkG;IAClG,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,GAAG;IACF,IAAI,EAAE,KAAK,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,YAAY,EAAE,KAAK,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;CACnB,CAqCA"}
+{"version":3,"file":"use-detail-view.d.ts","sourceRoot":"","sources":["../../src/ui/use-detail-view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AASpD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE;IACzC,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IACrC,sEAAsE;IACtE,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kGAAkG;IAClG,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,GAAG;IACF,IAAI,EAAE,KAAK,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,YAAY,EAAE,KAAK,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;CACnB,CAsCA"}

package/dist/ui/use-detail-view.js

@@ -1,43 +1,22 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { ErrorState, useLocale } from "@miragon/mcp-toolkit-ui";
-import { useViewData } from "@miragon/mcp-toolkit-ui/hooks";
+import { ErrorState, useLocale } from "@miragon/pulse-ui";
 import { describeError } from "./describe-error.js";
 import { kitLabels } from "./kit-labels.js";
+import { useViewData } from "./tool-query.js";
 import { viewRefreshState } from "./view-refresh-state.js";
 import { ViewDataState } from "./view-data-state.js";
 import { WidgetShell } from "./widget-shell.js";
 /**
- * The handed-in tool result SEEDS the feed query instead of switching it off,
- * so a write's invalidation, a Retry or a refresh re-reads a standalone view.
- */
-const SEED = { initialDataMode: "seed" };
-/**
- * The dual-mode detail scaffold every detail widget repeats: the toolkit's
- * `useViewData` in seed mode (handed-in `initialData` as the seed standalone,
- * self-fetch of `tool` in the cockpit) plus the shell-wrapped
- * loading/error/empty guard ({@link ViewDataState}: a skeleton under a
- * polite status, the described error with its retry). `guard` is null once
- * data is present, so a widget body reduces to:
- *
- *   const { data, guard, notice } = useDetailView<XData>({ … })
- *   if (guard) return guard
- *   // render with non-null data, `notice` on top
- *
- * `notice` is the other half: a REFETCH that failed while data is shown (a
- * write's invalidation, a refresh) — the data may be stale, so the view says
- * so in an inline warning (`ErrorState`: what failed and why, the raw reason
- * under "Details", the retry); null otherwise. `refreshError` is the same
- * fact for the view's own decisions (e.g. offering no state-changing action
- * on a state it cannot confirm), from the refetch's first failed attempt
- * ({@link viewRefreshState}). `loadError` is the failure behind the guard
- * while no data is shown — a section on a composed page hides itself when it
- * says the feed's tool is not on this server (`classifyError(…).kind`).
+ * `notice` reports a failed REFETCH over shown data, which may be stale.
+ * `loadError` lets a section on a composed page hide itself when the feed's
+ * tool is not on this server.
  */
 export function useDetailView(opts) {
     const locale = useLocale();
     const defaults = kitLabels(locale);
     const { initialData, key, tool, args, ready, emptyText, loadingText, skeleton, retryText } = opts;
-    const view = useViewData(initialData, key, tool, args, ready, SEED);
+    // The handed-in result SEEDS the feed: a write's invalidation or a Retry re-reads the view.
+    const view = useViewData(initialData, key, tool, args, ready);
     const { data, loading, error, refetch } = view;
     const retry = () => void refetch();
     const { refreshError } = viewRefreshState(view);

package/dist/ui/use-detail-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-detail-view.js","sourceRoot":"","sources":["../../src/ui/use-detail-view.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAA2B,MAAM,+BAA+B,CAAA;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;GAGG;AACH,MAAM,IAAI,GAAG,EAAE,eAAe,EAAE,MAAM,EAAiD,CAAA;AAEvF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAAQ,IAkBpC;IAOC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IACjG,MAAM,IAAI,GAAG,WAAW,CAAQ,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IAC1E,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9C,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAA;IAClC,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1B,KAAC,WAAW,cACV,KAAC,aAAa,IACZ,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,KAAK,EACd,UAAU,EAAE,SAAS,GACrB,GACU,CACf,CAAA;IACD,IAAI,MAAM,GAAwB,IAAI,CAAA;IACtC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QACrD,MAAM,GAAG,CACP,KAAC,UAAU,IACT,OAAO,EAAC,QAAQ,EAChB,IAAI,EAAC,SAAS,EACd,KAAK,EAAE,IAAI,CAAC,iBAAiB,IAAI,QAAQ,CAAC,aAAa,EACvD,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,YAAY,EAAE,EAC3D,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,EACvC,OAAO,EAAE,KAAK,EACd,UAAU,EAAE,SAAS,GACrB,CACH,CAAA;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAA;AACxF,CAAC"}
+{"version":3,"file":"use-detail-view.js","sourceRoot":"","sources":["../../src/ui/use-detail-view.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAQ,IAapC;IAOC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IACjG,4FAA4F;IAC5F,MAAM,IAAI,GAAG,WAAW,CAAQ,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IACpE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9C,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAA;IAClC,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1B,KAAC,WAAW,cACV,KAAC,aAAa,IACZ,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,KAAK,EACd,UAAU,EAAE,SAAS,GACrB,GACU,CACf,CAAA;IACD,IAAI,MAAM,GAAwB,IAAI,CAAA;IACtC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QACrD,MAAM,GAAG,CACP,KAAC,UAAU,IACT,OAAO,EAAC,QAAQ,EAChB,IAAI,EAAC,SAAS,EACd,KAAK,EAAE,IAAI,CAAC,iBAAiB,IAAI,QAAQ,CAAC,aAAa,EACvD,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,YAAY,EAAE,EAC3D,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,EACvC,OAAO,EAAE,KAAK,EACd,UAAU,EAAE,SAAS,GACrB,CACH,CAAA;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAA;AACxF,CAAC"}

package/dist/ui/use-paged-list-view.d.ts

@@ -1,46 +1,26 @@
 import { type PagedViewData } from "./use-paged-view-data.js";
 export interface PagedListView<TItem, TData> {
     paged: PagedViewData<TItem, TData>;
-    /** Raw (undebounced) search input value — bind to the FilterBar. */
     search: string;
     setSearch: (next: string) => void;
-    /** The debounced, trimmed value the feed was actually queried with. */
     debouncedSearch: string;
-    /**
-     * True when the rows on screen are a searched or filtered result (the
-     * handed-in page 0 is dropped, the list is server-filtered). Drives "no
-     * match" empty states, so it describes the rows SHOWN: while a new page 0
-     * is in flight or has failed (`paged.stale`) it stays the previous
-     * result's — an empty unfiltered list never reads "no match" for a search
-     * that has not answered.
-     */
+    /** Stays the previous result's while `paged.stale`: no "no match" for a search that has not answered. */
     interacted: boolean;
 }
 /**
- * The paged-list scaffold on top of {@link usePagedViewData}: owns the search
- * box state, its 300 ms debounce, the server-side search arg, and the
- * "once the operator interacts, drop the handed-in page and self-fetch the
- * server-filtered set" rule — the block every searchable list used to repeat.
- *
- * The search is SERVER-side by design: `searchArg` becomes a feed query param,
- * so it covers the whole result set, not just the loaded page. Any change
- * resets pagination to page 0 (via the underlying hook's args identity).
+ * Search box, 300 ms debounce and the server-side search arg; the search is a
+ * feed param so it covers the whole result set, not the loaded page.
  */
 export declare function usePagedListView<TItem, TData>(opts: {
     initialData: TData | null | undefined;
-    /** Stable cache-key prefix (e.g. ["camunda7:process-instances", engine]). */
     key: ReadonlyArray<unknown>;
     tool: string;
-    /** Filter args WITHOUT the search value; changing these resets paging. */
     args: Record<string, unknown>;
-    /** Feed arg carrying the debounced search value (e.g. "businessKeyLike").
-     *  Omit for lists without a search box. */
+    /** Omit for lists without a search box. */
     searchArg?: string;
-    /** Additional non-search filters (e.g. chips) that must also drop the
-     *  handed-in unfiltered page 0. */
+    /** Non-search filters that must also drop the handed-in unfiltered page 0. */
     filtersActive?: boolean;
     pageSize: number;
-    /** Gate the self-fetch until the required scope is present. */
     ready: boolean;
     selectItems: (data: TData) => TItem[];
     selectTotal: (data: TData) => number;

package/dist/ui/use-paged-list-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-paged-list-view.d.ts","sourceRoot":"","sources":["../../src/ui/use-paged-list-view.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE/E,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,KAAK;IACzC,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAClC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAA;IACvB;;;;;;;OAOG;IACH,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;IACnD,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IACrC,6EAA6E;IAC7E,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B;+CAC2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;uCACmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,EAAE,CAAA;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAA;CACrC,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAyC9B"}
+{"version":3,"file":"use-paged-list-view.d.ts","sourceRoot":"","sources":["../../src/ui/use-paged-list-view.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE/E,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,KAAK;IACzC,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,eAAe,EAAE,MAAM,CAAA;IACvB,yGAAyG;IACzG,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;IACnD,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IACrC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,EAAE,CAAA;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAA;CACrC,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAsC9B"}

package/dist/ui/use-paged-list-view.js

@@ -1,15 +1,9 @@
 import { useState } from "react";
-import { useDebouncedValue } from "@miragon/mcp-toolkit-ui";
+import { useDebouncedValue } from "@miragon/pulse-ui";
 import { usePagedViewData } from "./use-paged-view-data.js";
 /**
- * The paged-list scaffold on top of {@link usePagedViewData}: owns the search
- * box state, its 300 ms debounce, the server-side search arg, and the
- * "once the operator interacts, drop the handed-in page and self-fetch the
- * server-filtered set" rule — the block every searchable list used to repeat.
- *
- * The search is SERVER-side by design: `searchArg` becomes a feed query param,
- * so it covers the whole result set, not just the loaded page. Any change
- * resets pagination to page 0 (via the underlying hook's args identity).
+ * Search box, 300 ms debounce and the server-side search arg; the search is a
+ * feed param so it covers the whole result set, not the loaded page.
  */
 export function usePagedListView(opts) {
     const { initialData, key, tool, args, searchArg, filtersActive = false, pageSize, ready, selectItems, selectTotal, } = opts;
@@ -18,8 +12,7 @@ export function usePagedListView(opts) {
     const requested = debouncedSearch !== "" || filtersActive;
     const effectiveArgs = searchArg && debouncedSearch !== "" ? { ...args, [searchArg]: debouncedSearch } : args;
     const paged = usePagedViewData({
-        // Standalone data is only the unfiltered first page — a filtered view must
-        // come from the feed.
+        // Standalone data is only the unfiltered first page.
         initialData: requested ? null : initialData,
         key,
         tool,
@@ -29,9 +22,7 @@ export function usePagedListView(opts) {
         selectItems,
         selectTotal,
     });
-    // The rows on screen answer the last SETTLED request: its value is recorded
-    // whenever the shown page is the current one (render-phase state, replay
-    // safe) and kept while the previous result stays on screen.
+    // The rows on screen answer the last SETTLED request.
     const [shownRequested, setShownRequested] = useState(requested);
     if (!paged.stale && shownRequested !== requested)
         setShownRequested(requested);

package/dist/ui/use-paged-list-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-paged-list-view.js","sourceRoot":"","sources":["../../src/ui/use-paged-list-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAsB,MAAM,0BAA0B,CAAA;AAoB/E;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAe,IAkB9C;IACC,MAAM,EACJ,WAAW,EACX,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,aAAa,GAAG,KAAK,EACrB,QAAQ,EACR,KAAK,EACL,WAAW,EACX,WAAW,GACZ,GAAG,IAAI,CAAA;IACR,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;IACxC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;IAE7D,MAAM,SAAS,GAAG,eAAe,KAAK,EAAE,IAAI,aAAa,CAAA;IACzD,MAAM,aAAa,GACjB,SAAS,IAAI,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAExF,MAAM,KAAK,GAAG,gBAAgB,CAAe;QAC3C,2EAA2E;QAC3E,sBAAsB;QACtB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW;QAC3C,GAAG;QACH,IAAI;QACJ,IAAI,EAAE,aAAa;QACnB,QAAQ;QACR,KAAK;QACL,WAAW;QACX,WAAW;KACZ,CAAC,CAAA;IAEF,4EAA4E;IAC5E,yEAAyE;IACzE,4DAA4D;IAC5D,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC/D,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc,KAAK,SAAS;QAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IAC9E,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAA;IAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,CAAA;AAClE,CAAC"}
+{"version":3,"file":"use-paged-list-view.js","sourceRoot":"","sources":["../../src/ui/use-paged-list-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAsB,MAAM,0BAA0B,CAAA;AAW/E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAe,IAa9C;IACC,MAAM,EACJ,WAAW,EACX,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,aAAa,GAAG,KAAK,EACrB,QAAQ,EACR,KAAK,EACL,WAAW,EACX,WAAW,GACZ,GAAG,IAAI,CAAA;IACR,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;IACxC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;IAE7D,MAAM,SAAS,GAAG,eAAe,KAAK,EAAE,IAAI,aAAa,CAAA;IACzD,MAAM,aAAa,GACjB,SAAS,IAAI,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAExF,MAAM,KAAK,GAAG,gBAAgB,CAAe;QAC3C,qDAAqD;QACrD,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW;QAC3C,GAAG;QACH,IAAI;QACJ,IAAI,EAAE,aAAa;QACnB,QAAQ;QACR,KAAK;QACL,WAAW;QACX,WAAW;KACZ,CAAC,CAAA;IAEF,sDAAsD;IACtD,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC/D,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,cAAc,KAAK,SAAS;QAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IAC9E,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAA;IAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,CAAA;AAClE,CAAC"}

package/dist/ui/use-paged-view-data.d.ts

@@ -1,101 +1,46 @@
 import { type InlineRows } from "./inline-fit.js";
 export interface PagedViewData<TItem, TData = unknown> {
-    /**
-     * The rows to show: every loaded page — inline under a host, at most as
-     * many as fit the view's height budget (the measured fit, #396); `hasMore`
-     * then says there are more and `loadMore` shows them (fullscreen where the
-     * host offers it, else the next rows in place). The footer's "Showing X of
-     * Y" counts what is shown.
-     */
+    /** Inline under a host, at most the rows that fit the height budget (#396). */
     items: TItem[];
-    /**
-     * The page-0 payload (handed-in or self-fetched) for reading list metadata.
-     * While a NEW page 0 is in flight (or has failed), the previous result of
-     * the same list stays here — never null mid-search; {@link stale} says so.
-     */
+    /** While a new page 0 is in flight or failed, the previous result stays ({@link stale}). */
     firstPage: TData | null;
-    /**
-     * Server-reported total of {@link firstPage} (drives "X of Y" + hasMore) —
-     * while {@link stale}, the PREVIOUS result's, not the current filter's.
-     */
     total: number;
     /**
-     * {@link firstPage} — and with it `items` and `total` — is the PREVIOUS
-     * result of this list, not the current args' page 0: a changed search or
-     * filter is still in flight, or has failed. Whatever the list says about
-     * its rows (a header count, the filters it covers, a model context, an
-     * empty-state text) must then describe that previous result — read it from
-     * the payload on screen, never from the request that has not answered.
-     * (A same-filter refetch is not stale: its last good page is still the
-     * current filter's.)
+     * The rows on screen are the PREVIOUS filter's result: anything said about
+     * them must read the payload on screen, never the request.
      */
     stale: boolean;
     hasMore: boolean;
     loadMore: () => void;
-    /** First page is still loading (self-fetch, nothing to show yet). */
     loading: boolean;
     /** A page 0 is in flight while rows are on screen (a changed filter, a refetch). */
     refreshing: boolean;
-    /** A subsequent page is in flight. */
     loadingMore: boolean;
     /**
-     * The PAGE-0 failure. Without a `firstPage` it is the load error the
-     * caller's guard renders (once the client's retries ran out). With one, the
-     * rows on screen are unconfirmed — the previous filter's ({@link stale}), or
-     * the last good answer of a failed refetch — and it is set from the fetch's
-     * FIRST failed attempt (the toolkit's `failureReason`), like
-     * `viewRefreshState`'s `refreshError`: the same for a refetch of this
-     * filter's page (a write's invalidation, a Retry) and for a changed search
-     * or filter, so the list never presents the rows as current for the length
-     * of the backoff. {@link retry} re-runs page 0.
+     * The page-0 failure. Over rows on screen it is set from the FIRST failed
+     * attempt, so the list never presents them as current through the backoff.
      */
     error: Error | null;
-    /**
-     * Re-runs the page-0 fetch: the retry for {@link error}. A new read at
-     * once — also while the client still waits on that fetch's retry backoff
-     * (which `error` already reports), never a wait for the running chain (the
-     * toolkit's `useViewData` refetch cancels it first).
-     */
+    /** A new read at once, also during the client's retry backoff. */
     retry: () => void;
-    /** The last load-more failure — `loadMore` retries it; the rows above are current. */
     loadMoreError: Error | null;
-    /**
-     * The list's place in the inline fit: `PagedRows` hands it to the table
-     * inside, or a list of its own rows (an `<ol>`) passes `fit.attachRows` to
-     * the element whose children are the rows.
-     */
     fit: InlineRows;
-    /**
-     * Words for the toolkit's `PagedListFooter` (`labels`): while `loadMore`
-     * opens fullscreen, its button says "Show all", not "Load more".
-     */
+    /** While `loadMore` opens fullscreen, its button says "Show all". */
     footerLabels: {
         loadMore: string;
     } | undefined;
 }
 /**
- * Offset-paginated sibling of the toolkit's `useViewData`: one component, both
- * modes, plus "Load more". Page 0 is the feed query in the toolkit's
- * `initialDataMode: "seed"`, seeded with `initialData` (standalone, handed in)
- * or self-fetched (cockpit), so a write's invalidation refetches a standalone
- * list too; `loadMore()` fetches the next offset and appends. Changing `args`
- * (e.g. a server-side search/filter) resets pagination to page 0 while the
- * previous rows of the same list stay on screen (`stale`). The feed must
- * accept `firstResult`/`maxResults` and return the full filtered `total` so
- * the footer is honest and `hasMore` is correct.
- *
- * Deliberately explicit (button-driven), not infinite scroll — see the
- * toolkit's `ListFooter`.
+ * Offset-paginated sibling of `useViewData`; page 0 is seeded so
+ * a write's invalidation refetches a standalone list too. The feed must return
+ * the full filtered `total`. Button-driven, not infinite scroll.
  */
 export declare function usePagedViewData<TItem, TData>(opts: {
     initialData: TData | null | undefined;
-    /** Stable cache-key prefix (e.g. ["camunda7:process-instances", engine, key]). */
     key: ReadonlyArray<unknown>;
     tool: string;
-    /** Filter args (without firstResult/maxResults); changing these resets paging. */
     args: Record<string, unknown>;
     pageSize: number;
-    /** Gate the self-fetch until the required scope is present. */
     ready: boolean;
     selectItems: (data: TData) => TItem[];
     selectTotal: (data: TData) => number;

package/dist/ui/use-paged-view-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-paged-view-data.d.ts","sourceRoot":"","sources":["../../src/ui/use-paged-view-data.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAsBhE,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IACnD;;;;;;OAMG;IACH,KAAK,EAAE,KAAK,EAAE,CAAA;IACd;;;;OAIG;IACH,SAAS,EAAE,KAAK,GAAG,IAAI,CAAA;IACvB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;;OASG;IACH,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAA;IAChB,oFAAoF;IACpF,UAAU,EAAE,OAAO,CAAA;IACnB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAA;IACpB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,sFAAsF;IACtF,aAAa,EAAE,KAAK,GAAG,IAAI,CAAA;IAC3B;;;;OAIG;IACH,GAAG,EAAE,UAAU,CAAA;IACf;;;OAGG;IACH,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC/C;AA6CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;IACnD,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IACrC,kFAAkF;IAClF,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,EAAE,CAAA;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAA;CACrC,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAmG9B"}
+{"version":3,"file":"use-paged-view-data.d.ts","sourceRoot":"","sources":["../../src/ui/use-paged-view-data.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAiBhE,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IACnD,+EAA+E;IAC/E,KAAK,EAAE,KAAK,EAAE,CAAA;IACd,4FAA4F;IAC5F,SAAS,EAAE,KAAK,GAAG,IAAI,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,oFAAoF;IACpF,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB;;;OAGG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,kEAAkE;IAClE,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,aAAa,EAAE,KAAK,GAAG,IAAI,CAAA;IAC3B,GAAG,EAAE,UAAU,CAAA;IACf,qEAAqE;IACrE,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC/C;AAoCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;IACnD,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IACrC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,EAAE,CAAA;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAA;CACrC,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CA0F9B"}

package/dist/ui/use-paged-view-data.js

@@ -1,17 +1,15 @@
 import { useCallback, useMemo, useState } from "react";
-import { parseToolResult, useCallTool, useLocale } from "@miragon/mcp-toolkit-ui";
-import { useViewData } from "@miragon/mcp-toolkit-ui/hooks";
+import { useLocale } from "@miragon/pulse-ui";
+import { decodeToolResult } from "../protocol/tool-result.js";
 import { useInlineBudget } from "./inline-budget.js";
 import { useInlineRows } from "./inline-fit.js";
 import { kitLabels } from "./kit-labels.js";
+import { useViewData } from "./tool-query.js";
+import { useViewHost } from "./view-host.js";
 /**
- * Keep-previous-data for page 0, TanStack's own: a changed search or filter
- * keys a new page 0 whose data is undefined until it lands (a seed is only
- * ever the unfiltered page 0), so without a placeholder the caller's loading
- * guard would unmount the list — and the search box the operator is typing
- * into — for every round-trip. The placeholder is the previous answer of the
- * SAME list only (`scope`, the cache-key prefix): another engine or definition
- * never shows the previous list's rows. `isPlaceholderData` is then `stale`.
+ * Keep-previous-data for page 0: without it the loading guard would unmount
+ * the list and its search box on every round-trip. Same list (`scope`) only,
+ * so another engine never shows the previous list's rows.
  */
 function useSameListPlaceholder(key) {
     const scope = JSON.stringify(key);
@@ -22,13 +20,8 @@ function useSameListPlaceholder(key) {
     return { scope, placeholderData: placeholderData };
 }
 /**
- * The page on screen once a changed search's page 0 FAILED for good. TanStack
- * shows a placeholder only while the query is pending and drops it when the
- * retries ran out, but the failure line over the list says "you're seeing the
- * previous result" (the toolkit's `PagedListFooter`), so those rows must stay:
- * the page last shown for this list (render-phase state, replay-safe) bridges
- * that failure until the list's next answer. In flight it is TanStack's
- * placeholder, never this.
+ * TanStack drops a placeholder once retries ran out, but the failure line says
+ * "you're seeing the previous result", so the last shown page bridges it.
  */
 function useShownPage(data, scope, failed) {
     const [shown, setShown] = useState(null);
@@ -39,28 +32,17 @@ function useShownPage(data, scope, failed) {
     return failed && shown?.scope === scope ? shown.data : null;
 }
 /**
- * Offset-paginated sibling of the toolkit's `useViewData`: one component, both
- * modes, plus "Load more". Page 0 is the feed query in the toolkit's
- * `initialDataMode: "seed"`, seeded with `initialData` (standalone, handed in)
- * or self-fetched (cockpit), so a write's invalidation refetches a standalone
- * list too; `loadMore()` fetches the next offset and appends. Changing `args`
- * (e.g. a server-side search/filter) resets pagination to page 0 while the
- * previous rows of the same list stay on screen (`stale`). The feed must
- * accept `firstResult`/`maxResults` and return the full filtered `total` so
- * the footer is honest and `hasMore` is correct.
- *
- * Deliberately explicit (button-driven), not infinite scroll — see the
- * toolkit's `ListFooter`.
+ * Offset-paginated sibling of `useViewData`; page 0 is seeded so
+ * a write's invalidation refetches a standalone list too. The feed must return
+ * the full filtered `total`. Button-driven, not infinite scroll.
  */
 export function usePagedViewData(opts) {
     const { initialData, key, tool, args, pageSize, ready, selectItems, selectTotal } = opts;
-    const callTool = useCallTool();
+    const { callTool } = useViewHost();
     const argsKey = JSON.stringify(args);
     const { scope, placeholderData } = useSameListPlaceholder(key);
-    const page0 = useViewData(initialData, [...key, argsKey, "page0"], tool, { ...args, firstResult: 0, maxResults: pageSize }, ready, { initialDataMode: "seed", placeholderData });
-    // `fetched` is THIS filter's page 0 (the seed until the feed answered);
-    // `first` is the page on screen — the previous one of this list while the
-    // new one is in flight (the placeholder) or has failed (the bridge).
+    const page0 = useViewData(initialData, [...key, argsKey, "page0"], tool, { ...args, firstResult: 0, maxResults: pageSize }, ready, { placeholderData });
+    // `fetched` is THIS filter's page 0; `first` is the page on screen.
     const fetched = page0.isPlaceholderData ? null : page0.data;
     const first = useShownPage(page0.data, scope, page0.error !== null);
     const stale = !fetched && !!first;
@@ -71,13 +53,7 @@ export function usePagedViewData(opts) {
         error: null,
     });
     const [loadingMore, setLoadingMore] = useState(false);
-    // Render-phase reset: when the filter identity or the PAGE-0 identity
-    // changes, drop accumulated pages synchronously so we never show stale rows
-    // under a new page-0 result. Page-0 identity covers both a changed
-    // `initialData` and a page-0 REFETCH (e.g. a mutation invalidated the
-    // cache): after a refetch the rows have shifted, so keeping the appended
-    // pages would duplicate or skip rows — collapsing back to one page is the
-    // consistent behavior.
+    // A page-0 refetch shifts rows, so appended pages would duplicate or skip: drop them.
     const [prevReset, setPrevReset] = useState(argsKey);
     const [prevFirst, setPrevFirst] = useState(first);
     if (argsKey !== prevReset || first !== prevFirst) {
@@ -92,13 +68,13 @@ export function usePagedViewData(opts) {
     const hasMore = !stale && !pages.exhausted && items.length < total;
     const gen = pages.gen;
     const fetchNext = useCallback(() => {
-        if (!fetched || loadingMore || !callTool)
+        if (!fetched || loadingMore)
             return;
         setLoadingMore(true);
         setPages((prev) => (prev.gen === gen ? { ...prev, error: null } : prev));
         void callTool(tool, { ...args, firstResult: items.length, maxResults: pageSize })
             .then((res) => {
-            const data = parseToolResult(res);
+            const data = decodeToolResult(res);
             const pageItems = selectItems(data);
             setPages((prev) => prev.gen === gen
                 ? {
@@ -128,25 +104,17 @@ export function usePagedViewData(opts) {
         loading: !first && ready && page0.error === null,
         refreshing: !!first && page0.isFetching,
         loadingMore,
-        // Over rows on screen, a fetch's first failed attempt already unconfirms
-        // them; without rows, the guard keeps loading through the retries.
+        // Over rows on screen the first failed attempt unconfirms them; without rows the guard waits out retries.
         error: page0.error ?? (first ? page0.failureReason : null),
         retry: page0.refetch,
         loadMoreError: pages.error,
     };
 }
-/**
- * Inline in a chat, the head of a list's rows (#396): as many as fit the
- * view's height budget (`useInlineRows`, measured). More is fullscreen where
- * the host offers it; elsewhere the next rows in place, a fetched page with
- * the click that loaded it. A new search or filter (`resetKey`) starts at the
- * head again. Without a fit (fullscreen, no host) every row.
- */
+/** Inline, the rows that fit the budget (#396); more is fullscreen, else the next rows in place. */
 function useInlineHead(opts) {
     const { items, hasMore, fetchNext, pageSize, resetKey } = opts;
     const { expand } = useInlineBudget();
     const labels = kitLabels(useLocale());
-    // A page that lands (the answer to a search, a refetch) refits on its own rows.
     const fit = useInlineRows(items.length, { resetKey, contentKey: items });
     const { cap, step, reveal } = fit;
     const capped = cap !== null && items.length > cap;
@@ -157,7 +125,6 @@ function useInlineHead(opts) {
             return expand?.();
         if (capped)
             return reveal(step);
-        // Every loaded row shows: fetch the next page and show it with this click.
         if (cap !== null)
             reveal(items.length + pageSize - cap);
         fetchNext();

package/dist/ui/use-paged-view-data.js.map

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

package/dist/ui/view-call.d.ts

@@ -0,0 +1,66 @@
+/** The rendering call's lifecycle as plain logic: what the frame shows, and when it re-runs. */
+import type { ModelContextSpec } from "./ask-ai-prompt.js";
+import type { CallObservation } from "./call-observer.js";
+export type ViewPhase = {
+    phase: "waiting";
+}
+/** `reloadedAt`: the view re-ran its tool itself, so the figures can differ from the chat's. */
+ | {
+    phase: "ready";
+    data: object;
+    reloadedAt: number | null;
+} | {
+    phase: "error";
+    error: Error;
+} | {
+    phase: "cancelled";
+};
+export interface ViewCall {
+    phase: ViewPhase;
+    /** The user's retry on the error state: one call of the view's show tool. */
+    retry: () => void;
+}
+/** The view's own call of its show tool: a stripped-result recovery or the user's retry. */
+export type Rerun = {
+    state: "idle";
+} | {
+    state: "running";
+} | {
+    state: "done";
+    data: object;
+    at: number;
+    recovered: boolean;
+} | {
+    state: "failed";
+    error: Error;
+};
+export interface ViewCallInputs {
+    /** mcp-use's latch (`useToolContext().status`). */
+    status: "pending" | "ready" | "error";
+    output: unknown;
+    error: Error | undefined;
+    cancelled: boolean;
+    observation: CallObservation;
+    rerun: Rerun;
+}
+/** What a view renders: a non-null, non-array object (`buildViewResult`'s data). */
+export declare function isViewData(value: unknown): value is object;
+/**
+ * In order: the view's own successful re-run; the host's renderable result; a cancel; a re-run in
+ * flight (waiting, so a retry is never clicked twice); its failure; the call's own error; a
+ * stripped or unrenderable result (`recover`: re-run once); else still waiting. A slow tool, an
+ * `isError` or a cancel is never re-run on its own: re-running a failure only repeats it. The
+ * re-run checks no annotations, because every view-bound tool is a read (a server pins that, as
+ * the Pulse app's `view-registry.test.ts` does).
+ */
+export declare function resolveViewCall(inputs: ViewCallInputs): {
+    phase: ViewPhase;
+    recover: boolean;
+};
+/**
+ * The frame's own model line (read by the model, never shown, so English): an error or cancel
+ * the user sees instead of the view, or figures the view re-loaded itself. `null` while waiting
+ * and for a plain host-delivered view.
+ */
+export declare function viewCallContext(phase: ViewPhase): ModelContextSpec | null;
+//# sourceMappingURL=view-call.d.ts.map

package/dist/ui/view-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-call.d.ts","sourceRoot":"","sources":["../../src/ui/view-call.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,MAAM,SAAS,GACjB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE;AACtB,gGAAgG;GAC9F;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAAA;AAE1B,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,CAAA;IAChB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,4FAA4F;AAC5F,MAAM,MAAM,KAAK,GACb;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAErC,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IACrC,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,eAAe,CAAA;IAC5B,KAAK,EAAE,KAAK,CAAA;CACb;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE1D;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAmB9F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAuBzE"}