@carto/ps-react-ui 4.4.1 → 4.4.3

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":"AAiBO,SAASA,EAAQC,GAAuB;AAC7C,MAAIA,MAAU,EAAG,QAAO;AACxB,QAAMC,IAAWC,KAAKC,IAAIH,CAAK,GACzBI,IAAOF,KAAKG,IAAI,IAAIH,KAAKI,MAAMJ,KAAKK,MAAMN,CAAQ,CAAC,CAAC,GACpDO,IAAUN,KAAKO,KAAKR,IAAWG,CAAI,IAAIA;AAC7C,SAAOJ,IAAQ,IAAI,CAACQ,IAAUA;AAChC;AAUO,SAASE,EAAkB;AAAA,EAChCC,WAAAA;AAAAA,EACAC,gBAAAA;AAIF,GAA0B;AACxB,SAAO;AAAA,IACLC,MAAMF;AAAAA,IACNG,MAAM;AAAA,IACNC,MAAM;AAAA,IACNC,QAAQ;AAAA,IACRC,QAAQ;AAAA,IACRC,MAAM;AAAA,IACN,GAAIN,KAAkB;AAAA,MACpBO,WAAWA,CAACC,MAAiBC,OAAOT,EAAeQ,CAAI,CAAC;AAAA,IAAA;AAAA,EAC1D;AAEJ;AAUO,SAASE,EAAgBX,GAAoBY,GAAc;AAChE,SAAO;AAAA,IACL,GAAI,CAACZ,KAAa;AAAA,MAAEK,QAAQQ,SAASD,EAAME,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,IACrD,GAAId,KAAa;AAAA,MAAEK,QAAQQ,SAASD,EAAME,QAAQ,CAAC,CAAC;AAAA,IAAA;AAAA,EAAE;AAE1D;AASO,SAASC,EAAwBH,GAAc;AACpD,SAAO,SACLI,GACAC,GACAC,GACAC,GACAC,GACA;AACA,UAAMC,IAAW;AAAA,MAAEC,KAAKT,SAASD,EAAME,QAAQ,GAAG,CAAC;AAAA,IAAA;AAMnD,WAAIM,EAAKG,YAAY,CAAC,IAAIH,EAAKI,SAAS,CAAC,IAAIR,EAAM,CAAC,IAClDK,EAASjB,OAAOY,EAAM,CAAC,IAEvBK,EAASI,QAAQL,EAAKI,SAAS,CAAC,IAAIR,EAAM,CAAC,GAGtCK;AAAAA,EACT;AACF;AASO,SAASK,EACdlB,GACA;AACA,MAAKA;AACL,WAAO,CAACnB,MAAkBmB,EAAUnB,CAAK;AAC3C;AAUO,SAASsC,EACdC,GACApB,GACA;AACA,QAAMqB,IAAgBD,KAAS,CAACE,MAAMC,QAAQH,CAAK,GAC7CI,IAAaJ,GAEbK,IACJzB,KAAaqB,IACT,CAACxC,MAA2BqB,OAAOF,EAAUnB,CAAK,CAAC,IACnD6C;AAEN,SAAO;AAAA,IACL,GAAGF;AAAAA,IACHG,WAAW;AAAA,MACT,GAAI,OAAOH,EAAWG,aAAc,YAAYH,EAAWG,YACvDH,EAAWG,YACX,CAAA;AAAA,MACJ3B,WAAWyB;AAAAA,IAAAA;AAAAA,EACb;AAEJ;AAUO,SAASG,EACdC,GACA7B,GACA;AACA,MAAIyB,IAAgBP,EAAyBlB,CAAS;AAEtD,QAAM8B,IAAgBD,KAAS,CAACP,MAAMC,QAAQM,CAAK,GAC7CE,IAAaF;AAEnB,UAAI,CAACC,KAAiBC,EAAWhC,SAAS,aACxC0B,IAAgBC,SAGX;AAAA,IACL,GAAGK;AAAAA,IACHJ,WAAW;AAAA,MACT,GAAI,OAAOI,EAAWJ,aAAc,YAAYI,EAAWJ,YACvDI,EAAWJ,YACX,CAAA;AAAA,MACJ3B,WAAWyB;AAAAA,IAAAA;AAAAA,EACb;AAEJ;AAUO,SAASO,EACdC,GASA;AACA,SAAO,CAACC,MAAoC;AAE1C,UAAMC,IAAQb,MAAMC,QAAQW,CAAM,IAAIA,IAAS,CAACA,CAAM,GAEhDE,IAAUA,CAACnC,GAAcgC,MAC7B,+CAA+ChC,IAAO,gGAAgGA,CAAI,WAAW,EAAE,yCAAyCgC,CAAQ,8CAEpNI,IAASF,EAAMG,IAAKC,CAAAA,MAAS;AACjC,YAAM;AAAA,QAAEtC,MAAAA;AAAAA,QAAMuC,YAAAA;AAAAA,QAAYC,QAAAA;AAAAA,QAAQ5D,OAAAA;AAAAA,MAAAA,IAAUoD,EAASM,GAAMJ,CAAK;AAChE,aAAO;AAAA,QACLlC,MAAAA;AAAAA,QACAuC,YAAAA;AAAAA,QACAC,QAAAA;AAAAA,QACA5D,OAAAA;AAAAA,MAAAA;AAAAA,IAEJ,CAAC,GAEKoB,IAAOoC,EAAO,CAAC,GAAGpC,QAAQ,IAG1ByC,IADazC,KAAQkC,EAAMQ,SAAS,IAEtC,oCACA,4BAEEC,IAAkBP,EAAOC,IAC7B,CAAC;AAAA,MAAEE,YAAAA;AAAAA,MAAYC,QAAAA;AAAAA,MAAQ5D,OAAAA;AAAAA,IAAAA,MACrB,eAAe6D,CAAW,iDAAiDD,CAAM,GAAGD,IAAa,gGAAgGA,CAAU,YAAY,EAAE,2FAA2F3D,CAAK,qBAC7T;AAEA,WAAOuD,EAAQnC,GAAM2C,EAAgBC,KAAK,EAAE,CAAC;AAAA,EAC/C;AACF;AC7NO,MAAMC,IAAqB;AAAA,EAChCC,OAAO;AAAA;AAAA;AAAA;AAAA,IAILC,WAAW;AAAA,MACTC,SAAS;AAAA,MACTC,YAAY;AAAA,MACZC,gBAAgB;AAAA,MAChBC,eAAe;AAAA,MACfC,KAAKA,CAAC;AAAA,QAAE/C,SAAAA;AAAAA,MAAAA,MAAqBA,EAAQ,CAAC;AAAA,MACtCgD,QAAQA,CAAC;AAAA,QAAEhD,SAAAA;AAAAA,MAAAA,MAAqBA,EAAQ,EAAE;AAAA,IAAA;AAAA,EAC5C;AAEJ;"}

package/dist/tooltip-BDnrRKrp.js.map

@@ -1 +1 @@
-{"version":3,"file":"tooltip-BDnrRKrp.js","sources":["../src/components/tooltip/tooltip.tsx"],"sourcesContent":["import { Tooltip as MuiTooltip, type TooltipProps } from '@mui/material'\n\nlet tooltipEnterDelay = 500\n\n/**\n * A wrapper around MUI's Tooltip component with enterNextDelay set to 1000ms by default.\n *\n * This component ensures consistent tooltip behavior across the application.\n *\n * @example\n * <Tooltip title=\"This is a tooltip\">\n *   <Button>Hover me</Button>\n * </Tooltip>\n */\nexport function Tooltip({\n  children,\n  title,\n  enterNextDelay = tooltipEnterDelay,\n  ...props\n}: TooltipProps) {\n  return (\n    <MuiTooltip title={title} enterNextDelay={enterNextDelay} {...props}>\n      {children}\n    </MuiTooltip>\n  )\n}\n\nexport function setTooltipEnterDelay(delay: number) {\n  tooltipEnterDelay = delay\n}\n"],"names":["tooltipEnterDelay","Tooltip","t0","$","_c","children","props","t1","title","enterNextDelay","undefined","t2","MuiTooltip","setTooltipEnterDelay","delay"],"mappings":";;;AAEA,IAAIA,IAAoB;AAYjB,SAAAC,EAAAC,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA;AAAA,MAAAC,GAAAC,GAAAC,GAAAC;AAAA,EAAAL,SAAAD,KAAiB;AAAA,IAAAG,UAAAA;AAAAA,IAAAG,OAAAA;AAAAA,IAAAC,gBAAAF;AAAAA,IAAA,GAAAD;AAAAA,EAAAA,IAAAJ,GAKTC,OAAAD,GAAAC,OAAAE,GAAAF,OAAAG,GAAAH,OAAAI,GAAAJ,OAAAK,MAAAH,IAAAF,EAAA,CAAA,GAAAG,IAAAH,EAAA,CAAA,GAAAI,IAAAJ,EAAA,CAAA,GAAAK,IAAAL,EAAA,CAAA;AAFb,QAAAM,IAAAF,MAAAG,SAAAV,IAAAO;AAAkC,MAAAI;AAAA,SAAAR,EAAA,CAAA,MAAAE,KAAAF,EAAA,CAAA,MAAAM,KAAAN,EAAA,CAAA,MAAAG,KAAAH,SAAAK,KAIhCG,sBAACC,GAAA,EAAkBJ,OAAAA,GAAuBC,gBAAAA,MAAoBH,gBAE9D,GAAaH,OAAAE,GAAAF,OAAAM,GAAAN,OAAAG,GAAAH,OAAAK,GAAAL,OAAAQ,KAAAA,IAAAR,EAAA,CAAA,GAFbQ;AAEa;AAIV,SAASE,EAAqBC,GAAe;AAClDd,EAAAA,IAAoBc;AACtB;"}
+{"version":3,"file":"tooltip-BDnrRKrp.js","sources":["../src/components/tooltip/tooltip.tsx"],"sourcesContent":["import { Tooltip as MuiTooltip, type TooltipProps } from '@mui/material'\n\nlet tooltipEnterDelay = 500\n\n/**\n * A wrapper around MUI's Tooltip component with enterNextDelay set to 1000ms by default.\n *\n * This component ensures consistent tooltip behavior across the application.\n *\n * @example\n * <Tooltip title=\"This is a tooltip\">\n *   <Button>Hover me</Button>\n * </Tooltip>\n */\nexport function Tooltip({\n  children,\n  title,\n  enterNextDelay = tooltipEnterDelay,\n  ...props\n}: TooltipProps) {\n  return (\n    <MuiTooltip title={title} enterNextDelay={enterNextDelay} {...props}>\n      {children}\n    </MuiTooltip>\n  )\n}\n\n/**\n * Sets the global default `enterNextDelay` for all Tooltip components in the application.\n *\n * @param delay - Delay in milliseconds before showing tooltips on subsequent hovers.\n *\n * @example\n * ```tsx\n * import { setTooltipEnterDelay } from '@carto/ps-react-ui/components';\n *\n * // Set global delay to 300ms at app initialization\n * setTooltipEnterDelay(300);\n * ```\n */\nexport function setTooltipEnterDelay(delay: number) {\n  tooltipEnterDelay = delay\n}\n"],"names":["tooltipEnterDelay","Tooltip","t0","$","_c","children","props","t1","title","enterNextDelay","undefined","t2","MuiTooltip","setTooltipEnterDelay","delay"],"mappings":";;;AAEA,IAAIA,IAAoB;AAYjB,SAAAC,EAAAC,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA;AAAA,MAAAC,GAAAC,GAAAC,GAAAC;AAAA,EAAAL,SAAAD,KAAiB;AAAA,IAAAG,UAAAA;AAAAA,IAAAG,OAAAA;AAAAA,IAAAC,gBAAAF;AAAAA,IAAA,GAAAD;AAAAA,EAAAA,IAAAJ,GAKTC,OAAAD,GAAAC,OAAAE,GAAAF,OAAAG,GAAAH,OAAAI,GAAAJ,OAAAK,MAAAH,IAAAF,EAAA,CAAA,GAAAG,IAAAH,EAAA,CAAA,GAAAI,IAAAJ,EAAA,CAAA,GAAAK,IAAAL,EAAA,CAAA;AAFb,QAAAM,IAAAF,MAAAG,SAAAV,IAAAO;AAAkC,MAAAI;AAAA,SAAAR,EAAA,CAAA,MAAAE,KAAAF,EAAA,CAAA,MAAAM,KAAAN,EAAA,CAAA,MAAAG,KAAAH,SAAAK,KAIhCG,sBAACC,GAAA,EAAkBJ,OAAAA,GAAuBC,gBAAAA,MAAoBH,gBAE9D,GAAaH,OAAAE,GAAAF,OAAAM,GAAAN,OAAAG,GAAAH,OAAAK,GAAAL,OAAAQ,KAAAA,IAAAR,EAAA,CAAA,GAFbQ;AAEa;AAiBV,SAASE,EAAqBC,GAAe;AAClDd,EAAAA,IAAoBc;AACtB;"}

package/dist/types/components/basemaps/basemaps.d.ts

@@ -1,3 +1,23 @@
 import { BasemapsUIProps } from './types';
 import { JSX } from 'react';
+/**
+ * Provides an interactive basemap selector with responsive drawer, grouping support, and customizable positioning.
+ *
+ * @remarks
+ * This is an uncontrolled component focused on UI presentation. Typically used with the `BasemapsControls` HOC from `@carto/ps-react-maps` for automatic state management.
+ *
+ * @example
+ * ```tsx
+ * <BasemapsControls mapId={mapId}>
+ *   {({ basemap, setBasemap }) => (
+ *     <BasemapsUI
+ *       options={basemapOptions}
+ *       selected={basemap}
+ *       onChange={setBasemap}
+ *       position="bottom-right"
+ *     />
+ *   )}
+ * </BasemapsControls>
+ * ```
+ */
 export declare function BasemapsUI({ options, labels: _labels, position, selected, onChange, TooltipProps, }: BasemapsUIProps): JSX.Element;

package/dist/types/components/geolocation-controls/geolocation-controls.d.ts

@@ -1,3 +1,14 @@
 import { GeolocationControlProps } from './types';
 import { JSX } from 'react';
+/**
+ * Provides a seamless interface for accessing device location through the browser's Geolocation API, with permission handling, continuous tracking, and error management.
+ *
+ * @example
+ * ```tsx
+ * <GeolocationControls
+ *   onChange={(coords) => console.log(coords.latitude, coords.longitude)}
+ *   onError={(error) => console.error(error.message)}
+ * />
+ * ```
+ */
 export declare function GeolocationControls({ disabled, labels, PaperProps, TooltipProps, watch, onChange, onError, }: GeolocationControlProps): JSX.Element;

package/dist/types/components/lasso-tool/lasso-tool-inline.d.ts

@@ -1,3 +1,20 @@
 import { JSX } from 'react';
 import { LassoToolsInlineComponentProps } from './types';
+/**
+ * Provides an inline layout variant of the lasso tools interface with toggle button groups for mode selection and inline chip management for spatial filters.
+ *
+ * @example
+ * ```tsx
+ * <LassoToolsInlineUI
+ *   enabled={enabled}
+ *   values={spatialFilters}
+ *   modes={modes}
+ *   modesMapping={modesMapping}
+ *   modeSelected={modeSelected}
+ *   onChangeMode={setModeSelected}
+ *   onChipToggle={handleChipToggle}
+ *   onDelete={handleDelete}
+ * />
+ * ```
+ */
 export declare function LassoToolsInlineUI({ enabled, values, chipProps, labels, modes, modesMapping, modeSelected, BoxProps: { sx, ...BoxProps }, onChipToggle, onDelete, onChangeMode, onAllChipToggle, onAllDelete, }: LassoToolsInlineComponentProps): JSX.Element;

package/dist/types/components/lasso-tool/lasso-tool.d.ts

@@ -1,6 +1,27 @@
 import { JSX } from 'react';
 import { PickDeep } from 'type-fest';
 import { LassoToolsComponentProps, OptionsChildrenProps } from './types';
+/**
+ * Provides a comprehensive floating interface for spatial selection and drawing operations on maps, supporting polygon, rectangle, circle, freehand lasso, and edit modes.
+ *
+ * @remarks
+ * Supports customizable slots for action, options, chips, and secondary actions via compound component pattern (e.g., `LassoToolsUI.Action`, `LassoToolsUI.Chips`).
+ *
+ * @example
+ * ```tsx
+ * <LassoToolsUI
+ *   enabled={enabled}
+ *   values={spatialFilters}
+ *   modes={modes}
+ *   modesMapping={modesMapping}
+ *   modeSelected={modeSelected}
+ *   onActionToggle={setEnabled}
+ *   onChangeMode={setModeSelected}
+ *   onChipToggle={handleChipToggle}
+ *   onDelete={handleDelete}
+ * />
+ * ```
+ */
 export declare function LassoToolsUI({ enabled, values, actionProps, chipProps, labels, modes, modesMapping, modeSelected, PaperProps: { sx, ...PaperProps }, onActionToggle, onChipToggle, onDelete, onChangeMode, onAllChipToggle, onAllDelete, ChipsSlot, ActionSlot, SecondaryActionsSlot, OptionsSlot, }: LassoToolsComponentProps): JSX.Element;
 export declare namespace LassoToolsUI {
     var Action: ({ modes, modesMapping, modeSelected, actionProps, enabled, labels, onActionToggle, }: Partial<Omit<LassoToolsComponentProps, "ChipsSlot" | "ActionsSlot" | "OptionsSlot" | "SecondaryActionsSlot">> & {

package/dist/types/components/list-data/list-data.d.ts

@@ -1,3 +1,19 @@
 import { JSX } from 'react';
 import { ListDataProps } from './types';
+/**
+ * Displays structured data in an accessible list format with expandable views, interactive selection, tooltips, and loading states.
+ *
+ * @example
+ * ```tsx
+ * <ListDataUI
+ *   data={[
+ *     { id: '1', label: 'Population', value: '8.4M' },
+ *     { id: '2', label: 'Median Age', value: '32 years' },
+ *   ]}
+ *   maxItems={3}
+ *   onItemClick={(item) => setSelectedId(item.id)}
+ *   selectedItemId={selectedId}
+ * />
+ * ```
+ */
 export declare function ListDataUI({ data, isLoading, maxItems, labels, showDivider, selectedItemId, tooltipProps, onExpand, onItemClick, }: ListDataProps): JSX.Element;

package/dist/types/components/measurement-tools/measurement-tools.d.ts

@@ -1,3 +1,23 @@
 import { JSX } from 'react';
 import { MeasurementToolsComponentProps } from './types';
+/**
+ * Provides a measurement interface for calculating distances, areas, and buffers on maps with support for metric and imperial unit systems and real-time unit conversion.
+ *
+ * @example
+ * ```tsx
+ * <MeasurementToolsUI
+ *   enabled={enabled}
+ *   value={measurementValue}
+ *   modes={DEFAULT_MEASUREMENT_TOOLS_MODES}
+ *   units={DEFAULT_MEASUREMENT_TOOLS_UNITS}
+ *   modesMapping={DEFAULT_MEASUREMENT_TOOLS_MODES_MAPPING}
+ *   unitsMapping={DEFAULT_MEASUREMENT_TOOLS_UNITS_MAPPING}
+ *   modeSelected={mode}
+ *   unitSelected={unit}
+ *   onActionToggle={setEnabled}
+ *   onChangeMode={setMode}
+ *   onChangeUnit={setUnit}
+ * />
+ * ```
+ */
 export declare function MeasurementToolsUI({ enabled, actionProps, labels, modes, modesMapping, unitsMapping, modeSelected, PaperProps: { sx, ...PaperProps }, units, unitSelected, onActionToggle, onChangeMode, onChangeUnit, }: MeasurementToolsComponentProps): JSX.Element;

package/dist/types/components/smart-tooltip/smart-tooltip.d.ts

@@ -1,5 +1,22 @@
 import { TooltipProps } from '@mui/material';
 import { JSX, Ref } from 'react';
+/**
+ * An intelligent tooltip wrapper that automatically detects text overflow and displays a tooltip only when content is truncated.
+ *
+ * @remarks
+ * Uses a render prop pattern. The child function receives a `ref` that must be attached to the element being monitored for overflow. Use the `dependencies` array to trigger re-evaluation when content or container size changes.
+ *
+ * @example
+ * ```tsx
+ * <SmartTooltip title="This is a long text that might get truncated">
+ *   {({ ref }) => (
+ *     <Typography ref={ref} noWrap sx={{ overflow: 'hidden', textOverflow: 'ellipsis' }}>
+ *       This is a long text that might get truncated
+ *     </Typography>
+ *   )}
+ * </SmartTooltip>
+ * ```
+ */
 export declare function SmartTooltip<T extends HTMLElement>({ title, dependencies, timeout, TooltipProps, children, }: {
     title: string | undefined;
     dependencies?: unknown[];

package/dist/types/components/tooltip/tooltip.d.ts

@@ -10,4 +10,17 @@ import { TooltipProps } from '@mui/material';
  * </Tooltip>
  */
 export declare function Tooltip({ children, title, enterNextDelay, ...props }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Sets the global default `enterNextDelay` for all Tooltip components in the application.
+ *
+ * @param delay - Delay in milliseconds before showing tooltips on subsequent hovers.
+ *
+ * @example
+ * ```tsx
+ * import { setTooltipEnterDelay } from '@carto/ps-react-ui/components';
+ *
+ * // Set global delay to 300ms at app initialization
+ * setTooltipEnterDelay(300);
+ * ```
+ */
 export declare function setTooltipEnterDelay(delay: number): void;

package/dist/types/components/zoom-controls/zoom-controls.d.ts

@@ -1,3 +1,19 @@
 import { ZoomControlProps } from './types';
 import { JSX } from 'react';
+/**
+ * Provides intuitive zoom controls for maps and zoomable interfaces with flexible layouts, loading states, and optional reset functionality.
+ *
+ * @remarks
+ * This is an uncontrolled component. Typically used with the `ZoomControls` HOC from `@carto/ps-react-maps` for automatic state management.
+ *
+ * @example
+ * ```tsx
+ * <ZoomControlsUI
+ *   zoom={zoom}
+ *   onChange={setZoom}
+ *   minZoom={2}
+ *   maxZoom={20}
+ * />
+ * ```
+ */
 export declare function ZoomControlsUI({ zoom, disabled, direction, reverse, isLoading, maxZoom, minZoom, PaperProps, ResetViewProps, showZoom, onChange, onReset, }: ZoomControlProps): JSX.Element;

package/dist/types/hooks/use-widget-ref.d.ts

@@ -1,9 +1,9 @@
 /**
- * Custom hook for registering a DOM element ref with the widget store.
- * This allows other parts of the application to access the widget's DOM element.
+ * Registers a DOM element ref and an ECharts instance ref with the widget store.
+ * This allows other parts of the application (e.g., screenshot export) to access the widget's DOM element.
  *
- * @param widgetId - The widget ID to register the ref under
- * @returns A ref object to attach to the DOM element
+ * @param widgetId - The widget ID to register the refs under.
+ * @returns An object with `ref` (DOM element) and `instance` (ECharts instance) refs.
  *
  * @example
  * ```tsx

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/actions/download/download.d.ts

@@ -1,2 +1,13 @@
 import { DownloadProps } from './types';
+/**
+ * Dropdown menu action for exporting widget data in various formats (CSV, PNG, etc.).
+ *
+ * Reads widget data from the store and triggers downloads using the modifier
+ * function defined in each `DownloadItem`.
+ *
+ * @example
+ * ```tsx
+ * <Download id={widgetId} items={barDownloadConfig({ refUI })} />
+ * ```
+ */
 export declare function Download({ id, items, labels, Icon, IconButtonProps, }: DownloadProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/actions/download/exports.d.ts

@@ -1,6 +1,21 @@
 import { Ref } from 'react';
 import { DownloadItem } from './types';
+/**
+ * Pre-configured download item for exporting widget data as a CSV file.
+ *
+ * Converts a 2D array of data into CSV format with proper escaping and
+ * triggers a browser download. Revokes the object URL after download.
+ */
 export declare const downloadToCSV: DownloadItem<unknown[][]>;
+/**
+ * Pre-configured download item for exporting a widget as a PNG image.
+ *
+ * Uses html2canvas to capture the widget DOM element referenced by a React ref.
+ * Strips toolbar and action elements before capturing.
+ *
+ * @remarks
+ * The modifier expects a React ref to the widget's root HTML element, not raw data.
+ */
 export declare const downloadToPNG: Omit<DownloadItem, 'modifier'> & {
     modifier: (ref: Ref<HTMLElement | null> | undefined) => Promise<string | undefined>;
 };

package/dist/types/widgets/actions/fullscreen/fullscreen.d.ts

@@ -1,2 +1,15 @@
 import { FullScreenProps } from './types';
+/**
+ * Displays widget content in a fullscreen modal dialog.
+ *
+ * Manages fullscreen state via the widget store and renders a MUI Dialog
+ * with the widget title and a close button.
+ *
+ * @example
+ * ```tsx
+ * <FullScreen id="my-widget" labels={{ ariaLabel: 'Expand chart' }}>
+ *   <ChartContent id="my-widget" />
+ * </FullScreen>
+ * ```
+ */
 export declare function FullScreen({ id, labels, children, Icon, IconButtonProps, DialogContentProps: { sx, ...DialogContentProps }, DialogProps, }: FullScreenProps): import("react/jsx-runtime").JSX.Element;

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

@@ -3,7 +3,7 @@ export type { FullScreenState, FullScreenConfig } from './fullscreen/types';
 export { Download } from './download/download';
 export type { DownloadItem, DownloadProps } from './download/types';
 export { downloadToCSV, downloadToPNG } from './download/exports';
-export { RelativeData, RELATIVE_DATA_TOOL_ID, } from './relative-data/relative-data';
+export { RelativeData, RELATIVE_DATA_TOOL_ID, RELATIVE_DATA_CONFIG_TOOL_ID, } from './relative-data/relative-data';
 export type { RelativeDataProps } from './relative-data/types';
 export { ZoomToggle, ZOOM_TOGGLE_TOOL_ID } from './zoom-toggle/zoom-toggle';
 export type { ZoomToggleProps, ZoomState, ZoomConfig, } from './zoom-toggle/types';

package/dist/types/widgets/actions/relative-data/relative-data.d.ts

@@ -1,5 +1,6 @@
 import { RelativeDataProps } from './types';
 export declare const RELATIVE_DATA_TOOL_ID = "relative-data";
+export declare const RELATIVE_DATA_CONFIG_TOOL_ID = "relative-data-config";
 /**
  * Widget action to toggle between relative (percentage) and absolute data display.
  *

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

@@ -1,5 +1,9 @@
-import { BarConfig, BarWidgetConfig, BarWidgetData } from './types';
-import { DownloadItem } from '../actions';
-import { ConfigProps } from '../loader/types';
-export declare function barDownloadConfig({ refUI, }: ConfigProps): DownloadItem<BarWidgetData>[];
+import { BarConfig, BarWidgetConfig } from './types';
+export declare const barDownloadConfig: ({ refUI }: import('../loader').ConfigProps) => import('../actions').DownloadItem<import('../echart').EchartWidgetData>[];
+/**
+ * Generates ECharts configuration for bar chart widgets (vertical and horizontal), including axis, tooltip, legend, and series options styled with the CARTO theme.
+ *
+ * @param props - Bar chart configuration including data and theme.
+ * @returns Widget config with ECharts option object.
+ */
 export declare function barConfig(props: BarConfig): BarWidgetConfig;

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

@@ -1,2 +1,5 @@
 import { CategoryUIProps } from './types';
+/**
+ * Renders a category widget displaying horizontal bars for categorical data with support for single and multi-series layouts, selection, and overflow grouping.
+ */
 export declare function CategoryUI({ id }: CategoryUIProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/widgets/category/components/category-bar.d.ts

@@ -4,4 +4,7 @@ export interface CategoryBarProps {
     color: string;
     selected?: boolean;
 }
+/**
+ * Renders a single horizontal bar fill proportional to its value relative to the maximum.
+ */
 export declare function CategoryBar({ value, maxValue, color, selected, }: CategoryBarProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets/category/components/category-legend.d.ts

@@ -3,4 +3,7 @@ export interface CategoryLegendProps {
     series: CategorySeriesConfig[];
     colors: string[];
 }
+/**
+ * Renders a color-coded legend for multi-series category widgets.
+ */
 export declare function CategoryLegend({ series, colors }: CategoryLegendProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -5,7 +5,11 @@ export interface CategoryRowMultiProps {
     maxValue: number;
     colors: string[];
     formatter: NonNullable<CategoryWidgetConfig['formatter']>;
+    labelFormatter?: CategoryWidgetConfig['labelFormatter'];
     onClick?: CategoryWidgetConfig['onRowClick'];
     selected?: boolean;
 }
-export declare function CategoryRowMulti({ name, values, maxValue, colors, formatter, onClick, selected, }: CategoryRowMultiProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * 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, labelFormatter, onClick, selected, }: CategoryRowMultiProps): import("react/jsx-runtime").JSX.Element;

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

@@ -3,4 +3,7 @@ export interface CategoryRowOtherProps {
     otherLabel?: string;
     otherCountLabel?: string;
 }
+/**
+ * Renders an "Other" summary row indicating how many additional categories are hidden beyond `maxItems`.
+ */
 export declare function CategoryRowOther({ hiddenCount, otherLabel, otherCountLabel, }: CategoryRowOtherProps): import("react/jsx-runtime").JSX.Element;

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

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

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

@@ -4,6 +4,17 @@ import { CategoryWidgetConfig, CategoryWidgetData, CategorySeriesConfig } from '
 interface CategoryDownloadConfigProps extends ConfigProps {
     series?: CategorySeriesConfig[];
 }
+/**
+ * Creates download configuration for category widgets, supporting PNG (screenshot) and CSV (data) exports. CSV output groups values by category across multiple series.
+ *
+ * @param props - Configuration with `refUI` reference and optional `series` for CSV column headers.
+ * @returns Array of download items for use with the Download action.
+ */
 export declare function categoryDownloadConfig({ refUI, series, }: CategoryDownloadConfigProps): DownloadItem<CategoryWidgetData>[];
+/**
+ * Returns the default configuration for category list widgets, including empty series and a default `maxItems` of 10.
+ *
+ * @returns Default category widget config.
+ */
 export declare function categoryConfig(): CategoryWidgetConfig;
 export {};

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/echart-ui.d.ts

@@ -1,2 +1,9 @@
 import { EchartUIProps } from './types';
+/**
+ * Presentational component that initializes and manages an Apache ECharts instance.
+ *
+ * @remarks
+ * Handles chart lifecycle (init, dispose), option updates, resize observation, and event listener management.
+ * Uses SVG renderer with a default height of 304px.
+ */
 export declare function EchartUI(props: EchartUIProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,2 +1,8 @@
 import { EchartProps } from './types';
+/**
+ * Stateful EChart widget component that reads data and options from the widget store and renders an ECharts chart.
+ *
+ * @remarks
+ * Transforms widget data into ECharts dataset format and delegates rendering to {@link EchartUI}.
+ */
 export declare function Echart(props: EchartProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -1,2 +1,9 @@
 import { EchartOptionsProps, EchartWidgetOptionProps } from './types';
+/**
+ * Returns the shared base ECharts options used across all EChart-based widgets (bar, pie, histogram, etc.).
+ *
+ * @remarks
+ * Configures grid spacing, tooltip styling, legend, axis pointer, and the default color palette
+ * derived from the MUI theme.
+ */
 export declare function getCommonOptions({ theme, }: EchartWidgetOptionProps<unknown>): EchartOptionsProps;

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

@@ -27,9 +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;
 }