rename builder apis

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.7.0
+
+- **Incompatible**: API about `ReContext` changed.
+- Use `builder` instead of `ReContext`, which is conciser.
+- Optimize tests and tidy code structure.
+
 ## 0.6.0
 
 - Inherit data from widget tree ancestors.

lib/src/context.dart

@@ -1,16 +1,28 @@
 import 'package:flutter/widgets.dart';
 
 extension WrapContext on Widget {
+  /// Same as wrapping current widget with a [Builder], which keeps chain style.
   Widget wrap(Widget Function(BuildContext context, Widget child) builder) =>
-      ReContext((context) => builder(context, this));
+      Builder(builder: (context) => builder(context, this));
 }
 
-/// Refresh context, same as [Builder] but with conciser API.
-class ReContext extends StatelessWidget {
-  const ReContext(this.builder, {super.key});
+/// An encapsulation of [Builder], which makes it conciser.
+Widget builder(Widget Function(BuildContext context) builder) =>
+    Builder(builder: builder);
 
-  final Widget Function(BuildContext context) builder;
+extension WrapMedia on Widget {
+  Widget wrapMedia(MediaQueryData data) => MediaQuery(data: data, child: this);
 
-  @override
-  Widget build(BuildContext context) => builder(context);
+  /// Ensure the widget is wrapped by a [MediaQuery] ancestor.
+  ///
+  /// Provide environment for [MediaQuery.of] that many widgets need,
+  /// including the [Text] widget. Without such ancestor,
+  /// once displaying a [Text],
+  /// it will throw exceptions.
+  Widget ensureMedia(BuildContext context) {
+    final media = MediaQuery.maybeOf(context);
+    return media == null
+        ? wrapMedia(MediaQueryData.fromView(View.of(context)))
+        : this;
+  }
 }

lib/src/handler.dart

@@ -0,0 +1,58 @@
+import 'package:flutter/widgets.dart';
+
+import 'inherit.dart';
+
+class InheritHandler<T> extends StatefulWidget {
+  const InheritHandler({
+    super.key,
+    required this.data,
+    required this.child,
+  });
+
+  final T data;
+  final Widget child;
+
+  @override
+  State<InheritHandler<T>> createState() => _InheritHandlerState<T>();
+}
+
+class _InheritHandlerState<T> extends State<InheritHandler<T>> {
+  late var _data = widget.data;
+  T get data => _data;
+  set data(T value) {
+    if (_data != value) setState(() => _data = value);
+  }
+
+  @override
+  void didUpdateWidget(covariant InheritHandler<T> oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    data = widget.data;
+  }
+
+  @override
+  Widget build(BuildContext context) => widget.child
+      .wrapInherit(_data)
+      .wrapInheritUnchanged(InheritHandlerCaller<T>(
+        updater: (data) => this.data = data,
+      ));
+}
+
+class InheritHandlerCaller<T> {
+  const InheritHandlerCaller({required this.updater});
+
+  final void Function(T data) updater;
+}
+
+extension WrapHandler on Widget {
+  Widget wrapHandler<T>(T data) => InheritHandler<T>(data: data, child: this);
+}
+
+extension UpdateHandlerData on BuildContext {
+  void maybeUpdate<T>(T data) => find<InheritHandlerCaller<T>>()?.updater(data);
+
+  void updateAndTrust<T>(T data) =>
+      findAndTrust<InheritHandlerCaller<T>>().updater(data);
+
+  void updateAndCheck<T>(T data) =>
+      findAndCheck<InheritHandlerCaller<T>>().updater(data);
+}

lib/src/inherit.dart

@@ -58,4 +58,10 @@ extension FindInherit on BuildContext {
     assert(data != null, 'cannot find $T in context');
     return data!;
   }
+
+  T findAndCheck<T>() {
+    final data = find<T>();
+    if (data == null) throw Exception('cannot find $T in context');
+    return data;
+  }
 }

lib/src/text.dart

@@ -1,6 +1,6 @@
 import 'package:flutter/widgets.dart';
 
-import 'media.dart';
+import 'context.dart';
 
 extension WrapDirectionality on Widget {
   Widget wrapDirectionality(TextDirection direction) => Directionality(

lib/wrap.dart

@@ -2,8 +2,8 @@ export 'src/align.dart';
 export 'src/color.dart';
 export 'src/context.dart';
 export 'src/decorate.dart';
+export 'src/handler.dart';
 export 'src/inherit.dart';
 export 'src/list.dart';
-export 'src/media.dart';
 export 'src/size.dart';
 export 'src/text.dart';

pubspec.yaml

@@ -1,6 +1,6 @@
 name: wrap
 description: Chain style programming syntax sugar utilities for flutter widgets.
-version: 0.6.0
+version: 0.7.0
 repository: https://github.com/aprosail/wrap
 environment: {sdk: ">=3.3.4 <4.0.0", flutter: ">=3.19.6"}
 topics:

test/context_test.dart

@@ -5,7 +5,7 @@ import 'package:wrap/wrap.dart';
 void main() {
   testWidgets('re context root', (t) async {
     await t.pumpWidget(
-      ReContext((context) => const ColorProbe()
+      builder((context) => const ColorProbe()
           .wrapForeground(context, foreground)
           .ensureTextEnvironment(context)),
     );

test/inherit_test.dart

@@ -6,7 +6,7 @@ void main() {
   testWidgets('inherit and find', (t) async {
     const message = 'it works';
     await t.pumpWidget(
-      ReContext(
+      builder(
         (context) => Text(context.findAndTrust<String>())
             .wrapCenter
             .ensureTextEnvironment(context),

test/text_test.dart

@@ -5,7 +5,7 @@ import 'package:wrap/wrap.dart';
 void main() {
   testWidgets('ensure text environment', (t) async {
     const message = 'it works';
-    await t.pumpWidget(ReContext(
+    await t.pumpWidget(builder(
       (context) => const Text(message).ensureTextEnvironment(context),
     ));
     expect(find.text(message), findsOneWidget);
@@ -16,7 +16,7 @@ void main() {
     const fontSize = 23.4;
     const fontFamily = 'iosevka';
     await t.pumpWidget(
-      ReContext((context) {
+      builder((context) {
         final font = DefaultTextStyle.of(context).style;
         return <Widget>[
           'font color: ${font.color}'.textWidget,