@wenle_2523097/agri-map 1.0.2 → 1.0.3

package/dist/hooks/useEditMode.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 解析编辑模式的 Hook
+ * @description 统一处理各组件的 editMode 属性解析逻辑
+ */
+import type { ReactNode } from 'react';
+import type { ToolbarColor, ToolbarSize } from '../components/shared/BaseEditToolbar';
+/**
+ * 编辑模式对象配置
+ */
+export interface EditModeObjectConfig<T extends string> {
+    /** 启用的编辑按钮 */
+    enabled?: boolean | T[];
+    /** 自定义工具栏内容 */
+    toolbar?: ReactNode;
+    /** 内置按钮的统一颜色（支持预设色和自定义颜色） */
+    color?: ToolbarColor;
+    /** 内置按钮的统一尺寸（支持预设尺寸和自定义数字） */
+    size?: ToolbarSize;
+    /** 是否仅显示图标（不显示文字） */
+    iconOnly?: boolean;
+}
+/**
+ * 编辑模式类型
+ * - `false`: 禁用编辑
+ * - `true`: 启用全部编辑功能
+ * - `T[]`: 启用指定的编辑按钮
+ * - `EditModeObjectConfig<T>`: 对象配置，支持自定义工具栏
+ */
+export type EditModeConfig<T extends string> = boolean | T[] | EditModeObjectConfig<T>;
+/**
+ * 编辑模式解析结果
+ */
+export interface EditModeResult<T extends string> {
+    /** 是否启用编辑模式 */
+    editEnabled: boolean;
+    /** 启用的按钮列表 */
+    enabledButtons: T[];
+    /** 自定义工具栏内容 */
+    customToolbar?: ReactNode;
+    /** 内置按钮的统一颜色 */
+    color?: ToolbarColor;
+    /** 内置按钮的统一尺寸 */
+    size?: ToolbarSize;
+    /** 是否仅显示图标 */
+    iconOnly?: boolean;
+}
+/**
+ * 解析编辑模式配置
+ * @param editModeProp 编辑模式属性值
+ * @param defaultButtons 当 editMode 为 true 时默认启用的按钮
+ * @returns EditModeResult
+ *
+ * @example
+ * ```ts
+ * // PlotLayer
+ * const { editEnabled, enabledButtons } = useEditMode(
+ *   editModeProp,
+ *   ['redraw', 'clip', 'move', 'create', 'delete'] as const
+ * );
+ *
+ * // Marker
+ * const { editEnabled, enabledButtons } = useEditMode(
+ *   editModeProp,
+ *   ['create', 'move', 'delete'] as const
+ * );
+ *
+ * // 使用对象配置
+ * const { editEnabled, enabledButtons, customToolbar } = useEditMode(
+ *   { enabled: ['create', 'move'], toolbar: <Button>自定义</Button> },
+ *   ['create', 'move', 'delete'] as const
+ * );
+ * ```
+ */
+export declare function useEditMode<T extends string>(editModeProp: EditModeConfig<T> | undefined, defaultButtons: readonly T[]): EditModeResult<T>;
+export default useEditMode;

package/dist/hooks/useEditMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditMode.d.ts","sourceRoot":"","sources":["../../src/hooks/useEditMode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM;IACpD,cAAc;IACd,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,CAAC;IACxB,eAAe;IACf,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,GAAG,CAAC,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM;IAC9C,eAAe;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc;IACd,cAAc,EAAE,CAAC,EAAE,CAAC;IACpB,eAAe;IACf,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,gBAAgB;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,gBAAgB;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,cAAc;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,cAAc,EAAE,SAAS,CAAC,EAAE,GAC3B,cAAc,CAAC,CAAC,CAAC,CAkDnB;AAED,eAAe,WAAW,CAAC"}

package/dist/hooks/useLatestRef.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 保持 ref 始终指向最新值的 Hook
+ * @description 用于在回调中访问最新值，避免闭包陷阱
+ */
+/**
+ * 返回一个 ref，其 current 始终指向传入的最新值
+ * @param value 需要保持引用的值
+ * @returns React.MutableRefObject<T>
+ *
+ * @example
+ * ```ts
+ * const onClickRef = useLatestRef(onClick);
+ * // 在回调中使用 onClickRef.current
+ * ```
+ */
+export declare function useLatestRef<T>(value: T): import("react").MutableRefObject<T>;
+export default useLatestRef;

package/dist/hooks/useLatestRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLatestRef.d.ts","sourceRoot":"","sources":["../../src/hooks/useLatestRef.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,uCAMvC;AAED,eAAe,YAAY,CAAC"}

package/dist/hooks/usePolylineEditor.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 折线编辑器状态管理 Hook
+ *
+ * 封装 Irrigation / Road 等折线类组件共享的编辑状态机逻辑：
+ * - currentMode / tempPoints 状态管理
+ * - pendingCreate 流程（新建 → 保存 → 抽屉 → 完成/取消）
+ * - handleCancel（清理编辑状态）
+ * - Escape 快捷键取消
+ * - normalizedData 变化时自动重置 pendingCreate 状态
+ * - pm:create / pm:edit 事件监听
+ */
+import L from 'leaflet';
+import type { Coordinate } from '../types';
+export interface UsePolylineEditorOptions {
+    /** Leaflet 地图实例 */
+    map: L.Map;
+    /** 编辑中的图层引用（由组件持有，类型各不相同） */
+    editingLayerRef: React.MutableRefObject<L.Polyline | null>;
+    /** 标准化后的数据源，用于检测 pendingCreate 保存后的数据变化 */
+    normalizedData: unknown[];
+    /** Whether PM event listeners (pm:create, pm:edit, etc.) should be active. Default: true */
+    pmEventsEnabled?: boolean;
+    /** Called when pm:create fires. Use this to convert the drawn layer type (e.g., asIrrigationLayer). */
+    onDrawnLayer?: (drawnLayer: L.Polyline) => void;
+    /** Optional runtime guard for pm:create event. Return false to skip handling. */
+    pmCreateGuard?: () => boolean;
+}
+export interface UsePolylineEditorReturn {
+    /** 当前编辑模式 */
+    currentMode: 'idle' | 'create' | 'edit';
+    /** 设置当前编辑模式 */
+    setCurrentMode: React.Dispatch<React.SetStateAction<'idle' | 'create' | 'edit'>>;
+    /** 临时坐标点（绘制/编辑中的坐标） */
+    tempPoints: Coordinate[];
+    /** 设置临时坐标点 */
+    setTempPoints: React.Dispatch<React.SetStateAction<Coordinate[]>>;
+    /** 新建待提交标记 ref（详见各组件中 pendingCreateRef 注释） */
+    pendingCreateRef: React.MutableRefObject<boolean>;
+    /** 编辑前原始坐标 ref */
+    originalPointsRef: React.MutableRefObject<Coordinate[] | null>;
+    /** currentMode 的最新引用（用于在回调和事件处理中读取最新值） */
+    currentModeRef: React.MutableRefObject<'idle' | 'create' | 'edit'>;
+    /** 取消操作：清理所有编辑状态 */
+    handleCancel: () => void;
+}
+export declare function usePolylineEditor(options: UsePolylineEditorOptions): UsePolylineEditorReturn;
+export interface UsePolylineSaveOptions {
+    map: L.Map;
+    currentMode: 'idle' | 'create' | 'edit';
+    tempPoints: Coordinate[];
+    value: string | number | null;
+    editingLayerRef: React.MutableRefObject<L.Polyline | null>;
+    pendingCreateRef: React.MutableRefObject<boolean>;
+    originalPointsRef: React.MutableRefObject<Coordinate[] | null>;
+    layerByIdRef: React.MutableRefObject<Record<string | number, L.Polyline>>;
+    setCurrentMode: React.Dispatch<React.SetStateAction<'idle' | 'create' | 'edit'>>;
+    setTempPoints: React.Dispatch<React.SetStateAction<Coordinate[]>>;
+    /** Called when create save is triggered with the new points */
+    onCreateSave: (points: Coordinate[]) => void;
+    /** Called when edit save is triggered with id, oldPoints, newPoints */
+    onEditSave: (id: string | number, oldPoints: Coordinate[], newPoints: Coordinate[]) => void;
+}
+export declare function usePolylineSave(options: UsePolylineSaveOptions): {
+    handleSave: () => void;
+};

package/dist/hooks/usePolylineEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePolylineEditor.d.ts","sourceRoot":"","sources":["../../src/hooks/usePolylineEditor.ts"],"names":[],"mappings":"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"}

package/dist/hooks/usePolylineRenderer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview 线要素渲染 hook（共享逻辑）
+ * @description 提取 Irrigation 和 Road 组件中重复的图层管理逻辑：
+ * - 主渲染 useEffect 的图层创建/销毁/编辑模式过滤
+ * - 组件卸载时清理编辑图层 (editingLayerRef)
+ * @module hooks/usePolylineRenderer
+ */
+import { type MutableRefObject } from 'react';
+import L from 'leaflet';
+interface UsePolylineRendererOptions {
+    map: L.Map | null;
+    normalizedData: any[];
+    value: string | number | null;
+    currentMode: 'idle' | 'create' | 'edit';
+    /** 渲染单条数据到 layerGroup 中 */
+    renderItem: (item: any, layerGroup: L.LayerGroup, index: number) => void;
+    layerGroupRef: MutableRefObject<L.LayerGroup | null>;
+    layerByIdRef: MutableRefObject<Record<string | number, any>>;
+    editingLayerRef: MutableRefObject<any | null>;
+    deps: any[];
+}
+/**
+ * 管理线要素图层的创建与清理
+ *
+ * 负责：
+ * 1. 编辑模式下过滤数据（create/edit 模式不渲染已有要素）
+ * 2. 创建 LayerGroup 并将数据渲染进去
+ * 3. 组件卸载时移除 editingLayerRef
+ *
+ * 注意：editingLayerRef 的日常生命周期（handleRedraw/handleEdit 创建、
+ * handleCancel/handleSave 销毁）由组件自行管理，此 hook 仅在组件卸载时兜底清理。
+ */
+export declare function usePolylineRenderer(options: UsePolylineRendererOptions): void;
+export {};

package/dist/hooks/usePolylineRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePolylineRenderer.d.ts","sourceRoot":"","sources":["../../src/hooks/usePolylineRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,CAAC,MAAM,SAAS,CAAC;AAExB,UAAU,0BAA0B;IAClC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IAClB,cAAc,EAAE,GAAG,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxC,2BAA2B;IAC3B,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,aAAa,EAAE,gBAAgB,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACrD,YAAY,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7D,eAAe,EAAE,gBAAgB,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAC9C,IAAI,EAAE,GAAG,EAAE,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CA6E7E"}

package/dist/hooks/useTheme.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 主题 Hook
+ * @description 提供统一的主题访问接口
+ */
+import { type ThemeMode, type ThemeColors } from '../constants/theme';
+/**
+ * 获取当前主题及颜色配置的 Hook
+ * @returns 主题模式和颜色配置
+ */
+export declare const useTheme: () => {
+    theme: ThemeMode;
+    colors: ThemeColors;
+};

package/dist/hooks/useTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtF;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAO;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAOlE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,312 @@
+/**
+ * 农业地图组件库主入口文件
+ * @description 导出所有公共组件和工具函数
+ */
+import './styles/index.scss';
+/**
+ * 高性能地块图层组件
+ * @description 使用Leaflet原生GeoJSON Layer，支持大规模地块数据（上万条），支持单击和右键事件
+ * @see docs/PERFORMANCE_OPTIMIZATION.md 性能优化指南
+ * @example
+ * <PlotLayer plots={plotDataArray} onPlotClick={handleClick} onPlotContextMenu={handleContextMenu} />
+ */
+export { default as PlotLayer } from './components/PlotLayer';
+/**
+ * 多类型地块分组编排组件
+ * @description 将多种类型的地块分组渲染，每种类型对应一个独立的 PlotLayer 实例，
+ *   支持跨类型互斥选中、统一分组高亮、合并渲染统计等功能。
+ * @example
+ * <PlotGroupLayer
+ *   dataSource={{
+ *     wasteland: { dataSource: wastelandData, path: { color: '#8B7355', fillColor: '#8B7355', fillOpacity: 0.3 } },
+ *     paddyField: { dataSource: paddyFieldData, path: { color: '#52c41a', fillColor: '#52c41a', fillOpacity: 0.3 } },
+ *   }}
+ *   mode="single"
+ *   groupKey="possessor"
+ * />
+ */
+export { default as PlotGroupLayer } from './components/PlotGroupLayer';
+/**
+ * 天地图图层组件
+ * @description 封装天地图的矢量图层和标注图层，支持多种图层风格（矢量、卫星、地形）和叠加瓦片
+ * @example
+ * <TianDiTuLayer apiKey="your-key" layerType="satellite" showAnnotation={true} />
+ * <TianDiTuLayer apiKey="your-key" overlayUrl="https://your-server.com/overlay/{z}/{x}/{y}.png" overlayOpacity={0.5} />
+ */
+export { default as TianDiTuLayer, LAYER_TYPES } from './components/TianDiTuLayer';
+/**
+ * 双向标尺组件
+ * @description 在地图上同时显示水平和垂直两个标尺
+ * @example
+ * <DualScaleControl />
+ * <DualScaleControl config={{ metric: true, imperial: false, showZoomControl: true }} />
+ */
+export { default as DualScaleControl } from './components/DualScaleControl';
+/**
+ * 测量工具栏组件
+ * @description 提供地图上的长度和面积测量功能，采用统一的工具栏样式
+ * @features
+ * - 测长度：绘制折线，实时显示长度
+ * - 测面积：绘制多边形，实时显示面积
+ * - 支持多种单位：m/km/ft/mi（长度）, sqm/sqkm/sqft/acre/hectare（面积）
+ * - 可配置位置：topleft/topright/bottomleft/bottomright
+ * - 实时显示测量值
+ * - 统一工具栏样式，与 BaseEditToolbar 保持一致
+ * @example
+ * // 基础用法
+ * <MeasurementToolbar />
+ *
+ * // 自定义位置和单位
+ * <MeasurementToolbar position="topright" lengthUnit="km" areaUnit="hectare" />
+ */
+export { default as MeasurementToolbar } from './components/Measurement/toolbar';
+/**
+ * 全局配置提供者组件
+ * @description 为子组件提供统一的全局配置（如主题）
+ * @example
+ * <ConfigProvider theme="dark" dualScaleControl tianDiTuLayer={{ apiKey: 'xxx' }}>
+ *   <MapContainer>
+ *     <MapContent />
+ *   </MapContainer>
+ * </ConfigProvider>
+ */
+export { default as ConfigProvider, useConfig } from './components/ConfigProvider';
+/**
+ * 地图内容组件
+ * @description 根据 ConfigProvider 配置自动渲染 DualScaleControl、TianDiTuLayer 和 MapSizeHandler
+ * @example
+ * <ConfigProvider dualScaleControl tianDiTuLayer={{ apiKey: 'xxx' }} mapSizeHandler>
+ *   <MapContainer>
+ *     <MapContent />
+ *   </MapContainer>
+ * </ConfigProvider>
+ */
+export { default as MapContent } from './components/MapContent';
+/**
+ * 地图尺寸处理器组件
+ * @description 解决地图容器尺寸变化后（如抽屉/对话框打开），地图不自动刷新的问题
+ * @example
+ * // 通过 ConfigProvider 配置（推荐）
+ * <ConfigProvider mapSizeHandler>
+ *   <MapContainer>
+ *     <MapContent />
+ *   </MapContainer>
+ * </ConfigProvider>
+ *
+ * // 或直接使用
+ * <MapContainer>
+ *   <MapSizeHandler />
+ * </MapContainer>
+ */
+export { default as MapSizeHandler } from './components/MapSizeHandler';
+/**
+ * 地图标注组件
+ * @description 用于在地图上显示多个标注点，支持自定义图标
+ * @example
+ * <Marker
+ *   icon="point"
+ *   dataSource={[{ id: 1, position: [29.94, 117.90], title: '标注点1' }]}
+ *   onClick={handleClick}
+ * />
+ */
+export { default as Marker } from './components/Marker';
+/**
+ * 标注点编辑工具栏组件
+ * @description 提供标注点编辑功能的工具栏，包含新建、移动、删除等操作
+ */
+export { default as MarkerEditToolbar } from './components/Marker/toolbar';
+/**
+ * 农机轨迹组件
+ * @description 用于在地图上显示农机作业轨迹，支持轨迹分段显示（路上/作业中不同颜色）、方向指示、轨迹选中等功能
+ * @example
+ * <Track
+ *   data={trackData}
+ *   showDirection={true}
+ *   showStartEnd={true}
+ *   onClick={(key, track) => console.log(key, track)}
+ * />
+ */
+export { default as Track } from './components/Track';
+/**
+ * 小地图组件
+ * @description 在主地图上显示轨迹概览和当前视口位置的小地图，用于导航引导
+ * @example
+ * // 在 Track 组件中启用
+ * <Track dataSource={trackData} miniMap />
+ *
+ * // 自定义配置
+ * <Track
+ *   dataSource={trackData}
+ *   miniMap={{
+ *     width: 200,
+ *     height: 150,
+ *     zoomOffset: -5,
+ *     draggable: true,
+ *     showTrackOverview: true,
+ *   }}
+ * />
+ */
+export { default as MiniMap } from './components/MiniMap';
+/**
+ * 田间道路组件
+ * @description 用于在地图上绘制和管理田间道路，支持新建、编辑、删除等编辑功能
+ */
+export { default as Road } from './components/Road';
+/**
+ * 道路编辑工具栏组件
+ * @description 提供道路编辑功能的工具栏，包含新建、编辑、删除等操作
+ */
+export { default as RoadEditToolbar } from './components/Road/toolbar';
+/**
+ * 工具栏按钮组件
+ * @description 提供统一样式的工具栏按钮，用于自定义工具栏内容
+ * @example
+ * ```tsx
+ * import { Marker, ToolbarButton } from 'agri-map-components';
+ *
+ * <Marker
+ *   editMode={{
+ *     enabled: ['create', 'move', 'delete'],
+ *     toolbar: (
+ *       <>
+ *         <ToolbarButton variant="primary" onClick={() => console.log('自定义操作')}>
+ *           自定义按钮
+ *         </ToolbarButton>
+ *       </>
+ *     )
+ *   }}
+ * />
+ * ```
+ */
+export { default as ToolbarButton, type ToolbarButtonProps } from './components/shared/ToolbarButton';
+/**
+ * 灌溉渠组件
+ * @description 用于在地图上绘制和管理灌溉渠，支持新建、编辑、删除等编辑功能，可显示流向箭头
+ */
+export { default as Irrigation } from './components/Irrigation';
+/**
+ * 灌溉渠编辑工具栏组件
+ * @description 提供灌溉渠编辑功能的工具栏，包含新建、编辑、删除等操作
+ */
+export { default as IrrigationEditToolbar } from './components/Irrigation/toolbar';
+/**
+ * Loading 加载组件
+ * @description 显示加载状态的组件，支持多种加载图标和自定义配置
+ * @example
+ * // 基础用法
+ * <Loading />
+ *
+ * // 自定义图标和描述
+ * <Loading icon="loading-dots" description="加载中..." />
+ *
+ * // 自定义尺寸
+ * <Loading size="large" />
+ * <Loading size={64} />
+ *
+ * // 在 Marker 中使用
+ * <Marker loading={true} />
+ */
+export { default as Loading } from './components/Loading';
+/**
+ * SVG 图标组件库
+ * @description 统一的 SVG 图标组件，包含重绘、剪切、移动、删除、取消、保存、新建等图标
+ * @example
+ * import { PlotRedrawIcon, CreateIcon } from 'agri-map-components';
+ * // 或
+ * import Icons from 'agri-map-components';
+ * <Icons.Create />
+ */
+export { default as Icons, MarkerRedrawIcon, PlotRedrawIcon, RoadRedrawIcon, IrrigationRedrawIcon, ClipIcon, MoveIcon, DeleteIcon, CancelIcon, SaveIcon, CreateIcon, EditIcon, ReverseIcon } from './components/Icons';
+/**
+ * 图标选择器组件
+ * @description 兼容 antd Form 的 value/onChange 接口，用于选择预设地图图标
+ * @example
+ * // antd Form 中使用
+ * import { SelectIcon } from 'agri-map-components';
+ * <Form.Item label="图标" name="icon">
+ *   <SelectIcon />
+ * </Form.Item>
+ *
+ * // 独立使用
+ * const [icon, setIcon] = useState('marker-blue');
+ * <SelectIcon value={icon} onChange={setIcon} allowClear />
+ */
+export { SelectIcon, IconPreview, DEFAULT_ICON_GROUPS } from './components/Icons/SelectIcon';
+export type { SelectIconProps, IconPreviewProps, IconGroupItem, IconGroup } from './components/Icons/SelectIcon';
+/**
+ * 图标工具函数
+ * @description 统一的图标检测和处理工具
+ * @example
+ * import { detectIconType, PRESET_ICONS } from 'agri-map-components';
+ * const result = detectIconType('marker-blue'); // { type: 'preset', value: 'marker-blue' }
+ */
+export { detectIconType, PRESET_ICONS, isUrlIcon, isPresetIcon, generateSvgHtml, PULSE_ICONS } from './utils/iconUtils';
+export { generateTractorSvg, generateTractor2Svg } from './utils/iconCache';
+export { generatePulseSvg } from './utils/pulseIcon';
+/**
+ * 面积计算工具
+ * @description 包含面积计算、单位转换、格式化等函数
+ */
+export { calculatePolygonArea, convertArea, formatArea, getAreaUnitConfig, AREA_UNIT_CONFIGS, computeDataBounds } from './utils/area';
+/**
+ * 常量配置
+ * @description 地图组件库的常量定义
+ */
+export * from './constants';
+/**
+ * 工具函数
+ * @description 包含地图相关的计算和判断工具函数
+ */
+export * from './utils';
+/**
+ * 双向标尺配置类型
+ * @description DualScaleControl 组件的 config 属性配置
+ * @property metric - 是否显示公制单位（km/m/cm），默认 true
+ * @property imperial - 是否显示英制单位（mi/ft/in），默认 false
+ * @property showZoomControl - 是否显示缩放控件（放大/缩小按钮和缩放级别），默认 true
+ * @example
+ * const config: DualScaleControlConfig = {
+ *   metric: true,        // 显示公制单位
+ *   imperial: false,     // 不显示英制单位
+ *   showZoomControl: true // 显示缩放控件
+ * };
+ * <DualScaleControl config={config} />
+ */
+export type { DualScaleControlConfig } from './types';
+/**
+ * 天地图图层配置类型
+ * @description ConfigProvider 的 tianDiTuLayer 属性配置
+ * @property apiKey - 天地图 API Key（必填）
+ * @property layerType - 图层类型：vector(矢量) | satellite(卫星) | terrain(地形)，默认 vector
+ * @property showAnnotation - 是否显示标注图层，默认 true
+ * @property overlayUrl - 自定义瓦片叠加层 URL
+ * @property subdomains - 瓦片服务子域名
+ * @property maxZoom - 最大缩放级别
+ * @property minZoom - 最小缩放级别
+ * @example
+ * const config: TianDiTuLayerConfig = {
+ *   apiKey: 'your-api-key',
+ *   layerType: 'satellite',
+ *   showAnnotation: true,
+ *   overlayUrl: 'https://example.com/tile/{z}/{x}/{y}.png'
+ * };
+ */
+export type { TianDiTuLayerConfig } from './types';
+/**
+ * 地图尺寸处理器配置类型
+ * @description ConfigProvider 的 mapSizeHandler 属性配置
+ * @property enabled - 是否启用，默认 true
+ * @property delay - 首次刷新的延迟时间（毫秒），默认 100
+ * @property retries - 重试次数，默认 3
+ * @example
+ * const config: MapSizeHandlerConfig = {
+ *   enabled: true,
+ *   delay: 200,
+ *   retries: 5
+ * };
+ * <ConfigProvider mapSizeHandler={config}>
+ *   ...
+ * </ConfigProvider>
+ */
+export type { MapSizeHandlerConfig } from './types';
+export type { Coordinate, BoundingBox, PathOptions, PlotType, PlotStatus, PlotData, PlotStyle, PlotEditMode, PlotEditResult, PlotClipResult, PlotMoveResult, PlotCreateResult, PlotDeleteResult, RenderStats, PlotLayerProps, PlotRef, PlotFieldNames, PlotGroupConfig, GroupRenderStats, PlotGroupLayerProps, PlotGroupRef, MarkerData, MarkerIconOptions, MarkerCreateResult, MarkerMoveResult, MarkerDeleteResult, MarkerEditResult, MarkerProps, MarkerRef, MarkerEditModeConfig, MarkerEvents, RoadData, RoadCreateResult, RoadEditResult, RoadDeleteResult, RoadProps, RoadRef, RoadEditModeConfig, RoadEvents, IrrigationFieldNames, IrrigationData, IrrigationCreateResult, IrrigationEditResult, IrrigationDeleteResult, IrrigationReverseResult, IrrigationProps, IrrigationRef, IrrigationEvents, DecoratorConfig, LayerType, TianDiTuLayerProps, ConfigContextValue, ConfigProviderProps, DualScaleControlProps, MapContentProps, NotificationType, NotificationOptions, NotificationInstance, NotificationProps, PlotEditToolbarProps, MarkerEditToolbarProps, RoadEditToolbarProps, IrrigationEditToolbarProps, PlotLabelProps, TrackData, TrackProps, TrackRef, TrackPoint, MiniMapProps, LoadingIconName, LoadingSize, LoadingMaskConfig, LoadingProps, LengthUnit, MeasurementAreaUnit, MeasurementMode, MeasurementControlPosition, MeasurementToolbarProps, MeasurementData, UnitConfig, } from './types';

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,qBAAqB,CAAC;AAI7B;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAExE;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEnF;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEjF;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAEnF;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAExE;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;GAGG;AACH,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEtG;;;GAGG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;GAGG;AACH,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAEnF;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvN;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAEjH;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACxH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtI;;;GAGG;AACH,cAAc,aAAa,CAAC;AAE5B;;;GAGG;AACH,cAAc,SAAS,CAAC;AAIxB;;;;;;;;;;;;;GAaG;AACH,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,OAAO,EACP,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,SAAS,EACT,UAAU,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,EACf,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/types/basic.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 基础类型定义
+ */
+/**
+ * 坐标点
+ * @description 纬度和经度组成的元组 [lat, lng]
+ * @example [30.0, 120.0]
+ */
+export type Coordinate = [number, number];
+/**
+ * 坐标数组类型
+ * @description 二维坐标数组 [[lat,lng],...] 或三维坐标数组 [[[lat,lng],...], [孔洞], ...]
+ */
+export type Positions2D = Coordinate[];
+export type Positions3D = Coordinate[][];
+/**
+ * 判断坐标数组是否为三维数组（GeoJSON 格式：[[外环], [孔洞1], ...]）
+ * @param positions 待检测的坐标数组
+ * @returns true 表示三维数组，false 表示二维数组或无效
+ */
+export declare function is3DPositions(positions: unknown): positions is Positions3D;
+/**
+ * 边界框
+ * @description 地图边界范围 [南纬, 西经, 北纬, 东经]
+ * @example [29.9, 119.9, 30.1, 120.1]
+ */
+export type BoundingBox = [number, number, number, number];
+/**
+ * 路径样式选项
+ * @description 用于配置线条、多边形等图形的样式
+ */
+export interface PathOptions {
+    /** 边框颜色 */
+    color?: string;
+    /** 填充颜色 */
+    fillColor?: string;
+    /** 边框宽度（像素） */
+    weight?: number;
+    /** 边框透明度 (0-1) */
+    opacity?: number;
+    /** 填充透明度 (0-1) */
+    fillOpacity?: number;
+    /** 虚线模式，如 '5, 10' 或 [5, 10] */
+    dashArray?: string | number[];
+    /** 自定义 CSS 类名 */
+    className?: string;
+}
+/**
+ * 地块类型
+ * @description 农业地块的分类类型
+ */
+export type PlotType = 'farmland' | 'vegetable' | 'orchard' | 'forest' | 'grassland' | 'paddy' | 'greenhouse';
+/**
+ * 地块状态
+ * @description 地块的当前耕作状态
+ */
+export type PlotStatus = 'cultivating' | 'fallow' | 'harvesting' | 'planting' | 'irrigating';

package/dist/types/basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../src/types/basic.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,EAAE,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,UAAU,EAAE,EAAE,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,WAAW,CAI1E;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,YAAY,CAAC;AAE9G;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC"}