Nobody's Perfect, Man

    choo-model

    1.0.0 • Public • Published

    choo-model stability

    npm version build status test coverage downloads js-standard-style

    State management lib for choo ✌️. Experiment for now. Might become part of choo at some point, who knows.

    Usage

    const Model = require('choo-model')
    const mount = require('choo/mount')
    const html = require('choo/html')
    const choo = require('choo')
     
    const app = choo()
     
    app.model(todosModel())
    app.router(['/', mainView ])
    mount('body', app.start())
     
    function todosModel () {
      const model = Model('todos')
      model.state({ todos: [] })
      model.reducer('add', (state, data) => state.push({ text: data }))
      return model.start()
    }
     
    function mainView (state, prev, send) {
      return html`
        <body>
          <main><p>Todos: ${state.todos}</p></main>
        </body>
      `
    }

    API

    model = Model(namespace?)

    Create a new model instance

    model.start()

    Return the model object, ready for the app.model() call.

    model.reducer(name, reducer)

    Create a new reducer

    model.state(state)

    Save new state. The resulting state is combined into a single state object under the hood.

    model.subscription(name, subscription)

    Create a new subscription

    model.effect(name, effect)

    Create a new effect

    model.effect(name, effect)

    Create a new effect

    Installation

    $ npm install choo-model

    FAQ

    Why?

    Because experimenting outside of core is the right way to do things.

    What can we expect to land in here?

    Probably the ability to set constraints on send() calls so they can't access everything. Also the ability to create graph data based on those constraints. Perhaps selectors too. Y'know, basic stuff.

    Why aren't you doing X first?

    Having a solid story for state management is quite important. Some abstractions start to break down once apps grow; we're hitting that point. Everything else is irrelevant if we can't scale and use it ourselves on real projects.

    How can I contribute?

    Try it out. Build things on top of it. Build out alternatives.

    Is this optimizable?

    Yeah, definitely - if this ever makes the cut we can statically analyze the code and precompile the result so it'll have no overhead at runtime. Yay!

    License

    MIT

    Install

    npm i choo-model

    DownloadsWeekly Downloads

    5

    Version

    1.0.0

    License

    MIT

    Last publish

    Collaborators

    • mafintosh
    • benlyn
    • s3ththompson
    • substack
    • yoshuawuyts
    • bret
    • lrlna
    • yerkopalma
    • juliangruber
    • timwis
    • ahdinosaur
    • toddself
    • sethvincent
    • maxogden
    • shama
    • freeman-lab
    • feross
    • emilbayes
    • colingourlay
    • jameskyburz
    • almost
    • slaskis
    • ungoldman
    • graforlock
    • tornqvist
    • amongiants
    • goto-bus-stop