@lattices/cli 0.4.2 → 0.4.5

package/app/Sources/MouseGestureConfig.swift

@@ -0,0 +1,364 @@
+import AppKit
+import Foundation
+
+enum MouseGestureDirection: String, CaseIterable, Codable, Equatable {
+    case left
+    case right
+    case up
+    case down
+}
+
+enum MouseShortcutTriggerKind: String, Codable, Equatable {
+    case drag
+}
+
+enum MouseShortcutActionType: String, Codable, Equatable {
+    case spaceNext = "space.next"
+    case spacePrevious = "space.previous"
+    case screenMapToggle = "screenmap.toggle"
+    case dictationStart = "dictation.start"
+    case shortcutSend = "shortcut.send"
+}
+
+enum MouseShortcutModifier: String, CaseIterable, Codable, Equatable {
+    case command
+    case control
+    case option
+    case shift
+
+    var appleScriptToken: String {
+        switch self {
+        case .command: return "command down"
+        case .control: return "control down"
+        case .option: return "option down"
+        case .shift: return "shift down"
+        }
+    }
+
+    var displayLabel: String {
+        switch self {
+        case .command: return "Cmd"
+        case .control: return "Ctrl"
+        case .option: return "Option"
+        case .shift: return "Shift"
+        }
+    }
+}
+
+enum MouseShortcutButton: Hashable, Codable, Equatable {
+    case middle
+    case button4
+    case button5
+    case number(Int)
+
+    init(rawButtonNumber: Int) {
+        switch rawButtonNumber {
+        case 2: self = .middle
+        case 3: self = .button4
+        case 4: self = .button5
+        default: self = .number(rawButtonNumber)
+        }
+    }
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        if let intValue = try? container.decode(Int.self) {
+            self = MouseShortcutButton(rawButtonNumber: intValue)
+            return
+        }
+
+        let stringValue = try container.decode(String.self)
+        switch stringValue.lowercased() {
+        case "middle", "button.middle":
+            self = .middle
+        case "button4", "button.button4":
+            self = .button4
+        case "button5", "button.button5":
+            self = .button5
+        default:
+            if let raw = Int(stringValue.filter(\.isNumber)) {
+                self = MouseShortcutButton(rawButtonNumber: raw)
+            } else {
+                throw DecodingError.dataCorruptedError(in: container, debugDescription: "Unsupported mouse button '\(stringValue)'")
+            }
+        }
+    }
+
+    func encode(to encoder: Encoder) throws {
+        var container = encoder.singleValueContainer()
+        try container.encode(configValue)
+    }
+
+    var rawButtonNumber: Int {
+        switch self {
+        case .middle: return 2
+        case .button4: return 3
+        case .button5: return 4
+        case .number(let value): return value
+        }
+    }
+
+    var configValue: String {
+        switch self {
+        case .middle: return "middle"
+        case .button4: return "button4"
+        case .button5: return "button5"
+        case .number(let value): return "button\(value)"
+        }
+    }
+
+    var displayLabel: String {
+        switch self {
+        case .middle: return "Middle Click"
+        case .button4: return "Button 4"
+        case .button5: return "Button 5"
+        case .number(let value): return "Button \(value)"
+        }
+    }
+
+    var triggerToken: String {
+        switch self {
+        case .middle: return "button.middle"
+        case .button4: return "button.button4"
+        case .button5: return "button.button5"
+        case .number(let value): return "button.\(value)"
+        }
+    }
+}
+
+struct MouseShortcutDeviceSelector: Codable, Equatable {
+    private enum CodingKeys: String, CodingKey {
+        case match
+        case vendorId
+        case productId
+        case locationId
+        case product
+        case manufacturer
+        case transport
+    }
+
+    var match: String?
+    var vendorId: Int?
+    var productId: Int?
+    var locationId: Int?
+    var product: String?
+    var manufacturer: String?
+    var transport: String?
+
+    static let any = MouseShortcutDeviceSelector(match: "any")
+
+    init(
+        match: String? = "any",
+        vendorId: Int? = nil,
+        productId: Int? = nil,
+        locationId: Int? = nil,
+        product: String? = nil,
+        manufacturer: String? = nil,
+        transport: String? = nil
+    ) {
+        self.match = match
+        self.vendorId = vendorId
+        self.productId = productId
+        self.locationId = locationId
+        self.product = product
+        self.manufacturer = manufacturer
+        self.transport = transport
+    }
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        if let stringValue = try? container.decode(String.self) {
+            self = MouseShortcutDeviceSelector(match: stringValue)
+            return
+        }
+
+        let object = try decoder.container(keyedBy: CodingKeys.self)
+        match = try object.decodeIfPresent(String.self, forKey: .match)
+        vendorId = try object.decodeIfPresent(Int.self, forKey: .vendorId)
+        productId = try object.decodeIfPresent(Int.self, forKey: .productId)
+        locationId = try object.decodeIfPresent(Int.self, forKey: .locationId)
+        product = try object.decodeIfPresent(String.self, forKey: .product)
+        manufacturer = try object.decodeIfPresent(String.self, forKey: .manufacturer)
+        transport = try object.decodeIfPresent(String.self, forKey: .transport)
+    }
+
+    func encode(to encoder: Encoder) throws {
+        if isAny {
+            var container = encoder.singleValueContainer()
+            try container.encode("any")
+            return
+        }
+
+        var container = encoder.container(keyedBy: CodingKeys.self)
+        try container.encodeIfPresent(match, forKey: .match)
+        try container.encodeIfPresent(vendorId, forKey: .vendorId)
+        try container.encodeIfPresent(productId, forKey: .productId)
+        try container.encodeIfPresent(locationId, forKey: .locationId)
+        try container.encodeIfPresent(product, forKey: .product)
+        try container.encodeIfPresent(manufacturer, forKey: .manufacturer)
+        try container.encodeIfPresent(transport, forKey: .transport)
+    }
+
+    var isAny: Bool {
+        let normalized = (match ?? "any").lowercased()
+        return normalized == "any"
+            && vendorId == nil
+            && productId == nil
+            && locationId == nil
+            && product == nil
+            && manufacturer == nil
+            && transport == nil
+    }
+
+    func matches(_ device: MouseInputDeviceInfo?) -> Bool {
+        if isAny { return true }
+        guard let device else { return false }
+        if let vendorId, vendorId != device.vendorId { return false }
+        if let productId, productId != device.productId { return false }
+        if let locationId, locationId != device.locationId { return false }
+        if let product, device.product?.localizedCaseInsensitiveContains(product) != true { return false }
+        if let manufacturer, device.manufacturer?.localizedCaseInsensitiveContains(manufacturer) != true { return false }
+        if let transport, device.transport?.localizedCaseInsensitiveContains(transport) != true { return false }
+        return true
+    }
+}
+
+struct MouseShortcutTrigger: Codable, Equatable {
+    var button: MouseShortcutButton
+    var kind: MouseShortcutTriggerKind
+    var direction: MouseGestureDirection
+
+    var triggerName: String {
+        "\(button.triggerToken).\(kind.rawValue).\(direction.rawValue)"
+    }
+}
+
+struct MouseShortcutKeyStroke: Codable, Equatable {
+    var key: String?
+    var keyCode: Int?
+    var modifiers: [MouseShortcutModifier]
+
+    var displayLabel: String {
+        let keyLabel = key?.uppercased() ?? "KeyCode \(keyCode ?? -1)"
+        let parts = modifiers.map(\.displayLabel) + [keyLabel]
+        return parts.joined(separator: "+")
+    }
+}
+
+struct MouseShortcutActionDefinition: Codable, Equatable {
+    var type: MouseShortcutActionType
+    var shortcut: MouseShortcutKeyStroke?
+
+    var label: String {
+        switch type {
+        case .spaceNext:
+            return "Next Space"
+        case .spacePrevious:
+            return "Previous Space"
+        case .screenMapToggle:
+            return "Screen Map Overview"
+        case .dictationStart:
+            return "Dictation"
+        case .shortcutSend:
+            return shortcut?.displayLabel ?? "Send Shortcut"
+        }
+    }
+}
+
+struct MouseShortcutRule: Codable, Equatable, Identifiable {
+    var id: String
+    var enabled: Bool
+    var device: MouseShortcutDeviceSelector
+    var trigger: MouseShortcutTrigger
+    var action: MouseShortcutActionDefinition
+
+    var summary: String {
+        "\(trigger.triggerName) -> \(action.type.rawValue)"
+    }
+}
+
+struct MouseShortcutTuning: Codable, Equatable {
+    var dragThreshold: CGFloat
+    var holdTolerance: CGFloat
+    var axisBias: CGFloat
+
+    static let defaults = MouseShortcutTuning(
+        dragThreshold: 68,
+        holdTolerance: 10,
+        axisBias: 1.2
+    )
+}
+
+struct MouseShortcutConfig: Codable, Equatable {
+    var version: Int
+    var tuning: MouseShortcutTuning
+    var rules: [MouseShortcutRule]
+
+    static let defaults = MouseShortcutConfig(
+        version: 1,
+        tuning: .defaults,
+        rules: [
+            MouseShortcutRule(
+                id: "space-previous",
+                enabled: true,
+                device: .any,
+                trigger: MouseShortcutTrigger(button: .middle, kind: .drag, direction: .left),
+                action: MouseShortcutActionDefinition(type: .spacePrevious, shortcut: nil)
+            ),
+            MouseShortcutRule(
+                id: "space-next",
+                enabled: true,
+                device: .any,
+                trigger: MouseShortcutTrigger(button: .middle, kind: .drag, direction: .right),
+                action: MouseShortcutActionDefinition(type: .spaceNext, shortcut: nil)
+            ),
+            MouseShortcutRule(
+                id: "screenmap-overview",
+                enabled: true,
+                device: .any,
+                trigger: MouseShortcutTrigger(button: .middle, kind: .drag, direction: .down),
+                action: MouseShortcutActionDefinition(type: .screenMapToggle, shortcut: nil)
+            ),
+            MouseShortcutRule(
+                id: "dictation",
+                enabled: true,
+                device: .any,
+                trigger: MouseShortcutTrigger(button: .middle, kind: .drag, direction: .up),
+                action: MouseShortcutActionDefinition(type: .dictationStart, shortcut: nil)
+            ),
+        ]
+    )
+}
+
+struct MouseShortcutMatchResult {
+    let rule: MouseShortcutRule
+    let action: MouseShortcutActionDefinition
+    let triggerName: String
+}
+
+struct MouseShortcutTriggerEvent {
+    let button: MouseShortcutButton
+    let kind: MouseShortcutTriggerKind
+    let direction: MouseGestureDirection
+    let device: MouseInputDeviceInfo?
+
+    var triggerName: String {
+        MouseShortcutTrigger(button: button, kind: kind, direction: direction).triggerName
+    }
+}
+
+struct MouseShortcutObservedEvent {
+    let timestamp: Date
+    let phase: String
+    let buttonNumber: Int
+    let location: CGPoint
+    let delta: CGPoint
+    let modifiers: NSEvent.ModifierFlags
+    let frontmostAppName: String?
+    let frontmostBundleId: String?
+    let candidateTrigger: String?
+    let device: MouseInputDeviceInfo?
+    let matchedRuleSummary: String?
+    let willFire: Bool
+    let note: String?
+}