An open source design system that's fully customizable and agent ready
TypeScript
feat(sandbox): add Table Overview page template (#353)
rubyycheung1badb41b389c
diff --git a/apps/sandbox/src/app/Sidebar.tsx b/apps/sandbox/src/app/Sidebar.tsxindex 93b302bc3b..9a0ce40077 100644--- a/apps/sandbox/src/app/Sidebar.tsx+++ b/apps/sandbox/src/app/Sidebar.tsx@@ -23,6 +23,7 @@ const pages = [{name: 'TopNav Menu', href: '/pages/topnav-menu/'},{name: 'Mega Menu', href: '/pages/mega-menu/'},{name: 'Polymorphic Link', href: '/pages/polymorphic-link/'},+ {name: 'Table Overview', href: '/pages/table-overview/'},];const styles = stylex.create({diff --git a/apps/sandbox/src/app/pages/polymorphic-link/page.tsx b/apps/sandbox/src/app/pages/polymorphic-link/page.tsxindex e6a42022e4..f5cb64093f 100644--- a/apps/sandbox/src/app/pages/polymorphic-link/page.tsx+++ b/apps/sandbox/src/app/pages/polymorphic-link/page.tsx@@ -67,7 +67,7 @@ const SimulatedNextLink = forwardRef<href={href}onClick={e => {e.preventDefault();-+console.log(`[SimulatedNextLink] Client-side navigate to: ${href}`);onClick?.(e);}}@@ -92,7 +92,7 @@ const GreenLink = forwardRef<href={href}onClick={e => {e.preventDefault();-+console.log(`[GreenLink] Navigate to: ${href}`);onClick?.(e);}}@@ -196,7 +196,7 @@ export default function PolymorphicLinkPage() {XDSSideNav</XDSText><div {...stylex.props(styles.sidenavWrapper)}>- <XDSSideNav label="Provider sidenav">+ <XDSSideNav aria-label="Provider sidenav"><XDSSideNavItemlabel="Dashboard"href="/dashboard"diff --git a/apps/sandbox/src/app/pages/table-overview/page.tsx b/apps/sandbox/src/app/pages/table-overview/page.tsxnew file mode 100644index 0000000000..ee6fb01100--- /dev/null+++ b/apps/sandbox/src/app/pages/table-overview/page.tsx@@ -0,0 +1,515 @@+'use client';++import {useState, useMemo} from 'react';+import * as stylex from '@stylexjs/stylex';+import {XDSVStack, XDSHStack} from '@xds/core/Layout';+import {XDSText, XDSHeading} from '@xds/core/Text';+import {XDSTextInput} from '@xds/core/TextInput';+import {XDSCard} from '@xds/core/Card';+import {+ XDSTable,+ useXDSTableSelection,+ proportional,+ pixel,+} from '@xds/core/Table';+import type {XDSTableColumn} from '@xds/core/Table';+import {XDSAvatar} from '@xds/core/Avatar';+import {XDSBadge} from '@xds/core/Badge';+import type {XDSBadgeVariant} from '@xds/core/Badge';+import {XDSStatusDot} from '@xds/core/StatusDot';+import {XDSCollapsible} from '@xds/core/Collapsible';++// =============================================================================+// Types+// =============================================================================++interface ReviewRow extends Record<string, unknown> {+ id: string;+ title: string;+ diffId: string;+ lines: number;+ reviewTime: string;+ authorName: string;+ authorAvatar: string;+ reviewerAvatars: string[];+ testStatus: 'passed' | 'failed';+ created: string;+ status: 'Needs review' | 'Waiting on author' | 'Changes planned' | 'Accepted';+}++// =============================================================================+// Mock Data+// =============================================================================++const waitingForAWhile: ReviewRow[] = [+ {+ id: '1',+ title: '[xds][XDSCommonFilterTokenList]: Promote out of beta',+ diffId: 'D93462457',+ lines: 3,+ reviewTime: '<20sec review',+ authorName: 'Alice Chen',+ authorAvatar: 'https://i.pravatar.cc/36?img=1',+ reviewerAvatars: [+ 'https://i.pravatar.cc/36?img=5',+ 'https://i.pravatar.cc/36?img=6',+ ],+ testStatus: 'passed',+ created: 'Feb 24, 2025',+ status: 'Waiting on author',+ },+ {+ id: '2',+ title: '[xds][Table] Fix column resize regression on Safari',+ diffId: 'D93471823',+ lines: 47,+ reviewTime: '~3min review',+ authorName: 'Bob Martinez',+ authorAvatar: 'https://i.pravatar.cc/36?img=2',+ reviewerAvatars: ['https://i.pravatar.cc/36?img=7'],+ testStatus: 'failed',+ created: 'Feb 23, 2025',+ status: 'Changes planned',+ },+];++const needsCodeReview: ReviewRow[] = [+ {+ id: '3',+ title: '[xds][Avatar] Add XDSAvatarStatusDot size scaling',+ diffId: 'D93502119',+ lines: 128,+ reviewTime: '~8min review',+ authorName: 'Carol Wu',+ authorAvatar: 'https://i.pravatar.cc/36?img=3',+ reviewerAvatars: [+ 'https://i.pravatar.cc/36?img=8',+ 'https://i.pravatar.cc/36?img=9',+ 'https://i.pravatar.cc/36?img=10',+ ],+ testStatus: 'passed',+ created: '19 hours ago',+ status: 'Needs review',+ },+ {+ id: '4',+ title: '[xds][Badge] Introduce error variant with icon slot',+ diffId: 'D93508734',+ lines: 52,+ reviewTime: '~2min review',+ authorName: 'Dan Kim',+ authorAvatar: 'https://i.pravatar.cc/36?img=4',+ reviewerAvatars: ['https://i.pravatar.cc/36?img=11'],+ testStatus: 'passed',+ created: '14 hours ago',+ status: 'Needs review',+ },+ {+ id: '5',+ title: '[xds][Collapsible] Animate height transitions with CSS',+ diffId: 'D93510092',+ lines: 210,+ reviewTime: '~12min review',+ authorName: 'Eve Patel',+ authorAvatar: 'https://i.pravatar.cc/36?img=12',+ reviewerAvatars: [+ 'https://i.pravatar.cc/36?img=5',+ 'https://i.pravatar.cc/36?img=13',+ ],+ testStatus: 'passed',+ created: '8 hours ago',+ status: 'Needs review',+ },+ {+ id: '6',+ title: '[xds][TextInput] Add clearable prop with trailing icon',+ diffId: 'D93511456',+ lines: 34,+ reviewTime: '<1min review',+ authorName: 'Frank Lee',+ authorAvatar: 'https://i.pravatar.cc/36?img=14',+ reviewerAvatars: ['https://i.pravatar.cc/36?img=6'],+ testStatus: 'failed',+ created: '5 hours ago',+ status: 'Needs review',+ },+ {+ id: '7',+ title: '[xds][Layout] Support sticky header in XDSLayoutHeader',+ diffId: 'D93512890',+ lines: 89,+ reviewTime: '~5min review',+ authorName: 'Grace Tan',+ authorAvatar: 'https://i.pravatar.cc/36?img=15',+ reviewerAvatars: [+ 'https://i.pravatar.cc/36?img=7',+ 'https://i.pravatar.cc/36?img=8',+ ],+ testStatus: 'passed',+ created: '2 hours ago',+ status: 'Needs review',+ },+];++const acceptedAndReady: ReviewRow[] = [+ {+ id: '8',+ title: '[xds][StatusDot] Add isPulsing animation support',+ diffId: 'D93489001',+ lines: 22,+ reviewTime: '<30sec review',+ authorName: 'Hank Zhou',+ authorAvatar: 'https://i.pravatar.cc/36?img=9',+ reviewerAvatars: [+ 'https://i.pravatar.cc/36?img=1',+ 'https://i.pravatar.cc/36?img=2',+ ],+ testStatus: 'passed',+ created: 'Feb 25, 2025',+ status: 'Accepted',+ },+ {+ id: '9',+ title: '[xds][Card] Add isFullBleed prop for edge-to-edge content',+ diffId: 'D93495233',+ lines: 15,+ reviewTime: '<20sec review',+ authorName: 'Iris Nakamura',+ authorAvatar: 'https://i.pravatar.cc/36?img=10',+ reviewerAvatars: ['https://i.pravatar.cc/36?img=3'],+ testStatus: 'passed',+ created: 'Feb 26, 2025',+ status: 'Accepted',+ },+];++// =============================================================================+// Helpers+// =============================================================================++const STATUS_VARIANT_MAP: Record<ReviewRow['status'], XDSBadgeVariant> = {+ 'Needs review': 'info',+ 'Waiting on author': 'warning',+ 'Changes planned': 'warning',+ Accepted: 'success',+};++// =============================================================================+// Stat Card+// =============================================================================++function StatCard({+ label,+ value,+ emoji,+}: {+ label: string;+ value: string | number;+ emoji?: string;+}) {+ return (+ <XDSCard>+ <div {...stylex.props(styles.statCard)}>+ <XDSText type="supporting" color="secondary">+ {emoji ? `${emoji} ` : ''}+ {label}+ </XDSText>+ <XDSText type="large" weight="bold">+ {String(value)}+ </XDSText>+ </div>+ </XDSCard>+ );+}++// =============================================================================+// Columns (defined outside component for stable identity)+// =============================================================================++const columns: XDSTableColumn<ReviewRow>[] = [+ {+ key: 'author',+ header: 'Author',+ width: proportional(4),+ renderCell: (item: ReviewRow) => (+ <XDSHStack gap="space3" vAlign="center">+ <XDSAvatar+ src={item.authorAvatar}+ name={item.authorName}+ size="small"+ />+ <XDSVStack gap="space1">+ <span {...stylex.props(styles.titleLink)}>{item.title}</span>+ <XDSText type="supporting" color="secondary">+ {item.diffId} · {item.lines} lines {item.reviewTime}+ </XDSText>+ </XDSVStack>+ </XDSHStack>+ ),+ },+ {+ key: 'reviewers',+ header: 'Reviewers',+ width: pixel(120),+ renderCell: (item: ReviewRow) => (+ <div {...stylex.props(styles.avatarGroup)}>+ {item.reviewerAvatars.map((src: string, i: number) => (+ <div+ key={i}+ {...stylex.props(styles.avatarOverlap)}+ style={{+ marginLeft: i > 0 ? -8 : 0,+ zIndex: item.reviewerAvatars.length - i,+ }}>+ <XDSAvatar src={src} name={`Reviewer ${i + 1}`} size="xsmall" />+ </div>+ ))}+ </div>+ ),+ },+ {+ key: 'testing',+ header: 'Testing',+ width: pixel(110),+ renderCell: (item: ReviewRow) => (+ <XDSHStack gap="space2" vAlign="center">+ <XDSStatusDot+ variant={item.testStatus === 'passed' ? 'positive' : 'negative'}+ label={item.testStatus === 'passed' ? 'Passed' : 'Failed'}+ />+ <XDSText type="supporting">+ {item.testStatus === 'passed' ? 'Passed' : 'Failed'}+ </XDSText>+ </XDSHStack>+ ),+ },+ {+ key: 'created',+ header: 'Created',+ width: pixel(130),+ renderCell: (item: ReviewRow) => (+ <XDSText type="supporting" color="secondary">+ {item.created}+ </XDSText>+ ),+ },+ {+ key: 'status',+ header: 'Status',+ width: pixel(160),+ renderCell: (item: ReviewRow) => (+ <XDSBadge variant={STATUS_VARIANT_MAP[item.status]}>+ {item.status}+ </XDSBadge>+ ),+ },+];++// =============================================================================+// Styles+// =============================================================================++const styles = stylex.create({+ container: {+ maxWidth: 1100,+ width: '100%',+ },+ statCard: {+ display: 'flex',+ flexDirection: 'column',+ gap: 4,+ padding: '12px 16px',+ minWidth: 120,+ },+ statsRow: {+ display: 'flex',+ gap: 12,+ flexWrap: 'wrap',+ },+ titleLink: {+ color: '#1a73e8',+ fontWeight: 600,+ fontSize: '0.875rem',+ cursor: 'pointer',+ },+ avatarGroup: {+ display: 'flex',+ alignItems: 'center',+ },+ avatarOverlap: {+ position: 'relative',+ display: 'inline-flex',+ },+});++// =============================================================================+// Section Table (table within a collapsible)+// =============================================================================++function SectionTable({+ data,+ selectedKeys,+ setSelectedKeys,+}: {+ data: ReviewRow[];+ selectedKeys: Set<string>;+ setSelectedKeys: React.Dispatch<React.SetStateAction<Set<string>>>;+}) {+ const selectionPlugin = useXDSTableSelection<ReviewRow>({+ getIsItemSelected: (item: ReviewRow) => selectedKeys.has(item.id),+ onSelectItem: ({+ item,+ isSelected,+ }: {+ item: ReviewRow;+ isSelected: boolean;+ }) => {+ setSelectedKeys(prev => {+ const next = new Set(prev);+ if (isSelected) {+ next.add(item.id);+ } else {+ next.delete(item.id);+ }+ return next;+ });+ },+ onSelectAll: ({isAllSelected}: {isAllSelected: boolean}) => {+ setSelectedKeys(prev => {+ const next = new Set(prev);+ if (isAllSelected) {+ data.forEach(row => next.add(row.id));+ } else {+ data.forEach(row => next.delete(row.id));+ }+ return next;+ });+ },+ getIsAllSelected: () => data.every(row => selectedKeys.has(row.id)),+ getIsIndeterminate: () => {+ const count = data.filter(row => selectedKeys.has(row.id)).length;+ return count > 0 && count < data.length;+ },+ });++ const plugins = useMemo(+ () => ({selection: selectionPlugin}),+ [selectionPlugin],+ );++ return (+ <XDSTable<ReviewRow>+ data={data}+ columns={columns}+ idKey="id"+ density="balanced"+ dividers="rows"+ hasHover+ plugins={plugins}+ />+ );+}++// =============================================================================+// Page+// =============================================================================++export default function TableOverviewPage() {+ const [search, setSearch] = useState('');+ const [selectedKeys, setSelectedKeys] = useState<Set<string>>(new Set());++ const filterRows = (rows: ReviewRow[]) => {+ if (!search.trim()) return rows;+ const q = search.toLowerCase();+ return rows.filter(+ row =>+ row.title.toLowerCase().includes(q) ||+ row.authorName.toLowerCase().includes(q) ||+ row.diffId.toLowerCase().includes(q),+ );+ };++ const filteredWaiting = filterRows(waitingForAWhile);+ const filteredNeeds = filterRows(needsCodeReview);+ const filteredAccepted = filterRows(acceptedAndReady);++ return (+ <div {...stylex.props(styles.container)}>+ <XDSVStack gap="space6">+ <XDSVStack gap="space2">+ <XDSHeading level={1}>Table Overview</XDSHeading>+ <XDSText type="body" color="secondary">+ A code review dashboard demonstrating XDSTable with selection,+ badges, avatars, and collapsible sections.+ </XDSText>+ </XDSVStack>++ {/* Search */}+ <XDSTextInput+ label="Search"+ isLabelHidden+ placeholder="Search..."+ value={search}+ onChange={setSearch}+ />++ {/* Stats Row */}+ <div {...stylex.props(styles.statsRow)}>+ <StatCard emoji="🔥" label="Review streak" value="4 days" />+ <StatCard label="Reviews today" value={6} />+ <StatCard label="Diff reviews" value={28} />+ <StatCard label="Post-land reviews" value={3} />+ <StatCard label="Mobile reviews" value={2} />+ </div>++ {/* Grouped Tables */}+ <XDSVStack gap="space4">+ {filteredWaiting.length > 0 && (+ <XDSCollapsible+ trigger={+ <XDSText type="body" weight="bold">+ Waiting for a while ({filteredWaiting.length})+ </XDSText>+ }>+ <SectionTable+ data={filteredWaiting}+ selectedKeys={selectedKeys}+ setSelectedKeys={setSelectedKeys}+ />+ </XDSCollapsible>+ )}++ {filteredNeeds.length > 0 && (+ <XDSCollapsible+ trigger={+ <XDSText type="body" weight="bold">+ Needs code review ({filteredNeeds.length})+ </XDSText>+ }>+ <SectionTable+ data={filteredNeeds}+ selectedKeys={selectedKeys}+ setSelectedKeys={setSelectedKeys}+ />+ </XDSCollapsible>+ )}++ {filteredAccepted.length > 0 && (+ <XDSCollapsible+ trigger={+ <XDSText type="body" weight="bold">+ Accepted and ready to land ({filteredAccepted.length})+ </XDSText>+ }>+ <SectionTable+ data={filteredAccepted}+ selectedKeys={selectedKeys}+ setSelectedKeys={setSelectedKeys}+ />+ </XDSCollapsible>+ )}+ </XDSVStack>+ </XDSVStack>+ </div>+ );+}