Struct WitLanguageSpec 

pub struct WitLanguageSpec {
    pub name: String,
    pub extensions: Vec<String>,
    pub grammar_name: Option<String>,
    pub grammar: Vec<u8>,
    pub highlights: Option<String>,
    pub folds: Option<String>,
    pub injections: Option<String>,
    pub indents: Option<String>,
    pub textobjects: Option<String>,
    pub conceal_rules: Vec<ConcealRule>,
}

The wire record, as bindgen generates it. Taken whole by validate_language rather than splatted into nine positional arguments — the fields are all String/Option<String>, so a positional signature is exactly the shape a caller silently gets wrong. Everything the host needs to make a language real.

Fields

name: String

The grammar’s tree-sitter name — org for tree_sitter_org. Becomes the language id :set filetype and :describe-buffer report, and the key its queries are cached under. MUST match the grammar’s exported entry point or the module loads with nothing to call.

A name that collides with a bundled language is REFUSED, not shadowed: a plugin silently replacing rust would be a miserable thing to debug. Claiming a bundled extension is allowed but never wins, because the native table is consulted first.

extensions: Vec<String>

["org"] — extensions that select this language, matched case-insensitively, with or without a leading dot. A language with none can never be selected and is refused as a manifest mistake.

grammar_name: Option<String>

The grammar’s own entry-point name, when it differs from name.

load_language finds a grammar by its tree_sitter_<x> export, and that is not always what users call the language. lattice’s own bundled sql is the case in point: the grammar is tree-sitter-sequel and exports tree_sitter_sequel, while the language everyone types is sql. Absent means “same as name”, which is the common case.

grammar: Vec<u8>

The grammar, compiled to wasm. tree-sitter build --wasm produces one; so does scripts/build-wasm-grammar.sh with nothing but clang and a rustup toolchain.

highlights: Option<String>

Tree-sitter queries, as source. Absent means that feature is simply unavailable for this language — never an error.

All of these compile at REGISTRATION, not first use. A malformed query is the plugin author’s mistake and must surface at load with the offending query named; compiling lazily would turn a typo in folds.scm into “folding silently does nothing”, which is indistinguishable from the feature not existing and surfaces days later.

folds: Option<String>

injections: Option<String>

indents: Option<String>

textobjects: Option<String>

conceal_rules: Vec<ConcealRule>

H.2: what to hide when rendering this language, empty for most languages.

A refused rule is dropped, not fatal — deliberately unlike a malformed query above, which rejects the whole language. The asymmetry is the proportionality: a broken folds.scm means the language cannot fold at all, and silence there is indistinguishable from the feature not existing; a broken conceal rule means one pattern does not hide, the others are unaffected, and the language is otherwise entirely usable. Losing a language over a typo in a cosmetic regex would cost far more than it protects.

Trait Implementations

impl Clone for LanguageSpec

fn clone(&self) -> LanguageSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ComponentType for LanguageSpec

impl Debug for LanguageSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Lift for LanguageSpec

impl Lower for LanguageSpec