spiegel-keyman/mac/KeymanSettings/Sources/Model/Keyboard.swift

/*
 * Keyman is copyright (C) SIL Global. MIT License.
 *
 * Created by Shawn Schantz on 2026-02-24
 *
 * Wrapper object that represents a Keyman keyboard as loaded from a .KMP file
 * Mostly immutable, but can be marked as enabled/disabled
 *
 */


import Foundation
import AppKit

public class Keyboard: Identifiable, Hashable, Equatable {
  
  public var id = UUID()
  public var enabled: Bool
  public var name: String
  public var keyboardId: String
  // the directory we are reading the keyboard from
  public var keyboardDirectoryUrl: URL
  // the URL of the .kmx file for the package
  public let kmxFileUrl: URL
  // a key to uniquely identify the keyboard
  // in the UserDefaults this key is used for the selected Keyboard and enabled keyboards properties
  // the key is in the form "/[package directory]/[package name].kmx"
  // for example, "/khmer_angkor/khmer_angkor.kmx"
  public let keyboardKey: String

  public init(keyboardSource: KeyboardSource, directoryUrl: URL) {
    self.enabled = true
    self.name = keyboardSource.name
    self.keyboardId = keyboardSource.id
    self.keyboardDirectoryUrl = directoryUrl
    self.kmxFileUrl = Keyboard.deriveKmxFileUrl(from: self.keyboardDirectoryUrl, keyboardId: self.keyboardId)
    self.keyboardKey = Keyboard.deriveKeyboardSettingsKey(from: self.keyboardDirectoryUrl, keyboardId: self.keyboardId)

    print("keyboard created for: \(keyboardSource.id) \r   with kmxFileUrl: \(self.kmxFileUrl) \r   and settingsKey: \(self.keyboardKey)")
  }

  /**
   * initializer that does not rely on package source -- provided to create unit test data
   */
  public init(name: String, keyboardId: String, keyboardDirectoryUrl: URL, enabled: Bool) {
    self.name = name
    self.keyboardId = keyboardId
    self.keyboardDirectoryUrl = keyboardDirectoryUrl
    self.kmxFileUrl = Keyboard.deriveKmxFileUrl(from: self.keyboardDirectoryUrl, keyboardId: self.keyboardId)
    self.enabled = enabled
    self.keyboardKey = Keyboard.deriveKeyboardSettingsKey(from: self.keyboardDirectoryUrl, keyboardId: self.keyboardId)
  }
  
  public static func == (lhs: Keyboard, rhs: Keyboard) -> Bool {
    return lhs.keyboardId == rhs.keyboardId && lhs.enabled == rhs.enabled
  }

  public func hash(into hasher: inout Hasher) {
      hasher.combine(keyboardId)
  }

  static func deriveKmxFileUrl(from keyboardDirectory: URL, keyboardId: String) -> URL {
    return keyboardDirectory.appendingPathComponent("\(keyboardId).kmx")
  }
  
  static func deriveKeyboardSettingsKey(from keyboardDirectory: URL, keyboardId: String) -> String {
    // get parent directory
    let parentDirectoryName = keyboardDirectory.lastPathComponent

    // get filename from keyboardId
    let kmxFilename = "\(keyboardId).kmx"

    let settingsKey = "/\(parentDirectoryName)/\(kmxFilename)"
    print("settingsKey: \(settingsKey)")

    return settingsKey
  }
  
// TODO: "throw/handle error if no kmx file found in directory
  public func validateKmxFile() -> Bool {
    let fileManager = FileManager.default
    if fileManager.fileExists(atPath: self.kmxFileUrl.path) {
      return true
    } else {
      print("   *** Error: could not find kmx file \(self.kmxFileUrl.path)")
      return false
    }
  }
  
  public func findKmxFile(in keyboardDirectoryUrl: URL) -> URL? {
    var kmxFileUrl: URL? = nil
    let fileManager = FileManager.default
    
    do {
      let fileURLs = try fileManager.contentsOfDirectory(at: keyboardDirectoryUrl, includingPropertiesForKeys: nil)
      let filteredFiles = fileURLs.filter { $0.pathExtension == "kmx" }
      
      if (!filteredFiles.isEmpty) {
        kmxFileUrl = filteredFiles.first!
      }
    } catch {
      print("Error reading directory: \(error)")
    }
    
    return kmxFileUrl;
  }


}