@sproutsocial/seeds-react-data-viz 0.17.0 → 0.18.0

package/dist/bar/index.d.mts

@@ -61,6 +61,13 @@ interface BarChartProps {
     tooltipClickLabel?: ReactNode;
     /** Override for the value shown when a data point is null. Defaults to an em-dash. */
     invalidNumberLabel?: ReactNode;
+    /**
+     * Chart title included in the exported image (PNG/SVG/PDF) only — it does
+     * *not* render on screen. The on-screen title is a React sibling outside the
+     * chart SVG and can't be captured on export, so `exportTitle` is baked into
+     * the export clone as a themed native Highcharts title. Omit for no title.
+     */
+    exportTitle?: string;
     /** Fired once per chart instance with a handle for PNG/SVG/PDF/CSV downloads. Re-fires only on remount. */
     onReady?: (handle: ChartExportHandle) => void;
 }

package/dist/bar/index.d.ts

@@ -61,6 +61,13 @@ interface BarChartProps {
     tooltipClickLabel?: ReactNode;
     /** Override for the value shown when a data point is null. Defaults to an em-dash. */
     invalidNumberLabel?: ReactNode;
+    /**
+     * Chart title included in the exported image (PNG/SVG/PDF) only — it does
+     * *not* render on screen. The on-screen title is a React sibling outside the
+     * chart SVG and can't be captured on export, so `exportTitle` is baked into
+     * the export clone as a themed native Highcharts title. Omit for no title.
+     */
+    exportTitle?: string;
     /** Fired once per chart instance with a handle for PNG/SVG/PDF/CSV downloads. Re-fires only on remount. */
     onReady?: (handle: ChartExportHandle) => void;
 }

package/dist/bar/index.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunkVVGBJOFHjs = require('../chunk-VVGBJOFH.js');
+var _chunkGVAMWFB7js = require('../chunk-GVAMWFB7.js');
 
 
 
@@ -11,7 +11,7 @@ var _chunk6D7P3IOTjs = require('../chunk-6D7P3IOT.js');
 
 
 
-var _chunk2K7PFHIMjs = require('../chunk-2K7PFHIM.js');
+var _chunkXP7HNV23js = require('../chunk-XP7HNV23.js');
 
 
 var _chunkWEKDYQ4Tjs = require('../chunk-WEKDYQ4T.js');
@@ -27,7 +27,7 @@ function buildBarChartOptions(props, direction, series = props.series) {
   const chartType = highchartsType(direction);
   const isDatetime = props.xAxis.type === "datetime";
   const tooltipTimezone = _chunk6D7P3IOTjs.resolveTooltipTimezone.call(void 0, props.xAxis, props.timezone);
-  const { annotations, lookup: annotationLookup } = _chunkVVGBJOFHjs.buildAnnotationConfig.call(void 0, 
+  const { annotations, lookup: annotationLookup } = _chunkGVAMWFB7js.buildAnnotationConfig.call(void 0, 
     props.annotations
   );
   const barTypeConfig = {
@@ -74,7 +74,7 @@ function buildBarChartOptions(props, direction, series = props.series) {
     }
   };
   const options = {
-    ..._chunk2K7PFHIMjs.buildBaseChartOptions.call(void 0, {
+    ..._chunkXP7HNV23js.buildBaseChartOptions.call(void 0, {
       type: chartType,
       description: props.description,
       valueSuffix: props.valueSuffix,
@@ -86,13 +86,16 @@ function buildBarChartOptions(props, direction, series = props.series) {
       min: _optionalChain([props, 'access', _11 => _11.yAxis, 'optionalAccess', _12 => _12.min]),
       max: _optionalChain([props, 'access', _13 => _13.yAxis, 'optionalAccess', _14 => _14.max]),
       gridLineWidth: _optionalChain([props, 'access', _15 => _15.yAxis, 'optionalAccess', _16 => _16.showGridLines]) === false ? 0 : 1,
+      // A dedicated plotLine at 0, styled distinctly from regular gridlines
+      // (see chartStyles.ts).
+      plotLines: [{ value: 0, className: "y-axis-zero-line", zIndex: 3 }],
       title: { text: _nullishCoalesce(_optionalChain([props, 'access', _17 => _17.yAxis, 'optionalAccess', _18 => _18.title]), () => ( "")) },
       labels: {
         // `showLabels` toggles tick-label visibility; defaults to shown.
         enabled: _optionalChain([props, 'access', _19 => _19.yAxis, 'optionalAccess', _20 => _20.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', _21 => _21.yAxis, 'optionalAccess', _22 => _22.format]) ? _chunkVVGBJOFHjs.makeValueAxisLabelFormatter.call(void 0, props.yAxis.format) : _chunkVVGBJOFHjs.defaultValueAxisLabelFormatter
+        formatter: _optionalChain([props, 'access', _21 => _21.yAxis, 'optionalAccess', _22 => _22.format]) ? _chunkGVAMWFB7js.makeValueAxisLabelFormatter.call(void 0, props.yAxis.format) : _chunkGVAMWFB7js.defaultValueAxisLabelFormatter
       }
     },
     plotOptions: {
@@ -163,7 +166,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 } = _chunk2K7PFHIMjs.useSeedsChartSetup.call(void 0, {
+  const { colors, series } = _chunkXP7HNV23js.useSeedsChartSetup.call(void 0, {
     series: props.series,
     seriesLimit,
     isSeriesLimitOverridden: props.seriesLimit !== void 0,
@@ -183,7 +186,7 @@ var BarChart = _react.memo.call(void 0, function BarChart2(props) {
       $hasOnClick: hasOnClick,
       bg: "container.background.base",
       children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-        _chunk2K7PFHIMjs.ChartRenderer,
+        _chunkXP7HNV23js.ChartRenderer,
         {
           options,
           series,
@@ -195,6 +198,7 @@ var BarChart = _react.memo.call(void 0, function BarChart2(props) {
           timezone: tooltipTimezone,
           invalidNumberLabel: props.invalidNumberLabel,
           valueFormat: _optionalChain([props, 'access', _23 => _23.yAxis, 'optionalAccess', _24 => _24.format]),
+          exportTitle: props.exportTitle,
           onReady: props.onReady
         }
       )

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/bar/styles.ts","../../src/charts/shared/styles.ts","../../src/charts/constants.ts"],"names":["css","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 { buildBarChartOptions } from \"./adapter\";\nimport { BarStyledBox } from \"./styles\";\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  return (\n    <BarStyledBox\n      $colors={colors}\n      $hasOnClick={hasOnClick}\n      bg=\"container.background.base\"\n    >\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        onReady={props.onReady}\n      />\n    </BarStyledBox>\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 {\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  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; this mirrors\n    // v1's `pointWidth: 20` time-series treatment. Dense datetime data may\n    // 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          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          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 options: SeedsChartOptions = {\n    ...buildBaseChartOptions({\n      type: chartType,\n      description: props.description,\n      valueSuffix: props.valueSuffix,\n      reserveTopMargin: Boolean(annotations),\n      timezone: tooltipTimezone,\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      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","import styled, { css } from \"styled-components\";\nimport { Box } from \"@sproutsocial/seeds-react-box\";\nimport { timeSeriesChartStyles } from \"../../styles/chartStyles\";\nimport { axisLabelV2Styles } from \"../shared/styles\";\nimport type {\n  TypeChartStyleColor,\n  TypeChartStyleHasOnClick,\n} from \"../../types\";\n\ntype StyleProps = Readonly<{\n  $colors: ReadonlyArray<TypeChartStyleColor>;\n  $hasOnClick: TypeChartStyleHasOnClick;\n}>;\n\n// Direction-neutral styling shared by the v2 bar family (vertical + horizontal).\n// Consumes only the v1 `timeSeriesChartStyles` base and owns the hover-dimming\n// block itself, keyed on the neutral `.bar-point-hover` class the adapter emits\n// — so v2 no longer imports v1 *component* styles (see `shared/styles.ts`).\nexport const barFamilyStyles = css<StyleProps>`\n  ${timeSeriesChartStyles}\n\n  /*\n    When the chart container is hovered, dim all bars. Then restore opacity for\n    the hovered bar(s) — flagged with the bar-point-hover class by the adapter —\n    so the non-hovered bars fade out.\n  */\n  .highcharts-container:hover .highcharts-point {\n    fill-opacity: 0.3;\n  }\n\n  .highcharts-point.bar-point-hover {\n    fill-opacity: 1 !important;\n  }\n`;\n\nexport const BarStyledBox = styled(Box)<StyleProps>`\n  ${barFamilyStyles}\n  ${axisLabelV2Styles}\n`;\n","import { css } from \"styled-components\";\n\n/**\n * v2 chart axis-label styles. v2 charts render in `styledMode` with\n * `useHTML: false`, so axis labels are SVG `<text>` / `<tspan>` rather than the\n * HTML `<span>`s v1 uses; these mirror the v1 HTML label rules in\n * `styles/chartStyles.ts` for the SVG element type.\n *\n * Kept here, separate from v1's `timeSeriesChartStyles`: v2 may *consume* the v1\n * styles, but v2-specific rules must not accrete into the v1 files — that keeps\n * the eventual v1 → v2 port clean and avoids coupling. Compose this into each v2\n * chart family's styled wrapper.\n */\nexport const axisLabelV2Styles = css`\n  .highcharts-xaxis-labels,\n  .highcharts-yaxis-labels {\n    // SVG labels (styledMode): fill is the SVG text colour; color has no effect.\n    text {\n      font-family: ${({ theme }) => theme.fontFamily};\n      ${({ theme }) => theme.typography[100]};\n      font-weight: ${({ theme }) => theme.fontWeights.normal};\n      fill: ${({ theme }) => theme.colors.text.subtext};\n    }\n  }\n  // Two-line stacked datetime label: the boundary token is an\n  // hc-axis-label-secondary tspan on a second line, rendered semibold.\n  .highcharts-xaxis-labels text tspan.hc-axis-label-secondary {\n    font-weight: ${({ theme }) => theme.fontWeights.semibold};\n  }\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/bar/styles.ts","../../src/charts/shared/styles.ts","../../src/charts/constants.ts"],"names":["css","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 { buildBarChartOptions } from \"./adapter\";\nimport { BarStyledBox } from \"./styles\";\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  return (\n    <BarStyledBox\n      $colors={colors}\n      $hasOnClick={hasOnClick}\n      bg=\"container.background.base\"\n    >\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    </BarStyledBox>\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 {\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  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; this mirrors\n    // v1's `pointWidth: 20` time-series treatment. Dense datetime data may\n    // 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          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          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 options: SeedsChartOptions = {\n    ...buildBaseChartOptions({\n      type: chartType,\n      description: props.description,\n      valueSuffix: props.valueSuffix,\n      reserveTopMargin: Boolean(annotations),\n      timezone: tooltipTimezone,\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","import styled, { css } from \"styled-components\";\nimport { Box } from \"@sproutsocial/seeds-react-box\";\nimport { timeSeriesChartStyles } from \"../../styles/chartStyles\";\nimport { axisLabelV2Styles } from \"../shared/styles\";\nimport type {\n  TypeChartStyleColor,\n  TypeChartStyleHasOnClick,\n} from \"../../types\";\n\ntype StyleProps = Readonly<{\n  $colors: ReadonlyArray<TypeChartStyleColor>;\n  $hasOnClick: TypeChartStyleHasOnClick;\n}>;\n\n// Direction-neutral styling shared by the v2 bar family (vertical + horizontal).\n// Consumes only the v1 `timeSeriesChartStyles` base and owns the hover-dimming\n// block itself, keyed on the neutral `.bar-point-hover` class the adapter emits\n// — so v2 no longer imports v1 *component* styles (see `shared/styles.ts`).\nexport const barFamilyStyles = css<StyleProps>`\n  ${timeSeriesChartStyles}\n\n  /*\n    When the chart container is hovered, dim all bars. Then restore opacity for\n    the hovered bar(s) — flagged with the bar-point-hover class by the adapter —\n    so the non-hovered bars fade out.\n  */\n  .highcharts-container:hover .highcharts-point {\n    fill-opacity: 0.3;\n  }\n\n  .highcharts-point.bar-point-hover {\n    fill-opacity: 1 !important;\n  }\n`;\n\nexport const BarStyledBox = styled(Box)<StyleProps>`\n  ${barFamilyStyles}\n  ${axisLabelV2Styles}\n`;\n","import { css } from \"styled-components\";\n\n/**\n * v2 chart axis-label styles. v2 charts render in `styledMode` with\n * `useHTML: false`, so axis labels are SVG `<text>` / `<tspan>` rather than the\n * HTML `<span>`s v1 uses; these mirror the v1 HTML label rules in\n * `styles/chartStyles.ts` for the SVG element type.\n *\n * Kept here, separate from v1's `timeSeriesChartStyles`: v2 may *consume* the v1\n * styles, but v2-specific rules must not accrete into the v1 files — that keeps\n * the eventual v1 → v2 port clean and avoids coupling. Compose this into each v2\n * chart family's styled wrapper.\n */\nexport const axisLabelV2Styles = css`\n  .highcharts-xaxis-labels,\n  .highcharts-yaxis-labels {\n    // SVG labels (styledMode): fill is the SVG text colour; color has no effect.\n    text {\n      font-family: ${({ theme }) => theme.fontFamily};\n      ${({ theme }) => theme.typography[100]};\n      font-weight: ${({ theme }) => theme.fontWeights.normal};\n      fill: ${({ theme }) => theme.colors.text.subtext};\n    }\n  }\n  // Two-line stacked datetime label: the boundary token is an\n  // hc-axis-label-secondary tspan on a second line, rendered semibold.\n  .highcharts-xaxis-labels text tspan.hc-axis-label-secondary {\n    font-weight: ${({ theme }) => theme.fontWeights.semibold};\n  }\n`;\n","export const BAR_CHART_DEFAULT_SERIES_LIMIT = 10;\n"]}

package/dist/{chunk-VVGBJOFH.js → chunk-GVAMWFB7.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 _chunk2K7PFHIMjs = require('./chunk-2K7PFHIM.js');
+var _chunkXP7HNV23js = require('./chunk-XP7HNV23.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 _chunk2K7PFHIMjs.valueFormatter.call(void 0, { ...format, value: numberValue, abbreviate });
+    return _chunkXP7HNV23js.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-VVGBJOFH.js.map
+//# sourceMappingURL=chunk-GVAMWFB7.js.map

package/dist/{chunk-VVGBJOFH.js.map → chunk-GVAMWFB7.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-VVGBJOFH.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-VVGBJOFH.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-GVAMWFB7.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-GVAMWFB7.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-2K7PFHIM.js → chunk-XP7HNV23.js}

@@ -210,12 +210,12 @@ function DefaultChartTooltip({
   tooltipClickLabel,
   timezone,
   invalidNumberLabel,
-  valueFormat,
+  valueFormat = {},
   hideTitle,
   hideTotal = false
 }) {
   const rows = data.map((d) => {
-    const formattedValue = d.value == null ? _nullishCoalesce(invalidNumberLabel, () => ( "\u2014")) : valueFormat ? valueFormatter({ ...valueFormat, value: d.value, abbreviate: false }) : d.value;
+    const formattedValue = d.value == null ? _nullishCoalesce(invalidNumberLabel, () => ( "\u2014")) : valueFormatter({ ...valueFormat, value: d.value, abbreviate: false });
     const nameCell = {
       content: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkWEKDYQ4Tjs.ChartLegendLabel, { color: d.color, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _seedsreacttext.Text, { "aria-label": `${d.name}: `, children: d.name }) })
     };
@@ -246,11 +246,11 @@ function DefaultChartTooltip({
         },
         {
           // Mirror the per-series value cell's formatting path exactly.
-          content: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _seedsreacttext.Text, { fontWeight: "bold", children: total == null ? _nullishCoalesce(invalidNumberLabel, () => ( "\u2014")) : valueFormat ? valueFormatter({
+          content: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _seedsreacttext.Text, { fontWeight: "bold", children: total == null ? _nullishCoalesce(invalidNumberLabel, () => ( "\u2014")) : valueFormatter({
             ...valueFormat,
             value: total,
             abbreviate: false
-          }) : total }),
+          }) }),
           align: "right"
         }
       ]
@@ -370,7 +370,12 @@ function useSeedsChartSetup({
   }, [cappedSeries, includePatterns]);
   return { theme, colors, patterns, series: cappedSeries };
 }
-function buildExportChartOptions(theme, colors) {
+function buildExportChartOptions({
+  theme,
+  colors,
+  exportTitle: rawTitle
+}) {
+  const exportTitle = _optionalChain([rawTitle, 'optionalAccess', _6 => _6.trim, 'call', _7 => _7()]);
   const axisOptions = {
     lineColor: theme.colors.container.border.base,
     gridLineColor: theme.colors.container.border.base,
@@ -414,13 +419,35 @@ function buildExportChartOptions(theme, colors) {
         width: 1
       }
     },
-    // No zero-line: the `y-axis-zero-line` rule in chartStyles is a v1 leftover;
-    // the v2 bar adapter never creates that plotLine.
-    yAxis: axisOptions
+    yAxis: {
+      ...axisOptions,
+      // The live chart's plotLines (set by the adapter) merge with this by
+      // array index, so `className`/`value`/`zIndex` survive — this only adds
+      // the color the `y-axis-zero-line` CSS class can't reach in styledMode:false.
+      plotLines: [
+        { value: 0, color: theme.colors.container.border.decorative.neutral }
+      ]
+    },
+    // The on-screen title is a React sibling (`Text.SmallSubHeadline`) rendered
+    // above the chart, outside the SVG, so the export can't capture it. Bake a
+    // themed native Highcharts title into the clone instead (same treatment as
+    // the legend above), styled to match the Seeds SmallSubHeadline. Guarded so a
+    // chart with no title produces no native title in the export.
+    ...exportTitle ? {
+      title: {
+        text: exportTitle,
+        style: {
+          color: theme.colors.text.headline,
+          fontFamily: theme.fontFamily,
+          fontSize: theme.typography[200].fontSize,
+          fontWeight: String(theme.fontWeights.bold)
+        }
+      }
+    } : {}
   };
 }
 function createChartExportHandle(chart, getExportChartOptions) {
-  const resolveName = (filename) => _nullishCoalesce(filename, () => ( defaultFilename(_optionalChain([chart, 'access', _6 => _6.options, 'access', _7 => _7.chart, 'optionalAccess', _8 => _8.type]), /* @__PURE__ */ new Date())));
+  const resolveName = (filename) => _nullishCoalesce(filename, () => ( defaultFilename(_optionalChain([chart, 'access', _8 => _8.options, 'access', _9 => _9.chart, 'optionalAccess', _10 => _10.type]), /* @__PURE__ */ new Date())));
   const exportImage = async (type, filename) => {
     chart.exportChartLocal(
       { type, filename: resolveName(filename) },
@@ -459,6 +486,7 @@ function ChartRenderer({
   invalidNumberLabel,
   valueFormat,
   hideLegend = false,
+  exportTitle,
   onReady
 }) {
   const [chart, setChart] = _react.useState.call(void 0, null);
@@ -466,10 +494,10 @@ function ChartRenderer({
   const chartIsStacked = isChartStacked(options);
   const renderTooltip = _nullishCoalesce(tooltip, () => ( ((args) => DefaultChartTooltip({ ...args, hideTotal: !chartIsStacked }))));
   const theme = _styledcomponents.useTheme.call(void 0, );
-  const exportThemeRef = _react.useRef.call(void 0, { theme, colors });
-  exportThemeRef.current = { theme, colors };
+  const exportThemeRef = _react.useRef.call(void 0, { theme, colors, exportTitle });
+  exportThemeRef.current = { theme, colors, exportTitle };
   const captureChart = _react.useCallback.call(void 0, (chartInstance) => {
-    const forExport = _optionalChain([chartInstance, 'access', _9 => _9.options, 'access', _10 => _10.chart, 'optionalAccess', _11 => _11.forExport]);
+    const forExport = _optionalChain([chartInstance, 'access', _11 => _11.options, 'access', _12 => _12.chart, 'optionalAccess', _13 => _13.forExport]);
     if (!forExport) {
       setChart(chartInstance);
       setPlotHeight(chartInstance.plotHeight);
@@ -479,13 +507,10 @@ function ChartRenderer({
   onReadyRef.current = onReady;
   _react.useEffect.call(void 0, () => {
     if (!chart) return;
-    _optionalChain([onReadyRef, 'access', _12 => _12.current, 'optionalCall', _13 => _13(
+    _optionalChain([onReadyRef, 'access', _14 => _14.current, 'optionalCall', _15 => _15(
       createChartExportHandle(
         chart,
-        () => buildExportChartOptions(
-          exportThemeRef.current.theme,
-          exportThemeRef.current.colors
-        )
+        () => buildExportChartOptions(exportThemeRef.current)
       )
     )]);
   }, [chart]);
@@ -514,7 +539,7 @@ function ChartRenderer({
   );
   if (series.length === 0) return null;
   const chartWithAnnotations = chart;
-  const hasRenderedAnnotations = !!_optionalChain([chartWithAnnotations, 'optionalAccess', _14 => _14.annotations, 'optionalAccess', _15 => _15.length]) && !!_optionalChain([annotationLookup, 'optionalAccess', _16 => _16.size]) && plotHeight > 0;
+  const hasRenderedAnnotations = !!_optionalChain([chartWithAnnotations, 'optionalAccess', _16 => _16.annotations, 'optionalAccess', _17 => _17.length]) && !!_optionalChain([annotationLookup, 'optionalAccess', _18 => _18.size]) && plotHeight > 0;
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _jsxruntime.Fragment, { children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkWEKDYQ4Tjs.GlobalChartStyleOverrides, {}),
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
@@ -565,7 +590,7 @@ function ChartRenderer({
             }))
           );
           const position = isPie ? _nullishCoalesce(ctx.key, () => ( ctx.point.name)) : context.x;
-          const resolved = _optionalChain([annotationLookup, 'optionalAccess', _17 => _17.get, 'call', _18 => _18(context.point.x)]);
+          const resolved = _optionalChain([annotationLookup, 'optionalAccess', _19 => _19.get, 'call', _20 => _20(context.point.x)]);
           const annotation = resolved ? {
             icon: resolved.icon,
             color: resolved.color,
@@ -640,4 +665,4 @@ function buildBaseChartOptions({
 
 
 exports.valueFormatter = valueFormatter; exports.useSeedsChartSetup = useSeedsChartSetup; exports.ChartRenderer = ChartRenderer; exports.buildBaseChartOptions = buildBaseChartOptions;
-//# sourceMappingURL=chunk-2K7PFHIM.js.map
+//# sourceMappingURL=chunk-XP7HNV23.js.map

package/dist/chunk-XP7HNV23.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-XP7HNV23.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-XP7HNV23.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 {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { useTheme } from \"styled-components\";\n\nimport { Box } from \"@sproutsocial/seeds-react-box\";\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\n/** Highcharts series type. `column` is vertical bars; `bar` is horizontal bars; the line/area family adds the rest; `pie` is donut/pie. */\nexport type SeedsChartType =\n  | \"column\"\n  | \"bar\"\n  | \"line\"\n  | \"spline\"\n  | \"area\"\n  | \"areaspline\"\n  | \"pie\";\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  valueSuffix?: string;\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    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 click: `this` is the Highcharts Point object (carries `name`, etc.). */\n  point?: { events?: { click?: (this: { name: string }) => void } };\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\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}\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}\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<SeedsChartSeriesOptions | SeedsChartPieSeriesOptions>;\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}\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    () =>\n      ({\n        ...options,\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\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 context has a single `point`; time-series has a `points` array.\n            // Discriminate on the absence of `points` — pie never has it.\n            const ctx = context as {\n              point: {\n                name: string;\n                y: number | null;\n                color: string;\n                percentage: number;\n              };\n              points?: unknown[];\n              key?: string;\n            };\n            const isPie = !ctx.points;\n            const data: ChartTooltipDataRow[] = 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, `context.x` is the numeric slice index — use `context.key`\n            // (the slice name) as the tooltip title instead.\n            // For time-series, `context.x` is the timestamp/category value.\n            // The annotation lookup always uses `context.point.x` (numeric).\n            const position = isPie\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 has no x-axis position; its title would just repeat the slice name.\n              hideTitle: isPie,\n              annotation,\n              hasOnClick,\n              tooltipClickLabel,\n              timezone,\n              invalidNumberLabel,\n              valueFormat,\n            });\n          }}\n        />\n      ) : null}\n      {hideLegend ? null : (\n        <Box mt={350}>\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        </Box>\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  /** Appended to each tooltip value (e.g. `\" MT\"`, `\"%\"`). */\n  valueSuffix?: string;\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  valueSuffix,\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 },\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      valueSuffix,\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.d.mts

@@ -39,6 +39,13 @@ interface DonutChartProps {
     onClick?: ({ position }: {
         position: string;
     }) => void;
+    /**
+     * Chart title included in the exported image (PNG/SVG/PDF) only — it does
+     * *not* render on screen. The on-screen title is a React sibling outside the
+     * chart SVG and can't be captured on export, so `exportTitle` is baked into
+     * the export clone as a themed native Highcharts title. Omit for no title.
+     */
+    exportTitle?: string;
     /** Fired once per chart instance with a handle for PNG/SVG/PDF/CSV exports. */
     onReady?: (handle: ChartExportHandle) => void;
 }

package/dist/donut/index.d.ts

@@ -39,6 +39,13 @@ interface DonutChartProps {
     onClick?: ({ position }: {
         position: string;
     }) => void;
+    /**
+     * Chart title included in the exported image (PNG/SVG/PDF) only — it does
+     * *not* render on screen. The on-screen title is a React sibling outside the
+     * chart SVG and can't be captured on export, so `exportTitle` is baked into
+     * the export clone as a themed native Highcharts title. Omit for no title.
+     */
+    exportTitle?: string;
     /** Fired once per chart instance with a handle for PNG/SVG/PDF/CSV exports. */
     onReady?: (handle: ChartExportHandle) => void;
 }