@fluentui/react-charting 5.24.38 → 5.25.0

package/CHANGELOG.json

@@ -2,7 +2,105 @@
   "name": "@fluentui/react-charting",
   "entries": [
     {
-      "date": "Tue, 14 Oct 2025 07:19:57 GMT",
+      "date": "Thu, 23 Oct 2025 10:20:51 GMT",
+      "tag": "@fluentui/react-charting_v5.25.0",
+      "version": "5.25.0",
+      "comments": {
+        "patch": [
+          {
+            "author": "kumarkshitij@microsoft.com",
+            "package": "@fluentui/react-charting",
+            "commit": "83942b2faa689b1ab6b9e0f0b56fdbd625ac7631",
+            "comment": "feat: map deprecated plotly create_gantt() scatter traces to gantt chart"
+          },
+          {
+            "author": "anushgupta@microsoft.com",
+            "package": "@fluentui/react-charting",
+            "commit": "002f3d9ca75a903654557218aedee7a198edc804",
+            "comment": "fix chart exception issue"
+          },
+          {
+            "author": "120183316+srmukher@users.noreply.github.com",
+            "package": "@fluentui/react-charting",
+            "commit": "ad8b6d128850dbf3b6f7e4b74ebe137435ef15c1",
+            "comment": "feat(react-charting): Annotations"
+          }
+        ],
+        "minor": [
+          {
+            "author": "martinhochel@microsoft.com",
+            "package": "@fluentui/react-charting",
+            "commit": "6b3885cb0c984861ea8342fea64e95a2c9668125",
+            "comment": "feat: bump react range to support React 19"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-charting",
+            "comment": "Bump @fluentui/chart-utilities to v1.1.35",
+            "commit": "c16125427e4d796ae4a1143f482baa0da962bac1"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-charting",
+            "comment": "Bump @fluentui/react-focus to v8.10.0",
+            "commit": "c16125427e4d796ae4a1143f482baa0da962bac1"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-charting",
+            "comment": "Bump @fluentui/theme-samples to v8.7.219",
+            "commit": "c16125427e4d796ae4a1143f482baa0da962bac1"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-charting",
+            "comment": "Bump @fluentui/react to v8.125.0",
+            "commit": "c16125427e4d796ae4a1143f482baa0da962bac1"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Thu, 16 Oct 2025 07:21:58 GMT",
+      "tag": "@fluentui/react-charting_v5.24.39",
+      "version": "5.24.39",
+      "comments": {
+        "patch": [
+          {
+            "author": "martinhochel@microsoft.com",
+            "package": "@fluentui/react-charting",
+            "commit": "6c4630f5f8aa3ac42ce4c45be7d39642899e1e85",
+            "comment": "fix: resolve React 19 incompatible types"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-charting",
+            "comment": "Bump @fluentui/chart-utilities to v1.1.34",
+            "commit": "36be47512933fadd0418d11cdc1e3530c13f0575"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-charting",
+            "comment": "Bump @fluentui/react-focus to v8.9.29",
+            "commit": "36be47512933fadd0418d11cdc1e3530c13f0575"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-charting",
+            "comment": "Bump @fluentui/theme-samples to v8.7.218",
+            "commit": "36be47512933fadd0418d11cdc1e3530c13f0575"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-charting",
+            "comment": "Bump @fluentui/react to v8.124.2",
+            "commit": "36be47512933fadd0418d11cdc1e3530c13f0575"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Tue, 14 Oct 2025 07:21:45 GMT",
       "tag": "@fluentui/react-charting_v5.24.38",
       "version": "5.24.38",
       "comments": {

package/CHANGELOG.md

@@ -1,12 +1,44 @@
 # Change Log - @fluentui/react-charting
 
-This log was last generated on Tue, 14 Oct 2025 07:19:57 GMT and should not be manually modified.
+This log was last generated on Thu, 23 Oct 2025 10:20:51 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## [5.25.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-charting_v5.25.0)
+
+Thu, 23 Oct 2025 10:20:51 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-charting_v5.24.39..@fluentui/react-charting_v5.25.0)
+
+### Minor changes
+
+- feat: bump react range to support React 19 ([PR #35362](https://github.com/microsoft/fluentui/pull/35362) by martinhochel@microsoft.com)
+- Bump @fluentui/chart-utilities to v1.1.35 ([PR #35364](https://github.com/microsoft/fluentui/pull/35364) by beachball)
+- Bump @fluentui/react-focus to v8.10.0 ([PR #35364](https://github.com/microsoft/fluentui/pull/35364) by beachball)
+- Bump @fluentui/theme-samples to v8.7.219 ([PR #35364](https://github.com/microsoft/fluentui/pull/35364) by beachball)
+- Bump @fluentui/react to v8.125.0 ([PR #35364](https://github.com/microsoft/fluentui/pull/35364) by beachball)
+
+### Patches
+
+- feat: map deprecated plotly create_gantt() scatter traces to gantt chart ([PR #35334](https://github.com/microsoft/fluentui/pull/35334) by kumarkshitij@microsoft.com)
+- fix chart exception issue ([PR #35342](https://github.com/microsoft/fluentui/pull/35342) by anushgupta@microsoft.com)
+- feat(react-charting): Annotations ([PR #35324](https://github.com/microsoft/fluentui/pull/35324) by 120183316+srmukher@users.noreply.github.com)
+
+## [5.24.39](https://github.com/microsoft/fluentui/tree/@fluentui/react-charting_v5.24.39)
+
+Thu, 16 Oct 2025 07:21:58 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-charting_v5.24.38..@fluentui/react-charting_v5.24.39)
+
+### Patches
+
+- fix: resolve React 19 incompatible types ([PR #35303](https://github.com/microsoft/fluentui/pull/35303) by martinhochel@microsoft.com)
+- Bump @fluentui/chart-utilities to v1.1.34 ([commit](https://github.com/microsoft/fluentui/commit/36be47512933fadd0418d11cdc1e3530c13f0575) by beachball)
+- Bump @fluentui/react-focus to v8.9.29 ([commit](https://github.com/microsoft/fluentui/commit/36be47512933fadd0418d11cdc1e3530c13f0575) by beachball)
+- Bump @fluentui/theme-samples to v8.7.218 ([commit](https://github.com/microsoft/fluentui/commit/36be47512933fadd0418d11cdc1e3530c13f0575) by beachball)
+- Bump @fluentui/react to v8.124.2 ([commit](https://github.com/microsoft/fluentui/commit/36be47512933fadd0418d11cdc1e3530c13f0575) by beachball)
+
 ## [5.24.38](https://github.com/microsoft/fluentui/tree/@fluentui/react-charting_v5.24.38)
 
-Tue, 14 Oct 2025 07:19:57 GMT 
+Tue, 14 Oct 2025 07:21:45 GMT 
 [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-charting_v5.24.37..@fluentui/react-charting_v5.24.38)
 
 ### Patches

package/dist/react-charting.d.ts

@@ -15,6 +15,7 @@ import { IStyleFunctionOrObject } from '@fluentui/react/lib/Utilities';
 import { IStyleFunctionOrObject as IStyleFunctionOrObject_2 } from '@fluentui/react';
 import { ITheme } from '@fluentui/react/lib/Styling';
 import { ITheme as ITheme_2 } from '@fluentui/react';
+import type { JSXElement } from '@fluentui/utilities';
 import * as React_2 from 'react';
 import { SankeyLink } from 'd3-sankey';
 import { SankeyNode } from 'd3-sankey';
@@ -83,6 +84,10 @@ export declare type AxisProps = {
      *   - Exception: when `tickStep` uses `"L<f>"`, you can specify the raw value directly.
      */
     tick0?: number | Date;
+    /**
+     * Sets the text displayed at each tick position specified by `tickValues`. Used with `tickValues`.
+     */
+    tickText?: string[];
 };
 
 /**
@@ -101,6 +106,113 @@ export declare type AxisScaleType = 'default' | 'log';
  */
 export declare const CartesianChart: React_2.FunctionComponent<IModifiedCartesianChartProps>;
 
+export declare interface ChartAnnotation {
+    /** Optional id for React reconciliation */
+    id?: string;
+    /** Primary textual content */
+    text: string;
+    /** Coordinates describing where the annotation should be anchored */
+    coordinates: ChartAnnotationCoordinate;
+    /** Layout customisation */
+    layout?: ChartAnnotationLayoutProps;
+    /** Visual styling */
+    style?: ChartAnnotationStyleProps;
+    /** Optional connector line that links the annotation to its anchor. */
+    connector?: ChartAnnotationConnectorProps;
+    /** Accessibility metadata */
+    accessibility?: ChartAnnotationAccessibilityProps;
+    /** Optional application specific metadata */
+    data?: Record<string, unknown>;
+}
+
+export declare interface ChartAnnotationAccessibilityProps {
+    /** Accessible label announced by assistive technologies */
+    ariaLabel?: string;
+    /** Accessible description id */
+    ariaDescribedBy?: string;
+    /** Custom role */
+    role?: string;
+}
+
+export declare type ChartAnnotationArrowHead = 'none' | 'start' | 'end' | 'both';
+
+export declare interface ChartAnnotationConnectorProps {
+    /** Distance in pixels between the annotation element and the start of the connector. */
+    startPadding?: number;
+    /** Distance in pixels between the anchor point and the end of the connector. */
+    endPadding?: number;
+    /** Stroke colour for the connector. */
+    strokeColor?: string;
+    /** Stroke width in pixels. */
+    strokeWidth?: number;
+    /** SVG stroke dash array for dashed connectors. */
+    dashArray?: string;
+    /** Arrow head placement. Defaults to `'end'`. */
+    arrow?: ChartAnnotationArrowHead;
+}
+
+export declare type ChartAnnotationCoordinate = {
+    /** Cartesian data coordinates mapped through the chart scales or
+     * Normalised coordinates within the plot area (0-1) or
+     * Absolute pixel position relative to the chart's SVG origin
+     */
+    type: 'data' | 'relative' | 'pixel';
+    /** x-axis value in the data domain */
+    x: number | string | Date;
+    /** y-axis value in the data domain */
+    y: number | string | Date;
+    /** Use the secondary y scale when available */
+    yAxis?: 'primary' | 'secondary';
+};
+
+declare type ChartAnnotationHorizontalAlign = 'start' | 'center' | 'end';
+
+export declare interface ChartAnnotationLayoutProps {
+    /** Horizontal alignment of the annotation relative to the anchor point */
+    align?: ChartAnnotationHorizontalAlign;
+    /** Vertical alignment of the annotation relative to the anchor point */
+    verticalAlign?: ChartAnnotationVerticalAlign;
+    /** Horizontal offset in pixels applied after alignment */
+    offsetX?: number;
+    /** Vertical offset in pixels applied after alignment */
+    offsetY?: number;
+    /** Optional maximum width for wrapped text */
+    maxWidth?: number;
+    /** Whether the annotation should remain inside the plot area */
+    clipToBounds?: boolean;
+    /** Additional CSS classes applied to the annotation wrapper */
+    className?: string;
+}
+
+export declare interface ChartAnnotationStyleProps {
+    /** Text colour */
+    textColor?: string;
+    /** Background colour for the annotation container */
+    backgroundColor?: string;
+    /** Border colour */
+    borderColor?: string;
+    /** Border width */
+    borderWidth?: number;
+    /** Border style (solid, dashed, etc.) */
+    borderStyle?: React_2.CSSProperties['borderStyle'];
+    /** Border radius */
+    borderRadius?: number;
+    /** Box shadow applied to annotation */
+    boxShadow?: string;
+    /** Font size override */
+    fontSize?: string;
+    /** Font weight override */
+    fontWeight?: React_2.CSSProperties['fontWeight'];
+    /** Padding around the text. Accepts CSS shorthand notation */
+    padding?: string;
+    /** Opacity for the annotation container */
+    opacity?: number;
+    /** Optional class name applied to the annotation element */
+    className?: string;
+}
+
+declare type ChartAnnotationVerticalAlign = 'top' | 'middle' | 'bottom';
+
 /**
  * Chart data mode for chart data text
  * default: show the datapoint.x value
@@ -614,6 +726,10 @@ export declare interface ICartesianChartProps {
      * @default 10
      */
     xAxistickSize?: number;
+    /**
+     * Text annotations rendered on top of the chart area
+     */
+    annotations?: ChartAnnotation[];
     /**
      * defines the space between the tick line and the data label
      * @default 10
@@ -927,10 +1043,18 @@ export declare interface ICartesianChartStyles {
      * Styles for the chart wrapper div
      */
     chartWrapper?: IStyle;
+    /**
+     * Styles for the element wrapping the svg and overlays for annotation
+     */
+    plotContainer?: IStyle;
     /**
      * Styles for the svg tooltip
      */
     svgTooltip?: IStyle;
+    /**
+     * Styles applied to the annotation layer root element
+     */
+    annotationLayer?: IStyle;
     /**
      * Styles for the chart svg element
      */
@@ -3406,7 +3530,7 @@ export declare interface IModifiedCartesianChartProps extends ICartesianChartPro
     /**
      * Legends of the chart.
      */
-    legendBars: JSX.Element | null;
+    legendBars: JSXElement | null;
     /**
      * Callout props
      */
@@ -3487,6 +3611,10 @@ export declare interface IModifiedCartesianChartProps extends ICartesianChartPro
      * props to send to the focuszone
      */
     svgFocusZoneProps?: IFocusZoneProps;
+    /**
+     * Annotations to render on top of the chart area.
+     */
+    annotations?: ChartAnnotation[];
     /**
      * The prop used to define the culture to localize the numbers and date
      */