mobx 4.12.0 → 4.14.1

package/lib/api/autorun.d.ts

@@ -2,6 +2,11 @@ import { IReactionPublic, IReactionDisposer, IEqualsComparer } 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,16 @@
 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;

package/lib/api/when.d.ts

@@ -2,6 +2,11 @@ import { Lambda, IReactionDisposer } 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): 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/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,6 +78,16 @@ 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

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,5 +15,5 @@
  * - 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, extendShallowObservable, 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, 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, extendShallowObservable, 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, isComputingDerivation as _isComputingDerivation, onReactionError, interceptReads as _interceptReads, IComputedValueOptions, IActionRunInfo, _startAction, _endAction } from "./internal";
 export declare const $mobx = "$mobx";