addSbtPlugin("africa.shuwari" % "sbt-version" % "<version>")

//> using dep "africa.shuwari::version::<version>"

import version.*

// Parse
val v = Version.parse("2.1.0-rc.1+build.123") // Either[ParseError, Version]

// Construct
val release = Version(
  MajorVersion.fromUnsafe(1),
  MinorVersion.fromUnsafe(2),
  PatchNumber.fromUnsafe(3)
) // 1.2.3

// Operations
release.nextMinor // 1.3.0
release.toSnapshot // 1.2.3-snapshot
release.as[PreReleaseClassifier.Alpha.type] // 1.2.3-alpha.1

// Include build metadata
versionShow := Some(Version.Show.Extended)

// Custom format with 'v' prefix
versionShow := Some(new Version.Show {
  extension (v: Version) def show: String =
    s"v${v.major.value}.${v.minor.value}.${v.patch.value}" +
      v.preRelease.fold("")(pr => s"-${pr.show}")
})

// Standard (default) — excludes build metadata
version.value // "1.2.3-snapshot"

// Extended — includes build metadata
versionShow := Some(Version.Show.Extended)
version.value // "1.2.3-snapshot+pr42.branchmain.commits5.sha1a2b3c4"

// Direct access to Version with any Show instance

import version.Version.Show.Extended

resolvedVersion.value.show(using Extended)

import version.cli.core.VersionCliCore
import version.cli.core.domain.CliConfig

val config = CliConfig(
  repo = os.pwd,
  basisCommit = "HEAD",
  prNumber = Some(42),
  branchOverride = None,
  shaLength = 12
)

VersionCliCore.resolve(config) match
  case Right(v) => println(v.show)
  case Left(err) => System.err.println(err.message)

import version.*

// Safe construction
MajorVersion.from(1) // Right(MajorVersion(1))
MajorVersion.from(-1) // Left(InvalidMajorVersion(-1))

// Unsafe construction
MajorVersion.fromUnsafe(1)

// Extension syntax
1.as[MajorVersion] // Right(MajorVersion(1))

import version.*

PreRelease.snapshot // snapshot
PreRelease.alpha(PreReleaseNumber.fromUnsafe(1)) // alpha.1
PreRelease.releaseCandidate(PreReleaseNumber.fromUnsafe(2)) // rc.2

// Validated construction
PreRelease.from(PreReleaseClassifier.Alpha, Some(PreReleaseNumber.fromUnsafe(1))) // Right(...)
PreRelease.from(PreReleaseClassifier.Alpha, None) // Left(MissingPreReleaseNumber)

import version.*

// Combined identifiers normalised (rc3 → rc.3)
Version.parse("1.2.3-rc3") // Right(1.2.3-rc.3)
Version.parse("v2.0.0-alpha.1") // Right(2.0.0-alpha.1)

// With build metadata
Version.parse("1.0.0+build.123") // Right(1.0.0+build.123)

// Extension syntax
"1.2.3".toVersion // Either[ParseError, Version]

import version.*

val v = Version.parseUnsafe("2.0.5")

// Increment (clears pre-release and metadata)
v.nextMajor // 3.0.0
v.nextMinor // 2.1.0
v.nextPatch // 2.0.6
v.next[MajorVersion] // 3.0.0 (generic)

// Pre-release
v.toSnapshot // 2.0.5-snapshot
v.as[PreReleaseClassifier.Alpha.type] // 2.0.5-alpha.1
v.as[PreReleaseClassifier.Beta.type](3) // 2.0.5-beta.3

val alpha = v.as[PreReleaseClassifier.Alpha.type]
alpha.advance[PreReleaseClassifier.Alpha.type] // 2.0.5-alpha.2
alpha.advance[PreReleaseClassifier.Beta.type] // 2.0.5-beta.1

// Finalise
alpha.release // 2.0.5

// Query
v.isStable // true (major > 0)
v.isFinal // true (no pre-release)
v.isPreRelease // false
v.isSnapshot // false
v.core // Version without pre-release/metadata

import version.*

val v = Version.parseUnsafe("1.2.3-alpha.1+sha1234567")

// Standard (excludes build metadata) — default
v.show // "1.2.3-alpha.1"

// Extended (includes build metadata)
v.show(using Version.Show.Extended) // "1.2.3-alpha.1+sha1234567"

// toString uses extended format
v.toString // "1.2.3-alpha.1+sha1234567"

import version.*

val versions = List("1.0.0", "1.0.0-alpha.1", "1.0.0-rc.1", "0.9.0").map(Version.parseUnsafe)
versions.sorted // 0.9.0, 1.0.0-alpha.1, 1.0.0-rc.1, 1.0.0

import version.*
import version.codecs.jsoniter.given
import com.github.plokhotnyuk.jsoniter_scala.core.*

val v = Version.parseUnsafe("1.2.3-alpha.1")
val json = writeToString(v)
val decoded = readFromString[Version](json)

import version.*
import version.codecs.zio.given
import zio.json.*

val v = Version.parseUnsafe("1.2.3")
val json = v.toJson
val decoded = json.fromJson[Version]

import version.*
import version.codecs.yaml.given
import org.virtuslab.yaml.*

val v = Version.parseUnsafe("1.2.3")
val yaml = v.asYaml

import version.*
import version.zio.prelude.given
import zio.prelude.*

val v1 = Version.parseUnsafe("1.0.0")
val v2 = Version.parseUnsafe("2.0.0")

Ord[Version].compare(v1, v2) // Ordering.LessThan
Equal[Version].equal(v1, v1) // true