docs: added layout feature

Author: dasvh

README.md

@@ -13,8 +13,12 @@ A simple plugin for [taskfiles](https://taskfile.dev/)
 - Run tasks in a floating terminal
 - Automatically scroll to bottom of output (optional)
 - Rerun last task via command or key-map
-- Flexible layout with width_ratio or auto-sizing to fit
-  task names and descriptions neatly
+- Flexible layouts:
+  - **Horizontal**: task list and preview side-by-side
+  - **Vertical**: task list stacked above preview
+- Configurable `width_ratio` / `height_ratio` or automatic sizing
+  to neatly fit task names and descriptions
+- Toggle between horizontal and vertical layouts at runtime
 
 ## Requirements
 
@@ -39,6 +43,9 @@ All fields are optional and shown below with their default values:
 
 ```lua
 require('taskfile').setup({
+  layout = "horizontal", -- Layout: 'h', 'horiz', 'horizontal' or 'v', 'vert', 'vertical'.
+                         -- For 'horizontal' layout, list and preview are side-by-side.
+                         -- For 'vertical', list is above preview (vertically stacked).
   windows = {
     output = {           -- Task output window
       width = 0.8,       -- Width of the window (percentage of editor width)
@@ -48,11 +55,18 @@ require('taskfile').setup({
     list = {             -- Task list and preview window
       width = 0.6,
       height = 0.4,
-      border = "rounded"
+      border = "rounded",
+      -- only used for horizontal layout
       width_ratio = 0,   -- Ratio (0–1) of list vs preview width.
                          -- If set, determines how much space is given to the list.
                          -- If unset or 0, the list width is calculated to fit
                          -- longest task name and description without wrapping.
+      -- only used for vertical layout
+      height_ratio = 0,  -- Ratio (0–1) of list vs preview height.
+                         -- If set, determines how much space is given to the list.
+                         -- If unset or 0, the list height is calculated to fit
+                         -- the rendered task lines (name + description),
+                         -- wrapping as needed, without overflow.
     },
   },
   scroll = {
@@ -73,6 +87,8 @@ This plugin reads your Taskfile and displays available tasks.
 - `:Task <task_name>`: Run a specific task by name
 - `:Task`: Show a floating task selector with preview
 - `:TaskRerun`: Rerun the last executed task
+- `:TaskToggleLayout`: Toggles the layout for the current Neovim session.
+  On restart, it resets to your configured default.
 
 You can also bind a key to rerun using the `keymaps.rerun` config.
 

demo/demo.gif

@@ -8,9 +8,9 @@ Set MarginFill "#3D4262"
 Set BorderRadius 7
 
 
-Set Width 1600
+Set Width 1440
 Set Height 900
-Set FontSize 14
+Set FontSize 16
 
 Hide
 Type "cd $HOME/git/examples/go-web-app"
@@ -27,6 +27,11 @@ Sleep 750ms
 Enter
 Sleep 750ms
 
+Type ":TaskToggleLayout"
+Sleep 500ms
+Enter
+Sleep 500ms
+
 Type "j"
 Sleep 1000ms
 Enter
@@ -45,6 +50,11 @@ Sleep 1000ms
 Enter
 Sleep 1000ms
 
+Type ":TaskToggleLayout"
+Sleep 500ms
+Enter
+Sleep 500ms
+
 Type "j"
 Sleep 500ms
 Type "j"

demo/demo.tape

@@ -473,7 +473,7 @@ describe("ui integration", function()
 
   it("horizontal honors width_ratio and ignores height_ratio", function()
     local cfg_width = 0.9
-    local total_weight = math.floor(vim.o.columns * cfg_width)
+    local total_width = math.floor(vim.o.columns * cfg_width)
     local width_ratio = 0.3
 
     ui.select_task_with_preview(require("taskfile.core").get_tasks(), {
@@ -487,8 +487,8 @@ describe("ui integration", function()
 
     local list_cfg, preview_cfg = win_cfg(ui._list_win), win_cfg(ui._preview_win)
 
-    assert.are.equal(math.floor(total_weight * width_ratio), list_cfg.width)
-    assert.are.equal(total_weight, list_cfg.width + 2 + preview_cfg.width) -- gap=2
+    assert.are.equal(math.floor(total_width * width_ratio), list_cfg.width)
+    assert.are.equal(total_width, list_cfg.width + ui.const.WINDOW_GAP + preview_cfg.width)
   end)
 
   it("vertical honors height_ratio and ignores width_ratio", function()