@open-pioneer/map 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,12 +1,32 @@
 # @open-pioneer/map
 
+## 0.2.0
+
+### Minor Changes
+
+- 70349a8: Update to new core packages major versions
+
+### Patch Changes
+
+- Updated dependencies [70349a8]
+  - @open-pioneer/react-utils@0.2.0
+
+## 0.1.1
+
+### Patch Changes
+
+- 08bffbc: MapModel API has got new methods for zooming/highlighting
+- a58546b: Use `HttpService` for default health checks made by the map model.
+- a58546b: Use `HttpService` when loading images in WMSLayer.
+- 0c4ce04: Add OGC API Tiles (vector tiles) support
+
 ## 0.1.0
 
 ### Minor Changes
 
--   bb2f27a: Initial release.
+- bb2f27a: Initial release.
 
 ### Patch Changes
 
--   Updated dependencies [182da1c]
-    -   @open-pioneer/react-utils@0.1.0
+- Updated dependencies [182da1c]
+  - @open-pioneer/react-utils@0.1.0

package/MapRegistryImpl.d.ts

@@ -1,12 +1,14 @@
-import { Service, ServiceOptions, ServiceType } from "@open-pioneer/runtime";
+import { Service, ServiceOptions } from "@open-pioneer/runtime";
 import OlMap from "ol/Map";
-import { MapModel, MapRegistry } from "./api";
+import { MapConfigProvider, MapModel, MapRegistry } from "./api";
+import { HttpService } from "@open-pioneer/http";
 interface References {
-    providers: ServiceType<"map.MapConfigProvider">[];
+    providers: MapConfigProvider[];
+    httpService: HttpService;
 }
 export declare class MapRegistryImpl implements Service, MapRegistry {
     #private;
-    constructor(options: ServiceOptions<References>);
+    constructor({ references }: ServiceOptions<References>);
     destroy(): void;
     getMapModel(mapId: string): Promise<MapModel | undefined>;
     expectMapModel(mapId: string): Promise<MapModel>;

package/MapRegistryImpl.js

@@ -3,13 +3,15 @@ import { createMapModel } from './model/createMapModel.js';
 
 const LOG = createLogger("map:MapRegistry");
 class MapRegistryImpl {
+  #httpService;
   #configProviders = /* @__PURE__ */ new Map();
   #entries = /* @__PURE__ */ new Map();
   #modelCreationJobs = /* @__PURE__ */ new Map();
   #modelsByOlMap = /* @__PURE__ */ new WeakMap();
   #destroyed = false;
-  constructor(options) {
-    const providers = options.references.providers;
+  constructor({ references }) {
+    this.#httpService = references.httpService;
+    const providers = references.providers;
     for (const provider of providers) {
       this.#configProviders.set(provider.mapId, provider);
     }
@@ -66,7 +68,7 @@ class MapRegistryImpl {
   async #createModel(mapId, provider) {
     LOG.info(`Creating map with id '${mapId}'`);
     const mapConfig = await provider.getMapConfig();
-    const mapModel = await createMapModel(mapId, mapConfig);
+    const mapModel = await createMapModel(mapId, mapConfig, this.#httpService);
     if (this.#destroyed) {
       mapModel.destroy();
       throw new Error(`MapRegistry has been destroyed.`);

package/MapRegistryImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapRegistryImpl.js","sources":["MapRegistryImpl.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { createLogger } from \"@open-pioneer/core\";\nimport { Service, ServiceOptions, ServiceType } from \"@open-pioneer/runtime\";\nimport OlMap from \"ol/Map\";\nimport { MapModelImpl } from \"./model/MapModelImpl\";\nimport { MapConfigProvider, MapModel, MapRegistry } from \"./api\";\nimport { createMapModel } from \"./model/createMapModel\";\n\nconst LOG = createLogger(\"map:MapRegistry\");\n\ninterface References {\n    providers: ServiceType<\"map.MapConfigProvider\">[];\n}\n\ntype ModelJobResult = { kind: \"model\"; model: MapModelImpl } | { kind: \"error\"; error: Error };\n\nexport class MapRegistryImpl implements Service, MapRegistry {\n    #configProviders = new Map<string, MapConfigProvider>();\n    #entries = new Map<string, ModelJobResult>();\n    #modelCreationJobs = new Map<string, Promise<ModelJobResult>>();\n    #modelsByOlMap = new WeakMap<OlMap, MapModel>();\n    #destroyed = false;\n\n    constructor(options: ServiceOptions<References>) {\n        const providers = options.references.providers;\n        for (const provider of providers) {\n            this.#configProviders.set(provider.mapId, provider);\n        }\n    }\n\n    destroy(): void {\n        if (this.#destroyed) {\n            return;\n        }\n\n        LOG.info(`Destroy map registry and all maps`);\n        this.#destroyed = true;\n        this.#entries.forEach((model) => {\n            model.kind === \"model\" && model.model.destroy();\n        });\n        this.#entries.clear();\n        this.#modelCreationJobs.clear();\n    }\n\n    async getMapModel(mapId: string): Promise<MapModel | undefined> {\n        if (this.#destroyed) {\n            throw new Error(\"MapRegistry has already been destroyed.\");\n        }\n\n        const creationJob = this.#modelCreationJobs.get(mapId);\n        if (creationJob) {\n            return unbox(await creationJob);\n        }\n\n        const entry = this.#entries.get(mapId);\n        if (entry) {\n            return unbox(entry);\n        }\n\n        const provider = this.#configProviders.get(mapId);\n        if (!provider) {\n            LOG.debug(`Failed to find a config provider for map id '${mapId}'.`);\n            return undefined;\n        }\n\n        const modelPromise = this.#createModel(mapId, provider).catch((cause) => {\n            const error = new Error(`Failed to construct map '${mapId}'`, { cause });\n            const entry: ModelJobResult = { kind: \"error\", error };\n            this.#modelCreationJobs.delete(mapId);\n            this.#entries.set(mapId, entry);\n            return entry;\n        });\n        this.#modelCreationJobs.set(mapId, modelPromise);\n        return unbox(await modelPromise);\n    }\n\n    async expectMapModel(mapId: string): Promise<MapModel> {\n        const model = await this.getMapModel(mapId);\n        if (!model) {\n            throw new Error(`No configuration available for map with id '${mapId}'.`);\n        }\n        return model;\n    }\n\n    getMapModelByRawInstance(olMap: OlMap): MapModel | undefined {\n        return this.#modelsByOlMap.get(olMap);\n    }\n\n    async #createModel(mapId: string, provider: MapConfigProvider): Promise<ModelJobResult> {\n        LOG.info(`Creating map with id '${mapId}'`);\n        const mapConfig = await provider.getMapConfig();\n        const mapModel = await createMapModel(mapId, mapConfig);\n\n        if (this.#destroyed) {\n            mapModel.destroy();\n            throw new Error(`MapRegistry has been destroyed.`);\n        }\n\n        const entry: ModelJobResult = { kind: \"model\", model: mapModel };\n        this.#entries.set(mapId, entry);\n        this.#modelCreationJobs.delete(mapId);\n        this.#modelsByOlMap.set(mapModel.olMap, mapModel);\n        return entry;\n    }\n}\n\nfunction unbox(entry: ModelJobResult): MapModelImpl {\n    if (entry.kind === \"error\") {\n        throw entry.error;\n    }\n    return entry.model;\n}\n"],"names":["entry"],"mappings":"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"}
+{"version":3,"file":"MapRegistryImpl.js","sources":["MapRegistryImpl.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { createLogger } from \"@open-pioneer/core\";\nimport { Service, ServiceOptions } from \"@open-pioneer/runtime\";\nimport OlMap from \"ol/Map\";\nimport { MapModelImpl } from \"./model/MapModelImpl\";\nimport { MapConfigProvider, MapModel, MapRegistry } from \"./api\";\nimport { createMapModel } from \"./model/createMapModel\";\nimport { HttpService } from \"@open-pioneer/http\";\n\nconst LOG = createLogger(\"map:MapRegistry\");\n\ninterface References {\n    providers: MapConfigProvider[];\n    httpService: HttpService;\n}\n\ntype ModelJobResult = { kind: \"model\"; model: MapModelImpl } | { kind: \"error\"; error: Error };\n\nexport class MapRegistryImpl implements Service, MapRegistry {\n    #httpService: HttpService;\n\n    #configProviders = new Map<string, MapConfigProvider>();\n    #entries = new Map<string, ModelJobResult>();\n    #modelCreationJobs = new Map<string, Promise<ModelJobResult>>();\n    #modelsByOlMap = new WeakMap<OlMap, MapModel>();\n    #destroyed = false;\n\n    constructor({ references }: ServiceOptions<References>) {\n        this.#httpService = references.httpService;\n\n        const providers = references.providers;\n        for (const provider of providers) {\n            this.#configProviders.set(provider.mapId, provider);\n        }\n    }\n\n    destroy(): void {\n        if (this.#destroyed) {\n            return;\n        }\n\n        LOG.info(`Destroy map registry and all maps`);\n        this.#destroyed = true;\n        this.#entries.forEach((model) => {\n            model.kind === \"model\" && model.model.destroy();\n        });\n        this.#entries.clear();\n        this.#modelCreationJobs.clear();\n    }\n\n    async getMapModel(mapId: string): Promise<MapModel | undefined> {\n        if (this.#destroyed) {\n            throw new Error(\"MapRegistry has already been destroyed.\");\n        }\n\n        const creationJob = this.#modelCreationJobs.get(mapId);\n        if (creationJob) {\n            return unbox(await creationJob);\n        }\n\n        const entry = this.#entries.get(mapId);\n        if (entry) {\n            return unbox(entry);\n        }\n\n        const provider = this.#configProviders.get(mapId);\n        if (!provider) {\n            LOG.debug(`Failed to find a config provider for map id '${mapId}'.`);\n            return undefined;\n        }\n\n        const modelPromise = this.#createModel(mapId, provider).catch((cause) => {\n            const error = new Error(`Failed to construct map '${mapId}'`, { cause });\n            const entry: ModelJobResult = { kind: \"error\", error };\n            this.#modelCreationJobs.delete(mapId);\n            this.#entries.set(mapId, entry);\n            return entry;\n        });\n        this.#modelCreationJobs.set(mapId, modelPromise);\n        return unbox(await modelPromise);\n    }\n\n    async expectMapModel(mapId: string): Promise<MapModel> {\n        const model = await this.getMapModel(mapId);\n        if (!model) {\n            throw new Error(`No configuration available for map with id '${mapId}'.`);\n        }\n        return model;\n    }\n\n    getMapModelByRawInstance(olMap: OlMap): MapModel | undefined {\n        return this.#modelsByOlMap.get(olMap);\n    }\n\n    async #createModel(mapId: string, provider: MapConfigProvider): Promise<ModelJobResult> {\n        LOG.info(`Creating map with id '${mapId}'`);\n        const mapConfig = await provider.getMapConfig();\n        const mapModel = await createMapModel(mapId, mapConfig, this.#httpService);\n\n        if (this.#destroyed) {\n            mapModel.destroy();\n            throw new Error(`MapRegistry has been destroyed.`);\n        }\n\n        const entry: ModelJobResult = { kind: \"model\", model: mapModel };\n        this.#entries.set(mapId, entry);\n        this.#modelCreationJobs.delete(mapId);\n        this.#modelsByOlMap.set(mapModel.olMap, mapModel);\n        return entry;\n    }\n}\n\nfunction unbox(entry: ModelJobResult): MapModelImpl {\n    if (entry.kind === \"error\") {\n        throw entry.error;\n    }\n    return entry.model;\n}\n"],"names":["entry"],"mappings":"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"}

package/README.md

@@ -258,6 +258,65 @@ layer.updateAttributes({
 layer.deleteAttribute("foo");
 ```
 
+An optional property `healthCheck` allows to determine the availability status of a layer (e.g. map service down). The health check is performed asynchronous.
+
+It is possible to provide
+
+-   either a URL to perform a test request check the returned HTTP status
+-   or a `HealthCheckFunction` performing a custom check and returning the state
+
+**Important**: The availability of a layer is only checked once during initialization to reduce the load on server side. If a service becomes available again later, the application will need to be reloaded in order to update the availability status.
+
+The availability status of a layer can be accessed with the property `loadState`. Its value depends on the result of the health check and the OpenLayers `Source` of the layer. If at least one of both checks returns the state `error`, the `loadState` will be set to `error`.
+
+Example: Check of layer availability ("health check")
+
+```ts
+// YOUR-APP/MapConfigProviderImpl.ts
+import { MapConfig, MapConfigProvider, SimpleLayer } from "@open-pioneer/map";
+import TileLayer from "ol/layer/Tile";
+import OSM from "ol/source/OSM";
+
+export class MapConfigProviderImpl implements MapConfigProvider {
+    async getMapConfig(): Promise<MapConfig> {
+        return {
+            layers: [
+                new SimpleLayer({
+                    id: "1",
+                    title: "Layer 1",
+                    olLayer: new TileLayer({
+                        source: new OSM()
+                    }),
+                    // check layer availability by requesting the provided URL
+                    healthCheck:
+                        "https://sgx.geodatenzentrum.de/wmts_topplus_open/1.0.0/WMTSCapabilities.xml",
+                    isBaseLayer: false,
+                    visible: true
+                }),
+                new SimpleLayer({
+                    id: "2",
+                    title: "Layer 2",
+                    olLayer: new TileLayer({
+                        source: new OSM()
+                    }),
+                    // check layer availability by providing a custom health check function
+                    healthCheck: async () => {
+                        function wait(milliseconds: number): Promise<void> {
+                            return new Promise((resolve) => setTimeout(resolve, milliseconds));
+                        }
+
+                        await wait(3000);
+                        return "error";
+                    },
+                    isBaseLayer: false,
+                    visible: false
+                })
+            ]
+        };
+    }
+}
+```
+
 > NOTE: The visibility of base layers cannot be changed through the method `setVisible`.
 > Call `activateBaseLayer` instead.
 
@@ -266,7 +325,7 @@ layer.deleteAttribute("foo");
 To create an OGC API Features layer, use the `ogc-features` package.
 Details about the necessary steps are described in the package's [README](../ogc-features/README.md) file.
 
-##### Mapbox / MapLibre styles
+###### Mapbox / MapLibre styles
 
 To use layers of a Mapbox / MapLibre style document, use the class `MapboxVectorLayer` from the package `ol-mapbox-style` as in the following sample:
 
@@ -294,8 +353,7 @@ export class MapConfigProviderImpl implements MapConfigProvider {
                 {
                     title: "Abschnitte/Äste mit Unfällen (Mapbox Style)",
                     layer: new MapboxVectorLayer({
-                        styleUrl: "https://demo.ldproxy.net/strassen/styles/default?f=mbs",
-                        accessToken: null
+                        styleUrl: "https://demo.ldproxy.net/strassen/styles/default?f=mbs"
                     })
                 }
             ]
@@ -304,12 +362,56 @@ export class MapConfigProviderImpl implements MapConfigProvider {
 }
 ```
 
-As with the current version 12.0.0 of `ol-mapbox-style`, it is not possible to use the MapboxVectorLayer
-with styleUrls in format `mbs` (parameter `f=mbs`) due to a bug. A patch has been provided for this and is active
-with the current version of the trails base package.
-The patch enables the user to explicitly set the `accessToken` to `null`, if it is not needed/supported.
+Because of the changed license of Mapbox as of version 2.0, we recommend to override the implementation with the code of MapLibre (see the main package.json of this repository for a sample).
+
+##### OGC API Tiles
+
+OpenLayers supports OGC API Tiles (vector tiles) by default (see [OpenLayers API](https://openlayers.org/en/latest/apidoc/module-ol_source_OGCVectorTile-OGCVectorTile.html)).
+
+> IMPORTANT: The configured vector tile layer must have the same projection like the map. Otherwise OGC API Tiles cannot be displayed correctly in a map.
+
+Example: How to configure a vector tile layer:
 
-Because of the changed licence of Mapbox as of version 2.0, we recommend to override the implementation with the code of MapLibre (see the main package.json of this repository for a sample).
+```ts
+// YOUR-APP/MapConfigProviderImpl.ts
+export class MapConfigProviderImpl implements MapConfigProvider {
+    async getMapConfig(): Promise<MapConfig> {
+        return {
+            projection: "EPSG:3857",
+            initialView: {
+                kind: "position",
+                center: {
+                    x: 848890,
+                    y: 6793350
+                },
+                zoom: 13
+            },
+            layers: [
+                new SimpleLayer({
+                    title: "Pendleratlas",
+                    visible: true,
+                    olLayer: new VectorTileLayer({
+                        source: new VectorTileSource({
+                            url: "https://pendleratlas.statistikportal.de/_vector_tiles/2022/vg250/{z}/{x}/{y}.pbf",
+                            format: new MVT(),
+                            projection: "EPSG:3857"
+                        }),
+                        style: new Style({
+                            fill: new Fill({
+                                color: "rgba(173, 209, 158, 0.6)"
+                            }),
+                            stroke: new Stroke({
+                                color: "#2d7d9f",
+                                width: 3
+                            })
+                        })
+                    })
+                })
+            ]
+        };
+    }
+}
+```
 
 ##### OGC Web Map Tile Service (WMTS)
 
@@ -435,7 +537,7 @@ registerProjections({
 const mapModel: MapModel = ... // retrieved via MapRegistry service
 await mapModel.whenDisplayed();
 
-const response = await fetch("https://sgx.geodatenzentrum.de/wmts_topplus_open/1.0.0/WMTSCapabilities.xml");
+const response = await httpService.fetch("https://sgx.geodatenzentrum.de/wmts_topplus_open/1.0.0/WMTSCapabilities.xml");
 const responseText = await response.text();
 
 const wmtsParser = new WMTSCapabilities();

package/api/MapModel.d.ts

@@ -4,6 +4,8 @@ import type OlBaseLayer from "ol/layer/Base";
 import type { ExtentConfig } from "./MapConfig";
 import type { Layer, LayerBase } from "./layers";
 import type { LayerRetrievalOptions } from "./shared";
+import type { Geometry } from "ol/geom";
+import type { StyleLike } from "ol/style/Style";
 /** Events emitted by the {@link MapModel}. */
 export interface MapModelEvents {
     "changed": void;
@@ -11,6 +13,26 @@ export interface MapModelEvents {
     "changed:initialExtent": void;
     "destroy": void;
 }
+/** Options supported by the map model's {@link MapModel.highlightAndZoom | highlightAndZoom} method. */
+export interface HighlightOptions {
+    /**
+     * Optional styles to override the default styles.
+     */
+    highlightStyle?: HighlightStyle;
+    /**
+     * The zoom-level used if there is no valid extend (such as for single points).
+     */
+    pointZoom?: number;
+    /**
+     * The maximum zoom-level for line or polygon results.
+     */
+    maxZoom?: number;
+}
+export interface HighlightStyle {
+    Point?: StyleLike;
+    LineString?: StyleLike;
+    Polygon?: StyleLike;
+}
 /**
  * Represents a map.
  */
@@ -52,6 +74,17 @@ export interface MapModel extends EventSource<MapModelEvents> {
      * Returns a promise that resolves when the map has mounted in the DOM.
      */
     whenDisplayed(): Promise<void>;
+    /**
+     * Highlights the given geometries on the map.
+     * Centers and zooms the view on the geometries.
+     *
+     * Removes any previous highlights.
+     */
+    highlightAndZoom(geometries: Geometry[], options?: HighlightOptions): void;
+    /**
+     * Removes any existing highlights from the map.
+     */
+    removeHighlight(): void;
 }
 /** Events emitted by the {@link LayerCollection}. */
 export interface LayerCollectionEvents {

package/api/MapRegistry.d.ts

@@ -1,6 +1,7 @@
 import type OlMap from "ol/Map";
 import type { MapConfig } from "./MapConfig";
 import type { MapModel } from "./MapModel";
+import type { DeclaredService } from "@open-pioneer/runtime";
 /**
  * Provides access to registered map instances.
  *
@@ -8,7 +9,7 @@ import type { MapModel } from "./MapModel";
  *
  * Inject an instance of this service by referencing the interface name `"map.MapRegistry"`.
  */
-export interface MapRegistry {
+export interface MapRegistry extends DeclaredService<"map.MapRegistry"> {
     /**
      * Returns the map model associated with the given id.
      * Returns undefined if there is no such model.
@@ -45,10 +46,3 @@ export interface MapConfigProvider {
      */
     getMapConfig(): Promise<MapConfig>;
 }
-import "@open-pioneer/runtime";
-declare module "@open-pioneer/runtime" {
-    interface ServiceRegistry {
-        "map.MapRegistry": MapRegistry;
-        "map.MapConfigProvider": MapConfigProvider;
-    }
-}

package/api/index.d.ts

@@ -9,4 +9,5 @@ export { useCenter, useProjection, useResolution, useScale } from "../ui/hooks";
 export { MapAnchor, type MapAnchorProps, type MapAnchorPosition } from "../ui/MapAnchor";
 export { MapContainer, type MapContainerProps, type MapPadding } from "../ui/MapContainer";
 export { useMapModel, type UseMapModelResult, type UseMapModelLoading, type UseMapModelResolved, type UseMapModelRejected } from "../ui/useMapModel";
+export { calculateBufferedExtent } from "../util/geometry-utils";
 export { TOPMOST_LAYER_Z } from "../model/LayerCollectionImpl";

package/api/layers/WMSLayer.d.ts

@@ -1,9 +1,9 @@
 import type { Options as WMSSourceOptions } from "ol/source/ImageWMS";
-import type { LayerBaseConfig, Layer, SublayersCollection } from "./base";
+import type { LayerBaseConfig, Layer, SublayersCollection, LayerConfig } from "./base";
 /**
  * Configuration options to construct a WMS layer.
  */
-export interface WMSLayerConfig extends LayerBaseConfig {
+export interface WMSLayerConfig extends LayerConfig {
     /** URL of the WMS service. */
     url: string;
     /** Configures the layer's sublayers. */
@@ -12,7 +12,7 @@ export interface WMSLayerConfig extends LayerBaseConfig {
      * Additional source options for the layer's WMS source.
      *
      * NOTE: These options are intended for advanced configuration:
-     * the WMS Layer manages some of the open layers source options itself.
+     * the WMS Layer manages some of the OpenLayers source options itself.
      */
     sourceOptions?: Partial<WMSSourceOptions>;
 }

package/api/layers/WMSLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"WMSLayer.js","sources":["WMSLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport type { Options as WMSSourceOptions } from \"ol/source/ImageWMS\";\nimport { WMSLayerImpl } from \"../../model/layers/WMSLayerImpl\";\nimport type { LayerBaseConfig, Layer, SublayersCollection } from \"./base\";\n\n/**\n * Configuration options to construct a WMS layer.\n */\nexport interface WMSLayerConfig extends LayerBaseConfig {\n    /** URL of the WMS service. */\n    url: string;\n\n    /** Configures the layer's sublayers. */\n    sublayers?: WMSSublayerConfig[];\n\n    /**\n     * Additional source options for the layer's WMS source.\n     *\n     * NOTE: These options are intended for advanced configuration:\n     * the WMS Layer manages some of the open layers source options itself.\n     */\n    sourceOptions?: Partial<WMSSourceOptions>;\n}\n\n/**\n * Configuration options to construct the sublayers of a WMS layer.\n */\nexport interface WMSSublayerConfig extends LayerBaseConfig {\n    /** The name of the WMS sublayer in the service's capabilities. */\n    name: string;\n\n    /** Configuration for nested sublayers. */\n    sublayers?: WMSSublayerConfig[];\n}\n\n/** Represents a WMS layer. */\nexport interface WMSLayer extends Layer {\n    readonly sublayers: SublayersCollection;\n\n    /** The URL of the WMS service that was used during layer construction. */\n    readonly url: string;\n}\n\n/**\n * Constructor for {@link WMSLayer}.\n */\nexport interface WMSLayerConstructor {\n    prototype: WMSLayer;\n\n    /** Creates a new {@link WMSLayer}. */\n    new (config: WMSLayerConfig): WMSLayer;\n}\n\nexport const WMSLayer: WMSLayerConstructor = WMSLayerImpl;\n"],"names":[],"mappings":";;AAsDO,MAAM,QAAgC,GAAA;;;;"}
+{"version":3,"file":"WMSLayer.js","sources":["WMSLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport type { Options as WMSSourceOptions } from \"ol/source/ImageWMS\";\nimport { WMSLayerImpl } from \"../../model/layers/WMSLayerImpl\";\nimport type { LayerBaseConfig, Layer, SublayersCollection, LayerConfig } from \"./base\";\n\n/**\n * Configuration options to construct a WMS layer.\n */\nexport interface WMSLayerConfig extends LayerConfig {\n    /** URL of the WMS service. */\n    url: string;\n\n    /** Configures the layer's sublayers. */\n    sublayers?: WMSSublayerConfig[];\n\n    /**\n     * Additional source options for the layer's WMS source.\n     *\n     * NOTE: These options are intended for advanced configuration:\n     * the WMS Layer manages some of the OpenLayers source options itself.\n     */\n    sourceOptions?: Partial<WMSSourceOptions>;\n}\n\n/**\n * Configuration options to construct the sublayers of a WMS layer.\n */\nexport interface WMSSublayerConfig extends LayerBaseConfig {\n    /** The name of the WMS sublayer in the service's capabilities. */\n    name: string;\n\n    /** Configuration for nested sublayers. */\n    sublayers?: WMSSublayerConfig[];\n}\n\n/** Represents a WMS layer. */\nexport interface WMSLayer extends Layer {\n    readonly sublayers: SublayersCollection;\n\n    /** The URL of the WMS service that was used during layer construction. */\n    readonly url: string;\n}\n\n/**\n * Constructor for {@link WMSLayer}.\n */\nexport interface WMSLayerConstructor {\n    prototype: WMSLayer;\n\n    /** Creates a new {@link WMSLayer}. */\n    new (config: WMSLayerConfig): WMSLayer;\n}\n\nexport const WMSLayer: WMSLayerConstructor = WMSLayerImpl;\n"],"names":[],"mappings":";;AAsDO,MAAM,QAAgC,GAAA;;;;"}

package/api/layers/base.d.ts

@@ -14,6 +14,8 @@ export interface LayerBaseEvents {
 }
 /** The load state of a layer. */
 export type LayerLoadState = "not-loaded" | "loading" | "loaded" | "error";
+/** Custom function to check the state of a layer and returning a "loaded" or "error". */
+export type HealthCheckFunction = (layer: LayerBase) => Promise<"loaded" | "error">;
 /**
  * Configuration options supported by all layer types (layers and sublayers).
  */
@@ -116,6 +118,12 @@ export interface LayerConfig extends LayerBaseConfig {
      * Defaults to `false`.
      */
     isBaseLayer?: boolean;
+    /**
+     * Optional property to check the availability of the layer.
+     * It is possible to provide either a URL which indicates the state of the service (2xx response meaning "ok")
+     * or a {@link HealthCheckFunction} performing a custom check and returning the state.
+     */
+    healthCheck?: string | HealthCheckFunction;
 }
 /**
  * Represents an operational layer in the map.

package/index.js

@@ -1,4 +1,3 @@
-import '@open-pioneer/runtime';
 export { SimpleLayer } from './api/layers/SimpleLayer.js';
 export { WMSLayer } from './api/layers/WMSLayer.js';
 export { getProjection, registerProjections } from './projections.js';
@@ -7,5 +6,6 @@ export { useCenter, useProjection, useResolution, useScale } from './ui/hooks.js
 export { MapAnchor } from './ui/MapAnchor.js';
 export { MapContainer } from './ui/MapContainer.js';
 export { useMapModel } from './ui/useMapModel.js';
+export { calculateBufferedExtent } from './util/geometry-utils.js';
 export { TOPMOST_LAYER_Z } from './model/LayerCollectionImpl.js';
 //# sourceMappingURL=index.js.map

package/layers/BkgTopPlusOpen.js

@@ -52,7 +52,7 @@ class BkgTopPlusOpen extends WMTS {
         matrixIds
       }),
       style: "default",
-      attributions: `Kartendarstellung und Pr\xE4sentationsgraphiken: \xA9 Bundesamt f\xFCr Kartographie und Geod\xE4sie ${( new Date()).getFullYear()}, <a href="https://sg.geodatenzentrum.de/web_public/gdz/datenquellen/Datenquellen_TopPlusOpen.html" target="_blank">Datenquellen</a>`
+      attributions: `Kartendarstellung und Pr\xE4sentationsgraphiken: \xA9 Bundesamt f\xFCr Kartographie und Geod\xE4sie ${(/* @__PURE__ */ new Date()).getFullYear()}, <a href="https://sg.geodatenzentrum.de/web_public/gdz/datenquellen/Datenquellen_TopPlusOpen.html" target="_blank">Datenquellen</a>`
     });
   }
 }

package/layers/BkgTopPlusOpen.js.map

@@ -1 +1 @@
-{"version":3,"file":"BkgTopPlusOpen.js","sources":["BkgTopPlusOpen.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport WMTS from \"ol/source/WMTS\";\nimport WMTSTileGrid from \"ol/tilegrid/WMTS\";\n\n/** @internal */\nexport interface BkgTopPlusOpenProps {\n    /**\n     * The name of the requesting layer.\n     * @default \"web\"\n     */\n    layer?: \"web\" | \"web_grau\" | \"web_light\";\n}\n\n/**\n * Layer source for BKG TopPlus Open.\n *\n * Used for @open-pioneer unit tests: not part of the public interface.\n *\n * @see https://gdz.bkg.bund.de/index.php/default/wmts-topplusopen-wmts-topplus-open.html\n *\n * @internal\n */\nexport class BkgTopPlusOpen extends WMTS {\n    constructor(options?: BkgTopPlusOpenProps) {\n        const topLeftCorner = [-3803165.98427299, 8805908.08284866];\n\n        /**\n         * Resolutions taken from AdV WMTS-Profil\n         * @see https://www.adv-online.de/AdV-Produkte/Standards-und-Produktblaetter/AdV-Profile/\n         */\n        const resolutions = [\n            4891.96981025128, // AdV-Level 0  (1:17471320.7508974)\n            2445.98490512564, // AdV-Level 1  (1:8735660.37544872)\n            1222.99245256282, // AdV-Level 2  (1:4367830.18772436)\n            611.49622628141, // AdV-Level 3   (1:2183915.09386218)\n            305.748113140705, // AdV-Level 4  (1:1091957.54693109)\n            152.874056570353, // AdV-Level 5  (1:545978.773465545)\n            76.4370282851763, // AdV-Level 6  (1:272989,386732772)\n            38.2185141425881, // AdV-Level 7  (1:136494,693366386)\n            19.1092570712941, // AdV-Level 8  (1:68247,3466831931)\n            9.55462853564703, // AdV-Level 9  (1:34123,6733415966)\n            4.77731426782352, // AdV-Level 10 (1:17061,8366707983)\n            2.38865713391176, // AdV-Level 11 (1:8530,91833539914)\n            1.19432856695588, // AdV-Level 12 (1:4265,45916769957)\n            0.59716428347794 // AdV-Level 13 (1:2132,72958384978)\n        ];\n\n        /**\n         * The length of matrixIds needs to match the length of the resolutions array\n         * @see https://openlayers.org/en/latest/apidoc/module-ol_tilegrid_WMTS-WMTSTileGrid.html\n         */\n        const matrixIds = new Array(resolutions.length);\n        for (let i = 0; i < resolutions.length; i++) {\n            matrixIds[i] = i;\n        }\n\n        const layer = options?.layer ?? \"web\";\n\n        super({\n            url: `https://sgx.geodatenzentrum.de/wmts_topplus_open/tile/1.0.0/${layer}/{Style}/{TileMatrixSet}/{TileMatrix}/{TileRow}/{TileCol}.png`,\n            layer: layer,\n            matrixSet: \"EU_EPSG_25832_TOPPLUS\",\n            format: \"image/png\",\n            projection: \"EPSG:25832\",\n            requestEncoding: \"REST\",\n            tileGrid: new WMTSTileGrid({\n                origin: topLeftCorner,\n                resolutions: resolutions,\n                matrixIds: matrixIds\n            }),\n            style: \"default\",\n            attributions: `Kartendarstellung und Präsentationsgraphiken: © Bundesamt für Kartographie und Geodäsie ${new Date().getFullYear()}, <a href=\"https://sg.geodatenzentrum.de/web_public/gdz/datenquellen/Datenquellen_TopPlusOpen.html\" target=\"_blank\">Datenquellen</a>`\n        });\n    }\n}\n"],"names":[],"mappings":";;;AAuBO,MAAM,uBAAuB,IAAK,CAAA;AAAA,EACrC,YAAY,OAA+B,EAAA;AACvC,IAAM,MAAA,aAAA,GAAgB,CAAC,CAAA,kBAAA,EAAmB,kBAAgB,CAAA,CAAA;AAM1D,IAAA,MAAM,WAAc,GAAA;AAAA,MAChB,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,eAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,KACJ,CAAA;AAMA,IAAA,MAAM,SAAY,GAAA,IAAI,KAAM,CAAA,WAAA,CAAY,MAAM,CAAA,CAAA;AAC9C,IAAA,KAAA,IAAS,CAAI,GAAA,CAAA,EAAG,CAAI,GAAA,WAAA,CAAY,QAAQ,CAAK,EAAA,EAAA;AACzC,MAAA,SAAA,CAAU,CAAC,CAAI,GAAA,CAAA,CAAA;AAAA,KACnB;AAEA,IAAM,MAAA,KAAA,GAAQ,SAAS,KAAS,IAAA,KAAA,CAAA;AAEhC,IAAM,KAAA,CAAA;AAAA,MACF,GAAA,EAAK,+DAA+D,KAAK,CAAA,6DAAA,CAAA;AAAA,MACzE,KAAA;AAAA,MACA,SAAW,EAAA,uBAAA;AAAA,MACX,MAAQ,EAAA,WAAA;AAAA,MACR,UAAY,EAAA,YAAA;AAAA,MACZ,eAAiB,EAAA,MAAA;AAAA,MACjB,QAAA,EAAU,IAAI,YAAa,CAAA;AAAA,QACvB,MAAQ,EAAA,aAAA;AAAA,QACR,WAAA;AAAA,QACA,SAAA;AAAA,OACH,CAAA;AAAA,MACD,KAAO,EAAA,SAAA;AAAA,MACP,cAAc,CAA2F,oGAAA,EAAA,CAAA,CAAA,IAAI,IAAK,EAAA,EAAE,aAAa,CAAA,oIAAA,CAAA;AAAA,KACpI,CAAA,CAAA;AAAA,GACL;AACJ;;;;"}
+{"version":3,"file":"BkgTopPlusOpen.js","sources":["BkgTopPlusOpen.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport WMTS from \"ol/source/WMTS\";\nimport WMTSTileGrid from \"ol/tilegrid/WMTS\";\n\n/** @internal */\nexport interface BkgTopPlusOpenProps {\n    /**\n     * The name of the requesting layer.\n     * @default \"web\"\n     */\n    layer?: \"web\" | \"web_grau\" | \"web_light\";\n}\n\n/**\n * Layer source for BKG TopPlus Open.\n *\n * Used for @open-pioneer unit tests: not part of the public interface.\n *\n * @see https://gdz.bkg.bund.de/index.php/default/wmts-topplusopen-wmts-topplus-open.html\n *\n * @internal\n */\nexport class BkgTopPlusOpen extends WMTS {\n    constructor(options?: BkgTopPlusOpenProps) {\n        const topLeftCorner = [-3803165.98427299, 8805908.08284866];\n\n        /**\n         * Resolutions taken from AdV WMTS-Profil\n         * @see https://www.adv-online.de/AdV-Produkte/Standards-und-Produktblaetter/AdV-Profile/\n         */\n        const resolutions = [\n            4891.96981025128, // AdV-Level 0  (1:17471320.7508974)\n            2445.98490512564, // AdV-Level 1  (1:8735660.37544872)\n            1222.99245256282, // AdV-Level 2  (1:4367830.18772436)\n            611.49622628141, // AdV-Level 3   (1:2183915.09386218)\n            305.748113140705, // AdV-Level 4  (1:1091957.54693109)\n            152.874056570353, // AdV-Level 5  (1:545978.773465545)\n            76.4370282851763, // AdV-Level 6  (1:272989,386732772)\n            38.2185141425881, // AdV-Level 7  (1:136494,693366386)\n            19.1092570712941, // AdV-Level 8  (1:68247,3466831931)\n            9.55462853564703, // AdV-Level 9  (1:34123,6733415966)\n            4.77731426782352, // AdV-Level 10 (1:17061,8366707983)\n            2.38865713391176, // AdV-Level 11 (1:8530,91833539914)\n            1.19432856695588, // AdV-Level 12 (1:4265,45916769957)\n            0.59716428347794 // AdV-Level 13 (1:2132,72958384978)\n        ];\n\n        /**\n         * The length of matrixIds needs to match the length of the resolutions array\n         * @see https://openlayers.org/en/latest/apidoc/module-ol_tilegrid_WMTS-WMTSTileGrid.html\n         */\n        const matrixIds = new Array(resolutions.length);\n        for (let i = 0; i < resolutions.length; i++) {\n            matrixIds[i] = i;\n        }\n\n        const layer = options?.layer ?? \"web\";\n\n        super({\n            url: `https://sgx.geodatenzentrum.de/wmts_topplus_open/tile/1.0.0/${layer}/{Style}/{TileMatrixSet}/{TileMatrix}/{TileRow}/{TileCol}.png`,\n            layer: layer,\n            matrixSet: \"EU_EPSG_25832_TOPPLUS\",\n            format: \"image/png\",\n            projection: \"EPSG:25832\",\n            requestEncoding: \"REST\",\n            tileGrid: new WMTSTileGrid({\n                origin: topLeftCorner,\n                resolutions: resolutions,\n                matrixIds: matrixIds\n            }),\n            style: \"default\",\n            attributions: `Kartendarstellung und Präsentationsgraphiken: © Bundesamt für Kartographie und Geodäsie ${new Date().getFullYear()}, <a href=\"https://sg.geodatenzentrum.de/web_public/gdz/datenquellen/Datenquellen_TopPlusOpen.html\" target=\"_blank\">Datenquellen</a>`\n        });\n    }\n}\n"],"names":[],"mappings":";;;AAuBO,MAAM,uBAAuB,IAAK,CAAA;AAAA,EACrC,YAAY,OAA+B,EAAA;AACvC,IAAM,MAAA,aAAA,GAAgB,CAAC,CAAA,kBAAA,EAAmB,kBAAgB,CAAA,CAAA;AAM1D,IAAA,MAAM,WAAc,GAAA;AAAA,MAChB,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,eAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MACA,gBAAA;AAAA;AAAA,KACJ,CAAA;AAMA,IAAA,MAAM,SAAY,GAAA,IAAI,KAAM,CAAA,WAAA,CAAY,MAAM,CAAA,CAAA;AAC9C,IAAA,KAAA,IAAS,CAAI,GAAA,CAAA,EAAG,CAAI,GAAA,WAAA,CAAY,QAAQ,CAAK,EAAA,EAAA;AACzC,MAAA,SAAA,CAAU,CAAC,CAAI,GAAA,CAAA,CAAA;AAAA,KACnB;AAEA,IAAM,MAAA,KAAA,GAAQ,SAAS,KAAS,IAAA,KAAA,CAAA;AAEhC,IAAM,KAAA,CAAA;AAAA,MACF,GAAA,EAAK,+DAA+D,KAAK,CAAA,6DAAA,CAAA;AAAA,MACzE,KAAA;AAAA,MACA,SAAW,EAAA,uBAAA;AAAA,MACX,MAAQ,EAAA,WAAA;AAAA,MACR,UAAY,EAAA,YAAA;AAAA,MACZ,eAAiB,EAAA,MAAA;AAAA,MACjB,QAAA,EAAU,IAAI,YAAa,CAAA;AAAA,QACvB,MAAQ,EAAA,aAAA;AAAA,QACR,WAAA;AAAA,QACA,SAAA;AAAA,OACH,CAAA;AAAA,MACD,KAAO,EAAA,SAAA;AAAA,MACP,cAAc,CAA2F,oGAAA,EAAA,iBAAA,IAAI,IAAK,EAAA,EAAE,aAAa,CAAA,oIAAA,CAAA;AAAA,KACpI,CAAA,CAAA;AAAA,GACL;AACJ;;;;"}

package/model/AbstractLayer.js

@@ -7,6 +7,7 @@ const LOG = createLogger("map:AbstractLayer");
 class AbstractLayer extends AbstractLayerBase {
   #olLayer;
   #isBaseLayer;
+  #healthCheck;
   #visible;
   #loadState;
   #stateWatchResource;
@@ -14,16 +15,9 @@ class AbstractLayer extends AbstractLayerBase {
     super(config);
     this.#olLayer = config.olLayer;
     this.#isBaseLayer = config.isBaseLayer ?? false;
+    this.#healthCheck = config.healthCheck;
     this.#visible = config.visible ?? true;
-    const { initial: initialState, resource: stateWatchResource } = watchLoadState(
-      this.#olLayer,
-      (state) => {
-        this.#loadState = state;
-        this.__emitChangeEvent("changed:loadState");
-      }
-    );
-    this.#loadState = initialState;
-    this.#stateWatchResource = stateWatchResource;
+    this.#loadState = getSourceState(getSource(this.#olLayer));
   }
   get visible() {
     return this.#visible;
@@ -50,6 +44,15 @@ class AbstractLayer extends AbstractLayerBase {
    */
   __attach(map) {
     super.__attachToMap(map);
+    const { initial: initialState, resource: stateWatchResource } = watchLoadState(
+      this,
+      this.#healthCheck,
+      (state) => {
+        this.#setLoadState(state);
+      }
+    );
+    this.#stateWatchResource = stateWatchResource;
+    this.#setLoadState(initialState);
   }
   setVisible(newVisibility) {
     if (this.isBaseLayer) {
@@ -71,8 +74,15 @@ class AbstractLayer extends AbstractLayerBase {
     }
     changed && this.__emitChangeEvent("changed:visible");
   }
+  #setLoadState(loadState) {
+    if (loadState !== this.#loadState) {
+      this.#loadState = loadState;
+      this.__emitChangeEvent("changed:loadState");
+    }
+  }
 }
-function watchLoadState(olLayer, onChange) {
+function watchLoadState(layer, healthCheck, onChange) {
+  const olLayer = layer.olLayer;
   if (!(olLayer instanceof OlLayer)) {
     return {
       initial: "loaded",
@@ -82,10 +92,19 @@ function watchLoadState(olLayer, onChange) {
       }
     };
   }
-  let currentSource = olLayer?.getSource();
-  let currentLoadState = mapState(currentSource?.getState());
+  let currentSource = getSource(olLayer);
+  const currentOlLayerState = getSourceState(currentSource);
+  let currentLoadState = currentOlLayerState;
+  let currentHealthState = "loading";
+  if (currentOlLayerState !== "error") {
+    doHealthCheck(layer, healthCheck).then((state) => {
+      currentHealthState = state;
+      updateState();
+    });
+  }
   const updateState = () => {
-    const nextLoadState = mapState(currentSource?.getState());
+    const olLayerState = getSourceState(currentSource);
+    const nextLoadState = currentHealthState === "error" ? "error" : olLayerState;
     if (currentLoadState !== nextLoadState) {
       currentLoadState = nextLoadState;
       onChange(currentLoadState);
@@ -98,7 +117,7 @@ function watchLoadState(olLayer, onChange) {
   const sourceHandle = olLayer.on("change:source", () => {
     stateHandle && unByKey(stateHandle);
     stateHandle = void 0;
-    currentSource = olLayer?.getSource();
+    currentSource = getSource(olLayer);
     stateHandle = currentSource?.on("change", () => {
       updateState();
     });
@@ -114,7 +133,47 @@ function watchLoadState(olLayer, onChange) {
     }
   };
 }
-function mapState(state) {
+async function doHealthCheck(layer, healthCheck) {
+  if (healthCheck == null) {
+    return "loaded";
+  }
+  let healthCheckFn;
+  if (typeof healthCheck === "function") {
+    healthCheckFn = healthCheck;
+  } else if (typeof healthCheck === "string") {
+    healthCheckFn = async () => {
+      const httpService = layer.map.__sharedDependencies.httpService;
+      const response = await httpService.fetch(healthCheck);
+      if (response.ok) {
+        return "loaded";
+      }
+      LOG.warn(
+        `Health check failed for layer '${layer.id}' (http status ${response.status})`
+      );
+      return "error";
+    };
+  } else {
+    LOG.error(
+      `Unexpected object for 'healthCheck' parameter of layer '${layer.id}'`,
+      healthCheck
+    );
+    return "error";
+  }
+  try {
+    return await healthCheckFn(layer);
+  } catch (e) {
+    LOG.warn(`Health check failed for layer '${layer.id}'`, e);
+    return "error";
+  }
+}
+function getSource(olLayer) {
+  if (!(olLayer instanceof OlLayer)) {
+    return void 0;
+  }
+  return olLayer?.getSource() ?? void 0;
+}
+function getSourceState(olSource) {
+  const state = olSource?.getState();
   switch (state) {
     case void 0:
       return "loaded";