rvpm 3.29.1

// プラグインの `plugin/`, `ftplugin/`, `after/plugin/`, `lua/` ディレクトリを
// 静的スキャンして、user-facing な hook 情報を集める:
//
//   - `commands`     : `nvim_create_user_command("Foo", ...)` / `command! Foo`
//   - `user_maps`    : `nnoremap gc ...` / `vim.keymap.set("n", "gc", ...)` 等、
//                       **`<Plug>(...)` LHS は除外**した「user が直接押すキー」
//   - `plug_maps`    : `<Plug>(Foo)` 形式 LHS のみ。プラグインが exposing する
//                       `<Plug>` バインディング一覧。
//   - `user_events`  : プラグインが `nvim_exec_autocmds("User", {pattern = "X"})`
//                       / `doautocmd User X` で fire する User event 名
//
// 用途:
//   - `on_cmd` の `/regex/` 展開 (#86, shipped) — `commands` を消費
//   - `on_map` の `/regex/` 展開 (#88) — `plug_maps` を消費
//   - `on_event` の `/User .../` 展開 (#88) — `user_events` を消費
//   - `rvpm add` 自動 lazy 提案 (#87 UI) — `commands` + `user_maps` を消費
//
// 制約:
//   - 動的定義 (computed name, setup() 内定義で setup 未呼出) は拾えない。
//     これらは user が exact 名を手書きする想定。
//   - `<Plug>(...)` LHS は user-entry ではないので user_maps から弾き、専用
//     フィールド `plug_maps` に集める。
//   - On-event suggestion は deadlock 的制約があり、プラグインが **発火する側** の
//     User event を自身の lazy trigger にはできない (起動した瞬間まだ event は
//     fire されていない)。user_events は **他プラグインの** trigger として user が
//     `on_event = ["/User Foo.*/"]` と書くときの展開ソースとして使う。

use regex::Regex;
use std::collections::HashSet;
use std::path::{Path, PathBuf};
use std::sync::OnceLock;

/// user-facing キーマップ 1 件。
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct UserMap {
    pub lhs: String,
    pub modes: Vec<String>,
}

/// 1 プラグイン分のスキャン結果。各フィールドは順序保持 + dedup 済み (集約層)。
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct ScanResult {
    pub commands: Vec<String>,
    /// `<Plug>(...)` を **除いた** user-facing キーマップ。`#[87]` の auto-suggest
    /// (rvpm add) 用。
    pub user_maps: Vec<UserMap>,
    /// `<Plug>(...)` LHS のリスト。プラグインが exposing する `<Plug>` バインディング
    /// だけを集める。`#[88]` の `on_map = ["/^<Plug>(Foo/"]` 正規表現展開用。
    pub plug_maps: Vec<String>,
    pub user_events: Vec<String>,
}

/// スキャン対象の言語方言。`.lua` と `.vim` では regex も comment 規約も別物で、
/// 同じ buffer 上で両方を走らせると false positive が出る
/// (例: Lua の `noremap = true,` に Vim の `^\s*noremap\s+` regex が誤ヒット)。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Dialect {
    Lua,
    Vim,
}

impl Dialect {
    /// ファイル拡張子から方言を判定。`.lua` / `.vim` 以外は `None`。
    pub fn from_path(path: &Path) -> Option<Self> {
        match path.extension().and_then(|e| e.to_str()) {
            Some("lua") => Some(Dialect::Lua),
            Some("vim") => Some(Dialect::Vim),
            _ => None,
        }
    }
}

/// ソース文字列から 3 種類の hook 情報 (`commands` / `user_maps` / `user_events`)
/// を抽出する。出現順は保持、**重複除去は行わない** — 集約側 (`scan_files`) の責務。
///
/// `dialect` で走査戦略を切り替える:
///   - `Dialect::Lua`: `nvim_create_user_command(\n  "Foo", …)` のような複数行に
///     またがる call site が現代プラグインで一般的なので、**source buffer 全体
///     に対して regex 走査** する (`\s*` が改行を跨ぐ)。行コメント (`-- …`) は
///     事前に削除。
///   - `Dialect::Vim`: `command!` / `nnoremap` / `doautocmd` は言語仕様上 1 行完結。
///     line-based で走査し、Vim では `--` がコメントでないので**元の line を
///     そのまま使う** (コメント除去すると `echo '--'` の body を誤って切る)。
pub fn scan_source(src: &str, dialect: Dialect) -> ScanResult {
    let mut out = ScanResult::default();
    match dialect {
        Dialect::Lua => {
            // Lua: line-comment を削った buffer に multiline regex
            let lua_code = strip_lua_line_comments(src);
            scan_lua_commands(&lua_code, &mut out.commands);
            scan_lua_maps(&lua_code, &mut out.user_maps, &mut out.plug_maps);
            scan_lua_events(&lua_code, &mut out.user_events);
        }
        Dialect::Vim => {
            // Vim: 生の line (Vim では `--` はコメント扱いしない)
            for line in src.lines() {
                scan_vim_command(line, &mut out.commands);
                scan_vim_map(line, &mut out.user_maps, &mut out.plug_maps);
                scan_vim_event(line, &mut out.user_events);
            }
        }
    }
    out
}

/// Lua のコメントを削る。
///
/// 対象:
///   - 行コメント `-- …` — 行末まで削る。**文字列内の `--` は保護**する
///     (neorg の `"--- Quitting ---"` のような docstring 風 label で強制切断すると
///     string が未閉にズレ、後続の paren balance が狂って buffer-local 検出が壊れる)。
///   - ブロックコメント `--[[ … ]]` / `--[=*[ … ]=*]` — 複数行対応。
///     neorg や obsidian.nvim の header docstring (markdown を埋め込んだもの) が
///     この形式で書かれており、内部に live code に見える `vim.keymap.set(...)` の
///     example が埋まっている。削らないと user_maps に誤検出される。
///
/// `\n` は原則保持 (行番号・multiline regex マッチ位置を維持) するが、ブロック
/// コメント内の改行は削られる (空白 1 文字に置換)。regex は `\s*` を使うので
/// 内容が実コードと癒着する心配はない。
fn strip_lua_line_comments(src: &str) -> String {
    let bytes = src.as_bytes();
    let mut out = String::with_capacity(src.len());
    let mut in_str: Option<u8> = None;
    let mut escape = false;
    let mut i = 0;
    while i < bytes.len() {
        let c = bytes[i];
        if let Some(q) = in_str {
            // 文字列内: そのまま出力、閉じ引用符まで現状維持
            out.push(c as char);
            if escape {
                escape = false;
            } else if c == b'\\' {
                escape = true;
            } else if c == q {
                in_str = None;
            }
            i += 1;
            continue;
        }
        // 非文字列: `--[[` / `--[=*[` か `-- …` をまず確認
        if c == b'-' && i + 1 < bytes.len() && bytes[i + 1] == b'-' {
            let after_dashes = i + 2;
            // `--[=*[` の開始判定
            if after_dashes < bytes.len() && bytes[after_dashes] == b'[' {
                let mut level = 0usize;
                let mut j = after_dashes + 1;
                while j < bytes.len() && bytes[j] == b'=' {
                    level += 1;
                    j += 1;
                }
                if j < bytes.len() && bytes[j] == b'[' {
                    // `--[=^level[` 発見。対応する `]=^level]` まで skip
                    let start = j + 1;
                    let end = find_long_bracket_close(bytes, start, level);
                    let slice_end = end.unwrap_or(bytes.len());
                    // 空白 1 文字に置換 (regex ヒットしないように隔離)
                    out.push(' ');
                    i = slice_end;
                    continue;
                }
            }
            // 単純な行コメント `-- …` — 行末まで skip、`\n` は保持
            while i < bytes.len() && bytes[i] != b'\n' {
                i += 1;
            }
            continue;
        }
        // 文字列開始?
        if c == b'"' || c == b'\'' {
            in_str = Some(c);
        }
        out.push(c as char);
        i += 1;
    }
    out
}

/// Lua の long bracket `]=^level]` の終了位置 (最後の `]` の index) を返す。
/// 見つからなければ `None` (unterminated block comment → EOF 扱いで全部 skip)。
fn find_long_bracket_close(bytes: &[u8], from: usize, level: usize) -> Option<usize> {
    let mut i = from;
    while i < bytes.len() {
        if bytes[i] == b']' {
            // `]=^level]` パターンにマッチするか?
            let mut j = i + 1;
            let mut eq_count = 0usize;
            while j < bytes.len() && bytes[j] == b'=' {
                eq_count += 1;
                j += 1;
            }
            if eq_count == level && j < bytes.len() && bytes[j] == b']' {
                return Some(j + 1);
            }
        }
        i += 1;
    }
    None
}

/// ファイルパスのリストを読み込んで集約 + dedup した ScanResult を返す。
pub fn scan_files<P: AsRef<Path>>(paths: &[P]) -> ScanResult {
    let mut commands_seen: HashSet<String> = HashSet::new();
    let mut maps_seen: HashSet<(String, Vec<String>)> = HashSet::new();
    let mut plug_maps_seen: HashSet<String> = HashSet::new();
    let mut events_seen: HashSet<String> = HashSet::new();
    let mut agg = ScanResult::default();
    for p in paths {
        let path = p.as_ref();
        let Some(dialect) = Dialect::from_path(path) else {
            continue;
        };
        let Ok(src) = std::fs::read_to_string(path) else {
            continue;
        };
        let res = scan_source(&src, dialect);
        for c in res.commands {
            if commands_seen.insert(c.clone()) {
                agg.commands.push(c);
            }
        }
        for m in res.user_maps {
            let key = (m.lhs.clone(), m.modes.clone());
            if maps_seen.insert(key) {
                agg.user_maps.push(m);
            }
        }
        for p in res.plug_maps {
            if plug_maps_seen.insert(p.clone()) {
                agg.plug_maps.push(p);
            }
        }
        for e in res.user_events {
            if events_seen.insert(e.clone()) {
                agg.user_events.push(e);
            }
        }
    }
    agg
}

/// プラグイン root 配下のソースを走査。
/// 対象: `plugin/**`, `ftplugin/**`, `after/plugin/**`, `lua/**` の `.vim` / `.lua`。
///
/// `lua/` 追加により、modern plugin が setup() 内で `nvim_create_user_command` を
/// 定義する literal 定義を拾える (computed name は拾えない、制約として許容)。
pub fn scan_plugin(plugin_root: &Path) -> ScanResult {
    let mut files: Vec<PathBuf> = Vec::new();
    for sub in ["plugin", "ftplugin", "after/plugin", "lua"] {
        let dir = plugin_root.join(sub);
        if !dir.is_dir() {
            continue;
        }
        collect_scan_targets(&dir, &mut files);
    }
    scan_files(&files)
}

fn collect_scan_targets(dir: &Path, out: &mut Vec<PathBuf>) {
    let Ok(entries) = std::fs::read_dir(dir) else {
        return;
    };
    for entry in entries.flatten() {
        let path = entry.path();
        if path.is_dir() {
            collect_scan_targets(&path, out);
            continue;
        }
        let ext = path.extension().and_then(|e| e.to_str()).unwrap_or("");
        if ext == "vim" || ext == "lua" {
            out.push(path);
        }
    }
}

// ── Lua scanning (multiline buffer-wide regex) ──────────────────────────

/// Lua: `vim.api.nvim_create_user_command("Foo", …)` — 引数の改行対応。
fn lua_cmd_re() -> &'static Regex {
    static RE: OnceLock<Regex> = OnceLock::new();
    RE.get_or_init(|| {
        // `\s*` は改行含む (\s は \n にマッチ)。name は Vim の E183 に従い大文字始まり。
        Regex::new(r#"nvim_create_user_command\s*\(\s*["']([A-Z][A-Za-z0-9_]*)["']"#).unwrap()
    })
}

fn scan_lua_commands(code: &str, out: &mut Vec<String>) {
    for caps in lua_cmd_re().captures_iter(code) {
        out.push(caps[1].to_string());
    }
}

// ── Vim scanning (line-based) ───────────────────────────────────────────

fn scan_vim_command(line: &str, out: &mut Vec<String>) {
    // Vim script: `command! [-opts]* Foo ...` / `command [-opts]* Foo ...`
    //
    // Vim では `--` はコメントではないので、`command! Foo echo '--'` の本体も
    // そのまま渡される。strip_prefix で `command!` / `command ` の先頭を確認し、
    // その後のオプション (`-bang` / `-nargs=*` 等) を飛ばしてから command 名を取る。
    let trimmed = line.trim_start();
    let after_cmd = match trimmed
        .strip_prefix("command!")
        .or_else(|| trimmed.strip_prefix("command "))
    {
        Some(s) => s,
        None => return,
    };
    let mut rest = after_cmd.trim_start();
    while let Some(remaining) = rest.strip_prefix('-') {
        let end = remaining
            .find(char::is_whitespace)
            .unwrap_or(remaining.len());
        rest = remaining[end..].trim_start();
    }
    if let Some(name) = extract_ident(rest) {
        out.push(name);
    }
}

// ── keymap scanning (Lua = multiline regex, Vim = line-based) ──────────

/// Lua: `vim.keymap.set("n", "gc", …)` / `vim.api.nvim_set_keymap(…)` — 引数改行対応。
/// mode は複数文字可 (`"nv"`)、空文字可 (`""` → default)、bang 可 (`"!"` → i+c)。
fn lua_map_re() -> &'static Regex {
    static RE: OnceLock<Regex> = OnceLock::new();
    RE.get_or_init(|| {
        Regex::new(
            r#"vim\.(?:api\.nvim_set_keymap|keymap\.set)\s*\(\s*["'](?P<mode>[nvxiocstl!]*)["']\s*,\s*["'](?P<lhs>[^"']+)["']"#,
        )
        .unwrap()
    })
}

fn scan_lua_maps(code: &str, user: &mut Vec<UserMap>, plug: &mut Vec<String>) {
    for caps in lua_map_re().captures_iter(code) {
        let mode_str = caps.name("mode").map_or("", |m| m.as_str());
        let lhs = caps.name("lhs").map_or("", |m| m.as_str());
        if lhs.is_empty() {
            continue;
        }
        // buffer-local 判定: match 末尾 (lhs 閉じ引用符直後) から call の `)` までを
        // paren-balance で拾い、options テーブル内に `buffer = …` があれば skip。
        // aerial.nvim 等 plugin ウィンドウ内専用マップ (user-entry でも `<Plug>`-internal
        // でもない) の誤検出を防ぐため、両 sink で同じ filter を適用する。
        let match_end = caps.get(0).map_or(0, |m| m.end());
        if let Some(call_end) = find_lua_call_end(code, match_end)
            && has_buffer_option(&code[match_end..call_end])
        {
            continue;
        }
        if is_plug_lhs(lhs) {
            plug.push(lhs.to_string());
        } else {
            user.push(UserMap {
                lhs: lhs.to_string(),
                modes: lua_mode_string_to_list(mode_str),
            });
        }
    }
}

/// `(` が既に開いている状態で呼び出し、残りの buffer から対応する `)` 位置を返す。
/// 文字列 (`"..."` / `'...'`) 内の paren は無視。閉じ paren が見つからなければ `None`。
fn find_lua_call_end(code: &str, from: usize) -> Option<usize> {
    let bytes = code.as_bytes();
    let mut depth: i32 = 1; // 既に open paren を消費済み (regex 側で `(` を matched)
    let mut in_str: Option<u8> = None;
    let mut escape = false;
    let mut i = from;
    while i < bytes.len() {
        let c = bytes[i];
        if let Some(q) = in_str {
            if escape {
                escape = false;
            } else if c == b'\\' {
                escape = true;
            } else if c == q {
                in_str = None;
            }
        } else {
            match c {
                b'"' | b'\'' => in_str = Some(c),
                b'(' => depth += 1,
                b')' => {
                    depth -= 1;
                    if depth == 0 {
                        return Some(i);
                    }
                }
                _ => {}
            }
        }
        i += 1;
    }
    None
}

/// options テーブル内に `buffer` キー (`buffer = …` / `["buffer"] = …`) があるか。
/// `vim.keymap.set("n", "q", rhs, { buffer = bufnr })` の判定に使う。
fn has_buffer_option(segment: &str) -> bool {
    static RE: OnceLock<Regex> = OnceLock::new();
    let re = RE.get_or_init(|| Regex::new(r#"(?:^|[\s,{])buffer\s*="#).unwrap());
    re.is_match(segment)
}

/// Vim の `{nvim}_mode_list` 変換規則に合わせる:
///   ""  → ["n","v","o"] (bare `:map` 相当)
///   "!" → ["i","c"]     (`:map!` 相当)
///   "nv" → ["n","v"]    (各文字をばらす)
fn lua_mode_string_to_list(mode_str: &str) -> Vec<String> {
    if mode_str.is_empty() {
        vec!["n".into(), "v".into(), "o".into()]
    } else if mode_str == "!" {
        vec!["i".into(), "c".into()]
    } else {
        mode_str.chars().map(|c| c.to_string()).collect()
    }
}

fn vim_map_re() -> &'static Regex {
    static RE: OnceLock<Regex> = OnceLock::new();
    RE.get_or_init(|| {
        Regex::new(r"^\s*(?P<prefix>[nvxiocstl]?)(?P<kind>noremap|map)(?P<bang>!?)\s+(?P<rest>.+)$")
            .unwrap()
    })
}

fn scan_vim_map(line: &str, user: &mut Vec<UserMap>, plug: &mut Vec<String>) {
    let Some(caps) = vim_map_re().captures(line) else {
        return;
    };
    let prefix = caps.name("prefix").map_or("", |m| m.as_str());
    let bang = caps.name("bang").map_or("", |m| m.as_str());
    let rest = caps.name("rest").map_or("", |m| m.as_str());
    let modes = vim_map_modes(prefix, bang == "!");
    let Some((lhs, has_buffer)) = parse_vim_map_lhs(rest) else {
        return;
    };
    // buffer-local 判定 (Vim): `<buffer>` flag 付きは plugin window 内の private
    // バインディングなので、Lua 側 `has_buffer_option` と同じく入口候補から除外する
    // (#92 review)。`<Plug>` も user-entry もどちらの sink でも skip。
    if has_buffer {
        return;
    }
    if is_plug_lhs(&lhs) {
        plug.push(lhs);
    } else {
        user.push(UserMap { lhs, modes });
    }
}

/// `:map` 行の rest (mode prefix と bang を取り除いた残り) から lhs と
/// `<buffer>` flag の有無を取り出す。`<silent>` / `<expr>` 等の他オプションは
/// 透過 skip。`<buffer>` は呼び出し側で buffer-local 判定に使う。
fn parse_vim_map_lhs(rest: &str) -> Option<(String, bool)> {
    let mut s = rest.trim_start();
    let mut has_buffer = false;
    while let Some(after_lt) = s.strip_prefix('<') {
        let close = after_lt.find('>')?;
        let tag = &after_lt[..close];
        let lower = tag.to_ascii_lowercase();
        match lower.as_str() {
            "buffer" => {
                has_buffer = true;
                s = after_lt[close + 1..].trim_start();
            }
            "silent" | "expr" | "nowait" | "unique" | "script" | "special" => {
                s = after_lt[close + 1..].trim_start();
            }
            _ => break,
        }
    }
    let end = s.find(char::is_whitespace).unwrap_or(s.len());
    let lhs = s[..end].trim();
    if lhs.is_empty() {
        None
    } else {
        Some((lhs.to_string(), has_buffer))
    }
}

fn vim_map_modes(prefix: &str, bang: bool) -> Vec<String> {
    if prefix.is_empty() {
        if bang {
            vec!["i".into(), "c".into()]
        } else {
            vec!["n".into(), "v".into(), "o".into()]
        }
    } else {
        vec![prefix.to_string()]
    }
}

fn is_plug_lhs(lhs: &str) -> bool {
    lhs.to_ascii_lowercase().starts_with("<plug>")
}

// ── User event scanning ─────────────────────────────────────────────────

/// Lua: string pattern `nvim_exec_autocmds("User", { pattern = "Foo", … })`。
/// `[\s\S]*?` は改行含む lazy match — "User" と `pattern =` の間に他のフィールド
/// (modeline / group 等) や改行が挟まっても対応。
fn lua_user_event_string_re() -> &'static Regex {
    static RE: OnceLock<Regex> = OnceLock::new();
    RE.get_or_init(|| {
        Regex::new(
            r#"nvim_exec_autocmds\s*\(\s*["']User["']\s*,[\s\S]*?pattern\s*=\s*["'](?P<ev>[^"']+)["']"#,
        )
        .unwrap()
    })
}

/// Lua: table pattern `nvim_exec_autocmds("User", { pattern = { "Foo", "Bar" }, … })`。
fn lua_user_event_table_re() -> &'static Regex {
    static RE: OnceLock<Regex> = OnceLock::new();
    RE.get_or_init(|| {
        Regex::new(
            r#"nvim_exec_autocmds\s*\(\s*["']User["']\s*,[\s\S]*?pattern\s*=\s*\{(?P<inner>[^}]*)\}"#,
        )
        .unwrap()
    })
}

/// 与えられた Lua table 内容から "..." / '...' の string literal をすべて抽出。
/// `{"Foo", "Bar"}` の `Foo`, `Bar` を順に取り出す。
fn extract_lua_string_literals(inner: &str) -> Vec<String> {
    let mut out = Vec::new();
    let chars: Vec<char> = inner.chars().collect();
    let mut i = 0;
    while i < chars.len() {
        let c = chars[i];
        if c == '"' || c == '\'' {
            let quote = c;
            i += 1;
            let start = i;
            while i < chars.len() && chars[i] != quote {
                i += 1;
            }
            if i < chars.len() {
                let s: String = chars[start..i].iter().collect();
                out.push(s);
                i += 1; // past closing quote
            }
        } else {
            i += 1;
        }
    }
    out
}

fn scan_lua_events(code: &str, out: &mut Vec<String>) {
    // string 形式が優先マッチしたら table regex は同一位置で 2 重ヒットしないよう
    // `[\s\S]*?` で lazy にしてあるので各呼出につき 1 件ずつ拾う。
    for caps in lua_user_event_string_re().captures_iter(code) {
        out.push(caps["ev"].to_string());
    }
    for caps in lua_user_event_table_re().captures_iter(code) {
        for name in extract_lua_string_literals(&caps["inner"]) {
            out.push(name);
        }
    }
}

fn vim_doautocmd_re() -> &'static Regex {
    static RE: OnceLock<Regex> = OnceLock::new();
    RE.get_or_init(|| Regex::new(r"^\s*doautocmd(?:\s+<[^>]+>)*\s+User\s+(?P<ev>\S+)").unwrap())
}

fn scan_vim_event(line: &str, out: &mut Vec<String>) {
    if let Some(caps) = vim_doautocmd_re().captures(line) {
        out.push(caps["ev"].to_string());
    }
}

// ── shared ident helpers ────────────────────────────────────────────────

fn extract_ident(s: &str) -> Option<String> {
    let end = s
        .find(|c: char| !c.is_ascii_alphanumeric() && c != '_')
        .unwrap_or(s.len());
    let name = &s[..end];
    if is_valid_command_name(name) {
        Some(name.to_string())
    } else {
        None
    }
}

fn is_valid_command_name(name: &str) -> bool {
    let mut chars = name.chars();
    let Some(first) = chars.next() else {
        return false;
    };
    if !first.is_ascii_uppercase() {
        return false;
    }
    chars.all(|c| c.is_ascii_alphanumeric() || c == '_')
}

// ── auto-suggest helpers (#87) ──────────────────────────────────────────
//
// コマンド名リストを sort → 隣接 LCP クラスタ化して、各クラスタを
// `/^<LCP>/` regex に、singleton / 短すぎる LCP は exact 名のままにして
// "lazy trigger 提案" のコア出力を作る。
//
// 閾値 `min_prefix` は「プレフィクスが何文字以上あれば regex 化する価値が
// あるか」。短すぎると他プラグインの command を誤爆するので 3 文字推奨
// (`/^F/` は危険、`/^Foo/` は十分 specific)。

/// コマンド名リストから lazy trigger の提案リストを作る。
///
///   - 共通プレフィクス ≥ `min_prefix` のクラスタを `/^<LCP>/` にまとめる
///   - クラスタにならない (singleton / LCP 不足) は exact 名のまま残す
///   - 入力空なら空 Vec
///
/// 出力はソート済み順 (呼び出し側の UI で安定表示するため)。
pub fn suggest_cmd_triggers_smart(commands: &[String], min_prefix: usize) -> Vec<String> {
    if commands.is_empty() {
        return Vec::new();
    }
    let mut sorted: Vec<&str> = commands.iter().map(|s| s.as_str()).collect();
    sorted.sort();
    sorted.dedup();

    let mut out = Vec::new();
    let mut cluster_start = 0usize;
    let mut cluster_lcp: &str = sorted[0];

    for i in 1..sorted.len() {
        let new_lcp = common_prefix(cluster_lcp, sorted[i]);
        if new_lcp.chars().count() >= min_prefix {
            cluster_lcp = new_lcp;
        } else {
            emit_cluster(&sorted[cluster_start..i], cluster_lcp, min_prefix, &mut out);
            cluster_start = i;
            cluster_lcp = sorted[i];
        }
    }
    emit_cluster(&sorted[cluster_start..], cluster_lcp, min_prefix, &mut out);
    out
}

fn emit_cluster(cluster: &[&str], lcp: &str, min_prefix: usize, out: &mut Vec<String>) {
    if cluster.len() >= 2 && lcp.chars().count() >= min_prefix {
        out.push(format!("/^{}/", regex::escape(lcp)));
    } else {
        // singleton もしくは LCP 不足 → exact 名で enumerate
        for c in cluster {
            out.push((*c).to_string());
        }
    }
}

/// 2 文字列の共通プレフィクス。UTF-8 境界を意識して char 単位で比較。
fn common_prefix<'a>(a: &'a str, b: &str) -> &'a str {
    let mut end = 0;
    for (ac, bc) in a.chars().zip(b.chars()) {
        if ac == bc {
            end += ac.len_utf8();
        } else {
            break;
        }
    }
    &a[..end]
}

#[cfg(test)]
mod tests {
    use super::*;

    // ── command scanning ───────────────────────────────────────────

    #[test]
    fn scan_source_picks_lua_nvim_create_user_command() {
        let src = r#"
vim.api.nvim_create_user_command("FooOne", function() end, { bang = true })
vim.api.nvim_create_user_command('FooTwo', function() end, {})
require('foo').bar("NotCmd")
"#;
        let mut out = scan_source(src, Dialect::Lua).commands;
        out.sort();
        assert_eq!(out, vec!["FooOne", "FooTwo"]);
    }

    #[test]
    fn scan_source_picks_vim_command_bang_and_options() {
        let src = r#"
command! FooOne echo 'one'
command! -bang -nargs=* FooTwo echo 'two'
command -bar FooThree echo 'three'
command! -complete=file -nargs=1 FooFour echo 'four'
"#;
        let mut out = scan_source(src, Dialect::Vim).commands;
        out.sort();
        assert_eq!(out, vec!["FooFour", "FooOne", "FooThree", "FooTwo"]);
    }

    #[test]
    fn scan_source_ignores_lua_comment_out_definitions() {
        let src = r#"
-- example: vim.api.nvim_create_user_command("Example", function() end)
vim.api.nvim_create_user_command("Real", function() end, {})
"#;
        assert_eq!(scan_source(src, Dialect::Lua).commands, vec!["Real"]);
    }

    #[test]
    fn scan_files_preserves_command_duplicates_across_dialects() {
        // Same command name declared in a .lua file and a .vim file is preserved
        // as two entries (dedup only happens by (name) tuple inside scan_files —
        // here we want to show cross-dialect is counted via separate files).
        let tmp = tempfile::tempdir().unwrap();
        let a = tmp.path().join("a.lua");
        let b = tmp.path().join("b.vim");
        std::fs::write(
            &a,
            r#"vim.api.nvim_create_user_command("Foo", function() end)"#,
        )
        .unwrap();
        std::fs::write(&b, "command! Foo echo 'same name'").unwrap();
        // scan_files dedups by command name, so it reports Foo once.
        assert_eq!(scan_files(&[a, b]).commands, vec!["Foo"]);
    }

    // ── user-facing keymap scanning ────────────────────────────────

    #[test]
    fn scan_source_picks_vim_nnoremap_lhs() {
        let src = "nnoremap gc <Plug>(commentary)\nnnoremap gcc <Plug>(commentary-line)";
        let maps = scan_source(src, Dialect::Vim).user_maps;
        assert_eq!(
            maps,
            vec![
                UserMap {
                    lhs: "gc".into(),
                    modes: vec!["n".into()]
                },
                UserMap {
                    lhs: "gcc".into(),
                    modes: vec!["n".into()]
                },
            ]
        );
    }

    #[test]
    fn scan_source_strips_silent_option_but_keeps_global_map() {
        // `<silent>` 等は装飾なので透過 strip して lhs を取り出す。
        let src = "nnoremap <silent> gc :echo 'x'<CR>";
        let maps = scan_source(src, Dialect::Vim).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into()]
            }]
        );
    }

    #[test]
    fn scan_source_skips_vim_buffer_local_user_map() {
        // `<buffer>` 付きは buffer-local — plugin window 内の binding なので
        // user-entry trigger 候補から除外する (#92 review)。Lua 側 `has_buffer_option`
        // と統一。
        let src = "nnoremap <silent> <buffer> gc :echo 'x'<CR>";
        let result = scan_source(src, Dialect::Vim);
        assert!(result.user_maps.is_empty());
        assert!(result.plug_maps.is_empty());
    }

    #[test]
    fn scan_source_skips_vim_buffer_local_plug_map() {
        // 同じく `<Plug>` 系も `<buffer>` 付きなら plug_maps に入れない。
        let src = "nnoremap <buffer> <Plug>(InternalOnly) :echo 'x'<CR>";
        let result = scan_source(src, Dialect::Vim);
        assert!(result.user_maps.is_empty());
        assert!(result.plug_maps.is_empty());
    }

    #[test]
    fn scan_source_separates_plug_lhs_from_user_maps() {
        // `<Plug>(...)` LHS は user_maps から除外され、plug_maps へ。
        // user-typed LHS (`gc`) は user_maps に残る。
        let src = "nnoremap <Plug>(Foo) :echo 'foo'<CR>\nnnoremap gc <Plug>(Bar)";
        let result = scan_source(src, Dialect::Vim);
        assert_eq!(
            result.user_maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into()]
            }]
        );
        assert_eq!(result.plug_maps, vec!["<Plug>(Foo)"]);
    }

    #[test]
    fn scan_source_extracts_mode_from_vim_prefix() {
        let src = "\
vnoremap gc <Plug>(comment)
inoremap gi <Plug>(i-cmd)
xnoremap gx <Plug>(visual)
cnoremap gc :echo 'cmdline'<CR>";
        let maps = scan_source(src, Dialect::Vim).user_maps;
        assert_eq!(
            maps,
            vec![
                UserMap {
                    lhs: "gc".into(),
                    modes: vec!["v".into()]
                },
                UserMap {
                    lhs: "gi".into(),
                    modes: vec!["i".into()]
                },
                UserMap {
                    lhs: "gx".into(),
                    modes: vec!["x".into()]
                },
                UserMap {
                    lhs: "gc".into(),
                    modes: vec!["c".into()]
                },
            ]
        );
    }

    #[test]
    fn scan_source_bare_map_default_modes() {
        let src = "map gc <Plug>(Foo)";
        let maps = scan_source(src, Dialect::Vim).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into(), "v".into(), "o".into()],
            }]
        );
    }

    #[test]
    fn scan_source_map_bang_is_insert_and_cmdline() {
        let src = "noremap! gc <Plug>(Foo)";
        let maps = scan_source(src, Dialect::Vim).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["i".into(), "c".into()],
            }]
        );
    }

    #[test]
    fn scan_source_picks_lua_keymap_set() {
        let src = r#"vim.keymap.set("n", "gc", function() end, {})"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into()]
            }]
        );
    }

    #[test]
    fn scan_source_picks_lua_nvim_set_keymap() {
        let src = r#"vim.api.nvim_set_keymap("v", "gv", "<Plug>(Foo)", {})"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gv".into(),
                modes: vec!["v".into()]
            }]
        );
    }

    #[test]
    fn scan_source_filters_lua_plug_lhs() {
        let src = r#"vim.keymap.set("n", "<Plug>(Internal)", function() end)"#;
        assert!(scan_source(src, Dialect::Lua).user_maps.is_empty());
    }

    // ── User event scanning ────────────────────────────────────────

    #[test]
    fn scan_source_picks_lua_user_event_pattern() {
        let src = r#"vim.api.nvim_exec_autocmds("User", { pattern = "FooDone" })"#;
        assert_eq!(scan_source(src, Dialect::Lua).user_events, vec!["FooDone"]);
    }

    #[test]
    fn scan_source_picks_vim_doautocmd_user() {
        let src = "doautocmd User BarReady";
        assert_eq!(scan_source(src, Dialect::Vim).user_events, vec!["BarReady"]);
    }

    #[test]
    fn scan_source_picks_vim_doautocmd_with_options() {
        let src = "doautocmd <nomodeline> User BarReady";
        assert_eq!(scan_source(src, Dialect::Vim).user_events, vec!["BarReady"]);
    }

    // ── multiline Lua call sites (CodeRabbit Major on #90) ─────────

    #[test]
    fn scan_source_picks_multiline_lua_create_command() {
        // modern plugin はこの fmt が標準。per-line 走査だと miss してた。
        let src = r#"
vim.api.nvim_create_user_command(
  "MultiFoo",
  function() end,
  { bang = true }
)
"#;
        assert_eq!(scan_source(src, Dialect::Lua).commands, vec!["MultiFoo"]);
    }

    #[test]
    fn scan_source_picks_multiline_lua_keymap_set() {
        let src = r#"
vim.keymap.set(
  "n",
  "gc",
  function() end,
  {}
)
"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into()]
            }]
        );
    }

    #[test]
    fn scan_source_picks_multiline_lua_user_event_string() {
        let src = r#"
vim.api.nvim_exec_autocmds("User", {
  pattern = "FooDone",
  modeline = false,
})
"#;
        assert_eq!(scan_source(src, Dialect::Lua).user_events, vec!["FooDone"]);
    }

    // ── Lua map: multi-char mode / empty / bang (Gemini L171, L199) ────

    #[test]
    fn scan_source_lua_map_multi_char_mode() {
        let src = r#"vim.keymap.set("nv", "gc", function() end)"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into(), "v".into()]
            }]
        );
    }

    #[test]
    fn scan_source_lua_map_empty_mode_defaults_to_nvo() {
        // Neovim の `vim.keymap.set("", lhs, ...)` は bare `:map` 相当
        let src = r#"vim.keymap.set("", "gc", function() end)"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into(), "v".into(), "o".into()]
            }]
        );
    }

    #[test]
    fn scan_source_lua_map_bang_mode_is_insert_plus_cmdline() {
        let src = r#"vim.keymap.set("!", "gc", function() end)"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["i".into(), "c".into()]
            }]
        );
    }

    // ── User event table pattern (Gemini L246) ───────────────────────

    #[test]
    fn scan_source_picks_lua_user_event_table_pattern() {
        let src = r#"vim.api.nvim_exec_autocmds("User", { pattern = {"Foo", "Bar"} })"#;
        let mut events = scan_source(src, Dialect::Lua).user_events;
        events.sort();
        assert_eq!(events, vec!["Bar", "Foo"]);
    }

    #[test]
    fn scan_source_picks_multiline_lua_user_event_table_pattern() {
        let src = r#"
vim.api.nvim_exec_autocmds("User", {
  pattern = {
    "AlphaDone",
    "BetaReady",
  },
})
"#;
        let mut events = scan_source(src, Dialect::Lua).user_events;
        events.sort();
        assert_eq!(events, vec!["AlphaDone", "BetaReady"]);
    }

    // ── Vim command not affected by `--` inside strings (Gemini L52/127/140) ──

    #[test]
    fn scan_source_vim_command_keeps_name_when_body_contains_double_dash() {
        // Vim で `--` はコメントではない。`command! Foo echo '--'` で `--` 以降が
        // 削られると Vim 側 scan が bare な `command!` 行として誤判定する可能性。
        // Vim scan は元の line に対して行うべき。
        let src = r#"command! -bang Foo echo '--'"#;
        assert_eq!(scan_source(src, Dialect::Vim).commands, vec!["Foo"]);
    }

    // ── dialect split (hardtime.nvim false positive) ─────────────────────

    #[test]
    fn scan_source_lua_does_not_match_vim_noremap_keyword() {
        // hardtime.nvim init.lua の `noremap = true,` (Lua options テーブル) が
        // Vim の `^\s*noremap\s+` regex で lhs="=" として誤検出される bug の回帰 test。
        let src = r#"
vim.keymap.set(mode, key, function()
   return handler(key)
end, {
   noremap = true,
   expr = true,
})
"#;
        // mode / key が変数なので lua_map_re は matching しない → maps 空。
        // 重要: noremap = true, を拾わない。
        assert!(scan_source(src, Dialect::Lua).user_maps.is_empty());
    }

    #[test]
    fn scan_source_vim_does_not_process_lua_keymap_set() {
        // 逆: Vim dialect で走らせた Lua コード片は lua_* scanners を動かさない。
        let src = r#"vim.keymap.set("n", "gc", function() end, {})"#;
        assert!(scan_source(src, Dialect::Vim).user_maps.is_empty());
    }

    // ── buffer-local keymap skip (aerial.nvim q/<c-c> false positive) ────

    #[test]
    fn scan_source_skips_buffer_local_keymap_set() {
        // aerial.nvim keymap_util.lua — buffer = bufnr 付きは plugin window 内専用。
        let src = r#"
vim.keymap.set("n", "q", "<cmd>close<CR>", { buffer = bufnr, nowait = true })
vim.keymap.set("n", "<c-c>", "<cmd>close<CR>", { buffer = bufnr })
"#;
        assert!(scan_source(src, Dialect::Lua).user_maps.is_empty());
    }

    #[test]
    fn scan_source_keeps_global_keymap_set_without_buffer() {
        // buffer= が無いものは entry point なので残す。
        let src = r#"vim.keymap.set("n", "gc", "<Plug>(commentary)", { desc = "comment" })"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into()]
            }]
        );
    }

    #[test]
    fn scan_source_skips_buffer_local_multiline_keymap_set() {
        // multiline options テーブルでも buffer= を拾える。
        let src = r#"
vim.keymap.set("n", "q", "<cmd>close<CR>", {
  buffer = bufnr,
  nowait = true,
})
"#;
        assert!(scan_source(src, Dialect::Lua).user_maps.is_empty());
    }

    // ── plug_maps scanning (#88) ─────────────────────────────────────────

    #[test]
    fn scan_source_collects_vim_plug_maps() {
        let src = "\
nnoremap <Plug>(Foo)  :echo 'foo'<CR>
xnoremap <Plug>(BarVisual) :echo 'visual'<CR>
nmap <Plug>(NotNoRemap) <Plug>(Foo)
inoremap gi <Plug>(NotEntry)";
        let result = scan_source(src, Dialect::Vim);
        // <Plug>(...) LHS のみ plug_maps に集まる。`gi` は user-entry なので user_maps へ。
        assert_eq!(
            result.plug_maps,
            vec!["<Plug>(Foo)", "<Plug>(BarVisual)", "<Plug>(NotNoRemap)"]
        );
        assert_eq!(
            result.user_maps,
            vec![UserMap {
                lhs: "gi".into(),
                modes: vec!["i".into()]
            }]
        );
    }

    #[test]
    fn scan_source_collects_lua_plug_maps() {
        let src = r#"
vim.keymap.set("n", "<Plug>(LuaFoo)", function() end, {})
vim.api.nvim_set_keymap("v", "<Plug>(LuaBarVisual)", ":echo 'v'<CR>", {})
vim.keymap.set("n", "<leader>g", "<Plug>(NotEntry)", {})
"#;
        let result = scan_source(src, Dialect::Lua);
        assert_eq!(
            result.plug_maps,
            vec!["<Plug>(LuaFoo)", "<Plug>(LuaBarVisual)"]
        );
        assert_eq!(
            result.user_maps,
            vec![UserMap {
                lhs: "<leader>g".into(),
                modes: vec!["n".into()]
            }]
        );
    }

    #[test]
    fn scan_source_skips_buffer_local_plug_map() {
        // buffer-local な `<Plug>` は plugin window 内専用なので拾わない。
        // (本来 `<Plug>` は global RTP で公開する慣習だが念のため filter)
        let src = r#"
vim.keymap.set("n", "<Plug>(InternalOnly)", function() end, { buffer = bufnr })
"#;
        let result = scan_source(src, Dialect::Lua);
        assert!(result.plug_maps.is_empty());
    }

    // ── suggest_cmd_triggers_smart (#87) ──────────────────────────

    #[test]
    fn suggest_empty_returns_empty() {
        assert!(suggest_cmd_triggers_smart(&[], 3).is_empty());
    }

    #[test]
    fn suggest_single_command_returns_exact_name() {
        let out = suggest_cmd_triggers_smart(&["Foo".into()], 3);
        assert_eq!(out, vec!["Foo"]);
    }

    #[test]
    fn suggest_two_commands_with_shared_prefix_cluster_as_regex() {
        let out = suggest_cmd_triggers_smart(&["ChezmoiEdit".into(), "ChezmoiList".into()], 3);
        assert_eq!(out, vec!["/^Chezmoi/"]);
    }

    #[test]
    fn suggest_two_commands_short_lcp_enumerates() {
        // LCP が閾値未満なら enumerate のみ。
        let out = suggest_cmd_triggers_smart(&["Foo".into(), "Fox".into()], 3);
        assert_eq!(out, vec!["Foo", "Fox"]);
    }

    #[test]
    fn suggest_two_unrelated_commands_enumerate() {
        let out = suggest_cmd_triggers_smart(&["Foo".into(), "Bar".into()], 3);
        assert_eq!(out, vec!["Bar", "Foo"]); // sort order
    }

    #[test]
    fn suggest_two_clusters_both_become_regex() {
        let out = suggest_cmd_triggers_smart(
            &["Foo".into(), "FooOne".into(), "Bar".into(), "BarOne".into()],
            3,
        );
        assert_eq!(out, vec!["/^Bar/", "/^Foo/"]);
    }

    #[test]
    fn suggest_three_commands_shared_prefix_single_regex() {
        let out = suggest_cmd_triggers_smart(
            &[
                "GrugFar".into(),
                "GrugFarVisual".into(),
                "GrugFarWithin".into(),
            ],
            3,
        );
        assert_eq!(out, vec!["/^GrugFar/"]);
    }

    #[test]
    fn suggest_mixed_cluster_and_singleton() {
        let out =
            suggest_cmd_triggers_smart(&["Foo".into(), "FooOne".into(), "Standalone".into()], 3);
        assert_eq!(out, vec!["/^Foo/", "Standalone"]);
    }

    #[test]
    fn suggest_staircase_keeps_as_singletons() {
        // A, AB, ABC では LCP が順に A (1), AB (2) で 3 字閾値を満たせない
        let out = suggest_cmd_triggers_smart(&["A".into(), "AB".into(), "ABC".into()], 3);
        assert_eq!(out, vec!["A", "AB", "ABC"]);
    }

    #[test]
    fn suggest_dedups_duplicate_commands() {
        let out = suggest_cmd_triggers_smart(&["Foo".into(), "Foo".into(), "FooBar".into()], 3);
        assert_eq!(out, vec!["/^Foo/"]);
    }

    #[test]
    fn suggest_lcp_uses_char_count_not_byte_count() {
        // マルチバイト文字が含まれると len() (byte) と chars().count() (char) で
        // 差が出るので、LCP 判定は char 基準。実用上 Vim command 名は ASCII のみ
        // だがガードとして確認。
        let out = suggest_cmd_triggers_smart(&["日本Foo".into(), "日本Bar".into()], 3);
        // LCP = "日本" (2 chars、byte 数は 6) → threshold=3 未満 → enumerate
        assert_eq!(out, vec!["日本Bar", "日本Foo"]);
    }

    // ── file / plugin aggregation ──────────────────────────────────

    #[test]
    fn scan_files_dedups_across_sources() {
        let tmp = tempfile::tempdir().unwrap();
        let a = tmp.path().join("a.lua");
        let b = tmp.path().join("b.vim");
        std::fs::write(
            &a,
            "vim.api.nvim_create_user_command('Foo', function() end)\n\
             vim.api.nvim_create_user_command('Foo', function() end)",
        )
        .unwrap();
        std::fs::write(&b, "command! Foo echo 'b'\nnnoremap gc <Plug>(c)").unwrap();
        let result = scan_files(&[a, b]);
        assert_eq!(result.commands, vec!["Foo"]);
        assert_eq!(
            result.user_maps,
            vec![UserMap {
                lhs: "gc".into(),
                modes: vec!["n".into()]
            }]
        );
    }

    #[test]
    fn scan_plugin_walks_plugin_ftplugin_after_and_lua() {
        let tmp = tempfile::tempdir().unwrap();
        let root = tmp.path();
        for (sub, fname, body) in [
            (
                "plugin",
                "a.lua",
                "vim.api.nvim_create_user_command('PluginA', function() end, {})",
            ),
            ("ftplugin", "rust.vim", "command! FtRust echo 'rust'"),
            (
                "after/plugin",
                "b.vim",
                "command! -bang AfterB echo 'after'",
            ),
            (
                // modern plugin: setup() 内 literal 定義 (lua/ 追加の効果)
                "lua/foo",
                "init.lua",
                r#"return { setup = function() vim.api.nvim_create_user_command("Setupd", function() end, {}) end }"#,
            ),
            // scan 対象外ディレクトリ
            ("autoload", "x.vim", "command! NotScanned echo 'no'"),
        ] {
            let dir = root.join(sub);
            std::fs::create_dir_all(&dir).unwrap();
            std::fs::write(dir.join(fname), body).unwrap();
        }
        let mut out = scan_plugin(root).commands;
        out.sort();
        assert_eq!(out, vec!["AfterB", "FtRust", "PluginA", "Setupd"]);
    }

    // ── block comment stripping (neorg false positive) ───────────────────

    #[test]
    fn scan_source_skips_keymap_set_inside_block_comment() {
        // neorg の keybinds/module.lua は header docstring を `--[[ … ]]` ブロック
        // コメントで書いており、内部に example として `vim.keymap.set(…)` が
        // 埋まっている。live code ではないので拾ってはいけない。
        let src = r#"
--[[
    Example user keybind:
    vim.keymap.set("n", "my-key-here", "<Plug>(neorg.foo)", {})
    vim.keymap.set("n", "<up>", "<Plug>(neorg.bar)", {})
--]]

vim.keymap.set("n", "real", "<Plug>(plugin.action)", {})
"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "real".into(),
                modes: vec!["n".into()],
            }],
            "block comment body must not produce user_maps entries"
        );
    }

    #[test]
    fn scan_source_handles_long_bracket_level_in_block_comment() {
        // `--[===[ … ]===]` も block comment として機能する (Lua の long bracket level)。
        let src = r#"
--[==[
    vim.keymap.set("n", "must-be-skipped", "<Plug>(x)")
]==]
vim.keymap.set("n", "kept", "<Plug>(y)")
"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "kept".into(),
                modes: vec!["n".into()],
            }]
        );
    }

    // ── line-comment stripper preserves strings containing `--` ──────────

    #[test]
    fn scan_source_preserves_string_with_double_dash_inside() {
        // neorg calendar の `{ "--- Quitting ---", "@text.title" }` のような label は
        // 文字列内の `--` なのでコメント扱いしてはいけない。以前は強制切断で
        // 後続の paren balance が狂い、buffer-local 判定が失敗していた。
        let src = r#"
vim.keymap.set("n", "?", lib.wrap(display_help, {
    { "--- Quitting ---", "@text.title" },
    { "--- Date Syntax ---", "@text.title" },
}), { buffer = bufnr })
"#;
        // buffer-local なので拾わない。文字列内の `--` が保護されて paren が正しく
        // 閉じ、has_buffer_option が `{ buffer = bufnr }` を見つけられる。
        assert!(scan_source(src, Dialect::Lua).user_maps.is_empty());
    }

    #[test]
    fn scan_source_still_strips_real_line_comment_with_code_after() {
        // 実際の `-- …` 行コメントは従来どおり削る。
        let src = r#"
-- vim.keymap.set("n", "commented-out", …)
vim.keymap.set("n", "live", "<Plug>(x)")
"#;
        let maps = scan_source(src, Dialect::Lua).user_maps;
        assert_eq!(
            maps,
            vec![UserMap {
                lhs: "live".into(),
                modes: vec!["n".into()],
            }]
        );
    }
}