weifuwu 0.87.0 → 0.89.0

package/content/components/infinitescroll.md

@@ -1,54 +0,0 @@
-# InfiniteScroll · components
-
-## 概述
-
-无限滚动：底部哨兵触底加载 + loading/end 态
-
-## 典型场景
-
-- 大数据列表/表格/树——千级+数据量的性能场景
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `hasMore` | `boolean` | 否 |  |
-| `loading` | `boolean` | 否 |  |
-| `onLoadMore` | `() => void` | 否 | 触底加载回调（sentinel 进入视口触发） |
-| `threshold` | `number` | 否 | 提前触发距离（px） |
-| `children` | `any` | 否 |  |
-| `loadMoreText` | `string` | 否 |  |
-| `endText` | `string` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<InfiniteScroll hasMore loading={loading}
-  onLoadMore={loadMore}>
-  {items.map(i => <div>{i}</div>)}
-</InfiniteScroll>
-```
-
-## 纪律/坑
-
-> 大数据渲染：固定行高 + 窗口化（VirtualList）——动态高度裁剪登记
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/InfiniteScroll/InfiniteScroll.ts` |
-| 样式 | `src/client/components/InfiniteScroll/InfiniteScroll.css` |
-| 测试 | `src/client/components/InfiniteScroll/InfiniteScroll.test.ts` |
-| demo | `apps/showcase/src/demos/DemoInfiniteScroll.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/virtual/infinitescroll` ——（P1 填充具体步骤）

package/content/components/input.md

@@ -1,65 +0,0 @@
-# Input · components
-
-## 概述
-
-text/email/password/number，支持 label/error/hint/required
-
-## 典型场景
-
-- 页面模式：focus-task、settings-page（复制即用蓝本——examples/patterns/）
-- 应用模板：todo、auth、multi（examples/apps/ 完整可跑）
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `label` | `string` | 否 |  |
-| `name` | `string` | 否 |  |
-| `type` | `'text' \| 'email' \| 'password' \| 'number' \| 'url' \| 'date' \| 'tel' \| 'time' \| 'color'` | 否 |  |
-| `value` | `string` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `required` | `boolean` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `readonly` | `boolean` | 否 | 只读（不可编辑但可复制） |
-| `error` | `string` | 否 |  |
-| `hint` | `string` | 否 |  |
-| `variant` | `'default' \| 'borderless'` | 否 | 边框变体：borderless 用于可编辑标题/内联编辑（hover/focus 才显边框） |
-| `onInput` | `(e: Event) => void` | 否 |  |
-| `onChange` | `(e: Event) => void` | 否 |  |
-| `min` | `string \| number` | 否 | 原生 input 属性透传（type=number 时 min/max/step 等） |
-| `max` | `string \| number` | 否 |  |
-| `step` | `string \| number` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Input label="文本" value={text}
-  onInput={e => text = e.target.value} />
-<Input label="邮箱" type="email" required />
-<Input error="错误提示" />
-<Input hint="辅助文字" />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：[focus-task](../patterns/focus-task.md) · [settings-page](../patterns/settings-page.md)
-- ↑ 用于应用：[todo](../apps/todo.md) · [auth](../apps/auth.md) · [multi](../apps/multi.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Input/Input.ts` |
-| 样式 | `src/client/components/Input/Input.css` |
-| 测试 | `src/client/components/Input/Input.test.ts` |
-| demo | `apps/showcase/src/demos/DemoInput.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/input` ——（P1 填充具体步骤）

package/content/components/inputnumber.md

@@ -1,58 +0,0 @@
-# InputNumber · components
-
-## 概述
-
-数字输入：min/max/step + 增减按钮 + precision
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `number \| null` | 否 |  |
-| `onChange` | `(value: number \| null) => void` | 否 |  |
-| `min` | `number` | 否 |  |
-| `max` | `number` | 否 |  |
-| `step` | `number` | 否 |  |
-| `precision` | `number` | 否 |  |
-| `label` | `string` | 否 |  |
-| `name` | `string` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `error` | `string` | 否 |  |
-| `hint` | `string` | 否 |  |
-| `required` | `boolean` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<InputNumber value={0.7} min={0} max={1} step={0.1} precision={1}
-  onChange={v => setTemp(v)} />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/InputNumber/InputNumber.ts` |
-| 样式 | `src/client/components/InputNumber/InputNumber.css` |
-| 测试 | `src/client/components/InputNumber/InputNumber.test.ts` |
-| demo | `apps/showcase/src/demos/DemoInputNumber.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/inputnumber` ——（P1 填充具体步骤）

package/content/components/inview.md

@@ -1,56 +0,0 @@
-# InView · components
-
-## 概述
-
-进入视窗后懒加载内容，支持 IntersectionObserver
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `once` | `boolean` | 否 |  |
-| `threshold` | `number` | 否 |  |
-| `rootMargin` | `string` | 否 |  |
-| `placeholder` | `any` | 否 |  |
-| `onEnter` | `() => void` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<InView>
-  <ExpensiveComponent />
-</InView>
-
-<InView once={false} rootMargin="200px"
-  onEnter={() => console.log('进入')}>
-  <img src="large.jpg" />
-</InView>
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/InView/InView.ts` |
-| 样式 | `src/client/components/InView/InView.css` |
-| 测试 | `src/client/components/InView/InView.test.ts` |
-| demo | `apps/showcase/src/demos/DemoInView.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/inview` ——（P1 填充具体步骤）

package/content/components/jsonschemaform.md

@@ -1,53 +0,0 @@
-# JsonSchemaForm · components
-
-## 概述
-
-JSON Schema → 参数输入表单：类型映射 + 必填/范围校验 + 嵌套/数组（AI 工具参数输入面）
-
-## 典型场景
-
-- 创建/编辑表单页——提交、校验、字段编排
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `schema` | `JsonSchema` | 是 | 顶层对象 schema（type: 'object' + properties） |
-| `value` | `Record<string, any>` | 否 | 初始值（非受控语义）；内部状态由编辑驱动 |
-| `onChange` | `(values: Record<string, any>) => void` | 否 | 每次编辑通知（父层可读最新值；不回流控制） |
-| `onSubmit` | `(values: Record<string, any>) => void` | 否 | 提交（校验通过才触发）；不传则不渲染提交按钮 |
-| `submitLabel` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<JsonSchemaForm
-  schema={toolSchema}
-  value={{ city: '北京' }}
-  onSubmit={(v) => console.log('执行', v)}
-  submitLabel="执行工具"
-/>
-```
-
-## 纪律/坑
-
-> 受控纪律（§5.2）：受控 props 必须配回调——缺回调静默不可点；受控输入（§5.3）输入态不依赖 value 回流（焦点丢失）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/JsonSchemaForm/JsonSchemaForm.ts` |
-| 样式 | `src/client/components/JsonSchemaForm/JsonSchemaForm.css` |
-| 测试 | `src/client/components/JsonSchemaForm/JsonSchemaForm.test.ts` |
-| demo | `apps/showcase/src/demos/DemoJsonSchemaForm.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/form/jsonschemaform` ——（P1 填充具体步骤）

package/content/components/jsonviewer-v2.md

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

package/content/components/jsonviewer.md

@@ -1,49 +0,0 @@
-# JSONViewer · components
-
-## 概述
-
-结构化 JSON：递归折叠 + 类型色 + 路径复制 + 懒展开
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `data` | `unknown` | 是 |  |
-| `defaultExpandDepth` | `number` | 否 | 默认展开深度（默认 2）——更深折叠为摘要 |
-| `maxKeys` | `number` | 否 | 对象键数超过该值时懒展开（只渲染前 N 个 + "+N 项"，默认 100） |
-| `rootName` | `string` | 否 | 根键名（默认 'root'）——复制路径前缀 |
-| `onCopy` | `(path: string, value: unknown) => void` | 否 | 复制路径回调（默认 navigator.clipboard 写入 JSON 路径） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<JSONViewer data={payload} defaultExpandDepth={2} maxKeys={100} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/JSONViewer/JSONViewer.ts` |
-| 样式 | `src/client/components/JSONViewer/JSONViewer.css` |
-| 测试 | `src/client/components/JSONViewer/JSONViewer.test.ts` |
-| demo | `apps/showcase/src/demos/DemoJSONViewer.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/jsonviewer` ——（P1 填充具体步骤）

package/content/components/kanban.md

@@ -1,46 +0,0 @@
-# Kanban · components
-
-## 概述
-
-看板：原生 DnD 拖拽 + 跨列/重排 + 悬停高亮
-
-## 典型场景
-
-- 数据看板/统计报表——指标卡、图表、趋势
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `columns` | `KanbanColumn[]` | 是 |  |
-| `onMove` | `(from: KanbanMove, to: KanbanMove) => void` | 否 | 受控：移动回调（from → to）。缺回调交互静默失效——受控纪律 warn |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Kanban columns={cols} onMove={(from, to) => {}} />
-```
-
-## 纪律/坑
-
-- enumerated 属性（§6.2）：draggable 空字符串解析为 false——必须显式 setAttribute true/false（拖动变文本选中事故）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Kanban/Kanban.ts` |
-| 样式 | `src/client/components/Kanban/Kanban.css` |
-| 测试 | `src/client/components/Kanban/Kanban.test.ts` |
-| demo | `apps/showcase/src/demos/DemoKanban.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/viz/kanban` ——（P1 填充具体步骤）

package/content/components/label.md

@@ -1,48 +0,0 @@
-# Label · components
-
-## 概述
-
-独立标签（required 星号）+ 宽高比容器（内容填满）
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `htmlFor` | `string` | 否 |  |
-| `required` | `boolean` | 否 | 必填星号 |
-| `children` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Label htmlFor="name">用户名</Label>
-<Label required>必填</Label>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Label/Label.ts` |
-| 样式 | `src/client/components/Label/Label.css` |
-| 测试 | `src/client/components/Label/Label.test.ts` |
-| demo | `apps/showcase/src/demos/DemoLabel.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/label` ——（P1 填充具体步骤）

package/content/components/layout.md

@@ -1,54 +0,0 @@
-# Layout · components
-
-## 概述
-
-布局外壳：Sider 折叠 + Header/Content/Footer 骨架（antd Layout / shadcn Sidebar 等价）
-
-## 典型场景
-
-- 应用模板：admin（examples/apps/ 完整可跑）
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `style` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Layout>
-  <LayoutSider collapsible collapsed onCollapse={setCollapsed}>导航</LayoutSider>
-  <Layout>
-    <LayoutHeader>顶部</LayoutHeader>
-    <LayoutContent>主区</LayoutContent>
-    <LayoutFooter>底部</LayoutFooter>
-  </Layout>
-</Layout>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：[admin](../apps/admin.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Layout/Layout.ts` |
-| 样式 | `src/client/components/Layout/Layout.css` |
-| 测试 | `src/client/components/Layout/Layout.test.ts` |
-| demo | `apps/showcase/src/demos/DemoLayout.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/layout` ——（P1 填充具体步骤）

package/content/components/layoutcontent.md

@@ -1,43 +0,0 @@
-# LayoutContent · components
-
-## 概述
-
-布局内容区——Layout 家族
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `style` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Layout/Layout.ts` |
-| 样式 | `src/client/components/Layout/Layout.css` |
-| 测试 | `src/client/components/Layout/Layout.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/layoutcontent` ——（P1 填充具体步骤）

package/content/components/layoutheader.md

@@ -1,43 +0,0 @@
-# LayoutHeader · components
-
-## 概述
-
-布局顶栏——Layout 家族（Layout/LayoutHeader/LayoutSider/LayoutContent/LayoutFooter）
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `style` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Layout/Layout.ts` |
-| 样式 | `src/client/components/Layout/Layout.css` |
-| 测试 | `src/client/components/Layout/Layout.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/layoutheader` ——（P1 填充具体步骤）

package/content/components/layoutsider.md

@@ -1,43 +0,0 @@
-# LayoutSider · components
-
-## 概述
-
-布局侧栏（可折叠 collapsed/collapsible）——Layout 家族
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `style` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Layout/Layout.ts` |
-| 样式 | `src/client/components/Layout/Layout.css` |
-| 测试 | `src/client/components/Layout/Layout.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/layoutsider` ——（P1 填充具体步骤）