re-export original from immer (#832)

Co-authored-by: Mark Erikson <[email protected]>

Author: jackielii

.github/workflows/tests.yml

@@ -73,7 +73,7 @@ jobs:
         if: ${{ matrix.ts < 3.7 }}
         run: |
           sed -i -e "/import .* freeze .* from 'immer'/s/^/\/\/ @ts-ignore\n/" dist/typings.d.ts
-          sed -i -e "/export .* freeze .* from 'immer'/s/^/\/\/ @ts-ignore\n/" src/index.ts
+          sed -i -e "/  freeze,/s/^/  \/\/ @ts-ignore\n/" src/index.ts
 
       - name: Use typings-tester for old TS versions
         if: ${{ matrix.ts < 3.9 }}

docs/api/otherExports.mdx

@@ -30,6 +30,10 @@ The default immutable update function from the [`immer` library](https://immerjs
 
 [The `current` function](https://immerjs.github.io/immer/docs/current) from the [`immer` library](https://immerjs.github.io/immer/), which takes a snapshot of the current state of a draft and finalizes it (but without freezing). Current is a great utility to print the current state during debugging, and the output of `current` can also be safely leaked outside the producer.
 
+### `original`
+
+[The `original` function](https://immerjs.github.io/immer/docs/original) from the [`immer` library](https://immerjs.github.io/immer/), which returns the original object. This is particularly useful for referential equality check in reducers.
+
 ```ts
 import { createReducer, createAction, current } from '@reduxjs/toolkit'
 

etc/redux-toolkit.api.md

@@ -15,6 +15,7 @@ import { Dispatch } from 'redux';
 import { Draft } from 'immer';
 import { freeze } from 'immer';
 import { Middleware } from 'redux';
+import { original } from 'immer';
 import { OutputParametricSelector } from 'reselect';
 import { OutputSelector } from 'reselect';
 import { ParametricSelector } from 'reselect';
@@ -374,6 +375,8 @@ export class MiddlewareArray<Middlewares extends Middleware<any, any>> extends A
 // @public (undocumented)
 export let nanoid: (size?: number) => string;
 
+export { original }
+
 export { OutputParametricSelector }
 
 export { OutputSelector }

src/index.ts

@@ -1,7 +1,12 @@
 import { enableES5 } from 'immer'
 export * from 'redux'
-// @ts-ignore
-export { default as createNextState, Draft, current, freeze } from 'immer'
+export {
+  default as createNextState,
+  Draft,
+  current,
+  freeze,
+  original
+} from 'immer'
 export {
   createSelector,
   Selector,