update docs

README.md

@@ -469,3 +469,29 @@ listen_on unix:/tmp/mykitty
 Thanks @knubie for inspiration for the Kitty implementation from [vim-kitty-navigator](https://github.com/knubie/vim-kitty-navigator).
 
 Thanks to @chancez for the relative resize [Python kitten](https://github.com/chancez/dotfiles/blob/badc69d3895a6a942285126b8c372a55d77533e1/kitty/.config/kitty/relative_resize.py).
+
+### Multiplexer Lua API
+
+You can directly access the multiplexer API for scripting purposes as well.
+To get a handle to the current multiplexer backend, you can do:
+
+```lua
+local mux = require('smart-splits.mux').get()
+```
+
+This returns the currently enabled multiplexer backend, or `nil` if none is currently in use.
+The API offers the following methods:
+
+```lua
+local mux = require('smart-splits.mux').get()
+-- mux matches the following type annotations
+---@class SmartSplitsMultiplexer
+---@field current_pane_id fun():number|nil
+---@field current_pane_at_edge fun(direction:'left'|'right'|'up'|'down'):boolean
+---@field is_in_session fun():boolean
+---@field current_pane_is_zoomed fun():boolean
+---@field next_pane fun(direction:'left'|'right'|'up'|'down'):boolean
+---@field resize_pane fun(direction:'left'|'right'|'up'|'down', amount:number):boolean
+---@field split_pane fun(direction:'left'|'right'|'up'|'down',size:number|nil):boolean
+---@field type 'tmux'|'wezterm'|'kitty'
+```

lua/smart-splits/mux/init.lua

@@ -63,7 +63,7 @@ end
 ---@param direction SmartSplitsDirection direction to move
 ---@param will_wrap boolean whether to wrap around edge
 ---@param at_edge SmartSplitsAtEdgeBehavior behavior at edge
----@return boolean whether we moved with multiplexer or not
+---@return boolean success
 function M.move_pane(direction, will_wrap, at_edge)
   at_edge = at_edge or config.at_edge
   local multiplexer = M.get()
@@ -90,7 +90,7 @@ end
 ---Try resizing with multiplexer
 ---@param direction SmartSplitsDirection direction to resize
 ---@param amount number amount to resize
----@return boolean whether we resized with multiplexer or not
+---@return boolean success
 function M.resize_pane(direction, amount)
   local multiplexer = M.get()
   if not multiplexer or not multiplexer.is_in_session() then
@@ -103,10 +103,25 @@ function M.resize_pane(direction, amount)
   local ok = multiplexer.resize_pane(direction, amount)
   if not ok then
     vim.notify('[smart-splits.nvim] Failed to resize multiplexer pane', vim.log.levels.ERROR)
-    return false
   end
 
-  return true
+  return ok
+end
+
+---Try creating a new mux split pane. Not supported in Kitty multiplexer.
+---@param direction SmartSplitsDirection
+---@param size number|nil
+---@return boolean success
+function M.split_pane(direction, size)
+  local mux = M.get()
+  if not mux or not mux.is_in_session() then
+    return false
+  end
+  local ok = mux.split_pane(direction, size)
+  if not ok then
+    vim.notify('[smart-splits.nvim] Failed to create a new mux pane', vim.log.levels.ERROR)
+  end
+  return ok
 end
 
 return M

lua/smart-splits/mux/kitty.lua

@@ -81,10 +81,7 @@ function M.next_pane(direction)
   end
 
   direction = dir_keys_kitty[direction] ---@diagnostic disable-line
-  local ok, _ = pcall(function()
-    kitty_exec({ 'kitten', 'neighboring_window.py', direction })
-  end)
-
+  local ok, _ = pcall(kitty_exec, { 'kitten', 'neighboring_window.py', direction })
   return ok
 end
 
@@ -93,15 +90,16 @@ function M.resize_pane(direction, amount)
     return false
   end
 
-  local ok, _ = pcall(function()
-    kitty_exec({ 'kitten', 'relative_resize.py', direction, amount })
-  end)
+  local ok, _ = pcall(kitty_exec, { 'kitten', 'relative_resize.py', direction, amount })
 
   return ok
 end
 
 function M.split_pane(_, _)
-  vim.notify('[smart-splits.nvim] Sorry, Kitty does not support creation of arbitrary split panes.')
+  vim.notify(
+    '[smart-splits.nvim] Sorry, Kitty does not support creation of arbitrary split panes.',
+    vim.log.levels.WARN
+  )
   return false
 end
 

lua/smart-splits/mux/tmux.lua

@@ -161,8 +161,7 @@ function M.next_pane(direction)
   end
 
   direction = dir_keys_tmux[direction] ---@diagnostic disable-line
-  local ok, s = pcall(tmux_exec, { 'select-pane', string.format('-%s', direction) })
-  p(s)
+  local ok, _ = pcall(tmux_exec, { 'select-pane', string.format('-%s', direction) })
   return ok
 end
 
@@ -177,7 +176,17 @@ function M.resize_pane(direction, amount)
 end
 
 function M.split_pane(direction, size)
-  local args = {}
+  local vert_or_horiz = (direction == Direction.left or direction == Direction.right) and '-h' or '-v'
+  local args = { 'split-pane', vert_or_horiz }
+  if direction == Direction.up or direction == Direction.left then
+    table.insert(args, '-b')
+  end
+  if size then
+    table.insert(args, '-l')
+    table.insert(args, size)
+  end
+  local ok, _ = pcall(tmux_exec, args)
+  return ok
 end
 
 return M