From da390041c98c01eb5360cfedc3251860d272db81 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <> Date: Wed, 19 Apr 2023 16:17:24 +0000 Subject: [PATCH] chore: generated vimdoc --- doc/smart-splits.txt | 31 ++++++++++++++++++++++++++++++- doc/tags | 1 + 2 files changed, 31 insertions(+), 1 deletion(-) diff --git a/doc/smart-splits.txt b/doc/smart-splits.txt index a305450..9d668ff 100644 --- a/doc/smart-splits.txt +++ b/doc/smart-splits.txt @@ -13,6 +13,7 @@ Multiplexer Integrations ............. |smart-splits-multiplexer-integrations| Tmux ..................................................... |smart-splits-tmux| Wezterm ............................................... |smart-splits-wezterm| Kitty ................................................... |smart-splits-kitty| +Multiplexer Lua API ....................... |smart-splits-multiplexer-lua-api| ============================================================================== 🧠 `SMART-SPLITS.NVIM` *smart-splits-🧠-`smart-splits.nvim* @@ -29,7 +30,8 @@ demo - Install <#install> - Configuration <#configuration> - Hooks <#hooks> - Examples: <#examples> - Usage <#usage> - Multiplexer Integrations <#multiplexer-integrations> - Tmux - <#tmux> - Wezterm <#wezterm> - Kitty <#kitty> - Credits <#credits> + <#tmux> - Wezterm <#wezterm> - Kitty <#kitty> - Credits <#credits> - + Multiplexer Lua API <#multiplexer-lua-api> ------------------------------------------------------------------------------ INSTALL *smart-splits-install* @@ -104,6 +106,7 @@ Defaults are shown below: -- current_pane_at_edge(direction:'left'|'right'|'up'|'down'):boolean -- next_pane(direction:'left'|'right'|'up'|'down'):boolean -- resize_pane(direction:'left'|'right'|'up'|'down'):boolean + -- split_pane(direction:'left'|'right'|'up'|'down',size:number|nil):boolean -- }, -- direction = 'left'|'right'|'up'|'down', -- split(), -- utility function to split current Neovim pane in the current direction @@ -502,4 +505,30 @@ Thanks to @chancez for the relative resize Python kitten . + +MULTIPLEXER LUA API *smart-splits-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' +< + vim:tw=78:ts=8:ft=help:norl: \ No newline at end of file diff --git a/doc/tags b/doc/tags index f0d2319..39af5e9 100644 --- a/doc/tags +++ b/doc/tags @@ -8,6 +8,7 @@ smart-splits-key-mappings smart-splits.txt /*smart-splits-key-mappings* smart-splits-kitty smart-splits.txt /*smart-splits-kitty* smart-splits-lua-api smart-splits.txt /*smart-splits-lua-api* smart-splits-multiplexer-integrations smart-splits.txt /*smart-splits-multiplexer-integrations* +smart-splits-multiplexer-lua-api smart-splits.txt /*smart-splits-multiplexer-lua-api* smart-splits-table-of-contents smart-splits.txt /*smart-splits-table-of-contents* smart-splits-tmux smart-splits.txt /*smart-splits-tmux* smart-splits-usage smart-splits.txt /*smart-splits-usage*