Added FButton.icon for a single icon button

docs/pages/docs/button.mdx

@@ -103,7 +103,7 @@ FButton.raw(
   </Tabs.Tab>
 </Tabs>
 
-### With Icon
+### With Text and Icon
 <Tabs items={['Preview', 'Code']}>
   <Tabs.Tab>
     <Widget name='button' variant='icon' query={{}}/>
@@ -117,4 +117,20 @@ FButton.raw(
     ),
     ```
   </Tabs.Tab>
-</Tabs>
+</Tabs>
+
+### With Only Icon
+<Tabs items={['Preview', 'Code']}>
+  <Tabs.Tab>
+    <Widget name='button' variant='only-icon' query={{}}/>
+  </Tabs.Tab>
+  <Tabs.Tab>
+    ```dart {2}
+    FButton.icon(
+      icon: FButtonIcon(icon: FAssets.icons.chevronRight),
+      onPress: () {},
+    ),
+    ```
+  </Tabs.Tab>
+</Tabs>
+

forui/lib/src/widgets/button/button.dart

@@ -99,6 +99,18 @@ class FButton extends StatelessWidget {
           label: label,
         );
 
+  /// Creates a [FButton] that contains only an icon.
+  FButton.icon({
+    required this.onPress,
+    required Widget child,
+    this.style = Variant.outline,
+    this.onLongPress,
+    this.autofocus = false,
+    this.focusNode,
+    this.onFocusChange,
+    super.key,
+  }) : child = _FButtonIconContent(child: child);
+
   /// Creates a [FButton] with custom content.
   const FButton.raw({
     required this.onPress,
@@ -262,6 +274,82 @@ class FButtonCustomStyle extends FButtonStyle with Diagnosticable {
   int get hashCode => enabledBoxDecoration.hashCode ^ disabledBoxDecoration.hashCode ^ content.hashCode ^ icon.hashCode;
 }
 
+/// [FButton] style for icon-button.
+class FButtonIconStyle extends FButtonStyle with Diagnosticable {
+  /// The box decoration for an enabled button.
+  final BoxDecoration enabledBoxDecoration;
+
+  /// The box decoration for a disabled button.
+  final BoxDecoration disabledBoxDecoration;
+
+  /// The content's style.
+  final FButtonContentStyle content;
+
+  /// The icon's style.
+  final FButtonIconStyle icon;
+
+  /// Creates a [FButtonIconStyle].
+  FButtonIconStyle({
+    required this.enabledBoxDecoration,
+    required this.disabledBoxDecoration,
+    required this.content,
+    required this.icon,
+  });
+
+  /// Returns a copy of this [FButtonIconStyle] with the given properties replaced.
+  ///
+  /// ```dart
+  /// final style = FButtonIconStyle(
+  ///   enabledBoxDecoration: ...,
+  ///   disabledBoxDecoration: ...,
+  ///   // other properties omitted for brevity
+  /// );
+  ///
+  /// final copy = style.copyWith(
+  ///   disabledBoxDecoration: ...,
+  /// );
+  ///
+  /// print(copy.background); // Colors.blue
+  /// print(copy.border); // Colors.black
+  /// ```
+  @useResult
+  FButtonIconStyle copyWith({
+    BoxDecoration? enabledBoxDecoration,
+    BoxDecoration? disabledBoxDecoration,
+    FButtonContentStyle? content,
+    FButtonIconStyle? icon,
+  }) =>
+      FButtonIconStyle(
+        enabledBoxDecoration: enabledBoxDecoration ?? this.enabledBoxDecoration,
+        disabledBoxDecoration: disabledBoxDecoration ?? this.disabledBoxDecoration,
+        content: content ?? this.content,
+        icon: icon ?? this.icon,
+      );
+
+  @override
+  void debugFillProperties(DiagnosticPropertiesBuilder properties) {
+    super.debugFillProperties(properties);
+    properties
+      ..add(DiagnosticsProperty('enabledBoxDecoration', enabledBoxDecoration))
+      ..add(DiagnosticsProperty('disabledBoxDecoration', disabledBoxDecoration))
+      ..add(DiagnosticsProperty('content', content))
+      ..add(DiagnosticsProperty('icon', icon));
+  }
+
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      other is FButtonCustomStyle &&
+          runtimeType == other.runtimeType &&
+          enabledBoxDecoration == other.enabledBoxDecoration &&
+          disabledBoxDecoration == other.disabledBoxDecoration &&
+          content == other.content &&
+          icon == other.icon;
+
+  @override
+  int get hashCode => enabledBoxDecoration.hashCode ^ disabledBoxDecoration.hashCode ^ content.hashCode ^ icon.hashCode;
+}
+
 typedef _Data = ({FButtonCustomStyle style, bool enabled});
 
 class _InheritedData extends InheritedWidget {

forui/lib/src/widgets/button/button_content.dart

@@ -37,6 +37,59 @@ final class _FButtonContent extends StatelessWidget {
   }
 }
 
+final class _FButtonIconContent extends StatelessWidget {
+  final Widget child;
+
+  const _FButtonIconContent({required this.child});
+
+  @override
+  Widget build(BuildContext context) {
+    final FButtonIconContentStyle contentStyle = FButtonIconContentStyle();
+
+    return Padding(
+      padding: contentStyle.padding,
+      child: child,
+    );
+  }
+}
+
+/// [FButton] icon's style.
+class FButtonIconContentStyle with Diagnosticable {
+  /// The padding.
+  final EdgeInsets padding;
+
+  /// Creates a [FButtonIconContentStyle].
+  FButtonIconContentStyle({
+    this.padding = const EdgeInsets.symmetric(
+      horizontal: 16,
+      vertical: 12.5,
+    ),
+  });
+
+  /// Returns a copy of this [FButtonIconContentStyle] with the given properties replaced.
+  @useResult
+  FButtonIconContentStyle copyWith({
+    EdgeInsets? padding,
+  }) =>
+      FButtonIconContentStyle(
+        padding: padding ?? this.padding,
+      );
+
+  @override
+  bool operator ==(Object other) =>
+      identical(this, other) ||
+      other is FButtonIconContentStyle && runtimeType == other.runtimeType && padding == other.padding;
+
+  @override
+  int get hashCode => padding.hashCode;
+
+  @override
+  void debugFillProperties(DiagnosticPropertiesBuilder properties) {
+    super.debugFillProperties(properties);
+    properties.add(DiagnosticsProperty<EdgeInsets>('padding', padding));
+  }
+}
+
 /// [FButton] content's style.
 class FButtonContentStyle with Diagnosticable {
   /// The [TextStyle] when this button is enabled.

forui/test/src/widgets/button/button_golden_test.dart

@@ -136,7 +136,59 @@ void main() {
             matchesGoldenFile('button/$name-$variant-disabled-raw-button.png'),
           );
         });
+
+        testWidgets('$name with enabled icon', (tester) async {
+          await tester.pumpWidget(
+            TestScaffold(
+              data: theme,
+              child: Padding(
+                padding: const EdgeInsets.symmetric(horizontal: 20),
+                child: FButton.icon(
+                  onPress: () {},
+                  style: variant,
+                  child: FButtonIcon(
+                    icon: FAssets.icons.chevronRight,
+                  ),
+                ),
+              ),
+            ),
+          );
+
+          await expectLater(
+            find.byType(TestScaffold),
+            matchesGoldenFile(
+              'button/$name-$variant-icon-enabled-button.png',
+            ),
+          );
+        });
+
+        testWidgets('$name with disabled icon', (tester) async {
+          await tester.pumpWidget(
+            TestScaffold(
+              data: theme,
+              child: Padding(
+                padding: const EdgeInsets.symmetric(horizontal: 20),
+                child: FButton.icon(
+                  onPress: null,
+                  style: variant,
+                  child: FButtonIcon(
+                    icon: FAssets.icons.chevronRight,
+                  ),
+                ),
+              ),
+            ),
+          );
+
+          await expectLater(
+            find.byType(TestScaffold),
+            matchesGoldenFile(
+              'button/$name-$variant-icon-disabled-button.png',
+            ),
+          );
+        });
       }
     }
   });
 }
+
+//flutter test --update-goldens /Users/somyemahajan/Projects/forui/forui/test/src/widgets/button/button_golden_test.dart

samples/lib/main.dart

@@ -71,6 +71,10 @@ class _AppRouter extends RootStackRouter {
           path: '/button/icon',
           page: ButtonIconRoute.page,
         ),
+        AutoRoute(
+          path: '/button/only-icon',
+          page: ButtonOnlyIconRoute.page,
+        ),
         AutoRoute(
           path: '/calendar/default',
           page: CalendarRoute.page,

samples/lib/widgets/button.dart

@@ -52,3 +52,18 @@ class ButtonIconPage extends SampleScaffold {
         ),
       );
 }
+
+@RoutePage()
+class ButtonOnlyIconPage extends SampleScaffold {
+  ButtonOnlyIconPage({
+    @queryParam super.theme,
+  });
+
+  @override
+  Widget child(BuildContext context) => IntrinsicWidth(
+        child: FButton.icon(
+          child: FButtonIcon(icon: FAssets.icons.chevronRight),
+          onPress: () {},
+        ),
+      );
+}