Selection Manager¶

Overview¶

The SelectionManager handles multi-select and attachment selection state for TUI operations. It manages resource selection across different contexts including server, port, router, and subnet selection modes for resource management operations.

Location: Sources/Substation/Framework/SelectionManager.swift

Architecture¶

graph TB
    subgraph SelectionManager["SelectionManager"]
        MS[Multi-Select State]
        SA[Server Attachment]
        FI[Floating IP Selection]
        SR[Subnet-Router Selection]
        RS[Router-Subnet Selection]
    end

    subgraph Views["Views Using Selection"]
        LV[List Views]
        MV[Management Views]
        AV[Attachment Views]
    end

    LV --> MS
    MV --> SA
    MV --> FI
    AV --> SR
    AV --> RS

Class Definition¶

@MainActor
final class SelectionManager {
    // Multi-Select State
    var multiSelectMode: Bool = false
    var multiSelectedResourceIDs: Set<String> = []

    // Server Attachment Selection
    var selectedServers: Set<String> = []
    var attachedServerIds: Set<String> = []
    var attachmentMode: AttachmentMode = .attach

    // Floating IP Management
    var selectedServerId: String?
    var attachedServerId: String?
    var selectedPortId: String?
    var attachedPortId: String?

    // Subnet Router Management
    var selectedRouterId: String?
    var attachedRouterIds: Set<String> = []

    // Router Subnet Management
    var selectedSubnetId: String?
    var attachedSubnetIds: Set<String> = []
}

Selection Types¶

Multi-Select Mode¶

For batch operations on multiple resources in list views.

stateDiagram-v2
    [*] --> SingleSelect
    SingleSelect --> MultiSelect: toggleMultiSelect()
    MultiSelect --> SingleSelect: toggleMultiSelect()

    state MultiSelect {
        [*] --> Empty
        Empty --> HasSelections: toggleSelection(id)
        HasSelections --> Empty: clearMultiSelect()
        HasSelections --> HasSelections: toggleSelection(id)
        HasSelections --> AllSelected: selectAll(ids)
    }

Server Attachment Selection¶

For volume and network attachment operations.

Floating IP Selection¶

For floating IP association to servers and ports.

Subnet-Router Selection¶

For managing router attachments to subnets.

Router-Subnet Selection¶

For managing subnet interfaces on routers.

API Reference¶

Multi-Select Methods¶

/// Toggle multi-select mode on or off
/// When disabled, clears all multi-select selections
func toggleMultiSelect()

/// Clear all multi-select selections without disabling multi-select mode
func clearMultiSelect()

/// Toggle selection of a resource by ID
func toggleSelection(id: String)

/// Check if a resource is currently selected
func isSelected(id: String) -> Bool

/// Select all provided resource IDs
func selectAll(ids: [String])

Clear Methods¶

/// Clear server selection state
/// Resets selectedServers, selectedServerId, and attachedServerId
func clearServerSelection()

/// Clear port selection state
/// Resets selectedPortId and attachedPortId
func clearPortSelection()

/// Clear router selection state
/// Resets selectedRouterId and attachedRouterIds
func clearRouterSelection()

/// Clear subnet selection state
/// Resets selectedSubnetId and attachedSubnetIds
func clearSubnetSelection()

/// Reset all selection state to initial values
func resetAll()

Selection Flow Examples¶

Multi-Select for Batch Delete¶

sequenceDiagram
    participant User
    participant SM as SelectionManager
    participant View as ListView

    User->>SM: toggleMultiSelect()
    SM-->>View: multiSelectMode = true

    User->>SM: toggleSelection("server-1")
    User->>SM: toggleSelection("server-2")
    User->>SM: toggleSelection("server-3")

    User->>View: Delete selected
    View->>SM: multiSelectedResourceIDs
    SM-->>View: {"server-1", "server-2", "server-3"}

    View->>View: Delete servers
    View->>SM: clearMultiSelect()

Floating IP Assignment¶

sequenceDiagram
    participant User
    participant SM as SelectionManager
    participant FIP as FloatingIPView
    participant Server as ServerSelectView

    User->>FIP: Assign to server
    FIP->>SM: Set attachedServerId (if exists)
    FIP->>Server: Navigate to server select

    User->>Server: Select server
    Server->>SM: selectedServerId = "server-123"

    Server->>FIP: Confirm selection
    FIP->>SM: Get selectedServerId
    SM-->>FIP: "server-123"
    FIP->>FIP: Assign floating IP

Volume-Server Attachment¶

sequenceDiagram
    participant User
    participant SM as SelectionManager
    participant Vol as VolumeView
    participant Attach as AttachmentView

    User->>Vol: Attach to server
    Vol->>SM: attachmentMode = .attach
    Vol->>SM: Set attachedServerIds

    Vol->>Attach: Navigate to attachment

    User->>Attach: Select servers
    Attach->>SM: toggleSelection("server-1")
    Attach->>SM: toggleSelection("server-2")

    User->>Attach: Confirm
    Attach->>SM: selectedServers
    SM-->>Attach: Selected server set
    Attach->>Attach: Attach volume

Usage Examples¶

Multi-Select Operations¶

// Enable multi-select mode
selectionManager.toggleMultiSelect()

// Select resources
selectionManager.toggleSelection(id: "server-1")
selectionManager.toggleSelection(id: "server-2")

// Check selection
if selectionManager.isSelected(id: "server-1") {
    print("Server 1 is selected")
}

// Get all selected
let selected = selectionManager.multiSelectedResourceIDs

// Select all
selectionManager.selectAll(ids: allServerIds)

// Clear selections
selectionManager.clearMultiSelect()

// Disable multi-select mode
selectionManager.toggleMultiSelect()

Floating IP Assignment¶

// Store current attachment state
selectionManager.attachedServerId = floatingIP.serverId
selectionManager.attachedPortId = floatingIP.portId

// After user selects new server
selectionManager.selectedServerId = newServerId

// Perform assignment
let targetServer = selectionManager.selectedServerId
await assignFloatingIP(to: targetServer)

// Clear state
selectionManager.clearServerSelection()

Router Interface Management¶

// Store existing attachments
selectionManager.attachedSubnetIds = Set(router.attachedSubnets)

// User selects subnet
selectionManager.selectedSubnetId = "subnet-123"

// Add interface
if let subnetId = selectionManager.selectedSubnetId {
    await addRouterInterface(routerId: router.id, subnetId: subnetId)
}

// Clear state
selectionManager.clearSubnetSelection()

Complete Reset¶

// Reset all selection state when leaving management views
func exitManagementView() {
    selectionManager.resetAll()
    viewCoordinator.changeView(to: previousView)
}

Visual Selection Indicators¶

When rendering list views, use selection state to show visual indicators:

func renderServerRow(_ server: Server, isHighlighted: Bool) {
    let prefix: String
    if selectionManager.multiSelectMode {
        if selectionManager.isSelected(id: server.id) {
            prefix = "[X]"  // Selected
        } else {
            prefix = "[ ]"  // Not selected
        }
    } else {
        prefix = isHighlighted ? ">" : " "
    }
    print("\(prefix) \(server.name)")
}

State Diagram¶

stateDiagram-v2
    [*] --> Initial

    state Initial {
        [*] --> NoSelection
    }

    NoSelection --> MultiSelectActive: toggleMultiSelect()
    MultiSelectActive --> NoSelection: toggleMultiSelect()

    NoSelection --> ServerSelection: Enter server management
    ServerSelection --> NoSelection: clearServerSelection()

    NoSelection --> PortSelection: Enter port management
    PortSelection --> NoSelection: clearPortSelection()

    NoSelection --> RouterSelection: Enter router management
    RouterSelection --> NoSelection: clearRouterSelection()

    NoSelection --> SubnetSelection: Enter subnet management
    SubnetSelection --> NoSelection: clearSubnetSelection()

    state CleanReset {
        ServerSelection --> NoSelection
        PortSelection --> NoSelection
        RouterSelection --> NoSelection
        SubnetSelection --> NoSelection
        MultiSelectActive --> NoSelection
    }

    CleanReset --> NoSelection: resetAll()

Best Practices¶

1. Clear selection state when leaving management views
2. Store attached IDs before entering selection mode for visual indicators
3. Use resetAll() when transitioning to unrelated views
4. Check multiSelectMode before interpreting selection state
5. Use toggleSelection() rather than directly modifying the set

Related Documentation¶

• View System
• Render Coordinator
• Cache Manager