Merge pull request #2 from Alexander5015/sudo

Refactor MacroVisionKit: Introduce FullScreenMonitor Actor for Real-Time Full Screen Space Detection

Author: Alexander5015

.gitignore

@@ -1,3 +1,4 @@
 .build
 .swiftpm
 .vscode
+.DS_Store

Examples/FullScreenMonitorExample.swift

@@ -0,0 +1,50 @@
+import Cocoa
+import MacroVisionKit
+
+@MainActor
+@main
+final class FullScreenMonitorExampleApp: NSObject, NSApplicationDelegate {
+    private var monitorTask: Task<Void, Never>?
+
+    static func main() {
+        let app = NSApplication.shared
+        let delegate = FullScreenMonitorExampleApp()
+        app.delegate = delegate
+        app.setActivationPolicy(.accessory)
+        app.run()
+    }
+
+    func applicationDidFinishLaunching(_ notification: Notification) {
+        print("Listening for fullscreen space changes... (Press Ctrl+C to exit)")
+        monitorTask = Task { [weak self] in
+            guard let self = self else { return }
+            let stream = await FullScreenMonitor.shared.spaceChanges()
+            for await spaces in stream {
+                self.render(spaces)
+            }
+        }
+    }
+
+    func applicationWillTerminate(_ notification: Notification) {
+        monitorTask?.cancel()
+    }
+
+    private func render(_ spaces: [FullScreenMonitor.SpaceInfo]) {
+        print("\n--- Fullscreen Spaces Updated ---")
+        if spaces.isEmpty {
+            print("No fullscreen applications detected.")
+        } else {
+            print("Detected fullscreen applications:")
+            for space in spaces {
+                let screenID = space.screenUUID ?? "Unknown"
+                let screenName = FullScreenMonitor.shared.screen(for: space)?.localizedName ?? "Unknown"
+
+                let apps = space.runningApps.isEmpty ? "Unknown" : space.runningApps.joined(separator: ", ")
+                print("- Screen UUID: \(screenID)")
+                print("- Screen Name: \(screenName)")
+                print("- Apps: \(apps)")
+            }
+        }
+        fflush(stdout)
+    }
+}

Examples/FullscreenDetectorExample.swift

@@ -1,4 +1,4 @@
-// swift-tools-version: 5.9
+// swift-tools-version: 6.1
 import PackageDescription
 
 let package = Package(
@@ -10,12 +10,16 @@ let package = Package(
         .library(
             name: "MacroVisionKit",
             targets: ["MacroVisionKit"]),
+        .executable(
+            name: "FullScreenMonitorExample",
+            targets: ["FullScreenMonitorExample"]),
     ],
     targets: [
         .target(
             name: "MacroVisionKit"),
-        .testTarget(
-            name: "MacroVisionKitTests",
-            dependencies: ["MacroVisionKit"]),
+        .executableTarget(
+            name: "FullScreenMonitorExample",
+            dependencies: ["MacroVisionKit"],
+            path: "Examples"),
     ]
 ) 

Package.swift

@@ -18,7 +18,7 @@ Add the following dependency to your `Package.swift` file:
 
 ```swift
 dependencies: [
-    .package(url: "https://github.com/TheBoredTeam/MacroVisionKit.git", from: "0.0.0")
+    .package(url: "https://github.com/TheBoredTeam/MacroVisionKit.git", from: "0.2.0")
 ]
 ```
 
@@ -29,39 +29,54 @@ dependencies: [
 ```swift
 import MacroVisionKit
 
-// Initialize the detector
-let detector = MacroVisionKit.shared
-let fullscreenApps = detector.detectFullscreenApps()
+// Initialize the monitor
+let monitor = FullScreenMonitor.shared
+
+// Get current Full Screen apps
+let fullScreenApps = monitor.detectFullscreenApps()
 
 // Process detection results
-fullscreenApps.forEach { appInfo in
-    print(appInfo.debugDescription)
+fullScreenApps.forEach { spaceInfo in
+    print(spaceInfo.debugDescription)
 }
 ```
 
-### Advanced Configuration
+### Real-time Updates
+
+Use the `spaceChanges()` method to get an asynchronous stream of fullscreen space updates:
 
 ```swift
-// Configure detection parameters
-var config = MacroVisionKit.Configuration()
-config.sizeTolerance = 0.15 // 15% tolerance threshold
-config.includeSystemApps = true
+import MacroVisionKit
+
+// Get the stream of space changes
+let monitor = FullScreenMonitor.shared
+let stream = await monitor.spaceChanges()
 
-// Apply configuration
-MacroVisionKit.shared.configuration = config
+// Process updates asynchronously
+for await fullScreenSpaces in stream {
+    print("Fullscreen spaces updated: \(fullScreenSpaces.count)")
+    fullScreenSpaces.forEach { spaceInfo in
+        print(spaceInfo.debugDescription)
+    }
+}
 ```
 
-### Diagnostic Mode
+### Testing with the Example
 
-```swift
-// Enable diagnostic output for detailed analysis
-let fullscreenApps = detector.detectFullscreenApps(debug: true)
-```
+To test the framework, you can run the included example application. First, ensure you have Swift installed on your macOS system.
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/TheBoredTeam/MacroVisionKit.git
+   cd MacroVisionKit
+   ```
 
-## Technical Requirements
+2. Build and run the example:
+   ```bash
+   swift run FullScreenMonitorExample
+   ```
 
-- macOS 10.15 or later
-- Swift 5.0 or later
+3. The example will start monitoring for fullscreen space changes. Open some applications in fullscreen mode to see the detection in action. Press `Ctrl+C` to exit.
 
 ## License