feat: new pub version

Author: mattrltrent

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.0.2
+
+- Improves documentation.
+- Adds example weather app.
+- Fixes assorted errors.
+
 ## 0.0.1
 
 - Initial release.

example/lib/main.dart

@@ -105,7 +105,8 @@ class _HomeScreenState extends State<HomeScreen> {
                 TextButton(
                   onPressed: () {
                     final latitude = double.tryParse(_latitudeController.text);
-                    final longitude = double.tryParse(_longitudeController.text);
+                    final longitude =
+                        double.tryParse(_longitudeController.text);
 
                     if (latitude != null && longitude != null) {
                       weatherTrent.fetchWeather(latitude, longitude);
@@ -121,8 +122,10 @@ class _HomeScreenState extends State<HomeScreen> {
                   child: Digester<WeatherTrent, WeatherTypes>(
                     child: (mapper) {
                       mapper
-                        ..as<NoData>((state) => const Text("Please enter location to fetch weather."))
-                        ..as<Loading>((state) => const CupertinoActivityIndicator())
+                        ..as<NoData>((state) => const Text(
+                            "Please enter location to fetch weather."))
+                        ..as<Loading>(
+                            (state) => const CupertinoActivityIndicator())
                         ..as<Data>((state) => Text(
                               "${state.location} has temperature ${state.temperature}°C",
                               style: const TextStyle(fontSize: 18),
@@ -191,7 +194,9 @@ class WeatherTrent extends Trent<WeatherTypes> {
     emit(Loading());
     Future.delayed(const Duration(milliseconds: 500), () {
       final mockData = {
-        "temperature": double.parse((15 + (latitude % 10) + Random().nextDouble() * 5).toStringAsFixed(1)),
+        "temperature": double.parse(
+            (15 + (latitude % 10) + Random().nextDouble() * 5)
+                .toStringAsFixed(1)),
         "location": "$latitude, $longitude",
       };
 

lib/src/logic/accessors.dart

@@ -14,7 +14,8 @@ T watch<T extends Trents>(BuildContext context) {
 }
 
 /// Retrieve a map over the current state of a Trent reactively.
-Widget watchMap<T extends Trents<S>, S>(BuildContext context, void Function(WidgetSubtypeMapper<S>) configure) {
+Widget watchMap<T extends Trents<S>, S>(
+    BuildContext context, void Function(WidgetSubtypeMapper<S>) configure) {
   final trent = Provider.of<T>(context, listen: true);
   final mapper = WidgetSubtypeMapper<S>(trent.state);
 

lib/src/logic/mappers.dart

@@ -47,6 +47,8 @@ class WidgetSubtypeMapper<Base> {
   /// Resolve the widget for the current state.
   Widget resolve() {
     final builder = _widgetBuilders[_state.runtimeType];
-    return builder?.call(_state) ?? _defaultBuilder?.call(_state) ?? const SizedBox.shrink();
+    return builder?.call(_state) ??
+        _defaultBuilder?.call(_state) ??
+        const SizedBox.shrink();
   }
 }

lib/src/logic/trent.dart

@@ -96,15 +96,18 @@ abstract class Trents<Base> extends ChangeNotifier {
   /// to return to D(value: 10) instead of D(value: some_value_you_must_define).
   Option<T> getExStateAs<T extends Base>() {
     return _lastStates[T] != null
-        ? _lastStates[T]!.match(some: (v) => Option.some(v as T), none: () => Option<T>.none())
+        ? _lastStates[T]!.match(
+            some: (v) => Option.some(v as T), none: () => Option<T>.none())
         : Option<T>.none();
   }
 
   /// Retrieve the current state as a specific type.
   ///
   /// Will return None if the current state is not of the specified type.
   Option<T> getCurrStateAs<T extends Base>() {
-    return _state.runtimeType == T ? Option.some(_state as T) : Option<T>.none();
+    return _state.runtimeType == T
+        ? Option.some(_state as T)
+        : Option<T>.none();
   }
 
   /// Dispose of the Trent.
@@ -129,6 +132,7 @@ abstract class Copyable<T> {
 }
 
 /// A generic Trent that manages state transitions.
-abstract class Trent<Base extends EquatableCopyable<Base>> extends Trents<Base> {
+abstract class Trent<Base extends EquatableCopyable<Base>>
+    extends Trents<Base> {
   Trent(super.state);
 }

lib/src/widgets/alerter.dart

@@ -3,7 +3,8 @@ import 'package:trent/src/logic/mappers.dart';
 import 'package:trent/trent.dart';
 
 /// A generic Alerter widget that listens to alert events and state changes from a Trent.
-class Alerter<TrentType extends Trents<StateType>, StateType> extends StatefulWidget {
+class Alerter<TrentType extends Trents<StateType>, StateType>
+    extends StatefulWidget {
   /// Called when an alert state is emitted, using a mapper.
   final void Function(LogicSubTypeMapper<StateType> mapper)? listenAlerts;
 
@@ -28,14 +29,17 @@ class Alerter<TrentType extends Trents<StateType>, StateType> extends StatefulWi
   });
 
   @override
-  AlerterState<TrentType, StateType> createState() => AlerterState<TrentType, StateType>();
+  AlerterState<TrentType, StateType> createState() =>
+      AlerterState<TrentType, StateType>();
 }
 
-class AlerterState<TrentType extends Trents<StateType>, StateType> extends State<Alerter<TrentType, StateType>> {
+class AlerterState<TrentType extends Trents<StateType>, StateType>
+    extends State<Alerter<TrentType, StateType>> {
   late final TrentType sm = get<TrentType>(context);
   late StateType _previousAlert; // Tracks the previous alert state
   late StateType _previousState; // Tracks the previous normal state
-  bool _hasInitialStateTriggered = false; // Tracks if the initial state has been emitted
+  bool _hasInitialStateTriggered =
+      false; // Tracks if the initial state has been emitted
 
   @override
   void initState() {
@@ -46,7 +50,8 @@ class AlerterState<TrentType extends Trents<StateType>, StateType> extends State
     // Listen to the alert stream
     sm.alertStream.listen((alert) {
       if (widget.listenAlerts != null) {
-        final shouldTrigger = widget.listenAlertsIf?.call(_previousAlert, alert) ?? true;
+        final shouldTrigger =
+            widget.listenAlertsIf?.call(_previousAlert, alert) ?? true;
         if (shouldTrigger) {
           final mapper = LogicSubTypeMapper<StateType>(alert);
           widget.listenAlerts!(mapper);
@@ -63,7 +68,8 @@ class AlerterState<TrentType extends Trents<StateType>, StateType> extends State
       }
 
       if (widget.listenStates != null) {
-        final shouldTrigger = widget.listenStatesIf?.call(_previousState, state) ?? true;
+        final shouldTrigger =
+            widget.listenStatesIf?.call(_previousState, state) ?? true;
         if (shouldTrigger) {
           final mapper = LogicSubTypeMapper<StateType>(state);
           widget.listenStates!(mapper);

lib/src/widgets/digester.dart

@@ -3,7 +3,8 @@ import 'package:trent/src/logic/mappers.dart';
 import 'package:trent/trent.dart';
 
 /// A generic Digester widget that listens to state changes from a Trent.
-class Digester<TrentType extends Trents<StateType>, StateType> extends StatelessWidget {
+class Digester<TrentType extends Trents<StateType>, StateType>
+    extends StatelessWidget {
   /// A callback to build widgets dynamically for each state type.
   final void Function(WidgetSubtypeMapper<StateType> mapper) child;
 

pubspec.yaml

@@ -1,6 +1,6 @@
 name: trent
 description: A Flutter package for simple, scalable, and reactive state management with built-in dependency injection and efficient stream-based state handling.
-version: 0.0.1
+version: 0.0.2
 
 homepage: https://matthewtrent.me
 repository: https://github.com/mattrltrent/trent

test/trent_test.dart

@@ -136,8 +136,10 @@ class _TestAppState extends State<TestApp> {
                   ..as<B>((state) => _counter = 3)
                   ..as<C>((state) => _counter = 4);
               },
-              listenAlertsIf: (oldAlert, newAlert) => newAlert is D || newAlert is B,
-              listenStatesIf: (oldState, newState) => newState is A || newState is B || newState is C,
+              listenAlertsIf: (oldAlert, newAlert) =>
+                  newAlert is D || newAlert is B,
+              listenStatesIf: (oldState, newState) =>
+                  newState is A || newState is B || newState is C,
               child: Center(
                 child: Column(
                   mainAxisAlignment: MainAxisAlignment.center,
@@ -155,7 +157,8 @@ class _TestAppState extends State<TestApp> {
                       child: const Text("Switch to C"),
                     ),
                     ElevatedButton(
-                      onPressed: () => get<SimpleTrent>(context).triggerDAlert(),
+                      onPressed: () =>
+                          get<SimpleTrent>(context).triggerDAlert(),
                       child: const Text("Trigger D Alert"),
                     ),
                     ElevatedButton(
@@ -200,7 +203,8 @@ void main() {
       expect(find.text("Digester State C: 99"), findsOneWidget);
     });
 
-    testWidgets('Alerter updates _counter on alert and state changes', (tester) async {
+    testWidgets('Alerter updates _counter on alert and state changes',
+        (tester) async {
       await tester.pumpWidget(
         TrentManager(
           trents: [register(SimpleTrent())],