buuh/CHANGELOG.md

4.0.0 The routing patch

This patch changes the way we handle routes. It introduces query string support (!), and changes the router to use a lisp-like syntax. It also inverts the argument order of effects and reducers to be more intuitive. We also managed to sneak in some performance upgrades ✨ - We hope you enjoy it!

changes

• ❗ slim down server side rendering API | issue | pull-request
• ❗ update router API to be lisp-like
• ❗ swap state and data argument order | issue
• ❗ remove choo/http. Use xhr instead | pull-request
• update router to use memoization | issue | pull-request
• support inline anchor links | issue
• allow bypassing of link clicks in sheet-router | issue | pull-request
• update router API to handle hashes by default
• update router to provide out of the box support for Electron
• update location state to expose search parameters (query strings) | issue

3.3.0

Yay, plugins now support wrappers which is a segway onto HMR, time travel and other cool plugins. These changes have come through in barracks v8.3.0 and a lil fix in v8.3.1. This is a lil patch before 4.0.0 comes through, but should be super valuable. Wooh!

changes

• updated barracks to v8.3.1

3.2.0

Wooh, plugins are a first class citizen now thanks to the .use() API. It's a multiplexed version of the old app = choo(hooks). It should enable attaching multiple hooks onto the same API, which is useful to create re-usable extensions to choo. They should be used with care though, and be as generic as possible, but the docs should provide enough backdrop for that. Anyway, have fun with plugins! 🎉

changes

• added app.use()

3.1.0

And another patch down. This time around it's mostly maintenance and a bit of perf:

• The addition of the nanoraf dependency prevents bursts of DOM updates thrashing application performance, quite possibly making choo amongst the fastest frameworks out there.
• We now ship standalone UMD bundles on each release, available through https://unpkg.com/choo. The goal of this is to support sites like codepen and the like; this should not be used for production.

3.0.0

Woooh, happy third birthday choo - thanks dad. You're all grown up now; look at how far you've come in the last month. You've grown... tinier? But yet you do more? I love you choo - shut up dad.

Notable changes

Who's the tiniest of them all?

choo is now 5kb optimized! That's 2kb less compared to v2. Woah, how? We now support yo-yoify which optimizes those lil template tags to document.createElement() calls. So not only is it smaller, creating elements now has no overhead. Pretty nifty eh? Mad shoutout to Shama for building this!

Captain Hook(s)

V3 introduces hooks - powerful functions that are called at certain points in the refresh cycle. Unlike functions in models these functions have unfiltered access to all properties, call stacks and more. They're super useful when building error handling, logging or persisting for stuff like hot reloading. I quite like them, and I'm def keen to see what uses people will come up with!

Effect Composition :train::train::train:🚋

effects are now composable by calling a done(err, res) callback when they're done executing. This means that multiple namespaced effects can be chained together to form some higher level behavior.

Think of cases like "logout" - multiple models must be cleared, perhaps tokens invalidated on the server, all in a certain order. This requires multiple models to work in tandem. - And now that's possible! ✨

Pathfinders guide

We've started work on the choo handbook - a lil manual to help you get started, not only with choo, but with web development in general. It's super modest still, only containing a single choo tutorial, but we'll be expanding this over the coming months. If you want to contribute some docs, there's a whole section of ideas on stuff that might be neat to write. Any lil bits are welcome! Shout out to Tim for making this happen 🎉

The Cycle of Life

views have gone through a bit of a change - they're now required using require('choo/html') so they can be factored out of a project into standalone bel components at any time. But additionally these components have gained super powers through the adition of onload and onunload hooks. Components can now react to being mounted or not, which makes them ideal to implement standalone widgets. This behavior uses html5 MutationObserver under the hood, so it will work anywhere with a DOM! Again, this was all Shama's hard work.

Test coverage

choo has gained a beaut blanket of tests, courtesy of Todd and Ben. We've got server, browser and pretty-much-all-browsers-known-to-mankind style testing which should give us a pretty good idea if stuff breaks. Neat!

Core dump

Internally we've moved the core of choo into a separate package - barracks. choo is now mere glue code around barracks, yo-yo and sheet-router. This is good news for folks who like choo, but don't agree with all decisions. Go forth and build your own lil framework!

Changelog

• move choo.view out to require('choo/html') #71 | pr #103
• streamline view API #35 | pr #111
• higher order functions #34 | pr #104
• create lifecycle hooks #1 | feature addition in dependency covered by semver
• implement state hooks #15 | pr #104
• add yo-yoify #3 | pr #110
• rename "app" namespace #82 | pr #111
• enable browser testing | pr #86
• propagating actions creates infinite loop #114 | pr #104
• state is now immutable in reducers and effects

Thanks

Huge thanks to everyone who's collaborated on this, provided feedback or even mentioned it anywhere. It's been a hella lot of people, but seriously, you're the best :steam_locomotive::train::train::train::train:🚋

2.3.1

• 76 - fix router arguments

2.3.0

• 55 - load subscriptions once DOM is ready
• heaps of documentation fixes; looks like choo is taking off 🐨

2.2.2

• 53 - fix assert call for subscriptions
• 52 - fix naming rootId

2.0.0

breaking changes

• namespaces are now enforced more strictly
• models now only accept a single argument
• the namespace key was introduced inside of models (was prior the leading string in models)
• namespaced models can now only operate within themselves

1.0.0

• first version of choo