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

package/dist/ui/format.test.js

@@ -0,0 +1,181 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { formatDate, formatDuration, formatNumber, formatPercent, formatPercentPoints, formatPeriod, formatTime, formatTimestamp, getFormatLocale, setFormatLocale, subscribeFormatLocale, truncate, } from "./format.js";
+const EMPTY = "—";
+afterEach(() => setFormatLocale(undefined));
+describe("the published format locale (set by the shell's ProfileGate)", () => {
+    const iso = "2026-07-22T22:15:30.000Z";
+    it("renders every date helper in the published locale and time zone, not the browser's", () => {
+        setFormatLocale({ language: "de", locale: "de-AT", timeZone: "Asia/Tokyo" });
+        const date = new Date(iso);
+        expect(formatTimestamp(iso)).toBe(date.toLocaleString("de-AT", { timeZone: "Asia/Tokyo" }));
+        expect(formatDate(iso)).toBe(date.toLocaleDateString("de-AT", { timeZone: "Asia/Tokyo" }));
+        expect(formatTime(iso)).toBe(date.toLocaleTimeString("de-AT", { timeZone: "Asia/Tokyo" }));
+        expect(formatTime(iso, { seconds: false })).toBe(date.toLocaleTimeString("de-AT", {
+            hour: "2-digit",
+            minute: "2-digit",
+            timeZone: "Asia/Tokyo",
+        }));
+        // The zone moves the calendar day: 22:15 UTC is already the 23rd in Tokyo.
+        expect(formatDate(iso)).toContain("23");
+    });
+    it("keeps the browser's zone when none is published", () => {
+        setFormatLocale({ language: "en", locale: "en-GB" });
+        expect(formatTimestamp(iso)).toBe(new Date(iso).toLocaleString("en-GB"));
+    });
+    it("notifies subscribers on a real change only, and stops after unsubscribe", () => {
+        const listener = vi.fn();
+        const unsubscribe = subscribeFormatLocale(listener);
+        setFormatLocale({ language: "de", locale: "de" });
+        setFormatLocale({ language: "de", locale: "de" });
+        expect(listener).toHaveBeenCalledTimes(1);
+        expect(getFormatLocale()).toEqual({ language: "de", locale: "de" });
+        setFormatLocale({ language: "de", locale: "de", timeZone: "Europe/Berlin" });
+        expect(listener).toHaveBeenCalledTimes(2);
+        unsubscribe();
+        setFormatLocale(undefined);
+        expect(listener).toHaveBeenCalledTimes(2);
+        expect(getFormatLocale()).toBeUndefined();
+    });
+});
+describe("formatTimestamp / formatDate / formatTime", () => {
+    it("renders a valid ISO timestamp", () => {
+        const iso = "2026-07-22T10:15:30.000Z";
+        // No published locale: the browser's own, spelled out (an argument-less or
+        // `undefined` toLocaleString is what the kit's number gate bans).
+        const browserLocale = new Intl.DateTimeFormat().resolvedOptions().locale;
+        expect(formatTimestamp(iso)).toBe(new Date(iso).toLocaleString(browserLocale));
+        expect(formatDate(iso)).toBe(new Date(iso).toLocaleDateString());
+        expect(formatTime(iso)).toBe(new Date(iso).toLocaleTimeString());
+    });
+    it("returns the placeholder for null/undefined/empty input", () => {
+        for (const value of [null, undefined, ""]) {
+            expect(formatTimestamp(value)).toBe(EMPTY);
+            expect(formatDate(value)).toBe(EMPTY);
+            expect(formatTime(value)).toBe(EMPTY);
+        }
+    });
+    it("returns the placeholder for an unparsable date instead of 'Invalid Date'", () => {
+        expect(formatTimestamp("not-a-date")).toBe(EMPTY);
+        expect(formatDate("not-a-date")).toBe(EMPTY);
+        expect(formatTime("not-a-date")).toBe(EMPTY);
+    });
+});
+describe("formatDuration", () => {
+    it("formats the canonical compact family", () => {
+        expect(formatDuration(420)).toBe("420ms");
+        expect(formatDuration(12_000)).toBe("12s");
+        expect(formatDuration(187_000)).toBe("3m 7s");
+        expect(formatDuration(5_040_000)).toBe("1h 24m");
+    });
+    it("rounds fractional milliseconds", () => {
+        expect(formatDuration(420.4)).toBe("420ms");
+        expect(formatDuration(999.6)).toBe("1s");
+    });
+    it("returns the placeholder for null, negative and NaN input", () => {
+        expect(formatDuration(null)).toBe(EMPTY);
+        expect(formatDuration(undefined)).toBe(EMPTY);
+        expect(formatDuration(-1)).toBe(EMPTY);
+        expect(formatDuration(Number.NaN)).toBe(EMPTY);
+    });
+    it("speaks German units in a German view: a space before the unit, never wrapping", () => {
+        setFormatLocale({ language: "de", locale: "de-DE" });
+        expect(formatDuration(420)).toBe(`420${NBSP}ms`);
+        expect(formatDuration(12_000)).toBe(`12${NBSP}s`);
+        expect(formatDuration(187_000)).toBe(`3${NBSP}Min. 7${NBSP}s`);
+        expect(formatDuration(5_040_000)).toBe(`1${NBSP}h 24${NBSP}Min.`);
+        expect(formatDuration(3_600_000 * 1234)).toBe(`1.234${NBSP}h 0${NBSP}Min.`);
+    });
+    it("keeps the compact English family in an English view, grouped by the locale", () => {
+        setFormatLocale({ language: "en", locale: "en-US" });
+        expect(formatDuration(187_000)).toBe("3m 7s");
+        expect(formatDuration(3_600_000 * 1234)).toBe("1,234h 0m");
+    });
+});
+const NBSP = " ";
+describe("formatNumber", () => {
+    it("groups and separates decimals in the view's locale", () => {
+        setFormatLocale({ language: "de", locale: "de-DE" });
+        expect(formatNumber(1234567.5)).toBe("1.234.567,5");
+        expect(formatNumber(0.25, { style: "percent" })).toBe(`25${NBSP}%`);
+        setFormatLocale({ language: "en", locale: "en-US" });
+        expect(formatNumber(1234567.5)).toBe("1,234,567.5");
+        expect(formatNumber(1234.567, { maximumFractionDigits: 1 })).toBe("1,234.6");
+    });
+    it("returns the placeholder for missing and non-finite values, 0 stays 0", () => {
+        for (const value of [null, undefined, Number.NaN, Number.POSITIVE_INFINITY]) {
+            expect(formatNumber(value)).toBe(EMPTY);
+        }
+        expect(formatNumber(0)).toBe("0");
+    });
+});
+describe("formatPercent / formatPercentPoints", () => {
+    it("formats percent units: 3,7 % in German, 3.7% in English", () => {
+        setFormatLocale({ language: "de", locale: "de-DE" });
+        expect(formatPercent(3.7)).toBe(`3,7${NBSP}%`);
+        expect(formatPercent(3)).toBe(`3${NBSP}%`);
+        expect(formatPercent(3, { minimumFractionDigits: 1 })).toBe(`3,0${NBSP}%`);
+        expect(formatPercent(-84.66, { signed: true })).toBe(`-84,7${NBSP}%`);
+        expect(formatPercent(12.345, { maximumFractionDigits: 2 })).toBe(`12,35${NBSP}%`);
+        setFormatLocale({ language: "en", locale: "en-US" });
+        expect(formatPercent(3.7)).toBe("3.7%");
+        expect(formatPercent(427.4, { signed: true })).toBe("+427.4%");
+        expect(formatPercent(0, { signed: true })).toBe("0%");
+    });
+    it("formats percentage points signed by default: +0,2 Pp. / +0.2 pp", () => {
+        setFormatLocale({ language: "de", locale: "de-DE" });
+        expect(formatPercentPoints(0.2)).toBe(`+0,2${NBSP}Pp.`);
+        expect(formatPercentPoints(-1.25)).toBe(`-1,3${NBSP}Pp.`);
+        expect(formatPercentPoints(0)).toBe(`0${NBSP}Pp.`);
+        setFormatLocale({ language: "en", locale: "en-GB" });
+        expect(formatPercentPoints(0.2)).toBe(`+0.2${NBSP}pp`);
+        expect(formatPercentPoints(0.2, { signed: false })).toBe(`0.2${NBSP}pp`);
+    });
+    it("raises the default maximum to a larger minimum instead of throwing during render", () => {
+        // `rate.toFixed(2) + "%"` migrated naturally: the default maximum of 1
+        // would sit below the minimum, which Intl rejects with a RangeError.
+        setFormatLocale({ language: "de", locale: "de-DE" });
+        expect(formatPercent(3.75, { minimumFractionDigits: 2 })).toBe(`3,75${NBSP}%`);
+        expect(formatPercentPoints(0.25, { minimumFractionDigits: 2 })).toBe(`+0,25${NBSP}Pp.`);
+        setFormatLocale({ language: "en", locale: "en-US" });
+        expect(formatPercent(3.7, { minimumFractionDigits: 3 })).toBe("3.700%");
+        expect(formatPercent(3.75, { minimumFractionDigits: 2, maximumFractionDigits: 1 })).toBe("3.75%");
+    });
+    it("returns the placeholder for a missing value", () => {
+        expect(formatPercent(null)).toBe(EMPTY);
+        expect(formatPercentPoints(undefined)).toBe(EMPTY);
+        expect(formatPercent(Number.NaN)).toBe(EMPTY);
+    });
+});
+describe("formatPeriod", () => {
+    it("spells a period token in the view's language, singular and plural", () => {
+        setFormatLocale({ language: "de", locale: "de-DE" });
+        expect(formatPeriod("7d")).toBe(`7${NBSP}Tage`);
+        expect(formatPeriod("1d")).toBe(`1${NBSP}Tag`);
+        expect(formatPeriod("24h")).toBe(`24${NBSP}Stunden`);
+        expect(formatPeriod("1H")).toBe(`1${NBSP}Stunde`);
+        expect(formatPeriod("30m")).toBe(`30${NBSP}Minuten`);
+        expect(formatPeriod("2w")).toBe(`2${NBSP}Wochen`);
+        setFormatLocale({ language: "en", locale: "en-US" });
+        expect(formatPeriod("7d")).toBe(`7${NBSP}days`);
+        expect(formatPeriod("1w")).toBe(`1${NBSP}week`);
+        expect(formatPeriod(" 14d ")).toBe(`14${NBSP}days`);
+    });
+    it("passes anything else through and renders the placeholder for no period", () => {
+        expect(formatPeriod("last quarter")).toBe("last quarter");
+        expect(formatPeriod("7y")).toBe("7y");
+        expect(formatPeriod("")).toBe(EMPTY);
+        expect(formatPeriod(null)).toBe(EMPTY);
+    });
+    it("speaks English while no locale is published (fixtures, unit renders)", () => {
+        expect(formatPeriod("3d")).toBe(`3${NBSP}days`);
+        expect(formatPercentPoints(1)).toContain("pp");
+    });
+});
+describe("truncate", () => {
+    it("truncates with an ellipsis and passes short values through", () => {
+        expect(truncate("abcdef", 3)).toBe("abc…");
+        expect(truncate("abc", 3)).toBe("abc");
+        expect(truncate(null, 3)).toBe(EMPTY);
+    });
+});
+//# sourceMappingURL=format.test.js.map

package/dist/ui/format.test.js.map

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

package/dist/ui/generic-widgets.d.ts

@@ -0,0 +1,15 @@
+import type { WidgetProps } from "@miragon/mcp-toolkit-core";
+/**
+ * `shell:kpi-grid` — renders `keys[props.dataKey]` as a KPI strip.
+ * widgetProps: `dataKey` (required), `boxed?`, `variant?` ("strip" | "soft"),
+ * `emptyText?`.
+ */
+export declare function GenericKpiGridWidget({ keys, widgetProps }: WidgetProps): import("react").JSX.Element;
+/**
+ * `shell:data-table` — renders `keys[props.dataKey]` (an array of records, or
+ * `{ rows: [...] }`) as a cockpit-style table. widgetProps: `dataKey`
+ * (required), `columns?` (`[{ key, label?, align? }]`, derived from the first
+ * row when omitted; a missing `label` is the key in words), `emptyText?`.
+ */
+export declare function GenericDataTableWidget({ keys, widgetProps }: WidgetProps): import("react").JSX.Element;
+//# sourceMappingURL=generic-widgets.d.ts.map

package/dist/ui/generic-widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-widgets.d.ts","sourceRoot":"","sources":["../../src/ui/generic-widgets.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAgE5D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,WAAW,+BAkBtE;AAsCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,WAAW,+BAmCxE"}

package/dist/ui/generic-widgets.js

@@ -0,0 +1,122 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { KpiGrid, resolveTone, useLocale } from "@miragon/mcp-toolkit-ui";
+import { humanizeKey } from "./humanize-key.js";
+import { kitLabels } from "./kit-labels.js";
+import { ListTable } from "./list-table.js";
+import { TableEmptyState, Td } from "./table.js";
+/**
+ * Module-agnostic widgets — the standard composition targets for
+ * `render-view` and the visual builder: any module or pipeline step produces
+ * a context key with plain data, and a layout cell points a generic widget at
+ * it via `props.dataKey` — no custom widget needed for a standard KPI row or
+ * data table.
+ *
+ * Registered by the server app under the `shell:` namespace (see
+ * `../shell-catalogue.ts`, exported via `@miragon/pulse-widget-shell/server`). Their texts arrive via
+ * props; what they say themselves (the empty state, a Boolean's "Yes"/"No",
+ * the table's name) follows the active locale through `kitLabels`.
+ */
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isPrimitive(v) {
+    return typeof v === "string" || typeof v === "number" || typeof v === "boolean";
+}
+/** A cell as shown: numbers and text as they are, a Boolean in words, anything else a dash. */
+function cellValue(v, words) {
+    if (typeof v === "number")
+        return v;
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "boolean")
+        return v ? words.yes : words.no;
+    return "—";
+}
+/**
+ * Accepts either an array of `{ label, value, tone?, fraction? }` cells or a
+ * plain `{ label: value }` object; everything else renders as empty.
+ */
+function coerceKpiCells(raw, words) {
+    if (Array.isArray(raw)) {
+        return raw
+            .filter(isRecord)
+            .filter((r) => typeof r.label === "string" && r.label.length > 0)
+            .map((r) => ({
+            label: r.label,
+            value: cellValue(r.value, words),
+            // A tone from the wire: the five tones as is, a retired name
+            // (`critical`) onto its tone, anything else neutral (no dot).
+            tone: typeof r.tone === "string" ? resolveTone(r.tone) : undefined,
+            fraction: typeof r.fraction === "string" ? r.fraction : undefined,
+        }));
+    }
+    if (isRecord(raw)) {
+        return Object.entries(raw)
+            .filter(([, v]) => isPrimitive(v))
+            .map(([label, v]) => ({ label, value: cellValue(v, words) }));
+    }
+    return [];
+}
+/**
+ * `shell:kpi-grid` — renders `keys[props.dataKey]` as a KPI strip.
+ * widgetProps: `dataKey` (required), `boxed?`, `variant?` ("strip" | "soft"),
+ * `emptyText?`.
+ */
+export function GenericKpiGridWidget({ keys, widgetProps }) {
+    const labels = kitLabels(useLocale());
+    const dataKey = typeof widgetProps?.dataKey === "string" ? widgetProps.dataKey : undefined;
+    const cells = coerceKpiCells(dataKey ? keys[dataKey] : undefined, labels);
+    if (cells.length === 0) {
+        return typeof widgetProps?.emptyText === "string" ? (_jsx(TableEmptyState, { children: widgetProps.emptyText })) : (_jsx(TableEmptyState, { description: labels.noDataHint, children: labels.noFiguresYet }));
+    }
+    return (_jsx(KpiGrid, { cells: cells, boxed: widgetProps?.boxed === true, variant: widgetProps?.variant === "soft" ? "soft" : "strip" }));
+}
+/**
+ * The table's columns: the `columns` prop as given, else the first row's
+ * primitive fields. A header nobody wrote is the key in words ("Total
+ * incidents" for `totalIncidents`); a written `label` stays as it is.
+ */
+function coerceColumns(raw, rows) {
+    if (Array.isArray(raw)) {
+        const cols = raw
+            .filter(isRecord)
+            .filter((c) => typeof c.key === "string" && c.key.length > 0)
+            .map((c) => ({
+            key: c.key,
+            label: typeof c.label === "string" ? c.label : humanizeKey(c.key),
+            align: c.align === "right" ? "right" : "left",
+        }));
+        if (cols.length > 0)
+            return cols;
+    }
+    // Derive from the first row: primitive-valued keys, capped for readability.
+    const first = rows[0];
+    if (!first)
+        return [];
+    return Object.keys(first)
+        .filter((k) => isPrimitive(first[k]) || first[k] === null)
+        .slice(0, 8)
+        .map((key) => ({
+        key,
+        label: humanizeKey(key),
+        align: typeof first[key] === "number" ? "right" : "left",
+    }));
+}
+/**
+ * `shell:data-table` — renders `keys[props.dataKey]` (an array of records, or
+ * `{ rows: [...] }`) as a cockpit-style table. widgetProps: `dataKey`
+ * (required), `columns?` (`[{ key, label?, align? }]`, derived from the first
+ * row when omitted; a missing `label` is the key in words), `emptyText?`.
+ */
+export function GenericDataTableWidget({ keys, widgetProps }) {
+    const labels = kitLabels(useLocale());
+    const dataKey = typeof widgetProps?.dataKey === "string" ? widgetProps.dataKey : undefined;
+    const raw = dataKey ? keys[dataKey] : undefined;
+    const rows = (Array.isArray(raw) ? raw : isRecord(raw) && Array.isArray(raw.rows) ? raw.rows : []).filter(isRecord);
+    const columns = coerceColumns(widgetProps?.columns, rows);
+    if (rows.length === 0 || columns.length === 0) {
+        return typeof widgetProps?.emptyText === "string" ? (_jsx(TableEmptyState, { children: widgetProps.emptyText })) : (_jsx(TableEmptyState, { description: labels.noDataHint, children: labels.noRowsYet }));
+    }
+    return (_jsx("div", { className: "border-border overflow-hidden rounded-md border", children: _jsx(ListTable, { ariaLabel: labels.dataTable, columns: columns.map((col) => ({ label: col.label, align: col.align })), children: rows.map((row, i) => (_jsx("tr", { children: columns.map((col) => (_jsx(Td, { align: col.align, children: cellValue(row[col.key], labels) }, col.key))) }, i))) }) }));
+}
+//# sourceMappingURL=generic-widgets.js.map

package/dist/ui/generic-widgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-widgets.js","sourceRoot":"","sources":["../../src/ui/generic-widgets.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAgB,MAAM,yBAAyB,CAAA;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;;;GAWG;AAEH,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AACjE,CAAC;AAED,SAAS,WAAW,CAAC,CAAU;IAC7B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS,CAAA;AACjF,CAAC;AAID,+FAA+F;AAC/F,SAAS,SAAS,CAAC,CAAU,EAAE,KAAY;IACzC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAA;IACnC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAA;IACnC,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAA;IAC3D,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,GAAY,EAAE,KAAY;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG;aACP,MAAM,CAAC,QAAQ,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;aAChE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,KAAK,EAAE,CAAC,CAAC,KAAe;YACxB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC;YAChC,6DAA6D;YAC7D,8DAA8D;YAC9D,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YAClE,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SAClE,CAAC,CAAC,CAAA;IACP,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;aACvB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAe;IACrE,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,OAAO,WAAW,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAC1F,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,OAAO,WAAW,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAClD,KAAC,eAAe,cAAE,WAAW,CAAC,SAAS,GAAmB,CAC3D,CAAC,CAAC,CAAC,CACF,KAAC,eAAe,IAAC,WAAW,EAAE,MAAM,CAAC,UAAU,YAAG,MAAM,CAAC,YAAY,GAAmB,CACzF,CAAA;IACH,CAAC;IACD,OAAO,CACL,KAAC,OAAO,IACN,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,WAAW,EAAE,KAAK,KAAK,IAAI,EAClC,OAAO,EAAE,WAAW,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAC3D,CACH,CAAA;AACH,CAAC;AAQD;;;;GAIG;AACH,SAAS,aAAa,CAAC,GAAY,EAAE,IAA+B;IAClE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG;aACb,MAAM,CAAC,QAAQ,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;aAC5D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,GAAG,EAAE,CAAC,CAAC,GAAa;YACpB,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAa,CAAC;YAC3E,KAAK,EAAE,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAE,MAAgB;SACpE,CAAC,CAAC,CAAA;QACL,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;IAClC,CAAC;IACD,4EAA4E;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACrB,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;SACzD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,GAAG;QACH,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC;QACvB,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAE,MAAgB;KAC/E,CAAC,CAAC,CAAA;AACP,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAe;IACvE,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,OAAO,WAAW,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAC1F,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC/C,MAAM,IAAI,GAAG,CACX,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACpF,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAClB,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAEzD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,OAAO,WAAW,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAClD,KAAC,eAAe,cAAE,WAAW,CAAC,SAAS,GAAmB,CAC3D,CAAC,CAAC,CAAC,CACF,KAAC,eAAe,IAAC,WAAW,EAAE,MAAM,CAAC,UAAU,YAAG,MAAM,CAAC,SAAS,GAAmB,CACtF,CAAA;IACH,CAAC;IAED,OAAO,CACL,cAAK,SAAS,EAAC,iDAAiD,YAC9D,KAAC,SAAS,IACR,SAAS,EAAE,MAAM,CAAC,SAAS,EAC3B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,YAEtE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CACpB,uBACG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACpB,KAAC,EAAE,IAAe,KAAK,EAAE,GAAG,CAAC,KAAK,YAC/B,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,IADzB,GAAG,CAAC,GAAG,CAEX,CACN,CAAC,IALK,CAAC,CAML,CACN,CAAC,GACQ,GACR,CACP,CAAA;AACH,CAAC"}

package/dist/ui/generic-widgets.test.d.ts

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

package/dist/ui/generic-widgets.test.d.ts.map

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

package/dist/ui/generic-widgets.test.js

@@ -0,0 +1,139 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it } from "vitest";
+import { cleanup, render, screen } from "@testing-library/react";
+import { GenericDataTableWidget, GenericKpiGridWidget } from "./generic-widgets.js";
+/**
+ * The `shell:*` widgets are render-view and builder targets: they render
+ * whatever plain data a context key holds, and what they show reads for
+ * people, also when nobody wrote the labels (#322 U18).
+ */
+afterEach(cleanup);
+const CONTEXT = {};
+function renderTable(raw, widgetProps = {}) {
+    render(_jsx(GenericDataTableWidget, { keys: { "probe:rows": raw }, context: CONTEXT, widgetProps: { dataKey: "probe:rows", ...widgetProps } }));
+    return screen.queryAllByRole("columnheader").map((th) => th.textContent);
+}
+const cells = () => screen.getAllByRole("cell").map((td) => td.textContent);
+const ROWS = [
+    { process: "Invoice", totalIncidents: 3, process_definition_key: "invoice" },
+    { process: "Order", totalIncidents: 0, process_definition_key: "order" },
+];
+describe("shell:data-table", () => {
+    it("derives the columns from the first row, each key in words", () => {
+        expect(renderTable(ROWS)).toEqual(["Process", "Total incidents", "Process definition key"]);
+        // A number column aligns right, the others left.
+        const [process, incidents] = screen.getAllByRole("columnheader");
+        expect(incidents.className).toContain("text-right");
+        expect(process.className).toContain("text-left");
+        expect(cells()).toEqual(["Invoice", "3", "invoice", "Order", "0", "order"]);
+    });
+    it("keeps a written label and words the key of a column without one", () => {
+        expect(renderTable(ROWS, {
+            columns: [
+                { key: "process", label: "Prozess" },
+                { key: "totalIncidents", align: "right" },
+                { key: "" },
+                { label: "no key" },
+                "not a column",
+            ],
+        })).toEqual(["Prozess", "Total incidents"]);
+        expect(screen.getAllByRole("columnheader")[1].className).toContain("text-right");
+        expect(cells()).toEqual(["Invoice", "3", "Order", "0"]);
+    });
+    it("derives the columns when none of the given ones is usable", () => {
+        expect(renderTable(ROWS, { columns: [{ label: "no key" }] })).toEqual([
+            "Process",
+            "Total incidents",
+            "Process definition key",
+        ]);
+    });
+    it("reads { rows: [...] }, derives primitive and null fields only, at most eight", () => {
+        const wide = Object.fromEntries(Array.from({ length: 10 }, (_, i) => [`field${String(i)}`, i]));
+        const row = { flag: true, note: null, nested: { a: 1 }, list: [1], ...wide };
+        const headers = renderTable({ rows: [row, "not a record"] });
+        expect(headers).toEqual([
+            "Flag",
+            "Note",
+            "Field0",
+            "Field1",
+            "Field2",
+            "Field3",
+            "Field4",
+            "Field5",
+        ]);
+        // A Boolean in words, null and anything not primitive as a dash.
+        expect(cells().slice(0, 3)).toEqual(["Yes", "—", "0"]);
+    });
+    it("shows a dash for a cell whose value is not primitive", () => {
+        renderTable([
+            { name: "a", detail: "x" },
+            { name: "b", detail: { deep: true } },
+        ]);
+        expect(cells()).toEqual(["a", "x", "b", "—"]);
+    });
+    it("says so when the key holds no rows, in the given text or the kit's words", () => {
+        renderTable([], { emptyText: "Keine Zeilen." });
+        expect(screen.getByText("Keine Zeilen.")).toBeTruthy();
+        cleanup();
+        renderTable({ rows: "none" });
+        expect(screen.getByText("No rows yet")).toBeTruthy();
+        cleanup();
+        render(_jsx(GenericDataTableWidget, { keys: {}, context: CONTEXT }));
+        expect(screen.getByText("No rows yet")).toBeTruthy();
+    });
+    it("says so when the first row has no field it can show", () => {
+        renderTable([{ nested: { a: 1 } }]);
+        expect(screen.getByText("No rows yet")).toBeTruthy();
+    });
+});
+function renderKpis(raw, widgetProps = {}) {
+    return render(_jsx(GenericKpiGridWidget, { keys: { "probe:kpis": raw }, context: CONTEXT, widgetProps: { dataKey: "probe:kpis", ...widgetProps } }));
+}
+describe("shell:kpi-grid", () => {
+    it("renders an array of cells, skipping the ones without a label", () => {
+        const { container } = renderKpis([
+            { label: "Open incidents", value: 4, tone: "danger", fraction: " /10" },
+            { label: "Running", value: "12" },
+            { label: "Healthy", value: true, tone: "critical" },
+            { label: "Unknown", value: { n: 1 }, tone: 7 },
+            { label: "", value: 1 },
+            { value: 2 },
+            "not a cell",
+        ]);
+        const text = container.textContent ?? "";
+        for (const shown of ["Open incidents", "4", "/10", "Running", "12", "Healthy", "Yes"]) {
+            expect(text).toContain(shown);
+        }
+        expect(text).toContain("Unknown");
+        expect(text).toContain("—");
+        expect(container.querySelectorAll("[data-tone]").length).toBeGreaterThan(0);
+    });
+    it("renders a plain { label: value } object, primitive values only", () => {
+        const { container } = renderKpis({ "Open incidents": 4, Running: "12", nested: { a: 1 } });
+        const text = container.textContent ?? "";
+        expect(text).toContain("Open incidents");
+        expect(text).toContain("Running");
+        expect(text).not.toContain("nested");
+    });
+    it("passes the frame and the style on", () => {
+        const strip = renderKpis([{ label: "Running", value: 1 }]).container.innerHTML;
+        cleanup();
+        const soft = renderKpis([{ label: "Running", value: 1 }], {
+            boxed: true,
+            variant: "soft",
+        }).container.innerHTML;
+        expect(soft).not.toBe(strip);
+    });
+    it("says so when the key holds no cells, in the given text or the kit's words", () => {
+        renderKpis("not cells", { emptyText: "Keine Kennzahlen." });
+        expect(screen.getByText("Keine Kennzahlen.")).toBeTruthy();
+        cleanup();
+        renderKpis([]);
+        expect(screen.getByText("No figures yet")).toBeTruthy();
+        cleanup();
+        render(_jsx(GenericKpiGridWidget, { keys: {}, context: CONTEXT, widgetProps: { dataKey: 7 } }));
+        expect(screen.getByText("No figures yet")).toBeTruthy();
+    });
+});
+//# sourceMappingURL=generic-widgets.test.js.map

package/dist/ui/generic-widgets.test.js.map

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

package/dist/ui/hand-off-button.d.ts

@@ -0,0 +1,45 @@
+import { type AskAiVariant } from "./ask-ai-button.js";
+import type { AskAiPrompt } from "./ask-ai-prompt.js";
+import type { LucideIcon } from "./icon.js";
+/**
+ * The product's ONE hand-off vocabulary: what a hand-off asks the chat to
+ * do, one entry per function, each with the Lucide icon of that function.
+ * Its label ("Ursache im Chat klären" / "Find cause in chat") is the kit's
+ * `handOff` entry, so the same function reads and looks the same in every
+ * module, and no icon stands for two functions (CI U4: never a sparkle,
+ * never a generic "AI" symbol). A connector widget renders hand-offs only
+ * through {@link HandOffButton} (an ESLint gate bans `AskAiButton` there); a
+ * new function goes here, with its label in both languages.
+ */
+export declare const HAND_OFF_ACTIONS: {
+    readonly assess: LucideIcon;
+    readonly findCause: LucideIcon;
+    readonly explainError: LucideIcon;
+    readonly planFix: LucideIcon;
+    readonly draftTicket: LucideIcon;
+    readonly explainTimeline: LucideIcon;
+    readonly explainDuration: LucideIcon;
+    readonly checkVariables: LucideIcon;
+    readonly explainDiagram: LucideIcon;
+    readonly checkHealth: LucideIcon;
+    readonly analyzeFailures: LucideIcon;
+    readonly analyzePerformance: LucideIcon;
+    readonly explainBottleneck: LucideIcon;
+    readonly prioritize: LucideIcon;
+    readonly compareEngines: LucideIcon;
+};
+export type HandOffAction = keyof typeof HAND_OFF_ACTIONS;
+/**
+ * A chat hand-off: the kit's {@link AskAiButton} (a secondary outline, so the
+ * deterministic next step stays the view's primary action) with the icon and
+ * verb of `action`. `icon` variant rows keep the label as the accessible name
+ * and tooltip; `title` overrides both when a row needs its subject in them
+ * ("Compare “order” across its engines in chat").
+ */
+export declare function HandOffButton({ action, prompt, variant, title, }: {
+    action: HandOffAction;
+    prompt: AskAiPrompt | null;
+    variant?: AskAiVariant;
+    title?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=hand-off-button.d.ts.map

package/dist/ui/hand-off-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hand-off-button.d.ts","sourceRoot":"","sources":["../../src/ui/hand-off-button.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAG3C;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;CAgBkB,CAAA;AAE/C,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,gBAAgB,CAAA;AAEzD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,MAAM,EACN,OAAkB,EAClB,KAAK,GACN,EAAE;IACD,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,+BAWA"}

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

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLocale } from "@miragon/mcp-toolkit-ui";
+import { ArrowLeftRight, Braces, Bug, ClipboardList, FileSearch, Gauge, Hourglass, ListChecks, ListOrdered, Route, ScanSearch, Stethoscope, Timer, Workflow, Wrench, } from "lucide-react";
+import { AskAiButton } from "./ask-ai-button.js";
+import { kitLabels } from "./kit-labels.js";
+/**
+ * The product's ONE hand-off vocabulary: what a hand-off asks the chat to
+ * do, one entry per function, each with the Lucide icon of that function.
+ * Its label ("Ursache im Chat klären" / "Find cause in chat") is the kit's
+ * `handOff` entry, so the same function reads and looks the same in every
+ * module, and no icon stands for two functions (CI U4: never a sparkle,
+ * never a generic "AI" symbol). A connector widget renders hand-offs only
+ * through {@link HandOffButton} (an ESLint gate bans `AskAiButton` there); a
+ * new function goes here, with its label in both languages.
+ */
+export const HAND_OFF_ACTIONS = {
+    assess: ListChecks,
+    findCause: ScanSearch,
+    explainError: FileSearch,
+    planFix: Wrench,
+    draftTicket: ClipboardList,
+    explainTimeline: Route,
+    explainDuration: Timer,
+    checkVariables: Braces,
+    explainDiagram: Workflow,
+    checkHealth: Stethoscope,
+    analyzeFailures: Bug,
+    analyzePerformance: Gauge,
+    explainBottleneck: Hourglass,
+    prioritize: ListOrdered,
+    compareEngines: ArrowLeftRight,
+};
+/**
+ * A chat hand-off: the kit's {@link AskAiButton} (a secondary outline, so the
+ * deterministic next step stays the view's primary action) with the icon and
+ * verb of `action`. `icon` variant rows keep the label as the accessible name
+ * and tooltip; `title` overrides both when a row needs its subject in them
+ * ("Compare “order” across its engines in chat").
+ */
+export function HandOffButton({ action, prompt, variant = "subtle", title, }) {
+    const locale = useLocale();
+    return (_jsx(AskAiButton, { icon: HAND_OFF_ACTIONS[action], label: kitLabels(locale).handOff[action], prompt: prompt, variant: variant, title: title }));
+}
+//# sourceMappingURL=hand-off-button.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hand-off-button.js","sourceRoot":"","sources":["../../src/ui/hand-off-button.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,EACL,cAAc,EACd,MAAM,EACN,GAAG,EACH,aAAa,EACb,UAAU,EACV,KAAK,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,KAAK,EACL,UAAU,EACV,WAAW,EACX,KAAK,EACL,QAAQ,EACR,MAAM,GACP,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,WAAW,EAAqB,MAAM,oBAAoB,CAAA;AAGnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,UAAU;IAClB,SAAS,EAAE,UAAU;IACrB,YAAY,EAAE,UAAU;IACxB,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,MAAM;IACtB,cAAc,EAAE,QAAQ;IACxB,WAAW,EAAE,WAAW;IACxB,eAAe,EAAE,GAAG;IACpB,kBAAkB,EAAE,KAAK;IACzB,iBAAiB,EAAE,SAAS;IAC5B,UAAU,EAAE,WAAW;IACvB,cAAc,EAAE,cAAc;CACe,CAAA;AAI/C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,MAAM,EACN,MAAM,EACN,OAAO,GAAG,QAAQ,EAClB,KAAK,GAMN;IACC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,OAAO,CACL,KAAC,WAAW,IACV,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACZ,CACH,CAAA;AACH,CAAC"}

package/dist/ui/hand-off-button.test.d.ts

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

package/dist/ui/hand-off-button.test.d.ts.map

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