geo-polygonize 0.54.0 → 0.56.0

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

@@ -47,12 +47,20 @@ export function polygonizeFingerprintWithOptions(geojson_str: string, options_va
  */
 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;
 
@@ -71,6 +79,7 @@ export interface InitOutput {
     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

@@ -6,6 +6,7 @@ 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/standard/pkg-wrapper/bindings/CoordinateFingerprintV1.d.ts

@@ -0,0 +1,8 @@
+/**
+ * An exact finite coordinate. Every component is an IEEE-754 bit pattern.
+ */
+export type CoordinateFingerprintV1 = {
+    x: string;
+    y: string;
+    z: string;
+};

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

@@ -0,0 +1,5 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+export type ErrorWitnessV1 = {
+    ids: Array<string>;
+    coordinate: CoordinateFingerprintV1 | null;
+};

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

@@ -0,0 +1,16 @@
+import type { ErrorWitnessV1 } from "./ErrorWitnessV1";
+/**
+ * A structured, stable error equality contract.
+ */
+export type NormalizedPolygonizeErrorV1 = {
+    schema_version: number;
+    family: string;
+    code: string;
+    stage: string;
+    field: string | null;
+    expected: string | null;
+    actual: string | null;
+    limit: string | null;
+    observed: string | null;
+    witness: ErrorWitnessV1 | null;
+};

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

@@ -0,0 +1,12 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+import type { ProvenanceFingerprintV1 } from "./ProvenanceFingerprintV1";
+import type { RingFingerprintV1 } from "./RingFingerprintV1";
+export type PolygonFingerprintV1 = {
+    exterior: Array<CoordinateFingerprintV1>;
+    interiors: Array<RingFingerprintV1>;
+    /**
+     * Per-edge representative input IDs, encoded as fixed-width hex strings.
+     */
+    exterior_edge_ids: Array<string>;
+    provenance: ProvenanceFingerprintV1 | null;
+};

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

@@ -0,0 +1,7 @@
+export type ProvenanceFingerprintV1 = {
+    /**
+     * Complete source sets, never JSON numbers, so JavaScript cannot lose IDs.
+     */
+    boundary_line_ids: Array<string>;
+    input_profile_id: string | null;
+};

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

@@ -0,0 +1,5 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+export type RingFingerprintV1 = {
+    coordinates: Array<CoordinateFingerprintV1>;
+    edge_ids: Array<string>;
+};

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

@@ -0,0 +1,15 @@
+/**
+ * Only topology-level diagnostics. Timings and work counters are deliberately excluded.
+ */
+export type TopologyDiagnosticsFingerprintV1 = {
+    dangle_count: number;
+    cut_edge_count: number;
+    ring_count: number;
+    shell_count: number;
+    hole_count: number;
+    unassigned_hole_count: number;
+    unassigned_hole_area: string;
+    invalid_ring_count: number;
+    z_conflict_node_count: number;
+    z_conflicting_line_ids: Array<string>;
+};

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

@@ -0,0 +1,18 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+import type { PolygonFingerprintV1 } from "./PolygonFingerprintV1";
+import type { TopologyDiagnosticsFingerprintV1 } from "./TopologyDiagnosticsFingerprintV1";
+/**
+ * A versioned, structured canonical representation of a successful run.
+ */
+export type TopologyFingerprintV1 = {
+    schema_version: number;
+    /**
+     * The serialized canonical options object is part of the semantic contract.
+     */
+    options: unknown;
+    polygons: Array<PolygonFingerprintV1>;
+    dangles: Array<Array<CoordinateFingerprintV1>>;
+    cut_edges: Array<Array<CoordinateFingerprintV1>>;
+    invalid_rings: Array<Array<CoordinateFingerprintV1>>;
+    diagnostics: TopologyDiagnosticsFingerprintV1 | null;
+};

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

@@ -0,0 +1,8 @@
+/**
+ * An exact finite coordinate. Every component is an IEEE-754 bit pattern.
+ */
+export type CoordinateFingerprintV1 = {
+    x: string;
+    y: string;
+    z: string;
+};

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

@@ -0,0 +1,5 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+export type ErrorWitnessV1 = {
+    ids: Array<string>;
+    coordinate: CoordinateFingerprintV1 | null;
+};

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

@@ -0,0 +1,16 @@
+import type { ErrorWitnessV1 } from "./ErrorWitnessV1";
+/**
+ * A structured, stable error equality contract.
+ */
+export type NormalizedPolygonizeErrorV1 = {
+    schema_version: number;
+    family: string;
+    code: string;
+    stage: string;
+    field: string | null;
+    expected: string | null;
+    actual: string | null;
+    limit: string | null;
+    observed: string | null;
+    witness: ErrorWitnessV1 | null;
+};

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

@@ -0,0 +1,12 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+import type { ProvenanceFingerprintV1 } from "./ProvenanceFingerprintV1";
+import type { RingFingerprintV1 } from "./RingFingerprintV1";
+export type PolygonFingerprintV1 = {
+    exterior: Array<CoordinateFingerprintV1>;
+    interiors: Array<RingFingerprintV1>;
+    /**
+     * Per-edge representative input IDs, encoded as fixed-width hex strings.
+     */
+    exterior_edge_ids: Array<string>;
+    provenance: ProvenanceFingerprintV1 | null;
+};

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

@@ -0,0 +1,7 @@
+export type ProvenanceFingerprintV1 = {
+    /**
+     * Complete source sets, never JSON numbers, so JavaScript cannot lose IDs.
+     */
+    boundary_line_ids: Array<string>;
+    input_profile_id: string | null;
+};

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

@@ -0,0 +1,5 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+export type RingFingerprintV1 = {
+    coordinates: Array<CoordinateFingerprintV1>;
+    edge_ids: Array<string>;
+};

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

@@ -0,0 +1,15 @@
+/**
+ * Only topology-level diagnostics. Timings and work counters are deliberately excluded.
+ */
+export type TopologyDiagnosticsFingerprintV1 = {
+    dangle_count: number;
+    cut_edge_count: number;
+    ring_count: number;
+    shell_count: number;
+    hole_count: number;
+    unassigned_hole_count: number;
+    unassigned_hole_area: string;
+    invalid_ring_count: number;
+    z_conflict_node_count: number;
+    z_conflicting_line_ids: Array<string>;
+};

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

@@ -0,0 +1,18 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+import type { PolygonFingerprintV1 } from "./PolygonFingerprintV1";
+import type { TopologyDiagnosticsFingerprintV1 } from "./TopologyDiagnosticsFingerprintV1";
+/**
+ * A versioned, structured canonical representation of a successful run.
+ */
+export type TopologyFingerprintV1 = {
+    schema_version: number;
+    /**
+     * The serialized canonical options object is part of the semantic contract.
+     */
+    options: unknown;
+    polygons: Array<PolygonFingerprintV1>;
+    dangles: Array<Array<CoordinateFingerprintV1>>;
+    cut_edges: Array<Array<CoordinateFingerprintV1>>;
+    invalid_rings: Array<Array<CoordinateFingerprintV1>>;
+    diagnostics: TopologyDiagnosticsFingerprintV1 | null;
+};

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

@@ -15,5 +15,7 @@ export * from "./bindings/TileOwnershipPolicy";
 export * from "./bindings/TouchPolicy";
 export * from "./bindings/ZOptions";
 export * from "./bindings/ZPolicy";
+export * from "./bindings/TopologyFingerprintV1";
+export * from "./bindings/NormalizedPolygonizeErrorV1";
 export * from "./cfb";
 export default function init(_input?: any): Promise<typeof exports>;

package/dist/threads/es/index.js

@@ -377,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}
@@ -1172,6 +1202,7 @@ var geo_polygonize = /*#__PURE__*/Object.freeze({
   polygonize: polygonize,
   polygonizeFingerprintWithOptions: polygonizeFingerprintWithOptions,
   polygonizeGeoArrowWithOptions: polygonizeGeoArrowWithOptions,
+  polygonizeReportWithOptions: polygonizeReportWithOptions,
   polygonizeWithOptions: polygonizeWithOptions,
   polygonizeWithOptionsBuffer: polygonizeWithOptionsBuffer,
   polygonize_buffers: polygonize_buffers,
@@ -1217,4 +1248,4 @@ const cfbRobustOptions = {
     input_profile_id: "cfb_robust_v1",
 };
 
-export { PolygonizerWasmError, WasmPolygonResult, cfbRobustOptions, __wbg_init as default, initSync, initThreadPool, polygonize, polygonizeFingerprintWithOptions, 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

@@ -49,12 +49,20 @@ export function polygonizeFingerprintWithOptions(geojson_str: string, options_va
  */
 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;
 
@@ -83,6 +91,7 @@ export interface InitOutput {
     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

@@ -5,6 +5,7 @@ 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/pkg-wrapper/bindings/CoordinateFingerprintV1.d.ts

@@ -0,0 +1,8 @@
+/**
+ * An exact finite coordinate. Every component is an IEEE-754 bit pattern.
+ */
+export type CoordinateFingerprintV1 = {
+    x: string;
+    y: string;
+    z: string;
+};

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

@@ -0,0 +1,5 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+export type ErrorWitnessV1 = {
+    ids: Array<string>;
+    coordinate: CoordinateFingerprintV1 | null;
+};

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

@@ -0,0 +1,16 @@
+import type { ErrorWitnessV1 } from "./ErrorWitnessV1";
+/**
+ * A structured, stable error equality contract.
+ */
+export type NormalizedPolygonizeErrorV1 = {
+    schema_version: number;
+    family: string;
+    code: string;
+    stage: string;
+    field: string | null;
+    expected: string | null;
+    actual: string | null;
+    limit: string | null;
+    observed: string | null;
+    witness: ErrorWitnessV1 | null;
+};

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

@@ -0,0 +1,12 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+import type { ProvenanceFingerprintV1 } from "./ProvenanceFingerprintV1";
+import type { RingFingerprintV1 } from "./RingFingerprintV1";
+export type PolygonFingerprintV1 = {
+    exterior: Array<CoordinateFingerprintV1>;
+    interiors: Array<RingFingerprintV1>;
+    /**
+     * Per-edge representative input IDs, encoded as fixed-width hex strings.
+     */
+    exterior_edge_ids: Array<string>;
+    provenance: ProvenanceFingerprintV1 | null;
+};

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

@@ -0,0 +1,7 @@
+export type ProvenanceFingerprintV1 = {
+    /**
+     * Complete source sets, never JSON numbers, so JavaScript cannot lose IDs.
+     */
+    boundary_line_ids: Array<string>;
+    input_profile_id: string | null;
+};

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

@@ -0,0 +1,5 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+export type RingFingerprintV1 = {
+    coordinates: Array<CoordinateFingerprintV1>;
+    edge_ids: Array<string>;
+};

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

@@ -0,0 +1,15 @@
+/**
+ * Only topology-level diagnostics. Timings and work counters are deliberately excluded.
+ */
+export type TopologyDiagnosticsFingerprintV1 = {
+    dangle_count: number;
+    cut_edge_count: number;
+    ring_count: number;
+    shell_count: number;
+    hole_count: number;
+    unassigned_hole_count: number;
+    unassigned_hole_area: string;
+    invalid_ring_count: number;
+    z_conflict_node_count: number;
+    z_conflicting_line_ids: Array<string>;
+};

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

@@ -0,0 +1,18 @@
+import type { CoordinateFingerprintV1 } from "./CoordinateFingerprintV1";
+import type { PolygonFingerprintV1 } from "./PolygonFingerprintV1";
+import type { TopologyDiagnosticsFingerprintV1 } from "./TopologyDiagnosticsFingerprintV1";
+/**
+ * A versioned, structured canonical representation of a successful run.
+ */
+export type TopologyFingerprintV1 = {
+    schema_version: number;
+    /**
+     * The serialized canonical options object is part of the semantic contract.
+     */
+    options: unknown;
+    polygons: Array<PolygonFingerprintV1>;
+    dangles: Array<Array<CoordinateFingerprintV1>>;
+    cut_edges: Array<Array<CoordinateFingerprintV1>>;
+    invalid_rings: Array<Array<CoordinateFingerprintV1>>;
+    diagnostics: TopologyDiagnosticsFingerprintV1 | null;
+};

package/package.json

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