weifuwu 0.65.1 → 0.67.0

package/dist/index.js

@@ -4371,7 +4371,7 @@ function createSsrContext(serverCtx, dataStore) {
     },
     useDrag: () => ({ onPointerDown: () => {
     } }),
-    useDragDrop: () => ({ dropProps: {} }),
+    useDragDrop: () => ({ dropProps: {}, dragProps: {} }),
     useControlled: (options) => ({
       value: options.value,
       setValue: (v) => {
@@ -4426,8 +4426,35 @@ function createSsrContext(serverCtx, dataStore) {
       }
     })
   };
+  const browser = {
+    activeElement: () => null,
+    byId: () => null,
+    query: () => null,
+    createElement: () => null,
+    bodyAppend: () => {
+    },
+    bodyRemove: () => {
+    },
+    copyText: async () => false,
+    execCommand: () => false,
+    selectionText: () => null,
+    getSelection: () => null,
+    queryCommandState: () => false,
+    queryCommandValue: () => "",
+    viewportHeight: () => 0,
+    scrollTop: () => 0,
+    hash: () => "",
+    setHash: () => {
+    },
+    timeout: () => 0,
+    rootElement: () => null,
+    storageGet: () => null,
+    storageSet: () => {
+    }
+  };
   const ctx = Object.create(serverCtx ?? {});
   ctx.ui = ui2;
+  ctx.browser = browser;
   ctx.data = {
     async get(key, fetcher) {
       if (dataStore.has(key)) return dataStore.get(key);

package/dist/layout/weifuwu-layout.css

@@ -91,6 +91,13 @@
   --wf-z-sticky: 40;
   --wf-z-overlay: 80;
   --wf-z-modal: 100;
+  --wf-z-tour: 2000;
+  --wf-tour-min-width: 240px;
+  --wf-kanban-col-min-width: 200px;
+  --wf-kanban-col-max-width: 300px;
+  --wf-treeselect-min-width: 200px;
+  --wf-treeselect-max-width: 320px;
+  --wf-treeselect-dropdown-max-height: 260px;
   --wf-z-popover: 120; /* dropdown/select/datepicker 面板与 popover 同层 */
   --wf-z-toast: 140;
   --wf-z-tooltip: 160;

package/docs/components-map.md

@@ -141,13 +141,34 @@
 <Badge variant="secondary">x</Badge>               // → <Tag variant="secondary">x</Tag>
 ```
 
-## weifuwu 尚未实现（三库有）→ 待补清单
+## weifuwu 已补齐（第六批，2026-08）→ 待补清单清零 ✅
 
-仅 4 项：
+第六批 6 组件全部落地（TDD 红→绿 + style-audit + demo + agent-browser 实测）：
 
-- **Anchor**（锚点导航，三库均有）
-- **Menu 子菜单/折叠**（分组 group 已支持，子级/折叠待补）
-- **FileUpload 增强**（拖拽已支持；文件列表/预览/进度待补）
-- **VirtualTable**（VirtualList 已有，表格虚拟化待补）
+| 组件 | 类型 | 要点 |
+|------|------|------|
+| **Menu 子菜单/折叠** | 增强 | `children` 子菜单 + `collapsible` 折叠侧栏 + 多级键盘流 |
+| **FileUpload 增强** | 增强 | 图片缩略图（objectURL revoke）+ 进度条 + 受控纪律 |
+| **VirtualTable** | 新增 | 固定表头 + 虚拟滚动（10k 行 ~17 DOM）+ 排序 |
+| **Anchor** | 新增 | 滚动高亮跟随 + 点击平滑滚动 + useHash |
+| **LogViewer** | 新增 | ANSI 着色 + 虚拟滚动 + follow 自动跟随 + maxLines |
+| **JSONViewer** | 新增 | 递归折叠 + 类型色 + 路径复制 + 懒展开（ToolCallCard 已接入） |
 
-> 难度阶梯（L1-L6）与验证的 client 能力点：见 `design/components-cdd.md`；三库 → weifuwu 覆盖矩阵：见 `design/components-migration.md`。
+> 三库共识覆盖度 ~100%（剩余均为已声明裁剪项，见 `design/components-roadmap.md` 第六批裁剪清单）。
+
+## 第七批：AI 开发者工具深化（96 → 102 组件）
+
+> 追平期结束（三库共识 ~100%），差异化期——本批全部组件三库没有的直接等价物。
+
+| 组件 | 类型 | 要点 |
+|------|------|------|
+| **DiffView** | 新增 | LCS 行级 diff（自研算法）：三态行 + 未变块折叠 + maxLines 防超大 |
+| **Sparkline** | 新增 | 迷你趋势线：SVG 自绘 + 归一化 + 平滑曲线 + 面积填充 + 等值防抖 |
+| **Tour** | 新增 | 新手引导：目标高亮（rect 精确跟随）+ 遮罩 + 步骤气泡 + 全局 Escape |
+| **Kanban** | 新增 | 拖拽看板：原生 DnD + 跨列/重排 + 悬停高亮 + 受控纪律 |
+| **Pipeline** | 新增 | Agent 工作流 DAG：Kahn 拓扑分层 + 贝塞尔连线 + 状态语义色 + 环检测 |
+| **TreeSelect** | 新增 | 树形选择：单选/多选（父子联动）+ label 回显 + 受控纪律 |
+
+> AI 开发者工具链成型：AiChat / Command / JSONViewer / LogViewer / DiffView /
+> Pipeline——三库差异化最深的完整工具线。
+> 裁剪声明见 `design/components-roadmap.md` 第七批。

package/docs/custom-components.md

@@ -207,6 +207,35 @@ const CollapseItem: Component<{ active?: boolean; onChange?: (v: boolean) => voi
 
 **纪律**：组件内动画事件监听**唯一入口是 `useAnimationEnd`**——禁直接 `addEventListener('animationend')`（DatePicker 已收敛）；退场优先 `usePresence`（声明式状态机）或 `animateOut`（命令式）。
 
+## 8.6 浏览器环境纪律（ctx.browser）
+
+> **自定义组件禁止直接引用 window/document**——统一经 `ctx.browser`：
+> SSR 安全（shim 安全默认）+ 测试 mock 单点 + 环境差异隔离。
+
+```tsx
+const MyComp: Component = (_init, ctx) => {
+  // mount 层取 browser（ctx.browser 优先，测试/无注入环境 fallback jsdom）
+  const browser = ctx.browser ?? createClientBrowser()
+  return (props) =>
+    h('button', {
+      onClick: () => {
+        // 复制/查询/存储/滚动——全部经 browser
+        void browser.copyText('hello')
+        const el = browser.byId('target')
+      }
+    })
+}
+```
+
+**规则**：
+- 拖拽统一 `ctx.ui.useDragDrop`（drop 侧 dropProps + drag 侧 dragProps：draggable/
+  onDragStart/onDragEnd）——**dragstart 期间禁止重渲染**（渲染替换源元素中断拖拽；
+  身份/位置在渲染期闭包绑定，拖拽视觉高亮用 CSS :hover）
+- 复制统一 `browser.copyText`（clipboard + 降级——勿自建 textarea+execCommand）
+- 键盘导航用 `browser.activeElement()`（勿 document.activeElement）
+- 存储用 `browser.storageGet/Set`（勿 localStorage 裸调）
+- SSR 场景（render/mount 期）绝对不碰环境 API（shim 返回 null——需防御）
+
 ## 9. 样式纪律（style-audit 强制）
 
 - 动效用 Token：`--wf-dur-*` / `--wf-ease-*` / `--wf-motion-*`（禁硬编码）

package/docs/frontend.md

@@ -143,6 +143,34 @@ ctx.ui.render(['name'])
 
 ---
 
+## 浏览器环境抽象（ctx.browser）
+
+> 组件**不直接引用 window/document**——统一经 `ctx.browser`（环境 API）：
+> SSR 安全（shim 返回安全默认）+ 测试可 mock + 环境差异单点隔离。
+
+| 方法 | 说明 |
+|------|------|
+| `activeElement()` | 当前焦点元素（键盘导航） |
+| `byId(id)` / `query(sel)` | 元素查询（getElementById / querySelector） |
+| `createElement(tag)` / `bodyAppend(el)` / `bodyRemove(el)` | 动态创建/挂载容器 |
+| `copyText(text)` | **复制统一入口**（clipboard API + execCommand 降级） |
+| `execCommand(cmd, value?)` | 富文本编辑器命令 |
+| `selectionText()` / `getSelection()` | 编辑器选区（文本 / 完整 Selection 对象） |
+| `viewportHeight()` / `scrollTop()` | 视口高度 / 滚动量（scrollingElement 优先） |
+| `hash()` / `setHash(h)` | 锚点 hash |
+| `timeout(fn, ms)` | 定时器（SSR no-op） |
+| `rootElement()` | document.documentElement（主题应用） |
+| `storageGet(key)` / `storageSet(key, val)` | localStorage（SSR/隐私模式安全） |
+
+**三态实现**：客户端 `createClientBrowser`（惰性 typeof 防御）· SSR shim（null/0/no-op）· 测试 mock 或 jsdom fallback。
+
+```tsx
+// 组件内（mount 层）
+const browser = ctx.browser ?? createClientBrowser()
+// 事件回调
+await browser.copyText(text)
+```
+
 ## 状态管理
 
 ### ctx.ui 方法速查

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weifuwu",
   "type": "module",
-  "version": "0.65.1",
+  "version": "0.67.0",
   "description": "AI SaaS framework — (req, ctx) => Response",
   "exports": {
     ".": {