[charts] Expose `<ChartType>Series` type for all chart types #18805

bernardobelchior · 2025-07-15T07:37:59Z

Part of #16802.

Expose LineSeries, BarSeries, etc, so that it's easy to do something like:

const series = [/* series */] satisfies LineSeries[]

function Component() {
  return <LineChart series={series} />
}

Also replaced the old BarSeriesType pages with BarSeries as the latter are the ones that are exposed to the user.

Added some missing docs as well.

mui-bot · 2025-07-15T07:40:15Z

Deploy preview: https://deploy-preview-18805--material-ui-x.netlify.app/

Bundle size report

Total Size Change: 0B^(0.00%) - Total Gzip Change: ▼-81B^(0.00%)
Files: 122 total (0 added, 0 removed, 28 changed)

Show details for 100 more bundles (22 more not shown)

@mui/x-charts parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts-pro parsed: 0B^(0.00%) gzip: ▼-3B^(0.00%)
@mui/x-charts-pro/BarChartPro parsed: 0B^(0.00%) gzip: ▼-3B^(0.00%)
@mui/x-charts-pro/ChartContainerPro parsed: 0B^(0.00%) gzip: ▼-3B^(-0.01%)
@mui/x-charts-pro/ChartDataProviderPro parsed: 0B^(0.00%) gzip: ▼-4B^(-0.01%)
@mui/x-charts-pro/ChartsToolbarPro parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts-pro/ChartZoomSlider parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts-pro/FunnelChart parsed: 0B^(0.00%) gzip: ▼-3B^(0.00%)
@mui/x-charts-pro/Heatmap parsed: 0B^(0.00%) gzip: ▼-3B^(0.00%)
@mui/x-charts-pro/LineChartPro parsed: 0B^(0.00%) gzip: ▼-2B^(0.00%)
@mui/x-charts-pro/PieChartPro parsed: 0B^(0.00%) gzip: ▼-2B^(0.00%)
@mui/x-charts-pro/RadarChartPro parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts-pro/ScatterChartPro parsed: 0B^(0.00%) gzip: ▼-2B^(0.00%)
@mui/x-charts/BarChart parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartContainer parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartDataProvider parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsAxis parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsAxisHighlight parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsClipPath parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsGrid parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsLabel parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsLegend parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsLocalizationProvider parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsOverlay parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsReferenceLine parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsSurface parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsText parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsTooltip parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsXAxis parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ChartsYAxis parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/Gauge parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/LineChart parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/PieChart parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/RadarChart parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/ScatterChart parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/SparkLineChart parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-charts/Toolbar parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-data-grid parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-data-grid-premium parsed: 0B^(0.00%) gzip: ▼-2B^(0.00%)
@mui/x-data-grid-premium/DataGridPremium parsed: 0B^(0.00%) gzip: ▼-4B^(0.00%)
@mui/x-data-grid-pro parsed: 0B^(0.00%) gzip: ▼-2B^(0.00%)
@mui/x-data-grid-pro/DataGridPro parsed: 0B^(0.00%) gzip: ▼-2B^(0.00%)
@mui/x-data-grid/DataGrid parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro parsed: 0B^(0.00%) gzip: ▼-4B^(0.00%)
@mui/x-date-pickers-pro/AdapterDateFns parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/AdapterDateFnsJalali parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/AdapterDayjs parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/AdapterLuxon parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/AdapterMoment parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/AdapterMomentHijri parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/AdapterMomentJalaali parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/DateRangeCalendar parsed: 0B^(0.00%) gzip: ▼-2B^(-0.01%)
@mui/x-date-pickers-pro/DateRangePicker parsed: 0B^(0.00%) gzip: ▼-5B^(-0.01%)
@mui/x-date-pickers-pro/DateRangePickerDay parsed: 0B^(0.00%) gzip: ▼-1B^(-0.01%)
@mui/x-date-pickers-pro/DateRangePickerDay2 parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/DateTimeRangePicker parsed: 0B^(0.00%) gzip: ▼-4B^(-0.01%)
@mui/x-date-pickers-pro/DesktopDateRangePicker parsed: 0B^(0.00%) gzip: ▼-4B^(-0.01%)
@mui/x-date-pickers-pro/DesktopDateTimeRangePicker parsed: 0B^(0.00%) gzip: ▼-4B^(-0.01%)
@mui/x-date-pickers-pro/DesktopTimeRangePicker parsed: 0B^(0.00%) gzip: ▼-4B^(-0.01%)
@mui/x-date-pickers-pro/LocalizationProvider parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/MobileDateRangePicker parsed: 0B^(0.00%) gzip: ▼-4B^(-0.01%)
@mui/x-date-pickers-pro/MobileDateTimeRangePicker parsed: 0B^(0.00%) gzip: ▼-4B^(-0.01%)
@mui/x-date-pickers-pro/MobileTimeRangePicker parsed: 0B^(0.00%) gzip: ▼-2B^(0.00%)
@mui/x-date-pickers-pro/MultiInputDateRangeField parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/MultiInputDateTimeRangeField parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/MultiInputTimeRangeField parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/PickersRangeCalendarHeader parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/SingleInputDateRangeField parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/SingleInputDateTimeRangeField parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/SingleInputTimeRangeField parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers-pro/StaticDateRangePicker parsed: 0B^(0.00%) gzip: ▼-2B^(-0.01%)
@mui/x-date-pickers-pro/TimeRangePicker parsed: 0B^(0.00%) gzip: ▼-2B^(0.00%)
@mui/x-date-pickers/AdapterDateFns parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/AdapterDateFnsBase parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/AdapterDateFnsJalali parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/AdapterDayjs parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/AdapterLuxon parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/AdapterMoment parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/AdapterMomentHijri parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/AdapterMomentJalaali parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DateCalendar parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DateField parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DatePicker parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DateTimeField parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DateTimePicker parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DayCalendarSkeleton parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DesktopDatePicker parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DesktopDateTimePicker parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DesktopTimePicker parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/DigitalClock parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/LocalizationProvider parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/MobileDatePicker parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/MobileDateTimePicker parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/MobileTimePicker parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/MonthCalendar parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/MultiSectionDigitalClock parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/PickerDay2 parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/PickersActionBar parsed: 0B^(0.00%) gzip: 0B^(0.00%)
@mui/x-date-pickers/PickersCalendarHeader parsed: 0B^(0.00%) gzip: 0B^(0.00%)

Details of bundle changes

Generated by 🚫 dangerJS against 1ed1bf2

codspeed-hq · 2025-07-15T08:05:30Z

CodSpeed Performance Report

Merging #18805 will not alter performance

_{Comparing bernardobelchior:simplify-series-types (1ed1bf2) with master (c2c189c)}

Summary

✅ 10 untouched benchmarks

alexfauquette

Looks good. If you want to go further, I by searching SeriesType in the docs/data folder, I noticed some places where the new type could be used.

I left comments where I found what I assume are inconsistencies

alexfauquette · 2025-07-15T15:09:07Z

docs/data/pages.ts

+                      { pathname: '/x/api/charts/bar-series', title: 'BarSeries' },
+                      { pathname: '/x/api/charts/funnel-series', title: 'FunnelSeries' },
+                      { pathname: '/x/api/charts/heatmap-series', title: 'HeatmapSeries' },
+                      { pathname: '/x/api/charts/line-series', title: 'LineSeries' },
+                      { pathname: '/x/api/charts/pie-series', title: 'PieSeries' },
+                      { pathname: '/x/api/charts/radar-series', title: 'RadarSeries' },
+                      { pathname: '/x/api/charts/scatter-series', title: 'ScatterSeries' },


You could add them in the pocs/public/_redirects file such that links to previous page still work

/x/api/charts/scatter-series-type/ /x/api/charts/scatter-series/ 301

As I was adding these, I realized that maybe we want to keep the old pages?

The SeriesType is required for the ChartDataProvider as that component requires the type to be specified.

Should we keep both?

It feels a bit weird to have two API pages just because one property can be optional

Yeah, true. I'll keep it as is, then

packages/x-charts-pro/src/Heatmap/Heatmap.tsx

packages/x-charts/src/RadarChart/RadarDataProvider/RadarDataProvider.tsx

bernardobelchior added 2 commits July 15, 2025 09:28

[charts] Expose <ChartType>Series type for all chart types

fbfd9c4

Gen static

6e3940d

Gen pages, export missing types.

5343d86

bernardobelchior added type: enhancement It’s an improvement, but we can’t make up our mind whether it's a bug fix or a new feature. scope: charts Changes related to the charts. labels Jul 15, 2025

bernardobelchior changed the title ~~[charts] Expose <ChartType>Series type for all chart types~~ [charts] Expose <ChartType>Series type for all chart types Jul 15, 2025

bernardobelchior added 2 commits July 15, 2025 10:26

Update docs pages

0b798a0

Experiment with SimplifyDeep

377b170

bernardobelchior force-pushed the simplify-series-types branch from b5a419e to 377b170 Compare July 15, 2025 08:57

bernardobelchior added 2 commits July 15, 2025 11:11

Revert simplifydeep

8fe4e18

Add missing docs

9a79e1e

bernardobelchior marked this pull request as ready for review July 15, 2025 09:30

bernardobelchior requested review from alexfauquette and JCQuintas as code owners July 15, 2025 09:30

alexfauquette approved these changes Jul 15, 2025

View reviewed changes

bernardobelchior added 2 commits July 16, 2025 15:13

Replace *SeriesType with *Series usage where possible

4c7d9c6

Add redirects

1ed1bf2

bernardobelchior merged commit cc7e066 into mui:master Jul 16, 2025
24 checks passed

bernardobelchior deleted the simplify-series-types branch July 16, 2025 14:32

LukasTy mentioned this pull request Jul 17, 2025

[pickers] Revert CSS changes #18834

Merged

1 task

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

[charts] Expose `<ChartType>Series` type for all chart types #18805

[charts] Expose `<ChartType>Series` type for all chart types #18805

Uh oh!

bernardobelchior commented Jul 15, 2025 •

edited

Loading

Uh oh!

mui-bot commented Jul 15, 2025 •

edited

Loading

Uh oh!

codspeed-hq bot commented Jul 15, 2025 •

edited

Loading

Uh oh!

alexfauquette left a comment

Uh oh!

alexfauquette Jul 15, 2025

Uh oh!

bernardobelchior Jul 16, 2025

Uh oh!

alexfauquette Jul 16, 2025

Uh oh!

bernardobelchior Jul 16, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

[charts] Expose <ChartType>Series type for all chart types #18805

[charts] Expose <ChartType>Series type for all chart types #18805

Uh oh!

Conversation

bernardobelchior commented Jul 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mui-bot commented Jul 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle size report

Uh oh!

codspeed-hq bot commented Jul 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CodSpeed Performance Report

Merging #18805 will not alter performance

Summary

Uh oh!

alexfauquette left a comment

Choose a reason for hiding this comment

Uh oh!

alexfauquette Jul 15, 2025

Choose a reason for hiding this comment

Uh oh!

bernardobelchior Jul 16, 2025

Choose a reason for hiding this comment

Uh oh!

alexfauquette Jul 16, 2025

Choose a reason for hiding this comment

Uh oh!

bernardobelchior Jul 16, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

[charts] Expose `<ChartType>Series` type for all chart types #18805

[charts] Expose `<ChartType>Series` type for all chart types #18805

bernardobelchior commented Jul 15, 2025 •

edited

Loading

mui-bot commented Jul 15, 2025 •

edited

Loading

codspeed-hq bot commented Jul 15, 2025 •

edited

Loading