@fusedashlabs/widgets 0.4.3 → 0.4.5

package/dist/components/custom-widget/lib/normalize.js

@@ -0,0 +1,144 @@
+import { normalizeTextContent, normalizeImageContent } from "./content.js";
+import { MAX_PANES } from "./layout.js";
+import { parseTableHeaders, getSourceFromContains, normalizeTableModel } from "./table.js";
+const PANE_KINDS = [
+  "chartWidget",
+  "tableWidget",
+  "textWidget",
+  "imageWidget"
+];
+const CONTENT_CHART_TYPES = ["tableChart", "textChart", "imageChart"];
+const CHART_EMPTY_TITLE = "Custom Chart";
+const CHART_EMPTY_SUBTITLE = "Choose a chart from recommended or configure it by your own.";
+const PANE_EMPTY_TITLES = {
+  chartWidget: CHART_EMPTY_TITLE,
+  tableWidget: "Table",
+  textWidget: "Text",
+  imageWidget: "Image"
+};
+const EMPTY_MODEL = {
+  title: "",
+  direction: "vertical",
+  hasKpi: false,
+  panes: [],
+  widget: null,
+  isEmpty: true
+};
+function isPaneKind(value) {
+  return typeof value === "string" && PANE_KINDS.includes(value);
+}
+function isContentChartType(chartType) {
+  return !!chartType && CONTENT_CHART_TYPES.includes(chartType);
+}
+function emptyPane(kind, index, widgetId, title, subtitle) {
+  return {
+    key: `${widgetId}-${kind}-${index}`,
+    kind,
+    renderable: false,
+    emptyTitle: title,
+    emptySubtitle: subtitle
+  };
+}
+function buildPane(kind, index, widget) {
+  const widgetId = typeof widget.id === "string" ? widget.id : "";
+  const chartType = widget.chartType;
+  if (kind === "chartWidget") {
+    const renderable = !isContentChartType(chartType);
+    return {
+      key: `${widgetId}-${kind}-${index}`,
+      kind,
+      renderable,
+      emptyTitle: PANE_EMPTY_TITLES.chartWidget,
+      emptySubtitle: CHART_EMPTY_SUBTITLE
+    };
+  }
+  if (kind === "tableWidget") {
+    const headers = parseTableHeaders(widget.headers);
+    if (!headers.length) {
+      return emptyPane(
+        kind,
+        index,
+        widgetId,
+        "No table columns yet",
+        "Use MCP chat to describe which dataset fields, chart fields, or personal table data to show in this table."
+      );
+    }
+    if (headers.some((header) => !getSourceFromContains(header))) {
+      return emptyPane(
+        kind,
+        index,
+        widgetId,
+        "Table columns need sources",
+        "Each column must specify a dataset, chart, or static (tableData) field via MCP chat."
+      );
+    }
+    const table = normalizeTableModel(widget);
+    return {
+      key: `${widgetId}-${kind}-${index}`,
+      kind,
+      renderable: true,
+      emptyTitle: PANE_EMPTY_TITLES.tableWidget,
+      emptySubtitle: "",
+      table: table ?? { columns: [], cells: [] }
+    };
+  }
+  if (kind === "textWidget") {
+    const text = normalizeTextContent(widget);
+    if (!text) {
+      return emptyPane(
+        kind,
+        index,
+        widgetId,
+        "Add text",
+        "Click to write your own text or use AI to generate content"
+      );
+    }
+    return {
+      key: `${widgetId}-${kind}-${index}`,
+      kind,
+      renderable: true,
+      emptyTitle: PANE_EMPTY_TITLES.textWidget,
+      emptySubtitle: "",
+      text
+    };
+  }
+  const image = normalizeImageContent(widget);
+  if (!image) {
+    return emptyPane(
+      kind,
+      index,
+      widgetId,
+      "Upload or Generate an Image",
+      "The image should reflect the presented information"
+    );
+  }
+  return {
+    key: `${widgetId}-${kind}-${index}`,
+    kind,
+    renderable: true,
+    emptyTitle: PANE_EMPTY_TITLES.imageWidget,
+    emptySubtitle: "",
+    image
+  };
+}
+function normalizeCustomWidget(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return EMPTY_MODEL;
+  const widget = input;
+  const arranging = widget.arranging ?? {};
+  const direction = arranging.direction === "horizontal" ? "horizontal" : "vertical";
+  const hasKpi = !!arranging.hasKpi;
+  const panes = (Array.isArray(arranging.widgets) ? arranging.widgets : []).filter(isPaneKind).slice(0, MAX_PANES).map((kind, index) => buildPane(kind, index, widget));
+  return {
+    title: typeof widget.name === "string" ? widget.name.trim() : "",
+    direction,
+    hasKpi,
+    panes,
+    widget,
+    isEmpty: panes.length === 0 && !hasKpi
+  };
+}
+export {
+  isContentChartType,
+  normalizeCustomWidget
+};
+//# sourceMappingURL=normalize.js.map

package/dist/components/custom-widget/lib/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sources":["../../../../src/components/custom-widget/lib/normalize.ts"],"sourcesContent":["import { normalizeImageContent, normalizeTextContent } from './content.js';\nimport { MAX_PANES } from './layout.js';\nimport { getSourceFromContains, normalizeTableModel, parseTableHeaders } from './table.js';\nimport type {\n  ArrangingDirection,\n  CustomPane,\n  CustomPaneKind,\n  CustomWidgetModel,\n  CustomWidgetPayload,\n} from './types.js';\n\nconst PANE_KINDS: readonly CustomPaneKind[] = [\n  'chartWidget',\n  'tableWidget',\n  'textWidget',\n  'imageWidget',\n];\n\n/** Client `CONTENT_WIDGET_TYPES` — chart panes fall back to the empty state for these */\nconst CONTENT_CHART_TYPES = ['tableChart', 'textChart', 'imageChart'];\n\n/** Copy lifted from the client `ChartWidget` empty state */\nconst CHART_EMPTY_TITLE = 'Custom Chart';\nconst CHART_EMPTY_SUBTITLE =\n  'Choose a chart from recommended or configure it by your own.';\n\nconst PANE_EMPTY_TITLES: Record<CustomPaneKind, string> = {\n  chartWidget: CHART_EMPTY_TITLE,\n  tableWidget: 'Table',\n  textWidget: 'Text',\n  imageWidget: 'Image',\n};\n\nconst EMPTY_MODEL: CustomWidgetModel = {\n  title: '',\n  direction: 'vertical',\n  hasKpi: false,\n  panes: [],\n  widget: null,\n  isEmpty: true,\n};\n\nfunction isPaneKind(value: unknown): value is CustomPaneKind {\n  return typeof value === 'string' && PANE_KINDS.includes(value as CustomPaneKind);\n}\n\n/** Chart panes whose widget `chartType` is a content type render empty, as in the client */\nexport function isContentChartType(chartType: string | undefined): boolean {\n  return !!chartType && CONTENT_CHART_TYPES.includes(chartType);\n}\n\nfunction emptyPane(\n  kind: CustomPaneKind,\n  index: number,\n  widgetId: string,\n  title: string,\n  subtitle: string,\n): CustomPane {\n  return {\n    key: `${widgetId}-${kind}-${index}`,\n    kind,\n    renderable: false,\n    emptyTitle: title,\n    emptySubtitle: subtitle,\n  };\n}\n\nfunction buildPane(kind: CustomPaneKind, index: number, widget: CustomWidgetPayload): CustomPane {\n  const widgetId = typeof widget.id === 'string' ? widget.id : '';\n  const chartType = widget.chartType;\n\n  if (kind === 'chartWidget') {\n    const renderable = !isContentChartType(chartType);\n    return {\n      key: `${widgetId}-${kind}-${index}`,\n      kind,\n      renderable,\n      emptyTitle: PANE_EMPTY_TITLES.chartWidget,\n      emptySubtitle: CHART_EMPTY_SUBTITLE,\n    };\n  }\n\n  if (kind === 'tableWidget') {\n    const headers = parseTableHeaders(widget.headers);\n    if (!headers.length) {\n      return emptyPane(\n        kind,\n        index,\n        widgetId,\n        'No table columns yet',\n        'Use MCP chat to describe which dataset fields, chart fields, or personal table data to show in this table.',\n      );\n    }\n    if (headers.some((header) => !getSourceFromContains(header))) {\n      return emptyPane(\n        kind,\n        index,\n        widgetId,\n        'Table columns need sources',\n        'Each column must specify a dataset, chart, or static (tableData) field via MCP chat.',\n      );\n    }\n    const table = normalizeTableModel(widget);\n    return {\n      key: `${widgetId}-${kind}-${index}`,\n      kind,\n      renderable: true,\n      emptyTitle: PANE_EMPTY_TITLES.tableWidget,\n      emptySubtitle: '',\n      table: table ?? { columns: [], cells: [] },\n    };\n  }\n\n  if (kind === 'textWidget') {\n    const text = normalizeTextContent(widget);\n    if (!text) {\n      return emptyPane(\n        kind,\n        index,\n        widgetId,\n        'Add text',\n        'Click to write your own text or use AI to generate content',\n      );\n    }\n    return {\n      key: `${widgetId}-${kind}-${index}`,\n      kind,\n      renderable: true,\n      emptyTitle: PANE_EMPTY_TITLES.textWidget,\n      emptySubtitle: '',\n      text,\n    };\n  }\n\n  const image = normalizeImageContent(widget);\n  if (!image) {\n    return emptyPane(\n      kind,\n      index,\n      widgetId,\n      'Upload or Generate an Image',\n      'The image should reflect the presented information',\n    );\n  }\n  return {\n    key: `${widgetId}-${kind}-${index}`,\n    kind,\n    renderable: true,\n    emptyTitle: PANE_EMPTY_TITLES.imageWidget,\n    emptySubtitle: '',\n    image,\n  };\n}\n\n/** Build the shell model from a FuseDash CustomWidget payload. */\nexport function normalizeCustomWidget(input: unknown): CustomWidgetModel {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) return EMPTY_MODEL;\n\n  const widget = input as CustomWidgetPayload;\n  const arranging = widget.arranging ?? {};\n  const direction: ArrangingDirection =\n    arranging.direction === 'horizontal' ? 'horizontal' : 'vertical';\n  const hasKpi = !!arranging.hasKpi;\n\n  const panes = (Array.isArray(arranging.widgets) ? arranging.widgets : [])\n    .filter(isPaneKind)\n    .slice(0, MAX_PANES)\n    .map((kind, index) => buildPane(kind, index, widget));\n\n  return {\n    title: typeof widget.name === 'string' ? widget.name.trim() : '',\n    direction,\n    hasKpi,\n    panes,\n    widget,\n    isEmpty: panes.length === 0 && !hasKpi,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/components/custom-widget/lib/table.d.ts

@@ -0,0 +1,55 @@
+/** Client CustomWidget TableWidget — sources, zip-by-index rows, MCP preview fallback. */
+export type TableColumnSource = {
+    type: 'dataset';
+    datasetId: string;
+    field: string;
+} | {
+    type: 'chart';
+    field: string;
+} | {
+    type: 'static';
+    field: string;
+};
+export interface TableHeaderContains {
+    key?: string;
+    source?: TableColumnSource;
+}
+export interface TableHeader {
+    label: string;
+    contains?: TableHeaderContains[];
+}
+export type DataRow = Record<string, string | number | boolean | null | undefined>;
+export interface TableCellModel {
+    text: string;
+    badge?: 'success' | 'error';
+}
+export interface CustomTableModel {
+    columns: {
+        key: string;
+        label: string;
+    }[];
+    cells: TableCellModel[][];
+}
+export declare function stripDataPrefix(field: string): string;
+export declare function buildQualifiedDatasetColumnKey(datasetId: string, field: string): string;
+export declare function buildQualifiedChartColumnKey(field: string): string;
+export declare function buildQualifiedStaticColumnKey(field: string): string;
+export declare function getSourceFromContains(header: TableHeader): TableColumnSource | undefined;
+export declare function parseTableHeaders(input: unknown): TableHeader[];
+export declare function asDataRows(input: unknown): DataRow[];
+/** Client `buildLiveTableRowsFromSources` — zip sources by row index, not a join. */
+export declare function buildLiveTableRowsFromSources({ headers, datasetRows, chartRows, tableDataRows, }: {
+    headers: TableHeader[];
+    datasetRows: DataRow[];
+    chartRows: DataRow[];
+    tableDataRows?: DataRow[];
+}): DataRow[];
+/** Client `getCellValue` — stringify + Findings badge. */
+export declare function formatTableCell(header: TableHeader, row: DataRow): TableCellModel;
+export declare function normalizeTableModel(widget: {
+    headers?: unknown;
+    data?: unknown;
+    tableData?: unknown;
+    tablePreviewRows?: unknown;
+}): CustomTableModel | null;
+//# sourceMappingURL=table.d.ts.map

package/dist/components/custom-widget/lib/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/components/custom-widget/lib/table.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAgBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAExF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAqB/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAKpD;AAED,qFAAqF;AACrF,wBAAgB,6BAA6B,CAAC,EAC5C,OAAO,EACP,WAAW,EACX,SAAS,EACT,aAAkB,GACnB,EAAE;IACD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B,GAAG,OAAO,EAAE,CAwDZ;AAsBD,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,GAAG,cAAc,CA8BjF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,gBAAgB,GAAG,IAAI,CAqB1B"}

package/dist/components/custom-widget/lib/table.js

@@ -0,0 +1,181 @@
+function stripDataPrefix(field) {
+  return field.startsWith("data.") ? field.slice("data.".length) : field;
+}
+function buildQualifiedDatasetColumnKey(datasetId, field) {
+  return `${field}__${datasetId}`;
+}
+function buildQualifiedChartColumnKey(field) {
+  return `${field}__chart`;
+}
+function buildQualifiedStaticColumnKey(field) {
+  return `${field}__static`;
+}
+function parseSource(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  const o = raw;
+  const field = typeof o.field === "string" ? stripDataPrefix(o.field.trim()) : "";
+  if (!field) return void 0;
+  if (o.type === "chart" || o.type === "static") return { type: o.type, field };
+  if (o.type === "dataset") {
+    const datasetId = typeof o.datasetId === "string" ? o.datasetId.trim() : "";
+    if (!datasetId) return void 0;
+    return { type: "dataset", datasetId, field };
+  }
+  return void 0;
+}
+function getSourceFromContains(header) {
+  var _a, _b;
+  return (_b = (_a = header.contains) == null ? void 0 : _a[0]) == null ? void 0 : _b.source;
+}
+function parseTableHeaders(input) {
+  if (!Array.isArray(input)) return [];
+  const headers = [];
+  for (const item of input) {
+    if (!item || typeof item !== "object" || Array.isArray(item)) continue;
+    const raw = item;
+    const label = typeof raw.label === "string" ? raw.label : "";
+    const containsRaw = Array.isArray(raw.contains) ? raw.contains : [];
+    const contains = containsRaw.flatMap((entry) => {
+      if (!entry || typeof entry !== "object" || Array.isArray(entry)) return [];
+      const e = entry;
+      return [
+        {
+          key: typeof e.key === "string" ? e.key : void 0,
+          source: parseSource(e.source)
+        }
+      ];
+    });
+    headers.push({ label, contains });
+  }
+  return headers;
+}
+function asDataRows(input) {
+  if (!Array.isArray(input)) return [];
+  return input.filter(
+    (row) => !!row && typeof row === "object" && !Array.isArray(row)
+  );
+}
+function buildLiveTableRowsFromSources({
+  headers,
+  datasetRows,
+  chartRows,
+  tableDataRows = []
+}) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  const sourcedHeaders = headers.filter((header) => Boolean(getSourceFromContains(header)));
+  if (!sourcedHeaders.length) return [];
+  const needsDataset = sourcedHeaders.some((h) => {
+    var _a2;
+    return ((_a2 = getSourceFromContains(h)) == null ? void 0 : _a2.type) === "dataset";
+  });
+  const needsChart = sourcedHeaders.some((h) => {
+    var _a2;
+    return ((_a2 = getSourceFromContains(h)) == null ? void 0 : _a2.type) === "chart";
+  });
+  const needsStatic = sourcedHeaders.some((h) => {
+    var _a2;
+    return ((_a2 = getSourceFromContains(h)) == null ? void 0 : _a2.type) === "static";
+  });
+  const rowCount = Math.max(
+    needsDataset ? datasetRows.length : 0,
+    needsChart ? chartRows.length : 0,
+    needsStatic ? tableDataRows.length : 0,
+    0
+  );
+  const rows = [];
+  for (let index = 0; index < rowCount; index += 1) {
+    const row = {};
+    for (const header of sourcedHeaders) {
+      const contains = (_a = header.contains) == null ? void 0 : _a[0];
+      const source = getSourceFromContains(header);
+      if (!contains || !source) continue;
+      if (source.type === "chart") {
+        const chartField = stripDataPrefix(source.field);
+        const outputKey2 = contains.key || buildQualifiedChartColumnKey(chartField);
+        row[outputKey2] = ((_b = chartRows[index]) == null ? void 0 : _b[chartField]) ?? ((_c = chartRows[index]) == null ? void 0 : _c[source.field]) ?? null;
+        continue;
+      }
+      if (source.type === "static") {
+        const staticField = stripDataPrefix(source.field);
+        const outputKey2 = contains.key || buildQualifiedStaticColumnKey(staticField);
+        row[outputKey2] = ((_d = tableDataRows[index]) == null ? void 0 : _d[staticField]) ?? ((_e = tableDataRows[index]) == null ? void 0 : _e[source.field]) ?? ((_f = tableDataRows[index]) == null ? void 0 : _f[outputKey2]) ?? null;
+        continue;
+      }
+      const bareField = stripDataPrefix(source.field);
+      const outputKey = contains.key || buildQualifiedDatasetColumnKey(source.datasetId, bareField);
+      const qualifiedKey = buildQualifiedDatasetColumnKey(source.datasetId, bareField);
+      const legacyQualified = buildQualifiedDatasetColumnKey(source.datasetId, source.field);
+      row[outputKey] = ((_g = datasetRows[index]) == null ? void 0 : _g[qualifiedKey]) ?? ((_h = datasetRows[index]) == null ? void 0 : _h[legacyQualified]) ?? ((_i = datasetRows[index]) == null ? void 0 : _i[bareField]) ?? ((_j = datasetRows[index]) == null ? void 0 : _j[source.field]) ?? null;
+    }
+    rows.push(row);
+  }
+  return rows;
+}
+function formatJsonToReadable(value) {
+  if (!value) return void 0;
+  let obj = null;
+  if (typeof value === "object" && !Array.isArray(value)) {
+    obj = value;
+  } else if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (!trimmed.startsWith("{") || !trimmed.endsWith("}")) return void 0;
+    try {
+      obj = JSON.parse(trimmed);
+    } catch {
+      return void 0;
+    }
+  }
+  if (!obj) return void 0;
+  return Object.entries(obj).map(([key, val]) => `${key} : ${String(val)}`).join(", ");
+}
+function formatTableCell(header, row) {
+  var _a;
+  const contains = (_a = header.contains) == null ? void 0 : _a[0];
+  const source = getSourceFromContains(header);
+  const bareField = ((source == null ? void 0 : source.field) ?? "").replace(/^data\./, "");
+  const keyField = (contains == null ? void 0 : contains.key) || ((source == null ? void 0 : source.type) === "dataset" ? `${bareField}__${source.datasetId}` : (source == null ? void 0 : source.type) === "chart" ? `${bareField}__chart` : (source == null ? void 0 : source.type) === "static" ? `${bareField}__static` : "");
+  if (!keyField) return { text: "-" };
+  const rawValue = row[keyField];
+  const modelValue = formatJsonToReadable(rawValue);
+  const cellValue = modelValue ?? (rawValue == null ? void 0 : typeof rawValue === "string" || typeof rawValue === "number" || typeof rawValue === "boolean" ? String(rawValue) : JSON.stringify(rawValue));
+  const text = cellValue ?? "-";
+  if (keyField.toLowerCase() === "findings") {
+    return { text, badge: text === "Optimal" ? "success" : "error" };
+  }
+  return { text };
+}
+function normalizeTableModel(widget) {
+  const headers = parseTableHeaders(widget.headers);
+  if (!headers.length) return null;
+  if (headers.some((header) => !getSourceFromContains(header))) return null;
+  const rows = buildLiveTableRowsFromSources({
+    headers,
+    datasetRows: asDataRows(widget.tablePreviewRows),
+    chartRows: asDataRows(widget.data),
+    tableDataRows: asDataRows(widget.tableData)
+  });
+  const columns = headers.map((header, index) => {
+    var _a, _b, _c, _d;
+    return {
+      key: ((_b = (_a = header.contains) == null ? void 0 : _a[0]) == null ? void 0 : _b.key) || `col-${index}`,
+      label: header.label || ((_d = (_c = header.contains) == null ? void 0 : _c[0]) == null ? void 0 : _d.key) || `Column ${index + 1}`
+    };
+  });
+  return {
+    columns,
+    cells: rows.map((row) => headers.map((header) => formatTableCell(header, row)))
+  };
+}
+export {
+  asDataRows,
+  buildLiveTableRowsFromSources,
+  buildQualifiedChartColumnKey,
+  buildQualifiedDatasetColumnKey,
+  buildQualifiedStaticColumnKey,
+  formatTableCell,
+  getSourceFromContains,
+  normalizeTableModel,
+  parseTableHeaders,
+  stripDataPrefix
+};
+//# sourceMappingURL=table.js.map

package/dist/components/custom-widget/lib/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sources":["../../../../src/components/custom-widget/lib/table.ts"],"sourcesContent":["/** Client CustomWidget TableWidget — sources, zip-by-index rows, MCP preview fallback. */\n\nexport type TableColumnSource =\n  | { type: 'dataset'; datasetId: string; field: string }\n  | { type: 'chart'; field: string }\n  | { type: 'static'; field: string };\n\nexport interface TableHeaderContains {\n  key?: string;\n  source?: TableColumnSource;\n}\n\nexport interface TableHeader {\n  label: string;\n  contains?: TableHeaderContains[];\n}\n\nexport type DataRow = Record<string, string | number | boolean | null | undefined>;\n\nexport interface TableCellModel {\n  text: string;\n  badge?: 'success' | 'error';\n}\n\nexport interface CustomTableModel {\n  columns: { key: string; label: string }[];\n  cells: TableCellModel[][];\n}\n\nexport function stripDataPrefix(field: string): string {\n  return field.startsWith('data.') ? field.slice('data.'.length) : field;\n}\n\nexport function buildQualifiedDatasetColumnKey(datasetId: string, field: string): string {\n  return `${field}__${datasetId}`;\n}\n\nexport function buildQualifiedChartColumnKey(field: string): string {\n  return `${field}__chart`;\n}\n\nexport function buildQualifiedStaticColumnKey(field: string): string {\n  return `${field}__static`;\n}\n\nfunction parseSource(raw: unknown): TableColumnSource | undefined {\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return undefined;\n  const o = raw as Record<string, unknown>;\n  const field = typeof o.field === 'string' ? stripDataPrefix(o.field.trim()) : '';\n  if (!field) return undefined;\n  if (o.type === 'chart' || o.type === 'static') return { type: o.type, field };\n  if (o.type === 'dataset') {\n    const datasetId = typeof o.datasetId === 'string' ? o.datasetId.trim() : '';\n    if (!datasetId) return undefined;\n    return { type: 'dataset', datasetId, field };\n  }\n  return undefined;\n}\n\nexport function getSourceFromContains(header: TableHeader): TableColumnSource | undefined {\n  return header.contains?.[0]?.source;\n}\n\nexport function parseTableHeaders(input: unknown): TableHeader[] {\n  if (!Array.isArray(input)) return [];\n  const headers: TableHeader[] = [];\n  for (const item of input) {\n    if (!item || typeof item !== 'object' || Array.isArray(item)) continue;\n    const raw = item as Record<string, unknown>;\n    const label = typeof raw.label === 'string' ? raw.label : '';\n    const containsRaw = Array.isArray(raw.contains) ? raw.contains : [];\n    const contains: TableHeaderContains[] = containsRaw.flatMap((entry) => {\n      if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return [];\n      const e = entry as Record<string, unknown>;\n      return [\n        {\n          key: typeof e.key === 'string' ? e.key : undefined,\n          source: parseSource(e.source),\n        },\n      ];\n    });\n    headers.push({ label, contains });\n  }\n  return headers;\n}\n\nexport function asDataRows(input: unknown): DataRow[] {\n  if (!Array.isArray(input)) return [];\n  return input.filter(\n    (row): row is DataRow => !!row && typeof row === 'object' && !Array.isArray(row),\n  ) as DataRow[];\n}\n\n/** Client `buildLiveTableRowsFromSources` — zip sources by row index, not a join. */\nexport function buildLiveTableRowsFromSources({\n  headers,\n  datasetRows,\n  chartRows,\n  tableDataRows = [],\n}: {\n  headers: TableHeader[];\n  datasetRows: DataRow[];\n  chartRows: DataRow[];\n  tableDataRows?: DataRow[];\n}): DataRow[] {\n  const sourcedHeaders = headers.filter((header) => Boolean(getSourceFromContains(header)));\n  if (!sourcedHeaders.length) return [];\n\n  const needsDataset = sourcedHeaders.some((h) => getSourceFromContains(h)?.type === 'dataset');\n  const needsChart = sourcedHeaders.some((h) => getSourceFromContains(h)?.type === 'chart');\n  const needsStatic = sourcedHeaders.some((h) => getSourceFromContains(h)?.type === 'static');\n\n  const rowCount = Math.max(\n    needsDataset ? datasetRows.length : 0,\n    needsChart ? chartRows.length : 0,\n    needsStatic ? tableDataRows.length : 0,\n    0,\n  );\n\n  const rows: DataRow[] = [];\n  for (let index = 0; index < rowCount; index += 1) {\n    const row: DataRow = {};\n    for (const header of sourcedHeaders) {\n      const contains = header.contains?.[0];\n      const source = getSourceFromContains(header);\n      if (!contains || !source) continue;\n\n      if (source.type === 'chart') {\n        const chartField = stripDataPrefix(source.field);\n        const outputKey = contains.key || buildQualifiedChartColumnKey(chartField);\n        row[outputKey] =\n          chartRows[index]?.[chartField] ?? chartRows[index]?.[source.field] ?? null;\n        continue;\n      }\n\n      if (source.type === 'static') {\n        const staticField = stripDataPrefix(source.field);\n        const outputKey = contains.key || buildQualifiedStaticColumnKey(staticField);\n        row[outputKey] =\n          tableDataRows[index]?.[staticField] ??\n          tableDataRows[index]?.[source.field] ??\n          tableDataRows[index]?.[outputKey] ??\n          null;\n        continue;\n      }\n\n      const bareField = stripDataPrefix(source.field);\n      const outputKey = contains.key || buildQualifiedDatasetColumnKey(source.datasetId, bareField);\n      const qualifiedKey = buildQualifiedDatasetColumnKey(source.datasetId, bareField);\n      const legacyQualified = buildQualifiedDatasetColumnKey(source.datasetId, source.field);\n      row[outputKey] =\n        datasetRows[index]?.[qualifiedKey] ??\n        datasetRows[index]?.[legacyQualified] ??\n        datasetRows[index]?.[bareField] ??\n        datasetRows[index]?.[source.field] ??\n        null;\n    }\n    rows.push(row);\n  }\n  return rows;\n}\n\nfunction formatJsonToReadable(value: unknown): string | undefined {\n  if (!value) return undefined;\n  let obj: Record<string, unknown> | null = null;\n  if (typeof value === 'object' && !Array.isArray(value)) {\n    obj = value as Record<string, unknown>;\n  } else if (typeof value === 'string') {\n    const trimmed = value.trim();\n    if (!trimmed.startsWith('{') || !trimmed.endsWith('}')) return undefined;\n    try {\n      obj = JSON.parse(trimmed) as Record<string, unknown>;\n    } catch {\n      return undefined;\n    }\n  }\n  if (!obj) return undefined;\n  return Object.entries(obj)\n    .map(([key, val]) => `${key} : ${String(val)}`)\n    .join(', ');\n}\n\n/** Client `getCellValue` — stringify + Findings badge. */\nexport function formatTableCell(header: TableHeader, row: DataRow): TableCellModel {\n  const contains = header.contains?.[0];\n  const source = getSourceFromContains(header);\n  const bareField = (source?.field ?? '').replace(/^data\\./, '');\n  const keyField =\n    contains?.key ||\n    (source?.type === 'dataset'\n      ? `${bareField}__${source.datasetId}`\n      : source?.type === 'chart'\n        ? `${bareField}__chart`\n        : source?.type === 'static'\n          ? `${bareField}__static`\n          : '');\n  if (!keyField) return { text: '-' };\n\n  const rawValue = row[keyField];\n  const modelValue = formatJsonToReadable(rawValue);\n  const cellValue =\n    modelValue ??\n    (rawValue == null\n      ? undefined\n      : typeof rawValue === 'string' || typeof rawValue === 'number' || typeof rawValue === 'boolean'\n        ? String(rawValue)\n        : JSON.stringify(rawValue));\n  const text = cellValue ?? '-';\n\n  if (keyField.toLowerCase() === 'findings') {\n    return { text, badge: text === 'Optimal' ? 'success' : 'error' };\n  }\n  return { text };\n}\n\nexport function normalizeTableModel(widget: {\n  headers?: unknown;\n  data?: unknown;\n  tableData?: unknown;\n  tablePreviewRows?: unknown;\n}): CustomTableModel | null {\n  const headers = parseTableHeaders(widget.headers);\n  if (!headers.length) return null;\n  if (headers.some((header) => !getSourceFromContains(header))) return null;\n\n  const rows = buildLiveTableRowsFromSources({\n    headers,\n    datasetRows: asDataRows(widget.tablePreviewRows),\n    chartRows: asDataRows(widget.data),\n    tableDataRows: asDataRows(widget.tableData),\n  });\n\n  const columns = headers.map((header, index) => ({\n    key: header.contains?.[0]?.key || `col-${index}`,\n    label: header.label || header.contains?.[0]?.key || `Column ${index + 1}`,\n  }));\n\n  return {\n    columns,\n    cells: rows.map((row) => headers.map((header) => formatTableCell(header, row))),\n  };\n}\n"],"names":["_a","outputKey"],"mappings":"AA6BO,SAAS,gBAAgB,OAAuB;AACrD,SAAO,MAAM,WAAW,OAAO,IAAI,MAAM,MAAM,QAAQ,MAAM,IAAI;AACnE;AAEO,SAAS,+BAA+B,WAAmB,OAAuB;AACvF,SAAO,GAAG,KAAK,KAAK,SAAS;AAC/B;AAEO,SAAS,6BAA6B,OAAuB;AAClE,SAAO,GAAG,KAAK;AACjB;AAEO,SAAS,8BAA8B,OAAuB;AACnE,SAAO,GAAG,KAAK;AACjB;AAEA,SAAS,YAAY,KAA6C;AAChE,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,EAAG,QAAO;AAClE,QAAM,IAAI;AACV,QAAM,QAAQ,OAAO,EAAE,UAAU,WAAW,gBAAgB,EAAE,MAAM,KAAA,CAAM,IAAI;AAC9E,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,EAAE,SAAS,WAAW,EAAE,SAAS,SAAU,QAAO,EAAE,MAAM,EAAE,MAAM,MAAA;AACtE,MAAI,EAAE,SAAS,WAAW;AACxB,UAAM,YAAY,OAAO,EAAE,cAAc,WAAW,EAAE,UAAU,SAAS;AACzE,QAAI,CAAC,UAAW,QAAO;AACvB,WAAO,EAAE,MAAM,WAAW,WAAW,MAAA;AAAA,EACvC;AACA,SAAO;AACT;AAEO,SAAS,sBAAsB,QAAoD;AA9BnF;AA+BL,UAAO,kBAAO,aAAP,mBAAkB,OAAlB,mBAAsB;AAC/B;AAEO,SAAS,kBAAkB,OAA+B;AAC/D,MAAI,CAAC,MAAM,QAAQ,KAAK,UAAU,CAAA;AAClC,QAAM,UAAyB,CAAA;AAC/B,aAAW,QAAQ,OAAO;AACxB,QAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,EAAG;AAC9D,UAAM,MAAM;AACZ,UAAM,QAAQ,OAAO,IAAI,UAAU,WAAW,IAAI,QAAQ;AAC1D,UAAM,cAAc,MAAM,QAAQ,IAAI,QAAQ,IAAI,IAAI,WAAW,CAAA;AACjE,UAAM,WAAkC,YAAY,QAAQ,CAAC,UAAU;AACrE,UAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAA;AACxE,YAAM,IAAI;AACV,aAAO;AAAA,QACL;AAAA,UACE,KAAK,OAAO,EAAE,QAAQ,WAAW,EAAE,MAAM;AAAA,UACzC,QAAQ,YAAY,EAAE,MAAM;AAAA,QAAA;AAAA,MAC9B;AAAA,IAEJ,CAAC;AACD,YAAQ,KAAK,EAAE,OAAO,SAAA,CAAU;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,WAAW,OAA2B;AACpD,MAAI,CAAC,MAAM,QAAQ,KAAK,UAAU,CAAA;AAClC,SAAO,MAAM;AAAA,IACX,CAAC,QAAwB,CAAC,CAAC,OAAO,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,GAAG;AAAA,EAAA;AAEnF;AAGO,SAAS,8BAA8B;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA,gBAAgB,CAAA;AAClB,GAKc;AA3EP;AA4EL,QAAM,iBAAiB,QAAQ,OAAO,CAAC,WAAW,QAAQ,sBAAsB,MAAM,CAAC,CAAC;AACxF,MAAI,CAAC,eAAe,OAAQ,QAAO,CAAA;AAEnC,QAAM,eAAe,eAAe,KAAK,CAAC;AA/ErC,QAAAA;AA+E2C,aAAAA,MAAA,sBAAsB,CAAC,MAAvB,gBAAAA,IAA0B,UAAS;AAAA,GAAS;AAC5F,QAAM,aAAa,eAAe,KAAK,CAAC;AAhFnC,QAAAA;AAgFyC,aAAAA,MAAA,sBAAsB,CAAC,MAAvB,gBAAAA,IAA0B,UAAS;AAAA,GAAO;AACxF,QAAM,cAAc,eAAe,KAAK,CAAC;AAjFpC,QAAAA;AAiF0C,aAAAA,MAAA,sBAAsB,CAAC,MAAvB,gBAAAA,IAA0B,UAAS;AAAA,GAAQ;AAE1F,QAAM,WAAW,KAAK;AAAA,IACpB,eAAe,YAAY,SAAS;AAAA,IACpC,aAAa,UAAU,SAAS;AAAA,IAChC,cAAc,cAAc,SAAS;AAAA,IACrC;AAAA,EAAA;AAGF,QAAM,OAAkB,CAAA;AACxB,WAAS,QAAQ,GAAG,QAAQ,UAAU,SAAS,GAAG;AAChD,UAAM,MAAe,CAAA;AACrB,eAAW,UAAU,gBAAgB;AACnC,YAAM,YAAW,YAAO,aAAP,mBAAkB;AACnC,YAAM,SAAS,sBAAsB,MAAM;AAC3C,UAAI,CAAC,YAAY,CAAC,OAAQ;AAE1B,UAAI,OAAO,SAAS,SAAS;AAC3B,cAAM,aAAa,gBAAgB,OAAO,KAAK;AAC/C,cAAMC,aAAY,SAAS,OAAO,6BAA6B,UAAU;AACzE,YAAIA,UAAS,MACX,eAAU,KAAK,MAAf,mBAAmB,kBAAe,eAAU,KAAK,MAAf,mBAAmB,OAAO,WAAU;AACxE;AAAA,MACF;AAEA,UAAI,OAAO,SAAS,UAAU;AAC5B,cAAM,cAAc,gBAAgB,OAAO,KAAK;AAChD,cAAMA,aAAY,SAAS,OAAO,8BAA8B,WAAW;AAC3E,YAAIA,UAAS,MACX,mBAAc,KAAK,MAAnB,mBAAuB,mBACvB,mBAAc,KAAK,MAAnB,mBAAuB,OAAO,aAC9B,mBAAc,KAAK,MAAnB,mBAAuBA,gBACvB;AACF;AAAA,MACF;AAEA,YAAM,YAAY,gBAAgB,OAAO,KAAK;AAC9C,YAAM,YAAY,SAAS,OAAO,+BAA+B,OAAO,WAAW,SAAS;AAC5F,YAAM,eAAe,+BAA+B,OAAO,WAAW,SAAS;AAC/E,YAAM,kBAAkB,+BAA+B,OAAO,WAAW,OAAO,KAAK;AACrF,UAAI,SAAS,MACX,iBAAY,KAAK,MAAjB,mBAAqB,oBACrB,iBAAY,KAAK,MAAjB,mBAAqB,uBACrB,iBAAY,KAAK,MAAjB,mBAAqB,iBACrB,iBAAY,KAAK,MAAjB,mBAAqB,OAAO,WAC5B;AAAA,IACJ;AACA,SAAK,KAAK,GAAG;AAAA,EACf;AACA,SAAO;AACT;AAEA,SAAS,qBAAqB,OAAoC;AAChE,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,MAAsC;AAC1C,MAAI,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACtD,UAAM;AAAA,EACR,WAAW,OAAO,UAAU,UAAU;AACpC,UAAM,UAAU,MAAM,KAAA;AACtB,QAAI,CAAC,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,SAAS,GAAG,EAAG,QAAO;AAC/D,QAAI;AACF,YAAM,KAAK,MAAM,OAAO;AAAA,IAC1B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,OAAO,QAAQ,GAAG,EACtB,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM,GAAG,GAAG,MAAM,OAAO,GAAG,CAAC,EAAE,EAC7C,KAAK,IAAI;AACd;AAGO,SAAS,gBAAgB,QAAqB,KAA8B;AA1J5E;AA2JL,QAAM,YAAW,YAAO,aAAP,mBAAkB;AACnC,QAAM,SAAS,sBAAsB,MAAM;AAC3C,QAAM,cAAa,iCAAQ,UAAS,IAAI,QAAQ,WAAW,EAAE;AAC7D,QAAM,YACJ,qCAAU,UACT,iCAAQ,UAAS,YACd,GAAG,SAAS,KAAK,OAAO,SAAS,MACjC,iCAAQ,UAAS,UACf,GAAG,SAAS,aACZ,iCAAQ,UAAS,WACf,GAAG,SAAS,aACZ;AACV,MAAI,CAAC,SAAU,QAAO,EAAE,MAAM,IAAA;AAE9B,QAAM,WAAW,IAAI,QAAQ;AAC7B,QAAM,aAAa,qBAAqB,QAAQ;AAChD,QAAM,YACJ,eACC,YAAY,OACT,SACA,OAAO,aAAa,YAAY,OAAO,aAAa,YAAY,OAAO,aAAa,YAClF,OAAO,QAAQ,IACf,KAAK,UAAU,QAAQ;AAC/B,QAAM,OAAO,aAAa;AAE1B,MAAI,SAAS,YAAA,MAAkB,YAAY;AACzC,WAAO,EAAE,MAAM,OAAO,SAAS,YAAY,YAAY,QAAA;AAAA,EACzD;AACA,SAAO,EAAE,KAAA;AACX;AAEO,SAAS,oBAAoB,QAKR;AAC1B,QAAM,UAAU,kBAAkB,OAAO,OAAO;AAChD,MAAI,CAAC,QAAQ,OAAQ,QAAO;AAC5B,MAAI,QAAQ,KAAK,CAAC,WAAW,CAAC,sBAAsB,MAAM,CAAC,EAAG,QAAO;AAErE,QAAM,OAAO,8BAA8B;AAAA,IACzC;AAAA,IACA,aAAa,WAAW,OAAO,gBAAgB;AAAA,IAC/C,WAAW,WAAW,OAAO,IAAI;AAAA,IACjC,eAAe,WAAW,OAAO,SAAS;AAAA,EAAA,CAC3C;AAED,QAAM,UAAU,QAAQ,IAAI,CAAC,QAAQ,UAAA;AA3MhC;AA2M2C;AAAA,MAC9C,OAAK,kBAAO,aAAP,mBAAkB,OAAlB,mBAAsB,QAAO,OAAO,KAAK;AAAA,MAC9C,OAAO,OAAO,WAAS,kBAAO,aAAP,mBAAkB,OAAlB,mBAAsB,QAAO,UAAU,QAAQ,CAAC;AAAA,IAAA;AAAA,GACvE;AAEF,SAAO;AAAA,IACL;AAAA,IACA,OAAO,KAAK,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,WAAW,gBAAgB,QAAQ,GAAG,CAAC,CAAC;AAAA,EAAA;AAElF;"}

package/dist/components/custom-widget/lib/types.d.ts

@@ -0,0 +1,55 @@
+import { CustomTableModel } from './table.js';
+/** Pane types a FuseDash CustomWidget can arrange (`arranging.widgets`). */
+export type CustomPaneKind = 'chartWidget' | 'tableWidget' | 'textWidget' | 'imageWidget';
+/**
+ * Flex direction of the pane row, using FuseDash semantics:
+ * `vertical` lays panes out side by side, `horizontal` stacks them.
+ */
+export type ArrangingDirection = 'vertical' | 'horizontal';
+export interface CustomWidgetArranging {
+    widgets?: string[];
+    hasKpi?: boolean;
+    direction?: ArrangingDirection;
+}
+/** FuseDash `WidgetItem` subset the shell reads; the rest is forwarded to panes. */
+export interface CustomWidgetPayload {
+    id?: string;
+    name?: string;
+    chartType?: string;
+    arranging?: CustomWidgetArranging;
+    kpis?: unknown[];
+    text?: string;
+    imageUrl?: string;
+    alt?: string;
+    headers?: unknown[];
+    data?: unknown;
+    tableData?: unknown;
+    tablePreviewRows?: unknown;
+    [key: string]: unknown;
+}
+export interface CustomPane {
+    /** Stable key for list rendering — mirrors the client `${id}-${chartType}-${index}` */
+    key: string;
+    kind: CustomPaneKind;
+    /** true when the pane mounts content; false renders the pane empty state */
+    renderable: boolean;
+    emptyTitle: string;
+    emptySubtitle: string;
+    table?: CustomTableModel;
+    text?: string;
+    image?: {
+        src: string;
+        alt: string;
+    };
+}
+export interface CustomWidgetModel {
+    title: string;
+    direction: ArrangingDirection;
+    hasKpi: boolean;
+    panes: CustomPane[];
+    /** Payload handed to chart / KPI panes, or null when the input was unusable */
+    widget: CustomWidgetPayload | null;
+    /** No panes and no KPI band — the client `WidgetDefaultState` */
+    isEmpty: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/custom-widget/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/custom-widget/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAE1F;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,YAAY,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,4EAA4E;IAC5E,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,+EAA+E;IAC/E,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/components/custom-widget/metadata.json.d.ts

@@ -0,0 +1,96 @@
+declare const _default: {
+  "id": "custom-widget",
+  "tag": "ui9000-custom-widget",
+  "title": "Custom Widget",
+  "description": "FuseDash CustomWidget shell — title, optional KPI band, and up to two arranged panes. Chart panes mount ui9000-chart-renderer, the KPI band mounts ui9000-kpi-widget, table/text/image panes render inline. No Redux.",
+  "chartTypeKeys": ["customWidget"],
+  "source": "client/libs/shared/components/src/Widgets/CustomWidget/",
+  "stack": "composite",
+  "lazyImport": "@ui9000/widgets/lazy/custom-widget",
+  "entry": "@ui9000/widgets/custom-widget",
+  "usageConditions": {
+    "host": "mcp-chat",
+    "notFor": "fusedash-editor",
+    "mapsExcluded": true,
+    "requiresArranging": "Reads arranging.widgets / arranging.hasKpi / arranging.direction; renders the default state when both are absent.",
+    "panesSupported": ["chartWidget", "tableWidget", "textWidget", "imageWidget"],
+    "maxPanes": 2
+  },
+  "allowedActions": ["resize", "download"],
+  "propsSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "data": {
+        "type": "object",
+        "description": "FuseDash WidgetItem JSON for the custom widget, including arranging, kpis, and pane fields (text, imageUrl, headers, tableData, tablePreviewRows)",
+        "properties": {
+          "id": { "type": "string" },
+          "name": { "type": "string" },
+          "chartType": {
+            "type": "string",
+            "description": "Chart type of the chartWidget pane; content types (tableChart, textChart, imageChart) render the pane empty state"
+          },
+          "text": { "type": "string", "description": "Markdown/plain text for a textWidget pane" },
+          "imageUrl": { "type": "string", "description": "http(s) URL for an imageWidget pane" },
+          "alt": { "type": "string" },
+          "headers": {
+            "type": "array",
+            "description": "Table columns. Each contains[].source is dataset | chart | static"
+          },
+          "tableData": { "type": "array", "description": "Personal/static rows for static-sourced columns" },
+          "tablePreviewRows": {
+            "type": "array",
+            "description": "MCP snapshot used as dataset rows when the host has no live select"
+          },
+          "arranging": {
+            "type": "object",
+            "properties": {
+              "widgets": {
+                "type": "array",
+                "maxItems": 2,
+                "items": {
+                  "type": "string",
+                  "enum": ["chartWidget", "tableWidget", "textWidget", "imageWidget"]
+                }
+              },
+              "hasKpi": { "type": "boolean", "default": false },
+              "direction": {
+                "type": "string",
+                "enum": ["vertical", "horizontal"],
+                "default": "vertical",
+                "description": "FuseDash semantics — vertical lays panes side by side, horizontal stacks them"
+              }
+            }
+          },
+          "kpis": {
+            "type": "array",
+            "description": "KPI items rendered in the KPI band when arranging.hasKpi is true"
+          }
+        }
+      },
+      "chartTitle": {
+        "type": "string",
+        "description": "Header title override; falls back to data.name"
+      },
+      "direction": {
+        "type": "string",
+        "enum": ["vertical", "horizontal"],
+        "description": "Overrides data.arranging.direction"
+      },
+      "scale": {
+        "type": "string",
+        "enum": ["compact", "default", "comfortable"],
+        "default": "default"
+      },
+      "showHeader": { "type": "boolean", "default": true },
+      "showGrid": { "type": "boolean", "default": true },
+      "showLegend": { "type": "boolean", "default": true },
+      "showTooltip": { "type": "boolean", "default": true }
+    },
+    "required": ["data"]
+  }
+}
+;
+
+export default _default;

package/dist/components/custom-widget/metadata.json.js

@@ -0,0 +1,42 @@
+const id = "custom-widget";
+const tag = "ui9000-custom-widget";
+const title = "Custom Widget";
+const description = "FuseDash CustomWidget shell — title, optional KPI band, and up to two arranged panes. Chart panes mount ui9000-chart-renderer, the KPI band mounts ui9000-kpi-widget, table/text/image panes render inline. No Redux.";
+const chartTypeKeys = ["customWidget"];
+const source = "client/libs/shared/components/src/Widgets/CustomWidget/";
+const stack = "composite";
+const lazyImport = "@ui9000/widgets/lazy/custom-widget";
+const entry = "@ui9000/widgets/custom-widget";
+const usageConditions = { "host": "mcp-chat", "notFor": "fusedash-editor", "mapsExcluded": true, "requiresArranging": "Reads arranging.widgets / arranging.hasKpi / arranging.direction; renders the default state when both are absent.", "panesSupported": ["chartWidget", "tableWidget", "textWidget", "imageWidget"], "maxPanes": 2 };
+const allowedActions = ["resize", "download"];
+const propsSchema = { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "data": { "type": "object", "description": "FuseDash WidgetItem JSON for the custom widget, including arranging, kpis, and pane fields (text, imageUrl, headers, tableData, tablePreviewRows)", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "chartType": { "type": "string", "description": "Chart type of the chartWidget pane; content types (tableChart, textChart, imageChart) render the pane empty state" }, "text": { "type": "string", "description": "Markdown/plain text for a textWidget pane" }, "imageUrl": { "type": "string", "description": "http(s) URL for an imageWidget pane" }, "alt": { "type": "string" }, "headers": { "type": "array", "description": "Table columns. Each contains[].source is dataset | chart | static" }, "tableData": { "type": "array", "description": "Personal/static rows for static-sourced columns" }, "tablePreviewRows": { "type": "array", "description": "MCP snapshot used as dataset rows when the host has no live select" }, "arranging": { "type": "object", "properties": { "widgets": { "type": "array", "maxItems": 2, "items": { "type": "string", "enum": ["chartWidget", "tableWidget", "textWidget", "imageWidget"] } }, "hasKpi": { "type": "boolean", "default": false }, "direction": { "type": "string", "enum": ["vertical", "horizontal"], "default": "vertical", "description": "FuseDash semantics — vertical lays panes side by side, horizontal stacks them" } } }, "kpis": { "type": "array", "description": "KPI items rendered in the KPI band when arranging.hasKpi is true" } } }, "chartTitle": { "type": "string", "description": "Header title override; falls back to data.name" }, "direction": { "type": "string", "enum": ["vertical", "horizontal"], "description": "Overrides data.arranging.direction" }, "scale": { "type": "string", "enum": ["compact", "default", "comfortable"], "default": "default" }, "showHeader": { "type": "boolean", "default": true }, "showGrid": { "type": "boolean", "default": true }, "showLegend": { "type": "boolean", "default": true }, "showTooltip": { "type": "boolean", "default": true } }, "required": ["data"] };
+const metadata = {
+  id,
+  tag,
+  title,
+  description,
+  chartTypeKeys,
+  source,
+  stack,
+  lazyImport,
+  entry,
+  usageConditions,
+  allowedActions,
+  propsSchema
+};
+export {
+  allowedActions,
+  chartTypeKeys,
+  metadata as default,
+  description,
+  entry,
+  id,
+  lazyImport,
+  propsSchema,
+  source,
+  stack,
+  tag,
+  title,
+  usageConditions
+};
+//# sourceMappingURL=metadata.json.js.map

package/dist/components/custom-widget/metadata.json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;"}