giser-geometry-parse 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+export type Position = [number, number] | [number, number, number];
+export interface Point {
+    type: 'Point';
+    coordinates: Position;
+}
+export interface LineString {
+    type: 'LineString';
+    coordinates: Position[];
+}
+export interface Polygon {
+    type: 'Polygon';
+    coordinates: Position[][];
+}
+export interface MultiPoint {
+    type: 'MultiPoint';
+    coordinates: Position[];
+}
+export interface MultiLineString {
+    type: 'MultiLineString';
+    coordinates: Position[][];
+}
+export interface MultiPolygon {
+    type: 'MultiPolygon';
+    coordinates: Position[][][];
+}
+export interface GeometryCollection {
+    type: 'GeometryCollection';
+    geometries: Geometry[];
+}
+export type Geometry = Point | LineString | Polygon | MultiPoint | MultiLineString | MultiPolygon | GeometryCollection;
+/** GeoJSON Feature，包含一个 Geometry 和任意属性 */
+export interface Feature<G extends Geometry = Geometry> {
+    type: 'Feature';
+    geometry: G | null;
+    properties: Record<string, unknown> | null;
+    id?: string | number;
+}
+/** GeoJSON FeatureCollection，包含多个 Feature */
+export interface FeatureCollection {
+    type: 'FeatureCollection';
+    features: Feature[];
+}
+/** 所有 GeoJSON 对象的联合类型 */
+export type GeoJSONObject = Geometry | Feature | FeatureCollection;
+/**
+ * @deprecated 请使用 `GeoJSONObject`（包含 Geometry、Feature、FeatureCollection）
+ *             或直接使用 `Geometry` 类型（仅几何体）。
+ *             此别名保留用于向后兼容。
+ */
+export type GeoJSON = GeoJSONObject;
+export type WKTType = 'POINT' | 'LINESTRING' | 'POLYGON' | 'MULTIPOINT' | 'MULTILINESTRING' | 'MULTIPOLYGON' | 'GEOMETRYCOLLECTION';

package/dist/validate.d.ts

@@ -0,0 +1,29 @@
+import { Geometry } from './types';
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * 校验 WKT 字符串格式是否合法
+ */
+export declare function validateWKT(wkt: string): ValidationResult;
+/**
+ * 校验 GeoJSON Geometry 对象是否合法
+ */
+export declare function validateGeoJSON(geojson: unknown): ValidationResult;
+/**
+ * 尝试从可能不规范的 WKT 中恢复出有效结果
+ * 主要处理尾部多余字符的情况
+ */
+export declare function tryFixWKT(wkt: string): {
+    fixed: string;
+    changed: boolean;
+};
+/**
+ * 深度克隆 GeoJSON 对象（用于避免意外修改原对象）
+ */
+export declare function cloneGeometry<G extends Geometry>(geometry: G): G;
+/**
+ * 判断两个几何对象是否相等（坐标对比）
+ */
+export declare function geometryEquals(a: Geometry, b: Geometry): boolean;

package/dist/wkt-builder.d.ts

@@ -0,0 +1,17 @@
+import { Geometry } from './types';
+export declare class WKTBuilder {
+    build(geometry: Geometry): string;
+    private buildPoint;
+    private buildLineString;
+    private buildPolygon;
+    /**
+     * 按 OGC/ISO WKT 标准，MULTIPOINT 每个点用括号包裹：
+     * MULTIPOINT ((0 0), (1 1), (2 2))
+     */
+    private buildMultiPoint;
+    private buildMultiLineString;
+    private buildMultiPolygon;
+    private buildGeometryCollection;
+}
+/** 将 GeoJSON Geometry 对象转换为 WKT 字符串 */
+export declare function build(geometry: Geometry): string;

package/dist/wkt-parser.d.ts

@@ -0,0 +1,33 @@
+import { Geometry } from './types';
+export declare class WKTParser {
+    private tokens;
+    private pos;
+    parse(wkt: string): Geometry;
+    private peek;
+    private advance;
+    /** 消费当前 token 并返回，若类型不匹配则抛出错误 */
+    private consume;
+    private skipComma;
+    private isDone;
+    private parseGeometry;
+    private skipDimensionKeyword;
+    private isEmptyGeometry;
+    private parsePoint;
+    private parseLineString;
+    private parsePolygon;
+    private parseMultiPoint;
+    private parseMultiLineString;
+    private parseMultiPolygon;
+    private parseGeometryCollection;
+    /**
+     * 读取一个坐标点（自动检测维度：X Y 或 X Y Z）
+     * 读完 X、Y 后，若下一个 token 仍是 NUMBER，则继续读 Z
+     */
+    private parseCoordinates;
+    /** 解析带括号的坐标序列：( x y, x y, ... ) */
+    private parseCoordinatesList;
+    /** 解析环列表（Polygon 级别）：( (...), (...) ) */
+    private parseCoordinateListList;
+}
+/** 将 WKT 字符串解析为 GeoJSON Geometry 对象 */
+export declare function parse(wkt: string): Geometry;

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

@@ -0,0 +1,35 @@
+import { Geometry, Feature, FeatureCollection } from './types';
+/**
+ * 将 WKT 字符串转换为 GeoJSON Geometry 对象。
+ *
+ * @example
+ * wktToGeoJSON('POINT (30.5 40.5)')
+ * // → { type: 'Point', coordinates: [30.5, 40.5] }
+ *
+ * wktToGeoJSON('POLYGON ((0 0, 1 0, 1 1, 0 1, 0 0))')
+ * // → { type: 'Polygon', coordinates: [[[0,0],[1,0],[1,1],[0,1],[0,0]]] }
+ */
+export declare function wktToGeoJSON(wkt: string): Geometry;
+/**
+ * 将 WKT 字符串转换为 GeoJSON Feature 对象。
+ *
+ * @param wkt       WKT 字符串
+ * @param properties 可选的 Feature 属性对象
+ * @param id         可选的 Feature ID
+ *
+ * @example
+ * wktToFeature('POINT (30.5 40.5)', { name: '北京' })
+ * // → { type: 'Feature', geometry: { type: 'Point', ... }, properties: { name: '北京' } }
+ */
+export declare function wktToFeature(wkt: string, properties?: Record<string, unknown> | null, id?: string | number): Feature;
+/**
+ * 将多个 WKT 字符串批量转换为 GeoJSON FeatureCollection。
+ *
+ * @param wkts        WKT 字符串数组
+ * @param properties  可选，每个 Feature 的属性数组（长度应与 wkts 一致）
+ *
+ * @example
+ * wktToFeatureCollection(['POINT (0 0)', 'POINT (1 1)'])
+ * // → { type: 'FeatureCollection', features: [...] }
+ */
+export declare function wktToFeatureCollection(wkts: string[], properties?: Array<Record<string, unknown> | null>): FeatureCollection;

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "giser-geometry-parse",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Zero-dependency WKT parser/builder and WKT↔GeoJSON converter",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "wkt",
+    "geojson",
+    "geometry",
+    "parser",
+    "builder",
+    "gis",
+    "ogc",
+    "spatial"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^12.1.2",
+    "rollup": "^4.40.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.8.3"
+  }
+}