weifuwu 0.87.0 → 0.89.0

package/content/components/table.md

@@ -1,66 +0,0 @@
-# Table · components
-
-## 概述
-
-可排序 + 自定义 render + 空状态
-
-## 典型场景
-
-- 页面模式：app-shell、dashboard、list-page（复制即用蓝本——examples/patterns/）
-- 应用模板：admin、agent-platform（examples/apps/ 完整可跑）
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `data` | `any[]` | 否 |  |
-| `columns` | `TableColumn[]` | 是 |  |
-| `onRowClick` | `(row: any, index: number) => void` | 否 |  |
-| `sortKey` | `string` | 否 | 当前排序列的 key |
-| `sortOrder` | `'asc' \| 'desc'` | 否 | 当前排序方向 |
-| `onSort` | `(key: string, order: 'asc' \| 'desc') => void` | 否 | 排序变化回调 |
-| `rowSelection` | `TableRowSelection` | 否 | 行选择（受控） |
-| `emptyText` | `string` | 否 | 数据为空时显示的文本 |
-| `minWidth` | `string` | 否 | 表格最小宽度（窄屏横向滚动，如 '720px'） |
-| `onCellEdit` | `(key: string, rowIndex: number, value: string, row: any) => void` | 否 | 行内编辑提交回调（editable 列必配——受控纪律） |
-| `loading` | `boolean` | 否 | 加载中：保留表头，渲染骨架行 |
-| `loadingRows` | `number` | 否 | 骨架行数，默认 3 |
-
-## 用法示例
-
-```tsx
-<Table data={items} columns={[
-  {key:'id', label:'ID'},
-  {key:'name', label:'姓名', sortable: true},
-  {key:'status', label:'状态',
-    render: v => <Badge>{v}</Badge>},
-]}
-  sortKey="name" sortOrder="asc"
-  onSort={(k,o) => setSort(k,o)} />
-```
-
-## 纪律/坑
-
-- 固定列必须显式 width（缺省 140 估算 + console.warn——sticky 偏移累计依赖）
-- 数组空洞：children 里 {cond && <X/>} 是占位——不得误删下一个兄弟（提交按钮消失事故同源）
-- 行内编辑（editable 列）必须配 onCellEdit（受控纪律）
-
-## 关系
-
-- ↑ 用于页面模式：[app-shell](../patterns/app-shell.md) · [dashboard](../patterns/dashboard.md) · [list-page](../patterns/list-page.md)
-- ↑ 用于应用：[admin](../apps/admin.md) · [agent-platform](../apps/agent-platform.md)
-- → 后端能力：[sql](../backend/sql.md) · [redis](../backend/redis.md)
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Table/Table.ts` |
-| 样式 | `src/client/components/Table/Table.css` |
-| 测试 | `src/client/components/Table/Table.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTable.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/table` ——（P1 填充具体步骤）

package/content/components/tabs.md

@@ -1,56 +0,0 @@
-# Tabs · components
-
-## 概述
-
-标签页切换，支持 active/onChange
-
-## 典型场景
-
-- 页面模式：workspace、settings-page（复制即用蓝本——examples/patterns/）
-- 应用模板：multi（examples/apps/ 完整可跑）
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `TabItem[]` | 否 |  |
-| `active` | `string` | 否 |  |
-| `onChange` | `(key: string) => void` | 否 |  |
-| `closable` | `boolean` | 否 | 可关闭 tab（浏览器标签类应用——关闭中间 tab 自动激活邻居） |
-| `onClose` | `(key: string) => void` | 否 | 关闭回调（父负责从 items 移除；受控纪律：closable 必须配 onClose） |
-| `addable` | `boolean` | 否 | 显示新增 + 按钮 |
-| `onAdd` | `() => void` | 否 | 新增回调（父负责追加 items） |
-
-## 用法示例
-
-```tsx
-<Tabs items={[
-  {key:'a',label:'详情',
-    content:<p>...</p>},
-]} active="a" onChange={fn} />
-```
-
-## 纪律/坑
-
-- 混合数组稳定 key：tabList+addBtn+ink 全 keyed——无 key 项退 unkeyed 位置配对（新增 tab 错位事故）
-- closable 必须配 onClose / addable 必须配 onAdd（受控纪律——console.warn）
-
-## 关系
-
-- ↑ 用于页面模式：[workspace](../patterns/workspace.md) · [settings-page](../patterns/settings-page.md)
-- ↑ 用于应用：[multi](../apps/multi.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Tabs/Tabs.ts` |
-| 样式 | `src/client/components/Tabs/Tabs.css` |
-| 测试 | `src/client/components/Tabs/Tabs.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTabs.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/tabs` ——（P1 填充具体步骤）

package/content/components/tag.md

@@ -1,51 +0,0 @@
-# Tag · components
-
-## 概述
-
-标签，支持 closable/onClose
-
-## 典型场景
-
-- 页面模式：docs、list-page、detail-page（复制即用蓝本——examples/patterns/）
-- 应用模板：todo、admin、multi（examples/apps/ 完整可跑）
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `closable` | `boolean` | 否 |  |
-| `onClose` | `() => void` | 否 |  |
-| `variant` | `'default' \| 'primary' \| 'success' \| 'danger'` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Tag>标签</Tag>
-<Tag variant="primary" />
-<Tag closable>可关闭</Tag>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：[docs](../patterns/docs.md) · [list-page](../patterns/list-page.md) · [detail-page](../patterns/detail-page.md)
-- ↑ 用于应用：[todo](../apps/todo.md) · [admin](../apps/admin.md) · [multi](../apps/multi.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Tag/Tag.ts` |
-| 样式 | `src/client/components/Tag/Tag.css` |
-| 测试 | `src/client/components/Tag/Tag.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTag.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/tag` ——（P1 填充具体步骤）

package/content/components/tagsinput-v2.md

@@ -1,39 +0,0 @@
-# TagsInput 限制/错误 · components
-
-## 概述
-
-maxTags 限制 + error 校验态（状态矩阵覆盖）
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<TagsInput value={tags} maxTags={3} error="标签超限" onChange={t => set(t)} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoTagsInputErr.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/tagsinput-v2` ——（P1 填充具体步骤）

package/content/components/tagsinput.md

@@ -1,54 +0,0 @@
-# TagsInput · components
-
-## 概述
-
-标签输入：回车/逗号添加 + 中文输入法感知
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string[]` | 否 |  |
-| `onChange` | `(tags: string[]) => void` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `maxTags` | `number` | 否 |  |
-| `allowDuplicates` | `boolean` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `label` | `string` | 否 |  |
-| `error` | `string` | 否 |  |
-| `hint` | `string` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<TagsInput value={tags} placeholder="回车添加标签"
-  maxTags={10} onChange={setTags} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/TagsInput/TagsInput.ts` |
-| 样式 | `src/client/components/TagsInput/TagsInput.css` |
-| 测试 | `src/client/components/TagsInput/TagsInput.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTagsInput.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/tagsinput` ——（P1 填充具体步骤）

package/content/components/text.md

@@ -1,45 +0,0 @@
-# Text · components
-
-## 概述
-
-正文排版（语义色 -text 变体 + mark/code/删除线）——Typography 家族
-
-## 典型场景
-
-- 页面模式：app-shell、workspace、focus-task、dashboard、data-screen、landing、mobile（复制即用蓝本——examples/patterns/）
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `level` | `1 \| 2 \| 3 \| 4 \| 5` | 否 | 1-5，默认 1（h1-h5） |
-| `children` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-| `style` | `Record<string, string>` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：[app-shell](../patterns/app-shell.md) · [workspace](../patterns/workspace.md) · [focus-task](../patterns/focus-task.md) · [dashboard](../patterns/dashboard.md) · [data-screen](../patterns/data-screen.md) · [landing](../patterns/landing.md) · [mobile](../patterns/mobile.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Typography/Typography.ts` |
-| 样式 | `src/client/components/Typography/Typography.css` |
-| 测试 | `src/client/components/Typography/Typography.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/text` ——（P1 填充具体步骤）

package/content/components/textarea.md

@@ -1,57 +0,0 @@
-# Textarea · components
-
-## 概述
-
-多行文本，支持 rows/label/error/hint
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `label` | `string` | 否 |  |
-| `value` | `string` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `required` | `boolean` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `error` | `string` | 否 |  |
-| `hint` | `string` | 否 |  |
-| `rows` | `number` | 否 |  |
-| `maxLength` | `number` | 否 | 最大字符数（同时限制输入） |
-| `showCount` | `boolean` | 否 | 显示字数统计（右下角；配合受控 value 实时更新） |
-| `onInput` | `(e: Event) => void` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Textarea label="简介" rows={3}
-  value={bio}
-  onInput={e => bio = e.target.value} />
-<Textarea error="错误" />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Textarea/Textarea.ts` |
-| 样式 | `src/client/components/Textarea/Textarea.css` |
-| 测试 | `src/client/components/Textarea/Textarea.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTextarea.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/textarea` ——（P1 填充具体步骤）

package/content/components/themeswitch.md

@@ -1,69 +0,0 @@
-# ThemeSwitch · components
-
-## 概述
-
-主题切换：auto/light/dark，localStorage 持久化
-
-## 典型场景
-
-- 应用模板：admin、agent-platform（examples/apps/ 完整可跑）
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `mode` | `ThemeMode` | 否 | 初始模式（默认从 localStorage 读取，无记录时为 auto） |
-| `onChange` | `(mode: ThemeMode) => void` | 否 | 切换回调 |
-| `storageKey` | `string` | 否 | localStorage 存储 key |
-| `preset` | `PresetName` | 否 | 预设主题（可选——传了才渲染预设行；对应 layout `data-preset`） |
-| `onPresetChange` | `(preset: PresetName) => void` | 否 | 预设切换回调 |
-
-## 用法示例
-
-```tsx
-<ThemeSwitch />
-
-<ThemeSwitch onChange={mode =>
-  console.log(mode)} />  // auto | light | dark
-
-{/* 预设主题行（可选）：minimal/compact/rounded，与暗色正交 */}
-<ThemeSwitch preset="compact"
-  onPresetChange={p =>
-    console.log(p)} />
-
-// 单值换肤：改 seed 一个值，色阶自动派生
-:root {
-  --wf-brand-seed: #7c3aed;
-  --wf-dark-brand-seed: #a78bfa;  /* 暗色品牌（可选） */
-}
-
-// 命令式
-import { applyTheme, getTheme } from 'weifuwu/components'
-applyTheme('dark')
-getTheme()  // 'auto' | 'light' | 'dark'
-
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：[admin](../apps/admin.md) · [agent-platform](../apps/agent-platform.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ThemeSwitch/ThemeSwitch.ts` |
-| 样式 | `src/client/components/ThemeSwitch/ThemeSwitch.css` |
-| 测试 | `src/client/components/ThemeSwitch/ThemeSwitch.test.ts` |
-| demo | `apps/showcase/src/demos/DemoThemeSwitch.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/themeswitch` ——（P1 填充具体步骤）

package/content/components/timeline.md

@@ -1,50 +0,0 @@
-# Timeline · components
-
-## 概述
-
-时间线：节点状态色 + 时间 + 内容（执行日志/审批历史）
-
-## 典型场景
-
-- 页面模式：detail-page（复制即用蓝本——examples/patterns/）
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `TimelineItem[]` | 是 |  |
-| `mode` | `'left' \| 'alternate' \| 'horizontal'` | 否 |  |
-| `reverse` | `boolean` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Timeline items={[
-  { key: '1', title: 'AI 回复', time: '10:00', status: 'success', content: '…' },
-  { key: '2', title: '工具调用', time: '10:00', status: 'info' },
-]} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：[detail-page](../patterns/detail-page.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Timeline/Timeline.ts` |
-| 样式 | `src/client/components/Timeline/Timeline.css` |
-| 测试 | `src/client/components/Timeline/Timeline.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTimeline.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/timeline` ——（P1 填充具体步骤）

package/content/components/title.md

@@ -1,45 +0,0 @@
-# Title · components
-
-## 概述
-
-标题排版（语义标签 + 语义色 -text 变体）——Typography 家族
-
-## 典型场景
-
-- 页面模式：docs、dashboard、landing（复制即用蓝本——examples/patterns/）
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `level` | `1 \| 2 \| 3 \| 4 \| 5` | 否 | 1-5，默认 1（h1-h5） |
-| `children` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-| `style` | `Record<string, string>` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：[docs](../patterns/docs.md) · [dashboard](../patterns/dashboard.md) · [landing](../patterns/landing.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Typography/Typography.ts` |
-| 样式 | `src/client/components/Typography/Typography.css` |
-| 测试 | `src/client/components/Typography/Typography.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/title` ——（P1 填充具体步骤）

package/content/components/toast.md

@@ -1,52 +0,0 @@
-# Toast · components
-
-## 概述
-
-5 种位置 + 自动消失 + 数量限制
-
-## 典型场景
-
-- 操作反馈/结果页/确认——保存成功、删除确认、空态/加载态
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `toasts` | `ToastItem[]` | 否 |  |
-| `onRemove` | `(id: string) => void` | 否 |  |
-| `position` | `ToastPosition` | 否 | 容器位置，默认 top-right |
-| `duration` | `number` | 否 | 全局默认自动消失时间（ms），0 = 不自动消失，默认 0 |
-| `max` | `number` | 否 | 最大显示条数，超出时移除最早条目，默认 0 = 不限制 |
-
-## 用法示例
-
-```tsx
-// toasts: [{id, type, message}]
-<Toast toasts={toasts}
-  position="top-right"
-  max={3}
-  onRemove={id => ...} />
-```
-
-## 纪律/坑
-
-> 退场动画（§8）：exit 类必须挂载（animationend 驱动）+ reduced-motion 降级
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Toast/Toast.ts` |
-| 样式 | `src/client/components/Toast/Toast.css` |
-| 测试 | `src/client/components/Toast/Toast.test.ts` |
-| demo | `apps/showcase/src/demos/DemoToast.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/feedback/toast` ——（P1 填充具体步骤）

package/content/components/toggle-togglegroup.md

@@ -1,52 +0,0 @@
-# Toggle / ToggleGroup · components
-
-## 概述
-
-切换按钮：single/multiple 双模式（shadcn 对齐）
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `pressed` | `boolean` | 否 | 按下状态（受控） |
-| `onPressedChange` | `(pressed: boolean) => void` | 否 |  |
-| `variant` | `'default' \| 'outline'` | 否 |  |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `children` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<ToggleGroup type="single" options={[{value:'b',label:'B'}]} />
-<ToggleGroup type="multiple" />
-<Toggle pressed>单个</Toggle>
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ToggleGroup/ToggleGroup.ts` |
-| 样式 | `src/client/components/ToggleGroup/ToggleGroup.css` |
-| 测试 | `src/client/components/ToggleGroup/ToggleGroup.test.ts` |
-| demo | `apps/showcase/src/demos/DemoToggleGroup.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/toggle-togglegroup` ——（P1 填充具体步骤）

package/content/components/togglegroup.md

@@ -1,47 +0,0 @@
-# ToggleGroup · components
-
-## 概述
-
-（无 demo 卡片——组件目录存在）
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `pressed` | `boolean` | 否 | 按下状态（受控） |
-| `onPressedChange` | `(pressed: boolean) => void` | 否 |  |
-| `variant` | `'default' \| 'outline'` | 否 |  |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `children` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ToggleGroup/ToggleGroup.ts` |
-| 样式 | `src/client/components/ToggleGroup/ToggleGroup.css` |
-| 测试 | `src/client/components/ToggleGroup/ToggleGroup.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/togglegroup` ——（P1 填充具体步骤）