@opengeoweb/webmap-react 19.4.0 → 19.5.0

package/dist/src/lib/components/OpenLayers/component/OpenLayersMapView.d.ts

@@ -9,5 +9,6 @@ export interface OpenLayersMapViewProps {
     passiveMap?: boolean;
     holdShiftToScroll?: boolean;
     mapId?: string;
+    showMapMousePosition?: boolean;
 }
 export declare const OpenLayersMapView: React.FC<OpenLayersMapViewProps>;

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

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { Dimension } from '@opengeoweb/webmap';
+import type { Dimension, STACGeoTIFFLayerOptions } from '@opengeoweb/webmap';
 import type { OpenLayersFeatureLayerProps } from './OpenLayersFeatureLayer';
 import { getStacFrameItemsToRender, getStacItemLookupWindowForTimes } from './TimeAwareGeoTIFFLayerUtils';
 import type { OnInitializeLayerProps } from '../utils/types';
@@ -13,5 +13,9 @@ interface TimeAwareGeoTIFFLayerProps extends OpenLayersFeatureLayerProps {
     onInitializeLayer?: (payload: OnInitializeLayerProps) => void;
     opacity?: number;
     visible?: boolean;
+    assetKey?: string;
+    dataLayout?: STACGeoTIFFLayerOptions['dataLayout'];
+    spatialFilter?: boolean;
+    temporalStep?: string;
 }
 export declare const TimeAwareGeoTIFFLayer: React.FC<TimeAwareGeoTIFFLayerProps>;

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

@@ -3,10 +3,26 @@ import type { STACItem } from '../../../geotiff-layer-api/api';
 export declare const STAC_ITEM_LOOKUP_WINDOW_MS: number;
 export declare const STAC_ITEM_LOOKUP_WINDOW_INTERVAL_MULTIPLIER = 20;
 export declare const STAC_GEOTIFF_FRAME_PRELOAD_RADIUS = 4;
+export declare const STAC_TILED_ITEM_PAGE_LIMIT = 100;
+export declare const STAC_TILED_OVERVIEW_ITEM_PAGE_LIMIT = 1000;
 export interface STACFrameItem {
     item: STACItem;
     isSelected: boolean;
 }
+interface ResolveStacItemQueryStateProps {
+    hasCollectionData: boolean;
+    isTiledCollection: boolean;
+    rasterViewportBbox?: number[];
+    shouldUseSpatialFilter: boolean;
+    viewportBbox?: number[];
+}
+interface StacItemQueryState {
+    isItemQueryEnabled: boolean;
+    isTiledOverview: boolean;
+    itemQueryBbox?: number[];
+}
+export declare const resolveStacItemQueryState: ({ hasCollectionData, isTiledCollection, rasterViewportBbox, shouldUseSpatialFilter, viewportBbox, }: ResolveStacItemQueryStateProps) => StacItemQueryState;
+export declare const getSingleStacRasterItem: (frameItems: STACFrameItem[], selectionBbox?: number[], preferredItemId?: string) => STACFrameItem[];
 export type STACItemLookupWindow = [string | undefined, string | undefined];
 export declare const resolvePreferredStyleName: (styleNames: string[], currentStyle?: string) => string;
 export declare const getTimeIntervalInMilliseconds: (interval?: TimeInterval) => number | undefined;
@@ -17,4 +33,5 @@ export declare const getLookupStepInMilliseconds: (frameStepMs: number | undefin
 export declare const shouldPreloadStacFrames: (frameStepMs: number | undefined, timeIntervalMs: number | undefined) => boolean;
 export declare const getStacFrameTargetTimes: (timeValue: string | undefined, prefetchList: number[], fallbackStepMs: number | undefined, preloadRadius?: number) => number[];
 export declare const getRequiredLookupMarginInMilliseconds: (timeValue: string | undefined, frameTargetTimes: number[], fallbackMarginMs: number) => number;
-export declare const getStacFrameItemsToRender: (items: STACItem[] | undefined, timeValue?: string, frameTargetTimes?: number[]) => STACFrameItem[];
+export declare const getStacFrameItemsToRender: (items: STACItem[] | undefined, timeValue?: string, frameTargetTimes?: number[], selectionBbox?: number[], frameTimeToleranceMs?: number, selectionTimeToleranceMs?: number) => STACFrameItem[];
+export {};

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

@@ -0,0 +1,6 @@
+import type Map from 'ol/Map';
+export declare const STAC_TILED_MINIMUM_ZOOM = 10;
+export declare const getStacViewportBbox: (map: Map) => number[] | undefined;
+export declare const isStacViewportBboxQueryable: (bbox?: number[]) => bbox is number[];
+export declare const getNextStacViewportBbox: (currentBbox: number[] | undefined, viewportBbox: number[], bufferRatio?: number) => number[];
+export declare const useStacViewportBbox: (map: Map | null, enabled: boolean, minimumZoom?: number, bufferRatio?: number) => number[] | undefined;

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

@@ -7,6 +7,7 @@ export interface HoverSelect {
 export interface ClickOnFeature {
     onClick: (f: Feature[], isShiftClick?: boolean) => void;
     hitTolerance?: number;
+    eventType?: 'click' | 'singleclick';
 }
 export interface BoxSelect {
     onBoxSelect: (features: Feature[], addToSelection: boolean) => void;

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

@@ -1,14 +1,22 @@
 import type { Geometry } from 'geojson';
 import type { LayerProps } from '@opengeoweb/webmap';
-interface Properties {
+interface Properties extends Record<string, unknown> {
     datetime: string | null;
     'proj:wkt2'?: string;
+    'proj:code'?: string;
+    'proj:epsg'?: number;
 }
-interface STACAsset {
+export interface STACAsset {
     href: string;
-    type: string;
-    created: string;
+    type?: string;
+    created?: string;
+    title?: string;
+    roles?: string[];
 }
+export type STACItemAssets = Record<string, STACAsset>;
+export type STACItemAssetDefinitions = Record<string, Omit<STACAsset, 'href'> & {
+    href?: string;
+}>;
 export interface STACExtent {
     spatial?: {
         bbox?: number[][];
@@ -20,6 +28,7 @@ export interface STACExtent {
 export interface STACLink {
     href: string;
     rel: string;
+    method?: string;
 }
 export interface STACItem {
     type: 'Feature';
@@ -29,7 +38,7 @@ export interface STACItem {
     bbox: number[];
     properties: Properties;
     links: STACLink[];
-    assets: Record<string, STACAsset>;
+    assets?: STACItemAssets;
 }
 export type STACColormapEntry = [number, number, number, number];
 export interface STACRenderEntry {
@@ -49,11 +58,16 @@ export interface STACCollection {
     extent: STACExtent;
     links: STACLink[];
     features: STACItem[];
+    numberMatched?: number;
+    numberReturned?: number;
     renders?: Record<string, STACRenderEntry>;
+    item_assets?: STACItemAssetDefinitions;
 }
 export declare const STAC_ITEM_PAGE_LIMIT = 1000;
 export declare const STAC_TEMPORAL_STEP_SAMPLE_LIMIT = 11;
-export declare const getStacItemsUrl: (stacBaseUrlWithCollection: string, startDate?: string, endDate?: string) => string;
+export declare const getStacItemsUrl: (stacBaseUrlWithCollection: string, startDate?: string, endDate?: string, bbox?: number[]) => string;
+export declare const STAC_ITEM_SEARCH_FIELDS_CONFORMANCE = "https://api.stacspec.org/v1.0.0/item-search#fields";
+export declare const getStacItemSearchUrl: (searchUrl: string, collectionId: string, startDate?: string, endDate?: string, bbox?: number[]) => string;
 export declare const fetchStacCollection: (stacBaseUrlWithCollection: string) => Promise<STACCollection>;
 export declare const fetchStacItem: (stacItemUrl: string) => Promise<STACItem>;
 export declare const fetchStacItems: (collectionUrl: string) => Promise<STACItem[]>;
@@ -67,7 +81,7 @@ export declare const fetchStacItemsPage: (baseUrl: string, itemLimit?: number, o
  * @param itemLimit - Max items per page (default: 1000)
  * @returns Array of all fetched STAC items
  */
-export declare const fetchStacItemsWithPagination: (baseUrl: string, itemLimit?: number) => Promise<STACItem[]>;
+export declare const fetchStacItemsWithPagination: (baseUrl: string, itemLimit?: number, signal?: AbortSignal, maximumPages?: number) => Promise<STACItem[]>;
 export interface STACCatalogCollection {
     id: string;
     title?: string;
@@ -76,6 +90,7 @@ export interface STACCatalogCollection {
     keywords?: string[];
     links: STACLink[];
     renders?: Record<string, STACRenderEntry>;
+    item_assets?: STACItemAssetDefinitions;
 }
 export interface STACCatalogRoot {
     type?: string;

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

@@ -1,5 +1,7 @@
 import type { UseQueryResult } from '@tanstack/react-query';
-import type { STACCollection, STACItem } from './api';
+import type { STACCatalogRoot, STACCollection, STACItem } from './api';
 export declare const useStacCollection: (stacBaseUrlWithCollection: string, instanceId?: string, enabled?: boolean) => UseQueryResult<STACCollection, Error>;
-export declare const useStacItems: (stacBaseUrlWithCollection: string, startDate?: string, endDate?: string) => UseQueryResult<STACItem[], Error>;
+export declare const useStacCatalogRoot: (stacRootUrl: string, enabled?: boolean) => UseQueryResult<STACCatalogRoot, Error>;
+export declare const useStacItems: (stacBaseUrlWithCollection: string, startDate?: string, endDate?: string, bbox?: number[], enabled?: boolean, itemLimit?: number, maximumPages?: number) => UseQueryResult<STACItem[], Error>;
+export declare const useStacOverviewItems: (searchUrl: string, collectionId: string, startDate?: string, endDate?: string, bbox?: number[], enabled?: boolean, itemLimit?: number) => UseQueryResult<STACItem[], Error>;
 export declare const useStacTemporalStepItems: (stacBaseUrlWithCollection: string, startDate?: string, endDate?: string, enabled?: boolean) => UseQueryResult<STACItem[], Error>;

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

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

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

@@ -1,5 +1,15 @@
 import type { Style } from '@opengeoweb/webmap';
-import type { STACColormapEntry, STACRenderEntry } from '../api';
+import type { STACColormapEntry, 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: {
+    href?: string;
+    type?: string;
+}) => boolean;
+export declare const isBrowserReadableGeoTIFFAsset: (asset: {
+    href?: string;
+    type?: string;
+}) => boolean;
 /**
  * Converts a STAC render extension colormap to an OpenLayers WebGLTile palette style.
  *
@@ -23,3 +33,10 @@ export declare const stacNormalizedGrayscaleOlStyle: () => object;
  * compatible with the Layer Manager style selector.
  */
 export declare const getRendersAsStyles: (renders: Record<string, STACRenderEntry>) => Style[];
+export declare const getStacAssetStyles: (itemAssets?: STACItemAssetDefinitions) => Style[];
+export declare const getStacCollectionStyles: (renders?: Record<string, STACRenderEntry>, itemAssets?: STACItemAssetDefinitions) => Style[];
+export declare const resolveStacAssetKey: (assets: Record<string, {
+    href?: string;
+    type?: string;
+    roles?: string[];
+}>, styleName?: string, renderAssets?: string[], configuredAssetKey?: string) => string | undefined;

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

@@ -1,15 +1,18 @@
+import type { STACGeoTIFFLayerOptions } from '@opengeoweb/webmap';
 import type { STACCollection, STACItem } from '../api';
+export declare const isSpatiallyTiledStacCollection: (dataLayout: STACGeoTIFFLayerOptions["dataLayout"], hasItemAssets: boolean, sampleItems?: STACItem[]) => boolean;
 /**
  * Infers the temporal step (time resolution) from STAC collection metadata and items.
  * Attempts multiple strategies:
  * 1. Look for 'temporal-resolution' in collection properties
- * 2. Calculate from actual item timestamps
- * 3. Fall back to PT1H if unable to determine
+ * 2. Use a daily step for spatially tiled collections
+ * 3. Calculate from actual item timestamps
+ * 4. Fall back to PT1H if unable to determine
  *
  * @param collection - STAC collection with metadata and items
  * @returns ISO 8601 duration string (e.g., 'PT5M', 'PT1H', 'P1D')
  */
-export declare const inferTemporalStep: (collection: STACCollection | undefined, items?: STACItem[]) => string;
+export declare const inferTemporalStep: (collection: STACCollection | undefined, items?: STACItem[], dataLayout?: STACGeoTIFFLayerOptions["dataLayout"]) => string;
 /**
  * Converts milliseconds to ISO 8601 duration string
  * @param ms - Duration in milliseconds

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

@@ -0,0 +1 @@
+export declare const resolvePreferredStyleName: (styleNames: string[], currentStyle?: string) => string;

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

@@ -1,4 +1,5 @@
 import { WMLayer } from '@opengeoweb/webmap';
+import type { STACGeoTIFFLayerOptions } from '@opengeoweb/webmap';
 import type { OnInitializeLayerProps } from '../../components/OpenLayers/utils/types';
 /**
  * Returns WMLayer instance in STAC GeoTIFF mode. The layer will contains parsed dimensions and styles and keeps a state for these properties.
@@ -8,4 +9,4 @@ import type { OnInitializeLayerProps } from '../../components/OpenLayers/utils/t
  * @returns {(WMLayer | null)}
  */
 export declare const useGetStacGeoTIFFWMLayerInstance: (serviceUrl: string, name: string, id?: string, onLayerError?: (layerId: string, message: string) => void) => WMLayer | null;
-export declare const useGetStacGeoTIFFLayerInstance: (stacCollectionURL: string, parameter: string, layerId?: string, onInitializeLayer?: (payload: OnInitializeLayerProps) => void) => WMLayer | null;
+export declare const useGetStacGeoTIFFLayerInstance: (stacCollectionURL: string, parameter: string, layerId?: string, onInitializeLayer?: (payload: OnInitializeLayerProps) => void, configuredTemporalStep?: string, dataLayout?: STACGeoTIFFLayerOptions["dataLayout"]) => WMLayer | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeoweb/webmap-react",
-  "version": "19.4.0",
+  "version": "19.5.0",
   "description": "GeoWeb react wrapper for webmap",
   "license": "Apache-2.0",
   "repository": {