@sproutsocial/seeds-react-data-viz 0.7.31 → 0.14.0

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;
@@ -401,6 +312,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 +415,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 +432,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 +507,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 };

package/dist/index.d.ts

@@ -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_.js';
+export { m as ExtendedAxisLabelsFormatterContextObject, n as TypeChartXAnnotationsDetails, o as TypeExtendedChart } from './types-B7ILUQ6_.js';
 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;
@@ -401,6 +312,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 +415,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 +432,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 +507,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 };