@spec all() :: %{required(option_name()) => term()}

Returns all current global option values as a map.

Returns a specification to start this module under a supervisor.

See Supervisor.

@spec default(option_name()) :: term()

Returns the default value for an option.

@spec extension_option_description(atom(), atom()) :: String.t() | nil

Returns the description string for an extension option, or nil if not found.

Used by SPC h v (describe option) and other introspection features.

@spec extension_schema(atom()) :: [Minga.Extension.option_spec()] | nil

Returns the registered option schema for an extension, or nil if the extension has no schema.

@spec get(option_name()) :: term()

Gets the current global value of an option, falling back to its default.

@spec get_extension_option(atom(), atom()) :: term()

Gets an extension option value, falling back to its registered default.

Examples

Config.Options.get_extension_option(:minga_org, :conceal)
# => true

@spec get_extension_option_for_filetype(atom(), atom(), atom() | nil) :: term()

Gets an extension option with filetype override applied.

Checks filetype-specific override first, then falls back to the global extension option value.

@spec get_for_filetype(option_name(), atom() | nil) :: term()

Gets an option value with filetype override applied.

Checks filetype-specific settings first, then falls back to the global value. If filetype is nil, returns the global value.

@spec option_specs() :: [option_spec()]

Returns the full option spec list: [{name, type, default}].

Used by Config.Completion to generate completion items with type and default information in the detail text.

@spec register_extension_schema(atom(), [Minga.Extension.option_spec()], keyword()) ::
  :ok | {:error, String.t()}

Registers a typed option for use by an extension.

Registers a full option schema for an extension and validates user config against it. Called by Extension.Supervisor at load time, not by extensions directly.

Each spec in the schema is stored under {:extension, ext_name, opt_name} in ETS, with type metadata under {:extension_schema, ext_name}.

User config values that match a schema entry are validated and stored. Unknown keys produce a warning log. Type mismatches return an error.

@spec reset() :: :ok

Resets all options (global and per-filetype) to defaults.

@spec set(option_name(), term()) :: {:ok, term()} | {:error, String.t()}

Sets a global option value after type validation.

Returns {:ok, value} on success or {:error, reason} if the option name is unknown or the value has the wrong type.

@spec set_extension_option(atom(), atom(), term()) ::
  {:ok, term()} | {:error, String.t()}

Sets an extension option value after type validation.

Examples

Config.Options.set_extension_option(:minga_org, :conceal, false)
# => {:ok, false}

@spec set_extension_option_for_filetype(atom(), atom(), atom(), term()) ::
  {:ok, term()} | {:error, String.t()}

Sets an extension option override for a specific filetype.

The value is validated against the extension's registered schema.

Examples

Config.Options.set_extension_option_for_filetype(:minga_org, :org, :conceal, false)

@spec set_for_filetype(atom(), option_name(), term()) ::
  {:ok, term()} | {:error, String.t()}

Sets an option override for a specific filetype.

The value is validated the same way as global options.

@spec start_link(keyword()) :: GenServer.on_start()

Starts the options registry and creates the backing ETS table.

@spec type_for(option_name()) :: type_descriptor() | nil

Returns the type descriptor for an option, or nil if unknown.

Used by Config.Completion to determine what value completions to offer (enum variants, booleans, etc.).

@spec valid_names() :: [option_name()]

Returns the list of valid option names.

@spec validate_option(atom(), term()) :: :ok | {:error, String.t()}

Validates an option name and value against the type registry.

Returns :ok if valid, or {:error, reason} if the name is unknown or the value has the wrong type. Used by Buffer.Server.set_option/3 to validate buffer-local option overrides.