@gisatcz/deckgl-geolib 2.6.0-dev.4 → 2.6.0-dev.6

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/core/types.d.ts

@@ -83,6 +83,8 @@ export type GeoImageOptions = {
     disableLighting?: boolean;
     /** When true, fetch and cache all bands for a tile on first access. Enables instant slider animation. */
     cacheAllBands?: boolean;
+    /** When true, bypass the Web Worker pool for terrain tessellation. Set this for smooth animation during rapid band changes (e.g., slider scrubbing). Default: false */
+    disableWorkerPool?: boolean;
 };
 export declare const DefaultGeoImageOptions: GeoImageOptions;
 export type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array;

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/layers/CogTerrainLayer.d.ts

@@ -55,6 +55,17 @@ type _CogTerrainLayerProps = {
     terrainOptions: GeoImageOptions;
     /** Pre-initialized CogTiles object for terrain */
     cogTiles?: CogTiles;
+    /**
+     * Override layer zoom. When set, both minZoom and maxZoom will use this value,
+     * effectively locking the TileLayer to a single zoom level (used for LOD placeholder).
+     */
+    zoomOverride?: number;
+    /**
+     * When true (default), automatically loads low-resolution overview tiles first
+     * before fetching high-resolution detail tiles. Prevents blank-map delays on slow connections.
+     * Set to false to disable automatic LOD gate and request all visible tiles immediately.
+     */
+    enableProgressiveLoading?: boolean;
     /**
      * When true, suppresses any texture generated by the tile (e.g. heatmap/hillshade)
      * and renders the mesh in the plain `color` instead.
@@ -76,6 +87,8 @@ export default class CogTerrainLayer<ExtraPropsT extends object = object> extend
     static defaultProps: DefaultProps<_CogTerrainLayerProps>;
     static layerName: string;
     terrainUrl: string;
+    private zRangeUpdateTimeoutId;
+    private lastZRangeValue;
     state: {
         isTiled?: boolean;
         terrain?: MeshAttributes;
@@ -84,6 +97,7 @@ export default class CogTerrainLayer<ExtraPropsT extends object = object> extend
         maxZoom: number;
         terrainCogTiles: CogTiles;
         initialized: boolean;
+        overviewLoaded: boolean;
     };
     initializeState(context: any): Promise<void>;
     init(): Promise<void>;
@@ -97,5 +111,6 @@ export default class CogTerrainLayer<ExtraPropsT extends object = object> extend
     }): SimpleMeshLayer<any, {}> | null;
     onViewportLoad(tiles?: Tile2DHeader<MeshAndTexture | null>[]): void;
     renderLayers(): Layer | null | LayersList;
+    _finalize(): void;
 }
 export {};

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.4",
+  "version": "2.6.0-dev.6",
   "description": "Deck.gl extension for rendering Cloud-Optimized GeoTIFF (COG) data",
   "keywords": [
     "deck.gl",