Fix overlapping segmentation render issues

[rodrigobasilio2022]

This pull request introduces multi-volume support across multiple modules, refines type definitions for actors, and enhances segmentation handling. Key changes include the addition of multi-volume processing capabilities, updates to type definitions, and improvements to segmentation state management.

Multi-Volume Support Enhancements:

• packages/core/src/utilities/isValidVolume.ts: Updated isValidVolume to handle multi-volume segmentations by splitting image IDs into groups based on the number of images per volume. Added validation logic for each group. [1] [2] [3]
• packages/labelmap-interpolation/src/utilities/interpolateLabelmap.ts: Modified interpolateLabelmap to process multiple segmentation volumes iteratively, updating progress dynamically and handling failures gracefully. [1] [2]
• packages/tools/src/stateManagement/segmentation/SegmentationStateManager.ts: Added support for multi-volume segmentation by splitting image IDs into groups and updating references accordingly. Enhanced helper methods to return arrays of arrays for multi-volume scenarios. [1] [2] [3]

Type Definition Updates:

• packages/core/src/types/IActor.ts: Introduced ViewportActor type to unify various actor types (Actor, VolumeActor, ImageActor, ICanvasActor) and updated ActorEntry to use ViewportActor. [1] [2]
• packages/core/src/types/index.ts: Exported the new ViewportActor type for broader usage across modules. [1] [2]

Segmentation Handling Improvements:

• packages/polymorphic-segmentation/src/Labelmap/convertContourToLabelmap.ts: Added numberOfImages property to segmentation-related return objects for better multi-volume handling. [1] [2]
• packages/tools/src/eventListeners/segmentation/labelmap/performVolumeLabelmapUpdate.ts: Refactored performVolumeLabelmapUpdate to use getPrimaryVolumeId for improved segmentation volume retrieval. [1] [2]

[Copilot]

Pull Request Overview

This PR expands segmentation modules to fully support multi-volume data, updates type definitions to unify actor handling, and refines error handling and progress reporting in segmentation operations.

• Introduce volumeIds, getVolumeIds, and getPrimaryVolumeId utilities for multi-volume support
• Refactor core segmentation utilities and state manager to iterate over multiple volumes
• Update type definitions in LabelmapTypes and IActor to unify single- and multi-volume actors

Reviewed Changes

Copilot reviewed 36 out of 36 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
packages/core/src/types/LabelmapTypes.ts	Updated segmentation data types, introduced volumeIds
packages/tools/src/utilities/segmentation/validateLabelmap.ts	Enhanced validation for multi-volume & stack inputs
packages/tools/src/utilities/segmentation/getSegmentIndexAtWorldPoint.ts	Iterates over volumeIds for world‐point lookup
packages/tools/src/utilities/segmentation/getSegmentIndexAtLabelmapBorder.ts	Iterates over volumeIds for border‐point lookup
packages/tools/src/tools/displayTools/Labelmap/addLabelmapToElement.ts	Refactored to handle multiple volume inputs

Comments suppressed due to low confidence (1)

packages/tools/src/tools/displayTools/Labelmap/addLabelmapToElement.ts:178

• [nitpick] The function name is missing a capital 'L' in 'LabelMap' for readability and consistency (_ensureLabelMapDataVolumeHasVolumeId). Consider renaming to follow camel-case conventions.

function _ensurelabelMapDataVolumeHasVolumeId(