Remove `Stipple.init(m::M, ...)` and document workflow (`isready` and other app events)

Hi again 😃 I just noticed this strange behaviour when initializing a ReactiveModel. When I call the init()-Function before altering values in the Struct, the values are visible on the backend side but they are not transferred to the remote Endpoint and are thus stuck on the default values. But if I first create the Struct and set the values and afterwards call the init()-Function, the values are overwritten again and the default values are in place (I have found both ways in the demos).

Expected Behaviour

Initialize a model with Stipple.init() -> change values in the back end -> see changes in the front end

Code Example

using Genie, Stipple, StippleUI

@reactive mutable struct Test <: ReactiveModel
    changed::R{Bool} = false
end

function changeModel(pModel)
    pModel.changed[] = true
    return pModel
end

function initFirst()
    model = Stipple.init(Test())
    return changeModel(model)
end

function initLast()
    model = changeModel(Test())
    return Stipple.init(model)
end


a = initFirst()
b = initLast()

println(a.changed[])
println(b.changed[])



function ui(model)
    page(model, class = "container", [
        p(
            span("", @text(:changed))
        )
    ]) |> html
end

route("/a") do 
    ui(a)
end
route("/b") do 
    ui(b) 
end 

up(8020, open_browser=true)

Am I missing something here or approaching this from the wrong angle?

[essenciary]

I can work on it - I’m struggling to make the session ModelStorage work, for some reason the session state gets pushed to all channels/clients.

[essenciary]

Currently releasing/tagging new versions. Working super smoothly (sorry, compilation was a bit slow, my CPU was loaded 😄 )

Code:

using Stipple, StippleUI

@reactive! mutable struct Test <: ReactiveModel
    changed::R{Bool} = false
    sweetVec::R{Vector} = []
end

function changeModel!(model)
    model.changed[] = true
    model.sweetVec[] = ["ab", "cd", "ef", "gh"]

    model
end

function handlers(model)
    on(model.isready) do isready
        isready || return
        changeModel!(model)
    end

    on(model.changed) do val
      @show val
      notify(model, "The model has changed")
    end

    model
end

function ui(model::Test)
    page(model, class = "container", row(cell(class = "st-module", [
        toggle("Changed", :changed)
        list("", :bordered, :separator, style = "max-width: 25vw",
            [item("Hello {{ sweetVec[$(i-1)] }} ", :clickable, :v__ripple) for i in 1:length(model.sweetVec[])]
        )
        separator()
        list("", :bordered, :separator, style = "max-width: 25vw",
            [item("World {{ vec }}", @recur("vec in sweetVec"), :clickable, :v__ripple)]
        )
    ])), @iif(:isready)) |> html
end

route("/") do 
    ui(init(Test, transport = Genie.WebChannels) |> handlers)
end

up(8020, open_browser = true)