✨ New Zero type

[LVMVRQUXL]

📝 Description

We want to introduce a Zero experimental type, in the org.kotools.types package of the types Gradle subproject, for representing the zero number.

This type should have the following Application Programming Interface (API):

interface Zero {
    override fun equals(other: Any?): Boolean
    override fun hashCode(): Int
    fun toByte(): Byte
    override fun toString(): String

    companion object {
        fun fromByte(number: Byte): Zero = TODO()
        fun fromByteOrNull(number: Byte): Zero? = TODO()
    }
}

The serialization and deserialization processes of this type should behave like for the Byte type.
Here's an example of Kotlin code that encodes and decodes this type using the JavaScript Object Notation (JSON) format from kotlinx.serialization:

val format = Json { serializersModule = KotoolsTypesSerializers.zero }
val zero = Zero()
val encoded: String = format.encodeToString(zero)
println(encoded) // 0
val decoded: Zero = format.decodeFromString(encoded)
println(zero == decoded) // true

🕓 Commit history

Here's the history of commits related to this type made before the existence of this issue: 2df18e4, 43ee104, 5cfccae, 5cf8149, b031be2, e894ff7, d59f69e, 4d4fea9, f79a220, 5793ba6, c6e6a5e, fb29426 and f60d455.

✅ Checklist

• 📝 Reference this issue in related entries of the unreleased changelog.
• 💥 Convert the type from object to class, refactor usages and dump the Application Binary Interface (ABI).
• ✨ Override the structural equality operations (equals and hashCode) with tests, documentation and samples, then dump the ABI.
• ♻️ Refactor samples of the KotoolsTypesSerializers.zero property for using the Zero.equals override.
• ♻️ Refactor samples of the KotoolsTypesSerializers.all property for using the Zero.equals override.
• ✨ Add the Zero.Companion.fromByteOrNull function with tests, documentation and samples, then dump the ABI.
• ✨ Add the Zero.Companion.fromByte function with tests, documentation and samples, then dump the ABI.
• ♻️ Refactor the ZeroAsByteSerializer.deserialize function for using the Zero.Companion.fromByteOrNull function.
• 📝 Create an issue for stabilizing this type.