@sproutsocial/seeds-react-data-viz 0.27.2 → 0.28.0

package/dist/sparkline/index.d.mts

@@ -1,9 +1,8 @@
 import * as react from 'react';
-import { ReactNode } from 'react';
-import { C as ChartTooltipProps } from '../chartBase-Cd405GIA.mjs';
-import { C as ChartExportHandle } from '../chartExport-CKYpuhik.mjs';
-import { C as ChartDataPoint, c as DimensionalAxis } from '../axis-DVx6Mn1k.mjs';
-export { a as CategoryAxis, D as DatetimeAxis } from '../axis-DVx6Mn1k.mjs';
+import { T as TypeChartBaseProps, b as TypeChartTooltipDisplayProps } from '../chartProps-BgGx1GTo.mjs';
+import { T as TypeChartDataPoint, d as TypeDimensionalAxis } from '../axis-Byl9vNMR.mjs';
+export { a as TypeCategoryAxis, b as TypeDatetimeAxis } from '../axis-Byl9vNMR.mjs';
+export { T as TypeChartExportHandle } from '../chartExport-B0imEQ8Y.mjs';
 import '@sproutsocial/seeds-react-icon';
 import '../types-DxrhdAdn.mjs';
 import 'highcharts';
@@ -12,54 +11,46 @@ import 'highcharts';
  * Trend direction derived from a series (first vs. last finite value): rising →
  * `"positive"`, falling → `"negative"`, flat → `"neutral"`.
  */
-type Trend = "positive" | "negative" | "neutral";
+type TypeTrend = "positive" | "negative" | "neutral";
 
 /** A single sparkline value, or a `[timestamp, value]` / `{ x, y }` point on a datetime axis. */
-type SparklineDataPoint = ChartDataPoint;
+type TypeSparklineDataPoint = TypeChartDataPoint;
 /** Visual encoding of the sparkline. `"line"` draws a stroke; `"bar"` draws columns. */
-type SparklineVariant = "line" | "bar";
+type TypeSparklineVariant = "line" | "bar";
 /**
  * Trend direction, derived from the data (first vs. last finite value). Drives
  * the single color the whole sparkline renders in.
  */
-type SparklineTrend = Trend;
-type SparklineXAxis = DimensionalAxis;
-interface SparklineChartProps {
-    /** Wired into Highcharts' `accessibility.description`. */
-    description: string;
+type TypeSparklineTrend = TypeTrend;
+type TypeSparklineXAxis = TypeDimensionalAxis;
+/**
+ * Takes the core and tooltip tiers only — no `height` (this family is
+ * fixed-size, sized via `className`) and no `tooltipClickLabel` (it has no
+ * `onClick`, so the footer would never render). See `shared/chartProps.ts`.
+ */
+interface TypeSparklineChartProps extends TypeChartBaseProps, TypeChartTooltipDisplayProps {
     /** `"line"` (stroke) or `"bar"` (columns). */
-    variant: SparklineVariant;
+    variant: TypeSparklineVariant;
     /**
      * The single data series. Bare numbers render on an index/category axis;
      * `[timestamp, value]` tuples (or `{ x, y }`) render on a datetime axis when
      * `xAxis.type` is `"datetime"`.
      */
-    data: Array<SparklineDataPoint>;
+    data: TypeSparklineDataPoint[];
     /**
-     * Tailwind utilities (or any class names) applied to the wrapper — the intended
-     * way to size the sparkline (e.g. `"h-6 w-32"`). Defaults come from `sparkline.css`.
+     * Same type as the core tier's `className`, restated because this family
+     * gives it a specific job: Tailwind utilities applied to the wrapper are the
+     * intended way to size the sparkline (e.g. `"h-6 w-32"`), standing in for the
+     * `height` prop it opts out of. Defaults come from `sparkline.css`.
      */
     className?: string;
     /**
      * Optional axis config. Omit for the default hidden index axis; pass a
      * datetime axis to place `[timestamp, value]` points in time.
      */
-    xAxis?: SparklineXAxis;
+    xAxis?: TypeSparklineXAxis;
     /** IANA timezone for datetime-axis tooltips. Default `"UTC"`. Ignored for category axes. */
     timezone?: string;
-    /** Override for the default hover tooltip content. */
-    tooltip?: (args: ChartTooltipProps) => ReactNode;
-    /** Override for the value shown when a data point is null. Defaults to an em-dash. */
-    invalidNumberLabel?: ReactNode;
-    /**
-     * Chart title included in the exported image (PNG/SVG/PDF) only — it does
-     * *not* render on screen. The on-screen title is a React sibling outside the
-     * chart SVG and can't be captured on export, so `exportTitle` is baked into
-     * the export clone as a themed native Highcharts title. Omit for no title.
-     */
-    exportTitle?: string;
-    /** Fired once per chart instance with a handle for PNG/SVG/PDF/CSV downloads. Re-fires only on remount. */
-    onReady?: (handle: ChartExportHandle) => void;
 }
 
 /**
@@ -75,6 +66,6 @@ interface SparklineChartProps {
  * `--seeds-sparkline-color` CSS variable, so light/dark works without depending
  * on the theme's CSS-variable stylesheet.
  */
-declare const SparklineChart: react.NamedExoticComponent<SparklineChartProps>;
+declare const SparklineChart: react.NamedExoticComponent<TypeSparklineChartProps>;
 
-export { ChartExportHandle, SparklineChart, type SparklineChartProps, type SparklineDataPoint, type SparklineTrend, type SparklineVariant, type SparklineXAxis };
+export { SparklineChart, type TypeSparklineChartProps, type TypeSparklineDataPoint, type TypeSparklineTrend, type TypeSparklineVariant, type TypeSparklineXAxis };

package/dist/sparkline/index.d.ts

@@ -1,9 +1,8 @@
 import * as react from 'react';
-import { ReactNode } from 'react';
-import { C as ChartTooltipProps } from '../chartBase-BYipK7MZ.js';
-import { C as ChartExportHandle } from '../chartExport-CKYpuhik.js';
-import { C as ChartDataPoint, c as DimensionalAxis } from '../axis-DQXvjzBs.js';
-export { a as CategoryAxis, D as DatetimeAxis } from '../axis-DQXvjzBs.js';
+import { T as TypeChartBaseProps, b as TypeChartTooltipDisplayProps } from '../chartProps-C2Lxty-_.js';
+import { T as TypeChartDataPoint, d as TypeDimensionalAxis } from '../axis-Cn8NAgwb.js';
+export { a as TypeCategoryAxis, b as TypeDatetimeAxis } from '../axis-Cn8NAgwb.js';
+export { T as TypeChartExportHandle } from '../chartExport-B0imEQ8Y.js';
 import '@sproutsocial/seeds-react-icon';
 import '../types-DxrhdAdn.js';
 import 'highcharts';
@@ -12,54 +11,46 @@ import 'highcharts';
  * Trend direction derived from a series (first vs. last finite value): rising →
  * `"positive"`, falling → `"negative"`, flat → `"neutral"`.
  */
-type Trend = "positive" | "negative" | "neutral";
+type TypeTrend = "positive" | "negative" | "neutral";
 
 /** A single sparkline value, or a `[timestamp, value]` / `{ x, y }` point on a datetime axis. */
-type SparklineDataPoint = ChartDataPoint;
+type TypeSparklineDataPoint = TypeChartDataPoint;
 /** Visual encoding of the sparkline. `"line"` draws a stroke; `"bar"` draws columns. */
-type SparklineVariant = "line" | "bar";
+type TypeSparklineVariant = "line" | "bar";
 /**
  * Trend direction, derived from the data (first vs. last finite value). Drives
  * the single color the whole sparkline renders in.
  */
-type SparklineTrend = Trend;
-type SparklineXAxis = DimensionalAxis;
-interface SparklineChartProps {
-    /** Wired into Highcharts' `accessibility.description`. */
-    description: string;
+type TypeSparklineTrend = TypeTrend;
+type TypeSparklineXAxis = TypeDimensionalAxis;
+/**
+ * Takes the core and tooltip tiers only — no `height` (this family is
+ * fixed-size, sized via `className`) and no `tooltipClickLabel` (it has no
+ * `onClick`, so the footer would never render). See `shared/chartProps.ts`.
+ */
+interface TypeSparklineChartProps extends TypeChartBaseProps, TypeChartTooltipDisplayProps {
     /** `"line"` (stroke) or `"bar"` (columns). */
-    variant: SparklineVariant;
+    variant: TypeSparklineVariant;
     /**
      * The single data series. Bare numbers render on an index/category axis;
      * `[timestamp, value]` tuples (or `{ x, y }`) render on a datetime axis when
      * `xAxis.type` is `"datetime"`.
      */
-    data: Array<SparklineDataPoint>;
+    data: TypeSparklineDataPoint[];
     /**
-     * Tailwind utilities (or any class names) applied to the wrapper — the intended
-     * way to size the sparkline (e.g. `"h-6 w-32"`). Defaults come from `sparkline.css`.
+     * Same type as the core tier's `className`, restated because this family
+     * gives it a specific job: Tailwind utilities applied to the wrapper are the
+     * intended way to size the sparkline (e.g. `"h-6 w-32"`), standing in for the
+     * `height` prop it opts out of. Defaults come from `sparkline.css`.
      */
     className?: string;
     /**
      * Optional axis config. Omit for the default hidden index axis; pass a
      * datetime axis to place `[timestamp, value]` points in time.
      */
-    xAxis?: SparklineXAxis;
+    xAxis?: TypeSparklineXAxis;
     /** IANA timezone for datetime-axis tooltips. Default `"UTC"`. Ignored for category axes. */
     timezone?: string;
-    /** Override for the default hover tooltip content. */
-    tooltip?: (args: ChartTooltipProps) => ReactNode;
-    /** Override for the value shown when a data point is null. Defaults to an em-dash. */
-    invalidNumberLabel?: ReactNode;
-    /**
-     * Chart title included in the exported image (PNG/SVG/PDF) only — it does
-     * *not* render on screen. The on-screen title is a React sibling outside the
-     * chart SVG and can't be captured on export, so `exportTitle` is baked into
-     * the export clone as a themed native Highcharts title. Omit for no title.
-     */
-    exportTitle?: string;
-    /** Fired once per chart instance with a handle for PNG/SVG/PDF/CSV downloads. Re-fires only on remount. */
-    onReady?: (handle: ChartExportHandle) => void;
 }
 
 /**
@@ -75,6 +66,6 @@ interface SparklineChartProps {
  * `--seeds-sparkline-color` CSS variable, so light/dark works without depending
  * on the theme's CSS-variable stylesheet.
  */
-declare const SparklineChart: react.NamedExoticComponent<SparklineChartProps>;
+declare const SparklineChart: react.NamedExoticComponent<TypeSparklineChartProps>;
 
-export { ChartExportHandle, SparklineChart, type SparklineChartProps, type SparklineDataPoint, type SparklineTrend, type SparklineVariant, type SparklineXAxis };
+export { SparklineChart, type TypeSparklineChartProps, type TypeSparklineDataPoint, type TypeSparklineTrend, type TypeSparklineVariant, type TypeSparklineXAxis };

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 _chunkCV45MD47js = require('../chunk-CV45MD47.js');
+var _chunkRDS2VCPOjs = require('../chunk-RDS2VCPO.js');
 
 
 
-var _chunk5TWNMPQUjs = require('../chunk-5TWNMPQU.js');
-require('../chunk-34OKRQET.js');
+var _chunkV5EXL244js = require('../chunk-V5EXL244.js');
+require('../chunk-XH7ZKGHD.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 = _chunkCV45MD47js.resolveTooltipOptions.call(void 0, props);
+  const tooltipOptions = _chunkRDS2VCPOjs.resolveTooltipOptions.call(void 0, props);
   const xAxis = props.xAxis ? {
-    ..._chunkCV45MD47js.buildDimensionalAxis.call(void 0, props.xAxis, _nullishCoalesce(tooltipOptions.timezone, () => ( "UTC"))),
+    ..._chunkRDS2VCPOjs.buildDimensionalAxis.call(void 0, props.xAxis, _nullishCoalesce(tooltipOptions.timezone, () => ( "UTC"))),
     visible: false
   } : { type: "linear", visible: false };
-  const base = _chunk5TWNMPQUjs.buildBaseChartOptions.call(void 0, {
+  const base = _chunkV5EXL244js.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, 
-        _chunk5TWNMPQUjs.ChartRenderer,
+        _chunkV5EXL244js.ChartRenderer,
         {
           options,
           series: [{ name: SPARKLINE_SERIES_NAME, color: trendColor }],

package/dist/sparkline/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/sparkline/index.js","../../src/charts/sparkline/SparklineChart.tsx","../../src/charts/sparkline/adapter.ts","../../src/charts/shared/trend.ts"],"names":["SparklineChart"],"mappings":"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","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/sparkline/index.js","sourcesContent":[null,"import { memo, type CSSProperties } from \"react\";\nimport { useTheme } from \"styled-components\";\nimport type { TypeTheme } from \"@sproutsocial/seeds-react-theme\";\nimport { ChartRenderer } from \"../shared/chartBase\";\nimport { buildSparklineChartOptions, SPARKLINE_SERIES_NAME } from \"./adapter\";\nimport { computeTrend, resolveTrendColor } from \"./trend\";\nimport type { SparklineChartProps } from \"./types\";\n\n/**\n * SparklineChart — a compact, axis-less inline micro-chart in a `\"line\"` or\n * `\"bar\"` variant. The whole sparkline is colored by trend (auto-computed from\n * the data): green when rising, red when falling, neutral-gray when flat.\n *\n * Unlike the other v2 chart families this one carries no `styled-components`:\n * the wrapper is a plain `<div>` that accepts `className` (Tailwind sizing), and\n * the Highcharts styling lives in `sparkline.css`. Consumers must import\n * `@sproutsocial/seeds-react-data-viz/sparkline.css` once. The single trend\n * color is resolved from the JS theme and passed down as the\n * `--seeds-sparkline-color` CSS variable, so light/dark works without depending\n * on the theme's CSS-variable stylesheet.\n */\nexport const SparklineChart = memo(function SparklineChart(\n  props: SparklineChartProps\n) {\n  // The active theme resolves the single trend color. We read it directly rather\n  // than via useSeedsChartSetup — the sparkline has no categorical palette or\n  // series-limit concerns, so the hook's series machinery (and its dummy series\n  // input) would be dead weight. ChartRenderer below is itself a styled-\n  // component, so this adds no new dependency; the \"no styled-components\" trait\n  // of this family is about the wrapper being a plain <div> + static CSS.\n  const theme = useTheme() as TypeTheme;\n\n  const trend = computeTrend(props.data);\n  const trendColor = resolveTrendColor(theme, trend);\n\n  const { options, tooltipOptions } = buildSparklineChartOptions(props);\n\n  const className = [\n    \"seeds-sparkline\",\n    `seeds-sparkline-${props.variant}`,\n    props.className,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n\n  return (\n    <div\n      className={className}\n      style={{ \"--seeds-sparkline-color\": trendColor } as CSSProperties}\n    >\n      <ChartRenderer\n        options={options}\n        series={[{ name: SPARKLINE_SERIES_NAME, color: trendColor }]}\n        colors={[trendColor]}\n        tooltip={props.tooltip}\n        tooltipOptions={tooltipOptions}\n        invalidNumberLabel={props.invalidNumberLabel}\n        hideLegend\n        exportTitle={props.exportTitle}\n        onReady={props.onReady}\n      />\n    </div>\n  );\n});\n","import type {\n  ChartTooltipProps,\n  SeedsChartOptions,\n  SeedsChartType,\n} from \"../shared/chartBase\";\nimport { buildBaseChartOptions } from \"../shared/baseChartOptions\";\nimport {\n  buildDimensionalAxis,\n  resolveTooltipOptions,\n} from \"../shared/axisOptions\";\nimport type { SparklineChartProps, SparklineVariant } from \"./types\";\n\n// A sparkline line is a `line`; a sparkline bar is a `column` (vertical bars).\nfunction highchartsType(variant: SparklineVariant): SeedsChartType {\n  return variant === \"bar\" ? \"column\" : \"line\";\n}\n\nconst SPARKLINE_SERIES_NAME = \"sparkline\";\n\nexport function buildSparklineChartOptions(props: SparklineChartProps): {\n  options: SeedsChartOptions;\n  /** Resolved datetime-derived tooltip options (timezone / timeFormat / textLocale); all undefined without a datetime axis. */\n  tooltipOptions: Pick<\n    ChartTooltipProps,\n    \"timezone\" | \"timeFormat\" | \"textLocale\"\n  >;\n} {\n  const type = highchartsType(props.variant);\n  // `resolveTooltipOptions` handles the optional `xAxis` internally (all-undefined\n  // when absent), so the sparkline passes its props straight in like the other\n  // families.\n  const tooltipOptions = resolveTooltipOptions(props);\n\n  // A configured axis is placed but hidden (labels/line/ticks off). Without one\n  // we fall back to a hidden linear index axis.\n  const xAxis = props.xAxis\n    ? {\n        ...buildDimensionalAxis(props.xAxis, tooltipOptions.timezone ?? \"UTC\"),\n        visible: false,\n      }\n    : { type: \"linear\" as const, visible: false };\n\n  const base = buildBaseChartOptions({\n    type,\n    description: props.description,\n    timezone: tooltipOptions.timezone,\n  });\n\n  const options: SeedsChartOptions = {\n    ...base,\n    // Zero the outer spacing so the plot fills the (consumer-sized) wrapper.\n    chart: { type, styledMode: true, animation: false, spacing: [0, 0, 0, 0] },\n    xAxis,\n    yAxis: { visible: false },\n    plotOptions: {\n      series: {\n        animation: false,\n        // Decorative micro-chart: no per-point markers on the line.\n        marker: { enabled: false },\n      },\n      // Tight padding so bars read as a compact cluster.\n      column: {\n        pointPadding: 0.05,\n        groupPadding: 0.05,\n        borderWidth: 0,\n        borderRadius: 3,\n      },\n    },\n    series: [\n      {\n        type,\n        name: SPARKLINE_SERIES_NAME,\n        data: [...props.data],\n      },\n    ],\n  };\n\n  return { options, tooltipOptions };\n}\n\nexport { SPARKLINE_SERIES_NAME };\n","import type { TypeTheme } from \"@sproutsocial/seeds-react-theme\";\nimport type { ChartDataPoint } from \"./axis\";\n\n// Family-agnostic trend helpers, shared across chart families. First used by the\n// sparkline (colored entirely by its trend direction); reusable by any chart\n// that wants a sentiment/directional color from a single series (e.g. a\n// sentiment chart).\n\n/**\n * Trend direction derived from a series (first vs. last finite value): rising →\n * `\"positive\"`, falling → `\"negative\"`, flat → `\"neutral\"`.\n */\nexport type Trend = \"positive\" | \"negative\" | \"neutral\";\n\n/** Extract the numeric y-value from a bare number, tuple, or `{ x, y }` point. */\nfunction yValue(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/**\n * Derive the trend from the series by comparing the first finite value to the\n * last finite value: rising → `\"positive\"`, falling → `\"negative\"`, equal (or\n * fewer than two finite values) → `\"neutral\"`.\n */\nexport function computeTrend(data: ReadonlyArray<ChartDataPoint>): Trend {\n  const finite = data\n    .map(yValue)\n    .filter((v): v is number => v != null && Number.isFinite(v));\n\n  if (finite.length < 2) return \"neutral\";\n\n  const first = finite[0]!;\n  const last = finite[finite.length - 1]!;\n\n  if (last > first) return \"positive\";\n  if (last < first) return \"negative\";\n  return \"neutral\";\n}\n\n/**\n * Resolve the trend to a Seeds decorative highlight/accent color: positive →\n * vibrant green (green-500), negative → vibrant red (red-600), neutral → middle\n * gray (neutral-600). These highlight tones are theme-stable — the same value in\n * light and dark — and are designed to read as accents on either surface.\n */\nexport function resolveTrendColor(theme: TypeTheme, trend: Trend): string {\n  const decorative = theme.colors.container.border.decorative;\n  if (trend === \"positive\") return decorative.green;\n  if (trend === \"negative\") return decorative.red;\n  return decorative.neutral;\n}\n"]}
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/sparkline/index.js","../../src/charts/sparkline/SparklineChart.tsx","../../src/charts/sparkline/adapter.ts","../../src/charts/shared/trend.ts"],"names":["SparklineChart"],"mappings":"AAAA;AACE;AACA;AACF,uDAA6B;AAC7B;AACE;AACA;AACF,uDAA6B;AAC7B,gCAA6B;AAC7B;AACA;ACVA,8BAAyC;AACzC,qDAAyB;ADYzB;AACA;AEDA,SAAS,cAAA,CAAe,OAAA,EAAmD;AACzE,EAAA,OAAO,QAAA,IAAY,MAAA,EAAQ,SAAA,EAAW,MAAA;AACxC;AAEA,IAAM,sBAAA,EAAwB,WAAA;AAEvB,SAAS,0BAAA,CAA2B,KAAA,EAOzC;AACA,EAAA,MAAM,KAAA,EAAO,cAAA,CAAe,KAAA,CAAM,OAAO,CAAA;AAIzC,EAAA,MAAM,eAAA,EAAiB,oDAAA,KAA2B,CAAA;AAIlD,EAAA,MAAM,MAAA,EAAQ,KAAA,CAAM,MAAA,EAChB;AAAA,IACE,GAAG,mDAAA,KAAqB,CAAM,KAAA,mBAAO,cAAA,CAAe,QAAA,UAAY,OAAK,CAAA;AAAA,IACrE,OAAA,EAAS;AAAA,EACX,EAAA,EACA,EAAE,IAAA,EAAM,QAAA,EAAmB,OAAA,EAAS,MAAM,CAAA;AAE9C,EAAA,MAAM,KAAA,EAAO,oDAAA;AAAsB,IACjC,IAAA;AAAA,IACA,WAAA,EAAa,KAAA,CAAM,WAAA;AAAA,IACnB,QAAA,EAAU,cAAA,CAAe;AAAA,EAC3B,CAAC,CAAA;AAED,EAAA,MAAM,QAAA,EAAiC;AAAA,IACrC,GAAG,IAAA;AAAA;AAAA,IAEH,KAAA,EAAO,EAAE,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,SAAA,EAAW,KAAA,EAAO,OAAA,EAAS,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAC,EAAE,CAAA;AAAA,IACzE,KAAA;AAAA,IACA,KAAA,EAAO,EAAE,OAAA,EAAS,MAAM,CAAA;AAAA,IACxB,WAAA,EAAa;AAAA,MACX,MAAA,EAAQ;AAAA,QACN,SAAA,EAAW,KAAA;AAAA;AAAA,QAEX,MAAA,EAAQ,EAAE,OAAA,EAAS,MAAM;AAAA,MAC3B,CAAA;AAAA;AAAA,MAEA,MAAA,EAAQ;AAAA,QACN,YAAA,EAAc,IAAA;AAAA,QACd,YAAA,EAAc,IAAA;AAAA,QACd,WAAA,EAAa,CAAA;AAAA,QACb,YAAA,EAAc;AAAA,MAChB;AAAA,IACF,CAAA;AAAA,IACA,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,IAAA;AAAA,QACA,IAAA,EAAM,qBAAA;AAAA,QACN,IAAA,EAAM,CAAC,GAAG,KAAA,CAAM,IAAI;AAAA,MACtB;AAAA,IACF;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,EAAE,OAAA,EAAS,eAAe,CAAA;AACnC;AFjBA;AACA;AG/CA,SAAS,MAAA,CAAO,KAAA,EAA0C;AACxD,EAAA,GAAA,CAAI,MAAA,GAAS,IAAA,EAAM,OAAO,IAAA;AAC1B,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;AAOO,SAAS,YAAA,CAAa,IAAA,EAAgD;AAC3E,EAAA,MAAM,OAAA,EAAS,IAAA,CACZ,GAAA,CAAI,MAAM,CAAA,CACV,MAAA,CAAO,CAAC,CAAA,EAAA,GAAmB,EAAA,GAAK,KAAA,GAAQ,MAAA,CAAO,QAAA,CAAS,CAAC,CAAC,CAAA;AAE7D,EAAA,GAAA,CAAI,MAAA,CAAO,OAAA,EAAS,CAAA,EAAG,OAAO,SAAA;AAE9B,EAAA,MAAM,MAAA,EAAQ,MAAA,CAAO,CAAC,CAAA;AACtB,EAAA,MAAM,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,CAAC,CAAA;AAErC,EAAA,GAAA,CAAI,KAAA,EAAO,KAAA,EAAO,OAAO,UAAA;AACzB,EAAA,GAAA,CAAI,KAAA,EAAO,KAAA,EAAO,OAAO,UAAA;AACzB,EAAA,OAAO,SAAA;AACT;AAQO,SAAS,iBAAA,CAAkB,KAAA,EAAkB,KAAA,EAA0B;AAC5E,EAAA,MAAM,WAAA,EAAa,KAAA,CAAM,MAAA,CAAO,SAAA,CAAU,MAAA,CAAO,UAAA;AACjD,EAAA,GAAA,CAAI,MAAA,IAAU,UAAA,EAAY,OAAO,UAAA,CAAW,KAAA;AAC5C,EAAA,GAAA,CAAI,MAAA,IAAU,UAAA,EAAY,OAAO,UAAA,CAAW,GAAA;AAC5C,EAAA,OAAO,UAAA,CAAW,OAAA;AACpB;AH+BA;AACA;ACnCM,+CAAA;AA7BC,IAAM,eAAA,EAAiB,yBAAA,SAAcA,eAAAA,CAC1C,KAAA,EACA;AAOA,EAAA,MAAM,MAAA,EAAQ,wCAAA,CAAS;AAEvB,EAAA,MAAM,MAAA,EAAQ,YAAA,CAAa,KAAA,CAAM,IAAI,CAAA;AACrC,EAAA,MAAM,WAAA,EAAa,iBAAA,CAAkB,KAAA,EAAO,KAAK,CAAA;AAEjD,EAAA,MAAM,EAAE,OAAA,EAAS,eAAe,EAAA,EAAI,0BAAA,CAA2B,KAAK,CAAA;AAEpE,EAAA,MAAM,UAAA,EAAY;AAAA,IAChB,iBAAA;AAAA,IACA,CAAA,gBAAA,EAAmB,KAAA,CAAM,OAAO,CAAA,CAAA;AAC1B,IAAA;AAGG,EAAA;AAGT,EAAA;AAAC,IAAA;AAAA,IAAA;AACC,MAAA;AACS,MAAA;AAET,MAAA;AAAC,QAAA;AAAA,QAAA;AACC,UAAA;AACiB,UAAA;AACE,UAAA;AACJ,UAAA;AACf,UAAA;AAC0B,UAAA;AAChB,UAAA;AACS,UAAA;AACJ,UAAA;AAAA,QAAA;AACjB,MAAA;AAAA,IAAA;AACF,EAAA;AAEH;ADwDoC;AACA;AACA","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/sparkline/index.js","sourcesContent":[null,"import { memo, type CSSProperties } from \"react\";\nimport { useTheme } from \"styled-components\";\nimport type { TypeTheme } from \"@sproutsocial/seeds-react-theme\";\nimport { ChartRenderer } from \"../shared/chartBase\";\nimport { buildSparklineChartOptions, SPARKLINE_SERIES_NAME } from \"./adapter\";\nimport { computeTrend, resolveTrendColor } from \"./trend\";\nimport type { TypeSparklineChartProps } from \"./types\";\n\n/**\n * SparklineChart — a compact, axis-less inline micro-chart in a `\"line\"` or\n * `\"bar\"` variant. The whole sparkline is colored by trend (auto-computed from\n * the data): green when rising, red when falling, neutral-gray when flat.\n *\n * Unlike the other v2 chart families this one carries no `styled-components`:\n * the wrapper is a plain `<div>` that accepts `className` (Tailwind sizing), and\n * the Highcharts styling lives in `sparkline.css`. Consumers must import\n * `@sproutsocial/seeds-react-data-viz/sparkline.css` once. The single trend\n * color is resolved from the JS theme and passed down as the\n * `--seeds-sparkline-color` CSS variable, so light/dark works without depending\n * on the theme's CSS-variable stylesheet.\n */\nexport const SparklineChart = memo(function SparklineChart(\n  props: TypeSparklineChartProps\n) {\n  // The active theme resolves the single trend color. We read it directly rather\n  // than via useSeedsChartSetup — the sparkline has no categorical palette or\n  // series-limit concerns, so the hook's series machinery (and its dummy series\n  // input) would be dead weight. ChartRenderer below is itself a styled-\n  // component, so this adds no new dependency; the \"no styled-components\" trait\n  // of this family is about the wrapper being a plain <div> + static CSS.\n  const theme = useTheme() as TypeTheme;\n\n  const trend = computeTrend(props.data);\n  const trendColor = resolveTrendColor(theme, trend);\n\n  const { options, tooltipOptions } = buildSparklineChartOptions(props);\n\n  const className = [\n    \"seeds-sparkline\",\n    `seeds-sparkline-${props.variant}`,\n    props.className,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n\n  return (\n    <div\n      className={className}\n      style={{ \"--seeds-sparkline-color\": trendColor } as CSSProperties}\n    >\n      <ChartRenderer\n        options={options}\n        series={[{ name: SPARKLINE_SERIES_NAME, color: trendColor }]}\n        colors={[trendColor]}\n        tooltip={props.tooltip}\n        tooltipOptions={tooltipOptions}\n        invalidNumberLabel={props.invalidNumberLabel}\n        hideLegend\n        exportTitle={props.exportTitle}\n        onReady={props.onReady}\n      />\n    </div>\n  );\n});\n","import type {\n  TypeSeedsChartOptions,\n  TypeSeedsChartType,\n} from \"../shared/chartBase\";\nimport type { TypeChartTooltipRenderProps } from \"../shared/chartTooltip\";\nimport { buildBaseChartOptions } from \"../shared/baseChartOptions\";\nimport {\n  buildDimensionalAxis,\n  resolveTooltipOptions,\n} from \"../shared/axisOptions\";\nimport type { TypeSparklineChartProps, TypeSparklineVariant } from \"./types\";\n\n// A sparkline line is a `line`; a sparkline bar is a `column` (vertical bars).\nfunction highchartsType(variant: TypeSparklineVariant): TypeSeedsChartType {\n  return variant === \"bar\" ? \"column\" : \"line\";\n}\n\nconst SPARKLINE_SERIES_NAME = \"sparkline\";\n\nexport function buildSparklineChartOptions(props: TypeSparklineChartProps): {\n  options: TypeSeedsChartOptions;\n  /** Resolved datetime-derived tooltip options (timezone / timeFormat / textLocale); all undefined without a datetime axis. */\n  tooltipOptions: Pick<\n    TypeChartTooltipRenderProps,\n    \"timezone\" | \"timeFormat\" | \"textLocale\"\n  >;\n} {\n  const type = highchartsType(props.variant);\n  // `resolveTooltipOptions` handles the optional `xAxis` internally (all-undefined\n  // when absent), so the sparkline passes its props straight in like the other\n  // families.\n  const tooltipOptions = resolveTooltipOptions(props);\n\n  // A configured axis is placed but hidden (labels/line/ticks off). Without one\n  // we fall back to a hidden linear index axis.\n  const xAxis = props.xAxis\n    ? {\n        ...buildDimensionalAxis(props.xAxis, tooltipOptions.timezone ?? \"UTC\"),\n        visible: false,\n      }\n    : { type: \"linear\" as const, visible: false };\n\n  const base = buildBaseChartOptions({\n    type,\n    description: props.description,\n    timezone: tooltipOptions.timezone,\n  });\n\n  const options: TypeSeedsChartOptions = {\n    ...base,\n    // Zero the outer spacing so the plot fills the (consumer-sized) wrapper.\n    chart: { type, styledMode: true, animation: false, spacing: [0, 0, 0, 0] },\n    xAxis,\n    yAxis: { visible: false },\n    plotOptions: {\n      series: {\n        animation: false,\n        // Decorative micro-chart: no per-point markers on the line.\n        marker: { enabled: false },\n      },\n      // Tight padding so bars read as a compact cluster.\n      column: {\n        pointPadding: 0.05,\n        groupPadding: 0.05,\n        borderWidth: 0,\n        borderRadius: 3,\n      },\n    },\n    series: [\n      {\n        type,\n        name: SPARKLINE_SERIES_NAME,\n        data: [...props.data],\n      },\n    ],\n  };\n\n  return { options, tooltipOptions };\n}\n\nexport { SPARKLINE_SERIES_NAME };\n","import type { TypeTheme } from \"@sproutsocial/seeds-react-theme\";\nimport type { TypeChartDataPoint } from \"./axis\";\n\n// Family-agnostic trend helpers, shared across chart families. First used by the\n// sparkline (colored entirely by its trend direction); reusable by any chart\n// that wants a sentiment/directional color from a single series (e.g. a\n// sentiment chart).\n\n/**\n * Trend direction derived from a series (first vs. last finite value): rising →\n * `\"positive\"`, falling → `\"negative\"`, flat → `\"neutral\"`.\n */\nexport type TypeTrend = \"positive\" | \"negative\" | \"neutral\";\n\n/** Extract the numeric y-value from a bare number, tuple, or `{ x, y }` point. */\nfunction yValue(point: TypeChartDataPoint): 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/**\n * Derive the trend from the series by comparing the first finite value to the\n * last finite value: rising → `\"positive\"`, falling → `\"negative\"`, equal (or\n * fewer than two finite values) → `\"neutral\"`.\n */\nexport function computeTrend(data: readonly TypeChartDataPoint[]): TypeTrend {\n  const finite = data\n    .map(yValue)\n    .filter((v): v is number => v != null && Number.isFinite(v));\n\n  if (finite.length < 2) return \"neutral\";\n\n  const first = finite[0]!;\n  const last = finite[finite.length - 1]!;\n\n  if (last > first) return \"positive\";\n  if (last < first) return \"negative\";\n  return \"neutral\";\n}\n\n/**\n * Resolve the trend to a Seeds decorative highlight/accent color: positive →\n * vibrant green (green-500), negative → vibrant red (red-600), neutral → middle\n * gray (neutral-600). These highlight tones are theme-stable — the same value in\n * light and dark — and are designed to read as accents on either surface.\n */\nexport function resolveTrendColor(theme: TypeTheme, trend: TypeTrend): string {\n  const decorative = theme.colors.container.border.decorative;\n  if (trend === \"positive\") return decorative.green;\n  if (trend === \"negative\") return decorative.red;\n  return decorative.neutral;\n}\n"]}

package/dist/wordcloud/index.d.mts

@@ -1,38 +1,45 @@
 import * as react from 'react';
-import { C as ChartExportHandle } from '../chartExport-CKYpuhik.mjs';
+import { T as TypeChartBaseProps, a as TypeChartSizingProps } from '../chartProps-BgGx1GTo.mjs';
+import { T as TypeChartPointerClickData } from '../pointerClick-4LUDwS3L.mjs';
+export { T as TypeChartExportHandle } from '../chartExport-B0imEQ8Y.mjs';
+import '@sproutsocial/seeds-react-icon';
+import '../types-DxrhdAdn.mjs';
+import 'highcharts';
 
 /** A single word in the cloud. `weight` drives both font size and (absent `groups`) opacity. */
-interface WordCloudDataPoint {
+interface TypeWordCloudDataPoint {
     /** The word as rendered. */
     name: string;
     /** Relative size driver; larger renders bigger. */
     weight: number;
-    /** Links this word to a WordCloudGroup for coloring and dimming. */
+    /** Links this word to a TypeWordCloudGroup for coloring and dimming. */
     groupId?: string;
 }
 /** A competitive/category grouping. Presence of `groups` switches the cloud into competitive mode. */
-interface WordCloudGroup {
+interface TypeWordCloudGroup {
     id: string;
     name: string;
     /** Overrides this group's palette slot. Tenant-specific competitor colors go here. */
     color?: string;
 }
-interface WordCloudClickData {
+interface TypeWordCloudClickData extends TypeChartPointerClickData {
     name: string;
+    /** The clicked word's original input weight, not the font-size target. */
     weight: number;
     groupId?: string;
-    pointIndex: number;
-    pageX: number;
-    pageY: number;
 }
-interface WordCloudProps {
-    data: Array<WordCloudDataPoint>;
+/**
+ * Takes the core and sizing tiers only — no tooltip tier, since this family
+ * disables Highcharts' tooltip subsystem entirely (see `shared/chartProps.ts`).
+ */
+interface TypeWordCloudProps extends TypeChartBaseProps, TypeChartSizingProps {
+    data: TypeWordCloudDataPoint[];
     /** Competitive mode. Omit for a single-color cloud. */
-    groups?: Array<WordCloudGroup>;
+    groups?: TypeWordCloudGroup[];
     /** Dims every word outside this group. Null or undefined means no dimming. */
     activeGroupId?: string | null;
     /** Raises every word whose name is in this set to full opacity and dims the rest — the consumer decides what belongs in the set (e.g. every word matching the hovered term's text). Null or undefined means no emphasis. */
-    activeNames?: ReadonlyArray<string> | null;
+    activeNames?: readonly string[] | null;
     minFontSize?: number;
     maxFontSize?: number;
     /** [min, max] weight-driven opacity ramp. Defaults to [0.6, 1]; pass [1, 1] to disable. */
@@ -41,17 +48,12 @@ interface WordCloudProps {
     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;
+    onClick?: (data: TypeWordCloudClickData) => void;
     /** Fires on pointer enter with the hovered word's name (and `groupId`, if grouped); `null` on pointer leave. */
     onWordHover?: (data: {
         name: string;
         groupId?: string;
     } | null) => void;
-    onReady?: (handle: ChartExportHandle) => void;
 }
 
 /**
@@ -64,6 +66,6 @@ interface WordCloudProps {
  * 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>;
+declare const WordCloud: react.NamedExoticComponent<TypeWordCloudProps>;
 
-export { ChartExportHandle, WordCloud, type WordCloudClickData, type WordCloudDataPoint, type WordCloudGroup, type WordCloudProps };
+export { type TypeWordCloudClickData, type TypeWordCloudDataPoint, type TypeWordCloudGroup, type TypeWordCloudProps, WordCloud };

package/dist/wordcloud/index.d.ts

@@ -1,38 +1,45 @@
 import * as react from 'react';
-import { C as ChartExportHandle } from '../chartExport-CKYpuhik.js';
+import { T as TypeChartBaseProps, a as TypeChartSizingProps } from '../chartProps-C2Lxty-_.js';
+import { T as TypeChartPointerClickData } from '../pointerClick-4LUDwS3L.js';
+export { T as TypeChartExportHandle } from '../chartExport-B0imEQ8Y.js';
+import '@sproutsocial/seeds-react-icon';
+import '../types-DxrhdAdn.js';
+import 'highcharts';
 
 /** A single word in the cloud. `weight` drives both font size and (absent `groups`) opacity. */
-interface WordCloudDataPoint {
+interface TypeWordCloudDataPoint {
     /** The word as rendered. */
     name: string;
     /** Relative size driver; larger renders bigger. */
     weight: number;
-    /** Links this word to a WordCloudGroup for coloring and dimming. */
+    /** Links this word to a TypeWordCloudGroup for coloring and dimming. */
     groupId?: string;
 }
 /** A competitive/category grouping. Presence of `groups` switches the cloud into competitive mode. */
-interface WordCloudGroup {
+interface TypeWordCloudGroup {
     id: string;
     name: string;
     /** Overrides this group's palette slot. Tenant-specific competitor colors go here. */
     color?: string;
 }
-interface WordCloudClickData {
+interface TypeWordCloudClickData extends TypeChartPointerClickData {
     name: string;
+    /** The clicked word's original input weight, not the font-size target. */
     weight: number;
     groupId?: string;
-    pointIndex: number;
-    pageX: number;
-    pageY: number;
 }
-interface WordCloudProps {
-    data: Array<WordCloudDataPoint>;
+/**
+ * Takes the core and sizing tiers only — no tooltip tier, since this family
+ * disables Highcharts' tooltip subsystem entirely (see `shared/chartProps.ts`).
+ */
+interface TypeWordCloudProps extends TypeChartBaseProps, TypeChartSizingProps {
+    data: TypeWordCloudDataPoint[];
     /** Competitive mode. Omit for a single-color cloud. */
-    groups?: Array<WordCloudGroup>;
+    groups?: TypeWordCloudGroup[];
     /** Dims every word outside this group. Null or undefined means no dimming. */
     activeGroupId?: string | null;
     /** Raises every word whose name is in this set to full opacity and dims the rest — the consumer decides what belongs in the set (e.g. every word matching the hovered term's text). Null or undefined means no emphasis. */
-    activeNames?: ReadonlyArray<string> | null;
+    activeNames?: readonly string[] | null;
     minFontSize?: number;
     maxFontSize?: number;
     /** [min, max] weight-driven opacity ramp. Defaults to [0.6, 1]; pass [1, 1] to disable. */
@@ -41,17 +48,12 @@ interface WordCloudProps {
     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;
+    onClick?: (data: TypeWordCloudClickData) => void;
     /** Fires on pointer enter with the hovered word's name (and `groupId`, if grouped); `null` on pointer leave. */
     onWordHover?: (data: {
         name: string;
         groupId?: string;
     } | null) => void;
-    onReady?: (handle: ChartExportHandle) => void;
 }
 
 /**
@@ -64,6 +66,6 @@ interface WordCloudProps {
  * 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>;
+declare const WordCloud: react.NamedExoticComponent<TypeWordCloudProps>;
 
-export { ChartExportHandle, WordCloud, type WordCloudClickData, type WordCloudDataPoint, type WordCloudGroup, type WordCloudProps };
+export { type TypeWordCloudClickData, type TypeWordCloudDataPoint, type TypeWordCloudGroup, type TypeWordCloudProps, WordCloud };

package/dist/wordcloud/index.js

@@ -1,6 +1,6 @@
 "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 _chunkI72SSPMXjs = require('../chunk-I72SSPMX.js');
 
 
 
@@ -8,8 +8,8 @@ var _chunk6EIJCJCNjs = require('../chunk-6EIJCJCN.js');
 
 
 
-var _chunk5TWNMPQUjs = require('../chunk-5TWNMPQU.js');
-require('../chunk-34OKRQET.js');
+var _chunkV5EXL244js = require('../chunk-V5EXL244.js');
+require('../chunk-XH7ZKGHD.js');
 
 // src/charts/wordcloud/WordCloud.tsx
 var _react = require('react');
@@ -27,18 +27,18 @@ function resolveActiveWordIndices(activeNames, points) {
   return indices.length ? indices : void 0;
 }
 var WordCloud = _react.memo.call(void 0, function WordCloud2(props) {
-  const { colors } = _chunk5TWNMPQUjs.useSeedsChartSetup.call(void 0, {
+  const { colors } = _chunkV5EXL244js.useSeedsChartSetup.call(void 0, {
     series: _optionalChain([props, 'access', _4 => _4.groups, 'optionalAccess', _5 => _5.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 = _chunk5TWNMPQUjs.deriveMaxFontSize.call(void 0, width);
-  const derivedMaxWordCount = _chunk5TWNMPQUjs.deriveMaxWordCount.call(void 0, width);
-  const derivedWordPadding = _chunk5TWNMPQUjs.deriveWordPadding.call(void 0, width);
+  const derivedMaxFontSize = _chunkV5EXL244js.deriveMaxFontSize.call(void 0, width);
+  const derivedMaxWordCount = _chunkV5EXL244js.deriveMaxWordCount.call(void 0, width);
+  const derivedWordPadding = _chunkV5EXL244js.deriveWordPadding.call(void 0, width);
   const hasActiveNames = props.activeNames !== void 0;
   const options = _react.useMemo.call(void 0, 
-    () => _chunk5TWNMPQUjs.buildWordCloudOptions.call(void 0, props, width, hasActiveNames),
+    () => _chunkV5EXL244js.buildWordCloudOptions.call(void 0, props, width, hasActiveNames),
     // eslint-disable-next-line react-hooks/exhaustive-deps -- `width` excluded (see above); the rest is only what `buildWordCloudOptions` reads, not `props` wholesale, so an activeGroupId/activeNames/className/onReady change doesn't rebuild this.
     [
       props.data,
@@ -66,7 +66,7 @@ var WordCloud = _react.memo.call(void 0, function WordCloud2(props) {
     props.activeNames,
     renderedPoints
   );
-  const containerProps = _chunk6EIJCJCNjs.getChartContainerProps.call(void 0, {
+  const containerProps = _chunkI72SSPMXjs.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
@@ -92,12 +92,13 @@ var WordCloud = _react.memo.call(void 0, function WordCloud2(props) {
       // paint: `chart.hasRendered` never gets set by a wrong-then-corrected
       // double render.
       children: width > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-        _chunk5TWNMPQUjs.ChartRenderer,
+        _chunkV5EXL244js.ChartRenderer,
         {
           options,
           series: _optionalChain([options, 'access', _12 => _12.series, 'optionalAccess', _13 => _13.length]) ? [{ name: "Word Cloud" }] : [],
           colors,
           hideLegend: true,
+          exportTitle: props.exportTitle,
           onReady: props.onReady
         }
       )

package/dist/wordcloud/index.js.map

@@ -1 +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 {\n  SeedsChartWordCloudSeriesOptions,\n  WordCloudGroup,\n  WordCloudProps,\n} 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 * Resolves `activeNames` to the rendered indices of matching points, for the\n * container's `data-active-word-indices` attribute. Reads `points` off the\n * already-built options (not a fresh transform) so indices match what's\n * actually on screen, including `allocateWordsAcrossGroups`'s reordering.\n * Names are unbounded, unlike `activeGroupId`'s small `groups` list, so this\n * keys off each point's bounded position instead — see wordcloud.css's\n * `--index-N` rules (bounded by `WORD_CLOUD_MAXIMUM_WORD_COUNT`).\n */\nfunction resolveActiveWordIndices(\n  activeNames: ReadonlyArray<string> | null | undefined,\n  points: ReadonlyArray<{ name: string }> | undefined\n): ReadonlyArray<number> | undefined {\n  if (!activeNames?.length || !points?.length) return undefined;\n  const activeSet = new Set(activeNames);\n  const indices = points\n    .map((point, i) => (activeSet.has(point.name) ? i : -1))\n    .filter((i) => i !== -1);\n  return indices.length ? indices : undefined;\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` or `activeNames`).\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  // Whether `activeNames` is supplied at all, not its current null/array\n  // value — see `buildWordCloudOptions`'s `hasActiveNames` doc comment.\n  // Stable across hover transitions, so it's safe in the memo deps below.\n  const hasActiveNames = props.activeNames !== undefined;\n  const options = useMemo(\n    () => buildWordCloudOptions(props, width, hasActiveNames),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- `width` excluded (see above); the rest is only what `buildWordCloudOptions` reads, not `props` wholesale, so an activeGroupId/activeNames/className/onReady change doesn't rebuild this.\n    [\n      props.data,\n      props.groups,\n      props.opacityRange,\n      props.description,\n      props.height,\n      props.minFontSize,\n      props.maxFontSize,\n      props.wordPadding,\n      props.onClick,\n      props.onWordHover,\n      hasActiveNames,\n      derivedMaxFontSize,\n      derivedMaxWordCount,\n      derivedWordPadding,\n    ]\n  );\n  const activeGroupIndex = resolveActiveGroupIndex(\n    props.activeGroupId,\n    props.groups\n  );\n  const renderedPoints = (\n    options.series?.[0] as SeedsChartWordCloudSeriesOptions | undefined\n  )?.data;\n  const activeWordIndices = resolveActiveWordIndices(\n    props.activeNames,\n    renderedPoints\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      {...(activeWordIndices !== undefined\n        ? { \"data-active-word-indices\": activeWordIndices.join(\" \") }\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"]}
+{"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 {\n  TypeSeedsChartWordCloudSeriesOptions,\n  TypeWordCloudGroup,\n  TypeWordCloudProps,\n} 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: readonly TypeWordCloudGroup[] | 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 * Resolves `activeNames` to the rendered indices of matching points, for the\n * container's `data-active-word-indices` attribute. Reads `points` off the\n * already-built options (not a fresh transform) so indices match what's\n * actually on screen, including `allocateWordsAcrossGroups`'s reordering.\n * Names are unbounded, unlike `activeGroupId`'s small `groups` list, so this\n * keys off each point's bounded position instead — see wordcloud.css's\n * `--index-N` rules (bounded by `WORD_CLOUD_MAXIMUM_WORD_COUNT`).\n */\nfunction resolveActiveWordIndices(\n  activeNames: readonly string[] | null | undefined,\n  points: readonly { name: string }[] | undefined\n): readonly number[] | undefined {\n  if (!activeNames?.length || !points?.length) return undefined;\n  const activeSet = new Set(activeNames);\n  const indices = points\n    .map((point, i) => (activeSet.has(point.name) ? i : -1))\n    .filter((i) => i !== -1);\n  return indices.length ? indices : undefined;\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` or `activeNames`).\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: TypeWordCloudProps) {\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  // Whether `activeNames` is supplied at all, not its current null/array\n  // value — see `buildWordCloudOptions`'s `hasActiveNames` doc comment.\n  // Stable across hover transitions, so it's safe in the memo deps below.\n  const hasActiveNames = props.activeNames !== undefined;\n  const options = useMemo(\n    () => buildWordCloudOptions(props, width, hasActiveNames),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- `width` excluded (see above); the rest is only what `buildWordCloudOptions` reads, not `props` wholesale, so an activeGroupId/activeNames/className/onReady change doesn't rebuild this.\n    [\n      props.data,\n      props.groups,\n      props.opacityRange,\n      props.description,\n      props.height,\n      props.minFontSize,\n      props.maxFontSize,\n      props.wordPadding,\n      props.onClick,\n      props.onWordHover,\n      hasActiveNames,\n      derivedMaxFontSize,\n      derivedMaxWordCount,\n      derivedWordPadding,\n    ]\n  );\n  const activeGroupIndex = resolveActiveGroupIndex(\n    props.activeGroupId,\n    props.groups\n  );\n  const renderedPoints = (\n    options.series?.[0] as TypeSeedsChartWordCloudSeriesOptions | undefined\n  )?.data;\n  const activeWordIndices = resolveActiveWordIndices(\n    props.activeNames,\n    renderedPoints\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      {...(activeWordIndices !== undefined\n        ? { \"data-active-word-indices\": activeWordIndices.join(\" \") }\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            exportTitle={props.exportTitle}\n            onReady={props.onReady}\n          />\n        )\n      }\n    </div>\n  );\n});\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sproutsocial/seeds-react-data-viz",
-  "version": "0.27.2",
+  "version": "0.28.0",
   "description": "Seeds React Data Viz Components",
   "author": "Sprout Social, Inc.",
   "license": "MIT",
@@ -77,18 +77,18 @@
   "dependencies": {
     "@sproutsocial/seeds-dataviz": "^0.7.3",
     "@sproutsocial/seeds-networkcolor": "^2.22.0",
-    "@sproutsocial/seeds-react-box": "^1.1.31",
-    "@sproutsocial/seeds-react-button": "^2.3.8",
-    "@sproutsocial/seeds-react-duration": "^1.0.35",
-    "@sproutsocial/seeds-react-hooks": "^3.3.1",
-    "@sproutsocial/seeds-react-icon": "^2.5.1",
-    "@sproutsocial/seeds-react-menu": "^1.17.0",
-    "@sproutsocial/seeds-react-numeral": "^1.0.59",
-    "@sproutsocial/seeds-react-partner-logo": "^1.7.23",
+    "@sproutsocial/seeds-react-box": "^1.1.32",
+    "@sproutsocial/seeds-react-button": "^2.3.9",
+    "@sproutsocial/seeds-react-duration": "^1.0.36",
+    "@sproutsocial/seeds-react-hooks": "^3.3.2",
+    "@sproutsocial/seeds-react-icon": "^2.5.2",
+    "@sproutsocial/seeds-react-menu": "^1.18.1",
+    "@sproutsocial/seeds-react-numeral": "^1.0.60",
+    "@sproutsocial/seeds-react-partner-logo": "^1.7.24",
     "@sproutsocial/seeds-react-system-props": "^3.2.1",
-    "@sproutsocial/seeds-react-table": "^1.0.54",
+    "@sproutsocial/seeds-react-table": "^1.0.55",
     "@sproutsocial/seeds-react-text": "^1.5.5",
-    "@sproutsocial/seeds-react-theme": "^4.5.0",
+    "@sproutsocial/seeds-react-theme": "^4.5.1",
     "highcharts": "^11.4.3",
     "highcharts-react-official": "^3.2.1",
     "jspdf": "^4.2.1",