@automattic/charts 4.13.0 → 4.14.0

package/dist/index.css

@@ -37,6 +37,7 @@
   --a8c-charts-border-radius-leaderboard-bar: 9999px;
   --a8c-charts-dimension-leaderboard-row-gap: var(--wpds-dimension-gap-md, 12px);
   --a8c-charts-dimension-leaderboard-column-gap: var(--wpds-dimension-gap-xs, 4px);
+  --a8c-charts-dimension-leaderboard-label-inset: var(--wpds-dimension-padding-sm, 8px);
   --a8c-charts-dimension-legend-column-gap: var(--wpds-dimension-gap-lg, 16px);
   --a8c-charts-dimension-legend-row-gap: var(--wpds-dimension-gap-sm, 8px);
 }
@@ -762,7 +763,7 @@
 }
 
 .a8ccharts-GovfoW-barWithLabelContainer.a8ccharts-GovfoW-is-overlay .a8ccharts-GovfoW-label {
-  padding-left: var(--wpds-dimension-padding-sm, 8px);
+  padding-inline-start: var(--a8c-charts-dimension-leaderboard-label-inset);
 }
 
 .a8ccharts-GovfoW-barWithLabelContainer.a8ccharts-GovfoW-is-overlay .a8ccharts-GovfoW-barTrack {

package/dist/index.d.cts

@@ -163,18 +163,16 @@ type LeaderboardEntryFields = {
    */
   previousValue?: number;
   /**
-   * Width of current bar, as % of the largest absolute value across rows. A negative share
-   * extends the bar from a shared zero point toward the inline start, for every row.
+   * Width of current bar, as %. Derived from the values when omitted; a passed value wins.
+   * A negative share extends the bar from a shared zero point toward the inline start, for every row.
    */
-  currentShare: number;
+  currentShare?: number;
   /**
-   * Width of previous bar, as % of the largest absolute value across rows. Omit when this
-   * row has no matching comparison-period value.
+   * Width of previous bar, as %. Derived from `previousValue` when omitted; a passed value wins.
    */
   previousShare?: number;
   /**
-   * Delta of the entry. Omit when the percentage change is unavailable, such
-   * as when the row has no comparison value or its previous value is zero.
+   * Percentage change. Derived from the values when omitted; a passed value wins.
    */
   delta?: number;
   /**
@@ -785,7 +783,15 @@ type BaseLegendItem = {
   interactive?: boolean;
   /** Label of the series this static item describes; the item is left out while it is hidden. */
   describesSeries?: string;
-};
+} & ({
+  /** Pressed state of the toggle. */
+  pressed: boolean;
+  /** Makes an interactive legend item a toggle the consumer controls, instead of a series toggle. */
+  onToggle: () => void;
+} | {
+  pressed?: never;
+  onToggle?: never;
+});
 export declare const Legend: import("react").ForwardRefExoticComponent<Omit<BaseLegendProps, "items"> & {
   items?: BaseLegendItem[];
   chartId?: string;
@@ -1603,6 +1609,11 @@ interface LeaderboardChartProps extends Pick<BaseChartProps<LeaderboardEntry>, '
    * Whether to overlay the label on top of bar
    */
   withOverlayLabel?: boolean;
+  /**
+   * How a negative value draws: `diverge` puts every row on a shared zero point, `clamp` draws it as an empty bar.
+   * @default 'diverge'
+   */
+  negativeBars?: 'diverge' | 'clamp';
   /**
    * Primary color for current period bars
    */

package/dist/index.d.ts

@@ -163,18 +163,16 @@ type LeaderboardEntryFields = {
    */
   previousValue?: number;
   /**
-   * Width of current bar, as % of the largest absolute value across rows. A negative share
-   * extends the bar from a shared zero point toward the inline start, for every row.
+   * Width of current bar, as %. Derived from the values when omitted; a passed value wins.
+   * A negative share extends the bar from a shared zero point toward the inline start, for every row.
    */
-  currentShare: number;
+  currentShare?: number;
   /**
-   * Width of previous bar, as % of the largest absolute value across rows. Omit when this
-   * row has no matching comparison-period value.
+   * Width of previous bar, as %. Derived from `previousValue` when omitted; a passed value wins.
    */
   previousShare?: number;
   /**
-   * Delta of the entry. Omit when the percentage change is unavailable, such
-   * as when the row has no comparison value or its previous value is zero.
+   * Percentage change. Derived from the values when omitted; a passed value wins.
    */
   delta?: number;
   /**
@@ -785,7 +783,15 @@ type BaseLegendItem = {
   interactive?: boolean;
   /** Label of the series this static item describes; the item is left out while it is hidden. */
   describesSeries?: string;
-};
+} & ({
+  /** Pressed state of the toggle. */
+  pressed: boolean;
+  /** Makes an interactive legend item a toggle the consumer controls, instead of a series toggle. */
+  onToggle: () => void;
+} | {
+  pressed?: never;
+  onToggle?: never;
+});
 export declare const Legend: import("react").ForwardRefExoticComponent<Omit<BaseLegendProps, "items"> & {
   items?: BaseLegendItem[];
   chartId?: string;
@@ -1603,6 +1609,11 @@ interface LeaderboardChartProps extends Pick<BaseChartProps<LeaderboardEntry>, '
    * Whether to overlay the label on top of bar
    */
   withOverlayLabel?: boolean;
+  /**
+   * How a negative value draws: `diverge` puts every row on a shared zero point, `clamp` draws it as an empty bar.
+   * @default 'diverge'
+   */
+  negativeBars?: 'diverge' | 'clamp';
   /**
    * Primary color for current period bars
    */