@open-pioneer/map 0.9.0-dev.20250220091855 → 0.9.0-dev.20250224083536

package/CHANGELOG.md

@@ -1,13 +1,14 @@
 # @open-pioneer/map
 
-## 0.9.0-dev.20250220091855
+## 0.9.0-dev.20250224083536
 
 ### Minor Changes
 
--   f327eec: Deprecate `mapModel.layers.getAllLayers()`.
-    Use `mapModel.layers.getLayers()` instead.
-    The name of `getAllLayers()` is misleading because it does not recurse into nested layers.
--   f327eec: Add function `getRecursiveLayers()` to `LayerCollection`, `SublayerCollection` and `GroupLayerCollection` in `@open-pioneer/map`
+- cb94c75: update dependencies
+- f327eec: Deprecate `mapModel.layers.getAllLayers()`.
+  Use `mapModel.layers.getLayers()` instead.
+  The name of `getAllLayers()` is misleading because it does not recurse into nested layers.
+- f327eec: Add function `getRecursiveLayers()` to `LayerCollection`, `SublayerCollection` and `GroupLayerCollection` in `@open-pioneer/map`
 
     Compared to `getLayers` and `getOperationalLayers`, `getRecursiveLayer` returns all (nested) child and sub layers of a collection.
     The property `options.filter` can be used to exclude layers (and their child layers) from the result. For `LayerCollection`, `getRecursiveLayers()` provides the predefined filters `base` and `operational` to return either base layers or operation layers only.
@@ -49,15 +50,39 @@
 
 ### Patch Changes
 
--   209eb8e: Added a configuration option to disable fetching of WMS service capabilities.
+- 37cd707: Add a generic type parameter `PropertiesType` to the `BaseFeature` interface.
+  This allows specifying the type of the `properties` attribute.
+  The default type is `Readonly<Record<string, unknown>>` for backwards compatibility.
+
+    Example:
+
+    ```ts
+    interface MyFeatureProperties {
+        name: string;
+    }
+
+    const feature: BaseFeature<MyFeatureProperties> = {
+        id: 123,
+        properties: {
+            name: "Example Feature"
+        }
+    };
+
+    // string | undefined instead of `unknown`
+    const name = feature.properties?.name;
+    ```
+
+- 32ed2cd: Fix `mapModel.layers.getLayerById()` not being reactive (#400).
+- 209eb8e: Added a configuration option to disable fetching of WMS service capabilities.
+- d72e42c: Removed BKGTopPlusOpen layer source. The BKGTopPlusOpen was an internal layer source only needed for tests. Please use own test sources instead.
 
 ## 0.8.0
 
 ### Minor Changes
 
--   b717121: Update from OL 9 to OL 10.
--   e7978a8: **Breaking:** Remove most events from the map model and the layer interfaces.
-    All events that were merely used to synchronized state (e.g. `changed:title` etc.) have been removed.
+- b717121: Update from OL 9 to OL 10.
+- e7978a8: **Breaking:** Remove most events from the map model and the layer interfaces.
+  All events that were merely used to synchronized state (e.g. `changed:title` etc.) have been removed.
 
     The map model and related objects (layers, layer collections, etc.) are now based on the [Reactivity API](https://github.com/conterra/reactivity/blob/main/packages/reactivity-core/README.md).
     This change greatly simplifies the code that is necessary to access up-to-date values and to react to changes.
@@ -93,18 +118,18 @@
 
     For more details, check the [Reactivity API documentation](https://github.com/conterra/reactivity/blob/main/packages/reactivity-core/README.md).
 
--   7ae9f90: Add new `children` property to all layers.
-    This property makes it possible to handle any layer children in a generic fashion, regardless of the layer's actual type.
+- 7ae9f90: Add new `children` property to all layers.
+  This property makes it possible to handle any layer children in a generic fashion, regardless of the layer's actual type.
 
     `layer.children` is either an alias of `layer.sublayers` (if the layer has sublayers), `layer.layers` (if it's a `GroupLayer`) or undefined, if the layer does not have any children.
 
--   d8337a6: The following hooks are deprecated and will be removed in a future release:
+- d8337a6: The following hooks are deprecated and will be removed in a future release:
 
-    -   `useView`
-    -   `useProjection`
-    -   `useResolution`
-    -   `useCenter`
-    -   `useScale`
+    - `useView`
+    - `useProjection`
+    - `useResolution`
+    - `useCenter`
+    - `useScale`
 
     They can all be replaced by using the new reactive properties on the `MapModel`, for example:
 
@@ -116,13 +141,13 @@
     const center = useReactiveSnapshot(() => mapModel.center, [mapModel]);
     ```
 
--   2fa8020: Update trails core package dependencies.
+- 2fa8020: Update trails core package dependencies.
 
-    -   Also updates Chakra UI to the latest 2.x version and Chakra React Select to version 5.
-    -   Removes any obsolete references to `@chakra-ui/system`.
-        This dependency seems to be no longer required and may lead to duplicate packages in your dependency tree.
+    - Also updates Chakra UI to the latest 2.x version and Chakra React Select to version 5.
+    - Removes any obsolete references to `@chakra-ui/system`.
+      This dependency seems to be no longer required and may lead to duplicate packages in your dependency tree.
 
--   7ae9f90: Add new layer type `GroupLayer` to to the Map API.
+- 7ae9f90: Add new layer type `GroupLayer` to to the Map API.
 
     A `GroupLayer` contains a list of `Layer` (e.g. `SimpleLayer` or `WMSLayer`). Because `GroupLayer` is a `Layer` as well nested groups are supported.
     The child layers of a `GroupLayer` can be accessed with the `layers` property - `layers` is `undefined` if it is not a group.
@@ -166,14 +191,14 @@
     Layers can only be added to a single group or map.
     Sublayers (e.g. `WMSSublayer`) cannot be added to a group directly.
 
--   d8337a6: Provide new reactive properties on the `MapModel` type.
+- d8337a6: Provide new reactive properties on the `MapModel` type.
 
-    -   `olView` (-> `olMap.getView()`)
-    -   `projection` (-> `olMap.getView().getProjection()`)
-    -   `resolution` (-> `olMap.getView().getResolution()`)
-    -   `zoomLevel` (-> `olMap.getView().getZoom()`)
-    -   `center` (-> `olMap.getView().getCenter()`)
-    -   `scale` (derived from center and resolution)
+    - `olView` (-> `olMap.getView()`)
+    - `projection` (-> `olMap.getView().getProjection()`)
+    - `resolution` (-> `olMap.getView().getResolution()`)
+    - `zoomLevel` (-> `olMap.getView().getZoom()`)
+    - `center` (-> `olMap.getView().getCenter()`)
+    - `scale` (derived from center and resolution)
 
     Most of the listed properties are already available on raw OpenLayers objects (see code in parentheses above).
     However, those OpenLayers properties require manual work for synchronization, whereas the new properties are reactive (and can be watched, for example, using `useReactiveSnapshot()`).
@@ -182,15 +207,15 @@
 
 ### Patch Changes
 
--   7a5f1e1: Fix keyboard events from map anchors after update to OpenLayers 10.
--   49f0207: Update trails core packages to version 2.4.0
--   b2127df: Improve documentation of layers in README
+- 7a5f1e1: Fix keyboard events from map anchors after update to OpenLayers 10.
+- 49f0207: Update trails core packages to version 2.4.0
+- b2127df: Improve documentation of layers in README
 
 ## 0.7.0
 
 ### Minor Changes
 
--   2502050: Introduce union types and `type` attributes for layers. This allows TypeScript narrowing for layers and determining a layer's type.
+- 2502050: Introduce union types and `type` attributes for layers. This allows TypeScript narrowing for layers and determining a layer's type.
 
     The `Layer` and `Sublayer` types for layers remain, but are unions of the corresponding concrete layer types now.
     The layer type `LayerBase` has been removed and is replaced by `AnyLayerType`
@@ -200,10 +225,10 @@
 
     The following `type` attribute values have been implemented at the layers:
 
-    -   SimpleLayer: `simple`
-    -   WMSLayer: `wms`
-    -   WMSSubLayer: `wms-sublayer`
-    -   WMTSLayer: `wmts`
+    - SimpleLayer: `simple`
+    - WMSLayer: `wms`
+    - WMSSubLayer: `wms-sublayer`
+    - WMTSLayer: `wmts`
 
     Example of usage:
 
@@ -232,23 +257,23 @@
     }
     ```
 
--   310800c: Switch from `peerDependencies` to normal `dependencies`. Peer dependencies have some usability problems when used at scale.
+- 310800c: Switch from `peerDependencies` to normal `dependencies`. Peer dependencies have some usability problems when used at scale.
 
 ### Patch Changes
 
--   310800c: Update core packages version.
--   583f1d6: The `mapId` or `map` properties are now optional on individual components.
-    You can use the `DefaultMapProvider` to configure an implicit default value.
+- 310800c: Update core packages version.
+- 583f1d6: The `mapId` or `map` properties are now optional on individual components.
+  You can use the `DefaultMapProvider` to configure an implicit default value.
 
     Note that configuring _neither_ a default _nor_ an explicit `map` or `mapId` will trigger a runtime error.
 
--   583f1d6: All UI components in this project now accept the `mapId` (a `string`) _or_ the `map` (a `MapModel`) directly.
--   397d617: Reimplement computation of map anchor positioning using new css props.
--   a8b3449: Switch to a new versioning strategy.
-    From now on, packages released by this repository share a common version number.
--   900eb11: Update dependencies.
--   583f1d6: The new component `DefaultMapProvider` allows you to configure the _default map_ for its children.
-    If `DefaultMapProvider` is used, you can omit the explicit `mapId` (or `map`) property on the individual UI components.
+- 583f1d6: All UI components in this project now accept the `mapId` (a `string`) _or_ the `map` (a `MapModel`) directly.
+- 397d617: Reimplement computation of map anchor positioning using new css props.
+- a8b3449: Switch to a new versioning strategy.
+  From now on, packages released by this repository share a common version number.
+- 900eb11: Update dependencies.
+- 583f1d6: The new component `DefaultMapProvider` allows you to configure the _default map_ for its children.
+  If `DefaultMapProvider` is used, you can omit the explicit `mapId` (or `map`) property on the individual UI components.
 
     For many applications, `DefaultMapProvider` can be used to surround all (or most of) the application's UI.
 
@@ -265,20 +290,20 @@
     </DefaultMapProvider>;
     ```
 
--   397d617: Move attribution of OL map according to the map view's padding.
+- 397d617: Move attribution of OL map according to the map view's padding.
 
 ## 0.6.1
 
 ### Patch Changes
 
--   b152428: Update trails dependencies
--   291ccb6: Apply layer visibility initially to be consistent with the layer configuration.
+- b152428: Update trails dependencies
+- 291ccb6: Apply layer visibility initially to be consistent with the layer configuration.
 
 ## 0.6.0
 
 ### Minor Changes
 
--   0d51d2f: Change how map anchors are positioned in the DOM.
+- 0d51d2f: Change how map anchors are positioned in the DOM.
 
     Previously, map anchor divs were children of the OpenLayers map viewport:
 
@@ -313,95 +338,95 @@
 
 ### Patch Changes
 
--   28e092a: Update dependencies
--   76f8863: Add a new (internal) entry point to support the map-test-utils package.
+- 28e092a: Update dependencies
+- 76f8863: Add a new (internal) entry point to support the map-test-utils package.
 
 ## 0.5.1
 
 ### Patch Changes
 
--   4140646: Update trails dependencies
--   4140646: Update to react 18.3.1
--   b5bb7a1: Adjusted name of Open Pioneer project to Open Pioneer Trails
--   81bc7da: Update trails dependencies
--   2c092dc: Update dependencies
--   Updated dependencies [4140646]
--   Updated dependencies [4140646]
--   Updated dependencies [81bc7da]
--   Updated dependencies [2c092dc]
--   Updated dependencies [4140646]
-    -   @open-pioneer/react-utils@0.2.3
+- 4140646: Update trails dependencies
+- 4140646: Update to react 18.3.1
+- b5bb7a1: Adjusted name of Open Pioneer project to Open Pioneer Trails
+- 81bc7da: Update trails dependencies
+- 2c092dc: Update dependencies
+- Updated dependencies [4140646]
+- Updated dependencies [4140646]
+- Updated dependencies [81bc7da]
+- Updated dependencies [2c092dc]
+- Updated dependencies [4140646]
+    - @open-pioneer/react-utils@0.2.3
 
 ## 0.5.0
 
 ### Minor Changes
 
--   520a97b: Add `ZoomOptions` prop in map package
+- 520a97b: Add `ZoomOptions` prop in map package
 
 ## 0.4.0
 
 ### Minor Changes
 
--   a11bf72: Additional helpers for highlight and zoom
--   9334e81: Update to OpenLayers 9
+- a11bf72: Additional helpers for highlight and zoom
+- 9334e81: Update to OpenLayers 9
 
 ### Patch Changes
 
--   1a8ad89: Update package.json metadata
--   fc6bf82: introduce sourceOptions parameter to WMTS layer
--   a0d8882: hide help texts during map export
--   6162979: Update versions of core packages
--   ac7fdd1: Update documentation
--   13ea342: Remove duplicate viewPadding application.
--   Updated dependencies [1a8ad89]
-    -   @open-pioneer/react-utils@0.2.2
+- 1a8ad89: Update package.json metadata
+- fc6bf82: introduce sourceOptions parameter to WMTS layer
+- a0d8882: hide help texts during map export
+- 6162979: Update versions of core packages
+- ac7fdd1: Update documentation
+- 13ea342: Remove duplicate viewPadding application.
+- Updated dependencies [1a8ad89]
+    - @open-pioneer/react-utils@0.2.2
 
 ## 0.3.1
 
 ### Patch Changes
 
--   611ddb9: Export interface `BaseFeature` from Map API and use it correctly in base packages `selection` and `search`.
+- 611ddb9: Export interface `BaseFeature` from Map API and use it correctly in base packages `selection` and `search`.
 
 ## 0.3.0
 
 ### Minor Changes
 
--   ee7c2d4: Update runtime version.
--   0456500: Add interface `BaseFeature` to Map API.
+- ee7c2d4: Update runtime version.
+- 0456500: Add interface `BaseFeature` to Map API.
 
 ### Patch Changes
 
--   a582e5e: Add property `viewPadding` to `HighlightOptions`.
--   Updated dependencies [762e7b9]
-    -   @open-pioneer/react-utils@0.2.1
+- a582e5e: Add property `viewPadding` to `HighlightOptions`.
+- Updated dependencies [762e7b9]
+    - @open-pioneer/react-utils@0.2.1
 
 ## 0.2.0
 
 ### Minor Changes
 
--   70349a8: Update to new core packages major versions
+- 70349a8: Update to new core packages major versions
 
 ### Patch Changes
 
--   Updated dependencies [70349a8]
-    -   @open-pioneer/react-utils@0.2.0
+- 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
+- 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.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 } 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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"}
+{"version":3,"file":"MapRegistryImpl.js","sources":["MapRegistryImpl.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 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

@@ -7,8 +7,8 @@ APIs provided by this package can be used to configure, embed and access the map
 
 To use the map in your app, follow these two steps:
 
--   Add a `MapContainer` component to your app (see [Map container component](#map-container-component)).
--   Implement a `MapConfigProvider` (see [Map configuration](#map-configuration)).
+- Add a `MapContainer` component to your app (see [Map container component](#map-container-component)).
+- Implement a `MapConfigProvider` (see [Map configuration](#map-configuration)).
 
 To access or manipulate the content of the map programmatically, see [Using the map model](#using-the-map-model).
 
@@ -55,10 +55,10 @@ by animating the view) and `preserve-extent` ´(ensures that the extent remains
 
 To pass custom React components onto the map, the following anchor-points are provided:
 
--   `top-left`
--   `top-right`
--   `bottom-left`
--   `bottom-right`
+- `top-left`
+- `top-right`
+- `bottom-left`
+- `bottom-right`
 
 Example: Integration of a map anchor component into the map container with position `bottom-right` and optional horizontal and vertical gap:
 
@@ -113,10 +113,10 @@ export default defineBuildConfig({
 The service itself needs to implement the `MapConfigProvider` interface.
 The following map options are supported:
 
--   `initialView`,
--   `projection`,
--   `layers` (see [Layer configuration](#layer-configuration)),
--   `advanced`
+- `initialView`,
+- `projection`,
+- `layers` (see [Layer configuration](#layer-configuration)),
+- `advanced`
 
 Always use the provided map model to access the map initially.
 Use `.olMap` only, when the raw instance is required.
@@ -273,8 +273,8 @@ An optional property `healthCheck` allows to determine the availability status o
 
 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
+- 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.
 
@@ -659,8 +659,8 @@ const childLayers = group.layers; // Access child layers
 
 > Limitations:
 >
-> -   Do not add or remove layers directly to or from the underlying OpenLayers layer group (`group.olLayer`)! Changes are not synchronized with the `GroupLayer` instance.
-> -   Currently, it is not possible to manipulate (add or remove) the child layers of a `GroupLayer` during runtime.
+> - Do not add or remove layers directly to or from the underlying OpenLayers layer group (`group.olLayer`)! Changes are not synchronized with the `GroupLayer` instance.
+> - Currently, it is not possible to manipulate (add or remove) the child layers of a `GroupLayer` during runtime.
 
 #### Register additional projections
 
@@ -698,20 +698,20 @@ This package allows interacting with maps and their layers through multiple inte
 
 The most important API items are as follows:
 
--   The `MapRegistry` service (inject via `"map.MapRegistry"`).
-    This service is used to obtain a reference to the `MapModel` via `registry.getMapModel(mapId)`.
+- The `MapRegistry` service (inject via `"map.MapRegistry"`).
+  This service is used to obtain a reference to the `MapModel` via `registry.getMapModel(mapId)`.
 
     > NOTE: From inside a React component you can also use the hook `useMapModel(mapId)`.
 
--   The `MapModel` represents a map in an application.
-    Through the `MapModel` one can obtain the map's base layers, operational layers and so on.
-    The `MapModel` also provides access to the raw OpenLayers `olMap` for advanced use cases.
+- The `MapModel` represents a map in an application.
+  Through the `MapModel` one can obtain the map's base layers, operational layers and so on.
+  The `MapModel` also provides access to the raw OpenLayers `olMap` for advanced use cases.
 
     > NOTE: The `olMap` is manipulated by the `MapModel` to implement its functionality (for example, to add or remove layer instances). When using the `olMap` directly, treat it carefully and as a shared resource.
 
--   The `Layer` interface and its various implementations.
-    This interface is used to make common properties and methods available (such as `.title`, or `.setVisible`).
-    Layers may also have `.sublayers`, which support the same basic properties as other layer types.
+- The `Layer` interface and its various implementations.
+  This interface is used to make common properties and methods available (such as `.title`, or `.setVisible`).
+  Layers may also have `.sublayers`, which support the same basic properties as other layer types.
 
     As is the case in `MapModel`, one can retrieve the raw OpenLayers `olLayer` from a layer instance (the same restrictions apply, see above).
 
@@ -721,16 +721,16 @@ For example, other application components may not react to raw property changes
 
 This point is especially important for the map model's central features:
 
--   Map composition (access and configuration of layers, base layers, removing layers)
--   Layer visibility
--   Custom layer metadata (`attributes`)
+- Map composition (access and configuration of layers, base layers, removing layers)
+- Layer visibility
+- Custom layer metadata (`attributes`)
 
 In those cases, the properties or methods provided by this package should always be used:
 
--   `map.layers.addLayer(layer)` and `map.layers.removeLayerById(layerId)` to add or remove layers
--   `map.layers.getAllLayers()`, `map.layers.getBaseLayers()`, `map.layers.getOperationalLayers()` etc. to access (top-level) layers
--   `layer.setVisible(visible)` and `map.layers.activateBaseLayer(layerId)` to control visibility
--   `layer.updateAttributes()` and `layer.deleteAttributes()` to change a layer's custom attributes
+- `map.layers.addLayer(layer)` and `map.layers.removeLayerById(layerId)` to add or remove layers
+- `map.layers.getLayers()`, `map.layers.getBaseLayers()`, `map.layers.getOperationalLayers()` etc. to access (top-level) layers
+- `layer.setVisible(visible)` and `map.layers.activateBaseLayer(layerId)` to control visibility
+- `layer.updateAttributes()` and `layer.deleteAttributes()` to change a layer's custom attributes
 
 #### Layer classes
 

package/api/BaseFeature.d.ts

@@ -2,8 +2,12 @@ import { Geometry } from "ol/geom";
 import { Style } from "ol/style";
 /**
  * Base interface for all feature objects with geometry and / or attribute information.
+ *
+ * @typeParam PropertiesType The type of the properties of the feature.
+ *            Use this parameter if you know the shape of features ahead of time.
+ *            Note that this parameter should be some kind of object (not an array or primitive type).
  */
-export interface BaseFeature {
+export interface BaseFeature<PropertiesType = Readonly<Record<string, unknown>>> {
     /**
      * Identifier for the feature object. Must be unique within all features of one source/layer.
      *
@@ -23,7 +27,7 @@ export interface BaseFeature {
     /**
      * Properties of the feature.
      */
-    properties?: Readonly<Record<string, unknown>>;
+    properties?: PropertiesType;
     /**
      * Additional style information for displaying the feature on the map.
      */

package/api/index.d.ts

@@ -5,7 +5,6 @@ export * from "./MapRegistry";
 export * from "./layers";
 export * from "./shared";
 export { getProjection, registerProjections, type ProjectionDefinition } from "../projections";
-export { BkgTopPlusOpen, type BkgTopPlusOpenProps } from "../layers/BkgTopPlusOpen";
 export { useView, useProjection, useResolution, useCenter, useScale } from "../ui/hooks";
 export { MapAnchor, type MapAnchorProps, type MapAnchorPosition } from "../ui/MapAnchor";
 export { MapContainer, type MapContainerProps } from "../ui/MapContainer";

package/api/layers/GroupLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"GroupLayer.js","sources":["GroupLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport type { Group } from \"ol/layer\";\nimport { GroupLayerImpl } from \"../../model/layers/GroupLayerImpl\";\nimport type { LayerRetrievalOptions, RecursiveRetrievalOptions } from \"../shared\";\nimport type { AnyLayer, ChildrenCollection, Layer, LayerBaseType, LayerConfig } from \"./base\";\n\n/**\n * Configuration options to construct a {@link GroupLayer}.\n */\nexport interface GroupLayerConfig extends LayerConfig {\n    /**\n     * List of layers that belong to the new group layer.\n     *\n     * The group layer takes ownership of the given layers: they will be destroyed when the parent is destroyed.\n     * A layer must have a unique parent: it can only be added to the map or a single group layer.\n     */\n    layers: Layer[];\n}\n\n/**\n * Represents a group of layers.\n *\n * A group layer contains a collection of {@link Layer} children.\n * Groups can be nested to form a hierarchy.\n */\nexport interface GroupLayer extends LayerBaseType {\n    readonly type: \"group\";\n\n    /**\n     * Layers contained in this group.\n     */\n    readonly layers: GroupLayerCollection;\n\n    /**\n     * Raw OpenLayers group instance.\n     *\n     * **Warning:** Do not manipulate the collection of layers in this group directly, changes are not synchronized!\n     */\n    readonly olLayer: Group;\n\n    readonly sublayers: undefined;\n}\n\n/**\n * Contains {@link Layer} instances that belong to a {@link GroupLayer}\n */\nexport interface GroupLayerCollection extends ChildrenCollection<Layer> {\n    /**\n     * Returns all layers in this collection\n     */\n    getLayers(options?: LayerRetrievalOptions): Layer[];\n\n    /**\n     * Returns a list of all layers in the collection, including all children (recursively).\n     *\n     * > Note: This includes base layers by default (see `options.filter`).\n     * > Use the `\"base\"` or `\"operational\"` short hand values to filter by base layer or operational layers.\n     * >\n     * > If the group contains many, deeply nested sub groups, this function could potentially be expensive.\n     */\n    getRecursiveLayers(options?: RecursiveRetrievalOptions): AnyLayer[];\n}\n\nexport interface GroupLayerConstructor {\n    prototype: GroupLayer;\n\n    /** Creates a new {@link GroupLayer}. */\n    new (config: GroupLayerConfig): GroupLayer;\n}\n\nexport const GroupLayer: GroupLayerConstructor = GroupLayerImpl;\n"],"names":[],"mappings":";;AAuEO,MAAM,UAAoC,GAAA;;;;"}
+{"version":3,"file":"GroupLayer.js","sources":["GroupLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport type { Group } from \"ol/layer\";\nimport { GroupLayerImpl } from \"../../model/layers/GroupLayerImpl\";\nimport type { LayerRetrievalOptions, RecursiveRetrievalOptions } from \"../shared\";\nimport type { AnyLayer, ChildrenCollection, Layer, LayerBaseType, LayerConfig } from \"./base\";\n\n/**\n * Configuration options to construct a {@link GroupLayer}.\n */\nexport interface GroupLayerConfig extends LayerConfig {\n    /**\n     * List of layers that belong to the new group layer.\n     *\n     * The group layer takes ownership of the given layers: they will be destroyed when the parent is destroyed.\n     * A layer must have a unique parent: it can only be added to the map or a single group layer.\n     */\n    layers: Layer[];\n}\n\n/**\n * Represents a group of layers.\n *\n * A group layer contains a collection of {@link Layer} children.\n * Groups can be nested to form a hierarchy.\n */\nexport interface GroupLayer extends LayerBaseType {\n    readonly type: \"group\";\n\n    /**\n     * Layers contained in this group.\n     */\n    readonly layers: GroupLayerCollection;\n\n    /**\n     * Raw OpenLayers group instance.\n     *\n     * **Warning:** Do not manipulate the collection of layers in this group directly, changes are not synchronized!\n     */\n    readonly olLayer: Group;\n\n    readonly sublayers: undefined;\n}\n\n/**\n * Contains {@link Layer} instances that belong to a {@link GroupLayer}\n */\nexport interface GroupLayerCollection extends ChildrenCollection<Layer> {\n    /**\n     * Returns all layers in this collection\n     */\n    getLayers(options?: LayerRetrievalOptions): Layer[];\n\n    /**\n     * Returns a list of all layers in the collection, including all children (recursively).\n     *\n     * > Note: This includes base layers by default (see `options.filter`).\n     * > Use the `\"base\"` or `\"operational\"` short hand values to filter by base layer or operational layers.\n     * >\n     * > If the group contains many, deeply nested sub groups, this function could potentially be expensive.\n     */\n    getRecursiveLayers(options?: RecursiveRetrievalOptions): AnyLayer[];\n}\n\nexport interface GroupLayerConstructor {\n    prototype: GroupLayer;\n\n    /** Creates a new {@link GroupLayer}. */\n    new (config: GroupLayerConfig): GroupLayer;\n}\n\nexport const GroupLayer: GroupLayerConstructor = GroupLayerImpl;\n"],"names":[],"mappings":";;AAuEO,MAAM,UAAoC,GAAA;;;;"}

package/api/layers/SimpleLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleLayer.js","sources":["SimpleLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport type OlBaseLayer from \"ol/layer/Base\";\nimport { LayerConfig, LayerBaseType } from \"./base\";\nimport { SimpleLayerImpl } from \"../../model/layers/SimpleLayerImpl\";\n\n/**\n * Options to construct a simple layer.\n *\n * Simple layers are wrappers around a custom OpenLayers layer.\n */\nexport interface SimpleLayerConfig extends LayerConfig {\n    /**\n     * The raw OpenLayers instance.\n     */\n    olLayer: OlBaseLayer;\n}\n\n/** Constructor for {@link SimpleLayer}. */\nexport interface SimpleLayerConstructor {\n    prototype: SimpleLayer;\n\n    /** Creates a new {@link SimpleLayer}. */\n    new (config: SimpleLayerConfig): SimpleLayer;\n}\n\n/**\n * A simple layer type wrapping an OpenLayers layer.\n */\nexport interface SimpleLayer extends LayerBaseType {\n    readonly type: \"simple\";\n\n    readonly layers: undefined;\n}\n\nexport const SimpleLayer: SimpleLayerConstructor = SimpleLayerImpl;\n"],"names":[],"mappings":";;AAmCO,MAAM,WAAsC,GAAA;;;;"}
+{"version":3,"file":"SimpleLayer.js","sources":["SimpleLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport type OlBaseLayer from \"ol/layer/Base\";\nimport { LayerConfig, LayerBaseType } from \"./base\";\nimport { SimpleLayerImpl } from \"../../model/layers/SimpleLayerImpl\";\n\n/**\n * Options to construct a simple layer.\n *\n * Simple layers are wrappers around a custom OpenLayers layer.\n */\nexport interface SimpleLayerConfig extends LayerConfig {\n    /**\n     * The raw OpenLayers instance.\n     */\n    olLayer: OlBaseLayer;\n}\n\n/** Constructor for {@link SimpleLayer}. */\nexport interface SimpleLayerConstructor {\n    prototype: SimpleLayer;\n\n    /** Creates a new {@link SimpleLayer}. */\n    new (config: SimpleLayerConfig): SimpleLayer;\n}\n\n/**\n * A simple layer type wrapping an OpenLayers layer.\n */\nexport interface SimpleLayer extends LayerBaseType {\n    readonly type: \"simple\";\n\n    readonly layers: undefined;\n}\n\nexport const SimpleLayer: SimpleLayerConstructor = SimpleLayerImpl;\n"],"names":[],"mappings":";;AAmCO,MAAM,WAAsC,GAAA;;;;"}

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 {\n    LayerBaseConfig,\n    SublayersCollection,\n    LayerConfig,\n    LayerBaseType,\n    SublayerBaseType\n} 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     * Whether to automatically fetch capabilities from the service when needed (default: `true`).\n     *\n     * Setting this to `false` can be useful as a performance optimization when capabilities are not really required by the application.\n     * Note that this will disable some features of the WMS layer: for example, the legend URL will not be available.\n     */\n    fetchCapabilities?: boolean;\n}\n\n/**\n * Configuration options to construct the sublayers of a WMS layer.\n */\nexport interface WMSSublayerConfig extends LayerBaseConfig {\n    /**\n     * The name of the WMS sublayer in the service's capabilities.\n     * Not mandatory, e.g. for WMS group layer. See [WMS spec](https://www.ogc.org/standard/wms/).\n     */\n    name?: string;\n\n    /** Configuration for nested sublayers. */\n    sublayers?: WMSSublayerConfig[];\n}\n\n/** Represents a WMS layer. */\nexport interface WMSLayer extends LayerBaseType {\n    readonly type: \"wms\";\n\n    readonly sublayers: SublayersCollection<WMSSublayer>;\n    readonly layers: undefined;\n\n    /** The URL of the WMS service that was used during layer construction. */\n    readonly url: string;\n}\n\n/** Represents a WMS sublayer */\nexport interface WMSSublayer extends SublayerBaseType {\n    readonly type: \"wms-sublayer\";\n    /**\n     * The name of the WMS sublayer in the service's capabilities.\n     *\n     * Is optional as a WMS group layer in a WMS service does not need to have a name.\n     */\n    readonly name: string | undefined;\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":";;AAqFO,MAAM,QAAgC,GAAA;;;;"}
+{"version":3,"file":"WMSLayer.js","sources":["WMSLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 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 {\n    LayerBaseConfig,\n    SublayersCollection,\n    LayerConfig,\n    LayerBaseType,\n    SublayerBaseType\n} 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     * Whether to automatically fetch capabilities from the service when needed (default: `true`).\n     *\n     * Setting this to `false` can be useful as a performance optimization when capabilities are not really required by the application.\n     * Note that this will disable some features of the WMS layer: for example, the legend URL will not be available.\n     */\n    fetchCapabilities?: boolean;\n}\n\n/**\n * Configuration options to construct the sublayers of a WMS layer.\n */\nexport interface WMSSublayerConfig extends LayerBaseConfig {\n    /**\n     * The name of the WMS sublayer in the service's capabilities.\n     * Not mandatory, e.g. for WMS group layer. See [WMS spec](https://www.ogc.org/standard/wms/).\n     */\n    name?: string;\n\n    /** Configuration for nested sublayers. */\n    sublayers?: WMSSublayerConfig[];\n}\n\n/** Represents a WMS layer. */\nexport interface WMSLayer extends LayerBaseType {\n    readonly type: \"wms\";\n\n    readonly sublayers: SublayersCollection<WMSSublayer>;\n    readonly layers: undefined;\n\n    /** The URL of the WMS service that was used during layer construction. */\n    readonly url: string;\n}\n\n/** Represents a WMS sublayer */\nexport interface WMSSublayer extends SublayerBaseType {\n    readonly type: \"wms-sublayer\";\n    /**\n     * The name of the WMS sublayer in the service's capabilities.\n     *\n     * Is optional as a WMS group layer in a WMS service does not need to have a name.\n     */\n    readonly name: string | undefined;\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":";;AAqFO,MAAM,QAAgC,GAAA;;;;"}

package/api/layers/WMTSLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"WMTSLayer.js","sources":["WMTSLayer.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 { LayerBaseType, LayerConfig } from \"./base\";\nimport { WMTSLayerImpl } from \"../../model/layers/WMTSLayerImpl\";\n\nexport interface WMTSLayerConfig extends LayerConfig {\n    /** URL of the WMTS service. */\n    url: string;\n\n    /** The name of the WMTS layer in the service's capabilities. */\n    name: string;\n\n    /** The name of the tile matrix set in the service's capabilities. */\n    matrixSet: string;\n\n    /**\n     * Additional source options for the layer's WMTS source.\n     *\n     * NOTE: These options are intended for advanced configuration:\n     * the WMTS Layer manages some of the OpenLayers source options itself.\n     */\n    sourceOptions?: Partial<WMSSourceOptions>;\n}\n\nexport interface WMTSLayer extends LayerBaseType {\n    readonly type: \"wmts\";\n\n    /** URL of the WMTS service. */\n    readonly url: string;\n\n    /** The name of the WMTS layer in the service's capabilities. */\n    readonly name: string;\n\n    /** The name of the tile matrix set in the service's capabilities. */\n    readonly matrixSet: string;\n\n    readonly layers: undefined;\n}\n\nexport interface WMTSLayerConstructor {\n    prototype: WMTSLayer;\n\n    /** Creates a new {@link WMTSLayer}. */\n    new (config: WMTSLayerConfig): WMTSLayer;\n}\n\nexport const WMTSLayer: WMTSLayerConstructor = WMTSLayerImpl;\n"],"names":[],"mappings":";;AA+CO,MAAM,SAAkC,GAAA;;;;"}
+{"version":3,"file":"WMTSLayer.js","sources":["WMTSLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 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 { LayerBaseType, LayerConfig } from \"./base\";\nimport { WMTSLayerImpl } from \"../../model/layers/WMTSLayerImpl\";\n\nexport interface WMTSLayerConfig extends LayerConfig {\n    /** URL of the WMTS service. */\n    url: string;\n\n    /** The name of the WMTS layer in the service's capabilities. */\n    name: string;\n\n    /** The name of the tile matrix set in the service's capabilities. */\n    matrixSet: string;\n\n    /**\n     * Additional source options for the layer's WMTS source.\n     *\n     * NOTE: These options are intended for advanced configuration:\n     * the WMTS Layer manages some of the OpenLayers source options itself.\n     */\n    sourceOptions?: Partial<WMSSourceOptions>;\n}\n\nexport interface WMTSLayer extends LayerBaseType {\n    readonly type: \"wmts\";\n\n    /** URL of the WMTS service. */\n    readonly url: string;\n\n    /** The name of the WMTS layer in the service's capabilities. */\n    readonly name: string;\n\n    /** The name of the tile matrix set in the service's capabilities. */\n    readonly matrixSet: string;\n\n    readonly layers: undefined;\n}\n\nexport interface WMTSLayerConstructor {\n    prototype: WMTSLayer;\n\n    /** Creates a new {@link WMTSLayer}. */\n    new (config: WMTSLayerConfig): WMTSLayer;\n}\n\nexport const WMTSLayer: WMTSLayerConstructor = WMTSLayerImpl;\n"],"names":[],"mappings":";;AA+CO,MAAM,SAAkC,GAAA;;;;"}