weifuwu 0.85.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/client/components/Editor/Editor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * weifuwu/components/Editor — 富文本编辑器（事件流事务层，阶段 1）
+ *
+ * 架构（design/editor-events-plan.md）：文档 = fold(edit 事件流)。
+ * - 模型真相：DocState（contentEditable DOM 是渲染）
+ * - 语义操作（工具栏/快捷键）→ edit:commit（before 快照 + 事件）→ undo/redo 精确
+ * - 用户输入（键盘/IME/粘贴）暂由浏览器直写 DOM → onInput 同步回模型
+ *   （输入入流是阶段 2——阶段 1 撤销分流：语义操作走自建栈，输入退浏览器）
+ * - 受控 value 契约保留：onChange 发 serializeHtml(doc)
+ */
+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/client/components/Editor/edit-events.d.ts

@@ -0,0 +1,27 @@
+/**
+ * weifuwu/components/Editor/edit-events — 编辑事件流（第四端）
+ *
+ * 与 ai/sandbox 事件流同构（design/ai-events-plan.md / sandbox-events-plan.md）：
+ * 环形缓冲 + 查询（按动作过滤）+ 订阅 + 全局调试工具。
+ *
+ * 桥接（跨层一条链）：
+ * - vdom3 stream：每 commit 一条摘要（降频——细粒度事件只在本缓冲）
+ * - ai：edit:ai-apply 事件带 messageId 关联键（↔ ai 事件流 wf:token/done）
+ * - sandbox：source: 'sandbox' 的 commit 带 toolCallId（↔ sandbox exec 事件）
+ */
+export type EditAction = 'text-insert' | 'text-delete' | 'mark-apply' | 'block-set' | 'embed-insert' | 'embed-delete' | 'ai-apply' | 'ai-accept' | 'ai-reject' | 'commit' | 'undo' | 'redo' | 'clear' | 'preview' | 'office';
+export interface EditStreamEvent {
+    entity: 'edit';
+    action: EditAction;
+    ts: number;
+    target?: string;
+    payload?: Record<string, unknown>;
+}
+export declare function editEmit(action: EditAction, payload?: Record<string, unknown>, target?: string): void;
+/** 查询（倒序返回——最新在前；filter 按 action 过滤） */
+export declare function editEvents(n?: number, filter?: {
+    action?: EditAction | EditAction[];
+}): EditStreamEvent[];
+export declare function subscribeEditEvents(fn: (e: EditStreamEvent) => void): () => void;
+/** 测试隔离 */
+export declare function resetEditEvents(): void;

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

@@ -0,0 +1,23 @@
+/**
+ * weifuwu/components/Editor/model/apply — 事件应用（文档 = fold(事件流)）
+ *
+ * applyEdit(doc, ev) 纯函数：任意事件 → 新 DocState（不可变）。
+ * 所有 offset 平移在单一入口维护（marks/blockProps/embeds/caret 同步——
+ * 防止各路径各自修补的漂移）。段结构查找用二分（undo/redo 高频路径）。
+ */
+import type { DocState, EditEvent, BlockProp } from './types.ts';
+/** 所有段起点（升序；空文档 = [0]——单空段） */
+export declare function segmentStarts(text: string): number[];
+/** 最后一个 <= pos 的段起点（二分——O(log n)） */
+export declare function segmentStartAt(text: string, pos: number, starts?: number[]): number;
+/** 位置 pos 所属段的块属性（默认 p/null） */
+export declare function blockPropAt(doc: DocState, pos: number): BlockProp | null;
+export declare function applyEdit(doc: DocState, ev: EditEvent): DocState;
+/** 应用事件并记录实际效果（ai-apply 返回带 original 校验后的事件——供历史审计） */
+export declare function applyEditChecked(doc: DocState, ev: EditEvent): {
+    doc: DocState;
+    ev: EditEvent;
+};
+/** 删除区间内/边界段起点被覆盖的段属性（含边界——段起点恰在 at+len 时合并吞属性；
+ *  逆操作按原段起点恢复——文本恢复后起点仍有效，幂等安全） */
+export declare function removedBlocksOf(doc: DocState, at: number, end: number): BlockProp[];

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

@@ -0,0 +1,25 @@
+/**
+ * weifuwu/components/Editor/model/diff — 文本 diff（AI 建议对比用）
+ *
+ * 零依赖：公共前缀/后缀剪枝 + 中间 LCS（滚动数组 O(m) 空间）。
+ * 裁剪：总长度超 DIFF_MAX_LEN 退化为整体替换（诚实裁剪——大文本不追求
+ * 精细 diff，AI 选区级文本通常 < 4k）。
+ */
+export type DiffOp = {
+    type: 'equal';
+    text: string;
+} | {
+    type: 'insert';
+    text: string;
+} | {
+    type: 'delete';
+    text: string;
+};
+export declare const DIFF_MAX_LEN = 4000;
+/** a → b 的文本 diff（公共前后缀剪枝——编辑两端不动的场景零 DP） */
+export declare function textDiff(a: string, b: string): DiffOp[];
+/** diff 统计（AI 面板摘要：+N/-M） */
+export declare function diffStats(ops: DiffOp[]): {
+    added: number;
+    removed: number;
+};