@spec bump_major(String.t()) :: String.t() | :error

Increment the major version (resets minor and patch to 0).

@spec bump_minor(String.t()) :: String.t() | :error

Increment the minor version (resets patch to 0).

@spec bump_patch(String.t()) :: String.t() | :error

Increment the patch version.

@spec compare(String.t(), String.t()) :: :gt | :eq | :lt

Compare two version strings.

Returns :gt, :eq, or :lt.

@spec gt?(String.t(), String.t()) :: boolean()

Check if version a is greater than version b.

@spec latest([String.t()]) :: String.t() | nil

Get the latest (highest) version from a list.

@spec lt?(String.t(), String.t()) :: boolean()

Check if version a is less than version b.

@spec major(String.t()) :: non_neg_integer() | :error

Get the major version number from a version string.

@spec minor(String.t()) :: non_neg_integer() | :error

Get the minor version number from a version string.

@spec parse_triple(String.t()) ::
  {:ok, {non_neg_integer(), non_neg_integer(), non_neg_integer()}} | :error

Parse a version string into {major, minor, patch} tuple.

Returns :error for invalid versions.

@spec prerelease?(String.t()) :: boolean()

Check if a version is a prerelease (has a pre tag).

@spec sort([String.t()]) :: [String.t()]

Sort a list of version strings.