fatty 0.99.0

data/lib/fatty/view/status_view.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Fatty
+  class StatusView < View
+    def render(screen:, renderer:, terminal:)
+      return unless terminal.status_text
+
+      renderer.render_status(
+        terminal.status_text,
+        role: terminal.status_role || :info,
+      )
+    end
+  end
+end

data/lib/fatty/view.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Fatty
+  class View
+    attr_reader :id, :z
+
+    def initialize(id: nil, z: 0, log: false)
+      @id = (id || self.class.name.split("::").last).to_s
+      @z  = Integer(z)
+      @log = !!log
+    end
+
+    # Render wrapper: logs once, then delegates to #draw.
+    # Subclasses implement #draw.
+    def render(screen:, renderer:, terminal:, session:)
+      if @log
+        Fatty.debug(
+          "View#render",
+          tag: :render,
+          view: id,
+          z: z,
+          session: session.respond_to?(:id) ? session.id : session.class.name,
+        )
+      end
+
+      draw(screen:, renderer:, terminal:, session:)
+    end
+
+    def draw(screen:, renderer:, terminal:, session:)
+      raise NotImplementedError, "#{self.class} must implement #draw"
+    end
+  end
+end

data/lib/fatty/viewport.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Fatty
+  class Viewport
+    attr_accessor :top
+    attr_accessor :height
+
+    def initialize(top: 0, height:)
+      @top    = top
+      @height = height
+    end
+
+    def adjust_for_trim(n)
+      @top = [@top - n, 0].max
+    end
+
+    def at_bottom?(total_lines = nil)
+      return false unless total_lines
+
+      @top >= max_top(total_lines)
+    end
+
+    def at_top?
+      @top <= 0
+    end
+
+    # 1-based index of the last visible line (clamped), or 0 if no lines.
+    def bottom_index(total_lines)
+      return 0 if total_lines <= 0
+
+      [@top + @height, total_lines].min
+    end
+
+    def position_percent(total_lines)
+      return 100 if total_lines <= 0
+
+      b = bottom_index(total_lines)
+      pct = (b.to_f / total_lines.to_f) * 100.0
+      pct.round
+    end
+
+    def slice(lines)
+      lines[@top, @height] || []
+    end
+
+    def max_top(total_lines)
+      [total_lines - @height, 0].max
+    end
+
+    def clamp!(lines)
+      @top = @top.clamp(0, max_top(lines.size))
+    end
+
+    def scroll_up(lines, n = 1)
+      @top -= n
+      clamp!(lines)
+    end
+
+    def scroll_down(lines, n = 1)
+      @top += n
+      clamp!(lines)
+    end
+
+    def scroll_to_bottom(lines)
+      @top = max_top(lines.size)
+    end
+
+    def page_up(lines)
+      scroll_up(lines, @height)
+    end
+
+    def page_down(lines)
+      scroll_down(lines, @height)
+    end
+
+    # Jump to the very top.
+    def page_top
+      @top = 0
+    end
+
+    # Jump to the very bottom.
+    def page_bottom(lines)
+      @top = max_top(lines.size)
+    end
+
+    def reset
+      @top = 0
+    end
+  end
+end

data/lib/fatty/views.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative "view"
+
+require_relative "view/output_view"
+require_relative "view/alert_view"
+require_relative "view/input_view"
+require_relative "view/cursor_view"
+require_relative "view/status_view"

data/lib/fatty.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'fat_config'
+require "json"
+require "time"
+require "fileutils"
+require "rainbow"
+require "redcarpet"
+require "strscan"
+
+require 'debug'
+
+# Gem Overview (extracted from README.org by gem_docs)
+#
+# * Introduction
+#
+module Fatty
+  require_relative "fatty/version"
+  require_relative "fatty/core_ext"
+  require_relative "fatty/env"
+  require_relative "fatty/config"
+  require_relative "fatty/logger"
+  require_relative "fatty/counter"
+  require_relative "fatty/action_environment"
+  require_relative "fatty/accept_env"
+  require_relative "fatty/action"
+  require_relative "fatty/actionable"
+  require_relative "fatty/history"
+  require_relative "fatty/search"
+  require_relative "fatty/input_buffer"
+  require_relative "fatty/input_field"
+  require_relative "fatty/output_buffer"
+  require_relative "fatty/pager"
+  require_relative "fatty/alert"
+  require_relative "fatty/key_event"
+  require_relative "fatty/mouse_event"
+  require_relative "fatty/key_map"
+  require_relative "fatty/themes"
+  require_relative "fatty/ansi"
+  require_relative "fatty/colors"
+  require_relative "fatty/curses"
+  require_relative "fatty/renderer"
+  require_relative "fatty/prompt"
+  require_relative "fatty/menu_env"
+  require_relative "fatty/screen"
+  require_relative "fatty/viewport"
+  require_relative "fatty/views"
+  require_relative "fatty/sessions"
+  require_relative "fatty/terminal"
+  require_relative "fatty/markdown"
+  require_relative "fatty/help"
+
+  class Error < StandardError; end
+end

data/sig/fatty.rbs

@@ -0,0 +1,4 @@
+module Fatty
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,250 @@
+--- !ruby/object:Gem::Specification
+name: fatty
+version: !ruby/object:Gem::Version
+  version: 0.99.0
+platform: ruby
+authors:
+- Daniel E. Doherty
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: curses
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: fat_config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: unicode-display_width
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: yaml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rouge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |
+  fatty is a pure Ruby curses-backed terminal interaction library with editable single-line input, scrollable output, and
+  programmable keybindings, inspired by modern shells like fish.
+email:
+- ded@ddoherty.net
+executables:
+- fatty
+extensions: []
+extra_rdoc_files: []
+files:
+- ".envrc"
+- ".simplecov"
+- ".yardopts"
+- CHANGELOG.md
+- CHANGELOG.org
+- LICENSE.txt
+- README.md
+- README.org
+- Rakefile
+- TODO.org
+- examples/markdown/native-markdown.md
+- examples/markdown/ox-gfm-markdown.md
+- examples/markdown/ox-gfm-markdown.org
+- exe/fatty
+- fatty.gemspec
+- lib/fatty.rb
+- lib/fatty/accept_env.rb
+- lib/fatty/action.rb
+- lib/fatty/action_environment.rb
+- lib/fatty/actionable.rb
+- lib/fatty/alert.rb
+- lib/fatty/ansi.rb
+- lib/fatty/ansi/renderer.rb
+- lib/fatty/colors.rb
+- lib/fatty/colors/color.rb
+- lib/fatty/colors/pairs.rb
+- lib/fatty/colors/palette.rb
+- lib/fatty/colors/rgb.txt
+- lib/fatty/config.rb
+- lib/fatty/config_files/config.yml
+- lib/fatty/config_files/help.md
+- lib/fatty/config_files/help.org
+- lib/fatty/config_files/keybindings.yml
+- lib/fatty/config_files/keydefs.yml
+- lib/fatty/config_files/themes/mono.yml
+- lib/fatty/config_files/themes/nordic.yml
+- lib/fatty/config_files/themes/solarized_dark.yml
+- lib/fatty/config_files/themes/terminal.yml
+- lib/fatty/config_files/themes/wordperfect.yml
+- lib/fatty/config_files/themes/wordperfect_light.yml
+- lib/fatty/core_ext.rb
+- lib/fatty/core_ext/string.rb
+- lib/fatty/counter.rb
+- lib/fatty/curses.rb
+- lib/fatty/curses/context.rb
+- lib/fatty/curses/curses_coder.rb
+- lib/fatty/curses/event_source.rb
+- lib/fatty/curses/key_decoder.rb
+- lib/fatty/curses/patch.rb
+- lib/fatty/curses/window_styling.rb
+- lib/fatty/env.rb
+- lib/fatty/help.rb
+- lib/fatty/history.rb
+- lib/fatty/history/entry.rb
+- lib/fatty/input_buffer.rb
+- lib/fatty/input_field.rb
+- lib/fatty/key_event.rb
+- lib/fatty/key_map.rb
+- lib/fatty/keymaps/emacs.rb
+- lib/fatty/log_formats/json.rb
+- lib/fatty/log_formats/text.rb
+- lib/fatty/logger.rb
+- lib/fatty/markdown.rb
+- lib/fatty/markdown/ansi_renderer.rb
+- lib/fatty/markdown/render.rb
+- lib/fatty/menu_env.rb
+- lib/fatty/mouse_event.rb
+- lib/fatty/output_buffer.rb
+- lib/fatty/pager.rb
+- lib/fatty/prompt.rb
+- lib/fatty/renderer.rb
+- lib/fatty/renderer/curses.rb
+- lib/fatty/renderer/truecolor.rb
+- lib/fatty/screen.rb
+- lib/fatty/search.rb
+- lib/fatty/session.rb
+- lib/fatty/session/alert_session.rb
+- lib/fatty/session/input_session.rb
+- lib/fatty/session/isearch_session.rb
+- lib/fatty/session/keytest_session.rb
+- lib/fatty/session/modal_session.rb
+- lib/fatty/session/output_session.rb
+- lib/fatty/session/popup_session.rb
+- lib/fatty/session/prompt_session.rb
+- lib/fatty/session/search_session.rb
+- lib/fatty/session/shell_session.rb
+- lib/fatty/sessions.rb
+- lib/fatty/terminal.rb
+- lib/fatty/terminal/popup_owner.rb
+- lib/fatty/terminal/progress.rb
+- lib/fatty/themes.rb
+- lib/fatty/themes/loader.rb
+- lib/fatty/themes/manager.rb
+- lib/fatty/themes/registry.rb
+- lib/fatty/themes/resolver.rb
+- lib/fatty/themes/themes.rb
+- lib/fatty/version.rb
+- lib/fatty/view.rb
+- lib/fatty/view/alert_view.rb
+- lib/fatty/view/cursor_view.rb
+- lib/fatty/view/input_view.rb
+- lib/fatty/view/output_view.rb
+- lib/fatty/view/status_view.rb
+- lib/fatty/viewport.rb
+- lib/fatty/views.rb
+- sig/fatty.rbs
+homepage: https://github.com/ddoherty03/fatty
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/ddoherty03/fatty
+  source_code_uri: https://github.com/ddoherty03/fatty
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.0
+specification_version: 4
+summary: Stateful terminal UI with editable input and scrollback
+test_files: []