@fusedashlabs/widgets 0.2.0

package/dist/utils/fuse-palette.js

@@ -0,0 +1,158 @@
+const QUALITATIVE_2 = ["#473DD9", "#36C4A5"];
+const QUALITATIVE_4 = [
+  "#473DD9",
+  "#36C4A5",
+  "#FF8C47",
+  "#56546D"
+];
+const QUALITATIVE_12 = [
+  "#473DD9",
+  "#938CFF",
+  "#36C4A5",
+  "#ADF4E5",
+  "#BDBCC8",
+  "#56546D",
+  "#FF8C47",
+  "#FFCEB0",
+  "#FF4781",
+  "#FFB0C9",
+  "#47B0FF",
+  "#B0DDFF"
+];
+const SEQUENTIAL_1 = [
+  "#D6D3FF",
+  "#B5B0FF",
+  "#938CFF",
+  "#7369FF",
+  "#5448FF",
+  "#473DD9",
+  "#3C33B5"
+];
+const PUNCHCARD_RADII = [5, 10, 14, 17, 20, 24, 26];
+const PUNCHCARD_MAX_BUBBLE_RADIUS = 30;
+const PUNCHCARD_MIN_BUBBLE_RADIUS = 8;
+const PUNCHCARD_MIN_LABEL_RADIUS = 16;
+const PUNCHCARD_BOTTOM_MARGIN = 21;
+const PUNCHCARD_LABEL_GUTTER_PAD = 10;
+function punchcardLeftGutter(categories, fontSize = 11) {
+  const longest = categories.reduce(
+    (max, c) => Math.max(max, String(c).length),
+    0
+  );
+  const chars = Math.max(longest, 3);
+  return Math.ceil(chars * fontSize * 0.6) + PUNCHCARD_LABEL_GUTTER_PAD + 8;
+}
+function punchcardLayoutMaxRadius(plotWidth, plotHeight, xCount, yCount) {
+  if (xCount <= 0 || yCount <= 0) return PUNCHCARD_MAX_BUBBLE_RADIUS;
+  const byX = plotWidth / xCount / 2;
+  const byY = plotHeight / yCount / 2;
+  return Math.min(PUNCHCARD_MAX_BUBBLE_RADIUS, byX, byY);
+}
+function pickQualitativePalette(formattingCount, seriesCount = 1) {
+  const n = formattingCount > 0 ? formattingCount : seriesCount;
+  if (n > 4) return QUALITATIVE_12;
+  if (n > 2) return QUALITATIVE_4;
+  return QUALITATIVE_2;
+}
+function resolveFormattingColor(formatting, key, seriesCount = 1) {
+  var _a;
+  const colors = (formatting == null ? void 0 : formatting.length) ? formatting : [{ key: "default", color: "1" }];
+  const palette = pickQualitativePalette(colors.length, seriesCount);
+  const entry = colors.find((item) => String(item.key) === String(key));
+  const raw = (entry == null ? void 0 : entry.color) ?? ((_a = colors[0]) == null ? void 0 : _a.color) ?? 1;
+  const colorIndex = Number(raw);
+  const idx = Number.isFinite(colorIndex) ? colorIndex : 1;
+  const direct = palette[idx - 1];
+  if (direct) return direct;
+  return palette[((idx - 1) % palette.length + palette.length) % palette.length];
+}
+function generateBreakPoints(values, numBreaks = 7) {
+  const sorted = values.map((v) => typeof v === "number" ? v : Number(v)).filter((v) => Number.isFinite(v)).slice().sort((a, b) => a - b);
+  if (!sorted.length || numBreaks < 2) return [];
+  const breakPoints = [];
+  for (let i = 0; i < numBreaks; i++) {
+    const quantilePosition = i / (numBreaks - 1) * (sorted.length - 1);
+    const lowerIndex = Math.max(0, Math.floor(quantilePosition));
+    const upperIndex = Math.min(sorted.length - 1, Math.ceil(quantilePosition));
+    const weight = quantilePosition - lowerIndex;
+    breakPoints.push(
+      sorted[lowerIndex] * (1 - weight) + sorted[upperIndex] * weight
+    );
+  }
+  return breakPoints;
+}
+function generatePunchcardColorRanges(values, variations = SEQUENTIAL_1) {
+  if (!variations.length || !values.length) return [];
+  const sortedValues = [...new Set(values.map(Math.abs))].sort((a, b) => a - b);
+  const steps = generateBreakPoints(sortedValues);
+  if (!steps.length) return [];
+  return steps.map((_step, i) => ({
+    color: variations[i] ?? variations[variations.length - 1] ?? "#473DD9",
+    radius: PUNCHCARD_RADII[i] ?? PUNCHCARD_RADII[PUNCHCARD_RADII.length - 1],
+    start: -Math.ceil(
+      i === steps.length - 1 ? sortedValues[sortedValues.length - 1] : steps[i + 1]
+    ) - 1,
+    end: Math.ceil(
+      i === steps.length - 1 ? sortedValues[sortedValues.length - 1] : steps[i + 1]
+    ) + 1
+  }));
+}
+function punchcardColorForValue(value, ranges) {
+  if (!ranges.length) return SEQUENTIAL_1[0];
+  if (!value) return ranges[0].color;
+  const range = ranges.find((r) => value >= r.start && value <= r.end);
+  return (range == null ? void 0 : range.color) ?? ranges[0].color;
+}
+function punchcardRadiusForValue(value, ranges) {
+  if (!ranges.length) return 5;
+  const abs = Math.abs(value);
+  const range = ranges.find((r) => abs >= r.start && abs <= r.end);
+  return (range == null ? void 0 : range.radius) ?? 5;
+}
+function generateBubbleColorRanges(values, ranges) {
+  if (!values.length) return [];
+  const absValues = [...new Set(values.map(Math.abs))].sort((a, b) => a - b);
+  const absCount = absValues.length;
+  const steps = (ranges == null ? void 0 : ranges.length) ? ranges : generateBreakPoints(absValues);
+  if (!steps.length) return [];
+  return steps.map((step, i) => ({
+    color: "transparent",
+    radius: PUNCHCARD_RADII[i] ?? PUNCHCARD_RADII[PUNCHCARD_RADII.length - 1],
+    start: step,
+    end: i === steps.length - 1 ? absCount > 0 ? absValues[absCount - 1] : 0 : steps[i + 1]
+  }));
+}
+const bubbleRadiusForValue = punchcardRadiusForValue;
+function punchcardScaledRadius(value, ranges, layoutMaxR) {
+  const raw = punchcardRadiusForValue(value, ranges);
+  const bandMax = Math.max(...ranges.map((r) => r.radius), PUNCHCARD_MIN_BUBBLE_RADIUS);
+  const scale = layoutMaxR / Math.max(bandMax, PUNCHCARD_MIN_BUBBLE_RADIUS);
+  return Math.max(
+    PUNCHCARD_MIN_BUBBLE_RADIUS,
+    Math.min(layoutMaxR, raw * Math.min(1, scale))
+  );
+}
+export {
+  PUNCHCARD_BOTTOM_MARGIN,
+  PUNCHCARD_LABEL_GUTTER_PAD,
+  PUNCHCARD_MAX_BUBBLE_RADIUS,
+  PUNCHCARD_MIN_BUBBLE_RADIUS,
+  PUNCHCARD_MIN_LABEL_RADIUS,
+  PUNCHCARD_RADII,
+  QUALITATIVE_12,
+  QUALITATIVE_2,
+  QUALITATIVE_4,
+  SEQUENTIAL_1,
+  bubbleRadiusForValue,
+  generateBreakPoints,
+  generateBubbleColorRanges,
+  generatePunchcardColorRanges,
+  pickQualitativePalette,
+  punchcardColorForValue,
+  punchcardLayoutMaxRadius,
+  punchcardLeftGutter,
+  punchcardRadiusForValue,
+  punchcardScaledRadius,
+  resolveFormattingColor
+};
+//# sourceMappingURL=fuse-palette.js.map

package/dist/utils/fuse-palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuse-palette.js","sources":["../../src/utils/fuse-palette.ts"],"sourcesContent":["/**\n * FuseDash palette resolution — mirrors\n * `client/.../getQualitativePalette` + `getCurrentColor` + SequentialColors1.\n */\n\nexport type FuseFormattingEntry = { key?: string; color?: string | number };\n\nexport const QUALITATIVE_2: string[] = ['#473DD9', '#36C4A5'];\n\nexport const QUALITATIVE_4: string[] = [\n  '#473DD9',\n  '#36C4A5',\n  '#FF8C47',\n  '#56546D',\n];\n\n/** Qualitative12Colors.default */\nexport const QUALITATIVE_12: string[] = [\n  '#473DD9',\n  '#938CFF',\n  '#36C4A5',\n  '#ADF4E5',\n  '#BDBCC8',\n  '#56546D',\n  '#FF8C47',\n  '#FFCEB0',\n  '#FF4781',\n  '#FFB0C9',\n  '#47B0FF',\n  '#B0DDFF',\n];\n\n/** SequentialColors1.default — punchcard magnitude bands */\nexport const SEQUENTIAL_1: string[] = [\n  '#D6D3FF',\n  '#B5B0FF',\n  '#938CFF',\n  '#7369FF',\n  '#5448FF',\n  '#473DD9',\n  '#3C33B5',\n];\n\n/** FuseDash punchcard discrete radii per color band */\nexport const PUNCHCARD_RADII = [5, 10, 14, 17, 20, 24, 26] as const;\n\n/** Client PunchcardChart bubble + frame tokens */\nexport const PUNCHCARD_MAX_BUBBLE_RADIUS = 30;\nexport const PUNCHCARD_MIN_BUBBLE_RADIUS = 8;\nexport const PUNCHCARD_MIN_LABEL_RADIUS = 16;\nexport const PUNCHCARD_BOTTOM_MARGIN = 21;\nexport const PUNCHCARD_LABEL_GUTTER_PAD = 10;\n\n/** Tight left gutter from longest Y category (years ≈ 40px, not fixed 80). */\nexport function punchcardLeftGutter(\n  categories: string[],\n  fontSize = 11,\n): number {\n  const longest = categories.reduce(\n    (max, c) => Math.max(max, String(c).length),\n    0,\n  );\n  const chars = Math.max(longest, 3);\n  return Math.ceil(chars * fontSize * 0.6) + PUNCHCARD_LABEL_GUTTER_PAD + 8;\n}\n\n/** @deprecated Use punchcardLeftGutter() */\nexport const PUNCHCARD_LEFT_MARGIN = 80;\n\n/** Max bubble radius that fits the plot without clipping (FuseDash range inset). */\nexport function punchcardLayoutMaxRadius(\n  plotWidth: number,\n  plotHeight: number,\n  xCount: number,\n  yCount: number,\n): number {\n  if (xCount <= 0 || yCount <= 0) return PUNCHCARD_MAX_BUBBLE_RADIUS;\n  const byX = plotWidth / xCount / 2;\n  const byY = plotHeight / yCount / 2;\n  return Math.min(PUNCHCARD_MAX_BUBBLE_RADIUS, byX, byY);\n}\n\n/**\n * Client rule: formatting.length ≤2 → Q2, 3–4 → Q4, >4 → Q12.\n * Falls back to seriesCount when formatting is empty.\n */\nexport function pickQualitativePalette(\n  formattingCount: number,\n  seriesCount = 1,\n): string[] {\n  const n = formattingCount > 0 ? formattingCount : seriesCount;\n  if (n > 4) return QUALITATIVE_12;\n  if (n > 2) return QUALITATIVE_4;\n  return QUALITATIVE_2;\n}\n\n/**\n * Resolve hex for a formatting key (group / category / \"default\").\n * Color indices are 1-based strings matching palette `key`.\n */\nexport function resolveFormattingColor(\n  formatting: FuseFormattingEntry[] | null | undefined,\n  key: string,\n  seriesCount = 1,\n): string {\n  const colors = formatting?.length\n    ? formatting\n    : [{ key: 'default', color: '1' }];\n  const palette = pickQualitativePalette(colors.length, seriesCount);\n  const entry = colors.find((item) => String(item.key) === String(key));\n  const raw = entry?.color ?? colors[0]?.color ?? 1;\n  const colorIndex = Number(raw);\n  const idx = Number.isFinite(colorIndex) ? colorIndex : 1;\n  // Client: find by key string first, else cycle (colorIndex - 1) % length\n  const direct = palette[idx - 1];\n  if (direct) return direct;\n  return palette[(((idx - 1) % palette.length) + palette.length) % palette.length];\n}\n\n/** Apply qualitative colors onto a list of series/group ids. */\nexport function colorMapForKeys(\n  keys: string[],\n  formatting?: FuseFormattingEntry[] | null,\n): Map<string, string> {\n  const map = new Map<string, string>();\n  for (const key of keys) {\n    map.set(key, resolveFormattingColor(formatting, key, keys.length));\n  }\n  return map;\n}\n\nexport type PunchcardColorRange = {\n  color: string;\n  radius: number;\n  start: number;\n  end: number;\n};\n\n/** Mirrors client `generateBreakPoints` (quantile ladder, default 7). */\nexport function generateBreakPoints(\n  values: number[],\n  numBreaks = 7,\n): number[] {\n  const sorted = values\n    .map((v) => (typeof v === 'number' ? v : Number(v)))\n    .filter((v) => Number.isFinite(v))\n    .slice()\n    .sort((a, b) => a - b);\n  if (!sorted.length || numBreaks < 2) return [];\n\n  const breakPoints: number[] = [];\n  for (let i = 0; i < numBreaks; i++) {\n    const quantilePosition = (i / (numBreaks - 1)) * (sorted.length - 1);\n    const lowerIndex = Math.max(0, Math.floor(quantilePosition));\n    const upperIndex = Math.min(sorted.length - 1, Math.ceil(quantilePosition));\n    const weight = quantilePosition - lowerIndex;\n    breakPoints.push(\n      sorted[lowerIndex] * (1 - weight) + sorted[upperIndex] * weight,\n    );\n  }\n  return breakPoints;\n}\n\n/** Mirrors client `generateColorRanges` for punchcard bubbles. */\nexport function generatePunchcardColorRanges(\n  values: number[],\n  variations: string[] = SEQUENTIAL_1,\n): PunchcardColorRange[] {\n  if (!variations.length || !values.length) return [];\n\n  const sortedValues = [...new Set(values.map(Math.abs))].sort((a, b) => a - b);\n  const steps = generateBreakPoints(sortedValues);\n  if (!steps.length) return [];\n\n  return steps.map((_step, i) => ({\n    color: variations[i] ?? variations[variations.length - 1] ?? '#473DD9',\n    radius: PUNCHCARD_RADII[i] ?? PUNCHCARD_RADII[PUNCHCARD_RADII.length - 1],\n    start:\n      -Math.ceil(\n        i === steps.length - 1\n          ? sortedValues[sortedValues.length - 1]\n          : steps[i + 1],\n      ) - 1,\n    end:\n      Math.ceil(\n        i === steps.length - 1\n          ? sortedValues[sortedValues.length - 1]\n          : steps[i + 1],\n      ) + 1,\n  }));\n}\n\nexport function punchcardColorForValue(\n  value: number,\n  ranges: PunchcardColorRange[],\n): string {\n  if (!ranges.length) return SEQUENTIAL_1[0];\n  if (!value) return ranges[0].color;\n  const range = ranges.find((r) => value >= r.start && value <= r.end);\n  return range?.color ?? ranges[0].color;\n}\n\nexport function punchcardRadiusForValue(\n  value: number,\n  ranges: PunchcardColorRange[],\n): number {\n  if (!ranges.length) return 5;\n  const abs = Math.abs(value);\n  const range = ranges.find((r) => abs >= r.start && abs <= r.end);\n  return range?.radius ?? 5;\n}\n\n/** Mirrors client BubbleChart `generateColorRanges` — transparent bands, radius-only. */\nexport function generateBubbleColorRanges(\n  values: number[],\n  ranges?: number[] | null,\n): PunchcardColorRange[] {\n  if (!values.length) return [];\n\n  const absValues = [...new Set(values.map(Math.abs))].sort((a, b) => a - b);\n  const absCount = absValues.length;\n  const steps = ranges?.length ? ranges : generateBreakPoints(absValues);\n  if (!steps.length) return [];\n\n  return steps.map((step, i) => ({\n    color: 'transparent',\n    radius: PUNCHCARD_RADII[i] ?? PUNCHCARD_RADII[PUNCHCARD_RADII.length - 1],\n    start: step,\n    end:\n      i === steps.length - 1\n        ? absCount > 0\n          ? absValues[absCount - 1]\n          : 0\n        : steps[i + 1],\n  }));\n}\n\n/** Alias — bubble radii use the same abs(y) band lookup as punchcard. */\nexport const bubbleRadiusForValue = punchcardRadiusForValue;\n\n/** Scale discrete band radii when plot is shorter than FuseDash default height. */\nexport function punchcardScaledRadius(\n  value: number,\n  ranges: PunchcardColorRange[],\n  layoutMaxR: number,\n): number {\n  const raw = punchcardRadiusForValue(value, ranges);\n  const bandMax = Math.max(...ranges.map((r) => r.radius), PUNCHCARD_MIN_BUBBLE_RADIUS);\n  const scale = layoutMaxR / Math.max(bandMax, PUNCHCARD_MIN_BUBBLE_RADIUS);\n  return Math.max(\n    PUNCHCARD_MIN_BUBBLE_RADIUS,\n    Math.min(layoutMaxR, raw * Math.min(1, scale)),\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/utils/fuse-widget.d.ts

@@ -0,0 +1,38 @@
+import { FuseFormattingEntry } from './fuse-palette.js';
+export type FuseWidgetLike = {
+    chartType?: string;
+    stacked?: boolean;
+    xAxe?: string | string[] | null;
+    yAxe?: string | string[] | null;
+    groupBy?: string | string[] | null;
+    uniqueValues?: Record<string, string[]> | null;
+    orientation?: string | null;
+    formatting?: FuseFormattingEntry[] | null;
+    markers?: Array<{
+        key?: string;
+        shape?: string;
+    }> | null;
+    axisDetails?: Record<string, {
+        label?: string;
+        measure_unit_symbol?: string;
+    }> | null;
+    data?: unknown;
+};
+export declare function firstField(value: string | string[] | null | undefined): string | undefined;
+/** True when payload looks like a FuseDash widget (`data` rows + axes). */
+export declare function isFuseWidgetPayload(input: unknown): input is FuseWidgetLike;
+/**
+ * Categorical key for punchcard Y / grouping — mirrors client PunchcardChart:
+ * `groupBy?.[0] ?? Object.keys(uniqueValues)[0]`.
+ */
+export declare function resolveGroupByKey(widget: FuseWidgetLike): string | undefined;
+export declare function rowsOf(widget: FuseWidgetLike): Record<string, unknown>[];
+export declare function filterTruthyValues(values: string[]): string[];
+/**
+ * Order categorical keys by FuseDash `uniqueValues[fieldKey]`, keeping any
+ * extra data keys at the end in first-seen order.
+ */
+export declare function resolveUniqueValuesOrder(dataKeys: Iterable<string>, uniqueValues: Record<string, string[]> | null | undefined, fieldKey: string | undefined): string[];
+/** Categorical x-axis order from a FuseDash widget mock. */
+export declare function xDomainHintFromWidget(widget: FuseWidgetLike): string[] | undefined;
+//# sourceMappingURL=fuse-widget.d.ts.map

package/dist/utils/fuse-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuse-widget.d.ts","sourceRoot":"","sources":["../../src/utils/fuse-widget.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,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,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IACtF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,GAAG,SAAS,CAOpB;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAI3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAK5E;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAKxE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI7D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EACzD,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,EAAE,CAsBV;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,GACrB,MAAM,EAAE,GAAG,SAAS,CAItB"}

package/dist/utils/fuse-widget.js

@@ -0,0 +1,67 @@
+function firstField(value) {
+  if (Array.isArray(value)) {
+    const v = value[0];
+    return v != null && String(v) !== "" ? String(v) : void 0;
+  }
+  if (value == null || value === "") return void 0;
+  return String(value);
+}
+function isFuseWidgetPayload(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return false;
+  const o = input;
+  return Array.isArray(o.data);
+}
+function resolveGroupByKey(widget) {
+  const fromGroup = firstField(widget.groupBy ?? void 0);
+  if (fromGroup) return fromGroup;
+  const keys = widget.uniqueValues ? Object.keys(widget.uniqueValues) : [];
+  return keys[0];
+}
+function rowsOf(widget) {
+  if (!Array.isArray(widget.data)) return [];
+  return widget.data.filter(
+    (r) => !!r && typeof r === "object" && !Array.isArray(r)
+  );
+}
+function filterTruthyValues(values) {
+  return values.filter(
+    (v) => v != null && v !== "" && v !== "null" && v !== "undefined"
+  );
+}
+function resolveUniqueValuesOrder(dataKeys, uniqueValues, fieldKey) {
+  var _a;
+  const dataSet = new Set(dataKeys);
+  const fromUv = fieldKey && ((_a = uniqueValues == null ? void 0 : uniqueValues[fieldKey]) == null ? void 0 : _a.length) ? filterTruthyValues(uniqueValues[fieldKey].map(String)) : null;
+  if (fromUv == null ? void 0 : fromUv.length) {
+    const ordered = fromUv.filter((k) => dataSet.has(k));
+    for (const k of dataSet) {
+      if (!ordered.includes(k)) ordered.push(k);
+    }
+    return ordered;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const k of dataKeys) {
+    if (!seen.has(k)) {
+      seen.add(k);
+      out.push(k);
+    }
+  }
+  return out;
+}
+function xDomainHintFromWidget(widget) {
+  var _a, _b;
+  const xKey = firstField(widget.xAxe ?? void 0);
+  if (!xKey || !((_b = (_a = widget.uniqueValues) == null ? void 0 : _a[xKey]) == null ? void 0 : _b.length)) return void 0;
+  return filterTruthyValues(widget.uniqueValues[xKey].map(String));
+}
+export {
+  filterTruthyValues,
+  firstField,
+  isFuseWidgetPayload,
+  resolveGroupByKey,
+  resolveUniqueValuesOrder,
+  rowsOf,
+  xDomainHintFromWidget
+};
+//# sourceMappingURL=fuse-widget.js.map

package/dist/utils/fuse-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuse-widget.js","sources":["../../src/utils/fuse-widget.ts"],"sourcesContent":["/**\n * Shared helpers for FuseDash WidgetItem-shaped payloads from\n * `client/apps/charts/src/app/constants/default*.ts`.\n */\n\nimport type { FuseFormattingEntry } from './fuse-palette.js';\n\nexport type FuseWidgetLike = {\n  chartType?: string;\n  stacked?: boolean;\n  xAxe?: string | string[] | null;\n  yAxe?: string | string[] | null;\n  groupBy?: string | string[] | null;\n  uniqueValues?: Record<string, string[]> | null;\n  orientation?: string | null;\n  formatting?: FuseFormattingEntry[] | null;\n  markers?: Array<{ key?: string; shape?: string }> | null;\n  axisDetails?: Record<string, { label?: string; measure_unit_symbol?: string }> | null;\n  data?: unknown;\n};\n\nexport function firstField(\n  value: string | string[] | null | undefined,\n): string | undefined {\n  if (Array.isArray(value)) {\n    const v = value[0];\n    return v != null && String(v) !== '' ? String(v) : undefined;\n  }\n  if (value == null || value === '') return undefined;\n  return String(value);\n}\n\n/** True when payload looks like a FuseDash widget (`data` rows + axes). */\nexport function isFuseWidgetPayload(input: unknown): input is FuseWidgetLike {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) return false;\n  const o = input as FuseWidgetLike;\n  return Array.isArray(o.data);\n}\n\n/**\n * Categorical key for punchcard Y / grouping — mirrors client PunchcardChart:\n * `groupBy?.[0] ?? Object.keys(uniqueValues)[0]`.\n */\nexport function resolveGroupByKey(widget: FuseWidgetLike): string | undefined {\n  const fromGroup = firstField(widget.groupBy ?? undefined);\n  if (fromGroup) return fromGroup;\n  const keys = widget.uniqueValues ? Object.keys(widget.uniqueValues) : [];\n  return keys[0];\n}\n\nexport function rowsOf(widget: FuseWidgetLike): Record<string, unknown>[] {\n  if (!Array.isArray(widget.data)) return [];\n  return widget.data.filter(\n    (r): r is Record<string, unknown> => !!r && typeof r === 'object' && !Array.isArray(r),\n  );\n}\n\nexport function filterTruthyValues(values: string[]): string[] {\n  return values.filter(\n    (v) => v != null && v !== '' && v !== 'null' && v !== 'undefined',\n  );\n}\n\n/**\n * Order categorical keys by FuseDash `uniqueValues[fieldKey]`, keeping any\n * extra data keys at the end in first-seen order.\n */\nexport function resolveUniqueValuesOrder(\n  dataKeys: Iterable<string>,\n  uniqueValues: Record<string, string[]> | null | undefined,\n  fieldKey: string | undefined,\n): string[] {\n  const dataSet = new Set(dataKeys);\n  const fromUv =\n    fieldKey && uniqueValues?.[fieldKey]?.length\n      ? filterTruthyValues(uniqueValues[fieldKey].map(String))\n      : null;\n  if (fromUv?.length) {\n    const ordered = fromUv.filter((k) => dataSet.has(k));\n    for (const k of dataSet) {\n      if (!ordered.includes(k)) ordered.push(k);\n    }\n    return ordered;\n  }\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const k of dataKeys) {\n    if (!seen.has(k)) {\n      seen.add(k);\n      out.push(k);\n    }\n  }\n  return out;\n}\n\n/** Categorical x-axis order from a FuseDash widget mock. */\nexport function xDomainHintFromWidget(\n  widget: FuseWidgetLike,\n): string[] | undefined {\n  const xKey = firstField(widget.xAxe ?? undefined);\n  if (!xKey || !widget.uniqueValues?.[xKey]?.length) return undefined;\n  return filterTruthyValues(widget.uniqueValues[xKey].map(String));\n}\n"],"names":[],"mappings":"AAqBO,SAAS,WACd,OACoB;AACpB,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,UAAM,IAAI,MAAM,CAAC;AACjB,WAAO,KAAK,QAAQ,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI;AAAA,EACrD;AACA,MAAI,SAAS,QAAQ,UAAU,GAAI,QAAO;AAC1C,SAAO,OAAO,KAAK;AACrB;AAGO,SAAS,oBAAoB,OAAyC;AAC3E,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,QAAM,IAAI;AACV,SAAO,MAAM,QAAQ,EAAE,IAAI;AAC7B;AAMO,SAAS,kBAAkB,QAA4C;AAC5E,QAAM,YAAY,WAAW,OAAO,WAAW,MAAS;AACxD,MAAI,UAAW,QAAO;AACtB,QAAM,OAAO,OAAO,eAAe,OAAO,KAAK,OAAO,YAAY,IAAI,CAAA;AACtE,SAAO,KAAK,CAAC;AACf;AAEO,SAAS,OAAO,QAAmD;AACxE,MAAI,CAAC,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAA;AACxC,SAAO,OAAO,KAAK;AAAA,IACjB,CAAC,MAAoC,CAAC,CAAC,KAAK,OAAO,MAAM,YAAY,CAAC,MAAM,QAAQ,CAAC;AAAA,EAAA;AAEzF;AAEO,SAAS,mBAAmB,QAA4B;AAC7D,SAAO,OAAO;AAAA,IACZ,CAAC,MAAM,KAAK,QAAQ,MAAM,MAAM,MAAM,UAAU,MAAM;AAAA,EAAA;AAE1D;AAMO,SAAS,yBACd,UACA,cACA,UACU;AAlDL;AAmDL,QAAM,UAAU,IAAI,IAAI,QAAQ;AAChC,QAAM,SACJ,cAAY,kDAAe,cAAf,mBAA0B,UAClC,mBAAmB,aAAa,QAAQ,EAAE,IAAI,MAAM,CAAC,IACrD;AACN,MAAI,iCAAQ,QAAQ;AAClB,UAAM,UAAU,OAAO,OAAO,CAAC,MAAM,QAAQ,IAAI,CAAC,CAAC;AACnD,eAAW,KAAK,SAAS;AACvB,UAAI,CAAC,QAAQ,SAAS,CAAC,EAAG,SAAQ,KAAK,CAAC;AAAA,IAC1C;AACA,WAAO;AAAA,EACT;AACA,QAAM,2BAAW,IAAA;AACjB,QAAM,MAAgB,CAAA;AACtB,aAAW,KAAK,UAAU;AACxB,QAAI,CAAC,KAAK,IAAI,CAAC,GAAG;AAChB,WAAK,IAAI,CAAC;AACV,UAAI,KAAK,CAAC;AAAA,IACZ;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,sBACd,QACsB;AA7EjB;AA8EL,QAAM,OAAO,WAAW,OAAO,QAAQ,MAAS;AAChD,MAAI,CAAC,QAAQ,GAAC,kBAAO,iBAAP,mBAAsB,UAAtB,mBAA6B,QAAQ,QAAO;AAC1D,SAAO,mBAAmB,OAAO,aAAa,IAAI,EAAE,IAAI,MAAM,CAAC;AACjE;"}

package/dist/utils/fusedash-visual.d.ts

@@ -0,0 +1,335 @@
+import { Selection } from 'd3-selection';
+/** FuseDash Widgets visual tokens — keep charts looking 1:1 with client. */
+export declare const FD: {
+    readonly gridStroke: "#afb3bb";
+    readonly gridDash: "1 2";
+    readonly axisLabelFill: "#6c7584";
+    readonly axisLabelSize: 11;
+    readonly axisStroke: "#afb3bb";
+    readonly hoverGuideLight: "#6c7584";
+    readonly hoverGuideDark: "#ffffff";
+    /**
+     * Qualitative12Colors.default — used when series count unknown.
+     * Prefer `resolveFormattingColor` / `pickQualitativePalette` for FuseDash widgets.
+     */
+    readonly series: readonly ["#473DD9", "#938CFF", "#36C4A5", "#ADF4E5", "#BDBCC8", "#56546D", "#FF8C47", "#FFCEB0", "#FF4781", "#FFB0C9", "#47B0FF", "#B0DDFF"];
+    readonly lineMargin: {
+        readonly top: 10;
+        readonly right: 1;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    readonly lollipopMargin: {
+        readonly top: 10;
+        readonly right: 3;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    /** FuseDash RadarChart (useNewDesign) frame */
+    readonly radarMargin: {
+        readonly top: 25;
+        readonly right: 5;
+        readonly bottom: 25;
+        readonly left: 5;
+    };
+    readonly radarScaleSteps: 5;
+    readonly radarDomainPadFactor: 1.1;
+    readonly radarMarkerSize: 50;
+    readonly radarMarkerHoverSize: 70;
+    readonly radarSpokeDash: "2,2";
+    readonly radarCapRadius: 3;
+    readonly radarLabelOffset: 12;
+    readonly radarGradientEdgeOpacity: 0.3;
+    readonly radarStrokeWidth: 2;
+    readonly radarTickLabelFill: "#f1f4f7";
+    /** Client PunchcardChart DEFAULT_MARGIN */
+    readonly punchcardMargin: {
+        readonly top: 0;
+        readonly right: 0;
+        readonly bottom: 21;
+        readonly left: 80;
+    };
+    readonly stepLineMargin: {
+        readonly top: 10;
+        readonly right: 1;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    /** SparkLineChart — same frame as StepLineChart */
+    readonly sparkLineMargin: {
+        readonly top: 10;
+        readonly right: 1;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    readonly sparkLineStrokeWidth: 1.5;
+    readonly sparkDomainPadFactor: 1.2;
+    readonly sparkGuideDash: "5,2";
+    readonly sparkHoverDotRadius: 4;
+    readonly boxPlotMargin: {
+        readonly top: 10;
+        readonly right: 1;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    readonly histogramMargin: {
+        readonly top: 10;
+        readonly right: 1;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    /** Client VerticalWaterfallChart margin */
+    readonly waterfallVerticalMargin: {
+        readonly top: 10;
+        readonly right: 0;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    /** Client HorizontalWaterfallChart base margin (left is sized from labels) */
+    readonly waterfallHorizontalMargin: {
+        readonly top: 10;
+        readonly right: 1;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    readonly waterfallBarThickness: 16;
+    readonly waterfallBarRadius: 2;
+    readonly waterfallArrow: 5;
+    readonly waterfallDomainPadFactor: 1.2;
+    /** Client hard-coded fills (formatting keys are ignored for paint) */
+    readonly waterfallPositive: "#938CFF";
+    readonly waterfallNegative: "#FF8C47";
+    readonly waterfallTotal: "#BDBCC8";
+    readonly waterfallHoverDim: 0.2;
+    readonly waterfallMinBand: 32;
+    /** Client VerticalViolinChart DEFAULT_MARGIN */
+    readonly violinVerticalMargin: {
+        readonly top: 10;
+        readonly right: 16;
+        readonly bottom: 28;
+        readonly left: 44;
+    };
+    /** Client HorizontalViolinChart DEFAULT_MARGIN */
+    readonly violinHorizontalMargin: {
+        readonly top: 10;
+        readonly right: 24;
+        readonly bottom: 28;
+        readonly left: 44;
+    };
+    /** Client Horizontal/Vertical BoxPlot */
+    readonly boxPlotDomainPadFactor: 1.1;
+    readonly boxPlotBorderRadius: 2;
+    readonly lineStrokeWidth: 2;
+    readonly lineStrokeAlphaPct: 80;
+    /** FuseDash AreaChart linearGradient stops (new design) */
+    readonly areaGradientTopOpacity: 0.6;
+    readonly areaGradientBottomOpacity: 0.1;
+    readonly lollipopStemWidth: 3;
+    readonly lollipopStemAlphaPct: 50;
+    readonly markerRadius: 4;
+    /** StepLineChart: plain stroke, no alpha / glow / markers */
+    readonly stepStrokeWidth: 1.5;
+    /** StepLineChart y-domain is padded by 1.2x before `.nice()` */
+    readonly stepDomainPadFactor: 1.2;
+    /** KS-plot "Ideal" overlay */
+    readonly stepIdealColor: "#2ecc71";
+    readonly stepIdealWidth: 3;
+    /** ROC "Random guessing" diagonal */
+    readonly stepGuessWidth: 2;
+    readonly stepGuessDash: "5,5";
+    /** Max-deviation marker (KS distance) */
+    readonly stepDeviationFill: "#2c2d33";
+    /** Tooltip crosshair on the step chart */
+    readonly stepGuideDash: "5,2";
+    readonly stepHoverDotRadius: 4;
+    /** Barchart — shared frame + bar geometry (all six FuseDash variants) */
+    readonly barMargin: {
+        readonly top: 10;
+        readonly right: 1;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    readonly barCornerRadius: 4;
+    /** Bar fill is a gradient from the series color to a faded stop */
+    readonly barFadeOpacity: 0.6;
+    readonly barFadeOpacityHovered: 0.7;
+    /** Vertical single-series: bandwidth * 0.4, capped, with a visible floor */
+    readonly barBandFraction: 0.4;
+    readonly barMaxWidth: 40;
+    readonly barMinHeight: 6;
+    /** Vertical grouped: floor(clamp(plotWidth / categories / series)) + 1px gap */
+    readonly barGroupMinWidth: 4;
+    readonly barGroupMaxWidth: 24;
+    readonly barGroupGap: 1;
+    /** Vertical stacked: bandwidth * 0.85, same clamp as grouped */
+    readonly barStackedBandFraction: 0.85;
+    /** Horizontal: fixed row thickness, gutter, and a floor for tiny values */
+    readonly barRowThickness: 24;
+    readonly barRowSpacing: 16;
+    readonly barMinWidth: 6;
+    /** Y (vertical) / X (horizontal) domain headroom */
+    readonly barDomainPadFactor: 1.2;
+    readonly barHorizontalPadFactor: 1.1;
+    /** Stacked totals get a flat 10% pad instead */
+    readonly barStackedPadFraction: 0.1;
+    /** Cumulative overlay line (FuseDash `cumulativeLine`) */
+    readonly barCumulativeColor: "#6d6df7";
+    readonly barCumulativeWidth: 2;
+    readonly barCumulativeDotRadius: 3;
+    /** Hovered category column: animated dot pattern + solid guide */
+    readonly barHoverDotFill: "#CFD2D6";
+    readonly barHoverGuideWidth: 2;
+    /** Client `calculatedLeftMargin` (unused in chat — shared LEFT_GUTTER_MARGIN) */
+    readonly barLabelCharWidth: 5;
+    readonly barLabelGutter: 28;
+    readonly barLabelGutterMin: 56;
+    readonly barLabelGutterMax: 180;
+    /** DonutGroupChart — a row of gauges, each with a KPI block in the hole */
+    readonly donutMargin: {
+        readonly top: 10;
+        readonly right: 8;
+        readonly bottom: 10;
+        readonly left: 8;
+    };
+    /** FuseDash uses a flat 16px band; it is capped at half the radius here */
+    readonly donutThickness: 16;
+    readonly donutMinThickness: 4;
+    readonly donutCellPadding: 6;
+    readonly donutMinCellWidth: 140;
+    /** Gauges assume a 0–100 scale when the row carries no `maximalValue` */
+    readonly donutDefaultMax: 100;
+    /** Resting / dimmed / hovered arc opacity (FuseDash settles on 0.8) */
+    readonly donutArcOpacity: 0.8;
+    readonly donutArcOpacityDimmed: 0.2;
+    /** PieChart — FuseDash uses zero margin; pie is a square inscribed in the body */
+    readonly pieMargin: {
+        readonly top: 0;
+        readonly right: 0;
+        readonly bottom: 0;
+        readonly left: 0;
+    };
+    readonly pieMinArcLengthPx: 5;
+    /** ScatterPlot — FuseDash DEFAULT_MARGIN */
+    readonly scatterMargin: {
+        readonly top: 10;
+        readonly right: 5;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    /** AreaGroupedBarChart — client DEFAULT_MARGIN */
+    readonly areaGroupedBarMargin: {
+        readonly top: 10;
+        readonly right: 5;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    /** Area fill under the line (client stopOpacity 0.35 → 0) */
+    readonly areaGroupedBarGradientTopOpacity: 0.35;
+    readonly areaGroupedBarGradientBottomOpacity: 0;
+    readonly areaGroupedBarMarkerRadius: 3;
+    readonly areaGroupedBarDimOpacity: 0.3;
+    readonly areaGroupedBarBarOpacity: 0.85;
+    /** BubbleChart — BASE_MARGIN + MAX_BUBBLE_RADIUS/2 inset on top/right */
+    readonly bubbleBaseMargin: {
+        readonly top: 10;
+        readonly right: 1;
+        readonly bottom: 21;
+        readonly left: 40;
+    };
+    readonly bubbleMaxRadius: 30;
+    readonly bubbleNegativeFill: "#DADAE1";
+    readonly scatterMarkerSize: 40;
+    readonly scatterReferenceLine: "#56546D";
+    readonly donutSliceStroke: "#ffffff";
+    readonly donutSliceStrokeDark: "#1a1b1f";
+    readonly donutSliceStrokeWidth: 2;
+    /** Unfilled part of a gauge — the neutral background FuseDash falls back to */
+    readonly donutTrackFill: "#EAECF0";
+    readonly donutTrackFillDark: "#2C2D33";
+    /** Divider between donuts (FuseDash `border-left: neutralBorderWeakest`) */
+    readonly donutDivider: "#E4E6EA";
+    readonly donutDividerDark: "#2C2D33";
+    /** KPI block in the hole: 30/12/12px, sized down with the ring */
+    readonly donutValueSize: 30;
+    readonly donutValueWeight: 600;
+    readonly donutBadgeSize: 12;
+    readonly donutLabelSize: 12;
+    readonly donutStatusColors: {
+        readonly positive: {
+            readonly background: "#E6F6EF";
+            readonly text: "#067647";
+        };
+        readonly negative: {
+            readonly background: "#FEE4E2";
+            readonly text: "#B42318";
+        };
+        readonly neutral: {
+            readonly background: "#F2F4F7";
+            readonly text: "#475467";
+        };
+    };
+    readonly donutStatusColorsDark: {
+        readonly positive: {
+            readonly background: "#0C2C21";
+            readonly text: "#4ED8A6";
+        };
+        readonly negative: {
+            readonly background: "#3B1513";
+            readonly text: "#F5817A";
+        };
+        readonly neutral: {
+            readonly background: "#2C2D33";
+            readonly text: "#C3C7CE";
+        };
+    };
+    /** Sankey: layout extent inset, node gap, and the two node-rule colors */
+    readonly sankeyPadding: 4.5;
+    readonly sankeyNodePadding: 14;
+    readonly sankeyNodeWidth: 70;
+    readonly sankeyNodeWidthSmall: 65;
+    readonly sankeyNodeRule: "#D3DBE3";
+    readonly sankeyNodeRuleActive: "#939BA7";
+    /** Ribbons sit at 50% alpha until hovered or focused */
+    readonly sankeyLinkAlphaPct: 50;
+    readonly sankeyLinkInset: 3;
+    readonly sankeyDimOpacity: 0.5;
+};
+/** SequentialColors1 for the `default` styleId — low → high. */
+export declare const FD_SEQUENTIAL: readonly ["#D6D3FF", "#B5B0FF", "#938CFF", "#7369FF", "#5448FF", "#473DD9", "#3C33B5"];
+export type MarkerShape = 'donut' | 'circle' | 'square' | 'rhombus' | 'triangle' | 'disabled';
+/** Mirrors client `lightenColor` — blend hex toward white (amount 0–1). */
+export declare function lightenColor(hex: string, amount: number): string;
+/** Mirrors client `hexToHexWithAlpha` (opacity 0–100). */
+export declare function hexWithAlpha(hex: string, opacityPct: number): string;
+/** Mirrors client `calculateScaleLinearDomain`. */
+export declare function calculateScaleLinearDomain(data: number[]): [number, number];
+/** Mirrors client Y-tick formatting. */
+export declare function formatCompactNumber(value: number, decimals?: number): string;
+export declare function seriesColor(index: number, override?: string): string;
+/** Line markers: donut = hollow ring (FuseDash default). */
+export declare function markerAppearance(shape: MarkerShape, color: string, themeMode?: 'light' | 'dark'): {
+    fill: string;
+    stroke: string;
+};
+export declare function appendGlowFilter(svg: Selection<SVGSVGElement, unknown, null, undefined>, id?: string): string;
+export declare function calculateNumTicks(height: number): number;
+/** Append FuseDash-style line/area marker at (cx, cy). */
+export declare function appendLineMarker(parent: Selection<any, any, any, any>, opts: {
+    shape: MarkerShape;
+    color: string;
+    cx: number;
+    cy: number;
+    r?: number;
+    themeMode?: 'light' | 'dark';
+    hovered?: boolean;
+}): void;
+/**
+ * Lollipop head — FuseDash Vertical markers (default = rhombus diamond path).
+ */
+export declare function appendLollipopMarkerVertical(parent: Selection<any, any, any, any>, opts: {
+    shape: MarkerShape;
+    color: string;
+    cx: number;
+    cy: number;
+}): void;
+//# sourceMappingURL=fusedash-visual.d.ts.map

package/dist/utils/fusedash-visual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusedash-visual.d.ts","sourceRoot":"","sources":["../../src/utils/fusedash-visual.ts"],"names":[],"mappings":"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"}