@wenle_2523097/agri-map 2.0.1 → 2.0.2

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

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview 生命周期 Mixin
+ * @description 统一的组件生命周期回调
+ * @module types/mixins
+ */
+import type { AgriculturalComponentType, LifecycleConfig } from '../lifecycle';
+/**
+ * 生命周期 Mixin
+ * @description 提供统一的生命周期回调配置
+ * @example
+ * ```typescript
+ * interface MarkerProps extends LifecycleMixin<'Marker'> {
+ *   lifecycle?: LifecycleConfig<'Marker'>;
+ * }
+ * ```
+ */
+export interface LifecycleMixin<T extends AgriculturalComponentType = AgriculturalComponentType> {
+    /**
+     * 生命周期回调配置
+     * @description 组件挂载、渲染、卸载等关键节点的回调
+     */
+    lifecycle?: LifecycleConfig<T>;
+}

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

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview 加载状态 Mixin
+ * @description 统一的加载状态和遮罩配置
+ * @module types/mixins
+ */
+/**
+ * 加载遮罩配置
+ * @description 统一的加载遮罩层配置
+ */
+export interface LoadingMaskConfig {
+    /** 是否启用遮罩 */
+    enabled?: boolean;
+    /** 遮罩背景色 */
+    background?: string;
+    /** 遮罩层级 */
+    zIndex?: number;
+}
+/**
+ * 加载状态 Mixin
+ * @description 提供统一的加载状态控制
+ * @example
+ * ```typescript
+ * interface MarkerProps extends LoadingMixin {
+ *   loading?: boolean;
+ *   loadingMask?: LoadingMaskConfig;
+ * }
+ * ```
+ */
+export interface LoadingMixin {
+    /**
+     * 是否显示加载状态
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * 加载遮罩配置
+     * @description 自定义加载遮罩的样式和行为
+     */
+    loadingMask?: LoadingMaskConfig;
+}
+/**
+ * 加载图标名称
+ */
+export type LoadingIconName = 'loading-spinner' | 'loading-circle' | 'loading bars' | 'loading bars' | 'spinning' | 'spinning (SLOW)';

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

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview 选择 Mixin
+ * @description 支持单选/多选，受控/非受控模式
+ * @module types/mixins
+ */
+/**
+ * 选择模式
+ */
+export type SelectionMode = 'single' | 'multiple';
+/**
+ * 选择 Mixin
+ * @description 提供统一的选择状态管理
+ * @example
+ * ```typescript
+ * // 单选
+ * interface MarkerProps extends SelectableMixin<string | number> {
+ *   value?: string | number | null;
+ *   onSelect?: (id: string | number | null) => void;
+ * }
+ *
+ * // 多选
+ * interface PlotLayerProps extends SelectableMixin<string | number | (string | number)[]> {
+ *   value?: (string | number)[];
+ *   onSelect?: (ids: (string | number)[], plotId?: string | number) => void;
+ * }
+ * ```
+ */
+export interface SelectableMixin<T = string | number> {
+    /**
+     * 当前选中的值（受控模式）
+     * @description 当需要完全控制选择状态时使用
+     */
+    value?: T | null;
+    /**
+     * 默认选中的值（非受控模式）
+     * @description 组件内部管理状态，仅在首次渲染时使用
+     */
+    defaultValue?: T;
+    /**
+     * 选择变化时的回调
+     * @param id - 被选中或取消选中的 ID（单选），或 null（取消选中）
+     */
+    onSelect?: (id: T | null) => void;
+}
+/**
+ * 选择变化事件参数
+ */
+export interface SelectChangeEvent<T> {
+    value: T;
+    previousValue: T;
+    source: 'user' | 'programmatic';
+}

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

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview 样式 Mixin
+ * @description 动态样式支持
+ * @module types/mixins
+ */
+import type { PathOptions } from '../basic';
+/**
+ * 样式 Mixin
+ * @description 提供统一的样式配置
+ * @example
+ * ```typescript
+ * interface RoadProps extends StyleMixin<RoadData> {
+ *   style?: (data: RoadData) => PathOptions;
+ *   path?: PathOptions | null | false;
+ *   selectedPath?: PathOptions | null | false;
+ * }
+ * ```
+ */
+export interface StyleMixin<T = unknown> {
+    /**
+     * 动态样式函数
+     * @description 根据数据项动态返回样式配置，优先级最高
+     * @param data - 数据项
+     * @returns 样式配置
+     */
+    style?: (data: T) => PathOptions;
+    /**
+     * 默认路径样式
+     * @description
+     * - `undefined | null | false`: 使用默认样式
+     * - `object`: 使用自定义样式
+     */
+    path?: PathOptions | null | false;
+    /**
+     * 选中状态的路径样式
+     * @description
+     * - `undefined | null | false`: 使用默认选中样式
+     * - `object`: 使用自定义选中样式
+     */
+    selectedPath?: PathOptions | null | false;
+}
+/**
+ * 样式覆盖优先级
+ * 1. 数据级样式（data.options.path）
+ * 2. style 函数返回的样式
+ * 3. Props 级 path/selectedPath
+ * 4. 组件默认样式
+ */
+export type StylePriority = 'data' | 'function' | 'props' | 'default';

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

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview 视图控制 Mixin
+ * @description 统一的地图视图控制配置
+ * @module types/mixins
+ */
+/**
+ * 自动适应边界配置
+ * @description 配置地图自动适应边界的参数
+ */
+export interface AutoFitConfig {
+    /** 最大缩放级别 */
+    maxZoom?: number;
+    /** 内边距 */
+    padding?: number | [number, number];
+}
+/**
+ * 视图控制 Mixin
+ * @description 提供统一的地图视图控制
+ * @example
+ * ```typescript
+ * interface MarkerProps extends ViewControlMixin {
+ *   autoFit?: boolean | AutoFitConfig;
+ * }
+ * ```
+ */
+export interface ViewControlMixin {
+    /**
+     * 是否在首次加载数据后自动适应边界
+     * @description
+     * - `true`: 启用，使用默认配置
+     * - `false`: 禁用（默认）
+     * - `object`: 自定义配置
+     * @default false
+     */
+    autoFit?: boolean | AutoFitConfig;
+}

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

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Mixin 接口统一导出
+ * @description 导出所有 Mixin 接口，供组件类型组合使用
+ * @module types/mixins
+ */
+export type { DataSourceMixin, RequiredDataFields, CoordinateDataItem, DataValidationResult, } from './DataSourceMixin';
+export type { LoadingMixin, LoadingMaskConfig, LoadingIconName } from './LoadingMixin';
+export type { ViewControlMixin, AutoFitConfig } from './ViewControlMixin';
+export type { SelectableMixin, SelectionMode, SelectChangeEvent } from './SelectableMixin';
+export type { StyleMixin, StylePriority } from './StyleMixin';
+export type { InteractionMixin, RowEventHandler, HoverEvent } from './InteractionMixin';
+export type { LifecycleMixin } from './LifecycleMixin';
+export type { EditableMixin, EditModeConfig, ToolbarButton, ToolbarColor, ToolbarSize, EditAction, BaseEditResult, } from './EditableMixin';

package/dist/types/plot.d.ts

@@ -5,6 +5,7 @@ import type React from 'react';
 import type L from 'leaflet';
 import type { Coordinate, PathOptions } from './basic';
 import type { LifecycleConfig } from './lifecycle';
+import type { DataSourceMixin, StyleMixin, LoadingMixin, LifecycleMixin, ViewControlMixin, InteractionMixin, EditableMixin } from './mixins';
 export type { Boundaries, BBox } from './basic';
 export type { LifecycleConfig };
 /**
@@ -191,35 +192,19 @@ export interface AreaUnitConfig {
 }
 /**
  * 地块图层组件属性
- * @description PlotLayer 组件的 Props 定义
+ * @description PlotLayer 组件的 Props 定义，使用 Mixin 组合重构
  */
-export interface PlotLayerProps {
-    /** 地块数据数组 */
+export interface PlotLayerProps extends DataSourceMixin<PlotData>, StyleMixin<PlotData>, LoadingMixin, LifecycleMixin<'PlotLayer'>, ViewControlMixin, InteractionMixin<PlotData>, EditableMixin<'redraw' | 'clip' | 'move' | 'create' | 'delete'> {
+    /** 地块数据数组（必需） */
     dataSource: PlotData[];
-    /** 字段名映射，用于自定义 dataSource 中的字段名 */
-    fieldNames?: PlotFieldNames;
     /** 面积单位，用于计算新建地块的面积，默认 'mu'（亩） */
     areaUnit?: AreaUnit;
-    /** 点击地块时的回调函数 */
-    onClick?: (item: PlotData, layer?: L.Layer) => void;
-    /** 右键点击地块时的回调函数 */
-    onContextMenu?: (item: PlotData, layer?: L.Layer, event?: L.LeafletMouseEvent) => void;
     /** 鼠标悬停事件回调 */
     onHover?: (data: PlotData, type: 'mouseover' | 'mouseout') => void;
     /** 最小显示缩放级别 */
     minZoom?: number;
     /** 最大显示缩放级别 */
     maxZoom?: number;
-    /** 动态样式函数，根据地块数据返回样式 */
-    style?: (data: PlotData) => PlotStyle;
-    /**
-     * 是否在首次渲染数据后自动 fitBounds 适配地图视图
-     * @default false
-     */
-    autoFit?: boolean | {
-        maxZoom?: number;
-        padding?: number | [number, number];
-    };
     /**
      * 虚拟化渲染配置
      * @default false
@@ -231,10 +216,6 @@ export interface PlotLayerProps {
         minZoom?: number;
         maxZoom?: number;
     };
-    /** 默认选中的地块 ID（非受控模式） */
-    defaultValue?: string | number | (string | number)[];
-    /** 选中的地块 ID（受控模式） */
-    value?: string | number | (string | number)[];
     /** 选择模式：单选或多选 */
     mode?: 'single' | 'multiple';
     /**
@@ -246,27 +227,27 @@ export interface PlotLayerProps {
     path?: PathOptions;
     /** 选中状态的路径样式 */
     selectedPath?: PathOptions;
+    /** 选中的地块 ID（受控模式） */
+    value?: string | number | (string | number)[];
+    /** 默认选中的地块 ID（非受控模式） */
+    defaultValue?: string | number | (string | number)[];
     /** 选中变化时的回调 */
     onSelect?: (ids: (string | number)[], plotId?: string | number) => void;
-    /** 编辑模式，可开启全部或指定功能，或使用对象配置自定义工具栏 */
-    editMode?: boolean | ('redraw' | 'clip' | 'move' | 'create' | 'delete')[] | PlotEditModeConfig;
     /** 编辑按钮回调，用于打开编辑抽屉 */
     onEdit?: (result: {
         plotId: string | number;
         plot: PlotData;
     }) => void;
-    /** 重绘完成回调 */
+    /** 覆盖编辑模式回调 */
+    onCreate?: (result: PlotCreateResult) => void;
+    /** 删除完成回调 */
+    onDelete?: (result: PlotDeleteResult) => void;
+    /** 覆盖重绘回调 */
     onRedraw?: (result: PlotEditResult) => void;
     /** 剪辑完成回调 */
     onClip?: (result: PlotClipResult) => void;
     /** 移动完成回调 */
     onMove?: (result: PlotMoveResult) => void;
-    /** 新建完成回调，包含计算后的面积 */
-    onCreate?: (result: PlotCreateResult) => void;
-    /** 删除完成回调 */
-    onDelete?: (result: PlotDeleteResult) => void;
-    /** 保存回调（统一处理各种编辑结果） */
-    onSave?: (result: PlotEditResult | PlotClipResult | PlotMoveResult | PlotCreateResult) => void;
     /** 渲染统计回调 */
     onRenderStats?: (stats: RenderStats) => void;
     /** 是否显示地块标签 */
@@ -276,8 +257,6 @@ export interface PlotLayerProps {
     };
     /** 标签显示的字段列表 */
     labelFields?: string[];
-    /** 是否显示编辑模式提示，默认 false */
-    showEditHint?: boolean;
     /**
      * 分组字段名，用于构建字段值索引，支持 O(1) 快速查找同组地块
      * @default undefined
@@ -288,39 +267,6 @@ export interface PlotLayerProps {
      * @default { color: '#fa8c16', fillColor: '#fa8c16', fillOpacity: 0.4, weight: 2 }
      */
     highlightPath?: PathOptions;
-    /**
-     * 是否显示加载状态
-     * @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) => validatePlotData(data),
-     *   onFirstRender: (stats) => reportPerformance(stats),
-     *   onStateChange: (payload) => trackEditAction(payload),
-     *   onBeforeUnmount: () => saveDraft(),
-     * }}
-     * ```
-     */
-    lifecycle?: LifecycleConfig<'PlotLayer'>;
     /** 子组件 */
     children?: React.ReactNode;
 }

package/dist/types/road.d.ts

@@ -3,7 +3,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';
 /**
  * 编辑模式对象配置（Road）
  */
@@ -220,46 +220,9 @@ export interface RoadRef {
 }
 /**
  * 道路组件属性
- * @description Road 组件的 Props 定义
+ * @description Road 组件的 Props 定义，使用 Mixin 组合重构
  */
-export interface RoadProps<T = Record<string, unknown>> {
-    /**
-     * 道路数据数组
-     * @description 每个道路对象包含 id、name、points、distance、options 等字段
-     * @example
-     * ```ts
-     * const roads = [
-     *   {
-     *     id: 'road-1',
-     *     name: '主干道',
-     *     points: [[29.95, 117.98], [29.96, 117.99]],
-     *     distance: 500,
-     *     options: { default: { color: '#1668dc', weight: 10, opacity: 1 } }
-     *   }
-     * ];
-     * ```
-     */
-    dataSource?: T[];
-    /**
-     * 自定义字段名映射
-     * @description 当数据源字段名与默认字段名不同时，可通过此配置映射
-     * @example
-     * ```ts
-     * fieldNames={{ id: 'roadId', name: 'roadName', points: 'coordinates' }}
-     * ```
-     */
-    fieldNames?: RoadFieldNames;
-    /**
-     * 点击道路时的回调
-     * @param item - 被点击的道路数据
-     */
-    onClick?: (item: RoadData) => void;
-    /**
-     * 右键点击道路时的回调
-     * @param item - 被右键点击的道路数据
-     * @param event - Leaflet 鼠标事件
-     */
-    onContextMenu?: (item: RoadData, event: L.LeafletMouseEvent) => void;
+export interface RoadProps<T = Record<string, unknown>> extends DataSourceMixin<T>, SelectableMixin<string | number>, StyleMixin<T>, LoadingMixin, LifecycleMixin<'Road'>, ViewControlMixin, InteractionMixin<T>, EditableMixin<'create' | 'edit' | 'redraw' | 'delete'> {
     /**
      * 道路默认态样式配置
      * @description undefined | null | false | {} 时使用 ROAD_DEFAULT_PATH
@@ -270,64 +233,6 @@ export interface RoadProps<T = Record<string, unknown>> {
      * @description undefined | null | false | {} 时使用 ROAD_DEFAULT_SELECTED_PATH
      */
     selectedPath?: PathOptions | null | false;
-    /**
-     * 动态样式函数
-     * @description 根据道路数据动态返回样式，优先级：数据级 path > style 函数 > Props 级 path
-     */
-    style?: (data: T) => PathOptions;
-    /**
-     * 编辑模式
-     * @description 开启道路编辑功能，可传入 true 开启全部功能，或数组指定开启的功能，或对象配置
-     * @example
-     * ```ts
-     * editMode={true}  // 开启全部编辑功能
-     * editMode={['create', 'edit', 'redraw']}  // 仅开启新建、编辑和重绘
-     * editMode={{ enabled: ['create', 'edit'], toolbar: <ToolbarButton>自定义</ToolbarButton> }}  // 对象配置
-     * ```
-     */
-    editMode?: boolean | ('create' | 'edit' | 'redraw' | 'delete')[] | RoadEditModeConfig;
-    /**
-     * 新建道路回调
-     * @param result - 新建结果，包含 points 和 name
-     */
-    onCreate?: (result: RoadCreateResult) => void;
-    /**
-     * 编辑道路回调（点击编辑按钮触发，用于打开编辑抽屉）
-     * @param result - 编辑结果，包含 roadId 和 road 数据
-     */
-    onEdit?: (result: RoadEditDrawerResult) => void;
-    /**
-     * 重绘道路回调
-     * @param result - 重绘结果，包含 roadId、oldPoints、newPoints
-     */
-    onRedraw?: (result: RoadEditResult) => void;
-    /**
-     * 删除道路回调
-     * @param result - 删除结果，包含 roadId
-     */
-    onDelete?: (result: RoadDeleteResult) => void;
-    /**
-     * 保存回调
-     * @description 新建或编辑保存时触发，mode 字段区分操作类型
-     */
-    onSave?: (result: {
-        mode: string;
-    } & (RoadCreateResult | RoadEditResult)) => void;
-    /**
-     * 选中变化回调
-     * @param id - 新选中的道路 ID，null 表示取消选中
-     */
-    onSelect?: (id: string | number | null) => void;
-    /**
-     * 选中的道路 ID（受控模式）
-     * @description 传入此属性时，组件进入受控模式，选中状态由父组件管理
-     */
-    value?: string | number | null;
-    /**
-     * 默认选中的道路 ID（非受控模式）
-     * @description 组件初始化时默认选中的道路
-     */
-    defaultValue?: string | number;
     /**
      * 蚁行动画配置
      * @description 显示道路方向箭头动画
@@ -351,70 +256,19 @@ export interface RoadProps<T = Record<string, unknown>> {
      */
     showSelectedDistance?: boolean;
     /**
-     * 是否显示编辑模式提示
-     * @description 开启后，进入编辑模式时会显示操作提示
-     * @default false
-     */
-    showEditHint?: boolean;
-    /**
-     * 统一的声明式事件管理（类似 Ant Design Table 的 onRow）
-     * @description 返回一个事件回调对象，可按需绑定事件，支持基于数据项的条件化事件处理
-     * @param item - 当前道路数据
-     * @param index - 当前道路在数据源中的索引
-     * @returns RoadEvents 事件回调对象
-     * @example
-     * ```tsx
-     * <Road
-     *   dataSource={roads}
-     *   onRow={(item, index) => ({
-     *     onClick: () => console.log('点击了', item.name),
-     *     onContextMenu: (item, e) => { e.originalEvent.preventDefault(); },
-     *   })}
-     * />
-     * ```
+     * 覆盖编辑模式回调：重绘道路
      */
-    onRow?: (item: RoadData, index: number) => RoadEvents;
-    /**
-     * 是否显示加载状态
-     * @description 当为 true 时，在地图上显示加载动画覆盖层
-     * @default false
-     */
-    loading?: boolean;
-    /**
-     * 加载遮罩配置
-     * @description 自定义加载遮罩的样式
-     */
-    loadingMask?: {
-        /** 是否显示遮罩，默认 true */
-        enabled?: boolean;
-        /** 遮罩背景色，默认 'rgba(0, 0, 0, 0.5)' */
-        background?: string;
-        /** 遮罩层级，默认 1000 */
-        zIndex?: number;
-    };
+    onRedraw?: (result: RoadEditResult) => void;
     /**
-     * 生命周期回调配置
-     * @description 管理组件的挂载、渲染、状态变化、卸载等生命周期节点
-     * @since 1.4.0
-     * @example
-     * ```tsx
-     * lifecycle={{
-     *   onBeforeMount: (data) => validateRoadData(data),
-     *   onFirstRender: (stats) => reportPerformance(stats),
-     *   onStateChange: (payload) => trackEditAction(payload),
-     *   onBeforeUnmount: () => saveDraft(),
-     * }}
-     * ```
+     * 覆盖保存回调类型
      */
-    lifecycle?: LifecycleConfig<'Road'>;
+    onSave?: (result: {
+        mode: string;
+    } & (RoadCreateResult | RoadEditResult)) => void;
     /**
-     * 是否在首次加载数据后自动 fitBounds 适配地图视图
-     * @default false
+     * 统一的声明式事件管理（替代 InteractionMixin 的 onClick/onContextMenu）
      */
-    autoFit?: boolean | {
-        maxZoom?: number;
-        padding?: number | [number, number];
-    };
+    onRow?: (item: T, index: number) => RoadEvents;
     /**
      * 子组件
      * @description 用于嵌套 Popup 等子组件

package/dist/types/track.d.ts

@@ -4,6 +4,7 @@
  */
 import type { FilterResult, ParsedTrack } from '../components/Track/types';
 import type { IconConfig } from './icon';
+import type { SelectableMixin, ViewControlMixin } from './mixins';
 export type { IconConfig } from './icon';
 export type { ParsedTrack } from '../components/Track/types';
 export type { PolylineStyle as TrackStyle } from './polyline';
@@ -150,21 +151,18 @@ export interface DisplayModeConfig {
 }
 /**
  * Track 组件属性
+ * @description 使用 Mixin 组合重构，支持选择和视图控制
  */
-export interface TrackProps {
+export interface TrackProps extends SelectableMixin<string | string[]>, ViewControlMixin {
     /** 轨迹数据，key为 imei|date 组合 */
     dataSource: TrackData;
     /** 自定义数据字段名映射 */
     fieldNames?: TrackFieldNames;
     /** 选择模式 */
     mode?: 'single' | 'multiple';
-    /** 选中的轨迹key（受控模式） */
-    value?: string | string[];
-    /** 默认选中的轨迹key（非受控模式） */
-    defaultValue?: string | string[];
-    /** 轨迹点击回调 */
+    /** 轨迹点击回调（组件特定签名） */
     onClick?: (key: string, track: ParsedTrack) => void;
-    /** 选中值变化回调 */
+    /** 选中值变化回调（组件特定） */
     onChange?: (value: string | string[]) => void;
     /**
      * 性能优化配置
@@ -238,14 +236,6 @@ export interface TrackProps {
      * @default false
      */
     end?: boolean | 'selected';
-    /**
-     * 是否在首次加载数据后自动 fitBounds 适配地图视图
-     * @default false
-     */
-    autoFit?: boolean | {
-        maxZoom?: number;
-        padding?: number | [number, number];
-    };
     /** 子组件，通常放置 Popup 组件 */
     children?: React.ReactNode;
 }

package/dist/utils/__tests__/RTreeIndex.test.d.ts

@@ -1,5 +1,4 @@
 /**
  * @fileoverview RTreeIndex 性能测试
- * @description 测试 R-Tree 空间索引的性能表现
  */
 export {};

package/dist/utils/drawContext.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 折线绘制上下文状态管理
+ * @description 管理折线绘制过程中的所有状态，包括：
+ * - 当前是否正在绘制
+ * - 当前已添加的顶点列表
+ * - 临时线（绘制过程中的预览线）
+ * - 提示线（指向下一个顶点位置的虚线）
+ * - 顶点标记列表
+ *
+ * @since 2.1.0 移除 @geoman-io/leaflet-geoman-free 依赖重构
+ */
+import L from 'leaflet';
+export interface DrawContextState {
+    /** 是否正在绘制 */
+    isDrawing: boolean;
+    /** 当前已添加的顶点列表 */
+    points: L.LatLng[];
+    /** 临时线图层（连接所有已添加的顶点 + 当前鼠标位置） */
+    tempLine: L.Polyline | null;
+    /** 提示线图层（从最后一个顶点指向预测的下一个位置） */
+    hintLine: L.Polyline | null;
+    /** 顶点标记列表 */
+    vertexMarkers: L.CircleMarker[];
+    /** 当前绘制模式 */
+    mode: 'Line' | 'Polygon' | null;
+}
+export interface DrawContextOptions {
+    /** 临时线样式 */
+    tempLineStyle?: L.PathOptions;
+    /** 提示线样式 */
+    hintLineStyle?: L.PathOptions;
+    /** 顶点标记样式 */
+    vertexStyle?: {
+        radius?: number;
+        color?: string;
+        fillColor?: string;
+        fillOpacity?: number;
+        weight?: number;
+    };
+    /** 是否启用吸附 */
+    snappable?: boolean;
+    /** 吸附距离（像素） */
+    snapDistance?: number;
+}
+/**
+ * 创建并返回一个绘制上下文对象
+ */
+export declare function createDrawContext(map: L.Map, options?: DrawContextOptions): {
+    state: DrawContextState;
+    startDraw: (mode?: "Line" | "Polygon") => void;
+    stopDraw: (keepElements?: boolean) => void;
+    addVertex: (latlng: L.LatLng) => void;
+    removeLastVertex: () => void;
+    updateTempLine: () => void;
+    updateHintLine: (targetLatlng: L.LatLng) => void;
+    clearHintLine: () => void;
+    addVertexMarker: (latlng: L.LatLng, index: number) => void;
+    updateVertexMarkers: (points: L.LatLng[]) => void;
+    getPoints: () => L.LatLng[];
+    getTempLine: () => L.Polyline | null;
+    getLastVertex: () => L.LatLng | null;
+    getState: () => DrawContextState;
+    reset: () => void;
+};
+export type DrawContext = ReturnType<typeof createDrawContext>;