feat: add customizable window alignment system

Replace row/col positioning with intuitive align options:
- center, top-left, top-right, bottom-left, bottom-right
- top, bottom, left, right
- Defaults to 'center' for backward compatibility

Author: ravitemer

doc/configuration.md

@@ -37,6 +37,7 @@ All options are optional with sensible defaults. See below for each option in de
                 window = {
                     width = 0.8, -- 0-1 (ratio); "50%" (percentage); 50 (raw number)
                     height = 0.8, -- 0-1 (ratio); "50%" (percentage); 50 (raw number)
+                    align = "center", -- "center", "top-left", "top-right", "bottom-left", "bottom-right", "top", "bottom", "left", "right"
                     relative = "editor",
                     zindex = 50,
                     border = "rounded", -- "none", "single", "double", "rounded", "solid", "shadow"
@@ -196,6 +197,7 @@ Default:
         window = {
             width = 0.85, -- 0-1 (ratio); "50%" (percentage); 50 (raw number)
             height = 0.85, -- 0-1 (ratio); "50%" (percentage); 50 (raw number)
+            align = "center", -- "center", "top-left", "top-right", "bottom-left", "bottom-right", "top", "bottom", "left", "right"
             border = "rounded", -- "none", "single", "double", "rounded", "solid", "shadow"
             relative = "editor",
             zindex = 50,
@@ -210,6 +212,11 @@ Default:
 Controls the appearance and behavior of the MCPHub UI window:
 - `width`: Window width (0-1 for ratio, "50%" for percentage, or raw number)
 - `height`: Window height (same format as width)
+- `align`: Window alignment position. Options:
+  - `"center"`: Center the window (default)
+  - `"top-left"`, `"top-right"`, `"bottom-left"`, `"bottom-right"`: Corner positions
+  - `"top"`, `"bottom"`: Top/bottom edge, centered horizontally
+  - `"left"`, `"right"`: Left/right edge, centered vertically
 - `relative`: Window placement relative to ("editor", "win", or "cursor")
 - `zindex`: Window stacking order
 - `border`: Border style ("none", "single", "double", "rounded", "solid", "shadow")
@@ -246,3 +253,6 @@ Logging configuration options:
 - `file_path`: Custom log file path
 - `prefix`: Prefix for log messages
 
+
+
+

lua/mcphub/config.lua

@@ -30,6 +30,7 @@ local defaults = {
         window = {
             width = 0.85, -- 0-1 (ratio); "50%" (percentage); 50 (raw number)
             height = 0.85, -- 0-1 (ratio); "50%" (percentage); 50 (raw number)
+            align = "center", -- "center", "top-left", "top-right", "bottom-left", "bottom-right", "top", "bottom", "left", "right"
             border = "rounded", -- "none", "single", "double", "rounded", "solid", "shadow"
             relative = "editor",
             zindex = 50,

lua/mcphub/ui/init.lua

@@ -24,6 +24,7 @@ local defaults = {
     window = {
         width = 0.8, -- 0-1 (ratio); "50%" (percentage); 50 (raw number)
         height = 0.8, -- 0-1 (ratio); "50%" (percentage); 50 (raw number)
+        align = "center", -- "center", "top-left", "top-right", "bottom-left", "bottom-right", "top", "bottom", "left", "right"
         border = "rounded", -- "none", "single", "double", "rounded", "solid", "shadow"
         relative = "editor",
         zindex = 50,
@@ -195,9 +196,42 @@ function UI:calculate_window_dimensions()
     local height = parse_size(win_opts.height, vim.o.lines)
     height = math.max(min_height, height)
 
-    -- Calculate center position
-    local row = math.floor((vim.o.lines - height) / 2)
-    local col = math.floor((vim.o.columns - width) / 2)
+    -- Calculate position based on alignment
+    local row, col
+    local align = win_opts.align or "center"
+
+    if align == "center" then
+        row = math.floor((vim.o.lines - height) / 2)
+        col = math.floor((vim.o.columns - width) / 2)
+    elseif align == "top-left" then
+        row = 1
+        col = 1
+    elseif align == "top-right" then
+        row = 1
+        col = vim.o.columns - width
+    elseif align == "bottom-left" then
+        row = vim.o.lines - height
+        col = 1
+    elseif align == "bottom-right" then
+        row = vim.o.lines - height
+        col = vim.o.columns - width
+    elseif align == "top" then
+        row = 1
+        col = math.floor((vim.o.columns - width) / 2)
+    elseif align == "bottom" then
+        row = vim.o.lines - height
+        col = math.floor((vim.o.columns - width) / 2)
+    elseif align == "left" then
+        row = math.floor((vim.o.lines - height) / 2)
+        col = 1
+    elseif align == "right" then
+        row = math.floor((vim.o.lines - height) / 2)
+        col = vim.o.columns - width
+    else
+        -- Default to center for unknown alignment
+        row = math.floor((vim.o.lines - height) / 2)
+        col = math.floor((vim.o.columns - width) / 2)
+    end
 
     return {
         width = width,