mobx 6.0.0 → 6.0.4

package/README.md

@@ -4,11 +4,13 @@
 
 _Simple, scalable state management._
 
-[![Discuss on Github](https://img.shields.io/badge/discuss%20on-GitHub-orange)](https://github.com/mobxjs/mobx/discussions)
 [![npm version](https://badge.fury.io/js/mobx.svg)](https://badge.fury.io/js/mobx)
 [![OpenCollective](https://opencollective.com/mobx/backers/badge.svg)](docs/backers-sponsors.md#backers)
 [![OpenCollective](https://opencollective.com/mobx/sponsors/badge.svg)](docs/backers-sponsors.md#sponsors)
 
+[![Discuss on Github](https://img.shields.io/badge/discuss%20on-GitHub-orange)](https://github.com/mobxjs/mobx/discussions)
+[![View changelog](https://img.shields.io/badge/changelogs.xyz-Explore%20Changelog-brightgreen)](https://changelogs.xyz/mobx)
+
 ---
 
 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.
@@ -23,13 +25,14 @@ MobX is made possible by the generosity of the sponsors below, and many other [i
 <a href="https://www.canva.com/"><img src="docs/assets/canva.png" align="center" width="100" title="Canva" alt="Canva" /></a>
 
 **🥈Silver sponsors (\$100+ pm):**<br/>
-<a href="https://mantro.net/jobs/warlock"><img src="docs/assets/mantro.png" align="center" width="100" title="mantro GmbH" alt="mantro GmbH"></a>
 <a href="https://www.codefirst.co.uk/"><img src="docs/assets/codefirst.png" align="center" width="100" title="CodeFirst" alt="CodeFirst"/></a>
 <a href="https://www.dcslsoftware.com/"><img src="docs/assets/dcsl.png" align="center" width="100" title="DCSL Software" alt="DCSL Software"/></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="docs/assets/bugsnag.jpg" align="center" width="100" title="Bugsnag" alt="Bugsnag"/></a>
 <a href="https://curology.com/blog/tech"><img src="docs/assets/curology.png" align="center" width="100" title="Curology" alt="Curology"/></a>
+<a href="https://modulz.app/"><img src="docs/assets/modulz.png" align="center" width="100" title="Modulz" alt="Modulz"/></a>
 
 **🥉Bronze sponsors (\$500+ total contributions):**<br/>
+<a href="https://mantro.net/jobs/warlock"><img src="docs/assets/mantro.png" align="center" width="100" title="mantro GmbH" alt="mantro GmbH"></a>
 <a href="https://www.algolia.com/"><img src="docs/assets/algolia.jpg" align="center" width="100" title="Algolia" alt="Algolia" /></a>
 <a href="https://talentplot.com/"><img src="docs/assets/talentplot.png" align="center" width="100" title="talentplot" alt="talentplot"></a>
 <a href="https://careers.dazn.com/"><img src="docs/assets/dazn.png" align="center" width="100" title="DAZN" alt="DAZN"></a>
@@ -163,7 +166,7 @@ Created by [Pavan Podila](https://twitter.com/pavanpodila) and [Michel Weststrat
 
 -   [Introduction to MobX & React in 2020](https://www.youtube.com/watch?v=pnhIJA64ByY) by Leigh Halliday, _17min_.
 -   [ReactNext 2016: Real World MobX](https://www.youtube.com/watch?v=Aws40KOx90U) by Michel Weststrate, _40min_, [slides](https://docs.google.com/presentation/d/1DrI6Hc2xIPTLBkfNH8YczOcPXQTOaCIcDESdyVfG_bE/edit?usp=sharing).
--   [CityJS 2020: MobX, from mutable to immutable, to observable data](https://youtu.be/sP7dtZm_Wx0?t=27050) by Michel Weststrate, _30min_
+-   [CityJS 2020: MobX, from mutable to immutable, to observable data](https://www.youtube.com/watch?v=ZHxFrbK3VB0&feature=emb_logo) by Michel Weststrate, _30min_.
 -   [OpenSourceNorth: Practical React with MobX (ES5)](https://www.youtube.com/watch?v=XGwuM_u7UeQ) by Matt Ruby, _42min_.
 -   [HolyJS 2019: MobX and the unique symbiosis of predictability and speed](https://www.youtube.com/watch?v=NBYbBbjZeX4&list=PL8sJahqnzh8JJD7xahG5zXkjfM5GOgcPA&index=21&t=0s) by Michel Weststrate, _59min_.
 -   [React Amsterdam 2016: State Management Is Easy](https://www.youtube.com/watch?v=ApmSsu3qnf0&feature=youtu.be) by Michel Weststrate, _20min_, [slides](https://speakerdeck.com/mweststrate/state-management-is-easy-introduction-to-mobx).

package/dist/api/annotation.d.ts

@@ -4,5 +4,5 @@ export declare type Annotation = {
 };
 export declare type AnnotationMapEntry = Annotation | true | false;
 export declare type AnnotationsMap<T, AdditionalFields extends PropertyKey> = {
-    [P in keyof T]?: AnnotationMapEntry;
+    [P in Exclude<keyof T, "toString">]?: AnnotationMapEntry;
 } & Record<AdditionalFields, AnnotationMapEntry>;

package/dist/api/makeObservable.d.ts

@@ -3,5 +3,5 @@ export declare function makeProperty(adm: ObservableObjectAdministration, owner:
 autoBind: boolean): void;
 declare type NoInfer<T> = [T][T extends any ? 0 : never];
 export declare function makeObservable<T, AdditionalKeys extends PropertyKey = never>(target: T, annotations?: AnnotationsMap<T, NoInfer<AdditionalKeys>>, options?: CreateObservableOptions): T;
-export declare function makeAutoObservable<T extends Object, AdditionalKeys extends PropertyKey = never>(target: T, excludes?: AnnotationsMap<T, NoInfer<AdditionalKeys>>, options?: CreateObservableOptions): T;
+export declare function makeAutoObservable<T extends Object, AdditionalKeys extends PropertyKey = never>(target: T, overrides?: AnnotationsMap<T, NoInfer<AdditionalKeys>>, options?: CreateObservableOptions): T;
 export {};

package/dist/core/action.d.ts

@@ -12,7 +12,7 @@ export interface IActionRunInfo {
     actionId_: number;
     runAsAction_?: boolean;
 }
-export declare function _startAction(actionName: string, canRunAsDeriviation: boolean, // true for autoAction
+export declare function _startAction(actionName: string, canRunAsDerivation: boolean, // true for autoAction
 scope: any, args?: IArguments): IActionRunInfo;
 export declare function _endAction(runInfo: IActionRunInfo): void;
 export declare function allowStateChanges<T>(allowStateChanges: boolean, func: () => T): T;

package/dist/core/computedvalue.d.ts

@@ -72,7 +72,7 @@ export declare class ComputedValue<T> implements IObservable, IComputedValue<T>,
      *
      * The `equals` property specifies the comparer function to use to determine if a newly produced
      * value differs from the previous value. Two comparers are provided in the library; `defaultComparer`
-     * compares based on identity comparison (===), and `structualComparer` deeply compares the structure.
+     * compares based on identity comparison (===), and `structuralComparer` deeply compares the structure.
      * Structural comparison can be convenient if you always produce a new aggregated object and
      * don't want to notify observers if it is structurally the same.
      * This is useful for working with vectors, mouse coordinates etc.

package/dist/mobx.cjs.development.js

@@ -1,5 +1,7 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
 var niceErrors = {
   0: "Invalid value for configuration 'enforceActions', expected 'never', 'always' or 'observed'",
   1: function _(prop) {
@@ -85,9 +87,21 @@ function die(error) {
   }
 }
 
+var mockGlobal = {};
 function getGlobal() {
-  // @ts-ignore
-  return typeof global !== "undefined" ? global : window;
+  if (typeof window !== "undefined") {
+    return window;
+  }
+
+  if (typeof global !== "undefined") {
+    return global;
+  }
+
+  if (typeof self !== "undefined") {
+    return self;
+  }
+
+  return mockGlobal;
 }
 
 var assign = Object.assign;
@@ -150,11 +164,11 @@ function isPlainObject(value) {
   if (!isObject(value)) return false;
   var proto = Object.getPrototypeOf(value);
   if (proto == null) return true;
-  return ((_proto$constructor = proto.constructor) === null || _proto$constructor === void 0 ? void 0 : _proto$constructor.toString()) === plainObjectString;
+  return ((_proto$constructor = proto.constructor) == null ? void 0 : _proto$constructor.toString()) === plainObjectString;
 } // https://stackoverflow.com/a/37865170
 
 function isGenerator(obj) {
-  var constructor = obj === null || obj === void 0 ? void 0 : obj.constructor;
+  var constructor = obj == null ? void 0 : obj.constructor;
   if (!constructor) return false;
   if ("GeneratorFunction" === constructor.name || "GeneratorFunction" === constructor.displayName) return true;
   return false;
@@ -178,12 +192,12 @@ function addHiddenFinalProp(object, propName, value) {
 function assertPropertyConfigurable(object, prop) {
   {
     var descriptor = getDescriptor(object, prop);
-    if ((descriptor === null || descriptor === void 0 ? void 0 : descriptor.configurable) === false || (descriptor === null || descriptor === void 0 ? void 0 : descriptor.writable) === false) die("Cannot make property '" + stringifyKey(prop) + "' observable, it is not configurable and writable in the target object");
+    if ((descriptor == null ? void 0 : descriptor.configurable) === false || (descriptor == null ? void 0 : descriptor.writable) === false) die("Cannot make property '" + stringifyKey(prop) + "' observable, it is not configurable and writable in the target object");
   }
 }
-function createInstanceofPredicate(name, clazz) {
+function createInstanceofPredicate(name, theClass) {
   var propName = "isMobX" + name;
-  clazz.prototype[propName] = true;
+  theClass.prototype[propName] = true;
   return function (x) {
     return isObject(x) && x[propName] === true;
   };
@@ -500,7 +514,7 @@ var annotationToEnhancer = (_annotationToEnhancer = {}, _annotationToEnhancer[OB
 function getEnhancerFromAnnotation(annotation) {
   var _annotationToEnhancer2;
 
-  return !annotation ? deepEnhancer : (_annotationToEnhancer2 = annotationToEnhancer[annotation.annotationType_]) !== null && _annotationToEnhancer2 !== void 0 ? _annotationToEnhancer2 : die(12);
+  return !annotation ? deepEnhancer : (_annotationToEnhancer2 = annotationToEnhancer[annotation.annotationType_]) != null ? _annotationToEnhancer2 : die(12);
 }
 /**
  * Turns an object, array or function into a reactive structure.
@@ -544,7 +558,7 @@ var observableFactories = {
   object: function object(props, decorators, options) {
     var o = asCreateObservableOptions(options);
     var base = {};
-    asObservableObject(base, options === null || options === void 0 ? void 0 : options.name, getEnhancerFromOption(o));
+    asObservableObject(base, options == null ? void 0 : options.name, getEnhancerFromOption(o));
     return extendObservable(globalState.useProxies === false || o.proxy === false ? base : createDynamicObservableObject(base), props, decorators, options);
   },
   ref: /*#__PURE__*/createDecorator(OBSERVABLE_REF),
@@ -598,7 +612,7 @@ var _getDescriptor$config, _getDescriptor;
 
 var currentActionId = 0;
 var nextActionId = 1;
-var isFunctionNameConfigurable = (_getDescriptor$config = (_getDescriptor = /*#__PURE__*/getDescriptor(function () {}, "name")) === null || _getDescriptor === void 0 ? void 0 : _getDescriptor.configurable) !== null && _getDescriptor$config !== void 0 ? _getDescriptor$config : false; // we can safely recycle this object
+var isFunctionNameConfigurable = (_getDescriptor$config = (_getDescriptor = /*#__PURE__*/getDescriptor(function () {}, "name")) == null ? void 0 : _getDescriptor.configurable) != null ? _getDescriptor$config : false; // we can safely recycle this object
 
 var tmpNameDescriptor = {
   value: "action",
@@ -641,24 +655,24 @@ function executeAction(actionName, canRunAsDerivation, fn, scope, args) {
     _endAction(runInfo);
   }
 }
-function _startAction(actionName, canRunAsDeriviation, // true for autoAction
+function _startAction(actionName, canRunAsDerivation, // true for autoAction
 scope, args) {
   var notifySpy_ =  isSpyEnabled() && !!actionName;
   var startTime_ = 0;
 
   if ( notifySpy_) {
     startTime_ = Date.now();
-    var flattendArgs = args ? Array.from(args) : EMPTY_ARRAY;
+    var flattenedArgs = args ? Array.from(args) : EMPTY_ARRAY;
     spyReportStart({
       type: ACTION,
       name: actionName,
       object: scope,
-      arguments: flattendArgs
+      arguments: flattenedArgs
     });
   }
 
   var prevDerivation_ = globalState.trackingDerivation;
-  var runAsAction = !canRunAsDeriviation || !prevDerivation_;
+  var runAsAction = !canRunAsDerivation || !prevDerivation_;
   startBatch();
   var prevAllowStateChanges_ = globalState.allowStateChanges; // by default preserve previous allow
 
@@ -1006,7 +1020,7 @@ var ComputedValue = /*#__PURE__*/function () {
    *
    * The `equals` property specifies the comparer function to use to determine if a newly produced
    * value differs from the previous value. Two comparers are provided in the library; `defaultComparer`
-   * compares based on identity comparison (===), and `structualComparer` deeply compares the structure.
+   * compares based on identity comparison (===), and `structuralComparer` deeply compares the structure.
    * Structural comparison can be convenient if you always produce a new aggregated object and
    * don't want to notify observers if it is structurally the same.
    * This is useful for working with vectors, mouse coordinates etc.
@@ -2339,7 +2353,7 @@ function extendObservable(target, properties, annotations, options) {
   try {
     var descs = getOwnPropertyDescriptors(properties);
     getPlainObjectKeys(descs).forEach(function (key) {
-      makeProperty(adm, target, key, descs[key], !annotations ? true : key in annotations ? annotations[key] : true, true, !!(options === null || options === void 0 ? void 0 : options.autoBind));
+      makeProperty(adm, target, key, descs[key], !annotations ? true : key in annotations ? annotations[key] : true, true, !!(options == null ? void 0 : options.autoBind));
     });
   } finally {
     endBatch();
@@ -2434,7 +2448,7 @@ var flow = /*#__PURE__*/Object.assign(function flow(arg1, arg2) {
       }
 
       function next(ret) {
-        if (isFunction(ret === null || ret === void 0 ? void 0 : ret.then)) {
+        if (isFunction(ret == null ? void 0 : ret.then)) {
           // an async iterator
           ret.then(next, reject);
           return;
@@ -2481,7 +2495,7 @@ function flowResult(result) {
   return result; // just tricking TypeScript :)
 }
 function isFlow(fn) {
-  return (fn === null || fn === void 0 ? void 0 : fn.isMobXFlow) === true;
+  return (fn == null ? void 0 : fn.isMobXFlow) === true;
 }
 
 function interceptReads(thing, propOrHandler, handler) {
@@ -3025,7 +3039,7 @@ function getInferredAnnotation(desc, defaultAnnotation, autoBind) {
 
   if (isFunction(desc.value)) return isGenerator(desc.value) ? flow : isAction(desc.value) ? false : autoBind ? autoAction.bound : autoAction; // if (!desc.configurable || !desc.writable) return false
 
-  return defaultAnnotation !== null && defaultAnnotation !== void 0 ? defaultAnnotation : observable.deep;
+  return defaultAnnotation != null ? defaultAnnotation : observable.deep;
 }
 
 function getDescriptorInChain(target, prop) {
@@ -3052,7 +3066,7 @@ autoBind) {
   var target = adm.target_;
   var defaultAnnotation = observable; // ideally grap this from adm's defaultEnahncer instead!
 
-  var origAnnotation = annotation;
+  var originAnnotation = annotation;
 
   if (annotation === true) {
     annotation = getInferredAnnotation(descriptor, defaultAnnotation, autoBind);
@@ -3126,20 +3140,20 @@ autoBind) {
     case OBSERVABLE_STRUCT:
       {
         if ( isObservableProp(target, key)) die("Cannot decorate '" + key.toString() + "': the property is already decorated as observable.");
-        if ( !("value" in descriptor)) die("Cannot decorate '" + key.toString() + "': observable cannot be used on setter / getter properties."); // if the origAnnotation was true, preferred the adm's default enhancer over the inferred one
+        if ( !("value" in descriptor)) die("Cannot decorate '" + key.toString() + "': observable cannot be used on setter / getter properties."); // if the originAnnotation was true, preferred the adm's default enhancer over the inferred one
 
-        var enhancer = origAnnotation === true ? adm.defaultEnhancer_ : getEnhancerFromAnnotation(annotation);
+        var enhancer = originAnnotation === true ? adm.defaultEnhancer_ : getEnhancerFromAnnotation(annotation);
         adm.addObservableProp_(key, descriptor.value, enhancer);
         break;
       }
 
     default:
-      die("invalid decorator '" + ((_annotation$annotatio = annotation.annotationType_) !== null && _annotation$annotatio !== void 0 ? _annotation$annotatio : annotation) + "' for '" + key.toString() + "'");
+      die("invalid decorator '" + ((_annotation$annotatio = annotation.annotationType_) != null ? _annotation$annotatio : annotation) + "' for '" + key.toString() + "'");
   }
 }
 function makeObservable(target, annotations, options) {
-  var autoBind = !!(options === null || options === void 0 ? void 0 : options.autoBind);
-  var adm = asObservableObject(target, options === null || options === void 0 ? void 0 : options.name, getEnhancerFromAnnotation(options === null || options === void 0 ? void 0 : options.defaultDecorator));
+  var autoBind = !!(options == null ? void 0 : options.autoBind);
+  var adm = asObservableObject(target, options == null ? void 0 : options.name, getEnhancerFromAnnotation(options == null ? void 0 : options.defaultDecorator));
   startBatch();
 
   try {
@@ -3166,7 +3180,7 @@ function makeObservable(target, annotations, options) {
 
   return target;
 }
-function makeAutoObservable(target, excludes, options) {
+function makeAutoObservable(target, overrides, options) {
   var proto = Object.getPrototypeOf(target);
   var isPlain = proto == null || proto === objectPrototype;
 
@@ -3181,7 +3195,7 @@ function makeAutoObservable(target, excludes, options) {
     // shortcut, reuse inferred annotations for this type from the previous time
     annotations = proto[CACHED_ANNOTATIONS];
   } else {
-    annotations = _extends({}, excludes);
+    annotations = _extends({}, overrides);
     extractAnnotationsFromObject(target, annotations, options);
 
     if (!isPlain) {
@@ -3197,8 +3211,8 @@ function makeAutoObservable(target, excludes, options) {
 function extractAnnotationsFromObject(target, collector, options) {
   var _options$defaultDecor;
 
-  var autoBind = !!(options === null || options === void 0 ? void 0 : options.autoBind);
-  var defaultAnnotation = (options === null || options === void 0 ? void 0 : options.deep) ? observable.deep : (_options$defaultDecor = options === null || options === void 0 ? void 0 : options.defaultDecorator) !== null && _options$defaultDecor !== void 0 ? _options$defaultDecor : observable.deep;
+  var autoBind = !!(options == null ? void 0 : options.autoBind);
+  var defaultAnnotation = (options == null ? void 0 : options.deep) === undefined ? (_options$defaultDecor = options == null ? void 0 : options.defaultDecorator) != null ? _options$defaultDecor : observable.deep : (options == null ? void 0 : options.deep) ? observable.deep : observable.ref;
   Object.entries(getOwnPropertyDescriptors(target)).forEach(function (_ref) {
     var key = _ref[0],
         descriptor = _ref[1];
@@ -3216,7 +3230,7 @@ function extractAnnotationsFromProto(proto, collector, options) {
     if (prop.get) {
       collector[key] = computed;
     } else if (isFunction(prop.value)) {
-      collector[key] = isGenerator(prop.value) ? flow : (options === null || options === void 0 ? void 0 : options.autoBind) ? autoAction.bound : autoAction;
+      collector[key] = isGenerator(prop.value) ? flow : (options == null ? void 0 : options.autoBind) ? autoAction.bound : autoAction;
     }
   });
 }
@@ -4668,8 +4682,15 @@ function asObservableObject(target, name, defaultEnhancer) {
 
   if (hasProp(target, $mobx)) return target[$mobx];
   if ( !Object.isExtensible(target)) die("Cannot make the designated object observable; it is not extensible");
-  if (!isPlainObject(target)) name = (target.constructor.name || "ObservableObject") + "@" + getNextId();
-  if (!name) name = "ObservableObject@" + getNextId();
+
+  if (!name) {
+    if (isPlainObject(target)) {
+      name = "ObservableObject@" + getNextId();
+    } else {
+      name = (target.constructor.name || "ObservableObject") + "@" + getNextId();
+    }
+  }
+
   var adm = new ObservableObjectAdministration(target, new Map(), stringifyKey(name), defaultEnhancer);
   addHiddenProp(target, $mobx, adm);
   return adm;