feat: generalize format hook and add floating window docs

Change-Id: I18f2e841ae68c3f4017155367e9a944adf4a4827
Signed-off-by: Thomas Kosiewski <[email protected]>

Author: ThomasK33

.claude/hooks/format-lua.sh renamed to .claude/hooks/format.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 #
-# Claude Code Hook: Format Lua Files
-# Triggers after Claude edits/writes Lua files and runs nix fmt
+# Claude Code Hook: Format Files
+# Triggers after Claude edits/writes files and runs nix fmt
 #
 # Environment variables provided by Claude Code:
 # - CLAUDE_PROJECT_DIR: Path to the project directory
@@ -43,27 +43,21 @@ get_file_path() {
     return
   fi
 
-  # Try extracting any .lua file path from the input
-  local lua_path
-  lua_path=$(echo "$hook_input" | grep -o '"[^"]*\.lua"' | sed 's/"//g' | head -1)
+  # Try extracting any file path from the input
+  local any_file_path
+  any_file_path=$(echo "$hook_input" | grep -o '"[^"]*\.[^"]*"' | sed 's/"//g' | head -1)
 
-  if [ -n "$lua_path" ]; then
-    echo "$lua_path"
+  if [ -n "$any_file_path" ]; then
+    echo "$any_file_path"
     return
   fi
 
   log "DEBUG: Could not extract file path from hook input"
 }
 
-# Check if file is a Lua file
-is_lua_file() {
-  local file="$1"
-  [[ $file =~ \.lua$ ]]
-}
-
 # Main logic
 main() {
-  log "${YELLOW}Claude Code Hook: Lua Formatter${NC}"
+  log "${YELLOW}Claude Code Hook: File Formatter${NC}"
 
   # Get the file path from tool arguments
   FILE_PATH=$(get_file_path)
@@ -75,19 +69,13 @@ main() {
 
   log "Tool: ${CLAUDE_TOOL_NAME:-unknown}, File: $FILE_PATH"
 
-  # Check if it's a Lua file
-  if ! is_lua_file "$FILE_PATH"; then
-    log "Skipping: Not a Lua file ($FILE_PATH)"
-    exit 0
-  fi
-
   # Check if file exists
   if [ ! -f "$FILE_PATH" ]; then
     log "${RED}Error: File does not exist: $FILE_PATH${NC}"
     exit 1
   fi
 
-  log "${YELLOW}Formatting Lua file with nix fmt...${NC}"
+  log "${YELLOW}Formatting file with nix fmt...${NC}"
 
   # Change to project directory
   cd "${CLAUDE_PROJECT_DIR}"

.claude/settings.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format-lua.sh"
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/format.sh"
           }
         ]
       }

README.md

@@ -151,7 +151,7 @@ For deep technical details, see [ARCHITECTURE.md](./ARCHITECTURE.md).
       split_width_percentage = 0.30,
       provider = "auto", -- "auto", "snacks", "native", or custom provider table
       auto_close = true,
-      snacks_win_opts = {}, -- Opts to pass to `Snacks.terminal.open()`
+      snacks_win_opts = {}, -- Opts to pass to `Snacks.terminal.open()` - see Floating Window section below
     },
 
     -- Diff Integration
@@ -167,6 +167,158 @@ For deep technical details, see [ARCHITECTURE.md](./ARCHITECTURE.md).
 }
 ```
 
+## Floating Window Configuration
+
+The `snacks_win_opts` configuration allows you to create floating Claude Code terminals with custom positioning, sizing, and key bindings. Here are several practical examples:
+
+### Basic Floating Window with Ctrl+, Toggle
+
+```lua
+local toggle_key = "<C-,>"
+return {
+  {
+    "coder/claudecode.nvim",
+    dependencies = { "folke/snacks.nvim" },
+    keys = {
+      { toggle_key, "<cmd>ClaudeCodeFocus<cr>", desc = "Claude Code", mode = { "n", "x" } },
+    },
+    opts = {
+      terminal = {
+        ---@module "snacks"
+        ---@type snacks.win.Config|{}
+        snacks_win_opts = {
+          position = "float",
+          width = 0.9,
+          height = 0.9,
+          keys = {
+            claude_hide = {
+              toggle_key,
+              function(self)
+                self:hide()
+              end,
+              mode = "t",
+              desc = "Hide",
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+### Alternative with Meta+, (Alt+,) Toggle
+
+```lua
+local toggle_key = "<M-,>"  -- Alt/Meta + comma
+return {
+  {
+    "coder/claudecode.nvim",
+    dependencies = { "folke/snacks.nvim" },
+    keys = {
+      { toggle_key, "<cmd>ClaudeCodeFocus<cr>", desc = "Claude Code", mode = { "n", "x" } },
+    },
+    opts = {
+      terminal = {
+        snacks_win_opts = {
+          position = "float",
+          width = 0.8,
+          height = 0.8,
+          border = "rounded",
+          keys = {
+            claude_hide = { toggle_key, function(self) self:hide() end, mode = "t", desc = "Hide" },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+### Centered Floating Window with Custom Styling
+
+```lua
+require("claudecode").setup({
+  terminal = {
+    snacks_win_opts = {
+      position = "float",
+      width = 0.6,
+      height = 0.6,
+      border = "double",
+      backdrop = 80,
+      keys = {
+        claude_hide = { "<Esc>", function(self) self:hide() end, mode = "t", desc = "Hide" },
+        claude_close = { "q", "close", mode = "n", desc = "Close" },
+      },
+    },
+  },
+})
+```
+
+### Multiple Key Binding Options
+
+```lua
+{
+  "coder/claudecode.nvim",
+  dependencies = { "folke/snacks.nvim" },
+  keys = {
+    { "<C-,>", "<cmd>ClaudeCodeFocus<cr>", desc = "Claude Code (Ctrl+,)", mode = { "n", "x" } },
+    { "<M-,>", "<cmd>ClaudeCodeFocus<cr>", desc = "Claude Code (Alt+,)", mode = { "n", "x" } },
+    { "<leader>tc", "<cmd>ClaudeCodeFocus<cr>", desc = "Toggle Claude", mode = { "n", "x" } },
+  },
+  opts = {
+    terminal = {
+      snacks_win_opts = {
+        position = "float",
+        width = 0.85,
+        height = 0.85,
+        border = "rounded",
+        keys = {
+          -- Multiple ways to hide from terminal mode
+          claude_hide_ctrl = { "<C-,>", function(self) self:hide() end, mode = "t", desc = "Hide (Ctrl+,)" },
+          claude_hide_alt = { "<M-,>", function(self) self:hide() end, mode = "t", desc = "Hide (Alt+,)" },
+          claude_hide_esc = { "<C-\\><C-n>", function(self) self:hide() end, mode = "t", desc = "Hide (Ctrl+\\)" },
+        },
+      },
+    },
+  },
+}
+```
+
+### Window Position Variations
+
+```lua
+-- Bottom floating (like a drawer)
+snacks_win_opts = {
+  position = "bottom",
+  height = 0.4,
+  width = 1.0,
+  border = "single",
+}
+
+-- Side floating panel
+snacks_win_opts = {
+  position = "right",
+  width = 0.4,
+  height = 1.0,
+  border = "rounded",
+}
+
+-- Small centered popup
+snacks_win_opts = {
+  position = "float",
+  width = 120,  -- Fixed width in columns
+  height = 30,  -- Fixed height in rows
+  border = "double",
+  backdrop = 90,
+}
+```
+
+For complete configuration options, see:
+
+- [Snacks.nvim Terminal Documentation](https://github.com/folke/snacks.nvim/blob/main/docs/terminal.md)
+- [Snacks.nvim Window Documentation](https://github.com/folke/snacks.nvim/blob/main/docs/win.md)
+
 ## Custom Terminal Providers
 
 You can create custom terminal providers by passing a table with the required functions instead of a string provider name: