mittens_ui 0.0.15 → 0.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65ad0d43134bc7e47bcb8d797b70f275a6330426ba073f2f0861fa56a1f8f551
-  data.tar.gz: c613e0ddc59df4efdc64a0ee5b4af846c2549e30c562352c52864bfcdc62abe2
+  metadata.gz: ce8a7d0aa1723a2134b6364e0e6fda2c2b9cd4e91b4e05c4f4ca6e948428c643
+  data.tar.gz: 34d9f15cb0cae6dedbc33bd62a8e2a137c06323d196fb607295ddd47b66196a2
 SHA512:
-  metadata.gz: 98a84d6b246ec8112a724d9c7cb1ec6b3f147e369aafa8cb8290cdc40b1359ce9bd656f6f8e83555ce5acb99387983eb7a4b6af8beb27388b7b4834c35a29d18
-  data.tar.gz: ebda9e48f8553c48b9548d73a7778d0211a07d605e0758f107bdcca33e1877dadd07ff5132db3ca646e0070916675cb4685b150205e7cdce01305ec3a5feeb28
+  metadata.gz: 3528b40c3376faf23d93874d84247cfa6bcfa4b59f932a3e6000090619aa26c7dba5a2ff617f8530ca1cb62096f97ac533a4235da5ba91479e2dc9fa2601bb9d
+  data.tar.gz: b1c75473975e722ca380dda49dba9566128bc8becae1e6937a7e02a543361b367f5eb57a7b9c6837e980c95e7fa837583ce85a20c55c076ff4c3b664789ab932

data/Gemfile

@@ -1,6 +1,6 @@
 source "https://rubygems.org"
 
-ruby "4.0.0"
+ruby "4.0.3"
 
 # Specify your gem's dependencies in mittens_ui.gemspec
 gemspec

data/examples/hn.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+require '../lib/mittens_ui'
+
+class HackerNewsClient
+  BASE_URL = 'https://hacker-news.firebaseio.com/v0'
+
+  def self.get_json(path)
+    uri = URI("#{BASE_URL}/#{path}")
+    res = Net::HTTP.get_response(uri)
+    JSON.parse(res.body)
+  end
+
+  def self.top_story_ids
+    get_json('topstories.json')
+  end
+
+  def self.get_item(id)
+    get_json("item/#{id}.json")
+  end
+
+  def self.top_stories(limit = 20)
+    top_story_ids.first(limit).map do |id|
+      get_item(id)
+    end
+  end
+
+  def self.map_stories_to_rows(stories_data)
+    stories_data.map do |story|
+      url = story['url'] || "https://news.ycombinator.com/item?id=#{story['id']}"
+
+      [
+        story['title'] || 'N/A',
+        story['by'] || 'N/A',
+        story['score'] || 0,
+        url
+      ]
+    end
+  end
+end
+
+MittensUi::Application.Window(
+  name: 'hn_viewer',
+  title: 'HN - Top Hacker News Stories',
+  width: 900,
+  height: 600
+) do
+
+  stories = HackerNewsClient.top_stories(100)
+  rows = HackerNewsClient.map_stories_to_rows(stories)
+
+  top_stories_table = MittensUi::TableView.new(
+    %w[Title Author Score URL].freeze,
+    rows,
+    { page_threshold: 20, page_size: 10 }.freeze
+  )
+
+  top_stories_table.row_double_clicked do |row|
+    link = MittensUi::WebLink.new('', row[3])
+    link.open_url
+    link.remove
+  end
+
+  MittensUi::Button.new(title: 'Refresh Stories').click do |btn|
+    btn.loading do
+      stories = HackerNewsClient.top_stories(5)
+      top_stories_table.update_data(HackerNewsClient.map_stories_to_rows(stories))
+    end
+  end
+end

data/examples/keyboard_shortcut_demo.rb

@@ -0,0 +1,71 @@
+require '../lib/mittens_ui'
+
+app_options = {
+  name: 'shortcut_demo',
+  title: 'Keyboard Shortcut Demo',
+  height: 400,
+  width: 500,
+  can_resize: false,
+  theme: :light
+}.freeze
+
+MittensUi::Application.Window(app_options) do
+
+  press_counter = 0
+  status = MittensUi::Label.new('Press a shortcut key...', expand: true, margin: 12)
+
+  MittensUi::Separator.new(:horizontal, top: 8, bottom: 8)
+
+  d_btn = MittensUi::Button.new(title: 'Focus me → ctrl+d (instant)')
+  d_btn.keyboard_shortcut("ctrl", "d") do
+    press_counter += 1
+    status.text = "ctrl+d fired! x#{press_counter.to_s}"
+  end
+
+  MittensUi::Separator.new(:horizontal, top: 8, bottom: 8)
+
+
+  s_btn = MittensUi::Button.new(title: 'Focus me → ctrl+s (2s delay)')
+  s_btn.keyboard_shortcut("ctrl", "s", timer: 2) do
+    press_counter += 1
+    status.text = "ctrl+s fired after 2s! x#{press_counter}"
+  end
+
+  MittensUi::Separator.new(:horizontal, top: 8, bottom: 8)
+
+  tb = MittensUi::Textbox.new(multiline: false, width: :full, placeholder: "write text, press alt+r to clear it!")
+  tb.keyboard_shortcut("alt", "r") do
+    tb.text = ""
+    press_counter += 1
+    status.text = "alt+r fired — text field cleared! x#{press_counter}"
+  end
+
+  # can register multiple keyboard_shortcuts for the same Widget.
+  tb.keyboard_shortcut("alt", "u") do
+    tb.text = tb.text.upcase
+    press_counter += 1
+    status.text = "alt+u fired - text uppercased!  x#{press_counter}"
+  end
+
+  tb.keyboard_shortcut("alt", "d") do
+    tb.text = tb.text.downcase
+    press_counter += 1
+    status.text = "alt+d fired - text downcased!  x#{press_counter}"
+  end
+
+  MittensUi::Separator.new(:horizontal, top: 8, bottom: 8)
+
+  all = []
+  inspection_button = MittensUi::Button.new(title: 'Inspect Shortcuts')
+
+  inspection_button.click do
+    all = [d_btn.shortcuts, s_btn.shortcuts, tb.shortcuts].flatten
+    status.text = "Registered: #{all.join(', ')}"
+  end
+
+  inspection_button.keyboard_shortcut("ctrl", "s") do
+    status.text = "Registered: #{ all.map{ |cmd| cmd.upcase }.join(', ') }"
+  end
+
+  MittensUi::Separator.new(:horizontal, top: 8, bottom: 8)
+end

data/examples/mig.rb

@@ -109,4 +109,17 @@ MittensUi::Application.Window(app_options) do
   MittensUi::Separator.new(:horizontal, top: 10, bottom: 100)
   MittensUi::RadioButton.new({ options: %w[Red Green Blue], layout: :horizontal, bottom: 50 })
 
+  MittensUi::Separator.new(:horizontal, top: 10, bottom: 10)
+
+  status = MittensUi::Label.new('Press a shortcut key...', expand: true, margin: 12)
+
+  MittensUi::Separator.new(:horizontal, top: 8, bottom: 8)
+
+  # Ctrl+D fires instantly on the button
+  d_btn = MittensUi::Button.new(title: 'Focus me → Ctrl+D (instant)')
+  d_btn.keyboard_shortcut("ctrl", "d") do
+    status.text = "Ctrl+D fired!"
+  end
+
+
 end

data/lib/mittens_ui/button.rb

@@ -38,8 +38,8 @@ module MittensUi
     # @option options [Symbol] :width (:full) column width in the layout grid
     # @option options [Boolean] :defer_render (false) skip auto-rendering into layout
     def initialize(options = {})
-      button_title = options[:title] || 'Button'
-      icon_type    = options[:icon]  || nil
+      button_title = options.fetch(:title, 'Button')
+      icon_type    = options.fetch(:icon, nil)
 
       @loading  = false
       @button   = Gtk::Button.new
@@ -53,7 +53,9 @@ module MittensUi
 
       @label = Gtk::Label.new(button_title)
       @box.append(@label)
+      @box.set_halign(:center)
       @box.append(@spinner)
+
       @button.set_child(@box)
       @spinner.hide
 

data/lib/mittens_ui/checkbox.rb

@@ -24,7 +24,7 @@ module MittensUi
     # @option options [Symbol] :width (:full) column width in the layout grid
     # @option options [Boolean] :defer_render (false) skip auto-rendering into layout
     def initialize(options = {})
-      label    = options[:label] || 'Checkbox'
+      label    = options.fetch(:label, 'Checkbox')
       @value   = nil
       @checkbox = Gtk::CheckButton.new
       @checkbox.set_label(label.to_s)

data/lib/mittens_ui/colorpicker.rb

@@ -38,9 +38,9 @@ module MittensUi
     # @yield [picker] called only if the user selected a color
     # @yieldparam picker [MittensUi::ColorPicker] the picker with color data
     def initialize(options = {}, &block)
-      @title    = options[:title]   || 'Pick a Color'
-      @default  = options[:default] || nil
-      @alpha    = options[:alpha]   || false
+      @title    = options.fetch(:title, 'Pick a Color')
+      @default  = options.fetch(:default, nil)
+      @alpha    = options.fetch(:alpha, false)
       @selected = false
       @color    = nil
 

data/lib/mittens_ui/core.rb

@@ -49,11 +49,13 @@ module MittensUi
     # @option options [Integer] :bottom bottom margin in pixels
     # @option options [Integer] :right right margin in pixels
     def initialize(widget, options = {})
-      @core_widget  = widget
+      @core_widget  = widget # This represents the GTK widget.
+      @core_widget.focusable = true
       @width        = options[:width]        || :full
       @defer_render = options[:defer_render] || false
       set_margin_from_opts_for(@core_widget, options)
       render unless @defer_render
+      enable_hover_focus
     end
 
     # Shows the widget if it is hidden.
@@ -108,7 +110,7 @@ module MittensUi
     # Adds the widget to the application layout grid.
     # Called automatically during initialization unless +:defer_render+ is true.
     # Can be overridden in subclasses that require special placement
-    # (e.g. {HeaderBar}, {Notify}).
+    # ({HeaderBar}, {Notify}).
     #
     # @return [void]
     def render
@@ -119,5 +121,111 @@ module MittensUi
         MittensUi::Application.layout.add(@core_widget, width: @width)
       end
     end
+
+
+    # Registers a simple keyboard shortcut on +@core_wiget+ using a modifier + key combination.
+    #
+    # Attaches a +Gtk::EventControllerKey+ to the widget that listens for the given
+    # key combination. The widget must have focus for the shortcut to fire. If a
+    # +timer+ is provided, the block is executed after the specified delay via
+    # +GLib::Timeout+.
+    #
+    # @param modifier [String] The modifier key. Accepts "ctrl", "shift", "alt", or "super".
+    # @param key [String] The key name as a GTK key string ("d", "s", "Return", "Escape").
+    # @param timer [Integer] Seconds to wait before invoking the block. Defaults to 0 (immediate).
+    # @param block [Proc] The block to execute when the shortcut is triggered.
+    #
+    # @example Instant shortcut
+    #   btn.keyboard_shortcut("ctrl", "d") { puts "Ctrl+D fired" }
+    #
+    # @example Delayed shortcut
+    #   btn.keyboard_shortcut("ctrl", "s", timer: 2) { puts "fired after 2s" }
+    #
+    # @return [void]
+    def keyboard_shortcut(modifier, key, timer: 0, &block)
+      @shortcut_controllers ||= []
+
+      controller = Gtk::EventControllerKey.new
+
+      controller.signal_connect("key-pressed") do |_ctrl, keyval, _keycode, state|
+        mod_match = case modifier.to_s.downcase
+                    when "ctrl"  then (state & Gdk::ModifierType::CONTROL_MASK).nonzero?
+                    when "shift" then (state & Gdk::ModifierType::SHIFT_MASK).nonzero?
+                    when "alt"   then (state & Gdk::ModifierType::ALT_MASK).nonzero?
+                    when "super" then (state & Gdk::ModifierType::SUPER_MASK).nonzero?
+                    else false
+                    end
+
+        key_match = (keyval == Gdk::Keyval.from_name(key))
+
+        if mod_match && key_match
+          if timer > 0
+            GLib::Timeout.add(timer * 1000) do
+              block.call
+              GLib::Source::REMOVE
+            end
+          else
+            block.call
+          end
+          true  # consume the event
+        else
+          false
+        end
+      end
+
+      @shortcut_controllers << { modifier: modifier, key: key, controller: controller }
+      @core_widget.add_controller(controller)
+    end
+
+    # Removes a previously registered keyboard shortcut from +@core_widget+.
+    #
+    # Finds the shortcut matching the given +modifier+ and +key+ combination,
+    # detaches its +Gtk::EventControllerKey+ from the underlying GTK widget.
+    #
+    # If no matching shortcut is found, this is a no-op.
+    #
+    # @param modifier [String] The modifier key used when registering the shortcut ("ctrl").
+    # @param key [String] The key name used when registering the shortcut ("d").
+    #
+    # @example
+    #   btn.remove_shortcut("ctrl", "d")
+    #
+    # @return [void]
+    def remove_keyboard_shortcut(modifier, key)
+      @shortcut_controllers&.reject! do |entry|
+        if entry[:modifier] == modifier && entry[:key] == key
+          @gtk_widget.remove_controller(entry[:controller])
+          true
+        end
+      end
+    end
+
+    # Returns a list of all keyboard shortcuts registered on +@core_wiget+.
+    #
+    # Each shortcut is represented as a human-readable string in the format
+    # "modifier+key" ("ctrl+d", "alt+r").
+    #
+    # @example
+    #   btn.shortcuts # => ["ctrl+d", "ctrl+s"]
+    #
+    # @return [Array<String>] Registered shortcuts, or an empty array if none.
+    def shortcuts
+      @shortcut_controllers&.map { |e| "#{e[:modifier]}+#{e[:key]}" } || []
+    end
+
+    private
+
+    # Grants focus to the +@core_wiget+ when the mouse pointer enters it.
+    #
+    # Attaches a +Gtk::EventControllerMotion+ and sets +focusable+ to +true+,
+    # which is required for +grab_focus+ to work with GTK4 wigets.
+    #
+    # @return [void]
+    def enable_hover_focus
+      @core_widget.focusable = true
+      motion = Gtk::EventControllerMotion.new
+      motion.signal_connect("enter") { @core_widget.grab_focus }
+      @core_widget.add_controller(motion)
+    end
   end
 end

data/lib/mittens_ui/header_bar.rb

@@ -25,8 +25,8 @@ module MittensUi
     #   Accepted values are +:left+ and +:right+
     # @option options [Boolean] :defer_render (false) skip auto-rendering into layout
     def initialize(widgets, options = {})
-      title    = options[:title]    || ''
-      position = options[:position] || :left
+      title    = options.fetch(:title, '')
+      position = options.fetch(:position, :left)
 
       @header = Gtk::HeaderBar.new
 
@@ -36,9 +36,8 @@ module MittensUi
       title_label = Gtk::Label.new(title)
       @header.title_widget = title_label
 
-
       box = Gtk::Box.new(:horizontal, 0)
-      box.add_css_class("linked")
+      box.add_css_class('linked')
 
       widgets.each do |w|
         w.remove

data/lib/mittens_ui/knob.rb

@@ -210,7 +210,7 @@ module MittensUi
 
       # value text
       cr.set_source_rgb(0.9, 0.9, 0.9)
-      cr.set_font_size(9)
+      cr.set_font_size(10.4)
       text = value.to_s
       extents = cr.text_extents(text)
       cr.move_to(cx - extents.width / 2, cy + extents.height / 2)

data/lib/mittens_ui/label.rb

@@ -32,5 +32,15 @@ module MittensUi
       gtk_label = Gtk::Label.new(text)
       super(gtk_label, options)
     end
+
+    # @return [String] returns the current label text.
+    def text
+      @core_widget.label
+    end
+
+    # @param value [String] A String value that the label gets set to
+    def text=(value)
+      @core_widget.set_label(value.to_s)
+    end
   end
 end

data/lib/mittens_ui/table_view.rb

@@ -23,7 +23,7 @@ module MittensUi
   #   table.add(['Jane', 'jane@example.com'])
   #
   # @example Pagination (automatic)
-  #   # Pagination UI appears automatically when data > 500 rows
+  #   # Pagination UI appears automatically when data > 500 rows, unless you change it by using options hash.
   #
   class TableView < Core
     attr_reader :data, :headers, :selected_row_idx
@@ -41,6 +41,9 @@ module MittensUi
       @sort_directions = {}
       @current_page = 0
 
+      @page_threshold = options.fetch(:page_threshold, PAGE_THRESHOLD)
+      @page_size = options.fetch(:page_size, PAGE_SIZE)
+
       # ---------------------------
       # GTK Structure
       # ---------------------------
@@ -149,23 +152,23 @@ module MittensUi
     # ---------------------------
 
     def paginated_data
-      return @data if @data.size <= PAGE_THRESHOLD
+      return @data if @data.size <= @page_threshold
 
-      start = @current_page * PAGE_SIZE
-      @data.slice(start, PAGE_SIZE) || []
+      start = @current_page * @page_size
+      @data.slice(start, @page_size) || []
     end
 
     def next_page
-      return if @data.size <= PAGE_THRESHOLD
+      return if @data.size <= @page_threshold
 
-      max_page = (@data.size / PAGE_SIZE.to_f).ceil - 1
+      max_page = (@data.size / @page_size.to_f).ceil - 1
       @current_page = [@current_page + 1, max_page].min
       render_rows
       update_pagination_ui
     end
 
     def prev_page
-      return if @data.size <= PAGE_THRESHOLD
+      return if @data.size <= @page_threshold
 
       @current_page = [@current_page - 1, 0].max
       render_rows
@@ -173,18 +176,18 @@ module MittensUi
     end
 
     def adjust_page_after_insert
-      return if @data.size <= PAGE_THRESHOLD
+      return if @data.size <= @page_threshold
 
-      @current_page = (@data.size / PAGE_SIZE.to_f).floor
+      @current_page = (@data.size / @page_size.to_f).floor
     end
 
     def update_pagination_ui
-      if @data.size <= PAGE_THRESHOLD
+      if @data.size <= @page_threshold
         @pagination_box.hide
         return
       end
 
-      total_pages = (@data.size / PAGE_SIZE.to_f).ceil
+      total_pages = (@data.size / @page_size.to_f).ceil
       @page_label.set_label("#{@current_page + 1} / #{total_pages}")
 
       @prev_btn.set_sensitive(@current_page > 0)
@@ -338,7 +341,22 @@ module MittensUi
       arrow = dir == :asc ? ' ▲' : ' ▼'
       @header_labels[col_idx].set_label(@headers[col_idx] + arrow)
 
-      @data.sort_by! { |row| row[col_idx].to_s }
+      @data.sort_by! do |row|
+        val = row[col_idx]
+
+        case val
+        when Integer
+          val
+        when Float
+          val
+        when String
+          # try numeric string first
+          Integer(val) rescue Float(val) rescue val.downcase
+        else
+          val.to_s
+        end
+      end
+
       @data.reverse! if dir == :desc
 
       render_rows

data/lib/mittens_ui/textbox.rb

@@ -69,6 +69,15 @@ module MittensUi
       end
     end
 
+    # @param value [String] A String value that the label gets set to
+    def text=(value)
+      if @multiline
+        @text_buffer.text = value.to_s
+      else
+        @textbox.text = value.to_s
+      end
+    end
+
     # Clears all text from the widget.
     # Works in both single-line and multiline mode.
     #

data/lib/mittens_ui/version.rb

@@ -1,3 +1,3 @@
 module MittensUi
-  VERSION = "0.0.15"
+  VERSION = "0.0.16"
 end

data/lib/mittens_ui/web_link.rb

@@ -43,5 +43,13 @@ module MittensUi
       @web_link = Gtk::LinkButton.new(@url, @name)
       super(@web_link, options)
     end
+
+    # Opens the set @url link in a web browser.
+    #
+    # @return [void]
+    def open_url
+      launcher = Gtk::UriLauncher.new(@url)
+      launcher.launch
+    end
   end
 end

data/mittens_ui.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |spec|
   #spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
 
   spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/tuttza/mittens_ui"
+  spec.metadata["source_code_uri"] = "https://codeberg.org/tuttza/mittens_ui"
   #spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
 
   # Specify which files should be added to the gem when it is released.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mittens_ui
 version: !ruby/object:Gem::Version
-  version: 0.0.15
+  version: 0.0.16
 platform: ruby
 authors:
 - Zach Tuttle
@@ -112,6 +112,8 @@ files:
 - examples/assets/gnome_logo.png
 - examples/assets/mittens_ui_preview.gif
 - examples/contacts.rb
+- examples/hn.rb
+- examples/keyboard_shortcut_demo.rb
 - examples/mig.rb
 - lib/mittens_ui.rb
 - lib/mittens_ui/alert.rb
@@ -150,7 +152,7 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/tuttza/mittens_ui
-  source_code_uri: https://github.com/tuttza/mittens_ui
+  source_code_uri: https://codeberg.org/tuttza/mittens_ui
 rdoc_options: []
 require_paths:
 - lib
@@ -165,7 +167,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: A tiny GUI toolkit written on top of GTK
 test_files: []