@open-pioneer/map 1.4.0-dev.20260625074633 → 1.4.0

package/CHANGELOG.md

@@ -1,15 +1,32 @@
 # @open-pioneer/map
 
-## 1.4.0-dev.20260625074633
+## 1.4.0
 
 ### Minor Changes
 
-- c30396d: Update Chakra to 3.36.0
+- c30396d: Update Chakra to 3.36.1
+- 690a892: A layer's loadState is now a derived from three different channels:
+
+    - source — the OpenLayers source state (undefined/loading/ready/error).
+    - health — the result of the optional healthCheck (run once on attach).
+    - metadata — the result of a layer's own capabilities request (if any).
+
+    Additionally, a new property `loadError` has been added to the layer class.
+
+- e4b47f1: `useMapModel` now prints an error message if the map model could not be created.
+  This error was previously returned and was easy to silently ignore.
+
+    Use the option `quiet: true` to suppress this error message.
+
 - c9b3ced: Provide reactive rotation in MapModel
+- 690a892: WMS Layer: add validation that configured sublayers actually exist in the service's capabilities.
+- d862003: Update to trails core-packages 4.7.0
 
 ### Patch Changes
 
+- 078bef5: Use private JavaScript properties (#) instead of TypeScript keyword.
 - b58a50f: Use new `shallowEqual` function to compare attribution arrays.
+- c16a401: Migrated from eslint to oxlint and from prettier to oxfmt.
 
 ## 1.3.0
 
@@ -27,6 +44,7 @@
 - 73453af: Update OpenLayers to 10.9.0
 - fcbd505: Sanitize HTML used for layer attributions.
 - 33ab02f: Move highlight methods to `mapModel.highlights`.
+
     - `mapModel.highlight()` -> `mapModel.highlights.add()`
     - `mapModel.highlightAndZoom()` -> `mapModel.highlights.addAndZoom()`
     - `mapModel.removeHighlights()` -> `mapModel.highlights.clear()`
@@ -347,6 +365,7 @@
 - 138d85b: Update core packages to 4.2.0
 - 4f1e7bd: The internal constant `TOPMOST_LAYER_Z` has been removed.
   To configure a layer that is always on top:
+
     - Create a layer using the `LayerFactory`
     - Add it to the map model and specify the `at: "topmost"` option
 
@@ -362,6 +381,7 @@
 
 - 66179bc: Update to core-packages v4.0.0
 - acd5115: **Breaking:** Remove the following hooks, which were deprecated since version 0.8.0:
+
     - useView
     - useProjection
     - useResolution
@@ -614,6 +634,7 @@
     `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:
+
     - `useView`
     - `useProjection`
     - `useResolution`
@@ -631,6 +652,7 @@
     ```
 
 - 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.
@@ -643,34 +665,34 @@
 
     ```js
     const olLayer1 = new TileLayer({
-        source: new OSM()
+      source: new OSM(),
     });
     const olLayer2 = new TileLayer({
-        source: new BkgTopPlusOpen()
+      source: new BkgTopPlusOpen(),
     });
 
     // Create group layer with nested sub group
     const group = new GroupLayer({
-        id: "group",
-        title: "a group layer",
-        layers: [
+      id: "group",
+      title: "a group layer",
+      layers: [
+        new SimpleLayer({
+          id: "member",
+          title: "group member",
+          olLayer: olLayer1,
+        }),
+        new GroupLayer({
+          id: "subgroup",
+          title: "a nested group layer",
+          layers: [
             new SimpleLayer({
-                id: "member",
-                title: "group member",
-                olLayer: olLayer1
+              id: "submember",
+              title: "subgroup member",
+              olLayer: olLayer2,
             }),
-            new GroupLayer({
-                id: "subgroup",
-                title: "a nested group layer",
-                layers: [
-                    new SimpleLayer({
-                        id: "submember",
-                        title: "subgroup member",
-                        olLayer: olLayer2
-                    })
-                ]
-            })
-        ]
+          ],
+        }),
+      ],
     });
 
     const childLayers: GroupLayerCollection = group.layers; // Access child layers
@@ -680,6 +702,7 @@
     Sublayers (e.g. `WMSSublayer`) cannot be added to a group directly.
 
 - d8337a6: Provide new reactive properties on the `MapModel` type.
+
     - `olView` (-> `olMap.getView()`)
     - `projection` (-> `olMap.getView().getProjection()`)
     - `resolution` (-> `olMap.getView().getResolution()`)
@@ -711,6 +734,7 @@
     Two type guards have been implemented that allow to check if a layer instance is a `Layer` or `Sublayer`: `isLayer()`and `isSublayer()` (see example below).
 
     The following `type` attribute values have been implemented at the layers:
+
     - SimpleLayer: `simple`
     - WMSLayer: `wms`
     - WMSSubLayer: `wms-sublayer`

package/LayerFactory.d.ts

@@ -1,7 +1,7 @@
 import { HttpService } from "@open-pioneer/http";
 import { DECLARE_SERVICE_INTERFACE, ServiceOptions } from "@open-pioneer/runtime";
-import { LayerConfig } from "./layers/shared/LayerConfig";
 import { LayerConstructor } from "./layers/shared/internals";
+import { LayerConfig } from "./layers/shared/LayerConfig";
 import { Layer } from "./layers/unions";
 interface References {
     httpService: HttpService;

package/LayerFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"LayerFactory.js","sources":["LayerFactory.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { HttpService } from \"@open-pioneer/http\";\nimport { DECLARE_SERVICE_INTERFACE, ServiceOptions } from \"@open-pioneer/runtime\";\nimport { AbstractLayer } from \"./layers/AbstractLayer\";\nimport { LayerConfig } from \"./layers/shared/LayerConfig\";\nimport { LayerConstructor } from \"./layers/shared/internals\";\nimport { INTERNAL_CONSTRUCTOR_TAG } from \"./utils/InternalConstructorTag\";\nimport { Layer } from \"./layers/unions\";\n\ninterface References {\n    httpService: HttpService;\n}\n\n/**\n * Options that can be passed to {@link LayerFactory.create}.\n *\n * The `type` option is mandatory and indicates the type of the layer (e.g. `WMSLayer`).\n * The other options depend on the specific layer type.\n *\n * @group Services\n */\nexport type LayerCreateOptions<LayerType extends Layer, Config extends LayerConfig> = {\n    /** The layer type to construct. */\n    type: LayerConstructor<Config, LayerType>;\n} & Config;\n\n/**\n * Creates instances of layer classes.\n *\n * Use the interface `\"map.LayerFactory\"` to obtain an instance of this service.\n *\n * @group Services\n */\nexport class LayerFactory {\n    declare [DECLARE_SERVICE_INTERFACE]: \"map.LayerFactory\";\n\n    #httpService: HttpService;\n\n    constructor(options: ServiceOptions<References>) {\n        this.#httpService = options.references.httpService;\n    }\n\n    /**\n     * Creates a new instance of the given layer type.\n     * The `\"type\"` option is mandatory and specifies which layer type to create.\n     *\n     * The other configuration options may be dependent on the specific layer type.\n     *\n     * Example:\n     *\n     * ```ts\n     * import { SimpleLayer } from \"@open-pioneer/map\";\n     *\n     * const layerFactory = ...; // injected\n     * const layer = layerFactory.create({\n     *     type: SimpleLayer,\n     *     title: \"Layer title\",\n     *     olLayer: new TileLayer({}),\n     *     // ... other options\n     * });\n     * ```\n     */\n    create<LayerType extends Layer, Config extends LayerConfig>(\n        config: LayerCreateOptions<LayerType, Config>\n    ): LayerType {\n        const { type, ...rest } = config;\n        if (!type || !(type.prototype instanceof AbstractLayer)) {\n            throw new Error(\n                `Invalid layer type option. Use one of the layer classes exported by this package.`\n            );\n        }\n        return new type(\n            rest as unknown as Config,\n            { httpService: this.#httpService },\n            INTERNAL_CONSTRUCTOR_TAG\n        );\n    }\n}\n"],"names":[],"mappings":";;;AAkCO,MAAM,YAAA,CAAa;AAAA,EAGtB,YAAA;AAAA,EAEA,YAAY,OAAA,EAAqC;AAC7C,IAAA,IAAA,CAAK,YAAA,GAAe,QAAQ,UAAA,CAAW,WAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,OACI,MAAA,EACS;AACT,IAAA,MAAM,EAAE,IAAA,EAAM,GAAG,IAAA,EAAK,GAAI,MAAA;AAC1B,IAAA,IAAI,CAAC,IAAA,IAAQ,EAAE,IAAA,CAAK,qBAAqB,aAAA,CAAA,EAAgB;AACrD,MAAA,MAAM,IAAI,KAAA;AAAA,QACN,CAAA,iFAAA;AAAA,OACJ;AAAA,IACJ;AACA,IAAA,OAAO,IAAI,IAAA;AAAA,MACP,IAAA;AAAA,MACA,EAAE,WAAA,EAAa,IAAA,CAAK,YAAA,EAAa;AAAA,MACjC;AAAA,KACJ;AAAA,EACJ;AACJ;;;;"}
+{"version":3,"file":"LayerFactory.js","sources":["LayerFactory.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\n\nimport { HttpService } from \"@open-pioneer/http\";\nimport { DECLARE_SERVICE_INTERFACE, ServiceOptions } from \"@open-pioneer/runtime\";\nimport { AbstractLayer } from \"./layers/AbstractLayer\";\nimport { LayerConstructor } from \"./layers/shared/internals\";\nimport { LayerConfig } from \"./layers/shared/LayerConfig\";\nimport { Layer } from \"./layers/unions\";\nimport { INTERNAL_CONSTRUCTOR_TAG } from \"./utils/InternalConstructorTag\";\n\ninterface References {\n    httpService: HttpService;\n}\n\n/**\n * Options that can be passed to {@link LayerFactory.create}.\n *\n * The `type` option is mandatory and indicates the type of the layer (e.g. `WMSLayer`).\n * The other options depend on the specific layer type.\n *\n * @group Services\n */\nexport type LayerCreateOptions<LayerType extends Layer, Config extends LayerConfig> = {\n    /** The layer type to construct. */\n    type: LayerConstructor<Config, LayerType>;\n} & Config;\n\n/**\n * Creates instances of layer classes.\n *\n * Use the interface `\"map.LayerFactory\"` to obtain an instance of this service.\n *\n * @group Services\n */\nexport class LayerFactory {\n    declare [DECLARE_SERVICE_INTERFACE]: \"map.LayerFactory\";\n\n    #httpService: HttpService;\n\n    constructor(options: ServiceOptions<References>) {\n        this.#httpService = options.references.httpService;\n    }\n\n    /**\n     * Creates a new instance of the given layer type.\n     * The `\"type\"` option is mandatory and specifies which layer type to create.\n     *\n     * The other configuration options may be dependent on the specific layer type.\n     *\n     * Example:\n     *\n     * ```ts\n     * import { SimpleLayer } from \"@open-pioneer/map\";\n     *\n     * const layerFactory = ...; // injected\n     * const layer = layerFactory.create({\n     *     type: SimpleLayer,\n     *     title: \"Layer title\",\n     *     olLayer: new TileLayer({}),\n     *     // ... other options\n     * });\n     * ```\n     */\n    create<LayerType extends Layer, Config extends LayerConfig>(\n        config: LayerCreateOptions<LayerType, Config>\n    ): LayerType {\n        const { type, ...rest } = config;\n        if (!type || !(type.prototype instanceof AbstractLayer)) {\n            throw new Error(\n                `Invalid layer type option. Use one of the layer classes exported by this package.`\n            );\n        }\n        return new type(\n            rest as unknown as Config,\n            { httpService: this.#httpService },\n            INTERNAL_CONSTRUCTOR_TAG\n        );\n    }\n}\n"],"names":[],"mappings":";;;AAmCO,MAAM,YAAA,CAAa;AAAA,EAGtB,YAAA;AAAA,EAEA,YAAY,OAAA,EAAqC;AAC7C,IAAA,IAAA,CAAK,YAAA,GAAe,QAAQ,UAAA,CAAW,WAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,OACI,MAAA,EACS;AACT,IAAA,MAAM,EAAE,IAAA,EAAM,GAAG,IAAA,EAAK,GAAI,MAAA;AAC1B,IAAA,IAAI,CAAC,IAAA,IAAQ,EAAE,IAAA,CAAK,qBAAqB,aAAA,CAAA,EAAgB;AACrD,MAAA,MAAM,IAAI,KAAA;AAAA,QACN,CAAA,iFAAA;AAAA,OACJ;AAAA,IACJ;AACA,IAAA,OAAO,IAAI,IAAA;AAAA,MACP,IAAA;AAAA,MACA,EAAE,WAAA,EAAa,IAAA,CAAK,YAAA,EAAa;AAAA,MACjC;AAAA,KACJ;AAAA,EACJ;AACJ;;;;"}

package/MapRegistry.js

@@ -1,7 +1,7 @@
 import { batch } from '@conterra/reactivity-core';
 import { on } from '@conterra/reactivity-events';
 import { createLogger } from '@open-pioneer/core';
-import { sourceId$10 as sourceId } from './_virtual/source-info.js';
+import { sourceId$11 as sourceId } from './_virtual/source-info.js';
 import { createMapModel } from './model/createMapModel.js';
 
 const LOG = createLogger(sourceId);

package/MapRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapRegistry.js","sources":["MapRegistry.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { batch, ReadonlyReactive } from \"@conterra/reactivity-core\";\nimport { on } from \"@conterra/reactivity-events\";\nimport { createLogger, Resource } from \"@open-pioneer/core\";\nimport { HttpService } from \"@open-pioneer/http\";\nimport {\n    DECLARE_SERVICE_INTERFACE,\n    PackageIntl,\n    Service,\n    ServiceOptions\n} from \"@open-pioneer/runtime\";\nimport OlMap from \"ol/Map\";\nimport { sourceId } from \"open-pioneer:source-info\";\nimport { LayerFactory } from \"./LayerFactory\";\nimport { createMapModel } from \"./model/createMapModel\";\nimport { MapConfig } from \"./model/MapConfig\";\nimport { MapModel } from \"./model/MapModel\";\n\nconst LOG = createLogger(sourceId);\n\n/**\n * Options passed to the {@link MapConfigProvider.getMapConfig} method.\n *\n * @group Services\n */\nexport interface MapConfigProviderOptions {\n    /**\n     * A reference to the layer factory, for the construction of new layer instances.\n     */\n    layerFactory: LayerFactory;\n}\n\n/**\n * Provides an OpenLayers map configuration with a given map id.\n *\n * The implementor must also provide the interface name `\"map.MapConfigProvider\"`.\n *\n * @group Services\n */\nexport interface MapConfigProvider {\n    /**\n     * Unique identifier of the map.\n     */\n    readonly mapId: string;\n\n    /**\n     * Returns the map configuration for this map.\n     *\n     * Called by the {@link MapRegistry} when the map is requested for the first time.\n     *\n     * See {@link MapConfig} for supported options during map creation.\n     * Use {@link MapConfigProviderOptions.layerFactory} to construct new layers.\n     */\n    getMapConfig(options: MapConfigProviderOptions): Promise<MapConfig>;\n}\n\ninterface References {\n    providers: MapConfigProvider[];\n    httpService: HttpService;\n    layerFactory: LayerFactory;\n}\n\ntype ModelJobResult =\n    | { kind: \"model\"; model: MapModel; listener: Resource }\n    | { kind: \"error\"; error: Error };\n\n/**\n * Provides access to registered map instances.\n *\n * Maps are identified by a unique id.\n *\n * Inject an instance of this service by referencing the interface name `\"map.MapRegistry\"`.\n *\n * @group Services\n */\nexport class MapRegistry implements Service {\n    declare [DECLARE_SERVICE_INTERFACE]: \"map.MapRegistry\";\n\n    #currentIntl: ReadonlyReactive<PackageIntl>;\n    #httpService: HttpService;\n    #layerFactory: LayerFactory;\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, currentIntl }: ServiceOptions<References>) {\n        this.#currentIntl = currentIntl;\n        this.#httpService = references.httpService;\n        this.#layerFactory = references.layerFactory;\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        batch(() => {\n            LOG.debug(`Destroy map registry and all maps`);\n            this.#destroyed = true;\n            this.#entries.forEach((entry) => {\n                if (entry.kind === \"model\") {\n                    entry.listener.destroy();\n                    entry.model.destroy();\n                }\n            });\n            this.#entries.clear();\n            this.#modelCreationJobs.clear();\n        });\n    }\n\n    /**\n     * Returns the map model associated with the given id.\n     * Returns undefined if there is no such model.\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 entry = this.#entries.get(mapId);\n        if (entry) {\n            return unbox(entry);\n        }\n\n        const creationJob = this.#modelCreationJobs.get(mapId);\n        if (creationJob) {\n            return await waitForResult(creationJob);\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        return await this.#createMapModel(mapId, () =>\n            provider.getMapConfig({\n                layerFactory: this.#layerFactory\n            })\n        );\n    }\n\n    /**\n     * Like {@link getMapModel}, but throws if no model exists for the given `mapId`.\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    /**\n     * Creates a MapModel without the need to provide a {@link MapConfigProvider}.\n     * Throws an error if a map with the given id already exists or if the map config is invalid.\n     */\n    async createMapModel(mapId: string, options?: MapConfig): Promise<MapModel> {\n        if (this.#destroyed) {\n            throw new Error(\"MapRegistry has already been destroyed.\");\n        }\n        if (this.#entries.has(mapId)) {\n            throw new Error(`Map id '${mapId}' is not unique.`);\n        }\n        if (this.#modelCreationJobs.has(mapId)) {\n            throw new Error(`A map with the id '${mapId}' is already under construction.`);\n        }\n        return await this.#createMapModel(mapId, () => Promise.resolve(options ?? {}));\n    }\n\n    /**\n     * Given a raw OpenLayers map instance, returns the associated {@link MapModel} - or undefined\n     * if the map is unknown to this registry.\n     *\n     * All OpenLayers maps created by this registry (e.g. via {@link MapConfigProvider} or {@link createMapModel}) have an associated map model.\n     */\n    getMapModelByRawInstance(olMap: OlMap): MapModel | undefined {\n        return this.#modelsByOlMap.get(olMap);\n    }\n\n    // Wrapper method to ensure that in-progress construction of maps can be observed.\n    #createMapModel(mapId: string, configProvider: () => Promise<MapConfig>): Promise<MapModel> {\n        const creationJob = this.#modelCreationJobs.get(mapId);\n        if (creationJob) {\n            throw new Error(\"Internal error: a map model is already being created for this mapId\");\n        }\n\n        const modelPromise = this.#createMapModelImpl(mapId, configProvider)\n            .then((mapModel) => {\n                if (this.#destroyed) {\n                    mapModel.destroy();\n                    throw new Error(`MapRegistry has been destroyed.`);\n                }\n\n                const listener = on(\n                    mapModel.destroyed,\n                    () => {\n                        // Allow id reuse for dynamically created maps\n                        if (this.#isDynamic(mapId)) {\n                            const currentEntry = this.#entries.get(mapId);\n                            if (currentEntry === entry) {\n                                this.#entries.delete(mapId);\n                            }\n                        }\n                    },\n                    { dispatch: \"sync\" }\n                );\n\n                const entry: ModelJobResult = { kind: \"model\", model: mapModel, listener };\n                this.#entries.set(mapId, entry);\n                this.#modelCreationJobs.delete(mapId);\n                this.#modelsByOlMap.set(mapModel.olMap, mapModel);\n                return entry;\n            })\n            .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                if (!this.#isDynamic(mapId)) {\n                    // Don't store errors for dynamically created maps (the caller already got the error via promise).\n                    this.#entries.set(mapId, entry);\n                }\n                return entry;\n            });\n        this.#modelCreationJobs.set(mapId, modelPromise);\n        return waitForResult(modelPromise);\n    }\n\n    async #createMapModelImpl(\n        mapId: string,\n        configProvider: () => Promise<MapConfig>\n    ): Promise<MapModel> {\n        LOG.info(`Creating map with id '${mapId}'`);\n        const mapConfig = await configProvider();\n        const mapModel = await createMapModel(\n            mapId,\n            mapConfig,\n            this.#currentIntl,\n            this.#httpService\n        );\n        return mapModel;\n    }\n\n    #isDynamic(mapId: string): boolean {\n        return !this.#configProviders.has(mapId);\n    }\n}\n\nasync function waitForResult(job: Promise<ModelJobResult>): Promise<MapModel> {\n    return unbox(await job);\n}\n\nfunction unbox(entry: ModelJobResult): MapModel {\n    if (entry.kind === \"error\") {\n        throw entry.error;\n    }\n    return entry.model;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"MapRegistry.js","sources":["MapRegistry.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023-2025 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\n\nimport { batch, ReadonlyReactive } from \"@conterra/reactivity-core\";\nimport { on } from \"@conterra/reactivity-events\";\nimport { createLogger, Resource } from \"@open-pioneer/core\";\nimport { HttpService } from \"@open-pioneer/http\";\nimport {\n    DECLARE_SERVICE_INTERFACE,\n    PackageIntl,\n    Service,\n    ServiceOptions\n} from \"@open-pioneer/runtime\";\nimport OlMap from \"ol/Map\";\nimport { sourceId } from \"open-pioneer:source-info\";\nimport { LayerFactory } from \"./LayerFactory\";\nimport { createMapModel } from \"./model/createMapModel\";\nimport { MapConfig } from \"./model/MapConfig\";\nimport { MapModel } from \"./model/MapModel\";\n\nconst LOG = createLogger(sourceId);\n\n/**\n * Options passed to the {@link MapConfigProvider.getMapConfig} method.\n *\n * @group Services\n */\nexport interface MapConfigProviderOptions {\n    /**\n     * A reference to the layer factory, for the construction of new layer instances.\n     */\n    layerFactory: LayerFactory;\n}\n\n/**\n * Provides an OpenLayers map configuration with a given map id.\n *\n * The implementor must also provide the interface name `\"map.MapConfigProvider\"`.\n *\n * @group Services\n */\nexport interface MapConfigProvider {\n    /**\n     * Unique identifier of the map.\n     */\n    readonly mapId: string;\n\n    /**\n     * Returns the map configuration for this map.\n     *\n     * Called by the {@link MapRegistry} when the map is requested for the first time.\n     *\n     * See {@link MapConfig} for supported options during map creation.\n     * Use {@link MapConfigProviderOptions.layerFactory} to construct new layers.\n     */\n    getMapConfig(options: MapConfigProviderOptions): Promise<MapConfig>;\n}\n\ninterface References {\n    providers: MapConfigProvider[];\n    httpService: HttpService;\n    layerFactory: LayerFactory;\n}\n\ntype ModelJobResult =\n    | { kind: \"model\"; model: MapModel; listener: Resource }\n    | { kind: \"error\"; error: Error };\n\n/**\n * Provides access to registered map instances.\n *\n * Maps are identified by a unique id.\n *\n * Inject an instance of this service by referencing the interface name `\"map.MapRegistry\"`.\n *\n * @group Services\n */\nexport class MapRegistry implements Service {\n    declare [DECLARE_SERVICE_INTERFACE]: \"map.MapRegistry\";\n\n    #currentIntl: ReadonlyReactive<PackageIntl>;\n    #httpService: HttpService;\n    #layerFactory: LayerFactory;\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, currentIntl }: ServiceOptions<References>) {\n        this.#currentIntl = currentIntl;\n        this.#httpService = references.httpService;\n        this.#layerFactory = references.layerFactory;\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        batch(() => {\n            LOG.debug(`Destroy map registry and all maps`);\n            this.#destroyed = true;\n            this.#entries.forEach((entry) => {\n                if (entry.kind === \"model\") {\n                    entry.listener.destroy();\n                    entry.model.destroy();\n                }\n            });\n            this.#entries.clear();\n            this.#modelCreationJobs.clear();\n        });\n    }\n\n    /**\n     * Returns the map model associated with the given id.\n     * Returns undefined if there is no such model.\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 entry = this.#entries.get(mapId);\n        if (entry) {\n            return unbox(entry);\n        }\n\n        const creationJob = this.#modelCreationJobs.get(mapId);\n        if (creationJob) {\n            return await waitForResult(creationJob);\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        return await this.#createMapModel(mapId, () =>\n            provider.getMapConfig({\n                layerFactory: this.#layerFactory\n            })\n        );\n    }\n\n    /**\n     * Like {@link getMapModel}, but throws if no model exists for the given `mapId`.\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    /**\n     * Creates a MapModel without the need to provide a {@link MapConfigProvider}.\n     * Throws an error if a map with the given id already exists or if the map config is invalid.\n     */\n    async createMapModel(mapId: string, options?: MapConfig): Promise<MapModel> {\n        if (this.#destroyed) {\n            throw new Error(\"MapRegistry has already been destroyed.\");\n        }\n        if (this.#entries.has(mapId)) {\n            throw new Error(`Map id '${mapId}' is not unique.`);\n        }\n        if (this.#modelCreationJobs.has(mapId)) {\n            throw new Error(`A map with the id '${mapId}' is already under construction.`);\n        }\n        return await this.#createMapModel(mapId, () => Promise.resolve(options ?? {}));\n    }\n\n    /**\n     * Given a raw OpenLayers map instance, returns the associated {@link MapModel} - or undefined\n     * if the map is unknown to this registry.\n     *\n     * All OpenLayers maps created by this registry (e.g. via {@link MapConfigProvider} or {@link createMapModel}) have an associated map model.\n     */\n    getMapModelByRawInstance(olMap: OlMap): MapModel | undefined {\n        return this.#modelsByOlMap.get(olMap);\n    }\n\n    // Wrapper method to ensure that in-progress construction of maps can be observed.\n    #createMapModel(mapId: string, configProvider: () => Promise<MapConfig>): Promise<MapModel> {\n        const creationJob = this.#modelCreationJobs.get(mapId);\n        if (creationJob) {\n            throw new Error(\"Internal error: a map model is already being created for this mapId\");\n        }\n\n        const modelPromise = this.#createMapModelImpl(mapId, configProvider)\n            .then((mapModel) => {\n                if (this.#destroyed) {\n                    mapModel.destroy();\n                    throw new Error(`MapRegistry has been destroyed.`);\n                }\n\n                const listener = on(\n                    mapModel.destroyed,\n                    () => {\n                        // Allow id reuse for dynamically created maps\n                        if (this.#isDynamic(mapId)) {\n                            const currentEntry = this.#entries.get(mapId);\n                            if (currentEntry === entry) {\n                                this.#entries.delete(mapId);\n                            }\n                        }\n                    },\n                    { dispatch: \"sync\" }\n                );\n\n                const entry: ModelJobResult = { kind: \"model\", model: mapModel, listener };\n                this.#entries.set(mapId, entry);\n                this.#modelCreationJobs.delete(mapId);\n                this.#modelsByOlMap.set(mapModel.olMap, mapModel);\n                return entry;\n            })\n            .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                if (!this.#isDynamic(mapId)) {\n                    // Don't store errors for dynamically created maps (the caller already got the error via promise).\n                    this.#entries.set(mapId, entry);\n                }\n                return entry;\n            });\n        this.#modelCreationJobs.set(mapId, modelPromise);\n        return waitForResult(modelPromise);\n    }\n\n    async #createMapModelImpl(\n        mapId: string,\n        configProvider: () => Promise<MapConfig>\n    ): Promise<MapModel> {\n        LOG.info(`Creating map with id '${mapId}'`);\n        const mapConfig = await configProvider();\n        const mapModel = await createMapModel(\n            mapId,\n            mapConfig,\n            this.#currentIntl,\n            this.#httpService\n        );\n        return mapModel;\n    }\n\n    #isDynamic(mapId: string): boolean {\n        return !this.#configProviders.has(mapId);\n    }\n}\n\nasync function waitForResult(job: Promise<ModelJobResult>): Promise<MapModel> {\n    return unbox(await job);\n}\n\nfunction unbox(entry: ModelJobResult): MapModel {\n    if (entry.kind === \"error\") {\n        throw entry.error;\n    }\n    return entry.model;\n}\n"],"names":[],"mappings":"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"}

package/README.md

@@ -149,13 +149,9 @@ export class AppModel implements Service {
     declare [DECLARE_SERVICE_INTERFACE]: "example.AppModel";
     constructor({ references }: ServiceOptions<References>) {
         this._mapRegistry = references.mapRegistry;
-        this._mapRegistry
-            .createMapModel("myMapModelId", {
-                /* map config */
-            })
-            .then((map) => {
-                // use the map model instance
-            });
+        this._mapRegistry.createMapModel("myMapModelId", {/* map config */}).then((map) => {
+            // use the map model instance
+        });
     }
 }
 ```
@@ -193,9 +189,7 @@ import { MapConfig, MapConfigProvider } from "@open-pioneer/map";
 
 export class MapConfigProviderImpl implements MapConfigProvider {
     async getMapConfig(): Promise<MapConfig> {
-        return {
-            /* map config */
-        };
+        return {/* map config */};
     }
 }
 ```
@@ -995,19 +989,19 @@ interface References {
 }
 
 export class TestService {
-    private registry: MapRegistry;
+    #registry: MapRegistry;
 
     constructor(options: ServiceOptions<References>) {
-        this.registry = options.references.mapRegistry;
+        this.#registry = options.references.mapRegistry;
     }
 
     async centerBerlin() {
-        const model = await this.registry.getMapModel(MAP_ID);
+        const model = await this.#registry.getMapModel(MAP_ID);
         model?.olMap?.getView().fit([1489200, 6894026, 1489200, 6894026], { maxZoom: 13 });
     }
 
     async setLayerVisible() {
-        const model = await this.registry.getMapModel(MAP_ID);
+        const model = await this.#registry.getMapModel(MAP_ID);
         const layer = model?.layers.getLayerById("abe0e3f8-0ba2-409c-b6b4-9d8429c732e3");
         layer?.setVisible(true);
     }

package/_virtual/source-info.js

@@ -1,12 +1,14 @@
-const sourceId$a = "@open-pioneer/map/ui/MapContainer";
+const sourceId$b = "@open-pioneer/map/ui/MapContainer";
 
-const sourceId$9 = "@open-pioneer/map/model/MapModel";
+const sourceId$a = "@open-pioneer/map/model/MapModel";
 
-const sourceId$8 = "@open-pioneer/map/layers/AbstractLayer";
+const sourceId$9 = "@open-pioneer/map/layers/AbstractLayer";
 
-const sourceId$7 = "@open-pioneer/map/model/LayerCollection";
+const sourceId$8 = "@open-pioneer/map/model/LayerCollection";
 
-const sourceId$6 = "@open-pioneer/map/model/Overlays";
+const sourceId$7 = "@open-pioneer/map/model/Overlays";
+
+const sourceId$6 = "@open-pioneer/map/ui/hooks/useMapModel";
 
 const sourceId$5 = "@open-pioneer/map/layers/WMSLayer";
 
@@ -20,5 +22,5 @@ const sourceId$1 = "@open-pioneer/map/MapRegistry";
 
 const sourceId = "@open-pioneer/map/model/createMapModel";
 
-export { sourceId$8 as sourceId, sourceId$7 as sourceId$1, sourceId$1 as sourceId$10, sourceId$6 as sourceId$2, sourceId$9 as sourceId$3, sourceId$a as sourceId$4, sourceId$4 as sourceId$5, sourceId$5 as sourceId$6, sourceId$2 as sourceId$7, sourceId$3 as sourceId$8, sourceId as sourceId$9 };
+export { sourceId$9 as sourceId, sourceId$8 as sourceId$1, sourceId as sourceId$10, sourceId$1 as sourceId$11, sourceId$7 as sourceId$2, sourceId$a as sourceId$3, sourceId$6 as sourceId$4, sourceId$b as sourceId$5, sourceId$4 as sourceId$6, sourceId$5 as sourceId$7, sourceId$2 as sourceId$8, sourceId$3 as sourceId$9 };
 //# sourceMappingURL=source-info.js.map

package/_virtual/source-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-info.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"source-info.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/layers/AbstractLayer.d.ts

@@ -1,8 +1,9 @@
 import OlBaseLayer from "ol/layer/Base";
+import OlSource from "ol/source/Source";
 import { MapModel } from "../model/MapModel";
 import { InternalConstructorTag } from "../utils/InternalConstructorTag";
 import { AbstractLayerBase } from "./AbstractLayerBase";
-import { ATTACH_TO_MAP, GET_DEPS, LayerDependencies, SET_VISIBLE } from "./shared/internals";
+import { ATTACH_TO_MAP, GET_DEPS, LayerDependencies, SET_METADATA_LOAD_INFO, SET_VISIBLE } from "./shared/internals";
 import { SimpleLayerConfig } from "./SimpleLayer";
 import { LayerTypes } from "./unions";
 /**
@@ -11,6 +12,15 @@ import { LayerTypes } from "./unions";
  * @group Layer Utilities
  **/
 export type LayerLoadState = "not-loaded" | "loading" | "loaded" | "error";
+/**
+ * Load state of a single layer, bundling the state with its error.
+ *
+ * @internal
+ */
+export type LayerLoadInfo = "not-loaded" | "loading" | "loaded" | {
+    kind: "error";
+    error: Error;
+};
 /**
  * Represents an operational layer in the map.
  *
@@ -23,7 +33,10 @@ export type LayerLoadState = "not-loaded" | "loading" | "loaded" | "error";
  */
 export declare abstract class AbstractLayer extends AbstractLayerBase {
     #private;
-    constructor(config: SimpleLayerConfig, deps?: LayerDependencies, internalTag?: InternalConstructorTag);
+    constructor(config: SimpleLayerConfig & {
+        /** The initial load state (default: not-loaded). */
+        initialLoadInfo?: LayerLoadInfo;
+    }, deps?: LayerDependencies, internalTag?: InternalConstructorTag);
     destroy(): void;
     /**
      * Identifies the type of this layer.
@@ -34,6 +47,10 @@ export declare abstract class AbstractLayer extends AbstractLayerBase {
      * The raw OpenLayers layer.
      */
     get olLayer(): OlBaseLayer;
+    /**
+     * The current source of the {@link olLayer}.
+     */
+    get olSource(): OlSource | undefined;
     /**
      * True if this layer is a base layer.
      *
@@ -41,9 +58,19 @@ export declare abstract class AbstractLayer extends AbstractLayerBase {
      */
     get isBaseLayer(): boolean;
     /**
-     * The load state of a layer.
+     * The combined load state of a layer.
+     *
+     * Aggregates the OpenLayers source state, health check and metadata state.
+     * Priority for the state: `error` > `loading` > `not-loaded` > `loaded`.
      */
     get loadState(): LayerLoadState;
+    /**
+     * The error (if any) that prevented this layer from loading.
+     *
+     * Combines errors from the OpenLayers source, the health check and the
+     * metadata request (health > metadata > source).
+     */
+    get loadError(): Error | undefined;
     /**
      * The minimum resolution (inclusive) at which this layer will be visible.
      */
@@ -86,6 +113,12 @@ export declare abstract class AbstractLayer extends AbstractLayerBase {
      * @internal
      */
     [ATTACH_TO_MAP](map: MapModel): void;
+    /**
+     * Updates the load state of the layer's metadata request.
+     *
+     * @internal
+     */
+    [SET_METADATA_LOAD_INFO](loadInfo: LayerLoadInfo): void;
     setVisible(newVisibility: boolean): void;
     /** @internal */
     [SET_VISIBLE](newVisibility: boolean): void;