Ìkọkúkọ 0.2.0

Ìkọkúkọ 0.2.0 improves form state, validation behavior, cross-field validation, and Compose lifecycle handling.

This is a breaking pre-1.0 release.

Highlights

• Add dependency-aware cross-field validation with FieldEqualsValidator.
• Add CheckedValidator and SelectionRangeValidator.
• Add rememberSaveableFormState() and custom saver support.
• Separate strict field errors from UI error visibility.
• Keep initial form validity enabled until error reporting starts.
• Reset values, errors, dirty state, and error visibility together.
• Treat a new FormState instance as a new form composition.
• Make built-in validators structurally stable data classes.
• Add stronger recomposition, dependency, reset, saver, and lifecycle tests.

Breaking changes

• Field<T> now requires a non-null T : Any.
• Custom validators now use ValidationScope.validate.
• Cross-field validators must declare their field dependencies.
• Numeric validators now parse integer text directly.
• Pattern validators now accept pattern strings instead of Regex.
• field.markAsDirty() is replaced by field.isDirty = true.
• default is renamed to initialValue.
• EqualsValidator, NotEqualsValidator, validator lambdas, fixed email and phone validators, and specialized selection-size validators are removed.
• Desktop, JavaScript, and Wasm are not part of the 0.2.0 support promise.

Installation

After Maven Central synchronization:

implementation("com.quantipixels:ikokuko:0.2.0")

Migration

See the 0.1.0 to 0.2.0 migration guide in the README.

Full changes: release-0.1.0...release-0.2.0

Ìkọkúkọ 0.1.0

(2025-11-13)