path: root/src/UiKit.tsx

import { useState } from 'react'
import type { ReactNode } from 'react'
import {
  Alert, Badge, Box, Button, Card, DataList, Dialog, Drawer, Group,
  Loader, LoadingOverlay, Menu, Menubar, Modal, Notification, Pagination,
  Paper, Popover, SimpleGrid, Skeleton, Stack, Table, Tabs, Text,
  TextInput, Timeline, Title, Tooltip, useMatches,
} from '@mantine/core'
import { useTimeout } from '@mantine/hooks'
import { createNotificationsStore, Notifications, notifications } from '@mantine/notifications'
import { CheckIcon, HeartIcon, InfoIcon, PlusIcon, WarningIcon } from '@phosphor-icons/react'
import '@mantine/notifications/styles.css'
import classes from './UiKit.module.css'

function Section({ title, children }: { title: string; children: ReactNode }) {
  return (
    <Paper component="section" withBorder p="md" className={classes.section}>
      <Stack gap="md">
        <Title order={2} size="h4">{title}</Title>
        {children}
      </Stack>
    </Paper>
  )
}

const records = Array.from({ length: 13 }, (_, index) => ({
  id: index + 1,
  name: `示例项目 ${String(index + 1).padStart(2, '0')}`,
  owner: ['林晨', '陈宁', '李明'][index % 3],
  status: ['进行中', '已完成', '待开始'][index % 3],
}))
const statusColors: Record<string, string> = { 进行中: 'blue', 已完成: 'green', 待开始: 'gray' }
const pageSize = 5

export default function UiKit() {
  const [store] = useState(createNotificationsStore)
  const [overlay, setOverlay] = useState<'drawer' | 'dialog' | 'modal' | null>(null)
  const [popoverOpened, setPopoverOpened] = useState(false)
  const [showAlert, setShowAlert] = useState(true)
  const [showNotification, setShowNotification] = useState(true)
  const [loading, setLoading] = useState(false)
  const [liked, setLiked] = useState(false)
  const [showStatus, setShowStatus] = useState(true)
  const [action, setAction] = useState('尚未执行操作')
  const [page, setPage] = useState(1)
  const [draftName, setDraftName] = useState('我的示例项目')
  const drawerSize = useMatches({ base: '100%', sm: 'md' })
  const { start: finishLoading } = useTimeout(() => setLoading(false), 1500)
  const visibleRecords = records.slice((page - 1) * pageSize, page * pageSize)

  function notify(message: string, color = 'blue') {
    notifications.show({
      title: '示例通知', message, color,
      closeButtonProps: { 'aria-label': '关闭浮动通知' },
    }, store)
  }

  function runAction(message: string) {
    setAction(message)
    notify(message)
  }

  return (
    <Stack gap="lg">
      <Notifications store={store} position="top-right" limit={3} />
      <div>
        <Title order={1}>UI Kit</Title>
        <Text c="dimmed">常用界面组件与交互示例，所有操作仅作用于当前页面。</Text>
      </div>

      <Section title="按钮 Button">
        <Group>
          <Button leftSection={<PlusIcon aria-hidden="true" />} onClick={() => runAction('已点击主要按钮')}>主要按钮</Button>
          <Button variant="light" onClick={() => runAction('已点击浅色按钮')}>浅色按钮</Button>
          <Button variant="outline" onClick={() => runAction('已点击描边按钮')}>描边按钮</Button>
          <Button variant="subtle" onClick={() => runAction('已点击文字按钮')}>文字按钮</Button>
          <Button disabled>禁用按钮</Button>
          <Button loading>加载中</Button>
        </Group>
        <Text size="sm" c="dimmed" role="status">{action}</Text>
      </Section>

      <SimpleGrid cols={{ base: 1, md: 2 }} spacing="lg">
        <Section title="提示 Alert">
          <Alert title="提示信息" icon={<InfoIcon />} color="blue">可以在这里展示操作说明。</Alert>
          <Alert title="操作成功" icon={<CheckIcon />} color="green">示例内容已保存。</Alert>
          {showAlert ? (
            <Alert title="请留意" icon={<WarningIcon />} color="orange" withCloseButton
              closeButtonLabel="关闭警告" onClose={() => setShowAlert(false)}>
              这是一条可以关闭的警告提示。
            </Alert>
          ) : <Button variant="light" onClick={() => setShowAlert(true)}>重新显示警告</Button>}
        </Section>

        <Section title="通知 Notification">
          {showNotification ? (
            <Notification title="收到新消息" icon={<CheckIcon />} color="teal"
              onClose={() => setShowNotification(false)} closeButtonProps={{ 'aria-label': '关闭示例通知' }}>
              这是一条嵌入页面的通知。
            </Notification>
          ) : <Button variant="light" onClick={() => setShowNotification(true)}>恢复示例通知</Button>}
          <Group>
            <Button onClick={() => notify('欢迎体验浮动通知。')}>显示通知</Button>
            <Button color="green" variant="light" onClick={() => notify('操作成功完成。', 'green')}>成功通知</Button>
            <Button color="red" variant="light" onClick={() => notify('这是错误通知示例，请重试。', 'red')}>错误通知</Button>
          </Group>
        </Section>
      </SimpleGrid>

      <Section title="标签页 Tabs">
        <Tabs defaultValue="overview">
          <Tabs.List aria-label="示例标签页">
            <Tabs.Tab value="overview">概览</Tabs.Tab>
            <Tabs.Tab value="activity">动态</Tabs.Tab>
            <Tabs.Tab value="settings">设置</Tabs.Tab>
            <Tabs.Tab value="disabled" disabled>不可用</Tabs.Tab>
          </Tabs.List>
          <Tabs.Panel value="overview" pt="md">这是概览面板，可以放置摘要信息。</Tabs.Panel>
          <Tabs.Panel value="activity" pt="md">暂无新动态，所有示例数据均为本地数据。</Tabs.Panel>
          <Tabs.Panel value="settings" pt="md">
            <Button variant="light" onClick={() => notify('示例设置已恢复。')}>恢复示例设置</Button>
          </Tabs.Panel>
        </Tabs>
      </Section>

      <Section title="菜单栏 Menubar">
        <Menubar aria-label="示例菜单栏">
          <Menubar.Menu>
            <Menubar.Target>文件</Menubar.Target>
            <Menubar.Dropdown>
              <Menu.Item onClick={() => runAction('已新建示例文件')}>新建文件</Menu.Item>
              <Menu.Item onClick={() => runAction('已保存示例文件')}>保存文件</Menu.Item>
              <Menu.Divider />
              <Menu.Item disabled>导出（不可用）</Menu.Item>
            </Menubar.Dropdown>
          </Menubar.Menu>
          <Menubar.Menu>
            <Menubar.Target>视图</Menubar.Target>
            <Menubar.Dropdown>
              <Menu.CheckboxItem checked={showStatus} onChange={setShowStatus}>显示状态栏</Menu.CheckboxItem>
            </Menubar.Dropdown>
          </Menubar.Menu>
          <Menubar.Menu>
            <Menubar.Target>帮助</Menubar.Target>
            <Menubar.Dropdown>
              <Menu.Item onClick={() => notify('可使用方向键切换菜单，按 Escape 关闭。')}>键盘操作说明</Menu.Item>
            </Menubar.Dropdown>
          </Menubar.Menu>
        </Menubar>
        {showStatus && <Text size="sm" c="dimmed">状态栏：准备就绪</Text>}
      </Section>

      <Section title="加载状态 Loading">
        <Group gap="xl">
          <Loader type="oval" aria-label="圆环加载动画" />
          <Loader type="dots" aria-label="圆点加载动画" />
          <Loader type="bars" aria-label="条形加载动画" />
          <Button variant="light" disabled={loading} onClick={() => { setLoading(true); finishLoading() }}>
            模拟加载
          </Button>
        </Group>
        <Box className={classes.loadingExample} aria-busy={loading}>
          <LoadingOverlay visible={loading} zIndex={10} loaderProps={{ 'aria-label': '示例内容加载中' }} />
          <Stack gap="xs" inert={loading}>
            <Text size="sm">点击按钮展示加载遮罩，约 1.5 秒后恢复。</Text>
            <Skeleton height="var(--mantine-spacing-md)" />
            <Skeleton height="var(--mantine-spacing-md)" width="70%" />
          </Stack>
        </Box>
      </Section>

      <Section title="弹层 Drawer / Dialog / Modal / Popover / Tooltip">
        <Group>
          <Button onClick={() => setOverlay('drawer')}>打开 Drawer</Button>
          <Button variant="light" onClick={() => setOverlay('dialog')}>打开 Dialog</Button>
          <Button variant="outline" onClick={() => setOverlay('modal')}>打开 Modal</Button>
          <Popover opened={popoverOpened} onChange={setPopoverOpened} withArrow trapFocus width={260}>
            <Popover.Target>
              <Button variant="default" onClick={() => setPopoverOpened((value) => !value)}>打开 Popover</Button>
            </Popover.Target>
            <Popover.Dropdown>
              <Stack gap="xs">
                <Text fw={600}>快捷提示</Text>
                <Text size="sm">气泡内可以放置文字与操作按钮。</Text>
                <Button size="xs" onClick={() => setPopoverOpened(false)}>知道了</Button>
              </Stack>
            </Popover.Dropdown>
          </Popover>
          <Tooltip label="悬停或键盘聚焦时显示提示" withArrow events={{ hover: true, focus: true, touch: true }}>
            <Button variant="subtle">Tooltip 提示</Button>
          </Tooltip>
        </Group>
      </Section>

      <SimpleGrid cols={{ base: 1, md: 2 }} spacing="lg">
        <Section title="卡片 Card 与徽章 Badge">
          <Card withBorder padding="md">
            <Stack gap="sm">
              <Group justify="space-between">
                <Text fw={600}>组件示例项目</Text>
                <Badge color="green">进行中</Badge>
              </Group>
              <Text size="sm" c="dimmed">卡片组合标题、说明、状态与操作，适合展示独立内容。</Text>
              <Group>
                <Badge variant="light">React</Badge>
                <Badge variant="outline">Mantine</Badge>
                <Badge variant="dot" color="orange">示例</Badge>
              </Group>
              <Button variant={liked ? 'filled' : 'light'} aria-pressed={liked}
                leftSection={<HeartIcon weight={liked ? 'fill' : 'regular'} aria-hidden="true" />}
                onClick={() => setLiked((value) => !value)}>
                {liked ? '已收藏' : '收藏卡片'}
              </Button>
            </Stack>
          </Card>
        </Section>

        <Section title="数据列表 DataList">
          <DataList withDivider>
            <DataList.Item><DataList.ItemLabel>项目</DataList.ItemLabel><DataList.ItemValue>Template React</DataList.ItemValue></DataList.Item>
            <DataList.Item><DataList.ItemLabel>用途</DataList.ItemLabel><DataList.ItemValue>界面组件演示</DataList.ItemValue></DataList.Item>
            <DataList.Item><DataList.ItemLabel>状态</DataList.ItemLabel><DataList.ItemValue><Badge color="green" variant="light">可用</Badge></DataList.ItemValue></DataList.Item>
            <DataList.Item><DataList.ItemLabel>维护者</DataList.ItemLabel><DataList.ItemValue>示例团队</DataList.ItemValue></DataList.Item>
          </DataList>
        </Section>
      </SimpleGrid>

      <Section title="时间线 Timeline">
        <Timeline active={1}>
          <Timeline.Item title="创建项目"><Text size="sm" c="dimmed">项目初始化完成。</Text></Timeline.Item>
          <Timeline.Item title="开发组件"><Text size="sm" c="dimmed">正在搭建布局和交互示例。</Text></Timeline.Item>
          <Timeline.Item title="完成验收"><Text size="sm" c="dimmed">等待检查和发布。</Text></Timeline.Item>
        </Timeline>
      </Section>

      <Section title="表格 Table 与分页器 Pagination">
        <Table.ScrollContainer minWidth={500}>
          <Table striped highlightOnHover withTableBorder>
            <Table.Caption>项目列表（示例数据）</Table.Caption>
            <Table.Thead><Table.Tr>
              <Table.Th scope="col">编号</Table.Th><Table.Th scope="col">项目名称</Table.Th>
              <Table.Th scope="col">负责人</Table.Th><Table.Th scope="col">状态</Table.Th>
            </Table.Tr></Table.Thead>
            <Table.Tbody>
              {visibleRecords.map((record) => (
                <Table.Tr key={record.id}>
                  <Table.Td>{record.id}</Table.Td><Table.Td>{record.name}</Table.Td>
                  <Table.Td>{record.owner}</Table.Td>
                  <Table.Td><Badge color={statusColors[record.status]} variant="light">{record.status}</Badge></Table.Td>
                </Table.Tr>
              ))}
            </Table.Tbody>
          </Table>
        </Table.ScrollContainer>
        <Group justify="space-between">
          <Text size="sm" c="dimmed" aria-live="polite">
            共 {records.length} 条，第 {(page - 1) * pageSize + 1}–{Math.min(page * pageSize, records.length)} 条
          </Text>
          <Pagination total={Math.ceil(records.length / pageSize)} value={page} onChange={setPage}
            getItemProps={(value) => ({ 'aria-label': `第 ${value} 页` })}
            getControlProps={(control) => ({ 'aria-label': ({ first: '首页', previous: '上一页', next: '下一页', last: '末页' })[control] })} />
        </Group>
      </Section>

      <Drawer opened={overlay === 'drawer'} onClose={() => setOverlay(null)} title="Drawer 抽屉示例"
        position="right" size={drawerSize} closeButtonProps={{ 'aria-label': '关闭 Drawer' }}>
        <Stack>
          <Text>抽屉适合展示详情或辅助操作。</Text>
          <Button onClick={() => setOverlay(null)}>关闭抽屉</Button>
        </Stack>
      </Drawer>

      <Dialog opened={overlay === 'dialog'} onClose={() => setOverlay(null)} withCloseButton
        role="dialog" aria-labelledby="ui-kit-dialog-title" className={classes.dialog}>
        <Stack gap="xs">
          <Text id="ui-kit-dialog-title" fw={600}>Dialog 提示框</Text>
          <Text size="sm">无需遮罩的轻量提示，你仍可以操作页面。</Text>
          <Button size="xs" onClick={() => setOverlay(null)}>关闭提示</Button>
        </Stack>
      </Dialog>

      <Modal opened={overlay === 'modal'} onClose={() => setOverlay(null)} title="Modal 弹窗示例"
        centered closeButtonProps={{ 'aria-label': '关闭 Modal' }}>
        <Stack>
          <TextInput label="项目名称" value={draftName} onChange={(event) => setDraftName(event.currentTarget.value)} data-autofocus />
          <Group justify="flex-end">
            <Button variant="default" onClick={() => setOverlay(null)}>取消</Button>
            <Button disabled={!draftName.trim()} onClick={() => { setOverlay(null); notify(`已保存：${draftName.trim()}`, 'green') }}>保存</Button>
          </Group>
        </Stack>
      </Modal>
    </Stack>
  )
}