weifuwu 0.87.0 → 0.89.0

package/content/components/qrcode.md

@@ -1,50 +0,0 @@
-# QRCode · components
-
-## 概述
-
-二维码：自研 QR 编码（Reed-Solomon + 8 掩码）零依赖 SVG
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 是 | 二维码内容（URL/文本） |
-| `ecLevel` | `QrEcLevel` | 否 | 纠错级别，默认 M |
-| `size` | `number` | 否 | 渲染尺寸（px），默认 128 |
-| `quietZone` | `number` | 否 | 静默区模块数，默认 4 |
-| `color` | `string` | 否 | 模块颜色，默认 currentColor |
-| `bgColor` | `string` | 否 | 背景色（填充静默区），默认 transparent |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<QRCode value="https://weifuwu.dev" size={128} />
-<QRCode value="..." color="#4f6ef7" />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/QRCode/QRCode.ts` |
-| 测试 | `src/client/components/QRCode/QRCode.test.ts` |
-| demo | `apps/showcase/src/demos/DemoQRCode.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/qrcode` ——（P1 填充具体步骤）

package/content/components/radiogroup.md

@@ -1,53 +0,0 @@
-# RadioGroup · components
-
-## 概述
-
-单选组，支持 inline/options/value
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `name` | `string` | 否 |  |
-| `value` | `string` | 否 |  |
-| `options` | `RadioOption[]` | 否 |  |
-| `inline` | `boolean` | 否 |  |
-| `onChange` | `(value: string) => void` | 否 |  |
-
-## 用法示例
-
-```tsx
-<RadioGroup name="gender"
-  value={gender}
-  onChange={v => gender = v}
-  options={[
-    {value:'male',label:'男'},
-  ]} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/RadioGroup/RadioGroup.ts` |
-| 样式 | `src/client/components/RadioGroup/RadioGroup.css` |
-| 测试 | `src/client/components/RadioGroup/RadioGroup.test.ts` |
-| demo | `apps/showcase/src/demos/DemoRadio.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/radiogroup` ——（P1 填充具体步骤）

package/content/components/rate.md

@@ -1,53 +0,0 @@
-# Rate · components
-
-## 概述
-
-评分：键盘方向键 / allowClear / readOnly，新增 star 图标
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `number` | 否 | 当前评分值（0..count） |
-| `onChange` | `(value: number) => void` | 否 |  |
-| `count` | `number` | 否 | 星星总数，默认 5 |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-| `readOnly` | `boolean` | 否 | 只读（展示态，不可交互、不可聚焦） |
-| `disabled` | `boolean` | 否 |  |
-| `allowClear` | `boolean` | 否 | 点击当前评分值 → 清除为 0（antd 对齐） |
-| `allowHalf` | `boolean` | 否 | 允许半星（0.5 精度；点击左半=半星，右半=整星） |
-
-## 用法示例
-
-```tsx
-<Rate value={3} onChange={setRate} />
-<Rate value={4} readOnly />
-<Rate size="lg" allowClear />
-```
-
-## 纪律/坑
-
-- 小尺寸 button 固定 min/max-height（§5.6）：星 16x36 竖条事故
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Rate/Rate.ts` |
-| 样式 | `src/client/components/Rate/Rate.css` |
-| 测试 | `src/client/components/Rate/Rate.test.ts` |
-| demo | `apps/showcase/src/demos/DemoRate.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/rate` ——（P1 填充具体步骤）

package/content/components/reasoningblock.md

@@ -1,47 +0,0 @@
-# ReasoningBlock · components
-
-## 概述
-
-CoT 推理折叠展示：aria-expanded + 键盘可达 + 流式脉冲（thinking 模式 reasoning_content）
-
-## 典型场景
-
-- AI 对话/工具调用/审批/提示词——agent 场景全链路
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `content` | `string` | 是 | 推理文本（reasoning_content） |
-| `defaultExpanded` | `boolean` | 否 | 初始展开（默认折叠） |
-| `label` | `string` | 否 | 折叠头部文案（默认「已思考」） |
-| `streaming` | `boolean` | 否 | 流式中（头部脉冲指示） |
-
-## 用法示例
-
-```tsx
-<ReasoningBlock content={reasoningText} />
-```
-
-## 纪律/坑
-
-> AI 协议纪律：消息流事件驱动（useChat 订阅）——高频 notify 由写者控制频率
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ReasoningBlock/ReasoningBlock.ts` |
-| 样式 | `src/client/components/ReasoningBlock/ReasoningBlock.css` |
-| 测试 | `src/client/components/ReasoningBlock/ReasoningBlock.test.ts` |
-| demo | `apps/showcase/src/demos/DemoReasoningBlock.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/ai/reasoningblock` ——（P1 填充具体步骤）

package/content/components/relationgraph.md

@@ -1,52 +0,0 @@
-# RelationGraph · components
-
-## 概述
-
-关系图谱——环形/网格布局 + 类型着色 + 选中交互（人物/组织/网络）
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `nodes` | `RelationGraphNode[]` | 是 |  |
-| `edges` | `RelationGraphEdge[]` | 是 |  |
-| `selectedId` | `string \| null` | 否 | 选中节点 id（受控） |
-| `onSelect` | `(id: string) => void` | 否 | 节点点击（选中态切换——父层管理） |
-| `onNodeClick` | `(id: string) => void` | 否 | 节点双击/单独动作（如打开 agent 档案——可选） |
-| `layout` | `'ring' \| 'grid'` | 否 | 布局：ring（环形——网状关系）| grid（网格——组织/矩阵）——默认 ring |
-| `width` | `string` | 否 |  |
-| `height` | `string` | 否 |  |
-| `showLegend` | `boolean` | 否 | 关系图例（type → 颜色映射） |
-| `nodeColors` | `Record<string, string>` | 否 | 类型颜色覆盖（kind → 色值） |
-| `edgeColors` | `Record<string, string>` | 否 | 关系类型颜色覆盖（edge type → 色值） |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/RelationGraph/RelationGraph.ts` |
-| 样式 | `src/client/components/RelationGraph/RelationGraph.css` |
-| 测试 | `src/client/components/RelationGraph/RelationGraph.test.ts` |
-| demo | `apps/showcase/src/demos/DemoRelationGraph.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/relationgraph` ——（P1 填充具体步骤）

package/content/components/resizable.md

@@ -1,53 +0,0 @@
-# Resizable · components
-
-## 概述
-
-拖拽分割面板：pointer + 键盘方向键 + clamp（shadcn）
-
-## 典型场景
-
-- 大数据列表/表格/树——千级+数据量的性能场景
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `direction` | `'horizontal' \| 'vertical'` | 否 | horizontal 左右分割（默认）/ vertical 上下分割 |
-| `defaultSize` | `number` | 否 | 第一面板初始尺寸（px） |
-| `min` | `number` | 否 | 最小尺寸（px），默认 80 |
-| `max` | `number` | 否 | 最大尺寸（px），默认 80% 视口 |
-| `step` | `number` | 否 | 键盘步进（px），默认 20 |
-| `children` | `[any, any]` | 是 |  |
-| `onResize` | `(size: number) => void` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Resizable defaultSize={180}>
-  {[<PaneA />, <PaneB />]}
-</Resizable>
-```
-
-## 纪律/坑
-
-> 大数据渲染：固定行高 + 窗口化（VirtualList）——动态高度裁剪登记
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Resizable/Resizable.ts` |
-| 样式 | `src/client/components/Resizable/Resizable.css` |
-| 测试 | `src/client/components/Resizable/Resizable.test.ts` |
-| demo | `apps/showcase/src/demos/DemoResizable.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/virtual/resizable` ——（P1 填充具体步骤）

package/content/components/result.md

@@ -1,49 +0,0 @@
-# Result · components
-
-## 概述
-
-结果页：success/error/warning/info + extra 操作区
-
-## 典型场景
-
-- 操作反馈/结果页/确认——保存成功、删除确认、空态/加载态
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `status` | `ResultStatus` | 否 |  |
-| `title` | `any` | 是 |  |
-| `desc` | `any` | 否 |  |
-| `extra` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Result status="success" title="注册成功" desc="…"
-  extra={<Button variant="primary">进入工作台</Button>} />
-```
-
-## 纪律/坑
-
-> 退场动画（§8）：exit 类必须挂载（animationend 驱动）+ reduced-motion 降级
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Result/Result.ts` |
-| 样式 | `src/client/components/Result/Result.css` |
-| 测试 | `src/client/components/Result/Result.test.ts` |
-| demo | `apps/showcase/src/demos/DemoResult.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/feedback/result` ——（P1 填充具体步骤）

package/content/components/scrollbar.md

@@ -1,49 +0,0 @@
-# Scrollbar · components
-
-## 概述
-
-自定义滚动容器：webkit 样式 + hover 显示
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `maxHeight` | `number \| string` | 否 |  |
-| `height` | `number \| string` | 否 |  |
-| `orientation` | `'vertical' \| 'horizontal'` | 否 |  |
-| `always` | `boolean` | 否 | 常显滚动条（默认 hover 显示） |
-| `children` | `any` | 否 |  |
-| `style` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Scrollbar maxHeight={120}>长内容</Scrollbar>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Scrollbar/Scrollbar.ts` |
-| 样式 | `src/client/components/Scrollbar/Scrollbar.css` |
-| 测试 | `src/client/components/Scrollbar/Scrollbar.test.ts` |
-| demo | `apps/showcase/src/demos/DemoScrollbar.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/scrollbar` ——（P1 填充具体步骤）

package/content/components/searchinput.md

@@ -1,51 +0,0 @@
-# SearchInput · components
-
-## 概述
-
-搜索输入框，带清除按钮
-
-## 典型场景
-
-- 页面模式：mobile、list-page（复制即用蓝本——examples/patterns/）
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `onInput` | `(e: Event) => void` | 否 |  |
-| `onClear` | `() => void` | 否 |  |
-
-## 用法示例
-
-```tsx
-<SearchInput value={query}
-  onInput={e => query = e.target.value}
-  onClear={() => query = ''} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：[mobile](../patterns/mobile.md) · [list-page](../patterns/list-page.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/SearchInput/SearchInput.ts` |
-| 样式 | `src/client/components/SearchInput/SearchInput.css` |
-| 测试 | `src/client/components/SearchInput/SearchInput.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSearchInput.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/searchinput` ——（P1 填充具体步骤）

package/content/components/segmentedcontrol.md

@@ -1,59 +0,0 @@
-# SegmentedControl · components
-
-## 概述
-
-分段单选（模式切换/筛选/模板），支持 sm/block
-
-## 典型场景
-
-- 页面模式：dashboard（复制即用蓝本——examples/patterns/）
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `options` | `SegmentedOption[]` | 是 | 选项列表（label 可为字符串或任意 VNode） |
-| `value` | `string` | 否 | 当前选中值 |
-| `onChange` | `(value: string) => void` | 否 |  |
-| `size` | `'sm' \| 'md'` | 否 |  |
-| `block` | `boolean` | 否 | 撑满父容器宽度（选项等分） |
-| `ariaLabel` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<SegmentedControl
-  value={mode}
-  onChange={v => mode = v}
-  options={[
-    {value:'ai', label:'🤖 AI 生成'},
-    {value:'manual', label:'手动编写'},
-    {value:'template', label:'模板'},
-  ]} />
-{/* size="sm" 小尺寸 / block 等分 */}
-<SegmentedControl size="sm" block ... />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：[dashboard](../patterns/dashboard.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/SegmentedControl/SegmentedControl.ts` |
-| 样式 | `src/client/components/SegmentedControl/SegmentedControl.css` |
-| 测试 | `src/client/components/SegmentedControl/SegmentedControl.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSegmented.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/segmentedcontrol` ——（P1 填充具体步骤）

package/content/components/select-searchable.md

@@ -1,47 +0,0 @@
-# Select (searchable) · components
-
-## 概述
-
-搜索过滤下拉，输入即搜
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<Select label="角色" value={role}
-  onChange={v => role = v}
-  options={[
-    {value:'admin',label:'管理员'},
-  ]} />
-{/* searchable 搜索过滤 */}
-<Select searchable
-  options={options}
-  onChange={v => setVal(v)} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoSearchableSelect.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/select-searchable` ——（P1 填充具体步骤）

package/content/components/select.md

@@ -1,66 +0,0 @@
-# Select · components
-
-## 概述
-
-原生下拉选择器
-
-## 典型场景
-
-- 页面模式：settings-page（复制即用蓝本——examples/patterns/）
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `label` | `string` | 否 |  |
-| `value` | `string \| string[]` | 否 |  |
-| `options` | `SelectOptions` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `required` | `boolean` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `error` | `string` | 否 |  |
-| `onChange` | `(value: string \| string[]) => void` | 否 |  |
-| `children` | `any` | 否 |  |
-| `searchable` | `boolean` | 否 | 启用搜索过滤 |
-| `multiple` | `boolean` | 否 | 多选模式（searchable 下生效；value/onChange 为数组） |
-| `onSearch` | `(keyword: string) => SelectOption[] \| Promise<SelectOption[]>` | 否 | 异步搜索回调，返回值作为新选项列表 |
-
-## 用法示例
-
-```tsx
-<Select label="角色" value={role}
-  onChange={v => role = v}
-  options={[
-    {value:'admin',label:'管理员'},
-  ]} />
-{/* searchable 搜索过滤 */}
-<Select searchable
-  options={options}
-  onChange={v => setVal(v)} />
-```
-
-## 纪律/坑
-
-- 受控输入纪律：searchable 输入焦点丢失——useControlledInput 内部态
-- 事件 prop 判定：on+大写（EVENT_RE）——once/only 等 on 开头属性防误判
-- 浮层必须 portal（§5.4）——absolute 相对父容器在 overflow 下裁剪
-
-## 关系
-
-- ↑ 用于页面模式：[settings-page](../patterns/settings-page.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Select/Select.ts` |
-| 样式 | `src/client/components/Select/Select.css` |
-| 测试 | `src/client/components/Select/Select.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSelect.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/select` ——（P1 填充具体步骤）

package/content/components/sessionlist.md

@@ -1,52 +0,0 @@
-# SessionList · components
-
-## 概述
-
-会话管理列表：分组（今天/昨天/更早）+ 搜索 + 选中 + 重命名/删除/新建 + 键盘导航
-
-## 典型场景
-
-- AI 对话/工具调用/审批/提示词——agent 场景全链路
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `sessions` | `Session[]` | 是 |  |
-| `activeId` | `string` | 否 | 当前选中会话 id（高亮 + aria-selected） |
-| `onSelect` | `(id: string) => void` | 否 | 点击会话（键盘 Enter 同） |
-| `onNew` | `() => void` | 否 | 新建按钮（渲染条件：onNew 提供） |
-| `onRename` | `(id: string, title: string) => void` | 否 | 重命名（行内编辑 Enter 确认） |
-| `onDelete` | `(id: string) => void` | 否 | 删除（行内悬停按钮） |
-| `searchable` | `boolean` | 否 | 顶部搜索框（按标题过滤） |
-| `newLabel` | `string` | 否 | 新建按钮文案（默认「新建会话」） |
-
-## 用法示例
-
-```tsx
-<SessionList sessions={sessions} activeId={cur} searchable
-  onSelect={setCur} onNew={create} onRename={rename} onDelete={remove} />
-```
-
-## 纪律/坑
-
-> AI 协议纪律：消息流事件驱动（useChat 订阅）——高频 notify 由写者控制频率
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/SessionList/SessionList.ts` |
-| 样式 | `src/client/components/SessionList/SessionList.css` |
-| 测试 | `src/client/components/SessionList/SessionList.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSessionList.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/ai/sessionlist` ——（P1 填充具体步骤）