@wenle_2523097/agri-map 1.0.2 → 1.0.3

package/dist/types/road.d.ts

@@ -0,0 +1,382 @@
+/**
+ * 道路相关类型定义
+ */
+import type { Coordinate, PathOptions } from './basic';
+import type { ReactNode } from 'react';
+/**
+ * 编辑模式对象配置（Road）
+ */
+export interface RoadEditModeConfig {
+    /** 启用的编辑按钮 */
+    enabled?: boolean | ('create' | 'edit' | 'redraw' | 'delete')[];
+    /** 自定义工具栏内容 */
+    toolbar?: ReactNode;
+    /** 内置按钮的统一颜色（支持预设色和自定义颜色如 #ff0000、rgba(255,0,0,0.5)） */
+    color?: 'default' | 'primary' | 'danger' | 'success' | 'warning' | 'error' | 'magenta' | 'volcano' | 'gold' | 'orange' | 'cyan' | 'geekblue' | 'purple' | string;
+    /** 内置按钮的统一尺寸（支持预设尺寸和自定义数字，单位 px） */
+    size?: 'large' | 'middle' | 'small' | number;
+    /** 是否仅显示图标（不显示文字），默认 false */
+    iconOnly?: boolean;
+}
+/**
+ * 蚁行路径配置
+ * @description 道路蚁行动画效果的配置选项
+ */
+export interface AntPathConfig {
+    /** 是否使用脉冲效果，默认 true */
+    pulse?: boolean;
+    /** 动画延迟（毫秒），默认 400 */
+    delay?: number;
+    /** 虚线样式，默认 'a, b, c, d' */
+    dashArray?: string | number[];
+    /** 虚线颜色，默认使用道路颜色 */
+    color?: string;
+    /** 线条宽度，默认使用道路宽度 */
+    weight?: number;
+    /** 透明度，默认 0.8 */
+    opacity?: number;
+}
+/**
+ * 蚁行路径显示模式
+ * @description 控制道路蚁行动画的显示方式
+ * @example
+ * ```tsx
+ * <Road antPath />  // 全部显示
+ * <Road antPath="selected" />  // 仅选中显示
+ * <Road antPath={{ enabled: true, config: { delay: 200 } }} />  // 完整配置
+ * ```
+ */
+export type AntPathMode = boolean | 'selected' | {
+    /** 是否显示：true=全部, 'selected'=仅选中, false/undefined=不显示 */
+    enabled?: boolean | 'selected';
+    /** 动画配置 */
+    config?: AntPathConfig;
+};
+/**
+ * 道路三态样式配置
+ * @description 统一管理默认态、选中态、编辑态的 Leaflet Path 样式
+ */
+export interface RoadPathOptions {
+    /** 默认态样式 */
+    default?: PathOptions;
+    /** 选中态样式 */
+    selected?: PathOptions;
+    /**
+     * 编辑态样式
+     * @description 除标准 PathOptions 外，支持 vertexColor 自定义顶点标记颜色
+     */
+    editing?: PathOptions & {
+        /** 编辑态顶点标记边框颜色，默认使用 editing.color */
+        vertexColor?: string;
+    };
+}
+/**
+ * 道路字段名映射
+ * @description 自定义 dataSource 中数据的字段名
+ */
+export interface RoadFieldNames {
+    /** 道路唯一标识字段名，默认 'id' */
+    id?: string;
+    /** 道路名称字段名，默认 'name' */
+    name?: string;
+    /** 坐标点数组字段名，默认 'points' */
+    points?: string;
+    /** 道路距离字段名，默认 'distance' */
+    distance?: string;
+}
+/**
+ * 道路数据
+ * @description 田间道路的基础数据结构
+ * @example
+ * ```ts
+ * const road: RoadData = {
+ *   id: 'road-1',
+ *   name: '主干道 A',
+ *   points: [[29.95, 117.98], [29.96, 117.99]],
+ *   distance: 500,
+ *   options: { default: { color: '#1668dc', weight: 10, opacity: 1 } }
+ * };
+ * ```
+ */
+export interface RoadData {
+    /** 道路唯一标识 */
+    id: string | number;
+    /** 道路名称 */
+    name?: string;
+    /**
+     * 道路经过的坐标点数组
+     * @description 坐标格式为 [纬度, 经度]
+     * @example [[29.95, 117.98], [29.96, 117.99]]
+     */
+    points: Coordinate[];
+    /**
+     * 道路距离（米）
+     * @description 可选字段，如未提供会自动计算
+     */
+    distance?: string | number;
+    /**
+     * 道路样式配置
+     * @description 该道路的专属样式，会覆盖组件的 options 配置
+     */
+    options?: RoadPathOptions;
+    /** 其他自定义字段 */
+    [key: string]: unknown;
+}
+/**
+ * 道路新建结果
+ * @description 新建道路后返回的数据
+ */
+export interface RoadCreateResult {
+    /** 道路经过的坐标点 */
+    points: Coordinate[];
+    /** 道路名称 */
+    name: string;
+}
+/**
+ * 道路编辑结果
+ * @description 编辑道路后返回的数据
+ */
+export interface RoadEditResult {
+    /** 被编辑的道路 ID */
+    roadId: string | number;
+    /** 编辑前的坐标点 */
+    oldPoints: Coordinate[];
+    /** 编辑后的坐标点 */
+    newPoints: Coordinate[];
+}
+/**
+ * 道路编辑抽屉结果
+ * @description 点击编辑按钮触发，用于打开编辑抽屉
+ */
+export interface RoadEditDrawerResult {
+    /** 被编辑的道路 ID */
+    roadId: string | number;
+    /** 道路数据 */
+    road: RoadData;
+}
+/**
+ * 道路删除结果
+ * @description 删除道路后返回的数据
+ */
+export interface RoadDeleteResult {
+    /** 被删除的道路 ID */
+    roadId: string | number;
+}
+/**
+ * Road 事件回调集合
+ * @description 统一的声明式事件管理，类似 Ant Design Table 的 onRow
+ */
+export interface RoadEvents {
+    /** 点击道路时的回调 */
+    onClick?: (road: RoadData) => void;
+    /** 选中状态变化时的回调 */
+    onSelect?: (id: string | number | null) => void;
+    /** 右键点击道路时的回调 */
+    onContextMenu?: (road: RoadData, e: L.LeafletMouseEvent) => void;
+}
+/**
+ * Road 组件 Ref
+ * @description 暴露给父组件的方法
+ */
+export interface RoadRef {
+    /** 退出创建模式 */
+    exitCreateMode: () => void;
+    /** 退出编辑模式 */
+    exitEditMode: () => void;
+    /** 调整地图视野以适应所有道路 */
+    fitBounds: () => void;
+    /** 获取当前选中的道路数据 */
+    getSelected: () => RoadData | null;
+    /** 设置选中的道路 */
+    setValue: (id: string | number | null) => void;
+    /** 清除选中状态 */
+    clearSelection: () => void;
+    /** 显示道路距离标签 */
+    showDistanceLabels: (roadId?: string | number) => void;
+    /** 隐藏道路距离标签 */
+    hideDistanceLabels: (roadId?: string | number) => void;
+    /** 显示选中道路的距离标签 */
+    showSelectedDistanceLabels: () => void;
+    /** 隐藏选中道路的距离标签 */
+    hideSelectedDistanceLabels: () => void;
+    /** 获取道路总距离（米） */
+    getDistance: (roadId: string | number) => number | null;
+    /** 显示道路箭头（蚁行动画） */
+    showAntPath: (roadId?: string | number) => void;
+    /** 隐藏道路箭头（蚁行动画） */
+    hideAntPath: (roadId?: string | number) => void;
+}
+/**
+ * 道路组件属性
+ * @description Road 组件的 Props 定义
+ */
+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 road - 被点击的道路数据
+     */
+    onClick?: (road: RoadData) => void;
+    /**
+     * 右键点击道路时的回调
+     * @param road - 被右键点击的道路数据
+     * @param event - Leaflet 鼠标事件
+     */
+    onContextMenu?: (road: RoadData, event: L.LeafletMouseEvent) => void;
+    /**
+     * 道路样式配置
+     * @description 统一管理默认态、选中态、编辑态的 Leaflet Path 样式
+     * @example
+     * ```ts
+     * options={{
+     *   default: { color: '#1668dc', weight: 10, opacity: 1 },
+     *   selected: { color: '#d32029', weight: 10, opacity: 1 },
+     *   editing: { color: '#d89614', weight: 10, opacity: 1 },
+     * }}
+     * ```
+     */
+    options?: RoadPathOptions;
+    /**
+     * 编辑模式
+     * @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 显示道路方向箭头动画
+     * @example
+     * ```tsx
+     * <Road antPath />  // 全部显示
+     * <Road antPath="selected" />  // 仅选中显示
+     * <Road antPath={{ enabled: true, config: { delay: 200 } }} />
+     * ```
+     */
+    antPath?: AntPathMode;
+    /**
+     * 是否显示道路长度标注
+     * @description 开启后，在每段道路中间显示距离标签
+     * @default false
+     */
+    showDistance?: boolean;
+    /**
+     * 仅显示选中道路的距离
+     * @description 当 showDistance 为 false 时，仅显示选中道路的距离标签
+     * @default false
+     */
+    showSelectedDistance?: boolean;
+    /**
+     * 是否显示编辑模式提示
+     * @description 开启后，进入编辑模式时会显示操作提示
+     * @default false
+     */
+    showEditHint?: boolean;
+    /**
+     * 统一的声明式事件管理（类似 Ant Design Table 的 onRow）
+     * @description 返回一个事件回调对象，可按需绑定事件，支持基于数据项的条件化事件处理
+     * @param road - 当前道路数据
+     * @param index - 当前道路在数据源中的索引
+     * @returns RoadEvents 事件回调对象
+     * @example
+     * ```tsx
+     * <Road
+     *   dataSource={roads}
+     *   onRow={(road, index) => ({
+     *     onClick: () => console.log('点击了', road.name),
+     *     onContextMenu: (road, e) => { e.originalEvent.preventDefault(); },
+     *   })}
+     * />
+     * ```
+     */
+    onRow?: (road: RoadData, index: number) => RoadEvents;
+    /**
+     * 是否显示加载状态
+     * @description 当为 true 时，在地图上显示加载动画覆盖层
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * 加载遮罩配置
+     * @description 自定义加载遮罩的样式
+     */
+    loadingMask?: {
+        /** 是否显示遮罩，默认 true */
+        enabled?: boolean;
+        /** 遮罩背景色，默认 'rgba(255, 255, 255, 0.7)' */
+        background?: string;
+        /** 遮罩层级，默认 1000 */
+        zIndex?: number;
+    };
+}

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

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

package/dist/types/toolbar.d.ts

@@ -0,0 +1,176 @@
+/**
+ * 工具栏相关类型定义
+ */
+import type { PlotEditMode } from './plot';
+import type { ReactNode } from 'react';
+import type { ToolbarColor, ToolbarSize } from '../components/shared/BaseEditToolbar';
+/**
+ * 地块编辑工具栏属性
+ * @description PlotEditToolbar 组件的 Props 定义
+ */
+export interface PlotEditToolbarProps {
+    /** 是否显示工具栏 */
+    visible: boolean;
+    /** 当前选中的地块 ID */
+    selectedPlotId: string | number | null;
+    /** 当前编辑模式 */
+    currentMode?: PlotEditMode;
+    /** 启用的按钮列表 */
+    enabledButtons?: ('redraw' | 'clip' | 'move' | 'create' | 'delete' | 'edit')[];
+    /** 提示信息 */
+    hintMessage?: string;
+    /** 是否显示编辑模式提示 */
+    showHint?: boolean;
+    /** 警告提示信息（不受 showHint 控制，始终显示） */
+    warningHint?: string;
+    /** 内置按钮的统一颜色 */
+    color?: ToolbarColor;
+    /** 工具栏尺寸 */
+    size?: ToolbarSize;
+    /** 是否仅显示图标（不显示文字） */
+    iconOnly?: boolean;
+    /** 自定义工具栏内容 */
+    children?: ReactNode;
+    /** 点击编辑按钮的回调（打开编辑抽屉） */
+    onEdit?: (plotId?: string | number | null) => void;
+    /** 点击重绘按钮的回调 */
+    onRedraw?: (plotId?: string | number | null) => void;
+    /** 点击剪辑按钮的回调 */
+    onClip?: (plotId?: string | number | null) => void;
+    /** 点击移动按钮的回调 */
+    onMove?: (plotId?: string | number | null) => void;
+    /** 点击新建按钮的回调 */
+    onCreate?: () => void;
+    /** 点击取消按钮的回调 */
+    onCancel?: () => void;
+    /** 点击保存按钮的回调 */
+    onSave?: (plotId?: string | number | null) => void;
+    /** 点击删除按钮的回调 */
+    onDelete?: (plotId?: string | number | null) => void;
+}
+/**
+ * 标注编辑工具栏属性
+ * @description MarkerEditToolbar 组件的 Props 定义
+ */
+export interface MarkerEditToolbarProps {
+    /** 是否显示工具栏 */
+    visible: boolean;
+    /** 当前选中的标注 ID */
+    selectedMarkerId: string | number | null;
+    /** 当前编辑模式 */
+    currentMode?: 'idle' | 'create' | 'move';
+    /** 启用的按钮列表 */
+    enabledButtons?: ('create' | 'edit' | 'move' | 'delete')[];
+    /** 提示信息 */
+    hintMessage?: string;
+    /** 是否显示编辑模式提示 */
+    showHint?: boolean;
+    /** 警告提示信息（不受 showHint 控制，始终显示） */
+    warningHint?: string;
+    /** 内置按钮的统一颜色 */
+    color?: ToolbarColor;
+    /** 工具栏尺寸 */
+    size?: ToolbarSize;
+    /** 是否仅显示图标（不显示文字） */
+    iconOnly?: boolean;
+    /** 自定义工具栏内容 */
+    children?: ReactNode;
+    /** 点击新建按钮的回调 */
+    onCreate?: () => void;
+    /** 点击编辑按钮的回调 */
+    onEdit?: (markerId?: string | number | null) => void;
+    /** 点击移动按钮的回调 */
+    onMove?: (markerId?: string | number | null) => void;
+    /** 点击取消按钮的回调 */
+    onCancel?: () => void;
+    /** 点击保存按钮的回调 */
+    onSave?: (markerId?: string | number | null) => void;
+    /** 点击删除按钮的回调 */
+    onDelete?: (markerId?: string | number | null) => void;
+}
+/**
+ * 道路编辑工具栏属性
+ * @description RoadEditToolbar 组件的 Props 定义
+ */
+export interface RoadEditToolbarProps {
+    /** 是否显示工具栏 */
+    visible: boolean;
+    /** 当前选中的道路 ID */
+    selectedRoadId: string | number | null;
+    /** 当前编辑模式 */
+    currentMode?: 'idle' | 'create' | 'edit';
+    /** 启用的按钮列表 */
+    enabledButtons?: ('create' | 'edit' | 'redraw' | 'delete')[];
+    /** 已绘制的点数量 */
+    pointCount?: number;
+    /** 提示信息 */
+    hintMessage?: string;
+    /** 是否显示编辑模式提示 */
+    showHint?: boolean;
+    /** 警告提示信息（不受 showHint 控制，始终显示） */
+    warningHint?: string;
+    /** 内置按钮的统一颜色 */
+    color?: ToolbarColor;
+    /** 工具栏尺寸 */
+    size?: ToolbarSize;
+    /** 是否仅显示图标（不显示文字） */
+    iconOnly?: boolean;
+    /** 自定义工具栏内容 */
+    children?: ReactNode;
+    /** 点击新建按钮的回调 */
+    onCreate?: () => void;
+    /** 点击编辑按钮的回调（打开编辑抽屉） */
+    onEdit?: (roadId?: string | number | null) => void;
+    /** 点击重绘按钮的回调 */
+    onRedraw?: (roadId?: string | number | null) => void;
+    /** 点击取消按钮的回调 */
+    onCancel?: () => void;
+    /** 点击保存按钮的回调 */
+    onSave?: (roadId?: string | number | null) => void;
+    /** 点击删除按钮的回调 */
+    onDelete?: (roadId?: string | number | null) => void;
+}
+/**
+ * 灌溉渠编辑工具栏属性
+ * @description IrrigationEditToolbar 组件的 Props 定义
+ */
+export interface IrrigationEditToolbarProps {
+    /** 是否显示工具栏 */
+    visible: boolean;
+    /** 当前选中的灌溉渠 ID */
+    selectedChannelId: string | number | null;
+    /** 当前编辑模式 */
+    currentMode?: 'idle' | 'create' | 'edit';
+    /** 启用的按钮列表 */
+    enabledButtons?: ('create' | 'edit' | 'redraw' | 'delete' | 'reverse')[];
+    /** 已绘制的点数量 */
+    pointCount?: number;
+    /** 提示信息 */
+    hintMessage?: string;
+    /** 自定义工具栏内容 */
+    children?: ReactNode;
+    /** 内置按钮的统一颜色 */
+    color?: ToolbarColor;
+    /** 工具栏尺寸 */
+    size?: ToolbarSize;
+    /** 是否仅显示图标（不显示文字） */
+    iconOnly?: boolean;
+    /** 点击新建按钮的回调 */
+    onCreate?: () => void;
+    /** 点击编辑按钮的回调 */
+    onEdit?: (channelId?: string | number | null) => void;
+    /** 点击重绘按钮的回调 */
+    onRedraw?: (channelId?: string | number | null) => void;
+    /** 点击取消按钮的回调 */
+    onCancel?: () => void;
+    /** 点击保存按钮的回调 */
+    onSave?: (channelId?: string | number | null) => void;
+    /** 点击删除按钮的回调 */
+    onDelete?: (channelId?: string | number | null) => void;
+    /** 点击反转按钮的回调 */
+    onReverse?: (channelId?: string | number | null) => void;
+    /** 是否显示编辑模式提示 */
+    showHint?: boolean;
+    /** 警告提示信息（不受 showHint 控制，始终显示） */
+    warningHint?: string;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../src/types/toolbar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEtF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,aAAa;IACb,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;IAC/E,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,YAAY;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,wBAAwB;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC3D,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,YAAY;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB;IACjB,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC7D,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,YAAY;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,wBAAwB;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC;IACzE,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gBAAgB;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,YAAY;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD,gBAAgB;IAChB,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzD,iBAAiB;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}