✨ New constructors for EmailAddress

[LVMVRQUXL]

📝 Description

Similarly to #670, we want to replace existing factory functions by constructors and orNull functions. New constructors should be accessible easily from Kotlin and Java code, but orNull functions should be only accessible from Kotlin code.

Here's the Application Programming Interface (API) goal:

class EmailAddress {
    constructor(text: String)
    constructor(text: String, pattern: String)
    companion object {
        @JvmSynthetic fun orNull(text: String): EmailAddress?
        @JvmSynthetic fun orNull(text: String, pattern: String): EmailAddress?
    }
}

✅ Checklist

• ✨ Add the constructor accepting a single String argument with tests, documentation and samples.
• ✨ Add the orNull(String) function only for Kotlin with tests, documentation and samples.
• 📝 Refer to the constructor accepting a single String argument and the orNull(String) function in their respective documentation.
• ✨ Add the constructor accepting two String arguments with tests, documentation and samples.
• ✨ Add the orNull(String, String) function only for Kotlin with tests, documentation and samples.
• 📝 Refer to the constructor accepting two String arguments and the orNull(String, String) function in their respective documentation.
• 🔥 Remove the orNull(Any) function introduced by ✨ New orNull and orThrow functions for EmailAddress #669.
• 🔥 Remove the fromString(Any) function.
• 🔥 Remove the fromString(Any, Any) function.
• 🔥 Remove the fromStringOrNull(Any) function.
• 🔥 Remove the fromStringOrNull(Any, Any) function.
• 📝 Update the unreleased changelog for this issue.

[LVMVRQUXL]

Superseded by #675.