docs(api): update api docs

Author: unadlib

README.md

@@ -533,6 +533,7 @@ expect(state.simpleObject).not.toBe(baseState.simpleObject);
 
 - `castDraft()`
 - `castImmutable()`
+- `castMutable()`
 - `Draft<T>`
 - `Immutable<T>`
 - `Patches`

docs/README.md

@@ -21,6 +21,7 @@
 - [apply](functions/apply.md)
 - [castDraft](functions/castDraft.md)
 - [castImmutable](functions/castImmutable.md)
+- [castMutable](functions/castMutable.md)
 - [create](functions/create.md)
 - [current](functions/current.md)
 - [isDraft](functions/isDraft.md)

docs/functions/apply.md

@@ -48,4 +48,4 @@ expect(state).toEqual(apply(baseState, patches));
 
 ## Defined in
 
-[apply.ts:26](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/apply.ts#L26)
+[apply.ts:26](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/apply.ts#L26)

docs/functions/castDraft.md

@@ -24,4 +24,4 @@ Cast a value to an Draft type value.
 
 ## Defined in
 
-[utils/cast.ts:6](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/utils/cast.ts#L6)
+[utils/cast.ts:6](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/utils/cast.ts#L6)

docs/functions/castImmutable.md

@@ -24,4 +24,4 @@ Cast a value to an Immutable type value.
 
 ## Defined in
 
-[utils/cast.ts:13](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/utils/cast.ts#L13)
+[utils/cast.ts:13](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/utils/cast.ts#L13)

docs/functions/castMutable.md

@@ -0,0 +1,27 @@
+[**mutative**](../README.md) • **Docs**
+
+***
+
+[mutative](../README.md) / castMutable
+
+# Function: castMutable()
+
+> **castMutable**\<`T`\>(`draft`): `T`
+
+Cast a value to an Mutable type value.
+
+## Type Parameters
+
+• **T**
+
+## Parameters
+
+• **draft**: [`Draft`](../type-aliases/Draft.md)\<`T`\>
+
+## Returns
+
+`T`
+
+## Defined in
+
+[utils/cast.ts:20](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/utils/cast.ts#L20)

docs/functions/create.md

@@ -76,7 +76,7 @@ expect(state.arr).toBe(baseState.arr);
 
 ### Defined in
 
-[create.ts:25](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/create.ts#L25)
+[create.ts:25](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/create.ts#L25)
 
 ## create(base, mutate, options)
 
@@ -127,7 +127,7 @@ expect(state.arr).toBe(baseState.arr);
 
 ### Defined in
 
-[create.ts:25](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/create.ts#L25)
+[create.ts:25](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/create.ts#L25)
 
 ## create(mutate, options)
 
@@ -188,11 +188,11 @@ expect(state.arr).toBe(baseState.arr);
 
 ### Defined in
 
-[create.ts:25](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/create.ts#L25)
+[create.ts:25](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/create.ts#L25)
 
 ## create(base, options)
 
-> **create**\<`T`, `O`, `F`\>(`base`, `options`?): [`T`, () => `Result`\<`T`, `O`, `F`\>]
+> **create**\<`T`, `O`, `F`\>(`base`, `options`?): [[`Draft`](../type-aliases/Draft.md)\<`T`\>, () => `Result`\<`T`, `O`, `F`\>]
 
 `create(baseState, callback, options)` to create the next state
 
@@ -231,8 +231,8 @@ expect(state.arr).toBe(baseState.arr);
 
 ### Returns
 
-[`T`, () => `Result`\<`T`, `O`, `F`\>]
+[[`Draft`](../type-aliases/Draft.md)\<`T`\>, () => `Result`\<`T`, `O`, `F`\>]
 
 ### Defined in
 
-[create.ts:25](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/create.ts#L25)
+[create.ts:25](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/create.ts#L25)

docs/functions/current.md

@@ -6,6 +6,8 @@
 
 # Function: current()
 
+## current(target)
+
 > **current**\<`T`\>(`target`): `T`
 
 `current(draft)` to get current state in the draft mutation function.
@@ -25,18 +27,42 @@ const state = create(
 );
 ```
 
-## Type Parameters
+### Type Parameters
+
+• **T** *extends* `object`
+
+### Parameters
+
+• **target**: [`Draft`](../type-aliases/Draft.md)\<`T`\>
+
+### Returns
+
+`T`
+
+### Defined in
+
+[current.ts:120](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/current.ts#L120)
+
+## current(target)
+
+> **current**\<`T`\>(`target`): `T`
+
+### Type Parameters
 
 • **T** *extends* `object`
 
-## Parameters
+### Parameters
 
 • **target**: `T`
 
-## Returns
+### Returns
 
 `T`
 
-## Defined in
+### Deprecated
+
+You should call current only on `Draft<T>` types.
+
+### Defined in
 
-[current.ts:104](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/current.ts#L104)
+[current.ts:122](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/current.ts#L122)

docs/functions/isDraft.md

@@ -20,4 +20,4 @@ Check if the value is a draft
 
 ## Defined in
 
-[utils/draft.ts:11](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/utils/draft.ts#L11)
+[utils/draft.ts:12](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/utils/draft.ts#L12)

docs/functions/isDraftable.md

@@ -24,4 +24,4 @@ Check if a value is draftable
 
 ## Defined in
 
-[utils/draft.ts:28](https://github.com/unadlib/mutative/blob/4e5a64df3bd670123a9179420fc5820dbbf11915/src/utils/draft.ts#L28)
+[utils/draft.ts:29](https://github.com/unadlib/mutative/blob/7129237bc42b8475743ffff427a1f8f85e8e1e51/src/utils/draft.ts#L29)