@spec check(map(), map(), map()) :: [outdated_entry()]

Checks a lockfile against wanted ranges and latest versions.

Given a lockfile (installed versions) and deps (wanted ranges from package.json), and a map of latest versions from the registry, returns a list of outdated entries.

@spec compute([{String.t(), String.t(), String.t()}]) :: [map()]

Computes all available updates from {name, current, latest} tuples.

@spec filter_by_type([outdated_entry()], :major | :minor | :patch) :: [
  outdated_entry()
]

Filters outdated entries by update type.

@spec format([map()]) :: String.t()

Formats updates for display.

@spec format_entry(outdated_entry()) :: String.t()

Formats an outdated entry as a human-readable string.

@spec group_by_type([map()]) :: map()

Groups updates by type.

@spec summary([outdated_entry()] | [map()]) :: %{
  total: non_neg_integer(),
  major: non_neg_integer(),
  minor: non_neg_integer(),
  patch: non_neg_integer()
}

Returns a summary of outdated packages.

@spec update_type(String.t(), String.t()) :: :major | :minor | :patch | :current

Classifies an update type.