use std::collections::{BTreeMap, HashMap};
use regex::Regex;
use serde::Serialize;
use crate::Error;
use crate::morphology::{Morpheme, Morphology};
use crate::text::{mask_html_comments, mask_markdown_structure_preserving_headings};
const SURFACE_GLOSS_MARKERS: &[&str] = &["とは", "、つまり"];
const NAMING_VERBS: &[&str] = &["呼ぶ", "言う", "称する", "名付ける"];
#[derive(Clone, Debug, Serialize)]
pub struct Term {
pub term: String,
pub first_line: usize,
pub count: usize,
pub has_gloss_hint: bool,
pub context: String,
}
#[derive(Clone, Debug, Serialize)]
pub struct TermsReport {
pub terms: Vec<Term>,
}
#[derive(Clone, Debug, Serialize)]
pub struct AuditFileEntry {
pub file: String,
pub first_line: usize,
pub count: usize,
pub has_gloss_hint: bool,
}
#[derive(Clone, Debug, Serialize)]
pub struct AuditTerm {
pub term: String,
pub normalized: String,
pub total_count: usize,
pub files: Vec<AuditFileEntry>,
}
#[derive(Clone, Debug, Serialize)]
pub struct AuditSpelling {
pub term: String,
pub total_count: usize,
}
#[derive(Clone, Debug, Serialize)]
pub struct AuditVariantGroup {
pub normalized: String,
pub spellings: Vec<AuditSpelling>,
}
#[derive(Clone, Debug, Serialize)]
pub struct TermsAuditReport {
pub files: Vec<String>,
pub terms: Vec<AuditTerm>,
pub variants: Vec<AuditVariantGroup>,
}
#[derive(Clone, Debug)]
struct SeenTerm {
term: String,
line: usize,
byte_offset: usize,
}
fn katakana(surface: &str) -> bool {
!surface.is_empty()
&& surface
.chars()
.all(|ch| matches!(ch, 'ァ'..='ヶ' | 'ー' | '・'))
}
fn capitalized_latin(surface: &str) -> bool {
let mut chars = surface.chars();
chars.next().is_some_and(|ch| ch.is_ascii_uppercase())
&& chars.all(|ch| ch.is_ascii_alphanumeric())
&& surface.len() >= 2
}
fn proper_noun(token: &Morpheme) -> bool {
if token.surface.chars().all(|ch| ch.is_ascii_alphanumeric()) {
return capitalized_latin(&token.surface);
}
token.pos(0) == "名詞" && token.pos(1) == "固有名詞" && token.surface.chars().count() >= 2
}
fn register(seen: &mut HashMap<String, SeenTerm>, term: &str, line: usize, offset: usize) {
let term = term.trim();
if term.is_empty() {
return;
}
seen.entry(term.to_owned()).or_insert_with(|| SeenTerm {
term: term.to_owned(),
line,
byte_offset: offset,
});
}
fn has_gloss_marker(text: &str, morphology: &Morphology) -> Result<bool, Error> {
if SURFACE_GLOSS_MARKERS
.iter()
.any(|marker| text.contains(marker))
{
return Ok(true);
}
Ok(morphology.tokenize(text)?.windows(2).any(|pair| {
pair[0].surface == "と"
&& pair[0].pos(0) == "助詞"
&& pair[1].pos(0) == "動詞"
&& NAMING_VERBS.contains(&pair[1].normalized())
}))
}
fn context_and_gloss(
term: &str,
line_no: usize,
text: &str,
morphology: &Morphology,
) -> Result<(String, bool), Error> {
const CONTEXT_CHARS: usize = 80;
let mut line_start = 0;
let mut line = "";
for (index, candidate) in text.split('\n').enumerate() {
if index + 1 == line_no {
line = candidate;
break;
}
line_start += candidate.len() + 1;
}
let Some(byte_start) = line.find(term) else {
return Ok((line.trim().to_owned(), has_gloss_marker(line, morphology)?));
};
let absolute_start = line_start + byte_start;
let absolute_end = absolute_start + term.len();
let context_start = text[..absolute_start]
.char_indices()
.rev()
.nth(CONTEXT_CHARS.saturating_sub(1))
.map_or(0, |(byte, _)| byte);
let context_end = text[absolute_end..]
.char_indices()
.nth(CONTEXT_CHARS)
.map_or(text.len(), |(byte, _)| absolute_end + byte);
let context = &text[context_start..context_end];
let after = &text[absolute_end..context_end];
let hint =
after.starts_with('(') || after.starts_with('（') || has_gloss_marker(context, morphology)?;
Ok((context.trim().to_owned(), hint))
}
fn normalized_key(term: &str, morphology: &Morphology) -> Result<String, Error> {
Ok(morphology
.tokenize(term)?
.iter()
.map(|token| token.normalized().to_owned())
.collect::<String>())
}
pub fn audit(
inputs: &[(String, String)],
morphology: &Morphology,
) -> Result<TermsAuditReport, Error> {
let mut terms = BTreeMap::<String, AuditTerm>::new();
for (file, text) in inputs {
let report = analyze(text, morphology)?;
for term in report.terms {
let entry = terms.entry(term.term.clone()).or_insert(AuditTerm {
normalized: normalized_key(&term.term, morphology)?,
term: term.term,
total_count: 0,
files: Vec::new(),
});
entry.total_count += term.count;
entry.files.push(AuditFileEntry {
file: file.clone(),
first_line: term.first_line,
count: term.count,
has_gloss_hint: term.has_gloss_hint,
});
}
}
let mut groups = BTreeMap::<String, Vec<AuditSpelling>>::new();
for term in terms.values() {
groups
.entry(term.normalized.clone())
.or_default()
.push(AuditSpelling {
term: term.term.clone(),
total_count: term.total_count,
});
}
let mut variants = groups
.into_iter()
.filter(|(_, spellings)| spellings.len() >= 2)
.map(|(normalized, mut spellings)| {
spellings.sort_by(|a, b| b.total_count.cmp(&a.total_count).then(a.term.cmp(&b.term)));
AuditVariantGroup {
normalized,
spellings,
}
})
.collect::<Vec<_>>();
variants.sort_by(|a, b| a.normalized.cmp(&b.normalized));
let mut terms = terms.into_values().collect::<Vec<_>>();
terms.sort_by(|a, b| b.total_count.cmp(&a.total_count).then(a.term.cmp(&b.term)));
Ok(TermsAuditReport {
files: inputs.iter().map(|(file, _)| file.clone()).collect(),
terms,
variants,
})
}
pub fn analyze(raw_text: &str, morphology: &Morphology) -> Result<TermsReport, Error> {
let comments_masked = mask_html_comments(raw_text);
let body_masked = mask_markdown_structure_preserving_headings(&comments_masked);
let lines = body_masked
.split('\n')
.enumerate()
.map(|(index, line)| (index + 1, line.to_owned()))
.collect::<Vec<_>>();
let acronym = Regex::new(r"[A-Z]{2,}[0-9]*").expect("valid acronym regex");
let mut seen = HashMap::new();
for (line_no, line) in lines {
if line.trim().is_empty() {
continue;
}
for found in acronym.find_iter(&line) {
let before_ok = line[..found.start()]
.chars()
.next_back()
.is_none_or(|ch| !ch.is_ascii_alphanumeric());
let after_ok = line[found.end()..]
.chars()
.next()
.is_none_or(|ch| !ch.is_ascii_alphanumeric());
if before_ok && after_ok {
register(&mut seen, found.as_str(), line_no, found.start());
}
}
let tokens = morphology.tokenize(&line)?;
let mut index = 0;
while index < tokens.len() {
let predicate: Option<fn(&Morpheme) -> bool> = if katakana(&tokens[index].surface) {
Some(|token| katakana(&token.surface))
} else if proper_noun(&tokens[index]) {
Some(proper_noun)
} else {
None
};
let Some(predicate) = predicate else {
index += 1;
continue;
};
let mut end = index + 1;
while end < tokens.len()
&& predicate(&tokens[end])
&& tokens[end - 1].byte_end == tokens[end].byte_start
{
end += 1;
}
if katakana(&tokens[index].surface) {
let joined_before = index > 0
&& tokens[index - 1].byte_end == tokens[index].byte_start
&& !tokens[index].surface.starts_with('・')
&& matches!(tokens[index - 1].pos(0), "名詞" | "代名詞" | "接頭辞");
let joined_after = end < tokens.len()
&& tokens[end - 1].byte_end == tokens[end].byte_start
&& !tokens[end - 1].surface.ends_with('・')
&& matches!(tokens[end].pos(0), "名詞" | "代名詞" | "接尾辞");
if joined_before || joined_after {
index = end;
continue;
}
}
let byte_start = tokens[index].byte_start;
let byte_end = tokens[end - 1].byte_end;
let raw_term = &line[byte_start..byte_end];
let term = raw_term.trim_matches('・');
if !katakana(&tokens[index].surface) || term.chars().count() >= 3 {
let trimmed_start = byte_start + raw_term.find(term).unwrap_or_default();
register(&mut seen, term, line_no, trimmed_start);
}
index = end;
}
}
let mut seen = seen.into_values().collect::<Vec<_>>();
seen.sort_by_key(|term| (term.line, term.byte_offset));
let terms = seen
.into_iter()
.map(|seen| {
let (context, has_gloss_hint) =
context_and_gloss(&seen.term, seen.line, &comments_masked, morphology)?;
Ok(Term {
count: comments_masked.match_indices(&seen.term).count(),
term: seen.term,
first_line: seen.line,
has_gloss_hint,
context,
})
})
.collect::<Result<_, Error>>()?;
Ok(TermsReport { terms })
}