Struct Mappings 

pub struct Mappings {
    pub expand: HashMap<String, String>,
    pub compress: HashMap<String, String>,
}

Mapping storage for bidirectional key translation

This is the ONLY caching mechanism needed. The HashMaps provide instant O(1) lookups with zero overhead after initial load.

Fields

expand: HashMap<String, String>

Short key → Full name (machine → human expansion) Example: “n” → “name”

compress: HashMap<String, String>

Full name → Short key (human → machine compression) Example: “name” → “n”

Implementations

impl Mappings

pub fn load() -> Result<Self, String>

Load mappings from .dx/serializer/mappings.dx

pub fn get() -> &'static Mappings

Get global mappings instance (lazy load)

pub fn expand_key(&self, key: &str) -> String

Expand short key to full name (machine → human)

The Smart Logic

IF key exists in mappings.dx:
    expand it (popular key)
ELSE:
    keep it as-is (custom key)

Examples

let m = Mappings::get();

// Popular keys: expand (using default mappings)
assert_eq!(m.expand_key("n"), "name");
assert_eq!(m.expand_key("v"), "version");
assert_eq!(m.expand_key("d"), "description");

// Custom keys: preserve
assert_eq!(m.expand_key("myCustomKey"), "myCustomKey");
assert_eq!(m.expand_key("userPrefs"), "userPrefs");

Performance

O(1) - Single HashMap lookup with instant fallback

pub fn compress_key(&self, key: &str) -> String

Compress full name to short key (human → machine)

The Smart Logic

IF key exists in mappings.dx:
    abbreviate it (popular key)
ELSE:
    keep it as-is (custom key)

Examples

let m = Mappings::get();

// Popular keys: abbreviate (using default mappings)
assert_eq!(m.compress_key("name"), "n");
assert_eq!(m.compress_key("version"), "v");
assert_eq!(m.compress_key("description"), "d");

// Custom keys: preserve
assert_eq!(m.compress_key("myCustomKey"), "myCustomKey");
assert_eq!(m.compress_key("userPrefs"), "userPrefs");

Performance

O(1) - Single HashMap lookup with instant fallback

Trait Implementations

impl Default for Mappings

fn default() -> Self

Returns the “default value” for a type.