weifuwu 0.86.0 → 0.87.0

package/dist/client/components/FileTree/FileTree.d.ts

@@ -0,0 +1,57 @@
+/**
+ * weifuwu/components — FileTree
+ *
+ * 文件树浏览器（工作空间/目录浏览场景）：面包屑 + 工具行（上传/刷新）+
+ * 目录/文件列表（图标/大小/时间）+ 文件编辑态（textarea + 保存/返回）。
+ *
+ * **受控组件（诚实裁剪）**：纯展示 + 回调上抛——状态（entries/path/编辑
+ * 内容）与数据源（API/WS）由父组件管理——组件零 fetch/零 xhr——数据源
+ * 无关（本地目录/沙盒卷/API 均可驱动）。来源：agent-platform FilesSection
+ * （工作空间文件区——AI 沙盒写文件 ↔ 用户管理面双向可见）沉淀。
+ *
+ * 状态约定（父层驱动）：
+ * - entries/path/loading：当前目录列表
+ * - openFile/editValue/saving：编辑态（openFile 非空 = 编辑中）
+ * - 回调：onOpenDir/onOpenFile/onBack/onSave/onEditChange/onUpload/onRefresh
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface FileTreeEntry {
+    name: string;
+    type: 'dir' | 'file';
+    size?: number;
+    mtime?: string;
+}
+export interface FileTreeOpenFile {
+    path: string;
+    content: string;
+    /** 二进制不可预览（父层识别——打开时直接 toast） */
+    binary?: boolean;
+    truncated?: boolean;
+    size?: number;
+}
+export interface FileTreeProps {
+    /** 当前目录条目（父层数据源驱动） */
+    entries?: FileTreeEntry[];
+    /** 当前目录路径（面包屑） */
+    path?: string;
+    loading?: boolean;
+    /** 编辑态（非空 = 文件编辑中——列表替换为编辑器） */
+    openFile?: FileTreeOpenFile | null;
+    /** 编辑内容（受控） */
+    editValue?: string;
+    saving?: boolean;
+    /** 目录空态文案 */
+    emptyText?: string;
+    /** 编辑态返回列表 */
+    onBack?: () => void;
+    onOpenDir?: (path: string) => void;
+    onOpenFile?: (path: string) => void;
+    onSave?: (content: string) => void;
+    onEditChange?: (value: string) => void;
+    /** 上传（父层处理 File——组件只触发选择） */
+    onUpload?: (file: File) => void;
+    onRefresh?: () => void;
+    /** 上传 accept（默认全部） */
+    accept?: string;
+}
+export declare const FileTree: Component<FileTreeProps>;

package/dist/{components → client/components}/FileUpload/FileUpload.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components — FileUpload
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface FileUploadProps {
     accept?: string;
     multiple?: boolean;

package/dist/{components → client/components}/FloatButton/FloatButton.d.ts

@@ -11,7 +11,7 @@
  *
  * 裁剪（CS-05，见 design/components-cuts.md）：不做拖拽悬浮（Resizable 可组合）；回顶用 BackTop 语义更清晰。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export type FloatButtonPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 export interface FloatButtonProps {
     icon?: any;

package/dist/{components → client/components}/Form/Form.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface ValidationRule {
     required?: boolean;
     pattern?: RegExp;

package/dist/{components → client/components}/Grid/Grid.d.ts

@@ -13,7 +13,7 @@
  * 裁剪（CS-05，见 design/components-cuts.md）：不做响应式断点 props（useBreakpoint 由用户驱动）；
  * gutter 仅水平（垂直 gutter 低频）。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface GridProps {
     gutter?: number;
     flex?: boolean;

package/dist/{components → client/components}/Highlight/Highlight.d.ts

@@ -4,7 +4,7 @@
  * 搜索词高亮：给定文本 + 高亮词数组 → 分词渲染 <mark>（零依赖，VNode 拼接）。
  * 配合 SearchInput/Table 搜索结果命中展示。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface HighlightProps {
     text: string;
     query?: string | string[];

package/dist/{components → client/components}/HoverCard/HoverCard.d.ts

@@ -1,11 +1,12 @@
 /**
  * weifuwu/components — HoverCard
  *
- * usePopup 组合器：hover 触发（触屏自动降级 tap）+ openDelay/closeDelay +
- * 定位/视口 clamp + Escape + portal。对应 shadcn HoverCard。
+ * 命令式弹窗（一个形态——ctx.ui.openPopup——toast 心智）：hover 触发
+ * （触屏自动降级 tap）+ openDelay/closeDelay + 定位/视口 clamp + Escape。
+ * 对应 shadcn HoverCard。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
-import type { Placement } from '../../ui-dom/popup.ts';
+import type { Component } from '../../vdom/index.ts';
+import type { Placement } from '../../vdom/hooks/popup.ts';
 export type HoverCardPosition = Placement;
 export interface HoverCardProps {
     /** 富内容（任意 VNode，区别于 Tooltip 的 string） */

package/dist/{components → client/components}/Icon/Icon.d.ts

@@ -8,8 +8,8 @@
  *   h(Icon, { name: 'close' })
  *   h(Icon, { name: 'check', size: 16 })
  */
-import type { Component } from '../../ui-dom/vnode.ts';
-export type IconName = 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'arrow-left' | 'arrow-up' | 'arrow-down' | 'arrow-right' | 'sort' | 'sort-asc' | 'sort-desc' | 'check' | 'close' | 'alert' | 'info' | 'warning' | 'pause' | 'settings' | 'search' | 'send' | 'stop' | 'retry' | 'upload' | 'trash' | 'edit' | 'plus' | 'copy' | 'eye' | 'eye-off' | 'star' | 'dashboard' | 'grid' | 'box' | 'users' | 'user' | 'home' | 'folder' | 'file' | 'file-text' | 'calendar' | 'clock' | 'bell' | 'menu' | 'activity' | 'trending-up' | 'trending-down' | 'database' | 'server' | 'heart' | 'refresh' | 'message' | 'inbox' | 'shield' | 'zap' | 'target' | 'mail' | 'external-link' | 'log-out' | 'lock' | 'list' | 'bar-chart' | 'gauge' | 'paperclip' | 'filter' | 'layers' | 'map-pin' | 'book-open' | 'github' | 'tag' | 'phone' | 'more-vertical' | 'check-circle' | 'alert-circle' | 'wifi' | 'cpu' | 'hard-drive' | 'globe' | 'briefcase' | 'layout';
+import type { Component } from '../../vdom/index.ts';
+export type IconName = 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'arrow-left' | 'arrow-up' | 'arrow-down' | 'arrow-right' | 'sort' | 'sort-asc' | 'sort-desc' | 'check' | 'close' | 'alert' | 'info' | 'warning' | 'pause' | 'settings' | 'search' | 'send' | 'stop' | 'retry' | 'upload' | 'trash' | 'edit' | 'plus' | 'copy' | 'eye' | 'eye-off' | 'star' | 'dashboard' | 'grid' | 'box' | 'users' | 'user' | 'home' | 'folder' | 'file' | 'file-text' | 'calendar' | 'clock' | 'bell' | 'menu' | 'activity' | 'trending-up' | 'trending-down' | 'database' | 'server' | 'heart' | 'refresh' | 'message' | 'inbox' | 'shield' | 'zap' | 'target' | 'mail' | 'external-link' | 'log-out' | 'lock' | 'list' | 'bar-chart' | 'gauge' | 'paperclip' | 'filter' | 'layers' | 'map-pin' | 'book-open' | 'github' | 'tag' | 'phone' | 'more-vertical' | 'check-circle' | 'alert-circle' | 'wifi' | 'cpu' | 'hard-drive' | 'globe' | 'briefcase' | 'layout' | 'camera' | 'image' | 'share';
 export interface IconProps {
     name: IconName;
     /** 尺寸，默认 1em（随字号缩放） */

package/dist/client/components/ImageCropper/ImageCropper.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ImageCropper — 图片裁剪（canvas 原生 API + 拖拽裁剪框，零依赖）
+ *
+ * 用法：<ImageCropper src={url} aspect={1} onCrop={dataUrl => ...} />
+ * 实现：图片绘制到 canvas → 裁剪框（useDrag 拖动/缩放）→ onCrop 输出 dataURL。
+ * 纪律：canvas 浏览器 API 经 ctx.browser（SSR 无害——null 检查）。
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface ImageCropperProps {
+    src: string;
+    /** 裁剪比例（宽/高——默认 1） */
+    aspect?: number;
+    onCrop?: (dataUrl: string) => void;
+    onError?: (err: Error) => void;
+    className?: string;
+}
+export declare const ImageCropper: Component<ImageCropperProps>;

package/dist/{components → client/components}/Img/Img.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components — Img
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface ImgProps {
     src?: string;
     alt?: string;

package/dist/{components → client/components}/InView/InView.d.ts

@@ -4,7 +4,7 @@
  * 进入视窗后替换占位符为真实内容。
  * 实现：ctx.ui.useInView（IO 封装）——滚动/尺寸变化由合成器线程评估，无 scroll 监听。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface InViewProps {
     once?: boolean;
     threshold?: number;

package/dist/{components → client/components}/InfiniteScroll/InfiniteScroll.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface InfiniteScrollProps {
     hasMore?: boolean;
     loading?: boolean;

package/dist/{components → client/components}/Input/Input.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface InputProps {
     label?: string;
     name?: string;

package/dist/{components → client/components}/InputNumber/InputNumber.d.ts

@@ -5,7 +5,7 @@
  * 受控 value: number | null；空值 → null；输入 clamp 到 min/max。
  * 裁剪（CS-05，见 design/components-cuts.md）：千分位货币格式（业务自拼）。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface InputNumberProps {
     value?: number | null;
     onChange?: (value: number | null) => void;

package/dist/{components → client/components}/JSONViewer/JSONViewer.d.ts

@@ -5,7 +5,7 @@
  * 零依赖（无 raw JSON.parse 展示——VNode 渲染天然转义）。
  * 裁剪（CS-05，见 design/components-cuts.md）：JSON 编辑、超大对象流式渲染（懒展开覆盖 100 键级）。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface JSONViewerProps {
     data: unknown;
     /** 默认展开深度（默认 2）——更深折叠为摘要 */

package/dist/{components → client/components}/JsonSchemaForm/JsonSchemaForm.d.ts

@@ -1,5 +1,5 @@
-import type { Component } from '../../ui-dom/vnode.ts';
-import type { WfuiContext } from '../../ui-dom/types.ts';
+import type { Component } from '../../vdom/index.ts';
+import type { UIContext } from '../../vdom/index.ts';
 /**
  * JsonSchemaForm — JSON Schema（对象子集）→ 参数输入表单（零依赖）
  *
@@ -45,4 +45,4 @@ export interface JsonSchemaFormProps {
     onSubmit?: (values: Record<string, any>) => void;
     submitLabel?: string;
 }
-export declare const JsonSchemaForm: Component<JsonSchemaFormProps, WfuiContext>;
+export declare const JsonSchemaForm: Component<JsonSchemaFormProps, UIContext>;

package/dist/{components → client/components}/Kanban/Kanban.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface KanbanItem {
     id: string;
     title: string;

package/dist/{components → client/components}/Label/Label.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface LabelProps {
     htmlFor?: string;
     /** 必填星号 */

package/dist/{components → client/components}/Layout/Layout.d.ts

@@ -18,7 +18,7 @@
  * - 响应式折叠交还用户：useBreakpoint 驱动 collapsed（裁剪：不自动抽屉化）
  * - 静态外壳见 layout `_app-shell.css`（wf-app-shell/wf-sidebar/wf-main）
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface LayoutProps {
     style?: any;
     className?: string;

package/dist/{components → client/components}/Link/Link.d.ts

@@ -8,7 +8,7 @@
  *
  * 裁剪（CS-05，见 design/components-cuts.md）：不做 hover 弹层预览/图标内置枚举（icon 任意 VNode）。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface LinkProps {
     href?: string;
     variant?: 'default' | 'primary' | 'danger' | 'muted';

package/dist/{components → client/components}/List/List.d.ts

@@ -4,7 +4,7 @@
  * 通用列表：items + renderItem + header/footer/empty 占位。
  * 定位：Table 大材小用的消息/文件/成员列表场景。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface ListProps<T = any> {
     items: T[];
     renderItem: (item: T, index: number) => any;

package/dist/{components → client/components}/Loading/Loading.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface LoadingProps {
     text?: string;
 }

package/dist/{components → client/components}/LogViewer/LogViewer.d.ts

@@ -5,7 +5,7 @@
  * 复用 VirtualList 滚动基座（useScrollPosition + rAF 节流）。
  * 裁剪（CS-05，见 design/components-cuts.md）：正则高亮、多日志源合并、搜索定位。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface LogViewerProps {
     lines: string[];
     /** 视口高度（px），默认 400 */

package/dist/{components → client/components}/Markdown/Markdown.d.ts

@@ -4,7 +4,7 @@
  * AI 回复/富文本渲染。安全子集解析 → VNode 渲染（天然转义，无 innerHTML 注入面）。
  * 与 CodeBlock 组合渲染代码围栏。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 import { type MdInline } from './parser.ts';
 export interface MarkdownProps {
     content: string;

package/dist/client/components/MarkdownEditor/MarkdownEditor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MarkdownEditor — 分屏 Markdown 编辑器（textarea + 实时预览）
+ *
+ * 复用 Markdown 组件 parser（同一渲染——预览与最终展示零漂移）。
+ * 受控纪律：value 受控 + 缺 onChange → warn（防静默不可用）。
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface MarkdownEditorProps {
+    value: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    /** 初始模式：'write' | 'preview' | 'split'（默认 split） */
+    mode?: 'write' | 'preview' | 'split';
+    rows?: number;
+    disabled?: boolean;
+    className?: string;
+}
+export declare const MarkdownEditor: Component<MarkdownEditorProps>;

package/dist/client/components/Math/Math.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Math — 轻量公式渲染（自研 LaTeX 子集——不引 KaTeX，零依赖）
+ *
+ * 支持子集：上下标（x^2, x_1）、分数（\frac{a}{b}）、根号（\sqrt{x}）、
+ * 希腊字母（\alpha \beta \pi）、求和（\sum_{i=1}^{n}）
+ * 裁剪边界（design/components-cuts.md）：完整 LaTeX 引擎是独立项目——
+ * 本组件覆盖教学/文档场景 80% 公式；复杂排版（矩阵/多行对齐）不渲染（诚实渲染原文）。
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface MathProps {
+    /** LaTeX 公式（如 'x^2 + \\frac{1}{2}'） */
+    tex: string;
+    className?: string;
+}
+export declare const Math: Component<MathProps>;

package/dist/{components → client/components}/Mentions/Mentions.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface MentionsOption {
     value: string;
     label?: string;

package/dist/{components → client/components}/Menu/Menu.d.ts

@@ -5,7 +5,7 @@
  * 用于 SaaS 应用侧边导航（替代手写 nav-item 循环）。
  * 裁剪（CS-05，见 design/components-cuts.md）：水平菜单栏（Menubar，独立组件）、子菜单自动互斥。折叠态子菜单浮层已实现（usePopup 基座）。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface MenuItem {
     key: string;
     label: any;

package/dist/{components → client/components}/Menubar/Menubar.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface MenubarItem {
     key: string;
     label: string;

package/dist/{components → client/components}/MessageBubble/MessageBubble.d.ts

@@ -6,7 +6,7 @@
  * content 支持文本或任意 VNode（可与 Markdown 组合）。
  * 裁剪（CS-05，见 design/components-cuts.md）：不做打字指示动画（Loading 已有）。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export type MessageBubbleRole = 'user' | 'assistant';
 export type MessageBubbleStatus = 'complete' | 'streaming' | 'error';
 export interface MessageBubbleProps {

package/dist/{components → client/components}/Modal/Modal.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components — Modal
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface ModalProps {
     open?: boolean;
     title?: string;

package/dist/{components → client/components}/NavMenu/NavMenu.d.ts

@@ -6,13 +6,13 @@
  *
  *   <NavMenu items={[{ key, label, children: [...] }]} activeKey onSelect />
  *
- * 弹层纪律（AGENTS.md）：子菜单/嵌套子菜单全部经 usePopup 组合器
+ * 弹层纪律（）：子菜单/嵌套子菜单全部经 usePopup 组合器
  * （createPortal + fixed + 视口夹紧 + Escape + 外部点击）——不 absolute 定位。
  *
  * 裁剪（CS-05，见 design/components-cuts.md）：不做 hover 延迟微调/子菜单动画曲线定制；
  * 折叠态交还 useBreakpoint 由用户驱动。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface NavMenuItem {
     key: string;
     label?: any;

package/dist/{components → client/components}/Notification/Notification.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export type NotificationType = 'success' | 'error' | 'info' | 'warning';
 export type NotificationPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
 export interface NotificationItem {
@@ -27,7 +27,12 @@ export interface NotificationOptions {
     duration?: number;
     max?: number;
 }
-/** 通知（对应 antd/EP Notification 队列式）：title + description + icon + 操作，聚合角落 */
+/** 命令式入口（对齐 antd notification.open 风格——可调用可链式） */
+export declare const notification: NotificationInjected['notification'];
+/**
+ * 命令式中间件：注入 ctx.notification()（AppMiddleware 形态——应用装配）
+ */
+export declare function notificationMiddleware<C extends Record<string, unknown>>(ctx: C): C & NotificationInjected;
 export declare const Notification: Component<NotificationProps>;
 export interface NotificationInjected {
     notification: {

package/dist/{components → client/components}/PageHeader/PageHeader.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface PageHeaderProps {
     title: string;
     sub?: string;

package/dist/{components → client/components}/Pagination/Pagination.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface PaginationProps {
     total: number;
     page?: number;

package/dist/{components → client/components}/PasswordInput/PasswordInput.d.ts

@@ -3,7 +3,7 @@
  *
  * 密码输入：眼睛按钮切换可见性。Input 子集（label/error/hint/required/autoComplete 透传）。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface PasswordInputProps {
     value?: string;
     onInput?: (e: Event) => void;

package/dist/{components → client/components}/PinInput/PinInput.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface PinInputProps {
     /** 位数，默认 6 */
     length?: number;

package/dist/{components → client/components}/Pipeline/Pipeline.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export type NodeStatus = 'default' | 'success' | 'running' | 'error' | 'pending';
 export interface PipelineNode {
     id: string;

package/dist/{components → client/components}/Popconfirm/Popconfirm.d.ts

@@ -13,8 +13,8 @@
  * - 确认后自动关闭（onConfirm 后 setOpen(false)）
  * - 裁剪（CS-05，见 design/components-cuts.md）：不做气泡内表单/自定义箭头
  */
-import type { Component } from '../../ui-dom/vnode.ts';
-import type { Placement } from '../../ui-dom/popup.ts';
+import type { Component } from '../../vdom/index.ts';
+import type { Placement } from '../../vdom/hooks/popup.ts';
 export interface PopconfirmProps {
     title?: any;
     okText?: string;

package/dist/{components → client/components}/Popover/Popover.d.ts

@@ -1,11 +1,12 @@
 /**
  * weifuwu/components — Popover
  *
- * usePopup 组合器：click/hover 双触发（hover 触屏自动降级 tap）+ 受控 open +
- * 外部点击（document 级，取代原 overlay）+ 定位/视口 clamp + Escape + portal。
+ * 命令式弹窗（一个形态——ctx.ui.openPopup——toast 心智）：click/hover 双触发
+ * （hover 触屏自动降级 tap）+ 受控 open + 外部点击（document 级，取代原 overlay）
+ * + 定位/视口 clamp + Escape。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
-import type { Placement } from '../../ui-dom/popup.ts';
+import type { Component } from '../../vdom/index.ts';
+import type { Placement } from '../../vdom/hooks/popup.ts';
 export type PopoverPosition = Placement;
 export interface PopoverProps {
     content?: any;

package/dist/{components → client/components}/ProgressBar/ProgressBar.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface ProgressBarProps {
     /** 进度值；undefined = indeterminate（不确定态，动画扫动） */
     value?: number;

package/dist/client/components/PromptTemplate/PromptTemplate.d.ts

@@ -0,0 +1,37 @@
+/**
+ * weifuwu/components — PromptTemplate 提示词模板编辑器（AI 场景）
+ *
+ * agent-platform 类应用的提示词管理痛点：变量占位 `{{var}}` 记忆/拼写错误 +
+ * 填充结果不可见。组件提供：
+ *   ① 变量 chips（点击在光标处插入 `{{name}}`——不记变量名）
+ *   ② 模板编辑（受控 textarea）
+ *   ③ 实时预览（填充 values 后的最终提示词）
+ *
+ * 纪律：
+ * - 受控输入纪律（§5.3）：value 由父控制 + onChange 通知（组件不持输入态）
+ * - 插入走 textarea selectionStart（光标处插入——无光标则末尾追加）
+ * - 预览替换只认 `{{name}}` 精确匹配；values 缺失的变量保持占位（诚实可见）
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface PromptTemplateVariable {
+    /** 变量名（插入后为 {{name}}） */
+    name: string;
+    /** 描述（chips 悬停提示） */
+    description?: string;
+}
+export interface PromptTemplateProps {
+    /** 模板文本（受控） */
+    value?: string;
+    onChange?: (value: string) => void;
+    /** 变量定义（chips 行——点击插入） */
+    variables?: PromptTemplateVariable[];
+    /** 变量值（预览填充用——缺失的变量保持占位） */
+    values?: Record<string, string>;
+    /** 只读（预览场景） */
+    readOnly?: boolean;
+    label?: string;
+    /** 预览区显示开关（默认开） */
+    showPreview?: boolean;
+    className?: string;
+}
+export declare const PromptTemplate: Component<PromptTemplateProps>;

package/dist/{components → client/components}/QRCode/QRCode.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 import type { QrEcLevel } from './qr.ts';
 export interface QRCodeProps {
     /** 二维码内容（URL/文本） */

package/dist/{components → client/components}/RadioGroup/RadioGroup.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface RadioOption {
     value: string;
     label: string;

package/dist/{components → client/components}/Rate/Rate.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface RateProps {
     /** 当前评分值（0..count） */
     value?: number;

package/dist/{components → client/components}/ReasoningBlock/ReasoningBlock.d.ts

@@ -1,5 +1,5 @@
-import type { Component } from '../../ui-dom/vnode.ts';
-import type { WfuiContext } from '../../ui-dom/types.ts';
+import type { Component } from '../../vdom/index.ts';
+import type { UIContext } from '../../vdom/index.ts';
 /**
  * ReasoningBlock — CoT 推理过程折叠展示（AI 差异化）
  *
@@ -22,4 +22,4 @@ export interface ReasoningBlockProps {
     /** 流式中（头部脉冲指示） */
     streaming?: boolean;
 }
-export declare const ReasoningBlock: Component<ReasoningBlockProps, WfuiContext>;
+export declare const ReasoningBlock: Component<ReasoningBlockProps, UIContext>;