Something went wrong. Try again.
An auto tiler for macOS
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143import CoreGraphicsimport Darwinimport Foundationimport RealityDriverSupportimport Synchronization
final class DriverKeyBalance: Sendable { private struct State { var ledger = DriverKeyLedger() var targets: [UInt16: DriverInputTarget] = [:] var interrupted = false var registered: [DriverInputTarget] = [] } private let state = Mutex(State())
func interrupt() { state.withLock { $0.interrupted = true } }
func register(pid: Int32, windowID: UInt32) { state.withLock { $0.registered.append(DriverInputTarget(pid: pid, windowID: windowID)) } }
func requireRunning() throws { guard !state.withLock({ $0.interrupted }) else { throw DriverError("Safety stop: interrupted; input withheld") } }
func down(_ key: UInt16, target: DriverInputTarget) { state.withLock { $0.ledger.keyDown(key, target: target) $0.targets[key] = target } }
func up(_ key: UInt16, target: DriverInputTarget) { state.withLock { $0.ledger.keyUp(key, target: target) } }
func release() throws { guard !state.withLock({ $0.targets.isEmpty }) else { return } try DriverInput.requireAccess() let deadline = ContinuousClock.now.advanced(by: .seconds(1)) var failures: [String] = [] var sent: Set<UInt16> = [] var neutralSamples = 0 let targets = state.withLock { $0.targets } repeat { let releases = state.withLock { $0.ledger.releases } for release in releases { do { try postUp(key: release.key, target: release.target) up(release.key, target: release.target) sent.insert(release.key) } catch { failures.append("key \(release.key): \(error)") } } let held = Set(targets.keys.filter { CGEventSource.keyState(.combinedSessionState, key: $0) }) // Also cover re-posts consumed upstream of the tail fence, which have no native receipt. for (key, target) in targets.sorted(by: { $0.key < $1.key }) where held.contains(key) && !sent.contains(key) { do { try postUp(key: key, target: target) sent.insert(key) } catch { failures.append("key \(key): \(error)") } } sent.formIntersection(held) let balanced = state.withLock { $0.ledger.releases.isEmpty } neutralSamples = held.isEmpty && balanced ? neutralSamples + 1 : 0 if neutralSamples == 3 || !failures.isEmpty { break } Thread.sleep(forTimeInterval: 0.01) } while ContinuousClock.now < deadline let held = targets.keys.filter { CGEventSource.keyState(.combinedSessionState, key: $0) }.sorted() if !held.isEmpty { failures.append("combined session still holds keys \(held)") } if neutralSamples < 3 { failures.append("combined session key release did not settle") } do { try state.withLock { try $0.ledger.requireBalanced() } } catch { failures.append(String(describing: error)) } guard failures.isEmpty else { throw DriverError("Safety stop: key balance failed: \(failures.joined(separator: "; "))") } }
static func recover(key: UInt16, target: DriverInputTarget) throws { try DriverInput.requireAccess() guard target.fixture, !target.panel, !CGEventSource.keyState(.hidSystemState, key: key), CGEventSource.keyState(.combinedSessionState, key: key) else { throw DriverError( "Safety stop: recovery key \(key) must be virtually held, physically up, and target an owned fixture") } try postUp(key: key, target: target) let deadline = ContinuousClock.now.advanced(by: .seconds(1)) while CGEventSource.keyState(.combinedSessionState, key: key), ContinuousClock.now < deadline { Thread.sleep(forTimeInterval: 0.01) } guard !CGEventSource.keyState(.combinedSessionState, key: key) else { throw DriverError("Safety stop: recovery key-up did not release key \(key)") } }
private func postUp(key: UInt16, target: DriverInputTarget) throws { do { try Self.postUp(key: key, target: target) } catch { let originalError = error guard target.panel else { throw originalError } // Escape can close the owned panel before a screen reader's balancing up arrives. for candidate in state.withLock({ $0.registered }) { do { try DriverWindowMetadata.requireOwner(pid: candidate.pid, windowID: candidate.windowID) } catch { continue } try Self.postUp(key: key, target: candidate) try FileHandle.standardError.write( contentsOf: Data( "Balanced key \(key) through registered window \(candidate.windowID) after panel \(target.windowID) closed\n" .utf8)) return } throw originalError } }
private static func postUp(key: UInt16, target: DriverInputTarget) throws { guard !CGEventSource.keyState(.hidSystemState, key: key) else { throw DriverError("Safety stop: physical key \(key) is held; refusing to release external input") } try DriverWindowMetadata.requireOwner(pid: target.pid, windowID: target.windowID) guard let source = CGEventSource(stateID: .combinedSessionState), let up = CGEvent(keyboardEventSource: source, virtualKey: key, keyDown: false) else { throw DriverError("Could not create balancing key-up for key \(key)") } let held = Set( DriverModifierSequence.modifierKeys.filter { $0 != key && CGEventSource.keyState(.combinedSessionState, key: $0) }) up.flags = CGEventFlags( rawValue: DriverModifierSequence.releasingFlags( key: key, flags: CGEventSource.flagsState(.combinedSessionState).rawValue, heldKeys: held)) up.timestamp = clock_gettime_nsec_np(CLOCK_UPTIME_RAW) // Bypass a screen reader's re-posting tap; never deliver recovery input to the owner's foreground app. up.postToPid(target.pid) }}