ccp/com.ezzy.ccp.state/PhoneState

PhoneState

class PhoneState(source)

State holder for com.ezzy.ccp.components.PhoneNumberInput.

The public surface is unchanged from previous versions — activeCountry, phoneNumber, phoneField, formattedPhone, unformattedPhone, isValid, and the same five methods — but the implementation now runs on PhoneNumberValidator and PhoneNumberFormatter instead of its own parse/format helpers.

What that buys existing callers

Progressive formatting. The field previously reformatted through libphonenumber's NATIONAL formatter, which only produces grouping once a number is complete. It now uses AsYouTypeFormatter, so 71 → 712 → 712 345 678 groups as the user types.
Granular validity. validity distinguishes "still typing" from "wrong"; isValid behaves exactly as before.
Correct E.164. unformattedPhone is null-safe as before but is now only populated when the number is actually parseable, instead of echoing raw input back as though it were E.164.

Hoist it as before:

val phoneState = rememberPhoneState()
PhoneNumberInput(state = phoneState)
// Later: phoneState.clearPhone(), phoneState.isValid, phoneState.toPhone()

Constructors

constructor()

Properties

val activeCountry: Country?

The selected country in the legacy model.

var formattedPhone: String

International display form, e.g. +254 712 345 678.

var isValid: Boolean

Whether the number is valid and dialable for activeCountry.

var phoneField: TextFieldValue

The field's text and cursor. Derived from phoneNumber; never set independently.

var phoneNumber: String

Digits the user typed, with formatting stripped.

unformattedPhone

var unformattedPhone: String

E.164 form, e.g. +254712345678.

var validity: PhoneNumberValidity

The granular reason behind isValid.

var value: PhoneNumberValue

The full evaluated value, including the nullable E.164 form.

Functions

fun clearPhone()

Clears the number, leaving the country selected.

fun parseAndSet(value: String)

Parses a full phone string, adopting the country when the input identifies one.

fun selectCountry(country: Country)

Sets the active country from the canonical model.

fun selectCountry(country: Country)

Sets the active country and reformats the current number for it.

setCountryByCode

fun setCountryByCode(code: String)

Sets the active country by ISO code, case-insensitively. Falls back to the default if unknown.

fun toPhone(): Phone

Builds a Phone snapshot of the current state.

updatePhoneNumber

fun updatePhoneNumber(newValue: TextFieldValue)

Updates all derived phone state from a raw field edit.