@fusedashlabs/widgets 0.2.0

package/dist/components/sankey-chart/element/ui9000-sankey-chart.js

@@ -0,0 +1,186 @@
+import { LitElement, nothing, html } from "lit";
+import { property, state, customElement } from "lit/decorators.js";
+import { readThemeFromElement } from "../../../context/widget-context.js";
+import { parseJsonAttr, getSankeyDimensions } from "../../../utils/chart-helpers.js";
+import { chartPropsChanged } from "../../../utils/lit-draw.js";
+import { renderSankeyChart } from "../render/draw.js";
+import { sankeyStyles } from "./styles.js";
+import { normalizeSankeyData } from "../lib/normalize.js";
+import { buildColorRanges } from "../lib/domain.js";
+import { formatCapitalizedWords, formatSankeyValue } from "../lib/format.js";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+const EMPTY_VIEW = {
+  empty: true,
+  circular: false,
+  sourceLabel: "",
+  targetLabel: "",
+  colorRanges: []
+};
+let Ui9000SankeyChart = class extends LitElement {
+  constructor() {
+    super(...arguments);
+    this.dataJson = "[]";
+    this.showLegend = true;
+    this.showTooltip = true;
+    this.sourceLabel = "";
+    this.targetLabel = "";
+    this._tooltip = null;
+    this._view = EMPTY_VIEW;
+    this._raf = 0;
+  }
+  connectedCallback() {
+    super.connectedCallback();
+    this._resizeObserver = new ResizeObserver(() => this.scheduleDraw());
+    this._resizeObserver.observe(this);
+  }
+  disconnectedCallback() {
+    var _a;
+    (_a = this._resizeObserver) == null ? void 0 : _a.disconnect();
+    cancelAnimationFrame(this._raf);
+    super.disconnectedCallback();
+  }
+  updated(changed) {
+    if (chartPropsChanged(changed)) this.scheduleDraw();
+  }
+  scheduleDraw() {
+    cancelAnimationFrame(this._raf);
+    this._raf = requestAnimationFrame(() => this.draw());
+  }
+  parseData() {
+    return normalizeSankeyData(parseJsonAttr(this.dataJson, []));
+  }
+  draw() {
+    var _a;
+    const root = (_a = this.shadowRoot) == null ? void 0 : _a.querySelector(".chart-root");
+    if (!root) return;
+    const model = this.parseData();
+    const colorRanges = buildColorRanges(
+      model.links.map((l) => l.value),
+      model.colors
+    );
+    this._view = {
+      empty: model.links.length === 0,
+      circular: model.circular,
+      sourceLabel: this.sourceLabel || model.sourceLabel,
+      targetLabel: this.targetLabel || model.targetLabel,
+      colorRanges
+    };
+    if (!model.links.length) {
+      root.replaceChildren();
+      return;
+    }
+    const theme = readThemeFromElement(this);
+    const { width, height } = getSankeyDimensions(root);
+    renderSankeyChart(root, {
+      model,
+      colorRanges,
+      width,
+      height,
+      theme,
+      onLinkHover: this.showTooltip ? ({ sourceLabel, targetLabel, value, event }) => {
+        this.setTooltip(event, [
+          { key: this._view.sourceLabel, value: formatCapitalizedWords(sourceLabel) },
+          { key: model.valueLabel, value: formatSankeyValue(value) },
+          { key: this._view.targetLabel, value: formatCapitalizedWords(targetLabel) }
+        ]);
+      } : void 0,
+      onLinkLeave: this.showTooltip ? () => this.clearTooltip() : void 0,
+      onLabelHover: this.showTooltip ? ({ label, event }) => this.setTooltip(event, [{ key: "", value: label }]) : void 0,
+      onLabelLeave: this.showTooltip ? () => this.clearTooltip() : void 0
+    });
+  }
+  setTooltip(event, rows) {
+    const rect = this.getBoundingClientRect();
+    this._tooltip = {
+      x: event.clientX - rect.left,
+      y: event.clientY - rect.top,
+      rows
+    };
+  }
+  clearTooltip() {
+    this._tooltip = null;
+  }
+  render() {
+    const { empty, circular, sourceLabel, targetLabel, colorRanges } = this._view;
+    const showHeaders = !empty && Boolean(sourceLabel || targetLabel);
+    return html`
+      ${showHeaders ? html`<div class="axis-labels" part="axis-labels">
+            <div>${sourceLabel}</div>
+            <div>${targetLabel}</div>
+          </div>` : nothing}
+
+      <div class="chart-root" part="chart" ?hidden=${empty}></div>
+
+      ${empty ? html`<div class="empty" part="empty">
+            ${circular ? "Circular dependency detected in the data — this cannot be drawn as a Sankey." : "No data"}
+          </div>` : nothing}
+
+      ${!empty && this.showLegend && colorRanges.length ? html`<div class="legend" part="legend">
+            <span>Low</span>
+            <div class="swatches">
+              ${colorRanges.map(
+      (range) => html`<div class="swatch" style="background-color:${range.color}"></div>`
+    )}
+            </div>
+            <span>High</span>
+          </div>` : nothing}
+
+      ${this._tooltip ? html`<div
+            class="tooltip"
+            part="tooltip"
+            style="left:${this._tooltip.x}px;top:${this._tooltip.y}px"
+          >
+            ${this._tooltip.rows.map(
+      (row) => html`<div>
+                  ${row.key ? html`<span class="key">${row.key}:</span> ` : nothing}${row.value}
+                </div>`
+    )}
+          </div>` : nothing}
+    `;
+  }
+};
+Ui9000SankeyChart.styles = sankeyStyles;
+__decorateClass([
+  property({ type: String, attribute: "data" })
+], Ui9000SankeyChart.prototype, "dataJson", 2);
+__decorateClass([
+  property({ type: Boolean, attribute: "show-legend" })
+], Ui9000SankeyChart.prototype, "showLegend", 2);
+__decorateClass([
+  property({ type: Boolean, attribute: "show-tooltip" })
+], Ui9000SankeyChart.prototype, "showTooltip", 2);
+__decorateClass([
+  property({ type: String, attribute: "source-label" })
+], Ui9000SankeyChart.prototype, "sourceLabel", 2);
+__decorateClass([
+  property({ type: String, attribute: "target-label" })
+], Ui9000SankeyChart.prototype, "targetLabel", 2);
+__decorateClass([
+  state()
+], Ui9000SankeyChart.prototype, "_tooltip", 2);
+__decorateClass([
+  state()
+], Ui9000SankeyChart.prototype, "_view", 2);
+Ui9000SankeyChart = __decorateClass([
+  customElement("ui9000-sankey-chart")
+], Ui9000SankeyChart);
+function registerSankeyChart() {
+  if (!customElements.get("ui9000-sankey-chart")) {
+    customElements.define("ui9000-sankey-chart", Ui9000SankeyChart);
+  }
+}
+registerSankeyChart();
+export {
+  Ui9000SankeyChart,
+  registerSankeyChart
+};
+//# sourceMappingURL=ui9000-sankey-chart.js.map

package/dist/components/sankey-chart/element/ui9000-sankey-chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui9000-sankey-chart.js","sources":["../../../../src/components/sankey-chart/element/ui9000-sankey-chart.ts"],"sourcesContent":["import { LitElement, html, nothing, type PropertyValues } from 'lit';\nimport { customElement, property, state } from 'lit/decorators.js';\n\nimport { readThemeFromElement } from '../../../context/widget-context.js';\nimport { getSankeyDimensions, parseJsonAttr } from '../../../utils/chart-helpers.js';\nimport { chartPropsChanged } from '../../../utils/lit-draw.js';\nimport {\n  buildColorRanges,\n  formatCapitalizedWords,\n  formatSankeyValue,\n  normalizeSankeyData,\n  type SankeyColorRange,\n  type SankeyInput,\n  type SankeyModel,\n} from '../lib/index.js';\nimport { renderSankeyChart } from '../render/draw.js';\nimport { sankeyStyles } from './styles.js';\n\ninterface TooltipRow {\n  key: string;\n  value: string;\n}\n\ninterface SankeyView {\n  empty: boolean;\n  circular: boolean;\n  sourceLabel: string;\n  targetLabel: string;\n  colorRanges: SankeyColorRange[];\n}\n\nconst EMPTY_VIEW: SankeyView = {\n  empty: true,\n  circular: false,\n  sourceLabel: '',\n  targetLabel: '',\n  colorRanges: [],\n};\n\n@customElement('ui9000-sankey-chart')\nexport class Ui9000SankeyChart extends LitElement {\n  static override styles = sankeyStyles;\n\n  /** JSON: FuseDash widget payload | { nodes?, links } | SankeyLink[] */\n  @property({ type: String, attribute: 'data' })\n  dataJson = '[]';\n\n  @property({ type: Boolean, attribute: 'show-legend' })\n  showLegend = true;\n\n  @property({ type: Boolean, attribute: 'show-tooltip' })\n  showTooltip = true;\n\n  /** Overrides the header above the left column. */\n  @property({ type: String, attribute: 'source-label' })\n  sourceLabel = '';\n\n  /** Overrides the header above the right column. */\n  @property({ type: String, attribute: 'target-label' })\n  targetLabel = '';\n\n  @state()\n  private _tooltip: { x: number; y: number; rows: TooltipRow[] } | null = null;\n\n  @state()\n  private _view: SankeyView = EMPTY_VIEW;\n\n  private _resizeObserver?: ResizeObserver;\n  private _raf = 0;\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    this._resizeObserver = new ResizeObserver(() => this.scheduleDraw());\n    this._resizeObserver.observe(this);\n  }\n\n  override disconnectedCallback(): void {\n    this._resizeObserver?.disconnect();\n    cancelAnimationFrame(this._raf);\n    super.disconnectedCallback();\n  }\n\n  override updated(changed: PropertyValues): void {\n    if (chartPropsChanged(changed)) this.scheduleDraw();\n  }\n\n  private scheduleDraw(): void {\n    cancelAnimationFrame(this._raf);\n    this._raf = requestAnimationFrame(() => this.draw());\n  }\n\n  private parseData(): SankeyModel {\n    return normalizeSankeyData(parseJsonAttr<SankeyInput>(this.dataJson, []));\n  }\n\n  private draw(): void {\n    const root = this.shadowRoot?.querySelector('.chart-root') as HTMLElement | null;\n    if (!root) return;\n\n    const model = this.parseData();\n    const colorRanges = buildColorRanges(\n      model.links.map((l) => l.value),\n      model.colors,\n    );\n\n    this._view = {\n      empty: model.links.length === 0,\n      circular: model.circular,\n      sourceLabel: this.sourceLabel || model.sourceLabel,\n      targetLabel: this.targetLabel || model.targetLabel,\n      colorRanges,\n    };\n\n    if (!model.links.length) {\n      root.replaceChildren();\n      return;\n    }\n\n    const theme = readThemeFromElement(this);\n    const { width, height } = getSankeyDimensions(root);\n\n    renderSankeyChart(root, {\n      model,\n      colorRanges,\n      width,\n      height,\n      theme,\n      onLinkHover: this.showTooltip\n        ? ({ sourceLabel, targetLabel, value, event }) => {\n            this.setTooltip(event, [\n              { key: this._view.sourceLabel, value: formatCapitalizedWords(sourceLabel) },\n              { key: model.valueLabel, value: formatSankeyValue(value) },\n              { key: this._view.targetLabel, value: formatCapitalizedWords(targetLabel) },\n            ]);\n          }\n        : undefined,\n      onLinkLeave: this.showTooltip ? () => this.clearTooltip() : undefined,\n      onLabelHover: this.showTooltip\n        ? ({ label, event }) => this.setTooltip(event, [{ key: '', value: label }])\n        : undefined,\n      onLabelLeave: this.showTooltip ? () => this.clearTooltip() : undefined,\n    });\n  }\n\n  private setTooltip(event: MouseEvent, rows: TooltipRow[]): void {\n    const rect = this.getBoundingClientRect();\n    this._tooltip = {\n      x: event.clientX - rect.left,\n      y: event.clientY - rect.top,\n      rows,\n    };\n  }\n\n  private clearTooltip(): void {\n    this._tooltip = null;\n  }\n\n  override render() {\n    const { empty, circular, sourceLabel, targetLabel, colorRanges } = this._view;\n    const showHeaders = !empty && Boolean(sourceLabel || targetLabel);\n\n    return html`\n      ${showHeaders\n        ? html`<div class=\"axis-labels\" part=\"axis-labels\">\n            <div>${sourceLabel}</div>\n            <div>${targetLabel}</div>\n          </div>`\n        : nothing}\n\n      <div class=\"chart-root\" part=\"chart\" ?hidden=${empty}></div>\n\n      ${empty\n        ? html`<div class=\"empty\" part=\"empty\">\n            ${circular\n              ? 'Circular dependency detected in the data — this cannot be drawn as a Sankey.'\n              : 'No data'}\n          </div>`\n        : nothing}\n\n      ${!empty && this.showLegend && colorRanges.length\n        ? html`<div class=\"legend\" part=\"legend\">\n            <span>Low</span>\n            <div class=\"swatches\">\n              ${colorRanges.map(\n                (range) =>\n                  html`<div class=\"swatch\" style=\"background-color:${range.color}\"></div>`,\n              )}\n            </div>\n            <span>High</span>\n          </div>`\n        : nothing}\n\n      ${this._tooltip\n        ? html`<div\n            class=\"tooltip\"\n            part=\"tooltip\"\n            style=\"left:${this._tooltip.x}px;top:${this._tooltip.y}px\"\n          >\n            ${this._tooltip.rows.map(\n              (row) =>\n                html`<div>\n                  ${row.key ? html`<span class=\"key\">${row.key}:</span> ` : nothing}${row.value}\n                </div>`,\n            )}\n          </div>`\n        : nothing}\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'ui9000-sankey-chart': Ui9000SankeyChart;\n  }\n}\n\nexport function registerSankeyChart(): void {\n  if (!customElements.get('ui9000-sankey-chart')) {\n    customElements.define('ui9000-sankey-chart', Ui9000SankeyChart);\n  }\n}\n\nregisterSankeyChart();\n"],"names":[],"mappings":"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"}

package/dist/components/sankey-chart/index.d.ts

@@ -0,0 +1,5 @@
+export { Ui9000SankeyChart, registerSankeyChart, } from './element/ui9000-sankey-chart.js';
+export { renderSankeyChart, type RenderSankeyOptions, type SankeyLabelHover, type SankeyLinkHover, } from './render/index.js';
+export { MAX_SANKEY_LINKS, NODE_LABEL_MAX, buildColorRanges, formatCapitalizedWords, formatSankeyValue, generateBreakPoints, normalizeSankeyData, pickRangeColor, truncateNodeLabel, type SankeyColorRange, type SankeyFusePayload, type SankeyGraphPayload, type SankeyInput, type SankeyLinkDatum, type SankeyModel, type SankeyNodeDatum, } from './lib/index.js';
+export { default as sankeyChartMetadata } from './metadata.json';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/sankey-chart/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/sankey-chart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/components/sankey-chart/index.js

@@ -0,0 +1,23 @@
+import { registerSankeyChart } from "./element/ui9000-sankey-chart.js";
+import { Ui9000SankeyChart } from "./element/ui9000-sankey-chart.js";
+import { default as default2 } from "./metadata.json.js";
+import { MAX_SANKEY_LINKS, normalizeSankeyData } from "./lib/normalize.js";
+import { NODE_LABEL_MAX, formatCapitalizedWords, formatSankeyValue, truncateNodeLabel } from "./lib/format.js";
+import { buildColorRanges, generateBreakPoints, pickRangeColor } from "./lib/domain.js";
+import { renderSankeyChart } from "./render/draw.js";
+export {
+  MAX_SANKEY_LINKS,
+  NODE_LABEL_MAX,
+  Ui9000SankeyChart,
+  buildColorRanges,
+  formatCapitalizedWords,
+  formatSankeyValue,
+  generateBreakPoints,
+  normalizeSankeyData,
+  pickRangeColor,
+  registerSankeyChart,
+  renderSankeyChart,
+  default2 as sankeyChartMetadata,
+  truncateNodeLabel
+};
+//# sourceMappingURL=index.js.map

package/dist/components/sankey-chart/index.js.map

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

package/dist/components/sankey-chart/lib/domain.d.ts

@@ -0,0 +1,14 @@
+export interface SankeyColorRange {
+    color: string;
+    start: number;
+    end: number;
+}
+/** Mirrors client `generateBreakPoints` — quantile break points over the values. */
+export declare function generateBreakPoints(values: number[], numBreaks?: number): number[];
+/**
+ * Mirrors the client `generateColorRanges` effect: one range per palette step,
+ * the last one stretched to 3x so the largest link still finds a bucket.
+ */
+export declare function buildColorRanges(values: number[], colors: string[]): SankeyColorRange[];
+export declare function pickRangeColor(ranges: SankeyColorRange[], value: number, fallback: string): string;
+//# sourceMappingURL=domain.d.ts.map

package/dist/components/sankey-chart/lib/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../../src/components/sankey-chart/lib/domain.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,SAAI,GAAG,MAAM,EAAE,CAgB7E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,gBAAgB,EAAE,CAUpB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EAAE,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR"}

package/dist/components/sankey-chart/lib/domain.js

@@ -0,0 +1,34 @@
+function generateBreakPoints(values, numBreaks = 7) {
+  const sorted = values.filter((v) => Number.isFinite(v)).slice().sort((a, b) => a - b);
+  if (!sorted.length || numBreaks < 2) return [];
+  const breaks = [];
+  for (let i = 0; i < numBreaks; i++) {
+    const position = i / (numBreaks - 1) * (sorted.length - 1);
+    const lower = Math.max(0, Math.floor(position));
+    const upper = Math.min(sorted.length - 1, Math.ceil(position));
+    const weight = position - lower;
+    breaks.push(sorted[lower] * (1 - weight) + sorted[upper] * weight);
+  }
+  return breaks;
+}
+function buildColorRanges(values, colors) {
+  if (!colors.length) return [];
+  const unique = [...new Set(values.filter((v) => Number.isFinite(v)))];
+  const steps = generateBreakPoints(unique, colors.length);
+  return steps.map((step, i) => ({
+    color: colors[i],
+    start: Math.trunc(step),
+    end: Math.trunc(i === steps.length - 1 ? step * 3 : steps[i + 1])
+  }));
+}
+function pickRangeColor(ranges, value, fallback) {
+  if (!ranges.length) return fallback;
+  const hit = ranges.find((r) => r.start <= value && r.end >= value);
+  return (hit ?? ranges[ranges.length - 1]).color;
+}
+export {
+  buildColorRanges,
+  generateBreakPoints,
+  pickRangeColor
+};
+//# sourceMappingURL=domain.js.map

package/dist/components/sankey-chart/lib/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sources":["../../../../src/components/sankey-chart/lib/domain.ts"],"sourcesContent":["export interface SankeyColorRange {\n  color: string;\n  start: number;\n  end: number;\n}\n\n/** Mirrors client `generateBreakPoints` — quantile break points over the values. */\nexport function generateBreakPoints(values: number[], numBreaks = 7): number[] {\n  const sorted = values\n    .filter((v) => Number.isFinite(v))\n    .slice()\n    .sort((a, b) => a - b);\n  if (!sorted.length || numBreaks < 2) return [];\n\n  const breaks: number[] = [];\n  for (let i = 0; i < numBreaks; i++) {\n    const position = (i / (numBreaks - 1)) * (sorted.length - 1);\n    const lower = Math.max(0, Math.floor(position));\n    const upper = Math.min(sorted.length - 1, Math.ceil(position));\n    const weight = position - lower;\n    breaks.push(sorted[lower] * (1 - weight) + sorted[upper] * weight);\n  }\n  return breaks;\n}\n\n/**\n * Mirrors the client `generateColorRanges` effect: one range per palette step,\n * the last one stretched to 3x so the largest link still finds a bucket.\n */\nexport function buildColorRanges(\n  values: number[],\n  colors: string[],\n): SankeyColorRange[] {\n  if (!colors.length) return [];\n  const unique = [...new Set(values.filter((v) => Number.isFinite(v)))];\n  const steps = generateBreakPoints(unique, colors.length);\n\n  return steps.map((step, i) => ({\n    color: colors[i],\n    start: Math.trunc(step),\n    end: Math.trunc(i === steps.length - 1 ? step * 3 : steps[i + 1]),\n  }));\n}\n\nexport function pickRangeColor(\n  ranges: SankeyColorRange[],\n  value: number,\n  fallback: string,\n): string {\n  if (!ranges.length) return fallback;\n  const hit = ranges.find((r) => r.start <= value && r.end >= value);\n  return (hit ?? ranges[ranges.length - 1]).color;\n}\n"],"names":[],"mappings":"AAOO,SAAS,oBAAoB,QAAkB,YAAY,GAAa;AAC7E,QAAM,SAAS,OACZ,OAAO,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC,EAChC,QACA,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AACvB,MAAI,CAAC,OAAO,UAAU,YAAY,UAAU,CAAA;AAE5C,QAAM,SAAmB,CAAA;AACzB,WAAS,IAAI,GAAG,IAAI,WAAW,KAAK;AAClC,UAAM,WAAY,KAAK,YAAY,MAAO,OAAO,SAAS;AAC1D,UAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,CAAC;AAC9C,UAAM,QAAQ,KAAK,IAAI,OAAO,SAAS,GAAG,KAAK,KAAK,QAAQ,CAAC;AAC7D,UAAM,SAAS,WAAW;AAC1B,WAAO,KAAK,OAAO,KAAK,KAAK,IAAI,UAAU,OAAO,KAAK,IAAI,MAAM;AAAA,EACnE;AACA,SAAO;AACT;AAMO,SAAS,iBACd,QACA,QACoB;AACpB,MAAI,CAAC,OAAO,OAAQ,QAAO,CAAA;AAC3B,QAAM,SAAS,CAAC,GAAG,IAAI,IAAI,OAAO,OAAO,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;AACpE,QAAM,QAAQ,oBAAoB,QAAQ,OAAO,MAAM;AAEvD,SAAO,MAAM,IAAI,CAAC,MAAM,OAAO;AAAA,IAC7B,OAAO,OAAO,CAAC;AAAA,IACf,OAAO,KAAK,MAAM,IAAI;AAAA,IACtB,KAAK,KAAK,MAAM,MAAM,MAAM,SAAS,IAAI,OAAO,IAAI,MAAM,IAAI,CAAC,CAAC;AAAA,EAAA,EAChE;AACJ;AAEO,SAAS,eACd,QACA,OACA,UACQ;AACR,MAAI,CAAC,OAAO,OAAQ,QAAO;AAC3B,QAAM,MAAM,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,OAAO,KAAK;AACjE,UAAQ,OAAO,OAAO,OAAO,SAAS,CAAC,GAAG;AAC5C;"}

package/dist/components/sankey-chart/lib/format.d.ts

@@ -0,0 +1,8 @@
+/** Mirrors client `formatNumber` (Intl, up to 3 decimals). */
+export declare function formatSankeyValue(value: number): string;
+/** Mirrors client `formatCapitalizedWordsText`. */
+export declare function formatCapitalizedWords(text: string): string;
+/** FuseDash cuts node labels at 7 characters (and only then offers a tooltip). */
+export declare const NODE_LABEL_MAX = 7;
+export declare function truncateNodeLabel(text: string, max?: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/components/sankey-chart/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/components/sankey-chart/lib/format.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED,kFAAkF;AAClF,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAiB,GAAG,MAAM,CAE5E"}

package/dist/components/sankey-chart/lib/format.js

@@ -0,0 +1,20 @@
+function formatSankeyValue(value) {
+  if (!Number.isFinite(value)) return "";
+  return Intl.NumberFormat("en-US", { maximumFractionDigits: 3 }).format(value);
+}
+function formatCapitalizedWords(text) {
+  if (!text) return "";
+  if (!Number.isNaN(Number(text))) return text;
+  return text.replace(/[_-]/g, " ").split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+}
+const NODE_LABEL_MAX = 7;
+function truncateNodeLabel(text, max = NODE_LABEL_MAX) {
+  return text.length <= max ? text : `${text.slice(0, max)}...`;
+}
+export {
+  NODE_LABEL_MAX,
+  formatCapitalizedWords,
+  formatSankeyValue,
+  truncateNodeLabel
+};
+//# sourceMappingURL=format.js.map

package/dist/components/sankey-chart/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sources":["../../../../src/components/sankey-chart/lib/format.ts"],"sourcesContent":["/** Mirrors client `formatNumber` (Intl, up to 3 decimals). */\nexport function formatSankeyValue(value: number): string {\n  if (!Number.isFinite(value)) return '';\n  return Intl.NumberFormat('en-US', { maximumFractionDigits: 3 }).format(value);\n}\n\n/** Mirrors client `formatCapitalizedWordsText`. */\nexport function formatCapitalizedWords(text: string): string {\n  if (!text) return '';\n  if (!Number.isNaN(Number(text))) return text;\n  return text\n    .replace(/[_-]/g, ' ')\n    .split(' ')\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(' ');\n}\n\n/** FuseDash cuts node labels at 7 characters (and only then offers a tooltip). */\nexport const NODE_LABEL_MAX = 7;\n\nexport function truncateNodeLabel(text: string, max = NODE_LABEL_MAX): string {\n  return text.length <= max ? text : `${text.slice(0, max)}...`;\n}\n"],"names":[],"mappings":"AACO,SAAS,kBAAkB,OAAuB;AACvD,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO;AACpC,SAAO,KAAK,aAAa,SAAS,EAAE,uBAAuB,EAAA,CAAG,EAAE,OAAO,KAAK;AAC9E;AAGO,SAAS,uBAAuB,MAAsB;AAC3D,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,CAAC,OAAO,MAAM,OAAO,IAAI,CAAC,EAAG,QAAO;AACxC,SAAO,KACJ,QAAQ,SAAS,GAAG,EACpB,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAC,EAAE,YAAA,CAAa,EACxE,KAAK,GAAG;AACb;AAGO,MAAM,iBAAiB;AAEvB,SAAS,kBAAkB,MAAc,MAAM,gBAAwB;AAC5E,SAAO,KAAK,UAAU,MAAM,OAAO,GAAG,KAAK,MAAM,GAAG,GAAG,CAAC;AAC1D;"}

package/dist/components/sankey-chart/lib/index.d.ts

@@ -0,0 +1,5 @@
+export { type SankeyFusePayload, type SankeyGraphPayload, type SankeyInput, type SankeyLinkDatum, type SankeyModel, type SankeyNodeDatum, } from './types.js';
+export { MAX_SANKEY_LINKS, normalizeSankeyData } from './normalize.js';
+export { buildColorRanges, generateBreakPoints, pickRangeColor, type SankeyColorRange, } from './domain.js';
+export { NODE_LABEL_MAX, formatCapitalizedWords, formatSankeyValue, truncateNodeLabel, } from './format.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/sankey-chart/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/sankey-chart/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/components/sankey-chart/lib/normalize.d.ts

@@ -0,0 +1,9 @@
+import { SankeyInput, SankeyModel } from './types.js';
+/**
+ * Hard mark cap for chat: one ribbon per link, plus a label and a rule per
+ * node. Denser payloads keep their highest-value links.
+ */
+export declare const MAX_SANKEY_LINKS = 2000;
+/** Normalize FuseDash widget or chat payloads into a Sankey graph. */
+export declare function normalizeSankeyData(input: SankeyInput | null | undefined): SankeyModel;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/components/sankey-chart/lib/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/components/sankey-chart/lib/normalize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,WAAW,EAEX,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AA0LrC,sEAAsE;AACtE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACpC,WAAW,CAgBb"}

package/dist/components/sankey-chart/lib/normalize.js

@@ -0,0 +1,158 @@
+import { FD_SEQUENTIAL } from "../../../utils/fusedash-visual.js";
+const MAX_SANKEY_LINKS = 2e3;
+const EMPTY = {
+  nodes: [],
+  links: [],
+  sourceLabel: "",
+  targetLabel: "",
+  valueLabel: "",
+  colors: [...FD_SEQUENTIAL],
+  circular: false
+};
+function emptyModel(overrides = {}) {
+  return { ...EMPTY, colors: [...FD_SEQUENTIAL], ...overrides };
+}
+function firstKey(value) {
+  if (Array.isArray(value)) return typeof value[0] === "string" ? value[0] : "";
+  return typeof value === "string" ? value : "";
+}
+function capitalize(text) {
+  return text ? text.charAt(0).toUpperCase() + text.slice(1) : "";
+}
+function hasCycle(links) {
+  const adjacency = /* @__PURE__ */ new Map();
+  for (const link of links) {
+    let targets = adjacency.get(link.source);
+    if (!targets) {
+      targets = /* @__PURE__ */ new Set();
+      adjacency.set(link.source, targets);
+    }
+    targets.add(link.target);
+  }
+  const visited = /* @__PURE__ */ new Set();
+  const path = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    if (path.has(node)) return true;
+    if (visited.has(node)) return false;
+    visited.add(node);
+    path.add(node);
+    for (const next of adjacency.get(node) ?? []) {
+      if (walk(next)) return true;
+    }
+    path.delete(node);
+    return false;
+  };
+  for (const node of adjacency.keys()) {
+    if (!visited.has(node) && walk(node)) return true;
+  }
+  return false;
+}
+function buildModel(nodes, links, labels, colors) {
+  const known = new Set(nodes.map((n) => n.name));
+  let clean = links.filter(
+    (l) => known.has(l.source) && known.has(l.target) && l.source !== l.target && Number.isFinite(l.value)
+  );
+  if (clean.length > MAX_SANKEY_LINKS) {
+    clean = clean.slice().sort((a, b) => b.value - a.value).slice(0, MAX_SANKEY_LINKS);
+  }
+  if (!clean.length) return emptyModel({ ...labels, colors });
+  if (hasCycle(clean)) return emptyModel({ ...labels, colors, circular: true });
+  const used = /* @__PURE__ */ new Set();
+  for (const link of clean) {
+    used.add(link.source);
+    used.add(link.target);
+  }
+  return {
+    nodes: nodes.filter((n) => used.has(n.name)),
+    links: clean,
+    ...labels,
+    colors,
+    circular: false
+  };
+}
+function normalizeFuse(payload) {
+  var _a, _b, _c, _d, _e;
+  const rows = payload.data ?? [];
+  const details = payload.axisDetails ?? void 0;
+  const custom = ((_a = payload.palette) == null ? void 0 : _a.customColors) ?? void 0;
+  const colors = (custom == null ? void 0 : custom.length) ? custom.map((c) => c.hex) : [...FD_SEQUENTIAL];
+  const arrangeBy = payload.arrangeBy ?? [];
+  const sourceKey = firstKey(payload.xAxe) || arrangeBy[0] || "";
+  const valueKey = firstKey(payload.yAxe) || ((_b = payload.display) == null ? void 0 : _b[0]) || "";
+  let targetKey = firstKey(payload.groupBy) || arrangeBy[1] || "";
+  if (!targetKey) {
+    targetKey = Object.keys(rows[0] ?? {}).find(
+      (key) => key !== sourceKey && key !== valueKey
+    ) ?? "";
+  }
+  const labels = {
+    sourceLabel: ((_c = details == null ? void 0 : details[sourceKey]) == null ? void 0 : _c.label) || capitalize(sourceKey),
+    targetLabel: ((_d = details == null ? void 0 : details[targetKey]) == null ? void 0 : _d.label) || capitalize(targetKey),
+    valueLabel: ((_e = details == null ? void 0 : details[valueKey]) == null ? void 0 : _e.label) || capitalize(valueKey)
+  };
+  if (!rows.length || !sourceKey || !targetKey || !valueKey) {
+    return emptyModel({ ...labels, colors });
+  }
+  const sources = /* @__PURE__ */ new Set();
+  const targets = /* @__PURE__ */ new Set();
+  const links = [];
+  for (const row of rows) {
+    const source = String(row[sourceKey] ?? "");
+    const target = String(row[targetKey] ?? "").trim();
+    const value = Number(row[valueKey]);
+    if (!source || !target || !Number.isFinite(value)) continue;
+    sources.add(source);
+    targets.add(target);
+    links.push({ source: `${source} `, target, value });
+  }
+  const nodes = [
+    ...[...sources].sort().map((name) => ({ name: `${name} `, label: name })),
+    ...[...targets].sort().map((name) => ({ name, label: name }))
+  ];
+  return buildModel(nodes, links, labels, colors);
+}
+function normalizeGraph(payload) {
+  var _a;
+  const rawLinks = (payload.links ?? []).map((l) => ({
+    source: String(l.source ?? ""),
+    target: String(l.target ?? ""),
+    value: Number(l.value)
+  })).filter((l) => l.source && l.target);
+  const nodes = ((_a = payload.nodes) == null ? void 0 : _a.length) ? payload.nodes.map((n) => ({
+    name: String(n.name),
+    label: n.label ?? String(n.name)
+  })) : [
+    .../* @__PURE__ */ new Set([
+      ...rawLinks.map((l) => l.source),
+      ...rawLinks.map((l) => l.target)
+    ])
+  ].map((name) => ({ name, label: name }));
+  return buildModel(
+    nodes,
+    rawLinks,
+    {
+      sourceLabel: payload.sourceLabel ?? "",
+      targetLabel: payload.targetLabel ?? "",
+      valueLabel: payload.valueLabel ?? ""
+    },
+    [...FD_SEQUENTIAL]
+  );
+}
+function normalizeSankeyData(input) {
+  if (!input) return emptyModel();
+  if (Array.isArray(input)) {
+    return normalizeGraph({ links: input });
+  }
+  if ("links" in input && Array.isArray(input.links)) {
+    return normalizeGraph(input);
+  }
+  if ("data" in input && Array.isArray(input.data)) {
+    return normalizeFuse(input);
+  }
+  return emptyModel();
+}
+export {
+  MAX_SANKEY_LINKS,
+  normalizeSankeyData
+};
+//# sourceMappingURL=normalize.js.map

package/dist/components/sankey-chart/lib/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sources":["../../../../src/components/sankey-chart/lib/normalize.ts"],"sourcesContent":["import { FD_SEQUENTIAL } from '../../../utils/fusedash-visual.js';\n\nimport type {\n  SankeyFusePayload,\n  SankeyGraphPayload,\n  SankeyInput,\n  SankeyLinkDatum,\n  SankeyModel,\n  SankeyNodeDatum,\n} from './types.js';\n\n/**\n * Hard mark cap for chat: one ribbon per link, plus a label and a rule per\n * node. Denser payloads keep their highest-value links.\n */\nexport const MAX_SANKEY_LINKS = 2000;\n\nconst EMPTY: SankeyModel = {\n  nodes: [],\n  links: [],\n  sourceLabel: '',\n  targetLabel: '',\n  valueLabel: '',\n  colors: [...FD_SEQUENTIAL],\n  circular: false,\n};\n\nfunction emptyModel(overrides: Partial<SankeyModel> = {}): SankeyModel {\n  return { ...EMPTY, colors: [...FD_SEQUENTIAL], ...overrides };\n}\n\nfunction firstKey(value: string | string[] | null | undefined): string {\n  if (Array.isArray(value)) return typeof value[0] === 'string' ? value[0] : '';\n  return typeof value === 'string' ? value : '';\n}\n\nfunction capitalize(text: string): string {\n  return text ? text.charAt(0).toUpperCase() + text.slice(1) : '';\n}\n\n/** True when following source → target ever revisits a node on the same path. */\nfunction hasCycle(links: SankeyLinkDatum[]): boolean {\n  const adjacency = new Map<string, Set<string>>();\n  for (const link of links) {\n    let targets = adjacency.get(link.source);\n    if (!targets) {\n      targets = new Set();\n      adjacency.set(link.source, targets);\n    }\n    targets.add(link.target);\n  }\n\n  const visited = new Set<string>();\n  const path = new Set<string>();\n\n  const walk = (node: string): boolean => {\n    if (path.has(node)) return true;\n    if (visited.has(node)) return false;\n    visited.add(node);\n    path.add(node);\n    for (const next of adjacency.get(node) ?? []) {\n      if (walk(next)) return true;\n    }\n    path.delete(node);\n    return false;\n  };\n\n  for (const node of adjacency.keys()) {\n    if (!visited.has(node) && walk(node)) return true;\n  }\n  return false;\n}\n\nfunction buildModel(\n  nodes: SankeyNodeDatum[],\n  links: SankeyLinkDatum[],\n  labels: Pick<SankeyModel, 'sourceLabel' | 'targetLabel' | 'valueLabel'>,\n  colors: string[],\n): SankeyModel {\n  const known = new Set(nodes.map((n) => n.name));\n  let clean = links.filter(\n    (l) =>\n      known.has(l.source) &&\n      known.has(l.target) &&\n      l.source !== l.target &&\n      Number.isFinite(l.value),\n  );\n\n  if (clean.length > MAX_SANKEY_LINKS) {\n    clean = clean\n      .slice()\n      .sort((a, b) => b.value - a.value)\n      .slice(0, MAX_SANKEY_LINKS);\n  }\n\n  if (!clean.length) return emptyModel({ ...labels, colors });\n  if (hasCycle(clean)) return emptyModel({ ...labels, colors, circular: true });\n\n  const used = new Set<string>();\n  for (const link of clean) {\n    used.add(link.source);\n    used.add(link.target);\n  }\n\n  return {\n    nodes: nodes.filter((n) => used.has(n.name)),\n    links: clean,\n    ...labels,\n    colors,\n    circular: false,\n  };\n}\n\nfunction normalizeFuse(payload: SankeyFusePayload): SankeyModel {\n  const rows = payload.data ?? [];\n  const details = payload.axisDetails ?? undefined;\n  const custom = payload.palette?.customColors ?? undefined;\n  const colors = custom?.length\n    ? custom.map((c) => c.hex)\n    : [...FD_SEQUENTIAL];\n\n  // FuseDash reads xAxe/yAxe/groupBy; editor-built Sankeys keep the two\n  // dimensions in `arrangeBy` and the measure in `display`.\n  const arrangeBy = payload.arrangeBy ?? [];\n  const sourceKey = firstKey(payload.xAxe) || arrangeBy[0] || '';\n  const valueKey = firstKey(payload.yAxe) || payload.display?.[0] || '';\n  let targetKey = firstKey(payload.groupBy) || arrangeBy[1] || '';\n  if (!targetKey) {\n    targetKey =\n      Object.keys(rows[0] ?? {}).find(\n        (key) => key !== sourceKey && key !== valueKey,\n      ) ?? '';\n  }\n\n  const labels = {\n    sourceLabel: details?.[sourceKey]?.label || capitalize(sourceKey),\n    targetLabel: details?.[targetKey]?.label || capitalize(targetKey),\n    valueLabel: details?.[valueKey]?.label || capitalize(valueKey),\n  };\n\n  if (!rows.length || !sourceKey || !targetKey || !valueKey) {\n    return emptyModel({ ...labels, colors });\n  }\n\n  const sources = new Set<string>();\n  const targets = new Set<string>();\n  const links: SankeyLinkDatum[] = [];\n\n  for (const row of rows) {\n    const source = String(row[sourceKey] ?? '');\n    const target = String(row[targetKey] ?? '').trim();\n    const value = Number(row[valueKey]);\n    if (!source || !target || !Number.isFinite(value)) continue;\n    sources.add(source);\n    targets.add(target);\n    // Trailing space keeps a value that appears in both columns from\n    // becoming a self link (FuseDash).\n    links.push({ source: `${source} `, target, value });\n  }\n\n  const nodes: SankeyNodeDatum[] = [\n    ...[...sources].sort().map((name) => ({ name: `${name} `, label: name })),\n    ...[...targets].sort().map((name) => ({ name, label: name })),\n  ];\n\n  return buildModel(nodes, links, labels, colors);\n}\n\nfunction normalizeGraph(payload: SankeyGraphPayload): SankeyModel {\n  const rawLinks = (payload.links ?? [])\n    .map((l) => ({\n      source: String(l.source ?? ''),\n      target: String(l.target ?? ''),\n      value: Number(l.value),\n    }))\n    .filter((l) => l.source && l.target);\n\n  const nodes: SankeyNodeDatum[] = payload.nodes?.length\n    ? payload.nodes.map((n) => ({\n        name: String(n.name),\n        label: n.label ?? String(n.name),\n      }))\n    : [\n        ...new Set([\n          ...rawLinks.map((l) => l.source),\n          ...rawLinks.map((l) => l.target),\n        ]),\n      ].map((name) => ({ name, label: name }));\n\n  return buildModel(\n    nodes,\n    rawLinks,\n    {\n      sourceLabel: payload.sourceLabel ?? '',\n      targetLabel: payload.targetLabel ?? '',\n      valueLabel: payload.valueLabel ?? '',\n    },\n    [...FD_SEQUENTIAL],\n  );\n}\n\n/** Normalize FuseDash widget or chat payloads into a Sankey graph. */\nexport function normalizeSankeyData(\n  input: SankeyInput | null | undefined,\n): SankeyModel {\n  if (!input) return emptyModel();\n\n  if (Array.isArray(input)) {\n    return normalizeGraph({ links: input });\n  }\n\n  if ('links' in input && Array.isArray(input.links)) {\n    return normalizeGraph(input);\n  }\n\n  if ('data' in input && Array.isArray(input.data)) {\n    return normalizeFuse(input);\n  }\n\n  return emptyModel();\n}\n"],"names":[],"mappings":"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"}

package/dist/components/sankey-chart/lib/types.d.ts

@@ -0,0 +1,58 @@
+/** A node in one of the two Sankey columns. */
+export interface SankeyNodeDatum {
+    /**
+     * Layout id. Source ids keep a trailing space (FuseDash trick) so a value
+     * present in both columns can never resolve to a self link.
+     */
+    name: string;
+    /** Text drawn inside the node column. */
+    label: string;
+}
+export interface SankeyLinkDatum {
+    source: string;
+    target: string;
+    value: number;
+}
+export interface SankeyModel {
+    nodes: SankeyNodeDatum[];
+    links: SankeyLinkDatum[];
+    /** Header above the left column (source dimension). */
+    sourceLabel: string;
+    /** Header above the right column (target dimension). */
+    targetLabel: string;
+    /** Tooltip row label for the measure. */
+    valueLabel: string;
+    /** Sequential palette, low → high. */
+    colors: string[];
+    /** FuseDash refuses to lay out a cyclic graph. */
+    circular: boolean;
+}
+/** FuseDash widget payload (`WidgetItem`-shaped, chrome fields ignored). */
+export interface SankeyFusePayload {
+    data: Array<Record<string, unknown>>;
+    xAxe?: string | string[] | null;
+    yAxe?: string | string[] | null;
+    groupBy?: string | string[] | null;
+    /** Sankey widgets configured through the editor carry the two dimensions here. */
+    arrangeBy?: string[] | null;
+    /** …and the measure here. */
+    display?: string[] | null;
+    axisDetails?: Record<string, {
+        label?: string;
+    }> | null;
+    palette?: {
+        customColors?: Array<{
+            hex: string;
+        }> | null;
+    } | null;
+}
+/** Chat payload that already describes the graph. */
+export interface SankeyGraphPayload {
+    nodes?: SankeyNodeDatum[];
+    links: SankeyLinkDatum[];
+    sourceLabel?: string;
+    targetLabel?: string;
+    valueLabel?: string;
+}
+export type SankeyInput = SankeyLinkDatum[] | SankeyGraphPayload | SankeyFusePayload;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/sankey-chart/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/sankey-chart/lib/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GACnB,eAAe,EAAE,GACjB,kBAAkB,GAClB,iBAAiB,CAAC"}