An open source design system that's fully customizable and agent ready
TypeScript
feat(templates): add showcase blocks for layout and structure sub-components (#1740)
Cindy Zhangd3f116a44faf
diff --git a/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjsnew file mode 100644index 0000000000..ee06618a95--- /dev/null+++ b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'AvatarStatusDot',+ description:+ 'AvatarStatusDot renders a presence indicator on an Avatar, with variants for positive, neutral, and negative states. The dot size automatically coordinates with the Avatar size.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Avatar', 'AvatarStatusDot'],+};diff --git a/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.tsx b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.tsxnew file mode 100644index 0000000000..8a12bd95d3--- /dev/null+++ b/packages/cli/templates/blocks/components/AvatarStatusDot/AvatarStatusDotShowcase.tsx@@ -0,0 +1,26 @@+'use client';++import {XDSAvatar, XDSAvatarStatusDot} from '@xds/core/Avatar';+import {XDSHStack} from '@xds/core/Layout';++export default function AvatarStatusDotShowcase() {+ return (+ <XDSHStack gap={4} vAlign="center">+ <XDSAvatar+ name="Online User"+ size="large"+ status={<XDSAvatarStatusDot variant="positive" label="Online" />}+ />+ <XDSAvatar+ name="Away User"+ size="large"+ status={<XDSAvatarStatusDot variant="neutral" label="Away" />}+ />+ <XDSAvatar+ name="Busy User"+ size="large"+ status={<XDSAvatarStatusDot variant="negative" label="Busy" />}+ />+ </XDSHStack>+ );+}diff --git a/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjsnew file mode 100644index 0000000000..f3b0dccc1e--- /dev/null+++ b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'BreadcrumbItem',+ description:+ 'BreadcrumbItem represents a single step in a breadcrumb trail, supporting links, icons, current-page markers, and custom link components.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Breadcrumbs', 'BreadcrumbItem'],+};diff --git a/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.tsx b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.tsxnew file mode 100644index 0000000000..cb4f96fe38--- /dev/null+++ b/packages/cli/templates/blocks/components/BreadcrumbItem/BreadcrumbItemShowcase.tsx@@ -0,0 +1,76 @@+'use client';++import type {ComponentProps} from 'react';+import {XDSBreadcrumbs, XDSBreadcrumbItem} from '@xds/core/Breadcrumbs';+import {XDSVStack} from '@xds/core/Layout';+import {XDSText} from '@xds/core/Text';++function HomeIcon(props: ComponentProps<'svg'>) {+ return (+ <svg+ fill="none"+ viewBox="0 0 24 24"+ strokeWidth={2}+ stroke="currentColor"+ {...props}>+ <path+ strokeLinecap="round"+ strokeLinejoin="round"+ d="M3 9.5L12 3l9 6.5V20a1 1 0 01-1 1H4a1 1 0 01-1-1V9.5z"+ />+ </svg>+ );+}++export default function BreadcrumbItemShowcase() {+ return (+ <XDSVStack gap={4}>+ <XDSVStack gap={1}>+ <XDSText type="supporting" color="secondary">+ With start icon+ </XDSText>+ <XDSBreadcrumbs>+ <XDSBreadcrumbItem href="/" startIcon={<HomeIcon />}>+ Home+ </XDSBreadcrumbItem>+ <XDSBreadcrumbItem href="/docs">Docs</XDSBreadcrumbItem>+ <XDSBreadcrumbItem isCurrent>Components</XDSBreadcrumbItem>+ </XDSBreadcrumbs>+ </XDSVStack>++ <XDSVStack gap={1}>+ <XDSText type="supporting" color="secondary">+ As current page (non-link)+ </XDSText>+ <XDSBreadcrumbs>+ <XDSBreadcrumbItem href="/">Home</XDSBreadcrumbItem>+ <XDSBreadcrumbItem href="/settings">Settings</XDSBreadcrumbItem>+ <XDSBreadcrumbItem isCurrent>Profile</XDSBreadcrumbItem>+ </XDSBreadcrumbs>+ </XDSVStack>++ <XDSVStack gap={1}>+ <XDSText type="supporting" color="secondary">+ Supporting variant+ </XDSText>+ <XDSBreadcrumbs variant="supporting">+ <XDSBreadcrumbItem href="/">Home</XDSBreadcrumbItem>+ <XDSBreadcrumbItem href="/admin">Admin</XDSBreadcrumbItem>+ <XDSBreadcrumbItem href="/admin/users">Users</XDSBreadcrumbItem>+ <XDSBreadcrumbItem isCurrent>Permissions</XDSBreadcrumbItem>+ </XDSBreadcrumbs>+ </XDSVStack>++ <XDSVStack gap={1}>+ <XDSText type="supporting" color="secondary">+ With onClick handler (no href)+ </XDSText>+ <XDSBreadcrumbs>+ <XDSBreadcrumbItem onClick={() => {}}>Dashboard</XDSBreadcrumbItem>+ <XDSBreadcrumbItem onClick={() => {}}>Projects</XDSBreadcrumbItem>+ <XDSBreadcrumbItem isCurrent>Project Alpha</XDSBreadcrumbItem>+ </XDSBreadcrumbs>+ </XDSVStack>+ </XDSVStack>+ );+}diff --git a/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjsnew file mode 100644index 0000000000..041a94c9f3--- /dev/null+++ b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'CollapsibleGroup',+ description:+ 'CollapsibleGroup coordinates multiple Collapsible components so that expanding one can automatically collapse the others, creating accordion behavior.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Collapsible', 'CollapsibleGroup'],+};diff --git a/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.tsx b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.tsxnew file mode 100644index 0000000000..9cbf73b3cf--- /dev/null+++ b/packages/cli/templates/blocks/components/CollapsibleGroup/CollapsibleGroupShowcase.tsx@@ -0,0 +1,41 @@+'use client';++import {XDSCollapsible, XDSCollapsibleGroup} from '@xds/core/Collapsible';+import {XDSCard} from '@xds/core/Card';+import {XDSVStack} from '@xds/core/Layout';+import {XDSCenter} from '@xds/core/Center';+import {XDSText} from '@xds/core/Text';++export default function CollapsibleGroupShowcase() {+ return (+ <XDSCenter width={400}>+ <XDSCollapsibleGroup type="single" defaultValue="shipping">+ <XDSVStack gap={2} width="100%">+ <XDSCard>+ <XDSCollapsible trigger="Shipping Information" value="shipping">+ <XDSText type="body" color="secondary">+ Standard shipping takes 3–5 business days. Express shipping is+ available for an additional fee.+ </XDSText>+ </XDSCollapsible>+ </XDSCard>+ <XDSCard>+ <XDSCollapsible trigger="Return Policy" value="returns">+ <XDSText type="body" color="secondary">+ Items can be returned within 30 days of purchase. Items must be+ unused and in original packaging.+ </XDSText>+ </XDSCollapsible>+ </XDSCard>+ <XDSCard>+ <XDSCollapsible trigger="Payment Methods" value="payment">+ <XDSText type="body" color="secondary">+ We accept all major credit cards, PayPal, and bank transfers.+ </XDSText>+ </XDSCollapsible>+ </XDSCard>+ </XDSVStack>+ </XDSCollapsibleGroup>+ </XDSCenter>+ );+}diff --git a/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjsnew file mode 100644index 0000000000..35dd347a03--- /dev/null+++ b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'DialogHeader',+ description:+ 'DialogHeader provides a structured header for dialogs with slots for title, subtitle, close button, and optional start or end content.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Dialog', 'DialogHeader'],+};diff --git a/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.tsx b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.tsxnew file mode 100644index 0000000000..92c90ed8fe--- /dev/null+++ b/packages/cli/templates/blocks/components/DialogHeader/DialogHeaderShowcase.tsx@@ -0,0 +1,30 @@+'use client';++import {XDSDialog, XDSDialogHeader} from '@xds/core/Dialog';+import {XDSLayout, XDSLayoutContent, XDSCard} from '@xds/core/Layout';+import {XDSText} from '@xds/core/Text';++export default function DialogHeaderShowcase() {+ return (+ <XDSDialog isOpen isInline onOpenChange={() => {}}>+ <XDSLayout+ header={+ <XDSDialogHeader+ title="Edit Profile"+ subtitle="Update your personal information"+ onOpenChange={() => {}}+ />+ }+ content={+ <XDSLayoutContent>+ <XDSCard variant="muted">+ <XDSText type="body" color="secondary">+ Dialog body content goes here.+ </XDSText>+ </XDSCard>+ </XDSLayoutContent>+ }+ />+ </XDSDialog>+ );+}diff --git a/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjsnew file mode 100644index 0000000000..24b7e84287--- /dev/null+++ b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'GridSpan',+ description:+ 'GridSpan lets a grid item span multiple columns or rows within an XDSGrid, enabling masonry-style and asymmetric layouts.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Grid', 'GridSpan'],+};diff --git a/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.tsx b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.tsxnew file mode 100644index 0000000000..7abcd6f2e7--- /dev/null+++ b/packages/cli/templates/blocks/components/GridSpan/GridSpanShowcase.tsx@@ -0,0 +1,43 @@+'use client';++import {XDSGrid, XDSGridSpan} from '@xds/core/Grid';+import {XDSCard} from '@xds/core/Card';+import {XDSText} from '@xds/core/Text';++export default function GridSpanShowcase() {+ return (+ <XDSGrid columns={3} gap={3}>+ <XDSGridSpan columns={2}>+ <XDSCard variant="muted" padding={4} height={80}>+ <XDSText type="body" color="secondary">+ Spans 2 columns+ </XDSText>+ </XDSCard>+ </XDSGridSpan>+ <XDSCard variant="muted" padding={4} height={80}>+ <XDSText type="body" color="secondary">+ 1 col+ </XDSText>+ </XDSCard>+ <XDSCard variant="muted" padding={4} height={60}>+ <XDSText type="body" color="secondary">+ 1 col+ </XDSText>+ </XDSCard>+ <XDSGridSpan columns={2}>+ <XDSCard variant="muted" padding={4} height={60}>+ <XDSText type="body" color="secondary">+ Spans 2 columns+ </XDSText>+ </XDSCard>+ </XDSGridSpan>+ <XDSGridSpan columns="full">+ <XDSCard variant="muted" padding={4} height={60}>+ <XDSText type="body" color="secondary">+ Full-width row+ </XDSText>+ </XDSCard>+ </XDSGridSpan>+ </XDSGrid>+ );+}diff --git a/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjsnew file mode 100644index 0000000000..364ebc41ee--- /dev/null+++ b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'LayoutContent',+ description:+ 'LayoutContent is the scrollable main content area within a Layout, providing automatic padding and scroll containment between the header and footer.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Layout', 'LayoutContent'],+};diff --git a/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.tsx b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.tsxnew file mode 100644index 0000000000..da80254863--- /dev/null+++ b/packages/cli/templates/blocks/components/LayoutContent/LayoutContentShowcase.tsx@@ -0,0 +1,53 @@+'use client';++import {+ XDSLayout,+ XDSLayoutContent,+ XDSLayoutHeader,+ XDSLayoutFooter,+ XDSLayoutPanel,+ XDSCard,+ XDSVStack,+} from '@xds/core/Layout';+import {XDSCenter} from '@xds/core/Center';+import {XDSText, XDSHeading} from '@xds/core/Text';++export default function LayoutContentShowcase() {+ return (+ <XDSCenter width={600}>+ <XDSLayout+ height="fill"+ header={+ <XDSLayoutHeader hasDivider>+ <XDSCard variant="muted" />+ </XDSLayoutHeader>+ }+ start={+ <XDSLayoutPanel hasDivider width={140}>+ <XDSCard variant="muted" />+ </XDSLayoutPanel>+ }+ content={+ <XDSLayoutContent role="main">+ <XDSVStack gap={3}>+ <XDSHeading level={5}>Main Content Area</XDSHeading>+ <XDSText type="body" color="secondary">+ LayoutContent provides automatic padding and scroll containment.+ It fills the remaining space between the header and footer.+ </XDSText>+ <XDSText type="body" color="secondary">+ Content that overflows will scroll within this area while the+ header and footer remain fixed.+ </XDSText>+ </XDSVStack>+ </XDSLayoutContent>+ }+ footer={+ <XDSLayoutFooter hasDivider>+ <XDSCard variant="muted" />+ </XDSLayoutFooter>+ }+ />+ </XDSCenter>+ );+}diff --git a/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjsnew file mode 100644index 0000000000..9c34e389bf--- /dev/null+++ b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'LayoutFooter',+ description:+ 'LayoutFooter is a fixed footer slot within a Layout, pinned to the bottom for persistent actions like form buttons or navigation.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Layout', 'LayoutFooter'],+};diff --git a/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.tsx b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.tsxnew file mode 100644index 0000000000..55f3f47c46--- /dev/null+++ b/packages/cli/templates/blocks/components/LayoutFooter/LayoutFooterShowcase.tsx@@ -0,0 +1,50 @@+'use client';++import {+ XDSLayout,+ XDSLayoutContent,+ XDSLayoutHeader,+ XDSLayoutFooter,+ XDSLayoutPanel,+ XDSCard,+ XDSHStack,+} from '@xds/core/Layout';+import {XDSCenter} from '@xds/core/Center';+import {XDSButton} from '@xds/core/Button';++export default function LayoutFooterShowcase() {+ return (+ <XDSCenter width={600}>+ <XDSLayout+ height="fill"+ header={+ <XDSLayoutHeader hasDivider>+ <XDSCard variant="muted" />+ </XDSLayoutHeader>+ }+ start={+ <XDSLayoutPanel hasDivider width={140}>+ <XDSCard variant="muted" />+ </XDSLayoutPanel>+ }+ content={+ <XDSLayoutContent>+ <XDSCard variant="muted" />+ </XDSLayoutContent>+ }+ footer={+ <XDSLayoutFooter hasDivider>+ <XDSHStack gap={2} hAlign="end">+ <XDSButton label="Cancel" variant="secondary">+ Cancel+ </XDSButton>+ <XDSButton label="Save" variant="primary">+ Save+ </XDSButton>+ </XDSHStack>+ </XDSLayoutFooter>+ }+ />+ </XDSCenter>+ );+}diff --git a/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjsnew file mode 100644index 0000000000..a40713866e--- /dev/null+++ b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'LayoutHeader',+ description:+ 'LayoutHeader is a fixed header slot within a Layout, pinned to the top for titles, navigation, and action buttons.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Layout', 'LayoutHeader'],+};diff --git a/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.tsx b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.tsxnew file mode 100644index 0000000000..4bc5d2cd29--- /dev/null+++ b/packages/cli/templates/blocks/components/LayoutHeader/LayoutHeaderShowcase.tsx@@ -0,0 +1,54 @@+'use client';++import {+ XDSLayout,+ XDSLayoutHeader,+ XDSLayoutContent,+ XDSLayoutFooter,+ XDSLayoutPanel,+ XDSCard,+ XDSHStack,+} from '@xds/core/Layout';+import {XDSCenter} from '@xds/core/Center';+import {XDSHeading} from '@xds/core/Text';+import {XDSButton} from '@xds/core/Button';++export default function LayoutHeaderShowcase() {+ return (+ <XDSCenter width={600}>+ <XDSLayout+ height="fill"+ header={+ <XDSLayoutHeader hasDivider>+ <XDSHStack gap={2} vAlign="center" hAlign="between">+ <XDSHeading level={4}>Dashboard</XDSHeading>+ <XDSHStack gap={2}>+ <XDSButton label="Export" variant="secondary">+ Export+ </XDSButton>+ <XDSButton label="New Item" variant="primary">+ New Item+ </XDSButton>+ </XDSHStack>+ </XDSHStack>+ </XDSLayoutHeader>+ }+ start={+ <XDSLayoutPanel hasDivider width={140}>+ <XDSCard variant="muted" />+ </XDSLayoutPanel>+ }+ content={+ <XDSLayoutContent>+ <XDSCard variant="muted" />+ </XDSLayoutContent>+ }+ footer={+ <XDSLayoutFooter hasDivider>+ <XDSCard variant="muted" />+ </XDSLayoutFooter>+ }+ />+ </XDSCenter>+ );+}diff --git a/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjsnew file mode 100644index 0000000000..befbfb7ece--- /dev/null+++ b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'LayoutPanel',+ description:+ 'LayoutPanel is a sidebar slot within a Layout, used for navigation, detail views, or secondary content alongside the main content area.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Layout', 'LayoutPanel'],+};diff --git a/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.tsx b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.tsxnew file mode 100644index 0000000000..f89110d6ee--- /dev/null+++ b/packages/cli/templates/blocks/components/LayoutPanel/LayoutPanelShowcase.tsx@@ -0,0 +1,47 @@+'use client';++import {+ XDSLayout,+ XDSLayoutPanel,+ XDSLayoutContent,+ XDSLayoutHeader,+ XDSLayoutFooter,+ XDSCard,+} from '@xds/core/Layout';+import {XDSCenter} from '@xds/core/Center';+import {XDSList, XDSListItem} from '@xds/core/List';++export default function LayoutPanelShowcase() {+ return (+ <XDSCenter width={600}>+ <XDSLayout+ height="fill"+ header={+ <XDSLayoutHeader hasDivider>+ <XDSCard variant="muted" />+ </XDSLayoutHeader>+ }+ start={+ <XDSLayoutPanel hasDivider width={140} role="navigation">+ <XDSList>+ <XDSListItem label="Overview" isSelected />+ <XDSListItem label="Analytics" />+ <XDSListItem label="Reports" />+ <XDSListItem label="Settings" />+ </XDSList>+ </XDSLayoutPanel>+ }+ content={+ <XDSLayoutContent>+ <XDSCard variant="muted" />+ </XDSLayoutContent>+ }+ footer={+ <XDSLayoutFooter hasDivider>+ <XDSCard variant="muted" />+ </XDSLayoutFooter>+ }+ />+ </XDSCenter>+ );+}diff --git a/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjsnew file mode 100644index 0000000000..86ec7140c5--- /dev/null+++ b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'StackItem',+ description:+ 'StackItem can be used within XDSHStack or XDSVStack for more granular control over individual item sizing and alignment, but is optional — stack children work without it.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['Stack', 'StackItem'],+};diff --git a/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.tsx b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.tsxnew file mode 100644index 0000000000..898208640d--- /dev/null+++ b/packages/cli/templates/blocks/components/StackItem/StackItemShowcase.tsx@@ -0,0 +1,33 @@+'use client';++import {XDSHStack, XDSStackItem} from '@xds/core/Layout';+import {XDSCard} from '@xds/core/Card';+import {XDSText} from '@xds/core/Text';++export default function StackItemShowcase() {+ return (+ <XDSHStack gap={3} vAlign="center">+ <XDSStackItem size="static">+ <XDSCard variant="muted" padding={3}>+ <XDSText type="supporting" color="secondary">+ Static+ </XDSText>+ </XDSCard>+ </XDSStackItem>+ <XDSStackItem size="fill">+ <XDSCard variant="muted" padding={3}>+ <XDSText type="supporting" color="secondary">+ Fills remaining space+ </XDSText>+ </XDSCard>+ </XDSStackItem>+ <XDSStackItem size="static">+ <XDSCard variant="muted" padding={3}>+ <XDSText type="supporting" color="secondary">+ Static+ </XDSText>+ </XDSCard>+ </XDSStackItem>+ </XDSHStack>+ );+}diff --git a/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs b/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjsnew file mode 100644index 0000000000..504dc11327--- /dev/null+++ b/packages/cli/templates/blocks/components/Tab/TabShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'Tab',+ description:+ 'Tab is an individual tab item within a TabList, supporting labels, icons, selected icons, and end content slots.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['TabList', 'Tab'],+};diff --git a/packages/cli/templates/blocks/components/Tab/TabShowcase.tsx b/packages/cli/templates/blocks/components/Tab/TabShowcase.tsxnew file mode 100644index 0000000000..d4a8c03102--- /dev/null+++ b/packages/cli/templates/blocks/components/Tab/TabShowcase.tsx@@ -0,0 +1,16 @@+'use client';++import {XDSTabList, XDSTab} from '@xds/core/TabList';+import {XDSBadge} from '@xds/core/Badge';++export default function TabShowcase() {+ return (+ <XDSTabList value="inbox" onChange={() => {}}>+ <XDSTab+ value="inbox"+ label="Inbox"+ endContent={<XDSBadge label="3" variant="info" />}+ />+ </XDSTabList>+ );+}diff --git a/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjsnew file mode 100644index 0000000000..e9229edbb6--- /dev/null+++ b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'TabMenu',+ description:+ 'TabMenu is an overflow menu within a TabList that groups additional tab options into a dropdown, showing the selected option\'s label as the trigger text.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['TabList', 'Tab', 'TabMenu'],+};diff --git a/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.tsx b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.tsxnew file mode 100644index 0000000000..695cfea137--- /dev/null+++ b/packages/cli/templates/blocks/components/TabMenu/TabMenuShowcase.tsx@@ -0,0 +1,20 @@+'use client';++import {XDSTabList, XDSTab, XDSTabMenu} from '@xds/core/TabList';++export default function TabMenuShowcase() {+ return (+ <XDSTabList value="settings" onChange={() => {}}>+ <XDSTab value="overview" label="Overview" />+ <XDSTab value="activity" label="Activity" />+ <XDSTabMenu+ label="More"+ options={[+ {value: 'settings', label: 'Settings'},+ {value: 'integrations', label: 'Integrations'},+ {value: 'billing', label: 'Billing'},+ ]}+ />+ </XDSTabList>+ );+}diff --git a/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjsnew file mode 100644index 0000000000..61e5836b4d--- /dev/null+++ b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.doc.mjs@@ -0,0 +1,11 @@+/** @type {import('../../../../../core/src/docs-types').TemplateDoc} */+export const doc = {+ type: 'block',+ name: 'ToggleButtonGroup',+ description:+ 'ToggleButtonGroup manages a set of ToggleButtons with single-select or multi-select behavior for options like view modes or filters.',+ isReady: true,+ isShowcase: true,+ aspectRatio: 16 / 9,+ componentsUsed: ['ToggleButton', 'ToggleButtonGroup'],+};diff --git a/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.tsx b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.tsxnew file mode 100644index 0000000000..f74112cb2f--- /dev/null+++ b/packages/cli/templates/blocks/components/ToggleButtonGroup/ToggleButtonGroupShowcase.tsx@@ -0,0 +1,43 @@+'use client';++import {useState} from 'react';+import {+ XDSToggleButton,+ XDSToggleButtonGroup,+} from '@xds/core/ToggleButton';+import {XDSVStack} from '@xds/core/Layout';+import {XDSText} from '@xds/core/Text';++export default function ToggleButtonGroupShowcase() {+ const [view, setView] = useState<string | null>('grid');+ const [filters, setFilters] = useState<string[]>(['active']);++ return (+ <XDSVStack gap={4}>+ <XDSVStack gap={1}>+ <XDSText type="label" color="secondary">+ Single select+ </XDSText>+ <XDSToggleButtonGroup value={view} onChange={setView} label="View mode">+ <XDSToggleButton value="list" label="List" />+ <XDSToggleButton value="grid" label="Grid" />+ <XDSToggleButton value="board" label="Board" />+ </XDSToggleButtonGroup>+ </XDSVStack>+ <XDSVStack gap={1}>+ <XDSText type="label" color="secondary">+ Multi select+ </XDSText>+ <XDSToggleButtonGroup+ type="multiple"+ value={filters}+ onChange={setFilters}+ label="Status filters">+ <XDSToggleButton value="active" label="Active" />+ <XDSToggleButton value="pending" label="Pending" />+ <XDSToggleButton value="closed" label="Closed" />+ </XDSToggleButtonGroup>+ </XDSVStack>+ </XDSVStack>+ );+}