@commte/mdbrowse 0.3.0 → 0.3.2

package/README.ja.md

@@ -59,7 +59,7 @@ mdb
 
 プレビュー用のタブが開き、小さな背景プロセスが動きだす。以後どの Markdown を保存しても、どのプロジェクトのものでも、そのタブに出る。止めるときは `mdb --stop`、再開はまた `mdb`
 
-ログアウトや再起動で消える。macOS なら、勝手に戻ってくるようにもできる
+ログアウトや再起動で消えるので、そのままだと次に使うときにもう一度 `mdb` を叩くことになる。macOS なら、勝手に戻ってくるようにもできる
 
 ```sh
 mdb --install-agent
@@ -186,6 +186,14 @@ vim.api.nvim_create_autocmd("BufWritePost", {
 mdb sample.md
 ```
 
+## テスト
+
+```sh
+npm test
+```
+
+`test/cli.sh` はコマンド側を動かす。変換、相対パスの書き換え、異常系、監視、背景プロセスまで通す。必要なのは pandoc だけ。`test/browser.test.js` は `assets/head.html` からスクリプトを取り出して jsdom で動かし、更新の検知、目次の判定、バーの設定を見る。CI では macOS と Linux の両方で回していて、通らないものは公開されない
+
 ## 仕組み
 
 ```

package/README.md

@@ -59,7 +59,7 @@ mdb
 
 That opens the preview tab and starts a small background process. Save any Markdown file from here on and it shows up in that tab, whichever project it lives in. `mdb --stop` ends it; `mdb` starts it again.
 
-The process is gone after a logout or a reboot. On macOS you can have it come back on its own:
+The process is gone after a logout or a reboot, so otherwise you run `mdb` again next time. On macOS you can have it come back on its own:
 
 ```sh
 mdb --install-agent
@@ -186,6 +186,14 @@ Everything else visual lives in `~/.config/mdbrowse/head.html`: a settings block
 mdb sample.md
 ```
 
+## Tests
+
+```sh
+npm test
+```
+
+`test/cli.sh` drives the command itself — rendering, path rewriting, exit codes, watching, the background sync — and needs nothing but pandoc. `test/browser.test.js` pulls the script out of `assets/head.html` and runs it under jsdom, covering the reload loop, the table of contents rules and the settings bar. Both run on macOS and Linux in CI, and a release only goes out if they pass.
+
 ## How it works
 
 ```

package/assets/head.html

@@ -351,6 +351,6 @@
       if (printing || (hoverable && bar.matches(':hover'))) return;
       if (Date.now() - lastScroll < 900) return;
       checkStamp();
-    }, 1000);
+    }, 250);
   });
 </script>

package/bin/mdbrowse

@@ -3,7 +3,7 @@
 # browser tab can stay open and just swap its contents.
 set -euo pipefail
 
-VERSION="0.3.0"
+VERSION="0.3.2"
 PROG="$(basename "$0")"
 OUT="${MDBROWSE_OUT:-/tmp/mdbrowse.html}"
 case "$OUT" in
@@ -141,6 +141,17 @@ stop_sync() {
   if [ "$stopped" -eq 1 ]; then echo "$PROG: stopped"; else echo "$PROG: not running"; fi
 }
 
+# ログイン時の自動起動があることを、初回だけ1行で知らせる。
+# 毎回出すと邪魔になるので、一度出したら記録して黙る
+hint_agent() {
+  [ "$(uname -s)" = "Darwin" ] || return 0
+  agent_installed && return 0
+  [ -f "$RUNTIME_DIR/agent-hint" ] && return 0
+  mkdir -p "$RUNTIME_DIR" 2>/dev/null || true
+  : > "$RUNTIME_DIR/agent-hint" 2>/dev/null || true
+  echo "$PROG: it stops at logout — 'mdb --install-agent' starts it at every login"
+}
+
 start_sync() {
   if running_pid >/dev/null; then
     echo "$PROG: already in sync (mdb --stop to end it)"
@@ -156,6 +167,7 @@ start_sync() {
   done
   if running_pid >/dev/null; then
     echo "$PROG: in sync — save any .md and it shows up here (mdb --stop to end it)"
+    hint_agent
   else
     echo "$PROG: could not start the background sync (see $LOGFILE)" >&2
     return 1
@@ -459,16 +471,18 @@ if [ "$daemon" -eq 1 ]; then
   # 変換の失敗は画面に出ないので、ログに残す
   log() { printf '%s %s\n' "$(date '+%Y-%m-%d %H:%M:%S')" "$1" >> "$LOGFILE"; }
 
-  # Spotlight を使えない場合は木を歩く。大きな木では間隔を伸ばす
-  scan_gap=2
+  # 表示中のファイルは 0.25 秒ごとに見る。1周 = 0.25 秒
+  TICK=0.25
+  # Spotlight への問い合わせは 2 秒ごと（8周に1回）
+  scan_gap=8
   if [ "$use_spotlight" -eq 0 ]; then
     t0="$(perl -MTime::HiRes=time -e 'printf "%d", time*1000')"
     newest_md "$root" >/dev/null
     t1="$(perl -MTime::HiRes=time -e 'printf "%d", time*1000')"
-    scan_gap=$(( ( (t1 - t0) * 5 + 999) / 1000 ))
-    [ "$scan_gap" -lt 2 ] && scan_gap=2
-    [ "$scan_gap" -gt 10 ] && scan_gap=10
-    log "watching $root every ${scan_gap}s (no Spotlight)"
+    scan_gap=$(( ( (t1 - t0) * 5 + 249) / 250 ))
+    [ "$scan_gap" -lt 8 ] && scan_gap=8
+    [ "$scan_gap" -gt 40 ] && scan_gap=40
+    log "watching $root every $(( scan_gap / 4 ))s (no Spotlight)"
   fi
 
   src="$(pick)"
@@ -476,7 +490,7 @@ if [ "$daemon" -eq 1 ]; then
   last="$src $(fingerprint "$src") $(fingerprint "$HEAD")"
   # 開いているファイルの保存は毎秒見る。別ファイルへの切り替えの検出は2秒ごと
   tick=0
-  while sleep 1; do
+  while sleep "$TICK"; do
     tick=$(( tick + 1 ))
     if [ $(( tick % scan_gap )) -eq 0 ]; then
       cand="$(pick)"
@@ -508,7 +522,7 @@ render
 if [ "$watch" -eq 1 ]; then
   # ディレクトリを見る場合、木が大きいと走査が重い。1回の走査時間から
   # 待ち時間を決めて、CPU を食い潰さないようにする
-  interval=1
+  interval=0.25
   if [ -n "$root" ]; then
     t0="$(perl -MTime::HiRes=time -e 'printf "%d", time*1000')"
     newest_md "$root" >/dev/null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commte/mdbrowse",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Preview the Markdown file you are editing in a real browser, with your own CSS, from any editor that can run a shell command. No server, no port.",
   "bin": {
     "mdbrowse": "bin/mdbrowse",
@@ -15,6 +15,11 @@
     "README.ja.md",
     "LICENSE"
   ],
+  "scripts": {
+    "test": "bash test/cli.sh && vitest run",
+    "test:cli": "bash test/cli.sh",
+    "test:browser": "vitest run"
+  },
   "keywords": [
     "markdown",
     "preview",
@@ -43,5 +48,9 @@
   },
   "dependencies": {
     "shiki": "^4.4.3"
+  },
+  "devDependencies": {
+    "jsdom": "^30.0.1",
+    "vitest": "^5.0.0"
   }
 }