@spec empty() :: Alaja.Cell.t()

Creates an empty cell (space, no colour, no effects).

Returns a %Cell{} struct filled with defaults.

@spec new_buffer(non_neg_integer(), non_neg_integer()) :: Alaja.Buffer.t()

Creates a new buffer with the given dimensions.

Returns a %Buffer{} with width * height empty cells stored in a flat tuple for O(1) access.

@spec print(keyword() | list()) :: :ok

Prints a table to stdout.

Delegates to Alaja.Components.Table.print/2. Accepts a keyword list or a list of lists where the first row is treated as headers.

@spec print_error(String.t()) :: :ok

Prints an error message (icon: ✗).

@spec print_info(String.t()) :: :ok

Prints an informational message (icon: ℹ).

@spec print_raw(iodata()) :: :ok

Writes an iodata payload to stdout without any transformation.

Use this when you need to emit raw ANSI escapes (or any pre-formatted text) that should pass through untouched by Alaja's printers.

Example

Alaja.print_raw("\e[31mError\e[0m\n")

@spec print_raw(
  iodata(),
  keyword()
) :: :ok

Writes an iodata payload to a specific device (default :stdio).

Options

• :device — :stdio | {:fd, posix} | pid(). Defaults to :stdio.

Useful for writing to alternative file descriptors or to a process socket in interactive components.

@spec print_success(String.t()) :: :ok

Prints a success message (icon: ✓).

@spec print_warning(String.t()) :: :ok

Prints a warning message (icon: ⚠).

@spec rgb_to_hex({byte(), byte(), byte()}) :: String.t()

Converts an RGB tuple to uppercase hex string.

Examples

iex> Alaja.rgb_to_hex({255, 180, 0})
"#FFB400"

@spec run([String.t()], module()) :: any()

Unified entry point for running an Alaja-based CLI.

The default cli_module is Alaja.CLI (the self-hosted demo CLI shipped with the framework). Pass any module built with use Alaja.CLI.Definition, otp_app: :my_app, halt_on_error: true to run your own (escript-style aborts the BEAM on error). Set halt_on_error: false if you want main/1 to return {:error, reason} instead.

Both escript entry points and library callers should go through this function rather than calling cli_module.main/1 directly so the public facade has a single documented entry point.

Examples

# Library caller
Alaja.run(System.argv())

# Custom CLI
Alaja.run(System.argv(), MyApp.CLI)

# escript main_module
defmodule MyApp.CLIEntry do
  def main(argv), do: Alaja.run(argv, MyApp.CLI)
end