@automattic/charts 1.9.0 → 1.10.1

package/dist/index.css

@@ -79,7 +79,7 @@
 .a8ccharts-udGPVq-svg-empty-state {
   text-align: center;
   font-size: var(--wpds-typography-font-size-md, 13px);
-  color: var(--wpds-color-fg-content-neutral-weak, #707070);
+  color: var(--wpds-color-foreground-content-neutral-weak, #707070);
 }
 .a8ccharts-sP1gHa-container {
   min-width: 0;
@@ -99,7 +99,7 @@
   background: var(--charts-zoom-reset-bg, #ffffffeb);
   width: 28px;
   height: 28px;
-  color: var(--charts-zoom-reset-fg, var(--wpds-color-fg-content-neutral, #1e1e1e));
+  color: var(--charts-zoom-reset-fg, var(--wpds-color-foreground-content-neutral, #1e1e1e));
   border: var(--wpds-border-width-xs, 1px) solid var(--charts-zoom-reset-border, #00000029);
   border-radius: var(--wpds-border-radius-md, 4px);
   cursor: pointer;
@@ -116,7 +116,7 @@
 }
 
 .a8ccharts-y6bXNq-x-zoom__reset:focus-visible {
-  outline: 2px solid var(--charts-zoom-reset-focus, var(--wpds-color-stroke-focus-brand, #3858e9));
+  outline: 2px solid var(--charts-zoom-reset-focus, var(--wpds-color-stroke-focus, #3858e9));
   outline-offset: 1px;
 }
 
@@ -140,8 +140,8 @@
 }
 
 .a8ccharts-inuQka-line-chart__tooltip, .a8ccharts-inuQka-line-chart__annotation-label-popover {
-  background: var(--wpds-color-bg-surface-neutral-strong, #fff);
-  color: var(--wpds-color-fg-content-neutral, #1e1e1e);
+  background: var(--wpds-color-background-surface-neutral-strong, #fff);
+  color: var(--wpds-color-foreground-content-neutral, #1e1e1e);
   padding: var(--wpds-dimension-padding-sm, 8px);
 }
 
@@ -286,7 +286,7 @@
 }
 
 .a8ccharts-mGEVca-main-rate {
-  color: var(--wpds-color-fg-content-neutral, #1e1e1e);
+  color: var(--wpds-color-foreground-content-neutral, #1e1e1e);
   text-overflow: ellipsis;
   font-size: var(--wpds-typography-font-size-xl, 18px);
   font-style: normal;
@@ -327,7 +327,7 @@
 }
 
 .a8ccharts-mGEVca-step-label {
-  color: var(--wpds-color-fg-content-neutral-weak, #707070);
+  color: var(--wpds-color-foreground-content-neutral-weak, #707070);
   font-size: var(--wpds-typography-font-size-sm, 12px);
   font-weight: var(--wpds-typography-font-weight-regular, 400);
   line-height: var(--wpds-typography-line-height-xs, 16px);
@@ -337,7 +337,7 @@
 }
 
 .a8ccharts-mGEVca-step-rate {
-  color: var(--wpds-color-fg-content-neutral, #1e1e1e);
+  color: var(--wpds-color-foreground-content-neutral, #1e1e1e);
   font-size: var(--wpds-typography-font-size-md, 13px);
   font-weight: var(--wpds-typography-font-weight-medium, 499);
   line-height: var(--wpds-typography-line-height-xs, 16px);
@@ -370,14 +370,14 @@
 }
 
 .a8ccharts-mGEVca-tooltip-wrapper {
-  background: var(--wpds-color-bg-surface-neutral-strong, #fff);
+  background: var(--wpds-color-background-surface-neutral-strong, #fff);
   border-radius: var(--wpds-border-radius-md, 4px) !important;
   padding: var(--wpds-dimension-padding-md, 12px) !important;
   box-shadow: var(--wpds-elevation-sm, 0 1px 2px 0 #0000000d, 0 2px 3px 0 #0000000a, 0 6px 6px 0 #00000008, 0 8px 8px 0 #00000005) !important;
 }
 
 .a8ccharts-mGEVca-tooltip-title {
-  color: var(--wpds-color-fg-content-neutral, #1e1e1e);
+  color: var(--wpds-color-foreground-content-neutral, #1e1e1e);
   font-size: var(--wpds-typography-font-size-sm, 12px);
   font-style: normal;
   font-weight: var(--wpds-typography-font-weight-regular, 400);
@@ -385,7 +385,7 @@
 }
 
 .a8ccharts-mGEVca-tooltip-content {
-  color: var(--wpds-color-fg-content-neutral, #1e1e1e);
+  color: var(--wpds-color-foreground-content-neutral, #1e1e1e);
   font-size: var(--wpds-typography-font-size-md, 13px);
   font-style: normal;
   font-weight: var(--wpds-typography-font-weight-medium, 499);
@@ -394,7 +394,7 @@
 
 .a8ccharts-mGEVca-empty-state {
   text-align: center;
-  color: var(--wpds-color-fg-content-neutral-weak, #707070);
+  color: var(--wpds-color-foreground-content-neutral-weak, #707070);
   font-size: var(--wpds-typography-font-size-lg, 16px);
 }
 .a8ccharts-8hS2IW-container {
@@ -409,19 +409,19 @@
 
 .a8ccharts-O3YMOW-heatmap-chart__empty {
   padding: var(--wpds-dimension-padding-lg, 16px);
-  color: var(--wpds-color-fg-content-neutral-weak, #707070);
+  color: var(--wpds-color-foreground-content-neutral-weak, #707070);
 }
 
 .a8ccharts-O3YMOW-heatmap-chart__grid {
   gap: var(--heatmap-cell-gap, var(--wpds-dimension-gap-xs, 4px));
   flex: 1 1 0;
   width: 100%;
-  min-height: 200px;
+  min-height: 0;
   display: grid;
 }
 
 .a8ccharts-O3YMOW-heatmap-chart__grid:focus-visible {
-  outline: var(--wpds-border-width-focus, var(--wp-admin-border-width-focus, 2px)) solid var(--wpds-color-stroke-focus-brand, var(--wp-admin-theme-color, #3858e9));
+  outline: var(--wpds-border-width-focus, var(--wp-admin-border-width-focus, 2px)) solid var(--wpds-color-stroke-focus, var(--wp-admin-theme-color, #3858e9));
   outline-offset: 2px;
   border-radius: var(--wpds-border-radius-sm, 2px);
 }
@@ -438,7 +438,7 @@
 }
 
 .a8ccharts-O3YMOW-heatmap-chart__col-label, .a8ccharts-O3YMOW-heatmap-chart__row-label {
-  color: var(--wpds-color-fg-content-neutral-weak, #707070);
+  color: var(--wpds-color-foreground-content-neutral-weak, #707070);
   font-size: var(--wpds-typography-font-size-xs, 11px);
   white-space: nowrap;
   overflow: visible;
@@ -457,7 +457,7 @@
 
 .a8ccharts-O3YMOW-heatmap-chart__cell {
   border-radius: var(--wpds-border-radius-sm, 2px);
-  background: var(--wpds-color-bg-track-neutral-weak, #f0f0f0);
+  background: var(--wpds-color-background-track-neutral-weak, #f0f0f0);
   justify-content: center;
   align-items: center;
   min-width: 0;
@@ -466,28 +466,28 @@
 }
 
 .a8ccharts-O3YMOW-heatmap-chart__cell--filled {
-  background: color-mix(in sRGB, var(--heatmap-primary) calc((.15 + .85 * var(--intensity)) * 100%), transparent);
+  background: color-mix(in sRGB, var(--heatmap-primary) calc((.15 + .85 * var(--intensity)) * 100%), var(--heatmap-bg, #fff));
 }
 
 .a8ccharts-O3YMOW-heatmap-chart__cell--selected {
-  outline: var(--wpds-border-width-focus, var(--wp-admin-border-width-focus, 2px)) solid var(--wpds-color-stroke-focus-brand, var(--wp-admin-theme-color, #3858e9));
+  outline: var(--wpds-border-width-focus, var(--wp-admin-border-width-focus, 2px)) solid var(--wpds-color-stroke-focus, var(--wp-admin-theme-color, #3858e9));
   outline-offset: calc(-1 * var(--wpds-border-width-focus, var(--wp-admin-border-width-focus, 2px)));
 }
 
 .a8ccharts-O3YMOW-heatmap-chart__cell-value {
-  color: var(--wpds-color-fg-content-neutral, #1e1e1e);
+  color: var(--wpds-color-foreground-content-neutral, #1e1e1e);
   font-size: var(--wpds-typography-font-size-md, 13px);
 }
 
 .a8ccharts-O3YMOW-heatmap-chart__cell--strong .a8ccharts-O3YMOW-heatmap-chart__cell-value {
-  color: var(--wpds-color-fg-interactive-neutral-strong, #f0f0f0);
+  color: var(--wpds-color-foreground-interactive-neutral-strong, #f0f0f0);
 }
 
 .a8ccharts-O3YMOW-heatmap-chart__legend-swatch {
   width: var(--wpds-dimension-size-3xs, 12px);
   height: var(--wpds-dimension-size-3xs, 12px);
   border-radius: var(--wpds-border-radius-sm, 2px);
-  background: color-mix(in sRGB, var(--heatmap-primary) calc((.15 + .85 * var(--intensity)) * 100%), transparent);
+  background: color-mix(in sRGB, var(--heatmap-primary) calc((.15 + .85 * var(--intensity)) * 100%), var(--heatmap-bg, #fff));
 }
 .a8ccharts-GovfoW-leaderboardChart {
   transition: opacity var(--wpds-motion-duration-lg, .3s) var(--wpds-motion-easing-subtle, cubic-bezier(.15, 0, .15, 1));
@@ -552,6 +552,18 @@
 
 .a8ccharts-GovfoW-valueContainer {
   justify-content: flex-end;
+  align-items: center;
+}
+
+.a8ccharts-GovfoW-deltaValue {
+  font-variant-numeric: tabular-nums;
+  text-align: end;
+  min-width: 3ch;
+  display: inline-block;
+}
+
+.a8ccharts-GovfoW-deltaPlaceholder {
+  text-align: center;
 }
 
 .a8ccharts-GovfoW-overlayLabel {
@@ -561,7 +573,7 @@
 .a8ccharts-GovfoW-emptyState {
   padding: var(--wpds-dimension-padding-3xl, 32px) var(--wpds-dimension-padding-lg, 16px);
   text-align: center;
-  color: var(--wpds-color-fg-content-neutral-weak, #707070);
+  color: var(--wpds-color-foreground-content-neutral-weak, #707070);
   font-size: var(--wpds-typography-font-size-md, 13px);
   font-style: italic;
 }
@@ -616,14 +628,14 @@
 
 .a8ccharts-GovfoW-interactiveRow:focus-visible {
   border-radius: var(--wpds-border-radius-sm, 2px);
-  outline: var(--focus-ring-width) solid var(--wpds-color-stroke-focus-brand, var(--wp-admin-theme-color, #3858e9));
+  outline: var(--focus-ring-width) solid var(--wpds-color-stroke-focus, var(--wp-admin-theme-color, #3858e9));
   outline-offset: calc(-1 * var(--focus-ring-width));
 }
 
 .a8ccharts-GovfoW-chevron {
   inset-inline-end: var(--wpds-dimension-padding-xs, 4px);
   opacity: 0;
-  color: var(--wpds-color-fg-content-neutral-weak, #707070);
+  color: var(--wpds-color-foreground-content-neutral-weak, #707070);
   transition: opacity var(--wpds-motion-duration-sm, .1s) var(--wpds-motion-easing-subtle, cubic-bezier(.15, 0, .15, 1));
   pointer-events: none;
   margin-block: auto;
@@ -690,15 +702,15 @@
 }
 
 .a8ccharts-zR7F7G-trend-indicator--up {
-  color: var(--charts-trend-up-color, var(--wpds-color-fg-content-success-weak, #008030));
+  color: var(--charts-trend-up-color, var(--wpds-color-foreground-content-success-weak, #008030));
 }
 
 .a8ccharts-zR7F7G-trend-indicator--down {
-  color: var(--charts-trend-down-color, var(--wpds-color-fg-content-error-weak, #cc1818));
+  color: var(--charts-trend-down-color, var(--wpds-color-foreground-content-error-weak, #cc1818));
 }
 
 .a8ccharts-zR7F7G-trend-indicator--neutral {
-  color: var(--charts-trend-neutral-color, var(--wpds-color-fg-content-neutral-weak, #707070));
+  color: var(--charts-trend-neutral-color, var(--wpds-color-foreground-content-neutral-weak, #707070));
 }
 
 .a8ccharts-zR7F7G-trend-indicator__icon {

package/dist/index.d.cts

@@ -138,21 +138,24 @@ type LeaderboardEntry = {
    */
   currentValue: number;
   /**
-   * Value of the entry in the previous period
+   * Value of the entry in the previous period. Omit when this row has no
+   * matching comparison-period value.
    */
-  previousValue: number;
+  previousValue?: number;
   /**
    * Width of current bar, as % of the current value
    */
   currentShare: number;
   /**
-   * Width of previous bar, as % of the current value
+   * Width of previous bar, as % of the current value. Omit when this row has
+   * no matching comparison-period value.
    */
-  previousShare: number;
+  previousShare?: number;
   /**
-   * Delta of the entry
+   * Delta of the entry. Omit when this row has no matching comparison-period
+   * value.
    */
-  delta: number;
+  delta?: number;
   /**
    * Optional color for the entry's image/icon
    */
@@ -1043,6 +1046,12 @@ type GeoRegion = 'world' | (string & {});
  * - 'metros': Metropolitan areas (US only)
  */
 type GeoResolution = 'countries' | 'provinces' | 'metros';
+interface GeoChartError {
+  id?: string;
+  message?: string;
+  detailedMessage?: string;
+  options?: Record<string, unknown>;
+}
 interface GeoChartProps extends Pick<BaseChartProps, 'className' | 'chartId' | 'width' | 'height'> {
   /**
    * Data in Google Charts native format for maximum flexibility.
@@ -1066,6 +1075,10 @@ interface GeoChartProps extends Pick<BaseChartProps, 'className' | 'chartId' | '
    * @default 'countries'
    */
   resolution?: GeoResolution;
+  /**
+   * Callback fired when Google Charts emits a chart error.
+   */
+  onError?: (error: GeoChartError) => void;
   /**
    * Optional render function for the loading placeholder.
    * Called while Google Charts is loading.
@@ -1405,6 +1418,16 @@ declare const normalizeColorToHex: (color: string, element?: HTMLElement | null,
  * @throws {Error} if hex string is malformed
  */
 declare const lightenHexColor: (hex: string, blend: number) => string;
+/**
+ * Blend one hex color toward another, per-channel in sRGB.
+ *
+ * @param  fromHex - Starting hex color, returned when blend is 0
+ * @param  toHex   - Target hex color, returned when blend is 1
+ * @param  blend   - Amount toward toHex, clamped to [0, 1]
+ * @return Blended hex color string
+ * @throws {Error} if either hex string is malformed
+ */
+declare const mixHexColors: (fromHex: string, toHex: string, blend: number) => string;
 /**
  * WCAG relative luminance of a hex color (0 = black, 1 = white).
  *
@@ -1904,6 +1927,7 @@ interface GlobalChartsContextValue {
   getChartData: (id: string) => ChartRegistration | undefined;
   theme: CompleteChartTheme;
   getElementStyles: (params: GetElementStylesParams) => ElementStyles;
+  resolveThemeColor: (value: string) => string;
   toggleSeriesVisibility: (chartId: string, seriesLabel: string) => void;
   isSeriesVisible: (chartId: string, seriesLabel: string) => boolean;
   getHiddenSeries: (chartId: string) => Set<string>;
@@ -1935,5 +1959,5 @@ declare const useGlobalChartsTheme: () => CompleteChartTheme;
  */
 declare const defaultTheme: CompleteChartTheme;
 //#endregion
-export { AccessibleTooltip, type AnnotationStyles, type ArcData, AreaChartResponsive as AreaChart, type AreaChartProps, AreaChart as AreaChartUnresponsive, type AxisOptions, BarChartResponsive as BarChart, type BarChartProps, BarChart as BarChartUnresponsive, BarListChartResponsive as BarListChart, type BarListChartProps, BarListChart as BarListChartUnresponsive, type BaseChartProps, type BaseLegendItem, type BaseLegendProps, BaseTooltip, type BaseTooltipProps, type CalendarHeatmapResult, type ChartLegendConfig, type ChartLegendOptions, type ChartTheme, type CompleteChartTheme, ConversionFunnelChartWithProvider as ConversionFunnelChart, type ConversionFunnelChartProps, type CurveType, type DataPoint, type DataPointDate, type DataPointPercentage, type EventHandlerParams, type FunnelStep, GeoChartResponsive as GeoChart, type GeoChartProps, GeoChartWithProvider as GeoChartUnresponsive, type GeoData, type GeoRegion, type GeoResolution, GlobalChartsContext, GlobalChartsProvider, GlobalChartsProvider as ThemeProvider, type GoogleDataTableColumn, type GoogleDataTableColumnRoleType, type GoogleDataTableRow, type GradientConfig, type GradientStop, type GridProps, type GridStyles, type HeatmapCell, HeatmapChartResponsive as HeatmapChart, type HeatmapChartProps, HeatmapChart as HeatmapChartUnresponsive, type HeatmapColumn, type HeatmapTooltipData, LeaderboardChartResponsive as LeaderboardChart, type LeaderboardChartProps, LeaderboardChart as LeaderboardChartUnresponsive, type LeaderboardEntry, Legend, type LegendItemStyles, type LegendLabelStyles, type LegendPosition, type LegendProps, type LegendShape, type LegendShapeLabel, type LegendShapeRenderProps, type LegendShapeStyles, type LegendValueDisplay, LineChartResponsive as LineChart, type LineChartAnnotationProps, type LineChartProps, LineChart as LineChartUnresponsive, type LineStyles, type MainMetricRenderProps, type MetricValueType, type MultipleDataPointsDate, type Optional, type OrientationType, PieChartResponsive as PieChart, type PieChartProps, type PieChartRenderTooltipParams, PieChart as PieChartUnresponsive, PieSemiCircleChartResponsive as PieSemiCircleChart, type PieSemiCircleChartProps, type PieSemiCircleChartRenderTooltipParams, PieSemiCircleChart as PieSemiCircleChartUnresponsive, type RenderLabelProps, type RenderLineGlyphProps, type RenderTooltipGlyphProps, type RenderTooltipParams, type RenderValueProps, type ScaleOptions, type SeriesData, type SeriesDataOptions, Sparkline, type SparklineDataPoint, type SparklineProps, SparklineUnresponsive, type StepLabelRenderProps, type StepRateRenderProps, type TooltipData, type TooltipDatum, type TooltipProps, type TooltipRenderProps, type TrendDirection, TrendIndicator, type TrendIndicatorProps, type XyChartTooltipProps, buildCalendarHeatmapData, defaultTheme, formatMetricValue, formatPercentage, getColorDistance, hexToRgba, isValidHexColor, lightenHexColor, mergeThemes, normalizeColorToHex, parseAsLocalDate, parseHslString, parseRgbString, prefersLightText, relativeLuminance, useChartLegendItems, useGlobalChartsContext, useGlobalChartsTheme, useLeaderboardLegendItems, validateHexColor };
+export { AccessibleTooltip, type AnnotationStyles, type ArcData, AreaChartResponsive as AreaChart, type AreaChartProps, AreaChart as AreaChartUnresponsive, type AxisOptions, BarChartResponsive as BarChart, type BarChartProps, BarChart as BarChartUnresponsive, BarListChartResponsive as BarListChart, type BarListChartProps, BarListChart as BarListChartUnresponsive, type BaseChartProps, type BaseLegendItem, type BaseLegendProps, BaseTooltip, type BaseTooltipProps, type CalendarHeatmapResult, type ChartLegendConfig, type ChartLegendOptions, type ChartTheme, type CompleteChartTheme, ConversionFunnelChartWithProvider as ConversionFunnelChart, type ConversionFunnelChartProps, type CurveType, type DataPoint, type DataPointDate, type DataPointPercentage, type EventHandlerParams, type FunnelStep, GeoChartResponsive as GeoChart, type GeoChartError, type GeoChartProps, GeoChartWithProvider as GeoChartUnresponsive, type GeoData, type GeoRegion, type GeoResolution, GlobalChartsContext, GlobalChartsProvider, GlobalChartsProvider as ThemeProvider, type GoogleDataTableColumn, type GoogleDataTableColumnRoleType, type GoogleDataTableRow, type GradientConfig, type GradientStop, type GridProps, type GridStyles, type HeatmapCell, HeatmapChartResponsive as HeatmapChart, type HeatmapChartProps, HeatmapChart as HeatmapChartUnresponsive, type HeatmapColumn, type HeatmapTooltipData, LeaderboardChartResponsive as LeaderboardChart, type LeaderboardChartProps, LeaderboardChart as LeaderboardChartUnresponsive, type LeaderboardEntry, Legend, type LegendItemStyles, type LegendLabelStyles, type LegendPosition, type LegendProps, type LegendShape, type LegendShapeLabel, type LegendShapeRenderProps, type LegendShapeStyles, type LegendValueDisplay, LineChartResponsive as LineChart, type LineChartAnnotationProps, type LineChartProps, LineChart as LineChartUnresponsive, type LineStyles, type MainMetricRenderProps, type MetricValueType, type MultipleDataPointsDate, type Optional, type OrientationType, PieChartResponsive as PieChart, type PieChartProps, type PieChartRenderTooltipParams, PieChart as PieChartUnresponsive, PieSemiCircleChartResponsive as PieSemiCircleChart, type PieSemiCircleChartProps, type PieSemiCircleChartRenderTooltipParams, PieSemiCircleChart as PieSemiCircleChartUnresponsive, type RenderLabelProps, type RenderLineGlyphProps, type RenderTooltipGlyphProps, type RenderTooltipParams, type RenderValueProps, type ScaleOptions, type SeriesData, type SeriesDataOptions, Sparkline, type SparklineDataPoint, type SparklineProps, SparklineUnresponsive, type StepLabelRenderProps, type StepRateRenderProps, type TooltipData, type TooltipDatum, type TooltipProps, type TooltipRenderProps, type TrendDirection, TrendIndicator, type TrendIndicatorProps, type XyChartTooltipProps, buildCalendarHeatmapData, defaultTheme, formatMetricValue, formatPercentage, getColorDistance, hexToRgba, isValidHexColor, lightenHexColor, mergeThemes, mixHexColors, normalizeColorToHex, parseAsLocalDate, parseHslString, parseRgbString, prefersLightText, relativeLuminance, useChartLegendItems, useGlobalChartsContext, useGlobalChartsTheme, useLeaderboardLegendItems, validateHexColor };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import { EventHandlerParams, EventHandlerParams as EventHandlerParams$1, GlyphProps, GridStyles, GridStyles as GridStyles$1, LineStyles, LineStyles as LineStyles$1, TooltipContextType } from "@visx/xychart";
 import { CSSProperties, ComponentClass, ComponentProps, ComponentType, FC, MouseEvent, PointerEvent, PropsWithChildren, ReactElement, ReactNode, SVGProps } from "react";
 import { TextProps } from "@visx/text";
+import { TooltipProps as TooltipProps$1, UseTooltipPortalOptions } from "@visx/tooltip";
 import { PickD3Scale, ScaleInput, ScaleType } from "@visx/scale";
 import { LegendOrdinal } from "@visx/legend";
 import { CircleSubjectProps, ConnectorProps, LabelProps, LineSubjectProps } from "@visx/annotation";
-import { TooltipProps as TooltipProps$1, UseTooltipPortalOptions } from "@visx/tooltip";
 import { PieProvidedProps } from "@visx/shape";
 import { AxisRendererProps, AxisScale, Orientation, TickFormatter } from "@visx/axis";
 
@@ -138,21 +138,24 @@ type LeaderboardEntry = {
    */
   currentValue: number;
   /**
-   * Value of the entry in the previous period
+   * Value of the entry in the previous period. Omit when this row has no
+   * matching comparison-period value.
    */
-  previousValue: number;
+  previousValue?: number;
   /**
    * Width of current bar, as % of the current value
    */
   currentShare: number;
   /**
-   * Width of previous bar, as % of the current value
+   * Width of previous bar, as % of the current value. Omit when this row has
+   * no matching comparison-period value.
    */
-  previousShare: number;
+  previousShare?: number;
   /**
-   * Delta of the entry
+   * Delta of the entry. Omit when this row has no matching comparison-period
+   * value.
    */
-  delta: number;
+  delta?: number;
   /**
    * Optional color for the entry's image/icon
    */
@@ -1043,6 +1046,12 @@ type GeoRegion = 'world' | (string & {});
  * - 'metros': Metropolitan areas (US only)
  */
 type GeoResolution = 'countries' | 'provinces' | 'metros';
+interface GeoChartError {
+  id?: string;
+  message?: string;
+  detailedMessage?: string;
+  options?: Record<string, unknown>;
+}
 interface GeoChartProps extends Pick<BaseChartProps, 'className' | 'chartId' | 'width' | 'height'> {
   /**
    * Data in Google Charts native format for maximum flexibility.
@@ -1066,6 +1075,10 @@ interface GeoChartProps extends Pick<BaseChartProps, 'className' | 'chartId' | '
    * @default 'countries'
    */
   resolution?: GeoResolution;
+  /**
+   * Callback fired when Google Charts emits a chart error.
+   */
+  onError?: (error: GeoChartError) => void;
   /**
    * Optional render function for the loading placeholder.
    * Called while Google Charts is loading.
@@ -1405,6 +1418,16 @@ declare const normalizeColorToHex: (color: string, element?: HTMLElement | null,
  * @throws {Error} if hex string is malformed
  */
 declare const lightenHexColor: (hex: string, blend: number) => string;
+/**
+ * Blend one hex color toward another, per-channel in sRGB.
+ *
+ * @param  fromHex - Starting hex color, returned when blend is 0
+ * @param  toHex   - Target hex color, returned when blend is 1
+ * @param  blend   - Amount toward toHex, clamped to [0, 1]
+ * @return Blended hex color string
+ * @throws {Error} if either hex string is malformed
+ */
+declare const mixHexColors: (fromHex: string, toHex: string, blend: number) => string;
 /**
  * WCAG relative luminance of a hex color (0 = black, 1 = white).
  *
@@ -1904,6 +1927,7 @@ interface GlobalChartsContextValue {
   getChartData: (id: string) => ChartRegistration | undefined;
   theme: CompleteChartTheme;
   getElementStyles: (params: GetElementStylesParams) => ElementStyles;
+  resolveThemeColor: (value: string) => string;
   toggleSeriesVisibility: (chartId: string, seriesLabel: string) => void;
   isSeriesVisible: (chartId: string, seriesLabel: string) => boolean;
   getHiddenSeries: (chartId: string) => Set<string>;
@@ -1935,5 +1959,5 @@ declare const useGlobalChartsTheme: () => CompleteChartTheme;
  */
 declare const defaultTheme: CompleteChartTheme;
 //#endregion
-export { AccessibleTooltip, type AnnotationStyles, type ArcData, AreaChartResponsive as AreaChart, type AreaChartProps, AreaChart as AreaChartUnresponsive, type AxisOptions, BarChartResponsive as BarChart, type BarChartProps, BarChart as BarChartUnresponsive, BarListChartResponsive as BarListChart, type BarListChartProps, BarListChart as BarListChartUnresponsive, type BaseChartProps, type BaseLegendItem, type BaseLegendProps, BaseTooltip, type BaseTooltipProps, type CalendarHeatmapResult, type ChartLegendConfig, type ChartLegendOptions, type ChartTheme, type CompleteChartTheme, ConversionFunnelChartWithProvider as ConversionFunnelChart, type ConversionFunnelChartProps, type CurveType, type DataPoint, type DataPointDate, type DataPointPercentage, type EventHandlerParams, type FunnelStep, GeoChartResponsive as GeoChart, type GeoChartProps, GeoChartWithProvider as GeoChartUnresponsive, type GeoData, type GeoRegion, type GeoResolution, GlobalChartsContext, GlobalChartsProvider, GlobalChartsProvider as ThemeProvider, type GoogleDataTableColumn, type GoogleDataTableColumnRoleType, type GoogleDataTableRow, type GradientConfig, type GradientStop, type GridProps, type GridStyles, type HeatmapCell, HeatmapChartResponsive as HeatmapChart, type HeatmapChartProps, HeatmapChart as HeatmapChartUnresponsive, type HeatmapColumn, type HeatmapTooltipData, LeaderboardChartResponsive as LeaderboardChart, type LeaderboardChartProps, LeaderboardChart as LeaderboardChartUnresponsive, type LeaderboardEntry, Legend, type LegendItemStyles, type LegendLabelStyles, type LegendPosition, type LegendProps, type LegendShape, type LegendShapeLabel, type LegendShapeRenderProps, type LegendShapeStyles, type LegendValueDisplay, LineChartResponsive as LineChart, type LineChartAnnotationProps, type LineChartProps, LineChart as LineChartUnresponsive, type LineStyles, type MainMetricRenderProps, type MetricValueType, type MultipleDataPointsDate, type Optional, type OrientationType, PieChartResponsive as PieChart, type PieChartProps, type PieChartRenderTooltipParams, PieChart as PieChartUnresponsive, PieSemiCircleChartResponsive as PieSemiCircleChart, type PieSemiCircleChartProps, type PieSemiCircleChartRenderTooltipParams, PieSemiCircleChart as PieSemiCircleChartUnresponsive, type RenderLabelProps, type RenderLineGlyphProps, type RenderTooltipGlyphProps, type RenderTooltipParams, type RenderValueProps, type ScaleOptions, type SeriesData, type SeriesDataOptions, Sparkline, type SparklineDataPoint, type SparklineProps, SparklineUnresponsive, type StepLabelRenderProps, type StepRateRenderProps, type TooltipData, type TooltipDatum, type TooltipProps, type TooltipRenderProps, type TrendDirection, TrendIndicator, type TrendIndicatorProps, type XyChartTooltipProps, buildCalendarHeatmapData, defaultTheme, formatMetricValue, formatPercentage, getColorDistance, hexToRgba, isValidHexColor, lightenHexColor, mergeThemes, normalizeColorToHex, parseAsLocalDate, parseHslString, parseRgbString, prefersLightText, relativeLuminance, useChartLegendItems, useGlobalChartsContext, useGlobalChartsTheme, useLeaderboardLegendItems, validateHexColor };
+export { AccessibleTooltip, type AnnotationStyles, type ArcData, AreaChartResponsive as AreaChart, type AreaChartProps, AreaChart as AreaChartUnresponsive, type AxisOptions, BarChartResponsive as BarChart, type BarChartProps, BarChart as BarChartUnresponsive, BarListChartResponsive as BarListChart, type BarListChartProps, BarListChart as BarListChartUnresponsive, type BaseChartProps, type BaseLegendItem, type BaseLegendProps, BaseTooltip, type BaseTooltipProps, type CalendarHeatmapResult, type ChartLegendConfig, type ChartLegendOptions, type ChartTheme, type CompleteChartTheme, ConversionFunnelChartWithProvider as ConversionFunnelChart, type ConversionFunnelChartProps, type CurveType, type DataPoint, type DataPointDate, type DataPointPercentage, type EventHandlerParams, type FunnelStep, GeoChartResponsive as GeoChart, type GeoChartError, type GeoChartProps, GeoChartWithProvider as GeoChartUnresponsive, type GeoData, type GeoRegion, type GeoResolution, GlobalChartsContext, GlobalChartsProvider, GlobalChartsProvider as ThemeProvider, type GoogleDataTableColumn, type GoogleDataTableColumnRoleType, type GoogleDataTableRow, type GradientConfig, type GradientStop, type GridProps, type GridStyles, type HeatmapCell, HeatmapChartResponsive as HeatmapChart, type HeatmapChartProps, HeatmapChart as HeatmapChartUnresponsive, type HeatmapColumn, type HeatmapTooltipData, LeaderboardChartResponsive as LeaderboardChart, type LeaderboardChartProps, LeaderboardChart as LeaderboardChartUnresponsive, type LeaderboardEntry, Legend, type LegendItemStyles, type LegendLabelStyles, type LegendPosition, type LegendProps, type LegendShape, type LegendShapeLabel, type LegendShapeRenderProps, type LegendShapeStyles, type LegendValueDisplay, LineChartResponsive as LineChart, type LineChartAnnotationProps, type LineChartProps, LineChart as LineChartUnresponsive, type LineStyles, type MainMetricRenderProps, type MetricValueType, type MultipleDataPointsDate, type Optional, type OrientationType, PieChartResponsive as PieChart, type PieChartProps, type PieChartRenderTooltipParams, PieChart as PieChartUnresponsive, PieSemiCircleChartResponsive as PieSemiCircleChart, type PieSemiCircleChartProps, type PieSemiCircleChartRenderTooltipParams, PieSemiCircleChart as PieSemiCircleChartUnresponsive, type RenderLabelProps, type RenderLineGlyphProps, type RenderTooltipGlyphProps, type RenderTooltipParams, type RenderValueProps, type ScaleOptions, type SeriesData, type SeriesDataOptions, Sparkline, type SparklineDataPoint, type SparklineProps, SparklineUnresponsive, type StepLabelRenderProps, type StepRateRenderProps, type TooltipData, type TooltipDatum, type TooltipProps, type TooltipRenderProps, type TrendDirection, TrendIndicator, type TrendIndicatorProps, type XyChartTooltipProps, buildCalendarHeatmapData, defaultTheme, formatMetricValue, formatPercentage, getColorDistance, hexToRgba, isValidHexColor, lightenHexColor, mergeThemes, mixHexColors, normalizeColorToHex, parseAsLocalDate, parseHslString, parseRgbString, prefersLightText, relativeLuminance, useChartLegendItems, useGlobalChartsContext, useGlobalChartsTheme, useLeaderboardLegendItems, validateHexColor };
 //# sourceMappingURL=index.d.ts.map