refactor(ios): extract snapshot presenter

Author: thymikee

apple/runner/AgentDeviceRunner/AgentDeviceRunner.xcodeproj/project.pbxproj

@@ -113,6 +113,7 @@
 			);
 			name = AgentDeviceRunnerUITests;
 			packageProductDependencies = (
+				A1B2C3D4E5F60718293A4B5D /* AgentDeviceSnapshotPresentation */,
 			);
 			productName = AgentDeviceRunnerUITests;
 			productReference = 20EA2EDD2F2CFC7C001CF0EF /* AgentDeviceRunnerUITests.xctest */;
@@ -146,6 +147,9 @@
 			);
 			mainGroup = 20EA2EBD2F2CFC7B001CF0EF;
 			minimizedProjectReferenceProxies = 1;
+			packageReferences = (
+				A1B2C3D4E5F60718293A4B5C /* XCLocalSwiftPackageReference "snapshot-presentation" */,
+			);
 			preferredProjectObjectVersion = 77;
 			productRefGroup = 20EA2EC72F2CFC7B001CF0EF /* Products */;
 			projectDirPath = "";
@@ -157,6 +161,21 @@
 		};
 /* End PBXProject section */
 
+/* Begin XCLocalSwiftPackageReference section */
+		A1B2C3D4E5F60718293A4B5C /* XCLocalSwiftPackageReference "snapshot-presentation" */ = {
+			isa = XCLocalSwiftPackageReference;
+			relativePath = ../../snapshot-presentation;
+		};
+/* End XCLocalSwiftPackageReference section */
+
+/* Begin XCSwiftPackageProductDependency section */
+		A1B2C3D4E5F60718293A4B5D /* AgentDeviceSnapshotPresentation */ = {
+			isa = XCSwiftPackageProductDependency;
+			package = A1B2C3D4E5F60718293A4B5C /* XCLocalSwiftPackageReference "snapshot-presentation" */;
+			productName = AgentDeviceSnapshotPresentation;
+		};
+/* End XCSwiftPackageProductDependency section */
+
 /* Begin PBXResourcesBuildPhase section */
 		20EA2EC42F2CFC7B001CF0EF /* Resources */ = {
 			isa = PBXResourcesBuildPhase;

apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSnapshotScopePolicy.swift

@@ -1,61 +1,5 @@
 import Foundation
-
-enum SnapshotScopeSelection: Equatable {
-  case unscoped
-  case matched(Int)
-  case missing
-}
-
-/// Cross-runtime snapshot scope specification.
-///
-/// A non-empty scope selects the first node in presentation preorder whose label, identifier, or
-/// value contains the trimmed query case-insensitively and whose subtree contributes to the
-/// requested projection. Missing matches publish an empty projection.
-enum SnapshotScopePolicy {
-  static func select<Node>(
-    fromPreorder nodes: [Node],
-    scope: String?,
-    depth: (Node) -> Int,
-    semanticValues: (Node) -> [String?],
-    subtreeContributes: (Range<Int>) -> Bool
-  ) -> SnapshotScopeSelection {
-    guard let query = normalized(scope) else { return .unscoped }
-    for (index, node) in nodes.enumerated() {
-      guard semanticValues(node).contains(where: { value in
-        value?.lowercased().contains(query) == true
-      }) else { continue }
-      let range = subtreeRange(from: index, in: nodes, depth: depth)
-      if subtreeContributes(range) {
-        return .matched(index)
-      }
-    }
-    return .missing
-  }
-
-  static func isActive(_ scope: String?) -> Bool {
-    normalized(scope) != nil
-  }
-
-  private static func normalized(_ scope: String?) -> String? {
-    guard let query = scope?.trimmingCharacters(in: .whitespacesAndNewlines), !query.isEmpty else {
-      return nil
-    }
-    return query.lowercased()
-  }
-
-  static func subtreeRange<Node>(
-    from start: Int,
-    in nodes: [Node],
-    depth: (Node) -> Int
-  ) -> Range<Int> {
-    let rootDepth = depth(nodes[start])
-    var end = start + 1
-    while end < nodes.count, depth(nodes[end]) > rootDepth {
-      end += 1
-    }
-    return start..<end
-  }
-}
+import AgentDeviceSnapshotPresentation
 
 #if AGENT_DEVICE_RUNNER_UNIT_TESTS
 private struct SnapshotScopeFixture: Decodable {

apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift

@@ -1,4 +1,5 @@
 import XCTest
+import AgentDeviceSnapshotPresentation
 
 extension RunnerTests {
   private static let privateAXSnapshotMaxNodes = 5_000

apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift

@@ -1,4 +1,5 @@
 import XCTest
+import AgentDeviceSnapshotPresentation
 
 #if AGENT_DEVICE_RUNNER_UNIT_TESTS && os(iOS)
 import ObjectiveC.runtime

apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandJournal.swift

@@ -1,5 +1,6 @@
 import Foundation
 import XCTest
+import AgentDeviceSnapshotPresentation
 
 enum RunnerCommandLifecycleState: String {
   case notAccepted

apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift

@@ -1,4 +1,5 @@
 import XCTest
+import AgentDeviceSnapshotPresentation
 
 #if os(macOS)
 import CoreGraphics

apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Models.swift

@@ -1,3 +1,5 @@
+import AgentDeviceSnapshotPresentation
+
 // MARK: - Wire Models
 
 enum CommandType: String, Codable {
@@ -277,24 +279,3 @@ struct ErrorPayload: Codable {
   let message: String
   var hint: String?
 }
-
-struct SnapshotRect: Codable {
-  let x: Double
-  let y: Double
-  let width: Double
-  let height: Double
-}
-
-struct PresentationOptions {
-  let interactiveOnly: Bool
-  let depth: Int?
-  let scope: String?
-  let raw: Bool
-  /// Internal daemon ask: capture with this backend first regardless of channel
-  /// health ("private-ax"). Same-backend evidence probes (tap-outcome
-  /// corroboration) must be captured the way their baseline was.
-  var preferredBackend: String? = nil
-  /// Read UIAccessibilityCustomActions for merged leaves. Opt-in: each element
-  /// costs its own AX round trip (see RunnerAXSnapshotBridge).
-  var customActions: Bool = false
-}

apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+PrivateAXPresentation.swift

@@ -1,4 +1,5 @@
 import XCTest
+import AgentDeviceSnapshotPresentation
 
 /// Reported facts for one private-AX element, read once so every consumer describes a node the
 /// same way.

apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Snapshot.swift

@@ -1,4 +1,5 @@
 import XCTest
+import AgentDeviceSnapshotPresentation
 
 extension RunnerTests {
   private static let axSnapshotErrorCode = "IOS_AX_SNAPSHOT_FAILED"