weifuwu 0.65.1 → 0.66.0

package/dist/components/style.css

@@ -1626,6 +1626,46 @@ code {
   opacity: 1;
 }
 
+/* weifuwu/components — Anchor（锚点导航） */
+
+.wf-anchor {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  font-family: var(--wf-font-sans);
+  font-size: var(--wf-font-size-sm);
+}
+
+.wf-anchor-link {
+  display: block;
+  padding: var(--wf-space-xs) var(--wf-space-sm);
+  border-left: 2px solid transparent;
+  border-radius: 0 var(--wf-radius-sm) var(--wf-radius-sm) 0;
+  color: var(--wf-color-text-secondary);
+  text-decoration: none;
+  cursor: pointer;
+  transition: color var(--wf-dur-fast) var(--wf-ease-out),
+              background var(--wf-dur-fast) var(--wf-ease-out),
+              border-color var(--wf-dur-fast) var(--wf-ease-out);
+}
+
+.wf-anchor-link:hover {
+  background: var(--wf-color-bg-secondary);
+  color: var(--wf-color-text);
+}
+
+.wf-anchor-link--active {
+  color: var(--wf-color-primary-text);
+  border-left-color: var(--wf-color-primary);
+  font-weight: var(--wf-font-weight-semibold);
+  background: var(--wf-color-primary-bg);
+}
+
+.wf-anchor-link:focus-visible {
+  outline: none;
+  box-shadow: var(--wf-focus-ring);
+}
+
 /* weifuwu/components — ApprovalCard */
 
 .wf-approval {
@@ -4116,27 +4156,67 @@ code {
   flex-shrink: 0;
 }
 
+.wf-upload-err {
+  font-family: var(--wf-font-sans);
+  font-size: var(--wf-font-size-xs);
+  color: var(--wf-color-error-text);
+}
+
+/* ── 第六批增强：缩略图 / 进度条 ────────────────────────── */
+
+.wf-upload-item {
+  display: flex;
+  align-items: center;
+  gap: var(--wf-gap-sm);
+  padding: var(--wf-space-sm);
+  border-radius: var(--wf-radius-sm);
+  background: var(--wf-color-bg-secondary);
+}
+
+.wf-upload-thumb {
+  width: 36px;
+  height: 36px;
+  object-fit: cover;
+  border-radius: var(--wf-radius-sm);
+  border: var(--wf-border-width) solid var(--wf-color-border);
+  flex-shrink: 0;
+  background: var(--wf-color-bg);
+}
+
 .wf-upload-item-remove {
+  margin-left: auto;
+  width: 24px; height: 24px;
+  min-width: 24px; max-width: 24px;
+  min-height: 24px; max-height: 24px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
   border: none;
-  background: transparent;
+  background: none;
+  border-radius: var(--wf-radius-sm);
   color: var(--wf-color-text-tertiary);
   cursor: pointer;
-  padding: 2px 4px;
-  font-size: 12px;
-  line-height: 1;
-  border-radius: var(--wf-radius-sm);
-  flex-shrink: 0;
+  line-height: 0; padding: 0; flex-shrink: 0;
 }
 
 .wf-upload-item-remove:hover {
-  color: var(--wf-color-error-text);
   background: var(--wf-color-error-bg);
+  color: var(--wf-color-error-text);
 }
 
-.wf-upload-err {
-  font-family: var(--wf-font-sans);
-  font-size: var(--wf-font-size-xs);
-  color: var(--wf-color-error-text);
+.wf-upload-progress {
+  height: 4px;
+  border-radius: 2px;
+  background: var(--wf-color-bg-tertiary);
+  overflow: hidden;
+  margin-top: var(--wf-space-sm);
+}
+
+.wf-upload-progress-fill {
+  height: 100%;
+  background: var(--wf-color-primary);
+  border-radius: 2px;
+  transition: width var(--wf-dur-fast) var(--wf-ease-out);
 }
 
 /* weifuwu/components — Form */
@@ -4516,6 +4596,152 @@ code {
 .wf-inputnumber-err { font-size: var(--wf-font-size-xs); color: var(--wf-color-error-text); }
 .wf-inputnumber-hint { font-size: var(--wf-font-size-xs); color: var(--wf-color-text-tertiary); }
 
+/* weifuwu/components — JSONViewer（结构化 JSON 浏览） */
+
+.wf-json-viewer {
+  font-family: var(--wf-font-mono);
+  font-size: var(--wf-font-size-xs);
+  color: var(--wf-color-text);
+  background: var(--wf-color-bg-secondary);
+  border-radius: var(--wf-radius-sm);
+  padding: var(--wf-space-sm);
+  overflow-x: auto;
+  line-height: 1.6;
+}
+
+/* 对象/数组节点不额外缩进——同层键（标量/对象/数组）对齐；
+   子层缩进由 .wf-json-children 容器承担（padding + border-left） */
+.wf-json-node {
+  padding-left: 0;
+}
+
+.wf-json-row {
+  display: flex;
+  align-items: center;
+  gap: var(--wf-gap-xs);
+  white-space: nowrap;
+  border-radius: var(--wf-radius-sm);
+}
+
+.wf-json-row:hover {
+  background: var(--wf-color-bg-tertiary);
+}
+
+.wf-json-children {
+  padding-left: var(--wf-space-sm);
+  border-left: 1px solid var(--wf-color-border);
+  margin-left: var(--wf-space-xs);
+}
+
+.wf-json-key {
+  color: var(--wf-color-text-secondary);
+}
+
+/* 标量行 toggle 占位（与对象/数组行 chevron 同宽 16px）——同层 key 文本对齐 */
+.wf-json-toggle-placeholder {
+  width: 16px;
+  flex-shrink: 0;
+  display: inline-flex;
+}
+
+.wf-json-toggle {
+  width: 16px; height: 16px;
+  min-width: 16px; max-width: 16px;
+  min-height: 16px; max-height: 16px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  background: none;
+  color: var(--wf-color-text-tertiary);
+  cursor: pointer;
+  line-height: 0; padding: 0; flex-shrink: 0;
+}
+
+.wf-json-toggle:hover {
+  color: var(--wf-color-text);
+}
+
+.wf-json-toggle:focus-visible {
+  outline: none;
+  box-shadow: var(--wf-focus-ring);
+}
+
+.wf-json-summary,
+.wf-json-node-summary {
+  color: var(--wf-color-text-tertiary);
+}
+
+.wf-json-more {
+  padding-left: var(--wf-space-lg);
+  color: var(--wf-color-warning-text);
+  font-size: var(--wf-font-size-xs);
+}
+
+.wf-json-copy {
+  width: 16px; height: 16px;
+  min-width: 16px; max-width: 16px;
+  min-height: 16px; max-height: 16px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  background: none;
+  color: var(--wf-color-text-tertiary);
+  cursor: pointer;
+  line-height: 0; padding: 0; flex-shrink: 0;
+  opacity: 0;
+}
+
+.wf-json-row:hover .wf-json-copy {
+  opacity: 1;
+}
+
+.wf-json-copy:hover {
+  color: var(--wf-color-primary-text);
+}
+
+.wf-json-copy:focus-visible {
+  outline: none;
+  box-shadow: var(--wf-focus-ring);
+  opacity: 1;
+}
+
+/* ── 类型色（语义 Token） ── */
+.wf-json-string { color: var(--wf-color-success-text); }
+.wf-json-number { color: var(--wf-color-primary-text); }
+.wf-json-boolean { color: var(--wf-color-warning-text); }
+.wf-json-null { color: var(--wf-color-text-tertiary); font-style: italic; }
+
+/* ── 整行折叠交互（大命中区）+ 触屏适配 ── */
+
+.wf-json-collapse,
+.wf-json-row--header {
+  cursor: pointer;
+}
+
+.wf-json-collapse:hover,
+.wf-json-row--header:hover {
+  background: var(--wf-color-bg-tertiary);
+}
+
+.wf-json-collapse:focus-visible,
+.wf-json-row--header:focus-visible {
+  outline: none;
+  box-shadow: var(--wf-focus-ring);
+}
+
+/* 触屏（coarse）：toggle/复制按钮 44px 命中区（padding 扩展） */
+@media (pointer: coarse) {
+  .wf-json-toggle,
+  .wf-json-copy {
+    width: 24px; height: 24px;
+    min-width: 24px; max-width: 24px;
+    min-height: 24px; max-height: 24px;
+    padding: 4px;
+  }
+}
+
 /* weifuwu/components — Label（与 Input/Field 的 label 样式同源） */
 
 .wf-label {
@@ -4609,6 +4835,106 @@ code {
   font-size: var(--wf-font-size-sm);
 }
 
+/* weifuwu/components — LogViewer（日志流：ANSI 着色 + 虚拟滚动） */
+
+.wf-log-viewer {
+  font-family: var(--wf-font-mono);
+  font-size: var(--wf-font-size-xs);
+  color: var(--wf-color-text);
+  position: relative;
+  border: var(--wf-border-width) solid var(--wf-color-border);
+  border-radius: var(--wf-radius);
+  background: var(--wf-color-bg-secondary);
+  overflow: hidden;
+}
+
+.wf-log-copy {
+  position: absolute;
+  top: var(--wf-space-sm);
+  right: var(--wf-space-sm);
+  z-index: 1;
+  width: 24px; height: 24px;
+  min-width: 24px; max-width: 24px;
+  min-height: 24px; max-height: 24px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  background: var(--wf-color-bg-tertiary);
+  border-radius: var(--wf-radius-sm);
+  color: var(--wf-color-text-secondary);
+  cursor: pointer;
+  line-height: 0; padding: 0; flex-shrink: 0;
+}
+
+.wf-log-copy:hover {
+  background: var(--wf-color-bg);
+  color: var(--wf-color-text);
+}
+
+.wf-log-body {
+  position: relative;
+  overflow-y: auto;
+}
+
+.wf-log-spacer {
+  pointer-events: none;
+}
+
+.wf-log-row {
+  display: flex;
+  align-items: center;
+  box-sizing: border-box;
+  padding-right: var(--wf-space-md);
+  white-space: pre;
+}
+
+.wf-log-row:hover {
+  background: var(--wf-color-bg-tertiary);
+}
+
+.wf-log-line-no {
+  display: inline-flex;
+  align-items: center;
+  justify-content: flex-end;
+  min-width: 48px;
+  padding: 0 var(--wf-space-sm);
+  margin-right: var(--wf-space-sm);
+  color: var(--wf-color-text-tertiary);
+  user-select: none;
+  flex-shrink: 0;
+}
+
+.wf-log-line-content {
+  overflow: hidden;
+}
+
+/* ── ANSI 前景色（16 色映射到语义 Token） ── */
+.wf-log-ansi--bold { font-weight: var(--wf-font-weight-bold); }
+.wf-log-ansi--30 { color: var(--wf-color-text-secondary); }
+.wf-log-ansi--31 { color: var(--wf-color-error-text); }
+.wf-log-ansi--32 { color: var(--wf-color-success-text); }
+.wf-log-ansi--33 { color: var(--wf-color-warning-text); }
+.wf-log-ansi--34 { color: var(--wf-color-primary-text); }
+.wf-log-ansi--35 { color: var(--wf-color-primary-text); }
+.wf-log-ansi--36 { color: var(--wf-color-info-text); }
+.wf-log-ansi--37 { color: var(--wf-color-text); }
+
+/* ── ANSI 背景色（8 色 → 50 级语义底） ── */
+.wf-log-ansi--bg41 { background: var(--wf-color-error-bg); }
+.wf-log-ansi--bg42 { background: var(--wf-color-success-bg); }
+.wf-log-ansi--bg43 { background: var(--wf-color-warning-bg); }
+.wf-log-ansi--bg44 { background: var(--wf-color-primary-bg); }
+.wf-log-ansi--bg47 { background: var(--wf-color-bg-tertiary); }
+
+.wf-log-empty {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--wf-space-lg);
+  color: var(--wf-color-text-tertiary);
+}
+
 /* weifuwu/components — Markdown 排版 */
 
 .wf-md {
@@ -4798,6 +5124,102 @@ code {
   flex-shrink: 0;
 }
 
+/* ── 子菜单（第六批） ────────────────────────────── */
+
+.wf-menu-submenu {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.wf-menu-submenu-title {
+  display: flex;
+  align-items: center;
+  gap: var(--wf-gap-sm);
+  padding: var(--wf-space-sm) var(--wf-space-md);
+  border-radius: var(--wf-radius-sm);
+  font-size: var(--wf-font-size-sm);
+  color: var(--wf-color-text-secondary);
+  cursor: pointer;
+  user-select: none;
+  transition: background var(--wf-dur-fast) var(--wf-ease-out), color var(--wf-dur-fast) var(--wf-ease-out);
+}
+
+.wf-menu-submenu-title:hover {
+  background: var(--wf-color-bg-secondary);
+  color: var(--wf-color-text);
+}
+
+.wf-menu-submenu-title:focus-visible {
+  outline: 2px solid var(--wf-color-primary);
+  outline-offset: -2px;
+}
+
+.wf-menu-arrow {
+  margin-left: auto;
+  display: inline-flex;
+  color: var(--wf-color-text-tertiary);
+  transition: transform var(--wf-dur-fast) var(--wf-ease-out);
+}
+
+.wf-menu-submenu--open .wf-menu-arrow {
+  transform: rotate(90deg);
+}
+
+.wf-menu-submenu-content {
+  display: none;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.wf-menu-submenu--open .wf-menu-submenu-content {
+  display: flex;
+}
+
+.wf-menu-item--child {
+  padding-left: var(--wf-space-xl);
+  font-size: var(--wf-font-size-sm);
+}
+
+/* ── 折叠（第六批） ────────────────────────────── */
+
+.wf-menu--collapsed {
+  width: 56px;
+}
+
+.wf-menu--collapsed .wf-menu-group {
+  display: none;
+}
+
+.wf-menu--collapsed .wf-menu-item,
+.wf-menu--collapsed .wf-menu-submenu-title {
+  justify-content: center;
+  padding: var(--wf-space-sm);
+  gap: 0;
+}
+
+.wf-menu-collapse-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  margin-top: auto;
+  padding: var(--wf-space-sm);
+  border-radius: var(--wf-radius-sm);
+  color: var(--wf-color-text-tertiary);
+  cursor: pointer;
+  min-height: 36px;
+}
+
+.wf-menu-collapse-btn:hover {
+  background: var(--wf-color-bg-secondary);
+  color: var(--wf-color-text);
+}
+
+.wf-menu-collapse-btn:focus-visible {
+  outline: 2px solid var(--wf-color-primary);
+  outline-offset: -2px;
+}
+
 /* weifuwu/components — Menubar */
 
 .wf-menubar {
@@ -7473,6 +7895,104 @@ code {
   box-sizing: border-box;
 }
 
+/* weifuwu/components — VirtualTable（固定表头 + 虚拟滚动表体） */
+
+.wf-virtual-table {
+  font-family: var(--wf-font-sans);
+  font-size: var(--wf-font-size-sm);
+  color: var(--wf-color-text);
+  border: var(--wf-border-width) solid var(--wf-color-border);
+  border-radius: var(--wf-radius);
+  overflow: hidden;
+}
+
+.wf-virtual-table-thead {
+  display: flex;
+  border-bottom: var(--wf-border-width) solid var(--wf-color-border);
+  background: var(--wf-color-bg-secondary);
+}
+
+.wf-virtual-table-th {
+  display: flex;
+  align-items: center;
+  gap: var(--wf-gap-xs);
+  padding: var(--wf-space-sm) var(--wf-space-md);
+  font-size: var(--wf-font-size-xs);
+  font-weight: var(--wf-font-weight-semibold);
+  color: var(--wf-color-text-secondary);
+  flex-shrink: 0;
+  box-sizing: border-box;
+}
+
+.wf-virtual-table-th--sortable {
+  cursor: pointer;
+  user-select: none;
+}
+
+.wf-virtual-table-th--sortable:hover {
+  color: var(--wf-color-text);
+}
+
+.wf-virtual-table-th--sortable:focus-visible {
+  outline: none;
+  box-shadow: var(--wf-focus-ring);
+}
+
+.wf-virtual-table-th--sorted {
+  color: var(--wf-color-primary-text);
+}
+
+.wf-virtual-table-sort-icon {
+  display: inline-flex;
+  color: var(--wf-color-text-tertiary);
+}
+
+.wf-virtual-table-sort-icon--active {
+  color: var(--wf-color-primary-text);
+}
+
+.wf-virtual-table-body {
+  position: relative;
+  overflow-y: auto;
+}
+
+.wf-virtual-table-spacer {
+  pointer-events: none;
+}
+
+.wf-virtual-table-row {
+  display: flex;
+  align-items: center;
+  box-sizing: border-box;
+  border-bottom: var(--wf-border-width) solid var(--wf-color-border);
+  cursor: default;
+}
+
+.wf-virtual-table-row:hover {
+  background: var(--wf-color-bg-tertiary);
+}
+
+.wf-virtual-table-td {
+  display: flex;
+  align-items: center;
+  padding: 0 var(--wf-space-md);
+  flex-shrink: 0;
+  box-sizing: border-box;
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  color: var(--wf-color-text);
+}
+
+.wf-virtual-table-empty {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--wf-space-lg);
+  color: var(--wf-color-text-tertiary);
+  font-size: var(--wf-font-size-sm);
+}
+
 /* weifuwu/components — Watermark */
 
 .wf-watermark {

package/dist/index.js

@@ -4426,8 +4426,33 @@ 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,
+    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/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 方法速查