typr 1.8.0 → 1.9.2

data/lib/text.rb

@@ -4,7 +4,9 @@ require_relative 'stack.rb'
 module Typr
 
   # A vertically scrollable text viewer with word-wrapping, header bar,
-  # row selection via hint characters, and pager-style search (/ n p).
+  # row selection via hint characters (+pick :row+), word selection via
+  # +pick :column+ (hints sit on word boundaries), and pager-style
+  # search (/ n p).
   #
   # Accepts String, IO, or StringIO input. Content is split into display
   # rows by newlines and line width, then rendered as a sliding window.
@@ -22,7 +24,12 @@ module Typr
 
   class Text < Stack
 
-    ## Tabstop width in spaces. Default: 2.
+    ##
+    # Tabstop width in spaces applied by {#build}. Default: 2.
+    #
+    #   text.tabspace = 4
+    #   text.tabspace   #=> 4
+
     attr_accessor :tabspace
 
     # Rebuilds the internal line buffer from +input+.
@@ -32,6 +39,9 @@ module Typr
     #   text.build("one\ntwo three")  # => #<Typr::Text ...>
     #   text << "appended line"       # alias for build
 
+    # @param input [String, IO, nil] text (or stream) to append; nil reflows
+    # @return [Text] self
+
     def build input=nil
       ( input, @data, @lines = @data, "", [0] ) if rebuild = !input
       return self if rebuild && input == ""
@@ -77,7 +87,7 @@ module Typr
         else
           @tail = ""
         end
-        @lines << @data.length if wrap < line.length || line.include?("\n")
+        @lines << @data.length if line.include?("\n") || pos < str.size || !@tail.empty?
       end
       until @tail.empty?
         wrap_idx = @tail.index("\n") || @tail.rindex(" ") || @tail.length
@@ -92,6 +102,7 @@ module Typr
       end
       @lines << @data.length unless @lines.last == @data.length
       highlight if @re
+      self
     end
     alias :<< :build
 
@@ -132,8 +143,7 @@ module Typr
     def show
       (build; @lastwidth = width) if width != @lastwidth
       range = @lines[@start..@start+height]
-      page = StringIO.new @data[range.first..range.last]
-      @page=range[1..-1].map{|pos| page.read(pos-range.first-page.pos).rstrip}
+      @page = range.each_cons(2).map{ |a, b| @data[a...b].rstrip }
       super
     end
 
@@ -173,15 +183,31 @@ module Typr
       step
     end
 
-    ## Jump to the next match of the last search (wrap-around). Returns its line id or nil.
+    ##
+    # Jump to the next match of the last search (wrap-around).
+    #
+    #   text.search_next   #=> 12  (next matching line id, or nil)
+    #
+    # @return [Integer, nil] matched line id
 
     def search_next; @search[:dir] = :forward; step end
 
-    ## Jump to the previous match of the last search (wrap-around). Returns its line id or nil.
+    ##
+    # Jump to the previous match of the last search (wrap-around).
+    #
+    #   text.search_prev   #=> 12  (previous matching line id, or nil)
+    #
+    # @return [Integer, nil] matched line id
 
     def search_prev; @search[:dir] = :backward; step end
 
-    ## Recompute the set of lines containing the current pattern.
+    ##
+    # Recompute the set of lines containing the current pattern (called
+    # by {#search} and {#build}).
+    #
+    #   text.highlight   # @search[:matches] updated
+    #
+    # @return [nil]
 
     def highlight
       @search[:matches] = @re ?
@@ -190,7 +216,12 @@ module Typr
       return
     end
 
-    ## Clear the search pattern and all match highlights.
+    ##
+    # Clear the search pattern and all match highlights.
+    #
+    #   text.highlight_clear   # matches => [], pattern => nil
+    #
+    # @return [nil]
 
     def highlight_clear
       @re = @search[:pattern] = nil
@@ -203,6 +234,12 @@ module Typr
     #
     #   text = Typr::Text.new(input: "hello", header: "Title")
     #   text = Typr::Text.new(input: $stdin, tabspace: 4)
+    #
+    #   Option     | Value
+    #   -----------|------------------------------------------------
+    #   +input+    | String, IO, or StringIO (nil reflows from empty)
+    #   +tabspace+ | tabstop width in spaces (default 2)
+    #   +colors+   | +regex:+ paint map or scheme name (see {Typr.paint})
 
     def initialize args={}
       @tabspace = 2
@@ -215,8 +252,17 @@ module Typr
       self << @input
     end
 
-    # Reset state: +:search+ clears the pattern and highlights; +:all+ resets
-    # position, selection, and search; else falls through to {Stack#reset}.
+    ##
+    # Reset state: +:search+ clears the pattern and highlights, +:all+
+    # resets position, selection, and search; anything else falls through
+    # to {Stack#reset}.
+    #
+    #   text.reset :search
+    #   text.reset :all
+    #
+    # @param type [:search, :all, :position, :selection, Array<Symbol>]
+    # @return [void]
+
     def reset type=:all
       case type
         when :search; highlight_clear

data/lib/typr.rb

@@ -5,10 +5,12 @@
 #
 # * Typr::Grid   - Sortable, filterable table with formatted columns and row selection
 # * Typr::Text   - Scrollable text viewer with word/line picking and search
-# * Typr::Browser - File-system directory browser with MIME type detection
+# * Typr::Browser - File-system directory browser with MIME type detection,
+#   live / narrowing, mark/range selection, and a rebindable keybar
 # * Typr::Stack  - Scrollable container with keyboard navigation and hint overlays
 # * Typr::Space  - Base layout primitive with border drawing
-# * Typr::Line   - Interactive prompt/input with colored questions and answers
+# * Typr::Line   - Interactive prompt/input with colored questions and
+#   answers, ask question types, and shell command-line completion
 #
 # == Terminal Control
 #
@@ -35,7 +37,7 @@
 #   grid = Typr::Grid.new(
 #     input:  [['Alice', 30], ['Bob', 25]],
 #     header: ['Name', 'Age'],
-#     format: [:max, :right]
+#     format: [:max, :min]
 #   )
 #   grid.show
 #   key = Typr.read_key

data/typr.gemspec

@@ -2,8 +2,8 @@
 
 Gem::Specification.new do |s|
   s.name = "typr"
-  s.version = "1.8.0"
-  s.date = "2026-10-11"
+  s.version = "1.9.2"
+  s.date = "2026-10-13"
   s.homepage = "https://codeberg.org/typr/typr"
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: typr
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.2
 platform: ruby
 authors:
 - Kilian Reitmayr
 bindir: bin
 cert_chain: []
-date: 2026-10-11 00:00:00.000000000 Z
+date: 2026-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unicode-display_width