@carto/ps-react-ui 4.4.2 → 4.4.3

package/dist/download-config-Dqu78h2a.js

@@ -0,0 +1,57 @@
+import "react/jsx-runtime";
+import "react/compiler-runtime";
+import "@mui/material";
+import "./widget-store-CzDt8oSK.js";
+import "@mui/icons-material";
+import "zustand/shallow";
+import "react";
+import "react-markdown";
+import { d as n, a as s } from "./exports-Cr43OCul.js";
+import "./lasso-tool-BYbxrJ-7.js";
+import "./cjs-D4KH3azB.js";
+import "@dnd-kit/core";
+import "@dnd-kit/sortable";
+import "@dnd-kit/utilities";
+function T(r) {
+  const o = [];
+  if (r.length > 0 && (r[0]?.length ?? 0) > 0) {
+    const i = r?.[0]?.[0] ?? {}, t = Object.keys(i);
+    o.push(t);
+  }
+  return r.forEach((i) => {
+    i.forEach((t) => {
+      const e = Object.values(t).map((c) => String(c));
+      o.push(e);
+    });
+  }), o;
+}
+function b(r) {
+  const o = [];
+  return o.push(["x", "y"]), r.forEach((i) => {
+    i.forEach((t) => {
+      o.push([String(t[0]), String(t[1])]);
+    });
+  }), o;
+}
+function j(r) {
+  return function({
+    refUI: o
+  }) {
+    return [{
+      ...n,
+      modifier: () => n.modifier(o)
+    }, {
+      ...s,
+      modifier: async (i) => {
+        const t = r(i);
+        return s.modifier(t);
+      }
+    }];
+  };
+}
+export {
+  j as c,
+  T as f,
+  b as s
+};
+//# sourceMappingURL=download-config-Dqu78h2a.js.map

package/dist/download-config-Dqu78h2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-config-Dqu78h2a.js","sources":["../src/widgets/utils/chart-config/csv-modifiers.ts","../src/widgets/utils/chart-config/download-config.ts"],"sourcesContent":["/**\n * Shared CSV export modifiers for chart widgets\n */\n\n/**\n * Flattens object array data into CSV-ready rows.\n * Used by bar, pie, histogram, and timeseries widgets.\n *\n * @param data - Array of series, where each series is an array of data objects\n * @returns CSV rows with headers and values\n */\nexport function flattenObjectArrayToCSV<T extends Record<string, unknown>>(\n  data: T[][],\n): string[][] {\n  const rows: string[][] = []\n\n  // Add headers from first data point if available\n  if (data.length > 0 && (data[0]?.length ?? 0) > 0) {\n    const firstDataPoint = data?.[0]?.[0] ?? {}\n    const headers = Object.keys(firstDataPoint)\n    rows.push(headers)\n  }\n\n  // Add data rows from all series\n  data.forEach((series) => {\n    series.forEach((dataPoint) => {\n      const values = Object.values(dataPoint).map((v) => String(v))\n      rows.push(values)\n    })\n  })\n\n  return rows\n}\n\n/**\n * Creates CSV rows for scatterplot data.\n * Scatterplot uses array format [x, y] instead of objects.\n *\n * @param data - Array of series, where each series is an array of [x, y] tuples\n * @returns CSV rows with ['x', 'y'] headers\n */\nexport function scatterplotDataToCSV(data: number[][][]): string[][] {\n  const rows: string[][] = []\n\n  // Add headers\n  rows.push(['x', 'y'])\n\n  // Add data rows from all series\n  data.forEach((series) => {\n    series.forEach((dataPoint) => {\n      rows.push([String(dataPoint[0]), String(dataPoint[1])])\n    })\n  })\n\n  return rows\n}\n","import { downloadToCSV, downloadToPNG, type DownloadItem } from '../../actions'\nimport type { ConfigProps } from '../../loader/types'\n\nexport function createChartDownloadConfig<TData>(\n  csvModifier: (data: TData) => string[][],\n) {\n  return function ({ refUI }: ConfigProps): DownloadItem<TData>[] {\n    return [\n      {\n        ...downloadToPNG,\n        modifier: () => downloadToPNG.modifier(refUI),\n      },\n      {\n        ...downloadToCSV,\n        modifier: async (data) => {\n          const rows = csvModifier(data)\n          return downloadToCSV.modifier(rows)\n        },\n      },\n    ]\n  }\n}\n"],"names":["flattenObjectArrayToCSV","data","rows","length","firstDataPoint","headers","Object","keys","push","forEach","series","dataPoint","values","map","v","String","scatterplotDataToCSV","createChartDownloadConfig","csvModifier","refUI","downloadToPNG","modifier","downloadToCSV"],"mappings":";;;;;;;;;;;;;;AAWO,SAASA,EACdC,GACY;AACZ,QAAMC,IAAmB,CAAA;AAGzB,MAAID,EAAKE,SAAS,MAAMF,EAAK,CAAC,GAAGE,UAAU,KAAK,GAAG;AACjD,UAAMC,IAAiBH,IAAO,CAAC,IAAI,CAAC,KAAK,CAAA,GACnCI,IAAUC,OAAOC,KAAKH,CAAc;AAC1CF,IAAAA,EAAKM,KAAKH,CAAO;AAAA,EACnB;AAGAJ,SAAAA,EAAKQ,QAASC,CAAAA,MAAW;AACvBA,IAAAA,EAAOD,QAASE,CAAAA,MAAc;AAC5B,YAAMC,IAASN,OAAOM,OAAOD,CAAS,EAAEE,IAAKC,CAAAA,MAAMC,OAAOD,CAAC,CAAC;AAC5DZ,MAAAA,EAAKM,KAAKI,CAAM;AAAA,IAClB,CAAC;AAAA,EACH,CAAC,GAEMV;AACT;AASO,SAASc,EAAqBf,GAAgC;AACnE,QAAMC,IAAmB,CAAA;AAGzBA,SAAAA,EAAKM,KAAK,CAAC,KAAK,GAAG,CAAC,GAGpBP,EAAKQ,QAASC,CAAAA,MAAW;AACvBA,IAAAA,EAAOD,QAASE,CAAAA,MAAc;AAC5BT,MAAAA,EAAKM,KAAK,CAACO,OAAOJ,EAAU,CAAC,CAAC,GAAGI,OAAOJ,EAAU,CAAC,CAAC,CAAC,CAAC;AAAA,IACxD,CAAC;AAAA,EACH,CAAC,GAEMT;AACT;ACpDO,SAASe,EACdC,GACA;AACA,SAAO,SAAU;AAAA,IAAEC,OAAAA;AAAAA,EAAAA,GAA6C;AAC9D,WAAO,CACL;AAAA,MACE,GAAGC;AAAAA,MACHC,UAAUA,MAAMD,EAAcC,SAASF,CAAK;AAAA,IAAA,GAE9C;AAAA,MACE,GAAGG;AAAAA,MACHD,UAAU,OAAOpB,MAAS;AACxB,cAAMC,IAAOgB,EAAYjB,CAAI;AAC7B,eAAOqB,EAAcD,SAASnB,CAAI;AAAA,MACpC;AAAA,IAAA,CACD;AAAA,EAEL;AACF;"}

package/dist/formatter-B9Bxn1k7.js

@@ -0,0 +1,6 @@
+const a = (t) => String(t), e = (t) => t;
+export {
+  e as a,
+  a as d
+};
+//# sourceMappingURL=formatter-B9Bxn1k7.js.map

package/dist/formatter-B9Bxn1k7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter-B9Bxn1k7.js","sources":["../src/widgets/utils/formatter.ts"],"sourcesContent":["export const defaultFormatter = (value: number) => String(value)\nexport const defaultLabelFormatter = (value: string | number) => value\n"],"names":["defaultFormatter","value","String","defaultLabelFormatter"],"mappings":"AAAO,MAAMA,IAAmBA,CAACC,MAAkBC,OAAOD,CAAK,GAClDE,IAAwBA,CAACF,MAA2BA;"}

package/dist/styles-Y8q7Jff3.js

@@ -0,0 +1,118 @@
+function u(t) {
+  if (t === 0) return 0;
+  const e = Math.abs(t), n = Math.pow(10, Math.floor(Math.log10(e))), i = Math.ceil(e / n) * n;
+  return t < 0 ? -i : i;
+}
+function d({
+  hasLegend: t,
+  labelFormatter: e
+}) {
+  return {
+    show: t,
+    icon: "circle",
+    left: 0,
+    bottom: 0,
+    orient: "horizontal",
+    type: "scroll",
+    ...e && {
+      formatter: (n) => String(e(n))
+    }
+  };
+}
+function x(t, e) {
+  return {
+    ...!t && {
+      bottom: parseInt(e.spacing(3))
+    },
+    ...t && {
+      bottom: parseInt(e.spacing(7))
+    }
+  };
+}
+function y(t) {
+  return function(e, n, i, o, a) {
+    const l = {
+      top: parseInt(t.spacing(0.5))
+    };
+    return a.contentSize[0] < a.viewSize[0] - e[0] ? l.left = e[0] : l.right = a.viewSize[0] - e[0], l;
+  };
+}
+function m(t) {
+  if (t)
+    return (e) => t(e);
+}
+function b(t, e) {
+  const n = t && !Array.isArray(t), i = t, o = e && n ? (a) => String(e(a)) : void 0;
+  return {
+    ...i,
+    axisLabel: {
+      ...typeof i.axisLabel == "object" && i.axisLabel ? i.axisLabel : {},
+      formatter: o
+    }
+  };
+}
+function F(t, e) {
+  let n = m(e);
+  const i = t && !Array.isArray(t), o = t;
+  return (!i || o.type !== "value") && (n = void 0), {
+    ...o,
+    axisLabel: {
+      ...typeof o.axisLabel == "object" && o.axisLabel ? o.axisLabel : {},
+      formatter: n
+    }
+  };
+}
+function v(t) {
+  return (e) => {
+    const n = Array.isArray(e) ? e : [e], i = (r, s) => `<div style="margin: 0px 0 0;line-height:1;">${r ? `<div style="font-size:11px;color:#FFFFFF;font-weight:400;line-height:1; margin-bottom: 10px">${r}</div>` : ""}<div style="margin: 0;line-height:1;">${s}</div><div style="clear:both"></div></div>`, o = n.map((r) => {
+      const {
+        name: s,
+        seriesName: c,
+        marker: f,
+        value: h
+      } = t(r, n);
+      return {
+        name: s,
+        seriesName: c,
+        marker: f,
+        value: h
+      };
+    }), a = o[0]?.name ?? "", p = a || n.length > 1 ? "margin: 10px 0 0;line-height:1;" : "margin: 0;line-height:1;", g = o.map(({
+      seriesName: r,
+      marker: s,
+      value: c
+    }) => `<div style="${p}"><div style="margin: 0px 0 0;line-height:1;">${s}${r ? `<span style="font-size:11px;color:#FFFFFF;font-weight:400;margin-left:2px;margin-right:10px">${r}</span>` : ""}<span style="float:right;margin-left:10px;font-size:11px;color:#FFFFFF;font-weight:900">${c}</span></div></div>`);
+    return i(a, g.join(""));
+  };
+}
+const w = {
+  graph: {
+    /**
+     * Common container style for chart widget skeletons
+     */
+    container: {
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "space-between",
+      flexDirection: "column",
+      gap: ({
+        spacing: t
+      }) => t(1),
+      height: ({
+        spacing: t
+      }) => t(38)
+    }
+  }
+};
+export {
+  b as a,
+  F as b,
+  w as c,
+  x as d,
+  d as e,
+  m as f,
+  v as g,
+  y as h,
+  u as n
+};
+//# sourceMappingURL=styles-Y8q7Jff3.js.map

package/dist/styles-Y8q7Jff3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles-Y8q7Jff3.js","sources":["../src/widgets/utils/chart-config/option-builders.ts","../src/widgets/utils/skeleton/styles.ts"],"sourcesContent":["import type { Theme } from '@mui/material'\nimport type { LegendComponentOption } from 'echarts'\nimport type {\n  CallbackDataParams,\n  TopLevelFormatterParams,\n} from 'echarts/types/dist/shared'\n\n/**\n * Shared EChart configuration builders for chart widgets\n */\n\n/**\n * Rounds a value up to the nearest \"nice\" number.\n * A nice number is a multiple of 10^floor(log10(value)).\n *\n * Examples: 547 → 600, 200 → 200, 1200 → 2000, 18 → 20, 5 → 5, -547 → -500\n */\nexport function niceNum(value: number): number {\n  if (value === 0) return 0\n  const absValue = Math.abs(value)\n  const base = Math.pow(10, Math.floor(Math.log10(absValue)))\n  const rounded = Math.ceil(absValue / base) * base\n  return value < 0 ? -rounded : rounded\n}\n\n/**\n * Builds standard legend configuration for chart widgets\n *\n * @param params - Legend configuration parameters\n * @param params.hasLegend - Whether to show the legend\n * @param params.labelFormatter - Optional formatter for legend item names\n * @returns Legend configuration object\n */\nexport function buildLegendConfig({\n  hasLegend,\n  labelFormatter,\n}: {\n  hasLegend: boolean\n  labelFormatter?: (value: string | number) => string | number\n}): LegendComponentOption {\n  return {\n    show: hasLegend,\n    icon: 'circle' as const,\n    left: 0,\n    bottom: 0,\n    orient: 'horizontal',\n    type: 'scroll',\n    ...(labelFormatter && {\n      formatter: (name: string) => String(labelFormatter(name)),\n    }),\n  }\n}\n\n/**\n * Builds standard grid configuration with legend-aware spacing\n *\n * @param hasLegend - Whether the chart has a legend\n * @param theme - MUI theme for spacing\n * @param additionalConfig - Additional grid configuration to merge\n * @returns Grid configuration object\n */\nexport function buildGridConfig(hasLegend: boolean, theme: Theme) {\n  return {\n    ...(!hasLegend && { bottom: parseInt(theme.spacing(3)) }),\n    ...(hasLegend && { bottom: parseInt(theme.spacing(7)) }),\n  }\n}\n\n/**\n * Creates a tooltip position calculator that handles overflow\n * Used by bar, histogram, and scatterplot widgets\n *\n * @param theme - MUI theme for spacing\n * @returns Tooltip position function\n */\nexport function createTooltipPositioner(theme: Theme) {\n  return function (\n    point: [number, number],\n    _params: unknown,\n    _dom: unknown,\n    _rect: unknown,\n    size: { contentSize: [number, number]; viewSize: [number, number] },\n  ) {\n    const position = { top: parseInt(theme.spacing(0.5)) } as Record<\n      string,\n      number\n    >\n\n    // Position tooltip left or right based on available space\n    if (size.contentSize[0] < size.viewSize[0] - point[0]) {\n      position.left = point[0]\n    } else {\n      position.right = size.viewSize[0] - point[0]\n    }\n\n    return position\n  }\n}\n\n/**\n * Creates an axis label formatter for ECharts\n * Used to format numeric axis labels with a widget formatter\n *\n * @param formatter - Optional formatter function from widget config\n * @returns Axis label formatter function or undefined\n */\nexport function createAxisLabelFormatter(\n  formatter?: (value: number) => string,\n) {\n  if (!formatter) return undefined\n  return (value: number) => formatter(value)\n}\n\n/**\n * Applies labelFormatter to xAxis configuration\n * Applies to any xAxis regardless of axis type (category, value, etc.)\n *\n * @param xAxis - Existing xAxis configuration\n * @param labelFormatter - Optional labelFormatter function from widget config\n * @returns Updated xAxis configuration\n */\nexport function applyXAxisFormatter(\n  xAxis: unknown,\n  formatter?: (value: string | number) => string | number,\n) {\n  const xAxisIsObject = xAxis && !Array.isArray(xAxis)\n  const xAxisTyped = xAxis as { type?: string; axisLabel?: unknown }\n\n  const axisFormatter =\n    formatter && xAxisIsObject\n      ? (value: string | number) => String(formatter(value))\n      : undefined\n\n  return {\n    ...xAxisTyped,\n    axisLabel: {\n      ...(typeof xAxisTyped.axisLabel === 'object' && xAxisTyped.axisLabel\n        ? xAxisTyped.axisLabel\n        : {}),\n      formatter: axisFormatter,\n    },\n  }\n}\n\n/**\n * Applies formatter to yAxis configuration\n * Only applies to single axis objects (not arrays) with type 'value'\n *\n * @param yAxis - Existing yAxis configuration\n * @param formatter - Optional formatter function from widget config\n * @returns Updated yAxis configuration or undefined if no changes needed\n */\nexport function applyYAxisFormatter(\n  yAxis: unknown,\n  formatter?: (value: number) => string,\n) {\n  let axisFormatter = createAxisLabelFormatter(formatter)\n\n  const yAxisIsObject = yAxis && !Array.isArray(yAxis)\n  const yAxisTyped = yAxis as { type?: string; axisLabel?: unknown }\n\n  if (!yAxisIsObject || yAxisTyped.type !== 'value') {\n    axisFormatter = undefined\n  }\n\n  return {\n    ...yAxisTyped,\n    axisLabel: {\n      ...(typeof yAxisTyped.axisLabel === 'object' && yAxisTyped.axisLabel\n        ? yAxisTyped.axisLabel\n        : {}),\n      formatter: axisFormatter,\n    },\n  }\n}\n\n/**\n * Creates a tooltip formatter for ECharts\n * Formats numeric values in tooltip using widget formatter\n * Handles both axis trigger (array) and item trigger (object) modes\n *\n * @param formatter - Optional formatter function from widget config\n * @returns Tooltip formatter function or undefined\n */\nexport function createTooltipFormatter(\n  callback: (\n    item: CallbackDataParams,\n    items: CallbackDataParams[],\n  ) => {\n    name: string\n    seriesName: string\n    marker: string\n    value: string | number\n  },\n) {\n  return (params: TopLevelFormatterParams) => {\n    // Handle both array (axis trigger) and object (item trigger)\n    const items = Array.isArray(params) ? params : [params]\n\n    const tooltip = (name: string, callback: string) =>\n      `<div style=\"margin: 0px 0 0;line-height:1;\">${name ? `<div style=\"font-size:11px;color:#FFFFFF;font-weight:400;line-height:1; margin-bottom: 10px\">${name}</div>` : ''}<div style=\"margin: 0;line-height:1;\">${callback}</div><div style=\"clear:both\"></div></div>`\n\n    const values = items.map((item) => {\n      const { name, seriesName, marker, value } = callback(item, items)\n      return {\n        name,\n        seriesName,\n        marker,\n        value,\n      }\n    })\n\n    const name = values[0]?.name ?? ''\n    // Show margin if name exists or there are multiple items\n    const showMargin = name || items.length > 1\n    const marginStyle = showMargin\n      ? 'margin: 10px 0 0;line-height:1;'\n      : 'margin: 0;line-height:1;'\n\n    const formattedValues = values.map(\n      ({ seriesName, marker, value }) =>\n        `<div style=\"${marginStyle}\"><div style=\"margin: 0px 0 0;line-height:1;\">${marker}${seriesName ? `<span style=\"font-size:11px;color:#FFFFFF;font-weight:400;margin-left:2px;margin-right:10px\">${seriesName}</span>` : ''}<span style=\"float:right;margin-left:10px;font-size:11px;color:#FFFFFF;font-weight:900\">${value}</span></div></div>`,\n    )\n\n    return tooltip(name, formattedValues.join(''))\n  }\n}\n","import type { Theme } from '@mui/material'\n\n/**\n * Base skeleton styles shared across all chart widgets\n */\nexport const baseSkeletonStyles = {\n  graph: {\n    /**\n     * Common container style for chart widget skeletons\n     */\n    container: {\n      display: 'flex',\n      alignItems: 'center',\n      justifyContent: 'space-between',\n      flexDirection: 'column',\n      gap: ({ spacing }: Theme) => spacing(1),\n      height: ({ spacing }: Theme) => spacing(38),\n    },\n  },\n} as const\n"],"names":["niceNum","value","absValue","Math","abs","base","pow","floor","log10","rounded","ceil","buildLegendConfig","hasLegend","labelFormatter","show","icon","left","bottom","orient","type","formatter","name","String","buildGridConfig","theme","parseInt","spacing","createTooltipPositioner","point","_params","_dom","_rect","size","position","top","contentSize","viewSize","right","createAxisLabelFormatter","applyXAxisFormatter","xAxis","xAxisIsObject","Array","isArray","xAxisTyped","axisFormatter","undefined","axisLabel","applyYAxisFormatter","yAxis","yAxisIsObject","yAxisTyped","createTooltipFormatter","callback","params","items","tooltip","values","map","item","seriesName","marker","marginStyle","length","formattedValues","join","baseSkeletonStyles","graph","container","display","alignItems","justifyContent","flexDirection","gap","height"],"mappings":"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"}

package/dist/types/widgets/actions/brush-toggle/types.d.ts

@@ -2,9 +2,15 @@ import { IconButtonProps } from '@mui/material';
 import { ReactNode } from 'react';
 import { BaseWidgetState } from '../../stores/types';
 /**
- * Represents a single item selected by the brush
+ * Brush selection result emitted by BrushToggle.
+ * Contains raw indices so consumers can resolve data according to their widget type.
  */
-export type BrushSelectedItems = (string | number)[];
+export interface BrushSelectedItems {
+    /** Data indices of the selected items in the dataset */
+    dataIndex: number[];
+    /** Series index from the brush event (defaults to 0) */
+    seriesIndex: number;
+}
 /**
  * State stored in widget store for brush functionality
  */

package/dist/types/widgets/category/components/category-row-multi.d.ts

@@ -5,10 +5,11 @@ export interface CategoryRowMultiProps {
     maxValue: number;
     colors: string[];
     formatter: NonNullable<CategoryWidgetConfig['formatter']>;
+    labelFormatter?: CategoryWidgetConfig['labelFormatter'];
     onClick?: CategoryWidgetConfig['onRowClick'];
     selected?: boolean;
 }
 /**
  * Renders a multi-series category row with a label and multiple color-coded bars stacked vertically.
  */
-export declare function CategoryRowMulti({ name, values, maxValue, colors, formatter, onClick, selected, }: CategoryRowMultiProps): import("react/jsx-runtime").JSX.Element;
+export declare function CategoryRowMulti({ name, values, maxValue, colors, formatter, labelFormatter, onClick, selected, }: CategoryRowMultiProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/category/components/category-row-single.d.ts

@@ -5,10 +5,11 @@ export interface CategoryRowSingleProps {
     maxValue: number;
     color: string;
     formatter: NonNullable<CategoryWidgetConfig['formatter']>;
+    labelFormatter?: CategoryWidgetConfig['labelFormatter'];
     onClick?: CategoryWidgetConfig['onRowClick'];
     selected?: boolean;
 }
 /**
  * Renders a single-series category row with a label, formatted value, and proportional bar.
  */
-export declare function CategoryRowSingle({ name, value, maxValue, color, formatter, onClick, selected, }: CategoryRowSingleProps): import("react/jsx-runtime").JSX.Element;
+export declare function CategoryRowSingle({ name, value, maxValue, color, formatter, labelFormatter, onClick, selected, }: CategoryRowSingleProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/category/types.d.ts

@@ -22,6 +22,7 @@ export type CategoryWidgetState = BaseWidgetState<WrapperState<CategoryWidgetCon
 }>;
 export interface CategoryWidgetConfig {
     formatter?: (value: number) => string;
+    labelFormatter?: (value: string | number) => string | number;
     series?: CategorySeriesConfig[];
     maxItems?: number;
     labels?: CategoryLabels;

package/dist/types/widgets/echart/types.d.ts

@@ -27,10 +27,12 @@ export interface EchartWidgetOptionProps<D> {
     data?: D;
     theme: typeof CartoTheme;
     formatter?: (value: number) => string;
+    labelFormatter?: (value: string | number) => string | number;
 }
 export interface EchartWidgetProps {
     type: string;
     option: EchartUIProps['option'];
     onEvents?: EchartUIProps['onEvents'];
     formatter?: (value: number) => string;
+    labelFormatter?: (value: string | number) => string | number;
 }

package/dist/types/widgets/histogram/config.d.ts

@@ -1,9 +1,21 @@
 import { HistogramConfig, HistogramWidgetConfig } from './types';
-export declare const histogramDownloadConfig: ({ refUI }: import('../loader').ConfigProps) => import('../actions').DownloadItem<import('../echart').EchartWidgetData>[];
+import { DownloadItem } from '../actions';
+import { ConfigProps } from '../loader/types';
+export interface HistogramDownloadConfigProps extends ConfigProps {
+    ticks: number[];
+    labelFormatter?: (value: string | number) => string | number;
+}
+export declare function histogramDataToCSV(data: number[][], ticks: number[], labelFormatter?: (value: string | number) => string | number): string[][];
+export declare function histogramDownloadConfig({ refUI, ticks, labelFormatter, }: HistogramDownloadConfigProps): DownloadItem<number[][]>[];
 /**
- * Generates ECharts configuration for distribution histogram widgets with adjacent bars (minimal gap) and axis formatting styled with the CARTO theme.
+ * Generates ECharts configuration for distribution histogram widgets with
+ * adjacent bars (minimal gap) and axis formatting styled with the CARTO theme.
  *
- * @param props - Histogram configuration including bin data and theme.
+ * Accepts raw `number[][]` data and `ticks` boundaries. The ticks and
+ * `labelFormatter` are used to create the x-axis category labels; the raw
+ * numeric data is embedded directly in each series.
+ *
+ * @param props - Histogram configuration including raw data, ticks, and theme.
  * @returns Widget config with ECharts option object.
  */
 export declare function histogramConfig(props: HistogramConfig): HistogramWidgetConfig;

package/dist/types/widgets/histogram/index.d.ts

@@ -1,3 +1,4 @@
 export type { HistogramConfig, HistogramWidgetConfig, HistogramWidgetData, HistogramWidgetState, } from './types';
-export { histogramConfig, histogramDownloadConfig } from './config';
+export type { HistogramDownloadConfigProps } from './config';
+export { histogramConfig, histogramDataToCSV, histogramDownloadConfig, } from './config';
 export { HistogramSkeleton } from './skeleton';

package/dist/types/widgets/histogram/types.d.ts

@@ -1,9 +1,12 @@
-import { EchartWidgetData, EchartWidgetState } from '../echart';
+import { EchartWidgetState } from '../echart';
 import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types';
 import { ConfigProps } from '../loader';
-export type HistogramWidgetData = EchartWidgetData;
+export type HistogramWidgetData = number[][];
 export type HistogramWidgetState = EchartWidgetState;
 export type HistogramWidgetConfig = EchartWidgetProps & {
     type: 'histogram';
 };
-export type HistogramConfig = ConfigProps & EchartWidgetOptionProps<HistogramWidgetData>;
+export type HistogramConfig = ConfigProps & Pick<EchartWidgetOptionProps<unknown>, 'theme' | 'formatter' | 'labelFormatter'> & {
+    data?: number[][];
+    ticks: number[];
+};

package/dist/types/widgets/stores/types.d.ts

@@ -29,6 +29,8 @@ export interface WidgetsStoreProps {
     registeredTools?: ToolRegistration[];
     /** Formatter function for widget values */
     formatter?: (value: number) => string;
+    /** Formatter function for widget label/category values */
+    labelFormatter?: (value: string | number) => string | number;
     /** Locale for number formatting (e.g., 'en-US', 'es-ES', 'fr-FR') */
     locale?: string;
 }

package/dist/types/widgets/utils/chart-config/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared utilities for chart widget configuration
  */
-export { defaultFormatter } from '../formatter';
+export { defaultFormatter, defaultLabelFormatter } from '../formatter';
 export { createChartWidgetConfig } from './config-factory';
 export type { ChartWidgetBaseConfig, CreateChartWidgetConfigParams, } from './config-factory';
 export { flattenObjectArrayToCSV, scatterplotDataToCSV } from './csv-modifiers';

package/dist/types/widgets/utils/chart-config/option-builders.d.ts

@@ -14,10 +14,15 @@ export declare function niceNum(value: number): number;
 /**
  * Builds standard legend configuration for chart widgets
  *
- * @param hasLegend - Whether to show the legend
+ * @param params - Legend configuration parameters
+ * @param params.hasLegend - Whether to show the legend
+ * @param params.labelFormatter - Optional formatter for legend item names
  * @returns Legend configuration object
  */
-export declare function buildLegendConfig(hasLegend: boolean): LegendComponentOption;
+export declare function buildLegendConfig({ hasLegend, labelFormatter, }: {
+    hasLegend: boolean;
+    labelFormatter?: (value: string | number) => string | number;
+}): LegendComponentOption;
 /**
  * Builds standard grid configuration with legend-aware spacing
  *
@@ -49,16 +54,16 @@ export declare function createTooltipPositioner(theme: Theme): (point: [number,
  */
 export declare function createAxisLabelFormatter(formatter?: (value: number) => string): ((value: number) => string) | undefined;
 /**
- * Applies formatter to xAxis configuration
- * Only applies to single axis objects (not arrays) with type 'value'
+ * Applies labelFormatter to xAxis configuration
+ * Applies to any xAxis regardless of axis type (category, value, etc.)
  *
  * @param xAxis - Existing xAxis configuration
- * @param formatter - Optional formatter function from widget config
- * @returns Updated xAxis configuration or undefined if no changes needed
+ * @param labelFormatter - Optional labelFormatter function from widget config
+ * @returns Updated xAxis configuration
  */
-export declare function applyXAxisFormatter(xAxis: unknown, formatter?: (value: number) => string): {
+export declare function applyXAxisFormatter(xAxis: unknown, formatter?: (value: string | number) => string | number): {
     axisLabel: {
-        formatter: ((value: number) => string) | undefined;
+        formatter: ((value: string | number) => string) | undefined;
     };
     type?: string;
 };

package/dist/types/widgets/utils/formatter.d.ts

@@ -1 +1,2 @@
 export declare const defaultFormatter: (value: number) => string;
+export declare const defaultLabelFormatter: (value: string | number) => string | number;

package/dist/types/widgets/utils/index.d.ts

@@ -1,4 +1,4 @@
-export { defaultFormatter } from './formatter';
+export { defaultFormatter, defaultLabelFormatter } from './formatter';
 export { createChartWidgetConfig } from './chart-config';
 export type { ChartWidgetBaseConfig, CreateChartWidgetConfigParams, } from './chart-config';
 export { flattenObjectArrayToCSV, scatterplotDataToCSV } from './chart-config';