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

package/dist/ui/hand-off-button.test.js

@@ -0,0 +1,78 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { cleanup, render as rtlRender, screen } from "@testing-library/react";
+import { LocaleProvider } from "@miragon/mcp-toolkit-ui";
+import { HostBridgeProvider } from "@miragon/mcp-toolkit-ui/app";
+import { askAiPrompt } from "./ask-ai-prompt.js";
+import { HAND_OFF_ACTIONS, HandOffButton } from "./hand-off-button.js";
+import { KIT_LABELS } from "./kit-labels.js";
+afterEach(cleanup);
+const bridge = {
+    callTool: vi.fn(),
+    sendFollowup: vi.fn(),
+    openExternal: vi.fn(),
+    getWidgetData: () => null,
+};
+/** The button posts through the host bridge; a minimal one is enough to render it. */
+const render = (ui) => rtlRender(_jsx(HostBridgeProvider, { bridge: bridge, children: ui }));
+const prompt = askAiPrompt({
+    intent: "Explain this.",
+    locale: "en",
+    ids: { incidentId: "i1" },
+    surface: { has: () => true },
+});
+/** lucide-react's class for an icon component: `lucide-` + its name in kebab case. */
+const lucideClass = (name) => `lucide-${name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase()}`;
+const ACTIONS = Object.keys(HAND_OFF_ACTIONS);
+describe("HandOffButton: one icon and one verb per function, in every module", () => {
+    it.each(ACTIONS.flatMap((action) => [[action, "en"], [action, "de"]]))("%s (%s)", (action, locale) => {
+        const label = KIT_LABELS[locale].handOff[action];
+        // Every label says where the work happens.
+        expect(label).toMatch(locale === "de" ? /im Chat/i : / in chat$/);
+        const { container } = render(_jsx(LocaleProvider, { locale: locale, children: _jsx(HandOffButton, { action: action, prompt: prompt }) }));
+        expect(screen.getByRole("button", { name: label })).toBeTruthy();
+        const svg = container.querySelector("svg");
+        expect(svg.getAttribute("class")).toContain(lucideClass(HAND_OFF_ACTIONS[action].displayName));
+        expect(svg.getAttribute("aria-hidden")).toBe("true");
+    });
+    it("labels every function in both languages, and no two functions alike", () => {
+        for (const labels of [KIT_LABELS.de.handOff, KIT_LABELS.en.handOff]) {
+            expect(Object.keys(labels).sort()).toEqual([...ACTIONS].sort());
+            expect(new Set(Object.values(labels)).size).toBe(ACTIONS.length);
+        }
+    });
+    it("no two functions share an icon (two hand-offs in one row stay distinguishable)", () => {
+        const icons = Object.values(HAND_OFF_ACTIONS);
+        expect(new Set(icons).size).toBe(icons.length);
+    });
+    // The wording the owner decided (#322 U5): a chat hand-off never looks like
+    // an engine action, and the shared functions read the same in every module.
+    it.each([
+        ["assess", "Im Chat bewerten", "Assess in chat"],
+        ["findCause", "Ursache im Chat klären", "Find cause in chat"],
+        ["planFix", "Behebung im Chat planen", "Plan a fix in chat"],
+        ["explainError", "Fehler im Chat erklären", "Explain error in chat"],
+        ["draftTicket", "Ticket im Chat entwerfen", "Draft ticket in chat"],
+    ])("the decided wording: %s", (action, german, english) => {
+        expect(KIT_LABELS.de.handOff[action]).toBe(german);
+        expect(KIT_LABELS.en.handOff[action]).toBe(english);
+    });
+    it("an icon-only row keeps the label as the accessible name and tooltip", () => {
+        render(_jsx(LocaleProvider, { locale: "de", children: _jsx(HandOffButton, { action: "draftTicket", variant: "icon", prompt: prompt }) }));
+        const button = screen.getByRole("button", { name: "Ticket im Chat entwerfen" });
+        expect(button.getAttribute("title")).toBe("Ticket im Chat entwerfen");
+        expect(button.textContent).toBe("");
+    });
+    it("a row title names its subject in the accessible name and tooltip", () => {
+        render(_jsx(LocaleProvider, { locale: "en", children: _jsx(HandOffButton, { action: "compareEngines", variant: "icon", title: "Compare \u201Corder\u201D across its engines in chat", prompt: prompt }) }));
+        const button = screen.getByRole("button", {
+            name: "Compare “order” across its engines in chat",
+        });
+        expect(button.getAttribute("title")).toBe("Compare “order” across its engines in chat");
+    });
+    it("renders nothing for a hand-off this deployment cannot offer", () => {
+        const { container } = render(_jsx(HandOffButton, { action: "planFix", prompt: null }));
+        expect(container.querySelector("button")).toBeNull();
+    });
+});
+//# sourceMappingURL=hand-off-button.test.js.map

package/dist/ui/hand-off-button.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hand-off-button.test.js","sourceRoot":"","sources":["../../src/ui/hand-off-button.test.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,6BAA6B,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAsB,MAAM,sBAAsB,CAAA;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,SAAS,CAAC,OAAO,CAAC,CAAA;AAElB,MAAM,MAAM,GAAe;IACzB,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;CAC1B,CAAA;AAED,sFAAsF;AACtF,MAAM,MAAM,GAAG,CAAC,EAAa,EAAE,EAAE,CAC/B,SAAS,CAAC,KAAC,kBAAkB,IAAC,MAAM,EAAE,MAAM,YAAG,EAAE,GAAsB,CAAC,CAAA;AAE1E,MAAM,MAAM,GAAG,WAAW,CAAC;IACzB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;IACzB,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;CAC7B,CAAC,CAAA;AAEF,sFAAsF;AACtF,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CACnC,UAAU,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAA;AAEvE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAoB,CAAA;AAEhE,QAAQ,CAAC,oEAAoE,EAAE,GAAG,EAAE;IAClF,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAU,EAAE,CAAC,MAAM,EAAE,IAAI,CAAU,CAAC,CAAC,CAAC,CACtF,SAAS,EACT,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAChD,2CAA2C;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;QACjE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAC1B,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,YAC5B,KAAC,aAAa,IAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAI,GAClC,CAClB,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAA;QAChE,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,CAAC,KAAK,CAAE,CAAA;QAC3C,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CACzC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,WAAY,CAAC,CACnD,CAAA;QACD,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACtD,CAAC,CACF,CAAA;IAED,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,KAAK,MAAM,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YAC/D,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAClE,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAC7C,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,4EAA4E;IAC5E,4EAA4E;IAC5E,EAAE,CAAC,IAAI,CAAC;QACN,CAAC,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,CAAC;QAChD,CAAC,WAAW,EAAE,wBAAwB,EAAE,oBAAoB,CAAC;QAC7D,CAAC,SAAS,EAAE,yBAAyB,EAAE,oBAAoB,CAAC;QAC5D,CAAC,cAAc,EAAE,yBAAyB,EAAE,uBAAuB,CAAC;QACpE,CAAC,aAAa,EAAE,0BAA0B,EAAE,sBAAsB,CAAC;KAC3D,CAAC,CAAC,yBAAyB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClD,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CACJ,KAAC,cAAc,IAAC,MAAM,EAAC,IAAI,YACzB,KAAC,aAAa,IAAC,MAAM,EAAC,aAAa,EAAC,OAAO,EAAC,MAAM,EAAC,MAAM,EAAE,MAAM,GAAI,GACtD,CAClB,CAAA;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,CAAA;QAC/E,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;QACrE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CACJ,KAAC,cAAc,IAAC,MAAM,EAAC,IAAI,YACzB,KAAC,aAAa,IACZ,MAAM,EAAC,gBAAgB,EACvB,OAAO,EAAC,MAAM,EACd,KAAK,EAAC,sDAA4C,EAClD,MAAM,EAAE,MAAM,GACd,GACa,CAClB,CAAA;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE;YACxC,IAAI,EAAE,4CAA4C;SACnD,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAA;IACzF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,KAAC,aAAa,IAAC,MAAM,EAAC,SAAS,EAAC,MAAM,EAAE,IAAI,GAAI,CAAC,CAAA;QAC9E,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACtD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,66 @@
+import { type Locale } from "../profile-constants.js";
+/**
+ * The shell's host-context resolution, pure: which theme and which locale a
+ * view renders in, given what the host reported (SEP-1865 `hostContext`), the
+ * OS and — for the language only — the user's explicit profile choice:
+ *
+ *   theme:     host context  >  OS preference (no in-app theme switch)
+ *   language:  explicit profile choice  >  host context  >  English
+ *
+ * `system` (the profile's language default) is NOT an explicit choice — it
+ * defers to the host. The DOM side lives in `applyDocumentTheme` (below) and
+ * the hooks that feed it (`useApplyTheme`, `ProfileGate`).
+ */
+export type EffectiveTheme = "light" | "dark";
+/** A host-reported theme, or `undefined` when the host reported none (or garbage). */
+export declare function hostThemeOf(value: unknown): EffectiveTheme | undefined;
+/**
+ * The host's theme, else the OS `prefers-color-scheme`. Widgets follow the
+ * host; there is no in-app theme switch (#322 owner decision).
+ */
+export declare function resolveTheme(hostTheme: EffectiveTheme | undefined, osPrefersDark: boolean): EffectiveTheme;
+/**
+ * A BCP 47 tag's language when this build ships a catalog for it
+ * (`de-AT` → `de`, `EN` → `en`), else `undefined` (`fr-FR`, garbage).
+ */
+export declare function supportedLanguage(tag: string | undefined): Locale | undefined;
+/** Explicit profile language > the host's locale (if supported) > English. */
+export declare function resolveLanguage(profileLanguage: string | undefined, hostLocale: string | undefined): Locale;
+/**
+ * The tag the shared formatters render dates in: the host's full tag when it
+ * speaks the effective language (`de-AT` keeps Austrian conventions, `en-GB`
+ * day-first dates), else the bare language — a German profile in an `en-US`
+ * host formats German, not American.
+ */
+export declare function formattingLocale(language: Locale, hostLocale: string | undefined): string;
+/**
+ * The host's IANA time zone when the runtime knows it, else `undefined` (the
+ * browser's own) — an unknown zone would make every formatter throw.
+ */
+export declare function validTimeZone(timeZone: string | undefined): string | undefined;
+/** Every shell token a host variable can drive — cleared when the mapping does not apply. */
+export declare const HOST_MAPPED_TOKENS: readonly string[];
+export type HostStyleVariables = Readonly<Record<string, string | undefined>>;
+/**
+ * The neutral-role overrides the host's style variables imply — empty unless
+ * the view renders in the HOST's theme: the host's palette describes its own
+ * light or dark canvas, so a view on the OS theme (the host reported none)
+ * keeps the Miragon neutrals.
+ */
+export declare function hostTokenOverrides(variables: HostStyleVariables | undefined, followsHost: boolean): Record<string, string>;
+export interface DocumentThemeInput {
+    theme: EffectiveTheme;
+    /** What the host reported; `undefined` outside a host or before it answered. */
+    hostTheme: EffectiveTheme | undefined;
+    hostVariables?: HostStyleVariables;
+}
+/**
+ * Apply ONE effective theme consistently to the document root: the `.dark`
+ * class and `data-theme` (the toolkit theme's dark scope keys on both; SEP-1865
+ * hosts and ext-apps read `data-theme`) and `color-scheme` (native controls,
+ * scrollbars). The canvas stays transparent — the host's. The host's neutral
+ * palette lands on the neutral roles while the view renders in the host's
+ * theme; without a host theme every mapped role is cleared again.
+ */
+export declare function applyDocumentTheme(root: HTMLElement, { theme, hostTheme, hostVariables }: DocumentThemeInput): void;
+//# sourceMappingURL=host-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-context.d.ts","sourceRoot":"","sources":["../../src/ui/host-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAErE;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAEtE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,cAAc,GAAG,SAAS,EACrC,aAAa,EAAE,OAAO,GACrB,cAAc,CAEhB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,CAER;AAWD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGzF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQ9E;AAwBD,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAyC,CAAA;AAEzF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;AAE7E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,kBAAkB,GAAG,SAAS,EACzC,WAAW,EAAE,OAAO,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,CAAA;IACrB,gFAAgF;IAChF,SAAS,EAAE,cAAc,GAAG,SAAS,CAAA;IACrC,aAAa,CAAC,EAAE,kBAAkB,CAAA;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,kBAAkB,GACtD,IAAI,CAUN"}

package/dist/ui/host-context.js

@@ -0,0 +1,122 @@
+import { explicitLocale } from "../profile-constants.js";
+/** A host-reported theme, or `undefined` when the host reported none (or garbage). */
+export function hostThemeOf(value) {
+    return value === "light" || value === "dark" ? value : undefined;
+}
+/**
+ * The host's theme, else the OS `prefers-color-scheme`. Widgets follow the
+ * host; there is no in-app theme switch (#322 owner decision).
+ */
+export function resolveTheme(hostTheme, osPrefersDark) {
+    return hostTheme ?? (osPrefersDark ? "dark" : "light");
+}
+/**
+ * A BCP 47 tag's language when this build ships a catalog for it
+ * (`de-AT` → `de`, `EN` → `en`), else `undefined` (`fr-FR`, garbage).
+ */
+export function supportedLanguage(tag) {
+    return explicitLocale(tag?.split(/[-_]/)[0]?.toLowerCase());
+}
+/** Explicit profile language > the host's locale (if supported) > English. */
+export function resolveLanguage(profileLanguage, hostLocale) {
+    return explicitLocale(profileLanguage) ?? supportedLanguage(hostLocale) ?? "en";
+}
+/** The canonical form of a BCP 47 tag, or `undefined` when it is not one. */
+function canonicalTag(tag) {
+    try {
+        return Intl.getCanonicalLocales(tag)[0];
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The tag the shared formatters render dates in: the host's full tag when it
+ * speaks the effective language (`de-AT` keeps Austrian conventions, `en-GB`
+ * day-first dates), else the bare language — a German profile in an `en-US`
+ * host formats German, not American.
+ */
+export function formattingLocale(language, hostLocale) {
+    if (!hostLocale || supportedLanguage(hostLocale) !== language)
+        return language;
+    return canonicalTag(hostLocale) ?? language;
+}
+/**
+ * The host's IANA time zone when the runtime knows it, else `undefined` (the
+ * browser's own) — an unknown zone would make every formatter throw.
+ */
+export function validTimeZone(timeZone) {
+    if (!timeZone)
+        return undefined;
+    try {
+        new Date(0).toLocaleString("en", { timeZone });
+        return timeZone;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * SEP-1865 host style variables → the NEUTRAL roles they stand for: the
+ * canvas and its surfaces, the text on them and the decorative divider. The
+ * host never sets a brand, interaction or status role — `--primary`, `--link`,
+ * `--focus`, `--ring`, `--input` (the 3:1 control edge), `--accent` (the
+ * selection tint) and every `--<tone>`/`-soft`/`-ink` stay the Miragon
+ * theme's, so a host palette can neither recolour the brand nor drop a focus
+ * ring or a field edge below its contrast floor.
+ */
+const HOST_TOKEN_MAP = {
+    "--color-background-primary": ["--background", "--card", "--popover"],
+    "--color-background-secondary": ["--muted", "--secondary"],
+    "--color-text-primary": [
+        "--foreground",
+        "--card-foreground",
+        "--popover-foreground",
+        "--secondary-foreground",
+    ],
+    "--color-text-secondary": ["--muted-foreground"],
+    "--color-border-primary": ["--border"],
+};
+/** Every shell token a host variable can drive — cleared when the mapping does not apply. */
+export const HOST_MAPPED_TOKENS = Object.values(HOST_TOKEN_MAP).flat();
+/**
+ * The neutral-role overrides the host's style variables imply — empty unless
+ * the view renders in the HOST's theme: the host's palette describes its own
+ * light or dark canvas, so a view on the OS theme (the host reported none)
+ * keeps the Miragon neutrals.
+ */
+export function hostTokenOverrides(variables, followsHost) {
+    const overrides = {};
+    if (!variables || !followsHost)
+        return overrides;
+    for (const [source, tokens] of Object.entries(HOST_TOKEN_MAP)) {
+        const value = variables[source]?.trim();
+        if (!value)
+            continue;
+        for (const token of tokens)
+            overrides[token] = value;
+    }
+    return overrides;
+}
+/**
+ * Apply ONE effective theme consistently to the document root: the `.dark`
+ * class and `data-theme` (the toolkit theme's dark scope keys on both; SEP-1865
+ * hosts and ext-apps read `data-theme`) and `color-scheme` (native controls,
+ * scrollbars). The canvas stays transparent — the host's. The host's neutral
+ * palette lands on the neutral roles while the view renders in the host's
+ * theme; without a host theme every mapped role is cleared again.
+ */
+export function applyDocumentTheme(root, { theme, hostTheme, hostVariables }) {
+    root.classList.toggle("dark", theme === "dark");
+    root.setAttribute("data-theme", theme);
+    root.style.setProperty("color-scheme", theme);
+    const overrides = hostTokenOverrides(hostVariables, hostTheme === theme);
+    for (const token of HOST_MAPPED_TOKENS) {
+        const value = overrides[token];
+        if (value === undefined)
+            root.style.removeProperty(token);
+        else
+            root.style.setProperty(token, value);
+    }
+}
+//# sourceMappingURL=host-context.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,160 @@
+// @vitest-environment happy-dom
+import { describe, expect, it } from "vitest";
+import { applyDocumentTheme, formattingLocale, HOST_MAPPED_TOKENS, hostThemeOf, hostTokenOverrides, resolveLanguage, resolveTheme, supportedLanguage, validTimeZone, } from "./host-context.js";
+describe("resolveTheme — host > OS, no in-app switch", () => {
+    it("the host's theme wins over the OS, both ways", () => {
+        expect(resolveTheme("dark", false)).toBe("dark");
+        expect(resolveTheme("light", true)).toBe("light");
+    });
+    it("without a host theme the OS preference decides", () => {
+        expect(resolveTheme(undefined, true)).toBe("dark");
+        expect(resolveTheme(undefined, false)).toBe("light");
+    });
+    it("reads only a well-formed host theme", () => {
+        expect(hostThemeOf("dark")).toBe("dark");
+        expect(hostThemeOf("light")).toBe("light");
+        expect(hostThemeOf("Dark")).toBeUndefined();
+        expect(hostThemeOf(undefined)).toBeUndefined();
+    });
+});
+describe("resolveLanguage — explicit profile > host locale > English", () => {
+    it("an explicit profile language wins over the host locale", () => {
+        expect(resolveLanguage("en", "de-DE")).toBe("en");
+        expect(resolveLanguage("de", "en-US")).toBe("de");
+    });
+    it("system, a missing profile and an unshipped language follow the host locale", () => {
+        for (const profile of ["system", undefined, "fr"]) {
+            expect(resolveLanguage(profile, "de-AT")).toBe("de");
+        }
+    });
+    it("falls back to English for an unsupported or missing host locale", () => {
+        expect(resolveLanguage("system", "fr-FR")).toBe("en");
+        expect(resolveLanguage(undefined, undefined)).toBe("en");
+        expect(resolveLanguage("system", "")).toBe("en");
+    });
+    it("normalizes a host tag to its shipped language", () => {
+        expect(supportedLanguage("de")).toBe("de");
+        expect(supportedLanguage("DE-ch")).toBe("de");
+        expect(supportedLanguage("en_GB")).toBe("en");
+        expect(supportedLanguage("pt-BR")).toBeUndefined();
+        expect(supportedLanguage(undefined)).toBeUndefined();
+    });
+});
+describe("formattingLocale", () => {
+    it("keeps the host's full tag when it speaks the effective language", () => {
+        expect(formattingLocale("de", "de-AT")).toBe("de-AT");
+        expect(formattingLocale("en", "en-gb")).toBe("en-GB");
+    });
+    it("uses the bare language when the host speaks another one or reports none", () => {
+        expect(formattingLocale("de", "en-US")).toBe("de");
+        expect(formattingLocale("en", undefined)).toBe("en");
+    });
+    it("never hands the formatters a malformed tag", () => {
+        expect(formattingLocale("de", "de-")).toBe("de");
+    });
+});
+describe("validTimeZone", () => {
+    it("passes a zone the runtime knows and drops anything else", () => {
+        expect(validTimeZone("Europe/Berlin")).toBe("Europe/Berlin");
+        expect(validTimeZone("Mars/Olympus_Mons")).toBeUndefined();
+        expect(validTimeZone(undefined)).toBeUndefined();
+        expect(validTimeZone("")).toBeUndefined();
+    });
+});
+describe("hostTokenOverrides", () => {
+    const variables = {
+        "--color-background-primary": "#1f1e1d",
+        "--color-background-secondary": " #2a2927 ",
+        "--color-text-primary": "#f5f4ef",
+        "--color-text-secondary": "#b8b5a9",
+        "--color-border-primary": "#3d3c39",
+        "--color-ring-primary": "#c96442",
+        "--color-text-danger": "#ff0000",
+        "--font-sans": "Inter",
+    };
+    it("maps the host's neutral ramp onto the neutral roles while the view follows the host", () => {
+        expect(hostTokenOverrides(variables, true)).toEqual({
+            "--background": "#1f1e1d",
+            "--card": "#1f1e1d",
+            "--popover": "#1f1e1d",
+            "--muted": "#2a2927",
+            "--secondary": "#2a2927",
+            "--foreground": "#f5f4ef",
+            "--card-foreground": "#f5f4ef",
+            "--popover-foreground": "#f5f4ef",
+            "--secondary-foreground": "#f5f4ef",
+            "--muted-foreground": "#b8b5a9",
+            "--border": "#3d3c39",
+        });
+    });
+    it("never lets the host set a brand, interaction or status role", () => {
+        // The host's ring/border/danger colours stay unmapped: the focus ring,
+        // the 3:1 field edge, the selection tint and the tones are the theme's.
+        const brandRoles = [
+            "--primary",
+            "--primary-foreground",
+            "--primary-hover",
+            "--link",
+            "--focus",
+            "--ring",
+            "--input",
+            "--accent",
+            "--accent-foreground",
+            "--destructive",
+            "--scrim",
+        ];
+        const tones = ["danger", "warning", "success", "info"].flatMap((tone) => [
+            `--${tone}`,
+            `--${tone}-soft`,
+            `--${tone}-ink`,
+        ]);
+        for (const role of [...brandRoles, ...tones])
+            expect(HOST_MAPPED_TOKENS).not.toContain(role);
+        expect(Object.keys(hostTokenOverrides(variables, true))).toEqual(expect.not.arrayContaining([...brandRoles, ...tones]));
+    });
+    it("maps nothing when the view renders in another theme than the host's, or the host sent nothing", () => {
+        expect(hostTokenOverrides(variables, false)).toEqual({});
+        expect(hostTokenOverrides(undefined, true)).toEqual({});
+        expect(hostTokenOverrides({ "--color-background-primary": "  " }, true)).toEqual({});
+    });
+});
+describe("applyDocumentTheme", () => {
+    const root = () => document.createElement("html");
+    const state = (el) => ({
+        dark: el.classList.contains("dark"),
+        dataTheme: el.getAttribute("data-theme"),
+        colorScheme: el.style.getPropertyValue("color-scheme"),
+        background: el.style.getPropertyValue("background-color"),
+    });
+    it("drives .dark, data-theme and color-scheme from ONE theme, both ways, on the host's canvas", () => {
+        const el = root();
+        applyDocumentTheme(el, { theme: "dark", hostTheme: "dark" });
+        expect(state(el)).toEqual({
+            dark: true,
+            dataTheme: "dark",
+            colorScheme: "dark",
+            background: "",
+        });
+        applyDocumentTheme(el, { theme: "light", hostTheme: "light" });
+        expect(state(el)).toEqual({
+            dark: false,
+            dataTheme: "light",
+            colorScheme: "light",
+            background: "",
+        });
+        // Outside a host (the OS decides) the canvas stays transparent too.
+        applyDocumentTheme(el, { theme: "dark", hostTheme: undefined });
+        expect(state(el)).toMatchObject({ dark: true, background: "" });
+    });
+    it("sets the mapped roles while following the host and clears every one of them otherwise", () => {
+        const el = root();
+        const hostVariables = { "--color-background-primary": "#111111" };
+        applyDocumentTheme(el, { theme: "dark", hostTheme: "dark", hostVariables });
+        expect(el.style.getPropertyValue("--background")).toBe("#111111");
+        el.style.setProperty("--muted", "stale");
+        applyDocumentTheme(el, { theme: "light", hostTheme: undefined, hostVariables });
+        for (const token of HOST_MAPPED_TOKENS)
+            expect(el.style.getPropertyValue(token)).toBe("");
+    });
+});
+//# sourceMappingURL=host-context.test.js.map

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

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

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

@@ -0,0 +1,25 @@
+import { type ReactNode } from "react";
+/**
+ * The document layer under every view (replaces mcp-use's `ThemeProvider`,
+ * whose theme channel wrote only `data-theme` from the host/OS and reset
+ * `color-scheme` — the shell's `useApplyTheme` owns the theme now, from ONE
+ * resolution):
+ *  - Geist and Geist Mono are declared once from the server that served the
+ *    view (`declareServedFonts`, `font-display: swap`);
+ *  - the host's SEP-1865 style variables land on `<html>` and its font CSS is
+ *    injected once; right after, the toolkit's `adoptHostFontVariables` moves
+ *    the host's `--font-sans`/`--font-mono` into the fallback slot of the
+ *    theme's font roles (`--host-font-*`), so the stack stays Geist first,
+ *    then the host's font (what renders while Geist loads, or when the host
+ *    blocks the server's origin), then the system;
+ *  - inline views size to their content (auto-resize reports it), their lists
+ *    show as many rows as fit the host's height budget (`containerDimensions`
+ *    → `maxHeight`, else {@link UNSTATED_BUDGET}; the measured fit,
+ *    `InlineFitBox`), and a view that still does not fit a stated budget
+ *    scrolls inside it instead of being clipped;
+ *  - fullscreen/PiP fill the viewport (`html`/`body`/`#root` at 100%).
+ */
+export declare function HostDocument({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=host-document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-document.d.ts","sourceRoot":"","sources":["../../src/ui/host-document.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAmB3E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAmCjE"}

package/dist/ui/host-document.js

@@ -0,0 +1,93 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLayoutEffect } from "react";
+import { adoptHostFontVariables } from "@miragon/mcp-toolkit-ui";
+import { declareServedFonts } from "./declare-served-fonts.js";
+import { InlineFitBox, UNSTATED_BUDGET } from "./inline-fit.js";
+import { useShellHost } from "./shell-host.js";
+const HOST_FONTS_ID = "__mcp-host-fonts";
+/** Fullscreen/PiP: the view owns the viewport — fill it, scroll inside. */
+const FILL_STYLE = {
+    position: "relative",
+    height: "100%",
+    minHeight: "100%",
+    display: "flex",
+    flexDirection: "column",
+};
+/** Inline without a host budget: no box of its own — content decides the height. */
+const INLINE_STYLE = { display: "contents" };
+/**
+ * The document layer under every view (replaces mcp-use's `ThemeProvider`,
+ * whose theme channel wrote only `data-theme` from the host/OS and reset
+ * `color-scheme` — the shell's `useApplyTheme` owns the theme now, from ONE
+ * resolution):
+ *  - Geist and Geist Mono are declared once from the server that served the
+ *    view (`declareServedFonts`, `font-display: swap`);
+ *  - the host's SEP-1865 style variables land on `<html>` and its font CSS is
+ *    injected once; right after, the toolkit's `adoptHostFontVariables` moves
+ *    the host's `--font-sans`/`--font-mono` into the fallback slot of the
+ *    theme's font roles (`--host-font-*`), so the stack stays Geist first,
+ *    then the host's font (what renders while Geist loads, or when the host
+ *    blocks the server's origin), then the system;
+ *  - inline views size to their content (auto-resize reports it), their lists
+ *    show as many rows as fit the host's height budget (`containerDimensions`
+ *    → `maxHeight`, else {@link UNSTATED_BUDGET}; the measured fit,
+ *    `InlineFitBox`), and a view that still does not fit a stated budget
+ *    scrolls inside it instead of being clipped;
+ *  - fullscreen/PiP fill the viewport (`html`/`body`/`#root` at 100%).
+ */
+export function HostDocument({ children }) {
+    const { styleVariables, fontCss, displayMode, maxHeight } = useShellHost();
+    useLayoutEffect(() => {
+        declareServedFonts();
+    }, []);
+    useLayoutEffect(() => {
+        if (!styleVariables)
+            return;
+        const root = document.documentElement;
+        for (const [name, value] of Object.entries(styleVariables)) {
+            if (value !== undefined)
+                root.style.setProperty(name, value);
+        }
+        adoptHostFontVariables(root.style, styleVariables);
+    }, [styleVariables]);
+    useLayoutEffect(() => {
+        if (!fontCss || document.getElementById(HOST_FONTS_ID))
+            return;
+        const style = document.createElement("style");
+        style.id = HOST_FONTS_ID;
+        style.textContent = fontCss;
+        document.head.appendChild(style);
+    }, [fontCss]);
+    const fill = displayMode === "fullscreen" || displayMode === "pip";
+    useFillDocument(fill);
+    let style = INLINE_STYLE;
+    if (fill)
+        style = FILL_STYLE;
+    else if (maxHeight !== undefined)
+        style = { maxHeight, overflowY: "auto" };
+    return (_jsx(InlineFitBox, { active: !fill, budget: maxHeight ?? UNSTATED_BUDGET, style: style, children: children }));
+}
+/** `html`/`body`/`#root` at 100% while the view fills the host; restored on exit. */
+function useFillDocument(fill) {
+    useLayoutEffect(() => {
+        if (!fill)
+            return;
+        const elements = [
+            document.documentElement,
+            document.body,
+            document.getElementById("root"),
+        ].filter((el) => el !== null);
+        const previous = elements.map((el) => [el.style.height, el.style.minHeight]);
+        for (const el of elements) {
+            el.style.height = "100%";
+            el.style.minHeight = "100%";
+        }
+        return () => {
+            elements.forEach((el, i) => {
+                el.style.height = previous[i][0];
+                el.style.minHeight = previous[i][1];
+            });
+        };
+    }, [fill]);
+}
+//# sourceMappingURL=host-document.js.map

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

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

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

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

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

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