Expand description
§mongol-convert
Pure-Rust core of the Mongolian Encoding Converter (mongol-convert), ported from the
original Java library com.zvvnmod.mongolconvert.
Design & decisions: docs/superpowers/specs/2026-06-18-meco-rust-port-design.md.
Ground rules baked into this crate:
- Generated Java tables are the historical behavior baseline; Rust-owned Zvvnmod rules may intentionally override them when the project adopts corrected semantics.
- Conversions route through the intermediate Zvvnmod encoding.
- The build has no I/O or framework and is pure compute on every platform, including
wasm32-unknown-unknown. UTN #57 target conversion is linked in through the pure-Rustzvvnmod-utn57crate; no external command or interpreter is started.
Status: scaffolding — the shared spine (encoding types, errors, string helpers) is in place. Translation routing and the shape/letter subsystems are added in later steps.
Structs§
- Translation
- A finished conversion: the text, and whatever the conversion had to do beyond what the input
said. See
translate_with_warnings. - Translation
Options - Optional processing before conversion. Default settings preserve the input behavior of
translate.
Enums§
- Code
Series - Dispatch classification: a code is decoded/encoded either via the letter rules or the shape rules.
Port of
CodeSeries.java. - Code
Type - The supported Mongolian encodings. One variant per Java
CodeType(in declaration order).Zvvnmodis the intermediate hub. Port ofCodeType.javalines 14-20. - Mongol
Convert Error - Warning
- Something a conversion did beyond what its input said, including optional heuristic repairs.
Functions§
- restore_
menk_ shape_ emoji - Restore legacy SoftBank/iOS emoji that collide with MenkShape PUA.
- translate
- Convert
inputfrom one Mongolian encoding to another. UTF-8 in/out. - translate_
with_ options - Convert with optional input repair. Repairs run before source decoding, even when
from == to. With default options this is identical totranslate_with_warnings. - translate_
with_ warnings - Convert
inputfrom one Mongolian encoding to another, and say what the conversion had to do beyond what the input said. UTF-8 in/out. - version
- Crate version (currently just the Cargo package version). A table-provenance tag (the Java commit the generated tables come from) will be appended once tables exist.