@peaske7/readit 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peaske7/readit",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A CLI tool to review Markdown documents with inline comments",
   "author": "Jay Shimada <peaske@pm.me>",
   "license": "MIT",
@@ -17,7 +17,7 @@
     "dev": "NODE_ENV=development bun --watch src/cli.ts --",
     "dev:client": "bunx vite",
     "build": "bunx vite build && bun run build:cli",
-    "build:cli": "NODE_ENV=production bun build src/cli.ts --outdir dist --target bun --format esm --packages external",
+    "build:cli": "NODE_ENV=production bun build src/cli.ts --outfile dist/index.js --target bun --format esm --packages external",
     "start": "bun run build && bun dist/index.js",
     "test": "vitest run",
     "bench": "vitest bench",
@@ -36,37 +36,29 @@
   "dependencies": {
     "clsx": "^2.1.1",
     "commander": "^14.0.3",
-    "lucide-react": "^0.577.0",
-    "mermaid": "^11.13.0",
+    "lucide-svelte": "^0.577.0",
+    "markdown-it": "^14.1.1",
+    "mermaid": "^11.14.0",
     "open": "^11.0.0",
-    "react-markdown": "^10.1.0",
-    "react-syntax-highlighter": "^16.1.1",
-    "rehype-raw": "^7.0.0",
-    "remark-gfm": "^4.0.1",
-    "sonner": "^2.0.7",
-    "tailwind-merge": "^3.5.0",
-    "zod": "^4.3.6",
-    "zustand": "^5.0.12"
+    "jsdom": "^28.1.0",
+    "shiki": "^4.0.2",
+    "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.9",
-    "@playwright/test": "^1.58.2",
-    "@tailwindcss/vite": "^4.2.2",
+    "@biomejs/biome": "^2.4.15",
+    "@playwright/test": "^1.59.1",
+    "@sveltejs/vite-plugin-svelte": "^5.1.1",
+    "@tailwindcss/vite": "^4.3.0",
     "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.2",
-    "@types/bun": "^1.3.11",
+    "@types/bun": "^1.3.13",
     "@types/jsdom": "^28.0.1",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "@types/react-syntax-highlighter": "^15.5.13",
-    "@vitejs/plugin-react": "^6.0.1",
-    "jsdom": "^28.1.0",
-    "lefthook": "^2.1.4",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "tailwindcss": "^4.2.2",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^25.6.2",
+    "lefthook": "^2.1.6",
+    "svelte": "^5.55.5",
+    "tailwindcss": "^4.3.0",
     "typescript": "^5.9.3",
-    "vite": "^8.0.3",
-    "vitest": "^4.1.1"
+    "vite": "^8.0.11",
+    "vitest": "^4.1.5"
   }
 }

package/shell/_readit

@@ -0,0 +1,158 @@
+#compdef readit
+
+# Zsh completion for readit - Markdown document review CLI
+#
+# Provides:
+#   1. Standard subcommand/option completion (readit <TAB>)
+#   2. @-prefix file completion with [bracket] display (readit @<TAB>)
+#
+# Install: add to $fpath or source via `readit completion zsh`
+
+# ── Helpers ────────────────────────────────────────────────────────────
+
+# Collect markdown files using fd (fast) or find (fallback)
+_readit_collect_md_files() {
+  local fd_cmd="$(command -v fdfind 2>/dev/null || command -v fd 2>/dev/null)"
+  if [[ -n "$fd_cmd" ]]; then
+    "$fd_cmd" --type f --hidden --exclude .git \
+      --extension md --extension markdown 2>/dev/null
+  else
+    find . -type f \( -name '*.md' -o -name '*.markdown' \) \
+      -not -path '*/\.*' \
+      -not -path '*/node_modules/*' \
+      -not -path '*/.next/*' \
+      -not -path '*/dist/*' \
+      2>/dev/null | sed 's|^\./||'
+  fi
+}
+
+# Standard markdown file completion (no @ prefix, no brackets)
+_readit_markdown_files() {
+  local -a files
+  files=( ${(f)"$(_readit_collect_md_files)"} )
+  (( ${#files} )) && _describe -t files 'markdown files' files
+}
+
+# @ prefix file completion with [bracket] display
+# Renders a native multi-column grid of [file.md] entries
+_readit_at_files() {
+  local current="${PREFIX}${SUFFIX}"
+
+  # Strip the leading @
+  local filter="${current#@}"
+
+  # Collect all markdown files
+  local -a all_files
+  all_files=( ${(f)"$(_readit_collect_md_files)"} )
+  (( ${#all_files} )) || return 1
+
+  # Filter by case-insensitive substring match
+  local -a matches
+  if [[ -n "$filter" ]]; then
+    local lc_filter="${(L)filter}"
+    local f
+    for f in "${all_files[@]}"; do
+      [[ "${(L)f}" == *"$lc_filter"* ]] && matches+=("$f")
+    done
+  else
+    matches=("${all_files[@]}")
+  fi
+  (( ${#matches} )) || return 1
+
+  # Build display array: [file.md] and insertion values: @[file.md]
+  local -a display_items
+  local item
+  for item in "${matches[@]}"; do
+    display_items+=("@[${item}]")
+  done
+
+  # Use compadd:
+  #   -U  = don't verify matches against current word
+  #   -d  = display strings (the [bracketed] versions shown in the menu)
+  #   -Q  = don't quote completions
+  #   -S  = suffix after insertion (space)
+  #   -f  = treat as file names
+  # The inserted text is @[file.md] which gets stripped to file.md on Enter
+  # by the readit-accept-line widget in readit.zsh
+  compadd -U -Q -S ' ' -d display_items -a display_items
+}
+
+_readit_commented_files() {
+  local readit_dir="${HOME}/.readit/comments"
+  if [[ ! -d "$readit_dir" ]]; then
+    return 1
+  fi
+  local -a sources
+  sources=( ${(f)"$(grep -rh '^source:' "$readit_dir" 2>/dev/null | sed 's/^source: *//')"} )
+  if (( ${#sources} )); then
+    _describe -t files 'files with comments' sources
+  fi
+}
+
+# ── Main Completion ────────────────────────────────────────────────────
+
+_readit() {
+  local context state state_descr line
+  typeset -A opt_args
+
+  # Check if the current word starts with @
+  local current="${PREFIX}${SUFFIX}"
+  if [[ "$current" == @* ]]; then
+    _readit_at_files
+    return
+  fi
+
+  _arguments -C \
+    '1:command:->cmd_or_files' \
+    '*::arg:->args'
+
+  case "$state" in
+    cmd_or_files)
+      local -a commands
+      commands=(
+        'open:Add files to a running server or start a new one'
+        'list:List all files with comments'
+        'show:Show comments for a file'
+        'completion:Output shell completion script'
+      )
+      _alternative \
+        'commands:command:compadd -a commands' \
+        'files:markdown file:_readit_markdown_files'
+      ;;
+    args)
+      case "${line[1]}" in
+        open)
+          _arguments \
+            '-p[Port for new server]:port:' \
+            '--port[Port for new server]:port:' \
+            '--host[Host for new server]:host:' \
+            '*:file:_readit_markdown_files'
+          ;;
+        show)
+          _arguments \
+            '1:file:_readit_commented_files'
+          ;;
+        list)
+          # No arguments
+          ;;
+        completion)
+          local -a shells
+          shells=(zsh bash fish)
+          _describe -t shells 'shell' shells
+          ;;
+        *)
+          # Default command: [files...] with options
+          _arguments \
+            '-p[Port to run server on]:port:' \
+            '--port[Port to run server on]:port:' \
+            '--host[Host address to bind to]:host:' \
+            '--no-open[Do not automatically open browser]' \
+            '--clean[Clear all existing comments on startup]' \
+            '*:file:_readit_markdown_files'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_readit "$@"

package/shell/readit.zsh

@@ -0,0 +1,87 @@
+#!/usr/bin/env zsh
+
+# readit.zsh — Rich zsh integration for readit
+#
+# Provides @-prefix file autocomplete using zsh's native completion menu,
+# rendering markdown file matches in a multi-column [bracketed] grid
+# directly below the prompt — like Forge Code / Claude Code.
+#
+# The heavy lifting is in the _readit compdef (shell/_readit) which uses
+# compadd to render [file.md] entries. This file adds:
+#   - Accept-line handler to strip @[...] brackets before execution
+#   - Syntax highlighting for @[...] references (cyan bold)
+#   - Completion system setup (loads _readit into fpath)
+#
+# Usage:
+#   eval "$(readit completion zsh)"
+#
+# This gives you:
+#   readit @<TAB>           → native multi-column grid of markdown files
+#   readit @test<TAB>       → grid filtered to files matching "test"
+#   readit @docs/<TAB>      → grid filtered to files matching "docs/"
+#   readit open @<TAB>      → same, works with subcommands
+#   readit <TAB>            → standard subcommand/option completion
+
+# ── Guard ──────────────────────────────────────────────────────────────
+(( $+functions[_readit_plugin_loaded] )) && return 0
+_readit_plugin_loaded() { :; }
+
+# ── Accept Line: Strip @[...] Brackets ────────────────────────────────
+#
+# When Enter is pressed, convert @[file.md] references to bare file.md
+# paths before executing. This lets the bracket syntax be a visual aid
+# on the prompt without affecting the actual command arguments.
+
+function readit-accept-line() {
+  if [[ "$BUFFER" == *'@['* ]]; then
+    local result="" rest="$BUFFER"
+    while [[ "$rest" == *'@['* ]]; do
+      result+="${rest%%@\[*}"
+      rest="${rest#*@\[}"
+      if [[ "$rest" == *']'* ]]; then
+        result+="${rest%%\]*}"
+        rest="${rest#*\]}"
+      else
+        result+="@[${rest}"
+        rest=""
+      fi
+    done
+    result+="$rest"
+    BUFFER="$result"
+  fi
+  zle accept-line
+}
+
+zle -N readit-accept-line
+bindkey '^M' readit-accept-line
+bindkey '^J' readit-accept-line
+
+# ── Syntax Highlighting ───────────────────────────────────────────────
+# Highlight @[...] references in cyan bold (requires zsh-syntax-highlighting)
+
+if (( $+ZSH_HIGHLIGHT_PATTERNS )); then
+  ZSH_HIGHLIGHT_PATTERNS+=('@\[[^\]]*\]' 'fg=cyan,bold')
+  ZSH_HIGHLIGHT_HIGHLIGHTERS+=(pattern)
+fi
+
+# ── Completion Setup ──────────────────────────────────────────────────
+# Load _readit compdef into fpath so Tab triggers native @ completion
+
+_readit_setup_completion() {
+  local comp_dir="${0:A:h}"
+
+  if [[ -f "${comp_dir}/_readit" ]]; then
+    fpath=("$comp_dir" $fpath)
+  fi
+
+  autoload -Uz compinit
+  if (( ! $+functions[_readit] )); then
+    compinit -C 2>/dev/null
+  fi
+}
+
+_readit_setup_completion
+
+# ── Convenience ───────────────────────────────────────────────────────
+
+alias ri='readit'