An open source design system that's fully customizable and agent ready
TypeScript
fix (sandbox) Chat component block examples (#2037)
Kenton Quatmand92696e085e0
diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFullFeatured.tsx b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFullFeatured.tsxindex 78d025e224..262a32481f 100644--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFullFeatured.tsx+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerFullFeatured.tsx@@ -1,7 +1,11 @@'use client';import {useState} from 'react';-import {XDSChatComposer, XDSChatComposerDrawer} from '@xds/core/Chat';+import {+ XDSChatComposer,+ XDSChatComposerDrawer,+ XDSChatComposerInput,+} from '@xds/core/Chat';import {XDSToken} from '@xds/core/Token';import {XDSButton} from '@xds/core/Button';import {XDSDropdownMenu} from '@xds/core/DropdownMenu';@@ -21,7 +25,10 @@ export default function ChatComposerFullFeatured() {const [isStreaming, setIsStreaming] = useState(false);return (- <XDSStack direction="vertical" gap={4} style={{width: '100%', maxWidth: 450}}>+ <XDSStack+ direction="vertical"+ gap={4}+ style={{width: '100%', maxWidth: 450}}><XDSText type="supporting" color="secondary">All slots populated</XDSText>@@ -34,6 +41,7 @@ export default function ChatComposerFullFeatured() {isStreaming={isStreaming}onStop={() => setIsStreaming(false)}placeholder="Ask me anything..."+ input={<XDSChatComposerInput style={{minHeight: 44}} />}drawer={<XDSChatComposerDrawer count={5}><XDSToken label="design-spec.pdf" onRemove={() => {}} />@@ -62,7 +70,7 @@ export default function ChatComposerFullFeatured() {</>}headerContext={- <XDSProgressBar label="Context window" value={3} isLabelHidden />+ <XDSProgressBar label="Context window" value={50} isLabelHidden />}footerActions={<>diff --git a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerStreaming.tsx b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerStreaming.tsxindex 0568d41b60..42a9dfb5aa 100644--- a/packages/cli/templates/blocks/components/ChatComposer/ChatComposerStreaming.tsx+++ b/packages/cli/templates/blocks/components/ChatComposer/ChatComposerStreaming.tsx@@ -7,16 +7,27 @@ import {XDSText} from '@xds/core/Text';export default function ChatComposerStreaming() {const [isStreaming, setIsStreaming] = useState(false);+ const [value, setValue] = useState(+ 'Click the send button to start streaming.',+ );return (- <XDSStack direction="vertical" gap={4} style={{width: '100%', maxWidth: 450}}>+ <XDSStack+ direction="vertical"+ gap={4}+ style={{width: '100%', maxWidth: 450}}><XDSStack direction="vertical" gap={1}><XDSText type="supporting" color="secondary">- {isStreaming ? 'Streaming — click stop to cancel' : 'Send a message to start streaming'}+ {isStreaming+ ? 'Streaming — click stop to cancel'+ : 'Send a message to start streaming'}</XDSText><XDSChatComposer+ value={value}+ onChange={setValue}onSubmit={value => {console.log('Sent:', value);+ setValue('');setIsStreaming(true);setTimeout(() => setIsStreaming(false), 5000);}}diff --git a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageAvatarName.tsx b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageAvatarName.tsxindex dfd2d3fe45..848568e466 100644--- a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageAvatarName.tsx+++ b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageAvatarName.tsx@@ -9,70 +9,64 @@ import {import {XDSAvatar} from '@xds/core/Avatar';import {XDSTimestamp} from '@xds/core/Timestamp';import {XDSText} from '@xds/core/Text';-import {XDSStack} from '@xds/core/Layout';export default function ChatMessageAvatarName() {return (- <XDSStack direction="vertical" gap={4}>- <XDSText type="supporting" color="secondary">- Avatar and name on the bubble- </XDSText>- <XDSChatMessageList>- <XDSChatMessage- sender="assistant"- avatar={<XDSAvatar name="Agent" size="small" />}>- <XDSChatMessageBubble- name={- <XDSText type="supporting" weight="semibold" color="secondary">- Agent- </XDSText>- }- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-28T10:15:00" format="time" />- }- />- }>- I reviewed the pull request. The changes look solid — clean code and- good test coverage.- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessageList style={{maxWidth: 500}}>+ <XDSChatMessage+ sender="assistant"+ avatar={<XDSAvatar name="Agent" size="small" />}>+ <XDSChatMessageBubble+ name={+ <XDSText type="supporting" weight="semibold" color="secondary">+ Agent+ </XDSText>+ }+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T10:15:00" format="time" />+ }+ />+ }>+ I reviewed the pull request. The changes look solid — clean code and+ good test coverage.+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage sender="user">- <XDSChatMessageBubble- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-28T10:16:00" format="time" />- }- status="read"- />- }>- Thanks! Merging it now.- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T10:16:00" format="time" />+ }+ status="read"+ />+ }>+ Thanks! Merging it now.+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage- sender="assistant"- avatar={<XDSAvatar name="Agent" size="small" />}>- <XDSChatMessageBubble- name={- <XDSText type="supporting" weight="semibold" color="secondary">- Agent- </XDSText>- }- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-28T10:17:00" format="time" />- }- />- }>- I can run the deployment pipeline once it lands. Just let me know.- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>- </XDSStack>+ <XDSChatMessage+ sender="assistant"+ avatar={<XDSAvatar name="Agent" size="small" />}>+ <XDSChatMessageBubble+ name={+ <XDSText type="supporting" weight="semibold" color="secondary">+ Agent+ </XDSText>+ }+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T10:17:00" format="time" />+ }+ />+ }>+ I can run the deployment pipeline once it lands. Just let me know.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>);}diff --git a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageGhost.tsx b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageGhost.tsxindex ef6aa050e9..e4f217a4c2 100644--- a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageGhost.tsx+++ b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageGhost.tsx@@ -8,63 +8,56 @@ import {} from '@xds/core/Chat';import {XDSTimestamp} from '@xds/core/Timestamp';import {XDSText} from '@xds/core/Text';-import {XDSStack} from '@xds/core/Layout';export default function ChatMessageGhost() {return (- <XDSStack direction="vertical" gap={4}>- <XDSText type="supporting" color="secondary">- Ghost bubbles — no visible boundary- </XDSText>- <XDSChatMessageList>- <XDSChatMessage sender="assistant">- <XDSChatMessageBubble- variant="ghost"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-28T09:45:00" format="time" />- }- footer={- <XDSText type="supporting" color="secondary">- Claude Opus 4.6- </XDSText>- }- />- }>- Here is an analysis of your production metrics from last week.- Traffic peaked at 12,400 requests per second on Wednesday, with a- p99 latency of 45ms. Error rate stayed below 0.1% across all- endpoints.- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessageList style={{maxWidth: 500}}>+ <XDSChatMessage sender="assistant">+ <XDSChatMessageBubble+ variant="ghost"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T09:45:00" format="time" />+ }+ footer={+ <XDSText type="supporting" color="secondary">+ Claude Opus 4.6+ </XDSText>+ }+ />+ }>+ Here is an analysis of your production metrics from last week. Traffic+ peaked at 12,400 requests per second on Wednesday, with a p99 latency+ of 45ms. Error rate stayed below 0.1% across all endpoints.+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage sender="user">- <XDSChatMessageBubble>- That looks great. Can you compare it to the week before?- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble>+ That looks great. Can you compare it to the week before?+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage sender="assistant">- <XDSChatMessageBubble- variant="ghost"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-28T09:46:00" format="time" />- }- footer={- <XDSText type="supporting" color="secondary">- Claude Opus 4.6- </XDSText>- }- />- }>- Compared to the previous week, traffic is up 8% and latency improved- by 3ms. The deployment on Tuesday seems to have helped.- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>- </XDSStack>+ <XDSChatMessage sender="assistant">+ <XDSChatMessageBubble+ variant="ghost"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T09:46:00" format="time" />+ }+ footer={+ <XDSText type="supporting" color="secondary">+ Claude Opus 4.6+ </XDSText>+ }+ />+ }>+ Compared to the previous week, traffic is up 8% and latency improved+ by 3ms. The deployment on Tuesday seems to have helped.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>);}diff --git a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageMultiBubble.tsx b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageMultiBubble.tsxindex c91dbdbd49..54a4b0c6e8 100644--- a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageMultiBubble.tsx+++ b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageMultiBubble.tsx@@ -9,63 +9,57 @@ import {import {XDSAvatar} from '@xds/core/Avatar';import {XDSTimestamp} from '@xds/core/Timestamp';import {XDSText} from '@xds/core/Text';-import {XDSStack} from '@xds/core/Layout';export default function ChatMessageMultiBubble() {return (- <XDSStack direction="vertical" gap={4}>- <XDSText type="supporting" color="secondary">- Grouped bubbles with corner radius reduction- </XDSText>- <XDSChatMessageList>- <XDSChatMessage sender="user">- <XDSChatMessageBubble group="first">- I have a couple of questions about the new API.- </XDSChatMessageBubble>- <XDSChatMessageBubble group="middle">- First, how should we handle pagination?- </XDSChatMessageBubble>- <XDSChatMessageBubble- group="last"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-28T11:00:00" format="time" />- }- status="delivered"- />- }>- And second, what's the rate limit?- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessageList style={{maxWidth: 500}}>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble group="first">+ I have a couple of questions about the new API.+ </XDSChatMessageBubble>+ <XDSChatMessageBubble group="middle">+ First, how should we handle pagination?+ </XDSChatMessageBubble>+ <XDSChatMessageBubble+ group="last"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T11:00:00" format="time" />+ }+ status="delivered"+ />+ }>+ And second, what's the rate limit?+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage- sender="assistant"- avatar={<XDSAvatar name="Agent" size="small" />}>- <XDSChatMessageBubble- group="first"- name={- <XDSText type="supporting" weight="semibold" color="secondary">- Agent- </XDSText>- }>- Great questions! For pagination, use cursor-based with a limit- parameter. The response includes a nextCursor field.- </XDSChatMessageBubble>- <XDSChatMessageBubble- group="last"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-28T11:01:00" format="time" />- }- />- }>- Rate limit is 100 requests per minute per API key. You'll get a 429- response with a Retry-After header if you exceed it.- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>- </XDSStack>+ <XDSChatMessage+ sender="assistant"+ avatar={<XDSAvatar name="Agent" size="small" />}>+ <XDSChatMessageBubble+ group="first"+ name={+ <XDSText type="supporting" weight="semibold" color="secondary">+ Agent+ </XDSText>+ }>+ Great questions! For pagination, use cursor-based with a limit+ parameter. The response includes a nextCursor field.+ </XDSChatMessageBubble>+ <XDSChatMessageBubble+ group="last"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T11:01:00" format="time" />+ }+ />+ }>+ Rate limit is 100 requests per minute per API key. You'll get a 429+ response with a Retry-After header if you exceed it.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>);}diff --git a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageShowcase.tsx b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageShowcase.tsxindex e25ee43a31..14c26bcde4 100644--- a/packages/cli/templates/blocks/components/ChatMessage/ChatMessageShowcase.tsx+++ b/packages/cli/templates/blocks/components/ChatMessage/ChatMessageShowcase.tsx@@ -6,48 +6,33 @@ import {XDSChatMessageBubble,XDSChatMessageMetadata,} from '@xds/core/Chat';-import {XDSAvatar} from '@xds/core/Avatar';import {XDSTimestamp} from '@xds/core/Timestamp';import {XDSText} from '@xds/core/Text';-import {XDSStack} from '@xds/core/Layout';-import * as stylex from '@stylexjs/stylex';--const styles = stylex.create({- root: {- maxWidth: 600,- },-});export default function ChatMessageShowcase() {return (- <XDSStack direction="vertical" gap={4} xstyle={styles.root}>- <XDSChatMessageList>- <XDSChatMessage sender="user">- <XDSChatMessageBubble group="first">- I just pushed the refactored auth module.- </XDSChatMessageBubble>- <XDSChatMessageBubble- group="last"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-28T14:30:00" format="time" />- }- status="read"- />- }>- Can you review the token validation changes?- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessageList style={{maxWidth: 600}}>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble group="first">+ I just pushed the refactored auth module.+ </XDSChatMessageBubble>+ <XDSChatMessageBubble+ group="last"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-28T14:30:00" format="time" />+ }+ status="read"+ />+ }>+ Can you review the token validation changes?+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage- sender="assistant"- avatar={<XDSAvatar name="Agent" size="small" />}- name={- <XDSText type="supporting" weight="semibold" color="secondary">- Agent- </XDSText>- }+ <XDSChatMessage sender="assistant">+ <XDSChatMessageBubble+ variant="ghost"metadata={<XDSChatMessageMetadatatimestamp={@@ -60,12 +45,10 @@ export default function ChatMessageShowcase() {}/>}>- <XDSChatMessageBubble variant="ghost">- Looks good — the refresh token rotation is solid and the error- handling covers all the edge cases. Ship it.- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>- </XDSStack>+ Looks good — the refresh token rotation is solid and the error+ handling covers all the edge cases. Ship it.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>);}diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleDensity.tsx b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleDensity.tsxindex 98b437fa80..220f296cb7 100644--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleDensity.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleDensity.tsx@@ -16,7 +16,7 @@ const DENSITIES = [export default function ChatMessageBubbleDensity() {return (- <XDSVStack gap={5}>+ <XDSVStack gap={5} style={{width: '100%', maxWidth: 400}}>{DENSITIES.map(({density, label}) => (<XDSVStack key={density} gap={1}><XDSText type="supporting" color="secondary">@@ -29,9 +29,7 @@ export default function ChatMessageBubbleDensity() {</XDSChatMessageBubble></XDSChatMessage><XDSChatMessage sender="user">- <XDSChatMessageBubble>- Ship it to staging.- </XDSChatMessageBubble>+ <XDSChatMessageBubble>Ship it to staging.</XDSChatMessageBubble></XDSChatMessage></XDSChatMessageList></XDSVStack>diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleGrouping.tsx b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleGrouping.tsxindex e7a77dc4a2..292e60ed07 100644--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleGrouping.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleGrouping.tsx@@ -9,62 +9,54 @@ import {import {XDSAvatar} from '@xds/core/Avatar';import {XDSTimestamp} from '@xds/core/Timestamp';import {XDSText} from '@xds/core/Text';-import {XDSVStack} from '@xds/core/Layout';export default function ChatMessageBubbleGrouping() {return (- <XDSVStack gap={4}>- <XDSText type="supporting" color="secondary">- Grouped bubbles with tightened sender-side corners- </XDSText>- <XDSChatMessageList>- <XDSChatMessage- sender="assistant"- avatar={<XDSAvatar name="Agent" size="small" />}>- <XDSChatMessageBubble- group="first"- name={- <XDSText type="supporting" weight="semibold" color="secondary">- Agent- </XDSText>- }>- I reviewed the three files you shared.- </XDSChatMessageBubble>- <XDSChatMessageBubble group="middle">- The data model looks solid, but the API handler has a race- condition on concurrent writes.- </XDSChatMessageBubble>- <XDSChatMessageBubble- group="last"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-10T10:45:00" format="time" />- }- />- }>- I can draft a fix if you want.- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessageList style={{maxWidth: 500}}>+ <XDSChatMessage+ sender="assistant"+ avatar={<XDSAvatar name="Agent" size="small" />}>+ <XDSChatMessageBubble+ group="first"+ name={+ <XDSText type="supporting" weight="semibold" color="secondary">+ Agent+ </XDSText>+ }>+ I reviewed the three files you shared.+ </XDSChatMessageBubble>+ <XDSChatMessageBubble group="middle">+ The data model looks solid, but the API handler has a race condition+ on concurrent writes.+ </XDSChatMessageBubble>+ <XDSChatMessageBubble+ group="last"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-10T10:45:00" format="time" />+ }+ />+ }>+ I can draft a fix if you want.+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage sender="user">- <XDSChatMessageBubble group="first">- Yes please!- </XDSChatMessageBubble>- <XDSChatMessageBubble- group="last"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-10T10:46:00" format="time" />- }- status="delivered"- />- }>- Also add a test for the concurrent case.- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>- </XDSVStack>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble group="first">Yes please!</XDSChatMessageBubble>+ <XDSChatMessageBubble+ group="last"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-10T10:46:00" format="time" />+ }+ status="delivered"+ />+ }>+ Also add a test for the concurrent case.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>);}diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleMetadata.tsx b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleMetadata.tsxindex cbc78c585c..84a28ff30b 100644--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleMetadata.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleMetadata.tsx@@ -11,64 +11,59 @@ 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, XDSVStack} from '@xds/core/Layout';+import {XDSHStack} from '@xds/core/Layout';export default function ChatMessageBubbleMetadata() {return (- <XDSVStack gap={4}>- <XDSText type="supporting" color="secondary">- Name on first bubble, metadata on last- </XDSText>- <XDSChatMessageList>- <XDSChatMessage- sender="assistant"- avatar={<XDSAvatar name="Agent" size="small" />}>- <XDSChatMessageBubble- name={- <XDSText type="supporting" weight="semibold" color="secondary">- Agent- </XDSText>- }- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-10T09:15:00" format="time" />- }- footer={- <XDSHStack gap={1}>- <XDSButton- label="Copy"- variant="ghost"- size="sm"- icon={<XDSIcon icon="copy" size="sm" />}- isIconOnly- onClick={() => {}}- />- <XDSText type="supporting" color="secondary">- Claude Opus 4.6- </XDSText>- </XDSHStack>- }- />- }>- Your deployment finished successfully. All 14 checks passed.- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessageList style={{maxWidth: 500}}>+ <XDSChatMessage+ sender="assistant"+ avatar={<XDSAvatar name="Agent" size="small" />}>+ <XDSChatMessageBubble+ name={+ <XDSText type="supporting" weight="semibold" color="secondary">+ Agent+ </XDSText>+ }+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-10T09:15:00" format="time" />+ }+ footer={+ <XDSHStack gap={1}>+ <XDSButton+ label="Copy"+ variant="ghost"+ size="sm"+ icon={<XDSIcon icon="copy" size="sm" />}+ isIconOnly+ onClick={() => {}}+ />+ <XDSText type="supporting" color="secondary">+ Claude Opus 4.6+ </XDSText>+ </XDSHStack>+ }+ />+ }>+ Your deployment finished successfully. All 14 checks passed.+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage sender="user">- <XDSChatMessageBubble- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-10T09:16:00" format="time" />- }- status="read"- />- }>- Great, can you send me the production URL?- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>- </XDSVStack>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-10T09:16:00" format="time" />+ }+ status="read"+ />+ }>+ Great, can you send me the production URL?+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>);}diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleShowcase.tsx b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleShowcase.tsxindex bdfafda319..98fa7f2ec8 100644--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleShowcase.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleShowcase.tsx@@ -7,50 +7,41 @@ import {XDSChatMessageMetadata,} from '@xds/core/Chat';import {XDSTimestamp} from '@xds/core/Timestamp';-import * as stylex from '@stylexjs/stylex';--const styles = stylex.create({- root: {- maxWidth: 600,- },-});export default function ChatMessageBubbleShowcase() {return (- <div {...stylex.props(styles.root)}>- <XDSChatMessageList>- <XDSChatMessage sender="user">- <XDSChatMessageBubble group="first">- I just pushed the latest changes to the feature branch.- </XDSChatMessageBubble>- <XDSChatMessageBubble- group="last"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-10T09:15:00" format="time" />- }- status="read"- />- }>- Can you review when you get a chance?- </XDSChatMessageBubble>- </XDSChatMessage>+ <XDSChatMessageList style={{maxWidth: 600}}>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble group="first">+ I just pushed the latest changes to the feature branch.+ </XDSChatMessageBubble>+ <XDSChatMessageBubble+ group="last"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-10T09:15:00" format="time" />+ }+ status="read"+ />+ }>+ Can you review when you get a chance?+ </XDSChatMessageBubble>+ </XDSChatMessage>- <XDSChatMessage sender="assistant">- <XDSChatMessageBubble- variant="ghost"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-04-10T09:16:00" format="time" />- }- />- }>- The changes look great — clean code, good test coverage. Ship it!- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>- </div>+ <XDSChatMessage sender="assistant">+ <XDSChatMessageBubble+ variant="ghost"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-04-10T09:16:00" format="time" />+ }+ />+ }>+ The changes look great. Ship it!+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>);}diff --git a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleVariants.tsx b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleVariants.tsxindex 8465f41171..dc191a2352 100644--- a/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleVariants.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageBubble/ChatMessageBubbleVariants.tsx@@ -10,7 +10,7 @@ import {XDSText} from '@xds/core/Text';export default function ChatMessageBubbleVariants() {return (- <XDSStack direction="vertical" gap={4}>+ <XDSStack direction="vertical" gap={4} style={{maxWidth: 500}}><XDSStack direction="vertical" gap={1}><XDSText type="supporting" color="secondary">Filled — sender-colored background (default)diff --git a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListDensity.tsx b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListDensity.tsxindex b5998bb4d3..e41cfd08f3 100644--- a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListDensity.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListDensity.tsx@@ -8,6 +8,8 @@ import {import {XDSVStack} from '@xds/core/Layout';import {XDSText} from '@xds/core/Text';import {XDSAvatar} from '@xds/core/Avatar';+import {XDSDivider} from '@xds/core/Divider';+import {Fragment} from 'react';import * as stylex from '@stylexjs/stylex';const styles = stylex.create({@@ -27,31 +29,36 @@ const AVATAR_SIZE = {export default function ChatMessageListDensity() {return (- <XDSVStack gap={4}>- {DENSITIES.map(density => (- <XDSVStack key={density} gap={2}>- <XDSText type="supporting" color="secondary">- {density.charAt(0).toUpperCase() + density.slice(1)}- </XDSText>- <XDSVStack xstyle={styles.section}>- <XDSChatMessageList density={density}>- <XDSChatMessage sender="user">- <XDSChatMessageBubble>- How does density work?- </XDSChatMessageBubble>- </XDSChatMessage>- <XDSChatMessage- sender="assistant"- avatar={<XDSAvatar name="Agent" size={AVATAR_SIZE[density]} />}>- <XDSChatMessageBubble>- Density controls spacing at every level — gap between- messages, padding inside bubbles, and gap between child- elements.- </XDSChatMessageBubble>- </XDSChatMessage>- </XDSChatMessageList>+ <XDSVStack gap={4} style={{maxWidth: 500}}>+ {DENSITIES.map((density, index) => (+ <Fragment key={density}>+ {index > 0 && <XDSDivider />}+ <XDSVStack gap={2}>+ <XDSText type="supporting" color="secondary">+ {density.charAt(0).toUpperCase() + density.slice(1)}+ </XDSText>+ <XDSVStack xstyle={styles.section}>+ <XDSChatMessageList density={density}>+ <XDSChatMessage sender="user">+ <XDSChatMessageBubble>+ How does density work?+ </XDSChatMessageBubble>+ </XDSChatMessage>+ <XDSChatMessage+ sender="assistant"+ avatar={+ <XDSAvatar name="Agent" size={AVATAR_SIZE[density]} />+ }>+ <XDSChatMessageBubble>+ Density controls spacing at every level — gap between+ messages, padding inside bubbles, and gap between child+ elements.+ </XDSChatMessageBubble>+ </XDSChatMessage>+ </XDSChatMessageList>+ </XDSVStack></XDSVStack>- </XDSVStack>+ </Fragment>))}</XDSVStack>);diff --git a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListFullFeatured.tsx b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListFullFeatured.tsxindex 5922012c2f..49b76c13e8 100644--- a/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListFullFeatured.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageList/ChatMessageListFullFeatured.tsx@@ -17,7 +17,7 @@ import * as stylex from '@stylexjs/stylex';const styles = stylex.create({container: {- maxWidth: 600,+ maxWidth: 500,justifyContent: 'center',},});@@ -54,7 +54,21 @@ export default function ChatMessageListFullFeatured() {{`Sure! Here's the key pattern from **useReducer.ts**:`}</XDSMarkdown></XDSChatMessageBubble>- <XDSChatMessageBubble variant="ghost" group="middle">+ <XDSChatMessageBubble group="last">+ <XDSMarkdown density="compact">+ {`The reducer is **pure and easy to test** — pass in state and action, assert on the output.`}+ </XDSMarkdown>+ </XDSChatMessageBubble>+ <XDSChatMessageBubble+ variant="ghost"+ group="middle"+ metadata={+ <XDSChatMessageMetadata+ timestamp={+ <XDSTimestamp value="2026-03-15T14:30:30" format="time" />+ }+ />+ }><XDSCodeBlockcode={`const [state, dispatch] = useReducer((state, action) => ({@@ -66,19 +80,6 @@ export default function ChatMessageListFullFeatured() {language="tsx"/></XDSChatMessageBubble>- <XDSChatMessageBubble- group="last"- metadata={- <XDSChatMessageMetadata- timestamp={- <XDSTimestamp value="2026-03-15T14:30:30" format="time" />- }- />- }>- <XDSMarkdown density="compact">- {`The reducer is **pure and easy to test** — pass in state and action, assert on the output.`}- </XDSMarkdown>- </XDSChatMessageBubble></XDSChatMessage><XDSChatSystemMessage>Agent shared a code snippet</XDSChatSystemMessage>diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.tsxindex 705afccbad..e93a88520f 100644--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataFooter.tsx@@ -20,7 +20,7 @@ import {export default function ChatMessageMetadataFooter() {return (- <XDSChatMessageList>+ <XDSChatMessageList style={{maxWidth: 500}}><XDSChatMessage sender="user"><XDSChatMessageBubblemetadata={diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsxindex b2b81fa98b..f3fca61100 100644--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsx@@ -18,7 +18,7 @@ const STATUSES = [export default function ChatMessageMetadataStatus() {return (- <XDSChatMessageList>+ <XDSChatMessageList style={{maxWidth: 400}}>{STATUSES.map(({status, text}) => (<XDSChatMessage key={status} sender="user"><XDSChatMessageBubblediff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsxindex b47ddf2a54..28e7f27fdb 100644--- a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsx+++ b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsx@@ -10,7 +10,7 @@ import {XDSTimestamp} from '@xds/core/Timestamp';export default function ChatMessageMetadataTimestamp() {return (- <XDSChatMessageList>+ <XDSChatMessageList style={{maxWidth: 500}}><XDSChatMessage sender="user"><XDSChatMessageBubblemetadata={