fix(segmentation): restrict overlay segmentation menu to same frame of reference as viewport background display set (#5900)

- Add FrameOfReferenceUID to SEG and RTSTRUCT displaySet in SOP Class Handlers so the FOR is available for filtering
- Sync optimisticOverlayDisplaySets when background display set changes so the overlay menu reflects the correct state after a background switch
- Add FOR matching guard to the hydrate segmentation synchronizer to prevent the hydration synchronizer from blindly mirroring segmentations from a source viewport to a target viewport if their primary Frames of Reference do not align.
- fix segmentation overlay order reversal on viewport re-render

extensions/cornerstone-dicom-sr/src/getSopClassHandlerModule.ts

@@ -230,7 +230,7 @@ async function _load(
 
 function _measurementBelongsToDisplaySet({ measurement, displaySet }) {
   return (
-    measurement.coords[0].ReferencedFrameOfReferenceSequence === displaySet.FrameOfReferenceUID
+    measurement.coords[0].ReferencedFrameOfReferenceSequence === displaySet.frameOfReferenceUID
   );
 }
 

extensions/cornerstone-dicom-sr/src/utils/hydrateStructuredReport.ts

@@ -145,7 +145,7 @@ export default function hydrateStructuredReport(
 
   for (const FrameOfReferenceUID of frameOfReferenceUIDs) {
     const displaySetsFOR = displaySetService.getDisplaySetsBy(
-      ds => ds.FrameOfReferenceUID === FrameOfReferenceUID && !ds.isDerivedDisplaySet
+      ds => ds.frameOfReferenceUID === FrameOfReferenceUID && !ds.isDerivedDisplaySet
     );
     const ds = chooseDisplaySet(displaySetsFOR, FrameOfReferenceUID);
     if (!ds) {
@@ -335,7 +335,7 @@ function getReferenceData3D(toolData, servicesManager: Types.ServicesManager) {
   const { points } = toolData.annotation.data.handles;
   const { displaySetService } = servicesManager.services;
   const displaySetsFOR = displaySetService.getDisplaySetsBy(
-    ds => ds.FrameOfReferenceUID === FrameOfReferenceUID
+    ds => ds.frameOfReferenceUID === FrameOfReferenceUID
   );
   if (!displaySetsFOR.length || !points?.length) {
     return {