An open source design system that's fully customizable and agent ready
TypeScript
Improve ChatMessageMetadata docs page and block examples (#1867)
Kenton Quatmandeef77cd1f20
diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.doc.mjsnew file mode 100644index 0000000000..9698a14e0b--- /dev/null+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.doc.mjs@@ -0,0 +1,9 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'ChatMessageMetadata — Footer Actions',+ description: 'Assistant message with footer actions — copy, retry, thumbs up/down, and model label. Use for AI responses that need feedback or utility controls.',+ isReady: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Chat', 'ChatMessageMetadata', 'Timestamp', 'Button', 'Icon', 'Text', 'Layout'],+};diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.tsxnew file mode 100644index 0000000000..705afccbad--- /dev/null+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.tsx@@ -0,0 +1,93 @@+'use client';++import {+ XDSChatMessageList,+ XDSChatMessage,+ XDSChatMessageBubble,+ XDSChatMessageMetadata,+} from '@xds/core/Chat';+import {XDSTimestamp} from '@xds/core/Timestamp';+import {XDSButton} from '@xds/core/Button';+import {XDSIcon} from '@xds/core/Icon';+import {XDSText} from '@xds/core/Text';+import {XDSHStack} from '@xds/core/Layout';+import {+ ClipboardDocumentIcon,+ ArrowPathIcon,+ HandThumbUpIcon,+ HandThumbDownIcon,+} from '@heroicons/react/24/outline';++export default function ChatMessageMetadataFooter() {+ return (+ <XDSChatMessageList>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-29T09:41:00" format="time" />+ }+ status="read"+ />+ }>+ Summarize the Q1 revenue report.+ </XDSChatMessageBubble>+ </XDSChatMessage>++ <XDSChatMessage sender="assistant">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-29T09:42:00" format="time" />+ }+ footer={+ <XDSHStack gap={1}>+ <XDSButton+ label="Copy"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={ClipboardDocumentIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSButton+ label="Retry"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={ArrowPathIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSButton+ label="Good response"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={HandThumbUpIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSButton+ label="Bad response"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={HandThumbDownIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSText type="supporting" color="secondary">+ GPT-4o+ </XDSText>+ </XDSHStack>+ }+ />+ }>+ Q1 revenue reached $2.4B, up 18% year-over-year. Enterprise+ subscriptions drove 62% of the growth, while ad revenue held steady at+ $890M.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>+ );+}diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.doc.mjsindex d738e8aaa3..a249095c97 100644--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.doc.mjs+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.doc.mjs@@ -2,7 +2,7 @@export const doc = {type: 'block',name: 'ChatMessageMetadata',- description: 'Message metadata showing timestamps, delivery status, model info, and action buttons (copy, retry, approve) in the footer area.',+ description: 'Three-message conversation showcasing error status with retry, delivery status, and full footer actions with model label.',isReady: true,isShowcase: true,aspectRatio: 4 / 3,diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.tsxindex 243bab8afc..b2c7ac5d91 100644--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataShowcase.tsx@@ -1,5 +1,6 @@'use client';+import * as stylex from '@stylexjs/stylex';import {XDSChatMessageList,XDSChatMessage,@@ -10,109 +11,117 @@ import {XDSTimestamp} from '@xds/core/Timestamp';import {XDSText} from '@xds/core/Text';import {XDSButton} from '@xds/core/Button';import {XDSIcon} from '@xds/core/Icon';-import {XDSHStack} from '@xds/core/Layout';+import {XDSHStack, XDSVStack} from '@xds/core/Layout';+import {+ ClipboardDocumentIcon,+ ArrowPathIcon,+ HandThumbUpIcon,+ HandThumbDownIcon,+} from '@heroicons/react/24/outline';++const styles = stylex.create({+ container: {+ maxWidth: 600,+ },+});export default function ChatMessageMetadataShowcase() {return (- <XDSChatMessageList>- <XDSChatMessage sender="user">- <XDSChatMessageBubble- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-03-15T14:30:00" format="time" />- }- status="read"- />- }>- Did you see the latest deployment?- </XDSChatMessageBubble>- </XDSChatMessage>-- <XDSChatMessage sender="assistant">- <XDSChatMessageBubble- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-03-15T14:31:00" format="time" />- }- footer={- <XDSHStack gap={1}>- <XDSButton- label="Copy"- variant="ghost"- size="sm"- icon={<XDSIcon icon="copy" size="sm" />}- isIconOnly- onClick={() => {}}- />- <XDSButton- label="Retry"- variant="ghost"- size="sm"- icon={<XDSIcon icon="wrench" size="sm" />}- isIconOnly- onClick={() => {}}- />- <XDSButton- label="Good"- variant="ghost"- size="sm"- icon={<XDSIcon icon="check" size="sm" />}- isIconOnly- onClick={() => {}}- />- <XDSText type="supporting" color="secondary">- Claude Opus 4.6- </XDSText>- </XDSHStack>- }- />- }>- Yes, everything looks good! The build passed all checks and- performance metrics are within target.- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSVStack xstyle={styles.container}>+ <XDSChatMessageList>+ <XDSChatMessage sender="assistant">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-03-15T14:30:00" format="time" />+ }+ status="error"+ footer={+ <XDSHStack gap={1}>+ <XDSButton+ label="Retry"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={ArrowPathIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ </XDSHStack>+ }+ />+ }>+ Sorry, something went wrong on my end.+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage sender="user">- <XDSChatMessageBubble- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-03-15T14:32:00" format="time" />- }- status="delivered"- />- }>- Great, shipping it now.- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-03-15T14:31:00" format="time" />+ }+ status="read"+ />+ }>+ No worries — try again with just the last 24 hours of logs.+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage sender="assistant">- <XDSChatMessageBubble- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-03-15T14:33:00" format="time" />- }- status="error"- footer={- <XDSHStack gap={1}>- <XDSButton- label="Retry"- variant="ghost"- size="sm"- icon={<XDSIcon icon="wrench" size="sm" />}- isIconOnly- onClick={() => {}}- />- </XDSHStack>- }- />- }>- Metadata can also show error status with a retry action.- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>+ <XDSChatMessage sender="assistant">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-03-15T14:32:00" format="time" />+ }+ footer={+ <XDSHStack gap={1}>+ <XDSButton+ label="Copy"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={ClipboardDocumentIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSButton+ label="Retry"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={ArrowPathIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSButton+ label="Good response"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={HandThumbUpIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSButton+ label="Bad response"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon={HandThumbDownIcon} size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSText type="supporting" color="secondary">+ Claude Opus 4.6+ </XDSText>+ </XDSHStack>+ }+ />+ }>+ The canary at 11:42 AM caused a memory spike. Rolled back+ at 11:58 AM.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>+ </XDSVStack>);}diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.doc.mjsnew file mode 100644index 0000000000..f68427eeee--- /dev/null+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.doc.mjs@@ -0,0 +1,9 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'ChatMessageMetadata — Status',+ description: 'All 5 delivery statuses — sending, sent, delivered, read, and error — each with a timestamp. Use to show message delivery progress or surface failures.',+ isReady: true,+ aspectRatio: 1,+ componentsUsed: ['Chat', 'ChatMessageMetadata', 'Timestamp'],+};diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsxnew file mode 100644index 0000000000..b2b81fa98b--- /dev/null+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsx@@ -0,0 +1,39 @@+'use client';++import {+ XDSChatMessageList,+ XDSChatMessage,+ XDSChatMessageBubble,+ XDSChatMessageMetadata,+} from '@xds/core/Chat';+import {XDSTimestamp} from '@xds/core/Timestamp';++const STATUSES = [+ {status: 'sending' as const, text: 'Deploying the update now…'},+ {status: 'sent' as const, text: 'Config pushed to staging.'},+ {status: 'delivered' as const, text: 'Verified on the staging cluster.'},+ {status: 'read' as const, text: 'Looks good — promoting to prod.'},+ {status: 'error' as const, text: 'Rollback triggered, checking logs.'},+];++export default function ChatMessageMetadataStatus() {+ return (+ <XDSChatMessageList>+ {STATUSES.map(({status, text}) => (+ <XDSChatMessage key={status} sender="user">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-29T10:15:00" format="time" />+ }+ status={status}+ />+ }>+ {text}+ </XDSChatMessageBubble>+ </XDSChatMessage>+ ))}+ </XDSChatMessageList>+ );+}diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.doc.mjs b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.doc.mjsnew file mode 100644index 0000000000..e3c30b7b3d--- /dev/null+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.doc.mjs@@ -0,0 +1,9 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'ChatMessageMetadata — Timestamps',+ description: 'Timestamp-only metadata on user and assistant messages. Supports absolute time and relative formats via XDSTimestamp.',+ isReady: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Chat', 'ChatMessageMetadata', 'Timestamp'],+};diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsxnew file mode 100644index 0000000000..b47ddf2a54--- /dev/null+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsx@@ -0,0 +1,42 @@+'use client';++import {+ XDSChatMessageList,+ XDSChatMessage,+ XDSChatMessageBubble,+ XDSChatMessageMetadata,+} from '@xds/core/Chat';+import {XDSTimestamp} from '@xds/core/Timestamp';++export default function ChatMessageMetadataTimestamp() {+ return (+ <XDSChatMessageList>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-29T14:30:00" format="time" />+ }+ />+ }>+ Thanks — any blockers I should know about?+ </XDSChatMessageBubble>+ </XDSChatMessage>++ <XDSChatMessage sender="assistant">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T16:45:00" format="relative" />+ }+ />+ }>+ Relative timestamps work too — helpful for older messages where the+ exact time matters less than recency.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>+ );+}diff --git a/packages/core/src/Chat/Chat.doc.mjs b/packages/core/src/Chat/Chat.doc.mjsindex af4971e92a..7511e8bb73 100644--- a/packages/core/src/Chat/Chat.doc.mjs+++ b/packages/core/src/Chat/Chat.doc.mjs@@ -66,11 +66,11 @@ export const docs = {},{name: 'XDSChatMessageMetadata',- description: 'Composable metadata row for chat messages. Renders timestamp, footer content, and delivery status in a single row. Direction reverses for user sender. Renders nothing if all props are empty.',+ description: 'Composable metadata row that sits below a chat bubble. Arranges timestamp, footer actions, and delivery status in a single line — direction auto-reverses for user messages. Pass it to the metadata prop on XDSChatMessageBubble. Renders nothing when all slots are empty.',props: [- {name: 'timestamp', type: 'ReactNode', description: 'Timestamp content — a string or XDSTimestamp component.'},- {name: 'footer', type: 'ReactNode', description: 'Footer content — model info, reaction buttons, copy button.'},- {name: 'status', type: "'sending' | 'sent' | 'delivered' | 'read' | 'error'", description: 'Message delivery status. Shows icon + label.'},+ {name: 'timestamp', type: 'ReactNode', description: 'Timestamp content — typically an XDSTimestamp component with format="time" or format="relative".'},+ {name: 'footer', type: 'ReactNode', description: 'Footer actions or info — copy/retry/feedback buttons, model label, or any ReactNode. Use XDSHStack with ghost icon-only buttons for action rows.'},+ {name: 'status', type: "'sending' | 'sent' | 'delivered' | 'read' | 'error'", description: 'Delivery status indicator. Renders an icon and label — pulse animation for sending, red for error.'},],},{@@ -176,11 +176,16 @@ export const docs = {{ guidance: true, description: 'Use XDSChatLayout for full-page chat — it handles auto-scroll, density adaptation, and composer docking automatically.' },{ guidance: true, description: 'Use XDSChatSystemMessage with variant="divider" for date separators and default for status notices like joins, leaves, or topic changes.' },{ guidance: true, description: 'Add an icon to system messages when the type is not obvious from the text alone — membership changes, encryption notices, or AI activity benefit from visual reinforcement.' },+ { guidance: true, description: 'Pass XDSChatMessageMetadata to the bubble\'s metadata prop. It auto-reverses direction for user vs. assistant messages so timestamps and status always read naturally.' },+ { guidance: true, description: 'Use XDSTimestamp with format="time" for recent messages and format="relative" for older ones. Avoid raw date strings — XDSTimestamp handles localization and live updates.' },+ { guidance: true, description: 'Keep footer actions in XDSChatMessageMetadata small and icon-only — ghost variant, size="sm" buttons grouped in an XDSHStack. Reserve footer actions for assistant messages.' },{ guidance: false, description: 'Don\'t build custom input containers or composer chrome — XDSChatComposer handles the border radius, shadows, focus ring, and slot layout. Customise through slots, not wrapping.' },{ guidance: false, description: 'Don\'t place metadata or names on both the bubble and the message wrapper — pick one based on whether the content has a bubble boundary.' },{ guidance: false, description: 'Don\'t use the status prop for transient success messages — it\'s for errors and warnings that need the user\'s attention before they send another message.' },{ guidance: false, description: 'Don\'t use XDSChatSystemMessage for sender content — it has no avatar, alignment, or bubble. Use XDSChatMessage with a sender role instead.' },{ guidance: false, description: 'Don\'t put long or multi-line content in a system message — keep it to a single short sentence. If you need more, use a bubble or a card.' },+ { guidance: false, description: 'Don\'t add footer actions to user messages — users don\'t need to copy, retry, or rate their own messages. Use status alone for delivery feedback.' },+ { guidance: false, description: 'Don\'t show delivery status on assistant messages — status (sending, delivered, read) only applies to outbound user messages.' },],anatomy: [{ name: 'Drawer', required: false, description: 'Collapsible area above the input for file tokens, context chips, or other attachments. Use XDSChatComposerDrawer.' },@@ -232,11 +237,16 @@ export const docsZh = {{ guidance: true, description: 'Use XDSChatLayout for full-page chat — it handles auto-scroll, density adaptation, and composer docking automatically.' },{ guidance: true, description: 'Use XDSChatSystemMessage with variant="divider" for date separators and default for status notices like joins, leaves, or topic changes.' },{ guidance: true, description: 'Add an icon to system messages when the type is not obvious from the text alone — membership changes, encryption notices, or AI activity benefit from visual reinforcement.' },+ { guidance: true, description: 'Pass XDSChatMessageMetadata to the bubble\'s metadata prop. It auto-reverses direction for user vs. assistant messages so timestamps and status always read naturally.' },+ { guidance: true, description: 'Use XDSTimestamp with format="time" for recent messages and format="relative" for older ones. Avoid raw date strings — XDSTimestamp handles localization and live updates.' },+ { guidance: true, description: 'Keep footer actions in XDSChatMessageMetadata small and icon-only — ghost variant, size="sm" buttons grouped in an XDSHStack. Reserve footer actions for assistant messages.' },{ guidance: false, description: 'Don\'t build custom input containers or composer chrome — XDSChatComposer handles the border radius, shadows, focus ring, and slot layout. Customise through slots, not wrapping.' },{ guidance: false, description: 'Don\'t place metadata or names on both the bubble and the message wrapper — pick one based on whether the content has a bubble boundary.' },{ guidance: false, description: 'Don\'t use the status prop for transient success messages — it\'s for errors and warnings that need the user\'s attention before they send another message.' },{ guidance: false, description: 'Don\'t use XDSChatSystemMessage for sender content — it has no avatar, alignment, or bubble. Use XDSChatMessage with a sender role instead.' },{ guidance: false, description: 'Don\'t put long or multi-line content in a system message — keep it to a single short sentence. If you need more, use a bubble or a card.' },+ { guidance: false, description: 'Don\'t add footer actions to user messages — users don\'t need to copy, retry, or rate their own messages. Use status alone for delivery feedback.' },+ { guidance: false, description: 'Don\'t show delivery status on assistant messages — status (sending, delivered, read) only applies to outbound user messages.' },],},components: [@@ -275,8 +285,8 @@ export const docsZh = {},{name: 'XDSChatMessageMetadata',- description: '可组合的消息元数据行。渲染时间戳、页脚内容和发送状态。用户消息方向反转。',- propDescriptions: {timestamp: '时间戳内容 — 字符串或 XDSTimestamp 组件。', footer: '页脚内容 — 模型信息、反应按钮、复制按钮。', status: '消息发送状态。显示图标和标签。'},+ description: '可组合的消息元数据行。渲染时间戳、页脚操作和发送状态。用户消息方向自动反转。传递给气泡的 metadata 属性。',+ propDescriptions: {timestamp: '时间戳内容 — 通常是 XDSTimestamp 组件,使用 format="time" 或 format="relative"。', footer: '页脚操作或信息 — 复制/重试/反馈按钮、模型标签。使用 XDSHStack 组合 ghost 图标按钮。', status: '发送状态指示器。渲染图标和标签 — sending 有脉冲动画,error 为红色。'},},{name: 'XDSChatSystemMessage',@@ -396,11 +406,16 @@ export const docsDense = {{ guidance: true, description: 'Name/metadata on bubble if bubble boundary, on message wrapper if raw content.' },{ guidance: true, description: 'XDSChatLayout for full-page — auto-scroll, density adaptation, composer docking.' },{ guidance: true, description: 'SystemMessage: divider variant for date breaks, default for status notices. Add icon for membership/encryption/AI messages.' },+ { guidance: true, description: 'XDSChatMessageMetadata on bubble metadata prop — auto-reverses for user vs assistant.' },+ { guidance: true, description: 'XDSTimestamp format="time" for recent, format="relative" for older. No raw date strings.' },+ { guidance: true, description: 'Footer actions: ghost size="sm" icon-only buttons in XDSHStack. Assistant messages only.' },{ guidance: false, description: 'Custom composer chrome — Composer handles radius, shadows, focus ring. Use slots.' },{ guidance: false, description: 'Metadata/names on both bubble and wrapper — pick one.' },{ guidance: false, description: 'Status for success toasts — it\'s for errors/warnings before next send.' },{ guidance: false, description: 'SystemMessage for sender content — no avatar/alignment/bubble. Use ChatMessage instead.' },{ guidance: false, description: 'Long/multi-line system messages — keep to a single short sentence.' },+ { guidance: false, description: 'Footer actions on user messages — use status alone for delivery feedback.' },+ { guidance: false, description: 'Delivery status on assistant messages — status is for outbound user messages only.' },],},components: [@@ -439,11 +454,11 @@ export const docsDense = {},{name: 'XDSChatMessageMetadata',- description: 'composable metadata row; renders timestamp · footer · status; reverses for user sender',+ description: 'composable metadata row; timestamp · footer · status; auto-reverses for user sender; pass to bubble metadata prop',propDescriptions: {- timestamp: 'timestamp content; string or XDSTimestamp',- footer: 'footer content; model info, reaction btns, copy btn',- status: 'delivery status; shows icon+label',+ timestamp: 'XDSTimestamp w/ format="time" or "relative"',+ footer: 'actions/info: ghost sm icon-only buttons in XDSHStack, model label',+ status: 'delivery status; icon+label; pulse for sending, red for error',},},{