ratatui_ruby 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4af7cd6e9b1850a0abe3099f29c1dbf4d9e4f01cd1782196b0948c8591d9ba3
-  data.tar.gz: 7e68a66603d410baaad20d9267b3da083bff66a1a9c7d3dd9d0142a4b89fca9f
+  metadata.gz: df3052d1e97ee4b1fcb97693be22ad3f15a593f3c6fffe139e2758f2282bb44e
+  data.tar.gz: '01178a70dc0e6c35da3d6dedde2b5e83826f054cb930dce773e6323ecdf1e2fc'
 SHA512:
-  metadata.gz: b3790091fe5de4276ff383caffc753012efc7d8646eb7d2d5a2467e73518dbd8584c692ffec368a374d6cf9a11981be6af0d3d51a1421e48f4afe1e528547618
-  data.tar.gz: f63f2bbb7abf4462be09d17aabc8bdf7737853b79e4ff5d55425a2246687a23c47e5a04c19bd41405171f0e14f94749ba70e5fe07578ffcb5ffec1e248f43246
+  metadata.gz: 96b4aae8eb4c72cccef740f701556a86a59f11c43eb5a432c9715dbfe5f80c05002727a2cd567d16f84d995a3357810b2bbeb29c577b06fd505fd8361b213199
+  data.tar.gz: f833305d63b0def8e357ce8fbed452c3da62cf49afdd1d4ced9a1f1f1e181bc44fe628f8271c8be71e82440ef92a639a4cd035a010bdba3a98474fd02343ef95

data/.builds/ruby-3.2.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-1.1.0.gem
+  - ratatui_ruby/pkg/ratatui_ruby-1.2.0.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-3.3.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-1.1.0.gem
+  - ratatui_ruby/pkg/ratatui_ruby-1.2.0.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-3.4.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-1.1.0.gem
+  - ratatui_ruby/pkg/ratatui_ruby-1.2.0.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/.builds/ruby-4.0.0.yml

@@ -16,7 +16,7 @@ packages:
   - clang
   - git
 artifacts:
-  - ratatui_ruby/pkg/ratatui_ruby-1.1.0.gem
+  - ratatui_ruby/pkg/ratatui_ruby-1.2.0.gem
 sources:
   - https://git.sr.ht/~kerrick/ratatui_ruby
 tasks:

data/CHANGELOG.md

@@ -18,6 +18,18 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ### Removed
 
+## [1.2.0] - 2026-01-25
+
+### Added
+
+- **Inline Sync Mode**: `SyntheticEvents.inline_sync!` enables deterministic ordering of sync events with key events. When enabled, `inject_sync` routes through the native event queue and `poll_event` returns `Event::Sync` in sequence. Runtimes that need ordering guarantees (like Rooibos) should call this at startup.
+
+### Changed
+
+### Fixed
+
+### Removed
+
 ## [1.1.0] - 2026-01-25
 
 ### Added
@@ -45,6 +57,8 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ### Removed
 
+
+
 ## [1.0.0] - 2026-01-25
 
 ### Added
@@ -711,6 +725,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - **Testing Support**: Included `RatatuiRuby::TestHelper` and RSpec integration to make testing your TUI applications possible.
 
 [Unreleased]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/HEAD
+[1.2.0]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v1.2.0
 [1.1.0]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v1.1.0
 [1.0.0]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v1.0.0
 [0.10.3]: https://git.sr.ht/~kerrick/ratatui_ruby/refs/v0.10.3

data/ext/ratatui_ruby/Cargo.lock

@@ -1059,7 +1059,7 @@ dependencies = [
 
 [[package]]
 name = "ratatui_ruby"
-version = "1.1.0"
+version = "1.2.0"
 dependencies = [
  "bumpalo",
  "lazy_static",

data/ext/ratatui_ruby/Cargo.toml

@@ -3,7 +3,7 @@
 
 [package]
 name = "ratatui_ruby"
-version = "1.1.0"
+version = "1.2.0"
 edition = "2021"
 
 [lib]

data/ext/ratatui_ruby/src/events.rs

@@ -4,8 +4,15 @@
 use magnus::{Error, IntoValue, TryConvert, Value};
 use std::cell::RefCell;
 
+/// Wrapper enum for test events - includes crossterm events and our Sync event.
+#[derive(Debug, Clone)]
+enum TestEvent {
+    Crossterm(ratatui::crossterm::event::Event),
+    Sync,
+}
+
 thread_local! {
-    static EVENT_QUEUE: RefCell<Vec<ratatui::crossterm::event::Event>> = const { RefCell::new(Vec::new()) };
+    static EVENT_QUEUE: RefCell<Vec<TestEvent>> = const { RefCell::new(Vec::new()) };
 }
 
 use ratatui::crossterm::event::{KeyCode, KeyModifiers, MediaKeyCode, ModifierKeyCode};
@@ -107,12 +114,13 @@ pub fn all_key_codes() -> magnus::RHash {
 pub fn inject_test_event(event_type: String, data: magnus::RHash) -> Result<(), Error> {
     let ruby = magnus::Ruby::get().unwrap();
     let event = match event_type.as_str() {
-        "key" => parse_key_event(data, &ruby)?,
-        "mouse" => parse_mouse_event(data, &ruby)?,
-        "resize" => parse_resize_event(data, &ruby)?,
-        "paste" => parse_paste_event(data, &ruby)?,
-        "focus_gained" => ratatui::crossterm::event::Event::FocusGained,
-        "focus_lost" => ratatui::crossterm::event::Event::FocusLost,
+        "key" => TestEvent::Crossterm(parse_key_event(data, &ruby)?),
+        "mouse" => TestEvent::Crossterm(parse_mouse_event(data, &ruby)?),
+        "resize" => TestEvent::Crossterm(parse_resize_event(data, &ruby)?),
+        "paste" => TestEvent::Crossterm(parse_paste_event(data, &ruby)?),
+        "focus_gained" => TestEvent::Crossterm(ratatui::crossterm::event::Event::FocusGained),
+        "focus_lost" => TestEvent::Crossterm(ratatui::crossterm::event::Event::FocusLost),
+        "sync" => TestEvent::Sync,
         _ => {
             return Err(Error::new(
                 ruby.exception_arg_error(),
@@ -317,7 +325,7 @@ pub fn poll_event(ruby: &magnus::Ruby, timeout_val: Option<f64>) -> Result<Value
     });
 
     if let Some(e) = event {
-        return handle_event(e);
+        return handle_test_event(e);
     }
 
     let is_test_mode = crate::terminal::with_query(|q| q.is_test_mode()).unwrap_or(false);
@@ -334,7 +342,7 @@ pub fn poll_event(ruby: &magnus::Ruby, timeout_val: Option<f64>) -> Result<Value
         {
             let event = ratatui::crossterm::event::read()
                 .map_err(|e| Error::new(ruby.exception_runtime_error(), e.to_string()))?;
-            handle_event(event)
+            handle_crossterm_event(event)
         } else {
             Ok(ruby.qnil().into_value_with(ruby))
         }
@@ -342,11 +350,18 @@ pub fn poll_event(ruby: &magnus::Ruby, timeout_val: Option<f64>) -> Result<Value
         // Blocking: wait indefinitely for an event
         let event = ratatui::crossterm::event::read()
             .map_err(|e| Error::new(ruby.exception_runtime_error(), e.to_string()))?;
-        handle_event(event)
+        handle_crossterm_event(event)
+    }
+}
+
+fn handle_test_event(event: TestEvent) -> Result<Value, Error> {
+    match event {
+        TestEvent::Crossterm(e) => handle_crossterm_event(e),
+        TestEvent::Sync => handle_sync_event(),
     }
 }
 
-fn handle_event(event: ratatui::crossterm::event::Event) -> Result<Value, Error> {
+fn handle_crossterm_event(event: ratatui::crossterm::event::Event) -> Result<Value, Error> {
     match event {
         ratatui::crossterm::event::Event::Key(key) => handle_key_event(key),
         ratatui::crossterm::event::Event::Mouse(event) => handle_mouse_event(event),
@@ -357,6 +372,13 @@ fn handle_event(event: ratatui::crossterm::event::Event) -> Result<Value, Error>
     }
 }
 
+fn handle_sync_event() -> Result<Value, Error> {
+    let ruby = magnus::Ruby::get().unwrap();
+    let hash = ruby.hash_new();
+    hash.aset(ruby.to_symbol("type"), ruby.to_symbol("sync"))?;
+    Ok(hash.into_value_with(&ruby))
+}
+
 fn media_key_to_string(m: MediaKeyCode) -> &'static str {
     MEDIA_KEY_MAPPINGS
         .iter()

data/lib/ratatui_ruby/synthetic_events.rb

@@ -48,8 +48,28 @@ module RatatuiRuby
   module SyntheticEvents
     @queue = [] #: Array[Event]
     @mutex = Mutex.new
+    @inline_sync = false #: bool
 
     class << self
+      ##
+      # Enables inline sync mode for deterministic event ordering.
+      #
+      # Call once at startup. Cannot be disabled.
+      #
+      # When enabled, +inject_sync+ routes through the native event queue
+      # and +poll_event+ returns +Event::Sync+ like any other event.
+      # This ensures sync events are processed in sequence with key events.
+      #
+      # Runtimes that need ordering guarantees (like Rooibos) should call
+      # this before entering their event loop.
+      def inline_sync!
+        @inline_sync = true
+      end
+
+      def inline_sync? # :nodoc:
+        @inline_sync
+      end
+
       ##
       # Pushes an event to the synthetic queue.
       #

data/lib/ratatui_ruby/test_helper/event_injection.rb

@@ -89,8 +89,13 @@ module RatatuiRuby
         when RatatuiRuby::Event::FocusLost
           RatatuiRuby.inject_test_event("focus_lost", {})
         when RatatuiRuby::Event::Sync
-          # Sync events use the engine-level synthetic queue
-          RatatuiRuby::SyntheticEvents.push(event)
+          if RatatuiRuby::SyntheticEvents.inline_sync?
+            # Route through native queue for deterministic ordering with key events
+            RatatuiRuby.inject_test_event("sync", {})
+          else
+            # Default 1.0 behavior: use the engine-level synthetic queue
+            RatatuiRuby::SyntheticEvents.push(event)
+          end
         else
           raise ArgumentError, "Unknown event type: #{event.class}"
         end

data/lib/ratatui_ruby/version.rb

@@ -8,5 +8,5 @@
 module RatatuiRuby
   # The version of the ratatui_ruby gem.
   # See https://semver.org/spec/v2.0.0.html
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

data/lib/ratatui_ruby.rb

@@ -409,6 +409,8 @@ module RatatuiRuby
       Event::FocusGained.new.freeze
     when :focus_lost
       Event::FocusLost.new.freeze
+    when :sync
+      Event::Sync.new.freeze
     else
       # Return None for unknown event types
       Event::None.new.freeze

data/sig/ratatui_ruby/synthetic_events.rbs

@@ -12,7 +12,10 @@ module RatatuiRuby
   # Used primarily for testing and the andThen-like integration pattern.
   module SyntheticEvents
     @queue: Array[Event]
+    @inline_sync: bool
 
+    def self.inline_sync!: () -> void
+    def self.inline_sync?: () -> bool
     def self.push: (Event event) -> void
     def self.pop: () -> Event?
     def self.clear: () -> void

data/tasks/sourcehut.rake

@@ -68,6 +68,18 @@ namespace :sourcehut do
       abort "Fatal: Version mismatch! 'lib/ratatui_ruby/version.rb' says #{tag_name}, but the latest git tag is #{latest_tag}."
     end
 
+    # Get current stable version (if stable branch exists)
+    stable_version_str = `git show stable:lib/ratatui_ruby/version.rb 2>/dev/null`.match(/VERSION = "(.+?)"/)&.[](1)
+    if stable_version_str
+      stable_version = Gem::Version.new(stable_version_str)
+      new_version = Gem::Version.new(version)
+
+      if new_version <= stable_version
+        puts "Skipping stable update: #{version} is not newer than current stable #{stable_version_str}"
+        next
+      end
+    end
+
     puts "Updating stable branch to point to #{tag_name}..."
     # Resolve the tag to a commit hash (peel annotated tags)
     # This renders a commit SHA that can be pushed to a branch head
@@ -77,8 +89,8 @@ namespace :sourcehut do
     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"
+    # Force-push because stable is reset to each release, not fast-forwarded.
+    sh "git push --force origin #{commit_sha}:stable"
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratatui_ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Kerrick Long