shoko 0.1.0

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

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require_relative '../base_component'
+require_relative '../../constants/ui_constants'
+require_relative '../../../terminal/terminal_sanitizer.rb'
+require_relative '../ui/box_drawer'
+require_relative 'annotation_rendering_helpers'
+
+module Shoko
+  module Adapters::Output::Ui::Components
+    module Screens
+      # Detailed view for a single annotation selected from the list
+      class AnnotationDetailScreenComponent < BaseComponent
+        include Adapters::Output::Ui::Constants::UI
+        include UI::BoxDrawer
+
+        # Rendering context for this screen to avoid parameter clumps.
+        RenderContext = Struct.new(
+          :surface,
+          :bounds,
+          :width,
+          :height,
+          :reset,
+          :annotation,
+          :book_label,
+          keyword_init: true
+        )
+
+        def initialize(state)
+          super()
+          @state = state
+          @render_context = nil
+        end
+
+        def do_render(surface, bounds)
+          @render_context = build_context(surface, bounds)
+          render_header
+          return render_empty(context.surface, context.bounds) unless context.annotation
+
+          render_body
+        ensure
+          @render_context = nil
+        end
+
+        def preferred_height(_available_height)
+          :fill
+        end
+
+        private
+
+        def build_context(surface, bounds)
+          annotation = selected_annotation
+          RenderContext.new(
+            surface: surface,
+            bounds: bounds,
+            width: bounds.width,
+            height: bounds.height,
+            reset: Terminal::ANSI::RESET,
+            annotation: annotation ? AnnotationView.new(annotation) : nil,
+            book_label: resolve_book_label
+          )
+        end
+
+        def resolve_book_label
+          book_path = @state.get(%i[menu selected_annotation_book])
+          return 'Unknown Book' unless book_path
+
+          raw = File.basename(book_path)
+          Shoko::Adapters::Output::Terminal::TerminalSanitizer.sanitize(
+            raw,
+            preserve_newlines: false,
+            preserve_tabs: false
+          )
+        end
+
+        def render_header
+          title_width = render_title
+          render_actions(title_width)
+          render_divider
+        end
+
+        def render_title
+          title_plain = "📝 Annotation • #{context.book_label}"
+          title_width = Shoko::Adapters::Output::Terminal::TextMetrics.visible_length(title_plain)
+          title = "#{COLOR_TEXT_ACCENT}#{title_plain}#{context.reset}"
+          context.surface.write(context.bounds, 1, 2, title)
+          title_width
+        end
+
+        def render_actions(title_width)
+          actions_plain = '[o] Open • [e] Edit • [d] Delete • [ESC] Back'
+          actions_col = actions_column(title_width, actions_plain)
+          context.surface.write(
+            context.bounds,
+            1,
+            actions_col,
+            "#{COLOR_TEXT_DIM}#{actions_plain}#{context.reset}"
+          )
+        end
+
+        def render_divider
+          context.surface.write(
+            context.bounds,
+            2,
+            1,
+            COLOR_TEXT_DIM + ('─' * context.width) + context.reset
+          )
+        end
+
+        def actions_column(title_width, actions_plain)
+          actions_width = Shoko::Adapters::Output::Terminal::TextMetrics.visible_length(actions_plain)
+          min_actions_col = 2 + title_width + 2
+          right_actions_col = context.width - actions_width
+          [right_actions_col, min_actions_col].max
+        end
+
+        def render_metadata
+          annotation = context.annotation
+          page_meta = annotation.page_meta
+          meta_line = [
+            "Ch: #{annotation.chapter_index || '-'}",
+            page_meta && "Page: #{page_meta}",
+            "Saved: #{annotation.formatted_date}",
+          ].compact.join('   ')
+          context.surface.write(
+            context.bounds,
+            3,
+            2,
+            COLOR_TEXT_DIM + meta_line + context.reset
+          )
+        end
+
+        def render_body
+          render_metadata
+          text_box = selected_text_box
+          render_text_box(text_box)
+          render_text_box(note_box(text_box))
+        end
+
+        def selected_text_box
+          AnnotationTextBox.new(
+            row: 5,
+            height: [context.height * 0.35, 8].max.to_i,
+            width: context.width - 4,
+            label: 'Selected Text',
+            text: context.annotation.text
+          )
+        end
+
+        def note_box(text_box)
+          text_box.next_box(
+            total_height: context.height,
+            label: 'Note',
+            text: context.annotation.note
+          )
+        end
+
+        def render_text_box(box)
+          box.render(context, drawer: self, color_prefix: COLOR_TEXT_PRIMARY)
+        end
+
+        def context
+          @render_context
+        end
+
+        def selected_annotation
+          ann = @state.get(%i[menu selected_annotation])
+          ann if ann.is_a?(Hash)
+        end
+
+        # draw_box and wrap_text are provided by included UI modules
+      end
+    end
+  end
+end

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

@@ -0,0 +1,221 @@
+# frozen_string_literal: true
+
+require_relative '../base_component'
+require_relative '../../constants/ui_constants'
+require_relative '../../../terminal/terminal_sanitizer.rb'
+require_relative '../ui/box_drawer'
+require_relative 'annotation_rendering_helpers'
+
+module Shoko
+  module Adapters::Output::Ui::Components
+    module Screens
+      # Simple annotation note editor within the menu (no book load)
+      class AnnotationEditScreenComponent < BaseComponent
+        include Adapters::Output::Ui::Constants::UI
+        include UI::BoxDrawer
+
+        attr_reader :edit_state
+
+        # Rendering context for this screen to avoid parameter clumps.
+        RenderContext = Struct.new(
+          :surface,
+          :bounds,
+          :width,
+          :height,
+          :reset,
+          :annotation,
+          :book_label,
+          keyword_init: true
+        )
+
+        def initialize(state, dependencies = nil)
+          super(dependencies)
+          @state = state
+          @dependencies = dependencies
+          @render_context = nil
+          @edit_state = AnnotationEditState.new(@state)
+        end
+
+        def do_render(surface, bounds)
+          @render_context = build_context(surface, bounds)
+          render_header
+          render_body
+          render_footer
+        ensure
+          @render_context = nil
+        end
+
+        def preferred_height(_available_height)
+          :fill
+        end
+
+        # --- Unified editor API (used by Application::Commands) ---
+        def save_annotation
+          payload = edit_state.annotation_update_payload
+          return unless payload
+
+          persist_annotation(payload)
+          edit_state.return_to_annotations_list
+        end
+
+        def handle_backspace
+          edit_state.update_from do |text, cursor|
+            next nil if cursor <= 0
+
+            prev_cursor = cursor - 1
+            [text[0...prev_cursor] + text[(prev_cursor + 1)..].to_s, prev_cursor]
+          end
+        end
+
+        def handle_enter
+          edit_state.update_from do |text, cursor|
+            new_text = text.dup
+            new_text.insert(cursor, "\n")
+            [new_text, cursor + 1]
+          end
+        end
+
+        def handle_character(char)
+          return unless Shoko::Adapters::Output::Terminal::TerminalSanitizer.printable_char?(char.to_s)
+
+          edit_state.update_from do |text, cursor|
+            new_text = text.dup
+            new_text.insert(cursor, char)
+            [new_text, cursor + 1]
+          end
+        end
+
+        private
+
+        def build_context(surface, bounds)
+          annotation = edit_state.selected_annotation
+          RenderContext.new(
+            surface: surface,
+            bounds: bounds,
+            width: bounds.width,
+            height: bounds.height,
+            reset: Terminal::ANSI::RESET,
+            annotation: AnnotationView.new(annotation || {}),
+            book_label: resolve_book_label
+          )
+        end
+
+        def resolve_book_label
+          book_path = @state.get(%i[menu selected_annotation_book])
+          return 'Unknown Book' unless book_path
+
+          raw = File.basename(book_path)
+          Shoko::Adapters::Output::Terminal::TerminalSanitizer.sanitize(
+            raw,
+            preserve_newlines: false,
+            preserve_tabs: false
+          )
+        end
+
+        def render_header
+          title_width = render_title
+          render_hint(title_width)
+          render_divider
+        end
+
+        def render_title
+          title_plain = "📝 Edit Annotation • #{context.book_label}"
+          title_width = Shoko::Adapters::Output::Terminal::TextMetrics.visible_length(title_plain)
+          title = "#{COLOR_TEXT_ACCENT}#{title_plain}#{context.reset}"
+          context.surface.write(context.bounds, 1, 2, title)
+          title_width
+        end
+
+        def render_hint(title_width)
+          hint_plain = '[Ctrl+S] Save • [ESC] Cancel'
+          hint_col = hint_column(title_width, hint_plain)
+          context.surface.write(
+            context.bounds,
+            1,
+            hint_col,
+            "#{COLOR_TEXT_DIM}#{hint_plain}#{context.reset}"
+          )
+        end
+
+        def render_divider
+          context.surface.write(
+            context.bounds,
+            2,
+            1,
+            COLOR_TEXT_DIM + ('─' * context.width) + context.reset
+          )
+        end
+
+        def hint_column(title_width, hint_plain)
+          hint_width = Shoko::Adapters::Output::Terminal::TextMetrics.visible_length(hint_plain)
+          min_hint_col = 2 + title_width + 2
+          right_hint_col = context.width - hint_width
+          [right_hint_col, min_hint_col].max
+        end
+
+        def render_body
+          text_box = snippet_box
+          render_text_box(text_box)
+          render_note_box(note_box(text_box))
+        end
+
+        def render_footer
+          context.surface.write(
+            context.bounds,
+            context.height - 1,
+            2,
+            "#{COLOR_TEXT_DIM}[Type] to edit • [Backspace] delete • [Enter] newline#{context.reset}"
+          )
+        end
+
+        def snippet_box
+          AnnotationTextBox.new(
+            row: 4,
+            height: [context.height * 0.25, 6].max.to_i,
+            width: context.width - 4,
+            label: 'Selected Text',
+            text: context.annotation.text
+          )
+        end
+
+        def note_box(text_box)
+          text_box.next_box(
+            total_height: context.height,
+            label: 'Note (editable)',
+            text: edit_state.text
+          )
+        end
+
+        def render_text_box(box)
+          box.render(context, drawer: self, color_prefix: COLOR_TEXT_PRIMARY)
+        end
+
+        def render_note_box(box)
+          render_text_box(box)
+          render_cursor(box)
+        end
+
+        def render_cursor(box)
+          cursor = edit_state.cursor(box.text)
+          row, col = box.cursor_position(cursor)
+          context.surface.write(context.bounds, row, col, "#{SELECTION_HIGHLIGHT}_#{context.reset}")
+        end
+
+        def persist_annotation(payload)
+          service = @dependencies&.resolve(:annotation_service)
+          return unless service
+
+          path, ann_id, text = payload.values_at(:path, :ann_id, :text)
+          service.update(path, ann_id, text)
+          edit_state.refresh_annotations(service)
+        rescue StandardError
+          nil
+        end
+
+        def context
+          @render_context
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,205 @@
+# frozen_string_literal: true
+
+require_relative '../base_component'
+require_relative '../../constants/ui_constants'
+require_relative '../ui/box_drawer'
+require_relative 'annotation_rendering_helpers'
+
+module Shoko
+  module Adapters::Output::Ui::Components
+    module Screens
+      # Reader-context annotation editor as a proper component
+      # Replaces ReaderModes::AnnotationEditorMode
+      class AnnotationEditorScreenComponent < BaseComponent
+        include Adapters::Output::Ui::Constants::UI
+        include UI::BoxDrawer
+
+        # Rendering context for this screen to avoid parameter clumps.
+        RenderContext = Struct.new(
+          :surface,
+          :bounds,
+          :width,
+          :height,
+          :reset,
+          :selected_text,
+          :note_text,
+          keyword_init: true
+        )
+
+        def initialize(ui_controller, text: nil, range: nil, annotation: nil, chapter_index: nil,
+                       dependencies: nil)
+          super(dependencies)
+          @ui = ui_controller
+          @dependencies = dependencies
+          @annotation = annotation
+          @selected_text = (text || annotation&.fetch('text', '') || '').dup
+          @note = (annotation&.fetch('note', '') || '').dup
+          @range = range || annotation&.fetch('range')
+          @chapter_index = chapter_index || annotation&.fetch('chapter_index')
+          @cursor_pos = @note.length
+          @is_editing = !annotation.nil?
+          @render_context = nil
+        end
+
+        def do_render(surface, bounds)
+          @render_context = build_context(surface, bounds)
+          render_header
+          render_body
+          render_footer
+        ensure
+          @render_context = nil
+        end
+
+        # Public API used by InputController bindings
+        def save_annotation
+          path = @ui.current_book_path
+          service = @dependencies&.resolve(:annotation_service)
+          return unless path && service
+
+          persist_annotation(service, path)
+          finalize_save
+        end
+
+        def handle_backspace
+          return unless @cursor_pos.positive?
+
+          @note.slice!(@cursor_pos - 1)
+          @cursor_pos -= 1
+        end
+
+        def handle_enter
+          @note.insert(@cursor_pos, "\n")
+          @cursor_pos += 1
+        end
+
+        def handle_character(key)
+          ord = key.ord
+          return unless key.to_s.length == 1 && ord >= 32 && ord < 127
+
+          @note.insert(@cursor_pos, key)
+          @cursor_pos += 1
+        end
+
+        private
+
+        def build_context(surface, bounds)
+          RenderContext.new(
+            surface: surface,
+            bounds: bounds,
+            width: bounds.width,
+            height: bounds.height,
+            reset: Terminal::ANSI::RESET,
+            selected_text: @selected_text.to_s.tr("\n", ' '),
+            note_text: @note.to_s
+          )
+        end
+
+        def render_header
+          title_width = render_title
+          render_hint(title_width)
+          render_divider
+        end
+
+        def render_title
+          title_plain = @is_editing ? 'Editing Annotation' : 'Creating Annotation'
+          title = "#{COLOR_TEXT_ACCENT}#{title_plain}#{context.reset}"
+          context.surface.write(context.bounds, 1, 2, title)
+          Shoko::Adapters::Output::Terminal::TextMetrics.visible_length(title_plain)
+        end
+
+        def render_hint(title_width)
+          hint_plain = '[Ctrl+S] Save • [ESC] Cancel'
+          hint_col = hint_column(title_width, hint_plain)
+          context.surface.write(
+            context.bounds,
+            1,
+            hint_col,
+            "#{COLOR_TEXT_DIM}#{hint_plain}#{context.reset}"
+          )
+        end
+
+        def render_divider
+          context.surface.write(
+            context.bounds,
+            2,
+            1,
+            COLOR_TEXT_DIM + ('─' * context.width) + context.reset
+          )
+        end
+
+        def hint_column(title_width, hint_plain)
+          hint_width = Shoko::Adapters::Output::Terminal::TextMetrics.visible_length(hint_plain)
+          min_hint_col = 2 + title_width + 2
+          right_hint_col = context.width - hint_width
+          [right_hint_col, min_hint_col].max
+        end
+
+        def render_body
+          text_box = selected_text_box
+          render_text_box(text_box)
+          render_note_box(note_box(text_box))
+        end
+
+        def selected_text_box
+          AnnotationTextBox.new(
+            row: 4,
+            height: [context.height * 0.25, 6].max.to_i,
+            width: context.width - 4,
+            label: 'Selected Text',
+            text: context.selected_text
+          )
+        end
+
+        def note_box(text_box)
+          text_box.next_box(
+            total_height: context.height,
+            label: 'Note (editable)',
+            text: context.note_text
+          )
+        end
+
+        def render_text_box(box)
+          box.render(context, drawer: self, color_prefix: COLOR_TEXT_PRIMARY)
+        end
+
+        def render_note_box(box)
+          render_text_box(box)
+          render_cursor(box)
+        end
+
+        def render_cursor(box)
+          row, col = box.cursor_position(@cursor_pos)
+          context.surface.write(context.bounds, row, col, "#{SELECTION_HIGHLIGHT}_#{context.reset}")
+        end
+
+        def render_footer
+          context.surface.write(
+            context.bounds,
+            context.height - 1,
+            2,
+            "#{COLOR_TEXT_DIM}[Type] to edit • [Backspace] delete • [Enter] newline#{context.reset}"
+          )
+        end
+
+        def persist_annotation(service, path)
+          if @is_editing && @annotation
+            service.update(path, @annotation['id'], @note)
+          else
+            service.add(path, @selected_text, @note, @range, @chapter_index, nil)
+          end
+        end
+
+        def finalize_save
+          @ui.refresh_annotations
+          @ui.cleanup_popup_state
+          @ui.set_message('Annotation saved!')
+          @ui.switch_mode(:read)
+        end
+
+        def context
+          @render_context
+        end
+      end
+    end
+  end
+end