chamomile-petals 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ed123f1f94a7e5e22208bc83930247e62266c2436c1def4544321eb516eb7f9
-  data.tar.gz: 3bca72d7c2b82b6b13971ae0a104c874fb65e06066252a75683c06595159d4fe
+  metadata.gz: b0e639488f319cee4214dadaf0a18d780c364f1e2dd0eb105ad8a02396c10476
+  data.tar.gz: 312869e2b9d7f6e1cbeb10a88144adbd576ff53979e4aa6c3668846614e5d9d2
 SHA512:
-  metadata.gz: bb3390f954b95b548e3fa9af78ad1db0b122cdf65a4b620523546c6761e0dff1947ae266792bdf912039576dd344a692197b9e7690ba0d2b3eeb5e67b52c423b
-  data.tar.gz: cd8d70d75e9dd197677df817751f529483edc0b4d613a65b0fe49c20c3976f276d823d780425ce8d71ad9f26f86f2979ce9e962943a42d422bd15d5b6e72f580
+  metadata.gz: 83bd46a6443068228e48ac8084480044cb6656376120f9ed096ad803887d8c50bfe103143c988bb628576a2d58d20a93aaab5f448f1f2c7a6d19b98aa020150e
+  data.tar.gz: d8f90b12a4a67f5a07e04870b83f004fff7d385de2face4bd4fb7008e0be3e906c2f9ce8fb1bedc469ea3be0003585964e39e53f912696148743b41eb4b7ff5e

data/lib/petals/cursor.rb

@@ -74,7 +74,7 @@ module Petals
       }
     end
 
-    def update(msg)
+    def handle(msg)
       return unless msg.is_a?(CursorBlinkMsg)
       return unless @mode == MODE_BLINK && @focused
       return unless msg.id == @id && msg.tag == @tag
@@ -84,6 +84,8 @@ module Petals
       blink_cmd
     end
 
+    alias update handle
+
     def view
       return @char if @mode == MODE_HIDE
       return @char if @blinked

data/lib/petals/file_picker.rb

@@ -52,7 +52,7 @@ module Petals
       read_dir_cmd(@current_directory)
     end
 
-    def update(msg)
+    def handle(msg)
       case msg
       when FilePickerReadDirMsg
         return unless msg.id == @id
@@ -61,11 +61,13 @@ module Petals
         @cursor = @cursor.clamp(0, [entries_size - 1, 0].max)
         clamp_offset
         nil
-      when Chamomile::KeyMsg
+      when Chamomile::KeyEvent
         handle_key(msg)
       end
     end
 
+    alias update handle
+
     def view
       return "  (empty)" if @entries.empty?
 
@@ -93,7 +95,7 @@ module Petals
     end
 
     def did_select_file?(msg)
-      return [false, nil] unless msg.is_a?(Chamomile::KeyMsg)
+      return [false, nil] unless msg.is_a?(Chamomile::KeyEvent)
 
       if @selected_path
         path = @selected_path
@@ -105,7 +107,7 @@ module Petals
     end
 
     def did_select_disabled_file?(msg)
-      return [false, nil] unless msg.is_a?(Chamomile::KeyMsg)
+      return [false, nil] unless msg.is_a?(Chamomile::KeyEvent)
 
       if @disabled_selected_path
         path = @disabled_selected_path

data/lib/petals/help.rb

@@ -59,10 +59,12 @@ module Petals
       end
     end
 
-    def update(_msg)
+    def handle(_msg)
       nil
     end
 
+    alias update handle
+
     private
 
     def enabled_bindings(bindings)

data/lib/petals/key_binding.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Petals
-  # Utilities for matching KeyMsg against normalized key maps.
+  # Utilities for matching KeyEvent against normalized key maps.
   module KeyBinding
     # Normalize a key map so mod arrays are sorted and frozen.
     # Call once at definition time to avoid per-keystroke allocations.
@@ -14,7 +14,7 @@ module Petals
       end.freeze
     end
 
-    # Check if a KeyMsg matches any binding for a named action.
+    # Check if a KeyEvent matches any binding for a named action.
     # Expects a normalized key map (from .normalize) for best performance.
     def self.key_matches?(msg, key_map, action)
       return false unless msg.is_a?(Chamomile::KeyMsg)

data/lib/petals/list.rb

@@ -212,9 +212,9 @@ module Petals
       @spinner_visible
     end
 
-    def update(msg)
+    def handle(msg)
       case msg
-      when Chamomile::KeyMsg
+      when Chamomile::KeyEvent
         handle_key(msg)
       when SpinnerTickMsg
         @spinner.update(msg)
@@ -230,6 +230,8 @@ module Petals
       end
     end
 
+    alias update handle
+
     def view
       sections = []
 

data/lib/petals/paginator.rb

@@ -72,9 +72,9 @@ module Petals
 
     # Elm protocol
 
-    def update(msg)
+    def handle(msg)
       case msg
-      when Chamomile::KeyMsg
+      when Chamomile::KeyEvent
         if KeyBinding.key_matches?(msg, @key_map, :prev_page)
           prev_page
         elsif KeyBinding.key_matches?(msg, @key_map, :next_page)
@@ -85,6 +85,8 @@ module Petals
       nil
     end
 
+    alias update handle
+
     def view
       case @type
       when TYPE_ARABIC

data/lib/petals/progress.rb

@@ -79,7 +79,7 @@ module Petals
       @animating
     end
 
-    def update(msg)
+    def handle(msg)
       return unless msg.is_a?(ProgressFrameMsg)
       return unless msg.id == @id && msg.tag == @tag
 
@@ -101,6 +101,8 @@ module Petals
       end
     end
 
+    alias update handle
+
     def view
       render_bar(@percent)
     end

data/lib/petals/spinner.rb

@@ -42,7 +42,7 @@ module Petals
     end
 
     # Advance frame if msg is a matching SpinnerTickMsg; return cmd or nil.
-    def update(msg)
+    def handle(msg)
       return unless msg.is_a?(SpinnerTickMsg)
       return unless msg.id == @id && msg.tag == @tag
 
@@ -51,6 +51,8 @@ module Petals
       tick_cmd
     end
 
+    alias update handle
+
     # Current frame string.
     def view
       @spinner_type.frames[@frame]

data/lib/petals/stopwatch.rb

@@ -64,7 +64,7 @@ module Petals
       @running
     end
 
-    def update(msg)
+    def handle(msg)
       return unless msg.is_a?(StopwatchTickMsg)
       return unless msg.id == @id && msg.tag == @tag
 
@@ -73,6 +73,8 @@ module Petals
       tick_cmd
     end
 
+    alias update handle
+
     def view
       total = @elapsed.ceil.to_i
       hours = total / 3600

data/lib/petals/table.rb

@@ -8,14 +8,33 @@ module Petals
     attr_accessor :columns, :key_map, :height
     attr_reader :cursor, :rows
 
-    def initialize(columns: [], rows: [], height: 10, key_map: DEFAULT_KEY_MAP)
-      @columns = columns
+    # Accepts columns as keyword arg or via block DSL.
+    #
+    #   # Keyword form (original)
+    #   Table.new(columns: [Column.new(title: "Name", width: 20)], rows: rows)
+    #
+    #   # Block DSL form (new)
+    #   Table.new(rows: rows) do |t|
+    #     t.column "Name", width: 20
+    #     t.column "Size", width: 10
+    #   end
+    #
+    #   # Hash form (new)
+    #   Table.new(columns: [{ title: "Name", width: 20 }], rows: rows)
+    def initialize(columns: [], rows: [], height: 10, key_map: DEFAULT_KEY_MAP, &block)
+      @columns = normalize_columns(columns)
       @rows = rows
       @height = height
       @key_map = key_map
       @cursor = 0
       @offset = 0
       @focused = false
+
+      if block
+        builder = ColumnBuilder.new
+        block.call(builder)
+        @columns = builder.columns unless builder.columns.empty?
+      end
     end
 
     def rows=(rows)
@@ -69,17 +88,21 @@ module Petals
       @focused
     end
 
-    def update(msg)
+    # Handle an incoming event.
+    def handle(msg)
       return unless @focused
 
       case msg
-      when Chamomile::KeyMsg
+      when Chamomile::KeyEvent
         handle_key(msg)
       end
 
       nil
     end
 
+    # Backward compat alias
+    alias update handle
+
     def view
       header = render_header
       separator = render_separator
@@ -88,8 +111,34 @@ module Petals
       [header, separator, body].compact.join("\n")
     end
 
+    # DSL builder for column definitions.
+    class ColumnBuilder
+      attr_reader :columns
+
+      def initialize
+        @columns = []
+      end
+
+      def column(title, width: 20)
+        @columns << Column.new(title: title, width: width)
+      end
+    end
+
     private
 
+    def normalize_columns(columns)
+      columns.map do |col|
+        case col
+        when Column
+          col
+        when Hash
+          Column.new(title: col[:title], width: col[:width] || 20)
+        else
+          col
+        end
+      end
+    end
+
     def row_count
       @rows.length
     end

data/lib/petals/text_area.rb

@@ -168,19 +168,21 @@ module Petals
       @last_char_offset = 0
     end
 
-    def update(msg)
+    def handle(msg)
       return unless @focused
 
       case msg
-      when Chamomile::KeyMsg
+      when Chamomile::KeyEvent
         handle_key(msg)
-      when Chamomile::PasteMsg
+      when Chamomile::PasteEvent
         handle_paste(msg)
       end
 
       nil
     end
 
+    alias update handle
+
     def view
       return "#{@prompt}#{@placeholder}" if @lines == [""] && !@placeholder.empty? && !@focused
 

data/lib/petals/text_input.rb

@@ -65,21 +65,23 @@ module Petals
       recalc_offset
     end
 
-    # Elm protocol
-
-    def update(msg)
+    # Handle an incoming event. Primary API — replaces the old `update` name.
+    def handle(msg)
       return unless @focused
 
       case msg
-      when Chamomile::KeyMsg
+      when Chamomile::KeyEvent
         handle_key(msg)
-      when Chamomile::PasteMsg
+      when Chamomile::PasteEvent
         handle_paste(msg)
       end
 
       nil
     end
 
+    # Backward compat alias
+    alias update handle
+
     def view
       return "#{@prompt}#{@placeholder}" if @value.empty? && !@placeholder.empty? && !@focused
 

data/lib/petals/timer.rb

@@ -70,7 +70,7 @@ module Petals
       @remaining <= 0
     end
 
-    def update(msg)
+    def handle(msg)
       case msg
       when TimerTickMsg
         return unless msg.id == @id && msg.tag == @tag
@@ -87,6 +87,8 @@ module Petals
       end
     end
 
+    alias update handle
+
     def view
       total = @remaining.ceil.to_i
       total = 0 if total.negative?

data/lib/petals/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Petals
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/petals/viewport.rb

@@ -18,24 +18,36 @@ module Petals
       @soft_wrap = false
     end
 
-    def set_width(new_width)
+    def width=(new_width)
       @width = new_width
       clamp_offset
       @x_offset = @x_offset.clamp(0, [max_horizontal_scroll, 0].max) unless @soft_wrap
     end
 
-    def set_height(new_height)
+    # Backward compat alias
+    alias set_width width=
+
+    def height=(new_height)
       @height = new_height
       clamp_offset
     end
 
-    def set_content(s)
-      @lines = s.split("\n", -1)
+    # Backward compat alias
+    alias set_height height=
+
+    def content=(s)
+      @lines = s.to_s.split("\n", -1)
       clamp_offset
       @x_offset = @x_offset.clamp(0, [max_horizontal_scroll, 0].max) unless @soft_wrap
       self
     end
 
+    # Backward compat — preserves the return-self convention
+    def set_content(s)
+      self.content = s
+      self
+    end
+
     def content
       @lines.join("\n")
     end
@@ -138,19 +150,21 @@ module Petals
       self
     end
 
-    # Elm protocol
-
-    def update(msg)
+    # Handle an incoming event.
+    def handle(msg)
       case msg
-      when Chamomile::KeyMsg
+      when Chamomile::KeyEvent
         handle_key(msg)
-      when Chamomile::MouseMsg
+      when Chamomile::MouseEvent
         handle_mouse(msg)
       end
 
       nil
     end
 
+    # Backward compat alias
+    alias update handle
+
     def view
       if @soft_wrap
         render_soft_wrap

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chamomile-petals
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Jack Killilea
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-03-10 00:00:00.000000000 Z
+date: 2026-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chamomile
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement