Version 0.7

breaking changes

This release contains changes that break code written with earlier versions:

• Handlers are now suspendable, so you can call suspend-methods directly inside your Handler. There is no need for Applicator anymore. Therefore this class and its utility-functions have been removed. (PR#124 & PR#126)
• FormateStore and interface Format have been removed. Use format-factory-function inside lenses package to create a formatting Lens and create a normal SubStore (by using sub). (PR#139 & PR#146)

val df: DateFormat = DateFormat("yyyy-MM-dd")
// converts a Date into String in vice versa
val dateFormat = format(
    parse = { df.parseDate(it) },
    format = { df.format(it) }
)

//using the dateLens
val birthday = personStore.sub(L.Person.birthday + dateFormat)
// or
val birthday = personStore.sub(L.Person.birthday).sub(dateFormat)

• Validation has been extracted as a service and refactored to be more concise. (PR#149 & #157)

in commonMain

data class Message(val id: String, val status: Status, val text: String) : ValidationMessage {
    override fun isError(): Boolean = status > Status.Valid // renamed from failed() -> isError()
}

object PersonValidator : Validator<Person, Message, String>() {
   // return your validation messages here
   override fun validate(data: Person, metadata: String): List<Message> {
       ...
   }
}

in jsMain

val personStore = object : RootStore<Person>(Person()) {    
    // only update when it's valid
    val addOrUpdate = handle<Person> { oldPerson, newPerson ->
        if (PersonValidator.isValid(newPerson, "update")) new else oldPerson
    }
}
...

// then render the validation message list in your html
PersonValidator.msgs.render { msg ->
    ...
}.bind()

in jvmMain

if (PersonValidator.isValid(newPerson , "add")) {
    //e.g. save your new Person to Database
    ...
} else {
   // get the messages, only available after isValid() was called
   val msgs = PersonValidator.msgs
   ...
}

new features

• added tracking-service to access process state of Handlers (e.g. to show process indicator). (PR#147)
• added history-service to keep track of historical values in Stores and provide back() function. (PR#152)
• added Repository to offer CRUD-functionality for entities and dealing with queries. Implementations are available for REST and LocalStorage (see example). (PR#141, PR#144, PR#155 & PR#153)
• added storeOf() function to create a minimal RootStore (without Handlers) (PR#144)
• added convenience-function render on Seq, so you can directly write each(...).render { ... } (and leave out map) (PR#142)
• added convenience-function render on Flow, so you can directly write flow.render { ... } (and leave out map) (PR#154)
• added functions to deal with errors in Handlers (PR#137)
• snapshots are now provided on oss.jfrog.org (PR#128)
• added append function to remote (PR#127)
• changed IdProvider to generic type (PR#123)
• use Inspector (created by inspect()-function) to navigate through your model in validation and test and have data and corresponding ids available at any point (PR#118)

fixed bugs

• added isValid on JVM (PR#135)
• added missing factories for <dt> and <dd> (PR#134)
• added missing SelectedAttributeDelegate (PR#131)
• fixed some bugs in Router and minor API changes (PR#151)