weifuwu 0.83.0 → 0.85.0

package/dist/ui-dom/vdom2/patch.d.ts

@@ -1,116 +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 { VNode, VNodeChild } from '../vnode.ts';
-import { arrayChildren } from '../vnode.ts';
-export { arrayChildren };
-import { type Registry } from './registry.ts';
-/** 组件 vnode 从树中移除：ref(null) 递归 + 卸载钩子（cleanupComponent） */
-export declare function disposeComponent(vnode: VNode, registry?: Registry): void;
-import { type PropChannel } from './transform.ts';
-import { type KeyMode, type VKind } from './kind.ts';
-/** 重置 audit 告警去重（测试隔离——node --test 同进程共享 module 状态） */
-export declare function __resetAuditWarnings(): void;
-/**
- * 移除旧输出的全部 DOM（Fragment 展开多节点 + Portal 容器）并做组件/ref 清理。
- * @returns 移除后应插入新节点的位置（范围后兄弟；null = append 末尾）
- * 真实 bug：Frag→div 类型切换只 replaceChild 锚点 → Fragment 其余节点（holes/标记/数组项）残留
- * （frag-native-switch trace 定位 2026-12；同逻辑覆盖 Frag→null/Portal→null）
- *
- * 分派：REMOVERS[classifyKind(oldInput)] 查表（kind → 移除行为——无 if/else 类型链）
- */
-export declare function removeOldOutput(oldInput: VNodeChild, oldNode: Node | null, parent: Node, ctx: PatchCtx): Node | null;
-/** 移除状态机表（kind → 移除行为——单节点/范围/远程容器三类输出范围） */
-export declare const REMOVERS: Record<VKind, (oldInput: VNodeChild, oldNode: Node | null, parent: Node, ctx: PatchCtx) => Node | null>;
-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;
-/** 属性 diff 状态机表（通道 → 更新/移除行为——patchProps 查表分派）：
- *  每个处理器自含「移除」（nv==null/false）与「更新」两态——值判断保留在处理器内。
- *  通道分类单一源 = propChannelOf（transform.ts——与 setProp 共用，禁止各路径各自判定） */
-export declare const PROP_PATCHERS: Record<PropChannel, (el: Element, key: string, ov: any, nv: any) => void>;
-export declare function patchProps(el: Element, oldProps: Record<string, any>, newProps: Record<string, any>): void;
-/**
- * patchChildren — 数组 diff。
- * @returns 每个新子项的 DOM 范围（Fragment 展开对齐）
- */
-/** 多节点配对 diff（Fragment/数组项统一——2026-12 array2array）：
- *  展开 children（Fragment 项取 props.children；数组项传自身）→ patchChildren 递归。
- *  位置循环多节点分支与 fragToFrag（keyed/顶层入口）共用——多节点 diff 实现单点。
- *  oldRange = 标记范围（getOutputRange——start/end + fid 配对） */
-export declare function arrayToArray(parent: Node, oldInput: VNodeChild | null, newInput: VNodeChild | null, ctx: PatchCtx, oldRange: Node[] | null): (Node | null)[];
-export declare function patchChildren(parent: Node, oldInput: VNodeChild | null, newInput: VNodeChild | null, ctx: PatchCtx, oldRange?: Node[] | null, anchorOut?: (Node | null)[]): (Node | null)[];
-/** 位置级 kind 分类（数组上下文——POS 位置转换表分派用）：
- *  - hole ：无渲染值（null/false/undefined/true——占位）
- *  - real ：单节点值（text/native/comp/portal）
- *  - multi：多节点输出（数组项 = 隐式 Fragment / 显式 Fragment） */
-type PosKind = 'hole' | 'real' | 'multi';
-/** 位置转换上下文（数组 diff 每位置——POS 表分派参数） */
-interface PosState {
-    parent: Node;
-    oldC: VNodeChild | null;
-    newC: VNodeChild;
-    oldNode: Node | null;
-    i: number;
-    oldNodes: (Node | null)[];
-    newChildren: VNodeChild[];
-    out: (Node | null)[];
-    pushA: (n: Node | null) => void;
-    ctx: PatchCtx;
-}
-/** 位置级 (oldKind, newKind) 转换状态机表（数组上下文——与 x2y 同构的矩阵分派） */
-export declare const POS: Record<PosKind, Record<PosKind, (s: PosState) => void>>;
-/** keyed 新增项 kind 分类（无 key 匹配的占位/portal/普通项——KEYED_NEW 分派用） */
-type KeyedNewKind = 'hole' | 'portal' | 'real';
-/** keyed 新增上下文（KEYED_NEW 分派参数） */
-interface KeyedNewState {
-    parent: Node;
-    oldChildren: VNodeChild[];
-    newChildren: VNodeChild[];
-    oldNodes: (Node | null)[];
-    ctx: PatchCtx;
-    out: (Node | null)[];
-    pushA: (n: Node | null) => void;
-    arrEnd: Node | null;
-    c: VNodeChild;
-    i: number;
-}
-/** keyed 新增分派状态机表（kind → 处理——无 if/else 类型链） */
-export declare const KEYED_NEW: Record<KeyedNewKind, (s: KeyedNewState, lastRef: {
-    current: Node | null;
-}) => void>;
-/** 数组 diff 上下文（unkeyed/keyed 共享——状态机分派参数） */
-export interface KeyDiffState {
-    parent: Node;
-    oldChildren: VNodeChild[];
-    newChildren: VNodeChild[];
-    oldNodes: (Node | null)[];
-    ctx: PatchCtx;
-    arrEnd: Node | null;
-    anchorOut?: (Node | null)[];
-}
-/** mixed → keyed 状态转换：无 key 项分配 pos:{i}（位置身份显式化——防 keyed 分支
- *  「移除旧+新建」重建固定结构；portal 的 portalKey 不算用户 keyed（C1）——不分配） */
-export declare function prepPos(children: VNodeChild[]): void;
-/** key diff 策略状态机：KeyMode → 实现（查表分派——与 x2y 转换状态机同构）
- *  - unkeyed：位置身份——按位置 patch（不移动 DOM）
- *  - keyed  ：内容身份——按 key 匹配（keyMap + 位置校正）
- *  - mixed  ：状态转换 prepPos（无 key 项 → pos:{i}）→ 降级 keyed */
-export declare const KEY_DIFFERS: Record<KeyMode, (s: KeyDiffState) => (Node | null)[]>;

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

@@ -1,27 +0,0 @@
-/**
- * vdom/registry — 组件实例注册表（id → vnode）+ 卸载钩子
- *
- * 组件 id：`_wf_0` 自动分配（精准刷新锚点）+ `_customId`（ctx.ui.selfId 注册）。
- * 卸载钩子：hooks（usePopup/useMedia 等）注册清理回调，组件卸载时执行。
- */
-import type { VNode } from '../vnode.ts';
-export interface Registry {
-    idRegistry: Map<string, VNode>;
-    /** 卸载钩子（按组件 id 匹配——组件卸载时执行对应清理） */
-    unmountHooks: Array<(id: string) => void>;
-    nextId(): string;
-}
-export declare function createRegistry(): Registry;
-/** 给组件 vnode 分配 id（注册表写入） */
-export declare function ensureId(reg: Registry, vnode: VNode): string;
-/** 组件卸载回调注册（hooks 清理）——返回退订函数 */
-export declare function onComponentUnmountFor(reg: Registry, hook: (id: string) => void): () => void;
-/** 组件卸载：执行匹配的清理钩子 + 移除注册（vdom 渲染器卸载组件时调用） */
-export declare function cleanupComponent(reg: Registry, id: string): void;
-/** ref 调用错误隔离（用户 ref 抛错不中断渲染/清理管线） */
-export declare function safeCallRef(ref: Function, arg: any, phase: 'mount' | 'cleanup', name?: string): void;
-/**
- * 递归 ref 清理 + 组件卸载（组件 vnode 从树中移除时调用）：
- * idRegistry 注销 + 卸载钩子 + _child/props.children 递归 + ref(null) + Portal 容器移除
- */
-export declare function callRefCleanupFor(input: any, reg: Registry): void;

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

@@ -1,21 +0,0 @@
-/**
- * vdom2 render — vnode → DOM（客户端渲染）
- *
- * 与 vdom1 同构的渲染语义，但组织方式为**类型分派表**（vdom2 方案）：
- * RENDERERS[classifyKind(v)] 查表调用——每类一个渲染函数，无 if-else 类型链。
- * 渲染是「创建目标」——按目标类型分派（与 patch 的「源类型驱动 x2y」互补）。
- *
- * 输出范围协议（与 kind.ts getOutputRange 一致）：
- * - Fragment：_childNodes（输出节点数组）
- * - 组件：_refNode = 输出范围首节点（非 DocumentFragment——展开后失效）
- * - 数组项：fragment-start/end 标记（DOM 持久化）
- */
-import type { VNodeChild } from '../vnode.ts';
-import type { BrowserEnv } from '../types.ts';
-/** 创建占位节点（数组上下文的无渲染值 → 注释节点，childNodes 与数组同构——规则表 §1） */
-export declare function createHole(browser: BrowserEnv, v: unknown): Node | null;
-/** 递归渲染（同步——组件必须已构建；首帧/新增路径） */
-export declare function renderValue(v: VNodeChild, ctx: any, browser?: BrowserEnv, key?: string | null, id?: string | null, fid?: string | null): Node | null;
-/** 渲染函数表（按 classifyKind 分派——每类一个实现，无 if-else 类型链） */
-export declare const RENDERERS: Record<string, (v: VNodeChild, ctx: any, b: BrowserEnv, key?: string | null, id?: string | null, fid?: string | null) => Node | null>;
-export declare function renderTree(v: VNodeChild, ctx: any, browser?: BrowserEnv): Node | null;

package/dist/ui-dom/vdom2/route.d.ts

@@ -1,29 +0,0 @@
-/**
- * vdom2 route — 路由生命周期状态机（2026-12，design/vdom-lifecycle-state-machines.md Phase 1）
- *
- * 四状态机架构的第一层（页面级·宏观）：导航状态统一管理——
- * idle → navigating（旧树卸载/新树构建中）→ settled（新树就绪）。
- *
- * 与节点状态机（lifecycle.ts）的协同：NAVIGATE_START 触发旧树 DISPOSE + 新树 BUILD；
- * NAVIGATE_DONE 表示整条链路（build → diff → render）完成。
- *
- * 统一架构模式：状态 + 事件 + 转换表 + 查表分派（无 if/else 分派链）。
- */
-/** 路由生命周期状态 */
-export type RouteLifecycle = 'idle' | 'navigating' | 'settled';
-/** 路由事件（导航触发点） */
-export type RouteEvent = 'NAVIGATE_START' | 'NAVIGATE_DONE' | 'NAVIGATE_ERROR';
-/** 路由生命周期协调器（每 app 实例一个——serve.ts 接入） */
-export interface RouteController {
-    state: RouteLifecycle;
-    /** 导航开始（renderPath 入口）：旧树卸载 + 新树构建起点 */
-    navigateStart(path: string): void;
-    /** 导航完成（build + diff + render 全部落地） */
-    navigateDone(path: string): void;
-    /** 导航失败（router.execute 抛错——回退 idle） */
-    navigateError(path: string, err: unknown): void;
-}
-/** 创建路由生命周期协调器（查表分派——非法转换 emit/trace warn 不静默） */
-export declare function createRouteController(): RouteController;
-/** 重置（测试/清理用） */
-export declare function __resetRouteState(): void;

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

@@ -1,32 +0,0 @@
-/**
- * vdom2/ssr — 服务端渲染（基于 x2html——与客户端 renderValue 同一类型遍历）
- *
- * ssrToString：组件 → HTML 片段（工厂 + renderFn 现场执行——SSR 无预构建）
- * serializeData：__DATA__ 种子（hydration 同步命中）
- * ssrPage：完整页面（路由 + 数据 + HTML + 种子）
- */
-import type { Component } from '../vnode.ts';
-import { type VdomCtx } from './ctx.ts';
-/** __DATA__ 序列化（hydration 种子——< 转义防注入） */
-export declare function serializeData(data: Map<string, unknown>): string;
-/** SSR ctx：ui shim（hooks no-op）+ ctx.data（预取写入 dataStore） */
-export declare function createSsrContext(serverCtx: Record<string, unknown>, dataStore: Map<string, unknown>): VdomCtx;
-/** SSR 渲染组件 → HTML 片段（组件现场执行工厂 + renderFn） */
-export declare function ssrToString(Comp: Component, props: Record<string, any>, serverCtx: any, opts?: {
-    data?: Map<string, unknown>;
-}): Promise<string>;
-export interface SsrPageResult {
-    html: string;
-    /** __DATA__ 脚本（hydration 种子） */
-    dataScript: string;
-    /** 完整 HTML 页面 */
-    page: string;
-}
-/** SSR 完整页面（路由 + 数据 + HTML + 种子） */
-export declare function ssrPage(router: any, opts: {
-    url: string;
-    title?: string;
-    lang?: string;
-    rootId?: string;
-    styles?: string[];
-}): Promise<SsrPageResult>;

package/dist/ui-dom/vdom2/trace.d.ts

@@ -1,62 +0,0 @@
-/**
- * vdom/trace — 结构化调试 trace（阶段级开关 + 渲染会话 traceId）
- *
- * 目的（design 归档）：
- * - 一次建立全面 vdom 调试能力：build/render/diff/mount/audit 各阶段独立开关
- * - traceId 关联同一渲染会话（renderByIds/首帧/导航）的全部日志——事故可回放
- * - children 顺序可视化（kidsSeq）——快速定位顺序错乱类 bug（Fragment/数组项）
- *
- * 开启方式（三路，幂等解析）：
- *   1. URL query：?vdom_trace=build,render,diff（阶段子集）；?vdom_trace=render:trace（阶段+级别）；
- *      ?vdom_debug=1（兼容旧开关——全开 debug + audit）
- *   2. 全局变量（页面加载前注入）：window.__vdom_trace__ = { stages, level }
- *   3. localStorage：localStorage.vdom_trace = 'render:debug'（运行时设置 + reload）
- *
- * 性能：关闭时零开销——trace() 首行 flag 检查；插桩点用 traceEnabled() 前置检查
- * （关闭时连参数求值都跳过）。开启时高频路径（diff 逐位置）默认 trace 级（低于默认 debug）。
- *
- * 与 ../debug.ts（uiLog——递归深度/死循环定位）互补：trace 是阶段结构化日志，
- * uiLog 是深度跟踪——两者独立开关、不冲突。
- */
-import type { VNodeChild } from '../vnode.ts';
-export type VdomStage = 'mount' | 'build' | 'render' | 'diff' | 'lifecycle' | 'route' | 'audit';
-export type VdomLevel = 'error' | 'warn' | 'info' | 'debug' | 'trace';
-export interface VdomTraceConfig {
-    enabled: boolean;
-    /** 空 Set = 全阶段开启 */
-    stages: Set<VdomStage>;
-    /** 最低级别（info 起；debug/trace 明细） */
-    level: VdomLevel;
-    /** 组件名过滤（只输出含该名称的组件相关日志；null = 不过滤） */
-    filter: string | null;
-}
-/**
- * 解析开启配置（幂等——首次调用后缓存）。
- * uiServe 在首帧渲染前调用一次；测试/Node 环境也可手动调用。
- */
-export declare function initVdomTrace(): VdomTraceConfig;
-/** 插桩点前置检查：阶段开启 + 级别满足（关闭时连参数求值都跳过） */
-export declare function traceEnabled(stage: VdomStage, level?: VdomLevel): boolean;
-/** 输出 trace 日志（[vdom:{stage}] {traceId} {msg}）
- *  统一事件流：trace = 执行细节摘要通道——内部发射 TRACE 事件（console sink 输出原格式；
- *  ring/collect sink 记录——执行细节可追溯/可断言）。
- *  gate：trace 开启 或 存在观测 sink（collect/ring）——否则零成本（调用点已有 traceEnabled 前置守卫保证 msg 惰性） */
-export declare function trace(stage: VdomStage, level: VdomLevel, msg: string, ...args: unknown[]): void;
-/** 手动配置（测试/调试用——不受 init 时序/缓存影响） */
-export declare function configureVdomTrace(c: Partial<Omit<VdomTraceConfig, 'enabled'>>): void;
-export declare function nextTraceId(tag?: string): string;
-/** children 顺序摘要：["div#list-simple | false | ARR(2) | str"] */
-export declare function kidsSeq(kids: VNodeChild[] | null, max?: number): string;
-/** 单值摘要（children 项） */
-export declare function vnDesc(v: VNodeChild): string;
-/** DOM 节点摘要 */
-export declare function nodeDesc(n: Node | null): string;
-/** DOM 子节点序列摘要（childNodes 顺序——与 kidsSeq 对照验证顺序一致性） */
-export declare function childNodesSeq(parent: Node | null, max?: number): string;
-/** 递归打印 vnode 树快照：type + id + lifecycle + 深度缩进（组件视角——整页可观测） */
-export declare function dumpTree(vnode: VNodeChild, depth?: number): string[];
-/** 安装全局调试 API（dev/调试——页面加载后可用）：
- *  __vdom_dump()      全树生命周期快照（root 由调用方注入）
- *  __vdom_lc(id?)     生命周期时间线（全组件或单组件）
- *  __vdom_events(n?)  统一状态机事件流（最近 N 条——跨状态机关联/追溯） */
-export declare function installVdomInspect(rootGetter: () => VNodeChild | null | undefined): void;

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

@@ -1,76 +0,0 @@
-/**
- * transform — children/属性转化规则单一源（design 归档 阶段 0）
- *
- * 可推导性 by construction（design/vdom-transform-rules.md）：所有 children 形态判定与
- * 属性通道判定收敛到此单一模块——buildVNode / renderValue / patchChildren / renderSsr /
- * hydrateVNode 全部调用，禁止各路径各自实现形态判定（同一语义多套实现 = 漂移 = 转化分叉）。
- */
-import type { VNodeChild } from '../vnode.ts';
-import type { BrowserEnv } from '../types.ts';
-/** 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 | null;
-}): 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;
-/** 非法 type 判定（组件/原生/Fragment/Portal 之外——数字/未知 Symbol/缺失 → 诊断占位） */
-export declare function isInvalidVNodeType(t: unknown): boolean;
-/** 数组上下文：无渲染值（false/null/true）→ 占位（规则表 §1——childNodes 与数组同构） */
-export declare function isHoleChild(c: VNodeChild): boolean;
-/** 数组项 key 规范化（key 业务身份声明协议——design 归档）：显式 key 仅字符串化（统一字符串）；
- *  无 key 项保持 null（框架不生成身份 key——位置身份由 patch 的 prepPos 显式接管混合数组）。
- *  文本/占位值豁免。原地写入 vnode.key（声明规则，非隐藏 magic） */
-export declare function ensureArrayKeys(children: VNodeChild[]): void;
-/** 事件 prop 判定：on + 大写字母（React 约定）——排除 once/only 等 on 开头非事件属性 */
-export declare const EVENT_RE: RegExp;
-/** 事件类型 + 捕获标志（onClick → click；onClickCapture → click + capture）——单一实现 */
-export declare function eventTarget(key: string): {
-    type: string;
-    capture: boolean;
-};
-/** enumerated value-based 白名单（规则表 §2）：空字符串解析为 false——必须显式 'true'/'false'。
- *  对照 HTML 规范 enumerated 属性表：value-based 类（draggable/contenteditable/spellcheck/translate） */
-export declare const ENUMERATED_VALUE_BASED: Set<string>;
-/** CSS 无单位属性（数字不加 px）——其余数字样式属性必须加 px（规则表 §2 UNITLESS 白名单） */
-export declare const UNITLESS_PROPS: Set<string>;
-/** 属性通道分类（单一判定源——setProp/patchProps/x2html 共用；规则表 §2 属性三通道）：
- *  - enumerated ：value-based 枚举属性（draggable 等——空字符串解析为 false，必须显式 'true'/'false'）
- *  - class      ：class/className（字符串/对象形态）
- *  - style      ：style（字符串/对象形态）
- *  - ref        ：ref 回调（挂载调用 el / 卸载调用 null）
- *  - event      ：on + 大写（onClick/onClickCapture——事件通道）
- *  - value      ：input/select value（property）
- *  - indeterminate：checkbox 半选态（property——attribute 解析为 false）
- *  - innerHTML  ：innerHTML 内容（存在则 children 不渲染）
- *  - aria       ：aria-* 语义属性（boolean 必须显式 'true'/'false'）
- *  - default    ：其余——property + attribute 双写 */
-export type PropChannel = 'enumerated' | 'class' | 'style' | 'ref' | 'event' | 'value' | 'indeterminate' | 'innerHTML' | 'aria' | 'default';
-/** 属性通道判定（key 分类——值判断留在各通道处理函数内，规则表 §2）
- *  enumerated 白名单小写匹配：JSX camelCase（contentEditable）与规范小写（contenteditable）
- *  统一走显式 'true'/'false'——否则 camelCase 落入 boolean 通道输出空字符串（解析仍 true，
- *  但违反 §6.2 显式协议且属性值不可预期） */
-export declare function propChannelOf(key: string): PropChannel;
-type SetPropFn = (el: Element, key: string, value: any) => void;
-/** 属性设置状态机表（通道 → 设置行为——setProp 查表分派，无 if/else 通道链） */
-export declare const PROP_SETTERS: Record<PropChannel, SetPropFn>;
-/** 属性设置（查表分派——PROP_SETTERS[propChannelOf(key)]） */
-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 {};
-/** 递归渲染（同步——组件必须已构建） */ 

package/dist/ui-dom/vdom2/transitions.d.ts

@@ -1,24 +0,0 @@
-/**
- * vdom2 x2y 转换状态机——**源类型驱动**：每个 (源, 目标) 组合一个转换函数，
- * TRANSITIONS[oldKind][newKind] 查表分派（patchValue 用）。
- *
- * 转换动作由**源类型**决定（源最清楚自己的 DOM 形态如何移除/递归/复用）：
- * - 同类型：递归 patch（frag→frag children diff / comp→comp 输出递归 / native→native
- *   同 tag in-place / arr→arr 数组递归 / text→text nodeValue 直改 / hole→hole 占位保持 /
- *   portal→portal 远程 patch）
- * - 异类型：toOther 通用——renderValue 渲染目标 + removeOldOutput 移除旧输出
- *   （removeOldOutput 内部 getOutputRange 多态——每类输出范围：Fragment._childNodes /
- *   组件 _outputChild 递归 / 数组 fragment-start..end 标记）
- *
- * 全量组合表显式列出——vdom2-matrix.test.ts 9×9 矩阵验证无遗漏。
- */
-import { Fragment, Portal } from '../vnode.ts';
-import { type PatchState, type VKind } from './kind.ts';
-import { type PatchCtx } from './patch.ts';
-type TransitionFn = (s: PatchState) => Node | null;
-export declare const TRANSITIONS: Record<VKind, Record<VKind, TransitionFn>>;
-/** x2y 状态机分派：由源类型（oldInput）与目标类型（newInput）查表调用转换函数
- *  转换事件：machine=x2y（from=旧 kind，to=新 kind）——过程级可观测 */
-export declare function x2y(s: PatchState): Node | null;
-export type { PatchCtx };
-export { Fragment, Portal };

package/dist/ui-dom/vdom2/x2html.d.ts

@@ -1,26 +0,0 @@
-/**
- * vdom2 x2html — vnode → HTML 字符串（SSR）
- *
- * 与 renderValue（客户端 DOM）同一**类型遍历**——TO_HTML[classifyKind(v)] 分派：
- * 每个类型一个渲染实现，SSR/客户端结构同构（数组边界标记/占位注释/属性规则同一单一规则源
- * transform.ts），hydration 不 mismatch。
- *
- * 与客户端的差异（SSR 语义）：
- * - 组件：现场执行工厂 + renderFn（无预构建——SSR 服务端每次渲染）
- * - Portal：就地内联子节点（客户端 portal 渲染到 #__wf_portal——SSR 内联保留内容/SEO）
- * - 事件 props 剥离（hydration 接线）；ref 剥离
- */
-import type { VNodeChild } from '../vnode.ts';
-import { isFrag, isComp, isPortal, isNative, Fragment, Portal } from '../vnode.ts';
-import { type VKind } from './kind.ts';
-export declare function escape(s: string): string;
-type HtmlCtx = {
-    _fidPath?: string;
-    [key: string]: any;
-};
-/** vnode → HTML（SSR）——类型分派主入口 */
-export declare function x2html(input: VNodeChild, ctx: HtmlCtx): Promise<string>;
-/** 类型分派表（与客户端 renderValue 同一 classifyKind——SSR/客户端结构同构） */
-export declare const TO_HTML: Record<VKind, (v: VNodeChild, ctx: HtmlCtx) => Promise<string>>;
-export { Fragment, Portal };
-export { isFrag, isComp, isPortal, isNative };

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

@@ -1,20 +0,0 @@
-/**
- * vdom3 compat — vdom2 ↔ vdom3 组件兼容层（迁移路径）
- *
- * vdom2 两阶段组件 `(initProps, ctx) => async (props) => VNode` 与 vdom3 同模型——
- * 唯一差异是 ctx 接口：vdom2 用 `ctx.ui.render()`（vdom2 的 ui 上下文）。
- *
- * compat()：包一层——ctx.ui.render → v3 ctx.render（调度自身重渲染——同 tick 合并）。
- * 迁移：vdom2 组件 `h(compat(V2Comp), props)` 即可在 vdom3 树运行（无需改组件代码）。
- *
- * 裁剪（诚实）：只适配 render/onUnmount/基础 ctx——vdom2 的 hooks
- * （useExternal/useMedia/usePopup 等 ctx.ui.* 依赖）不在兼容范围
- * （迁移时由调用方注入或重构）。
- */
-import type { Component } from './types.ts';
-type V2Component = (initProps: any, ctx: any) => Promise<(props: any) => Promise<any>>;
-/** vdom2 组件 → vdom3 组件（ctx.ui.render 适配） */
-export declare function compat(comp: V2Component): Component;
-/** vdom3 组件 → vdom2 组件（反向互操作——ctx.render 从 ui.render 取） */
-export declare function toV2(comp: Component): V2Component;
-export {};