@wenle_2523097/agri-map 1.0.2 → 1.0.4

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

@@ -0,0 +1,15 @@
+/**
+ * 全局配置提供者组件
+ * @description 使用 React Context 为子组件提供统一的全局配置
+ */
+import type { ConfigContextValue, ConfigProviderProps } from '../../types';
+/**
+ * 获取配置上下文的 Hook
+ * @returns 配置对象
+ */
+export declare const useConfig: () => ConfigContextValue;
+/**
+ * 全局配置提供者组件
+ */
+declare const ConfigProvider: ({ theme, dualScaleControl, tianDiTuLayer, mapSizeHandler, children }: ConfigProviderProps) => JSX.Element;
+export default ConfigProvider;

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

@@ -0,0 +1,10 @@
+/**
+ * 双向标尺组件
+ * @description 在地图上同时显示水平和垂直两个标尺，覆盖整个地图窗口
+ */
+import type { DualScaleControlProps } from '../../types';
+/**
+ * 双向标尺组件
+ */
+declare const DualScaleControl: ({ config: configProp, theme: themeProp, layerType, scaleColor: scaleColorProp, controlBg: controlBgProp, controlText: controlTextProp, }: DualScaleControlProps) => null;
+export default DualScaleControl;

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

@@ -0,0 +1,68 @@
+/**
+ * SelectIcon 图标选择器组件
+ * @description 兼容 antd Form 的 value/onChange 接口，用于选择预设地图图标
+ * @example
+ * // antd Form 中使用
+ * <Form.Item label="图标" name="icon">
+ *   <SelectIcon />
+ * </Form.Item>
+ *
+ * // 独立使用
+ * const [icon, setIcon] = useState('marker-blue');
+ * <SelectIcon value={icon} onChange={setIcon} />
+ */
+import { type CSSProperties } from 'react';
+import type { PresetIconName } from '../../types/icon';
+export interface IconGroupItem {
+    /** 图标名称（预设图标名称） */
+    type: PresetIconName;
+    /** 图标显示名称 */
+    name: string;
+}
+export interface IconGroup {
+    /** 分组标签 */
+    label: string;
+    /** 分组内图标列表 */
+    icons: IconGroupItem[];
+}
+/** 默认预设图标分组 */
+export declare const DEFAULT_ICON_GROUPS: IconGroup[];
+export interface IconPreviewProps {
+    /** 图标类型 */
+    iconType: string;
+    /** 图标尺寸，默认 24 */
+    size?: number;
+    /** 是否启用动画，默认 false */
+    animated?: boolean;
+    /** 样式 */
+    style?: CSSProperties;
+}
+/**
+ * 图标预览组件
+ * @description 根据图标类型渲染不同的预览效果
+ */
+export declare function IconPreview({ iconType, size, animated, style }: IconPreviewProps): JSX.Element;
+export interface SelectIconProps {
+    /** 当前选中值（兼容 antd Form） */
+    value?: string;
+    /** 选中变化回调（兼容 antd Form） */
+    onChange?: (value: string) => void;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 预览图标尺寸，默认 20 */
+    previewSize?: number;
+    /** 是否可清除 */
+    allowClear?: boolean;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 自定义 className */
+    className?: string;
+    /** 自定义图标分组（可选，默认使用预设分组） */
+    groups?: IconGroup[];
+    /** 主题模式，默认跟随系统浅色 */
+    theme?: 'light' | 'dark';
+}
+export declare function SelectIcon({ value, onChange, placeholder, disabled, previewSize, allowClear, style, className, groups, theme, }: SelectIconProps): JSX.Element;
+export default SelectIcon;

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

@@ -0,0 +1,43 @@
+/**
+ * SVG 图标组件库
+ * @description 统一的 SVG 图标组件，用于工具栏等场景
+ */
+/** 图标组件属性 */
+interface IconProps {
+    size?: number;
+    color?: string;
+    /** 无障碍标签文本 */
+    ariaLabel?: string;
+    /** 是否对屏幕阅读器隐藏，默认 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;
+/** 图标组件映射 */
+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;
+};
+export default Icons;
+export { SelectIcon, IconPreview, DEFAULT_ICON_GROUPS } from './SelectIcon';
+export type { SelectIconProps, IconPreviewProps, IconGroup, IconGroupItem } from './SelectIcon';

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

@@ -0,0 +1,8 @@
+/**
+ * 灌溉渠组件
+ */
+import '@geoman-io/leaflet-geoman-free';
+import 'leaflet-ant-path';
+import type { IrrigationProps, IrrigationRef } from '../../types';
+declare const Irrigation: import("react").ForwardRefExoticComponent<IrrigationProps & import("react").RefAttributes<IrrigationRef>>;
+export default Irrigation;

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

@@ -0,0 +1,6 @@
+/**
+ * 灌溉渠编辑工具栏组件
+ */
+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;
+export default IrrigationEditToolbar;

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

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Loading 加载组件
+ * @description 显示加载状态的组件，支持多种加载图标和自定义配置
+ * @module components/Loading
+ */
+import type { LoadingProps } from '../../types';
+/**
+ * Loading 加载组件
+ *
+ * @description
+ * 显示加载状态，支持以下功能：
+ * - 多种加载图标：loading-spinner（旋转圆圈）、loading-dots（跳动圆点）
+ * - 自定义尺寸：small、default、large 或数字
+ * - 描述文案：可选的加载提示文字
+ * - 遮罩配置：支持自定义背景色、层级等
+ *
+ * @example
+ * ```tsx
+ * import { Loading } from 'agri-map-components';
+ *
+ * // 基础用法
+ * <Loading />
+ *
+ * // 自定义图标和描述
+ * <Loading icon="loading-dots" description="加载中..." />
+ *
+ * // 自定义尺寸
+ * <Loading size="large" />
+ * <Loading size={64} />
+ *
+ * // 带遮罩
+ * <Loading mask />
+ * <Loading mask={{ background: 'rgba(0, 0, 0, 0.5)', zIndex: 999 }} />
+ *
+ * // 在 Marker 中使用
+ * <Marker loading={true} />
+ * ```
+ */
+declare const Loading: React.FC<LoadingProps>;
+export default Loading;

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

@@ -0,0 +1,17 @@
+/**
+ * 地图内容组件
+ * @description 根据 ConfigProvider 配置自动渲染地图子组件
+ */
+import type { MapContentProps } from '../../types';
+/**
+ * 地图内容组件
+ * @description 放在 MapContainer 内部，自动渲染 ConfigProvider 配置的组件
+ * @example
+ * <ConfigProvider dualScaleControl tianDiTuLayer={{ apiKey: 'xxx' }} mapSizeHandler>
+ *   <MapContainer>
+ *     <MapContent />
+ *   </MapContainer>
+ * </ConfigProvider>
+ */
+declare const MapContent: ({ children }: MapContentProps) => JSX.Element;
+export default MapContent;

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

@@ -0,0 +1,24 @@
+/**
+ * 地图尺寸处理器组件
+ * @description 解决地图容器尺寸变化后（如抽屉/对话框打开），地图不自动刷新的问题
+ */
+import type { MapSizeHandlerConfig } from '../../types';
+/**
+ * 地图尺寸处理器组件
+ * @description 通过多次调用 invalidateSize 确保地图在容器尺寸变化后正确渲染
+ *
+ * @example
+ * // 在 MapContent 中自动使用，通过 ConfigProvider 配置
+ * <ConfigProvider mapSizeHandler>
+ *   <MapContainer>
+ *     <MapContent />
+ *   </MapContainer>
+ * </ConfigProvider>
+ *
+ * // 自定义配置
+ * <ConfigProvider mapSizeHandler={{ delay: 200, retries: 5 }}>
+ *   ...
+ * </ConfigProvider>
+ */
+declare const MapSizeHandler: ({ enabled, delay, retries, }?: MapSizeHandlerConfig) => null;
+export default MapSizeHandler;

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

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Marker 聚合模式渲染子组件
+ * @module components/Marker/ClusterView
+ */
+import React from 'react';
+import L from 'leaflet';
+import Supercluster from 'supercluster';
+import type { MarkerData, ClusterIconConfig } from '../../types';
+interface ClusterViewProps {
+    /** 聚合结果数组（包含聚合气泡和单独点） */
+    clusterResults: Supercluster.ClusterFeature<any>[];
+    /** 单独 Marker 的图标 */
+    markerIcon: L.DivIcon;
+    /** 聚合气泡图标配置 */
+    clusterIconConfig?: ClusterIconConfig;
+    /** 是否永久显示 Tooltip，false 时悬停显示 */
+    showTooltip: boolean;
+    /** 聚合气泡点击处理 */
+    onClusterClick: (feature: Supercluster.ClusterFeature<Supercluster.AnyProps>) => void;
+    /** 单独 Marker 点击处理 */
+    onMarkerClick: (markerId: string | number) => void;
+    /** 获取 Marker 的 Tooltip 内容 */
+    getTooltipContent: (marker: MarkerData) => {
+        title?: string;
+        description?: string;
+    };
+}
+declare const _default: React.NamedExoticComponent<ClusterViewProps>;
+export default _default;

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

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview 地图点击处理器组件
+ * @description 处理地图点击事件，用于创建模式下的标注点创建和 Tooltip 关闭
+ * @module components/Marker/MapClickHandler
+ */
+import L from 'leaflet';
+/**
+ * 地图点击处理器属性
+ */
+interface MapClickHandlerProps {
+    /** 是否启用点击处理 */
+    enabled: boolean;
+    /** 是否存在临时标注点 */
+    hasTempMarker: boolean;
+    /** 地图点击回调 */
+    onMapClick: (latlng: L.LatLng) => void;
+    /** 点击非标注区域时的回调（用于关闭 Tooltip） */
+    onMapClickWithoutMarker?: () => void;
+}
+/**
+ * 地图点击处理器
+ * @description 处理地图点击事件，用于创建模式下的标注点创建和 Tooltip 关闭
+ */
+declare function MapClickHandler({ enabled, hasTempMarker, onMapClick, onMapClickWithoutMarker }: MapClickHandlerProps): null;
+export default MapClickHandler;

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

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Marker 标注组件
+ * @description 用于在地图上显示标注点，支持自定义图标、动画效果、编辑模式、聚合和 Tooltip 控制
+ * @module components/Marker
+ */
+import type { MarkerProps, MarkerRef } from '../../types';
+/**
+ * Marker 标注组件
+ *
+ * @description
+ * 用于在地图上显示标注点，支持以下功能：
+ * - 自定义图标：预设名称、SVG字符串、图片URL
+ * - 动画效果：脉冲动画
+ * - 编辑模式：创建、移动、删除标注点
+ * - Tooltip 控制：打开/关闭指定或所有标注点的 Tooltip
+ * - 选中状态：支持受控和非受控模式
+ *
+ * @example
+ * ```tsx
+ * import { Marker } from 'agri-map-components';
+ * import { useRef } from 'react';
+ *
+ * // 基础用法
+ * <Marker
+ *   icon="marker-blue"
+ *   dataSource={[
+ *     { id: 1, position: [29.95, 117.98], title: '标注点A' },
+ *     { id: 2, position: [29.96, 117.99], title: '标注点B' },
+ *   ]}
+ *   onClick={(item) => console.log('点击:', item)}
+ * />
+ *
+ * // 使用 ref 控制方法
+ * const markerRef = useRef(null);
+ * <Marker
+ *   ref={markerRef}
+ *   dataSource={data}
+ *   value={value}
+ *   onSelect={setValue}
+ * />
+ * <button onClick={() => markerRef.current?.openAllTooltips()}>显示所有 Tooltip</button>
+ *
+ * // 编辑模式
+ * <Marker
+ *   editMode={['create', 'move', 'delete']}
+ *   dataSource={data}
+ *   onCreate={(result) => console.log('新建:', result)}
+ *   onMove={(result) => console.log('移动:', result)}
+ *   onDelete={(result) => console.log('删除:', result)}
+ * />
+ *
+ * // 自定义图标
+ * <Marker
+ *   icon="<svg>...</svg>"
+ *   dataSource={data}
+ *   animated
+ * />
+ * ```
+ */
+declare const Marker: import("react").ForwardRefExoticComponent<MarkerProps & import("react").RefAttributes<MarkerRef>>;
+export default Marker;

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

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Marker 聚合配置解析
+ * @description 将 boolean | MarkerClusterConfig 三态配置解析为统一的配置对象
+ * @module components/Marker/parseClusterConfig
+ */
+import type { MarkerClusterConfig } from '../../types';
+export interface ParsedClusterConfig {
+    /** 是否启用聚合 */
+    enabled: boolean;
+    /** 聚合半径（像素） */
+    radius: number;
+    /** 聚合生效的最大缩放级别 */
+    maxZoom: number;
+    /** 最小聚合数量 */
+    minPoints: number;
+    /** 点击聚合气泡后的行为 */
+    onClickBehavior: 'zoom' | 'expand';
+}
+/**
+ * 解析 cluster 配置
+ * - undefined / false → 关闭聚合
+ * - true → 启用默认聚合配置
+ * - object → 自定义聚合参数
+ */
+export declare function parseClusterConfig(clusterConfig: boolean | MarkerClusterConfig | undefined): ParsedClusterConfig;

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

@@ -0,0 +1,6 @@
+/**
+ * 标注点编辑工具栏组件
+ */
+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;
+export default MarkerEditToolbar;

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

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Marker 编辑事件处理 hook
+ * @description 将编辑模式的状态管理和事件处理提取为独立 hook
+ * @module components/Marker/useEditHandlers
+ */
+import L from 'leaflet';
+import type { MarkerData, MarkerCreateResult, MarkerMoveResult } from '../../types';
+interface EditHandlersOptions {
+    enabledButtonsRef: React.MutableRefObject<('create' | 'edit' | 'move' | 'delete')[]>;
+    value: string | number | null;
+    dataSource: MarkerData[];
+    handleSelect: (id: string | number | null) => void;
+    onCreateRef: React.MutableRefObject<((result: MarkerCreateResult) => void) | undefined>;
+    onEditRef: React.MutableRefObject<((result: {
+        markerId: string | number;
+        marker: MarkerData;
+    }) => void) | undefined>;
+    onMoveRef: React.MutableRefObject<((result: MarkerMoveResult) => void) | undefined>;
+    onDeleteRef: React.MutableRefObject<((result: {
+        markerId: string | number;
+    }) => void) | undefined>;
+    onSaveRef: React.MutableRefObject<((result: {
+        mode: string;
+    } & (MarkerCreateResult | MarkerMoveResult)) => void) | undefined>;
+    closeTooltip: () => void;
+}
+/**
+ * Marker 编辑事件处理 hook
+ */
+export declare function useEditHandlers({ enabledButtonsRef, value, dataSource, handleSelect, onCreateRef, onEditRef, onMoveRef, onDeleteRef, onSaveRef, closeTooltip, }: EditHandlersOptions): {
+    currentMode: "idle" | "move" | "create";
+    tempMarker: MarkerData | null;
+    handleCreate: () => void;
+    handleEdit: () => void;
+    handleMove: () => void;
+    handleDelete: () => void;
+    handleCancel: () => void;
+    handleSave: () => void;
+    handleDragEnd: (id: string | number, e: L.DragEndEvent) => void;
+    handleMapClick: (latlng: L.LatLng) => void;
+    exitCreateMode: () => void;
+    exitEditMode: () => void;
+};
+export {};

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

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Marker 图标配置 hook
+ * @description 将图标解析、合并、生成逻辑抽取为独立 hook
+ * @module components/Marker/useIconConfig
+ */
+import L from 'leaflet';
+import type { MarkerData, MarkerIconsConfig } from '../../types';
+interface UseIconConfigOptions {
+    icons?: MarkerIconsConfig;
+    editEnabled: boolean;
+    currentMode: 'idle' | 'create' | 'move';
+    permanent: boolean;
+}
+/**
+ * Marker 图标配置 hook
+ * @description 管理图标配置的解析、合并和生成
+ */
+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];
+};
+export {};

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

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Marker 命令式方法 hook
+ * @description 将 useImperativeHandle 中的方法逻辑提取为独立 hook，便于维护
+ * @module components/Marker/useMarkerCommands
+ */
+import L from 'leaflet';
+import type { MarkerRef, MarkerData, MarkerEvents } from '../../types';
+interface UseMarkerCommandsOptions {
+    map: L.Map | null;
+    value: string | number | null;
+    dataSource: MarkerData[];
+    handleSelect: (id: string | number | null, index?: number) => void;
+    onClickRef: React.MutableRefObject<((item: MarkerData) => void) | undefined>;
+    onRowRef: React.MutableRefObject<((item: MarkerData, index: number) => MarkerEvents) | undefined>;
+    setActiveTooltipId: (id: string | number | null) => void;
+    setTooltipContentMap: React.Dispatch<React.SetStateAction<Map<string | number, {
+        title?: string;
+        description?: string;
+    }>>>;
+    exitCreateMode: () => void;
+    exitEditMode: () => void;
+    closeTooltip: () => void;
+}
+/**
+ * Marker 命令式方法 hook
+ * @description activeTooltipId 和 tooltipContentMap 的状态由调用方管理，
+ *              本 hook 只负责将方法绑定到 ref 上
+ */
+export declare function useMarkerCommands(ref: React.Ref<MarkerRef>, options: UseMarkerCommandsOptions): void;
+export {};

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

@@ -0,0 +1,20 @@
+/**
+ * 测量工具栏组件
+ * @description 提供地图上的长度和面积测量功能，基于 @geoman-io/leaflet-geoman-free
+ * @features
+ * - 测长度：绘制折线，实时显示长度
+ * - 测面积：绘制多边形，实时显示面积
+ * - 支持多种单位：m/km/ft/mi（长度）, sqm/sqkm/sqft/acre/hectare（面积）
+ * - 可配置位置：topleft/topright/bottomleft/bottomright
+ * - 实时显示测量值
+ * - 统一工具栏样式，与 BaseEditToolbar 保持一致
+ */
+import '@geoman-io/leaflet-geoman-free';
+import type { MeasurementToolbarProps, LengthUnit, MeasurementAreaUnit, UnitConfig } from '../../types/measurement';
+export declare const LENGTH_UNITS: Record<LengthUnit, UnitConfig>;
+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;
+export default MeasurementToolbar;

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

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview MiniMap 小地图组件
+ * @description 在主地图上显示轨迹概览和当前视口位置的小地图
+ * @module components/MiniMap
+ */
+import type { MiniMapProps } from '../../types';
+export type { MiniMapProps, TileLayerConfig } from '../../types';
+/**
+ * 小地图组件
+ * @description 在主地图上显示轨迹概览和当前视口位置
+ */
+declare const MiniMap: {
+    ({ show, width, height, zoomOffset, showTrackOverview, trackData, visibleTrackKeys, className, viewportColor, viewportBorderColor, tileLayer, }: MiniMapProps): null;
+    displayName: string;
+};
+export default MiniMap;

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

@@ -0,0 +1,12 @@
+/**
+ * 通知提醒组件
+ * @description 类似 antd Notification 的通知提醒框，显示在地图右下角
+ */
+import type { NotificationInstance, NotificationProps } from '../../types';
+/**
+ * 通知容器组件
+ * @param onClose - 通知关闭时的回调
+ * @param ref - ref 引用，暴露 open/close 方法
+ */
+declare const Notification: import("react").ForwardRefExoticComponent<NotificationProps & import("react").RefAttributes<NotificationInstance>>;
+export default Notification;

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

@@ -0,0 +1,8 @@
+/**
+ * PlotGroupLayer 多类型地块分组编排组件
+ * @description 将多种类型的地块分组渲染，每种类型对应一个独立的 PlotLayer 实例，
+ *   支持跨类型互斥选中、统一分组高亮、合并渲染统计等功能。
+ */
+import type { PlotGroupLayerProps, PlotGroupRef } from '../../types';
+declare const PlotGroupLayer: import("react").ForwardRefExoticComponent<PlotGroupLayerProps & import("react").RefAttributes<PlotGroupRef>>;
+export default PlotGroupLayer;

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

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview 高性能地块图层组件
+ */
+import '@geoman-io/leaflet-geoman-free';
+import type { PlotRef, PlotLayerProps } from '../../types';
+declare const PlotLayer: import("react").ForwardRefExoticComponent<PlotLayerProps & import("react").RefAttributes<PlotRef>>;
+export default PlotLayer;

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

@@ -0,0 +1,12 @@
+import type { RefObject } from 'react';
+import type L from 'leaflet';
+interface PlotLabelProps {
+    selectedIds?: (string | number)[];
+    labelFields?: string[];
+    layerByIdRef: RefObject<Record<string | number, L.Layer>>;
+}
+/**
+ * PlotLabel - 为选中地块显示标签的组件
+ */
+declare const PlotLabel: React.FC<PlotLabelProps>;
+export default PlotLabel;

package/dist/components/PlotLayer/leaflet-types.d.ts

@@ -0,0 +1,59 @@
+import type { MutableRefObject } from 'react';
+import L from 'leaflet';
+import type { PlotData, Coordinate } from '../../types';
+/** PlotLayer 图层类型扩展 */
+export interface PlotLayer extends L.Path {
+    feature?: GeoJSON.Feature;
+    plotData?: PlotData;
+    _path?: HTMLElement;
+    _moveHandlers?: {
+        onMouseDown: (e: L.LeafletMouseEvent) => void;
+        onMouseMove: (e: L.LeafletMouseEvent) => void;
+        onMouseUp: () => void;
+    };
+}
+export interface PmLayerOptions {
+    allowSelfIntersection?: boolean;
+}
+export interface PmLayerInstance {
+    enable?: (options?: PmLayerOptions) => void;
+    disable?: () => void;
+    enableLayerDrag?: () => void;
+    disableLayerDrag?: () => void;
+    _shape?: string;
+    _drawing?: boolean;
+}
+export interface PmMapInstance {
+    setLang: (lang: string) => void;
+    enableDraw: (shape: string, options?: Record<string, unknown>) => void;
+    disableDraw: () => void;
+    globalDrawModeEnabled?: () => boolean;
+}
+export interface EditEventHandlers {
+    pmEdit?: ((e: L.LeafletEvent) => void) | null;
+    pmDragEnd?: (() => void) | null;
+    pmDrag?: (() => void) | null;
+}
+export declare function getPmLayer(layer: L.Layer): PmLayerInstance | undefined;
+export declare function getPmMap(map: L.Map): PmMapInstance | undefined;
+export declare function getLeafletId(layer: L.Layer): number;
+/** 安全计算边界框（避免 Math.min/max spread 栈溢出） */
+export declare function computeBoundsFromCoordinates(boundaries: Coordinate[]): [number, number, number, number] | undefined;
+/** 清理 Geoman 编辑状态（解除事件监听 + 禁用图层编辑/拖拽） */
+export declare function cleanupPmEditing(editingLayerRef: {
+    current: PlotLayer | null;
+}, cleanupEditEvents: (layer: L.Layer | null) => void): void;
+/** 禁用地图绘制模式 */
+export declare function disableDrawMode(map: L.Map): void;
+export interface BuildPlotGeoJSONOptions {
+    layerByIdRef: MutableRefObject<Record<string | number, PlotLayer>>;
+    selectedIdsRef: MutableRefObject<(string | number)[]>;
+    getFeatureStyleRef: MutableRefObject<(feature: GeoJSON.Feature | undefined, isSelected: boolean) => L.PathOptions>;
+    handlePlotClickRef: MutableRefObject<(layer: L.Layer, feature: GeoJSON.Feature) => void>;
+    handleContextMenuRef: MutableRefObject<(layer: L.Layer, feature: GeoJSON.Feature, event: L.LeafletMouseEvent) => void>;
+    handleHoverRef: MutableRefObject<(layer: L.Layer, feature: GeoJSON.Feature, type: 'mouseover' | 'mouseout') => void>;
+    /** 图层创建后的额外处理（如设置 editingLayerRef） */
+    onLayerReady?: (feature: GeoJSON.Feature, layer: PlotLayer) => void;
+}
+/** 构建地块 GeoJSON 图层的标准配置（消除主渲染和 rebuildGeoJSONLayer 中的重复） */
+export declare function buildPlotGeoJSONOptions(params: BuildPlotGeoJSONOptions): L.GeoJSONOptions;

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

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview PlotLayer 组件配置解析
+ * @module components/PlotLayer/parseConfig
+ */
+import type { ParsedVirtualizationConfig } from './types';
+/**
+ * 解析 virtualization 配置
+ * - undefined / true → 启用虚拟化（默认参数）
+ * - false → 关闭虚拟化
+ * - object → 自定义参数
+ */
+export declare function parseVirtualizationConfig(virtualization: boolean | {
+    minZoom?: number;
+    maxZoom?: number;
+} | undefined): ParsedVirtualizationConfig;