Crate styx_cst 

styx-cst

Lossless Concrete Syntax Tree for the Styx configuration language. Preserves all whitespace and comments for formatting and refactoring tools.

Sponsors

Thanks to all individual sponsors:

…along with corporate sponsors:

…without whom this work could not exist.

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option. Lossless Concrete Syntax Tree for the Styx configuration language.

This crate provides a CST (Concrete Syntax Tree) representation of Styx documents using the rowan library. Unlike an AST, the CST preserves all source information including whitespace, comments, and exact token positions, making it ideal for tooling like formatters, refactoring tools, and language servers.

Features

• Lossless representation: Source text can be exactly reconstructed from the CST
• Cheap cloning: Syntax nodes use reference counting internally
• Parent pointers: Navigate up and down the tree
• Typed AST layer: Ergonomic wrappers over raw CST nodes
• Semantic validation: Check for issues like duplicate keys and mixed separators

Example

use styx_cst::{parse, ast::{AstNode, Document}};

let source = r#"
host localhost
port 8080
"#;

let parsed = parse(source);
assert!(parsed.is_ok());

let doc = Document::cast(parsed.syntax()).unwrap();
for entry in doc.entries() {
    if let Some(key) = entry.key_text() {
        println!("Found key: {}", key);
    }
}

// Roundtrip: source can be exactly reconstructed
assert_eq!(parsed.syntax().to_string(), source);

Validation

use styx_cst::{parse, validation::validate};

let source = "{ a 1, a 2 }"; // Duplicate key
let parsed = parse(source);
let diagnostics = validate(&parsed.syntax());

assert!(!diagnostics.is_empty());

Re-exports

pub use parser::Parse;

pub use parser::ParseError;

pub use parser::parse;

pub use syntax_kind::StyxLanguage;

pub use syntax_kind::SyntaxElement;

pub use syntax_kind::SyntaxKind;

pub use syntax_kind::SyntaxNode;

pub use syntax_kind::SyntaxToken;

pub use validation::Diagnostic;

pub use validation::Severity;

pub use validation::validate;

Modules

ast

Typed AST wrappers over CST nodes.

parser

CST parser for Styx using rowan’s GreenNodeBuilder.

syntax_kind

Syntax node and token kinds for the Styx CST.

validation

Semantic validation for Styx CST.

Structs

TextRange

A range in text, represented as a pair of TextSize.

TextSize

A measure of text length. Also, equivalently, an index into text.

Enums

TokenAtOffset

There might be zero, one or two leaves at a given offset.