weifuwu 0.86.0 → 0.87.0

package/dist/cli/home-flash.test.d.ts

@@ -0,0 +1 @@
+export {};

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * weifuwu/components — ActionSheet 动作面板（移动端底部滑出）
+ *
+ * 命令列表 + 取消按钮（iOS 风格）——移动端 App 常用弹层（照片选择/分享/
+ * 更多操作）。与 Modal/Drawer 同款会话级模态（usePopup presence 退场状态机 +
+ * 焦点 trap + 滚动锁）。
+ *
+ * 纪律：
+ * - 受控纪律（§5.2）：open 由父控制 + onClose 必须提供
+ * - 键盘：role=menu + menuitem，方向键上下移动 + Enter 选择 + Escape 关闭
+ * - 选择后自动关闭（onSelect(key) + onClose()）
+ * - 危险操作项 danger（--wf-color-error-text 语义文字色）
+ * - 图标走 Icon 组件（IconName）或任意 VNode
+ */
+import type { Component } from '../../vdom/index.ts';
+import type { IconName } from '../Icon/Icon.ts';
+export interface ActionSheetItem {
+    key: string;
+    label: string;
+    /** 图标：IconName（内置）或任意 VNode（业务自定义） */
+    icon?: IconName | any;
+    /** 危险操作（红色语义文字） */
+    danger?: boolean;
+    disabled?: boolean;
+}
+export interface ActionSheetProps {
+    open: boolean;
+    items: ActionSheetItem[];
+    /** 点击项回调（选择后组件自动关闭） */
+    onSelect?: (key: string) => void;
+    onClose: () => void;
+    /** 取消按钮文案（默认「取消」） */
+    cancelText?: string;
+    /** 可选标题（面板顶部） */
+    title?: string;
+}
+export declare const ActionSheet: Component<ActionSheetProps>;

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface AffixProps {
     /** 距视口顶部偏移，滚动超过该值后固定（px），默认 0 */
     offsetTop?: number;

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

@@ -18,9 +18,9 @@
  * return () => h(AiChat, { chat: $ })
  * ```
  */
-import type { Component } from '../../ui-dom/vnode.ts';
-import type { UseChatHandle, UiMessage } from '../../ui-dom/use-chat.ts';
-import type { WfError, WfUsage, WfApprovalRequest } from '../../ai/types.ts';
+import type { Component } from '../../vdom/index.ts';
+import type { ChatHandle as UseChatHandle, ChatMessage as UiMessage } from '../../vdom/hooks/chat.ts';
+import type { WfError, WfUsage, WfApprovalRequest } from '../../../server/ai/types.ts';
 import type { JsonSchema } from '../JsonSchemaForm/JsonSchemaForm.ts';
 export interface AiChatLabels {
     send: string;

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export type AlertVariant = 'info' | 'success' | 'warning' | 'error';
 export interface AlertProps {
     variant?: AlertVariant;

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

@@ -9,7 +9,7 @@
  * 裁剪（CS-05，见 design/components-cuts.md）：合并阈值固定 3 条起（少于此退化为平铺）；
  * 不做时间线分组/虚拟化。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface AlertGroupItem {
     id: string;
     message: any;

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

@@ -5,7 +5,7 @@
  * 滚动侦听：ctx.ui.useScrollPosition（全局/容器 scroll 监听 + rAF 节流，内置方案）。
  * 裁剪（CS-05，见 design/components-cuts.md）：嵌套滚动容器、滚动容器非视口（container 未提供时仅视口）、自动生成标题锚点。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface AnchorItem {
     href: string;
     title: any;

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

@@ -0,0 +1,55 @@
+/**
+ * weifuwu/components — AppShell
+ *
+ * 应用壳（SaaS 侧栏布局）：品牌区 + 导航菜单 + 用户区 + 主内容区——
+ * 认证守卫/导航/用户数据由父层驱动（受控——组件零 fetch 零路由依赖）。
+ *
+ * 来源：agent-platform AppLayout（侧栏壳——Menu/Avatar/Button 组装样板）
+ * 沉淀——每个 SPA 应用的重复样板：品牌 + 分组菜单 + 用户信息 + 设置/
+ * 退出操作 + 守卫加载态。样式复用 weifuwu/layout 的 app-shell 原语
+ * （wf-app-shell + wf-sidebar 系列 + wf-main——grid 栅格 + 移动端降级），
+ * 组件只补品牌区/用户区细节（AppShell.css）。
+ *
+ * 状态约定（父层驱动）：
+ * - nav/path：菜单数据与当前路由（activeKey 计算）
+ * - user：用户信息（null = 未登录——父层守卫跳登录）
+ * - onNavigate/onLogout/onSettings：回调上抛
+ * - loading：守卫加载态（骨架占位）
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface AppShellNavItem {
+    key: string;
+    label: string;
+    icon?: any;
+    group?: string;
+}
+export interface AppShellProps {
+    /** 导航菜单项（Menu items——key/label/icon/group） */
+    nav?: AppShellNavItem[];
+    /** 当前路由路径（activeKey 匹配——'/' 精确，其余前缀） */
+    path?: string;
+    /** 品牌区（name/subtitle/logo 文本） */
+    brand?: {
+        name?: string;
+        subtitle?: string;
+        logo?: string;
+    };
+    /** 用户信息（null = 未登录——父层守卫） */
+    user?: {
+        name?: string;
+        email?: string;
+    } | null;
+    /** 导航回调（菜单选择 → 父层 navigate） */
+    onNavigate?: (key: string) => void;
+    onLogout?: () => void;
+    onSettings?: () => void;
+    /** 守卫加载态（骨架占位——不渲染菜单/用户） */
+    loading?: boolean;
+    /** 主内容区 */
+    children?: any;
+    /** 自定义底部（覆盖用户区——高级场景） */
+    footer?: any;
+    /** 侧栏宽度（layout 变量——默认 240px） */
+    sidebarWidth?: string;
+}
+export declare const AppShell: Component<AppShellProps>;

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

@@ -1,6 +1,6 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 import { type JsonSchema } from '../JsonSchemaForm/JsonSchemaForm.ts';
-import type { WfApprovalRequest } from '../../ai/types.ts';
+import type { WfApprovalRequest } from '../../../server/ai/types.ts';
 /**
  * ApprovalCard — 人工审批卡片（wf: 协议 §4.5 交互原语）
  *

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface AspectRatioProps {
     /** 宽/高比，默认 16/9 */
     ratio?: number;

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

@@ -9,8 +9,8 @@
  *
  * 使用两阶段模型 + render-only。无状态（props 驱动）。
  */
-import type { Component, VNode } from '../../ui-dom/vnode.ts';
-import type { HookEnv } from '../../ui-dom/hooks/types.ts';
+import type { Component, VNode } from '../../vdom/index.ts';
+import type { HookEnv } from '../../vdom/hooks/env.ts';
 export interface AuthPageProps {
     /** 标题（如「登录」） */
     title: string;

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

@@ -13,7 +13,7 @@
  * 裁剪（CS-05，见 design/components-cuts.md）：不做分组/虚拟化候选（Select searchable 覆盖分组场景）；
  * 自定义渲染用 `renderOption` 透传。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface AutoCompleteOption {
     value: string;
     label?: any;

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

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

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

@@ -5,7 +5,7 @@
  * 用于群聊成员、协作人列表。
  * 裁剪（CS-05，见 design/components-cuts.md）：hover 展开 tooltip（Tooltip 可组合）。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 import { type AvatarProps } from '../Avatar/Avatar.ts';
 export interface AvatarGroupItem {
     name?: string;

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface BackTopProps {
     /** 滚动超过此高度显示（px），默认 400 */
     visibilityHeight?: number;

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'error';
 export interface BadgeProps {
     variant?: BadgeVariant;

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

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

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface ButtonProps {
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'danger-ghost';
     size?: 'sm' | 'md' | 'lg';

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface CalendarEvent {
     key: string;
     /** 日期 'YYYY-MM-DD' */

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface CardProps {
     variant?: 'default' | 'outlined';
     /** 便捷：outlined = variant 'outlined' */

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface CarouselProps {
     children: any[];
     /** 自动播放 */

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

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

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

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components — Chart
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 import type { DataPoint, ChartType, ChartOptions } from './chart-utils.ts';
 export type { DataPoint, ChartType, ChartOptions };
 export interface ChartProps {

package/dist/{components → client/components}/Chart/chart-utils.d.ts

@@ -3,7 +3,7 @@
  *
  * 无 DOM 依赖，可测试。
  */
-export type ChartType = 'line' | 'bar' | 'pie';
+export type ChartType = 'line' | 'bar' | 'pie' | 'radar' | 'gauge' | 'scatter';
 export interface DataPoint {
     label: string;
     value: number;
@@ -13,6 +13,10 @@ export interface ChartOptions {
     width?: number;
     height?: number;
     padding?: number;
+    /** gauge 最小值（默认 0） */
+    min?: number;
+    /** gauge 最大值（默认 100） */
+    max?: number;
 }
 export interface ScaleLinear {
     (v: number): number;

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

@@ -14,8 +14,8 @@
  *
  * 使用两阶段模型 + render-only。状态：内部 keyword（useControlledInput Map 缓存）。
  */
-import type { Component, VNode } from '../../ui-dom/vnode.ts';
-import type { V3Ui } from '../../ui-dom/vdom3/types.ts';
+import type { Component, VNode } from '../../vdom/index.ts';
+import type { Ui } from '../../vdom/index.ts';
 export interface ChatInputLabels {
     send: string;
     stop: string;
@@ -45,10 +45,10 @@ export interface ChatInputProps {
     labels?: Partial<ChatInputLabels>;
     /** 扩展位（附件/知识库/模型选择等） */
     actions?: VNode | null;
-    /** 外部程序化控制（@ 补全等场景）——mount 后写入 { setKeyword, setValue } */
-    control?: {
-        current: ChatInputControl | null;
-    };
+    /** 外部程序化控制（@ 补全等场景）——mount 期回调上抛稳定 handle（{ setKeyword, setValue }）——
+     *  回调必须 mount 层定义（稳定引用——vdom3 props 剪枝）；禁止 out-param 对象（props 不可变契约——
+     *  原地写 control.current 触发 vdom3 audit） */
+    onControl?: (handle: ChatInputControl) => void;
 }
 export interface ChatInputControl {
     /** 直接写内部输入态（不触发 onChange——程序化改写如 @ 补全） */
@@ -57,5 +57,5 @@ export interface ChatInputControl {
     setValue: (v: string) => void;
 }
 export declare const ChatInput: Component<ChatInputProps, {
-    ui: V3Ui;
+    ui: Ui;
 }>;

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

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

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

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

package/dist/{components → client/components}/CitationCard/CitationCard.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';
 /**
  * CitationCard — RAG 检索引用展示（AI 差异化）
  *
@@ -35,4 +35,4 @@ export interface CitationCardProps {
     /** 点击条目回调（提供时不渲染链接，由调用方处理跳转/打开） */
     onOpen?: (citation: Citation) => void;
 }
-export declare const CitationCard: Component<CitationCardProps, WfuiContext>;
+export declare const CitationCard: Component<CitationCardProps, UIContext>;

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

@@ -5,7 +5,7 @@
  * （highlight.ts tokenizer——零依赖 FS-05）。
  * 由 Markdown 代码围栏复用；也可独立使用。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface CodeBlockProps {
     code: string;
     lang?: string;

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

@@ -0,0 +1,18 @@
+/**
+ * CodeEditor — 轻量代码编辑器（textarea + 行号——零依赖自研，不引 Monaco）
+ *
+ * 定位：配置/模板/脚本类轻编辑（非 IDE 级）——需要完整 IDE 体验的场景
+ * 是裁剪边界（Monaco 600KB+ 违背零依赖哲学——design/components-cuts.md 登记）。
+ * 受控纪律：value 受控 + 缺 onChange → warn。
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface CodeEditorProps {
+    value: string;
+    onChange?: (value: string) => void;
+    lang?: 'ts' | 'tsx' | 'js' | 'css' | 'json' | 'md' | 'text';
+    rows?: number;
+    readOnly?: boolean;
+    placeholder?: string;
+    className?: string;
+}
+export declare const CodeEditor: Component<CodeEditorProps>;

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

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

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface ColorPickerProps {
     /** 受控颜色值（hex，如 #4f6ef7） */
     value?: string;

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

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

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

@@ -4,7 +4,7 @@
  * 声明式：基于 Modal 封装，footer 自带「取消 / 确定」按钮。
  * 命令式：confirm() 中间件注入 ctx.confirm()，返回 Promise<boolean>。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface ConfirmProps {
     open?: boolean;
     title?: string;
@@ -35,10 +35,5 @@ export interface ConfirmOptions {
 export interface ConfirmInjected {
     confirm: (message: string, options?: ConfirmOptions) => Promise<boolean>;
 }
-/**
- * 命令式中间件：注入 ctx.confirm()
- *
- * 每次调用挂载 Confirm 组件到独立容器（mountVNode），
- * resolve 后 callRefCleanup 清理（含 Modal 的 portal DOM）+ 移除容器。
- */
+export declare function confirm(message: string, options?: ConfirmOptions): Promise<boolean>;
 export declare const Confirm: Component<ConfirmProps>;

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

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

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface CopyButtonProps {
     /** 要复制的文本 */
     value: string;

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

@@ -4,9 +4,9 @@
  * 四合一日期选择器，支持 mode: date | datetime | time | range
  * 统一 usePopup：focus 触发 + mask 遮罩 + 自由定位（left 对齐 + width 跟随 trigger）。
  *
- * 状态管理：闭包变量 + ctx.ui.render()
+ * 状态管理：闭包变量 + ctx.render()
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export type DatePickerMode = 'date' | 'datetime' | 'time' | 'range';
 export interface DatePickerProps {
     mode?: DatePickerMode;

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

@@ -4,7 +4,7 @@
  * 详情字段展示：label/value 栅格（<dl> 语义结构，屏幕阅读器友好）。
  * 用于 Agent 配置展示、实体详情、订单信息等只读字段场景。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface DescriptionItem {
     label: any;
     value: any;

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface DiffViewProps {
     /** 旧代码 */
     oldCode: string;

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

@@ -1,4 +1,4 @@
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface DividerProps {
     vertical?: boolean;
     children?: any;

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

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components — Drawer
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export type DrawerPosition = 'left' | 'right';
 export interface DrawerProps {
     open?: boolean;

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

@@ -4,7 +4,7 @@
  * usePopup 组合器：click 触发 + 受控 open + 外部点击/Escape（document 级，
  * 弹层在 portal 中按 Escape 也能关）+ 定位/视口 clamp + portal。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 export interface DropdownItem {
     label: string;
     value?: string;

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

@@ -8,7 +8,7 @@
  *   （输入入流是阶段 2——阶段 1 撤销分流：语义操作走自建栈，输入退浏览器）
  * - 受控 value 契约保留：onChange 发 serializeHtml(doc)
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 import type { EditorProps } from './tools/types.ts';
 export type { EditorProps, ToolbarItem, EditorAiAction, EditorAiOptions } from './tools/types.ts';
 export declare const Editor: Component<EditorProps>;

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

@@ -1,7 +1,7 @@
 /**
  * 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>;

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/{components → client/components}/FilePreview/FilePreview.d.ts

@@ -11,7 +11,7 @@
  * 事件流：预览加载 `editEmit('preview')`（__edit_tail 可审计）；编辑 = Editor
  * commit 事件流（同一时间线）。sandbox 集成：url 加载 + onSave 回写由消费方接。
  */
-import type { Component } from '../../ui-dom/vnode.ts';
+import type { Component } from '../../vdom/index.ts';
 import type { EditorAiOptions } from '../Editor/Editor.ts';
 export type FileType = 'md' | 'html' | 'pdf' | 'office' | 'text';
 /** 从文件名/URL 推断类型（type 未传时自动探测） */