@spec capability_hints() :: map()

Returns terminal capability hints based only on the OS-version heuristic.

These hints describe possible VT-sequence support, not implemented native TermUI input, mouse, paste, focus, or resize support.

@spec disable_vt_processing() :: :ok

Disables VT sequence processing.

Note: Stub implementation.

@spec enable_vt_processing() :: {:ok, :stub} | {:error, String.t()}

Stub for enabling VT sequence processing for the console.

It does not change console mode. {:ok, :stub} only means the OS version meets the intended baseline; a future NIF/port must call SetConsoleMode.

@spec info() :: map()

Returns Windows-specific terminal information.

Note: Currently returns stub data as full implementation requires NIFs.

@spec meets_minimum_version?() :: boolean()

Checks if the current Windows version meets minimum requirements.

@spec minimum_version() :: {non_neg_integer(), non_neg_integer(), non_neg_integer()}

Returns the intended minimum Windows version for a future full implementation. Full native Windows support is not present in 1.0.

@spec terminal_size() :: {pos_integer(), pos_integer()}

Returns terminal size on Windows.

Note: Stub using Erlang's :io module. For accurate results, would need GetConsoleScreenBufferInfo via NIF.

@spec vt_support_available?() :: boolean()

Returns an OS-version eligibility heuristic for Windows VT sequences.

This stub does not call GetConsoleMode, confirm that VT processing is enabled, or indicate that TermUI's native input/resize paths are implemented.

@spec windows_version() ::
  {non_neg_integer(), non_neg_integer(), non_neg_integer()} | nil

Returns the Windows version.