config(apple): make trackpad usage a configurable option

Previously, we implemented both the USB pointer and trackpad device but it
introduced double-clicking and scrolling issues (#4636, #4645). After
setting the default to trackpad for macOS, it turns out that Monterey guests
do not have the right driver for it and does not work.

Now, we will attempt to detect Monterey on new installs and enable the
trackpad when it is not Monterey (no earlier macOS versions are supported).
Existing VMs will default to trackpad off for compatibility and will require
manual setting to enable it.

Fixes #5237

Configuration/UTMAppleConfigurationVirtualization.swift

@@ -45,6 +45,8 @@ struct UTMAppleConfigurationVirtualization: Codable {
 
     var hasPointer: Bool = false
 
+    var hasTrackpad: Bool = false
+
     var hasRosetta: Bool?
 
     var hasClipboardSharing: Bool = false
@@ -55,6 +57,7 @@ struct UTMAppleConfigurationVirtualization: Codable {
         case hasEntropy = "Entropy"
         case hasKeyboard = "Keyboard"
         case hasPointer = "Pointer"
+        case hasTrackpad = "Trackpad"
         case rosetta = "Rosetta"
         case hasClipboardSharing = "ClipboardSharing"
     }
@@ -70,8 +73,10 @@ struct UTMAppleConfigurationVirtualization: Codable {
         hasKeyboard = try values.decode(Bool.self, forKey: .hasKeyboard)
         if let legacyPointer = try? values.decode(PointerDevice.self, forKey: .hasPointer) {
             hasPointer = legacyPointer != .disabled
+            hasTrackpad = legacyPointer == .trackpad
         } else {
             hasPointer = try values.decode(Bool.self, forKey: .hasPointer)
+            hasTrackpad = try values.decodeIfPresent(Bool.self, forKey: .hasTrackpad) ?? false
         }
         if #available(macOS 13, *) {
             hasRosetta = try values.decodeIfPresent(Bool.self, forKey: .rosetta)
@@ -138,7 +143,7 @@ extension UTMAppleConfigurationVirtualization {
             if hasPointer {
                 vzconfig.pointingDevices = [VZUSBScreenCoordinatePointingDeviceConfiguration()]
                 #if arch(arm64)
-                if #available(macOS 13, *), isMacOSGuest {
+                if #available(macOS 13, *), isMacOSGuest && hasTrackpad {
                     // replace with trackpad device
                     vzconfig.pointingDevices = [VZMacTrackpadConfiguration()]
                 }

Platform/Shared/VMWizardOSMacView.swift

@@ -66,6 +66,7 @@ struct VMWizardOSMacView: View {
             await MainActor.run {
                 wizardState.macPlatform = UTMAppleConfigurationMacPlatform(newHardware: model)
                 wizardState.macRecoveryIpswURL = url
+                wizardState.macIsMonterey = image.buildVersion.hasPrefix("21")
                 wizardState.isSkipBootImage = true
                 wizardState.bootImageURL = nil
                 wizardState.next()

Platform/Shared/VMWizardState.swift

@@ -78,6 +78,7 @@ enum VMWizardOS: String, Identifiable {
     #if os(macOS) && arch(arm64)
     @Published var macPlatform: UTMAppleConfigurationMacPlatform?
     @Published var macRecoveryIpswURL: URL?
+    @Published var macIsMonterey: Bool = false
     #endif
     @Published var isSkipBootImage: Bool = false
     @Published var bootImageURL: URL?
@@ -264,6 +265,7 @@ enum VMWizardOS: String, Identifiable {
                 config.system.boot = try! UTMAppleConfigurationBoot(for: .macOS)
                 config.system.boot.macRecoveryIpswURL = macRecoveryIpswURL
                 config.system.macPlatform = macPlatform
+                config.virtualization.hasTrackpad = !macIsMonterey
             }
             #endif
         case .Linux:
@@ -332,6 +334,7 @@ enum VMWizardOS: String, Identifiable {
                     if let hardwareModel = restoreImage.mostFeaturefulSupportedConfiguration?.hardwareModel {
                         self.macPlatform = UTMAppleConfigurationMacPlatform(newHardware: hardwareModel)
                         self.macRecoveryIpswURL = restoreImage.url
+                        self.macIsMonterey = restoreImage.buildVersion.hasPrefix("21")
                     } else {
                         self.alertMessage = AlertMessage(NSLocalizedString("Failed to get latest macOS version from Apple.", comment: "VMWizardState"))
                     }

Platform/macOS/VMConfigAppleVirtualizationView.swift

@@ -29,6 +29,10 @@ struct VMConfigAppleVirtualizationView: View {
                 Toggle("Enable Keyboard", isOn: $config.hasKeyboard)
                 Toggle("Enable Pointer", isOn: $config.hasPointer)
             }
+            if #available(macOS 13, *), config.hasPointer {
+                Toggle("Use Trackpad", isOn: $config.hasTrackpad)
+                    .help("Allows passing through additional input from trackpads. Only supported on macOS 13+ guests.")
+            }
             if #available(macOS 13, *), operatingSystem == .linux {
                 #if arch(arm64)
                 Toggle("Enable Rosetta on Linux (x86_64 Emulation)", isOn: $config.hasRosetta.bound)