@burdenoff/microfe-bigconsole 2026.1012.4 → 2026.1012.5

package/dist/bigconsole/customWidget/CustomWidgetProposalPanel.js

@@ -7,8 +7,8 @@ import { localProposalSource as ne } from "./proposalSource.js";
 import { memo as a, useCallback as o, useEffect as re, useMemo as s, useState as c } from "react";
 import { AlertTriangle as l, Check as u, Loader2 as d, RefreshCw as ie, Sparkles as ae, X as oe } from "lucide-react";
 import { Button as f, Input as p, Label as m, Textarea as se } from "@burdenoff/fe-libs/ui";
-import { Fragment as ce, jsx as h, jsxs as g } from "react/jsx-runtime";
-import { useI18n as _ } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
+import { useI18n as ce } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
+import { Fragment as h, jsx as g, jsxs as _ } from "react/jsx-runtime";
 //#region src/bigconsole/customWidget/CustomWidgetProposalPanel.tsx
 var v = "w-full", y = {
 	loading: "neutral",
@@ -61,7 +61,7 @@ function S(e) {
 	return 0;
 }
 var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T, onClose: E, source: D = ne }) {
-	let { t: O } = _(), k = s(() => ({
+	let { t: O } = ce(), k = s(() => ({
 		loading: {
 			title: O("bigconsole.widget.customWidget.preview.loading.title", "Building preview…"),
 			body: O("bigconsole.widget.customWidget.preview.loading.body", "Reading the selected data binding.")
@@ -162,43 +162,43 @@ var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T,
 		E,
 		O
 	]), Q = J.issues.filter((e) => e.severity === "error"), $ = J.issues.filter((e) => e.severity === "warning");
-	return /* @__PURE__ */ h("section", {
+	return /* @__PURE__ */ g("section", {
 		"data-testid": "custom-widget-proposal-panel",
 		"aria-label": O("bigconsole.widget.customWidget.panel.ariaLabel", "AI custom widget builder"),
 		className: "flex h-full w-full min-w-0 flex-col overflow-y-auto p-4",
-		children: /* @__PURE__ */ g(t, { children: [/* @__PURE__ */ h(e, {
+		children: /* @__PURE__ */ _(t, { children: [/* @__PURE__ */ g(e, {
 			title: O("bigconsole.widget.customWidget.prompt.label", "Describe the widget you need"),
 			description: "Plain English. The assistant proposes a typed widget you can edit before anything is saved.",
-			icon: /* @__PURE__ */ h(ae, {
+			icon: /* @__PURE__ */ g(ae, {
 				className: "size-4",
 				"aria-hidden": "true"
 			}),
-			actions: /* @__PURE__ */ g("div", {
+			actions: /* @__PURE__ */ _("div", {
 				className: "flex flex-wrap gap-2",
-				children: [/* @__PURE__ */ g(f, {
+				children: [/* @__PURE__ */ _(f, {
 					"data-testid": "custom-widget-generate",
 					onClick: ue,
 					disabled: !A.trim() || N,
-					children: [N ? /* @__PURE__ */ h(d, {
+					children: [N ? /* @__PURE__ */ g(d, {
 						className: "mr-2 size-4 animate-spin",
 						"aria-hidden": "true"
 					}) : null, j ? O("bigconsole.widget.customWidget.action.regenerate", "Regenerate") : O("bigconsole.widget.customWidget.action.generateProposal", "Generate proposal")]
-				}), j ? /* @__PURE__ */ g(f, {
+				}), j ? /* @__PURE__ */ _(f, {
 					variant: "outline",
 					"data-testid": "custom-widget-reject",
 					onClick: de,
-					children: [/* @__PURE__ */ h(oe, {
+					children: [/* @__PURE__ */ g(oe, {
 						className: "mr-1 size-4",
 						"aria-hidden": "true"
 					}), O("bigconsole.widget.customWidget.action.reject", "Reject")]
 				}) : null]
 			}),
-			children: /* @__PURE__ */ g("div", {
+			children: /* @__PURE__ */ _("div", {
 				className: "flex flex-col gap-2",
-				children: [/* @__PURE__ */ h(m, {
+				children: [/* @__PURE__ */ g(m, {
 					htmlFor: "custom-widget-prompt",
 					children: "What should it show?"
-				}), /* @__PURE__ */ h(se, {
+				}), /* @__PURE__ */ g(se, {
 					id: "custom-widget-prompt",
 					"data-testid": "custom-widget-prompt",
 					value: A,
@@ -207,95 +207,95 @@ var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T,
 					rows: 3
 				})]
 			})
-		}), j ? /* @__PURE__ */ g(ce, { children: [
-			/* @__PURE__ */ g(e, {
+		}), j ? /* @__PURE__ */ _(h, { children: [
+			/* @__PURE__ */ _(e, {
 				emphasis: "primary",
 				tone: y[Y],
 				title: k[Y].title,
 				description: j.binding.parserId ? O("bigconsole.widget.customWidget.preview.parserDescription", "Rendered using the saved parser output.") : O("bigconsole.widget.customWidget.preview.sourceDescription", "Rendered using up to 50 source rows. Full data may differ."),
-				meta: /* @__PURE__ */ h("span", {
+				meta: /* @__PURE__ */ g("span", {
 					"data-testid": "custom-widget-preview-state",
 					"data-state": Y,
 					className: "rounded-pill bg-bg-sunken px-2 py-0.5 text-xs text-text-secondary",
 					children: Y
 				}),
-				children: [/* @__PURE__ */ h("div", {
+				children: [/* @__PURE__ */ g("div", {
 					"data-testid": "custom-widget-preview",
 					className: "min-h-[220px] min-w-0 rounded-card border border-[var(--color-border-subtle)] bg-bg-surface p-2",
-					children: Y === "loading" ? /* @__PURE__ */ g("div", {
+					children: Y === "loading" ? /* @__PURE__ */ _("div", {
 						className: "flex h-[200px] items-center justify-center text-text-secondary",
-						children: [/* @__PURE__ */ h(d, {
+						children: [/* @__PURE__ */ g(d, {
 							className: "mr-2 size-4 animate-spin",
 							"aria-hidden": "true"
-						}), /* @__PURE__ */ h("span", {
+						}), /* @__PURE__ */ g("span", {
 							className: "text-sm",
 							children: k.loading.body
 						})]
-					}) : Y === "valid" ? /* @__PURE__ */ h("div", {
+					}) : Y === "valid" ? /* @__PURE__ */ g("div", {
 						className: "h-[200px]",
-						children: /* @__PURE__ */ h(n, {
+						children: /* @__PURE__ */ g(n, {
 							widgetId: `preview-${j.id}`,
-							children: /* @__PURE__ */ h(ee, {
+							children: /* @__PURE__ */ g(ee, {
 								widget: b(j, O("bigconsole.widget.customWidget.untitledWidget", "Untitled widget")),
 								data: z
 							})
 						})
-					}) : /* @__PURE__ */ g("div", {
+					}) : /* @__PURE__ */ _("div", {
 						className: "flex h-[200px] flex-col items-center justify-center gap-2 px-4 text-center",
 						children: [
-							/* @__PURE__ */ h(l, {
+							/* @__PURE__ */ g(l, {
 								className: "size-5 text-[var(--color-status-warning-text)]",
 								"aria-hidden": "true"
 							}),
-							/* @__PURE__ */ h("p", {
+							/* @__PURE__ */ g("p", {
 								className: "text-sm text-text-secondary",
 								children: k[Y].body
 							}),
-							Y === "access-error" ? /* @__PURE__ */ g(f, {
+							Y === "access-error" ? /* @__PURE__ */ _(f, {
 								size: "sm",
 								variant: "outline",
 								onClick: () => X((e) => ({ ...e })),
-								children: [/* @__PURE__ */ h(ie, {
+								children: [/* @__PURE__ */ g(ie, {
 									className: "mr-1 size-3.5",
 									"aria-hidden": "true"
 								}), O("bigconsole.widget.customWidget.action.retry", "Retry")]
 							}) : null
 						]
 					})
-				}), j.rationale ? /* @__PURE__ */ h("p", {
+				}), j.rationale ? /* @__PURE__ */ g("p", {
 					className: "mt-2 text-xs text-text-secondary",
 					"data-testid": "custom-widget-rationale",
 					children: j.rationale
 				}) : null]
 			}),
-			Q.length > 0 || $.length > 0 ? /* @__PURE__ */ h(e, {
+			Q.length > 0 || $.length > 0 ? /* @__PURE__ */ g(e, {
 				tone: Q.length > 0 ? "danger" : "warning",
 				padding: "compact",
 				headingLevel: 3,
 				title: Q.length > 0 ? `${Q.length} ${Q.length === 1 ? "problem" : "problems"} to fix before approving` : `${$.length} ${$.length === 1 ? "warning" : "warnings"}`,
-				children: /* @__PURE__ */ h("ul", {
+				children: /* @__PURE__ */ g("ul", {
 					"data-testid": "custom-widget-issues",
 					className: "flex min-w-0 flex-col gap-1",
-					children: [...Q, ...$].map((e) => /* @__PURE__ */ h("li", {
+					children: [...Q, ...$].map((e) => /* @__PURE__ */ g("li", {
 						"data-severity": e.severity,
 						className: `break-words text-xs ${e.severity === "error" ? "text-[var(--color-status-error-text)]" : "text-[var(--color-status-warning-text)]"}`,
 						children: e.message
 					}, `${e.code}-${e.path ?? ""}`))
 				})
 			}) : null,
-			/* @__PURE__ */ h(e, {
+			/* @__PURE__ */ g(e, {
 				title: O("bigconsole.widget.customWidget.proposal.heading", "Proposal"),
 				description: "Every field is editable — the assistant proposes, you dispose.",
 				"data-testid": "custom-widget-proposal-fields",
-				children: /* @__PURE__ */ g("div", {
+				children: /* @__PURE__ */ _("div", {
 					className: "flex flex-col gap-3",
 					children: [
-						/* @__PURE__ */ g("div", {
+						/* @__PURE__ */ _("div", {
 							className: "flex flex-col gap-1",
-							children: [/* @__PURE__ */ h(m, {
+							children: [/* @__PURE__ */ g(m, {
 								htmlFor: "custom-widget-title",
 								children: O("bigconsole.widget.customWidget.field.title", "Title")
-							}), /* @__PURE__ */ h(p, {
+							}), /* @__PURE__ */ g(p, {
 								id: "custom-widget-title",
 								"data-testid": "custom-widget-title",
 								className: v,
@@ -309,12 +309,12 @@ var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T,
 								}))
 							})]
 						}),
-						/* @__PURE__ */ g("div", {
+						/* @__PURE__ */ _("div", {
 							className: "flex flex-col gap-1",
-							children: [/* @__PURE__ */ h(m, {
+							children: [/* @__PURE__ */ g(m, {
 								htmlFor: "custom-widget-type",
 								children: O("bigconsole.widget.customWidget.field.widgetType", "Widget type")
-							}), /* @__PURE__ */ h("select", {
+							}), /* @__PURE__ */ g("select", {
 								id: "custom-widget-type",
 								"data-testid": "custom-widget-type",
 								value: j.widgetType,
@@ -323,18 +323,18 @@ var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T,
 									widgetType: e.target.value
 								})),
 								className: "w-full rounded-md border border-[var(--color-border-default)] bg-bg-surface px-3 py-2 text-sm text-text-primary focus:outline-none focus:ring-2 focus:ring-action-primary-bg",
-								children: te.map((e) => /* @__PURE__ */ h("option", {
+								children: te.map((e) => /* @__PURE__ */ g("option", {
 									value: e,
 									children: e
 								}, e))
 							})]
 						}),
-						/* @__PURE__ */ g("div", {
+						/* @__PURE__ */ _("div", {
 							className: "flex flex-col gap-1",
-							children: [/* @__PURE__ */ h(m, {
+							children: [/* @__PURE__ */ g(m, {
 								htmlFor: "custom-widget-sink",
 								children: O("bigconsole.widget.customWidget.field.dataSink", "DataSink")
-							}), /* @__PURE__ */ g("select", {
+							}), /* @__PURE__ */ _("select", {
 								id: "custom-widget-sink",
 								"data-testid": "custom-widget-sink",
 								value: j.binding.dataSinkId,
@@ -350,21 +350,21 @@ var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T,
 									}));
 								},
 								className: "w-full rounded-md border border-[var(--color-border-default)] bg-bg-surface px-3 py-2 text-sm text-text-primary focus:outline-none focus:ring-2 focus:ring-action-primary-bg",
-								children: [/* @__PURE__ */ h("option", {
+								children: [/* @__PURE__ */ g("option", {
 									value: "",
 									children: O("bigconsole.widget.customWidget.field.selectDataSink", "Select a DataSink…")
-								}), a.map((e) => /* @__PURE__ */ h("option", {
+								}), a.map((e) => /* @__PURE__ */ g("option", {
 									value: e.id,
 									children: e.name || e.key
 								}, e.id))]
 							})]
 						}),
-						/* @__PURE__ */ g("div", {
+						/* @__PURE__ */ _("div", {
 							className: "flex flex-col gap-1",
-							children: [/* @__PURE__ */ h(m, {
+							children: [/* @__PURE__ */ g(m, {
 								htmlFor: "custom-widget-parser",
 								children: O("bigconsole.widget.customWidget.field.parser", "Parser")
-							}), /* @__PURE__ */ g("select", {
+							}), /* @__PURE__ */ _("select", {
 								id: "custom-widget-parser",
 								"data-testid": "custom-widget-parser",
 								value: j.binding.parserId ?? "",
@@ -380,29 +380,29 @@ var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T,
 									}));
 								},
 								className: "w-full rounded-md border border-[var(--color-border-default)] bg-bg-surface px-3 py-2 text-sm text-text-primary focus:outline-none focus:ring-2 focus:ring-action-primary-bg",
-								children: [/* @__PURE__ */ h("option", {
+								children: [/* @__PURE__ */ g("option", {
 									value: "",
 									children: O("bigconsole.widget.customWidget.field.noParser", "No parser")
-								}), C.map((e) => /* @__PURE__ */ h("option", {
+								}), C.map((e) => /* @__PURE__ */ g("option", {
 									value: e.id,
 									children: e.name
 								}, e.id))]
 							})]
 						}),
-						Object.keys(j.fieldMapping).length > 0 ? /* @__PURE__ */ g("fieldset", {
+						Object.keys(j.fieldMapping).length > 0 ? /* @__PURE__ */ _("fieldset", {
 							className: "flex flex-col gap-2",
 							"data-testid": "custom-widget-field-mapping",
 							children: [
-								/* @__PURE__ */ h("legend", {
+								/* @__PURE__ */ g("legend", {
 									className: "text-sm font-medium text-text-primary",
 									children: O("bigconsole.widget.customWidget.fieldMapping.legend", "Field mapping")
 								}),
-								Object.entries(j.fieldMapping).map(([e, t]) => /* @__PURE__ */ g("div", {
+								Object.entries(j.fieldMapping).map(([e, t]) => /* @__PURE__ */ _("div", {
 									className: "flex flex-col gap-1",
-									children: [/* @__PURE__ */ h(m, {
+									children: [/* @__PURE__ */ g(m, {
 										htmlFor: `custom-widget-field-${e}`,
 										children: e
-									}), /* @__PURE__ */ h(p, {
+									}), /* @__PURE__ */ g(p, {
 										id: `custom-widget-field-${e}`,
 										"data-testid": `custom-widget-field-${e}`,
 										value: t,
@@ -415,7 +415,7 @@ var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T,
 										}))
 									})]
 								}, e)),
-								q?.length ? /* @__PURE__ */ h("p", {
+								q?.length ? /* @__PURE__ */ g("p", {
 									className: "break-words text-xs text-text-secondary",
 									children: O("bigconsole.widget.customWidget.fieldMapping.available", "Available: {{fields}}", { fields: q.join(", ") })
 								}) : null
@@ -424,44 +424,44 @@ var C = a(function({ sinks: a, parsers: C, resolvePreviewData: w, onApprove: T,
 					]
 				})
 			}),
-			L ? /* @__PURE__ */ h(e, {
+			L ? /* @__PURE__ */ g(e, {
 				tone: "danger",
 				padding: "compact",
 				headingLevel: 3,
 				title: "Could not add the widget",
-				children: /* @__PURE__ */ h("p", {
+				children: /* @__PURE__ */ g("p", {
 					role: "alert",
 					className: "break-words text-xs text-[var(--color-status-error-text)]",
 					"data-testid": "custom-widget-approve-error",
 					children: L
 				})
 			}) : null,
-			/* @__PURE__ */ g("div", {
+			/* @__PURE__ */ _("div", {
 				className: "flex flex-wrap gap-2 border-t border-[var(--color-border-subtle)] pt-3",
-				children: [/* @__PURE__ */ g(f, {
+				children: [/* @__PURE__ */ _(f, {
 					"data-testid": "custom-widget-approve",
 					onClick: Z,
 					disabled: !J.canApprove || V || U || F,
-					children: [F ? /* @__PURE__ */ h(d, {
+					children: [F ? /* @__PURE__ */ g(d, {
 						className: "mr-2 size-4 animate-spin",
 						"aria-hidden": "true"
-					}) : /* @__PURE__ */ h(u, {
+					}) : /* @__PURE__ */ g(u, {
 						className: "mr-1 size-4",
 						"aria-hidden": "true"
 					}), O("bigconsole.widget.customWidget.action.approveAndAdd", "Approve & add to dashboard")]
-				}), /* @__PURE__ */ h(f, {
+				}), /* @__PURE__ */ g(f, {
 					variant: "outline",
 					onClick: E,
 					"data-testid": "custom-widget-cancel",
 					children: O("bigconsole.widget.customWidget.action.cancel", "Cancel")
 				})]
 			})
-		] }) : /* @__PURE__ */ h(e, {
+		] }) : /* @__PURE__ */ g(e, {
 			emphasis: "muted",
 			padding: "compact",
 			title: "No proposal yet",
 			headingLevel: 3,
-			children: /* @__PURE__ */ h("p", {
+			children: /* @__PURE__ */ g("p", {
 				className: "text-sm text-text-secondary",
 				"data-testid": "custom-widget-empty",
 				children: O("bigconsole.widget.customWidget.empty", "No proposal yet. Describe a widget and the assistant will propose one for you to review — nothing is added to the dashboard until you approve it.")

package/dist/bigconsole/hooks/useDashboardLayoutBaseline.d.ts

@@ -0,0 +1,14 @@
+import { LayoutItem } from '../utils/layoutBaseline';
+
+export interface DashboardLayoutBaseline {
+    /** The board's positions differ from the last loaded or saved ones, because a person placed something. */
+    dirty: boolean;
+    /**
+     * Re-take the baseline after the positions reached the server. `sent` is exactly
+     * what was sent; `editRevisionAtSave` is `layoutEditRevision` read BEFORE the
+     * request began, so a placement made while it was in flight stays dirty.
+     * Call it on success only: a failed save must leave the layout dirty.
+     */
+    markSaved: (sent: ReadonlyArray<LayoutItem>, editRevisionAtSave: number) => void;
+}
+export declare function useDashboardLayoutBaseline(dashboardId: string | undefined): DashboardLayoutBaseline;

package/dist/bigconsole/hooks/useDashboardLayoutBaseline.js

@@ -0,0 +1,32 @@
+import { useWidgetStore as e } from "../store/widgetStore.js";
+import "../store/index.js";
+import { INITIAL_LAYOUT_BASELINE as t, isLayoutBaselineDirty as n, layoutFromWidgets as r, normaliseLayout as i, reduceLayoutBaseline as a } from "../utils/layoutBaseline.js";
+import { useCallback as o, useEffect as s, useMemo as c, useReducer as l, useState as u } from "react";
+//#region src/bigconsole/hooks/useDashboardLayoutBaseline.ts
+function d(d) {
+	let f = e((e) => e.widgets), p = e((e) => e.layoutEditRevision), [m, h] = l(a, t), g = c(() => r(f.values()), [f]), [_, v] = u(d);
+	_ !== d && (v(d), h({ type: "reset" })), s(() => {
+		h({
+			type: "observe",
+			layout: g,
+			editRevision: p
+		});
+	}, [
+		d,
+		g,
+		p
+	]);
+	let y = o((e, t) => {
+		h({
+			type: "saved",
+			layout: i(e),
+			editRevision: t
+		});
+	}, []);
+	return {
+		dirty: n(m, g),
+		markSaved: y
+	};
+}
+//#endregion
+export { d as useDashboardLayoutBaseline };

package/dist/bigconsole/hooks/useDataSinkAlerts.d.ts

@@ -7,6 +7,25 @@ export type AlertChannel = BigConsoleDataSinkAlertChannelsQuery['dataSinkAlertCh
 export type AlertExecution = BigConsoleDataSinkAlertExecutionsQuery['dataSinkAlertExecutions'][number];
 export type AlertPreview = BigConsolePreviewDataSinkAlertQuery['previewDataSinkAlert'];
 export declare const alertErrorMessage: (error: unknown) => string;
+/**
+ * "This data sink is not here": the client's own check (`getDataSink` answers
+ * `null`, or a sink from another workspace) and the server's codes for it.
+ */
+export declare const ALERT_SINK_NOT_FOUND = "DATASINK_NOT_FOUND";
+type Translate = (key: string, fallback: string) => string;
+/**
+ * What the alerts page says when the data sink could not be loaded
+ * (BOFF-8060 i18n B3). The server's English never wins over a keyed string:
+ *
+ *  - not found (or nothing recorded) → `bigconsole.alerts.notFound`;
+ *  - a coded failure → `bigconsole.errors.<CODE>`, the catalog the rest of
+ *    BigConsole localizes backend errors with;
+ *  - only an uncoded failure falls back to its raw message, which has no key.
+ */
+export declare function describeAlertLoadFailure(t: Translate, failure: {
+    error: string | null;
+    errorCode: string | null;
+}): string;
 /** Every read and write uses the selected workspace; late requests cannot populate a new owner. */
 export declare function useDataSinkAlerts(dataSinkId: string, enabled: boolean): {
     owner: string;
@@ -43,6 +62,7 @@ export declare function useDataSinkAlerts(dataSinkId: string, enabled: boolean):
         }> | null;
     } | null | undefined>;
     reloadChannels: () => Promise<void>;
+    reloadSinkThenChannels: () => Promise<void>;
     save: (alert: DataSinkAlertInput, expectedVersion: number) => Promise<{
         __typename?: "DataSink";
         id: string;
@@ -141,5 +161,8 @@ export declare function useDataSinkAlerts(dataSinkId: string, enabled: boolean):
     channels: AlertChannel[];
     loading: boolean;
     error: string | null;
+    /** The first GraphQL `extensions.code` behind `error`, or the client's own not-found marker. */
+    errorCode: string | null;
     channelError: string | null;
 };
+export {};