@mui/x-charts 7.7.1 → 7.8.0

package/BarChart/BarLabel/getBarLabel.d.ts

@@ -1,7 +1,7 @@
 import { SeriesId } from '../../models/seriesType/common';
 import { BarLabelFunction } from './BarLabel.types';
 export declare const getBarLabel: (options: {
-    barLabel: 'value' | BarLabelFunction;
+    barLabel: "value" | BarLabelFunction;
     value: number | null;
     dataIndex: number;
     seriesId: SeriesId;

package/BarChart/useBarChartProps.d.ts

@@ -1,5 +1,14 @@
-/// <reference types="react" />
 import type { BarChartProps } from './BarChart';
+import { ResponsiveChartContainerProps } from '../ResponsiveChartContainer';
+import { BarPlotProps } from './BarPlot';
+import { ChartsOnAxisClickHandlerProps } from '../ChartsOnAxisClickHandler';
+import { ChartsGridProps } from '../ChartsGrid';
+import { ChartsClipPathProps } from '../ChartsClipPath';
+import { ChartsOverlayProps } from '../ChartsOverlay';
+import { ChartsAxisProps } from '../ChartsAxis';
+import { ChartsAxisHighlightProps } from '../ChartsAxisHighlight';
+import { ChartsLegendProps } from '../ChartsLegend';
+import { ChartsTooltipProps } from '../ChartsTooltip';
 /**
  * A helper function that extracts BarChartProps from the input props
  * and returns an object with props for the children components of BarChart.
@@ -8,95 +17,18 @@ import type { BarChartProps } from './BarChart';
  * @returns An object with props for the children components of BarChart
  */
 export declare const useBarChartProps: (props: BarChartProps) => {
-    chartContainerProps: {
-        series: {
-            layout: "horizontal" | "vertical";
-            color?: string | undefined;
-            data?: (number | null)[] | undefined;
-            label?: string | ((location: "tooltip" | "legend") => string) | undefined;
-            id?: import("../internals").SeriesId | undefined;
-            dataKey?: string | undefined;
-            stackOffset?: import("..").StackOffsetType | undefined;
-            valueFormatter?: import("../internals").SeriesValueFormatter<number | null> | undefined;
-            highlightScope?: Partial<import("..").HighlightScope> | undefined;
-            xAxisKey?: string | undefined;
-            yAxisKey?: string | undefined;
-            stack?: string | undefined;
-            stackOrder?: import("..").StackOrderType | undefined;
-            type: "bar";
-        }[];
-        width: number | undefined;
-        height: number | undefined;
-        margin: Partial<import("..").CardinalDirections<number>> | undefined;
-        colors: import("..").ChartsColorPalette | undefined;
-        dataset: import("../internals").DatasetType | undefined;
-        xAxis: import("../internals").MakeOptional<import("..").AxisConfig<import("..").ScaleName, any, import("..").ChartsXAxisProps>, "id">[] | undefined;
-        yAxis: import("../internals").MakeOptional<import("..").AxisConfig<import("..").ScaleName, any, import("..").ChartsYAxisProps>, "id">[] | undefined;
-        sx: import("@mui/system").SxProps<import("@mui/material").Theme> | undefined;
-        highlightedItem: import("..").HighlightItemData | null | undefined;
-        onHighlightChange: ((highlightedItem: import("..").HighlightItemData | null) => void) | undefined;
-        disableAxisListener: boolean;
-    };
-    barPlotProps: {
-        onItemClick: ((event: import("react").MouseEvent<SVGElement, MouseEvent>, barItemIdentifier: import("..").BarItemIdentifier) => void) | undefined;
-        slots: import("./BarChart").BarChartSlots | undefined;
-        slotProps: import("./BarChart").BarChartSlotProps | undefined;
-        skipAnimation: boolean | undefined;
-        borderRadius: number | undefined;
-        barLabel: "value" | ((item: import("./BarLabel").BarItem, context: import("./BarLabel").BarLabelContext) => string | null | undefined) | undefined;
-    };
-    axisClickHandlerProps: {
-        onAxisClick: ((event: MouseEvent, data: {
-            dataIndex: number;
-            axisValue?: string | number | Date | undefined;
-            seriesValues: Record<string, number | null | undefined>;
-        } | null) => void) | undefined;
-    };
-    gridProps: {
-        vertical: boolean | undefined;
-        horizontal: boolean | undefined;
-    };
-    clipPathProps: {
-        id: string;
-    };
+    chartContainerProps: ResponsiveChartContainerProps;
+    barPlotProps: BarPlotProps;
+    axisClickHandlerProps: ChartsOnAxisClickHandlerProps;
+    gridProps: ChartsGridProps;
+    clipPathProps: ChartsClipPathProps;
     clipPathGroupProps: {
         clipPath: string;
     };
-    overlayProps: {
-        slots: import("./BarChart").BarChartSlots | undefined;
-        slotProps: import("./BarChart").BarChartSlotProps | undefined;
-        loading: boolean | undefined;
-    };
-    chartsAxisProps: {
-        topAxis: string | import("..").ChartsXAxisProps | null | undefined;
-        leftAxis: string | import("..").ChartsYAxisProps | null | undefined;
-        rightAxis: string | import("..").ChartsYAxisProps | null | undefined;
-        bottomAxis: string | import("..").ChartsXAxisProps | null | undefined;
-        slots: import("./BarChart").BarChartSlots | undefined;
-        slotProps: import("./BarChart").BarChartSlotProps | undefined;
-    };
-    axisHighlightProps: {
-        x?: ("none" | "line" | "band") | undefined;
-        y: "none" | "line" | "band";
-    } | {
-        x: "none" | "line" | "band";
-        y?: ("none" | "line" | "band") | undefined;
-    };
-    legendProps: {
-        slots: import("./BarChart").BarChartSlots | undefined;
-        slotProps: import("./BarChart").BarChartSlotProps | undefined;
-        position?: import("..").AnchorPosition | undefined;
-        classes?: Partial<import("..").ChartsLegendClasses> | undefined;
-        hidden?: boolean | undefined;
-        direction?: import("..").Direction | undefined;
-    };
-    tooltipProps: {
-        slots: import("./BarChart").BarChartSlots | undefined;
-        slotProps: import("./BarChart").BarChartSlotProps | undefined;
-        trigger?: import("../ChartsTooltip/utils").TriggerOptions | undefined;
-        itemContent?: import("react").ElementType<import("..").ChartsItemContentProps<any>, keyof import("react").JSX.IntrinsicElements> | undefined;
-        axisContent?: import("react").ElementType<import("..").ChartsAxisContentProps, keyof import("react").JSX.IntrinsicElements> | undefined;
-        classes?: Partial<import("..").ChartsTooltipClasses> | undefined;
-    };
+    overlayProps: ChartsOverlayProps;
+    chartsAxisProps: ChartsAxisProps;
+    axisHighlightProps: ChartsAxisHighlightProps;
+    legendProps: ChartsLegendProps;
+    tooltipProps: ChartsTooltipProps;
     children: import("react").ReactNode;
 };

package/CHANGELOG.md

@@ -3,6 +3,105 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 7.8.0
+
+_Jun 28, 2024_
+
+We'd like to offer a big thanks to the 10 contributors who made this release possible. Here are some highlights ✨:
+
+- 🛰 Introduce server-side data source for improved server integration in the Data Grid.
+
+  Supports server-side pagination, sorting and filtering on plain and tree data, and automatic caching.
+
+  To enable, provide a `getRows` function to the `unstable_dataSource` prop on the Data Grid component.
+
+  ```tsx
+  const dataSource = {
+    getRows: async (params: GridServerGetRowsParams) => {
+      const data = await fetch(
+        `https://api.example.com/data?${new URLSearchParams({
+          page: params.page,
+          pageSize: params.pageSize,
+          sortModel: JSON.stringify(params.sortModel),
+          filterModel: JSON.stringify(params.filterModel),
+        }).toString()}`,
+      );
+      return {
+        rows: data.rows,
+        totalRows: data.totalRows,
+      };
+    },
+  }
+  <DataGridPro
+    unstable_dataSource={dataSource}
+    {...otherProps}
+  />
+  ```
+
+  See [server-side data documentation](https://mui.com/x/react-data-grid/server-side-data/) for more details.
+
+- 📈 Support Date data on the BarChart component
+- ↕️ Support custom column sort icons on the Data Grid
+- 🖱️ Support modifying the expansion trigger on the Tree View components
+
+<!--/ HIGHLIGHT_ABOVE_SEPARATOR /-->
+
+### Data Grid
+
+#### `@mui/x-data-grid@7.8.0`
+
+- [DataGrid] Add `columnHeaderSortIcon` slot (#13563) @arminmeh
+- [DataGrid] Fix dimensions lag issue after autosize (#13587) @MBilalShafi
+- [DataGrid] Fix print export failure when `hideFooter` option is set (#13034) @tarunrajput
+
+#### `@mui/x-data-grid-pro@7.8.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-data-grid@7.8.0`, plus:
+
+- [DataGridPro] Fix multi-sorting indicator being cut off (#13625) @KenanYusuf
+- [DataGridPro] Server-side tree data support (#12317) @MBilalShafi
+
+#### `@mui/x-data-grid-premium@7.8.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-data-grid-pro@7.8.0`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@7.8.0`
+
+- [fields] Fix section clearing behavior on Android (#13652) @LukasTy
+
+#### `@mui/x-date-pickers-pro@7.8.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-date-pickers@7.8.0`.
+
+### Charts
+
+#### `@mui/x-charts@7.8.0`
+
+- [charts] Fix line chart props not passing correct event handlers (#13609) @JCQuintas
+- [charts] Support BarChart with `Date` data (#13471) @alexfauquette
+- [charts] Support RTL for y-axis (#13614) @alexfauquette
+- [charts] Use default values instead of non-null assertion to prevent error being thrown (#13637) @JCQuintas
+
+### Tree View
+
+#### `@mui/x-tree-view@7.8.0`
+
+- [TreeView] Add `expansionTrigger` prop (#13533) @noraleonte
+- [TreeView] Support experimental features from plugin's dependencies (#13632) @flaviendelangle
+
+### Docs
+
+- [docs] Add callout for `Luxon` `throwOnInvalid` support (#13621) @LukasTy
+- [docs] Add "Overlays" section to the Data Grid documentation (#13624) @KenanYusuf
+
+### Core
+
+- [core] Add eslint rule to restrict import from `../internals` root (#13633) @JCQuintas
+- [docs-infra] Sync `\_app` folder with monorepo (#13582) @Janpot
+- [license] Allow usage of charts and tree view pro package for old premium licenses (#13619) @flaviendelangle
+
 ## 7.7.1
 
 _Jun 21, 2024_
@@ -44,7 +143,7 @@ Same changes as in `@mui/x-data-grid-pro@7.7.1`.
 - [pickers] Always use the same timezone in the field, the view and the layout components (#13481) @flaviendelangle
 - [pickers] Fix `AdapterDateFnsV3` generated method types (#13464) @alexey-kozlenkov
 - [pickers] Fix controlled `view` behavior (#13552) @LukasTy
-- [TimePicker] Improves RTL verification for the time pickers default views  (#13447) @arthurbalduini
+- [TimePicker] Improves RTL verification for the time pickers default views (#13447) @arthurbalduini
 
 #### `@mui/x-date-pickers-pro@7.7.1` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
 

package/ChartContainer/ChartContainer.d.ts

@@ -20,6 +20,6 @@ declare const ChartContainer: React.ForwardRefExoticComponent<Omit<ChartsSurface
      * An array of plugins defining how to preprocess data.
      * If not provided, the container supports line, bar, scatter and pie charts.
      */
-    plugins?: ChartsPluginType<keyof import("../models/seriesType/config").ChartsSeriesConfig>[] | undefined;
+    plugins?: ChartsPluginType<ChartSeriesType>[];
 } & React.RefAttributes<unknown>>;
 export { ChartContainer };

package/ChartContainer/useChartContainerHooks.d.ts

@@ -3,7 +3,7 @@ import { ChartsPluginType } from '../models';
 import { ChartSeriesType } from '../models/seriesType/config';
 export declare const useChartContainerHooks: (ref: React.ForwardedRef<unknown> | null, plugins?: ChartsPluginType<ChartSeriesType>[]) => {
     svgRef: React.RefObject<SVGSVGElement>;
-    handleRef: ((instance: unknown) => void) | null;
+    handleRef: ((instance: unknown) => void | React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof React.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | null;
     xExtremumGetters: import("../models").ExtremumGettersConfig<keyof import("../models/seriesType/config").ChartsSeriesConfig>;
     yExtremumGetters: import("../models").ExtremumGettersConfig<keyof import("../models/seriesType/config").ChartsSeriesConfig>;
     seriesFormatters: import("../internals").SeriesFormatterConfig<keyof import("../models/seriesType/config").ChartsSeriesConfig>;

package/ChartsAxisHighlight/ChartsAxisHighlight.js

@@ -77,15 +77,30 @@ function ChartsAxisHighlight(props) {
   } = React.useContext(_InteractionProvider.InteractionContext);
   const getXPosition = (0, _useScale.getValueToPositionMapper)(xScale);
   const getYPosition = (0, _useScale.getValueToPositionMapper)(yScale);
+  const axisX = axis.x;
+  const axisY = axis.y;
+  const isBandScaleX = xAxisHighlight === 'band' && axisX !== null && (0, _isBandScale.isBandScale)(xScale);
+  const isBandScaleY = yAxisHighlight === 'band' && axisY !== null && (0, _isBandScale.isBandScale)(yScale);
+  if (process.env.NODE_ENV !== 'production') {
+    const isXError = isBandScaleX && xScale(axisX.value) === undefined;
+    const isYError = isBandScaleY && yScale(axisY.value) === undefined;
+    if (isXError || isYError) {
+      console.error([`MUI X Charts: The position value provided for the axis is not valid for the current scale.`, `This probably means something is wrong with the data passed to the chart.`, `The ChartsAxisHighlight component will not be displayed.`].join('\n'));
+    }
+  }
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(React.Fragment, {
-    children: [xAxisHighlight === 'band' && axis.x !== null && (0, _isBandScale.isBandScale)(xScale) && /*#__PURE__*/(0, _jsxRuntime.jsx)(ChartsAxisHighlightPath, {
-      d: `M ${xScale(axis.x.value) - (xScale.step() - xScale.bandwidth()) / 2} ${yScale.range()[0]} l ${xScale.step()} 0 l 0 ${yScale.range()[1] - yScale.range()[0]} l ${-xScale.step()} 0 Z`,
+    children: [isBandScaleX && xScale(axisX.value) !== undefined && /*#__PURE__*/(0, _jsxRuntime.jsx)(ChartsAxisHighlightPath
+    // @ts-expect-error, xScale value is checked in the statement above
+    , {
+      d: `M ${xScale(axisX.value) - (xScale.step() - xScale.bandwidth()) / 2} ${yScale.range()[0]} l ${xScale.step()} 0 l 0 ${yScale.range()[1] - yScale.range()[0]} l ${-xScale.step()} 0 Z`,
       className: classes.root,
       ownerState: {
         axisHighlight: 'band'
       }
-    }), yAxisHighlight === 'band' && axis.y !== null && (0, _isBandScale.isBandScale)(yScale) && /*#__PURE__*/(0, _jsxRuntime.jsx)(ChartsAxisHighlightPath, {
-      d: `M ${xScale.range()[0]} ${yScale(axis.y.value) - (yScale.step() - yScale.bandwidth()) / 2} l 0 ${yScale.step()} l ${xScale.range()[1] - xScale.range()[0]} 0 l 0 ${-yScale.step()} Z`,
+    }), isBandScaleY && yScale(axisY.value) === undefined && /*#__PURE__*/(0, _jsxRuntime.jsx)(ChartsAxisHighlightPath, {
+      d: `M ${xScale.range()[0]} ${
+      // @ts-expect-error, yScale value is checked in the statement above
+      yScale(axisY.value) - (yScale.step() - yScale.bandwidth()) / 2} l 0 ${yScale.step()} l ${xScale.range()[1] - xScale.range()[0]} 0 l 0 ${-yScale.step()} Z`,
       className: classes.root,
       ownerState: {
         axisHighlight: 'band'

package/ChartsReferenceLine/common.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { ChartsReferenceLineClasses } from './chartsReferenceLineClasses';
 import { ChartsTextStyle } from '../ChartsText';
 import { AxisId } from '../models/axis';

package/ChartsTooltip/ChartsTooltipTable.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export declare const ChartsTooltipPaper: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, Pick<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, keyof import("react").ClassAttributes<HTMLDivElement> | keyof import("react").HTMLAttributes<HTMLDivElement>>, {}>;
 export declare const ChartsTooltipTable: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, Pick<import("react").DetailedHTMLProps<import("react").TableHTMLAttributes<HTMLTableElement>, HTMLTableElement>, keyof import("react").ClassAttributes<HTMLTableElement> | keyof import("react").TableHTMLAttributes<HTMLTableElement>>, {}>;
 export declare const ChartsTooltipRow: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, Pick<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement>, keyof import("react").ClassAttributes<HTMLTableRowElement> | keyof import("react").HTMLAttributes<HTMLTableRowElement>>, {}>;

package/ChartsVoronoiHandler/ChartsVoronoiHandler.js

@@ -12,7 +12,7 @@ var _useEnhancedEffect = _interopRequireDefault(require("@mui/utils/useEnhancedE
 var _InteractionProvider = require("../context/InteractionProvider");
 var _CartesianProvider = require("../context/CartesianProvider");
 var _useScale = require("../hooks/useScale");
-var _utils = require("../internals/utils");
+var _getSVGPoint = require("../internals/getSVGPoint");
 var _hooks = require("../hooks");
 var _context = require("../context");
 var _useSeries = require("../hooks/useSeries");
@@ -105,7 +105,7 @@ function ChartsVoronoiHandler(props) {
     // TODO: A perf optimisation of voronoi could be to use the last point as the initial point for the next search.
     function getClosestPoint(event) {
       // Get mouse coordinate in global SVG space
-      const svgPoint = (0, _utils.getSVGPoint)(svgRef.current, event);
+      const svgPoint = (0, _getSVGPoint.getSVGPoint)(svgRef.current, event);
       const outsideX = svgPoint.x < left || svgPoint.x > left + width;
       const outsideY = svgPoint.y < top || svgPoint.y > top + height;
       if (outsideX || outsideY) {

package/ChartsYAxis/ChartsYAxis.js

@@ -90,6 +90,7 @@ function ChartsYAxis(inProps) {
     tickLabelInterval
   } = defaultizedProps;
   const theme = (0, _styles.useTheme)();
+  const isRTL = theme.direction === 'rtl';
   const classes = useUtilityClasses((0, _extends2.default)({}, defaultizedProps, {
     theme
   }));
@@ -117,13 +118,14 @@ function ChartsYAxis(inProps) {
   const Tick = slots?.axisTick ?? 'line';
   const TickLabel = slots?.axisTickLabel ?? _ChartsText.ChartsText;
   const Label = slots?.axisLabel ?? _ChartsText.ChartsText;
+  const revertAnchor = !isRTL && position === 'right' || isRTL && position !== 'right';
   const axisTickLabelProps = (0, _utils.useSlotProps)({
     elementType: TickLabel,
     externalSlotProps: slotProps?.axisTickLabel,
     additionalProps: {
       style: (0, _extends2.default)({
         fontSize: tickFontSize,
-        textAnchor: position === 'right' ? 'start' : 'end',
+        textAnchor: revertAnchor ? 'start' : 'end',
         dominantBaseline: 'central'
       }, tickLabelStyle)
     },

package/Gauge/GaugeProvider.d.ts

@@ -112,6 +112,6 @@ export declare function useGaugeState(): Required<GaugeConfig> & ProcessedCircul
     /**
      * The angle (rad) associated to the current value.
      */
-    valueAngle: number | null;
+    valueAngle: null | number;
 };
 export {};