ratatui_ruby 0.6.0 → 0.7.1

data/sig/ratatui_ruby/tui/widget_factories.rbs

@@ -0,0 +1,39 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  class TUI
+    module WidgetFactories
+      def block: (**top) -> Widgets::Block
+      def paragraph: (**top) -> Widgets::Paragraph
+      def list: (**top) -> Widgets::List
+      def list_item: (**top) -> Widgets::ListItem
+      def table: (**top) -> Widgets::Table
+      def row: (**top) -> Widgets::Row
+      def table_row: (**top) -> Widgets::Row
+      def table_cell: (**top) -> Widgets::Cell
+      def tabs: (**top) -> Widgets::Tabs
+      def gauge: (**top) -> Widgets::Gauge
+      def line_gauge: (**top) -> Widgets::LineGauge
+      def sparkline: (**top) -> Widgets::Sparkline
+      def bar_chart: (**top) -> Widgets::BarChart
+      def bar: (**top) -> Widgets::BarChart::Bar
+      def bar_group: (**top) -> Widgets::BarChart::BarGroup
+      def bar_chart_bar: (**top) -> Widgets::BarChart::Bar
+      def bar_chart_bar_group: (**top) -> Widgets::BarChart::BarGroup
+      def chart: (**top) -> Widgets::Chart
+      def dataset: (**top) -> Widgets::Dataset
+      def axis: (**top) -> Widgets::Axis
+      def scrollbar: (**top) -> Widgets::Scrollbar
+      def calendar: (**top) -> Widgets::Calendar
+      def canvas: (**top) -> Widgets::Canvas
+      def clear: (**top) -> Widgets::Clear
+      def cursor: (**top) -> Widgets::Cursor
+      def overlay: (**top) -> Widgets::Overlay
+      def center: (**top) -> Widgets::Center
+      def ratatui_logo: (**top) -> Widgets::RatatuiLogo
+      def ratatui_mascot: (**top) -> Widgets::RatatuiMascot
+      def shape_label: (**top) -> Widgets::Shape::Label
+    end
+  end
+end

data/sig/ratatui_ruby/tui.rbs

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+module RatatuiRuby
+  # Terminal User Interface facade providing a concise DSL for building TUI applications.
+  #
+  # Combines all factory mixins to provide convenient access to widgets, layouts,
+  # styles, and terminal operations without verbose class name qualification.
+  class TUI
+    include Core
+    include LayoutFactories
+    include StyleFactories
+    include WidgetFactories
+    include TextFactories
+    include StateFactories
+    include CanvasFactories
+    include BufferFactories
+  end
+end

data/tasks/autodoc.rake

@@ -3,45 +3,11 @@
 # SPDX-FileCopyrightText: 2025 Kerrick Long <me@kerricklong.com>
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-require_relative "autodoc/inventory"
-require_relative "autodoc/notice"
-require_relative "autodoc/rbs"
-require_relative "autodoc/rdoc"
 require_relative "autodoc/examples"
 
 namespace :autodoc do
   desc "Update all automatically generated documentation"
-  task all: [:rbs, :rdoc, :examples]
-
-  desc "Update all automatically generated RBS signatures"
-  task rbs: ["rbs:session"]
-
-  desc "Update all automatically generated RDoc files"
-  task rdoc: ["rdoc:session"]
-
-  namespace :rbs do
-    desc "Generate RBS for RatatuiRuby::Session"
-    task :session do
-      require_relative "../lib/ratatui_ruby"
-
-      Autodoc::Rbs.new(
-        path: File.expand_path("../sig/ratatui_ruby/session.rbs", __dir__),
-        notice: Autodoc::Notice.new("autodoc:rbs:session")
-      ).write(Autodoc::Inventory.new)
-    end
-  end
-
-  namespace :rdoc do
-    desc "Generate RDoc autodoc for RatatuiRuby::Session"
-    task :session do
-      require_relative "../lib/ratatui_ruby"
-
-      Autodoc::Rdoc.new(
-        path: File.expand_path("../lib/ratatui_ruby/session/autodoc.rb", __dir__),
-        notice: Autodoc::Notice.new("autodoc:rdoc:session")
-      ).write(Autodoc::Inventory.new)
-    end
-  end
+  task all: [:examples]
 
   desc "Sync code snippets in example READMEs with source files"
   task :examples do

data/tasks/bump/changelog.rb

@@ -34,4 +34,12 @@ class Changelog
     File.write(@path, "#{header}#{UnreleasedSection.fresh}\n\n#{history}\n#{links}")
     nil
   end
+
+  def commit_message(version)
+    content = File.read(@path)
+    unreleased = UnreleasedSection.parse(content)
+    return nil unless unreleased
+
+    "chore: release v#{version}\n\n#{unreleased.commit_body}"
+  end
 end

data/tasks/bump/ruby_gem.rb

@@ -17,19 +17,31 @@ class RubyGem
 
   def bump(segment)
     target = version.next(segment)
+    commit_message = @changelog.commit_message(target)
 
     puts "Bumping #{segment}: #{version} -> #{target}"
     @changelog.release(target)
     @manifests.each { |manifest| manifest.write(target) }
     @lockfile.refresh
+
+    puts_commit_message(commit_message)
   end
 
   def set(version_string)
     target = SemVer.parse(version_string)
+    commit_message = @changelog.commit_message(target)
 
     puts "Setting version: #{version} -> #{target}"
     @changelog.release(target)
     @manifests.each { |manifest| manifest.write(target) }
     @lockfile.refresh
+
+    puts_commit_message(commit_message)
+  end
+
+  private def puts_commit_message(message)
+    puts "=" * 80
+    puts message
+    puts "=" * 80
   end
 end

data/tasks/bump/unreleased_section.rb

@@ -4,6 +4,7 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 require "date"
+require "rdoc"
 
 # UnreleasedSection manages the [Unreleased] section of the changelog.
 class UnreleasedSection
@@ -35,4 +36,19 @@ class UnreleasedSection
   def to_s
     @content
   end
+
+  def commit_body
+    formatter = Class.new { include RDoc::Text }.new
+    @content
+      .sub(/^## \[Unreleased\].*$/, "")
+      .gsub(/^### (Added|Changed|Fixed|Removed)\n*$/, "")
+      .gsub(/^- \*\*([^*]+)\*\*:/, '\1:')
+      .gsub(/`([^`]+)`/, '\1')
+      .strip
+      .lines
+      .map { |line| line.gsub(/^- /, "").strip }
+      .reject(&:empty?)
+      .map { |line| formatter.wrap(line, 72) }
+      .join("\n\n")
+  end
 end

data/tasks/sourcehut.rake

@@ -65,7 +65,10 @@ namespace :sourcehut do
     # This renders a commit SHA that can be pushed to a branch head
     commit_sha = `git rev-parse #{tag_name}^{}`.strip
 
-    # Push the commit to stable branch
+    # Update local stable branch to match
+    sh "git branch -f stable #{commit_sha}"
+
+    # Push the commit to remote stable branch
     # This creates 'stable' if it doesn't exist, or fast-forwards it.
     sh "git push origin #{commit_sha}:stable"
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratatui_ruby
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Kerrick Long
@@ -107,24 +107,23 @@ files:
 - Rakefile
 - doc/application_architecture.md
 - doc/application_testing.md
+- doc/async.md
+- doc/contributors/architectural_overhaul/chat_conversations.md
+- doc/contributors/architectural_overhaul/implementation_plan.md
+- doc/contributors/architectural_overhaul/task.md
 - doc/contributors/design.md
 - doc/contributors/design/ruby_frontend.md
 - doc/contributors/design/rust_backend.md
 - doc/contributors/developing_examples.md
 - doc/contributors/documentation_style.md
-- doc/contributors/dwim_dx.md
-- doc/contributors/examples_audit.md
-- doc/contributors/examples_audit/p1_high.md
-- doc/contributors/examples_audit/p2_moderate.md
 - doc/contributors/index.md
+- doc/contributors/v1.0.0_blockers.md
 - doc/custom.css
+- doc/debugging.md
 - doc/event_handling.md
 - doc/images/app_all_events.png
-- doc/images/app_analytics.png
 - doc/images/app_color_picker.png
-- doc/images/app_custom_widget.png
 - doc/images/app_login_form.png
-- doc/images/app_mouse_events.png
 - doc/images/app_stateful_interaction.png
 - doc/images/verify_quickstart_dsl.png
 - doc/images/verify_quickstart_layout.png
@@ -155,13 +154,14 @@ files:
 - doc/images/widget_sparkline_demo.png
 - doc/images/widget_style_colors.png
 - doc/images/widget_table_demo.png
-- doc/images/widget_table_flex.png
 - doc/images/widget_tabs_demo.png
 - doc/images/widget_text_width.png
 - doc/index.md
 - doc/interactive_design.md
 - doc/quickstart.md
 - doc/terminal_limitations.md
+- doc/v0.7.0_migration.md
+- doc/why.md
 - examples/app_all_events/README.md
 - examples/app_all_events/app.rb
 - examples/app_all_events/model/app_model.rb
@@ -226,6 +226,7 @@ files:
 - examples/widget_list_demo/app.rb
 - examples/widget_map_demo/README.md
 - examples/widget_map_demo/app.rb
+- examples/widget_overlay_demo/README.md
 - examples/widget_overlay_demo/app.rb
 - examples/widget_popup_demo/README.md
 - examples/widget_popup_demo/app.rb
@@ -293,6 +294,8 @@ files:
 - ext/ratatui_ruby/src/widgets/table_state.rs
 - ext/ratatui_ruby/src/widgets/tabs.rs
 - lib/ratatui_ruby.rb
+- lib/ratatui_ruby/buffer.rb
+- lib/ratatui_ruby/buffer/cell.rb
 - lib/ratatui_ruby/cell.rb
 - lib/ratatui_ruby/event.rb
 - lib/ratatui_ruby/event/focus_gained.rb
@@ -308,6 +311,10 @@ files:
 - lib/ratatui_ruby/event/paste.rb
 - lib/ratatui_ruby/event/resize.rb
 - lib/ratatui_ruby/frame.rb
+- lib/ratatui_ruby/layout.rb
+- lib/ratatui_ruby/layout/constraint.rb
+- lib/ratatui_ruby/layout/layout.rb
+- lib/ratatui_ruby/layout/rect.rb
 - lib/ratatui_ruby/list_state.rb
 - lib/ratatui_ruby/schema/bar_chart.rb
 - lib/ratatui_ruby/schema/bar_chart/bar.rb
@@ -331,6 +338,7 @@ files:
 - lib/ratatui_ruby/schema/ratatui_logo.rb
 - lib/ratatui_ruby/schema/ratatui_mascot.rb
 - lib/ratatui_ruby/schema/rect.rb
+- lib/ratatui_ruby/schema/row.rb
 - lib/ratatui_ruby/schema/scrollbar.rb
 - lib/ratatui_ruby/schema/shape/label.rb
 - lib/ratatui_ruby/schema/sparkline.rb
@@ -339,8 +347,8 @@ files:
 - lib/ratatui_ruby/schema/tabs.rb
 - lib/ratatui_ruby/schema/text.rb
 - lib/ratatui_ruby/scrollbar_state.rb
-- lib/ratatui_ruby/session.rb
-- lib/ratatui_ruby/session/autodoc.rb
+- lib/ratatui_ruby/style.rb
+- lib/ratatui_ruby/style/style.rb
 - lib/ratatui_ruby/table_state.rb
 - lib/ratatui_ruby/test_helper.rb
 - lib/ratatui_ruby/test_helper/event_injection.rb
@@ -348,7 +356,42 @@ files:
 - lib/ratatui_ruby/test_helper/style_assertions.rb
 - lib/ratatui_ruby/test_helper/terminal.rb
 - lib/ratatui_ruby/test_helper/test_doubles.rb
+- lib/ratatui_ruby/tui.rb
+- lib/ratatui_ruby/tui/buffer_factories.rb
+- lib/ratatui_ruby/tui/canvas_factories.rb
+- lib/ratatui_ruby/tui/core.rb
+- lib/ratatui_ruby/tui/layout_factories.rb
+- lib/ratatui_ruby/tui/state_factories.rb
+- lib/ratatui_ruby/tui/style_factories.rb
+- lib/ratatui_ruby/tui/text_factories.rb
+- lib/ratatui_ruby/tui/widget_factories.rb
 - lib/ratatui_ruby/version.rb
+- lib/ratatui_ruby/widgets.rb
+- lib/ratatui_ruby/widgets/bar_chart.rb
+- lib/ratatui_ruby/widgets/bar_chart/bar.rb
+- lib/ratatui_ruby/widgets/bar_chart/bar_group.rb
+- lib/ratatui_ruby/widgets/block.rb
+- lib/ratatui_ruby/widgets/calendar.rb
+- lib/ratatui_ruby/widgets/canvas.rb
+- lib/ratatui_ruby/widgets/cell.rb
+- lib/ratatui_ruby/widgets/center.rb
+- lib/ratatui_ruby/widgets/chart.rb
+- lib/ratatui_ruby/widgets/clear.rb
+- lib/ratatui_ruby/widgets/cursor.rb
+- lib/ratatui_ruby/widgets/gauge.rb
+- lib/ratatui_ruby/widgets/line_gauge.rb
+- lib/ratatui_ruby/widgets/list.rb
+- lib/ratatui_ruby/widgets/list_item.rb
+- lib/ratatui_ruby/widgets/overlay.rb
+- lib/ratatui_ruby/widgets/paragraph.rb
+- lib/ratatui_ruby/widgets/ratatui_logo.rb
+- lib/ratatui_ruby/widgets/ratatui_mascot.rb
+- lib/ratatui_ruby/widgets/row.rb
+- lib/ratatui_ruby/widgets/scrollbar.rb
+- lib/ratatui_ruby/widgets/shape/label.rb
+- lib/ratatui_ruby/widgets/sparkline.rb
+- lib/ratatui_ruby/widgets/table.rb
+- lib/ratatui_ruby/widgets/tabs.rb
 - mise.toml
 - sig/examples/app_all_events/app.rbs
 - sig/examples/app_all_events/model/event_entry.rbs
@@ -414,6 +457,7 @@ files:
 - sig/ratatui_ruby/schema/ratatui_logo.rbs
 - sig/ratatui_ruby/schema/ratatui_mascot.rbs
 - sig/ratatui_ruby/schema/rect.rbs
+- sig/ratatui_ruby/schema/row.rbs
 - sig/ratatui_ruby/schema/scrollbar.rbs
 - sig/ratatui_ruby/schema/sparkline.rbs
 - sig/ratatui_ruby/schema/style.rbs
@@ -429,15 +473,20 @@ files:
 - sig/ratatui_ruby/test_helper/style_assertions.rbs
 - sig/ratatui_ruby/test_helper/terminal.rbs
 - sig/ratatui_ruby/test_helper/test_doubles.rbs
+- sig/ratatui_ruby/tui.rbs
+- sig/ratatui_ruby/tui/buffer_factories.rbs
+- sig/ratatui_ruby/tui/canvas_factories.rbs
+- sig/ratatui_ruby/tui/core.rbs
+- sig/ratatui_ruby/tui/layout_factories.rbs
+- sig/ratatui_ruby/tui/state_factories.rbs
+- sig/ratatui_ruby/tui/style_factories.rbs
+- sig/ratatui_ruby/tui/text_factories.rbs
+- sig/ratatui_ruby/tui/widget_factories.rbs
 - sig/ratatui_ruby/version.rbs
 - tasks/autodoc.rake
 - tasks/autodoc/examples.rb
-- tasks/autodoc/inventory.rb
 - tasks/autodoc/member.rb
 - tasks/autodoc/name.rb
-- tasks/autodoc/notice.rb
-- tasks/autodoc/rbs.rb
-- tasks/autodoc/rdoc.rb
 - tasks/bump.rake
 - tasks/bump/cargo_lockfile.rb
 - tasks/bump/changelog.rb