bubbles 0.0.5 → 0.1.1

data/bubbles.gemspec

@@ -1,28 +1,36 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'bubbles/version'
+# frozen_string_literal: true
+
+require_relative "lib/bubbles/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = "bubbles"
-  spec.version       = Bubbles::VERSION
-  spec.authors       = ["Tomas Valent"]
-  spec.licenses      = ['MIT']
-  spec.email         = ["equivalent@eq8.eu"]
+  spec.name = "bubbles"
+  spec.version = Bubbles::VERSION
+  spec.authors = ["Marco Roth"]
+  spec.email = ["marco.roth@intergga.ch"]
+
+  spec.summary = "TUI components for Bubble Tea."
+  spec.description = "Ruby port of Charm's Bubbles. Common UI components for building terminal applications with Bubble Tea."
+  spec.homepage = "https://github.com/marcoroth/bubbles-ruby"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/marcoroth/bubbles-ruby"
+  spec.metadata["changelog_uri"] = "https://github.com/marcoroth/bubbles-ruby/releases"
+  spec.metadata["rubygems_mfa_required"] = "true"
 
-  spec.summary       = %q{Lightweight daemon file uploader to cloud}
-  spec.description   = %q{Daemonized file uploader that watch a folder and uploads any files files to AWS S3. Designed for Raspberry pi zero}
-  spec.homepage      = "https://github.com/equivalent/bubbles"
+  spec.files = Dir[
+    "bubbles.gemspec",
+    "LICENSE.txt",
+    "README.md",
+    "{lib,sig}/**/*"
+  ]
 
-  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features)/})
-  end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "aws-sdk", "~> 2"
-  spec.add_development_dependency "bundler", "~> 1.14"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_dependency "bubbletea"
+  spec.add_dependency "harmonica"
+  spec.add_dependency "lipgloss"
 end

data/lib/bubbles/ansi.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Bubbles
+  module ANSI
+    PATTERN = /\e\[[0-9;]*[A-Za-z]/ #: Regexp
+
+    # Extracts a visible character range from a string while preserving ANSI escape codes.
+    # ANSI codes before the start position are carried forward and applied to the result.
+    # A reset sequence is appended if the result contains any ANSI codes.
+    #
+    # @rbs string String -- the input string potentially containing ANSI codes
+    # @rbs start_column Integer -- the starting visible character position (0-indexed)
+    # @rbs end_column Integer -- the ending visible character position (exclusive)
+    # @rbs return String -- the extracted substring with ANSI codes preserved
+    #
+    def self.cut_string(string, start_column, end_column)
+      result = +""
+      active_codes = +""
+      visible_position = 0
+      scanner_position = 0
+
+      while scanner_position < string.length
+        if string[scanner_position..] =~ /\A(#{PATTERN})/
+          ansi_sequence = ::Regexp.last_match(1)
+          next unless ansi_sequence
+
+          if visible_position < start_column
+            if ansi_sequence == "\e[0m" # rubocop:disable Metrics/BlockNesting
+              active_codes = +""
+            else
+              active_codes << ansi_sequence
+            end
+          elsif visible_position < end_column
+            result << ansi_sequence
+          end
+
+          scanner_position += ansi_sequence.length
+        else
+          char = string[scanner_position]
+          next unless char
+
+          if visible_position >= start_column && visible_position < end_column
+            result << active_codes unless active_codes.empty?
+            active_codes = +""
+            result << char
+          end
+
+          visible_position += 1
+          scanner_position += 1
+        end
+      end
+
+      stripped = strip(result)
+      return "" if stripped.empty?
+
+      result << "\e[0m" unless result == stripped
+
+      result
+    end
+
+    # Removes all ANSI escape codes from a string.
+    #
+    # @rbs string String -- the input string
+    # @rbs return String -- the string with all ANSI codes removed
+    #
+    def self.strip(string)
+      string.gsub(PATTERN, "")
+    end
+  end
+end

data/lib/bubbles/cryptic_spinner.rb

@@ -0,0 +1,274 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+require "lipgloss"
+
+module Bubbles
+  # CrypticSpinner is an animated activity indicator that displays cycling
+  # random characters with gradient colors. Inspired by the Charm CLI crush
+  # animation.
+  #
+  # Example:
+  #   spinner = Bubbles::CrypticSpinner.new(
+  #     size: 15,
+  #     rows: 1,
+  #     label: "Loading",
+  #     color_a: "#ff0000",
+  #     color_b: "#0000ff",
+  #     cycle_colors: true
+  #   )
+  #
+  # Multi-row example (matrix style):
+  #   spinner = Bubbles::CrypticSpinner.new(
+  #     size: 30,
+  #     rows: 5,
+  #     cycle_colors: true
+  #   )
+  #
+  #   # In your model's init:
+  #   def init
+  #     [self, @spinner.tick]
+  #   end
+  #
+  #   # In your model's update:
+  #   def update(message)
+  #     case message
+  #     when Bubbles::CrypticSpinner::TickMessage
+  #       @spinner, command = @spinner.update(message)
+  #       [self, command]
+  #     end
+  #   end
+  #
+  #   # In your model's view:
+  #   def view
+  #     @spinner.view
+  #   end
+  #
+  class CrypticSpinner
+    AVAILABLE_CHARS = "0123456789abcdefABCDEF~!@#$%^&*()+=_".chars.freeze #: Array[String]
+    INITIAL_CHAR = "." #: String
+    ELLIPSIS_FRAMES = [".", "..", "...", ""].freeze #: Array[String]
+
+    FPS = 20 #: Integer
+    FRAME_DURATION = 1.0 / FPS #: Float
+    MAX_BIRTH_OFFSET = 1.0 #: Float
+    ELLIPSIS_ANIM_SPEED = 8 #: Integer
+
+    DEFAULT_SIZE = 10 #: Integer
+    DEFAULT_ROWS = 1 #: Integer
+    DEFAULT_COLOR_A = "#6B50FF" #: String
+    DEFAULT_COLOR_B = "#FF60FF" #: String
+    DEFAULT_LABEL_COLOR = "#DFDBDD" #: String
+
+    class TickMessage < Bubbletea::Message
+      attr_reader :id #: Integer
+      attr_reader :tag #: Integer
+
+      #: (id: Integer, tag: Integer) -> void
+      def initialize(id:, tag:)
+        super()
+        @id = id
+        @tag = tag
+      end
+    end
+
+    # @rbs self.@next_id: Integer
+    # @rbs self.@id_mutex: Mutex
+    @next_id = 0
+    @id_mutex = Mutex.new
+
+    class << self
+      #: () -> Integer
+      def next_id
+        @id_mutex.synchronize do
+          @next_id += 1
+        end
+      end
+    end
+
+    attr_reader :id #: Integer
+    attr_reader :size #: Integer
+    attr_reader :rows #: Integer
+    attr_accessor :label
+    attr_reader :label_color #: String
+    attr_reader :color_a #: String
+    attr_reader :color_b #: String
+    attr_reader :cycle_colors #: bool
+
+    #: (
+    #:   ?size: Integer,
+    #:   ?rows: Integer,
+    #:   ?label: String,
+    #:   ?label_color: String,
+    #:   ?color_a: String,
+    #:   ?color_b: String,
+    #:   ?cycle_colors: bool
+    #: ) -> void
+    def initialize(
+      size: DEFAULT_SIZE,
+      rows: DEFAULT_ROWS,
+      label: "",
+      label_color: DEFAULT_LABEL_COLOR,
+      color_a: DEFAULT_COLOR_A,
+      color_b: DEFAULT_COLOR_B,
+      cycle_colors: false
+    )
+      @id = self.class.next_id
+      @tag = 0
+      @size = size
+      @rows = rows
+      @label = label
+      @label_color = label_color
+      @color_a = color_a
+      @color_b = color_b
+      @cycle_colors = cycle_colors
+
+      @step = 0
+      @ellipsis_step = 0
+      @start_time = Time.now
+      @initialized = false
+
+      @birth_offsets = Array.new(@rows) do |row|
+        Array.new(@size) { (rand * MAX_BIRTH_OFFSET) + (row * 0.1) }
+      end
+
+      @gradient = generate_gradient
+
+      prerender_frames
+    end
+
+    #: () -> [CrypticSpinner, Bubbletea::Command]
+    def init
+      [self, tick]
+    end
+
+    #: (Bubbletea::Message) -> [CrypticSpinner, Bubbletea::Command?]
+    def update(message)
+      case message
+      when TickMessage
+        return [self, nil] if message.id.positive? && message.id != @id
+        return [self, nil] if message.tag.positive? && message.tag != @tag
+
+        @step = (@step + 1) % @cycling_frames.length
+        @tag += 1
+
+        if @initialized && !@label.empty?
+          @ellipsis_step = (@ellipsis_step + 1) % (ELLIPSIS_ANIM_SPEED * ELLIPSIS_FRAMES.length)
+        elsif !@initialized && (Time.now - @start_time) >= MAX_BIRTH_OFFSET
+          @initialized = true
+        end
+
+        [self, tick]
+      else
+        [self, nil]
+      end
+    end
+
+    #: () -> String
+    def view
+      elapsed = Time.now - @start_time
+      lines = [] #: Array[String]
+
+      @rows.times do |row|
+        line = String.new
+
+        @size.times do |i|
+          line << if !@initialized && elapsed < @birth_offsets[row][i]
+                    @initial_frames[@step][row][i]
+                  else
+                    @cycling_frames[@step][row][i]
+                  end
+        end
+
+        if row == @rows - 1 && !@label.empty?
+          line << " "
+          line << render_label
+
+          if @initialized
+            ellipsis_index = @ellipsis_step / ELLIPSIS_ANIM_SPEED
+            line << render_ellipsis(ELLIPSIS_FRAMES[ellipsis_index])
+          end
+        end
+
+        lines << line
+      end
+
+      lines.join("\n")
+    end
+
+    #: () -> Bubbletea::Command
+    def tick
+      current_id = @id
+      current_tag = @tag
+
+      Bubbletea.tick(FRAME_DURATION) { TickMessage.new(id: current_id, tag: current_tag) }
+    end
+
+    #: () -> Integer
+    def width
+      w = @size
+
+      w += 1 + @label.length + (ELLIPSIS_FRAMES.max_by(&:length) || "").length unless @label.empty?
+
+      w
+    end
+
+    #: () -> Integer
+    def height
+      @rows
+    end
+
+    #: (String) -> void
+
+    private
+
+    #: () -> Array[String]
+    def generate_gradient
+      num_colors = @cycle_colors ? @size * 3 : @size
+
+      Lipgloss::ColorBlend.blends(@color_a, @color_b, num_colors, mode: :hcl)
+    end
+
+    #: () -> void
+    def prerender_frames
+      num_frames = @cycle_colors ? @size * 2 : 10
+
+      @initial_frames = Array.new(num_frames) do |frame_index|
+        Array.new(@rows) do |row|
+          offset = @cycle_colors ? frame_index + row : row
+
+          Array.new(@size) do |char_index|
+            color_index = (char_index + offset) % @gradient.length
+            style = Lipgloss::Style.new.foreground(@gradient[color_index])
+            style.render(INITIAL_CHAR)
+          end
+        end
+      end
+
+      @cycling_frames = Array.new(num_frames) do |frame_index|
+        Array.new(@rows) do |row|
+          offset = @cycle_colors ? frame_index + row : row
+
+          Array.new(@size) do |char_index|
+            color_index = (char_index + offset) % @gradient.length
+            char = AVAILABLE_CHARS.sample
+            style = Lipgloss::Style.new.foreground(@gradient[color_index])
+            style.render(char)
+          end
+        end
+      end
+    end
+
+    #: () -> String
+    def render_label
+      style = Lipgloss::Style.new.foreground(@label_color)
+      style.render(@label)
+    end
+
+    #: (String) -> String
+    def render_ellipsis(ellipsis)
+      style = Lipgloss::Style.new.foreground(@label_color)
+      style.render(ellipsis)
+    end
+  end
+end

data/lib/bubbles/cursor.rb

@@ -0,0 +1,169 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Bubbles
+  # Cursor provides cursor functionality for text input components.
+  #
+  # Example:
+  #   cursor = Bubbles::Cursor.new
+  #   cursor.char = "a"
+  #   cursor.focus
+  #
+  #   # In update:
+  #   cursor, command = cursor.update(message)
+  #
+  #   # In view:
+  #   cursor.view
+  #
+  class Cursor
+    MODE_BLINK = :blink #: Symbol
+    MODE_STATIC = :static #: Symbol
+    MODE_HIDE = :hide #: Symbol
+
+    DEFAULT_BLINK_SPEED = 0.53 #: Float
+
+    class InitialBlinkMessage < Bubbletea::Message
+    end
+
+    class BlinkMessage < Bubbletea::Message
+      attr_reader :id #: Integer
+      attr_reader :tag #: Integer
+
+      #: (id: Integer, tag: Integer) -> void
+      def initialize(id:, tag:)
+        super()
+
+        @id = id
+        @tag = tag
+      end
+    end
+
+    class BlinkCanceledMessage < Bubbletea::Message
+    end
+
+    # rubocop:disable Style/ClassVars
+    @@last_id = 0 #: Integer
+    @@id_mutex = Mutex.new #: Mutex
+
+    #: () -> Integer
+    def self.next_id
+      @@id_mutex.synchronize do
+        @@last_id += 1
+      end
+    end
+    # rubocop:enable Style/ClassVars
+
+    attr_reader :id #: Integer
+    attr_reader :mode #: Symbol
+    attr_accessor :char #: String
+
+    attr_accessor :blink_speed #: Float
+    attr_accessor :style #: Lipgloss::Style?
+    attr_accessor :text_style #: Lipgloss::Style?
+
+    #: () -> void
+    def initialize
+      @id = self.class.next_id
+      @blink_speed = DEFAULT_BLINK_SPEED
+      @style = nil
+      @text_style = nil
+      @char = ""
+      @focus = false
+      @blink = true
+      @blink_tag = 0
+      @mode = MODE_BLINK
+    end
+
+    #: () -> bool
+    def blink?
+      @blink
+    end
+
+    #: () -> bool
+    def focused?
+      @focus
+    end
+
+    #: (Bubbletea::Message) -> [Cursor, Bubbletea::Command?]
+    def update(message)
+      case message
+      when InitialBlinkMessage
+        return [self, nil] if @mode != MODE_BLINK || !@focus
+
+        [self, blink_command]
+      when BlinkMessage
+        return [self, nil] if @mode != MODE_BLINK || !@focus
+        return [self, nil] if message.id != @id || message.tag != @blink_tag
+
+        @blink = !@blink
+
+        [self, blink_command]
+      when BlinkCanceledMessage
+        [self, nil]
+      else # rubocop:disable Lint/DuplicateBranch
+        [self, nil]
+      end
+    end
+
+    #: (Symbol) -> Bubbletea::Command?
+    def set_mode(mode) # rubocop:disable Naming/AccessorMethodName
+      return nil unless [MODE_BLINK, MODE_STATIC, MODE_HIDE].include?(mode)
+
+      @mode = mode
+      @blink = @mode == MODE_HIDE || !@focus
+
+      mode == MODE_BLINK ? self.class.blink : nil
+    end
+
+    #: () -> Bubbletea::Command?
+    def focus
+      @focus = true
+      @blink = @mode == MODE_HIDE
+
+      return unless @mode == MODE_BLINK && @focus
+
+      blink_command
+    end
+
+    #: () -> void
+    def blur
+      @focus = false
+      @blink = true
+    end
+
+    #: () -> String
+    def view
+      if @blink
+        if (text_style = @text_style)
+          text_style.render(@char)
+        else
+          @char
+        end
+      elsif (style = @style)
+        style.reverse(true).render(@char)
+      else
+        "\e[7m#{@char}\e[0m"
+      end
+    end
+
+    #: () -> Bubbletea::SendMessage
+    def self.blink
+      Bubbletea.send_message(InitialBlinkMessage.new)
+    end
+
+    private
+
+    #: () -> Bubbletea::Command?
+    def blink_command
+      return nil unless @mode == MODE_BLINK
+
+      @blink_tag += 1
+      current_id = @id
+      current_tag = @blink_tag
+
+      Bubbletea.tick(@blink_speed) do
+        BlinkMessage.new(id: current_id, tag: current_tag)
+      end
+    end
+  end
+end