rubyterm 0.2.1 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b689e43998c1e63f2cd607d3200aeb67d7cf49d6a1ce685ab532ea525132b41c
-  data.tar.gz: a6b2201c362d87c3114762e30cc55a2b90af4bd3d7ceec2fe4b14beaabc61d72
+  metadata.gz: 201ce77d71abc653a76c0fb9a51827e13910767e5f5946999853a13b8ab02006
+  data.tar.gz: 4b57378d7077055158b33aca41b4e365c4f63a60bb95547e2c5e64ffa91e1e75
 SHA512:
-  metadata.gz: 005e2010106589917df481c5ae217959114a8f80a7ce5787855dab5ef9ed69fa14b9c840781899e609e0d795f39f022fe60ff46448960dd0f2a713dc00c4a2f4
-  data.tar.gz: e6182b8a2b492e41777386c0a2cc8626d3e5195a89b14b6e46639cb5e5f7e1baa2abde4b1a135bba08004f78a5077075dcebf089b790cf9fcd27296ec011031a
+  metadata.gz: d60d6b223b2819739d0dff9e571b8007a2422c2f38fc5d784e733c3273242037d1833fdea48c15735e72b76ef3487e4c716ed8b1cc10b707cfaddac96e76c511
+  data.tar.gz: 3c5b38c7f9a928f2f1bfa99b798515bb42a0d455c04d956cac11ec8687bac35adcd92fa96c2c6e6c40c28587957ced61c25c747ab990a526a2961c9d01377824

data/README.md

@@ -18,6 +18,25 @@ all.
 > to contribute, **talk to me first** (vidar@hokstad.com) or fork — I won't
 > promise to merge changes we haven't discussed.
 
+## Getting started
+
+rubyterm is a **standalone X11 terminal emulator** — like `xterm` or any
+other terminal, but written entirely in Ruby. You run it inside a running X
+session and it opens a window with a shell in it.
+
+    gem install rubyterm
+
+Then, from within an X session (`$DISPLAY` must point at your X server):
+
+    rubyterm                  # your $SHELL in a new window
+    rubyterm bash -lc htop    # ...or run a specific command
+
+Launch it however you launch any other terminal — from your window manager's
+menu or a keybinding, from your X startup file, or from an existing terminal.
+
+**Tabs?** Not yet — rubyterm is one terminal per window. For multiple
+sessions, open several windows or run `tmux`/`screen` inside it.
+
 ## Screenshots of Ruby-in-Ruby-in-Ruby-...
 
 ![Rubyterm](docs/2026-06-15_18-40_1.png)
@@ -57,32 +76,31 @@ For the full picture and the rationale behind the layering, see:
 
 ## Installation
 
-Dependencies are managed with Bundler.
+**From RubyGems** — to use it:
 
 ```bash
-bundle install
+gem install rubyterm
+rubyterm                  # then run it inside an X session
 ```
 
-`skrift` and `skrift-x11` are developed alongside this project and are
-pulled from git. To build against a local checkout instead of the pushed
-branch, set a per-machine local override (kept out of the repo):
+**From source** — to hack on it:
 
 ```bash
-bundle config set --global local.skrift     /path/to/skrift
-bundle config set --global local.skrift-x11 /path/to/skrift-x11
+git clone https://github.com/vidarh/rubyterm && cd rubyterm
+bundle install
+bundle exec rubyterm
 ```
 
-## Running
+[skrift](https://github.com/vidarh/skrift) — the pure-Ruby TrueType/OpenType
+font renderer rubyterm draws its text with — and its companion plugins live in
+one monorepo and are pulled from git. To build against a local checkout, set
+one per-machine override at the monorepo root (kept out of the repo):
 
 ```bash
-bundle exec rubyterm                 # start a terminal running your $SHELL
-bundle exec rubyterm bash -lc htop   # ...or run a specific command
+bundle config set --global disable_local_branch_check true
+bundle config set --global local.skrift /path/to/skrift
 ```
 
-With some luck you'll get a terminal window. Once the gem (and its
-dependencies) are installed system-wide, the `rubyterm` executable can be
-run directly.
-
 ## Configuration
 
 Configuration is read from `~/.config/rterm/config.toml` (TOML). See

data/bin/record

@@ -0,0 +1,3 @@
+#!/bin/env ruby
+
+exec(%{ruby harness/cli.rb record --out /tmp/#{ARGV[0].gsub("/","_")}.rec -- #{ARGV.join(" ")}})

data/lib/charwidth.rb

@@ -20,9 +20,25 @@ module CharWidth
   WIDE_SPACER = 0
 
   # Wide (two-cell) blocks: CJK, Hangul, Kana, fullwidth forms, and emoji.
+  #
+  # In the BMP symbol zone (Misc Symbols, Dingbats, Misc Symbols & Arrows)
+  # only the East Asian Wide + emoji-presentation codepoints are double-width;
+  # the surrounding text dingbats are single-width. A broad 0x25FD..0x27BF (and
+  # peers) wrongly widened text characters like U+273B (the spinner ✻ used by
+  # TUIs), shifting the cursor one column on every line that contained one and
+  # corrupting incremental redraws. These ranges now match tmux exactly.
   WIDE = [
-    0x1100..0x115F, 0x231A..0x232A, 0x23E9..0x23F3, 0x25FD..0x27BF,
-    0x2B1B..0x2B55, 0x2E80..0xA4C6, 0xA960..0xA97C, 0xAC00..0xD7A3,
+    0x1100..0x115F,
+    0x231A..0x231B, 0x2329..0x232A, 0x23E9..0x23EC, 0x23F0..0x23F0,
+    0x23F3..0x23F3, 0x25FD..0x25FE, 0x2614..0x2615, 0x2648..0x2653,
+    0x267F..0x267F, 0x2693..0x2693, 0x26A1..0x26A1, 0x26AA..0x26AB,
+    0x26BD..0x26BE, 0x26C4..0x26C5, 0x26CE..0x26CE, 0x26D4..0x26D4,
+    0x26EA..0x26EA, 0x26F2..0x26F3, 0x26F5..0x26F5, 0x26FA..0x26FA,
+    0x26FD..0x26FD, 0x2705..0x2705, 0x270A..0x270B, 0x2728..0x2728,
+    0x274C..0x274C, 0x274E..0x274E, 0x2753..0x2755, 0x2757..0x2757,
+    0x2795..0x2797, 0x27B0..0x27B0, 0x27BF..0x27BF, 0x2B1B..0x2B1C,
+    0x2B50..0x2B50, 0x2B55..0x2B55,
+    0x2E80..0xA4C6, 0xA960..0xA97C, 0xAC00..0xD7A3,
     0xF900..0xFAD9, 0xFE10..0xFE6B, 0xFF01..0xFF60, 0xFFE0..0xFFE6,
     0x16FE0..0x18D08, 0x1B000..0x1B2FB, 0x1F18E..0x1F19A, 0x1F200..0x1F265,
     0x1F300..0x1F5A4, 0x1F5FB..0x1F6FC, 0x1F7E0..0x1F7EB, 0x1F90C..0x1F9FF,

data/lib/rubyterm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class RubyTerm
-  VERSION = "0.2.1"
+  VERSION = "0.2.4"
 end

data/lib/term.rb

@@ -115,6 +115,15 @@ class Term
     @buffer.clear   # the buffer (TrackChanges) also clears the backend
   end
 
+  # Cursor + charset save/restore, shared by DECSC/DECRC (ESC 7 / ESC 8) and
+  # DEC private modes 1048/1049. DECRC with no prior save defaults to the home
+  # position and default charsets rather than leaving @x/@y nil (which would
+  # crash draw_cursor).
+  def save_cursor    = @saved = [@x, @y, @gl, @gr, @g.dup]
+  def restore_cursor
+    @x, @y, @gl, @gr, @g = @saved || [0, 0, 0, nil, [DefaultCharset, nil, nil, nil]]
+  end
+
   # RIS - Reset to Initial State (ESC c). Full reset: restore margins,
   # modes, charsets, tab stops and attributes to their defaults, home the
   # cursor and clear the screen.
@@ -408,6 +417,16 @@ class Term
           # FIXME: Save/restore
           # FIXME: Scrollback should be disabled/enabled.
           clear_screen
+        when 1048
+          # Save (h) / restore (l) cursor, as DECSC / DECRC.
+          set ? save_cursor : restore_cursor
+        when 1049
+          # Alternate screen + cursor save/restore. Like mode 47 this
+          # terminal has no separate alt buffer yet, so it just clears; the
+          # cursor save (on enter) / restore (on leave) is what apps rely on
+          # to land the cursor back where it was before the alt screen.
+          set ? save_cursor : restore_cursor
+          clear_screen
 
         # Extended mouse modes
         # See https://terminalguide.namepad.de/mouse/
@@ -596,12 +615,8 @@ class Term
     when ")B"; @g[1] = DefaultCharset
     when "(0"; @g[0] = GraphicsCharset
     when ")0"; @g[1] = GraphicsCharset
-    when "7";  @saved = [@x,@y,@gl,@gr,@g.dup]
-    when "8"
-      # DECRC with no prior DECSC: default to home position and default
-      # charsets rather than leaving @x/@y nil (which crashes draw_cursor).
-      sx, sy, sgl, sgr, sg = @saved || [0, 0, 0, nil, [DefaultCharset, nil, nil, nil]]
-      @x, @y, @gl, @gr, @g = sx, sy, sgl, sgr, sg
+    when "7";  save_cursor    # DECSC
+    when "8";  restore_cursor # DECRC
     else
       unhandled(:escape, s)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubyterm
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.4
 platform: ruby
 authors:
 - Vidar Hokstad
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-22 00:00:00.000000000 Z
+date: 2026-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pure-x11
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.0.15
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.0.15
 - !ruby/object:Gem::Dependency
   name: skrift
   requirement: !ruby/object:Gem::Requirement
@@ -95,6 +95,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - README.md
+- bin/record
 - bin/rubyterm
 - example-config.toml
 - lib/ansibackend.rb