Injects the Minga.Extension behaviour, DSL macros (option/3, command/3, keybind/4, keybind/5), and a default child_spec/1.

The option macro

Declares a typed config option the extension accepts:

option :conceal, :boolean, default: true
option :heading_bullets, :string_list, default: ["◉", "○", "◈", "◇"]

At compile time, these are accumulated into __option_schema__/0, a generated function the framework reads at load time to validate user config and register options in ETS.

The command macro

Declares an editor command the extension provides:

command :org_cycle_todo, "Cycle TODO keyword",
  execute: {MingaOrg.Todo, :cycle},
  requires_buffer: true

Accumulated into __command_schema__/0. The framework registers these in Minga.Command.Registry when the extension loads. The execute MFA must be a {Module, :function} tuple whose function accepts editor state and returns new state.

The keybind macro

Declares a keybinding the extension provides:

keybind :normal, "SPC m t", :org_cycle_todo, "Cycle TODO", filetype: :org

Accumulated into __keybind_schema__/0. The framework registers these in Minga.Keymap.Active when the extension loads.

Supported option types

:boolean, :pos_integer, :non_neg_integer, :integer, :string, :string_or_nil, :string_list, :atom, {:enum, [atoms]}, :map_or_nil, :any.

Declares a runtime or UI capability this extension uses.

Capabilities are declarative and are available through Minga.Extension.Manifest before init/1 runs. They should describe contribution surfaces or runtime needs, not perform side effects.

Declares an editor command this extension provides.

Accumulated at compile time and exposed via __command_schema__/0. The framework auto-registers these commands when the extension loads.

Options

• :execute (required) — {Module, :function} MFA tuple. The function receives editor state and returns new state.
• :requires_buffer — when true, command is skipped if no buffer is active (default: false)

Examples

command :org_cycle_todo, "Cycle TODO keyword",
  execute: {MingaOrg.Todo, :cycle},
  requires_buffer: true

command :org_toggle_checkbox, "Toggle checkbox",
  execute: {MingaOrg.Checkbox, :toggle},
  requires_buffer: true

Declares a keybinding this extension provides.

Accumulated at compile time and exposed via __keybind_schema__/0. The framework auto-registers these keybindings when the extension loads.

Examples

keybind :normal, "SPC m t", :org_cycle_todo, "Cycle TODO"
keybind :normal, "M-h", :org_promote_heading, "Promote heading", filetype: :org

Declares when this extension should be loaded.

Extensions default to :eager (loaded at boot). Use this macro to defer loading until the extension is actually needed.

Policies

• :eager — compile + init at boot. Required for extensions that contribute first-paint UI (modeline segments, themes, dashboard).
• :deferred — loaded in the background shortly after first paint.
• {:on_command, [:cmd1, :cmd2]} — loaded when any listed command is first invoked. Commands and keybindings are registered as stubs at boot; the extension loads transparently on first use.
• {:on_filetype, [:elixir, :rust]} — reserved for future use. Registers stubs like on_command but filetype-open events do not yet trigger autoload automatically.
• {:on_key, [normal: "SPC m"]} — reserved for future use. Registers stubs like on_command but key-press events do not yet trigger autoload automatically.

Examples

load_policy :deferred
load_policy {:on_command, [:toggle_board]}

@spec manifest(module(), Minga.Extension.Manifest.source_type()) ::
  Minga.Extension.Manifest.t()

Builds a public manifest for a loaded extension module.

This calls the extension's declaration callbacks directly, so callback failures can raise or exit. Use Minga.Extension.Supervisor.start_extension/5 if you want those failures converted into load errors instead of propagating.

Declares a modeline segment this extension provides.

The block receives ctx, the same context map used by built-in modeline segments, and returns a segment tuple, a list of segment tuples, nil, or [].

Examples

modeline_segment :word_count, side: :right, priority: 50 do
  if ctx.data.filetype in [:markdown, :text, :org] do
    {" WORDS ", ctx.info_fg, ctx.bar_bg, [], nil}
  end
end

Declares a typed config option for this extension.

Accumulated at compile time and exposed via __option_schema__/0.

Options

• :default (required) — the default value when the user doesn't set it
• :description (required) — a short human-readable description shown by SPC h v

Examples

option :conceal, :boolean,
  default: true,
  description: "Hide markup delimiters and show styled content"

option :format, {:enum, [:html, :pdf, :md]},
  default: :html,
  description: "Default export format"

option :heading_bullets, :string_list,
  default: ["◉", "○"],
  description: "Unicode bullets for heading levels (cycles when depth exceeds list length)"