@gisatcz/deckgl-geolib 2.5.1-dev.1 → 2.6.0-dev.2

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

@@ -11,6 +11,7 @@ declare class CogTiles {
     zoomRange: number[];
     tileSize: number;
     bounds: [number, number, number, number];
+    bandDescriptions: string[];
     geo: GeoImage;
     options: GeoImageOptions;
     private cache;
@@ -22,9 +23,19 @@ declare class CogTiles {
     getZoomRange(): number[];
     getBoundsAsLatLon(): [number, number, number, number];
     /**
-     * Gets the auto meshMaxError for a given overview index.
-     * Returns undefined if auto lookup has not been computed.
+     * Gets the number of channels/bands in the COG.
+     * Returns the value from COG metadata, or 1 if not initialized.
      */
+    getNumChannels(): number;
+    /**
+     * Returns per-band descriptions loaded from GDAL_METADATA during initialization.
+     * Index is 0-based. Returns an empty string for bands without a description.
+     */
+    getBandDescriptions(): string[];
+    /**
+      * Gets the auto meshMaxError for a given overview index.
+      * Returns undefined if auto lookup has not been computed.
+      */
     getMeshMaxErrorForImageIndex(imageIndex: number): number | undefined;
     /**
      * Computes dynamic meshMaxError values for each overview based on COG resolution and zoom level.
@@ -50,6 +61,7 @@ declare class CogTiles {
     private getTerrainTile;
     private getGlazeTile;
     private getBitmapTile;
+    getTileAllBands(x: number, y: number, z: number, meshMaxError?: number, signal?: AbortSignal, bounds?: Bounds): Promise<TileResult[]>;
     clearTileResultCache(): void;
 }
 export default CogTiles;

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

@@ -81,6 +81,8 @@ export type GeoImageOptions = {
     /** Strategy for detecting all-noData tiles. Options: 'full' | 'border+center' */
     noDataCheck?: 'full' | 'border+center';
     disableLighting?: boolean;
+    /** When true, fetch and cache all bands for a tile on first access. Enables instant slider animation. */
+    cacheAllBands?: 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

@@ -1,4 +1,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 type { GeoImageOptions } from './core/index';
+export type { TerrainCoordinate } from './utils/terrainPickingUtils';

package/dist/esm/types/utils/terrainPickingUtils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Terrain coordinate extraction utility for CogTerrainLayer
+ * Enables precise lat/lon/elevation extraction from 3D terrain picks
+ */
+/**
+ * Represents a geographic coordinate with elevation from terrain picking
+ */
+export interface TerrainCoordinate {
+    /** Longitude in degrees */
+    longitude: number;
+    /** Latitude in degrees */
+    latitude: number;
+    /** Elevation in meters */
+    elevation: number;
+}
+/**
+ * Extracts precise geographic coordinates and elevation from a CogTerrainLayer pick result
+ *
+ * @param pickResult - DeckGL pickObject result from terrain-layer pick
+ * @returns TerrainCoordinate with lon/lat/elevation, or null if extraction fails
+ *
+ * @requires deck.gl >=9.3.0 (for `pickable: '3d'` support)
+ * @note Requires `pickable: '3d'` on CogTerrainLayer. With 3D picking enabled,
+ * deck.gl's terrain layer provides info.coordinate as a 3-element array [lon, lat, elevation]
+ * where elevation is read directly from the terrain mesh at the picked point.
+ * This gives accurate 3D coordinates regardless of camera pitch or bearing.
+ *
+ * @example
+ * ```ts
+ * const cogLayer = new CogTerrainLayer({
+ *   // ...
+ *   pickable: '3d',  // Requires deck.gl >=9.3.0
+ *   onClick: (info) => {
+ *     const coord = extractTerrainCoordinate(info);
+ *     if (coord) {
+ *       console.log(`Clicked at ${coord.latitude}, ${coord.longitude}, elevation: ${coord.elevation}m`);
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare function extractTerrainCoordinate(pickResult: any): TerrainCoordinate | null;
+/**
+ * Samples terrain coordinates in a grid around a pick point for debugging
+ * Useful for understanding terrain data layout and accuracy
+ *
+ * @param pickResult - DeckGL pickObject result from terrain-layer pick
+ * @param gridSize - Odd number for grid dimensions (default: 3 for 3x3 grid).
+ *                   gridSize=3 → 3×3 grid (offset±1), gridSize=5 → 5×5 grid (offset±2).
+ *                   Uses WebMercator projection for accurate latitude mapping.
+ * @returns Array of TerrainCoordinate samples, or empty array if extraction fails
+ *
+ * @example
+ * ```ts
+ * const samples = sampleTerrainTileCoordinates(info, 5); // 5x5 grid around click
+ * samples.forEach(coord => {
+ *   console.log(`Sample: ${coord.latitude}, ${coord.longitude}, elev: ${coord.elevation}m`);
+ * });
+ * ```
+ */
+export declare function sampleTerrainTileCoordinates(pickResult: any, gridSize?: number): TerrainCoordinate[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gisatcz/deckgl-geolib",
-  "version": "2.5.1-dev.1",
+  "version": "2.6.0-dev.2",
   "description": "Deck.gl extension for rendering Cloud-Optimized GeoTIFF (COG) data",
   "keywords": [
     "deck.gl",
@@ -67,17 +67,17 @@
     "@luma.gl/shadertools": ">=9.0.0"
   },
   "devDependencies": {
-    "@deck.gl/core": "^9.2.11",
-    "@deck.gl/extensions": "^9.2.11",
-    "@deck.gl/geo-layers": "^9.2.11",
-    "@deck.gl/layers": "^9.2.11",
-    "@deck.gl/mesh-layers": "^9.2.11",
-    "@loaders.gl/core": "^4.3.4",
-    "@loaders.gl/loader-utils": "^4.3.4",
-    "@loaders.gl/schema": "^4.3.4",
-    "@luma.gl/core": "^9.2.6",
-    "@luma.gl/engine": "^9.2.6",
-    "@luma.gl/shadertools": "^9.2.6",
+    "@deck.gl/core": "^9.3.2",
+    "@deck.gl/extensions": "^9.3.2",
+    "@deck.gl/geo-layers": "^9.3.2",
+    "@deck.gl/layers": "^9.3.2",
+    "@deck.gl/mesh-layers": "^9.3.2",
+    "@loaders.gl/core": "^4.4.1",
+    "@loaders.gl/loader-utils": "^4.4.1",
+    "@loaders.gl/schema": "^4.4.1",
+    "@luma.gl/core": "^9.3.3",
+    "@luma.gl/engine": "^9.3.3",
+    "@luma.gl/shadertools": "^9.3.3",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",