ratatui_ruby 0.3.1 → 0.5.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 (350) hide show
  1. checksums.yaml +4 -4
  2. data/.builds/ruby-3.2.yml +14 -12
  3. data/.builds/ruby-3.3.yml +14 -12
  4. data/.builds/ruby-3.4.yml +14 -12
  5. data/.builds/ruby-4.0.0.yml +14 -12
  6. data/AGENTS.md +89 -132
  7. data/CHANGELOG.md +223 -1
  8. data/README.md +23 -16
  9. data/REUSE.toml +20 -0
  10. data/doc/application_architecture.md +176 -0
  11. data/doc/application_testing.md +17 -10
  12. data/doc/contributors/design/ruby_frontend.md +11 -7
  13. data/doc/contributors/developing_examples.md +261 -0
  14. data/doc/contributors/documentation_style.md +104 -0
  15. data/doc/contributors/dwim_dx.md +366 -0
  16. data/doc/contributors/index.md +2 -0
  17. data/doc/custom.css +14 -0
  18. data/doc/event_handling.md +125 -0
  19. data/doc/images/app_all_events.png +0 -0
  20. data/doc/images/app_analytics.png +0 -0
  21. data/doc/images/app_color_picker.png +0 -0
  22. data/doc/images/app_custom_widget.png +0 -0
  23. data/doc/images/app_login_form.png +0 -0
  24. data/doc/images/app_map_demo.png +0 -0
  25. data/doc/images/app_mouse_events.png +0 -0
  26. data/doc/images/app_table_select.png +0 -0
  27. data/doc/images/verify_quickstart_dsl.png +0 -0
  28. data/doc/images/verify_quickstart_layout.png +0 -0
  29. data/doc/images/verify_quickstart_lifecycle.png +0 -0
  30. data/doc/images/verify_readme_usage.png +0 -0
  31. data/doc/images/widget_barchart_demo.png +0 -0
  32. data/doc/images/widget_block_padding.png +0 -0
  33. data/doc/images/widget_block_titles.png +0 -0
  34. data/doc/images/widget_box_demo.png +0 -0
  35. data/doc/images/widget_calendar_demo.png +0 -0
  36. data/doc/images/widget_cell_demo.png +0 -0
  37. data/doc/images/widget_chart_demo.png +0 -0
  38. data/doc/images/widget_gauge_demo.png +0 -0
  39. data/doc/images/widget_layout_split.png +0 -0
  40. data/doc/images/widget_line_gauge_demo.png +0 -0
  41. data/doc/images/widget_list_demo.png +0 -0
  42. data/doc/images/widget_list_styles.png +0 -0
  43. data/doc/images/widget_popup_demo.png +0 -0
  44. data/doc/images/widget_ratatui_logo_demo.png +0 -0
  45. data/doc/images/widget_ratatui_mascot_demo.png +0 -0
  46. data/doc/images/widget_rect.png +0 -0
  47. data/doc/images/widget_render.png +0 -0
  48. data/doc/images/widget_rich_text.png +0 -0
  49. data/doc/images/widget_scroll_text.png +0 -0
  50. data/doc/images/widget_scrollbar_demo.png +0 -0
  51. data/doc/images/widget_sparkline_demo.png +0 -0
  52. data/doc/images/widget_style_colors.png +0 -0
  53. data/doc/images/widget_table_flex.png +0 -0
  54. data/doc/images/widget_tabs_demo.png +0 -0
  55. data/doc/index.md +1 -0
  56. data/doc/interactive_design.md +116 -0
  57. data/doc/quickstart.md +186 -84
  58. data/examples/app_all_events/README.md +81 -0
  59. data/examples/app_all_events/app.rb +93 -0
  60. data/examples/app_all_events/model/event_color_cycle.rb +41 -0
  61. data/examples/app_all_events/model/event_entry.rb +75 -0
  62. data/examples/app_all_events/model/events.rb +180 -0
  63. data/examples/app_all_events/model/highlight.rb +57 -0
  64. data/examples/app_all_events/model/timestamp.rb +54 -0
  65. data/examples/app_all_events/test/snapshots/after_focus_lost.txt +24 -0
  66. data/examples/app_all_events/test/snapshots/after_focus_regained.txt +24 -0
  67. data/examples/app_all_events/test/snapshots/after_horizontal_resize.txt +24 -0
  68. data/examples/app_all_events/test/snapshots/after_key_a.txt +24 -0
  69. data/examples/app_all_events/test/snapshots/after_key_ctrl_x.txt +24 -0
  70. data/examples/app_all_events/test/snapshots/after_mouse_click.txt +24 -0
  71. data/examples/app_all_events/test/snapshots/after_mouse_drag.txt +24 -0
  72. data/examples/app_all_events/test/snapshots/after_multiple_events.txt +24 -0
  73. data/examples/app_all_events/test/snapshots/after_paste.txt +24 -0
  74. data/examples/app_all_events/test/snapshots/after_resize.txt +24 -0
  75. data/examples/app_all_events/test/snapshots/after_right_click.txt +24 -0
  76. data/examples/app_all_events/test/snapshots/after_vertical_resize.txt +24 -0
  77. data/examples/app_all_events/test/snapshots/initial_state.txt +24 -0
  78. data/examples/app_all_events/view/app_view.rb +78 -0
  79. data/examples/app_all_events/view/controls_view.rb +50 -0
  80. data/examples/app_all_events/view/counts_view.rb +55 -0
  81. data/examples/app_all_events/view/live_view.rb +69 -0
  82. data/examples/app_all_events/view/log_view.rb +60 -0
  83. data/{lib/ratatui_ruby/output.rb → examples/app_all_events/view.rb} +1 -1
  84. data/examples/app_all_events/view_state.rb +42 -0
  85. data/examples/app_color_picker/README.md +94 -0
  86. data/examples/app_color_picker/app.rb +112 -0
  87. data/examples/app_color_picker/clipboard.rb +84 -0
  88. data/examples/app_color_picker/color.rb +191 -0
  89. data/examples/app_color_picker/copy_dialog.rb +170 -0
  90. data/examples/app_color_picker/harmony.rb +56 -0
  91. data/examples/app_color_picker/input.rb +142 -0
  92. data/examples/app_color_picker/palette.rb +80 -0
  93. data/examples/app_color_picker/scene.rb +201 -0
  94. data/examples/app_login_form/app.rb +108 -0
  95. data/examples/app_map_demo/app.rb +93 -0
  96. data/examples/app_table_select/app.rb +201 -0
  97. data/examples/verify_quickstart_dsl/app.rb +45 -0
  98. data/examples/verify_quickstart_layout/app.rb +69 -0
  99. data/examples/verify_quickstart_lifecycle/app.rb +48 -0
  100. data/examples/verify_readme_usage/app.rb +34 -0
  101. data/examples/widget_barchart_demo/app.rb +238 -0
  102. data/examples/widget_block_padding/app.rb +67 -0
  103. data/examples/widget_block_titles/app.rb +69 -0
  104. data/examples/widget_box_demo/app.rb +250 -0
  105. data/examples/widget_calendar_demo/app.rb +109 -0
  106. data/examples/widget_cell_demo/app.rb +104 -0
  107. data/examples/widget_chart_demo/app.rb +213 -0
  108. data/examples/widget_gauge_demo/app.rb +212 -0
  109. data/examples/widget_layout_split/app.rb +246 -0
  110. data/examples/widget_line_gauge_demo/app.rb +217 -0
  111. data/examples/widget_list_demo/app.rb +382 -0
  112. data/examples/widget_list_styles/app.rb +141 -0
  113. data/examples/widget_popup_demo/app.rb +104 -0
  114. data/examples/widget_ratatui_logo_demo/app.rb +103 -0
  115. data/examples/widget_ratatui_mascot_demo/app.rb +93 -0
  116. data/examples/widget_rect/app.rb +205 -0
  117. data/examples/widget_render/app.rb +184 -0
  118. data/examples/widget_rich_text/app.rb +137 -0
  119. data/examples/widget_scroll_text/app.rb +108 -0
  120. data/examples/widget_scrollbar_demo/app.rb +153 -0
  121. data/examples/widget_sparkline_demo/app.rb +274 -0
  122. data/examples/widget_style_colors/app.rb +102 -0
  123. data/examples/widget_table_flex/app.rb +95 -0
  124. data/examples/widget_tabs_demo/app.rb +167 -0
  125. data/ext/ratatui_ruby/Cargo.lock +889 -115
  126. data/ext/ratatui_ruby/Cargo.toml +4 -3
  127. data/ext/ratatui_ruby/clippy.toml +7 -0
  128. data/ext/ratatui_ruby/extconf.rb +7 -0
  129. data/ext/ratatui_ruby/src/events.rs +293 -219
  130. data/ext/ratatui_ruby/src/frame.rs +115 -0
  131. data/ext/ratatui_ruby/src/lib.rs +105 -24
  132. data/ext/ratatui_ruby/src/rendering.rs +94 -10
  133. data/ext/ratatui_ruby/src/style.rs +357 -93
  134. data/ext/ratatui_ruby/src/terminal.rs +121 -31
  135. data/ext/ratatui_ruby/src/text.rs +178 -0
  136. data/ext/ratatui_ruby/src/widgets/barchart.rs +99 -24
  137. data/ext/ratatui_ruby/src/widgets/block.rs +32 -3
  138. data/ext/ratatui_ruby/src/widgets/calendar.rs +45 -44
  139. data/ext/ratatui_ruby/src/widgets/canvas.rs +44 -9
  140. data/ext/ratatui_ruby/src/widgets/chart.rs +79 -27
  141. data/ext/ratatui_ruby/src/widgets/clear.rs +3 -1
  142. data/ext/ratatui_ruby/src/widgets/gauge.rs +11 -4
  143. data/ext/ratatui_ruby/src/widgets/layout.rs +223 -15
  144. data/ext/ratatui_ruby/src/widgets/line_gauge.rs +92 -0
  145. data/ext/ratatui_ruby/src/widgets/list.rs +114 -11
  146. data/ext/ratatui_ruby/src/widgets/mod.rs +3 -0
  147. data/ext/ratatui_ruby/src/widgets/overlay.rs +4 -2
  148. data/ext/ratatui_ruby/src/widgets/paragraph.rs +35 -13
  149. data/ext/ratatui_ruby/src/widgets/ratatui_logo.rs +40 -0
  150. data/ext/ratatui_ruby/src/widgets/ratatui_mascot.rs +51 -0
  151. data/ext/ratatui_ruby/src/widgets/scrollbar.rs +61 -7
  152. data/ext/ratatui_ruby/src/widgets/sparkline.rs +73 -6
  153. data/ext/ratatui_ruby/src/widgets/table.rs +177 -64
  154. data/ext/ratatui_ruby/src/widgets/tabs.rs +105 -5
  155. data/lib/ratatui_ruby/cell.rb +166 -0
  156. data/lib/ratatui_ruby/event/focus_gained.rb +49 -0
  157. data/lib/ratatui_ruby/event/focus_lost.rb +50 -0
  158. data/lib/ratatui_ruby/event/key.rb +211 -0
  159. data/lib/ratatui_ruby/event/mouse.rb +124 -0
  160. data/lib/ratatui_ruby/event/none.rb +43 -0
  161. data/lib/ratatui_ruby/event/paste.rb +71 -0
  162. data/lib/ratatui_ruby/event/resize.rb +80 -0
  163. data/lib/ratatui_ruby/event.rb +131 -0
  164. data/lib/ratatui_ruby/frame.rb +87 -0
  165. data/lib/ratatui_ruby/schema/bar_chart/bar.rb +45 -0
  166. data/lib/ratatui_ruby/schema/bar_chart/bar_group.rb +23 -0
  167. data/lib/ratatui_ruby/schema/bar_chart.rb +226 -17
  168. data/lib/ratatui_ruby/schema/block.rb +178 -11
  169. data/lib/ratatui_ruby/schema/calendar.rb +70 -14
  170. data/lib/ratatui_ruby/schema/canvas.rb +213 -46
  171. data/lib/ratatui_ruby/schema/center.rb +46 -8
  172. data/lib/ratatui_ruby/schema/chart.rb +134 -32
  173. data/lib/ratatui_ruby/schema/clear.rb +22 -53
  174. data/lib/ratatui_ruby/schema/constraint.rb +72 -12
  175. data/lib/ratatui_ruby/schema/cursor.rb +23 -5
  176. data/lib/ratatui_ruby/schema/draw.rb +53 -0
  177. data/lib/ratatui_ruby/schema/gauge.rb +56 -12
  178. data/lib/ratatui_ruby/schema/layout.rb +91 -9
  179. data/lib/ratatui_ruby/schema/line_gauge.rb +78 -0
  180. data/lib/ratatui_ruby/schema/list.rb +92 -16
  181. data/lib/ratatui_ruby/schema/overlay.rb +29 -3
  182. data/lib/ratatui_ruby/schema/paragraph.rb +82 -25
  183. data/lib/ratatui_ruby/schema/ratatui_logo.rb +29 -0
  184. data/lib/ratatui_ruby/schema/ratatui_mascot.rb +34 -0
  185. data/lib/ratatui_ruby/schema/rect.rb +59 -10
  186. data/lib/ratatui_ruby/schema/scrollbar.rb +127 -19
  187. data/lib/ratatui_ruby/schema/shape/label.rb +66 -0
  188. data/lib/ratatui_ruby/schema/sparkline.rb +120 -12
  189. data/lib/ratatui_ruby/schema/style.rb +39 -11
  190. data/lib/ratatui_ruby/schema/table.rb +109 -18
  191. data/lib/ratatui_ruby/schema/tabs.rb +71 -10
  192. data/lib/ratatui_ruby/schema/text.rb +90 -0
  193. data/lib/ratatui_ruby/session/autodoc.rb +417 -0
  194. data/lib/ratatui_ruby/session.rb +163 -0
  195. data/lib/ratatui_ruby/test_helper.rb +322 -13
  196. data/lib/ratatui_ruby/version.rb +1 -1
  197. data/lib/ratatui_ruby.rb +184 -38
  198. data/sig/examples/app_all_events/app.rbs +11 -0
  199. data/sig/examples/app_all_events/model/event_entry.rbs +16 -0
  200. data/sig/examples/app_all_events/model/events.rbs +15 -0
  201. data/sig/examples/app_all_events/model/timestamp.rbs +11 -0
  202. data/sig/examples/app_all_events/view/app_view.rbs +8 -0
  203. data/sig/examples/app_all_events/view/controls_view.rbs +6 -0
  204. data/sig/examples/app_all_events/view/counts_view.rbs +6 -0
  205. data/sig/examples/app_all_events/view/live_view.rbs +6 -0
  206. data/sig/examples/app_all_events/view/log_view.rbs +6 -0
  207. data/sig/examples/app_all_events/view.rbs +8 -0
  208. data/sig/examples/app_all_events/view_state.rbs +15 -0
  209. data/sig/examples/app_color_picker/app.rbs +12 -0
  210. data/sig/examples/app_login_form/app.rbs +11 -0
  211. data/sig/examples/app_map_demo/app.rbs +11 -0
  212. data/sig/examples/app_table_select/app.rbs +11 -0
  213. data/sig/examples/verify_quickstart_dsl/app.rbs +11 -0
  214. data/sig/examples/verify_quickstart_lifecycle/app.rbs +11 -0
  215. data/sig/examples/verify_readme_usage/app.rbs +11 -0
  216. data/sig/examples/widget_block_padding/app.rbs +11 -0
  217. data/sig/examples/widget_block_titles/app.rbs +11 -0
  218. data/sig/examples/widget_box_demo/app.rbs +11 -0
  219. data/sig/examples/widget_calendar_demo/app.rbs +11 -0
  220. data/sig/examples/widget_cell_demo/app.rbs +11 -0
  221. data/sig/examples/widget_chart_demo/app.rbs +11 -0
  222. data/sig/examples/widget_gauge_demo/app.rbs +11 -0
  223. data/sig/examples/widget_layout_split/app.rbs +10 -0
  224. data/sig/examples/widget_line_gauge_demo/app.rbs +11 -0
  225. data/sig/examples/widget_list_demo/app.rbs +12 -0
  226. data/sig/examples/widget_list_styles/app.rbs +11 -0
  227. data/sig/examples/widget_popup_demo/app.rbs +11 -0
  228. data/sig/examples/widget_ratatui_logo_demo/app.rbs +11 -0
  229. data/sig/examples/widget_ratatui_mascot_demo/app.rbs +11 -0
  230. data/sig/examples/widget_rect/app.rbs +12 -0
  231. data/sig/examples/widget_render/app.rbs +10 -0
  232. data/sig/examples/widget_rich_text/app.rbs +11 -0
  233. data/sig/examples/widget_scroll_text/app.rbs +11 -0
  234. data/sig/examples/widget_scrollbar_demo/app.rbs +11 -0
  235. data/sig/examples/widget_sparkline_demo/app.rbs +10 -0
  236. data/sig/examples/widget_style_colors/app.rbs +14 -0
  237. data/sig/examples/widget_table_flex/app.rbs +11 -0
  238. data/sig/ratatui_ruby/event.rbs +69 -0
  239. data/sig/ratatui_ruby/frame.rbs +9 -0
  240. data/sig/ratatui_ruby/ratatui_ruby.rbs +5 -3
  241. data/sig/ratatui_ruby/schema/bar_chart/bar.rbs +16 -0
  242. data/sig/ratatui_ruby/schema/bar_chart/bar_group.rbs +13 -0
  243. data/sig/ratatui_ruby/schema/bar_chart.rbs +20 -2
  244. data/sig/ratatui_ruby/schema/block.rbs +5 -4
  245. data/sig/ratatui_ruby/schema/calendar.rbs +6 -2
  246. data/sig/ratatui_ruby/schema/canvas.rbs +52 -39
  247. data/sig/ratatui_ruby/schema/center.rbs +3 -3
  248. data/sig/ratatui_ruby/schema/chart.rbs +8 -5
  249. data/sig/ratatui_ruby/schema/constraint.rbs +8 -5
  250. data/sig/ratatui_ruby/schema/cursor.rbs +1 -1
  251. data/sig/ratatui_ruby/schema/draw.rbs +27 -0
  252. data/sig/ratatui_ruby/schema/gauge.rbs +4 -2
  253. data/sig/ratatui_ruby/schema/layout.rbs +11 -1
  254. data/sig/ratatui_ruby/schema/line_gauge.rbs +16 -0
  255. data/sig/ratatui_ruby/schema/list.rbs +5 -1
  256. data/sig/ratatui_ruby/schema/paragraph.rbs +4 -1
  257. data/sig/ratatui_ruby/schema/ratatui_logo.rbs +8 -0
  258. data/sig/ratatui_ruby/{buffer.rbs → schema/ratatui_mascot.rbs} +4 -3
  259. data/sig/ratatui_ruby/schema/rect.rbs +2 -1
  260. data/sig/ratatui_ruby/schema/scrollbar.rbs +18 -2
  261. data/sig/ratatui_ruby/schema/sparkline.rbs +6 -2
  262. data/sig/ratatui_ruby/schema/table.rbs +8 -1
  263. data/sig/ratatui_ruby/schema/tabs.rbs +5 -1
  264. data/sig/ratatui_ruby/schema/text.rbs +22 -0
  265. data/sig/ratatui_ruby/session.rbs +94 -0
  266. data/tasks/autodoc/inventory.rb +61 -0
  267. data/tasks/autodoc/member.rb +56 -0
  268. data/tasks/autodoc/name.rb +19 -0
  269. data/tasks/autodoc/notice.rb +26 -0
  270. data/tasks/autodoc/rbs.rb +38 -0
  271. data/tasks/autodoc/rdoc.rb +45 -0
  272. data/tasks/autodoc.rake +47 -0
  273. data/tasks/bump/history.rb +2 -2
  274. data/tasks/doc.rake +600 -6
  275. data/tasks/example_viewer.html.erb +172 -0
  276. data/tasks/lint.rake +8 -4
  277. data/tasks/resources/build.yml.erb +13 -11
  278. data/tasks/resources/index.html.erb +6 -0
  279. data/tasks/sourcehut.rake +4 -4
  280. data/tasks/terminal_preview/app_screenshot.rb +33 -0
  281. data/tasks/terminal_preview/crash_report.rb +52 -0
  282. data/tasks/terminal_preview/example_app.rb +25 -0
  283. data/tasks/terminal_preview/launcher_script.rb +46 -0
  284. data/tasks/terminal_preview/preview_collection.rb +58 -0
  285. data/tasks/terminal_preview/preview_timing.rb +22 -0
  286. data/tasks/terminal_preview/safety_confirmation.rb +56 -0
  287. data/tasks/terminal_preview/saved_screenshot.rb +53 -0
  288. data/tasks/terminal_preview/system_appearance.rb +11 -0
  289. data/tasks/terminal_preview/terminal_window.rb +136 -0
  290. data/tasks/terminal_preview/window_id.rb +14 -0
  291. data/tasks/terminal_preview.rake +28 -0
  292. data/tasks/test.rake +2 -2
  293. data/tasks/website/index_page.rb +3 -3
  294. data/tasks/website/version.rb +10 -10
  295. data/tasks/website/version_menu.rb +10 -12
  296. data/tasks/website/versioned_documentation.rb +49 -17
  297. data/tasks/website/website.rb +6 -8
  298. data/tasks/website.rake +4 -4
  299. metadata +206 -54
  300. data/LICENSES/BSD-2-Clause.txt +0 -9
  301. data/doc/images/examples-analytics.rb.png +0 -0
  302. data/doc/images/examples-box_demo.rb.png +0 -0
  303. data/doc/images/examples-calendar_demo.rb.png +0 -0
  304. data/doc/images/examples-chart_demo.rb.png +0 -0
  305. data/doc/images/examples-custom_widget.rb.png +0 -0
  306. data/doc/images/examples-dashboard.rb.png +0 -0
  307. data/doc/images/examples-list_styles.rb.png +0 -0
  308. data/doc/images/examples-login_form.rb.png +0 -0
  309. data/doc/images/examples-map_demo.rb.png +0 -0
  310. data/doc/images/examples-mouse_events.rb.png +0 -0
  311. data/doc/images/examples-popup_demo.rb.gif +0 -0
  312. data/doc/images/examples-quickstart_lifecycle.rb.png +0 -0
  313. data/doc/images/examples-scroll_text.rb.png +0 -0
  314. data/doc/images/examples-scrollbar_demo.rb.png +0 -0
  315. data/doc/images/examples-stock_ticker.rb.png +0 -0
  316. data/doc/images/examples-system_monitor.rb.png +0 -0
  317. data/doc/images/examples-table_select.rb.png +0 -0
  318. data/examples/analytics.rb +0 -88
  319. data/examples/box_demo.rb +0 -71
  320. data/examples/calendar_demo.rb +0 -55
  321. data/examples/chart_demo.rb +0 -84
  322. data/examples/custom_widget.rb +0 -43
  323. data/examples/dashboard.rb +0 -72
  324. data/examples/list_styles.rb +0 -66
  325. data/examples/login_form.rb +0 -115
  326. data/examples/map_demo.rb +0 -58
  327. data/examples/mouse_events.rb +0 -95
  328. data/examples/popup_demo.rb +0 -105
  329. data/examples/quickstart_dsl.rb +0 -30
  330. data/examples/quickstart_lifecycle.rb +0 -40
  331. data/examples/readme_usage.rb +0 -21
  332. data/examples/scroll_text.rb +0 -74
  333. data/examples/scrollbar_demo.rb +0 -75
  334. data/examples/stock_ticker.rb +0 -93
  335. data/examples/system_monitor.rb +0 -94
  336. data/examples/table_select.rb +0 -70
  337. data/examples/test_analytics.rb +0 -65
  338. data/examples/test_box_demo.rb +0 -38
  339. data/examples/test_calendar_demo.rb +0 -66
  340. data/examples/test_dashboard.rb +0 -38
  341. data/examples/test_list_styles.rb +0 -61
  342. data/examples/test_login_form.rb +0 -63
  343. data/examples/test_map_demo.rb +0 -100
  344. data/examples/test_popup_demo.rb +0 -62
  345. data/examples/test_scroll_text.rb +0 -130
  346. data/examples/test_stock_ticker.rb +0 -39
  347. data/examples/test_system_monitor.rb +0 -40
  348. data/examples/test_table_select.rb +0 -37
  349. data/ext/ratatui_ruby/src/buffer.rs +0 -54
  350. data/lib/ratatui_ruby/dsl.rb +0 -64
@@ -1,14 +1,58 @@
1
1
  // SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
2
+ //
2
3
  // SPDX-License-Identifier: AGPL-3.0-or-later
3
4
 
5
+ use bumpalo::Bump;
4
6
  use magnus::{prelude::*, Error, Symbol, Value};
5
7
  use ratatui::{
8
+ layout::Alignment,
6
9
  style::{Color, Modifier, Style},
7
- widgets::{Block, Borders},
10
+ symbols,
11
+ text::Line,
12
+ widgets::{Block, BorderType, Borders, Padding},
8
13
  };
9
14
 
10
15
  pub fn parse_color(color_str: &str) -> Option<Color> {
11
- color_str.parse::<Color>().ok()
16
+ // Try standard ratatui parsing first (named colors, indexed, etc.)
17
+ if let Ok(color) = color_str.parse::<Color>() {
18
+ return Some(color);
19
+ }
20
+
21
+ // Try hex parsing manually: #RRGGBB
22
+ let hex_str = color_str.trim();
23
+ if hex_str.starts_with('#') && hex_str.len() == 7 {
24
+ if let Ok(hex_val) = u32::from_str_radix(&hex_str[1..], 16) {
25
+ let r = ((hex_val >> 16) & 0xFF) as u8;
26
+ let g = ((hex_val >> 8) & 0xFF) as u8;
27
+ let b = (hex_val & 0xFF) as u8;
28
+ return Some(Color::Rgb(r, g, b));
29
+ }
30
+ }
31
+
32
+ None
33
+ }
34
+
35
+ pub fn parse_color_value(val: Value) -> Result<Option<Color>, Error> {
36
+ if val.is_nil() {
37
+ return Ok(None);
38
+ }
39
+ let s: String = val.funcall("to_s", ())?;
40
+ Ok(parse_color(&s))
41
+ }
42
+
43
+ pub fn parse_modifier_str(s: &str) -> Option<Modifier> {
44
+ match s {
45
+ "bold" => Some(Modifier::BOLD),
46
+ "italic" => Some(Modifier::ITALIC),
47
+ "dim" => Some(Modifier::DIM),
48
+ "reversed" => Some(Modifier::REVERSED),
49
+ "underlined" => Some(Modifier::UNDERLINED),
50
+ "slow_blink" => Some(Modifier::SLOW_BLINK),
51
+ "rapid_blink" => Some(Modifier::RAPID_BLINK),
52
+ "crossed_out" => Some(Modifier::CROSSED_OUT),
53
+ "hidden" => Some(Modifier::HIDDEN),
54
+ _ => None,
55
+ }
12
56
  }
13
57
 
14
58
  pub fn parse_style(style_val: Value) -> Result<Style, Error> {
@@ -19,44 +63,49 @@ pub fn parse_style(style_val: Value) -> Result<Style, Error> {
19
63
 
20
64
  let mut style = Style::default();
21
65
 
22
- let fg: Value = style_val.funcall("fg", ())?;
66
+ let (fg, bg, modifiers_val) = if let Some(hash) = magnus::RHash::from_value(style_val) {
67
+ (
68
+ hash.lookup(ruby.to_symbol("fg"))
69
+ .unwrap_or_else(|_| ruby.qnil().as_value()),
70
+ hash.lookup(ruby.to_symbol("bg"))
71
+ .unwrap_or_else(|_| ruby.qnil().as_value()),
72
+ hash.lookup(ruby.to_symbol("modifiers"))
73
+ .unwrap_or_else(|_| ruby.qnil().as_value()),
74
+ )
75
+ } else {
76
+ (
77
+ style_val.funcall("fg", ())?,
78
+ style_val.funcall("bg", ())?,
79
+ style_val.funcall("modifiers", ())?,
80
+ )
81
+ };
82
+
23
83
  if !fg.is_nil() {
24
- let fg_str: String = fg.funcall("to_s", ())?;
25
- if let Some(color) = parse_color(&fg_str) {
26
- style = style.fg(color);
84
+ if let Ok(fg_str) = fg.funcall::<_, _, String>("to_s", ()) {
85
+ if let Some(color) = parse_color(&fg_str) {
86
+ style = style.fg(color);
87
+ }
27
88
  }
28
89
  }
29
90
 
30
- let bg: Value = style_val.funcall("bg", ())?;
31
91
  if !bg.is_nil() {
32
- let bg_str: String = bg.funcall("to_s", ())?;
33
- if let Some(color) = parse_color(&bg_str) {
34
- style = style.bg(color);
92
+ if let Ok(bg_str) = bg.funcall::<_, _, String>("to_s", ()) {
93
+ if let Some(color) = parse_color(&bg_str) {
94
+ style = style.bg(color);
95
+ }
35
96
  }
36
97
  }
37
98
 
38
- let modifiers_val: Value = style_val.funcall("modifiers", ())?;
39
99
  if !modifiers_val.is_nil() {
40
- let modifiers_array = magnus::RArray::from_value(modifiers_val).ok_or_else(|| {
41
- Error::new(
42
- ruby.exception_type_error(),
43
- "expected array for modifiers",
44
- )
45
- })?;
46
-
47
- for i in 0..modifiers_array.len() {
48
- let sym: Symbol = modifiers_array.entry(i as isize)?;
49
- match sym.to_string().as_str() {
50
- "bold" => style = style.add_modifier(Modifier::BOLD),
51
- "italic" => style = style.add_modifier(Modifier::ITALIC),
52
- "dim" => style = style.add_modifier(Modifier::DIM),
53
- "reversed" => style = style.add_modifier(Modifier::REVERSED),
54
- "underlined" => style = style.add_modifier(Modifier::UNDERLINED),
55
- "slow_blink" => style = style.add_modifier(Modifier::SLOW_BLINK),
56
- "rapid_blink" => style = style.add_modifier(Modifier::RAPID_BLINK),
57
- "crossed_out" => style = style.add_modifier(Modifier::CROSSED_OUT),
58
- "hidden" => style = style.add_modifier(Modifier::HIDDEN),
59
- _ => {}
100
+ if let Some(modifiers_array) = magnus::RArray::from_value(modifiers_val) {
101
+ for i in 0..modifiers_array.len() {
102
+ let index = isize::try_from(i)
103
+ .map_err(|e| Error::new(ruby.exception_range_error(), e.to_string()))?;
104
+ if let Ok(sym) = modifiers_array.entry::<Symbol>(index) {
105
+ if let Some(m) = parse_modifier_str(&sym.to_string()) {
106
+ style = style.add_modifier(m);
107
+ }
108
+ }
60
109
  }
61
110
  }
62
111
  }
@@ -64,87 +113,302 @@ pub fn parse_style(style_val: Value) -> Result<Style, Error> {
64
113
  Ok(style)
65
114
  }
66
115
 
67
- pub fn parse_block(block_val: Value) -> Result<Block<'static>, Error> {
116
+ pub fn parse_border_set<'a>(
117
+ set_val: Value,
118
+ bump: &'a Bump,
119
+ ) -> Result<symbols::border::Set<'a>, Error> {
120
+ let ruby = magnus::Ruby::get().unwrap();
121
+ let hash = magnus::RHash::from_value(set_val)
122
+ .ok_or_else(|| Error::new(ruby.exception_type_error(), "expected hash for border_set"))?;
123
+
124
+ let get_char = |key: &str| -> Result<Option<&'a str>, Error> {
125
+ let mut val: Value = hash
126
+ .lookup(ruby.to_symbol(key))
127
+ .unwrap_or_else(|_| ruby.qnil().as_value());
128
+ if val.is_nil() {
129
+ val = hash
130
+ .lookup(ruby.str_new(key))
131
+ .unwrap_or_else(|_| ruby.qnil().as_value());
132
+ }
133
+ if val.is_nil() {
134
+ Ok(None)
135
+ } else {
136
+ let s: String = val.funcall("to_s", ())?;
137
+ Ok(Some(bump.alloc_str(&s)))
138
+ }
139
+ };
140
+
141
+ let mut set = symbols::border::Set::default();
142
+ if let Some(s) = get_char("top_left")? {
143
+ set.top_left = s;
144
+ }
145
+ if let Some(s) = get_char("top_right")? {
146
+ set.top_right = s;
147
+ }
148
+ if let Some(s) = get_char("bottom_left")? {
149
+ set.bottom_left = s;
150
+ }
151
+ if let Some(s) = get_char("bottom_right")? {
152
+ set.bottom_right = s;
153
+ }
154
+ if let Some(s) = get_char("vertical_left")? {
155
+ set.vertical_left = s;
156
+ }
157
+ if let Some(s) = get_char("vertical_right")? {
158
+ set.vertical_right = s;
159
+ }
160
+ if let Some(s) = get_char("horizontal_top")? {
161
+ set.horizontal_top = s;
162
+ }
163
+ if let Some(s) = get_char("horizontal_bottom")? {
164
+ set.horizontal_bottom = s;
165
+ }
166
+
167
+ Ok(set)
168
+ }
169
+
170
+ pub fn parse_bar_set<'a>(set_val: Value, bump: &'a Bump) -> Result<symbols::bar::Set<'a>, Error> {
171
+ let ruby = magnus::Ruby::get().unwrap();
172
+ let hash = magnus::RHash::from_value(set_val)
173
+ .ok_or_else(|| Error::new(ruby.exception_type_error(), "expected hash for bar_set"))?;
174
+
175
+ let get_char = |key: &str| -> Result<Option<&'a str>, Error> {
176
+ let mut val: Value = hash
177
+ .lookup(ruby.to_symbol(key))
178
+ .unwrap_or_else(|_| ruby.qnil().as_value());
179
+ if val.is_nil() {
180
+ val = hash
181
+ .lookup(ruby.str_new(key))
182
+ .unwrap_or_else(|_| ruby.qnil().as_value());
183
+ }
184
+ if val.is_nil() {
185
+ Ok(None)
186
+ } else {
187
+ let s: String = val.funcall("to_s", ())?;
188
+ Ok(Some(bump.alloc_str(&s)))
189
+ }
190
+ };
191
+
192
+ let mut set = symbols::bar::Set::default();
193
+ if let Some(s) = get_char("empty")? {
194
+ set.empty = s;
195
+ }
196
+ if let Some(s) = get_char("one_eighth")? {
197
+ set.one_eighth = s;
198
+ }
199
+ if let Some(s) = get_char("one_quarter")? {
200
+ set.one_quarter = s;
201
+ }
202
+ if let Some(s) = get_char("three_eighths")? {
203
+ set.three_eighths = s;
204
+ }
205
+ if let Some(s) = get_char("half")? {
206
+ set.half = s;
207
+ }
208
+ if let Some(s) = get_char("five_eighths")? {
209
+ set.five_eighths = s;
210
+ }
211
+ if let Some(s) = get_char("three_quarters")? {
212
+ set.three_quarters = s;
213
+ }
214
+ if let Some(s) = get_char("seven_eighths")? {
215
+ set.seven_eighths = s;
216
+ }
217
+ if let Some(s) = get_char("full")? {
218
+ set.full = s;
219
+ }
220
+
221
+ Ok(set)
222
+ }
223
+
224
+ pub fn parse_block(block_val: Value, bump: &Bump) -> Result<Block<'_>, Error> {
68
225
  if block_val.is_nil() {
69
226
  return Ok(Block::default());
70
227
  }
71
228
 
72
- let title: Value = block_val.funcall("title", ())?;
73
- let borders_val: Value = block_val.funcall("borders", ())?;
74
- let border_color: Value = block_val.funcall("border_color", ())?;
75
-
76
229
  let mut block = Block::default();
230
+ if let Ok(v) = block_val.funcall::<&str, _, Value>("style", ()) {
231
+ if !v.is_nil() {
232
+ block = block.style(parse_style(v)?);
233
+ }
234
+ }
235
+
236
+ if let Ok(v) = block_val.funcall::<&str, _, Value>("title_style", ()) {
237
+ if !v.is_nil() {
238
+ block = block.title_style(parse_style(v)?);
239
+ }
240
+ }
77
241
 
78
- if !title.is_nil() {
79
- let title_str: String = title.funcall("to_s", ())?;
80
- block = block.title(title_str);
81
- }
82
-
83
- if !borders_val.is_nil() {
84
- let mut ratatui_borders = Borders::NONE;
85
- if let Some(sym) = Symbol::from_value(borders_val) {
86
- match sym.to_string().as_str() {
87
- "all" => ratatui_borders = Borders::ALL,
88
- "top" => ratatui_borders = Borders::TOP,
89
- "bottom" => ratatui_borders = Borders::BOTTOM,
90
- "left" => ratatui_borders = Borders::LEFT,
91
- "right" => ratatui_borders = Borders::RIGHT,
92
- _ => {}
242
+ if let Ok(title) = block_val.funcall::<&str, _, Value>("title", ()) {
243
+ if !title.is_nil() {
244
+ let s: String = title.funcall("to_s", ())?;
245
+ block = block.title(Line::from(s));
246
+ }
247
+ }
248
+
249
+ if let Ok(v) = block_val.funcall::<&str, _, Value>("title_alignment", ()) {
250
+ if let Some(align_sym) = Symbol::from_value(v) {
251
+ match align_sym.to_string().as_str() {
252
+ "center" => block = block.title_alignment(Alignment::Center),
253
+ "right" => block = block.title_alignment(Alignment::Right),
254
+ _ => block = block.title_alignment(Alignment::Left),
93
255
  }
94
- } else if let Some(borders_array) = magnus::RArray::from_value(borders_val) {
95
- for i in 0..borders_array.len() {
96
- let sym: Symbol = borders_array.entry(i as isize)?;
256
+ }
257
+ }
258
+
259
+ block = parse_titles(block_val, block)?;
260
+ block = parse_borders(block_val, block, bump)?;
261
+ block = parse_padding(block_val, block);
262
+
263
+ Ok(block)
264
+ }
265
+
266
+ fn parse_titles(block_val: Value, mut block: Block<'_>) -> Result<Block<'_>, Error> {
267
+ if let Ok(titles_val) = block_val.funcall::<&str, _, Value>("titles", ()) {
268
+ if titles_val.is_nil() {
269
+ return Ok(block);
270
+ }
271
+ if let Some(titles_array) = magnus::RArray::from_value(titles_val) {
272
+ for i in 0..titles_array.len() {
273
+ let ruby = magnus::Ruby::get().unwrap();
274
+ let index = isize::try_from(i)
275
+ .map_err(|e| Error::new(ruby.exception_range_error(), e.to_string()))?;
276
+ let title_item: Value = titles_array.entry(index)?;
277
+ let mut content = String::new();
278
+ let mut alignment = Alignment::Left;
279
+ let mut is_bottom = false;
280
+ let mut style = Style::default();
281
+
282
+ if let Some(hash) = magnus::RHash::from_value(title_item) {
283
+ if let Ok(v) = hash.lookup::<_, Value>(ruby.to_symbol("content")) {
284
+ if !v.is_nil() {
285
+ content = v.funcall("to_s", ())?;
286
+ }
287
+ }
288
+ if let Ok(v) = hash.lookup::<_, Value>(ruby.to_symbol("alignment")) {
289
+ if let Some(s) = Symbol::from_value(v) {
290
+ match s.to_string().as_str() {
291
+ "center" => alignment = Alignment::Center,
292
+ "right" => alignment = Alignment::Right,
293
+ _ => {}
294
+ }
295
+ }
296
+ }
297
+ if let Ok(v) = hash.lookup::<_, Value>(ruby.to_symbol("position")) {
298
+ if let Some(s) = Symbol::from_value(v) {
299
+ if s.to_string().as_str() == "bottom" {
300
+ is_bottom = true;
301
+ }
302
+ }
303
+ }
304
+ if let Ok(v) = hash.lookup::<_, Value>(ruby.to_symbol("style")) {
305
+ if !v.is_nil() {
306
+ style = parse_style(v)?;
307
+ }
308
+ }
309
+ } else {
310
+ content = title_item.funcall("to_s", ())?;
311
+ }
312
+
313
+ let line = Line::from(content).alignment(alignment).style(style);
314
+ block = if is_bottom {
315
+ block.title_bottom(line)
316
+ } else {
317
+ block.title_top(line)
318
+ };
319
+ }
320
+ }
321
+ }
322
+ Ok(block)
323
+ }
324
+
325
+ fn parse_borders<'a>(
326
+ block_val: Value,
327
+ mut block: Block<'a>,
328
+ bump: &'a Bump,
329
+ ) -> Result<Block<'a>, Error> {
330
+ if let Ok(borders_val) = block_val.funcall::<&str, _, Value>("borders", ()) {
331
+ if !borders_val.is_nil() {
332
+ let mut ratatui_borders = Borders::NONE;
333
+ if let Some(sym) = Symbol::from_value(borders_val) {
97
334
  match sym.to_string().as_str() {
98
- "all" => ratatui_borders |= Borders::ALL,
99
- "top" => ratatui_borders |= Borders::TOP,
100
- "bottom" => ratatui_borders |= Borders::BOTTOM,
101
- "left" => ratatui_borders |= Borders::LEFT,
102
- "right" => ratatui_borders |= Borders::RIGHT,
335
+ "all" => ratatui_borders = Borders::ALL,
336
+ "top" => ratatui_borders = Borders::TOP,
337
+ "bottom" => ratatui_borders = Borders::BOTTOM,
338
+ "left" => ratatui_borders = Borders::LEFT,
339
+ "right" => ratatui_borders = Borders::RIGHT,
103
340
  _ => {}
104
341
  }
342
+ } else if let Some(arr) = magnus::RArray::from_value(borders_val) {
343
+ for i in 0..arr.len() {
344
+ let ruby = magnus::Ruby::get().unwrap();
345
+ let index = isize::try_from(i)
346
+ .map_err(|e| Error::new(ruby.exception_range_error(), e.to_string()))?;
347
+ let sym: Symbol = arr.entry(index)?;
348
+ match sym.to_string().as_str() {
349
+ "all" => ratatui_borders |= Borders::ALL,
350
+ "top" => ratatui_borders |= Borders::TOP,
351
+ "bottom" => ratatui_borders |= Borders::BOTTOM,
352
+ "left" => ratatui_borders |= Borders::LEFT,
353
+ "right" => ratatui_borders |= Borders::RIGHT,
354
+ _ => {}
355
+ }
356
+ }
105
357
  }
358
+ block = block.borders(ratatui_borders);
106
359
  }
107
- block = block.borders(ratatui_borders);
108
360
  }
109
361
 
110
- if !border_color.is_nil() {
111
- let color_str: String = border_color.funcall("to_s", ())?;
112
- if let Some(color) = parse_color(&color_str) {
113
- block = block.border_style(Style::default().fg(color));
362
+ if let Ok(v) = block_val.funcall::<&str, _, Value>("border_style", ()) {
363
+ if !v.is_nil() {
364
+ block = block.border_style(parse_style(v)?);
365
+ } else if let Ok(color_val) = block_val.funcall::<&str, _, Value>("border_color", ()) {
366
+ if !color_val.is_nil() {
367
+ if let Ok(s) = color_val.funcall::<&str, _, String>("to_s", ()) {
368
+ if let Some(c) = parse_color(&s) {
369
+ block = block.border_style(Style::default().fg(c));
370
+ }
371
+ }
372
+ }
114
373
  }
115
374
  }
116
375
 
376
+ if let Ok(v) = block_val.funcall::<&str, _, Value>("border_set", ()) {
377
+ if !v.is_nil() {
378
+ block = block.border_set(parse_border_set(v, bump)?);
379
+ } else if let Ok(v) = block_val.funcall::<&str, _, Value>("border_type", ()) {
380
+ if let Some(sym) = Symbol::from_value(v) {
381
+ match sym.to_string().as_str() {
382
+ "rounded" => block = block.border_type(BorderType::Rounded),
383
+ "double" => block = block.border_type(BorderType::Double),
384
+ "thick" => block = block.border_type(BorderType::Thick),
385
+ "quadrant_inside" => block = block.border_type(BorderType::QuadrantInside),
386
+ "quadrant_outside" => block = block.border_type(BorderType::QuadrantOutside),
387
+ _ => block = block.border_type(BorderType::Plain),
388
+ }
389
+ }
390
+ }
391
+ }
117
392
  Ok(block)
118
393
  }
119
394
 
120
- #[cfg(test)]
121
- mod tests {
122
- use super::*;
123
-
124
- #[test]
125
- fn test_parse_color() {
126
- assert_eq!(parse_color("red"), Some(Color::Red));
127
- assert_eq!(parse_color("blue"), Some(Color::Blue));
128
- assert_eq!(parse_color("black"), Some(Color::Black));
129
- assert_eq!(parse_color("white"), Some(Color::White));
130
- assert_eq!(parse_color("green"), Some(Color::Green));
131
- assert_eq!(parse_color("yellow"), Some(Color::Yellow));
132
- assert_eq!(parse_color("magenta"), Some(Color::Magenta));
133
- assert_eq!(parse_color("cyan"), Some(Color::Cyan));
134
- assert_eq!(parse_color("gray"), Some(Color::Gray));
135
- assert_eq!(parse_color("dark_gray"), Some(Color::DarkGray));
136
- assert_eq!(parse_color("light_red"), Some(Color::LightRed));
137
- assert_eq!(parse_color("light_green"), Some(Color::LightGreen));
138
- assert_eq!(parse_color("light_yellow"), Some(Color::LightYellow));
139
- assert_eq!(parse_color("light_blue"), Some(Color::LightBlue));
140
- assert_eq!(parse_color("light_magenta"), Some(Color::LightMagenta));
141
- assert_eq!(parse_color("light_cyan"), Some(Color::LightCyan));
142
-
143
- assert_eq!(parse_color("#ffffff"), Some(Color::Rgb(255, 255, 255)));
144
- assert_eq!(parse_color("#000000"), Some(Color::Rgb(0, 0, 0)));
145
- assert_eq!(parse_color("#FF0000"), Some(Color::Rgb(255, 0, 0)));
146
-
147
- assert_eq!(parse_color("invalid"), None);
148
- assert_eq!(parse_color(""), None);
395
+ fn parse_padding(block_val: Value, block: Block<'_>) -> Block<'_> {
396
+ if let Ok(padding_val) = block_val.funcall::<&str, _, Value>("padding", ()) {
397
+ if padding_val.is_nil() {
398
+ return block;
399
+ }
400
+ if let Ok(p) = u16::try_convert(padding_val) {
401
+ return block.padding(Padding::uniform(p));
402
+ }
403
+ if let Some(arr) = magnus::RArray::from_value(padding_val) {
404
+ if arr.len() == 4 {
405
+ let left: u16 = arr.entry(0).unwrap_or(0);
406
+ let right: u16 = arr.entry(1).unwrap_or(0);
407
+ let top: u16 = arr.entry(2).unwrap_or(0);
408
+ let bottom: u16 = arr.entry(3).unwrap_or(0);
409
+ return block.padding(Padding::new(left, right, top, bottom));
410
+ }
411
+ }
149
412
  }
413
+ block
150
414
  }