weifuwu 0.78.0 → 0.79.0

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

@@ -8,8 +8,8 @@
  * 三态 skip：props 同 + 无 dirty + ctx 版本同 → 复用旧 _child（renderFn 不重跑）。
  */
 import type { VNodeChild } from '../vnode.ts';
-import { normalizeChildren } from '../vnode.ts';
-export { normalizeChildren };
+import { arrayChildren } from '../vnode.ts';
+export { arrayChildren };
 export interface PatchCtx {
     browser: any;
     registry: import('./registry.ts').Registry;
@@ -26,8 +26,4 @@ export interface PatchCtx {
 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/render.d.ts

@@ -7,11 +7,11 @@
  */
 import type { VNodeChild } from '../vnode.ts';
 import type { BrowserEnv } from '../types.ts';
-export { EVENT_RE, eventTarget, ENUMERATED_VALUE_BASED, holeDetail } from './transform.ts';
+export { EVENT_RE, eventTarget, ENUMERATED_VALUE_BASED, holeDetail, holeMarkup } 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;
+export declare function renderValue(v: VNodeChild, ctx: any, browser?: BrowserEnv, key?: string | null, id?: string | null, fid?: string | null): Node | null;

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

@@ -6,8 +6,23 @@
  * hydrateVNode 全部调用，禁止各路径各自实现形态判定（同一语义多套实现 = 漂移 = 转化分叉）。
  */
 import type { VNodeChild } from '../vnode.ts';
-/** 占位内容（规则表 §1——wf-hole 内容可见可审计：false/null/undefined/true/对象摘要/bad-vnode） */
+/** wf-hole 值摘要（占位内容可见可审计：false/null/undefined/true/对象摘要/bad-vnode） */
 export declare function holeDetail(v: unknown): string;
+/** 统一 wf-hole 标记（规则表 §1——全部 wf-hole 同一格式，用户直接读 DOM 注释可懂）：
+ *  - 占位  `wf-hole: type=hole value=false key=0 id=_wf_5`
+ *  - 边界  `wf-hole: type=fragment-start key="0" id="_wf_5"` / `wf-hole: type=fragment-end key="0"`
+ *  - 诊断  `wf-hole: type=hole value="object {...}"`（value 承载内容）
+ *  字段：type 必写（hole/fragment-start/fragment-end）；value/key/id 有则写。
+ *  前缀恒为 `wf-hole:`——diff/audit/hydrate 的占位判断（startsWith）不随格式演进变化 */
+export declare function holeMarkup(opts: {
+    type: string;
+    value?: unknown;
+    key?: string | null;
+    id?: string | null;
+    fid?: string;
+}): string;
+/** 解析 wf-hole 注释字段（type/key/depth/id/value——统一格式，单一解析点） */
+export declare function parseHoleMarkup(nodeValue: string): Record<string, string>;
 /** children 项分类（规则表 §1）——唯一判定，消费方只调函数不写判定 */
 export type ChildKind = 'text' | 'hole' | 'native' | 'component' | 'fragment' | 'portal' | 'array' | 'invalid';
 export declare function classifyChild(c: VNodeChild): ChildKind;

package/dist/ui-dom/vnode.d.ts

@@ -70,7 +70,11 @@ export declare function h(type: VNodeType, props: Record<string, any> | null, ..
 export declare function isNative(vnode: VNode): boolean;
 /** 递归文本/数组归一化（children 数组展开——嵌套数组扁平化，DOM 范围对齐）。
  *  栈展开（索引遍历替代 shift/unshift 头部操作——长数组 O(n) 而非 O(n²)）；逆序入栈 + pop 保持原顺序 */
-export declare function normalizeChildren(c: VNodeChild | undefined | null): VNodeChild[];
+/** children 数组视图（保真用户结构——vnode 任何阶段以用户 JSX 为标准，规则表 §1-20）。
+ *  数组原样返回（零拷贝——嵌套数组不展开：数组项 ≡ 隐式 Fragment，渲染/diff 按嵌套递归，
+ *  key 层级独立 §3-46）；非数组包装成单元素数组。替代 v1 normalizeChildren（平铺展开——
+ *  消灭层级信息 → 内层/外层下标 key 撞车 → auth 切换字段残留）。 */
+export declare function arrayChildren(c: VNodeChild | undefined | null): VNodeChild[];
 export declare function isComponent(vnode: VNode): boolean;
 export declare function isFragment(vnode: VNode): boolean;
 export declare function isPortal(vnode: VNode): boolean;

package/docs/components-map.md

@@ -111,6 +111,8 @@
 | 组件 | 说明 |
 |------|------|
 | `<AiChat>` | 完整 AI 对话界面（流式 token/工具卡/审批卡/自动滚动），配 `ctx.ui.useChat()`；移动端 `raiseOnKeyboard` |
+| `<ChatInput>` | 独立聊天输入条（AiChat 抽取）：单行/多行 + streaming 停止 + IME 安全——纯输入层（useChat 组合在消费方） |
+| `<AuthPage>` | 认证页骨架：居中卡片 + logo + 表单插槽 + 错误条 + 提交 loading（登录/注册复用） |
 | `<Markdown content>` | 零依赖安全子集 parser（无 raw HTML 注入，VNode 渲染天然转义） |
 | `<CodeBlock code lang>` | 代码块 + 语言标签 + 复制按钮 |
 | `<MessageBubble role status>` | 聊天气泡（独立复用，AiChat 抽取） |
@@ -199,7 +201,7 @@
 |------|------|---------|------|
 | **Layout**（+LayoutHeader/Sider/Content/Footer） | 新增 | antd Layout / EP Container / shadcn Sidebar | 复合子组件双模式；含 Sider → row 布局；Sider 折叠受控/非受控 + trigger |
 | **Popconfirm** | 新增 | antd / EP Popconfirm | 复用 usePopup 基座（弹层组合性）；danger 危险色；确认后自动关闭 |
-| **AutoComplete** | 新增 | antd+EP Autocomplete / shadcn Combobox | 自由输入联想；包含过滤（纯函数）；键盘 ↓↑/Enter/Escape；选中回填 |
+| **AutoComplete** | 新增 | antd+EP Autocomplete / shadcn Combobox | 自由输入联想；包含过滤（纯函数）；键盘 ↓↑/Enter/Escape；选中回填；error 错误态 |
 | **Link** | 新增 | EP Link / antd Typography.Link | 语义色/下划线/disabled/new window/icon |
 | **FloatButton** | 新增 | antd FloatButton（特有） | fixed 定位 + badge + 组展开状态机 |
 | **NavMenu** | 新增 | shadcn NavigationMenu（特有） | 顶部多级 hover 弹出 + 键盘 →/Escape |

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/package.json

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