weifuwu 0.83.0 → 0.85.0

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

@@ -31,10 +31,12 @@ 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 } from './types.ts';
+export { Portal, App } from './types.ts';
 export { ensurePortalContainer } from './registry.ts';
 export { createV3Ui } from './ui.ts';
 export { createSync, autoSync } from './sync.ts';
-export { compat, toV2 } from './compat.ts';
-export { createEventStream, stream, nextNodeId } from './events.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,10 +1,32 @@
 /**
- * vdom3 jsx — vnode 创建（声明式——与 vdom2 同模型：renderFn 输出完整树）
+ * 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 } from './types.ts';
-export declare function h(type: string | symbol | ((initProps: any, ctx: any) => any), props?: Record<string, unknown> | null, ...children: VNodeChild[]): VNode;
-/** Portal：children 渲染到远程容器（#__wf_portal > [data-wf-portal-key=key]） */
+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

@@ -5,6 +5,9 @@
  * → 回放 + 事件序列断言（DOM = fold 验证 + 精确渲染描述）。
  *
  * 事故转测试：任意渲染异常 → 录制事件流 → 生成回归测试（无需手动复现）。
+ *
+ * 事件统一命名：对象 + 动作 + 参数（entity + action + target + payload）——
+ * 键格式 `entity:action`（如 'node:create' / 'comp:render'）。
  */
 import type { V3Event } from './types.ts';
 /** 事件流 → jsdom 测试代码（可写盘/执行） */

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

@@ -7,20 +7,33 @@
  * 组件 vnode（已 build）：输出 _child（渲染组件输出——无重复构建）；
  * 卸载：COMP_UNMOUNT 事件（类型/位置变化时——由 patch 顶层判定）。
  */
-import type { VNode, VNodeChild, PortalVNode } from './types.ts';
+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——事件流指令定位） */
-export declare const registry: NodeRegistry;
-/** 挂载：纯树 → 事件流 → DOM */
-export declare function mount(vnode: VNode, root: HTMLElement): void;
+/** 节点注册表（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: VNodeChild, parent: Node, anchor?: Node | null): Node | null;
+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,13 +1,16 @@
 /**
  * vdom3 replay — 事件流回放 / 取消 / 断言（DOM = fold(事件流)）
  *
- * 回放（replay）：从目标容器重放事件流——NODE_CREATE 建节点（id→节点映射）、
- * INSERT 挂载、PROP/TEXT_UPDATE 应用——结果 = 原渲染的 DOM（fold 不变量）。
+ * 回放（replay）：从目标容器重放事件流——node:create 建节点（id→节点映射）、
+ * node:insert 挂载、prop:text update 应用——结果 = 原渲染的 DOM（fold 不变量）。
  *
- * 取消（undo）：从事件流末尾取 N 个事件 → 应用逆操作——INSERT→REMOVE、
- * REMOVE→恢复（registry 保存的节点）、PROP/TEXT_UPDATE→恢复 prev。
+ * 取消（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';
@@ -17,9 +20,9 @@ export declare function applyEvent(ev: V3Event, target: HTMLElement, reg: NodeRe
 export declare function replay(events: V3Event[], target: HTMLElement, reg?: NodeRegistry): void;
 /** 取消：从事件流末尾取 n 个 DOM 指令 → 应用逆操作（撤销渲染变化） */
 export declare function undo(events: V3Event[], n: number, reg?: NodeRegistry): void;
-/** 断言工具：过滤事件（按类型/谓词） */
-export declare function eventsOf(events: V3Event[], type: V3Event['type']): V3Event[];
+/** 断言工具：过滤事件（按 entity:action 键——如 'node:create'） */
+export declare function eventsOf(events: V3Event[], type: string): V3Event[];
 /** 断言工具：是否存在匹配事件 */
 export declare function hasEvent(events: V3Event[], predicate: (e: V3Event) => boolean): boolean;
-/** 断言：渲染 = 事件序列（测试——精确描述渲染做了什么） */
-export declare function expectEventSequence(events: V3Event[], expected: V3Event['type'][]): void;
+/** 断言：渲染 = 事件序列（测试——精确描述渲染做了什么；键格式 entity:action） */
+export declare function expectEventSequence(events: V3Event[], expected: string[]): void;

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

@@ -4,13 +4,7 @@
  * 组件 ctx.render()：调度自身重渲染（同 tick 合并——一次 patch）。
  * 渲染流程：renderFn 重跑 → buildVNode（oldV 对照复用）→ patch（事件流 → DOM）。
  */
-import type { VNode } from './types.ts';
-export interface V3Ctx {
-    render: () => void;
-    /** 组件自身输出（渲染定位） */
-    _vnode: VNode;
-    _parent: Node | null;
-}
+import type { VNode, V3Ctx } from './types.ts';
 export interface RootHandle {
     ctx: V3Ctx;
     /** 组件重渲染（ctx.render 内部路径——同 tick 合并） */
@@ -21,6 +15,8 @@ export interface RootHandle {
     /** 首帧完成 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?: {

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

@@ -9,26 +9,71 @@
  * 事件流是引擎本体：从 location 到 DOM 的每一步都是事件——可记录/回放/取消/断言。
  * 不变量：DOM = fold(事件流)——给定初始 DOM + 事件流 = 任意时刻 DOM。
  */
-/** 两阶段组件契约（与 vdom2 同模型：mount 工厂一次 + renderFn 每次渲染）
- *  返回 Promise<any>（兼容 vdom2 组件——renderFn 产出 JSX.Element（名义类型
- *  不同于 VNode——结构兼容）——vdom2 资产零改动迁移的前提） */
-export type Component<P = Record<string, unknown>, C = Record<string, unknown>> = (initProps: P, ctx: C) => Promise<(props: P) => Promise<any>>;
+/** WfuiContext（组件 ctx 类型源——192 处组件消费）——V3Ctx extends 统一 */
+import type { WfuiContext } from '../types.ts';
+/** vdom3 组件 ctx（正式契约——组件可见最小面 + 中间件扩展（index 签名））
+ *  render：调度自身重渲染（同 tick 合并）——render-only 唯一触发
+ *  onUnmount：卸载清理注册（COMP_UNMOUNT 时执行）
+ *  ui：vdom2 兼容面（hooks shim——组件库零改动运行）
+ *  扩展字段（ctx.app/i18n/data/auth...）经 index 签名消费（可选链——中间件注入） */
+/** vdom3 组件 ctx（正式契约——与 WfuiContext 类型唯一化：
+ *  V3Ctx extends WfuiContext——vdom2 时代内联标注 ctx: WfuiContext 的组件
+ *  类型兼容（逆变：接受 WfuiContext 的函数可接收 V3Ctx）；组件库 192 处
+ *  WfuiContext 消费零改动——严格类型，无 any 绕开） */
+export interface V3Ctx extends WfuiContext {
+    /** 调度自身重渲染（同 tick 合并）——render-only 唯一触发 */
+    render(): void;
+    /** 卸载清理注册（COMP_UNMOUNT 时执行） */
+    onUnmount(fn: () => void): void;
+    /** vdom2 兼容面（hooks shim——组件库零改动运行——V3Ui 满足放宽后的
+     *  WfuiContext['ui']（render: void ⊂ void | Promise<void>）） */
+    ui: V3Ui;
+}
+/** ctx.ui 兼容面（vdom2 hooks 契约——组件库零改动运行）
+ *  方法签名继承 vdom2 ui（hooks 类型源——vdom2 删除后 hooks 保留为共享层）；
+ *  render/onUnmount 覆盖为 vdom3 语义（同步 render）。 */
+export interface V3Ui extends Omit<WfuiContext['ui'], 'render' | 'onUnmount'> {
+    render(ids?: string[]): void;
+    onUnmount(fn: () => void): (() => void) | undefined;
+    /** 实例标记（debug：ctx.ui 来源审计——双实例定位） */
+    __v3ui?: boolean;
+    /** 实例绑定的组件 id（debug：compId 错位定位） */
+    __compId?: string;
+}
+/** 两阶段组件契约（正式签名——无 any）
+ *  P：props（JSX 自动推断）；C：ctx 注入依赖——**自动 & WfuiContext**（vdom2 语义：
+ *  组件声明 C 只写注入面（ToastInjected 等）——ctx.ui/browser 等基础面自动可用）
+ *  ——严格交叉（无 any）——默认 C = V3Ctx（V3Ctx extends WfuiContext——交叉 = V3Ctx） */
+export type Component<P = Record<string, unknown>, C = V3Ctx> = (initProps: P, ctx: C & WfuiContext) => Promise<(props: P) => Promise<VNode | null>>;
 export interface VNode {
-    /** native 标签名 / 组件函数 / Fragment 符号 */
+    /** native 标签名 / 组件函数 / Fragment/Portal 符号 */
     type: string | symbol | Component;
     props: Record<string, unknown>;
     key?: string | null;
     /** 渲染后回填：DOM 元素（native）/ 组件实例输出（comp） */
     el?: Node | null;
     children?: VNodeChild[];
-    /** 组件实例状态（comp：工厂返回的 renderFn + 实例 id） */
-    _render?: (props: any) => Promise<VNode | null>;
+    /** 组件实例状态（comp：工厂返回的 renderFn + 实例 id）——内部字段
+     *  （props 参数放宽为 Record——组件 renderFn 的 P 泛型在 buildVNode 赋值处断言一次） */
+    _render?: (props: Record<string, unknown>) => Promise<VNode | null>;
     _id?: string;
     /** 组件输出（build 写——独立于 children（props.children 是入参）；避免覆盖污染对照树） */
     _child?: VNode | null;
+    /** 多节点输出范围（阶段 2——渲染后回填：首/尾 DOM 节点——组件/Fragment 输出
+     *  多节点时移除/推进用范围（vdom2 getOutputRange 语义——事件流引用替代 DOM 标记） */
+    _outFirst?: Node | null;
+    _outLast?: Node | null;
+    /** props 内容快照（透明度 round2 阶段 1——dev only——检测原地改对象） */
+    _propsSnap?: string | null;
 }
-export type VNodeChild = VNode | string | number | null | undefined | boolean;
-export declare function childrenOf(v: VNode): VNodeChild[];
+export type VNodeChild = VNode | string | number | null | undefined | boolean | VNodeChild[];
+/** vnode kind 分类（全链路事件流的决策基础——单一规则源）
+ *  renderVNode / patchInner / patchChildren / 事件流 全部消费——新增类型只改此处 */
+export type VKind = 'native' | 'comp' | 'frag' | 'portal' | 'text' | 'null' | 'app';
+export declare function classifyKind(v: VNodeChild | undefined | null): VKind;
+/** 拍平后元素（flatten 展开嵌套数组——类型层面排除数组——逻辑保证） */
+export type FlatChild = VNode | string | number | null | undefined | boolean;
+export declare function childrenOf(v: VNode): FlatChild[];
 export declare const Fragment: unique symbol;
 /** Portal（浮层渲染到远程容器——#__wf_portal 下按 key 的容器——脱离父节点位置） */
 export declare const Portal: unique symbol;
@@ -36,73 +81,86 @@ export type PortalVNode = VNode & {
     type: typeof Portal;
     portalKey?: string | null;
 };
-export type V3Event = 
-/** 路由 */
-{
-    type: 'ROUTE_CHANGE';
-    path: string;
-    params: Record<string, string>;
-    ts: number;
-}
-/** 组件 */
- | {
-    type: 'COMP_MOUNT';
-    id: string;
-    name: string;
-    ts: number;
-} | {
-    type: 'COMP_UNMOUNT';
-    id: string;
-    name: string;
-    ts: number;
-}
-/** 渲染指令（DOM 变更——执行器消费；可逆） */
- | {
-    type: 'NODE_CREATE';
-    id: string;
-    tag: string;
-    ts: number;
-} | {
-    type: 'TEXT_CREATE';
-    id: string;
-    value: string;
-    ts: number;
-} | {
-    type: 'INSERT';
-    parent: string;
-    child: string;
-    ref?: string | null;
-    ts: number;
-} | {
-    type: 'REMOVE';
-    parent: string;
-    child: string;
-    ts: number;
-} | {
-    type: 'PROP_UPDATE';
-    target: string;
-    key: string;
-    value: unknown;
-    prev: unknown;
-    ts: number;
-} | {
-    type: 'TEXT_UPDATE';
-    target: string;
-    value: string;
-    prev: string;
-    ts: number;
-} | {
-    type: 'MOVE';
-    node: string;
-    parent: string;
-    ref: string | null;
-    prev?: string | null;
+/** App（多应用加载——type: App 的节点 = 子应用挂载点——应用编排） */
+export declare const App: unique symbol;
+export type AppVNode = VNode & {
+    type: typeof App;
+    appId?: string;
+    _appOutput?: VNode | null;
+};
+export type Entity = 'route' | 'comp' | 'props' | 'vnode' | 'node' | 'text' | 'prop' | 'event' | 'ref' | 'error' | 'internal' | 'stream' | 'effect' | 'app' | 'diff' | 'render' | 'portal';
+export type Action = 
+/** location 层 */
+'change'
+/** jsx 层 */
+ | 'render' | 'build' | 'mount' | 'unmount' | 'update'
+/** vdom 层 */
+ | 'patch'
+/** dom 层 */
+ | 'create' | 'insert' | 'remove' | 'move' | 'bind' | 'unbind' | 'cleanup'
+/** 错误层（任意环节失败——事件流完整覆盖：throw=未捕获传播 / caught=隔离降级） */
+ | 'throw' | 'caught'
+/** 内部决策层（渲染管线内部状态——busy 排队/组件未定位/跳过——非正常路径可观测） */
+ | 'queue' | 'notfound' | 'skip'
+/** 事件流自身层（buffer 状态——溢出覆盖/水位预警可观测） */
+ | 'overflow' | 'watermark'
+/** diff 决策层（阶段 0——vdom2 机制事件化）：
+ *  transition = 类型转换决策（from 旧 kind → to 新 kind——patch 查表分派观测）
+ *  mode       = key 模式选择（unkeyed/keyed/mixed——业务身份声明协议观测）
+ *  summary    = children 摘要（old/new/dom 三序列——顺序错乱快速定位） */
+ | 'transition' | 'mode' | 'summary'
+/** 渲染性能层（round2 阶段 2——每次渲染耗时可观测） */
+ | 'duration'
+/** 调度时间线层（round3 阶段 2——渲染排队/合并可观测） */
+ | 'queued' | 'flushed'
+/** portal 生命周期层（round3 阶段 3——弹层开合可观测） */
+ | 'open' | 'close'
+/** 组件副作用层（ref 挂载/动画/滚动锁/焦点 trap/滚动——非渲染的 DOM 行为可观测） */
+ | 'mount' | 'animate' | 'lock' | 'unlock' | 'focus' | 'scroll'
+/** 用户文本操作层（输入/选区/剪贴板——用户对文本的交互可观测） */
+ | 'input' | 'select' | 'copy' | 'cut' | 'paste'
+/** 应用编排层（app 节点——子应用挂载/更新/卸载/错误——payload.appId 可区分） */
+ | 'mount' | 'unmount' | 'error'
+/** 应用编排层（app 节点——子应用挂载/更新/卸载/错误——payload.appId 可区分） */
+ | 'mount' | 'unmount' | 'error';
+export type V3Event = {
+    /** 对象（什么） */
+    entity: Entity;
+    /** 动作（怎么了） */
+    action: Action;
+    /** 对象 id（目标定位——node id / comp id） */
+    target?: string;
+    /** 参数（对象相关数据——旧值/新值/父节点/属性 key 等） */
+    payload?: Record<string, unknown>;
+    /** 渲染会话 id（一次渲染（renderByIds/首帧/导航）内的事件共享同一 session——
+     *  按会话过滤/回放——vdom2 traceId 事件流化）——emit 时注入（stream 持有当前会话） */
+    session?: string;
     ts: number;
 };
+/** patch 决策策略（vnode:patch 的 payload.strategy） */
+export type PatchStrategy = 'reuse' | 'rebuild' | 'move' | 'remove' | 'unhandled';
+/** 错误发生的环节（error:throw/caught 的 payload.phase——全链路可定位） */
+export type ErrorPhase = 'factory' | 'renderFn' | 'build' | 'patch' | 'mount' | 'update' | 'hook' | 'schedule' | 'event';
 /** 事件流（记录/回放/断言——DOM = fold(events)） */
 export interface EventStream {
     emit(ev: V3Event): void;
+    /** 新渲染会话开始（每次渲染入口调用——同一次渲染的事件共享 session） */
+    setSession(): string;
+    /** 当前会话 id（无渲染进行时 null） */
+    currentSession(): string | null;
+    /** 实时订阅（emit 同步回调——缓冲溢出也不丢事件——返回退订）
+     *  重载：subscribe(fn) 全部事件；subscribe(filter, fn) 按层过滤（entity） */
+    subscribe(fn: (ev: V3Event) => void): () => void;
+    subscribe(filter: Entity[] | Entity, fn: (ev: V3Event) => void): () => void;
     events(): V3Event[];
+    /** 按渲染会话过滤（一次渲染的事件全量——调试/回放按会话） */
+    eventsBySession(sessionId: string): V3Event[];
+    /** 当前有效条数（缓冲占用——事件流自身状态可观测） */
+    size(): number;
+    /** 缓冲容量 */
+    capacity(): number;
+    /** 溢出次数（最旧事件被覆盖的次数——事件丢失可审计） */
+    overflowCount(): number;
     /** 逆操作（取消——INSERT↔REMOVE / UPDATE 恢复旧值） */
     inverse(ev: V3Event): V3Event | null;
     reset(): void;

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

@@ -9,35 +9,8 @@
  * render(ids) 语义：含自身 id → vdom3 ctx.render()（组件自身重渲染）；
  * 其他 id → vdom3 无跨组件 render（诚实 warn——后续补 registry 级 render）。
  */
-/** 组件 ctx.ui（vdom2 兼容面）——组件库零改动运行 */
-export interface V3Ui {
-    render(ids?: string[]): void;
-    onUnmount(fn: () => void): (() => void) | undefined;
-    selfId(name: string): void;
-    useExternal(store: any): any;
-    useControlled(options: any): any;
-    useControlledInput(options: any): any;
-    useOpen(options: any): any;
-    usePopup(options: any): any;
-    usePopupPosition(options: any): any;
-    useTween(target: number, opts?: any): any;
-    useInView(options?: any): any;
-    useScrollPosition(options?: any): any;
-    useGlobalKey(handler: (e: KeyboardEvent) => void): () => void;
-    useDrag(options?: any): any;
-    useDragDrop(options?: any): any;
-    useMedia(query: string, callback: (matches: boolean) => void): void;
-    useBreakpoint(bps: any, callback?: any): void;
-    useReducedMotion(): boolean;
-    useStableRef(init: any, cleanup?: any): any;
-    useAnimationEnd(cb: any, opts?: any): any;
-    usePresence(options?: any): any;
-    useLongPress(options?: any): any;
-    useHoverCapable(): boolean;
-    useVisualViewport(): any;
-    useAsync(fetcher: any): any;
-    useChat(options: any): any;
-    [key: string]: any;
-}
+/** 组件 ctx.ui（vdom2 兼容面——V3Ui 类型定义在 types.ts（hooks 契约继承）） */
+import type { V3Ui } from './types.ts';
+export type { V3Ui } from './types.ts';
 /** 组装 HookEnv + ctx.ui（组件实例级——id 绑定；共享态模块级） */
 export declare function createV3Ui(compId: string, render: () => void, onUnmountCb: (fn: () => void) => void): V3Ui;