ETS-backed registry for named editor commands.
Commands are stored by name (atom) in an ETS table with read_concurrency: true for lock-free lookups on the hot path. A companion ETS table stores the source that contributed each command so config reloads and extension unloads can remove everything owned by one source without touching other contributions.
Sources
A command can be owned by :builtin, :config, or {:extension, name}. Registering the same command name from the same source replaces that source's previous value. Registering a duplicate name from a different source is rejected deterministically.
Built-in command providers are seeded through the same source-owned registration path used by config and extensions.
Summary
Types
Source that contributed registry entries.
Command registration failure reason.
Registry server name or pid. Used as the ETS table name.
Functions
Returns all registered commands as a list.
Returns a specification to start this module under a supervisor.
Looks up a command by name.
Registers a config-owned command with the given name, description, and execute function.
Registers a command with an explicit source.
Registers a config-owned pre-built %Command{} struct.
Registers a pre-built %Command{} struct with an explicit source.
Registers multiple commands for one source as a group.
Registers every command returned by a provider module for one source.
Resets the registry to built-in commands only.
Starts the command registry as a named GenServer that owns ETS tables.
Removes a command by name regardless of source.
Removes every command contributed by a source.
Types
@type contribution_source() :: :builtin | :config | {:extension, atom()}
Source that contributed registry entries.
@type register_error() :: {:duplicate_name, atom(), existing_source :: contribution_source(), attempted_source :: contribution_source()} | {:duplicate_names, [atom()]}
Command registration failure reason.
@type server() :: GenServer.server()
Registry server name or pid. Used as the ETS table name.
Functions
@spec all(server()) :: [Minga.Command.t()]
Returns all registered commands as a list.
Returns a specification to start this module under a supervisor.
See Supervisor.
@spec lookup(server(), atom()) :: {:ok, Minga.Command.t()} | :error
Looks up a command by name.
@spec register(server(), atom(), String.t(), function()) :: :ok | {:error, register_error()}
Registers a config-owned command with the given name, description, and execute function.
@spec register(server(), contribution_source(), atom(), String.t(), function()) :: :ok | {:error, register_error()}
Registers a command with an explicit source.
@spec register_command(server(), Minga.Command.t()) :: :ok | {:error, register_error()}
Registers a config-owned pre-built %Command{} struct.
@spec register_command(server(), contribution_source(), Minga.Command.t()) :: :ok | {:error, register_error()}
Registers a pre-built %Command{} struct with an explicit source.
@spec register_commands(server(), contribution_source(), [Minga.Command.t()]) :: :ok | {:error, register_error()}
Registers multiple commands for one source as a group.
@spec register_provider(server(), contribution_source(), module()) :: :ok | {:error, register_error()}
Registers every command returned by a provider module for one source.
@spec reset() :: :ok
Resets the registry to built-in commands only.
@spec reset(server()) :: :ok
@spec start_link(keyword()) :: GenServer.on_start()
Starts the command registry as a named GenServer that owns ETS tables.
Removes a command by name regardless of source.
@spec unregister_source(contribution_source()) :: :ok
Removes every command contributed by a source.
@spec unregister_source(server(), contribution_source()) :: :ok