@gisatcz/deckgl-geolib 2.6.0-dev.3 → 2.6.0-dev.5

package/dist/esm/types/core/CogTiles.d.ts

@@ -16,6 +16,7 @@ declare class CogTiles {
     options: GeoImageOptions;
     private cache;
     private tileReader?;
+    private workerPool?;
     private initializePromise?;
     private lastInitializedUrl?;
     constructor(options: GeoImageOptions);

package/dist/esm/types/core/GeoImage.d.ts

@@ -10,7 +10,8 @@ export default class GeoImage {
         rasters: any[];
         bounds: Bounds;
         cellSizeMeters?: number;
-    }, options: GeoImageOptions, meshMaxError: number): Promise<TileResult | null>;
+    }, options: GeoImageOptions, meshMaxError: number, workerPool?: any, // TerrainWorkerPool (optional)
+    signal?: AbortSignal): Promise<TileResult | null>;
     /**
      * Resolves the active visualization (coloring) mode after merging user options with defaults.
      *
@@ -38,7 +39,8 @@ export default class GeoImage {
         height: number;
         rasters: any[];
         cellSizeMeters?: number;
-    }, options: GeoImageOptions, meshMaxError: number): Promise<TileResult>;
+    }, options: GeoImageOptions, meshMaxError: number, workerPool?: any, // TerrainWorkerPool (optional)
+    signal?: AbortSignal): Promise<TileResult>;
     getBitmap(input: string | {
         width: number;
         height: number;

package/dist/esm/types/core/lib/TerrainGenerator.d.ts

@@ -6,7 +6,8 @@ export declare class TerrainGenerator {
         rasters: TypedArray[];
         bounds: Bounds;
         cellSizeMeters?: number;
-    }, options: GeoImageOptions, meshMaxError: number): Promise<TileResult>;
+    }, options: GeoImageOptions, meshMaxError: number, workerPool?: any, // TerrainWorkerPool (optional for flexibility)
+    signal?: AbortSignal): Promise<TileResult>;
     private static extractMeshRaster;
     private static hasVisualizationOptions;
     /**

package/dist/esm/types/index.d.ts

@@ -2,5 +2,6 @@ export { CogBitmapLayer, CogTerrainLayer } from './layers/index';
 export { CogTiles, GeoImage } from './core/index';
 export { suppressGlobalAbortErrors } from './utils/suppressAbortErrors';
 export { extractTerrainCoordinate, sampleTerrainTileCoordinates } from './utils/terrainPickingUtils';
+export { terminateGlobalTerrainWorkerPool } from './workers/TerrainWorkerPool';
 export type { GeoImageOptions } from './core/index';
 export type { TerrainCoordinate } from './utils/terrainPickingUtils';

package/dist/esm/types/workers/TerrainWorkerPool.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pool of Web Workers for parallel terrain tessellation.
+ * Distributes work across multiple workers based on CPU core count.
+ *
+ * SINGLETON PATTERN: One global pool is shared across all CogTiles instances
+ * to avoid expensive worker creation/destruction during deck.gl layer recreations.
+ */
+interface MeshResult {
+    vertices: Uint16Array | Float64Array;
+    triangles: Uint32Array;
+    terrain: Float32Array;
+}
+export interface ComputeMeshOptions {
+    terrain: Float32Array;
+    meshMaxError: number;
+    tesselator: 'martini' | 'delatin';
+    width: number;
+    height: number;
+    signal?: AbortSignal;
+}
+/**
+ * Manages a pool of terrain tessellation workers.
+ * Automatically scales to CPU core count (capped at 8 for memory safety).
+ */
+declare class TerrainWorkerPool {
+    private workers;
+    private pendingTasks;
+    private taskCounter;
+    private roundRobinIndex;
+    constructor(poolSize?: number);
+    /**
+     * Compute terrain mesh using the worker pool.
+     * Returns a Promise that resolves with the mesh data.
+     * Supports cancellation via AbortSignal.
+     */
+    computeMesh(options: ComputeMeshOptions): Promise<MeshResult>;
+    private getNextWorker;
+    private handleWorkerMessage;
+    private handleWorkerError;
+    /**
+     * Terminate all workers.
+     * ⚠️ NOTE: Because this is a singleton, terminate() should only be called
+     * on app shutdown, not on individual layer unmount.
+     */
+    terminate(): void;
+}
+/**
+ * Gets the global terrain worker pool, creating it on first use.
+ * All CogTiles instances share this pool to avoid expensive worker churn
+ * during deck.gl layer recreations.
+ */
+export declare function getGlobalTerrainWorkerPool(): TerrainWorkerPool;
+/**
+ * Terminates the global worker pool.
+ * Only call this on app shutdown, not on layer unmount.
+ */
+export declare function terminateGlobalTerrainWorkerPool(): void;
+export {};

package/dist/esm/types/workers/terrain.worker.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Web Worker for terrain mesh tessellation.
+ * Runs Martini/Delatin algorithms on a background thread to avoid blocking the main thread.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gisatcz/deckgl-geolib",
-  "version": "2.6.0-dev.3",
+  "version": "2.6.0-dev.5",
   "description": "Deck.gl extension for rendering Cloud-Optimized GeoTIFF (COG) data",
   "keywords": [
     "deck.gl",