weifuwu 0.60.0 → 0.61.0

package/README.md

@@ -236,8 +236,8 @@ createApp().use(router({ routes })).mount('#root', RouteView, { hydrate: true })
 | 资源 | CDN 地址 | 说明 |
 |------|---------|------|
 | `weifuwu/client` | `https://unpkg.com/weifuwu@latest/dist/client/index.js` | 客户端核心（createApp, h, 路由, 状态管理等） |
-| `weifuwu/components` | `https://unpkg.com/weifuwu@latest/dist/components/index.js` | 46 个 UI 组件（Button, Card, Table, Modal 等） |
-| 组件样式 | `https://unpkg.com/weifuwu@latest/dist/components/style.css` | 组件 CSS + 115 个主题 Token + 67 个布局原语 |
+| `weifuwu/components` | `https://unpkg.com/weifuwu@latest/dist/components/index.js` | 48 个 UI 组件（Button, Card, Table, Modal, Icon 等） |
+| 组件样式 | `https://unpkg.com/weifuwu@latest/dist/components/style.css` | 组件 CSS + 141 个主题 Token + 67 个布局原语 |
 | 独立布局系统 | `https://unpkg.com/weifuwu@latest/dist/layout/weifuwu-layout.css` | 仅 CSS 布局，不依赖 JS |
 
 
@@ -275,8 +275,8 @@ createApp().use(router({ routes })).mount('#root', RouteView, { hydrate: true })
 | `weifuwu/client` | **ErrorBoundary** | 错误边界组件 | createApp |
 | `weifuwu/client` | **lockScroll/trapFocus** | 滚动锁定 / 焦点陷阱工具 | — |
 | `weifuwu/client` | **popup** | 弹层 fixed 定位工具（`computeFixedPos` / `computeFixedPosRect`） | — |
-| `weifuwu/components` | **47 个组件** | Button/Table/Modal/Confirm/Toast/... + `confirm()` / `toast()` 命令式中间件 | weifuwu/client |
-| `weifuwu/layout` | **CSS 布局** | 67 个布局原语 + 115 个主题 Token（也支持 `weifuwu/layout/style.css`） | — |
+| `weifuwu/components` | **48 个组件** | Button/Table/Modal/Confirm/Toast/... + `confirm()` / `toast()` 命令式中间件 | weifuwu/client |
+| `weifuwu/layout` | **CSS 布局** | 67 个布局原语 + 141 个主题 Token（也支持 `weifuwu/layout/style.css`） | — |
 
 ---
 
@@ -2450,7 +2450,7 @@ props 变化 ──────────────────────
 
 # 布局系统 (`weifuwu/layout`)
 
-纯 CSS 布局原语 + 工具类 + 115 个主题 Token。不绑定任何 JS 框架。
+纯 CSS 布局原语 + 工具类 + 141 个主题 Token。不绑定任何 JS 框架。
 
 > **学习路径与命名规范**：见 [`docs/style-guide.md`](./docs/style-guide.md)——统一语法 `wf-<域>-<名>`、三档学习（组件 → 10 核心原语 → 完整速查）、场景速查、变量定制。
 
@@ -2547,7 +2547,7 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 | `wf-truncate` | 单行省略（ellipsis） |
 | `wf-line-clamp-2/3` | 多行截断 |
 
-## 115 个主题 Token
+## 141 个主题 Token
 
 **双层结构**：原始层（Primitive，色值只定义一次，品牌/暗色调校改这里）+ 语义层（Semantic，组件消费）。
 
@@ -2567,6 +2567,11 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 --wf-color-error / --wf-color-error-bg
 --wf-color-info / --wf-color-info-bg
 
+/* 语义文字色（P2）：浅底可读 700 级，文字用 -text、填充用 500 级 */
+--wf-color-primary-text / --wf-color-success-text / --wf-color-warning-text / --wf-color-error-text / --wf-color-info-text
+--wf-color-on-brand   /* 实心品牌/语义底上的文字与图标 */
+--wf-overlay          /* 浮层遮罩（Modal/Drawer），暗色自动加深 */
+
 /* 文字色 */
 --wf-color-text / --wf-color-text-secondary / --wf-color-text-tertiary / --wf-color-text-disabled
 
@@ -2579,7 +2584,7 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 /* 字体 */
 --wf-font-sans / --wf-font-mono
 
-/* 字号: xs sm base lg xl 2xl 3xl 4xl 5xl */
+/* 字号: xs sm base lg xl 2xl 3xl 4xl 5xl display */
 --wf-font-size-*
 
 /* 字重: normal medium semibold bold */
@@ -2603,6 +2608,17 @@ app.get('/layout.css', (req, ctx) => ctx.ui.css('weifuwu/layout'))
 /* 阴影: sm md lg */
 --wf-shadow-*
 
+/* 动效（P0）：时长阶梯/缓动曲线/位移量，全站动效统一引用 */
+--wf-dur-fast / --wf-dur-base / --wf-dur-slow
+--wf-ease-out / --wf-ease-in / --wf-ease-snap
+--wf-motion-sm / --wf-motion-md / --wf-motion-lg
+
+/* 表头/分组标题（P5）：CJK 感知，默认 none/0，英文可覆盖 */
+--wf-heading-case / --wf-heading-tracking
+
+/* 数字（P5）：tabular-nums 防宽度抖动（wf-nums 工具类） */
+--wf-nums
+
 /* 其他 */
 --wf-border-width / --wf-focus-ring
 --wf-transition-duration / --wf-transition-timing

package/dist/ai/agent.d.ts

@@ -14,7 +14,7 @@
  */
 import { type WfEmitter } from './sse.ts';
 import type { AiClient } from './client.ts';
-import type { ChatMessage } from './types.ts';
+import type { ChatMessage, WfUsage } from './types.ts';
 export interface ToolContext {
     /** 工具执行声道：emit('wf:tool_progress', ...) 或 emit('x:*', ...) */
     emit: WfEmitter;
@@ -43,8 +43,36 @@ export interface AgentRunOptions {
     signal?: AbortSignal;
     traceId?: string;
 }
+/** agent 执行步骤（结构化结果用，协议 wf:step/wf:tool_result 的汇总） */
+export interface AgentStep {
+    type: 'llm' | 'tool_call' | 'tool_result';
+    content?: string;
+    toolCall?: {
+        id: string;
+        name: string;
+        arguments: string;
+    };
+    toolResult?: string;
+}
+/** 结构化运行结果（非流式服务编排用；流式场景走 stream/SSE 的 wf:* 事件） */
+export interface AgentRunResult {
+    content: string;
+    steps: AgentStep[];
+    usage?: WfUsage;
+}
 export interface AgentRunner {
     /** 运行 agent → SSE Response（wf: 协议事件流），路由直接 return */
     run: (messages: ChatMessage[], options?: AgentRunOptions) => Response;
+    /**
+     * 事件流模式：wf:* 事件打到自定义 emitter（SSE 只是默认实现）。
+     * 应用层可把事件接到 WS/回调/自有协议（协议适配器）——不绑死传输通道。
+     */
+    stream: (messages: ChatMessage[], options?: {
+        emit: WfEmitter;
+        signal?: AbortSignal;
+        traceId?: string;
+    }) => Promise<void>;
+    /** 结构化结果模式：收集 wf:* 事件 → AgentRunResult（非流式服务编排用） */
+    runToResult: (messages: ChatMessage[], options?: AgentRunOptions) => Promise<AgentRunResult>;
 }
 export declare function createAgent(client: AiClient, config: AgentConfig): AgentRunner;

package/dist/ai/client.d.ts

@@ -57,6 +57,17 @@ export interface AiClientOptions {
     baseUrl: string;
     apiKey: string;
     defaultModel: string;
+    /** embedding provider 配置（可选；未配时 embed/embedMany 抛 AiError('unsupported')） */
+    embedding?: AiEmbeddingOptions;
+}
+/** embedding provider 配置——默认参数与 DashScope compatible-mode 对齐（DeepSeek 无 embedding API） */
+export interface AiEmbeddingOptions {
+    /** 默认读 DASHSCOPE_API_KEY */
+    apiKey?: string;
+    /** 默认 'https://dashscope.aliyuncs.com/compatible-mode/v1' */
+    baseUrl?: string;
+    /** 默认读 DASHSCOPE_EMBEDDING_MODEL，回退 'text-embedding-v4' */
+    defaultModel?: string;
 }
 /** 单轮 LLM 流式调用的聚合结果（agent 循环用） */
 export interface StreamFinishResult {
@@ -96,6 +107,10 @@ export interface AiClient {
         name: string;
         args: Record<string, unknown>;
     }, emit: WfEmitter, timeoutMs?: number): Promise<WfApprovalResponse>;
+    /** 单文本嵌入（知识库/语义检索；需 ai({ embedding }) 配置，未配抛 AiError） */
+    embed(text: string): Promise<number[]>;
+    /** 批量文本嵌入（按输入顺序返回） */
+    embedMany(texts: string[]): Promise<number[][]>;
 }
 export declare function createAiClient(opts: AiClientOptions): AiClient;
 /** 审批默认超时：5 分钟 */

package/dist/ai/index.d.ts

@@ -29,6 +29,8 @@
 import type { Context, Middleware } from '../types.ts';
 import { type AiClient, type AiClientOptions } from './client.ts';
 import { type AgentConfig, type AgentRunner } from './agent.ts';
+export type { AiEmbeddingOptions } from './client.ts';
+export type { AgentRunResult, AgentStep, AgentTool, AgentConfig, AgentRunner, ToolContext } from './agent.ts';
 export interface AiOptions extends Partial<AiClientOptions> {
 }
 export interface AiInjected {
@@ -51,4 +53,3 @@ export type { WfStreamEvent, WfMessageStart, WfToken, WfUsage, WfDone, WfError,
 export type { WfEmitter } from './sse.ts';
 export { AiError } from './client.ts';
 export type { AiClient, ChatResponse } from './client.ts';
-export type { AgentConfig, AgentTool, AgentRunner, ToolContext } from './agent.ts';

package/dist/client/diff.d.ts

@@ -0,0 +1,15 @@
+/**
+ * weifuwu/client 增量 diff — patchValue 及全部 diff 辅助
+ *
+ * 从 render.ts 拆出（P2 结构拆分）。依赖方向：
+ *   diff.ts → render.ts（renderValue/mountComponent/patchPortal/renderPortal）
+ *   diff.ts → registry.ts（callRefCleanup）
+ *   render.ts 不依赖 diff.ts（单向，无环）
+ */
+import type { WfuiContext } from './types.ts';
+export declare function patchValue(parent: Node, oldNode: Node | null, oldInput: any, newInput: any, ctx: WfuiContext): Node | null;
+export declare function patchProps(el: Element, oldProps: any, newProps: any): void;
+/** 为无 key 的子节点自动分配位置 key，确保 keyed diff 正确性 */
+export declare function ensureKeys(oldChildren: any[], newChildren: any[]): void;
+export declare function normalize(children: any): any[];
+export declare function patchKeyedChildren(parent: Node, oldChildren: any[], newChildren: any[], ctx: WfuiContext): void;

package/dist/client/hydration.d.ts

@@ -0,0 +1,13 @@
+/**
+ * weifuwu/client Hydration（游标收养）— 收养服务端 HTML，不重建 DOM
+ *
+ * 从 render.ts 拆出（P2 结构拆分）。依赖：render.ts（flattenChildren/SVG 常量）、
+ * diff.ts（patchProps）、registry.ts（idRegistry/nextComponentId/resolveAsyncFactory）。
+ */
+import type { VNode } from './vnode.ts';
+import type { WfuiContext } from './types.ts';
+/**
+ * Hydration 挂载入口：收养 container 内现有服务端 HTML。
+ * 渲染完收尾：删除服务端有、客户端没有的残留 DOM。
+ */
+export declare function hydrateVNode(container: Element, vnode: VNode, ctx: WfuiContext): Promise<void>;

package/dist/client/index.d.ts

@@ -42,6 +42,10 @@ export { i18n } from './i18n.ts';
 export type { I18nOptions, I18nState, I18nInjected } from './i18n.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';