@miragon/mcp-toolkit-ui 2.6.0 → 2.8.0

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

@@ -1,5 +1,5 @@
 import type { LayoutBuilderLabels, RefreshStatus } from "./labels.js";
-declare function ToolbarImpl({ L, previewMode, isBusy, status, liveKeys, reachableCount, unreachableCount, onOpenCatalogue, onOpenSave, onDone, hasAnyCell, }: {
+export interface ToolbarProps {
     L: Required<LayoutBuilderLabels>;
     previewMode: boolean;
     isBusy: boolean;
@@ -7,11 +7,21 @@ declare function ToolbarImpl({ L, previewMode, isBusy, status, liveKeys, reachab
     liveKeys: number;
     reachableCount: number;
     unreachableCount: number;
+    /** Advanced mode: shows the stats and the catalogue (the data sources tab lives below). */
+    advanced: boolean;
+    onToggleAdvanced: () => void;
+    /** The draft has changes that would be lost (the marker next to the title). */
+    unsaved: boolean;
     onOpenCatalogue: () => void;
     onOpenSave: () => void;
-    onDone?: () => void;
+    /** Leaves the builder without the edits (or, without `onApply`, resets the draft in place). */
+    onDiscard: () => void;
+    /** Shows the draft in the view and leaves the builder; absent when there is no view to apply to. */
+    onApply?: () => void;
     hasAnyCell: boolean;
-}): import("react").JSX.Element;
-export declare const Toolbar: import("react").MemoExoticComponent<typeof ToolbarImpl>;
+}
+/** A dense chrome bar: its Lucide icons draw at stroke 2 (CI §11), not the view's 2.5. */
+declare function DenseToolbar(props: ToolbarProps): import("react").JSX.Element;
+export declare const Toolbar: import("react").MemoExoticComponent<typeof DenseToolbar>;
 export {};
 //# sourceMappingURL=Toolbar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../../src/app/builder/Toolbar.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAOrE,iBAAS,WAAW,CAAC,EACnB,CAAC,EACD,WAAW,EACX,MAAM,EACN,MAAM,EACN,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,MAAM,EACN,UAAU,GACX,EAAE;IACD,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAChC,WAAW,EAAE,OAAO,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;CACpB,+BAwDA;AAED,eAAO,MAAM,OAAO,yDAAoB,CAAA"}
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../../src/app/builder/Toolbar.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAOrE,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAChC,WAAW,EAAE,OAAO,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,2FAA2F;IAC3F,QAAQ,EAAE,OAAO,CAAA;IACjB,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,+FAA+F;IAC/F,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;CACpB;AAmJD,0FAA0F;AAC1F,iBAAS,YAAY,CAAC,KAAK,EAAE,YAAY,+BAMxC;AAED,eAAO,MAAM,OAAO,0DAAqB,CAAA"}

package/dist/app/builder/Toolbar.js

@@ -1,15 +1,32 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { memo } from "react";
-import { Check, Eye, Layers, Library, Save } from "lucide-react";
+import { Check, Library, LucideProvider, Save, Undo2, Wrench } from "lucide-react";
+import { DENSE_ICON_STROKE } from "../../lib/icon-stroke.js";
+import { FOCUS_RING } from "../../lib/focus-ring.js";
 import { Badge } from "../../primitives/badge.js";
 import { Button } from "../../primitives/button.js";
+import { TONE_DOT } from "../../lib/tone-utils.js";
 import { cn } from "../../lib/utils.js";
 import { StatusChip } from "./status-chip.js";
-// -------------------------------------------------------------------------- //
-// Toolbar — sticky top, dense status row + actions
-// -------------------------------------------------------------------------- //
-function ToolbarImpl({ L, previewMode, isBusy, status, liveKeys, reachableCount, unreachableCount, onOpenCatalogue, onOpenSave, onDone, hasAnyCell, }) {
-    return (_jsxs("header", { className: "bg-background/80 sticky top-0 z-10 -mx-1 flex flex-wrap items-center gap-3 border-b px-1 py-2 backdrop-blur", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: cn("inline-flex size-6 items-center justify-center rounded-md", previewMode ? "bg-emerald-500/10 text-emerald-500" : "bg-primary/10 text-primary"), "aria-hidden": "true", children: previewMode ? _jsx(Eye, { className: "size-3.5" }) : _jsx(Layers, { className: "size-3.5" }) }), _jsx("h2", { className: "text-sm font-semibold tracking-tight", children: L.title }), _jsx(Badge, { variant: previewMode ? "outline" : "secondary", className: "font-normal", children: previewMode ? L.previewBadge : L.builderBadge })] }), _jsxs("div", { className: "text-muted-foreground hidden items-center gap-3 text-[11px] sm:flex", children: [_jsxs("span", { className: "inline-flex items-center gap-1.5", children: [_jsx("span", { className: "size-1.5 rounded-full bg-emerald-500" }), _jsxs("span", { children: [_jsx("span", { className: "text-foreground font-medium", children: liveKeys }), " live"] })] }), _jsx("span", { className: "bg-border h-3 w-px", "aria-hidden": "true" }), _jsxs("span", { children: [_jsx("span", { className: "text-foreground font-medium", children: reachableCount }), " reachable"] }), unreachableCount > 0 && (_jsxs(_Fragment, { children: [_jsx("span", { className: "bg-border h-3 w-px", "aria-hidden": "true" }), _jsxs("span", { children: [_jsx("span", { className: "text-foreground font-medium", children: unreachableCount }), " unreachable"] })] })), _jsx(StatusChip, { status: status, L: L })] }), _jsxs("div", { className: "ml-auto flex items-center gap-1", children: [_jsxs(Button, { variant: "ghost", size: "sm", onClick: onOpenCatalogue, children: [_jsx(Library, {}), " ", L.catalogue] }), _jsxs(Button, { size: "sm", onClick: onOpenSave, disabled: isBusy || !hasAnyCell, children: [_jsx(Save, {}), " ", L.save] }), onDone && (_jsxs(Button, { variant: "outline", size: "sm", onClick: onDone, children: [_jsx(Check, {}), " ", L.done] }))] })] }));
+/** The live-context stats and the refresh state: data-source vocabulary, so advanced mode only. */
+function Stats({ L, status, liveKeys, reachableCount, unreachableCount, }) {
+    return (_jsxs("div", { className: "text-muted-foreground text-small hidden items-center gap-3 sm:flex", children: [_jsxs("span", { className: "inline-flex items-center gap-1.5", children: [_jsx("span", { "aria-hidden": "true", className: `size-1.5 rounded-full ${TONE_DOT.success}` }), _jsxs("span", { children: [_jsx("span", { className: "text-foreground font-medium", children: liveKeys }), " ", L.statsLive] })] }), _jsx("span", { className: "bg-border h-3 w-px", "aria-hidden": "true" }), _jsxs("span", { children: [_jsx("span", { className: "text-foreground font-medium", children: reachableCount }), " ", L.statsReachable] }), unreachableCount > 0 && (_jsxs(_Fragment, { children: [_jsx("span", { className: "bg-border h-3 w-px", "aria-hidden": "true" }), _jsxs("span", { children: [_jsx("span", { className: "text-foreground font-medium", children: unreachableCount }), " ", L.statsUnreachable] })] })), _jsx(StatusChip, { status: status, L: L })] }));
 }
-export const Toolbar = memo(ToolbarImpl);
+/**
+ * The unsaved marker. The live region is always mounted (only its content
+ * changes), so a screen reader hears the marker appear and go.
+ */
+function UnsavedMarker({ L, unsaved }) {
+    return (_jsx("span", { role: "status", "data-slot": "builder-unsaved", className: "text-muted-foreground text-small inline-flex items-center gap-1.5", children: unsaved && (_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": "true", className: `size-2 rounded-full ${TONE_DOT.warning}` }), L.unsavedChanges] })) }));
+}
+function ToolbarImpl({ L, previewMode, isBusy, status, liveKeys, reachableCount, unreachableCount, advanced, onToggleAdvanced, unsaved, onOpenCatalogue, onOpenSave, onDiscard, onApply, hasAnyCell, }) {
+    return (_jsxs("header", { className: "bg-background/80 sticky top-0 z-10 -mx-1 flex flex-wrap items-center gap-x-3 gap-y-2 border-b px-1 py-2 backdrop-blur", children: [_jsxs("div", { className: "flex min-w-0 flex-wrap items-center gap-2", children: [_jsx("h2", { "data-slot": "builder-title", tabIndex: -1, className: cn("rounded-sm text-sm font-semibold tracking-tight", FOCUS_RING), children: L.title }), _jsx(Badge, { variant: previewMode ? "outline" : "secondary", className: "font-normal", children: previewMode ? L.previewBadge : L.builderBadge }), _jsx(UnsavedMarker, { L: L, unsaved: unsaved })] }), advanced && (_jsx(Stats, { L: L, status: status, liveKeys: liveKeys, reachableCount: reachableCount, unreachableCount: unreachableCount })), _jsxs("div", { className: "ml-auto flex flex-wrap items-center gap-1", children: [_jsxs(Button, { variant: "ghost", size: "sm", "aria-pressed": advanced, title: L.advancedHint, onClick: onToggleAdvanced, className: "aria-pressed:bg-accent aria-pressed:text-accent-foreground", children: [_jsx(Wrench, { "aria-hidden": "true" }), " ", L.advanced] }), advanced && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: onOpenCatalogue, children: [_jsx(Library, { "aria-hidden": "true" }), " ", L.catalogue] })), _jsxs(Button, { variant: "outline", size: "sm", title: L.saveHint, onClick: onOpenSave, disabled: isBusy || !hasAnyCell, children: [_jsx(Save, { "aria-hidden": "true" }), " ", L.save] }), _jsxs(Button, { variant: "ghost", size: "sm", 
+                        // Without Apply there is no view to leave to: Discard resets in place.
+                        title: onApply ? L.discardHint : L.discardHintStandalone, onClick: onDiscard, children: [_jsx(Undo2, { "aria-hidden": "true" }), " ", L.discard] }), onApply && (_jsxs(Button, { size: "sm", title: L.applyHint, onClick: onApply, children: [_jsx(Check, { "aria-hidden": "true" }), " ", L.apply] }))] })] }));
+}
+/** A dense chrome bar: its Lucide icons draw at stroke 2 (CI §11), not the view's 2.5. */
+function DenseToolbar(props) {
+    return (_jsx(LucideProvider, { strokeWidth: DENSE_ICON_STROKE, children: _jsx(ToolbarImpl, { ...props }) }));
+}
+export const Toolbar = memo(DenseToolbar);
 //# sourceMappingURL=Toolbar.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Toolbar.js","sourceRoot":"","sources":["../../../src/app/builder/Toolbar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACnD,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF,SAAS,WAAW,CAAC,EACnB,CAAC,EACD,WAAW,EACX,MAAM,EACN,MAAM,EACN,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,MAAM,EACN,UAAU,GAaX;IACC,OAAO,CACL,kBAAQ,SAAS,EAAC,6GAA6G,aAC7H,eAAK,SAAS,EAAC,yBAAyB,aACtC,eACE,SAAS,EAAE,EAAE,CACX,2DAA2D,EAC3D,WAAW,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,4BAA4B,CAClF,iBACW,MAAM,YAEjB,WAAW,CAAC,CAAC,CAAC,KAAC,GAAG,IAAC,SAAS,EAAC,UAAU,GAAG,CAAC,CAAC,CAAC,KAAC,MAAM,IAAC,SAAS,EAAC,UAAU,GAAG,GACxE,EACP,aAAI,SAAS,EAAC,sCAAsC,YAAE,CAAC,CAAC,KAAK,GAAM,EACnE,KAAC,KAAK,IAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,EAAC,aAAa,YAC3E,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,GACxC,IACJ,EAEN,eAAK,SAAS,EAAC,qEAAqE,aAClF,gBAAM,SAAS,EAAC,kCAAkC,aAChD,eAAM,SAAS,EAAC,sCAAsC,GAAG,EACzD,2BACE,eAAM,SAAS,EAAC,6BAA6B,YAAE,QAAQ,GAAQ,aAC1D,IACF,EACP,eAAM,SAAS,EAAC,oBAAoB,iBAAa,MAAM,GAAG,EAC1D,2BACE,eAAM,SAAS,EAAC,6BAA6B,YAAE,cAAc,GAAQ,kBAChE,EACN,gBAAgB,GAAG,CAAC,IAAI,CACvB,8BACE,eAAM,SAAS,EAAC,oBAAoB,iBAAa,MAAM,GAAG,EAC1D,2BACE,eAAM,SAAS,EAAC,6BAA6B,YAAE,gBAAgB,GAAQ,oBAClE,IACN,CACJ,EACD,KAAC,UAAU,IAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,GAAI,IAChC,EAEN,eAAK,SAAS,EAAC,iCAAiC,aAC9C,MAAC,MAAM,IAAC,OAAO,EAAC,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,eAAe,aACxD,KAAC,OAAO,KAAG,OAAE,CAAC,CAAC,SAAS,IACjB,EACT,MAAC,MAAM,IAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC,UAAU,aACpE,KAAC,IAAI,KAAG,OAAE,CAAC,CAAC,IAAI,IACT,EACR,MAAM,IAAI,CACT,MAAC,MAAM,IAAC,OAAO,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,MAAM,aACjD,KAAC,KAAK,KAAG,OAAE,CAAC,CAAC,IAAI,IACV,CACV,IACG,IACC,CACV,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,CAAA"}
+{"version":3,"file":"Toolbar.js","sourceRoot":"","sources":["../../../src/app/builder/Toolbar.tsx"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import type { ReachableWidget, RowDef, WidgetProps } from "@miragon/mcp-toolkit-core";
+import type { DisplayText, ReachableWidget, RowDef, WidgetProps } from "@miragon/mcp-toolkit-core";
 import type { WidgetComponent } from "../widget-renderer.js";
 import type { LayoutBuilderLabels } from "./labels.js";
 /**
@@ -9,7 +9,13 @@ import type { LayoutBuilderLabels } from "./labels.js";
 export interface WorkspaceProps {
     L: Required<LayoutBuilderLabels>;
     paletteByApp: [string, ReachableWidget[]][];
+    /** Each app's title (or its key) by app name: the palette's group headings. */
+    appDisplayByName: Map<string, DisplayText>;
     paletteCount: number;
+    /** The first catalogue answer is still on its way: the palette shows a loading state. */
+    paletteLoading: boolean;
+    /** The empty palette's next step: show the data sources (it turns on advanced mode). */
+    onOpenDataSources: () => void;
     activeRows: RowDef[];
     focusedRowIndex: number;
     setFocusedRowIndex: (idx: number) => void;
@@ -23,12 +29,26 @@ export interface WorkspaceProps {
     onAddWidget: (widgetId: string, targetRowIdx?: number) => void;
     onConfigureCell: (rowIdx: number, cellIdx: number) => void;
     propsSchemaByWidgetId: Map<string, Record<string, unknown>>;
+    /** Title, summary (or their keys) per widget id: the canvas cells' names. */
+    displayByWidgetId: Map<string, DisplayText>;
+    /** Advanced mode adds the technical lines (a widget's required keys, cell ids). */
+    advanced: boolean;
     widgets: Record<string, WidgetComponent>;
     widgetProps: WidgetProps;
-    showAddTabButton?: boolean;
+    /** Offered next to "Add row" while the draft has no tabs yet. */
     onAddTab?: () => void;
 }
-declare function WorkspaceImpl({ L, paletteByApp, paletteCount, activeRows, focusedRowIndex, setFocusedRowIndex, dragOverRow, setDragOverRow, onAddRow, onRemoveRow, onMoveRow, onSetCellSpan, onRemoveCell, onAddWidget, onConfigureCell, propsSchemaByWidgetId, widgets, widgetProps, showAddTabButton, onAddTab, }: WorkspaceProps): import("react").JSX.Element;
+declare function WorkspaceImpl({ L, paletteByApp, appDisplayByName, paletteCount, paletteLoading, onOpenDataSources, activeRows, focusedRowIndex, setFocusedRowIndex, dragOverRow, setDragOverRow, onAddRow, onRemoveRow, onMoveRow, onSetCellSpan, onRemoveCell, onAddWidget, onConfigureCell, propsSchemaByWidgetId, displayByWidgetId, advanced, widgets, widgetProps, onAddTab, }: WorkspaceProps): import("react").JSX.Element;
 export declare const Workspace: import("react").MemoExoticComponent<typeof WorkspaceImpl>;
+/**
+ * The palette without any element. It speaks no data-source words (they sit
+ * behind Advanced); its one next step opens the data sources, also when the
+ * layout already has cells and the builder's empty state is not shown.
+ * Exported for its tests only.
+ */
+export declare function PaletteEmpty({ L, onOpenDataSources, }: {
+    L: Required<LayoutBuilderLabels>;
+    onOpenDataSources: () => void;
+}): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=Workspace.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Workspace.d.ts","sourceRoot":"","sources":["../../../src/app/builder/Workspace.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAIrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAQtD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAChC,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,CAAA;IAC3C,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;IACtD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACtE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACvD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1D,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACxC,WAAW,EAAE,WAAW,CAAA;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED,iBAAS,aAAa,CAAC,EACrB,CAAC,EACD,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,QAAQ,GACT,EAAE,cAAc,+BA4EhB;AAED,eAAO,MAAM,SAAS,2DAAsB,CAAA"}
+{"version":3,"file":"Workspace.d.ts","sourceRoot":"","sources":["../../../src/app/builder/Workspace.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAMlG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAStD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAChC,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,CAAA;IAC3C,+EAA+E;IAC/E,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC1C,YAAY,EAAE,MAAM,CAAA;IACpB,yFAAyF;IACzF,cAAc,EAAE,OAAO,CAAA;IACvB,wFAAwF;IACxF,iBAAiB,EAAE,MAAM,IAAI,CAAA;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;IACtD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACtE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACvD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1D,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3D,6EAA6E;IAC7E,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC3C,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IACxC,WAAW,EAAE,WAAW,CAAA;IACxB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED,iBAAS,aAAa,CAAC,EACrB,CAAC,EACD,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,WAAW,EACX,QAAQ,GACT,EAAE,cAAc,+BAuDhB;AAED,eAAO,MAAM,SAAS,2DAAsB,CAAA;AAuF5C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,CAAC,EACD,iBAAiB,GAClB,EAAE;IACD,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAChC,iBAAiB,EAAE,MAAM,IAAI,CAAA;CAC9B,+BAYA"}

package/dist/app/builder/Workspace.js

@@ -1,23 +1,73 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { memo } from "react";
-import { GripVertical, Plus } from "lucide-react";
+import { memo, useId } from "react";
+import { GripVertical, Plus, SlidersHorizontal } from "lucide-react";
+import { FOCUS_RING } from "../../lib/focus-ring.js";
+import { cn } from "../../lib/utils.js";
 import { Badge } from "../../primitives/badge.js";
 import { Button } from "../../primitives/button.js";
-import { ScrollArea } from "../../primitives/scroll-area.js";
+import { Skeleton } from "../../primitives/skeleton.js";
+import { displayLabel } from "./builder-model.js";
 import { WIDGET_DRAG_MIME } from "./labels.js";
 import { CanvasRow } from "./CanvasRow.js";
-function WorkspaceImpl({ L, paletteByApp, paletteCount, activeRows, focusedRowIndex, setFocusedRowIndex, dragOverRow, setDragOverRow, onAddRow, onRemoveRow, onMoveRow, onSetCellSpan, onRemoveCell, onAddWidget, onConfigureCell, propsSchemaByWidgetId, widgets, widgetProps, showAddTabButton, onAddTab, }) {
-    return (_jsxs("div", { className: "grid grid-cols-12 gap-4", children: [_jsx("aside", { className: "col-span-12 lg:col-span-3 xl:col-span-2", children: _jsxs("div", { className: "lg:sticky lg:top-16", children: [_jsxs("div", { className: "text-muted-foreground mb-2 flex items-center gap-2 text-[10px] font-semibold tracking-[0.12em] uppercase", children: [L.paletteHeader, _jsx(Badge, { variant: "outline", className: "px-1.5 text-[10px]", children: paletteCount })] }), paletteCount === 0 ? (_jsx("div", { className: "text-muted-foreground rounded-md border border-dashed p-3 text-xs", children: L.paletteEmpty })) : (_jsx(ScrollArea, { className: "lg:max-h-[70vh]", children: _jsx("div", { className: "flex flex-col gap-3 pr-1", children: paletteByApp.map(([app, ws]) => (_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("div", { className: "text-muted-foreground/80 text-[10px] font-semibold tracking-wide uppercase", children: app }), ws.map((w) => (_jsx(PaletteItem, { w: w, onClick: () => onAddWidget(w.id) }, w.id)))] }, app))) }) })), showAddTabButton && onAddTab && (_jsxs(Button, { variant: "ghost", size: "xs", onClick: onAddTab, className: "text-muted-foreground hover:text-foreground mt-3", children: [_jsx(Plus, {}), " ", L.addTab] }))] }) }), _jsx("section", { className: "col-span-12 lg:col-span-9 xl:col-span-10", children: _jsxs("div", { className: "flex flex-col gap-3", children: [activeRows.map((row, rowIdx) => (_jsx(CanvasRow, { L: L, row: row, rowIdx: rowIdx, focused: rowIdx === focusedRowIndex, isFirst: rowIdx === 0, isLast: rowIdx === activeRows.length - 1, dragOver: dragOverRow === rowIdx, setDragOverRow: setDragOverRow, setFocusedRowIndex: setFocusedRowIndex, onRemoveRow: onRemoveRow, onMoveRow: onMoveRow, onSetCellSpan: onSetCellSpan, onRemoveCell: onRemoveCell, onAddWidget: onAddWidget, onConfigureCell: onConfigureCell, propsSchemaByWidgetId: propsSchemaByWidgetId, widgets: widgets, widgetProps: widgetProps }, rowIdx))), _jsxs(Button, { variant: "outline", size: "sm", onClick: onAddRow, className: "self-start text-xs", children: [_jsx(Plus, {}), " ", L.addRow] })] }) })] }));
+import { useDisplayResolver } from "./use-display-resolver.js";
+function WorkspaceImpl({ L, paletteByApp, appDisplayByName, paletteCount, paletteLoading, onOpenDataSources, activeRows, focusedRowIndex, setFocusedRowIndex, dragOverRow, setDragOverRow, onAddRow, onRemoveRow, onMoveRow, onSetCellSpan, onRemoveCell, onAddWidget, onConfigureCell, propsSchemaByWidgetId, displayByWidgetId, advanced, widgets, widgetProps, onAddTab, }) {
+    return (_jsxs("div", { className: "grid grid-cols-12 gap-4", children: [_jsx(Palette, { L: L, paletteByApp: paletteByApp, appDisplayByName: appDisplayByName, paletteCount: paletteCount, loading: paletteLoading, advanced: advanced, onAddWidget: onAddWidget, onOpenDataSources: onOpenDataSources }), _jsx("section", { className: "col-span-12 lg:col-span-9 xl:col-span-10", children: _jsxs("div", { className: "flex flex-col gap-3", children: [activeRows.map((row, rowIdx) => (_jsx(CanvasRow, { L: L, row: row, rowIdx: rowIdx, focused: rowIdx === focusedRowIndex, isFirst: rowIdx === 0, isLast: rowIdx === activeRows.length - 1, dragOver: dragOverRow === rowIdx, setDragOverRow: setDragOverRow, setFocusedRowIndex: setFocusedRowIndex, onRemoveRow: onRemoveRow, onMoveRow: onMoveRow, onSetCellSpan: onSetCellSpan, onRemoveCell: onRemoveCell, onAddWidget: onAddWidget, onConfigureCell: onConfigureCell, propsSchemaByWidgetId: propsSchemaByWidgetId, displayByWidgetId: displayByWidgetId, advanced: advanced, widgets: widgets, widgetProps: widgetProps }, rowIdx))), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsxs(Button, { variant: "outline", size: "sm", onClick: onAddRow, children: [_jsx(Plus, { "aria-hidden": "true" }), " ", L.addRow] }), onAddTab && (_jsxs(Button, { variant: "ghost", size: "sm", onClick: onAddTab, children: [_jsx(Plus, { "aria-hidden": "true" }), " ", L.addTab] }))] })] }) })] }));
 }
 export const Workspace = memo(WorkspaceImpl);
 // -------------------------------------------------------------------------- //
+// Palette — the elements to add, grouped by app (sticky on lg+)
+// -------------------------------------------------------------------------- //
+function Palette({ L, paletteByApp, appDisplayByName, paletteCount, loading, advanced, onAddWidget, onOpenDataSources, }) {
+    const headingId = useId();
+    return (_jsx("aside", { "aria-labelledby": headingId, className: "col-span-12 lg:col-span-3 xl:col-span-2", children: _jsxs("div", { className: "lg:sticky lg:top-16", children: [_jsxs("h3", { id: headingId, className: "text-muted-foreground text-small mb-2 flex items-center gap-2 font-semibold", children: [L.paletteHeader, !loading && (_jsx(Badge, { variant: "outline", className: "px-1.5", children: paletteCount }))] }), loading ? (_jsx(PaletteLoading, { L: L })) : paletteCount === 0 ? (_jsx(PaletteEmpty, { L: L, onOpenDataSources: onOpenDataSources })) : (_jsx("div", { className: "flex flex-col gap-3 lg:max-h-[70vh] lg:overflow-y-auto lg:pr-1", children: paletteByApp.map(([app, ws]) => (_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx(PaletteGroupHeading, { app: app, display: appDisplayByName.get(app), advanced: advanced }), _jsx("ul", { className: "flex flex-col gap-1", children: ws.map((w) => (_jsx("li", { children: _jsx(PaletteItem, { L: L, w: w, advanced: advanced, onClick: () => onAddWidget(w.id) }) }, w.id))) })] }, app))) }))] }) }));
+}
+/** The palette while the first catalogue answer is on its way (CI §9: a skeleton, not "none"). */
+function PaletteLoading({ L }) {
+    return (_jsxs("div", { "data-slot": "builder-palette-loading", className: "flex flex-col gap-1", children: [_jsx(Skeleton, { "aria-hidden": "true", className: "h-9 w-full" }), _jsx(Skeleton, { "aria-hidden": "true", className: "h-9 w-full" }), _jsx(Skeleton, { "aria-hidden": "true", className: "h-9 w-3/4" }), _jsx("p", { role: "status", className: "text-muted-foreground text-small mt-1", children: L.paletteLoading })] }));
+}
+/**
+ * The palette without any element. It speaks no data-source words (they sit
+ * behind Advanced); its one next step opens the data sources, also when the
+ * layout already has cells and the builder's empty state is not shown.
+ * Exported for its tests only.
+ */
+export function PaletteEmpty({ L, onOpenDataSources, }) {
+    return (_jsxs("div", { "data-slot": "builder-palette-empty", className: "text-muted-foreground text-small flex flex-col items-start gap-2 rounded-md border border-dashed p-3", children: [_jsx("p", { children: L.paletteEmpty }), _jsxs(Button, { size: "sm", variant: "outline", onClick: onOpenDataSources, children: [_jsx(SlidersHorizontal, { "aria-hidden": "true" }), " ", L.openDataSources] })] }));
+}
+// -------------------------------------------------------------------------- //
+// Palette group heading
+// -------------------------------------------------------------------------- //
+/**
+ * The heading of one app's group in the palette: the app's title. Without a
+ * title the app's name is a technical namespace, so it heads the group only in
+ * advanced mode; there it also follows a title as a quiet mono hint.
+ */
+function PaletteGroupHeading({ app, display, advanced, }) {
+    const { locale, resolveKey } = useDisplayResolver();
+    const { label, hint } = displayLabel(display ?? {}, app, locale, resolveKey);
+    if (hint === undefined && !advanced)
+        return null;
+    return (_jsxs("div", { "data-slot": "builder-palette-group", className: "text-muted-foreground text-small font-semibold", children: [label, advanced && hint && _jsx("span", { className: "ml-1.5 font-mono font-normal", children: hint })] }));
+}
+// -------------------------------------------------------------------------- //
 // Palette item
 // -------------------------------------------------------------------------- //
-function PaletteItemImpl({ w, onClick }) {
-    return (_jsxs("button", { type: "button", draggable: true, onDragStart: (e) => {
+/**
+ * One widget in the palette: its title and one-line summary, the widget id as
+ * a quiet mono line (only next to a real title), and in advanced mode the keys
+ * it needs. A click (or Enter) adds it to the target row; dragging drops it
+ * on any row.
+ */
+function PaletteItemImpl({ L, w, advanced, onClick, }) {
+    const { locale, resolveKey } = useDisplayResolver();
+    const { label, hint, summary } = displayLabel(w, w.id, locale, resolveKey);
+    // On the hovered --accent surface quiet text takes the surface's
+    // foreground: --muted-foreground drops to 3.66:1 there in dark.
+    const quiet = "text-muted-foreground group-hover:text-accent-foreground block w-full truncate";
+    return (_jsxs("button", { type: "button", draggable: true, "data-slot": "builder-palette-item", onDragStart: (e) => {
             e.dataTransfer.setData(WIDGET_DRAG_MIME, w.id);
             e.dataTransfer.effectAllowed = "copy";
-        }, onClick: onClick, className: "hover:bg-accent hover:text-accent-foreground group bg-background/50 flex cursor-grab flex-col items-start gap-0.5 rounded-md border px-2 py-1.5 text-left text-xs transition-colors active:cursor-grabbing", children: [_jsxs("span", { className: "flex w-full items-center justify-between gap-2", children: [_jsx("span", { className: "truncate font-mono", children: w.id }), _jsx(GripVertical, { className: "text-muted-foreground/40 group-hover:text-muted-foreground size-3" })] }), w.requires.length > 0 && (_jsxs("span", { className: "text-muted-foreground/80 truncate font-mono text-[10px]", children: ["\u2190 ", w.requires.join(", ")] }))] }));
+        }, onClick: onClick, className: cn("hover:bg-accent hover:text-accent-foreground group bg-background flex w-full cursor-grab flex-col items-start gap-0.5 rounded-md border px-2 py-1.5 text-left transition-colors active:cursor-grabbing", FOCUS_RING), children: [_jsxs("span", { className: "flex w-full items-center justify-between gap-2", children: [_jsx("span", { className: "truncate text-sm font-medium", children: label }), _jsx(GripVertical, { "aria-hidden": "true", className: "text-muted-foreground group-hover:text-accent-foreground size-3.5 shrink-0" })] }), summary && _jsx("span", { className: cn(quiet, "text-small"), children: summary }), hint && _jsx("span", { className: cn(quiet, "text-small font-mono"), children: hint }), advanced && w.requires.length > 0 && (_jsxs("span", { className: cn(quiet, "text-small"), children: [L.catalogueNeedsKeys, " ", _jsx("span", { className: "font-mono", children: w.requires.join(", ") })] }))] }));
 }
 const PaletteItem = memo(PaletteItemImpl);
 //# sourceMappingURL=Workspace.js.map

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

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

package/dist/app/builder/builder-model.d.ts

@@ -7,7 +7,7 @@
  * `parseKeyValue ↔ keysToEntries ↔ entriesToKeys` round-trip and
  * `draftToLayout` — unit-testable in isolation.
  */
-import type { LayoutConfig, PipelineContext, RowDef } from "@miragon/mcp-toolkit-core";
+import type { DisplayText, LayoutConfig, PipelineContext, PipelineStepRef, RowDef } from "@miragon/mcp-toolkit-core";
 export interface DraftTab {
     label: string;
     rows: RowDef[];
@@ -71,9 +71,10 @@ export declare function entriesToKeys(entries: KeyEntry[]): Record<string, unkno
  * 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 declare function formatLiveKeyValue(value: unknown): string | undefined;
+export declare function formatLiveKeyValue(value: unknown, prefix?: string): string | undefined;
 export declare function valueTypeLabel(raw: string): string;
 export declare function sizeToSpan(size: string): number;
 export declare function defaultStepIdFor(stepId: string, takenIds: Set<string>): string;
@@ -83,4 +84,146 @@ export declare function defaultStepIdFor(stepId: string, takenIds: Set<string>):
  * `WidgetRenderer` expects.
  */
 export declare function toPipelineContext(ctx: WireContext): PipelineContext;
+/** Resolves an i18n key in the active locale; `undefined` when it is unknown. */
+export type DisplayKeyResolver = (key: string) => string | undefined;
+/**
+ * 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 declare function keyResolverFrom(translate: (key: string) => string): DisplayKeyResolver;
+/** How the builder names one entry: a label, the technical id as a quiet hint, a one-liner. */
+export interface DisplayLabel {
+    /** The name people read: the entry's title, else its id. */
+    label: string;
+    /** The technical id, set only when the label is a real title (so it is never shown twice). */
+    hint?: string;
+    /** The one-line summary, when the entry has one. */
+    summary?: string;
+}
+/**
+ * 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 declare function displayLabel(entry: DisplayText, id: string, locale: string, resolveKey?: DisplayKeyResolver): DisplayLabel;
+/** A props-sheet field: its label, the raw property name as a hint, and its help line. */
+export interface PropFieldText {
+    label: string;
+    /** The property name, set only when the label differs from it. */
+    hint?: string;
+    help?: string;
+}
+/**
+ * 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 declare function propFieldText(name: string, prop: Record<string, unknown>, locale: string, resolveKey?: DisplayKeyResolver): PropFieldText;
+/**
+ * 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 declare function draftHasCells(draft: DraftLayout): boolean;
+/**
+ * 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 declare function builderSnapshot(draft: DraftLayout, keyEntries: KeyEntry[], stepEntries: PipelineStepRef[]): string;
+/** What Apply hands to `onExit`: the draft, plus the live context it was previewed with. */
+export interface BuilderExitCommit {
+    layout: LayoutConfig;
+    keys?: Record<string, unknown>;
+    steps?: PipelineStepRef[];
+    title?: string;
+    context?: WireContext;
+}
+/**
+ * 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 declare function toExitCommit(draft: DraftLayout, keyEntries: KeyEntry[], stepEntries: PipelineStepRef[], title: string | undefined, live: PipelineContext): BuilderExitCommit;
+export interface DraftStatus {
+    /**
+     * The draft differs from the view as it was before editing: what Discard
+     * takes out of the view, so it decides whether Discard asks first.
+     */
+    changed: boolean;
+    /**
+     * The draft has changes that would be lost: it differs from the view before
+     * editing AND from the last saved dashboard (a draft equal to either one
+     * loses nothing). Drives the unsaved marker and tells the discard
+     * confirmation whether a dashboard keeps the changes.
+     */
+    unsaved: boolean;
+}
+/** Compares the current {@link builderSnapshot} with the pre-edit one and the last saved one. */
+export declare function draftStatus(current: string, baseline: string, saved: string | null): DraftStatus;
+/** The builder's leave actions, built by {@link builderLeave}. */
+export interface BuilderLeave {
+    /** Apply: hands the commit to `onExit`. Absent without `onExit` (no view to apply to). */
+    apply?: () => void;
+    /** Discard: asks first when the view would lose changes, else leaves at once. */
+    discard: () => void;
+    /** Discard without asking (the confirmation's own action). */
+    discardNow: () => void;
+}
+/**
+ * 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 declare function builderLeave({ changed, onExit, onReset, commit, confirm, }: {
+    changed: boolean;
+    onExit?: (commit?: BuilderExitCommit) => void;
+    onReset: () => void;
+    commit: () => BuilderExitCommit;
+    confirm: () => void;
+}): BuilderLeave;
+/**
+ * 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 declare function tabTriggerKeyAction(key: string, isActive: boolean): "rename" | null;
+/** What a key press in a tab's rename field does: Enter commits, Escape cancels. */
+export declare function renameFieldKeyAction(key: string): "commit" | "cancel" | null;
+/**
+ * Hands the focus back to a tab once its rename field closes by keyboard.
+ * The tab strip holds it, by the tab's INDEX: a rename that changes the label
+ * mounts a new tab, so a request held by the tab itself would go with the old
+ * one and leave the focus on the document body.
+ */
+export interface TabRefocus {
+    /** The trigger of tab `tabIdx` takes the focus the next time it attaches. */
+    request: (tabIdx: number) => void;
+    /** The ref callback of tab `tabIdx`'s trigger: focuses it once while a request for it is open. */
+    attach: (tabIdx: number, el: {
+        focus: () => void;
+    } | null) => void;
+    /** The two props that wire tab `tabIdx` to this hand-back: its trigger's ref and its request. */
+    forTab: (tabIdx: number) => TabRefocusProps;
+}
+/** What one tab gets from {@link TabRefocus.forTab}. */
+export interface TabRefocusProps {
+    triggerRef: (el: {
+        focus: () => void;
+    } | null) => void;
+    onRefocus: () => void;
+}
+/** A {@link TabRefocus} with no open request. */
+export declare function createTabRefocus(): TabRefocus;
+export type BuilderView = "layout" | "pipeline" | "preview";
+/** The builder's views in tab order: the data sources ("pipeline") only in advanced mode. */
+export declare function builderViews(advanced: boolean): BuilderView[];
+/** The view to show after advanced mode switches: a view that is now hidden falls back to the layout. */
+export declare function viewAfterAdvancedToggle(view: BuilderView, advanced: boolean): BuilderView;
 //# sourceMappingURL=builder-model.d.ts.map

package/dist/app/builder/builder-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder-model.d.ts","sourceRoot":"","sources":["../../../src/app/builder/builder-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAOtF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AAE/F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,CACd,MAAM,EACN;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAClF,CAAA;IACD,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC7C;AAMD,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAElD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,CAWvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAK9D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAYlD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,QAAQ,EAAE,CAYnF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO1E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASrE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBlD;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc/C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAM9E;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe,CAMnE"}
+{"version":3,"file":"builder-model.d.ts","sourceRoot":"","sources":["../../../src/app/builder/builder-model.ts"],"names":[],"mappings":"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"}