weifuwu 0.65.0 → 0.66.0

package/docs/components-map.md

@@ -141,13 +141,17 @@
 <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` 第六批裁剪清单）。

package/docs/custom-components.md

@@ -207,6 +207,32 @@ 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')
+      }
+    })
+}
+```
+
+**规则**：
+- 复制统一 `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/docs/layout.md

@@ -2,7 +2,7 @@
 
 > 本页为 weifuwu 官方文档拆分页 · [返回 README](../README.md)
 
-纯 CSS 布局原语 + 工具类 + 141 个主题 Token。不绑定任何 JS 框架。
+纯 CSS 布局原语 + 工具类 + 143 个主题 Token。不绑定任何 JS 框架。
 
 > **学习路径与命名规范**：见 [`design/style-guide.md`](../design/style-guide.md)——统一语法 `wf-<域>-<名>`、三档学习（组件 → 10 核心原语 → 完整速查）、场景速查、变量定制。
 
@@ -101,7 +101,7 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 | `wf-truncate` | 单行省略（ellipsis） |
 | `wf-line-clamp-2/3` | 多行截断 |
 
-## 141 个主题 Token
+## 143 个主题 Token
 
 **双层结构**：原始层（Primitive，色值只定义一次，品牌/暗色调校改这里）+ 语义层（Semantic，组件消费）。
 

package/package.json

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