@miragon/pulse-widget-shell 0.24.2 → 0.25.0

package/dist/ui/view-call.js

@@ -0,0 +1,63 @@
+/** What a view renders: a non-null, non-array object (`buildViewResult`'s data). */
+export function isViewData(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+const WAITING = { phase: "waiting" };
+/**
+ * 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 function resolveViewCall(inputs) {
+    const { status, output, rerun } = inputs;
+    if (rerun.state === "done") {
+        const reloadedAt = rerun.recovered ? rerun.at : null;
+        return { phase: { phase: "ready", data: rerun.data, reloadedAt }, recover: false };
+    }
+    if (status === "ready" && isViewData(output)) {
+        return { phase: { phase: "ready", data: output, reloadedAt: null }, recover: false };
+    }
+    if (inputs.cancelled)
+        return { phase: { phase: "cancelled" }, recover: false };
+    if (rerun.state === "running")
+        return { phase: WAITING, recover: false };
+    if (rerun.state === "failed")
+        return { phase: { phase: "error", error: rerun.error }, recover: false };
+    if (status === "error") {
+        const error = inputs.error ?? new Error("The tool call failed.");
+        return { phase: { phase: "error", error }, recover: false };
+    }
+    const recover = status === "ready" || inputs.observation.result === "stripped";
+    return { phase: WAITING, recover };
+}
+/**
+ * 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 function viewCallContext(phase) {
+    switch (phase.phase) {
+        case "waiting":
+            return null;
+        case "cancelled":
+            return {
+                summary: "The view was cancelled before it rendered. The user sees a note that the call was cancelled.",
+            };
+        case "error":
+            return {
+                summary: "The view could not be shown. The user sees an error message with a retry button instead of the view.",
+                untrusted: [{ label: "reason", text: phase.error.message }],
+            };
+        case "ready":
+            if (phase.reloadedAt === null)
+                return null;
+            return {
+                summary: "The view re-ran its tool because the host did not pass the result to the view; its figures are live as of liveAsOf and can differ from the result in the chat.",
+                facts: { liveAsOf: new Date(phase.reloadedAt).toISOString() },
+            };
+    }
+}
+//# sourceMappingURL=view-call.js.map

package/dist/ui/view-call.js.map

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

package/dist/ui/view-data-state.d.ts

@@ -1,52 +1,22 @@
 import type { ReactNode } from "react";
-/**
- * A loading state for screen readers and eyes alike: a polite status with
- * the (visually hidden) text, and the skeleton shown instead of it.
- */
 export declare function LoadingStatus({ text, skeleton, className, }: {
     text: string;
     skeleton?: ReactNode;
     className?: string;
 }): import("react").JSX.Element;
-/**
- * The canonical loading / error / no-data boundary for widgets driven by
- * `useViewData`-style hooks — the block every widget used to copy inline.
- *
- * - Loading: the `skeleton` (default: a heading bar and a block) under a
- *   polite status whose words ("Ansicht wird geladen…" / "Loading view…",
- *   or `loadingText`) only a screen reader reads.
- * - Error: the toolkit's `ErrorState` from {@link describeError}: what
- *   happened, what you can do, the raw text collapsed under "Details", and a
- *   retry — mandatory, a failed load is never a dead end.
- * - No data: the toolkit's `EmptyState` with `emptyText`.
- *
- * Callers keep their own wrapper (`WidgetShell`, card, …):
- *
- *   if (!data) {
- *     return (
- *       <WidgetShell>
- *         <ViewDataState loading={loading} error={error} onRetry={refetch}
- *           emptyText={t("x.noData")} />
- *       </WidgetShell>
- *     )
- *   }
- */
+/** Loading, error and no-data boundary; the retry is mandatory, a failed load is never a dead end. */
 export declare function ViewDataState({ loading, error, onRetry, emptyText, loadingText, skeleton, errorTitle, retryLabel, className, }: {
     loading: boolean;
     error: Error | null | undefined;
-    /** Re-run the failed load (the query's refetch). */
     onRetry: () => void;
     /** What is missing when the load finished without data ("No incident found"). */
     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;
     /** Title for an error the kit cannot classify (default: the locale's "Something went wrong"). */
     errorTitle?: string;
-    /** Caller-localized retry label (default: the active locale's). */
     retryLabel?: string;
-    /** Merged into the state's wrapper (tailwind-merge semantics). */
     className?: string;
 }): import("react").JSX.Element;
 //# sourceMappingURL=view-data-state.d.ts.map

package/dist/ui/view-data-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-data-state.d.ts","sourceRoot":"","sources":["../../src/ui/view-data-state.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAkBtC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,SAAS,GACV,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,+BASA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,GACV,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,oDAAoD;IACpD,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAA;IACjB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,+BA0BA"}
+{"version":3,"file":"view-data-state.d.ts","sourceRoot":"","sources":["../../src/ui/view-data-state.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAetC,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,SAAS,GACV,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,+BASA;AAED,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,GACV,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,+BA0BA"}

package/dist/ui/view-data-state.js

@@ -1,44 +1,15 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { cn, EmptyState, ErrorState, Skeleton, useLocale } from "@miragon/mcp-toolkit-ui";
+import { cn, EmptyState, ErrorState, Skeleton, useLocale } from "@miragon/pulse-ui";
 import { describeError } from "./describe-error.js";
 import { kitLabels } from "./kit-labels.js";
-/**
- * The default loading skeleton: a heading bar over a block, the rough
- * geometry of a widget body. Pass `skeleton` for one shaped like the result.
- */
+/** The rough geometry of a widget body. */
 function DefaultSkeleton() {
     return (_jsxs(_Fragment, { children: [_jsx(Skeleton, { className: "h-7 w-48" }), _jsx(Skeleton, { className: "h-24 w-full" })] }));
 }
-/**
- * A loading state for screen readers and eyes alike: a polite status with
- * the (visually hidden) text, and the skeleton shown instead of it.
- */
 export function LoadingStatus({ text, skeleton, className, }) {
     return (_jsxs("div", { role: "status", className: cn("flex flex-col gap-3", className), children: [_jsx("span", { className: "sr-only", children: text }), _jsx("div", { "aria-hidden": "true", className: "flex flex-col gap-3", children: skeleton ?? _jsx(DefaultSkeleton, {}) })] }));
 }
-/**
- * The canonical loading / error / no-data boundary for widgets driven by
- * `useViewData`-style hooks — the block every widget used to copy inline.
- *
- * - Loading: the `skeleton` (default: a heading bar and a block) under a
- *   polite status whose words ("Ansicht wird geladen…" / "Loading view…",
- *   or `loadingText`) only a screen reader reads.
- * - Error: the toolkit's `ErrorState` from {@link describeError}: what
- *   happened, what you can do, the raw text collapsed under "Details", and a
- *   retry — mandatory, a failed load is never a dead end.
- * - No data: the toolkit's `EmptyState` with `emptyText`.
- *
- * Callers keep their own wrapper (`WidgetShell`, card, …):
- *
- *   if (!data) {
- *     return (
- *       <WidgetShell>
- *         <ViewDataState loading={loading} error={error} onRetry={refetch}
- *           emptyText={t("x.noData")} />
- *       </WidgetShell>
- *     )
- *   }
- */
+/** Loading, error and no-data boundary; the retry is mandatory, a failed load is never a dead end. */
 export function ViewDataState({ loading, error, onRetry, emptyText, loadingText, skeleton, errorTitle, retryLabel, className, }) {
     const locale = useLocale();
     const defaults = kitLabels(locale);

package/dist/ui/view-data-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-data-state.js","sourceRoot":"","sources":["../../src/ui/view-data-state.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C;;;GAGG;AACH,SAAS,eAAe;IACtB,OAAO,CACL,8BACE,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,GAAG,EACjC,KAAC,QAAQ,IAAC,SAAS,EAAC,aAAa,GAAG,IACnC,CACJ,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,SAAS,GAKV;IACC,OAAO,CACL,eAAK,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC,aAChE,eAAM,SAAS,EAAC,SAAS,YAAE,IAAI,GAAQ,EACvC,6BAAiB,MAAM,EAAC,SAAS,EAAC,qBAAqB,YACpD,QAAQ,IAAI,KAAC,eAAe,KAAG,GAC5B,IACF,CACP,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,GAkBV;IACC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAA;QAC7E,OAAO,CACL,KAAC,UAAU,IACT,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,SAAS,CAAC,KAAK,EACtB,WAAW,EAAE,SAAS,CAAC,IAAI,EAC3B,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,EACvC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,GACtB,CACH,CAAA;IACH,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CACL,KAAC,aAAa,IACZ,IAAI,EAAE,WAAW,IAAI,QAAQ,CAAC,WAAW,EACzC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,GACpB,CACH,CAAA;IACH,CAAC;IACD,OAAO,KAAC,UAAU,IAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAI,CAAA;AAC/D,CAAC"}
+{"version":3,"file":"view-data-state.js","sourceRoot":"","sources":["../../src/ui/view-data-state.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,2CAA2C;AAC3C,SAAS,eAAe;IACtB,OAAO,CACL,8BACE,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,GAAG,EACjC,KAAC,QAAQ,IAAC,SAAS,EAAC,aAAa,GAAG,IACnC,CACJ,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAQ,EACR,SAAS,GAKV;IACC,OAAO,CACL,eAAK,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC,aAChE,eAAM,SAAS,EAAC,SAAS,YAAE,IAAI,GAAQ,EACvC,6BAAiB,MAAM,EAAC,SAAS,EAAC,qBAAqB,YACpD,QAAQ,IAAI,KAAC,eAAe,KAAG,GAC5B,IACF,CACP,CAAA;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,GAcV;IACC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAA;QAC7E,OAAO,CACL,KAAC,UAAU,IACT,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,SAAS,CAAC,KAAK,EACtB,WAAW,EAAE,SAAS,CAAC,IAAI,EAC3B,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS,EACvC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,GACtB,CACH,CAAA;IACH,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CACL,KAAC,aAAa,IACZ,IAAI,EAAE,WAAW,IAAI,QAAQ,CAAC,WAAW,EACzC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,GACpB,CACH,CAAA;IACH,CAAC;IACD,OAAO,KAAC,UAAU,IAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAI,CAAA;AAC/D,CAAC"}

package/dist/ui/view-error-boundary.d.ts

@@ -0,0 +1,24 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+interface BoundaryState {
+    error: Error | null;
+    resetKey: unknown;
+}
+/**
+ * Keeps one crashing widget from blanking the view: it says the element couldn't be displayed,
+ * the raw text under Details, with a retry that renders it again. A new `resetKey` (the next
+ * route) clears it.
+ */
+export declare class ViewErrorBoundary extends Component<{
+    resetKey?: unknown;
+    children: ReactNode;
+}, BoundaryState> {
+    state: BoundaryState;
+    static getDerivedStateFromError(error: unknown): Partial<BoundaryState>;
+    static getDerivedStateFromProps(props: {
+        resetKey?: unknown;
+    }, state: BoundaryState): Partial<BoundaryState> | null;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=view-error-boundary.d.ts.map

package/dist/ui/view-error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-error-boundary.d.ts","sourceRoot":"","sources":["../../src/ui/view-error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIjE,UAAU,aAAa;IACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,SAAS,CAC9C;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,EAC3C,aAAa,CACd;IACC,KAAK,EAAE,aAAa,CAAiD;IAErE,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IAIvE,MAAM,CAAC,wBAAwB,CAC7B,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAC7B,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAMhC,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAItD,MAAM,IAAI,SAAS;CAIpB"}

package/dist/ui/view-error-boundary.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component } from "react";
+import { ErrorState, useLocale } from "@miragon/pulse-ui";
+import { kitLabels } from "./kit-labels.js";
+/**
+ * Keeps one crashing widget from blanking the view: it says the element couldn't be displayed,
+ * the raw text under Details, with a retry that renders it again. A new `resetKey` (the next
+ * route) clears it.
+ */
+export class ViewErrorBoundary extends Component {
+    state = { error: null, resetKey: this.props.resetKey };
+    static getDerivedStateFromError(error) {
+        return { error: error instanceof Error ? error : new Error(String(error)) };
+    }
+    static getDerivedStateFromProps(props, state) {
+        return Object.is(props.resetKey, state.resetKey)
+            ? null
+            : { error: null, resetKey: props.resetKey };
+    }
+    componentDidCatch(error, info) {
+        console.error("[pulse] a view element crashed:", error, info.componentStack);
+    }
+    render() {
+        if (!this.state.error)
+            return this.props.children;
+        return _jsx(Crashed, { error: this.state.error, onRetry: () => this.setState({ error: null }) });
+    }
+}
+function Crashed({ error, onRetry }) {
+    const labels = kitLabels(useLocale());
+    return (_jsx(ErrorState, { variant: "inline", title: labels.viewCrashed, details: error.message || undefined, onRetry: onRetry, retryLabel: labels.retry }));
+}
+//# sourceMappingURL=view-error-boundary.js.map

package/dist/ui/view-error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-error-boundary.js","sourceRoot":"","sources":["../../src/ui/view-error-boundary.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAkC,MAAM,OAAO,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAO3C;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAGtC;IACC,KAAK,GAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAA;IAErE,MAAM,CAAC,wBAAwB,CAAC,KAAc;QAC5C,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAA;IAC7E,CAAC;IAED,MAAM,CAAC,wBAAwB,CAC7B,KAA6B,EAC7B,KAAoB;QAEpB,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC;YAC9C,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAA;IAC/C,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,IAAe;QAC7C,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;IAC9E,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAA;QACjD,OAAO,KAAC,OAAO,IAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAI,CAAA;IAC5F,CAAC;CACF;AAED,SAAS,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAyC;IACxE,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,CAAA;IACrC,OAAO,CACL,KAAC,UAAU,IACT,OAAO,EAAC,QAAQ,EAChB,KAAK,EAAE,MAAM,CAAC,WAAW,EACzB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,SAAS,EACnC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,CAAC,KAAK,GACxB,CACH,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+import { type ViewCall } from "./view-call.js";
+import type { ViewComponent } from "./views.js";
+/** After this long, the waiting line adds what to do. */
+export declare const SLOW_HINT_MS = 8000;
+/**
+ * The view's lifecycle around ONE view component: waiting, error (the kit's words, the raw text
+ * under Details, Try again), cancelled, a missing view, then the view itself under a toolbar that
+ * carries the "Reloaded at" stamp and the fullscreen switch. No title: views carry their heading.
+ * Host-agnostic, so it renders under `TestViewHost` too.
+ */
+export declare function ViewFrame({ call, view }: {
+    call: ViewCall;
+    view: ViewComponent | undefined;
+}): import("react").JSX.Element;
+//# sourceMappingURL=view-frame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view-frame.d.ts","sourceRoot":"","sources":["../../src/ui/view-frame.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAI/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,yDAAyD;AACzD,eAAO,MAAM,YAAY,OAAQ,CAAA;AAEjC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,+BAgB5F"}

package/dist/ui/view-frame.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { ErrorState, Skeleton, useLocale, formatTime } from "@miragon/pulse-ui";
+import { modelContextText } from "./ask-ai-prompt.js";
+import { DisplayModeToggle, useDisplayModeControl } from "./display-mode-toggle.js";
+import { kitLabels } from "./kit-labels.js";
+import { useShellHost } from "./shell-host.js";
+import { viewCallContext } from "./view-call.js";
+import { ViewDataState } from "./view-data-state.js";
+import { ViewErrorBoundary } from "./view-error-boundary.js";
+import { HostModelContext } from "./view-host.js";
+/** After this long, the waiting line adds what to do. */
+export const SLOW_HINT_MS = 8_000;
+/**
+ * The view's lifecycle around ONE view component: waiting, error (the kit's words, the raw text
+ * under Details, Try again), cancelled, a missing view, then the view itself under a toolbar that
+ * carries the "Reloaded at" stamp and the fullscreen switch. No title: views carry their heading.
+ * Host-agnostic, so it renders under `TestViewHost` too.
+ */
+export function ViewFrame({ call, view }) {
+    const frameRef = useRef(null);
+    const labels = kitLabels(useLocale());
+    const { phase } = call;
+    // The frame stays the focus target, so a retry never drops focus to the document.
+    const retry = useCallback(() => {
+        frameRef.current?.focus();
+        call.retry();
+    }, [call]);
+    const spec = view ? viewCallContext(phase) : null;
+    return (_jsxs("div", { ref: frameRef, tabIndex: -1, "data-slot": "view-frame", className: "outline-hidden", children: [spec && _jsx(HostModelContext, { content: modelContextText(spec) }), _jsx(FrameBody, { call: call, view: view, labels: labels, onRetry: retry })] }));
+}
+function FrameBody({ call: { phase }, view: View, labels, onRetry, }) {
+    if (!View) {
+        return (_jsx("div", { className: "px-4 py-4", children: _jsx(ErrorState, { title: labels.viewMissing }) }));
+    }
+    switch (phase.phase) {
+        case "waiting":
+            return _jsx(ViewWaiting, { labels: labels });
+        case "cancelled":
+            return (_jsx("div", { className: "px-4 py-4", children: _jsx("p", { role: "status", className: "text-muted-foreground text-small", children: labels.cancelled }) }));
+        case "error":
+            return (_jsx("div", { className: "px-4 py-4", children: _jsx(ViewDataState, { loading: false, error: phase.error, onRetry: onRetry, emptyText: "", errorTitle: labels.viewErrorTitle }) }));
+        case "ready":
+            return (_jsx(ViewMain, { reloadedAt: phase.reloadedAt, labels: labels, children: _jsx(ViewErrorBoundary, { children: _jsx(View, { data: phase.data }) }) }));
+    }
+}
+/** No aria-busy above the live region: assistive technology may hold back the slow hint. */
+function ViewWaiting({ labels }) {
+    const [slow, setSlow] = useState(false);
+    useEffect(() => {
+        const id = setTimeout(() => setSlow(true), SLOW_HINT_MS);
+        return () => clearTimeout(id);
+    }, []);
+    return (_jsxs("div", { className: "flex flex-col gap-4 px-4 py-4", children: [_jsx(Skeleton, { "aria-hidden": "true", className: "h-8 w-48" }), _jsx(Skeleton, { "aria-hidden": "true", className: "h-32 w-full" }), _jsxs("div", { role: "status", className: "text-muted-foreground text-small flex flex-col gap-1", children: [_jsx("p", { children: labels.loadingView }), slow && _jsx("p", { "data-slot": "slow-hint", children: labels.slowHint })] })] }));
+}
+/**
+ * Fullscreen, the view owns the viewport and scrolls itself; inline the host sizes the frame from
+ * its height. Safe-area insets pad it on mobile hosts.
+ */
+function ViewMain({ reloadedAt, labels, children, }) {
+    const { safeArea } = useShellHost();
+    const { displayMode, canFullscreen } = useDisplayModeControl();
+    const style = {
+        ...(displayMode === "fullscreen" ? { minHeight: "100vh", overflowY: "auto" } : null),
+        paddingTop: safeArea?.top,
+        paddingRight: safeArea?.right,
+        paddingBottom: safeArea?.bottom,
+        paddingLeft: safeArea?.left,
+    };
+    return (_jsxs("main", { style: style, children: [(reloadedAt !== null || canFullscreen) && (_jsxs("div", { "data-slot": "view-toolbar", className: "flex min-h-12 items-center gap-2 px-4 py-2", children: [reloadedAt !== null && (_jsx("p", { "data-slot": "view-reloaded-at", className: "text-muted-foreground text-small min-w-0 truncate", children: labels.reloadedAt(formatTime(new Date(reloadedAt).toISOString(), { seconds: false })) })), _jsx("div", { className: "ml-auto flex shrink-0 items-center gap-1", children: _jsx(DisplayModeToggle, {}) })] })), children] }));
+}
+//# sourceMappingURL=view-frame.js.map

package/dist/ui/view-frame.js.map

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

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

@@ -0,0 +1,35 @@
+import { type ComponentType, type ReactNode } from "react";
+import type { ToolResult } from "../protocol/tool-result.js";
+/**
+ * The ONE seam between a view and its host. Widgets never import `mcp-use/react` (its hooks
+ * throw outside `bootstrapView`): production provides the mcp-use adapter (`mountViews`), tests
+ * `TestViewHost`. Display mode stays in the host-agnostic `useShellHost`/`useDisplayModeControl`.
+ */
+export interface ViewHost {
+    /**
+     * Calls any server tool by name. RESOLVES with the raw result, an `isError` result included
+     * (`decodeToolResult` throws it); rejects only on a transport failure (no host, no
+     * `serverTools` capability, a JSON-RPC error such as an unknown tool).
+     */
+    callTool: (name: string, args?: object) => Promise<ToolResult>;
+    /** Posts a USER message into the chat (hand-offs, navigation). Fail-soft: never throws. */
+    sendFollowUp: (prompt: string) => void;
+    /** Opens a URL outside the frame. Fail-soft. */
+    openExternal: (url: string) => void;
+    /** One node of the view's model-context tree; nests like mcp-use's `ModelContext`. */
+    ModelContext: ComponentType<{
+        content: string;
+        children?: ReactNode;
+    }>;
+}
+export declare function ViewHostProvider({ host, children }: {
+    host: ViewHost;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useViewHost(): ViewHost;
+/** The ONE way a widget reports model context; build `content` with `modelContextText`. */
+export declare function HostModelContext({ content, children }: {
+    content: string;
+    children?: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=view-host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view-host.d.ts","sourceRoot":"","sources":["../../src/ui/view-host.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAE5D;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC9D,2FAA2F;IAC3F,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,gDAAgD;IAChD,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,sFAAsF;IACtF,YAAY,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAA;CACvE;AAID,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAE3F;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAItC;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,+BAGhG"}

package/dist/ui/view-host.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const ViewHostContext = createContext(null);
+export function ViewHostProvider({ host, children }) {
+    return _jsx(ViewHostContext.Provider, { value: host, children: children });
+}
+export function useViewHost() {
+    const host = useContext(ViewHostContext);
+    if (!host)
+        throw new Error("[pulse] useViewHost() needs mountViews/mountView or TestViewHost");
+    return host;
+}
+/** The ONE way a widget reports model context; build `content` with `modelContextText`. */
+export function HostModelContext({ content, children }) {
+    const { ModelContext } = useViewHost();
+    return _jsx(ModelContext, { content: content, children: children });
+}
+//# sourceMappingURL=view-host.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view-host.js","sourceRoot":"","sources":["../../src/ui/view-host.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAsC,MAAM,OAAO,CAAA;AAuBrF,MAAM,eAAe,GAAG,aAAa,CAAkB,IAAI,CAAC,CAAA;AAE5D,MAAM,UAAU,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAA2C;IAC1F,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAAG,QAAQ,GAA4B,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;IACxC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IAC9F,OAAO,IAAI,CAAA;AACb,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAA6C;IAC/F,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAAA;IACtC,OAAO,KAAC,YAAY,IAAC,OAAO,EAAE,OAAO,YAAG,QAAQ,GAAgB,CAAA;AAClE,CAAC"}

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

@@ -1,19 +1,9 @@
-import type { Locale } from "../profile-constants.js";
+import type { Locale } from "./host-context.js";
 /**
- * The reference frame of a data view, as one quiet line under its title:
- * "Letzte 7 Tage · 6 Engines (3 ohne Metriken) · Stand 14:32" (U7: real
- * numbers say where they come from). A number without its period, its engine
- * set and the time it was read is a number the reader has to guess about;
- * the model gets the same scope through the view's description.
- *
- * Every part is optional and left out when unknown, never guessed: a live
- * snapshot has no period, an unscoped result no engine count, an old payload
- * no as-of time. Like the other formatters, the words follow the view's
- * format locale (German or English) that the shell's ProfileGate publishes.
+ * Period, engine set and as-of time under a view title (U7). Each part is
+ * left out when unknown, never guessed.
  */
-/** The engines the figures add up. */
 export interface ViewMetaEngines {
-    /** How many engines the figures cover. */
     count: number;
     /** Of those, how many report no metrics; omit when unknown. */
     silent?: number | null;
@@ -21,16 +11,13 @@ export interface ViewMetaEngines {
 export interface ViewMetaParts {
     /** What the figures are about, first on the line (a process key, "v1 → v2"). */
     subject?: string | null;
-    /**
-     * The time frame in words: `formatLookback("7d")` → "Letzte 7 Tage", or a
-     * custom window ("7 Tage davor, 7 Tage danach"). Omit for a live snapshot.
-     */
+    /** Omit for a live snapshot. */
     period?: string | null;
     engines?: ViewMetaEngines | null;
     /** When the figures were read (ISO timestamp); shown as "Stand 14:32". */
     asOf?: string | null;
 }
-/** The words of the meta line, per language (run through the catalog text test). */
+/** Run through the catalog text test. */
 export interface ViewMetaLabels {
     /** `count` decides the plural, `n` is the formatted number. */
     engines: (p: {
@@ -51,19 +38,9 @@ export interface ViewMetaLabels {
     lastMinute: string;
 }
 export declare const VIEW_META_LABELS: Readonly<Record<Locale, ViewMetaLabels>>;
-/**
- * A look-back period token as the frame of a view: "7d" → "Letzte 7 Tage" /
- * "Last 7 days". A single day or week reads as its length ("Letzte 24
- * Stunden", "Letzte 7 Tage"): "Letzter Tag" would read as yesterday. Anything
- * that is not such a token comes back unchanged; empty input renders "".
- */
+/** A single day reads as its length ("Letzte 24 Stunden"): "Letzter Tag" would read as yesterday. */
 export declare function formatLookback(period: string | null | undefined): string;
-/** The meta line as text: the known parts joined with " · ", "" when none is known. */
 export declare function formatViewMeta(parts: ViewMetaParts, now?: Date): string;
-/**
- * The quiet meta line under a view title (`WidgetHeader`'s `sub`, or right
- * under a card heading). Renders nothing when no part is known.
- */
 export declare function ViewMeta({ className, ...parts }: ViewMetaParts & {
     className?: string;
 }): import("react").JSX.Element | null;

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

@@ -1 +1 @@
-{"version":3,"file":"view-meta.d.ts","sourceRoot":"","sources":["../../src/ui/view-meta.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGrD;;;;;;;;;;;GAWG;AAEH,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAChC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACpD,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACpC,IAAI,EAAE,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACrC,4DAA4D;IAC5D,IAAI,EAAE,CAAC,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAiBrE,CAAA;AAQD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAaxE;AASD,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAcnF;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,sCAQvF"}
+{"version":3,"file":"view-meta.d.ts","sourceRoot":"","sources":["../../src/ui/view-meta.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAChC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACpD,MAAM,EAAE,CAAC,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACpC,IAAI,EAAE,CAAC,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACrC,4DAA4D;IAC5D,IAAI,EAAE,CAAC,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAiBrE,CAAA;AAQD,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAaxE;AASD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAcnF;AAED,wBAAgB,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,sCAQvF"}

package/dist/ui/view-meta.js

@@ -1,6 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { cn } from "@miragon/mcp-toolkit-ui";
-import { formatDate, formatNumber, formatPeriod, formatTime, getFormatLocale } from "./format.js";
+import { cn, formatDate, formatNumber, formatPeriod, formatTime, getFormatLocale, } from "@miragon/pulse-ui";
 export const VIEW_META_LABELS = {
     en: {
         engines: ({ count, n }) => (count === 1 ? "1 engine" : `${n} engines`),
@@ -23,12 +22,7 @@ const SEPARATOR = " · ";
 function labels() {
     return VIEW_META_LABELS[getFormatLocale()?.language.toLowerCase().startsWith("de") ? "de" : "en"];
 }
-/**
- * A look-back period token as the frame of a view: "7d" → "Letzte 7 Tage" /
- * "Last 7 days". A single day or week reads as its length ("Letzte 24
- * Stunden", "Letzte 7 Tage"): "Letzter Tag" would read as yesterday. Anything
- * that is not such a token comes back unchanged; empty input renders "".
- */
+/** A single day reads as its length ("Letzte 24 Stunden"): "Letzter Tag" would read as yesterday. */
 export function formatLookback(period) {
     if (!period)
         return "";
@@ -53,7 +47,6 @@ function asOfTime(iso, now) {
     const sameDay = formatDate(iso) === formatDate(now.toISOString());
     return sameDay ? time : `${formatDate(iso)}, ${time}`;
 }
-/** The meta line as text: the known parts joined with " · ", "" when none is known. */
 export function formatViewMeta(parts, now = new Date()) {
     const l = labels();
     const out = [];
@@ -71,10 +64,6 @@ export function formatViewMeta(parts, now = new Date()) {
     }
     return out.join(SEPARATOR);
 }
-/**
- * The quiet meta line under a view title (`WidgetHeader`'s `sub`, or right
- * under a card heading). Renders nothing when no part is known.
- */
 export function ViewMeta({ className, ...parts }) {
     const text = formatViewMeta(parts);
     if (!text)

package/dist/ui/view-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-meta.js","sourceRoot":"","sources":["../../src/ui/view-meta.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAA;AAE5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAgDjG,MAAM,CAAC,MAAM,gBAAgB,GAA6C;IACxE,EAAE,EAAE;QACF,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;QACtE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB;QAC3C,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,IAAI,EAAE;QACnC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,QAAQ,MAAM,EAAE;QACtC,QAAQ,EAAE,WAAW;QACrB,UAAU,EAAE,aAAa;KAC1B;IACD,EAAE,EAAE;QACF,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;QACtE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB;QACzC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,IAAI,EAAE;QACnC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,UAAU,MAAM,EAAE;QACxC,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,eAAe;KAC5B;CACF,CAAA;AAED,MAAM,SAAS,GAAG,KAAK,CAAA;AAEvB,SAAS,MAAM;IACb,OAAO,gBAAgB,CAAC,eAAe,EAAE,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AACnG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiC;IAC9D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IACvD,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAA;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;IACnC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAA;IAClB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,CAAC,CAAC,UAAU,CAAA;QACrC,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,CAAC,CAAC,QAAQ,CAAA;QACnC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;AAC5D,CAAC;AAED,sEAAsE;AACtE,SAAS,QAAQ,CAAC,GAAW,EAAE,GAAS;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IAChD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;IACjE,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAA;AACvD,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,KAAoB,EAAE,MAAY,IAAI,IAAI,EAAE;IACzE,MAAM,CAAC,GAAG,MAAM,EAAE,CAAA;IAClB,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,IAAI,KAAK,CAAC,OAAO;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1C,IAAI,KAAK,CAAC,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAA;QACvC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC5D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACpF,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAA0C;IACtF,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,OAAO,CACL,8BAAkB,EAAE,EAAC,SAAS,EAAE,EAAE,CAAC,kCAAkC,EAAE,SAAS,CAAC,YAC9E,IAAI,GACH,CACL,CAAA;AACH,CAAC"}
+{"version":3,"file":"view-meta.js","sourceRoot":"","sources":["../../src/ui/view-meta.tsx"],"names":[],"mappings":"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"}

package/dist/ui/view-refresh-state.d.ts

@@ -1,26 +1,12 @@
-import type { ViewDataResult } from "@miragon/mcp-toolkit-ui/hooks";
-/** What a seeded view knows about re-reading the data it shows. */
+import type { ViewDataResult } from "./tool-query.js";
 export interface ViewRefreshState {
     /**
-     * A REFETCH of the data on screen failed: the view can no longer confirm it
-     * is current (an instance that ended answers 404 now). Set from the
-     * refetch's FIRST failed attempt — the toolkit's `failureReason`, while the
-     * client still retries (TanStack's default: 3 retries, ~7 s) — not only
-     * once `error` lands, so a view gating its writes on it never offers them
-     * on an unconfirmed state for the length of the backoff. Null while the
-     * data is the feed's latest answer, and null without data (that failure is
-     * the load error).
+     * Set from the refetch's FIRST failed attempt, so a view gating writes on it
+     * never offers them on an unconfirmed state through the backoff.
      */
     refreshError: Error | null;
-    /** A refetch of the data on screen is in flight. */
     refreshing: boolean;
 }
-/**
- * The refresh half of a view whose tool result SEEDS a live feed (the
- * toolkit's `useViewData(…, { initialDataMode: "seed" })`): the toolkit hands
- * out the raw query state (`error`, `failureReason`, `isFetching`), this is
- * the house rule over it — the one place that decides when shown data counts
- * as unconfirmed (`useDetailView`, the engine overview).
- */
+/** The one place that decides when shown data counts as unconfirmed. */
 export declare function viewRefreshState(view: Pick<ViewDataResult<unknown>, "data" | "error" | "failureReason" | "isFetching">): ViewRefreshState;
 //# sourceMappingURL=view-refresh-state.d.ts.map

package/dist/ui/view-refresh-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-refresh-state.d.ts","sourceRoot":"","sources":["../../src/ui/view-refresh-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,YAAY,EAAE,KAAK,GAAG,IAAI,CAAA;IAC1B,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,eAAe,GAAG,YAAY,CAAC,GACrF,gBAAgB,CAMlB"}
+{"version":3,"file":"view-refresh-state.d.ts","sourceRoot":"","sources":["../../src/ui/view-refresh-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,EAAE,KAAK,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,eAAe,GAAG,YAAY,CAAC,GACrF,gBAAgB,CAMlB"}

package/dist/ui/view-refresh-state.js

@@ -1,10 +1,4 @@
-/**
- * The refresh half of a view whose tool result SEEDS a live feed (the
- * toolkit's `useViewData(…, { initialDataMode: "seed" })`): the toolkit hands
- * out the raw query state (`error`, `failureReason`, `isFetching`), this is
- * the house rule over it — the one place that decides when shown data counts
- * as unconfirmed (`useDetailView`, the engine overview).
- */
+/** The one place that decides when shown data counts as unconfirmed. */
 export function viewRefreshState(view) {
     const shown = view.data !== null;
     return {

package/dist/ui/view-refresh-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-refresh-state.js","sourceRoot":"","sources":["../../src/ui/view-refresh-state.ts"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAsF;IAEtF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAA;IAChC,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,UAAU,EAAE,KAAK,IAAI,IAAI,CAAC,UAAU;KACrC,CAAA;AACH,CAAC"}
+{"version":3,"file":"view-refresh-state.js","sourceRoot":"","sources":["../../src/ui/view-refresh-state.ts"],"names":[],"mappings":"AAWA,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAC9B,IAAsF;IAEtF,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAA;IAChC,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,UAAU,EAAE,KAAK,IAAI,IAAI,CAAC,UAAU;KACrC,CAAA;AACH,CAAC"}