@ploykit/ui 0.5.0 → 0.6.2

package/src/components/__tests__/WorkspaceSwitcher.test.tsx

@@ -0,0 +1,162 @@
+import '@testing-library/jest-dom/vitest'
+import { fireEvent, render, screen, waitFor } from '@testing-library/react'
+import { MemoryRouter } from 'react-router'
+import { describe, it, expect, vi, beforeAll, beforeEach } from 'vitest'
+import { ApiError } from '@ploykit/client'
+import { WorkspaceSwitcher } from '../WorkspaceSwitcher'
+import { SidebarProvider } from '../ui/sidebar'
+
+
+
+const switchTo = vi.fn()
+const create = vi.fn(async (name: string, slug: string) => ({ id: 'ws-new', name, slug }))
+let mockError: unknown = null
+vi.mock('../../../../hooks/src/hooks/useWorkspace', () => ({
+  useWorkspaceSwitch: () => ({
+    current: { id: 'ws-1', name: 'Acme', plan_code: 'free', role: 'owner' },
+    list: [
+      { id: 'ws-1', name: 'Acme', plan_code: 'free', role: 'owner' },
+      { id: 'ws-2', name: 'Beta', plan_code: 'pro', role: 'admin' },
+    ],
+    switchTo,
+    create,
+    creating: false,
+    error: mockError,
+  }),
+}))
+
+function renderSwitcher() {
+  return render(
+    <MemoryRouter>
+      <SidebarProvider>
+        <WorkspaceSwitcher />
+      </SidebarProvider>
+    </MemoryRouter>,
+  )
+}
+
+
+beforeAll(() => {
+  Object.defineProperty(window, 'matchMedia', {
+    writable: true,
+    value: (query: string) => ({
+      matches: false,
+      media: query,
+      addEventListener: () => {},
+      removeEventListener: () => {},
+      addListener: () => {},
+      removeListener: () => {},
+      dispatchEvent: () => false,
+    }),
+  })
+})
+
+describe('WorkspaceSwitcher（Base UI Menu 重建）', () => {
+  beforeEach(() => {
+    switchTo.mockClear()
+    create.mockClear()
+    mockError = null
+  })
+
+  it('渲染当前工作区，打开菜单列出工作区与新建入口', async () => {
+    renderSwitcher()
+    const trigger = screen.getByRole('button', { name: '切换工作区' })
+    expect(trigger).toHaveTextContent('Acme')
+
+    
+    fireEvent.click(trigger)
+
+    expect(await screen.findByRole('menu')).toBeInTheDocument()
+    expect(screen.getByRole('menuitem', { name: /Beta/ })).toBeVisible()
+    expect(screen.getByRole('menuitem', { name: /新建工作区/ })).toBeVisible()
+  })
+
+  it('点击工作区项调用 switchTo', async () => {
+    renderSwitcher()
+    const trigger = screen.getByRole('button', { name: '切换工作区' })
+    fireEvent.click(trigger)
+    fireEvent.click(await screen.findByRole('menuitem', { name: /Beta/ }))
+    expect(switchTo).toHaveBeenCalledWith('ws-2')
+  })
+
+  it('新建工作区：打开内联创建，提交调用 create(name, slug)', async () => {
+    renderSwitcher()
+    const trigger = screen.getByRole('button', { name: '切换工作区' })
+    fireEvent.click(trigger)
+    fireEvent.click(await screen.findByRole('menuitem', { name: /新建工作区/ }))
+
+    const input = await screen.findByLabelText('新工作区名称')
+    fireEvent.change(input, { target: { value: 'Gamma Workspace' } })
+    fireEvent.click(screen.getByRole('button', { name: '创建' }))
+
+    await waitFor(() => expect(create).toHaveBeenCalledWith('Gamma Workspace', 'gamma-workspace'))
+  })
+
+  it('RE2-1：创建失败（配额满 402/E_QUOTA_EXCEEDED）显示中文错误与"升级套餐"指引，不再静默', async () => {
+    mockError = new ApiError(402, 'E_QUOTA_EXCEEDED', 'quota exceeded for workspaces')
+    renderSwitcher()
+    const trigger = screen.getByRole('button', { name: '切换工作区' })
+    fireEvent.click(trigger)
+    fireEvent.click(await screen.findByRole('menuitem', { name: /新建工作区/ }))
+
+    expect(await screen.findByRole('alert')).toHaveTextContent('配额已用尽')
+    
+    
+    expect(screen.getByText(/已达当前工作区数上限/)).toBeInTheDocument()
+    const billing = screen.getByRole('link', { name: '设置→计费' })
+    expect(billing).toHaveAttribute('href', '/settings/workspace/billing')
+  })
+
+  it('RE2-1：slug 冲突等其他失败显示中文文案，且不出现升级指引', async () => {
+    mockError = new ApiError(409, 'E_CONFLICT', 'slug already taken')
+    renderSwitcher()
+    const trigger = screen.getByRole('button', { name: '切换工作区' })
+    fireEvent.click(trigger)
+    fireEvent.click(await screen.findByRole('menuitem', { name: /新建工作区/ }))
+
+    expect(await screen.findByRole('alert')).toHaveTextContent('该标识已被占用，请换个工作区名称重试')
+    expect(screen.queryByRole('link', { name: '升级套餐' })).not.toBeInTheDocument()
+  })
+
+  it('RE2-1：创建成功（无 error）时面板内无错误提示', async () => {
+    renderSwitcher()
+    const trigger = screen.getByRole('button', { name: '切换工作区' })
+    fireEvent.click(trigger)
+    fireEvent.click(await screen.findByRole('menuitem', { name: /新建工作区/ }))
+
+    await screen.findByLabelText('新工作区名称')
+    expect(screen.queryByRole('alert')).not.toBeInTheDocument()
+  })
+
+  
+
+  async function submitName(name: string): Promise<unknown[]> {
+    const trigger = screen.getByRole('button', { name: '切换工作区' })
+    fireEvent.click(trigger)
+    fireEvent.click(await screen.findByRole('menuitem', { name: /新建工作区/ }))
+    fireEvent.change(await screen.findByLabelText('新工作区名称'), { target: { value: name } })
+    fireEvent.click(screen.getByRole('button', { name: '创建' }))
+    await waitFor(() => expect(create).toHaveBeenCalledTimes(1))
+    return create.mock.calls[0]
+  }
+
+  it('G2：纯中文名生成合法 slug（ws-随机后缀兜底，不以 - 开头/结尾、≥4 字符）', async () => {
+    renderSwitcher()
+    const [name, slug] = (await submitName('审计账单')) as [string, string]
+    expect(name).toBe('审计账单')
+    
+    expect(slug).toMatch(/^ws-[a-z0-9]{4}$/)
+  })
+
+  it('G2：中文-英文混合名剥离首尾横线（审计-Webhooks- → webhooks）', async () => {
+    renderSwitcher()
+    const [, slug] = (await submitName('审计-Webhooks-')) as [string, string]
+    expect(slug).toBe('webhooks')
+  })
+
+  it('G2：过短名补随机后缀达服务端 4 字符下限（ab → ab-xxxx）', async () => {
+    renderSwitcher()
+    const [, slug] = (await submitName('ab')) as [string, string]
+    expect(slug).toMatch(/^ab-[a-z0-9]{4}$/)
+  })
+})

package/src/components/__tests__/form.test.tsx

@@ -0,0 +1,133 @@
+import '@testing-library/jest-dom/vitest'
+import { fireEvent, render, screen, waitFor } from '@testing-library/react'
+import { describe, expect, it } from 'vitest'
+import { z } from 'zod'
+import { FormField } from '../FormField'
+import { useZodForm } from '@ploykit/hooks'
+
+const schema = z.object({ email: z.string().email('邮箱格式无效') })
+type FormValues = z.infer<typeof schema>
+
+let submitted: string[] = []
+
+
+function DemoForm() {
+  const { register, handleSubmit, formState } = useZodForm<FormValues>({ schema })
+  return (
+    <form
+      onSubmit={handleSubmit((values) => submitted.push(values.email))}
+      noValidate
+    >
+      <FormField label="邮箱" error={formState.errors.email?.message} htmlFor="email">
+        <input id="email" {...register('email')} />
+      </FormField>
+      <button type="submit">提交</button>
+    </form>
+  )
+}
+
+describe('useZodForm + FormField', () => {
+  it('空值提交 → formState.errors.email 非空且 FormField 显示错误文案', async () => {
+    submitted = []
+    render(<DemoForm />)
+    fireEvent.click(screen.getByRole('button', { name: '提交' }))
+    expect(await screen.findByText('邮箱格式无效')).toBeInTheDocument()
+    expect(submitted).toEqual([]) 
+  })
+
+  it('合法值提交 → 通过校验、无错误文案、onSubmit 收到值', async () => {
+    submitted = []
+    render(<DemoForm />)
+    fireEvent.change(screen.getByLabelText('邮箱'), { target: { value: 'a@b.com' } })
+    fireEvent.click(screen.getByRole('button', { name: '提交' }))
+    await waitFor(() => expect(submitted).toEqual(['a@b.com']))
+    expect(screen.queryByText('邮箱格式无效')).not.toBeInTheDocument()
+  })
+
+  it('FormField 渲染 label 并通过 htmlFor 关联控件', () => {
+    render(
+      <FormField label="名称" htmlFor="name">
+        <input id="name" />
+      </FormField>,
+    )
+    expect(screen.getByLabelText('名称')).toBe(screen.getByRole('textbox'))
+  })
+})
+
+
+
+describe('FormField aria 回连（G7.3 / B5）', () => {
+  it('出错时控件 aria-invalid=true 且 aria-describedby 同时指向说明与错误节点', () => {
+    render(
+      <FormField
+        label="昵称" htmlFor="f1" error="请输入昵称" description="对外展示的名称"
+      >
+        <input id="f1" />
+      </FormField>,
+    )
+    const input = screen.getByRole('textbox')
+    expect(input).toHaveAttribute('aria-invalid', 'true')
+    expect(input.getAttribute('aria-describedby')).toBe('f1-desc f1-error')
+    
+    expect(document.getElementById('f1-desc')).toHaveTextContent('对外展示的名称')
+    const alert = document.getElementById('f1-error')
+    expect(alert).toHaveAttribute('role', 'alert')
+    expect(alert).toHaveTextContent('请输入昵称')
+  })
+
+  it('无错误时不设置 aria-invalid，aria-describedby 仅指向说明节点', () => {
+    render(
+      <FormField label="头像链接" htmlFor="f2" description="可选，需 http(s):// 开头">
+        <input id="f2" />
+      </FormField>,
+    )
+    const input = screen.getByRole('textbox')
+    expect(input).not.toHaveAttribute('aria-invalid')
+    expect(input.getAttribute('aria-describedby')).toBe('f2-desc')
+    expect(screen.queryByRole('alert')).toBeNull()
+  })
+
+  it('缺 htmlFor 时：aria-invalid 仍注入（自包含属性），aria-describedby 不注入（id 无锚点）', () => {
+    render(
+      <FormField label="名称" error="不能为空">
+        <input />
+      </FormField>,
+    )
+    const input = screen.getByRole('textbox')
+    expect(input).toHaveAttribute('aria-invalid', 'true')
+    expect(input).not.toHaveAttribute('aria-describedby')
+    expect(screen.getByRole('alert')).toHaveTextContent('不能为空')
+  })
+
+  it('调用方自带 aria-describedby 时拼接不覆盖', () => {
+    render(
+      <FormField label="名称" htmlFor="f3" error="不能为空">
+        <input id="f3" aria-describedby="custom-hint" />
+      </FormField>,
+    )
+    expect(screen.getByRole('textbox').getAttribute('aria-describedby')).toBe('custom-hint f3-error')
+  })
+
+  it('required：label 渲染 aria-hidden 星号（不进可访问名），控件 aria-required=true', () => {
+    render(
+      <FormField label="昵称" htmlFor="f4" required>
+        <input id="f4" />
+      </FormField>,
+    )
+    const star = screen.getByText('*')
+    expect(star).toHaveAttribute('aria-hidden', 'true')
+    expect(screen.getByRole('textbox')).toHaveAttribute('aria-required', 'true')
+    
+    expect(screen.getByRole('textbox', { name: '昵称' })).toBeInTheDocument()
+  })
+
+  it('children 为字符串等非元素时安全渲染（不注入）', () => {
+    render(
+      <FormField label="区块" htmlFor="f5" error="不能为空">
+        纯文本插槽
+      </FormField>,
+    )
+    expect(screen.getByText('纯文本插槽')).toBeInTheDocument()
+    expect(screen.getByRole('alert')).toHaveTextContent('不能为空')
+  })
+})

package/src/components/__tests__/semantic-tokens.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it } from 'vitest'
+import { readFileSync, readdirSync } from 'node:fs'
+import { join, dirname, relative } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+// 语义令牌合同：@ploykit/ui 全部源码只允许使用语义令牌类（bg-background /
+// text-muted-foreground / text-(--success) 等），禁止经典调色板类
+// （bg-gray-50、text-blue-600…）。经典类依赖消费方 CSS 保留 Tailwind 默认
+// 色板——那不在令牌合同内，按 example 主题接入的产品会拿到裸页面
+// （aiblog 实录问题 10）。状态色使用 CSS 变量直引语法 text-(--success)，
+// 与 lib/utils 的 STATUS_TONE_CLASS 同一词汇表。
+const srcRoot = join(dirname(fileURLToPath(import.meta.url)), '../../..')
+const CLASSIC = /(?:bg|text|border|ring|from|to|via|fill|stroke|outline|decoration|divide|accent|caret)-(?:gray|zinc|slate|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)-\d/
+
+function collect(dir: string): string[] {
+  const out: string[] = []
+  for (const e of readdirSync(dir, { withFileTypes: true })) {
+    const p = join(dir, e.name)
+    if (e.isDirectory()) { if (e.name !== '__tests__') out.push(...collect(p)) }
+    else if (/\.tsx?$/.test(e.name) && !/\.test\./.test(e.name)) out.push(p)
+  }
+  return out
+}
+
+describe('语义令牌合同：ui 包禁用经典调色板类', () => {
+  const files = collect(srcRoot)
+
+  it('扫描范围覆盖全部源码文件', () => {
+    expect(files.length).toBeGreaterThan(80)
+  })
+
+  for (const f of files) {
+    const rel = relative(srcRoot, f).replaceAll('\\', '/')
+    it(`${rel} 无经典调色板类`, () => {
+      const lines = readFileSync(f, 'utf8').split('\n')
+      lines.forEach((line, i) => {
+        expect(CLASSIC.test(line), `${rel}:${i + 1} 使用了经典调色板类（改用语义令牌或 (--var) 直引）: ${line.trim().slice(0, 80)}`).toBe(false)
+      })
+    })
+  }
+})

package/src/components/__tests__/smoke.test.tsx

@@ -0,0 +1,11 @@
+import '@testing-library/jest-dom/vitest'
+import { render, screen } from '@testing-library/react'
+import { describe, it, expect } from 'vitest'
+import { Button } from '../ui/button'
+
+describe('vitest 基建冒烟', () => {
+  it('渲染 Button 并断言在文档中', () => {
+    render(<Button>ok</Button>)
+    expect(screen.getByRole('button', { name: 'ok' })).toBeInTheDocument()
+  })
+})

package/src/components/__tests__/toast.test.tsx

@@ -0,0 +1,27 @@
+import '@testing-library/jest-dom/vitest'
+import { render, screen } from '@testing-library/react'
+import { describe, expect, it } from 'vitest'
+import { toast, Toaster } from '../toast'
+
+describe('toast / Toaster', () => {
+  it('toast.success 后 Toaster 渲染成功提示文案', async () => {
+    render(<Toaster />)
+    toast.success('保存成功')
+    expect(await screen.findByText('保存成功')).toBeInTheDocument()
+  })
+
+  it('toast.error 渲染错误提示文案（props 可透传覆盖默认值）', async () => {
+    render(<Toaster position="bottom-left" />)
+    toast.error('保存失败')
+    expect(await screen.findByText('保存失败')).toBeInTheDocument()
+  })
+
+  
+  
+  
+  
+  
+  it('B1/G1：sonner 样式表随组件入口可解析（import 缺失即红）', async () => {
+    await expect(import('sonner/dist/styles.css')).resolves.toBeDefined()
+  })
+})

package/src/components/toast.tsx

@@ -0,0 +1,23 @@
+
+import type { ComponentProps } from 'react'
+import { Toaster as SonnerToaster, toast as sonnerToast } from 'sonner'
+
+
+
+
+import 'sonner/dist/styles.css'
+
+type SonnerToast = typeof sonnerToast
+
+
+const originalError = sonnerToast.error
+const errorWithLongerDuration: SonnerToast['error'] = (message, data) =>
+  originalError(message, { duration: 8000, ...data })
+
+export const toast: SonnerToast = Object.assign(sonnerToast, {
+  error: errorWithLongerDuration,
+})
+
+export function Toaster(props: ComponentProps<typeof SonnerToaster>) {
+  return <SonnerToaster richColors position="top-right" containerAriaLabel="通知" {...props} />
+}

package/src/components/ui/__tests__/alert-dialog.test.tsx

@@ -0,0 +1,66 @@
+import '@testing-library/jest-dom/vitest'
+import { fireEvent, render, screen, waitFor } from '@testing-library/react'
+import { useState } from 'react'
+import { describe, it, expect } from 'vitest'
+import {
+  AlertDialog, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader,
+  AlertDialogTitle, AlertDialogDescription, AlertDialogFooter,
+  AlertDialogCancel, AlertDialogAction,
+} from '../alert-dialog'
+
+
+function Demo({ onConfirm }: { onConfirm?: () => void }) {
+  const [open, setOpen] = useState(false)
+  return (
+    <AlertDialog open={open} onOpenChange={setOpen}>
+      <AlertDialogTrigger>删除</AlertDialogTrigger>
+      <AlertDialogContent>
+        <AlertDialogHeader>
+          <AlertDialogTitle>确认删除？</AlertDialogTitle>
+          <AlertDialogDescription>此操作不可撤销</AlertDialogDescription>
+        </AlertDialogHeader>
+        <AlertDialogFooter>
+          <AlertDialogCancel>取消</AlertDialogCancel>
+          <AlertDialogAction
+            onClick={() => {
+              onConfirm?.()
+              setOpen(false)
+            }}
+          >
+            确定
+          </AlertDialogAction>
+        </AlertDialogFooter>
+      </AlertDialogContent>
+    </AlertDialog>
+  )
+}
+
+describe('alert-dialog 冒烟', () => {
+  it('Trigger 打开 → Action 确认并关闭', async () => {
+    const confirmed: boolean[] = []
+    render(<Demo onConfirm={() => confirmed.push(true)} />)
+
+    fireEvent.click(screen.getByRole('button', { name: '删除' }))
+    expect(await screen.findByRole('alertdialog')).toBeInTheDocument()
+    expect(screen.getByText('确认删除？')).toBeVisible()
+    expect(screen.getByText('此操作不可撤销')).toBeVisible()
+
+    fireEvent.click(screen.getByRole('button', { name: '确定' }))
+    expect(confirmed).toEqual([true])
+    await waitFor(() =>
+      expect(screen.queryByRole('alertdialog')).not.toBeInTheDocument(),
+    )
+  })
+
+  it('Cancel 关闭弹窗且不触发确认', async () => {
+    const confirmed: boolean[] = []
+    render(<Demo onConfirm={() => confirmed.push(true)} />)
+
+    fireEvent.click(screen.getByRole('button', { name: '删除' }))
+    fireEvent.click(await screen.findByRole('button', { name: '取消' }))
+    await waitFor(() =>
+      expect(screen.queryByRole('alertdialog')).not.toBeInTheDocument(),
+    )
+    expect(confirmed).toEqual([])
+  })
+})

package/src/components/ui/__tests__/avatar.test.tsx

@@ -0,0 +1,30 @@
+import '@testing-library/jest-dom/vitest'
+import { render, screen } from '@testing-library/react'
+import { describe, it, expect } from 'vitest'
+import { Avatar, AvatarImage, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarBadge } from '../avatar'
+
+describe('avatar 冒烟', () => {
+  it('无图时渲染 AvatarFallback 内容', () => {
+    render(
+      <Avatar>
+        <AvatarImage src="" alt="张三" />
+        <AvatarFallback>张</AvatarFallback>
+      </Avatar>,
+    )
+    expect(screen.getByText('张')).toBeVisible()
+  })
+
+  it('AvatarGroup + AvatarBadge + AvatarGroupCount 组合渲染', () => {
+    render(
+      <AvatarGroup>
+        <Avatar>
+          <AvatarFallback>甲</AvatarFallback>
+          <AvatarBadge />
+        </Avatar>
+        <AvatarGroupCount>+3</AvatarGroupCount>
+      </AvatarGroup>,
+    )
+    expect(screen.getByText('甲')).toBeVisible()
+    expect(screen.getByText('+3')).toBeVisible()
+  })
+})

package/src/components/ui/__tests__/checkbox.test.tsx

@@ -0,0 +1,18 @@
+import '@testing-library/jest-dom/vitest'
+import { fireEvent, render, screen } from '@testing-library/react'
+import { describe, it, expect, vi } from 'vitest'
+import { Checkbox } from '../checkbox'
+
+describe('checkbox 冒烟', () => {
+  it('点击切换 aria-checked 并触发 onCheckedChange', () => {
+    const onChange = vi.fn()
+    render(<Checkbox defaultChecked onCheckedChange={onChange} aria-label="同意条款" />)
+
+    const cb = screen.getByRole('checkbox', { name: '同意条款' })
+    expect(cb).toHaveAttribute('aria-checked', 'true')
+
+    fireEvent.click(cb)
+    expect(cb).toHaveAttribute('aria-checked', 'false')
+    expect(onChange).toHaveBeenCalledWith(false, expect.anything())
+  })
+})

package/src/components/ui/__tests__/dropdown-menu.test.tsx

@@ -0,0 +1,33 @@
+import '@testing-library/jest-dom/vitest'
+import { fireEvent, render, screen, waitFor } from '@testing-library/react'
+import { describe, it, expect } from 'vitest'
+import {
+  DropdownMenu, DropdownMenuTrigger, DropdownMenuContent,
+  DropdownMenuItem, DropdownMenuSeparator,
+} from '../dropdown-menu'
+
+describe('dropdown-menu 冒烟', () => {
+  it('Trigger 打开菜单；点击 MenuItem 触发回调并关闭', async () => {
+    const picked: string[] = []
+    render(
+      <DropdownMenu>
+        <DropdownMenuTrigger>操作</DropdownMenuTrigger>
+        <DropdownMenuContent>
+          <DropdownMenuItem onClick={() => picked.push('edit')}>编辑</DropdownMenuItem>
+          <DropdownMenuSeparator />
+          <DropdownMenuItem variant="destructive">删除</DropdownMenuItem>
+        </DropdownMenuContent>
+      </DropdownMenu>,
+    )
+
+    fireEvent.click(screen.getByRole('button', { name: '操作' }))
+    expect(await screen.findByRole('menu')).toBeInTheDocument()
+    expect(screen.getByRole('menuitem', { name: '编辑' })).toBeVisible()
+
+    fireEvent.click(screen.getByRole('menuitem', { name: '编辑' }))
+    expect(picked).toEqual(['edit'])
+    await waitFor(() =>
+      expect(screen.queryByRole('menu')).not.toBeInTheDocument(),
+    )
+  })
+})

package/src/components/ui/__tests__/field.test.tsx

@@ -0,0 +1,43 @@
+import '@testing-library/jest-dom/vitest'
+import { render, screen } from '@testing-library/react'
+import { describe, it, expect } from 'vitest'
+import {
+  Field, FieldLabel, FieldDescription, FieldError, FieldSeparator, FieldGroup,
+} from '../field'
+
+describe('field 体系冒烟', () => {
+  it('Field(role=group) + FieldLabel(htmlFor) 关联控件', () => {
+    render(
+      <Field>
+        <FieldLabel htmlFor="name">名称</FieldLabel>
+        <input id="name" />
+      </Field>,
+    )
+    expect(screen.getByRole('group')).toBeInTheDocument()
+    expect(screen.getByLabelText('名称')).toBe(screen.getByRole('textbox'))
+  })
+
+  it('FieldError 渲染 errors 去重后的 message，并保持 role=alert', () => {
+    render(
+      <FieldError
+        errors={[{ message: '必填' }, { message: '必填' }, { message: '邮箱格式无效' }]}
+      />,
+    )
+    const alert = screen.getByRole('alert')
+    expect(alert).toHaveTextContent('必填')
+    expect(alert).toHaveTextContent('邮箱格式无效')
+  })
+
+  it('无内容时 FieldError 不渲染；FieldDescription/FieldSeparator 正常出文案', () => {
+    render(
+      <FieldGroup>
+        <FieldError errors={[]} />
+        <FieldDescription>辅助说明文字</FieldDescription>
+        <FieldSeparator>Or continue with</FieldSeparator>
+      </FieldGroup>,
+    )
+    expect(screen.queryByRole('alert')).not.toBeInTheDocument()
+    expect(screen.getByText('辅助说明文字')).toBeInTheDocument()
+    expect(screen.getByText('Or continue with')).toBeInTheDocument()
+  })
+})