@mui/types 7.1.3 → 7.2.0

package/OverridableComponentAugmentation.ts

@@ -0,0 +1,44 @@
+import * as React from 'react';
+
+declare module '@mui/types' {
+  /**
+   * A component whose root component can be controlled via a `component` prop.
+   *
+   * Adjusts valid props based on the type of `component`.
+   */
+  interface OverridableComponent<M extends OverridableTypeMap> {
+    <C extends React.ElementType>(
+      props: {
+        /**
+         * The component used for the root node.
+         * Either a string to use a HTML element or a component.
+         */
+        component: C;
+      } & OverridePropsVer2<M, C>,
+    ): JSX.Element;
+    (props: DefaultComponentPropsVer2<M>): JSX.Element;
+    propTypes?: any;
+  }
+
+  /**
+   * Props of the component if `component={Component}` is used.
+   */
+  // prettier-ignore
+  type OverridePropsVer2<
+    M extends OverridableTypeMap,
+    C extends React.ElementType
+  > = (
+    & BaseProps<M>
+    & DistributiveOmit<React.ComponentPropsWithoutRef<C>, keyof BaseProps<M>>
+    & { ref?: React.Ref<Element> }
+  );
+
+  /**
+   * Props if `component={Component}` is NOT used.
+   */
+  // prettier-ignore
+  type DefaultComponentPropsVer2<M extends OverridableTypeMap> =
+    & BaseProps<M>
+    & DistributiveOmit<React.ComponentPropsWithoutRef<M['defaultComponent']>, keyof BaseProps<M>>
+    & { ref?: React.Ref<Element> };
+}

package/index.d.ts

@@ -67,7 +67,7 @@ type GenerateStringUnion<T> = Extract<
 >;
 
 // https://stackoverflow.com/questions/53807517/how-to-test-if-two-types-are-exactly-the-same
-type IfEquals<T, U, Y = unknown, N = never> = (<G>() => G extends T ? 1 : 2) extends <
+export type IfEquals<T, U, Y = unknown, N = never> = (<G>() => G extends T ? 1 : 2) extends <
   G,
 >() => G extends U ? 1 : 2
   ? Y
@@ -92,6 +92,10 @@ export function expectType<Expected, Actual>(actual: IfEquals<Actual, Expected,
  * Adjusts valid props based on the type of `component`.
  */
 export interface OverridableComponent<M extends OverridableTypeMap> {
+  // If you make any changes to this interface, please make sure to update the
+  // `OverridableComponent` type in `mui-material/src/OverridableComponent.d.ts` as well.
+  // Also, there are types in MUI Base that have a similar shape to this interface
+  // (e.g. SelectUnstyledType, OptionUnstyledType, etc.).
   <C extends React.ElementType>(
     props: {
       /**

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@mui/types",
-  "version": "7.1.3",
+  "version": "7.2.0",
   "private": false,
   "author": "MUI Team",
   "description": "Utility types for MUI.",
   "types": "./index.d.ts",
   "files": [
-    "index.d.ts"
+    "index.d.ts",
+    "OverridableComponentAugmentation.ts"
   ],
   "keywords": [
     "react",