weifuwu 0.79.0 → 0.80.0

package/docs/frontend.md

@@ -233,7 +233,7 @@ const Counter: Component = async (_init, ctx) => {
 }
 ```
 
-**render-only 唯一规则**：渲染只发生在 `render()` 调用处（design/render-only-plan.md）——
+**render-only 唯一规则**：渲染只发生在 `render()` 调用处——
 状态是普通对象（`let` / `createStore`），**没有 `$` Proxy、没有赋值自动渲染**。改状态后必须显式 `ctx.ui.render()`。
 
 ### `createStore` + `ctx.ui.useExternal()` — 跨组件共享状态
@@ -448,7 +448,7 @@ ctx.ui.render(['stats'])
 
 #### `ctx.ui.useChat(options)` — AI 对话会话（AiChat 配套）
 
-会话语义的流式 AI 状态容器：消息累积 / 工具调用内嵌 / HITL 审批 / stop / retry，协议对页面完全透明（wf: 协议见 `design/ai-contract.md`）。返回 handle 带 `subscribe(cb)`——子组件用 `ctx.ui.useExternal(chat)` 订阅会话变化（render-only 共享状态原语）：
+会话语义的流式 AI 状态容器：消息累积 / 工具调用内嵌 / HITL 审批 / stop / retry，协议对页面完全透明（wf: 协议见 `docs/ai-contract.md`）。返回 handle 带 `subscribe(cb)`——子组件用 `ctx.ui.useExternal(chat)` 订阅会话变化（render-only 共享状态原语）：
 
 ```tsx
 // mount 阶段（服务端 `ai()` 中间件 + `AiChat` 组件配套）

package/docs/layout.md

@@ -4,7 +4,7 @@
 
 纯 CSS 58 个布局原语 + 136 个工具类 + 167 个主题 Token。不绑定任何 JS 框架。
 
-> **学习路径与命名规范**：见 [`design/style-guide.md`](../design/style-guide.md)——统一语法 `wf-<域>-<名>`、三档学习（组件 → 10 核心原语 → 完整速查）、场景速查、变量定制。
+> **学习路径与命名规范**：见 [`docs/style-guide.md`](style-guide.md)——统一语法 `wf-<域>-<名>`、三档学习（组件 → 10 核心原语 → 完整速查）、场景速查、变量定制。
 
 > **全栈 weifuwu 项目**：`weifuwu/components/style.css` 已包含布局系统，一条 import 就够了，无需单独引用本页。
 > 本页仅适用于**非 weifuwu 项目**或**只需 CSS 布局**的场景。

package/docs/mobile.md

@@ -1,7 +1,7 @@
 # 移动端开发指南（weifuwu）
 
 > 移动端友好由框架构造保证：**用对原语 + 守 audit 规则**，不靠每个组件"记得"。
-> 落地依据：`design/mobile-support-plan.md`（P0/P1 已完成，P2 进行中）。
+> 落地依据：移动端支持计划（P0-P3 全落地——usePopup 全系 + safe-area + 44px 命中区 + docs/mobile 指南）。
 
 ## 一、断点体系（布局原语）
 

package/docs/saas.md

@@ -147,7 +147,7 @@ import { ai } from 'weifuwu'
 const a = ai()          // DEEPSEEK_API_KEY / BASE_URL / MODEL 自动读 env，默认 deepseek-v4-flash
 app.use(a)              // 注入 ctx.ai（worker/非请求场景也可直接 a.chat()）
 
-// 流式对话：路由一行返回 SSE（wf: 协议，详见 design/ai-contract.md）
+// 流式对话：路由一行返回 SSE（wf: 协议，详见 docs/ai-contract.md）
 app.post('/api/chat', async (req, ctx) => {
   const { messages } = await req.json()
   return ctx.ai.stream({ messages }, {
@@ -217,7 +217,7 @@ return () => <AiChat chat={$} />
 
 > 分层：`ctx.ai`（后端协议）→ `aiStream`（传输解码）→ `useChat`（会话语义）→ `AiChat`（标准界面）。要完全自定义 UI 的应用用 useChat + 自有渲染；要 5 分钟出界面用 AiChat。
 
-- **协议**：`wf:` 命名空间（message_start/token/tool_call/tool_progress/usage/done/error + agent 扩展 step/approval_request），SSE 下行 + POST 上行，错误即值、未知事件透传、`x:*` 自定义事件（详见 [design/ai-contract.md](../design/ai-contract.md)）
+- **协议**：`wf:` 命名空间（message_start/token/tool_call/tool_progress/usage/done/error + agent 扩展 step/approval_request），SSE 下行 + POST 上行，错误即值、未知事件透传、`x:*` 自定义事件（详见 [docs/ai-contract.md](ai-contract.md)）
 - **agent 引擎**：`a.agent({ systemPrompt, tools, humanInTheLoop })` 工具循环（LLM → tool_call → 执行 → 回喂 → 重复）；工具可 `emit` 进度/自定义事件、接收 `signal` 取消；HITL 审批（`ctx.ai.approve` 响应，拒绝≠终止、modified 改参、超时兜底）
 - **emitter 抽象**：`agent.stream(messages, { emit })`——`wf:*` 事件（step/token/tool_result/usage/done）可接任意通道（SSE/WS/回调），协议不焊死在传输层；`agent.runToResult(messages)` 返回结构化结果 `{ content, steps, usage }`（非流式/worker 场景）
 - **embedding**：`ctx.ai.embed(text)` / `embedMany(texts)` 向量化（默认 `DASHSCOPE_API_KEY` + `text-embedding-v4`，compatible-mode 端点）；未配置抛 `AiError('unsupported')`（惰性检查，不静默降级）——知识库/语义检索开箱即用

package/docs/style-guide.md

@@ -0,0 +1,182 @@
+# weifuwu/style 使用指南（wf-* 命名规范 + 三档学习路径）
+
+> 一个 CSS 文件（`weifuwu/components/style.css`）= Token + 布局原语 + 工具类 + 组件样式。
+> 本文档是**学习路径**与**命名规范**——看完第二档即可上手 90% 页面。
+
+## 统一语法：`wf-<域>-<名字>`
+
+所有类遵循一个规则：`wf-` + **域** + 名字。
+
+| 域 | 例子 | 说明 |
+|---|---|---|
+| `layout`（布局原语） | `wf-layout-stack` `wf-layout-split` `wf-layout-grid` | 元素之间的空间关系 |
+| `p/m/gap/w/h`（间距尺寸） | `wf-p-md` `wf-mt-lg` `wf-gap-sm` `wf-w-full` | padding/margin/gap/width/height |
+| `border/rounded`（边框圆角） | `wf-border-b` `wf-rounded-md` `wf-pill` | |
+| `bg/text/weight/leading/align/tracking`（视觉） | `wf-bg-primary` `wf-text-secondary` `wf-weight-semibold` `wf-leading-base` | |
+| `btn/card/modal/…`（组件域） | `wf-btn--primary` `wf-card--hover` | 组件由 props 渲染，一般不需手写 |
+
+**修饰符号**：
+```
+wf-card--active    -- = 变体/状态（选中/激活/hover）
+wf-modal-header    -  = 子元素（组件内部结构，不手写）
+wf-layout-stack@md @  = 断点变体（≥768px 时横向）
+```
+
+**值类（裸词）**：单值工具没有属性域——`wf-uppercase` `wf-truncate` `wf-pre-wrap` `wf-dim` `wf-pill`。
+
+## 三档学习路径
+
+### 第一档：只用组件（0 成本）
+
+48 个组件覆盖页面功能块，完全不需要 wf-*：
+
+```tsx
+<PageHeader title="订单"><Button variant="primary">+ 新建</Button></PageHeader>
+<Table data={orders} columns={cols} />
+<Card hover><StatCard value="1,234" label="总用户" /></Card>
+```
+
+### 第二档：10 个核心原语（半小时，覆盖 90% 页面）
+
+```
+wf-layout-stack   垂直堆叠 + gap
+wf-layout-row     水平排列 + wrap
+wf-layout-split   两端分布
+wf-layout-fill    flex: 1 撑满
+wf-gap-md         设置间距（配合上面）
+wf-p-md           内边距
+wf-text-secondary 次级文字
+wf-bg-primary     品牌浅底
+wf-border-b       下边框
+wf-rounded-md     圆角
+```
+
+```tsx
+<div class="wf-layout-split">
+  <div class="wf-layout-row wf-gap-md">
+    <Card>…</Card>
+  </div>
+  <Button variant="primary">提交</Button>
+</div>
+```
+
+### 第三档：完整速查（按需查 IDE 补全）
+
+输入 `wf-layout-` / `wf-text-` / `wf-bg-` 弹出全部候选。完整清单见 README「布局系统」。
+
+## 场景速查（"我要做什么"）
+
+| 需求 | 写法 |
+|---|---|
+| 两个元素两端分布 | `wf-layout-split` |
+| 一列堆叠带间距 | `wf-layout-stack wf-gap-md` |
+| 一行换行居中对齐 | `wf-layout-row wf-gap-md wf-layout-cluster` |
+| 卡片网格 | `<div class="wf-layout-grid">` |
+| 状态色文字/背景 | `wf-text-success` / `wf-bg-error` |
+| 卡片 hover 抬升 | `<Card hover>` 或 `wf-elevate` |
+| 聊天气泡 | `wf-bubble` / `wf-bubble--own` |
+| 文章正文排版 | `<article class="wf-prose">` |
+| 隐藏元素（桌面显示/移动隐藏） | `wf-layout-hidden@sm` |
+| 按钮变胶囊 | `:root { --wf-btn-radius: 999px }` |
+| 数字防抖（统计/表格数值） | `wf-nums`（StatCard 已默认套用） |
+| 顶级页面大标题 | `<PageHeader display>` 或 `wf-text-display` |
+| 状态/计数徽章 | `<Badge variant>`（不可交互，含 dot） |
+| 可关闭标签 | `<Tag closable>`（可交互，有关闭钮） |
+| 图标 | `<Icon name="close" />`（禁止裸 emoji/字形） |
+
+## 定制（零 CSS 文件）
+
+### 品牌换色 — 改原始层一个值，全站跟随
+
+```html
+<style>
+  :root { --wf-brand-500: #7c3aed; }        /* 亮色品牌 */
+  :root { --wf-dark-brand-500: #a78bfa; }   /* 暗色品牌（可选） */
+</style>
+```
+
+### 组件定制 — 设一个变量
+
+```html
+<style>
+  :root {
+    --wf-modal-width: 640px;
+    --wf-btn-radius: 999px;
+    --wf-field-height: 44px;
+    --wf-card-shadow: 0 8px 24px rgba(0,0,0,.12);
+  }
+</style>
+```
+
+完整钩子清单：`--wf-btn-*` `--wf-card-*` `--wf-field-*` `--wf-modal-*` `--wf-drawer-width` `--wf-toast-*` `--wf-alert-radius` `--wf-badge-radius` `--wf-tag-radius` `--wf-switch-radius` `--wf-popover-*` `--wf-tooltip-radius` `--wf-dropdown-min-width` `--wf-datepicker-*`。
+
+### 动效定制 — 时长/缓动/位移
+
+```html
+<style>
+  :root {
+    --wf-dur-base: 300ms;                     /* 默认动画时长 */
+    --wf-ease-out: cubic-bezier(0.22, 1, 0.36, 1);  /* 入场缓动 */
+    --wf-motion-lg: 32px;                     /* 抽屉全幅位移 */
+  }
+</style>
+```
+
+### 覆盖优先级（@layer）
+
+```
+@layer tokens, base, layout, utilities, components;   ← weifuwu 的层
+未分层的用户 CSS 天然最高优先级                        ← 你写的普通规则直接生效
+用户 @layer utilities 可精准盖过 weifuwu 的 utilities
+```
+
+## 主题 Token（141 个，双层）
+
+- **原始层**（`--wf-brand-*` `--wf-slate-*` `--wf-dark-*`）：色值只定义一次，品牌/暗色调校改这里
+- **语义层**（`--wf-color-*` `--wf-space-*` `--wf-radius-*` …）：组件消费，主题切换覆盖这里
+- 暗色模式：`--wf-dark-*` 间接层映射，两段激活（`data-theme` / 系统偏好），无硬编码
+
+### 动效 Token（P8 新增，全站动效统一引用）
+
+| Token | 默认 | 用途 |
+|---|---|---|
+| `--wf-dur-fast/base/slow` | 120/200/300ms | 动画时长阶梯 |
+| `--wf-ease-out` | `cubic-bezier(0.16,1,0.3,1)` | 入场（快出缓停） |
+| `--wf-ease-in` | `cubic-bezier(0.4,0,1,1)` | 退场（渐入加速） |
+| `--wf-ease-snap` | `cubic-bezier(0.34,1.56,0.64,1)` | 选中/弹跳（Segmented 等） |
+| `--wf-motion-sm/md/lg` | 4/8/24px | 位移量（toast 退场/抽屉） |
+
+### 语义文字色（P2 新增，浅底可读）
+
+`--wf-color-{primary,success,warning,error,info}-text`（700 级，对 50 级底对比度 ≥ 4.5:1）——**文字用 `-text` 变体，500 级只做填充/边框/焦点**。实心填充上的文字用 `--wf-color-on-brand`；遮罩用 `--wf-overlay`。
+
+### CJK / 数字（P5 新增）
+
+- `--wf-heading-case: none`（默认）——表头/分组标题文本变换，英文项目可覆盖 `uppercase`
+- `--wf-nums`——`wf-nums` 工具类的取值（tabular-nums，数字防宽度抖动）
+
+## 图标（Icon 组件）
+
+组件库内置 `Icon`（stroke SVG、`currentColor`、`1em` 随字号、`aria-hidden`），组件内部图标统一用它——**禁止裸文本字形**（✕✓⚠▲▼ 等）：
+
+```tsx
+h(Icon, { name: 'close' })          // 随上下文颜色/字号
+h(Icon, { name: 'check', size: 16 })
+```
+
+内置 25 个：方向（chevron/arrow/sort）、状态（check/close/alert/info/warning）、操作（search/send/stop/retry/upload/trash/edit/plus）等。业务图标自备（`Icon` 只做基础集）。
+
+## 浮层退场语义（P0/P4 变更，注意时序）
+
+Modal/Drawer/Confirm/Toast 关闭时**先播退场动画再卸载**：
+
+- `open=false` 后 DOM 仍存在约 200ms（播 `--exit` 动画）——时序敏感代码（测量/立即重开）需知悉
+- `prefers-reduced-motion: reduce` 下动画降为 0.01ms，等效立即卸载
+- Confirm 默认 `maskClosable=false`（遮罩点击不取消，防误触）；Escape 仍可关闭
+
+## 边界（诚实说明）
+
+- 业务具体尺寸（`width: 220px`、`min-height: 120px`）用内联——设计系统不背业务值
+- 深度定制组件结构用覆盖 CSS（@layer 友好支持）
+- 低频 CSS（float/filter）不做类——用内联或组件
+- 动效已统一由 Token 驱动：新增动画禁止硬编码时长/缓动（audit 把关）

package/package.json

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

package/dist/ui-dom/vdom/diff.d.ts

@@ -1,29 +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 { VNodeChild } from '../vnode.ts';
-import { arrayChildren } from '../vnode.ts';
-export { arrayChildren };
-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;
-/** 属性 patch（只设不删语义保持简单；差异删除由 diff 上层处理） */
-export declare function patchProps(el: Element, oldProps: Record<string, any>, newProps: Record<string, any>): void;
-export declare function patchChildren(parent: Node, oldInput: VNodeChild | null | undefined, newInput: VNodeChild | null | undefined, ctx: PatchCtx, oldRange?: Node[], oldAnchors?: (Node | null)[], anchorOut?: (Node | null)[]): (Node | null)[];

package/dist/ui-dom/vdom/hydration.d.ts

@@ -1,17 +0,0 @@
-/**
- * vdom/hydration — 游标收养（SSR HTML → 客户端，不重建 DOM）
- *
- * 与第 1 代 hydration 的区别：**先 buildVNode 预构建**（await 工厂——组件已 resolve、
- * _child 已展开）→ 再游标收养（只接线属性/事件/ref——不重跑 renderFn/工厂）。
- *
- * 游标不变量：元素/文本 VNode 恰好消耗一个游标节点；组件/Fragment/数组透明；
- * null 消耗零；创建时 insertBefore(游标) 且游标不动；收养/替换时游标前进。
- */
-import type { VNode } from '../vnode.ts';
-import type { WfuiContext } from '../types.ts';
-import { mountAsyncComponent } from './build.ts';
-/** Hydration 入口：buildVNode 预构建（await 工厂）→ 游标收养 */
-export declare function hydrateVNode(container: Element, vnode: VNode, ctx: WfuiContext): Promise<void>;
-/** 给组件 vnode 分配 id（hydration 需要——注册表定位） */
-export declare function ensureHydrationId(vnode: VNode, ctx: WfuiContext): void;
-export { mountAsyncComponent };

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

@@ -1,23 +0,0 @@
-/**
- * vdom — 全新虚拟 DOM 引擎（第 2 代）
- *
- * 设计初衷（修复第 1 代死循环/动态挂载问题）：
- * - 组件 vnode 进入 diff 前**必须已构建**（`_render` 已设）——diff 永不调用组件工厂
- * - 构建（buildVNode）是 async 的，统一在渲染入口完成（首帧 / renderByIds / 导航）
- * - 动态挂载组件在 buildVNode 阶段被 await（构建完成）→ diff 同步渲染——
- *   无占位、无注释、无「resolve 回调触发补全」（第 1 代死循环根因）
- * - 工厂只跑一次（vnode 级缓存 + 旧树同位置同类型复用）——无无限挂载
- *
- * 两阶段异步组件（唯一签名）：
- *   async (initProps, ctx) => Promise<(props) => VNode | null>
- */
-export { buildVNode } from './build.ts';
-export { renderValue } from './render.ts';
-export { patchValue } from './diff.ts';
-export { createRenderer, type Renderer } from './mount.ts';
-export { createRegistry, type Registry } from './registry.ts';
-export { createStore, type ExternalStore } from '../store.ts';
-export { mountRoot, createVdomContext, mountCommand, unmountCommand, createCommandContainer } from './mount.ts';
-export { hydrateVNode } from './hydration.ts';
-export { renderSsr, ssrPage, ssrToString, serializeData, createSsrContext } from './ssr.ts';
-export { uiServe, type UIServeOptions, type UIServeHandle } from './serve.ts';

package/dist/ui-dom/vdom/mount.d.ts

@@ -1,58 +0,0 @@
-/**
- * vdom/mount — 挂载入口（首帧 + ctx/ui 组装）
- *
- * 渲染管线：buildVNode（async 预构建）→ renderValue（同步落地）。
- * ctx.ui：render/setMounting/endMounting——render-only（design/render-only-plan.md）。
- */
-import type { VNode, VNodeChild, Component } from '../vnode.ts';
-import type { WfuiContext } from '../types.ts';
-import type { BrowserEnv } from '../types.ts';
-import { type Registry } from './registry.ts';
-export interface MountOptions {
-    browser: BrowserEnv;
-    root: HTMLElement;
-    registry?: Registry;
-    renderer?: Renderer;
-    onError?: (e: unknown) => void;
-}
-export interface MountHandle {
-    ctx: WfuiContext;
-    registry: Registry;
-    renderer: Renderer;
-    /** 挂载根组件 */
-    mount(comp: Component | VNodeChild): Promise<void>;
-    /** 整树强制重渲染（force——测试辅助/手动刷新：renderFn 重跑 + patch） */
-    rerender(): Promise<void>;
-    /** 卸载（清理 DOM） */
-    unmount(): void;
-}
-export interface VdomContext {
-    ctx: WfuiContext;
-    registry: Registry;
-    renderer: Renderer;
-    rootUi: any;
-    destroyPopupListeners: () => void;
-}
-export interface Renderer {
-    render(ids?: string[]): Promise<void>;
-}
-export interface RendererOptions {
-    registry: Registry;
-    ctx: WfuiContext;
-    rootEl?: HTMLElement;
-    onError?: (e: unknown) => void;
-}
-export declare function createRenderer(opts: RendererOptions): Renderer;
-/** 组装 vdom 渲染上下文（ctx/registry/renderer/rootUi——含完整 hooks 转发） */
-export declare function createVdomContext(opts: MountOptions): VdomContext;
-export declare function mountRoot(opts: MountOptions): MountHandle;
-/** vdom 命令式挂载：buildVNode（await 工厂）→ renderValue → append + _parentNode */
-export declare function mountCommand(container: HTMLElement, vnode: VNode, ctx: WfuiContext, opts?: {
-    onMounted?: () => void;
-}): {
-    id: string;
-};
-/** vdom 命令式卸载：ref 清理 + 卸载钩子 + 容器移除 */
-export declare function unmountCommand(container: HTMLElement, vnode: VNode | null, ctx: WfuiContext): void;
-/** 创建命令式挂载容器（body 下独立 div） */
-export declare function createCommandContainer(): HTMLDivElement | null;

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

@@ -1,17 +0,0 @@
-/**
- * vdom/render — DOM 落地（阶段 2 同步）
- *
- * **只处理已构建的组件**（`_render` 已设——buildVNode 已 await 工厂）。
- * 遇未构建组件 → 抛错（开发期暴露 bug；生产路径 renderByIds 先 build 后 patch，
- * 不会出现未构建组件）。
- */
-import type { VNodeChild } from '../vnode.ts';
-import type { BrowserEnv } from '../types.ts';
-export { EVENT_RE, eventTarget, ENUMERATED_VALUE_BASED, holeDetail, holeMarkup } from './transform.ts';
-export declare const SVG_TAGS: Set<string>;
-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 declare function renderValue(v: VNodeChild, ctx: any, browser?: BrowserEnv, key?: string | null, id?: string | null, fid?: string | null): Node | null;

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

@@ -1,44 +0,0 @@
-/**
- * vdom/ssr — 服务端渲染（无 DOM，纯字符串）
- *
- * SSR 与引擎无关（vnode → HTML 字符串）——vdom 独立实现：
- * - renderSsr：await 工厂 → renderFn → 递归（组件签名两阶段 async）
- * - createSsrContext：SSR ctx shim（hooks no-op、$ 普通对象、ctx.data 预取）
- * - ssrPage：router.execute → renderSsr → 完整 HTML（__DATA__ 种子）
- *
- * 渲染期非确定性（Date/Math.random/locale）导致 SSR/hydration mismatch——
- * dev 检测，文档红线（AGENTS.md §3.5 诚实裁剪）。
- */
-import type { VNodeChild, Component } from '../vnode.ts';
-import type { WfuiContext } from '../types.ts';
-import type { UIRouter } from '../router.ts';
-/** HTML 转义（文本/属性值） */
-export declare function escape(s: string): string;
-/** 渲染 vnode → HTML 字符串（服务端） */
-export declare function renderSsr(input: VNodeChild, ctx: WfuiContext): Promise<string>;
-/** 创建 SSR ctx（serverCtx 注入 + dataStore 预取 + hooks shim） */
-export declare function createSsrContext(serverCtx: any, dataStore: Map<string, unknown>): WfuiContext;
-/** 序列化数据存储 → window.__DATA__ 脚本（防 XSS：转义 <） */
-export declare function serializeData(data: Map<string, unknown>): string;
-export interface SsrPageResult {
-    html: string;
-    /** __DATA__ 脚本（hydration 种子） */
-    dataScript: string;
-    /** 完整 HTML（含 dataScript） */
-    page: string;
-}
-/**
- * SSR 渲染路由页面 → 完整 HTML（Node 无 DOM）。
- * 客户端 uiServe(router, { root, hydrate: true }) 收养。
- */
-export declare function ssrPage(router: UIRouter, opts: {
-    url: string;
-    title?: string;
-    lang?: string;
-    rootId?: string;
-    styles?: string[];
-}): Promise<SsrPageResult>;
-/** SSR 渲染组件 → HTML 片段 */
-export declare function ssrToString(Comp: Component, props: Record<string, any>, serverCtx: any, opts?: {
-    data?: Map<string, unknown>;
-}): Promise<string>;