muxr 0.1.0

data/lib/muxr/version.rb

@@ -0,0 +1,3 @@
+module Muxr
+  VERSION = "0.1.0"
+end

data/lib/muxr/window.rb

@@ -0,0 +1,110 @@
+module Muxr
+  # A Window is a single logical "screen" containing an ordered list of panes,
+  # a focused-index, a master-index (which pane is the master for tall/grid
+  # layouts), and the currently-selected layout.
+  class Window
+    LAYOUTS = LayoutManager::LAYOUTS
+
+    attr_accessor :name, :layout, :master_index
+    attr_reader :panes, :focused_index
+
+    def initialize(name: "main")
+      @name = name
+      @panes = []
+      @focused_index = 0
+      @last_focused_pane = nil
+      @master_index = 0
+      @layout = :tall
+    end
+
+    # Setter records the outgoing focused pane (by reference) so focus_last can
+    # return to it even after the panes array is reordered (e.g. by
+    # promote_to_master).
+    def focused_index=(value)
+      return if value == @focused_index
+      @last_focused_pane = focused_pane
+      @focused_index = value
+    end
+
+    def add_pane(pane)
+      @panes << pane
+      pane
+    end
+
+    def remove_pane(pane)
+      idx = @panes.index(pane)
+      return false unless idx
+      pane.close
+      @panes.delete_at(idx)
+      @last_focused_pane = nil if @last_focused_pane == pane
+      clamp_indices!
+      true
+    end
+
+    def focused_pane
+      return nil if @panes.empty?
+      @panes[@focused_index]
+    end
+
+    def focus_next
+      return if @panes.empty?
+      self.focused_index = (@focused_index + 1) % @panes.length
+    end
+
+    def focus_prev
+      return if @panes.empty?
+      self.focused_index = (@focused_index - 1) % @panes.length
+    end
+
+    def focus_last
+      return unless @last_focused_pane
+      idx = @panes.index(@last_focused_pane)
+      return unless idx
+      self.focused_index = idx
+    end
+
+    def focus_index(idx)
+      return if @panes.empty?
+      return unless idx.is_a?(Integer) && idx >= 0 && idx < @panes.length
+      self.focused_index = idx
+    end
+
+    def promote_to_master
+      return if @panes.empty?
+      return if @master_index == @focused_index
+      # Move the focused pane into the master slot and shift the others down,
+      # preserving relative order so tall/grid layouts stay stable.
+      pane = @panes.delete_at(@focused_index)
+      @panes.unshift(pane)
+      @master_index = 0
+      @focused_index = 0
+    end
+
+    def swap_panes(i, j)
+      return if i == j
+      return unless @panes[i] && @panes[j]
+      @panes[i], @panes[j] = @panes[j], @panes[i]
+    end
+
+    def cycle_layout
+      i = LAYOUTS.index(@layout) || 0
+      @layout = LAYOUTS[(i + 1) % LAYOUTS.length]
+    end
+
+    def set_layout(layout)
+      layout = layout.to_sym
+      raise ArgumentError, "Unknown layout: #{layout}" unless LAYOUTS.include?(layout)
+      @layout = layout
+    end
+
+    def clamp_indices!
+      if @panes.empty?
+        @focused_index = 0
+        @master_index = 0
+      else
+        @focused_index = @focused_index.clamp(0, @panes.length - 1)
+        @master_index  = @master_index.clamp(0, @panes.length - 1)
+      end
+    end
+  end
+end

data/lib/muxr.rb

@@ -0,0 +1,18 @@
+require_relative "muxr/version"
+require_relative "muxr/pty_process"
+require_relative "muxr/terminal"
+require_relative "muxr/pane"
+require_relative "muxr/drawer"
+require_relative "muxr/layout_manager"
+require_relative "muxr/window"
+require_relative "muxr/session"
+require_relative "muxr/renderer"
+require_relative "muxr/input_handler"
+require_relative "muxr/command_dispatcher"
+require_relative "muxr/protocol"
+require_relative "muxr/application"
+require_relative "muxr/client"
+
+module Muxr
+  class Error < StandardError; end
+end

data/muxr.gemspec

@@ -0,0 +1,42 @@
+require_relative "lib/muxr/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "muxr"
+  spec.version       = Muxr::VERSION
+  spec.authors       = ["Roel Bondoc"]
+  spec.email         = ["rsbondoc@gmail.com"]
+
+  spec.summary       = "A keyboard-driven terminal multiplexer with tiling layouts and a Quake-style drawer"
+  spec.description   = <<~DESC
+    muxr is a Ruby terminal multiplexer that combines GNU Screen's familiar
+    keybindings, xmonad-inspired automatic tiling, and a Quake-style drop-down
+    drawer overlay. Panes are treated as tiling clients: layouts are pure
+    functions of pane count and screen dimensions, not user-resized regions.
+  DESC
+  spec.homepage      = "https://github.com/roelbondoc/muxr"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.4"
+
+  spec.metadata = {
+    "source_code_uri"       => "https://github.com/roelbondoc/muxr",
+    "bug_tracker_uri"       => "https://github.com/roelbondoc/muxr/issues",
+    "changelog_uri"         => "https://github.com/roelbondoc/muxr/blob/main/CHANGELOG.md",
+    "rubygems_mfa_required" => "true",
+    "allowed_push_host"     => "https://rubygems.org"
+  }
+
+  spec.bindir        = "bin"
+  spec.executables   = ["muxr"]
+  spec.files         = Dir[
+    "lib/**/*.rb",
+    "bin/muxr",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE.txt",
+    "muxr.gemspec"
+  ]
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: muxr
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Roel Bondoc
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: |
+  muxr is a Ruby terminal multiplexer that combines GNU Screen's familiar
+  keybindings, xmonad-inspired automatic tiling, and a Quake-style drop-down
+  drawer overlay. Panes are treated as tiling clients: layouts are pure
+  functions of pane count and screen dimensions, not user-resized regions.
+email:
+- rsbondoc@gmail.com
+executables:
+- muxr
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- bin/muxr
+- lib/muxr.rb
+- lib/muxr/application.rb
+- lib/muxr/client.rb
+- lib/muxr/command_dispatcher.rb
+- lib/muxr/drawer.rb
+- lib/muxr/input_handler.rb
+- lib/muxr/layout_manager.rb
+- lib/muxr/pane.rb
+- lib/muxr/protocol.rb
+- lib/muxr/pty_process.rb
+- lib/muxr/renderer.rb
+- lib/muxr/session.rb
+- lib/muxr/terminal.rb
+- lib/muxr/version.rb
+- lib/muxr/window.rb
+- muxr.gemspec
+homepage: https://github.com/roelbondoc/muxr
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/roelbondoc/muxr
+  bug_tracker_uri: https://github.com/roelbondoc/muxr/issues
+  changelog_uri: https://github.com/roelbondoc/muxr/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+  allowed_push_host: https://rubygems.org
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: A keyboard-driven terminal multiplexer with tiling layouts and a Quake-style
+  drawer
+test_files: []