README.md

mithril-codemods

Automated porting of mithril@0.2 code to mithril@1.0.

Usage

> npm i -g mithril-codemods
> mithril-codemods --help

Usage
    $ mithril-codemods [<file|glob> ...]

Options
    --unsafe, -u    Use unsafe transforms
    --apply,  -a    Apply transforms (instead of a dry run)

Examples
    mithril-codemods **/*.js
    mithril-codemods --apply **/*.js
    mithril-codemods -ua some/specific/file.js

Transforms

Safe

These transforms are pretty safe and unlikely to have many false positives.

• Replace m.component() with m()
• Rename controller️ to oninit
• Rename m.route.mode to m.route.prefix() and adjust args
• Rename m.route() to m.route.get() and m.route("route") to m.route.set("route")
• Replace config: m.route ️w️i️t️h️ oncreate: m.route.link
• Wrap raw vnodes in m.mount()/m.route()
• Replace options with vnode.attrs
• Add xlink namespacing to <svg>
• Replace m.sync with Promise.all
• Remove m.startComputation/m.endComputation
• Replace m.route.build/parseQueryString with m.build/parseQueryString

⚠️️️ Unsafe ⚠️

These transform are usually fine, but not applied by default since they can have unfortunate side-effects.

• Convert m.redraw.strategy("none") to e.redraw = false
• Wrap unwrapped components
• Replace config with oninit/onupdate
• Rewrite view(ctrl, options) as view(vnode)

Warnings

There are certain classes of changes that are impossible to automatically convert.

• m.prop removed
• m.redraw(true) removed
• m.deferred() removed
• onunload preventing unmounting