true, the React tree is ignored and only the DOM tree is considered. This prop changes how portaled elements are handled."
+ },
+ "mouseEvent": {
+ "description": "The mouse event to listen to. You can disable the listener by providing false."
+ },
+ "onClickAway": {
+ "description": "Callback fired when a "click away" event is detected."
+ },
+ "touchEvent": {
+ "description": "The touch event to listen to. You can disable the listener by providing false."
+ }
+ },
+ "classDescriptions": {}
+}
diff --git a/docs/translations/api-docs/no-ssr/no-ssr.json b/docs/translations/api-docs/no-ssr/no-ssr.json
new file mode 100644
index 00000000000000..ff903d12a20b33
--- /dev/null
+++ b/docs/translations/api-docs/no-ssr/no-ssr.json
@@ -0,0 +1,11 @@
+{
+ "componentDescription": "NoSsr purposely removes components from the subject of Server Side Rendering (SSR).\n\nThis component can be useful in a variety of situations:\n\n* Escape hatch for broken dependencies not supporting SSR.\n* Improve the time-to-first paint on the client by only rendering above the fold.\n* Reduce the rendering time on the server.\n* Under too heavy server load, you can turn on service degradation.",
+ "propDescriptions": {
+ "children": { "description": "You can wrap a node." },
+ "defer": {
+ "description": "If true, the component will not only prevent server-side rendering. It will also defer the rendering of the children into a different screen frame."
+ },
+ "fallback": { "description": "The fallback content to display." }
+ },
+ "classDescriptions": {}
+}
diff --git a/docs/translations/api-docs/popper/popper.json b/docs/translations/api-docs/popper/popper.json
index 178879e0bd5352..23b39e61d6fa7a 100644
--- a/docs/translations/api-docs/popper/popper.json
+++ b/docs/translations/api-docs/popper/popper.json
@@ -41,5 +41,5 @@
"description": "Help supporting a react-transition-group/Transition component."
}
},
- "classDescriptions": {}
+ "classDescriptions": { "root": { "description": "Class name applied to the root element." } }
}
diff --git a/docs/translations/api-docs/portal/portal.json b/docs/translations/api-docs/portal/portal.json
new file mode 100644
index 00000000000000..d7fb72bca569c9
--- /dev/null
+++ b/docs/translations/api-docs/portal/portal.json
@@ -0,0 +1,13 @@
+{
+ "componentDescription": "Portals provide a first-class way to render children into a DOM node\nthat exists outside the DOM hierarchy of the parent component.",
+ "propDescriptions": {
+ "children": { "description": "The children to render into the container." },
+ "container": {
+ "description": "An HTML element or function that returns one. The container will have the portal children appended to it.document.body most of the time."
+ },
+ "disablePortal": {
+ "description": "The children will be under the DOM hierarchy of the parent component."
+ }
+ },
+ "classDescriptions": {}
+}
diff --git a/docs/translations/api-docs/textarea-autosize/textarea-autosize.json b/docs/translations/api-docs/textarea-autosize/textarea-autosize.json
new file mode 100644
index 00000000000000..ee91d0dd6d70c6
--- /dev/null
+++ b/docs/translations/api-docs/textarea-autosize/textarea-autosize.json
@@ -0,0 +1,8 @@
+{
+ "componentDescription": "",
+ "propDescriptions": {
+ "maxRows": { "description": "Maximum number of rows to display." },
+ "minRows": { "description": "Minimum number of rows to display." }
+ },
+ "classDescriptions": {}
+}
diff --git a/packages/api-docs-builder-core/baseUi/projectSettings.ts b/packages/api-docs-builder-core/baseUi/projectSettings.ts
index b9b64d42adc3c4..6e7df498b54278 100644
--- a/packages/api-docs-builder-core/baseUi/projectSettings.ts
+++ b/packages/api-docs-builder-core/baseUi/projectSettings.ts
@@ -27,6 +27,9 @@ export const projectSettings: ProjectSettings = {
getHookInfo: getBaseUiHookInfo,
translationLanguages: LANGUAGES,
skipComponent: () => false,
+ skipHook: (filename) => {
+ return filename.match(/(useSlotProps)/) !== null;
+ },
onCompleted: async () => {
await generateBaseUIApiPages();
},
diff --git a/packages/api-docs-builder/ProjectSettings.ts b/packages/api-docs-builder/ProjectSettings.ts
index 2ba937f0a4e9b2..8baa6193c75912 100644
--- a/packages/api-docs-builder/ProjectSettings.ts
+++ b/packages/api-docs-builder/ProjectSettings.ts
@@ -56,6 +56,10 @@ export interface ProjectSettings {
* Fuction called to detemine whether to skip the generation of a particular component's API docs
*/
skipComponent: (filename: string) => boolean;
+ /**
+ * Fuction called to detemine whether to skip the generation of a particular hook's API docs
+ */
+ skipHook?: (filename: string) => boolean;
/**
* Determine is the component definition should be updated.
*/
diff --git a/packages/api-docs-builder/buildApi.ts b/packages/api-docs-builder/buildApi.ts
index 886b04f2e02f07..29bec459529bc5 100644
--- a/packages/api-docs-builder/buildApi.ts
+++ b/packages/api-docs-builder/buildApi.ts
@@ -135,6 +135,9 @@ async function buildSingleProject(
);
const projectHooks = findHooks(path.join(project.rootPath, 'src')).filter((hook) => {
+ if (projectSettings.skipHook?.(hook.filename)) {
+ return false;
+ }
if (grep === null) {
return true;
}
diff --git a/packages/mui-base/src/utils/appendOwnerState.ts b/packages/mui-base/src/utils/appendOwnerState.ts
index 0ef5e0c47a4f60..9c4b778bef1add 100644
--- a/packages/mui-base/src/utils/appendOwnerState.ts
+++ b/packages/mui-base/src/utils/appendOwnerState.ts
@@ -1,51 +1,3 @@
-import * as React from 'react';
-import { Simplify } from '@mui/types';
-import { isHostComponent } from './isHostComponent';
+export { default as appendOwnerState } from '@mui/utils/appendOwnerState';
-/**
- * Type of the ownerState based on the type of an element it applies to.
- * This resolves to the provided OwnerState for React components and `undefined` for host components.
- * Falls back to `OwnerState | undefined` when the exact type can't be determined in development time.
- */
-type OwnerStateWhenApplicable