@mui/material 9.0.0 → 9.1.0

package/LinearProgress/LinearProgress.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
+exports.resetWarningFlags = resetWarningFlags;
 var React = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _clsx = _interopRequireDefault(require("clsx"));
@@ -17,9 +18,23 @@ var _memoTheme = _interopRequireDefault(require("../utils/memoTheme"));
 var _createSimplePaletteValueFilter = _interopRequireDefault(require("../utils/createSimplePaletteValueFilter"));
 var _DefaultPropsProvider = require("../DefaultPropsProvider");
 var _capitalize = _interopRequireDefault(require("../utils/capitalize"));
+var _utils = require("../transitions/utils");
 var _linearProgressClasses = require("./linearProgressClasses");
 var _jsxRuntime = require("react/jsx-runtime");
 const TRANSITION_DURATION = 4; // seconds
+const EMPTY_STYLE = {};
+let warnedMinMaxWithoutVariant = false;
+let warnedInvalidMinMaxValue = false;
+let warnedValueRequired = false;
+let warnedInvalidMinMaxValueBuffer = false;
+let warnedValueBufferRequired = false;
+function resetWarningFlags() {
+  warnedMinMaxWithoutVariant = false;
+  warnedInvalidMinMaxValue = false;
+  warnedValueRequired = false;
+  warnedInvalidMinMaxValueBuffer = false;
+  warnedValueBufferRequired = false;
+}
 const indeterminate1Keyframe = (0, _zeroStyled.keyframes)`
   0% {
     left: -35%;
@@ -195,7 +210,11 @@ const LinearProgressDashed = (0, _zeroStyled.styled)('span', {
 })), bufferAnimation || {
   // At runtime for Pigment CSS, `bufferAnimation` will be null and the generated keyframe will be used.
   animation: `${bufferKeyframe} 3s infinite linear`
-});
+}, (0, _memoTheme.default)(({
+  theme
+}) => (0, _utils.getReducedMotionStyles)(theme, {
+  animation: 'none'
+}) || EMPTY_STYLE));
 const LinearProgressBar1 = (0, _zeroStyled.styled)('span', {
   name: 'MuiLinearProgress',
   slot: 'Bar1',
@@ -204,59 +223,81 @@ const LinearProgressBar1 = (0, _zeroStyled.styled)('span', {
   }
 })((0, _memoTheme.default)(({
   theme
-}) => ({
-  width: '100%',
-  position: 'absolute',
-  left: 0,
-  bottom: 0,
-  top: 0,
-  transition: 'transform 0.2s linear',
-  transformOrigin: 'left',
-  variants: [{
-    props: {
-      color: 'inherit'
-    },
-    style: {
-      backgroundColor: 'currentColor'
-    }
-  }, ...Object.entries(theme.palette).filter((0, _createSimplePaletteValueFilter.default)()).map(([color]) => ({
-    props: {
-      color
-    },
-    style: {
-      backgroundColor: (theme.vars || theme).palette[color].main
-    }
-  })), {
-    props: {
-      variant: 'determinate'
-    },
-    style: {
-      transition: `transform .${TRANSITION_DURATION}s linear`
-    }
-  }, {
-    props: {
-      variant: 'buffer'
-    },
-    style: {
-      zIndex: 1,
-      transition: `transform .${TRANSITION_DURATION}s linear`
-    }
-  }, {
-    props: ({
-      ownerState
-    }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
-    style: {
-      width: 'auto'
-    }
-  }, {
-    props: ({
-      ownerState
-    }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
-    style: indeterminate1Animation || {
-      animation: `${indeterminate1Keyframe} 2.1s cubic-bezier(0.65, 0.815, 0.735, 0.395) infinite`
-    }
-  }]
-})));
+}) => {
+  const reducedMotionIndeterminateStyles = (0, _utils.getReducedMotionStyles)(theme, {
+    animation: 'none',
+    left: '30%',
+    right: 'auto',
+    width: '40%'
+  });
+  return {
+    width: '100%',
+    position: 'absolute',
+    left: 0,
+    bottom: 0,
+    top: 0,
+    ...(0, _utils.getTransitionStyles)(theme, 'transform', {
+      duration: '0.2s',
+      easing: 'linear'
+    }),
+    transformOrigin: 'left',
+    variants: [{
+      props: {
+        color: 'inherit'
+      },
+      style: {
+        backgroundColor: 'currentColor'
+      }
+    }, ...Object.entries(theme.palette).filter((0, _createSimplePaletteValueFilter.default)()).map(([color]) => ({
+      props: {
+        color
+      },
+      style: {
+        backgroundColor: (theme.vars || theme).palette[color].main
+      }
+    })), {
+      props: {
+        variant: 'determinate'
+      },
+      style: {
+        ...(0, _utils.getTransitionStyles)(theme, 'transform', {
+          duration: `.${TRANSITION_DURATION}s`,
+          easing: 'linear'
+        })
+      }
+    }, {
+      props: {
+        variant: 'buffer'
+      },
+      style: {
+        zIndex: 1,
+        ...(0, _utils.getTransitionStyles)(theme, 'transform', {
+          duration: `.${TRANSITION_DURATION}s`,
+          easing: 'linear'
+        })
+      }
+    }, {
+      props: ({
+        ownerState
+      }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
+      style: {
+        width: 'auto'
+      }
+    }, {
+      props: ({
+        ownerState
+      }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
+      style: indeterminate1Animation || {
+        animation: `${indeterminate1Keyframe} 2.1s cubic-bezier(0.65, 0.815, 0.735, 0.395) infinite`
+      }
+    }, ...(reducedMotionIndeterminateStyles ? [{
+      props: ({
+        ownerState
+      }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
+      style: reducedMotionIndeterminateStyles
+    }] : [])]
+  };
+}));
 const LinearProgressBar2 = (0, _zeroStyled.styled)('span', {
   name: 'MuiLinearProgress',
   slot: 'Bar2',
@@ -265,67 +306,84 @@ const LinearProgressBar2 = (0, _zeroStyled.styled)('span', {
   }
 })((0, _memoTheme.default)(({
   theme
-}) => ({
-  width: '100%',
-  position: 'absolute',
-  left: 0,
-  bottom: 0,
-  top: 0,
-  transition: 'transform 0.2s linear',
-  transformOrigin: 'left',
-  variants: [...Object.entries(theme.palette).filter((0, _createSimplePaletteValueFilter.default)()).map(([color]) => ({
-    props: {
-      color
-    },
-    style: {
-      '--LinearProgressBar2-barColor': (theme.vars || theme).palette[color].main
-    }
-  })), {
-    props: ({
-      ownerState
-    }) => ownerState.variant !== 'buffer' && ownerState.color !== 'inherit',
-    style: {
-      backgroundColor: 'var(--LinearProgressBar2-barColor, currentColor)'
-    }
-  }, {
-    props: ({
-      ownerState
-    }) => ownerState.variant !== 'buffer' && ownerState.color === 'inherit',
-    style: {
-      backgroundColor: 'currentColor'
-    }
-  }, {
-    props: {
-      color: 'inherit'
-    },
-    style: {
-      opacity: 0.3
-    }
-  }, ...Object.entries(theme.palette).filter((0, _createSimplePaletteValueFilter.default)()).map(([color]) => ({
-    props: {
-      color,
-      variant: 'buffer'
-    },
-    style: {
-      backgroundColor: getColorShade(theme, color),
-      transition: `transform .${TRANSITION_DURATION}s linear`
-    }
-  })), {
-    props: ({
-      ownerState
-    }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
-    style: {
-      width: 'auto'
-    }
-  }, {
-    props: ({
-      ownerState
-    }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
-    style: indeterminate2Animation || {
-      animation: `${indeterminate2Keyframe} 2.1s cubic-bezier(0.165, 0.84, 0.44, 1) 1.15s infinite`
-    }
-  }]
-})));
+}) => {
+  const reducedMotionIndeterminateStyles = (0, _utils.getReducedMotionStyles)(theme, {
+    animation: 'none',
+    display: 'none'
+  });
+  return {
+    width: '100%',
+    position: 'absolute',
+    left: 0,
+    bottom: 0,
+    top: 0,
+    ...(0, _utils.getTransitionStyles)(theme, 'transform', {
+      duration: '0.2s',
+      easing: 'linear'
+    }),
+    transformOrigin: 'left',
+    variants: [...Object.entries(theme.palette).filter((0, _createSimplePaletteValueFilter.default)()).map(([color]) => ({
+      props: {
+        color
+      },
+      style: {
+        '--LinearProgressBar2-barColor': (theme.vars || theme).palette[color].main
+      }
+    })), {
+      props: ({
+        ownerState
+      }) => ownerState.variant !== 'buffer' && ownerState.color !== 'inherit',
+      style: {
+        backgroundColor: 'var(--LinearProgressBar2-barColor, currentColor)'
+      }
+    }, {
+      props: ({
+        ownerState
+      }) => ownerState.variant !== 'buffer' && ownerState.color === 'inherit',
+      style: {
+        backgroundColor: 'currentColor'
+      }
+    }, {
+      props: {
+        color: 'inherit'
+      },
+      style: {
+        opacity: 0.3
+      }
+    }, ...Object.entries(theme.palette).filter((0, _createSimplePaletteValueFilter.default)()).map(([color]) => ({
+      props: {
+        color,
+        variant: 'buffer'
+      },
+      style: {
+        backgroundColor: getColorShade(theme, color),
+        ...(0, _utils.getTransitionStyles)(theme, 'transform', {
+          duration: `.${TRANSITION_DURATION}s`,
+          easing: 'linear'
+        })
+      }
+    })), {
+      props: ({
+        ownerState
+      }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
+      style: {
+        width: 'auto'
+      }
+    }, {
+      props: ({
+        ownerState
+      }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
+      style: indeterminate2Animation || {
+        animation: `${indeterminate2Keyframe} 2.1s cubic-bezier(0.165, 0.84, 0.44, 1) 1.15s infinite`
+      }
+    }, ...(reducedMotionIndeterminateStyles ? [{
+      props: ({
+        ownerState
+      }) => ownerState.variant === 'indeterminate' || ownerState.variant === 'query',
+      style: reducedMotionIndeterminateStyles
+    }] : [])]
+  };
+}));
 
 /**
  * ## ARIA
@@ -342,6 +400,8 @@ const LinearProgress = /*#__PURE__*/React.forwardRef(function LinearProgress(inP
   const {
     className,
     color = 'primary',
+    max: maxProp,
+    min: minProp,
     value,
     valueBuffer,
     variant = 'indeterminate',
@@ -352,6 +412,14 @@ const LinearProgress = /*#__PURE__*/React.forwardRef(function LinearProgress(inP
     color,
     variant
   };
+  if (process.env.NODE_ENV !== 'production') {
+    if (!warnedMinMaxWithoutVariant && ['indeterminate', 'query'].includes(variant) && (minProp !== undefined || maxProp !== undefined)) {
+      console.warn(`MUI: You have provided the \`min\` or \`max\` props with an 'indeterminate' or 'query' variant. These props will have no effect.`);
+      warnedMinMaxWithoutVariant = true;
+    }
+  }
+  const min = minProp ?? 0;
+  const max = maxProp ?? 100;
   const classes = useUtilityClasses(ownerState);
   const isRtl = (0, _RtlProvider.useRtl)();
   const rootProps = {};
@@ -361,27 +429,48 @@ const LinearProgress = /*#__PURE__*/React.forwardRef(function LinearProgress(inP
   };
   if (variant === 'determinate' || variant === 'buffer') {
     if (value !== undefined) {
-      rootProps['aria-valuenow'] = Math.round(value);
-      rootProps['aria-valuemin'] = 0;
-      rootProps['aria-valuemax'] = 100;
-      let transform = value - 100;
+      if (process.env.NODE_ENV !== 'production') {
+        if (!warnedInvalidMinMaxValue && (value < min || value > max || min >= max)) {
+          console.error(`MUI: The min, max, and value props in LinearProgress should be numbers where min < max and min <= value <= max. Received min=${min}, max=${max}, value=${value}.`);
+          warnedInvalidMinMaxValue = true;
+        }
+      }
+      const range = max - min;
+      let transform = (value - min) / range * 100 - 100;
       if (isRtl) {
         transform = -transform;
       }
-      inlineStyles.bar1.transform = `translateX(${transform}%)`;
+      inlineStyles.bar1.transform = range > 0 ? `translateX(${transform}%)` : 'translateX(-100%)'; // empty-state fallback when range is invalid
+
+      rootProps['aria-valuenow'] = value;
+      rootProps['aria-valuemin'] = min;
+      rootProps['aria-valuemax'] = max;
     } else if (process.env.NODE_ENV !== 'production') {
-      console.error('MUI: You need to provide a value prop ' + 'when using the determinate or buffer variant of LinearProgress .');
+      if (!warnedValueRequired) {
+        console.error('MUI: You need to provide a value prop when using the determinate or buffer variant of LinearProgress.');
+        warnedValueRequired = true;
+      }
     }
   }
   if (variant === 'buffer') {
     if (valueBuffer !== undefined) {
-      let transform = (valueBuffer || 0) - 100;
+      if (process.env.NODE_ENV !== 'production') {
+        if (!warnedInvalidMinMaxValueBuffer && (valueBuffer < min || valueBuffer > max || valueBuffer < value || min >= max)) {
+          console.error(`MUI: The min, max, value, and valueBuffer props in LinearProgress should be numbers where min < max and min <= value <= valueBuffer <= max. Received min=${min}, max=${max}, value=${value}, valueBuffer=${valueBuffer}.`);
+          warnedInvalidMinMaxValueBuffer = true;
+        }
+      }
+      const range = max - min;
+      let transform = (valueBuffer - min) / range * 100 - 100;
       if (isRtl) {
         transform = -transform;
       }
-      inlineStyles.bar2.transform = `translateX(${transform}%)`;
+      inlineStyles.bar2.transform = range > 0 ? `translateX(${transform}%)` : 'translateX(-100%)'; // empty-state fallback when range is invalid
     } else if (process.env.NODE_ENV !== 'production') {
-      console.error('MUI: You need to provide a valueBuffer prop ' + 'when using the buffer variant of LinearProgress.');
+      if (!warnedValueBufferRequired) {
+        console.error('MUI: You need to provide a valueBuffer prop when using the buffer variant of LinearProgress.');
+        warnedValueBufferRequired = true;
+      }
     }
   }
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(LinearProgressRoot, {
@@ -425,18 +514,28 @@ process.env.NODE_ENV !== "production" ? LinearProgress.propTypes /* remove-propt
    * @default 'primary'
    */
   color: _propTypes.default /* @typescript-to-proptypes-ignore */.oneOfType([_propTypes.default.oneOf(['inherit', 'primary', 'secondary']), _propTypes.default.string]),
+  /**
+   * The maximum value for the progress indicator for the determinate and buffer variants.
+   * @default 100
+   */
+  max: _propTypes.default.number,
+  /**
+   * The minimum value for the progress indicator for the determinate and buffer variants.
+   * @default 0
+   */
+  min: _propTypes.default.number,
   /**
    * The system prop that allows defining system overrides as well as additional CSS styles.
    */
   sx: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object, _propTypes.default.bool])), _propTypes.default.func, _propTypes.default.object]),
   /**
    * The value of the progress indicator for the determinate and buffer variants.
-   * Value between 0 and 100.
+   * Value between `min` and `max`.
    */
   value: _propTypes.default.number,
   /**
    * The value for the buffer variant.
-   * Value between 0 and 100.
+   * Value between `min` and `max`.
    */
   valueBuffer: _propTypes.default.number,
   /**