weifuwu 0.94.0 → 0.95.0

package/dist/level3/vdom/patch/verify.d.ts

@@ -0,0 +1,17 @@
+/**
+ * vdom core/patch — dev 验证器（状态机 Post 断言——dev only）
+ *
+ * 机制（P3b/P3c）：CommandApplier 可选注入 devVerify——每个命令消费后
+ * 断言 Post——**状态机规格单一实现源**：patch/state-machine.ts（transition
+ * ——与 Sim（契约层对账器）共用——消灭双实现漂移）——数据面类型检查
+ * （nodeType）与挂载性（isConnected）在此补充（规格的类型维度由各数据面
+ * 承担——Sim 查 SimNode.kind / devVerify 查 nodeType）。
+ *
+ * 报告方式：console.error（不中断渲染管线——dev 可见性）——
+ * 违例 = 生成层 bug 或 Sim 与浏览器语义差异（isConnected 类问题落验）。
+ *
+ * 生产零开销：仅 window.__WF_DEV__ 开启时注入（serve.ts）。
+ */
+import type { Command } from '../../../level0/vdom/command/index.ts';
+import type { CommandApplier } from './index.ts';
+export declare function createDevVerifier(): (cmd: Command, applier: CommandApplier) => void;

package/dist/level3/vdom/patch/verify.ts

@@ -0,0 +1,47 @@
+/**
+ * vdom core/patch — dev 验证器（状态机 Post 断言——dev only）
+ *
+ * 机制（P3b/P3c）：CommandApplier 可选注入 devVerify——每个命令消费后
+ * 断言 Post——**状态机规格单一实现源**：patch/state-machine.ts（transition
+ * ——与 Sim（契约层对账器）共用——消灭双实现漂移）——数据面类型检查
+ * （nodeType）与挂载性（isConnected）在此补充（规格的类型维度由各数据面
+ * 承担——Sim 查 SimNode.kind / devVerify 查 nodeType）。
+ *
+ * 报告方式：console.error（不中断渲染管线——dev 可见性）——
+ * 违例 = 生成层 bug 或 Sim 与浏览器语义差异（isConnected 类问题落验）。
+ *
+ * 生产零开销：仅 window.__WF_DEV__ 开启时注入（serve.ts）。
+ */
+import type { Command } from '../../../level0/vdom/command/index.ts'
+import type { CommandApplier } from './index.ts'
+import { createStateTracker, transition } from '../../../level1/vdom/patch/state-machine.ts'
+
+/** dev 验证器（共享规格——每命令消费后状态迁移 + Post 断言） */
+function trackerIds(): string[] { return [] }
+export function createDevVerifier(): (cmd: Command, applier: CommandApplier) => void {
+  const tracker = createStateTracker()
+  return (cmd, applier) => {
+    // 共享规格（P3c——与 Sim 同一份 transition）
+    const violations = transition(tracker, cmd)
+    for (const v of violations) console.error(`[vdom-dev] ${v}`)
+    // 数据面补充检查（类型/挂载性）
+    switch (cmd.op) {
+      case 'insert': {
+        const n = applier.nodes.get(cmd.id)
+        if (n && !n.isConnected) console.error(`[vdom-dev] insert Post 违例：${cmd.id} 未挂载（isConnected=false）`)
+        break
+      }
+      case 'setText': {
+        const n = applier.nodes.get(cmd.id)
+        if (n && n.nodeType !== 3) console.error(`[vdom-dev] setText Pre 违例：${cmd.id} 非文本节点（${n.nodeType}）`)
+        break
+      }
+      case 'setProp': {
+        const n = applier.nodes.get(cmd.id)
+        if (n && n.nodeType !== 1) console.error(`[vdom-dev] setProp Pre 违例：${cmd.id} 非元素节点（${n.nodeType}）`)
+        break
+      }
+      default: break
+    }
+  }
+}

package/dist/level3/vdom/protocol.d.ts

@@ -0,0 +1,98 @@
+import type { VNode } from '../../level0/vdom/vnode.ts';
+import type { UIContext } from './context/UIContext.ts';
+import type { Command } from '../../level0/vdom/command/index.ts';
+import type { ApiClient, AuthClient, I18nState, WsClient } from '../../level1/vdom/ports.ts';
+/** 函数表还原（$fn 标记 → 函数——编码/解码同进程共享） */
+export declare function reviveFn(fnTable: Map<number, unknown>): (k: string, v: unknown) => unknown;
+/** R1 熔断默认回退 UI（core 内建——inline style 零样式系统依赖——
+ *  errorFallback 未配置时使用——错误文案 + 重试按钮（恢复路径）） */
+export declare function defaultErrorFallback(err: Error, ctx: UIContext): VNode;
+/** NDJSON 命令流解析（行缓冲——命令可能跨 chunk——函数表还原——
+ * 导出（测试——跨 chunk 边界/畸形行合规断言）） */
+export declare function commandReader(reader: ReadableStreamDefaultReader<Uint8Array>, fnTable: Map<number, unknown>): AsyncGenerator<Command>;
+/** 命令流编码（函数面 → {$fn: n}——函数表——同进程共享）
+ *  函数 → 序号（WeakMap——同函数流内复用同序号——减少重复条目） */
+export declare function encodeCommands(stream: ReadableStream<Command>, fnTable: Map<number, unknown>): ReadableStream<Uint8Array>;
+/** 函数表（serve 级共享——编码/解码同进程） */
+export declare function createFnTable(): Map<number, unknown>;
+/** uiServe 选项（v1/v2 共同——公共面契约） */
+export interface UiServeOptions {
+    /** 根容器（选择器或元素） */
+    root: string | HTMLElement;
+    /** 错误熔断回退（R1——应用可配置） */
+    errorFallback?: (err: Error, ctx: UIContext) => VNode;
+    /** 数据客户端（W0 web——装配面类型化——api 形状错编译红） */
+    api?: ApiClient;
+    /** 认证客户端 */
+    auth?: AuthClient;
+    /** WebSocket 客户端 */
+    ws?: WsClient;
+    /** 国际化 */
+    i18n?: I18nState;
+    /** 命令式轻提示（形状与 ToastInjected 对齐——签名内联避免 core→components 依赖） */
+    toast?: (message: string, type?: 'success' | 'error' | 'info' | 'warning', duration?: number, action?: {
+        label: string;
+        onClick: () => void;
+    }) => void;
+    /** 命令式确认 */
+    confirm?: (message: string, options?: {
+        title?: string;
+    } & Record<string, unknown>) => Promise<boolean>;
+    /** 命令式通知（对齐 NotificationInjected 形状——对象式 + open/success/error/info/warning 面） */
+    notification?: {
+        (title: string, opts?: {
+            type?: 'success' | 'error' | 'info' | 'warning';
+            description?: string;
+            duration?: number;
+            action?: {
+                label: string;
+                onClick: () => void;
+            };
+        }): void;
+        open: (opts: {
+            type?: 'success' | 'error' | 'info' | 'warning';
+            title: string;
+            description?: string;
+            duration?: number;
+            action?: {
+                label: string;
+                onClick: () => void;
+            };
+        }) => void;
+        success: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        error: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        info: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        warning: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+    };
+    [key: string]: unknown;
+}
+/** uiServe 句柄（v1/v2 共同） */
+export interface UiServeHandle {
+    ready: Promise<void>;
+    render(): Promise<void>;
+    navigate(path: string): Promise<void>;
+    /** 卸载（清理事件代理/组件实例——DOM 清空） */
+    unmount(): void;
+}
+export type ServePhase = 'active' | 'unmounted';
+export type RenderPhase = 'idle' | 'rendering';
+/** 渲染上下文（stream = 页面作者渲染入口——vnode → command 流） */
+export interface RenderCtx extends UIContext {
+    stream(vnode: VNode, init?: ResponseInit): Response;
+}

package/dist/level3/vdom/protocol.ts

@@ -0,0 +1,152 @@
+/**
+ * vdom core — protocol（命令流协议层——v1/v2 引擎共享）
+ *
+ * **v1 退役拆分（2027-08）**：原 core/serve.ts 同时承载 uiServe（v1 引擎）
+ * 与协议层（函数表编码/命令流解码/熔断 fallback/RenderCtx 类型）——v2 引擎
+ * 依赖后者——删除 v1 引擎前把协议层抽为独立文件。
+ * 原 uiSsr（core/ssr/index.ts）的 NDJSON 解码同样归并（v1 引擎特有——
+ * v2/ssr.ts 有自己的解码——协议面仅保留编码/解码原语）。
+ */
+import { UIRouter } from './router.ts'
+import { CommandApplier } from './patch/index.ts'
+import { h } from '../../level0/vdom/vnode.ts'
+import type { VNode } from '../../level0/vdom/vnode.ts'
+import { createComponentRegistry } from './node/component.ts'
+import type { UIContext } from './context/UIContext.ts'
+import type { Command } from '../../level0/vdom/command/index.ts'
+import type { Browser } from './browser/Browser.ts'
+import type { ApiClient, AuthClient, I18nState, WsClient } from '../../level1/vdom/ports.ts'
+import { createDevVerifier } from './patch/verify.ts'
+import { installEffectGuard } from '../../level1/vdom/dev/effect-guard.ts'
+
+/** 函数表还原（$fn 标记 → 函数——编码/解码同进程共享） */
+export function reviveFn(fnTable: Map<number, unknown>) {
+  return (k: string, v: unknown): unknown => {
+    if (v && typeof v === 'object' && typeof (v as { $fn?: unknown }).$fn === 'number') {
+      const fn = fnTable.get((v as { $fn: number }).$fn)
+      if (!fn) console.error(`[vdom] 传输违例：$fn:${(v as { $fn: number }).$fn} 无对应函数（函数表已清/跨流引用）`)
+      return fn
+    }
+    return v
+  }
+}
+
+/** R1 熔断默认回退 UI（core 内建——inline style 零样式系统依赖——
+ *  errorFallback 未配置时使用——错误文案 + 重试按钮（恢复路径）） */
+export function defaultErrorFallback(err: Error, ctx: UIContext): VNode {
+  return h('div', {
+    class: 'wf-error-fallback',
+    style: 'padding:40px 24px;text-align:center;font-family:var(--wf-font-sans,system-ui);',
+  }, [
+    h('div', { style: 'font-size:21px;font-weight:600;margin-bottom:8px;' }, '页面渲染失败'),
+    h('div', { style: 'font-size:13px;color:var(--wf-color-text-secondary,#64748b);margin-bottom:16px;max-width:520px;margin-inline:auto;word-break:break-all;' }, String(err?.message ?? err)),
+    h('button', {
+      class: 'wf-btn wf-btn--primary',
+      onClick: () => { void ctx.render?.() },
+      style: 'padding:8px 20px;border-radius:6px;border:none;cursor:pointer;',
+    }, '重试'),
+  ])
+}
+
+/** NDJSON 命令流解析（行缓冲——命令可能跨 chunk——函数表还原——
+ * 导出（测试——跨 chunk 边界/畸形行合规断言）） */
+export function commandReader(
+  reader: ReadableStreamDefaultReader<Uint8Array>,
+  fnTable: Map<number, unknown>,
+): AsyncGenerator<Command> {
+  const decoder = new TextDecoder()
+  let buf = ''
+  return (async function* () {
+    const revive = reviveFn(fnTable)
+    while (true) {
+      const { value, done } = await reader.read()
+      if (done) break
+      buf += decoder.decode(value, { stream: true })
+      const lines = buf.split('\n')
+      buf = lines.pop() ?? ''
+      for (const line of lines) {
+        if (!line.trim()) continue
+        yield JSON.parse(line, revive) as Command
+      }
+    }
+    if (buf.trim()) yield JSON.parse(buf, revive) as Command
+  })()
+}
+
+/** 命令流编码（函数面 → {$fn: n}——函数表——同进程共享）
+ *  函数 → 序号（WeakMap——同函数流内复用同序号——减少重复条目） */
+export function encodeCommands(
+  stream: ReadableStream<Command>,
+  fnTable: Map<number, unknown>,
+): ReadableStream<Uint8Array> {
+  const enc = new TextEncoder()
+  const fnToId = new WeakMap<object, number>()
+  const mark = (k: string, v: unknown): unknown => {
+    if (typeof v === 'function') {
+      const known = fnToId.get(v as object)
+      if (known !== undefined) return { $fn: known }
+      const n = fnTable.size + 1
+      fnTable.set(n, v)
+      fnToId.set(v as object, n)
+      return { $fn: n }
+    }
+    return v
+  }
+  return stream.pipeThrough(new TransformStream<Command, Uint8Array>({
+    transform(cmd, controller) {
+      controller.enqueue(enc.encode(JSON.stringify(cmd, mark) + '\n'))
+    },
+  }))
+}
+
+/** 函数表（serve 级共享——编码/解码同进程） */
+export function createFnTable(): Map<number, unknown> {
+  return new Map()
+}
+
+/** uiServe 选项（v1/v2 共同——公共面契约） */
+export interface UiServeOptions {
+  /** 根容器（选择器或元素） */
+  root: string | HTMLElement
+  /** 错误熔断回退（R1——应用可配置） */
+  errorFallback?: (err: Error, ctx: UIContext) => VNode
+  /** 数据客户端（W0 web——装配面类型化——api 形状错编译红） */
+  api?: ApiClient
+  /** 认证客户端 */
+  auth?: AuthClient
+  /** WebSocket 客户端 */
+  ws?: WsClient
+  /** 国际化 */
+  i18n?: I18nState
+  /** 命令式轻提示（形状与 ToastInjected 对齐——签名内联避免 core→components 依赖） */
+  toast?: (message: string, type?: 'success' | 'error' | 'info' | 'warning', duration?: number, action?: { label: string; onClick: () => void }) => void
+  /** 命令式确认 */
+  confirm?: (message: string, options?: { title?: string } & Record<string, unknown>) => Promise<boolean>
+  /** 命令式通知（对齐 NotificationInjected 形状——对象式 + open/success/error/info/warning 面） */
+  notification?: {
+    (title: string, opts?: { type?: 'success' | 'error' | 'info' | 'warning'; description?: string; duration?: number; action?: { label: string; onClick: () => void } }): void
+    open: (opts: { type?: 'success' | 'error' | 'info' | 'warning'; title: string; description?: string; duration?: number; action?: { label: string; onClick: () => void } }) => void
+    success: (opts: { title: string; description?: string; duration?: number }) => void
+    error: (opts: { title: string; description?: string; duration?: number }) => void
+    info: (opts: { title: string; description?: string; duration?: number }) => void
+    warning: (opts: { title: string; description?: string; duration?: number }) => void
+  }
+  [key: string]: unknown
+}
+
+/** uiServe 句柄（v1/v2 共同） */
+export interface UiServeHandle {
+  ready: Promise<void>
+  render(): Promise<void>
+  navigate(path: string): Promise<void>
+  /** 卸载（清理事件代理/组件实例——DOM 清空） */
+  unmount(): void
+}
+
+export type ServePhase = 'active' | 'unmounted'
+export type RenderPhase = 'idle' | 'rendering'
+
+/** 渲染上下文（stream = 页面作者渲染入口——vnode → command 流） */
+export interface RenderCtx extends UIContext {
+  stream(vnode: VNode, init?: ResponseInit): Response
+}

package/dist/level3/vdom/router.d.ts

@@ -0,0 +1,38 @@
+/**
+ * vdom core — route 阶段（UIRouter——应用唯一入口——公共面）
+ *
+ * 设计（ §2）：Handler 签名字面同构后端——
+ * `(req: Request, ctx) => Response`——原生 Request/Response——
+ * 路由核心 = shared Trie（src/level0/router/trie.ts——前后端共用）——
+ * 静态段优先 → :param → * 通配——params 注入 req。
+ */
+import type { UIContext } from './context/UIContext.ts';
+import type { Command } from '../../level0/vdom/command/index.ts';
+/** 页面 handler——返回原生 Response（body = 命令流字节——NDJSON）——
+ *  与后端 Handler 签名字面同构：(req, ctx) => Response——req 为**标准
+ *  Request**（零扩展——params/query 经 ctx 注入） */
+export type PageHandler = (req: Request, ctx: UIContext) => Response | Promise<Response>;
+/** 渲染入口封装：命令流 → 原生 Response（body = NDJSON 字节流——
+ *  HTTP 传输层即字节——命令纯数据可序列化——服务端同源解析） */
+export declare function commandResponse(stream: ReadableStream<Command>, init?: ResponseInit): Response;
+/** 构造前端请求（纯标准 Request——零扩展——URL 基于 http://localhost） */
+export declare function frontRequest(path: string): Request;
+export declare class UIRouter {
+    private root;
+    private notFoundHandler;
+    /** 注册路由（shared Trie——静态/:param/*——params 注入 req） */
+    get(path: string, handler: PageHandler): this;
+    /** 路由存在性（onDocClick 决策：无匹配 → 不拦截——默认完整导航——
+     *  实证：stats 页「← 填写页」链接被拦截但 navigate 落空——半跳转） */
+    has(path: string): boolean;
+    /** 404 兜底 */
+    notFound(handler: PageHandler): this;
+    /** 解析请求 → 响应（Trie 匹配 + **params/query 注入 ctx**——对齐后端
+     *  `ctx = { params, query }`——`Object.fromEntries(searchParams)`——
+     *  不修改原始 Request） */
+    private _pipeline?;
+    private get pipeline();
+    /** 解析请求 → 响应（**shared pipeline 内核**——parse→match→ctx 注入→
+     *  执行→404 兜底骨架单源——非法编码 → 400（B1——对齐 server 语义）） */
+    resolve(req: Request, ctx: UIContext): Promise<Response>;
+}

package/dist/level3/vdom/router.ts

@@ -0,0 +1,101 @@
+/**
+ * vdom core — route 阶段（UIRouter——应用唯一入口——公共面）
+ *
+ * 设计（ §2）：Handler 签名字面同构后端——
+ * `(req: Request, ctx) => Response`——原生 Request/Response——
+ * 路由核心 = shared Trie（src/level0/router/trie.ts——前后端共用）——
+ * 静态段优先 → :param → * 通配——params 注入 req。
+ */
+
+import type { UIContext } from './context/UIContext.ts'
+import type { Command } from '../../level0/vdom/command/index.ts'
+import { createTrie, trieRegister, trieMatch, splitPath, type TrieNode } from '../../level0/router/trie.ts'
+import { dispatchRouter, type RouterPipeline, type RouteMatch } from '../../level0/router/pipeline.ts'
+import { parseRequestTarget } from '../../level0/router/context.ts'
+
+/** 页面 handler——返回原生 Response（body = 命令流字节——NDJSON）——
+ *  与后端 Handler 签名字面同构：(req, ctx) => Response——req 为**标准
+ *  Request**（零扩展——params/query 经 ctx 注入） */
+export type PageHandler = (req: Request, ctx: UIContext) => Response | Promise<Response>
+
+/** 渲染入口封装：命令流 → 原生 Response（body = NDJSON 字节流——
+ *  HTTP 传输层即字节——命令纯数据可序列化——服务端同源解析） */
+export function commandResponse(stream: ReadableStream<Command>, init?: ResponseInit): Response {
+  const enc = new TextEncoder()
+  const body = stream.pipeThrough(new TransformStream<Command, Uint8Array>({
+    transform(cmd, controller) {
+      controller.enqueue(enc.encode(JSON.stringify(cmd) + '\n'))
+    },
+  }))
+  return new Response(body, { status: init?.status ?? 200, headers: init?.headers })
+}
+
+/** 构造前端请求（纯标准 Request——零扩展——URL 基于 http://localhost） */
+export function frontRequest(path: string): Request {
+  return new Request(new URL(path, 'http://localhost'))
+}
+
+export class UIRouter {
+  private root: TrieNode<PageHandler> = createTrie<PageHandler>()
+  private notFoundHandler: PageHandler | null = null
+
+  /** 注册路由（shared Trie——静态/:param/*——params 注入 req） */
+  get(path: string, handler: PageHandler): this {
+    trieRegister(this.root, path, handler)
+    return this
+  }
+
+  /** 路由存在性（onDocClick 决策：无匹配 → 不拦截——默认完整导航——
+   *  实证：stats 页「← 填写页」链接被拦截但 navigate 落空——半跳转） */
+  has(path: string): boolean {
+    // **非法编码防御（B1）**：onDocClick 的 href 可能含 %zz——URIError
+    // 裸抛会崩导航——视为无匹配（默认完整导航——安全回退）
+    try {
+      const url = new URL(path, 'http://x')
+      for (const seg of url.pathname.split('/').filter(Boolean)) decodeURIComponent(seg)
+      return trieMatch(this.root, splitPath(url.pathname)) !== null
+    } catch {
+      return false
+    }
+  }
+
+  /** 404 兜底 */
+  notFound(handler: PageHandler): this {
+    this.notFoundHandler = handler
+    return this
+  }
+
+  /** 解析请求 → 响应（Trie 匹配 + **params/query 注入 ctx**——对齐后端
+   *  `ctx = { params, query }`——`Object.fromEntries(searchParams)`——
+   *  不修改原始 Request） */
+  private _pipeline?: RouterPipeline<PageHandler, UIContext>
+
+  private get pipeline(): RouterPipeline<PageHandler, UIContext> {
+    return (this._pipeline ??= {
+      // **verb 差异点**（client 单 method——handler 直调闭包）
+      resolveHandler: (m: RouteMatch<PageHandler>, req, ctx) => ({
+        kind: 'route' as const,
+        run: () => m.value(req, ctx),
+      }),
+      // 404 兜底（notFound ?? null body——原语义精确保留）
+      onNotFound: (req, ctx) => {
+        if (!this.notFoundHandler) return new Response(null, { status: 404 })
+        return this.notFoundHandler(req, ctx)
+      },
+      // **ctx 扩展**（机制一致能力不同——client 三面注入：params fresh/
+      // query/route——route 是应用消费面单点：AppLayout 活性/AgentDetail
+      // params/navigate——2026-08 实证面）
+      enrichCtx: (ctx, m, pathname, query) => {
+        ctx.params = m ? { ...m.params } : {} // fresh——不残留旧路由键
+        ctx.query = query
+        ctx.route = { path: pathname, params: ctx.params, query }
+      },
+    })
+  }
+
+  /** 解析请求 → 响应（**shared pipeline 内核**——parse→match→ctx 注入→
+   *  执行→404 兜底骨架单源——非法编码 → 400（B1——对齐 server 语义）） */
+  async resolve(req: Request, ctx: UIContext): Promise<Response> {
+    return dispatchRouter<PageHandler, UIContext>(this.root, this.pipeline, req, ctx)
+  }
+}

package/dist/level3/vdom/ssr/absorb.d.ts

@@ -0,0 +1,80 @@
+/**
+ * vdom core/ssr — absorb（SSR 结构吸收状态机）
+ *
+ * 首帧结构对齐：SSR 输出静态 HTML → 客户端 uiServe 接管——create 命令
+ * 按 DFS 序消费 SSR 节点（类型匹配复用——焦点/状态保持——零重建）。
+ *
+ * 职责边界（中转——命令分发细节在 processors——本文件只持有状态 +
+ * 匹配判定）：
+ * - begin（DFS 序快照——不消费 root 自身）
+ * - next（匹配消费——元素按 tag 匹配 / 文本 / 注释锚——不匹配跳过）
+ * - end（done.full 收尾——剩余节点 = SSR 输出多于命令 → mismatch）
+ * - failed（serve 检测回退清空重建——原子性）
+ *
+ * 确定性前提（诚实裁剪）：SSR 与客户端首帧必须同构（同路由同组件——
+ * 渲染期非确定（Date/Math.random）→ mismatch → 回退重建——dev 检测）。
+ */
+/** 吸收状态机（**状态机化——非法调用顺序显式 Reject**）：
+ *  inactive → begin → consuming →（end/next 耗尽）→ inactive/failed
+ *  - begin：inactive → consuming（DFS 序快照）
+ *  - next：consuming → consuming（消费）/ failed（队列耗尽）
+ *  - end：consuming → inactive（无剩余）/ failed（剩余 = mismatch）
+ *  - reset：任意 → inactive（回退重建）
+ *  违例（静默路径歼灭——审计 2026-XX）：next/end 在 inactive 调用 →
+ *  显式 console.error（不再静默返回 null——非法顺序是 bug）
+ */
+import type { WfNode } from '../patch/processors.ts';
+import { type Observable } from '../../../level1/vdom/observable/index.ts';
+/** 吸收阶段（状态机枚举） */
+export type AbsorbPhase = 'inactive' | 'consuming' | 'failed';
+/** 吸收迁移事件（**流化（2027-09）——事件序列 = 时间线——可回放**） */
+export type AbsorbEvent = {
+    kind: 'begin';
+} | {
+    kind: 'next';
+    matched: boolean;
+} | {
+    kind: 'end';
+    remaining: number;
+} | {
+    kind: 'reset';
+};
+/** 吸收迁移表（**纯 reducer——状态机维度总表语义不变——波次 4 流化**）：
+ *  - begin：任意 → consuming（无条件——幂等——现状）
+ *  - next matched：consuming → consuming（消耗）；matched=false = 耗尽——failed
+ *  - end：consuming → remaining>0 ? failed : inactive（mismatch 判定）
+ *  - reset：任意 → inactive（回退重建）
+ *  违例语义（保持现状——不抛——消费端防御）：next/end 于非 consuming =
+ *  无迁移（合法 no-op——procDone 无条件调用 end——未 begin 不报错）——
+ *  next 违例的方法层保留 console.error（audit 可见——2026 审计语义） */
+export declare function absorbReducer(s: AbsorbPhase, e: AbsorbEvent): AbsorbPhase;
+/** 吸收状态（CommandApplier 持有——apply 层消费） */
+export declare class AbsorbState {
+    /** DFS 序快照（root 后代——create 按序消费） */
+    queue: Node[] | null;
+    /** 状态机阶段（**单源 = events$ 的 scan 折叠写回**——2027-09） */
+    phase: AbsorbPhase;
+    /** 迁移事件流（begin/next/end/reset 全序列——**时间线可回放**） */
+    readonly events$: Observable<AbsorbEvent>;
+    /** **吸收失败事件**（next 耗尽 / end 剩余——serve 回退闭环订阅点） */
+    readonly failed$: Observable<void>;
+    private readonly events;
+    constructor();
+    /** 启动吸收（root 有 SSR 内容——DFS 序快照——不消费 root 自身） */
+    begin(container: HTMLElement): void;
+    /** 吸收结束（done.full）——剩余节点 = SSR 输出多于命令——mismatch
+     *  **inactive 时 = 合法 no-op**（procDone 无条件调用——非 SSR 客户端
+     *  渲染未 begin——end 无意义——不报错——reducer 无迁移）；consuming 时 =
+     *  正常收尾（remaining=0 → inactive / >0 → failed 事件） */
+    end(): void;
+    /** 重置（回退重建后——恢复非吸收态） */
+    reset(): void;
+    /** 吸收消费（create 族——匹配下一个 SSR 节点——类型不符/耗尽 → 失败）
+     *  **文本分裂（2026-08——SSR 相邻文本合流实战）**：HTML 序列化会把
+     *  相邻 createText 合并成一个 DOM 文本节点（如 ` › ` + `InputNumber`
+     *  → `" › InputNumber"`）——但客户端命令流是两条 createText——按整节点
+     *  消费会吞掉后缀（后续 next 找不到文本 → 耗尽 failed）→ 前缀匹配 +
+     *  splitText 分裂：剩余部分 unshift 回队列头部——命令流 1:1 对齐
+     *  （procCreateText 传目标 value——prefix 判定） */
+    next(kind: 'element' | 'text' | 'comment', tag?: string, value?: string): WfNode | null;
+}