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

package/dist/ui/parse-tool-result.test.js

@@ -0,0 +1,88 @@
+import { describe, expect, it } from "vitest";
+import { parseToolResult, parseViewToolResult } from "@miragon/mcp-toolkit-ui";
+describe("parseToolResult (structuredContent-first contract)", () => {
+    it("prefers structuredContent over the text channel", () => {
+        const result = {
+            content: [{ type: "text", text: "Process list: 2 definitions." }],
+            structuredContent: { items: [1, 2], total: 2 },
+        };
+        expect(parseToolResult(result)).toEqual({ items: [1, 2], total: 2 });
+    });
+    it("prefers structuredContent even when the text channel is parseable JSON", () => {
+        const result = {
+            content: [{ type: "text", text: JSON.stringify({ fromText: true }) }],
+            structuredContent: { fromStructured: true },
+        };
+        expect(parseToolResult(result)).toEqual({ fromStructured: true });
+    });
+    it("falls back to JSON-decoding the first text block without structuredContent", () => {
+        const result = {
+            content: [{ type: "text", text: JSON.stringify({ items: [1, 2], total: 2 }) }],
+        };
+        expect(parseToolResult(result)).toEqual({ items: [1, 2], total: 2 });
+    });
+    it("returns non-JSON text verbatim without structuredContent", () => {
+        const result = { content: [{ type: "text", text: "plain status line" }] };
+        expect(parseToolResult(result)).toBe("plain status line");
+    });
+    it("falls back to the raw result when neither channel is present", () => {
+        const result = { something: "else" };
+        expect(parseToolResult(result)).toEqual({ something: "else" });
+    });
+    it("throws the first text block as the error message on isError results", () => {
+        const result = { isError: true, content: [{ type: "text", text: "boom" }] };
+        expect(() => parseToolResult(result)).toThrowError("boom");
+    });
+    it("throws a generic message on isError results without content", () => {
+        expect(() => parseToolResult({ isError: true })).toThrowError("Tool call failed");
+    });
+});
+describe("parseViewToolResult (show-tool envelope unwrap)", () => {
+    it("unwraps a single-step view envelope to the widget's flat data", () => {
+        const result = {
+            content: [{ type: "text", text: "Model summary." }],
+            structuredContent: {
+                title: "Instances",
+                context: {
+                    keys: {},
+                    stepIds: ["result"],
+                    stepData: { result: { data: { rows: [1], total: 1 }, keys: {} } },
+                    errors: [],
+                },
+                layout: [],
+            },
+        };
+        expect(parseViewToolResult(result)).toEqual({ rows: [1], total: 1 });
+    });
+    it("returns multi-step composed views keyed by step id", () => {
+        const result = {
+            structuredContent: {
+                context: {
+                    stepIds: ["kpis", "result_1"],
+                    stepData: {
+                        kpis: { data: { totalCount: 5 } },
+                        result_1: { data: { patterns: [] } },
+                    },
+                },
+                layout: [],
+            },
+        };
+        expect(parseViewToolResult(result)).toEqual({
+            kpis: { totalCount: 5 },
+            result_1: { patterns: [] },
+        });
+    });
+    it("passes non-envelope results (e.g. *_data feeds) through unchanged", () => {
+        const data = { jobs: [], totalCount: 0 };
+        const result = {
+            content: [{ type: "text", text: JSON.stringify(data) }],
+            structuredContent: data,
+        };
+        expect(parseViewToolResult(result)).toEqual(data);
+    });
+    it("propagates isError results as thrown errors", () => {
+        const result = { isError: true, content: [{ type: "text", text: "boom" }] };
+        expect(() => parseViewToolResult(result)).toThrowError("boom");
+    });
+});
+//# sourceMappingURL=parse-tool-result.test.js.map

package/dist/ui/parse-tool-result.test.js.map

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

package/dist/ui/profile-gate.d.ts

@@ -0,0 +1,37 @@
+import { type ReactNode } from "react";
+export interface ProfileGateProps {
+    /**
+     * The first paint's bound wait for the profile (ms, default
+     * {@link PROFILE_WAIT_MS}), counted from the host connection — a slow
+     * handshake never eats into it: a feed that neither answers nor fails in
+     * time (a slow store) renders from the host context instead of holding the
+     * view.
+     */
+    profileWaitMs?: number;
+    children: ReactNode;
+}
+/**
+ * Resolves the active user profile once at the app root — the shell's own
+ * feed (`shell_settings_data`), under the key the language section shares
+ * ({@link SHELL_SETTINGS_KEY}), so a saved language re-fetches one entry and
+ * flips every view live (the refetch never re-shows the first-paint
+ * skeleton) — and turns it, with
+ * the host context ({@link useShellHost}), into the view's ONE effective
+ * locale and theme — so every widget is localized and themed with zero
+ * per-widget wiring:
+ *  - language: explicit profile choice > `hostContext.locale` > English;
+ *  - theme: `hostContext.theme` > the OS (applied document-wide by
+ *    {@link useApplyTheme}; there is no in-app theme switch);
+ *  - the shared date formatters follow the same locale and the host's time zone.
+ * The first paint waits for the host handshake (bounded by {@link HOST_WAIT_MS}),
+ * then for the profile (bounded by `profileWaitMs` from the connection) behind
+ * a neutral skeleton, so a German profile or a dark host never flashes English
+ * or the OS theme first. A feed that FAILS (e.g. a root without a profile store
+ * registers no settings tools, or the host cannot call server tools) releases
+ * the gate at its first failure
+ * with the host-derived values — react-query keeps the query pending through
+ * its retries, which run on in the background; a retry that answers later
+ * still applies live.
+ */
+export declare function ProfileGate({ profileWaitMs, children }: ProfileGateProps): import("react").JSX.Element;
+//# sourceMappingURL=profile-gate.d.ts.map

package/dist/ui/profile-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-gate.d.ts","sourceRoot":"","sources":["../../src/ui/profile-gate.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAoCd,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,gBAAgB,+BAaxE"}

package/dist/ui/profile-gate.js

@@ -0,0 +1,126 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useState, useSyncExternalStore, } from "react";
+import { AppQueryProvider, LocaleProvider, Skeleton, useToolQuery } from "@miragon/mcp-toolkit-ui";
+import { useHostBridge } from "@miragon/mcp-toolkit-ui/app";
+import { getFormatLocale, setFormatLocale, subscribeFormatLocale, } from "./format.js";
+import { formattingLocale, resolveLanguage, validTimeZone } from "./host-context.js";
+import { SHELL_SETTINGS_DATA } from "../shell-settings-contract.js";
+import { kitLabels } from "./kit-labels.js";
+import { SHELL_SETTINGS_KEY } from "./shell-settings.js";
+import { useShellHost } from "./shell-host.js";
+import { useApplyTheme } from "./use-apply-theme.js";
+/**
+ * How long the first paint waits for the profile, counted from the host
+ * connection, before it renders from the host context alone.
+ */
+const PROFILE_WAIT_MS = 1_500;
+/**
+ * How long the first paint waits for the host handshake itself, counted from
+ * mount. Deliberately longer than the profile wait: painting before the host
+ * context arrived is exactly the OS-theme/English flash the gate exists to
+ * prevent, so only a host that never answers `ui/initialize` gets a view
+ * without it.
+ */
+const HOST_WAIT_MS = 5_000;
+/**
+ * Resolves the active user profile once at the app root — the shell's own
+ * feed (`shell_settings_data`), under the key the language section shares
+ * ({@link SHELL_SETTINGS_KEY}), so a saved language re-fetches one entry and
+ * flips every view live (the refetch never re-shows the first-paint
+ * skeleton) — and turns it, with
+ * the host context ({@link useShellHost}), into the view's ONE effective
+ * locale and theme — so every widget is localized and themed with zero
+ * per-widget wiring:
+ *  - language: explicit profile choice > `hostContext.locale` > English;
+ *  - theme: `hostContext.theme` > the OS (applied document-wide by
+ *    {@link useApplyTheme}; there is no in-app theme switch);
+ *  - the shared date formatters follow the same locale and the host's time zone.
+ * The first paint waits for the host handshake (bounded by {@link HOST_WAIT_MS}),
+ * then for the profile (bounded by `profileWaitMs` from the connection) behind
+ * a neutral skeleton, so a German profile or a dark host never flashes English
+ * or the OS theme first. A feed that FAILS (e.g. a root without a profile store
+ * registers no settings tools, or the host cannot call server tools) releases
+ * the gate at its first failure
+ * with the host-derived values — react-query keeps the query pending through
+ * its retries, which run on in the background; a retry that answers later
+ * still applies live.
+ */
+export function ProfileGate({ profileWaitMs, children }) {
+    const { callTool } = useHostBridge();
+    // Adapt the host bridge's `Record<string, unknown>` args to the provider's
+    // `object` signature.
+    const callToolFn = useCallback((name, args) => callTool(name, args), [callTool]);
+    return (_jsx(AppQueryProvider, { callTool: callToolFn, children: _jsx(ProfileGateInner, { profileWaitMs: profileWaitMs, children: children }) }));
+}
+/**
+ * True once `ms` elapsed since `start` first held. The clock starts once and
+ * never restarts, and the result never flips back.
+ */
+function useElapsedSince(start, ms) {
+    const [started, setStarted] = useState(start);
+    if (start && !started)
+        setStarted(true);
+    const [elapsed, setElapsed] = useState(false);
+    useEffect(() => {
+        if (!started)
+            return;
+        const id = setTimeout(() => setElapsed(true), ms);
+        return () => clearTimeout(id);
+    }, [started, ms]);
+    return elapsed;
+}
+/**
+ * Whether the first paint may go ahead. It waits for the host (its theme and
+ * locale), then for the profile's answer: data, an error, or a FIRST failure
+ * (the query stays pending through react-query's retries, ~7 s of backoff on
+ * the toolkit's client) — or for the profile's bound, counted from the
+ * connection. Only a host that never connects paints without its context,
+ * after the longer host bound.
+ */
+function useFirstPaintSettled(connected, profile, profileWaitMs) {
+    const hostWaitedOut = useElapsedSince(true, HOST_WAIT_MS);
+    const profileWaitedOut = useElapsedSince(connected, profileWaitMs);
+    const profileAnswered = !profile.isPending || profile.failureCount > 0 || profileWaitedOut;
+    return (connected && profileAnswered) || hostWaitedOut;
+}
+function ProfileGateInner({ profileWaitMs = PROFILE_WAIT_MS, children, }) {
+    const host = useShellHost();
+    const query = useToolQuery([...SHELL_SETTINGS_KEY], SHELL_SETTINGS_DATA, {});
+    const profile = query.data;
+    const settled = useFirstPaintSettled(host.connected, query, profileWaitMs);
+    useApplyTheme();
+    const language = resolveLanguage(profile?.language, host.locale);
+    const target = useMemo(() => ({
+        language,
+        locale: formattingLocale(language, host.locale),
+        timeZone: validTimeZone(host.timeZone),
+    }), [language, host.locale, host.timeZone]);
+    // Publish before paint: the document language (screen readers — the view
+    // document ships without one) and the formatters' locale. The tree below
+    // reads the PUBLISHED value, so a widget never formats a date in one locale
+    // while its strings render in another.
+    useLayoutEffect(() => {
+        document.documentElement.lang = target.language;
+        setFormatLocale(target);
+    }, [target]);
+    const published = useSyncExternalStore(subscribeFormatLocale, getFormatLocale, getFormatLocale);
+    // Once settled and published, the tree stays mounted for good and only
+    // follows changes (a saved language flips live).
+    const [ready, setReady] = useState(false);
+    if (!ready && settled && isPublished(published, target))
+        setReady(true);
+    if (!ready)
+        return host.connected ? _jsx(GateSkeleton, { language: language }) : null;
+    return _jsx(LocaleProvider, { locale: published?.language ?? language, children: children });
+}
+/** The formatters already render in `target` — the first paint may go ahead. */
+function isPublished(published, target) {
+    return (published?.language === target.language &&
+        published.locale === target.locale &&
+        published.timeZone === target.timeZone);
+}
+/** The pre-paint placeholder: the toolkit view skeleton's shape, no visible text. */
+function GateSkeleton({ language }) {
+    return (_jsxs("div", { className: "flex flex-col gap-4 p-4", "aria-busy": "true", children: [_jsx(Skeleton, { className: "h-8 w-48" }), _jsx(Skeleton, { className: "h-32 w-full" }), _jsx("span", { role: "status", className: "sr-only", children: kitLabels(language).loading })] }));
+}
+//# sourceMappingURL=profile-gate.js.map

package/dist/ui/profile-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-gate.js","sourceRoot":"","sources":["../../src/ui/profile-gate.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,WAAW,EACX,SAAS,EACT,eAAe,EACf,OAAO,EACP,QAAQ,EACR,oBAAoB,GAErB,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAClG,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EACL,eAAe,EACf,eAAe,EACf,qBAAqB,GAEtB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAOpD;;;GAGG;AACH,MAAM,eAAe,GAAG,KAAK,CAAA;AAE7B;;;;;;GAMG;AACH,MAAM,YAAY,GAAG,KAAK,CAAA;AAc1B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAoB;IACvE,MAAM,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,CAAA;IACpC,2EAA2E;IAC3E,sBAAsB;IACtB,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,IAAY,EAAE,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAA+B,CAAC,EAC/E,CAAC,QAAQ,CAAC,CACX,CAAA;IACD,OAAO,CACL,KAAC,gBAAgB,IAAC,QAAQ,EAAE,UAAU,YACpC,KAAC,gBAAgB,IAAC,aAAa,EAAE,aAAa,YAAG,QAAQ,GAAoB,GAC5D,CACpB,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAc,EAAE,EAAU;IACjD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,IAAI,KAAK,IAAI,CAAC,OAAO;QAAE,UAAU,CAAC,IAAI,CAAC,CAAA;IACvC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QACjD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IAC/B,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IACjB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAC3B,SAAkB,EAClB,OAAqD,EACrD,aAAqB;IAErB,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACzD,MAAM,gBAAgB,GAAG,eAAe,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;IAClE,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,YAAY,GAAG,CAAC,IAAI,gBAAgB,CAAA;IAC1F,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC,IAAI,aAAa,CAAA;AACxD,CAAC;AAED,SAAS,gBAAgB,CAAC,EACxB,aAAa,GAAG,eAAe,EAC/B,QAAQ,GACqD;IAC7D,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAG,YAAY,CAAc,CAAC,GAAG,kBAAkB,CAAC,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAA;IACzF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAA;IAC1B,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,CAAA;IAE1E,aAAa,EAAE,CAAA;IACf,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAChE,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ;QACR,MAAM,EAAE,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QAC/C,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;KACvC,CAAC,EACF,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CACvC,CAAA;IACD,yEAAyE;IACzE,yEAAyE;IACzE,4EAA4E;IAC5E,uCAAuC;IACvC,eAAe,CAAC,GAAG,EAAE;QACnB,QAAQ,CAAC,eAAe,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAA;QAC/C,eAAe,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IACZ,MAAM,SAAS,GAAG,oBAAoB,CAAC,qBAAqB,EAAE,eAAe,EAAE,eAAe,CAAC,CAAA;IAE/F,uEAAuE;IACvE,iDAAiD;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IAEvE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAC,YAAY,IAAC,QAAQ,EAAE,QAAQ,GAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IAC/E,OAAO,KAAC,cAAc,IAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,IAAI,QAAQ,YAAG,QAAQ,GAAkB,CAAA;AAC7F,CAAC;AAED,gFAAgF;AAChF,SAAS,WAAW,CAAC,SAAmC,EAAE,MAAoB;IAC5E,OAAO,CACL,SAAS,EAAE,QAAQ,KAAK,MAAM,CAAC,QAAQ;QACvC,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAClC,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CACvC,CAAA;AACH,CAAC;AAED,qFAAqF;AACrF,SAAS,YAAY,CAAC,EAAE,QAAQ,EAAwB;IACtD,OAAO,CACL,eAAK,SAAS,EAAC,yBAAyB,eAAW,MAAM,aACvD,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,GAAG,EACjC,KAAC,QAAQ,IAAC,SAAS,EAAC,aAAa,GAAG,EACpC,eAAM,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,SAAS,YACpC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,GACvB,IACH,CACP,CAAA;AACH,CAAC"}

package/dist/ui/profile-gate.test.d.ts

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

package/dist/ui/profile-gate.test.d.ts.map

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

package/dist/ui/profile-gate.test.js

@@ -0,0 +1,246 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { act, cleanup, render, screen, waitFor } from "@testing-library/react";
+import { queryClient, useLocale } from "@miragon/mcp-toolkit-ui";
+import { HostBridgeProvider } from "@miragon/mcp-toolkit-ui/app";
+import { SHELL_SETTINGS_DATA } from "../shell-settings-contract.js";
+import { ProfileGate } from "./profile-gate.js";
+import { SHELL_SETTINGS_KEY } from "./shell-settings.js";
+import { formatTimestamp, setFormatLocale } from "./format.js";
+import { ShellHostProvider } from "./shell-host.js";
+const FEED = SHELL_SETTINGS_DATA;
+const ISO = "2026-07-22T22:15:30.000Z";
+/** What `shell_settings_data` returns: the `*_data` envelope (structuredContent first). */
+function feedResult(view) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(view) }],
+        structuredContent: view,
+    };
+}
+function bridgeWith(callTool) {
+    return {
+        callTool,
+        sendFollowup: vi.fn(),
+        openExternal: vi.fn(),
+        getWidgetData: () => null,
+    };
+}
+/** The locale the tree reads AND the date the shared formatter renders, in one line. */
+function LocaleProbe() {
+    return _jsx("p", { "data-testid": "locale", children: `${useLocale()}|${formatTimestamp(ISO)}` });
+}
+const NO_HOST = { connected: true, displayMode: "inline", availableDisplayModes: [] };
+function gateTree(callTool, options = {}) {
+    return (_jsx(ShellHostProvider, { host: { ...NO_HOST, ...options.host }, children: _jsx(HostBridgeProvider, { bridge: bridgeWith(callTool), children: _jsx(ProfileGate, { profileWaitMs: options.waitMs, children: _jsx(LocaleProbe, {}) }) }) }));
+}
+function renderGate(callTool, options = {}) {
+    return render(gateTree(callTool, options));
+}
+/** A profile feed that never answers. */
+const neverAnswers = () => new Promise(() => { });
+/** `en|<date in en>` — what the probe shows for a locale (and optional zone). */
+function probeFor(locale, timeZone) {
+    return `${locale.split("-")[0]}|${new Date(ISO).toLocaleString(locale, timeZone ? { timeZone } : {})}`;
+}
+const probe = () => screen.getByTestId("locale").textContent;
+/** Stub `matchMedia` with a fixed OS preference (the theme's last fallback). */
+function stubOsPreference(dark) {
+    vi.stubGlobal("matchMedia", vi.fn().mockReturnValue({
+        matches: dark,
+        addEventListener: vi.fn(),
+        removeEventListener: vi.fn(),
+    }));
+}
+const isDark = () => document.documentElement.classList.contains("dark");
+/** The gate's query, under the feed's module default key (args `{}` appended). */
+const gateQueryStatus = () => queryClient.getQueryState([...SHELL_SETTINGS_KEY, {}])?.status;
+afterEach(async () => {
+    cleanup();
+    vi.useRealTimers();
+    // The toolkit's query client is a module singleton shared by every mount —
+    // the suite runs on its PRODUCTION defaults (react-query's retries
+    // included); cancelling stops any retry still waiting.
+    await queryClient.cancelQueries();
+    queryClient.clear();
+    setFormatLocale(undefined);
+    const root = document.documentElement;
+    root.className = "";
+    root.lang = "";
+    root.removeAttribute("data-theme");
+    root.removeAttribute("style");
+    vi.unstubAllGlobals();
+});
+describe("ProfileGate", () => {
+    it("fetches the profile feed through the host bridge, with no arguments", async () => {
+        const callTool = vi.fn().mockResolvedValue(feedResult({ language: "en" }));
+        renderGate(callTool);
+        await waitFor(() => expect(callTool).toHaveBeenCalledWith(FEED, {}));
+        expect(callTool).toHaveBeenCalledTimes(1);
+    });
+    it("provides the profile locale to the tree, the formatters and the document", async () => {
+        renderGate(vi.fn().mockResolvedValue(feedResult({ language: "de" })));
+        await waitFor(() => expect(probe()).toBe(probeFor("de")));
+        expect(document.documentElement.lang).toBe("de");
+    });
+    it("holds the first paint while the profile loads — a localized skeleton, never English content", () => {
+        renderGate(neverAnswers, { host: { locale: "de-DE" } });
+        expect(screen.queryByTestId("locale")).toBeNull();
+        // The placeholder speaks the host's language already.
+        expect(screen.getByRole("status").textContent).toBe("Wird geladen…");
+        expect(document.documentElement.lang).toBe("de");
+    });
+    it("paints nothing at all until the host bridge is connected", () => {
+        renderGate(neverAnswers, { host: { connected: false } });
+        expect(screen.queryByRole("status")).toBeNull();
+        expect(screen.queryByTestId("locale")).toBeNull();
+    });
+    it("renders from the host context once the bounded wait is over", async () => {
+        renderGate(neverAnswers, { host: { locale: "de-AT" }, waitMs: 20 });
+        await waitFor(() => expect(probe()).toBe(probeFor("de-AT")));
+    });
+    it("counts the profile wait from the host connection — a slow handshake never paints without the host context", () => {
+        vi.useFakeTimers();
+        // Before the handshake the host context is unknown.
+        const view = renderGate(neverAnswers, { host: { connected: false }, waitMs: 100 });
+        // Far past the profile bound, still no handshake: nothing paints — the
+        // content would render in English and the OS theme, then flip.
+        act(() => {
+            vi.advanceTimersByTime(1_000);
+        });
+        expect(screen.queryByTestId("locale")).toBeNull();
+        expect(screen.queryByRole("status")).toBeNull();
+        view.rerender(gateTree(neverAnswers, { host: { connected: true, locale: "de-DE" }, waitMs: 100 }));
+        // Connected: the profile gets its FULL bound behind the localized skeleton …
+        expect(screen.getByRole("status").textContent).toBe("Wird geladen…");
+        act(() => {
+            vi.advanceTimersByTime(99);
+        });
+        expect(screen.queryByTestId("locale")).toBeNull();
+        // … then the view paints from the host context.
+        act(() => {
+            vi.advanceTimersByTime(1);
+        });
+        expect(probe()).toBe(probeFor("de-DE"));
+    });
+    it("paints without any host context only when the host never connects, after its own longer bound", () => {
+        vi.useFakeTimers();
+        renderGate(neverAnswers, { host: { connected: false }, waitMs: 100 });
+        act(() => {
+            vi.advanceTimersByTime(4_999);
+        });
+        expect(screen.queryByTestId("locale")).toBeNull();
+        act(() => {
+            vi.advanceTimersByTime(1);
+        });
+        expect(probe()).toBe(probeFor("en"));
+    });
+    it("follows the host locale for a system profile, normalized to a shipped language", async () => {
+        renderGate(vi.fn().mockResolvedValue(feedResult({ language: "system" })), {
+            host: { locale: "de-AT", timeZone: "Asia/Tokyo" },
+        });
+        // The full host tag drives the dates, the language the strings; the
+        // host's time zone applies to every formatted date.
+        await waitFor(() => expect(probe()).toBe(probeFor("de-AT", "Asia/Tokyo")));
+        expect(document.documentElement.lang).toBe("de");
+        cleanup();
+        queryClient.clear();
+        renderGate(vi.fn().mockResolvedValue(feedResult({ language: "system" })), {
+            host: { locale: "fr-FR" },
+        });
+        await waitFor(() => expect(probe()).toBe(probeFor("en")));
+    });
+    it("an explicit profile language beats the host locale", async () => {
+        renderGate(vi.fn().mockResolvedValue(feedResult({ language: "en" })), {
+            host: { locale: "de-DE" },
+        });
+        // English strings AND English dates — not the host's German conventions.
+        await waitFor(() => expect(probe()).toBe(probeFor("en")));
+        expect(document.documentElement.lang).toBe("en");
+    });
+    it("ignores a time zone the runtime does not know instead of breaking every date", async () => {
+        renderGate(vi.fn().mockResolvedValue(feedResult({ language: "en" })), {
+            host: { timeZone: "Mars/Olympus_Mons" },
+        });
+        await waitFor(() => expect(probe()).toBe(probeFor("en")));
+    });
+    it("never takes the theme from the profile: a stored theme of an earlier build is ignored", async () => {
+        // No in-app theme switch: the host decides, then the OS.
+        stubOsPreference(false);
+        renderGate(vi.fn().mockResolvedValue(feedResult({ theme: "dark" })), {
+            host: { theme: "light" },
+        });
+        await waitFor(() => expect(probe()).not.toBeNull());
+        expect(isDark()).toBe(false);
+        cleanup();
+        queryClient.clear();
+        stubOsPreference(false);
+        renderGate(vi.fn().mockResolvedValue(feedResult({ theme: "light" })), {
+            host: { theme: "dark" },
+        });
+        await waitFor(() => expect(probe()).not.toBeNull());
+        expect(isDark()).toBe(true);
+    });
+    it("follows the HOST theme, even against the OS", async () => {
+        stubOsPreference(false);
+        renderGate(vi.fn().mockResolvedValue(feedResult({ language: "system" })), {
+            host: { theme: "dark" },
+        });
+        await waitFor(() => expect(probe()).not.toBeNull());
+        expect(isDark()).toBe(true);
+        expect(document.documentElement.getAttribute("data-theme")).toBe("dark");
+    });
+    it("falls back to the host locale and the OS theme at the feed's FIRST failure (e.g. the module is disabled)", async () => {
+        stubOsPreference(true);
+        const callTool = vi.fn().mockRejectedValue(new Error("unknown tool"));
+        // A bound far beyond the test: only the failure itself can release the gate.
+        renderGate(callTool, { host: { locale: "de-DE" }, waitMs: 60_000 });
+        await waitFor(() => expect(probe()).toBe(probeFor("de-DE")));
+        expect(isDark()).toBe(true);
+        // The toolkit's client retries (react-query's default 3, backing off from
+        // 1 s) and keeps the query PENDING meanwhile — the view did not wait.
+        expect(gateQueryStatus()).toBe("pending");
+        expect(callTool).toHaveBeenCalledTimes(1);
+    });
+    it("applies a profile that a background retry delivers after the release", async () => {
+        const callTool = vi
+            .fn()
+            .mockRejectedValueOnce(new Error("store briefly unavailable"))
+            .mockResolvedValue(feedResult({ language: "en" }));
+        renderGate(callTool, { host: { locale: "de-DE" }, waitMs: 60_000 });
+        await waitFor(() => expect(probe()).toBe(probeFor("de-DE")));
+        // react-query's first retry fires after 1 s; the tree stays mounted and flips.
+        await waitFor(() => expect(probe()).toBe(probeFor("en")), { timeout: 3_000 });
+        expect(callTool).toHaveBeenCalledTimes(2);
+    });
+    it("flips live when the language section's save invalidates the shared key — no skeleton in between", async () => {
+        const callTool = vi
+            .fn()
+            .mockResolvedValueOnce(feedResult({ language: "en" }))
+            .mockResolvedValue(feedResult({ language: "de" }));
+        renderGate(callTool);
+        await waitFor(() => expect(probe()).toBe(probeFor("en")));
+        const shown = screen.getByTestId("locale");
+        // What the shell's language section does after shell_save_settings.
+        await act(async () => {
+            await queryClient.invalidateQueries({ queryKey: [...SHELL_SETTINGS_KEY] });
+        });
+        await waitFor(() => expect(probe()).toBe(probeFor("de")));
+        expect(callTool).toHaveBeenCalledTimes(2);
+        // The same node: the tree was never swapped for the first-paint skeleton.
+        expect(screen.getByTestId("locale")).toBe(shown);
+        expect(screen.queryByRole("status")).toBeNull();
+    });
+    it("reads the shell's feed under the key the language section shares", async () => {
+        const callTool = vi.fn().mockResolvedValue(feedResult({ language: "de" }));
+        renderGate(callTool);
+        await waitFor(() => expect(probe()).toBe(probeFor("de")));
+        expect(callTool).toHaveBeenCalledWith(SHELL_SETTINGS_DATA, {});
+        const keys = queryClient
+            .getQueryCache()
+            .getAll()
+            .map((q) => q.queryKey[0]);
+        expect(keys).toEqual([SHELL_SETTINGS_KEY[0]]);
+    });
+});
+//# sourceMappingURL=profile-gate.test.js.map

package/dist/ui/profile-gate.test.js.map

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

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

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

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

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

package/dist/ui/query-fallback.js

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

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

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

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

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

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

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