weifuwu 0.87.0 → 0.89.0

package/content/components/sheetgrid.md

@@ -1,44 +0,0 @@
-# SheetGrid · components
-
-## 概述
-
-weifuwu/components/SheetGrid — xlsx 网格编辑器（ODES 事件流底座） 设计（design/office-events-plan.md）：文档 = fold(事件流)——SheetGrid 的每个
-
-## 典型场景
-
-- office 文档/代码/内容编辑——xlsx/pptx/代码/公式/裁剪
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `workbook` | `WorkbookState` | 是 | 受控工作簿（FilePreview 传入——编辑经 onChange 回写） |
-| `onChange` | `(wb: WorkbookState) => void` | 否 |  |
-| `height` | `string` | 否 | AI 公式（SSE wf: 协议——选中单元格 → 建议 → 接受 commit） |
-| `readonly` | `boolean` | 否 | 关闭编辑（只读展示） |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 内容编辑：textarea value 走 property（attribute 只是 defaultValue）；受控输入纪律
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/SheetGrid/SheetGrid.ts` |
-| 样式 | `src/client/components/SheetGrid/SheetGrid.css` |
-| 测试 | `src/client/components/SheetGrid/SheetGrid.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/editor/sheetgrid` ——（P1 填充具体步骤）

package/content/components/skeleton.md

@@ -1,55 +0,0 @@
-# Skeleton · components
-
-## 概述
-
-text/circle/rect/image/avatar/table 六种变体
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `variant` | `SkeletonVariant` | 否 |  |
-| `lines` | `number` | 否 |  |
-| `cols` | `number` | 否 |  |
-| `width` | `number \| string` | 否 |  |
-| `height` | `number \| string` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Skeleton />
-<Skeleton lines={3} />
-<Skeleton variant="avatar" />
-<Skeleton variant="image" />
-<Skeleton variant="table" lines={3} cols={4} />
-<Skeleton variant="circle" width={40} height={40} />
-<Skeleton variant="rect" width="100%" height={100} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Skeleton/Skeleton.ts` |
-| 样式 | `src/client/components/Skeleton/Skeleton.css` |
-| 测试 | `src/client/components/Skeleton/Skeleton.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSkeleton.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/skeleton` ——（P1 填充具体步骤）

package/content/components/slidecanvas.md

@@ -1,44 +0,0 @@
-# SlideCanvas · components
-
-## 概述
-
-weifuwu/components/SlideCanvas — pptx 画布编辑器（ODES 事件流——阶段 3） 设计（design/office-events-plan.md）：文档 = fold(事件流)——每个编辑 =
-
-## 典型场景
-
-- office 文档/代码/内容编辑——xlsx/pptx/代码/公式/裁剪
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `deck` | `DeckState` | 是 | 受控 DeckState |
-| `onChange` | `(deck: DeckState) => void` | 否 |  |
-| `height` | `string` | 否 |  |
-| `readonly` | `boolean` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 内容编辑：textarea value 走 property（attribute 只是 defaultValue）；受控输入纪律
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/SlideCanvas/SlideCanvas.ts` |
-| 样式 | `src/client/components/SlideCanvas/SlideCanvas.css` |
-| 测试 | `src/client/components/SlideCanvas/SlideCanvas.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/editor/slidecanvas` ——（P1 填充具体步骤）

package/content/components/slider.md

@@ -1,62 +0,0 @@
-# Slider · components
-
-## 概述
-
-范围滑块，支持 min/max/step/label
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `label` | `string` | 否 |  |
-| `value` | `number \| string \| [number, number]` | 否 | 单值模式 value；range 模式 [lo, hi]（传反自动纠正） |
-| `min` | `number` | 否 |  |
-| `max` | `number` | 否 |  |
-| `step` | `number` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `range` | `boolean` | 否 | range 模式：双滑块区间（价格/日期/年龄筛选——三库标配） |
-| `marks` | `SliderMark[]` | 否 | 刻度标记（轨道下方刻度线 + 可选文字标签） |
-| `onChangeEnd` | `(value: number) => void` | 否 | 单值拖拽结束回调（pointerup） |
-| `onChange` | `(value: number) => void` | 否 | 单值实时回调 |
-| `onRangeChange` | `(value: [number, number]) => void` | 否 | range 实时回调（range 模式专用——类型独立防单值误用） |
-| `onRangeChangeEnd` | `(value: [number, number]) => void` | 否 | range 拖拽结束回调 |
-
-## 用法示例
-
-```tsx
-<Slider label="音量" value={volume}
-  onChange={v => setVolume(v)} />  // 拖拽/hover/focus 显示当前值气泡
-
-<Slider label="价格" value={800} min={0} max={2000} step={50}
-  marks={[{ value: 0, label: '0' }, { value: 500 },
-          { value: 1000 }, { value: 2000, label: '2000' }]}
-  onChangeEnd={v => console.log('拖拽结束:', v)} />
-```
-
-## 纪律/坑
-
-- 浏览器表单状态恢复（刷新/后退）覆盖受控 value——autocomplete=off + 内部 0-100 归一化刻度（2000 slider 刷新跳动事故）
-- 拖拽中气泡位置冻结——usePopup 锚点恒定需 popup.refresh() 跟随 thumb
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Slider/Slider.ts` |
-| 样式 | `src/client/components/Slider/Slider.css` |
-| 测试 | `src/client/components/Slider/Slider.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSlider.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/slider` ——（P1 填充具体步骤）

package/content/components/sortablelist.md

@@ -1,39 +0,0 @@
-# SortableList · components
-
-## 概述
-
-拖拽排序列表——useDragDrop 原语 + keyed 身份（任务/字段/配置排序）
-
-## 典型场景
-
-- 数据看板/统计报表——指标卡、图表、趋势
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`src/client/components/SortableList/SortableList.ts`
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 图表自研 SVG：数据点 label 为轴名；交互 tooltip 经 usePopup（视口夹紧）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/SortableList/SortableList.ts` |
-| 样式 | `src/client/components/SortableList/SortableList.css` |
-| 测试 | `src/client/components/SortableList/SortableList.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/viz/sortablelist` ——（P1 填充具体步骤）

package/content/components/space.md

@@ -1,52 +0,0 @@
-# Space · components
-
-## 概述
-
-间距容器：size/direction/wrap + split 分隔符
-
-## 典型场景
-
-- 页面模式：app-shell、workspace、focus-task、docs、dashboard、data-screen、landing、mobile、detail-page、settings-page（复制即用蓝本——examples/patterns/）
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `size` | `number \| 'sm' \| 'md' \| 'lg'` | 否 |  |
-| `direction` | `'horizontal' \| 'vertical'` | 否 |  |
-| `wrap` | `boolean` | 否 |  |
-| `align` | `'start' \| 'center' \| 'end' \| 'baseline'` | 否 |  |
-| `split` | `any` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Space split={<Divider vertical />}>
-  <span>一</span><span>二</span><span>三</span>
-</Space>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§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) · [detail-page](../patterns/detail-page.md) · [settings-page](../patterns/settings-page.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Space/Space.ts` |
-| 样式 | `src/client/components/Space/Space.css` |
-| 测试 | `src/client/components/Space/Space.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSpace.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/space` ——（P1 填充具体步骤）

package/content/components/sparkline.md

@@ -1,52 +0,0 @@
-# Sparkline · components
-
-## 概述
-
-迷你趋势线：SVG 自绘 + 归一化 + 平滑曲线 + 面积填充
-
-## 典型场景
-
-- 页面模式：data-screen（复制即用蓝本——examples/patterns/）
-- 数据看板/统计报表——指标卡、图表、趋势
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `data` | `number[]` | 是 | 数据序列 |
-| `width` | `number` | 否 | SVG 宽（默认 120） |
-| `height` | `number` | 否 | SVG 高（默认 32） |
-| `stroke` | `string` | 否 | 描边色（默认语义 primary，随 currentColor 可继承） |
-| `fill` | `boolean` | 否 | 面积填充（默认关） |
-| `smooth` | `boolean` | 否 | 平滑曲线（Catmull-Rom）——默认折线 |
-| `label` | `string` | 否 | 可访问名（提供则 role=img + aria-label，否则 aria-hidden 装饰） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Sparkline data={[12, 18, 15, 22, 30, 28, 35]} width={140} height={36} fill />
-```
-
-## 纪律/坑
-
-> 图表自研 SVG：数据点 label 为轴名；交互 tooltip 经 usePopup（视口夹紧）
-
-## 关系
-
-- ↑ 用于页面模式：[data-screen](../patterns/data-screen.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Sparkline/Sparkline.ts` |
-| 样式 | `src/client/components/Sparkline/Sparkline.css` |
-| 测试 | `src/client/components/Sparkline/Sparkline.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSparkline.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/viz/sparkline` ——（P1 填充具体步骤）

package/content/components/statcard-countdown.md

@@ -1,39 +0,0 @@
-# StatCard Countdown · components
-
-## 概述
-
-倒计时模式：剩余 HH:MM:SS + 结束回调
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<StatCard label="倒计时" countdown={deadline} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoStatCountdown.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/statcard-countdown` ——（P1 填充具体步骤）

package/content/components/statcard.md

@@ -1,56 +0,0 @@
-# StatCard · components
-
-## 概述
-
-KPI 指标卡，支持 trend/icon
-
-## 典型场景
-
-- 页面模式：app-shell、dashboard、data-screen（复制即用蓝本——examples/patterns/）
-- 应用模板：admin、agent-platform（examples/apps/ 完整可跑）
-- 数据看板/统计报表——指标卡、图表、趋势
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `label` | `string` | 是 |  |
-| `value` | `string \| number` | 否 | 展示值——countdown 模式下可选（显示剩余时间） |
-| `trend` | `'up' \| 'down'` | 否 |  |
-| `trendLabel` | `string` | 否 |  |
-| `icon` | `string \| VNode \| null` | 否 | 图标——字符串（emoji/字形）或 VNode（推荐 <Icon name=... />，禁 emoji 装饰的场景用后者） |
-| `onClick` | `() => void` | 否 | 点击跳转/交互（悬停抬升 + role=button） |
-| `animate` | `boolean` | 否 | 数字从 0 递增动画（reduced-motion 下直接终值），仅数值类型生效 |
-| `countdown` | `number` | 否 | 倒计时目标时间戳（ms）——显示剩余 HH:MM:SS（antd Statistic.Countdown 等价） |
-| `onFinish` | `() => void` | 否 | 倒计时结束回调 |
-
-## 用法示例
-
-```tsx
-<StatCard label="用户"
-  value="1,234" icon={<Icon name="users" />}
-  trend="up" trendLabel="12%" />
-```
-
-## 纪律/坑
-
-> 图表自研 SVG：数据点 label 为轴名；交互 tooltip 经 usePopup（视口夹紧）
-
-## 关系
-
-- ↑ 用于页面模式：[app-shell](../patterns/app-shell.md) · [dashboard](../patterns/dashboard.md) · [data-screen](../patterns/data-screen.md)
-- ↑ 用于应用：[admin](../apps/admin.md) · [agent-platform](../apps/agent-platform.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/StatCard/StatCard.ts` |
-| 样式 | `src/client/components/StatCard/StatCard.css` |
-| 测试 | `src/client/components/StatCard/StatCard.test.ts` |
-| demo | `apps/showcase/src/demos/DemoStatCard.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/viz/statcard` ——（P1 填充具体步骤）

package/content/components/steps.md

@@ -1,48 +0,0 @@
-# Steps · components
-
-## 概述
-
-分步指示器，支持 active/current
-
-## 典型场景
-
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `StepItem[]` | 否 |  |
-| `active` | `string` | 否 |  |
-| `current` | `number` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Steps items={[
-  {key:'a',label:'第一步'},
-]} active="b" />
-```
-
-## 纪律/坑
-
-> 键盘可达（P1）：方向键导航焦点跟随（roving tabindex）；受控 props 配回调
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Steps/Steps.ts` |
-| 样式 | `src/client/components/Steps/Steps.css` |
-| 测试 | `src/client/components/Steps/Steps.test.ts` |
-| demo | `apps/showcase/src/demos/DemoSteps.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/steps` ——（P1 填充具体步骤）

package/content/components/switch.md

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

package/content/components/tabbar.md

@@ -1,45 +0,0 @@
-# TabBar · components
-
-## 概述
-
-底部标签栏——移动端 App 主导航（3-5 tab + icon/badge/受控激活 + safe-area 避让）
-
-## 典型场景
-
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `TabBarItem[]` | 是 |  |
-| `activeKey` | `string` | 否 | 受控激活 key（不传 = 非受控自管理） |
-| `onChange` | `(key: string) => void` | 否 |  |
-| `fixed` | `boolean` | 否 | 底部固定（position:fixed + safe-area 避让）——移动端 App 主导航 |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 键盘可达（P1）：方向键导航焦点跟随（roving tabindex）；受控 props 配回调
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/TabBar/TabBar.ts` |
-| 样式 | `src/client/components/TabBar/TabBar.css` |
-| 测试 | `src/client/components/TabBar/TabBar.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/tabbar` ——（P1 填充具体步骤）

package/content/components/table-v2.md

@@ -1,40 +0,0 @@
-# Table 行选择 · components
-
-## 概述
-
-rowSelection 勾选列 + 受控 keys（状态矩阵覆盖）
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<Table rowSelection={{selectedRowKeys, onChange:setKeys}}
-  data={rows} columns={[{key:'name',label:'姓名'}]} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoTableRowSelect.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/table-v2` ——（P1 填充具体步骤）