@mui/docs 7.3.1 → 7.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/Ad/Ad.js CHANGED
@@ -64,22 +64,26 @@ const inHouseAds = [{
64
64
  name: 'templates',
65
65
  link: 'https://mui.com/store/?utm_source=docs&utm_medium=referral&utm_campaign=in-house-templates',
66
66
  img: '/static/ads-in-house/themes-2.jpg',
67
- description: '<b>Premium Templates</b>. Start your project with the best templates for admins, dashboards, and more.'
67
+ descriptionHeader: 'Premium Templates',
68
+ description: 'Start your project with the best templates for admins, dashboards, and more.'
68
69
  }, {
69
70
  name: 'themes',
70
71
  link: 'https://mui.com/store/?utm_source=docs&utm_medium=referral&utm_campaign=in-house-themes',
71
72
  img: '/static/ads-in-house/themes.png',
72
- description: '<b>Premium Themes</b>. Kickstart your application development with a ready-made theme.'
73
+ descriptionHeader: 'Premium Themes',
74
+ description: 'Kickstart your application development with a ready-made theme.'
73
75
  }, {
74
76
  name: 'tidelift',
75
77
  link: 'https://tidelift.com/?utm_source=npm-material-ui&utm_medium=referral&utm_campaign=enterprise&utm_content=ad',
76
78
  img: '/static/ads-in-house/tidelift.png',
77
- description: '<b>MUI for enterprise</b>. Save time and reduce risk. Managed open source — backed by maintainers.'
79
+ descriptionHeader: 'MUI for enterprise',
80
+ description: 'Save time and reduce risk. Managed open source — backed by maintainers.'
78
81
  }, {
79
82
  name: 'figma',
80
83
  link: 'https://mui.com/store/items/figma-react/?utm_source=docs&utm_medium=referral&utm_campaign=in-house-figma',
81
84
  img: '/static/ads-in-house/figma.png',
82
- description: '<b>For Figma</b>. A large UI kit with over 600 handcrafted Material UI, MUI X, Joy UI components 🎨.'
85
+ descriptionHeader: 'For Figma',
86
+ description: 'A large UI kit with over 600 handcrafted Material UI, MUI X, Joy UI components 🎨.'
83
87
  }];
84
88
  class AdErrorBoundary extends React.Component {
85
89
  state = {
package/Ad/AdCarbon.js CHANGED
@@ -117,7 +117,8 @@ function AdCarbonInline() {
117
117
  link: ad.statlink,
118
118
  img: ad.image,
119
119
  name: ad.company,
120
- description: `<strong>${ad.company}</strong> - ${ad.description}`,
120
+ descriptionHeader: ad.company,
121
+ description: ad.description,
121
122
  poweredby: 'Carbon',
122
123
  label: 'carbon-demo-inline'
123
124
  }
package/Ad/AdDisplay.d.ts CHANGED
@@ -3,6 +3,7 @@ export interface AdParameters {
3
3
  name: string;
4
4
  link: string;
5
5
  img?: string;
6
+ descriptionHeader: string;
6
7
  description: string;
7
8
  poweredby: string;
8
9
  label: string;
package/Ad/AdDisplay.js CHANGED
@@ -60,8 +60,6 @@ function AdDisplay(props) {
60
60
  }, [GADisplayRatio, ad.label]);
61
61
  const shape = shapeProp === 'auto' ? _AdManager.adShape : shapeProp;
62
62
  const Root = shape === 'image' ? ImageShape : InlineShape;
63
-
64
- /* eslint-disable react/no-danger */
65
63
  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(Root, {
66
64
  className: className,
67
65
  children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("a", {
@@ -81,16 +79,15 @@ function AdDisplay(props) {
81
79
  src: ad.img,
82
80
  alt: ad.name
83
81
  })
84
- }), /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
82
+ }), /*#__PURE__*/(0, _jsxRuntime.jsxs)("span", {
85
83
  className: "AdDisplay-description",
86
- dangerouslySetInnerHTML: {
87
- __html: ad.description
88
- }
84
+ children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("strong", {
85
+ children: ad.descriptionHeader
86
+ }), " - ", ad.description]
89
87
  })]
90
88
  }), /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
91
89
  className: "AdDisplay-poweredby",
92
90
  children: t('adPublisher').replace('{{publisher}}', ad.poweredby)
93
91
  })]
94
92
  });
95
- /* eslint-enable react/no-danger */
96
93
  }
package/CHANGELOG.md CHANGED
@@ -1,5 +1,154 @@
1
1
  # [Versions](https://mui.com/versions/)
2
2
 
3
+ ## 7.3.3
4
+
5
+ <!-- generated comparing v7.3.2..master -->
6
+
7
+ _Sep 30, 2025_
8
+
9
+ A big thanks to the 14 contributors who made this release possible.
10
+
11
+ ### `@mui/material@7.3.3`
12
+
13
+ - [Autocomplete] Sync highlighted index when popup is opened (#46894) @ZeeshanTamboli
14
+ - [CircularProgress] Add track slot via enableTrackSlot (#46907) @monam2
15
+ - [locale] Split locales into separate files (#46933) @christopherschroer
16
+ - [Tabs] Fix not scrolling to correct tab after refresh when auto scrollable (#46869) @Jayesh-11
17
+
18
+ ### Docs
19
+
20
+ - Add a guide for building extensible themes (#46896) @siriwatknp
21
+ - Add v7 community course to resources page (#46944) @alelthomas
22
+ - Improve performance of Default Theme Viewer (#46841) @sai6855
23
+ - Fix typo in blog component MainContent (#46868) @jonyen
24
+ - [Steppers] Replace TransitionProps with slotProps.transition (#46898) @sai6855
25
+
26
+ ### Core
27
+
28
+ - [blog] Fix year in Punta Cana retreat post (#46943) @mapache-salvaje
29
+ - [blog] Punta Cana retreat post (#46892) @mapache-salvaje
30
+ - [code-infra] Publish from CI (#46851) @Janpot
31
+ - [code-infra] Convert reportBrokenLink script to ts (#47002) @brijeshb42
32
+ - [code-infra] Update module resolution for typescript@next (#46940) @Janpot
33
+ - [code-infra] Run continuous releases during ci-check (#46948) @Janpot
34
+ - [code-infra] Fix github actions check for continuous release (#46941) @Janpot
35
+ - [code-infra] Address high/critical dependabot reports (#46937) @Janpot
36
+ - [code-infra] Update ci.yml triggers (#46860) @Janpot
37
+ - [code-infra] Exact match for renovate file name (#46916) @Janpot
38
+ - [code-infra] Disable dependency update for `@material-ui/core` in codemod (#46899) @Janpot
39
+ - [code-infra] Transpile `assertion-error` in karma tests (#46909) @Janpot
40
+ - [code-infra] Disable browserstack on circleci cron jobs (#46905) @Janpot
41
+ - [code-infra] Remove `copy-files` command usage from packages (#46902) @brijeshb42
42
+ - [code-infra] Low-hanging ts conversion (#46903) @Janpot
43
+ - [code-infra] Bring batch of changes from vitest PR (#46795) @Janpot
44
+ - [code-infra] Remove dependency on `fs-extra` (#46755) @bernardobelchior
45
+ - [code-infra] Make error code extraction independent of build (#46865) @brijeshb42
46
+ - [docs-infra] Fix markdown generation script to find correct files (#46954) @siriwatknp
47
+ - [docs-infra] Fix unnecessary redirects (#46951) @Janpot
48
+ - [docs-infra] Remove `dangerouslySetInnerHTML` for ad description (#46936) @Janpot
49
+ - [docs-infra] Display "View as Markdown" only on Material UI (#46861) @siriwatknp
50
+ - [infra] Fix JSON files not being imported in TS demos (#47000) @bernardobelchior
51
+ - [infra] Turn `literal | (string & {})` to `PropTypes.string` (#46934) @siriwatknp
52
+ - [infra] Bump node.js version and make local usage strict (#46834) @brijeshb42
53
+ - [infra] Remove "main" fields from publishable packages (#46856) @brijeshb42
54
+ - [internal] Refactor `useForkRef` TS types: tighten `cleanupRef` and simplify ref typing (#46967) @wo-o29
55
+ - [internal] Fix naming to match convention (2099cb0) @oliviertassinari
56
+ - [internal] Fix naming to match convention (29aad62) @oliviertassinari
57
+ - [internal] Use same option as other repositories (eabda77) @oliviertassinari
58
+ - [internal] Normalize <meta name='viewport' (9d1922a) @oliviertassinari
59
+ - [internal] Normalize charset='utf-8' (f1aae00) @oliviertassinari
60
+ - [test] Split infinitive (0237fda) @oliviertassinari
61
+
62
+ All contributors of this release in alphabetical order: @alelthomas, @bernardobelchior, @brijeshb42, @christopherschroer, @Janpot, @Jayesh-11, @jonyen, @mapache-salvaje, @monam2, @oliviertassinari, @sai6855, @siriwatknp, @wo-o29, @ZeeshanTamboli
63
+
64
+ ## 7.3.2
65
+
66
+ <!-- generated comparing v7.3.1..master -->
67
+
68
+ _Sep 1, 2025_
69
+
70
+ A big thanks to the 16 contributors who made this release possible.
71
+
72
+ ### `@mui/material@7.3.2`
73
+
74
+ - [Chip] Remove unnecessary optional chaining from key event handlers (#46752) @ZeeshanTamboli
75
+ - [Drawer] Add dialog role and aria-modal for `temporary` variant (#46690) @Yashkanekar
76
+ - [PaginationItem] Add slot descriptions and default components in API documentation (#46677) @sai6855
77
+ - [utils] Remove duplicate isHostComponent function (#46721) @frontman-git
78
+
79
+ ### `@mui/codemod@7.3.2`
80
+
81
+ - Add codemod to convert top-level to path imports (#46657) @neemski
82
+
83
+ ### Docs
84
+
85
+ - Remove outdated Next.js lint command (#46847) @oliviertassinari
86
+ - Add `View as Markdown` to component link header (#46835) @siriwatknp
87
+ - Add a link to open `llms.txt` (#46832) @siriwatknp
88
+ - Fix typos in Material UI API docs (#46787) @noritaka1166
89
+ - Fix typo extra "to" word (#46783) @danpeleg4
90
+ - Remove past employees from about page (#46780) @Janpot
91
+ - Fix typos in `docs/pages` folder (#46761) @noritaka1166
92
+ - Add clarification on `react-is` resolution with Material UI v6 and v7 for React 18 and below (#46633) @alisasanib
93
+ - Fix typos in `joy` and `utils` package (#46713) @noritaka1166
94
+ - [autocomplete] Fix console in unstyled demo (#46804) @oliviertassinari
95
+ - [autocomplete] Fix Google Maps brand attribution (#46803) @oliviertassinari
96
+ - [autocomplete] Fix header sentence case (#46805) @oliviertassinari
97
+ - [autocomplete] Fix Google Maps demo (#46793) @oliviertassinari
98
+ - [Select] Fix labeling issues in grouped select demo (#46722) @mj12albert
99
+ - [table] Remove outdated unstyled section (#46786) @mj12albert
100
+ - [TextField] Add note about removal of `sizeMedium` class from InputLabel in v7 upgrade guide (#46693) @checcoux
101
+
102
+ ### Core
103
+
104
+ - Update `cipher-base` transitive dependency (#46800) @Janpot
105
+ - [charts] Marked Treemap chart as Pro (#46691) @prakhargupta1
106
+ - [code-infra] Remove some csbci references (#46797) @Janpot
107
+ - [code-infra] update build tool (#46801) @Janpot
108
+ - [code-infra] Align pkg.pr.new with other projects (#46467) @Janpot
109
+ - [code-infra] Prepare for incoming `execa` update (#46781) @Janpot
110
+ - [code-infra] Remove `@mui/internal-babel-plugin-resolve-imports` override config (#46754) @ZeeshanTamboli
111
+ - [core] Fix typo in `docs/mui-vale` folder (#46760) @noritaka1166
112
+ - [core] Fix typos in `docs/data/material` folder (#46757) @noritaka1166
113
+ - [core] Fix typos in `netlify` folder (#46756) @noritaka1166
114
+ - [core] Upgrade brace-expansion (#46747) @oliviertassinari
115
+ - [core] Fix typos in Joy UI docs and `test` folder (#46738) @noritaka1166
116
+ - [core] Upgrade KaTeX (#46731) @oliviertassinari
117
+ - [core] Avoid Polynomial regex backtracking (#46732) @oliviertassinari
118
+ - [core] Remove dead @toolpad/core dependency (#46730) @oliviertassinari
119
+ - [core] Fix typos in `markdown` and `system` packages (#46720) @noritaka1166
120
+ - [core] Fix typos in `api-docs-builder` package (#46719) @noritaka1166
121
+ - [core] Fix typos in `codemod` package (#46715) @noritaka1166
122
+ - [core] pnpm prettier:all (#46685) @oliviertassinari
123
+ - [docs-infra] Set origin to generated `llms.txt` (#46833) @siriwatknp
124
+ - [docs-infra] Fix AbortController error (#46408) @oliviertassinari
125
+ - [docs-infra] Block than more feedback submissions (#46824) @oliviertassinari
126
+ - [docs-infra] Fix ESLint references (#46680) @oliviertassinari
127
+ - [infra] Migrate away from airbnb's eslint config (#46794) @brijeshb42
128
+ - [infra] Remove `fs-extra` from docs scripts (#46749) @bernardobelchior
129
+ - [infra] Remove dependency on `react-spring` (but keep `@react-spring/web`) (#46748) @bernardobelchior
130
+ - [infra] Remove `fs-extra` from `mui-icons-material` (#46745) @bernardobelchior
131
+ - [infra] Remove `api-docs-builder` dependency on `fs-extra` (#46742) @bernardobelchior
132
+ - [infra] Migrate build command to code-infra (#46614) @brijeshb42
133
+ - [infra] move testBuiltTypes step (#46735) @Janpot
134
+ - [infra] Remove `fs-extra` from `netlify-plugin-cache-docs` (#46740) @bernardobelchior
135
+ - [infra] Supply `document` to `userEvent.setup()` (#46714) @Janpot
136
+ - [infra] Remove useless test step (#46679) @Janpot
137
+ - [infra] Stagger daily cron jobs to avoid browserstack timeouts (#46676) @Janpot
138
+ - [internal] Improve useControlled() strict mode handling (#46807) @oliviertassinari
139
+ - [internal] Sentence case (55a9d8f) @oliviertassinari
140
+ - [internal] Fix typos in code comments (#46784) @noritaka1166
141
+ - [internal] Fix console regression in dev mode (925f02b) @oliviertassinari
142
+ - [internal] Prettier all if dependencies changes (1f63b03) @oliviertassinari
143
+ - [internal] Fix renovate.json (84be632) @oliviertassinari
144
+ - [internal] Polish renovate schedule (#46727) @oliviertassinari
145
+ - [internal] Update link to GitHub labels (8ab4813) @oliviertassinari
146
+ - [internal] Bump brace-expansion (06de338) @oliviertassinari
147
+ - [internal] Normalize Action description (4a2fbcb) @oliviertassinari
148
+ - [toolpad] Remove it from website and docs (#46595) @prakhargupta1
149
+
150
+ All contributors of this release in alphabetical order: @alisasanib, @bernardobelchior, @brijeshb42, @checcoux, @danpeleg4, @frontman-git, @Janpot, @mj12albert, @neemski, @noritaka1166, @oliviertassinari, @prakhargupta1, @sai6855, @siriwatknp, @Yashkanekar, @ZeeshanTamboli
151
+
3
152
  ## 7.3.1
4
153
 
5
154
  <!-- generated comparing v7.3.0..master -->
@@ -71,7 +220,7 @@ A big thanks to the 24 contributors who made this release possible. Here are som
71
220
  - Fix unpinned version regression (#46438) @oliviertassinari
72
221
  - [code-infra] Accomodate build requirements from mui-x (#46551) @brijeshb42
73
222
  - [code-infra] Extend renovate preset from infra repo (#46483) @brijeshb42
74
- - [code-infra] Use flat eslint config (#46258) @brijeshb42
223
+ - [code-infra] Use flat ESLint config (#46258) @brijeshb42
75
224
  - [docs-infra] Remove comment saving in G-sheet option (#46617) @alexfauquette
76
225
  - [docs-infra] Move `Open in MUI Chat` to Demo toolbar and adjust styles (#46579) @siriwatknp
77
226
  - [docs-infra] Fix codeblock issues (#46323) @atharva3333
@@ -143,11 +292,11 @@ A big thanks to the 17 contributors who made this release possible. Here are the
143
292
  ### Core
144
293
 
145
294
  - pnpm docs:sync-team (3641a0b) @oliviertassinari
146
- - Add cross-env to eslint script (#46358) @ZeeshanTamboli
295
+ - Add cross-env to ESLint script (#46358) @ZeeshanTamboli
147
296
  - Support merging of className and style from theme (#45975) @sai6855
148
297
  - [code-infra] Create bundle size package (#45911) @Janpot
149
298
  - [docs-infra] Add a script to generate Material UI `llms.txt` and docs markdown. (#46308) @siriwatknp
150
- - [docs-infra] Fix stackblitz for js projects (#46220) @Janpot
299
+ - [docs-infra] Fix StackBlitz for js projects (#46220) @Janpot
151
300
  - [infra] Add emotion as external for bundle monitor (#46372) @Janpot
152
301
  - [infra] Create update PR on every canary publish for internal packages (#46367) @Janpot
153
302
  - [infra] Remove deprecated esmExternals (#46365) @Janpot
@@ -225,7 +374,7 @@ A big thanks to the 15 contributors who made this release possible.
225
374
  ### Core
226
375
 
227
376
  - [code-infra] Add plugin to check for index file access (#46178) @Janpot
228
- - [code-infra] Bump eslint to v9 (#46222) @brijeshb42
377
+ - [code-infra] Bump ESLint to v9 (#46222) @brijeshb42
229
378
  - [code-infra] Move packages to mui/mui-public (#46155) @Janpot
230
379
  - [code-infra] Move `chai` to peerDep (#46227) @JCQuintas
231
380
  - [code-infra] Avoid loading barrel file during type checking (#46177) @Janpot
@@ -7,11 +7,13 @@ Object.defineProperty(exports, "__esModule", {
7
7
  });
8
8
  exports.ComponentLinkHeader = ComponentLinkHeader;
9
9
  var React = _interopRequireWildcard(require("react"));
10
+ var _router = require("next/router");
10
11
  var _Chip = _interopRequireDefault(require("@mui/material/Chip"));
11
12
  var _Tooltip = _interopRequireDefault(require("@mui/material/Tooltip"));
12
13
  var _ChatRounded2 = _interopRequireDefault(require("@mui/icons-material/ChatRounded"));
13
14
  var _GitHub = _interopRequireDefault(require("@mui/icons-material/GitHub"));
14
15
  var _styles = require("@mui/material/styles");
16
+ var _MarkdownIcon2 = _interopRequireDefault(require("../svgIcons/MarkdownIcon"));
15
17
  var _SketchIcon = _interopRequireDefault(require("../svgIcons/SketchIcon"));
16
18
  var _FigmaIcon = _interopRequireDefault(require("../svgIcons/FigmaIcon"));
17
19
  var _BundleSizeIcon2 = _interopRequireDefault(require("../svgIcons/BundleSizeIcon"));
@@ -19,7 +21,7 @@ var _W3CIcon2 = _interopRequireDefault(require("../svgIcons/W3CIcon"));
19
21
  var _MaterialDesignIcon2 = _interopRequireDefault(require("../svgIcons/MaterialDesignIcon"));
20
22
  var _i18n = require("../i18n");
21
23
  var _jsxRuntime = require("react/jsx-runtime");
22
- var _ChatRounded, _BundleSizeIcon, _GitHubIcon, _W3CIcon, _MaterialDesignIcon, _li, _li2;
24
+ var _MarkdownIcon, _ChatRounded, _BundleSizeIcon, _GitHubIcon, _W3CIcon, _MaterialDesignIcon, _li, _li2;
23
25
  const Root = (0, _styles.styled)('ul')(({
24
26
  theme
25
27
  }) => ({
@@ -57,9 +59,25 @@ function ComponentLinkHeader(props) {
57
59
  design
58
60
  } = props;
59
61
  const t = (0, _i18n.useTranslate)();
62
+ const router = (0, _router.useRouter)();
60
63
  const packageName = headers.packageName ?? defaultPackageNames[headers.productId] ?? '@mui/material';
61
64
  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(Root, {
62
- children: [headers.githubLabel ? /*#__PURE__*/(0, _jsxRuntime.jsx)("li", {
65
+ children: [packageName === '@mui/material' && /*#__PURE__*/(0, _jsxRuntime.jsx)("li", {
66
+ children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Chip.default, {
67
+ clickable: true,
68
+ role: undefined,
69
+ component: "a",
70
+ size: "small",
71
+ variant: "outlined",
72
+ href: `${router.pathname}.md`,
73
+ icon: _MarkdownIcon || (_MarkdownIcon = /*#__PURE__*/(0, _jsxRuntime.jsx)(_MarkdownIcon2.default, {})),
74
+ "data-ga-event-category": "ComponentLinkHeader",
75
+ "data-ga-event-action": "click",
76
+ "data-ga-event-label": "Markdown",
77
+ "data-ga-event-split": "0.1",
78
+ label: "View as Markdown"
79
+ })
80
+ }), headers.githubLabel ? /*#__PURE__*/(0, _jsxRuntime.jsx)("li", {
63
81
  children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Chip.default, {
64
82
  clickable: true,
65
83
  role: undefined,
package/esm/Ad/Ad.js CHANGED
@@ -55,22 +55,26 @@ const inHouseAds = [{
55
55
  name: 'templates',
56
56
  link: 'https://mui.com/store/?utm_source=docs&utm_medium=referral&utm_campaign=in-house-templates',
57
57
  img: '/static/ads-in-house/themes-2.jpg',
58
- description: '<b>Premium Templates</b>. Start your project with the best templates for admins, dashboards, and more.'
58
+ descriptionHeader: 'Premium Templates',
59
+ description: 'Start your project with the best templates for admins, dashboards, and more.'
59
60
  }, {
60
61
  name: 'themes',
61
62
  link: 'https://mui.com/store/?utm_source=docs&utm_medium=referral&utm_campaign=in-house-themes',
62
63
  img: '/static/ads-in-house/themes.png',
63
- description: '<b>Premium Themes</b>. Kickstart your application development with a ready-made theme.'
64
+ descriptionHeader: 'Premium Themes',
65
+ description: 'Kickstart your application development with a ready-made theme.'
64
66
  }, {
65
67
  name: 'tidelift',
66
68
  link: 'https://tidelift.com/?utm_source=npm-material-ui&utm_medium=referral&utm_campaign=enterprise&utm_content=ad',
67
69
  img: '/static/ads-in-house/tidelift.png',
68
- description: '<b>MUI for enterprise</b>. Save time and reduce risk. Managed open source — backed by maintainers.'
70
+ descriptionHeader: 'MUI for enterprise',
71
+ description: 'Save time and reduce risk. Managed open source — backed by maintainers.'
69
72
  }, {
70
73
  name: 'figma',
71
74
  link: 'https://mui.com/store/items/figma-react/?utm_source=docs&utm_medium=referral&utm_campaign=in-house-figma',
72
75
  img: '/static/ads-in-house/figma.png',
73
- description: '<b>For Figma</b>. A large UI kit with over 600 handcrafted Material UI, MUI X, Joy UI components 🎨.'
76
+ descriptionHeader: 'For Figma',
77
+ description: 'A large UI kit with over 600 handcrafted Material UI, MUI X, Joy UI components 🎨.'
74
78
  }];
75
79
  class AdErrorBoundary extends React.Component {
76
80
  state = {
@@ -108,7 +108,8 @@ export function AdCarbonInline() {
108
108
  link: ad.statlink,
109
109
  img: ad.image,
110
110
  name: ad.company,
111
- description: `<strong>${ad.company}</strong> - ${ad.description}`,
111
+ descriptionHeader: ad.company,
112
+ description: ad.description,
112
113
  poweredby: 'Carbon',
113
114
  label: 'carbon-demo-inline'
114
115
  }
@@ -3,6 +3,7 @@ export interface AdParameters {
3
3
  name: string;
4
4
  link: string;
5
5
  img?: string;
6
+ descriptionHeader: string;
6
7
  description: string;
7
8
  poweredby: string;
8
9
  label: string;
@@ -53,8 +53,6 @@ export default function AdDisplay(props) {
53
53
  }, [GADisplayRatio, ad.label]);
54
54
  const shape = shapeProp === 'auto' ? adShape : shapeProp;
55
55
  const Root = shape === 'image' ? ImageShape : InlineShape;
56
-
57
- /* eslint-disable react/no-danger */
58
56
  return /*#__PURE__*/_jsxs(Root, {
59
57
  className: className,
60
58
  children: [/*#__PURE__*/_jsxs("a", {
@@ -74,16 +72,15 @@ export default function AdDisplay(props) {
74
72
  src: ad.img,
75
73
  alt: ad.name
76
74
  })
77
- }), /*#__PURE__*/_jsx("span", {
75
+ }), /*#__PURE__*/_jsxs("span", {
78
76
  className: "AdDisplay-description",
79
- dangerouslySetInnerHTML: {
80
- __html: ad.description
81
- }
77
+ children: [/*#__PURE__*/_jsx("strong", {
78
+ children: ad.descriptionHeader
79
+ }), " - ", ad.description]
82
80
  })]
83
81
  }), /*#__PURE__*/_jsx("span", {
84
82
  className: "AdDisplay-poweredby",
85
83
  children: t('adPublisher').replace('{{publisher}}', ad.poweredby)
86
84
  })]
87
85
  });
88
- /* eslint-enable react/no-danger */
89
86
  }
@@ -1,10 +1,12 @@
1
- var _ChatRounded, _BundleSizeIcon, _GitHubIcon, _W3CIcon, _MaterialDesignIcon, _li, _li2;
1
+ var _MarkdownIcon, _ChatRounded, _BundleSizeIcon, _GitHubIcon, _W3CIcon, _MaterialDesignIcon, _li, _li2;
2
2
  import * as React from 'react';
3
+ import { useRouter } from 'next/router';
3
4
  import Chip from '@mui/material/Chip';
4
5
  import Tooltip from '@mui/material/Tooltip';
5
6
  import ChatRounded from '@mui/icons-material/ChatRounded';
6
7
  import GitHubIcon from '@mui/icons-material/GitHub';
7
8
  import { styled } from '@mui/material/styles';
9
+ import MarkdownIcon from "../svgIcons/MarkdownIcon.js";
8
10
  import SketchIcon from "../svgIcons/SketchIcon.js";
9
11
  import FigmaIcon from "../svgIcons/FigmaIcon.js";
10
12
  import BundleSizeIcon from "../svgIcons/BundleSizeIcon.js";
@@ -49,9 +51,25 @@ export function ComponentLinkHeader(props) {
49
51
  design
50
52
  } = props;
51
53
  const t = useTranslate();
54
+ const router = useRouter();
52
55
  const packageName = headers.packageName ?? defaultPackageNames[headers.productId] ?? '@mui/material';
53
56
  return /*#__PURE__*/_jsxs(Root, {
54
- children: [headers.githubLabel ? /*#__PURE__*/_jsx("li", {
57
+ children: [packageName === '@mui/material' && /*#__PURE__*/_jsx("li", {
58
+ children: /*#__PURE__*/_jsx(Chip, {
59
+ clickable: true,
60
+ role: undefined,
61
+ component: "a",
62
+ size: "small",
63
+ variant: "outlined",
64
+ href: `${router.pathname}.md`,
65
+ icon: _MarkdownIcon || (_MarkdownIcon = /*#__PURE__*/_jsx(MarkdownIcon, {})),
66
+ "data-ga-event-category": "ComponentLinkHeader",
67
+ "data-ga-event-action": "click",
68
+ "data-ga-event-label": "Markdown",
69
+ "data-ga-event-split": "0.1",
70
+ label: "View as Markdown"
71
+ })
72
+ }), headers.githubLabel ? /*#__PURE__*/_jsx("li", {
55
73
  children: /*#__PURE__*/_jsx(Chip, {
56
74
  clickable: true,
57
75
  role: undefined,
package/esm/package.json CHANGED
@@ -1 +1 @@
1
- {"type":"module"}
1
+ {"type":"module","sideEffects":false}
@@ -0,0 +1,3 @@
1
+ import * as React from 'react';
2
+ import { SvgIconProps } from '@mui/material/SvgIcon';
3
+ export default function MarkdownIcon(props: SvgIconProps): React.JSX.Element;
@@ -0,0 +1,23 @@
1
+ var _svg;
2
+ import * as React from 'react';
3
+ import SvgIcon from '@mui/material/SvgIcon';
4
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
5
+ export default function MarkdownIcon(props) {
6
+ return /*#__PURE__*/_jsx(SvgIcon, {
7
+ ...props,
8
+ children: _svg || (_svg = /*#__PURE__*/_jsxs("svg", {
9
+ width: "16",
10
+ height: "16",
11
+ viewBox: "0 0 24 24",
12
+ fill: "none",
13
+ xmlns: "http://www.w3.org/2000/svg",
14
+ "aria-hidden": "true",
15
+ children: [/*#__PURE__*/_jsx("title", {
16
+ children: "Markdown"
17
+ }), /*#__PURE__*/_jsx("path", {
18
+ d: "M22.269 19.385H1.731a1.73 1.73 0 0 1-1.73-1.73V6.345a1.73 1.73 0 0 1 1.73-1.73h20.538a1.73 1.73 0 0 1 1.73 1.73v11.308a1.73 1.73 0 0 1-1.73 1.731zm-16.5-3.462v-4.5l2.308 2.885 2.307-2.885v4.5h2.308V8.078h-2.308l-2.307 2.885-2.308-2.885H3.461v7.847zM21.231 12h-2.308V8.077h-2.307V12h-2.308l3.461 4.039z",
19
+ fill: "currentColor"
20
+ })]
21
+ }))
22
+ });
23
+ }
package/package.json CHANGED
@@ -1,9 +1,8 @@
1
1
  {
2
2
  "name": "@mui/docs",
3
- "version": "7.3.1",
3
+ "version": "7.3.3",
4
4
  "author": "MUI Team",
5
5
  "description": "MUI Docs - Documentation building blocks.",
6
- "main": "./index.js",
7
6
  "keywords": [
8
7
  "react",
9
8
  "react-component",
@@ -22,20 +21,20 @@
22
21
  },
23
22
  "homepage": "https://github.com/mui/material-ui/tree/master/packages/mui-docs",
24
23
  "dependencies": {
25
- "@babel/runtime": "^7.28.2",
24
+ "@babel/runtime": "^7.28.4",
26
25
  "clipboard-copy": "^4.0.1",
27
26
  "clsx": "^2.1.1",
28
27
  "nprogress": "^0.2.0",
29
28
  "prop-types": "^15.8.1",
30
- "@mui/internal-markdown": "^2.0.9"
29
+ "@mui/internal-markdown": "^2.0.11"
31
30
  },
32
31
  "peerDependencies": {
33
- "@mui/base": "*",
32
+ "@mui/base": "^5.0.0 || ^5.0.0-beta || ^7.0.0 || ^7.0.0-beta",
34
33
  "@mui/icons-material": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^7.0.0-beta",
35
34
  "@mui/material": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^7.0.0-beta",
36
35
  "@mui/system": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^7.0.0-beta",
37
36
  "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",
38
- "chai": "^4.5.0",
37
+ "chai": "^6.0.1",
39
38
  "csstype": "^3.1.3",
40
39
  "next": "^13.5.1 || ^14 || ^15.0.0",
41
40
  "react": "^17.0.0 || ^18.0.0 || ^19.0.0"
@@ -51,30 +50,19 @@
51
50
  "engines": {
52
51
  "node": ">=14.0.0"
53
52
  },
54
- "private": false,
53
+ "type": "commonjs",
55
54
  "exports": {
56
55
  "./package.json": "./package.json",
57
- ".": {
58
- "require": {
59
- "types": "./index.d.ts",
60
- "default": "./index.js"
61
- },
62
- "import": {
63
- "types": "./esm/index.d.ts",
64
- "default": "./esm/index.js"
65
- }
66
- },
67
56
  "./*": {
68
57
  "require": {
69
58
  "types": "./*/index.d.ts",
70
59
  "default": "./*/index.js"
71
60
  },
72
- "import": {
61
+ "default": {
73
62
  "types": "./esm/*/index.d.ts",
74
63
  "default": "./esm/*/index.js"
75
64
  }
76
65
  },
77
- "./esm": null,
78
- "./modern": null
66
+ "./esm": null
79
67
  }
80
68
  }
@@ -0,0 +1,3 @@
1
+ import * as React from 'react';
2
+ import { SvgIconProps } from '@mui/material/SvgIcon';
3
+ export default function MarkdownIcon(props: SvgIconProps): React.JSX.Element;
@@ -0,0 +1,31 @@
1
+ "use strict";
2
+
3
+ var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
4
+ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
5
+ Object.defineProperty(exports, "__esModule", {
6
+ value: true
7
+ });
8
+ exports.default = MarkdownIcon;
9
+ var React = _interopRequireWildcard(require("react"));
10
+ var _SvgIcon = _interopRequireDefault(require("@mui/material/SvgIcon"));
11
+ var _jsxRuntime = require("react/jsx-runtime");
12
+ var _svg;
13
+ function MarkdownIcon(props) {
14
+ return /*#__PURE__*/(0, _jsxRuntime.jsx)(_SvgIcon.default, {
15
+ ...props,
16
+ children: _svg || (_svg = /*#__PURE__*/(0, _jsxRuntime.jsxs)("svg", {
17
+ width: "16",
18
+ height: "16",
19
+ viewBox: "0 0 24 24",
20
+ fill: "none",
21
+ xmlns: "http://www.w3.org/2000/svg",
22
+ "aria-hidden": "true",
23
+ children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("title", {
24
+ children: "Markdown"
25
+ }), /*#__PURE__*/(0, _jsxRuntime.jsx)("path", {
26
+ d: "M22.269 19.385H1.731a1.73 1.73 0 0 1-1.73-1.73V6.345a1.73 1.73 0 0 1 1.73-1.73h20.538a1.73 1.73 0 0 1 1.73 1.73v11.308a1.73 1.73 0 0 1-1.73 1.731zm-16.5-3.462v-4.5l2.308 2.885 2.307-2.885v4.5h2.308V8.078h-2.308l-2.307 2.885-2.308-2.885H3.461v7.847zM21.231 12h-2.308V8.077h-2.307V12h-2.308l3.461 4.039z",
27
+ fill: "currentColor"
28
+ })]
29
+ }))
30
+ });
31
+ }
@@ -1,223 +0,0 @@
1
- {
2
- "adblock": "If you don't mind tech-related ads (no tracking or remarketing), and want to keep us running, please whitelist us in your blocker.",
3
- "adPublisher": "ad by {{publisher}}",
4
- "aiCustomizeDemo": "Want to customize this?",
5
- "aiChatFailed": "Failed to open MUI Chat",
6
- "api-docs": {
7
- "componentName": "Component name",
8
- "componentsApi": "Components API",
9
- "themeDefaultProps": "Theme default props",
10
- "themeDefaultPropsDescription": "You can use <code>{{muiName}}</code> to change the default props of this component <a href={{defaultPropsLink}}>with the theme</a>.",
11
- "classes": "CSS classes",
12
- "classesDescription": "These class names are useful for styling with CSS. They are applied to the component's slots when specific states are triggered.",
13
- "className": "Class name",
14
- "cssDescription": "The following class names are useful for styling with CSS (the <a href=\"/material-ui/customization/how-to-customize/#state-classes\">state classes</a> are marked). <br /> To learn more, visit the <a href=\"/material-ui/customization/theme-components/\">component customization</a> page.",
15
- "css": "CSS",
16
- "cssComponent": "As a CSS utility, the {{name}} component also supports all <a href=\"/system/properties/\"><code>system</code></a> properties. You can use them as props directly on the component.",
17
- "default": "Default",
18
- "defaultComponent": "Default component",
19
- "defaultValue": "Default value",
20
- "defaultHTMLTag": "Default HTML tag",
21
- "defaultDeprecationMessage": "This API is deprecated.",
22
- "demos": "Demos",
23
- "deprecated": "Deprecated",
24
- "description": "Description",
25
- "globalClass": "Global class",
26
- "defaultClass": "Default class",
27
- "hookName": "Hook name",
28
- "hooksApi": "Hooks API",
29
- "hooksNoParameters": "This hook does not accept any input parameters.",
30
- "hooksPageDescription": "API reference docs for the {{name}} hook. Learn about the input parameters and other APIs of this exported module.",
31
- "import": "Import",
32
- "importDifference": "Learn about the difference by <a href=\"/material-ui/guides/minimizing-bundle-size/\">reading this guide on minimizing bundle size</a>.",
33
- "inheritance": "Inheritance",
34
- "inheritanceDescription": "While not explicitly documented above, the props of the <a href=\"{{pathname}}\">{{component}}</a> component{{suffix}} are also available in {{name}}. You can take advantage of this to <a href=\"/material-ui/guides/api/#spread\">target nested components</a>.",
35
- "inheritanceSuffixTransition": " from react-transition-group",
36
- "name": "Name",
37
- "nativeElement": "native",
38
- "overrideStyles": "You can override the style of the component using one of these customization options:\n",
39
- "overrideStylesStyledComponent": "<ul>\n<li>With a <a href=\"/material-ui/integrations/interoperability/#global-css\">global class name</a>.</li>\n<li>With a rule name as part of the component's <a href=\"{{styleOverridesLink}}\"><code>styleOverrides</code> property</a> in a custom theme.</li>\n</ul>",
40
- "pageDescription": "API reference docs for the React {{name}} component. Learn about the props, CSS, and other APIs of this exported module.",
41
- "props": "Props",
42
- "properties": "Properties",
43
- "parameters": "Parameters",
44
- "requires-ref": "This <a href=\"/material-ui/guides/composition/#caveat-with-refs\">needs to be able to hold a ref</a>.",
45
- "returns": "Returns: ",
46
- "returnValue": "Return value",
47
- "refNotHeld": "The component cannot hold a ref.",
48
- "refRootElement": "The <code>ref</code> is forwarded to the root element.",
49
- "ruleName": "Rule name",
50
- "seeSourceCode": "If you did not find the information in this page, consider having a look at the <a href=\"{{href}}\">implementation of the component</a> for more detail.",
51
- "signature": "Signature",
52
- "slots": "Slots",
53
- "spreadHint": "Props of the {{spreadHintElement}} component are also available.",
54
- "state": "STATE",
55
- "styleOverrides": "The name <code>{{componentStyles.name}}</code> can be used when providing <a href={{defaultPropsLink}}>default props</a> or <a href={{styleOverridesLink}}>style overrides</a> in the theme.",
56
- "slotDescription": "To learn how to customize the slot, check out the <a href={{slotGuideLink}}>Overriding component structure</a> guide.",
57
- "slotName": "Slot name",
58
- "source-code": "Source code",
59
- "type": "Type",
60
- "required": "Required",
61
- "optional": "Optional",
62
- "additional-info": {
63
- "cssApi": "See <a href='#classes'>CSS classes API</a> below for more details.",
64
- "sx": "See the <a href='/system/getting-started/the-sx-prop/'>`sx` page</a> for more details.",
65
- "slotsApi": "See <a href='#slots'>Slots API</a> below for more details.",
66
- "joy-size": "To learn how to add custom sizes to the component, check out <a href='/joy-ui/customization/themed-components/#extend-sizes'>Themed components—Extend sizes</a>.",
67
- "joy-color": "To learn how to add your own colors, check out <a href='/joy-ui/customization/themed-components/#extend-colors'>Themed components—Extend colors</a>.",
68
- "joy-variant": "To learn how to add your own variants, check out <a href='/joy-ui/customization/themed-components/#extend-variants'>Themed components—Extend variants</a>."
69
- }
70
- },
71
- "marketingPageDescr": "A responsive marketing page layout with sections for product features, testimonials, pricing, and FAQs.",
72
- "marketingPageTitle": "Marketing page",
73
- "searchButton": "Search…",
74
- "algoliaSearch": "What are you looking for?",
75
- "appFrame": {
76
- "changeLanguage": "Change language",
77
- "github": "GitHub repository",
78
- "helpToTranslate": "Help to translate",
79
- "openDrawer": "Open main navigation",
80
- "skipToContent": "Skip to content",
81
- "toggleSettings": "Toggle settings drawer"
82
- },
83
- "backToTop": "Scroll back to top",
84
- "backToOpenRoles": "Back to open roles",
85
- "blogDescr": "A sleek, modern blog homepage layout with Markdown support via markdown-to-jsx.",
86
- "blogTitle": "Blog",
87
- "bundleSize": "Bundle size",
88
- "bundleSizeTooltip": "Scroll down to 'Exports Analysis' for a more detailed report.",
89
- "cancel": "Cancel",
90
- "cdn": "or use a CDN.",
91
- "checkoutDescr": "A sophisticated checkout flow with fully customizable steps.",
92
- "checkoutTitle": "Checkout",
93
- "clickToCopy": "Click to copy",
94
- "close": "Close",
95
- "codesandbox": "Edit in CodeSandbox",
96
- "copied": "Copied",
97
- "copiedSource": "The source code has been copied to your clipboard.",
98
- "copiedSourceLink": "Link to the source code has been copied to your clipboard.",
99
- "copySource": "Copy the source",
100
- "copySourceLinkJS": "Copy link to JavaScript source",
101
- "copySourceLinkTS": "Copy link to TypeScript source",
102
- "dashboardDescr": "A complex data visualization dashboard featuring the MUI X Data Grid and Charts.",
103
- "dashboardTitle": "Dashboard",
104
- "decreaseSpacing": "decrease spacing",
105
- "demoToolbarLabel": "demo source",
106
- "demoStylingSelectSystem": "MUI System",
107
- "demoStylingSelectTailwind": "Tailwind CSS",
108
- "demoStylingSelectCSS": "Plain CSS",
109
- "diamondSponsors": "Diamond sponsors",
110
- "becomeADiamondSponsor": "Become a Diamond sponsor",
111
- "diamondSponsorVacancies": "One spot left!",
112
- "editorHint": "Press <kbd>Enter</kbd> to start editing",
113
- "editPage": "Edit this page",
114
- "emojiLove": "Love",
115
- "emojiWarning": "Warning",
116
- "expandAll": "Expand all",
117
- "feedbackCommentLabel": "Comment",
118
- "feedbackFailed": "Couldn't submit feedback. Please try again later.",
119
- "feedbackMessage": "Was this page helpful?",
120
- "feedbackMessageDown": "How can we improve this page? (optional)",
121
- "feedbackMessageUp": "What did you like about this page? (optional)",
122
- "feedbackSectionSpecific": "How can we improve the <strong>{{sectionName}}</strong> section? (optional)",
123
- "feedbackMessageToGitHub": {
124
- "usecases": "If something is broken or if you need a reply to a problem you've encountered, please",
125
- "reasonWhy": "Otherwise, the team won't be able to answer back or ask for more information.",
126
- "callToAction": {
127
- "link": "open an issue instead."
128
- }
129
- },
130
- "feedbackNo": "No",
131
- "feedbackSubmitted": "Feedback submitted",
132
- "feedbackYes": "Yes",
133
- "footerCompany": "Company",
134
- "goToHome": "go to homepage",
135
- "getProfessionalSupport": "Get Professional Support",
136
- "getStarted": "Get Started",
137
- "githubLabel": "Feedback",
138
- "headTitle": "MUI: A popular React UI framework",
139
- "hideFullSource": "Collapse code",
140
- "hideSource": "Hide code",
141
- "homeQuickWord": "A quick word from our sponsors:",
142
- "increaseSpacing": "increase spacing",
143
- "initialFocusLabel": "A generic container that is programmatically focused to test keyboard navigation of our components.",
144
- "installation": "Installation",
145
- "installButton": "Read installation docs",
146
- "installDescr": "Install MUI's source files via npm. We take care of injecting the CSS needed.",
147
- "joinThese": "Join these and other great organizations!",
148
- "JS": "JavaScript",
149
- "letUsKnow": "Let us know!",
150
- "likeMui": "Help us keep running",
151
- "loadFont": "Load the default Roboto font.",
152
- "mainNavigation": "documentation",
153
- "newest": "Newest",
154
- "openDrawer": "Open documentation navigation",
155
- "or": "or",
156
- "pageTOC": "Page table of contents",
157
- "praise": "Praise for MUI",
158
- "praiseDescr": "Here's what some of our users are saying.",
159
- "pricingDescr": "Quickly build an effective pricing table for your potential customers.",
160
- "pricingTitle": "Pricing",
161
- "resetDemo": "Reset demo",
162
- "resetDensity": "Reset density",
163
- "resetFocus": "Reset focus to test keyboard navigation",
164
- "searchIcons": {
165
- "learnMore": "Learn more about the import"
166
- },
167
- "seeMore": "See more",
168
- "settings": {
169
- "color": "Color",
170
- "dark": "Dark",
171
- "direction": "Direction",
172
- "editDocsColors": "Edit documentation colors",
173
- "light": "Light",
174
- "ltr": "Left to right",
175
- "mode": "Mode",
176
- "rtl": "Right to left",
177
- "settings": "Settings",
178
- "system": "System",
179
- "language": "Language"
180
- },
181
- "showFullSource": "Expand code",
182
- "showJSSource": "Show JavaScript source",
183
- "showSource": "Show code",
184
- "showTSSource": "Show TypeScript source",
185
- "signInDescr": "A clean and efficient sign-in page, ready for your favorite auth provider.",
186
- "signInSideDescr": "A responsive, two-column sign-in page for adding content alongside the form.",
187
- "signInSideTitle": "Sign-in side",
188
- "signInTitle": "Sign-in",
189
- "signUpDescr": "A clean and efficient sign-up page, perfect for pairing with a sign-in template.",
190
- "signUpTitle": "Sign-up",
191
- "crudDashboardTitle": "CRUD dashboard",
192
- "crudDashboardDescr": "Dashboard with CRUD pages and mobile-friendly layout with highly customizable sidebar.",
193
- "sourceCode": "Source code",
194
- "spacingUnit": "Spacing unit",
195
- "stackblitz": "Edit in StackBlitz",
196
- "stars": "GitHub stars",
197
- "stickyFooterDescr": "Attach a footer to the bottom of the viewport when page content is short.",
198
- "stickyFooterTitle": "Sticky footer",
199
- "strapline": "MUI provides a simple, customizable, and accessible library of React components. Follow your own design system, or start with Material Design.",
200
- "submit": "Submit",
201
- "tableOfContents": "Contents",
202
- "thanks": "Thank you!",
203
- "themes": "Premium themes",
204
- "themesButton": "Browse themes",
205
- "themesDescr": "Take your project to the next level with premium themes from our store – all built on MUI.",
206
- "toggleNotifications": "Toggle notifications panel",
207
- "toggleRTL": "Toggle right-to-left/left-to-right",
208
- "traffic": "Traffic",
209
- "TS": "TypeScript",
210
- "v5IsOut": "🎉 v5 release candidate is out! Head to the",
211
- "v5docsLink": "v5 documentation",
212
- "v5startAdoption": "to get started.",
213
- "unreadNotifications": "unread notifications",
214
- "usage": "Usage",
215
- "usageButton": "Explore the docs",
216
- "usageDescr": "MUI components work without any additional setup, and don't pollute the global scope.",
217
- "useDarkTheme": "Use dark theme",
218
- "useHighDensity": "Apply higher density via props",
219
- "usingMui": "Are you using MUI?",
220
- "viewGitHub": "View the source on GitHub",
221
- "visit": "Visit the website",
222
- "whosUsing": "Who's using MUI?"
223
- }