termfront 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2169347d66dd50b7734b9de8afc2398a0b979649cd98cb36aa6cc6dcdc9373f5
-  data.tar.gz: afd578bf2aabf93476c81d96fdcceeb5d55289d6137dade78429b75bdd84753a
+  metadata.gz: d84ea40d760b9d62c0037b83a0b83576725a12a16c3aa2937e16025e6a798015
+  data.tar.gz: e33b7fc4bde17b2924ea6a1f30bb11f6f8d30fbba75bd9f9130c773b1b1cf33a
 SHA512:
-  metadata.gz: 4bf5e4ee9f0c736626f7c73f05ce04a5a2c128f1c94193d9f74ae6c7788297561f24244d7ae65d03f5b6955ba10d772bfe9ba3a017de4d2bac18b8a527020a8b
-  data.tar.gz: d317a9c0ac3ba86c633c3fb1f8b5af951bda951bcc2418213457535ec32d3e0d2471fca9c3e34588f5f134800c46a495a68cbfa58f86f9349739e1dc206ffe7d
+  metadata.gz: fc5856f2bb1eea72307f2ba41af96e5b3412e7ef893fe8a3609f0841ab88d693653ed797c072eff8a4092d01511c810edd2fc848c12dcd17a07b8803181cc551
+  data.tar.gz: 461847cef45b100959a044dcb22cca9c537a806331168834d9f936fd6055c4c668581f376058003ad2eb28abdd805cc3f2d82d6f52a36644b7f7d53a13635f9f

data/CHANGELOG.md

@@ -6,6 +6,49 @@ The format is based on Keep a Changelog, and this project follows Semantic Versi
 
 ## [Unreleased]
 
+## [0.1.6] - 2026-05-26
+
+### Changed
+
+- Memoize the HUD shield and ammo lines so `fit_ansi` only re-runs when the shown shield value, weapon, ammo, pickup hint, or terminal width actually change
+- Inline the color-mode branching and SGR lookups into `Renderer#render_view` to remove per-cell `bg_only?`, `ansi_fg`, and `ansi_bg` method calls (about 72,000 calls per second at 30 Hz on an 80-wide terminal)
+- Enable YJIT on startup so the hot Ruby methods in the renderer (`build_view_pixels`, `render_view`, `cast_ray`, etc.) get JIT-compiled instead of interpreted
+- Rewrite `TerminalOutput.fit_ansi` to walk the input by byte index with `getbyte` and `byteslice` instead of scanning with a regular expression, removing the per-line `Regexp#match` / `MatchData` allocations that dominated the renderer's CPU profile under YJIT
+- Render the title screen at 30 Hz while still advancing its spin animation and polling input at 60 Hz, so the per-frame renderer cost halves without making the demo motion feel choppy
+- Cache the demo mission instance, its tile-map, and its enemy definitions inside `TitleScreen#initialize` instead of rebuilding them every frame
+- Render singleplayer and Wavesfight at 30 Hz while still running the update step, physics, and input polling at 60 Hz, halving the in-game renderer cost without slowing the simulation or input response
+- Rewrite `Renderer#build_view_pixels` with column-major `while` loops that read `wtop`/`wbot`/`wcol` once per column and fill the ceiling / wall / floor segments without per-cell branching, hoisting `Config::CEIL_C` / `Config::FLOOR_C` and `@pixels` as locals so YJIT keeps the hot loop tight
+- Memoize the title screen's static lines (logo, subtitle, and the five menu entries) per terminal width so `fit_ansi` runs once instead of seven times per title-screen frame
+- Memoize every line of `Game#render_mission_select` keyed by terminal width, current selection, difficulty, and mission class, so the nine `fit_ansi` calls per frame collapse to cache lookups while the cursor is idle
+- Reuse the radar's enemy / drop / terminal / ally cell hashes between frames and key them by integer (`sy * diam + sx`) to drop per-cell `Array` allocations, hoisting `Config::RADAR_RANGE`, `RADAR_RANGE_SQ`, `r*r`, and the player position as locals so YJIT keeps the radar projection loops tight
+- Tighten the enemy half of `Renderer#overlay_enemies_3d`: hoist the FOV tangent, player position, and half-frame constants as locals, replace the `upto` loops with `while`, use integer shift instead of `to_f` / `.ceil` / `.floor` for half-block row indexing, and cache the float versions of `actual_h` / `actual_w` so the per-cell sprite division loop stops allocating new floats every iteration
+- Apply the same `while`-loop and integer-math pattern to the drop and projectile branches of `Renderer#overlay_enemies_3d`, reusing the hoisted player position and half-frame constants and computing the projectile color directly instead of through an intermediate ANSI code string
+
+## [0.1.5] - 2026-05-25
+
+### Changed
+
+- Radar distance culling now compares squared distances against `Config::RADAR_RANGE_SQ` instead of taking a square root per entity per frame
+- Renderer reuses the per-column raycast buffers and the virtual pixel grid across frames instead of allocating fresh arrays each tick, only re-allocating when the terminal is resized
+- Build the radar background grid, horizontal rule, and ANSI-styled radar glyphs once and reuse them across frames
+- Look up 256-color SGR escape sequences from a precomputed table and memoize truecolor SGR sequences to avoid rebuilding the same ANSI strings every cell
+- Reuse renderer sprite collection arrays and the radar line buffer across frames, and sort sprites with a comparator block instead of `sort_by`
+- Cache the terminal `winsize` inside the renderer and invalidate the cache from a `SIGWINCH` handler instead of issuing an ioctl every frame
+- PvP hit raycast now culls candidates beyond `MAX_PVP_RANGE` and skips the line-of-sight check when the candidate is already farther than the current best
+- Multiplayer server `broadcast` now serializes each outgoing message once and writes the same JSON line to every recipient
+- PvP server now aggregates outgoing player state on a 30 Hz server tick instead of relaying each incoming state message immediately, reducing TLS write bursts on small VMs
+- PvP match loop `IO.select` timeout shortened from 500 ms to ~16 ms so the new 30 Hz broadcast tick is not delayed by idle reads
+- PvP client opponent interpolation now converges within ~40 ms (lerp factor raised from 15 to 25) so remote players track the new 30 Hz broadcast tick within a single frame
+- Run the title demo, campaign missions, Wavesfight, and PvP at 60 FPS
+
+### Removed
+
+- Stopped emitting DEC 2026 synchronized update escape sequences around each frame and removed the `TERMFRONT_SYNC_UPDATES` environment switch; non-supporting terminals (some SSH paths, older xterm) were paying parsing cost for shapes they ignore, while supporting terminals show no visible regression
+
+### Fixed
+
+- Wavesfight wave advance now fully restores each surviving and revived player's shield to `Config::SHIELD_MAX`; previously only a +35 partial recovery was applied, which left revived players at 35%
+
 ## [0.1.34] - 2026-05-25
 
 ### Fixed

data/exe/termfront

@@ -1,6 +1,8 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
+RubyVM::YJIT.enable if defined?(RubyVM::YJIT)
+
 require "termfront"
 
 Termfront.start

data/lib/termfront/config.rb

@@ -2,7 +2,8 @@
 
 module Termfront
   module Config
-    FRAME_DT      = 1.0 / 30.0
+    FRAME_DT      = 1.0 / 60.0
+    RENDER_DT     = 1.0 / 30.0
     FOV           = 66.0 * Math::PI / 180.0
     PLAYER_RADIUS = 0.2
     KEY_TIMEOUT   = 5
@@ -29,6 +30,7 @@ module Termfront
 
     RADAR_RADIUS = 3
     RADAR_RANGE  = 12.0
+    RADAR_RANGE_SQ = RADAR_RANGE * RADAR_RANGE
 
     PVP_PORT    = 7777
     PVP_DEFAULT_ADDRESS = "termfront.gamelinks007.net:443"

data/lib/termfront/game.rb

@@ -10,6 +10,7 @@ module Termfront
       @scene_player = ScenePlayer.new(@stdout, audio: @audio)
       @demo_player = DemoPlayer.new(@stdout, @renderer)
       @difficulty = nil
+      Signal.trap("WINCH") { @renderer.invalidate_size_cache! }
     end
 
     def start
@@ -130,6 +131,7 @@ module Termfront
     def run_game_loop(show_complete_banner: true)
       STDIN.raw do |stdin|
         last_time = clock
+        last_render = last_time - Config::RENDER_DT
 
         loop do
           now = clock
@@ -145,11 +147,14 @@ module Termfront
           end
 
           update(dt)
-          @renderer.render(
-            player: @player, map: @map,
-            enemies: @enemies, projectiles: @projectiles,
-            drops: @player.drops, terminals: @terminals
-          )
+          if now - last_render >= Config::RENDER_DT
+            @renderer.render(
+              player: @player, map: @map,
+              enemies: @enemies, projectiles: @projectiles,
+              drops: @player.drops, terminals: @terminals
+            )
+            last_render = now
+          end
 
           if @player.dead
             rows, cols = @stdout.winsize
@@ -175,6 +180,7 @@ module Termfront
     def run_wavesfight_loop
       STDIN.raw do |stdin|
         last_time = clock
+        last_render = last_time - Config::RENDER_DT
 
         loop do
           now = clock
@@ -190,12 +196,15 @@ module Termfront
           end
 
           update(dt)
-          @renderer.render(
-            player: @player, map: @map,
-            enemies: @enemies, projectiles: @projectiles,
-            drops: @player.drops, terminals: @terminals,
-            status_line: "  WAVE #{@wave}  #{Enemy::Base::DIFFICULTIES[@difficulty][:name]}"
-          )
+          if now - last_render >= Config::RENDER_DT
+            @renderer.render(
+              player: @player, map: @map,
+              enemies: @enemies, projectiles: @projectiles,
+              drops: @player.drops, terminals: @terminals,
+              status_line: "  WAVE #{@wave}  #{Enemy::Base::DIFFICULTIES[@difficulty][:name]}"
+            )
+            last_render = now
+          end
 
           if @player.dead
             rows, cols = @stdout.winsize
@@ -208,6 +217,7 @@ module Termfront
             show_wave_clear
             start_wavesfight_wave
             last_time = clock
+            last_render = clock - Config::RENDER_DT
           end
 
           cap_frame(now)
@@ -413,7 +423,7 @@ module Termfront
     end
 
     def replenish_wavesfight_loadout
-      @player.shield = [@player.shield + 35.0, Config::SHIELD_MAX].min
+      @player.shield = Config::SHIELD_MAX
       @player.health = [@player.health + 20.0, Config::HEALTH_MAX].min
       @player.last_damage = -Config::SHIELD_DELAY
       @player.dead = false
@@ -542,62 +552,78 @@ module Termfront
       end
     end
 
+    MISSION_SELECT_DIFF_COLORS = ["\e[92m", "\e[93m", "\e[38;2;255;165;0m", "\e[91m"].freeze
+    MISSION_SELECT_CTRL = "Up/Down: Select   Left/Right: Difficulty   Enter/1-5: Start   Q: Back"
+
     def render_mission_select(selected, missions, title)
       rows, cols = @stdout.winsize
       buf = TerminalOutput.begin_frame(home: true)
       lines = Array.new(rows) { " " * cols }
+      cache = (@mission_select_cache ||= {})
 
-      tc = [(cols - title.size) / 2 + 1, 1].max
-      lines[1] = TerminalOutput.fit_ansi("#{" " * (tc - 1)}\e[1;38;2;120;140;255m#{title}\e[0m", cols)
+      lines[1] = cache[[:title, cols, title]] ||= begin
+        tc = [(cols - title.size) / 2 + 1, 1].max
+        TerminalOutput.fit_ansi("#{" " * (tc - 1)}\e[1;38;2;120;140;255m#{title}\e[0m", cols)
+      end
 
       diff = Enemy::Base::DIFFICULTIES[@difficulty]
-      diff_colors = ["\e[92m", "\e[93m", "\e[38;2;255;165;0m", "\e[91m"]
-      diff_label = "< #{diff[:name]} >"
-      dc = [(cols - diff_label.size) / 2 + 1, 1].max
-      lines[2] = TerminalOutput.fit_ansi("#{" " * (dc - 1)}#{diff_colors[@difficulty]}#{diff_label}\e[0m", cols)
+      lines[2] = cache[[:diff, cols, @difficulty]] ||= begin
+        diff_label = "< #{diff[:name]} >"
+        dc = [(cols - diff_label.size) / 2 + 1, 1].max
+        TerminalOutput.fit_ansi("#{" " * (dc - 1)}#{MISSION_SELECT_DIFF_COLORS[@difficulty]}#{diff_label}\e[0m", cols)
+      end
 
       missions.each_with_index do |klass, i|
-        m = klass.new
         row = 5 + i * 2
-        label = "  #{i + 1}. #{m.name}"
-        lc = [(cols - 40) / 2 + 1, 1].max
-        text = if i == selected
-                 "\e[1;97;44m> #{label.strip.ljust(38)}\e[0m"
-               else
-                 "\e[97m  #{label.strip.ljust(38)}\e[0m"
-               end
-        lines[row - 1] = TerminalOutput.fit_ansi("#{" " * (lc - 1)}#{text}", cols)
+        is_selected = i == selected
+        lines[row - 1] = cache[[:mission, cols, i, is_selected, klass]] ||= begin
+          m = klass.new
+          label = "  #{i + 1}. #{m.name}"
+          lc = [(cols - 40) / 2 + 1, 1].max
+          text = if is_selected
+                   "\e[1;97;44m> #{label.strip.ljust(38)}\e[0m"
+                 else
+                   "\e[97m  #{label.strip.ljust(38)}\e[0m"
+                 end
+          TerminalOutput.fit_ansi("#{" " * (lc - 1)}#{text}", cols)
+        end
       end
 
       brief_row = 5 + missions.size * 2 + 1
-      m = missions[selected].new
-      briefing = m.briefing
-      bc = [(cols - briefing.size) / 2 + 1, 1].max
-      lines[brief_row - 1] = TerminalOutput.fit_ansi("#{" " * (bc - 1)}\e[38;2;180;180;200m#{briefing}\e[0m", cols)
+      lines[brief_row - 1] = cache[[:brief, cols, missions[selected]]] ||= begin
+        m = missions[selected].new
+        briefing = m.briefing
+        bc = [(cols - briefing.size) / 2 + 1, 1].max
+        TerminalOutput.fit_ansi("#{" " * (bc - 1)}\e[38;2;180;180;200m#{briefing}\e[0m", cols)
+      end
 
       info_row = brief_row + 2
-      edefs = m.enemy_defs
-      base_crawler = edefs.count { |e| e[4] == :crawler }
-      base_executor = edefs.count { |e| e[4] == :executor }
-      extra = diff[:extra_enemies]
-      extra_crawler = 0
-      extra_executor = 0
-      extra.times do |i|
-        src_type = edefs[i % edefs.size][4]
-        src_type == :crawler ? (extra_crawler += 1) : (extra_executor += 1)
+      lines[info_row - 1] = cache[[:info, cols, @difficulty, missions[selected]]] ||= begin
+        m = missions[selected].new
+        edefs = m.enemy_defs
+        base_crawler = edefs.count { |e| e[4] == :crawler }
+        base_executor = edefs.count { |e| e[4] == :executor }
+        extra = diff[:extra_enemies]
+        extra_crawler = 0
+        extra_executor = 0
+        extra.times do |i|
+          src_type = edefs[i % edefs.size][4]
+          src_type == :crawler ? (extra_crawler += 1) : (extra_executor += 1)
+        end
+        crawler_c = base_crawler + extra_crawler
+        executor_c = base_executor + extra_executor
+        info = "Enemies: #{crawler_c} Crawler#{crawler_c != 1 ? "s" : ""}"
+        info += ", #{executor_c} Executor#{executor_c != 1 ? "s" : ""}" if executor_c > 0
+        info += "  |  HP x#{diff[:hp_mult]}"
+        ic = [(cols - info.size) / 2 + 1, 1].max
+        TerminalOutput.fit_ansi("#{" " * (ic - 1)}\e[38;2;140;140;160m#{info}\e[0m", cols)
       end
-      crawler_c = base_crawler + extra_crawler
-      executor_c = base_executor + extra_executor
-      info = "Enemies: #{crawler_c} Crawler#{crawler_c != 1 ? "s" : ""}"
-      info += ", #{executor_c} Executor#{executor_c != 1 ? "s" : ""}" if executor_c > 0
-      info += "  |  HP x#{diff[:hp_mult]}"
-      ic = [(cols - info.size) / 2 + 1, 1].max
-      lines[info_row - 1] = TerminalOutput.fit_ansi("#{" " * (ic - 1)}\e[38;2;140;140;160m#{info}\e[0m", cols)
 
       ctrl_row = info_row + 2
-      ctrl = "Up/Down: Select   Left/Right: Difficulty   Enter/1-5: Start   Q: Back"
-      cc = [(cols - ctrl.size) / 2 + 1, 1].max
-      lines[ctrl_row - 1] = TerminalOutput.fit_ansi("#{" " * (cc - 1)}\e[38;2;100;100;120m#{ctrl}\e[0m", cols)
+      lines[ctrl_row - 1] = cache[[:ctrl, cols]] ||= begin
+        cc = [(cols - MISSION_SELECT_CTRL.size) / 2 + 1, 1].max
+        TerminalOutput.fit_ansi("#{" " * (cc - 1)}\e[38;2;100;100;120m#{MISSION_SELECT_CTRL}\e[0m", cols)
+      end
 
       lines.each_with_index do |line, index|
         buf << line

data/lib/termfront/network/client.rb

@@ -392,7 +392,7 @@ module Termfront
 
       def interpolate_opponents(dt)
         @remotes.each_value do |remote|
-          remote[:lerp_t] = [remote[:lerp_t] + dt * 15.0, 1.0].min
+          remote[:lerp_t] = [remote[:lerp_t] + dt * 25.0, 1.0].min
           t = remote[:lerp_t]
           remote[:render].x = remote[:prev].x + (remote[:current].x - remote[:prev].x) * t
           remote[:render].y = remote[:prev].y + (remote[:current].y - remote[:prev].y) * t

data/lib/termfront/network/server.rb

@@ -28,6 +28,10 @@ module Termfront
       }.freeze
       DEFAULT_RATE_LIMIT = 10
       MAX_DROPPED_MSGS = 200
+      MAX_PVP_RANGE = 30.0
+      STATE_BROADCAST_HZ = 30
+      STATE_BROADCAST_DT = 1.0 / STATE_BROADCAST_HZ
+      SELECT_TIMEOUT = 1.0 / 60.0
       PVP_MAP = [
         "####################",
         "#........##........#",
@@ -271,6 +275,7 @@ module Termfront
         match_start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
         last_activity = match_start
         last_tick_at = match_start
+        last_state_flush_at = match_start
 
         loop do
           sockets = roster.filter_map do |player|
@@ -281,7 +286,7 @@ module Termfront
           end
           break if sockets.empty?
 
-          readable, = IO.select(sockets, nil, nil, 0.5)
+          readable, = IO.select(sockets, nil, nil, SELECT_TIMEOUT)
 
           now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
           if (reason = match_timeout_reason(now, match_start, last_activity))
@@ -295,6 +300,11 @@ module Termfront
           roster.each { |player| regen_player(player, dt, now) }
           last_tick_at = now
 
+          if now - last_state_flush_at >= STATE_BROADCAST_DT
+            flush_pending_states(roster)
+            last_state_flush_at = now
+          end
+
           next unless readable
 
           last_activity = now
@@ -388,7 +398,7 @@ module Termfront
               msg = msg.merge(ff: ff || 0)
             end
             msg = msg.merge(s: player[:shield].round(1), h: player[:health].round(1))
-            broadcast(roster, msg.merge(from: player[:id]), except: player[:id])
+            player[:pending_state] = msg.merge(from: player[:id])
           when "hit"
             route_hit(roster, player, msg, Process.clock_gettime(Process::CLOCK_MONOTONIC))
           when "dead"
@@ -430,11 +440,12 @@ module Termfront
           oy = other[:y] - attacker[:y]
           dot = ox * dx + oy * dy
           next if dot < 0.1
+          next if dot > MAX_PVP_RANGE
+          next unless dot < best_dot
 
           perp = (ox * (-dy) + oy * dx).abs
           next if perp > weapon.hit_width
           next unless pvp_map.line_of_sight?(attacker[:x], attacker[:y], other[:x], other[:y])
-          next unless dot < best_dot
 
           best = other
           best_dot = dot
@@ -450,15 +461,30 @@ module Termfront
       end
 
       def broadcast(roster, msg, except: nil)
+        line = JSON.generate(msg) + "\n"
         roster.each do |player|
           next if player[:id] == except
 
-          send_json(player[:socket], msg)
+          write_line(player[:socket], line)
+        end
+      end
+
+      def flush_pending_states(roster)
+        roster.each do |player|
+          state = player[:pending_state]
+          next unless state
+
+          broadcast(roster, state, except: player[:id])
+          player[:pending_state] = nil
         end
       end
 
       def send_json(socket, msg)
-        socket.write(JSON.generate(msg) + "\n")
+        write_line(socket, JSON.generate(msg) + "\n")
+      end
+
+      def write_line(socket, line)
+        socket.write(line)
       rescue Errno::EPIPE, Errno::ECONNRESET, IOError, OpenSSL::SSL::SSLError
         nil
       end
@@ -919,7 +945,7 @@ module Termfront
 
       def replenish_wavesfight_roster(roster, session)
         roster.each do |player|
-          player[:shield] = [player[:shield] + 35.0, Config::SHIELD_MAX].min
+          player[:shield] = Config::SHIELD_MAX
           player[:health] = [player[:health] + 20.0, Config::HEALTH_MAX].min
           player[:last_damage] = session[:clock] - Config::SHIELD_DELAY
           player[:alive] = true