reactter 5.1.0

A light, powerful and quick Reactive State Management, Dependency Injection and Event Management.

Reactter

5.1.0

Enhancements

• feat(framework): Implement hook register.
  • Add hook register logic for attaching ReactterState defined into ReactterHook.
  • Refactor hooks to implement hook register.
• feat(framework): Add lazy method and make isInstanceBuilding variable as public.
• feat(extensions): Add ReactterStateListExtension with when method.
• feat(hooks): Add UseCompute hook.
• feat(widget, test): Add ReactterConsumer widget.

Internal

• build(example): Use reactter_lint.
• build(widgets): Remove unnecesary import.
• doc: Fix ReactterInstanceNotFoundException documentation.
• refactor(framework): Export ReactterInstance.
• doc(example): Add and remove some concepts from main.
• refactor(example): Remove late keyword form some hooks.
• refactor(example): Implement play and stop animation.
• refactor(framework): Rename _RegisterHook to HookRegister.
• test: Add ReactterStateListExtension test and other adjustments.
• refactor(widgets): Make ReactterConsumer.builder required.
• fix(framework): Add instance attached validation before UseCompute is disponsed.
• refactor(extensions): Use UseCompute type on when method.
• test: Add UseCompute test and other adjustments.
• build(example): Change folder structure.
• build: Change folder structure for flutter_reactter package.
  • Move all files to src.
  • Rename ReactterTypes to types.
  • engine was separated into extensions, framework and types.
  • Change folder structure of test.
• build: Change folder structure for reactter package.
  • Move all files to src.
  • Rename ReactterTypes to types.
  • core was separated into framework, objs, signals, lifecycle, types.
  • Change folder structure of test.
• refactor(core, widgets): Implement Reactter event to Signal generic.
  • Remove ReactterSignalProxy.
  • Move Obj, Signal to other folder.
  • Refactor ReactterWatcher to the new changes.
• refactor(core): Remove ReactterNotifyManager.
  • ReactterNotifyManager is no longer used, all its methods were moved to ReactterState.
  • Lifecycle enum was move to new file(lifecycle.dart).

5.0.1

Internal

• fix(test): Change dependencies for test coverage.
• fix(test): Fix some info about code validator.

5.0.0

Breaking

• refactor(engine, widgets, core, hooks, test): Delete ReactterContext and ReactterHookManager and remove all about it.
• refactor(widgets, test): Replace ReactterContextNotFoundException to ReactterInstanceNotFoundException.
• refactor(widgets, test): Remove listenAllHooks property from ReactterComponent, use listenAll.
• refactor(widgets, test): Remove listenHooks property from ReactterComponent and ReactterProvider.contextOf, use listenStates.
• refactor(hooks, test): Remove context property from UseAsyncState, UseContext, UseEvent, UseReducer and UseState.
• refactor(hooks, test): Remove type ReactterAction, type is String.
• refactor(core, widgets, test): Delete ReactterBuilder and ReactterScope, replace to build, StatelessWidget, StatefulWidget or any Widget that expose BuildContext.

Enhancements

• feat(core): Add attachTo, detachTo and createState methods to ReactterState.

Fixes

• refactor(core): Fix hasListener no depend of ReactterNotifyManager.

Internal

• refactor, doc(example): Adjust to new changes.
• doc: Change documentation to better readability and adjut to new changes.

4.1.2

Internal

• build: Move examples folder to packages/flutter_reactter/example.

4.1.1

Fixes

• fix(core): Fix predispose all hook states.

Internal

• refactor(example): Minor changes in some examples.
• refactor(example): Improve code and design of tree example.
• refactor(example): Improve code of calculator example.
• refactor(example): Improve code of animation example.
• doc: Add link to examples using zapp

4.1.0

Enhancements

• perf(core): Improve performance for changing states.
• perf(engine): Improve management for context dependencies.

Fixes

• fix(core): Remove the callbacks of one events when the instance will be disposed.

Internal

• refactor(example): Improve examples and fix some bugs.
• doc: Fix documentation.

4.0.0

Enhancements

• feat(core): Add Obj.
• feat(core): Add Signal.
• feat(core): Add ReactterSignalProxy mixin.
• feat(core): Add ReactterNotifyManager mixin.
• feat(core): Add ReactterState mixin.
• refactor(core,hooks): Manage event separate from UseEvent hook.
• perf(core): Improve to manage instances.
• perf(core): Improve to manage state.
• perf(widgets,core): Improve performance on ReactterProvider. Now there is no need to use ReactterComponent or ReactterBuilder. The instance can be accessed directly from the context(BuildContext) and just the part belonging to the context is re-built.
• feat(widgets): Add ReactterWatcher. You can use the Signal variable in ReactterWatcher and react when it changed for ReactterWatcher's widgets rebuild.

Breaking

• refactor(core): Remove typedef innecesary.
• refactor(hooks): Fix dispose of UseContext and UseEffect.
• build(widgets): Mark ReactterScope as deprecated. Use any Widget that exposes the BuildContext like Build, StatelessWidget or StatefulWidget instead.
• build(widgets): Mark listenHooks and listenAllHooks as deprecated. Use listenStates and listenAll instead.
• refactor(widgets): Remove onInit from ReactteProvider and ReactterComponent.
• refactor(widget): Add ReactterContext argument in builder of ReactterProvider.

Fixes

• fix(core): Don't allow increasing listeners count, if event don't exist.
• fix(widgets): Clear previous signals saved.
• fix(core): Remove one callback using off method and was changed how to storage event.

Internal

• test: Refactor test and add event manager test.
• refactor(test): Fix test and add new tests.
• build(engine): Rename some files.
• refactor(test): Fix test and add ReactterWatcher test.
• refactor(examples): Improve examples code and add calculator example.
• doc: Fix documentation and add new documentation.
• test(core,hooks): Fix dispose on some tests.
• refactor(examples): Do counter more simple.

3.2.1-dev.2

Enhancements

• refactor(engine): Use ReactterScopeInheritedElement as mixin on ReactterProviderInheritedElement.
• perf(widget): Improve ReactterBuilder performance.

3.2.0

Enhancements

• feat(hooks): Add UseReducer hook.

Breaking

• refactor(core): Replace ReactterInstanceManager extension to class.

Fixes

• refactor(hooks): Move events storage variable.

Internal

• refactor(examples): Improve examples code.
• docs: Update roadmap.
• docs: Fix some typos and improve documentation.

3.1.2

Fixes

• fix(core): Add ref on Reactter.create.

Internal

• docs: Fix some documentation.

3.1.1

Fixes

• fix(widgets): Fix child and builder of ReactterProvider is not required when use ReactterProviders.

3.1.0

Breaking

• refactor(core): Remove selector aspect from ReactterProvider.of.

Fixes

• fix(core): Fix ReactterInstanceManager's get method create instance when instance didn't create yet.
• refactor(engine, widgets): Add validations about child and builder properties.

Enhancements

• refactor(core): Change Reactter.delete named argument to positional argument.

Internal

• docs: Fix README documentation.
• refactor(tests): Add test coverage of 100%.

3.0.0

Breaking

• build: Change structure folder. Now the package was separated into two packages, one for dart only(reactter) and one for flutter(flutter_reactter).
• refactor(hooks): Type return on UseAsyncState.when.
• refactor(widgets): Replace UseContext to ReactterProvider.
• refactor(widgets): Replace ReactterProvider to ReactterProviders.
• refactor: Rename LifeCycleEvent.onWillMount to Lifecycle.willMount,LifeCycleEvent.onDidMount to Lifecycle.didMount,LifeCycleEvent.onWillUpdate to Lifecycle.willUpdate,LifeCycleEvent.onDidUpdate to Lifecycle.didUpdate and LifeCycleEvent.onWillUnmount to Lifecycle.willUnmount.
• refactor(core): Move Reactter.factory.register to Reactter.register, Reactter.factory.unregistered to Reactter.unregister, Reactter.factory.existsInstance to Reactter.factory.exists, Reactter.factory.getInstance to Reactter.get, Reactter.factory.deletedInstance to Reactter.delete.
• refactor(core): Replace ReactterSubscribersManager to UseEvent.
• refactor(core): Replace BuildContext.read and BuildContext.readId to BuildContext.use.

Enhancements

• feat(widgets): Improve finding ReactterContext in the widget tree via the BuildContext. Now the operation of finding ReactterContext is O(1) and ReactterContext using id is O(2).
• refactor(hooks): Add more Lifecycle events(Lifecycle.registered,Lifecycle.unregistered,Lifecycle.registered and Lifecycle.destroyed)
• feat(hooks): Add UseContext hook.
• feat(hooks): Add UseEvent hook.
• feat(widgets): Add ReactterScope widget.
• refactor(core): Add Reactter.create and Reactter.find.

2.3.3

Enhancements

• refactor(core,widget): Remove life cycle class and move it to reactter_context.

Internal

• reactor(example): Move buttons and fix typo on tree example.
• docs(example): Change description of some examples.
• docs: Remove assets and change README.
• docs: Add README to example.

2.3.2

Fixes

• fix: format reactter.dart and remove an unnecessary dart file

2.3.1

Internal

• fix(example): Fix typo on counter example button.
• fix(example): Add implement tags on animation example.

2.3.0

Breaking

• refactor: Rename context.of to context.watch.
• refactor: Rename context.ofId to context.watchId.
• refactor: Rename context.ofStatic to context.read.
• refactor: Rename context.ofIdStatic to context.readId.
• refactor: Move subscribe and publish pattern to ReactterSubscribersManager class. Can use subscribe and publish pattern with enum type specified.
• refactor(widgets): Use ReactterInheritedProvider as scope on ReactterBuilder.
• refactor(widgets): Add ReactterBuilder as scope when didn't has builder on ReactterComponent.
• refactor(core): HookManager subscribe to willUpdate and didUpdate event.
• refactor(core): WillUpdate and DidUpdate event trigger when its ReactterHook update.
• refactor(engine): Manage dependencies of ReactterPubSub and lifecycle of ReactterContext.
• refactor(widget): Performance as the instance of context is listened to mark need build.
• refactor(hooks, widgets) - Rename UseProvide to ReactterProvider.

Fixes

• fix(hooks,widgets): Delete instances of UseContext when dispatch updated event on ReactterProvider, to prevent has instances duplicated.
• refactor(widget): Fix ReactterBuilder.

Enhancements

• feat(widgets): Send id for find ReactterContext on ReactterComponent.
• feat(widget): Add type on listenerHooks of ReactterBuilder.
• feat(hooks): Add argument to resolve method of UseAsyncState.
• feat(hooks): Add lifecycle willUpdate and didUpdate.
• feat(widget): Add onInit to UseContext.
• feat(hooks): UseEffect has lifecycle control of the context.
• feat(hook) UseContext works with unique ids to create unique instances.
• feat(widget): Add ReactterComponent.
• refactor(core): Remove context property as public on ReactterHook.
• feat(engine): Remove dependencies when ReactterProvider unmount.
• refactor(core): Remove unnecessary event listeners from ReactterContext.
• refactor(core,hooks): Remove unnecessary code.
• refactor(engine): Remove props unnecessary on ReactterInheritedProvider.
• refactor(hooks): Clear code and do code simple on UseAsyncState.
• refactor(core): Improve performance how instances manager on ReactterFactory.
• refactor(core): Improve UseEffect. Now the return of callback execute when a hook was change or willUnmount event was invoke.
• refactor(core): Improve lifecycle events. Now it uses as subscription.

Internal

• docs: Fix some documentation.
• feat(example): Add more example with animation.
• feat(example): Add new examples.
• docs: Add badgets, reorder topic, fix examples and improve redaction on README.
• docs: Add more documentation.
• tests: Add tests for hooks and Widgets.

1.0.1

Enhancements

• Improve performance with primitive loops in functions.

Internal

• Fix some documentation.
• Removed Utils folder from library.

1.0.0

Enhancements

• No need package dependencies: We decided to remove all dependencies and create a new state management from scratch.

• Controller now is Context: ReactterController has been replaced by ReactterContext, which are the classes that going to manage our states.

• Two ways to manage state: You can control the listeners from context like this:

    class AppContext extends ReactterContext {
        /* You can create the state here and add it to dependencies in 
        constructor with listenHooks() */
        final username = UseState<String>("");
  
        AppContext(){
            listenHooks([username]);
        }
  
        /* But we recommend to give the context to the state this way:
        With this, you no longer need to put it in listenHooks()
       which is cleaner */
        late final firstName = UseState<String>("Leo", context: this);
        late final lastName = UseState<String>("León", context: this);
    }
  

• Added UseProvider widget: UseProvider provide all ReactterContext to his children.

    UseProvider(
      contexts: [
        UseContext(
          () => AppContext(),
          init: true,
        ),
      ],
      builder: (context, _) {
        // Get all the states listeners of context.
        final appContext = context.of<AppContext>();
  
        // Get the listener of an specific state to rebuild.
        final appContext = context.of<AppContext>((ctx) => [ctx.userName]);
  
        // Read all the states, but no rebuild when change.
        final appContextStatic = context.ofStatic<AppContext>();
  
        return Text(appContext.username.value);
      }
    );
  
  

• Remove UseEffect widget: This widget has been replaced by a class called UseEffect. It has exactly the same functionality as the React Hook, when a dependency changes, executes the callback parameter.

    UseEffect((){
  
      userName.value = firstName + lastName;
  
    }, [firstName, lastName]);
  

-Note*: UseEffect has to be called inside context constructor.

• Added custom Hooks: You can create your own hooks with mixin inherit from ReactterHook.

   mixin UseCart on ReactterHook {
       late final cart = UseState<Cart?>(null, context: this);
  
       addProductToCart(Product product) {
           final oldProducts = cart.value.products;
  
           cart.value = cart.value?
               .copyWith(products: [...oldProducts, product]);
       }
   }
  
  

• Added UseAsyncState class: If you need an async state, you can use this:

  
  class AppContext extends ReactterContext {
      ...
  
       late final userName =
           UseAsyncState<String>("Init state", fillUsername, context: this);
  
       Future<String> fillUsername() async {
           final userFromApi = await getUserName();
  
           return userFromApi;
       }
  
       ...
  }
  
  

• Added UseAsyncState.when function: Added this function to controll the async flow from UseAsyncState:

   ...
   ),
   userContext.userName.when(
       // Base state
       standby: (value) => Text("Standby: " + value),
       // When is executing the async code
       loading: () => const CircularProgressIndicator(),
       // When the async code has finished
       done: (value) => Text(value),
       // When it throw an error
       error: (error) => const Text(
           "Unhandled exception",
           style: TextStyle(color: Colors.red),
       ),
   ),
   ...
  
  

• Added lifecycle methods to ReactterContext:

   @override
   awake() {
       // Executes when the instance starts building.
   }
  
   @override
   willMount() {
       // Before the dependency widget will mount in the tree.
   }
  
   @override
   didMount() {
       // After the dependency widget did mount in the tree.
   }
  
   @override
   willUnmount() {
       // When the widget removes from the tree.
   }
  
  

Internal

• Fix some documentation.
• Package description (was too short).
• Remove unused imports in library.
• Documentation
• 130 points in pub.dev.

1.0.0-dev

Enhancements

• Controller now is Context: ReactterController has been replaced by ReactterContext, which are the classes that going to manage our states.

    class AppContext extends ReactterContext {}
  

Internal

• No need package dependencies: We decided to remove all dependencies and create a new state management from scratch.

0.0.1-dev.4

Added

• useEffect
• useState
• Reactter View
• Reactter State
• Reactter Controller
• Routing Controller
• Helpers
• Exceptions
• Types

Changed

• First release