feat(imageIdSpecificStateManager): add replace imageIdToolState fun…

…ctions

There is currently no function to consume the same output from getImageIdToolState, which is the
state of a specific tool for the given imageId. addElementToolState requires a single item input,
and without replace, requires both a clear step and an iteration over all items to add into the
tool's id-specific state.

src/stateManagement/imageIdSpecificStateManager.js

@@ -94,6 +94,27 @@ function newImageIdSpecificToolStateManager() {
     return imageIdToolState[toolName];
   }
 
+  function replaceElementToolState(element, toolName, data) {
+    const enabledElement = external.cornerstone.getEnabledElement(element);
+
+    if (!enabledElement.image) {
+      return;
+    }
+    replaceImageIdToolState(enabledElement.image.imageId, toolName, data);
+  }
+
+  function replaceImageIdToolState(imageId, toolName, data) {
+    // If we don't have any tool state for this imageId, add an empty object
+    if (toolState.hasOwnProperty(imageId) === false) {
+      toolState[imageId] = {};
+    }
+
+    const imageIdToolState = toolState[imageId];
+
+    // Finally, add this new tool to the state
+    imageIdToolState[toolName] = data;
+  }
+
   // Clears all tool data from this toolStateManager.
   function clearElementToolState(element) {
     const enabledElement = external.cornerstone.getEnabledElement(element);
@@ -115,9 +136,12 @@ function newImageIdSpecificToolStateManager() {
   return {
     get: getElementToolState,
     add: addElementToolState,
+    replace: replaceImageIdToolState,
     clear: clearElementToolState,
     getImageIdToolState,
     addImageIdToolState,
+    replaceElementToolState,
+    replaceImageIdToolState,
     clearImageIdToolState,
     saveImageIdToolState,
     restoreImageIdToolState,