Struct SyntaxSessionState 

pub struct SyntaxSessionState { /* private fields */ }

Per-session syntax state stored in ExtensionMap.

Maps buffer IDs to their syntax drivers. Each buffer can have at most one syntax driver (language-specific highlighting).

Design Rationale

Originally the plan called for storing syntax drivers in the kernel’s Buffer struct. However, the kernel has a strict rule that it “depends only on arch”. Storing drivers here in the session layer:

• Preserves kernel purity (no syntax dependency in kernel)
• Maintains per-buffer semantics (each buffer has its own driver)
• Uses existing ExtensionMap pattern (consistent with VimSessionState)

Thread Safety

Access should be synchronized at the session level via with_state_mut().

Implementations

impl SyntaxSessionState

pub fn new() -> SyntaxSessionState

Create a new empty syntax state.

pub fn set_factory(&mut self, factory: Arc<dyn SyntaxDriverFactory>)

Set the factory used to create new syntax drivers.

Accepts Arc for shared ownership (populated from SyntaxFactoryStore).

pub fn factory(&self) -> Option<&dyn SyntaxDriverFactory>

Get the factory (if set).

pub fn set_registry(&mut self, registry: Arc<dyn LanguageRegistry>)

Set the language registry used for language detection.

pub fn registry(&self) -> Option<&dyn LanguageRegistry>

Get the language registry (if set).

pub fn detect_language(&self, path: &str) -> Option<String>

Detect language from a file path using the registry.

Returns None if no registry is set or the language is not recognized.

pub fn ensure_driver_from_path( &mut self, buffer_id: BufferId, path: &str, content: &str, ) -> bool

Ensure a driver exists for a buffer by detecting language from file path.

Combines language detection (via registry) and driver creation (via factory). Returns true if a driver exists after the call.

pub fn get(&self, buffer_id: BufferId) -> Option<&dyn SyntaxDriver>

Get a reference to the driver for a buffer.

pub fn get_mut(&mut self, buffer_id: BufferId) -> Option<&mut dyn SyntaxDriver>

Get a mutable reference to the driver for a buffer.

pub fn set(&mut self, buffer_id: BufferId, driver: Box<dyn SyntaxDriver>)

Set the driver for a buffer.

Replaces any existing driver for this buffer.

pub fn remove(&mut self, buffer_id: BufferId) -> Option<Box<dyn SyntaxDriver>>

Remove the driver for a buffer.

Call this when a buffer is closed to clean up resources.

pub fn has_driver(&self, buffer_id: BufferId) -> bool

Check if a buffer has a syntax driver.

pub fn ensure_driver( &mut self, buffer_id: BufferId, language_id: &str, content: &str, ) -> bool

Get or create a driver for a buffer.

If no driver exists and a factory is set, attempts to create one for the given language. Returns false if:

• No driver exists AND no factory is set
• No driver exists AND factory doesn’t support the language

After calling this, use get_mut() to access the driver.

pub fn len(&self) -> usize

Get the number of buffers with syntax drivers.

pub fn is_empty(&self) -> bool

Check if no buffers have syntax drivers.

pub fn clear(&mut self)

Clear all syntax drivers.

Trait Implementations

impl Debug for SyntaxSessionState

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

Formats the value using the given formatter.

impl Default for SyntaxSessionState

fn default() -> SyntaxSessionState

Returns the “default value” for a type.

impl SessionExtension for SyntaxSessionState

fn create() -> SyntaxSessionState

Create default state for a new session.

fn as_text_input_sink(&mut self) -> Option<&mut dyn TextInputSink>

Return self as a TextInputSink if this extension accepts text input.