Files
craft-libs/crates/proof
577e816e9b craft-proof: decode KOI8-R and Windows-1251 dictionaries (from wordcraft#894)
Older Russian Hunspell dictionaries are in KOI8-R or Windows-1251. The
decoder and its test come from xmaks82's Russian proofing PR,
storytold/wordcraft#894, so that support lands in the shared loader as
asked in storytold/craft-libs#30.

Co-Authored-By: xmaks82 <200731976+xmaks82@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 18:35:32 +02:00
..

craft-proof

Spelling mechanism shared by the Craft apps: read a Hunspell .aff/.dic pair installed on the system and check words against it. Seeded from WordCraft's wordcraft-proof; GridCraft, DeckCraft and PdfCraft are the next consumers (storytold/craft-libs#30). No dependency on any app or UI framework. Requires Rust 1.95.

let search = craft_proof::hunspell::Search::for_app("WordCraft");
if let Some((aff, dic)) = search.find(&["pl_PL", "pl"]) {
    let dict = craft_proof::hunspell::load(&aff, &dic)?;
    assert!(dict.check("kotami"));
}
# Ok::<(), String>(())
  • Dictionaries are not bundled. Apps read what the OS, a package manager or LibreOffice installed; without one a language simply has no spelling check.
  • Search order (Search): the app's dictionaries folder setting, <APP>_DICTIONARIES, the app's folder under the Windows application-data folders, then the usual Hunspell and LibreOffice locations for the platform. Nothing on wasm.
  • Affix engine (AffixDict): the Hunspell subset real dictionaries such as SJP.PL (Polish) and VERO (Brazilian Portuguese) use: one-character or FLAG UTF-8 flags, prefixes and suffixes with conditions and cross products, continuation classes, FORBIDDENWORD, and the TRY/MAP/REP suggestion tables. Compounding and long or numeric flags are rejected with an error rather than misread.
  • Compact form: AffixDict::to_bytes/from_bytes store a loaded dictionary deflated (Polish is under 1 MB), so an app can cache it instead of parsing the .aff/.dic each start.

What stays in each app: which languages it proofs, suggestion ranking and grammar rules per language, the user dictionary, and how marks are shown.