@wenle_2523097/agri-map 1.0.9 → 1.0.10

package/dist/components/ConfigProvider/index.d.ts

@@ -11,5 +11,5 @@ export declare const useConfig: () => ConfigContextValue;
 /**
  * 全局配置提供者组件
  */
-declare const ConfigProvider: ({ theme, dualScaleControl, tianDiTuLayer, mapSizeHandler, children }: ConfigProviderProps) => JSX.Element;
+declare const ConfigProvider: ({ theme, dualScaleControl, tianDiTuLayer, mapSizeHandler, children, }: ConfigProviderProps) => JSX.Element;
 export default ConfigProvider;

package/dist/components/Icons/Icons.stories.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Icons 组件故事
+ */
+import type { StoryObj } from '@storybook/react';
+declare const meta: {
+    title: string;
+    component: ({ size, color, ariaLabel, ariaHidden, }: import("../Icons").IconProps) => JSX.Element;
+    parameters: {
+        layout: string;
+        docs: {
+            description: {
+                component: string;
+            };
+        };
+    };
+    tags: string[];
+    argTypes: any;
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const PlotRedraw: Story;
+export declare const Clip: Story;
+export declare const Move: Story;
+export declare const Delete: Story;
+export declare const Cancel: Story;
+export declare const Save: Story;
+export declare const Create: Story;
+export declare const Edit: Story;
+export declare const Reverse: Story;
+export declare const AllIcons: Story;

package/dist/components/Icons/SelectIcon.d.ts

@@ -12,10 +12,9 @@
  * <SelectIcon value={icon} onChange={setIcon} />
  */
 import { type CSSProperties } from 'react';
-import type { PresetIconName } from '../../types/icon';
 export interface IconGroupItem {
-    /** 图标名称（预设图标名称） */
-    type: PresetIconName;
+    /** 图标名称（预设图标名称或自定义图标名称） */
+    type: string;
     /** 图标显示名称 */
     name: string;
 }
@@ -41,7 +40,7 @@ export interface IconPreviewProps {
  * 图标预览组件
  * @description 根据图标类型渲染不同的预览效果
  */
-export declare function IconPreview({ iconType, size, animated, style }: IconPreviewProps): JSX.Element;
+export declare function IconPreview({ iconType, size, animated, style, }: IconPreviewProps): JSX.Element;
 export interface SelectIconProps {
     /** 当前选中值（兼容 antd Form） */
     value?: string;

package/dist/components/Icons/index.d.ts

@@ -3,7 +3,7 @@
  * @description 统一的 SVG 图标组件，用于工具栏等场景
  */
 /** 图标组件属性 */
-interface IconProps {
+export interface IconProps {
     size?: number;
     color?: string;
     /** 无障碍标签文本 */
@@ -11,32 +11,38 @@ interface IconProps {
     /** 是否对屏幕阅读器隐藏，默认 true */
     ariaHidden?: boolean;
 }
-export declare const MarkerRedrawIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const PlotRedrawIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const RoadRedrawIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const IrrigationRedrawIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const ClipIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const MoveIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const DeleteIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const CancelIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const SaveIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const CreateIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const EditIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-export declare const ReverseIcon: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
+export declare const MarkerRedrawIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const PlotRedrawIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const RoadRedrawIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const IrrigationRedrawIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const ClipIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const MoveIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const DeleteIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const CancelIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const SaveIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const CreateIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const EditIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const ReverseIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const MeasureLengthUIIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const MeasureAreaUIIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+export declare const ClearMeasureUIIcon: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
 /** 图标组件映射 */
 declare const Icons: {
-    MarkerRedraw: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    PlotRedraw: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    RoadRedraw: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    IrrigationRedraw: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    Clip: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    Move: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    Delete: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    Cancel: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    Save: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    Create: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    Edit: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
-    Reverse: ({ size, color, ariaLabel, ariaHidden }: IconProps) => JSX.Element;
+    MarkerRedraw: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    PlotRedraw: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    RoadRedraw: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    IrrigationRedraw: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    Clip: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    Move: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    Delete: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    Cancel: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    Save: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    Create: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    Edit: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    Reverse: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    MeasureLengthUI: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    MeasureAreaUI: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
+    ClearMeasureUI: ({ size, color, ariaLabel, ariaHidden, }: IconProps) => JSX.Element;
 };
 export default Icons;
 export { SelectIcon, IconPreview, DEFAULT_ICON_GROUPS } from './SelectIcon';

package/dist/components/Irrigation/toolbar.d.ts

@@ -2,5 +2,5 @@
  * 灌溉渠编辑工具栏组件
  */
 import type { IrrigationEditToolbarProps } from '../../types';
-declare const IrrigationEditToolbar: ({ visible, selectedChannelId, currentMode, enabledButtons, pointCount, hintMessage, showHint, color, size, iconOnly, children, onCreate, onEdit, onRedraw, onCancel, onSave, onDelete, onReverse, }: IrrigationEditToolbarProps) => import("react/jsx-runtime").JSX.Element;
+declare const IrrigationEditToolbar: ({ visible, selectedChannelId, currentMode, enabledButtons, pointCount, hintMessage, showHint, color, size, iconOnly, children, onCreate, onEdit, onRedraw, onCancel, onSave, onDelete, onReverse, }: IrrigationEditToolbarProps) => JSX.Element;
 export default IrrigationEditToolbar;

package/dist/components/Marker/ClusterView.d.ts

@@ -3,8 +3,8 @@
  * @module components/Marker/ClusterView
  */
 import React from 'react';
-import L from 'leaflet';
-import Supercluster from 'supercluster';
+import type L from 'leaflet';
+import type Supercluster from 'supercluster';
 import type { MarkerData, ClusterIconConfig } from '../../types';
 interface ClusterViewProps {
     /** 聚合结果数组（包含聚合气泡和单独点） */

package/dist/components/Marker/MapClickHandler.d.ts

@@ -3,7 +3,7 @@
  * @description 处理地图点击事件，用于创建模式下的标注点创建和 Tooltip 关闭
  * @module components/Marker/MapClickHandler
  */
-import L from 'leaflet';
+import type L from 'leaflet';
 /**
  * 地图点击处理器属性
  */
@@ -21,5 +21,5 @@ interface MapClickHandlerProps {
  * 地图点击处理器
  * @description 处理地图点击事件，用于创建模式下的标注点创建和 Tooltip 关闭
  */
-declare function MapClickHandler({ enabled, hasTempMarker, onMapClick, onMapClickWithoutMarker }: MapClickHandlerProps): null;
+declare function MapClickHandler({ enabled, hasTempMarker, onMapClick, onMapClickWithoutMarker, }: MapClickHandlerProps): null;
 export default MapClickHandler;

package/dist/components/Marker/toolbar.d.ts

@@ -2,5 +2,5 @@
  * 标注点编辑工具栏组件
  */
 import type { MarkerEditToolbarProps } from '../../types';
-declare const MarkerEditToolbar: ({ visible, selectedMarkerId, currentMode, enabledButtons, hintMessage, showHint, color, size, iconOnly, children, onEdit, onMove, onCreate, onCancel, onSave, onDelete, }: MarkerEditToolbarProps) => import("react/jsx-runtime").JSX.Element;
+declare const MarkerEditToolbar: ({ visible, selectedMarkerId, currentMode, enabledButtons, hintMessage, showHint, color, size, iconOnly, children, onEdit, onMove, onCreate, onCancel, onSave, onDelete, }: MarkerEditToolbarProps) => JSX.Element;
 export default MarkerEditToolbar;

package/dist/components/Marker/useEditHandlers.d.ts

@@ -3,7 +3,7 @@
  * @description 将编辑模式的状态管理和事件处理提取为独立 hook
  * @module components/Marker/useEditHandlers
  */
-import L from 'leaflet';
+import type L from 'leaflet';
 import type { MarkerData, MarkerCreateResult, MarkerMoveResult } from '../../types';
 interface EditHandlersOptions {
     enabledButtonsRef: React.MutableRefObject<('create' | 'edit' | 'move' | 'delete')[]>;

package/dist/components/Marker/useIconConfig.d.ts

@@ -3,7 +3,7 @@
  * @description 将图标解析、合并、生成逻辑抽取为独立 hook
  * @module components/Marker/useIconConfig
  */
-import L from 'leaflet';
+import type L from 'leaflet';
 import type { MarkerData, MarkerIconsConfig } from '../../types';
 interface UseIconConfigOptions {
     icons?: MarkerIconsConfig;
@@ -15,7 +15,7 @@ interface UseIconConfigOptions {
  * Marker 图标配置 hook
  * @description 管理图标配置的解析、合并和生成
  */
-export declare function useIconConfig({ icons, editEnabled, currentMode, permanent }: UseIconConfigOptions): {
+export declare function useIconConfig({ icons, editEnabled, currentMode, permanent, }: UseIconConfigOptions): {
     getItemIcon: (item: MarkerData, isSelected: boolean, isEditing: boolean, isTemp?: boolean) => L.DivIcon;
     getItemPermanent: (item: MarkerData) => boolean;
     getTooltipOffset: (item: MarkerData) => [number, number];

package/dist/components/Measurement/toolbar.d.ts

@@ -1,13 +1,6 @@
 /**
  * 测量工具栏组件
- * @description 提供地图上的长度和面积测量功能，基于 @geoman-io/leaflet-geoman-free
- * @features
- * - 测长度：绘制折线，实时显示长度
- * - 测面积：绘制多边形，实时显示面积
- * - 支持多种单位：m/km/ft/mi（长度）, sqm/sqkm/sqft/acre/hectare（面积）
- * - 可配置位置：topleft/topright/bottomleft/bottomright
- * - 实时显示测量值
- * - 统一工具栏样式，与 BaseEditToolbar 保持一致
+ * @description 提供地图上的长度和面积测量功能
  */
 import '@geoman-io/leaflet-geoman-free';
 import type { MeasurementToolbarProps, LengthUnit, MeasurementAreaUnit, UnitConfig } from '../../types/measurement';
@@ -16,5 +9,5 @@ export declare const AREA_UNITS: Record<MeasurementAreaUnit, UnitConfig>;
 /**
  * 测量工具栏组件
  */
-declare const MeasurementToolbar: ({ visible, position, lengthUnit, areaUnit, precision, style, className, onStartMeasurement, onEndMeasurement, onMeasurementChange, }: Omit<MeasurementToolbarProps, "showMeasurements">) => null;
+declare const MeasurementToolbar: ({ position, lengthUnit, areaUnit, precision, style, className, onStartMeasurement, onEndMeasurement, onMeasurementChange, }: Omit<MeasurementToolbarProps, "visible" | "showMeasurements">) => null;
 export default MeasurementToolbar;

package/dist/components/PlotLayer/toolbar.d.ts

@@ -2,5 +2,5 @@
  * 地块编辑工具栏组件
  */
 import type { PlotEditToolbarProps } from '../../types';
-declare const PlotEditToolbar: ({ visible, selectedPlotId, currentMode, enabledButtons, hintMessage, showHint, warningHint, color, size, iconOnly, children, onEdit, onRedraw, onClip, onMove, onCreate, onCancel, onSave, onDelete, }: PlotEditToolbarProps) => import("react/jsx-runtime").JSX.Element;
+declare const PlotEditToolbar: ({ visible, selectedPlotId, currentMode, enabledButtons, hintMessage, showHint, warningHint, color, size, iconOnly, children, onEdit, onRedraw, onClip, onMove, onCreate, onCancel, onSave, onDelete, }: PlotEditToolbarProps) => JSX.Element;
 export default PlotEditToolbar;

package/dist/components/PlotLayer/usePlotData.d.ts

@@ -28,5 +28,5 @@ interface UsePlotDataResult {
     /** 当前高亮分组 ref */
     highlightedGroupRef: React.MutableRefObject<string | null>;
 }
-export declare function usePlotData({ fieldNames, dataSource, groupKey }: UsePlotDataOptions): UsePlotDataResult;
+export declare function usePlotData({ fieldNames, dataSource, groupKey, }: UsePlotDataOptions): UsePlotDataResult;
 export {};

package/dist/components/Road/toolbar.d.ts

@@ -2,5 +2,5 @@
  * 道路编辑工具栏组件
  */
 import type { RoadEditToolbarProps } from '../../types';
-declare const RoadEditToolbar: ({ visible, selectedRoadId, currentMode, enabledButtons, pointCount, hintMessage, showHint, color, size, iconOnly, children, onEdit, onRedraw, onCreate, onCancel, onSave, onDelete, }: RoadEditToolbarProps) => import("react/jsx-runtime").JSX.Element;
+declare const RoadEditToolbar: ({ visible, selectedRoadId, currentMode, enabledButtons, pointCount, hintMessage, showHint, color, size, iconOnly, children, onEdit, onRedraw, onCreate, onCancel, onSave, onDelete, }: RoadEditToolbarProps) => JSX.Element;
 export default RoadEditToolbar;

package/dist/components/Track/ClusterView.d.ts

@@ -3,8 +3,8 @@
  * @module components/Track/ClusterView
  */
 import React from 'react';
-import L from 'leaflet';
-import Supercluster from 'supercluster';
+import type L from 'leaflet';
+import type Supercluster from 'supercluster';
 import type { ClusterIconConfig } from '../../types';
 import type { MiniMapProps } from '../../types';
 interface ClusterViewProps {

package/dist/components/Track/TrackView.d.ts

@@ -14,10 +14,10 @@ interface TrackViewProps {
     getStyles: (state: number, isSelected: boolean, isHovered: boolean) => any;
     handleTrackClick: (trackKey: string) => void;
     handleTrackHover: (trackKey: string, isHovered: boolean) => void;
-    renderStartEndMarkers: (trackKey: string, points: Array<{
+    renderStartEndMarkers: (trackKey: string, points: {
         position: [number, number];
         state: number;
-    }>) => React.ReactNode | null;
+    }[]) => React.ReactNode | null;
     polylineRefs: React.MutableRefObject<Map<string, any>>;
 }
 declare const _default: React.NamedExoticComponent<TrackViewProps>;

package/dist/components/Track/commands.d.ts

@@ -32,9 +32,9 @@ export declare function computeTrackStats<T extends {
 /**
  * 从轨迹列表中提取 bounds 并安全构建 latLngBounds
  */
-export declare function safeLatLngBounds(tracks: Array<{
+export declare function safeLatLngBounds(tracks: {
     bounds?: any;
-}>): L.LatLngBounds | null;
+}[]): L.LatLngBounds | null;
 /**
  * 飞行到指定 bounds（带动画时长计算）
  */

package/dist/components/Track/types.d.ts

@@ -23,13 +23,13 @@ export interface TrackPointProperties {
 }
 /** 筛选结果类型 */
 export interface FilterResult {
-    tracks: Array<{
+    tracks: {
         key: string;
         imei: string;
         date: string;
         bounds: any;
         pointCount: number;
-    }>;
+    }[];
     imeis: string[];
     dates: string[];
     totalTracks: number;

package/dist/components/shared/ToolbarButton.d.ts

@@ -18,6 +18,8 @@ export interface ToolbarButtonProps extends React.ButtonHTMLAttributes<HTMLButto
     iconOnly?: boolean;
     /** 类名前缀（可选，默认从 Context 获取） */
     classPrefix?: string;
+    /** 提示文本（Tooltip） */
+    tooltip?: string;
     /** 子元素 */
     children?: React.ReactNode;
 }
@@ -43,6 +45,11 @@ export interface ToolbarButtonProps extends React.ButtonHTMLAttributes<HTMLButto
  * <ToolbarButton variant="danger" icon={<DeleteIcon />}>
  *   删除
  * </ToolbarButton>
+ *
+ * // 带 Tooltip
+ * <ToolbarButton variant="primary" tooltip="提示信息">
+ *   按钮
+ * </ToolbarButton>
  * ```
  */
 declare const ToolbarButton: import("react").ForwardRefExoticComponent<ToolbarButtonProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/components/shared/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * 共享组件导出
  */
-export { default as BaseEditToolbar, type BaseEditToolbarProps, type BaseEditToolbarRef, type ButtonVariant, type ToolbarColor, type ToolbarPresetColors, type ToolbarSize, ToolbarContext, useToolbarContext } from './BaseEditToolbar';
+export { default as BaseEditToolbar, type BaseEditToolbarProps, type BaseEditToolbarRef, type ButtonVariant, type ToolbarColor, type ToolbarPresetColors, type ToolbarSize, ToolbarContext, useToolbarContext, } from './BaseEditToolbar';
 export { default as ToolbarButton, type ToolbarButtonProps } from './ToolbarButton';

package/dist/constants/index.d.ts

@@ -12,9 +12,9 @@
  * - styles.ts: 默认 PathOptions 样式常量
  */
 export { PlotType, PlotStatus, PLOT_TYPE_COLORS, getPlotTypeColor, type PlotTypeColorConfig, } from './plot';
-export { RoadType, ROAD_TYPE_STYLES, } from './road';
-export { DeviceType, DEVICE_TYPE_COLORS, } from './device';
-export { DEFAULT_MAP_CONFIG, } from './map';
-export { UNIT_CONVERSION, } from './unit';
+export { RoadType, ROAD_TYPE_STYLES } from './road';
+export { DeviceType, DEVICE_TYPE_COLORS } from './device';
+export { DEFAULT_MAP_CONFIG } from './map';
+export { UNIT_CONVERSION } from './unit';
 export { THEME_CONFIG, THEME_CSS_VARS, getThemeColors, type ThemeMode, type ThemeColors, } from './theme';
 export { PLOT_DEFAULT_PATH, PLOT_DEFAULT_SELECTED_PATH, PLOT_DEFAULT_EDIT_PATH, PLOT_DEFAULT_HIGHLIGHT_PATH, PLOT_FALLBACK_PATH, PLOT_PM_CREATE_OPTIONS, PLOT_CLIP_FRAGMENT_DEFAULT, PLOT_CLIP_FRAGMENT_SELECTED, ROAD_DEFAULT_PATH, ROAD_DEFAULT_SELECTED_PATH, ROAD_PM_PATH_OPTIONS, IRRIGATION_DEFAULT_PATH, IRRIGATION_DEFAULT_SELECTED_PATH, IRRIGATION_PM_PATH_OPTIONS, PM_TEMPLATE_LINE_STYLE, PM_HINT_LINE_STYLE, PM_DRAW_COMMON_OPTIONS, } from './styles';

package/dist/hooks/index.d.ts

@@ -6,3 +6,4 @@ export { useEditMode, type EditModeConfig, type EditModeResult } from './useEdit
 export { useTheme } from './useTheme';
 export { usePolylineRenderer } from './usePolylineRenderer';
 export { usePolylineEditor, usePolylineSave } from './usePolylineEditor';
+export { useLoadingOverlay, type UseLoadingOverlayOptions } from './useLoadingOverlay';

package/dist/hooks/useLoadingOverlay.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Loading 覆盖层 Hook
+ * @description 提取各组件中重复的 Loading 覆盖层逻辑
+ */
+import type L from 'leaflet';
+import type { LoadingMaskConfig } from '../types';
+import type { LoadingIconName, LoadingSize } from '../types/loading';
+export interface UseLoadingOverlayOptions {
+    /** 是否显示加载状态 */
+    loading: boolean;
+    /** Loading 遮罩配置 */
+    loadingMask?: LoadingMaskConfig;
+    /** Leaflet 地图实例 */
+    map: L.Map;
+    /** Loading 覆盖层的 CSS 类名 */
+    className: string;
+    /** 自定义 Loading 图标名称，默认为 'loading-spinner' */
+    icon?: LoadingIconName;
+    /** 自定义 Loading 尺寸，默认为 'large' */
+    size?: LoadingSize;
+}
+/**
+ * Loading 覆盖层 Hook
+ *
+ * @description
+ * 提取各图层组件中重复的 Loading 覆盖层逻辑，包括：
+ * - PlotLayer / PlotGroupLayer
+ * - Road / Irrigation
+ * - Marker
+ *
+ * @example
+ * ```tsx
+ * const loadingOverlay = useLoadingOverlay({
+ *   loading,
+ *   loadingMask,
+ *   map,
+ *   className: 'agri-plot-loading-overlay',
+ * });
+ *
+ * return (
+ *   <>
+ *     {/* 其他内容 *}
+ *     {loadingOverlay}
+ *   </>
+ * );
+ * ```
+ */
+export declare function useLoadingOverlay(options: UseLoadingOverlayOptions): React.ReactNode | null;

package/dist/hooks/usePolylineCommon.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview 线要素通用逻辑 Hook
+ * @description 提取 Road 和 Irrigation 组件的共享逻辑：
+ * - 样式合并（default/selected/editing）
+ * - 编辑态顶点颜色处理
+ * - 创建/编辑模式下的地图类名和 CSS 变量管理
+ * - 工具栏按钮处理框架
+ */
+import type L from 'leaflet';
+import type { PathOptions } from '../types';
+/**
+ * 线要素类型
+ */
+export type PolylineType = 'road' | 'irrigation';
+/**
+ * 编辑模式类型
+ */
+export type PolylineEditMode = 'idle' | 'create' | 'edit';
+/**
+ * 样式配置接口
+ */
+export interface PolylineStyleConfig {
+    /** 默认样式 */
+    defaultPath: PathOptions;
+    /** 选中样式 */
+    selectedPath: PathOptions;
+    /** 编辑样式 */
+    editingPath: PathOptions;
+    /** 编辑态顶点颜色（可选，用于覆盖默认颜色） */
+    editingVertexColor?: string;
+}
+/**
+ * 模式样式常量接口
+ */
+export interface ModeStyleConstants {
+    /** 默认路径样式常量 */
+    defaultPathConstant: PathOptions;
+    /** 选中路径样式常量 */
+    selectedPathConstant: PathOptions;
+    /** 编辑路径样式常量 */
+    editingPathConstant: PathOptions;
+}
+/**
+ * usePolylineCommon Options
+ */
+export interface UsePolylineCommonOptions {
+    /** 线要素类型：'road' | 'irrigation' */
+    type: PolylineType;
+    /** 组件 props 中的 options */
+    optionsProp?: {
+        default?: PathOptions;
+        selected?: PathOptions;
+        editing?: PathOptions & {
+            vertexColor?: string;
+        };
+    };
+    /** 旧版 path prop（仅 irrigation 需要） */
+    pathProp?: PathOptions;
+    /** 旧版 selectedPath prop（仅 irrigation 需要） */
+    selectedPathProp?: PathOptions;
+    /** 样式常量 */
+    constants: ModeStyleConstants;
+    /** Leaflet 地图实例 */
+    map: L.Map | null;
+    /** 当前编辑模式 */
+    currentMode: PolylineEditMode;
+}
+/**
+ * usePolylineCommon Return
+ */
+export interface UsePolylineCommonReturn {
+    /** 合并后的默认样式 */
+    defaultPath: L.PathOptions;
+    /** 合并后的选中样式 */
+    selectedPath: L.PathOptions;
+    /** 合并后的编辑样式 */
+    editingPath: L.PathOptions;
+    /** 编辑态顶点颜色 */
+    editingVertexColor: string;
+}
+/**
+ * 线要素通用逻辑 Hook
+ *
+ * @description
+ * 提取 Road 和 Irrigation 组件的共享逻辑，包括：
+ * 1. 三态样式合并（options prop > 旧 prop > 默认常量）
+ * 2. 编辑态顶点颜色处理
+ * 3. 创建/编辑模式下的地图类名和 CSS 变量管理
+ *
+ * @example
+ * ```tsx
+ * const { defaultPath, selectedPath, editingPath, editingVertexColor } = usePolylineCommon({
+ *   type: 'road',
+ *   optionsProp,
+ *   constants: {
+ *     defaultPathConstant: ROAD_DEFAULT_PATH,
+ *     selectedPathConstant: ROAD_DEFAULT_SELECTED_PATH,
+ *     editingPathConstant: ROAD_DEFAULT_EDIT_PATH,
+ *   },
+ *   map,
+ *   currentMode,
+ * });
+ * ```
+ */
+export declare function usePolylineCommon(options: UsePolylineCommonOptions): UsePolylineCommonReturn;

package/dist/hooks/usePolylineEditor.d.ts

@@ -9,7 +9,7 @@
  * - normalizedData 变化时自动重置 pendingCreate 状态
  * - pm:create / pm:edit 事件监听
  */
-import L from 'leaflet';
+import type L from 'leaflet';
 import type { Coordinate } from '../types';
 export interface UsePolylineEditorOptions {
     /** Leaflet 地图实例 */