[docs] Add chat docs page shells by hasdfa · Pull Request #22483 · mui/mui-x

hasdfa · 2026-05-17T21:23:20Z

Summary

Adds X Chat docs page shells for the new documentation structure.
Covers all-components, built-in adapters, conversation, customization structure, and display pages without adding the full content payload yet.
Connects the page shell work to both the docs IA PR and the package/codemod stack underneath it.

Details

This PR creates the page destinations that later content PRs fill in.
It carries generated API/demo link output needed for the new page shell structure.
It intentionally avoids standalone examples and keeps the branch scoped to X Chat docs paths.

Validation

git diff --check x-chat-chatbox-layout-slots-codemod...x-chat-docs-new-pages
Split-scope checks confirmed this branch stays within X Chat docs paths.

Batch merge structure

Merge top to bottom. #22478 can merge independently, but it should land before #22483 because #22483 assumes the new docs IA.

master
|-- #22478 [docs] Reorganize existing chat docs navigation
`-- #22479 [chat-headless] Add built-in chat adapters
    `-- #22480 [chat-headless] Harden runtime model and message errors
        `-- #22481 [x-chat] Harden material message surfaces
            `-- #22482 [x-chat] Add ChatBox layout slots and migration codemod
                `-- #22483 [docs] Add chat docs page shells (after #22478)
                    `-- #22484 [docs] Add chat playground infrastructure
                        |-- #22485 [docs] Update chat quickstart and backend adapters
                        |-- #22486 [docs] Update chat basics display and behavior
                        |-- #22487 [docs] Update chat customization core material and headless docs
                        `-- #22488 [docs] Update chat overview and component gallery

Two built-in adapters that ship with @mui/x-chat-headless: a simple echo adapter for examples and an AI SDK adapter that bridges Vercel AI SDK UIMessage streams into ChatMessageChunk events. Wire both through the headless core barrel so they can be imported from '@mui/x-chat-headless' and '@mui/x-chat-headless/core'.

code-infra-dashboard · 2026-05-17T21:27:18Z

Deploy preview

Bundle size

Bundle	Parsed size	Gzip size
@mui/x-data-grid	0B^(0.00%)	0B^(0.00%)
@mui/x-data-grid-pro	0B^(0.00%)	0B^(0.00%)
@mui/x-data-grid-premium	0B^(0.00%)	0B^(0.00%)
@mui/x-charts	0B^(0.00%)	0B^(0.00%)
@mui/x-charts-pro	0B^(0.00%)	0B^(0.00%)
@mui/x-charts-premium	0B^(0.00%)	0B^(0.00%)
@mui/x-date-pickers	0B^(0.00%)	0B^(0.00%)
@mui/x-date-pickers-pro	0B^(0.00%)	0B^(0.00%)
@mui/x-tree-view	0B^(0.00%)	0B^(0.00%)
@mui/x-tree-view-pro	0B^(0.00%)	0B^(0.00%)
@mui/x-license	0B^(0.00%)	0B^(0.00%)

Details of bundle changes

Check out the code infra dashboard for more information about this PR.

Copilot

Pull request overview

Adds new MUI X Chat documentation destinations (page shells) for the reworked docs IA, and wires in the associated API/docs metadata and demo updates needed for those new routes.

Changes:

Add new docs pages under /x/react-chat/* (all-components, backend/built-in-adapters, basics, customization, display) with placeholder markdown content.
Update/extend X Chat API docs metadata (new API pages like ChatMessageError/MessageError, new props like alwaysVisible, updated demos links).
Bring along supporting X Chat package/codemod updates that the new docs structure references (exports, slot-shape codemod, message author/error/runtime improvements).

Reviewed changes

Copilot reviewed 243 out of 243 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
scripts/x-chat.exports.json	Updates public export manifest for new chat symbols (e.g. `ChatMessageError`, `createEchoAdapter`).
scripts/buildApiDocs/chatSettings/index.ts	Excludes additional internal chat files from API docs generation.
packages/x-codemod/src/v9.0.0/preset-safe/index.ts	Adds chat codemods into the v9 preset-safe pipeline.
packages/x-codemod/src/v9.0.0/chat/preset-safe/index.ts	Introduces chat preset-safe transformer that runs chat codemods.
packages/x-codemod/src/v9.0.0/chat/migrate-slots/actual.spec.tsx	Test fixture for slot-shape migration codemod (flat → nested).
packages/x-codemod/src/v9.0.0/chat/migrate-slots/expected.spec.tsx	Expected output fixture for slot-shape migration codemod.
packages/x-codemod/src/v9.0.0/chat/migrate-slots/pre-rename.actual.spec.tsx	Test fixture for pre-rename slot keys migration.
packages/x-codemod/src/v9.0.0/chat/migrate-slots/pre-rename.expected.spec.tsx	Expected output for pre-rename slot keys migration.
packages/x-codemod/src/v9.0.0/chat/migrate-slots/migrate-slots.test.ts	Adds unit tests for the chat migrate-slots codemod.
packages/x-codemod/README.md	Documents the new chat codemods (migrate-slots).
packages/x-chat/src/themeAugmentation/props.ts	Adds theme defaultProps typing for `MuiChatMessageError`.
packages/x-chat/src/themeAugmentation/overrides.ts	Adds theme overrides typing for `MuiChatMessageError`.
packages/x-chat/src/themeAugmentation/components.ts	Adds theme component entry for `MuiChatMessageError`.
packages/x-chat/src/internals/useCopyToClipboard.ts	Extracts clipboard logic into a reusable hook.
packages/x-chat/src/index.ts	Exports new chat types/components and re-exports `createEchoAdapter`.
packages/x-chat/src/ChatSuggestions/ChatSuggestions.tsx	Adds `sx` support and alwaysVisible PropTypes surface.
packages/x-chat/src/ChatSuggestions/ChatSuggestions.test.tsx	Updates expectations for suggestions rendering behavior when messages exist.
packages/x-chat/src/ChatMessageSources/ChatMessageSources.tsx	Adds `sx` support to ChatMessageSources.
packages/x-chat/src/ChatMessageSkeleton/ChatMessageSkeleton.tsx	Adds `sx` support to ChatMessageSkeleton.
packages/x-chat/src/ChatMessageList/DefaultMessageItem.tsx	Adds shared default row composition used by ChatBox/ChatMessageList.
packages/x-chat/src/ChatMessageList/ChatMessageList.test.tsx	Adds coverage for standalone/default rendering + slot overrides + custom renderItem.
packages/x-chat/src/ChatMessageError/index.ts	Adds ChatMessageError barrel exports.
packages/x-chat/src/ChatMessageError/chatMessageErrorClasses.ts	Introduces utility classes for ChatMessageError.
packages/x-chat/src/ChatMessage/index.ts	Re-exports ChatMessageError alongside message primitives.
packages/x-chat/src/ChatMessage/ChatMessageMeta.tsx	Updates meta alignment rules to use `isOwnMessage`.
packages/x-chat/src/ChatMessage/ChatMessageInlineMeta.tsx	Updates inline meta contrast/alignment logic to use `isOwnMessage`.
packages/x-chat/src/ChatMessage/ChatMessageGroup.test.tsx	Adds tests for author label default/override/null slot behavior.
packages/x-chat/src/ChatMessage/ChatMessageContent.test.tsx	Updates locale label expectations and expands tool-part behavior tests.
packages/x-chat/src/ChatMessage/chatMessageClasses.ts	Adds new `noAvatar` utility class.
packages/x-chat/src/ChatMessage/ChatMessageActions.tsx	Aligns actions placement with `isOwnMessage`.
packages/x-chat/src/ChatMessage/ChatMessage.test.tsx	Updates slotProps naming and adds “own message” resolution test.
packages/x-chat/src/ChatMessage/ChatDateDivider.tsx	Adds `sx` support to ChatDateDivider.
packages/x-chat/src/ChatIndicators/ChatUnreadMarker.tsx	Adds `sx` support to ChatUnreadMarker.
packages/x-chat/src/ChatIndicators/ChatTypingIndicator.tsx	Adds `sx` support to ChatTypingIndicator.
packages/x-chat/src/ChatIndicators/ChatScrollToBottomAffordance.tsx	Adds `sx` support to scroll-to-bottom affordance.
packages/x-chat/src/ChatConversationList/ChatConversationList.test.tsx	Updates tests to opt into conversationList feature + stabilizes async selection assertion.
packages/x-chat/src/ChatConfirmation/ChatConfirmation.tsx	Adds `sx` support and documents `onSubmit` propType in composer-related area.
packages/x-chat/src/ChatComposer/ChatComposerTextArea.test.tsx	Updates slotProps nesting for composer input.
packages/x-chat/src/ChatComposer/ChatComposerSendButton.test.tsx	Updates slotProps nesting for composer send button.
packages/x-chat/src/ChatComposer/ChatComposerAttachmentList.tsx	Switches to `useChatComposer` to support rendering outside ChatComposer component.
packages/x-chat/src/ChatComposer/ChatComposerAttachButton.test.tsx	Updates slotProps nesting for attach button.
packages/x-chat/src/ChatComposer/ChatComposer.tsx	Removes zIndex and adds PropTypes docs for `onSubmit`.
packages/x-chat/src/ChatComposer/ChatComposer.test.tsx	Updates slotProps nesting for composer root.
packages/x-chat/src/ChatCodeBlock/ChatCodeBlock.tsx	Adds `sx` support and refactors copy behavior to `useCopyToClipboard`.
packages/x-chat/src/ChatBox/index.ts	Exports new layout mode types from ChatBox types.
packages/x-chat-headless/src/types/chat-state.ts	Adds per-message error map to internal state.
packages/x-chat-headless/src/types/chat-entities.ts	Documents/enables message author resolution getters types.
packages/x-chat-headless/src/suggestions/SuggestionsRoot.tsx	Adds `alwaysVisible` prop to render suggestions even when not empty.
packages/x-chat-headless/src/stream/streamTextDeltaBuffer.ts	Fixes streamId isolation behavior and adds createIfMissing option.
packages/x-chat-headless/src/stream/streamHelpers.ts	Adds createdAt to assistant messages created during streaming.
packages/x-chat-headless/src/stream/processStream.test.ts	Adds regression test for interleaved parallel text streams.
packages/x-chat-headless/src/store/ChatStore.test.ts	Adds coverage for message-scoped errors and disposal behavior.
packages/x-chat-headless/src/selectors/chatSelectors.ts	Adds selectors for resolved message author + per-message error.
packages/x-chat-headless/src/selectors/chatSelectors.test.ts	Tests message-scoped errors selection behavior.
packages/x-chat-headless/src/message/parts/ToolPart.tsx	Adds `sectionSummary` slot + preview/label ownerState and expands input visibility states.
packages/x-chat-headless/src/message/parts/MessageParts.test.tsx	Updates reasoning label expectation and tests ToolPart sectionSummary ownerState.
packages/x-chat-headless/src/message/MessageRoot.tsx	Integrates author resolution and `isOwnMessage` into ownerState/data attrs/aria-label.
packages/x-chat-headless/src/message/MessageMeta.tsx	Suppresses generic error status label when message-scoped error is available.
packages/x-chat-headless/src/message/MessageError.tsx	Adds headless per-message error primitive with retry integration.
packages/x-chat-headless/src/message/MessageContent.tsx	Refactors default renderer helpers for step-start and data parts.
packages/x-chat-headless/src/message/MessageAvatar.tsx	Uses resolved author for avatar/name.
packages/x-chat-headless/src/message/MessageAuthorLabel.tsx	Uses resolved author displayName for author label.
packages/x-chat-headless/src/message/message.types.ts	Extends ownerState with resolved author + isOwnMessage + message error ownerState.
packages/x-chat-headless/src/message/internals/MessageContext.tsx	Extends MessageContext defaults for new ownerState fields.
packages/x-chat-headless/src/message/index.ts	Exports MessageError and related types/ownerState.
packages/x-chat-headless/src/message-list/useMessageListBehavior.ts	Adds SSR/unmount guards for rAF resize restore and StrictMode remount behavior.
packages/x-chat-headless/src/message-list/MessageListRoot.tsx	Adds rAF availability guards in ResizeObserver callback cleanup.
packages/x-chat-headless/src/message-list/MessageListRoot.test.tsx	Adds (skipped in JSDOM) tests for streaming-row resize autoscroll incl. StrictMode.
packages/x-chat-headless/src/message-group/messageGroup.types.ts	Adds isOwnMessage to group ownerState.
packages/x-chat-headless/src/message-group/MessageGroup.tsx	Resolves author/grouping based on resolved author instead of inline author only.
packages/x-chat-headless/src/message-group/MessageGroup.test.tsx	Adds coverage for member-based author resolution and getter-based author id grouping.
packages/x-chat-headless/src/internals/useChatInstance/useChatInstance.ts	Adjusts controlled/uncontrolled detection for activeConversationId via explicit flag.
packages/x-chat-headless/src/internals/useChatInstance/useChatInstance.test.tsx	Adds test for “controlled even when rerendered with undefined” activeConversationId.
packages/x-chat-headless/src/internals/useChatController/useChatControllerHelpers.ts	Adds helper to extract messageId from runtime error details.
packages/x-chat-headless/src/internals/useChatController/useChatController.ts	Routes message-scoped runtime errors to per-message error state and adds stream producer error dedupe handling.
packages/x-chat-headless/src/internals/useChatController/realtimeActions.test.ts	Adds regression test ensuring in-flight loads are discarded after realtime removal.
packages/x-chat-headless/src/internals/useChatController/conversationActions.ts	Avoids eager message reset during conversation switches.
packages/x-chat-headless/src/index.ts	Exports new hooks/selectors/adapters/types and MessageError.
packages/x-chat-headless/src/hooks/useMessageError.ts	Adds hook for selecting per-message errors.
packages/x-chat-headless/src/hooks/useMessageError.test.tsx	Adds tests for useMessageError.
packages/x-chat-headless/src/hooks/useMessageAuthor.ts	Adds hook to resolve/enrich message author using locale-driven role labels.
packages/x-chat-headless/src/hooks/useChat.test.tsx	Updates tests for createdAt and adds regression coverage for initial conversation load.
packages/x-chat-headless/src/hooks/index.ts	Re-exports useMessageError from hooks index.
packages/x-chat-headless/src/core/index.ts	Re-exports adapters and author getter types from core entry point.
packages/x-chat-headless/src/conversation-list/ConversationListRoot.tsx	Adds keyboard PageUp/PageDown and type-ahead navigation + cleanup.
packages/x-chat-headless/src/conversation-list/ConversationListItem.tsx	Adds `data-conversation-id` attribute for stable selection/testing/styling.
packages/x-chat-headless/src/composer/ComposerSendButton.tsx	Allows sending attachment-only drafts (no text).
packages/x-chat-headless/src/composer/ComposerRoot.tsx	Adds onSubmit prop and prevents native navigation while allowing external suppression of submit().
packages/x-chat-headless/src/composer/ComposerRoot.test.tsx	Adds tests for attachment-only sending and onSubmit semantics.
packages/x-chat-headless/src/composer/ComposerHelperText.tsx	Sets role=alert automatically when displaying composer error.
packages/x-chat-headless/src/ChatProvider.tsx	Adjusts activeConversationId controlled detection and passes author getter props through parameters.
packages/x-chat-headless/src/ChatProvider.test.tsx	Improves streamFlushInterval test to validate buffering behavior with fake timers.
packages/x-chat-headless/src/chat/internals/chatLocaleText.ts	Adds new locale labels (reasoning/tool labels, conversation header labels, role labels).
packages/x-chat-headless/src/chat/ChatRoot.tsx	Aligns controlled activeConversationId detection and forwards author getter props.
packages/x-chat-headless/src/chat/ChatLayout.tsx	Ensures layout panes use flex column sizing/overflow handling.
packages/x-chat-headless/src/chat/ChatComposition.test.tsx	Updates focus assertions naming for composer input.
packages/x-chat-headless/src/adapters/index.ts	Exports built-in adapters from adapters entry.
packages/x-chat-headless/src/adapters/createEchoAdapter.ts	Adds built-in echo adapter implementation.
docs/translations/api-docs/chat/message-error/message-error.json	Adds translation shell for MessageError API docs.
docs/translations/api-docs/chat/composer-root/composer-root.json	Adds onSubmit description translation for ComposerRoot API docs.
docs/translations/api-docs/chat/chat-suggestions/chat-suggestions.json	Adds alwaysVisible prop translation for ChatSuggestions.
docs/translations/api-docs/chat/chat-root/chat-root.json	Updates chat-root propDescriptions (generated).
docs/translations/api-docs/chat/chat-provider/chat-provider.json	Updates chat-provider propDescriptions (generated).
docs/translations/api-docs/chat/chat-message-meta/chat-message-meta.json	Adds `noAvatar` class description.
docs/translations/api-docs/chat/chat-message-list/chat-message-list.json	Adds `renderItem` prop description.
docs/translations/api-docs/chat/chat-message-group/chat-message-group.json	Adds `noAvatar` class description.
docs/translations/api-docs/chat/chat-message-error/chat-message-error.json	Adds translations for new ChatMessageError API docs.
docs/translations/api-docs/chat/chat-message-content/chat-message-content.json	Adds `noAvatar` class description.
docs/translations/api-docs/chat/chat-message-avatar/chat-message-avatar.json	Adds `noAvatar` class description.
docs/translations/api-docs/chat/chat-message-author-label/chat-message-author-label.json	Adds `noAvatar` class description.
docs/translations/api-docs/chat/chat-message-actions/chat-message-actions.json	Adds `noAvatar` class description.
docs/translations/api-docs/chat/chat-date-divider/chat-date-divider.json	Adds `noAvatar` class description.
docs/src/modules/components/overview/chat/mainDemo/MessengerDemo.tsx	Updates ChatBox slot nesting and enables conversationList feature in demo.
docs/src/modules/components/overview/chat/mainDemo/AgentDemo.tsx	Updates ChatBox slot nesting and enables conversationList feature in demo.
docs/pages/x/react-chat/display/unread-marker.js	Adds new docs route for unread marker placeholder page.
docs/pages/x/react-chat/display/date-divider.js	Adds new docs route for date divider placeholder page.
docs/pages/x/react-chat/customization/structure.js	Adds new docs route for customization structure placeholder page.
docs/pages/x/react-chat/customization/overview.js	Adds new docs route for customization overview placeholder page.
docs/pages/x/react-chat/customization/look-and-feel.js	Adds new docs route for look-and-feel placeholder page.
docs/pages/x/react-chat/basics/conversation.js	Adds new docs route for conversation basics placeholder page.
docs/pages/x/react-chat/backend/built-in-adapters/echo-adapter.js	Adds new docs route for echo adapter placeholder page.
docs/pages/x/react-chat/backend/built-in-adapters/ai-sdk-adapter.js	Adds new docs route for AI SDK adapter placeholder page.
docs/pages/x/react-chat/all-components.js	Adds new docs route for chat component gallery placeholder page.
docs/pages/x/api/chat/message-error.json	Adds generated API metadata for new MessageError component.
docs/pages/x/api/chat/message-error.js	Adds API page for new MessageError component.
docs/pages/x/api/chat/chat-unread-marker.json	Updates demos list to include the new unread-marker docs page.
docs/pages/x/api/chat/chat-suggestions.json	Adds `alwaysVisible` prop to API metadata.
docs/pages/x/api/chat/chat-message-meta.json	Adds `noAvatar` class to API metadata.
docs/pages/x/api/chat/chat-message-list.json	Adds `renderItem` prop to API metadata.
docs/pages/x/api/chat/chat-message-group.json	Adds `noAvatar` class to API metadata.
docs/pages/x/api/chat/chat-message-error.json	Adds generated API metadata for new ChatMessageError component.
docs/pages/x/api/chat/chat-message-error.js	Adds API page for new ChatMessageError component.
docs/pages/x/api/chat/chat-message-content.json	Adds `noAvatar` class to API metadata.
docs/pages/x/api/chat/chat-message-avatar.json	Adds `noAvatar` class to API metadata.
docs/pages/x/api/chat/chat-message-author-label.json	Adds `noAvatar` class to API metadata.
docs/pages/x/api/chat/chat-message-actions.json	Adds `noAvatar` class to API metadata.
docs/pages/x/api/chat/chat-date-divider.json	Updates demos list and adds `noAvatar` class to API metadata.
docs/data/chatApiPages.ts	Registers new API pages for `ChatMessageError` and `MessageError`.
docs/data/chat/material/thread/PaperBubble.tsx	Updates ChatBox slot nesting in demo source.
docs/data/chat/material/thread/PaperBubble.js	Updates compiled demo to match new slot nesting.
docs/data/chat/material/thread/GradientHeader.tsx	Updates ChatBox slot nesting in demo source.
docs/data/chat/material/thread/GradientHeader.js	Updates compiled demo to match new slot nesting.
docs/data/chat/material/thread/BubbleWithStatus.tsx	Updates ChatBox slot nesting in demo source.
docs/data/chat/material/thread/BubbleWithStatus.js	Updates compiled demo to match new slot nesting.
docs/data/chat/material/thread/AdaptiveSendButton.tsx	Updates ChatBox slot nesting in demo source.
docs/data/chat/material/thread/AdaptiveSendButton.js	Updates compiled demo to match new slot nesting.
docs/data/chat/material/slot-overrides/ThemeAndSlotCombination.tsx	Updates ChatBox slot nesting in demo source.
docs/data/chat/material/slot-overrides/ThemeAndSlotCombination.js	Updates compiled demo to match new slot nesting.
docs/data/chat/material/slot-overrides/SlotPropsCustomization.tsx	Updates slotProps structure to new nested families.
docs/data/chat/material/slot-overrides/SlotPropsCustomization.js	Updates compiled demo to match new slotProps structure.
docs/data/chat/material/slot-overrides/SlotBasicReplacement.tsx	Updates ChatBox slot nesting in demo source.
docs/data/chat/material/slot-overrides/SlotBasicReplacement.js	Updates compiled demo to match new slot nesting.
docs/data/chat/material/message-list/MessageGrouping.tsx	Updates slotProps nesting for grouping configuration.
docs/data/chat/material/message-list/MessageGrouping.js	Updates compiled demo to match new slotProps structure.
docs/data/chat/material/message-list/DateDividerFormat.tsx	Updates slotProps nesting for date divider formatting.
docs/data/chat/material/message-list/DateDividerFormat.js	Updates compiled demo to match new slotProps structure.
docs/data/chat/material/hooks/CustomComposer.tsx	Updates ChatBox slot nesting in demo source.
docs/data/chat/material/hooks/CustomComposer.js	Updates compiled demo to match new slot nesting.
docs/data/chat/material/examples/slot-overrides/SlotOverrides.tsx	Updates ChatBox slot nesting in demo source.
docs/data/chat/material/examples/slot-overrides/SlotOverrides.js	Updates compiled demo to match new slot nesting.
docs/data/chat/material/examples/responsive-drawer/ResponsiveDrawer.tsx	Enables conversationList feature on ChatBox usage.
docs/data/chat/material/examples/responsive-drawer/ResponsiveDrawer.js	Updates compiled demo accordingly.
docs/data/chat/material/examples/multi-conversation/MultiConversation.tsx	Enables conversationList feature on ChatBox usage.
docs/data/chat/material/examples/multi-conversation/MultiConversation.js	Updates compiled demo accordingly.
docs/data/chat/material/examples/model-selector/ModelSelector.tsx	Updates conversation header action slot nesting.
docs/data/chat/material/examples/model-selector/ModelSelector.js	Updates compiled demo accordingly.
docs/data/chat/material/examples/compact-variant/CompactVariant.tsx	Enables conversationList feature on ChatBox usage.
docs/data/chat/material/examples/compact-variant/CompactVariant.js	Updates compiled demo accordingly.
docs/data/chat/material/examples/agentic-code/ToolStylingC.tsx	Enables conversationList and updates message content slotProps nesting.
docs/data/chat/material/examples/agentic-code/ToolStylingC.js	Updates compiled demo accordingly.
docs/data/chat/material/examples/agentic-code/ToolStylingB.tsx	Enables conversationList and updates message content slotProps nesting.
docs/data/chat/material/examples/agentic-code/ToolStylingB.js	Updates compiled demo accordingly.
docs/data/chat/material/examples/agentic-code/ToolStylingA.tsx	Enables conversationList and updates message content slotProps nesting.
docs/data/chat/material/examples/agentic-code/ToolStylingA.js	Updates compiled demo accordingly.
docs/data/chat/material/examples/agentic-code/AgenticCode.tsx	Enables conversationList feature on ChatBox usage.
docs/data/chat/material/examples/agentic-code/AgenticCode.js	Updates compiled demo accordingly.
docs/data/chat/material/conversation-list/ThemedAvatar.tsx	Enables conversationList and updates conversation list slotProps nesting.
docs/data/chat/material/conversation-list/ThemedAvatar.js	Updates compiled demo accordingly.
docs/data/chat/material/conversation-list/RichItemContent.tsx	Enables conversationList and updates conversation list slotProps nesting.
docs/data/chat/material/conversation-list/RichItemContent.js	Updates compiled demo accordingly.
docs/data/chat/material/conversation-list/FullCustomRow.tsx	Enables conversationList and updates conversation list slotProps nesting.
docs/data/chat/material/conversation-list/FullCustomRow.js	Updates compiled demo accordingly.
docs/data/chat/material/conversation-list/CompactRow.tsx	Enables conversationList and updates conversation list slotProps nesting.
docs/data/chat/material/conversation-list/CompactRow.js	Updates compiled demo accordingly.
docs/data/chat/material/composer/ComposerDisabled.tsx	Updates composer slotProps nesting.
docs/data/chat/material/composer/ComposerDisabled.js	Updates compiled demo accordingly.
docs/data/chat/material/composer/ComposerCustomPlaceholder.tsx	Updates composer slotProps nesting.
docs/data/chat/material/composer/ComposerCustomPlaceholder.js	Updates compiled demo accordingly.
docs/data/chat/display/unread-marker/unread-marker.md	Adds placeholder markdown page for unread marker docs.
docs/data/chat/display/message-actions/RoleBasedMessageActions.tsx	Updates message actions slot nesting.
docs/data/chat/display/message-actions/RoleBasedMessageActions.js	Updates compiled demo accordingly.
docs/data/chat/display/message-actions/BasicMessageActions.tsx	Updates message actions slot nesting.
docs/data/chat/display/message-actions/BasicMessageActions.js	Updates compiled demo accordingly.
docs/data/chat/display/date-divider/date-divider.md	Adds placeholder markdown page for date divider docs.
docs/data/chat/customization/structure/structure.md	Adds placeholder markdown page for structure docs.
docs/data/chat/customization/overview/overview.md	Adds placeholder markdown page for customization overview docs.
docs/data/chat/customization/look-and-feel/look-and-feel.md	Adds placeholder markdown page for look-and-feel docs.
docs/data/chat/behavior/error-handling/error-handling.md	Updates components frontmatter to include new error components.
docs/data/chat/basics/conversation/conversation.md	Adds placeholder markdown page for conversation docs.
docs/data/chat/backend/built-in-adapters/echo-adapter/echo-adapter.md	Adds placeholder markdown page for echo adapter docs.
docs/data/chat/backend/built-in-adapters/ai-sdk-adapter/ai-sdk-adapter.md	Adds placeholder markdown page for AI SDK adapter docs.
docs/data/chat/all-components/all-components.md	Adds placeholder markdown page for all-components gallery.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

hasdfa · 2026-05-18T14:30:05Z

  { "name": "ChatBoxClasses", "kind": "Interface" },
  { "name": "ChatBoxClassKey", "kind": "TypeAlias" },
  { "name": "ChatBoxFeatures", "kind": "Interface" },
+  { "name": "ChatBoxLayoutMode", "kind": "TypeAlias" },
+  { "name": "ChatBoxLayoutModeBreakpoints", "kind": "Interface" },
  { "name": "ChatBoxProps", "kind": "Interface" },


This is expected stack noise because the PR still targets master: lower dependency branches appear in the full GitHub diff. The actual #22483 layer is the docs page-shell/navigation work on top of #22482; the related-PR tree in the description shows the merge order.

hasdfa · 2026-05-18T14:30:08Z

+  "name": "MessageError",
+  "imports": [
+    "import { MessageError } from '@mui/x-chat/headless';",
+    "import { MessageError } from '@mui/x-chat/headless';"
+  ],


Fixed lower in the stack in 9941d6e3dc: the chat API docs generator now dedupes imports. After rebasing this branch, the stale duplicate-import diff is gone here too.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: faee23e8b7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-05-18T13:22:35Z

+        // Allow any replayed sequence number to apply on the reconnected
+        // stream (#5). Without this, chunks the server resends from an
+        // earlier point would be silently dropped by the sequence guard.
+        reconnectFromSequence: 0,


Remove hardcoded reconnect sequence floor

Do not force reconnectFromSequence: 0 here. processStream treats expectedSequence as the next required envelope sequence, so if a reconnecting adapter resumes at a higher sequence (for example, 51), every envelope is buffered as “future” and never processed because 0..50 never arrive. In that case the reconnect path can return sent without consuming the resumed chunks, leaving the assistant message in a stale/error state and dropping the resumed output.

Useful? React with 👍 / 👎.

Fixed lower in the stack in 1dba6392bf: reconnect now resumes from result.nextSequence, preserves seen event IDs, and avoids firing interim onFinish before the reconnect completes. This branch has been rebased on that fix.

chatgpt-codex-connector · 2026-05-18T13:22:35Z

+      input.signal.addEventListener('abort', onAbort, { once: true });
+
+      try {
+        await chat.sendMessage({ text: userText });


Forward draft attachments in AI SDK chat adapter

Pass attachments through when calling chat.sendMessage in the { chat } adapter branch. The current call only sends { text }, so messages composed with attachments lose their files entirely when this adapter is used, even though ChatSendMessageInput carries them and the AI SDK chat shape supports a files field.

Useful? React with 👍 / 👎.

Fixed lower in the stack in 849b199246: the AI SDK { chat } branch now forwards draft attachments as files to chat.sendMessage. This branch has been rebased on that fix.

hasdfa added 2 commits May 17, 2026 20:45

[x-chat] Complete built-in adapter exports

2f156eb

hasdfa mentioned this pull request May 17, 2026

[docs] Add chat playground infrastructure #22484

Open

hasdfa added scope: chat Changes related to the AI chat. type: enhancement It’s an improvement, but we can’t make up our mind whether it's a bug fix or a new feature. docs Improvements or additions to the documentation. labels May 17, 2026

[chat-headless] Format AI SDK adapter test

59f5389

hasdfa force-pushed the x-chat-docs-new-pages branch 2 times, most recently from de78ede to faee23e Compare May 18, 2026 09:54

hasdfa mentioned this pull request May 18, 2026

[docs] Reorganize existing chat docs navigation #22478

Open

hasdfa marked this pull request as ready for review May 18, 2026 13:14

Copilot AI review requested due to automatic review settings May 18, 2026 13:14

Copilot started reviewing on behalf of hasdfa May 18, 2026 13:15 View session

Copilot AI reviewed May 18, 2026

View reviewed changes

chatgpt-codex-connector Bot reviewed May 18, 2026

View reviewed changes

[x-chat] Address built-in adapter review comments

849b199

hasdfa force-pushed the x-chat-docs-new-pages branch from faee23e to d48ca3d Compare May 18, 2026 14:29

hasdfa added 7 commits May 18, 2026 16:41

[x-chat] Fix adapter CI issues

8d32a61

[chat-headless] Harden runtime model and message errors

2e92b22

[chat-headless] Fix runtime branch CI

216a7da

[chat-headless] Keep runtime tests on pre-slots API

c8fc6ba

[chat-headless] Fix runtime static docs output

9034463

[chat-headless] Address runtime review comments

212b1cc

[chat-headless] Fix provider controlled message reset

0585a84

hasdfa force-pushed the x-chat-docs-new-pages branch from d48ca3d to 606ad17 Compare May 18, 2026 14:44

[chat-headless] Forward role display names

555b9fa

hasdfa force-pushed the x-chat-docs-new-pages branch from 606ad17 to c1da39a Compare May 18, 2026 14:51

hasdfa added 2 commits May 18, 2026 17:13

[chat-headless] Regenerate ChatBox API docs

2d10846

[x-chat] Harden material message surfaces

285865c

hasdfa added 11 commits May 18, 2026 17:14

[x-chat] Fix material message surfaces CI

2f6463d

[x-chat] Fix message surface API docs generation

66c6e5a

[docs] Dedupe chat API imports

613840a

[x-chat] Add ChatBox layout slots and migration codemod

1318492

[x-chat] Fix slots migration branch CI

fb08ef6

[x-chat] Regenerate slots API demo links

e0f9f43

[x-chat] Address chat slots codemod reviews

81b4b68

[docs] Reorganize existing chat docs navigation

9f6131a

[docs] Add chat docs page shells

555dfe7

[docs] Fix chat page shell Vale wording

c7408af

[docs] Regenerate chat page shell API links

d000594

hasdfa force-pushed the x-chat-docs-new-pages branch from c1da39a to d000594 Compare May 18, 2026 15:24

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[docs] Add chat docs page shells#22483

[docs] Add chat docs page shells#22483
hasdfa wants to merge 25 commits into
mui:masterfrom
hasdfa:x-chat-docs-new-pages

hasdfa commented May 17, 2026 •

edited

Loading

Uh oh!

code-infra-dashboard Bot commented May 17, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

hasdfa May 18, 2026

Uh oh!

hasdfa May 18, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

chatgpt-codex-connector Bot May 18, 2026

Uh oh!

hasdfa May 18, 2026

Uh oh!

chatgpt-codex-connector Bot May 18, 2026

Uh oh!

hasdfa May 18, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

hasdfa commented May 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Details

Validation

Batch merge structure

Uh oh!

code-infra-dashboard Bot commented May 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploy preview

Bundle size

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

hasdfa May 18, 2026

Choose a reason for hiding this comment

Uh oh!

hasdfa May 18, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot May 18, 2026

Choose a reason for hiding this comment

Uh oh!

hasdfa May 18, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot May 18, 2026

Choose a reason for hiding this comment

Uh oh!

hasdfa May 18, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

hasdfa commented May 17, 2026 •

edited

Loading

code-infra-dashboard Bot commented May 17, 2026 •

edited

Loading