@opengeoweb/webmap-react 20.2.0 → 21.0.0-nightly-20261031

package/dist/src/lib/components/LayerInfo/LayerInfoDialog.d.ts

@@ -1,5 +1,6 @@
 import type { Position, Source } from '@opengeoweb/shared';
-import type { LayerProps } from '@opengeoweb/webmap';
+import { LayerType } from '@opengeoweb/webmap';
+import type { LayerFoundation, LayerProps } from '@opengeoweb/webmap';
 export interface LayerInfoDialogProps {
     layer: LayerProps;
     serviceName: string;
@@ -12,6 +13,9 @@ export interface LayerInfoDialogProps {
     dialogHeight?: number;
     startPosition?: Position;
     selectedStyle?: string;
+    layerType?: LayerType;
+    layerOpacity?: number;
+    stacLayer?: Pick<LayerFoundation, 'service' | 'id' | 'style'>;
     showLayerLegend: boolean;
     onToggleLayerLegendVisibility: (showLegend: boolean) => void;
     edrParameterMetadata?: {

package/dist/src/lib/components/LayerInfo/LayerInfoLegend.d.ts

@@ -1,7 +1,12 @@
+import type { LayerFoundation } from '@opengeoweb/webmap';
+import { LayerType } from '@opengeoweb/webmap';
 export interface LayerInfoLegendProps {
     title: string;
     legendURL?: string;
     showLayerLegend: boolean;
     onToggleLayerLegendVisibility: (showLegend: boolean) => void;
+    layerType?: LayerType;
+    stacLayer?: Pick<LayerFoundation, 'service' | 'id' | 'style'>;
+    layerOpacity?: number;
 }
 export declare const LayerInfoLegend: React.FC<LayerInfoLegendProps>;

package/dist/src/lib/components/Legend/StacLegendCanvas.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { LayerFoundation } from '@opengeoweb/webmap';
+interface StacLegendCanvasProps {
+    layer: Pick<LayerFoundation, 'service' | 'id' | 'style'>;
+    height: number;
+    width: number;
+    opacity: number;
+    onHeightChange: (height: number) => void;
+    onWidthChange?: (width: number) => void;
+}
+export declare const StacLegendCanvas: React.FC<StacLegendCanvasProps>;
+export {};

package/dist/src/lib/components/Legend/index.d.ts

@@ -2,3 +2,4 @@ export * from './Legend';
 export * from './LegendLayout';
 export * from './LegendDialog';
 export * from './LegendButton';
+export * from './StacLegendCanvas';

package/dist/src/lib/components/OpenLayers/layers/GeoTIFFLayer.d.ts

@@ -9,5 +9,8 @@ export interface TiledWMSLayerProps {
     shouldRender?: boolean;
     geotiffStyle?: object;
     normalize?: boolean;
+    nodata?: number;
+    min?: number;
+    max?: number;
 }
 export declare const GeoTIFFLayer: React.FC<TiledWMSLayerProps>;

package/dist/src/lib/components/OpenLayers/utils/TimeawareImageSource.d.ts

@@ -69,6 +69,14 @@ export declare class TimeawareImageSource extends ImageSource {
     setImageForTimeValue(timeStampsToPrefetch: string): void;
     setStyle(styleName: string): void;
     setLayerName(layerName: string): void;
+    /**
+     * Sets the layer name, style and dimensions at once, so the source never requests a layer with the style or dimensions of another layer.
+     */
+    setLayerProps({ layerName, styleName, dimProps, }: {
+        layerName: string;
+        styleName: string;
+        dimProps: Record<string, string>;
+    }): void;
     setTimeValuesValuesToPrefetch(timeStampsToPrefetch: string[]): void;
 }
 export {};

package/dist/src/lib/geotiff-layer-api/api.d.ts

@@ -1,10 +1,26 @@
 import type { Geometry } from 'geojson';
 import type { LayerProps } from '@opengeoweb/webmap';
+export interface STACRasterBand {
+    name?: string;
+    unit?: string;
+    scale?: number;
+    offset?: number;
+    nodata?: number | string;
+    data_type?: string;
+    statistics?: {
+        minimum?: number;
+        maximum?: number;
+        mean?: number;
+        stdev?: number;
+        valid_percent?: number;
+    };
+}
 interface Properties extends Record<string, unknown> {
     datetime: string | null;
     'proj:wkt2'?: string;
     'proj:code'?: string;
     'proj:epsg'?: number;
+    'raster:bands'?: STACRasterBand[];
 }
 export interface STACAsset {
     href: string;
@@ -12,6 +28,7 @@ export interface STACAsset {
     created?: string;
     title?: string;
     roles?: string[];
+    'raster:bands'?: STACRasterBand[];
 }
 export type STACItemAssets = Record<string, STACAsset>;
 export type STACItemAssetDefinitions = Record<string, Omit<STACAsset, 'href'> & {
@@ -40,17 +57,49 @@ export interface STACItem {
     links: STACLink[];
     assets?: STACItemAssets;
 }
+/** Prefer asset metadata, with support for legacy item-level raster metadata. */
+export declare const getStacRasterBands: (item: STACItem, assetKey: string) => STACRasterBand[] | undefined;
 export type STACColormapEntry = [number, number, number, number];
+export type STACPaletteColormap = Record<string, STACColormapEntry>;
+export interface STACIntervalColormap {
+    intervals: [[min: number, max: number], STACColormapEntry][];
+}
+export type STACColormap = STACPaletteColormap | STACIntervalColormap;
+export interface STACCubeVariable {
+    dimensions: string[];
+    type: string;
+    unit?: string;
+    description?: string;
+    extent?: [min: number, max: number];
+}
 export interface STACRenderEntry {
     title?: string;
     assets: string[];
     rescale?: number[][];
-    colormap?: Record<string, STACColormapEntry>;
+    colormap?: STACColormap;
+    nodata?: number | string;
+    'geoweb:style'?: {
+        type: 'gradient';
+        entries: {
+            value: number;
+            color: STACColormapEntry;
+            label?: string;
+        }[];
+    } | {
+        type: 'intervals';
+        entries: {
+            min: number;
+            max: number;
+            color: STACColormapEntry;
+            label?: string;
+        }[];
+    };
 }
 export interface STACCollection {
     type: 'Collection';
     stac_version: string;
     id: string;
+    title?: string;
     description: string;
     license: string;
     keywords?: string[];
@@ -60,8 +109,12 @@ export interface STACCollection {
     features: STACItem[];
     numberMatched?: number;
     numberReturned?: number;
+    'cube:variables'?: Record<string, STACCubeVariable>;
     renders?: Record<string, STACRenderEntry>;
     item_assets?: STACItemAssetDefinitions;
+    summaries?: Record<string, unknown> & {
+        'raster:bands'?: STACRasterBand[];
+    };
 }
 export declare const STAC_ITEM_PAGE_LIMIT = 1000;
 export declare const STAC_TEMPORAL_STEP_SAMPLE_LIMIT = 11;
@@ -88,6 +141,7 @@ export interface STACCatalogCollection {
     description?: string;
     extent?: STACExtent;
     keywords?: string[];
+    'cube:variables'?: Record<string, STACCubeVariable>;
     links: STACLink[];
     renders?: Record<string, STACRenderEntry>;
     item_assets?: STACItemAssetDefinitions;

package/dist/src/lib/geotiff-layer-api/index.d.ts

@@ -1,4 +1,6 @@
 export * from './api';
 export * from './hooks';
 export * from './utils/stacColormapToOlStyle';
+export * from './utils/stacLegendUtils';
 export * from './utils/styleSelection';
+export * from './utils/stacLegendMetadata';

package/dist/src/lib/geotiff-layer-api/utils/stacColorUtils.d.ts

@@ -0,0 +1,2 @@
+import type { STACColormapEntry } from '../api';
+export declare const stacColorToRgba: ([red, green, blue, alpha,]: STACColormapEntry) => string;

package/dist/src/lib/geotiff-layer-api/utils/stacColormapToOlStyle.d.ts

@@ -1,5 +1,5 @@
 import type { Style } from '@opengeoweb/webmap';
-import type { STACColormapEntry, STACItemAssetDefinitions, STACRenderEntry } from '../api';
+import type { STACColormap, STACItemAssetDefinitions, STACRenderEntry } from '../api';
 export declare const STAC_ASSET_STYLE_PREFIX = "asset:";
 export declare const getStacAssetKeyFromStyle: (styleName?: string) => string | undefined;
 export declare const isGeoTIFFAsset: (asset: {
@@ -10,13 +10,9 @@ export declare const isBrowserReadableGeoTIFFAsset: (asset: {
     href?: string;
     type?: string;
 }) => boolean;
-/**
- * Converts a STAC render extension colormap to an OpenLayers WebGLTile palette style.
- *
- * The STAC colormap maps pixel values (0–255) to RGBA arrays where each channel is 0–255.
- * The returned object is suitable for use as the `style` option of `ol/layer/WebGLTile`.
- */
-export declare const stacColormapToOlStyle: (colormap: Record<string, STACColormapEntry>) => object;
+export declare const stacColormapToOlStyle: (colormap: STACColormap) => object;
+/** Nodata samples can become zero in band 1; their alpha band is authoritative. */
+export declare const applyStacNodataMask: (style: object, alphaBand: number) => object;
 /**
  * Returns a grayscale WebGLTile style where band-1 value maps from black (0)
  * to white (255). Used as a safe default when no STAC render colormap exists.

package/dist/src/lib/geotiff-layer-api/utils/stacLegendMetadata.d.ts

@@ -0,0 +1,7 @@
+import type { STACRasterBand } from '../api';
+export interface STACLegendMetadata {
+    assetKey?: string;
+    band?: STACRasterBand;
+}
+/** Asset and band of the STAC item currently displayed for the layer, if any. */
+export declare const getStacLegendMetadata: (layerId?: string) => STACLegendMetadata | undefined;

package/dist/src/lib/geotiff-layer-api/utils/stacLegendUtils.d.ts

@@ -0,0 +1,43 @@
+import type { STACCubeVariable, STACRenderEntry, STACRasterBand } from '../api';
+export interface STACLegendInterval {
+    min: number;
+    max: number;
+    color: string;
+    label?: string;
+}
+export interface STACContinuousLegend {
+    type: 'continuous';
+    min: number;
+    max: number;
+    colors: string[];
+    showLabels?: boolean;
+    stops?: {
+        value: number;
+        color: string;
+        label?: string;
+    }[];
+    unit?: string;
+    title?: string;
+}
+export interface STACIntervalLegend {
+    type: 'intervals';
+    entries: STACLegendInterval[];
+    unit?: string;
+    title?: string;
+}
+export type STACLegendModel = STACContinuousLegend | STACIntervalLegend;
+/** Return known normalization bounds, leaving TIFF detection to OpenLayers otherwise. */
+export declare const getStacGrayscaleRange: (renderEntry: STACRenderEntry, band?: STACRasterBand, variable?: STACCubeVariable) => [number, number] | undefined;
+/**
+ * Returns the stored sample range used by GeoTIFF normalization. STAC band
+ * statistics describe physical values when scale/offset are present, while
+ * OpenLayers normalizes the encoded samples before applying the display style.
+ */
+export declare const getStacGrayscaleSampleRange: (renderEntry: STACRenderEntry, band?: STACRasterBand, variable?: STACCubeVariable) => [number, number] | undefined;
+export declare const makeStacLegendModel: (props: {
+    renderEntry: STACRenderEntry;
+    variable?: STACCubeVariable;
+    band?: STACRasterBand;
+}) => STACLegendModel;
+export declare const getStacLegendWidth: (model: STACLegendModel, ctx: CanvasRenderingContext2D) => number;
+export declare const renderStacLegend: (model: STACLegendModel, ctx: CanvasRenderingContext2D, opacity?: number) => number;

package/dist/src/lib/hooks/useHooksGetCapabilities.d.ts

@@ -48,12 +48,15 @@ export declare const useGetWMSLayerStyleList: (serviceUrl: string, name: string)
 /**
  * Returns a WMLayer instance. If the layerType is LayerType.mapLayer or LayerType.wmtsMapLayer, the layer will detect the right type and will contain the parsed dimensions and styles.
  *
+ * When the name changes, the same WMLayer instance is returned, but it is re-parsed asynchronously. Until that is done, it still holds the styles and dimensions of the previous layer name. Use isParsedForName to know when the WMLayer is up to date.
+ *
  * @param layerFoundation
- * @returns object with wmLayer and if set an errorMessage
+ * @returns object with wmLayer, if set an errorMessage, and isParsedForName which is true when wmLayer has been parsed for the requested name
  */
 export declare const useGetWMLayerInstance: (layerFoundation?: LayerFoundation) => {
     wmLayer: WMLayer | null;
     errorMessage: string | null;
+    isParsedForName: boolean;
 };
 /**
  * Used for querying WMTS GetCapabilities documents

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@opengeoweb/webmap-react",
-    "version": "20.2.0",
+    "version": "21.0.0-nightly-20261031",
     "description": "GeoWeb react wrapper for webmap",
     "license": "Apache-2.0",
     "repository": {
@@ -20,9 +20,9 @@
         }
     },
     "dependencies": {
-        "@opengeoweb/webmap": "20.2.0",
-        "@opengeoweb/theme": "20.2.0",
-        "@opengeoweb/shared": "20.2.0",
+        "@opengeoweb/webmap": "21.0.0-nightly-20261031",
+        "@opengeoweb/theme": "21.0.0-nightly-20261031",
+        "@opengeoweb/shared": "21.0.0-nightly-20261031",
         "lodash": "^4.18.1",
         "ol": "^10.4.0",
         "proj4": "^2.9.2",