feat(mac): drag and drop to install a Keyman package🍎

mac/Config/Config/ConfigDebugView.swift

@@ -12,6 +12,12 @@ import KeymanSettings
 struct ConfigDebugView: View {
   @EnvironmentObject var settings: SettingsContainer
   @State private var isShowingSheet = false
+
+  // for drag and drop package installation
+  @State private var dropError: DropKmpError?
+  @State private var isShowingDropKmpAlert = false
+  @State private var alertMessage = ""
+  @State private var isHovering = false
 
   var body: some View {
     VStack {
@@ -41,7 +47,48 @@ struct ConfigDebugView: View {
           .frame(width: 700, height: 500)
       }
 
-
+      VStack {
+        Text("Drag a single .kmp archive here")
+          .font(.system(.body, design: .monospaced))
+          .multilineTextAlignment(.center)
+          .padding()
+          .frame(width: 350, height: 180)
+          .background(Color(NSColor.controlBackgroundColor))
+          .cornerRadius(10)
+          .overlay(
+            RoundedRectangle(cornerRadius: 10)
+              .stroke(isHovering ? Color.accentColor : Color.gray, lineWidth: 2)
+          )
+        // Accept URL drops
+          .dropDestination(for: URL.self) { urls, _ in
+            // reject drop if it is more than one file
+            guard let droppedFileUrl = urls.first, urls.count == 1 else {
+              let error = DropKmpError.tooManyFiles
+              self.alertMessage = error.localizedDescription
+              self.isShowingDropKmpAlert = true
+              return false // the drop failed
+            }
+            do {
+              try settings.processDroppedKmpFile(at: droppedFileUrl)
+              return true // the drop was successful
+            } catch {
+              self.alertMessage = error.localizedDescription
+              self.isShowingDropKmpAlert = true
+              return false
+
+            }
+          } isTargeted: { hovering in
+            isHovering = hovering
+          }
+      }
+      .padding()
+      // alert triggers automatically when $dropError becomes non-nil
+      .alert("Package Installation Failed", isPresented: $isShowingDropKmpAlert) {
+          Button("OK", role: .cancel) { }
+      } message: {
+          Text(alertMessage)
+      }
+
       ScrollView {
         VStack(alignment: .leading, spacing: 6) {
           ForEach(Array(settings.singleKeyboardPackages.enumerated()), id: \.offset) { index, package in

mac/Config/Config/KeyboardSearchView.swift

@@ -148,14 +148,17 @@ struct KeyboardSearchView: NSViewRepresentable {
       if let downloadFileUrl {
         print("Download of \(downloadFileUrl.path()) was successful.")
         if let settings {
-          settings.packageDownloadComplete(kmpFileUrl: downloadFileUrl)
+          do {
+            try settings.packageDownloadComplete(kmpFileUrl: downloadFileUrl)
+          } catch {
+            // MAC-CONFIG-TODO: communicate failed install to user
+          }
         }
       }
     }
-
-    // MAC-CONFIG-TODO: remove package if it already exists
 
     func download(_ download: WKDownload, didFailWithError error: Error, resumeData: Data?) {
+      // MAC-CONFIG-TODO: communicate failed install to user
       print("Download failed with error: \(error.localizedDescription)")
     }
 

mac/Config/Config/MainConfigView.swift

@@ -21,6 +21,12 @@ struct MainConfigView: View {
   @State private var selectedTab = 0
   @State private var packageSelectedForHelpUrl: URL? = nil
 
+  // for drag and drop package installation
+  @State private var dropError: DropKmpError?
+  @State private var isShowingDropKmpAlert = false
+  @State private var alertMessage = ""
+  @State private var isHovering = false
+
   /**
    * Assigns packageSelectedForHelpUrl the url argument and changes the selected tab to the help tab
    */
@@ -58,7 +64,37 @@ struct MainConfigView: View {
             showHelpTab(for: url) })
         }
         .formStyle(.grouped)
-
+        // highlight border with accent color when hovering over view
+        .overlay(RoundedRectangle(cornerRadius: 10).stroke(Color.accentColor, lineWidth: 2).opacity(isHovering ? 1 : 0))
+        .animation(.easeInOut(duration: 0.2), value: isHovering)
+        // accepts URL drops
+        .dropDestination(for: URL.self) { urls, _ in
+          // reject drop if it is more than one file
+          guard let droppedFileUrl = urls.first, urls.count == 1 else {
+            let error = DropKmpError.tooManyFiles
+            self.alertMessage = error.localizedDescription
+            self.isShowingDropKmpAlert = true
+            return false // the drop failed
+          }
+          do {
+            try settings.processDroppedKmpFile(at: droppedFileUrl)
+            return true // the drop was successful
+          } catch {
+            self.alertMessage = error.localizedDescription
+            self.isShowingDropKmpAlert = true
+            return false
+
+          }
+        } isTargeted: { hovering in
+          isHovering = hovering
+        }
+        // alert triggers automatically when $dropError becomes non-nil
+        .alert("Package Installation Failed", isPresented: $isShowingDropKmpAlert) {
+            Button("OK", role: .cancel) { }
+        } message: {
+            Text(alertMessage)
+        }
+
         // the Spacer pushes the contents of the VStack to the top of the VStack
         Spacer()
       }

mac/Config/Config/PackageRowView.swift

@@ -62,7 +62,7 @@ public struct PackageRowView: View {
               // if the package contains one keyboard, show the keyboard name, otherwise show the package name
               Text(isSingleKeyboardPackage ? keyboard.name: package.packageName)
                 .font(.title)
-              
+
               // see keyboard help button
               if let url = package.helpFileUrl {
                 IconButtonView(
@@ -84,8 +84,6 @@ public struct PackageRowView: View {
                   .toggleStyle(.switch)
                   .gridColumnAlignment(.leading)
               }
-
-
             }
 
             // if the package contains multiple keyboards shows an HStack with the keyboard name and toggle button for each keyboard in the package
@@ -124,6 +122,8 @@ public struct PackageRowView: View {
         }
       }
     }
+    // animate changes in the package list
+    .animation(.easeInOut, value: packages)
     // binds the visibilty state to the alert builder
     .alert("Are you sure you want to delete the keyboard \"\(selectedPackage?.packageName ?? "")\"?",
            isPresented: $isShowingDeleteAlert,

mac/Config/Installation/InputMethodUtil.swift

@@ -246,7 +246,7 @@ public class InputMethodUtil {
 
     NSWorkspace.shared.openApplication(at: inputMethodUrl, configuration: openConfig) { (app, error) in
       if let error = error {
-        print("Could not launch Keyman input method: \(error.localizedDescription)")
+        print("Could not launch Keyman input method at \(inputMethodUrl), due to error: \(error.localizedDescription), code: \(error._code)")
       }
     }
   }

mac/KeymanSettings/Sources/KeymanSettings/PackageRepo.swift

@@ -19,6 +19,6 @@ public protocol PackageRepo {
   func loadSinglePackage(packageUrl: URL) throws -> KeymanPackage
   func getDownloadUrl(for kmpFilename: String) -> URL
   func getUnzipDestinationUrl(for packageName: String) -> URL
-  func getInstallationUrlForPackageName(packageName: String) -> URL
+  func buildInstallationUrlForPackageName(packageName: String) -> URL
   func cleanupTempDirectory()
 }