Yattee v2 rewrite

spec/ui/support/search_helper.rb

@@ -0,0 +1,259 @@
+# frozen_string_literal: true
+
+module UITest
+  # Helper for search functionality in UI tests.
+  # Provides methods to navigate to search, enter queries, and interact with results.
+  class SearchHelper
+    # Coordinates for iPhone 17 Pro (402pt width based on AXe frame data)
+    # On iOS 26+ with TabView role: .search, the search field is integrated into the tab bar
+    # Search field frame from AXe: {{88, 798}, {286, 48}} - center is approximately (231, 822)
+    SEARCH_FIELD_COORDS = { x: 231, y: 822 }.freeze
+    # Search tab is on the right side of the tab bar (bottom of screen)
+    # Tab bar is at approximately y=815, search tab is rightmost
+    SEARCH_TAB_COORDS = { x: 350, y: 815 }.freeze
+
+    def initialize(axe)
+      @axe = axe
+    end
+
+    # Navigate to Search tab
+    def navigate_to_search
+      # Try accessibility ID first, fall back to coordinates
+      begin
+        @axe.tap_id('tab.search')
+      rescue UITest::Axe::AxeError
+        # Tab accessibility IDs may not work on iOS 26+ tab bars
+        # Use coordinates to tap the search tab (rightmost tab)
+        puts '  Using coordinates to tap Search tab'
+        @axe.tap_coordinates(**SEARCH_TAB_COORDS)
+      end
+      sleep 1.0
+
+      # Debug: Take screenshot and dump elements to see what's visible
+      puts '  [DEBUG] After tapping search tab, checking visible elements...'
+      puts "  [DEBUG] text 'search.empty' visible? #{@axe.text_visible?('search.empty')}"
+      puts "  [DEBUG] text 'search.recents' visible? #{@axe.text_visible?('search.recents')}"
+      puts "  [DEBUG] text 'Search' visible? #{@axe.text_visible?('Search')}"
+
+      # Take debug screenshot
+      screenshot_path = @axe.screenshot('debug_after_search_tap')
+      puts "  [DEBUG] Screenshot saved to: #{screenshot_path}"
+
+      # Dump accessibility tree for debugging
+      puts '  [DEBUG] Dumping accessibility tree labels...'
+      tree = @axe.describe_ui
+      dump_labels(tree)
+      puts '  [DEBUG] End of accessibility tree'
+
+      # The search tab with role: .search on iOS 26+ integrates searchable into tab bar
+      # The SearchView content should be visible - try waiting for the search field or view
+      wait_for_search_ready
+    end
+
+    # Wait for search to be ready (search view, empty state, or recents visible)
+    def wait_for_search_ready(timeout: 10)
+      start_time = Time.now
+
+      loop do
+        # Check for various search view states using accessibility labels
+        # (accessibilityIdentifier doesn't work on Group/some SwiftUI views)
+        return true if @axe.text_visible?('search.empty')
+        return true if @axe.text_visible?('search.recents')
+
+        # Also check for the navigation title "Search" as fallback
+        return true if @axe.text_visible?('Search')
+
+        elapsed = Time.now - start_time
+        raise "Search not ready after #{timeout} seconds" if elapsed > timeout
+
+        sleep 0.3
+      end
+    end
+
+    # Check if search view is displayed (any state)
+    def search_visible?
+      @axe.text_visible?('search.empty') ||
+        @axe.text_visible?('search.recents') ||
+        @axe.text_visible?('Search')
+    end
+
+    # Perform a search query
+    # @param query [String] The search query to enter
+    def search(query)
+      puts "  Searching for: #{query}"
+
+      # First, check if this query exists in recent searches - if so, tap it directly
+      if @axe.text_visible?(query)
+        puts "  [DEBUG] Found '#{query}' in recent searches, tapping it"
+        @axe.tap_label(query)
+        sleep 1.0
+        @axe.screenshot('debug_after_recent_tap')
+        return
+      end
+
+      # Take screenshot before tapping search field
+      @axe.screenshot('debug_before_search_tap')
+
+      # Try to tap on search field by label first, fall back to coordinates
+      begin
+        @axe.tap_label('Videos, channels, playlists')
+        puts '  [DEBUG] Tapped search field by label'
+      rescue UITest::Axe::AxeError
+        puts '  [DEBUG] Label tap failed, using coordinates'
+        @axe.tap_coordinates(**SEARCH_FIELD_COORDS)
+      end
+      sleep 0.5
+
+      # Take screenshot after tapping search field
+      @axe.screenshot('debug_after_search_field_tap')
+
+      # Type the query
+      @axe.type(query)
+      sleep 0.3
+
+      # Take screenshot after typing
+      @axe.screenshot('debug_after_typing')
+
+      # Submit the search by pressing Return key
+      # Using hardware key press instead of typing \n which doesn't work in iOS 26+ searchable
+      @axe.press_return
+      sleep 1.0
+
+      # Take screenshot after submitting
+      screenshot_path = @axe.screenshot('debug_after_search_submit')
+      puts "  [DEBUG] After search submit: #{screenshot_path}"
+    end
+
+    # Wait for search results to appear
+    # @param timeout [Integer] Maximum time to wait in seconds
+    def wait_for_results(timeout: 30)
+      puts '  Waiting for search results...'
+      start_time = Time.now
+
+      loop do
+        # Check using accessibility labels (more reliable than identifiers)
+        return true if @axe.text_visible?('search.results')
+
+        # Check for no results or error states
+        return true if @axe.text_visible?('search.noResults')
+
+        elapsed = Time.now - start_time
+        if elapsed > timeout
+          # Take debug screenshot before failing
+          @axe.screenshot('debug_wait_for_results_timeout')
+          raise "Search results not found after #{timeout} seconds"
+        end
+
+        sleep 0.5
+      end
+    end
+
+    # Tap on a specific video by ID
+    # @param video_id [String] The video ID to tap
+    def tap_video(video_id)
+      puts "  Tapping video: #{video_id}"
+      @axe.tap_id("video.row.#{video_id}")
+      sleep 0.5
+    end
+
+    # Tap the first video result by coordinates (text area - opens info)
+    # Used when individual video rows aren't accessible via accessibility tree
+    def tap_first_result
+      puts '  Tapping first search result by coordinates'
+      # First result is below filter strip (y≈122) with padding
+      # Video row center is approximately y=230 for first result
+      @axe.tap_coordinates(x: 200, y: 230)
+      sleep 0.5
+    end
+
+    # Tap the first video thumbnail to start playback directly
+    # Thumbnail is on the left side of the video row
+    def tap_first_result_thumbnail
+      puts '  Tapping first search result thumbnail to play'
+      # First result thumbnail is at approximately:
+      # x: 100 (center of thumbnail on left side)
+      # y: 180 (first result row)
+      @axe.tap_coordinates(x: 100, y: 180)
+      sleep 0.5
+    end
+
+    # Check if a video exists in results
+    # @param video_id [String] The video ID to check
+    # @return [Boolean] true if the video exists in results
+    def video_exists?(video_id)
+      @axe.text_visible?("video.row.#{video_id}")
+    end
+
+    # Wait for a specific video to appear in results
+    # @param video_id [String] The video ID to wait for
+    # @param timeout [Integer] Timeout in seconds
+    def wait_for_video(video_id, timeout: 30)
+      puts "  Waiting for video: #{video_id}"
+      start_time = Time.now
+
+      loop do
+        return true if video_exists?(video_id)
+
+        elapsed = Time.now - start_time
+        if elapsed > timeout
+          @axe.screenshot('debug_wait_for_video_timeout')
+          raise "Video '#{video_id}' not found after #{timeout} seconds"
+        end
+
+        sleep 0.5
+      end
+    end
+
+    # Check if search results are displayed
+    # @return [Boolean] true if results are visible
+    def results_visible?
+      @axe.text_visible?('search.results')
+    end
+
+    # Check if no results message is displayed
+    # @return [Boolean] true if no results message is visible
+    def no_results_visible?
+      @axe.element_exists?('search.noResults')
+    end
+
+    # Check if search is loading
+    # @return [Boolean] true if loading indicator is visible
+    def loading?
+      @axe.element_exists?('search.loading')
+    end
+
+    private
+
+    # Wait for an element to appear
+    # @param identifier [String] Accessibility identifier
+    # @param timeout [Integer] Timeout in seconds
+    def wait_for_element(identifier, timeout: Config.element_timeout)
+      start_time = Time.now
+
+      loop do
+        return true if @axe.element_exists?(identifier)
+
+        raise "Element '#{identifier}' not found after #{timeout} seconds" if Time.now - start_time > timeout
+
+        sleep 0.3
+      end
+    end
+
+    # Debug helper to dump accessibility labels from tree
+    def dump_labels(node, depth = 0, max_depth = 10)
+      return if depth > max_depth
+
+      case node
+      when Hash
+        id = node['AXUniqueId']
+        label = node['AXLabel']
+        role = node['AXRole']
+        indent = '  ' * depth
+        puts "#{indent}[Role: #{role}] [ID: #{id}] [Label: #{label}]" if id || label || role
+        node.each_value { |v| dump_labels(v, depth + 1, max_depth) }
+      when Array
+        node.each { |item| dump_labels(item, depth, max_depth) }
+      end
+    end
+  end
+end