geo-polygonize 0.53.0 → 0.55.0

package/dist/standard/pkg-scalar/geo_polygonize.d.ts

@@ -33,6 +33,11 @@ export class WasmPolygonResult {
 
 export function polygonize(geojson_str: string, node_input?: boolean | null, snap_grid_size?: number | null, extract_only_polygonal?: boolean | null, report_mode?: boolean | null): string;
 
+/**
+ * Returns the exact retained topology contract for a GeoJSON canonical-options call.
+ */
+export function polygonizeFingerprintWithOptions(geojson_str: string, options_val: Partial<PolygonizerOptions>): string;
+
 /**
  * Polygonizes an Arrow IPC stream containing a GeoArrow LineString array.
  *
@@ -42,12 +47,20 @@ export function polygonize(geojson_str: string, node_input?: boolean | null, sna
  */
 export function polygonizeGeoArrowWithOptions(ipc_bytes: Uint8Array, options_val: Partial<PolygonizerOptions>): Uint8Array;
 
+/**
+ * Returns the complete versioned topology report for a GeoJSON canonical-options call.
+ *
+ * The report is the JSON serialization of `TopologyFingerprintV1`; it is the
+ * stable cross-binding success contract, not a polygon-only GeoJSON projection.
+ */
+export function polygonizeReportWithOptions(geojson_str: string, options_val: Partial<PolygonizerOptions>): string;
+
 /**
  * Polygonizes a GeoJSON FeatureCollection using the canonical `PolygonizerOptions`.
  *
- * This is the primary entry point for JavaScript users. It accepts a JSON string
- * of options and returns a JSON string representing the result, including faces,
- * dangles, cut-lines, and (optionally) provenance/diagnostics.
+ * This compatibility entry point returns polygons only. Use
+ * [`polygonize_report_with_options_js`] when dangles, cut edges, invalid rings,
+ * provenance, diagnostics, and exact coordinate encoding are required.
  */
 export function polygonizeWithOptions(geojson_str: string, options_val: Partial<PolygonizerOptions>): string;
 
@@ -64,7 +77,9 @@ export interface InitOutput {
     readonly __wbg_polygonizerwasmerror_free: (a: number, b: number) => void;
     readonly __wbg_wasmpolygonresult_free: (a: number, b: number) => void;
     readonly polygonize: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+    readonly polygonizeFingerprintWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
     readonly polygonizeGeoArrowWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
+    readonly polygonizeReportWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
     readonly polygonizeWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
     readonly polygonizeWithOptionsBuffer: (a: number, b: number, c: number, d: number, e: number, f: any, g: number, h: number) => [number, number, number];
     readonly polygonize_buffers: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];

package/dist/standard/pkg-scalar/geo_polygonize_bg.wasm.d.ts

@@ -4,7 +4,9 @@ export const memory: WebAssembly.Memory;
 export const __wbg_polygonizerwasmerror_free: (a: number, b: number) => void;
 export const __wbg_wasmpolygonresult_free: (a: number, b: number) => void;
 export const polygonize: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+export const polygonizeFingerprintWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
 export const polygonizeGeoArrowWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
+export const polygonizeReportWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
 export const polygonizeWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
 export const polygonizeWithOptionsBuffer: (a: number, b: number, c: number, d: number, e: number, f: any, g: number, h: number) => [number, number, number];
 export const polygonize_buffers: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];

package/dist/threads/es/index.js

@@ -328,6 +328,33 @@ function polygonize(geojson_str, node_input, snap_grid_size, extract_only_polygo
     }
 }
 
+/**
+ * Returns the exact retained topology contract for a GeoJSON canonical-options call.
+ * @param {string} geojson_str
+ * @param {any} options_val
+ * @returns {string}
+ */
+function polygonizeFingerprintWithOptions(geojson_str, options_val) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(geojson_str, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.polygonizeFingerprintWithOptions(ptr0, len0, options_val);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * Polygonizes an Arrow IPC stream containing a GeoArrow LineString array.
  *
@@ -350,12 +377,42 @@ function polygonizeGeoArrowWithOptions(ipc_bytes, options_val) {
     return v2;
 }
 
+/**
+ * Returns the complete versioned topology report for a GeoJSON canonical-options call.
+ *
+ * The report is the JSON serialization of `TopologyFingerprintV1`; it is the
+ * stable cross-binding success contract, not a polygon-only GeoJSON projection.
+ * @param {string} geojson_str
+ * @param {any} options_val
+ * @returns {string}
+ */
+function polygonizeReportWithOptions(geojson_str, options_val) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const ptr0 = passStringToWasm0(geojson_str, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.polygonizeReportWithOptions(ptr0, len0, options_val);
+        var ptr2 = ret[0];
+        var len2 = ret[1];
+        if (ret[3]) {
+            ptr2 = 0; len2 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * Polygonizes a GeoJSON FeatureCollection using the canonical `PolygonizerOptions`.
  *
- * This is the primary entry point for JavaScript users. It accepts a JSON string
- * of options and returns a JSON string representing the result, including faces,
- * dangles, cut-lines, and (optionally) provenance/diagnostics.
+ * This compatibility entry point returns polygons only. Use
+ * [`polygonize_report_with_options_js`] when dangles, cut edges, invalid rings,
+ * provenance, diagnostics, and exact coordinate encoding are required.
  * @param {string} geojson_str
  * @param {any} options_val
  * @returns {string}
@@ -1143,7 +1200,9 @@ var geo_polygonize = /*#__PURE__*/Object.freeze({
   initSync: initSync,
   initThreadPool: initThreadPool,
   polygonize: polygonize,
+  polygonizeFingerprintWithOptions: polygonizeFingerprintWithOptions,
   polygonizeGeoArrowWithOptions: polygonizeGeoArrowWithOptions,
+  polygonizeReportWithOptions: polygonizeReportWithOptions,
   polygonizeWithOptions: polygonizeWithOptions,
   polygonizeWithOptionsBuffer: polygonizeWithOptionsBuffer,
   polygonize_buffers: polygonize_buffers,
@@ -1189,4 +1248,4 @@ const cfbRobustOptions = {
     input_profile_id: "cfb_robust_v1",
 };
 
-export { PolygonizerWasmError, WasmPolygonResult, cfbRobustOptions, __wbg_init as default, initSync, initThreadPool, polygonize, polygonizeGeoArrowWithOptions, polygonizeWithOptions, polygonizeWithOptionsBuffer, polygonize_buffers, polygonize_geoarrow, wbg_rayon_PoolBuilder, wbg_rayon_start_worker };
+export { PolygonizerWasmError, WasmPolygonResult, cfbRobustOptions, __wbg_init as default, initSync, initThreadPool, polygonize, polygonizeFingerprintWithOptions, polygonizeGeoArrowWithOptions, polygonizeReportWithOptions, polygonizeWithOptions, polygonizeWithOptionsBuffer, polygonize_buffers, polygonize_geoarrow, wbg_rayon_PoolBuilder, wbg_rayon_start_worker };

package/dist/threads/pkg-threads/geo_polygonize.d.ts

@@ -35,6 +35,11 @@ export function initThreadPool(num_threads: number): Promise<any>;
 
 export function polygonize(geojson_str: string, node_input?: boolean | null, snap_grid_size?: number | null, extract_only_polygonal?: boolean | null, report_mode?: boolean | null): string;
 
+/**
+ * Returns the exact retained topology contract for a GeoJSON canonical-options call.
+ */
+export function polygonizeFingerprintWithOptions(geojson_str: string, options_val: Partial<PolygonizerOptions>): string;
+
 /**
  * Polygonizes an Arrow IPC stream containing a GeoArrow LineString array.
  *
@@ -44,12 +49,20 @@ export function polygonize(geojson_str: string, node_input?: boolean | null, sna
  */
 export function polygonizeGeoArrowWithOptions(ipc_bytes: Uint8Array, options_val: Partial<PolygonizerOptions>): Uint8Array;
 
+/**
+ * Returns the complete versioned topology report for a GeoJSON canonical-options call.
+ *
+ * The report is the JSON serialization of `TopologyFingerprintV1`; it is the
+ * stable cross-binding success contract, not a polygon-only GeoJSON projection.
+ */
+export function polygonizeReportWithOptions(geojson_str: string, options_val: Partial<PolygonizerOptions>): string;
+
 /**
  * Polygonizes a GeoJSON FeatureCollection using the canonical `PolygonizerOptions`.
  *
- * This is the primary entry point for JavaScript users. It accepts a JSON string
- * of options and returns a JSON string representing the result, including faces,
- * dangles, cut-lines, and (optionally) provenance/diagnostics.
+ * This compatibility entry point returns polygons only. Use
+ * [`polygonize_report_with_options_js`] when dangles, cut edges, invalid rings,
+ * provenance, diagnostics, and exact coordinate encoding are required.
  */
 export function polygonizeWithOptions(geojson_str: string, options_val: Partial<PolygonizerOptions>): string;
 
@@ -76,7 +89,9 @@ export interface InitOutput {
     readonly __wbg_polygonizerwasmerror_free: (a: number, b: number) => void;
     readonly __wbg_wasmpolygonresult_free: (a: number, b: number) => void;
     readonly polygonize: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+    readonly polygonizeFingerprintWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
     readonly polygonizeGeoArrowWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
+    readonly polygonizeReportWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
     readonly polygonizeWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
     readonly polygonizeWithOptionsBuffer: (a: number, b: number, c: number, d: number, e: number, f: any, g: number, h: number) => [number, number, number];
     readonly polygonize_buffers: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];

package/dist/threads/pkg-threads/geo_polygonize_bg.wasm.d.ts

@@ -3,7 +3,9 @@
 export const __wbg_polygonizerwasmerror_free: (a: number, b: number) => void;
 export const __wbg_wasmpolygonresult_free: (a: number, b: number) => void;
 export const polygonize: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+export const polygonizeFingerprintWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
 export const polygonizeGeoArrowWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
+export const polygonizeReportWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
 export const polygonizeWithOptions: (a: number, b: number, c: any) => [number, number, number, number];
 export const polygonizeWithOptionsBuffer: (a: number, b: number, c: number, d: number, e: number, f: any, g: number, h: number) => [number, number, number];
 export const polygonize_buffers: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-polygonize",
-  "version": "0.53.0",
+  "version": "0.55.0",
   "description": "A native Rust port of the JTS/GEOS polygonization algorithm (Wasm)",
   "type": "module",
   "scripts": {