kotose-form-swiftui/io.github.robinpcrd.kotose.form.swiftui/NativeFormAdapter

NativeFormAdapter

Experimental adapter over the existing Compose-backed form engine. Collect and mutate on the main thread. No Compose view or recomposer is required. Each collector owns and disposes its snapshot observer when collection is cancelled.

Constructors

NativeFormAdapter

constructor(form: Form)

Properties

snapshots

val snapshots: Flow<NativeFormSnapshot>

Functions

completeNavigation

fun completeNavigation(requestId: Long): Boolean

customField

fun customField(key: String): Field<*>?

The live Kotlin field behind a CUSTOM snapshot, for the application's own renderer to cast to its class and read or update typed state. Null when the key is not a visible custom field. The renderer must honor the snapshot's enabled state itself.

focusNext

fun focusNext(key: String)

focusPrevious

fun focusPrevious(key: String)

isNavigationCurrent

fun isNavigationCurrent(requestId: Long): Boolean

onFocusChanged

fun onFocusChanged(key: String, focused: Boolean)

performAction

fun performAction(key: String): Boolean

Runs the Kotlin callback of a visible, enabled action field.

selectOption

fun selectOption(key: String, optionId: String?): Boolean

Null requests user clearing. The model enforces clearing and option membership.

selectPhoneCountry

fun selectPhoneCountry(key: String, region: String): Boolean

setDate

fun setDate(key: String, year: Int, month: Int, day: Int, hour: Int, minute: Int): Boolean

Applies calendar components to a date or date-time field. Time components are ignored for date-only fields. Impossible components such as February 30 are rejected.

setPhoneDialCode

fun setPhoneDialCode(key: String, dialCode: String): String?

Sets the typed dial code of a phone row without a country picker and returns the dial code the row now holds, which the input shows instead of dialCode: a rejected digit leaves the value, and so the snapshots, unchanged. Null when the row has a country picker or is not editable.

setSelected

fun setSelected(key: String, selected: Boolean): Boolean

The option key identifies the control; its typed value stays in Kotlin. In a single selection group, selecting moves the selection and deselecting follows the group's deselection policy.

setText

fun setText(key: String, value: String): Boolean

setToggle

fun setToggle(key: String, value: Boolean): Boolean

stopEditing

fun stopEditing()

Cancels pending navigation when this renderer is detached. Form values remain shared.

validate

fun validate(): Boolean

fun validate(includeHidden: Boolean, warningAsError: Boolean): Boolean

The same submission and navigation policies as Form.validate.