momentum 1.1.4

A super powerful flutter state management library that focuses on ease of control inspired with MVC pattern.

1.1.4

• exposed MomentumModel.controller property.

---

1.1.3 - Breaking Changes

• bootstrap() method is now synchronous only.
• added bootstrapAsync() for separate asynchronous support.
• For the execution order, bootstrap() gets called first then bootstrapAsync().
• added detailed logging for both bootstrap() and bootstrapAsync() so you can really see what gets executed first and the time it took.

---

1.1.2

• Fixed health check: Fix lib/src/momentum_base.dart. (-1 points)

---

1.1.1

• New feature: Asynchronous bootstrap() method now supports loading widget using appLoader parameter on Momentum root widget. If appLoader is not specified a default loading widget will be shown.
  • You have to turn lazy loading off to enable this feature.
  • Lets say one of your controllers implements bootstrap() method asynchronously and it loads a data that takes seconds to finish:

      @override
      void bootstrap() async {
        // assuming we are loading some complex and big data here.
        var appSettings = await apiService.getAppSettings();
        model.update(appSettings: appSettings);
      }
    

  • Now, imagine apiService.getAppSettings() takes 3-5 seconds to load. Before your MyApp() gets actually loaded, momentum will await this boostrap method and show a loading widget until it finishes. Means, you can now do anything you want with bootstrap() method synchronous or asynchonous. It is safe to call model.update(...) in this method.

---

1.1.0

• Reformatted the whole readme, reduce number of headings.

---

1.0.9

• New feature: dontRebuildIf parameter for MomentumBuilder.

  • This method will be called after model.update(...) right before the builder.

  • isTimeTravel is also provided that indicates if the model was updated by time travel methods .backward() or .forward(), returning it directly means you don't want to rebuild if an update was done with time travel method.

  • Two new properties was also added: MomentumController.prevModel and MomentumController.nextModel which are properties from model history and their meaning is quite obvious. The prevModel is the previous state and nextModel is the next state which will only have a value if you use .backward() method. If you are on latest snapshot of the model nextModel will be null.

  • Take a look at this example, The widget is displaying a time format HH:mm and TimerController ticks every 500ms for accuracy. We only need to rebuild if minute property is changed, that's where dontRebuildIf parameter comes.

      MomentumBuilder(
        controllers: [TimerController],
        dontRebuildIf: (controller, isTimeTravel) {
          var timer = controller<TimerController>();
          var prevMinute = timer.prevModel.dateTime.minute;
          var currentMinute = timer.model.dateTime.minute;
          var minuteUnchanged = currentMinute == prevMinute;
          return minuteUnchanged; // don't rebuild the widget if "minute" is unchanged.
        },
        builder: (context, snapshot) {...},
      )
    

  • WARNING: This method is the same as any other builder or build methods, do not call model.update(...) or anything that calls build method, for example setState(...). You'll get an infinite loop.

---

1.0.8

• Major update:
  • updated onResetAll to support widget operation before actually reseting all models.
  • improved README, added lots of new contents.

---

1.0.7

• fixed typos on readme.

---

1.0.6

• updated readme, added MomentumState listener section. and also fix typos.

---

1.0.5

• fix readme not properly displaying in pub.dev

---

1.0.4

• updated example project to link the correct momentum version from pub.dev.

---

1.0.3

• updated readme, now most parts are covered.

---

1.0.2

• added example app.

---

1.0.1

• updated error message.

---

1.0.0

• Initial version.