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

package/dist/ui/tone-components.test.js

@@ -0,0 +1,145 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { cleanup, fireEvent, render, screen } from "@testing-library/react";
+import { buttonVariants, LocaleProvider } from "@miragon/mcp-toolkit-ui";
+import { HostBridgeProvider } from "@miragon/mcp-toolkit-ui/app";
+import { TriangleAlert } from "lucide-react";
+import { Icon } from "./icon.js";
+import { OpenInCockpitLink } from "./open-in-cockpit-link.js";
+import { Section } from "./section.js";
+import { SegmentedControl } from "./segmented-control.js";
+import { DEFAULT_HEATMAP_LABELS } from "./bpmn-heatmap-labels.js";
+/**
+ * The kit's OWN tone-aware pieces. The tone model itself (TONE_*, the
+ * vocabulary, MICRO_LABEL) and the components the toolkit ships (KpiGrid,
+ * StatusBadge, LivePill, CountPill, FilterBar, WidgetHeader) are pinned by
+ * the toolkit's own suites since 2.8 (`lib/tone-utils.test.ts`,
+ * `lib/typography.test.ts`, `components/{KpiGrid,Pills,FilterBar,
+ * WidgetHeader,tone-figures}.test.tsx` in @miragon/mcp-toolkit-ui); their
+ * AA contrast over the shipped theme stays here (`tone-contrast.test.ts`).
+ */
+afterEach(cleanup);
+const classes = (el) => (el?.getAttribute("class") ?? "").split(/\s+/);
+describe("heatmap defaults", () => {
+    it("pins the English fallback strings", () => {
+        expect(DEFAULT_HEATMAP_LABELS).toEqual({
+            title: "BPMN heatmap",
+            window: "window:",
+            frequency: "Frequency",
+            duration: "Duration",
+            frequencyLegend: "Executions per element",
+            durationLegend: "Avg duration per element",
+            noData: "No heatmap data.",
+            noHeat: "No metric data in this window.",
+            bpmnUnavailable: "The BPMN diagram is not available. Ask in the chat for the figures per element instead.",
+            less: "Less",
+            more: "More",
+            diagramAriaLabel: "BPMN process diagram with an execution heat overlay",
+            errorTitle: "Diagram could not be rendered",
+        });
+    });
+});
+describe("selection in the info tone (CI: blue contour + tint, black text)", () => {
+    it("SegmentedControl: the pressed segment is the info tint and an inset info contour", () => {
+        render(_jsx(SegmentedControl, { options: [
+                { value: "f", label: "Frequenz" },
+                { value: "d", label: "Dauer" },
+            ], value: "d", onChange: () => { } }));
+        const pressed = screen.getByRole("button", { name: "Dauer" });
+        expect(classes(pressed)).toEqual(expect.arrayContaining([
+            "bg-info-soft",
+            "text-foreground",
+            "ring-1",
+            "ring-inset",
+            "ring-info",
+        ]));
+        expect(classes(pressed)).toContain("focus-visible:ring-focus");
+        expect(classes(screen.getByRole("button", { name: "Frequenz" }))).not.toContain("ring-info");
+    });
+    it("SegmentedControl: segments sit inside the track with concentric corners, no separators", () => {
+        const { container } = render(_jsx(SegmentedControl, { ariaLabel: "Ansicht", options: [
+                { value: "live", label: "Live" },
+                { value: "freq", label: "Frequenz" },
+                { value: "dur", label: "Dauer" },
+            ], value: "live", onChange: () => undefined }));
+        const track = container.firstElementChild;
+        // The contour never touches the track's border, and the track never clips it.
+        expect(classes(track)).toEqual(expect.arrayContaining(["p-0.5", "gap-0.5", "rounded-md"]));
+        expect(classes(track)).not.toContain("overflow-hidden");
+        for (const segment of screen.getAllByRole("button")) {
+            expect(classes(segment)).toContain("rounded-[calc(var(--radius-md)-3px)]");
+            expect(classes(segment).some((c) => c.includes("border-r"))).toBe(false);
+        }
+    });
+});
+describe("icons", () => {
+    it("Icon: decorative 16 px at the CI stroke by default, named when it stands alone, dense opt-in", () => {
+        const { container } = render(_jsxs(_Fragment, { children: [_jsx(Icon, { icon: TriangleAlert }), _jsx(Icon, { icon: TriangleAlert, label: "Warnung", dense: true, size: 24 })] }));
+        const [plain, named] = [...container.querySelectorAll("svg")];
+        expect(plain.getAttribute("aria-hidden")).toBe("true");
+        expect(plain.getAttribute("width")).toBe("16");
+        expect(plain.getAttribute("stroke-width")).toBe("2.5");
+        expect(screen.getByRole("img", { name: "Warnung" })).toBe(named);
+        expect(named.getAttribute("width")).toBe("24");
+        expect(named.getAttribute("stroke-width")).toBe("2");
+    });
+    it("Section rotates a Lucide chevron when open and reports the toggle", () => {
+        const onToggle = vi.fn();
+        const { container } = render(_jsx(Section, { title: "Variablen", count: 2, onToggle: onToggle, children: "x" }));
+        const chevron = container.querySelector("summary svg.lucide-chevron-right");
+        expect(chevron.getAttribute("class")).toContain("[[open]>summary>&]:rotate-90");
+        const details = container.querySelector("details");
+        details.open = true;
+        fireEvent(details, new Event("toggle"));
+        expect(onToggle).toHaveBeenCalledWith(true);
+    });
+});
+describe("OpenInCockpitLink", () => {
+    function renderLink(locale, props) {
+        const openExternal = vi.fn();
+        const bridge = {
+            callTool: vi.fn(),
+            sendFollowup: vi.fn(),
+            openExternal,
+            getWidgetData: () => null,
+        };
+        render(_jsx(HostBridgeProvider, { bridge: bridge, children: _jsx(LocaleProvider, { locale: locale, children: _jsx(OpenInCockpitLink, { url: "https://engine.example/cockpit", ...props }) }) }));
+        return openExternal;
+    }
+    it("is named after the vendor and says that it opens a new tab", () => {
+        renderLink("de", { vendor: "CIB seven" });
+        const link = screen.getByRole("link", { name: "In CIB seven öffnen, öffnet in neuem Tab" });
+        expect(link.textContent).toBe("In CIB seven öffnen");
+        expect(link.querySelector("svg.lucide-external-link")?.getAttribute("aria-hidden")).toBe("true");
+        expect(link.className).not.toContain("text-muted-foreground");
+        // One action size with the buttons beside it: the toolkit's outline button, sm.
+        expect(link.className).toBe(buttonVariants({ variant: "outline", size: "sm" }));
+    });
+    it("falls back to the engine cockpit and honours a caller's label, in English", () => {
+        renderLink("en", {});
+        expect(screen.getByRole("link", { name: "Open in engine cockpit (opens in a new tab)" })).toBeTruthy();
+        cleanup();
+        const openExternal = renderLink("en", {
+            label: "Open instance in Camunda 7",
+            vendor: "Camunda 7",
+        });
+        const link = screen.getByRole("link", {
+            name: "Open instance in Camunda 7 (opens in a new tab)",
+        });
+        fireEvent.click(link);
+        expect(openExternal).toHaveBeenCalledWith("https://engine.example/cockpit");
+    });
+    it("as a menu entry: the same link and name, its icon in front, no outline", () => {
+        const openExternal = renderLink("de", { vendor: "CIB seven", variant: "menuitem" });
+        const item = screen.getByRole("menuitem", { name: "In CIB seven öffnen, öffnet in neuem Tab" });
+        expect(item.tagName).toBe("A");
+        expect(item.getAttribute("href")).toBe("https://engine.example/cockpit");
+        expect(item.getAttribute("tabindex")).toBe("-1");
+        expect(item.firstElementChild?.getAttribute("class")).toContain("lucide-external-link");
+        expect(item.className).not.toContain("border-border");
+        fireEvent.click(item);
+        expect(openExternal).toHaveBeenCalledWith("https://engine.example/cockpit");
+    });
+});
+//# sourceMappingURL=tone-components.test.js.map

package/dist/ui/tone-components.test.js.map

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

package/dist/ui/tone-contrast.test.d.ts

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

package/dist/ui/tone-contrast.test.d.ts.map

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

package/dist/ui/tone-contrast.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it } from "vitest";
+import { ROLE_CONTRAST_PAIRS, contrastFindings, measureContrast, parseThemeVariables, toneContrastPairs, toolkitThemeStylesheets, } from "../testing/index.js";
+/**
+ * The tone model's promise, measured on the theme every view ships — the
+ * toolkit's Miragon theme (`@miragon/mcp-toolkit-ui/theme.css` over the
+ * vendored `--cd-*` tokens), which the shell no longer copies — in light AND
+ * dark: every TONE_* entry reaches WCAG AA for what it is — 4.5:1 for the
+ * text of a tint and the ink, 3:1 for dots, edges and icons (CI
+ * modeler-tool-design §3.3/§3.7). A consumer's override runs the same pairs
+ * over its own stylesheet (see the app's ui-stylesheet test).
+ */
+const shipped = toolkitThemeStylesheets();
+const theme = parseThemeVariables(...shipped);
+/**
+ * The CI's own exemption (§3.3, mirrored by the toolkit's theme test): on a
+ * light ground success green and amber reach only 1.67:1 / 1.83:1, so a status
+ * is never colour alone — every toned dot, edge or icon sits next to words in
+ * the foreground (StatusBadge, KpiGrid, CountPill do that). Their ink is the
+ * foreground, so no TEXT pair is exempt. Shrink-only: a pair that reaches 3:1
+ * fails below until it is deleted here, a new miss fails because it is not
+ * listed.
+ */
+const CI_EXEMPT_LIGHT_STATUS = ["success", "warning"].flatMap((tone) => [
+    `light: TONE_DOT.${tone} on card`,
+    `light: TONE_ICON.${tone} on card`,
+    `light: TONE_BORDER.${tone} on card`,
+    `light: TONE_DOT.${tone} on background`,
+    `light: TONE_ICON.${tone} on background`,
+    `light: TONE_BORDER.${tone} on background`,
+    `light: TONE_DOT.${tone} inside its tint`,
+    `light: TONE_ICON.${tone} inside its tint`,
+]);
+describe("tone contrast (the toolkit's Miragon theme, light + dark)", () => {
+    it("measures every TONE_* entry in both modes", () => {
+        const results = measureContrast(theme, toneContrastPairs());
+        // 5 tones × (2 surfaces × 4–5 roles + 3 tint pairs), each in two modes.
+        expect(results.length).toBeGreaterThanOrEqual(5 * 11 * 2);
+        expect(new Set(results.map((r) => r.mode))).toEqual(new Set(["light", "dark"]));
+    });
+    it("every TONE_* entry reaches its minimum, apart from the CI's light status exemption", () => {
+        expect(contrastFindings(theme, toneContrastPairs()).sort()).toEqual([...CI_EXEMPT_LIGHT_STATUS].sort());
+    });
+    it("measures a light-only brand override in dark too, where html.dark sees it", () => {
+        // A light-only `:root` override (the template brand.css's example without
+        // its dark block): the light navy reaches the dark card in the browser,
+        // so the guard must fail; with the dark repeat it passes. A customer
+        // brand is the test data here, not a Miragon UI colour.
+        /* brand-lint-disable */
+        const light = ":root { --info: #0055aa; --info-soft: #e6f0fa; --info-ink: #0055aa; }";
+        const dark = ".dark { --info: #6b9ce0; --info-soft: transparent; --info-ink: #6b9ce0; }";
+        /* brand-lint-enable */
+        const findings = contrastFindings(parseThemeVariables(...shipped, light), toneContrastPairs());
+        expect(findings).toContain("dark: TONE_INK.info on card");
+        expect(findings.filter((f) => f.startsWith("dark: "))).not.toEqual([]);
+        const repeated = contrastFindings(parseThemeVariables(...shipped, light, dark), toneContrastPairs());
+        expect(repeated.sort()).toEqual([...CI_EXEMPT_LIGHT_STATUS].sort());
+    });
+});
+describe("role contrast (the toolkit's Miragon theme, light + dark)", () => {
+    it("reaches AA on every neutral and interaction role — the interim gaps are gone", () => {
+        // The shadcn neutrals missed it on the input edge (1.26:1) and the quiet
+        // text on muted (4.34:1); the Miragon roles reach 3.40:1 and 5.29:1.
+        expect(contrastFindings(theme, ROLE_CONTRAST_PAIRS)).toEqual([]);
+    });
+});
+//# sourceMappingURL=tone-contrast.test.js.map

package/dist/ui/tone-contrast.test.js.map

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

package/dist/ui/toolkit-overlap.test.d.ts

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

package/dist/ui/toolkit-overlap.test.d.ts.map

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

package/dist/ui/toolkit-overlap.test.js

@@ -0,0 +1,86 @@
+import { createRequire } from "node:module";
+import { dirname, join, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import ts from "typescript";
+import { describe, expect, it } from "vitest";
+/**
+ * ONE kit (toolkit 2.8): the toolkit's components, tone maps, `cn` and hooks
+ * are imported from `@miragon/mcp-toolkit-ui` itself. A widget-shell export
+ * under one of the toolkit's names is either a fork — a second StatusBadge or
+ * KpiGrid that drifts from the toolkit's — or a second import path for the
+ * same piece; neither may come back. Values AND types count (`KpiCell`,
+ * `ToneVariant`, `ViewDataResult` …), so both packages' export lists are read
+ * through the TypeScript compiler — statically, so the check loads none of
+ * the kit's modules (which would count them as uncovered code).
+ */
+const here = dirname(fileURLToPath(import.meta.url));
+const TOOLKIT_DIR = `${sep}@miragon${sep}mcp-toolkit-ui${sep}`;
+/**
+ * The one deliberate pass-through, with its reason. Shrink-only: an entry
+ * leaves when its subpath goes.
+ */
+const PASS_THROUGH = {
+    adaptDataWidget: "the /ui subpath is the module widget registries' one import of the toolkit's data adapter (CLAUDE.md invariant 3)",
+    DescribeForModel: "the type of that adapter's model-context callback, on the same /ui subpath",
+};
+function exportsOf(entry) {
+    const program = ts.createProgram([entry], {
+        module: ts.ModuleKind.NodeNext,
+        moduleResolution: ts.ModuleResolutionKind.NodeNext,
+        target: ts.ScriptTarget.ES2022,
+        jsx: ts.JsxEmit.ReactJSX,
+        noEmit: true,
+        skipLibCheck: true,
+        types: [],
+    });
+    const checker = program.getTypeChecker();
+    const source = program.getSourceFile(entry);
+    if (!source)
+        throw new Error(`cannot read ${entry}`);
+    const moduleSymbol = checker.getSymbolAtLocation(source);
+    if (!moduleSymbol)
+        throw new Error(`${entry} has no exports`);
+    return checker.getExportsOfModule(moduleSymbol).map((symbol) => {
+        const target = symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;
+        const files = (target.declarations ?? []).map((d) => d.getSourceFile().fileName);
+        return {
+            name: symbol.name,
+            fromToolkit: files.some((file) => file.split("/").join(sep).includes(TOOLKIT_DIR)),
+        };
+    });
+}
+/** The toolkit's three entries, as the installed package declares them. */
+function toolkitDeclarations() {
+    const require = createRequire(import.meta.url);
+    // The plain-string `./theme.css` export locates the package root.
+    const root = dirname(dirname(require.resolve("@miragon/mcp-toolkit-ui/theme.css")));
+    return ["dist/index.d.ts", "dist/app/index.d.ts", "dist/hooks/index.d.ts"].map((entry) => join(root, entry));
+}
+const TOOLKIT = new Set(toolkitDeclarations().flatMap((entry) => exportsOf(entry).map((e) => e.name)));
+const WIDGETS = exportsOf(join(here, "index.ts"));
+const UI = exportsOf(join(here, "../adapt-data-widget.tsx"));
+describe("widget-shell exports no toolkit name (one kit, toolkit 2.8)", () => {
+    it("reads both export lists, values and types", () => {
+        // Sanity: the lists are real, so an empty overlap below means something.
+        for (const name of ["KpiGrid", "StatusBadge", "WidgetHeader", "ToneVariant", "useViewData"]) {
+            expect(TOOLKIT.has(name), name).toBe(true);
+        }
+        const kit = WIDGETS.map((e) => e.name);
+        for (const name of ["WidgetShell", "PagedRows", "usePagedViewData", "PagedViewData"]) {
+            expect(kit, name).toContain(name);
+        }
+    });
+    it("the /widgets barrel shares no name with the toolkit — no fork, no second import path", () => {
+        expect(WIDGETS.filter((e) => TOOLKIT.has(e.name)).map((e) => e.name)).toEqual([]);
+    });
+    it("the /widgets barrel re-exports no toolkit piece, under any name", () => {
+        expect(WIDGETS.filter((e) => e.fromToolkit).map((e) => e.name)).toEqual([]);
+    });
+    it("the /ui subpath passes only the listed toolkit pieces through, as the toolkit's own", () => {
+        const shared = UI.filter((e) => TOOLKIT.has(e.name));
+        expect(shared.map((e) => e.name).sort()).toEqual(Object.keys(PASS_THROUGH).sort());
+        // A pass-through is the toolkit's declaration itself, never a look-alike.
+        expect(shared.filter((e) => !e.fromToolkit)).toEqual([]);
+    });
+});
+//# sourceMappingURL=toolkit-overlap.test.js.map

package/dist/ui/toolkit-overlap.test.js.map

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

package/dist/ui/use-apply-theme.d.ts

@@ -0,0 +1,11 @@
+import { type EffectiveTheme } from "./host-context.js";
+/**
+ * Resolve and apply the view's ONE effective theme: the HOST's theme
+ * (`hostContext.theme`, via {@link useShellHost}), else the OS
+ * `prefers-color-scheme` (live). There is no in-app theme switch. Applied
+ * before paint to `.dark`, `data-theme` and `color-scheme` on `<html>`
+ * together, plus the host's neutral palette onto the neutral roles — see
+ * `applyDocumentTheme`. Returns the resolved theme.
+ */
+export declare function useApplyTheme(): EffectiveTheme;
+//# sourceMappingURL=use-apply-theme.d.ts.map

package/dist/ui/use-apply-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-apply-theme.d.ts","sourceRoot":"","sources":["../../src/ui/use-apply-theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAkBzF;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,cAAc,CAY9C"}

package/dist/ui/use-apply-theme.js

@@ -0,0 +1,37 @@
+import { useLayoutEffect, useSyncExternalStore } from "react";
+import { applyDocumentTheme, resolveTheme } from "./host-context.js";
+import { useShellHost } from "./shell-host.js";
+const OS_DARK_QUERY = "(prefers-color-scheme: dark)";
+function osDarkQuery() {
+    if (typeof window === "undefined" || typeof window.matchMedia !== "function")
+        return undefined;
+    return window.matchMedia(OS_DARK_QUERY);
+}
+function subscribeOsTheme(onChange) {
+    const query = osDarkQuery();
+    query?.addEventListener("change", onChange);
+    return () => query?.removeEventListener("change", onChange);
+}
+const osPrefersDark = () => osDarkQuery()?.matches ?? false;
+/**
+ * Resolve and apply the view's ONE effective theme: the HOST's theme
+ * (`hostContext.theme`, via {@link useShellHost}), else the OS
+ * `prefers-color-scheme` (live). There is no in-app theme switch. Applied
+ * before paint to `.dark`, `data-theme` and `color-scheme` on `<html>`
+ * together, plus the host's neutral palette onto the neutral roles — see
+ * `applyDocumentTheme`. Returns the resolved theme.
+ */
+export function useApplyTheme() {
+    const host = useShellHost();
+    const osDark = useSyncExternalStore(subscribeOsTheme, osPrefersDark, () => false);
+    const theme = resolveTheme(host.theme, osDark);
+    useLayoutEffect(() => {
+        applyDocumentTheme(document.documentElement, {
+            theme,
+            hostTheme: host.theme,
+            hostVariables: host.styleVariables,
+        });
+    }, [theme, host.theme, host.styleVariables]);
+    return theme;
+}
+//# sourceMappingURL=use-apply-theme.js.map

package/dist/ui/use-apply-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-apply-theme.js","sourceRoot":"","sources":["../../src/ui/use-apply-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAA;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,aAAa,GAAG,8BAA8B,CAAA;AAEpD,SAAS,WAAW;IAClB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,SAAS,CAAA;IAC9F,OAAO,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAoB;IAC5C,MAAM,KAAK,GAAG,WAAW,EAAE,CAAA;IAC3B,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC3C,OAAO,GAAG,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAC7D,CAAC;AAED,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,IAAI,KAAK,CAAA;AAEpE;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,YAAY,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAG,oBAAoB,CAAC,gBAAgB,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IACjF,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC9C,eAAe,CAAC,GAAG,EAAE;QACnB,kBAAkB,CAAC,QAAQ,CAAC,eAAe,EAAE;YAC3C,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,aAAa,EAAE,IAAI,CAAC,cAAc;SACnC,CAAC,CAAA;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAA;IAC5C,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/ui/use-apply-theme.test.d.ts

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

package/dist/ui/use-apply-theme.test.d.ts.map

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

package/dist/ui/use-apply-theme.test.js

@@ -0,0 +1,102 @@
+// @vitest-environment happy-dom
+import { createElement } from "react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { act, cleanup, renderHook } from "@testing-library/react";
+import { ShellHostProvider } from "./shell-host.js";
+import { useApplyTheme } from "./use-apply-theme.js";
+const root = document.documentElement;
+afterEach(() => {
+    cleanup();
+    root.className = "";
+    root.removeAttribute("data-theme");
+    root.removeAttribute("style");
+    vi.unstubAllGlobals();
+});
+/** Stub `matchMedia` with a fixed OS preference; returns the change-listener registry. */
+function stubOsPreference(dark) {
+    const query = { matches: dark, addEventListener: vi.fn(), removeEventListener: vi.fn() };
+    const matchMedia = vi.fn().mockReturnValue(query);
+    vi.stubGlobal("matchMedia", matchMedia);
+    return { query, matchMedia };
+}
+function inHost(host) {
+    const value = {
+        connected: true,
+        displayMode: "inline",
+        availableDisplayModes: [],
+        ...host,
+    };
+    return ({ children }) => createElement(ShellHostProvider, { host: value, children });
+}
+/** The three document signals that must always agree. */
+const documentTheme = () => ({
+    dark: root.classList.contains("dark"),
+    dataTheme: root.getAttribute("data-theme"),
+    colorScheme: root.style.getPropertyValue("color-scheme"),
+});
+describe("useApplyTheme", () => {
+    it("follows the OS preference outside a host, on .dark, data-theme and color-scheme alike", () => {
+        stubOsPreference(true);
+        const { result } = renderHook(() => useApplyTheme());
+        expect(result.current).toBe("dark");
+        expect(documentTheme()).toEqual({ dark: true, dataTheme: "dark", colorScheme: "dark" });
+        cleanup();
+        stubOsPreference(false);
+        renderHook(() => useApplyTheme());
+        expect(documentTheme()).toEqual({ dark: false, dataTheme: "light", colorScheme: "light" });
+    });
+    it("follows the HOST theme over the OS, both ways (#339: dark host, light OS)", () => {
+        stubOsPreference(false);
+        renderHook(() => useApplyTheme(), { wrapper: inHost({ theme: "dark" }) });
+        expect(documentTheme()).toEqual({ dark: true, dataTheme: "dark", colorScheme: "dark" });
+        cleanup();
+        stubOsPreference(true);
+        renderHook(() => useApplyTheme(), { wrapper: inHost({ theme: "light" }) });
+        expect(documentTheme()).toEqual({ dark: false, dataTheme: "light", colorScheme: "light" });
+    });
+    it("keeps the host's transparent canvas", () => {
+        stubOsPreference(true);
+        renderHook(() => useApplyTheme(), { wrapper: inHost({ theme: "light" }) });
+        expect(root.style.getPropertyValue("background-color")).toBe("");
+    });
+    it("maps the host palette onto the neutral roles only while the host names its theme", () => {
+        stubOsPreference(false);
+        const styleVariables = {
+            "--color-background-primary": "#1f1e1d",
+            "--color-text-primary": "#f5f4ef",
+            "--color-ring-primary": "#c96442",
+        };
+        renderHook(() => useApplyTheme(), {
+            wrapper: inHost({ theme: "dark", styleVariables }),
+        });
+        expect(root.style.getPropertyValue("--card")).toBe("#1f1e1d");
+        expect(root.style.getPropertyValue("--foreground")).toBe("#f5f4ef");
+        // The focus ring stays the theme's.
+        expect(root.style.getPropertyValue("--ring")).toBe("");
+        cleanup();
+        renderHook(() => useApplyTheme(), { wrapper: inHost({ styleVariables }) });
+        // No host theme, so the OS decides — the host's palette does not apply.
+        expect(root.style.getPropertyValue("--card")).toBe("");
+        expect(root.style.getPropertyValue("--foreground")).toBe("");
+    });
+    it("subscribes to the OS dark-mode query while mounted and re-resolves on its change", () => {
+        const { query, matchMedia } = stubOsPreference(false);
+        const { unmount } = renderHook(() => useApplyTheme());
+        expect(matchMedia).toHaveBeenCalledWith("(prefers-color-scheme: dark)");
+        expect(query.addEventListener).toHaveBeenCalledWith("change", expect.any(Function));
+        expect(root.classList.contains("dark")).toBe(false);
+        query.matches = true;
+        const onChange = query.addEventListener.mock.calls[0][1];
+        act(() => onChange());
+        expect(root.classList.contains("dark")).toBe(true);
+        unmount();
+        expect(query.removeEventListener).toHaveBeenCalledWith("change", onChange);
+    });
+    it("resolves light without a matchMedia (no OS signal is no dark signal)", () => {
+        vi.stubGlobal("matchMedia", undefined);
+        const { result } = renderHook(() => useApplyTheme());
+        expect(result.current).toBe("light");
+        expect(root.classList.contains("dark")).toBe(false);
+    });
+});
+//# sourceMappingURL=use-apply-theme.test.js.map

package/dist/ui/use-apply-theme.test.js.map

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