geo-polygonize 0.36.2 → 0.39.2

package/dist/standard/es/index_slim.d.ts

@@ -9,7 +9,6 @@ export * from "./bindings/NodingOptions";
 export * from "./bindings/ProvenanceOptions";
 export * from "./bindings/SnapStrategy";
 export * from "./bindings/TileOwnershipPolicy";
-export * from "./bindings/TilingOptions";
 export * from "./bindings/TouchPolicy";
 export * from "./cfb";
 export declare function initBest(scalarModule: any, simdModule?: any): Promise<typeof scalarExports>;

package/dist/standard/es/index_threads.d.ts

@@ -9,7 +9,6 @@ export * from "./bindings/NodingOptions";
 export * from "./bindings/ProvenanceOptions";
 export * from "./bindings/SnapStrategy";
 export * from "./bindings/TileOwnershipPolicy";
-export * from "./bindings/TilingOptions";
 export * from "./bindings/TouchPolicy";
 export * from "./cfb";
 export default init;

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

@@ -35,7 +35,7 @@ export function polygonize(geojson_str: string, node_input?: boolean | null, sna
 /**
  * Polygonizes an Arrow IPC stream containing a GeoArrow LineString array.
  *
- * This zero-copy path avoids JSON serialization overhead and returns a binary
+ * This binary path avoids JSON serialization overhead and returns an
  * Arrow IPC stream containing a GeoArrow Polygon array. Requires the options
  * to be passed as a parsed JS object.
  */

package/dist/standard/pkg-wrapper/bindings/PolygonizerOptions.d.ts

@@ -49,7 +49,7 @@ export type PolygonizerOptions = {
      */
     extract_only_polygonal: boolean;
     /**
-     * The underlying strategy to apply when snapping coordinate geometries.
+     * Controls robust snap noding and output coordinate handling.
      *
      * See `SnapStrategy` for differences between strict `Grid` snapping and
      * Shapely/GEOS `GeosCompat` strategies.

package/dist/standard/pkg-wrapper/bindings/SnapStrategy.d.ts

@@ -1,25 +1,15 @@
 /**
- * Strategy for snapping coordinates to a grid.
+ * Strategy for robust snap noding and output coordinates.
  *
- * `Grid` applies a standard round-to-nearest integer grid policy `(coord / size).round() * size`.
- * `GeosCompat` attempts to emulate GEOS / Shapely's `set_precision` behavior, which uses
- * C++ std::round (rounding halfway cases away from zero).
+ * `Grid` uses the precision grid for both topology and output coordinates.
+ * `GeosCompat` uses the grid for topology, then restores one deterministic nearest source
+ * coordinate per snapped node. This targets Shapely-style `snap` followed by full-precision
+ * noding and polygonization; it does not emulate `set_precision` output.
  *
  * **Scale Guidance:**
- * Use `Grid` for native Rust applications where absolute topological determinism and
- * intuitive rounding is preferred.
- * Use `GeosCompat` if you are using `geo-polygonize` to replace a Shapely / GEOS pipeline
- * and require exact parity for edge cases at precision boundaries.
- *
- * **Expected Parity:**
- * Rust's native `f64::round()` rounds halfway cases away from zero. This perfectly
- * matches C++ `std::round` behavior, meaning that `Grid` and `GeosCompat` currently
- * map identical values for basic single-coordinate precision points (e.g., `-0.5` => `-1.0`
- * and `0.5` => `1.0`).
- *
- * **Expected Divergence:**
- * The divergence between `Grid` and `GeosCompat` strategies typically arises under complex
- * topological scaling sequences rather than simple single point coordinate rounding, but
- * the option ensures the library remains semantically compatible with Python/C++ GEOS pipelines.
+ * Use `Grid` when an explicit precision model is the desired output contract.
+ * Use `GeosCompat` when the grid is a robustness aid but source-coordinate fidelity matters.
+ * Both strategies are deterministic; exact GEOS/Shapely parity is not guaranteed for
+ * degenerate or many-to-one snaps.
  */
 export type SnapStrategy = "Grid" | "GeosCompat";

package/dist/threads/es/bindings/PolygonizerOptions.d.ts

@@ -49,7 +49,7 @@ export type PolygonizerOptions = {
      */
     extract_only_polygonal: boolean;
     /**
-     * The underlying strategy to apply when snapping coordinate geometries.
+     * Controls robust snap noding and output coordinate handling.
      *
      * See `SnapStrategy` for differences between strict `Grid` snapping and
      * Shapely/GEOS `GeosCompat` strategies.

package/dist/threads/es/bindings/SnapStrategy.d.ts

@@ -1,25 +1,15 @@
 /**
- * Strategy for snapping coordinates to a grid.
+ * Strategy for robust snap noding and output coordinates.
  *
- * `Grid` applies a standard round-to-nearest integer grid policy `(coord / size).round() * size`.
- * `GeosCompat` attempts to emulate GEOS / Shapely's `set_precision` behavior, which uses
- * C++ std::round (rounding halfway cases away from zero).
+ * `Grid` uses the precision grid for both topology and output coordinates.
+ * `GeosCompat` uses the grid for topology, then restores one deterministic nearest source
+ * coordinate per snapped node. This targets Shapely-style `snap` followed by full-precision
+ * noding and polygonization; it does not emulate `set_precision` output.
  *
  * **Scale Guidance:**
- * Use `Grid` for native Rust applications where absolute topological determinism and
- * intuitive rounding is preferred.
- * Use `GeosCompat` if you are using `geo-polygonize` to replace a Shapely / GEOS pipeline
- * and require exact parity for edge cases at precision boundaries.
- *
- * **Expected Parity:**
- * Rust's native `f64::round()` rounds halfway cases away from zero. This perfectly
- * matches C++ `std::round` behavior, meaning that `Grid` and `GeosCompat` currently
- * map identical values for basic single-coordinate precision points (e.g., `-0.5` => `-1.0`
- * and `0.5` => `1.0`).
- *
- * **Expected Divergence:**
- * The divergence between `Grid` and `GeosCompat` strategies typically arises under complex
- * topological scaling sequences rather than simple single point coordinate rounding, but
- * the option ensures the library remains semantically compatible with Python/C++ GEOS pipelines.
+ * Use `Grid` when an explicit precision model is the desired output contract.
+ * Use `GeosCompat` when the grid is a robustness aid but source-coordinate fidelity matters.
+ * Both strategies are deterministic; exact GEOS/Shapely parity is not guaranteed for
+ * degenerate or many-to-one snaps.
  */
 export type SnapStrategy = "Grid" | "GeosCompat";

package/dist/threads/es/index.d.ts

@@ -9,7 +9,6 @@ export * from "./bindings/NodingOptions";
 export * from "./bindings/ProvenanceOptions";
 export * from "./bindings/SnapStrategy";
 export * from "./bindings/TileOwnershipPolicy";
-export * from "./bindings/TilingOptions";
 export * from "./bindings/TouchPolicy";
 export * from "./cfb";
 export default function init(_input?: any): Promise<typeof exports>;

package/dist/threads/es/index.js

@@ -324,7 +324,7 @@ function polygonize(geojson_str, node_input, snap_grid_size, extract_only_polygo
 /**
  * Polygonizes an Arrow IPC stream containing a GeoArrow LineString array.
  *
- * This zero-copy path avoids JSON serialization overhead and returns a binary
+ * This binary path avoids JSON serialization overhead and returns an
  * Arrow IPC stream containing a GeoArrow Polygon array. Requires the options
  * to be passed as a parsed JS object.
  * @param {Uint8Array} ipc_bytes

package/dist/threads/es/index_slim.d.ts

@@ -9,7 +9,6 @@ export * from "./bindings/NodingOptions";
 export * from "./bindings/ProvenanceOptions";
 export * from "./bindings/SnapStrategy";
 export * from "./bindings/TileOwnershipPolicy";
-export * from "./bindings/TilingOptions";
 export * from "./bindings/TouchPolicy";
 export * from "./cfb";
 export declare function initBest(scalarModule: any, simdModule?: any): Promise<typeof scalarExports>;

package/dist/threads/es/index_threads.d.ts

@@ -9,7 +9,6 @@ export * from "./bindings/NodingOptions";
 export * from "./bindings/ProvenanceOptions";
 export * from "./bindings/SnapStrategy";
 export * from "./bindings/TileOwnershipPolicy";
-export * from "./bindings/TilingOptions";
 export * from "./bindings/TouchPolicy";
 export * from "./cfb";
 export default init;

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

@@ -37,7 +37,7 @@ export function polygonize(geojson_str: string, node_input?: boolean | null, sna
 /**
  * Polygonizes an Arrow IPC stream containing a GeoArrow LineString array.
  *
- * This zero-copy path avoids JSON serialization overhead and returns a binary
+ * This binary path avoids JSON serialization overhead and returns an
  * Arrow IPC stream containing a GeoArrow Polygon array. Requires the options
  * to be passed as a parsed JS object.
  */

package/dist/threads/pkg-wrapper/bindings/PolygonizerOptions.d.ts

@@ -49,7 +49,7 @@ export type PolygonizerOptions = {
      */
     extract_only_polygonal: boolean;
     /**
-     * The underlying strategy to apply when snapping coordinate geometries.
+     * Controls robust snap noding and output coordinate handling.
      *
      * See `SnapStrategy` for differences between strict `Grid` snapping and
      * Shapely/GEOS `GeosCompat` strategies.

package/dist/threads/pkg-wrapper/bindings/SnapStrategy.d.ts

@@ -1,25 +1,15 @@
 /**
- * Strategy for snapping coordinates to a grid.
+ * Strategy for robust snap noding and output coordinates.
  *
- * `Grid` applies a standard round-to-nearest integer grid policy `(coord / size).round() * size`.
- * `GeosCompat` attempts to emulate GEOS / Shapely's `set_precision` behavior, which uses
- * C++ std::round (rounding halfway cases away from zero).
+ * `Grid` uses the precision grid for both topology and output coordinates.
+ * `GeosCompat` uses the grid for topology, then restores one deterministic nearest source
+ * coordinate per snapped node. This targets Shapely-style `snap` followed by full-precision
+ * noding and polygonization; it does not emulate `set_precision` output.
  *
  * **Scale Guidance:**
- * Use `Grid` for native Rust applications where absolute topological determinism and
- * intuitive rounding is preferred.
- * Use `GeosCompat` if you are using `geo-polygonize` to replace a Shapely / GEOS pipeline
- * and require exact parity for edge cases at precision boundaries.
- *
- * **Expected Parity:**
- * Rust's native `f64::round()` rounds halfway cases away from zero. This perfectly
- * matches C++ `std::round` behavior, meaning that `Grid` and `GeosCompat` currently
- * map identical values for basic single-coordinate precision points (e.g., `-0.5` => `-1.0`
- * and `0.5` => `1.0`).
- *
- * **Expected Divergence:**
- * The divergence between `Grid` and `GeosCompat` strategies typically arises under complex
- * topological scaling sequences rather than simple single point coordinate rounding, but
- * the option ensures the library remains semantically compatible with Python/C++ GEOS pipelines.
+ * Use `Grid` when an explicit precision model is the desired output contract.
+ * Use `GeosCompat` when the grid is a robustness aid but source-coordinate fidelity matters.
+ * Both strategies are deterministic; exact GEOS/Shapely parity is not guaranteed for
+ * degenerate or many-to-one snaps.
  */
 export type SnapStrategy = "Grid" | "GeosCompat";

package/package.json

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

package/dist/slim/cjs/bindings/TilingOptions.d.ts

@@ -1,6 +0,0 @@
-import type { DedupPolicy } from "./DedupPolicy";
-import type { TileOwnershipPolicy } from "./TileOwnershipPolicy";
-export type TilingOptions = {
-    ownership_policy: TileOwnershipPolicy;
-    dedup_policy: DedupPolicy;
-};

package/dist/slim/es/bindings/TilingOptions.d.ts

@@ -1,6 +0,0 @@
-import type { DedupPolicy } from "./DedupPolicy";
-import type { TileOwnershipPolicy } from "./TileOwnershipPolicy";
-export type TilingOptions = {
-    ownership_policy: TileOwnershipPolicy;
-    dedup_policy: DedupPolicy;
-};

package/dist/slim/pkg-wrapper/bindings/TilingOptions.d.ts

@@ -1,6 +0,0 @@
-import type { DedupPolicy } from "./DedupPolicy";
-import type { TileOwnershipPolicy } from "./TileOwnershipPolicy";
-export type TilingOptions = {
-    ownership_policy: TileOwnershipPolicy;
-    dedup_policy: DedupPolicy;
-};

package/dist/standard/cjs/bindings/TilingOptions.d.ts

@@ -1,6 +0,0 @@
-import type { DedupPolicy } from "./DedupPolicy";
-import type { TileOwnershipPolicy } from "./TileOwnershipPolicy";
-export type TilingOptions = {
-    ownership_policy: TileOwnershipPolicy;
-    dedup_policy: DedupPolicy;
-};

package/dist/standard/es/bindings/TilingOptions.d.ts

@@ -1,6 +0,0 @@
-import type { DedupPolicy } from "./DedupPolicy";
-import type { TileOwnershipPolicy } from "./TileOwnershipPolicy";
-export type TilingOptions = {
-    ownership_policy: TileOwnershipPolicy;
-    dedup_policy: DedupPolicy;
-};

package/dist/standard/pkg-wrapper/bindings/TilingOptions.d.ts

@@ -1,6 +0,0 @@
-import type { DedupPolicy } from "./DedupPolicy";
-import type { TileOwnershipPolicy } from "./TileOwnershipPolicy";
-export type TilingOptions = {
-    ownership_policy: TileOwnershipPolicy;
-    dedup_policy: DedupPolicy;
-};

package/dist/threads/es/bindings/TilingOptions.d.ts

@@ -1,6 +0,0 @@
-import type { DedupPolicy } from "./DedupPolicy";
-import type { TileOwnershipPolicy } from "./TileOwnershipPolicy";
-export type TilingOptions = {
-    ownership_policy: TileOwnershipPolicy;
-    dedup_policy: DedupPolicy;
-};

package/dist/threads/pkg-wrapper/bindings/TilingOptions.d.ts

@@ -1,6 +0,0 @@
-import type { DedupPolicy } from "./DedupPolicy";
-import type { TileOwnershipPolicy } from "./TileOwnershipPolicy";
-export type TilingOptions = {
-    ownership_policy: TileOwnershipPolicy;
-    dedup_policy: DedupPolicy;
-};