weifuwu 0.81.0 → 0.81.2

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

@@ -31,8 +31,9 @@ export declare function classifyChild(c: VNodeChild): ChildKind;
 export declare function isInvalidVNodeType(t: unknown): boolean;
 /** 数组上下文：无渲染值（false/null/true）→ 占位（规则表 §1——childNodes 与数组同构） */
 export declare function isHoleChild(c: VNodeChild): boolean;
-/** 数组项必有 key（规则表 §3）：无显式 key 的元素/组件项赋默认下标 key（数组原始下标含占位位置，
- *  统一字符串）；文本/占位值豁免。原地写入 vnode.key（声明规则，非隐藏 magic） */
+/** 数组项 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;
@@ -46,8 +47,27 @@ export declare function eventTarget(key: string): {
 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） */
+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

@@ -17,7 +17,8 @@ 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）查表调用转换函数 */
+/** 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

@@ -12,6 +12,7 @@
  */
 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;
@@ -19,5 +20,7 @@ type HtmlCtx = {
 };
 /** 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/vnode.d.ts

@@ -13,6 +13,7 @@
  */
 export type VNodeType = string | Component<any, any> | typeof Fragment | typeof Portal;
 export type VNodeChild = VNode | string | number | boolean | null | undefined | VNodeChild[];
+import type { Lifecycle } from './vdom2/lifecycle.ts';
 export declare const Fragment: unique symbol;
 export declare const Portal: unique symbol;
 /** 通用字段（所有 VNode 共有——构建元数据；渲染前为 null 的显式初始化） */
@@ -34,6 +35,10 @@ interface VNodeBase {
     _parentVNode: VNode | null;
     /** 组件 renderFn 上次执行时的 ctx 版本号（buildVNode 剪枝 + diff 三态 skip） */
     _ctxVersion: number | null;
+    /** 生命周期状态（节点生命周期状态机——lifecycle.ts）：fresh→building→built / pruned；dispose→disposed */
+    _lifecycle: Lifecycle;
+    /** 渲染调度状态（render 调度状态机：IDLE/RUNNING——渲染中再次触发跳过，防重入） */
+    _rendering?: boolean;
 }
 /** 原生元素——type: string；特有：el（元素引用——锚点统一用 _refNode） */
 export interface NativeVNode extends VNodeBase {

package/package.json

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