Struct CommandRegistry 

pub struct CommandRegistry { /* private fields */ }

Registry for managing editor commands

Supports both built-in commands and dynamically registered plugin commands. Thread-safe for use across multiple threads (e.g., from async tasks).

Implementations

impl CommandRegistry

pub fn new() -> Self

Create a new command registry with built-in commands

pub fn refresh_builtin_commands(&mut self)

Refresh built-in commands (e.g. after locale change)

pub fn record_usage(&mut self, command_name: &str)

Record that a command was used (for history/sorting)

This moves the command to the front of the history list. Recently used commands appear first in suggestions.

pub fn register(&self, command: Command)

Register a new command (typically from a plugin)

If a command with the same name already exists, it will be replaced. This allows plugins to override built-in commands. Note: For plugin commands, prefer try_register which enforces first-writer-wins semantics. This method is kept for internal use and hot-reload scenarios.

pub fn try_register( &self, command: Command, ) -> Result<(), (String, CommandSource)>

Try to register a command, failing if a command with the same name is already registered by a different plugin (first-writer-wins).

Returns Ok(()) on success, or Err with the name of the existing plugin that owns the command.

pub fn unregister(&self, name: &str)

Unregister a command by name

pub fn unregister_by_prefix(&self, prefix: &str)

Unregister all commands whose name starts with a prefix

pub fn unregister_by_plugin(&self, plugin_name: &str)

Unregister all commands registered by a specific plugin

pub fn get_all(&self) -> Vec<Command>

Get all commands (built-in + plugin)

pub fn filter( &self, query: &str, current_context: KeyContext, keybinding_resolver: &KeybindingResolver, selection_active: bool, active_custom_contexts: &HashSet<String>, active_buffer_mode: Option<&str>, has_lsp_config: bool, ) -> Vec<Suggestion>

Filter commands by fuzzy matching query with context awareness

When query is empty, commands are sorted by recency (most recently used first). When query is not empty, commands are sorted by match quality (fzf-style scoring) with recency as tiebreaker for equal scores. Disabled commands always appear after enabled ones.

has_lsp_config indicates whether the active buffer’s language has an LSP server configured. When false, LSP start/restart/toggle commands are disabled.

pub fn plugin_command_count(&self) -> usize

Get count of registered plugin commands

pub fn total_command_count(&self) -> usize

Get count of total commands (built-in + plugin)

pub fn find_by_name(&self, name: &str) -> Option<Command>

Find a command by exact name match

Trait Implementations

impl Default for CommandRegistry

fn default() -> Self

Returns the “default value” for a type.