@mui/docs 6.0.0-alpha.8 → 6.0.0-beta.0

package/node/MarkdownElement/MarkdownElement.js

@@ -8,6 +8,7 @@ exports.MarkdownElement = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _clsx = _interopRequireDefault(require("clsx"));
 var _styles = require("@mui/material/styles");
+var _useForkRef = _interopRequireDefault(require("@mui/utils/useForkRef"));
 var _branding = require("../branding");
 var _jsxRuntime = require("react/jsx-runtime");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
@@ -18,8 +19,8 @@ const Root = (0, _styles.styled)('div')(({
   var _theme$shape$borderRa, _theme$shape, _theme$shape$borderRa2, _theme$shape2, _theme$shape$borderRa3, _theme$shape3;
   return {
     ..._branding.brandingLightTheme.typography.body1,
-    lineHeight: 1.6,
-    // Increased compared to the 1.5 default to make the docs easier to read.
+    lineHeight: 1.625,
+    // Rounds up to 26px－increased compared to the 1.5 default to make the docs easier to read.
     color: `var(--muidocs-palette-text-primary, ${_branding.brandingLightTheme.palette.text.primary})`,
     '& :focus-visible': {
       outline: `3px solid ${(0, _styles.alpha)(_branding.brandingLightTheme.palette.primary[500], 0.5)}`,
@@ -34,7 +35,7 @@ const Root = (0, _styles.styled)('div')(({
       // Developers like when the code is dense.
       margin: theme.spacing(2, 'auto'),
       padding: theme.spacing(2),
-      backgroundColor: 'hsl(210, 35%, 9%)',
+      backgroundColor: 'hsl(210, 25%, 9%)',
       // a special, one-off, color tailored for the code blocks using MUI's branding theme blue palette as the starting point. It has a less saturaded color but still maintaining a bit of the blue tint.
       color: 'hsl(60, 30%, 96%)',
       colorScheme: 'dark',
@@ -133,6 +134,44 @@ const Root = (0, _styles.styled)('div')(({
         marginBottom: 6
       }
     },
+    '& a[target="_blank"]::after': {
+      content: '""',
+      maskImage: `url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' focusable='false' aria-hidden='true' viewBox='0 0 24 24' fill='currentColor'%3E%3Cpath d='M6 6v2h8.59L5 17.59 6.41 19 16 9.41V18h2V6z'%3E%3C/path%3E%3C/svg%3E")`,
+      display: 'inline-flex',
+      width: '1em',
+      height: '1em',
+      color: 'inherit',
+      backgroundColor: 'currentColor',
+      transform: 'translate(0, 2px)',
+      transition: 'transform 0.3s cubic-bezier(0.1, 0.8, 0.3, 1)',
+      // bounce effect
+      opacity: 0.8
+    },
+    '& a[target="_blank"]:hover::after': {
+      opacity: 1,
+      transform: 'translate(1px, 0)'
+    },
+    '& a.remove-link-arrow::after': {
+      // Allows to remove link arrows for images
+      display: 'none'
+    },
+    '& .Ad-root a::after': {
+      // Remove link arrow for ads
+      display: 'none'
+    },
+    '& a': {
+      // Style taken from the Link component
+      color: `var(--muidocs-palette-primary-600, ${_branding.brandingLightTheme.palette.primary[600]})`,
+      fontWeight: theme.typography.fontWeightMedium,
+      textDecoration: 'underline',
+      textDecorationColor: (0, _styles.alpha)(_branding.brandingLightTheme.palette.primary.main, 0.4),
+      '&:hover': {
+        textDecorationColor: 'inherit'
+      }
+    },
+    '& a code': {
+      color: (0, _styles.darken)(_branding.brandingLightTheme.palette.primary.main, 0.2)
+    },
     '& h1, & h2, & h3, & h4': {
       display: 'flex',
       alignItems: 'center',
@@ -146,9 +185,12 @@ const Root = (0, _styles.styled)('div')(({
       '& .title-link-to-anchor': {
         color: 'inherit',
         textDecoration: 'none',
+        boxShadow: 'none',
+        fontWeight: 'inherit',
         position: 'relative',
         display: 'flex',
-        alignItems: 'center'
+        alignItems: 'center',
+        userSelect: 'text'
       },
       '& .anchor-icon': {
         // To prevent the link to get the focus.
@@ -156,12 +198,6 @@ const Root = (0, _styles.styled)('div')(({
         alignItems: 'center',
         visibility: 'hidden'
       },
-      '& a:not(.title-link-to-anchor):hover': {
-        color: 'currentColor',
-        border: 'none',
-        boxShadow: '0 1px 0 0 currentColor',
-        textDecoration: 'none'
-      },
       '& .anchor-icon, & .comment-link': {
         padding: 0,
         cursor: 'pointer',
@@ -172,11 +208,13 @@ const Root = (0, _styles.styled)('div')(({
         marginLeft: 8,
         height: 26,
         width: 26,
-        backgroundColor: `var(--muidocs-palette-primary-50, ${_branding.brandingLightTheme.palette.grey[50]})`,
         color: `var(--muidocs-palette-grey-600, ${_branding.brandingLightTheme.palette.grey[600]})`,
-        border: '1px solid',
-        borderColor: `var(--muidocs-palette-divider, ${_branding.brandingLightTheme.palette.divider})`,
+        backgroundColor: 'transparent',
+        border: '1px solid transparent',
         borderRadius: 8,
+        transition: theme.transitions.create(['visibility', 'background-color', 'color', 'border-color'], {
+          duration: theme.transitions.duration.shortest
+        }),
         '&:hover': {
           backgroundColor: (0, _styles.alpha)(_branding.brandingLightTheme.palette.primary[100], 0.4),
           borderColor: `var(--muidocs-palette-primary-100, ${_branding.brandingLightTheme.palette.primary[100]})`,
@@ -197,7 +235,7 @@ const Root = (0, _styles.styled)('div')(({
         display: 'none',
         // So we can have the comment button opt-in.
         marginLeft: 'auto',
-        transition: theme.transitions.create('opacity', {
+        transition: theme.transitions.create(['background-color', 'color', 'border-color'], {
           duration: theme.transitions.duration.shortest
         }),
         '& svg': {
@@ -295,44 +333,58 @@ const Root = (0, _styles.styled)('div')(({
     },
     '& .MuiCallout-root': {
       display: 'flex',
-      gap: 12,
-      padding: '16px',
+      gap: '8px',
+      padding: '12px',
       margin: '16px 0',
       border: '1px solid',
       color: `var(--muidocs-palette-text-secondary, ${_branding.brandingLightTheme.palette.text.secondary})`,
       borderColor: `var(--muidocs-palette-grey-100, ${_branding.brandingLightTheme.palette.grey[100]})`,
       borderRadius: `var(--muidocs-shape-borderRadius, ${(_theme$shape$borderRa2 = (_theme$shape2 = theme.shape) == null ? void 0 : _theme$shape2.borderRadius) != null ? _theme$shape$borderRa2 : _branding.brandingLightTheme.shape.borderRadius}px)`,
-      '& > code': {
+      '& .MuiCallout-content': {
+        minWidth: 0,
+        // Allows content to shrink. Useful when callout contains code block
+        flexGrow: 1
+      },
+      '& code': {
         height: 'fit-content',
         backgroundColor: `var(--muidocs-palette-grey-100, ${_branding.brandingLightTheme.palette.grey[100]})`,
         borderColor: `var(--muidocs-palette-grey-300, ${_branding.brandingLightTheme.palette.grey[300]})`
       },
-      '& .MuiCallout-content': {
-        minWidth: 0,
-        // Allows content to shrink. Useful when callout contains code block
-        flexGrow: 1,
+      '& p': {
+        marginBottom: '8px',
         '& > p:last-child, & > ul:last-child': {
           // Avoid margin on last child
           marginBottom: 0
         },
-        '& .MuiCode-root': {
-          '& > pre': {
-            margin: 0,
-            marginTop: 4
-          }
-        },
         '& > ul': {
           // Because of the gap left by the icon, we visually need less padding
           paddingLeft: 22
         }
       },
-      '& > svg': {
-        marginTop: 2,
-        width: 20,
-        height: 20,
-        flexShrink: 0
+      '& .MuiCode-root': {
+        '& pre': {
+          margin: '4px 0 0 0',
+          borderRadius: '12px 12px 6px 12px',
+          borderColor: (0, _styles.alpha)(_branding.brandingLightTheme.palette.primaryDark[600], 0.6),
+          '& code': {
+            backgroundColor: 'transparent'
+          }
+        }
+      },
+      '& .MuiCallout-icon-container': {
+        width: 26,
+        // to match text's line-height
+        height: 26,
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        flexShrink: 0,
+        '& svg': {
+          width: 18,
+          height: 18
+        }
       },
-      '& > ul, & > p': {
+      '& ul, & p': {
         '&:last-child': {
           margin: 0
         }
@@ -347,7 +399,7 @@ const Root = (0, _styles.styled)('div')(({
         '& strong': {
           color: `var(--muidocs-palette-error-800, ${_branding.brandingLightTheme.palette.error[800]})`
         },
-        '& > svg': {
+        '& svg': {
           fill: `var(--muidocs-palette-error-500, ${_branding.brandingLightTheme.palette.error[600]})`
         },
         '& a': {
@@ -365,7 +417,7 @@ const Root = (0, _styles.styled)('div')(({
         '& strong': {
           color: `var(--muidocs-palette-primary-800, ${_branding.brandingLightTheme.palette.primary[800]})`
         },
-        '& > svg': {
+        '& svg': {
           fill: `var(--muidocs-palette-grey-600, ${_branding.brandingLightTheme.palette.grey[600]})`
         }
       },
@@ -376,7 +428,7 @@ const Root = (0, _styles.styled)('div')(({
         '& strong': {
           color: `var(--muidocs-palette-success-900, ${_branding.brandingLightTheme.palette.success[900]})`
         },
-        '& > svg': {
+        '& svg': {
           fill: `var(--muidocs-palette-success-600, ${_branding.brandingLightTheme.palette.success[600]})`
         },
         '& a': {
@@ -394,7 +446,7 @@ const Root = (0, _styles.styled)('div')(({
         '& strong': {
           color: `var(--muidocs-palette-warning-800, ${_branding.brandingLightTheme.palette.warning[800]})`
         },
-        '& > svg': {
+        '& svg': {
           fill: `var(--muidocs-palette-warning-600, ${_branding.brandingLightTheme.palette.warning[600]})`
         },
         '& a': {
@@ -406,47 +458,6 @@ const Root = (0, _styles.styled)('div')(({
         }
       }
     },
-    '& a[target="_blank"]::after': {
-      content: '""',
-      maskImage: `url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' focusable='false' aria-hidden='true' viewBox='0 0 24 24' fill='currentColor'%3E%3Cpath d='M6 6v2h8.59L5 17.59 6.41 19 16 9.41V18h2V6z'%3E%3C/path%3E%3C/svg%3E")`,
-      display: 'inline-flex',
-      width: '1em',
-      height: '1em',
-      color: 'inherit',
-      backgroundColor: 'currentColor',
-      transform: 'translate(0, 2px)',
-      transition: 'transform 0.3s cubic-bezier(0.1, 0.8, 0.3, 1)',
-      // bounce effect
-      opacity: 0.8
-    },
-    '& a[target="_blank"]:hover::after': {
-      opacity: 1,
-      transform: 'translate(1px, 0)'
-    },
-    '& a.remove-link-arrow::after': {
-      // Allows to remove link arrows for images
-      display: 'none'
-    },
-    '& .Ad-root a::after': {
-      // Remove link arrow for ads
-      display: 'none'
-    },
-    '& a:not(.title-link-to-anchor), & a:not(.title-link-to-anchor) code': {
-      // Style taken from the Link component
-      color: `var(--muidocs-palette-primary-600, ${_branding.brandingLightTheme.palette.primary[600]})`,
-      fontWeight: theme.typography.fontWeightMedium,
-      textDecoration: 'underline',
-      textDecorationColor: (0, _styles.alpha)(_branding.brandingLightTheme.palette.primary.main, 0.4),
-      '&:hover': {
-        textDecorationColor: 'inherit'
-      }
-    },
-    '& a code': {
-      color: (0, _styles.darken)(_branding.brandingLightTheme.palette.primary.main, 0.04)
-    },
-    '& a:not(.title-link-to-anchor) code': {
-      color: (0, _styles.darken)(_branding.brandingLightTheme.palette.primary.main, 0.2)
-    },
     '& img, & video': {
       // Use !important so that inline style on <img> or <video> can't win.
       // This avoid horizontal overflows on mobile.
@@ -550,7 +561,6 @@ const Root = (0, _styles.styled)('div')(({
       display: 'inline-flex',
       flexDirection: 'row-reverse',
       alignItems: 'center',
-      height: 24,
       padding: theme.spacing(0.5),
       paddingBottom: '5px',
       // optical alignment
@@ -561,7 +571,7 @@ const Root = (0, _styles.styled)('div')(({
       border: '1px solid',
       borderColor: (0, _styles.alpha)(_branding.brandingLightTheme.palette.primaryDark[600], 0.5),
       backgroundColor: (0, _styles.alpha)(_branding.brandingLightTheme.palette.primaryDark[800], 0.5),
-      color: `var(--muidocs-palette-grey-200, ${_branding.brandingLightTheme.palette.grey[200]})`,
+      color: `var(--muidocs-palette-grey-300, ${_branding.brandingLightTheme.palette.grey[300]})`,
       transition: theme.transitions.create(['background', 'borderColor', 'display'], {
         duration: theme.transitions.duration.shortest
       }),
@@ -675,24 +685,26 @@ const Root = (0, _styles.styled)('div')(({
     '& hr': {
       backgroundColor: `var(--muidocs-palette-divider, ${_branding.brandingDarkTheme.palette.divider})`
     },
-    '& h1, & h2, & h3, & h4, & h5': {
-      color: `var(--muidocs-palette-grey-50, ${_branding.brandingDarkTheme.palette.grey[50]})`
+    '& a': {
+      color: `var(--muidocs-palette-primary-300, ${_branding.brandingDarkTheme.palette.primary[300]})`
     },
-    '& p, & ul, & ol': {
-      color: `var(--muidocs-palette-grey-400, ${_branding.brandingDarkTheme.palette.grey[400]})`
+    '& a code': {
+      color: `var(--muidocs-palette-primary-light, ${_branding.brandingDarkTheme.palette.primary.light})`
     },
-    '& h1, & h2, & h3, & h4': {
-      '&:hover .anchor-icon, & .comment-link': {
-        color: `var(--muidocs-palette-primary-300, ${_branding.brandingDarkTheme.palette.primaryDark[300]})`,
-        borderColor: `var(--muidocs-palette-divider, ${_branding.brandingDarkTheme.palette.divider})`,
-        backgroundColor: (0, _styles.alpha)(_branding.brandingDarkTheme.palette.primaryDark[700], 0.5),
+    '& h1, & h2, & h3, & h4, & h5': {
+      color: `var(--muidocs-palette-grey-50, ${_branding.brandingDarkTheme.palette.grey[50]})`,
+      '& .anchor-icon, & .comment-link': {
+        color: `var(--muidocs-palette-primary-300, ${_branding.brandingDarkTheme.palette.primaryDark[400]})`,
         '&:hover': {
+          color: `var(--muidocs-palette-primary-100, ${_branding.brandingDarkTheme.palette.primary[100]})`,
           borderColor: `var(--muidocs-palette-primary-900, ${_branding.brandingDarkTheme.palette.primary[900]})`,
-          backgroundColor: (0, _styles.alpha)(_branding.brandingDarkTheme.palette.primary[900], 0.6),
-          color: `var(--muidocs-palette-primary-100, ${_branding.brandingDarkTheme.palette.primary[100]})`
+          backgroundColor: (0, _styles.alpha)(_branding.brandingDarkTheme.palette.primary[900], 0.6)
         }
       }
     },
+    '& p, & ul, & ol': {
+      color: `var(--muidocs-palette-grey-400, ${_branding.brandingDarkTheme.palette.grey[400]})`
+    },
     '& h1 code, & h2 code, & h3 code': {
       color: `var(--muidocs-palette-grey-100, ${_branding.brandingDarkTheme.palette.grey[100]})`
     },
@@ -726,8 +738,7 @@ const Root = (0, _styles.styled)('div')(({
     },
     '& .MuiCallout-root': {
       borderColor: `var(--muidocs-palette-primaryDark-700, ${_branding.brandingDarkTheme.palette.primaryDark[700]})`,
-      '& > code': {
-        height: 'fit-content',
+      '& code': {
         backgroundColor: `var(--muidocs-palette-primaryDark-600, ${_branding.brandingDarkTheme.palette.primaryDark[600]})`,
         borderColor: `var(--muidocs-palette-primaryDark-500, ${_branding.brandingDarkTheme.palette.primaryDark[500]})`
       },
@@ -738,7 +749,7 @@ const Root = (0, _styles.styled)('div')(({
         '& strong': {
           color: `var(--muidocs-palette-error-300, ${_branding.brandingDarkTheme.palette.error[300]})`
         },
-        '& > svg': {
+        '& svg': {
           fill: `var(--muidocs-palette-error-500, ${_branding.brandingDarkTheme.palette.error[500]})`
         },
         '& a': {
@@ -752,7 +763,7 @@ const Root = (0, _styles.styled)('div')(({
         '& strong': {
           color: `var(--muidocs-palette-primary-200, ${_branding.brandingDarkTheme.palette.primary[200]})`
         },
-        '& > svg': {
+        '& svg': {
           fill: `var(--muidocs-palette-grey-400, ${_branding.brandingDarkTheme.palette.grey[400]})`
         }
       },
@@ -763,7 +774,7 @@ const Root = (0, _styles.styled)('div')(({
         '& strong': {
           color: `var(--muidocs-palette-success-200, ${_branding.brandingDarkTheme.palette.success[200]})`
         },
-        '& > svg': {
+        '& svg': {
           fill: `var(--muidocs-palette-success-500, ${_branding.brandingDarkTheme.palette.success[500]})`
         },
         '& a': {
@@ -777,7 +788,7 @@ const Root = (0, _styles.styled)('div')(({
         '& strong': {
           color: `var(--muidocs-palette-warning-200, ${_branding.brandingDarkTheme.palette.warning[200]})`
         },
-        '& > svg': {
+        '& svg': {
           fill: `var(--muidocs-palette-warning-400, ${_branding.brandingDarkTheme.palette.warning[400]})`
         },
         '& a': {
@@ -785,12 +796,6 @@ const Root = (0, _styles.styled)('div')(({
         }
       }
     },
-    '& a:not(.title-link-to-anchor), & a:not(.title-link-to-anchor) code': {
-      color: `var(--muidocs-palette-primary-300, ${_branding.brandingDarkTheme.palette.primary[300]})`
-    },
-    '& a:not(.title-link-to-anchor) code': {
-      color: `var(--muidocs-palette-primary-light, ${_branding.brandingDarkTheme.palette.primary.light})`
-    },
     '& kbd.key': {
       color: `var(--muidocs-palette-text-primary, ${_branding.brandingDarkTheme.palette.text.primary})`,
       backgroundColor: `var(--muidocs-palette-primaryDark-800, ${_branding.brandingDarkTheme.palette.primaryDark[800]})`,
@@ -814,12 +819,32 @@ const Root = (0, _styles.styled)('div')(({
     }
   }
 }));
+function handleHeaderClick(event) {
+  const selection = document.getSelection();
+  if (selection === null) {
+    return;
+  }
+  if (selection.type === 'Range') {
+    // Disable the <a> behavior to be able to select text.
+    event.preventDefault();
+  }
+}
 const MarkdownElement = exports.MarkdownElement = /*#__PURE__*/React.forwardRef(function MarkdownElement(props, ref) {
   const {
     className,
     renderedMarkdown,
     ...other
   } = props;
+  const rootRef = React.useRef(null);
+  const handleRef = (0, _useForkRef.default)(rootRef, ref);
+  React.useEffect(() => {
+    const elements = rootRef.current.getElementsByClassName('title-link-to-anchor');
+    for (let i = 0; i < elements.length; i += 1) {
+      // More reliable than `-webkit-user-drag` (https://caniuse.com/webkit-user-drag)
+      elements[i].setAttribute('draggable', 'false');
+      elements[i].addEventListener('click', handleHeaderClick);
+    }
+  }, []);
   const more = {};
   if (typeof renderedMarkdown === 'string') {
     // workaround for https://github.com/facebook/react/issues/17170
@@ -832,6 +857,6 @@ const MarkdownElement = exports.MarkdownElement = /*#__PURE__*/React.forwardRef(
     className: (0, _clsx.default)('markdown-body', className),
     ...more,
     ...other,
-    ref: ref
+    ref: handleRef
   });
 });