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

package/dist/axis-DXzufRRj.d.mts

@@ -0,0 +1,116 @@
+import { ReactNode } from 'react';
+import { TypeIconName } from '@sproutsocial/seeds-react-icon';
+import { c as TypeChartNumberFormat, k as TypeChartStyleColor } from './types-B7ILUQ6_.mjs';
+
+type TypeValuePercentInput = "decimal" | "whole";
+type TypeValueFormatterOptions = Readonly<{
+    /** The raw numeric value. For duration, milliseconds. */
+    value: number;
+    /** default "decimal" */
+    numberFormat?: TypeChartNumberFormat;
+    /** Only used when numberFormat === "currency". default "USD" */
+    currency?: string;
+    /** true → 10k threshold; number → max(1000, abs(n)); false → never. default true */
+    abbreviate?: boolean | number;
+    /** "decimal" scales 0.42 → "42%"; "whole" treats 42 → "42%". default "decimal" */
+    percentInput?: TypeValuePercentInput;
+    /** locale for decimal/currency/percent (formatNumeral) */
+    numberLocale?: Intl.LocalesArgument;
+    /** locale for duration (formatDuration) */
+    textLocale?: Intl.LocalesArgument;
+}>;
+/**
+ * Declarative value-format config for axis ticks and the default tooltip — the
+ * full {@link TypeValueFormatterOptions} surface minus `value`, which is
+ * supplied per-tick / per-row by the caller (the adapter and tooltip).
+ */
+type ValueFormat = Omit<TypeValueFormatterOptions, "value">;
+
+interface ChartTooltipDataRow {
+    color: TypeChartStyleColor;
+    name: string;
+    value: number | null;
+}
+/** Tooltip render-prop signature for v2 charts. */
+interface ChartTooltipProps {
+    data: ChartTooltipDataRow[];
+    /** Resolved x-axis position. Category name for category axes, numeric for time/linear. */
+    position: number | string;
+    /** Resolved chart timezone — pass to date formatters when `position` is a numeric timestamp. Undefined on category axes. */
+    timezone?: string;
+    /** Declarative annotation anchored at this position, if any. Rendered in the tooltip header. */
+    annotation?: {
+        icon?: TypeIconName;
+        color?: string;
+        title?: string;
+        description?: string;
+    };
+    /** True when the chart has an `onClick` handler — used by the default tooltip to render the click-label footer. */
+    hasOnClick?: boolean;
+    /** Footer content shown in the default tooltip when the chart is clickable. */
+    tooltipClickLabel?: ReactNode;
+    /** Content shown in place of a row's value when the value is null. Defaults to an em-dash. */
+    invalidNumberLabel?: ReactNode;
+    /** Declarative value format for the tooltip value cell. Omit for raw rendering. Applied at full precision (abbreviation off). */
+    valueFormat?: ValueFormat;
+}
+
+/**
+ * Declarative annotation shape — the DS renders the marker and tooltip header
+ * internally; consumers don't supply render functions. See CE-7.
+ */
+interface ChartAnnotation {
+    /** Numeric x-axis coordinate — a category index (category axes) or the raw coordinate (datetime/linear axes). */
+    position: number;
+    /** Icon shown above the chart at `position` and inline with `title` in the tooltip header. */
+    icon?: TypeIconName;
+    /** Color applied to the marker's vertical line. */
+    color?: string;
+    /** Tooltip header line 1. */
+    title?: string;
+    /** Tooltip header line 2. */
+    description?: string;
+}
+
+/**
+ * Pure, Highcharts-free datetime axis label formatter for v2 chart families.
+ *
+ * Ports v1's `helpers/xAxisLabelFormatter` into a rendering-agnostic shape: it
+ * returns a `{ primary, secondary? }` object instead of an HTML string, leaving
+ * SVG rendering to the caller. The timezone- and DST-correct boundary detection
+ * (calendar parts read in the target timezone) and the per-granularity
+ * `Intl.DateTimeFormat` option sets are a near-verbatim port of v1.
+ *
+ * The one net-new piece versus v1 is granularity derivation: v1 receives
+ * `unitName` from Highcharts, but `charts/` may not depend on Highcharts types
+ * (see `charts/README.md` invariants), so granularity is derived from the
+ * spacing of `tickPositions`.
+ */
+type DatetimeTimeFormat = "12" | "24";
+
+/** A datetime data point: `[msSinceEpoch, value]` tuple or `{ x, y }` object. */
+type DatetimePoint = [number, number | null] | {
+    x: number;
+    y: number | null;
+};
+/** A value on a category axis, or a datetime point when the axis is `"datetime"`. */
+type ChartDataPoint = number | null | DatetimePoint;
+/** Category axis — labels indexed parallel to `series.data`. The default axis type. */
+interface CategoryAxis {
+    type?: "category";
+    /** Category labels, indexed parallel to `series.data`. */
+    categories: Array<string>;
+    crosshair?: boolean;
+}
+/** Datetime axis — `series.data` carries timestamped points. */
+interface DatetimeAxis {
+    type: "datetime";
+    crosshair?: boolean;
+    /**
+     * 12- or 24-hour clock for hour-granularity tick labels (e.g. `9 AM` vs
+     * `09:00`). Default `"12"`. Coarser granularities (day/month/year) ignore it.
+     */
+    timeFormat?: DatetimeTimeFormat;
+}
+
+export type { ChartDataPoint as C, DatetimeAxis as D, ValueFormat as V, CategoryAxis as a, ChartTooltipProps as b, ChartAnnotation as c, DatetimePoint as d };

package/dist/axis-PJwu5Xmo.d.ts

@@ -0,0 +1,116 @@
+import { ReactNode } from 'react';
+import { TypeIconName } from '@sproutsocial/seeds-react-icon';
+import { c as TypeChartNumberFormat, k as TypeChartStyleColor } from './types-B7ILUQ6_.js';
+
+type TypeValuePercentInput = "decimal" | "whole";
+type TypeValueFormatterOptions = Readonly<{
+    /** The raw numeric value. For duration, milliseconds. */
+    value: number;
+    /** default "decimal" */
+    numberFormat?: TypeChartNumberFormat;
+    /** Only used when numberFormat === "currency". default "USD" */
+    currency?: string;
+    /** true → 10k threshold; number → max(1000, abs(n)); false → never. default true */
+    abbreviate?: boolean | number;
+    /** "decimal" scales 0.42 → "42%"; "whole" treats 42 → "42%". default "decimal" */
+    percentInput?: TypeValuePercentInput;
+    /** locale for decimal/currency/percent (formatNumeral) */
+    numberLocale?: Intl.LocalesArgument;
+    /** locale for duration (formatDuration) */
+    textLocale?: Intl.LocalesArgument;
+}>;
+/**
+ * Declarative value-format config for axis ticks and the default tooltip — the
+ * full {@link TypeValueFormatterOptions} surface minus `value`, which is
+ * supplied per-tick / per-row by the caller (the adapter and tooltip).
+ */
+type ValueFormat = Omit<TypeValueFormatterOptions, "value">;
+
+interface ChartTooltipDataRow {
+    color: TypeChartStyleColor;
+    name: string;
+    value: number | null;
+}
+/** Tooltip render-prop signature for v2 charts. */
+interface ChartTooltipProps {
+    data: ChartTooltipDataRow[];
+    /** Resolved x-axis position. Category name for category axes, numeric for time/linear. */
+    position: number | string;
+    /** Resolved chart timezone — pass to date formatters when `position` is a numeric timestamp. Undefined on category axes. */
+    timezone?: string;
+    /** Declarative annotation anchored at this position, if any. Rendered in the tooltip header. */
+    annotation?: {
+        icon?: TypeIconName;
+        color?: string;
+        title?: string;
+        description?: string;
+    };
+    /** True when the chart has an `onClick` handler — used by the default tooltip to render the click-label footer. */
+    hasOnClick?: boolean;
+    /** Footer content shown in the default tooltip when the chart is clickable. */
+    tooltipClickLabel?: ReactNode;
+    /** Content shown in place of a row's value when the value is null. Defaults to an em-dash. */
+    invalidNumberLabel?: ReactNode;
+    /** Declarative value format for the tooltip value cell. Omit for raw rendering. Applied at full precision (abbreviation off). */
+    valueFormat?: ValueFormat;
+}
+
+/**
+ * Declarative annotation shape — the DS renders the marker and tooltip header
+ * internally; consumers don't supply render functions. See CE-7.
+ */
+interface ChartAnnotation {
+    /** Numeric x-axis coordinate — a category index (category axes) or the raw coordinate (datetime/linear axes). */
+    position: number;
+    /** Icon shown above the chart at `position` and inline with `title` in the tooltip header. */
+    icon?: TypeIconName;
+    /** Color applied to the marker's vertical line. */
+    color?: string;
+    /** Tooltip header line 1. */
+    title?: string;
+    /** Tooltip header line 2. */
+    description?: string;
+}
+
+/**
+ * Pure, Highcharts-free datetime axis label formatter for v2 chart families.
+ *
+ * Ports v1's `helpers/xAxisLabelFormatter` into a rendering-agnostic shape: it
+ * returns a `{ primary, secondary? }` object instead of an HTML string, leaving
+ * SVG rendering to the caller. The timezone- and DST-correct boundary detection
+ * (calendar parts read in the target timezone) and the per-granularity
+ * `Intl.DateTimeFormat` option sets are a near-verbatim port of v1.
+ *
+ * The one net-new piece versus v1 is granularity derivation: v1 receives
+ * `unitName` from Highcharts, but `charts/` may not depend on Highcharts types
+ * (see `charts/README.md` invariants), so granularity is derived from the
+ * spacing of `tickPositions`.
+ */
+type DatetimeTimeFormat = "12" | "24";
+
+/** A datetime data point: `[msSinceEpoch, value]` tuple or `{ x, y }` object. */
+type DatetimePoint = [number, number | null] | {
+    x: number;
+    y: number | null;
+};
+/** A value on a category axis, or a datetime point when the axis is `"datetime"`. */
+type ChartDataPoint = number | null | DatetimePoint;
+/** Category axis — labels indexed parallel to `series.data`. The default axis type. */
+interface CategoryAxis {
+    type?: "category";
+    /** Category labels, indexed parallel to `series.data`. */
+    categories: Array<string>;
+    crosshair?: boolean;
+}
+/** Datetime axis — `series.data` carries timestamped points. */
+interface DatetimeAxis {
+    type: "datetime";
+    crosshair?: boolean;
+    /**
+     * 12- or 24-hour clock for hour-granularity tick labels (e.g. `9 AM` vs
+     * `09:00`). Default `"12"`. Coarser granularities (day/month/year) ignore it.
+     */
+    timeFormat?: DatetimeTimeFormat;
+}
+
+export type { ChartDataPoint as C, DatetimeAxis as D, ValueFormat as V, CategoryAxis as a, ChartTooltipProps as b, ChartAnnotation as c, DatetimePoint as d };

package/dist/bar/index.d.mts

@@ -1,121 +1,11 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { TypeIconName } from '@sproutsocial/seeds-react-icon';
-import { c as TypeChartNumberFormat, k as TypeChartStyleColor } from '../types-B7ILUQ6_.mjs';
+import { C as ChartDataPoint, a as CategoryAxis, D as DatetimeAxis, V as ValueFormat, b as ChartTooltipProps, c as ChartAnnotation, d as DatetimePoint } from '../axis-DXzufRRj.mjs';
 import { C as ChartExportHandle } from '../chartExport-CKYpuhik.mjs';
+import '../types-B7ILUQ6_.mjs';
 import 'highcharts';
 
-type TypeValuePercentInput = "decimal" | "whole";
-type TypeValueFormatterOptions = Readonly<{
-    /** The raw numeric value. For duration, milliseconds. */
-    value: number;
-    /** default "decimal" */
-    numberFormat?: TypeChartNumberFormat;
-    /** Only used when numberFormat === "currency". default "USD" */
-    currency?: string;
-    /** true → 10k threshold; number → max(1000, abs(n)); false → never. default true */
-    abbreviate?: boolean | number;
-    /** "decimal" scales 0.42 → "42%"; "whole" treats 42 → "42%". default "decimal" */
-    percentInput?: TypeValuePercentInput;
-    /** locale for decimal/currency/percent (formatNumeral) */
-    numberLocale?: Intl.LocalesArgument;
-    /** locale for duration (formatDuration) */
-    textLocale?: Intl.LocalesArgument;
-}>;
-/**
- * Declarative value-format config for axis ticks and the default tooltip — the
- * full {@link TypeValueFormatterOptions} surface minus `value`, which is
- * supplied per-tick / per-row by the caller (the adapter and tooltip).
- */
-type ValueFormat = Omit<TypeValueFormatterOptions, "value">;
-
-interface ChartTooltipDataRow {
-    color: TypeChartStyleColor;
-    name: string;
-    value: number | null;
-}
-/** Tooltip render-prop signature for v2 charts. */
-interface ChartTooltipProps {
-    data: ChartTooltipDataRow[];
-    /** Resolved x-axis position. Category name for category axes, numeric for time/linear. */
-    position: number | string;
-    /** Resolved chart timezone — pass to date formatters when `position` is a numeric timestamp. Undefined on category axes. */
-    timezone?: string;
-    /** Declarative annotation anchored at this position, if any. Rendered in the tooltip header. */
-    annotation?: {
-        icon?: TypeIconName;
-        color?: string;
-        title?: string;
-        description?: string;
-    };
-    /** True when the chart has an `onClick` handler — used by the default tooltip to render the click-label footer. */
-    hasOnClick?: boolean;
-    /** Footer content shown in the default tooltip when the chart is clickable. */
-    tooltipClickLabel?: ReactNode;
-    /** Content shown in place of a row's value when the value is null. Defaults to an em-dash. */
-    invalidNumberLabel?: ReactNode;
-    /** Declarative value format for the tooltip value cell. Omit for raw rendering. Applied at full precision (abbreviation off). */
-    valueFormat?: ValueFormat;
-}
-
-/**
- * Declarative annotation shape — the DS renders the marker and tooltip header
- * internally; consumers don't supply render functions. See CE-7.
- */
-interface ChartAnnotation {
-    /** Numeric x-axis coordinate — a category index (category axes) or the raw coordinate (datetime/linear axes). */
-    position: number;
-    /** Icon shown above the chart at `position` and inline with `title` in the tooltip header. */
-    icon?: TypeIconName;
-    /** Color applied to the marker's vertical line. */
-    color?: string;
-    /** Tooltip header line 1. */
-    title?: string;
-    /** Tooltip header line 2. */
-    description?: string;
-}
-
-/**
- * Pure, Highcharts-free datetime axis label formatter for v2 chart families.
- *
- * Ports v1's `helpers/xAxisLabelFormatter` into a rendering-agnostic shape: it
- * returns a `{ primary, secondary? }` object instead of an HTML string, leaving
- * SVG rendering to the caller. The timezone- and DST-correct boundary detection
- * (calendar parts read in the target timezone) and the per-granularity
- * `Intl.DateTimeFormat` option sets are a near-verbatim port of v1.
- *
- * The one net-new piece versus v1 is granularity derivation: v1 receives
- * `unitName` from Highcharts, but `charts/` may not depend on Highcharts types
- * (see `charts/README.md` invariants), so granularity is derived from the
- * spacing of `tickPositions`.
- */
-type DatetimeTimeFormat = "12" | "24";
-
-/** A datetime data point: `[msSinceEpoch, value]` tuple or `{ x, y }` object. */
-type DatetimePoint = [number, number | null] | {
-    x: number;
-    y: number | null;
-};
-/** A value on a category axis, or a datetime point when the axis is `"datetime"`. */
-type ChartDataPoint = number | null | DatetimePoint;
-/** Category axis — labels indexed parallel to `series.data`. The default axis type. */
-interface CategoryAxis {
-    type?: "category";
-    /** Category labels, indexed parallel to `series.data`. */
-    categories: Array<string>;
-    crosshair?: boolean;
-}
-/** Datetime axis — `series.data` carries timestamped points. */
-interface DatetimeAxis {
-    type: "datetime";
-    crosshair?: boolean;
-    /**
-     * 12- or 24-hour clock for hour-granularity tick labels (e.g. `9 AM` vs
-     * `09:00`). Default `"12"`. Coarser granularities (day/month/year) ignore it.
-     */
-    timeFormat?: DatetimeTimeFormat;
-}
-
 /** A datetime data point: `[msSinceEpoch, value]` tuple or `{ x, y }` object. */
 type BarDatetimePoint = DatetimePoint;
 /** A category y-value, or a datetime point when the dimensional axis is `"datetime"`. */
@@ -205,4 +95,4 @@ interface BarChartProps {
 
 declare const VerticalBarChart: react.NamedExoticComponent<BarChartProps>;
 
-export { type BarChartDirection, type BarChartProps, type BarDataPoint, type BarDatetimePoint, type BarSeries, type BarXAxis, type BarYAxis, type CategoryAxis, ChartExportHandle, type DatetimeAxis, type ValueFormat, VerticalBarChart };
+export { type BarChartDirection, type BarChartProps, type BarDataPoint, type BarDatetimePoint, type BarSeries, type BarXAxis, type BarYAxis, CategoryAxis, ChartExportHandle, DatetimeAxis, ValueFormat, VerticalBarChart };

package/dist/bar/index.d.ts

@@ -1,121 +1,11 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { TypeIconName } from '@sproutsocial/seeds-react-icon';
-import { c as TypeChartNumberFormat, k as TypeChartStyleColor } from '../types-B7ILUQ6_.js';
+import { C as ChartDataPoint, a as CategoryAxis, D as DatetimeAxis, V as ValueFormat, b as ChartTooltipProps, c as ChartAnnotation, d as DatetimePoint } from '../axis-PJwu5Xmo.js';
 import { C as ChartExportHandle } from '../chartExport-CKYpuhik.js';
+import '../types-B7ILUQ6_.js';
 import 'highcharts';
 
-type TypeValuePercentInput = "decimal" | "whole";
-type TypeValueFormatterOptions = Readonly<{
-    /** The raw numeric value. For duration, milliseconds. */
-    value: number;
-    /** default "decimal" */
-    numberFormat?: TypeChartNumberFormat;
-    /** Only used when numberFormat === "currency". default "USD" */
-    currency?: string;
-    /** true → 10k threshold; number → max(1000, abs(n)); false → never. default true */
-    abbreviate?: boolean | number;
-    /** "decimal" scales 0.42 → "42%"; "whole" treats 42 → "42%". default "decimal" */
-    percentInput?: TypeValuePercentInput;
-    /** locale for decimal/currency/percent (formatNumeral) */
-    numberLocale?: Intl.LocalesArgument;
-    /** locale for duration (formatDuration) */
-    textLocale?: Intl.LocalesArgument;
-}>;
-/**
- * Declarative value-format config for axis ticks and the default tooltip — the
- * full {@link TypeValueFormatterOptions} surface minus `value`, which is
- * supplied per-tick / per-row by the caller (the adapter and tooltip).
- */
-type ValueFormat = Omit<TypeValueFormatterOptions, "value">;
-
-interface ChartTooltipDataRow {
-    color: TypeChartStyleColor;
-    name: string;
-    value: number | null;
-}
-/** Tooltip render-prop signature for v2 charts. */
-interface ChartTooltipProps {
-    data: ChartTooltipDataRow[];
-    /** Resolved x-axis position. Category name for category axes, numeric for time/linear. */
-    position: number | string;
-    /** Resolved chart timezone — pass to date formatters when `position` is a numeric timestamp. Undefined on category axes. */
-    timezone?: string;
-    /** Declarative annotation anchored at this position, if any. Rendered in the tooltip header. */
-    annotation?: {
-        icon?: TypeIconName;
-        color?: string;
-        title?: string;
-        description?: string;
-    };
-    /** True when the chart has an `onClick` handler — used by the default tooltip to render the click-label footer. */
-    hasOnClick?: boolean;
-    /** Footer content shown in the default tooltip when the chart is clickable. */
-    tooltipClickLabel?: ReactNode;
-    /** Content shown in place of a row's value when the value is null. Defaults to an em-dash. */
-    invalidNumberLabel?: ReactNode;
-    /** Declarative value format for the tooltip value cell. Omit for raw rendering. Applied at full precision (abbreviation off). */
-    valueFormat?: ValueFormat;
-}
-
-/**
- * Declarative annotation shape — the DS renders the marker and tooltip header
- * internally; consumers don't supply render functions. See CE-7.
- */
-interface ChartAnnotation {
-    /** Numeric x-axis coordinate — a category index (category axes) or the raw coordinate (datetime/linear axes). */
-    position: number;
-    /** Icon shown above the chart at `position` and inline with `title` in the tooltip header. */
-    icon?: TypeIconName;
-    /** Color applied to the marker's vertical line. */
-    color?: string;
-    /** Tooltip header line 1. */
-    title?: string;
-    /** Tooltip header line 2. */
-    description?: string;
-}
-
-/**
- * Pure, Highcharts-free datetime axis label formatter for v2 chart families.
- *
- * Ports v1's `helpers/xAxisLabelFormatter` into a rendering-agnostic shape: it
- * returns a `{ primary, secondary? }` object instead of an HTML string, leaving
- * SVG rendering to the caller. The timezone- and DST-correct boundary detection
- * (calendar parts read in the target timezone) and the per-granularity
- * `Intl.DateTimeFormat` option sets are a near-verbatim port of v1.
- *
- * The one net-new piece versus v1 is granularity derivation: v1 receives
- * `unitName` from Highcharts, but `charts/` may not depend on Highcharts types
- * (see `charts/README.md` invariants), so granularity is derived from the
- * spacing of `tickPositions`.
- */
-type DatetimeTimeFormat = "12" | "24";
-
-/** A datetime data point: `[msSinceEpoch, value]` tuple or `{ x, y }` object. */
-type DatetimePoint = [number, number | null] | {
-    x: number;
-    y: number | null;
-};
-/** A value on a category axis, or a datetime point when the axis is `"datetime"`. */
-type ChartDataPoint = number | null | DatetimePoint;
-/** Category axis — labels indexed parallel to `series.data`. The default axis type. */
-interface CategoryAxis {
-    type?: "category";
-    /** Category labels, indexed parallel to `series.data`. */
-    categories: Array<string>;
-    crosshair?: boolean;
-}
-/** Datetime axis — `series.data` carries timestamped points. */
-interface DatetimeAxis {
-    type: "datetime";
-    crosshair?: boolean;
-    /**
-     * 12- or 24-hour clock for hour-granularity tick labels (e.g. `9 AM` vs
-     * `09:00`). Default `"12"`. Coarser granularities (day/month/year) ignore it.
-     */
-    timeFormat?: DatetimeTimeFormat;
-}
-
 /** A datetime data point: `[msSinceEpoch, value]` tuple or `{ x, y }` object. */
 type BarDatetimePoint = DatetimePoint;
 /** A category y-value, or a datetime point when the dimensional axis is `"datetime"`. */
@@ -205,4 +95,4 @@ interface BarChartProps {
 
 declare const VerticalBarChart: react.NamedExoticComponent<BarChartProps>;
 
-export { type BarChartDirection, type BarChartProps, type BarDataPoint, type BarDatetimePoint, type BarSeries, type BarXAxis, type BarYAxis, type CategoryAxis, ChartExportHandle, type DatetimeAxis, type ValueFormat, VerticalBarChart };
+export { type BarChartDirection, type BarChartProps, type BarDataPoint, type BarDatetimePoint, type BarSeries, type BarXAxis, type BarYAxis, CategoryAxis, ChartExportHandle, DatetimeAxis, ValueFormat, VerticalBarChart };