@geospatial-sdk/core 0.0.5-dev.46 → 0.0.5-dev.48

package/dist/model/map-context-diff.d.ts

@@ -15,6 +15,14 @@ export interface MapContextLayerReordered {
     newPosition: number;
     previousPosition: number;
 }
+/**
+ * Describes a layer that was changed: both states before and after change are included
+ */
+export interface MapContextLayerChanged {
+    layer: MapContextLayer;
+    previousLayer: MapContextLayer;
+    position: number;
+}
 /**
  * Describes a delta between two contexts, in order to be
  * applied to an existing map.
@@ -26,7 +34,7 @@ export interface MapContextLayerReordered {
  * 4. change layers
  */
 export interface MapContextDiff {
-    layersChanged: MapContextLayerPositioned[];
+    layersChanged: MapContextLayerChanged[];
     layersReordered: MapContextLayerReordered[];
     layersRemoved: MapContextLayerPositioned[];
     layersAdded: MapContextLayerPositioned[];

package/dist/model/map-context-diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-context-diff.d.ts","sourceRoot":"","sources":["../../lib/model/map-context-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,yBAAyB,EAAE,CAAC;IAC3C,eAAe,EAAE,wBAAwB,EAAE,CAAC;IAC5C,aAAa,EAAE,yBAAyB,EAAE,CAAC;IAC3C,WAAW,EAAE,yBAAyB,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACrC"}
+{"version":3,"file":"map-context-diff.d.ts","sourceRoot":"","sources":["../../lib/model/map-context-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa,EAAE,eAAe,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACxC,eAAe,EAAE,wBAAwB,EAAE,CAAC;IAC5C,aAAa,EAAE,yBAAyB,EAAE,CAAC;IAC3C,WAAW,EAAE,yBAAyB,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACrC"}

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-context-diff.d.ts","sourceRoot":"","sources":["../../lib/utils/map-context-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EAIf,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,UAAU,EACvB,eAAe,EAAE,UAAU,GAC1B,cAAc,CA0EhB"}
+{"version":3,"file":"map-context-diff.d.ts","sourceRoot":"","sources":["../../lib/utils/map-context-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EAKf,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,UAAU,EACvB,eAAe,EAAE,UAAU,GAC1B,cAAc,CA0EhB"}

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.
@@ -50,7 +50,7 @@ export function computeMapContextDiff(nextContext, previousContext) {
         else {
             const prevLayer = previousContext.layers[prevPosition];
             if (!isLayerSameAndUnchanged(layer, prevLayer)) {
-                layersChanged.push({ layer, position: i });
+                layersChanged.push({ layer, previousLayer: prevLayer, position: i });
             }
         }
     }

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,CAqBjB"}

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

@@ -0,0 +1,44 @@
+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,
+    };
+    const versionExplicitlyUpdated = "version" in updates && updates.version !== undefined;
+    if ("id" in updatedLayer &&
+        "version" in updatedLayer &&
+        typeof updatedLayer.version === "number" &&
+        !versionExplicitlyUpdated) {
+        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,50 @@
 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;
+/**
+ * Updates an existing layer in the context by applying partial changes.
+ *
+ * Note: setting a property to `undefined` in the partial layer updates will remove that
+ * property from the existing layer.
+ *
+ * @param context The current map context.
+ * @param layerModel The layer to be updated.
+ * @param layerUpdates A partial layer object containing the properties to update on the existing layer.
+ * @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;;;;;;;;;;GAUG;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,35 @@ export function replaceLayerInContext(context, layerModel, replacement) {
     }
     return newContext;
 }
+/**
+ * Updates an existing layer in the context by applying partial changes.
+ *
+ * Note: setting a property to `undefined` in the partial layer updates will remove that
+ * property from the existing layer.
+ *
+ * @param context The current map context.
+ * @param layerModel The layer to be updated.
+ * @param layerUpdates A partial layer object containing the properties to update on the existing layer.
+ * @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[position];
+        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/model/map-context-diff.ts

@@ -18,6 +18,15 @@ export interface MapContextLayerReordered {
   previousPosition: number;
 }
 
+/**
+ * Describes a layer that was changed: both states before and after change are included
+ */
+export interface MapContextLayerChanged {
+  layer: MapContextLayer;
+  previousLayer: MapContextLayer;
+  position: number;
+}
+
 /**
  * Describes a delta between two contexts, in order to be
  * applied to an existing map.
@@ -29,7 +38,7 @@ export interface MapContextLayerReordered {
  * 4. change layers
  */
 export interface MapContextDiff {
-  layersChanged: MapContextLayerPositioned[];
+  layersChanged: MapContextLayerChanged[];
   layersReordered: MapContextLayerReordered[];
   layersRemoved: MapContextLayerPositioned[];
   layersAdded: MapContextLayerPositioned[];

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.test.ts

@@ -121,10 +121,12 @@ describe("Context diff utils", () => {
           layersChanged: [
             {
               layer: contextNew.layers[0],
+              previousLayer: contextOld.layers[0],
               position: 0,
             },
             {
               layer: contextNew.layers[1],
+              previousLayer: contextOld.layers[1],
               position: 1,
             },
           ],
@@ -356,6 +358,7 @@ describe("Context diff utils", () => {
           layersChanged: [
             {
               layer: changedLayer,
+              previousLayer: SAMPLE_LAYER3,
               position: 1,
             },
           ],

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

@@ -2,10 +2,11 @@ import {
   MapContext,
   MapContextDiff,
   MapContextLayer,
+  MapContextLayerChanged,
   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
@@ -42,7 +43,7 @@ export function computeMapContextDiff(
     return -1;
   }
 
-  const layersChanged: MapContextLayerPositioned[] = [];
+  const layersChanged: MapContextLayerChanged[] = [];
   const layersReordered: MapContextLayerReordered[] = [];
   const layersRemoved: MapContextLayerPositioned[] = [];
   const layersAdded: MapContextLayerPositioned[] = [];
@@ -66,7 +67,7 @@ export function computeMapContextDiff(
     } else {
       const prevLayer = previousContext.layers[prevPosition];
       if (!isLayerSameAndUnchanged(layer, prevLayer)) {
-        layersChanged.push({ layer, position: i });
+        layersChanged.push({ layer, previousLayer: prevLayer, position: i });
       }
     }
   }