dependencies: [
    // Dependencies declare other packages that this package depends on.
    .package(url: "https://github.com/NakaokaRei/SwiftAutoGUI", branch: "master")
],
targets: [
    .target(
        name: "MyProject",
        dependencies: [..., "SwiftAutoGUI"]
    )
    ...
]

import SwiftAutoGUI
// Async methods (recommended for non-blocking operations)
Task {
    // Send ctrl + ← using async method
    await SwiftAutoGUI.sendKeyShortcut([.control, .leftArrow])
    
    // Send sound up using async methods
    await SwiftAutoGUI.keyDown(.soundUp)
    await SwiftAutoGUI.keyUp(.soundUp)
    
    // Type text instantly
    await SwiftAutoGUI.write("Hello, World!")
    
    // Type with 0.1 second delay between characters
    await SwiftAutoGUI.write("Slowly typed text", interval: 0.1)
}
// Synchronous methods are deprecated but still available
// SwiftAutoGUI.sendKeyShortcut([.control, .leftArrow])

import SwiftAutoGUI
// Async methods (recommended for non-blocking operations)
Task {
    // Move mouse by dx, dy from the current location
    await SwiftAutoGUI.moveMouse(dx: 10, dy: 10)
    
    // Move the mouse to a specific position instantly
    // This parameter is the `CGWindow` coordinate.
    await SwiftAutoGUI.move(to: CGPointMake(0, 0), duration: 0)
    
    // Move with animation over 2 seconds
    await SwiftAutoGUI.move(to: CGPointMake(500, 500), duration: 2.0, tweening: .easeInOutQuad)
    
    // Double and triple clicks (async)
    await SwiftAutoGUI.doubleClick()
    await SwiftAutoGUI.tripleClick()
}
// Click where the mouse is located (no async needed)
SwiftAutoGUI.leftClick() // left
SwiftAutoGUI.rightClick() // right
// Scroll (no async needed - doesn't use Thread.sleep)
SwiftAutoGUI.vscroll(clicks: 10) // up
SwiftAutoGUI.vscroll(clicks: -10) // down
SwiftAutoGUI.hscroll(clicks: 10) // left
SwiftAutoGUI.hscroll(clicks: -10) // right
// Drag operations (no async needed)
SwiftAutoGUI.leftDragged(to: CGPoint(x: 300, y: 400), from: CGPoint(x: 100, y: 200))

import SwiftAutoGUI
// Take a screenshot of the entire screen
if let screenshot = SwiftAutoGUI.screenshot() {
    // Use the NSImage object
}
// Take a screenshot of a specific region
let region = CGRect(x: 100, y: 100, width: 200, height: 200)
if let regionScreenshot = SwiftAutoGUI.screenshot(region: region) {
    // Use the NSImage object
}
// Save a screenshot directly to a file
SwiftAutoGUI.screenshot(imageFilename: "screenshot.png")
// Save a region screenshot to a file
SwiftAutoGUI.screenshot(imageFilename: "region.jpg", region: region)
// Get screen size
let (width, height) = SwiftAutoGUI.size()
print("Screen size: \(width)x\(height)")
// Get the color of a specific pixel
if let color = SwiftAutoGUI.pixel(x: 100, y: 200) {
    print("Pixel color: \(color)")
}

import SwiftAutoGUI
// Locate an image on the screen
if let location = SwiftAutoGUI.locateOnScreen("button.png") {
    print("Found at: \(location)")
    // location is a CGRect with the position and size
    
    // Click at the center of the found image
    let center = CGPoint(x: location.midX, y: location.midY)
    Task {
        await SwiftAutoGUI.move(to: center, duration: 0)
        SwiftAutoGUI.leftClick()
    }
}
// Search with confidence threshold (0.0-1.0)
if let location = SwiftAutoGUI.locateOnScreen("button.png", confidence: 0.9) {
    // Found with 90% confidence
}
// Search in a specific region for better performance
let searchRegion = CGRect(x: 0, y: 0, width: 500, height: 500)
if let location = SwiftAutoGUI.locateOnScreen("button.png", region: searchRegion) {
    // Found within the specified region
}
// Locate and get the center point directly
if let buttonCenter = SwiftAutoGUI.locateCenterOnScreen("button.png") {
    // buttonCenter is a CGPoint with x,y coordinates of the center
    Task {
        await SwiftAutoGUI.move(to: buttonCenter, duration: 0)
        SwiftAutoGUI.leftClick()
    }
}
// locateCenterOnScreen also supports confidence and region parameters
if let center = SwiftAutoGUI.locateCenterOnScreen("target.png", confidence: 0.8, region: searchRegion) {
    // Click at the center of the found image
    Task {
        await SwiftAutoGUI.move(to: center, duration: 0)
        SwiftAutoGUI.leftClick()
    }
}
// Find all occurrences of an image on screen
Task {
    let buttons = SwiftAutoGUI.locateAllOnScreen("button.png")
    print("Found \(buttons.count) buttons")
    for (index, button) in buttons.enumerated() {
        print("Button \(index): \(button)")
        await SwiftAutoGUI.move(to: CGPoint(x: button.midX, y: button.midY), duration: 0)
        SwiftAutoGUI.leftClick()
        try await Task.sleep(nanoseconds: 500_000_000) // 0.5 seconds
    }
}
// locateAllOnScreen with confidence threshold for flexible matching
let icons = SwiftAutoGUI.locateAllOnScreen("app_icon.png", confidence: 0.85)
for icon in icons {
    // Process each found icon
    print("Found icon at: \(icon)")
}
// Search for multiple matches in a specific region
let topRegion = CGRect(x: 0, y: 0, width: 1920, height: 100)
let menuItems = SwiftAutoGUI.locateAllOnScreen("menu_item.png", region: topRegion)

import SwiftAutoGUI
// Execute AppleScript code
let script = """
tell application "Safari"
    activate
    make new document
    set URL of current tab of front window to "https://github.com/NakaokaRei/SwiftAutoGUI"
end tell
"""
try SwiftAutoGUI.executeAppleScript(script)
// Execute and get return value
let systemInfo = """
tell application "System Events"
    return system version of (system info)
end tell
"""
if let version = try SwiftAutoGUI.executeAppleScript(systemInfo) {
    print("macOS version: \(version)")
}
// Control system volume
try SwiftAutoGUI.executeAppleScript("set volume output volume 50")
// Display notification
let notification = """
display notification "Task completed!" with title "SwiftAutoGUI"
"""
try SwiftAutoGUI.executeAppleScript(notification)
// Execute AppleScript from file
try SwiftAutoGUI.executeAppleScriptFile("/path/to/script.applescript")