@geospatial-sdk/core 0.0.5-dev.45 → 0.0.5-dev.47

package/dist/utils/index.d.ts

@@ -6,6 +6,7 @@ export * from "./url.js";
 export * from "./freeze.js";
 export * from "./hash.js";
 export { computeMapContextDiff } from "./map-context-diff.js";
-export { getLayerPosition, addLayerToContext, removeLayerFromContext, replaceLayerInContext, changeLayerPositionInContext, } from "./map-context.js";
+export { getLayerPosition, addLayerToContext, removeLayerFromContext, replaceLayerInContext, changeLayerPositionInContext, updateLayerInContext, } from "./map-context.js";
+export { updateLayer } from "./map-context-layer.js";
 export { createViewFromLayer } from "./view.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/utils/index.js

@@ -6,5 +6,6 @@ export * from "./url.js";
 export * from "./freeze.js";
 export * from "./hash.js";
 export { computeMapContextDiff } from "./map-context-diff.js";
-export { getLayerPosition, addLayerToContext, removeLayerFromContext, replaceLayerInContext, changeLayerPositionInContext, } from "./map-context.js";
+export { getLayerPosition, addLayerToContext, removeLayerFromContext, replaceLayerInContext, changeLayerPositionInContext, updateLayerInContext, } from "./map-context.js";
+export { updateLayer } from "./map-context-layer.js";
 export { createViewFromLayer } from "./view.js";

package/dist/utils/map-context-diff.js

@@ -1,4 +1,4 @@
-import { isLayerSame, isLayerSameAndUnchanged } from "./map-context.js";
+import { isLayerSame, isLayerSameAndUnchanged } from "./map-context-layer.js";
 /**
  * The following logic is produced by identifying layers in both context
  * and determining whether they have been added, removed, changed or reordered.

package/dist/utils/map-context-layer.d.ts

@@ -0,0 +1,13 @@
+import { MapContextLayer } from "../model/index.js";
+export declare function getLayerHash(layer: MapContextLayer, includeExtras?: boolean): string;
+export declare function isLayerSame(layerA: MapContextLayer, layerB: MapContextLayer): boolean;
+export declare function isLayerSameAndUnchanged(layerA: MapContextLayer, layerB: MapContextLayer): boolean;
+/**
+ * Applies the `updates` partial to the given layer. The layer will also be
+ * adjusted depending on the presence of the `id` and `version` fields.
+ * Note: any property set to `undefined` in `updates` will be removed from the resulting layer.
+ * @param layer
+ * @param updates
+ */
+export declare function updateLayer(layer: MapContextLayer, updates: Partial<MapContextLayer>): MapContextLayer;
+//# sourceMappingURL=map-context-layer.d.ts.map

package/dist/utils/map-context-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-context-layer.d.ts","sourceRoot":"","sources":["../../lib/utils/map-context-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,aAAa,UAAQ,GACpB,MAAM,CAER;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAKT;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAST;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,eAAe,CAkBjB"}

package/dist/utils/map-context-layer.js

@@ -0,0 +1,42 @@
+import { getHash } from "./hash.js";
+export function getLayerHash(layer, includeExtras = false) {
+    return getHash(layer, includeExtras ? [] : ["extras"]);
+}
+export function isLayerSame(layerA, layerB) {
+    if ("id" in layerA && "id" in layerB) {
+        return layerA.id == layerB.id;
+    }
+    return getLayerHash(layerA) === getLayerHash(layerB);
+}
+export function isLayerSameAndUnchanged(layerA, layerB) {
+    if ("id" in layerA &&
+        "id" in layerB &&
+        ("version" in layerA || "version" in layerB)) {
+        return layerA.id == layerB.id && layerA.version == layerB.version;
+    }
+    return getLayerHash(layerA, true) === getLayerHash(layerB, true);
+}
+/**
+ * Applies the `updates` partial to the given layer. The layer will also be
+ * adjusted depending on the presence of the `id` and `version` fields.
+ * Note: any property set to `undefined` in `updates` will be removed from the resulting layer.
+ * @param layer
+ * @param updates
+ */
+export function updateLayer(layer, updates) {
+    const updatedLayer = {
+        ...layer,
+        ...updates,
+    };
+    if ("id" in updatedLayer &&
+        "version" in updatedLayer &&
+        typeof updatedLayer.version === "number") {
+        updatedLayer.version = updatedLayer.version + 1;
+    }
+    for (const key in updatedLayer) {
+        if (updatedLayer[key] === undefined) {
+            delete updatedLayer[key];
+        }
+    }
+    return updatedLayer;
+}

package/dist/utils/map-context.d.ts

@@ -1,41 +1,47 @@
 import { MapContext, MapContextLayer } from "../model/index.js";
-export declare function getLayerHash(layer: MapContextLayer, includeExtras?: boolean): string;
-export declare function isLayerSame(layerA: MapContextLayer, layerB: MapContextLayer): boolean;
-export declare function isLayerSameAndUnchanged(layerA: MapContextLayer, layerB: MapContextLayer): boolean;
 export declare function getLayerPosition(context: MapContext, layerModel: MapContextLayer): number;
 /**
  * Adds a layer to the context at a specific position or at the end if no position is specified.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be added.
- * @param {number} [position] - The position at which to add the layer. If not specified, the layer is added at the end.
- * @returns {MapContext} - The new map context with the added layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be added.
+ * @param [position] The position at which to add the layer. If not specified, the layer is added at the end.
+ * @returns The new map context with the added layer.
  */
 export declare function addLayerToContext(context: MapContext, layerModel: MapContextLayer, position?: number): MapContext;
 /**
  * Removes a layer from the context.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be removed.
- * @returns {MapContext} - The new map context without the removed layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be removed.
+ * @returns The new map context without the removed layer.
  */
 export declare function removeLayerFromContext(context: MapContext, layerModel: MapContextLayer): MapContext;
 /**
  * Replaces a layer in the context with a new layer.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be replaced.
- * @param {MapContextLayer} replacement - The new layer that will replace the old one.
- * @returns {MapContext} - The new map context with the replaced layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be replaced.
+ * @param replacement The new layer that will replace the old one.
+ * @returns The new map context with the replaced layer.
  */
 export declare function replaceLayerInContext(context: MapContext, layerModel: MapContextLayer, replacement: MapContextLayer): MapContext;
+/**
+ * Replaces a layer in the context with a new layer.
+ *
+ * @param context The current map context.
+ * @param layerModel The layer to be replaced.
+ * @param layerUpdates The new layer that will replace the old one.
+ * @returns The new map context with the updated layer.
+ */
+export declare function updateLayerInContext(context: MapContext, layerModel: MapContextLayer, layerUpdates: Partial<MapContextLayer>): MapContext;
 /**
  * Changes the position of a layer in the context.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer whose position is to be changed.
- * @param {number} position - The new position for the layer.
- * @returns {MapContext} - The new map context with the layer moved to the new position.
+ * @param context The current map context.
+ * @param layerModel The layer whose position is to be changed.
+ * @param position The new position for the layer.
+ * @returns The new map context with the layer moved to the new position.
  */
 export declare function changeLayerPositionInContext(context: MapContext, layerModel: MapContextLayer, position: number): MapContext;
 //# sourceMappingURL=map-context.d.ts.map

package/dist/utils/map-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-context.d.ts","sourceRoot":"","sources":["../../lib/utils/map-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGhE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,aAAa,UAAQ,GACpB,MAAM,CAER;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAKT;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAST;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,GAC1B,MAAM,CAER;AAED;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAQZ;AAED;;;;;;GAMG;AAEH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,GAC1B,UAAU,CAOZ;AAED;;;;;;;GAOG;AAEH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,EAC3B,WAAW,EAAE,eAAe,GAC3B,UAAU,CAOZ;AAED;;;;;;;GAOG;AAEH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,EAC3B,QAAQ,EAAE,MAAM,GACf,UAAU,CAGZ"}
+{"version":3,"file":"map-context.d.ts","sourceRoot":"","sources":["../../lib/utils/map-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGhE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,GAC1B,MAAM,CAER;AAED;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAQZ;AAED;;;;;;GAMG;AAEH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,GAC1B,UAAU,CAOZ;AAED;;;;;;;GAOG;AAEH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,EAC3B,WAAW,EAAE,eAAe,GAC3B,UAAU,CAOZ;AAED;;;;;;;GAOG;AAEH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,EAC3B,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC,GACrC,UAAU,CAUZ;AAED;;;;;;;GAOG;AAEH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,EAC3B,QAAQ,EAAE,MAAM,GACf,UAAU,CAGZ"}

package/dist/utils/map-context.js

@@ -1,31 +1,14 @@
-import { getHash } from "./hash.js";
-export function getLayerHash(layer, includeExtras = false) {
-    return getHash(layer, includeExtras ? [] : ["extras"]);
-}
-export function isLayerSame(layerA, layerB) {
-    if ("id" in layerA && "id" in layerB) {
-        return layerA.id == layerB.id;
-    }
-    return getLayerHash(layerA) === getLayerHash(layerB);
-}
-export function isLayerSameAndUnchanged(layerA, layerB) {
-    if ("id" in layerA &&
-        "id" in layerB &&
-        ("version" in layerA || "version" in layerB)) {
-        return layerA.id == layerB.id && layerA.version == layerB.version;
-    }
-    return getLayerHash(layerA, true) === getLayerHash(layerB, true);
-}
+import { isLayerSame, updateLayer } from "./map-context-layer.js";
 export function getLayerPosition(context, layerModel) {
     return context.layers.findIndex((l) => isLayerSame(layerModel, l));
 }
 /**
  * Adds a layer to the context at a specific position or at the end if no position is specified.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be added.
- * @param {number} [position] - The position at which to add the layer. If not specified, the layer is added at the end.
- * @returns {MapContext} - The new map context with the added layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be added.
+ * @param [position] The position at which to add the layer. If not specified, the layer is added at the end.
+ * @returns The new map context with the added layer.
  */
 export function addLayerToContext(context, layerModel, position) {
     const newContext = { ...context, layers: [...context.layers] };
@@ -40,9 +23,9 @@ export function addLayerToContext(context, layerModel, position) {
 /**
  * Removes a layer from the context.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be removed.
- * @returns {MapContext} - The new map context without the removed layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be removed.
+ * @returns The new map context without the removed layer.
  */
 export function removeLayerFromContext(context, layerModel) {
     const newContext = { ...context, layers: [...context.layers] };
@@ -55,10 +38,10 @@ export function removeLayerFromContext(context, layerModel) {
 /**
  * Replaces a layer in the context with a new layer.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be replaced.
- * @param {MapContextLayer} replacement - The new layer that will replace the old one.
- * @returns {MapContext} - The new map context with the replaced layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be replaced.
+ * @param replacement The new layer that will replace the old one.
+ * @returns The new map context with the replaced layer.
  */
 export function replaceLayerInContext(context, layerModel, replacement) {
     const newContext = { ...context, layers: [...context.layers] };
@@ -68,13 +51,32 @@ export function replaceLayerInContext(context, layerModel, replacement) {
     }
     return newContext;
 }
+/**
+ * Replaces a layer in the context with a new layer.
+ *
+ * @param context The current map context.
+ * @param layerModel The layer to be replaced.
+ * @param layerUpdates The new layer that will replace the old one.
+ * @returns The new map context with the updated layer.
+ */
+export function updateLayerInContext(context, layerModel, layerUpdates) {
+    const position = getLayerPosition(context, layerModel);
+    if (position >= 0) {
+        const existing = context.layers[getLayerPosition(context, layerModel)];
+        const updated = updateLayer(existing, layerUpdates);
+        return replaceLayerInContext(context, layerModel, updated);
+    }
+    // we're building a new context so that the reference is changed anyway; this is done to be
+    // consistent with other utilities that always change the context reference even if the layer wasn't found
+    return { ...context };
+}
 /**
  * Changes the position of a layer in the context.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer whose position is to be changed.
- * @param {number} position - The new position for the layer.
- * @returns {MapContext} - The new map context with the layer moved to the new position.
+ * @param context The current map context.
+ * @param layerModel The layer whose position is to be changed.
+ * @param position The new position for the layer.
+ * @returns The new map context with the layer moved to the new position.
  */
 export function changeLayerPositionInContext(context, layerModel, position) {
     const newContext = removeLayerFromContext(context, layerModel);

package/lib/utils/index.ts

@@ -13,5 +13,7 @@ export {
   removeLayerFromContext,
   replaceLayerInContext,
   changeLayerPositionInContext,
+  updateLayerInContext,
 } from "./map-context.js";
+export { updateLayer } from "./map-context-layer.js";
 export { createViewFromLayer } from "./view.js";

package/lib/utils/map-context-diff.ts

@@ -5,7 +5,7 @@ import {
   MapContextLayerPositioned,
   MapContextLayerReordered,
 } from "../model/index.js";
-import { isLayerSame, isLayerSameAndUnchanged } from "./map-context.js";
+import { isLayerSame, isLayerSameAndUnchanged } from "./map-context-layer.js";
 
 /**
  * The following logic is produced by identifying layers in both context

package/lib/utils/map-context-layer.test.ts

@@ -0,0 +1,351 @@
+import { describe } from "vitest";
+import {
+  getLayerHash,
+  isLayerSame,
+  isLayerSameAndUnchanged,
+  updateLayer,
+} from "./map-context-layer.js";
+import {
+  SAMPLE_LAYER1,
+  SAMPLE_LAYER2,
+} from "../../fixtures/map-context.fixtures.js";
+
+describe("Map context layer utils", () => {
+  describe("isLayerSame", () => {
+    describe("layers with id", () => {
+      it("compares non-strictly by id", () => {
+        expect(
+          isLayerSame(
+            { ...SAMPLE_LAYER1, id: "a" },
+            { ...SAMPLE_LAYER1, id: "b" },
+          ),
+        ).toBe(false);
+        expect(
+          isLayerSame(
+            { ...SAMPLE_LAYER1, id: "ab" },
+            { ...SAMPLE_LAYER2, id: "ab" },
+          ),
+        ).toBe(true);
+        expect(
+          isLayerSame(
+            { ...SAMPLE_LAYER1, id: 1 },
+            { ...SAMPLE_LAYER2, id: "01" },
+          ),
+        ).toBe(true);
+        expect(
+          isLayerSame({ ...SAMPLE_LAYER1, id: 1 }, { ...SAMPLE_LAYER2, id: 1 }),
+        ).toBe(true);
+        expect(
+          isLayerSame({ ...SAMPLE_LAYER1, id: 1 }, { ...SAMPLE_LAYER1, id: 2 }),
+        ).toBe(false);
+      });
+    });
+    describe("layers without id", () => {
+      it("compares by properties", () => {
+        expect(isLayerSame(SAMPLE_LAYER1, SAMPLE_LAYER1)).toBe(true);
+        expect(
+          isLayerSame(SAMPLE_LAYER1, { ...SAMPLE_LAYER1, name: "abc" }),
+        ).toBe(false);
+        expect(
+          isLayerSame(
+            {
+              ...SAMPLE_LAYER1,
+              url: "http://abc.org",
+              name: SAMPLE_LAYER1.name,
+            },
+            { ...SAMPLE_LAYER1, url: "http://abc.org" },
+          ),
+        ).toBe(true);
+        expect(isLayerSame(SAMPLE_LAYER1, SAMPLE_LAYER2)).toBe(false);
+      });
+      it("ignores extras prop", () => {
+        expect(
+          isLayerSame(SAMPLE_LAYER1, {
+            ...SAMPLE_LAYER1,
+            extras: { otherProp: "abc" },
+          }),
+        ).toBe(true);
+        expect(
+          isLayerSame(SAMPLE_LAYER1, {
+            ...SAMPLE_LAYER1,
+            extras: undefined,
+          }),
+        ).toBe(true);
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const { extras, ...layer } = SAMPLE_LAYER1;
+        expect(isLayerSame(SAMPLE_LAYER1, layer)).toBe(true);
+      });
+    });
+    describe("layers with and without id", () => {
+      it("compares by properties", () => {
+        expect(
+          isLayerSame(SAMPLE_LAYER1, { ...SAMPLE_LAYER1, id: "123" }),
+        ).toBe(false);
+        expect(
+          isLayerSame(
+            { ...SAMPLE_LAYER1, id: "123" },
+            { id: "123", ...SAMPLE_LAYER1, name: SAMPLE_LAYER1.name },
+          ),
+        ).toBe(true);
+      });
+    });
+  });
+
+  describe("isLayerSameAndUnchanged", () => {
+    describe("layers with id and version", () => {
+      it("compares non-strictly by id and version field", () => {
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER1, id: "ab", version: 2 },
+            { ...SAMPLE_LAYER2, id: "ab", version: 2 },
+          ),
+        ).toBe(true);
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER1, id: "ab", version: 2 },
+            { ...SAMPLE_LAYER1, id: "ab", version: 1 },
+          ),
+        ).toBe(false);
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER1, id: 1 },
+            { ...SAMPLE_LAYER1, id: "01", version: 3 },
+          ),
+        ).toBe(false);
+      });
+    });
+    describe("layers with id and both without version", () => {
+      it("compares by properties, including extras", () => {
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER1, id: "a" },
+            { ...SAMPLE_LAYER1, id: "b" },
+          ),
+        ).toBe(false);
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER1, id: "a" },
+            { ...SAMPLE_LAYER2, id: "a" },
+          ),
+        ).toBe(false);
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER1, id: "a" },
+            { ...SAMPLE_LAYER1, id: "a" },
+          ),
+        ).toBe(true);
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER2, id: "b", extras: { hello: "world" } },
+            { ...SAMPLE_LAYER2, id: "b", extras: { hello: "world" } },
+          ),
+        ).toBe(true);
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER2, id: "b", extras: { hello: "world" } },
+            { ...SAMPLE_LAYER2, id: "b", extras: { foo: "bar" } },
+          ),
+        ).toBe(false);
+      });
+    });
+    describe("layers without id", () => {
+      it("compares by properties, including extras", () => {
+        expect(isLayerSameAndUnchanged(SAMPLE_LAYER1, SAMPLE_LAYER1)).toBe(
+          true,
+        );
+        expect(
+          isLayerSameAndUnchanged(SAMPLE_LAYER1, {
+            ...SAMPLE_LAYER1,
+            name: "abc",
+          }),
+        ).toBe(false);
+        expect(
+          isLayerSameAndUnchanged(
+            {
+              ...SAMPLE_LAYER1,
+              url: "http://abc.org",
+              name: SAMPLE_LAYER1.name,
+            },
+            { ...SAMPLE_LAYER1, url: "http://abc.org" },
+          ),
+        ).toBe(true);
+        expect(
+          isLayerSameAndUnchanged(
+            {
+              ...SAMPLE_LAYER1,
+              opacity: 1,
+            },
+            SAMPLE_LAYER1,
+          ),
+        ).toBe(false);
+        expect(isLayerSameAndUnchanged(SAMPLE_LAYER1, SAMPLE_LAYER2)).toBe(
+          false,
+        );
+      });
+      it("takes into account extras prop", () => {
+        expect(
+          isLayerSameAndUnchanged(SAMPLE_LAYER1, {
+            ...SAMPLE_LAYER1,
+            extras: { otherProp: "abc" },
+          }),
+        ).toBe(false);
+        expect(
+          isLayerSameAndUnchanged(SAMPLE_LAYER1, {
+            ...SAMPLE_LAYER1,
+            extras: undefined,
+          }),
+        ).toBe(false);
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const { extras, ...layer } = SAMPLE_LAYER1;
+        expect(isLayerSameAndUnchanged(SAMPLE_LAYER1, layer)).toBe(false);
+      });
+    });
+    describe("layers with and without id", () => {
+      it("compares by properties", () => {
+        expect(
+          isLayerSameAndUnchanged(SAMPLE_LAYER1, {
+            ...SAMPLE_LAYER1,
+            id: "123",
+          }),
+        ).toBe(false);
+        expect(
+          isLayerSameAndUnchanged(
+            { ...SAMPLE_LAYER1, id: "123" },
+            { id: "123", ...SAMPLE_LAYER1, name: SAMPLE_LAYER1.name },
+          ),
+        ).toBe(true);
+      });
+    });
+  });
+
+  describe("getLayerHash", () => {
+    it("works with serializable entities", () => {
+      expect(
+        getLayerHash({
+          ...SAMPLE_LAYER1,
+          extras: {
+            array: [11, 22, null, undefined],
+            object: {},
+            undef: undefined,
+          },
+        }),
+      ).toBeTypeOf("string");
+    });
+    it("ignores extra property by default", () => {
+      expect(
+        getLayerHash({
+          ...SAMPLE_LAYER1,
+          extras: {
+            array: [11, 22, null, undefined],
+            object: {},
+          },
+        }),
+      ).toEqual(
+        getLayerHash({
+          ...SAMPLE_LAYER1,
+          extras: { hello: "world" },
+        }),
+      );
+    });
+    it("works with non-serializable entities (but they are ignored)", () => {
+      const hash = getLayerHash(
+        {
+          ...SAMPLE_LAYER1,
+          extras: {
+            func: () => 123,
+            canvas: document.createElement("canvas"),
+          },
+        },
+        true,
+      );
+      expect(hash).toBeTypeOf("string");
+      expect(hash).toEqual(
+        getLayerHash(
+          {
+            ...SAMPLE_LAYER1,
+            extras: {
+              func: () => 456,
+              canvas: document.createElement("div"),
+            },
+          },
+          true,
+        ),
+      );
+      expect(hash).not.toEqual(
+        getLayerHash(
+          {
+            ...SAMPLE_LAYER1,
+            extras: {},
+          },
+          true,
+        ),
+      );
+    });
+    it("does not take into account properties order", () => {
+      expect(
+        getLayerHash(
+          {
+            type: "wms",
+            url: "http://abc.org/wms",
+            name: "myLayer",
+            extras: {
+              array: [1, 2, 3],
+              object: {},
+            },
+          },
+          true,
+        ),
+      ).toEqual(
+        getLayerHash(
+          {
+            extras: {
+              array: [1, 2, 3],
+              object: {},
+            },
+            url: "http://abc.org/wms",
+            type: "wms",
+            name: "myLayer",
+          },
+          true,
+        ),
+      );
+    });
+  });
+
+  describe("updateLayer", () => {
+    it("applies updates to a layer", () => {
+      const updated = updateLayer(SAMPLE_LAYER1, {
+        opacity: 0.9,
+        visibility: false,
+      });
+      expect(updated).toMatchObject({
+        ...SAMPLE_LAYER1,
+        opacity: 0.9,
+        visibility: false,
+      });
+    });
+
+    it("does not modify the original layer", () => {
+      const updated = updateLayer(SAMPLE_LAYER1, { opacity: 0.5 });
+      expect(updated).not.toBe(SAMPLE_LAYER1);
+    });
+
+    it("removes properties set to undefined", () => {
+      const layerWithOpacity = { ...SAMPLE_LAYER1, opacity: 0.8 };
+      const updated = updateLayer(layerWithOpacity, { opacity: undefined });
+      expect(updated).not.toHaveProperty("opacity");
+    });
+
+    it("increments version when layer has both id and version", () => {
+      const layer = { ...SAMPLE_LAYER1, id: "123", version: 0 };
+      const updated = updateLayer(layer, { opacity: 0.6 });
+      expect(updated.version).toBe(1);
+    });
+
+    it("does not write version when layer only has id", () => {
+      const layer = { ...SAMPLE_LAYER1, id: "123" };
+      const updated = updateLayer(layer, { opacity: 0.6 });
+      expect(updated).not.toHaveProperty("version");
+    });
+  });
+});

package/lib/utils/map-context-layer.ts

@@ -0,0 +1,63 @@
+import { MapContextLayer } from "../model/index.js";
+import { getHash } from "./hash.js";
+
+export function getLayerHash(
+  layer: MapContextLayer,
+  includeExtras = false,
+): string {
+  return getHash(layer, includeExtras ? [] : ["extras"]);
+}
+
+export function isLayerSame(
+  layerA: MapContextLayer,
+  layerB: MapContextLayer,
+): boolean {
+  if ("id" in layerA && "id" in layerB) {
+    return layerA.id == layerB.id;
+  }
+  return getLayerHash(layerA) === getLayerHash(layerB);
+}
+
+export function isLayerSameAndUnchanged(
+  layerA: MapContextLayer,
+  layerB: MapContextLayer,
+): boolean {
+  if (
+    "id" in layerA &&
+    "id" in layerB &&
+    ("version" in layerA || "version" in layerB)
+  ) {
+    return layerA.id == layerB.id && layerA.version == layerB.version;
+  }
+  return getLayerHash(layerA, true) === getLayerHash(layerB, true);
+}
+
+/**
+ * Applies the `updates` partial to the given layer. The layer will also be
+ * adjusted depending on the presence of the `id` and `version` fields.
+ * Note: any property set to `undefined` in `updates` will be removed from the resulting layer.
+ * @param layer
+ * @param updates
+ */
+export function updateLayer(
+  layer: MapContextLayer,
+  updates: Partial<MapContextLayer>,
+): MapContextLayer {
+  const updatedLayer: MapContextLayer = {
+    ...layer,
+    ...updates,
+  } as MapContextLayer;
+  if (
+    "id" in updatedLayer &&
+    "version" in updatedLayer &&
+    typeof updatedLayer.version === "number"
+  ) {
+    updatedLayer.version = updatedLayer.version + 1;
+  }
+  for (const key in updatedLayer) {
+    if (updatedLayer[key as keyof MapContextLayer] === undefined) {
+      delete updatedLayer[key as keyof MapContextLayer];
+    }
+  }
+  return updatedLayer;
+}

package/lib/utils/map-context.test.ts

@@ -2,14 +2,12 @@ import { describe } from "vitest";
 import {
   addLayerToContext,
   changeLayerPositionInContext,
-  getLayerHash,
   getLayerPosition,
-  isLayerSame,
-  isLayerSameAndUnchanged,
   removeLayerFromContext,
   replaceLayerInContext,
+  updateLayerInContext,
 } from "./map-context.js";
-import { MapContext } from "../model/index.js";
+import { MapContext, MapContextLayer } from "../model/index.js";
 import {
   SAMPLE_CONTEXT,
   SAMPLE_LAYER1,
@@ -18,307 +16,6 @@ import {
 } from "../../fixtures/map-context.fixtures.js";
 
 describe("Map context utils", () => {
-  describe("isLayerSame", () => {
-    describe("layers with id", () => {
-      it("compares non-strictly by id", () => {
-        expect(
-          isLayerSame(
-            { ...SAMPLE_LAYER1, id: "a" },
-            { ...SAMPLE_LAYER1, id: "b" },
-          ),
-        ).toBe(false);
-        expect(
-          isLayerSame(
-            { ...SAMPLE_LAYER1, id: "ab" },
-            { ...SAMPLE_LAYER2, id: "ab" },
-          ),
-        ).toBe(true);
-        expect(
-          isLayerSame(
-            { ...SAMPLE_LAYER1, id: 1 },
-            { ...SAMPLE_LAYER2, id: "01" },
-          ),
-        ).toBe(true);
-        expect(
-          isLayerSame({ ...SAMPLE_LAYER1, id: 1 }, { ...SAMPLE_LAYER2, id: 1 }),
-        ).toBe(true);
-        expect(
-          isLayerSame({ ...SAMPLE_LAYER1, id: 1 }, { ...SAMPLE_LAYER1, id: 2 }),
-        ).toBe(false);
-      });
-    });
-    describe("layers without id", () => {
-      it("compares by properties", () => {
-        expect(isLayerSame(SAMPLE_LAYER1, SAMPLE_LAYER1)).toBe(true);
-        expect(
-          isLayerSame(SAMPLE_LAYER1, { ...SAMPLE_LAYER1, name: "abc" }),
-        ).toBe(false);
-        expect(
-          isLayerSame(
-            {
-              ...SAMPLE_LAYER1,
-              url: "http://abc.org",
-              name: SAMPLE_LAYER1.name,
-            },
-            { ...SAMPLE_LAYER1, url: "http://abc.org" },
-          ),
-        ).toBe(true);
-        expect(isLayerSame(SAMPLE_LAYER1, SAMPLE_LAYER2)).toBe(false);
-      });
-      it("ignores extras prop", () => {
-        expect(
-          isLayerSame(SAMPLE_LAYER1, {
-            ...SAMPLE_LAYER1,
-            extras: { otherProp: "abc" },
-          }),
-        ).toBe(true);
-        expect(
-          isLayerSame(SAMPLE_LAYER1, {
-            ...SAMPLE_LAYER1,
-            extras: undefined,
-          }),
-        ).toBe(true);
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const { extras, ...layer } = SAMPLE_LAYER1;
-        expect(isLayerSame(SAMPLE_LAYER1, layer)).toBe(true);
-      });
-    });
-    describe("layers with and without id", () => {
-      it("compares by properties", () => {
-        expect(
-          isLayerSame(SAMPLE_LAYER1, { ...SAMPLE_LAYER1, id: "123" }),
-        ).toBe(false);
-        expect(
-          isLayerSame(
-            { ...SAMPLE_LAYER1, id: "123" },
-            { id: "123", ...SAMPLE_LAYER1, name: SAMPLE_LAYER1.name },
-          ),
-        ).toBe(true);
-      });
-    });
-  });
-
-  describe("isLayerSameAndUnchanged", () => {
-    describe("layers with id and version", () => {
-      it("compares non-strictly by id and version field", () => {
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER1, id: "ab", version: 2 },
-            { ...SAMPLE_LAYER2, id: "ab", version: 2 },
-          ),
-        ).toBe(true);
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER1, id: "ab", version: 2 },
-            { ...SAMPLE_LAYER1, id: "ab", version: 1 },
-          ),
-        ).toBe(false);
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER1, id: 1 },
-            { ...SAMPLE_LAYER1, id: "01", version: 3 },
-          ),
-        ).toBe(false);
-      });
-    });
-    describe("layers with id and both without version", () => {
-      it("compares by properties, including extras", () => {
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER1, id: "a" },
-            { ...SAMPLE_LAYER1, id: "b" },
-          ),
-        ).toBe(false);
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER1, id: "a" },
-            { ...SAMPLE_LAYER2, id: "a" },
-          ),
-        ).toBe(false);
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER1, id: "a" },
-            { ...SAMPLE_LAYER1, id: "a" },
-          ),
-        ).toBe(true);
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER2, id: "b", extras: { hello: "world" } },
-            { ...SAMPLE_LAYER2, id: "b", extras: { hello: "world" } },
-          ),
-        ).toBe(true);
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER2, id: "b", extras: { hello: "world" } },
-            { ...SAMPLE_LAYER2, id: "b", extras: { foo: "bar" } },
-          ),
-        ).toBe(false);
-      });
-    });
-    describe("layers without id", () => {
-      it("compares by properties, including extras", () => {
-        expect(isLayerSameAndUnchanged(SAMPLE_LAYER1, SAMPLE_LAYER1)).toBe(
-          true,
-        );
-        expect(
-          isLayerSameAndUnchanged(SAMPLE_LAYER1, {
-            ...SAMPLE_LAYER1,
-            name: "abc",
-          }),
-        ).toBe(false);
-        expect(
-          isLayerSameAndUnchanged(
-            {
-              ...SAMPLE_LAYER1,
-              url: "http://abc.org",
-              name: SAMPLE_LAYER1.name,
-            },
-            { ...SAMPLE_LAYER1, url: "http://abc.org" },
-          ),
-        ).toBe(true);
-        expect(
-          isLayerSameAndUnchanged(
-            {
-              ...SAMPLE_LAYER1,
-              opacity: 1,
-            },
-            SAMPLE_LAYER1,
-          ),
-        ).toBe(false);
-        expect(isLayerSameAndUnchanged(SAMPLE_LAYER1, SAMPLE_LAYER2)).toBe(
-          false,
-        );
-      });
-      it("takes into account extras prop", () => {
-        expect(
-          isLayerSameAndUnchanged(SAMPLE_LAYER1, {
-            ...SAMPLE_LAYER1,
-            extras: { otherProp: "abc" },
-          }),
-        ).toBe(false);
-        expect(
-          isLayerSameAndUnchanged(SAMPLE_LAYER1, {
-            ...SAMPLE_LAYER1,
-            extras: undefined,
-          }),
-        ).toBe(false);
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const { extras, ...layer } = SAMPLE_LAYER1;
-        expect(isLayerSameAndUnchanged(SAMPLE_LAYER1, layer)).toBe(false);
-      });
-    });
-    describe("layers with and without id", () => {
-      it("compares by properties", () => {
-        expect(
-          isLayerSameAndUnchanged(SAMPLE_LAYER1, {
-            ...SAMPLE_LAYER1,
-            id: "123",
-          }),
-        ).toBe(false);
-        expect(
-          isLayerSameAndUnchanged(
-            { ...SAMPLE_LAYER1, id: "123" },
-            { id: "123", ...SAMPLE_LAYER1, name: SAMPLE_LAYER1.name },
-          ),
-        ).toBe(true);
-      });
-    });
-  });
-
-  describe("getLayerHash", () => {
-    it("works with serializable entities", () => {
-      expect(
-        getLayerHash({
-          ...SAMPLE_LAYER1,
-          extras: {
-            array: [11, 22, null, undefined],
-            object: {},
-            undef: undefined,
-          },
-        }),
-      ).toBeTypeOf("string");
-    });
-    it("ignores extra property by default", () => {
-      expect(
-        getLayerHash({
-          ...SAMPLE_LAYER1,
-          extras: {
-            array: [11, 22, null, undefined],
-            object: {},
-          },
-        }),
-      ).toEqual(
-        getLayerHash({
-          ...SAMPLE_LAYER1,
-          extras: { hello: "world" },
-        }),
-      );
-    });
-    it("works with non-serializable entities (but they are ignored)", () => {
-      const hash = getLayerHash(
-        {
-          ...SAMPLE_LAYER1,
-          extras: {
-            func: () => 123,
-            canvas: document.createElement("canvas"),
-          },
-        },
-        true,
-      );
-      expect(hash).toBeTypeOf("string");
-      expect(hash).toEqual(
-        getLayerHash(
-          {
-            ...SAMPLE_LAYER1,
-            extras: {
-              func: () => 456,
-              canvas: document.createElement("div"),
-            },
-          },
-          true,
-        ),
-      );
-      expect(hash).not.toEqual(
-        getLayerHash(
-          {
-            ...SAMPLE_LAYER1,
-            extras: {},
-          },
-          true,
-        ),
-      );
-    });
-    it("does not take into account properties order", () => {
-      expect(
-        getLayerHash(
-          {
-            type: "wms",
-            url: "http://abc.org/wms",
-            name: "myLayer",
-            extras: {
-              array: [1, 2, 3],
-              object: {},
-            },
-          },
-          true,
-        ),
-      ).toEqual(
-        getLayerHash(
-          {
-            extras: {
-              array: [1, 2, 3],
-              object: {},
-            },
-            url: "http://abc.org/wms",
-            type: "wms",
-            name: "myLayer",
-          },
-          true,
-        ),
-      );
-    });
-  });
-
   describe("getLayerPosition", () => {
     it("returns the index of the layer in the context", () => {
       const context: MapContext = {
@@ -393,4 +90,78 @@ describe("Map context utils", () => {
       expect(newContext.layers).toEqual([SAMPLE_LAYER2, SAMPLE_LAYER1]);
     });
   });
+
+  describe("updateLayerInContext", () => {
+    it("updates properties of a layer in the context (without id)", () => {
+      const context: MapContext = {
+        ...SAMPLE_CONTEXT,
+        layers: [SAMPLE_LAYER1, SAMPLE_LAYER2],
+      };
+      const newContext = updateLayerInContext(context, SAMPLE_LAYER1, {
+        opacity: 0.8,
+        visibility: false,
+      });
+      expect(newContext.layers).toHaveLength(2);
+      expect(newContext.layers[0]).toEqual({
+        ...SAMPLE_LAYER1,
+        opacity: 0.8,
+        visibility: false,
+      });
+      expect(newContext.layers[1]).toBe(SAMPLE_LAYER2);
+    });
+    it("does not modify the original context", () => {
+      const context: MapContext = {
+        ...SAMPLE_CONTEXT,
+        layers: [SAMPLE_LAYER1, SAMPLE_LAYER2],
+      };
+      const newContext = updateLayerInContext(context, SAMPLE_LAYER1, {
+        opacity: 0.8,
+        visibility: false,
+      });
+      expect(newContext).not.toBe(context);
+      expect(newContext.layers).not.toBe(context.layers);
+    });
+    it("updates properties of a layer with id in the context", () => {
+      const context: MapContext = {
+        ...SAMPLE_CONTEXT,
+        layers: [
+          SAMPLE_LAYER1,
+          SAMPLE_LAYER2,
+          { ...SAMPLE_LAYER3, id: "myLayer", version: 3 },
+        ],
+      };
+      const newContext = updateLayerInContext(
+        context,
+        // this is an empty layer that should not be used because we should track the layer by id in the context
+        {
+          id: "myLayer",
+        } as MapContextLayer,
+        {
+          opacity: 0.8,
+          visibility: false,
+        },
+      );
+      expect(newContext.layers).toHaveLength(3);
+      expect(newContext.layers[2]).toEqual({
+        ...SAMPLE_LAYER3,
+        id: "myLayer",
+        version: 4,
+        opacity: 0.8,
+        visibility: false,
+      });
+      expect(newContext.layers[0]).toBe(SAMPLE_LAYER1);
+      expect(newContext.layers[1]).toBe(SAMPLE_LAYER2);
+    });
+    it("changes the context ref even if the layer is not found (the layers array is untouched)", () => {
+      const context: MapContext = {
+        ...SAMPLE_CONTEXT,
+        layers: [SAMPLE_LAYER1, SAMPLE_LAYER2],
+      };
+      const newContext = updateLayerInContext(context, SAMPLE_LAYER3, {
+        opacity: 0.8,
+      });
+      expect(newContext).not.toBe(context);
+      expect(newContext.layers).toBe(context.layers);
+    });
+  });
 });

package/lib/utils/map-context.ts

@@ -1,36 +1,5 @@
 import { MapContext, MapContextLayer } from "../model/index.js";
-import { getHash } from "./hash.js";
-
-export function getLayerHash(
-  layer: MapContextLayer,
-  includeExtras = false,
-): string {
-  return getHash(layer, includeExtras ? [] : ["extras"]);
-}
-
-export function isLayerSame(
-  layerA: MapContextLayer,
-  layerB: MapContextLayer,
-): boolean {
-  if ("id" in layerA && "id" in layerB) {
-    return layerA.id == layerB.id;
-  }
-  return getLayerHash(layerA) === getLayerHash(layerB);
-}
-
-export function isLayerSameAndUnchanged(
-  layerA: MapContextLayer,
-  layerB: MapContextLayer,
-): boolean {
-  if (
-    "id" in layerA &&
-    "id" in layerB &&
-    ("version" in layerA || "version" in layerB)
-  ) {
-    return layerA.id == layerB.id && layerA.version == layerB.version;
-  }
-  return getLayerHash(layerA, true) === getLayerHash(layerB, true);
-}
+import { isLayerSame, updateLayer } from "./map-context-layer.js";
 
 export function getLayerPosition(
   context: MapContext,
@@ -42,10 +11,10 @@ export function getLayerPosition(
 /**
  * Adds a layer to the context at a specific position or at the end if no position is specified.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be added.
- * @param {number} [position] - The position at which to add the layer. If not specified, the layer is added at the end.
- * @returns {MapContext} - The new map context with the added layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be added.
+ * @param [position] The position at which to add the layer. If not specified, the layer is added at the end.
+ * @returns The new map context with the added layer.
  */
 
 export function addLayerToContext(
@@ -65,9 +34,9 @@ export function addLayerToContext(
 /**
  * Removes a layer from the context.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be removed.
- * @returns {MapContext} - The new map context without the removed layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be removed.
+ * @returns The new map context without the removed layer.
  */
 
 export function removeLayerFromContext(
@@ -85,10 +54,10 @@ export function removeLayerFromContext(
 /**
  * Replaces a layer in the context with a new layer.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer to be replaced.
- * @param {MapContextLayer} replacement - The new layer that will replace the old one.
- * @returns {MapContext} - The new map context with the replaced layer.
+ * @param context The current map context.
+ * @param layerModel The layer to be replaced.
+ * @param replacement The new layer that will replace the old one.
+ * @returns The new map context with the replaced layer.
  */
 
 export function replaceLayerInContext(
@@ -104,13 +73,38 @@ export function replaceLayerInContext(
   return newContext;
 }
 
+/**
+ * Replaces a layer in the context with a new layer.
+ *
+ * @param context The current map context.
+ * @param layerModel The layer to be replaced.
+ * @param layerUpdates The new layer that will replace the old one.
+ * @returns The new map context with the updated layer.
+ */
+
+export function updateLayerInContext(
+  context: MapContext,
+  layerModel: MapContextLayer,
+  layerUpdates: Partial<MapContextLayer>,
+): MapContext {
+  const position = getLayerPosition(context, layerModel);
+  if (position >= 0) {
+    const existing = context.layers[getLayerPosition(context, layerModel)];
+    const updated = updateLayer(existing, layerUpdates);
+    return replaceLayerInContext(context, layerModel, updated);
+  }
+  // we're building a new context so that the reference is changed anyway; this is done to be
+  // consistent with other utilities that always change the context reference even if the layer wasn't found
+  return { ...context };
+}
+
 /**
  * Changes the position of a layer in the context.
  *
- * @param {MapContext} context - The current map context.
- * @param {MapContextLayer} layerModel - The layer whose position is to be changed.
- * @param {number} position - The new position for the layer.
- * @returns {MapContext} - The new map context with the layer moved to the new position.
+ * @param context The current map context.
+ * @param layerModel The layer whose position is to be changed.
+ * @param position The new position for the layer.
+ * @returns The new map context with the layer moved to the new position.
  */
 
 export function changeLayerPositionInContext(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geospatial-sdk/core",
-  "version": "0.0.5-dev.45+a90fe28",
+  "version": "0.0.5-dev.47+37669e8",
   "description": "Core functions and models for the SDK",
   "author": "Olivia <olivia.guyot@camptocamp.com>",
   "homepage": "",
@@ -22,7 +22,7 @@
     "test": "vitest",
     "build": "tsc"
   },
-  "gitHead": "a90fe28ac749e1d35a976bdcfd02cb47357e8955",
+  "gitHead": "37669e815765d751c4795a67e671ae19e3bf5a92",
   "dependencies": {
     "proj4": "^2.9.2"
   },