feat: Introduce unified PortRowView component for consistent port display

- Added PortContextMenu for shared context menu actions across port rows.
- Created PortRowComponents for reusable UI elements in port rows.
- Implemented PortRowView to support multiple display styles (table, nested, menu bar).
- Refactored MenuBarPortRow and MenuBarNestedPortRow to utilize PortRowView.
- Updated PortDetailView to use process type colors directly from PortInfo.
- Removed legacy PortListRow and integrated its functionality into PortRowView.

Author: productdevbook

platforms/macos/Sources/AppState+Favorites.swift

@@ -1,12 +1,13 @@
 import Foundation
 
 extension AppState {
-    /// Toggles favorite status for a port.
+    /// Toggles favorite status for a port (delegates to FavoritesState)
     func toggleFavorite(_ port: Int) {
-        if favorites.contains(port) { favorites.remove(port) }
-        else { favorites.insert(port) }
+        favoritesState.toggle(port)
     }
 
-    /// Checks if a port is marked as favorite.
-    func isFavorite(_ port: Int) -> Bool { favorites.contains(port) }
+    /// Checks if a port is marked as favorite (delegates to FavoritesState)
+    func isFavorite(_ port: Int) -> Bool {
+        favoritesState.isFavorite(port)
+    }
 }

platforms/macos/Sources/AppState+WatchedPorts.swift

@@ -1,55 +1,28 @@
 import Foundation
 
 extension AppState {
-    /// Toggles watch status for a port.
+    /// Toggles watch status for a port (delegates to WatchedPortsState)
     func toggleWatch(_ port: Int) {
-        if let idx = watchedPorts.firstIndex(where: { $0.port == port }) {
-            previousPortStates.removeValue(forKey: port)
-            watchedPorts.remove(at: idx)
-        } else {
-            watchedPorts.append(WatchedPort(port: port))
-        }
+        watchedPortsState.toggle(port)
     }
 
-    /// Checks if a port is being watched.
-    func isWatching(_ port: Int) -> Bool { watchedPorts.contains { $0.port == port } }
+    /// Checks if a port is being watched (delegates to WatchedPortsState)
+    func isWatching(_ port: Int) -> Bool {
+        watchedPortsState.isWatching(port)
+    }
 
-    /// Updates notification preferences for a watched port.
+    /// Updates notification preferences for a watched port (delegates to WatchedPortsState)
     func updateWatch(_ port: Int, onStart: Bool, onStop: Bool) {
-        if let idx = watchedPorts.firstIndex(where: { $0.port == port }) {
-            watchedPorts[idx].notifyOnStart = onStart
-            watchedPorts[idx].notifyOnStop = onStop
-        }
+        watchedPortsState.updateWatch(port, onStart: onStart, onStop: onStop)
     }
 
-    /// Removes a watched port by its ID.
+    /// Removes a watched port by its ID (delegates to WatchedPortsState)
     func removeWatch(_ id: UUID) {
-        if let w = watchedPorts.first(where: { $0.id == id }) {
-            previousPortStates.removeValue(forKey: w.port)
-        }
-        watchedPorts.removeAll { $0.id == id }
+        watchedPortsState.removeWatch(id)
     }
 
-    /// Checks watched ports for state changes and triggers notifications.
+    /// Checks watched ports for state changes and triggers notifications
     func checkWatchedPorts() {
-        let activePorts = Set(ports.map { $0.port })
-        for w in watchedPorts {
-            let isActive = activePorts.contains(w.port)
-            if let wasActive = previousPortStates[w.port] {
-                if wasActive && !isActive && w.notifyOnStop {
-                    NotificationService.shared.notify(
-                        title: "Port \(w.port) Available",
-                        body: "Port is now free."
-                    )
-                } else if !wasActive && isActive && w.notifyOnStart {
-                    let name = ports.first { $0.port == w.port }?.processName ?? "Unknown"
-                    NotificationService.shared.notify(
-                        title: "Port \(w.port) In Use",
-                        body: "Used by \(name)."
-                    )
-                }
-            }
-            previousPortStates[w.port] = isActive
-        }
+        watchedPortsState.checkForChanges(ports: ports)
     }
 }

platforms/macos/Sources/AppState.swift

@@ -35,6 +35,14 @@ extension KeyboardShortcuts.Name {
 @Observable
 @MainActor
 final class AppState {
+    // MARK: - Decomposed State Objects
+
+    /// Manages favorite ports (extracted state)
+    let favoritesState: FavoritesState
+
+    /// Manages watched ports (extracted state)
+    let watchedPortsState: WatchedPortsState
+
     // MARK: - Port State
 
     /// All currently scanned ports
@@ -114,30 +122,24 @@ final class AppState {
         return result
     }
 
-    // MARK: - Favorites
-
-    /// Cached favorites set, synced with UserDefaults
-    private var _favorites: Set<Int> = Defaults[.favorites] {
-        didSet { Defaults[.favorites] = _favorites }
-    }
+    // MARK: - Backward Compatibility Accessors
 
-    /// Port numbers marked as favorites by the user
+    /// Port numbers marked as favorites by the user (delegates to FavoritesState)
     var favorites: Set<Int> {
-        get { _favorites }
-        set { _favorites = newValue }
+        get { favoritesState.favorites }
+        set { favoritesState.favorites = newValue }
     }
 
-    // MARK: - Watched Ports
-
-    /// Cached watched ports array, synced with UserDefaults
-    private var _watchedPorts: [WatchedPort] = Defaults[.watchedPorts] {
-        didSet { Defaults[.watchedPorts] = _watchedPorts }
+    /// Ports being watched for state changes (delegates to WatchedPortsState)
+    var watchedPorts: [WatchedPort] {
+        get { watchedPortsState.watchedPorts }
+        set { watchedPortsState.watchedPorts = newValue }
     }
 
-    /// Ports being watched for state changes
-    var watchedPorts: [WatchedPort] {
-        get { _watchedPorts }
-        set { _watchedPorts = newValue }
+    /// Tracks previous port states for watch notifications (delegates to WatchedPortsState)
+    var previousPortStates: [Int: Bool] {
+        get { watchedPortsState.previousPortStates }
+        set { watchedPortsState.previousPortStates = newValue }
     }
 
     // MARK: - Managers
@@ -154,17 +156,22 @@ final class AppState {
     // MARK: - Internal Properties (for extensions)
 
     /// Port scanning actor
-    let scanner = PortScanner()
+    let scanner: PortScannerProtocol
 
     /// Background task for auto-refresh
     @ObservationIgnored var refreshTask: Task<Void, Never>?
 
-    /// Tracks previous port states for watch notifications
-    var previousPortStates: [Int: Bool] = [:]
-
     // MARK: - Initialization
 
-    init() {
+    init(
+        scanner: PortScannerProtocol = PortScanner(),
+        favoritesState: FavoritesState? = nil,
+        watchedPortsState: WatchedPortsState? = nil
+    ) {
+        self.scanner = scanner
+        self.favoritesState = favoritesState ?? FavoritesState()
+        self.watchedPortsState = watchedPortsState ?? WatchedPortsState()
+
         setupKeyboardShortcuts()
         startAutoRefresh()
     }

platforms/macos/Sources/Extensions/ProcessType+Color.swift

@@ -0,0 +1,21 @@
+/**
+ * ProcessType+Color.swift
+ * PortKiller
+ *
+ * Provides color representation for process types in the UI.
+ */
+
+import SwiftUI
+
+extension ProcessType {
+    /// Color associated with this process type for UI display
+    var color: Color {
+        switch self {
+        case .webServer: return .blue
+        case .database: return .purple
+        case .development: return .orange
+        case .system: return .gray
+        case .other: return .secondary
+        }
+    }
+}