@wenle_2523097/agri-map 2.0.1 → 2.0.2

package/dist/tests/setup/antd-mock.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview 统一测试设置 - Ant Design Mock
+ * @description 提供 Ant Design 组件 mock，解决 message, Notification 等静态方法在测试环境的问题
+ */
+/**
+ * 创建 Ant Design message mock
+ */
+export declare function createMessageMock(): object;
+/**
+ * 创建 Ant Design Notification mock
+ */
+export declare function createNotificationMock(): object;
+/**
+ * 创建 Ant Design Modal mock
+ */
+export declare function createModalMock(): object;
+/**
+ * 创建 Ant Design message.mock
+ */
+export declare function getAntdMessageMock(): {
+    default: object;
+};
+/**
+ * 创建 Ant Design Notification mock
+ */
+export declare function getAntdNotificationMock(): object;
+/**
+ * 创建完整的 Ant Design mock
+ */
+export declare function createAntdMock(): object;
+/**
+ * 获取 Ant Design mock（用于 vi.mock）
+ */
+export declare function getAntdMock(): object;

package/dist/tests/setup/browser-mock.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview 统一测试设置 - Browser API Mock
+ * @description 提供浏览器 API mock，解决 performance.memory, getComputedStyle 等在测试环境不可用的问题
+ */
+/**
+ * 创建 performance API mock
+ */
+export declare function createPerformanceMock(): object;
+/**
+ * 创建 ResizeObserver mock
+ */
+export declare function createResizeObserverMock(): () => object;
+/**
+ * 创建 MutationObserver mock
+ */
+export declare function createMutationObserverMock(): () => object;
+/**
+ * 创建 IntersectionObserver mock
+ */
+export declare function createIntersectionObserverMock(): typeof IntersectionObserver;
+/**
+ * 创建 requestAnimationFrame mock
+ */
+export declare function createRequestAnimationFrameMock(): typeof requestAnimationFrame;
+/**
+ * 创建 getComputedStyle mock
+ */
+export declare function createGetComputedStyleMock(): import("vitest").Mock<() => {
+    getPropertyValue: import("vitest").Mock<() => string>;
+    display: string;
+    visibility: string;
+    opacity: string;
+    color: string;
+    backgroundColor: string;
+    fontSize: string;
+    lineHeight: string;
+    position: string;
+    top: string;
+    left: string;
+    width: string;
+    height: string;
+    margin: string;
+    padding: string;
+    border: string;
+}>;
+/**
+ * 设置所有浏览器 mock
+ */
+export declare function setupBrowserMocks(): void;
+/**
+ * 清理浏览器 mock
+ */
+export declare function cleanupBrowserMocks(): void;

package/dist/tests/setup/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview 统一测试设置入口
+ * @description 导出所有测试 mock 和辅助函数
+ *
+ * @usage
+ * 在测试文件顶部导入:
+ * import { setupLeafletMock, setupBrowserMocks } from '@/tests/setup';
+ *
+ * 或在 vite.config.ts 中全局设置
+ */
+export { createLeafletMock, getLeafletMock, resetLeafletMock } from './leaflet-mock';
+export { setupBrowserMocks, cleanupBrowserMocks, createPerformanceMock, createResizeObserverMock, createMutationObserverMock, createIntersectionObserverMock, createRequestAnimationFrameMock, createGetComputedStyleMock, } from './browser-mock';
+export { createAntdMock, getAntdMock, createMessageMock, createNotificationMock, createModalMock, } from './antd-mock';
+/**
+ * 初始化所有测试 mock
+ * 建议在 vite.config.ts 的 test.setupFiles 中调用
+ */
+export declare function setupAllMocks(): void;
+declare const _default: {
+    setupAllMocks: typeof setupAllMocks;
+};
+export default _default;

package/dist/tests/setup/leaflet-mock.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview 统一测试设置 - Leaflet Mock
+ * @description 提供完整的 Leaflet mock，解决测试中 L.DomUtil.create 等方法 undefined 的问题
+ */
+/**
+ * 创建完整的 Leaflet Map mock
+ */
+export declare function createMapMock(): object;
+/**
+ * 创建 Leaflet DomUtil mock
+ */
+export declare function createDomUtilMock(): object;
+/**
+ * 创建 Leaflet LatLng mock
+ */
+export declare function createLatLngMock(): object;
+/**
+ * 创建完整的 Leaflet mock
+ */
+export declare function createLeafletMock(): object;
+/**
+ * 获取默认的 Leaflet mock（用于 vi.mock）
+ */
+export declare function getLeafletMock(): object;
+/**
+ * 重置 Leaflet mock
+ */
+export declare function resetLeafletMock(): void;

package/dist/types/index.d.ts

@@ -27,3 +27,4 @@ export type { MapContentProps } from './config';
 export type { PlotLabelProps } from './plot';
 export type { PopupProps, PopupTrigger, PopupPlacement, PopupConfig, PopupState, PopupContextValue, } from './popup';
 export type { LeafletEventHandler, GeoJSONFeature, GeoJSONFeatureCollection, PartialPathOptions, MaybePromise, AnyFunction, DeepPartial, DeepRequired, DeepReadonly, NonNullable, UnwrapPromise, UnwrapArray, RefType, EventHandler, AsyncEventHandler, RenderFn, ComponentType, MaybeControlledProps, ControlledProps, UncontrolledProps, } from './utils';
+export type { DataSourceMixin, LoadingMixin, ViewControlMixin, AutoFitConfig, SelectableMixin, StyleMixin, InteractionMixin, LifecycleMixin, EditableMixin, EditModeConfig, ToolbarButton, ToolbarColor, ToolbarSize, } from './mixins';

package/dist/types/irrigation.d.ts

@@ -2,8 +2,7 @@
  * 灌溉渠相关类型定义
  */
 import type { Coordinate, PathOptions } from './basic';
-import type { ReactNode } from 'react';
-import type { LifecycleConfig } from './lifecycle';
+import type { DataSourceMixin, SelectableMixin, StyleMixin, LoadingMixin, LifecycleMixin, ViewControlMixin, InteractionMixin, EditableMixin } from './mixins';
 /**
  * 灌溉渠字段名映射
  * @description 自定义 dataSource 中数据的字段名
@@ -98,17 +97,9 @@ export interface IrrigationEvents {
 }
 /**
  * 灌溉渠组件属性
- * @description Irrigation 组件的 Props 定义
+ * @description Irrigation 组件的 Props 定义，使用 Mixin 组合重构
  */
-export interface IrrigationProps {
-    /** 灌溉渠数据数组 */
-    dataSource?: IrrigationData[] | Record<string, unknown>[];
-    /** 自定义数据字段名映射 */
-    fieldNames?: IrrigationFieldNames;
-    /** 点击灌溉渠时的回调 */
-    onClick?: (item: IrrigationData) => void;
-    /** 右键点击灌溉渠时的回调 */
-    onContextMenu?: (item: IrrigationData, event: L.LeafletMouseEvent) => void;
+export interface IrrigationProps extends DataSourceMixin<IrrigationData | Record<string, unknown>>, SelectableMixin<string | number>, StyleMixin<IrrigationData>, LoadingMixin, LifecycleMixin<'Irrigation'>, ViewControlMixin, InteractionMixin<IrrigationData>, EditableMixin<'create' | 'edit' | 'delete' | 'reverse'> {
     /**
      * 默认灌溉渠样式
      * @description undefined | null | false | {} 时使用默认配置 IRRIGATION_DEFAULT_PATH
@@ -119,70 +110,15 @@ export interface IrrigationProps {
      * @description undefined | null | false | {} 时使用默认配置 IRRIGATION_DEFAULT_SELECTED_PATH
      */
     selectedPath?: PathOptions | null | false;
-    /**
-     * 动态样式函数
-     * @description 根据灌溉渠数据动态返回样式，优先级：数据级 path > style 函数 > Props 级 path
-     */
-    style?: (data: IrrigationData) => PathOptions;
-    /** 编辑模式 */
-    editMode?: boolean | ('create' | 'edit' | 'delete' | 'reverse')[] | {
-        /** 启用的编辑按钮 */
-        enabled?: boolean | ('create' | 'edit' | 'delete' | 'reverse')[];
-        /** 自定义工具栏内容 */
-        toolbar?: ReactNode;
-        /** 内置按钮的统一颜色（支持预设色和自定义颜色如 #ff0000、rgba(255,0,0,0.5)） */
-        color?: 'default' | 'primary' | 'danger' | 'success' | 'warning' | 'error' | 'magenta' | 'volcano' | 'gold' | 'orange' | 'cyan' | 'geekblue' | 'purple' | string;
-        /** 内置按钮的统一尺寸（支持预设尺寸和自定义数字，单位 px） */
-        size?: 'large' | 'middle' | 'small' | number;
-    };
-    /** 新建灌溉渠回调 */
-    onCreate?: (result: IrrigationCreateResult) => void;
-    /** 编辑灌溉渠属性回调（点击编辑按钮时触发） */
-    onEdit?: (result: IrrigationEditPropertyParams) => void;
-    /** 重绘灌溉渠形状回调（重绘保存后触发） */
-    onRedraw?: (result: IrrigationEditResult) => void;
-    /** 删除灌溉渠回调 */
-    onDelete?: (result: IrrigationDeleteResult) => void;
-    /** 保存回调 */
-    onSave?: (result: {
-        mode: string;
-    } & (IrrigationCreateResult | IrrigationEditResult)) => void;
-    /** 选中变化回调 */
-    onSelect?: (id: string | number | null) => void;
     /** 反转流向回调 */
     onReverse?: (result: IrrigationReverseResult) => void;
-    /** 选中的灌溉渠 ID（受控模式） */
-    value?: string | number | null;
-    /** 默认选中的灌溉渠 ID（非受控模式） */
-    defaultValue?: string | number;
     /** 是否显示灌溉渠长度 */
     showDistance?: boolean;
     /**
      * 蚁行动画配置
      * @description 显示灌溉渠方向箭头动画
-     * @example
-     * ```tsx
-     * <Irrigation antPath />  // 全部显示
-     * <Irrigation antPath="selected" />  // 仅选中显示
-     * ```
      */
     antPath?: boolean | 'selected';
-    /** 是否显示编辑模式提示 */
-    showEditHint?: boolean;
-    /**
-     * 进出水口默认图标
-     * @description 所有渠道的进水口/出水口默认图标配置，可被数据项级 channel.inlet/outlet 覆盖。
-     * 不传时，有 channel.inlet/outlet 配置的渠道使用内置默认箭头图标。
-     * @example
-     * ```tsx
-     * <Irrigation
-     *   icons={{
-     *     inlet: { icon: 'pulse-green', iconSize: 32 },
-     *     outlet: { icon: 'pulse-orange', iconSize: 32 },
-     *   }}
-     * />
-     * ```
-     */
     /**
      * 进水口显示控制
      * @description true: 显示所有渠道进水口 | 'selected': 仅显示选中渠道进水口 | false: 不显示
@@ -196,64 +132,9 @@ export interface IrrigationProps {
      */
     outlet?: boolean | 'selected';
     /**
-     * 统一的声明式事件管理（类似 Ant Design Table 的 onRow）
-     * @description 返回一个事件回调对象，可按需绑定事件，支持基于数据项的条件化事件处理
-     * @param item - 当前灌溉渠数据
-     * @param index - 当前灌溉渠在数据源中的索引
-     * @returns IrrigationEvents 事件回调对象
-     * @example
-     * ```tsx
-     * <Irrigation
-     *   dataSource={channels}
-     *   onRow={(item, index) => ({
-     *     onClick: () => console.log('点击了', item.name),
-     *     onContextMenu: (item, e) => { e.originalEvent.preventDefault(); },
-     *   })}
-     * />
-     * ```
+     * 统一的声明式事件管理（替代 InteractionMixin 的 onClick/onContextMenu）
      */
     onRow?: (item: IrrigationData, index: number) => IrrigationEvents;
-    /**
-     * 是否显示加载状态
-     * @description 当为 true 时，在地图上显示加载动画覆盖层
-     * @default false
-     */
-    loading?: boolean;
-    /**
-     * 加载遮罩配置
-     * @description 自定义加载遮罩的样式
-     */
-    loadingMask?: {
-        /** 是否显示遮罩，默认 true */
-        enabled?: boolean;
-        /** 遮罩背景色，默认 'rgba(0, 0, 0, 0.5)' */
-        background?: string;
-        /** 遮罩层级，默认 1000 */
-        zIndex?: number;
-    };
-    /**
-     * 生命周期回调配置
-     * @description 管理组件的挂载、渲染、状态变化、卸载等生命周期节点
-     * @since 1.4.0
-     * @example
-     * ```tsx
-     * lifecycle={{
-     *   onBeforeMount: (data) => validateIrrigationData(data),
-     *   onFirstRender: (stats) => reportPerformance(stats),
-     *   onStateChange: (payload) => trackEditAction(payload),
-     *   onBeforeUnmount: () => saveDraft(),
-     * }}
-     * ```
-     */
-    lifecycle?: LifecycleConfig<'Irrigation'>;
-    /**
-     * 是否在首次加载数据后自动 fitBounds 适配地图视图
-     * @default false
-     */
-    autoFit?: boolean | {
-        maxZoom?: number;
-        padding?: number | [number, number];
-    };
     /**
      * 子组件
      * @description 用于嵌套 Popup 等子组件

package/dist/types/marker.d.ts

@@ -4,7 +4,7 @@
 import type { Coordinate } from './basic';
 import type { ReactNode } from 'react';
 import type { IconConfig, ClusterIconConfig } from './icon';
-import type { LifecycleConfig } from './lifecycle';
+import type { DataSourceMixin, SelectableMixin, StyleMixin, LoadingMixin, LifecycleMixin, ViewControlMixin, InteractionMixin, EditableMixin } from './mixins';
 export type { IconConfig } from './icon';
 export type { ClusterIconConfig } from './icon';
 /**
@@ -203,128 +203,27 @@ export interface MarkerDisplayModeConfig {
 export type MarkerClusterConfig = MarkerDisplayModeConfig;
 /**
  * 标注组件属性
- * @description Marker 组件的 Props 定义
+ * @description Marker 组件的 Props 定义，使用 Mixin 组合重构
  */
-export interface MarkerProps {
-    /** 标注数据数组 */
-    dataSource?: MarkerData[];
-    /** 字段名称映射，自定义 dataSource 中的字段名 */
-    fieldNames?: MarkerFieldNames;
-    /** 点击标注时的回调 */
-    onClick?: (item: MarkerData) => void;
-    /** 右键点击标注时的回调 */
-    onContextMenu?: (item: MarkerData, e: L.LeafletMouseEvent) => void;
+export interface MarkerProps extends DataSourceMixin<MarkerData>, SelectableMixin<string | number>, StyleMixin<MarkerData>, LoadingMixin, LifecycleMixin<'Marker'>, ViewControlMixin, InteractionMixin<MarkerData>, EditableMixin<'create' | 'edit' | 'move' | 'delete'> {
     /** 是否永久显示弹窗 */
     permanent?: boolean;
-    /**
-     * 动态样式函数
-     * @description 根据标注数据动态返回图标配置，优先级：数据级 icon > style 函数 > Props 级 icon
-     */
-    style?: (data: MarkerData) => IconConfig;
-    /**
-     * 默认图标配置
-     * @description 设置所有标注点的默认图标，优先级低于数据级 icon
-     */
+    /** 默认图标配置 */
     icon?: IconConfig;
-    /**
-     * 选中状态图标配置
-     * @description 设置标注点选中时的图标
-     */
+    /** 选中状态图标配置 */
     selectedIcon?: IconConfig;
-    /** 编辑模式 */
-    editMode?: boolean | ('create' | 'edit' | 'move' | 'delete')[] | MarkerEditModeConfig;
-    /** 新建标注回调 */
-    onCreate?: (result: MarkerCreateResult) => void;
-    /** 编辑标注回调（点击编辑按钮触发） */
-    onEdit?: (result: MarkerEditResult) => void;
-    /** 移动标注回调 */
+    /** 覆盖编辑模式回调：移动标注 */
     onMove?: (result: MarkerMoveResult) => void;
-    /** 删除标注回调 */
-    onDelete?: (result: MarkerDeleteResult) => void;
-    /** 保存回调 */
+    /** 覆盖保存回调类型 */
     onSave?: (result: {
         mode: string;
     } & (MarkerCreateResult | MarkerMoveResult)) => void;
-    /** 选中变化回调 */
-    onSelect?: (id: string | number | null) => void;
-    /** 选中的标注 ID（受控模式） */
-    value?: string | number | null;
-    /** 默认选中的标注 ID（非受控模式） */
-    defaultValue?: string | number;
-    /** 是否显示编辑模式提示，默认 false */
-    showEditHint?: boolean;
-    /** Marker 数据加载完成回调 */
-    onLoaded?: (data: MarkerData[]) => void;
-    /**
-     * 显示模式配置
-     * - true: 启用默认显示模式（聚合）
-     * - 对象: 自定义显示模式配置
-     * @description 启用后，在小缩放级别下将相近的标注点聚合为气泡显示
-     */
+    /** 显示模式配置 */
     displayMode?: boolean | MarkerDisplayModeConfig;
-    /**
-     * 聚合气泡点击回调
-     * @param count - 聚合内的标注点数量
-     * @param markers - 聚合内的标注数据数组
-     */
+    /** 聚合气泡点击回调 */
     onClusterClick?: (count: number, markers: MarkerData[]) => void;
-    /**
-     * 统一的声明式事件管理（类似 Ant Design Table 的 onRow）
-     * @description 返回一个事件回调对象，可按需绑定事件，支持基于数据项的条件化事件处理
-     * @param item - 当前标注数据
-     * @param index - 当前标注在数据源中的索引
-     * @returns MarkerEvents 事件回调对象
-     * @example
-     * ```tsx
-     * <Marker
-     *   dataSource={markers}
-     *   onRow={(item, index) => ({
-     *     onClick: () => console.log('点击了', item.title),
-     *     onContextMenu: (item, e) => { e.originalEvent.preventDefault(); },
-     *   })}
-     * />
-     * ```
-     */
+    /** 声明式事件管理（替代 InteractionMixin 的 onClick/onContextMenu） */
     onRow?: (item: MarkerData, index: number) => MarkerEvents;
-    /**
-     * 是否显示加载状态
-     * @description 当为 true 时，在标注点上显示加载动画覆盖层
-     * @default false
-     */
-    loading?: boolean;
-    /**
-     * 加载遮罩配置
-     * @description 自定义加载遮罩的样式
-     */
-    loadingMask?: {
-        /** 是否显示遮罩，默认 true */
-        enabled?: boolean;
-        /** 遮罩背景色，默认 'rgba(0, 0, 0, 0.5)' */
-        background?: string;
-        /** 遮罩层级，默认 1000 */
-        zIndex?: number;
-    };
-    /**
-     * 生命周期回调配置
-     * @description 管理组件的挂载、渲染、状态变化、卸载等生命周期节点
-     * @since 1.4.0
-     * @example
-     * ```tsx
-     * lifecycle={{
-     *   onBeforeMount: (data) => validateMarkerData(data),
-     *   onFirstRender: (stats) => reportPerformance(stats),
-     *   onStateChange: (payload) => trackEditAction(payload),
-     *   onBeforeUnmount: () => saveDraft(),
-     * }}
-     * ```
-     */
-    lifecycle?: LifecycleConfig<'Marker'>;
-    /**
-     * 是否在首次加载数据后自动 fitBounds 适配地图视图
-     * @default false
-     */
-    autoFit?: boolean | {
-        maxZoom?: number;
-        padding?: number | [number, number];
-    };
+    /** Marker 数据加载完成回调 */
+    onLoaded?: (data: MarkerData[]) => void;
 }

package/dist/types/mixins/DataSourceMixin.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview 数据源 Mixin
+ * @description 所有需要 dataSource 的组件共享此 Mixin
+ * @module types/mixins
+ */
+import type { Coordinate } from '../basic';
+/**
+ * 数据源 Mixin
+ * @description 提供统一的数据源和字段映射配置
+ * @example
+ * ```typescript
+ * interface MarkerProps extends DataSourceMixin<MarkerData> {
+ *   dataSource: MarkerData[];
+ *   fieldNames?: MarkerFieldNames;
+ * }
+ * ```
+ */
+export interface DataSourceMixin<T = unknown> {
+    /**
+     * 数据源数组
+     * @description 组件渲染所需的数据集合
+     */
+    dataSource?: T[];
+    /**
+     * 字段名映射
+     * @description 用于自定义 dataSource 中的字段名
+     */
+    fieldNames?: Record<string, string>;
+}
+/**
+ * 数据项必需字段
+ */
+export interface RequiredDataFields {
+    /** 唯一标识 */
+    id: string | number;
+}
+/**
+ * 带坐标的数据项
+ */
+export interface CoordinateDataItem extends RequiredDataFields {
+    /** 坐标位置 [纬度, 经度] */
+    position?: Coordinate;
+    /** 坐标点数组 */
+    points?: Coordinate[];
+}
+/**
+ * 数据验证结果
+ */
+export interface DataValidationResult<T> {
+    valid: boolean;
+    data?: T[];
+    errors?: {
+        index: number;
+        message: string;
+    }[];
+}

package/dist/types/mixins/EditableMixin.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @fileoverview 编辑模式 Mixin
+ * @description CRUD 操作支持
+ * @module types/mixins
+ */
+import type { ReactNode } from 'react';
+/**
+ * 工具栏颜色
+ */
+export type ToolbarColor = 'default' | 'primary' | 'danger' | 'warning' | 'success' | string;
+/**
+ * 工具栏尺寸
+ */
+export type ToolbarSize = 'large' | 'middle' | 'small' | number;
+/**
+ * 工具栏按钮
+ * @description 通用工具栏按钮配置
+ */
+export interface ToolbarButton<T extends string = string> {
+    /** 按钮操作类型 */
+    action: T;
+    /** 按钮文字 */
+    label: string;
+    /** 按钮图标 */
+    icon?: ReactNode;
+    /** 工具提示 */
+    tooltip?: string;
+    /** 按钮样式变体 */
+    variant?: 'default' | 'primary' | 'danger';
+    /** 按钮颜色 */
+    color?: ToolbarColor;
+    /** 是否需要选中项才能使用 */
+    needsSelection?: boolean;
+    /** 是否在编辑模式下显示 */
+    showInEdit?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+}
+/**
+ * 基础编辑模式配置
+ * @description 各组件编辑模式的公共结构
+ */
+export interface EditModeConfig {
+    /** 启用的编辑操作 */
+    enabled?: boolean | string[];
+    /** 自定义工具栏 */
+    toolbar?: ReactNode;
+    /** 工具栏颜色 */
+    color?: ToolbarColor;
+    /** 工具栏尺寸 */
+    size?: ToolbarSize;
+    /** 是否只显示图标 */
+    iconOnly?: boolean;
+}
+/**
+ * 编辑模式 Mixin
+ * @description 提供统一的编辑功能配置
+ * @example
+ * ```typescript
+ * // 使用字符串字面量类型
+ * interface MarkerProps extends EditableMixin<'create' | 'edit' | 'move' | 'delete'> {
+ *   editMode?: boolean | ('create' | 'edit' | 'move' | 'delete')[];
+ * }
+ *
+ * // 使用对象配置
+ * interface RoadProps extends EditableMixin<string> {
+ *   editMode?: EditModeConfig;
+ * }
+ * ```
+ */
+export interface EditableMixin<T extends string = string> {
+    /**
+     * 编辑模式
+     * @description
+     * - `false`: 禁用编辑
+     * - `true`: 启用全部编辑功能
+     * - `string[]`: 启用的特定编辑操作
+     * - `object`: 自定义编辑配置
+     */
+    editMode?: boolean | T[] | EditModeConfig;
+    /**
+     * 是否显示编辑提示
+     * @default false
+     */
+    showEditHint?: boolean;
+    /**
+     * 创建完成回调
+     * @param result - 创建结果
+     */
+    onCreate?: (result: any) => void;
+    /**
+     * 编辑完成回调
+     * @param result - 编辑结果
+     */
+    onEdit?: (result: any) => void;
+    /**
+     * 重绘完成回调（部分组件支持）
+     * @param result - 重绘结果
+     */
+    onRedraw?: (result: any) => void;
+    /**
+     * 删除确认回调
+     * @param result - 删除结果
+     */
+    onDelete?: (result: any) => void;
+    /**
+     * 保存完成回调
+     * @param result - 保存结果
+     */
+    onSave?: (result: any) => void;
+}
+/**
+ * 编辑操作类型
+ */
+export type EditAction = 'create' | 'edit' | 'move' | 'delete' | 'redraw' | 'clip' | 'reverse';
+/**
+ * 编辑结果基类
+ */
+export interface BaseEditResult {
+    /** 编辑操作类型 */
+    action: EditAction;
+    /** 操作的 ID */
+    id?: string | number;
+}

package/dist/types/mixins/InteractionMixin.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview 交互 Mixin
+ * @description 点击、右键等交互事件
+ * @module types/mixins
+ */
+/**
+ * 交互 Mixin
+ * @description 提供统一的交互事件处理
+ * @example
+ * ```typescript
+ * interface MarkerProps extends InteractionMixin<MarkerData> {
+ *   onClick?: (item: MarkerData) => void;
+ *   onContextMenu?: (item: MarkerData, e: any) => void;
+ * }
+ * ```
+ */
+export interface InteractionMixin<T = unknown> {
+    /**
+     * 点击事件回调
+     * @param item - 被点击的数据项
+     */
+    onClick?: (item: T) => void;
+    /**
+     * 右键点击事件回调
+     * @param item - 被点击的数据项
+     * @param e - 事件对象
+     */
+    onContextMenu?: (item: T, e: any) => void;
+}
+/**
+ * 行事件回调
+ * @description 鼠标悬停或移出时触发
+ * @param item - 数据项
+ * @param index - 数据项索引
+ */
+export type RowEventHandler<T = unknown> = (item: T, index: number) => void;
+/**
+ * 悬停事件参数
+ */
+export interface HoverEvent<T = unknown> {
+    item: T;
+    type: 'mouseover' | 'mouseout';
+}