weifuwu 0.78.0 → 0.80.0

package/docs/components.md

@@ -2,7 +2,7 @@
 
 > 本页为 weifuwu 官方文档拆分页 · [返回 README](../README.md)
 
-113 个 HTML 原语组件。每个是 `async (initProps, ctx) => (props) => Promise<VNode>`（两阶段组件，与前端框架同一模型——外层工厂 + 内层 renderFn 强制异步），引用 `--wf-*` CSS 变量做主题。另含 `confirm()` / `toast()` 命令式中间件。
+115 个 HTML 原语组件。每个是 `async (initProps, ctx) => (props) => Promise<VNode>`（两阶段组件，与前端框架同一模型——外层工厂 + 内层 renderFn 强制异步），引用 `--wf-*` CSS 变量做主题。另含 `confirm()` / `toast()` 命令式中间件。
 
 > **组件速查（weifuwu 组件 ↔ antd / Element Plus / shadcn-ui 对应 + 迁移示例）**：见 [`docs/components-map.md`](components-map.md)——从其他组件库迁来的开发者按功能直接找对应组件。
 > **自定义组件开发**：见 [docs/custom-components.md](custom-components.md)——usePopup/useControlled/对话框/AI 组件/类型纪律逐步指南。
@@ -301,6 +301,7 @@ props 变化 ──────────────────────
 | `onChange` | `(value: string) => void` | — |
 | `placeholder` | `string` | — |
 | `disabled` | `boolean` | — |
+| `error` | `string` | 错误态——输入框错误样式 + aria-invalid（F2 状态矩阵） |
 
 ### Form（表单增强）
 | Prop | 类型 | 说明 |
@@ -614,7 +615,7 @@ props 变化 ──────────────────────
 | ContextMenu | `ContextMenu` | `items: ContextMenuItem[]`（`{ label, onClick, variant: 'danger' }`） | 右键菜单（光标定位 + 方向键） |
 | Mentions | `Mentions` | `options: { value, label }[]`, `value`, `onChange`, `prefix` | @提及（composition 抑制） |
 | Collapse | `Collapse` | `items: CollapseItem[]`（`{ key, title, content, loading }`）, `active`, `multiple` | 行内折叠（异步 loading） |
-| Tree | `Tree` | `data: TreeNode[]`, `expandedKeys`, `checkedKeys`, `checkable`, `selectedKeys`, `onCheck/onExpand/onSelect` | 树（递归 + 勾选父子联动 + 半选传播） |
+| Tree | `Tree` | `data: TreeNode[]`, `expandedKeys`, `checkedKeys`, `checkable`, `selectedKeys`, `onCheck/onExpand/onSelect` | 树（递归 + 勾选父子联动 + 半选传播；空数据「暂无数据」） |
 | Cascader | `Cascader` | `options: CascaderOption[]`, `value: string[]`, `onChange` | 级联选择（多列推进） |
 | Transfer | `Transfer` | `data: { key, label }[]`, `targetKeys`, `onChange`, `titles` | 穿梭框（选中 + 批量移动） |
 | Command | `Command` | `items: CommandItem[]`, `open`, `onOpenChange`, `shortcut` | 命令面板（⌘K 全局 + 键盘流） |
@@ -623,7 +624,7 @@ props 变化 ──────────────────────
 | Resizable | `Resizable` | `direction`, `defaultSize`, `min/maxSize` | 拖拽分割面板（pointer + 键盘方向键） |
 | Calendar | `Calendar` | `month`, `year`, `events`, `selectedDate`, `onMonthChange/onSelectDate` | 月历（事件点 + 月切换 + 选日） |
 | Watermark | `Watermark` | `text`, `fontSize`, `rotate`, `zIndex` | 水印（canvas 平铺） |
-| VirtualList | `VirtualList` | `items`, `height`, `itemHeight`, `renderItem`, `overscan` | 虚拟列表（spacer + 可见窗口，1000+ 条） |
+| VirtualList | `VirtualList` | `items`, `height`, `itemHeight`, `renderItem`, `overscan`, `emptyText` | 虚拟列表（spacer + 可见窗口，1000+ 条；空态占位） |
 | InfiniteScroll | `InfiniteScroll` | `hasMore`, `loadMore`, `children`, `loader` | 触底加载（IntersectionObserver） |
 | QRCode | `QRCode` | `value`, `ecLevel`, `size`, `color`, `bgColor` | 二维码（自研 Reed-Solomon，版本 1-6） |
 
@@ -640,12 +641,14 @@ props 变化 ──────────────────────
 | 组件 | 导入名 | 关键 Props | 说明 |
 |-----|--------|-----------|------|
 | Divider | `Divider` | `vertical` | 分割线（水平带文字放 children，`vertical` 垂直） |
+| AuthPage | `AuthPage` | `title`, `subtitle?`, `logo?`, `children`, `footer?`, `submitLabel`, `loading?`, `error?`, `onSubmit?` | 认证页骨架：居中卡片 + logo + 标题/副标题 + 表单插槽 + 错误条 + 提交 loading + 底部链接（登录/注册复用；认证流程/跳转由消费方提供） |
 
 ### AI 交互原语（wf: 协议配套）
 
 | 组件 | 导入名 | 关键 Props | 说明 |
 |-----|--------|-----------|------|
 | AiChat | `AiChat` | `chat`, `maxHeight?`, `labels?`, `renderMessage?`, `renderToolArgs?` | 标准 AI 对话界面：气泡 + 工具卡 + 审批卡 + 自动滚动 + 错误重试（接收 `ctx.ui.useChat()` handle） |
+| ChatInput | `ChatInput` | `value`, `onChange`, `onSend`, `streaming?`, `onStop?`, `error?`, `onRetry?`, `multiline?`, `actions?` | 独立聊天输入条（AiChat 抽取）：单行/多行（Enter 发送/Shift+Enter 换行）+ streaming 停止切换 + §5.3 IME 受控输入纪律——纯输入层，聊天逻辑（useChat）由消费方组合 |
 | MessageBubble | `MessageBubble` | `content`, `role`, `status`, `actions` | 独立消息气泡（业务聊天页复用） |
 | ToolCallCard | `ToolCallCard` | `call`, `progress?`, `result?`, `renderArgs?` | 工具调用卡片：running（进度条）/ ok / error 三态（协议 §4） |
 | JsonSchemaForm | `JsonSchemaForm` | `schema`, `value?`, `onChange?`, `onSubmit?`, `submitLabel?` | JSON Schema（对象子集）→ 参数输入表单：类型映射 + required/范围校验 + 嵌套/数组（工具参数输入面；不支持项告警降级） |

package/docs/frontend-ui-dom.md

@@ -31,7 +31,7 @@ const Counter = async (initProps, ctx) => {
 ```
 
 - **没有 hooks 规则、没有依赖数组、没有闭包陷阱**。外层 = 初始化（一次），内层 = 渲染（每次变化）。
-- **render-only 确定性渲染**（design/render-only-plan.md）：渲染只发生在 `ctx.ui.render()` 调用处——改状态后显式 `render()`，行为可静态推导。无 `$` Proxy、无隐式触发；跨组件共享用 `createStore` + `ctx.ui.useExternal()`。
+- **render-only 确定性渲染**：渲染只发生在 `ctx.ui.render()` 调用处——改状态后显式 `render()`，行为可静态推导。无 `$` Proxy、无隐式触发；跨组件共享用 `createStore` + `ctx.ui.useExternal()`。
 
 ### 框架即纪律：浏览器环境抽象把常见坑变成编译期/审计期错误
 
@@ -42,7 +42,7 @@ const Counter = async (initProps, ctx) => {
 
 - **零 npm 运行时依赖**（对比 React + react-dom + react-router + 状态库 + SSR 工具 5+ 依赖）。
 - **自研 VDOM/diff**（keyed children、style diff、CSS 变量、Portal、hydration 游标收养）——每个算法都有对应测试与纪律条目（真实事故沉淀）。**读源码即可完全理解框架行为**。
-- **VDOM 对开发者透明（占位法 + 单一规则源）**：写 JSX → 看 DOM 即真相——`data-wf-key`（数组项身份，元素/组件一致）、`data-wf-id`（组件实例身份）、`<!--wf-hole: xxx-->`（条件渲染 false 的占位注释）直接在 DOM 可见；非法输入（对象/数字 type）→ 诊断占位 + warn，不崩溃不静默；`?vdom_debug=1` 开启 patch trace + 结构 audit。**转化路径唯一清晰、无 magic、可推导**（规则表：design/vdom-transform-rules.md）
+- **VDOM 对开发者透明（占位法 + 单一规则源）**：写 JSX → 看 DOM 即真相——`data-wf-key`（数组项身份，元素/组件一致）、`data-wf-id`（组件实例身份）、`<!--wf-hole: xxx-->`（条件渲染 false 的占位注释）直接在 DOM 可见；非法输入（对象/数字 type）→ 诊断占位 + warn，不崩溃不静默；`?vdom_debug=1` 开启 patch trace + 结构 audit。**转化路径唯一清晰、无 magic、可推导**（规则表为内部开发契约）
 - **零构建步骤**：`weifuwu/dev` loader + `ctx.ui.js/css` 动态编译，服务端直接跑 `.tsx`，改组件刷新即生效。
 
 ### 弹层/浮层体系：最难的 UI 类别变成复用的原语

package/docs/frontend.md

@@ -233,7 +233,7 @@ const Counter: Component = async (_init, ctx) => {
 }
 ```
 
-**render-only 唯一规则**：渲染只发生在 `render()` 调用处（design/render-only-plan.md）——
+**render-only 唯一规则**：渲染只发生在 `render()` 调用处——
 状态是普通对象（`let` / `createStore`），**没有 `$` Proxy、没有赋值自动渲染**。改状态后必须显式 `ctx.ui.render()`。
 
 ### `createStore` + `ctx.ui.useExternal()` — 跨组件共享状态
@@ -448,7 +448,7 @@ ctx.ui.render(['stats'])
 
 #### `ctx.ui.useChat(options)` — AI 对话会话（AiChat 配套）
 
-会话语义的流式 AI 状态容器：消息累积 / 工具调用内嵌 / HITL 审批 / stop / retry，协议对页面完全透明（wf: 协议见 `design/ai-contract.md`）。返回 handle 带 `subscribe(cb)`——子组件用 `ctx.ui.useExternal(chat)` 订阅会话变化（render-only 共享状态原语）：
+会话语义的流式 AI 状态容器：消息累积 / 工具调用内嵌 / HITL 审批 / stop / retry，协议对页面完全透明（wf: 协议见 `docs/ai-contract.md`）。返回 handle 带 `subscribe(cb)`——子组件用 `ctx.ui.useExternal(chat)` 订阅会话变化（render-only 共享状态原语）：
 
 ```tsx
 // mount 阶段（服务端 `ai()` 中间件 + `AiChat` 组件配套）

package/docs/layout.md

@@ -4,7 +4,7 @@
 
 纯 CSS 58 个布局原语 + 136 个工具类 + 167 个主题 Token。不绑定任何 JS 框架。
 
-> **学习路径与命名规范**：见 [`design/style-guide.md`](../design/style-guide.md)——统一语法 `wf-<域>-<名>`、三档学习（组件 → 10 核心原语 → 完整速查）、场景速查、变量定制。
+> **学习路径与命名规范**：见 [`docs/style-guide.md`](style-guide.md)——统一语法 `wf-<域>-<名>`、三档学习（组件 → 10 核心原语 → 完整速查）、场景速查、变量定制。
 
 > **全栈 weifuwu 项目**：`weifuwu/components/style.css` 已包含布局系统，一条 import 就够了，无需单独引用本页。
 > 本页仅适用于**非 weifuwu 项目**或**只需 CSS 布局**的场景。

package/docs/mobile.md

@@ -1,7 +1,7 @@
 # 移动端开发指南（weifuwu）
 
 > 移动端友好由框架构造保证：**用对原语 + 守 audit 规则**，不靠每个组件"记得"。
-> 落地依据：`design/mobile-support-plan.md`（P0/P1 已完成，P2 进行中）。
+> 落地依据：移动端支持计划（P0-P3 全落地——usePopup 全系 + safe-area + 44px 命中区 + docs/mobile 指南）。
 
 ## 一、断点体系（布局原语）
 

package/docs/saas.md

@@ -147,7 +147,7 @@ import { ai } from 'weifuwu'
 const a = ai()          // DEEPSEEK_API_KEY / BASE_URL / MODEL 自动读 env，默认 deepseek-v4-flash
 app.use(a)              // 注入 ctx.ai（worker/非请求场景也可直接 a.chat()）
 
-// 流式对话：路由一行返回 SSE（wf: 协议，详见 design/ai-contract.md）
+// 流式对话：路由一行返回 SSE（wf: 协议，详见 docs/ai-contract.md）
 app.post('/api/chat', async (req, ctx) => {
   const { messages } = await req.json()
   return ctx.ai.stream({ messages }, {
@@ -217,7 +217,7 @@ return () => <AiChat chat={$} />
 
 > 分层：`ctx.ai`（后端协议）→ `aiStream`（传输解码）→ `useChat`（会话语义）→ `AiChat`（标准界面）。要完全自定义 UI 的应用用 useChat + 自有渲染；要 5 分钟出界面用 AiChat。
 
-- **协议**：`wf:` 命名空间（message_start/token/tool_call/tool_progress/usage/done/error + agent 扩展 step/approval_request），SSE 下行 + POST 上行，错误即值、未知事件透传、`x:*` 自定义事件（详见 [design/ai-contract.md](../design/ai-contract.md)）
+- **协议**：`wf:` 命名空间（message_start/token/tool_call/tool_progress/usage/done/error + agent 扩展 step/approval_request），SSE 下行 + POST 上行，错误即值、未知事件透传、`x:*` 自定义事件（详见 [docs/ai-contract.md](ai-contract.md)）
 - **agent 引擎**：`a.agent({ systemPrompt, tools, humanInTheLoop })` 工具循环（LLM → tool_call → 执行 → 回喂 → 重复）；工具可 `emit` 进度/自定义事件、接收 `signal` 取消；HITL 审批（`ctx.ai.approve` 响应，拒绝≠终止、modified 改参、超时兜底）
 - **emitter 抽象**：`agent.stream(messages, { emit })`——`wf:*` 事件（step/token/tool_result/usage/done）可接任意通道（SSE/WS/回调），协议不焊死在传输层；`agent.runToResult(messages)` 返回结构化结果 `{ content, steps, usage }`（非流式/worker 场景）
 - **embedding**：`ctx.ai.embed(text)` / `embedMany(texts)` 向量化（默认 `DASHSCOPE_API_KEY` + `text-embedding-v4`，compatible-mode 端点）；未配置抛 `AiError('unsupported')`（惰性检查，不静默降级）——知识库/语义检索开箱即用

package/docs/style-guide.md

@@ -0,0 +1,182 @@
+# weifuwu/style 使用指南（wf-* 命名规范 + 三档学习路径）
+
+> 一个 CSS 文件（`weifuwu/components/style.css`）= Token + 布局原语 + 工具类 + 组件样式。
+> 本文档是**学习路径**与**命名规范**——看完第二档即可上手 90% 页面。
+
+## 统一语法：`wf-<域>-<名字>`
+
+所有类遵循一个规则：`wf-` + **域** + 名字。
+
+| 域 | 例子 | 说明 |
+|---|---|---|
+| `layout`（布局原语） | `wf-layout-stack` `wf-layout-split` `wf-layout-grid` | 元素之间的空间关系 |
+| `p/m/gap/w/h`（间距尺寸） | `wf-p-md` `wf-mt-lg` `wf-gap-sm` `wf-w-full` | padding/margin/gap/width/height |
+| `border/rounded`（边框圆角） | `wf-border-b` `wf-rounded-md` `wf-pill` | |
+| `bg/text/weight/leading/align/tracking`（视觉） | `wf-bg-primary` `wf-text-secondary` `wf-weight-semibold` `wf-leading-base` | |
+| `btn/card/modal/…`（组件域） | `wf-btn--primary` `wf-card--hover` | 组件由 props 渲染，一般不需手写 |
+
+**修饰符号**：
+```
+wf-card--active    -- = 变体/状态（选中/激活/hover）
+wf-modal-header    -  = 子元素（组件内部结构，不手写）
+wf-layout-stack@md @  = 断点变体（≥768px 时横向）
+```
+
+**值类（裸词）**：单值工具没有属性域——`wf-uppercase` `wf-truncate` `wf-pre-wrap` `wf-dim` `wf-pill`。
+
+## 三档学习路径
+
+### 第一档：只用组件（0 成本）
+
+48 个组件覆盖页面功能块，完全不需要 wf-*：
+
+```tsx
+<PageHeader title="订单"><Button variant="primary">+ 新建</Button></PageHeader>
+<Table data={orders} columns={cols} />
+<Card hover><StatCard value="1,234" label="总用户" /></Card>
+```
+
+### 第二档：10 个核心原语（半小时，覆盖 90% 页面）
+
+```
+wf-layout-stack   垂直堆叠 + gap
+wf-layout-row     水平排列 + wrap
+wf-layout-split   两端分布
+wf-layout-fill    flex: 1 撑满
+wf-gap-md         设置间距（配合上面）
+wf-p-md           内边距
+wf-text-secondary 次级文字
+wf-bg-primary     品牌浅底
+wf-border-b       下边框
+wf-rounded-md     圆角
+```
+
+```tsx
+<div class="wf-layout-split">
+  <div class="wf-layout-row wf-gap-md">
+    <Card>…</Card>
+  </div>
+  <Button variant="primary">提交</Button>
+</div>
+```
+
+### 第三档：完整速查（按需查 IDE 补全）
+
+输入 `wf-layout-` / `wf-text-` / `wf-bg-` 弹出全部候选。完整清单见 README「布局系统」。
+
+## 场景速查（"我要做什么"）
+
+| 需求 | 写法 |
+|---|---|
+| 两个元素两端分布 | `wf-layout-split` |
+| 一列堆叠带间距 | `wf-layout-stack wf-gap-md` |
+| 一行换行居中对齐 | `wf-layout-row wf-gap-md wf-layout-cluster` |
+| 卡片网格 | `<div class="wf-layout-grid">` |
+| 状态色文字/背景 | `wf-text-success` / `wf-bg-error` |
+| 卡片 hover 抬升 | `<Card hover>` 或 `wf-elevate` |
+| 聊天气泡 | `wf-bubble` / `wf-bubble--own` |
+| 文章正文排版 | `<article class="wf-prose">` |
+| 隐藏元素（桌面显示/移动隐藏） | `wf-layout-hidden@sm` |
+| 按钮变胶囊 | `:root { --wf-btn-radius: 999px }` |
+| 数字防抖（统计/表格数值） | `wf-nums`（StatCard 已默认套用） |
+| 顶级页面大标题 | `<PageHeader display>` 或 `wf-text-display` |
+| 状态/计数徽章 | `<Badge variant>`（不可交互，含 dot） |
+| 可关闭标签 | `<Tag closable>`（可交互，有关闭钮） |
+| 图标 | `<Icon name="close" />`（禁止裸 emoji/字形） |
+
+## 定制（零 CSS 文件）
+
+### 品牌换色 — 改原始层一个值，全站跟随
+
+```html
+<style>
+  :root { --wf-brand-500: #7c3aed; }        /* 亮色品牌 */
+  :root { --wf-dark-brand-500: #a78bfa; }   /* 暗色品牌（可选） */
+</style>
+```
+
+### 组件定制 — 设一个变量
+
+```html
+<style>
+  :root {
+    --wf-modal-width: 640px;
+    --wf-btn-radius: 999px;
+    --wf-field-height: 44px;
+    --wf-card-shadow: 0 8px 24px rgba(0,0,0,.12);
+  }
+</style>
+```
+
+完整钩子清单：`--wf-btn-*` `--wf-card-*` `--wf-field-*` `--wf-modal-*` `--wf-drawer-width` `--wf-toast-*` `--wf-alert-radius` `--wf-badge-radius` `--wf-tag-radius` `--wf-switch-radius` `--wf-popover-*` `--wf-tooltip-radius` `--wf-dropdown-min-width` `--wf-datepicker-*`。
+
+### 动效定制 — 时长/缓动/位移
+
+```html
+<style>
+  :root {
+    --wf-dur-base: 300ms;                     /* 默认动画时长 */
+    --wf-ease-out: cubic-bezier(0.22, 1, 0.36, 1);  /* 入场缓动 */
+    --wf-motion-lg: 32px;                     /* 抽屉全幅位移 */
+  }
+</style>
+```
+
+### 覆盖优先级（@layer）
+
+```
+@layer tokens, base, layout, utilities, components;   ← weifuwu 的层
+未分层的用户 CSS 天然最高优先级                        ← 你写的普通规则直接生效
+用户 @layer utilities 可精准盖过 weifuwu 的 utilities
+```
+
+## 主题 Token（141 个，双层）
+
+- **原始层**（`--wf-brand-*` `--wf-slate-*` `--wf-dark-*`）：色值只定义一次，品牌/暗色调校改这里
+- **语义层**（`--wf-color-*` `--wf-space-*` `--wf-radius-*` …）：组件消费，主题切换覆盖这里
+- 暗色模式：`--wf-dark-*` 间接层映射，两段激活（`data-theme` / 系统偏好），无硬编码
+
+### 动效 Token（P8 新增，全站动效统一引用）
+
+| Token | 默认 | 用途 |
+|---|---|---|
+| `--wf-dur-fast/base/slow` | 120/200/300ms | 动画时长阶梯 |
+| `--wf-ease-out` | `cubic-bezier(0.16,1,0.3,1)` | 入场（快出缓停） |
+| `--wf-ease-in` | `cubic-bezier(0.4,0,1,1)` | 退场（渐入加速） |
+| `--wf-ease-snap` | `cubic-bezier(0.34,1.56,0.64,1)` | 选中/弹跳（Segmented 等） |
+| `--wf-motion-sm/md/lg` | 4/8/24px | 位移量（toast 退场/抽屉） |
+
+### 语义文字色（P2 新增，浅底可读）
+
+`--wf-color-{primary,success,warning,error,info}-text`（700 级，对 50 级底对比度 ≥ 4.5:1）——**文字用 `-text` 变体，500 级只做填充/边框/焦点**。实心填充上的文字用 `--wf-color-on-brand`；遮罩用 `--wf-overlay`。
+
+### CJK / 数字（P5 新增）
+
+- `--wf-heading-case: none`（默认）——表头/分组标题文本变换，英文项目可覆盖 `uppercase`
+- `--wf-nums`——`wf-nums` 工具类的取值（tabular-nums，数字防宽度抖动）
+
+## 图标（Icon 组件）
+
+组件库内置 `Icon`（stroke SVG、`currentColor`、`1em` 随字号、`aria-hidden`），组件内部图标统一用它——**禁止裸文本字形**（✕✓⚠▲▼ 等）：
+
+```tsx
+h(Icon, { name: 'close' })          // 随上下文颜色/字号
+h(Icon, { name: 'check', size: 16 })
+```
+
+内置 25 个：方向（chevron/arrow/sort）、状态（check/close/alert/info/warning）、操作（search/send/stop/retry/upload/trash/edit/plus）等。业务图标自备（`Icon` 只做基础集）。
+
+## 浮层退场语义（P0/P4 变更，注意时序）
+
+Modal/Drawer/Confirm/Toast 关闭时**先播退场动画再卸载**：
+
+- `open=false` 后 DOM 仍存在约 200ms（播 `--exit` 动画）——时序敏感代码（测量/立即重开）需知悉
+- `prefers-reduced-motion: reduce` 下动画降为 0.01ms，等效立即卸载
+- Confirm 默认 `maskClosable=false`（遮罩点击不取消，防误触）；Escape 仍可关闭
+
+## 边界（诚实说明）
+
+- 业务具体尺寸（`width: 220px`、`min-height: 120px`）用内联——设计系统不背业务值
+- 深度定制组件结构用覆盖 CSS（@layer 友好支持）
+- 低频 CSS（float/filter）不做类——用内联或组件
+- 动效已统一由 Token 驱动：新增动画禁止硬编码时长/缓动（audit 把关）

package/package.json

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

package/dist/ui-dom/vdom/diff.d.ts

@@ -1,33 +0,0 @@
-/**
- * vdom/diff — 同步 patch（阶段 2）
- *
- * **不变量：diff 只处理已构建树**——组件 vnode 必已 `_render`/`_child`（buildVNode 预构建）。
- * 遇未构建组件 → throw（开发期暴露；生产路径 renderByIds/导航都先 buildVNode await）。
- * 这是第 1 代死循环的根治：diff 永不调用组件工厂、无 resolve 回调、无补全循环。
- *
- * 三态 skip：props 同 + 无 dirty + ctx 版本同 → 复用旧 _child（renderFn 不重跑）。
- */
-import type { VNodeChild } from '../vnode.ts';
-import { normalizeChildren } from '../vnode.ts';
-export { normalizeChildren };
-export interface PatchCtx {
-    browser: any;
-    registry: import('./registry.ts').Registry;
-    /** 当前 ctx 版本号（三态 skip 版本比较：组件 _ctxVersion !== 当前版本 → 不 skip，
-     *  强制重渲染——bumpCtxVersion 递增后所有组件重跑 renderFn，如 i18n 切换语言） */
-    ctxVersion?: number;
-    /** force：跳过三态 skip（mountRoot.rerender 全量重跑用） */
-    force?: boolean;
-}
-/**
- * patchValue — 同步 diff 单一节点。
- * @returns newInput 的实际 DOM（null = 无 DOM）
- */
-export declare function patchValue(parent: Node, oldNode: Node | null, oldInput: VNodeChild, newInput: VNodeChild, ctx: PatchCtx): Node | null;
-/** 属性 patch（只设不删语义保持简单；差异删除由 diff 上层处理） */
-export declare function patchProps(el: Element, oldProps: Record<string, any>, newProps: Record<string, any>): void;
-/**
- * patchChildren — 数组 diff。
- * @returns 每个新子项的 DOM 范围（Fragment 展开对齐）
- */
-export declare function patchChildren(parent: Node, oldInput: VNodeChild | null | undefined, newInput: VNodeChild | null | undefined, ctx: PatchCtx, oldRange?: Node[], oldAnchors?: (Node | null)[], anchorOut?: (Node | null)[]): (Node | null)[];

package/dist/ui-dom/vdom/hydration.d.ts

@@ -1,17 +0,0 @@
-/**
- * vdom/hydration — 游标收养（SSR HTML → 客户端，不重建 DOM）
- *
- * 与第 1 代 hydration 的区别：**先 buildVNode 预构建**（await 工厂——组件已 resolve、
- * _child 已展开）→ 再游标收养（只接线属性/事件/ref——不重跑 renderFn/工厂）。
- *
- * 游标不变量：元素/文本 VNode 恰好消耗一个游标节点；组件/Fragment/数组透明；
- * null 消耗零；创建时 insertBefore(游标) 且游标不动；收养/替换时游标前进。
- */
-import type { VNode } from '../vnode.ts';
-import type { WfuiContext } from '../types.ts';
-import { mountAsyncComponent } from './build.ts';
-/** Hydration 入口：buildVNode 预构建（await 工厂）→ 游标收养 */
-export declare function hydrateVNode(container: Element, vnode: VNode, ctx: WfuiContext): Promise<void>;
-/** 给组件 vnode 分配 id（hydration 需要——注册表定位） */
-export declare function ensureHydrationId(vnode: VNode, ctx: WfuiContext): void;
-export { mountAsyncComponent };

package/dist/ui-dom/vdom/index.d.ts

@@ -1,23 +0,0 @@
-/**
- * vdom — 全新虚拟 DOM 引擎（第 2 代）
- *
- * 设计初衷（修复第 1 代死循环/动态挂载问题）：
- * - 组件 vnode 进入 diff 前**必须已构建**（`_render` 已设）——diff 永不调用组件工厂
- * - 构建（buildVNode）是 async 的，统一在渲染入口完成（首帧 / renderByIds / 导航）
- * - 动态挂载组件在 buildVNode 阶段被 await（构建完成）→ diff 同步渲染——
- *   无占位、无注释、无「resolve 回调触发补全」（第 1 代死循环根因）
- * - 工厂只跑一次（vnode 级缓存 + 旧树同位置同类型复用）——无无限挂载
- *
- * 两阶段异步组件（唯一签名）：
- *   async (initProps, ctx) => Promise<(props) => VNode | null>
- */
-export { buildVNode } from './build.ts';
-export { renderValue } from './render.ts';
-export { patchValue } from './diff.ts';
-export { createRenderer, type Renderer } from './mount.ts';
-export { createRegistry, type Registry } from './registry.ts';
-export { createStore, type ExternalStore } from '../store.ts';
-export { mountRoot, createVdomContext, mountCommand, unmountCommand, createCommandContainer } from './mount.ts';
-export { hydrateVNode } from './hydration.ts';
-export { renderSsr, ssrPage, ssrToString, serializeData, createSsrContext } from './ssr.ts';
-export { uiServe, type UIServeOptions, type UIServeHandle } from './serve.ts';

package/dist/ui-dom/vdom/mount.d.ts

@@ -1,58 +0,0 @@
-/**
- * vdom/mount — 挂载入口（首帧 + ctx/ui 组装）
- *
- * 渲染管线：buildVNode（async 预构建）→ renderValue（同步落地）。
- * ctx.ui：render/setMounting/endMounting——render-only（design/render-only-plan.md）。
- */
-import type { VNode, VNodeChild, Component } from '../vnode.ts';
-import type { WfuiContext } from '../types.ts';
-import type { BrowserEnv } from '../types.ts';
-import { type Registry } from './registry.ts';
-export interface MountOptions {
-    browser: BrowserEnv;
-    root: HTMLElement;
-    registry?: Registry;
-    renderer?: Renderer;
-    onError?: (e: unknown) => void;
-}
-export interface MountHandle {
-    ctx: WfuiContext;
-    registry: Registry;
-    renderer: Renderer;
-    /** 挂载根组件 */
-    mount(comp: Component | VNodeChild): Promise<void>;
-    /** 整树强制重渲染（force——测试辅助/手动刷新：renderFn 重跑 + patch） */
-    rerender(): Promise<void>;
-    /** 卸载（清理 DOM） */
-    unmount(): void;
-}
-export interface VdomContext {
-    ctx: WfuiContext;
-    registry: Registry;
-    renderer: Renderer;
-    rootUi: any;
-    destroyPopupListeners: () => void;
-}
-export interface Renderer {
-    render(ids?: string[]): Promise<void>;
-}
-export interface RendererOptions {
-    registry: Registry;
-    ctx: WfuiContext;
-    rootEl?: HTMLElement;
-    onError?: (e: unknown) => void;
-}
-export declare function createRenderer(opts: RendererOptions): Renderer;
-/** 组装 vdom 渲染上下文（ctx/registry/renderer/rootUi——含完整 hooks 转发） */
-export declare function createVdomContext(opts: MountOptions): VdomContext;
-export declare function mountRoot(opts: MountOptions): MountHandle;
-/** vdom 命令式挂载：buildVNode（await 工厂）→ renderValue → append + _parentNode */
-export declare function mountCommand(container: HTMLElement, vnode: VNode, ctx: WfuiContext, opts?: {
-    onMounted?: () => void;
-}): {
-    id: string;
-};
-/** vdom 命令式卸载：ref 清理 + 卸载钩子 + 容器移除 */
-export declare function unmountCommand(container: HTMLElement, vnode: VNode | null, ctx: WfuiContext): void;
-/** 创建命令式挂载容器（body 下独立 div） */
-export declare function createCommandContainer(): HTMLDivElement | null;

package/dist/ui-dom/vdom/render.d.ts

@@ -1,17 +0,0 @@
-/**
- * vdom/render — DOM 落地（阶段 2 同步）
- *
- * **只处理已构建的组件**（`_render` 已设——buildVNode 已 await 工厂）。
- * 遇未构建组件 → 抛错（开发期暴露 bug；生产路径 renderByIds 先 build 后 patch，
- * 不会出现未构建组件）。
- */
-import type { VNodeChild } from '../vnode.ts';
-import type { BrowserEnv } from '../types.ts';
-export { EVENT_RE, eventTarget, ENUMERATED_VALUE_BASED, holeDetail } from './transform.ts';
-export declare const SVG_TAGS: Set<string>;
-export declare function setProp(el: Element, key: string, value: any): void;
-/** 占位内容（规则表 §1——wf-hole 内容可见可审计：false/null/undefined/true/对象摘要/bad-vnode） */
-/** 创建占位节点（数组上下文的无渲染值 → 注释节点，childNodes 与数组同构——规则表 §1） */
-export declare function createHole(browser: BrowserEnv, v: unknown): Node | null;
-/** 递归渲染（同步——组件必须已构建） */
-export declare function renderValue(v: VNodeChild, ctx: any, browser?: BrowserEnv): Node | null;

package/dist/ui-dom/vdom/ssr.d.ts

@@ -1,44 +0,0 @@
-/**
- * vdom/ssr — 服务端渲染（无 DOM，纯字符串）
- *
- * SSR 与引擎无关（vnode → HTML 字符串）——vdom 独立实现：
- * - renderSsr：await 工厂 → renderFn → 递归（组件签名两阶段 async）
- * - createSsrContext：SSR ctx shim（hooks no-op、$ 普通对象、ctx.data 预取）
- * - ssrPage：router.execute → renderSsr → 完整 HTML（__DATA__ 种子）
- *
- * 渲染期非确定性（Date/Math.random/locale）导致 SSR/hydration mismatch——
- * dev 检测，文档红线（AGENTS.md §3.5 诚实裁剪）。
- */
-import type { VNodeChild, Component } from '../vnode.ts';
-import type { WfuiContext } from '../types.ts';
-import type { UIRouter } from '../router.ts';
-/** HTML 转义（文本/属性值） */
-export declare function escape(s: string): string;
-/** 渲染 vnode → HTML 字符串（服务端） */
-export declare function renderSsr(input: VNodeChild, ctx: WfuiContext): Promise<string>;
-/** 创建 SSR ctx（serverCtx 注入 + dataStore 预取 + hooks shim） */
-export declare function createSsrContext(serverCtx: any, dataStore: Map<string, unknown>): WfuiContext;
-/** 序列化数据存储 → window.__DATA__ 脚本（防 XSS：转义 <） */
-export declare function serializeData(data: Map<string, unknown>): string;
-export interface SsrPageResult {
-    html: string;
-    /** __DATA__ 脚本（hydration 种子） */
-    dataScript: string;
-    /** 完整 HTML（含 dataScript） */
-    page: string;
-}
-/**
- * SSR 渲染路由页面 → 完整 HTML（Node 无 DOM）。
- * 客户端 uiServe(router, { root, hydrate: true }) 收养。
- */
-export declare function ssrPage(router: UIRouter, opts: {
-    url: string;
-    title?: string;
-    lang?: string;
-    rootId?: string;
-    styles?: string[];
-}): Promise<SsrPageResult>;
-/** SSR 渲染组件 → HTML 片段 */
-export declare function ssrToString(Comp: Component, props: Record<string, any>, serverCtx: any, opts?: {
-    data?: Map<string, unknown>;
-}): Promise<string>;