Skip to content

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.tsx
index 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.tsx
index 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">
<XDSSideNavItem
label="Dashboard"
href="/dashboard"
diff --git a/apps/sandbox/src/app/pages/table-overview/page.tsx b/apps/sandbox/src/app/pages/table-overview/page.tsx
new file mode 100644
index 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>
+ );
+}