# ReScope
##
[](https://travis-ci.org/CaipiLabs/rescope)
[](https://npmjs.org/package/rescope)
[](#)
##
## ReScope What ?
ReScope is a flexible, effective and easy to use state management system inspired by ReactJS methods.
## What's the point ?
Applications transform structured data & events into user-friendly interfaces and controls.
The set of data transformations of one or more applications can be divided into reusable data components with a reactive state and result data.
Just like React Components.
Of course, that's quickly said, in an application, the data must deal with complex dependencies,
different contexts, custom data bindings, and so on.
This is where reScope comes in:
It offers a simple, flexible and familiar structure to organize and synchronize your data components.
It manage theirs dependencies, theirs scopes, persitence, active instances & much more.
## How ?
By using independent, specialized & serializable "Data Stores" in a Flux oriented architecture.
### Stores ?
ReScope stores look like "React components for data".
Basically, they render determined data according theirs entry state & dependencies data.
Each Stores can manage part of, or the entire App state's determining values,
maintain intermediate, possibly asynchronous resources,
and/or finals or ready-to-render data.
### Scopes ?
To deal with complex architectures & data processing the Scopes allow :
- normalized scopes for modules & views
- to inherit & mix other Scopes,
- automatic & chained destroy
- ...
## What else ?
- React "high order components" factories decorators ( [react-rescope](https://github.com/CaipiLabs/react-rescope) )
- Keep related stuff in the same store files (actions, mutations, helpers, states, etc...)
- Remove up to 100% of the tpls components code and put them in clean, reusable & specialized stores,
- Easy pairing of remote / webworker based stores
- Easy remapping & aliasing of dependencies data,
- Easy, partial or complete serialization / restoration
- No more real async problems
- Promise like APIs
- Semaphores like API ( wait, release, retain, dispose )
- Inheritable ES6 class
- Synchrone injection & init (React SSR) (as long as stores transformations stay sync)
- Lazy stores instantiation & active stores auto destroy
- Another alternative to Redux & co
- Library agnostic, rescope has no dependencies and will keep working with any states based system
- etc..
## Doc ?
[Work in progress doc](doc/readme.md)
About [Stores](doc/Store.md)
About [Scopes](doc/Scope.md)
### Related packages
The ReScope package has a limited perimeter,
other packages make it even easier to use:
React HOCs, decorators & tools : [react-rescope](https://github.com/CaipiLabs/react-rescope)
ReScope HOCs, decorators & tools : [rescope-spells](https://github.com/CaipiLabs/rescope-spells)
### Samples & bootstraps
The examples and bootstrap will come gradually [here](https://github.com/CaipiLabs/rescope-samples)
## What's next ?
- Optimize
- Many more tests
- Cosmetics rewrites & more comments
- Possibly some semantic/normalisation updates
[](http://hits.dwyl.io/caipilabs/Caipilabs/rescope)
