ratatat 1.0.0

data/lib/ratatat/widgets/tree.rb

@@ -0,0 +1,172 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Ratatat
+  # A node in a tree structure
+  class TreeNode
+    extend T::Sig
+
+    sig { returns(String) }
+    attr_reader :label
+
+    sig { returns(T::Array[TreeNode]) }
+    attr_reader :children
+
+    sig { returns(T.untyped) }
+    attr_reader :data
+
+    sig { returns(T::Boolean) }
+    attr_accessor :expanded
+
+    sig { params(label: String, children: T::Array[TreeNode], data: T.untyped).void }
+    def initialize(label, children = [], data: nil)
+      @label = label
+      @children = children
+      @data = data
+      @expanded = T.let(false, T::Boolean)
+    end
+
+    sig { returns(T::Boolean) }
+    def expandable?
+      !@children.empty?
+    end
+  end
+
+  # Tree view widget with expandable nodes
+  class Tree < Widget
+    extend T::Sig
+
+    CAN_FOCUS = true
+
+    # Emitted when a node is selected (Space pressed)
+    class NodeSelected < Message
+      extend T::Sig
+
+      sig { returns(TreeNode) }
+      attr_reader :node
+
+      sig { params(sender: Widget, node: TreeNode).void }
+      def initialize(sender:, node:)
+        super(sender: sender)
+        @node = node
+      end
+    end
+
+    sig { returns(T::Array[TreeNode]) }
+    attr_reader :roots
+
+    reactive :cursor, default: 0, repaint: true
+
+    sig { params(roots: T::Array[TreeNode], id: T.nilable(String), classes: T::Array[String]).void }
+    def initialize(roots: [], id: nil, classes: [])
+      super(id: id, classes: classes)
+      @roots = roots
+      @cursor = 0
+    end
+
+    sig { params(message: Key).void }
+    def on_key(message)
+      case message.key
+      when "down", "j"
+        move_cursor(1)
+        message.stop
+      when "up", "k"
+        move_cursor(-1)
+        message.stop
+      when "enter"
+        toggle_current
+        message.stop
+      when "right", "l"
+        expand_current
+        message.stop
+      when "left", "h"
+        collapse_current
+        message.stop
+      when " "
+        select_current
+        message.stop
+      end
+    end
+
+    sig { params(buffer: Buffer, x: Integer, y: Integer, width: Integer, height: Integer).void }
+    def render(buffer, x:, y:, width:, height:)
+      visible = visible_nodes
+      visible.each_with_index do |(node, depth), i|
+        break if i >= height
+
+        prefix = @cursor == i ? "> " : "  "
+        indent = "  " * depth
+        icon = if node.expandable?
+                 node.expanded ? "v " : "> "
+               else
+                 "  "
+               end
+        text = "#{prefix}#{indent}#{icon}#{node.label}"
+        buffer.put_string(x, y + i, text[0, width])
+      end
+    end
+
+    private
+
+    sig { returns(T::Array[[TreeNode, Integer]]) }
+    def visible_nodes
+      result = T.let([], T::Array[[TreeNode, Integer]])
+      collect_visible(@roots, 0, result)
+      result
+    end
+
+    sig { params(nodes: T::Array[TreeNode], depth: Integer, result: T::Array[[TreeNode, Integer]]).void }
+    def collect_visible(nodes, depth, result)
+      nodes.each do |node|
+        result << [node, depth]
+        collect_visible(node.children, depth + 1, result) if node.expanded
+      end
+    end
+
+    sig { params(delta: Integer).void }
+    def move_cursor(delta)
+      max = visible_nodes.length - 1
+      @cursor = (@cursor + delta).clamp(0, [max, 0].max)
+    end
+
+    sig { returns(T.nilable(TreeNode)) }
+    def current_node
+      visible_nodes[@cursor]&.first
+    end
+
+    sig { void }
+    def toggle_current
+      node = current_node
+      return unless node&.expandable?
+
+      node.expanded = !node.expanded
+      refresh
+    end
+
+    sig { void }
+    def expand_current
+      node = current_node
+      return unless node&.expandable?
+
+      node.expanded = true
+      refresh
+    end
+
+    sig { void }
+    def collapse_current
+      node = current_node
+      return unless node&.expandable?
+
+      node.expanded = false
+      refresh
+    end
+
+    sig { void }
+    def select_current
+      node = current_node
+      return unless node
+
+      parent&.dispatch(NodeSelected.new(sender: self, node: node))
+    end
+  end
+end

data/lib/ratatat/widgets/vertical.rb

@@ -0,0 +1,52 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Ratatat
+  # Vertical flexbox-like layout widget
+  class Vertical < Widget
+    extend T::Sig
+
+    sig { returns(Integer) }
+    attr_reader :gap
+
+    sig { returns(T.nilable(T::Array[Float])) }
+    attr_reader :ratios
+
+    sig { params(gap: Integer, ratios: T.nilable(T::Array[Float]), id: T.nilable(String), classes: T::Array[String]).void }
+    def initialize(gap: 0, ratios: nil, id: nil, classes: [])
+      super(id: id, classes: classes)
+      @gap = gap
+      @ratios = ratios
+    end
+
+    sig { params(buffer: Buffer, x: Integer, y: Integer, width: Integer, height: Integer).void }
+    def render(buffer, x:, y:, width:, height:)
+      return if children.empty?
+
+      total_gap = @gap * (children.length - 1)
+      available_height = height - total_gap
+
+      heights = calculate_heights(available_height)
+      current_y = y
+
+      children.each_with_index do |child, i|
+        child_height = heights[i] || 0
+        child.render(buffer, x: x, y: current_y, width: width, height: child_height) if child.respond_to?(:render)
+        current_y += child_height + @gap
+      end
+    end
+
+    private
+
+    sig { params(available_height: Integer).returns(T::Array[Integer]) }
+    def calculate_heights(available_height)
+      if @ratios && @ratios.length == children.length
+        @ratios.map { |r| (available_height * r).to_i }
+      else
+        # Equal distribution
+        child_height = available_height / children.length
+        Array.new(children.length, child_height)
+      end
+    end
+  end
+end

data/lib/ratatat.rb

@@ -0,0 +1,51 @@
+require_relative "ratatat/version"
+
+# Core rendering engine (order matters for dependencies)
+require_relative "ratatat/color"
+require_relative "ratatat/cell"
+require_relative "ratatat/buffer"
+require_relative "ratatat/ansi_backend"
+require_relative "ratatat/terminal"
+require_relative "ratatat/input"
+
+# Drivers
+require_relative "ratatat/driver"
+
+# Message system
+require_relative "ratatat/message"
+require_relative "ratatat/binding"
+require_relative "ratatat/reactive"
+require_relative "ratatat/styles"
+require_relative "ratatat/css_parser"
+require_relative "ratatat/dom_query"
+require_relative "ratatat/widget"
+
+# Application framework
+require_relative "ratatat/app"
+
+# Widgets
+require_relative "ratatat/widgets/static"
+require_relative "ratatat/widgets/button"
+require_relative "ratatat/widgets/text_input"
+require_relative "ratatat/widgets/container"
+require_relative "ratatat/widgets/checkbox"
+require_relative "ratatat/widgets/select"
+require_relative "ratatat/widgets/data_table"
+require_relative "ratatat/widgets/tree"
+require_relative "ratatat/widgets/progress_bar"
+require_relative "ratatat/widgets/modal"
+require_relative "ratatat/widgets/text_area"
+require_relative "ratatat/widgets/radio_set"
+require_relative "ratatat/widgets/sparkline"
+require_relative "ratatat/widgets/log"
+require_relative "ratatat/widgets/grid"
+require_relative "ratatat/widgets/scrollable_container"
+require_relative "ratatat/widgets/tabbed_content"
+require_relative "ratatat/widgets/toast"
+require_relative "ratatat/widgets/tooltip"
+require_relative "ratatat/widgets/spinner"
+require_relative "ratatat/widgets/horizontal"
+require_relative "ratatat/widgets/vertical"
+
+module Ratatat
+end

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification
+name: ratatat
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Vicente Reig Rincon de Arellano
+bindir: bin
+cert_chain: []
+date: 2025-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sorbet-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: sorbet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: tapioca
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+description: Build terminal user interfaces with a reactive, component-based architecture.
+  Features reactive properties, CSS-like styling, message-driven communication, and
+  a rich widget library.
+email:
+- hey@vicente.services
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- examples/log_tailer.rb
+- lib/ratatat.rb
+- lib/ratatat/ansi_backend.rb
+- lib/ratatat/app.rb
+- lib/ratatat/binding.rb
+- lib/ratatat/buffer.rb
+- lib/ratatat/cell.rb
+- lib/ratatat/color.rb
+- lib/ratatat/css_parser.rb
+- lib/ratatat/dom_query.rb
+- lib/ratatat/driver.rb
+- lib/ratatat/input.rb
+- lib/ratatat/message.rb
+- lib/ratatat/reactive.rb
+- lib/ratatat/styles.rb
+- lib/ratatat/terminal.rb
+- lib/ratatat/version.rb
+- lib/ratatat/widget.rb
+- lib/ratatat/widgets/button.rb
+- lib/ratatat/widgets/checkbox.rb
+- lib/ratatat/widgets/container.rb
+- lib/ratatat/widgets/data_table.rb
+- lib/ratatat/widgets/grid.rb
+- lib/ratatat/widgets/horizontal.rb
+- lib/ratatat/widgets/log.rb
+- lib/ratatat/widgets/modal.rb
+- lib/ratatat/widgets/progress_bar.rb
+- lib/ratatat/widgets/radio_set.rb
+- lib/ratatat/widgets/scrollable_container.rb
+- lib/ratatat/widgets/select.rb
+- lib/ratatat/widgets/sparkline.rb
+- lib/ratatat/widgets/spinner.rb
+- lib/ratatat/widgets/static.rb
+- lib/ratatat/widgets/tabbed_content.rb
+- lib/ratatat/widgets/text_area.rb
+- lib/ratatat/widgets/text_input.rb
+- lib/ratatat/widgets/toast.rb
+- lib/ratatat/widgets/tooltip.rb
+- lib/ratatat/widgets/tree.rb
+- lib/ratatat/widgets/vertical.rb
+homepage: https://github.com/vicentereig/ratatat
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/vicentereig/ratatat
+  source_code_uri: https://github.com/vicentereig/ratatat
+  documentation_uri: https://github.com/vicentereig/ratatat#readme
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.5
+specification_version: 4
+summary: A pure Ruby TUI framework inspired by Textual
+test_files: []