@sproutsocial/seeds-react-data-viz 0.7.32 → 0.15.0

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

@@ -0,0 +1,151 @@
+import {
+  ChartRenderer,
+  buildAnnotationConfig,
+  buildBaseChartOptions,
+  buildDimensionalAxis,
+  defaultValueAxisLabelFormatter,
+  makeValueAxisLabelFormatter,
+  resolveTooltipTimezone,
+  useSeedsChartSetup
+} from "../chunk-OAN5VC7M.js";
+import {
+  areaChartStyles,
+  lineChartStyles
+} from "../chunk-LC3HGWDD.js";
+
+// src/charts/line-area/LineAreaChart.tsx
+import { memo, useMemo } from "react";
+
+// src/charts/line-area/adapter.ts
+var AREA_VARIANTS = /* @__PURE__ */ new Set(["area", "areaspline"]);
+function pointY(point) {
+  if (point === null) return null;
+  if (typeof point === "number") return point;
+  if (Array.isArray(point)) return point[1];
+  return point.y;
+}
+function withIsolatedPointMarkers(data) {
+  return data.map((point, i) => {
+    if (point === null) return null;
+    if (pointY(point) === null) return point;
+    const prevY = i === 0 ? null : pointY(data[i - 1]);
+    const nextY = i === data.length - 1 ? null : pointY(data[i + 1]);
+    if (prevY !== null || nextY !== null) return point;
+    const marker = { enabled: true, symbol: "circle" };
+    if (typeof point === "number") return { y: point, marker };
+    if (Array.isArray(point)) return { x: point[0], y: point[1], marker };
+    return { ...point, marker };
+  });
+}
+function buildLineAreaChartOptions(props) {
+  const tooltipTimezone = resolveTooltipTimezone(props.xAxis, props.timezone);
+  const isStacked = AREA_VARIANTS.has(props.variant) && Boolean(props.stacking);
+  const { annotations, lookup: annotationLookup } = buildAnnotationConfig(
+    props.annotations
+  );
+  const options = {
+    ...buildBaseChartOptions({
+      type: props.variant,
+      description: props.description,
+      valueSuffix: props.valueSuffix,
+      reserveTopMargin: Boolean(annotations),
+      timezone: tooltipTimezone
+    }),
+    xAxis: buildDimensionalAxis(props.xAxis, tooltipTimezone ?? "UTC"),
+    yAxis: {
+      min: props.yAxis?.min,
+      max: props.yAxis?.max,
+      // Anchor the value axis to 0 (like v1/bar/area): line/spline otherwise
+      // auto-scale above 0, which truncates the axis and pushes the annotation
+      // anchor (y: 0) out of range. `soft` still extends for negative data.
+      softMin: 0,
+      softMax: 0,
+      gridLineWidth: props.yAxis?.showGridLines === false ? 0 : 1,
+      title: { text: props.yAxis?.title ?? "" },
+      // Zero-config default: abbreviate value-axis ticks (1.20K / 1.20M / 1.20B).
+      labels: {
+        // A declarative `format` drives ticks through the shared valueFormatter;
+        // absent it, the zero-config decimal default (1.20K / 1.20M / 1.20B).
+        formatter: props.yAxis?.format ? makeValueAxisLabelFormatter(props.yAxis.format) : defaultValueAxisLabelFormatter
+      }
+    },
+    plotOptions: {
+      series: {
+        animation: false,
+        // Hide point markers by default (matching v1 + designs); isolated points
+        // re-enable their own marker via `withIsolatedPointMarkers`.
+        marker: { enabled: false },
+        ...props.onClick ? {
+          point: {
+            events: {
+              click: (event) => props.onClick({ position: event.point.x })
+            }
+          }
+        } : {}
+      },
+      // Type-scoped stacking: only the (area) variant stacks. `isStacked` already
+      // guarantees `props.variant` is an area variant here, so the computed key is
+      // always a valid plotOptions slot. Matches bar's per-type placement and keeps
+      // line/spline unstacked.
+      ...isStacked ? { [props.variant]: { stacking: props.stacking } } : {}
+    },
+    series: props.series.map((s) => ({
+      type: props.variant,
+      name: s.name,
+      data: withIsolatedPointMarkers(s.data)
+    })),
+    ...annotations ? { annotations } : {}
+  };
+  return { options, annotationLookup, tooltipTimezone };
+}
+
+// src/charts/line-area/styles.ts
+import styled from "styled-components";
+var LineAreaChartContainer = styled.div`
+  background-color: ${({ theme }) => theme.colors.container.background.base};
+  ${(props) => props.$isArea ? areaChartStyles : lineChartStyles}
+`;
+
+// src/charts/line-area/LineAreaChart.tsx
+import { jsx } from "react/jsx-runtime";
+var AREA_VARIANTS2 = /* @__PURE__ */ new Set(["area", "areaspline"]);
+var LineAreaChart = memo(function LineAreaChart2(props) {
+  const { colors, patterns } = useSeedsChartSetup({
+    series: props.series,
+    includePatterns: true
+  });
+  const { options, annotationLookup, tooltipTimezone } = useMemo(
+    () => buildLineAreaChartOptions(props),
+    [props]
+  );
+  const hasOnClick = Boolean(props.onClick);
+  return /* @__PURE__ */ jsx(
+    LineAreaChartContainer,
+    {
+      $colors: colors,
+      $patterns: patterns,
+      $hasOnClick: hasOnClick,
+      $isArea: AREA_VARIANTS2.has(props.variant),
+      className: props.className,
+      children: /* @__PURE__ */ jsx(
+        ChartRenderer,
+        {
+          options,
+          series: props.series,
+          colors,
+          tooltip: props.tooltip,
+          annotationLookup,
+          hasOnClick,
+          tooltipClickLabel: props.tooltipClickLabel,
+          timezone: tooltipTimezone,
+          invalidNumberLabel: props.invalidNumberLabel,
+          onReady: props.onReady
+        }
+      )
+    }
+  );
+});
+export {
+  LineAreaChart
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/charts/line-area/LineAreaChart.tsx","../../../src/charts/line-area/adapter.ts","../../../src/charts/line-area/styles.ts"],"sourcesContent":["import { memo, useMemo } from \"react\";\nimport { useSeedsChartSetup, ChartRenderer } from \"../shared/chartBase\";\nimport { buildLineAreaChartOptions } from \"./adapter\";\nimport { LineAreaChartContainer } from \"./styles\";\nimport type { LineAreaChartProps, LineAreaVariant } from \"./types\";\n\nconst AREA_VARIANTS = new Set<LineAreaVariant>([\"area\", \"areaspline\"]);\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, tooltipTimezone } = useMemo(\n    () => buildLineAreaChartOptions(props),\n    [props]\n  );\n  const hasOnClick = Boolean(props.onClick);\n\n  return (\n    <LineAreaChartContainer\n      $colors={colors}\n      $patterns={patterns}\n      $hasOnClick={hasOnClick}\n      $isArea={AREA_VARIANTS.has(props.variant)}\n      className={props.className}\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        timezone={tooltipTimezone}\n        invalidNumberLabel={props.invalidNumberLabel}\n        onReady={props.onReady}\n      />\n    </LineAreaChartContainer>\n  );\n});\n","import { buildAnnotationConfig } from \"../shared/annotations\";\nimport type { ChartAnnotationLookup } from \"../shared/annotations\";\nimport type {\n  SeedsChartDataPoint,\n  SeedsChartOptions,\n} from \"../shared/chartBase\";\nimport { buildBaseChartOptions } from \"../shared/baseChartOptions\";\nimport {\n  buildDimensionalAxis,\n  resolveTooltipTimezone,\n} from \"../shared/axisOptions\";\nimport {\n  defaultValueAxisLabelFormatter,\n  makeValueAxisLabelFormatter,\n} from \"../shared/valueAxisLabelFormatter\";\nimport type { 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// Mirrors v1's marker handling: point markers are hidden by default (set on\n// `plotOptions.series`), but an *isolated* non-null point — one with a null (or\n// the chart edge) on both sides — gets a circle marker so a point with no\n// connecting line segment stays visible. Connected points pass through\n// unchanged so the line/area renders dot-free, matching v1 and 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 timezone for the tooltip date formatter; undefined on category axes. */\n  tooltipTimezone: string | undefined;\n} {\n  const tooltipTimezone = resolveTooltipTimezone(props.xAxis, props.timezone);\n  const isStacked = AREA_VARIANTS.has(props.variant) && Boolean(props.stacking);\n  const { annotations, lookup: annotationLookup } = buildAnnotationConfig(\n    props.annotations\n  );\n\n  const options: SeedsChartOptions = {\n    ...buildBaseChartOptions({\n      type: props.variant,\n      description: props.description,\n      valueSuffix: props.valueSuffix,\n      reserveTopMargin: Boolean(annotations),\n      timezone: tooltipTimezone,\n    }),\n    xAxis: buildDimensionalAxis(props.xAxis, tooltipTimezone ?? \"UTC\"),\n    yAxis: {\n      min: props.yAxis?.min,\n      max: props.yAxis?.max,\n      // Anchor the value axis to 0 (like v1/bar/area): 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      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 (matching v1 + designs); isolated points\n        // re-enable their own marker via `withIsolatedPointMarkers`.\n        marker: { enabled: false },\n        ...(props.onClick\n          ? {\n              point: {\n                events: {\n                  click: (event) => props.onClick!({ position: event.point.x }),\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, tooltipTimezone };\n}\n","import styled from \"styled-components\";\nimport { lineChartStyles, areaChartStyles } from \"../../styles/chartStyles\";\nimport type {\n  TypeChartStyleColor,\n  TypeChartStyleHasOnClick,\n  TypeChartStylePattern,\n} from \"../../types\";\n\ntype StyleProps = Readonly<{\n  $colors: ReadonlyArray<TypeChartStyleColor>;\n  $patterns: ReadonlyArray<TypeChartStylePattern>;\n  $hasOnClick: TypeChartStyleHasOnClick;\n  /** `area`/`areaspline` fill below the line; `line`/`spline` show only the stroke. */\n  $isArea: boolean;\n}>;\n\n// Plain styled `div` — not `Box`. Per the DS Tailwind direction, components\n// render semantic elements internally (and accept `className`) rather than\n// depending on the `Box` component. The container background — previously Box's\n// `bg` prop — is set explicitly here.\n//\n// The line/area CSS is still v1's styled-components layer (`chartStyles.ts`);\n// migrating those styles to CSS modules is a tracked clean-up follow-up.\nexport const LineAreaChartContainer = styled.div<StyleProps>`\n  background-color: ${({ theme }) => theme.colors.container.background.base};\n  ${(props) => (props.$isArea ? areaChartStyles : lineChartStyles)}\n`;\n"],"mappings":"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","names":["AREA_VARIANTS","LineAreaChart"]}

package/dist/esm/pdfExportLibs-NWLZH5KL.js

@@ -0,0 +1,10 @@
+// src/charts/shared/pdfExportLibs.ts
+import { jsPDF } from "jspdf";
+import "svg2pdf.js";
+function loadPdfExportLibs() {
+  window.jspdf = { jsPDF };
+}
+export {
+  loadPdfExportLibs
+};
+//# sourceMappingURL=pdfExportLibs-NWLZH5KL.js.map

package/dist/esm/pdfExportLibs-NWLZH5KL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/charts/shared/pdfExportLibs.ts"],"sourcesContent":["// Lazily-loaded PDF export dependencies. This module is imported via a dynamic\n// `import(\"./pdfExportLibs\")` from `chartBase` so jspdf + svg2pdf.js land in a\n// deferred chunk (tsup `splitting: true`) and are fetched only when a consumer\n// actually exports a PDF — they stay out of the main bundle.\n//\n// It is Highcharts-free (imports jspdf/svg2pdf, never \"highcharts\"), so it does\n// not touch the engine-boundary invariant.\nimport { jsPDF } from \"jspdf\";\n// Side-effect import: svg2pdf.js patches `jsPDF.API.svg`, the method Highcharts'\n// offline-exporting calls (`pdfDoc.svg(...)`) to render the chart SVG into the PDF.\nimport \"svg2pdf.js\";\n\ninterface JsPdfGlobal {\n  jspdf?: { jsPDF: typeof jsPDF };\n}\n\n/**\n * Expose jsPDF on `window.jspdf` so Highcharts' offline-exporting resolves PDF\n * support locally instead of fetching jspdf/svg2pdf from its CDN\n * (`exporting.libURL`). Highcharts checks `window.jspdf.jsPDF` and constructs\n * `new window.jspdf.jsPDF(...)`. Idempotent — safe to call before every export.\n */\nexport function loadPdfExportLibs(): void {\n  (window as unknown as JsPdfGlobal).jspdf = { jsPDF };\n}\n"],"mappings":";AAOA,SAAS,aAAa;AAGtB,OAAO;AAYA,SAAS,oBAA0B;AACxC,EAAC,OAAkC,QAAQ,EAAE,MAAM;AACrD;","names":[]}

package/dist/export/index.d.mts

@@ -0,0 +1,25 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { C as ChartExportHandle, a as ChartExportFormat } from '../chartExport-CKYpuhik.mjs';
+
+interface ChartExportMenuProps {
+    /** The opaque export handle surfaced by a v2 chart's `onReady` callback. */
+    exportHandle: ChartExportHandle;
+    /**
+     * Visible labels per format. Only formats with a non-empty label render an
+     * item; an empty object (or all-falsy labels) renders nothing — no dead
+     * trigger. Items always render in canonical order, never in key-insertion
+     * order.
+     */
+    labels: Partial<Record<ChartExportFormat, string>>;
+    /** Accessible name for the icon-only trigger button. */
+    triggerAriaLabel: string;
+}
+/**
+ * Icon-only overflow button that opens a dropdown of chart export actions
+ * (PNG/SVG/PDF/CSV) for greenfield consumers, so they don't have to wire up
+ * their own menu around the `ChartExportHandle` from `onReady`. Consumes only
+ * the opaque handle — no Highcharts type crosses this boundary.
+ */
+declare function ChartExportMenu({ exportHandle, labels, triggerAriaLabel, }: ChartExportMenuProps): react_jsx_runtime.JSX.Element | null;
+
+export { ChartExportFormat, ChartExportHandle, ChartExportMenu, type ChartExportMenuProps };

package/dist/export/index.d.ts

@@ -0,0 +1,25 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { C as ChartExportHandle, a as ChartExportFormat } from '../chartExport-CKYpuhik.js';
+
+interface ChartExportMenuProps {
+    /** The opaque export handle surfaced by a v2 chart's `onReady` callback. */
+    exportHandle: ChartExportHandle;
+    /**
+     * Visible labels per format. Only formats with a non-empty label render an
+     * item; an empty object (or all-falsy labels) renders nothing — no dead
+     * trigger. Items always render in canonical order, never in key-insertion
+     * order.
+     */
+    labels: Partial<Record<ChartExportFormat, string>>;
+    /** Accessible name for the icon-only trigger button. */
+    triggerAriaLabel: string;
+}
+/**
+ * Icon-only overflow button that opens a dropdown of chart export actions
+ * (PNG/SVG/PDF/CSV) for greenfield consumers, so they don't have to wire up
+ * their own menu around the `ChartExportHandle` from `onReady`. Consumes only
+ * the opaque handle — no Highcharts type crosses this boundary.
+ */
+declare function ChartExportMenu({ exportHandle, labels, triggerAriaLabel, }: ChartExportMenuProps): react_jsx_runtime.JSX.Element | null;
+
+export { ChartExportFormat, ChartExportHandle, ChartExportMenu, type ChartExportMenuProps };

package/dist/export/index.js

@@ -0,0 +1,41 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/export/ChartExportMenu.tsx
+var _base = require('@sproutsocial/seeds-react-menu/base');
+var _seedsreactbutton = require('@sproutsocial/seeds-react-button');
+var _seedsreacticon = require('@sproutsocial/seeds-react-icon');
+var _jsxruntime = require('react/jsx-runtime');
+var ORDER = ["png", "svg", "pdf", "csv"];
+var METHOD = {
+  png: "exportPNG",
+  svg: "exportSVG",
+  pdf: "exportPDF",
+  csv: "exportCSV"
+};
+function ChartExportMenu({
+  exportHandle,
+  labels,
+  triggerAriaLabel
+}) {
+  const formats = ORDER.filter((format) => labels[format]);
+  if (formats.length === 0) return null;
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _base.ActionMenu,
+    {
+      trigger: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _seedsreactbutton.Button, { appearance: "secondary", ariaLabel: triggerAriaLabel, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _seedsreacticon.Icon, { name: "arrow-down-to-bracket-outline", fixedWidth: true, "aria-hidden": true }) }),
+      children: formats.map((format) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        _base.MenuItem,
+        {
+          onClick: () => {
+            void exportHandle[METHOD[format]]().catch(() => {
+            });
+          },
+          children: labels[format]
+        },
+        format
+      ))
+    }
+  );
+}
+
+
+exports.ChartExportMenu = ChartExportMenu;
+//# sourceMappingURL=index.js.map

package/dist/export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/export/index.js","../../src/export/ChartExportMenu.tsx"],"names":[],"mappings":"AAAA;ACAA,2DAAqC;AACrC,oEAAuB;AACvB,gEAAqB;AAiDX,+CAAA;AA5BV,IAAM,MAAA,EAA6B,CAAC,KAAA,EAAO,KAAA,EAAO,KAAA,EAAO,KAAK,CAAA;AAG9D,IAAM,OAAA,EAA6D;AAAA,EACjE,GAAA,EAAK,WAAA;AAAA,EACL,GAAA,EAAK,WAAA;AAAA,EACL,GAAA,EAAK,WAAA;AAAA,EACL,GAAA,EAAK;AACP,CAAA;AAQO,SAAS,eAAA,CAAgB;AAAA,EAC9B,YAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,EAAyB;AACvB,EAAA,MAAM,QAAA,EAAU,KAAA,CAAM,MAAA,CAAO,CAAC,MAAA,EAAA,GAAW,MAAA,CAAO,MAAM,CAAC,CAAA;AACvD,EAAA,GAAA,CAAI,OAAA,CAAQ,OAAA,IAAW,CAAA,EAAG,OAAO,IAAA;AAEjC,EAAA,uBACE,6BAAA;AAAA,IAAC,gBAAA;AAAA,IAAA;AAAA,MACC,OAAA,kBACE,6BAAA,wBAAC,EAAA,EAAO,UAAA,EAAW,WAAA,EAAY,SAAA,EAAW,gBAAA,EACxC,QAAA,kBAAA,6BAAA,oBAAC,EAAA,EAAK,IAAA,EAAK,+BAAA,EAAgC,UAAA,EAAU,IAAA,EAAC,aAAA,EAAW,KAAA,CAAC,EAAA,CACpE,CAAA;AAAA,MAGD,QAAA,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,EAAA,mBACZ,6BAAA;AAAA,QAAC,cAAA;AAAA,QAAA;AAAA,UAEC,OAAA,EAAS,CAAA,EAAA,GAAM;AAKb,YAAA,KAAK,YAAA,CAAa,MAAA,CAAO,MAAM,CAAC,CAAA,CAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAA,GAAM;AAAA,YAAC,CAAC,CAAA;AAAA,UACpD,CAAA;AAAA,UAEC,QAAA,EAAA,MAAA,CAAO,MAAM;AAAA,QAAA,CAAA;AAAA,QATT;AAAA,MAUP,CACD;AAAA,IAAA;AAAA,EACH,CAAA;AAEJ;ADlCA;AACE;AACF,0CAAC","file":"/home/runner/_work/seeds/seeds/seeds-react/seeds-react-data-viz/dist/export/index.js","sourcesContent":[null,"import { ActionMenu, MenuItem } from \"@sproutsocial/seeds-react-menu/base\";\nimport { Button } from \"@sproutsocial/seeds-react-button\";\nimport { Icon } from \"@sproutsocial/seeds-react-icon\";\nimport type {\n  ChartExportFormat,\n  ChartExportHandle,\n} from \"../charts/shared/chartExport\";\n\nexport interface ChartExportMenuProps {\n  /** The opaque export handle surfaced by a v2 chart's `onReady` callback. */\n  exportHandle: ChartExportHandle;\n  /**\n   * Visible labels per format. Only formats with a non-empty label render an\n   * item; an empty object (or all-falsy labels) renders nothing — no dead\n   * trigger. Items always render in canonical order, never in key-insertion\n   * order.\n   */\n  labels: Partial<Record<ChartExportFormat, string>>;\n  /** Accessible name for the icon-only trigger button. */\n  triggerAriaLabel: string;\n}\n\n// Canonical render order, independent of `labels` key order.\nconst ORDER: ChartExportFormat[] = [\"png\", \"svg\", \"pdf\", \"csv\"];\n\n// Maps each format to the matching handle callable.\nconst METHOD: Record<ChartExportFormat, keyof ChartExportHandle> = {\n  png: \"exportPNG\",\n  svg: \"exportSVG\",\n  pdf: \"exportPDF\",\n  csv: \"exportCSV\",\n};\n\n/**\n * Icon-only overflow button that opens a dropdown of chart export actions\n * (PNG/SVG/PDF/CSV) for greenfield consumers, so they don't have to wire up\n * their own menu around the `ChartExportHandle` from `onReady`. Consumes only\n * the opaque handle — no Highcharts type crosses this boundary.\n */\nexport function ChartExportMenu({\n  exportHandle,\n  labels,\n  triggerAriaLabel,\n}: ChartExportMenuProps) {\n  const formats = ORDER.filter((format) => labels[format]);\n  if (formats.length === 0) return null;\n\n  return (\n    <ActionMenu\n      trigger={\n        <Button appearance=\"secondary\" ariaLabel={triggerAriaLabel}>\n          <Icon name=\"arrow-down-to-bracket-outline\" fixedWidth aria-hidden />\n        </Button>\n      }\n    >\n      {formats.map((format) => (\n        <MenuItem\n          key={format}\n          onClick={() => {\n            // The handle is fire-and-forget by design (opaque, consumer owns no\n            // UI here). Attach a no-op catch so a rejected export (e.g. a PDF\n            // dynamic-import failure) is a deliberate swallow, not an unhandled\n            // promise rejection.\n            void exportHandle[METHOD[format]]().catch(() => {});\n          }}\n        >\n          {labels[format]}\n        </MenuItem>\n      ))}\n    </ActionMenu>\n  );\n}\n"]}

package/dist/index.d.mts

@@ -1,104 +1,15 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { AxisLabelsFormatterContextObject, TimeTicksInfoObject, Chart, Annotation, TooltipFormatterContextObject, Options, SeriesSplineOptions, SeriesAreasplineOptions, SeriesColumnOptions, AxisTickPositionsArray } from 'highcharts';
+import { T as TypeChartDataPoint, a as TypeChartDataStyles, b as TypeChartTooltipDateFormatter, c as TypeChartNumberFormat, d as TypeChartTooltipProps, e as TypeChartYAxisLabelFormatter, f as TypeChartTimeFormat, g as TypeChartXAnnotations, h as TypeChartStylePattern, i as TypeVerticalBarChartProps, j as TypeSeriesType, E as ExtendedTimeTicksInfoObject, k as TypeChartStyleColor, l as TypeChartStyleHasOnClick } from './types-B7ILUQ6_.mjs';
+export { m as ExtendedAxisLabelsFormatterContextObject, n as TypeChartXAnnotationsDetails, o as TypeExtendedChart } from './types-B7ILUQ6_.mjs';
 import * as _sproutsocial_seeds_react_box from '@sproutsocial/seeds-react-box';
 import { TypeBoxProps } from '@sproutsocial/seeds-react-box';
 import { Table } from '@sproutsocial/seeds-react-table';
+import { Chart, TooltipFormatterContextObject, Options, SeriesSplineOptions, SeriesAreasplineOptions, SeriesColumnOptions, AxisTickPositionsArray, AxisLabelsFormatterContextObject } from 'highcharts';
 import { TypeIconName } from '@sproutsocial/seeds-react-icon';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as styled_components from 'styled-components';
 
-/**
- * Type of series to render. See {@link https://api.highcharts.com/highcharts/series} for detailed series configuration options.
- */
-type TypeSeriesType = "areaspline" | "spline" | "column";
-interface ExtendedTimeTicksInfoObject extends TimeTicksInfoObject {
-    unitName: "hour" | "day" | "week" | "month" | "year";
-}
-interface ExtendedAxisLabelsFormatterContextObject extends AxisLabelsFormatterContextObject {
-    tickPositionInfo: ExtendedTimeTicksInfoObject;
-}
-type TypeChartDataPoint = Readonly<{
-    x: number | string;
-    y: number | null;
-}>;
-type TypeChartDataStyles = Readonly<{
-    color?: TypeChartStyleColor;
-}>;
-type TypeChartNumberFormat = "decimal" | "percent" | "currency" | "duration";
-type TypeChartTimeFormat = "12" | "24";
-type TypeChartTooltipDateFormatter = ({ x, }: {
-    x: number | string;
-}) => ReactNode;
-type TypeChartTooltipProps = Readonly<{
-    data: ReadonlyArray<Readonly<{
-        color: TypeChartStyleColor;
-        name: string;
-        value: number | null;
-        icon?: ReactNode;
-    }>>;
-    x: number | string;
-}>;
-type TypeChartYAxisLabelFormatter = ({ y, yValues, }: Readonly<{
-    y: number;
-    yValues: ReadonlyArray<number>;
-}>) => string;
-type TypeChartXAnnotationsDetails = () => ReactNode;
-type TypeChartXAnnotations = Readonly<{
-    [x: number]: Readonly<{
-        marker: () => ReactNode;
-        details: TypeChartXAnnotationsDetails;
-    }>;
-}> | undefined;
-type TypeChartStyleColor = string;
-type TypeChartStylePattern = "solid" | "dashed";
-type TypeChartStyleHasOnClick = boolean;
-type TypeVerticalBarChartProps = Readonly<{
-    data: ReadonlyArray<Readonly<{
-        name: string;
-        points: ReadonlyArray<TypeChartDataPoint>;
-        icon?: ReactNode;
-        styles?: TypeChartDataStyles & Readonly<{
-            pattern?: TypeChartStylePattern;
-        }>;
-    }>>;
-    invalidNumberLabel: ReactNode;
-    numberLocale: Intl.LocalesArgument;
-    textLocale: Intl.LocalesArgument;
-    tooltipDateFormatter: TypeChartTooltipDateFormatter;
-    currency?: string;
-    numberFormat?: TypeChartNumberFormat;
-    /**
-     * The maximum number of series to display.
-     * @default 10
-     * @description We recommend limiting the number of series to 10 to maintain chart readability and accessibility.
-     */
-    seriesLimit?: number;
-    /**
-     * If false, disables the warning when the number of series exceeds the seriesLimit.
-     * @default true
-     */
-    showSeriesLimitWarning?: boolean;
-    tooltip?: ({ data, x }: TypeChartTooltipProps) => ReactNode;
-    yAxisLabelFormatter?: TypeChartYAxisLabelFormatter;
-    onClick?: ({ x }: Readonly<{
-        x: number;
-    }>) => void;
-    tooltipClickLabel?: ReactNode;
-    timeFormat?: TypeChartTimeFormat;
-    xAnnotations?: TypeChartXAnnotations;
-    xAxisLabelFormatter?: (params: {
-        textLocale: Intl.LocalesArgument;
-        tickPositions: number[];
-        unitName: string;
-        value: string | number;
-        timeFormat?: string;
-    }) => string;
-}>;
-interface TypeExtendedChart extends Chart {
-    annotations?: Annotation[];
-}
-
 type TypeAreaChartProps = Readonly<{
     data: ReadonlyArray<Readonly<{
         name: string;
@@ -126,6 +37,19 @@ type TypeAreaChartProps = Readonly<{
     timezone?: string;
     xAnnotations?: TypeChartXAnnotations;
 }>;
+/**
+ * @deprecated Use the v2 component instead:
+ *
+ * ```ts
+ * import { LineAreaChart } from "@sproutsocial/seeds-react-data-viz/line-area";
+ * ```
+ *
+ * `LineAreaChart` (with `variant="area"` or `"areaspline"`) is built on the shared
+ * v2 chart base — see `charts/README.md` for the architecture. The v2 prop shape
+ * differs from this legacy component and v2 does not yet cover every legacy
+ * feature (locale-aware tooltips, currency/number formatters, area totals).
+ * Migrate when ready; Claude-assisted migration guidance lands with the CE-10 codemod.
+ */
 declare const AreaChart: react.NamedExoticComponent<Readonly<{
     data: ReadonlyArray<Readonly<{
         name: string;
@@ -367,6 +291,19 @@ type TypeLineChartProps = Readonly<{
         timeFormat?: string;
     }) => string;
 }>;
+/**
+ * @deprecated Use the v2 component instead:
+ *
+ * ```ts
+ * import { LineAreaChart } from "@sproutsocial/seeds-react-data-viz/line-area";
+ * ```
+ *
+ * `LineAreaChart` (with `variant="line"` or `"spline"`) is built on the shared
+ * v2 chart base — see `charts/README.md` for the architecture. The v2 prop shape
+ * differs from this legacy component and v2 does not yet cover every legacy
+ * feature (locale-aware tooltips, currency/number formatters). Migrate when ready;
+ * Claude-assisted migration guidance lands with the CE-9 codemod.
+ */
 declare const LineChart: react.NamedExoticComponent<Readonly<{
     data: ReadonlyArray<Readonly<{
         name: string;
@@ -401,6 +338,22 @@ declare const LineChart: react.NamedExoticComponent<Readonly<{
     }) => string;
 }>>;
 
+/**
+ * @deprecated Use the v2 component instead:
+ *
+ * ```ts
+ * import { VerticalBarChart } from "@sproutsocial/seeds-react-data-viz/bar";
+ * ```
+ *
+ * The v2 component is built on the shared chart base. See `charts/README.md`
+ * for the architecture. The v2 prop shape differs from this legacy component
+ * and v2 does not yet cover every legacy feature (locale-aware tooltips,
+ * formatters, interactions, annotations, legend). Use the Claude-assisted
+ * migration skill at
+ * `seeds-tooling/seeds-codemod-cli/src/usage-patterns/VERTICALBARCHARTV1_PATTERNS.md`
+ * — it documents the prop mapping and tells you when to wait rather than
+ * force-migrate.
+ */
 declare const VerticalBarChart: react.NamedExoticComponent<Readonly<{
     data: ReadonlyArray<Readonly<{
         name: string;
@@ -488,6 +441,11 @@ declare const xAxisLabelFormatter: ({ textLocale, tickPositions, unitName, value
  * Helper to detect if data is hourly time data (all x values are hours of the same day)
  * @param data - Array of series data with points containing x values
  * @returns boolean indicating if all x values are hours of the same day
+ * @deprecated Auto-detection of hourly data is deprecated. v2 is declarative:
+ * use `xAxis={{ type: "datetime", timeFormat: "12" | "24" }}` + a top-level
+ * `timezone` instead of relying on implicit detection. See
+ * `seeds-tooling/seeds-codemod-cli/src/usage-patterns/VERTICALBARCHARTV1_PATTERNS.md`
+ * (CE-8).
  */
 declare function isHourlyTimeData(data: ReadonlyArray<Readonly<{
     points: ReadonlyArray<{
@@ -500,6 +458,11 @@ declare function isHourlyTimeData(data: ReadonlyArray<Readonly<{
  * Supports both 12-hour format ("12 AM", "1 PM") and 24-hour format ("00:00", "13:00", "23:00")
  * @param data - Array of series data with points containing x values
  * @returns boolean indicating if all x values are hour strings
+ * @deprecated Auto-detection of hourly data is deprecated. v2 is declarative:
+ * use `xAxis={{ type: "datetime", timeFormat: "12" | "24" }}` + a top-level
+ * `timezone` instead of relying on implicit detection. See
+ * `seeds-tooling/seeds-codemod-cli/src/usage-patterns/VERTICALBARCHARTV1_PATTERNS.md`
+ * (CE-8).
  */
 declare function isCategoricalHourData(data: ReadonlyArray<Readonly<{
     points: ReadonlyArray<{
@@ -570,4 +533,4 @@ declare const donutChartStyles: styled_components.FlattenInterpolation<styled_co
     $hasOnClick: TypeChartStyleHasOnClick;
 }>, any>>;
 
-export { AreaChart, ChartLegend, ChartLegendLabel, ChartTable, ChartTooltip, ChartTooltipFooter, ChartTooltipHeader, ChartTooltipPortal, ChartTooltipTable, ChartTooltipTitle, ChartXAnnotationDetails, ChartXAnnotationMarker, ColorBox, DONUT_CHART_HALO_SIZE, DONUT_CHART_HEIGHT, DONUT_CHART_WIDTH, DatavizColorBox, DonutChart, DonutChartLegendTable, type ExtendedAxisLabelsFormatterContextObject, type ExtendedTimeTicksInfoObject, GlobalChartStyleOverrides, LineChart, NetworkColorBox, TIME_SERIES_CHART_HEIGHT, type TypeAreaChartProps, type TypeChartDataPoint, type TypeChartDataStyles, type TypeChartLegendLabelProps, type TypeChartLegendProps, type TypeChartNumberFormat, type TypeChartStyleColor, type TypeChartStyleHasOnClick, type TypeChartStylePattern, type TypeChartTableProps, type TypeChartTimeFormat, type TypeChartTooltipDateFormatter, type TypeChartTooltipProps, type TypeChartTooltipTableProps, type TypeChartXAnnotations, type TypeChartXAnnotationsDetails, type TypeChartYAxisLabelFormatter, type TypeColorBoxProps, type TypeDatavizColorBox, type TypeDatavizColorBoxProps, type TypeDonutChartDataItem, type TypeDonutChartLegendTableProps, type TypeDonutChartProps, type TypeDonutChartTooltipProps, type TypeExtendedChart, type TypeLegendLabel, type TypeLineChartProps, type TypeSeriesType, type TypeVerticalBarChartProps, VERTICAL_BAR_CHART_DEFAULT_SERIES_LIMIT, VerticalBarChart, areaChartOptions, areaChartStyles, baseChartOptions, baseChartStyles, columnChartOptions, donutChartOptions, donutChartStyles, generateChartTooltipPortalId, getDatavizColor, getDatavizColorWithAlpha, getDatavizOpacity, getStorybookCategoricalData, getStorybookSparseTimelineData, isCategoricalHourData, isHourlyTimeData, lineChartOptions, lineChartStyles, timeSeriesChartOptions, timeSeriesChartStyles, transformDataToSeries, transformTimeSeriesTooltipData, xAxisLabelFormatter, yAxisLabelFormatter };
+export { AreaChart, ChartLegend, ChartLegendLabel, ChartTable, ChartTooltip, ChartTooltipFooter, ChartTooltipHeader, ChartTooltipPortal, ChartTooltipTable, ChartTooltipTitle, ChartXAnnotationDetails, ChartXAnnotationMarker, ColorBox, DONUT_CHART_HALO_SIZE, DONUT_CHART_HEIGHT, DONUT_CHART_WIDTH, DatavizColorBox, DonutChart, DonutChartLegendTable, ExtendedTimeTicksInfoObject, GlobalChartStyleOverrides, LineChart, NetworkColorBox, TIME_SERIES_CHART_HEIGHT, type TypeAreaChartProps, TypeChartDataPoint, TypeChartDataStyles, type TypeChartLegendLabelProps, type TypeChartLegendProps, TypeChartNumberFormat, TypeChartStyleColor, TypeChartStyleHasOnClick, TypeChartStylePattern, type TypeChartTableProps, TypeChartTimeFormat, TypeChartTooltipDateFormatter, TypeChartTooltipProps, type TypeChartTooltipTableProps, TypeChartXAnnotations, TypeChartYAxisLabelFormatter, type TypeColorBoxProps, type TypeDatavizColorBox, type TypeDatavizColorBoxProps, type TypeDonutChartDataItem, type TypeDonutChartLegendTableProps, type TypeDonutChartProps, type TypeDonutChartTooltipProps, type TypeLegendLabel, type TypeLineChartProps, TypeSeriesType, TypeVerticalBarChartProps, VERTICAL_BAR_CHART_DEFAULT_SERIES_LIMIT, VerticalBarChart, areaChartOptions, areaChartStyles, baseChartOptions, baseChartStyles, columnChartOptions, donutChartOptions, donutChartStyles, generateChartTooltipPortalId, getDatavizColor, getDatavizColorWithAlpha, getDatavizOpacity, getStorybookCategoricalData, getStorybookSparseTimelineData, isCategoricalHourData, isHourlyTimeData, lineChartOptions, lineChartStyles, timeSeriesChartOptions, timeSeriesChartStyles, transformDataToSeries, transformTimeSeriesTooltipData, xAxisLabelFormatter, yAxisLabelFormatter };