doc: Improve documentation of code.

Author: CarLeonDev

packages/flutter_reactter/example/lib/animation/animation_controller.dart

@@ -65,7 +65,7 @@ class AnimationController {
     ),
   );
 
-  late final isPlaying = Reactter.lazy(() {
+  late final isPlaying = Reactter.lazyState(() {
     return UseCompute(
       () => [
         sizeAnimation.control.value,

packages/flutter_reactter/example/lib/animation/use_animation.dart

@@ -62,10 +62,12 @@ class UseAnimation<T> extends ReactterHook implements TickerProvider {
   @protected
   final $ = ReactterHook.$register;
 
-  late final tween = Reactter.lazy(() => UseState(options.tween), this);
-  late final control = Reactter.lazy(() => UseState(options.control), this);
-  late final duration = Reactter.lazy(() => UseState(options.duration), this);
-  late final curve = Reactter.lazy(() => UseState(options.curve), this);
+  late final tween = Reactter.lazyState(() => UseState(options.tween), this);
+  late final control =
+      Reactter.lazyState(() => UseState(options.control), this);
+  late final duration =
+      Reactter.lazyState(() => UseState(options.duration), this);
+  late final curve = Reactter.lazyState(() => UseState(options.curve), this);
 
   bool _waitForDelay = true;
   Set<Ticker>? _tickers;

packages/flutter_reactter/example/lib/api/api_page.dart

@@ -1,4 +1,4 @@
-import 'package:flutter/material.dart';
+import 'package:flutter/material.dart' hide SearchBar;
 import 'package:flutter_reactter/flutter_reactter.dart';
 
 import 'controllers/api_controller.dart';
@@ -35,7 +35,7 @@ class ApiPage extends StatelessWidget {
             padding: const EdgeInsets.all(8),
             child: Center(
               child: ReactterConsumer<ApiController>(
-                listenStates: (inst) => [inst.entity],
+                listenStates: (inst) => [inst.entityState],
                 builder: (_, __, ___) {
                   return FittedBox(
                     child: SizedBox(
@@ -45,7 +45,7 @@ class ApiPage extends StatelessWidget {
                         child: Container(
                           alignment: Alignment.center,
                           padding: const EdgeInsets.all(16),
-                          child: apiController.entity.when<Widget>(
+                          child: apiController.entityState.when<Widget>(
                             standby: (_) => const Text(
                               'Search a user or repository(like "flutter/flutter")',
                             ),

packages/flutter_reactter/example/lib/api/controllers/api_controller.dart

@@ -6,13 +6,19 @@ class ApiController {
   String _query = '';
   String get query => _query;
 
-  final entity = UseAsyncState.withArgs(
+  final entityState = UseAsyncState.withArg(
     null,
-    Reactter.memo(ApiService().getEntity.ary),
+    Memo.inline<Future<Object?>, Args1<String>>(
+      ApiService().getEntity.ary,
+      const MemoInterceptors([
+        AsyncMemoSafe(),
+        TemporaryCacheMemo(Duration(seconds: 30)),
+      ]),
+    ),
   );
 
   void search(String query) {
     _query = query;
-    entity.resolve(Args1(query));
+    entityState.resolve(Args1(query));
   }
 }

packages/flutter_reactter/example/lib/main.dart

@@ -62,7 +62,7 @@ final items = [
     "Search user or repository and show info about it.",
     [
       "Generic arguments",
-      "Reactter.memo",
+      "Memo",
       "ReactterConsumer",
       "ReactterProvider",
       "UseAsyncState",

packages/flutter_reactter/example/lib/todo/controllers/todo_controller.dart

@@ -24,15 +24,15 @@ class TodoController {
     ),
   );
 
-  late final todoListFiltered = Reactter.lazy(
+  late final todoListFiltered = Reactter.lazyState(
     () => UseCompute(
       () => getTodosBy(state.value.filterBy),
       [state],
     ),
     this,
   );
 
-  late final todoActiveCount = Reactter.lazy(
+  late final todoActiveCount = Reactter.lazyState(
     () => UseCompute(
       () => state.value.todoList.fold<int>(
         0,

packages/flutter_reactter/lib/src/extensions/build_context_extension.dart

@@ -2,13 +2,15 @@ part of '../extensions.dart';
 
 /// Exposes methods to helps to get and listen the Object instance.
 extension ReactterBuildContextExtension on BuildContext {
-  /// Gets the [T] instance from the closest ancestor of [ReactterProvider]
-  /// and watches instance changes or [ReactterState] defined
-  /// in first paramater([listenStates]) to re-render the Widget tree.
+  /// Gets the instance of [T] type from the closest ancestor of [ReactterProvider]
+  /// and listens changes to the instance or the states([ReactterState]) defined
+  /// in first parameter([listenStates]) to trigger re-render of the Widget tree.
   ///
   /// ```dart
   /// final appController = context.watch<AppController>();
-  /// final appControllerWatchState = context.watch<AppController>((inst) => [inst.stateA]);
+  /// final appControllerWatchStates = context.watch<AppController>(
+  ///   (inst) => [inst.stateA],
+  /// );
   /// final appControllerNullable = context.wath<AppController?>();
   /// ```
   ///
@@ -27,13 +29,17 @@ extension ReactterBuildContextExtension on BuildContext {
     return ReactterProvider.contextOf<T>(this, listenStates: listenStates);
   }
 
-  /// Gets the [T] instance by [id] from the closest ancestor of [ReactterProvider]
-  /// and watches instance changes or [ReactterState] defined
-  /// in second paramater([listenStates]) to re-render the Widget tree.
+  /// Gets the instance of [T] type by [id] from the closest ancestor
+  /// of [ReactterProvider] and watchs changes to the instance or
+  /// the states([ReactterState]) defined in first parameter([listenStates])
+  /// to trigger re-render of the Widget tree.
   ///
   /// ```dart
   /// final appController = context.watchId<AppController>("UniqueId");
-  /// final appControllerWatchHook = context.watchId<AppController>("UniqueId", (inst) => [inst.stateA]);
+  /// final appControllerWatchHook = context.watchId<AppController>(
+  ///   "UniqueId",
+  ///   (inst) => [inst.stateA],
+  /// );
   /// final appControllerNullable = context.wathId<AppController?>("UniqueId");
   /// ```
   ///
@@ -59,7 +65,7 @@ extension ReactterBuildContextExtension on BuildContext {
     );
   }
 
-  /// Gets the [T] instance with/without [id]
+  /// Gets the instance of [T] type with/without [id]
   /// from the closest ancestor of [ReactterProvider].
   ///
   /// ```dart
@@ -87,7 +93,7 @@ extension ReactterBuildContextExtension on BuildContext {
 /// The error that will be thrown if [ReactterProvider.contextOf] fails
 /// to find the instance from ancestor of the [BuildContext] used.
 class ReactterInstanceNotFoundException implements Exception {
-  ReactterInstanceNotFoundException(
+  const ReactterInstanceNotFoundException(
     this.valueType,
     this.widgetType,
   );

packages/flutter_reactter/lib/src/extensions/reactter_state_list_extension.dart

@@ -1,8 +1,8 @@
 part of '../extensions.dart';
 
 extension ReactterStateListExtension<E extends ReactterState> on List<E> {
-  /// Takes multiple conditions as arguments and returns a list of
-  /// [UseCompute] objects based on those conditions.
+  /// Takes multiple conditions and returns a list of [UseCompute] based
+  /// on theses conditions.
   ///
   /// Generally, it's used to listen for conditional states using [context.watch]:
   ///
@@ -16,7 +16,10 @@ extension ReactterStateListExtension<E extends ReactterState> on List<E> {
   ///     () => inst.stateB.value == 'Y', // condition3
   ///   ),
   /// );
+  ///
   /// ```
+  /// Use [UseCompute] instead to improve performance, creating it out of
+  /// context.
   List<UseCompute> when(
     dynamic Function() condition, [
     dynamic Function()? condition2,

packages/flutter_reactter/lib/src/widgets/reactter_component.dart

@@ -1,7 +1,8 @@
 part of '../widgets.dart';
 
+/// {@template reactter_component}
 /// A abstract [StatelessWidget] class that provides [ReactterProvider] features,
-/// whose [T] instance defined is exposing trough [render] method.
+/// whose instance of [T] type defined is exposing trough [render] method.
 ///
 /// ```dart
 /// class App extends ReactterComponent<AppController> {
@@ -53,8 +54,8 @@ part of '../widgets.dart';
 /// }
 /// ```
 ///
-/// Use [listenAll] getter as `true` to listen all the [T] instance changes
-/// to rebuild the Widget tree defined in [render] method.
+/// Use [listenAll] getter as `true` to listen all instance changes to rebuild
+/// the Widget tree defined in [render] method.
 ///
 /// ```dart
 /// class App extends ReactterComponent<AppController> {
@@ -69,8 +70,9 @@ part of '../widgets.dart';
 ///
 /// See also:
 ///
-/// * [ReactterProvider], a [StatelessWidget] that provides a [T] instance
+/// * [ReactterProvider], a [StatelessWidget] that provides an instance of [T] type
 /// to widget tree that can be access through the [BuildContext].
+/// {@endtemplate}
 abstract class ReactterComponent<T extends Object> extends StatelessWidget {
   const ReactterComponent({Key? key}) : super(key: key);
 

packages/flutter_reactter/lib/src/widgets/reactter_consumer.dart

@@ -1,18 +1,19 @@
 part of '../widgets.dart';
 
-/// A [StatelessWidget] that allows to obtains a [T] instance
-/// from the closest ancestor of [ReactterProvider]
-/// and passes the instance to [builder].
+/// {@template reactter_consumer}
+/// A [StatelessWidget] that allows to obtains an instance of [T] type
+/// from the closest ancestor of [ReactterProvider] and passes the instance
+/// to [builder].
 ///
-/// Also, it listens for changes from the instance or a [ReactterState] list
-/// to rebuild the Widget tree.
+/// Also, listens for instance changes or a [ReactterState] list
+/// to rebuild the widget tree.
 ///
 /// [ReactterConsumer] has same functionality as [ReactterProvider.contextOf].
 ///
 /// Use [id] property to identify the [T] instance.
 ///
-/// Use [listenAll] property for listen to changes from the instance
-/// or states defined in [listenStates] property:
+/// Use [listenAll] property to listen changes to the instance
+/// or the states defined in [listenStates] property:
 ///
 ///```dart
 /// ReactterConsumer<AppController>(
@@ -29,7 +30,8 @@ part of '../widgets.dart';
 /// ```
 ///
 /// Use [child] property to pass a [Widget] which to be built once only.
-/// It will be sent through the [builder] callback, so you can incorporate it into your build:
+/// It will be sent through the [builder] callback, so you can incorporate it
+/// into your build:
 ///
 ///```dart
 /// ReactterConsumer<AppController>(
@@ -49,9 +51,11 @@ part of '../widgets.dart';
 /// See also:
 ///
 /// * [ReactterState], a state in reactter.
-/// * [ReactterProvider], a widget that provides a [T] instance through Widget tree.
-///
+/// * [ReactterProvider], a widget that provides a [T] instance through Widget
+/// tree.
+///{@endtemplate}
 class ReactterConsumer<T extends Object?> extends StatelessWidget {
+  /// {@macro reactter_consumer}
   const ReactterConsumer({
     Key? key,
     this.id,