geo-polygonize 0.65.0 → 0.67.0

package/README.md

@@ -281,6 +281,22 @@ async function run() {
 }
 ```
 
+For cancellable browser work, use the worker-backed asynchronous entry point.
+Aborting terminates its disposable worker; the direct Wasm exports above remain
+synchronous and cannot be interrupted with an `AbortSignal`.
+
+```javascript
+import { polygonizeWithOptionsAsync } from "geo-polygonize";
+
+const controller = new AbortController();
+const result = await polygonizeWithOptionsAsync(
+    JSON.stringify(geojson),
+    cfbRobustOptions,
+    { signal: controller.signal },
+);
+// controller.abort();
+```
+
 **Multithreaded Usage (Experimental):**
 This library provides a multithreaded build powered by `wasm-bindgen-rayon`.
 

package/dist/slim/cjs/index.d.ts

@@ -1,4 +1,5 @@
 import * as exports from "../pkg-scalar/geo_polygonize.js";
+import type { PolygonizerOptions } from "./bindings/PolygonizerOptions";
 export * from "../pkg-scalar/geo_polygonize.js";
 export * from "./bindings/PolygonizerOptions";
 export * from "./bindings/ContainmentOptions";
@@ -18,4 +19,16 @@ export * from "./bindings/ZPolicy";
 export * from "./bindings/TopologyFingerprintV1";
 export * from "./bindings/NormalizedPolygonizeErrorV1";
 export * from "./cfb";
+export type WasmWorkerOptions = {
+    signal?: AbortSignal;
+};
+/**
+ * Polygonizes GeoJSON in an isolated browser worker.
+ *
+ * Aborting terminates that worker; direct Wasm exports remain synchronous and
+ * cannot be interrupted with an `AbortSignal`.
+ */
+export declare function polygonizeWithOptionsAsync(geojson: string, options: Partial<PolygonizerOptions>, workerOptions?: WasmWorkerOptions): Promise<string>;
+/** Returns the canonical topology report in an abortable browser worker. */
+export declare function polygonizeReportWithOptionsAsync(geojson: string, options: Partial<PolygonizerOptions>, workerOptions?: WasmWorkerOptions): Promise<string>;
 export default function init(_input?: any): Promise<typeof exports>;

package/dist/slim/cjs/polygonize_worker.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,4 +1,5 @@
 import * as exports from "../pkg-scalar/geo_polygonize.js";
+import type { PolygonizerOptions } from "./bindings/PolygonizerOptions";
 export * from "../pkg-scalar/geo_polygonize.js";
 export * from "./bindings/PolygonizerOptions";
 export * from "./bindings/ContainmentOptions";
@@ -18,4 +19,16 @@ export * from "./bindings/ZPolicy";
 export * from "./bindings/TopologyFingerprintV1";
 export * from "./bindings/NormalizedPolygonizeErrorV1";
 export * from "./cfb";
+export type WasmWorkerOptions = {
+    signal?: AbortSignal;
+};
+/**
+ * Polygonizes GeoJSON in an isolated browser worker.
+ *
+ * Aborting terminates that worker; direct Wasm exports remain synchronous and
+ * cannot be interrupted with an `AbortSignal`.
+ */
+export declare function polygonizeWithOptionsAsync(geojson: string, options: Partial<PolygonizerOptions>, workerOptions?: WasmWorkerOptions): Promise<string>;
+/** Returns the canonical topology report in an abortable browser worker. */
+export declare function polygonizeReportWithOptionsAsync(geojson: string, options: Partial<PolygonizerOptions>, workerOptions?: WasmWorkerOptions): Promise<string>;
 export default function init(_input?: any): Promise<typeof exports>;

package/dist/slim/es/polygonize_worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/standard/cjs/index.d.ts

@@ -1,4 +1,5 @@
 import * as exports from "../pkg-scalar/geo_polygonize.js";
+import type { PolygonizerOptions } from "./bindings/PolygonizerOptions";
 export * from "../pkg-scalar/geo_polygonize.js";
 export * from "./bindings/PolygonizerOptions";
 export * from "./bindings/ContainmentOptions";
@@ -18,4 +19,16 @@ export * from "./bindings/ZPolicy";
 export * from "./bindings/TopologyFingerprintV1";
 export * from "./bindings/NormalizedPolygonizeErrorV1";
 export * from "./cfb";
+export type WasmWorkerOptions = {
+    signal?: AbortSignal;
+};
+/**
+ * Polygonizes GeoJSON in an isolated browser worker.
+ *
+ * Aborting terminates that worker; direct Wasm exports remain synchronous and
+ * cannot be interrupted with an `AbortSignal`.
+ */
+export declare function polygonizeWithOptionsAsync(geojson: string, options: Partial<PolygonizerOptions>, workerOptions?: WasmWorkerOptions): Promise<string>;
+/** Returns the canonical topology report in an abortable browser worker. */
+export declare function polygonizeReportWithOptionsAsync(geojson: string, options: Partial<PolygonizerOptions>, workerOptions?: WasmWorkerOptions): Promise<string>;
 export default function init(_input?: any): Promise<typeof exports>;