@spec add_damage(
  t(),
  non_neg_integer(),
  non_neg_integer(),
  non_neg_integer(),
  non_neg_integer()
) :: t()

Adds a damage region to the active buffer.

@spec clear(t()) :: t()

Clears the active buffer.

@spec clear_damage(t()) :: t()

Clears damage regions (stub).

@spec clear_damage_regions(t()) :: t()

Clears all damage regions from the active buffer.

@spec constrain_position(t(), integer(), integer()) :: {integer(), integer()}

Constrains a position to buffer bounds (stub).

@spec get_active_buffer(t()) :: Raxol.Terminal.ScreenBuffer.Core.t()

Gets the currently active buffer.

@spec get_damage_regions(t()) :: [tuple()]

Gets all damage regions from the active buffer.

@spec get_memory_stats(t()) :: map()

Gets memory usage statistics.

@spec get_memory_usage(t()) :: non_neg_integer()

Gets current memory usage in bytes.

@spec get_metrics(t()) :: map()

Gets all metrics.

@spec get_position(t()) :: {integer(), integer()}

Gets current cursor position (stub).

@spec get_total_lines(t()) :: non_neg_integer()

Gets total lines in buffer including scrollback (stub).

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

Gets visible content as string (stub).

@spec get_visible_lines(t()) :: non_neg_integer()

Gets visible lines count (stub).

@spec initialize_buffers(
  non_neg_integer(),
  non_neg_integer(),
  non_neg_integer()
) :: t()

Initializes buffers (stub for test compatibility).

@spec mark_all_damaged(t()) :: t()

Marks the entire buffer as damaged.

@spec move_to(t(), integer(), integer()) :: t()

Moves cursor to position (stub).

@spec new(non_neg_integer(), non_neg_integer(), keyword()) :: t()

Creates a new buffer manager with main and alternate buffers.

@spec read(
  t(),
  keyword()
) :: binary() | list()

Reads data from the active buffer (stub for test compatibility).

@spec record_clear(t()) :: t()

Increments a clear operation metric.

@spec record_scroll(t()) :: t()

Increments a scroll operation metric.

@spec record_write(t()) :: t()

Increments a write operation metric.

@spec reset_metrics(t()) :: t()

Resets metrics.

@spec reset_position(t()) :: t()

Resets cursor position to origin (stub).

@spec resize(t(), non_neg_integer(), non_neg_integer()) :: t()

Resizes both buffers.

@spec start_link(keyword()) :: {:ok, pid()} | {:error, term()}

Starts a GenServer for the manager (stub for test compatibility).

@spec switch_buffer(t(), :main | :alternate) :: t()

Switches between main and alternate buffers.

@spec switch_to_alternate(t()) :: t()

Switches to alternate buffer (convenience function).

@spec switch_to_main(t()) :: t()

Switches to main buffer (convenience function).

@spec toggle_buffer(t()) :: t()

Toggles between main and alternate buffers.

@spec trim_if_needed(t()) :: t()

Trims scrollback if exceeding memory limits.

@spec update_active_buffer(t(), (Raxol.Terminal.ScreenBuffer.Core.t() ->
                             Raxol.Terminal.ScreenBuffer.Core.t())) :: t()

@spec update_active_buffer(t(), Raxol.Terminal.ScreenBuffer.Core.t()) :: t()

Updates the active buffer.

Can accept either:

• A function that transforms the current buffer
• A new buffer to replace the current one

@spec update_memory_usage(t()) :: t()

Updates memory usage calculation.

@spec update_position(
  t(),
  {integer(), integer()}
) :: t()

Updates cursor position with delta (stub).

@spec update_visible_region(t(), non_neg_integer()) :: t()

Updates visible region for scrolling (stub).

@spec within_memory_limits?(t()) :: boolean()

Checks if within memory limits.

@spec write(t(), binary(), keyword()) :: {:ok, t()} | t()

Writes data to the active buffer (stub for test compatibility).