Fix contour annotations RTSS saving (#5545)

* [WIP] Fix contour annotations RTSS saving

* fix: Export image sop image reference provider

* Fixes for download with filename

* Updates to fix metadata issues with CS3D

* Updates to save menu

* Fixing some additional re-save metadata

* Add support for saving with predecessor image sequence

* PR comment fixes

* fix: Load RTSS after save

* fix segmentation save

* fix load of mixed seg/rt studies

* Use frame module to get information on the frame shown

* Fix study browser to use instances.length when numImageFrames not present

* fix: Load of display set split from multiple non-FOR referenes

* Fix RT and SEG applying to wrong series because of using
referenced series sequence without checkout sop instances

* Fix save seg

* Update to released CS3D versions

* test: Add revokeObjectURL to test download blob

* Add hard dependency on mode-basic to fix build order issues

* fix: build

* Try to fix build segmentation

* PR comments

* PR comment update

platform/docs/versioned_docs/version-3.11/platform/extensions/modules/sop-class-handler.md

@@ -39,6 +39,31 @@ return {
 }
 ```
 
+## Replacing Instances in Series
+
+Series such as segmentations and annotations often have the concept of replacing
+an earlier instance with a newer one.  The official way to do this is using the
+`predecessor document sequence` to reference the old object in the new one.
+It isn't that the old one is deleted (never delete data), but rather that the new
+one is used in preference to the old one.  This results in code that looks like:
+
+```
+  utils.sortStudyInstances(instances);
+  // Choose the LAST instance in the list as the most recently created one.
+  const instance = instances[instances.length - 1];
+
+  ...
+  const displaySet = {
+    ...
+    predecessorImageId: instance.imageId,
+    numImageFrames: instances.length,
+  }
+```
+
+so that the last/latest SOP instance is used by default, and that it is
+recorded what imageId was used to load that instance.  This then allows saving
+new instances in the same series by using a new predecessor sequence.
+
 ## Example SOP Class Handler Module
 
 ```js