Minga.Extension.CallbackRegistry (Minga v0.1.0)

Copy Markdown View Source

Extension-only registry for declarative runtime editor callbacks.

Registration derives the extension source from lifecycle ownership and checks callback modules against the source's admitted artifact inventory. Core and config callbacks are intentionally not stored here; they execute directly in the layer that owns them.

Summary

Types

callback()

A callback returned in deterministic dispatch order.

family()

Runtime editor callback category available to extensions.

lifecycle_opts()

Options reserved for lifecycle-owned extension registration.

registry()

Named registry process and ETS table.

source()

An extension source that owns a registered callback.

Functions

callbacks(family, registry \\ Minga.Extension.CallbackRegistry)

Returns extension callbacks for a family in deterministic priority order.

callbacks_for_source(family, source, registry \\ Minga.Extension.CallbackRegistry)

Returns one extension source's callbacks in deterministic priority order.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

default_table()

Returns the production registry table name.

start_link(opts \\ [])

Starts a callback registry and its protected ETS table.

unregister_source(source, registry \\ Minga.Extension.CallbackRegistry)

Removes every callback owned by an extension source.

Types

callback()

@type callback() :: {source(), module()}

A callback returned in deterministic dispatch order.

family()

@type family() :: :buffer_saved | :editor_action | :source_unload

Runtime editor callback category available to extensions.

lifecycle_opts()

@type lifecycle_opts() :: [
  registry: registry(),
  artifact_admission: GenServer.server()
]

Options reserved for lifecycle-owned extension registration.

registry()

@type registry() :: atom()

Named registry process and ETS table.

source()

@type source() :: {:extension, atom()}

An extension source that owns a registered callback.

Functions

callbacks(family, registry \\ Minga.Extension.CallbackRegistry)

@spec callbacks(family(), registry()) :: [callback()]

Returns extension callbacks for a family in deterministic priority order.

callbacks_for_source(family, source, registry \\ Minga.Extension.CallbackRegistry)

@spec callbacks_for_source(family(), source(), registry()) :: [callback()]

Returns one extension source's callbacks in deterministic priority order.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

default_table()

@spec default_table() :: registry()

Returns the production registry table name.

start_link(opts \\ [])

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

Starts a callback registry and its protected ETS table.

unregister_source(source, registry \\ Minga.Extension.CallbackRegistry)

@spec unregister_source(source(), registry()) :: :ok

Removes every callback owned by an extension source.