shoko 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (294) hide show
  1. checksums.yaml +7 -0
  2. data/.bundle/config +4 -0
  3. data/.bundle/config.bak +3 -0
  4. data/.rspec_status +42 -0
  5. data/.rubocop.yml +124 -0
  6. data/Gemfile +19 -0
  7. data/LICENSE +21 -0
  8. data/README.md +82 -0
  9. data/Rakefile +29 -0
  10. data/bin/start +15 -0
  11. data/lib/shoko/adapters/book_sources/document_service.rb +201 -0
  12. data/lib/shoko/adapters/book_sources/download_service.rb +95 -0
  13. data/lib/shoko/adapters/book_sources/epub/epub_resource_loader.rb +137 -0
  14. data/lib/shoko/adapters/book_sources/epub/parsers/html_processor.rb +151 -0
  15. data/lib/shoko/adapters/book_sources/epub/parsers/metadata_extractor.rb +53 -0
  16. data/lib/shoko/adapters/book_sources/epub/parsers/opf/entry_reader.rb +77 -0
  17. data/lib/shoko/adapters/book_sources/epub/parsers/opf/metadata_extractor.rb +67 -0
  18. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_context.rb +86 -0
  19. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_document_index.rb +75 -0
  20. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_document_scanner.rb +47 -0
  21. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_extractor.rb +46 -0
  22. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_label_resolver.rb +83 -0
  23. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_list_item.rb +55 -0
  24. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_result.rb +8 -0
  25. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_selector.rb +100 -0
  26. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_source_locator.rb +93 -0
  27. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_traversal.rb +103 -0
  28. data/lib/shoko/adapters/book_sources/epub/parsers/opf/navigation_walker.rb +56 -0
  29. data/lib/shoko/adapters/book_sources/epub/parsers/opf_processor.rb +102 -0
  30. data/lib/shoko/adapters/book_sources/epub/parsers/xhtml_content_parser.rb +661 -0
  31. data/lib/shoko/adapters/book_sources/epub/parsers/xml_text_normalizer.rb +41 -0
  32. data/lib/shoko/adapters/book_sources/epub_document.rb +253 -0
  33. data/lib/shoko/adapters/book_sources/epub_finder/directory_scanner.rb +134 -0
  34. data/lib/shoko/adapters/book_sources/epub_finder/scanner_context.rb +28 -0
  35. data/lib/shoko/adapters/book_sources/epub_finder.rb +161 -0
  36. data/lib/shoko/adapters/book_sources/epub_importer.rb +268 -0
  37. data/lib/shoko/adapters/book_sources/gutendex_client.rb +150 -0
  38. data/lib/shoko/adapters/book_sources/library_scanner.rb +93 -0
  39. data/lib/shoko/adapters/book_sources/source_fingerprint.rb +57 -0
  40. data/lib/shoko/adapters/input/annotations/mouse_handler.rb +84 -0
  41. data/lib/shoko/adapters/input/command_bridge.rb +148 -0
  42. data/lib/shoko/adapters/input/command_factory.rb +255 -0
  43. data/lib/shoko/adapters/input/commands.rb +60 -0
  44. data/lib/shoko/adapters/input/dispatcher.rb +69 -0
  45. data/lib/shoko/adapters/input/input_controller.rb +250 -0
  46. data/lib/shoko/adapters/input/key_definitions.rb +108 -0
  47. data/lib/shoko/adapters/input/validators/file_path_validator.rb +81 -0
  48. data/lib/shoko/adapters/input/validators/terminal_size_validator.rb +76 -0
  49. data/lib/shoko/adapters/monitoring/logger.rb +150 -0
  50. data/lib/shoko/adapters/monitoring/perf_tracer.rb +183 -0
  51. data/lib/shoko/adapters/monitoring/performance_monitor.rb +110 -0
  52. data/lib/shoko/adapters/output/clipboard/clipboard_service.rb +125 -0
  53. data/lib/shoko/adapters/output/formatting/formatting_service/line_assembler/image_builder.rb +149 -0
  54. data/lib/shoko/adapters/output/formatting/formatting_service/line_assembler/text_wrapper.rb +149 -0
  55. data/lib/shoko/adapters/output/formatting/formatting_service/line_assembler/tokenizer.rb +91 -0
  56. data/lib/shoko/adapters/output/formatting/formatting_service/line_assembler.rb +144 -0
  57. data/lib/shoko/adapters/output/formatting/formatting_service/plain_lines_builder.rb +54 -0
  58. data/lib/shoko/adapters/output/formatting/formatting_service.rb +247 -0
  59. data/lib/shoko/adapters/output/formatting/wrapping_service.rb +228 -0
  60. data/lib/shoko/adapters/output/instrumentation_service.rb +52 -0
  61. data/lib/shoko/adapters/output/kitty/image_transcoder.rb +71 -0
  62. data/lib/shoko/adapters/output/kitty/kitty_graphics.rb +114 -0
  63. data/lib/shoko/adapters/output/kitty/kitty_image_renderer.rb +239 -0
  64. data/lib/shoko/adapters/output/kitty/kitty_unicode_placeholders.rb +139 -0
  65. data/lib/shoko/adapters/output/kitty/kitty_unicode_placeholders_diacritic_codepoints.txt +26 -0
  66. data/lib/shoko/adapters/output/notification_service.rb +58 -0
  67. data/lib/shoko/adapters/output/render_registry.rb +45 -0
  68. data/lib/shoko/adapters/output/rendering/models/line_geometry.rb +60 -0
  69. data/lib/shoko/adapters/output/rendering/models/page_rendering_context.rb +22 -0
  70. data/lib/shoko/adapters/output/rendering/models/render_params.rb +28 -0
  71. data/lib/shoko/adapters/output/rendering/models/rendering_context.rb +58 -0
  72. data/lib/shoko/adapters/output/terminal/buffer.rb +275 -0
  73. data/lib/shoko/adapters/output/terminal/constants/terminal_defaults.rb +11 -0
  74. data/lib/shoko/adapters/output/terminal/input/decoder.rb +347 -0
  75. data/lib/shoko/adapters/output/terminal/input.rb +161 -0
  76. data/lib/shoko/adapters/output/terminal/output.rb +105 -0
  77. data/lib/shoko/adapters/output/terminal/terminal.rb +167 -0
  78. data/lib/shoko/adapters/output/terminal/terminal_sanitizer.rb +243 -0
  79. data/lib/shoko/adapters/output/terminal/terminal_service.rb +138 -0
  80. data/lib/shoko/adapters/output/terminal/text_metrics.rb +273 -0
  81. data/lib/shoko/adapters/output/ui/builders/page_setup_builder.rb +47 -0
  82. data/lib/shoko/adapters/output/ui/components/annotation_editor_overlay/footer_renderer.rb +80 -0
  83. data/lib/shoko/adapters/output/ui/components/annotation_editor_overlay/geometry.rb +61 -0
  84. data/lib/shoko/adapters/output/ui/components/annotation_editor_overlay/note_renderer.rb +86 -0
  85. data/lib/shoko/adapters/output/ui/components/annotation_editor_overlay_component.rb +234 -0
  86. data/lib/shoko/adapters/output/ui/components/annotations_overlay/list_renderer.rb +142 -0
  87. data/lib/shoko/adapters/output/ui/components/annotations_overlay_component.rb +185 -0
  88. data/lib/shoko/adapters/output/ui/components/base_component.rb +110 -0
  89. data/lib/shoko/adapters/output/ui/components/component_interface.rb +80 -0
  90. data/lib/shoko/adapters/output/ui/components/content_component.rb +61 -0
  91. data/lib/shoko/adapters/output/ui/components/enhanced_popup_menu.rb +191 -0
  92. data/lib/shoko/adapters/output/ui/components/footer_component.rb +120 -0
  93. data/lib/shoko/adapters/output/ui/components/header_component.rb +46 -0
  94. data/lib/shoko/adapters/output/ui/components/layouts/horizontal.rb +63 -0
  95. data/lib/shoko/adapters/output/ui/components/layouts/vertical.rb +73 -0
  96. data/lib/shoko/adapters/output/ui/components/main_menu_component.rb +103 -0
  97. data/lib/shoko/adapters/output/ui/components/reading/base_view_renderer.rb +199 -0
  98. data/lib/shoko/adapters/output/ui/components/reading/config_helpers.rb +42 -0
  99. data/lib/shoko/adapters/output/ui/components/reading/help_renderer.rb +62 -0
  100. data/lib/shoko/adapters/output/ui/components/reading/inline_segment_highlighter.rb +144 -0
  101. data/lib/shoko/adapters/output/ui/components/reading/kitty_image_line_renderer.rb +262 -0
  102. data/lib/shoko/adapters/output/ui/components/reading/line_content_composer.rb +114 -0
  103. data/lib/shoko/adapters/output/ui/components/reading/line_drawer.rb +87 -0
  104. data/lib/shoko/adapters/output/ui/components/reading/line_geometry_builder.rb +41 -0
  105. data/lib/shoko/adapters/output/ui/components/reading/rendered_lines_recorder.rb +64 -0
  106. data/lib/shoko/adapters/output/ui/components/reading/single_view_renderer.rb +156 -0
  107. data/lib/shoko/adapters/output/ui/components/reading/split_view_renderer.rb +221 -0
  108. data/lib/shoko/adapters/output/ui/components/reading/view_renderer_factory.rb +20 -0
  109. data/lib/shoko/adapters/output/ui/components/reading/wrapped_lines_fetcher.rb +139 -0
  110. data/lib/shoko/adapters/output/ui/components/rect.rb +15 -0
  111. data/lib/shoko/adapters/output/ui/components/render_style.rb +84 -0
  112. data/lib/shoko/adapters/output/ui/components/screen_component.rb +24 -0
  113. data/lib/shoko/adapters/output/ui/components/screens/annotation_detail_screen_component.rb +175 -0
  114. data/lib/shoko/adapters/output/ui/components/screens/annotation_edit_screen_component.rb +221 -0
  115. data/lib/shoko/adapters/output/ui/components/screens/annotation_editor_screen_component.rb +205 -0
  116. data/lib/shoko/adapters/output/ui/components/screens/annotation_rendering_helpers.rb +190 -0
  117. data/lib/shoko/adapters/output/ui/components/screens/annotations_screen_component.rb +266 -0
  118. data/lib/shoko/adapters/output/ui/components/screens/base_screen_component.rb +49 -0
  119. data/lib/shoko/adapters/output/ui/components/screens/browse_screen_component.rb +319 -0
  120. data/lib/shoko/adapters/output/ui/components/screens/download_books_screen_component.rb +340 -0
  121. data/lib/shoko/adapters/output/ui/components/screens/library_screen_component.rb +205 -0
  122. data/lib/shoko/adapters/output/ui/components/screens/loading_overlay_component.rb +49 -0
  123. data/lib/shoko/adapters/output/ui/components/screens/menu_screen_component.rb +107 -0
  124. data/lib/shoko/adapters/output/ui/components/screens/settings_screen_component.rb +238 -0
  125. data/lib/shoko/adapters/output/ui/components/sidebar/annotations_tab_renderer.rb +159 -0
  126. data/lib/shoko/adapters/output/ui/components/sidebar/bookmarks_tab_renderer.rb +139 -0
  127. data/lib/shoko/adapters/output/ui/components/sidebar/tab_header_component.rb +157 -0
  128. data/lib/shoko/adapters/output/ui/components/sidebar/toc_tab_renderer.rb +111 -0
  129. data/lib/shoko/adapters/output/ui/components/sidebar/toc_tab_support.rb +1606 -0
  130. data/lib/shoko/adapters/output/ui/components/sidebar_panel_component.rb +217 -0
  131. data/lib/shoko/adapters/output/ui/components/surface.rb +88 -0
  132. data/lib/shoko/adapters/output/ui/components/tooltip_overlay_component.rb +224 -0
  133. data/lib/shoko/adapters/output/ui/components/ui/box_drawer.rb +32 -0
  134. data/lib/shoko/adapters/output/ui/components/ui/list_helpers.rb +33 -0
  135. data/lib/shoko/adapters/output/ui/components/ui/overlay_layout.rb +79 -0
  136. data/lib/shoko/adapters/output/ui/components/ui/text_utils.rb +46 -0
  137. data/lib/shoko/adapters/output/ui/constants/highlighting.rb +21 -0
  138. data/lib/shoko/adapters/output/ui/constants/messages.rb +12 -0
  139. data/lib/shoko/adapters/output/ui/constants/themes.rb +79 -0
  140. data/lib/shoko/adapters/output/ui/constants/ui_constants.rb +85 -0
  141. data/lib/shoko/adapters/output/ui/rendering/frame_coordinator.rb +42 -0
  142. data/lib/shoko/adapters/output/ui/rendering/reader_render_coordinator.rb +169 -0
  143. data/lib/shoko/adapters/output/ui/rendering/render_pipeline.rb +55 -0
  144. data/lib/shoko/adapters/storage/atomic_file_writer.rb +43 -0
  145. data/lib/shoko/adapters/storage/background_worker.rb +66 -0
  146. data/lib/shoko/adapters/storage/book_cache_pipeline.rb +653 -0
  147. data/lib/shoko/adapters/storage/cache/epub/memory_cache.rb +99 -0
  148. data/lib/shoko/adapters/storage/cache/epub/persistence.rb +131 -0
  149. data/lib/shoko/adapters/storage/cache/epub/serializer/deserialize.rb +225 -0
  150. data/lib/shoko/adapters/storage/cache/epub/serializer/helpers.rb +63 -0
  151. data/lib/shoko/adapters/storage/cache/epub/serializer/serialize.rb +83 -0
  152. data/lib/shoko/adapters/storage/cache/epub/serializer.rb +5 -0
  153. data/lib/shoko/adapters/storage/cache/epub/source_reference.rb +58 -0
  154. data/lib/shoko/adapters/storage/cache_paths.rb +21 -0
  155. data/lib/shoko/adapters/storage/cache_pointer_manager.rb +60 -0
  156. data/lib/shoko/adapters/storage/config_paths.rb +30 -0
  157. data/lib/shoko/adapters/storage/epub_cache.rb +195 -0
  158. data/lib/shoko/adapters/storage/file_writer_service.rb +47 -0
  159. data/lib/shoko/adapters/storage/json_cache_store/chapters.rb +141 -0
  160. data/lib/shoko/adapters/storage/json_cache_store/layouts.rb +67 -0
  161. data/lib/shoko/adapters/storage/json_cache_store/manifest.rb +42 -0
  162. data/lib/shoko/adapters/storage/json_cache_store/payload_helpers.rb +113 -0
  163. data/lib/shoko/adapters/storage/json_cache_store/resources.rb +84 -0
  164. data/lib/shoko/adapters/storage/json_cache_store.rb +167 -0
  165. data/lib/shoko/adapters/storage/lazy_file_string.rb +65 -0
  166. data/lib/shoko/adapters/storage/pagination_cache.rb +127 -0
  167. data/lib/shoko/adapters/storage/recent_files.rb +78 -0
  168. data/lib/shoko/adapters/storage/repositories/annotation_repository.rb +182 -0
  169. data/lib/shoko/adapters/storage/repositories/base_repository.rb +81 -0
  170. data/lib/shoko/adapters/storage/repositories/bookmark_repository.rb +132 -0
  171. data/lib/shoko/adapters/storage/repositories/cached_library_repository.rb +129 -0
  172. data/lib/shoko/adapters/storage/repositories/config_repository.rb +262 -0
  173. data/lib/shoko/adapters/storage/repositories/progress_repository.rb +166 -0
  174. data/lib/shoko/adapters/storage/repositories/storage/annotation_file_store.rb +128 -0
  175. data/lib/shoko/adapters/storage/repositories/storage/bookmark_file_store.rb +109 -0
  176. data/lib/shoko/adapters/storage/repositories/storage/file_store_utils.rb +20 -0
  177. data/lib/shoko/adapters/storage/repositories/storage/progress_file_store.rb +59 -0
  178. data/lib/shoko/application/annotation_editor_overlay_session.rb +138 -0
  179. data/lib/shoko/application/cli.rb +134 -0
  180. data/lib/shoko/application/controllers/menu/input_controller.rb +189 -0
  181. data/lib/shoko/application/controllers/menu/state_controller.rb +642 -0
  182. data/lib/shoko/application/controllers/menu_controller.rb +469 -0
  183. data/lib/shoko/application/controllers/mouseable_reader.rb +377 -0
  184. data/lib/shoko/application/controllers/reader_controller.rb +449 -0
  185. data/lib/shoko/application/controllers/state_controller.rb +410 -0
  186. data/lib/shoko/application/controllers/ui_controller.rb +782 -0
  187. data/lib/shoko/application/dependency_container.rb +301 -0
  188. data/lib/shoko/application/infrastructure/event_bus.rb +80 -0
  189. data/lib/shoko/application/infrastructure/observer_state_store.rb +136 -0
  190. data/lib/shoko/application/infrastructure/state_store.rb +413 -0
  191. data/lib/shoko/application/main_menu/menu_progress_presenter.rb +83 -0
  192. data/lib/shoko/application/pending_jump_handler.rb +122 -0
  193. data/lib/shoko/application/reader_lifecycle.rb +65 -0
  194. data/lib/shoko/application/reader_startup_orchestrator.rb +113 -0
  195. data/lib/shoko/application/selectors/config_selectors.rb +62 -0
  196. data/lib/shoko/application/selectors/menu_selectors.rb +62 -0
  197. data/lib/shoko/application/selectors/reader_selectors.rb +186 -0
  198. data/lib/shoko/application/state/actions/base_action.rb +24 -0
  199. data/lib/shoko/application/state/actions/quit_to_menu_action.rb +16 -0
  200. data/lib/shoko/application/state/actions/switch_reader_mode_action.rb +22 -0
  201. data/lib/shoko/application/state/actions/toggle_view_mode_action.rb +31 -0
  202. data/lib/shoko/application/state/actions/update_annotation_editor_overlay_action.rb +27 -0
  203. data/lib/shoko/application/state/actions/update_annotations_action.rb +20 -0
  204. data/lib/shoko/application/state/actions/update_annotations_overlay_action.rb +27 -0
  205. data/lib/shoko/application/state/actions/update_bookmarks_action.rb +20 -0
  206. data/lib/shoko/application/state/actions/update_chapter_action.rb +24 -0
  207. data/lib/shoko/application/state/actions/update_config_action.rb +22 -0
  208. data/lib/shoko/application/state/actions/update_field_helpers.rb +26 -0
  209. data/lib/shoko/application/state/actions/update_menu_action.rb +21 -0
  210. data/lib/shoko/application/state/actions/update_message_action.rb +35 -0
  211. data/lib/shoko/application/state/actions/update_page_action.rb +21 -0
  212. data/lib/shoko/application/state/actions/update_pagination_state_action.rb +21 -0
  213. data/lib/shoko/application/state/actions/update_popup_menu_action.rb +27 -0
  214. data/lib/shoko/application/state/actions/update_reader_meta_action.rb +21 -0
  215. data/lib/shoko/application/state/actions/update_reader_mode_action.rb +20 -0
  216. data/lib/shoko/application/state/actions/update_rendered_lines_action.rb +40 -0
  217. data/lib/shoko/application/state/actions/update_selection_action.rb +27 -0
  218. data/lib/shoko/application/state/actions/update_selections_action.rb +21 -0
  219. data/lib/shoko/application/state/actions/update_sidebar_action.rb +34 -0
  220. data/lib/shoko/application/state/actions/update_ui_loading_action.rb +23 -0
  221. data/lib/shoko/application/ui/reader_view_model_builder.rb +74 -0
  222. data/lib/shoko/application/ui/view_models/reader_view_model.rb +177 -0
  223. data/lib/shoko/application/unified_application.rb +48 -0
  224. data/lib/shoko/application/use_cases/catalog_service.rb +117 -0
  225. data/lib/shoko/application/use_cases/commands/annotation_editor_commands.rb +105 -0
  226. data/lib/shoko/application/use_cases/commands/application_commands.rb +208 -0
  227. data/lib/shoko/application/use_cases/commands/base_command.rb +166 -0
  228. data/lib/shoko/application/use_cases/commands/bookmark_commands.rb +114 -0
  229. data/lib/shoko/application/use_cases/commands/conditional_navigation_commands.rb +57 -0
  230. data/lib/shoko/application/use_cases/commands/menu_commands.rb +170 -0
  231. data/lib/shoko/application/use_cases/commands/navigation_commands.rb +183 -0
  232. data/lib/shoko/application/use_cases/commands/reader_commands.rb +46 -0
  233. data/lib/shoko/application/use_cases/commands/sidebar_commands.rb +55 -0
  234. data/lib/shoko/application/use_cases/settings_service.rb +123 -0
  235. data/lib/shoko/core/events/annotation_events.rb +94 -0
  236. data/lib/shoko/core/events/base_domain_event.rb +169 -0
  237. data/lib/shoko/core/events/bookmark_events.rb +41 -0
  238. data/lib/shoko/core/events/domain_event_bus.rb +163 -0
  239. data/lib/shoko/core/events/progress_events.rb +108 -0
  240. data/lib/shoko/core/models/bookmark.rb +36 -0
  241. data/lib/shoko/core/models/bookmark_data.rb +10 -0
  242. data/lib/shoko/core/models/chapter.rb +25 -0
  243. data/lib/shoko/core/models/content_block.rb +44 -0
  244. data/lib/shoko/core/models/reader_settings.rb +20 -0
  245. data/lib/shoko/core/models/selection_anchor.rb +73 -0
  246. data/lib/shoko/core/models/toc_entry.rb +14 -0
  247. data/lib/shoko/core/ports/annotation_repository.rb +0 -0
  248. data/lib/shoko/core/ports/book_repository.rb +0 -0
  249. data/lib/shoko/core/ports/book_source.rb +0 -0
  250. data/lib/shoko/core/ports/bookmark_repository.rb +0 -0
  251. data/lib/shoko/core/ports/cache.rb +0 -0
  252. data/lib/shoko/core/ports/input_handler.rb +0 -0
  253. data/lib/shoko/core/ports/renderer.rb +0 -0
  254. data/lib/shoko/core/ports/storage.rb +0 -0
  255. data/lib/shoko/core/services/annotation_service.rb +102 -0
  256. data/lib/shoko/core/services/base_service.rb +60 -0
  257. data/lib/shoko/core/services/bookmark_service.rb +267 -0
  258. data/lib/shoko/core/services/coordinate_service.rb +265 -0
  259. data/lib/shoko/core/services/layout_service.rb +95 -0
  260. data/lib/shoko/core/services/navigation/absolute_change_applier.rb +96 -0
  261. data/lib/shoko/core/services/navigation/absolute_layout.rb +101 -0
  262. data/lib/shoko/core/services/navigation/absolute_strategy.rb +179 -0
  263. data/lib/shoko/core/services/navigation/context_builder.rb +52 -0
  264. data/lib/shoko/core/services/navigation/context_helpers.rb +63 -0
  265. data/lib/shoko/core/services/navigation/dynamic_change_applier.rb +50 -0
  266. data/lib/shoko/core/services/navigation/dynamic_strategy.rb +51 -0
  267. data/lib/shoko/core/services/navigation/image_offset_snapper.rb +150 -0
  268. data/lib/shoko/core/services/navigation/nav_context.rb +27 -0
  269. data/lib/shoko/core/services/navigation/state_updater.rb +29 -0
  270. data/lib/shoko/core/services/navigation/strategy_factory.rb +20 -0
  271. data/lib/shoko/core/services/navigation_service.rb +150 -0
  272. data/lib/shoko/core/services/page_calculator_service.rb +242 -0
  273. data/lib/shoko/core/services/pagination/internal/absolute_page_map_builder.rb +28 -0
  274. data/lib/shoko/core/services/pagination/internal/chapter_cache.rb +60 -0
  275. data/lib/shoko/core/services/pagination/internal/dynamic_page_map_builder.rb +157 -0
  276. data/lib/shoko/core/services/pagination/internal/layout_metrics_calculator.rb +73 -0
  277. data/lib/shoko/core/services/pagination/internal/page_hydrator.rb +145 -0
  278. data/lib/shoko/core/services/pagination/internal/pagination_workflow.rb +152 -0
  279. data/lib/shoko/core/services/pagination/page_info_calculator.rb +247 -0
  280. data/lib/shoko/core/services/pagination/pagination_cache_preloader.rb +173 -0
  281. data/lib/shoko/core/services/pagination/pagination_coordinator.rb +202 -0
  282. data/lib/shoko/core/services/pagination/pagination_orchestrator.rb +291 -0
  283. data/lib/shoko/core/services/pagination.rb +10 -0
  284. data/lib/shoko/core/services/progress_helper.rb +22 -0
  285. data/lib/shoko/core/services/selection_service.rb +126 -0
  286. data/lib/shoko/core/validator.rb +76 -0
  287. data/lib/shoko/shared/errors.rb +97 -0
  288. data/lib/shoko/shared/version.rb +5 -0
  289. data/lib/shoko/test_support/terminal_double.rb +175 -0
  290. data/lib/shoko/test_support/test_mode.rb +78 -0
  291. data/lib/shoko.rb +279 -0
  292. data/lib/zip.rb +732 -0
  293. data/zip.rb +5 -0
  294. metadata +370 -0
data/lib/shoko.rb ADDED
@@ -0,0 +1,279 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Shoko - A fast, keyboard-driven terminal EPUB reader
4
+ #
5
+ # This is the main entry point for the Shoko gem. It loads all
6
+ # necessary components in the correct order to ensure dependencies are
7
+ # satisfied.
8
+ #
9
+ # @example Basic usage
10
+ # require 'shoko'
11
+ # Shoko::CLI.run
12
+ #
13
+ # @example Programmatic usage
14
+ # reader = Shoko::Application::Controllers::MouseableReader.new('/path/to/book.epub')
15
+ # reader.run
16
+
17
+ module Shoko
18
+ module Adapters
19
+ module Output
20
+ module Ui; end
21
+ module Rendering; end
22
+ end
23
+ module Input; end
24
+ module Storage
25
+ module Repositories; end
26
+ end
27
+ module Monitoring; end
28
+ module BookSources
29
+ module Epub; end
30
+ end
31
+ end
32
+
33
+ module Core
34
+ module Services
35
+ module Pagination; end
36
+ end
37
+ module Models; end
38
+ module Events; end
39
+ end
40
+
41
+ module Application
42
+ module Controllers; end
43
+ module Infrastructure; end
44
+ module UseCases; end
45
+ module State; end
46
+ module Actions; end
47
+ module Selectors; end
48
+ module UI; end
49
+ end
50
+ end
51
+
52
+ # Core infrastructure - must be loaded first
53
+ # Our minimal ZIP reader lives at lib/zip.rb, and a top-level zip.rb wrapper ensures
54
+ # `require 'zip'` in specs loads it. Keep this require close for clarity.
55
+ require_relative 'zip'
56
+ require_relative 'shoko/adapters/monitoring/logger.rb'
57
+ require_relative 'shoko/core/validator.rb'
58
+ require_relative 'shoko/adapters/monitoring/performance_monitor.rb'
59
+ require_relative 'shoko/application/infrastructure/event_bus'
60
+ require_relative 'shoko/application/infrastructure/state_store'
61
+ require_relative 'shoko/application/infrastructure/observer_state_store'
62
+ require_relative 'shoko/adapters/storage/cache_pointer_manager'
63
+ require_relative 'shoko/adapters/book_sources/document_service.rb'
64
+ require_relative 'shoko/adapters/storage/pagination_cache.rb'
65
+ require_relative 'shoko/adapters/book_sources/library_scanner'
66
+ require_relative 'shoko/adapters/book_sources/gutendex_client.rb'
67
+ require_relative 'shoko/core/services/pagination/pagination_cache_preloader.rb'
68
+
69
+ # Error definitions
70
+ require_relative 'shoko/shared/errors'
71
+
72
+ # Constants and configuration
73
+ require_relative 'shoko/core/models/reader_settings.rb'
74
+ require_relative 'shoko/adapters/output/ui/constants/ui_constants.rb'
75
+ require_relative 'shoko/adapters/output/ui/constants/themes.rb'
76
+ require_relative 'shoko/adapters/output/ui/constants/messages.rb'
77
+ require_relative 'shoko/adapters/output/ui/constants/highlighting.rb'
78
+ require_relative 'shoko/adapters/output/rendering/models/page_rendering_context.rb'
79
+ require_relative 'shoko/adapters/output/rendering/models/rendering_context.rb'
80
+ require_relative 'shoko/adapters/output/rendering/models/line_geometry.rb'
81
+ require_relative 'shoko/core/models/selection_anchor.rb'
82
+ require_relative 'shoko/adapters/output/ui/builders/page_setup_builder.rb'
83
+
84
+ # Core components
85
+ require_relative 'shoko/shared/version'
86
+ require_relative 'shoko/adapters/output/terminal/terminal.rb'
87
+ # Config/state access uses ObserverStateStore via DI (:global_state resolves to the shared state store)
88
+
89
+ # Validators
90
+ require_relative 'shoko/adapters/input/validators/file_path_validator.rb'
91
+ require_relative 'shoko/adapters/input/validators/terminal_size_validator.rb'
92
+
93
+ # Data management
94
+ require_relative 'shoko/adapters/book_sources/epub_finder.rb'
95
+ require_relative 'shoko/adapters/storage/recent_files.rb'
96
+
97
+ # Document handling
98
+ require_relative 'shoko/adapters/book_sources/epub_document.rb'
99
+ require_relative 'shoko/adapters/output/terminal/text_metrics.rb'
100
+
101
+ # Legacy command system removed - now using Application commands only
102
+
103
+ # Input system - load early for dependency resolution
104
+ require_relative 'shoko/adapters/input/key_definitions.rb'
105
+ require_relative 'shoko/adapters/input/command_factory.rb'
106
+
107
+ # Domain layer - new architecture (must load before bridge)
108
+ require_relative 'shoko/application/dependency_container'
109
+ require_relative 'shoko/core/models/chapter.rb'
110
+ require_relative 'shoko/core/models/bookmark.rb'
111
+ require_relative 'shoko/core/models/bookmark_data.rb'
112
+ require_relative 'shoko/core/models/toc_entry.rb'
113
+ require_relative 'shoko/core/models/content_block.rb'
114
+ require_relative 'shoko/core/events/base_domain_event.rb'
115
+ require_relative 'shoko/core/events/bookmark_events.rb'
116
+ require_relative 'shoko/core/events/annotation_events.rb'
117
+ require_relative 'shoko/core/events/progress_events.rb'
118
+ require_relative 'shoko/core/events/domain_event_bus.rb'
119
+ require_relative 'shoko/adapters/storage/repositories/base_repository.rb'
120
+ require_relative 'shoko/adapters/storage/repositories/bookmark_repository.rb'
121
+ require_relative 'shoko/adapters/storage/repositories/annotation_repository.rb'
122
+ require_relative 'shoko/adapters/storage/repositories/progress_repository.rb'
123
+ require_relative 'shoko/adapters/storage/repositories/config_repository.rb'
124
+ require_relative 'shoko/core/services/base_service.rb'
125
+ require_relative 'shoko/core/services/navigation_service'
126
+ require_relative 'shoko/core/services/navigation/context_helpers'
127
+ require_relative 'shoko/core/services/bookmark_service'
128
+ require_relative 'shoko/core/services/page_calculator_service'
129
+ require_relative 'shoko/core/services/coordinate_service'
130
+ require_relative 'shoko/core/services/layout_service'
131
+ require_relative 'shoko/adapters/output/clipboard/clipboard_service'
132
+ require_relative 'shoko/core/services/annotation_service'
133
+ require_relative 'shoko/adapters/output/terminal/terminal_service'
134
+ require_relative 'shoko/core/services/selection_service'
135
+ require_relative 'shoko/adapters/output/formatting/wrapping_service'
136
+ require_relative 'shoko/adapters/output/formatting/formatting_service'
137
+ require_relative 'shoko/adapters/output/notification_service'
138
+ require_relative 'shoko/application/use_cases/catalog_service'
139
+ require_relative 'shoko/application/use_cases/settings_service'
140
+ require_relative 'shoko/adapters/book_sources/download_service'
141
+ require_relative 'shoko/application/use_cases/commands/base_command.rb'
142
+ require_relative 'shoko/application/use_cases/commands/navigation_commands.rb'
143
+ require_relative 'shoko/application/use_cases/commands/application_commands.rb'
144
+ require_relative 'shoko/application/use_cases/commands/bookmark_commands.rb'
145
+ require_relative 'shoko/application/use_cases/commands/sidebar_commands.rb'
146
+ require_relative 'shoko/application/use_cases/commands/conditional_navigation_commands.rb'
147
+ require_relative 'shoko/application/use_cases/commands/menu_commands.rb'
148
+ require_relative 'shoko/application/use_cases/commands/annotation_editor_commands.rb'
149
+ require_relative 'shoko/application/use_cases/commands/reader_commands.rb'
150
+ require_relative 'shoko/application/state/actions/base_action.rb'
151
+ require_relative 'shoko/application/state/actions/toggle_view_mode_action.rb'
152
+ require_relative 'shoko/application/state/actions/switch_reader_mode_action.rb'
153
+ require_relative 'shoko/application/state/actions/quit_to_menu_action.rb'
154
+ require_relative 'shoko/application/state/actions/update_reader_mode_action.rb'
155
+ require_relative 'shoko/application/state/actions/update_page_action.rb'
156
+ require_relative 'shoko/application/state/actions/update_selection_action.rb'
157
+ require_relative 'shoko/application/state/actions/update_message_action.rb'
158
+ require_relative 'shoko/application/state/actions/update_chapter_action.rb'
159
+ require_relative 'shoko/application/state/actions/update_config_action.rb'
160
+ require_relative 'shoko/application/state/actions/update_bookmarks_action.rb'
161
+ require_relative 'shoko/application/state/actions/update_sidebar_action.rb'
162
+ require_relative 'shoko/application/state/actions/update_selections_action.rb'
163
+ require_relative 'shoko/application/state/actions/update_popup_menu_action.rb'
164
+ require_relative 'shoko/application/state/actions/update_rendered_lines_action.rb'
165
+ require_relative 'shoko/application/state/actions/update_ui_loading_action.rb'
166
+ require_relative 'shoko/application/state/actions/update_pagination_state_action.rb'
167
+ require_relative 'shoko/application/state/actions/update_reader_meta_action.rb'
168
+ require_relative 'shoko/application/state/actions/update_annotations_action.rb'
169
+ require_relative 'shoko/application/state/actions/update_menu_action.rb'
170
+ require_relative 'shoko/application/state/actions/update_annotations_overlay_action.rb'
171
+ require_relative 'shoko/application/state/actions/update_annotation_editor_overlay_action.rb'
172
+
173
+ # Domain selectors for state access
174
+ require_relative 'shoko/application/selectors/reader_selectors'
175
+ require_relative 'shoko/application/selectors/menu_selectors'
176
+ require_relative 'shoko/application/selectors/config_selectors'
177
+
178
+ # Input system bridge (load after application commands)
179
+ require_relative 'shoko/adapters/input/command_bridge.rb'
180
+
181
+ # UI layer - new architecture
182
+ require_relative 'shoko/application/ui/view_models/reader_view_model.rb'
183
+ # Removed unused: pure_content_component, pure_footer_component
184
+
185
+ # Application layer - new architecture
186
+ require_relative 'shoko/application/unified_application.rb'
187
+ require_relative 'shoko/application/ui/reader_view_model_builder.rb'
188
+ require_relative 'shoko/application/reader_startup_orchestrator.rb'
189
+ require_relative 'shoko/adapters/output/ui/rendering/frame_coordinator.rb'
190
+ require_relative 'shoko/adapters/output/ui/rendering/render_pipeline.rb'
191
+ require_relative 'shoko/core/services/pagination/page_info_calculator.rb'
192
+ require_relative 'shoko/core/services/pagination/pagination_orchestrator.rb'
193
+ require_relative 'shoko/core/services/pagination/pagination_coordinator.rb'
194
+ require_relative 'shoko/adapters/output/ui/rendering/reader_render_coordinator.rb'
195
+ require_relative 'shoko/application/reader_lifecycle.rb'
196
+ require_relative 'shoko/core/services/progress_helper.rb'
197
+ # Removed unused: reader_application, menu_application
198
+
199
+ # Controller layer - focused controllers replacing god class
200
+ require_relative 'shoko/application/controllers/ui_controller.rb'
201
+ require_relative 'shoko/application/controllers/state_controller.rb'
202
+ require_relative 'shoko/adapters/input/input_controller.rb'
203
+
204
+ # Core reader components updated to use new state management
205
+ # Removed: legacy global state implementation (now using Application::Infrastructure::ObserverStateStore)
206
+ # Removed: state_accessor - no longer needed with direct state.get() and selectors
207
+ # Removed: state_service (replaced with direct state management)
208
+ # Removed: page_manager (merged into PageCalculatorService)
209
+ # Removed: services/main_menu_input_handler (replaced by dispatcher bindings)
210
+
211
+ # Legacy service wrappers removed - now using domain services directly
212
+
213
+ # Reading components
214
+ require_relative 'shoko/adapters/output/ui/components/reading/base_view_renderer.rb'
215
+ require_relative 'shoko/adapters/output/ui/components/reading/split_view_renderer.rb'
216
+ require_relative 'shoko/adapters/output/ui/components/reading/single_view_renderer.rb'
217
+ require_relative 'shoko/adapters/output/ui/components/reading/help_renderer.rb'
218
+ require_relative 'shoko/adapters/output/ui/components/reading/view_renderer_factory.rb'
219
+
220
+ # Component system
221
+ require_relative 'shoko/adapters/output/ui/components/component_interface.rb'
222
+ # Screen components
223
+ require_relative 'shoko/adapters/output/ui/components/screens/base_screen_component.rb'
224
+ ## recent screen removed
225
+ require_relative 'shoko/adapters/output/ui/components/screens/menu_screen_component.rb'
226
+ require_relative 'shoko/adapters/output/ui/components/screens/annotation_detail_screen_component.rb'
227
+ require_relative 'shoko/adapters/output/ui/components/screens/annotation_editor_screen_component.rb'
228
+ require_relative 'shoko/adapters/output/ui/components/annotation_editor_overlay_component.rb'
229
+
230
+ # UI components
231
+ require_relative 'shoko/application/controllers/menu_controller.rb'
232
+ require_relative 'shoko/application/controllers/mouseable_reader.rb'
233
+
234
+ # Application entry point
235
+ require_relative 'shoko/application/cli.rb'
236
+
237
+
238
+ # Test-only shims and coverage warmup
239
+ if defined?(RSpec)
240
+ require_relative 'shoko/test_support/test_mode'
241
+ Shoko::TestSupport::TestMode.activate!
242
+ end
243
+
244
+ # Main module for the Shoko application
245
+ #
246
+ # This module serves as the namespace for all Shoko components
247
+ # and provides version information and error classes.
248
+ #
249
+ # @example Check version
250
+ # puts Shoko::VERSION
251
+ #
252
+ # @example Handle errors
253
+ # begin
254
+ # Shoko::CLI.run
255
+ # rescue Shoko::Error => e
256
+ # puts "Error: #{e.message}"
257
+ # end
258
+ module Shoko
259
+ # Module-level configuration
260
+ #
261
+ # @return [Application::Infrastructure::ObserverStateStore] Global state instance
262
+ def self.config
263
+ @config ||= Application::ContainerFactory.create_default_container.resolve(:global_state)
264
+ end
265
+
266
+ # Module-level logger
267
+ #
268
+ # @return [Adapters::Monitoring::Logger] Global logger instance
269
+ def self.logger
270
+ Adapters::Monitoring::Logger
271
+ end
272
+
273
+ # Reset module state (mainly for testing)
274
+ def self.reset!
275
+ @config = nil
276
+ Adapters::Monitoring::Logger.clear
277
+ Adapters::Monitoring::PerformanceMonitor.clear
278
+ end
279
+ end