Add window management and AppRunner API

- Implement Window, WindowOptions, and WindowList types - Add
WindowManager with event handling and window lifecycle methods -
Introduce AppRunner for running applications with windows - Update
example to demonstrate simple AppRunner usage - Update libnativeapi
submodule to latest commit

Author: lijy91

Sources/Example/main.swift

@@ -1,32 +1,49 @@
 import Foundation
 import NativeAPI
 
-// MARK: - Main Program
+// MARK: - Simple AppRunner Example
 
-print("=== NativeAPI Swift Example ===")
+print("=== NativeAPI AppRunner Simple Example ===")
+print("🚀 This demonstrates the simplest way to use AppRunner")
 print()
 
-// Test basic Display functionality
-print("🚀 Testing NativeAPI Display...")
-
-AccessibilityManager.shared.enable()
-
-let isAccessibilityEnabled = AccessibilityManager.shared.isEnabled()
+// Method 1: Using the convenience function with default window
+print("📱 Method 1: Running app with default window")
+print("💡 This creates a default window and runs the application")
+print()
 
-print("✅ Accessibility is enabled:", isAccessibilityEnabled)
+// Uncomment to try the simplest approach:
+// let exitCode = runApp()
+// print("✅ App exited with code: \(exitCode)")
 
-let display = Display()
-print("✅ Display instance created successfully!")
+// Method 2: Using custom window options
+print("📱 Method 2: Running app with custom window options")
+print("💡 This creates a window with specific options")
 print()
 
-print("📱 NativeAPI is working correctly!")
-print("💡 This example demonstrates that the NativeAPI library can be imported and used.")
+// Create custom window options
+let options = WindowOptions()
+_ = options.setTitle("My Swift App")
+options.setSize(Size(width: 1000, height: 700))
+options.setMinimumSize(Size(width: 500, height: 350))
+options.setCentered(true)
+
+print("⚙️ Window options configured:")
+print("   - Title: 'My Swift App'")
+print("   - Size: 1000x700")
+print("   - Minimum size: 500x350")
+print("   - Centered on screen")
 print()
 
-print("🎯 Next steps:")
-print("   - Implement more functionality in the NativeAPI module")
-print("   - Add real display management features")
-print("   - Test with actual display operations")
-print()
+// Run with custom options
+let exitCodeWithOptions = runApp(with: options)
+print("✅ App exited with code: \(exitCodeWithOptions)")
 
-print("✅ Example completed successfully!")
+print()
+print("🎉 Simple AppRunner example completed!")
+print("📝 This example showed:")
+print("   ✅ Simple one-line app launching")
+print("   ✅ Custom window configuration")
+print("   ✅ Exit code handling")
+print()
+print("💡 For more advanced features, see AppRunnerExample.swift")

Sources/NativeAPI/AppRunner.swift

@@ -1,5 +1,61 @@
-public class AppRunner {
-    public func run() {
+import CNativeAPI
+import Foundation
 
+/// AppRunner exit codes
+public enum AppExitCode: Int32 {
+    case success = 0
+    case failure = 1
+    case invalidWindow = 2
+}
+
+/// AppRunner manages the application lifecycle and event loop
+public class AppRunner: @unchecked Sendable {
+    /// Shared singleton instance
+    public static let shared = AppRunner()
+
+    private init() {}
+
+    /// Run the application with the specified window
+    /// This method starts the main event loop and blocks until the application exits
+    /// - Parameter window: The window to run the application with
+    /// - Returns: Exit code of the application (0 for success)
+    public func run(with window: Window) -> AppExitCode {
+        let exitCode = native_app_runner_run(window.handle)
+        return AppExitCode(rawValue: exitCode) ?? .failure
+    }
+
+    /// Check if the application is currently running
+    /// - Returns: true if the app is running, false otherwise
+    public var isRunning: Bool {
+        return native_app_runner_is_running()
+    }
+}
+
+/// Convenience function to run the application with the specified window
+/// This is equivalent to calling AppRunner.shared.run(with: window)
+/// - Parameter window: The window to run the application with
+/// - Returns: Exit code of the application (0 for success)
+public func runApp(with window: Window) -> AppExitCode {
+    return AppRunner.shared.run(with: window)
+}
+
+/// Convenience function to run the application with window options
+/// Creates a window with the specified options and runs the application
+/// - Parameter options: Window options for creating the window
+/// - Returns: Exit code of the application (0 for success)
+public func runApp(with options: WindowOptions) -> AppExitCode {
+    guard let window = WindowManager.shared.createWindow(with: options) else {
+        return .invalidWindow
+    }
+    return AppRunner.shared.run(with: window)
+}
+
+/// Convenience function to run the application with default window
+/// Creates a default window and runs the application
+/// - Returns: Exit code of the application (0 for success)
+public func runApp() -> AppExitCode {
+    guard let window = WindowManager.shared.createWindow() else {
+        return .invalidWindow
     }
+    return AppRunner.shared.run(with: window)
 }