Skip to content

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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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={
<XDSChatMessageMetadata
timestamp={
@@ -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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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" />
+ }
+ />
+ }>
<XDSCodeBlock
code={`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.tsx
index 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">
<XDSChatMessageBubble
metadata={
diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataStatus.tsx
index 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">
<XDSChatMessageBubble
diff --git a/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsx b/packages/cli/templates/blocks/components/ChatMessageMetadata/ChatMessageMetadataTimestamp.tsx
index 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">
<XDSChatMessageBubble
metadata={