typr 1.8.0 → 1.9.0

data/lib/text.rb

@@ -22,7 +22,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+.
@@ -173,15 +178,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 +211,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
@@ -215,8 +241,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
 #

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.0"
+  s.date = "2026-10-12"
   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.0
 platform: ruby
 authors:
 - Kilian Reitmayr
 bindir: bin
 cert_chain: []
-date: 2026-10-11 00:00:00.000000000 Z
+date: 2026-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unicode-display_width