weifuwu 0.87.0 → 0.89.0

package/content/components/navmenu.md

@@ -1,47 +0,0 @@
-# NavMenu · components
-
-## 概述
-
-顶部导航：多级 hover 弹出 + 键盘（shadcn NavigationMenu）
-
-## 典型场景
-
-- 应用模板：admin（examples/apps/ 完整可跑）
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `NavMenuItem[]` | 是 |  |
-| `activeKey` | `string` | 否 |  |
-| `onSelect` | `(key: string) => void` | 否 |  |
-
-## 用法示例
-
-```tsx
-<NavMenu items={items} activeKey="home" onSelect={go} />
-```
-
-## 纪律/坑
-
-> 键盘可达（P1）：方向键导航焦点跟随（roving tabindex）；受控 props 配回调
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：[admin](../apps/admin.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/NavMenu/NavMenu.ts` |
-| 样式 | `src/client/components/NavMenu/NavMenu.css` |
-| 测试 | `src/client/components/NavMenu/NavMenu.test.ts` |
-| demo | `apps/showcase/src/demos/DemoNavMenu.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/navmenu` ——（P1 填充具体步骤）

package/content/components/notification.md

@@ -1,51 +0,0 @@
-# Notification · components
-
-## 概述
-
-队列式通知：notification.success/error/warning 命令式（antd 对齐）
-
-## 典型场景
-
-- 操作反馈/结果页/确认——保存成功、删除确认、空态/加载态
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `NotificationItem[]` | 否 |  |
-| `onRemove` | `(id: string) => void` | 否 |  |
-| `position` | `NotificationPosition` | 否 |  |
-| `duration` | `number` | 否 | 全局默认自动关闭时间（ms），默认 4500 |
-| `max` | `number` | 否 | 最大显示条数，超出移除最早，默认 0 = 不限制 |
-
-## 用法示例
-
-```tsx
-notification.success({
-  title: '部署成功',
-  description: 'v0.63.0 已上线',
-})
-```
-
-## 纪律/坑
-
-> 退场动画（§8）：exit 类必须挂载（animationend 驱动）+ reduced-motion 降级
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Notification/Notification.ts` |
-| 样式 | `src/client/components/Notification/Notification.css` |
-| 测试 | `src/client/components/Notification/Notification.test.ts` |
-| demo | `apps/showcase/src/demos/DemoNotification.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/feedback/notification` ——（P1 填充具体步骤）

package/content/components/pageheader.md

@@ -1,53 +0,0 @@
-# PageHeader · components
-
-## 概述
-
-页面标题栏，支持 sub + 右侧操作区 + display 大标题
-
-## 典型场景
-
-- 页面模式：app-shell、dashboard、list-page、detail-page、settings-page（复制即用蓝本——examples/patterns/）
-- 应用模板：todo（examples/apps/ 完整可跑）
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `title` | `string` | 是 |  |
-| `sub` | `string` | 否 |  |
-| `display` | `boolean` | 否 | 顶级页面大标题（display 档 30px），默认 21px |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<PageHeader title="用户管理" sub="管理平台所有用户的账号、角色与权限">
-  <Button size="sm" variant="primary">新建用户</Button>
-  <Button size="sm">导出</Button>
-</PageHeader>
-<PageHeader display title="大标题模式" />
-```
-
-## 纪律/坑
-
-> 键盘可达（P1）：方向键导航焦点跟随（roving tabindex）；受控 props 配回调
-
-## 关系
-
-- ↑ 用于页面模式：[app-shell](../patterns/app-shell.md) · [dashboard](../patterns/dashboard.md) · [list-page](../patterns/list-page.md) · [detail-page](../patterns/detail-page.md) · [settings-page](../patterns/settings-page.md)
-- ↑ 用于应用：[todo](../apps/todo.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/PageHeader/PageHeader.ts` |
-| 样式 | `src/client/components/PageHeader/PageHeader.css` |
-| 测试 | `src/client/components/PageHeader/PageHeader.test.ts` |
-| demo | `apps/showcase/src/demos/DemoPageHeader.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/pageheader` ——（P1 填充具体步骤）

package/content/components/pagination.md

@@ -1,49 +0,0 @@
-# Pagination · components
-
-## 概述
-
-分页器，自动计算页码范围
-
-## 典型场景
-
-- 页面模式：app-shell、list-page（复制即用蓝本——examples/patterns/）
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `total` | `number` | 是 |  |
-| `page` | `number` | 否 |  |
-| `pageSize` | `number` | 否 |  |
-| `onChange` | `(page: number) => void` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Pagination total={200}
-  page={page} onChange={fn} />
-```
-
-## 纪律/坑
-
-> 键盘可达（P1）：方向键导航焦点跟随（roving tabindex）；受控 props 配回调
-
-## 关系
-
-- ↑ 用于页面模式：[app-shell](../patterns/app-shell.md) · [list-page](../patterns/list-page.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Pagination/Pagination.ts` |
-| 样式 | `src/client/components/Pagination/Pagination.css` |
-| 测试 | `src/client/components/Pagination/Pagination.test.ts` |
-| demo | `apps/showcase/src/demos/DemoPagination.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/pagination` ——（P1 填充具体步骤）

package/content/components/paragraph.md

@@ -1,45 +0,0 @@
-# Paragraph · components
-
-## 概述
-
-段落排版——Typography 家族
-
-## 典型场景
-
-- 页面模式：docs、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) · [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/paragraph` ——（P1 填充具体步骤）

package/content/components/passwordinput.md

@@ -1,57 +0,0 @@
-# PasswordInput · components
-
-## 概述
-
-密码输入：眼睛按钮切换可见性
-
-## 典型场景
-
-- 应用模板：auth（examples/apps/ 完整可跑）
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 否 |  |
-| `onInput` | `(e: Event) => void` | 否 |  |
-| `onChange` | `(e: Event) => void` | 否 |  |
-| `label` | `string` | 否 |  |
-| `name` | `string` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `error` | `string` | 否 |  |
-| `hint` | `string` | 否 |  |
-| `required` | `boolean` | 否 |  |
-| `autoComplete` | `string` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<PasswordInput label="密码" value={pwd} onInput={e => setPwd(e.target.value)} />
-{/* 眼睛按钮切换可见性 */}
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：[auth](../apps/auth.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/PasswordInput/PasswordInput.ts` |
-| 样式 | `src/client/components/PasswordInput/PasswordInput.css` |
-| 测试 | `src/client/components/PasswordInput/PasswordInput.test.ts` |
-| demo | `apps/showcase/src/demos/DemoPasswordInput.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/passwordinput` ——（P1 填充具体步骤）

package/content/components/pininput-v2.md

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

package/content/components/pininput.md

@@ -1,50 +0,0 @@
-# PinInput · components
-
-## 概述
-
-验证码输入：自动聚焦/粘贴分派/Backspace 回退（shadcn InputOTP）
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `length` | `number` | 否 | 位数，默认 6 |
-| `value` | `string` | 否 | 受控完整值（如 '483920'） |
-| `onChange` | `(value: string) => void` | 否 |  |
-| `type` | `'number' \| 'text'` | 否 | number = 纯数字（默认）；text = 任意字符 |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-
-## 用法示例
-
-```tsx
-<PinInput length={6} value={code}
-  onChange={setCode} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/PinInput/PinInput.ts` |
-| 样式 | `src/client/components/PinInput/PinInput.css` |
-| 测试 | `src/client/components/PinInput/PinInput.test.ts` |
-| demo | `apps/showcase/src/demos/DemoPinInput.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/pininput` ——（P1 填充具体步骤）

package/content/components/pipeline.md

@@ -1,49 +0,0 @@
-# Pipeline · components
-
-## 概述
-
-Agent 工作流 DAG：分层布局 + 贝塞尔连线 + 状态语义色 + 环检测
-
-## 典型场景
-
-- AI 对话/工具调用/审批/提示词——agent 场景全链路
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `nodes` | `PipelineNode[]` | 是 |  |
-| `edges` | `PipelineEdge[]` | 是 |  |
-| `orientation` | `'vertical' \| 'horizontal'` | 否 | 布局方向（默认 vertical：输入在左→输出在右） |
-| `width` | `number` | 否 |  |
-| `height` | `number` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Pipeline orientation="horizontal" nodes={[{ id: 'a', label: '输入' }]} edges={[]} />
-```
-
-## 纪律/坑
-
-> AI 协议纪律：消息流事件驱动（useChat 订阅）——高频 notify 由写者控制频率
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Pipeline/Pipeline.ts` |
-| 样式 | `src/client/components/Pipeline/Pipeline.css` |
-| 测试 | `src/client/components/Pipeline/Pipeline.test.ts` |
-| demo | `apps/showcase/src/demos/DemoPipeline.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/ai/pipeline` ——（P1 填充具体步骤）

package/content/components/popconfirm.md

@@ -1,58 +0,0 @@
-# Popconfirm · components
-
-## 概述
-
-气泡确认：危险操作防误触 + 复用 usePopup 基座
-
-## 典型场景
-
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `title` | `any` | 否 |  |
-| `okText` | `string` | 否 |  |
-| `cancelText` | `string` | 否 |  |
-| `okType` | `'primary' \| 'danger'` | 否 |  |
-| `danger` | `boolean` | 否 | 危险确认（默认图标换 warning 色 + 确认按钮 danger） |
-| `onConfirm` | `() => void` | 否 |  |
-| `onCancel` | `() => void` | 否 |  |
-| `position` | `Placement` | 否 |  |
-| `open` | `boolean` | 否 |  |
-| `onOpenChange` | `(open: boolean) => void` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `icon` | `any` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Popconfirm title="确定删除？" danger onConfirm={del}>
-  <Button variant="danger">删除</Button>
-</Popconfirm>
-```
-
-## 纪律/坑
-
-- 气泡内表单/自定义箭头已裁剪（Popover 基座 + 定位全套复用）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Popconfirm/Popconfirm.ts` |
-| 样式 | `src/client/components/Popconfirm/Popconfirm.css` |
-| 测试 | `src/client/components/Popconfirm/Popconfirm.test.ts` |
-| demo | `apps/showcase/src/demos/DemoPopconfirm.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/popconfirm` ——（P1 填充具体步骤）

package/content/components/popover.md

@@ -1,61 +0,0 @@
-# Popover · components
-
-## 概述
-
-通用弹出层，click/hover 触发，4 方向
-
-## 典型场景
-
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `content` | `any` | 否 |  |
-| `trigger` | `'click' \| 'hover'` | 否 |  |
-| `position` | `PopoverPosition` | 否 |  |
-| `open` | `boolean` | 否 |  |
-| `onOpenChange` | `(open: boolean) => void` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Popover content={<div>面板内容</div>}>
-  <Button>点击弹出</Button>
-</Popover>
-
-<Popover position="top" content=...>
-  <Button>顶部</Button>
-</Popover>
-
-<Popover trigger="hover" content=...>
-  <span>悬停查看</span>
-</Popover>
-```
-
-## 纪律/坑
-
-- portal 槽豁免（同 HoverCard）
-- 富内容自动判定已裁剪——HoverCard 补富内容（components-cuts.md）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Popover/Popover.ts` |
-| 样式 | `src/client/components/Popover/Popover.css` |
-| 测试 | `src/client/components/Popover/Popover.test.ts` |
-| demo | `apps/showcase/src/demos/DemoPopover.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/popover` ——（P1 填充具体步骤）

package/content/components/progressbar.md

@@ -1,50 +0,0 @@
-# ProgressBar · components
-
-## 概述
-
-进度条，支持 label/showValue
-
-## 典型场景
-
-- 页面模式：dashboard（复制即用蓝本——examples/patterns/）
-- 操作反馈/结果页/确认——保存成功、删除确认、空态/加载态
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `number` | 否 | 进度值；undefined = indeterminate（不确定态，动画扫动） |
-| `max` | `number` | 否 |  |
-| `label` | `string` | 否 |  |
-| `showValue` | `boolean` | 否 |  |
-| `status` | `'default' \| 'success' \| 'error' \| 'warning'` | 否 | 状态色（default/success/error/warning） |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 | 尺寸 |
-
-## 用法示例
-
-```tsx
-<ProgressBar value={75} label="进度" showValue />
-```
-
-## 纪律/坑
-
-> 退场动画（§8）：exit 类必须挂载（animationend 驱动）+ reduced-motion 降级
-
-## 关系
-
-- ↑ 用于页面模式：[dashboard](../patterns/dashboard.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ProgressBar/ProgressBar.ts` |
-| 样式 | `src/client/components/ProgressBar/ProgressBar.css` |
-| 测试 | `src/client/components/ProgressBar/ProgressBar.test.ts` |
-| demo | `apps/showcase/src/demos/DemoProgress.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/feedback/progressbar` ——（P1 填充具体步骤）

package/content/components/prompttemplate.md

@@ -1,49 +0,0 @@
-# PromptTemplate · components
-
-## 概述
-
-提示词模板编辑器——变量 chips 插入 + 实时预览填充（AI 场景痛点）
-
-## 典型场景
-
-- AI 对话/工具调用/审批/提示词——agent 场景全链路
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 否 | 模板文本（受控） |
-| `onChange` | `(value: string) => void` | 否 |  |
-| `variables` | `PromptTemplateVariable[]` | 否 | 变量定义（chips 行——点击插入） |
-| `values` | `Record<string, string>` | 否 | 变量值（预览填充用——缺失的变量保持占位） |
-| `readOnly` | `boolean` | 否 | 只读（预览场景） |
-| `label` | `string` | 否 |  |
-| `showPreview` | `boolean` | 否 | 预览区显示开关（默认开） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-- textarea value 必须走 property（attribute 只是 defaultValue——DOM value 恒空/光标失效事故，vdom3 渲染器已修）
-- 受控输入纪律：value 由父控制 + onChange 通知
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/PromptTemplate/PromptTemplate.ts` |
-| 样式 | `src/client/components/PromptTemplate/PromptTemplate.css` |
-| 测试 | `src/client/components/PromptTemplate/PromptTemplate.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/ai/prompttemplate` ——（P1 填充具体步骤）