MingaEditor.Frontend.Manager (Minga v0.1.0)

Copy Markdown View Source

GenServer that manages the frontend renderer Port.

Operates in two modes depending on the MINGA_PORT_MODE env var:

  • Spawn mode (default): BEAM is the parent process. Port.Manager spawns the GUI/TUI binary as a child via Port.open({:spawn_executable, ...}). Used in development, TUI mode, and Burrito releases.

  • Connected mode (MINGA_PORT_MODE=connected): BEAM is a child of the GUI process. The GUI set up stdin/stdout pipes before launching us. Port.Manager opens {:fd, 0, 1} as a Port instead of spawning a child. Used when launching from Minga.app (Finder, Spotlight, Dock).

Both modes use identical {:packet, 4} framing. The protocol layer (event decoding, render commands, subscriber broadcasting) is the same.

Subscribers register via subscribe/1 and receive messages as:

{:minga_input, event}

where event is a MingaEditor.Frontend.Protocol.input_event().

Summary

Types

backend()

Renderer backend.

start_opt()

Options for starting the port manager.

state()

Internal state.

Functions

capabilities(server \\ __MODULE__)

Returns the frontend's reported capabilities.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

ready?(server \\ __MODULE__)

Returns whether the Zig renderer has sent its ready signal.

send_commands(server \\ __MODULE__, commands)

Sends a list of encoded render command binaries to the Zig renderer.

start_link(opts \\ [])

Starts the port manager.

subscribe(server \\ __MODULE__)

Subscribes the calling process to receive input events.

terminal_size(server \\ __MODULE__)

Returns the terminal size as {width, height}, or nil if not yet ready.

tty_path_for(tty_name)

Builds a /dev/ path from the tty name returned by ps -o tty=.

Types

backend()

@type backend() :: :tui | :gui

Renderer backend.

start_opt()

@type start_opt() ::
  {:name, GenServer.name()}
  | {:renderer_path, String.t()}
  | {:backend, backend()}
  | {:port_mode, MingaEditor.Frontend.Manager.State.port_mode()}
  | {:port_opener, (term(), [term()] -> port())}

Options for starting the port manager.

state()

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

Internal state.

Functions

capabilities(server \\ __MODULE__)

@spec capabilities(GenServer.server()) :: MingaEditor.Frontend.Capabilities.t()

Returns the frontend's reported capabilities.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

ready?(server \\ __MODULE__)

@spec ready?(GenServer.server()) :: boolean()

Returns whether the Zig renderer has sent its ready signal.

send_commands(server \\ __MODULE__, commands)

@spec send_commands(GenServer.server(), [binary()]) :: :ok

Sends a list of encoded render command binaries to the Zig renderer.

start_link(opts \\ [])

@spec start_link([start_opt()]) :: GenServer.on_start()

Starts the port manager.

subscribe(server \\ __MODULE__)

@spec subscribe(GenServer.server()) :: :ok

Subscribes the calling process to receive input events.

terminal_size(server \\ __MODULE__)

@spec terminal_size(GenServer.server()) :: {pos_integer(), pos_integer()} | nil

Returns the terminal size as {width, height}, or nil if not yet ready.

tty_path_for(tty_name)

@spec tty_path_for(String.t()) :: String.t()

Builds a /dev/ path from the tty name returned by ps -o tty=.

The format varies by OS and version:

  • macOS long form: "ttys008" → "/dev/ttys008"
  • macOS short form: "s003" → "/dev/ttys003"
  • Linux: "pts/3" → "/dev/pts/3"

Checks if /dev/{name} exists first (handles long form and Linux). Falls back to /dev/tty{name} for short forms.