shoko 0.1.0

data/lib/shoko/adapters/output/ui/components/screens/browse_screen_component.rb

@@ -0,0 +1,319 @@
+# frozen_string_literal: true
+
+require_relative '../base_component'
+require_relative '../../constants/ui_constants'
+require_relative '../../../terminal/terminal_sanitizer.rb'
+require_relative '../ui/text_utils'
+require_relative '../ui/list_helpers'
+
+module Shoko
+  module Adapters::Output::Ui::Components
+    module Screens
+      # Browse screen component that renders the book browsing interface
+      class BrowseScreenComponent < BaseComponent
+        include Adapters::Output::Ui::Constants::UI
+        include UI::TextUtils
+
+        BookItemCtx = Struct.new(:row, :book, :selected, :layout, keyword_init: true)
+
+        def initialize(catalog_service, state)
+          super()
+          @catalog = catalog_service
+          @state = state
+          @filtered_epubs = []
+
+          # Observe state changes for search and selection
+          @state.add_observer(self, %i[menu browse_selected], %i[menu search_query],
+                              %i[menu search_active])
+        end
+
+        def state_changed(path, _old_value, _new_value)
+          case path
+          when %i[menu search_query]
+            filter_books
+          end
+        end
+
+        def filtered_epubs=(books)
+          @filtered_epubs = books || []
+        end
+
+        def selected
+          Shoko::Application::Selectors::MenuSelectors.browse_selected(@state)
+        end
+
+        def navigate(key)
+          return unless @filtered_epubs.any?
+
+          current = Shoko::Application::Selectors::MenuSelectors.browse_selected(@state)
+          max_index = @filtered_epubs.length - 1
+
+          new_selected = case key
+                         when :up then [current - 1, 0].max
+                         when :down then [current + 1, max_index].min
+                         else current
+                         end
+
+          @state.dispatch(Shoko::Application::Actions::UpdateMenuAction.new(browse_selected: new_selected))
+        end
+
+        def selected_book
+          browse_selected = Shoko::Application::Selectors::MenuSelectors.browse_selected(@state)
+          @filtered_epubs[browse_selected]
+        end
+
+        # Expose filtered list count for navigation logic integration
+        def filtered_count
+          (@filtered_epubs || []).length
+        end
+
+        # Expose random access by index (read-only)
+        def book_at(index)
+          (@filtered_epubs || [])[index]
+        end
+
+        def do_render(surface, bounds)
+          @filtered_epubs ||= []
+          layout = layout_metrics(bounds)
+
+          render_search(surface, bounds, layout)
+          render_status(surface, bounds, layout)
+
+          if @filtered_epubs.nil? || @filtered_epubs.empty?
+            render_empty_state(surface, bounds, layout)
+          else
+            render_books_list(surface, bounds, layout)
+          end
+        end
+
+        def preferred_height(_available_height)
+          :fill
+        end
+
+        private
+
+        def filter_books
+          query = Shoko::Application::Selectors::MenuSelectors.search_query(@state)
+          books = @catalog.entries || []
+          return @filtered_epubs = books if query.nil? || query.empty?
+
+          q = query.downcase
+          @filtered_epubs = books.select do |book|
+            name = book['name']&.downcase
+            author = book['author']&.downcase
+            name&.include?(q) || author&.include?(q)
+          end
+        end
+
+        def render_status(surface, bounds, layout)
+          total = @filtered_epubs&.length.to_i
+          status = @catalog.scan_status
+          message = Shoko::Adapters::Output::Terminal::TerminalSanitizer.sanitize(@catalog.scan_message.to_s,
+                                                                     preserve_newlines: false,
+                                                                     preserve_tabs: false)
+          status_row = layout[:status_row]
+          indent = layout[:indent]
+
+          count_text = "#{COLOR_TEXT_DIM}Found #{total} #{total == 1 ? 'book' : 'books'}#{Terminal::ANSI::RESET}"
+          surface.write(bounds, status_row, indent, count_text)
+
+          return unless status
+
+          status_text = case status
+                        when :scanning then "#{COLOR_TEXT_WARNING}⟳ #{message}#{Terminal::ANSI::RESET}"
+                        when :error    then "#{COLOR_TEXT_ERROR}✗ #{message}#{Terminal::ANSI::RESET}"
+                        when :done     then "#{COLOR_TEXT_SUCCESS}✓ #{message}#{Terminal::ANSI::RESET}"
+                        else ''
+                        end
+          return if status_text.empty?
+
+          offset = Shoko::Adapters::Output::Terminal::TextMetrics.visible_length(count_text)
+          surface.write(bounds, status_row, indent + offset + 2, status_text)
+        end
+
+        def render_empty_state(surface, bounds, layout)
+          status = @catalog.scan_status
+          empty_text = if status == :scanning
+                         "#{COLOR_TEXT_WARNING}⟳ Scanning for books...#{Terminal::ANSI::RESET}"
+                       else
+                         "#{COLOR_TEXT_DIM}No matching books#{Terminal::ANSI::RESET}"
+                       end
+          row = (bounds.height / 2).clamp(layout[:list_start_row], bounds.bottom - 2)
+          surface.write(bounds, row, layout[:indent], empty_text)
+        end
+
+        def render_books_list(surface, bounds, layout)
+          list_start_row = layout[:list_start_row]
+          list_height = bounds.height - list_start_row - 2
+          return if list_height <= 0
+
+          selected = Shoko::Application::Selectors::MenuSelectors.browse_selected(@state)
+          start_index, visible_books = UI::ListHelpers.slice_visible(@filtered_epubs, list_height, selected)
+
+          draw_list_header(surface, bounds, layout, layout[:header_row])
+          current_row = list_start_row
+
+          loading_path = @state.get(%i[menu loading_path])
+          loading_active = @state.get(%i[menu loading_active])
+          loading_progress = (@state.get(%i[menu loading_progress]) || 0.0).to_f
+          loading_message = @state.get(%i[menu loading_message])
+
+          visible_books.each_with_index do |book, index|
+            is_selected = (start_index + index) == selected
+            ctx = BookItemCtx.new(row: current_row, book: book, selected: is_selected, layout: layout)
+            render_book_item(surface, bounds, ctx)
+
+            progress_row = current_row + 1
+            if loading_active && loading_path == book['path'] && progress_row <= bounds.bottom
+              rows_used = draw_inline_progress(surface, bounds, layout, progress_row, loading_progress, loading_message)
+              current_row += 1 + rows_used
+            else
+              current_row += 1
+            end
+          end
+        end
+
+        def render_book_item(surface, bounds, ctx)
+          book = ctx.book
+          path = book['path']
+          meta = @catalog.metadata_for(path)
+
+          title = (meta[:title] || book['name'] || 'Unknown').to_s
+          size_mb = format_size(book['size'] || @catalog.size_for(path))
+
+          # Compute column widths
+          layout = ctx.layout
+          cols = layout[:columns]
+          gap = ' ' * layout[:gap]
+          title_width = cols[:title]
+          size_width = cols[:size]
+
+          title_col = pad_right(truncate_text(title, title_width), title_width)
+          size_col = pad_left(size_mb, size_width)
+
+          line = [title_col, size_col].join(gap)
+          row = ctx.row
+          indent = layout[:indent]
+
+          content = if ctx.selected
+                      Terminal::ANSI::BOLD + COLOR_TEXT_ACCENT + line + Terminal::ANSI::RESET
+                    else
+                      COLOR_TEXT_PRIMARY + line + Terminal::ANSI::RESET
+                    end
+          surface.write(bounds, row, indent, content)
+        end
+
+        def draw_list_header(surface, bounds, layout, row)
+          return if row < 5
+
+          indent = layout[:indent]
+          content_width = layout[:content_width]
+          cols = layout[:columns]
+          gap = ' ' * layout[:gap]
+          headers = [
+            pad_right('Title', cols[:title]),
+            pad_left('Size', cols[:size]),
+          ].join(gap)
+
+          header_style = Terminal::ANSI::BOLD + Terminal::ANSI::LIGHT_GREY
+          padded_headers = pad_right(headers, content_width)
+          surface.write(bounds, row, indent, header_style + padded_headers + Terminal::ANSI::RESET)
+          # Divider line
+          divider = ('─' * [content_width, 1].max)
+          surface.write(bounds, row + 1, indent, COLOR_TEXT_DIM + divider + Terminal::ANSI::RESET)
+        end
+
+        def format_size(bytes)
+          mb = (bytes.to_f / (1024 * 1024)).round(1)
+          format('%.1f MB', mb)
+        end
+
+        def draw_inline_progress(surface, bounds, layout, row, progress, message)
+          return 0 if row > bounds.bottom
+
+          rows_used = 0
+          indent = layout[:indent]
+          content_width = layout[:content_width]
+          message_text = message.to_s.strip
+
+          unless message_text.empty?
+            truncated = Shoko::Adapters::Output::Terminal::TextMetrics.truncate_to(message_text, content_width)
+            surface.write(bounds, row, indent, "#{COLOR_TEXT_DIM}#{truncated}#{Terminal::ANSI::RESET}")
+            rows_used += 1
+            row += 1
+            return rows_used if row > bounds.bottom
+          end
+
+          bar_col = layout[:indent]
+          usable = [layout[:content_width], 10].max
+          filled = (usable * progress.to_f.clamp(0.0, 1.0)).round
+          accent = Terminal::ANSI::BRIGHT_GREEN
+          dim = Terminal::ANSI::DIM
+          reset = Terminal::ANSI::RESET
+          track = accent + ('━' * filled) + reset
+          track << (dim + ('━' * (usable - filled)) + reset) if filled < usable
+          surface.write(bounds, row, bar_col, track)
+          rows_used + 1
+        end
+
+        def render_search(surface, bounds, layout)
+          row = layout[:search_row]
+          indent = layout[:indent]
+
+          surface.write(bounds, row, indent, "#{COLOR_TEXT_DIM}Search#{Terminal::ANSI::RESET}")
+
+          search_query = Shoko::Application::Selectors::MenuSelectors.search_query(@state)
+          search_display = search_query.dup
+          cursor_pos = Shoko::Application::Selectors::MenuSelectors.search_cursor(@state)
+          cursor_pos = cursor_pos.to_i.clamp(0, search_display.length)
+          search_display.insert(cursor_pos, '_')
+          field_text = pad_right(search_display, layout[:content_width])
+
+          surface.write(bounds, row + 1, indent,
+                        "#{SELECTION_HIGHLIGHT}#{field_text}#{Terminal::ANSI::RESET}")
+        end
+
+        def layout_metrics(bounds)
+          height = bounds.height
+          width  = bounds.width
+          row_base = height / 6
+
+          base_width = [width - 8, 72].min
+          column_spec = column_layout(base_width)
+          content_width = column_spec[:content_width]
+          indent = ((width - content_width) / 2).floor
+          indent = indent.clamp(2, width / 3)
+
+          {
+            indent: indent,
+            content_width: content_width,
+            columns: column_spec[:columns],
+            gap: column_spec[:gap],
+            search_row: [row_base, 2].max,
+            status_row: [row_base + 2, 4].max,
+            header_row: [row_base + 4, 6].max,
+            list_start_row: [row_base + 6, 8].max,
+          }
+        end
+
+        def column_layout(content_width)
+          gap = 4
+          size_w = 8
+          title_w = [content_width - size_w - gap, 24].max
+          content_width = title_w + size_w + gap
+
+          {
+            content_width: content_width,
+            columns: {
+              title: title_w,
+              size: size_w,
+            },
+            gap: gap,
+          }
+        end
+
+        # truncate_text provided by UI::TextUtils
+      end
+    end
+  end
+end

data/lib/shoko/adapters/output/ui/components/screens/download_books_screen_component.rb

@@ -0,0 +1,340 @@
+# frozen_string_literal: true
+
+require_relative '../base_component'
+require_relative '../../constants/ui_constants'
+require_relative '../../../terminal/text_metrics.rb'
+require_relative '../../../terminal/terminal_sanitizer.rb'
+require_relative '../ui/text_utils'
+require_relative '../ui/list_helpers'
+
+module Shoko
+  module Adapters::Output::Ui::Components
+    module Screens
+      # Centralized download screen for Gutendex search + download flow.
+      class DownloadBooksScreenComponent < BaseComponent
+        include Adapters::Output::Ui::Constants::UI
+        include UI::TextUtils
+
+        BookItemCtx = Struct.new(:row, :book, :selected, :layout, keyword_init: true)
+
+        def initialize(state)
+          super()
+          @state = state
+        end
+
+        def do_render(surface, bounds)
+          layout = layout_metrics(bounds)
+
+          render_header(surface, bounds, layout)
+          render_search(surface, bounds, layout)
+          render_status(surface, bounds, layout)
+          render_results(surface, bounds, layout)
+          render_footer(surface, bounds, layout)
+        end
+
+        def preferred_height(_available_height)
+          :fill
+        end
+
+        private
+
+        def results
+          Array(@state.get(%i[menu download_results]))
+        end
+
+        def selected_index
+          (@state.get(%i[menu download_selected]) || 0).to_i
+        end
+
+        def download_status
+          (@state.get(%i[menu download_status]) || :idle).to_sym
+        end
+
+        def download_message
+          @state.get(%i[menu download_message]).to_s
+        end
+
+        def download_count
+          (@state.get(%i[menu download_count]) || 0).to_i
+        end
+
+        def download_progress
+          (@state.get(%i[menu download_progress]) || 0.0).to_f
+        end
+
+        def search_query
+          @state.get(%i[menu download_query]) || ''
+        end
+
+        def search_cursor
+          cursor = @state.get(%i[menu download_cursor])
+          cursor ? cursor.to_i : search_query.length
+        end
+
+        def search_active?
+          @state.get(%i[menu mode]) == :download_search
+        end
+
+        def render_header(surface, bounds, layout)
+          title_plain = 'Download Books'
+          reset = Terminal::ANSI::RESET
+          surface.write(bounds, layout[:header_row], layout[:indent],
+                        "#{COLOR_TEXT_ACCENT}#{title_plain}#{reset}")
+        end
+
+        def render_search(surface, bounds, layout)
+          row = layout[:search_row]
+          indent = layout[:indent]
+          reset = Terminal::ANSI::RESET
+
+          surface.write(bounds, row, indent, "#{COLOR_TEXT_DIM}Search Gutendex#{reset}")
+
+          query = search_query.dup
+          cursor = search_cursor.clamp(0, query.length)
+          query.insert(cursor, '_')
+          field_text = pad_right(query, layout[:content_width])
+
+          style = search_active? ? SELECTION_HIGHLIGHT : COLOR_TEXT_DIM
+          surface.write(bounds, row + 1, indent, "#{style}#{field_text}#{reset}")
+        end
+
+        def render_status(surface, bounds, layout)
+          row = layout[:status_row]
+          indent = layout[:indent]
+          reset = Terminal::ANSI::RESET
+
+          shown = results.length
+          total = download_count
+          count_text = if total.positive? && total != shown
+                         "#{COLOR_TEXT_DIM}Showing #{shown} of #{total}#{reset}"
+                       else
+                         "#{COLOR_TEXT_DIM}Found #{shown} #{shown == 1 ? 'book' : 'books'}#{reset}"
+                       end
+          surface.write(bounds, row, indent, count_text)
+
+          status_text, color = status_label
+          return if status_text.empty?
+
+          offset = Shoko::Adapters::Output::Terminal::TextMetrics.visible_length(count_text)
+          surface.write(bounds, row, indent + offset + 2, "#{color}#{status_text}#{reset}")
+
+          render_progress(surface, bounds, layout) if download_progress.positive?
+        end
+
+        def render_progress(surface, bounds, layout)
+          row = layout[:progress_row]
+          return if row > bounds.bottom
+
+          indent = layout[:indent]
+          content_width = layout[:content_width]
+          usable = [content_width, 10].max
+          filled = (usable * download_progress.clamp(0.0, 1.0)).round
+
+          accent = Terminal::ANSI::BRIGHT_GREEN
+          dim = Terminal::ANSI::DIM
+          reset = Terminal::ANSI::RESET
+          track = accent + ('=' * filled) + reset
+          track << (dim + ('-' * (usable - filled)) + reset) if filled < usable
+          surface.write(bounds, row, indent, track)
+        end
+
+        def render_results(surface, bounds, layout)
+          items = results
+          if items.empty?
+            render_empty_state(surface, bounds, layout)
+          else
+            render_results_list(surface, bounds, layout, items)
+          end
+        end
+
+        def render_empty_state(surface, bounds, layout)
+          row = (bounds.height / 2).clamp(layout[:list_start_row], bounds.bottom - 2)
+          message = empty_state_message
+          surface.write(bounds, row, layout[:indent], message)
+        end
+
+        def empty_state_message
+          reset = Terminal::ANSI::RESET
+          case download_status
+          when :searching
+            "#{COLOR_TEXT_WARNING}Searching Gutendex...#{reset}"
+          when :error
+            "#{COLOR_TEXT_ERROR}#{safe_text(download_message)}#{reset}"
+          else
+            if search_query.strip.empty?
+              "#{COLOR_TEXT_DIM}Type to search and press Enter#{reset}"
+            else
+              "#{COLOR_TEXT_DIM}No results for your search#{reset}"
+            end
+          end
+        end
+
+        def render_results_list(surface, bounds, layout, items)
+          list_start_row = layout[:list_start_row]
+          list_height = bounds.height - list_start_row - 3
+          return if list_height <= 0
+
+          selected = selected_index
+          start_index, visible = UI::ListHelpers.slice_visible(items, list_height, selected)
+
+          draw_list_header(surface, bounds, layout, layout[:header_row_list])
+
+          current_row = list_start_row
+          visible.each_with_index do |book, index|
+            is_selected = (start_index + index) == selected
+            ctx = BookItemCtx.new(row: current_row, book: book, selected: is_selected, layout: layout)
+            render_book_item(surface, bounds, ctx)
+            current_row += 1
+            break if current_row > bounds.bottom
+          end
+        end
+
+        def render_book_item(surface, bounds, ctx)
+          book = ctx.book
+          layout = ctx.layout
+          cols = layout[:columns]
+          gap = ' ' * layout[:gap]
+
+          title = safe_text(value_for(book, :title, 'title', 'Untitled'))
+          authors = Array(value_for(book, :authors, 'authors', [])).join(', ')
+          authors = safe_text(authors)
+          languages = Array(value_for(book, :languages, 'languages', [])).map(&:to_s).join(',')
+          languages = safe_text(languages)
+          downloads = value_for(book, :download_count, 'download_count', 0).to_i
+
+          title_col = pad_right(truncate_text(title, cols[:title]), cols[:title])
+          author_col = pad_right(truncate_text(authors, cols[:author]), cols[:author])
+          lang_col = pad_right(truncate_text(languages, cols[:lang]), cols[:lang])
+          dl_col = pad_left(downloads.to_s, cols[:downloads])
+
+          line = [title_col, author_col, lang_col, dl_col].join(gap)
+
+          content = if ctx.selected
+                      Terminal::ANSI::BOLD + COLOR_TEXT_ACCENT + line + Terminal::ANSI::RESET
+                    else
+                      COLOR_TEXT_PRIMARY + line + Terminal::ANSI::RESET
+                    end
+          surface.write(bounds, ctx.row, layout[:indent], content)
+        end
+
+        def draw_list_header(surface, bounds, layout, row)
+          return if row < 5
+
+          indent = layout[:indent]
+          content_width = layout[:content_width]
+          cols = layout[:columns]
+          gap = ' ' * layout[:gap]
+
+          headers = [
+            pad_right('Title', cols[:title]),
+            pad_right('Author', cols[:author]),
+            pad_right('Lang', cols[:lang]),
+            pad_left('DLs', cols[:downloads]),
+          ].join(gap)
+
+          header_style = Terminal::ANSI::BOLD + Terminal::ANSI::LIGHT_GREY
+          padded = pad_right(headers, content_width)
+          surface.write(bounds, row, indent, header_style + padded + Terminal::ANSI::RESET)
+          divider = ('-' * [content_width, 1].max)
+          surface.write(bounds, row + 1, indent, COLOR_TEXT_DIM + divider + Terminal::ANSI::RESET)
+        end
+
+        def render_footer(surface, bounds, layout)
+          row = layout[:footer_row]
+          return if row > bounds.bottom
+
+          reset = Terminal::ANSI::RESET
+          hint = if search_active?
+                   '[Enter] Search  [/ or ESC] Back'
+                 else
+                   '[Enter] Download  [/] Search  [N/P] Page  [ESC] Back'
+                 end
+          clipped = Shoko::Adapters::Output::Terminal::TextMetrics.truncate_to(hint, layout[:content_width])
+          surface.write(bounds, row, layout[:indent], "#{COLOR_TEXT_DIM}#{clipped}#{reset}")
+        end
+
+        def status_label
+          msg = safe_text(download_message)
+          case download_status
+          when :searching
+            [msg.empty? ? 'Searching...' : msg, COLOR_TEXT_WARNING]
+          when :downloading
+            [msg.empty? ? 'Downloading...' : msg, COLOR_TEXT_WARNING]
+          when :error
+            [msg.empty? ? 'Request failed' : msg, COLOR_TEXT_ERROR]
+          when :done
+            [msg, COLOR_TEXT_SUCCESS]
+          else
+            ['', COLOR_TEXT_DIM]
+          end
+        end
+
+        def value_for(book, key_sym, key_str, default)
+          return book[key_sym] if book.respond_to?(:key?) && book.key?(key_sym)
+          return book[key_str] if book.respond_to?(:key?) && book.key?(key_str)
+
+          default
+        end
+
+        def safe_text(text)
+          Shoko::Adapters::Output::Terminal::TerminalSanitizer.sanitize(text.to_s, preserve_newlines: false,
+                                                                      preserve_tabs: false)
+        end
+
+        def layout_metrics(bounds)
+          height = bounds.height
+          width = bounds.width
+          row_base = height / 6
+
+          base_width = [width - 8, 86].min
+          column_spec = column_layout(base_width)
+          content_width = column_spec[:content_width]
+          indent = ((width - content_width) / 2).floor
+          indent = indent.clamp(2, width / 3)
+
+          header_row = [row_base - 2, 1].max
+          search_row = [row_base, header_row + 2].max
+          status_row = search_row + 2
+          progress_row = status_row + 1
+          header_row_list = status_row + 2
+          list_start_row = header_row_list + 2
+          footer_row = [height - 2, list_start_row + 2].max
+
+          {
+            indent: indent,
+            content_width: content_width,
+            columns: column_spec[:columns],
+            gap: column_spec[:gap],
+            header_row: header_row,
+            search_row: search_row,
+            status_row: status_row,
+            progress_row: progress_row,
+            header_row_list: header_row_list,
+            list_start_row: list_start_row,
+            footer_row: footer_row,
+          }
+        end
+
+        def column_layout(content_width)
+          gap = 3
+          downloads_w = 6
+          lang_w = 6
+          author_w = 18
+          title_w = [content_width - (downloads_w + lang_w + author_w + (gap * 3)), 16].max
+          content_width = title_w + author_w + lang_w + downloads_w + (gap * 3)
+
+          {
+            content_width: content_width,
+            columns: {
+              title: title_w,
+              author: author_w,
+              lang: lang_w,
+              downloads: downloads_w,
+            },
+            gap: gap,
+          }
+        end
+      end
+    end
+  end
+end