weifuwu 0.85.0 → 0.87.0

package/dist/ui-dom/use-chat.d.ts

@@ -1,95 +0,0 @@
-/**
- * ctx.ui.useChat — AI 会话语义层（client）
- *
- * 在 aiStream（传输解码）之上加一层「一段对话」的语义：
- * 消息累积、工具调用内嵌、HITL 审批、错误恢复、stop/retry/clear。
- *
- * - 协议透明：消费 wf: 事件（docs/ai-contract.md），页面不需要知道事件名
- * - 状态即共享 store（render-only 方案——design 归档）：
- *   state 是**普通对象**（非 Proxy），变化 → notify() → 订阅者（useExternal）重渲染；
- *   handle 带 subscribe——可被 useExternal 订阅（AiChat 等共享会话的子组件）
- * - 就地累积：token 经 state.messages[idx] 就地 append（O(1)/token，
- *   不重建数组；配合 key 稳定引用 → VDOM 只 patch 文本节点）
- * - 工具内嵌：wf:tool_call/progress/result 按 toolCallId/id 聚合到
- *   消息的 toolCalls[]，ToolCallCard 直接消费（call/progress/result）
- * - 审批：approval 挂消息，approve() POST approveUrl（协议 §4.5）
- * - 生命周期：dispose() 中止流（组件卸载时调用；卸载防泄漏）
- *
- * 核心与框架无关：transport 注入（默认 aiStream），node 直接测。
- */
-import type { AiStreamCallbacks, AiStreamHandle } from './ai.ts';
-import type { ChatMessage, WfApprovalDecision, WfApprovalRequest, WfError, WfStep, WfToolCall, WfToolProgress, WfToolResult, WfUsage } from '../ai/types.ts';
-/** 工具调用显示条目：ToolCallCard 的三个 props 聚合 + 状态机 */
-export interface UiToolCall {
-    call: WfToolCall;
-    progress?: WfToolProgress;
-    result?: WfToolResult;
-    status: 'running' | 'ok' | 'error';
-}
-/** 对话消息（显示模型）：provider 形状 + UI 状态字段 */
-export interface UiMessage {
-    id: string;
-    role: 'user' | 'assistant';
-    content: string;
-    /** thinking 模式推理过程（wf:done 下发后挂上，ReasoningBlock 展示） */
-    reasoning?: string;
-    status: 'streaming' | 'done' | 'error';
-    usage?: WfUsage;
-    toolCalls?: UiToolCall[];
-    approval?: WfApprovalRequest;
-    error?: WfError;
-}
-/** useChat 会话状态（普通对象 + 订阅——不再挂组件 $） */
-export interface UseChatState {
-    messages: UiMessage[];
-    input: string;
-    streaming: boolean;
-    error: WfError | null;
-    usage: WfUsage | null;
-    /** 最近 wf:step（思考/工具指示），done/error 时清空 */
-    step: WfStep | null;
-    /** 页面自有状态与 chat 状态共处一个 store（订阅者共享） */
-    [key: string]: any;
-}
-/** useChat 操作（挂到 state 上的方法；调用不触发渲染，内部 notify 触发） */
-export interface ChatApi {
-    /** 发送当前输入：追加 user + assistant 占位 → POST url */
-    send: () => void;
-    /** 中止当前流；空占位移除，有内容则标记 done */
-    stop: () => void;
-    /** 截断到最后一条 user 消息并重新生成其回复（错误恢复） */
-    retry: () => void;
-    /** 清空会话并中止 */
-    clear: () => void;
-    /** 响应 HITL 审批（协议 §4.5）：清卡片 + POST approveUrl；modified 决策带修改后参数 */
-    approve: (decision: WfApprovalDecision, note?: string, modifiedArgs?: Record<string, unknown>) => Promise<void>;
-    /** 中止流并释放（组件卸载时调用） */
-    dispose: () => void;
-}
-/** useChat 返回句柄：状态 + 方法 + subscribe（可被 useExternal 订阅——AiChat 等共享子组件） */
-export type UseChatHandle = UseChatState & ChatApi & {
-    /** 订阅会话状态变更（任何变化 → cb）；返回退订 */
-    subscribe: (cb: () => void) => () => void;
-};
-export interface UseChatOptions {
-    /** POST 端点（返回 wf: SSE 流） */
-    url: string;
-    /** HITL 审批上行端点（协议 §4.5）；缺省时 approve() 只清卡片不请求 */
-    approveUrl?: string;
-    /** 历史会话种子（app 数据注入；hook 不持有持久化） */
-    initialMessages?: UiMessage[];
-    /** 定制请求体（agent 模式携带 tools/mode 等）；缺省 { messages } */
-    body?: (messages: UiMessage[]) => unknown;
-    headers?: Record<string, string>;
-    signal?: AbortSignal;
-    /** x:* 自定义事件透传（协议 §6） */
-    onEvent?: (name: string, data: unknown) => void;
-}
-/** 传输层（默认 aiStream）：POST + SSE 解析 + abort */
-export type ChatTransport = (url: string, body: unknown, callbacks: AiStreamCallbacks, opts?: {
-    signal?: AbortSignal;
-    headers?: Record<string, string>;
-}) => AiStreamHandle;
-/** UiMessage[] → provider ChatMessage[]（剥离 UI 字段；reasoning 回传——thinking 模式闭环） */
-export declare function toChatMessages(msgs: UiMessage[]): ChatMessage[];
-export declare function createChatSession(state: UseChatState, transport: ChatTransport, options: UseChatOptions, notify?: () => void): ChatApi;

package/dist/ui-dom/vdom3/README.d.ts

@@ -1,32 +0,0 @@
-export {};
-/**
- * vdom3 — vnode + stream 前端引擎（2026-08）
- *
- * 与 vdom2 的差异：**渲染执行 = 事件流**（vnode 树保留声明式——renderFn 输出完整树）。
- *
- *   vdom2：状态 → renderFn → vnode 树 → diff（命令式比较）→ DOM 变更 + 旁路事件记录
- *   vdom3：状态 → renderFn → vnode 树 → **渲染事件流**（CREATE/INSERT/UPDATE/REMOVE）
- *          → 执行器消费事件 → DOM（事件流是引擎本体——DOM = fold(事件流)）
- *
- * 核心不变量：
- *   1. vnode 树保留声明式（与 vdom2 同模型——两阶段组件兼容）
- *   2. 渲染即事件：节点创建/属性设置/文本更新/插入/移除都是事件（可回放/取消/断言）
- *   3. DOM = fold(事件流)：初始 DOM + 事件序列 = 任意时刻 DOM（时间旅行）
- *   4. 更新最小化：同位置同类型（含 key）复用——仅变化发事件
- *      （TEXT_UPDATE/PROP_UPDATE——无整树 diff 决策噪音；异类型 → 重建事件）
- *
- * 事件流覆盖（location → DOM）——统一命名：对象 + 动作 + 参数（entity + action + target + payload）：
- *   route:change → comp:mount → node:text:create → node:insert → prop:text:update
- *   → node:remove/move（更新时）→ comp:unmount
- *   每层同构：location（route:change）/ jsx（comp:render·build·mount·unmount、props:update）
- *   / vdom（vnode:patch 决策——strategy 参数）/ dom（node:text:prop:event:ref 的 create·insert·
- *   remove·move·update·bind·unbind·cleanup）——任何事件触发最终落到 dom 层的精准状态变化
- *
- * 模块：
- *   types.ts   — VNode（native/文本/Fragment）+ V3Event + EventStream 契约
- *   jsx.ts     — h（vnode 创建——单数组参数自动展开）
- *   render.ts  — mount/patch：树 → 事件流 → DOM（同类型复用/异类型重建/文本属性特判）
- *   events.ts  — 事件流（记录/回放/逆操作/断言——DOM = fold(events)）
- *
- * 与 vdom2 并行（不兼容演进）——vdom2 资产保留，vdom3 验证「事件流即执行」范式。
- */

package/dist/ui-dom/vdom3/app.d.ts

@@ -1,20 +0,0 @@
-/**
- * vdom3 app — 应用注册表（多应用加载——app 节点消费）
- *
- * registerApp(appId, factory)：注册子应用（factory 返回子应用根 vnode——
- * 可 await 初始化——应用实例状态由工厂闭包持有——appId 复用不重跑）。
- * 渲染时（app 节点 build）：查注册表 → 工厂调用（首次/应用实例复用）→
- * 子应用根在父流构建——app:* 边界事件（mount/update/unmount/error——带 appId）。
- *
- * 不隔离设计（design/vdom3-app-node.md）：共享流/全局 id——天然归属唯一——
- * app 的价值 = 应用编排（注册表 + 生命周期 + 边界事件）。
- */
-import type { VNode, V3Ctx } from './types.ts';
-/** 子应用工厂：(props, ctx) => 子应用根 vnode（可 await——应用初始化） */
-export type AppFactory = (props: Record<string, unknown>, ctx: V3Ctx) => Promise<VNode> | VNode;
-/** 注册子应用（模块级——appId 全局唯一） */
-export declare function registerApp(appId: string, factory: AppFactory): void;
-/** 查询（app 节点 build 消费——未注册返回 null——app:error unknown-app） */
-export declare function getAppFactory(appId: string): AppFactory | null;
-/** 测试隔离 */
-export declare function resetAppRegistry(): void;

package/dist/ui-dom/vdom3/audit.d.ts

@@ -1,29 +0,0 @@
-/**
- * vdom3 audit — 开发期不变量校验（防御——测试之外的第二道防线）
- *
- * 启用：__WF_V3_AUDIT !== '0'（默认开——与 vdom2 audit 对齐）。
- * 校验点（渲染后）：
- * 1. 孤儿节点：DOM 中 data-v3-id 节点在 registry 有记录（patch 泄漏检测）
- * 2. vnode/DOM 一致性：有 el 的 children 项在 DOM 中的顺序与 children 顺序一致
- *    （空洞错位——prevNode 锚修复的回归防线）
- * 校验失败 → console.warn('[vdom3/audit] ...')（不中断渲染——观测性）
- */
-import type { VNode } from './types.ts';
-/** 渲染后校验（patch 完成调用——root 为挂载容器） */
-export declare function auditAfterRender(root: Element): void;
-/** vnode/DOM 顺序一致性（children 有 el 的项——DOM 顺序 = children 顺序）
- *  索引比较（父下 childNodes indexOf——无 compareDocumentPosition 的跨树/同节点歧义） */
-export declare function auditOrder(_el: Element, v: VNode): void;
-/**
- * DOM ↔ 事件流对照审计（不变量"无事件流不渲染"的运行时守护——dev 模式）
- *
- * 启用：__WF_VDOM_AUDIT === '1'（独立开关——默认关——审计开销仅 dev）。
- * 机制：MutationObserver 观察挂载点（childList——added/removedNodes）——
- * 对照事件流（node:insert/remove 的 target）——无事件对应的 DOM 结构变化
- * = 绕过点（静默渲染）——warn。
- * 例外（白名单）：无 data-v3-id 的节点（内部容器/文本包装）；挂载点自身清空
- * （mount/unmount——初始/销毁语义）。
- */
-export declare function auditDomEvents(root: Element, getRecent: () => Array<{
-    target?: string;
-}>): () => void;

package/dist/ui-dom/vdom3/build.d.ts

@@ -1,20 +0,0 @@
-/**
- * vdom3 build — 异步组件构建（两阶段组件 → 纯 vnode 树）
- *
- * 与 vdom2 同模型：先 await 组件工厂 + renderFn → 构建产物（纯树）→ 同步渲染。
- * 组件实例复用：同位置同类型（patch 判定）→ 工厂不重跑（内部状态保持）。
- */
-import type { VNode, PortalVNode, V3Ctx } from './types.ts';
-import { Fragment } from './types.ts';
-export declare function runUnmountHooks(id: string): void;
-export declare function isVNode(v: unknown): v is VNode;
-/** 构建 vnode 树（组件展开——异步；native/text 同步递归）——**纯函数式**：
- *  每层返回克隆（不就地修改入参）——update 的对照树（current）不被污染。
- *  oldV：旧树同位置对照——同类型组件复用 _render（工厂不重跑——内部状态保持）。
- *  isRoot：整树 rerender（createRoot/router 顶层）——根组件不剪枝（内部状态
- *  （闭包 let）变化时 props 不变——剪枝跳过 renderFn = 读旧闭包值；根必须重跑。
- *  嵌套剪枝保留：子组件内部状态由自身 ctx.render（组件级——绕开 build）维护，
- *  父重跑时剪枝复用其最新输出——安全。 */
-export declare function buildVNode(vnode: VNode, ctx: V3Ctx, oldV?: VNode | null, isRoot?: boolean): Promise<VNode>;
-export declare function isPortal(v: unknown): v is PortalVNode;
-export { Fragment };

package/dist/ui-dom/vdom3/commands.d.ts

@@ -1,21 +0,0 @@
-/**
- * vdom3 commands — 命令式中间件（confirm/toast——vdom2 mountCommand 的 vdom3 等价）
- *
- * vdom2 的 confirm()/toast()（组件库）用 mountCommand 挂载——依赖 vdom2 引擎。
- * vdom3 适配：复用 Confirm/Toast 组件（vdom2 组件——hooks shim 可跑）——
- * createRoot 挂载到命令式容器——resolve 时 handle.unmount 清理。
- */
-/** 命令式中间件注入类型（confirm/toast 挂到 ctx——中间件面） */
-export interface V3CommandInjected {
-    confirm(message: string, options?: Record<string, unknown>): Promise<boolean>;
-    toast(message: string, variant?: 'success' | 'error' | 'warning' | 'info'): void;
-}
-/** 命令式确认（vdom3——createRoot 挂载 Confirm 组件——Modal portal 退场）
- *  泛型 ctx（兼容 UIRouter（WfuiContext）与 vdom3（V3Ctx）双入口） */
-export declare function v3Confirm<C extends {
-    [key: string]: unknown;
-}>(): (ctx: C) => C & V3CommandInjected;
-/** 命令式轻提示（vdom3——createRoot 挂载 Toast 组件——自动消失） */
-export declare function v3Toast<C extends {
-    [key: string]: unknown;
-}>(): (ctx: C) => C & V3CommandInjected;

package/dist/ui-dom/vdom3/comp-index.d.ts

@@ -1,18 +0,0 @@
-/**
- * vdom3 comp-index — 组件实例索引（组件 id → 当前树 vnode 引用）
- *
- * 优化：updateComponent（组件级更新——ctx.render 高频路径）原为 DFS 整树
- * 定位（O(树大小)）——滚动跟随 renderByIds 每帧多次——大应用热点。
- * 索引定位 O(1)——注册（build 组件分支）/ 注销（组件移除）/ miss 回退 DFS（防御）。
- *
- * id 全局唯一（nextNodeId）——索引全局——与 delegate 注册表同模式。
- */
-import type { VNode } from './types.ts';
-/** 注册（build 组件分支——mount/reuse 时——指向当前树的最新克隆） */
-export declare function indexComponent(v: VNode): void;
-/** 注销（组件实例从树中移除——条件渲染/列表删除） */
-export declare function unindexComponent(compId: string): void;
-/** O(1) 定位（updateComponent 消费——miss 由调用方回退 DFS） */
-export declare function getIndexedComponent(compId: string): VNode | null;
-/** 测试隔离（跨测试残留——id 从 n1 重新分配——旧索引 miss 回退安全——整洁清理） */
-export declare function resetCompIndex(): void;

package/dist/ui-dom/vdom3/delegate.d.ts

@@ -1,48 +0,0 @@
-/**
- * vdom3 event delegation — 事件代理（用户决策：事件注册到代理而非组件自身）
- *
- * 架构：
- *   组件渲染 → handler 写入代理注册表（按节点 id——Map 覆盖零重绑）
- *   挂载点（createRoot/createRouter 的 root + portal 容器）注册原生监听
- *   （每挂载点每事件一次——监听器 O(1)）——惰性（首次绑定某事件时注册）
- *   事件冒泡 → 挂载点监听 → e.target 向上找最近 [data-v3-id] → 查注册表 → 分发
- *
- * 收益：
- *   - 监听器 O(1)（每挂载点每事件一次——非每元素）
- *   - 零重绑（handler 变化 = Map 覆盖——事件流零噪音——§5.1 稳定引用仅为性能建议）
- *   - 生命周期：EVENT_BIND（挂载点首次注册）/ EVENT_UNBIND（节点移除时代理删除）
- */
-/** event → (nodeId → 条目{handler, once})——模块级全局（节点 id 全局唯一） */
-/** 监听计数 API（round3 阶段 4——泄漏检测：unmount 后残留检查——
- *  handlers[event][nodeId] 数 = 某节点的绑定数） */
-export declare function listenerCount(nodeId: string | null): number;
-/** 绑定/更新 handler（Map 覆盖——零重绑零事件） */
-export declare function bindEvent(nodeId: string, event: string, handler: EventListener, once?: boolean): void;
-/** 解绑（节点移除——代理删除 + EVENT_UNBIND） */
-export declare function unbindEvent(nodeId: string, event: string): void;
-/** 解绑节点的全部事件（移除统一清理——注册表与元素级标记解耦） */
-export declare function unbindAll(nodeId: string): void;
-/** 元素级监听统一入口（动画生命周期等——ref 回调的 el）：
- *  注册到代理（once 自动解绑）+ 挂载点监听（el 已挂载——向上找）——返回退订 */
-export declare function bindElementListener(el: Element, event: string, handler: EventListener, once?: boolean): () => void;
-/** 测试/调试隔离：清空注册表与挂载点（模块级 handlers 跨测试残留——
- *  节点 id 各测试从 n1 重新分配——旧 handler 可能被错误分发） */
-export declare function resetDelegation(): void;
-/** 注册挂载点（createRoot/createRouter 挂载时调用） */
-export declare function ensureDelegationRoot(root: Element): void;
-/** 移除挂载点（卸载——removeEventListener 配对 + 注册表清理；
- *  handler 由节点移除清理（unbindAll）） */
-export declare function removeDelegationRoot(root: Element): void;
-/** 全局监听（document/window 级——hooks 统一入口）：
- *  同事件多 handler 聚合到一个目标监听（EventTarget 每事件一次）——
- *  统一注册/退订 + 事件流可观测（EVENT_BIND/UNBIND——delegated: true）。
- *  options.capture：scroll 等不冒泡事件的捕获监听（嵌套容器滚动跟踪）。
- *  mql/visualViewport 等浏览器 API 对象（无事件冒泡语义）不纳入——保持直接监听。 */
-export interface GlobalListenerOptions {
-    capture?: boolean;
-    passive?: boolean;
-}
-export declare function addGlobalListener(target: EventTarget, event: string, handler: EventListener, opts?: GlobalListenerOptions): () => void;
-/** 渲染时绑定（createNode/patchProps 调用——事件 props 处理）：
- *  注册 handler + 确保挂载点监听（向上找——首次） */
-export declare function bindDelegated(nodeId: string, event: string, handler: EventListener, parent: Node | null): void;

package/dist/ui-dom/vdom3/events.d.ts

@@ -1,17 +0,0 @@
-/**
- * vdom3 events — 事件流（引擎本体——渲染全程可记录/回放/取消）
- *
- * 不变量：DOM = fold(事件流)——初始 DOM + 事件序列 = 任意时刻 DOM。
- * 事件不可变；DOM 指令可逆（取消 = 应用逆事件）。
- */
-import type { EventStream, V3Event, Entity, Action } from './types.ts';
-/** 事件构造（统一命名：对象 + 动作 + 参数——每层同构） */
-export declare function ev(entity: Entity, action: Action, target?: string, payload?: Record<string, unknown>): V3Event;
-/** 事件键（断言/审计：'comp:render'——对象:动作） */
-export declare function evKey(ev: V3Event): string;
-export declare function createEventStream(max?: number, opts?: {
-    watermark?: number;
-}): EventStream;
-/** 全局流（默认实例——后续 per-app 实例化） */
-export declare const stream: EventStream;
-export declare function nextNodeId(): string;

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

@@ -1,42 +0,0 @@
-/**
- * vdom3 — vnode + stream 前端引擎（全新架构，2026-08）
- *
- * 与 vdom2 的差异：**渲染执行 = 事件流**（不是命令式 diff + 旁路记录）。
- *
- *   vdom2：状态 → renderFn → vnode 树 → diff（命令式比较）→ DOM 变更 + 旁路事件记录
- *   vdom3：状态 → renderFn → vnode 树 → **渲染事件流**（CREATE/INSERT/UPDATE/REMOVE）
- *          → 执行器消费事件 → DOM（事件流是引擎本体——DOM = fold(事件流)）
- *
- * 核心不变量：
- *   1. **vnode 树保留声明式**（renderFn 输出完整树——与 vdom2 同模型）
- *   2. **渲染即事件**：节点创建/属性设置/文本更新/插入/移除都是事件（可回放/取消/断言）
- *   3. **DOM = fold(事件流)**：初始 DOM + 事件序列 = 任意时刻 DOM（时间旅行）
- *   4. **更新最小化**：同位置同类型（含 key）复用——仅变化发事件（无整树 diff 决策噪音）
- *
- * 事件流覆盖（location → DOM）：
- *   ROUTE_CHANGE → COMP_MOUNT → NODE_CREATE/TEXT_CREATE → INSERT → PROP_UPDATE/TEXT_UPDATE
- *   → REMOVE/MOVE（更新时）→ COMP_UNMOUNT
- *
- * 与 vdom2 并行（不兼容演进）——vdom2 资产（两阶段组件/状态机/观测体系）保留，
- * vdom3 验证"事件流即执行"范式。
- */
-export { h, Fragment } from './jsx.ts';
-export { mount, patch } from './render.ts';
-export { buildVNode, isVNode } from './build.ts';
-export { createRoot } from './root.ts';
-export { scheduler, Scheduler } from './scheduler.ts';
-export { replay, applyEvent, undo, eventsOf, hasEvent, expectEventSequence } from './replay.ts';
-export { NodeRegistry } from './registry.ts';
-export { createRouter, type RouteDef } from './router.ts';
-export { renderToEvents, renderToEventStream, serializeEvents, deserializeEvents, eventsToHtml } from './ssr.ts';
-export { recordToTest, summarizeEvents } from './record.ts';
-export { createPortal } from './jsx.ts';
-export { Portal, App } from './types.ts';
-export { ensurePortalContainer } from './registry.ts';
-export { createV3Ui } from './ui.ts';
-export { createSync, autoSync } from './sync.ts';
-export { v3Confirm, v3Toast, type V3CommandInjected } from './commands.ts';
-export { createEventStream, stream, nextNodeId, ev, evKey } from './events.ts';
-export { registerApp, getAppFactory, resetAppRegistry } from './app.ts';
-export { addGlobalListener, bindElementListener, bindDelegated, unbindEvent, unbindAll, ensureDelegationRoot, removeDelegationRoot, resetDelegation, } from './delegate.ts';
-export type { VNode, VNodeChild, V3Event, EventStream, Renderer } from './types.ts';

package/dist/ui-dom/vdom3/jsx.d.ts

@@ -1,32 +0,0 @@
-/**
- * vdom3 jsx — vnode 创建（声明式——vdom2 同模型：renderFn 输出完整树）
- *
- * 统一 JSX 入口：h/jsx/jsxs/jsxDEV + createPortal + Fragment/Portal——
- * vdom2 时代 vnode.ts 的工厂全部收敛到此处（组件库 249 处 import 经转发层零改动）。
- */
-import type { VNode, VNodeChild } from './types.ts';
-import { Fragment, Portal, App } from './types.ts';
-import type { Component } from './types.ts';
-type HType = string | symbol | Component<any, any>;
-export declare function h(type: HType, props?: Record<string, unknown> | null, ...children: VNodeChild[]): VNode;
-/** JSX 编译产物入口（jsxImportSource: weifuwu/ui-dom——jsx-runtime 转发） */
-export declare function jsx(type: HType, props: Record<string, unknown> | null, key?: string | null): VNode;
-/** jsxs = jsx（children 数组已在 props.children——h 语义同构） */
-export declare const jsxs: typeof jsx;
-export declare function jsxDEV(type: HType, props: Record<string, unknown> | null, key?: string | null): VNode;
-/** Portal：children 渲染到远程容器（#__wf_portal > [data-wf-portal-key=key]） */
-export declare function createPortal(children: VNodeChild, portalKey?: string): VNode;
-export { Fragment, Portal };
-/** JSX 类型声明（jsxImportSource: weifuwu/ui-dom——组件/用户 JSX 编译产物类型） */
-declare global {
-    namespace JSX {
-        type Element = import('./types.ts').VNode | null;
-        type ElementType = string | ((props: any, ctx: any) => any) | typeof Fragment | typeof Portal | typeof App;
-        interface IntrinsicElements {
-            [tag: string]: any;
-        }
-        interface IntrinsicAttributes {
-            key?: string | number | null;
-        }
-    }
-}

package/dist/ui-dom/vdom3/record.d.ts

@@ -1,16 +0,0 @@
-/**
- * vdom3 record — 录制转测试（事故 → 自动生成可运行测试）
- *
- * 闭环：渲染/交互 → 事件流（录制）→ recordToTest 生成 jsdom 测试骨架
- * → 回放 + 事件序列断言（DOM = fold 验证 + 精确渲染描述）。
- *
- * 事故转测试：任意渲染异常 → 录制事件流 → 生成回归测试（无需手动复现）。
- *
- * 事件统一命名：对象 + 动作 + 参数（entity + action + target + payload）——
- * 键格式 `entity:action`（如 'node:create' / 'comp:render'）。
- */
-import type { V3Event } from './types.ts';
-/** 事件流 → jsdom 测试代码（可写盘/执行） */
-export declare function recordToTest(events: V3Event[], name?: string): string;
-/** 事件流摘要（录制信息——时间/类型计数） */
-export declare function summarizeEvents(events: V3Event[]): string;

package/dist/ui-dom/vdom3/registry.d.ts

@@ -1,30 +0,0 @@
-/**
- * vdom3 registry — 节点注册表（id ↔ DOM 节点双向映射）
- *
- * 事件流指令用 id 定位（NODE_CREATE id / INSERT parent/child）——回放/取消需要
- * 从 id 解析节点。native 元素用 data-v3-id 属性；文本/注释节点无属性——用 WeakMap。
- * REMOVE 时保存被移除节点（undo 恢复——取消的节点快照）。
- */
-/** portal 容器（#__wf_portal > [data-wf-portal-key]——lazy 创建——组件库浮层基础） */
-export declare function ensurePortalContainer(key: string): HTMLElement;
-export declare class NodeRegistry {
-    private byId;
-    private idByNode;
-    /** 被移除节点（id → node——undo 恢复用） */
-    private removed;
-    /** portal 容器 id 约定（事件流 parent 用——replay 可解析） */
-    static PORTAL: (key: string) => string;
-    /** 解析父 id（portal: 前缀 → lazy 容器；否则查注册表） */
-    resolveParent(id: string): Node | null;
-    /** id → 节点（回放/取消）——含 portal 容器 */
-    get(id: string): Node | null;
-    register(id: string, node: Node): void;
-    /** 节点 → id（native 元素读 data-v3-id；其他查 WeakMap） */
-    idOf(node: Node | null): string;
-    /** 移除记录（REMOVE 时调用——保存节点供 undo） */
-    unregister(id: string, node: Node): void;
-    /** 恢复被移除节点（undo 的 REMOVE 逆操作） */
-    takeRemoved(id: string): Node | null;
-    /** 根节点 id（replay 目标容器映射） */
-    static ROOT: string;
-}

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

@@ -1,39 +0,0 @@
-/**
- * vdom3 render — 渲染执行器：**构建后的纯树** → 事件流 → DOM
- *
- * 核心：**渲染即事件**——节点创建/属性设置/文本更新/插入/移除都是事件（stream.emit），
- * 执行器消费事件操作 DOM。DOM = fold(事件流)。
- *
- * 组件 vnode（已 build）：输出 _child（渲染组件输出——无重复构建）；
- * 卸载：COMP_UNMOUNT 事件（类型/位置变化时——由 patch 顶层判定）。
- */
-import type { VNode, PortalVNode } from './types.ts';
-import { Fragment } from './types.ts';
-/** Portal 判定（symbol 恒等 + props.portalKey——兼容 vdom2 组件产出的 Portal vnode） */
-export declare function isPortalNode(v: unknown): v is PortalVNode;
-/** Fragment 判定（symbol 且非 Portal——vdom2/vdom3 Fragment 都认） */
-export declare function isFragmentNode(v: unknown): boolean;
-import { NodeRegistry } from './registry.ts';
-/** 节点注册表（id ↔ Node——事件流指令定位）——模块级可变（mount/patch 支持
- *  per-call 注入（测试隔离）——同步段切换安全（并发交错在 await 点） */
-declare let registry: NodeRegistry;
-export { registry };
-/** 挂载：纯树 → 事件流 → DOM（reg 可选——per-call 隔离；默认全局）
- *  挂载前清空容器（首次挂载语义——清除 HTML 预置的 boot-loading 等占位——
- *  不残留「加载中...」） */
-export declare function mount(vnode: VNode, root: HTMLElement, reg?: NodeRegistry): void;
-/**
- * patch：旧树（纯）vs 新树（纯）→ 事件流 → DOM。
- * 同位置同类型（含 key）复用——仅变化发事件；异类型 → REMOVE+CREATE+INSERT（重建事件）。
- */
-export declare function patch(oldV: VNode | null, newV: VNode | string | number | null | undefined | boolean, parent: Node, anchor?: Node | null, reg?: NodeRegistry): Node | null;
-/** 递归调 ref(null)（移除树——ref 纪律：卸载清理（lockScroll/focus）依赖
- *  ——portal/组件输出等嵌套结构的 ref 全部清理——REF_CLEANUP 事件（生命周期可观测））
- *  导出（组件级 update 用） */
-export declare function callRefCleanup(v: VNode | null | undefined): void;
-/** 节点移除的完整清理（REMOVE 事件 + EVENT_UNBIND（绑定生命周期）+ ref(null) + registry） */
-export declare function removeNodeWithLifecycle(node: Node, parent: Node, vnodeRef?: VNode | null): void;
-/** 移除 portal 内容（远程容器清空——子树 REMOVE 事件 + ref(null)——ref 纪律：
- *  卸载必须调 ref(null)（usePopup 的 portalPanelRef 清理——lockScroll/focus 恢复）） */
-export declare function removePortalContent(pv: PortalVNode): void;
-export { Fragment };

package/dist/ui-dom/vdom3/replay.d.ts

@@ -1,28 +0,0 @@
-/**
- * vdom3 replay — 事件流回放 / 取消 / 断言（DOM = fold(事件流)）
- *
- * 回放（replay）：从目标容器重放事件流——node:create 建节点（id→节点映射）、
- * node:insert 挂载、prop:text update 应用——结果 = 原渲染的 DOM（fold 不变量）。
- *
- * 取消（undo）：从事件流末尾取 N 个事件 → 应用逆操作——insert→remove、
- * remove→恢复（registry 保存的节点）、update→恢复 prev。
- *
- * 断言（eventsOf/hasEvent）：渲染 = 事件序列断言（测试/调试）。
- *
- * 事件统一命名：对象 + 动作 + 参数（entity + action + target + payload）——
- * 键格式 `entity:action`（如 'node:create'）。
- */
-import type { V3Event } from './types.ts';
-import { NodeRegistry } from './registry.ts';
-/** 应用单个事件（流式客户端逐事件消费——replay 循环的拆解） */
-export declare function applyEvent(ev: V3Event, target: HTMLElement, reg: NodeRegistry): void;
-/** 回放事件流到目标容器（DOM = fold(events)——结果与原始渲染同构） */
-export declare function replay(events: V3Event[], target: HTMLElement, reg?: NodeRegistry): void;
-/** 取消：从事件流末尾取 n 个 DOM 指令 → 应用逆操作（撤销渲染变化） */
-export declare function undo(events: V3Event[], n: number, reg?: NodeRegistry): void;
-/** 断言工具：过滤事件（按 entity:action 键——如 'node:create'） */
-export declare function eventsOf(events: V3Event[], type: string): V3Event[];
-/** 断言工具：是否存在匹配事件 */
-export declare function hasEvent(events: V3Event[], predicate: (e: V3Event) => boolean): boolean;
-/** 断言：渲染 = 事件序列（测试——精确描述渲染做了什么；键格式 entity:action） */
-export declare function expectEventSequence(events: V3Event[], expected: string[]): void;

package/dist/ui-dom/vdom3/root.d.ts

@@ -1,24 +0,0 @@
-/**
- * vdom3 root — 应用入口：createRoot（挂载 + 组件渲染上下文）
- *
- * 组件 ctx.render()：调度自身重渲染（同 tick 合并——一次 patch）。
- * 渲染流程：renderFn 重跑 → buildVNode（oldV 对照复用）→ patch（事件流 → DOM）。
- */
-import type { VNode, V3Ctx } from './types.ts';
-export interface RootHandle {
-    ctx: V3Ctx;
-    /** 组件重渲染（ctx.render 内部路径——同 tick 合并） */
-    rerender(): void;
-    /** 立即刷新（测试） */
-    flush(): void;
-    unmount(): void;
-    /** 首帧完成 Promise（初始挂载——工厂 await + 渲染落地） */
-    ready: Promise<void>;
-}
-/** 树中按组件 _id 定位（组件级更新的定位——DFS——含组件输出 _child） */
-export declare function findComponent(v: VNode | null | undefined, compId: string): VNode | null;
-/** 创建应用根（挂载组件树——组件获得 ctx.render 调度能力；options.ctx 注入扩展字段
- *  ——中间件面（app/i18n/auth/data 等——组件 ctx 可选链消费）） */
-export declare function createRoot(vnode: VNode, root: HTMLElement, options?: {
-    ctx?: Record<string, unknown>;
-}): RootHandle;

package/dist/ui-dom/vdom3/router.d.ts

@@ -1,31 +0,0 @@
-/**
- * vdom3 router — 路由（location → ROUTE_CHANGE 事件 → 组件挂载 → DOM 全链路）
- *
- * 事件流覆盖：ROUTE_CHANGE(path, params) → COMP_MOUNT → NODE_CREATE/INSERT → ...
- * 页面切换 = 异类型 patch（旧页面 COMP_UNMOUNT + REMOVE；新页面 MOUNT + CREATE/INSERT）——
- * 全链路事件化（location→DOM 的完整因果链可回放）。
- */
-import type { VNode } from './types.ts';
-/** 布局包裹（跨路由复用——layout 函数引用稳定 → patch 同位置同类型复用——
- *  工厂不重跑——内部状态（折叠/高亮）保持——vdom2 布局层语义） */
-export type RouteLayout = (page: VNode) => VNode;
-export interface RouteDef {
-    path: string;
-    /** 页面渲染（params 注入——:id 等） */
-    render: (params: Record<string, string>) => VNode;
-    /** 布局包裹（可选——页面在布局插槽内） */
-    layout?: RouteLayout;
-}
-export interface RouterHandle {
-    navigate(path: string): void;
-    /** 当前路径 */
-    path(): string;
-    /** 立即处理当前 URL（测试/恢复） */
-    refresh(): void;
-    close(): void;
-}
-/** 创建路由应用（初始挂载 + popstate 导航；options.ctx 注入中间件面——页面组件消费） */
-export declare function createRouter(routes: RouteDef[], root: HTMLElement, options?: {
-    initialPath?: string;
-    ctx?: Record<string, unknown>;
-}): RouterHandle;

package/dist/ui-dom/vdom3/scheduler.d.ts

@@ -1,23 +0,0 @@
-/**
- * vdom3 scheduler — 渲染调度（同 tick 合并 + 批处理 + 防死循环）
- *
- * 语义：
- *  - schedule(fn)：收集渲染请求——同 tick 多次 schedule 合并为一次 flush（微任务）
- *  - flush：批量执行（一次事件循环内所有待渲染请求）
- *  - 渲染中再次 schedule（组件 renderFn 内触发）→ 排队到下一轮（合并补跑）
- *  - 防死循环：单次 flush 内重渲染次数上限（吸取 vdom2 pending 死循环教训）
- */
-export declare class Scheduler {
-    private queue;
-    private running;
-    private iterations;
-    /** 调度渲染（同 tick 合并——微任务批量执行） */
-    schedule(fn: () => void): void;
-    /** 立即执行队列（测试/显式刷新用） */
-    flush(): void;
-    /** 待处理数量（测试断言——合并语义） */
-    pending(): number;
-    get isRunning(): boolean;
-}
-/** 全局调度器（默认实例——后续 per-app 实例化） */
-export declare const scheduler: Scheduler;

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

@@ -1,27 +0,0 @@
-/**
- * vdom3 ssr — 服务端事件流生成（dry-run——不创建 DOM）
- *
- * 差异化能力（可移植执行记录）：服务端执行组件（buildVNode）→ 生成渲染事件流
- * （NODE_CREATE/PROP_UPDATE/INSERT/TEXT_CREATE——自包含指令）→ 序列化传输 →
- * 客户端 replay(events, root) 重建 DOM——**零 DOM 猜测**（事件流自带全部指令）。
- *
- * 与 vdom2 SSR（HTML 字符串 + hydrate 游标收养）的本质区别：
- *  - vdom2：服务端序列化 HTML → 客户端解析 + 游标匹配（DOM 结构猜测）
- *  - vdom3：服务端生成事件流 → 客户端重放（精确增量——无猜测）
- */
-import type { VNode, V3Event } from './types.ts';
-import { stream } from './events.ts';
-/** 服务端渲染 → 事件流（dry-run：只生成指令，不创建 DOM——可传输/回放） */
-export declare function renderToEvents(vnode: VNode): Promise<V3Event[]>;
-/**
- * 流式渲染：服务端逐事件推送（AsyncGenerator）→ 客户端逐事件应用
- * ——TTFB 后首帧渐进（根节点先到 → 内容逐块）——vdom2 无法做到（HTML 需完整）
- */
-export declare function renderToEventStream(vnode: VNode): AsyncGenerator<V3Event>;
-/** 事件流 → HTML 字符串（首帧序列化——SEO/爬虫/首帧；客户端用事件流重建——零 DOM 猜测） */
-export declare function eventsToHtml(events: V3Event[]): string;
-/** 序列化（传输——事件流 JSON 化） */
-export declare function serializeEvents(events: V3Event[]): string;
-/** 反序列化 */
-export declare function deserializeEvents(json: string): V3Event[];
-export { stream };