New toAnyInt builder

[LVMVRQUXL]

🤔 The problem

Currently with Kotools Types, converting a number to an AnyInt for using its explicit API introduces too much boilerplate code.
Here's an example for converting a random Int to an AnyInt:

val x: AnyInt = Random.nextInt()
    .toNonZeroInt()
    .getOrNull()
    ?: ZeroInt
println(x)

💡 The idea

For facilitating the conversion to an AnyInt, we would like to add a toAnyInt builder on all platforms for creating an AnyInt from a Number, which may involve rounding or truncation.
Here's the signature of this new declaration with some examples:

/**
 * Returns this number as an [AnyInt], which may involve rounding or truncation.
 */
fun Number.toAnyInt(): AnyInt

val x: AnyInt = 1.toAnyInt() // returns an instance of StrictlyPositiveInt
val y: AnyInt = (-1).toAnyInt() // returns an instance of StrictlyNegativeInt
val z: AnyInt = 0.toAnyInt() // returns a ZeroInt object

✅ Checklist

Here's the checklist for implementing this idea:

• New toAnyInt builder #130
• Stabilization of the toAnyInt builder #131

🙏 Help needed

Please give this post a reaction if you are interested in this declaration and comment below your thoughts on it.
We would love to have your feedback!

[LVMVRQUXL]

We will not implement this idea because we will remove the AnyInt type in the idea #271.