MingaEditor (Minga v0.1.0)

Editor orchestration GenServer.

Ties together the buffer, port manager, viewport, and modal FSM. Receives input events from the Port Manager, routes them through Minga.Mode.process/3, executes the resulting commands against the buffer, recomputes the visible region, and sends render commands back to the Zig renderer.

The editor starts in Normal mode (Vim-style). The status line reflects the current mode: -- NORMAL --, -- INSERT --, etc.

Summary

Types

effect()

start_opt()

Options for starting the editor.

state()

Internal state.

Functions

cast(msg, server \\ __MODULE__)

Send an async message to the Editor GenServer. Used by background tasks.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

ensure_buffer_for_path(path, server \\ __MODULE__)

Ensures a buffer exists for the given file path, opening one if needed.

open_file(server \\ __MODULE__, file_path)

Opens a file in the editor.

refresh_gui_config_state(state)

Rebuilds the cached native settings snapshot (#2119).

render(server \\ __MODULE__)

Triggers a full re-render of the current state.

start_link(opts \\ [])

Starts the editor.

Types

effect()

@type effect() :: MingaEditor.Handlers.EffectHandler.effect()

start_opt()

@type start_opt() ::
  {:name, GenServer.name()}
  | {:backend, MingaEditor.State.backend()}
  | {:port_manager, GenServer.server()}
  | {:parser_manager, GenServer.server()}
  | {:keymap_server, GenServer.server()}
  | {:options_server, GenServer.server() | nil}
  | {:events_registry, Minga.Events.registry()}
  | {:buffer, pid()}
  | {:width, pos_integer()}
  | {:height, pos_integer()}
  | {:editing_model, :vim | :cua}
  | {:view_mode, Minga.CLI.view_mode()}
  | {:shell, :traditional | module()}
  | {:project_root, String.t() | nil}
  | {:swap_dir, String.t()}
  | {:session_dir, String.t()}
  | {:suppress_tool_prompts, boolean()}

Options for starting the editor.

state()

@type state() :: MingaEditor.State.t()

Internal state.

Functions

cast(msg, server \\ MODULE)

@spec cast(term(), GenServer.server()) :: :ok

Send an async message to the Editor GenServer. Used by background tasks.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

ensure_buffer_for_path(path, server \\ MODULE)

@spec ensure_buffer_for_path(String.t(), GenServer.server()) ::
  {:ok, pid()} | {:error, term()}

Ensures a buffer exists for the given file path, opening one if needed.

Delegates to the Editor GenServer so it can use the editor's options server for buffer creation, then registers the buffer in the workspace (buffer list, monitoring, log message). The buffer is added in the background without switching the active window.

Layer 2 callers that need workspace registration should use this function. Layer 1 callers (agent tools) should use Buffer.ensure_for_path/1 directly.

open_file(server \\ MODULE, file_path)

@spec open_file(GenServer.server(), String.t()) :: :ok | {:error, term()}