inkhaven 1.7.3

Inkhaven — TUI literary work editor for Typst books
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

//! LING-1 L-P3 — `inkhaven language universals <lang>`: judge a language's
//! grammar block against the typological baseline (head-directionality harmony +
//! the classic implicational universals) and survey its word order + morphotype.
//! Read-only; a violation is a flag, not an error. `--json` for machine use.

use std::path::Path;

use crate::conlang::universals::{Branch, TypologyReport, Verdict};
use crate::error::{Error, Result};

use super::*;

pub(crate) fn universals(project: &Path, language: &str, json: bool) -> Result<()> {
    let (store, hierarchy, lang_book) = open_lang_book(project, language)?;
    let (spec, _) = load_grammar_spec(&store, &hierarchy, &lang_book)?;
    let report = crate::conlang::universals::survey(&spec);

    if json {
        println!(
            "{}",
            serde_json::to_string_pretty(&report)
                .map_err(|e| Error::Store(format!("serializing typology: {e}")))?
        );
        return Ok(());
    }

    print_report(language, &report);
    Ok(())
}

fn branch_label(b: Branch) -> &'static str {
    match b {
        Branch::HeadInitial => "head-initial",
        Branch::HeadFinal => "head-final",
        Branch::Mixed => "mixed / disharmonic",
        Branch::Unknown => "unknown (no word-order features set)",
    }
}

fn verdict_glyph(v: Verdict) -> &'static str {
    match v {
        Verdict::Satisfied => "✓",
        Verdict::Violated => "✗",
        Verdict::NotApplicable => "·",
    }
}

/// LING-1 Wave-2 — `inkhaven language grammar-check <lang>`: validate the typed
/// grammar blocks (`ug_parameters`, `verb_classes`) and check them for
/// consistency against the WALS feature answers.
pub(crate) fn grammar_check(project: &Path, language: &str, json: bool) -> Result<()> {
    let (store, hierarchy, lang_book) = open_lang_book(project, language)?;
    let (spec, _) = load_grammar_spec(&store, &hierarchy, &lang_book)?;
    let report = crate::conlang::grammar_check::check(&spec);

    if json {
        println!(
            "{}",
            serde_json::to_string_pretty(&report)
                .map_err(|e| Error::Store(format!("serializing grammar check: {e}")))?
        );
        return Ok(());
    }

    println!("grammar check · {language}");
    println!(
        "  blocks     · {} parameter(s), {} verb class(es)",
        report.parameter_count, report.verb_class_count
    );
    if report.ok() {
        println!("  ✓ typed grammar blocks are valid and consistent with the feature answers.");
    } else {
        println!("  {} issue(s):", report.issues.len());
        for i in &report.issues {
            println!("      ✗ {}", i.message);
        }
    }
    Ok(())
}

fn print_report(language: &str, r: &TypologyReport) {
    println!("typological universals · {language}");
    println!(
        "  order      · {}",
        r.word_order.as_deref().unwrap_or("(unspecified)")
    );
    if let Some(mt) = &r.morphological_type {
        println!("  morphology · {mt}");
    }
    if let Some(hm) = &r.head_marking {
        println!("  marking    · {hm}");
    }
    println!("  branching  · {}", branch_label(r.branch));
    let measured = r.harmonic + r.disharmonic.len();
    if measured > 0 {
        print!(
            "  harmony    · {}/{} correlates aligned ({:.0}%)",
            r.harmonic,
            measured,
            r.harmony_score * 100.0
        );
        if r.disharmonic.is_empty() {
            println!();
        } else {
            println!(" · disharmonic: {}", r.disharmonic.join(", "));
        }
    }
    println!("  universals ·");
    for c in &r.checks {
        println!("      {} {} — {}", verdict_glyph(c.verdict), c.statement, c.detail);
    }
    let violations = r.checks.iter().filter(|c| c.verdict == Verdict::Violated).count();
    if violations == 0 {
        println!("  (no universal violated — but a natural conlang may still break tendencies)");
    } else {
        println!("  ({violations} typologically marked combination(s) flagged)");
    }
}