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

package/dist/chunk-6D7P3IOT.js

@@ -0,0 +1,150 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } 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; }// src/charts/shared/formatters/datetimeFormatter.ts
+var DAY_MS = 864e5;
+var WEEK_MS = 6048e5;
+var MIN_MONTH_MS = 24192e5;
+var MIN_YEAR_MS = 31536e6;
+var getDatePartsInTimezone = (date, timezone) => {
+  const formatter = new Intl.DateTimeFormat("en-US", {
+    year: "numeric",
+    month: "numeric",
+    day: "numeric",
+    timeZone: timezone
+  });
+  const parts = formatter.formatToParts(date);
+  return {
+    day: parseInt(_nullishCoalesce(_optionalChain([parts, 'access', _ => _.find, 'call', _2 => _2((p) => p.type === "day"), 'optionalAccess', _3 => _3.value]), () => ( "0")), 10),
+    month: parseInt(_nullishCoalesce(_optionalChain([parts, 'access', _4 => _4.find, 'call', _5 => _5((p) => p.type === "month"), 'optionalAccess', _6 => _6.value]), () => ( "0")), 10),
+    year: parseInt(_nullishCoalesce(_optionalChain([parts, 'access', _7 => _7.find, 'call', _8 => _8((p) => p.type === "year"), 'optionalAccess', _9 => _9.value]), () => ( "0")), 10)
+  };
+};
+var deriveGranularity = (tickPositions) => {
+  if (tickPositions.length < 2) {
+    return "day";
+  }
+  const deltas = [];
+  for (let i = 1; i < tickPositions.length; i++) {
+    const curr = tickPositions[i];
+    const prev = tickPositions[i - 1];
+    if (curr === void 0 || prev === void 0) {
+      continue;
+    }
+    deltas.push(Math.abs(curr - prev));
+  }
+  deltas.sort((a, b) => a - b);
+  const mid = Math.floor(deltas.length / 2);
+  const upper = deltas[mid];
+  const lower = deltas[mid - 1];
+  const median = deltas.length % 2 === 0 && lower !== void 0 ? (lower + upper) / 2 : upper;
+  if (median < DAY_MS) {
+    return "hour";
+  }
+  if (median < WEEK_MS) {
+    return "day";
+  }
+  if (median < MIN_MONTH_MS) {
+    return "week";
+  }
+  if (median < MIN_YEAR_MS) {
+    return "month";
+  }
+  return "year";
+};
+function datetimeFormatter({
+  value,
+  tickPositions = [],
+  // optional
+  timezone = "UTC",
+  timeFormat = "12",
+  textLocale = "en-US"
+}) {
+  if (typeof value === "string" || !Number.isFinite(value)) {
+    return { primary: String(value) };
+  }
+  const granularity = deriveGranularity(tickPositions);
+  const tickIndex = tickPositions.indexOf(value);
+  const isFirst = tickIndex === 0;
+  const previousValue = tickPositions[tickIndex - 1];
+  const valueDate = new Date(value);
+  const valueParts = getDatePartsInTimezone(valueDate, timezone);
+  const previousValueDate = previousValue ? new Date(previousValue) : void 0;
+  const previousValueParts = previousValueDate ? getDatePartsInTimezone(previousValueDate, timezone) : void 0;
+  let firstPartOptions = {};
+  let secondPartOptions = {};
+  switch (granularity) {
+    case "hour":
+      firstPartOptions = timeFormat === "24" ? { hour: "numeric", minute: "numeric", hour12: false } : { hour: "numeric" };
+      if (isFirst || valueParts.day !== _optionalChain([previousValueParts, 'optionalAccess', _10 => _10.day])) {
+        secondPartOptions = { day: "numeric", month: "short" };
+      }
+      break;
+    case "day":
+    case "week":
+      firstPartOptions = { day: "numeric" };
+      if (isFirst || valueParts.month !== _optionalChain([previousValueParts, 'optionalAccess', _11 => _11.month])) {
+        secondPartOptions = { month: "short" };
+      }
+      break;
+    case "month":
+      firstPartOptions = { month: "short" };
+      if (isFirst || valueParts.year !== _optionalChain([previousValueParts, 'optionalAccess', _12 => _12.year])) {
+        secondPartOptions = { year: "numeric" };
+      }
+      break;
+    case "year":
+      firstPartOptions = { year: "numeric" };
+      break;
+    default:
+      firstPartOptions = {};
+      break;
+  }
+  const primary = new Intl.DateTimeFormat(textLocale, {
+    ...firstPartOptions,
+    timeZone: timezone
+  }).format(valueDate);
+  if (Object.keys(secondPartOptions).length > 0) {
+    const secondary = new Intl.DateTimeFormat(textLocale, {
+      ...secondPartOptions,
+      timeZone: timezone
+    }).format(valueDate);
+    return { primary, secondary };
+  }
+  return { primary };
+}
+
+// src/charts/shared/axisOptions.ts
+function makeDatetimeAxisLabelFormatter(timezone, timeFormat) {
+  return function() {
+    const { primary, secondary } = datetimeFormatter({
+      value: this.value,
+      tickPositions: _nullishCoalesce(this.axis.tickPositions, () => ( [])),
+      timezone,
+      timeFormat
+    });
+    return secondary ? `${primary}<br/><span class="hc-axis-label-secondary">${secondary}</span>` : primary;
+  };
+}
+function buildDimensionalAxis(axis, timezone) {
+  if (axis.type === "datetime") {
+    return {
+      type: "datetime",
+      crosshair: axis.crosshair,
+      labels: {
+        formatter: makeDatetimeAxisLabelFormatter(timezone, axis.timeFormat)
+      }
+    };
+  }
+  return {
+    type: "category",
+    categories: [...axis.categories],
+    crosshair: axis.crosshair
+  };
+}
+function resolveTooltipTimezone(axis, timezone) {
+  return axis.type === "datetime" ? _nullishCoalesce(timezone, () => ( "UTC")) : void 0;
+}
+
+
+
+
+exports.buildDimensionalAxis = buildDimensionalAxis; exports.resolveTooltipTimezone = resolveTooltipTimezone;
+//# sourceMappingURL=chunk-6D7P3IOT.js.map

package/dist/chunk-6D7P3IOT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-6D7P3IOT.js","../src/charts/shared/formatters/datetimeFormatter.ts","../src/charts/shared/axisOptions.ts"],"names":[],"mappings":"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","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-6D7P3IOT.js","sourcesContent":[null,"/**\n * Pure, Highcharts-free datetime axis label formatter for v2 chart families.\n *\n * Ports v1's `helpers/xAxisLabelFormatter` into a rendering-agnostic shape: it\n * returns a `{ primary, secondary? }` object instead of an HTML string, leaving\n * SVG rendering to the caller. The timezone- and DST-correct boundary detection\n * (calendar parts read in the target timezone) and the per-granularity\n * `Intl.DateTimeFormat` option sets are a near-verbatim port of v1.\n *\n * The one net-new piece versus v1 is granularity derivation: v1 receives\n * `unitName` from Highcharts, but `charts/` may not depend on Highcharts types\n * (see `charts/README.md` invariants), so granularity is derived from the\n * spacing of `tickPositions`.\n */\n\n// Local types — defined here rather than imported from the Highcharts package\n// or v1's src/types.ts, to keep charts/ self-contained per the README invariant.\nexport type DatetimeTimeFormat = \"12\" | \"24\";\n\nexport type DatetimeLabel = Readonly<{\n  primary: string;\n  /** Omitted (undefined) when the tick is not on a unit boundary. */\n  secondary?: string;\n}>;\n\ntype DatetimeGranularity = \"hour\" | \"day\" | \"week\" | \"month\" | \"year\";\n\ntype DatetimeFormatterInput = Readonly<{\n  /** ms-epoch tick value, or a categorical string passed through verbatim. */\n  value: number | string;\n  /** Full tick array — used for boundary lookup and granularity derivation. */\n  tickPositions: readonly number[];\n  // optional\n  /** IANA timezone. Defaults to \"UTC\". */\n  timezone?: string;\n  /** \"12\" | \"24\" hour clock for the hour granularity. Defaults to \"12\". */\n  timeFormat?: DatetimeTimeFormat;\n  /** Locale for Intl formatting. Defaults to \"en-US\". */\n  textLocale?: Intl.LocalesArgument;\n}>;\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars -- kept alongside DAY_MS/WEEK_MS for upcoming duration formatting; stable numeric constant unlikely to drift\nconst HOUR_MS = 3_600_000;\nconst DAY_MS = 86_400_000;\nconst WEEK_MS = 604_800_000;\n// Granularity cutoffs use the *minimum* month/year length, not the average, so\n// calendar-aligned axes classify correctly: a real Highcharts month-unit axis\n// sits 28–31d apart and a year-unit axis 365–366d apart. Comparing the median\n// tick delta against the *average* month (30.44d) / year (365.25d) length\n// misclassified a 28-day February month gap as \"week\" and a 365-day non-leap\n// year as \"month\". Bias to the minimum so the shortest real span still reads as\n// \"month\" / \"year\".\nconst MIN_MONTH_MS = 2_419_200_000; // 28 days (shortest month, non-leap Feb)\nconst MIN_YEAR_MS = 31_536_000_000; // 365 days (shortest, non-leap year)\n\n/**\n * Reads the calendar day/month/year of a date *in the target timezone* via\n * `Intl.DateTimeFormat(...).formatToParts`. This is what makes boundary\n * detection timezone- and DST-correct (a 25-hour \"fall back\" day still rolls\n * the day over on the correct local-midnight tick). Ported verbatim from v1.\n */\nconst getDatePartsInTimezone = (date: Date, timezone: string) => {\n  const formatter = new Intl.DateTimeFormat(\"en-US\", {\n    year: \"numeric\",\n    month: \"numeric\",\n    day: \"numeric\",\n    timeZone: timezone,\n  });\n  const parts = formatter.formatToParts(date);\n  return {\n    day: parseInt(parts.find((p) => p.type === \"day\")?.value ?? \"0\", 10),\n    month: parseInt(parts.find((p) => p.type === \"month\")?.value ?? \"0\", 10),\n    year: parseInt(parts.find((p) => p.type === \"year\")?.value ?? \"0\", 10),\n  };\n};\n\n/**\n * Derives the axis granularity from the median delta between consecutive\n * `tickPositions`. Median (not mean) so an irregular first/last gap does not\n * skew the result. With fewer than two ticks there is no spacing to measure, so\n * we default to \"day\".\n *\n * Note: \"day\" and \"week\" produce identical output (same primary/secondary\n * option sets), so the day/week threshold is cosmetic and never changes a label.\n * The week↔month and month↔year cutoffs do change output, so they compare\n * against the *minimum* month/year length (not the average); see MIN_MONTH_MS /\n * MIN_YEAR_MS for why calendar-aligned axes would otherwise be misclassified.\n */\nconst deriveGranularity = (\n  tickPositions: readonly number[]\n): DatetimeGranularity => {\n  if (tickPositions.length < 2) {\n    return \"day\";\n  }\n\n  const deltas: number[] = [];\n  for (let i = 1; i < tickPositions.length; i++) {\n    const curr = tickPositions[i];\n    const prev = tickPositions[i - 1];\n    // Both reads are in range by the loop bounds (1 <= i < length); the guard\n    // only satisfies noUncheckedIndexedAccess and is unreachable at runtime.\n    if (curr === undefined || prev === undefined) {\n      continue;\n    }\n    deltas.push(Math.abs(curr - prev));\n  }\n  deltas.sort((a, b) => a - b);\n\n  const mid = Math.floor(deltas.length / 2);\n  // `length >= 2` is guaranteed by the early return above, so `deltas` has at\n  // least one element and `deltas[mid]` is always defined; `deltas[mid - 1]` is\n  // only read on the even-length branch, where it is guaranteed in range too.\n  const upper = deltas[mid]!;\n  const lower = deltas[mid - 1];\n  const median =\n    deltas.length % 2 === 0 && lower !== undefined\n      ? (lower + upper) / 2\n      : upper;\n\n  if (median < DAY_MS) {\n    return \"hour\";\n  }\n  if (median < WEEK_MS) {\n    return \"day\";\n  }\n  if (median < MIN_MONTH_MS) {\n    return \"week\";\n  }\n  if (median < MIN_YEAR_MS) {\n    return \"month\";\n  }\n  return \"year\";\n};\n\n/**\n * Derives a datetime tick's two-line stacked label as a rendering-agnostic\n * `{ primary, secondary? }` object. `secondary` is emitted only on a unit\n * boundary (the first tick, or when the relevant calendar part changes versus\n * the previous tick), matching v1's two-line semantics.\n *\n * Categorical (string) values and non-finite numbers are passed through as\n * `{ primary: String(value) }` with no secondary, so callers always get a\n * stable, markup-free string rather than \"Invalid Date\".\n */\nexport function datetimeFormatter({\n  value,\n  tickPositions = [],\n  // optional\n  timezone = \"UTC\",\n  timeFormat = \"12\",\n  textLocale = \"en-US\",\n}: DatetimeFormatterInput): DatetimeLabel {\n  // Categorical (string) data, and non-finite timestamps, pass through.\n  if (typeof value === \"string\" || !Number.isFinite(value)) {\n    return { primary: String(value) };\n  }\n\n  const granularity = deriveGranularity(tickPositions);\n\n  const tickIndex = tickPositions.indexOf(value);\n  const isFirst = tickIndex === 0;\n  const previousValue = tickPositions[tickIndex - 1];\n\n  const valueDate = new Date(value);\n  const valueParts = getDatePartsInTimezone(valueDate, timezone);\n  const previousValueDate = previousValue ? new Date(previousValue) : undefined;\n  const previousValueParts = previousValueDate\n    ? getDatePartsInTimezone(previousValueDate, timezone)\n    : undefined;\n\n  let firstPartOptions: Intl.DateTimeFormatOptions = {};\n  let secondPartOptions: Intl.DateTimeFormatOptions = {};\n\n  switch (granularity) {\n    case \"hour\":\n      firstPartOptions =\n        timeFormat === \"24\"\n          ? { hour: \"numeric\", minute: \"numeric\", hour12: false }\n          : { hour: \"numeric\" };\n      if (isFirst || valueParts.day !== previousValueParts?.day) {\n        secondPartOptions = { day: \"numeric\", month: \"short\" };\n      }\n      break;\n    case \"day\":\n    case \"week\":\n      firstPartOptions = { day: \"numeric\" };\n      if (isFirst || valueParts.month !== previousValueParts?.month) {\n        secondPartOptions = { month: \"short\" };\n      }\n      break;\n    case \"month\":\n      firstPartOptions = { month: \"short\" };\n      if (isFirst || valueParts.year !== previousValueParts?.year) {\n        secondPartOptions = { year: \"numeric\" };\n      }\n      break;\n    case \"year\":\n      firstPartOptions = { year: \"numeric\" };\n      break;\n    default:\n      firstPartOptions = {};\n      break;\n  }\n\n  const primary = new Intl.DateTimeFormat(textLocale, {\n    ...firstPartOptions,\n    timeZone: timezone,\n  }).format(valueDate);\n\n  if (Object.keys(secondPartOptions).length > 0) {\n    const secondary = new Intl.DateTimeFormat(textLocale, {\n      ...secondPartOptions,\n      timeZone: timezone,\n    }).format(valueDate);\n    return { primary, secondary };\n  }\n\n  return { primary };\n}\n","// Shared adapter helpers for the X/Y chart families (bar, line-area, …). Each\n// family's adapter still owns its `chart.type`, `plotOptions`, `series`, and\n// value (y) axis; these utilities cover the dimensional-axis + timezone wiring\n// that is identical across families, so it lives in one place.\n//\n// Deliberately granular (one concern per function) rather than a single base-\n// options builder, so a non-X/Y family like donut can reuse the subset that\n// applies to it. The broader shared-shell + value-axis sharing is left to the\n// X/Y pattern-sharing spike — the value axis in particular diverges per family\n// today (e.g. bar's declarative `format` from CE-41), so it stays per-family.\n\nimport type { DimensionalAxis } from \"./axis\";\nimport type {\n  SeedsAxisLabelFormatterContext,\n  SeedsChartXAxisOptions,\n} from \"./chartBase\";\nimport { datetimeFormatter } from \"./formatters/datetimeFormatter\";\nimport type { DatetimeTimeFormat } from \"./formatters/datetimeFormatter\";\n\n// Datetime tick labels: a granularity-aware, timezone/DST-correct two-line\n// stacked label via the shared `datetimeFormatter`, rendered as SVG. `<br/>` is a\n// line break in Highcharts' SVG text (styledMode, useHTML: false); the secondary\n// token is wrapped in a <span> — rendered as a <tspan> — styled by the\n// `.highcharts-xaxis-labels` rule in `styles/chartStyles.ts`.\nfunction makeDatetimeAxisLabelFormatter(\n  timezone: string,\n  timeFormat: DatetimeTimeFormat | undefined\n) {\n  return function (this: SeedsAxisLabelFormatterContext): string {\n    const { primary, secondary } = datetimeFormatter({\n      value: this.value,\n      tickPositions: this.axis.tickPositions ?? [],\n      timezone,\n      timeFormat,\n    });\n    return secondary\n      ? `${primary}<br/><span class=\"hc-axis-label-secondary\">${secondary}</span>`\n      : primary;\n  };\n}\n\n/**\n * Builds the dimensional (x) axis options shared by the X/Y chart families.\n * Category axes pass their labels through; datetime axes get the granularity-\n * aware two-line label formatter. `timezone` is only consulted for datetime.\n */\nexport function buildDimensionalAxis(\n  axis: DimensionalAxis,\n  timezone: string\n): SeedsChartXAxisOptions {\n  if (axis.type === \"datetime\") {\n    return {\n      type: \"datetime\",\n      crosshair: axis.crosshair,\n      labels: {\n        formatter: makeDatetimeAxisLabelFormatter(timezone, axis.timeFormat),\n      },\n    };\n  }\n  return {\n    type: \"category\",\n    categories: [...axis.categories],\n    crosshair: axis.crosshair,\n  };\n}\n\n/**\n * The timezone shared by datetime-axis ticks (`time.timezone`) and the tooltip\n * date formatter, so they can never disagree about the day. Defaults to `\"UTC\"`\n * on a datetime axis; `undefined` on a category axis (timezone is meaningless).\n */\nexport function resolveTooltipTimezone(\n  axis: DimensionalAxis,\n  timezone?: string\n): string | undefined {\n  return axis.type === \"datetime\" ? timezone ?? \"UTC\" : undefined;\n}\n"]}

package/dist/chunk-CYQXUAJC.js

@@ -0,0 +1,169 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }// src/constants/chartOptions.ts
+var _lodash = require('lodash'); var _lodash2 = _interopRequireDefault(_lodash);
+var baseChartOptions = {
+  chart: {
+    animation: false,
+    styledMode: true
+  },
+  credits: {
+    enabled: false
+  },
+  exporting: {
+    enabled: false,
+    fallbackToExportServer: false
+  },
+  legend: {
+    enabled: false
+  },
+  title: {
+    text: void 0
+  },
+  tooltip: {
+    hideDelay: 0,
+    outside: true,
+    padding: 0,
+    shape: "rect",
+    shared: true,
+    useHTML: true
+  }
+};
+var TIME_SERIES_CHART_HEIGHT = 275;
+var timeSeriesChartOptions = _lodash2.default.merge({}, baseChartOptions, {
+  annotations: [
+    {
+      draggable: "",
+      labelOptions: {
+        useHTML: true,
+        padding: 0
+        // removes "left" property padding created by highcharts so that label is centered
+      }
+    }
+  ],
+  chart: {
+    // events.click is set at the component level because of the optional onClick prop
+    height: TIME_SERIES_CHART_HEIGHT,
+    spacing: [5, 1, 0, 2]
+  },
+  plotOptions: {
+    series: {
+      animation: false,
+      clip: false,
+      marker: {
+        enabled: false,
+        states: {
+          hover: {
+            enabled: false
+          }
+        }
+      }
+    }
+  },
+  xAxis: {
+    crosshair: {
+      zIndex: 3
+    },
+    minPadding: 0,
+    // must be handled dynamically instead of css
+    maxPadding: 0,
+    // must be handled dynamically instead of css
+    type: "datetime",
+    labels: {
+      useHTML: true
+      // formatter is set at the component level because of the required text locale prop
+    }
+  },
+  yAxis: {
+    labels: {
+      useHTML: true
+      // formatter is set at the component level because of the optional yAxisLabelFormatter prop
+    },
+    softMax: 0,
+    softMin: 0,
+    title: {
+      text: void 0
+    },
+    plotLines: [
+      /* Adds a custom plotLine at y=0 to represent the chart baseline.
+        This approach allows full control over the line's appearance (e.g., color, z-index),
+        unlike relying on the default xAxis line, which always renders at the bottom of the chart
+        even when y=0 appears elsewhere (e.g., with negative values).
+      */
+      {
+        className: "y-axis-zero-line",
+        value: 0,
+        zIndex: 3
+        // ensures the line appears over the default y=0 line, which we can't seleect as specifically
+      }
+    ]
+  }
+});
+var lineChartOptions = _lodash2.default.merge({}, timeSeriesChartOptions, {
+  // plotOptions.spline.events.click is set at the component level because of the optional onClick prop
+});
+var areaChartOptions = _lodash2.default.merge({}, timeSeriesChartOptions, {
+  plotOptions: {
+    areaspline: {
+      // events.click is set at the component level because of the optional onClick prop
+      stacking: "normal"
+    }
+  }
+});
+var columnChartOptions = _lodash2.default.merge({}, timeSeriesChartOptions, {
+  plotOptions: {
+    column: {
+      stacking: "normal",
+      pointPadding: 0.25,
+      groupPadding: 0.25,
+      borderRadius: 4
+    }
+  },
+  xAxis: {
+    crosshair: false
+  },
+  yAxis: {
+    plotLines: [
+      {
+        // For stacked column charts with visible borders (e.g., white for contrast),
+        // we raise the zIndex of the y=0 plotLine to ensure it remains visible
+        // and isn't visually covered by overlapping column borders.
+        zIndex: 5
+      }
+    ]
+  }
+});
+var VERTICAL_BAR_CHART_DEFAULT_SERIES_LIMIT = 10;
+var DONUT_CHART_HALO_SIZE = 10;
+var DONUT_CHART_HEIGHT = 250 + DONUT_CHART_HALO_SIZE * 2;
+var DONUT_CHART_WIDTH = DONUT_CHART_HEIGHT;
+var donutChartOptions = _lodash2.default.merge({}, baseChartOptions, {
+  chart: {
+    height: DONUT_CHART_HEIGHT,
+    spacing: [0, 0, 0, 0]
+  },
+  plotOptions: {
+    pie: {
+      animation: false,
+      borderRadius: 0,
+      // must be handled here instead of css because of path rendering
+      dataLabels: {
+        enabled: false
+      },
+      innerSize: "50%"
+    }
+  }
+});
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.baseChartOptions = baseChartOptions; exports.TIME_SERIES_CHART_HEIGHT = TIME_SERIES_CHART_HEIGHT; exports.timeSeriesChartOptions = timeSeriesChartOptions; exports.lineChartOptions = lineChartOptions; exports.areaChartOptions = areaChartOptions; exports.columnChartOptions = columnChartOptions; exports.VERTICAL_BAR_CHART_DEFAULT_SERIES_LIMIT = VERTICAL_BAR_CHART_DEFAULT_SERIES_LIMIT; exports.DONUT_CHART_HALO_SIZE = DONUT_CHART_HALO_SIZE; exports.DONUT_CHART_HEIGHT = DONUT_CHART_HEIGHT; exports.DONUT_CHART_WIDTH = DONUT_CHART_WIDTH; exports.donutChartOptions = donutChartOptions;
+//# sourceMappingURL=chunk-CYQXUAJC.js.map

package/dist/chunk-CYQXUAJC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-CYQXUAJC.js","../src/constants/chartOptions.ts"],"names":[],"mappings":"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","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/chunk-CYQXUAJC.js","sourcesContent":[null,"import type { Options } from \"highcharts\";\nimport _ from \"lodash\";\n\n// options that should apply to all charts\n// this is being exported because it's needed for the listening bubble chart component.\n// when that components gets moved into the data-viz package, we can remove the export here\nexport const baseChartOptions: Options = {\n  chart: {\n    animation: false,\n    styledMode: true,\n  },\n  credits: {\n    enabled: false,\n  },\n  exporting: {\n    enabled: false,\n    fallbackToExportServer: false,\n  },\n  legend: {\n    enabled: false,\n  },\n  title: {\n    text: undefined,\n  },\n  tooltip: {\n    hideDelay: 0,\n    outside: true,\n    padding: 0,\n    shape: \"rect\",\n    shared: true,\n    useHTML: true,\n  },\n};\n\n// options that should apply to time series charts\nexport const TIME_SERIES_CHART_HEIGHT = 275;\nexport const timeSeriesChartOptions: Options = _.merge({}, baseChartOptions, {\n  annotations: [\n    {\n      draggable: \"\",\n      labelOptions: {\n        useHTML: true,\n        padding: 0, // removes \"left\" property padding created by highcharts so that label is centered\n      },\n    },\n  ],\n  chart: {\n    // events.click is set at the component level because of the optional onClick prop\n    height: TIME_SERIES_CHART_HEIGHT,\n    spacing: [5, 1, 0, 2],\n  },\n  plotOptions: {\n    series: {\n      animation: false,\n      clip: false,\n      marker: {\n        enabled: false,\n        states: {\n          hover: {\n            enabled: false,\n          },\n        },\n      },\n    },\n  },\n  xAxis: {\n    crosshair: {\n      zIndex: 3,\n    },\n    minPadding: 0, // must be handled dynamically instead of css\n    maxPadding: 0, // must be handled dynamically instead of css\n    type: \"datetime\",\n    labels: {\n      useHTML: true,\n      // formatter is set at the component level because of the required text locale prop\n    },\n  },\n  yAxis: {\n    labels: {\n      useHTML: true,\n      // formatter is set at the component level because of the optional yAxisLabelFormatter prop\n    },\n    softMax: 0,\n    softMin: 0,\n    title: {\n      text: undefined,\n    },\n    plotLines: [\n      /* Adds a custom plotLine at y=0 to represent the chart baseline.\n        This approach allows full control over the line's appearance (e.g., color, z-index),\n        unlike relying on the default xAxis line, which always renders at the bottom of the chart\n        even when y=0 appears elsewhere (e.g., with negative values).\n      */\n      {\n        className: \"y-axis-zero-line\",\n        value: 0,\n        zIndex: 3, // ensures the line appears over the default y=0 line, which we can't seleect as specifically\n      },\n    ],\n  },\n});\n\n// options that should apply to LineChart\nexport const lineChartOptions: Options = _.merge({}, timeSeriesChartOptions, {\n  // plotOptions.spline.events.click is set at the component level because of the optional onClick prop\n});\n\n// options that should apply to AreaChart\nexport const areaChartOptions: Options = _.merge({}, timeSeriesChartOptions, {\n  plotOptions: {\n    areaspline: {\n      // events.click is set at the component level because of the optional onClick prop\n      stacking: \"normal\",\n    },\n  },\n});\n\nexport const columnChartOptions: Options = _.merge({}, timeSeriesChartOptions, {\n  plotOptions: {\n    column: {\n      stacking: \"normal\",\n      pointPadding: 0.25,\n      groupPadding: 0.25,\n      borderRadius: 4,\n    },\n  },\n  xAxis: {\n    crosshair: false,\n  },\n  yAxis: {\n    plotLines: [\n      {\n        // For stacked column charts with visible borders (e.g., white for contrast),\n        // we raise the zIndex of the y=0 plotLine to ensure it remains visible\n        // and isn't visually covered by overlapping column borders.\n        zIndex: 5,\n      },\n    ],\n  },\n});\n\n/**\n * The default series limit for VerticalBarChart.\n * This limit is recommended to maintain chart readability and accessibility.\n * @see {VerticalBarChart}\n */\nexport const VERTICAL_BAR_CHART_DEFAULT_SERIES_LIMIT = 10;\n\n// options that should apply to DonutChart\nexport const DONUT_CHART_HALO_SIZE = 10; // 10 is the default from highcharts\nexport const DONUT_CHART_HEIGHT = 250 + DONUT_CHART_HALO_SIZE * 2;\nexport const DONUT_CHART_WIDTH = DONUT_CHART_HEIGHT;\nexport const donutChartOptions: Options = _.merge({}, baseChartOptions, {\n  chart: {\n    height: DONUT_CHART_HEIGHT,\n    spacing: [0, 0, 0, 0],\n  },\n  plotOptions: {\n    pie: {\n      animation: false,\n      borderRadius: 0, // must be handled here instead of css because of path rendering\n      dataLabels: {\n        enabled: false,\n      },\n      innerSize: \"50%\",\n    },\n  },\n});\n"]}

package/dist/chunk-VVGBJOFH.js

@@ -0,0 +1,68 @@
+"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');
+
+// src/charts/shared/annotations.ts
+function buildAnnotationConfig(annotations) {
+  if (!_optionalChain([annotations, 'optionalAccess', _ => _.length])) {
+    return { annotations: void 0, lookup: void 0 };
+  }
+  const labels = [];
+  const lookup = /* @__PURE__ */ new Map();
+  for (const annotation of annotations) {
+    const { position } = annotation;
+    labels.push({
+      // Highcharts anchor — always uses `x` regardless of chart orientation.
+      point: { x: position, y: 0, xAxis: 0, yAxis: 0 },
+      // Space (not empty) — Highcharts reverts to its built-in label text on empty string.
+      text: " "
+    });
+    lookup.set(position, annotation);
+  }
+  if (labels.length === 0) {
+    return { annotations: void 0, lookup: void 0 };
+  }
+  return {
+    // `useHTML: true` makes Highcharts attach an HTML `graphic.div` to each
+    // label, which the marker portal needs as its render target. `padding: 0`
+    // removes Highcharts' default left padding so markers stay centered.
+    annotations: [{ labels, labelOptions: { useHTML: true, padding: 0 } }],
+    lookup
+  };
+}
+
+// src/charts/shared/valueAxisLabelFormatter.ts
+var _seedsreactnumeral = require('@sproutsocial/seeds-react-numeral');
+var FIXED_LOCALE = "en-US";
+function deriveAbbreviateFromTicks(context) {
+  const tickPositions = context.axis.tickPositions;
+  const maxValue = tickPositions && tickPositions.length > 0 ? tickPositions[tickPositions.length - 1] : void 0;
+  return typeof maxValue === "number" && maxValue > 9999 ? 1e3 : true;
+}
+function defaultValueAxisLabelFormatter() {
+  const numberValue = Number(this.value);
+  if (numberValue === 0) {
+    return _seedsreactnumeral.formatNumeral.call(void 0, { locale: FIXED_LOCALE, number: 0 });
+  }
+  const abbreviate = deriveAbbreviateFromTicks(this);
+  return _seedsreactnumeral.formatNumeral.call(void 0, {
+    abbreviate,
+    format: "decimal",
+    locale: FIXED_LOCALE,
+    number: numberValue
+  });
+}
+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 });
+  };
+}
+
+
+
+
+
+exports.buildAnnotationConfig = buildAnnotationConfig; exports.defaultValueAxisLabelFormatter = defaultValueAxisLabelFormatter; exports.makeValueAxisLabelFormatter = makeValueAxisLabelFormatter;
+//# sourceMappingURL=chunk-VVGBJOFH.js.map

package/dist/chunk-VVGBJOFH.js.map

@@ -0,0 +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"]}

package/dist/donut/index.d.mts

@@ -0,0 +1,48 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { TypeIconName } from '@sproutsocial/seeds-react-icon';
+import { V as ValueFormat, C as ChartTooltipProps, a as ChartTooltipDataRow } from '../chartBase-Cn_5CUJi.mjs';
+import { C as ChartExportHandle } from '../chartExport-CKYpuhik.mjs';
+import '../types-DxrhdAdn.mjs';
+import 'highcharts';
+
+interface DonutDataPoint {
+    name: string;
+    value: number | null;
+    color?: string;
+    /** Seeds icon or partner-logo name rendered in the legend chip. */
+    icon?: TypeIconName;
+}
+/** A donut tooltip row — always carries `percent` (Highcharts computes it for pie series). */
+interface DonutChartTooltipRow extends ChartTooltipDataRow {
+    percent: number;
+}
+/** Tooltip render-prop signature for DonutChart. `data` rows always include `percent`. */
+interface DonutChartTooltipProps extends Omit<ChartTooltipProps, "data"> {
+    data: DonutChartTooltipRow[];
+}
+interface DonutChartProps {
+    /** Wired into Highcharts' `accessibility.description`. */
+    description: string;
+    data: Array<DonutDataPoint>;
+    /** Applied to the outermost container element for layout/spacing overrides. */
+    className?: string;
+    /** Replaces v1's `numberFormat`, `currency`, `numberLocale`, `textLocale`. */
+    format?: ValueFormat;
+    /** Override for the default tooltip content. Receives `DonutChartTooltipProps` including `percent` per row. */
+    tooltip?: (args: DonutChartTooltipProps) => ReactNode;
+    /** Footer content shown in the default tooltip when `onClick` is set. */
+    tooltipClickLabel?: ReactNode;
+    /** Override for the value shown when a data point is `null`. Defaults to an em-dash. */
+    invalidNumberLabel?: ReactNode;
+    /** Click handler invoked with the `name` of the clicked slice. */
+    onClick?: ({ position }: {
+        position: string;
+    }) => void;
+    /** Fired once per chart instance with a handle for PNG/SVG/PDF/CSV exports. */
+    onReady?: (handle: ChartExportHandle) => void;
+}
+
+declare const DonutChart: react.NamedExoticComponent<DonutChartProps>;
+
+export { ChartExportHandle, DonutChart, type DonutChartProps, type DonutChartTooltipProps, type DonutChartTooltipRow, type DonutDataPoint, ValueFormat };

package/dist/donut/index.d.ts

@@ -0,0 +1,48 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { TypeIconName } from '@sproutsocial/seeds-react-icon';
+import { V as ValueFormat, C as ChartTooltipProps, a as ChartTooltipDataRow } from '../chartBase-C-l7yYGx.js';
+import { C as ChartExportHandle } from '../chartExport-CKYpuhik.js';
+import '../types-DxrhdAdn.js';
+import 'highcharts';
+
+interface DonutDataPoint {
+    name: string;
+    value: number | null;
+    color?: string;
+    /** Seeds icon or partner-logo name rendered in the legend chip. */
+    icon?: TypeIconName;
+}
+/** A donut tooltip row — always carries `percent` (Highcharts computes it for pie series). */
+interface DonutChartTooltipRow extends ChartTooltipDataRow {
+    percent: number;
+}
+/** Tooltip render-prop signature for DonutChart. `data` rows always include `percent`. */
+interface DonutChartTooltipProps extends Omit<ChartTooltipProps, "data"> {
+    data: DonutChartTooltipRow[];
+}
+interface DonutChartProps {
+    /** Wired into Highcharts' `accessibility.description`. */
+    description: string;
+    data: Array<DonutDataPoint>;
+    /** Applied to the outermost container element for layout/spacing overrides. */
+    className?: string;
+    /** Replaces v1's `numberFormat`, `currency`, `numberLocale`, `textLocale`. */
+    format?: ValueFormat;
+    /** Override for the default tooltip content. Receives `DonutChartTooltipProps` including `percent` per row. */
+    tooltip?: (args: DonutChartTooltipProps) => ReactNode;
+    /** Footer content shown in the default tooltip when `onClick` is set. */
+    tooltipClickLabel?: ReactNode;
+    /** Override for the value shown when a data point is `null`. Defaults to an em-dash. */
+    invalidNumberLabel?: ReactNode;
+    /** Click handler invoked with the `name` of the clicked slice. */
+    onClick?: ({ position }: {
+        position: string;
+    }) => void;
+    /** Fired once per chart instance with a handle for PNG/SVG/PDF/CSV exports. */
+    onReady?: (handle: ChartExportHandle) => void;
+}
+
+declare const DonutChart: react.NamedExoticComponent<DonutChartProps>;
+
+export { ChartExportHandle, DonutChart, type DonutChartProps, type DonutChartTooltipProps, type DonutChartTooltipRow, type DonutDataPoint, ValueFormat };