termvas 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e006617f9d17384317e9c45880fbdef15e35049894eb82013557d170e805c97d
-  data.tar.gz: 05fc5d8aeff21250c54bef69b4cd81c023d1c6c02aaac47c1ad72046f3c22ccd
+  metadata.gz: d3cf29b6b2bd27eb84a1cda85bb993a8e5f642bb27c97aab69f944a968809374
+  data.tar.gz: 646acf9519788a0944ae798247a5d82ee7f63c8db098fb65892b0876ddca285e
 SHA512:
-  metadata.gz: 64cad8ca3988821b0361941f9027c2ff763e7b5b16e5fd8ac7a6b7b9e6f5859697474fe2901f001f98c1525c825aeeb8dae5e3b1c4b70eabd79897a030db556e
-  data.tar.gz: 3cdda1da18561fd32d131dda835f19fc6062b7f4626acef9b0713b5a8ea843cf788843b5f2750b9d656cced5fbf811bfece6c01a3dd257582f540675a2485f81
+  metadata.gz: 2c23b3ec1a1a79e1126e976df5c4aba2ba1fae6af962c86ffbcbdfc8c021efd9340892485f7441dac1205d44b99c35e8762e716a3fef18990c6fd7f7c5efe330
+  data.tar.gz: 768c92089cbec5566b6b7db8193cbedf5e51399ae86fcee805a7cfbb25b7af73438d734b48b7437b2ff29f8469d76dd059426f2f7815bb2a84bb2500a8769873

data/CHANGELOG.md

@@ -1,6 +1,8 @@
 # Changelog
 
-## [Unreleased]
+## [0.3.0] - Unreleased
+
+- Expose terminal cell-size estimates for display fitting, with environment overrides.
 
 ## [0.2.0] - 2026-09-25
 

data/README.md

@@ -84,6 +84,12 @@ The encoders, protocol detection, input parser, and terminal sizing utilities
 load with <code>require "termvas"</code> alone. The optional RBGL backend is
 available from <code>require "termvas/rbgl"</code>.
 
+<code>Termvas::Terminal#size</code> returns <code>[columns, rows]</code>.
+<code>#cell_size</code> returns estimated pixel dimensions as
+<code>[width, height]</code> (8 × 16 by default). Set
+<code>TERMVAS_CELL_WIDTH</code> and <code>TERMVAS_CELL_HEIGHT</code> to tune the
+estimate; sizing does not query the terminal.
+
 ## Terminal notes
 
 <code>fit: :contain</code> is the default and reduces oversized frames to the

data/lib/termvas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Termvas
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/termvas.rb

@@ -271,10 +271,11 @@ module Termvas
   class Terminal
     attr_reader :input, :output
 
-    def initialize(input: $stdin, output: $stdout, alt_screen: true, tmux: false)
+    def initialize(input: $stdin, output: $stdout, alt_screen: true, tmux: false, env: ENV)
       @input = input
       @output = output
       @alt_screen = alt_screen
+      @env = env
       @closed = false
       @opened = false
       @raw = false
@@ -288,10 +289,14 @@ module Termvas
       return [columns, rows] if rows.to_i.positive? && columns.to_i.positive?
 
       fallback_size
-    rescue Errno::ENOTTY, IOError, NoMethodError
+    rescue Errno::ENODEV, Errno::ENOTTY, IOError, NoMethodError
       fallback_size
     end
 
+    def cell_size
+      [environment_dimension("TERMVAS_CELL_WIDTH", 8), environment_dimension("TERMVAS_CELL_HEIGHT", 16)]
+    end
+
     def open
       return self if @opened
       @opened = true
@@ -367,12 +372,19 @@ module Termvas
     end
 
     def fallback_size
-      columns = Integer(ENV.fetch("COLUMNS", 80))
-      rows = Integer(ENV.fetch("LINES", 24))
+      columns = Integer(@env.fetch("COLUMNS", 80))
+      rows = Integer(@env.fetch("LINES", 24))
       [columns.positive? ? columns : 80, rows.positive? ? rows : 24]
     rescue ArgumentError, TypeError
       [80, 24]
     end
+
+    def environment_dimension(name, fallback)
+      value = Integer(@env.fetch(name, fallback))
+      value.positive? ? value : fallback
+    rescue ArgumentError, TypeError
+      fallback
+    end
   end
 
 end

data/sig/termvas.rbs

@@ -1,4 +1,9 @@
 module Termvas
   VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+
+  class Terminal
+    def initialize: (?input: untyped, ?output: untyped, ?alt_screen: bool, ?tmux: bool, ?env: Hash[String, String]) -> void
+    def size: () -> [Integer, Integer]
+    def cell_size: () -> [Integer, Integer]
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: termvas
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Yudai Takada