mobx 5.10.1 → 5.14.0

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+# 5.14.0 / 4.14.0
+
+* Added experimental `reactionRequiresObservable` & `observableRequiresReaction` config [#2079](https://github.com/mobxjs/mobx/pull/2079), [Docs](https://github.com/mobxjs/mobx/pull/2082)
+* Added experimental `requiresObservable` config to `reaction`, `autorun` & `when` options [#2079](https://github.com/mobxjs/mobx/pull/2079), [Docs](https://github.com/mobxjs/mobx/pull/2082)
+
+# 5.13.1 / 4.13.1
+
+* Don't use `global` and `self` keywords unless defined. Fixes [#2070](https://github.com/mobxjs/mobx/issues/2070).
+* onBecome(Un)Observed didn't trigger when using number as key of observable map. Fixes [#2067](https://github.com/mobxjs/mobx/issues/2067).
+* Exposed `_startAction` and `_endAction` to be able to start and action and finish it without needing a code block. This is low level stuff you shouldn't need that's mostly useful for library creators.
+
+# 5.13.0 / 4.13.0
+
+* Fixed potential memory leak in observable maps, when non-primitive values are used as keys. Fixes [#2031](https://github.com/mobxjs/mobx/issues/2031) through [#2032](https://github.com/mobxjs/mobx/pull/2032).
+* Added support to store additional non-observable(!) fields (string or symbol based) on array, to better reflect behavior of MobX 4. Fixes [#2044](https://github.com/mobxjs/mobx/issues/2044) through [#2046](https://github.com/mobxjs/mobx/pull/2046)
+
+# 5.11.0 / 4.12.0
+
+* Added `computedConfigurable` config [#2011](https://github.com/mobxjs/mobx/pull/2011), [#2013](https://github.com/mobxjs/mobx/pull/2014)
+
+# 4.11.0
+
+**BREAKING CHANGE**
+
+Reverted the support of Symbols in general in MobX 4, as it gives to many potential build errors and increases the system requirements for MobX 4 (which was an oversight in 4.10.0). Apologies for the breaking change (lack of new major version numbers). If lock files are properly used however, no harm should be caused by this change.
+
+* Reverted `Symbol` support in observable maps and objects. Reverts [#1944](https://github.com/mobxjs/mobx/pull/1944) through [#1988](https://github.com/mobxjs/mobx/pull/1988). Fixes [#1986](https://github.com/mobxjs/mobx/issues/1986), [#1987](https://github.com/mobxjs/mobx/issues/1987)
+
 # 5.10.1
 
 * Fixed a recent regression where array update events would send undefined as `change.object` through [#1985](https://github.com/mobxjs/mobx/pull/1985) by [xaviergonz](https://github.com/xaviergonz)
@@ -143,7 +171,7 @@ MobX 5 is the first MobX version fully leveraging Proxies. This has two big adva
 
 ### The system requirements to run MobX has been upped
 
-* MobX 5 can only be used on environments that support `Proxies`. In practice this means, no Internet Explorer (Edge is fine). No nodejs < 6. React Native on Android only when JavaScript core is [upgraded](https://github.com/react-community/jsc-android-buildscripts#how-to-use-it-with-my-react-native-app). All modern browsers are supported.
+* MobX 5 can only be used on environments that support `Proxies`. See the [browser support](https://github.com/mobxjs/mobx#browser-support) for details.
 * Since MobX no longer runs on older browsers, the compilation target has been upgraded to ES2015 syntax supporting browsers. This means that MobX is not loadable on older browsers without down compilation to ES5.
 * If for whatever reason your project cannot meet this requirements, please stick to MobX 4. It will be actively maintained. All current features of MobX 5 are expressable in MobX 4 as well, but it means that for example to use dynamic objects some [additional APIs](https://mobx.js.org/refguide/object-api.html) are needed.
 * The performance footprint of MobX 5 should be pretty similar to MobX 4. In our performance tests we saw some minor improvements in memory footprint, but overall it should be pretty comparable.

package/README.md

@@ -4,7 +4,7 @@
 
 _Simple, scalable state management_
 
-[![Build Status](https://travis-ci.org/mobxjs/mobx.svg?branch=master)](https://travis-ci.org/mobxjs/mobx)
+[![CircleCI](https://circleci.com/gh/mobxjs/mobx.svg?style=svg)](https://circleci.com/gh/mobxjs/mobx)
 [![Coverage Status](https://coveralls.io/repos/mobxjs/mobx/badge.svg?branch=master&service=github)](https://coveralls.io/github/mobxjs/mobx?branch=master)
 [![Join the chat at https://gitter.im/mobxjs/mobx](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/mobxjs/mobx?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 [![Discuss MobX on Hashnode](https://hashnode.github.io/badges/mobx.svg)](https://hashnode.com/n/mobx)
@@ -12,60 +12,72 @@ _Simple, scalable state management_
 [![OpenCollective](https://opencollective.com/mobx/sponsors/badge.svg)](#sponsors)
 [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
 
-MobX is proudly sponsored by Mendix, Coinbase, Facebook Open Source, Canva, Algolia, Guilded, Auction Frontier, Mantro and TalentPlot for 100$/month or more! And beyond that by many [individual backers](#backers) and through [one time contributions](https://github.com/mobxjs/mobx/blob/master/sponsors.md).
+MobX is proudly sponsored by Mendix, Coinbase, Facebook Open Source, Canva, Algolia, Guilded, Auction Frontier, Mantro and TalentPlot for 100\$/month or more! And beyond that by many [individual backers](#backers) and through [one time contributions](https://github.com/mobxjs/mobx/blob/master/sponsors.md).
 
+**🥇Gold sponsors (\$250+ pm):** <br/>
 <a href="https://mendix.com/"><img src="docs/mendix-logo.png" align="center" width="100" title="Mendix" alt="Mendix" /></a>
-<a href="https://coinbase.com/"><img src="docs/coinbase.jpeg" align="center" width="100" title="Coinbase" alt="Coinbase" /></a>
+<a href="http://auctionfrontier.com/"><img src="docs/auctionfrontier.jpeg" align="center" width="100" title="Auction Frontier" alt="Auction Frontier"></a>
+
+**🥈Silver sponsors (\$100+ pm):**<br/>
 <a href="https://opensource.facebook.com/"><img src="docs/fbos.jpeg" align="center" width="100" title="Facebook Open Source" alt="Facebook Open Source" /></a>
 <a href="https://www.canva.com/"><img src="docs/canva.png" align="center" width="100" title="Canva" alt="Canva" /></a>
-<a href="https://www.algolia.com/"><img src="docs/algolia.jpg" align="center" width="100" title="Algolia" alt="Algolia" /></a>
 <a href="https://www.guilded.gg/"><img src="docs/guilded.jpg" align="center" width="100" title="Guilded" alt="Guilded" /></a>
-<a href="http://auctionfrontier.com/"><img src="docs/auctionfrontier.jpeg" align="center" width="100" title="Auction Frontier" alt="Auction Frontier"></a>
 <a href="https://mantro.net/jobs/warlock"><img src="docs/mantro.png" align="center" width="100" title="mantro GmbH" alt="mantro GmbH"></a>
-<a href="https://talentplot.com/"><img src="docs/talentplot.png" align="center" width="100" title="talentplot" alt="talentplot"></a>
 <a href="https://www.codefirst.co.uk/"><img src="https://mobx.js.org/docs/codefirst.png" align="center" width="100" title="CodeFirst" alt="CodeFirst"/></a>
 <a href="https://blokt.com/"><img src="https://mobx.js.org/docs/blokt.jpg" align="center" width="100" title="Blokt" alt="Blokt"/></a>
-<a href="https://www.faire.com/"><img src="https://mobx.js.org/docs/faire.jpg" align="center" width="100" title="Faire" alt="Faire"/></a>
+
+**🥉Bronze sponsors:**<br/>
+<a href="https://coinbase.com/"><img src="docs/coinbase.jpeg" align="center" width="100" title="Coinbase" alt="Coinbase" /></a>
+<a href="https://www.algolia.com/"><img src="docs/algolia.jpg" align="center" width="100" title="Algolia" alt="Algolia" /></a>
+<a href="https://talentplot.com/"><img src="docs/talentplot.png" align="center" width="100" title="talentplot" alt="talentplot"></a>
 
 # Installation
 
-*   Installation: `npm install mobx --save`. React bindings: `npm install mobx-react --save`. To enable ESNext decorators (optional), see below.
-*   CDN:
-    *   https://unpkg.com/mobx/lib/mobx.umd.js
-    *   https://cdnjs.com/libraries/mobx
+-   Installation: `npm install mobx --save`. React bindings: `npm install mobx-react --save`. To enable ESNext decorators (optional), see below.
+-   CDN:
+    -   https://unpkg.com/mobx/lib/mobx.umd.js
+    -   https://cdnjs.com/libraries/mobx
 
 _Tip: Consider using the faster and smaller ES6 build if targetting a modern environment: `lib/mobx.es6.js`. For example by setting up a webpack alias: `resolve: { alias: { mobx: __dirname + "/node_modules/mobx/lib/mobx.es6.js" }}`_
 
 # Browser support
 
-| MobX version | Actively supported | Supported browsers                                                                                                                                                                | GitHub branch    |
-| ------------ | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
+| MobX version | Actively supported | Supported browsers                                                                                                                                          | GitHub branch    |
+| ------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
 | 5.\*         | Yes                | Any browser that supports [ES6 Proxies](https://kangax.github.io/compat-table/es6/#test-Proxy) (non polyfillable). _NOT:_ IE 11 and lower, Node 5 and lower | `master`         |
-| 4.\*         | Yes (LTS)          | Any ES5 compliant browser                                                                                                                                                         | `mobx4-master`   |
-| 1-3.\*       | No                 | Any ES5 compliant browser                                                                                                                                                         | No active branch |
-
-*   MobX >=5 runs on any browser with [ES6 proxy support](https://kangax.github.io/compat-table/es6/#test-Proxy). It will throw an error on startup on older environments such as IE11, Node.js <6 or React Native Android on old JavaScriptCore [how-to-upgrade](https://github.com/react-community/jsc-android-buildscripts#how-to-use-it-with-my-react-native-app).
-*   MobX 4 runs on any ES5 browser and will be actively maintained. The MobX 4 and 5 api's are the same and semantically can achieve the same, but MobX 4 has some [limitations](#mobx-4-vs-mobx-5).
+| 4.\*         | Yes (LTS)          | Any ES5 compliant browser                                                                                                                                   | `mobx4-master`   |
+| 1-3.\*       | No                 | Any ES5 compliant browser                                                                                                                                   | No active branch |
+
+-   All modern browsers are supported.
+-   MobX >=5 runs on any browser with [ES6 proxy support](https://kangax.github.io/compat-table/es6/#test-Proxy). In practice this means:
+    - no Internet Explorer (Edge is fine)
+    - Node.js >= 6  
+-   React Native:
+    - iOS >= 10
+    - Android from RN 0.59 (or with manual JavaScript core [upgrade](https://github.com/react-community/jsc-android-buildscripts#how-to-use-it-with-my-react-native-app))
+    - Hermes runtime is [not supported](https://github.com/facebook/hermes/issues/28) (Use MobX 4 instead)
+-   MobX 4 runs on any ES5 browser and will be actively maintained. The MobX 4 and 5 api's are the same and semantically can achieve the same, but MobX 4 has some [limitations](#mobx-4-vs-mobx-5).
+-   The latest versions of libraries like mobx-react, mobx-react-lite, mobx-state-tree etc are kept compatible with both MobX 4 and 5.
 
 ## Translations
 
-*   [中文](http://cn.mobx.js.org)
+-   [中文](http://cn.mobx.js.org)
 
 ## Getting started
 
-*   <i><a style="color: white; background:green;padding:5px;margin:5px;border-radius:2px" href="https://egghead.io/courses/manage-complex-state-in-react-apps-with-mobx">Egghead.io course</a></i>
-*   [Ten minute, interactive MobX + React tutorial](https://mobxjs.github.io/mobx/getting-started.html)
-*   <img src="docs/book.jpg" height="80px"/> [The MobX book](https://books.google.nl/books?id=ALFmDwAAQBAJ&pg=PP1&lpg=PP1&dq=michel+weststrate+mobx+quick+start+guide:+supercharge+the+client+state+in+your+react+apps+with+mobx&source=bl&ots=D460fxti0F&sig=ivDGTxsPNwlOjLHrpKF1nweZFl8&hl=nl&sa=X&ved=2ahUKEwiwl8XO--ncAhWPmbQKHWOYBqIQ6AEwAnoECAkQAQ#v=onepage&q=michel%20weststrate%20mobx%20quick%20start%20guide%3A%20supercharge%20the%20client%20state%20in%20your%20react%20apps%20with%20mobx&f=false) by Pavan Podila and Michel Weststrate (which despite it's name is in-depth!)
-*   [Official MobX 4 documentation and API overview](https://mobxjs.github.io/mobx/refguide/api.html) ([MobX 3](https://github.com/mobxjs/mobx/blob/54557dc319b04e92e31cb87427bef194ec1c549c/docs/refguide/api.md), [MobX 2](https://github.com/mobxjs/mobx/blob/7c9e7c86e0c6ead141bb0539d33143d0e1f576dd/docs/refguide/api.md))
-*   [How to (not) use decorators](https://mobx.js.org/best/decorators.html)
-*   Videos:
-    *   [ReactNext 2016: Real World MobX](https://www.youtube.com/watch?v=Aws40KOx90U) - 40m [slides](https://docs.google.com/presentation/d/1DrI6Hc2xIPTLBkfNH8YczOcPXQTOaCIcDESdyVfG_bE/edit?usp=sharing)
-    *   [Practical React with MobX](https://www.youtube.com/watch?v=XGwuM_u7UeQ). In depth introduction and explanation to MobX and React by Matt Ruby on OpenSourceNorth (ES5 only) - 42m.
-    *   LearnCode.academy MobX tutorial [Part I: MobX + React is AWESOME (7m)](https://www.youtube.com/watch?v=_q50BXqkAfI) [Part II: Computed Values and Nested/Referenced Observables (12m.)](https://www.youtube.com/watch?v=nYvNqKrl69s)
-    *   [Screencast: intro to MobX](https://www.youtube.com/watch?v=K8dr8BMU7-8) - 8m
-    *   [Talk: State Management Is Easy, React Amsterdam 2016 conf](https://www.youtube.com/watch?v=ApmSsu3qnf0&feature=youtu.be) ([slides](https://speakerdeck.com/mweststrate/state-management-is-easy-introduction-to-mobx))
-*   [Boilerplates and related projects](http://mobxjs.github.io/mobx/faq/boilerplates.html)
-*   More tutorials, blogs, videos, and other helpful resources can be found on the [MobX awesome list](https://github.com/mobxjs/awesome-mobx#awesome-mobx)
+-   <i><a style="color: white; background:green;padding:5px;margin:5px;border-radius:2px" href="https://egghead.io/courses/manage-complex-state-in-react-apps-with-mobx">Egghead.io course</a></i>
+-   [Ten minute, interactive MobX + React tutorial](https://mobxjs.github.io/mobx/getting-started.html)
+-   <img src="docs/book.jpg" height="80px"/> [The MobX book](https://books.google.nl/books?id=ALFmDwAAQBAJ&pg=PP1&lpg=PP1&dq=michel+weststrate+mobx+quick+start+guide:+supercharge+the+client+state+in+your+react+apps+with+mobx&source=bl&ots=D460fxti0F&sig=ivDGTxsPNwlOjLHrpKF1nweZFl8&hl=nl&sa=X&ved=2ahUKEwiwl8XO--ncAhWPmbQKHWOYBqIQ6AEwAnoECAkQAQ#v=onepage&q=michel%20weststrate%20mobx%20quick%20start%20guide%3A%20supercharge%20the%20client%20state%20in%20your%20react%20apps%20with%20mobx&f=false) by Pavan Podila and Michel Weststrate (which despite it's name is in-depth!)
+-   [Official MobX 4 documentation and API overview](https://mobxjs.github.io/mobx/refguide/api.html) ([MobX 3](https://github.com/mobxjs/mobx/blob/54557dc319b04e92e31cb87427bef194ec1c549c/docs/refguide/api.md), [MobX 2](https://github.com/mobxjs/mobx/blob/7c9e7c86e0c6ead141bb0539d33143d0e1f576dd/docs/refguide/api.md))
+-   [How to (not) use decorators](https://mobx.js.org/best/decorators.html)
+-   Videos:
+    -   [ReactNext 2016: Real World MobX](https://www.youtube.com/watch?v=Aws40KOx90U) - 40m [slides](https://docs.google.com/presentation/d/1DrI6Hc2xIPTLBkfNH8YczOcPXQTOaCIcDESdyVfG_bE/edit?usp=sharing)
+    -   [Practical React with MobX](https://www.youtube.com/watch?v=XGwuM_u7UeQ). In depth introduction and explanation to MobX and React by Matt Ruby on OpenSourceNorth (ES5 only) - 42m.
+    -   LearnCode.academy MobX tutorial [Part I: MobX + React is AWESOME (7m)](https://www.youtube.com/watch?v=_q50BXqkAfI) [Part II: Computed Values and Nested/Referenced Observables (12m.)](https://www.youtube.com/watch?v=nYvNqKrl69s)
+    -   [Screencast: intro to MobX](https://www.youtube.com/watch?v=K8dr8BMU7-8) - 8m
+    -   [Talk: State Management Is Easy, React Amsterdam 2016 conf](https://www.youtube.com/watch?v=ApmSsu3qnf0&feature=youtu.be) ([slides](https://speakerdeck.com/mweststrate/state-management-is-easy-introduction-to-mobx))
+-   [Boilerplates and related projects](http://mobxjs.github.io/mobx/faq/boilerplates.html)
+-   More tutorials, blogs, videos, and other helpful resources can be found on the [MobX awesome list](https://github.com/mobxjs/awesome-mobx#awesome-mobx)
 
 ## Introduction
 
@@ -168,7 +180,9 @@ class TodoListView extends Component {
         return (
             <div>
                 <ul>
-                    {this.props.todoList.todos.map(todo => <TodoView todo={todo} key={todo.id} />)}
+                    {this.props.todoList.todos.map(todo => (
+                        <TodoView todo={todo} key={todo.id} />
+                    ))}
                 </ul>
                 Tasks left: {this.props.todoList.unfinishedTodoCount}
             </div>
@@ -223,9 +237,9 @@ For an in-depth explanation about how MobX determines to which observables needs
 
 Unlike many flux frameworks, MobX is unopinionated about how user events should be handled.
 
-*   This can be done in a Flux like manner.
-*   Or by processing events using RxJS.
-*   Or by simply handling events in the most straightforward way possible, as demonstrated in the above `onClick` handler.
+-   This can be done in a Flux like manner.
+-   Or by processing events using RxJS.
+-   Or by simply handling events in the most straightforward way possible, as demonstrated in the above `onClick` handler.
 
 In the end it all boils down to: somehow the state should be updated.
 
@@ -294,12 +308,12 @@ And finally, kudos to all the people that believed in, tried, validated and even
 
 ## Further resources and documentation
 
-*   <img src="docs/book.jpg" height="80px"/> [The MobX book](https://books.google.nl/books?id=ALFmDwAAQBAJ&pg=PP1&lpg=PP1&dq=michel+weststrate+mobx+quick+start+guide:+supercharge+the+client+state+in+your+react+apps+with+mobx&source=bl&ots=D460fxti0F&sig=ivDGTxsPNwlOjLHrpKF1nweZFl8&hl=nl&sa=X&ved=2ahUKEwiwl8XO--ncAhWPmbQKHWOYBqIQ6AEwAnoECAkQAQ#v=onepage&q=michel%20weststrate%20mobx%20quick%20start%20guide%3A%20supercharge%20the%20client%20state%20in%20your%20react%20apps%20with%20mobx&f=false) by Pavan Podila and Michel Weststrate (which despite it's name is in-depth!)
-*   [MobX homepage](http://mobxjs.github.io/mobx/faq/blogs.html)
-*   [API overview](http://mobxjs.github.io/mobx/refguide/api.html)
-*   [Tutorials, Blogs & Videos](http://mobxjs.github.io/mobx/faq/blogs.html)
-*   [Boilerplates](http://mobxjs.github.io/mobx/faq/boilerplates.html)
-*   [Related projects](http://mobxjs.github.io/mobx/faq/related.html)
+-   <img src="docs/book.jpg" height="80px"/> [The MobX book](https://books.google.nl/books?id=ALFmDwAAQBAJ&pg=PP1&lpg=PP1&dq=michel+weststrate+mobx+quick+start+guide:+supercharge+the+client+state+in+your+react+apps+with+mobx&source=bl&ots=D460fxti0F&sig=ivDGTxsPNwlOjLHrpKF1nweZFl8&hl=nl&sa=X&ved=2ahUKEwiwl8XO--ncAhWPmbQKHWOYBqIQ6AEwAnoECAkQAQ#v=onepage&q=michel%20weststrate%20mobx%20quick%20start%20guide%3A%20supercharge%20the%20client%20state%20in%20your%20react%20apps%20with%20mobx&f=false) by Pavan Podila and Michel Weststrate (which despite it's name is in-depth!)
+-   [MobX homepage](http://mobxjs.github.io/mobx/faq/blogs.html)
+-   [API overview](http://mobxjs.github.io/mobx/refguide/api.html)
+-   [Tutorials, Blogs & Videos](http://mobxjs.github.io/mobx/faq/blogs.html)
+-   [Boilerplates](http://mobxjs.github.io/mobx/faq/boilerplates.html)
+-   [Related projects](http://mobxjs.github.io/mobx/faq/related.html)
 
 ## What others are saying...
 
@@ -319,11 +333,11 @@ And finally, kudos to all the people that believed in, tried, validated and even
 
 ## Contributing
 
-*   Feel free to send small pull requests. Please discuss new features or big changes in a GitHub issue first.
-*   Use `yarn test` to run the basic test suite.
-*   Use `yarn test:travis` for the test suite with coverage.
-*   and `yarn test:performance` for the performance tests.
-*   Please note that if you want to backport a feature / fix to MobX 4 a second PR needs to be opened to the mobx4-master branch.
+-   Feel free to send small pull requests. Please discuss new features or big changes in a GitHub issue first.
+-   Use `yarn test` to run the basic test suite.
+-   Use `yarn test:ci` for the test suite with coverage.
+-   and `yarn test:performance` for the performance tests.
+-   Please note that if you want to backport a feature / fix to MobX 4 a second PR needs to be opened to the mobx4-master branch.
 
 # MobX 4 vs MobX 5
 
@@ -331,8 +345,8 @@ The difference between MobX 4 and MobX 5 is that the latter uses Proxies to do p
 
 The most notable limitations of MobX 4:
 
-*   Observable arrays are not real arrays, so they won't pass the `Array.isArray()` check. The practical consequence is that you often need to `.slice()` the array first (to get a real array shallow copy) before passing to third party libraries.
-*   Adding properties to existing observable objects after creation is not automatically picked up. Instead, either use observable maps or use the the built-in [utility functions](https://mobx.js.org/refguide/object-api.html) to read / write / iterate objects that you want to dynamically add properties to.
+-   Observable arrays are not real arrays, so they won't pass the `Array.isArray()` check. The practical consequence is that you often need to `.slice()` the array first (to get a real array shallow copy) before passing to third party libraries.
+-   Adding properties to existing observable objects after creation is not automatically picked up. Instead, either use observable maps or use the the built-in [utility functions](https://mobx.js.org/refguide/object-api.html) to read / write / iterate objects that you want to dynamically add properties to.
 
 For more details see the [caveats page](https://mobx.js.org/best/pitfalls.html).
 
@@ -342,9 +356,9 @@ MobX ships with [flow typings](flow-typed/mobx.js). Flow will automatically incl
 
 To use the [flow typings](flow-typed/mobx.js) shipped with MobX:
 
-*   In `.flowconfig`, you **cannot** ignore `node_modules`.
-*   In `.flowconfig`, you **cannot** import it explicitly in the `[libs]` section.
-*   You **do not** need to install library definition using [flow-typed](https://github.com/flowtype/flow-typed).
+-   In `.flowconfig`, you **cannot** ignore `node_modules`.
+-   In `.flowconfig`, you **cannot** import it explicitly in the `[libs]` section.
+-   You **do not** need to install library definition using [flow-typed](https://github.com/flowtype/flow-typed).
 
 ## Donating
 

package/lib/api/autorun.d.ts

@@ -2,6 +2,11 @@ import { IEqualsComparer, IReactionDisposer, IReactionPublic } from "../internal
 export interface IAutorunOptions {
     delay?: number;
     name?: string;
+    /**
+     * Experimental.
+     * Warns if the view doesn't track observables
+     */
+    requiresObservable?: boolean;
     scheduler?: (callback: () => void) => any;
     onError?: (error: any) => void;
 }

package/lib/api/configure.d.ts

@@ -1,6 +1,17 @@
 export declare function configure(options: {
     enforceActions?: boolean | "strict" | "never" | "always" | "observed";
     computedRequiresReaction?: boolean;
+    /**
+     * (Experimental)
+     * Warn if you try to create to derivation / reactive context without accessing any observable.
+     */
+    reactionRequiresObservable?: boolean;
+    /**
+     * (Experimental)
+     * Warn if observables are accessed outside a reactive context
+     */
+    observableRequiresReaction?: boolean;
+    computedConfigurable?: boolean;
     isolateGlobalState?: boolean;
     disableErrorBoundaries?: boolean;
     reactionScheduler?: (f: () => void) => void;

package/lib/api/object-api.d.ts

@@ -6,11 +6,11 @@ export declare function keys<T extends Object>(obj: T): ReadonlyArray<PropertyKe
 export declare function values<K, T>(map: ObservableMap<K, T>): ReadonlyArray<T>;
 export declare function values<T>(set: ObservableSet<T>): ReadonlyArray<T>;
 export declare function values<T>(ar: IObservableArray<T>): ReadonlyArray<T>;
-export declare function values<T = any>(obj: T): ReadonlyArray<any>;
+export declare function values<T = any>(obj: T): ReadonlyArray<T extends object ? T[keyof T] : any>;
 export declare function entries<K, T>(map: ObservableMap<K, T>): ReadonlyArray<[K, T]>;
 export declare function entries<T>(set: ObservableSet<T>): ReadonlyArray<[T, T]>;
 export declare function entries<T>(ar: IObservableArray<T>): ReadonlyArray<[number, T]>;
-export declare function entries<T = any>(obj: T): ReadonlyArray<[string, any]>;
+export declare function entries<T = any>(obj: T): ReadonlyArray<[string, T extends object ? T[keyof T] : any]>;
 export declare function set<V>(obj: ObservableMap<PropertyKey, V>, values: {
     [key: string]: V;
 }): any;

package/lib/api/when.d.ts

@@ -2,6 +2,11 @@ import { IReactionDisposer, Lambda } from "../internal";
 export interface IWhenOptions {
     name?: string;
     timeout?: number;
+    /**
+     * Experimental.
+     * Warns if the view doesn't track observables
+     */
+    requiresObservable?: boolean;
     onError?: (error: any) => void;
 }
 export declare function when(predicate: () => boolean, opts?: IWhenOptions): Promise<void> & {

package/lib/core/action.d.ts

@@ -1,8 +1,21 @@
+import { IDerivation } from "../internal";
 export interface IAction {
     isMobxAction: boolean;
 }
 export declare function createAction(actionName: string, fn: Function, ref?: Object): Function & IAction;
 export declare function executeAction(actionName: string, fn: Function, scope?: any, args?: IArguments): any;
+export interface IActionRunInfo {
+    prevDerivation: IDerivation | null;
+    prevAllowStateChanges: boolean;
+    prevAllowStateReads: boolean;
+    notifySpy: boolean;
+    startTime: number;
+    error?: any;
+    parentActionId: number;
+    actionId: number;
+}
+export declare function _startAction(actionName: string, scope: any, args?: IArguments): IActionRunInfo;
+export declare function _endAction(runInfo: IActionRunInfo): void;
 export declare function allowStateChanges<T>(allowStateChanges: boolean, func: () => T): T;
 export declare function allowStateChangesStart(allowStateChanges: boolean): boolean;
 export declare function allowStateChangesEnd(prev: boolean): void;

package/lib/core/atom.d.ts

@@ -1,4 +1,4 @@
-import { IDerivationState, IObservable } from "../internal";
+import { IDerivationState, IObservable, IDerivation } from "../internal";
 import { Lambda } from "../utils/utils";
 export declare const $mobx: unique symbol;
 export interface IAtom extends IObservable {
@@ -9,7 +9,7 @@ export declare class Atom implements IAtom {
     name: string;
     isPendingUnobservation: boolean;
     isBeingObserved: boolean;
-    observers: Set<any>;
+    observers: Set<IDerivation>;
     diffValue: number;
     lastAccessedBy: number;
     lowestObserverState: IDerivationState;

package/lib/core/derivation.d.ts

@@ -30,6 +30,10 @@ export interface IDerivation extends IDepTreeNode {
     __mapid: string;
     onBecomeStale(): void;
     isTracing: TraceMode;
+    /**
+     *  warn if the derivation has no dependencies after creation/update
+     */
+    requiresObservable?: boolean;
 }
 export declare class CaughtException {
     cause: any;
@@ -50,6 +54,7 @@ export declare function isCaughtException(e: any): e is CaughtException;
 export declare function shouldCompute(derivation: IDerivation): boolean;
 export declare function isComputingDerivation(): boolean;
 export declare function checkIfStateModificationsAreAllowed(atom: IAtom): void;
+export declare function checkIfStateReadsAreAllowed(observable: IObservable): void;
 /**
  * Executes the provided function `f` and tracks which observables are being accessed.
  * The tracking information is stored on the `derivation` object and the derivation is registered
@@ -60,6 +65,8 @@ export declare function clearObserving(derivation: IDerivation): void;
 export declare function untracked<T>(action: () => T): T;
 export declare function untrackedStart(): IDerivation | null;
 export declare function untrackedEnd(prev: IDerivation | null): void;
+export declare function allowStateReadsStart(allowStateReads: boolean): boolean;
+export declare function allowStateReadsEnd(prev: boolean): void;
 /**
  * needed to keep `lowestObserverState` correct. when changing from (2 or 1) to 0
  *

package/lib/core/globalstate.d.ts

@@ -55,6 +55,11 @@ export declare class MobXGlobals {
      * To ensure that those functions stay pure.
      */
     allowStateChanges: boolean;
+    /**
+     * Is it allowed to read observables at this point?
+     * Used to hold the state needed for `observableRequiresReaction`
+     */
+    allowStateReads: boolean;
     /**
      * If strict mode is enabled, state changes are by default not allowed
      */
@@ -73,8 +78,25 @@ export declare class MobXGlobals {
      * Warn if computed values are accessed outside a reactive context
      */
     computedRequiresReaction: boolean;
+    /**
+     * (Experimental)
+     * Warn if you try to create to derivation / reactive context without accessing any observable.
+     */
+    reactionRequiresObservable: boolean;
+    /**
+     * (Experimental)
+     * Warn if observables are accessed outside a reactive context
+     */
+    observableRequiresReaction: boolean;
+    /**
+     * Allows overwriting of computed properties, useful in tests but not prod as it can cause
+     * memory leaks. See https://github.com/mobxjs/mobx/issues/1867
+     */
+    computedConfigurable: boolean;
     disableErrorBoundaries: boolean;
     suppressReactionErrors: boolean;
+    currentActionId: number;
+    nextActionId: number;
 }
 export declare let globalState: MobXGlobals;
 export declare function isolateGlobalState(): void;

package/lib/core/reaction.d.ts

@@ -29,6 +29,7 @@ export declare class Reaction implements IDerivation, IReactionPublic {
     name: string;
     private onInvalidate;
     private errorHandler?;
+    requiresObservable: boolean;
     observing: IObservable[];
     newObserving: IObservable[];
     dependenciesState: IDerivationState;
@@ -41,7 +42,7 @@ export declare class Reaction implements IDerivation, IReactionPublic {
     _isTrackPending: boolean;
     _isRunning: boolean;
     isTracing: TraceMode;
-    constructor(name: string, onInvalidate: () => void, errorHandler?: ((error: any, derivation: IDerivation) => void) | undefined);
+    constructor(name: string, onInvalidate: () => void, errorHandler?: ((error: any, derivation: IDerivation) => void) | undefined, requiresObservable?: boolean);
     onBecomeStale(): void;
     schedule(): void;
     isScheduled(): boolean;

package/lib/mobx.d.ts

@@ -15,4 +15,4 @@
  * - utils/   Utility stuff.
  *
  */
-export { IObservable, IDepTreeNode, Reaction, IReactionPublic, IReactionDisposer, IDerivation, untracked, IDerivationState, IAtom, createAtom, IAction, spy, IComputedValue, IEqualsComparer, comparer, IEnhancer, IInterceptable, IInterceptor, IListenable, IObjectWillChange, IObjectDidChange, IObservableObject, isObservableObject, IValueDidChange, IValueWillChange, IObservableValue, isObservableValue as isBoxedObservable, IObservableArray, IArrayWillChange, IArrayWillSplice, IArrayChange, IArraySplice, isObservableArray, IKeyValueMap, ObservableMap, IMapEntries, IMapEntry, IMapWillChange, IMapDidChange, isObservableMap, IObservableMapInitialValues, ObservableSet, isObservableSet, ISetDidChange, ISetWillChange, IObservableSetInitialValues, transaction, observable, IObservableFactory, IObservableFactories, computed, IComputed, isObservable, isObservableProp, isComputed, isComputedProp, extendObservable, observe, intercept, autorun, IAutorunOptions, reaction, IReactionOptions, when, IWhenOptions, action, isAction, runInAction, IActionFactory, keys, values, entries, set, remove, has, get, decorate, configure, onBecomeObserved, onBecomeUnobserved, flow, toJS, trace, IObserverTree, IDependencyTree, getDependencyTree, getObserverTree, resetGlobalState as _resetGlobalState, getGlobalState as _getGlobalState, getDebugName, getAtom, getAdministration as _getAdministration, allowStateChanges as _allowStateChanges, allowStateChangesInsideComputed as _allowStateChangesInsideComputed, Lambda, isArrayLike, $mobx, isComputingDerivation as _isComputingDerivation, onReactionError, interceptReads as _interceptReads, IComputedValueOptions } from "./internal";
+export { IObservable, IDepTreeNode, Reaction, IReactionPublic, IReactionDisposer, IDerivation, untracked, IDerivationState, IAtom, createAtom, IAction, spy, IComputedValue, IEqualsComparer, comparer, IEnhancer, IInterceptable, IInterceptor, IListenable, IObjectWillChange, IObjectDidChange, IObservableObject, isObservableObject, IValueDidChange, IValueWillChange, IObservableValue, isObservableValue as isBoxedObservable, IObservableArray, IArrayWillChange, IArrayWillSplice, IArrayChange, IArraySplice, isObservableArray, IKeyValueMap, ObservableMap, IMapEntries, IMapEntry, IMapWillChange, IMapDidChange, isObservableMap, IObservableMapInitialValues, ObservableSet, isObservableSet, ISetDidChange, ISetWillChange, IObservableSetInitialValues, transaction, observable, IObservableFactory, IObservableFactories, computed, IComputed, isObservable, isObservableProp, isComputed, isComputedProp, extendObservable, observe, intercept, autorun, IAutorunOptions, reaction, IReactionOptions, when, IWhenOptions, action, isAction, runInAction, IActionFactory, keys, values, entries, set, remove, has, get, decorate, configure, onBecomeObserved, onBecomeUnobserved, flow, toJS, trace, IObserverTree, IDependencyTree, getDependencyTree, getObserverTree, resetGlobalState as _resetGlobalState, getGlobalState as _getGlobalState, getDebugName, getAtom, getAdministration as _getAdministration, allowStateChanges as _allowStateChanges, allowStateChangesInsideComputed as _allowStateChangesInsideComputed, Lambda, isArrayLike, $mobx, isComputingDerivation as _isComputingDerivation, onReactionError, interceptReads as _interceptReads, IComputedValueOptions, IActionRunInfo, _startAction, _endAction } from "./internal";