Struct WindowState 

pub struct WindowState { /* private fields */ }

Per-window state that manages a single terminal window with multiple tabs

Implementations

impl WindowState

pub fn new_tab_or_show_profiles(&mut self)

Create a new tab, or show profile picker if configured and profiles exist

pub fn new_tab(&mut self)

Create a new tab

pub fn close_current_tab(&mut self) -> bool

Close the current tab Returns true if the window should close (last tab was closed)

pub fn close_current_tab_immediately(&mut self) -> bool

Close the current tab immediately without confirmation Returns true if the window should close (last tab was closed)

pub fn reopen_closed_tab(&mut self)

Reopen the most recently closed tab at its original position

pub fn next_tab(&mut self)

Switch to next tab

pub fn prev_tab(&mut self)

Switch to previous tab

pub fn switch_to_tab_index(&mut self, index: usize)

Switch to tab by index (1-based)

pub fn move_tab_left(&mut self)

Move current tab left

pub fn move_tab_right(&mut self)

Move current tab right

pub fn duplicate_tab(&mut self)

Duplicate current tab

pub fn duplicate_tab_by_id(&mut self, source_tab_id: TabId)

Duplicate a specific tab by ID

pub fn has_multiple_tabs(&self) -> bool

Check if there are multiple tabs

pub fn active_terminal(&self) -> Option<&Arc<Mutex<TerminalManager>>>

Get the active tab’s terminal

pub fn split_pane_horizontal(&mut self)

Split the current pane horizontally (panes stacked top/bottom)

pub fn split_pane_vertical(&mut self)

Split the current pane vertically (panes side by side)

pub fn close_focused_pane(&mut self) -> bool

Close the focused pane in the current tab

If this is the last pane, the tab is closed. Returns true if the window should close (last tab was closed).

pub fn has_multiple_panes(&self) -> bool

Check if the current tab has multiple panes

pub fn navigate_pane(&mut self, direction: NavigationDirection)

Navigate to an adjacent pane in the given direction

pub fn resize_pane(&mut self, direction: NavigationDirection)

Resize the focused pane in the given direction

Growing left/up decreases the pane’s ratio, growing right/down increases it

pub fn open_profile(&mut self, profile_id: ProfileId)

Open a new tab from a profile

pub fn toggle_profile_drawer(&mut self)

Toggle the profile drawer visibility

pub fn save_profiles(&self)

Save profiles to disk

pub fn apply_profile_changes(&mut self, profiles: Vec<Profile>)

Update profile manager from modal working copy

pub fn check_auto_profile_switch(&mut self) -> bool

Check for automatic profile switching based on hostname, SSH command, and directory detection

This checks the active tab for hostname and CWD changes (detected via OSC 7), SSH command detection, and applies matching profiles automatically. Priority: explicit user selection > hostname match > SSH command match > directory match > default

Returns true if a profile was auto-applied, triggering a redraw.

impl WindowState

pub fn notify_tmux_of_resize(&self)

Notify tmux of a window/pane resize

Called when the window is resized to keep tmux in sync with par-term’s size. This sends refresh-client -C cols,rows to tmux in gateway mode.

pub fn initiate_tmux_gateway( &mut self, session_name: Option<&str>, ) -> Result<()>

Initiate a new tmux session via gateway mode.

This writes tmux -CC new-session to the active tab’s PTY and enables tmux control mode parsing. The session will be fully connected once we receive the %session-changed notification.

Arguments

• session_name - Optional session name. If None, tmux will auto-generate one.

pub fn attach_tmux_gateway(&mut self, session_name: &str) -> Result<()>

Attach to an existing tmux session via gateway mode.

This writes tmux -CC attach -t session to the active tab’s PTY.

pub fn disconnect_tmux_session(&mut self)

Disconnect from the current tmux session

pub fn is_tmux_connected(&self) -> bool

Check if tmux session is active

pub fn is_gateway_active(&self) -> bool

Check if gateway mode is active (connected or connecting)

pub fn set_tmux_focused_pane_from_native(&mut self, native_pane_id: PaneId)

Update the tmux focused pane when a native pane is focused

This should be called when the user clicks on a pane to ensure input is routed to the correct tmux pane.

pub fn send_input_via_tmux(&self, data: &[u8]) -> bool

Send input through tmux gateway mode.

When in gateway mode, keyboard input is sent via send-keys command written to the gateway tab’s PTY. This routes input to the appropriate tmux pane.

Returns true if input was handled via tmux, false if it should go to PTY directly.

pub fn paste_via_tmux(&self, text: &str) -> bool

Send paste text through tmux gateway mode.

Uses send-keys -l for literal text to handle special characters properly.

pub fn split_pane_via_tmux(&self, vertical: bool) -> bool

Split the current pane via tmux control mode.

Writes split-window command to the gateway PTY.

Arguments

• vertical - true for vertical split (side by side), false for horizontal (stacked)

Returns true if the command was sent successfully.

pub fn close_pane_via_tmux(&self) -> bool

Close the focused pane via tmux control mode.

Writes kill-pane command to the gateway PTY.

Returns true if the command was sent successfully.

pub fn sync_clipboard_to_tmux(&self, content: &str) -> bool

Sync clipboard content to tmux paste buffer.

Writes set-buffer command to the gateway PTY.

Returns true if the command was sent successfully.

pub fn sync_pane_resize_to_tmux(&self, is_horizontal_divider: bool)

Sync pane resize to tmux after a divider drag.

When the user resizes panes by dragging a divider in par-term, this sends the new pane sizes to tmux so external clients see the same layout.

Arguments

• is_horizontal_divider - true if dragging a horizontal divider (changes heights), false if dragging a vertical divider (changes widths)

pub fn handle_tmux_prefix_key(&mut self, event: &KeyEvent) -> bool

Handle tmux prefix key mode

In control mode, we intercept the prefix key (e.g., Ctrl+B or Ctrl+Space) and wait for the next key to translate into a tmux command.

Returns true if the key was handled by the prefix system.

impl WindowState

pub fn new(config: Config, runtime: Arc<Runtime>) -> Self

Create a new window state with the given configuration

Trait Implementations

impl Drop for WindowState

fn drop(&mut self)

Executes the destructor for this type.