@fleet-frontend/mower-maps 0.2.5-beta.3 → 0.2.5-beta.4

package/README.md

@@ -1 +1,39 @@
-暂无
+# Mower Maps
+
+## 放大镜功能介绍
+
+放大镜用于在编辑禁区顶点时，提供局部放大预览，帮助用户更精准地拖拽点位并对齐底图。
+
+### 功能特点
+
+- 仅在 `H5` 平台显示（`platform === PlatformType.H5`）。
+- 拖拽禁区顶点时自动出现，结束拖拽后自动隐藏。
+- 放大镜位置会根据拖拽点自动切换左右，尽量避免遮挡编辑区域。
+- 使用圆形镜片样式，默认尺寸 `130px`，白色边框 `2px`。
+- 放大镜内禁区点和线会增强显示，便于观察与操作。
+
+### 底图渲染方式
+
+放大镜底图优先使用 Google Static Maps API，按当前地图视口生成静态背景图，再与 SVG 图层一起渲染，保证编辑点与底图尽量对齐。
+
+为避免在 npm 包中暴露密钥，静态地图 API Key 需要由业务侧传入：
+
+- 配置名：`googleMapStaticApiKey`
+- 位置：`MowerMapRenderer` 组件 props
+
+### 使用方式
+
+```tsx
+<MowerMapRenderer
+  platform={PlatformType.H5}
+  mapJson={mapData}
+  pathJson={pathData}
+  googleMapStaticApiKey={process.env.REACT_APP_GOOGLE_STATIC_MAP_KEY}
+  // ...其他配置
+/>
+```
+
+### 注意事项
+
+- 若未传 `googleMapStaticApiKey`，放大镜将无法请求静态底图。
+- 外部项目使用新字段前，请确保已安装包含最新类型声明的包版本（避免出现“字段不存在”的 TS/ESLint 报错）。

package/dist/context/common.d.ts

@@ -19,38 +19,73 @@ interface CommonContextType {
     drag: {
         x?: number;
         y?: number;
+        rotate?: number;
         rotation?: number;
     };
     mapRef: any;
     overlayScale?: number;
     showStraddleBoundaryBorder?: boolean;
     doodleList?: any[];
+    overlayLayout?: Record<string, any> | null;
+    bounds?: any;
+    googleMapStaticApiKey?: string;
+    onH5FirstSelectObstaclePoint?: () => void;
 }
 export declare const CommonContext: import("react").Context<{
     sn: string;
     editMap: boolean;
-    mowerIconConfig: {};
+    mowerIconConfig: {
+        mapImgUrl: string;
+        mapDisabledUrl: string;
+        mapNoPositionUrl: string;
+    };
     platform: PlatformType;
     svgViewBox: any;
     unitType: UnitsType;
+    mapConfig: {};
+    mapJson: any;
+    drag: {
+        x: number;
+        y: number;
+        rotate: number;
+        rotation: number;
+    };
     mapRef: any;
+    bounds: any;
     globalHeight: number;
     heightOptions: any[];
     overlayScale: number;
     showStraddleBoundaryBorder: boolean;
+    googleMapStaticApiKey: string;
+    onH5FirstSelectObstaclePoint: any;
 }>;
 export declare const CommonContextProvider: import("react").Provider<{
     sn: string;
     editMap: boolean;
-    mowerIconConfig: {};
+    mowerIconConfig: {
+        mapImgUrl: string;
+        mapDisabledUrl: string;
+        mapNoPositionUrl: string;
+    };
     platform: PlatformType;
     svgViewBox: any;
     unitType: UnitsType;
+    mapConfig: {};
+    mapJson: any;
+    drag: {
+        x: number;
+        y: number;
+        rotate: number;
+        rotation: number;
+    };
     mapRef: any;
+    bounds: any;
     globalHeight: number;
     heightOptions: any[];
     overlayScale: number;
     showStraddleBoundaryBorder: boolean;
+    googleMapStaticApiKey: string;
+    onH5FirstSelectObstaclePoint: any;
 }>;
 export declare const useCommonContext: () => CommonContextType;
 export {};

package/dist/context/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/context/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,MAAM,EAAE,GAAG,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;EAYxB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAAyB,CAAC;AAE5D,eAAO,MAAM,gBAAgB,yBAAqD,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/context/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,MAAM,EAAE,GAAG,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4BAA4B,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3C;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBxB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyB,CAAC;AAE5D,eAAO,MAAM,gBAAgB,yBAAqD,CAAC"}