RubyGems - ratatui_ruby - Versions diffs - 0.3.1 → 0.5.0 - Mend

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

checksums.yaml +4 -4
data/.builds/ruby-3.2.yml +14 -12
data/.builds/ruby-3.3.yml +14 -12
data/.builds/ruby-3.4.yml +14 -12
data/.builds/ruby-4.0.0.yml +14 -12
data/AGENTS.md +89 -132
data/CHANGELOG.md +223 -1
data/README.md +23 -16
data/REUSE.toml +20 -0
data/doc/application_architecture.md +176 -0
data/doc/application_testing.md +17 -10
data/doc/contributors/design/ruby_frontend.md +11 -7
data/doc/contributors/developing_examples.md +261 -0
data/doc/contributors/documentation_style.md +104 -0
data/doc/contributors/dwim_dx.md +366 -0
data/doc/contributors/index.md +2 -0
data/doc/custom.css +14 -0
data/doc/event_handling.md +125 -0
data/doc/images/app_all_events.png +0 -0
data/doc/images/app_analytics.png +0 -0
data/doc/images/app_color_picker.png +0 -0
data/doc/images/app_custom_widget.png +0 -0
data/doc/images/app_login_form.png +0 -0
data/doc/images/app_map_demo.png +0 -0
data/doc/images/app_mouse_events.png +0 -0
data/doc/images/app_table_select.png +0 -0
data/doc/images/verify_quickstart_dsl.png +0 -0
data/doc/images/verify_quickstart_layout.png +0 -0
data/doc/images/verify_quickstart_lifecycle.png +0 -0
data/doc/images/verify_readme_usage.png +0 -0
data/doc/images/widget_barchart_demo.png +0 -0
data/doc/images/widget_block_padding.png +0 -0
data/doc/images/widget_block_titles.png +0 -0
data/doc/images/widget_box_demo.png +0 -0
data/doc/images/widget_calendar_demo.png +0 -0
data/doc/images/widget_cell_demo.png +0 -0
data/doc/images/widget_chart_demo.png +0 -0
data/doc/images/widget_gauge_demo.png +0 -0
data/doc/images/widget_layout_split.png +0 -0
data/doc/images/widget_line_gauge_demo.png +0 -0
data/doc/images/widget_list_demo.png +0 -0
data/doc/images/widget_list_styles.png +0 -0
data/doc/images/widget_popup_demo.png +0 -0
data/doc/images/widget_ratatui_logo_demo.png +0 -0
data/doc/images/widget_ratatui_mascot_demo.png +0 -0
data/doc/images/widget_rect.png +0 -0
data/doc/images/widget_render.png +0 -0
data/doc/images/widget_rich_text.png +0 -0
data/doc/images/widget_scroll_text.png +0 -0
data/doc/images/widget_scrollbar_demo.png +0 -0
data/doc/images/widget_sparkline_demo.png +0 -0
data/doc/images/widget_style_colors.png +0 -0
data/doc/images/widget_table_flex.png +0 -0
data/doc/images/widget_tabs_demo.png +0 -0
data/doc/index.md +1 -0
data/doc/interactive_design.md +116 -0
data/doc/quickstart.md +186 -84
data/examples/app_all_events/README.md +81 -0
data/examples/app_all_events/app.rb +93 -0
data/examples/app_all_events/model/event_color_cycle.rb +41 -0
data/examples/app_all_events/model/event_entry.rb +75 -0
data/examples/app_all_events/model/events.rb +180 -0
data/examples/app_all_events/model/highlight.rb +57 -0
data/examples/app_all_events/model/timestamp.rb +54 -0
data/examples/app_all_events/test/snapshots/after_focus_lost.txt +24 -0
data/examples/app_all_events/test/snapshots/after_focus_regained.txt +24 -0
data/examples/app_all_events/test/snapshots/after_horizontal_resize.txt +24 -0
data/examples/app_all_events/test/snapshots/after_key_a.txt +24 -0
data/examples/app_all_events/test/snapshots/after_key_ctrl_x.txt +24 -0
data/examples/app_all_events/test/snapshots/after_mouse_click.txt +24 -0
data/examples/app_all_events/test/snapshots/after_mouse_drag.txt +24 -0
data/examples/app_all_events/test/snapshots/after_multiple_events.txt +24 -0
data/examples/app_all_events/test/snapshots/after_paste.txt +24 -0
data/examples/app_all_events/test/snapshots/after_resize.txt +24 -0
data/examples/app_all_events/test/snapshots/after_right_click.txt +24 -0
data/examples/app_all_events/test/snapshots/after_vertical_resize.txt +24 -0
data/examples/app_all_events/test/snapshots/initial_state.txt +24 -0
data/examples/app_all_events/view/app_view.rb +78 -0
data/examples/app_all_events/view/controls_view.rb +50 -0
data/examples/app_all_events/view/counts_view.rb +55 -0
data/examples/app_all_events/view/live_view.rb +69 -0
data/examples/app_all_events/view/log_view.rb +60 -0
data/{lib/ratatui_ruby/output.rb → examples/app_all_events/view.rb} +1 -1
data/examples/app_all_events/view_state.rb +42 -0
data/examples/app_color_picker/README.md +94 -0
data/examples/app_color_picker/app.rb +112 -0
data/examples/app_color_picker/clipboard.rb +84 -0
data/examples/app_color_picker/color.rb +191 -0
data/examples/app_color_picker/copy_dialog.rb +170 -0
data/examples/app_color_picker/harmony.rb +56 -0
data/examples/app_color_picker/input.rb +142 -0
data/examples/app_color_picker/palette.rb +80 -0
data/examples/app_color_picker/scene.rb +201 -0
data/examples/app_login_form/app.rb +108 -0
data/examples/app_map_demo/app.rb +93 -0
data/examples/app_table_select/app.rb +201 -0
data/examples/verify_quickstart_dsl/app.rb +45 -0
data/examples/verify_quickstart_layout/app.rb +69 -0
data/examples/verify_quickstart_lifecycle/app.rb +48 -0
data/examples/verify_readme_usage/app.rb +34 -0
data/examples/widget_barchart_demo/app.rb +238 -0
data/examples/widget_block_padding/app.rb +67 -0
data/examples/widget_block_titles/app.rb +69 -0
data/examples/widget_box_demo/app.rb +250 -0
data/examples/widget_calendar_demo/app.rb +109 -0
data/examples/widget_cell_demo/app.rb +104 -0
data/examples/widget_chart_demo/app.rb +213 -0
data/examples/widget_gauge_demo/app.rb +212 -0
data/examples/widget_layout_split/app.rb +246 -0
data/examples/widget_line_gauge_demo/app.rb +217 -0
data/examples/widget_list_demo/app.rb +382 -0
data/examples/widget_list_styles/app.rb +141 -0
data/examples/widget_popup_demo/app.rb +104 -0
data/examples/widget_ratatui_logo_demo/app.rb +103 -0
data/examples/widget_ratatui_mascot_demo/app.rb +93 -0
data/examples/widget_rect/app.rb +205 -0
data/examples/widget_render/app.rb +184 -0
data/examples/widget_rich_text/app.rb +137 -0
data/examples/widget_scroll_text/app.rb +108 -0
data/examples/widget_scrollbar_demo/app.rb +153 -0
data/examples/widget_sparkline_demo/app.rb +274 -0
data/examples/widget_style_colors/app.rb +102 -0
data/examples/widget_table_flex/app.rb +95 -0
data/examples/widget_tabs_demo/app.rb +167 -0
data/ext/ratatui_ruby/Cargo.lock +889 -115
data/ext/ratatui_ruby/Cargo.toml +4 -3
data/ext/ratatui_ruby/clippy.toml +7 -0
data/ext/ratatui_ruby/extconf.rb +7 -0
data/ext/ratatui_ruby/src/events.rs +293 -219
data/ext/ratatui_ruby/src/frame.rs +115 -0
data/ext/ratatui_ruby/src/lib.rs +105 -24
data/ext/ratatui_ruby/src/rendering.rs +94 -10
data/ext/ratatui_ruby/src/style.rs +357 -93
data/ext/ratatui_ruby/src/terminal.rs +121 -31
data/ext/ratatui_ruby/src/text.rs +178 -0
data/ext/ratatui_ruby/src/widgets/barchart.rs +99 -24
data/ext/ratatui_ruby/src/widgets/block.rs +32 -3
data/ext/ratatui_ruby/src/widgets/calendar.rs +45 -44
data/ext/ratatui_ruby/src/widgets/canvas.rs +44 -9
data/ext/ratatui_ruby/src/widgets/chart.rs +79 -27
data/ext/ratatui_ruby/src/widgets/clear.rs +3 -1
data/ext/ratatui_ruby/src/widgets/gauge.rs +11 -4
data/ext/ratatui_ruby/src/widgets/layout.rs +223 -15
data/ext/ratatui_ruby/src/widgets/line_gauge.rs +92 -0
data/ext/ratatui_ruby/src/widgets/list.rs +114 -11
data/ext/ratatui_ruby/src/widgets/mod.rs +3 -0
data/ext/ratatui_ruby/src/widgets/overlay.rs +4 -2
data/ext/ratatui_ruby/src/widgets/paragraph.rs +35 -13
data/ext/ratatui_ruby/src/widgets/ratatui_logo.rs +40 -0
data/ext/ratatui_ruby/src/widgets/ratatui_mascot.rs +51 -0
data/ext/ratatui_ruby/src/widgets/scrollbar.rs +61 -7
data/ext/ratatui_ruby/src/widgets/sparkline.rs +73 -6
data/ext/ratatui_ruby/src/widgets/table.rs +177 -64
data/ext/ratatui_ruby/src/widgets/tabs.rs +105 -5
data/lib/ratatui_ruby/cell.rb +166 -0
data/lib/ratatui_ruby/event/focus_gained.rb +49 -0
data/lib/ratatui_ruby/event/focus_lost.rb +50 -0
data/lib/ratatui_ruby/event/key.rb +211 -0
data/lib/ratatui_ruby/event/mouse.rb +124 -0
data/lib/ratatui_ruby/event/none.rb +43 -0
data/lib/ratatui_ruby/event/paste.rb +71 -0
data/lib/ratatui_ruby/event/resize.rb +80 -0
data/lib/ratatui_ruby/event.rb +131 -0
data/lib/ratatui_ruby/frame.rb +87 -0
data/lib/ratatui_ruby/schema/bar_chart/bar.rb +45 -0
data/lib/ratatui_ruby/schema/bar_chart/bar_group.rb +23 -0
data/lib/ratatui_ruby/schema/bar_chart.rb +226 -17
data/lib/ratatui_ruby/schema/block.rb +178 -11
data/lib/ratatui_ruby/schema/calendar.rb +70 -14
data/lib/ratatui_ruby/schema/canvas.rb +213 -46
data/lib/ratatui_ruby/schema/center.rb +46 -8
data/lib/ratatui_ruby/schema/chart.rb +134 -32
data/lib/ratatui_ruby/schema/clear.rb +22 -53
data/lib/ratatui_ruby/schema/constraint.rb +72 -12
data/lib/ratatui_ruby/schema/cursor.rb +23 -5
data/lib/ratatui_ruby/schema/draw.rb +53 -0
data/lib/ratatui_ruby/schema/gauge.rb +56 -12
data/lib/ratatui_ruby/schema/layout.rb +91 -9
data/lib/ratatui_ruby/schema/line_gauge.rb +78 -0
data/lib/ratatui_ruby/schema/list.rb +92 -16
data/lib/ratatui_ruby/schema/overlay.rb +29 -3
data/lib/ratatui_ruby/schema/paragraph.rb +82 -25
data/lib/ratatui_ruby/schema/ratatui_logo.rb +29 -0
data/lib/ratatui_ruby/schema/ratatui_mascot.rb +34 -0
data/lib/ratatui_ruby/schema/rect.rb +59 -10
data/lib/ratatui_ruby/schema/scrollbar.rb +127 -19
data/lib/ratatui_ruby/schema/shape/label.rb +66 -0
data/lib/ratatui_ruby/schema/sparkline.rb +120 -12
data/lib/ratatui_ruby/schema/style.rb +39 -11
data/lib/ratatui_ruby/schema/table.rb +109 -18
data/lib/ratatui_ruby/schema/tabs.rb +71 -10
data/lib/ratatui_ruby/schema/text.rb +90 -0
data/lib/ratatui_ruby/session/autodoc.rb +417 -0
data/lib/ratatui_ruby/session.rb +163 -0
data/lib/ratatui_ruby/test_helper.rb +322 -13
data/lib/ratatui_ruby/version.rb +1 -1
data/lib/ratatui_ruby.rb +184 -38
data/sig/examples/app_all_events/app.rbs +11 -0
data/sig/examples/app_all_events/model/event_entry.rbs +16 -0
data/sig/examples/app_all_events/model/events.rbs +15 -0
data/sig/examples/app_all_events/model/timestamp.rbs +11 -0
data/sig/examples/app_all_events/view/app_view.rbs +8 -0
data/sig/examples/app_all_events/view/controls_view.rbs +6 -0
data/sig/examples/app_all_events/view/counts_view.rbs +6 -0
data/sig/examples/app_all_events/view/live_view.rbs +6 -0
data/sig/examples/app_all_events/view/log_view.rbs +6 -0
data/sig/examples/app_all_events/view.rbs +8 -0
data/sig/examples/app_all_events/view_state.rbs +15 -0
data/sig/examples/app_color_picker/app.rbs +12 -0
data/sig/examples/app_login_form/app.rbs +11 -0
data/sig/examples/app_map_demo/app.rbs +11 -0
data/sig/examples/app_table_select/app.rbs +11 -0
data/sig/examples/verify_quickstart_dsl/app.rbs +11 -0
data/sig/examples/verify_quickstart_lifecycle/app.rbs +11 -0
data/sig/examples/verify_readme_usage/app.rbs +11 -0
data/sig/examples/widget_block_padding/app.rbs +11 -0
data/sig/examples/widget_block_titles/app.rbs +11 -0
data/sig/examples/widget_box_demo/app.rbs +11 -0
data/sig/examples/widget_calendar_demo/app.rbs +11 -0
data/sig/examples/widget_cell_demo/app.rbs +11 -0
data/sig/examples/widget_chart_demo/app.rbs +11 -0
data/sig/examples/widget_gauge_demo/app.rbs +11 -0
data/sig/examples/widget_layout_split/app.rbs +10 -0
data/sig/examples/widget_line_gauge_demo/app.rbs +11 -0
data/sig/examples/widget_list_demo/app.rbs +12 -0
data/sig/examples/widget_list_styles/app.rbs +11 -0
data/sig/examples/widget_popup_demo/app.rbs +11 -0
data/sig/examples/widget_ratatui_logo_demo/app.rbs +11 -0
data/sig/examples/widget_ratatui_mascot_demo/app.rbs +11 -0
data/sig/examples/widget_rect/app.rbs +12 -0
data/sig/examples/widget_render/app.rbs +10 -0
data/sig/examples/widget_rich_text/app.rbs +11 -0
data/sig/examples/widget_scroll_text/app.rbs +11 -0
data/sig/examples/widget_scrollbar_demo/app.rbs +11 -0
data/sig/examples/widget_sparkline_demo/app.rbs +10 -0
data/sig/examples/widget_style_colors/app.rbs +14 -0
data/sig/examples/widget_table_flex/app.rbs +11 -0
data/sig/ratatui_ruby/event.rbs +69 -0
data/sig/ratatui_ruby/frame.rbs +9 -0
data/sig/ratatui_ruby/ratatui_ruby.rbs +5 -3
data/sig/ratatui_ruby/schema/bar_chart/bar.rbs +16 -0
data/sig/ratatui_ruby/schema/bar_chart/bar_group.rbs +13 -0
data/sig/ratatui_ruby/schema/bar_chart.rbs +20 -2
data/sig/ratatui_ruby/schema/block.rbs +5 -4
data/sig/ratatui_ruby/schema/calendar.rbs +6 -2
data/sig/ratatui_ruby/schema/canvas.rbs +52 -39
data/sig/ratatui_ruby/schema/center.rbs +3 -3
data/sig/ratatui_ruby/schema/chart.rbs +8 -5
data/sig/ratatui_ruby/schema/constraint.rbs +8 -5
data/sig/ratatui_ruby/schema/cursor.rbs +1 -1
data/sig/ratatui_ruby/schema/draw.rbs +27 -0
data/sig/ratatui_ruby/schema/gauge.rbs +4 -2
data/sig/ratatui_ruby/schema/layout.rbs +11 -1
data/sig/ratatui_ruby/schema/line_gauge.rbs +16 -0
data/sig/ratatui_ruby/schema/list.rbs +5 -1
data/sig/ratatui_ruby/schema/paragraph.rbs +4 -1
data/sig/ratatui_ruby/schema/ratatui_logo.rbs +8 -0
data/sig/ratatui_ruby/{buffer.rbs → schema/ratatui_mascot.rbs} +4 -3
data/sig/ratatui_ruby/schema/rect.rbs +2 -1
data/sig/ratatui_ruby/schema/scrollbar.rbs +18 -2
data/sig/ratatui_ruby/schema/sparkline.rbs +6 -2
data/sig/ratatui_ruby/schema/table.rbs +8 -1
data/sig/ratatui_ruby/schema/tabs.rbs +5 -1
data/sig/ratatui_ruby/schema/text.rbs +22 -0
data/sig/ratatui_ruby/session.rbs +94 -0
data/tasks/autodoc/inventory.rb +61 -0
data/tasks/autodoc/member.rb +56 -0
data/tasks/autodoc/name.rb +19 -0
data/tasks/autodoc/notice.rb +26 -0
data/tasks/autodoc/rbs.rb +38 -0
data/tasks/autodoc/rdoc.rb +45 -0
data/tasks/autodoc.rake +47 -0
data/tasks/bump/history.rb +2 -2
data/tasks/doc.rake +600 -6
data/tasks/example_viewer.html.erb +172 -0
data/tasks/lint.rake +8 -4
data/tasks/resources/build.yml.erb +13 -11
data/tasks/resources/index.html.erb +6 -0
data/tasks/sourcehut.rake +4 -4
data/tasks/terminal_preview/app_screenshot.rb +33 -0
data/tasks/terminal_preview/crash_report.rb +52 -0
data/tasks/terminal_preview/example_app.rb +25 -0
data/tasks/terminal_preview/launcher_script.rb +46 -0
data/tasks/terminal_preview/preview_collection.rb +58 -0
data/tasks/terminal_preview/preview_timing.rb +22 -0
data/tasks/terminal_preview/safety_confirmation.rb +56 -0
data/tasks/terminal_preview/saved_screenshot.rb +53 -0
data/tasks/terminal_preview/system_appearance.rb +11 -0
data/tasks/terminal_preview/terminal_window.rb +136 -0
data/tasks/terminal_preview/window_id.rb +14 -0
data/tasks/terminal_preview.rake +28 -0
data/tasks/test.rake +2 -2
data/tasks/website/index_page.rb +3 -3
data/tasks/website/version.rb +10 -10
data/tasks/website/version_menu.rb +10 -12
data/tasks/website/versioned_documentation.rb +49 -17
data/tasks/website/website.rb +6 -8
data/tasks/website.rake +4 -4
metadata +206 -54
data/LICENSES/BSD-2-Clause.txt +0 -9
data/doc/images/examples-analytics.rb.png +0 -0
data/doc/images/examples-box_demo.rb.png +0 -0
data/doc/images/examples-calendar_demo.rb.png +0 -0
data/doc/images/examples-chart_demo.rb.png +0 -0
data/doc/images/examples-custom_widget.rb.png +0 -0
data/doc/images/examples-dashboard.rb.png +0 -0
data/doc/images/examples-list_styles.rb.png +0 -0
data/doc/images/examples-login_form.rb.png +0 -0
data/doc/images/examples-map_demo.rb.png +0 -0
data/doc/images/examples-mouse_events.rb.png +0 -0
data/doc/images/examples-popup_demo.rb.gif +0 -0
data/doc/images/examples-quickstart_lifecycle.rb.png +0 -0
data/doc/images/examples-scroll_text.rb.png +0 -0
data/doc/images/examples-scrollbar_demo.rb.png +0 -0
data/doc/images/examples-stock_ticker.rb.png +0 -0
data/doc/images/examples-system_monitor.rb.png +0 -0
data/doc/images/examples-table_select.rb.png +0 -0
data/examples/analytics.rb +0 -88
data/examples/box_demo.rb +0 -71
data/examples/calendar_demo.rb +0 -55
data/examples/chart_demo.rb +0 -84
data/examples/custom_widget.rb +0 -43
data/examples/dashboard.rb +0 -72
data/examples/list_styles.rb +0 -66
data/examples/login_form.rb +0 -115
data/examples/map_demo.rb +0 -58
data/examples/mouse_events.rb +0 -95
data/examples/popup_demo.rb +0 -105
data/examples/quickstart_dsl.rb +0 -30
data/examples/quickstart_lifecycle.rb +0 -40
data/examples/readme_usage.rb +0 -21
data/examples/scroll_text.rb +0 -74
data/examples/scrollbar_demo.rb +0 -75
data/examples/stock_ticker.rb +0 -93
data/examples/system_monitor.rb +0 -94
data/examples/table_select.rb +0 -70
data/examples/test_analytics.rb +0 -65
data/examples/test_box_demo.rb +0 -38
data/examples/test_calendar_demo.rb +0 -66
data/examples/test_dashboard.rb +0 -38
data/examples/test_list_styles.rb +0 -61
data/examples/test_login_form.rb +0 -63
data/examples/test_map_demo.rb +0 -100
data/examples/test_popup_demo.rb +0 -62
data/examples/test_scroll_text.rb +0 -130
data/examples/test_stock_ticker.rb +0 -39
data/examples/test_system_monitor.rb +0 -40
data/examples/test_table_select.rb +0 -37
data/ext/ratatui_ruby/src/buffer.rs +0 -54
data/lib/ratatui_ruby/dsl.rb +0 -64

data/tasks/example_viewer.html.erb ADDED Viewed

@@ -0,0 +1,172 @@
+<%#
+SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+SPDX-License-Identifier: AGPL-3.0-or-later
+%>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title><%= page_title %> - Example Viewer</title>
+  <script>
+  var rdoc_rel_prefix = "<%= doc_root_link.sub('index.html', '') %>";
+  var index_rel_prefix = "<%= '../' * (relative_path.split('/').size - 1) %>";
+  </script>
+  <script src="<%= '../' * (relative_path.split('/').size - 1) %>js/search_navigation.js" defer></script>
+  <script src="<%= '../' * (relative_path.split('/').size - 1) %>js/search_data.js" defer></script>
+  <script src="<%= '../' * (relative_path.split('/').size - 1) %>js/search_ranker.js" defer></script>
+  <script src="<%= '../' * (relative_path.split('/').size - 1) %>js/search_controller.js" defer></script>
+  <script src="<%= '../' * (relative_path.split('/').size - 1) %>js/aliki.js" defer></script>
+  <link href="<%= doc_root_link.sub('index.html', '') %>css/rdoc.css" rel="stylesheet">
+  <link href="<%= doc_root_link.sub('index.html', '') %>custom.css" rel="stylesheet">
+</head>
+<body class="file<%= ' has-toc' unless toc_items.empty? %>">
+<%= icons_svg %>
+  <header class="top-navbar">
+    <div class="navbar-brand">
+      Example Viewer
+    </div>
+    <!-- Desktop search bar -->
+    <div class="navbar-search navbar-search-desktop" role="search">
+      <form action="#" method="get" accept-charset="utf-8">
+        <input id="search-field" role="combobox" aria-label="Search"
+               aria-autocomplete="list" aria-controls="search-results-desktop"
+               type="text" name="search" placeholder="Search (/) examples..."
+               spellcheck="false" autocomplete="off"
+               title="Type to search, Up and Down to navigate, Enter to load">
+        <ul id="search-results-desktop" aria-label="Search Results"
+            aria-busy="false" aria-expanded="false"
+            aria-atomic="false" class="initially-hidden search-results"></ul>
+      </form>
+    </div>
+    <!-- Mobile search icon button -->
+    <button id="search-toggle" class="navbar-search-mobile" aria-label="Open search" type="button">
+      <span aria-hidden="true">🔍</span>
+    </button>
+    <button id="theme-toggle" class="theme-toggle" aria-label="Switch to dark mode" type="button" onclick="cycleColorMode()">
+      <span class="theme-toggle-icon" aria-hidden="true">🌙</span>
+    </button>
+  </header>
+  <!-- Search Modal (Mobile) -->
+  <div id="search-modal" class="search-modal" hidden aria-modal="true" role="dialog" aria-label="Search">
+    <div class="search-modal-backdrop"></div>
+    <div class="search-modal-content">
+      <div class="search-modal-header">
+        <form class="search-modal-form" action="#" method="get" accept-charset="utf-8">
+          <span class="search-modal-icon" aria-hidden="true">🔍</span>
+          <input id="search-field-mobile" role="combobox" aria-label="Search"
+                 aria-autocomplete="list" aria-controls="search-results-mobile"
+                 type="text" name="search" placeholder="Search examples"
+                 spellcheck="false" autocomplete="off">
+          <button type="button" class="search-modal-close" aria-label="Close search" id="search-modal-close">
+            <span aria-hidden="true">esc</span>
+          </button>
+        </form>
+      </div>
+      <div class="search-modal-body">
+        <ul id="search-results-mobile" aria-label="Search Results"
+            aria-busy="false" aria-expanded="false"
+            aria-atomic="false" class="search-results search-modal-results initially-hidden"></ul>
+        <div class="search-modal-empty">
+          <p>No recent searches</p>
+        </div>
+      </div>
+    </div>
+  </div>
+  <nav id="navigation" role="navigation">
+    <div id="fileindex-section" class="nav-section">
+      <details class="nav-section-collapsible" open>
+        <summary class="nav-section-header">
+          <span class="nav-section-icon">
+             <svg><use href="#icon-file"></use></svg>
+          </span>
+          <span class="nav-section-title">Examples</span>
+          <span class="nav-section-chevron">
+            <svg><use href="#icon-chevron"></use></svg>
+          </span>
+        </summary>
+        <ul class="nav-list">
+          <li><a href="<%= doc_root_link %>">← Back to Docs</a></li>
+        </ul>
+      </details>
+    </div>
+    <div class="nav-section">
+      <details class="nav-section-collapsible" open>
+        <summary class="nav-section-header">
+          <span class="nav-section-icon">
+            <svg><use href="#icon-layers"></use></svg>
+          </span>
+          <span class="nav-section-title">Files</span>
+          <span class="nav-section-chevron">
+            <svg><use href="#icon-chevron"></use></svg>
+          </span>
+        </summary>
+        <ul class="link-list nav-list">
+          <%= render_tree(tree_data, relative_path, current_file_html) %>
+        </ul>
+      </details>
+    </div>
+  </nav>
+  <main role="main">
+    <div class="breadcrumb">
+      <%= breadcrumb_path %>
+    </div>
+    <%= file_header_html %>
+    <div class="content">
+      <%= file_content_html %>
+    </div>
+  </main>
+  <% unless toc_items.empty? %>
+  <aside class="table-of-contents" role="complementary" aria-label="Table of Contents">
+    <div class="toc-sticky">
+      <div class="toc-list">
+        <h3>On This Page</h3>
+        <%= render_toc(toc_items) %>
+      </div>
+    </div>
+  </aside>
+  <% end %>
+  <script>
+    const modes = ['auto', 'light', 'dark'];
+    const icons = { auto: '🌓', light: '☀️', dark: '🌙' };
+    function setColorMode(mode) {
+      if (mode === 'auto') {
+        document.documentElement.removeAttribute('data-theme');
+        const systemTheme = (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) ? 'dark' : 'light';
+        document.documentElement.setAttribute('data-theme', systemTheme);
+      } else {
+        document.documentElement.setAttribute('data-theme', mode);
+      }
+      const icon = icons[mode];
+      const toggle = document.getElementById('theme-toggle');
+      toggle.querySelector('.theme-toggle-icon').textContent = icon;
+      localStorage.setItem('rdoc-theme', mode);
+    }
+    function cycleColorMode() {
+      const current = localStorage.getItem('rdoc-theme') || 'auto';
+      const currentIndex = modes.indexOf(current);
+      const nextMode = modes[(currentIndex + 1) % modes.length];
+      setColorMode(nextMode);
+    }
+    const savedMode = localStorage.getItem('rdoc-theme') || 'auto';
+    setColorMode(savedMode);
+  </script>
+</body>
+</html>

data/tasks/lint.rake CHANGED Viewed

@@ -9,9 +9,9 @@ require "inch/rake"
 RuboCop::RakeTask.new
-RubyCritic::RakeTask.new do |task|
-  task.options = "--no-browser"
-  task.paths = FileList.new.include("exe/**/*.rb", "lib/**/*.rb", "sig/**/*.rbs")
+# Run rubycritic in a shell to prevent it from exiting the rake process
+task :rubycritic do
+  sh "bundle exec rubycritic --no-browser exe lib sig"
 end
 Inch::Rake::Suggest.new("doc:suggest", "exe/**/*.rb", "lib/**/*.rb", "sig/**/*.rbs") do |suggest|
@@ -39,7 +39,11 @@ end
 task(:reuse) { Rake::Task["reuse:lint"].invoke }
 namespace :lint do
-  task docs: %w[rubycritic rdoc:coverage reuse:lint]
+  task :safe_rdoc_coverage do
+    sh "bundle exec rake rdoc:coverage"
+  end
+  task docs: %w[autodoc rubycritic safe_rdoc_coverage reuse:lint]
   task code: %w[rubocop rubycritic cargo:fmt cargo:clippy cargo:test]
   task licenses: %w[reuse:lint]
   task all: %w[docs code licenses]

data/tasks/resources/build.yml.erb CHANGED Viewed

@@ -1,19 +1,19 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
-image: alpine/edge
+image: archlinux
 packages:
   - bash
-  - build-base
+  - base-devel
   - curl
-  - openssl-dev
-  - yaml-dev
-  - zlib-dev
-  - readline-dev
-  - gdbm-dev
-  - ncurses-dev
-  - libffi-dev
-  - clang-dev
+  - openssl
+  - libyaml
+  - zlib
+  - readline
+  - gdbm
+  - ncurses
+  - libffi
+  - clang
   - git
 artifacts:
   - ratatui_ruby/pkg/<%= gem_filename %>
@@ -24,8 +24,10 @@ tasks:
       curl https://mise.jdx.dev/install.sh | sh
       echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.buildenv
       echo 'eval "$($HOME/.local/bin/mise activate bash)"' >> ~/.buildenv
+      echo 'export LANG="en_US.UTF-8"' >> ~/.buildenv
+      echo 'export LC_ALL="en_US.UTF-8"' >> ~/.buildenv
+      echo 'export BINDGEN_EXTRA_CLANG_ARGS="-include stdbool.h"' >> ~/.buildenv
       . ~/.buildenv
-      export RUSTFLAGS="-C target-feature=-crt-static"
       export CI="true"
       cd ratatui_ruby
       sed -i 's/ruby = .*/ruby = "<%= ruby_version %>"/' mise.toml

data/tasks/resources/index.html.erb CHANGED Viewed

@@ -1,3 +1,9 @@
+<!--
+SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+SPDX-License-Identifier: AGPL-3.0-or-later
+-->
 <!DOCTYPE html>
 <html>
 <head>

data/tasks/sourcehut.rake CHANGED Viewed

@@ -9,18 +9,18 @@ task :sourcehut do
   require "yaml"
   spec = Gem::Specification.load("ratatui_ruby.gemspec")
   # Read version directly from file to ensure we get the latest version
   # even if it was just bumped in the same Rake execution
   version_content = File.read("lib/ratatui_ruby/version.rb")
   version = version_content.match(/VERSION = "(.+?)"/)[1]
   gem_filename = "#{spec.name}-#{version}.gem"
   rubies = YAML.load_file("tasks/resources/rubies.yml")
   bundler_version = File.read("Gemfile.lock").match(/BUNDLED WITH\n\s+([\d.]+)/)[1]
   template = File.read("tasks/resources/build.yml.erb")
   erb = ERB.new(template, trim_mode: "-")

data/tasks/terminal_preview/app_screenshot.rb ADDED Viewed

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+require "tmpdir"
+require_relative "launcher_script"
+require_relative "terminal_window"
+require_relative "crash_report"
+class AppScreenshot < Data.define(:app, :output_path)
+  def capture
+    print "  📸 #{app}..."
+    LauncherScript.new(app.app_path, Dir.pwd).run do |launcher|
+      TerminalWindow.new(launcher.path, launcher.pid_file).open do |window|
+        take_snapshot(window.window_id)
+        puts " done."
+        true
+      end
+    end
+  rescue => e
+    puts " FAILED"
+    puts
+    puts CrashReport.new(app, e, "Program crashed before screenshot could be taken:")
+    puts
+    false
+  end
+  private def take_snapshot(window_id)
+    system("screencapture -l #{window_id} -o -x '#{output_path}'")
+  end
+end

data/tasks/terminal_preview/crash_report.rb ADDED Viewed

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+class CrashReport < Data.define(:app, :error, :preamble)
+  def self.new(app, error, preamble = nil)
+    # Allow preamble to be optional while Data.define requires all fields
+    super(app:, error:, preamble:)
+  end
+  def to_s
+    output = error.message.strip
+    formatted_error = output.split("\n").map { |line| format_line(line) }.join("\n")
+    preamble_section = preamble ? <<~PREAMBLE.chomp : ""
+      #{box_top}
+      #{format_line(preamble)}
+      #{box_bottom}
+    PREAMBLE
+    <<~TEXT
+      #{preamble_section}
+      #{border_top(app.to_s)}
+      #{formatted_error}
+      #{box_bottom}
+    TEXT
+  end
+  private def box_top
+    "┌#{'─' * (width - 2)}┐"
+  end
+  private def box_bottom
+    "└#{'─' * (width - 2)}┘"
+  end
+  private def border_top(title)
+    left = "┌─ #{title} "
+    right = "┐"
+    dashes = "─" * (width - left.length - right.length)
+    left + dashes + right
+  end
+  private def format_line(line)
+    truncated = line[0...(width - 4)]
+    "│ #{truncated.ljust(width - 4)} │"
+  end
+  private def width
+    80
+  end
+end

data/tasks/terminal_preview/example_app.rb ADDED Viewed

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+class ExampleApp < Data.define(:directory)
+  def self.all
+    examples_dir = File.expand_path("../../examples", __dir__)
+    Dir.glob("#{examples_dir}/*/app.rb").map do |path|
+      new(File.basename(File.dirname(path)))
+    end.sort_by(&:directory)
+  end
+  def app_path
+    "examples/#{directory}/app.rb"
+  end
+  def screenshot_filename
+    "#{directory}.png"
+  end
+  def to_s
+    directory
+  end
+end

data/tasks/terminal_preview/launcher_script.rb ADDED Viewed

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+require "fileutils"
+require "tmpdir"
+class LauncherScript < Data.define(:app_path, :repo_root)
+  def initialize(app_path:, repo_root:)
+    super
+    write
+  end
+  def run
+    yield self
+  ensure
+    cleanup
+  end
+  def path
+    File.join(Dir.tmpdir, "preview_launcher.sh")
+  end
+  def pid_file
+    File.join(Dir.tmpdir, "preview_launcher.pid")
+  end
+  private def cleanup
+    FileUtils.rm_f(path)
+    FileUtils.rm_f(pid_file)
+  rescue Errno::ENOENT
+    # Already deleted
+  end
+  private def write
+    File.open(path, "w") do |f|
+      f.puts "#!/bin/zsh"
+      f.puts "cd '#{repo_root}'"
+      f.puts "clear"
+      f.puts "echo $$ > '#{pid_file}'"
+      f.puts "exec bundle exec ruby '#{app_path}'"
+    end
+    FileUtils.chmod(0o755, path)
+  end
+end

data/tasks/terminal_preview/preview_collection.rb ADDED Viewed

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+require "fileutils"
+require_relative "example_app"
+require_relative "app_screenshot"
+require_relative "crash_report"
+require_relative "preview_timing"
+require_relative "safety_confirmation"
+require_relative "saved_screenshot"
+class PreviewCollection
+  def initialize(output_dir)
+    @output_dir = output_dir
+  end
+  def generate
+    abort "Error: This task requires macOS." unless RUBY_PLATFORM.match?(/darwin/)
+    apps = ExampleApp.all
+    stale_count = count_stale_apps(apps)
+    if stale_count.zero?
+      puts "\n✨ All #{apps.count} screenshots are up to date."
+      return
+    end
+    SafetyConfirmation.new(stale_count, apps.count).request
+    puts "\nHere we go!"
+    failures = apps.count { |app| !capture_app(app) }
+    if failures.zero?
+      puts "\n✨ All captures complete. Check doc/images/."
+    else
+      abort "\n❌ #{failures} capture(s) failed."
+    end
+  end
+  private def count_stale_apps(apps)
+    apps.count { |app| SavedScreenshot.for(app, @output_dir).stale? }
+  end
+  private def capture_app(app)
+    saved = SavedScreenshot.for(app, @output_dir)
+    if saved.stale?
+      success = AppScreenshot.new(app, saved.path).capture
+      sleep PreviewTiming.between_captures
+      success
+    else
+      puts "  ⏭️  #{app} (unchanged)"
+      true
+    end
+  end
+end

data/tasks/terminal_preview/preview_timing.rb ADDED Viewed

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+class PreviewTiming
+  def self.window_startup
+    1.5
+  end
+  def self.between_captures
+    0.2
+  end
+  def self.close_delay
+    1.0
+  end
+  def self.total
+    window_startup + close_delay + between_captures
+  end
+end

data/tasks/terminal_preview/safety_confirmation.rb ADDED Viewed

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+require_relative "preview_timing"
+require_relative "system_appearance"
+class SafetyConfirmation
+  def initialize(stale_count, total_count)
+    @stale_count = stale_count
+    @total_count = total_count
+  end
+  def request
+    print_warning
+    wait_for_user
+  end
+  private def print_warning
+    unchanged_count = @total_count - @stale_count
+    puts "\n#{'=' * 60}"
+    puts "  📸  NATIVE TERMINAL CAPTURE  📸"
+    puts "=" * 60
+    puts "This task will:"
+    puts "  1. Take control of your mouse/keyboard focus"
+    puts "  2. Rapidly open and close Terminal windows"
+    puts "  3. Capture #{@stale_count} screenshots (#{unchanged_count} unchanged)"
+    puts
+    puts "Before starting, be sure Terminal.app has the following permissions"
+    puts "in System Settings.app -> Privacy & Security:"
+    puts "  - Screen & System Audio Recording"
+    puts "  - Automation -> System Events"
+    puts
+    puts "⚠️  PLEASE DO NOT TOUCH YOUR COMPUTER WHILE THIS RUNS."
+    min_time = (@stale_count * PreviewTiming.total).to_i
+    max_time = (@stale_count * (PreviewTiming.total + PreviewTiming.close_delay)).to_i
+    puts "   (Estimated time: #{min_time}-#{max_time} seconds)"
+    puts
+  end
+  private def wait_for_user
+    loop do
+      print "Continue? [Y/n]: "
+      response = $stdin.gets.strip.downcase
+      if response.empty? || response == "y"
+        return if SystemAppearance.dark?
+        puts "⚠️  Dark Mode is not enabled. Please enable it in System Settings or Control Center before proceeding."
+        puts
+      elsif response == "n"
+        abort "Cancelled."
+      end
+    end
+  end
+end

data/tasks/terminal_preview/saved_screenshot.rb ADDED Viewed

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+require "time"
+class SavedScreenshot < Data.define(:app, :path)
+  def self.for(app, output_dir)
+    new(app, File.join(output_dir, app.screenshot_filename))
+  end
+  def stale?
+    return true unless exists?
+    app_last_modified > screenshot_last_commit_time
+  end
+  private def exists?
+    File.exist?(path)
+  end
+  private def app_last_modified
+    # If the file has staged or unstaged changes, it's definitely stale
+    return Time.now.to_i if changed?
+    # Otherwise, compare against the last git commit time
+    app_last_commit_time
+  end
+  private def changed?
+    system("git diff HEAD --quiet #{app.app_path} 2>/dev/null")
+    !$?.success?
+  end
+  private def app_last_commit_time
+    output = `git log -1 --format=%cI "#{app.app_path}" 2>/dev/null`.strip
+    return 0 if output.empty?
+    Time.iso8601(output).to_i
+  rescue
+    0
+  end
+  private def screenshot_last_commit_time
+    output = `git log -1 --format=%cI "#{path}" 2>/dev/null`.strip
+    return Time.now.to_i if output.empty?
+    Time.iso8601(output).to_i
+  rescue
+    Time.now.to_i
+  end
+end

data/tasks/terminal_preview/system_appearance.rb ADDED Viewed

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+class SystemAppearance
+  def self.dark?
+    result = `osascript -e 'tell application "System Events" to tell appearance preferences to get dark mode'`.strip
+    result == "true"
+  end
+end