npm - @peaske7/readit - Versions diffs - 0.2.0 → 0.2.1 - Mend

@peaske7/readit 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (173) hide show

package/.claude/CLAUDE.md +118 -76
package/.claude/commands/review.md +1 -1
package/.claude/roadmap.md +32 -9
package/.claude/user-stories.md +100 -15
package/AGENTS.md +30 -26
package/Makefile +32 -0
package/README.md +90 -2
package/biome.json +18 -8
package/bun.lock +426 -568
package/bunfig.toml +2 -0
package/docs/perf-baseline.md +56 -1
package/docs/superpowers/specs/2026-03-27-go-server-rewrite-design.md +284 -0
package/e2e/comments.spec.ts +14 -58
package/e2e/document-load.spec.ts +1 -23
package/e2e/export.spec.ts +4 -4
package/e2e/perf/add-comment.spec.ts +9 -11
package/e2e/perf/fixtures/generate.ts +1 -5
package/e2e/perf/screenshot-final.png +0 -0
package/e2e/perf/utils/metrics.ts +73 -9
package/e2e/persistence-file.spec.ts +41 -26
package/e2e/utils/selection.ts +17 -73
package/go/cmd/readit/main.go +416 -0
package/go/go.mod +20 -0
package/go/go.sum +41 -0
package/go/internal/server/anchor.go +302 -0
package/go/internal/server/anchor_test.go +111 -0
package/go/internal/server/comments.go +390 -0
package/go/internal/server/documents.go +113 -0
package/go/internal/server/embed.go +17 -0
package/go/internal/server/headings.go +33 -0
package/go/internal/server/headings_test.go +75 -0
package/go/internal/server/htmltext.go +123 -0
package/go/internal/server/markdown.go +157 -0
package/go/internal/server/markdown_bench_test.go +42 -0
package/go/internal/server/markdown_test.go +79 -0
package/go/internal/server/server.go +453 -0
package/go/internal/server/server_bench_test.go +122 -0
package/go/internal/server/settings.go +110 -0
package/go/internal/server/sse.go +140 -0
package/go/internal/server/storage.go +275 -0
package/go/internal/server/storage_test.go +118 -0
package/go/internal/server/template.go +66 -0
package/go/internal/server/types.go +101 -0
package/go/internal/server/watcher.go +74 -0
package/index.html +4 -14
package/nvim-readit/lua/readit/health.lua +64 -0
package/nvim-readit/lua/readit/init.lua +463 -0
package/nvim-readit/plugin/readit.lua +19 -0
package/package.json +20 -28
package/shell/_readit +158 -0
package/shell/readit.zsh +87 -0
package/src/App.svelte +881 -0
package/src/cli.ts +183 -21
package/src/components/ActionsMenu.svelte +95 -0
package/src/components/CommentBadge.svelte +67 -0
package/src/components/CommentErrorBanner.svelte +33 -0
package/src/components/CommentInput.svelte +75 -0
package/src/components/CommentListItem.svelte +95 -0
package/src/components/CommentManager.svelte +129 -0
package/src/components/CommentNav.svelte +109 -0
package/src/components/DocumentViewer.svelte +218 -0
package/src/components/FloatingComment.svelte +107 -0
package/src/components/Header.svelte +76 -0
package/src/components/InlineEditor.svelte +72 -0
package/src/components/MarginNote.svelte +167 -0
package/src/components/MarginNotesContainer.svelte +33 -0
package/src/components/RawModal.svelte +126 -0
package/src/components/ReanchorConfirm.svelte +30 -0
package/src/components/SettingsModal.svelte +220 -0
package/src/components/ShortcutCapture.svelte +82 -0
package/src/components/ShortcutList.svelte +145 -0
package/src/components/TabBar.svelte +52 -0
package/src/components/TableOfContents.svelte +125 -0
package/src/components/ui/ActionLink.svelte +40 -0
package/src/components/ui/{Button.tsx → Button.svelte} +19 -20
package/src/components/ui/Dialog.svelte +97 -0
package/src/components/ui/DropdownMenu.svelte +85 -0
package/src/components/ui/DropdownMenuItem.svelte +38 -0
package/src/components/ui/DropdownMenuSeparator.svelte +11 -0
package/src/components/ui/{Text.tsx → Text.svelte} +18 -23
package/src/env.d.ts +6 -0
package/src/index.css +36 -166
package/src/lib/__fixtures__/bench-data.ts +0 -13
package/src/lib/anchor.bench.ts +1 -12
package/src/lib/anchor.test.ts +0 -8
package/src/lib/anchor.ts +0 -4
package/src/lib/comment-storage.bench.ts +49 -0
package/src/lib/comment-storage.test.ts +41 -33
package/src/lib/comment-storage.ts +21 -18
package/src/lib/export.bench.ts +21 -0
package/src/lib/export.ts +0 -1
package/src/{hooks/useHeadings.test.ts → lib/headings.test.ts} +10 -24
package/src/{hooks/useHeadings.ts → lib/headings.ts} +11 -13
package/src/lib/highlight/core.test.ts +0 -5
package/src/lib/highlight/dom.ts +52 -216
package/src/lib/highlight/highlight-registry.ts +221 -0
package/src/lib/highlight/highlight.bench.ts +92 -0
package/src/lib/highlight/highlighter.ts +112 -132
package/src/lib/highlight/resolver.ts +5 -79
package/src/lib/highlight/types.ts +0 -5
package/src/lib/html-text.test.ts +162 -0
package/src/lib/html-text.ts +161 -0
package/src/lib/i18n/en.ts +26 -0
package/src/lib/i18n/ja.ts +26 -0
package/src/lib/i18n/types.ts +25 -0
package/src/lib/margin-layout.bench.ts +61 -0
package/src/lib/margin-layout.ts +0 -7
package/src/lib/markdown-renderer.test.ts +154 -0
package/src/lib/markdown-renderer.ts +177 -0
package/src/lib/mermaid-config.ts +38 -0
package/src/lib/mermaid-renderer.ts +162 -0
package/src/lib/mermaid-worker.ts +60 -0
package/src/lib/positions.ts +31 -24
package/src/lib/shortcut-registry.ts +244 -0
package/src/lib/utils.ts +0 -29
package/src/main.ts +16 -0
package/src/schema.ts +16 -5
package/src/server.ts +355 -91
package/src/stores/app.svelte.ts +231 -0
package/src/stores/locale.svelte.ts +46 -0
package/src/stores/settings.svelte.ts +90 -0
package/src/stores/shortcuts.svelte.ts +104 -0
package/src/stores/ui.svelte.ts +12 -0
package/src/template.ts +104 -0
package/src/test-setup.ts +47 -0
package/svelte.config.js +5 -0
package/tsconfig.json +2 -2
package/vite.config.ts +23 -3
package/vscode-readit/.mcp.json +7 -0
package/vscode-readit/.vscodeignore +7 -0
package/vscode-readit/bun.lock +78 -0
package/vscode-readit/icon.svg +10 -0
package/vscode-readit/package.json +110 -0
package/vscode-readit/src/extension.ts +117 -0
package/vscode-readit/src/server-manager.ts +272 -0
package/vscode-readit/src/webview-provider.ts +204 -0
package/vscode-readit/tsconfig.json +20 -0
package/e2e/fixtures/sample.html +0 -13
package/src/App.tsx +0 -368
package/src/components/ActionsMenu.tsx +0 -91
package/src/components/DocumentViewer/CodeBlock.tsx +0 -160
package/src/components/DocumentViewer/DocumentViewer.tsx +0 -230
package/src/components/DocumentViewer/MermaidDiagram.tsx +0 -136
package/src/components/Header.tsx +0 -54
package/src/components/InlineEditor.tsx +0 -74
package/src/components/MarginNote.tsx +0 -185
package/src/components/MarginNotes.tsx +0 -23
package/src/components/RawModal.tsx +0 -144
package/src/components/ReanchorConfirm.tsx +0 -36
package/src/components/SettingsModal.tsx +0 -232
package/src/components/TabBar.tsx +0 -60
package/src/components/TableOfContents.tsx +0 -108
package/src/components/comments/CommentBadge.tsx +0 -49
package/src/components/comments/CommentInput.tsx +0 -86
package/src/components/comments/CommentListItem.tsx +0 -90
package/src/components/comments/CommentManager.tsx +0 -129
package/src/components/comments/CommentNav.tsx +0 -109
package/src/components/ui/ActionLink.tsx +0 -28
package/src/components/ui/Dialog.tsx +0 -116
package/src/components/ui/DropdownMenu.tsx +0 -158
package/src/contexts/CommentContext.tsx +0 -198
package/src/contexts/LocaleContext.tsx +0 -76
package/src/contexts/PositionsContext.tsx +0 -16
package/src/contexts/SettingsContext.tsx +0 -133
package/src/hooks/useClickOutside.ts +0 -31
package/src/hooks/useCommentNavigation.ts +0 -107
package/src/hooks/useComments.ts +0 -311
package/src/hooks/useDocument.ts +0 -157
package/src/hooks/useScrollSpy.ts +0 -77
package/src/hooks/useTextSelection.ts +0 -86
package/src/lib/highlight/worker.ts +0 -45
package/src/main.tsx +0 -13
package/src/store.ts +0 -222

package/go/internal/server/watcher.go ADDED Viewed

@@ -0,0 +1,74 @@
+package server
+import (
+	"sync"
+	"time"
+	"github.com/fsnotify/fsnotify"
+)
+type Watcher struct {
+	fsWatcher *fsnotify.Watcher
+	debounce  map[string]*time.Timer
+	onChange  func(filePath string)
+	mu        sync.Mutex
+	done      chan struct{}
+}
+func NewWatcher(onChange func(string)) (*Watcher, error) {
+	fsw, err := fsnotify.NewWatcher()
+	if err != nil {
+		return nil, err
+	}
+	w := &Watcher{
+		fsWatcher: fsw,
+		debounce:  make(map[string]*time.Timer),
+		onChange:  onChange,
+		done:      make(chan struct{}),
+	}
+	go w.loop()
+	return w, nil
+}
+func (w *Watcher) loop() {
+	for {
+		select {
+		case event, ok := <-w.fsWatcher.Events:
+			if !ok {
+				return
+			}
+			if event.Has(fsnotify.Write) || event.Has(fsnotify.Create) {
+				w.debounceChange(event.Name)
+			}
+		case _, ok := <-w.fsWatcher.Errors:
+			if !ok {
+				return
+			}
+		case <-w.done:
+			return
+		}
+	}
+}
+func (w *Watcher) debounceChange(path string) {
+	w.mu.Lock()
+	defer w.mu.Unlock()
+	if t, ok := w.debounce[path]; ok {
+		t.Stop()
+	}
+	w.debounce[path] = time.AfterFunc(100*time.Millisecond, func() {
+		w.onChange(path)
+	})
+}
+func (w *Watcher) Add(path string) error {
+	return w.fsWatcher.Add(path)
+}
+func (w *Watcher) Close() {
+	close(w.done)
+	_ = w.fsWatcher.Close()
+}

package/index.html CHANGED Viewed

@@ -3,20 +3,10 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>readit - Markdown Review</title>
-    <link rel="preconnect" href="https://fonts.googleapis.com">
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-    <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>📖</text></svg>">
-    <script>
-      (() => {
-        var t = localStorage.getItem("readit:theme");
-        var d = t === "dark" || (t !== "light" && matchMedia("(prefers-color-scheme: dark)").matches);
-        if (d) document.documentElement.classList.add("dark");
-      })();
-    </script>
+    <title>readit</title>
   </head>
-  <body class="min-h-screen">
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
   </body>
 </html>

package/nvim-readit/lua/readit/health.lua ADDED Viewed

@@ -0,0 +1,64 @@
+-- Health check for readit.nvim
+-- Run with :checkhealth readit
+local M = {}
+function M.check()
+  vim.health.start("readit.nvim")
+  -- Check bun
+  local readit = require("readit")
+  local bun_path = readit.config.bun_path or "bun"
+  local bun_exec = vim.fn.exepath(bun_path)
+  if bun_exec ~= "" then
+    local version = vim.fn.system(bun_path .. " --version")
+    vim.health.ok("bun found: " .. vim.trim(version) .. " (" .. bun_exec .. ")")
+  else
+    vim.health.error(
+      "bun not found",
+      { "Install Bun: https://bun.sh", "Or set bun_path in setup()" }
+    )
+  end
+  -- Check readit CLI
+  local readit_exec = vim.fn.exepath("readit")
+  if readit_exec ~= "" then
+    vim.health.ok("readit CLI found: " .. readit_exec)
+  else
+    local dist = vim.fn.expand("~/.readit/dist/index.js")
+    if vim.fn.filereadable(dist) == 1 then
+      vim.health.ok("readit dist found: " .. dist)
+    else
+      vim.health.warn(
+        "readit CLI not in PATH",
+        { "Install: npm install -g @peaske7/readit", "Or: bun add -g @peaske7/readit" }
+      )
+    end
+  end
+  -- Check curl (needed for server communication)
+  if vim.fn.exepath("curl") ~= "" then
+    vim.health.ok("curl found")
+  else
+    vim.health.error("curl not found (required for server API calls)")
+  end
+  -- Check server status
+  if readit._server_port then
+    vim.health.ok("Server running on port " .. readit._server_port)
+  else
+    vim.health.info("Server not running (will start on :ReaditOpen)")
+  end
+  -- Check for comments directory
+  local comments_dir = vim.fn.expand("~/.readit/comments")
+  if vim.fn.isdirectory(comments_dir) == 1 then
+    local count = #vim.fn.glob(comments_dir .. "/**/*.comments.md", false, true)
+    vim.health.ok("Comments directory exists (" .. count .. " comment files)")
+  else
+    vim.health.info("No comments directory yet (~/.readit/comments/)")
+  end
+end
+return M

package/nvim-readit/lua/readit/init.lua ADDED Viewed

@@ -0,0 +1,463 @@
+-- readit.nvim — Neovim plugin for rendering Markdown with readit
+--
+-- Manages a readit server process and opens documents in the browser
+-- or a split terminal. Supports live-reload: edits in Neovim are
+-- reflected in the browser automatically (via readit's file watcher).
+local M = {}
+--- @class ReaditConfig
+--- @field bun_path string Path to bun executable
+--- @field port number Preferred server port (0 = auto)
+--- @field host string Server host
+--- @field auto_open boolean Open browser automatically
+--- @field auto_reload boolean Auto-reload on BufWritePost (enabled by default via readit's fs watcher)
+--- @field open_cmd string|nil Custom browser open command
+--- @field keymap_prefix string Key prefix for mappings
+--- @field keymaps table<string, string|false> Keymap overrides (false to disable)
+--- @field float_opts table Floating window options for terminal
+--- @type ReaditConfig
+M.config = {
+  bun_path = "bun",
+  port = 0,
+  host = "127.0.0.1",
+  auto_open = true,
+  auto_reload = true,
+  open_cmd = nil,
+  keymap_prefix = "<leader>r",
+  keymaps = {
+    open = "o",        -- Open current file in readit
+    open_side = "s",   -- Open in side browser (if available)
+    stop = "q",        -- Stop the server
+    status = "i",      -- Show server status
+    reload = "r",      -- Force reload in browser
+    list = "l",        -- List commented files
+  },
+  float_opts = {
+    relative = "editor",
+    width = 0.8,
+    height = 0.8,
+    border = "rounded",
+  },
+}
+--- @type number|nil
+M._server_port = nil
+--- @type number|nil
+M._server_job_id = nil
+--- @type table<string, boolean>
+M._attached_files = {}
+-- ── Setup ────────────────────────────────────────────────────────────
+--- Setup the plugin with user configuration
+--- @param opts? ReaditConfig
+--- @type boolean
+M._setup_done = false
+function M.setup(opts)
+  M.config = vim.tbl_deep_extend("force", M.config, opts or {})
+  M._setup_commands()
+  M._setup_keymaps()
+  M._setup_autocmds()
+  M._setup_done = true
+end
+-- ── Server Management ────────────────────────────────────────────────
+--- Discover an already-running readit server from ~/.readit/server.json
+--- @return {port: number, pid: number}|nil
+function M._discover_server()
+  local path = vim.fn.expand("~/.readit/server.json")
+  local ok, content = pcall(vim.fn.readfile, path)
+  if not ok or #content == 0 then
+    return nil
+  end
+  local decoded = vim.json.decode(table.concat(content, "\n"))
+  if not decoded or not decoded.port or not decoded.pid then
+    return nil
+  end
+  -- Check if the process is alive
+  local alive = vim.fn.system("kill -0 " .. decoded.pid .. " 2>/dev/null; echo $?")
+  if vim.trim(alive) ~= "0" then
+    return nil
+  end
+  -- Health check
+  local health = vim.fn.system(
+    "curl -sf http://127.0.0.1:" .. decoded.port .. "/api/health 2>/dev/null"
+  )
+  if health == "" or vim.v.shell_error ~= 0 then
+    return nil
+  end
+  return decoded
+end
+--- Start the readit server for a given file
+--- @param file_path string Absolute path to the markdown file
+--- @param callback? fun(port: number) Called when server is ready
+function M.start_server(file_path, callback)
+  -- Check for existing server first
+  local existing = M._discover_server()
+  if existing then
+    M._server_port = existing.port
+    M._attach_file(file_path, callback)
+    return
+  end
+  -- If we already have a running job, attach to it
+  if M._server_job_id and vim.fn.jobwait({ M._server_job_id }, 0)[1] == -1 then
+    if M._server_port then
+      M._attach_file(file_path, callback)
+      return
+    end
+  end
+  local port = M.config.port
+  local args = {
+    M.config.bun_path,
+    "run",
+    "--bun",
+    vim.fn.expand("~/.readit/dist/index.js"),  -- Try installed version first
+    file_path,
+    "--no-open",
+  }
+  -- Check if the global dist exists; otherwise try npx
+  if vim.fn.filereadable(vim.fn.expand("~/.readit/dist/index.js")) == 0 then
+    -- Try to find readit in the project or globally
+    local readit_bin = vim.fn.exepath("readit")
+    if readit_bin ~= "" then
+      args = { readit_bin, file_path, "--no-open" }
+    else
+      -- Fall back to bunx
+      args = { M.config.bun_path .. "x", "@peaske7/readit", file_path, "--no-open" }
+    end
+  end
+  if port > 0 then
+    table.insert(args, "--port")
+    table.insert(args, tostring(port))
+  end
+  vim.notify("readit: starting server...", vim.log.levels.INFO)
+  M._server_job_id = vim.fn.jobstart(args, {
+    on_stdout = function(_, data)
+      for _, line in ipairs(data) do
+        -- Parse the URL from server output
+        local found_port = line:match("URL:%s*http://[^:]+:(%d+)")
+        if found_port then
+          M._server_port = tonumber(found_port)
+          M._attached_files[file_path] = true
+          vim.notify("readit: server ready on port " .. M._server_port, vim.log.levels.INFO)
+          if callback then
+            vim.schedule(function()
+              callback(M._server_port)
+            end)
+          end
+        end
+      end
+    end,
+    on_stderr = function(_, data)
+      for _, line in ipairs(data) do
+        if line ~= "" then
+          vim.notify("readit: " .. line, vim.log.levels.WARN)
+        end
+      end
+    end,
+    on_exit = function(_, code)
+      M._server_job_id = nil
+      M._server_port = nil
+      M._attached_files = {}
+      if code ~= 0 then
+        vim.notify("readit: server exited with code " .. code, vim.log.levels.ERROR)
+      end
+    end,
+    detach = false,
+  })
+  if M._server_job_id <= 0 then
+    vim.notify("readit: failed to start server", vim.log.levels.ERROR)
+    M._server_job_id = nil
+  end
+end
+--- Attach a file to the running server via HTTP API
+--- @param file_path string
+--- @param callback? fun(port: number)
+function M._attach_file(file_path, callback)
+  if M._attached_files[file_path] then
+    if callback and M._server_port then
+      callback(M._server_port)
+    end
+    return
+  end
+  if not M._server_port then
+    vim.notify("readit: no server running", vim.log.levels.WARN)
+    return
+  end
+  local cmd = string.format(
+    'curl -sf -X POST -H "Content-Type: application/json" -d \'{"path":"%s"}\' http://127.0.0.1:%d/api/documents 2>/dev/null',
+    file_path:gsub("'", "'\\''"),
+    M._server_port
+  )
+  vim.fn.jobstart({ "sh", "-c", cmd }, {
+    on_exit = function(_, code)
+      if code == 0 then
+        M._attached_files[file_path] = true
+        vim.schedule(function()
+          if callback and M._server_port then
+            callback(M._server_port)
+          end
+        end)
+      else
+        vim.schedule(function()
+          vim.notify("readit: failed to attach file", vim.log.levels.ERROR)
+        end)
+      end
+    end,
+  })
+end
+--- Stop the readit server
+function M.stop_server()
+  if M._server_job_id then
+    vim.fn.jobstop(M._server_job_id)
+    M._server_job_id = nil
+    M._server_port = nil
+    M._attached_files = {}
+    vim.notify("readit: server stopped", vim.log.levels.INFO)
+  else
+    vim.notify("readit: no server running", vim.log.levels.INFO)
+  end
+end
+--- Get server status info
+--- @return string
+function M.server_status()
+  if M._server_port then
+    local files = vim.tbl_keys(M._attached_files)
+    return string.format(
+      "readit server running on port %d (%d file%s)",
+      M._server_port,
+      #files,
+      #files == 1 and "" or "s"
+    )
+  end
+  return "readit server not running"
+end
+-- ── Actions ──────────────────────────────────────────────────────────
+--- Open the current markdown buffer in readit
+--- @param opts? {browser?: boolean}
+function M.open(opts)
+  opts = opts or { browser = true }
+  local bufname = vim.api.nvim_buf_get_name(0)
+  if bufname == "" then
+    vim.notify("readit: buffer has no file", vim.log.levels.WARN)
+    return
+  end
+  if not bufname:match("%.md$") and not bufname:match("%.markdown$") then
+    vim.notify("readit: not a markdown file", vim.log.levels.WARN)
+    return
+  end
+  -- Save the buffer first to ensure file watcher picks up latest
+  if vim.bo.modified then
+    vim.cmd("write")
+  end
+  local file_path = vim.fn.fnamemodify(bufname, ":p")
+  M.start_server(file_path, function(port)
+    if opts.browser and M.config.auto_open then
+      M._open_browser(port)
+    end
+  end)
+end
+--- Open the browser to the readit server
+--- @param port number
+function M._open_browser(port)
+  local url = "http://" .. M.config.host .. ":" .. port
+  if M.config.open_cmd then
+    vim.fn.system(M.config.open_cmd .. " " .. vim.fn.shellescape(url))
+    return
+  end
+  -- Platform-specific open
+  local open_cmd
+  if vim.fn.has("mac") == 1 then
+    open_cmd = "open"
+  elseif vim.fn.has("unix") == 1 then
+    open_cmd = "xdg-open"
+  elseif vim.fn.has("win32") == 1 then
+    open_cmd = "start"
+  end
+  if open_cmd then
+    vim.fn.jobstart({ open_cmd, url }, { detach = true })
+  end
+end
+--- Force reload the current document in the browser
+function M.reload()
+  if not M._server_port then
+    vim.notify("readit: no server running", vim.log.levels.WARN)
+    return
+  end
+  -- Save first so the file watcher triggers reload
+  if vim.bo.modified then
+    vim.cmd("write")
+  end
+  vim.notify("readit: document will reload via file watcher", vim.log.levels.INFO)
+end
+--- List files with comments (in a floating window)
+function M.list_comments()
+  local comments_dir = vim.fn.expand("~/.readit/comments")
+  if vim.fn.isdirectory(comments_dir) == 0 then
+    vim.notify("readit: no comments found", vim.log.levels.INFO)
+    return
+  end
+  local cmd = string.format(
+    "grep -rh '^source:' %s 2>/dev/null | sed 's/^source: *//' | sort -u",
+    vim.fn.shellescape(comments_dir)
+  )
+  local result = vim.fn.system(cmd)
+  local files = vim.split(vim.trim(result), "\n", { trimempty = true })
+  if #files == 0 then
+    vim.notify("readit: no comments found", vim.log.levels.INFO)
+    return
+  end
+  vim.ui.select(files, {
+    prompt = "readit: files with comments",
+    format_item = function(item)
+      return vim.fn.fnamemodify(item, ":~:.")
+    end,
+  }, function(choice)
+    if choice then
+      vim.cmd("edit " .. vim.fn.fnameescape(choice))
+      M.open()
+    end
+  end)
+end
+-- ── Commands ─────────────────────────────────────────────────────────
+function M._setup_commands()
+  vim.api.nvim_create_user_command("ReaditOpen", function()
+    M.open()
+  end, { desc = "Open current markdown file in readit" })
+  vim.api.nvim_create_user_command("ReaditStop", function()
+    M.stop_server()
+  end, { desc = "Stop the readit server" })
+  vim.api.nvim_create_user_command("ReaditStatus", function()
+    vim.notify(M.server_status(), vim.log.levels.INFO)
+  end, { desc = "Show readit server status" })
+  vim.api.nvim_create_user_command("ReaditReload", function()
+    M.reload()
+  end, { desc = "Reload current document in readit" })
+  vim.api.nvim_create_user_command("ReaditList", function()
+    M.list_comments()
+  end, { desc = "List files with readit comments" })
+  vim.api.nvim_create_user_command("ReaditOpenFile", function(cmd_opts)
+    local file = cmd_opts.args
+    if file == "" then
+      vim.notify("readit: specify a file path", vim.log.levels.WARN)
+      return
+    end
+    local abs = vim.fn.fnamemodify(file, ":p")
+    M.start_server(abs, function(port)
+      if M.config.auto_open then
+        M._open_browser(port)
+      end
+    end)
+  end, {
+    nargs = 1,
+    complete = function(_, cmd_line, _)
+      -- Complete markdown files
+      local files = vim.fn.glob("**/*.md", false, true)
+      local markdown_files = vim.fn.glob("**/*.markdown", false, true)
+      vim.list_extend(files, markdown_files)
+      return files
+    end,
+    desc = "Open a specific file in readit",
+  })
+end
+-- ── Keymaps ──────────────────────────────────────────────────────────
+function M._setup_keymaps()
+  local prefix = M.config.keymap_prefix
+  local maps = M.config.keymaps
+  local function map(suffix, action, desc)
+    if suffix == false then
+      return
+    end
+    vim.keymap.set("n", prefix .. suffix, action, {
+      desc = "readit: " .. desc,
+      silent = true,
+    })
+  end
+  if maps.open then
+    map(maps.open, function() M.open() end, "Open in readit")
+  end
+  if maps.open_side then
+    map(maps.open_side, function() M.open({ browser = true }) end, "Open in browser")
+  end
+  if maps.stop then
+    map(maps.stop, function() M.stop_server() end, "Stop server")
+  end
+  if maps.status then
+    map(maps.status, function() vim.notify(M.server_status()) end, "Server status")
+  end
+  if maps.reload then
+    map(maps.reload, function() M.reload() end, "Reload document")
+  end
+  if maps.list then
+    map(maps.list, function() M.list_comments() end, "List commented files")
+  end
+end
+-- ── Autocommands ─────────────────────────────────────────────────────
+function M._setup_autocmds()
+  local group = vim.api.nvim_create_augroup("readit", { clear = true })
+  -- Clean up server on Neovim exit
+  vim.api.nvim_create_autocmd("VimLeavePre", {
+    group = group,
+    callback = function()
+      if M._server_job_id then
+        vim.fn.jobstop(M._server_job_id)
+      end
+    end,
+  })
+end
+return M

package/nvim-readit/plugin/readit.lua ADDED Viewed

@@ -0,0 +1,19 @@
+-- readit.nvim plugin loader
+-- Auto-loaded by Neovim's plugin system
+if vim.g.loaded_readit then
+  return
+end
+vim.g.loaded_readit = true
+-- The plugin is configured via require("readit").setup({...}).
+-- If the user hasn't called setup() (e.g. lazy.nvim with `ft`-trigger
+-- and no `config`), bootstrap with defaults on the next event-loop
+-- tick so any explicit setup({...}) in user config wins, but commands
+-- and keymaps still register out of the box.
+vim.schedule(function()
+  local ok, readit = pcall(require, "readit")
+  if ok and not readit._setup_done then
+    readit.setup()
+  end
+end)