Struct Synx 

pub struct Synx;

Main entry point for the SYNX parser.

Implementations

impl Synx

pub fn parse(text: &str) -> HashMap<String, Value>

Parse a SYNX string into a key-value map (static mode only).

pub fn parse_active(text: &str, opts: &Options) -> HashMap<String, Value>

Parse with full engine resolution (!active mode).

pub fn parse_full(text: &str) -> ParseResult

Parse and return full result including mode and metadata.

pub fn parse_tool(text: &str, opts: &Options) -> HashMap<String, Value>

Parse a !tool call: returns { tool: "name", params: { ... } }.

If the text is also !active, markers (:env, :default, etc.) are resolved before reshaping.

pub fn stringify(value: &Value) -> String

Stringify a Value back to SYNX format.

pub fn format(text: &str) -> String

Reformat a .synx string into canonical form:

• Keys sorted alphabetically at every nesting level
• Exactly 2 spaces per indentation level
• One blank line between top-level blocks (objects / lists)
• Comments stripped — canonical form is comment-free
• Directive lines (!active, !lock) preserved at the top

The same data always produces byte-for-byte identical output, making .synx files deterministic and noise-free in git diff.

pub fn compile(text: &str, resolved: bool) -> Vec<u8>

Compile a .synx string into compact binary .synxb format.

If resolved is true, active markers are resolved first (requires !active mode) and metadata is stripped from the output.

pub fn decompile(data: &[u8]) -> Result<String, String>

Decompile a .synxb binary back into a human-readable .synx string.

pub fn is_synxb(data: &[u8]) -> bool

Check if data is a .synxb binary file.

pub fn diff( a: &HashMap<String, Value>, b: &HashMap<String, Value>, ) -> DiffResult

Structural diff between two parsed SYNX objects.

Returns added / removed / changed / unchanged keys.