BREAKING(semver): replace prerelease and buildmetadata arguments with options object

[iuioiua]

What's changed

The prerelease and buildmetadata arguments for increment() into a new optional IncrementOptions interface.

Motivation

This change was made to ensure the symbol adheres to the Deno Style Guide which states that optional arguments should go into an options object.

Migration

To migrate, use the options argument, instead of the positional arguments in increment().

import { increment, parse } from "./semver/mod.ts";

- increment(parse("1.2.3"), "prerelease", "alpha", "0");
+ increment(parse("1.2.3"), "prerelease", { prerelease: "alpha", build: "0" });

Related

Closes #4420

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.35%. Comparing base (3af2ed3) to head (cb1ad64).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5471      +/-   ##
==========================================
- Coverage   96.35%   96.35%   -0.01%     
==========================================
  Files         463      463              
  Lines       37729    37728       -1     
  Branches     5568     5568              
==========================================
- Hits        36355    36354       -1     
  Misses       1332     1332              
  Partials       42       42              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[kt3k]

LGTM