toast

conceptadev · Nov 7, 2024 · 2a00103 · 2a00103
1 parent 54036e2
commit 2a00103
Show file tree

Hide file tree

Showing 7 changed files with 71 additions and 53 deletions.
diff --git a/packages/remix/lib/src/components/spinner/spinner_widget.dart b/packages/remix/lib/src/components/spinner/spinner_widget.dart
@@ -3,7 +3,10 @@ part of 'spinner.dart';
 class Spinner extends StatelessWidget {
   const Spinner({super.key, this.style, this.variants = const []});
 
+  /// {@macro remix.component.style}
   final SpinnerStyle? style;
+
+  /// {@macro remix.component.variants}
   final List<Variant> variants;
 
   @override

diff --git a/packages/remix/lib/src/components/switch/switch_widget.dart b/packages/remix/lib/src/components/switch/switch_widget.dart
@@ -10,10 +10,19 @@ class Switch extends StatefulWidget {
     this.variants = const [],
   });
 
+  /// Whether the switch is on or off.
   final bool value;
+
+  /// {@macro remix.component.onChanged}
   final ValueChanged<bool> onChanged;
+
+  /// {@macro remix.component.style}
   final SwitchStyle? style;
+
+  /// {@macro remix.component.disabled}
   final bool disabled;
+
+  /// {@macro remix.component.variants}
   final List<Variant> variants;
 
   @override

diff --git a/packages/remix/lib/src/components/toast/toast.dart b/packages/remix/lib/src/components/toast/toast.dart
@@ -17,8 +17,8 @@ part 'toast_widget.dart';
 @MixableSpec()
 base class ToastSpec extends Spec<ToastSpec> with _$ToastSpec, Diagnosticable {
   final BoxSpec container;
-  final FlexSpec containerFlex;
-  final FlexSpec textContentFlex;
+  final FlexSpec layout;
+  final FlexSpec textLayout;
   final TextSpec title;
   final TextSpec description;
 
@@ -29,15 +29,15 @@ base class ToastSpec extends Spec<ToastSpec> with _$ToastSpec, Diagnosticable {
 
   const ToastSpec({
     BoxSpec? container,
-    FlexSpec? containerFlex,
-    FlexSpec? textContentFlex,
+    FlexSpec? layout,
+    FlexSpec? textLayout,
     TextSpec? title,
     TextSpec? description,
     super.modifiers,
     super.animated,
   })  : container = container ?? const BoxSpec(),
-        containerFlex = containerFlex ?? const FlexSpec(),
-        textContentFlex = textContentFlex ?? const FlexSpec(),
+        layout = layout ?? const FlexSpec(),
+        textLayout = textLayout ?? const FlexSpec(),
         title = title ?? const TextSpec(),
         description = description ?? const TextSpec();
 

diff --git a/packages/remix/lib/src/components/toast/toast.g.dart b/packages/remix/lib/src/components/toast/toast.g.dart
diff --git a/packages/remix/lib/src/components/toast/toast_style.dart b/packages/remix/lib/src/components/toast/toast_style.dart
@@ -15,13 +15,13 @@ class ToastStyle extends SpecStyle<ToastSpecUtility> {
       ..margin.all(20)
       ..constraints.minWidth(300);
 
-    final containerFlexStyle = $.containerFlex.chain
+    final layoutFlexStyle = $.layout.chain
       ..direction.horizontal()
       ..mainAxisAlignment.spaceBetween()
       ..mainAxisSize.min()
       ..gap(16);
 
-    final textContentFlexStyle = $.textContentFlex.chain
+    final textLayoutFlexStyle = $.textLayout.chain
       ..direction.vertical()
       ..crossAxisAlignment.start()
       ..gap(4)
@@ -37,8 +37,8 @@ class ToastStyle extends SpecStyle<ToastSpecUtility> {
 
     return Style.create([
       containerStyle,
-      containerFlexStyle,
-      textContentFlexStyle,
+      layoutFlexStyle,
+      textLayoutFlexStyle,
       titleStyle,
       descriptionStyle,
     ]);

diff --git a/packages/remix/lib/src/components/toast/toast_theme.dart b/packages/remix/lib/src/components/toast/toast_theme.dart
@@ -14,9 +14,9 @@ class FortalezaToastStyle extends ToastStyle {
       ..padding.all.$space(4)
       ..margin.all.$space(4);
 
-    final containerFlexStyle = $.containerFlex.gap.$space(5);
+    final layoutStyle = $.layout.gap.$space(5);
 
-    final textContentFlexStyle = $.textContentFlex.gap.$space(1);
+    final textLayoutStyle = $.textLayout.gap.$space(1);
 
     final titleStyle = $.title.chain
       ..style.$text(2)
@@ -29,8 +29,8 @@ class FortalezaToastStyle extends ToastStyle {
     return Style.create([
       super.makeStyle(spec).call(),
       containerStyle,
-      containerFlexStyle,
-      textContentFlexStyle,
+      layoutStyle,
+      textLayoutStyle,
       titleStyle,
       descriptionStyle,
     ]);

diff --git a/packages/remix/lib/src/components/toast/toast_widget.dart b/packages/remix/lib/src/components/toast/toast_widget.dart
@@ -11,12 +11,22 @@ class Toast extends StatelessWidget {
     this.variants = const [],
   });
 
+  /// The title text displayed in the toast.
   final String title;
+
+  /// The description text displayed below the title.
   final String? description;
+
+  /// Optional widget displayed on the right side of the toast.
   final Widget? trailing;
+
+  /// Optional widget displayed on the left side of the toast.
   final Widget? leading;
 
+  /// {@macro remix.component.style}
   final ToastStyle? style;
+
+  /// {@macro remix.component.variants}
   final List<Variant> variants;
 
   @override
@@ -30,11 +40,11 @@ class Toast extends StatelessWidget {
         final spec = ToastSpec.of(context);
 
         return spec.container(
-          child: spec.containerFlex(
+          child: spec.layout(
             direction: Axis.horizontal,
             children: [
               if (leading != null) leading!,
-              spec.textContentFlex(
+              spec.textLayout(
                 direction: Axis.vertical,
                 children: [
                   spec.title(title),