@sproutsocial/seeds-react-data-viz 0.22.2 → 0.23.0

package/dist/bar/index.d.mts

@@ -49,8 +49,6 @@ interface BarChartProps {
     timezone?: string;
     /** Stacking mode. `"normal"` stacks series (default); `"percent"` normalizes to 100%; `"grouped"` renders adjacent bars. */
     stacking?: "normal" | "percent" | "grouped";
-    /** Appended to each tooltip value (e.g., `" MT"`, `"%"`). */
-    valueSuffix?: string;
     /** Override for the default tooltip content. */
     tooltip?: (args: ChartTooltipProps) => ReactNode;
     /** Declarative annotations rendered at positions on the chart. */

package/dist/bar/index.d.ts

@@ -49,8 +49,6 @@ interface BarChartProps {
     timezone?: string;
     /** Stacking mode. `"normal"` stacks series (default); `"percent"` normalizes to 100%; `"grouped"` renders adjacent bars. */
     stacking?: "normal" | "percent" | "grouped";
-    /** Appended to each tooltip value (e.g., `" MT"`, `"%"`). */
-    valueSuffix?: string;
     /** Override for the default tooltip content. */
     tooltip?: (args: ChartTooltipProps) => ReactNode;
     /** Declarative annotations rendered at positions on the chart. */

package/dist/bar/index.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunkKMJD7BW3js = require('../chunk-KMJD7BW3.js');
+var _chunk6SF6OYQAjs = require('../chunk-6SF6OYQA.js');
 
 
 
@@ -17,7 +17,7 @@ var _chunk33Y5FZTTjs = require('../chunk-33Y5FZTT.js');
 
 
 
-var _chunkGWP3PWIGjs = require('../chunk-GWP3PWIG.js');
+var _chunkGQOKCB3Mjs = require('../chunk-GQOKCB3M.js');
 require('../chunk-2H2Z7PKZ.js');
 
 // src/charts/bar/BarChart.tsx
@@ -32,7 +32,7 @@ function buildBarChartOptions(props, direction, series = props.series) {
   const isDatetime = props.xAxis.type === "datetime";
   const isMultiSeries = series.length > 1;
   const tooltipTimezone = _chunk6D7P3IOTjs.resolveTooltipTimezone.call(void 0, props.xAxis, props.timezone);
-  const { annotations, lookup: annotationLookup } = _chunkKMJD7BW3js.buildAnnotationConfig.call(void 0, 
+  const { annotations, lookup: annotationLookup } = _chunk6SF6OYQAjs.buildAnnotationConfig.call(void 0, 
     props.annotations
   );
   const barTypeConfig = {
@@ -92,10 +92,9 @@ function buildBarChartOptions(props, direction, series = props.series) {
       }
     }
   };
-  const base = _chunkGWP3PWIGjs.buildBaseChartOptions.call(void 0, {
+  const base = _chunkGQOKCB3Mjs.buildBaseChartOptions.call(void 0, {
     type: chartType,
     description: props.description,
-    valueSuffix: props.valueSuffix,
     reserveTopMargin: Boolean(annotations),
     timezone: tooltipTimezone
   });
@@ -128,7 +127,7 @@ function buildBarChartOptions(props, direction, series = props.series) {
         enabled: _optionalChain([props, 'access', _23 => _23.yAxis, 'optionalAccess', _24 => _24.showLabels]) !== false,
         // A declarative `format` drives ticks through the shared valueFormatter;
         // absent it, the zero-config decimal default (1.20K / 1.20M / 1.20B).
-        formatter: _optionalChain([props, 'access', _25 => _25.yAxis, 'optionalAccess', _26 => _26.format]) ? _chunkKMJD7BW3js.makeValueAxisLabelFormatter.call(void 0, props.yAxis.format) : _chunkKMJD7BW3js.defaultValueAxisLabelFormatter
+        formatter: _optionalChain([props, 'access', _25 => _25.yAxis, 'optionalAccess', _26 => _26.format]) ? _chunk6SF6OYQAjs.makeValueAxisLabelFormatter.call(void 0, props.yAxis.format) : _chunk6SF6OYQAjs.defaultValueAxisLabelFormatter
       }
     },
     plotOptions: {
@@ -153,7 +152,7 @@ var BAR_CHART_DEFAULT_SERIES_LIMIT = 10;
 var _jsxruntime = require('react/jsx-runtime');
 var BarChart = _react.memo.call(void 0, function BarChart2(props) {
   const seriesLimit = _nullishCoalesce(props.seriesLimit, () => ( BAR_CHART_DEFAULT_SERIES_LIMIT));
-  const { colors, series } = _chunkGWP3PWIGjs.useSeedsChartSetup.call(void 0, {
+  const { colors, series } = _chunkGQOKCB3Mjs.useSeedsChartSetup.call(void 0, {
     series: props.series,
     seriesLimit,
     isSeriesLimitOverridden: props.seriesLimit !== void 0,
@@ -173,7 +172,7 @@ var BarChart = _react.memo.call(void 0, function BarChart2(props) {
     className: props.className
   });
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ...containerProps, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkGWP3PWIGjs.ChartRenderer,
+    _chunkGQOKCB3Mjs.ChartRenderer,
     {
       options,
       series,

package/dist/bar/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/bar/index.js","../../src/charts/bar/BarChart.tsx","../../src/charts/bar/adapter.ts","../../src/charts/constants.ts"],"names":["BarChart"],"mappings":"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","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/bar/index.js","sourcesContent":[null,"import { memo } from \"react\";\nimport { useSeedsChartSetup, ChartRenderer } from \"../shared/chartBase\";\nimport { getChartContainerProps } from \"../shared/chartContainer\";\nimport { buildBarChartOptions } from \"./adapter\";\nimport type { BarChartProps } from \"./types\";\nimport { BAR_CHART_DEFAULT_SERIES_LIMIT } from \"../constants\";\n\nexport const BarChart = memo(function BarChart(props: BarChartProps) {\n  // The shared hook caps the series to the limit (and warns once per render\n  // when the default is exceeded without an explicit override) so the adapter\n  // and renderer below all consume the capped data.\n  const seriesLimit = props.seriesLimit ?? BAR_CHART_DEFAULT_SERIES_LIMIT;\n  const { colors, series } = useSeedsChartSetup({\n    series: props.series,\n    seriesLimit,\n    isSeriesLimitOverridden: props.seriesLimit !== undefined,\n    hideSeriesLimitWarning: props.hideSeriesLimitWarning,\n    componentName: \"BarChart\",\n  });\n\n  const { options, annotationLookup, tooltipTimezone } = buildBarChartOptions(\n    props,\n    props.direction ?? \"vertical\",\n    series\n  );\n  const hasOnClick = Boolean(props.onClick);\n\n  // Plain <div> consuming the shared chart-styles.css contract via\n  // getChartContainerProps. Colors are the RAW per-series colors (undefined when\n  // unset, so only explicit overrides inline --highcharts-color-N), NOT the\n  // palette-resolved `colors` passed to ChartRenderer. Neither stylesheet is\n  // self-imported (consumers import both).\n  const containerProps = getChartContainerProps({\n    familyClasses: [\"seeds-chart-time-series\", \"seeds-chart-bar\"],\n    colors: series.map((s) => s.color),\n    hasOnClick,\n    className: props.className,\n  });\n\n  return (\n    <div {...containerProps}>\n      <ChartRenderer\n        options={options}\n        series={series}\n        colors={colors}\n        tooltip={props.tooltip}\n        annotationLookup={annotationLookup}\n        hasOnClick={hasOnClick}\n        tooltipClickLabel={props.tooltipClickLabel}\n        timezone={tooltipTimezone}\n        invalidNumberLabel={props.invalidNumberLabel}\n        valueFormat={props.yAxis?.format}\n        exportTitle={props.exportTitle}\n        onReady={props.onReady}\n      />\n    </div>\n  );\n});\n","import { buildAnnotationConfig } from \"../shared/annotations\";\nimport type { ChartAnnotationLookup } from \"../shared/annotations\";\nimport type {\n  SeedsChartColumnPlotOptions,\n  SeedsChartOptions,\n} from \"../shared/chartBase\";\nimport { buildBaseChartOptions } from \"../shared/baseChartOptions\";\nimport { TIME_SERIES_CHART_HEIGHT } from \"../../constants/chartOptions\";\nimport {\n  buildDimensionalAxis,\n  resolveTooltipTimezone,\n} from \"../shared/axisOptions\";\nimport {\n  defaultValueAxisLabelFormatter,\n  makeValueAxisLabelFormatter,\n} from \"../shared/valueAxisLabelFormatter\";\nimport type { BarChartDirection, BarChartProps } from \"./types\";\n\n// Maps the public `direction` to the Highcharts series/chart type. Highcharts\n// `bar` is a horizontally-oriented `column`: it performs the visual rotation\n// while keeping axis roles (xAxis = category, yAxis = value), so the rest of the\n// adapter is direction-agnostic.\nfunction highchartsType(direction: BarChartDirection): \"column\" | \"bar\" {\n  return direction === \"horizontal\" ? \"bar\" : \"column\";\n}\n\nexport function buildBarChartOptions(\n  props: BarChartProps,\n  direction: BarChartDirection,\n  // The (already-capped) series to render. Defaults to `props.series` so the\n  // ~40 existing call sites keep working; the component passes the capped\n  // series from `useSeedsChartSetup` explicitly.\n  series: BarChartProps[\"series\"] = props.series\n): {\n  options: SeedsChartOptions;\n  annotationLookup: ChartAnnotationLookup | undefined;\n  /** Resolved timezone for the tooltip date formatter; undefined on category axes. */\n  tooltipTimezone: string | undefined;\n} {\n  const chartType = highchartsType(direction);\n  const isDatetime = props.xAxis.type === \"datetime\";\n  // Gate the `onMouseEnter`/`onMouseLeave` `series` field on the *rendered*\n  // (already-capped) series count, not `props.series` — if `seriesLimit` caps a\n  // multi-series input down to one rendered series the chart is effectively\n  // single-series, and `series` must be absent per the \"present only for\n  // multi-series bar\" contract.\n  const isMultiSeries = series.length > 1;\n  const tooltipTimezone = resolveTooltipTimezone(props.xAxis, props.timezone);\n  const { annotations, lookup: annotationLookup } = buildAnnotationConfig(\n    props.annotations\n  );\n  // `column` (vertical) and `bar` (horizontal) take the same option shape, so a\n  // single config is assigned under the active direction's key. Typed\n  // explicitly so the `point.events` handlers below keep their `this`/`event`\n  // contextual types (a computed `[chartType]` key would otherwise erase them).\n  const barTypeConfig: SeedsChartColumnPlotOptions = {\n    // \"grouped\" maps to omitting `stacking` — Highcharts renders multi-series\n    // columns side-by-side when no stacking is set.\n    ...(props.stacking === \"grouped\"\n      ? {}\n      : { stacking: props.stacking ?? \"normal\" }),\n    // Horizontal bars are height-constrained (fixed chart height ÷ categories),\n    // so the same padding fractions that work for columns produce hairline bars.\n    pointPadding: direction === \"horizontal\" ? 0.05 : 0.25,\n    groupPadding: direction === \"horizontal\" ? 0.1 : 0.25,\n    // Fixed bar width on datetime axes. Sparse time-series otherwise size\n    // columns from the (large) gap between points and balloon; a fixed\n    // pointWidth: 20 gives a consistent time-series treatment. Dense datetime\n    // data may instead want a maxPointWidth cap — revisit when Line/Area land.\n    ...(isDatetime ? { pointWidth: 20 } : {}),\n    borderRadius: 4,\n    borderWidth: 0,\n    // Pairs with the `:hover` dimming rule in `styles.ts`: while the cursor\n    // is over the chart, all bars dim; these handlers restore opacity for\n    // every bar at the hovered x (so stacked/grouped bars highlight together\n    // rather than just the single hovered bar).\n    point: {\n      events: {\n        click: props.onClick\n          ? (event) => props.onClick!({ position: event.point.x })\n          : undefined,\n        mouseOver: function () {\n          const x = this.x;\n          props.onMouseEnter?.({\n            position: x,\n            // Omit the key entirely (not `series: undefined`) for single-series\n            // so consumers testing `\"series\" in payload` see the contract.\n            ...(isMultiSeries\n              ? {\n                  series: { name: this.series.name, index: this.series.index },\n                }\n              : {}),\n          });\n          this.series.chart.series.forEach((s) => {\n            if (s.type !== chartType) return;\n            s.data.forEach((point) => {\n              if (point.x !== x) return;\n              point.graphic?.element?.classList.add(\"bar-point-hover\");\n            });\n          });\n        },\n        mouseOut: function () {\n          props.onMouseLeave?.({\n            position: this.x,\n            ...(isMultiSeries\n              ? {\n                  series: { name: this.series.name, index: this.series.index },\n                }\n              : {}),\n          });\n          this.series.chart.series.forEach((s) => {\n            if (s.type !== chartType) return;\n            s.data.forEach((point) => {\n              point.graphic?.element?.classList.remove(\"bar-point-hover\");\n            });\n          });\n        },\n      },\n    },\n  };\n  const base = buildBaseChartOptions({\n    type: chartType,\n    description: props.description,\n    valueSuffix: props.valueSuffix,\n    reserveTopMargin: Boolean(annotations),\n    timezone: tooltipTimezone,\n  });\n\n  const options: SeedsChartOptions = {\n    ...base,\n    // Default height baseline (overridable via `props.height`) so consumers\n    // who don't configure sizing keep the design-reviewed default.\n    chart: {\n      ...base.chart,\n      // Re-assert the definite `type` so spreading the optionally-typed\n      // `base.chart` doesn't widen the required `type` field to optional.\n      type: chartType,\n      height: props.height ?? TIME_SERIES_CHART_HEIGHT,\n      // Tight time-series spacing (from constants/chartOptions.ts) so the plot\n      // area fills the 275px container; without it Highcharts' larger default\n      // spacing ([10, 10, 15, 10]) shrinks the plot area.\n      spacing: [5, 1, 0, 2],\n    },\n    xAxis: buildDimensionalAxis(props.xAxis, tooltipTimezone ?? \"UTC\"),\n    yAxis: {\n      min: props.yAxis?.min,\n      max: props.yAxis?.max,\n      gridLineWidth: props.yAxis?.showGridLines === false ? 0 : 1,\n      // A dedicated plotLine at 0, styled distinctly from regular gridlines\n      // (see chartStyles.ts).\n      plotLines: [{ value: 0, className: \"y-axis-zero-line\", zIndex: 3 }],\n      title: { text: props.yAxis?.title ?? \"\" },\n      labels: {\n        // `showLabels` toggles tick-label visibility; defaults to shown.\n        enabled: props.yAxis?.showLabels !== false,\n        // A declarative `format` drives ticks through the shared valueFormatter;\n        // absent it, the zero-config decimal default (1.20K / 1.20M / 1.20B).\n        formatter: props.yAxis?.format\n          ? makeValueAxisLabelFormatter(props.yAxis.format)\n          : defaultValueAxisLabelFormatter,\n      },\n    },\n    plotOptions: {\n      series: { animation: false },\n      [chartType]: barTypeConfig,\n    },\n    series: series.map((s) => ({\n      type: chartType,\n      name: s.name,\n      data: [...s.data],\n      color: s.color,\n    })),\n    ...(annotations ? { annotations } : {}),\n  };\n\n  return { options, annotationLookup, tooltipTimezone };\n}\n","export const BAR_CHART_DEFAULT_SERIES_LIMIT = 10;\n"]}
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/bar/index.js","../../src/charts/bar/BarChart.tsx","../../src/charts/bar/adapter.ts","../../src/charts/constants.ts"],"names":["BarChart"],"mappings":"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","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/bar/index.js","sourcesContent":[null,"import { memo } from \"react\";\nimport { useSeedsChartSetup, ChartRenderer } from \"../shared/chartBase\";\nimport { getChartContainerProps } from \"../shared/chartContainer\";\nimport { buildBarChartOptions } from \"./adapter\";\nimport type { BarChartProps } from \"./types\";\nimport { BAR_CHART_DEFAULT_SERIES_LIMIT } from \"../constants\";\n\nexport const BarChart = memo(function BarChart(props: BarChartProps) {\n  // The shared hook caps the series to the limit (and warns once per render\n  // when the default is exceeded without an explicit override) so the adapter\n  // and renderer below all consume the capped data.\n  const seriesLimit = props.seriesLimit ?? BAR_CHART_DEFAULT_SERIES_LIMIT;\n  const { colors, series } = useSeedsChartSetup({\n    series: props.series,\n    seriesLimit,\n    isSeriesLimitOverridden: props.seriesLimit !== undefined,\n    hideSeriesLimitWarning: props.hideSeriesLimitWarning,\n    componentName: \"BarChart\",\n  });\n\n  const { options, annotationLookup, tooltipTimezone } = buildBarChartOptions(\n    props,\n    props.direction ?? \"vertical\",\n    series\n  );\n  const hasOnClick = Boolean(props.onClick);\n\n  // Plain <div> consuming the shared chart-styles.css contract via\n  // getChartContainerProps. Colors are the RAW per-series colors (undefined when\n  // unset, so only explicit overrides inline --highcharts-color-N), NOT the\n  // palette-resolved `colors` passed to ChartRenderer. Neither stylesheet is\n  // self-imported (consumers import both).\n  const containerProps = getChartContainerProps({\n    familyClasses: [\"seeds-chart-time-series\", \"seeds-chart-bar\"],\n    colors: series.map((s) => s.color),\n    hasOnClick,\n    className: props.className,\n  });\n\n  return (\n    <div {...containerProps}>\n      <ChartRenderer\n        options={options}\n        series={series}\n        colors={colors}\n        tooltip={props.tooltip}\n        annotationLookup={annotationLookup}\n        hasOnClick={hasOnClick}\n        tooltipClickLabel={props.tooltipClickLabel}\n        timezone={tooltipTimezone}\n        invalidNumberLabel={props.invalidNumberLabel}\n        valueFormat={props.yAxis?.format}\n        exportTitle={props.exportTitle}\n        onReady={props.onReady}\n      />\n    </div>\n  );\n});\n","import { buildAnnotationConfig } from \"../shared/annotations\";\nimport type { ChartAnnotationLookup } from \"../shared/annotations\";\nimport type {\n  SeedsChartColumnPlotOptions,\n  SeedsChartOptions,\n} from \"../shared/chartBase\";\nimport { buildBaseChartOptions } from \"../shared/baseChartOptions\";\nimport { TIME_SERIES_CHART_HEIGHT } from \"../../constants/chartOptions\";\nimport {\n  buildDimensionalAxis,\n  resolveTooltipTimezone,\n} from \"../shared/axisOptions\";\nimport {\n  defaultValueAxisLabelFormatter,\n  makeValueAxisLabelFormatter,\n} from \"../shared/valueAxisLabelFormatter\";\nimport type { BarChartDirection, BarChartProps } from \"./types\";\n\n// Maps the public `direction` to the Highcharts series/chart type. Highcharts\n// `bar` is a horizontally-oriented `column`: it performs the visual rotation\n// while keeping axis roles (xAxis = category, yAxis = value), so the rest of the\n// adapter is direction-agnostic.\nfunction highchartsType(direction: BarChartDirection): \"column\" | \"bar\" {\n  return direction === \"horizontal\" ? \"bar\" : \"column\";\n}\n\nexport function buildBarChartOptions(\n  props: BarChartProps,\n  direction: BarChartDirection,\n  // The (already-capped) series to render. Defaults to `props.series` so the\n  // ~40 existing call sites keep working; the component passes the capped\n  // series from `useSeedsChartSetup` explicitly.\n  series: BarChartProps[\"series\"] = props.series\n): {\n  options: SeedsChartOptions;\n  annotationLookup: ChartAnnotationLookup | undefined;\n  /** Resolved timezone for the tooltip date formatter; undefined on category axes. */\n  tooltipTimezone: string | undefined;\n} {\n  const chartType = highchartsType(direction);\n  const isDatetime = props.xAxis.type === \"datetime\";\n  // Gate the `onMouseEnter`/`onMouseLeave` `series` field on the *rendered*\n  // (already-capped) series count, not `props.series` — if `seriesLimit` caps a\n  // multi-series input down to one rendered series the chart is effectively\n  // single-series, and `series` must be absent per the \"present only for\n  // multi-series bar\" contract.\n  const isMultiSeries = series.length > 1;\n  const tooltipTimezone = resolveTooltipTimezone(props.xAxis, props.timezone);\n  const { annotations, lookup: annotationLookup } = buildAnnotationConfig(\n    props.annotations\n  );\n  // `column` (vertical) and `bar` (horizontal) take the same option shape, so a\n  // single config is assigned under the active direction's key. Typed\n  // explicitly so the `point.events` handlers below keep their `this`/`event`\n  // contextual types (a computed `[chartType]` key would otherwise erase them).\n  const barTypeConfig: SeedsChartColumnPlotOptions = {\n    // \"grouped\" maps to omitting `stacking` — Highcharts renders multi-series\n    // columns side-by-side when no stacking is set.\n    ...(props.stacking === \"grouped\"\n      ? {}\n      : { stacking: props.stacking ?? \"normal\" }),\n    // Horizontal bars are height-constrained (fixed chart height ÷ categories),\n    // so the same padding fractions that work for columns produce hairline bars.\n    pointPadding: direction === \"horizontal\" ? 0.05 : 0.25,\n    groupPadding: direction === \"horizontal\" ? 0.1 : 0.25,\n    // Fixed bar width on datetime axes. Sparse time-series otherwise size\n    // columns from the (large) gap between points and balloon; a fixed\n    // pointWidth: 20 gives a consistent time-series treatment. Dense datetime\n    // data may instead want a maxPointWidth cap — revisit when Line/Area land.\n    ...(isDatetime ? { pointWidth: 20 } : {}),\n    borderRadius: 4,\n    borderWidth: 0,\n    // Pairs with the `:hover` dimming rule in `styles.ts`: while the cursor\n    // is over the chart, all bars dim; these handlers restore opacity for\n    // every bar at the hovered x (so stacked/grouped bars highlight together\n    // rather than just the single hovered bar).\n    point: {\n      events: {\n        click: props.onClick\n          ? (event) => props.onClick!({ position: event.point.x })\n          : undefined,\n        mouseOver: function () {\n          const x = this.x;\n          props.onMouseEnter?.({\n            position: x,\n            // Omit the key entirely (not `series: undefined`) for single-series\n            // so consumers testing `\"series\" in payload` see the contract.\n            ...(isMultiSeries\n              ? {\n                  series: { name: this.series.name, index: this.series.index },\n                }\n              : {}),\n          });\n          this.series.chart.series.forEach((s) => {\n            if (s.type !== chartType) return;\n            s.data.forEach((point) => {\n              if (point.x !== x) return;\n              point.graphic?.element?.classList.add(\"bar-point-hover\");\n            });\n          });\n        },\n        mouseOut: function () {\n          props.onMouseLeave?.({\n            position: this.x,\n            ...(isMultiSeries\n              ? {\n                  series: { name: this.series.name, index: this.series.index },\n                }\n              : {}),\n          });\n          this.series.chart.series.forEach((s) => {\n            if (s.type !== chartType) return;\n            s.data.forEach((point) => {\n              point.graphic?.element?.classList.remove(\"bar-point-hover\");\n            });\n          });\n        },\n      },\n    },\n  };\n  const base = buildBaseChartOptions({\n    type: chartType,\n    description: props.description,\n    reserveTopMargin: Boolean(annotations),\n    timezone: tooltipTimezone,\n  });\n\n  const options: SeedsChartOptions = {\n    ...base,\n    // Default height baseline (overridable via `props.height`) so consumers\n    // who don't configure sizing keep the design-reviewed default.\n    chart: {\n      ...base.chart,\n      // Re-assert the definite `type` so spreading the optionally-typed\n      // `base.chart` doesn't widen the required `type` field to optional.\n      type: chartType,\n      height: props.height ?? TIME_SERIES_CHART_HEIGHT,\n      // Tight time-series spacing (from constants/chartOptions.ts) so the plot\n      // area fills the 275px container; without it Highcharts' larger default\n      // spacing ([10, 10, 15, 10]) shrinks the plot area.\n      spacing: [5, 1, 0, 2],\n    },\n    xAxis: buildDimensionalAxis(props.xAxis, tooltipTimezone ?? \"UTC\"),\n    yAxis: {\n      min: props.yAxis?.min,\n      max: props.yAxis?.max,\n      gridLineWidth: props.yAxis?.showGridLines === false ? 0 : 1,\n      // A dedicated plotLine at 0, styled distinctly from regular gridlines\n      // (see chartStyles.ts).\n      plotLines: [{ value: 0, className: \"y-axis-zero-line\", zIndex: 3 }],\n      title: { text: props.yAxis?.title ?? \"\" },\n      labels: {\n        // `showLabels` toggles tick-label visibility; defaults to shown.\n        enabled: props.yAxis?.showLabels !== false,\n        // A declarative `format` drives ticks through the shared valueFormatter;\n        // absent it, the zero-config decimal default (1.20K / 1.20M / 1.20B).\n        formatter: props.yAxis?.format\n          ? makeValueAxisLabelFormatter(props.yAxis.format)\n          : defaultValueAxisLabelFormatter,\n      },\n    },\n    plotOptions: {\n      series: { animation: false },\n      [chartType]: barTypeConfig,\n    },\n    series: series.map((s) => ({\n      type: chartType,\n      name: s.name,\n      data: [...s.data],\n      color: s.color,\n    })),\n    ...(annotations ? { annotations } : {}),\n  };\n\n  return { options, annotationLookup, tooltipTimezone };\n}\n","export const BAR_CHART_DEFAULT_SERIES_LIMIT = 10;\n"]}

package/dist/bubble/index.js

@@ -11,7 +11,7 @@ var _chunk33Y5FZTTjs = require('../chunk-33Y5FZTT.js');
 
 
 
-var _chunkGWP3PWIGjs = require('../chunk-GWP3PWIG.js');
+var _chunkGQOKCB3Mjs = require('../chunk-GQOKCB3M.js');
 require('../chunk-2H2Z7PKZ.js');
 
 // src/charts/bubble/BubbleChart.tsx
@@ -107,7 +107,7 @@ function mapBubbleTooltipRow(data) {
 }
 function buildBubbleChartOptions(props) {
   const hasOnClick = Boolean(props.onClick);
-  const base = _chunkGWP3PWIGjs.buildBaseChartOptions.call(void 0, {
+  const base = _chunkGQOKCB3Mjs.buildBaseChartOptions.call(void 0, {
     type: "packedbubble",
     description: props.accessibility.description,
     svgContainerLabel: props.accessibility.svgContainerLabel,
@@ -182,7 +182,7 @@ function buildBubbleChartOptions(props) {
 // src/charts/bubble/BubbleChart.tsx
 var _jsxruntime = require('react/jsx-runtime');
 var BubbleChart = _react.memo.call(void 0, function BubbleChart2(props) {
-  const { colors } = _chunkGWP3PWIGjs.useSeedsChartSetup.call(void 0, {
+  const { colors } = _chunkGQOKCB3Mjs.useSeedsChartSetup.call(void 0, {
     series: props.data.map((d) => ({ color: d.color }))
   });
   const options = _react.useMemo.call(void 0, () => buildBubbleChartOptions(props), [props]);
@@ -206,7 +206,7 @@ var BubbleChart = _react.memo.call(void 0, function BubbleChart2(props) {
       ...hasOnPlotBackgroundClick ? { "data-has-on-plot-background-click": "" } : {},
       onClick: props.onPlotBackgroundClick,
       children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-        _chunkGWP3PWIGjs.ChartRenderer,
+        _chunkGQOKCB3Mjs.ChartRenderer,
         {
           options,
           series: props.data.map((d, i) => ({

package/dist/{chunk-KMJD7BW3.js → chunk-6SF6OYQA.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkGWP3PWIGjs = require('./chunk-GWP3PWIG.js');
+var _chunkGQOKCB3Mjs = require('./chunk-GQOKCB3M.js');
 
 // src/charts/shared/annotations.ts
 function buildAnnotationConfig(annotations) {
@@ -56,7 +56,7 @@ function makeValueAxisLabelFormatter(format) {
   return function() {
     const numberValue = Number(this.value);
     const abbreviate = format.abbreviate === false ? false : deriveAbbreviateFromTicks(this);
-    return _chunkGWP3PWIGjs.valueFormatter.call(void 0, { ...format, value: numberValue, abbreviate });
+    return _chunkGQOKCB3Mjs.valueFormatter.call(void 0, { ...format, value: numberValue, abbreviate });
   };
 }
 
@@ -65,4 +65,4 @@ function makeValueAxisLabelFormatter(format) {
 
 
 exports.buildAnnotationConfig = buildAnnotationConfig; exports.defaultValueAxisLabelFormatter = defaultValueAxisLabelFormatter; exports.makeValueAxisLabelFormatter = makeValueAxisLabelFormatter;
-//# sourceMappingURL=chunk-KMJD7BW3.js.map
+//# sourceMappingURL=chunk-6SF6OYQA.js.map

package/dist/{chunk-KMJD7BW3.js.map → chunk-6SF6OYQA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-KMJD7BW3.js","../src/charts/shared/annotations.ts","../src/charts/shared/valueAxisLabelFormatter.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACkCO,SAAS,qBAAA,CACd,WAAA,EAIA;AACA,EAAA,GAAA,CAAI,iBAAC,WAAA,2BAAa,QAAA,EAAQ;AACxB,IAAA,OAAO,EAAE,WAAA,EAAa,KAAA,CAAA,EAAW,MAAA,EAAQ,KAAA,EAAU,CAAA;AAAA,EACrD;AACA,EAAA,MAAM,OAAA,EAGA,CAAC,CAAA;AACP,EAAA,MAAM,OAAA,kBAAgC,IAAI,GAAA,CAAI,CAAA;AAC9C,EAAA,IAAA,CAAA,MAAW,WAAA,GAAc,WAAA,EAAa;AACpC,IAAA,MAAM,EAAE,SAAS,EAAA,EAAI,UAAA;AACrB,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA;AAAA,MAEV,KAAA,EAAO,EAAE,CAAA,EAAG,QAAA,EAAU,CAAA,EAAG,CAAA,EAAG,KAAA,EAAO,CAAA,EAAG,KAAA,EAAO,EAAE,CAAA;AAAA;AAAA,MAE/C,IAAA,EAAM;AAAA,IACR,CAAC,CAAA;AAID,IAAA,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,UAAU,CAAA;AAAA,EACjC;AACA,EAAA,GAAA,CAAI,MAAA,CAAO,OAAA,IAAW,CAAA,EAAG;AACvB,IAAA,OAAO,EAAE,WAAA,EAAa,KAAA,CAAA,EAAW,MAAA,EAAQ,KAAA,EAAU,CAAA;AAAA,EACrD;AACA,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA,IAIL,WAAA,EAAa,CAAC,EAAE,MAAA,EAAQ,YAAA,EAAc,EAAE,OAAA,EAAS,IAAA,EAAM,OAAA,EAAS,EAAE,EAAE,CAAC,CAAA;AAAA,IACrE;AAAA,EACF,CAAA;AACF;AD3CA;AACA;AEjCA,sEAA8B;AAW9B,IAAM,aAAA,EAAe,OAAA;AAWrB,SAAS,yBAAA,CACP,OAAA,EACkB;AAClB,EAAA,MAAM,cAAA,EAAgB,OAAA,CAAQ,IAAA,CAAK,aAAA;AACnC,EAAA,MAAM,SAAA,EACJ,cAAA,GAAiB,aAAA,CAAc,OAAA,EAAS,EAAA,EACpC,aAAA,CAAc,aAAA,CAAc,OAAA,EAAS,CAAC,EAAA,EACtC,KAAA,CAAA;AACN,EAAA,OAAO,OAAO,SAAA,IAAa,SAAA,GAAY,SAAA,EAAW,KAAA,EAAO,IAAA,EAAO,IAAA;AAClE;AAWO,SAAS,8BAAA,CAAA,EAEN;AACR,EAAA,MAAM,YAAA,EAAc,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA;AAErC,EAAA,GAAA,CAAI,YAAA,IAAgB,CAAA,EAAG;AACrB,IAAA,OAAO,8CAAA,EAAgB,MAAA,EAAQ,YAAA,EAAc,MAAA,EAAQ,EAAE,CAAC,CAAA;AAAA,EAC1D;AAEA,EAAA,MAAM,WAAA,EAAa,yBAAA,CAA0B,IAAI,CAAA;AAEjD,EAAA,OAAO,8CAAA;AAAc,IACnB,UAAA;AAAA,IACA,MAAA,EAAQ,SAAA;AAAA,IACR,MAAA,EAAQ,YAAA;AAAA,IACR,MAAA,EAAQ;AAAA,EACV,CAAC,CAAA;AACH;AAYO,SAAS,2BAAA,CAA4B,MAAA,EAAqB;AAC/D,EAAA,OAAO,QAAA,CAAA,EAAwD;AAC7D,IAAA,MAAM,YAAA,EAAc,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA;AAMrC,IAAA,MAAM,WAAA,EACJ,MAAA,CAAO,WAAA,IAAe,MAAA,EAAQ,MAAA,EAAQ,yBAAA,CAA0B,IAAI,CAAA;AAEtE,IAAA,OAAO,6CAAA,EAAiB,GAAG,MAAA,EAAQ,KAAA,EAAO,WAAA,EAAa,WAAW,CAAC,CAAA;AAAA,EACrE,CAAA;AACF;AFvBA;AACA;AACE;AACA;AACA;AACF,kMAAC","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-KMJD7BW3.js","sourcesContent":[null,"// Shared annotation plumbing across v2 chart families. Currently consumed by\n// BarChart; v2 Line/Area will share the same `annotations` shape and reuse\n// `buildAnnotationConfig` directly. Annotation data is purely numeric —\n// the module has no knowledge of `categories`; resolving a numeric position to\n// a display name is the tooltip's job (see chartBase `renderContent`).\n\nimport type { TypeIconName } from \"@sproutsocial/seeds-react-icon\";\nimport type { SeedsChartAnnotationsOptions } from \"./chartBase\";\n\n/**\n * Annotations keyed by the numeric Highcharts index. Both consumers resolve\n * numerically: the marker portal reads `label.point.x` and the tooltip reads\n * `context.point.x` (numeric on both category and datetime axes).\n */\nexport type ChartAnnotationLookup = Map<number, ChartAnnotation>;\n\n/**\n * Declarative annotation shape — the DS renders the marker and tooltip header\n * internally; consumers don't supply render functions. See CE-7.\n */\nexport interface ChartAnnotation {\n  /** Numeric x-axis coordinate — a category index (category axes) or the raw coordinate (datetime/linear axes). */\n  position: number;\n  /** Icon shown above the chart at `position` and inline with `title` in the tooltip header. */\n  icon?: TypeIconName;\n  /** Color applied to the marker's vertical line. */\n  color?: string;\n  /** Tooltip header line 1. */\n  title?: string;\n  /** Tooltip header line 2. */\n  description?: string;\n}\n\n/**\n * Build the Highcharts `annotations` config and a parallel lookup keyed by the\n * numeric `position`. Both consumers (chart adapter for Highcharts, ChartRenderer\n * for the portal + tooltip) read from the same numeric lookup to stay aligned.\n */\nexport function buildAnnotationConfig(\n  annotations: ChartAnnotation[] | undefined\n): {\n  annotations: SeedsChartAnnotationsOptions[] | undefined;\n  lookup: ChartAnnotationLookup | undefined;\n} {\n  if (!annotations?.length) {\n    return { annotations: undefined, lookup: undefined };\n  }\n  const labels: {\n    point: { x: number; y: number; xAxis: 0; yAxis: 0 };\n    text: string;\n  }[] = [];\n  const lookup: ChartAnnotationLookup = new Map();\n  for (const annotation of annotations) {\n    const { position } = annotation;\n    labels.push({\n      // Highcharts anchor — always uses `x` regardless of chart orientation.\n      point: { x: position, y: 0, xAxis: 0, yAxis: 0 },\n      // Space (not empty) — Highcharts reverts to its built-in label text on empty string.\n      text: \" \",\n    });\n    // Keyed by the numeric position only. The marker portal reads\n    // `label.point.x` and the tooltip reads `context.point.x` — both numeric on\n    // every axis type, so no category-name keying is needed.\n    lookup.set(position, annotation);\n  }\n  if (labels.length === 0) {\n    return { annotations: undefined, lookup: undefined };\n  }\n  return {\n    // `useHTML: true` makes Highcharts attach an HTML `graphic.div` to each\n    // label, which the marker portal needs as its render target. `padding: 0`\n    // removes Highcharts' default left padding so markers stay centered.\n    annotations: [{ labels, labelOptions: { useHTML: true, padding: 0 } }],\n    lookup,\n  };\n}\n","import { formatNumeral } from \"@sproutsocial/seeds-react-numeral\";\n\nimport type { SeedsAxisLabelFormatterContext } from \"./chartBase\";\nimport { valueFormatter, type ValueFormat } from \"./formatters/valueFormatter\";\n\n/**\n * Fixed internal locale for the default value-axis formatter. Pins the en-US\n * compact symbols (2K / 1.2M / 1.2B) so output is deterministic regardless of\n * the environment's locale resolution.\n * TODO: consumer-facing locale and an override surface may be added later.\n */\nconst FIXED_LOCALE = \"en-US\";\n\n/**\n * Derive formatNumeral's `abbreviate` threshold from the axis tick scan.\n *\n * formatNumeral abbreviates above 10,000 by default; passing a numeric\n * `abbreviate` lowers that threshold to that value. When the top tick exceeds\n * 9,999 we lower it to 1,000 so the whole axis reads \"2K 4K 6K 8K 10K\" rather\n * than a mixed \"2,000 4,000 6,000 8,000 10K\". Otherwise `true` keeps the default\n * 10,000 threshold. Centralizes the 9,999 rule for both formatters below.\n */\nfunction deriveAbbreviateFromTicks(\n  context: SeedsAxisLabelFormatterContext\n): boolean | number {\n  const tickPositions = context.axis.tickPositions;\n  const maxValue =\n    tickPositions && tickPositions.length > 0\n      ? tickPositions[tickPositions.length - 1]\n      : undefined;\n  return typeof maxValue === \"number\" && maxValue > 9999 ? 1000 : true;\n}\n\n/**\n * Internal, zero-config default value-axis label formatter for v2 chart\n * families. Abbreviates value-axis ticks (1.20K / 1.20M / 1.20B); decimal mode\n * only. Zero renders \"0\". Decimal compact precision is fixed at two fraction\n * digits, so abbreviated ticks always carry two decimals.\n *\n * Wired as a Highcharts `yAxis.labels.formatter`, invoked `this`-bound with the\n * Seeds-local context.\n */\nexport function defaultValueAxisLabelFormatter(\n  this: SeedsAxisLabelFormatterContext\n): string {\n  const numberValue = Number(this.value);\n\n  if (numberValue === 0) {\n    return formatNumeral({ locale: FIXED_LOCALE, number: 0 });\n  }\n\n  const abbreviate = deriveAbbreviateFromTicks(this);\n\n  return formatNumeral({\n    abbreviate,\n    format: \"decimal\",\n    locale: FIXED_LOCALE,\n    number: numberValue,\n  });\n}\n\n/**\n * Build a `format`-driven value-axis label formatter that runs a declarative\n * {@link ValueFormat} through the shared {@link valueFormatter}. Reuses the same\n * `tickPositions` scan as {@link defaultValueAxisLabelFormatter} so the\n * axis-wide \"smart 1k/10k\" abbreviation is preserved for decimal/currency ticks.\n *\n * Wired as a Highcharts `yAxis.labels.formatter`; invoked `this`-bound with the\n * Seeds-local context. The returned formatter never carries chart-engine types,\n * keeping the engine boundary intact.\n */\nexport function makeValueAxisLabelFormatter(format: ValueFormat) {\n  return function (this: SeedsAxisLabelFormatterContext): string {\n    const numberValue = Number(this.value);\n\n    // Honor an explicit `abbreviate: false` opt-out; otherwise derive the\n    // threshold from the same tick scan as the default formatter (abbreviation\n    // only affects decimal/currency — percent and duration ignore it inside\n    // valueFormatter).\n    const abbreviate =\n      format.abbreviate === false ? false : deriveAbbreviateFromTicks(this);\n\n    return valueFormatter({ ...format, value: numberValue, abbreviate });\n  };\n}\n"]}
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-6SF6OYQA.js","../src/charts/shared/annotations.ts","../src/charts/shared/valueAxisLabelFormatter.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACkCO,SAAS,qBAAA,CACd,WAAA,EAIA;AACA,EAAA,GAAA,CAAI,iBAAC,WAAA,2BAAa,QAAA,EAAQ;AACxB,IAAA,OAAO,EAAE,WAAA,EAAa,KAAA,CAAA,EAAW,MAAA,EAAQ,KAAA,EAAU,CAAA;AAAA,EACrD;AACA,EAAA,MAAM,OAAA,EAGA,CAAC,CAAA;AACP,EAAA,MAAM,OAAA,kBAAgC,IAAI,GAAA,CAAI,CAAA;AAC9C,EAAA,IAAA,CAAA,MAAW,WAAA,GAAc,WAAA,EAAa;AACpC,IAAA,MAAM,EAAE,SAAS,EAAA,EAAI,UAAA;AACrB,IAAA,MAAA,CAAO,IAAA,CAAK;AAAA;AAAA,MAEV,KAAA,EAAO,EAAE,CAAA,EAAG,QAAA,EAAU,CAAA,EAAG,CAAA,EAAG,KAAA,EAAO,CAAA,EAAG,KAAA,EAAO,EAAE,CAAA;AAAA;AAAA,MAE/C,IAAA,EAAM;AAAA,IACR,CAAC,CAAA;AAID,IAAA,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,UAAU,CAAA;AAAA,EACjC;AACA,EAAA,GAAA,CAAI,MAAA,CAAO,OAAA,IAAW,CAAA,EAAG;AACvB,IAAA,OAAO,EAAE,WAAA,EAAa,KAAA,CAAA,EAAW,MAAA,EAAQ,KAAA,EAAU,CAAA;AAAA,EACrD;AACA,EAAA,OAAO;AAAA;AAAA;AAAA;AAAA,IAIL,WAAA,EAAa,CAAC,EAAE,MAAA,EAAQ,YAAA,EAAc,EAAE,OAAA,EAAS,IAAA,EAAM,OAAA,EAAS,EAAE,EAAE,CAAC,CAAA;AAAA,IACrE;AAAA,EACF,CAAA;AACF;AD3CA;AACA;AEjCA,sEAA8B;AAW9B,IAAM,aAAA,EAAe,OAAA;AAWrB,SAAS,yBAAA,CACP,OAAA,EACkB;AAClB,EAAA,MAAM,cAAA,EAAgB,OAAA,CAAQ,IAAA,CAAK,aAAA;AACnC,EAAA,MAAM,SAAA,EACJ,cAAA,GAAiB,aAAA,CAAc,OAAA,EAAS,EAAA,EACpC,aAAA,CAAc,aAAA,CAAc,OAAA,EAAS,CAAC,EAAA,EACtC,KAAA,CAAA;AACN,EAAA,OAAO,OAAO,SAAA,IAAa,SAAA,GAAY,SAAA,EAAW,KAAA,EAAO,IAAA,EAAO,IAAA;AAClE;AAWO,SAAS,8BAAA,CAAA,EAEN;AACR,EAAA,MAAM,YAAA,EAAc,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA;AAErC,EAAA,GAAA,CAAI,YAAA,IAAgB,CAAA,EAAG;AACrB,IAAA,OAAO,8CAAA,EAAgB,MAAA,EAAQ,YAAA,EAAc,MAAA,EAAQ,EAAE,CAAC,CAAA;AAAA,EAC1D;AAEA,EAAA,MAAM,WAAA,EAAa,yBAAA,CAA0B,IAAI,CAAA;AAEjD,EAAA,OAAO,8CAAA;AAAc,IACnB,UAAA;AAAA,IACA,MAAA,EAAQ,SAAA;AAAA,IACR,MAAA,EAAQ,YAAA;AAAA,IACR,MAAA,EAAQ;AAAA,EACV,CAAC,CAAA;AACH;AAYO,SAAS,2BAAA,CAA4B,MAAA,EAAqB;AAC/D,EAAA,OAAO,QAAA,CAAA,EAAwD;AAC7D,IAAA,MAAM,YAAA,EAAc,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA;AAMrC,IAAA,MAAM,WAAA,EACJ,MAAA,CAAO,WAAA,IAAe,MAAA,EAAQ,MAAA,EAAQ,yBAAA,CAA0B,IAAI,CAAA;AAEtE,IAAA,OAAO,6CAAA,EAAiB,GAAG,MAAA,EAAQ,KAAA,EAAO,WAAA,EAAa,WAAW,CAAC,CAAA;AAAA,EACrE,CAAA;AACF;AFvBA;AACA;AACE;AACA;AACA;AACF,kMAAC","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-6SF6OYQA.js","sourcesContent":[null,"// Shared annotation plumbing across v2 chart families. Currently consumed by\n// BarChart; v2 Line/Area will share the same `annotations` shape and reuse\n// `buildAnnotationConfig` directly. Annotation data is purely numeric —\n// the module has no knowledge of `categories`; resolving a numeric position to\n// a display name is the tooltip's job (see chartBase `renderContent`).\n\nimport type { TypeIconName } from \"@sproutsocial/seeds-react-icon\";\nimport type { SeedsChartAnnotationsOptions } from \"./chartBase\";\n\n/**\n * Annotations keyed by the numeric Highcharts index. Both consumers resolve\n * numerically: the marker portal reads `label.point.x` and the tooltip reads\n * `context.point.x` (numeric on both category and datetime axes).\n */\nexport type ChartAnnotationLookup = Map<number, ChartAnnotation>;\n\n/**\n * Declarative annotation shape — the DS renders the marker and tooltip header\n * internally; consumers don't supply render functions. See CE-7.\n */\nexport interface ChartAnnotation {\n  /** Numeric x-axis coordinate — a category index (category axes) or the raw coordinate (datetime/linear axes). */\n  position: number;\n  /** Icon shown above the chart at `position` and inline with `title` in the tooltip header. */\n  icon?: TypeIconName;\n  /** Color applied to the marker's vertical line. */\n  color?: string;\n  /** Tooltip header line 1. */\n  title?: string;\n  /** Tooltip header line 2. */\n  description?: string;\n}\n\n/**\n * Build the Highcharts `annotations` config and a parallel lookup keyed by the\n * numeric `position`. Both consumers (chart adapter for Highcharts, ChartRenderer\n * for the portal + tooltip) read from the same numeric lookup to stay aligned.\n */\nexport function buildAnnotationConfig(\n  annotations: ChartAnnotation[] | undefined\n): {\n  annotations: SeedsChartAnnotationsOptions[] | undefined;\n  lookup: ChartAnnotationLookup | undefined;\n} {\n  if (!annotations?.length) {\n    return { annotations: undefined, lookup: undefined };\n  }\n  const labels: {\n    point: { x: number; y: number; xAxis: 0; yAxis: 0 };\n    text: string;\n  }[] = [];\n  const lookup: ChartAnnotationLookup = new Map();\n  for (const annotation of annotations) {\n    const { position } = annotation;\n    labels.push({\n      // Highcharts anchor — always uses `x` regardless of chart orientation.\n      point: { x: position, y: 0, xAxis: 0, yAxis: 0 },\n      // Space (not empty) — Highcharts reverts to its built-in label text on empty string.\n      text: \" \",\n    });\n    // Keyed by the numeric position only. The marker portal reads\n    // `label.point.x` and the tooltip reads `context.point.x` — both numeric on\n    // every axis type, so no category-name keying is needed.\n    lookup.set(position, annotation);\n  }\n  if (labels.length === 0) {\n    return { annotations: undefined, lookup: undefined };\n  }\n  return {\n    // `useHTML: true` makes Highcharts attach an HTML `graphic.div` to each\n    // label, which the marker portal needs as its render target. `padding: 0`\n    // removes Highcharts' default left padding so markers stay centered.\n    annotations: [{ labels, labelOptions: { useHTML: true, padding: 0 } }],\n    lookup,\n  };\n}\n","import { formatNumeral } from \"@sproutsocial/seeds-react-numeral\";\n\nimport type { SeedsAxisLabelFormatterContext } from \"./chartBase\";\nimport { valueFormatter, type ValueFormat } from \"./formatters/valueFormatter\";\n\n/**\n * Fixed internal locale for the default value-axis formatter. Pins the en-US\n * compact symbols (2K / 1.2M / 1.2B) so output is deterministic regardless of\n * the environment's locale resolution.\n * TODO: consumer-facing locale and an override surface may be added later.\n */\nconst FIXED_LOCALE = \"en-US\";\n\n/**\n * Derive formatNumeral's `abbreviate` threshold from the axis tick scan.\n *\n * formatNumeral abbreviates above 10,000 by default; passing a numeric\n * `abbreviate` lowers that threshold to that value. When the top tick exceeds\n * 9,999 we lower it to 1,000 so the whole axis reads \"2K 4K 6K 8K 10K\" rather\n * than a mixed \"2,000 4,000 6,000 8,000 10K\". Otherwise `true` keeps the default\n * 10,000 threshold. Centralizes the 9,999 rule for both formatters below.\n */\nfunction deriveAbbreviateFromTicks(\n  context: SeedsAxisLabelFormatterContext\n): boolean | number {\n  const tickPositions = context.axis.tickPositions;\n  const maxValue =\n    tickPositions && tickPositions.length > 0\n      ? tickPositions[tickPositions.length - 1]\n      : undefined;\n  return typeof maxValue === \"number\" && maxValue > 9999 ? 1000 : true;\n}\n\n/**\n * Internal, zero-config default value-axis label formatter for v2 chart\n * families. Abbreviates value-axis ticks (1.20K / 1.20M / 1.20B); decimal mode\n * only. Zero renders \"0\". Decimal compact precision is fixed at two fraction\n * digits, so abbreviated ticks always carry two decimals.\n *\n * Wired as a Highcharts `yAxis.labels.formatter`, invoked `this`-bound with the\n * Seeds-local context.\n */\nexport function defaultValueAxisLabelFormatter(\n  this: SeedsAxisLabelFormatterContext\n): string {\n  const numberValue = Number(this.value);\n\n  if (numberValue === 0) {\n    return formatNumeral({ locale: FIXED_LOCALE, number: 0 });\n  }\n\n  const abbreviate = deriveAbbreviateFromTicks(this);\n\n  return formatNumeral({\n    abbreviate,\n    format: \"decimal\",\n    locale: FIXED_LOCALE,\n    number: numberValue,\n  });\n}\n\n/**\n * Build a `format`-driven value-axis label formatter that runs a declarative\n * {@link ValueFormat} through the shared {@link valueFormatter}. Reuses the same\n * `tickPositions` scan as {@link defaultValueAxisLabelFormatter} so the\n * axis-wide \"smart 1k/10k\" abbreviation is preserved for decimal/currency ticks.\n *\n * Wired as a Highcharts `yAxis.labels.formatter`; invoked `this`-bound with the\n * Seeds-local context. The returned formatter never carries chart-engine types,\n * keeping the engine boundary intact.\n */\nexport function makeValueAxisLabelFormatter(format: ValueFormat) {\n  return function (this: SeedsAxisLabelFormatterContext): string {\n    const numberValue = Number(this.value);\n\n    // Honor an explicit `abbreviate: false` opt-out; otherwise derive the\n    // threshold from the same tick scan as the default formatter (abbreviation\n    // only affects decimal/currency — percent and duration ignore it inside\n    // valueFormatter).\n    const abbreviate =\n      format.abbreviate === false ? false : deriveAbbreviateFromTicks(this);\n\n    return valueFormatter({ ...format, value: numberValue, abbreviate });\n  };\n}\n"]}

package/dist/{chunk-GWP3PWIG.js → chunk-GQOKCB3M.js}

@@ -685,7 +685,6 @@ function buildBaseChartOptions({
   description,
   svgContainerLabel,
   point,
-  valueSuffix,
   reserveTopMargin = false,
   timezone
 }) {
@@ -706,8 +705,7 @@ function buildBaseChartOptions({
       padding: 0,
       shape: "rect",
       shared: true,
-      hideDelay: 0,
-      valueSuffix
+      hideDelay: 0
     },
     // Chart-global in Highcharts; only meaningful for datetime axes, so it's
     // present only when a timezone was resolved (omitted for category axes).
@@ -721,4 +719,4 @@ function buildBaseChartOptions({
 
 
 exports.valueFormatter = valueFormatter; exports.useSeedsChartSetup = useSeedsChartSetup; exports.ChartRenderer = ChartRenderer; exports.buildBaseChartOptions = buildBaseChartOptions;
-//# sourceMappingURL=chunk-GWP3PWIG.js.map
+//# sourceMappingURL=chunk-GQOKCB3M.js.map

package/dist/chunk-GQOKCB3M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-GQOKCB3M.js","../src/charts/shared/chartBase.tsx","../src/charts/shared/ChartAnnotationMarkerPortal.tsx","../src/charts/shared/DefaultChartTooltip.tsx","../src/charts/shared/formatters/valueFormatter.ts","../src/charts/shared/SeriesLegend.tsx","../src/charts/shared/chartExport.ts","../src/charts/shared/baseChartOptions.ts"],"names":["ChartAnnotationMarkerPortal","Box","Icon","memo","jsx"],"mappings":"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","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-GQOKCB3M.js","sourcesContent":[null,"// Engine boundary for the v2 chart architecture. The only file under `charts/`\n// that imports from \"highcharts\". See `charts/README.md` for invariants.\n\nimport Highcharts from \"highcharts\";\nimport { HighchartsReact } from \"highcharts-react-official\";\nimport highchartsAccessibility from \"highcharts/modules/accessibility\";\nimport highchartsAnnotations from \"highcharts/modules/annotations\";\nimport highchartsExporting from \"highcharts/modules/exporting\";\nimport highchartsOfflineExporting from \"highcharts/modules/offline-exporting\";\nimport highchartsExportData from \"highcharts/modules/export-data\";\nimport highchartsMore from \"highcharts/highcharts-more\";\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { useTheme } from \"styled-components\";\n\nimport { ChartTooltipPortal } from \"../../components/ChartTooltip/components/ChartTooltipPortal\";\nimport { transformTimeSeriesTooltipData } from \"../../helpers\";\nimport { GlobalChartStyleOverrides } from \"../../styles/chartStyles\";\nimport { ChartAnnotationMarkerPortal } from \"./ChartAnnotationMarkerPortal\";\nimport { DefaultChartTooltip } from \"./DefaultChartTooltip\";\nimport { SeriesLegend } from \"./SeriesLegend\";\nimport type { TypeIconName } from \"@sproutsocial/seeds-react-icon\";\nimport type { TypeTheme } from \"@sproutsocial/seeds-react-theme\";\nimport { defaultFilename } from \"./chartExport\";\nimport type { ChartAnnotationLookup } from \"./annotations\";\nimport type { ValueFormat } from \"./formatters/valueFormatter\";\nimport type { ChartExportHandle } from \"./chartExport\";\nimport type { TypeChartStyleColor, TypeChartStylePattern } from \"../../types\";\n\nhighchartsAccessibility(Highcharts);\nhighchartsAnnotations(Highcharts);\n// `exporting` must register before `offline-exporting` and `export-data`, which\n// extend it. `exporting` adds a native context (hamburger) button by default;\n// `ChartRenderer` disables it on the chart options so v2 charts expose export\n// only through the `onReady` handle. Export is client-side/offline only —\n// we never call the Highcharts export server.\nhighchartsExporting(Highcharts);\nhighchartsOfflineExporting(Highcharts);\nhighchartsExportData(Highcharts);\n// `highcharts-more` adds the packedbubble series type. Bubble is the first v2\n// family to need it — no other family registers or depends on this module.\nhighchartsMore(Highcharts);\n\n/** Highcharts series type. `column` is vertical bars; `bar` is horizontal bars; the line/area family adds the rest; `pie` is donut/pie; `packedbubble` is the clustered bubble family. */\nexport type SeedsChartType =\n  | \"column\"\n  | \"bar\"\n  | \"line\"\n  | \"spline\"\n  | \"area\"\n  | \"areaspline\"\n  | \"pie\"\n  | \"packedbubble\";\n\nexport interface SeedsChartMarkerOptions {\n  enabled?: boolean;\n  symbol?: \"circle\";\n}\n\n/** Object form of a series point — carries an optional per-point `marker` override. */\nexport interface SeedsChartDataPoint {\n  x?: number;\n  y: number | null;\n  marker?: SeedsChartMarkerOptions;\n}\n\nexport interface SeedsChartSeriesOptions {\n  type: SeedsChartType;\n  name: string;\n  data: Array<number | null | [number, number | null] | SeedsChartDataPoint>;\n  color?: string;\n}\n\n/**\n * Seeds-local shape of the `this` context Highcharts binds when invoking an\n * axis-label `formatter`. Models only the fields our default formatter reads\n * (`value` and `axis.tickPositions`).\n */\nexport interface SeedsAxisLabelFormatterContext {\n  value: number | string;\n  axis: { tickPositions?: ReadonlyArray<number> };\n}\n\nexport interface SeedsChartAxisLabelOptions {\n  useHTML?: boolean;\n  /** Show the axis tick labels. Maps to Highcharts' `labels.enabled`; defaults to shown. */\n  enabled?: boolean;\n  /** `this`-bound tick-label formatter returning the rendered string. */\n  formatter?: (this: SeedsAxisLabelFormatterContext) => string;\n}\n\n/**\n * Highcharts datetime tick-label formats, keyed by the auto-selected tick unit.\n * Only the units the chart families set are modeled; Highcharts merges the rest\n * with its own defaults.\n */\nexport interface SeedsChartDateTimeLabelFormats {\n  hour?: string;\n  day?: string;\n  week?: string;\n  month?: string;\n  year?: string;\n}\n\nexport interface SeedsChartAxisTitleOptions {\n  text: string;\n}\n\nexport interface SeedsChartXAxisOptions {\n  type?: \"category\" | \"datetime\" | \"linear\";\n  categories?: Array<string>;\n  crosshair?: boolean;\n  min?: number;\n  max?: number;\n  /** Hide the axis line, ticks, and labels entirely (e.g. sparklines). Maps to Highcharts' `visible`. */\n  visible?: boolean;\n  labels?: SeedsChartAxisLabelOptions;\n  dateTimeLabelFormats?: SeedsChartDateTimeLabelFormats;\n}\n\nexport interface SeedsChartYAxisOptions {\n  min?: number;\n  max?: number;\n  /** Soft minimum — the axis won't start above this value, but may extend below it for negative data. */\n  softMin?: number;\n  /** Soft maximum — the axis won't end below this value, but may extend above it. */\n  softMax?: number;\n  gridLineWidth?: number;\n  /** Hide the axis line, ticks, and labels entirely (e.g. sparklines). Maps to Highcharts' `visible`. */\n  visible?: boolean;\n  title?: SeedsChartAxisTitleOptions;\n  labels?: SeedsChartAxisLabelOptions;\n  /** Reference lines drawn across the plot area (e.g. the 0 baseline). `color` is only needed for the styledMode:false export clone, which can't reach scoped CSS. */\n  plotLines?: Array<{\n    value: number;\n    className?: string;\n    color?: string;\n    zIndex?: number;\n  }>;\n}\n\nexport interface SeedsChartTooltipOptions {\n  enabled?: boolean;\n  // `useHTML` is intentionally not here — it's hardcoded `true` at the engine\n  // boundary (ChartRenderer) because the tooltip portal can't work without it.\n  outside?: boolean;\n  padding?: number;\n  shape?: \"rect\" | \"callout\";\n  shared?: boolean;\n  hideDelay?: number;\n}\n\nexport interface SeedsChartSeriesPlotOptions {\n  animation?: boolean;\n  /** Stacking applied across all series. Used by the line/area family for `stacked-area`. */\n  stacking?: \"normal\" | \"percent\";\n  /** Point-level event wiring (e.g. click). The events shape is family-agnostic. */\n  point?: { events?: SeedsChartPointEvents };\n  /** Default point-marker visibility. The line/area family disables markers and re-enables them per isolated point. */\n  marker?: SeedsChartMarkerOptions;\n}\n\nexport interface SeedsChartPointEventContext {\n  x: number | string;\n  series: {\n    name: string;\n    index: number;\n    chart: {\n      series: ReadonlyArray<{\n        type: string;\n        data: ReadonlyArray<{\n          x: number | string;\n          graphic?: { element?: Element };\n        }>;\n      }>;\n    };\n  };\n}\n\nexport interface SeedsChartPointEvents {\n  mouseOver?: (this: SeedsChartPointEventContext) => void;\n  mouseOut?: (this: SeedsChartPointEventContext) => void;\n  click?: (event: { point: { x: number | string } }) => void;\n}\n\nexport interface SeedsChartColumnPointOptions {\n  events?: SeedsChartPointEvents;\n}\n\nexport interface SeedsChartColumnPlotOptions {\n  stacking?: \"normal\" | \"percent\";\n  pointPadding?: number;\n  groupPadding?: number;\n  pointWidth?: number;\n  borderRadius?: number;\n  borderWidth?: number;\n  point?: SeedsChartColumnPointOptions;\n}\n\n/** Type-scoped stacking for filled line-area variants (parity with `column`). */\nexport interface SeedsChartAreaPlotOptions {\n  stacking?: \"normal\" | \"percent\";\n}\n\nexport interface SeedsChartPiePlotOptions {\n  /** `\"60%\"` for donut (hollow center), `0` for a solid pie. */\n  innerSize?: string | number;\n  animation?: boolean;\n  /** Must be set in JS (not CSS) — Highcharts computes the arc path before CSS is applied. */\n  borderRadius?: number;\n  dataLabels?: { enabled?: boolean };\n  states?: { inactive?: { opacity?: number } };\n  /** Pie point events: `this` is the Highcharts Point object (carries `name`, etc.). */\n  point?: {\n    events?: {\n      click?: (this: { name: string }) => void;\n      mouseOver?: (this: { name: string }) => void;\n      mouseOut?: (this: { name: string }) => void;\n    };\n  };\n}\n\n/** A single data point in a pie/donut series. Seeds-vocab — no Highcharts imports. */\nexport interface PiePoint {\n  name: string;\n  y: number | null;\n  color?: string;\n}\n\n/** Series options for pie/donut charts. `data` is per-point objects, not x/y tuples. */\nexport interface SeedsChartPieSeriesOptions {\n  type: \"pie\";\n  name: string;\n  data: Array<PiePoint>;\n  color?: string;\n}\n\n/** A single inner bubble within a packedbubble outer (category) series. Seeds-vocab — no Highcharts imports. */\nexport interface SeedsChartBubbleDataPoint {\n  name: string;\n  value: number;\n}\n\n/**\n * One outer (category) series for a packedbubble chart. `color`/`colorIndex`\n * follow the same raw-override convention as `getChartContainerProps`: an\n * explicit `color` inlines a `--highcharts-color-N` override, otherwise the\n * CSS default takes over. `colorIndex` pins the styledMode CSS class per\n * category (mirrors v1) so inner bubbles inherit their outer category's color.\n */\nexport interface SeedsChartPackedBubbleSeriesOptions {\n  type: \"packedbubble\";\n  name: string;\n  data: Array<SeedsChartBubbleDataPoint>;\n  color?: string;\n  colorIndex?: number;\n}\n\n/**\n * `this`-bound context for a packedbubble `dataLabels.formatter`. `point.index`/\n * `point.series.index` identify which inner bubble this is (same shape as\n * `SeedsChartBubbleClickEvent.point`, both real, typed Highcharts Point\n * fields). `radius` is genuine base-level extraction, not a pass-through: it\n * reads Highcharts' computed `point.marker.radius`, which is real at runtime\n * but untyped in Highcharts' own `.d.ts` (same field v1 read via its own\n * `@ts-expect-error`) — so `ChartRenderer` wraps the formatter to extract it,\n * the same pattern used for `accessibility.point.descriptionFormatter`.\n */\nexport interface SeedsChartBubbleDataLabelFormatterContext {\n  point: {\n    name: string;\n    value: number;\n    index: number;\n    series: { index: number };\n  };\n  radius: number;\n}\n\n/**\n * Point-click event shape for a packedbubble point. Structurally compatible\n * with Highcharts' real click event (stopPropagation/type/target distinguish\n * keyboard activation from a mouse click; see the family adapter's transform).\n */\nexport interface SeedsChartBubbleClickEvent {\n  type: string;\n  pageX?: number;\n  pageY?: number;\n  stopPropagation?: () => void;\n  target?: EventTarget | null;\n  point: {\n    name: string;\n    value: number;\n    index: number;\n    series: { index: number };\n  };\n}\n\nexport interface SeedsChartPackedBubblePlotOptions {\n  maxSize?: string | number;\n  minSize?: string | number;\n  draggable?: boolean;\n  layoutAlgorithm?: {\n    bubblePadding?: number;\n    splitSeries?: boolean;\n    gravitationalConstant?: number;\n    seriesInteraction?: boolean;\n    parentNodeLimit?: boolean;\n    enableSimulation?: boolean;\n  };\n  dataLabels?: {\n    enabled?: boolean;\n    // Known gap (mirrors bar's axis-label useHTML, see charts/README.md):\n    // v1's data-label formatter returns HTML (icon + wrapped text), which SVG\n    // <text> can't render. Kept for functional parity — not a portal target,\n    // so it's an exception to the useHTML rule, not a new portal use.\n    useHTML?: boolean;\n    formatter?: (this: SeedsChartBubbleDataLabelFormatterContext) => string;\n  };\n  states?: { hover?: { enabled?: boolean } };\n  /** Per-series accessibility config — required for Highcharts to emit focusable `.highcharts-a11y-proxy-button`s per point. */\n  accessibility?: {\n    enabled?: boolean;\n    keyboardNavigation?: { enabled?: boolean };\n    point?: { valueDescriptionFormat?: string };\n  };\n  point?: {\n    events?: {\n      click?: (event: SeedsChartBubbleClickEvent) => void;\n      mouseOver?: (this: { name: string }) => void;\n      mouseOut?: (this: { name: string }) => void;\n    };\n  };\n}\n\nexport interface SeedsChartPlotOptions {\n  series?: SeedsChartSeriesPlotOptions;\n  // `column` (vertical bars) and `bar` (horizontal bars) take the same option\n  // shape; the bar adapter assigns one config under whichever key is active.\n  column?: SeedsChartColumnPlotOptions;\n  bar?: SeedsChartColumnPlotOptions;\n  area?: SeedsChartAreaPlotOptions;\n  areaspline?: SeedsChartAreaPlotOptions;\n  pie?: SeedsChartPiePlotOptions;\n  packedbubble?: SeedsChartPackedBubblePlotOptions;\n}\n\nexport interface SeedsChartChartOptions {\n  type: SeedsChartType;\n  styledMode?: boolean;\n  animation?: boolean;\n  marginTop?: number;\n  height?: number;\n  /** `[top, right, bottom, left]` chart spacing. Donut zeroes it so the ring fills the height; sparklines zero it so the plot fills the container. */\n  spacing?: [number, number, number, number];\n}\n\nexport interface SeedsChartAnnotationLabelOptions {\n  point: { x: number; y: number; xAxis: 0; yAxis: 0 };\n  /** Highcharts shows a default label if this is empty; pass `\" \"` to suppress. */\n  text?: string;\n}\n\n/**\n * Shared options applied to every label in a Highcharts annotation block.\n * `useHTML: true` is load-bearing — it makes Highcharts attach an HTML\n * `graphic.div` to each label, which `ChartAnnotationMarkerPortal` portals\n * React content into. Without it, labels render as SVG `<text>` and the\n * portal finds no containers.\n */\nexport interface SeedsChartAnnotationLabelOptionsShared {\n  useHTML?: boolean;\n  padding?: number;\n}\n\nexport interface SeedsChartAnnotationsOptions {\n  labels?: SeedsChartAnnotationLabelOptions[];\n  labelOptions?: SeedsChartAnnotationLabelOptionsShared;\n}\n\nexport interface SeedsChartAccessibilityOptions {\n  description?: string;\n  /** The chart region's accessible name. Maps to Highcharts' `lang.accessibility.svgContainerLabel`, not `accessibility.*` — `ChartRenderer` performs that redirection at the engine boundary. */\n  svgContainerLabel?: string;\n  point?: {\n    /**\n     * Seeds-vocab per-point description for keyboard/proxy-button activation.\n     * `ChartRenderer` wraps this into Highcharts' real\n     * `accessibility.point.descriptionFormatter`, extracting `name`/`value`\n     * from the live `Point` (only `chartBase` may touch that type).\n     */\n    descriptionFormatter?: (point: { name: string; value: number }) => string;\n  };\n}\n\nexport interface SeedsChartTitleOptions {\n  text?: string;\n}\n\nexport interface SeedsChartCreditsOptions {\n  enabled?: boolean;\n}\n\nexport interface SeedsChartLegendOptions {\n  enabled?: boolean;\n}\n\n/** Maps to Highcharts `time` — chart-global; `timezone` only affects datetime axes. */\nexport interface SeedsChartTimeOptions {\n  timezone?: string;\n}\n\nexport interface SeedsChartOptions {\n  chart?: SeedsChartChartOptions;\n  accessibility?: SeedsChartAccessibilityOptions;\n  title?: SeedsChartTitleOptions;\n  credits?: SeedsChartCreditsOptions;\n  legend?: SeedsChartLegendOptions;\n  tooltip?: SeedsChartTooltipOptions;\n  time?: SeedsChartTimeOptions;\n  xAxis?: SeedsChartXAxisOptions;\n  yAxis?: SeedsChartYAxisOptions;\n  plotOptions?: SeedsChartPlotOptions;\n  series?: Array<\n    | SeedsChartSeriesOptions\n    | SeedsChartPieSeriesOptions\n    | SeedsChartPackedBubbleSeriesOptions\n  >;\n  annotations?: SeedsChartAnnotationsOptions[];\n}\n\n/**\n * A summed Total is only meaningful when the chart stacks its series (a stack\n * is, by definition, an additive composition). Returns true if any plotOptions\n * slot (series/column/bar/area/areaspline) carries a truthy `stacking`. Kept\n * key-agnostic so new stacked families are covered without changes here.\n */\nexport function isChartStacked(options: SeedsChartOptions): boolean {\n  const plotOptions = options.plotOptions;\n  if (!plotOptions) return false;\n  return Object.values(plotOptions).some(\n    (slot) =>\n      slot != null &&\n      typeof slot === \"object\" &&\n      Boolean((slot as { stacking?: unknown }).stacking)\n  );\n}\n\nexport interface SeedsChartSetupSeriesInput {\n  color?: string;\n  pattern?: TypeChartStylePattern;\n}\n\nexport interface UseSeedsChartSetupParams<\n  T extends SeedsChartSetupSeriesInput = SeedsChartSetupSeriesInput\n> {\n  series: Array<T>;\n  /** Opt-in for the pattern array. Families that apply patterns (line, area) pass `true`. */\n  includePatterns?: boolean;\n  /**\n   * Resolved effective cap (the family default, or the consumer's explicit\n   * value). Series beyond it are dropped. Omit to disable capping entirely.\n   */\n  seriesLimit?: number;\n  /**\n   * Whether the consumer set `seriesLimit` explicitly. Suppresses the over-limit\n   * warning (an explicit cap is intentional, not an accidental overflow).\n   * Default `false`.\n   */\n  isSeriesLimitOverridden?: boolean;\n  /** Opt out of the over-limit warning. Default `false`. */\n  hideSeriesLimitWarning?: boolean;\n  /** Component name used in the over-limit warning message (kept generic for future families). */\n  componentName?: string;\n}\n\nexport interface UseSeedsChartSetupResult<\n  T extends SeedsChartSetupSeriesInput = SeedsChartSetupSeriesInput\n> {\n  theme: TypeTheme;\n  colors: Array<TypeChartStyleColor>;\n  patterns: Array<TypeChartStylePattern>;\n  /** Series after applying the (optional) cap. Referentially equal to the input when no cap applies. */\n  series: Array<T>;\n}\n\nexport function useSeedsChartSetup<\n  T extends SeedsChartSetupSeriesInput = SeedsChartSetupSeriesInput\n>({\n  series,\n  includePatterns = false,\n  seriesLimit,\n  isSeriesLimitOverridden = false,\n  hideSeriesLimitWarning = false,\n  componentName,\n}: UseSeedsChartSetupParams<T>): UseSeedsChartSetupResult<T> {\n  const theme = useTheme() as TypeTheme;\n  const palette = theme.colors.DATAVIZ_COLORS_LIST;\n\n  // Cap the series at the resolved limit. Memoized so the input reference is\n  // preserved when no cap applies, keeping the colors/patterns memos\n  // referentially stable.\n  const cappedSeries = useMemo<Array<T>>(\n    () =>\n      seriesLimit !== undefined &&\n      seriesLimit >= 1 &&\n      series.length > seriesLimit\n        ? series.slice(0, seriesLimit)\n        : series,\n    [series, seriesLimit]\n  );\n\n  // Warn when the limit was exceeded, was not explicitly overridden by the\n  // consumer, and the warning isn't suppressed. Keyed off the gating conditions\n  // so it fires when those change rather than on every render.\n  useEffect(() => {\n    if (\n      seriesLimit !== undefined &&\n      seriesLimit >= 1 &&\n      series.length > seriesLimit &&\n      !isSeriesLimitOverridden &&\n      !hideSeriesLimitWarning &&\n      componentName != null\n    ) {\n      console.warn(\n        `${componentName}: Maximum number of series (${seriesLimit}) exceeded. Only the first ${seriesLimit} series will be displayed.`\n      );\n    }\n  }, [\n    series.length,\n    seriesLimit,\n    isSeriesLimitOverridden,\n    hideSeriesLimitWarning,\n    componentName,\n  ]);\n\n  const colors = useMemo<Array<TypeChartStyleColor>>(() => {\n    const out: TypeChartStyleColor[] = [];\n    const paletteLen = palette.length;\n    for (let i = 0; i < cappedSeries.length; i++) {\n      const s = cappedSeries[i]!;\n      out.push(s.color ?? palette[i % paletteLen] ?? \"\");\n    }\n    return out;\n  }, [cappedSeries, palette]);\n\n  const patterns = useMemo<Array<TypeChartStylePattern>>(() => {\n    if (!includePatterns) return [];\n    const out: TypeChartStylePattern[] = [];\n    for (let i = 0; i < cappedSeries.length; i++) {\n      const s = cappedSeries[i]!;\n      out.push(s.pattern ?? \"solid\");\n    }\n    return out;\n  }, [cappedSeries, includePatterns]);\n\n  return { theme, colors, patterns, series: cappedSeries };\n}\n\nexport interface ChartRendererSeries {\n  name: string;\n  color?: string;\n  /** Seeds icon or partner-logo name rendered before the series name in the legend label. */\n  icon?: TypeIconName;\n}\n\nexport interface ChartTooltipDataRow {\n  color: TypeChartStyleColor;\n  name: string;\n  value: number | null;\n  /** Slice percentage — populated by pie/donut tooltips; `undefined` for bar/line-area rows. */\n  percent?: number;\n  /** Outer category index — populated by bubble tooltips only; `undefined` elsewhere. */\n  seriesIndex?: number;\n  /** Inner bubble index — populated by bubble tooltips only; `undefined` elsewhere. */\n  pointIndex?: number;\n}\n\n/** Tooltip render-prop signature for v2 charts. */\nexport interface ChartTooltipProps {\n  data: ChartTooltipDataRow[];\n  /** Resolved x-axis position. Category name for category axes, numeric for time/linear. */\n  position: number | string;\n  /** Suppress the default tooltip's title row. Set for pie/donut, which have no x-axis position — the title would just duplicate the single slice's name. */\n  hideTitle?: boolean;\n  /** Resolved chart timezone — pass to date formatters when `position` is a numeric timestamp. Undefined on category axes. */\n  timezone?: string;\n  /** Declarative annotation anchored at this position, if any. Rendered in the tooltip header. */\n  annotation?: {\n    icon?: TypeIconName;\n    color?: string;\n    title?: string;\n    description?: string;\n  };\n  /** True when the chart has an `onClick` handler — used by the default tooltip to render the click-label footer. */\n  hasOnClick?: boolean;\n  /** Footer content shown in the default tooltip when the chart is clickable. */\n  tooltipClickLabel?: ReactNode;\n  /** Content shown in place of a row's value when the value is null. Defaults to an em-dash. */\n  invalidNumberLabel?: ReactNode;\n  /** Declarative value format for the tooltip value cell. Omit for raw rendering. Applied at full precision (abbreviation off). */\n  valueFormat?: ValueFormat;\n}\n\nexport interface ChartRendererProps {\n  options: SeedsChartOptions;\n  series: Array<ChartRendererSeries>;\n  /** Theme-aware palette resolved by `useSeedsChartSetup`. Used as the swatch color for any series that doesn't carry an explicit `color`. */\n  colors: ReadonlyArray<TypeChartStyleColor>;\n  /** Override for the default tooltip content. Portal is always rendered — `GlobalChartStyleOverrides` makes Highcharts' native tooltip box transparent. */\n  tooltip?: (args: ChartTooltipProps) => ReactNode;\n  /**\n   * Resolved annotations keyed by numeric x. Drives both the in-chart marker\n   * portal and the tooltip-header `annotation` injection. The family component\n   * builds this map (resolving category-string positions to indices); the\n   * renderer is axis-type agnostic.\n   */\n  annotationLookup?: ChartAnnotationLookup;\n  /** Forwarded into the default tooltip so it can render the click-label footer. */\n  hasOnClick?: boolean;\n  /** Forwarded into the default tooltip for click-label footer rendering. */\n  tooltipClickLabel?: ReactNode;\n  /** Resolved chart timezone, forwarded to the tooltip so its date title matches the axis ticks. Undefined on category axes. */\n  timezone?: string;\n  /** Forwarded into the default tooltip as the null-value override. */\n  invalidNumberLabel?: ReactNode;\n  /** Forwarded into the default tooltip to format the value cell declaratively. */\n  valueFormat?: ValueFormat;\n  /**\n   * Suppress the Seeds series legend beneath the chart. Default `false` (the\n   * legend renders). Decorative charts (e.g. sparklines) pass `true` to hide it.\n   */\n  hideLegend?: boolean;\n  /**\n   * Chart title baked into the exported image only. The on-screen title is a\n   * React sibling outside the chart SVG, so it can't be captured on export;\n   * `exportTitle` threads the text into the `styledMode:false` export clone as a\n   * themed native Highcharts title. It never renders on the live chart. Omit for\n   * no title.\n   */\n  exportTitle?: string;\n  /**\n   * Fired once per chart instance with an opaque {@link ChartExportHandle} for\n   * triggering PNG/SVG/PDF/CSV downloads. Re-fires only on a genuine remount,\n   * never on data or prop updates.\n   */\n  onReady?: (handle: ChartExportHandle) => void;\n}\n\n/**\n * Runtime shape of one Highcharts annotation label — only the fields the\n * marker portal reads. Re-exported so the portal stays inside the engine\n * boundary (no direct \"highcharts\" import).\n */\nexport interface ChartAnnotationRuntimeLabel {\n  graphic?: { div?: HTMLDivElement };\n  options?: { point?: { x?: number } };\n}\n\n/** Runtime shape of one Highcharts annotation block (a group of labels). */\nexport interface ChartAnnotationRuntime {\n  labels?: ChartAnnotationRuntimeLabel[];\n}\n\n/** Highcharts doesn't include the `annotations` array on its `Chart` type. */\ninterface ChartWithAnnotations extends Highcharts.Chart {\n  annotations?: ChartAnnotationRuntime[];\n}\n\n/** Inputs for the `styledMode: false` export clone (see `buildExportChartOptions`). */\ninterface ExportChartOptionsParams {\n  theme: TypeTheme;\n  colors: ReadonlyArray<TypeChartStyleColor>;\n  /** Title baked into the export clone only; omit/blank for no native title. */\n  exportTitle?: string;\n}\n\n/**\n * Theme→options map for the `styledMode: false` export clone, which can't see\n * the scoped CSS v2 charts normally style with. Mirrors `styles/chartStyles`.\n */\nfunction buildExportChartOptions({\n  theme,\n  colors,\n  exportTitle: rawTitle,\n}: ExportChartOptionsParams): Highcharts.Options {\n  // Trim so a whitespace-only title never reserves title space in the export.\n  const exportTitle = rawTitle?.trim();\n  // Line, gridline, and label styling are identical for both axes.\n  const axisOptions = {\n    lineColor: theme.colors.container.border.base,\n    gridLineColor: theme.colors.container.border.base,\n    labels: {\n      style: {\n        color: theme.colors.text.subtext,\n        fontFamily: theme.fontFamily,\n        fontSize: theme.typography[100].fontSize,\n        fontWeight: String(theme.fontWeights.normal),\n      },\n    },\n  };\n  return {\n    chart: {\n      styledMode: false,\n      backgroundColor: theme.colors.container.background.base,\n    },\n    // Series without an explicit `color` fall through to this palette by index.\n    colors: [...colors],\n    // The on-screen legend is a React sibling (`SeriesLegend`) outside the chart\n    // SVG, so the export can't capture it. Turn on Highcharts' native legend for\n    // the clone instead, themed to approximate the Seeds `ChartLegend` (centered\n    // row of swatch + `text.subtext` label). It can't reproduce per-series Seeds\n    // icons — those series show colour + name only.\n    legend: {\n      enabled: true,\n      symbolRadius: 4,\n      symbolHeight: 12,\n      symbolWidth: 12,\n      itemStyle: {\n        color: theme.colors.text.subtext,\n        fontFamily: theme.fontFamily,\n        fontSize: theme.typography[200].fontSize,\n        fontWeight: String(theme.fontWeights.normal),\n      },\n    },\n    xAxis: {\n      ...axisOptions,\n      crosshair: {\n        color: theme.colors.container.border.decorative.neutral,\n        width: 1,\n      },\n    },\n    yAxis: {\n      ...axisOptions,\n      // The live chart's plotLines (set by the adapter) merge with this by\n      // array index, so `className`/`value`/`zIndex` survive — this only adds\n      // the color the `y-axis-zero-line` CSS class can't reach in styledMode:false.\n      plotLines: [\n        { value: 0, color: theme.colors.container.border.decorative.neutral },\n      ],\n    },\n    // The on-screen title is a React sibling (`Text.SmallSubHeadline`) rendered\n    // above the chart, outside the SVG, so the export can't capture it. Bake a\n    // themed native Highcharts title into the clone instead (same treatment as\n    // the legend above), styled to match the Seeds SmallSubHeadline. Guarded so a\n    // chart with no title produces no native title in the export.\n    ...(exportTitle\n      ? {\n          title: {\n            text: exportTitle,\n            style: {\n              color: theme.colors.text.headline,\n              fontFamily: theme.fontFamily,\n              fontSize: theme.typography[200].fontSize,\n              fontWeight: String(theme.fontWeights.bold),\n            },\n          },\n        }\n      : {}),\n  } as Highcharts.Options;\n}\n\n/**\n * Build the opaque export handle for a chart instance. Lives here — not in\n * `chartExport.ts` — because it closes over the live `Highcharts.Chart`, which\n * never leaves the engine boundary. The returned {@link ChartExportHandle} is\n * Highcharts-free.\n *\n * PDF lazy-loads jspdf + svg2pdf.js (a deferred chunk) on first use.\n */\nfunction createChartExportHandle(\n  chart: Highcharts.Chart,\n  getExportChartOptions: () => Highcharts.Options\n): ChartExportHandle {\n  const resolveName = (filename?: string) =>\n    filename ?? defaultFilename(chart.options.chart?.type, new Date());\n\n  const exportImage = async (\n    type: Highcharts.ExportingMimeTypeValue,\n    filename?: string\n  ): Promise<void> => {\n    // Read options at call time, not when the handle was built: a light/dark\n    // toggle updates the chart in place without re-firing `onReady`, so the\n    // export must reflect the current theme. 2nd arg is deep-merged, so\n    // `labels.style` here merges with the live axis `formatter`, not clobbers it.\n    chart.exportChartLocal(\n      { type, filename: resolveName(filename) },\n      getExportChartOptions()\n    );\n  };\n\n  return {\n    exportPNG: ({ filename } = {}) => exportImage(\"image/png\", filename),\n    exportSVG: ({ filename } = {}) => exportImage(\"image/svg+xml\", filename),\n    exportPDF: async ({ filename } = {}): Promise<void> => {\n      // Lazy-load jspdf + svg2pdf.js (deferred chunk) and expose `window.jspdf`\n      // before exporting, so Highcharts' offline-exporting renders the PDF\n      // locally rather than fetching the libs from its CDN.\n      const { loadPdfExportLibs } = await import(\"./pdfExportLibs\");\n      loadPdfExportLibs();\n      await exportImage(\"application/pdf\", filename);\n    },\n    exportCSV: async ({ filename } = {}): Promise<void> => {\n      // `downloadCSV()` reads the filename from `chart.options.exporting.filename`\n      // via `getFilename()`. Set it transiently (direct mutation — no `update()`,\n      // so no redraw) so the per-call override and generated default both apply,\n      // then restore the previous value.\n      const exporting = (chart.options.exporting ??= {});\n      const previous = exporting.filename;\n      exporting.filename = resolveName(filename);\n      try {\n        chart.downloadCSV();\n      } finally {\n        exporting.filename = previous;\n      }\n    },\n  };\n}\n\nexport function ChartRenderer({\n  options,\n  series,\n  colors,\n  tooltip,\n  annotationLookup,\n  hasOnClick,\n  tooltipClickLabel,\n  timezone,\n  invalidNumberLabel,\n  valueFormat,\n  hideLegend = false,\n  exportTitle,\n  onReady,\n}: ChartRendererProps) {\n  const [chart, setChart] = useState<Highcharts.Chart | null>(null);\n  const [plotHeight, setPlotHeight] = useState(0);\n  // Wrap the default tooltip so unstacked families (line/spline, unstacked\n  // area, grouped bar) suppress the summed Total, which is meaningless there.\n  // When a consumer supplies `tooltip`, DefaultChartTooltip is bypassed and\n  // never sees `hideTotal` — the escape hatch and public props stay untouched.\n  const chartIsStacked = isChartStacked(options);\n  const renderTooltip =\n    tooltip ??\n    ((args) => DefaultChartTooltip({ ...args, hideTotal: !chartIsStacked }));\n  const theme = useTheme() as TypeTheme;\n\n  // Hold the live theme + palette in a ref so the export handle reads the\n  // *current* theme at call time (see `createChartExportHandle`). A dark-mode\n  // toggle updates this each render without re-firing `onReady`.\n  const exportThemeRef = useRef({ theme, colors, exportTitle });\n  exportThemeRef.current = { theme, colors, exportTitle };\n\n  // Capture only the live chart. Highcharts reuses a chart's `callback` when it\n  // builds the throwaway clone for export (`new chart.constructor(options,\n  // chart.callback)` in exporting/offline-exporting, with `chart.forExport:\n  // true`). That clone is destroyed the instant its SVG is captured, so binding\n  // React state to it would leave a destroyed chart whose next `update()` reads\n  // `options.responsive` on `undefined` and throws.\n  const captureChart = useCallback((chartInstance: Highcharts.Chart) => {\n    const forExport = (\n      chartInstance.options.chart as { forExport?: boolean } | undefined\n    )?.forExport;\n    if (!forExport) {\n      setChart(chartInstance);\n      // Seed plotHeight in the same commit as the chart so markers render with\n      // it, not a frame later (the pop-in). The redraw handler keeps it current.\n      setPlotHeight(chartInstance.plotHeight);\n    }\n  }, []);\n\n  // Hold `onReady` in a ref so an inline callback (new identity each render)\n  // doesn't re-fire the effect below — it should fire on instance change only.\n  const onReadyRef = useRef(onReady);\n  onReadyRef.current = onReady;\n\n  // Fire `onReady` once per chart instance. The chart callback runs only on\n  // instance creation — data/prop changes call `chart.update()` on the same\n  // instance and don't re-run it — so keying on `[chart]` gives once-per-instance\n  // semantics: re-fires on a genuine remount, never on a data update.\n  useEffect(() => {\n    if (!chart) return;\n    onReadyRef.current?.(\n      createChartExportHandle(chart, () =>\n        buildExportChartOptions(exportThemeRef.current)\n      )\n    );\n  }, [chart]);\n\n  // Track the chart's actual plot-area height so the annotation marker line\n  // spans it. Re-reads on Highcharts' `redraw` event (covers window resizes,\n  // data updates, anything that re-lays-out the plot area).\n  useEffect(() => {\n    if (!chart) return;\n    setPlotHeight(chart.plotHeight);\n    const unbind = Highcharts.addEvent(chart, \"redraw\", () => {\n      setPlotHeight(chart.plotHeight);\n    });\n    return () => unbind();\n  }, [chart]);\n\n  // Stable ref across internal re-renders (setChart/setPlotHeight): HighchartsReact\n  // keys its update effect on the options ref and redraws on change, so a fresh\n  // object each render would redraw — and re-flicker the annotations — every time.\n  const highchartsOptions = useMemo(() => {\n    // Seeds groups svgContainerLabel/point.descriptionFormatter under\n    // `accessibility` for a cleaner public shape, but Highcharts itself reads\n    // svgContainerLabel from `lang.accessibility`, and `point.descriptionFormatter`\n    // is called with the live `Point` instance — only `chartBase` may touch that\n    // type, so the extraction (including v1's `.value` vs `.y` fallback) is\n    // wrapped here rather than in a family adapter.\n    const pointDescriptionFormatter =\n      options.accessibility?.point?.descriptionFormatter;\n    const svgContainerLabel = options.accessibility?.svgContainerLabel;\n    // Same rationale as the accessibility wrap above: the family's formatter\n    // is Seeds-vocab, but `radius` (`point.marker.radius`) is a genuine\n    // Highcharts runtime field with no place in a structurally-typed\n    // pass-through, so `chartBase` extracts it via a contained cast.\n    const packedBubbleDataLabelFormatter =\n      options.plotOptions?.packedbubble?.dataLabels?.formatter;\n    return {\n      ...options,\n      ...(packedBubbleDataLabelFormatter\n        ? {\n            plotOptions: {\n              ...options.plotOptions,\n              packedbubble: {\n                ...options.plotOptions?.packedbubble,\n                dataLabels: {\n                  ...options.plotOptions?.packedbubble?.dataLabels,\n                  formatter(this: Highcharts.PointLabelObject) {\n                    const bubblePoint = this.point as Highcharts.Point & {\n                      value?: number;\n                      marker?: { radius?: number };\n                    };\n                    return packedBubbleDataLabelFormatter.call({\n                      point: {\n                        name: bubblePoint.name,\n                        value: bubblePoint.value ?? (bubblePoint.y as number),\n                        index: bubblePoint.index,\n                        series: { index: bubblePoint.series.index },\n                      },\n                      radius: bubblePoint.marker?.radius ?? 0,\n                    });\n                  },\n                },\n              },\n            },\n          }\n        : {}),\n      accessibility: {\n        description: options.accessibility?.description,\n        ...(pointDescriptionFormatter\n          ? {\n              point: {\n                descriptionFormatter: (point: Highcharts.Point) => {\n                  const bubblePoint = point as Highcharts.Point & {\n                    value?: number;\n                  };\n                  return pointDescriptionFormatter({\n                    name: point.name,\n                    value: bubblePoint.value ?? (point.y as number),\n                  });\n                },\n              },\n            }\n          : {}),\n      },\n      ...(svgContainerLabel\n        ? { lang: { accessibility: { svgContainerLabel } } }\n        : {}),\n      // useHTML is load-bearing: the tooltip portal's target div only mounts\n      // when the label renders as HTML, not SVG (see `charts/README.md`).\n      tooltip: { ...options.tooltip, useHTML: true },\n      // Client-side/offline export only; native context button hidden (export\n      // is exposed via the `onReady` handle).\n      exporting: {\n        fallbackToExportServer: false,\n        buttons: { contextButton: { enabled: false } },\n      },\n    } as Highcharts.Options;\n  }, [options]);\n\n  // Safety net: no series → render nothing. Families are expected to early-return\n  // before calling hooks to avoid wasted work, but this guards future families\n  // that forget. See `charts/README.md` (\"Empty-data handling\").\n  if (series.length === 0) return null;\n\n  const chartWithAnnotations = chart as ChartWithAnnotations | null;\n  const hasRenderedAnnotations =\n    !!chartWithAnnotations?.annotations?.length &&\n    !!annotationLookup?.size &&\n    plotHeight > 0;\n\n  return (\n    <>\n      <GlobalChartStyleOverrides />\n      <HighchartsReact\n        highcharts={Highcharts}\n        // Structural cast at the engine seam — the only place we touch Highcharts' option types.\n        options={highchartsOptions}\n        callback={captureChart}\n      />\n      {hasRenderedAnnotations ? (\n        <ChartAnnotationMarkerPortal\n          annotationLookup={annotationLookup}\n          annotationContext={chartWithAnnotations!.annotations![0]!}\n          chartContainer={chartWithAnnotations!.container}\n          plotHeight={plotHeight}\n        />\n      ) : null}\n      {chart ? (\n        <ChartTooltipPortal\n          chart={chart}\n          renderContent={(context) => {\n            // Pie and packedbubble contexts have a single `point`, no `points`\n            // array; time-series has `points`. Packedbubble is discriminated\n            // from pie by `series.type`, since it needs colorIndex-based color\n            // resolution (no per-point `.color`/`.percentage` the way pie has).\n            const ctx = context as {\n              point: {\n                name: string;\n                y: number | null;\n                color: string;\n                percentage: number;\n                index: number;\n              };\n              points?: unknown[];\n              key?: string;\n              colorIndex?: number;\n              series?: { type?: string; index: number };\n            };\n            const isPackedBubble =\n              !ctx.points && ctx.series?.type === \"packedbubble\";\n            const isPie = !ctx.points && !isPackedBubble;\n            const data: ChartTooltipDataRow[] = isPackedBubble\n              ? // Mirrors v1's `transformBubbleChartTooltipData`: color comes from\n                // the outer category's colorIndex, not a per-point `.color`.\n                [\n                  {\n                    color:\n                      (ctx.colorIndex !== undefined\n                        ? colors[ctx.colorIndex]\n                        : undefined) ?? \"\",\n                    name: ctx.key ?? ctx.point.name,\n                    value: ctx.point.y,\n                    seriesIndex: ctx.series?.index,\n                    pointIndex: ctx.point.index,\n                  },\n                ]\n              : isPie\n              ? [\n                  {\n                    color: ctx.point.color,\n                    name: ctx.point.name,\n                    value: ctx.point.y,\n                    percent: ctx.point.percentage,\n                  },\n                ]\n              : // Drop v1's `readonly` array wrapper and `icon` field at the seam —\n                // the v2 surface is mutable and doesn't expose row-level icons.\n                transformTimeSeriesTooltipData({\n                  context,\n                  data: series.map((s, i) => ({\n                    name: s.name,\n                    points: [],\n                    styles: { color: s.color ?? colors[i] ?? \"\" },\n                  })),\n                }).map((row) => ({\n                  color: row.color,\n                  name: row.name,\n                  value: row.value,\n                }));\n            // For pie/packedbubble, `context.x` is meaningless (no x-axis) —\n            // use `context.key`/point name instead. For time-series,\n            // `context.x` is the timestamp/category value. The annotation\n            // lookup always uses `context.point.x` (numeric).\n            const position =\n              isPie || isPackedBubble\n                ? ctx.key ?? ctx.point.name\n                : (context.x as number | string);\n            const resolved = annotationLookup?.get(context.point.x as number);\n            const annotation = resolved\n              ? {\n                  icon: resolved.icon,\n                  color: resolved.color,\n                  title: resolved.title,\n                  description: resolved.description,\n                }\n              : undefined;\n            return renderTooltip({\n              data,\n              position,\n              // Pie/packedbubble have no x-axis position; a title would just repeat the point name.\n              hideTitle: isPie || isPackedBubble,\n              annotation,\n              hasOnClick,\n              tooltipClickLabel,\n              timezone,\n              invalidNumberLabel,\n              valueFormat,\n            });\n          }}\n        />\n      ) : null}\n      {hideLegend ? null : (\n        <div className=\"seeds-chart-legend\">\n          <SeriesLegend\n            items={series.map((s, i) => ({\n              name: s.name,\n              icon: s.icon,\n              color: s.color ?? colors[i] ?? \"\",\n            }))}\n          />\n        </div>\n      )}\n    </>\n  );\n}\n","// Portals DS-owned marker content into Highcharts annotation containers. The\n// marker shape (icon + vertical line in the configured color) is rendered\n// internally — consumers don't supply React nodes. See CE-7.\n\nimport { memo, useEffect, useRef, useState } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { Box } from \"@sproutsocial/seeds-react-box\";\nimport { Icon } from \"@sproutsocial/seeds-react-icon\";\nimport type { ChartAnnotationLookup, ChartAnnotation } from \"./annotations\";\nimport type {\n  ChartAnnotationRuntime,\n  ChartAnnotationRuntimeLabel,\n} from \"./chartBase\";\n\nfunction ChartAnnotationMarker({\n  annotation,\n  lineHeight,\n}: {\n  annotation: ChartAnnotation;\n  /** Vertical pixel length of the marker line. Driven by `chart.plotHeight`\n   *  so the line spans the chart's full plot area regardless of chart size. */\n  lineHeight: number;\n}) {\n  return (\n    <Box display=\"flex\" flexDirection=\"column\" alignItems=\"center\" gap={200}>\n      {annotation.icon ? (\n        <Box\n          display=\"flex\"\n          alignItems=\"center\"\n          justifyContent=\"center\"\n          width=\"20px\"\n          height=\"20px\"\n          bg=\"icon.base\"\n          borderRadius=\"50%\"\n        >\n          <Icon name={annotation.icon} size=\"mini\" color=\"icon.inverse\" />\n        </Box>\n      ) : null}\n      <Box\n        height={`${lineHeight}px`}\n        width=\"0.5px\"\n        bg={annotation.color ?? \"neutral.200\"}\n      />\n    </Box>\n  );\n}\n\n// v2-specific marker attribute. Distinct from v1's `data-annotation-marker`\n// so v1 and v2 portals don't sweep each other's containers when both render\n// side-by-side (e.g. in the v1↔v2 comparison story).\nconst MARKER_ATTR = \"data-v2-chart-annotation-marker\";\n\nexport const ChartAnnotationMarkerPortal = memo(\n  function ChartAnnotationMarkerPortal({\n    annotationLookup,\n    annotationContext,\n    chartContainer,\n    plotHeight,\n  }: {\n    annotationLookup: ChartAnnotationLookup;\n    annotationContext: ChartAnnotationRuntime;\n    /** The chart's own DOM root — every query is scoped here to keep\n     *  multi-chart renders from interfering. */\n    chartContainer: HTMLElement;\n    /** Highcharts' current plot-area height in pixels. Drives the marker\n     *  line length so it spans the chart's plot area at any chart size. */\n    plotHeight: number;\n  }) {\n    const annotationContainers = useRef<Record<number, HTMLDivElement>>({});\n    const [, setRenderCount] = useState(0);\n    const forceRender = () => setRenderCount((prev) => prev + 1);\n\n    useEffect(() => {\n      if (!annotationContext.labels) return;\n\n      const newContainers: Record<number, HTMLDivElement> = {};\n      const existingAnnotationContainers = chartContainer.querySelectorAll(\n        `div[${MARKER_ATTR}='true']`\n      );\n\n      // 1. Mark this chart's existing markers as stale before updating.\n      //    Highcharts doesn't clean these up, so we sweep them below.\n      existingAnnotationContainers.forEach((annotation) =>\n        annotation.setAttribute(MARKER_ATTR, \"false\")\n      );\n\n      annotationContext.labels.forEach((label: ChartAnnotationRuntimeLabel) => {\n        const labelElement = label.graphic?.div;\n        if (!labelElement) return;\n\n        // 2. Reuse this label's existing marker div when present — Highcharts\n        //    repositions (rather than recreates) annotation graphics across\n        //    redraws, so reusing keeps the React portal mounted and avoids the\n        //    teardown→recreate flash. Only create one when absent.\n        let annotationDiv = labelElement.querySelector<HTMLDivElement>(\n          `div[${MARKER_ATTR}]`\n        );\n        if (!annotationDiv) {\n          annotationDiv = document.createElement(\"div\");\n          labelElement.appendChild(annotationDiv);\n        }\n        annotationDiv.setAttribute(MARKER_ATTR, \"true\");\n\n        const xValue = label.options?.point?.x as number;\n        newContainers[xValue] = annotationDiv;\n      });\n\n      annotationContainers.current = newContainers;\n      forceRender();\n\n      // 4. Within this chart's container, remove `.highcharts-annotation`\n      //    parents that no longer have any live v2 marker child.\n      requestAnimationFrame(() => {\n        chartContainer\n          .querySelectorAll(\"div.highcharts-annotation\")\n          .forEach((annotationDiv) => {\n            const reactAnnotations = annotationDiv.querySelectorAll(\n              `div[${MARKER_ATTR}]`\n            );\n            const hasActiveAnnotations = Array.from(reactAnnotations).some(\n              (div) => div.getAttribute(MARKER_ATTR) === \"true\"\n            );\n            if (!hasActiveAnnotations) annotationDiv.remove();\n          });\n      });\n    }, [annotationContext.labels, annotationLookup, chartContainer]);\n\n    return (\n      <>\n        {Object.entries(annotationContainers.current).map(\n          ([xValue, container]) => {\n            const annotation = annotationLookup.get(Number(xValue));\n            return annotation\n              ? createPortal(\n                  <ChartAnnotationMarker\n                    annotation={annotation}\n                    lineHeight={plotHeight}\n                  />,\n                  container\n                )\n              : null;\n          }\n        )}\n      </>\n    );\n  }\n);\n","// Minimal: no locale / currency / duration formatting. Consumers needing those pass their own `tooltip` render prop.\n\nimport { Box } from \"@sproutsocial/seeds-react-box\";\nimport { Icon, type TypeIconName } from \"@sproutsocial/seeds-react-icon\";\nimport { Text } from \"@sproutsocial/seeds-react-text\";\n\nimport { ChartLegendLabel } from \"../../components/ChartLegend/components/ChartLegendLabel\";\nimport {\n  ChartTooltip,\n  ChartTooltipFooter,\n  ChartTooltipHeader,\n  ChartTooltipTable,\n  ChartTooltipTitle,\n  type TypeChartTooltipTableProps,\n} from \"../../components/ChartTooltip\";\nimport type { ChartTooltipProps } from \"./chartBase\";\nimport { valueFormatter } from \"./formatters/valueFormatter\";\n\nfunction formatTitle(position: number | string, timezone?: string): string {\n  if (typeof position === \"string\") return position;\n  // `timeZone` aligns the title with the chart's configured timezone (which\n  // governs the axis ticks). Omitting it would format in the browser's local\n  // zone and disagree with the ticks by up to a day.\n  return new Date(position).toLocaleDateString(undefined, {\n    year: \"numeric\",\n    month: \"long\",\n    day: \"numeric\",\n    weekday: \"long\",\n    timeZone: timezone,\n  });\n}\n\n// Inlined (not v1's `ChartXAnnotationDetails`) because that component requires\n// both iconName and text together — v2's `ChartAnnotation` documents icon,\n// title, and description as independently optional, so the renderer has to\n// match that contract instead of dropping fields silently.\nfunction AnnotationHeader({\n  icon,\n  title,\n  description,\n}: {\n  icon?: TypeIconName;\n  title?: string;\n  description?: string;\n}) {\n  const hasIconOrTitle = Boolean(icon || title);\n  if (!hasIconOrTitle && !description) return null;\n  return (\n    <>\n      {hasIconOrTitle ? (\n        <ChartTooltipHeader>\n          <Box display=\"flex\" alignItems=\"center\" gap={300}>\n            {icon ? <Icon name={icon} size=\"mini\" color=\"icon.base\" /> : null}\n            {title ? (\n              <Text color=\"text.body\" fontSize={200}>\n                {title}\n              </Text>\n            ) : null}\n          </Box>\n        </ChartTooltipHeader>\n      ) : null}\n      {description ? (\n        <ChartTooltipHeader>\n          <Text fontSize={200} color=\"text.subtext\">\n            {description}\n          </Text>\n        </ChartTooltipHeader>\n      ) : null}\n    </>\n  );\n}\n\n// Local to the default tooltip: `hideTotal` opts out of the multi-series Total\n// row. Kept off the shared `ChartTooltipProps` render-prop contract (and off\n// `BarChart`'s public props) intentionally — the chart sets it internally; any\n// consumer-facing tooltip config is deferred to CE-35.\ntype DefaultChartTooltipProps = ChartTooltipProps & { hideTotal?: boolean };\n\nexport function DefaultChartTooltip({\n  data,\n  position,\n  annotation,\n  hasOnClick,\n  tooltipClickLabel,\n  timezone,\n  invalidNumberLabel,\n  valueFormat = {},\n  hideTitle,\n  hideTotal = false,\n}: DefaultChartTooltipProps) {\n  const rows = data.map((d) => {\n    const formattedValue =\n      d.value == null\n        ? invalidNumberLabel ?? \"—\"\n        : valueFormatter({ ...valueFormat, value: d.value, abbreviate: false });\n\n    const nameCell = {\n      content: (\n        <ChartLegendLabel color={d.color}>\n          <Text aria-label={`${d.name}: `}>{d.name}</Text>\n        </ChartLegendLabel>\n      ),\n    };\n\n    // When a row carries `percent` (pie/donut), show percent + value grouped\n    // and flush right, matching v1's DonutChartTooltip: `inline-flex` shrinks\n    // the pair to its content so the cell's `align: right` right-aligns the\n    // whole group (a block `flex` stretched to fill the cell, leaving a gap\n    // between percent and value — svbarker review, PR #2267). Guard NaN:\n    // Highcharts emits NaN% when every slice value is null (total = 0).\n    return {\n      cells: [\n        nameCell,\n        {\n          content:\n            d.percent != null && !isNaN(d.percent) ? (\n              <Box display=\"inline-flex\" alignItems=\"center\" gap={350}>\n                <Text>{Math.round(d.percent)}%</Text>\n                <Text fontWeight=\"semibold\">{formattedValue}</Text>\n              </Box>\n            ) : (\n              <Text>{formattedValue}</Text>\n            ),\n          align: \"right\" as const,\n        },\n      ],\n    };\n  });\n\n  // Multi-series parity with v1/Trellis: append a Total row summing the\n  // contributing (non-null) values. Track contribution count separately from\n  // the sum — `[5, -5]` legitimately totals 0 and must render \"0\", whereas an\n  // all-null set must render the null placeholder, not a misleading 0.\n  const contributing = data.filter((d) => d.value != null);\n  const total =\n    contributing.length > 0\n      ? contributing.reduce((sum, d) => sum + (d.value as number), 0)\n      : null;\n\n  const totalRow =\n    data.length > 1 && !hideTotal\n      ? [\n          {\n            isAppendedRow: true,\n            cells: [\n              {\n                content: (\n                  <Text fontWeight=\"semibold\" aria-label=\"Total: \">\n                    Total\n                  </Text>\n                ),\n              },\n              {\n                // Mirror the per-series value cell's formatting path exactly.\n                content: (\n                  <Text fontWeight=\"bold\">\n                    {total == null\n                      ? invalidNumberLabel ?? \"—\"\n                      : valueFormatter({\n                          ...valueFormat,\n                          value: total,\n                          abbreviate: false,\n                        })}\n                  </Text>\n                ),\n                align: \"right\" as const,\n              },\n            ],\n          },\n        ]\n      : [];\n\n  return (\n    <ChartTooltip>\n      {annotation ? (\n        <AnnotationHeader\n          icon={annotation.icon}\n          title={annotation.title}\n          description={annotation.description}\n        />\n      ) : null}\n      {hideTitle ? null : (\n        <ChartTooltipTitle>{formatTitle(position, timezone)}</ChartTooltipTitle>\n      )}\n      <ChartTooltipTable\n        rows={[...rows, ...totalRow] as TypeChartTooltipTableProps[\"rows\"]}\n      />\n      {hasOnClick && tooltipClickLabel ? (\n        <ChartTooltipFooter>\n          {typeof tooltipClickLabel === \"string\" ? (\n            <Box display=\"flex\" alignItems=\"center\" gap={300}>\n              <Icon name=\"hand-pointer-clicking-outline\" color=\"icon.base\" />\n              <Text color=\"text.subtext\" fontSize={200}>\n                {tooltipClickLabel}\n              </Text>\n            </Box>\n          ) : (\n            tooltipClickLabel\n          )}\n        </ChartTooltipFooter>\n      ) : null}\n    </ChartTooltip>\n  );\n}\n","import { formatDuration } from \"@sproutsocial/seeds-react-duration\";\nimport { formatNumeral } from \"@sproutsocial/seeds-react-numeral\";\n\nimport type { TypeChartNumberFormat } from \"../../../types\";\n\nexport type TypeValuePercentInput = \"decimal\" | \"whole\";\n\nexport type TypeValueFormatterOptions = Readonly<{\n  /** The raw numeric value. For duration, milliseconds. */\n  value: number;\n  /** default \"decimal\" */\n  numberFormat?: TypeChartNumberFormat;\n  /** Only used when numberFormat === \"currency\". default \"USD\" */\n  currency?: string;\n  /** true → 10k threshold; number → max(1000, abs(n)); false → never. default true */\n  abbreviate?: boolean | number;\n  /** \"decimal\" scales 0.42 → \"42%\"; \"whole\" treats 42 → \"42%\". default \"decimal\" */\n  percentInput?: TypeValuePercentInput;\n  /** locale for decimal/currency/percent (formatNumeral) */\n  numberLocale?: Intl.LocalesArgument;\n  /** locale for duration (formatDuration) */\n  textLocale?: Intl.LocalesArgument;\n}>;\n\n/**\n * Pure value formatter for v2 charts. Turns a numeric value plus declarative\n * config into a display string. Composes `formatNumeral` (decimal/currency/\n * percent) and `formatDuration` (duration). Contains no chart-engine types or\n * imports — it upholds the \"engine boundary is one file\" invariant documented\n * in `src/charts/README.md`.\n *\n * The axis-wide \"smart 1k/10k\" abbreviation scan that v1's `yAxisLabelFormatter`\n * derives from `tickPositions` is not available to a pure per-value function;\n * callers pass the lowered threshold via `abbreviate` (a number) instead.\n */\nexport function valueFormatter({\n  value,\n  numberFormat = \"decimal\",\n  currency = \"USD\",\n  abbreviate = true,\n  percentInput = \"decimal\",\n  numberLocale,\n  textLocale,\n}: TypeValueFormatterOptions): string {\n  const numberValue = Number(value);\n\n  // v1 parity: render 0 as a bare \"0\" for every format (clean axis origin) —\n  // not \"$0.00\" / \"0%\" / a duration-zero. Matches v1's yAxisLabelFormatter,\n  // which checks zero first, before any format branch. Revisit if design\n  // wants per-format zero rendering later.\n  if (numberValue === 0) {\n    return formatNumeral({ locale: numberLocale as string, number: 0 });\n  }\n\n  if (numberFormat === \"duration\") {\n    return formatDuration({\n      display: \"narrow\",\n      locale: textLocale,\n      milliseconds: numberValue,\n    });\n  }\n\n  if (numberFormat === \"percent\") {\n    const whole = percentInput === \"decimal\" ? numberValue * 100 : numberValue;\n    return formatNumeral({\n      format: \"percent\",\n      locale: numberLocale as string,\n      number: whole,\n    });\n  }\n\n  // decimal | currency\n  return formatNumeral({\n    abbreviate,\n    currency,\n    format: numberFormat,\n    locale: numberLocale as string,\n    number: numberValue,\n  });\n}\n\n/**\n * Declarative value-format config for axis ticks and the default tooltip — the\n * full {@link TypeValueFormatterOptions} surface minus `value`, which is\n * supplied per-tick / per-row by the caller (the adapter and tooltip).\n */\nexport type ValueFormat = Omit<TypeValueFormatterOptions, \"value\">;\n","import { memo } from \"react\";\nimport { Icon, type TypeIconName } from \"@sproutsocial/seeds-react-icon\";\nimport { ChartLegend } from \"../../components/ChartLegend\";\nimport { ChartLegendLabelContentWithIcon } from \"../../components/ChartLegend/components/ChartLegendLabelContentWithIcon\";\n\nexport interface SeriesLegendItem {\n  name: string;\n  /** Resolved swatch color — caller is responsible for resolving against the active theme. */\n  color: string;\n  /** Seeds icon or partner-logo name rendered before the series name. */\n  icon?: TypeIconName;\n}\n\nexport interface SeriesLegendProps {\n  items: ReadonlyArray<SeriesLegendItem>;\n}\n\n// Internal to `ChartRenderer` — not intended for standalone use. Swatch\n// colors must be resolved by the caller (the chart base does this via\n// `useSeedsChartSetup`) so we keep a single source of truth for the\n// theme-aware palette. If this ever becomes a publicly-exposed primitive,\n// add a `useTheme()` fallback here and relax `item.color` to optional.\nexport const SeriesLegend = memo<SeriesLegendProps>(function SeriesLegend({\n  items,\n}) {\n  const labels = items.map((item) => ({\n    content: (\n      <ChartLegendLabelContentWithIcon\n        icon={\n          item.icon ? (\n            <Icon name={item.icon} fixedWidth aria-hidden />\n          ) : undefined\n        }\n      >\n        {item.name}\n      </ChartLegendLabelContentWithIcon>\n    ),\n    color: item.color,\n  }));\n  return <ChartLegend legendLabels={labels} />;\n});\n","// Public, Highcharts-free surface for the v2 chart export API. This module\n// imports nothing — it is a leaf so it can never form an import cycle with\n// `chartBase`. The `createChartExportHandle` factory that closes over the live\n// `Highcharts.Chart` lives in `chartBase.tsx` (the one file allowed to import\n// \"highcharts\"); the instance never crosses this boundary.\n//\n/**\n * Opaque export API handed to consumers via `ChartRenderer`'s `onReady`. Each\n * callable closes over the chart instance and triggers a client-side download;\n * an optional `filename` overrides the generated default. No Highcharts type,\n * ref, or method shape crosses this boundary.\n */\nexport interface ChartExportHandle {\n  exportPNG: (opts?: { filename?: string }) => Promise<void>;\n  exportSVG: (opts?: { filename?: string }) => Promise<void>;\n  exportPDF: (opts?: { filename?: string }) => Promise<void>;\n  exportCSV: (opts?: { filename?: string }) => Promise<void>;\n}\n\n/**\n * Canonical client-side export formats offered by `ChartExportMenu`. Co-located\n * with `ChartExportHandle` so the format vocabulary lives next to the handle it\n * maps onto; this leaf imports nothing, so re-exporting it carries no cycle risk.\n */\nexport type ChartExportFormat = \"png\" | \"svg\" | \"pdf\" | \"csv\";\n\n/**\n * Default download filename when a consumer doesn't pass a `filename` override:\n * `chart-<type>-<YYYY-MM-DD-HH-mm-ss>`, lowercased with non-alphanumerics\n * collapsed to hyphens. The full datetime (not just the date) avoids collisions\n * between charts exported on the same day. `type` comes from the chart's\n * `chart.type`; it falls back to `chart` when absent.\n */\nexport function defaultFilename(type: string | undefined, now: Date): string {\n  const iso = now.toISOString();\n  const stamp = `${iso.slice(0, 10)}-${iso.slice(11, 19).replace(/:/g, \"-\")}`;\n  return slugify(type ? `chart-${type}-${stamp}` : `chart-${stamp}`);\n}\n\nfunction slugify(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n","import type { SeedsChartOptions, SeedsChartType } from \"./chartBase\";\n\ninterface BaseChartOptionsInput {\n  /** Highcharts chart/series type for the family (`column`, `line`, `area`, `pie`, …). */\n  type: SeedsChartType;\n  /** Accessibility description (Highcharts `accessibility.description`). */\n  description: string;\n  /** The chart region's accessible name (Highcharts `lang.accessibility.svgContainerLabel`, wired by `ChartRenderer`). */\n  svgContainerLabel?: string;\n  /** Seeds-vocab per-point a11y description, wrapped to Highcharts' `Point` by `ChartRenderer`. */\n  point?: {\n    descriptionFormatter?: (point: { name: string; value: number }) => string;\n  };\n  /** Reserve top margin for content drawn above the plot area (e.g. annotation markers). */\n  reserveTopMargin?: boolean;\n  /**\n   * Resolved IANA timezone for the chart (`time.timezone`) — governs datetime\n   * ticks and the tooltip date. Pass the value from `resolveTooltipTimezone`;\n   * `undefined` (a category axis) omits `time` entirely.\n   */\n  timezone?: string;\n}\n\n/**\n * The chart options shared by *every* v2 chart family, independent of axis type:\n * styled-mode + animation-off, the accessibility description, Highcharts' native\n * title/credits/legend disabled (Seeds renders its own legend), and the tooltip-\n * portal config. Families spread the result and add their own axes, `plotOptions`,\n * `series`, and `annotations`.\n *\n * This is the family-agnostic base layer — donut (no axes) consumes it just as\n * the X/Y families do. Axis/series/X-Y-specific sharing lives elsewhere\n * (`axisOptions` + the X/Y pattern-sharing spike), layered on top of this.\n */\nexport function buildBaseChartOptions({\n  type,\n  description,\n  svgContainerLabel,\n  point,\n  reserveTopMargin = false,\n  timezone,\n}: BaseChartOptionsInput): Pick<\n  SeedsChartOptions,\n  | \"chart\"\n  | \"accessibility\"\n  | \"title\"\n  | \"credits\"\n  | \"legend\"\n  | \"tooltip\"\n  | \"time\"\n> {\n  return {\n    chart: {\n      type,\n      styledMode: true,\n      animation: false,\n      ...(reserveTopMargin ? { marginTop: 24 } : {}),\n    },\n    accessibility: { description, svgContainerLabel, point },\n    title: { text: \"\" },\n    credits: { enabled: false },\n    legend: { enabled: false },\n    tooltip: {\n      enabled: true,\n      outside: true,\n      padding: 0,\n      shape: \"rect\",\n      shared: true,\n      hideDelay: 0,\n    },\n    // Chart-global in Highcharts; only meaningful for datetime axes, so it's\n    // present only when a timezone was resolved (omitted for category axes).\n    ...(timezone ? { time: { timezone } } : {}),\n  };\n}\n"]}

package/dist/donut/index.js

@@ -8,7 +8,7 @@ var _chunk33Y5FZTTjs = require('../chunk-33Y5FZTT.js');
 
 
 
-var _chunkGWP3PWIGjs = require('../chunk-GWP3PWIG.js');
+var _chunkGQOKCB3Mjs = require('../chunk-GQOKCB3M.js');
 require('../chunk-2H2Z7PKZ.js');
 
 // src/charts/donut/DonutChart.tsx
@@ -16,7 +16,7 @@ var _react = require('react');
 
 // src/charts/donut/adapter.ts
 function buildDonutOptions(props, colors) {
-  const base = _chunkGWP3PWIGjs.buildBaseChartOptions.call(void 0, {
+  const base = _chunkGQOKCB3Mjs.buildBaseChartOptions.call(void 0, {
     type: "pie",
     description: props.description
   });
@@ -75,7 +75,7 @@ function buildDonutOptions(props, colors) {
 // src/charts/donut/DonutChart.tsx
 var _jsxruntime = require('react/jsx-runtime');
 var DonutChart = _react.memo.call(void 0, function DonutChart2(props) {
-  const { colors } = _chunkGWP3PWIGjs.useSeedsChartSetup.call(void 0, {
+  const { colors } = _chunkGQOKCB3Mjs.useSeedsChartSetup.call(void 0, {
     series: props.data.map((d) => ({ color: d.color }))
   });
   const options = _react.useMemo.call(void 0, 
@@ -91,7 +91,7 @@ var DonutChart = _react.memo.call(void 0, function DonutChart2(props) {
   });
   const tooltip = props.tooltip ? (args) => props.tooltip(args) : void 0;
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ...containerProps, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkGWP3PWIGjs.ChartRenderer,
+    _chunkGQOKCB3Mjs.ChartRenderer,
     {
       options,
       series: props.data.map((d, i) => ({

package/dist/esm/bar/index.js

@@ -2,7 +2,7 @@ import {
   buildAnnotationConfig,
   defaultValueAxisLabelFormatter,
   makeValueAxisLabelFormatter
-} from "../chunk-KQKAVIYW.js";
+} from "../chunk-AEBP4NCY.js";
 import {
   buildDimensionalAxis,
   resolveTooltipTimezone
@@ -17,7 +17,7 @@ import {
   ChartRenderer,
   buildBaseChartOptions,
   useSeedsChartSetup
-} from "../chunk-JGM4M7QV.js";
+} from "../chunk-EHKGDOMK.js";
 import "../chunk-NZX3WPXT.js";
 
 // src/charts/bar/BarChart.tsx
@@ -95,7 +95,6 @@ function buildBarChartOptions(props, direction, series = props.series) {
   const base = buildBaseChartOptions({
     type: chartType,
     description: props.description,
-    valueSuffix: props.valueSuffix,
     reserveTopMargin: Boolean(annotations),
     timezone: tooltipTimezone
   });