@mui/utils 7.0.2 → 7.1.0

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.
Files changed (124) hide show
  1. package/CHANGELOG.md +97 -0
  2. package/deprecatedPropType/deprecatedPropType.d.ts +2 -1
  3. package/esm/deprecatedPropType/deprecatedPropType.d.ts +2 -1
  4. package/esm/index.js +1 -1
  5. package/esm/integerPropType/integerPropType.d.ts +1 -0
  6. package/esm/integerPropType/integerPropType.js +4 -3
  7. package/esm/requirePropFactory/requirePropFactory.d.ts +2 -1
  8. package/esm/requirePropFactory/requirePropFactory.js +1 -1
  9. package/esm/useControlled/index.js +2 -1
  10. package/esm/useControlled/useControlled.d.ts +2 -1
  11. package/esm/useControlled/useControlled.js +12 -6
  12. package/index.js +1 -1
  13. package/integerPropType/integerPropType.d.ts +1 -0
  14. package/integerPropType/integerPropType.js +4 -3
  15. package/package.json +4 -4
  16. package/requirePropFactory/requirePropFactory.d.ts +2 -1
  17. package/requirePropFactory/requirePropFactory.js +1 -1
  18. package/useControlled/index.js +14 -2
  19. package/useControlled/useControlled.d.ts +2 -1
  20. package/useControlled/useControlled.js +12 -6
  21. package/modern/ClassNameGenerator/ClassNameGenerator.d.ts +0 -6
  22. package/modern/ClassNameGenerator/index.d.ts +0 -1
  23. package/modern/HTMLElementType/HTMLElementType.d.ts +0 -3
  24. package/modern/HTMLElementType/index.d.ts +0 -1
  25. package/modern/appendOwnerState/appendOwnerState.d.ts +0 -20
  26. package/modern/appendOwnerState/index.d.ts +0 -2
  27. package/modern/capitalize/capitalize.d.ts +0 -1
  28. package/modern/capitalize/index.d.ts +0 -1
  29. package/modern/chainPropTypes/chainPropTypes.d.ts +0 -2
  30. package/modern/chainPropTypes/index.d.ts +0 -1
  31. package/modern/clamp/clamp.d.ts +0 -2
  32. package/modern/clamp/index.d.ts +0 -1
  33. package/modern/composeClasses/composeClasses.d.ts +0 -29
  34. package/modern/composeClasses/index.d.ts +0 -1
  35. package/modern/createChainedFunction/createChainedFunction.d.ts +0 -7
  36. package/modern/createChainedFunction/index.d.ts +0 -1
  37. package/modern/debounce/debounce.d.ts +0 -4
  38. package/modern/debounce/index.d.ts +0 -2
  39. package/modern/deepmerge/deepmerge.d.ts +0 -23
  40. package/modern/deepmerge/index.d.ts +0 -2
  41. package/modern/deprecatedPropType/deprecatedPropType.d.ts +0 -1
  42. package/modern/deprecatedPropType/index.d.ts +0 -1
  43. package/modern/elementAcceptingRef/elementAcceptingRef.d.ts +0 -3
  44. package/modern/elementAcceptingRef/index.d.ts +0 -1
  45. package/modern/elementTypeAcceptingRef/elementTypeAcceptingRef.d.ts +0 -3
  46. package/modern/elementTypeAcceptingRef/index.d.ts +0 -1
  47. package/modern/exactProp/exactProp.d.ts +0 -2
  48. package/modern/exactProp/index.d.ts +0 -1
  49. package/modern/extractEventHandlers/extractEventHandlers.d.ts +0 -10
  50. package/modern/extractEventHandlers/index.d.ts +0 -1
  51. package/modern/formatMuiErrorMessage/formatMuiErrorMessage.d.ts +0 -11
  52. package/modern/formatMuiErrorMessage/index.d.ts +0 -1
  53. package/modern/generateUtilityClass/generateUtilityClass.d.ts +0 -17
  54. package/modern/generateUtilityClass/index.d.ts +0 -2
  55. package/modern/generateUtilityClasses/generateUtilityClasses.d.ts +0 -1
  56. package/modern/generateUtilityClasses/index.d.ts +0 -1
  57. package/modern/getDisplayName/getDisplayName.d.ts +0 -7
  58. package/modern/getDisplayName/index.d.ts +0 -1
  59. package/modern/getReactElementRef/getReactElementRef.d.ts +0 -9
  60. package/modern/getReactElementRef/index.d.ts +0 -1
  61. package/modern/getReactNodeRef/getReactNodeRef.d.ts +0 -11
  62. package/modern/getReactNodeRef/index.d.ts +0 -1
  63. package/modern/getScrollbarSize/getScrollbarSize.d.ts +0 -1
  64. package/modern/getScrollbarSize/index.d.ts +0 -1
  65. package/modern/getValidReactChildren/getValidReactChildren.d.ts +0 -8
  66. package/modern/getValidReactChildren/index.d.ts +0 -1
  67. package/modern/index.d.ts +0 -51
  68. package/modern/integerPropType/index.d.ts +0 -2
  69. package/modern/integerPropType/integerPropType.d.ts +0 -3
  70. package/modern/isFocusVisible/index.d.ts +0 -1
  71. package/modern/isFocusVisible/isFocusVisible.d.ts +0 -4
  72. package/modern/isHostComponent/index.d.ts +0 -1
  73. package/modern/isHostComponent/isHostComponent.d.ts +0 -6
  74. package/modern/isMuiElement/index.d.ts +0 -1
  75. package/modern/isMuiElement/isMuiElement.d.ts +0 -1
  76. package/modern/mergeSlotProps/index.d.ts +0 -2
  77. package/modern/mergeSlotProps/mergeSlotProps.d.ts +0 -56
  78. package/modern/omitEventHandlers/index.d.ts +0 -1
  79. package/modern/omitEventHandlers/omitEventHandlers.d.ts +0 -9
  80. package/modern/ownerDocument/index.d.ts +0 -1
  81. package/modern/ownerDocument/ownerDocument.d.ts +0 -1
  82. package/modern/ownerWindow/index.d.ts +0 -1
  83. package/modern/ownerWindow/ownerWindow.d.ts +0 -1
  84. package/modern/ponyfillGlobal/index.d.ts +0 -1
  85. package/modern/ponyfillGlobal/ponyfillGlobal.d.ts +0 -6
  86. package/modern/refType/index.d.ts +0 -1
  87. package/modern/refType/refType.d.ts +0 -3
  88. package/modern/requirePropFactory/index.d.ts +0 -1
  89. package/modern/requirePropFactory/requirePropFactory.d.ts +0 -2
  90. package/modern/resolveComponentProps/index.d.ts +0 -1
  91. package/modern/resolveComponentProps/resolveComponentProps.d.ts +0 -6
  92. package/modern/resolveProps/index.d.ts +0 -1
  93. package/modern/resolveProps/resolveProps.d.ts +0 -12
  94. package/modern/setRef/index.d.ts +0 -1
  95. package/modern/setRef/setRef.d.ts +0 -15
  96. package/modern/types/index.d.ts +0 -7
  97. package/modern/unsupportedProp/index.d.ts +0 -1
  98. package/modern/unsupportedProp/unsupportedProp.d.ts +0 -3
  99. package/modern/useControlled/index.d.ts +0 -2
  100. package/modern/useControlled/useControlled.d.ts +0 -19
  101. package/modern/useEnhancedEffect/index.d.ts +0 -1
  102. package/modern/useEnhancedEffect/useEnhancedEffect.d.ts +0 -10
  103. package/modern/useEventCallback/index.d.ts +0 -1
  104. package/modern/useEventCallback/useEventCallback.d.ts +0 -7
  105. package/modern/useForkRef/index.d.ts +0 -1
  106. package/modern/useForkRef/useForkRef.d.ts +0 -17
  107. package/modern/useId/index.d.ts +0 -1
  108. package/modern/useId/useId.d.ts +0 -7
  109. package/modern/useIsFocusVisible/index.d.ts +0 -2
  110. package/modern/useIsFocusVisible/useIsFocusVisible.d.ts +0 -9
  111. package/modern/useLazyRef/index.d.ts +0 -1
  112. package/modern/useLazyRef/useLazyRef.d.ts +0 -9
  113. package/modern/useLocalStorageState/index.d.ts +0 -1
  114. package/modern/useLocalStorageState/useLocalStorageState.d.ts +0 -14
  115. package/modern/useOnMount/index.d.ts +0 -1
  116. package/modern/useOnMount/useOnMount.d.ts +0 -5
  117. package/modern/usePreviousProps/index.d.ts +0 -1
  118. package/modern/usePreviousProps/usePreviousProps.d.ts +0 -2
  119. package/modern/useSlotProps/index.d.ts +0 -2
  120. package/modern/useSlotProps/useSlotProps.d.ts +0 -41
  121. package/modern/useTimeout/index.d.ts +0 -2
  122. package/modern/useTimeout/useTimeout.d.ts +0 -11
  123. package/modern/visuallyHidden/index.d.ts +0 -1
  124. package/modern/visuallyHidden/visuallyHidden.d.ts +0 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,102 @@
1
1
  # [Versions](https://mui.com/versions/)
2
2
 
3
+ ## 7.1.0
4
+
5
+ <!-- generated comparing v7.0.2..master -->
6
+
7
+ _May 6, 2025_
8
+
9
+ A big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
10
+
11
+ - 🎉 Material UI now works with **Tailwind CSS v4**! Check out the [setup guide](https://mui.com/material-ui/integrations/tailwindcss/tailwindcss-v4/).
12
+
13
+ ### `@mui/material@7.1.0`
14
+
15
+ - [InputBase] Text cursor jumps several lines up when inserting text fragment with new line at the end (#45246) @yermartee
16
+ - [OutlinedInput] Add missing `notchedOutline` slot (#45917) @siriwatknp
17
+ - [Snackbar] Skip default `onClickAway` behavior when `defaultMuiPrevented` is provided (#45629) @sai6855
18
+ - [Avatar] Fix img slot types and add missing slots (#45483) @siriwatknp
19
+ - [Badge] Replace useSlotProps with useSlot hook (#45871) @sai6855
20
+ - [BottomNavigationAction] Add slots and slotProps (#45776) @sai6855
21
+ - [CardActionArea] Add slots and slotProps (#45866) @sai6855
22
+ - [useMediaQuery] Add warning and docs for using `useMediaQuery('print')` (#44790) @good-jinu
23
+ - Remove unnecessary clsx usages (#46084) @sai6855
24
+ - Corrected generic type definition in `SelectChangeEvent` (#45941) @SuyashShukla0007
25
+ - Fix theme object changes between renders (#45863) @siriwatknp
26
+
27
+ ### `@mui/material-nextjs@7.1.0`
28
+
29
+ - Add option to enable CSS layers for pages router (#45596) @siriwatknp
30
+ - Do not wrap `@layer` order rules in App Router (#45864) @Nayeem-XTREME
31
+
32
+ ### `@mui/system@7.1.0`
33
+
34
+ - Fix `@mui/system` types organization (#45860) @Janpot
35
+
36
+ ### `@mui/styled-engine@7.1.0`
37
+
38
+ - Infer `ownerState` from props in `styled` (#46083) @siriwatknp
39
+ - Fix style overrides variants type (#45478) @siriwatknp
40
+
41
+ ### Docs
42
+
43
+ - [Avatar] Add avatar upload demo (#45986) @Demianeen
44
+ - [Dialog] Remove deprecated props usage in demos (#45923) @sai6855
45
+ - [Menu] Update `paper` slot JSDoc default from `Paper` to `PopoverPaper` (#45722) @andreachiera
46
+ - [examples] Remove create-react-app usages (#45426) @CodeLeom
47
+ - Add `AccordionSummary` to the v5 breaking change migration (#45947) @siriwatknp
48
+ - Update CSS variable usage in migration guide for Pigment CSS (#46033) @sai6855
49
+ - Fix docs API dark mode color (#46086) @alexfauquette
50
+ - Add a guide for extending Material UI classes in Tailwind CSS (#46039) @siriwatknp
51
+ - Add `InitColorSchemeScript` docs and API (#45927) @siriwatknp
52
+ - Add Tailwind CSS v4 integration guide (#45906) @siriwatknp
53
+ - Fix 301 links to the system v6 (#45931) @oliviertassinari
54
+ - Add notification for MUI X v8 announcement (#45942) @joserodolfofreitas
55
+ - Fix som 301 redirections (ae84b35) @oliviertassinari
56
+ - Fix some 301 redirections (057384e) @oliviertassinari
57
+ - Fix logo is not centered on small screens (#45920) @crabsim
58
+ - Fix line break typo (a2a62d5) @oliviertassinari
59
+ - Fix markdown typo in templates.md (#45914) @scyzoryck
60
+ - Add Next.js App Router guide for custom classnames (#45852) @siriwatknp
61
+
62
+ ### Core
63
+
64
+ - [code-infra] Give a stable name to dev tool app (3889ded) @oliviertassinari
65
+ - [code-infra] Normalize author package in org (8135638) @oliviertassinari
66
+ - [code-infra] Correct some manually curated .d.ts files (#46054) @Janpot
67
+ - [code-infra] Align deps versions (#46048) @Janpot
68
+ - [code-infra] Fix dynamic import in imports resolver (#46046) @Janpot
69
+ - [code-infra] Eliminate `@mui/utils` deep imports (#46004) @Janpot
70
+ - [code-infra] Expand renovate.json for react types (#45935) @Janpot
71
+ - [code-infra] Make Argos upload script reusable (#45883) @Janpot
72
+ - [code-infra] Disallow redundant window prefixes for globals (#45880) @Janpot
73
+ - [code-infra] Remove type generation of modern build (#45912) @Janpot
74
+ - [code-infra] Clean up bundle size checker (#45622) @Janpot
75
+ - [code-infra] Fix `StrictMode` effects not being called twice in React 19 tests (#45812) @bernardobelchior
76
+ - [code-infra] Convert `@mui/utils` to typescript (#45671) @Janpot
77
+ - [docs-infra] Improve export into sandbox package.json (#46044) @oliviertassinari
78
+ - [docs-infra] Update feedback Node.js to v22 (#46064) @oliviertassinari
79
+ - [docs-infra] Normalize netlify.toml in org (b101d5c) @oliviertassinari
80
+ - [docs-infra] Uniformize Vale between repositories (0f79796) @oliviertassinari
81
+ - [docs-infra] Fix Vale no longer working (#46029) @oliviertassinari
82
+ - [docs-infra] Remove demo styling switch (#45926) @Janpot
83
+ - [docs-infra] StackBlitz WebContainer demos (#45924) @Janpot
84
+ - [docs-infra] Fix feedback management (#45872) @alexfauquette
85
+ - [test] Replace `playwright` with `@playwright/test` (#45998) @ZeeshanTamboli
86
+ - Fix internal version duplication (#46051) @oliviertassinari
87
+ - Avoid the need for `@mui/material/themeCssVarsAugmentation` (#46053) @Janpot
88
+ - Add security label to dependabot PRs (0a5c027) @oliviertassinari
89
+ - Remove unecessary versions (#46034) @oliviertassinari
90
+ - Remove redundant overrides resolver (#45970) @romgrk
91
+ - Fix duplicate branch reference (#45915) @oliviertassinari
92
+ - Fix outdated <link rel="shortcut icon" (#45916) @oliviertassinari
93
+ - Fix redirection chains (#45930) @oliviertassinari
94
+ - Run pnpm docs:sync-team (beee09f) @oliviertassinari
95
+ - Add `pkg.pr.new` publishing (#42984) @Aslemammad
96
+ - Remove @mui/base from the master branch (#45857) @mnajdova
97
+
98
+ All contributors of this release in alphabetical order: @alexfauquette, @andreachiera, @Aslemammad, @bernardobelchior, @CodeLeom, @crabsim, @Demianeen, @good-jinu, @Janpot, @joserodolfofreitas, @mnajdova, @Nayeem-XTREME, @oliviertassinari, @renovate[bot], @romgrk, @sai6855, @scyzoryck, @siriwatknp, @SuyashShukla0007, @yermartee, @ZeeshanTamboli
99
+
3
100
  ## 7.0.2
4
101
 
5
102
  _Apr 9, 2025_
@@ -1 +1,2 @@
1
- export default function deprecatedPropType<T>(validator: T, reason: string): T;
1
+ import { Validator } from 'prop-types';
2
+ export default function deprecatedPropType<T>(validator: Validator<T>, reason: string): Validator<T>;
@@ -1 +1,2 @@
1
- export default function deprecatedPropType<T>(validator: T, reason: string): T;
1
+ import { Validator } from 'prop-types';
2
+ export default function deprecatedPropType<T>(validator: Validator<T>, reason: string): Validator<T>;
package/esm/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @mui/utils v7.0.2
2
+ * @mui/utils v7.1.0
3
3
  *
4
4
  * @license MIT
5
5
  * This source code is licensed under the MIT license found in the
@@ -1,3 +1,4 @@
1
1
  import PropTypes from 'prop-types';
2
+ export declare function getTypeByValue(value: any): string;
2
3
  declare const integerPropType: PropTypes.Requireable<number>;
3
4
  export default integerPropType;
@@ -29,16 +29,17 @@ function requiredInteger(props, propName, componentName, location) {
29
29
  }
30
30
  return null;
31
31
  }
32
- function validator(props, propName, ...other) {
32
+ function validator(props, propName, componentName, location) {
33
33
  const propValue = props[propName];
34
34
  if (propValue === undefined) {
35
35
  return null;
36
36
  }
37
- return requiredInteger(props, propName, ...other);
37
+ return requiredInteger(props, propName, componentName, location);
38
38
  }
39
39
  function validatorNoop() {
40
40
  return null;
41
41
  }
42
42
  validator.isRequired = requiredInteger;
43
43
  validatorNoop.isRequired = validatorNoop;
44
- export default process.env.NODE_ENV === 'production' ? validatorNoop : validator;
44
+ const integerPropType = process.env.NODE_ENV === 'production' ? validatorNoop : validator;
45
+ export default integerPropType;
@@ -1,2 +1,3 @@
1
1
  import * as React from 'react';
2
- export default function requirePropFactory(componentNameInError: string, Component?: React.JSXElementConstructor<unknown>): any;
2
+ import PropTypes from 'prop-types';
3
+ export default function requirePropFactory(componentNameInError: string, Component?: React.ComponentType<unknown>): (requiredProp: string) => PropTypes.Validator<any>;
@@ -1,6 +1,6 @@
1
1
  export default function requirePropFactory(componentNameInError, Component) {
2
2
  if (process.env.NODE_ENV === 'production') {
3
- return () => null;
3
+ return () => () => null;
4
4
  }
5
5
 
6
6
  // eslint-disable-next-line react/forbid-foreign-prop-types
@@ -1 +1,2 @@
1
- export { default } from "./useControlled.js";
1
+ export { default } from "./useControlled.js";
2
+ export * from "./useControlled.js";
@@ -1,3 +1,4 @@
1
+ import * as React from 'react';
1
2
  export interface UseControlledProps<T = unknown> {
2
3
  /**
3
4
  * Holds the component value when it's controlled.
@@ -16,4 +17,4 @@ export interface UseControlledProps<T = unknown> {
16
17
  */
17
18
  state?: string;
18
19
  }
19
- export default function useControlled<T = unknown>(props: UseControlledProps<T>): [T, (newValue: T | ((prevValue: T) => T)) => void];
20
+ export default function useControlled<T = unknown>(props: UseControlledProps<T>): [T, React.Dispatch<React.SetStateAction<T | undefined>>];
@@ -3,12 +3,13 @@
3
3
  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- process.env never changes, dependency arrays are intentionally ignored
4
4
  /* eslint-disable react-hooks/rules-of-hooks, react-hooks/exhaustive-deps */
5
5
  import * as React from 'react';
6
- export default function useControlled({
7
- controlled,
8
- default: defaultProp,
9
- name,
10
- state = 'value'
11
- }) {
6
+ export default function useControlled(props) {
7
+ const {
8
+ controlled,
9
+ default: defaultProp,
10
+ name,
11
+ state = 'value'
12
+ } = props;
12
13
  // isControlled is ignored in the hook dependency lists as it should never change.
13
14
  const {
14
15
  current: isControlled
@@ -37,5 +38,10 @@ export default function useControlled({
37
38
  setValue(newValue);
38
39
  }
39
40
  }, []);
41
+
42
+ // TODO: provide overloads for the useControlled function to account for the case where either
43
+ // controlled or default is not undefiend.
44
+ // In that case the return type should be [T, React.Dispatch<React.SetStateAction<T>>]
45
+ // otherwise it should be [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>]
40
46
  return [value, setValueIfUncontrolled];
41
47
  }
package/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @mui/utils v7.0.2
2
+ * @mui/utils v7.1.0
3
3
  *
4
4
  * @license MIT
5
5
  * This source code is licensed under the MIT license found in the
@@ -1,3 +1,4 @@
1
1
  import PropTypes from 'prop-types';
2
+ export declare function getTypeByValue(value: any): string;
2
3
  declare const integerPropType: PropTypes.Requireable<number>;
3
4
  export default integerPropType;
@@ -36,16 +36,17 @@ function requiredInteger(props, propName, componentName, location) {
36
36
  }
37
37
  return null;
38
38
  }
39
- function validator(props, propName, ...other) {
39
+ function validator(props, propName, componentName, location) {
40
40
  const propValue = props[propName];
41
41
  if (propValue === undefined) {
42
42
  return null;
43
43
  }
44
- return requiredInteger(props, propName, ...other);
44
+ return requiredInteger(props, propName, componentName, location);
45
45
  }
46
46
  function validatorNoop() {
47
47
  return null;
48
48
  }
49
49
  validator.isRequired = requiredInteger;
50
50
  validatorNoop.isRequired = validatorNoop;
51
- var _default = exports.default = process.env.NODE_ENV === 'production' ? validatorNoop : validator;
51
+ const integerPropType = process.env.NODE_ENV === 'production' ? validatorNoop : validator;
52
+ var _default = exports.default = integerPropType;
package/package.json CHANGED
@@ -1,7 +1,6 @@
1
1
  {
2
2
  "name": "@mui/utils",
3
- "version": "7.0.2",
4
- "private": false,
3
+ "version": "7.1.0",
5
4
  "author": "MUI Team",
6
5
  "description": "Utility functions for React components.",
7
6
  "main": "./index.js",
@@ -26,12 +25,12 @@
26
25
  "url": "https://opencollective.com/mui-org"
27
26
  },
28
27
  "dependencies": {
29
- "@babel/runtime": "^7.27.0",
28
+ "@babel/runtime": "^7.27.1",
30
29
  "@types/prop-types": "^15.7.14",
31
30
  "clsx": "^2.1.1",
32
31
  "prop-types": "^15.8.1",
33
32
  "react-is": "^19.1.0",
34
- "@mui/types": "^7.4.1"
33
+ "@mui/types": "^7.4.2"
35
34
  },
36
35
  "peerDependencies": {
37
36
  "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",
@@ -50,6 +49,7 @@
50
49
  "engines": {
51
50
  "node": ">=14.0.0"
52
51
  },
52
+ "private": false,
53
53
  "module": "./esm/index.js",
54
54
  "exports": {
55
55
  "./package.json": "./package.json",
@@ -1,2 +1,3 @@
1
1
  import * as React from 'react';
2
- export default function requirePropFactory(componentNameInError: string, Component?: React.JSXElementConstructor<unknown>): any;
2
+ import PropTypes from 'prop-types';
3
+ export default function requirePropFactory(componentNameInError: string, Component?: React.ComponentType<unknown>): (requiredProp: string) => PropTypes.Validator<any>;
@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
6
6
  exports.default = requirePropFactory;
7
7
  function requirePropFactory(componentNameInError, Component) {
8
8
  if (process.env.NODE_ENV === 'production') {
9
- return () => null;
9
+ return () => () => null;
10
10
  }
11
11
 
12
12
  // eslint-disable-next-line react/forbid-foreign-prop-types
@@ -1,13 +1,25 @@
1
1
  "use strict";
2
2
 
3
- var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
3
+ var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
4
4
  Object.defineProperty(exports, "__esModule", {
5
5
  value: true
6
6
  });
7
+ var _exportNames = {};
7
8
  Object.defineProperty(exports, "default", {
8
9
  enumerable: true,
9
10
  get: function () {
10
11
  return _useControlled.default;
11
12
  }
12
13
  });
13
- var _useControlled = _interopRequireDefault(require("./useControlled"));
14
+ var _useControlled = _interopRequireWildcard(require("./useControlled"));
15
+ Object.keys(_useControlled).forEach(function (key) {
16
+ if (key === "default" || key === "__esModule") return;
17
+ if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
18
+ if (key in exports && exports[key] === _useControlled[key]) return;
19
+ Object.defineProperty(exports, key, {
20
+ enumerable: true,
21
+ get: function () {
22
+ return _useControlled[key];
23
+ }
24
+ });
25
+ });
@@ -1,3 +1,4 @@
1
+ import * as React from 'react';
1
2
  export interface UseControlledProps<T = unknown> {
2
3
  /**
3
4
  * Holds the component value when it's controlled.
@@ -16,4 +17,4 @@ export interface UseControlledProps<T = unknown> {
16
17
  */
17
18
  state?: string;
18
19
  }
19
- export default function useControlled<T = unknown>(props: UseControlledProps<T>): [T, (newValue: T | ((prevValue: T) => T)) => void];
20
+ export default function useControlled<T = unknown>(props: UseControlledProps<T>): [T, React.Dispatch<React.SetStateAction<T | undefined>>];
@@ -9,12 +9,13 @@ Object.defineProperty(exports, "__esModule", {
9
9
  });
10
10
  exports.default = useControlled;
11
11
  var React = _interopRequireWildcard(require("react"));
12
- function useControlled({
13
- controlled,
14
- default: defaultProp,
15
- name,
16
- state = 'value'
17
- }) {
12
+ function useControlled(props) {
13
+ const {
14
+ controlled,
15
+ default: defaultProp,
16
+ name,
17
+ state = 'value'
18
+ } = props;
18
19
  // isControlled is ignored in the hook dependency lists as it should never change.
19
20
  const {
20
21
  current: isControlled
@@ -43,5 +44,10 @@ function useControlled({
43
44
  setValue(newValue);
44
45
  }
45
46
  }, []);
47
+
48
+ // TODO: provide overloads for the useControlled function to account for the case where either
49
+ // controlled or default is not undefiend.
50
+ // In that case the return type should be [T, React.Dispatch<React.SetStateAction<T>>]
51
+ // otherwise it should be [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>]
46
52
  return [value, setValueIfUncontrolled];
47
53
  }
@@ -1,6 +0,0 @@
1
- declare const ClassNameGenerator: {
2
- configure(generator: (componentName: string) => string): void;
3
- generate(componentName: string): string;
4
- reset(): void;
5
- };
6
- export default ClassNameGenerator;
@@ -1 +0,0 @@
1
- export { default } from "./ClassNameGenerator.js";
@@ -1,3 +0,0 @@
1
- export default function HTMLElementType(props: {
2
- [key: string]: unknown;
3
- }, propName: string, componentName: string, location: string, propFullName: string): Error | null;
@@ -1 +0,0 @@
1
- export { default } from "./HTMLElementType.js";
@@ -1,20 +0,0 @@
1
- import * as React from 'react';
2
- import { Simplify } from '@mui/types';
3
- /**
4
- * Type of the ownerState based on the type of an element it applies to.
5
- * This resolves to the provided OwnerState for React components and `undefined` for host components.
6
- * Falls back to `OwnerState | undefined` when the exact type can't be determined in development time.
7
- */
8
- type OwnerStateWhenApplicable<ElementType extends React.ElementType, OwnerState> = ElementType extends React.ComponentType<any> ? OwnerState : ElementType extends keyof React.JSX.IntrinsicElements ? undefined : OwnerState | undefined;
9
- export type AppendOwnerStateReturnType<ElementType extends React.ElementType, OtherProps, OwnerState> = Simplify<OtherProps & {
10
- ownerState: OwnerStateWhenApplicable<ElementType, OwnerState>;
11
- }>;
12
- /**
13
- * Appends the ownerState object to the props, merging with the existing one if necessary.
14
- *
15
- * @param elementType Type of the element that owns the `existingProps`. If the element is a DOM node or undefined, `ownerState` is not applied.
16
- * @param otherProps Props of the element.
17
- * @param ownerState
18
- */
19
- declare function appendOwnerState<ElementType extends React.ElementType, OtherProps extends Record<string, any>, OwnerState>(elementType: ElementType | undefined, otherProps: OtherProps, ownerState: OwnerState): AppendOwnerStateReturnType<ElementType, OtherProps, OwnerState>;
20
- export default appendOwnerState;
@@ -1,2 +0,0 @@
1
- export { default } from "./appendOwnerState.js";
2
- export type { AppendOwnerStateReturnType } from "./appendOwnerState.js";
@@ -1 +0,0 @@
1
- export default function capitalize(string: string): string;
@@ -1 +0,0 @@
1
- export { default } from "./capitalize.js";
@@ -1,2 +0,0 @@
1
- import PropTypes from 'prop-types';
2
- export default function chainPropTypes<A, B>(propType1: PropTypes.Validator<A>, propType2: PropTypes.Validator<B>): PropTypes.Validator<A & B>;
@@ -1 +0,0 @@
1
- export { default } from "./chainPropTypes.js";
@@ -1,2 +0,0 @@
1
- declare function clamp(val: number, min?: number, max?: number): number;
2
- export default clamp;
@@ -1 +0,0 @@
1
- export { default } from "./clamp.js";
@@ -1,29 +0,0 @@
1
- /**
2
- * Compose classes from multiple sources.
3
- *
4
- * @example
5
- * ```tsx
6
- * const slots = {
7
- * root: ['root', 'primary'],
8
- * label: ['label'],
9
- * };
10
- *
11
- * const getUtilityClass = (slot) => `MuiButton-${slot}`;
12
- *
13
- * const classes = {
14
- * root: 'my-root-class',
15
- * };
16
- *
17
- * const output = composeClasses(slots, getUtilityClass, classes);
18
- * // {
19
- * // root: 'MuiButton-root MuiButton-primary my-root-class',
20
- * // label: 'MuiButton-label',
21
- * // }
22
- * ```
23
- *
24
- * @param slots a list of classes for each possible slot
25
- * @param getUtilityClass a function to resolve the class based on the slot name
26
- * @param classes the input classes from props
27
- * @returns the resolved classes for all slots
28
- */
29
- export default function composeClasses<ClassKey extends string>(slots: Record<ClassKey, ReadonlyArray<string | false | undefined | null>>, getUtilityClass: (slot: string) => string, classes?: Record<string, string> | undefined): Record<ClassKey, string>;
@@ -1 +0,0 @@
1
- export { default } from "./composeClasses.js";
@@ -1,7 +0,0 @@
1
- /**
2
- * Safe chained function.
3
- *
4
- * Will only create a new function if needed,
5
- * otherwise will pass back existing functions or null.
6
- */
7
- export default function createChainedFunction<Args extends any[], This>(...funcs: Array<(this: This, ...args: Args) => any>): (this: This, ...args: Args) => void;
@@ -1 +0,0 @@
1
- export { default } from "./createChainedFunction.js";
@@ -1,4 +0,0 @@
1
- export interface Cancelable {
2
- clear(): void;
3
- }
4
- export default function debounce<T extends (...args: any[]) => any>(func: T, wait?: number): T & Cancelable;
@@ -1,2 +0,0 @@
1
- export { default } from "./debounce.js";
2
- export * from "./debounce.js";
@@ -1,23 +0,0 @@
1
- export declare function isPlainObject(item: unknown): item is Record<keyof any, unknown>;
2
- export interface DeepmergeOptions {
3
- clone?: boolean;
4
- }
5
- /**
6
- * Merge objects deeply.
7
- * It will shallow copy React elements.
8
- *
9
- * If `options.clone` is set to `false` the source object will be merged directly into the target object.
10
- *
11
- * @example
12
- * ```ts
13
- * deepmerge({ a: { b: 1 }, d: 2 }, { a: { c: 2 }, d: 4 });
14
- * // => { a: { b: 1, c: 2 }, d: 4 }
15
- * ````
16
- *
17
- * @param target The target object.
18
- * @param source The source object.
19
- * @param options The merge options.
20
- * @param options.clone Set to `false` to merge the source object directly into the target object.
21
- * @returns The merged object.
22
- */
23
- export default function deepmerge<T>(target: T, source: unknown, options?: DeepmergeOptions): T;
@@ -1,2 +0,0 @@
1
- export { default } from "./deepmerge.js";
2
- export * from "./deepmerge.js";
@@ -1 +0,0 @@
1
- export default function deprecatedPropType<T>(validator: T, reason: string): T;
@@ -1 +0,0 @@
1
- export { default } from "./deprecatedPropType.js";
@@ -1,3 +0,0 @@
1
- import PropTypes from 'prop-types';
2
- declare const elementAcceptingRef: PropTypes.Requireable<unknown>;
3
- export default elementAcceptingRef;
@@ -1 +0,0 @@
1
- export { default } from "./elementAcceptingRef.js";
@@ -1,3 +0,0 @@
1
- import PropTypes from 'prop-types';
2
- declare const _default: PropTypes.Validator<PropTypes.ReactComponentLike | null | undefined>;
3
- export default _default;
@@ -1 +0,0 @@
1
- export { default } from "./elementTypeAcceptingRef.js";
@@ -1,2 +0,0 @@
1
- import { ValidationMap } from 'prop-types';
2
- export default function exactProp<T>(propTypes: ValidationMap<T>): ValidationMap<T>;
@@ -1 +0,0 @@
1
- export { default } from "./exactProp.js";
@@ -1,10 +0,0 @@
1
- import { EventHandlers } from "../types/index.js";
2
- /**
3
- * Extracts event handlers from a given object.
4
- * A prop is considered an event handler if it is a function and its name starts with `on`.
5
- *
6
- * @param object An object to extract event handlers from.
7
- * @param excludeKeys An array of keys to exclude from the returned object.
8
- */
9
- declare function extractEventHandlers(object: Record<string, any> | undefined, excludeKeys?: string[]): EventHandlers;
10
- export default extractEventHandlers;
@@ -1 +0,0 @@
1
- export { default } from "./extractEventHandlers.js";
@@ -1,11 +0,0 @@
1
- /**
2
- * WARNING: Don't import this directly. It's imported by the code generated by
3
- * `@mui/interal-babel-plugin-minify-errors`. Make sure to always use string literals in `Error`
4
- * constructors to ensure the plugin works as expected. Supported patterns include:
5
- * throw new Error('My message');
6
- * throw new Error(`My message: ${foo}`);
7
- * throw new Error(`My message: ${foo}` + 'another string');
8
- * ...
9
- * @param {number} code
10
- */
11
- export default function formatMuiErrorMessage(code: number, ...args: string[]): string;
@@ -1 +0,0 @@
1
- export { default } from "./formatMuiErrorMessage.js";
@@ -1,17 +0,0 @@
1
- export type GlobalStateSlot = keyof typeof globalStateClasses;
2
- export declare const globalStateClasses: {
3
- active: string;
4
- checked: string;
5
- completed: string;
6
- disabled: string;
7
- error: string;
8
- expanded: string;
9
- focused: string;
10
- focusVisible: string;
11
- open: string;
12
- readOnly: string;
13
- required: string;
14
- selected: string;
15
- };
16
- export default function generateUtilityClass(componentName: string, slot: string, globalStatePrefix?: string): string;
17
- export declare function isGlobalState(slot: string): boolean;
@@ -1,2 +0,0 @@
1
- export { default } from "./generateUtilityClass.js";
2
- export * from "./generateUtilityClass.js";
@@ -1 +0,0 @@
1
- export default function generateUtilityClasses<T extends string>(componentName: string, slots: T[], globalStatePrefix?: string): Record<T, string>;
@@ -1 +0,0 @@
1
- export { default } from "./generateUtilityClasses.js";
@@ -1,7 +0,0 @@
1
- import * as React from 'react';
2
- /**
3
- * cherry-pick from
4
- * https://github.com/facebook/react/blob/769b1f270e1251d9dbdce0fcbd9e92e502d059b8/packages/shared/getComponentName.js
5
- * originally forked from recompose/getDisplayName
6
- */
7
- export default function getDisplayName(Component: React.ElementType): string | undefined;
@@ -1 +0,0 @@
1
- export { default } from "./getDisplayName.js";