weifuwu 0.93.3 → 0.94.0

package/README.md

@@ -32,7 +32,7 @@
 
 ```tsx
 // routes.tsx —— 路由树（UIRouter——前后端同一棵树——单一实现源）
-import { UIRouter, h } from 'weifuwu/vdom'
+import { UIRouter, h } from 'weifuwu/client/vdom'
 
 export function buildRouter() {
   const router = new UIRouter()
@@ -57,7 +57,7 @@ serve(router, { port: 3000 })
 
 ```ts
 // src/client.ts —— 浏览器 boot
-import { uiServe } from 'weifuwu/vdom'
+import { uiServe } from 'weifuwu/client/vdom'
 import { buildRouter } from './routes.tsx'
 uiServe(buildRouter(), { root: '#root' })
 ```
@@ -95,9 +95,9 @@ router.get('*', async (req, ctx) => {
 | `weifuwu` | postgres / redis / Memory | 自研 PG v3 + RESP2 协议（`ctx.orm` / `ctx.redis`——数据面 = 声明式 ORM AST，业务零 SQL 文本）；Memory 零数据库测试 |
 | `weifuwu` | shape / bodyOf / listQuery / errorResponse | 数据样板收口：shape 声明 → `bodyOf`（body 校验·类型精确）/ `listQuery`（URL 参数）/ `errorResponse`（catch 映射）——手写 route 三件套（docs/server.md §5.3/§5.4.1） |
 | `weifuwu` | ui | SSR 渲染 + esbuild JS/CSS 动态编译（`ctx.ui`） |
-| `weifuwu/vdom` | UIRouter / uiServe / uiSsr | 前端路由唯一入口 + 浏览器 boot + SSR（结构吸收） |
-| `weifuwu/vdom` | 命令流引擎 + hooks 全家 | 渲染周期/事件代理/三状态机 + useAsyncData/usePopup/useControlled/… |
-| `weifuwu/components` | **134 个组件** | Button/Table/Modal/AiChat/… + `toast()`/`confirm()` 命令式中间件 |
+| `weifuwu/client/vdom` | UIRouter / uiServe / uiSsr | 前端路由唯一入口 + 浏览器 boot + SSR（结构吸收） |
+| `weifuwu/client/vdom` | 命令流引擎 + hooks 全家 | 渲染周期/事件代理/三状态机 + useAsyncData/usePopup/useControlled/… |
+| `weifuwu/client/components` | **134 个组件** | Button/Table/Modal/AiChat/… + `toast()`/`confirm()` 命令式中间件 |
 | `weifuwu/layout` | CSS 布局 | 50 个布局原语 + 98 个工具类 + 176 个主题 Token |
 | `weifuwu` | rateLimit / email / userSystem / messager / queue / scheduler / ai / graphql | SaaS 地基中间件（ctx 注入） |
 | `weifuwu/dev` | dev loader | `--import weifuwu/dev` 直接跑 `.ts/.tsx` |

package/dist/client/components/ActionSheet/ActionSheet.d.ts

@@ -1,6 +1,6 @@
 /** ActionSheet：动作面板——移动端底部滑出（命令列表 + 取消按钮，usePopup 会话级模态）（showcase /components/actionsheet） */
 /**
- * weifuwu/components — ActionSheet 动作面板（移动端底部滑出）
+ * weifuwu/client/components — ActionSheet 动作面板（移动端底部滑出）
  *
  * 命令列表 + 取消按钮（iOS 风格）——移动端 App 常用弹层（照片选择/分享/
  * 更多操作）。与 Modal/Drawer 同款会话级模态（openPopup presence 退场状态机 +

package/dist/client/components/AlertGroup/AlertGroup.d.ts

@@ -1,6 +1,6 @@
 /** AlertGroup：通知合并组：≥3 条折叠为 +N，点击展开（showcase /components/alertgroup） */
 /**
- * weifuwu/components — AlertGroup 通知合并组
+ * weifuwu/client/components — AlertGroup 通知合并组
  *
  * 三库等价：EP AlertGroup（2.8 新增）。
  * 同类通知合并折叠：≥3 条折叠为摘要 +N，点击展开：

package/dist/client/components/Anchor/Anchor.d.ts

@@ -1,6 +1,6 @@
 /** Anchor：锚点导航：滚动高亮跟随 + 点击平滑滚动（showcase /components/anchor） */
 /**
- * weifuwu/components — Anchor
+ * weifuwu/client/components — Anchor
  *
  * 锚点导航（长文页）：items 列表 + 滚动高亮跟随 + 点击平滑滚动。
  * 滚动侦听：ctx.ui.useScrollPosition（全局/容器 scroll 监听 + rAF 节流，内置方案）。

package/dist/client/components/AppShell/AppShell.d.ts

@@ -1,13 +1,13 @@
 /** AppShell：应用壳——品牌 + 分组导航 + 用户区 + 主内容（受控——父层驱动）（showcase /components/appshell） */
 /**
- * weifuwu/components — AppShell
+ * weifuwu/client/components — AppShell
  *
  * 应用壳（SaaS 侧栏布局）：品牌区 + 导航菜单 + 用户区 + 主内容区——
  * 认证守卫/导航/用户数据由父层驱动（受控——组件零 fetch 零路由依赖）。
  *
  * 来源：agent-platform AppLayout（侧栏壳——Menu/Avatar/Button 组装样板）
  * 沉淀——每个 SPA 应用的重复样板：品牌 + 分组菜单 + 用户信息 + 设置/
- * 退出操作 + 守卫加载态。样式复用 weifuwu/layout 的 app-shell 原语
+ * 退出操作 + 守卫加载态。样式复用 weifuwu/client/layout 的 app-shell 原语
  * （wf-app-shell + wf-sidebar 系列 + wf-main——grid 栅格 + 移动端降级），
  * 组件只补品牌区/用户区细节（AppShell.css）。
  *

package/dist/client/components/AuthPage/AuthPage.d.ts

@@ -1,6 +1,6 @@
 /** AuthPage：认证页骨架：居中卡片 + logo + 表单插槽 + 错误条 + 提交 loading（登录/注册复用）（showcase /components/authpage） */
 /**
- * weifuwu/components — AuthPage
+ * weifuwu/client/components — AuthPage
  *
  * 认证页骨架（登录/注册复用——agent-platform Login/Register 抽取）。
  * 布局：居中卡片 + logo + 标题/副标题 + 表单插槽 + 错误条 + 提交 loading + 底部链接。

package/dist/client/components/AutoComplete/AutoComplete.d.ts

@@ -1,6 +1,6 @@
 /** AutoComplete：输入联想：自由输入 + 过滤下拉 + 键盘流 + 选中回填（showcase /components/autocomplete） */
 /**
- * weifuwu/components — AutoComplete 输入联想
+ * weifuwu/client/components — AutoComplete 输入联想
  *
  * 三库等价：antd AutoComplete / EP Autocomplete / shadcn Combobox（输入侧）。
  * 自由输入 + 实时联想下拉：包含匹配（不区分大小写）、键盘 ↓↑/Enter/Escape、

package/dist/client/components/AvatarGroup/AvatarGroup.d.ts

@@ -1,6 +1,6 @@
 /** AvatarGroup：头像组：堆叠 + max 溢出 +N（showcase /components/avatargroup） */
 /**
- * weifuwu/components — AvatarGroup
+ * weifuwu/client/components — AvatarGroup
  *
  * 堆叠头像组（负 margin 重叠）+ max 溢出显示 +N。
  * 用于群聊成员、协作人列表。

package/dist/client/components/Button/Button.d.ts

@@ -1,5 +1,11 @@
 /** Button：4 variants × 3 sizes + loading + block + disabled（showcase /components/button） */
-import type { Component, VNodeChild } from '../../vdom/index.ts';
+/**
+ * weifuwu/client/components — Button
+ *
+ * 2027-09 W3：状态类（variant/size/block/loading）+ aria-busy → createComponent
+ * 声明（BEM 直拼单源）——render 只写结构/内容/事件（皮）。
+ */
+import type { VNodeChild } from '../../vdom/index.ts';
 export interface ButtonProps {
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'danger-ghost';
     size?: 'sm' | 'md' | 'lg';
@@ -17,4 +23,4 @@ export interface ButtonProps {
     onClick?: (e: MouseEvent) => void;
     children?: VNodeChild;
 }
-export declare const Button: Component<ButtonProps>;
+export declare const Button: import("../../vdom/index.ts").Component<ButtonProps>;

package/dist/client/components/Chart/Chart.d.ts

@@ -1,6 +1,6 @@
 /** Chart：SVG 图表：line/bar/pie/radar/gauge/scatter——零依赖自绘（showcase /components/chart） */
 /**
- * weifuwu/components — Chart
+ * weifuwu/client/components — Chart
  */
 import type { Component } from '../../vdom/index.ts';
 import type { DataPoint, ChartType, ChartOptions } from './chart-utils.ts';

package/dist/client/components/Chart/chart-utils.d.ts

@@ -1,6 +1,6 @@
 /** Chart：SVG 图表：line/bar/pie/radar/gauge/scatter——零依赖自绘（showcase /components/chart） */
 /**
- * weifuwu/components — Chart 纯函数坐标计算
+ * weifuwu/client/components — Chart 纯函数坐标计算
  *
  * 无 DOM 依赖，可测试。
  */

package/dist/client/components/ChatInput/ChatInput.d.ts

@@ -1,6 +1,6 @@
 /** ChatInput：独立聊天输入条（AiChat 抽取）：单行/多行 + streaming 停止 + IME 安全——不自带聊天逻辑（showcase /components/chatinput） */
 /**
- * weifuwu/components — ChatInput
+ * weifuwu/client/components — ChatInput
  *
  * 独立复用的聊天输入条（从 AiChat 抽取——消 AiChat 内置 + 消费方手搓双重复）。
  * 纯输入层：不自带聊天逻辑（useChat 组合在消费方——AiChat 传入 chat handle，
@@ -44,6 +44,8 @@ export interface ChatInputProps {
     multiline?: boolean;
     /** 标签（i18n 覆盖） */
     labels?: Partial<ChatInputLabels>;
+    /** 占位文案（缺省 labels.placeholder） */
+    placeholder?: string;
     /** 扩展位（附件/知识库/模型选择等） */
     actions?: VNode | null;
     /** 外部程序化控制（@ 补全等场景）——mount 期回调上抛稳定 handle（{ setKeyword, setValue }）——

package/dist/client/components/CodeBlock/CodeBlock.d.ts

@@ -1,6 +1,6 @@
 /** CodeBlock：代码块：语言标签 + 复制按钮 + 横向滚动（showcase /components/codeblock） */
 /**
- * weifuwu/components — CodeBlock
+ * weifuwu/client/components — CodeBlock
  *
  * 代码展示块：语言标签 + 复制按钮 + 横向滚动 + 自研轻量语法高亮
  * （highlight.ts tokenizer——零依赖 FS-05）。

package/dist/client/components/CodeBlock/highlight.d.ts

@@ -1,6 +1,6 @@
 /** CodeBlock：代码块：语言标签 + 复制按钮 + 横向滚动（showcase /components/codeblock） */
 /**
- * weifuwu/components — 轻量语法高亮 tokenizer
+ * weifuwu/client/components — 轻量语法高亮 tokenizer
  *
  * 零依赖（FS-05）：正则单 pass 扫描，覆盖常见语法（注释/字符串/关键字/
  * 数字/函数调用/JSX 标签/操作符）。不追求完美分词（不做括号配对、多行

package/dist/client/components/Confirm/Confirm.d.ts

@@ -1,6 +1,6 @@
 /** Confirm：确认对话框，Promise 化 await 调用（showcase /components/confirm） */
 /**
- * weifuwu/components — Confirm 确认对话框
+ * weifuwu/client/components — Confirm 确认对话框
  *
  * 声明式：基于 Modal 封装，footer 自带「取消 / 确定」按钮。
  * 命令式：confirm() 中间件注入 ctx.confirm()，返回 Promise<boolean>。

package/dist/client/components/CronPicker/CronPicker.d.ts

@@ -1,7 +1,7 @@
 /** CronPicker：cron 表达式快捷输入（预置常见 + 自由编辑）（showcase /components/cronpicker） */
 import type { Component } from '../../vdom/index.ts';
 /**
- * weifuwu/components — CronPicker
+ * weifuwu/client/components — CronPicker
  *
  * cron 表达式输入原语：预置语义 + 自由编辑双通道。
  * - 预置面：常见档（每分钟/每 5 分钟/每小时/每天/工作日——单源 PRESETS）

package/dist/client/components/DatePicker/DatePicker.d.ts

@@ -1,6 +1,6 @@
 /** DatePicker：日期选择器，四种模式：date/datetime/time/range（showcase /components/datepicker） */
 /**
- * weifuwu/components — DatePicker
+ * weifuwu/client/components — DatePicker
  *
  * 四合一日期选择器，支持 mode: date | datetime | time | range
  * 统一 openPopup 内核：focus 触发 + mask 遮罩 + 自由定位（left 对齐 + width 跟随 trigger）。

package/dist/client/components/DatePicker/calendar-utils.d.ts

@@ -1,6 +1,6 @@
 /** DatePicker：日期选择器，四种模式：date/datetime/time/range（showcase /components/datepicker） */
 /**
- * weifuwu/components — DatePicker 日期计算工具
+ * weifuwu/client/components — DatePicker 日期计算工具
  *
  * 纯函数，无 DOM 依赖，可测试。
  */

package/dist/client/components/Descriptions/Descriptions.d.ts

@@ -1,6 +1,6 @@
 /** Descriptions：描述列表：label/value 栅格 + bordered + span（详情页）（showcase /components/descriptions） */
 /**
- * weifuwu/components — Descriptions
+ * weifuwu/client/components — Descriptions
  *
  * 详情字段展示：label/value 栅格（<dl> 语义结构，屏幕阅读器友好）。
  * 用于 Agent 配置展示、实体详情、订单信息等只读字段场景。

package/dist/client/components/Drawer/Drawer.d.ts

@@ -1,6 +1,9 @@
 /** Drawer：侧边面板，左右滑入 + ESC 关闭（showcase /components/drawer） */
 /**
- * weifuwu/components — Drawer
+ * weifuwu/client/components — Drawer
+ *
+ * 2027-09 原语全面化 W1：行为面（openPopup 生命周期/焦点 trap/滚动锁/Esc/
+ * 遮罩点击）→ useOverlay 契约——组件只写皮（overlay/panel/关闭钮/header/footer）。
  */
 import type { Component, VNodeChild } from '../../vdom/index.ts';
 export type DrawerPosition = 'left' | 'right';

package/dist/client/components/DropZone/DropZone.d.ts

@@ -1,6 +1,6 @@
 /** DropZone：全区域拖放区——整容器拖入文件高亮 + onFiles 回调（现代 IM 标配——Chat 手搓证据）（showcase /components/dropzone） */
 /**
- * weifuwu/components — DropZone 全区域拖放区
+ * weifuwu/client/components — DropZone 全区域拖放区
  *
  * 整容器拖放目标：文件拖入指定区域任意位置（含悬停子元素）即高亮 + drop 回调
  * ——「现代 IM 标配」手搓实证 agent-platform Chat

package/dist/client/components/Dropdown/Dropdown.d.ts

@@ -1,6 +1,6 @@
 /** Dropdown：下拉菜单，支持 danger variant（showcase /components/dropdown） */
 /**
- * weifuwu/components — Dropdown
+ * weifuwu/client/components — Dropdown
  *
  * openPopup 内核：click 触发 + 受控 open + 外部点击/Escape（document 级，
  * 弹层在 portal 中按 Escape 也能关）+ 定位/视口 clamp + portal。

package/dist/client/components/Editor/Editor.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor — 富文本编辑器（事件流事务层，阶段 1）
+ * weifuwu/client/components/Editor — 富文本编辑器（事件流事务层，阶段 1）
  *
  * 架构（）：文档 = fold(edit 事件流)。
  * - 模型真相：DocState（contentEditable DOM 是渲染）

package/dist/client/components/Editor/edit-events.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/edit-events — 编辑事件流（第四端）
+ * weifuwu/client/components/Editor/edit-events — 编辑事件流（第四端）
  *
  * 与 ai/sandbox 事件流同构（ / sandbox-events-plan.md）：
  * 环形缓冲 + 查询（按动作过滤）+ 订阅 + 全局调试工具。

package/dist/client/components/Editor/model/apply.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/model/apply — 事件应用（文档 = fold(事件流)）
+ * weifuwu/client/components/Editor/model/apply — 事件应用（文档 = fold(事件流)）
  *
  * applyEdit(doc, ev) 纯函数：任意事件 → 新 DocState（不可变）。
  * 所有 offset 平移在单一入口维护（marks/blockProps/embeds/caret 同步——

package/dist/client/components/Editor/model/diff.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/model/diff — 文本 diff（AI 建议对比用）
+ * weifuwu/client/components/Editor/model/diff — 文本 diff（AI 建议对比用）
  *
  * 零依赖：公共前缀/后缀剪枝 + 中间 LCS（滚动数组 O(m) 空间）。
  * 裁剪：总长度超 DIFF_MAX_LEN 退化为整体替换（诚实裁剪——大文本不追求

package/dist/client/components/Editor/model/dom.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/model/dom — offset ↔ DOM 桥
+ * weifuwu/client/components/Editor/model/dom — offset ↔ DOM 桥
  *
  * doc.text 的 offset 与 contentEditable DOM 的双向映射：
  * - 文本节点：按 nodeValue.length 累加

package/dist/client/components/Editor/model/history.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/model/history — undo/redo 栈（commit 粒度）
+ * weifuwu/client/components/Editor/model/history — undo/redo 栈（commit 粒度）
  *
  * 撤销粒度 = commit 粒度（AI 流式接受 = 1 个 commit = 1 个撤销步）。
  * 栈本身只存事件——状态折叠由调用方（Editor 层）执行 applyEdit。

package/dist/client/components/Editor/model/html.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/model/html — HTML ⇄ DocState 序列化
+ * weifuwu/client/components/Editor/model/html — HTML ⇄ DocState 序列化
  *
  * 只认 Editor 格式子集（诚实裁剪）：p/div/h1-3/blockquote/ul/ol（块）、
  * b/strong/i/em/u/a（内联）、img/table/hr（embed 快照——内部不解析）、

package/dist/client/components/Editor/model/inverse.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/model/inverse — 事件逆操作（undo 基元）
+ * weifuwu/client/components/Editor/model/inverse — 事件逆操作（undo 基元）
  *
  * 任意事件 → 逆事件（与 vdom3 events.ts inverse() 同构）。不变量：
  * applyEdit(applyEdit(doc, ev), inverseEdit(ev)) === doc。

package/dist/client/components/Editor/model/types.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/model — 文档模型（事件流底座）
+ * weifuwu/client/components/Editor/model — 文档模型（事件流底座）
  *
  * 核心不变量（）：文档状态 = fold(edit 事件流)。
  * 本文档模型是纯 TS 数据结构 + 纯函数（无 DOM、无 UI）——阶段 0 验收：

package/dist/client/components/Editor/tools/table.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/tools — 表格工具
+ * weifuwu/client/components/Editor/tools — 表格工具
  *
  * 事件流事务层（ 阶段 1）：表格 = embed 事件——
  * 本模块只生成 HTML（不再操作 DOM/execCommand）。

package/dist/client/components/Editor/tools/toolbar.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/tools — 工具栏渲染
+ * weifuwu/client/components/Editor/tools — 工具栏渲染
  */
 import type { VNode } from '../../../vdom/index.ts';
 import type { FormatState, ToolbarItem } from './types.ts';

package/dist/client/components/Editor/tools/types.d.ts

@@ -1,6 +1,6 @@
 /** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
- * weifuwu/components/Editor/tools — 类型定义
+ * weifuwu/client/components/Editor/tools — 类型定义
  */
 export type ToolbarItem = 'bold' | 'italic' | 'underline' | 'h1' | 'h2' | 'h3' | 'ul' | 'ol' | 'blockquote' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'hr' | 'image' | 'table' | 'link' | 'clear' | 'source';
 export interface EditorProps {

package/dist/client/components/FilePreview/FilePreview.d.ts

@@ -1,6 +1,6 @@
 /** FilePreview：文件预览（md/html/pdf/office）——基于事件流，可编辑（showcase /components/filepreview） */
 /**
- * weifuwu/components/FilePreview — 文件预览（office/pdf/md/html/text）
+ * weifuwu/client/components/FilePreview — 文件预览（office/pdf/md/html/text）
  *
  * 架构（ —— ODES 事件流底座）：
  * - md 预览：复用 `<Markdown>` 组件（安全 token 渲染——表格/任务列表/URL 白名单）

package/dist/client/components/FilePreview/markdown.d.ts

@@ -1,6 +1,6 @@
 /** FilePreview：文件预览（md/html/pdf/office）——基于事件流，可编辑（showcase /components/filepreview） */
 /**
- * weifuwu/components/FilePreview/markdown — Markdown 转换（编辑桥）
+ * weifuwu/client/components/FilePreview/markdown — Markdown 转换（编辑桥）
  *
  * 复用现有 Markdown 组件（src/components/Markdown/parser.ts——安全子集 token 树：
  * 表格/任务列表/删除线/安全 URL 白名单——不重复造轮子）。

package/dist/client/components/FileTree/FileTree.d.ts

@@ -1,6 +1,6 @@
 /** FileTree：文件树浏览器——面包屑 + 列表/编辑态 + 上传（受控——数据源无关）（showcase /components/filetree） */
 /**
- * weifuwu/components — FileTree
+ * weifuwu/client/components — FileTree
  *
  * 文件树浏览器（工作空间/目录浏览场景）：面包屑 + 工具行（上传/刷新）+
  * 目录/文件列表（图标/大小/时间）+ 文件编辑态（textarea + 保存/返回）。

package/dist/client/components/FileUpload/FileUpload.d.ts

@@ -1,6 +1,6 @@
 /** FileUpload：文件上传，拖拽区 + 文件列表 + accept/maxSize（showcase /components/fileupload） */
 /**
- * weifuwu/components — FileUpload
+ * weifuwu/client/components — FileUpload
  */
 import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface FileUploadProps {

package/dist/client/components/FloatButton/FloatButton.d.ts

@@ -1,6 +1,6 @@
 /** FloatButton：悬浮按钮组：展开状态机 + badge（showcase /components/floatbutton） */
 /**
- * weifuwu/components — FloatButton 悬浮操作按钮
+ * weifuwu/client/components — FloatButton 悬浮操作按钮
  *
  * 三库等价：antd FloatButton（特有——EP/shadcn 无独立等价）。
  * 固定视口定位 + badge + 组展开状态机：

package/dist/client/components/Grid/Grid.d.ts

@@ -1,6 +1,6 @@
 /** Grid：24 栅格 + gutter + flex 容器模式（Row/Col/Flex 等价）（showcase /components/grid） */
 /**
- * weifuwu/components — Grid 栅格 + Flex 容器
+ * weifuwu/client/components — Grid 栅格 + Flex 容器
  *
  * 三库等价：antd Row/Col/Flex、EP Row/Col。
  * 24 栅格 + gutter + flex 容器模式（单行弹性布局 = antd Flex 场景）：

package/dist/client/components/Highlight/Highlight.d.ts

@@ -1,6 +1,6 @@
 /** Highlight：搜索词高亮：分词渲染 mark，大小写不敏感（showcase /components/highlight） */
 /**
- * weifuwu/components — Highlight
+ * weifuwu/client/components — Highlight
  *
  * 搜索词高亮：给定文本 + 高亮词数组 → 分词渲染 <mark>（零依赖，VNode 拼接）。
  * 配合 SearchInput/Table 搜索结果命中展示。

package/dist/client/components/HoverCard/HoverCard.d.ts

@@ -1,6 +1,6 @@
 /** HoverCard：悬停富内容卡：openDelay 延迟 + 任意 VNode（shadcn）（showcase /components/hovercard） */
 /**
- * weifuwu/components — HoverCard
+ * weifuwu/client/components — HoverCard
  *
  * 命令式弹窗（一个形态——ctx.ui.openPopup——toast 心智）：hover 触发
  * （触屏自动降级 tap）+ openDelay/closeDelay + 定位/视口 clamp + Escape。

package/dist/client/components/Icon/Icon.d.ts

@@ -1,6 +1,6 @@
 /** Icon：stroke SVG 图标集，currentColor 着色，随字号缩放（showcase /components/icon） */
 /**
- * weifuwu/components — Icon 内联 SVG 图标
+ * weifuwu/client/components — Icon 内联 SVG 图标
  *
  * 24px stroke 风格（feather-like），currentColor 着色随文字/上下文，
  * 零外部依赖（FS-05）。组件内部图标统一走这里，替换文本字形/emoji。

package/dist/client/components/Img/Img.d.ts

@@ -1,6 +1,6 @@
 /** Img：图片 \\<img\\> 组件：fallback / lazy / preview 点击放大（showcase /components/img） */
 /**
- * weifuwu/components — Img
+ * weifuwu/client/components — Img
  */
 import type { Component } from '../../vdom/index.ts';
 export interface ImgProps {

package/dist/client/components/InView/InView.d.ts

@@ -1,6 +1,6 @@
 /** InView：进入视窗后懒加载内容，支持 IntersectionObserver（showcase /components/inview） */
 /**
- * weifuwu/components — InView
+ * weifuwu/client/components — InView
  *
  * 进入视窗后替换占位符为真实内容。
  * 实现：ctx.ui.useInView（IO 封装）——滚动/尺寸变化由合成器线程评估，无 scroll 监听。

package/dist/client/components/Input/Input.d.ts

@@ -1,4 +1,10 @@
 /** Input：text/email/password/number，支持 label/error/hint/required（showcase /components/input） */
+/**
+ * weifuwu/client/components — Input
+ *
+ * 2027-09 W5：label/required/error/hint 块 + aria 连接（aria-invalid/
+ * aria-describedby/aria-required/label for）→ useField 契约——组件只写输入面。
+ */
 import type { Component } from '../../vdom/index.ts';
 export interface InputProps {
     label?: string;

package/dist/client/components/InputNumber/InputNumber.d.ts

@@ -1,6 +1,6 @@
 /** InputNumber：数字输入：min/max/step + 增减按钮 + precision（showcase /components/inputnumber） */
 /**
- * weifuwu/components — InputNumber
+ * weifuwu/client/components — InputNumber
  *
  * 数字输入：min/max/step + 增减按钮 + precision 格式化 + 长按连增。
  * 受控 value: number | null；空值 → null；输入 clamp 到 min/max。

package/dist/client/components/JSONViewer/JSONViewer.d.ts

@@ -1,6 +1,6 @@
 /** JSONViewer：结构化 JSON：递归折叠 + 类型色 + 路径复制 + 懒展开（showcase /components/jsonviewer） */
 /**
- * weifuwu/components — JSONViewer
+ * weifuwu/client/components — JSONViewer
  *
  * 结构化 JSON 浏览（工具调用 args / API 响应）：递归树 + 折叠 + 类型色 + 路径复制 + 懒展开。
  * 零依赖（无 raw JSON.parse 展示——VNode 渲染天然转义）。

package/dist/client/components/Layout/Layout.d.ts

@@ -1,6 +1,6 @@
 /** Layout：布局外壳：Sider 折叠 + Header/Content/Footer 骨架（antd Layout / shadcn Sidebar 等价）（showcase /components/layout） */
 /**
- * weifuwu/components — Layout 布局外壳
+ * weifuwu/client/components — Layout 布局外壳
  *
  * 三库等价：antd Layout / Element Plus Container / shadcn Sidebar。
  * 复合子组件模式（无命名空间——独立导出）：

package/dist/client/components/Link/Link.d.ts

@@ -1,6 +1,6 @@
 /** Link：文字链接：语义色/下划线/disabled/新窗口（showcase /components/link） */
 /**
- * weifuwu/components — Link 文字链接
+ * weifuwu/client/components — Link 文字链接
  *
  * 三库等价：EP Link / antd Typography.Link（内嵌）。
  * 语义色/下划线/disabled/新窗口/图标——原语 a 的组件化。

package/dist/client/components/List/List.d.ts

@@ -1,6 +1,6 @@
 /** List：通用列表：renderItem + divided + header/footer/empty（showcase /components/list） */
 /**
- * weifuwu/components — List
+ * weifuwu/client/components — List
  *
  * 通用列表：items + renderItem + header/footer/empty 占位。
  * 定位：Table 大材小用的消息/文件/成员列表场景。

package/dist/client/components/ListScaffold/ListScaffold.d.ts

@@ -1,7 +1,7 @@
-/** ListScaffold：列表页骨架（PageHeader + 工具栏 + loading/empty + 内容插槽）（showcase /components/list-scaffold） */
+/** ListScaffold：列表页骨架（PageHeader + 工具栏 + loading/empty + 内容插槽）（showcase /components/listscaffold） */
 import type { Component, VNodeChild } from '../../vdom/index.ts';
 /**
- * weifuwu/components — ListScaffold
+ * weifuwu/client/components — ListScaffold
  *
  * 列表页骨架原语：PageHeader + 搜索/工具区 + loading/empty 态 + 内容插槽。
  * 各页面差异在内容循环（render 插槽）——头部/状态区单点一致。

package/dist/client/components/LogViewer/LogViewer.d.ts

@@ -1,6 +1,6 @@
 /** LogViewer：日志流：ANSI 着色 + 虚拟滚动 + 自动跟随 + 复制（showcase /components/logviewer） */
 /**
- * weifuwu/components — LogViewer
+ * weifuwu/client/components — LogViewer
  *
  * 日志流查看器（Agent 执行日志 / CI 输出）：ANSI 着色 + 虚拟滚动 + 自动跟随。
  * 复用 VirtualList 滚动基座（useScrollPosition + rAF 节流）。

package/dist/client/components/Markdown/Markdown.d.ts

@@ -1,6 +1,6 @@
 /** Markdown：AI 回复渲染：安全子集 parser + 代码块 + 链接白名单（showcase /components/markdown） */
 /**
- * weifuwu/components — Markdown
+ * weifuwu/client/components — Markdown
  *
  * AI 回复/富文本渲染。安全子集解析 → VNode 渲染（天然转义，无 innerHTML 注入面）。
  * 与 CodeBlock 组合渲染代码围栏。

package/dist/client/components/Markdown/parser.d.ts

@@ -1,6 +1,6 @@
 /** Markdown：AI 回复渲染：安全子集 parser + 代码块 + 链接白名单（showcase /components/markdown） */
 /**
- * weifuwu/components — Markdown 安全子集 parser
+ * weifuwu/client/components — Markdown 安全子集 parser
  *
  * 零依赖自研解析器，输出结构化 token（非 HTML 字符串）——
  * 组件层以 VNode 渲染，天然转义任何用户/AI 内容（无 innerHTML 注入面）。

package/dist/client/components/Menu/Menu.d.ts

@@ -1,6 +1,6 @@
 /** Menu：侧栏导航：分组 + 图标 + 选中态 + 方向键（showcase /components/menu） */
 /**
- * weifuwu/components — Menu
+ * weifuwu/client/components — Menu
  *
  * 导航菜单（侧栏导航）：分组项 + 图标 + 选中态 + 方向键导航 + Enter 激活 + 子菜单 + 折叠。
  * 用于 SaaS 应用侧边导航（替代手写 nav-item 循环）。

package/dist/client/components/MessageBubble/MessageBubble.d.ts

@@ -1,6 +1,6 @@
 /** MessageBubble：消息气泡：user/assistant + streaming/error 状态 + actions（showcase /components/messagebubble） */
 /**
- * weifuwu/components — MessageBubble
+ * weifuwu/client/components — MessageBubble
  *
  * 独立消息气泡（从 AiChat 气泡层抽取，业务聊天页复用）。
  * 复用 layout 的 wf-bubble 原语：user → --own，assistant → --ai。

package/dist/client/components/Modal/Modal.d.ts

@@ -1,6 +1,10 @@
 /** Modal：自定义宽度 + closable 控制关闭按钮（showcase /components/modal） */
 /**
- * weifuwu/components — Modal
+ * weifuwu/client/components — Modal
+ *
+ * 行为面（2027-09 分层抽象 W2）：openPopup 生命周期/焦点 trap/滚动锁/Esc/
+ * 遮罩点击 → useOverlay 契约（手搓面消除——行为正确性结构性保证）。
+ * 组件只写皮：overlay（遮罩）+ content（面板）+ 关闭按钮/标题/footer。
  */
 import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface ModalProps {

package/dist/client/components/NavBar/NavBar.d.ts

@@ -1,6 +1,6 @@
 /** NavBar：移动端顶栏——left 槽（返回/菜单）+ 标题截断 + right 槽（antd-mobile NavBar 对位）（showcase /components/navbar） */
 /**
- * weifuwu/components — NavBar 移动端顶栏（antd-mobile NavBar / MUI AppBar 对位）
+ * weifuwu/client/components — NavBar 移动端顶栏（antd-mobile NavBar / MUI AppBar 对位）
  *
  * 移动端 App 应用外壳顶栏：left 槽（返回/菜单按钮）+ 标题（单行截断）+ right 槽
  * （操作按钮）——消费侧手搓实证 agent-platform `ap-topbar`