@miragon/pulse-widget-shell 0.0.0-stage → 0.22.0

package/dist/ui/use-bpmn-viewer.test.js.map

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

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

@@ -0,0 +1,49 @@
+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`).
+ */
+export declare function useDetailView<TData>(opts: {
+    initialData: TData | null | undefined;
+    /** Stable cache-key (e.g. ["camunda7: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;
+}): {
+    data: TData | null;
+    guard: ReactElement | null;
+    notice: ReactElement | null;
+    refreshError: Error | null;
+    loadError: unknown;
+};
+//# sourceMappingURL=use-detail-view.d.ts.map

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

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

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

@@ -0,0 +1,52 @@
+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 { describeError } from "./describe-error.js";
+import { kitLabels } from "./kit-labels.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`).
+ */
+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);
+    const { data, loading, error, refetch } = view;
+    const retry = () => void refetch();
+    const { refreshError } = viewRefreshState(view);
+    const guard = data ? null : (_jsx(WidgetShell, { children: _jsx(ViewDataState, { loading: loading, error: error, loadingText: loadingText, skeleton: skeleton, emptyText: emptyText, onRetry: retry, retryLabel: retryText }) }));
+    let notice = null;
+    if (refreshError) {
+        const described = describeError(refreshError, locale);
+        notice = (_jsx(ErrorState, { variant: "inline", tone: "warning", title: opts.refreshErrorTitle ?? defaults.refreshFailed, description: `${described.title}. ${defaults.refreshStale}`, details: described.details ?? undefined, onRetry: retry, retryLabel: retryText }));
+    }
+    return { data, guard, notice, refreshError, loadError: data ? null : (error ?? null) };
+}
+//# sourceMappingURL=use-detail-view.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-detail-view.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-detail-view.test.d.ts","sourceRoot":"","sources":["../../src/ui/use-detail-view.test.tsx"],"names":[],"mappings":""}

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

@@ -0,0 +1,178 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { act, cleanup, fireEvent, render, renderHook, screen, waitFor, } from "@testing-library/react";
+import { AppQueryProvider, LocaleProvider, queryClient } from "@miragon/mcp-toolkit-ui";
+import { useViewData } from "@miragon/mcp-toolkit-ui/hooks";
+import { useDetailView } from "./use-detail-view.js";
+import { viewRefreshState } from "./view-refresh-state.js";
+const callTool = vi.fn();
+const answer = (name) => ({ structuredContent: { name } });
+function wrapper({ children }) {
+    return _jsx(AppQueryProvider, { callTool: callTool, children: children });
+}
+const toolkitDefaults = queryClient.getDefaultOptions();
+beforeEach(() => {
+    callTool.mockReset();
+    queryClient.setDefaultOptions({
+        ...toolkitDefaults,
+        queries: { ...toolkitDefaults.queries, retry: false },
+    });
+});
+afterEach(() => {
+    cleanup();
+    queryClient.clear();
+    queryClient.setDefaultOptions(toolkitDefaults);
+});
+const invalidate = () => act(() => queryClient.invalidateQueries({ queryKey: ["test:detail"] }));
+/**
+ * A seeded view (the toolkit's `useViewData` in seed mode, which replaced the
+ * kit's own hook in 2.8) and the kit's rule over its refresh state
+ * (`viewRefreshState`): what `useDetailView` and the engine overview read.
+ */
+describe("useViewData in seed mode + viewRefreshState", () => {
+    function setup(seed, ready = true) {
+        return renderHook(() => {
+            const view = useViewData(seed, ["test:detail", "x"], "test_detail_data", { id: "x" }, ready, { initialDataMode: "seed" });
+            return { ...view, ...viewRefreshState(view) };
+        }, { wrapper });
+    }
+    it("loads while a ready view has nothing to show yet", async () => {
+        callTool.mockResolvedValue(answer("fetched"));
+        const { result } = setup(null);
+        expect(result.current.loading).toBe(true);
+        await waitFor(() => expect(result.current.data).toEqual({ name: "fetched" }));
+        expect(result.current.loading).toBe(false);
+    });
+    it("is neither loading nor fetching before the scope is ready", () => {
+        const { result } = setup(null, false);
+        expect(result.current.loading).toBe(false);
+        expect(callTool).not.toHaveBeenCalled();
+    });
+    it("reports a failed first load as error, not as a refresh error", async () => {
+        callTool.mockRejectedValue(new Error("boom"));
+        const { result } = setup(null);
+        await waitFor(() => expect(result.current.error?.message).toBe("boom"));
+        expect(result.current.loading).toBe(false);
+        expect(result.current.refreshError).toBeNull();
+    });
+    it("flags a refetch in flight and a failed refetch next to the shown seed", async () => {
+        let fail;
+        callTool.mockReturnValue(new Promise((_, reject) => (fail = reject)));
+        const { result } = setup({ name: "seed" });
+        expect(result.current.refreshing).toBe(false);
+        // Not awaited (the refetch hangs until `fail`), so not inside act either:
+        // an open act scope would swallow the next test's updates.
+        void queryClient.invalidateQueries({ queryKey: ["test:detail"] });
+        await waitFor(() => expect(result.current.refreshing).toBe(true));
+        act(() => fail(new Error("gone")));
+        await waitFor(() => expect(result.current.refreshError?.message).toBe("gone"));
+        expect(result.current.data).toEqual({ name: "seed" });
+        expect(result.current.refreshing).toBe(false);
+    });
+    it("reports a failed refetch from its FIRST attempt — not after the client's retries", async () => {
+        // The toolkit's production defaults: TanStack retries a failed query 3×
+        // with 1 s/2 s/4 s backoff, and `error` stays null all that time. A view
+        // that gates writes on `refreshError` would keep offering them on a state
+        // it cannot confirm for ~7 s (an instance that just ended).
+        queryClient.setDefaultOptions(toolkitDefaults);
+        callTool.mockRejectedValue(new Error("gone"));
+        const { result } = setup({ name: "seed" });
+        void queryClient.invalidateQueries({ queryKey: ["test:detail"] });
+        await waitFor(() => expect(result.current.refreshError?.message).toBe("gone"));
+        // Still retrying: one attempt so far, the refetch in flight.
+        expect(callTool).toHaveBeenCalledTimes(1);
+        expect(result.current.refreshing).toBe(true);
+        expect(result.current.data).toEqual({ name: "seed" });
+    });
+});
+function Detail({ seed }) {
+    const { data, guard, notice, refreshError } = useDetailView({
+        initialData: seed,
+        key: ["test:detail", "x"],
+        tool: "test_detail_data",
+        args: { id: "x" },
+        ready: true,
+        loadingText: "Loading…",
+        emptyText: "Nothing",
+        retryText: "Retry now",
+        refreshErrorTitle: "Stale",
+    });
+    if (!data)
+        return guard;
+    return (_jsxs("div", { children: [notice, _jsx("p", { children: data.name }), !refreshError && _jsx("button", { type: "button", children: "Act" })] }));
+}
+describe("useDetailView", () => {
+    it("hands out the failed first load, so a section can hide when its tool is missing", async () => {
+        callTool.mockRejectedValueOnce(new Error("Tool test_detail_data not found"));
+        const { result } = renderHook(() => useDetailView({
+            initialData: null,
+            key: ["test:detail", "missing"],
+            tool: "test_detail_data",
+            args: {},
+            ready: true,
+            emptyText: "Nothing",
+        }), { wrapper });
+        await waitFor(() => expect(result.current.loadError).toBeInstanceOf(Error));
+        expect(String(result.current.loadError)).toContain("not found");
+    });
+    it("offers a Retry on a failed load — never a dead end", async () => {
+        callTool.mockRejectedValueOnce(new Error("[503 ProcessEngineException] down (engine prod)"));
+        render(_jsx(Detail, { seed: null }), { wrapper });
+        // The error in words; the raw text only under "Details".
+        expect(await screen.findByRole("heading", { name: "Engine prod is unreachable (HTTP 503)" })).toBeTruthy();
+        expect(screen.getByText("[503 ProcessEngineException] down (engine prod)").closest("details")).toBeTruthy();
+        callTool.mockResolvedValueOnce(answer("loaded"));
+        fireEvent.click(screen.getByRole("button", { name: "Retry now" }));
+        expect(await screen.findByText("loaded")).toBeTruthy();
+    });
+    it("says so when a refetch fails over shown data, and retries from the notice", async () => {
+        callTool.mockRejectedValueOnce(new Error("instance gone"));
+        render(_jsx(Detail, { seed: { name: "seed" } }), { wrapper });
+        expect(screen.getByRole("button", { name: "Act" })).toBeTruthy();
+        expect(screen.queryByRole("alert")).toBeNull();
+        await invalidate();
+        const notice = await screen.findByRole("alert");
+        expect(notice.getAttribute("data-tone")).toBe("warning");
+        expect(notice.getAttribute("data-variant")).toBe("inline");
+        expect(notice.textContent).toContain("Stale");
+        expect(notice.textContent).toContain("Something went wrong. You're seeing the last loaded state.");
+        expect(screen.getByText("instance gone").closest("details")).toBeTruthy();
+        expect(screen.getByText("seed")).toBeTruthy();
+        expect(screen.queryByRole("button", { name: "Act" })).toBeNull();
+        callTool.mockResolvedValueOnce(answer("fresh"));
+        fireEvent.click(screen.getByRole("button", { name: "Retry now" }));
+        expect(await screen.findByText("fresh")).toBeTruthy();
+        expect(screen.queryByRole("alert")).toBeNull();
+        expect(screen.getByRole("button", { name: "Act" })).toBeTruthy();
+    });
+    function Bare() {
+        const { data, guard, notice } = useDetailView({
+            initialData: { name: "seed" },
+            key: ["test:detail", "bare"],
+            tool: "test_detail_data",
+            args: {},
+            ready: true,
+            loadingText: "Loading…",
+            emptyText: "Nothing",
+        });
+        return data ? notice : guard;
+    }
+    it("defaults its texts to English outside a locale", async () => {
+        callTool.mockRejectedValueOnce(new Error("engine prod unreachable (ECONNREFUSED)"));
+        render(_jsx(Bare, {}), { wrapper });
+        await invalidate();
+        expect(await screen.findByText("Couldn't refresh this view")).toBeTruthy();
+        expect(screen.getByText("Engine prod is unreachable. You're seeing the last loaded state.")).toBeTruthy();
+        expect(screen.getByRole("button", { name: "Try again" })).toBeTruthy();
+    });
+    it("defaults its texts to the active locale's kit labels (#339)", async () => {
+        callTool.mockRejectedValueOnce(new Error("weg"));
+        render(_jsx(LocaleProvider, { locale: "de", children: _jsx(Bare, {}) }), { wrapper });
+        await invalidate();
+        expect(await screen.findByText("Die Ansicht konnte nicht aktualisiert werden")).toBeTruthy();
+        expect(screen.getByText("Das hat nicht geklappt. Du siehst den zuletzt geladenen Stand.")).toBeTruthy();
+        expect(screen.getByRole("button", { name: "Erneut versuchen" })).toBeTruthy();
+    });
+});
+//# sourceMappingURL=use-detail-view.test.js.map

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

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

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

@@ -0,0 +1,48 @@
+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.
+     */
+    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).
+ */
+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. */
+    searchArg?: string;
+    /** Additional non-search filters (e.g. chips) 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;
+}): PagedListView<TItem, TData>;
+//# sourceMappingURL=use-paged-list-view.d.ts.map

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

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

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

@@ -0,0 +1,41 @@
+import { useState } from "react";
+import { useDebouncedValue } from "@miragon/mcp-toolkit-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).
+ */
+export function usePagedListView(opts) {
+    const { initialData, key, tool, args, searchArg, filtersActive = false, pageSize, ready, selectItems, selectTotal, } = opts;
+    const [search, setSearch] = useState("");
+    const debouncedSearch = useDebouncedValue(search.trim(), 300);
+    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.
+        initialData: requested ? null : initialData,
+        key,
+        tool,
+        args: effectiveArgs,
+        pageSize,
+        ready,
+        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.
+    const [shownRequested, setShownRequested] = useState(requested);
+    if (!paged.stale && shownRequested !== requested)
+        setShownRequested(requested);
+    const interacted = paged.stale ? shownRequested : requested;
+    return { paged, search, setSearch, debouncedSearch, interacted };
+}
+//# sourceMappingURL=use-paged-list-view.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-paged-list-view.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-paged-list-view.test.d.ts","sourceRoot":"","sources":["../../src/ui/use-paged-list-view.test.tsx"],"names":[],"mappings":""}

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

@@ -0,0 +1,136 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { act, cleanup, renderHook, waitFor } from "@testing-library/react";
+import { AppQueryProvider, queryClient } from "@miragon/mcp-toolkit-ui";
+import { usePagedListView } from "./use-paged-list-view.js";
+const PAGE = { items: ["a", "b"], total: 10 };
+const toolResult = (p) => ({ structuredContent: p });
+const callTool = vi.fn();
+function wrapper({ children }) {
+    return _jsx(AppQueryProvider, { callTool: callTool, children: children });
+}
+/** The list's filter args: a chip (`suspended`) is part of them, as in the real lists. */
+const argsFor = (filtersActive) => filtersActive ? { scope: "s1", suspended: true } : { scope: "s1" };
+function setup(opts) {
+    return renderHook(({ filtersActive }) => usePagedListView({
+        initialData: opts?.initialData ?? null,
+        key: ["test:list"],
+        tool: "test_list_data",
+        args: argsFor(filtersActive),
+        searchArg: "nameLike",
+        filtersActive,
+        pageSize: 2,
+        ready: true,
+        selectItems: (d) => d.items,
+        selectTotal: (d) => d.total,
+    }), { wrapper, initialProps: { filtersActive: opts?.filtersActive ?? false } });
+}
+/** The page-0 reads sent with exactly these filter args. */
+const page0Calls = (args) => callTool.mock.calls.filter(([, sent]) => JSON.stringify(sent) === JSON.stringify({ ...args, firstResult: 0, maxResults: 2 }));
+/** A tool answer that waits until the test lands it. */
+function deferred() {
+    let land;
+    const promise = new Promise((resolve) => (land = resolve));
+    return { promise, land };
+}
+/** Past the search box's 300 ms debounce. */
+const debounce = () => act(() => new Promise((resolve) => setTimeout(resolve, 350)));
+const toolkitDefaults = queryClient.getDefaultOptions();
+beforeEach(() => {
+    callTool.mockReset();
+    queryClient.setDefaultOptions({
+        ...toolkitDefaults,
+        queries: { ...toolkitDefaults.queries, retry: false },
+    });
+});
+afterEach(() => {
+    cleanup();
+    queryClient.clear();
+    queryClient.setDefaultOptions(toolkitDefaults);
+});
+describe("usePagedListView", () => {
+    it("adds the debounced, trimmed search value as the server-side search arg", async () => {
+        callTool.mockResolvedValue(toolResult(PAGE));
+        const { result } = setup();
+        await waitFor(() => expect(result.current.paged.items).toEqual(["a", "b"]));
+        act(() => result.current.setSearch("  ORDER-1 "));
+        // Before the debounce elapses the feed still sees the base args.
+        expect(callTool.mock.calls.some(([, sent]) => "nameLike" in sent)).toBe(false);
+        expect(result.current.interacted).toBe(false);
+        await debounce();
+        await waitFor(() => expect(page0Calls({ scope: "s1", nameLike: "ORDER-1" })).toHaveLength(1));
+        await waitFor(() => expect(result.current.interacted).toBe(true));
+        expect(result.current.debouncedSearch).toBe("ORDER-1");
+    });
+    it("drops the handed-in page 0 once a search or filter is active", async () => {
+        const { result, rerender } = setup({ initialData: PAGE });
+        // Unfiltered: the handed-in page renders — as the seed of the unfiltered
+        // page-0 query, which stays live for a write's refetch.
+        expect(result.current.paged.items).toEqual(["a", "b"]);
+        expect(queryClient.getQueryData([
+            "test:list",
+            JSON.stringify({ scope: "s1" }),
+            "page0",
+            { scope: "s1", firstResult: 0, maxResults: 2 },
+        ])).toBe(PAGE);
+        expect(callTool).not.toHaveBeenCalled();
+        callTool.mockReturnValue(deferred().promise);
+        act(() => result.current.setSearch("x"));
+        await debounce();
+        // The filtered view must come from the feed, not the unfiltered page …
+        await waitFor(() => expect(page0Calls({ scope: "s1", nameLike: "x" })).toHaveLength(1));
+        // … but until it answers, the handed-in rows stay on screen (#341 N123):
+        // the list — and the search box above it — never unmounts mid-search.
+        expect(result.current.paged.firstPage).toBe(PAGE);
+        expect(result.current.paged.items).toEqual(["a", "b"]);
+        expect(result.current.paged.loading).toBe(false);
+        // Chips (filtersActive) drop the handed-in page the same way.
+        act(() => result.current.setSearch(""));
+        await debounce();
+        rerender({ filtersActive: true });
+        await waitFor(() => expect(page0Calls({ scope: "s1", suspended: true })).toHaveLength(1));
+        expect(result.current.paged.firstPage).toBe(PAGE);
+        expect(result.current.paged.stale).toBe(true);
+    });
+    it("`interacted` describes the rows on screen, not a filter that has not answered", async () => {
+        const EMPTY = { items: [], total: 0 };
+        const { result, rerender } = setup({ initialData: EMPTY });
+        expect(result.current.interacted).toBe(false);
+        // A chip is in flight: the unfiltered (empty) result stays on screen, and
+        // its empty state must not read "no match" for a filter nobody answered.
+        const chip = deferred();
+        callTool.mockReturnValueOnce(chip.promise);
+        rerender({ filtersActive: true });
+        await waitFor(() => expect(page0Calls({ scope: "s1", suspended: true })).toHaveLength(1));
+        expect(result.current.paged.stale).toBe(true);
+        expect(result.current.interacted).toBe(false);
+        // The filtered page lands: the rows on screen are now the filtered set.
+        act(() => chip.land(toolResult({ items: [], total: 0 })));
+        await waitFor(() => expect(result.current.paged.stale).toBe(false));
+        expect(result.current.interacted).toBe(true);
+    });
+    it("a filtered result on screen still reads as filtered while the unfiltered one loads", async () => {
+        const ALL = { items: ["a"], total: 1 };
+        const FILTERED = { items: [], total: 0 };
+        callTool.mockResolvedValueOnce(toolResult(ALL));
+        const { result, rerender } = setup({ initialData: null });
+        await waitFor(() => expect(result.current.paged.firstPage).toEqual(ALL));
+        expect(result.current.interacted).toBe(false);
+        // The chip's page lands: the filtered set is on screen.
+        callTool.mockResolvedValueOnce(toolResult(FILTERED));
+        rerender({ filtersActive: true });
+        await waitFor(() => expect(result.current.paged.firstPage).toEqual(FILTERED));
+        expect(result.current.paged.stale).toBe(false);
+        expect(result.current.interacted).toBe(true);
+        // The chip is cleared; the unfiltered page 0 (gone from the cache) is in flight.
+        queryClient.removeQueries({ queryKey: ["test:list", JSON.stringify({ scope: "s1" })] });
+        callTool.mockReturnValueOnce(deferred().promise);
+        rerender({ filtersActive: false });
+        await waitFor(() => expect(page0Calls({ scope: "s1" })).toHaveLength(2));
+        expect(result.current.paged.firstPage).toEqual(FILTERED);
+        expect(result.current.paged.stale).toBe(true);
+        expect(result.current.interacted).toBe(true);
+    });
+});
+//# sourceMappingURL=use-paged-list-view.test.js.map

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

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