weifuwu 0.87.0 → 0.89.0

package/dist/server/messager/index.d.ts

@@ -53,9 +53,19 @@ export type CreateConversationInput = {
 };
 /** 实时事件（业务事件对象，如 { type: 'new_message', ... }） */
 export type MsgEvent = Record<string, unknown>;
+/** handler 可选鉴权注入（M15——2027-XX） */
+export interface MessagerHandlerOptions {
+    /** WS 握手 token 验证（query ?token=）——返回 { sub } 或 null（null = 拒绝） */
+    verifyToken?: (token: string) => Promise<{
+        sub: string;
+    } | null>;
+    /** 订阅授权（已验证 userId + room）——false 拒绝订阅（发 error 事件）；不传 = 全允许 */
+    authorizeRoom?: (userId: string, room: string) => boolean | Promise<boolean>;
+}
 export interface MessagerClient {
-    /** 标准 WS 协议 handler（connected/subscribe/unsubscribe/ping/pong），供 app.ws(path, ...) */
-    handler: () => WebSocketHandler;
+    /** 标准 WS 协议 handler（connected/subscribe/unsubscribe/ping/pong），供 app.ws(path, ...)
+     *  opts.verifyToken/authorizeRoom 注入鉴权（M15——原升级不跑中间件——任意客户端可订阅任意房间） */
+    handler: (opts?: MessagerHandlerOptions) => WebSocketHandler;
     /** 房间广播（本地 + Redis 跨进程；room 约定 `conv:{id}` / `user:{id}`） */
     broadcast: (room: string, event: MsgEvent) => void;
     /** 用户维度点对点（内部 room `user:{id}`） */
@@ -96,6 +106,15 @@ export interface MessagerSystem extends Middleware<Context, Context & MessagerIn
 }
 export interface MessagerOptions {
     sql: SqlClient;
+    /**
+     * 连接级事务（传 `pg.transaction` / `pool.begin`）——提供时会话创建原子。
+     * 不传 → 裸执行（回退面：成员 insert 失败时孤儿会话——低影响；并发唯一性由
+     * M9 direct_key 唯一约束兜底）。
+     * M10（2027-XX）：原实现 sql.unsafe('BEGIN'/'COMMIT') 在连接池下断裂——
+     * pool.query 每条 acquire/release 任意连接（BEGIN 在 A、INSERT 在 B、COMMIT 在 C）
+     * ——`pool.begin` 才是连接亲和的正途。
+     */
+    transaction?: <T>(fn: (sql: SqlClient) => Promise<T>) => Promise<T>;
     /** Redis（可选：多进程广播/实时推送需要；不传则仅本进程内广播）——
      * 传 `redis().redis`（中间件）或 `new RedisPool()`/`RedisPool.create()` */
     redis?: Redis;

package/dist/server/middleware/compress.d.ts

@@ -0,0 +1,25 @@
+/**
+ * weifuwu/compress — 响应压缩中间件（SERVER-PERF-PLAN S7——波次 3）
+ *
+ * br 优先 → gzip 兜底（Accept-Encoding 协商）；阈值默认 1KB（小响应压缩得不偿失）；
+ * content-type 白名单（文本类）；SSE（text/event-stream）跳过——流式逐 token 推送
+ * 不被缓冲化。流式压缩：response.body 管道经 zlib 转换流——不在内存攒全量（与
+ * sendResponse 背压机制衔接——SERVER-PERF-PLAN S1）。
+ *
+ * 诚实裁剪：❌ zstd（node 内置支持面未稳）、❌ 动态字典、❌ 静态压缩
+ * （serveStatic 预压缩探测覆盖——S8）。
+ *
+ * ```ts
+ * import { compress } from 'weifuwu'
+ * app.use(compress())                          // 默认阈值 1KB
+ * app.use(compress({ threshold: 0 }))          // 全部压缩
+ * ```
+ */
+import type { Context, Middleware } from '../types.ts';
+export interface CompressOptions {
+    /** 最小压缩字节数（Content-Length 判定；未知长度按需压缩）。默认 1024。 */
+    threshold?: number;
+    /** 压缩级别（gzip level / brotli quality）。默认 zlib 默认值。 */
+    level?: number;
+}
+export declare function compress(options?: CompressOptions): Middleware<Context, Context>;

package/dist/server/ui/index.d.ts

@@ -53,5 +53,12 @@ interface UiHtmlTag {
     (strings: TemplateStringsArray, ...values: unknown[]): Response;
     unsafe: (s: string) => string;
 }
-export declare function ui(): Middleware;
+export interface UiOptions {
+    /**
+     * 编译产物缓存。默认 true。
+     * false = 每请求重新编译（旧行为等价——永远新鲜，a29efec3 语义保留逃生舱）。
+     */
+    cache?: boolean;
+}
+export declare function ui(options?: UiOptions): Middleware;
 export {};

package/dist/server/user/index.d.ts

@@ -64,6 +64,10 @@ export interface RegisterInput {
     email: string;
     password: string;
     name?: string;
+    /**
+     * @deprecated B5.2（2027-XX）：自助注册忽略自赋 role（入库恒 null）——
+     * 授权一律走应用成员表 role（防假 admin）；平台 profile role 由应用层管理。
+     */
     role?: string;
     /** 兼容旧单层模型：注册即绑定应用（新三层模型请用 createApp/registerInApp） */
     tenant?: string;

package/dist/shared/router/chain.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 中间件链执行（SHARED-TRIE-EXCELLENCE B0——2027-10 自 server/core/chain.ts
+ * 移入 shared——**前端获得 middleware 能力**（机制就位——路由内核
+ * dispatchRouter 的 resolveHandler 钩子消费））
+ *
+ * next() 重复调用守卫在案（called 标志——server 路由测试锁定 500 语义）。
+ */
+import type { SharedHandler, SharedMiddleware } from './types.ts';
+export declare function runChain<TCtx>(mws: SharedMiddleware<TCtx>[], finalHandler: SharedHandler<TCtx>, req: Request, ctx: TCtx): Promise<Response>;

package/dist/shared/router/context.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 请求目标解析 + ctx 注入纯函数（SHARED-TRIE-EXCELLENCE B1——2027-10）
+ *
+ * **双端重复面收敛**（盘点实证：URL→segments 三处重复、query 注入
+ * 双端同式、params fresh 语义等价实现分散）——单一实现源：
+ * - server：handler() / serve.ts createRequest
+ * - client：UIRouter.resolve / has
+ *
+ * **URIError 防御双端统一**：param 段 decodeURIComponent 对非法编码
+ * （%zz）抛 URIError——非法编码 URL 是客户端错误 → 400 信号
+ * （server C3 修复迁移至此——client 同享——双端 400 语义一致）。
+ */
+/** 解析结果——ok=false 时 reason 分类（400 响应由调用方构造） */
+export type RequestTarget = {
+    ok: true;
+    segments: string[];
+    pathname: string;
+    query: Record<string, string>;
+} | {
+    ok: false;
+    reason: 'malformed-encoding' | 'invalid-url';
+};
+/**
+ * Request → 匹配输入（segments/pathname/query 一次拿全——零二次解析）。
+ * URIError（非法 percent-encoding）→ { ok: false, reason: 'malformed-encoding' }
+ * ——**不抛出**（调用方按 400 分类——双端统一语义）。
+ */
+export declare function parseRequestTarget(req: Request): RequestTarget;
+/** fresh params（match.params 克隆——**不残留旧路由键**——client 契约
+ *  语义（params 每次渲染替换）单一实现源） */
+export declare function freshParams(match?: {
+    params: Record<string, string>;
+} | null): Record<string, string>;
+/** query 提取（Object.fromEntries(searchParams)——双端同一实现源） */
+export declare function parseQuery(url: URL): Record<string, string>;

package/dist/shared/router/ctx-fields.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ctx 字段注册表（SHARED-TRIE-EXCELLENCE B0'——2027-10）
+ *
+ * **ctx 扩展机制双端统一**（用户论证：「前后端都是通过扩展 ctx.xxx
+ * 提供新能力，只是扩展的能力不一样」）——middleware 声明 injects（注入
+ * 字段）/depends（依赖字段）——依赖未注册抛错（含注册引导文案）。
+ *
+ * - server：Router._checkMiddlewareMeta 迁移消费（行为零变化——
+ *   global/route/mount 三位置检查语义保留）
+ * - client：获得同一机制（UIContext declare module 类型增强的运行时
+ *   对应——未来前端中间件声明 injects 同样受检）——类型/运行时双层对齐
+ */
+export interface CtxFieldRegistry {
+    /** 登记注入字段（injects——provider 中间件先行注册） */
+    register(injects: string[]): void;
+    /** 依赖检查（depends——未注册抛错，含 app.use(xxx()) 引导） */
+    check(depends: string[], location: string): void;
+    has(field: string): boolean;
+}
+export declare function createCtxFieldRegistry(): CtxFieldRegistry;

package/dist/shared/router/pipeline.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 路由内核——流程骨架 + 差异钩子（SHARED-TRIE-EXCELLENCE B0——2027-10）
+ *
+ * **机制公用、实现不一样**（用户论证采纳——handler 签名双端同构 +
+ * 流程 6 步中 3 步完全同构、3 步是差异点而非不同流程）：
+ *
+ * ```
+ * dispatchRouter 流程骨架（单一实现源——改一处双端生效）：
+ *   1. parseRequestTarget（URIError → 400 信号——双端统一防御）
+ *   2. trieMatch（shared Trie——静态/param/通配——回溯语义在案）
+ *   3. enrichCtx（ctx 扩展——机制一致能力不同）
+ *   4. resolveHandler（verb 差异点：server method 表 / client 直调）
+ *   5. run → onRouteSuccess（恢复清出）| catch → onError
+ *   6. 404/405 兜底（形态差异钩子化）
+ * ```
+ *
+ * **双端类 API 零变化**：Router.handler() / UIRouter.resolve() 内部
+ * 换 dispatchRouter——405/Allow/去重收敛 serverPipeline；route 注入/
+ * 前端 404 收敛 clientPipeline；serve（Request/Response 编解码边界）
+ * 留双端——pipeline 不关心。
+ */
+import { type TrieNode } from './trie.ts';
+/** 匹配结果（trieMatch 返回 + verb 分类的输入载荷） */
+export interface RouteMatch<TValue> {
+    value: TValue;
+    params: Record<string, string>;
+    wildcard: boolean;
+}
+export interface RouterPipeline<TValue, TCtx> {
+    /**
+     * **verb 差异点**（负载 → 实际执行闭包）：
+     * - server：value 是 method 表——method 查找 + HEAD fallback（mw 联动）
+     *   + 405 分类 + runChain 链组装（globalMws + routeMws）
+     * - client：value 是 PageHandler——直调闭包
+     */
+    resolveHandler(m: RouteMatch<TValue>, req: Request, ctx: TCtx): {
+        kind: 'route';
+        run: () => Response | Promise<Response>;
+    }
+    /** method 表分类（405 Allow 头）——server 独有 */
+     | {
+        kind: 'not-allowed';
+        methods: string[];
+    }
+    /** 通配命中但 method 落空 → 404（通配不产生 405——探针实证锁死） */
+     | {
+        kind: 'not-found';
+    };
+    /** 404 兜底（server: JSON + globalMws 链；client: notFound ?? null body） */
+    onNotFound(req: Request, ctx: TCtx, path: string): Response | Promise<Response>;
+    /** 405 兜底（server 实现——globalMws 链 + Allow 头；client 不实现） */
+    onMethodNotAllowed?(methods: string[], req: Request, ctx: TCtx, path: string): Response | Promise<Response>;
+    /** 错误语义（server: onError 优先/HttpError/去重计数；client 可缺省直抛） */
+    onError?(e: unknown, req: Request, ctx: TCtx, path: string): Response | Promise<Response>;
+    /** 路由成功完成（server: 恢复清出错误状态——再错再报；client 可缺省） */
+    onRouteSuccess?(req: Request, ctx: TCtx, path: string): void;
+    /**
+     * **ctx 扩展钩子**（机制一致能力不同）：
+     * - server：params merge 进既有 ctx.params（Object.assign 语义）
+     * - client：params fresh + query + ctx.route 三面注入
+     * - 404（m null）时也执行——client notFound handler 收到空 params +
+     *   query + route（原语义精确保留）
+     */
+    enrichCtx?(ctx: TCtx, m: RouteMatch<TValue> | null, pathname: string, query: Record<string, string>): void;
+}
+/**
+ * **路由分发流程骨架**——双端 Router 的内核（机制公用、实现不一样）。
+ * 差异全部在 pipeline 钩子——骨架只编排顺序与错误边界。
+ */
+export declare function dispatchRouter<TValue, TCtx>(root: TrieNode<TValue>, pipeline: RouterPipeline<TValue, TCtx>, req: Request, ctx: TCtx): Promise<Response>;

package/dist/shared/router/trie.d.ts

@@ -47,11 +47,19 @@ export declare function trieFind<T>(root: TrieNode<T>, path: string): TrieNode<T
  * '/'（空段）→ value 绑 root；'*' 结尾 → wildcardValue（独立槽）；
  * 其余逐段 getOrCreateChild——终点绑 value。返回终点节点（冲突检查）。
  */
-export declare function trieRegister<T>(root: TrieNode<T>, path: string, value: T, isWildcardValue?: boolean): TrieNode<T>;
+/**
+ * 注册（path → value）——分段插入：
+ * '/'（空段）→ value 绑 root；'*' 结尾 → wildcardValue（独立槽——
+ * **path 自描述**——SHARED-TRIE D1 收紧：原 isWildcardValue 参数与
+ * 内部 path.includes('*') 判定重复（恒真验证：生产调用面 isWildcard =
+ * path.includes('*')——第三态零消费——参数删除））；
+ * 其余逐段 getOrCreateChild——终点绑 value。返回终点节点（冲突检查）。
+ */
+export declare function trieRegister<T>(root: TrieNode<T>, path: string, value: T): TrieNode<T>;
 /**
  * 匹配（segments → { value, params, wildcard } | null）：
- * 精确优先（静态 → :param 逐段）——段失败或终端无 value → 通配兜底
- * （从 root 沿路径检查任意前缀深度的通配注册——params['*'] = 剩余段）；
+ * 精确优先（DFS——静态 → :param 回溯——见 exactDfs）——精确未命中 → 通配
+ * 兜底（从 root 沿路径检查任意前缀深度的通配注册——params['*'] = 剩余段）；
  * 精确命中且节点有通配槽（'/' + '/*' 并存）→ params['*'] = ''（精确优先标记）。
  */
 export declare function trieMatch<T>(root: TrieNode<T>, segments: string[]): {

package/dist/shared/router/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * shared router 类型（SHARED-TRIE-EXCELLENCE B0——2027-10）
+ *
+ * **双端同构的机制形状**（server/types.ts 与 client PageHandler 字面同构——
+ * handler 签名 `(req: Request, ctx) => Response`、middleware洋葱
+ * `(req, ctx, next) => Response`——单一实现源）。server/types.ts 可
+ * re-export（D 波次收紧时统一）——当前结构类型兼容并存。
+ */
+/** 路由 handler——双端签名同构（req 标准 Request 零扩展；Response 原生） */
+export type SharedHandler<TCtx = unknown> = (req: Request, ctx: TCtx) => Response | Promise<Response>;
+/** 中间件——洋葱模型（next 调用透传——可短路可改写响应） */
+export type SharedMiddleware<TCtx = unknown> = (req: Request, ctx: TCtx, next: SharedHandler<TCtx>) => Response | Promise<Response>;
+/** middleware 元信息（ctx 扩展声明——depends 必须先注册/injects 登记字段） */
+export interface MiddlewareMeta {
+    /** Fields this middleware injects into ctx. */
+    injects: string[];
+    /** Fields this middleware depends on (must be injected earlier). */
+    depends: string[];
+}
+/** 带 meta 的 middleware（__meta 可选——ctx-fields 注册表检查依据） */
+export type MetaMiddleware<TCtx = unknown> = SharedMiddleware<TCtx> & {
+    __meta?: MiddlewareMeta;
+};

package/docs/style-guide.md

@@ -15,28 +15,31 @@ weifuwu 的设计语言与框架哲学同源（确定性、诚实裁剪、render
 | 4 | **专业** Instrumental | 面向 AI 应用/管理后台/数据工具：键盘可达、数据密度、三态完整 | 键盘焦点全局；compact 预设；加载/空/错误三态规范 |
 | 5 | **中文原生** CJK-Native | 字阶/行高/断行针对中文；表头不做 uppercase；数字防抖 | `--wf-heading-case: none`；`wf-nums`（tabular-nums） |
 
-主题配置三档（详见 [content/guides/styling.md](styling.md)）：**① 改 `--wf-brand-seed` 一个值换肤**（色阶 color-mix 自动派生，暗色自动跟随）→ **② `<html data-preset="minimal|compact|rounded">` 预设**（与 data-theme 正交）→ **③ 深度定制**（组件钩子 + @layer 覆盖）。
+主题配置三档：**① 改 `--wf-brand-seed` 一个值换肤**（色阶 color-mix 自动派生，暗色自动跟随）→ **② `<html data-preset="minimal|compact|rounded">` 预设**（与 data-theme 正交）→ **③ 深度定制**（组件钩子 + @layer 覆盖）。
 
-## 统一语法：`wf-<域>-<名字>`
+## 统一命名规则：三类词根 + 三后缀（design/layout-naming.md）
 
-所有类遵循一个规则：`wf-` + **域** + 名字。
+类名零猜词——单属性工具直接用 **CSS 属性名**（会 CSS 即会写），
+组合原语用**意图词汇**（表达要什么）。命名只有一种推导路径：
 
-| 域 | 例子 | 说明 |
+| 词根类 | 判定 | 例 |
 |---|---|---|
-| `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-stack` `wf-row` `wf-grid` `wf-split` `wf-center` `wf-surface` |
+| 属性根 | 单一 CSS 属性 → 属性全名 | `wf-padding-md` `wf-margin-top-sm` `wf-radius-md` `wf-justify-between` `wf-overflow-auto` |
+| 裸值词 | 单值状态/行为 | `wf-bold` `wf-uppercase` `wf-truncate` `wf-dim` `wf-pill` `wf-hidden` |
 
-**修饰符号**：
+**后缀语法（三种，各管一事）**：
 ```
-wf-card--active    -- = 变体/状态（选中/激活/hover）
-wf-modal-header    -  = 子元素（组件内部结构，不手写）
-wf-layout-stack@md @  = 断点变体（≥768px 时横向）
+wf-padding-md      -   值/子名（刻度：none|xs|sm|md|lg|xl；方向：全词 top/bottom/left/right/x/y）
+wf-bubble--own     --  变体/状态（选中/激活）
+wf-flex@lg         @   断点变体（≥1024px）
 ```
 
-**值类（裸词）**：单值工具没有属性域——`wf-uppercase` `wf-truncate` `wf-pre-wrap` `wf-dim` `wf-pill`。
+**值词汇封闭表**：标尺 `none~xl`（none = 零/取消唯一形态）·对齐用 CSS 值词
+`start/center/end/stretch/between`（物理方向词禁入对齐域）·颜色语义随 token。
+
+域前缀分域（无过载）：`wf-font-*` 字号 · `wf-text-*` 文字颜色/对齐 ·
+`wf-bg-*` 背景 · `wf-medium/semibold/bold` 字重裸词 · `btn/card/modal/…` 组件域（由 props 渲染，一般不需手写）。
 
 ## 三档学习路径
 
@@ -50,24 +53,24 @@ wf-layout-stack@md @  = 断点变体（≥768px 时横向）
 <Card hover><StatCard value="1,234" label="总用户" /></Card>
 ```
 
-### 第二档：10 个核心原语（半小时，覆盖 90% 页面）
+### 第二档：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     圆角
+wf-stack           垂直堆叠 + gap（第一原语）
+wf-row             水平排列 + wrap + gap
+wf-gap-sm          设置间距（配合上面）
+wf-fill            flex:1 撑满（配 wf-min-width-0 防溢出）
+wf-padding-md      内边距
+wf-font-sm         字号（小字）
+wf-text-secondary  次级文字色（第二档唯一需要记的颜色词）
+wf-justify-between 两端分布
+wf-border-bottom   下边框
+wf-radius-md       圆角
 ```
 
 ```tsx
-<div class="wf-layout-split">
-  <div class="wf-layout-row wf-gap-md">
+<div class="wf-justify-between">
+  <div class="wf-row wf-gap-md">
     <Card>…</Card>
   </div>
   <Button variant="primary">提交</Button>
@@ -76,24 +79,25 @@ wf-rounded-md     圆角
 
 ### 第三档：完整速查（按需查 IDE 补全）
 
-输入 `wf-layout-` / `wf-text-` / `wf-bg-` 弹出全部候选。完整清单见 README「布局系统」。
+输入 `wf-` 后按词根补全（`wf-padding-` / `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-justify-between` |
+| 一列堆叠带间距 | `wf-stack wf-gap-md` |
+| 一行换行居中对齐 | `wf-cluster wf-gap-md` |
+| 卡片网格 | `<div class="wf-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` |
+| 隐藏元素（窄隐宽显） | `wf-hidden wf-flex@lg`（响应式显隐唯一模式） |
+| 角标/覆盖层 | 父 `wf-relative` + 子 `wf-absolute`（CSS 零学习配对） |
+| 可滚动区 | `wf-overflow-auto`（横滚 `wf-overflow-x`） |
 | 按钮变胶囊 | `:root { --wf-btn-radius: 999px }` |
 | 数字防抖（统计/表格数值） | `wf-nums`（StatCard 已默认套用） |
-| 顶级页面大标题 | `<PageHeader display>` 或 `wf-text-display` |
+| 顶级页面大标题 | `<PageHeader display>` |
 | 状态/计数徽章 | `<Badge variant>`（不可交互，含 dot） |
 | 可关闭标签 | `<Tag closable>`（可交互，有关闭钮） |
 | 图标 | `<Icon name="close" />`（禁止裸 emoji/字形） |
@@ -103,11 +107,10 @@ wf-rounded-md     圆角
 | 用途 | 写法 | Token |
 |------|------|-------|
 | 顶级页面标题 | `<PageHeader display>` | `--wf-font-size-display` (30px, 负字距) |
-| 页面标题 | `wf-text-3xl/4xl` | 24/30px |
-| 卡片标题 | `wf-text-xl/2xl` | 16/21px |
-| 正文 | `wf-text-base`（默认） | 14px · 行高 1.5（CJK 实测可读，与主流框架同档） |
-| 次级/辅助 | `wf-text-sm` / `wf-text-xs` | 13/12px · 配 `wf-text-secondary` |
-| 长文正文（文章） | `wf-prose` | 行高 1.75（relaxed）——长文更宽松 |
+| 页面标题 | `wf-font-3xl/4xl` | 24/30px |
+| 卡片标题 | `wf-font-xl/2xl` | 16/21px |
+| 正文 | `wf-font-base`（默认） | 14px · 行高 1.5（CJK 实测可读，与主流框架同档） |
+| 次级/辅助 | `wf-font-sm` / `wf-font-xs` | 13/12px · 配 `wf-text-secondary` |
 | 数字/统计 | `wf-nums`（StatCard/Table 数值） | tabular-nums 防宽度抖动 |
 | 标题字距/变换 | 全局 | `--wf-heading-case`（CJK 默认 none，英文可 uppercase） |
 
@@ -189,7 +192,7 @@ wf-rounded-md     圆角
 用户 @layer utilities 可精准盖过 weifuwu 的 utilities
 ```
 
-## 主题 Token（182 个，双层）
+## 主题 Token（183 个，双层）
 
 - **原始层**（`--wf-brand-*` `--wf-slate-*` `--wf-dark-*`）：色值只定义一次，品牌/暗色调校改这里
 - **语义层**（`--wf-color-*` `--wf-space-*` `--wf-radius-*` …）：组件消费，主题切换覆盖这里

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weifuwu",
   "type": "module",
-  "version": "0.87.0",
+  "version": "0.89.0",
   "description": "AI SaaS full-stack framework — backend HTTP + frontend VDOM + 129 components + CSS design system + SaaS foundation (auth/queue/AI). Zero-build, zero-dependency.",
   "exports": {
     ".": {
@@ -32,13 +32,8 @@
   "files": [
     "dist/",
     "README.md",
-    "docs/",
-    "content/",
-    "examples/"
+    "docs/"
   ],
-  "bin": {
-    "weifuwu": "./dist/cli/docs.mjs"
-  },
   "scripts": {
     "build": "node scripts/build.mjs",
     "prepublishOnly": "npm run build && tsc --emitDeclarationOnly --outdir dist",
@@ -47,14 +42,21 @@
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
     "test:client": "node --env-file=.env --test --test-concurrency=4 'src/test/contract/**/*.test.ts'",
-    "test:server": "node --env-file=.env --test --test-concurrency=8 'src/server/**/*.test.ts'",
+    "test:server": "node --env-file=.env --test --experimental-test-module-mocks --test-concurrency=8 'src/server/**/*.test.ts'",
     "test:showcase": "node --env-file=.env --test --test-timeout=8000 apps/showcase/test/comp-*.test.ts",
     "test:scenario": "node --env-file=.env --test --test-timeout=8000 --test-concurrency=14 'src/test/scenario/e2e*.test.ts'",
     "test:components": "node --env-file=.env --test --test-timeout=8000 --test-concurrency=2 src/test/scenario/e2e-6.test.ts",
     "audit:semantics": "node scripts/audit-core-semantics.mjs",
     "audit:showcase": "node scripts/audit-showcase-dev.mjs",
-    "audit:all": "npm run audit:semantics && npm run audit:showcase",
-    "test:contract-components": "node --env-file=.env --test 'src/client/components/**/*.test.ts'"
+    "audit:all": "npm run audit:semantics && npm run audit:interactivity && npm run audit:vdom && npm run audit:theme && npm run audit:api && npm run audit:bundle && npm run audit:showcase",
+    "bench:server": "node bench/server-bench.ts",
+    "bench:db": "node bench/db-bench.ts",
+    "test:contract-components": "node --env-file=.env --test 'src/client/components/**/*.test.ts'",
+    "audit:interactivity": "node scripts/audit-interactivity.mjs",
+    "audit:theme": "node scripts/audit-theme.mjs",
+    "audit:api": "node scripts/audit-api.mjs",
+    "audit:bundle": "node scripts/audit-bundle.mjs",
+    "audit:vdom": "node scripts/audit-vdom.mjs"
   },
   "dependencies": {
     "esbuild": "^0.28.1",
@@ -86,6 +88,7 @@
     "playwright": "^1.62.1",
     "postcss": "^8.5.19",
     "postgres": "^3.4.9",
+    "puppeteer-core": "^25.9.0",
     "tailwindcss": "^4.3.3"
   },
   "keywords": [

package/content/apps/admin.md

@@ -1,55 +0,0 @@
-# 管理后台 · apps
-
-## 概述
-
-AppShell + Dashboard/Table/Form 多页——layout 包裹复用 + 主题。后端：rateLimit + 查询端点。源于 agent-platform 架构提炼。
-
-
-## 用到的页面模式
-- [app-shell](../patterns/app-shell.md)
-
-## 用到的组件
-- [Layout](../components/layout.md)
-- [Menu](../components/menu.md)
-- [NavMenu](../components/navmenu.md)
-- [Table](../components/table.md)
-- [Form](../components/form.md)
-- [ThemeSwitch](../components/themeswitch.md)
-- [StatCard](../components/statcard.md)
-- [Chart](../components/chart.md)
-- [Badge](../components/badge.md)
-- [Avatar](../components/avatar.md)
-- [Tag](../components/tag.md)
-
-## 源码
-
-> `examples/apps/admin/` ——完整可运行（随 npm 包发布）
-
-## 目录结构
-
-| 文件 | 职责 |
-|------|------|
-| `app.tsx` | 前端：AppShell（Layout 骨架 + Menu）+ DashboardPage/OrdersPage + 路由 layout 包裹 |
-| `api.ts` | 后端：registerAdminApi——订单查询 + 种子数据 |
-| `server.ts` | 独立入口（:3302） |
-| `main.tsx` | 独立前端入口 |
-
-## 改造指南（新手从跑起来到改成自己的）
-
-- 1. 换业务数据：api.ts 的 admin_orders 表 + 种子数据 → 自己的业务表（或接真实 postgres）
-- 2. 加页面：app.tsx 路由表加 { path, render, layout: AppShell }——侧栏 Menu items 同步加
-- 3. 改菜单/品牌：AppShell 里 Menu items + 标题文案
-- 4. 表格交互：Table 组件文档（sortable/rowSelection——受控 props 配回调）
-- 5. 参考生产级：apps/agent-platform/（多租户/权限/商业化真实架构）
-
-## 质量标准
-
-- [x] 键盘可达
-- [x] 侧栏折叠
-- [x] 表格排序
-- [x] 亮暗主题
-- [x] loading/empty 态
-
-## 验证
-
-> agent-browser 走查：打开 showcase `/apps/admin`（活体嵌入）——列表/新建/保存/删除全流程 + 控制台零错误

package/content/apps/agent-platform.md

@@ -1,35 +0,0 @@
-# agent-platform（生产级） · apps（生产级）
-
-## 概述
-
-多租户 AI Agent 平台——weifuwu 中间件全量消费方（认证/AI/沙箱/工具链/商业化/私有化）。实战驱动框架开发的生产级参考。
-
-> **生产级参考**：目录独立于 showcase（apps/agent-platform/），此处为展示层纳入——架构文档 + 源码索引 + 启动方式。
-## 用到的页面模式
-- （无）
-
-## 用到的组件
-- [AiChat](../components/aichat.md)
-- [AuthPage](../components/authpage.md)
-- [Table](../components/table.md)
-- [Form](../components/form.md)
-- [Modal](../components/modal.md)
-- [Drawer](../components/drawer.md)
-- [Menu](../components/menu.md)
-- [StatCard](../components/statcard.md)
-- [ThemeSwitch](../components/themeswitch.md)
-
-## 源码
-
-> 源码见 `apps/agent-platform/`（独立仓库结构——不随包）
-
-## 质量标准
-
-- [x] 真实产品
-- [x] 多租户
-- [x] 私有化部署
-- [x] 商业化闭环
-
-## 验证
-
-> 独立部署验证（docker + 真实库）——见 apps/agent-platform/README.md

package/content/apps/auth.md

@@ -1,49 +0,0 @@
-# 登录注册 · apps
-
-## 概述
-
-登录/注册 → 受保护页 → 登出：应用级状态（user store）+ 路由守卫 + ctx.data。后端：认证中间件。
-
-
-## 用到的页面模式
-- （无）
-
-## 用到的组件
-- [Card](../components/card.md)
-- [Form](../components/form.md)
-- [Input](../components/input.md)
-- [PasswordInput](../components/passwordinput.md)
-- [Button](../components/button.md)
-- [Alert](../components/alert.md)
-
-## 源码
-
-> `examples/apps/auth/` ——完整可运行（随 npm 包发布）
-
-## 目录结构
-
-| 文件 | 职责 |
-|------|------|
-| `app.tsx` | 前端：AuthFormPage（登录/注册两用）+ 路由守卫 + authStore |
-| `api.ts` | 后端：registerAuthApi——内存用户表 + token 会话 |
-| `server.ts` | 独立入口（:3301） |
-| `main.tsx` | 独立前端入口 |
-
-## 改造指南（新手从跑起来到改成自己的）
-
-- 1. 换用户存储：api.ts 的 auth_users 表 → 接 userSystem 中间件（见 content/backend/auth.md）
-- 2. 加受保护页：app.tsx 路由表加页面 + 组件内读 authStore.state.user 做守卫（同 DashboardPage 模式）
-- 3. 改会话持久化：app.tsx 的 ctx.browser.storageSet 已处理——key 名 auth:token 可改
-- 4. 加角色权限：守卫处加角色判断（user 表加 role 字段）
-
-## 质量标准
-
-- [x] 键盘可达
-- [x] 表单校验
-- [x] 错误态
-- [x] 会话持久化
-- [x] 零控制台错误
-
-## 验证
-
-> agent-browser 走查：打开 showcase `/apps/auth`（活体嵌入）——列表/新建/保存/删除全流程 + 控制台零错误