feat: replace npm live-server with pure-Lua HTTP server

.github/workflows/quality.yaml

@@ -24,6 +24,7 @@ jobs:
               - '*.lua'
               - '.luarc.json'
               - '*.toml'
+              - 'vim.yaml'
             markdown:
               - '*.md'
               - 'doc/**/*.md'
@@ -35,11 +36,8 @@ jobs:
     if: ${{ needs.changes.outputs.lua == 'true' }}
     steps:
       - uses: actions/checkout@v4
-      - uses: JohnnyMorganz/stylua-action@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          version: 2.1.0
-          args: --check .
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop --command stylua --check .
 
   lua-lint:
     name: Lua Lint Check
@@ -48,11 +46,8 @@ jobs:
     if: ${{ needs.changes.outputs.lua == 'true' }}
     steps:
       - uses: actions/checkout@v4
-      - name: Lint with Selene
-        uses: NTBBloodbath/selene-action@v1.0.0
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          args: --display-style quiet .
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop --command selene --display-style quiet .
 
   lua-typecheck:
     name: Lua Type Check
@@ -75,15 +70,5 @@ jobs:
     if: ${{ needs.changes.outputs.markdown == 'true' }}
     steps:
       - uses: actions/checkout@v4
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 8
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-      - name: Install prettier
-        run: pnpm add -g prettier@3.1.0
-      - name: Check markdown formatting with prettier
-        run: prettier --check .
+      - uses: cachix/install-nix-action@v31
+      - run: nix develop --command prettier --check .

.gitignore

@@ -3,3 +3,6 @@ doc/tags
 CLAUDE.md
 .claude/
 node_modules/
+
+.envrc
+.direnv

.luarc.json

@@ -1,5 +1,5 @@
 {
-  "runtime.version": "Lua 5.1",
+  "runtime.version": "LuaJIT",
   "runtime.path": ["lua/?.lua", "lua/?/init.lua"],
   "diagnostics.globals": ["vim"],
   "workspace.library": ["$VIMRUNTIME/lua", "${3rd}/luv/library"],

.pre-commit-config.yaml

@@ -14,4 +14,4 @@ repos:
     hooks:
       - id: prettier
         name: prettier
-        files: \.(md|toml|ya?ml|sh)$
+        files: \.(md|toml|yaml|yml|sh)$

README.md

@@ -1,7 +1,12 @@
 # live-server.nvim
 
-Live reload HTML, CSS, and JavaScript files inside Neovim with the power of
-[live-server](https://www.npmjs.com/package/live-server).
+Live reload HTML, CSS, and JavaScript files inside Neovim. No external
+dependencies — the server runs entirely in Lua using Neovim's built-in libuv
+bindings.
+
+## Dependencies
+
+- Neovim >= 0.10
 
 ## Installation
 
@@ -12,12 +17,17 @@ Install with your package manager or via
 luarocks install live-server.nvim
 ```
 
-## Dependencies
-
-- [live-server](https://www.npmjs.com/package/live-server) (install globally via npm/yarn)
-
 ## Documentation
 
 ```vim
 :help live-server.nvim
 ```
+
+## Known Limitations
+
+- **No recursive file watching on Linux**: libuv's `uv_fs_event` only supports
+  recursive directory watching on macOS and Windows. On Linux (inotify), the
+  `recursive` flag is silently ignored, so only files in the served root
+  directory trigger hot-reload. Files in subdirectories (e.g. `css/style.css`)
+  will not be detected. See
+  [libuv#1778](https://github.com/libuv/libuv/issues/1778).

doc/live-server.txt

@@ -7,13 +7,13 @@ Homepage: <https://github.com/barrettruth/live-server.nvim>
 INTRODUCTION                                                *live-server.nvim*
 
 live-server.nvim automatically reloads HTML, CSS, and JavaScript files in the
-browser via a local development server.
+browser via a local development server. No external dependencies required —
+the server runs entirely in Lua using Neovim's built-in libuv bindings.
 
 ===============================================================================
 REQUIREMENTS                                        *live-server-requirements*
 
-- Neovim >= 0.9.0
-- live-server npm package (`npm install -g live-server`)
+- Neovim >= 0.10
 
 ===============================================================================
 CONFIGURATION                                            *live-server-config*
@@ -22,15 +22,23 @@ CONFIGURATION                                            *live-server-config*
 Configure via `vim.g.live_server` before the plugin loads: >lua
 
     vim.g.live_server = {
-        args = { '--port=8080', '--no-browser' },
+        port = 8080,
+        browser = false,
     }
 <
                                                          *live_server.Config*
 Fields: ~
 
-    {args}  (`string[]`) Arguments passed to live-server via |vim.fn.jobstart()|.
-            Run `live-server --help` to see available options.
-            Default: `{ '--port=5555' }`
+    {port}      (`integer?`) Port for the HTTP server. Default: `5500`
+    {browser}   (`boolean?`) Auto-open browser on start. Default: `true`
+    {debounce}  (`integer?`) Debounce interval in ms for file changes.
+                Default: `120`
+    {ignore}    (`string[]?`) Lua patterns for file paths to ignore when
+                watching for changes. Default: `{}`
+    {css_inject} (`boolean?`) Hot-swap CSS without full page reload.
+                Default: `true`
+    {debug}     (`boolean?`) Log each step of the hot-reload chain via
+                |vim.notify()| at DEBUG level. Default: `false`
 
 ===============================================================================
 COMMANDS                                               *live-server-commands*
@@ -113,8 +121,32 @@ Lua keybinding to toggle server: >lua
 Configuration with custom port and no auto-open: >lua
 
     vim.g.live_server = {
-        args = { '--port=3000', '--no-browser' },
+        port = 3000,
+        browser = false,
     }
 <
+Ignore node_modules and dotfiles: >lua
+
+    vim.g.live_server = {
+        ignore = { 'node_modules', '^%.' },
+    }
+<
+===============================================================================
+KNOWN LIMITATIONS                                  *live-server-limitations*
+
+No Recursive File Watching on Linux ~
+                                              *live-server-linux-recursive*
+libuv's `uv_fs_event` only supports recursive directory watching on macOS
+(FSEvents) and Windows (ReadDirectoryChangesW). On Linux, the `recursive`
+flag is silently accepted but ignored because inotify does not support it
+natively. Only files directly in the served root directory trigger
+hot-reload; files in subdirectories (e.g. `css/style.css`) will not be
+detected.
+
+See https://github.com/libuv/libuv/issues/1778
+
+Enable `debug` in |live-server-config| to verify whether `fs_event`
+callbacks fire for a given file change.
+
 -------------------------------------------------------------------------------
 vim:tw=78:ft=help:norl:

flake.nix

@@ -0,0 +1,36 @@
+{
+  description = "live-server.nvim — live reload for web development in Neovim";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
+    systems.url = "github:nix-systems/default";
+  };
+
+  outputs =
+    {
+      nixpkgs,
+      systems,
+      ...
+    }:
+    let
+      forEachSystem = f: nixpkgs.lib.genAttrs (import systems) (system: f nixpkgs.legacyPackages.${system});
+    in
+    {
+      devShells = forEachSystem (pkgs: {
+        default = pkgs.mkShell {
+          packages = [
+            (pkgs.luajit.withPackages (
+              ps: with ps; [
+                busted
+                nlua
+              ]
+            ))
+            pkgs.prettier
+            pkgs.stylua
+            pkgs.selene
+            pkgs.lua-language-server
+          ];
+        };
+      });
+    };
+}