@miragon/pulse-widget-shell 0.0.0-bootstrap.0 → 0.21.0

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

@@ -0,0 +1,49 @@
+import { jsx as _jsx } 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 { LocaleProvider } from "@miragon/mcp-toolkit-ui";
+import { QueryFallback, TableSkeleton } from "./query-fallback.js";
+afterEach(cleanup);
+const SKELETON = _jsx("div", { children: "loading skeleton" });
+describe("QueryFallback: never an eternal skeleton, never a dead end (U1, U22)", () => {
+    it("renders the skeleton under a polite status while the query has not errored", () => {
+        render(_jsx(QueryFallback, { isError: false, onRetry: vi.fn(), skeleton: SKELETON }));
+        expect(screen.getByText("loading skeleton").closest('[aria-hidden="true"]')).toBeTruthy();
+        expect(screen.getByRole("status").textContent).toContain("Loading view…");
+        expect(screen.queryByRole("alert")).toBeNull();
+    });
+    it("names the loading in the caller's words", () => {
+        render(_jsx(QueryFallback, { isError: false, onRetry: vi.fn(), loadingText: "Jobs\u2026", skeleton: SKELETON }));
+        expect(screen.getByRole("status").textContent).toContain("Jobs…");
+    });
+    it("says what happened and what to do, the raw cause under Details, and retries", () => {
+        const onRetry = vi.fn();
+        render(_jsx(QueryFallback, { isError: true, error: new Error("engine prod unreachable (ECONNREFUSED)"), onRetry: onRetry, errorTitle: "Could not load the process definitions", skeleton: SKELETON }));
+        expect(screen.getByRole("heading", { name: "Engine prod is unreachable" })).toBeTruthy();
+        expect(screen.getByText("Check that the engine is running, or pick another engine.")).toBeTruthy();
+        expect(screen.getByText("engine prod unreachable (ECONNREFUSED)").closest("details")).toBeTruthy();
+        expect(screen.queryByText("loading skeleton")).toBeNull();
+        fireEvent.click(screen.getByRole("button", { name: "Try again" }));
+        expect(onRetry).toHaveBeenCalledTimes(1);
+    });
+    it("heads an unclassified error with the caller's title, in the active locale", () => {
+        render(_jsx(LocaleProvider, { locale: "de", children: _jsx(QueryFallback, { isError: true, error: "nicht klassifizierbar", onRetry: vi.fn(), errorTitle: "Die Liste konnte nicht geladen werden", skeleton: SKELETON }) }));
+        expect(screen.getByRole("heading", { name: "Die Liste konnte nicht geladen werden" })).toBeTruthy();
+        expect(screen.getByText("Versuch es noch mal. Klappt es wieder nicht, frag im Chat nach.")).toBeTruthy();
+        expect(screen.getByRole("button", { name: "Erneut versuchen" })).toBeTruthy();
+    });
+    it("without a title or a cause still offers what to do and the retry", () => {
+        render(_jsx(QueryFallback, { isError: true, onRetry: vi.fn(), skeleton: SKELETON }));
+        expect(screen.getByRole("heading", { name: "Something went wrong" })).toBeTruthy();
+        expect(screen.getByRole("alert").querySelector("details")).toBeNull();
+        expect(screen.getByRole("button", { name: "Try again" })).toBeTruthy();
+    });
+});
+describe("TableSkeleton", () => {
+    it("draws a card with two bars", () => {
+        const { container } = render(_jsx(TableSkeleton, {}));
+        expect(container.querySelectorAll('[data-slot="skeleton"]')).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=query-fallback.test.js.map

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

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

package/dist/ui/row-card.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+/**
+ * Bordered list-row card — truncating title/subtitle block on the left,
+ * action buttons pinned right. The row shape the engine-health cluster list
+ * and the cluster-detail rows used to copy verbatim.
+ */
+export declare function RowCard({ title, subtitle, actions, className, }: {
+    title: ReactNode;
+    subtitle?: ReactNode;
+    actions?: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=row-card.d.ts.map

package/dist/ui/row-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-card.d.ts","sourceRoot":"","sources":["../../src/ui/row-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAS,GACV,EAAE;IACD,KAAK,EAAE,SAAS,CAAA;IAChB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,+BAeA"}

package/dist/ui/row-card.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@miragon/mcp-toolkit-ui";
+/**
+ * Bordered list-row card — truncating title/subtitle block on the left,
+ * action buttons pinned right. The row shape the engine-health cluster list
+ * and the cluster-detail rows used to copy verbatim.
+ */
+export function RowCard({ title, subtitle, actions, className, }) {
+    return (_jsxs("div", { className: cn("border-border flex items-center justify-between gap-3 rounded-md border p-3", className), children: [_jsxs("div", { className: "min-w-0", children: [_jsx("div", { className: "text-dense flex items-center gap-2 font-medium", children: title }), subtitle && _jsx("div", { className: "text-muted-foreground text-small truncate", children: subtitle })] }), actions && _jsx("div", { className: "flex shrink-0 items-center gap-1.5", children: actions })] }));
+}
+//# sourceMappingURL=row-card.js.map

package/dist/ui/row-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-card.js","sourceRoot":"","sources":["../../src/ui/row-card.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAA;AAE5C;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,EACtB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAS,GAMV;IACC,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CACX,6EAA6E,EAC7E,SAAS,CACV,aAED,eAAK,SAAS,EAAC,SAAS,aACtB,cAAK,SAAS,EAAC,gDAAgD,YAAE,KAAK,GAAO,EAC5E,QAAQ,IAAI,cAAK,SAAS,EAAC,2CAA2C,YAAE,QAAQ,GAAO,IACpF,EACL,OAAO,IAAI,cAAK,SAAS,EAAC,oCAAoC,YAAE,OAAO,GAAO,IAC3E,CACP,CAAA;AACH,CAAC"}

package/dist/ui/section.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from "react";
+/**
+ * Collapsible disclosure section — `<details>`/`<summary>` with the chevron,
+ * heading and optional count badge. Lifted from the camunda7 instance detail;
+ * the analytics dashboard tables inline-copied the same markup four times
+ * before this became shared.
+ */
+export declare function Section({ title, count, badgeVariant, defaultOpen, onToggle, children, }: {
+    title: ReactNode;
+    count?: number;
+    /** `destructive` for error/incident counts, `secondary` (default) otherwise. */
+    badgeVariant?: "secondary" | "destructive";
+    defaultOpen?: boolean;
+    /** Notified when the disclosure opens/closes — lets callers lazy-mount content. */
+    onToggle?: (open: boolean) => void;
+    children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=section.d.ts.map

package/dist/ui/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../src/ui/section.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,KAAK,EACL,YAA0B,EAC1B,WAAmB,EACnB,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,YAAY,CAAC,EAAE,WAAW,GAAG,aAAa,CAAA;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAoBA"}

package/dist/ui/section.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge, cn, FOCUS_RING } from "@miragon/mcp-toolkit-ui";
+import { ChevronRight } from "lucide-react";
+import { Icon } from "./icon.js";
+/**
+ * Collapsible disclosure section — `<details>`/`<summary>` with the chevron,
+ * heading and optional count badge. Lifted from the camunda7 instance detail;
+ * the analytics dashboard tables inline-copied the same markup four times
+ * before this became shared.
+ */
+export function Section({ title, count, badgeVariant = "secondary", defaultOpen = false, onToggle, children, }) {
+    return (_jsxs("details", { open: defaultOpen || undefined, onToggle: (e) => onToggle?.(e.currentTarget.open), children: [_jsxs("summary", { className: cn("flex w-fit cursor-pointer list-none items-center gap-2 rounded-sm [&::-webkit-details-marker]:hidden", FOCUS_RING), children: [_jsx(Icon, { icon: ChevronRight, className: "text-muted-foreground transition-transform motion-reduce:transition-none [[open]>summary>&]:rotate-90" }), _jsx("h3", { className: "text-section", children: title }), count !== undefined && _jsx(Badge, { variant: badgeVariant, children: count })] }), _jsx("div", { className: "mt-2", children: children })] }));
+}
+//# sourceMappingURL=section.js.map

package/dist/ui/section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.js","sourceRoot":"","sources":["../../src/ui/section.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,EACtB,KAAK,EACL,KAAK,EACL,YAAY,GAAG,WAAW,EAC1B,WAAW,GAAG,KAAK,EACnB,QAAQ,EACR,QAAQ,GAUT;IACC,OAAO,CACL,mBAAS,IAAI,EAAE,WAAW,IAAI,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,aACxF,mBACE,SAAS,EAAE,EAAE,CACX,sGAAsG,EACtG,UAAU,CACX,aAED,KAAC,IAAI,IACH,IAAI,EAAE,YAAY,EAClB,SAAS,EAAC,uGAAuG,GACjH,EAEF,aAAI,SAAS,EAAC,cAAc,YAAE,KAAK,GAAM,EACxC,KAAK,KAAK,SAAS,IAAI,KAAC,KAAK,IAAC,OAAO,EAAE,YAAY,YAAG,KAAK,GAAS,IAC7D,EACV,cAAK,SAAS,EAAC,MAAM,YAAE,QAAQ,GAAO,IAC9B,CACX,CAAA;AACH,CAAC"}

package/dist/ui/segmented-control.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from "react";
+export interface SegmentedControlOption<V extends string = string> {
+    value: V;
+    label: ReactNode;
+}
+/**
+ * Compact multi-state toggle — a track of segments where the active one is a
+ * selection in the info tone (CI: blue contour + tint, black text: an inset
+ * info ring on the tint). Modeled on the live/frequency/duration flow toggle
+ * in the process-detail widget; `aria-pressed` carries the state.
+ *
+ * The segments sit 2 px inside the track's edge, each with the track's
+ * radius minus that inset (concentric corners), so the contour follows the
+ * corner and never touches the track's border. A square segment clipped by a
+ * rounded track left light wedges between the two lines at the corners, and
+ * a middle segment's contour doubled the border.
+ */
+export declare function SegmentedControl<V extends string>({ options, value, onChange, ariaLabel, className, }: {
+    options: ReadonlyArray<SegmentedControlOption<V>>;
+    value: V;
+    onChange: (next: V) => void;
+    ariaLabel?: string;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=segmented-control.d.ts.map

package/dist/ui/segmented-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmented-control.d.ts","sourceRoot":"","sources":["../../src/ui/segmented-control.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC/D,KAAK,EAAE,CAAC,CAAA;IACR,KAAK,EAAE,SAAS,CAAA;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,EACjD,OAAO,EACP,KAAK,EACL,QAAQ,EACR,SAAS,EACT,SAAS,GACV,EAAE;IACD,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,+BA8BA"}

package/dist/ui/segmented-control.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn, FOCUS_RING_INSET, TONE_SOFT } from "@miragon/mcp-toolkit-ui";
+/**
+ * Compact multi-state toggle — a track of segments where the active one is a
+ * selection in the info tone (CI: blue contour + tint, black text: an inset
+ * info ring on the tint). Modeled on the live/frequency/duration flow toggle
+ * in the process-detail widget; `aria-pressed` carries the state.
+ *
+ * The segments sit 2 px inside the track's edge, each with the track's
+ * radius minus that inset (concentric corners), so the contour follows the
+ * corner and never touches the track's border. A square segment clipped by a
+ * rounded track left light wedges between the two lines at the corners, and
+ * a middle segment's contour doubled the border.
+ */
+export function SegmentedControl({ options, value, onChange, ariaLabel, className, }) {
+    return (_jsx("div", { role: ariaLabel ? "group" : undefined, "aria-label": ariaLabel, className: cn("border-border text-dense inline-flex gap-0.5 rounded-md border p-0.5", className), children: options.map((option) => (_jsx("button", { type: "button", onClick: () => onChange(option.value), "aria-pressed": value === option.value, className: cn(
+            // 32 px in all, like the buttons beside it: 1 px border + 2 px inset + 26 px.
+            "inline-flex h-[26px] items-center rounded-[calc(var(--radius-md)-3px)] px-2.5 font-medium transition-colors", FOCUS_RING_INSET, value === option.value
+                ? cn(TONE_SOFT.info, "ring-info ring-1 ring-inset")
+                : "text-muted-foreground hover:bg-muted hover:text-foreground"), children: option.label }, option.value))) }));
+}
+//# sourceMappingURL=segmented-control.js.map

package/dist/ui/segmented-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmented-control.js","sourceRoot":"","sources":["../../src/ui/segmented-control.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAOzE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAmB,EACjD,OAAO,EACP,KAAK,EACL,QAAQ,EACR,SAAS,EACT,SAAS,GAOV;IACC,OAAO,CACL,cACE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,gBACzB,SAAS,EACrB,SAAS,EAAE,EAAE,CACX,sEAAsE,EACtE,SAAS,CACV,YAEA,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACvB,iBAEE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,kBACvB,KAAK,KAAK,MAAM,CAAC,KAAK,EACpC,SAAS,EAAE,EAAE;YACX,8EAA8E;YAC9E,6GAA6G,EAC7G,gBAAgB,EAChB,KAAK,KAAK,MAAM,CAAC,KAAK;gBACpB,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,6BAA6B,CAAC;gBACnD,CAAC,CAAC,4DAA4D,CACjE,YAEA,MAAM,CAAC,KAAK,IAbR,MAAM,CAAC,KAAK,CAcV,CACV,CAAC,GACE,CACP,CAAA;AACH,CAAC"}

package/dist/ui/settings-labels.d.ts

@@ -0,0 +1,33 @@
+import type { Locale } from "../profile-constants.js";
+import type { ShellSettingsReadOnlyReason } from "../shell-settings-contract.js";
+/**
+ * The words of the settings page (`shell:settings-page`) and the shell's
+ * language section (`shell:settings`), en/de. Voice (brand-tone): German
+ * addresses you with "du", a read-only notice says why and what you can do,
+ * no dash as a connector. `brand-gates.test.ts` runs the catalog text test
+ * over both sets.
+ */
+export interface SettingsLabels {
+    pageTitle: string;
+    pageSubtitle: string;
+    languageSection: string;
+    language: string;
+    languageHelp: string;
+    /** The "system" option: the view follows the chat app's locale. */
+    languageSystem: string;
+    save: string;
+    saving: string;
+    savedToast: string;
+    saveFailedToast: string;
+    loadError: string;
+    none: string;
+    readOnlyTitle: string;
+    readOnly: Readonly<Record<ShellSettingsReadOnlyReason, string>>;
+}
+/** Each language named in itself, so a reader finds theirs in any view. */
+export declare const LANGUAGE_NAMES: Readonly<Record<Locale, string>>;
+/** The settings words for a locale tag (`de-AT` → German); English for anything unsupported. */
+export declare function settingsLabels(locale: string | undefined): SettingsLabels;
+/** Both label sets, for the catalog text test. */
+export declare const SETTINGS_LABELS: Readonly<Record<Locale, SettingsLabels>>;
+//# sourceMappingURL=settings-labels.d.ts.map

package/dist/ui/settings-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-labels.d.ts","sourceRoot":"","sources":["../../src/ui/settings-labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAGhF;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC,CAAA;CAChE;AAED,2EAA2E;AAC3E,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAoC,CAAA;AAiDhG,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAEzE;AAED,kDAAkD;AAClD,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAU,CAAA"}

package/dist/ui/settings-labels.js

@@ -0,0 +1,50 @@
+import { supportedLanguage } from "./host-context.js";
+/** Each language named in itself, so a reader finds theirs in any view. */
+export const LANGUAGE_NAMES = { en: "English", de: "Deutsch" };
+const LABELS = {
+    en: {
+        pageTitle: "Settings",
+        pageSubtitle: "Your language and each module's settings, in every chat.",
+        languageSection: "Language",
+        language: "Language",
+        languageHelp: "Automatic follows your chat app. A fixed language also applies to what the tools report back to the AI.",
+        languageSystem: "Automatic (follows the chat app)",
+        save: "Save",
+        saving: "Saving…",
+        savedToast: "Language saved",
+        saveFailedToast: "Couldn't save the language",
+        loadError: "Couldn't load the language setting",
+        none: "No settings available",
+        readOnlyTitle: "The language is read-only here",
+        readOnly: {
+            noSignIn: "This connection has no sign-in, so it has no one to save settings for. Saving needs a connection with sign-in: ask your administrator to set one up.",
+            readOnly: "This server runs a module read-only, so it saves no settings. Ask your administrator for a connection that allows changes.",
+        },
+    },
+    de: {
+        pageTitle: "Einstellungen",
+        pageSubtitle: "Deine Sprache und die Einstellungen jedes Moduls, in jedem Chat.",
+        languageSection: "Sprache",
+        language: "Sprache",
+        languageHelp: "„Automatisch“ übernimmt die Sprache deiner Chat-App. Eine feste Sprache gilt auch für das, was die Tools der AI zurückmelden.",
+        languageSystem: "Automatisch (wie die Chat-App)",
+        save: "Speichern",
+        saving: "Wird gespeichert…",
+        savedToast: "Sprache gespeichert",
+        saveFailedToast: "Die Sprache wurde nicht gespeichert",
+        loadError: "Die Spracheinstellung konnte nicht geladen werden",
+        none: "Keine Einstellungen verfügbar",
+        readOnlyTitle: "Die Sprache ist hier nur lesbar",
+        readOnly: {
+            noSignIn: "Diese Verbindung hat keine Anmeldung und weiß deshalb nicht, für wen sie speichern soll. Speichern geht nur über eine Verbindung mit Anmeldung: Bitte deine Administration, sie einzurichten.",
+            readOnly: "Dieser Server betreibt ein Modul nur lesend und speichert deshalb keine Einstellungen. Bitte deine Administration um eine Verbindung, die Änderungen erlaubt.",
+        },
+    },
+};
+/** The settings words for a locale tag (`de-AT` → German); English for anything unsupported. */
+export function settingsLabels(locale) {
+    return LABELS[supportedLanguage(locale) ?? "en"];
+}
+/** Both label sets, for the catalog text test. */
+export const SETTINGS_LABELS = LABELS;
+//# sourceMappingURL=settings-labels.js.map

package/dist/ui/settings-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-labels.js","sourceRoot":"","sources":["../../src/ui/settings-labels.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AA2BrD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,cAAc,GAAqC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAA;AAEhG,MAAM,MAAM,GAA6C;IACvD,EAAE,EAAE;QACF,SAAS,EAAE,UAAU;QACrB,YAAY,EAAE,0DAA0D;QACxE,eAAe,EAAE,UAAU;QAC3B,QAAQ,EAAE,UAAU;QACpB,YAAY,EACV,yGAAyG;QAC3G,cAAc,EAAE,kCAAkC;QAClD,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,gBAAgB;QAC5B,eAAe,EAAE,4BAA4B;QAC7C,SAAS,EAAE,oCAAoC;QAC/C,IAAI,EAAE,uBAAuB;QAC7B,aAAa,EAAE,gCAAgC;QAC/C,QAAQ,EAAE;YACR,QAAQ,EACN,sJAAsJ;YACxJ,QAAQ,EACN,4HAA4H;SAC/H;KACF;IACD,EAAE,EAAE;QACF,SAAS,EAAE,eAAe;QAC1B,YAAY,EAAE,kEAAkE;QAChF,eAAe,EAAE,SAAS;QAC1B,QAAQ,EAAE,SAAS;QACnB,YAAY,EACV,+HAA+H;QACjI,cAAc,EAAE,gCAAgC;QAChD,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,mBAAmB;QAC3B,UAAU,EAAE,qBAAqB;QACjC,eAAe,EAAE,qCAAqC;QACtD,SAAS,EAAE,mDAAmD;QAC9D,IAAI,EAAE,+BAA+B;QACrC,aAAa,EAAE,iCAAiC;QAChD,QAAQ,EAAE;YACR,QAAQ,EACN,+LAA+L;YACjM,QAAQ,EACN,+JAA+J;SAClK;KACF;CACF,CAAA;AAED,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAAC,MAA0B;IACvD,OAAO,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAA;AAClD,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAA6C,MAAM,CAAA"}

package/dist/ui/settings-layout.d.ts

@@ -0,0 +1,29 @@
+import { type LayoutConfig } from "@miragon/mcp-toolkit-core";
+/**
+ * The settings page, assembled from what the host actually composed: the
+ * shell's language section first, then one row per `<module>:settings`
+ * widget in the host registry, in registration order (the composition root's
+ * module order).
+ *
+ * This is the host-extension point of the page. A module contributes its
+ * section by catalogueing it as `<module>:settings` and having its widget map
+ * spread into the host bundle's registry (link 3 of the widget chain) — no
+ * edit anywhere else, so a custom module composed from the published packages
+ * is a first-class citizen of the page.
+ *
+ * Section ids stay raw strings on purpose (tier-2 cross-module reference):
+ * the host registry resolves them at runtime and {@link filterLayoutToWidgets}
+ * drops whatever resolves nowhere. A module that IS bundled but inactive at
+ * runtime (`MCP_ACTIVE_MODULES`) still contributes its id; its section widget
+ * hides itself once its feed answers "unknown tool".
+ */
+export declare function settingsLayout(widgetIds?: readonly string[]): LayoutConfig;
+/**
+ * Drop layout cells whose widget id resolves to no component in `widgets`
+ * (cross-module ids in a host that does not bundle that module), then drop
+ * emptied rows — the tier-2 degradation for composed views: a missing
+ * module's section simply disappears instead of rendering an unknown-widget
+ * error.
+ */
+export declare function filterLayoutToWidgets(layout: LayoutConfig, widgets: Record<string, unknown>): LayoutConfig;
+//# sourceMappingURL=settings-layout.d.ts.map

package/dist/ui/settings-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-layout.d.ts","sourceRoot":"","sources":["../../src/ui/settings-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAe,MAAM,2BAA2B,CAAA;AAS3F;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,SAAS,GAAE,SAAS,MAAM,EAAO,GAAG,YAAY,CAQ9E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,YAAY,CASd"}

package/dist/ui/settings-layout.js

@@ -0,0 +1,49 @@
+import { normalizeLayout } from "@miragon/mcp-toolkit-core";
+import { SHELL_SETTINGS_WIDGET } from "../shell-settings-contract.js";
+/**
+ * The convention that marks a module's settings section: the `<module>:settings`
+ * widget id it catalogues for its own section.
+ */
+const SETTINGS_SECTION_SUFFIX = ":settings";
+/**
+ * The settings page, assembled from what the host actually composed: the
+ * shell's language section first, then one row per `<module>:settings`
+ * widget in the host registry, in registration order (the composition root's
+ * module order).
+ *
+ * This is the host-extension point of the page. A module contributes its
+ * section by catalogueing it as `<module>:settings` and having its widget map
+ * spread into the host bundle's registry (link 3 of the widget chain) — no
+ * edit anywhere else, so a custom module composed from the published packages
+ * is a first-class citizen of the page.
+ *
+ * Section ids stay raw strings on purpose (tier-2 cross-module reference):
+ * the host registry resolves them at runtime and {@link filterLayoutToWidgets}
+ * drops whatever resolves nowhere. A module that IS bundled but inactive at
+ * runtime (`MCP_ACTIVE_MODULES`) still contributes its id; its section widget
+ * hides itself once its feed answers "unknown tool".
+ */
+export function settingsLayout(widgetIds = []) {
+    const sections = widgetIds.filter((id) => id !== SHELL_SETTINGS_WIDGET && id.endsWith(SETTINGS_SECTION_SUFFIX));
+    // Deduped: callers may merge several registries into the id list.
+    return [SHELL_SETTINGS_WIDGET, ...new Set(sections)].map((widget) => ({
+        row: [{ widget, props: {} }],
+    }));
+}
+/**
+ * Drop layout cells whose widget id resolves to no component in `widgets`
+ * (cross-module ids in a host that does not bundle that module), then drop
+ * emptied rows — the tier-2 degradation for composed views: a missing
+ * module's section simply disappears instead of rendering an unknown-widget
+ * error.
+ */
+export function filterLayoutToWidgets(layout, widgets) {
+    const filterRows = (rows) => rows
+        .map((r) => ({ ...r, row: r.row.filter((cell) => cell.widget in widgets) }))
+        .filter((r) => r.row.length > 0);
+    const normalized = normalizeLayout(layout);
+    return "tabs" in normalized
+        ? { tabs: normalized.tabs.map((tab) => ({ ...tab, rows: filterRows(tab.rows) })) }
+        : { rows: filterRows(normalized.rows) };
+}
+//# sourceMappingURL=settings-layout.js.map

package/dist/ui/settings-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-layout.js","sourceRoot":"","sources":["../../src/ui/settings-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkC,MAAM,2BAA2B,CAAA;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAErE;;;GAGG;AACH,MAAM,uBAAuB,GAAG,WAAW,CAAA;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAC,YAA+B,EAAE;IAC9D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAC/B,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,qBAAqB,IAAI,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAC7E,CAAA;IACD,kEAAkE;IAClE,OAAO,CAAC,qBAAqB,EAAE,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;KAC7B,CAAC,CAAC,CAAA;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAoB,EACpB,OAAgC;IAEhC,MAAM,UAAU,GAAG,CAAC,IAAc,EAAY,EAAE,CAC9C,IAAI;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;SAC3E,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,MAAM,IAAI,UAAU;QACzB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE;QAClF,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAA;AAC3C,CAAC"}

package/dist/ui/settings-layout.test.d.ts

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

package/dist/ui/settings-layout.test.d.ts.map

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

package/dist/ui/settings-layout.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, it } from "vitest";
+import { collectLayoutWidgets } from "@miragon/mcp-toolkit-core";
+import { filterLayoutToWidgets, settingsLayout } from "./settings-layout.js";
+/** The section ids the settings page would render for a given host registry. */
+const sectionsFor = (widgetIds) => collectLayoutWidgets(settingsLayout(widgetIds));
+describe("settingsLayout", () => {
+    it("renders the shell's language section without any host registry", () => {
+        // A host that mounts no HostWidgetsProvider (fixture harnesses, foreign
+        // hosts) still gets the shell's own section — never an empty page.
+        expect(sectionsFor()).toEqual(["shell:settings"]);
+        expect(sectionsFor([])).toEqual(["shell:settings"]);
+    });
+    it("adds a row for every module's `<module>:settings` widget, in registration order", () => {
+        expect(sectionsFor([
+            "camunda7:engine-health",
+            "camunda7:settings",
+            "analytics:settings",
+            "shell:kpi-grid",
+            "shell:settings-page",
+        ])).toEqual(["shell:settings", "camunda7:settings", "analytics:settings"]);
+    });
+    it("pins the shell's section first, wherever the host registered it", () => {
+        expect(sectionsFor(["analytics:settings", "shell:settings", "camunda7:settings"])).toEqual([
+            "shell:settings",
+            "analytics:settings",
+            "camunda7:settings",
+        ]);
+    });
+    it("picks up a CUSTOM module's section nothing else has heard of", () => {
+        // The whole point of the self-assembly: a server composed from the
+        // published packages contributes its own section by registering the
+        // widget, with no edit anywhere else.
+        expect(sectionsFor(["analytics:settings", "acme:settings"])).toEqual([
+            "shell:settings",
+            "analytics:settings",
+            "acme:settings",
+        ]);
+    });
+    it("matches the convention exactly — a lookalike id contributes no section", () => {
+        expect(sectionsFor(["acme:settings-advanced", "acme:settingsfoo", "settings"])).toEqual([
+            "shell:settings",
+        ]);
+    });
+    it("lists no section twice when ids repeat across merged registries", () => {
+        expect(sectionsFor(["analytics:settings", "camunda7:settings", "analytics:settings"])).toEqual([
+            "shell:settings",
+            "analytics:settings",
+            "camunda7:settings",
+        ]);
+    });
+});
+describe("filterLayoutToWidgets", () => {
+    it("drops cells whose widget id resolves nowhere, and the rows they empty", () => {
+        const layout = settingsLayout(["analytics:settings", "acme:settings"]);
+        const filtered = filterLayoutToWidgets(layout, {
+            "shell:settings": () => null,
+            "acme:settings": () => null,
+        });
+        expect(collectLayoutWidgets(filtered)).toEqual(["shell:settings", "acme:settings"]);
+    });
+    it("keeps every cell a host can resolve, tabs included", () => {
+        const layout = {
+            tabs: [
+                { label: "A", rows: [{ row: [{ widget: "x:one", props: {} }] }] },
+                { label: "B", rows: [{ row: [{ widget: "x:two", props: {} }] }] },
+            ],
+        };
+        const filtered = filterLayoutToWidgets(layout, { "x:one": () => null });
+        expect(collectLayoutWidgets(filtered)).toEqual(["x:one"]);
+        expect("tabs" in filtered && filtered.tabs[1]?.rows).toEqual([]);
+    });
+});
+//# sourceMappingURL=settings-layout.test.js.map

package/dist/ui/settings-layout.test.js.map

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

package/dist/ui/settings.d.ts

@@ -0,0 +1,47 @@
+import { type ComponentProps, type ReactElement, type ReactNode } from "react";
+/**
+ * Shared building blocks for settings sections. The settings page composes one
+ * section widget per module (camunda7's profile panel, analytics' defaults, …)
+ * — these primitives keep the sections visually identical without the modules
+ * sharing any code beyond this kit.
+ */
+/**
+ * One titled settings card — the visual unit a module's settings section
+ * renders. Its title is an `h3` under the section's own `h2` heading; a
+ * section whose cards sit directly under the page title (`h1`) passes
+ * `titleAs="h2"`, so the outline never skips a level.
+ */
+export declare function SettingsCard({ title, titleAs: Title, children, }: {
+    title: string;
+    titleAs?: "h2" | "h3";
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The props a field hands its single control. */
+interface FieldControlProps {
+    id?: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: boolean;
+}
+/**
+ * A labelled form field with optional help text. Associates the label with its
+ * single child control via `htmlFor`/`id`; checkbox groups (no single control)
+ * set `group` and get a `role="group"` labelled by the text instead.
+ *
+ * `error` is the inline validation of the entry (CI §8/§9: say what is wrong
+ * where it is, never correct it silently): a line in the danger ink right
+ * under the control with an icon, the control marked `aria-invalid` and
+ * described by the line (and by the help text, which stays).
+ */
+export declare function SettingsField({ label, help, error, group, children, }: {
+    label: string;
+    help?: string;
+    /** What is wrong with the entry, in words ("Enter a whole number of 1 or more."). */
+    error?: string;
+    /** Checkbox-group fields: labelled via role="group" (no single control to point htmlFor at). */
+    group?: boolean;
+    children: ReactElement<FieldControlProps>;
+}): import("react").JSX.Element;
+/** Styled native `<input>` matching `NativeSelect` — for the rare free-form settings value. */
+export declare function SettingsInput({ className, ...props }: ComponentProps<"input">): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=settings.d.ts.map

package/dist/ui/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/ui/settings.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAMnG;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,OAAO,EAAE,KAAY,EACrB,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BASA;AAED,kDAAkD;AAClD,UAAU,iBAAiB;IACzB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,KAAK,EACL,KAAa,EACb,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gGAAgG;IAChG,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAA;CAC1C,+BAyCA;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,+BAE7E"}

package/dist/ui/settings.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cloneElement, useId } from "react";
+import { Card, CardContent, cn, TONE_INK } from "@miragon/mcp-toolkit-ui";
+import { CircleAlert } from "lucide-react";
+import { Icon } from "./icon.js";
+import { FIELD_CONTROL } from "./native-select.js";
+/**
+ * Shared building blocks for settings sections. The settings page composes one
+ * section widget per module (camunda7's profile panel, analytics' defaults, …)
+ * — these primitives keep the sections visually identical without the modules
+ * sharing any code beyond this kit.
+ */
+/**
+ * One titled settings card — the visual unit a module's settings section
+ * renders. Its title is an `h3` under the section's own `h2` heading; a
+ * section whose cards sit directly under the page title (`h1`) passes
+ * `titleAs="h2"`, so the outline never skips a level.
+ */
+export function SettingsCard({ title, titleAs: Title = "h3", children, }) {
+    return (_jsx(Card, { className: "gap-0 py-0 shadow-none", children: _jsxs(CardContent, { className: "flex flex-col gap-4 p-4", children: [_jsx(Title, { className: "text-foreground text-section", children: title }), children] }) }));
+}
+/**
+ * A labelled form field with optional help text. Associates the label with its
+ * single child control via `htmlFor`/`id`; checkbox groups (no single control)
+ * set `group` and get a `role="group"` labelled by the text instead.
+ *
+ * `error` is the inline validation of the entry (CI §8/§9: say what is wrong
+ * where it is, never correct it silently): a line in the danger ink right
+ * under the control with an icon, the control marked `aria-invalid` and
+ * described by the line (and by the help text, which stays).
+ */
+export function SettingsField({ label, help, error, group = false, children, }) {
+    const id = useId();
+    const labelId = `${id}-label`;
+    const helpId = `${id}-help`;
+    const errorId = `${id}-error`;
+    const describedBy = [error ? errorId : null, help ? helpId : null].filter(Boolean).join(" ");
+    return (_jsxs("div", { className: "flex flex-col gap-1.5", children: [group ? (_jsx("span", { id: labelId, className: "text-foreground text-dense font-medium", children: label })) : (_jsx("label", { htmlFor: id, className: "text-foreground text-dense font-medium", children: label })), group ? (_jsx("div", { role: "group", "aria-labelledby": labelId, "aria-describedby": describedBy || undefined, children: children })) : (cloneElement(children, {
+                id,
+                "aria-describedby": describedBy || undefined,
+                "aria-invalid": error ? true : undefined,
+            })), error && (_jsxs("span", { id: errorId, className: cn("text-small flex items-center gap-1.5", TONE_INK.danger), children: [_jsx(Icon, { icon: CircleAlert, dense: true }), error] })), help && (_jsx("span", { id: helpId, className: "text-muted-foreground text-small", children: help }))] }));
+}
+/** Styled native `<input>` matching `NativeSelect` — for the rare free-form settings value. */
+export function SettingsInput({ className, ...props }) {
+    return _jsx("input", { ...props, className: cn(FIELD_CONTROL, className) });
+}
+//# sourceMappingURL=settings.js.map

package/dist/ui/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/ui/settings.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAA0D,MAAM,OAAO,CAAA;AACnG,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,KAAK,EACL,OAAO,EAAE,KAAK,GAAG,IAAI,EACrB,QAAQ,GAKT;IACC,OAAO,CACL,KAAC,IAAI,IAAC,SAAS,EAAC,wBAAwB,YACtC,MAAC,WAAW,IAAC,SAAS,EAAC,yBAAyB,aAC9C,KAAC,KAAK,IAAC,SAAS,EAAC,8BAA8B,YAAE,KAAK,GAAS,EAC9D,QAAQ,IACG,GACT,CACR,CAAA;AACH,CAAC;AASD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,KAAK,EACL,KAAK,GAAG,KAAK,EACb,QAAQ,GAST;IACC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;IAClB,MAAM,OAAO,GAAG,GAAG,EAAE,QAAQ,CAAA;IAC7B,MAAM,MAAM,GAAG,GAAG,EAAE,OAAO,CAAA;IAC3B,MAAM,OAAO,GAAG,GAAG,EAAE,QAAQ,CAAA;IAC7B,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC5F,OAAO,CACL,eAAK,SAAS,EAAC,uBAAuB,aACnC,KAAK,CAAC,CAAC,CAAC,CACP,eAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAC,wCAAwC,YAClE,KAAK,GACD,CACR,CAAC,CAAC,CAAC,CACF,gBAAO,OAAO,EAAE,EAAE,EAAE,SAAS,EAAC,wCAAwC,YACnE,KAAK,GACA,CACT,EACA,KAAK,CAAC,CAAC,CAAC,CACP,cAAK,IAAI,EAAC,OAAO,qBAAkB,OAAO,sBAAoB,WAAW,IAAI,SAAS,YACnF,QAAQ,GACL,CACP,CAAC,CAAC,CAAC,CACF,YAAY,CAAC,QAAQ,EAAE;gBACrB,EAAE;gBACF,kBAAkB,EAAE,WAAW,IAAI,SAAS;gBAC5C,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;aACzC,CAAC,CACH,EACA,KAAK,IAAI,CACR,gBAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,sCAAsC,EAAE,QAAQ,CAAC,MAAM,CAAC,aACvF,KAAC,IAAI,IAAC,IAAI,EAAE,WAAW,EAAE,KAAK,SAAG,EAChC,KAAK,IACD,CACR,EACA,IAAI,IAAI,CACP,eAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAC,kCAAkC,YAC3D,IAAI,GACA,CACR,IACG,CACP,CAAA;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAA2B;IAC5E,OAAO,mBAAW,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC,GAAI,CAAA;AACtE,CAAC"}

package/dist/ui/settings.test.d.ts

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

package/dist/ui/settings.test.d.ts.map

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