mobx-sentinel/core

Core functionality for tracking changes to MobX observables and validating them.

Documentation: guide · API reference

• @nested annotation for tracking nested models.
  • @nested annotation supports objects, boxed observables, arrays, sets, and maps.
  • @nested.hoist annotation can be used to hoist sub-fields in a nested model to the parent model.
  • StandardNestedFetcher (low-level API) provides a simple but powerful mechanism for tracking and retrieving nested models. Allowing other modules (even your own code) to integrate nested models into their logic without hassle.
• Watcher detects changes in models automatically.
  • All @observable annotations are automatically watched by default.
  • @watch annotation can be used for @computed getters, and for fields holding an observable.box(), .array(), .map() or .set() instead of being annotated with @observable. e.g., @watch readonly count = observable.box(0)
  • @watch.ref annotation can be used to watch values with identity comparison, in contrast to the default behavior which uses shallow comparison.
  • @unwatch annotation and unwatch(() => ...) function disable change detection when you need to modify values silently.
• Validator and addValidation provide reactive model validation.
  • Composable from multiple sources.
  • Both sync and async validations are supported.
  • Async validations feature smart job scheduling and are cancellable with AbortSignal.