wkt-parse-and-geojson 1.0.0

package/dist/geojson-builder.d.ts

@@ -0,0 +1,92 @@
+import { Position, Geometry, Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, GeometryCollection } from './types';
+/**
+ * GeoJSON 几何对象构建器（类形式，方便组合使用）
+ */
+export declare class GeoJSONBuilder {
+    createPoint(x: number, y: number, z?: number): Point;
+    createLineString(coordinates: Position[]): LineString;
+    /**
+     * 创建 Polygon。
+     * - 传入 `Position[]`：视为单个外环，自动包装为 `[ring]`
+     * - 传入 `Position[][]`：视为完整的环列表（外环 + 内环/空洞）
+     */
+    createPolygon(coordinates: Position[] | Position[][]): Polygon;
+    /**
+     * 创建 MultiPoint。
+     * - 传入 `Position`：视为单个点，自动包装为 `[point]`
+     * - 传入 `Position[]`：视为多个点
+     */
+    createMultiPoint(coordinates: Position | Position[]): MultiPoint;
+    /**
+     * 创建 MultiLineString。
+     * - 传入 `Position[]`：视为单条线，自动包装为 `[line]`
+     * - 传入 `Position[][]`：视为多条线
+     */
+    createMultiLineString(coordinates: Position[] | Position[][]): MultiLineString;
+    /**
+     * 创建 MultiPolygon。
+     * - 传入 `Position[][]`：视为单个多边形（环列表），自动包装为 `[polygon]`
+     * - 传入 `Position[][][]`：视为多个多边形
+     */
+    createMultiPolygon(coordinates: Position[][] | Position[][][]): MultiPolygon;
+    /**
+     * 创建 GeometryCollection。
+     * - 传入单个 `Geometry`：自动包装为 `[geometry]`
+     * - 传入 `Geometry[]`：直接使用
+     */
+    createGeometryCollection(geometries: Geometry | Geometry[]): GeometryCollection;
+}
+/** 创建 Point */
+export declare function createPoint(x: number, y: number, z?: number): Point;
+/** 创建 LineString */
+export declare function createLineString(coordinates: Position[]): LineString;
+/**
+ * 创建 Polygon。
+ * - 传入 `Position[]`：单个外环，自动包装
+ * - 传入 `Position[][]`：外环 + 内环（空洞）
+ *
+ * @example
+ * createPolygon([[0,0],[1,0],[1,1],[0,1],[0,0]])
+ * createPolygon([[[0,0],[10,0],[10,10],[0,10],[0,0]], [[2,2],[4,2],[4,4],[2,4],[2,2]]])
+ */
+export declare function createPolygon(coordinates: Position[] | Position[][]): Polygon;
+/**
+ * 创建 MultiPoint。
+ * - 传入 `Position`：单个点
+ * - 传入 `Position[]`：多个点
+ *
+ * @example
+ * createMultiPoint([0, 0])
+ * createMultiPoint([[0,0],[1,1],[2,2]])
+ */
+export declare function createMultiPoint(coordinates: Position | Position[]): MultiPoint;
+/**
+ * 创建 MultiLineString。
+ * - 传入 `Position[]`：单条线
+ * - 传入 `Position[][]`：多条线
+ *
+ * @example
+ * createMultiLineString([[0,0],[1,1]])
+ * createMultiLineString([[[0,0],[1,1]], [[2,2],[3,3]]])
+ */
+export declare function createMultiLineString(coordinates: Position[] | Position[][]): MultiLineString;
+/**
+ * 创建 MultiPolygon。
+ * - 传入 `Position[][]`：单个多边形（环列表）
+ * - 传入 `Position[][][]`：多个多边形
+ *
+ * @example
+ * createMultiPolygon([[[0,0],[1,0],[1,1],[0,1],[0,0]]])
+ * createMultiPolygon([[[[0,0],[1,0],[1,1],[0,1],[0,0]]], [[[2,2],[3,2],[3,3],[2,3],[2,2]]]])
+ */
+export declare function createMultiPolygon(coordinates: Position[][] | Position[][][]): MultiPolygon;
+/**
+ * 创建 GeometryCollection。
+ * - 传入单个 `Geometry`：自动包装
+ * - 传入 `Geometry[]`：直接使用
+ *
+ * @example
+ * createGeometryCollection(createPoint(0, 0))
+ * createGeometryCollection([createPoint(0,0), createLineString([[0,0],[1,1]])])
+ */
+export declare function createGeometryCollection(geometries: Geometry | Geometry[]): GeometryCollection;

package/dist/geojson-to-wkt.d.ts

@@ -0,0 +1,32 @@
+import { Geometry, Feature, FeatureCollection } from './types';
+/**
+ * 将 GeoJSON Geometry 对象转换为 WKT 字符串。
+ *
+ * @example
+ * geojsonToWkt({ type: 'Point', coordinates: [30.5, 40.5] })
+ * // → 'POINT (30.5 40.5)'
+ *
+ * geojsonToWkt({ type: 'Polygon', coordinates: [[[0,0],[1,0],[1,1],[0,1],[0,0]]] })
+ * // → 'POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0))'
+ */
+export declare function geojsonToWkt(geojson: Geometry): string;
+/**
+ * 将 GeoJSON Feature 对象转换为 WKT 字符串（取 geometry 部分）。
+ *
+ * @throws 若 Feature.geometry 为 null，则抛出错误
+ *
+ * @example
+ * featureToWkt({ type: 'Feature', geometry: { type: 'Point', coordinates: [0, 0] }, properties: null })
+ * // → 'POINT (0 0)'
+ */
+export declare function featureToWkt(feature: Feature): string;
+/**
+ * 将 GeoJSON FeatureCollection 中所有 Feature 转换为 WKT 字符串数组。
+ *
+ * geometry 为 null 的 Feature 会被跳过（返回数组中对应位置为 null）。
+ *
+ * @example
+ * featureCollectionToWkt({ type: 'FeatureCollection', features: [...] })
+ * // → ['POINT (0 0)', 'LINESTRING (0 0, 1 1)', ...]
+ */
+export declare function featureCollectionToWkt(fc: FeatureCollection): Array<string | null>;