bubbles 0.0.5 → 0.1.0

data/sig/bubbles/file_picker.rbs

@@ -0,0 +1,138 @@
+# Generated from lib/bubbles/file_picker.rb with RBS::Inline
+
+module Bubbles
+  # FilePicker is a component for browsing and selecting files.
+  #
+  # Example:
+  #   picker = Bubbles::FilePicker.new
+  #   picker.current_directory = "."
+  #
+  #   # In update:
+  #   picker, command = picker.update(message)
+  #
+  #   # Check if a file was selected:
+  #   if picker.did_select_file?
+  #     selected_file = picker.path
+  #   end
+  #
+  #   # In view:
+  #   picker.view
+  class FilePicker
+    class ReadDirMessage < Bubbletea::Message
+      attr_reader id: Integer
+
+      attr_reader entries: Array[Hash[Symbol, untyped]]
+
+      # : (id: Integer, entries: Array[Hash[Symbol, untyped]]) -> void
+      def initialize: (id: Integer, entries: Array[Hash[Symbol, untyped]]) -> void
+    end
+
+    class ErrorMessage < Bubbletea::Message
+      attr_reader error: StandardError
+
+      # : (StandardError) -> void
+      def initialize: (StandardError) -> void
+    end
+
+    # : () -> Integer
+    def self.next_id: () -> Integer
+
+    attr_accessor height: Integer
+
+    attr_accessor cursor_char: String
+
+    attr_accessor show_permissions: bool
+
+    attr_accessor show_size: bool
+
+    attr_accessor show_hidden: bool
+
+    attr_accessor dir_allowed: bool
+
+    attr_accessor file_allowed: bool
+
+    attr_accessor allowed_types: Array[String]
+
+    attr_accessor cursor_style: Lipgloss::Style?
+
+    attr_accessor dir_style: Lipgloss::Style?
+
+    attr_accessor file_style: Lipgloss::Style?
+
+    attr_accessor selected_style: Lipgloss::Style?
+
+    attr_accessor permission_style: Lipgloss::Style?
+
+    attr_accessor size_style: Lipgloss::Style?
+
+    attr_accessor disabled_style: Lipgloss::Style?
+
+    attr_reader id: Integer
+
+    attr_reader current_directory: String
+
+    attr_reader path: String?
+
+    attr_reader files: Array[Hash[Symbol, untyped]]
+
+    # @rbs directory: String -- Starting directory
+    # @rbs return: void
+    def initialize: (?directory: String) -> void
+
+    # : (String) -> void
+    def current_directory=: (String) -> void
+
+    # : () -> bool
+    def did_select_file?: () -> bool
+
+    # : () -> bool
+    def selected?: () -> bool
+
+    # : () -> void
+    def clear_selected: () -> void
+
+    # : () -> Integer
+    def cursor: () -> Integer
+
+    # : (Bubbletea::Message) -> [FilePicker, Bubbletea::Command?]
+    def update: (Bubbletea::Message) -> [ FilePicker, Bubbletea::Command? ]
+
+    # : () -> String
+    def view: () -> String
+
+    private
+
+    # : (Bubbletea::KeyMessage) -> void
+    def handle_key: (Bubbletea::KeyMessage) -> void
+
+    # : () -> void
+    def read_directory: () -> void
+
+    # : (Hash[Symbol, untyped]) -> void
+    def enter_directory: (Hash[Symbol, untyped]) -> void
+
+    # : () -> void
+    def go_up: () -> void
+
+    # : (Hash[Symbol, untyped]) -> void
+    def select_file: (Hash[Symbol, untyped]) -> void
+
+    # : (Hash[Symbol, untyped]) -> bool
+    def can_select?: (Hash[Symbol, untyped]) -> bool
+
+    # : (String) -> String
+    def render_path: (String) -> String
+
+    # : (Hash[Symbol, untyped], bool) -> String
+    def render_entry: (Hash[Symbol, untyped], bool) -> String
+
+    # : (Integer) -> String
+    def format_permissions: (Integer) -> String
+
+    # : (Integer) -> String
+    def format_size: (Integer) -> String
+
+    # : () -> void
+    def update_offset: () -> void
+  end
+end

data/sig/bubbles/help.rbs

@@ -0,0 +1,88 @@
+# Generated from lib/bubbles/help.rb with RBS::Inline
+
+module Bubbles
+  # Help renders help text from key bindings.
+  #
+  # Example:
+  #   help = Bubbles::Help.new
+  #   help.width = 80
+  #
+  #   # Define a keymap with short_help and full_help methods
+  #   class MyKeyMap
+  #     BINDINGS = {
+  #       up: Bubbles::Key.binding(keys: ["up", "k"], help: ["↑/k", "up"]),
+  #       down: Bubbles::Key.binding(keys: ["down", "j"], help: ["↓/j", "down"]),
+  #       help: Bubbles::Key.binding(keys: ["?"], help: ["?", "help"]),
+  #       quit: Bubbles::Key.binding(keys: ["q"], help: ["q", "quit"])
+  #     }
+  #
+  #     def short_help
+  #       [BINDINGS[:help], BINDINGS[:quit]]
+  #     end
+  #
+  #     def full_help
+  #       [
+  #         [BINDINGS[:up], BINDINGS[:down]],
+  #         [BINDINGS[:help], BINDINGS[:quit]]
+  #       ]
+  #     end
+  #   end
+  #
+  #   keymap = MyKeyMap.new
+  #   puts help.view(keymap)
+  class Help
+    DEFAULT_KEY_STYLE: Lipgloss::Style?
+
+    DEFAULT_DESC_STYLE: Lipgloss::Style?
+
+    DEFAULT_SEPARATOR_STYLE: Lipgloss::Style?
+
+    attr_accessor width: Integer
+
+    attr_accessor show_all: bool
+
+    attr_accessor short_separator: String
+
+    attr_accessor full_separator: String
+
+    attr_accessor full_help_column_gap: Integer
+
+    attr_accessor key_style: Lipgloss::Style?
+
+    attr_accessor desc_style: Lipgloss::Style?
+
+    attr_accessor separator_style: Lipgloss::Style?
+
+    # : () -> void
+    def initialize: () -> void
+
+    # : (untyped) -> String
+    def view: (untyped) -> String
+
+    # : (Array[Key::Binding]?) -> String
+    def short_help_view: (Array[Key::Binding]?) -> String
+
+    # : (Array[Array[Key::Binding]]?) -> String
+    def full_help_view: (Array[Array[Key::Binding]]?) -> String
+
+    private
+
+    # : (Key::Binding) -> String
+    def render_binding: (Key::Binding) -> String
+
+    # : (String) -> String
+    def render_key: (String) -> String
+
+    # : (String) -> String
+    def render_desc: (String) -> String
+
+    # : (String) -> String
+    def render_separator: (String) -> String
+
+    # : (String) -> String
+    def truncate_to_width: (String) -> String
+
+    # : (String) -> String
+    def strip_ansi: (String) -> String
+  end
+end

data/sig/bubbles/key.rbs

@@ -0,0 +1,63 @@
+# Generated from lib/bubbles/key.rb with RBS::Inline
+
+module Bubbles
+  # Key provides helpers for defining and matching key bindings.
+  #
+  # Example:
+  #   # Define key bindings
+  #   KEYS = {
+  #     up: Bubbles::Key.binding(
+  #       keys: ["up", "k"],
+  #       help: ["↑/k", "move up"]
+  #     ),
+  #     down: Bubbles::Key.binding(
+  #       keys: ["down", "j"],
+  #       help: ["↓/j", "move down"]
+  #     ),
+  #     quit: Bubbles::Key.binding(
+  #       keys: ["q", "esc", "ctrl+c"],
+  #       help: ["q", "quit"]
+  #     )
+  #   }
+  #
+  #   # Match in update
+  #   def update(message)
+  #     case message
+  #     when Bubbletea::KeyMessage
+  #       if Bubbles::Key.matches?(message, KEYS[:up])
+  #         # handle up
+  #       elsif Bubbles::Key.matches?(message, KEYS[:down])
+  #         # handle down
+  #       end
+  #     end
+  #   end
+  module Key
+    class Binding
+      attr_accessor keys: Array[String]
+
+      attr_accessor help_key: String?
+
+      attr_accessor help_desc: String?
+
+      attr_accessor enabled: bool
+
+      # : (keys: Array[String], ?help_key: String?, ?help_desc: String?, ?enabled: bool) -> void
+      def initialize: (keys: Array[String], ?help_key: String?, ?help_desc: String?, ?enabled: bool) -> void
+
+      # : () -> bool
+      def enabled?: () -> bool
+
+      # : () -> bool
+      def help?: () -> bool
+
+      # : () -> [String, String]
+      def help: () -> [ String, String ]
+    end
+
+    # : (keys: Array[String] | String, ?help: Array[String]?, ?enabled: bool) -> Binding
+    def self.binding: (keys: Array[String] | String, ?help: Array[String]?, ?enabled: bool) -> Binding
+
+    # : (Bubbletea::KeyMessage, *Binding) -> bool
+    def self.matches?: (Bubbletea::KeyMessage, *Binding) -> bool
+  end
+end

data/sig/bubbles/list.rbs

@@ -0,0 +1,138 @@
+# Generated from lib/bubbles/list.rb with RBS::Inline
+
+module Bubbles
+  # List is a feature-rich component for browsing a list of items.
+  # It features optional filtering, pagination, and status messages.
+  #
+  # Example:
+  #   items = [
+  #     { title: "Item 1", description: "Description 1" },
+  #     { title: "Item 2", description: "Description 2" }
+  #   ]
+  #   list = Bubbles::List.new(items, width: 40, height: 10)
+  #
+  #   # In update:
+  #   list, command = list.update(message)
+  #
+  #   # In view:
+  #   list.view
+  class List
+    UNFILTERED: Symbol
+
+    FILTERING: Symbol
+
+    FILTER_APPLIED: Symbol
+
+    class StatusMessageTimeoutMessage < Bubbletea::Message
+    end
+
+    attr_accessor width: Integer
+
+    attr_accessor height: Integer
+
+    attr_accessor title: String
+
+    attr_accessor show_title: bool
+
+    attr_accessor show_filter: bool
+
+    attr_accessor show_pagination: bool
+
+    attr_accessor show_status_bar: bool
+
+    attr_accessor status_message_lifetime: Float
+
+    attr_accessor fill_height: bool
+
+    attr_accessor title_style: Lipgloss::Style?
+
+    attr_accessor item_style: Lipgloss::Style?
+
+    attr_accessor selected_item_style: Lipgloss::Style?
+
+    attr_accessor filter_prompt: String
+
+    attr_accessor filter_style: Lipgloss::Style?
+
+    attr_accessor status_bar_style: Lipgloss::Style?
+
+    attr_accessor pagination_style: Lipgloss::Style?
+
+    attr_reader filter_state: Symbol
+
+    attr_reader filter_input: TextInput
+
+    # : (?Array[untyped], ?width: Integer, ?height: Integer) -> void
+    def initialize: (?Array[untyped], ?width: Integer, ?height: Integer) -> void
+
+    # : (Array[untyped]) -> void
+    def items=: (Array[untyped]) -> void
+
+    attr_reader items: Array[untyped]
+
+    # : () -> Array[untyped]
+    def visible_items: () -> Array[untyped]
+
+    # : () -> Integer
+    def selected_index: () -> Integer
+
+    # : () -> untyped
+    def selected_item: () -> untyped
+
+    # : (Integer) -> void
+    def select: (Integer) -> void
+
+    # : () -> void
+    def select_next: () -> void
+
+    # : () -> void
+    def select_prev: () -> void
+
+    # : (String) -> Bubbletea::Command
+    def set_status_message: (String) -> Bubbletea::Command
+
+    # : () -> void
+    def clear_status_message: () -> void
+
+    # : () -> Bubbletea::Command?
+    def start_filtering: () -> Bubbletea::Command?
+
+    # : () -> void
+    def apply_filter: () -> void
+
+    # : () -> void
+    def reset_filter: () -> void
+
+    # : (Bubbletea::Message) -> [List, Bubbletea::Command?]
+    def update: (Bubbletea::Message) -> [ List, Bubbletea::Command? ]
+
+    # : () -> String
+    def view: () -> String
+
+    private
+
+    # : () -> String
+    def items_view: () -> String
+
+    # : (untyped, Integer, bool) -> String
+    def render_item: (untyped, Integer, bool) -> String
+
+    # : (untyped) -> String
+    def item_title: (untyped) -> String
+
+    # : (untyped) -> String
+    def item_filter_value: (untyped) -> String
+
+    # : () -> void
+    def do_filter: () -> void
+
+    # : () -> Integer
+    def visible_item_count: () -> Integer
+
+    # : () -> void
+    def update_offset: () -> void
+
+    # : () -> void
+    def update_pagination: () -> void
+  end
+end

data/sig/bubbles/paginator.rbs

@@ -0,0 +1,90 @@
+# Generated from lib/bubbles/paginator.rb with RBS::Inline
+
+module Bubbles
+  # Paginator provides pagination logic and rendering.
+  #
+  # Example:
+  #   items = (1..100).to_a
+  #   paginator = Bubbles::Paginator.new(per_page: 10)
+  #   paginator.update_total_pages(items.length)
+  #
+  #   # Get current page items
+  #   start_index, end_index = paginator.slice_bounds(items.length)
+  #   current_items = items[start_index...end_index]
+  #
+  #   # Navigation
+  #   paginator.next_page
+  #   paginator.prev_page
+  #
+  #   # Render pagination indicator
+  #   puts paginator.view
+  class Paginator
+    ARABIC: Symbol
+
+    DOTS: Symbol
+
+    attr_accessor type: Symbol
+
+    attr_accessor page: Integer
+
+    attr_accessor per_page: Integer
+
+    attr_accessor total_pages: Integer
+
+    attr_accessor active_dot: String
+
+    attr_accessor inactive_dot: String
+
+    attr_accessor arabic_format: String
+
+    attr_accessor key_style: Lipgloss::Style?
+
+    attr_accessor active_dot_style: Lipgloss::Style?
+
+    attr_accessor inactive_dot_style: Lipgloss::Style?
+
+    # : (?type: Symbol, ?per_page: Integer) -> void
+    def initialize: (?type: Symbol, ?per_page: Integer) -> void
+
+    # : (Integer) -> void
+    def update_total_pages: (Integer) -> void
+
+    # : (Integer) -> Integer
+    def items_on_page: (Integer) -> Integer
+
+    # : (Integer) -> [Integer, Integer]
+    def slice_bounds: (Integer) -> [ Integer, Integer ]
+
+    # : () -> bool
+    def prev_page?: () -> bool
+
+    # : () -> bool
+    def next_page?: () -> bool
+
+    # : () -> bool
+    def prev_page: () -> bool
+
+    # : () -> bool
+    def next_page: () -> bool
+
+    # : (Integer) -> bool
+    def go_to_page: (Integer) -> bool
+
+    # : () -> String
+    def view: () -> String
+
+    private
+
+    # : () -> String
+    def arabic_view: () -> String
+
+    # : () -> String
+    def dots_view: () -> String
+
+    # : () -> String
+    def render_active_dot: () -> String
+
+    # : () -> String
+    def render_inactive_dot: () -> String
+  end
+end

data/sig/bubbles/progress.rbs

@@ -0,0 +1,123 @@
+# Generated from lib/bubbles/progress.rb with RBS::Inline
+
+module Bubbles
+  # Progress renders an animated progress bar.
+  #
+  # Example:
+  #   progress = Bubbles::Progress.new
+  #   progress.width = 40
+  #
+  #   # Static rendering
+  #   puts progress.view_as(0.5)  # 50%
+  #
+  #   # Animated rendering (use in bubbletea)
+  #   command = progress.set_percent(0.75)
+  #   # Then in update: progress.update(message)
+  #   puts progress.view
+  class Progress
+    class FrameMessage < Bubbletea::Message
+      attr_reader id: Integer
+
+      attr_reader tag: Integer
+
+      # : (id: Integer, tag: Integer) -> void
+      def initialize: (id: Integer, tag: Integer) -> void
+    end
+
+    FPS: Integer
+
+    DEFAULT_WIDTH: Integer
+
+    SPRING_FREQUENCY: Float
+
+    SPRING_DAMPING: Float
+
+    # : () -> Integer
+    def self.next_id: () -> Integer
+
+    attr_accessor width: Integer
+
+    attr_accessor full: String
+
+    attr_accessor full_color: String
+
+    attr_accessor empty: String
+
+    attr_accessor empty_color: String
+
+    attr_accessor show_percentage: bool
+
+    attr_accessor percent_format: String
+
+    attr_accessor percent_style: Lipgloss::Style?
+
+    attr_accessor use_gradient: bool
+
+    attr_accessor gradient_a: String?
+
+    attr_accessor gradient_b: String?
+
+    attr_accessor scale_gradient: bool
+
+    attr_reader id: Integer
+
+    # : (?width: Integer, ?gradient: Array[String]?, ?scaled_gradient: Array[String]?, ?solid_fill: String?) -> void
+    def initialize: (?width: Integer, ?gradient: Array[String]?, ?scaled_gradient: Array[String]?, ?solid_fill: String?) -> void
+
+    # : () -> nil
+    def init: () -> nil
+
+    # : (Bubbletea::Message) -> [Progress, Bubbletea::Command?]
+    def update: (Bubbletea::Message) -> [ Progress, Bubbletea::Command? ]
+
+    # : () -> String
+    def view: () -> String
+
+    # : (Float) -> String
+    def view_as: (Float) -> String
+
+    # : () -> Float
+    def percent: () -> Float
+
+    # : (Float) -> Bubbletea::Command
+    def set_percent: (Float) -> Bubbletea::Command
+
+    # : (?Float) -> Bubbletea::Command
+    def increment_percent: (?Float) -> Bubbletea::Command
+
+    # : (?Float) -> Bubbletea::Command
+    def decrement_percent: (?Float) -> Bubbletea::Command
+
+    # : () -> bool
+    def animating?: () -> bool
+
+    # : (String, String, ?scaled: bool) -> void
+    def gradient: (String, String, ?scaled: bool) -> void
+
+    private
+
+    # : () -> Bubbletea::Command
+    def next_frame: () -> Bubbletea::Command
+
+    # : (Float, Integer) -> String
+    def render_bar: (Float, Integer) -> String
+
+    # : (Integer) -> String
+    def render_solid_fill: (Integer) -> String
+
+    # : (Integer) -> String
+    def render_empty_fill: (Integer) -> String
+
+    # : (Integer, Integer) -> String
+    def render_gradient_fill: (Integer, Integer) -> String
+
+    # : (Float) -> String
+    def render_percentage: (Float) -> String
+
+    # : (String, String) -> String
+    def colorize: (String, String) -> String
+
+    # : (String?, String?, Float) -> String
+    def blend_colors: (String?, String?, Float) -> String
+  end
+end

data/sig/bubbles/spinner/spinners.rbs

@@ -0,0 +1,32 @@
+# Generated from lib/bubbles/spinner/spinners.rb with RBS::Inline
+
+module Bubbles
+  module Spinners
+    LINE: Hash[Symbol, Array[String] | Float]
+
+    DOT: Hash[Symbol, Array[String] | Float]
+
+    MINI_DOT: Hash[Symbol, Array[String] | Float]
+
+    JUMP: Hash[Symbol, Array[String] | Float]
+
+    PULSE: Hash[Symbol, Array[String] | Float]
+
+    POINTS: Hash[Symbol, Array[String] | Float]
+
+    GLOBE: Hash[Symbol, Array[String] | Float]
+
+    MOON: Hash[Symbol, Array[String] | Float]
+
+    MONKEY: Hash[Symbol, Array[String] | Float]
+
+    METER: Hash[Symbol, Array[String] | Float]
+
+    HAMBURGER: Hash[Symbol, Array[String] | Float]
+
+    ELLIPSIS: Hash[Symbol, Array[String] | Float]
+
+    # @rbs DEFAULT:
+    DEFAULT: Hash[Symbol, Array[String] | Float]
+  end
+end