@zenalexa/unicli 0.221.1 → 0.222.0

package/dist/transport/adapters/desktop-ax-background-dispatch-swift.js

@@ -0,0 +1,169 @@
+/**
+ * @owner   src/transport/adapters/desktop-ax-background-dispatch-swift.ts
+ * @does    Generate Swift for pid-addressed mouse, text, and key-combo dispatch.
+ * @needs   AppKit NSEvent factories, CoreGraphics event APIs, Carbon virtual key constants
+ * @feeds   desktop-ax background input Swift generator
+ * @breaks  Bad key maps or event ordering can drop input or leave modifier keys pressed.
+ */
+export function swiftBackgroundDispatcherSupportCode() {
+    return [
+        `struct ScopedWindowInputDispatcher {`,
+        `  let targetPID: pid_t`,
+        `  let windowNumber: Int`,
+        `  let windowFrame: CGRect`,
+        `  let keySource = CGEventSource(stateID: .hidSystemState)`,
+        `  func click(atScreenPoint point: CGPoint, buttonIndex: Int, clickCount: Int) throws {`,
+        `    let button = cgButton(buttonIndex)`,
+        `    let types = mouseTypes(buttonIndex)`,
+        `    let clampedCount = max(1, min(3, clickCount))`,
+        `    for index in 1...clampedCount {`,
+        `      let state = index`,
+        `      let down = try makeMouse(types.down, point: point, button: button, clickState: state, pressure: 1)`,
+        `      let up = try makeMouse(types.up, point: point, button: button, clickState: state, pressure: 0)`,
+        `      down.postToPid(targetPID)`,
+        `      usleep(30_000)`,
+        `      up.postToPid(targetPID)`,
+        `      if index < clampedCount { usleep(80_000) }`,
+        `    }`,
+        `  }`,
+        `  func typeText(_ text: String) throws {`,
+        `    for character in text {`,
+        `      let units = Array(String(character).utf16)`,
+        `      try units.withUnsafeBufferPointer { buffer in`,
+        `        guard let base = buffer.baseAddress, buffer.count > 0 else { return }`,
+        `        let down = try makeKey(keyCode: 0, flags: [], isDown: true)`,
+        `        down.keyboardSetUnicodeString(stringLength: buffer.count, unicodeString: base)`,
+        `        postKey(down)`,
+        `        let up = try makeKey(keyCode: 0, flags: [], isDown: false)`,
+        `        up.keyboardSetUnicodeString(stringLength: buffer.count, unicodeString: base)`,
+        `        postKey(up)`,
+        `      }`,
+        `      usleep(1_000)`,
+        `    }`,
+        `  }`,
+        `  func press(_ raw: String) throws {`,
+        `    let combo = try KeyCombination.parse(raw)`,
+        `    for modifier in combo.modifiers { postKey(try makeKey(keyCode: modifier.virtualKey, flags: modifier.flags, isDown: true)) }`,
+        `    let combined = combo.modifiers.reduce(into: CGEventFlags()) { acc, modifier in acc.formUnion(modifier.flags) }`,
+        `    postKey(try makeKey(keyCode: combo.keyCode, flags: combined, isDown: true))`,
+        `    postKey(try makeKey(keyCode: combo.keyCode, flags: combined, isDown: false))`,
+        `    var remaining = combined`,
+        `    for modifier in combo.modifiers.reversed() {`,
+        `      remaining.subtract(modifier.flags)`,
+        `      postKey(try makeKey(keyCode: modifier.virtualKey, flags: remaining, isDown: false))`,
+        `    }`,
+        `  }`,
+        `  private func makeMouse(_ type: CGEventType, point: CGPoint, button: CGMouseButton, clickState: Int, pressure: Double) throws -> CGEvent {`,
+        `    let modifierFlags: NSEvent.ModifierFlags = appIsActive(pid: targetPID) ? [] : [.command]`,
+        `    guard let nsEvent = NSEvent.mouseEvent(`,
+        `      with: nsMouseType(type),`,
+        `      location: point,`,
+        `      modifierFlags: modifierFlags,`,
+        `      timestamp: ProcessInfo.processInfo.systemUptime,`,
+        `      windowNumber: windowNumber,`,
+        `      context: nil,`,
+        `      eventNumber: nextSyntheticMouseEventNumber(),`,
+        `      clickCount: clickState,`,
+        `      pressure: Float(pressure)`,
+        `    ), let event = nsEvent.cgEvent else { throw BackgroundInputError.eventCreate("mouse") }`,
+        `    stampWindow(event, targetPID: targetPID, windowNumber: windowNumber, windowFrame: windowFrame, point: point, buttonNumber: Int64(button.rawValue), clickState: Int64(clickState), pressure: pressure)`,
+        `    return event`,
+        `  }`,
+        `  private func nsMouseType(_ type: CGEventType) -> NSEvent.EventType {`,
+        `    switch type {`,
+        `    case .rightMouseDown: return .rightMouseDown`,
+        `    case .rightMouseUp: return .rightMouseUp`,
+        `    case .otherMouseDown: return .otherMouseDown`,
+        `    case .otherMouseUp: return .otherMouseUp`,
+        `    case .leftMouseUp: return .leftMouseUp`,
+        `    default: return .leftMouseDown`,
+        `    }`,
+        `  }`,
+        `  private func makeKey(keyCode: CGKeyCode, flags: CGEventFlags, isDown: Bool) throws -> CGEvent {`,
+        `    guard let event = CGEvent(keyboardEventSource: keySource, virtualKey: keyCode, keyDown: isDown) else { throw BackgroundInputError.eventCreate("keyboard") }`,
+        `    event.flags = flags`,
+        `    event.setIntegerValueField(.eventTargetUnixProcessID, value: Int64(targetPID))`,
+        `    event.setWindowAddressingFields(windowNumber: windowNumber)`,
+        `    return event`,
+        `  }`,
+        `  private func postKey(_ event: CGEvent) { event.postToPid(targetPID) }`,
+        `}`,
+        ``,
+        `var syntheticMouseEventNumber = 1`,
+        `func nextSyntheticMouseEventNumber() -> Int {`,
+        `  defer { syntheticMouseEventNumber += 1 }`,
+        `  return syntheticMouseEventNumber`,
+        `}`,
+        ``,
+        `func appIsActive(pid: pid_t) -> Bool {`,
+        `  NSWorkspace.shared.runningApplications.first { $0.processIdentifier == pid }?.isActive == true`,
+        `}`,
+        ``,
+        `func cgButton(_ index: Int) -> CGMouseButton {`,
+        `  if index == 1 { return .right }`,
+        `  if index == 2 { return .center }`,
+        `  return .left`,
+        `}`,
+        ``,
+        `func mouseTypes(_ index: Int) -> (down: CGEventType, up: CGEventType) {`,
+        `  if index == 1 { return (.rightMouseDown, .rightMouseUp) }`,
+        `  if index == 2 { return (.otherMouseDown, .otherMouseUp) }`,
+        `  return (.leftMouseDown, .leftMouseUp)`,
+        `}`,
+        ``,
+        `struct KeyCombination {`,
+        `  let modifiers: [KeyModifier]`,
+        `  let keyCode: CGKeyCode`,
+        `  static func parse(_ raw: String) throws -> KeyCombination {`,
+        `    let segments = raw.split(separator: "+").map { $0.trimmingCharacters(in: .whitespacesAndNewlines).lowercased() }`,
+        `    guard let final = segments.last, !final.isEmpty else { throw BackgroundInputError.invalidCombo(raw) }`,
+        `    let modifiers = try segments.dropLast().map(KeyModifier.init(token:))`,
+        `    return KeyCombination(modifiers: modifiers, keyCode: try keyCode(for: final))`,
+        `  }`,
+        `  private static func keyCode(for token: String) throws -> CGKeyCode {`,
+        `    if token.count == 1, let scalar = token.unicodeScalars.first {`,
+        `      switch scalar {`,
+        `      case "a"..."z": return alphaKeyCodes[String(scalar)]!`,
+        `      case "0"..."9": return digitKeyCodes[String(scalar)]!`,
+        `      default: break`,
+        `      }`,
+        `    }`,
+        `    guard let keyCode = namedKeyCodes[token] else { throw BackgroundInputError.unsupportedKey(token) }`,
+        `    return keyCode`,
+        `  }`,
+        `}`,
+        ``,
+        `struct KeyModifier {`,
+        `  let flags: CGEventFlags`,
+        `  let virtualKey: CGKeyCode`,
+        `  init(token: String) throws {`,
+        `    switch token {`,
+        `    case "shift": flags = .maskShift; virtualKey = CGKeyCode(kVK_Shift)`,
+        `    case "control", "ctrl": flags = .maskControl; virtualKey = CGKeyCode(kVK_Control)`,
+        `    case "option", "alt": flags = .maskAlternate; virtualKey = CGKeyCode(kVK_Option)`,
+        `    case "command", "cmd", "super", "meta": flags = .maskCommand; virtualKey = CGKeyCode(kVK_Command)`,
+        `    default: throw BackgroundInputError.unsupportedKey(token)`,
+        `    }`,
+        `  }`,
+        `}`,
+        ``,
+        `let alphaKeyCodes: [String: CGKeyCode] = [`,
+        `  "a": CGKeyCode(kVK_ANSI_A), "b": CGKeyCode(kVK_ANSI_B), "c": CGKeyCode(kVK_ANSI_C), "d": CGKeyCode(kVK_ANSI_D), "e": CGKeyCode(kVK_ANSI_E), "f": CGKeyCode(kVK_ANSI_F),`,
+        `  "g": CGKeyCode(kVK_ANSI_G), "h": CGKeyCode(kVK_ANSI_H), "i": CGKeyCode(kVK_ANSI_I), "j": CGKeyCode(kVK_ANSI_J), "k": CGKeyCode(kVK_ANSI_K), "l": CGKeyCode(kVK_ANSI_L),`,
+        `  "m": CGKeyCode(kVK_ANSI_M), "n": CGKeyCode(kVK_ANSI_N), "o": CGKeyCode(kVK_ANSI_O), "p": CGKeyCode(kVK_ANSI_P), "q": CGKeyCode(kVK_ANSI_Q), "r": CGKeyCode(kVK_ANSI_R),`,
+        `  "s": CGKeyCode(kVK_ANSI_S), "t": CGKeyCode(kVK_ANSI_T), "u": CGKeyCode(kVK_ANSI_U), "v": CGKeyCode(kVK_ANSI_V), "w": CGKeyCode(kVK_ANSI_W), "x": CGKeyCode(kVK_ANSI_X),`,
+        `  "y": CGKeyCode(kVK_ANSI_Y), "z": CGKeyCode(kVK_ANSI_Z),`,
+        `]`,
+        `let digitKeyCodes: [String: CGKeyCode] = [`,
+        `  "0": CGKeyCode(kVK_ANSI_0), "1": CGKeyCode(kVK_ANSI_1), "2": CGKeyCode(kVK_ANSI_2), "3": CGKeyCode(kVK_ANSI_3), "4": CGKeyCode(kVK_ANSI_4),`,
+        `  "5": CGKeyCode(kVK_ANSI_5), "6": CGKeyCode(kVK_ANSI_6), "7": CGKeyCode(kVK_ANSI_7), "8": CGKeyCode(kVK_ANSI_8), "9": CGKeyCode(kVK_ANSI_9),`,
+        `]`,
+        `let namedKeyCodes: [String: CGKeyCode] = [`,
+        `  "space": CGKeyCode(kVK_Space), "tab": CGKeyCode(kVK_Tab), "return": CGKeyCode(kVK_Return), "enter": CGKeyCode(kVK_Return),`,
+        `  "escape": CGKeyCode(kVK_Escape), "esc": CGKeyCode(kVK_Escape), "delete": CGKeyCode(kVK_Delete), "backspace": CGKeyCode(kVK_Delete),`,
+        `  "forward-delete": CGKeyCode(kVK_ForwardDelete), "left": CGKeyCode(kVK_LeftArrow), "right": CGKeyCode(kVK_RightArrow), "up": CGKeyCode(kVK_UpArrow),`,
+        `  "down": CGKeyCode(kVK_DownArrow), "home": CGKeyCode(kVK_Home), "end": CGKeyCode(kVK_End), "pageup": CGKeyCode(kVK_PageUp), "pagedown": CGKeyCode(kVK_PageDown),`,
+        `]`,
+    ].join("\n");
+}
+//# sourceMappingURL=desktop-ax-background-dispatch-swift.js.map

package/dist/transport/adapters/desktop-ax-background-dispatch-swift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-ax-background-dispatch-swift.js","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-background-dispatch-swift.ts"],"names":[],"mappings":"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"}

package/dist/transport/adapters/desktop-ax-background-input-swift.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @owner   src/transport/adapters/desktop-ax-background-input-swift.ts
+ * @does    Generate Swift for scoped macOS background window activation and pid-addressed input.
+ * @needs   desktop-ax target resolution, background activation/window/input Swift fragments
+ * @feeds   desktop-ax background click/type/press actions
+ * @breaks  Invalid event fields or focus suppression regressions can steal focus or drop background input.
+ */
+import type { ResolvedAxTarget } from "./desktop-ax-swift.js";
+export type AxBackgroundInputAction = "click" | "type_text" | "press_key";
+export interface AxBackgroundInputScriptOptions {
+    action: AxBackgroundInputAction;
+    x?: number;
+    y?: number;
+    coordinateSpace: "screen" | "window";
+    button: number;
+    clickCount: number;
+    windowNumber?: number;
+    text?: string;
+    key?: string;
+    clickBeforeText?: boolean;
+}
+export declare function buildAxBackgroundInputScript(target: ResolvedAxTarget, opts: AxBackgroundInputScriptOptions): string;
+//# sourceMappingURL=desktop-ax-background-input-swift.d.ts.map

package/dist/transport/adapters/desktop-ax-background-input-swift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-ax-background-input-swift.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-background-input-swift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,uBAAuB,CAAC;IAChC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,8BAA8B,GACnC,MAAM,CAgHR"}

package/dist/transport/adapters/desktop-ax-background-input-swift.js

@@ -0,0 +1,157 @@
+/**
+ * @owner   src/transport/adapters/desktop-ax-background-input-swift.ts
+ * @does    Generate Swift for scoped macOS background window activation and pid-addressed input.
+ * @needs   desktop-ax target resolution, background activation/window/input Swift fragments
+ * @feeds   desktop-ax background click/type/press actions
+ * @breaks  Invalid event fields or focus suppression regressions can steal focus or drop background input.
+ */
+import { swiftStringArray, swiftStringLiteral } from "./desktop-ax-swift.js";
+import { swiftBackgroundActivationSupportCode } from "./desktop-ax-background-activation-swift.js";
+import { swiftBackgroundDispatcherSupportCode } from "./desktop-ax-background-dispatch-swift.js";
+import { swiftBackgroundWindowSupportCode } from "./desktop-ax-background-window-swift.js";
+export function buildAxBackgroundInputScript(target, opts) {
+    const action = opts.action;
+    const x = normalizeNumber(opts.x, 0);
+    const y = normalizeNumber(opts.y, 0);
+    const hasPoint = typeof opts.x === "number" &&
+        Number.isFinite(opts.x) &&
+        typeof opts.y === "number" &&
+        Number.isFinite(opts.y);
+    const coordinateSpace = opts.coordinateSpace === "screen" ? "screen" : "window";
+    const button = Math.max(0, Math.trunc(opts.button));
+    const clickCount = Math.max(1, Math.trunc(opts.clickCount));
+    const windowNumber = opts.windowNumber
+        ? Math.max(0, Math.trunc(opts.windowNumber))
+        : 0;
+    return [
+        `import AppKit`,
+        `import ApplicationServices`,
+        `import Carbon.HIToolbox`,
+        `import CoreFoundation`,
+        `import CoreGraphics`,
+        `import Darwin`,
+        `import Foundation`,
+        ``,
+        ...buildRunningAppPrelude(target),
+        swiftEmitHelper(),
+        `let commandMode = "background_input"`,
+        `let requestedAction = ${swiftStringLiteral(action)}`,
+        `let inputX = CGFloat(${x})`,
+        `let inputY = CGFloat(${y})`,
+        `let hasInputPoint = ${hasPoint ? "true" : "false"}`,
+        `let coordinateSpace = ${swiftStringLiteral(coordinateSpace)}`,
+        `let buttonIndex = ${button}`,
+        `let requestedClickCount = ${clickCount}`,
+        `let requestedWindowNumber = ${windowNumber}`,
+        `let inputText = ${swiftStringLiteral(opts.text ?? "")}`,
+        `let inputKey = ${swiftStringLiteral(opts.key ?? "")}`,
+        `let clickBeforeText = ${opts.clickBeforeText === false ? "false" : "true"}`,
+        ``,
+        swiftSupportCode(),
+        ``,
+        `guard let running else {`,
+        `  emit(["found": false, "posted": false, "mode": commandMode, "action": requestedAction, "bundleId": bundleId, "localizedName": processName, "reason": "target_app_not_running"])`,
+        `  exit(0)`,
+        `}`,
+        ``,
+        `guard let window = targetWindow(pid: running.processIdentifier) else {`,
+        `  emit(["found": true, "posted": false, "mode": commandMode, "action": requestedAction, "pid": Int(running.processIdentifier), "reason": "window_not_found"])`,
+        `  exit(0)`,
+        `}`,
+        ``,
+        `if requestedAction == "click" && !hasInputPoint {`,
+        `  emit(["found": true, "posted": false, "mode": commandMode, "action": requestedAction, "pid": Int(running.processIdentifier), "windowNumber": Int(window.id), "reason": "missing_point"])`,
+        `  exit(0)`,
+        `}`,
+        `if requestedAction == "type_text" && inputText.isEmpty {`,
+        `  emit(["found": true, "posted": true, "mode": commandMode, "action": requestedAction, "pid": Int(running.processIdentifier), "windowNumber": Int(window.id), "typedCharacters": 0])`,
+        `  exit(0)`,
+        `}`,
+        `if requestedAction == "press_key" && inputKey.isEmpty {`,
+        `  emit(["found": true, "posted": false, "mode": commandMode, "action": requestedAction, "pid": Int(running.processIdentifier), "windowNumber": Int(window.id), "reason": "missing_key"])`,
+        `  exit(0)`,
+        `}`,
+        ``,
+        `let wasFrontmost = NSWorkspace.shared.frontmostApplication?.processIdentifier == running.processIdentifier`,
+        `let activation: ScopedWindowActivationSession?`,
+        `if wasFrontmost {`,
+        `  activation = nil`,
+        `} else {`,
+        `  guard let session = ScopedWindowActivationSession.start(targetPID: running.processIdentifier) else {`,
+        `    emit(["found": true, "posted": false, "mode": commandMode, "action": requestedAction, "pid": Int(running.processIdentifier), "windowNumber": Int(window.id), "reason": "focus_suppression_tap_failed"])`,
+        `    exit(0)`,
+        `  }`,
+        `  activation = session`,
+        `}`,
+        `defer {`,
+        `  if !wasFrontmost { activation?.restoreBackgroundActivationIfNeeded(windowNumber: Int(window.id)) }`,
+        `  activation?.finish()`,
+        `}`,
+        ``,
+        `if !wasFrontmost {`,
+        `  activation?.beginTargetDelivery()`,
+        `  ScopedWindowActivationSession.activateWindow(targetPID: running.processIdentifier, windowNumber: Int(window.id), windowFrame: window.frame)`,
+        `  activation?.holdFocusSuppressionUntilFinish()`,
+        `}`,
+        ``,
+        `let requestedPoint = hasInputPoint ? requestedScreenPoint(windowFrame: window.frame) : CGPoint(x: window.frame.midX, y: window.frame.midY)`,
+        `let dispatcher = ScopedWindowInputDispatcher(targetPID: running.processIdentifier, windowNumber: Int(window.id), windowFrame: window.frame)`,
+        `do {`,
+        `  switch requestedAction {`,
+        `  case "click":`,
+        `    try dispatcher.click(atScreenPoint: requestedPoint, buttonIndex: buttonIndex, clickCount: requestedClickCount)`,
+        `    emitSuccess(window: window, running: running, wasFrontmost: wasFrontmost, extra: ["screenX": Double(requestedPoint.x), "screenY": Double(requestedPoint.y)])`,
+        `  case "type_text":`,
+        `    if clickBeforeText && hasInputPoint {`,
+        `      try dispatcher.click(atScreenPoint: requestedPoint, buttonIndex: 0, clickCount: 1)`,
+        `      usleep(30_000)`,
+        `    }`,
+        `    try dispatcher.typeText(inputText)`,
+        `    emitSuccess(window: window, running: running, wasFrontmost: wasFrontmost, extra: ["typedCharacters": inputText.count])`,
+        `  case "press_key":`,
+        `    try dispatcher.press(inputKey)`,
+        `    emitSuccess(window: window, running: running, wasFrontmost: wasFrontmost, extra: ["key": inputKey])`,
+        `  default:`,
+        `    emit(["found": true, "posted": false, "mode": commandMode, "action": requestedAction, "pid": Int(running.processIdentifier), "windowNumber": Int(window.id), "reason": "unsupported_action"])`,
+        `  }`,
+        `} catch {`,
+        `  emit(["found": true, "posted": false, "mode": commandMode, "action": requestedAction, "pid": Int(running.processIdentifier), "windowNumber": Int(window.id), "reason": String(describing: error)])`,
+        `}`,
+    ].join("\n");
+}
+function buildRunningAppPrelude(target) {
+    return [
+        `let bundleId: String? = ${swiftStringLiteral(target.bundleId ?? "")}.isEmpty ? nil : ${swiftStringLiteral(target.bundleId ?? "")}`,
+        `let processName: String? = ${swiftStringLiteral(target.processName)}.isEmpty ? nil : ${swiftStringLiteral(target.processName)}`,
+        `let executableNames: [String] = ${swiftStringArray(target.executableNames)}`,
+        `func matches(_ app: NSRunningApplication) -> Bool {`,
+        `  if let bundleId, app.bundleIdentifier == bundleId { return true }`,
+        `  if let processName, app.localizedName == processName { return true }`,
+        `  if let executable = app.executableURL?.lastPathComponent, executableNames.contains(executable) { return true }`,
+        `  return false`,
+        `}`,
+        `let running = NSWorkspace.shared.runningApplications.first(where: matches)`,
+    ];
+}
+function swiftEmitHelper() {
+    return [
+        `func emit(_ object: [String: Any?]) {`,
+        `  let flat = object.reduce(into: [String: Any]()) { acc, item in`,
+        `    if let value = item.value { acc[item.key] = value }`,
+        `  }`,
+        `  let data = try! JSONSerialization.data(withJSONObject: flat, options: [])`,
+        `  FileHandle.standardOutput.write(data)`,
+        `}`,
+    ].join("\n");
+}
+function swiftSupportCode() {
+    return [
+        swiftBackgroundWindowSupportCode(),
+        swiftBackgroundActivationSupportCode(),
+        swiftBackgroundDispatcherSupportCode(),
+    ].join("\n");
+}
+function normalizeNumber(value, fallback) {
+    return String(typeof value === "number" && Number.isFinite(value) ? value : fallback);
+}
+//# sourceMappingURL=desktop-ax-background-input-swift.js.map

package/dist/transport/adapters/desktop-ax-background-input-swift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-ax-background-input-swift.js","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-background-input-swift.ts"],"names":[],"mappings":"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"}

package/dist/transport/adapters/desktop-ax-background-input.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @owner   src/transport/adapters/desktop-ax-background-input.ts
+ * @does    Validate and execute macOS desktop-ax background input actions through generated Swift.
+ * @needs   desktop-ax shell abstraction, target resolution, background input Swift generator
+ * @feeds   DesktopAxTransport background click/type/press actions
+ * @breaks  Bad validation can route unscoped input to the wrong app or hide host permission failures.
+ */
+import type { Envelope } from "../../core/envelope.js";
+import type { AxShell } from "./desktop-ax.js";
+export declare function runAxBackgroundClick<T>(shell: AxShell, params: Record<string, unknown>): Promise<Envelope<T>>;
+export declare function runAxBackgroundType<T>(shell: AxShell, params: Record<string, unknown>): Promise<Envelope<T>>;
+export declare function runAxBackgroundPress<T>(shell: AxShell, params: Record<string, unknown>): Promise<Envelope<T>>;
+//# sourceMappingURL=desktop-ax-background-input.d.ts.map

package/dist/transport/adapters/desktop-ax-background-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-ax-background-input.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-background-input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAoB/C,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAMtB;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAMtB;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAMtB"}

package/dist/transport/adapters/desktop-ax-background-input.js

@@ -0,0 +1,124 @@
+/**
+ * @owner   src/transport/adapters/desktop-ax-background-input.ts
+ * @does    Validate and execute macOS desktop-ax background input actions through generated Swift.
+ * @needs   desktop-ax shell abstraction, target resolution, background input Swift generator
+ * @feeds   DesktopAxTransport background click/type/press actions
+ * @breaks  Bad validation can route unscoped input to the wrong app or hide host permission failures.
+ */
+import { err, exitCodeFor, ok } from "../../core/envelope.js";
+import { buildAxBackgroundInputScript } from "./desktop-ax-background-input-swift.js";
+import { readPositiveInt, resolveAxTarget } from "./desktop-ax-swift.js";
+export async function runAxBackgroundClick(shell, params) {
+    return runAxBackgroundInput(shell, params, {
+        action: "click",
+        sourceAction: "ax_background_click",
+        requirePoint: true,
+    });
+}
+export async function runAxBackgroundType(shell, params) {
+    return runAxBackgroundInput(shell, params, {
+        action: "type_text",
+        sourceAction: "ax_background_type",
+        textParam: typeof params.value === "string" ? "value" : "text",
+    });
+}
+export async function runAxBackgroundPress(shell, params) {
+    return runAxBackgroundInput(shell, params, {
+        action: "press_key",
+        sourceAction: "ax_background_press",
+        keyParam: typeof params.key === "string" ? "key" : "combo",
+    });
+}
+async function runAxBackgroundInput(shell, params, opts) {
+    const target = resolveAxTarget(params);
+    if (!target) {
+        return err({
+            transport: "desktop-ax",
+            step: 0,
+            action: opts.sourceAction,
+            reason: "missing target app (`app`, `bundleId`, or `processName`)",
+            suggestion: "pass params.app, or supply params.bundleId / params.processName for localized Electron apps",
+            exit_code: exitCodeFor("usage_error"),
+        });
+    }
+    const x = typeof params.x === "number" ? params.x : undefined;
+    const y = typeof params.y === "number" ? params.y : undefined;
+    if (opts.requirePoint && (x === undefined || y === undefined)) {
+        return err({
+            transport: "desktop-ax",
+            step: 0,
+            action: opts.sourceAction,
+            reason: `missing required param \`${x === undefined ? "x" : "y"}\``,
+            suggestion: `pass screen or window-local x/y coordinates to ${opts.sourceAction}`,
+            exit_code: exitCodeFor("usage_error"),
+        });
+    }
+    const text = opts.textParam ? readString(params[opts.textParam]) : undefined;
+    if (opts.textParam && text === undefined) {
+        return missingInputParam(opts.sourceAction, opts.textParam);
+    }
+    const key = opts.keyParam ? readString(params[opts.keyParam]) : undefined;
+    if (opts.keyParam && key === undefined) {
+        return missingInputParam(opts.sourceAction, opts.keyParam);
+    }
+    try {
+        const { stdout } = await shell.run("swift", [
+            "-e",
+            buildAxBackgroundInputScript(target, {
+                action: opts.action,
+                x,
+                y,
+                coordinateSpace: params.coordinateSpace === "screen" ? "screen" : "window",
+                button: readPositiveInt(params.button, 0),
+                clickCount: readPositiveInt(params.clickCount, 1) || 1,
+                windowNumber: typeof params.windowNumber === "number"
+                    ? readPositiveInt(params.windowNumber, 0)
+                    : undefined,
+                text,
+                key,
+                clickBeforeText: params.clickBeforeText !== false,
+            }),
+        ], { timeoutMs: 10_000 });
+        const result = JSON.parse(stdout.trim());
+        if (!result.found || result.posted === false) {
+            return err({
+                transport: "desktop-ax",
+                step: 0,
+                action: opts.sourceAction,
+                reason: `background input failed in ${target.appName}: ${result.reason ?? "target app/window not found"}`,
+                suggestion: "verify the target window is on screen and grant Input Monitoring / Accessibility to the host terminal",
+                exit_code: exitCodeFor("service_unavailable"),
+            });
+        }
+        return ok(result);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        const timeout = /timeout|timed out|ETIMEDOUT/i.test(msg);
+        return err({
+            transport: "desktop-ax",
+            step: 0,
+            action: opts.sourceAction,
+            reason: msg,
+            suggestion: "check app name, Input Monitoring / Accessibility permissions, and that the app is installed",
+            retryable: timeout,
+            exit_code: timeout
+                ? exitCodeFor("temp_failure")
+                : exitCodeFor("service_unavailable"),
+        });
+    }
+}
+function readString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function missingInputParam(action, paramName) {
+    return err({
+        transport: "desktop-ax",
+        step: 0,
+        action,
+        reason: `missing required param \`${paramName}\``,
+        suggestion: `pass params.${paramName} to ${action}`,
+        exit_code: exitCodeFor("usage_error"),
+    });
+}
+//# sourceMappingURL=desktop-ax-background-input.js.map

package/dist/transport/adapters/desktop-ax-background-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-ax-background-input.js","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-background-input.ts"],"names":[],"mappings":"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"}

package/dist/transport/adapters/desktop-ax-background-window-swift.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   src/transport/adapters/desktop-ax-background-window-swift.ts
+ * @does    Generate Swift helpers for target window lookup and CGEvent window addressing.
+ * @needs   AppKit/CoreGraphics runtime APIs
+ * @feeds   desktop-ax background input Swift generator
+ * @breaks  Incorrect window fields can send background input to the wrong macOS window.
+ */
+export declare function swiftBackgroundWindowSupportCode(): string;
+//# sourceMappingURL=desktop-ax-background-window-swift.d.ts.map

package/dist/transport/adapters/desktop-ax-background-window-swift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-ax-background-window-swift.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/desktop-ax-background-window-swift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,gCAAgC,IAAI,MAAM,CAqGzD"}