Struct DetectedLanguage 

pub struct DetectedLanguage {
    pub name: String,
    pub display_name: String,
    pub highlighter: HighlightEngine,
    pub ts_language: Option<Language>,
}

The result of language detection — groups the things that must stay in sync on an EditorState: the language ID, display name, highlighting engine, and tree-sitter Language (used for reference highlighting, indentation, etc.).

Fields

name: String

The canonical language ID for LSP and config lookup (e.g., “csharp”, “rust”, “text”).

display_name: String

Human-readable display name shown in the status bar and Set Language prompt (e.g., “C#”, “Rust”, “Plain Text”). Matches the syntect syntax name where available.

highlighter: HighlightEngine

The highlighting engine to use for this buffer.

ts_language: Option<Language>

The tree-sitter Language, if available (used for reference highlighting, auto-indent, bracket matching, etc.). Only ~18 languages have tree-sitter support; this is None for the remaining 100+ syntect-only languages.

Implementations

impl DetectedLanguage

pub fn from_entry(entry: &GrammarEntry, registry: &GrammarRegistry) -> Self

Build a DetectedLanguage from a unified catalog entry.

The single place that glues a GrammarEntry to a HighlightEngine. All path-based and name-based constructors funnel through this.

pub fn from_path( path: &Path, first_line: Option<&str>, registry: &GrammarRegistry, languages: &HashMap<String, LanguageConfig>, ) -> Self

Detect language from a file path using user configuration.

This is the primary detection path used when opening, reloading, or saving files. Priority order matches the grammar registry:

1. Exact filename match in user config
2. Glob pattern match in user config
3. Extension match in user config
4. Built-in detection (catalog lookup)
5. Shebang / first-line regex against first_line (catalog lookup)
6. Fallback config (if set and no other match found)

first_line is the literal first line of the file (including any trailing newline). The caller — which has already loaded the buffer via the FileSystem trait — supplies it so the registry never does its own I/O. Pass None when there is no content to inspect (e.g., virtual buffers, unsaved files).

pub fn from_path_with_fallback( path: &Path, first_line: Option<&str>, registry: &GrammarRegistry, languages: &HashMap<String, LanguageConfig>, default_language: Option<&str>, ) -> Self

Like from_path, but also accepts an optional default language name that is applied when no language is detected (#1219). The default_language must reference a key in the languages map.

pub fn from_syntax_name( name: &str, registry: &GrammarRegistry, languages: &HashMap<String, LanguageConfig>, ) -> Option<Self>

Set language by syntax name (user selected from the language palette).

Looks up the entry in the unified catalog. The languages config is used to resolve the canonical language ID (e.g., “Rust” syntax → “rust” config key). Returns None if the name matches no catalog entry.

pub fn plain_text() -> Self

Plain text — no highlighting.

pub fn from_virtual_name(name: &str, registry: &GrammarRegistry) -> Self

Detect language from a virtual buffer name like *OLD:test.ts* or *OURS*.c.

Strips surrounding * characters and extracts the filename after any prefix like “OLD:” or “NEW:”.