weifuwu 0.87.0 → 0.89.0

package/content/components/filetree.md

@@ -1,56 +0,0 @@
-# FileTree · components
-
-## 概述
-
-文件树浏览器——面包屑 + 列表/编辑态 + 上传（受控——数据源无关）
-
-## 典型场景
-
-- office 文档/代码/内容编辑——xlsx/pptx/代码/公式/裁剪
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `entries` | `FileTreeEntry[]` | 否 | 当前目录条目（父层数据源驱动） |
-| `path` | `string` | 否 | 当前目录路径（面包屑） |
-| `loading` | `boolean` | 否 |  |
-| `openFile` | `FileTreeOpenFile \| null` | 否 | 编辑态（非空 = 文件编辑中——列表替换为编辑器） |
-| `editValue` | `string` | 否 | 编辑内容（受控） |
-| `saving` | `boolean` | 否 |  |
-| `emptyText` | `string` | 否 | 目录空态文案 |
-| `onBack` | `() => void` | 否 | 编辑态返回列表 |
-| `onOpenDir` | `(path: string) => void` | 否 |  |
-| `onOpenFile` | `(path: string) => void` | 否 |  |
-| `onSave` | `(content: string) => void` | 否 |  |
-| `onEditChange` | `(value: string) => void` | 否 |  |
-| `onUpload` | `(file: File) => void` | 否 | 上传（父层处理 File——组件只触发选择） |
-| `onRefresh` | `() => void` | 否 |  |
-| `accept` | `string` | 否 | 上传 accept（默认全部） |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 内容编辑：textarea value 走 property（attribute 只是 defaultValue）；受控输入纪律
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/FileTree/FileTree.ts` |
-| 样式 | `src/client/components/FileTree/FileTree.css` |
-| 测试 | `src/client/components/FileTree/FileTree.test.ts` |
-| demo | `apps/showcase/src/demos/DemoFileTree.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/editor/filetree` ——（P1 填充具体步骤）

package/content/components/fileupload-v2.md

@@ -1,39 +0,0 @@
-# FileUpload 禁用 · components
-
-## 概述
-
-disabled + accept 限定（状态矩阵覆盖）
-
-## 典型场景
-
-- office 文档/代码/内容编辑——xlsx/pptx/代码/公式/裁剪
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<FileUpload accept="image/*" multiple disabled error />
-```
-
-## 纪律/坑
-
-> 内容编辑：textarea value 走 property（attribute 只是 defaultValue）；受控输入纪律
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoFileUploadDis.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/editor/fileupload-v2` ——（P1 填充具体步骤）

package/content/components/fileupload.md

@@ -1,57 +0,0 @@
-# FileUpload · components
-
-## 概述
-
-文件上传，拖拽区 + 文件列表 + accept/maxSize
-
-## 典型场景
-
-- office 文档/代码/内容编辑——xlsx/pptx/代码/公式/裁剪
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `accept` | `string` | 否 |  |
-| `multiple` | `boolean` | 否 |  |
-| `maxSize` | `number` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `error` | `string` | 否 |  |
-| `hint` | `string` | 否 |  |
-| `value` | `File[]` | 否 |  |
-| `onChange` | `(files: File[]) => void` | 否 |  |
-| `uploading` | `boolean` | 否 | 上传中状态（父层驱动——组件不做 xhr，诚实裁剪） |
-| `progress` | `number` | 否 | 上传进度 0-100（父层驱动） |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<FileUpload accept="image/*,.pdf"
-  multiple maxSize={5242880}
-  value={files}
-  onChange={f => files = f} />
-```
-
-## 纪律/坑
-
-> 内容编辑：textarea value 走 property（attribute 只是 defaultValue）；受控输入纪律
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/FileUpload/FileUpload.ts` |
-| 样式 | `src/client/components/FileUpload/FileUpload.css` |
-| 测试 | `src/client/components/FileUpload/FileUpload.test.ts` |
-| demo | `apps/showcase/src/demos/DemoFileUpload.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/editor/fileupload` ——（P1 填充具体步骤）

package/content/components/floatbutton.md

@@ -1,52 +0,0 @@
-# FloatButton · components
-
-## 概述
-
-悬浮按钮组：展开状态机 + badge
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `icon` | `any` | 否 |  |
-| `badge` | `number \| string` | 否 |  |
-| `position` | `FloatButtonPosition` | 否 |  |
-| `static` | `boolean` | 否 | 'static'：组内子项（不 fixed——独立 fixed 会与主按钮重叠） |
-| `disabled` | `boolean` | 否 |  |
-| `onClick` | `() => void` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<FloatButtonGroup>
-  <FloatButton icon={editIcon} onClick={edit} />
-</FloatButtonGroup>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/FloatButton/FloatButton.ts` |
-| 样式 | `src/client/components/FloatButton/FloatButton.css` |
-| 测试 | `src/client/components/FloatButton/FloatButton.test.ts` |
-| demo | `apps/showcase/src/demos/DemoFloatButton.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/floatbutton` ——（P1 填充具体步骤）

package/content/components/form-v2.md

@@ -1,41 +0,0 @@
-# Form 提交 · components
-
-## 概述
-
-loading 提交 + 校验错误（状态矩阵覆盖）
-
-## 典型场景
-
-- 创建/编辑表单页——提交、校验、字段编排
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<Form validation={{name:[{required:true,minLength:2}]}}
-  onSubmit={submit}><Field label="项目名称" required><Input name="name" /></Field>
-  <Button type="submit" loading={loading}>提交</Button></Form>
-```
-
-## 纪律/坑
-
-> 受控纪律（§5.2）：受控 props 必须配回调——缺回调静默不可点；受控输入（§5.3）输入态不依赖 value 回流（焦点丢失）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoFormSubmit.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/form/form-v2` ——（P1 填充具体步骤）

package/content/components/form.md

@@ -1,60 +0,0 @@
-# Form · components
-
-## 概述
-
-内置验证规则：required/pattern/minLength/自定义
-
-## 典型场景
-
-- 页面模式：focus-task、settings-page（复制即用蓝本——examples/patterns/）
-- 应用模板：todo、auth、admin、agent-platform（examples/apps/ 完整可跑）
-- 创建/编辑表单页——提交、校验、字段编排
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `onSubmit` | `(values: Record<string, any>) => void \| Promise<void>` | 否 | 提交回调，接收字段名→值的对象 |
-| `validation` | `Record<string, ValidationRule[]>` | 否 | 验证规则：字段名 → 规则数组 |
-| `onError` | `(errors: Record<string, string>) => void` | 否 | 验证失败时回调，接收字段名→错误消息的对象 |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Form
-  validation={{
-    email: {required: true, message: '必填'},
-  }}
-  onSubmit={values => ...}
-  onError={errors => ...}>
-  <Field label="邮箱" error={errors.email}>
-    <Input name="email" />
-  </Field>
-  <Button type="submit">提交</Button>
-</Form>
-```
-
-## 纪律/坑
-
-- 三层一致（§6.3）：条件渲染 false 是空洞占位——{cond && <Alert/>} 不滤除不塌缩（提交按钮消失事故）
-- 受控纪律：受控 value 必须配 onChange——缺回调静默不可点
-
-## 关系
-
-- ↑ 用于页面模式：[focus-task](../patterns/focus-task.md) · [settings-page](../patterns/settings-page.md)
-- ↑ 用于应用：[todo](../apps/todo.md) · [auth](../apps/auth.md) · [admin](../apps/admin.md) · [agent-platform](../apps/agent-platform.md)
-- → 后端能力：[sql](../backend/sql.md)
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Form/Form.ts` |
-| 样式 | `src/client/components/Form/Form.css` |
-| 测试 | `src/client/components/Form/Form.test.ts` |
-| demo | `apps/showcase/src/demos/DemoForm.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/form/form` ——（P1 填充具体步骤）

package/content/components/grid.md

@@ -1,51 +0,0 @@
-# Grid · components
-
-## 概述
-
-24 栅格 + gutter + flex 容器模式（Row/Col/Flex 等价）
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `gutter` | `number` | 否 |  |
-| `flex` | `boolean` | 否 |  |
-| `gap` | `number` | 否 |  |
-| `direction` | `'row' \| 'column'` | 否 |  |
-| `align` | `'start' \| 'center' \| 'end' \| 'stretch'` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Grid gutter={16}>
-  <Col span={8}>A</Col><Col span={8}>B</Col><Col span={8}>C</Col>
-</Grid>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Grid/Grid.ts` |
-| 样式 | `src/client/components/Grid/Grid.css` |
-| 测试 | `src/client/components/Grid/Grid.test.ts` |
-| demo | `apps/showcase/src/demos/DemoGrid.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/grid` ——（P1 填充具体步骤）

package/content/components/highlight-v2.md

@@ -1,39 +0,0 @@
-# Highlight 多词 · components
-
-## 概述
-
-query 数组多词高亮（变体覆盖）
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<Highlight text="React 与 Vue" query={['react','vue']} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoHighlightMulti.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/highlight-v2` ——（P1 填充具体步骤）

package/content/components/highlight.md

@@ -1,46 +0,0 @@
-# Highlight · components
-
-## 概述
-
-搜索词高亮：分词渲染 mark，大小写不敏感
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `text` | `string` | 是 |  |
-| `query` | `string \| string[]` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Highlight text="搜索 张三 的订单" query={['张三']} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Highlight/Highlight.ts` |
-| 样式 | `src/client/components/Highlight/Highlight.css` |
-| 测试 | `src/client/components/Highlight/Highlight.test.ts` |
-| demo | `apps/showcase/src/demos/DemoHighlight.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/highlight` ——（P1 填充具体步骤）

package/content/components/hovercard.md

@@ -1,51 +0,0 @@
-# HoverCard · components
-
-## 概述
-
-悬停富内容卡：openDelay 延迟 + 任意 VNode（shadcn）
-
-## 典型场景
-
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `content` | `any` | 是 | 富内容（任意 VNode，区别于 Tooltip 的 string） |
-| `position` | `HoverCardPosition` | 否 |  |
-| `children` | `any` | 是 |  |
-| `disabled` | `boolean` | 否 |  |
-| `openDelay` | `number` | 否 | 悬停打开延迟（ms），默认 150 |
-| `closeDelay` | `number` | 否 | 移出关闭延迟（ms），默认 0 |
-
-## 用法示例
-
-```tsx
-<HoverCard content={<UserCard />}>
-  <Button>悬停</Button>
-</HoverCard>
-```
-
-## 纪律/坑
-
-- portal 槽豁免：浮层插槽打开/关闭不触发 A 级动态数组检测（框架管理切换槽）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/HoverCard/HoverCard.ts` |
-| 样式 | `src/client/components/HoverCard/HoverCard.css` |
-| 测试 | `src/client/components/HoverCard/HoverCard.test.ts` |
-| demo | `apps/showcase/src/demos/DemoHoverCard.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/hovercard` ——（P1 填充具体步骤）

package/content/components/icon.md

@@ -1,50 +0,0 @@
-# Icon · components
-
-## 概述
-
-stroke SVG 图标集，currentColor 着色，随字号缩放
-
-## 典型场景
-
-- 页面模式：app-shell、workspace、focus-task、docs、dashboard、data-screen、landing、mobile、list-page（复制即用蓝本——examples/patterns/）
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `name` | `IconName` | 是 |  |
-| `size` | `number \| string` | 否 | 尺寸，默认 1em（随字号缩放） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Icon name="check" size={16} />
-<Icon name="search" />
-<Icon name="settings" size={20} />
-{/* stroke SVG · currentColor · 1em 随字号 */}
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§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) · [docs](../patterns/docs.md) · [dashboard](../patterns/dashboard.md) · [data-screen](../patterns/data-screen.md) · [landing](../patterns/landing.md) · [mobile](../patterns/mobile.md) · [list-page](../patterns/list-page.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Icon/Icon.ts` |
-| 样式 | `src/client/components/Icon/Icon.css` |
-| 测试 | `src/client/components/Icon/Icon.test.ts` |
-| demo | `apps/showcase/src/demos/DemoIcon.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/icon` ——（P1 填充具体步骤）

package/content/components/imagecropper.md

@@ -1,45 +0,0 @@
-# ImageCropper · components
-
-## 概述
-
-图片裁剪——canvas 原生 API + 拖拽裁剪框 + 比例控制（零依赖）
-
-## 典型场景
-
-- office 文档/代码/内容编辑——xlsx/pptx/代码/公式/裁剪
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `src` | `string` | 是 |  |
-| `aspect` | `number` | 否 | 裁剪比例（宽/高——默认 1） |
-| `onCrop` | `(dataUrl: string) => void` | 否 |  |
-| `onError` | `(err: Error) => void` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 内容编辑：textarea value 走 property（attribute 只是 defaultValue）；受控输入纪律
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ImageCropper/ImageCropper.ts` |
-| 样式 | `src/client/components/ImageCropper/ImageCropper.css` |
-| 测试 | `src/client/components/ImageCropper/ImageCropper.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/editor/imagecropper` ——（P1 填充具体步骤）

package/content/components/img.md

@@ -1,56 +0,0 @@
-# Img · components
-
-## 概述
-
-图片 \<img\> 组件：fallback / lazy / preview 点击放大
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `src` | `string` | 否 |  |
-| `alt` | `string` | 否 |  |
-| `fallback` | `string` | 否 |  |
-| `loading` | `'lazy' \| 'eager'` | 否 |  |
-| `width` | `number \| string` | 否 |  |
-| `height` | `number \| string` | 否 |  |
-| `className` | `string` | 否 |  |
-| `style` | `Record<string, string>` | 否 |  |
-| `preview` | `boolean` | 否 | 点击放大预览（对应 antd/EP Image preview） |
-| `previewScale` | `number` | 否 | 预览缩放倍率，默认 1 |
-
-## 用法示例
-
-```tsx
-<Img src="/photo.jpg" alt="照片" />
-<Img src="/photo.jpg" fallback="/placeholder.png" />
-<Img src="..." loading="lazy" width={200} />
-<Img src="..." preview /> {/* 点击放大：Escape/遮罩关闭 */}
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Img/Img.ts` |
-| 样式 | `src/client/components/Img/Img.css` |
-| 测试 | `src/client/components/Img/Img.test.ts` |
-| demo | `apps/showcase/src/demos/DemoImage.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/img` ——（P1 填充具体步骤）

package/content/components/infinitescroll-v2.md

@@ -1,40 +0,0 @@
-# InfiniteScroll 失败重试 · components
-
-## 概述
-
-加载失败提示 + 滚动重试（状态矩阵覆盖）
-
-## 典型场景
-
-- 大数据列表/表格/树——千级+数据量的性能场景
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<InfiniteScroll hasMore loading onLoadMore={加载}
-  endText="已全部加载">...</InfiniteScroll>
-```
-
-## 纪律/坑
-
-> 大数据渲染：固定行高 + 窗口化（VirtualList）——动态高度裁剪登记
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoInfiniteScrollRetry.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/virtual/infinitescroll-v2` ——（P1 填充具体步骤）