weifuwu 0.87.0 → 0.89.0

package/content/components/chart.md

@@ -1,53 +0,0 @@
-# Chart · components
-
-## 概述
-
-SVG 图表：line/bar/pie/radar/gauge/scatter——零依赖自绘
-
-## 典型场景
-
-- 应用模板：admin（examples/apps/ 完整可跑）
-- 数据看板/统计报表——指标卡、图表、趋势
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `type` | `ChartType` | 否 |  |
-| `data` | `DataPoint[]` | 是 |  |
-| `options` | `ChartOptions` | 否 |  |
-| `title` | `string` | 否 |  |
-| `area` | `boolean` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Chart type="line" data={data} title="标题" />
-<Chart type="bar" data={data} />
-<Chart type="pie" data={data} />
-
-```
-
-## 纪律/坑
-
-> 图表自研 SVG：数据点 label 为轴名；交互 tooltip 经 usePopup（视口夹紧）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：[admin](../apps/admin.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Chart/Chart.ts` |
-| 样式 | `src/client/components/Chart/Chart.css` |
-| 测试 | `src/client/components/Chart/Chart.test.ts` |
-| demo | `apps/showcase/src/demos/DemoChart.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/viz/chart` ——（P1 填充具体步骤）

package/content/components/chatinput.md

@@ -1,63 +0,0 @@
-# ChatInput · components
-
-## 概述
-
-独立聊天输入条（AiChat 抽取）：单行/多行 + streaming 停止 + IME 安全——不自带聊天逻辑
-
-## 典型场景
-
-- AI 对话/工具调用/审批/提示词——agent 场景全链路
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 是 | 受控值（共享输入态——ChatInput 不持有聊天逻辑） |
-| `onChange` | `(v: string) => void` | 是 | 值变化（IME 安全：组合期间不触发） |
-| `onSend` | `(text: string) => void` | 是 | 发送（Enter 或按钮）——入参为当前输入文本（trim 后非空才触发） |
-| `streaming` | `boolean` | 否 | 流式状态——true 时按钮变「停止」 |
-| `onStop` | `() => void` | 否 | 停止回调（streaming 时按钮触发） |
-| `error` | `string \| null` | 否 | 错误——非流式时显示「重试」按钮 |
-| `onRetry` | `() => void` | 否 | 重试回调 |
-| `disabled` | `boolean` | 否 | 禁用（输入 + 按钮） |
-| `multiline` | `boolean` | 否 | 多行 textarea（Enter 发送 / Shift+Enter 换行）；默认 false = 单行 input |
-| `labels` | `Partial<ChatInputLabels>` | 否 | 标签（i18n 覆盖） |
-| `actions` | `VNode \| null` | 否 | 扩展位（附件/知识库/模型选择等） |
-| `onControl` | `(handle: ChatInputControl) => void` | 否 | 外部程序化控制（@ 补全等场景）——mount 期回调上抛稳定 handle（{ setKeyword, setValue }）—— |
-
-## 用法示例
-
-```tsx
-<ChatInput value={input} onChange={v => input = v}
-  onSend={text => send(text)}      // 回车/按钮触发（trim 后非空）
-  streaming={streaming}            // 流式 → 按钮变「停止」
-  onStop={() => stop()}
-  multiline                         // 多行 textarea（Shift+Enter 换行）
-  actions={<button>附件</button>}  // 扩展位插槽
-/>
-
-// 纯输入层：不自带聊天逻辑（useChat 组合在消费方）
-```
-
-## 纪律/坑
-
-> AI 协议纪律：消息流事件驱动（useChat 订阅）——高频 notify 由写者控制频率
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ChatInput/ChatInput.ts` |
-| 样式 | `src/client/components/ChatInput/ChatInput.css` |
-| 测试 | `src/client/components/ChatInput/ChatInput.test.ts` |
-| demo | `apps/showcase/src/demos/DemoChatInput.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/ai/chatinput` ——（P1 填充具体步骤）

package/content/components/checkbox.md

@@ -1,51 +0,0 @@
-# Checkbox · components
-
-## 概述
-
-带 label 的复选框，支持 checked/disabled
-
-## 典型场景
-
-- 页面模式：focus-task（复制即用蓝本——examples/patterns/）
-- 应用模板：todo（examples/apps/ 完整可跑）
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `label` | `string` | 否 |  |
-| `checked` | `boolean` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `onChange` | `(checked: boolean) => void` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Checkbox label="同意"
-  checked={agree}
-  onChange={v => agree = v} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：[focus-task](../patterns/focus-task.md)
-- ↑ 用于应用：[todo](../apps/todo.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Checkbox/Checkbox.ts` |
-| 样式 | `src/client/components/Checkbox/Checkbox.css` |
-| 测试 | `src/client/components/Checkbox/Checkbox.test.ts` |
-| demo | `apps/showcase/src/demos/DemoCheckbox.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/checkbox` ——（P1 填充具体步骤）

package/content/components/checkboxgroup.md

@@ -1,52 +0,0 @@
-# CheckboxGroup · components
-
-## 概述
-
-复选框组：数组受控 + 栅格列数（antd Checkbox.Group）
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `options` | `CheckboxGroupOption[]` | 否 |  |
-| `value` | `string[]` | 否 | 受控选中值 |
-| `onChange` | `(value: string[]) => void` | 否 |  |
-| `columns` | `1 \| 2 \| 3 \| 4` | 否 | 栅格列数（1-4） |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `label` | `string` | 否 | 组标题（可选） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<CheckboxGroup options={[{value:'a',label:'A'}]}
-  value={selected} onChange={setSelected} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/CheckboxGroup/CheckboxGroup.ts` |
-| 样式 | `src/client/components/CheckboxGroup/CheckboxGroup.css` |
-| 测试 | `src/client/components/CheckboxGroup/CheckboxGroup.test.ts` |
-| demo | `apps/showcase/src/demos/DemoCheckboxGroup.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/checkboxgroup` ——（P1 填充具体步骤）

package/content/components/citationcard.md

@@ -1,48 +0,0 @@
-# CitationCard · components
-
-## 概述
-
-RAG 引用来源：折叠「引用 N 条」+ 条目列表（序号/标题/来源/片段/链接）+ 溢出 +N
-
-## 典型场景
-
-- AI 对话/工具调用/审批/提示词——agent 场景全链路
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `Citation[]` | 是 |  |
-| `label` | `string` | 否 | 折叠头文案（默认「引用来源」） |
-| `maxVisible` | `number` | 否 | 折叠时最多显示条数（默认 3；溢出显示 +N 汇总条目） |
-| `defaultExpanded` | `boolean` | 否 | 初始展开（默认折叠） |
-| `onOpen` | `(citation: Citation) => void` | 否 | 点击条目回调（提供时不渲染链接，由调用方处理跳转/打开） |
-
-## 用法示例
-
-```tsx
-<CitationCard items={[{ id, title, source, snippet, url }]} maxVisible={3} />
-```
-
-## 纪律/坑
-
-> AI 协议纪律：消息流事件驱动（useChat 订阅）——高频 notify 由写者控制频率
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/CitationCard/CitationCard.ts` |
-| 样式 | `src/client/components/CitationCard/CitationCard.css` |
-| 测试 | `src/client/components/CitationCard/CitationCard.test.ts` |
-| demo | `apps/showcase/src/demos/DemoCitationCard.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/ai/citationcard` ——（P1 填充具体步骤）

package/content/components/codeblock.md

@@ -1,48 +0,0 @@
-# CodeBlock · components
-
-## 概述
-
-代码块：语言标签 + 复制按钮 + 横向滚动
-
-## 典型场景
-
-- 页面模式：workspace、docs（复制即用蓝本——examples/patterns/）
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `code` | `string` | 是 |  |
-| `lang` | `string` | 否 |  |
-| `title` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<CodeBlock lang="ts" title="示例.ts" code={...} />
-{/* 复制按钮 + 语言标签 + 横向滚动 */}
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：[workspace](../patterns/workspace.md) · [docs](../patterns/docs.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/CodeBlock/CodeBlock.ts` |
-| 样式 | `src/client/components/CodeBlock/CodeBlock.css` |
-| 测试 | `src/client/components/CodeBlock/CodeBlock.test.ts` |
-| demo | `apps/showcase/src/demos/DemoCodeBlock.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/codeblock` ——（P1 填充具体步骤）

package/content/components/codeeditor.md

@@ -1,47 +0,0 @@
-# CodeEditor · components
-
-## 概述
-
-轻量代码编辑器——textarea + 行号 + Tab 缩进（零依赖，不引 Monaco）
-
-## 典型场景
-
-- office 文档/代码/内容编辑——xlsx/pptx/代码/公式/裁剪
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 是 |  |
-| `onChange` | `(value: string) => void` | 否 |  |
-| `lang` | `'ts' \| 'tsx' \| 'js' \| 'css' \| 'json' \| 'md' \| 'text'` | 否 |  |
-| `rows` | `number` | 否 |  |
-| `readOnly` | `boolean` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 内容编辑：textarea value 走 property（attribute 只是 defaultValue）；受控输入纪律
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/CodeEditor/CodeEditor.ts` |
-| 样式 | `src/client/components/CodeEditor/CodeEditor.css` |
-| 测试 | `src/client/components/CodeEditor/CodeEditor.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/editor/codeeditor` ——（P1 填充具体步骤）

package/content/components/collapse.md

@@ -1,49 +0,0 @@
-# Collapse · components
-
-## 概述
-
-行内折叠：异步 loading + extra 操作区（区别于 Accordion）
-
-## 典型场景
-
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `CollapseItem[]` | 否 |  |
-| `active` | `string[]` | 否 | 受控展开 keys |
-| `onChange` | `(keys: string[]) => void` | 否 |  |
-| `multiple` | `boolean` | 否 | false = 手风琴互斥（同一时间只开一个）；默认 true 多开 |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Collapse items={[{key:'1',title:'标题',content:'内容',loading}]}
-  active={['1']} />
-```
-
-## 纪律/坑
-
-- 受控纪律（§5.2）：受控 activeKeys 必须配回调——缺回调静默不可点（console.warn 防护）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Collapse/Collapse.ts` |
-| 样式 | `src/client/components/Collapse/Collapse.css` |
-| 测试 | `src/client/components/Collapse/Collapse.test.ts` |
-| demo | `apps/showcase/src/demos/DemoCollapse.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/collapse` ——（P1 填充具体步骤）

package/content/components/colorpicker.md

@@ -1,50 +0,0 @@
-# ColorPicker · components
-
-## 概述
-
-颜色选择：预设色板 + hex 输入（Popover 弹层）
-
-## 典型场景
-
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 否 | 受控颜色值（hex，如 #4f6ef7） |
-| `onChange` | `(value: string) => void` | 否 |  |
-| `colors` | `string[]` | 否 | 预设色板（默认内置 10 色） |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `showInput` | `boolean` | 否 | 显示 hex 输入框（自由输入） |
-
-## 用法示例
-
-```tsx
-<ColorPicker value={color} showInput
-  onChange={setColor} />
-```
-
-## 纪律/坑
-
-> 弹窗纪律（§5.4）：浮层必须 createPortal 渲染（#__wf_portal）——禁 absolute 相对父容器（overflow/transform 裁剪）；统一走 ctx.ui.usePopup
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ColorPicker/ColorPicker.ts` |
-| 样式 | `src/client/components/ColorPicker/ColorPicker.css` |
-| 测试 | `src/client/components/ColorPicker/ColorPicker.test.ts` |
-| demo | `apps/showcase/src/demos/DemoColorPicker.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/colorpicker` ——（P1 填充具体步骤）

package/content/components/command.md

@@ -1,50 +0,0 @@
-# Command · components
-
-## 概述
-
-命令面板：⌘K 全局快捷键 + 键盘流（shadcn Command）
-
-## 典型场景
-
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `open` | `boolean` | 否 |  |
-| `onOpenChange` | `(open: boolean) => void` | 否 |  |
-| `items` | `CommandItem[]` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `emptyText` | `string` | 否 |  |
-| `globalShortcut` | `string \| null` | 否 | 全局快捷键，如 'mod+k'（cmd/ctrl + k）；null 关闭全局监听 |
-
-## 用法示例
-
-```tsx
-<Command items={items} open={open}
-  onOpenChange={setOpen} />
-```
-
-## 纪律/坑
-
-> 弹窗纪律（§5.4）：浮层必须 createPortal 渲染（#__wf_portal）——禁 absolute 相对父容器（overflow/transform 裁剪）；统一走 ctx.ui.usePopup
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Command/Command.ts` |
-| 样式 | `src/client/components/Command/Command.css` |
-| 测试 | `src/client/components/Command/Command.test.ts` |
-| demo | `apps/showcase/src/demos/DemoCommand.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/command` ——（P1 填充具体步骤）

package/content/components/confirm.md

@@ -1,57 +0,0 @@
-# Confirm · components
-
-## 概述
-
-确认对话框，Promise 化 await 调用
-
-## 典型场景
-
-- 操作反馈/结果页/确认——保存成功、删除确认、空态/加载态
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `open` | `boolean` | 否 |  |
-| `title` | `string` | 否 |  |
-| `message` | `any` | 否 | 提示内容（文本或任意 VNode） |
-| `confirmText` | `string` | 否 |  |
-| `cancelText` | `string` | 否 |  |
-| `variant` | `'primary' \| 'danger'` | 否 |  |
-| `width` | `string` | 否 | 对话框宽度，如 '500px'、'80%'，默认 Modal 的 400px |
-| `maskClosable` | `boolean` | 否 | 遮罩点击是否取消（默认 false：危险操作防误触；显式传 true 可恢复） |
-| `onConfirm` | `() => void` | 否 |  |
-| `onCancel` | `() => void` | 否 |  |
-| `onClose` | `() => void` | 否 | Modal 关闭回调（Escape/遮罩——onCancel 缺省时兜底——命令式兼容） |
-
-## 用法示例
-
-```tsx
-const ok = await ctx.confirm?.('确定删除？', {
-  confirmText: '删除',
-  variant: 'danger',
-})
-if (ok) { /* 执行 */ }
-```
-
-## 纪律/坑
-
-> 退场动画（§8）：exit 类必须挂载（animationend 驱动）+ reduced-motion 降级
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Confirm/Confirm.ts` |
-| 测试 | `src/client/components/Confirm/Confirm.test.ts` |
-| demo | `apps/showcase/src/demos/DemoConfirm.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/feedback/confirm` ——（P1 填充具体步骤）

package/content/components/contextmenu.md

@@ -1,48 +0,0 @@
-# ContextMenu · components
-
-## 概述
-
-右键菜单：光标定位 + 方向键 + danger 变体（shadcn）
-
-## 典型场景
-
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `ContextMenuItem[]` | 否 |  |
-| `children` | `any` | 是 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<ContextMenu items={[{key:'edit',label:'编辑'}]}>
-  <div>右键区域</div>
-</ContextMenu>
-```
-
-## 纪律/坑
-
-- portal 槽豁免；右键 + 触屏长按双通道
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ContextMenu/ContextMenu.ts` |
-| 样式 | `src/client/components/ContextMenu/ContextMenu.css` |
-| 测试 | `src/client/components/ContextMenu/ContextMenu.test.ts` |
-| demo | `apps/showcase/src/demos/DemoContextMenu.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/contextmenu` ——（P1 填充具体步骤）

package/content/components/copybutton.md

@@ -1,51 +0,0 @@
-# CopyButton · components
-
-## 概述
-
-复制按钮：clipboard + execCommand 降级 + 成功状态机
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 是 | 要复制的文本 |
-| `label` | `string` | 否 | 按钮文字（默认仅图标） |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-| `variant` | `'ghost' \| 'secondary' \| 'default'` | 否 |  |
-| `iconOnly` | `boolean` | 否 | 仅图标（无文字） |
-| `successText` | `string` | 否 | 成功提示文字（默认「已复制」） |
-| `onCopied` | `() => void` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<CopyButton value="https://..." label="复制" />
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/CopyButton/CopyButton.ts` |
-| 样式 | `src/client/components/CopyButton/CopyButton.css` |
-| 测试 | `src/client/components/CopyButton/CopyButton.test.ts` |
-| demo | `apps/showcase/src/demos/DemoCopyButton.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/copybutton` ——（P1 填充具体步骤）