@idm-plugin/geo 2.1.5 → 2.1.7

package/dist/json/src/index.d.ts

@@ -1,3 +1,5 @@
+/// <reference types="node" />
+/// <reference types="node" />
 import * as turf from '@turf/turf';
 export interface GeoJsonOptions {
     /** 圆的边数，默认64 */
@@ -14,6 +16,14 @@ export interface GeoJsonOptions {
     properties?: Record<string, any>;
 }
 export declare class GeoJsonHelper {
+    /**
+     * Buffer to ArrayBuffer
+     * 将 Node.js Buffer 转换为独立的 ArrayBuffer（byteOffset=0）。
+     * Node.js 的 Buffer.concat() 返回的 Buffer 共享内存池，直接用 .buffer 会读到错误偏移。
+     * @param buf
+     * @returns
+     */
+    static toArrayBuffer(buf: Buffer): ArrayBuffer;
     /**
      * 基于turf画圆，返回GeoJSON Feature<Polygon>
      * @param lng 圆心经度
@@ -31,13 +41,12 @@ export declare class GeoJsonHelper {
     static drawRect(start: number[], end: number[], options?: GeoJsonOptions): turf.Feature<turf.Polygon>;
     /**
      * 基于turf画线，返回GeoJSON Feature<LineString>
-     * 需要注意跨180度的情况
-     * @param start
-     * @param end
+     * 支持2个或以上的点，需要注意跨180度的情况
+     * @param coordinates 坐标点数组，每个元素为 [lng, lat]，至少2个点
      * @param options
      * @returns
      */
-    static drawLine(start: number[], end: number[], options?: GeoJsonOptions): turf.Feature<turf.LineString>;
+    static drawLine(coordinates: number[][], options?: GeoJsonOptions): turf.Feature<turf.LineString>;
     /**
      * 基于turf画多边形，返回GeoJSON Feature<Polygon>
      * @param coordinates
@@ -45,6 +54,14 @@ export declare class GeoJsonHelper {
      * @returns
      */
     static drawPolygon(coordinates: number[][], options?: GeoJsonOptions): turf.Feature<turf.Polygon>;
+    /**
+     * 基于turf画点，返回GeoJSON Feature<Point>
+     * @param lat
+     * @param lng
+     * @param options
+     * @returns
+     */
+    static drawPoint(lat: number, lng: number, options?: GeoJsonOptions): turf.Feature<turf.Point>;
     /**
      * 解析ORM GeoJSON Feature (圆), 返回FeatureCollection
      * @param feature
@@ -66,7 +83,7 @@ export declare class GeoJsonHelper {
      * @param feature
      * @param options
      * @returns
-     * 如果feature是线，则返回线的起点和终点以及线Feature
+     * 如果feature是线，则返回所有坐标点（首为start、尾为end、中间为point_N）以及线Feature
      */
     static parseLine(feature: turf.Feature<turf.LineString>, options?: GeoJsonOptions): turf.FeatureCollection<any>;
     /**
@@ -77,4 +94,49 @@ export declare class GeoJsonHelper {
      * 如果feature是多边形，则返回多边形的顶点和多边形Feature
      */
     static parsePolygon(feature: turf.Feature<turf.Polygon>, options?: GeoJsonOptions): turf.FeatureCollection<any>;
+    /**
+     * 解压 DEFLATE raw 数据（ZIP compressionMethod=8）。
+     * Node.js 环境使用内置 zlib.inflateRawSync；浏览器环境抛出错误提示使用异步版本。
+     */
+    private static _inflateRawSync;
+    /**
+     * 从 ZIP ArrayBuffer 中异步解析所有文件条目（浏览器 DecompressionStream）。
+     */
+    private static _parseZipEntries;
+    /**
+     * 将KML转换为GeoJSON
+     * @param kml
+     * @param options
+     * @returns
+     */
+    static convertKML2GeoJSON(kml: string, options?: GeoJsonOptions): Promise<turf.helpers.FeatureCollection<any, turf.helpers.Properties>>;
+    /**
+     * 将 KMZ（ZIP 内含 doc.kml 或首个 .kml 文件）异步转换为 GeoJSON。
+     * 浏览器环境通过 DecompressionStream 解压，Node.js 自动降级为同步 zlib。
+     * 典型用法：
+     *   const buffer = await file.arrayBuffer()  // 或 FileReader.readAsArrayBuffer()
+     *   const geoJson = await GeoJsonHelper.convertKMZ2GeoJSONAsync(buffer)
+     * @param buffer KMZ 文件的 ArrayBuffer
+     * @param options
+     */
+    static convertKMZ2GeoJSON(buffer: ArrayBuffer | Buffer, options?: GeoJsonOptions): Promise<turf.FeatureCollection<any>>;
+    /**
+     * 将 ZIP 文件中所有 .kml 文件合并转换为一个 GeoJSON FeatureCollection（异步）。
+     * 浏览器环境通过 DecompressionStream 解压，Node.js 自动降级为同步 zlib。
+     * 典型用法：
+     *   const buffer = await file.arrayBuffer()  // 或 FileReader.readAsArrayBuffer()
+     *   const geoJson = await GeoJsonHelper.convertZIP2GeoJSONAsync(buffer)
+     * @param buffer ZIP 文件的 ArrayBuffer
+     * @param options
+     */
+    static convertZIP2GeoJSON(buffer: ArrayBuffer | Buffer, options?: GeoJsonOptions): Promise<turf.FeatureCollection<any>>;
+    /**
+     * 将 Shapefile ZIP（含 .shp/.shx/.dbf/.prj）转换为 GeoJSON FeatureCollection。
+     * - ZIP 中可包含多组 shapefile（如 input1.shp + input2.shp）
+     * - .prj 投影文件会自动转换为 WGS84（由 shpjs + proj4 处理）
+     * - .dbf 属性字段会合并到每个 Feature 的 properties 中
+     * @param buffer ZIP 文件的 ArrayBuffer
+     * @param options
+     */
+    static convertSHP2GeoJSON(buffer: ArrayBuffer | Buffer, options?: GeoJsonOptions): Promise<turf.FeatureCollection<any>>;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@idm-plugin/geo",
   "private": false,
-  "version": "2.1.5",
+  "version": "2.1.7",
   "description": "idm plugin for geo in browser",
   "type": "module",
   "keywords": [
@@ -33,9 +33,18 @@
     "moment-timezone": "^0.5.45",
     "tz-lookup": "^6.1.25"
   },
+  "peerDependencies": {
+    "shpjs": "^6.2.0"
+  },
+  "peerDependenciesMeta": {
+    "shpjs": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/jest": "^25.2.2",
     "@types/node": "^18.14.2",
+    "@types/shpjs": "^3.4.7",
     "@types/tz-lookup": "^6.1.2",
     "@typescript-eslint/eslint-plugin": "^5.53.0",
     "@typescript-eslint/parser": "^5.53.0",
@@ -48,6 +57,7 @@
     "lint-staged": "^13.1.2",
     "prettier": "^2.8.4",
     "sass": "^1.58.3",
+    "shpjs": "6.2.0",
     "simple-git-hooks": "^2.8.1",
     "stylelint": "^15.2.0",
     "supertest": "^4.0.2",