@mui/material 7.0.0-alpha.0 → 7.0.0-alpha.2

package/esm/Breadcrumbs/BreadcrumbCollapsed.js

@@ -0,0 +1,90 @@
+'use client';
+
+import * as React from 'react';
+import PropTypes from 'prop-types';
+import { emphasize } from '@mui/system/colorManipulator';
+import { styled } from "../zero-styled/index.js";
+import memoTheme from "../utils/memoTheme.js";
+import MoreHorizIcon from "../internal/svg-icons/MoreHoriz.js";
+import ButtonBase from "../ButtonBase/index.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const BreadcrumbCollapsedButton = styled(ButtonBase)(memoTheme(({
+  theme
+}) => ({
+  display: 'flex',
+  marginLeft: `calc(${theme.spacing(1)} * 0.5)`,
+  marginRight: `calc(${theme.spacing(1)} * 0.5)`,
+  ...(theme.palette.mode === 'light' ? {
+    backgroundColor: theme.palette.grey[100],
+    color: theme.palette.grey[700]
+  } : {
+    backgroundColor: theme.palette.grey[700],
+    color: theme.palette.grey[100]
+  }),
+  borderRadius: 2,
+  '&:hover, &:focus': {
+    ...(theme.palette.mode === 'light' ? {
+      backgroundColor: theme.palette.grey[200]
+    } : {
+      backgroundColor: theme.palette.grey[600]
+    })
+  },
+  '&:active': {
+    boxShadow: theme.shadows[0],
+    ...(theme.palette.mode === 'light' ? {
+      backgroundColor: emphasize(theme.palette.grey[200], 0.12)
+    } : {
+      backgroundColor: emphasize(theme.palette.grey[600], 0.12)
+    })
+  }
+})));
+const BreadcrumbCollapsedIcon = styled(MoreHorizIcon)({
+  width: 24,
+  height: 16
+});
+
+/**
+ * @ignore - internal component.
+ */
+function BreadcrumbCollapsed(props) {
+  const {
+    slots = {},
+    slotProps = {},
+    ...otherProps
+  } = props;
+  const ownerState = props;
+  return /*#__PURE__*/_jsx("li", {
+    children: /*#__PURE__*/_jsx(BreadcrumbCollapsedButton, {
+      focusRipple: true,
+      ...otherProps,
+      ownerState: ownerState,
+      children: /*#__PURE__*/_jsx(BreadcrumbCollapsedIcon, {
+        as: slots.CollapsedIcon,
+        ownerState: ownerState,
+        ...slotProps.collapsedIcon
+      })
+    })
+  });
+}
+process.env.NODE_ENV !== "production" ? BreadcrumbCollapsed.propTypes = {
+  /**
+   * The props used for the CollapsedIcon slot.
+   * @default {}
+   */
+  slotProps: PropTypes.shape({
+    collapsedIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
+  }),
+  /**
+   * The components used for each slot inside the BreadcumbCollapsed.
+   * Either a string to use a HTML element or a component.
+   * @default {}
+   */
+  slots: PropTypes.shape({
+    CollapsedIcon: PropTypes.elementType
+  }),
+  /**
+   * The system prop that allows defining system overrides as well as additional CSS styles.
+   */
+  sx: PropTypes.object
+} : void 0;
+export default BreadcrumbCollapsed;

package/esm/Breadcrumbs/Breadcrumbs.d.ts

@@ -0,0 +1,94 @@
+import * as React from 'react';
+import { SxProps } from '@mui/system';
+import { SlotComponentProps } from "../utils/types.js";
+import { Theme } from "../styles/index.js";
+import { OverridableComponent, OverrideProps } from "../OverridableComponent/index.js";
+import { BreadcrumbsClasses } from "./breadcrumbsClasses.js";
+import SvgIcon from "../SvgIcon/index.js";
+export interface BreadcrumbsCollapsedIconSlotPropsOverrides {}
+export interface BreadcrumbsOwnerState extends BreadcrumbsProps {
+  expanded: boolean;
+}
+export interface BreadcrumbsOwnProps {
+  /**
+   * The content of the component.
+   */
+  children?: React.ReactNode;
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<BreadcrumbsClasses>;
+  /**
+   * The components used for each slot inside the Breadcumb.
+   * Either a string to use a HTML element or a component.
+   * @default {}
+   */
+  slots?: {
+    CollapsedIcon?: React.ElementType;
+  };
+  /**
+   * The props used for each slot inside the Breadcumb.
+   * @default {}
+   */
+  slotProps?: {
+    /**
+     * Props applied to the CollapsedIcon slot.
+     * @default {}
+     */
+    collapsedIcon?: SlotComponentProps<typeof SvgIcon, BreadcrumbsCollapsedIconSlotPropsOverrides, BreadcrumbsOwnerState>;
+  };
+  /**
+   * Override the default label for the expand button.
+   *
+   * For localization purposes, you can use the provided [translations](https://mui.com/material-ui/guides/localization/).
+   * @default 'Show path'
+   */
+  expandText?: string;
+  /**
+   * If max items is exceeded, the number of items to show after the ellipsis.
+   * @default 1
+   */
+  itemsAfterCollapse?: number;
+  /**
+   * If max items is exceeded, the number of items to show before the ellipsis.
+   * @default 1
+   */
+  itemsBeforeCollapse?: number;
+  /**
+   * Specifies the maximum number of breadcrumbs to display. When there are more
+   * than the maximum number, only the first `itemsBeforeCollapse` and last `itemsAfterCollapse`
+   * will be shown, with an ellipsis in between.
+   * @default 8
+   */
+  maxItems?: number;
+  /**
+   * Custom separator node.
+   * @default '/'
+   */
+  separator?: React.ReactNode;
+  /**
+   * The system prop that allows defining system overrides as well as additional CSS styles.
+   */
+  sx?: SxProps<Theme>;
+}
+export interface BreadcrumbsTypeMap<AdditionalProps = {}, RootComponent extends React.ElementType = 'nav'> {
+  props: AdditionalProps & BreadcrumbsOwnProps;
+  defaultComponent: RootComponent;
+}
+
+/**
+ *
+ * Demos:
+ *
+ * - [Breadcrumbs](https://next.mui.com/material-ui/react-breadcrumbs/)
+ *
+ * API:
+ *
+ * - [Breadcrumbs API](https://next.mui.com/material-ui/api/breadcrumbs/)
+ * - inherits [Typography API](https://next.mui.com/material-ui/api/typography/)
+ */
+declare const Breadcrumbs: OverridableComponent<BreadcrumbsTypeMap>;
+export type BreadcrumbsProps<RootComponent extends React.ElementType = BreadcrumbsTypeMap['defaultComponent'], AdditionalProps = {}> = OverrideProps<BreadcrumbsTypeMap<AdditionalProps, RootComponent>, RootComponent> & {
+  component?: React.ElementType;
+};
+export default Breadcrumbs;

package/esm/Breadcrumbs/Breadcrumbs.js

@@ -0,0 +1,240 @@
+'use client';
+
+import * as React from 'react';
+import { isFragment } from 'react-is';
+import PropTypes from 'prop-types';
+import clsx from 'clsx';
+import integerPropType from '@mui/utils/integerPropType';
+import composeClasses from '@mui/utils/composeClasses';
+import useSlotProps from '@mui/utils/useSlotProps';
+import { styled } from "../zero-styled/index.js";
+import { useDefaultProps } from "../DefaultPropsProvider/index.js";
+import Typography from "../Typography/index.js";
+import BreadcrumbCollapsed from "./BreadcrumbCollapsed.js";
+import breadcrumbsClasses, { getBreadcrumbsUtilityClass } from "./breadcrumbsClasses.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const useUtilityClasses = ownerState => {
+  const {
+    classes
+  } = ownerState;
+  const slots = {
+    root: ['root'],
+    li: ['li'],
+    ol: ['ol'],
+    separator: ['separator']
+  };
+  return composeClasses(slots, getBreadcrumbsUtilityClass, classes);
+};
+const BreadcrumbsRoot = styled(Typography, {
+  name: 'MuiBreadcrumbs',
+  slot: 'Root',
+  overridesResolver: (props, styles) => {
+    return [{
+      [`& .${breadcrumbsClasses.li}`]: styles.li
+    }, styles.root];
+  }
+})({});
+const BreadcrumbsOl = styled('ol', {
+  name: 'MuiBreadcrumbs',
+  slot: 'Ol',
+  overridesResolver: (props, styles) => styles.ol
+})({
+  display: 'flex',
+  flexWrap: 'wrap',
+  alignItems: 'center',
+  padding: 0,
+  margin: 0,
+  listStyle: 'none'
+});
+const BreadcrumbsSeparator = styled('li', {
+  name: 'MuiBreadcrumbs',
+  slot: 'Separator',
+  overridesResolver: (props, styles) => styles.separator
+})({
+  display: 'flex',
+  userSelect: 'none',
+  marginLeft: 8,
+  marginRight: 8
+});
+function insertSeparators(items, className, separator, ownerState) {
+  return items.reduce((acc, current, index) => {
+    if (index < items.length - 1) {
+      acc = acc.concat(current, /*#__PURE__*/_jsx(BreadcrumbsSeparator, {
+        "aria-hidden": true,
+        className: className,
+        ownerState: ownerState,
+        children: separator
+      }, `separator-${index}`));
+    } else {
+      acc.push(current);
+    }
+    return acc;
+  }, []);
+}
+const Breadcrumbs = /*#__PURE__*/React.forwardRef(function Breadcrumbs(inProps, ref) {
+  const props = useDefaultProps({
+    props: inProps,
+    name: 'MuiBreadcrumbs'
+  });
+  const {
+    children,
+    className,
+    component = 'nav',
+    slots = {},
+    slotProps = {},
+    expandText = 'Show path',
+    itemsAfterCollapse = 1,
+    itemsBeforeCollapse = 1,
+    maxItems = 8,
+    separator = '/',
+    ...other
+  } = props;
+  const [expanded, setExpanded] = React.useState(false);
+  const ownerState = {
+    ...props,
+    component,
+    expanded,
+    expandText,
+    itemsAfterCollapse,
+    itemsBeforeCollapse,
+    maxItems,
+    separator
+  };
+  const classes = useUtilityClasses(ownerState);
+  const collapsedIconSlotProps = useSlotProps({
+    elementType: slots.CollapsedIcon,
+    externalSlotProps: slotProps.collapsedIcon,
+    ownerState
+  });
+  const listRef = React.useRef(null);
+  const renderItemsBeforeAndAfter = allItems => {
+    const handleClickExpand = () => {
+      setExpanded(true);
+
+      // The clicked element received the focus but gets removed from the DOM.
+      // Let's keep the focus in the component after expanding.
+      // Moving it to the <ol> or <nav> does not cause any announcement in NVDA.
+      // By moving it to some link/button at least we have some announcement.
+      const focusable = listRef.current.querySelector('a[href],button,[tabindex]');
+      if (focusable) {
+        focusable.focus();
+      }
+    };
+
+    // This defends against someone passing weird input, to ensure that if all
+    // items would be shown anyway, we just show all items without the EllipsisItem
+    if (itemsBeforeCollapse + itemsAfterCollapse >= allItems.length) {
+      if (process.env.NODE_ENV !== 'production') {
+        console.error(['MUI: You have provided an invalid combination of props to the Breadcrumbs.', `itemsAfterCollapse={${itemsAfterCollapse}} + itemsBeforeCollapse={${itemsBeforeCollapse}} >= maxItems={${maxItems}}`].join('\n'));
+      }
+      return allItems;
+    }
+    return [...allItems.slice(0, itemsBeforeCollapse), /*#__PURE__*/_jsx(BreadcrumbCollapsed, {
+      "aria-label": expandText,
+      slots: {
+        CollapsedIcon: slots.CollapsedIcon
+      },
+      slotProps: {
+        collapsedIcon: collapsedIconSlotProps
+      },
+      onClick: handleClickExpand
+    }, "ellipsis"), ...allItems.slice(allItems.length - itemsAfterCollapse, allItems.length)];
+  };
+  const allItems = React.Children.toArray(children).filter(child => {
+    if (process.env.NODE_ENV !== 'production') {
+      if (isFragment(child)) {
+        console.error(["MUI: The Breadcrumbs component doesn't accept a Fragment as a child.", 'Consider providing an array instead.'].join('\n'));
+      }
+    }
+    return /*#__PURE__*/React.isValidElement(child);
+  }).map((child, index) => /*#__PURE__*/_jsx("li", {
+    className: classes.li,
+    children: child
+  }, `child-${index}`));
+  return /*#__PURE__*/_jsx(BreadcrumbsRoot, {
+    ref: ref,
+    component: component,
+    color: "textSecondary",
+    className: clsx(classes.root, className),
+    ownerState: ownerState,
+    ...other,
+    children: /*#__PURE__*/_jsx(BreadcrumbsOl, {
+      className: classes.ol,
+      ref: listRef,
+      ownerState: ownerState,
+      children: insertSeparators(expanded || maxItems && allItems.length <= maxItems ? allItems : renderItemsBeforeAndAfter(allItems), classes.separator, separator, ownerState)
+    })
+  });
+});
+process.env.NODE_ENV !== "production" ? Breadcrumbs.propTypes /* remove-proptypes */ = {
+  // ┌────────────────────────────── Warning ──────────────────────────────┐
+  // │ These PropTypes are generated from the TypeScript type definitions. │
+  // │    To update them, edit the d.ts file and run `pnpm proptypes`.     │
+  // └─────────────────────────────────────────────────────────────────────┘
+  /**
+   * The content of the component.
+   */
+  children: PropTypes.node,
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes: PropTypes.object,
+  /**
+   * @ignore
+   */
+  className: PropTypes.string,
+  /**
+   * The component used for the root node.
+   * Either a string to use a HTML element or a component.
+   */
+  component: PropTypes.elementType,
+  /**
+   * Override the default label for the expand button.
+   *
+   * For localization purposes, you can use the provided [translations](https://mui.com/material-ui/guides/localization/).
+   * @default 'Show path'
+   */
+  expandText: PropTypes.string,
+  /**
+   * If max items is exceeded, the number of items to show after the ellipsis.
+   * @default 1
+   */
+  itemsAfterCollapse: integerPropType,
+  /**
+   * If max items is exceeded, the number of items to show before the ellipsis.
+   * @default 1
+   */
+  itemsBeforeCollapse: integerPropType,
+  /**
+   * Specifies the maximum number of breadcrumbs to display. When there are more
+   * than the maximum number, only the first `itemsBeforeCollapse` and last `itemsAfterCollapse`
+   * will be shown, with an ellipsis in between.
+   * @default 8
+   */
+  maxItems: integerPropType,
+  /**
+   * Custom separator node.
+   * @default '/'
+   */
+  separator: PropTypes.node,
+  /**
+   * The props used for each slot inside the Breadcumb.
+   * @default {}
+   */
+  slotProps: PropTypes.shape({
+    collapsedIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
+  }),
+  /**
+   * The components used for each slot inside the Breadcumb.
+   * Either a string to use a HTML element or a component.
+   * @default {}
+   */
+  slots: PropTypes.shape({
+    CollapsedIcon: PropTypes.elementType
+  }),
+  /**
+   * The system prop that allows defining system overrides as well as additional CSS styles.
+   */
+  sx: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.func, PropTypes.object, PropTypes.bool])), PropTypes.func, PropTypes.object])
+} : void 0;
+export default Breadcrumbs;

package/esm/Breadcrumbs/breadcrumbsClasses.d.ts

@@ -0,0 +1,14 @@
+export interface BreadcrumbsClasses {
+  /** Styles applied to the root element. */
+  root: string;
+  /** Styles applied to the ol element. */
+  ol: string;
+  /** Styles applied to the li element. */
+  li: string;
+  /** Styles applied to the separator element. */
+  separator: string;
+}
+export type BreadcrumbsClassKey = keyof BreadcrumbsClasses;
+export declare function getBreadcrumbsUtilityClass(slot: string): string;
+declare const breadcrumbsClasses: BreadcrumbsClasses;
+export default breadcrumbsClasses;

package/esm/Breadcrumbs/breadcrumbsClasses.js

@@ -0,0 +1,7 @@
+import generateUtilityClasses from '@mui/utils/generateUtilityClasses';
+import generateUtilityClass from '@mui/utils/generateUtilityClass';
+export function getBreadcrumbsUtilityClass(slot) {
+  return generateUtilityClass('MuiBreadcrumbs', slot);
+}
+const breadcrumbsClasses = generateUtilityClasses('MuiBreadcrumbs', ['root', 'ol', 'li', 'separator']);
+export default breadcrumbsClasses;

package/esm/Breadcrumbs/index.d.ts

@@ -0,0 +1,4 @@
+export { default } from "./Breadcrumbs.js";
+export * from "./Breadcrumbs.js";
+export { default as breadcrumbsClasses } from "./breadcrumbsClasses.js";
+export * from "./breadcrumbsClasses.js";

package/esm/Breadcrumbs/index.js

@@ -0,0 +1,3 @@
+export { default } from "./Breadcrumbs.js";
+export { default as breadcrumbsClasses } from "./breadcrumbsClasses.js";
+export * from "./breadcrumbsClasses.js";

package/esm/Button/Button.d.ts

@@ -0,0 +1,130 @@
+import * as React from 'react';
+import { DistributiveOmit, OverridableStringUnion } from '@mui/types';
+import { SxProps } from '@mui/system';
+import { Theme } from "../styles/index.js";
+import { ExtendButtonBase, ExtendButtonBaseTypeMap } from "../ButtonBase/index.js";
+import { OverrideProps, OverridableComponent, OverridableTypeMap } from "../OverridableComponent/index.js";
+import { ButtonClasses } from "./buttonClasses.js";
+export interface ButtonPropsVariantOverrides {}
+export interface ButtonPropsColorOverrides {}
+export interface ButtonPropsSizeOverrides {}
+export interface ButtonOwnProps {
+  /**
+   * The content of the component.
+   */
+  children?: React.ReactNode;
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<ButtonClasses>;
+  /**
+   * The color of the component.
+   * It supports both default and custom theme colors, which can be added as shown in the
+   * [palette customization guide](https://mui.com/material-ui/customization/palette/#custom-colors).
+   * @default 'primary'
+   */
+  color?: OverridableStringUnion<'inherit' | 'primary' | 'secondary' | 'success' | 'error' | 'info' | 'warning', ButtonPropsColorOverrides>;
+  /**
+   * If `true`, the component is disabled.
+   * @default false
+   */
+  disabled?: boolean;
+  /**
+   * If `true`, no elevation is used.
+   * @default false
+   */
+  disableElevation?: boolean;
+  /**
+   * If `true`, the  keyboard focus ripple is disabled.
+   * @default false
+   */
+  disableFocusRipple?: boolean;
+  /**
+   * Element placed after the children.
+   */
+  endIcon?: React.ReactNode;
+  /**
+   * If `true`, the button will take up the full width of its container.
+   * @default false
+   */
+  fullWidth?: boolean;
+  /**
+   * The URL to link to when the button is clicked.
+   * If defined, an `a` element will be used as the root node.
+   */
+  href?: string;
+  /**
+   * If `true`, the loading indicator is visible and the button is disabled.
+   * If `true | false`, the loading wrapper is always rendered before the children to prevent [Google Translation Crash](https://github.com/mui/material-ui/issues/27853).
+   * @default null
+   */
+  loading?: boolean | null;
+  /**
+   * Element placed before the children if the button is in loading state.
+   * The node should contain an element with `role="progressbar"` with an accessible name.
+   * By default, it renders a `CircularProgress` that is labeled by the button itself.
+   * @default <CircularProgress color="inherit" size={16} />
+   */
+  loadingIndicator?: React.ReactNode;
+  /**
+   * The loading indicator can be positioned on the start, end, or the center of the button.
+   * @default 'center'
+   */
+  loadingPosition?: 'start' | 'end' | 'center';
+  /**
+   * The size of the component.
+   * `small` is equivalent to the dense button styling.
+   * @default 'medium'
+   */
+  size?: OverridableStringUnion<'small' | 'medium' | 'large', ButtonPropsSizeOverrides>;
+  /**
+   * Element placed before the children.
+   */
+  startIcon?: React.ReactNode;
+  /**
+   * The system prop that allows defining system overrides as well as additional CSS styles.
+   */
+  sx?: SxProps<Theme>;
+  /**
+   * The variant to use.
+   * @default 'text'
+   */
+  variant?: OverridableStringUnion<'text' | 'outlined' | 'contained', ButtonPropsVariantOverrides>;
+}
+export type ButtonTypeMap<AdditionalProps = {}, RootComponent extends React.ElementType = 'button'> = ExtendButtonBaseTypeMap<{
+  props: AdditionalProps & ButtonOwnProps;
+  defaultComponent: RootComponent;
+}>;
+
+/**
+ * utility to create component types that inherit props from ButtonBase.
+ * This component has an additional overload if the `href` prop is set which
+ * can make extension quite tricky
+ */
+export interface ExtendButtonTypeMap<TypeMap extends OverridableTypeMap> {
+  props: TypeMap['props'] & (TypeMap['props'] extends {
+    classes?: Record<string, string>;
+  } ? DistributiveOmit<ButtonTypeMap['props'], 'classes'> : ButtonTypeMap['props']);
+  defaultComponent: TypeMap['defaultComponent'];
+}
+export type ExtendButton<TypeMap extends OverridableTypeMap> = ((props: {
+  href: string;
+} & OverrideProps<ExtendButtonBaseTypeMap<TypeMap>, 'a'>) => React.JSX.Element) & OverridableComponent<ExtendButtonBaseTypeMap<TypeMap>>;
+
+/**
+ *
+ * Demos:
+ *
+ * - [Button Group](https://next.mui.com/material-ui/react-button-group/)
+ * - [Button](https://next.mui.com/material-ui/react-button/)
+ *
+ * API:
+ *
+ * - [Button API](https://next.mui.com/material-ui/api/button/)
+ * - inherits [ButtonBase API](https://next.mui.com/material-ui/api/button-base/)
+ */
+declare const Button: ExtendButtonBase<ButtonTypeMap>;
+export type ButtonProps<RootComponent extends React.ElementType = ButtonTypeMap['defaultComponent'], AdditionalProps = {}> = OverrideProps<ButtonTypeMap<AdditionalProps, RootComponent>, RootComponent> & {
+  component?: React.ElementType;
+};
+export default Button;