kasy-cli 1.2.1

package/lib/scaffold/features/onboarding/lib/features/onboarding/ui/widgets/onboarding_illustration_scaffold.dart

@@ -0,0 +1,110 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_progress.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_sticky_footer.dart';
+
+/// Layout compartilhado para passos de onboarding com ilustração e ações no rodapé.
+///
+/// Evita buracos grandes de [Expanded] + [Spacer] com imagens [BoxFit.contain].
+class OnboardingIllustrationScaffold extends StatelessWidget {
+  const OnboardingIllustrationScaffold({
+    super.key,
+    required this.progress,
+    required this.title,
+    required this.description,
+    required this.footerActions,
+    this.imageAsset,
+    this.image,
+    this.imageMaxHeight = 280,
+    this.titleWidget,
+    this.descriptionWidget,
+    this.footerAnimationDelayMs = 400,
+    this.animateFooter = true,
+  });
+
+  final double progress;
+  final String title;
+  final String description;
+  final String? imageAsset;
+  final Widget? image;
+  final List<Widget> footerActions;
+  final double imageMaxHeight;
+  final Widget? titleWidget;
+  final Widget? descriptionWidget;
+  final int footerAnimationDelayMs;
+  final bool animateFooter;
+
+  @override
+  Widget build(BuildContext context) {
+    final Widget? illustration = image ??
+        (imageAsset != null && imageAsset!.isNotEmpty
+            ? Image.asset(imageAsset!, fit: BoxFit.contain)
+            : null);
+
+    return Column(
+      crossAxisAlignment: CrossAxisAlignment.stretch,
+      children: [
+        Expanded(
+          child: SafeArea(
+            bottom: false,
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.stretch,
+              children: [
+                OnboardingProgress(value: progress),
+                Expanded(
+                  child: SingleChildScrollView(
+                    padding: const EdgeInsets.fromLTRB(
+                      KasySpacing.xl,
+                      KasySpacing.lg,
+                      KasySpacing.xl,
+                      KasySpacing.md,
+                    ),
+                    child: Column(
+                      children: [
+                        titleWidget ??
+                            Text(
+                              title,
+                              textAlign: TextAlign.center,
+                              style:
+                                  context.textTheme.headlineMedium?.copyWith(
+                                color: context.colors.onBackground,
+                                fontWeight: FontWeight.w600,
+                              ),
+                            ),
+                        const SizedBox(height: KasySpacing.smd),
+                        descriptionWidget ??
+                            Text(
+                              description,
+                              textAlign: TextAlign.center,
+                              style: context.textTheme.bodyLarge?.copyWith(
+                                color: context.colors.onBackground.withValues(
+                                  alpha: 0.6,
+                                ),
+                              ),
+                            ),
+                        if (illustration != null) ...[
+                          const SizedBox(height: KasySpacing.xl),
+                          ConstrainedBox(
+                            constraints:
+                                BoxConstraints(maxHeight: imageMaxHeight),
+                            child: illustration,
+                          ),
+                        ],
+                      ],
+                    ),
+                  ),
+                ),
+              ],
+            ),
+          ),
+        ),
+        OnboardingStickyFooter(
+          animate: animateFooter,
+          animationDelayMs: footerAnimationDelayMs,
+          horizontalPadding: KasySpacing.xl,
+          children: footerActions,
+        ),
+      ],
+    );
+  }
+}

package/lib/scaffold/features/onboarding/lib/features/onboarding/ui/widgets/onboarding_progress.dart

@@ -0,0 +1,84 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+
+class OnboardingProgress extends StatefulWidget {
+  final double value;
+
+  const OnboardingProgress({super.key, required this.value});
+
+  @override
+  State<OnboardingProgress> createState() => _OnboardingProgressState();
+}
+
+class _OnboardingProgressState extends State<OnboardingProgress>
+    with SingleTickerProviderStateMixin {
+  late final AnimationController animationController;
+
+  late Animation<double> _progressAnimation;
+
+  @override
+  void initState() {
+    super.initState();
+
+    animationController = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 1500),
+    );
+    _setProgressValueAndStart();
+  }
+
+  @override
+  void didUpdateWidget(OnboardingProgress oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    if (oldWidget.value != widget.value) {
+      _setProgressValueAndStart();
+    }
+  }
+
+  @override
+  void dispose() {
+    animationController.dispose();
+    super.dispose();
+  }
+
+  void _setProgressValueAndStart() {
+    var start = 0.0;
+    if (widget.value > 0) {
+      start = widget.value - 0.1;
+    }
+    _progressAnimation = Tween<double>(
+      begin: start,
+      end: widget.value,
+    ).animate(
+      CurvedAnimation(
+        parent: animationController,
+        curve: Curves.ease,
+      ),
+    );
+    animationController.forward(from: 0);
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return AnimatedBuilder(
+      animation: _progressAnimation,
+      builder: (context, child) {
+        return Padding(
+          // Intentionally narrow (80px lateral) — visual design choice for progress bar
+          padding: const EdgeInsets.fromLTRB(80, KasySpacing.md, 80, 0),
+          child: ClipRRect(
+            borderRadius: KasyRadius.fullBorderRadius,
+            child: LinearProgressIndicator(
+              value: _progressAnimation.value,
+              minHeight: 16,
+              valueColor: AlwaysStoppedAnimation<Color>(
+                context.colors.primary,
+              ),
+              backgroundColor: context.colors.primary.withValues(alpha: 0.1),
+            ),
+          ),
+        );
+      },
+    );
+  }
+}

package/lib/scaffold/features/onboarding/lib/features/onboarding/ui/widgets/onboarding_radio_question.dart

@@ -0,0 +1,173 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_animate/flutter_animate.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/components/components.dart';
+import 'package:kasy_kit/core/animations/movefade_anim.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/responsive_layout.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_background.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_progress.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/onboarding_sticky_footer.dart';
+import 'package:kasy_kit/features/onboarding/ui/widgets/selectable_row_tile.dart';
+
+typedef OptionBuilder = Widget Function(String key, bool selected);
+
+typedef ReassuranceBuilder = Widget? Function(String key);
+
+typedef OnOptionIdSelected = void Function(String id);
+
+typedef OnValidate = void Function(String? key);
+
+/// Single choice question with radio buttons
+class OnboardingRadioQuestion extends ConsumerStatefulWidget {
+  final double? progress;
+  final String title;
+  final String description;
+  final String btnText;
+  final List<String> optionIds;
+  final OptionBuilder optionBuilder;
+  final ReassuranceBuilder? reassuranceBuilder;
+  final OnOptionIdSelected? onOptionIdSelected;
+  final OnValidate? onValidate;
+
+  const OnboardingRadioQuestion({
+    super.key,
+    required this.title,
+    required this.description,
+    required this.btnText,
+    required this.optionIds,
+    required this.optionBuilder,
+    this.progress,
+    this.onOptionIdSelected,
+    this.onValidate,
+    this.reassuranceBuilder,
+  });
+
+  @override
+  ConsumerState<OnboardingRadioQuestion> createState() =>
+      _OnboardingRadioQuestionState();
+}
+
+class _OnboardingRadioQuestionState
+    extends ConsumerState<OnboardingRadioQuestion> {
+  String? selectedChoiceId;
+
+  @override
+  Widget build(BuildContext context) {
+    final scrollBody = Column(
+      crossAxisAlignment: CrossAxisAlignment.stretch,
+      children: [
+        if (widget.progress != null)
+          OnboardingProgress(value: widget.progress!),
+        Padding(
+          padding: const EdgeInsets.fromLTRB(
+            KasySpacing.md,
+            KasySpacing.xl,
+            KasySpacing.md,
+            0,
+          ),
+          child: MoveFadeAnim(
+            delayInMs: 100,
+            child: Text(
+              widget.title,
+              textAlign: TextAlign.center,
+              style: context.textTheme.headlineLarge?.copyWith(
+                color: context.colors.onBackground,
+              ),
+            ),
+          ),
+        ),
+        Padding(
+          padding: const EdgeInsets.fromLTRB(
+            KasySpacing.lg,
+            KasySpacing.md,
+            KasySpacing.lg,
+            KasySpacing.xl,
+          ),
+          child: MoveFadeAnim(
+            delayInMs: 200,
+            child: Text(
+              widget.description,
+              textAlign: TextAlign.center,
+              style: context.textTheme.bodyLarge?.copyWith(
+                color: context.colors.onBackground.withValues(alpha: 0.6),
+              ),
+            ),
+          ),
+        ),
+        Padding(
+          padding: const EdgeInsets.symmetric(horizontal: KasySpacing.md),
+          child: OnboardingSelectableRowGroup(
+            physics: const NeverScrollableScrollPhysics(),
+            options: widget.optionIds
+                .map(
+              (e) {
+                final index = widget.optionIds.indexOf(e);
+                return Animate(
+                  effects: [
+                    FadeEffect(
+                      delay: Duration(milliseconds: 300 + index * 100),
+                      duration: const Duration(milliseconds: 550),
+                      curve: Curves.easeInOut,
+                    ),
+                  ],
+                  child: widget.optionBuilder(e, e == selectedChoiceId),
+                );
+              },
+            ).toList(),
+            onSelect: (index, selected) {
+              widget.onOptionIdSelected?.call(widget.optionIds[index]);
+              setState(() {
+                selectedChoiceId = widget.optionIds[index];
+              });
+            },
+            onSelectInfoWidget: widget.optionIds
+                .map((el) => widget.reassuranceBuilder?.call(el))
+                .toList(),
+          ),
+        ),
+        const SizedBox(height: KasySpacing.xl),
+      ],
+    );
+
+    return OnboardingBackground(
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.stretch,
+        children: [
+          Expanded(
+            child: SafeArea(
+              bottom: false,
+              child: SingleChildScrollView(
+                padding: const EdgeInsets.only(bottom: KasySpacing.md),
+                child: ResponsiveBuilder(
+                  small: scrollBody,
+                  medium: Center(
+                    child: ConstrainedBox(
+                      constraints: const BoxConstraints(maxWidth: 600),
+                      child: scrollBody,
+                    ),
+                  ),
+                ),
+              ),
+            ),
+          ),
+          DeviceSizeBuilder(
+            builder: (device) => OnboardingStickyFooter(
+              maxContentWidth:
+                  device == DeviceType.small ? null : 600,
+              children: [
+                KasyButton(
+                  label: widget.btnText,
+                  expand: true,
+                  onPressed: selectedChoiceId == null
+                      ? null
+                      : () => widget.onValidate?.call(selectedChoiceId),
+                ),
+              ],
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}

package/lib/scaffold/features/onboarding/lib/features/onboarding/ui/widgets/onboarding_reassurance.dart

@@ -0,0 +1,45 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_animate/flutter_animate.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+
+class CheckedReassurance extends StatelessWidget {
+  final String text;
+
+  const CheckedReassurance({super.key, required this.text});
+
+  @override
+  Widget build(BuildContext context) {
+    return Animate(
+      effects: const [
+        FadeEffect(
+          duration: Duration(milliseconds: 300),
+          curve: Curves.easeInOut,
+        ),
+        MoveEffect(
+          duration: Duration(milliseconds: 250),
+          curve: Curves.easeInOut,
+          begin: Offset(0, -20),
+          end: Offset.zero,
+        ),
+      ],
+      child: Container(
+        padding: const EdgeInsets.all(KasySpacing.lg),
+        decoration: BoxDecoration(
+          color: context.colors.success.withValues(alpha: 0.05),
+          borderRadius: KasyRadius.smBorderRadius,
+          border: Border.all(
+            color: context.colors.muted,
+          ),
+        ),
+        child: Text(
+          text,
+          textAlign: TextAlign.left,
+          style: context.textTheme.bodyLarge?.copyWith(
+            color: context.colors.muted,
+            fontWeight: FontWeight.w900,
+          ),
+        ),
+      ),
+    );
+  }
+}

package/lib/scaffold/features/onboarding/lib/features/onboarding/ui/widgets/onboarding_sticky_footer.dart

@@ -0,0 +1,77 @@
+import 'package:flutter/foundation.dart';
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/animations/movefade_anim.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+
+/// Rodapé fixo do onboarding: fundo até a borda inferior + animação de entrada.
+class OnboardingStickyFooter extends StatelessWidget {
+  const OnboardingStickyFooter({
+    super.key,
+    required this.children,
+    this.animate = true,
+    this.animationDelayMs = 400,
+    this.horizontalPadding = KasySpacing.lg,
+    this.maxContentWidth,
+  });
+
+  final List<Widget> children;
+  final bool animate;
+  final int animationDelayMs;
+  final double horizontalPadding;
+
+  /// Largura máxima do conteúdo (ex.: 600 em telas médias).
+  final double? maxContentWidth;
+
+  @override
+  Widget build(BuildContext context) {
+    final bottomInset = MediaQuery.viewPaddingOf(context).bottom;
+
+    Widget content = Column(
+      crossAxisAlignment: CrossAxisAlignment.stretch,
+      children: children,
+    );
+
+    if (maxContentWidth != null) {
+      content = Center(
+        child: ConstrainedBox(
+          constraints: BoxConstraints(maxWidth: maxContentWidth!),
+          child: content,
+        ),
+      );
+    }
+
+    Widget footer = Container(
+      width: double.infinity,
+      decoration: BoxDecoration(
+        color: context.colors.background,
+        boxShadow: [
+          BoxShadow(
+            color: context.colors.onBackground.withValues(alpha: 0.06),
+            blurRadius: 16,
+            offset: const Offset(0, -4),
+          ),
+        ],
+      ),
+      padding: EdgeInsets.fromLTRB(
+        horizontalPadding,
+        KasySpacing.md,
+        horizontalPadding,
+        KasySpacing.md +
+            bottomInset +
+            (defaultTargetPlatform == TargetPlatform.android
+                ? KasySpacing.sm
+                : 0),
+      ),
+      child: content,
+    );
+
+    if (animate) {
+      footer = MoveFadeAnim(
+        delayInMs: animationDelayMs,
+        child: footer,
+      );
+    }
+
+    return footer;
+  }
+}