Struct OptionRegistry 

pub struct OptionRegistry { /* private fields */ }

Thread-safe registry for all editor options.

This is the MECHANISM for option storage. POLICY (which options to register) is in modules.

Storage Model

OptionRegistry
├── specs: HashMap<String, OptionSpec>              # Option definitions
├── aliases: HashMap<String, String>                # Short -> Full name
├── global_values: HashMap<String, OptionValue>     # Global overrides
├── buffer_values: HashMap<(BufferId, String), OptionValue>   # Per-buffer
└── window_values: HashMap<(WindowId, String), OptionValue>   # Per-window

Thread Safety

All operations use RwLock for thread-safe access. Multiple readers allowed, single writer for mutations.

Implementations

impl OptionRegistry

pub fn new() -> Self

Create a new empty option registry.

pub fn register(&self, spec: OptionSpec) -> Result<(), OptionError>

Register an option specification.

Errors

Returns error if:

• Option with same name already exists
• Short alias conflicts with existing name or alias

pub fn unregister_by_module(&self, module_id: &ModuleId)

Unregister all options owned by a module.

Removes all option specs with matching owner, their aliases, and any stored values (global, buffer-local, window-local).

pub fn list_by_module(&self, module_id: &ModuleId) -> Vec<OptionSpec>

List all options owned by a module.

pub fn resolve_name(&self, name: &str) -> Option<String>

Resolve a name (which may be an alias) to the full option name.

pub fn get_spec(&self, name: &str) -> Option<OptionSpec>

Get an option specification by name (supports aliases).

pub fn contains(&self, name: &str) -> bool

Check if an option exists.

pub fn get(&self, name: &str, scope: OptionScopeId) -> Option<OptionValue>

Get the effective value of an option for a given scope.

Resolution order (most specific wins):

1. Window-local value (if scope is Window)
2. Buffer-local value (if scope is Buffer or has buffer context)
3. Global value (if set)
4. Default value from spec

pub fn get_global(&self, name: &str) -> Option<OptionValue>

Get global value (ignoring scope context).

pub fn get_for_buffer( &self, name: &str, buffer_id: BufferId, ) -> Option<OptionValue>

Get buffer-local value.

pub fn get_for_window( &self, name: &str, window_id: WindowId, ) -> Option<OptionValue>

Get window-local value.

pub fn set( &self, name: &str, value: OptionValue, scope: OptionScopeId, ) -> Result<SetResult, OptionError>

Set an option value at a specific scope.

Errors

Returns error if:

• Option not found
• Value fails validation
• Scope mismatch

pub fn set_global( &self, name: &str, value: OptionValue, ) -> Result<SetResult, OptionError>

Set global value.

Errors

Returns error if option not found or validation fails.

pub fn set_for_buffer( &self, name: &str, value: OptionValue, buffer_id: BufferId, ) -> Result<SetResult, OptionError>

Set buffer-local value.

Errors

Returns error if option not found, validation fails, or scope mismatch.

pub fn set_for_window( &self, name: &str, value: OptionValue, window_id: WindowId, ) -> Result<SetResult, OptionError>

Set window-local value.

Errors

Returns error if option not found, validation fails, or scope mismatch.

pub fn reset( &self, name: &str, scope: OptionScopeId, ) -> Result<Option<OptionValue>, OptionError>

Reset an option to its default value at a specific scope.

Errors

Returns error if option not found.

pub fn clear_buffer(&self, buffer_id: BufferId)

Reset all buffer-local values for a buffer (called when buffer closes).

pub fn clear_window(&self, window_id: WindowId)

Reset all window-local values for a window (called when window closes).

pub fn toggle( &self, name: &str, scope: OptionScopeId, ) -> Result<bool, OptionError>

Toggle a boolean option.

Errors

Returns error if option not found or is not boolean.

pub fn list_all(&self) -> Vec<String>

List all registered option names.

pub fn list_matching(&self, prefix: &str) -> Vec<OptionSpec>

List options matching a prefix (for tab completion).

pub fn list_by_scope(&self, scope: OptionScope) -> Vec<OptionSpec>

List options by scope.

pub fn len(&self) -> usize

Get the number of registered options.

pub fn is_empty(&self) -> bool

Check if the registry is empty.

Trait Implementations

impl Debug for OptionRegistry

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

Formats the value using the given formatter.

impl Default for OptionRegistry

fn default() -> OptionRegistry

Returns the “default value” for a type.