weifuwu 0.85.0 → 0.87.0

package/dist/client/components/Editor/model/dom.d.ts

@@ -0,0 +1,27 @@
+/**
+ * weifuwu/components/Editor/model/dom — offset ↔ DOM 桥
+ *
+ * doc.text 的 offset 与 contentEditable DOM 的双向映射：
+ * - 文本节点：按 nodeValue.length 累加
+ * - 嵌入元素（IMG/TABLE/HR）：占位符 1 个 offset（与模型 embeds 对应）
+ * - **块级元素边界：计 1 个 \n**（模型段分隔——serialize 输出块标签，
+ *   \n 无 DOM 文本节点——不计数则 offset 偏 1（真实事故：AI 选区替换错位））
+ *
+ * 前提：DOM 内容 = serialize(doc) 的渲染（文本 + 嵌入 + 块结构对应）。
+ */
+/** 嵌入元素判定（与 html.ts EMBED_TAGS 一致） */
+export declare function isEmbedElement(el: Element): boolean;
+/** Range → 文档 offset（相对 root 内容起点） */
+export declare function rangeToOffsets(root: HTMLElement, range: Range): {
+    start: number;
+    end: number;
+};
+/** 当前选区 → offsets（编辑器内/无 DOM 时返回 null） */
+export declare function selectionOffsets(root: HTMLElement | null): {
+    start: number;
+    end: number;
+} | null;
+/** offset 区间 → Range（恢复选区；越界时 clamp 到内容末尾） */
+export declare function offsetsToRange(root: HTMLElement, start: number, end: number): Range | null;
+/** offsets → 选区（focus + 设置） */
+export declare function setSelectionOffsets(root: HTMLElement | null, start: number, end: number): void;

package/dist/client/components/Editor/model/history.d.ts

@@ -0,0 +1,21 @@
+/**
+ * weifuwu/components/Editor/model/history — undo/redo 栈（commit 粒度）
+ *
+ * 撤销粒度 = commit 粒度（AI 流式接受 = 1 个 commit = 1 个撤销步）。
+ * 栈本身只存事件——状态折叠由调用方（Editor 层）执行 applyEdit。
+ */
+import type { Commit } from './types.ts';
+export interface HistoryState {
+    undoStack: Commit[];
+    redoStack: Commit[];
+}
+export declare function createHistory(maxDepth?: number): HistoryState;
+/** 压入新 commit（清空 redo 栈——新分支；超深丢弃最旧） */
+export declare function pushCommit(h: HistoryState, commit: Commit, maxDepth?: number): void;
+/** 弹出 undo 栈顶（不动 redo——由调用方折叠后决定；返回 null = 无可撤销） */
+export declare function popUndo(h: HistoryState): Commit | null;
+/** 弹出 redo 栈顶（同时收回 undo——撤销后重做路径一致） */
+export declare function popRedo(h: HistoryState): Commit | null;
+export declare function canUndo(h: HistoryState): boolean;
+export declare function canRedo(h: HistoryState): boolean;
+export declare function clearHistory(h: HistoryState): void;

package/dist/client/components/Editor/model/html.d.ts

@@ -0,0 +1,16 @@
+/**
+ * weifuwu/components/Editor/model/html — HTML ⇄ DocState 序列化
+ *
+ * 只认 Editor 格式子集（诚实裁剪）：p/div/h1-3/blockquote/ul/ol（块）、
+ * b/strong/i/em/u/a（内联）、img/table/hr（embed 快照——内部不解析）、
+ * text-align（inline style 或 wf-text-* class）。未知标签降级取文本。
+ *
+ * parse 需要 DOM（DOMParser）——浏览器环境全局可用；测试注入 jsdom document。
+ */
+import type { DocState } from './types.ts';
+/** HTML → DocState（doc 可注入——jsdom 测试；浏览器默认全局） */
+export declare function parseHtml(html: string, doc?: Document): DocState;
+/** DocState → HTML（块标签 + 对齐 + marks + embeds；相邻 ul/ol 段合并列表） */
+export declare function serializeHtml(doc: DocState): string;
+/** 往返幂等校验辅助：parse → serialize → parse 不再变化 */
+export declare function normalizeHtml(html: string, doc?: Document): string;

package/dist/client/components/Editor/model/inverse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * weifuwu/components/Editor/model/inverse — 事件逆操作（undo 基元）
+ *
+ * 任意事件 → 逆事件（与 vdom3 events.ts inverse() 同构）。不变量：
+ * applyEdit(applyEdit(doc, ev), inverseEdit(ev)) === doc。
+ */
+import type { DocState, EditEvent, EmbedSpan } from './types.ts';
+import { EMBED_CHAR } from './types.ts';
+/** 逆操作可能产生多个事件（text-delete 覆盖 embed → 恢复条目需补 embed-insert） */
+export type InverseResult = EditEvent | EditEvent[];
+/**
+ * 逆操作（undo 审计/验证用——生产 undo 走 commit 快照）。
+ * doc 可选：text-insert/ai-apply 的逆需要操作后文档提取区间内段属性
+ * （text-delete 校验要求——无 doc 时跳过（不精确——仅审计场景））。
+ */
+export declare function inverseEdit(ev: EditEvent, doc?: DocState): InverseResult;
+/** commit 的逆（事件逆序 + 各自逆操作展开——undo 应用顺序） */
+export declare function inverseCommit(events: EditEvent[]): EditEvent[];
+export { EMBED_CHAR };
+export type { EmbedSpan };

package/dist/client/components/Editor/model/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * weifuwu/components/Editor/model — 文档模型（事件流底座）
+ *
+ * 核心不变量（design/editor-events-plan.md）：文档状态 = fold(edit 事件流)。
+ * 本文档模型是纯 TS 数据结构 + 纯函数（无 DOM、无 UI）——阶段 0 验收：
+ * 折叠不变量（fuzz）/ 逆操作 / HTML 往返。
+ *
+ * 模型设计：
+ * - text 为全文纯文本，`\n` 为段落分隔符（offset 连续——选区/diff/提示词天然）
+ * - blockProps：非默认块属性（按段起点 offset 记录；段结构由 text 派生）
+ * - marks：内联格式区间（左闭右开；b/i/u/link 可重叠）
+ * - embeds：img/table/hr 用占位符 `\uFFFC` 占 1 个字符位（标准对象替换字符）
+ */
+/** 块类型（p 为默认——不记录） */
+export type BlockKind = 'p' | 'h1' | 'h2' | 'h3' | 'ul' | 'ol' | 'quote';
+export type Align = 'left' | 'center' | 'right';
+export type MarkType = 'b' | 'i' | 'u' | 'link';
+/** 非默认块属性（段起点 offset → 块格式） */
+export interface BlockProp {
+    start: number;
+    kind: BlockKind;
+    align?: Align;
+}
+/** 内联格式区间 */
+export interface MarkSpan {
+    start: number;
+    end: number;
+    type: MarkType;
+    href?: string;
+}
+/** 嵌入（占位符 \uFFFC 占据 text 1 字符位；id 唯一——删除按 id 精确匹配） */
+export interface EmbedSpan {
+    id: string;
+    at: number;
+    type: 'img' | 'table' | 'hr' | 'pre';
+    html: string;
+}
+/** 文档状态（不可变——applyEdit 返回新对象；undo/redo 快照对比免费） */
+export interface DocState {
+    text: string;
+    blockProps: BlockProp[];
+    marks: MarkSpan[];
+    embeds: EmbedSpan[];
+}
+export declare const EMPTY_DOC: DocState;
+/** 嵌入占位符（OBJECT REPLACEMENT CHARACTER——业界标准） */
+export declare const EMBED_CHAR = "\uFFFC";
+export type EditEvent = {
+    type: 'text-insert';
+    at: number;
+    text: string;
+} | {
+    type: 'text-delete';
+    at: number;
+    len: number;
+    removed: string;
+    removedEmbeds: EmbedSpan[];
+    /** 被完整删除的段属性（起点在区间内）——逆操作恢复段格式（合并段继承丢失） */
+    removedBlocks: BlockProp[];
+} | {
+    type: 'mark-apply';
+    start: number;
+    end: number;
+    mark: MarkType;
+    on: boolean;
+    href?: string;
+    prev: MarkSpan[];
+}
+/** 绝对恢复（mark 逆操作——区间表示不可逆，undo 用快照精确还原） */
+ | {
+    type: 'mark-restore';
+    mark: MarkType;
+    spans: MarkSpan[];
+    prev: MarkSpan[];
+} | {
+    type: 'block-set';
+    start: number;
+    kind: BlockKind;
+    align?: Align | null;
+    prev: BlockProp | null;
+} | {
+    type: 'embed-insert';
+    at: number;
+    embed: EmbedSpan;
+} | {
+    type: 'embed-delete';
+    at: number;
+    embed: EmbedSpan;
+}
+/** 快照式：AI 替换（original 由创建者提供——diff 面板直接读；原子撤销一步；
+ *  removedEmbeds/removedBlocks：区间内嵌入与被删段属性——逆操作恢复） */
+ | {
+    type: 'ai-apply';
+    start: number;
+    end: number;
+    original: string;
+    revised: string;
+    removedEmbeds: EmbedSpan[];
+    removedBlocks: BlockProp[];
+};
+/** 事务边界：N 个事件 = 1 个撤销步（AI 流式接受 = 1 个 commit）
+ *  before：操作前状态快照——undo 精确恢复（mark 区间表示不可逆——
+ *  收缩/合并后无法从逆事件还原；快照 + 重放混合：undo=恢复 before，
+ *  redo=从 before 重放 events——vdom3 remove 逆操作存快照同款先例） */
+export interface Commit {
+    label: string;
+    events: EditEvent[];
+    before: DocState;
+    /** 操作时间（历史面板显示；缺省 = 记录时） */
+    ts?: number;
+    /** 操作前光标（undo 恢复位置；可选——默认不恢复） */
+    caret?: {
+        start: number;
+        end: number;
+    };
+}

package/dist/client/components/Editor/tools/table.d.ts

@@ -0,0 +1,10 @@
+/**
+ * weifuwu/components/Editor/tools — 表格工具
+ *
+ * 事件流事务层（design/editor-events-plan.md 阶段 1）：表格 = embed 事件——
+ * 本模块只生成 HTML（不再操作 DOM/execCommand）。
+ */
+/** 生成表格 HTML（表头行加粗——模型 embed 快照） */
+export declare function tableHtml(rows: number, cols: number): string;
+/** 渲染 6×6 表格选择网格 */
+export declare function renderTableGrid(hoverRow: number, hoverCol: number, onSelect: (rows: number, cols: number) => void, onHover: (row: number, col: number) => void, onLeave: () => void): any;

package/dist/{components → client/components}/Editor/tools/toolbar.d.ts

@@ -1,9 +1,9 @@
 /**
  * weifuwu/components/Editor/tools — 工具栏渲染
  */
-import type { VNode } from '../../../ui-dom/vnode.ts';
+import type { VNode } from '../../../vdom/index.ts';
 import type { FormatState, ToolbarItem } from './types.ts';
 export declare const DEFAULT_TOOLBAR: ToolbarItem[];
 export declare const TOOLBAR_LABELS: Record<ToolbarItem, string>;
 export declare const TOOLBAR_TITLES: Record<ToolbarItem, string>;
-export declare function renderToolbar(items: ToolbarItem[], active: FormatState, isSource: boolean, onItem: (item: ToolbarItem) => void, customRender?: Record<string, (item: ToolbarItem) => VNode>): VNode;
+export declare function renderToolbar(items: ToolbarItem[], active: FormatState, isSource: boolean, onItem: (item: ToolbarItem, anchor?: HTMLElement | null) => void, customRender?: Record<string, (item: ToolbarItem) => VNode>, extra?: VNode[]): VNode;

package/dist/client/components/Editor/tools/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * weifuwu/components/Editor/tools — 类型定义
+ */
+export type ToolbarItem = 'bold' | 'italic' | 'underline' | 'h1' | 'h2' | 'h3' | 'ul' | 'ol' | 'blockquote' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'hr' | 'image' | 'table' | 'link' | 'clear' | 'source';
+export interface EditorProps {
+    value?: string;
+    onChange?: (html: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    minHeight?: string;
+    toolbar?: ToolbarItem[];
+    /** 图片上传回调 — 接收 File 返回图片 URL。不传时弹出 URL 输入框 */
+    onUpload?: (file: File) => Promise<string>;
+    /** AI 协作（可选——不传则无 AI 能力）：选区操作 → wf: 流式端点 → 建议浮层 →
+     *  接受 = edit:ai-apply commit（原子撤销一步） */
+    ai?: EditorAiOptions;
+    /** 草稿持久化 key（可选）：传入时内容自动保存/恢复（ctx.browser.storage*——
+     *  SSR 无害 no-op）。挂载时 value 为空且存在草稿 → 恢复草稿。 */
+    draftKey?: string;
+}
+/** AI 动作（选区文本 → 提示词 → 建议） */
+export interface EditorAiAction {
+    id: string;
+    /** 按钮标签（如 '润色'） */
+    label: string;
+    /** 提示词模板（选区文本注入 {selection} 由调用方替换） */
+    prompt: (ctx: {
+        selection: string;
+    }) => string;
+}
+export interface EditorAiOptions {
+    /** wf: SSE 端点（POST——协议 docs/ai-contract.md） */
+    url: string;
+    headers?: Record<string, string>;
+    /** 自定义动作（缺省 = 内置 5 个：润色/翻译/缩写/扩写/纠错） */
+    actions?: EditorAiAction[];
+    /** x:* 自定义事件透传 */
+    onEvent?: (name: string, data: unknown) => void;
+}
+export type FormatState = Record<string, boolean>;

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

@@ -1,4 +1,4 @@
-import type { Component, VNode } from '../../ui-dom/vnode.ts';
+import type { Component, VNode } from '../../vdom/index.ts';
 export interface EmptyStateProps {
     /** 图标——VNode（推荐 <Icon />）或字符串（emoji/字形）；默认 Icon inbox（P3：组件内禁裸 emoji） */
     icon?: string | VNode | null;

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

@@ -0,0 +1,30 @@
+/**
+ * ExportCSV — 数据导出 CSV（零依赖：纯函数 + ctx.browser.downloadFile）
+ *
+ * 用法：
+ *   exportCSV({ data: rows, filename: 'orders.csv', columns: [{ key, label }] })
+ *   <ExportCSV data={rows} filename="orders.csv">导出</ExportCSV>
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface CsvColumn {
+    key: string;
+    label?: string;
+}
+export interface ExportCsvOptions {
+    data: Record<string, any>[];
+    filename?: string;
+    columns?: CsvColumn[];
+    /** 值格式化（默认 String；null/undefined → 空） */
+    format?: (value: any, key: string) => string;
+}
+/** 纯函数：data → CSV 字符串（RFC 4180：引号转义 + BOM 防 Excel 乱码） */
+export declare function toCsv({ data, columns, format }: ExportCsvOptions): string;
+export interface ExportCSVProps extends ExportCsvOptions {
+    children?: any;
+    variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
+    size?: 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    className?: string;
+}
+/** 导出按钮组件（点击 → 下载 CSV——browser.downloadFile 安全适配） */
+export declare const ExportCSV: Component<ExportCSVProps>;

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * weifuwu/components/FilePreview — 文件预览（office/pdf/md/html/text）
+ *
+ * 架构（design/file-preview-plan.md）：
+ * - md 预览：复用 `<Markdown>` 组件（安全 token 渲染——表格/任务列表/URL 白名单）
+ * - md/text 编辑：复用 `<Editor>`（事件流事务层——撤销/时光机/AI 全继承）——
+ *   编辑闭环：md → markdownToHtml → Editor（DocState 模型）→ serializeMarkdown 回写
+ * - html 预览：iframe sandbox（安全隔离——untrusted HTML 不直插 DOM）
+ * - pdf/office：浏览器原生/服务端转换 URL（只读）
+ *
+ * 事件流：预览加载 `editEmit('preview')`（__edit_tail 可审计）；编辑 = Editor
+ * commit 事件流（同一时间线）。sandbox 集成：url 加载 + onSave 回写由消费方接。
+ */
+import type { Component } from '../../vdom/index.ts';
+import type { EditorAiOptions } from '../Editor/Editor.ts';
+export type FileType = 'md' | 'html' | 'pdf' | 'office' | 'text';
+/** 从文件名/URL 推断类型（type 未传时自动探测） */
+export declare function detectType(fileName?: string, url?: string): FileType;
+export interface FilePreviewProps {
+    /** 文件类型（缺省按 fileName/url 扩展名自动探测） */
+    type?: FileType;
+    /** md/html/text 内容（直接传入）；pdf/office 用 url */
+    content?: string;
+    /** pdf/office 文件 URL（或 html 远程加载） */
+    url?: string;
+    fileName?: string;
+    /** md/text：切换 Editor（复用事件流事务层——编辑/撤销/时光机/AI） */
+    editable?: boolean;
+    /** 编辑模式 AI 协作（透传 Editor） */
+    ai?: EditorAiOptions;
+    /** 编辑保存回调（md/text 序列化回写） */
+    onSave?: (content: string, type: 'md' | 'text') => void;
+    /** 加载完成（解析成功） */
+    onLoad?: (info: {
+        type: FileType;
+        chars: number;
+        blocks: number;
+    }) => void;
+    /** 内容高度 */
+    height?: string;
+}
+export declare const FilePreview: Component<FilePreviewProps>;

package/dist/client/components/FilePreview/markdown.d.ts

@@ -0,0 +1,23 @@
+/**
+ * weifuwu/components/FilePreview/markdown — Markdown 转换（编辑桥）
+ *
+ * 复用现有 Markdown 组件（src/components/Markdown/parser.ts——安全子集 token 树：
+ * 表格/任务列表/删除线/安全 URL 白名单——不重复造轮子）。
+ *
+ * 本模块只提供两个编辑桥转换：
+ * - markdownToHtml(md)：md → HTML 字符串（Editor 编辑入口——Editor 是 HTML 模型）
+ * - serializeMarkdown(doc)：DocState → md（编辑保存回写）
+ *
+ * 编辑闭环（事件流）：md → markdownToHtml → Editor（DocState 模型——撤销/时光机/
+ * AI 全继承）→ serializeMarkdown → 保存。
+ */
+import type { DocState } from '../Editor/model/types.ts';
+import { safeUrl, type MdBlock, type MdInline } from '../Markdown/parser.ts';
+/** md → HTML（Editor 模型子集内：标题/段落/引用/列表/代码块/分割线/图片——
+ *  表格/任务列表/删除线超出 Editor 模型——裁剪为段落（编辑时降级——诚实）） */
+export declare function markdownToHtml(md: string): string;
+/** DocState → Markdown（编辑保存回写——格式子集内语义等价）
+ *  块间空行分隔（md 规范）；相邻列表项单换行（保持列表连续） */
+export declare function serializeMarkdown(doc: DocState): string;
+export { safeUrl };
+export type { MdBlock, MdInline };

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;