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

package/dist/ui/declare-served-fonts.test.js

@@ -0,0 +1,44 @@
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it } from "vitest";
+import { declareServedFonts, SERVED_FONTS_STYLE_ID } from "./declare-served-fonts.js";
+const PUBLIC_BASE = "https://mcp.example.com/mcp/_mcp-use/public/";
+const FONT_BASE = "https://mcp.example.com/fonts/geist-5.3.0";
+const declared = () => document.getElementById(SERVED_FONTS_STYLE_ID);
+afterEach(() => {
+    declared()?.remove();
+    delete globalThis.__mcpUseViewConfig;
+});
+describe("declareServedFonts", () => {
+    it("declares Geist and Geist Mono from the view's own server, swap, once per document", () => {
+        expect(declareServedFonts(document, PUBLIC_BASE)).toBe(FONT_BASE);
+        const style = declared();
+        expect(style.parentElement).toBe(document.head);
+        expect(style.dataset.baseUrl).toBe(FONT_BASE);
+        const css = style.textContent;
+        expect(css).toContain('font-family: "Geist";');
+        expect(css).toContain('font-family: "Geist Mono";');
+        expect(css).toContain(`url("${FONT_BASE}/geist-latin-wght-normal.woff2") format("woff2")`);
+        expect(css).toContain(`url("${FONT_BASE}/geist-mono-latin-wght-normal.woff2") format("woff2")`);
+        expect(css.match(/font-display: swap;/g)).toHaveLength(2);
+        // Never inlined: the files are fetched once and cached across views.
+        expect(css).not.toContain("data:");
+        // A second mount (StrictMode, a re-rendered shell) adds nothing.
+        expect(declareServedFonts(document, "https://other.example/mcp/_mcp-use/public/")).toBe(FONT_BASE);
+        expect(document.querySelectorAll(`#${SERVED_FONTS_STYLE_ID}`)).toHaveLength(1);
+    });
+    it("reads the public base mcp-use injects into the served view document by default", () => {
+        globalThis.__mcpUseViewConfig = { publicBase: PUBLIC_BASE };
+        expect(declareServedFonts()).toBe(FONT_BASE);
+        expect(declared()).not.toBeNull();
+    });
+    it("declares nothing outside a served view document — the host's font renders", () => {
+        expect(declareServedFonts()).toBeUndefined();
+        expect(declareServedFonts(document, "")).toBeUndefined();
+        expect(declared()).toBeNull();
+    });
+    it("declares nothing for a base it cannot write into a CSS url()", () => {
+        expect(declareServedFonts(document, "http://a(b/mcp/_mcp-use/public/")).toBeUndefined();
+        expect(declared()).toBeNull();
+    });
+});
+//# sourceMappingURL=declare-served-fonts.test.js.map

package/dist/ui/declare-served-fonts.test.js.map

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

package/dist/ui/describe-error.d.ts

@@ -0,0 +1,71 @@
+import { type ErrorSource } from "./error-labels.js";
+export type { ErrorSource } from "./error-labels.js";
+/**
+ * What kind of failure an error text describes:
+ * - `unreachable`: no connection, or the source answered 502/503;
+ * - `timeout`: the deadline passed (the client's, or a 408/504);
+ * - `notOnServer`: the tool is not on this server (its module is inactive);
+ * - `unauthorized` / `forbidden`: the source refused the server (401 / 403);
+ * - `notFound`: the entry is gone (404);
+ * - `failed`: any other error status or engine exception;
+ * - `unknown`: nothing the kit recognises.
+ */
+export declare const ERROR_KINDS: readonly ["unreachable", "timeout", "notOnServer", "unauthorized", "forbidden", "notFound", "failed", "unknown"];
+export type ErrorKind = (typeof ERROR_KINDS)[number];
+/** The facts `classifyError` reads from an error, before any words. */
+export interface ErrorFacts {
+    kind: ErrorKind;
+    /** HTTP status the text names, if any. */
+    status?: number;
+    source: ErrorSource;
+    /** The raw text (the error's message), or null for an error without one. */
+    raw: string | null;
+    /**
+     * The source's own words, readable: the raw text without its bracketed
+     * status code, the engine-id suffix and the write caveat
+     * ("Cannot resolve incident"); null when nothing is left.
+     */
+    reason: string | null;
+    /**
+     * The text says a write may still have gone through (the camunda7
+     * client's caveat for a write whose answer never came: a timeout, a
+     * connection lost mid-request). Retrying blindly could apply it twice.
+     */
+    mayHaveApplied: boolean;
+}
+/** An error in words: for the toolkit's `ErrorState` (title, description, details). */
+export interface DescribedError {
+    kind: ErrorKind;
+    /** What happened, one line ("Die Engine prod ist nicht erreichbar (HTTP 503)"). */
+    title: string;
+    /** What you can do next. */
+    hint: string;
+    /** The raw reason for the collapsed "Details"; null when there was none. */
+    details: string | null;
+}
+/**
+ * The facts of an engine or transport error, read from its text (the wire
+ * carries text only: a tool's `isError` answer, a JSON-RPC error, a failed
+ * fetch) plus a numeric `status`/`httpStatus` when the object has one. Pure:
+ * no words, no locale.
+ */
+export declare function classifyError(error: unknown): ErrorFacts;
+export interface DescribeErrorOptions {
+    /**
+     * The title for an error the kit cannot classify, in the caller's words
+     * ("Die Prozessliste konnte nicht geladen werden"). Default: the kit's
+     * "Das hat nicht geklappt" / "Something went wrong".
+     */
+    fallbackTitle?: string;
+}
+/**
+ * An engine or transport error in the words of the active locale (en/de by
+ * `supportedLanguage`, English otherwise): what happened, what you can do,
+ * and the raw text for a collapsed "Details" — never the raw
+ * "[503 ProcessEngineException] …" as the headline. Feed the result to the
+ * toolkit's `ErrorState` (`title`, `description` = hint, `details`); the
+ * kit's `ViewDataState`, `QueryFallback`, `useDetailView`, `ConfirmDialog`
+ * and `useActionFeedback` do.
+ */
+export declare function describeError(error: unknown, locale: string | undefined, options?: DescribeErrorOptions): DescribedError;
+//# sourceMappingURL=describe-error.d.ts.map

package/dist/ui/describe-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-error.d.ts","sourceRoot":"","sources":["../../src/ui/describe-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAsC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAExF,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,kHASd,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAA;IACf,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,4EAA4E;IAC5E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAA;IACf,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAyGD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAYxD;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAgBhB"}

package/dist/ui/describe-error.js

@@ -0,0 +1,175 @@
+import { supportedLanguage } from "./host-context.js";
+import { ERROR_LABELS } from "./error-labels.js";
+/**
+ * What kind of failure an error text describes:
+ * - `unreachable`: no connection, or the source answered 502/503;
+ * - `timeout`: the deadline passed (the client's, or a 408/504);
+ * - `notOnServer`: the tool is not on this server (its module is inactive);
+ * - `unauthorized` / `forbidden`: the source refused the server (401 / 403);
+ * - `notFound`: the entry is gone (404);
+ * - `failed`: any other error status or engine exception;
+ * - `unknown`: nothing the kit recognises.
+ */
+export const ERROR_KINDS = [
+    "unreachable",
+    "timeout",
+    "notOnServer",
+    "unauthorized",
+    "forbidden",
+    "notFound",
+    "failed",
+    "unknown",
+];
+/**
+ * `[503 ProcessEngineException] …` (the camunda7 client's engine responses,
+ * `withToolErrors`' `[code] …`) and `Prometheus query failed (503 …)`.
+ */
+const BRACKET_STATUS = /\[(\d{3})(?:[\s\]])/;
+const PROMETHEUS_STATUS = /Prometheus query failed \((\d{3})\b/;
+/** The engine id the camunda7 client appends or leads with. */
+const ENGINE_ID = /\(engine ([^\s)]+)\)|\bengine (\S+) (?:unreachable|did not respond)|connection to engine (\S+) failed/;
+const ENGINE = /\bengine\b|ProcessEngineException|\bCamunda\b|\bCIB seven\b/i;
+const PROMETHEUS = /\bPrometheus\b/;
+const TOOL_MISSING = /\btool\b[^\n]*\bnot found\b|\bunknown tool\b|-32601\b|\bmethod not found\b/i;
+const TIMEOUT = /\(timeout\)|\btimed? ?out\b|-32001\b|did not respond within/i;
+const UNREACHABLE = /\bunreachable\b|\bconnection to \S+(?: \S+)? failed\b|ECONNREFUSED|ENOTFOUND|EHOSTUNREACH|ENETUNREACH|EAI_AGAIN|\bfailed to fetch\b|\bfetch failed\b|\bnetworkerror\b|\bload failed\b/i;
+/** The camunda7 client's caveat on a write whose outcome is unknown. */
+const WRITE_CAVEAT = /the \w+ may still have been applied\b/i;
+/** The bracketed status and exception: `[500 ProcessEngineException] `. */
+const STATUS_CODE = /\[\d{3}(?:\s[^\]\n]{0,120})?\]\s*/;
+/** Any other leading bracketed code (`withToolErrors`' `[code] …`). */
+const LEADING_CODE = /^\[[^\]\n]{1,120}\]\s*/;
+/** The engine id the camunda7 client appends: ` (engine prod)`. */
+const ENGINE_SUFFIX = /\(engine [^\s)]+\)$/;
+/*
+ * The cuts below trim whitespace with String#trimEnd instead of `\s*` in the
+ * patterns: a leading `\s*` on an unanchored pattern backtracks polynomially
+ * over a long whitespace run (CodeQL js/polynomial-redos), and these helpers
+ * read error text that comes from the wire.
+ */
+/** The text before the write caveat, without the separator that led into it. */
+function withoutWriteCaveat(text) {
+    const caveat = WRITE_CAVEAT.exec(text);
+    if (!caveat)
+        return text;
+    const head = text.slice(0, caveat.index).trimEnd();
+    return /[—;-]$/.test(head) ? head.slice(0, -1).trimEnd() : head;
+}
+/** The text without the trailing ` (engine <id>)` the client appends. */
+function withoutEngineSuffix(text) {
+    const trimmed = text.trimEnd();
+    const suffix = ENGINE_SUFFIX.exec(trimmed);
+    return suffix ? trimmed.slice(0, suffix.index).trimEnd() : text;
+}
+/** The raw text as the source's own words (see {@link ErrorFacts.reason}). */
+function reasonOf(text) {
+    const rest = withoutWriteCaveat(text);
+    const code = STATUS_CODE.exec(rest);
+    const words = code ? rest.slice(code.index + code[0].length) : rest.replace(LEADING_CODE, "");
+    return withoutEngineSuffix(words).trim() || null;
+}
+/** The message of whatever was thrown (an `Error`, a string, an `{ message }`). */
+function rawText(error) {
+    if (error instanceof Error)
+        return error.message.trim() || null;
+    if (typeof error === "string")
+        return error.trim() || null;
+    if (typeof error === "object" && error !== null) {
+        const message = error.message;
+        if (typeof message === "string")
+            return message.trim() || null;
+    }
+    return null;
+}
+/** A numeric HTTP status on the error object (`status` / `httpStatus`), or in its text. */
+function statusOf(error, text) {
+    if (typeof error === "object" && error !== null) {
+        for (const key of ["httpStatus", "status"]) {
+            const value = error[key];
+            if (typeof value === "number" && value >= 100 && value <= 599)
+                return value;
+        }
+    }
+    const match = BRACKET_STATUS.exec(text) ?? PROMETHEUS_STATUS.exec(text);
+    return match ? Number(match[1]) : undefined;
+}
+function sourceOf(text) {
+    const id = ENGINE_ID.exec(text);
+    if (id)
+        return { type: "engine", id: id[1] ?? id[2] ?? id[3] };
+    if (PROMETHEUS.test(text))
+        return { type: "prometheus" };
+    if (ENGINE.test(text))
+        return { type: "engine" };
+    return { type: "unknown" };
+}
+/** The kind an HTTP status stands for. */
+function kindOfStatus(status) {
+    if (status === 401)
+        return "unauthorized";
+    if (status === 403)
+        return "forbidden";
+    if (status === 404)
+        return "notFound";
+    if (status === 408 || status === 504)
+        return "timeout";
+    if (status === 502 || status === 503)
+        return "unreachable";
+    return "failed";
+}
+function kindOf(text, status) {
+    if (TOOL_MISSING.test(text))
+        return "notOnServer";
+    if (status !== undefined)
+        return kindOfStatus(status);
+    if (TIMEOUT.test(text))
+        return "timeout";
+    if (UNREACHABLE.test(text))
+        return "unreachable";
+    return "unknown";
+}
+/**
+ * The facts of an engine or transport error, read from its text (the wire
+ * carries text only: a tool's `isError` answer, a JSON-RPC error, a failed
+ * fetch) plus a numeric `status`/`httpStatus` when the object has one. Pure:
+ * no words, no locale.
+ */
+export function classifyError(error) {
+    const raw = rawText(error);
+    const text = raw ?? "";
+    const status = statusOf(error, text);
+    return {
+        kind: kindOf(text, status),
+        ...(status !== undefined ? { status } : {}),
+        source: sourceOf(text),
+        raw,
+        reason: reasonOf(text),
+        mayHaveApplied: WRITE_CAVEAT.test(text),
+    };
+}
+/**
+ * An engine or transport error in the words of the active locale (en/de by
+ * `supportedLanguage`, English otherwise): what happened, what you can do,
+ * and the raw text for a collapsed "Details" — never the raw
+ * "[503 ProcessEngineException] …" as the headline. Feed the result to the
+ * toolkit's `ErrorState` (`title`, `description` = hint, `details`); the
+ * kit's `ViewDataState`, `QueryFallback`, `useDetailView`, `ConfirmDialog`
+ * and `useActionFeedback` do.
+ */
+export function describeError(error, locale, options = {}) {
+    const labels = ERROR_LABELS[supportedLanguage(locale) ?? "en"];
+    const facts = classifyError(error);
+    const words = labels[facts.kind];
+    const source = labels.source({ source: facts.source });
+    const status = facts.status === undefined ? "" : labels.status({ status: facts.status });
+    const title = facts.kind === "unknown" && options.fallbackTitle
+        ? options.fallbackTitle
+        : words.title({ source, status });
+    return {
+        kind: facts.kind,
+        title,
+        hint: words.hint({ source: facts.source.type }),
+        details: facts.raw,
+    };
+}
+//# sourceMappingURL=describe-error.js.map

package/dist/ui/describe-error.js.map

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

package/dist/ui/describe-error.test.d.ts

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

package/dist/ui/describe-error.test.d.ts.map

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

package/dist/ui/describe-error.test.js

@@ -0,0 +1,274 @@
+import { describe, expect, it } from "vitest";
+import { classifyError, describeError } from "./describe-error.js";
+/**
+ * The mapping table (U1): every error text the wire carries into a widget —
+ * the camunda7 client's engine responses through `withToolErrors`, its
+ * network and deadline failures, Prometheus', a JSON-RPC "tool not found"
+ * from a server without the module, a browser's failed fetch — onto one
+ * kind, its status and its source.
+ */
+const TABLE = [
+    [
+        "[503 ProcessEngineException] Engine is shutting down (engine prod-leasing)",
+        "unreachable",
+        503,
+        "engine:prod-leasing",
+    ],
+    [
+        "[502] Bad Gateway — empty response body (engine billing)",
+        "unreachable",
+        502,
+        "engine:billing",
+    ],
+    ["engine prod-a unreachable (ECONNREFUSED)", "unreachable", undefined, "engine:prod-a"],
+    [
+        "connection to engine prod-a failed (UND_ERR_SOCKET) — the POST may still have been applied",
+        "unreachable",
+        undefined,
+        "engine:prod-a",
+    ],
+    ["Prometheus unreachable (ENOTFOUND)", "unreachable", undefined, "prometheus"],
+    ["Prometheus query failed (503): service unavailable", "unreachable", 503, "prometheus"],
+    ["TypeError: Failed to fetch", "unreachable", undefined, "unknown"],
+    [
+        "engine prod-a did not respond within 30000 ms (timeout)",
+        "timeout",
+        undefined,
+        "engine:prod-a",
+    ],
+    ["Prometheus did not respond within 10000 ms (timeout)", "timeout", undefined, "prometheus"],
+    ["MCP error -32001: Request timed out", "timeout", undefined, "unknown"],
+    ["[504] Gateway Timeout (engine prod)", "timeout", 504, "engine:prod"],
+    ["Tool camunda7_process_list_data not found", "notOnServer", undefined, "unknown"],
+    ["MCP error -32602: Tool analytics_settings_data not found", "notOnServer", undefined, "unknown"],
+    ["Unknown tool: camunda7_jobs_data", "notOnServer", undefined, "unknown"],
+    [
+        "[401] Unauthorized (engine prod). Check CAMUNDA_ENGINES_JSON credentials",
+        "unauthorized",
+        401,
+        "engine:prod",
+    ],
+    [
+        "Prometheus query failed (403): forbidden — check the configured Prometheus credentials",
+        "forbidden",
+        403,
+        "prometheus",
+    ],
+    [
+        "[404 InvalidRequestException] Process instance with id x does not exist (engine prod-a)",
+        "notFound",
+        404,
+        "engine:prod-a",
+    ],
+    [
+        "[500 ProcessEngineException] Cannot resolve incident (engine prod-a)",
+        "failed",
+        500,
+        "engine:prod-a",
+    ],
+    ["[400 InvalidRequestException] Invalid variable value", "failed", 400, "unknown"],
+    [
+        "[ENGINE_NOT_SELECTED] No engine specified and no default engine saved.",
+        "unknown",
+        undefined,
+        "engine",
+    ],
+    ["Something odd happened", "unknown", undefined, "unknown"],
+];
+function sourceTag(source) {
+    if (source.type === "engine")
+        return source.id ? `engine:${source.id}` : "engine";
+    return source.type;
+}
+describe("classifyError — the mapping table", () => {
+    it.each(TABLE)("%s → %s", (raw, kind, status, source) => {
+        const facts = classifyError(new Error(raw));
+        expect(facts.kind).toBe(kind);
+        expect(facts.status).toBe(status);
+        expect(sourceTag(facts.source)).toBe(source);
+        expect(facts.raw).toBe(raw);
+    });
+    it("reads a numeric status off the error object before the text", () => {
+        const error = Object.assign(new Error("no details"), { httpStatus: 403 });
+        expect(classifyError(error)).toMatchObject({ kind: "forbidden", status: 403 });
+        expect(classifyError({ message: "x", status: 401 })).toMatchObject({ kind: "unauthorized" });
+        // Out of range or not a number: ignored.
+        expect(classifyError({ message: "x", status: 42 }).kind).toBe("unknown");
+        expect(classifyError({ message: "x", status: "503" }).kind).toBe("unknown");
+    });
+    it("takes strings, { message } objects and anything else", () => {
+        expect(classifyError("engine e unreachable (ECONNREFUSED)").kind).toBe("unreachable");
+        expect(classifyError({ message: "Prometheus unreachable (x)" }).source).toEqual({
+            type: "prometheus",
+        });
+        expect(classifyError(null)).toEqual({
+            kind: "unknown",
+            source: { type: "unknown" },
+            raw: null,
+            reason: null,
+            mayHaveApplied: false,
+        });
+        expect(classifyError(42).raw).toBeNull();
+        expect(classifyError({ message: 7 }).raw).toBeNull();
+        expect(classifyError(new Error("   ")).raw).toBeNull();
+        expect(classifyError("  ").raw).toBeNull();
+    });
+    it("a missing tool wins over a status in the same text", () => {
+        expect(classifyError("[404] Tool x not found").kind).toBe("notOnServer");
+    });
+    it("reads the source's own reason: no status code, engine suffix or write caveat", () => {
+        const reason = (text) => classifyError(text).reason;
+        expect(reason("[500 ProcessEngineException] Cannot resolve incident (engine prod)")).toBe("Cannot resolve incident");
+        // A prefix before the bracket (a transport's wrapper) goes with it.
+        expect(reason("Error: [400 InvalidRequestException] Bad value. (engine p)")).toBe("Bad value.");
+        expect(reason("[VALIDATION] amount must be positive")).toBe("amount must be positive");
+        expect(reason("connection to engine prod failed (UND_ERR_SOCKET) — the POST may still have been applied; check the current state before retrying")).toBe("connection to engine prod failed (UND_ERR_SOCKET)");
+        expect(reason("[500] (engine prod)")).toBeNull();
+        expect(reason("plain words")).toBe("plain words");
+    });
+    it("knows a write whose answer never came may have gone through", () => {
+        expect(classifyError("engine prod did not respond within 30000 ms (timeout) — the PUT may still have been applied; check the current state before retrying").mayHaveApplied).toBe(true);
+        // A read's timeout carries no caveat; an engine refusal never does.
+        expect(classifyError("engine prod did not respond within 30000 ms (timeout)").mayHaveApplied).toBe(false);
+        expect(classifyError("[500 X] boom (engine prod)").mayHaveApplied).toBe(false);
+    });
+});
+describe("classifyError — hostile input stays linear (CodeQL js/polynomial-redos)", () => {
+    const spaces = " ".repeat(100_000);
+    it("reads a long whitespace run before the write caveat and the engine suffix quickly", () => {
+        const started = performance.now();
+        const facts = classifyError(`[500 X] boom${spaces}— the POST may still have been applied`);
+        expect(facts.mayHaveApplied).toBe(true);
+        expect(facts.reason).toBe("boom");
+        expect(classifyError(`[500 X] boom${spaces}(engine prod)${spaces}`).reason).toBe("boom");
+        expect(classifyError(`[500 X] ${spaces}x`).reason).toBe("x");
+        expect(performance.now() - started).toBeLessThan(500);
+    });
+});
+describe("describeError — the words, en and de", () => {
+    const down = new Error("[503 ProcessEngineException] Engine is shutting down (engine prod-leasing)");
+    it("never leads with the raw engine text; it stays for Details", () => {
+        expect(describeError(down, "de-DE")).toEqual({
+            kind: "unreachable",
+            title: "Die Engine prod-leasing ist nicht erreichbar (HTTP 503)",
+            hint: "Prüf, ob die Engine läuft, oder wähl eine andere Engine.",
+            details: "[503 ProcessEngineException] Engine is shutting down (engine prod-leasing)",
+        });
+        expect(describeError(down, "en-US")).toMatchObject({
+            title: "Engine prod-leasing is unreachable (HTTP 503)",
+            hint: "Check that the engine is running, or pick another engine.",
+        });
+    });
+    it.each([
+        [
+            "engine e did not respond within 1 ms (timeout)",
+            "Die Engine e antwortet nicht rechtzeitig",
+            "Versuch es gleich noch mal. Passiert das öfter, ist die Engine vielleicht stark ausgelastet.",
+        ],
+        [
+            "Prometheus did not respond within 1 ms (timeout)",
+            "Prometheus antwortet nicht rechtzeitig",
+            "Versuch es gleich noch mal.",
+        ],
+        [
+            "Prometheus unreachable (ECONNREFUSED)",
+            "Prometheus ist nicht erreichbar",
+            "Prüf, ob Prometheus läuft und erreichbar ist.",
+        ],
+        [
+            "Failed to fetch",
+            "Die Datenquelle ist nicht erreichbar",
+            "Prüf die Verbindung und versuch es noch mal.",
+        ],
+        [
+            "Tool x not found",
+            "Diese Daten gibt es auf diesem Server nicht",
+            "Das zuständige Modul ist hier nicht aktiv. Frag im Chat, was du stattdessen tun kannst.",
+        ],
+        [
+            "[401] no (engine p)",
+            "Die Engine p lehnt die Zugangsdaten des Servers ab (HTTP 401)",
+            "Bitte die Person, die den Server betreibt, die Zugangsdaten zu prüfen.",
+        ],
+        [
+            "[403] no (engine p)",
+            "Die Engine p verweigert den Zugriff (HTTP 403)",
+            "Dem Konto des Servers fehlt dafür die Berechtigung. Bitte die Person, die den Server betreibt, das zu prüfen.",
+        ],
+        [
+            "[404] gone (engine p)",
+            "Diesen Eintrag gibt es nicht mehr",
+            "Er wurde vielleicht beendet oder gelöscht. Geh zurück zur Liste oder versuch es noch mal.",
+        ],
+        [
+            "[500 ProcessEngineException] boom",
+            "Die Engine meldet einen Fehler (HTTP 500)",
+            "Den Grund findest du unter Details. Versuch es noch mal oder frag im Chat nach.",
+        ],
+        [
+            "odd",
+            "Das hat nicht geklappt",
+            "Versuch es noch mal. Klappt es wieder nicht, frag im Chat nach.",
+        ],
+    ])("de: %s", (raw, title, hint) => {
+        expect(describeError(raw, "de")).toMatchObject({ title, hint });
+    });
+    it.each([
+        [
+            "engine e did not respond within 1 ms (timeout)",
+            "Engine e did not respond in time",
+            "Try again in a moment. If it keeps happening, the engine may be under heavy load.",
+        ],
+        [
+            "Prometheus did not respond within 1 ms (timeout)",
+            "Prometheus did not respond in time",
+            "Try again in a moment.",
+        ],
+        [
+            "Prometheus unreachable (ECONNREFUSED)",
+            "Prometheus is unreachable",
+            "Check that Prometheus is running and reachable.",
+        ],
+        ["Failed to fetch", "The data source is unreachable", "Check the connection, then try again."],
+        [
+            "Tool x not found",
+            "This data isn't available on this server",
+            "The module behind it isn't active here. Ask in the chat what you can do instead.",
+        ],
+        [
+            "[401] no (engine p)",
+            "Engine p rejected the server's credentials (HTTP 401)",
+            "Ask whoever runs this server to check its credentials.",
+        ],
+        [
+            "[403] no",
+            "The data source denied access (HTTP 403)",
+            "The server's account lacks the permission for this. Ask whoever runs the server to check it.",
+        ],
+        [
+            "[404] gone",
+            "This entry no longer exists",
+            "It may have ended or been deleted. Go back to the list, or try again.",
+        ],
+        [
+            "[500] boom (engine p)",
+            "Engine p reported an error (HTTP 500)",
+            "You'll find the reason under Details. Try again, or ask in the chat.",
+        ],
+        ["odd", "Something went wrong", "Try again. If it fails again, ask in the chat."],
+    ])("en: %s", (raw, title, hint) => {
+        expect(describeError(raw, "en")).toMatchObject({ title, hint });
+    });
+    it("English for an unsupported or missing locale", () => {
+        expect(describeError("odd", "fr-FR").title).toBe("Something went wrong");
+        expect(describeError("odd", undefined).title).toBe("Something went wrong");
+    });
+    it("an unclassified error takes the caller's title; a classified one keeps its own", () => {
+        expect(describeError("odd", "de", { fallbackTitle: "Liste nicht geladen" }).title).toBe("Liste nicht geladen");
+        expect(describeError(down, "de", { fallbackTitle: "Liste nicht geladen" }).title).toBe("Die Engine prod-leasing ist nicht erreichbar (HTTP 503)");
+    });
+    it("has no details without a raw text", () => {
+        expect(describeError(undefined, "en").details).toBeNull();
+    });
+});
+//# sourceMappingURL=describe-error.test.js.map

package/dist/ui/describe-error.test.js.map

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

package/dist/ui/display-mode-toggle.d.ts

@@ -0,0 +1,32 @@
+import { type ReactNode } from "react";
+/**
+ * The host's display mode as something a view can SWITCH — provided by the
+ * host bridge (`ViewHostBridge`); outside a host nothing can be switched.
+ */
+export interface DisplayModeControl {
+    displayMode: string;
+    /** The host offers fullscreen to this view. */
+    canFullscreen: boolean;
+    request: (mode: "inline" | "fullscreen") => void;
+}
+export declare function DisplayModeControlProvider({ control, children, }: {
+    control: DisplayModeControl;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useDisplayModeControl(): DisplayModeControl;
+/**
+ * Fullscreen and back, for a surface that hides the view's own chrome (the
+ * standalone drill-down, #344 N109): the same words as the toolkit's toolbar
+ * toggle, nothing where the host offers no fullscreen.
+ */
+export declare function DisplayModeToggle(): import("react").JSX.Element | null;
+/**
+ * The display modes every view of the bundle supports, for the roots'
+ * `bootstrapView({ default, viewConfig })` (#344 N159): inline as a card,
+ * fullscreen for the rest. Not picture-in-picture: no view is laid out for a
+ * small floating frame, so a host must not offer one.
+ */
+export declare const SHELL_VIEW_CONFIG: {
+    readonly displayModes: readonly ["inline", "fullscreen"];
+};
+//# sourceMappingURL=display-mode-toggle.d.ts.map

package/dist/ui/display-mode-toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-mode-toggle.d.ts","sourceRoot":"","sources":["../../src/ui/display-mode-toggle.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAKjE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,aAAa,EAAE,OAAO,CAAA;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,KAAK,IAAI,CAAA;CACjD;AAUD,wBAAgB,0BAA0B,CAAC,EACzC,OAAO,EACP,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,kBAAkB,CAAA;IAC3B,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAMA;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,uCAkBhC;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;CAAsD,CAAA"}