@sproutsocial/seeds-react-data-viz 0.24.3 → 0.25.0

package/dist/line-area/index.js

@@ -2,23 +2,22 @@
 
 
 
-var _chunkGHZHRFE6js = require('../chunk-GHZHRFE6.js');
+var _chunkCWKFNAXFjs = require('../chunk-CWKFNAXF.js');
 
 
 
-var _chunkLKUL4EFZjs = require('../chunk-LKUL4EFZ.js');
+var _chunk2A3KLUIFjs = require('../chunk-2A3KLUIF.js');
 
 
 var _chunk6EIJCJCNjs = require('../chunk-6EIJCJCN.js');
 
 
-var _chunk33Y5FZTTjs = require('../chunk-33Y5FZTT.js');
 
 
+var _chunkTNZNBMSZjs = require('../chunk-TNZNBMSZ.js');
 
 
-var _chunk5JQXDK23js = require('../chunk-5JQXDK23.js');
-require('../chunk-W57R2V23.js');
+var _chunkLWDHU4QKjs = require('../chunk-LWDHU4QK.js');
 
 // src/charts/line-area/LineAreaChart.tsx
 var _react = require('react');
@@ -45,12 +44,12 @@ function withIsolatedPointMarkers(data) {
   });
 }
 function buildLineAreaChartOptions(props) {
-  const tooltipOptions = _chunkLKUL4EFZjs.resolveTooltipOptions.call(void 0, props);
+  const tooltipOptions = _chunk2A3KLUIFjs.resolveTooltipOptions.call(void 0, props);
   const isStacked = AREA_VARIANTS.has(props.variant) && Boolean(props.stacking);
-  const { annotations, lookup: annotationLookup } = _chunkGHZHRFE6js.buildAnnotationConfig.call(void 0, 
+  const { annotations, lookup: annotationLookup } = _chunkCWKFNAXFjs.buildAnnotationConfig.call(void 0, 
     props.annotations
   );
-  const base = _chunk5JQXDK23js.buildBaseChartOptions.call(void 0, {
+  const base = _chunkTNZNBMSZjs.buildBaseChartOptions.call(void 0, {
     type: props.variant,
     description: props.description,
     reserveTopMargin: Boolean(annotations),
@@ -65,13 +64,13 @@ function buildLineAreaChartOptions(props) {
       // Re-assert the definite `type` so spreading the optionally-typed
       // `base.chart` doesn't widen the required `type` field to optional.
       type: props.variant,
-      height: _nullishCoalesce(props.height, () => ( _chunk33Y5FZTTjs.TIME_SERIES_CHART_HEIGHT)),
+      height: _nullishCoalesce(props.height, () => ( _chunkLWDHU4QKjs.TIME_SERIES_CHART_HEIGHT)),
       // Tight time-series spacing (from constants/chartOptions.ts) so the plot
       // area fills the 275px container; without it Highcharts' larger default
       // spacing ([10, 10, 15, 10]) shrinks the plot area.
       spacing: [5, 1, 0, 2]
     },
-    xAxis: _chunkLKUL4EFZjs.buildDimensionalAxis.call(void 0, props.xAxis, _nullishCoalesce(tooltipOptions.timezone, () => ( "UTC"))),
+    xAxis: _chunk2A3KLUIFjs.buildDimensionalAxis.call(void 0, props.xAxis, _nullishCoalesce(tooltipOptions.timezone, () => ( "UTC"))),
     yAxis: {
       min: _optionalChain([props, 'access', _ => _.yAxis, 'optionalAccess', _2 => _2.min]),
       max: _optionalChain([props, 'access', _3 => _3.yAxis, 'optionalAccess', _4 => _4.max]),
@@ -89,7 +88,7 @@ function buildLineAreaChartOptions(props) {
       labels: {
         // 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', _9 => _9.yAxis, 'optionalAccess', _10 => _10.format]) ? _chunkGHZHRFE6js.makeValueAxisLabelFormatter.call(void 0, props.yAxis.format) : _chunkGHZHRFE6js.defaultValueAxisLabelFormatter
+        formatter: _optionalChain([props, 'access', _9 => _9.yAxis, 'optionalAccess', _10 => _10.format]) ? _chunkCWKFNAXFjs.makeValueAxisLabelFormatter.call(void 0, props.yAxis.format) : _chunkCWKFNAXFjs.defaultValueAxisLabelFormatter
       }
     },
     plotOptions: {
@@ -132,7 +131,7 @@ function buildLineAreaChartOptions(props) {
 var _jsxruntime = require('react/jsx-runtime');
 var AREA_VARIANTS2 = /* @__PURE__ */ new Set(["area", "areaspline"]);
 var LineAreaChart = _react.memo.call(void 0, function LineAreaChart2(props) {
-  const { colors, patterns } = _chunk5JQXDK23js.useSeedsChartSetup.call(void 0, {
+  const { colors, patterns } = _chunkTNZNBMSZjs.useSeedsChartSetup.call(void 0, {
     series: props.series,
     includePatterns: true
   });
@@ -160,7 +159,7 @@ var LineAreaChart = _react.memo.call(void 0, function LineAreaChart2(props) {
         className: props.className
       }),
       children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-        _chunk5JQXDK23js.ChartRenderer,
+        _chunkTNZNBMSZjs.ChartRenderer,
         {
           options,
           series: props.series,

package/dist/line-area/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/line-area/index.js","../../src/charts/line-area/LineAreaChart.tsx","../../src/charts/line-area/adapter.ts"],"names":["AREA_VARIANTS","LineAreaChart"],"mappings":"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","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/line-area/index.js","sourcesContent":[null,"import { memo, useMemo } from \"react\";\nimport { useSeedsChartSetup, ChartRenderer } from \"../shared/chartBase\";\nimport { getChartContainerProps } from \"../shared/chartContainer\";\nimport { buildLineAreaChartOptions } from \"./adapter\";\nimport type { LineAreaChartProps, LineAreaVariant } from \"./types\";\n\nconst AREA_VARIANTS = new Set<LineAreaVariant>([\"area\", \"areaspline\"]);\n\n/**\n * LineAreaChart — the v2 time-series line/area family.\n *\n * Like SparklineChart, the wrapper carries no styled-components: it is a plain\n * <div> whose className / inline custom properties / data-attributes come from\n * the shared getChartContainerProps contract (CE-164), and its Highcharts\n * styling ships as a static line-area.css. chart-styles.css owns the shared\n * base (background, per-series color fallback, click cursor, tooltip, legend)\n * AND the shared cross-family .seeds-chart-time-series layer (crosshair,\n * grid/axis lines, ticks, zero line, axis-label typography) that bar also uses;\n * line-area.css owns only the .seeds-chart-line / .seeds-chart-area selectors.\n * Neither is imported here — matching the Sparkline/bar convention, the component never\n * self-imports its stylesheet; consumers import both explicitly (see\n * charts/README.md).\n */\nexport const LineAreaChart = memo(function LineAreaChart(\n  props: LineAreaChartProps\n) {\n  const { colors, patterns } = useSeedsChartSetup({\n    series: props.series,\n    includePatterns: true,\n  });\n  const { options, annotationLookup, tooltipOptions } = useMemo(\n    () => buildLineAreaChartOptions(props),\n    [props]\n  );\n  const hasOnClick = Boolean(props.onClick);\n  const isArea = AREA_VARIANTS.has(props.variant);\n\n  return (\n    <div\n      {...getChartContainerProps({\n        familyClasses: [\n          \"seeds-chart-time-series\",\n          isArea ? \"seeds-chart-area\" : \"seeds-chart-line\",\n        ],\n        // RAW per-series colors: only an explicit consumer override is inlined\n        // as --highcharts-color-N; an unset series falls through to the DS\n        // palette default in chart-styles.css. ChartRenderer below still gets\n        // the palette-RESOLVED `colors` for its own styled-components engine.\n        colors: props.series.map((s) => s.color),\n        patterns,\n        hasOnClick,\n        className: props.className,\n      })}\n    >\n      <ChartRenderer\n        options={options}\n        series={props.series}\n        colors={colors}\n        tooltip={props.tooltip}\n        annotationLookup={annotationLookup}\n        hasOnClick={hasOnClick}\n        tooltipClickLabel={props.tooltipClickLabel}\n        tooltipOptions={tooltipOptions}\n        invalidNumberLabel={props.invalidNumberLabel}\n        valueFormat={props.yAxis?.format}\n        exportTitle={props.exportTitle}\n        onReady={props.onReady}\n      />\n    </div>\n  );\n});\n","import { buildAnnotationConfig } from \"../shared/annotations\";\nimport type { ChartAnnotationLookup } from \"../shared/annotations\";\nimport type {\n  ChartTooltipProps,\n  SeedsChartDataPoint,\n  SeedsChartOptions,\n} from \"../shared/chartBase\";\nimport { buildBaseChartOptions } from \"../shared/baseChartOptions\";\nimport { TIME_SERIES_CHART_HEIGHT } from \"../../constants/chartOptions\";\nimport {\n  buildDimensionalAxis,\n  resolveTooltipOptions,\n} from \"../shared/axisOptions\";\nimport {\n  defaultValueAxisLabelFormatter,\n  makeValueAxisLabelFormatter,\n} from \"../shared/valueAxisLabelFormatter\";\nimport type { ChartDataPoint } from \"../shared/axis\";\nimport type { LineAreaChartProps, LineAreaVariant } from \"./types\";\n\n// `stacking` is meaningful only for filled variants; on `line`/`spline` it's a\n// no-op, so the adapter drops it rather than emitting a misleading option.\nconst AREA_VARIANTS = new Set<LineAreaVariant>([\"area\", \"areaspline\"]);\n\ntype SeriesPoint =\n  | number\n  | null\n  | [number, number | null]\n  | SeedsChartDataPoint;\n\nfunction pointY(point: ChartDataPoint): number | null {\n  if (point === null) return null;\n  if (typeof point === \"number\") return point;\n  if (Array.isArray(point)) return point[1];\n  return point.y;\n}\n\n// Point markers are hidden by default (set on `plotOptions.series`), but an\n// *isolated* non-null point — one with a null (or the chart edge) on both\n// sides — gets a circle marker so a point with no connecting line segment\n// stays visible. Connected points pass through unchanged so the line/area\n// renders dot-free, matching the designs.\nfunction withIsolatedPointMarkers(\n  data: ReadonlyArray<ChartDataPoint>\n): SeriesPoint[] {\n  return data.map((point, i): SeriesPoint => {\n    if (point === null) return null; // explicit gap\n    if (pointY(point) === null) return point; // tuple/object with null y — a gap\n    const prevY = i === 0 ? null : pointY(data[i - 1]!);\n    const nextY = i === data.length - 1 ? null : pointY(data[i + 1]!);\n    if (prevY !== null || nextY !== null) return point; // connected → no marker\n    const marker = { enabled: true, symbol: \"circle\" as const };\n    if (typeof point === \"number\") return { y: point, marker };\n    if (Array.isArray(point)) return { x: point[0], y: point[1], marker };\n    return { ...point, marker };\n  });\n}\n\nexport function buildLineAreaChartOptions(props: LineAreaChartProps): {\n  options: SeedsChartOptions;\n  annotationLookup: ChartAnnotationLookup | undefined;\n  /** Resolved datetime-derived tooltip options (timezone / timeFormat / textLocale); all undefined on category axes. */\n  tooltipOptions: Pick<\n    ChartTooltipProps,\n    \"timezone\" | \"timeFormat\" | \"textLocale\"\n  >;\n} {\n  const tooltipOptions = resolveTooltipOptions(props);\n  const isStacked = AREA_VARIANTS.has(props.variant) && Boolean(props.stacking);\n  const { annotations, lookup: annotationLookup } = buildAnnotationConfig(\n    props.annotations\n  );\n\n  const base = buildBaseChartOptions({\n    type: props.variant,\n    description: props.description,\n    reserveTopMargin: Boolean(annotations),\n    timezone: tooltipOptions.timezone,\n  });\n\n  const options: SeedsChartOptions = {\n    ...base,\n    // Default height baseline (overridable via `props.height`) so consumers\n    // who don't configure sizing keep the design-reviewed default.\n    chart: {\n      ...base.chart,\n      // Re-assert the definite `type` so spreading the optionally-typed\n      // `base.chart` doesn't widen the required `type` field to optional.\n      type: props.variant,\n      height: props.height ?? TIME_SERIES_CHART_HEIGHT,\n      // Tight time-series spacing (from constants/chartOptions.ts) so the plot\n      // area fills the 275px container; without it Highcharts' larger default\n      // spacing ([10, 10, 15, 10]) shrinks the plot area.\n      spacing: [5, 1, 0, 2],\n    },\n    xAxis: buildDimensionalAxis(props.xAxis, tooltipOptions.timezone ?? \"UTC\"),\n    yAxis: {\n      min: props.yAxis?.min,\n      max: props.yAxis?.max,\n      // Anchor the value axis to 0 (as the bar/area families do): line/spline otherwise\n      // auto-scale above 0, which truncates the axis and pushes the annotation\n      // anchor (y: 0) out of range. `soft` still extends for negative data.\n      softMin: 0,\n      softMax: 0,\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      // Zero-config default: abbreviate value-axis ticks (1.20K / 1.20M / 1.20B).\n      labels: {\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: {\n        animation: false,\n        // Hide point markers by default (per the designs); isolated points\n        // re-enable their own marker via `withIsolatedPointMarkers`.\n        marker: { enabled: false },\n        ...(props.onClick || props.onMouseEnter || props.onMouseLeave\n          ? {\n              point: {\n                events: {\n                  click: props.onClick\n                    ? (event) => props.onClick!({ position: event.point.x })\n                    : undefined,\n                  mouseOver: props.onMouseEnter\n                    ? function (this: { x: number | string }) {\n                        props.onMouseEnter!({ position: this.x });\n                      }\n                    : undefined,\n                  mouseOut: props.onMouseLeave\n                    ? function (this: { x: number | string }) {\n                        props.onMouseLeave!({ position: this.x });\n                      }\n                    : undefined,\n                },\n              },\n            }\n          : {}),\n      },\n      // Type-scoped stacking: only the (area) variant stacks. `isStacked` already\n      // guarantees `props.variant` is an area variant here, so the computed key is\n      // always a valid plotOptions slot. Matches bar's per-type placement and keeps\n      // line/spline unstacked.\n      ...(isStacked ? { [props.variant]: { stacking: props.stacking } } : {}),\n    },\n    series: props.series.map((s) => ({\n      type: props.variant,\n      name: s.name,\n      data: withIsolatedPointMarkers(s.data),\n    })),\n    ...(annotations ? { annotations } : {}),\n  };\n\n  return { options, annotationLookup, tooltipOptions };\n}\n"]}
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/line-area/index.js","../../src/charts/line-area/LineAreaChart.tsx","../../src/charts/line-area/adapter.ts"],"names":["AREA_VARIANTS","LineAreaChart"],"mappings":"AAAA;AACE;AACA;AACA;AACF,uDAA6B;AAC7B;AACE;AACA;AACF,uDAA6B;AAC7B;AACE;AACF,uDAA6B;AAC7B;AACE;AACA;AACA;AACF,uDAA6B;AAC7B;AACE;AACF,uDAA6B;AAC7B;AACA;ACrBA,8BAA8B;ADuB9B;AACA;AEFA,IAAM,cAAA,kBAAgB,IAAI,GAAA,CAAqB,CAAC,MAAA,EAAQ,YAAY,CAAC,CAAA;AAQrE,SAAS,MAAA,CAAO,KAAA,EAAsC;AACpD,EAAA,GAAA,CAAI,MAAA,IAAU,IAAA,EAAM,OAAO,IAAA;AAC3B,EAAA,GAAA,CAAI,OAAO,MAAA,IAAU,QAAA,EAAU,OAAO,KAAA;AACtC,EAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG,OAAO,KAAA,CAAM,CAAC,CAAA;AACxC,EAAA,OAAO,KAAA,CAAM,CAAA;AACf;AAOA,SAAS,wBAAA,CACP,IAAA,EACe;AACf,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAC,KAAA,EAAO,CAAA,EAAA,GAAmB;AACzC,IAAA,GAAA,CAAI,MAAA,IAAU,IAAA,EAAM,OAAO,IAAA;AAC3B,IAAA,GAAA,CAAI,MAAA,CAAO,KAAK,EAAA,IAAM,IAAA,EAAM,OAAO,KAAA;AACnC,IAAA,MAAM,MAAA,EAAQ,EAAA,IAAM,EAAA,EAAI,KAAA,EAAO,MAAA,CAAO,IAAA,CAAK,EAAA,EAAI,CAAC,CAAE,CAAA;AAClD,IAAA,MAAM,MAAA,EAAQ,EAAA,IAAM,IAAA,CAAK,OAAA,EAAS,EAAA,EAAI,KAAA,EAAO,MAAA,CAAO,IAAA,CAAK,EAAA,EAAI,CAAC,CAAE,CAAA;AAChE,IAAA,GAAA,CAAI,MAAA,IAAU,KAAA,GAAQ,MAAA,IAAU,IAAA,EAAM,OAAO,KAAA;AAC7C,IAAA,MAAM,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,MAAA,EAAQ,SAAkB,CAAA;AAC1D,IAAA,GAAA,CAAI,OAAO,MAAA,IAAU,QAAA,EAAU,OAAO,EAAE,CAAA,EAAG,KAAA,EAAO,OAAO,CAAA;AACzD,IAAA,GAAA,CAAI,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG,OAAO,EAAE,CAAA,EAAG,KAAA,CAAM,CAAC,CAAA,EAAG,CAAA,EAAG,KAAA,CAAM,CAAC,CAAA,EAAG,OAAO,CAAA;AACpE,IAAA,OAAO,EAAE,GAAG,KAAA,EAAO,OAAO,CAAA;AAAA,EAC5B,CAAC,CAAA;AACH;AAEO,SAAS,yBAAA,CAA0B,KAAA,EAQxC;AACA,EAAA,MAAM,eAAA,EAAiB,oDAAA,KAA2B,CAAA;AAClD,EAAA,MAAM,UAAA,EAAY,aAAA,CAAc,GAAA,CAAI,KAAA,CAAM,OAAO,EAAA,GAAK,OAAA,CAAQ,KAAA,CAAM,QAAQ,CAAA;AAC5E,EAAA,MAAM,EAAE,WAAA,EAAa,MAAA,EAAQ,iBAAiB,EAAA,EAAI,oDAAA;AAAA,IAChD,KAAA,CAAM;AAAA,EACR,CAAA;AAEA,EAAA,MAAM,KAAA,EAAO,oDAAA;AAAsB,IACjC,IAAA,EAAM,KAAA,CAAM,OAAA;AAAA,IACZ,WAAA,EAAa,KAAA,CAAM,WAAA;AAAA,IACnB,gBAAA,EAAkB,OAAA,CAAQ,WAAW,CAAA;AAAA,IACrC,QAAA,EAAU,cAAA,CAAe;AAAA,EAC3B,CAAC,CAAA;AAED,EAAA,MAAM,QAAA,EAA6B;AAAA,IACjC,GAAG,IAAA;AAAA;AAAA;AAAA,IAGH,KAAA,EAAO;AAAA,MACL,GAAG,IAAA,CAAK,KAAA;AAAA;AAAA;AAAA,MAGR,IAAA,EAAM,KAAA,CAAM,OAAA;AAAA,MACZ,MAAA,mBAAQ,KAAA,CAAM,MAAA,UAAU,2CAAA;AAAA;AAAA;AAAA;AAAA,MAIxB,OAAA,EAAS,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAC;AAAA,IACtB,CAAA;AAAA,IACA,KAAA,EAAO,mDAAA,KAAqB,CAAM,KAAA,mBAAO,cAAA,CAAe,QAAA,UAAY,OAAK,CAAA;AAAA,IACzE,KAAA,EAAO;AAAA,MACL,GAAA,kBAAK,KAAA,mBAAM,KAAA,6BAAO,KAAA;AAAA,MAClB,GAAA,kBAAK,KAAA,qBAAM,KAAA,6BAAO,KAAA;AAAA;AAAA;AAAA;AAAA,MAIlB,OAAA,EAAS,CAAA;AAAA,MACT,OAAA,EAAS,CAAA;AAAA,MACT,aAAA,kBAAe,KAAA,qBAAM,KAAA,6BAAO,gBAAA,IAAkB,MAAA,EAAQ,EAAA,EAAI,CAAA;AAAA;AAAA;AAAA,MAG1D,SAAA,EAAW,CAAC,EAAE,KAAA,EAAO,CAAA,EAAG,SAAA,EAAW,kBAAA,EAAoB,MAAA,EAAQ,EAAE,CAAC,CAAA;AAAA,MAClE,KAAA,EAAO,EAAE,IAAA,mCAAM,KAAA,qBAAM,KAAA,6BAAO,OAAA,UAAS,KAAG,CAAA;AAAA;AAAA,MAExC,MAAA,EAAQ;AAAA;AAAA;AAAA,QAGN,SAAA,kBAAW,KAAA,qBAAM,KAAA,+BAAO,SAAA,EACpB,0DAAA,KAA4B,CAAM,KAAA,CAAM,MAAM,EAAA,EAC9C;AAAA,MACN;AAAA,IACF,CAAA;AAAA,IACA,WAAA,EAAa;AAAA,MACX,MAAA,EAAQ;AAAA,QACN,SAAA,EAAW,KAAA;AAAA;AAAA;AAAA,QAGX,MAAA,EAAQ,EAAE,OAAA,EAAS,MAAM,CAAA;AAAA,QACzB,GAAI,KAAA,CAAM,QAAA,GAAW,KAAA,CAAM,aAAA,GAAgB,KAAA,CAAM,aAAA,EAC7C;AAAA,UACE,KAAA,EAAO;AAAA,YACL,MAAA,EAAQ;AAAA,cACN,KAAA,EAAO,KAAA,CAAM,QAAA,EACT,CAAC,KAAA,EAAA,GAAU,KAAA,CAAM,OAAA,CAAS,EAAE,QAAA,EAAU,KAAA,CAAM,KAAA,CAAM,EAAE,CAAC,EAAA,EACrD,KAAA,CAAA;AAAA,cACJ,SAAA,EAAW,KAAA,CAAM,aAAA,EACb,QAAA,CAAA,EAAwC;AACtC,gBAAA,KAAA,CAAM,YAAA,CAAc,EAAE,QAAA,EAAU,IAAA,CAAK,EAAE,CAAC,CAAA;AAAA,cAC1C,EAAA,EACA,KAAA,CAAA;AAAA,cACJ,QAAA,EAAU,KAAA,CAAM,aAAA,EACZ,QAAA,CAAA,EAAwC;AACtC,gBAAA,KAAA,CAAM,YAAA,CAAc,EAAE,QAAA,EAAU,IAAA,CAAK,EAAE,CAAC,CAAA;AAAA,cAC1C,EAAA,EACA,KAAA;AAAA,YACN;AAAA,UACF;AAAA,QACF,EAAA,EACA,CAAC;AAAA,MACP,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAKA,GAAI,UAAA,EAAY,EAAE,CAAC,KAAA,CAAM,OAAO,CAAA,EAAG,EAAE,QAAA,EAAU,KAAA,CAAM,SAAS,EAAE,EAAA,EAAI,CAAC;AAAA,IACvE,CAAA;AAAA,IACA,MAAA,EAAQ,KAAA,CAAM,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,EAAA,GAAA,CAAO;AAAA,MAC/B,IAAA,EAAM,KAAA,CAAM,OAAA;AAAA,MACZ,IAAA,EAAM,CAAA,CAAE,IAAA;AAAA,MACR,IAAA,EAAM,wBAAA,CAAyB,CAAA,CAAE,IAAI;AAAA,IACvC,CAAA,CAAE,CAAA;AAAA,IACF,GAAI,YAAA,EAAc,EAAE,YAAY,EAAA,EAAI,CAAC;AAAA,EACvC,CAAA;AAEA,EAAA,OAAO,EAAE,OAAA,EAAS,gBAAA,EAAkB,eAAe,CAAA;AACrD;AFjCA;AACA;AC3EM,+CAAA;AAhDN,IAAMA,eAAAA,kBAAgB,IAAI,GAAA,CAAqB,CAAC,MAAA,EAAQ,YAAY,CAAC,CAAA;AAiB9D,IAAM,cAAA,EAAgB,yBAAA,SAAcC,cAAAA,CACzC,KAAA,EACA;AACA,EAAA,MAAM,EAAE,MAAA,EAAQ,SAAS,EAAA,EAAI,iDAAA;AAAmB,IAC9C,MAAA,EAAQ,KAAA,CAAM,MAAA;AAAA,IACd,eAAA,EAAiB;AAAA,EACnB,CAAC,CAAA;AACD,EAAA,MAAM,EAAE,OAAA,EAAS,gBAAA,EAAkB,eAAe,EAAA,EAAI,4BAAA;AAAA,IACpD,CAAA,EAAA,GAAM,yBAAA,CAA0B,KAAK,CAAA;AAAA,IACrC,CAAC,KAAK;AAAA,EACR,CAAA;AACA,EAAA,MAAM,WAAA,EAAa,OAAA,CAAQ,KAAA,CAAM,OAAO,CAAA;AACxC,EAAA,MAAM,OAAA,EAASD,cAAAA,CAAc,GAAA,CAAI,KAAA,CAAM,OAAO,CAAA;AAE9C,EAAA,uBACE,6BAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACE,GAAG,qDAAA;AAAuB,QACzB,aAAA,EAAe;AAAA,UACb,yBAAA;AAAA,UACA,OAAA,EAAS,mBAAA,EAAqB;AAAA,QAChC,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAKA,MAAA,EAAQ,KAAA,CAAM,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,EAAA,GAAM,CAAA,CAAE,KAAK,CAAA;AAAA,QACvC,QAAA;AAAA,QACA,UAAA;AAAA,QACA,SAAA,EAAW,KAAA,CAAM;AAAA,MACnB,CAAC,CAAA;AAAA,MAED,QAAA,kBAAA,6BAAA;AAAA,QAAC,8BAAA;AAAA,QAAA;AAAA,UACC,OAAA;AAAA,UACA,MAAA,EAAQ,KAAA,CAAM,MAAA;AAAA,UACd,MAAA;AAAA,UACA,OAAA,EAAS,KAAA,CAAM,OAAA;AAAA,UACf,gBAAA;AAAA,UACA,UAAA;AAAA,UACA,iBAAA,EAAmB,KAAA,CAAM,iBAAA;AAAA,UACzB,cAAA;AAAA,UACA,kBAAA,EAAoB,KAAA,CAAM,kBAAA;AAAA,UAC1B,WAAA,kBAAa,KAAA,uBAAM,KAAA,+BAAO,QAAA;AAAA,UAC1B,WAAA,EAAa,KAAA,CAAM,WAAA;AAAA,UACnB,OAAA,EAAS,KAAA,CAAM;AAAA,QAAA;AAAA,MACjB;AAAA,IAAA;AAAA,EACF,CAAA;AAEJ,CAAC,CAAA;AD8GD;AACE;AACF,sCAAC","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/line-area/index.js","sourcesContent":[null,"import { memo, useMemo } from \"react\";\nimport { useSeedsChartSetup, ChartRenderer } from \"../shared/chartBase\";\nimport { getChartContainerProps } from \"../shared/chartContainer\";\nimport { buildLineAreaChartOptions } from \"./adapter\";\nimport type { LineAreaChartProps, LineAreaVariant } from \"./types\";\n\nconst AREA_VARIANTS = new Set<LineAreaVariant>([\"area\", \"areaspline\"]);\n\n/**\n * LineAreaChart — the v2 time-series line/area family.\n *\n * Like SparklineChart, the wrapper carries no styled-components: it is a plain\n * <div> whose className / inline custom properties / data-attributes come from\n * the shared getChartContainerProps contract (CE-164), and its Highcharts\n * styling ships as a static line-area.css. chart-styles.css owns the shared\n * base (background, per-series color fallback, click cursor, tooltip, legend)\n * AND the shared cross-family .seeds-chart-time-series layer (crosshair,\n * grid/axis lines, ticks, zero line, axis-label typography) that bar also uses;\n * line-area.css owns only the .seeds-chart-line / .seeds-chart-area selectors.\n * Neither is imported here — matching the Sparkline/bar convention, the component never\n * self-imports its stylesheet; consumers import both explicitly (see\n * charts/README.md).\n */\nexport const LineAreaChart = memo(function LineAreaChart(\n  props: LineAreaChartProps\n) {\n  const { colors, patterns } = useSeedsChartSetup({\n    series: props.series,\n    includePatterns: true,\n  });\n  const { options, annotationLookup, tooltipOptions } = useMemo(\n    () => buildLineAreaChartOptions(props),\n    [props]\n  );\n  const hasOnClick = Boolean(props.onClick);\n  const isArea = AREA_VARIANTS.has(props.variant);\n\n  return (\n    <div\n      {...getChartContainerProps({\n        familyClasses: [\n          \"seeds-chart-time-series\",\n          isArea ? \"seeds-chart-area\" : \"seeds-chart-line\",\n        ],\n        // RAW per-series colors: only an explicit consumer override is inlined\n        // as --highcharts-color-N; an unset series falls through to the DS\n        // palette default in chart-styles.css. ChartRenderer below still gets\n        // the palette-RESOLVED `colors` for its own styled-components engine.\n        colors: props.series.map((s) => s.color),\n        patterns,\n        hasOnClick,\n        className: props.className,\n      })}\n    >\n      <ChartRenderer\n        options={options}\n        series={props.series}\n        colors={colors}\n        tooltip={props.tooltip}\n        annotationLookup={annotationLookup}\n        hasOnClick={hasOnClick}\n        tooltipClickLabel={props.tooltipClickLabel}\n        tooltipOptions={tooltipOptions}\n        invalidNumberLabel={props.invalidNumberLabel}\n        valueFormat={props.yAxis?.format}\n        exportTitle={props.exportTitle}\n        onReady={props.onReady}\n      />\n    </div>\n  );\n});\n","import { buildAnnotationConfig } from \"../shared/annotations\";\nimport type { ChartAnnotationLookup } from \"../shared/annotations\";\nimport type {\n  ChartTooltipProps,\n  SeedsChartDataPoint,\n  SeedsChartOptions,\n} from \"../shared/chartBase\";\nimport { buildBaseChartOptions } from \"../shared/baseChartOptions\";\nimport { TIME_SERIES_CHART_HEIGHT } from \"../../constants/chartOptions\";\nimport {\n  buildDimensionalAxis,\n  resolveTooltipOptions,\n} from \"../shared/axisOptions\";\nimport {\n  defaultValueAxisLabelFormatter,\n  makeValueAxisLabelFormatter,\n} from \"../shared/valueAxisLabelFormatter\";\nimport type { ChartDataPoint } from \"../shared/axis\";\nimport type { LineAreaChartProps, LineAreaVariant } from \"./types\";\n\n// `stacking` is meaningful only for filled variants; on `line`/`spline` it's a\n// no-op, so the adapter drops it rather than emitting a misleading option.\nconst AREA_VARIANTS = new Set<LineAreaVariant>([\"area\", \"areaspline\"]);\n\ntype SeriesPoint =\n  | number\n  | null\n  | [number, number | null]\n  | SeedsChartDataPoint;\n\nfunction pointY(point: ChartDataPoint): number | null {\n  if (point === null) return null;\n  if (typeof point === \"number\") return point;\n  if (Array.isArray(point)) return point[1];\n  return point.y;\n}\n\n// Point markers are hidden by default (set on `plotOptions.series`), but an\n// *isolated* non-null point — one with a null (or the chart edge) on both\n// sides — gets a circle marker so a point with no connecting line segment\n// stays visible. Connected points pass through unchanged so the line/area\n// renders dot-free, matching the designs.\nfunction withIsolatedPointMarkers(\n  data: ReadonlyArray<ChartDataPoint>\n): SeriesPoint[] {\n  return data.map((point, i): SeriesPoint => {\n    if (point === null) return null; // explicit gap\n    if (pointY(point) === null) return point; // tuple/object with null y — a gap\n    const prevY = i === 0 ? null : pointY(data[i - 1]!);\n    const nextY = i === data.length - 1 ? null : pointY(data[i + 1]!);\n    if (prevY !== null || nextY !== null) return point; // connected → no marker\n    const marker = { enabled: true, symbol: \"circle\" as const };\n    if (typeof point === \"number\") return { y: point, marker };\n    if (Array.isArray(point)) return { x: point[0], y: point[1], marker };\n    return { ...point, marker };\n  });\n}\n\nexport function buildLineAreaChartOptions(props: LineAreaChartProps): {\n  options: SeedsChartOptions;\n  annotationLookup: ChartAnnotationLookup | undefined;\n  /** Resolved datetime-derived tooltip options (timezone / timeFormat / textLocale); all undefined on category axes. */\n  tooltipOptions: Pick<\n    ChartTooltipProps,\n    \"timezone\" | \"timeFormat\" | \"textLocale\"\n  >;\n} {\n  const tooltipOptions = resolveTooltipOptions(props);\n  const isStacked = AREA_VARIANTS.has(props.variant) && Boolean(props.stacking);\n  const { annotations, lookup: annotationLookup } = buildAnnotationConfig(\n    props.annotations\n  );\n\n  const base = buildBaseChartOptions({\n    type: props.variant,\n    description: props.description,\n    reserveTopMargin: Boolean(annotations),\n    timezone: tooltipOptions.timezone,\n  });\n\n  const options: SeedsChartOptions = {\n    ...base,\n    // Default height baseline (overridable via `props.height`) so consumers\n    // who don't configure sizing keep the design-reviewed default.\n    chart: {\n      ...base.chart,\n      // Re-assert the definite `type` so spreading the optionally-typed\n      // `base.chart` doesn't widen the required `type` field to optional.\n      type: props.variant,\n      height: props.height ?? TIME_SERIES_CHART_HEIGHT,\n      // Tight time-series spacing (from constants/chartOptions.ts) so the plot\n      // area fills the 275px container; without it Highcharts' larger default\n      // spacing ([10, 10, 15, 10]) shrinks the plot area.\n      spacing: [5, 1, 0, 2],\n    },\n    xAxis: buildDimensionalAxis(props.xAxis, tooltipOptions.timezone ?? \"UTC\"),\n    yAxis: {\n      min: props.yAxis?.min,\n      max: props.yAxis?.max,\n      // Anchor the value axis to 0 (as the bar/area families do): line/spline otherwise\n      // auto-scale above 0, which truncates the axis and pushes the annotation\n      // anchor (y: 0) out of range. `soft` still extends for negative data.\n      softMin: 0,\n      softMax: 0,\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      // Zero-config default: abbreviate value-axis ticks (1.20K / 1.20M / 1.20B).\n      labels: {\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: {\n        animation: false,\n        // Hide point markers by default (per the designs); isolated points\n        // re-enable their own marker via `withIsolatedPointMarkers`.\n        marker: { enabled: false },\n        ...(props.onClick || props.onMouseEnter || props.onMouseLeave\n          ? {\n              point: {\n                events: {\n                  click: props.onClick\n                    ? (event) => props.onClick!({ position: event.point.x })\n                    : undefined,\n                  mouseOver: props.onMouseEnter\n                    ? function (this: { x: number | string }) {\n                        props.onMouseEnter!({ position: this.x });\n                      }\n                    : undefined,\n                  mouseOut: props.onMouseLeave\n                    ? function (this: { x: number | string }) {\n                        props.onMouseLeave!({ position: this.x });\n                      }\n                    : undefined,\n                },\n              },\n            }\n          : {}),\n      },\n      // Type-scoped stacking: only the (area) variant stacks. `isStacked` already\n      // guarantees `props.variant` is an area variant here, so the computed key is\n      // always a valid plotOptions slot. Matches bar's per-type placement and keeps\n      // line/spline unstacked.\n      ...(isStacked ? { [props.variant]: { stacking: props.stacking } } : {}),\n    },\n    series: props.series.map((s) => ({\n      type: props.variant,\n      name: s.name,\n      data: withIsolatedPointMarkers(s.data),\n    })),\n    ...(annotations ? { annotations } : {}),\n  };\n\n  return { options, annotationLookup, tooltipOptions };\n}\n"]}

package/dist/sparkline/index.js

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
 
 
-var _chunkLKUL4EFZjs = require('../chunk-LKUL4EFZ.js');
+var _chunk2A3KLUIFjs = require('../chunk-2A3KLUIF.js');
 
 
 
-var _chunk5JQXDK23js = require('../chunk-5JQXDK23.js');
-require('../chunk-W57R2V23.js');
+var _chunkTNZNBMSZjs = require('../chunk-TNZNBMSZ.js');
+require('../chunk-LWDHU4QK.js');
 
 // src/charts/sparkline/SparklineChart.tsx
 var _react = require('react');
@@ -19,12 +19,12 @@ function highchartsType(variant) {
 var SPARKLINE_SERIES_NAME = "sparkline";
 function buildSparklineChartOptions(props) {
   const type = highchartsType(props.variant);
-  const tooltipOptions = _chunkLKUL4EFZjs.resolveTooltipOptions.call(void 0, props);
+  const tooltipOptions = _chunk2A3KLUIFjs.resolveTooltipOptions.call(void 0, props);
   const xAxis = props.xAxis ? {
-    ..._chunkLKUL4EFZjs.buildDimensionalAxis.call(void 0, props.xAxis, _nullishCoalesce(tooltipOptions.timezone, () => ( "UTC"))),
+    ..._chunk2A3KLUIFjs.buildDimensionalAxis.call(void 0, props.xAxis, _nullishCoalesce(tooltipOptions.timezone, () => ( "UTC"))),
     visible: false
   } : { type: "linear", visible: false };
-  const base = _chunk5JQXDK23js.buildBaseChartOptions.call(void 0, {
+  const base = _chunkTNZNBMSZjs.buildBaseChartOptions.call(void 0, {
     type,
     description: props.description,
     timezone: tooltipOptions.timezone
@@ -101,7 +101,7 @@ var SparklineChart = _react.memo.call(void 0, function SparklineChart2(props) {
       className,
       style: { "--seeds-sparkline-color": trendColor },
       children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-        _chunk5JQXDK23js.ChartRenderer,
+        _chunkTNZNBMSZjs.ChartRenderer,
         {
           options,
           series: [{ name: SPARKLINE_SERIES_NAME, color: trendColor }],

package/dist/wordcloud/index.d.mts

@@ -0,0 +1,62 @@
+import * as react from 'react';
+import { C as ChartExportHandle } from '../chartExport-CKYpuhik.mjs';
+
+/** A single word in the cloud. `weight` drives both font size and (absent `groups`) opacity. */
+interface WordCloudDataPoint {
+    /** The word as rendered. */
+    name: string;
+    /** Relative size driver; larger renders bigger. */
+    weight: number;
+    /** Links this word to a WordCloudGroup for coloring and dimming. */
+    groupId?: string;
+}
+/** A competitive/category grouping. Presence of `groups` switches the cloud into competitive mode. */
+interface WordCloudGroup {
+    id: string;
+    name: string;
+    /** Overrides this group's palette slot. Tenant-specific competitor colors go here. */
+    color?: string;
+}
+interface WordCloudClickData {
+    name: string;
+    weight: number;
+    groupId?: string;
+    pointIndex: number;
+    pageX: number;
+    pageY: number;
+}
+interface WordCloudProps {
+    data: Array<WordCloudDataPoint>;
+    /** Competitive mode. Omit for a single-color cloud. */
+    groups?: Array<WordCloudGroup>;
+    /** Dims every word outside this group. Null or undefined means no dimming. */
+    activeGroupId?: string | null;
+    minFontSize?: number;
+    maxFontSize?: number;
+    /** [min, max] weight-driven opacity ramp. Defaults to [0.6, 1]; pass [1, 1] to disable. */
+    opacityRange?: [number, number];
+    /** Approximate spacing between words, in pixels. Defaults to a value derived from container width (1-4px, narrower containers get less). Larger values shrink the rendered font size. */
+    wordPadding?: number;
+    /** Skips internal container measurement — pass the container's known pixel width directly. Useful in tests (no `ResizeObserver` mocking needed) and anywhere the width is already known. */
+    width?: number;
+    height?: number;
+    /** Accessibility description (Highcharts `accessibility.description`) — required, matching every sibling v2 family. */
+    description: string;
+    className?: string;
+    onClick?: (data: WordCloudClickData) => void;
+    onReady?: (handle: ChartExportHandle) => void;
+}
+
+/**
+ * WordCloud renders a Highcharts wordcloud chart from a flat list of weighted
+ * words, optionally grouped (competitive coloring + externally-driven dimming
+ * via `activeGroupId`).
+ *
+ * Like BubbleChart/DonutChart, it carries no `styled-components`: the wrapper
+ * is a plain `<div>` and the Highcharts styling ships as static CSS. Consumers
+ * import both `@sproutsocial/seeds-react-data-viz/chart-styles.css` and
+ * `.../wordcloud.css` once (the component never self-imports its CSS).
+ */
+declare const WordCloud: react.NamedExoticComponent<WordCloudProps>;
+
+export { ChartExportHandle, WordCloud, type WordCloudClickData, type WordCloudDataPoint, type WordCloudGroup, type WordCloudProps };

package/dist/wordcloud/index.d.ts

@@ -0,0 +1,62 @@
+import * as react from 'react';
+import { C as ChartExportHandle } from '../chartExport-CKYpuhik.js';
+
+/** A single word in the cloud. `weight` drives both font size and (absent `groups`) opacity. */
+interface WordCloudDataPoint {
+    /** The word as rendered. */
+    name: string;
+    /** Relative size driver; larger renders bigger. */
+    weight: number;
+    /** Links this word to a WordCloudGroup for coloring and dimming. */
+    groupId?: string;
+}
+/** A competitive/category grouping. Presence of `groups` switches the cloud into competitive mode. */
+interface WordCloudGroup {
+    id: string;
+    name: string;
+    /** Overrides this group's palette slot. Tenant-specific competitor colors go here. */
+    color?: string;
+}
+interface WordCloudClickData {
+    name: string;
+    weight: number;
+    groupId?: string;
+    pointIndex: number;
+    pageX: number;
+    pageY: number;
+}
+interface WordCloudProps {
+    data: Array<WordCloudDataPoint>;
+    /** Competitive mode. Omit for a single-color cloud. */
+    groups?: Array<WordCloudGroup>;
+    /** Dims every word outside this group. Null or undefined means no dimming. */
+    activeGroupId?: string | null;
+    minFontSize?: number;
+    maxFontSize?: number;
+    /** [min, max] weight-driven opacity ramp. Defaults to [0.6, 1]; pass [1, 1] to disable. */
+    opacityRange?: [number, number];
+    /** Approximate spacing between words, in pixels. Defaults to a value derived from container width (1-4px, narrower containers get less). Larger values shrink the rendered font size. */
+    wordPadding?: number;
+    /** Skips internal container measurement — pass the container's known pixel width directly. Useful in tests (no `ResizeObserver` mocking needed) and anywhere the width is already known. */
+    width?: number;
+    height?: number;
+    /** Accessibility description (Highcharts `accessibility.description`) — required, matching every sibling v2 family. */
+    description: string;
+    className?: string;
+    onClick?: (data: WordCloudClickData) => void;
+    onReady?: (handle: ChartExportHandle) => void;
+}
+
+/**
+ * WordCloud renders a Highcharts wordcloud chart from a flat list of weighted
+ * words, optionally grouped (competitive coloring + externally-driven dimming
+ * via `activeGroupId`).
+ *
+ * Like BubbleChart/DonutChart, it carries no `styled-components`: the wrapper
+ * is a plain `<div>` and the Highcharts styling ships as static CSS. Consumers
+ * import both `@sproutsocial/seeds-react-data-viz/chart-styles.css` and
+ * `.../wordcloud.css` once (the component never self-imports its CSS).
+ */
+declare const WordCloud: react.NamedExoticComponent<WordCloudProps>;
+
+export { ChartExportHandle, WordCloud, type WordCloudClickData, type WordCloudDataPoint, type WordCloudGroup, type WordCloudProps };

package/dist/wordcloud/index.js

@@ -0,0 +1,82 @@
+"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; }
+
+var _chunk6EIJCJCNjs = require('../chunk-6EIJCJCN.js');
+
+
+
+
+
+
+
+var _chunkTNZNBMSZjs = require('../chunk-TNZNBMSZ.js');
+require('../chunk-LWDHU4QK.js');
+
+// src/charts/wordcloud/WordCloud.tsx
+var _react = require('react');
+var _seedsreacthooks = require('@sproutsocial/seeds-react-hooks');
+var _jsxruntime = require('react/jsx-runtime');
+function resolveActiveGroupIndex(activeGroupId, groups) {
+  if (activeGroupId == null || !_optionalChain([groups, 'optionalAccess', _ => _.length])) return void 0;
+  const index = groups.findIndex((group) => group.id === activeGroupId);
+  return index === -1 ? void 0 : index;
+}
+var WordCloud = _react.memo.call(void 0, function WordCloud2(props) {
+  const { colors } = _chunkTNZNBMSZjs.useSeedsChartSetup.call(void 0, {
+    series: _optionalChain([props, 'access', _2 => _2.groups, 'optionalAccess', _3 => _3.length]) ? props.groups.map((group) => ({ color: group.color })) : [{ color: void 0 }]
+  });
+  const containerRef = _react.useRef.call(void 0, null);
+  const { width: measuredWidth } = _seedsreacthooks.useMeasure.call(void 0, containerRef, true);
+  const width = _nullishCoalesce(props.width, () => ( measuredWidth));
+  const derivedMaxFontSize = _chunkTNZNBMSZjs.deriveMaxFontSize.call(void 0, width);
+  const derivedMaxWordCount = _chunkTNZNBMSZjs.deriveMaxWordCount.call(void 0, width);
+  const derivedWordPadding = _chunkTNZNBMSZjs.deriveWordPadding.call(void 0, width);
+  const options = _react.useMemo.call(void 0, 
+    () => _chunkTNZNBMSZjs.buildWordCloudOptions.call(void 0, props, width),
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `width` is intentionally excluded; see the comment above `derivedMaxFontSize`.
+    [props, derivedMaxFontSize, derivedMaxWordCount, derivedWordPadding]
+  );
+  const activeGroupIndex = resolveActiveGroupIndex(
+    props.activeGroupId,
+    props.groups
+  );
+  const containerProps = _chunk6EIJCJCNjs.getChartContainerProps.call(void 0, {
+    familyClasses: ["seeds-chart-wordcloud"],
+    // RAW per-group colors only — an unset group falls through to
+    // chart-styles.css's --highcharts-color-N default, matching the
+    // bubble/bar convention. Only an explicit consumer override is inlined.
+    colors: _nullishCoalesce(_optionalChain([props, 'access', _4 => _4.groups, 'optionalAccess', _5 => _5.map, 'call', _6 => _6((group) => group.color)]), () => ( [])),
+    hasOnClick: Boolean(props.onClick),
+    className: props.className
+  });
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    "div",
+    {
+      ref: containerRef,
+      ...containerProps,
+      ...activeGroupIndex !== void 0 ? { "data-active-group-index": activeGroupIndex } : {},
+      // Gate the chart's one-and-only real mount on a genuinely measured
+      // width. This container `<div>` still always renders (measuring it
+      // is what produces `measuredWidth` in the first place) — but a
+      // `width` of 0 means "no room to lay out yet," not "assume the
+      // widest case," so nothing else renders until it's positive. This
+      // is also what makes Highcharts' native center-burst entrance
+      // animation (plotOptions.wordcloud.animation, above) fire on first
+      // paint: `chart.hasRendered` never gets set by a wrong-then-corrected
+      // double render.
+      children: width > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        _chunkTNZNBMSZjs.ChartRenderer,
+        {
+          options,
+          series: _optionalChain([options, 'access', _7 => _7.series, 'optionalAccess', _8 => _8.length]) ? [{ name: "Word Cloud" }] : [],
+          colors,
+          hideLegend: true,
+          onReady: props.onReady
+        }
+      )
+    }
+  );
+});
+
+
+exports.WordCloud = WordCloud;
+//# sourceMappingURL=index.js.map

package/dist/wordcloud/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/wordcloud/index.js","../../src/charts/wordcloud/WordCloud.tsx"],"names":["WordCloud"],"mappings":"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","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/wordcloud/index.js","sourcesContent":[null,"import { memo, useMemo, useRef } from \"react\";\nimport { useMeasure } from \"@sproutsocial/seeds-react-hooks\";\nimport { useSeedsChartSetup, ChartRenderer } from \"../shared/chartBase\";\nimport { getChartContainerProps } from \"../shared/chartContainer\";\nimport {\n  buildWordCloudOptions,\n  deriveMaxFontSize,\n  deriveMaxWordCount,\n  deriveWordPadding,\n} from \"./adapter\";\nimport type { WordCloudGroup, WordCloudProps } from \"./types\";\n\n/**\n * Resolves `activeGroupId` to its index in `groups` for the container's\n * `data-active-group-index` attribute (layer 2 CSS dimming, wordcloud.css).\n * An unresolvable id (unknown, or no `groups`) is treated the same as\n * null/undefined — no dimming — rather than falling back to group 0, which\n * would incorrectly mark group 0 as \"active\" and dim everything else.\n */\nfunction resolveActiveGroupIndex(\n  activeGroupId: string | null | undefined,\n  groups: ReadonlyArray<WordCloudGroup> | undefined\n): number | undefined {\n  if (activeGroupId == null || !groups?.length) return undefined;\n  const index = groups.findIndex((group) => group.id === activeGroupId);\n  return index === -1 ? undefined : index;\n}\n\n/**\n * WordCloud renders a Highcharts wordcloud chart from a flat list of weighted\n * words, optionally grouped (competitive coloring + externally-driven dimming\n * via `activeGroupId`).\n *\n * Like BubbleChart/DonutChart, it carries no `styled-components`: the wrapper\n * is a plain `<div>` and the Highcharts styling ships as static CSS. Consumers\n * import both `@sproutsocial/seeds-react-data-viz/chart-styles.css` and\n * `.../wordcloud.css` once (the component never self-imports its CSS).\n */\nexport const WordCloud = memo(function WordCloud(props: WordCloudProps) {\n  // One \"series\" input per group (or a single default entry when ungrouped),\n  // matching bubble/donut's convention: colorIndex slots map 1:1 to entries\n  // here, so the resolved `colors` array sizes and resolves correctly for\n  // both the live chart and the styledMode:false export clone.\n  const { colors } = useSeedsChartSetup({\n    series: props.groups?.length\n      ? props.groups.map((group) => ({ color: group.color }))\n      : [{ color: undefined }],\n  });\n\n  const containerRef = useRef<HTMLDivElement>(null);\n  // `synchronous: true` reads the container's bounds before first paint\n  // instead of waiting on ResizeObserver's own (always-async) first\n  // callback — otherwise every derive* below sees a false `width: 0` on\n  // mount and renders the widest-case guess before snapping to the real\n  // layout a tick later (the flash this family shipped with through Slice\n  // 8). An explicit `props.width` skips measurement entirely.\n  const { width: measuredWidth } = useMeasure(containerRef, true);\n  const width = props.width ?? measuredWidth;\n  // These derived values, not raw `width`, drive the memo dependency below.\n  // Each is a step function of width (`deriveMaxFontSize`/`deriveMaxWordCount`/\n  // `deriveWordPadding` in adapter.ts), so a resize tick that lands in the\n  // same bucket for all three — most of them, during a drag-resize — leaves\n  // the dependency array unchanged and the options object keeps its identity\n  // instead of forcing Highcharts to re-lay out the cloud on every\n  // ResizeObserver callback.\n  const derivedMaxFontSize = deriveMaxFontSize(width);\n  const derivedMaxWordCount = deriveMaxWordCount(width);\n  const derivedWordPadding = deriveWordPadding(width);\n  const options = useMemo(\n    () => buildWordCloudOptions(props, width),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- `width` is intentionally excluded; see the comment above `derivedMaxFontSize`.\n    [props, derivedMaxFontSize, derivedMaxWordCount, derivedWordPadding]\n  );\n  const activeGroupIndex = resolveActiveGroupIndex(\n    props.activeGroupId,\n    props.groups\n  );\n\n  const containerProps = getChartContainerProps({\n    familyClasses: [\"seeds-chart-wordcloud\"],\n    // RAW per-group colors only — an unset group falls through to\n    // chart-styles.css's --highcharts-color-N default, matching the\n    // bubble/bar convention. Only an explicit consumer override is inlined.\n    colors: props.groups?.map((group) => group.color) ?? [],\n    hasOnClick: Boolean(props.onClick),\n    className: props.className,\n  });\n\n  return (\n    <div\n      ref={containerRef}\n      {...containerProps}\n      {...(activeGroupIndex !== undefined\n        ? { \"data-active-group-index\": activeGroupIndex }\n        : {})}\n    >\n      {\n        // Gate the chart's one-and-only real mount on a genuinely measured\n        // width. This container `<div>` still always renders (measuring it\n        // is what produces `measuredWidth` in the first place) — but a\n        // `width` of 0 means \"no room to lay out yet,\" not \"assume the\n        // widest case,\" so nothing else renders until it's positive. This\n        // is also what makes Highcharts' native center-burst entrance\n        // animation (plotOptions.wordcloud.animation, above) fire on first\n        // paint: `chart.hasRendered` never gets set by a wrong-then-corrected\n        // double render.\n        width > 0 && (\n          <ChartRenderer\n            options={options}\n            // A single Highcharts series (all words), so a single entry here —\n            // its only job is satisfying ChartRenderer's non-empty-series check,\n            // since hideLegend suppresses the legend this would otherwise feed.\n            series={options.series?.length ? [{ name: \"Word Cloud\" }] : []}\n            colors={colors}\n            hideLegend\n            onReady={props.onReady}\n          />\n        )\n      }\n    </div>\n  );\n});\n"]}

package/dist/wordcloud.css

@@ -0,0 +1,79 @@
+/**
+ * Seeds WordCloud family styles.
+ *
+ * The wordcloud-specific layer on top of the shared `chart-styles.css`
+ * foundation, implementing a three-layer opacity model:
+ *
+ *   1. Weight ramp — per-point `opacity` set once in the adapter's series
+ *                     data (wordcloud/adapter.ts), landing as an SVG
+ *                     presentation attribute (Highcharts' `WordcloudSeries`
+ *                     applies it with no styledMode guard).
+ *   2. Group dim   — below. Gated on the wrapper's `data-active-group-index`
+ *                     attribute (set from `activeGroupId`, resolved against
+ *                     `groups`), scoped per adapter-assigned
+ *                     `.seeds-wordcloud-word--group-{n}` class.
+ *   3. Hover       — below. Highcharts' native `.highcharts-point-hover`/
+ *                     `.highcharts-point-inactive`, inherited from
+ *                     ColumnSeries state handling.
+ *
+ * All three layers write the CSS `opacity` *property*, never `fill-opacity`:
+ * a presentation attribute (layer 1) resolves in the author origin at
+ * specificity 0, so any author `opacity` declaration here replaces it
+ * outright rather than multiplying with it. This matches `donut/donut.css`'s
+ * existing opacity-property dimming.
+ *
+ * Layers 2 and 3 can coexist (hovering a word while `activeGroupId` is set),
+ * and layer 3 must always win. The layer 2 rules below exclude
+ * `.highcharts-point-hover`/`.highcharts-point-inactive` from their selector
+ * for exactly this: the moment any point is hovered, every point in the
+ * series carries one of those two classes (`inactiveOtherPoints: true`), so
+ * layer 2 stops matching anything and layer 3 takes over completely, with no
+ * `!important` needed.
+ *
+ * Consumers import BOTH stylesheets once (the component never self-imports):
+ *
+ *   import "@sproutsocial/seeds-react-data-viz/chart-styles.css";
+ *   import "@sproutsocial/seeds-react-data-viz/wordcloud.css";
+ */
+
+/* Layer 3: hover. The hovered word lifts to full opacity; every other word
+   drops to a flat 0.6, discarding its own weight-ramp value for the
+   duration of the hover. */
+.seeds-chart-wordcloud .highcharts-point-hover {
+  opacity: 1;
+  transition: opacity 0s;
+}
+
+.seeds-chart-wordcloud .highcharts-point-inactive {
+  opacity: 0.6;
+  transition: opacity 0s;
+}
+
+/* Layer 2: group dim. Only active when the wrapper sets
+   `data-active-group-index` (a resolved `activeGroupId`); bounded by the DS
+   data-viz palette length (20 slots — chart-styles.css's --highcharts-color-0
+   through -19). Excludes hover-state classes so layer 3 always wins during a
+   hover (see the file header). One shared declaration: every group index
+   dims to the same 0.4, only the selector differs. */
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="0"]) .seeds-wordcloud-word--group-0:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="1"]) .seeds-wordcloud-word--group-1:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="2"]) .seeds-wordcloud-word--group-2:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="3"]) .seeds-wordcloud-word--group-3:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="4"]) .seeds-wordcloud-word--group-4:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="5"]) .seeds-wordcloud-word--group-5:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="6"]) .seeds-wordcloud-word--group-6:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="7"]) .seeds-wordcloud-word--group-7:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="8"]) .seeds-wordcloud-word--group-8:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="9"]) .seeds-wordcloud-word--group-9:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="10"]) .seeds-wordcloud-word--group-10:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="11"]) .seeds-wordcloud-word--group-11:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="12"]) .seeds-wordcloud-word--group-12:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="13"]) .seeds-wordcloud-word--group-13:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="14"]) .seeds-wordcloud-word--group-14:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="15"]) .seeds-wordcloud-word--group-15:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="16"]) .seeds-wordcloud-word--group-16:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="17"]) .seeds-wordcloud-word--group-17:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="18"]) .seeds-wordcloud-word--group-18:not(.highcharts-point-hover):not(.highcharts-point-inactive),
+.seeds-chart-wordcloud[data-active-group-index]:not([data-active-group-index="19"]) .seeds-wordcloud-word--group-19:not(.highcharts-point-hover):not(.highcharts-point-inactive) {
+  opacity: 0.4;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sproutsocial/seeds-react-data-viz",
-  "version": "0.24.3",
+  "version": "0.25.0",
   "description": "Seeds React Data Viz Components",
   "author": "Sprout Social, Inc.",
   "license": "MIT",
@@ -38,12 +38,18 @@
       "import": "./dist/esm/bubble/index.js",
       "require": "./dist/bubble/index.js"
     },
+    "./wordcloud": {
+      "types": "./dist/wordcloud/index.d.ts",
+      "import": "./dist/esm/wordcloud/index.js",
+      "require": "./dist/wordcloud/index.js"
+    },
     "./sparkline.css": "./dist/sparkline.css",
     "./chart-styles.css": "./dist/chart-styles.css",
     "./bar.css": "./dist/bar.css",
     "./donut.css": "./dist/donut.css",
     "./line-area.css": "./dist/line-area.css",
     "./bubble.css": "./dist/bubble.css",
+    "./wordcloud.css": "./dist/wordcloud.css",
     "./charts.css": "./dist/charts.css",
     "./export": {
       "types": "./dist/export/index.d.ts",
@@ -71,17 +77,18 @@
   "dependencies": {
     "@sproutsocial/seeds-dataviz": "^0.7.3",
     "@sproutsocial/seeds-networkcolor": "^2.22.0",
-    "@sproutsocial/seeds-react-box": "^1.1.28",
-    "@sproutsocial/seeds-react-button": "^2.3.4",
-    "@sproutsocial/seeds-react-duration": "^1.0.32",
-    "@sproutsocial/seeds-react-icon": "^2.4.8",
-    "@sproutsocial/seeds-react-menu": "^1.16.12",
-    "@sproutsocial/seeds-react-numeral": "^1.0.56",
-    "@sproutsocial/seeds-react-partner-logo": "^1.7.20",
-    "@sproutsocial/seeds-react-system-props": "^3.1.4",
-    "@sproutsocial/seeds-react-table": "^1.0.51",
-    "@sproutsocial/seeds-react-text": "^1.5.3",
-    "@sproutsocial/seeds-react-theme": "^4.3.1",
+    "@sproutsocial/seeds-react-box": "^1.1.30",
+    "@sproutsocial/seeds-react-button": "^2.3.7",
+    "@sproutsocial/seeds-react-duration": "^1.0.34",
+    "@sproutsocial/seeds-react-hooks": "^3.3.0",
+    "@sproutsocial/seeds-react-icon": "^2.5.0",
+    "@sproutsocial/seeds-react-menu": "^1.16.15",
+    "@sproutsocial/seeds-react-numeral": "^1.0.58",
+    "@sproutsocial/seeds-react-partner-logo": "^1.7.22",
+    "@sproutsocial/seeds-react-system-props": "^3.2.0",
+    "@sproutsocial/seeds-react-table": "^1.0.53",
+    "@sproutsocial/seeds-react-text": "^1.5.4",
+    "@sproutsocial/seeds-react-theme": "^4.4.0",
     "highcharts": "^11.4.3",
     "highcharts-react-official": "^3.2.1",
     "jspdf": "^4.2.1",