Skip to content

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.mjs
new file mode 100644
index 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.tsx
new file mode 100644
index 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.mjs
index 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.tsx
index 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.mjs
new file mode 100644
index 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.tsx
new file mode 100644
index 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.mjs
new file mode 100644
index 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.tsx
new file mode 100644
index 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.mjs
index 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',
},
},
{