weifuwu 0.70.0 → 0.72.0

package/dist/{client → ui-dom}/ui.d.ts

@@ -18,17 +18,23 @@ export interface UiInternal {
     bumpCtxVersion(): void;
     /** 异步批处理调度标记（dirty 微任务防重入） */
     _dirtyScheduled?: boolean;
+    /** 渲染期调 render() 的推迟标记（防重入——见 ui.ts render 实现） */
+    _pendingRender?: boolean;
+    /** 渲染期调 dirty() 的推迟标记（防重入——见 ui.ts dirty 实现） */
+    _pendingDirty?: boolean;
     /** ctx.ui.$() 的 WeakMap 缓存（每组件一个 $ 容器） */
     _$cache?: Record<string, any>;
     /** mount 阶段标记（内部——mountComponent 包裹） */
     setMounting: (v: boolean) => void;
     endMounting: () => void;
+    /** ErrorBoundary 注入的错误处理器（子组件 render 抛错时调用） */
+    _errorHandler?: (err: unknown) => void;
 }
 /** createUi 依赖（由 createApp 注入 app 级闭包状态） */
 export interface UiDeps {
     ctx: WfuiContext;
     renderByIds: (ids: string[]) => void;
-    getSelfId: (ui: any) => string | undefined;
+    getSelfId: (ui: WfuiContext['ui'] | undefined) => string | undefined;
     dirtyBatch: Set<string>;
     dirtySet: Set<string>;
     mediaRegistry: Map<string, {
@@ -66,5 +72,7 @@ export interface UiDeps {
     /** mount 阶段标记置位/恢复（mountComponent 包裹） */
     setMounting: (v: boolean) => void;
     endMounting: () => void;
+    /** 注册表实例（serve 注入局部；缺省 ctx.__registry） */
+    registry?: import('./registry.ts').Registry;
 }
 export declare function createUi(deps: UiDeps): WfuiContext['ui'] & UiInternal;

package/dist/{client → ui-dom}/vnode.d.ts

@@ -8,19 +8,24 @@
  */
 import type { WfuiContext } from './types.ts';
 export type VNodeType = string | Component<any, any> | AsyncComponent | typeof Fragment | typeof Portal;
+/**
+ * VNode 子节点合法值——组件可返回/渲染的多态内容。
+ * 递归联合：string/number/VNode/array/null/boolean 任意组合。
+ */
+export type VNodeChild = VNode | string | number | boolean | null | undefined | VNodeChild[];
 export interface VNode {
     type: VNodeType;
     props: Record<string, any>;
     key?: string;
     el?: Node;
     /** 子 VNode 缓存（用于 patchValue diff，避免重复执行组件） */
-    _child?: any;
+    _child?: VNode | VNode[] | null;
     /** 远程 DOM 容器（Portal 等 remote VNode 的 DOM 所在处） */
     _remoteEl?: HTMLElement | undefined;
     /** VNode 的 DOM 归属：'local' 在父 DOM 树下，'remote' 在别处 */
     _placement?: 'local' | 'remote';
     /** 两阶段组件的 render 函数（mount 返回的函数） */
-    _render?: (props: any) => VNode | null;
+    _render?: (props: Record<string, unknown>) => VNode | null;
     /** 组件实例 ID（如 '_wf_0'） */
     _id?: string;
     /** 自定义组件 ID（ctx.ui.selfId() 注册，跨组件精准刷新） */
@@ -29,6 +34,8 @@ export interface VNode {
     _parentNode?: Node;
     /** 组件输出的第一个 DOM 节点 */
     _refNode?: Node | null;
+    /** Fragment 展开后的多个直属 DOM 节点范围（diff 对齐用，见 diff.ts） */
+    _childNodes?: Node[];
     /** 组件 mount/render 时的 ctx 版本号（供三态 skip 判定） */
     _ctxVersion?: number;
 }
@@ -70,26 +77,27 @@ export declare const Fragment: unique symbol;
 /** Portal — 将子 VNode 渲染到 document.body 下的独立容器 */
 export declare const Portal: unique symbol;
 /** JSX 类型声明 — 使 TypeScript 理解自定义 JSX 运行时 */
-declare global {
-    namespace JSX {
-        type Element = VNode | null;
-        type ElementType = string | Component<any>;
-        interface IntrinsicAttributes {
-            key?: string | number;
-        }
-        interface IntrinsicElements {
-            [tag: string]: any;
-        }
-    }
-}
 export declare function jsx(type: VNodeType, props: Record<string, any> | null, key?: string | null): VNode;
 export declare const jsxs: typeof jsx;
 export declare function jsxDEV(type: VNodeType, props: Record<string, any> | null, key?: string | null): VNode;
 /** `h`（hyperscript）支持 variadic children: `h('div', {class:'x'}, child1, child2)` */
-export declare function h(type: VNodeType, props: Record<string, any> | null, ...children: any[]): VNode;
+export declare function h(type: VNodeType, props: Record<string, any> | null, ...children: VNodeChild[]): VNode;
 export declare function isNative(vnode: VNode): boolean;
 export declare function isComponent(vnode: VNode): boolean;
 export declare function isFragment(vnode: VNode): boolean;
 export declare function isPortal(vnode: VNode): boolean;
 /** Portal VNode — 子节点渲染到 document.body#__wf_portal 中 */
-export declare function createPortal(children: any, portalKey?: string): VNode;
+export declare function createPortal(children: VNodeChild, portalKey?: string): VNode;
+/** JSX 类型声明 — ui-dom 是 jsxImportSource（client 壳不再声明） */
+declare global {
+    namespace JSX {
+        type Element = import('./vnode.ts').VNode | null;
+        type ElementType = string | ((props: any, ctx: any) => any) | typeof Fragment | typeof Portal;
+        interface IntrinsicElements {
+            [tag: string]: any;
+        }
+        interface IntrinsicAttributes {
+            key?: string | number;
+        }
+    }
+}

package/docs/components.md

@@ -2,14 +2,14 @@
 
 > 本页为 weifuwu 官方文档拆分页 · [返回 README](../README.md)
 
-92 个 HTML 原语组件。每个是 `(_init, ctx) => (props) => VNode`（两阶段组件，与前端框架同一模型），引用 `--wf-*` CSS 变量做主题。另含 `confirm()` / `toast()` 命令式中间件。
+109 个 HTML 原语组件。每个是 `(_init, ctx) => (props) => VNode`（两阶段组件，与前端框架同一模型），引用 `--wf-*` CSS 变量做主题。另含 `confirm()` / `toast()` 命令式中间件。
 
 > **组件速查（weifuwu 组件 ↔ antd / Element Plus / shadcn-ui 对应 + 迁移示例）**：见 [`docs/components-map.md`](components-map.md)——从其他组件库迁来的开发者按功能直接找对应组件。
 > **自定义组件开发**：见 [docs/custom-components.md](custom-components.md)——usePopup/useControlled/对话框/AI 组件/类型纪律逐步指南。
 
 ```ts
 import { Button, Input, Table, Modal, Toast } from 'weifuwu/components'
-import 'weifuwu/components/style.css'   // 包含 Token + 67 布局原语 + 组件样式，一次性引入
+import 'weifuwu/components/style.css'   // 包含 Token + 57 布局原语 + 136 工具类 + 组件样式，一次性引入
 ```
 
 ### 使用示例

package/docs/custom-components.md

@@ -1,5 +1,7 @@
 # 自定义组件开发指南
 
+
+> ⚠️ **weifuwu/client 已删除**——前端运行时唯一入口为 `weifuwu/ui-dom`，见 [frontend-ui-dom.md](frontend-ui-dom.md)。
 > 用 weifuwu/client 写自己的组件——与内置组件同权：同渲染引擎、同弹层原语、同类型安全。
 > 前置：[前端概念](frontend.md)（两阶段模型/ctx.ui）+ [组件列表](components.md)。
 

package/docs/frontend-middleware.md

@@ -1,4 +1,6 @@
-# 前端中间件与工具（weifuwu/client）
+# 前端中间件与工具（weifuwu/ui-dom）
+
+> ⚠️ **`weifuwu/client` 已删除**——中间件（api/auth/ws/i18n）现位于 `weifuwu/ui-dom`，新 API 见 [frontend-ui-dom.md](frontend-ui-dom.md)。
 
 > 本页为 weifuwu 官方文档拆分页 · [返回 README](../README.md)
 

package/docs/frontend-ui-dom.md

@@ -0,0 +1,110 @@
+# ui-dom — 前端路由（UIRouter + uiServe，试验性）
+
+> **试验性**：`src/ui-dom/` 是定稿架构（`design/ui-architecture.md`）的落地——
+> **UIRouter（纯路由）+ uiServe（渲染运行时）**，复用 `weifuwu/components`
+> （VNode 契约共享，组件零修改）。渲染算法复制自 client（局部 registry 隔离，
+> 不与 createApp 交叉）。当前未随 npm 包发布，源码直用。
+>
+> 概念对齐：**req = window.location**，**res = VNode**（数据结构），
+> **uiServe = VDOM**（落地机制），**params/query 在 ctx**（对齐后端 `ctx.params`）。
+
+## 快速开始
+
+```tsx
+import { UIRouter, uiServe, h } from './src/ui-dom/index.ts'
+import { toast } from './src/ui-dom/Toast.ts'
+import { Button } from './src/components/index.ts'
+
+const app = new UIRouter()
+
+app.use(toast()) // ctx 注入链（对齐后端 app.use——注入 ctx.toast）
+
+// handler = 异步组件：async (location, ctx) => VNode（$ 有效）
+app.get('/', async (location, ctx) => {
+  const info = await ctx.data.get('/api/info', async () => ({ title: '首页' }))
+  const $ = ctx.ui.$()
+  $.clicks = $.clicks ?? 0
+  return h('div', {},
+    h('h2', {}, info.title),
+    h(Button, { onClick: () => $.clicks++ }, `点击 ${$.clicks} 次`),
+    h(Button, { variant: 'secondary', onClick: () => ctx.toast?.('提示', 'success') }, '弹 toast'),
+  )
+})
+
+app.get('/users/:id', (location, ctx) => h('div', {}, `用户 ${ctx.params.id}`))
+app.notFound(() => h('div', {}, '404'))
+
+uiServe(app, { root: '#root' }) // 装配点：路由已注册 → serve 监听 URL → 渲染
+```
+
+## 核心概念
+
+### req / res / 落地分离
+
+| 概念 | 含义 |
+|------|------|
+| req | `window.location`（浏览器原生，不包装） |
+| res | `VNode`（handler 返回的数据结构） |
+| uiServe | VDOM 落地（renderValue/patchValue diff·patch DOM） |
+| ssrPage | 服务端落地（renderSsr → HTML + `__DATA__`） |
+
+handler 只产 VNode，落地由 serve 决定——SSR 与 SPA 是两种落地，同一 router 定义共享。
+
+### UIRouter 三态 use（对齐后端 app.use）
+
+| 形态 | 签名 | 用途 |
+|------|------|------|
+| ctx 注入 | `use(mw: AppMiddleware)` | `(ctx) => ctx`——注入 ctx.toast/confirm 等（类型累积 `UIRouter<C & O>`） |
+| 渲染中间件 | `use(mw: UIMiddleware)` | `(location, ctx, children) => (location, ctx) => vnode`——layout/SSR 包装 children |
+| 子路由 | `use(prefix, sub)` | 独立路由树（sub 的中间件/notFound/嵌套均生效） |
+
+运行时按 `arg.length` 区分（1 参 = ctx 注入；3 参 = 渲染）。
+
+### components 复用（零修改）
+
+VNode 契约与 client 共享（Fragment/Portal symbol 同一份）——components 产的 VNode
+直接被 ui-dom 渲染器识别。渲染算法（render/diff/createUi 19 原语）复制到 ui-dom，
+**registry/popup-tracker/dirty 集合局部实例**（不与 createApp 交叉）。
+
+命令式工厂（toast/confirm/notification）复制到 ui-dom（`src/ui-dom/Toast.ts` 等）：
+components 版 import client 的 mountVNode（模块级 registry）会注册错——ui-dom 版用局部。
+
+### $ 响应式（两层）
+
+| 层级 | 触发 | 重渲染范围 |
+|------|------|-----------|
+| 路由实例级 `$`（handler 的 `ctx.ui.$()`） | 赋值 | 重渲染 handler（data 缓存命中） |
+| 组件级 `$`（子组件 `ctx.ui.$()`） | 赋值 | **仅该组件**（父 handler 不重跑） |
+
+## SSR + hydration（端到端）
+
+```tsx
+// 服务端（Node 无 DOM）：ssrPage → 完整 HTML + __DATA__
+import { ssrPage } from './src/ui-dom/ssr.ts'
+import { app } from './router.ts' // 路由定义两端共享
+
+const { page } = await ssrPage(app, { url: '/users/42' })
+
+// 客户端：uiServe hydrate（收养服务端 HTML + __DATA__ 种子命中不重取数）
+uiServe(app, { root: '#root', hydrate: true })
+```
+
+- SSR 时 `ctx.data.get` 写入 dataStore → `__DATA__` 脚本；hydrate 从种子同步命中
+- renderSsr：组件两阶段 + asyncComponent await（数据 per-request）/ Portal 内联 / 事件剥离
+- SSR 确定性：ui 19 原语 shim 全 no-op（不启动监听/会话）；渲染期非确定性由开发者规避
+
+## ctx 注入
+
+| 字段 | 说明 |
+|------|------|
+| `ctx.params` / `ctx.query` | 路由参数 / URL query（顶层，对齐后端） |
+| `ctx.data.get/set/has` | 数据管道（缓存 + in-flight 合并 + `__DATA__` 种子） |
+| `ctx.ui.*` | 19 原语（`$`/`dirty`/`render`/`usePopup`/`useChat`/`useInView`…） |
+| `ctx.browser.*` | 环境抽象（复制自 client） |
+| `ctx.toast` / `ctx.confirm` / `ctx.notification` | 命令式注入（`app.use(toast())` 等） |
+
+## demo
+
+`apps/ui-router-demo`：UIRouter + uiServe + components（Button/Input/Tag/Dropdown）
++ toast 注入 + 嵌套路由 + SSR/hydrate 端到端。
+启动：`node apps/ui-router-demo/server.ts` → http://localhost:3100

package/docs/frontend.md

@@ -1,4 +1,6 @@
-# 前端 API 核心（weifuwu/client）
+# 前端 API 核心（weifuwu/ui-dom）
+
+> ⚠️ **`weifuwu/client` 已删除**——本页为历史文档。前端运行时唯一入口是 **`weifuwu/ui-dom`**（UIRouter 纯路由 + uiServe 渲染运行时 + SSR/hydration），权威参考见 **[docs/frontend-ui-dom.md](frontend-ui-dom.md)**。本页的 createApp/router/RouteView 用法已失效，对应新 API 为 `uiServe` / `UIRouter`。
 
 > 以下为完整 API 参考，按需查阅。新手建议先阅读 README 的「核心概念」和「快速开始」。
 

package/docs/layout.md

@@ -2,7 +2,7 @@
 
 > 本页为 weifuwu 官方文档拆分页 · [返回 README](../README.md)
 
-纯 CSS 布局原语 + 工具类 + 143 个主题 Token。不绑定任何 JS 框架。
+纯 CSS 57 个布局原语 + 136 个工具类 + 167 个主题 Token。不绑定任何 JS 框架。
 
 > **学习路径与命名规范**：见 [`design/style-guide.md`](../design/style-guide.md)——统一语法 `wf-<域>-<名>`、三档学习（组件 → 10 核心原语 → 完整速查）、场景速查、变量定制。
 
@@ -25,7 +25,7 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 
 也支持相对路径：`ctx.ui.css('./src/style.css')`。
 
-## 70 个布局原语
+## 57 个布局原语
 
 | 类别 | 原语 | 效果 |
 |------|------|------|
@@ -44,11 +44,12 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 | | `wf-bottom` | align-items: flex-end |
 | | `wf-stretch` | align-items: stretch |
 | **弹性** | `wf-fill` | flex: 1 + min-width: 0 |
-| | `wf-fixed` | flex: none |
+| | `wf-flex-none` | flex: none（`wf-fixed` 为兼容别名——易与 position:fixed 混淆，推荐新名） |
 | | `wf-auto` | flex: auto |
 | | `wf-shrink` | min-width/height: 0 |
 | **Z轴** | `wf-cover` | position: fixed + inset: 0 |
-| | `wf-pop` | position: absolute |
+| | `wf-pin` | position: fixed（角标/浮层锚点，坐标由 inline 控制——相对视口） |
+| | `wf-pop` | position: absolute（容器内角标：配合 `wf-layer`/`wf-anchor` 父级） |
 | | `wf-anchor` | position: relative |
 | | `wf-layer` | position: relative + z-index |
 | | `wf-sticky` | position: sticky |
@@ -60,17 +61,24 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 | | `wf-scroll` | overflow: auto |
 | | `wf-clip` | overflow: hidden |
 | **显隐** | `wf-hidden` `wf-hidden@sm/md/lg` | display: none |
+| | `wf-flex` `wf-flex@sm/md/lg` | display: flex（响应式显隐的 flex 容器恢复用——见「组合规则」） |
 | | `wf-block` `wf-block@sm/md/lg` | display: block |
 | | `wf-inline` | display: inline |
 | | `wf-inline-block` | display: inline-block |
 | | `wf-contents` | display: contents |
-| **间距** | `wf-p-*` / `wf-px-*` / `wf-py-*`（xs~2xl） | padding：全/水平/垂直，引用 `--wf-space-*` |
+| | `wf-dim` | opacity 0.7（运行中/历史态淡化） |
+| **间距** | `wf-p-*` / `wf-px-*` / `wf-py-*`（xs~2xl，另有 `wf-p-0`） | padding：全/水平/垂直，引用 `--wf-space-*` |
+| | `wf-m-0` | margin: 0 |
 | | `wf-mt-*` / `wf-mb-*` / `wf-my-*`（xs~2xl） | margin：top/bottom/垂直 |
-| | `wf-mx-auto` / `wf-my-auto` | margin: auto 居中 |
+| | `wf-pt-*` / `wf-pb-*`（xs~2xl） | padding：单侧顶/底（分隔条场景） |
+| | `wf-mx-auto` / `wf-my-auto` / `wf-mt-auto` / `wf-mb-auto` | margin: auto 居中 / flex 列推底 |
 | | `wf-gap-*`（xs~2xl） | 为 flex/grid 原语设置 `--wf-gap` |
 | **尺寸** | `wf-w-full` / `wf-h-full` / `wf-w-auto` | 宽/高 100%、auto |
+| | `wf-w-xs…xl` / `wf-w-max` / `wf-w-md-auto` | 固定宽阶（`--wf-space-*` 派生）/ max-content / md 起 auto |
 | **边框** | `wf-border` / `wf-border-t/b/l/r` | 1px 边框（`--wf-border-width` + `--wf-color-border`） |
-| **面工具** | `wf-bg-secondary/tertiary/brand/success/warning/error/info` | 语义背景色（`--wf-color-*-bg`） |
+| **面工具** | `wf-bg-secondary/tertiary/brand/success/warning/error/info`（`wf-bg-primary` 为 brand 别名） | 语义背景色（`--wf-color-*-bg`） |
+| | `wf-elevate` | 抬升阴影（`--wf-shadow-*`） |
+| | `wf-panel-in` | 内凹面板（次级背景 + 内边距） |
 | | `wf-pill` | 胶囊圆角（999px，状态徽章/标签/色块） |
 | | `wf-rounded-sm` `wf-rounded` `wf-rounded-md` `wf-rounded-lg` | 圆角工具（`--wf-radius-*`） |
 | **气泡** | `wf-bubble` / `wf-bubble--own` / `wf-bubble--ai` | 聊天气泡（pre-wrap + 折行内建） |
@@ -84,13 +92,33 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 | | `wf-main` | 主内容区（padding + min-width: 0） |
 | | `wf-text-*` 排版工具 | 见下文「排版工具」 |
 
+### 组合规则（冲突防线）
+
+原语分两类：**布局身份类**（display/position/flex-direction——stack/row/grid/nav/center/cover/pop…）
+与**叠加工具类**（gap/对齐/显隐——叠加在身份类上）。规则：
+
+1. **同一元素只带一个布局身份类**——两个身份类设置同一属性不同值时 import 顺序定胜负，
+   静默失效（事故例：`wf-nav wf-row` → nav 的 column 胜，横向失效；`wf-grid wf-stack` → stack 胜，网格失效）。
+   `style-audit` 静态扫描 class 组合，命中即红。
+2. **对齐工具可叠加**：`wf-top/right/bottom/stretch/between/around/evenly` 专门用于覆盖
+   `wf-row` 等的默认对齐（后导入获胜，组合合法）。`wf-nowrap` 专门关 `wf-row` 的 wrap。
+3. **`wf-center` 是 column 双轴居中**（不是 justify-center）——要“行内水平居中”用 `wf-cluster`，
+   不要 `wf-row wf-center`（center 的 column 方向会静默覆盖 row）。
+4. **响应式显隐用 `wf-flex@bp` 恢复**：`wf-hidden wf-flex@lg` = 窄隐宽显（flex 容器）。
+   不可用 `wf-block@lg`——block 会覆盖 `wf-stack` 的 display:flex，gap/mt-auto 静默失效。
+5. **容器内角标用 `wf-pop`**（父级 `wf-layer`/`wf-anchor`）；`wf-pin` 是相对视口的 fixed，
+   嵌进带壳页面会覆盖壳。
+
+完整冲突矩阵由 `node scripts/layout-inventory.mjs --json` 生成（属性指纹自动推导）。
+
 ### 排版工具（`wf-text-*`）
 
 | 工具 | 效果 |
 |------|------|
 | `wf-text-left/center/right` | text-align |
 | `wf-text-xs…5xl` | 字号（`--wf-font-size-*`） |
-| `wf-text-secondary/tertiary/disabled/brand` | 中性色阶 |
+| `wf-text-secondary/tertiary/disabled/brand`（`wf-text-primary` 为 brand 别名） | 中性色阶 |
+| `wf-nums` | tabular-nums（数值防宽度抖动） |
 | `wf-text-success/warning/error/info` | 语义色文本（`--wf-color-*`） |
 | `wf-text-medium/semibold/bold` | 字重 |
 | `wf-tracking-normal/wide/wider` | letter-spacing |
@@ -101,7 +129,7 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 | `wf-truncate` | 单行省略（ellipsis） |
 | `wf-line-clamp-2/3` | 多行截断 |
 
-## 143 个主题 Token
+## 167 个主题 Token
 
 **双层结构**：原始层（Primitive，色值只定义一次，品牌/暗色调校改这里）+ 语义层（Semantic，组件消费）。
 

package/docs/realtime.md

@@ -69,6 +69,8 @@ app.get('/page', (req, ctx) => ctx.ui.html`
 
 ```ts
 app.get('/app.js', (req, ctx) => ctx.ui.js('./src/main.tsx'))   // 相对路径
+
+> ⚠️ **weifuwu/client 已删除**——前端运行时唯一入口为 `weifuwu/ui-dom`，见 [frontend-ui-dom.md](frontend-ui-dom.md)。
 app.get('/app.js', (req, ctx) => ctx.ui.js('weifuwu/client'))   // 或包名
 ```
 

package/docs/saas.md

@@ -75,6 +75,8 @@ app.get('/me', (req, ctx) => ok(ctx.user))        // 已注入
 app.post('/secure', (req, ctx) => { ctx.auth.requireAuth(); ... })
 ```
 
+
+> ⚠️ **weifuwu/client 已删除**——前端运行时唯一入口为 `weifuwu/ui-dom`，见 [frontend-ui-dom.md](frontend-ui-dom.md)。
 - **安全基线**：scrypt 密码哈希（per-user salt + timing-safe，异步不阻塞）；access token = HMAC-SHA256 JWT（与 `weifuwu/client` 的 `auth()` 天然配对）；refresh token = 不透明随机串，DB 只存哈希，logout/轮换即撤销
 - **防枚举**：登录失败统一 401（不泄露邮箱是否存在）
 - **`ctx.auth` 方法面**：`register` / `login` / `logout` / `requireAuth` / `setPassword(userId, newPwd)` / `createToken(type, payload, { ttlSeconds })`（邮箱验证/密码重置自接）

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "weifuwu",
   "type": "module",
-  "version": "0.70.0",
+  "version": "0.72.0",
   "description": "AI SaaS framework — (req, ctx) => Response",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./client": {
-      "types": "./dist/client/index.d.ts",
-      "default": "./dist/client/index.js"
+    "./ui-dom": {
+      "types": "./dist/ui-dom/index.d.ts",
+      "default": "./dist/ui-dom/index.js"
     },
-    "./client/jsx-runtime": {
-      "types": "./dist/client/index.d.ts",
-      "default": "./dist/client/index.js"
+    "./ui-dom/jsx-runtime": {
+      "types": "./dist/ui-dom/index.d.ts",
+      "default": "./dist/ui-dom/jsx-runtime.js"
     },
     "./layout": "./dist/layout/weifuwu-layout.css",
     "./layout/style.css": "./dist/layout/weifuwu-layout.css",

package/dist/client/app.d.ts

@@ -1,26 +0,0 @@
-/**
- * weifuwu/client 应用 — createApp + ctx.ui.render
- *
- * createApp() → app.use(mw) → app.mount('#root', RootComponent)
- *
- * ctx.ui 在 mount 时注入：
- *   ctx.ui.render()        同步刷新当前组件
- *   ctx.ui.render(['#id']) 同步刷新指定组件
- *   ctx.ui.dirty()         异步刷新当前组件（微任务批处理）
- *   ctx.ui.$()             响应式状态容器（$.x = val 自动 dirty）
- *
- * render / dirty / $ 通过 prototype chain 实现组件级 scope：
- *   每个组件 mount 时创建 childCtx.ui = Object.create(ctx.ui)
- *   并设置 childCtx.ui._selfId = 组件 ID
- *   render() 无参时从 this._selfId 取当前组件 ID
- */
-import type { AppMiddleware } from './types.ts';
-import type { Component } from './vnode.ts';
-/** 应用句柄：use() 链式累积中间件注入的 ctx 类型，mount() 时组件拿到完整注入 */
-export interface App<C extends object = {}> {
-    use<I extends object, O extends object>(mw: AppMiddleware<I, O>): App<C & O>;
-    mount(rootSelector: string, root: Component<any, C>, options?: {
-        hydrate?: boolean;
-    }): Promise<void>;
-}
-export declare function createApp<C extends object = {}>(): App<C>;

package/dist/client/error-boundary.d.ts

@@ -1,23 +0,0 @@
-/**
- * ErrorBoundary — 错误边界组件
- *
- * 捕获子组件渲染时的错误，展示 fallback 替代崩溃白屏。
- *
- * ```tsx
- * <ErrorBoundary fallback={<p>出错了</p>}>
- *   <UserProfile />
- * </ErrorBoundary>
- * ```
- *
- * 基于 ctx.ui._errorHandler 机制：在渲染子组件前注入错误处理器，
- * 子组件 render 抛错时设置 error → 重新渲染 fallback。
- */
-import type { WfuiContext } from './types.ts';
-import type { VNode } from './vnode.ts';
-export interface ErrorBoundaryProps {
-    fallback?: VNode | ((props: {
-        error: unknown;
-    }) => VNode) | null;
-    children?: any;
-}
-export declare function ErrorBoundary(props: ErrorBoundaryProps, ctx: WfuiContext): (props2: ErrorBoundaryProps) => VNode | null;

package/dist/client/index.d.ts

@@ -1,54 +0,0 @@
-/**
- * weifuwu/client — VDOM 前端框架
- *
- * 概念：
- *   组件 = (props, ctx) => VNode
- *   状态 = JS 变量
- *   更新 = ctx.ui.render()
- *   挂载/卸载 = ref 回调
- *
- * 导出：
- *   h / jsx / jsxs / jsxDEV / Fragment  → JSX 工厂
- *   createApp                            → 应用引导
- *   router / RouteView                   → 路由
- *   api / auth / ws                      → 中间件
- *   extendCtx                            → ctx 扩展
- *   WfuiContext / AppMiddleware / RouteDef → 类型
- */
-export { h, jsx, jsxs, jsxDEV, Fragment, Portal, createPortal } from './vnode.ts';
-export type { VNode, VNodeType, Component, AsyncComponent } from './vnode.ts';
-export { asyncComponent, isAsyncComponent } from './vnode.ts';
-export { createApp } from './app.ts';
-export type { App } from './app.ts';
-export { router, RouteView } from './router.ts';
-export type { RouteInjected } from './router.ts';
-export { ws } from './middleware/ws.ts';
-export type { WsClient, WsInjected } from './middleware/ws.ts';
-export { api } from './middleware/api.ts';
-export { auth } from './middleware/auth.ts';
-export type { ApiClient, ApiOptions, ApiRequestOptions, ApiInjected } from './middleware/api.ts';
-export { ApiError } from './middleware/api.ts';
-export type { AuthClient, AuthOptions, AuthInjected } from './middleware/auth.ts';
-export { extendCtx } from './types.ts';
-export type { WfuiContext, AppMiddleware, RouteDef } from './types.ts';
-export { aiStream } from './ai.ts';
-export type { AiStreamCallbacks, AiStreamOptions, AiStreamHandle } from './ai.ts';
-export { toChatMessages } from './use-chat.ts';
-export type { UiMessage, UiToolCall, UseChatOptions, UseChatState, UseChatHandle, ChatApi } from './use-chat.ts';
-export type { WfStreamEvent, WfMessageStart, WfToken, WfUsage, WfDone, WfError, WfErrorCode, WfToolCall, WfToolResult, WfToolProgress, WfStep, WfApprovalRequest, WfApprovalResponse, WfApprovalDecision, ChatMessage, ChatParams, MessageRole, ToolCall, ToolDefinition, } from '../ai/types.ts';
-export { ErrorBoundary } from './error-boundary.ts';
-export type { ErrorBoundaryProps } from './error-boundary.ts';
-export { i18n } from './i18n.ts';
-export type { I18nOptions, I18nState, I18nInjected } from './i18n.ts';
-export { createReactiveState } from './reactive.ts';
-export type { ReactiveState } from './types.ts';
-export { lockScroll, unlockScroll } from './scroll-lock.ts';
-export { trapFocus } from './focus-trap.ts';
-export { mountVNode, callRefCleanup, clearAsyncComponentCache } from './render.ts';
-export { hydrateVNode } from './hydration.ts';
-export { patchValue } from './diff.ts';
-export { animateOut } from './motion.ts';
-export { computeFixedPos, computeFixedPosRect } from './popup.ts';
-export type { FixedPos, Placement } from './popup.ts';
-export { zhCN } from './locale/zh_CN.ts';
-export { enUS } from './locale/en_US.ts';