@burdenoff/microfe-bigconsole 2026.1013.3 → 2026.1013.4

package/README.md

@@ -35,6 +35,14 @@ import { WorkflowsRoot } from '@burdenoff/micro-fe/workflows';
 
 Widget configuration and parser output are rendered as data:
 
+Explicit data and connected/parser data take priority. For an unbound widget or a
+mock-only binding, existing `config.mockData` and generated `config.data` can supply
+intentional examples; the selected example data carries a **Sample data** badge.
+An explicitly supplied empty result remains empty, and a connected empty/error
+response never switches to fictional samples. Concrete sink/parser/dataset bindings
+remain connected even if a stale canonical binding says MOCK. Table filters and
+CSV exports select the same envelope and rows as the table renderer.
+
 - **Text widgets** render markdown through the shared fe-libs `Markdown`
   component (raw HTML inside markdown is not rendered, images show their alt
   text). The `html` format is available only when the widget is configured for

package/dist/bigconsole/components/widgets/WidgetHeader.js

@@ -33,8 +33,8 @@ var a = t(function({ previewOnly: t = !1, widget: a, definition: s, isSelected:
 				}),
 				d && /* @__PURE__ */ r("span", {
 					className: "\n              flex-shrink-0\n              px-1.5 py-0.5\n              rounded\n              text-[10px] font-medium uppercase tracking-wide\n              bg-status-info-bg-subtle text-status-info-text\n            ",
-					title: "Example values from the template. Connect a data source to see your own data.",
-					children: "Sample"
+					title: "Example values supplied with this widget. Connect a data source to see your own data.",
+					children: "Sample data"
 				}),
 				p && /* @__PURE__ */ i("span", {
 					className: "\n              flex-shrink-0 inline-flex items-center gap-0.5\n              px-1.5 py-0.5 rounded-md\n              bg-action-primary-bg/10 text-action-primary-text\n              text-[10px] font-medium\n            ",

package/dist/bigconsole/components/widgets/WidgetWrapper.js

@@ -9,52 +9,53 @@ import ne from "../../hooks/useWidgetComments.js";
 import re from "../../hooks/useWidgetExport.js";
 import ie from "../../hooks/useDrilldown.js";
 import "../../hooks/index.js";
-import { resolveTextData as ae } from "./text-widget/textData.js";
-import oe from "./WidgetHeader.js";
-import { useBigConsoleSettings as se } from "../../hooks/useBigConsoleSettings.js";
-import ce from "./states/LoadingState.js";
-import le from "./states/ErrorState.js";
-import c from "./states/EmptyState.js";
+import { resolveTextData as c } from "./text-widget/textData.js";
+import ae from "./WidgetHeader.js";
+import { useBigConsoleSettings as oe } from "../../hooks/useBigConsoleSettings.js";
+import se from "./states/LoadingState.js";
+import ce from "./states/ErrorState.js";
+import le from "./states/EmptyState.js";
 import ue from "./WidgetErrorBoundary.js";
 import { hasCustomIframeConfig as de, hasRenderableCustomConfig as fe } from "./custom/config.js";
 import { getBindingForWidget as pe } from "../../utils/widgetBinding.js";
-import me from "../../renderers/factory/WidgetRendererFactory.js";
-import he from "./widget-actions/WidgetActions.js";
+import { isUsableWidgetData as me, resolveWidgetDisplayData as he, widgetDataSourcePolicy as ge, widgetExportRows as _e } from "../../utils/widgetDisplayData.js";
+import ve from "../../renderers/factory/WidgetRendererFactory.js";
+import ye from "./widget-actions/WidgetActions.js";
 import "./widget-actions/index.js";
-import { Suspense as l, lazy as u, memo as d, useCallback as f, useEffect as ge, useMemo as p, useRef as m, useState as h } from "react";
-import { useApolloClient as _e } from "@apollo/client/react";
-import { jsx as g, jsxs as ve } from "react/jsx-runtime";
+import { Suspense as be, lazy as l, memo as u, useCallback as d, useEffect as xe, useMemo as f, useRef as p, useState as Se } from "react";
+import { useApolloClient as Ce } from "@apollo/client/react";
+import { jsx as m, jsxs as we } from "react/jsx-runtime";
 //#region src/bigconsole/components/widgets/WidgetWrapper.tsx
-var ye = u(() => import("./metric-card/index.js").then((e) => ({ default: e.MetricCardWidget }))), be = u(() => import("./chart/index.js").then((e) => ({ default: e.ChartWidget }))), xe = u(() => import("./table/index.js").then((e) => ({ default: e.TableWidget }))), Se = u(() => import("./pivot-table/index.js").then((e) => ({ default: e.PivotTableWidget }))), Ce = u(() => import("./gauge/index.js").then((e) => ({ default: e.GaugeWidget }))), we = u(() => import("./progress/index.js").then((e) => ({ default: e.ProgressWidget }))), Te = u(() => import("./list/index.js").then((e) => ({ default: e.ListWidget }))), Ee = u(() => import("./heatmap/index.js").then((e) => ({ default: e.HeatmapWidget }))), De = u(() => import("./retention/index.js").then((e) => ({ default: e.RetentionWidget }))), Oe = u(() => import("./calendar/index.js").then((e) => ({ default: e.CalendarWidget }))), ke = u(() => import("./kanban/index.js").then((e) => ({ default: e.KanbanWidget }))), Ae = u(() => import("./timeline/index.js").then((e) => ({ default: e.TimelineWidget }))), je = u(() => import("./kpi-comparison/index.js").then((e) => ({ default: e.KPIComparisonWidget }))), Me = u(() => import("./text-widget/index.js").then((e) => ({ default: e.TextWidget }))), Ne = u(() => import("./map-widget/index.js").then((e) => ({ default: e.MapWidget }))), Pe = u(() => import("./iframe-widget/index.js").then((e) => ({ default: e.IframeWidget }))), Fe = u(() => import("./custom/index.js").then((e) => ({ default: e.CustomWidget })));
-u(() => import("./adaptive-card/index.js").then((e) => ({ default: e.AdaptiveCardWidget })));
-var Ie = u(() => import("./form/index.js").then((e) => ({ default: e.FormWidget }))), Le = u(() => import("./advanced/AdvancedWidgets.js").then((e) => ({ default: e.SankeyWidget }))), Re = u(() => import("./advanced/AdvancedWidgets.js").then((e) => ({ default: e.BoxPlotWidget }))), ze = u(() => import("./advanced/AdvancedWidgets.js").then((e) => ({ default: e.WaterfallWidget }))), Be = u(() => import("./comments/WidgetComments.js").then((e) => ({ default: e.WidgetComments })));
-function _(e, t) {
+var Te = l(() => import("./metric-card/index.js").then((e) => ({ default: e.MetricCardWidget }))), Ee = l(() => import("./chart/index.js").then((e) => ({ default: e.ChartWidget }))), De = l(() => import("./table/index.js").then((e) => ({ default: e.TableWidget }))), Oe = l(() => import("./pivot-table/index.js").then((e) => ({ default: e.PivotTableWidget }))), ke = l(() => import("./gauge/index.js").then((e) => ({ default: e.GaugeWidget }))), Ae = l(() => import("./progress/index.js").then((e) => ({ default: e.ProgressWidget }))), je = l(() => import("./list/index.js").then((e) => ({ default: e.ListWidget }))), Me = l(() => import("./heatmap/index.js").then((e) => ({ default: e.HeatmapWidget }))), Ne = l(() => import("./retention/index.js").then((e) => ({ default: e.RetentionWidget }))), Pe = l(() => import("./calendar/index.js").then((e) => ({ default: e.CalendarWidget }))), Fe = l(() => import("./kanban/index.js").then((e) => ({ default: e.KanbanWidget }))), Ie = l(() => import("./timeline/index.js").then((e) => ({ default: e.TimelineWidget }))), Le = l(() => import("./kpi-comparison/index.js").then((e) => ({ default: e.KPIComparisonWidget }))), Re = l(() => import("./text-widget/index.js").then((e) => ({ default: e.TextWidget }))), ze = l(() => import("./map-widget/index.js").then((e) => ({ default: e.MapWidget }))), Be = l(() => import("./iframe-widget/index.js").then((e) => ({ default: e.IframeWidget }))), Ve = l(() => import("./custom/index.js").then((e) => ({ default: e.CustomWidget })));
+l(() => import("./adaptive-card/index.js").then((e) => ({ default: e.AdaptiveCardWidget })));
+var He = l(() => import("./form/index.js").then((e) => ({ default: e.FormWidget }))), Ue = l(() => import("./advanced/AdvancedWidgets.js").then((e) => ({ default: e.SankeyWidget }))), We = l(() => import("./advanced/AdvancedWidgets.js").then((e) => ({ default: e.BoxPlotWidget }))), Ge = l(() => import("./advanced/AdvancedWidgets.js").then((e) => ({ default: e.WaterfallWidget }))), Ke = l(() => import("./comments/WidgetComments.js").then((e) => ({ default: e.WidgetComments })));
+function h(e, t) {
 	return !(e.previewOnly !== t.previewOnly || e.widget.id !== t.widget.id || e.widget.updatedAt !== t.widget.updatedAt || e.isLoading !== t.isLoading || e.error !== t.error || e.actions !== t.actions || e.data !== t.data || JSON.stringify(e.filterValues) !== JSON.stringify(t.filterValues));
 }
-var v = d(function({ widget: u, children: d, data: _, className: v = "", isLoading: Ve, error: He, onRefresh: y, onDrilldown: Ue, actions: b, onAction: x, filterValues: S, previewOnly: C = !1 }) {
-	let w = se(), We = r((e) => e.viewMode === "edit"), T = !C && We, E = t((e) => e.selectWidget), D = e(u.id), O = n(u.id), k = i(), A = _e(), j = u.dashboardId, M = p(() => {
-		if (!j) return {};
+var g = u(function({ widget: l, children: u, data: h, className: g = "", isLoading: qe, error: Je, onRefresh: _, onDrilldown: Ye, actions: v, onAction: y, filterValues: b, previewOnly: x = !1 }) {
+	let S = oe(), Xe = r((e) => e.viewMode === "edit"), C = !x && Xe, w = t((e) => e.selectWidget), T = e(l.id), Ze = n(l.id), E = i(), D = Ce(), O = l.dashboardId, k = f(() => {
+		if (!O) return {};
 		try {
-			let e = A.readQuery({
+			let e = D.readQuery({
 				query: a,
-				variables: { id: j }
+				variables: { id: O }
 			}), t = {};
 			for (let n of e?.getDashboard?.globalFilters ?? []) {
 				let e = n.config?.field;
-				typeof e == "string" && e && Object.hasOwn(k, n.id) && (t[n.id] = e);
+				typeof e == "string" && e && Object.hasOwn(E, n.id) && (t[n.id] = e);
 			}
 			return t;
 		} catch {
 			return {};
 		}
 	}, [
-		A,
-		j,
-		k
-	]), N = p(() => pe(u), [u]), P = N.source.kind !== "DATASINK" || !!N.source.ref || !!N.parserId || !!u.datasetId, { data: F, loading: Ge } = o(u.id, {
-		skip: C || !P,
-		pollInterval: (u.refreshInterval ?? 0) * 1e3 || 0
-	}), I = p(() => {
+		D,
+		O,
+		E
+	]), A = f(() => pe(l), [l]), { hasDataSource: Qe, allowSamples: j, mockSource: M } = ge(l, A), { data: N, loading: $e, error: et } = o(l.id, {
+		skip: x || !Qe,
+		pollInterval: (l.refreshInterval ?? 0) * 1e3 || 0
+	}), P = f(() => {
 		if (typeof window > "u") return {};
 		let e = new URLSearchParams(window.location.search), t = {};
 		return e.forEach((e, n) => {
@@ -63,56 +64,30 @@ var v = d(function({ widget: u, children: d, data: _, className: v = "", isLoadi
 				r.startsWith("__") || (t[r] = e);
 			}
 		}), t;
-	}, []), L = p(() => {
+	}, []), F = f(() => {
 		let e = {};
-		return I && Object.keys(I).length > 0 && Object.assign(e, I), k && Object.keys(k).length > 0 && Object.assign(e, k), S && Object.keys(S).length > 0 && Object.assign(e, S), e;
+		return P && Object.keys(P).length > 0 && Object.assign(e, P), E && Object.keys(E).length > 0 && Object.assign(e, E), b && Object.keys(b).length > 0 && Object.assign(e, b), e;
 	}, [
-		I,
-		k,
-		S
-	]), R = Object.keys(L).length > 0, z = Ve ?? (Ge && !F) ?? O.isLoading, B = He ?? O.errorMessage, Ke = s(u.type), V = m(y);
-	ge(() => {
-		V.current = y;
-	}, [y]);
-	let qe = f(async () => {
-		V.current && await V.current();
-	}, []), { timeUntilRefresh: Je, isPaused: Ye } = te({
-		widgetId: u.id,
-		refreshInterval: u.refreshInterval,
-		onRefresh: qe,
-		enabled: !C && !T && !!u.refreshInterval
-	}), H = m(null), [U, W] = h(!1), [Xe, Ze] = h(!1), { count: Qe } = ne(u.id, Xe), $e = f(() => {
-		W((e) => {
-			let t = !e;
-			return t && Ze(!0), t;
-		});
-	}, []), et = p(() => {
-		if (_ && Array.isArray(_)) return _;
-		let e = u.data;
-		if (e?.processed && Array.isArray(e.processed)) return e.processed;
-		if (e?.raw) {
-			let t = typeof e.raw == "string" ? JSON.parse(e.raw) : e.raw;
-			if (Array.isArray(t)) return t;
-		}
-		return null;
-	}, [_, u]), { exportCSV: tt, exportPNG: nt } = re(u, {
-		data: et,
-		containerRef: H
-	}), G = f((e) => {
-		if (e == null) return !1;
-		if (Array.isArray(e)) return e.length > 0;
-		if (typeof e == "object") {
-			let t = e, n = Object.keys(t);
-			return n.length === 0 ? !1 : n.some((e) => {
-				let n = t[e];
-				return n == null || n === "" ? !1 : Array.isArray(n) ? n.length > 0 : typeof n == "object" ? G(n) : !0;
-			});
-		}
-		return !0;
-	}, []), rt = f((e) => {
-		if (!R || !e) return e;
+		P,
+		E,
+		b
+	]), I = Object.keys(F).length > 0, L = qe ?? ($e && !N) ?? Ze.isLoading, R = Je ?? et?.message ?? Ze.errorMessage, tt = s(l.type), z = p(_);
+	xe(() => {
+		z.current = _;
+	}, [_]);
+	let nt = d(async () => {
+		z.current && await z.current();
+	}, []), { timeUntilRefresh: rt, isPaused: it } = te({
+		widgetId: l.id,
+		refreshInterval: l.refreshInterval,
+		onRefresh: nt,
+		enabled: !x && !C && !!l.refreshInterval
+	}), B = p(null), [V, H] = Se(!1), [U, at] = Se(!1), { count: ot } = ne(l.id, U), st = d(() => {
+		at(!0), H((e) => !e);
+	}, []), W = d((e) => {
+		if (!I || !e) return e;
 		let t = {}, n = {};
-		Object.entries(L || {}).forEach(([e, r]) => {
+		Object.entries(F || {}).forEach(([e, r]) => {
 			if (e.startsWith("ctx_")) {
 				let n = e.slice(4);
 				t[n] = r;
@@ -174,7 +149,7 @@ var v = d(function({ widget: u, children: d, data: _, className: v = "", isLoadi
 					}
 				}
 				if (typeof a == "object" && a && !Array.isArray(a)) continue;
-				let n = M[t];
+				let n = k[t];
 				if (n) {
 					let t = i(e, n);
 					if (t !== void 0) {
@@ -208,7 +183,18 @@ var v = d(function({ widget: u, children: d, data: _, className: v = "", isLoadi
 		});
 		if (Array.isArray(e)) return a(e);
 		if (e && typeof e == "object") {
-			for (let t of [
+			let t = [
+				...l.type === "table" ? [
+					"data",
+					"items",
+					"rows",
+					"results",
+					"records",
+					"list",
+					"sales",
+					"entries",
+					"values"
+				] : l.type === "pivot_table" ? ["rows"] : [],
 				"kpis",
 				"rows",
 				"items",
@@ -222,343 +208,391 @@ var v = d(function({ widget: u, children: d, data: _, className: v = "", isLoadi
 				"values",
 				"series",
 				"datasets"
-			]) if (e[t] && Array.isArray(e[t])) {
-				let n = a(e[t]);
+			];
+			for (let n of t) if (e[n] && Array.isArray(e[n])) {
+				let t = a(e[n]);
 				return {
 					...e,
-					[t]: n,
-					...t === "rows" ? { totalRows: n.length } : {}
+					[n]: t,
+					...n === "rows" ? { totalRows: t.length } : {}
 				};
 			}
-			let t = Object.entries(e).filter(([e, t]) => Array.isArray(t));
-			if (t.length > 0) {
-				let [n, r] = t[0], i = a(r);
+			let n = Object.entries(e).filter(([e, t]) => Array.isArray(t));
+			if (n.length > 0) {
+				let [t, r] = n[0], i = a(r);
 				return {
 					...e,
-					[n]: i
+					[t]: i
 				};
 			}
 		}
 		return e;
 	}, [
-		R,
-		L,
-		u.id,
+		I,
+		F,
+		k,
+		l.type
+	]), G = f(() => he({
+		explicit: h,
+		fetched: N,
+		persisted: l.data,
+		config: l.config,
+		allowSamples: j,
+		mockSource: M
+	}), [
+		h,
+		N,
+		l,
+		j,
 		M
-	]), K = p(() => {
-		let e = null;
-		if (_ && G(_)) e = _;
-		else if (F) {
-			let t = F;
-			if (t?.processed && G(t.processed)) e = t.processed;
-			else if (t?.raw) try {
-				let n = typeof t.raw == "string" ? JSON.parse(t.raw) : t.raw;
-				G(n) && (e = n);
-			} catch {}
-		} else {
-			let t = u.data;
-			if (t?.processed && G(t.processed)) e = t.processed;
-			else if (t?.raw) try {
-				let n = typeof t.raw == "string" ? JSON.parse(t.raw) : t.raw;
-				G(n) && (e = n);
-			} catch {}
-		}
-		if (!e) {
-			let t = u.config?.mockData;
-			if (t) try {
-				let n = typeof t == "string" ? JSON.parse(t) : t;
-				G(n) && (e = n);
-			} catch {}
-		}
+	]), K = f(() => {
+		let e = G.data;
 		if (e && typeof e == "object" && !Array.isArray(e)) {
-			let t = u.config, n = t?.dataKey ?? t?.dataPath ?? t?.seriesPath;
+			let t = l.config, n = t?.dataKey ?? t?.dataPath ?? t?.seriesPath;
 			if (n && typeof n == "string") {
 				let t = n.split(".").reduce((e, t) => e && typeof e == "object" ? e[t] : void 0, e);
-				t != null && G(t) && (e = t);
+				t != null && me(t) && (e = t);
 			}
 		}
-		return R && e ? rt(e) : e;
+		return I && e ? W(e) : e;
 	}, [
-		_,
-		u,
-		F,
-		R,
-		rt,
-		L,
-		G
-	]), q = p(() => K ?? null, [K]), it = p(() => !q || P ? !1 : u.config?.mockData != null, [
-		q,
-		P,
-		u.config
-	]), { executeDrilldown: at, canDrilldown: ot } = ie({ onDrilldown: (e, t) => {
-		Ue?.(e);
-	} }), J = p(() => ot(u), [u, ot]), st = f((e) => {
-		if (!u.drilldown?.enabled) return;
+		G,
+		l.config,
+		I,
+		W
+	]), ct = K !== null && G.isSample, q = f(() => _e(K, l.type), [K, l.type]), { exportCSV: lt, exportPNG: ut } = re(l, {
+		data: q,
+		containerRef: B
+	}), { executeDrilldown: J, canDrilldown: dt } = ie({ onDrilldown: (e, t) => {
+		Ye?.(e);
+	} }), Y = f(() => dt(l), [l, dt]), ft = d((e) => {
+		if (!l.drilldown?.enabled) return;
 		let t = {
 			selectedData: e || {},
-			globalFilters: k || {},
-			widgetData: q || {},
+			globalFilters: E || {},
+			widgetData: K || {},
 			metadata: {
-				widgetId: u.id,
-				widgetType: u.type,
-				widgetTitle: u.title
+				widgetId: l.id,
+				widgetType: l.type,
+				widgetTitle: l.title
 			},
-			sourceDashboardId: u.dashboardId
+			sourceDashboardId: l.dashboardId
 		};
-		at(u.drilldown, t);
+		J(l.drilldown, t);
 	}, [
-		u,
-		q,
-		k,
-		at
-	]), Y = J && !T ? st : void 0, X = m(null), ct = f((e) => {
-		X.current = {
+		l,
+		K,
+		E,
+		J
+	]), X = Y && !C ? ft : void 0, Z = p(null), pt = d((e) => {
+		Z.current = {
 			x: e.clientX,
 			y: e.clientY
 		};
-	}, []), lt = f((e) => {
-		if (e.stopPropagation(), X.current) {
-			let t = Math.abs(e.clientX - X.current.x), n = Math.abs(e.clientY - X.current.y);
+	}, []), mt = d((e) => {
+		if (e.stopPropagation(), Z.current) {
+			let t = Math.abs(e.clientX - Z.current.x), n = Math.abs(e.clientY - Z.current.y);
 			if (t > 5 || n > 5) {
-				X.current = null;
+				Z.current = null;
 				return;
 			}
 		}
-		X.current = null, T && E(u.id);
+		Z.current = null, C && w(l.id);
 	}, [
-		T,
-		E,
-		u.id
-	]), ut = f((e) => {
-		(e.key === "Enter" || e.key === " ") && (e.preventDefault(), e.stopPropagation(), T && E(u.id));
+		C,
+		w,
+		l.id
+	]), ht = d((e) => {
+		(e.key === "Enter" || e.key === " ") && (e.preventDefault(), e.stopPropagation(), C && w(l.id));
 	}, [
-		T,
-		E,
-		u.id
-	]), dt = p(() => u.type === "custom" && fe(u.config), [u.type, u.config]), ft = p(() => u.type === "custom" && de(u.config), [u.type, u.config]), Z = J && !ft, pt = p(() => u.type === "text" ? ae(u.config, q).hasContent : !1, [
-		u.type,
-		u.config,
-		q
-	]), mt = !z && !B && !q && !dt && !pt, Q = p(() => u.renderer, [u]), ht = p(() => Q && Q !== "BIGCONSOLE", [Q]), gt = p(() => ({
-		widgetId: u.id,
-		data: q || {}
-	}), [u.id, q]), $ = f((e, t) => {
-		if (!x) return;
-		let n = b?.find((t) => t.name === e.name);
-		x(n || e, t);
-	}, [x, b]), _t = f(() => {
-		let e = {
-			widget: u,
-			data: (() => {
-				if (!q) return q;
-				if (u.type === "table" || u.type === "pivot_table") {
-					if (Array.isArray(q)) return q;
-					if (q && typeof q == "object" && "rows" in q) return q.rows;
-				}
-				if (u.type === "list") {
-					if (Array.isArray(q)) return q;
-					if (q && typeof q == "object" && "items" in q) return q.items;
-				}
-				if (u.type === "funnel_chart") {
-					if (Array.isArray(q)) return q;
-					if (q && typeof q == "object" && "stages" in q) return q.stages;
-				}
-				if (u.type === "chart") {
-					if (Array.isArray(q)) return q;
-					if (q && typeof q == "object" && "datasets" in q) {
-						let e = q;
-						if (e.labels && e.datasets) return e.labels.map((t, n) => {
-							let r = { name: t };
-							return e.datasets?.forEach((e) => {
-								r[e.name.toLowerCase()] = e.data[n];
-							}), r;
-						});
-					}
+		C,
+		w,
+		l.id
+	]), gt = f(() => l.type === "custom" && fe(l.config), [l.type, l.config]), _t = f(() => l.type === "custom" && de(l.config), [l.type, l.config]), Q = Y && !_t, vt = f(() => l.type === "text" ? c(l.config, K).hasContent : !1, [
+		l.type,
+		l.config,
+		K
+	]), yt = !L && !R && !K && !gt && !vt, $ = f(() => l.renderer, [l]), bt = f(() => $ && $ !== "BIGCONSOLE", [$]), xt = f(() => ({
+		widgetId: l.id,
+		data: K || {}
+	}), [l.id, K]), St = d((e, t) => {
+		if (!y) return;
+		let n = v?.find((t) => t.name === e.name);
+		y(n || e, t);
+	}, [y, v]), Ct = d(() => {
+		let e = (() => {
+			if (!K) return K;
+			if (l.type === "pivot_table") {
+				if (Array.isArray(K)) return K;
+				if (K && typeof K == "object" && "rows" in K) return K.rows;
+			}
+			if (l.type === "list") {
+				if (Array.isArray(K)) return K;
+				if (K && typeof K == "object" && "items" in K) return K.items;
+			}
+			if (l.type === "funnel_chart") {
+				if (Array.isArray(K)) return K;
+				if (K && typeof K == "object" && "stages" in K) return K.stages;
+			}
+			if (l.type === "chart") {
+				if (Array.isArray(K)) return K;
+				if (K && typeof K == "object" && "datasets" in K) {
+					let e = K;
+					if (e.labels && e.datasets) return e.labels.map((t, n) => {
+						let r = { name: t };
+						return e.datasets?.forEach((e) => {
+							r[e.name.toLowerCase()] = e.data[n];
+						}), r;
+					});
 				}
-				if (u.type === "text") {
-					let e = ae(u.config, q);
-					return {
-						content: e.content,
-						format: e.format,
-						alignment: e.alignment
+			}
+			if (l.type === "text") {
+				let e = c(l.config, K);
+				return {
+					content: e.content,
+					format: e.format,
+					alignment: e.alignment
+				};
+			}
+			if (l.type === "custom") {
+				let e = l.config?.valueField;
+				if (e && K && typeof K == "object" && !Array.isArray(K)) {
+					let t = K;
+					if (e in t) return {
+						value: t[e],
+						label: l.title,
+						data: t
 					};
 				}
-				if (u.type === "custom") {
-					let e = u.config?.valueField;
-					if (e && q && typeof q == "object" && !Array.isArray(q)) {
-						let t = q;
-						if (e in t) return {
-							value: t[e],
-							label: u.title,
-							data: t
-						};
-					}
-				}
-				return q;
-			})(),
-			onDrilldown: Y
+			}
+			return K;
+		})(), t = {
+			widget: l,
+			onDrilldown: X
 		};
-		if (ht) {
+		if (bt) {
 			let e = {};
-			if (K && typeof K == "object" && !Array.isArray(K) && Object.keys(K).length > 0 && (e = { ...K }), u.config?._internalWidgetType === "custom" && Object.keys(e).length > 0) {
-				let t = u.config?.valueField;
+			if (K && typeof K == "object" && !Array.isArray(K) && Object.keys(K).length > 0 && (e = { ...K }), l.config?._internalWidgetType === "custom" && Object.keys(e).length > 0) {
+				let t = l.config?.valueField;
 				if (t && t in e) {
 					let n = e[t], r = typeof n == "number" ? n.toLocaleString() : String(n);
 					e = {
 						...e,
 						value: n,
 						title: e.title || r,
-						description: e.description || u.title || "",
+						description: e.description || l.title || "",
 						text: e.text || r
 					};
 				}
 			}
-			return /* @__PURE__ */ g(me, {
-				widget: u,
+			return /* @__PURE__ */ m(ve, {
+				widget: l,
 				data: e,
-				isEditMode: T,
-				isSelected: D,
-				isLoading: z,
-				error: B,
-				onDrilldown: Y,
-				onAction: $
+				isEditMode: C,
+				isSelected: T,
+				isLoading: L,
+				error: R,
+				onDrilldown: X,
+				onAction: St
 			});
 		}
-		switch (u.type?.toLowerCase() || "") {
-			case "metric_card": return /* @__PURE__ */ g(ye, { ...e });
-			case "kpi_card_comparison": return /* @__PURE__ */ g(je, { ...e });
+		switch (l.type?.toLowerCase() || "") {
+			case "metric_card": return /* @__PURE__ */ m(Te, {
+				...t,
+				data: e
+			});
+			case "kpi_card_comparison": return /* @__PURE__ */ m(Le, {
+				...t,
+				data: e
+			});
 			case "chart":
-			case "funnel_chart": return /* @__PURE__ */ g(be, { ...e });
-			case "waterfall": return /* @__PURE__ */ g(ze, { ...e });
-			case "sankey": return /* @__PURE__ */ g(Le, { ...e });
-			case "box_plot": return /* @__PURE__ */ g(Re, { ...e });
-			case "table": return /* @__PURE__ */ g(xe, { ...e });
-			case "pivot_table": return /* @__PURE__ */ g(Se, { ...e });
-			case "gauge": return /* @__PURE__ */ g(Ce, { ...e });
-			case "progress": return /* @__PURE__ */ g(we, { ...e });
-			case "list": return /* @__PURE__ */ g(Te, { ...e });
-			case "heatmap": return /* @__PURE__ */ g(Ee, { ...e });
-			case "retention": return /* @__PURE__ */ g(De, { ...e });
-			case "calendar": return /* @__PURE__ */ g(Oe, { ...e });
-			case "timeline": return /* @__PURE__ */ g(Ae, { ...e });
-			case "kanban": return /* @__PURE__ */ g(ke, { ...e });
-			case "form": return /* @__PURE__ */ g(Ie, { ...e });
-			case "text": return /* @__PURE__ */ g(Me, { ...e });
-			case "iframe": return /* @__PURE__ */ g(Pe, { ...e });
-			case "map": return /* @__PURE__ */ g(Ne, { ...e });
-			case "custom": return /* @__PURE__ */ g(Fe, { ...e });
-			default: return d || /* @__PURE__ */ g(c, { widgetType: u.type });
+			case "funnel_chart": return /* @__PURE__ */ m(Ee, {
+				...t,
+				data: e
+			});
+			case "waterfall": return /* @__PURE__ */ m(Ge, {
+				...t,
+				data: e
+			});
+			case "sankey": return /* @__PURE__ */ m(Ue, {
+				...t,
+				data: e
+			});
+			case "box_plot": return /* @__PURE__ */ m(We, {
+				...t,
+				data: e
+			});
+			case "table": return /* @__PURE__ */ m(De, {
+				...t,
+				data: e
+			});
+			case "pivot_table": return /* @__PURE__ */ m(Oe, {
+				...t,
+				data: e
+			});
+			case "gauge": return /* @__PURE__ */ m(ke, {
+				...t,
+				data: e
+			});
+			case "progress": return /* @__PURE__ */ m(Ae, {
+				...t,
+				data: e
+			});
+			case "list": return /* @__PURE__ */ m(je, {
+				...t,
+				data: e
+			});
+			case "heatmap": return /* @__PURE__ */ m(Me, {
+				...t,
+				data: e
+			});
+			case "retention": return /* @__PURE__ */ m(Ne, {
+				...t,
+				data: e
+			});
+			case "calendar": return /* @__PURE__ */ m(Pe, {
+				...t,
+				data: e
+			});
+			case "timeline": return /* @__PURE__ */ m(Ie, {
+				...t,
+				data: e
+			});
+			case "kanban": return /* @__PURE__ */ m(Fe, {
+				...t,
+				data: e
+			});
+			case "form": return /* @__PURE__ */ m(He, {
+				...t,
+				data: e
+			});
+			case "text": return /* @__PURE__ */ m(Re, {
+				...t,
+				data: e
+			});
+			case "iframe": return /* @__PURE__ */ m(Be, {
+				...t,
+				data: e
+			});
+			case "map": return /* @__PURE__ */ m(ze, {
+				...t,
+				data: e
+			});
+			case "custom": return /* @__PURE__ */ m(Ve, {
+				...t,
+				data: e
+			});
+			default: return u || /* @__PURE__ */ m(le, { widgetType: l.type });
 		}
 	}, [
+		l,
+		K,
 		u,
-		q,
-		d,
-		Y,
-		ht,
+		X,
+		bt,
+		C,
 		T,
-		D,
-		z,
-		B,
-		$,
-		K
+		L,
+		R,
+		St
 	]);
-	return /* @__PURE__ */ ve("div", {
-		ref: H,
+	return /* @__PURE__ */ we("div", {
+		ref: B,
 		className: `
         group relative flex flex-col
         h-full w-full min-w-0
         rounded-card border
         bg-bg-surface
         shadow-[var(--shadow-elevation-1)]
-        ${w.animationsEnabled ? "motion-safe:transition-[box-shadow,border-color] motion-safe:duration-200" : ""}
-        ${D && T ? "border-[var(--color-action-primary-border)] ring-2 ring-[var(--color-action-primary-border)]/30 shadow-[var(--shadow-elevation-2)]" : w.showWidgetBorders ? "border-[var(--color-border-subtle)] hover:border-action-primary-bg hover:shadow-[var(--shadow-elevation-2)]" : "border-transparent"}
-        ${T ? "cursor-pointer" : ""}
-        ${v}
+        ${S.animationsEnabled ? "motion-safe:transition-[box-shadow,border-color] motion-safe:duration-200" : ""}
+        ${T && C ? "border-[var(--color-action-primary-border)] ring-2 ring-[var(--color-action-primary-border)]/30 shadow-[var(--shadow-elevation-2)]" : S.showWidgetBorders ? "border-[var(--color-border-subtle)] hover:border-action-primary-bg hover:shadow-[var(--shadow-elevation-2)]" : "border-transparent"}
+        ${C ? "cursor-pointer" : ""}
+        ${g}
       `,
-		onMouseDown: ct,
-		onClick: lt,
-		onKeyDown: ut,
-		tabIndex: T ? 0 : -1,
-		role: T ? "button" : void 0,
-		"aria-selected": D,
-		"aria-label": `Widget: ${u.title}`,
-		"data-widget-id": u.id,
-		"data-widget-type": u.type,
+		onMouseDown: pt,
+		onClick: mt,
+		onKeyDown: ht,
+		tabIndex: C ? 0 : -1,
+		role: C ? "button" : void 0,
+		"aria-selected": T,
+		"aria-label": `Widget: ${l.title}`,
+		"data-widget-id": l.id,
+		"data-widget-type": l.type,
 		children: [
-			/* @__PURE__ */ g(oe, {
-				widget: u,
-				previewOnly: C,
-				definition: Ke,
-				isSelected: D,
-				isEditMode: T,
-				isLoading: z,
-				isSampleData: it,
-				timeUntilRefresh: u.refreshInterval && !Ye ? ee(Je) : void 0,
-				hasDrilldown: J,
-				onRefresh: y,
-				onExportCSV: et ? tt : void 0,
-				onExportPNG: nt,
-				onDrilldown: Y ? () => Y() : void 0,
-				onToggleComments: C ? void 0 : $e,
-				commentsOpen: U,
-				commentCount: Xe ? Qe : void 0
+			/* @__PURE__ */ m(ae, {
+				widget: l,
+				previewOnly: x,
+				definition: tt,
+				isSelected: T,
+				isEditMode: C,
+				isLoading: L,
+				isSampleData: ct,
+				timeUntilRefresh: l.refreshInterval && !it ? ee(rt) : void 0,
+				hasDrilldown: Y,
+				onRefresh: _,
+				onExportCSV: q ? lt : void 0,
+				onExportPNG: ut,
+				onDrilldown: X ? () => X() : void 0,
+				onToggleComments: x ? void 0 : st,
+				commentsOpen: V,
+				commentCount: U ? ot : void 0
 			}),
-			/* @__PURE__ */ g("div", {
+			/* @__PURE__ */ m("div", {
 				className: `
           flex-1 overflow-hidden min-h-0 min-w-0
-          ${w.compactMode ? "p-2" : "p-3 sm:p-4"}
-          ${Z && !T ? "cursor-pointer" : ""}
+          ${S.compactMode ? "p-2" : "p-3 sm:p-4"}
+          ${Q && !C ? "cursor-pointer" : ""}
         `,
-				title: Z && !T ? "Click data to drill down" : void 0,
-				children: /* @__PURE__ */ g("div", {
+				title: Q && !C ? "Click data to drill down" : void 0,
+				children: /* @__PURE__ */ m("div", {
 					className: "h-full min-w-0 overflow-auto",
 					children: (() => {
-						if (z) return /* @__PURE__ */ g(ce, {});
-						if (B) return /* @__PURE__ */ g(le, {
-							error: B,
-							onRetry: y
+						if (L) return /* @__PURE__ */ m(se, {});
+						if (R) return /* @__PURE__ */ m(ce, {
+							error: R,
+							onRetry: _
 						});
-						if (mt && !d) return /* @__PURE__ */ g(c, {
-							widgetType: u.type,
-							hideEditHint: C,
-							hasDataSource: P,
-							templateSlot: typeof u.metadata?.templateDataSinkSlot == "string" ? u.metadata.templateDataSinkSlot : null
+						if (yt && !u) return /* @__PURE__ */ m(le, {
+							widgetType: l.type,
+							hideEditHint: x,
+							hasDataSource: Qe,
+							templateSlot: typeof l.metadata?.templateDataSinkSlot == "string" ? l.metadata.templateDataSinkSlot : null
 						});
-						let e = `${N.source.kind}|${N.source.ref ?? ""}|${N.parserId ?? ""}|${u.updatedAt ?? ""}`;
-						return /* @__PURE__ */ g(ue, {
-							widgetId: u.id,
-							widgetType: u.type,
-							widgetTitle: u.title,
+						let e = `${A.source.kind}|${A.source.ref ?? ""}|${A.parserId ?? ""}|${l.updatedAt ?? ""}`;
+						return /* @__PURE__ */ m(ue, {
+							widgetId: l.id,
+							widgetType: l.type,
+							widgetTitle: l.title,
 							resetKey: e,
-							children: d ?? /* @__PURE__ */ g(l, {
-								fallback: /* @__PURE__ */ g(ce, {}),
-								children: _t()
+							children: u ?? /* @__PURE__ */ m(be, {
+								fallback: /* @__PURE__ */ m(se, {}),
+								children: Ct()
 							})
 						});
 					})()
 				})
 			}),
-			b && b.length > 0 && !z && !B && /* @__PURE__ */ g("div", {
+			v && v.length > 0 && !L && !R && /* @__PURE__ */ m("div", {
 				className: "min-w-0 border-t border-[var(--color-border-subtle)] bg-bg-sunken px-3 py-2 sm:px-4",
 				style: { flexShrink: 0 },
-				children: /* @__PURE__ */ g(he, {
-					actions: b,
-					context: gt,
-					onAction: x,
-					disabled: T,
+				children: /* @__PURE__ */ m(ye, {
+					actions: v,
+					context: xt,
+					onAction: y,
+					disabled: C,
 					layout: "horizontal",
 					size: "sm"
 				})
 			}),
-			Z && !T && /* @__PURE__ */ g("div", {
+			Q && !C && /* @__PURE__ */ m("div", {
 				className: "\n            absolute bottom-2 right-2\n            opacity-0 group-hover:opacity-100\n            transition-opacity duration-200\n          ",
 				title: "Click to drill down",
-				children: /* @__PURE__ */ g("svg", {
+				children: /* @__PURE__ */ m("svg", {
 					className: "w-4 h-4 text-text-secondary",
 					fill: "none",
 					stroke: "currentColor",
 					viewBox: "0 0 24 24",
-					children: /* @__PURE__ */ g("path", {
+					children: /* @__PURE__ */ m("path", {
 						strokeLinecap: "round",
 						strokeLinejoin: "round",
 						strokeWidth: 2,
@@ -566,15 +600,15 @@ var v = d(function({ widget: u, children: d, data: _, className: v = "", isLoadi
 					})
 				})
 			}),
-			U && /* @__PURE__ */ g(l, {
+			V && /* @__PURE__ */ m(be, {
 				fallback: null,
-				children: /* @__PURE__ */ g(Be, {
-					widgetId: u.id,
-					onClose: () => W(!1)
+				children: /* @__PURE__ */ m(Ke, {
+					widgetId: l.id,
+					onClose: () => H(!1)
 				})
 			})
 		]
 	});
-}, _);
+}, h);
 //#endregion
-export { v as default };
+export { g as default };

package/dist/bigconsole/utils/widgetDisplayData.d.ts

@@ -0,0 +1,30 @@
+import { WidgetBinding } from '../types';
+
+/** Resolve explicit and connected data before intentional embedded samples. */
+export interface WidgetDisplayData {
+    data: unknown;
+    isSample: boolean;
+}
+export declare function isUsableWidgetData(value: unknown): boolean;
+export declare function resolveWidgetDisplayData(input: {
+    explicit?: unknown;
+    fetched?: unknown;
+    persisted?: unknown;
+    config?: Record<string, unknown>;
+    allowSamples: boolean;
+    mockSource?: boolean;
+}): WidgetDisplayData;
+/** Export the same resolved and filtered rows the renderer receives. */
+export declare function widgetExportRows(value: unknown, widgetType?: string): Record<string, unknown>[] | null;
+/** Legacy concrete sources remain authoritative when a stale canonical binding says MOCK. */
+export declare function widgetDataSourcePolicy(widget: {
+    dataSinkId?: string | null;
+    parserId?: string | null;
+    datasetId?: string | null;
+    dataSourceId?: string | null;
+    config?: Record<string, unknown>;
+}, binding: WidgetBinding): {
+    hasDataSource: boolean;
+    allowSamples: boolean;
+    mockSource: boolean;
+};

package/dist/bigconsole/utils/widgetDisplayData.js

@@ -0,0 +1,80 @@
+//#region src/bigconsole/utils/widgetDisplayData.ts
+function e(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function t(n) {
+	return n == null || n === "" ? !1 : Array.isArray(n) ? n.length > 0 : e(n) ? Object.values(n).some(t) : !0;
+}
+function n(e) {
+	if (typeof e != "string") return e;
+	try {
+		return JSON.parse(e);
+	} catch {
+		return null;
+	}
+}
+function r(r) {
+	if (!e(r)) return null;
+	let i = n(r.processed);
+	if (t(i)) return i;
+	let a = n(r.raw);
+	return t(a) ? a : null;
+}
+function i(i) {
+	if (i.explicit !== void 0 && i.explicit !== null) return {
+		data: i.explicit,
+		isSample: !1
+	};
+	for (let e of [i.fetched, i.persisted]) {
+		let t = r(e);
+		if (t !== null) return {
+			data: t,
+			isSample: i.mockSource === !0
+		};
+	}
+	if (i.allowSamples) {
+		let r = n(i.config?.mockData);
+		if (t(r)) return {
+			data: r,
+			isSample: !0
+		};
+		let a = n(i.config?.data);
+		if ((Array.isArray(a) && a.every(e) || e(a)) && t(a)) return {
+			data: a,
+			isSample: !0
+		};
+	}
+	return {
+		data: null,
+		isSample: !1
+	};
+}
+function a(t, n = "table") {
+	let r = t;
+	if (e(t)) {
+		let e = [
+			...n === "pivot_table" ? ["rows"] : n === "list" ? ["items"] : n === "funnel_chart" ? ["stages"] : [],
+			"data",
+			"items",
+			"rows",
+			"results",
+			"records",
+			"list",
+			"sales",
+			"entries",
+			"values"
+		].find((e) => Array.isArray(t[e]));
+		r = e ? t[e] : Object.values(t).find(Array.isArray);
+	}
+	return !Array.isArray(r) || r.length === 0 || !r.every(e) ? null : r;
+}
+function o(e, t) {
+	let n = e.config?.dataSourceType === "DATASINK" && typeof e.config.dataSinkKey == "string" && e.config.dataSinkKey.length > 0, r = !!(e.dataSinkId || e.parserId || e.datasetId || e.dataSourceId || t.parserId || n), i = t.source.kind !== "DATASINK" || !!t.source.ref, a = t.source.kind === "MOCK" && !r, o = i || r;
+	return {
+		hasDataSource: o,
+		allowSamples: !o || a,
+		mockSource: a
+	};
+}
+//#endregion
+export { t as isUsableWidgetData, i as resolveWidgetDisplayData, o as widgetDataSourcePolicy, a as widgetExportRows };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-bigconsole",
-  "version": "2026.1013.3",
+  "version": "2026.1013.4",
   "description": "BigConsole - AI-powered analytics and dashboard platform",
   "type": "module",
   "files": [