@miragon/mcp-toolkit-ui 2.6.0 → 2.8.0

package/dist/app/builder/builder-model.js

@@ -1,4 +1,4 @@
-import { normalizeLayout } from "@miragon/mcp-toolkit-core";
+import { normalizeLayout, PROPS_SCHEMA_DISPLAY_KEYWORD, resolveLocalizedText, } from "@miragon/mcp-toolkit-core";
 // -------------------------------------------------------------------------- //
 // Draft <-> layout conversions
 // -------------------------------------------------------------------------- //
@@ -92,17 +92,18 @@ export function entriesToKeys(entries) {
  * Compact preview of a value as it currently lives in the pipeline.
  * Used as the placeholder when the editor's `rawValue` is empty so the
  * user can see what the server is actually working with right now
- * without the editor overwriting their (empty) input.
+ * without the editor overwriting their (empty) input. `prefix` is the
+ * localized word for "live" (the builder passes its catalog's).
  */
-export function formatLiveKeyValue(value) {
+export function formatLiveKeyValue(value, prefix = "live") {
     if (value === undefined)
         return undefined;
     if (value === "")
         return undefined;
     if (typeof value === "string")
-        return `live: ${value}`;
+        return `${prefix}: ${value}`;
     try {
-        return `live: ${JSON.stringify(value)}`;
+        return `${prefix}: ${JSON.stringify(value)}`;
     }
     catch {
         return undefined;
@@ -171,4 +172,194 @@ export function toPipelineContext(ctx) {
     }
     return { steps, keys: ctx.keys, errors: ctx.errors };
 }
+/**
+ * A {@link DisplayKeyResolver} over a translate function that echoes unknown
+ * keys (the `createTranslator` / `useTranslate` contract): the echo, or a
+ * blank result, means "unknown", so the caller falls back to its inline text.
+ */
+export function keyResolverFrom(translate) {
+    return (key) => {
+        const text = translate(key).trim();
+        return text.length > 0 && text !== key ? text : undefined;
+    };
+}
+/**
+ * The i18n key's text when the resolver knows it, else the inline (per-locale)
+ * text. Display text crosses the wire (the catalogue, a `propsSchema`), so a
+ * key that is not a string is ignored instead of reaching the translator.
+ */
+function keyedText(key, text, locale, resolveKey) {
+    const viaKey = typeof key === "string" && resolveKey ? resolveKey(key) : undefined;
+    return viaKey ?? resolveLocalizedText(text, locale);
+}
+/**
+ * The builder's name for a widget or a step: its `titleKey` (when `resolveKey`
+ * knows it), its `title` in `locale`, else the id. The id comes back as `hint`
+ * only next to a real title. The `description` is the LLM's text and never
+ * appears here.
+ */
+export function displayLabel(entry, id, locale, resolveKey) {
+    const title = keyedText(entry.titleKey, entry.title, locale, resolveKey);
+    const summary = keyedText(entry.summaryKey, entry.summary, locale, resolveKey);
+    return {
+        label: title ?? id,
+        ...(title !== undefined && title !== id ? { hint: id } : {}),
+        ...(summary !== undefined ? { summary } : {}),
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * The props sheet's text for one `propsSchema` property. Label: the
+ * `x-display` title (key or text), else the standard JSON Schema `title`,
+ * else the property name. Help: the `x-display` summary, else the property's
+ * `description`.
+ */
+export function propFieldText(name, prop, locale, resolveKey) {
+    const raw = prop[PROPS_SCHEMA_DISPLAY_KEYWORD];
+    const display = isRecord(raw) ? raw : {};
+    const schemaTitle = typeof prop.title === "string" ? prop.title : undefined;
+    const label = keyedText(display.titleKey, display.title, locale, resolveKey) ??
+        resolveLocalizedText(schemaTitle, locale) ??
+        name;
+    const schemaHelp = typeof prop.description === "string" ? prop.description : undefined;
+    const help = keyedText(display.summaryKey, display.summary, locale, resolveKey) ??
+        resolveLocalizedText(schemaHelp, locale);
+    return {
+        label,
+        ...(label !== name ? { hint: name } : {}),
+        ...(help !== undefined ? { help } : {}),
+    };
+}
+// -------------------------------------------------------------------------- //
+// Draft status — what Apply, Discard and the unsaved marker compare
+// -------------------------------------------------------------------------- //
+/**
+ * Whether the draft holds at least one element on ANY tab, not only the
+ * active one: a new, still empty tab must not disable "Save as dashboard" or
+ * the preview while another tab has content.
+ */
+export function draftHasCells(draft) {
+    const rows = draft.kind === "tabs" ? draft.tabs.flatMap((t) => t.rows) : draft.rows;
+    return rows.some((r) => r.row.length > 0);
+}
+/**
+ * A comparable fingerprint of what Apply and Save hand on: the layout, the
+ * keys (blank names dropped, values parsed) and the steps that name a step.
+ * An empty key or step row the user has not filled in changes nothing.
+ */
+export function builderSnapshot(draft, keyEntries, stepEntries) {
+    return JSON.stringify({
+        layout: draftToLayout(draft),
+        keys: entriesToKeys(keyEntries),
+        steps: stepEntries.filter((s) => s.step.trim().length > 0),
+    });
+}
+/**
+ * The commit of Apply: the layout, keys and steps exactly as a save would send
+ * them, and the live context in its wire shape (`stepIds` + keyed `stepData`)
+ * so the view renders the just-built layout without another round trip.
+ */
+export function toExitCommit(draft, keyEntries, stepEntries, title, live) {
+    return {
+        layout: draftToLayout(draft),
+        keys: entriesToKeys(keyEntries),
+        steps: stepEntries.filter((s) => s.step.trim().length > 0),
+        title,
+        context: {
+            keys: live.keys,
+            stepIds: Object.keys(live.steps),
+            stepData: Object.fromEntries(Object.entries(live.steps).map(([id, result]) => [
+                id,
+                { data: result.data, keys: result.keys, _app: result._app, _dataType: result._dataType },
+            ])),
+            errors: live.errors,
+        },
+    };
+}
+/** Compares the current {@link builderSnapshot} with the pre-edit one and the last saved one. */
+export function draftStatus(current, baseline, saved) {
+    const changed = current !== baseline;
+    return { changed, unsaved: changed && current !== saved };
+}
+/**
+ * The builder's leave actions. Apply hands `commit()` to `onExit`. Discard
+ * calls `onExit()` WITHOUT a commit, so the view stays as it was before
+ * editing; without `onExit` it calls `onReset()`, which restores the draft in
+ * place. Discard asks first (`confirm`) only when the draft `changed` the
+ * view: a draft that matches the view before editing loses nothing, even when
+ * it differs from a saved dashboard.
+ */
+export function builderLeave({ changed, onExit, onReset, commit, confirm, }) {
+    // Never hands its own arguments on: a click event must not reach `onExit` as a commit.
+    const discardNow = () => {
+        if (onExit)
+            onExit();
+        else
+            onReset();
+    };
+    return {
+        ...(onExit ? { apply: () => onExit(commit()) } : {}),
+        discard: () => {
+            if (changed)
+                confirm();
+            else
+                discardNow();
+        },
+        discardNow,
+    };
+}
+// -------------------------------------------------------------------------- //
+// Keyboard — tab rename without a double-click
+// -------------------------------------------------------------------------- //
+/**
+ * What a key press on a tab trigger does: F2 renames any tab; Enter renames
+ * the tab that is already active (on another tab Enter keeps selecting it,
+ * the tabs' own behaviour). `null` leaves the key to the tabs.
+ */
+export function tabTriggerKeyAction(key, isActive) {
+    if (key === "F2")
+        return "rename";
+    if (key === "Enter" && isActive)
+        return "rename";
+    return null;
+}
+/** What a key press in a tab's rename field does: Enter commits, Escape cancels. */
+export function renameFieldKeyAction(key) {
+    if (key === "Enter")
+        return "commit";
+    if (key === "Escape")
+        return "cancel";
+    return null;
+}
+/** A {@link TabRefocus} with no open request. */
+export function createTabRefocus() {
+    let pending = null;
+    const request = (tabIdx) => {
+        pending = tabIdx;
+    };
+    const attach = (tabIdx, el) => {
+        if (el === null || pending !== tabIdx)
+            return;
+        pending = null;
+        el.focus();
+    };
+    return {
+        request,
+        attach,
+        forTab: (tabIdx) => ({
+            triggerRef: (el) => attach(tabIdx, el),
+            onRefocus: () => request(tabIdx),
+        }),
+    };
+}
+/** The builder's views in tab order: the data sources ("pipeline") only in advanced mode. */
+export function builderViews(advanced) {
+    return advanced ? ["layout", "pipeline", "preview"] : ["layout", "preview"];
+}
+/** The view to show after advanced mode switches: a view that is now hidden falls back to the layout. */
+export function viewAfterAdvancedToggle(view, advanced) {
+    return builderViews(advanced).includes(view) ? view : "layout";
+}
 //# sourceMappingURL=builder-model.js.map

package/dist/app/builder/builder-model.js.map

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

package/dist/app/builder/labels.d.ts

@@ -4,69 +4,20 @@
  * Extracted from `layout-builder.tsx` so the presentational sub-components
  * (Toolbar, PipelineStrip, Workspace, CatalogueSheet, SaveDialog, PreviewPane)
  * can depend on the labels without importing the orchestrating container —
- * which would create an import cycle. React-free and `mcp-use`-free.
+ * which would create an import cycle. React-free and `mcp-use`-free. The
+ * strings themselves live in the toolkit catalog (`locale/messages-*.ts`).
+ */
+import { type BuilderMessages } from "../../locale/toolkit-messages.js";
+/**
+ * Override strings for every user-facing caption in the builder. Each field
+ * defaults to the active locale's toolkit catalog (`useToolkitMessages().builder`).
+ */
+export type LayoutBuilderLabels = Partial<BuilderMessages>;
+/**
+ * English builder strings.
+ * @deprecated Read the active locale's strings with `useToolkitMessages().builder`
+ * (or `TOOLKIT_MESSAGES.en.builder`); this alias stays for existing imports.
  */
-export interface LayoutBuilderLabels {
-    title?: string;
-    builderBadge?: string;
-    previewBadge?: string;
-    catalogue?: string;
-    save?: string;
-    done?: string;
-    viewLayoutTab?: string;
-    viewPipelineTab?: string;
-    viewPreviewTab?: string;
-    saveDialogTitle?: string;
-    saveDialogDescription?: string;
-    saveNameLabel?: string;
-    saveDescriptionLabel?: string;
-    saveConfirm?: string;
-    cancel?: string;
-    pipelineHeader?: string;
-    keysHeader?: string;
-    stepsHeader?: string;
-    keyName?: string;
-    keyValue?: string;
-    stepContextId?: string;
-    stepPickerLabel?: string;
-    addKey?: string;
-    addStep?: string;
-    emptyKeys?: string;
-    emptySteps?: string;
-    statusUpToDate?: string;
-    statusPending?: string;
-    statusRefreshing?: string;
-    paletteHeader?: string;
-    paletteEmpty?: string;
-    canvasEmpty?: string;
-    canvasDropHint?: string;
-    addRow?: string;
-    addTab?: string;
-    removeRow?: string;
-    renameTab?: string;
-    removeTab?: string;
-    tabsLabel?: string;
-    catalogueDescription?: string;
-    catalogueKeys?: string;
-    catalogueSteps?: string;
-    catalogueUnreachable?: string;
-    catalogueUnreachableEmpty?: string;
-    catalogueProducedBy?: string;
-    catalogueConsumedBy?: string;
-    catalogueNeedsKeys?: string;
-    cataloguePickKey?: string;
-    catalogueAddProducingStep?: string;
-    catalogueLive?: string;
-    catalogueMissing?: string;
-    /** Banner shown when the catalogue fetch fails (prefixes the reason). */
-    catalogueError?: string;
-    /** Heading for the pipeline-validation warning banner. */
-    validationWarning?: string;
-    /** Inline message when a save fails (prefixes the reason). */
-    saveError?: string;
-    /** Inline message when a tab rename is rejected (duplicate label). */
-    renameDuplicate?: string;
-}
 export declare const DEFAULT_LABELS: Required<LayoutBuilderLabels>;
 /**
  * MIME type used to carry a widget id across the palette → canvas drag.

package/dist/app/builder/labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/app/builder/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,mBAAmB,CA0DxD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,gCAAgC,CAAA;AAE7D,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAA"}
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/app/builder/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAEzF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;AAE1D;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,mBAAmB,CAA+B,CAAA;AAExF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,gCAAgC,CAAA;AAE7D,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAA"}

package/dist/app/builder/labels.js

@@ -4,65 +4,16 @@
  * Extracted from `layout-builder.tsx` so the presentational sub-components
  * (Toolbar, PipelineStrip, Workspace, CatalogueSheet, SaveDialog, PreviewPane)
  * can depend on the labels without importing the orchestrating container —
- * which would create an import cycle. React-free and `mcp-use`-free.
+ * which would create an import cycle. React-free and `mcp-use`-free. The
+ * strings themselves live in the toolkit catalog (`locale/messages-*.ts`).
  */
-export const DEFAULT_LABELS = {
-    title: "View Builder",
-    builderBadge: "Builder",
-    previewBadge: "Preview",
-    catalogue: "Catalogue",
-    save: "Save",
-    done: "Done",
-    viewLayoutTab: "Layout",
-    viewPipelineTab: "Pipeline",
-    viewPreviewTab: "Preview",
-    saveDialogTitle: "Save dashboard",
-    saveDialogDescription: "Persists the current layout along with the keys and steps that populate it.",
-    saveNameLabel: "Name",
-    saveDescriptionLabel: "Description",
-    saveConfirm: "Save dashboard",
-    cancel: "Cancel",
-    pipelineHeader: "Pipeline",
-    keysHeader: "Keys",
-    stepsHeader: "Steps",
-    keyName: "key",
-    keyValue: 'value, "literal", true, {…}',
-    stepContextId: "ctx id",
-    stepPickerLabel: "pick a step",
-    addKey: "Add key",
-    addStep: "Add step",
-    emptyKeys: "No keys seeded.",
-    emptySteps: "No steps configured.",
-    statusUpToDate: "Up to date",
-    statusPending: "Applying soon…",
-    statusRefreshing: "Applying…",
-    paletteHeader: "Palette",
-    paletteEmpty: "No widgets reachable yet — seed a key or add a step.",
-    canvasEmpty: "Drag a widget here, or click one in the palette.",
-    canvasDropHint: "Drop to add",
-    addRow: "Add row",
-    addTab: "Add tab",
-    removeRow: "Remove row",
-    renameTab: "Rename tab",
-    removeTab: "Remove tab",
-    tabsLabel: "Tabs",
-    catalogueDescription: "Every key and widget the framework knows about, whether or not it's reachable right now.",
-    catalogueKeys: "Keys",
-    catalogueSteps: "Steps",
-    catalogueUnreachable: "Unreachable widgets",
-    catalogueUnreachableEmpty: "Every registered widget is reachable.",
-    catalogueProducedBy: "produced by",
-    catalogueConsumedBy: "consumed by",
-    catalogueNeedsKeys: "needs",
-    cataloguePickKey: "Add as key",
-    catalogueAddProducingStep: "Add producing step",
-    catalogueLive: "live",
-    catalogueMissing: "missing",
-    catalogueError: "Couldn't refresh the builder catalogue",
-    validationWarning: "This pipeline won't render as configured",
-    saveError: "Couldn't save",
-    renameDuplicate: "A tab with that name already exists.",
-};
+import { TOOLKIT_MESSAGES } from "../../locale/toolkit-messages.js";
+/**
+ * English builder strings.
+ * @deprecated Read the active locale's strings with `useToolkitMessages().builder`
+ * (or `TOOLKIT_MESSAGES.en.builder`); this alias stays for existing imports.
+ */
+export const DEFAULT_LABELS = TOOLKIT_MESSAGES.en.builder;
 /**
  * MIME type used to carry a widget id across the palette → canvas drag.
  * Shared between the palette items and the canvas drop targets.

package/dist/app/builder/labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../src/app/builder/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgEH,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,KAAK,EAAE,cAAc;IACrB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,QAAQ;IACvB,eAAe,EAAE,UAAU;IAC3B,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,gBAAgB;IACjC,qBAAqB,EACnB,6EAA6E;IAC/E,aAAa,EAAE,MAAM;IACrB,oBAAoB,EAAE,aAAa;IACnC,WAAW,EAAE,gBAAgB;IAC7B,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,UAAU;IAC1B,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,6BAA6B;IACvC,aAAa,EAAE,QAAQ;IACvB,eAAe,EAAE,aAAa;IAC9B,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,sBAAsB;IAClC,cAAc,EAAE,YAAY;IAC5B,aAAa,EAAE,gBAAgB;IAC/B,gBAAgB,EAAE,WAAW;IAC7B,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,sDAAsD;IACpE,WAAW,EAAE,kDAAkD;IAC/D,cAAc,EAAE,aAAa;IAC7B,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,MAAM;IACjB,oBAAoB,EAClB,0FAA0F;IAC5F,aAAa,EAAE,MAAM;IACrB,cAAc,EAAE,OAAO;IACvB,oBAAoB,EAAE,qBAAqB;IAC3C,yBAAyB,EAAE,uCAAuC;IAClE,mBAAmB,EAAE,aAAa;IAClC,mBAAmB,EAAE,aAAa;IAClC,kBAAkB,EAAE,OAAO;IAC3B,gBAAgB,EAAE,YAAY;IAC9B,yBAAyB,EAAE,oBAAoB;IAC/C,aAAa,EAAE,MAAM;IACrB,gBAAgB,EAAE,SAAS;IAC3B,cAAc,EAAE,wCAAwC;IACxD,iBAAiB,EAAE,0CAA0C;IAC7D,SAAS,EAAE,eAAe;IAC1B,eAAe,EAAE,sCAAsC;CACxD,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,6BAA6B,CAAA"}
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../src/app/builder/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAwB,MAAM,kCAAkC,CAAA;AAQzF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkC,gBAAgB,CAAC,EAAE,CAAC,OAAO,CAAA;AAExF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,6BAA6B,CAAA"}

package/dist/app/builder/reveal.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Secondary builder controls (row, tab and cell actions) stay quiet until the
+ * pointer is over their group or focus is anywhere inside it, and are always
+ * visible where nothing can hover (touch screens). Spread it on the controls'
+ * container inside an element with `group`; a control that is never revealed
+ * by hover alone is a CI §12 rule ("alles per Tastatur bedienbar"), guarded by
+ * `builder-ux.test.tsx`.
+ */
+export declare const REVEAL_ON_INTENT = "opacity-0 transition-opacity group-hover:opacity-100 group-focus-within:opacity-100 focus-within:opacity-100 [@media(hover:none)]:opacity-100";
+//# sourceMappingURL=reveal.d.ts.map

package/dist/app/builder/reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal.d.ts","sourceRoot":"","sources":["../../../src/app/builder/reveal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,kJACoH,CAAA"}

package/dist/app/builder/reveal.js

@@ -0,0 +1,10 @@
+/**
+ * Secondary builder controls (row, tab and cell actions) stay quiet until the
+ * pointer is over their group or focus is anywhere inside it, and are always
+ * visible where nothing can hover (touch screens). Spread it on the controls'
+ * container inside an element with `group`; a control that is never revealed
+ * by hover alone is a CI §12 rule ("alles per Tastatur bedienbar"), guarded by
+ * `builder-ux.test.tsx`.
+ */
+export const REVEAL_ON_INTENT = "opacity-0 transition-opacity group-hover:opacity-100 group-focus-within:opacity-100 focus-within:opacity-100 [@media(hover:none)]:opacity-100";
+//# sourceMappingURL=reveal.js.map

package/dist/app/builder/reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal.js","sourceRoot":"","sources":["../../../src/app/builder/reveal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,+IAA+I,CAAA"}

package/dist/app/builder/status-chip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-chip.d.ts","sourceRoot":"","sources":["../../../src/app/builder/status-chip.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAErE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,CAAC,GACF,EAAE;IACD,MAAM,EAAE,aAAa,CAAA;IACrB,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;CACjC,+BAuBA"}
+{"version":3,"file":"status-chip.d.ts","sourceRoot":"","sources":["../../../src/app/builder/status-chip.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAErE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,CAAC,GACF,EAAE;IACD,MAAM,EAAE,aAAa,CAAA;IACrB,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;CACjC,+BA0BA"}

package/dist/app/builder/status-chip.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { CircleDot, Loader2 } from "lucide-react";
+import { TONE_DOT, TONE_TEXT } from "../../lib/tone-utils.js";
 /**
  * Compact auto-apply status chip. Shared by the Toolbar and the
  * PipelineStrip so both surfaces show the same refresh state.
@@ -9,8 +10,8 @@ export function StatusChip({ status, L, }) {
         return (_jsxs("span", { className: "text-muted-foreground inline-flex items-center gap-1.5", children: [_jsx(CircleDot, { className: "size-3" }), L.statusUpToDate] }));
     }
     if (status === "pending") {
-        return (_jsxs("span", { className: "inline-flex items-center gap-1.5 text-amber-600 dark:text-amber-400", children: [_jsx("span", { className: "size-1.5 animate-pulse rounded-full bg-amber-500" }), L.statusPending] }));
+        return (_jsxs("span", { className: `inline-flex items-center gap-1.5 ${TONE_TEXT.warning}`, children: [_jsx("span", { "aria-hidden": "true", className: `size-1.5 animate-pulse rounded-full ${TONE_DOT.warning}` }), L.statusPending] }));
     }
-    return (_jsxs("span", { className: "text-primary inline-flex items-center gap-1.5", children: [_jsx(Loader2, { className: "size-3 animate-spin" }), L.statusRefreshing] }));
+    return (_jsxs("span", { className: `inline-flex items-center gap-1.5 ${TONE_TEXT.info}`, children: [_jsx(Loader2, { "aria-hidden": "true", className: "size-3 animate-spin" }), L.statusRefreshing] }));
 }
 //# sourceMappingURL=status-chip.js.map

package/dist/app/builder/status-chip.js.map

@@ -1 +1 @@
-{"version":3,"file":"status-chip.js","sourceRoot":"","sources":["../../../src/app/builder/status-chip.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGjD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,MAAM,EACN,CAAC,GAIF;IACC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CACL,gBAAM,SAAS,EAAC,wDAAwD,aACtE,KAAC,SAAS,IAAC,SAAS,EAAC,QAAQ,GAAG,EAC/B,CAAC,CAAC,cAAc,IACZ,CACR,CAAA;IACH,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CACL,gBAAM,SAAS,EAAC,qEAAqE,aACnF,eAAM,SAAS,EAAC,kDAAkD,GAAG,EACpE,CAAC,CAAC,aAAa,IACX,CACR,CAAA;IACH,CAAC;IACD,OAAO,CACL,gBAAM,SAAS,EAAC,+CAA+C,aAC7D,KAAC,OAAO,IAAC,SAAS,EAAC,qBAAqB,GAAG,EAC1C,CAAC,CAAC,gBAAgB,IACd,CACR,CAAA;AACH,CAAC"}
+{"version":3,"file":"status-chip.js","sourceRoot":"","sources":["../../../src/app/builder/status-chip.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAG7D;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,MAAM,EACN,CAAC,GAIF;IACC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CACL,gBAAM,SAAS,EAAC,wDAAwD,aACtE,KAAC,SAAS,IAAC,SAAS,EAAC,QAAQ,GAAG,EAC/B,CAAC,CAAC,cAAc,IACZ,CACR,CAAA;IACH,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CACL,gBAAM,SAAS,EAAE,oCAAoC,SAAS,CAAC,OAAO,EAAE,aACtE,8BACc,MAAM,EAClB,SAAS,EAAE,uCAAuC,QAAQ,CAAC,OAAO,EAAE,GACpE,EACD,CAAC,CAAC,aAAa,IACX,CACR,CAAA;IACH,CAAC;IACD,OAAO,CACL,gBAAM,SAAS,EAAE,oCAAoC,SAAS,CAAC,IAAI,EAAE,aACnE,KAAC,OAAO,mBAAa,MAAM,EAAC,SAAS,EAAC,qBAAqB,GAAG,EAC7D,CAAC,CAAC,gBAAgB,IACd,CACR,CAAA;AACH,CAAC"}

package/dist/app/builder/use-builder-catalogue.d.ts

@@ -1,4 +1,4 @@
-import type { AvailableStep, KeyCatalogEntry, PipelineContext, PipelineStepRef, ReachableWidget, UnreachableWidget } from "@miragon/mcp-toolkit-core";
+import type { AvailableStep, DisplayText, KeyCatalogEntry, PipelineContext, PipelineStepRef, ReachableWidget, UnreachableWidget } from "@miragon/mcp-toolkit-core";
 import { type KeyEntry } from "./builder-model.js";
 import type { RefreshStatus } from "./labels.js";
 /**
@@ -23,9 +23,13 @@ export declare function useBuilderCatalogue({ callTool, catalogueToolName, keyEn
     liveContext: PipelineContext;
     validationIssues: string[];
     status: RefreshStatus;
+    loaded: boolean;
     refreshError: string | null;
+    retryCatalogue: () => void;
     widgetById: Map<string, ReachableWidget>;
     propsSchemaByWidgetId: Map<string, Record<string, unknown>>;
+    displayByWidgetId: Map<string, DisplayText>;
+    appDisplayByName: Map<string, DisplayText>;
     paletteByApp: [string, ReachableWidget[]][];
     liveKeyCount: number;
     stepsByApp: [string, AvailableStep[]][];

package/dist/app/builder/use-builder-catalogue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-builder-catalogue.d.ts","sourceRoot":"","sources":["../../../src/app/builder/use-builder-catalogue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAGL,KAAK,QAAQ,EAEd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAQhD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,QAAQ,EAAE,CAAA;IACtB,WAAW,EAAE,eAAe,EAAE,CAAA;CAC/B;;;;;;;;;;;;;;EA+IA"}
+{"version":3,"file":"use-builder-catalogue.d.ts","sourceRoot":"","sources":["../../../src/app/builder/use-builder-catalogue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EAEb,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAGL,KAAK,QAAQ,EAEd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAmBhD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,QAAQ,EAAE,CAAA;IACtB,WAAW,EAAE,eAAe,EAAE,CAAA;CAC/B;;;;;;;;;;;;;;;;;;EA6KA"}

package/dist/app/builder/use-builder-catalogue.js

@@ -22,6 +22,9 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
     const [liveCatalog, setLiveCatalog] = useState([]);
     const [liveSteps, setLiveSteps] = useState([]);
     const [liveContext, setLiveContext] = useState(EMPTY_CONTEXT);
+    // The titled apps (the palette's group headings); the catalogue leaves the
+    // field out when no app has a title.
+    const [liveApps, setLiveApps] = useState([]);
     // Pipeline validation issues from the catalogue (Finding [10]/[6]). The
     // catalogue is fail-soft, but `render-view` is fail-hard, so we surface
     // these so the user sees — before committing — that the pipeline as
@@ -33,6 +36,31 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
     // instead of only `console.warn`-ing, so the user knows the palette/context
     // may be stale. Cleared on the next successful refresh.
     const [refreshError, setRefreshError] = useState(null);
+    // The first fetch has settled (answer or failure). Until then the palette
+    // shows a loading state, not "no elements" (CI §9: a skeleton while loading).
+    const [loaded, setLoaded] = useState(false);
+    // Takes over what one catalogue response carries; a field it lacks keeps
+    // the last snapshot.
+    const applySnapshot = useCallback((sc) => {
+        if (sc?.reachableWidgets)
+            setLiveReachable(sc.reachableWidgets);
+        if (sc?.unreachableWidgets)
+            setLiveUnreachable(sc.unreachableWidgets);
+        if (sc?.availableSteps)
+            setLiveSteps(sc.availableSteps);
+        if (sc?.keyCatalog)
+            setLiveCatalog(sc.keyCatalog);
+        if (sc?.context)
+            setLiveContext(toPipelineContext(sc.context));
+        // Absent `apps` means no app has a title (not "unchanged").
+        if (sc)
+            setLiveApps(sc.apps ?? []);
+        // Pipeline issues are fail-soft in the catalogue but fail-hard in
+        // render-view; surface them so the user sees the render path wouldn't
+        // run as configured (Finding [10]/[6]). Coerce undefined → [] so a
+        // fixed pipeline clears a previously-shown warning.
+        setValidationIssues(sc?.validationIssues ?? []);
+    }, []);
     const refreshBuilder = useCallback(async () => {
         setStatus("refreshing");
         try {
@@ -40,22 +68,7 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
                 keys: entriesToKeys(keyEntries),
                 steps: stepEntries.filter((s) => s.step.trim().length > 0),
             });
-            const sc = parseToolResult(result);
-            if (sc?.reachableWidgets)
-                setLiveReachable(sc.reachableWidgets);
-            if (sc?.unreachableWidgets)
-                setLiveUnreachable(sc.unreachableWidgets);
-            if (sc?.availableSteps)
-                setLiveSteps(sc.availableSteps);
-            if (sc?.keyCatalog)
-                setLiveCatalog(sc.keyCatalog);
-            if (sc?.context)
-                setLiveContext(toPipelineContext(sc.context));
-            // Pipeline issues are fail-soft in the catalogue but fail-hard in
-            // render-view; surface them so the user sees the render path wouldn't
-            // run as configured (Finding [10]/[6]). Coerce undefined → [] so a
-            // fixed pipeline clears a previously-shown warning.
-            setValidationIssues(sc?.validationIssues ?? []);
+            applySnapshot(parseToolResult(result));
             // A successful fetch clears any stale failure banner.
             setRefreshError(null);
         }
@@ -73,12 +86,18 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
         }
         finally {
             setStatus("idle");
+            setLoaded(true);
         }
-    }, [catalogueToolName, callTool, keyEntries, stepEntries]);
+    }, [applySnapshot, catalogueToolName, callTool, keyEntries, stepEntries]);
     const refreshRef = useRef(refreshBuilder);
     useEffect(() => {
         refreshRef.current = refreshBuilder;
     }, [refreshBuilder]);
+    // Retry of the catalogue error state: fetch again right away, with the
+    // current keys and steps.
+    const retryCatalogue = useCallback(() => {
+        void refreshRef.current();
+    }, []);
     const isFirstRun = useRef(true);
     useEffect(() => {
         if (isFirstRun.current) {
@@ -117,6 +136,16 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
         }
         return map;
     }, [liveReachable, liveUnreachable]);
+    // Display text (title, summary, their keys) per widget id, from both lists:
+    // a canvas cell or the props sheet may name a widget the current keys do
+    // not reach.
+    const displayByWidgetId = useMemo(() => {
+        const map = new Map();
+        for (const w of [...liveUnreachable, ...liveReachable])
+            map.set(w.id, w);
+        return map;
+    }, [liveReachable, liveUnreachable]);
+    const appDisplayByName = useMemo(() => new Map(liveApps.map((app) => [app.name, app])), [liveApps]);
     const paletteByApp = useMemo(() => {
         const groups = new Map();
         for (const w of liveReachable) {
@@ -144,9 +173,13 @@ export function useBuilderCatalogue({ callTool, catalogueToolName, keyEntries, s
         liveContext,
         validationIssues,
         status,
+        loaded,
         refreshError,
+        retryCatalogue,
         widgetById,
         propsSchemaByWidgetId,
+        displayByWidgetId,
+        appDisplayByName,
         paletteByApp,
         liveKeyCount,
         stepsByApp,