termvas 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e006617f9d17384317e9c45880fbdef15e35049894eb82013557d170e805c97d
-  data.tar.gz: 05fc5d8aeff21250c54bef69b4cd81c023d1c6c02aaac47c1ad72046f3c22ccd
+  metadata.gz: d96a53546db38dd9887bd4f0368a1b818ea2eafd58bb7fc9024ef1bf5d6d08da
+  data.tar.gz: 01ccfbff4469d665303695ad61600c8e591604cc7ce9b8b5c6f64b1026d48199
 SHA512:
-  metadata.gz: 64cad8ca3988821b0361941f9027c2ff763e7b5b16e5fd8ac7a6b7b9e6f5859697474fe2901f001f98c1525c825aeeb8dae5e3b1c4b70eabd79897a030db556e
-  data.tar.gz: 3cdda1da18561fd32d131dda835f19fc6062b7f4626acef9b0713b5a8ea843cf788843b5f2750b9d656cced5fbf811bfece6c01a3dd257582f540675a2485f81
+  metadata.gz: af06e7b15123c603edef3f89b8c5b8e13e7a3fde78ae0ed052a07f9a7320985e81ab6e75ec396760a289f70d835bd01100329d7bee9aa1242077df47b7f99225
+  data.tar.gz: a416408455b495482c2cc057c284509de678fdf48e15d950caa9f36637c5bd929a2110f20155e8da083231cf9ef06c7cb173027460418734d0577d1553824a91

data/.codespellignore

@@ -0,0 +1 @@
+iTerm

data/.yamllint

@@ -0,0 +1,16 @@
+extends: default
+ignore: |
+  build/
+  node_modules/
+  runtime/build/
+  tmp/
+  **/*.dSYM/**
+
+rules:
+  comments:
+    min-spaces-from-content: 1
+  document-start: disable
+  line-length:
+    max: 200
+  truthy:
+    check-keys: false

data/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Changelog
 
-## [Unreleased]
+## [0.3.1] - 2026-09-26
+
+- Skip unsupported terminal control sequences instead of reporting them as key events.
+- Reject non-finite terminal frame limits.
+
+## [0.3.0] - 2026-09-25
+
+- 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/Rakefile

@@ -3,9 +3,7 @@
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 
-RSpec::Core::RakeTask.new(:spec) do |task|
-  task.ruby_opts = %w[-I../rbgl/lib -I../larb/lib -I../tessel/lib]
-end
+RSpec::Core::RakeTask.new(:spec)
 
 task default: :spec
 task verify: :spec

data/lib/termvas/rbgl.rb

@@ -17,7 +17,7 @@ module Termvas
       @fit = fit.to_sym
       raise ArgumentError, "fit must be :contain or :none" unless %i[contain none].include?(@fit)
       @max_fps = max_fps.nil? ? nil : Float(max_fps)
-      raise ArgumentError, "max_fps must be positive" if @max_fps && !@max_fps.positive?
+      raise ArgumentError, "max_fps must be positive and finite" if @max_fps && (!@max_fps.positive? || !@max_fps.finite?)
       @terminal = Terminal.new(input: input, output: output, alt_screen: alt_screen, tmux: tmux)
       @output = output
       @input = input

data/lib/termvas/version.rb

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

data/lib/termvas.rb

@@ -179,6 +179,14 @@ module Termvas
       @buffer << bytes
       events = []
       loop do
+        if @buffer.start_with?("\e[")
+          sequence = @buffer.match(/\A\e\[[0-?]*[ -\/]*[@-~]/)
+          break unless sequence
+          unless sequence[0].match?(/\A\e\[<\d+;\d+;\d+[Mm]\z|\A\e\[[0-9;]*[A-Za-z~]\z/)
+            @buffer = @buffer.byteslice(sequence[0].bytesize..).to_s.b
+            next
+          end
+        end
         if @buffer.start_with?("\e[<")
           match = @buffer.match(/\A\e\[<([0-9]+);([0-9]+);([0-9]+)([Mm])/
           )
@@ -271,10 +279,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 +297,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 +380,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,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: termvas
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Yudai Takada
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-25 00:00:00.000000000 Z
+date: 2026-09-26 00:00:00.000000000 Z
 dependencies: []
 description: Half block, Kitty, iTerm2, and Sixel terminal output with input parsing.
 email:
@@ -18,6 +18,8 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".codespellignore"
+- ".yamllint"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md