mobx 6.2.0 → 6.3.3

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # mobx
 
+## 6.3.3
+
+### Patch Changes
+
+-   [`d78a1592`](https://github.com/mobxjs/mobx/commit/d78a15929052b96698b3355a0b4c8335750422db) [#2902](https://github.com/mobxjs/mobx/pull/2902) Thanks [@z3rog](https://github.com/z3rog)! - chore: observable use internal constants
+
+*   [`db21d85f`](https://github.com/mobxjs/mobx/commit/db21d85fcd41c6c142998f53e722ee0a0e9b5c18) [#2998](https://github.com/mobxjs/mobx/pull/2998) Thanks [@urugator](https://github.com/urugator)! - `trace()`: log when computed becomes suspended
+    `requiresReaction` warns instead of throwing
+
+-   [`b9fa119c`](https://github.com/mobxjs/mobx/commit/b9fa119c90e23d4b327763189f24c00be2fb2c26) [#3056](https://github.com/mobxjs/mobx/pull/3056) Thanks [@upsuper](https://github.com/upsuper)! - Create WHEN_TIMEOUT error earlier to capture useful stack
+
+*   [`99491ec2`](https://github.com/mobxjs/mobx/commit/99491ec2d315a3a01cdbe40d9a24d920a09cbd0e) [#2972](https://github.com/mobxjs/mobx/pull/2972) Thanks [@kk-gjyang](https://github.com/kk-gjyang)! - Polyfill `Object.is` for old/unsupported browsers
+
+-   [`0d28db8a`](https://github.com/mobxjs/mobx/commit/0d28db8a0ba99f5cce744bb83b5bd88ec45a7e41) [#2927](https://github.com/mobxjs/mobx/pull/2927) Thanks [@upsuper](https://github.com/upsuper)! - Give proper typing to opts.equals of reaction
+
+*   [`c6dc925c`](https://github.com/mobxjs/mobx/commit/c6dc925c6cf7eeff9237ee07c55927a7bbc14cb7) [#2985](https://github.com/mobxjs/mobx/pull/2985) Thanks [@fecqs](https://github.com/fecqs)! - Remove duplicate global property check
+
+## 6.3.2
+
+### Patch Changes
+
+-   [`4011b378`](https://github.com/mobxjs/mobx/commit/4011b3789d57e3dab0b85a835fe2979033133ce9) [#2949](https://github.com/mobxjs/mobx/pull/2949) Thanks [@urugator](https://github.com/urugator)! - fix #2948: flow ignores `autoBind` option
+
+## 6.3.1
+
+### Patch Changes
+
+-   [`d678ebd7`](https://github.com/mobxjs/mobx/commit/d678ebd7e54efb3aeae4541f87f5bcf93a623ec6) [#2944](https://github.com/mobxjs/mobx/pull/2944) Thanks [@urugator](https://github.com/urugator)! - Fix [#2941](https://github.com/mobxjs/mobx/issues/2941) - flow.bound replaces method on proto with bound function
+
+## 6.3.0
+
+### Minor Changes
+
+-   [`035bf409`](https://github.com/mobxjs/mobx/commit/035bf4096dd72d296af1fc25304adaade73cc7eb) [#2906](https://github.com/mobxjs/mobx/pull/2906) Thanks [@urugator](https://github.com/urugator)! - Provide `flow.bound` annotation/decorator
+
+### Patch Changes
+
+-   [`3dedb4d4`](https://github.com/mobxjs/mobx/commit/3dedb4d4b5376f3991183923838da942a9a81506) [#2904](https://github.com/mobxjs/mobx/pull/2904) Thanks [@ahoisl](https://github.com/ahoisl)! - Make toJS work with computed value props
+
 ## 6.2.0
 
 ### Minor Changes
@@ -175,12 +214,12 @@ Support the ongoing maintenance at: https://opencollective.com/mobx
 
 ### New features
 
--   [`makeObservable(target, annotations)`](./docs/observable-state.md#makeobservable) is now the recommended way to make objects with a fixed shape observable, such as classes.
--   [`makeAutoObservable(target)`](./docs/observable-state.md#makeautoobservable) will automatically determine the annotations used by `makeObservable`. Methods will be marked as 'autoAction', so that they can be used both from a computed value or as standalone method.
--   MobX 6 can be used in both modern environments, and environments that don't support Proxy. So both MobX 4 and 5 users can upgrade to 6. See [proxy support](./docs/configuration.md#proxy-support) for more details.
+-   [`makeObservable(target, annotations)`](../../docs/observable-state.md#makeobservable) is now the recommended way to make objects with a fixed shape observable, such as classes.
+-   [`makeAutoObservable(target)`](../../docs/observable-state.md#makeautoobservable) will automatically determine the annotations used by `makeObservable`. Methods will be marked as 'autoAction', so that they can be used both from a computed value or as standalone method.
+-   MobX 6 can be used in both modern environments, and environments that don't support Proxy. So both MobX 4 and 5 users can upgrade to 6. See [proxy support](../../docs/configuration.md#proxy-support) for more details.
 -   `observable.array` now supports `{ proxy: false }` as option.
 -   `reaction`'s effect function now receives the previous value seen by the reaction as second argument.
--   `flow` can now be used as annotation as well. You might need `flowResult` in case you use TypeScript to extract the correct result type. [details](./docs/actions.md#using-flow-instead-of-async--await-).
+-   `flow` can now be used as annotation as well. You might need `flowResult` in case you use TypeScript to extract the correct result type. [details](../../docs/actions.md#using-flow-instead-of-async--await-).
 
 ### Breaking changes
 
@@ -188,7 +227,7 @@ Support the ongoing maintenance at: https://opencollective.com/mobx
 
 -   The `decorate` API has been removed, and needs to be replaced by `makeObservable` in the constructor of the targeted class. It accepts the same arguments. The `mobx-undecorate` can transform this automatically.
 -   When using `extendObservable` / `observable`, fields that contained functions used to be turned into observables. This is no longer the case, they will be converted into `autoActions`.
--   [Strict mode](./docs/configuration.md#enforceactions) for actions is now enabled by default in `observed` mode.
+-   [Strict mode](../../docs/configuration.md#enforceactions) for actions is now enabled by default in `observed` mode.
 -   `toJS` no longer takes any options. It no longer converts Maps and Sets to plain data structures. Generic, flexible serialization of data structures is out of scope for the MobX project, and writing custom serialization methods is a much more scalable approach to serialization (tip: leverage `computed`s to define how class instances should be serialized).
 -   The methods `intercept` and `observe` are no longer exposed on observable arrays, maps and boxed observables. Import them as utility from mobx instead: `import { observe, intercept } from "mobx"`, and pass the collection as first argument: `observer(collection, callback)`. Note that we still recommend to avoid these APIs.
 -   `observableMap.toPOJO()`, `observableMap.toJS()` have been dropped. Use `new Map(observableMap)` instead if you want to convert an observable map to a plain Map shallowly.

package/README.md

@@ -17,7 +17,7 @@ _Simple, scalable state management._
 
 MobX is made possible by the generosity of the sponsors below, and many other [individual backers](docs/backers-sponsors.md#backers). Sponsoring directly impacts the longevity of this project.
 
-**🥇Gold sponsors (\$3000+ total contribution):** <br/>
+**🥇 Gold sponsors (\$3000+ total contribution):** <br/>
 <a href="https://mendix.com/"><img src="https://mobx.js.org/assets/mendix-logo.png" align="center" width="100" title="Mendix" alt="Mendix" /></a>
 <a href="https://frontendmasters.com/"><img src="https://mobx.js.org/assets/frontendmasters.jpg" align="center" width="100" title="Frontend Masters" alt="Frontend Masters"></a>
 <a href="https://opensource.facebook.com/"><img src="https://mobx.js.org/assets/fbos.jpeg" align="center" width="100" title="Facebook Open Source" alt="Facebook Open Source" /></a>
@@ -26,15 +26,15 @@ MobX is made possible by the generosity of the sponsors below, and many other [i
 <a href="https://coinbase.com/"><img src="https://mobx.js.org/assets/coinbase.jpeg" align="center" width="100" title="Coinbase" alt="Coinbase" /></a>
 <a href="https://www.canva.com/"><img src="https://mobx.js.org/assets/canva.png" align="center" width="100" title="Canva" alt="Canva" /></a>
 
-**🥈Silver sponsors (\$100+ pm):**<br/>
+**🥈 Silver sponsors (\$100+ per month):**<br/>
 <a href="https://www.codefirst.co.uk/"><img src="https://mobx.js.org/assets/codefirst.png" align="center" width="100" title="CodeFirst" alt="CodeFirst"/></a>
-<a href="https://www.dcslsoftware.com/"><img src="https://mobx.js.org/assets/dcsl.png" align="center" width="100" title="DCSL Software" alt="DCSL Software"/></a>
+<a href="https://www.dcsl.com/"><img src="https://mobx.js.org/assets/dcsl.png" align="center" width="100" title="DCSL Guidesmiths" alt="DCSL Guidesmiths"/></a>
 <a href="https://www.bugsnag.com/platforms/react-error-reporting?utm_source=MobX&utm_medium=Website&utm_content=open-source&utm_campaign=2019-community&utm_term=20190913"><img src="https://mobx.js.org/assets/bugsnag.jpg" align="center" width="100" title="Bugsnag" alt="Bugsnag"/></a>
 <a href="https://curology.com/blog/tech"><img src="https://mobx.js.org/assets/curology.png" align="center" width="100" title="Curology" alt="Curology"/></a>
 <a href="https://modulz.app/"><img src="https://mobx.js.org/assets/modulz.png" align="center" width="100" title="Modulz" alt="Modulz"/></a>
 <a href="https://space307.com/?utm_source=sponsorship&utm_medium=mobx&utm_campaign=readme"><img src="https://mobx.js.org/assets/space307.png" align="center" width="100" title="Space307" alt="Space307"/></a>
 
-**🥉Bronze sponsors (\$500+ total contributions):**<br/>
+**🥉 Bronze sponsors (\$500+ total contributions):**<br/>
 <a href="https://mantro.net/jobs/warlock"><img src="https://mobx.js.org/assets/mantro.png" align="center" width="100" title="mantro GmbH" alt="mantro GmbH"></a>
 <a href="https://www.algolia.com/"><img src="https://mobx.js.org/assets/algolia.jpg" align="center" width="100" title="Algolia" alt="Algolia" /></a>
 <a href="https://talentplot.com/"><img src="https://mobx.js.org/assets/talentplot.png" align="center" width="100" title="talentplot" alt="talentplot"></a>

package/dist/api/autorun.d.ts

@@ -17,8 +17,8 @@ export interface IAutorunOptions {
  * @returns disposer function, which can be used to stop the view from being updated in the future.
  */
 export declare function autorun(view: (r: IReactionPublic) => any, opts?: IAutorunOptions): IReactionDisposer;
-export declare type IReactionOptions = IAutorunOptions & {
+export declare type IReactionOptions<T> = IAutorunOptions & {
     fireImmediately?: boolean;
-    equals?: IEqualsComparer<any>;
+    equals?: IEqualsComparer<T>;
 };
-export declare function reaction<T>(expression: (r: IReactionPublic) => T, effect: (arg: T, prev: T, r: IReactionPublic) => void, opts?: IReactionOptions): IReactionDisposer;
+export declare function reaction<T>(expression: (r: IReactionPublic) => T, effect: (arg: T, prev: T, r: IReactionPublic) => void, opts?: IReactionOptions<T>): IReactionDisposer;

package/dist/api/flow.d.ts

@@ -10,6 +10,7 @@ export declare type CancellablePromise<T> = Promise<T> & {
 };
 interface Flow extends Annotation, PropertyDecorator {
     <R, Args extends any[]>(generator: (...args: Args) => Generator<any, R, any> | AsyncGenerator<any, R, any>): (...args: Args) => CancellablePromise<R>;
+    bound: Annotation & PropertyDecorator;
 }
 export declare const flow: Flow;
 export declare function flowResult<T>(result: T): T extends Generator<any, infer R, any> ? CancellablePromise<R> : T extends CancellablePromise<any> ? T : never;

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

@@ -32,3 +32,5 @@ export declare function has<T extends Object>(obj: T, key: string): boolean;
 export declare function get<K, V>(obj: ObservableMap<K, V>, key: K): V | undefined;
 export declare function get<T>(obj: IObservableArray<T>, index: number): T | undefined;
 export declare function get<T extends Object>(obj: T, key: string): any;
+export declare function apiDefineProperty(obj: Object, key: PropertyKey, descriptor: PropertyDescriptor): any;
+export declare function apiOwnKeys(obj: Object): any;

package/dist/errors.d.ts

@@ -34,6 +34,8 @@ declare const niceErrors: {
     readonly 35: "There are multiple, different versions of MobX active. Make sure MobX is loaded only once or use `configure({ isolateGlobalState: true })`";
     readonly 36: "isolateGlobalState should be called before MobX is running any reactions";
     readonly 37: (method: any) => string;
+    readonly 38: "'ownKeys()' can only be used on observable objects";
+    readonly 39: "'defineProperty()' can only be used on observable objects";
 };
 declare const errors: typeof niceErrors;
 export declare function die(error: string | keyof typeof errors, ...args: any[]): never;

package/dist/mobx.cjs.development.js

@@ -7,6 +7,18 @@ var niceErrors = {
   1: function _(annotationType, key) {
     return "Cannot apply '" + annotationType + "' to '" + key.toString() + "': Field not found.";
   },
+
+  /*
+  2(prop) {
+      return `invalid decorator for '${prop.toString()}'`
+  },
+  3(prop) {
+      return `Cannot decorate '${prop.toString()}': action can only be used on properties with a function value.`
+  },
+  4(prop) {
+      return `Cannot decorate '${prop.toString()}': computed can only be used on getter properties.`
+  },
+  */
   5: "'keys()' can only be used on observable objects, arrays, sets and maps",
   6: "'values()' can only be used on observable objects, arrays, sets and maps",
   7: "'entries()' can only be used on observable objects, arrays and maps",
@@ -63,7 +75,9 @@ var niceErrors = {
   36: "isolateGlobalState should be called before MobX is running any reactions",
   37: function _(method) {
     return "[mobx] `observableArray." + method + "()` mutates the array in-place, which is not allowed inside a derivation. Use `array.slice()." + method + "()` instead";
-  }
+  },
+  38: "'ownKeys()' can only be used on observable objects",
+  39: "'defineProperty()' can only be used on observable objects"
 };
 var errors =  niceErrors ;
 function die(error) {
@@ -500,7 +514,8 @@ function shallowComparer(a, b) {
 }
 
 function defaultComparer(a, b) {
-  return Object.is(a, b);
+  if (Object.is) return Object.is(a, b);
+  return a === b ? a !== 0 || 1 / a === 1 / b : a !== a && b !== b;
 }
 
 var comparer = {
@@ -698,6 +713,8 @@ function createFlowAnnotation(name, options) {
 }
 
 function make_$2(adm, key, descriptor, source) {
+  var _this$options_;
+
   // own
   if (source === adm.target_) {
     return this.extend_(adm, key, descriptor, false) === null ? 0
@@ -706,8 +723,15 @@ function make_$2(adm, key, descriptor, source) {
     /* Continue */
     ;
   } // prototype
+  // bound - must annotate protos to support super.flow()
 
 
+  if (((_this$options_ = this.options_) == null ? void 0 : _this$options_.bound) && !isFlow(adm.target_[key])) {
+    if (this.extend_(adm, key, descriptor, false) === null) return 0
+    /* Cancel */
+    ;
+  }
+
   if (isFlow(descriptor.value)) {
     // A prototype could have been annotated already by other constructor,
     // rest of the proto chain must be annotated already
@@ -716,7 +740,7 @@ function make_$2(adm, key, descriptor, source) {
     ;
   }
 
-  var flowDescriptor = createFlowDescriptor(adm, this, key, descriptor, false);
+  var flowDescriptor = createFlowDescriptor(adm, this, key, descriptor, false, false);
   defineProperty(source, key, flowDescriptor);
   return 2
   /* Continue */
@@ -724,7 +748,9 @@ function make_$2(adm, key, descriptor, source) {
 }
 
 function extend_$2(adm, key, descriptor, proxyTrap) {
-  var flowDescriptor = createFlowDescriptor(adm, this, key, descriptor);
+  var _this$options_2;
+
+  var flowDescriptor = createFlowDescriptor(adm, this, key, descriptor, (_this$options_2 = this.options_) == null ? void 0 : _this$options_2.bound);
   return adm.defineProperty_(key, flowDescriptor, proxyTrap);
 }
 
@@ -737,15 +763,23 @@ function assertFlowDescriptor(adm, _ref, key, _ref2) {
   }
 }
 
-function createFlowDescriptor(adm, annotation, key, descriptor, // provides ability to disable safeDescriptors for prototypes
+function createFlowDescriptor(adm, annotation, key, descriptor, bound, // provides ability to disable safeDescriptors for prototypes
 safeDescriptors) {
   if (safeDescriptors === void 0) {
     safeDescriptors = globalState.safeDescriptors;
   }
 
   assertFlowDescriptor(adm, annotation, key, descriptor);
+  var value = descriptor.value;
+
+  if (bound) {
+    var _adm$proxy_;
+
+    value = value.bind((_adm$proxy_ = adm.proxy_) != null ? _adm$proxy_ : adm.target_);
+  }
+
   return {
-    value: flow(descriptor.value),
+    value: flow(value),
     // Non-configurable for classes
     // prevents accidental field redefinition in subclass
     configurable: safeDescriptors ? adm.isPlainObject_ : true,
@@ -835,7 +869,7 @@ function createAutoAnnotation(options) {
 }
 
 function make_$5(adm, key, descriptor, source) {
-  var _this$options_2, _this$options_3;
+  var _this$options_3, _this$options_4;
 
   // getter -> computed
   if (descriptor.get) {
@@ -870,22 +904,25 @@ function make_$5(adm, key, descriptor, source) {
 
 
   if (source !== adm.target_ && typeof descriptor.value === "function") {
-    var _this$options_;
+    var _this$options_2;
 
     if (isGenerator(descriptor.value)) {
-      return flow.make_(adm, key, descriptor, source);
+      var _this$options_;
+
+      var flowAnnotation = ((_this$options_ = this.options_) == null ? void 0 : _this$options_.autoBind) ? flow.bound : flow;
+      return flowAnnotation.make_(adm, key, descriptor, source);
     }
 
-    var actionAnnotation = ((_this$options_ = this.options_) == null ? void 0 : _this$options_.autoBind) ? autoAction.bound : autoAction;
+    var actionAnnotation = ((_this$options_2 = this.options_) == null ? void 0 : _this$options_2.autoBind) ? autoAction.bound : autoAction;
     return actionAnnotation.make_(adm, key, descriptor, source);
   } // other -> observable
   // Copy props from proto as well, see test:
   // "decorate should work with Object.create"
 
 
-  var observableAnnotation = ((_this$options_2 = this.options_) == null ? void 0 : _this$options_2.deep) === false ? observable.ref : observable; // if function respect autoBind option
+  var observableAnnotation = ((_this$options_3 = this.options_) == null ? void 0 : _this$options_3.deep) === false ? observable.ref : observable; // if function respect autoBind option
 
-  if (typeof descriptor.value === "function" && ((_this$options_3 = this.options_) == null ? void 0 : _this$options_3.autoBind)) {
+  if (typeof descriptor.value === "function" && ((_this$options_4 = this.options_) == null ? void 0 : _this$options_4.autoBind)) {
     var _adm$proxy_;
 
     descriptor.value = descriptor.value.bind((_adm$proxy_ = adm.proxy_) != null ? _adm$proxy_ : adm.target_);
@@ -895,7 +932,7 @@ function make_$5(adm, key, descriptor, source) {
 }
 
 function extend_$5(adm, key, descriptor, proxyTrap) {
-  var _this$options_4, _this$options_5;
+  var _this$options_5, _this$options_6;
 
   // getter -> computed
   if (descriptor.get) {
@@ -913,16 +950,20 @@ function extend_$5(adm, key, descriptor, proxyTrap) {
   // if function respect autoBind option
 
 
-  if (typeof descriptor.value === "function" && ((_this$options_4 = this.options_) == null ? void 0 : _this$options_4.autoBind)) {
+  if (typeof descriptor.value === "function" && ((_this$options_5 = this.options_) == null ? void 0 : _this$options_5.autoBind)) {
     var _adm$proxy_2;
 
     descriptor.value = descriptor.value.bind((_adm$proxy_2 = adm.proxy_) != null ? _adm$proxy_2 : adm.target_);
   }
 
-  var observableAnnotation = ((_this$options_5 = this.options_) == null ? void 0 : _this$options_5.deep) === false ? observable.ref : observable;
+  var observableAnnotation = ((_this$options_6 = this.options_) == null ? void 0 : _this$options_6.deep) === false ? observable.ref : observable;
   return observableAnnotation.extend_(adm, key, descriptor, proxyTrap);
 }
 
+var OBSERVABLE = "observable";
+var OBSERVABLE_REF = "observable.ref";
+var OBSERVABLE_SHALLOW = "observable.shallow";
+var OBSERVABLE_STRUCT = "observable.struct"; // Predefined bags of create observable options, to avoid allocating temporarily option objects
 // in the majority of cases
 
 var defaultCreateObservableOptions = {
@@ -935,14 +976,14 @@ Object.freeze(defaultCreateObservableOptions);
 function asCreateObservableOptions(thing) {
   return thing || defaultCreateObservableOptions;
 }
-var observableAnnotation = /*#__PURE__*/createObservableAnnotation("observable");
-var observableRefAnnotation = /*#__PURE__*/createObservableAnnotation("observable.ref", {
+var observableAnnotation = /*#__PURE__*/createObservableAnnotation(OBSERVABLE);
+var observableRefAnnotation = /*#__PURE__*/createObservableAnnotation(OBSERVABLE_REF, {
   enhancer: referenceEnhancer
 });
-var observableShallowAnnotation = /*#__PURE__*/createObservableAnnotation("observable.shallow", {
+var observableShallowAnnotation = /*#__PURE__*/createObservableAnnotation(OBSERVABLE_SHALLOW, {
   enhancer: shallowEnhancer
 });
-var observableStructAnnotation = /*#__PURE__*/createObservableAnnotation("observable.struct", {
+var observableStructAnnotation = /*#__PURE__*/createObservableAnnotation(OBSERVABLE_STRUCT, {
   enhancer: refStructEnhancer
 });
 var observableDecoratorAnnotation = /*#__PURE__*/createDecoratorAnnotation(observableAnnotation);
@@ -1547,6 +1588,10 @@ var ComputedValue = /*#__PURE__*/function () {
     if (!this.keepAlive_) {
       clearObserving(this);
       this.value_ = undefined; // don't hold on to computed value!
+
+      if ( this.isTracing_ !== TraceMode.NONE) {
+        console.log("[mobx.trace] Computed value '" + this.name_ + "' was suspended and it will recompute on the next access.");
+      }
     }
   };
 
@@ -1579,16 +1624,12 @@ var ComputedValue = /*#__PURE__*/function () {
 
   _proto.warnAboutUntrackedRead_ = function warnAboutUntrackedRead_() {
 
-    if (this.requiresReaction_ === true) {
-      die("[mobx] Computed value " + this.name_ + " is read outside a reactive context");
-    }
-
     if (this.isTracing_ !== TraceMode.NONE) {
-      console.log("[mobx.trace] '" + this.name_ + "' is being read outside a reactive context. Doing a full recompute");
+      console.log("[mobx.trace] Computed value '" + this.name_ + "' is being read outside a reactive context. Doing a full recompute.");
     }
 
-    if (globalState.computedRequiresReaction) {
-      console.warn("[mobx] Computed value " + this.name_ + " is being read outside a reactive context. Doing a full recompute");
+    if (globalState.computedRequiresReaction || this.requiresReaction_) {
+      console.warn("[mobx] Computed value '" + this.name_ + "' is being read outside a reactive context. Doing a full recompute.");
     }
   };
 
@@ -1721,7 +1762,7 @@ function checkIfStateModificationsAreAllowed(atom) {
 }
 function checkIfStateReadsAreAllowed(observable) {
   if ( !globalState.allowStateReads && globalState.observableRequiresReaction) {
-    console.warn("[mobx] Observable " + observable.name_ + " being read outside a reactive context");
+    console.warn("[mobx] Observable '" + observable.name_ + "' being read outside a reactive context.");
   }
 }
 /**
@@ -1765,7 +1806,7 @@ function warnAboutDerivationWithoutDependencies(derivation) {
   if (derivation.observing_.length !== 0) return;
 
   if (globalState.reactionRequiresObservable || derivation.requiresObservable_) {
-    console.warn("[mobx] Derivation " + derivation.name_ + " is created/updated without reading any observable value");
+    console.warn("[mobx] Derivation '" + derivation.name_ + "' is created/updated without reading any observable value.");
   }
 }
 /**
@@ -2785,6 +2826,9 @@ function isFlowCancellationError(error) {
   return error instanceof FlowCancellationError;
 }
 var flowAnnotation = /*#__PURE__*/createFlowAnnotation("flow");
+var flowBoundAnnotation = /*#__PURE__*/createFlowAnnotation("flow.bound", {
+  bound: true
+});
 var flow = /*#__PURE__*/Object.assign(function flow(arg1, arg2) {
   // @flow
   if (isStringish(arg2)) {
@@ -2870,6 +2914,7 @@ var flow = /*#__PURE__*/Object.assign(function flow(arg1, arg2) {
   res.isMobXFlow = true;
   return res;
 }, flowAnnotation);
+flow.bound = /*#__PURE__*/createDecoratorAnnotation(flowBoundAnnotation);
 
 function cancelPromise(promise) {
   if (isFunction(promise.cancel)) promise.cancel();
@@ -3094,6 +3139,20 @@ function get(obj, key) {
 
   die(11);
 }
+function apiDefineProperty(obj, key, descriptor) {
+  if (isObservableObject(obj)) {
+    return obj[$mobx].defineProperty_(key, descriptor);
+  }
+
+  die(39);
+}
+function apiOwnKeys(obj) {
+  if (isObservableObject(obj)) {
+    return obj[$mobx].ownKeys_();
+  }
+
+  die(38);
+}
 
 function observe(thing, propOrCb, cbOrFire, fireImmediately) {
   if (isFunction(cbOrFire)) return observeObservableProperty(thing, propOrCb, cbOrFire, fireImmediately);else return observeObservable(thing, propOrCb, cbOrFire);
@@ -3114,7 +3173,7 @@ function cache(map, key, value) {
 
 function toJSHelper(source, __alreadySeen) {
   if (source == null || typeof source !== "object" || source instanceof Date || !isObservable(source)) return source;
-  if (isObservableValue(source)) return toJSHelper(source.get(), __alreadySeen);
+  if (isObservableValue(source) || isComputedValue(source)) return toJSHelper(source.get(), __alreadySeen);
 
   if (__alreadySeen.has(source)) {
     return __alreadySeen.get(source);
@@ -3148,7 +3207,7 @@ function toJSHelper(source, __alreadySeen) {
     // must be observable object
     var _res3 = cache(__alreadySeen, source, {});
 
-    source[$mobx].ownKeys_().forEach(function (key) {
+    apiOwnKeys(source).forEach(function (key) {
       if (objectPrototype.propertyIsEnumerable.call(source, key)) {
         _res3[key] = toJSHelper(source[key], __alreadySeen);
       }
@@ -3231,10 +3290,10 @@ function _when(predicate, effect, opts) {
   var timeoutHandle;
 
   if (typeof opts.timeout === "number") {
+    var error = new Error("WHEN_TIMEOUT");
     timeoutHandle = setTimeout(function () {
       if (!disposer[$mobx].isDisposed_) {
         disposer();
-        var error = new Error("WHEN_TIMEOUT");
         if (opts.onError) opts.onError(error);else throw error;
       }
     }, opts.timeout);
@@ -3321,7 +3380,7 @@ var objectProxyTraps = {
     return (_getAdm$definePropert = getAdm(target).defineProperty_(name, descriptor)) != null ? _getAdm$definePropert : true;
   },
   ownKeys: function ownKeys(target) {
-    if ( globalState.trackingDerivation) warnAboutProxyRequirement("iterate keys to detect added / removed properties. Use `keys` from 'mobx' instead.");
+    if ( globalState.trackingDerivation) warnAboutProxyRequirement("iterate keys to detect added / removed properties. Use 'keys' from 'mobx' instead.");
     return getAdm(target).ownKeys_();
   },
   preventExtensions: function preventExtensions(target) {
@@ -5684,7 +5743,7 @@ function isAnnotation(thing) {
  * - utils/   Utility stuff.
  *
  */
-["Symbol", "Map", "Set", "Symbol"].forEach(function (m) {
+["Symbol", "Map", "Set"].forEach(function (m) {
   var g = getGlobal();
 
   if (typeof g[m] === "undefined") {
@@ -5726,6 +5785,7 @@ exports.comparer = comparer;
 exports.computed = computed;
 exports.configure = configure;
 exports.createAtom = createAtom;
+exports.defineProperty = apiDefineProperty;
 exports.entries = entries;
 exports.extendObservable = extendObservable;
 exports.flow = flow;
@@ -5758,6 +5818,7 @@ exports.onBecomeObserved = onBecomeObserved;
 exports.onBecomeUnobserved = onBecomeUnobserved;
 exports.onReactionError = onReactionError;
 exports.override = override;
+exports.ownKeys = apiOwnKeys;
 exports.reaction = reaction;
 exports.remove = remove;
 exports.runInAction = runInAction;