dependencies: [
    .package(url: "https://github.com/CorvidLabs/swift-godot.git", from: "0.1.0")
]

.target(
    name: "YourGame",
    dependencies: [
        .product(name: "SwiftGodotKit", package: "swift-godot")
    ]
)

import SwiftGodotKit  // Includes all of SwiftGodot

@Godot
class Player: CharacterBody3D {
    // Reactive state with change tracking
    @GodotState var health: Int = 100
    @GodotState var isAlive: Bool = true

    // Declarative node references
    @GodotNode("HealthBar") var healthBar: ProgressBar?
    @GodotNode(.unique("AnimPlayer")) var animator: AnimationPlayer?

    override func _ready() {
        $healthBar.configure(owner: self)
        $animator.configure(owner: self)
    }

    override func _process(delta: Double) {
        // React to state changes
        if $health.changed {
            healthBar?.value = Double(health)
            if health <= 0 { isAlive = false }
        }
        $health.reset()
    }

    func takeDamage(_ amount: Int) {
        health = max(0, health - amount)
    }
}

@GodotState var score: Int = 0

// Check if changed this frame
if $score.changed {
    updateScoreDisplay()
}

// Get previous value for animations
if let previous = $score.previous {
    animateScoreChange(from: previous, to: score)
}

// Create bindings for UI
let binding = $score.binding

// By path
@GodotNode("UI/HealthBar") var healthBar: ProgressBar?

// By unique name (% prefix in scene)
@GodotNode(.unique("Player")) var player: CharacterBody3D?

// By group
@GodotNode(.group("enemies")) var firstEnemy: Node?

@GodotSignal("pressed")
var onPressed: () -> Void = { print("Pressed!") }

// Wait for a signal
await SignalAwaiter.wait(for: button, signal: "pressed")

// Wait with timeout
let succeeded = try await SignalAwaiter.wait(
    for: enemy,
    signal: "died",
    timeout: .seconds(5)
)

// Stream signals as AsyncSequence
for await _ in AsyncSignal(source: timer, signal: "timeout") {
    updateGame()
}

// Wait for next frame
await GodotTask.nextFrame()

// Wait for physics frame
await GodotTask.nextPhysicsFrame()

// Wait specific duration
await GodotTask.wait(seconds: 1.5)

class GameScene: SceneController {
    typealias RootNode = Node3D
    var rootNode: Node3D?

    func sceneDidBecomeReady() {
        setupGame()
    }

    func sceneDidProcess(delta: Double) {
        updateGameLogic(delta: delta)
    }
}

class PlayerController: NodeController {
    typealias NodeType = CharacterBody3D
    let node = CharacterBody3D()

    var children: [any NodeController] {
        [HealthBarController(), WeaponController()]
    }

    func configure() {
        node.name = "Player"
    }
}

// Iterate children
for child in node.children {
    print(child.name)
}

// Type-safe queries
let buttons: [Button] = panel.children(ofType: Button.self)
let allEnemies: [Enemy] = level.descendants(ofType: Enemy.self)

// Fluent configuration
let label = Label().configure {
    $0.text = "Hello"
    $0.horizontalAlignment = .center
}