Nicer API

Hi, thanks for the amazing helper.

When using this library in conjunction with lodash/fp, I found that the API would be much more powerful if the argument order was changed (iteratee first, data last), and if it was curried, in the spirit of lodash-fp.

I usually define a function called mutate this way:

const mutate = (getter,setter,context?) => (state) => iassign(state,getter,setter,context,{freeze:true})

The resulting function mutate is extremely helpful, as it allows to represent “mutations” in a declarative way. These mutations can then be applied to data. Here is an example of use:

const reducer = (state = initialState, action) => {

    switch (action.type) {

    case "TICK":
        return mutate(
          state=>state.time,
          time=>time+1
        )(state)
        
        ...

[crubier]

Hi, I just meant to move the option parameter first, not to reverse the argument order completely.

Auto currying is excellent !

[crubier]

Hi, thank you this is very nice.

However there is only one thing that could be made better: The order of argument could be changed in order to make this more useful: In the curried form, the options should be the first argument and not the last.

Also, to match lodash/fp, and as a matter of usability, it would be nice if it was autocurried, which means that we can call the function with any number of arguments, and it would be curried accordingly.

This would allow to write things like that

import iassign from "immutable-assign"
// We create our instance with no options
iassignFp = iassign.fp( undefined ) 

// ...

var nested1 = { a: { b: { c: [3, 4, 5] } } };

// ...

var mutation = iassignFp(
    (n, ctx) => (n.a.b.c[ctx.i])  ,
    (ci) => (ci + 100) ,
    {i: 1}
);

// ...

var nested2 = mutation(nested1);
// nested2 == { a: { b: { c: [3, 104, 5] } } }

I asked for this feature in your package, because otherwise I would have had to create a fork of your package just to implement this small change.

If you want I can code this and make a pull request. However you are really close right now