kasy-cli 1.17.0 → 1.18.0

package/templates/firebase/ios/HomeWidgetExtension/MyWidget.swift

@@ -1,6 +1,29 @@
 import WidgetKit
 import SwiftUI
 
+// MARK: - Brand
+//
+// Single source of truth for widget colors on iOS. To rebrand the widget,
+// edit ONLY this enum.
+//
+// IMPORTANT: keep these values in sync with the Android counterparts in
+// Firebase/android/app/src/main/res/values/colors.xml.
+enum WidgetBrand {
+    // Background gradient.
+    static let gradientStart = Color(red: 0.08, green: 0.03, blue: 0.16)   // #FF140829
+    static let gradientEnd   = Color(red: 0.20, green: 0.09, blue: 0.42)   // #FF33176B
+
+    // PRO plan pill (gold) + its soft background.
+    static let proGold       = Color(red: 1.00, green: 0.84, blue: 0.00)   // #FFFFD700
+    static let proPillBg     = Color(red: 1.00, green: 0.84, blue: 0.00).opacity(0.18)
+
+    // Free plan pill — low-emphasis translucent white.
+    static let freePillBg    = Color.white.opacity(0.08)
+
+    // "+" circular button on medium/large widgets.
+    static let addButtonBg   = Color.white.opacity(0.18)
+}
+
 struct MyWidgetProvider: TimelineProvider {
     func placeholder(in context: Context) -> MyWidgetEntry {
         MyWidgetEntry.defaults()
@@ -24,6 +47,7 @@ struct MyWidgetEntry: TimelineEntry {
     let planText: String
     let isPro: Bool
     let quote: String
+    let quoteAuthor: String
 
     /// Reads the latest data from the shared app group. If a string was never
     /// written (first install before the Flutter app pushed data), falls back
@@ -36,6 +60,7 @@ struct MyWidgetEntry: TimelineEntry {
         let storedPlan = prefs?.string(forKey: "planText") ?? ""
         let storedIsPro = prefs?.string(forKey: "isPro") == "true"
         let storedQuote = prefs?.string(forKey: "quote") ?? ""
+        let storedQuoteAuthor = prefs?.string(forKey: "quoteAuthor") ?? ""
 
         let defaults = MyWidgetEntry.defaults()
         return MyWidgetEntry(
@@ -44,34 +69,33 @@ struct MyWidgetEntry: TimelineEntry {
             title: storedTitle.isEmpty ? defaults.title : storedTitle,
             planText: storedPlan,
             isPro: storedIsPro,
-            quote: storedQuote
+            quote: storedQuote,
+            quoteAuthor: storedQuoteAuthor
         )
     }
 
-    /// Time-aware fallback used when the Flutter side has not yet written
-    /// data. Picks the language from the device locale so the first render
-    /// is at least in the user's language; once the app runs, the real
-    /// values (in the app locale) overwrite this.
+    /// Fallback used ONLY in the brief window between the widget being placed
+    /// and the Flutter app pushing real values. Kept dead simple — the
+    /// time-aware greeting in three languages lives on the Dart side
+    /// (home_widget_mywidget_service.dart::_greeting). Duplicating that logic
+    /// here was a maintenance trap when adding new locales.
     static func defaults() -> MyWidgetEntry {
-        let hour = Calendar.current.component(.hour, from: Date())
         let lang = Locale.current.language.languageCode?.identifier ?? "en"
-        let (morning, afternoon, evening, hello): (String, String, String, String)
+        let greeting: String
+        let hello: String
         switch lang {
-        case "pt": (morning, afternoon, evening, hello) = ("Bom dia", "Boa tarde", "Boa noite", "Olá!")
-        case "es": (morning, afternoon, evening, hello) = ("Buenos días", "Buenas tardes", "Buenas noches", "¡Hola!")
-        default:   (morning, afternoon, evening, hello) = ("Good morning", "Good afternoon", "Good evening", "Hi there!")
+        case "pt": (greeting, hello) = ("Olá", "Bem-vindo!")
+        case "es": (greeting, hello) = ("Hola", "¡Bienvenido!")
+        default:   (greeting, hello) = ("Hello", "Welcome!")
         }
-        let greeting: String
-        if hour < 12 { greeting = morning }
-        else if hour < 18 { greeting = afternoon }
-        else { greeting = evening }
         return MyWidgetEntry(
             date: Date(),
             greeting: greeting,
             title: hello,
             planText: "",
             isPro: false,
-            quote: ""
+            quote: "",
+            quoteAuthor: ""
         )
     }
 }
@@ -107,19 +131,41 @@ struct MyWidgetWidgetView: View {
                 .frame(maxWidth: .infinity, alignment: .leading)
                 .padding(.trailing, 8)
 
-            // Motivational quote only on the large widget — small/medium
-            // don't have the vertical room. Thin, low-emphasis typography
-            // so the title stays the hero element.
-            if family == .systemLarge && !entry.quote.isEmpty {
+            // Quote line counts per iOS widget family (fixed sizes, so we
+            // can hand-tune instead of measuring):
+            //   small  → 1 line   (just the first sentence, no attribution)
+            //   medium → 2 lines  (horizontal, short — fits two short lines)
+            //   large  → 4 lines + bold attribution (the whole quote)
+            if !entry.quote.isEmpty {
+                let lineLimit: Int = {
+                    switch family {
+                    case .systemSmall:  return 1
+                    case .systemMedium: return 2
+                    default:            return 4
+                    }
+                }()
+
                 Spacer().frame(height: 12)
                 Text(entry.quote)
                     .font(.system(size: 15, weight: .light, design: .rounded))
                     .italic()
                     .foregroundStyle(.white.opacity(0.7))
-                    .lineLimit(4)
+                    .lineLimit(lineLimit)
                     .lineSpacing(2)
                     .frame(maxWidth: .infinity, alignment: .leading)
                     .padding(.trailing, 8)
+
+                if family == .systemLarge && !entry.quoteAuthor.isEmpty {
+                    // Attribution on its own line, right-aligned and bold so
+                    // it reads as the source of the quote rather than part of
+                    // the quote itself.
+                    Text(entry.quoteAuthor)
+                        .font(.system(size: 13, weight: .bold, design: .rounded))
+                        .foregroundStyle(.white.opacity(0.7))
+                        .frame(maxWidth: .infinity, alignment: .trailing)
+                        .padding(.trailing, 8)
+                        .padding(.top, 4)
+                }
             }
 
             Spacer()
@@ -133,10 +179,10 @@ struct MyWidgetWidgetView: View {
                     if entry.isPro {
                         Label(entry.planText, systemImage: "star.fill")
                             .font(.system(size: 11, weight: .bold, design: .rounded))
-                            .foregroundStyle(Color(red: 1.0, green: 0.84, blue: 0.0))
+                            .foregroundStyle(WidgetBrand.proGold)
                             .padding(.horizontal, 10)
                             .padding(.vertical, 5)
-                            .background(Color(red: 1.0, green: 0.84, blue: 0.0).opacity(0.18))
+                            .background(WidgetBrand.proPillBg)
                             .clipShape(Capsule())
                     } else {
                         Text(entry.planText)
@@ -144,7 +190,7 @@ struct MyWidgetWidgetView: View {
                             .foregroundStyle(.white.opacity(0.45))
                             .padding(.horizontal, 10)
                             .padding(.vertical, 5)
-                            .background(Color.white.opacity(0.08))
+                            .background(WidgetBrand.freePillBg)
                             .clipShape(Capsule())
                     }
                 }
@@ -153,7 +199,7 @@ struct MyWidgetWidgetView: View {
                     Spacer(minLength: 12)
                     ZStack {
                         Circle()
-                            .fill(Color.white.opacity(0.18))
+                            .fill(WidgetBrand.addButtonBg)
                             .frame(width: 34, height: 34)
                         Image(systemName: "plus")
                             .font(.system(size: 16, weight: .bold))
@@ -176,8 +222,8 @@ struct MyWidgetWidget: Widget {
                 .containerBackground(for: .widget) {
                     LinearGradient(
                         gradient: Gradient(colors: [
-                            Color(red: 0.08, green: 0.03, blue: 0.16),
-                            Color(red: 0.20, green: 0.09, blue: 0.42),
+                            WidgetBrand.gradientStart,
+                            WidgetBrand.gradientEnd,
                         ]),
                         startPoint: .topLeading,
                         endPoint: .bottomTrailing
@@ -193,17 +239,17 @@ struct MyWidgetWidget: Widget {
 #Preview("Small", as: .systemSmall) {
     MyWidgetWidget()
 } timeline: {
-    MyWidgetEntry(date: .now, greeting: "Bom dia", title: "Olá, Paulo!", planText: "PRO", isPro: true, quote: "")
+    MyWidgetEntry(date: .now, greeting: "Bom dia", title: "Olá, Paulo!", planText: "PRO", isPro: true, quote: "Seu tempo é limitado.", quoteAuthor: "")
 }
 
 #Preview("Medium", as: .systemMedium) {
     MyWidgetWidget()
 } timeline: {
-    MyWidgetEntry(date: .now, greeting: "Boa tarde", title: "Olá, Paulo!", planText: "Plano grátis", isPro: false, quote: "")
+    MyWidgetEntry(date: .now, greeting: "Boa tarde", title: "Olá, Paulo!", planText: "Plano grátis", isPro: false, quote: "Seu tempo é limitado.\nNão viva a vida de outra pessoa.", quoteAuthor: "")
 }
 
 #Preview("Large", as: .systemLarge) {
     MyWidgetWidget()
 } timeline: {
-    MyWidgetEntry(date: .now, greeting: "Boa noite", title: "Olá, Paulo!", planText: "PRO", isPro: true, quote: "Sempre parece impossível, até que seja feito.")
+    MyWidgetEntry(date: .now, greeting: "Boa noite", title: "Olá, Paulo!", planText: "PRO", isPro: true, quote: "Seu tempo é limitado.\nNão viva a vida de outra pessoa.\nTenha coragem de seguir sua intuição.\nTodo o resto é secundário.", quoteAuthor: "Steve Jobs")
 }

package/templates/firebase/ios/Runner/Base.lproj/LaunchScreen.storyboard

@@ -38,7 +38,7 @@
         </scene>
     </scenes>
     <resources>
-        <image name="LaunchImage" width="512" height="512"/>
+        <image name="LaunchImage" width="1254" height="1254"/>
         <image name="LaunchBackground" width="1" height="1"/>
     </resources>
 </document>

package/templates/firebase/lib/components/components.dart

@@ -18,6 +18,7 @@ export 'kasy_button.dart';
 export 'kasy_card.dart';
 export 'kasy_checkbox.dart';
 export 'kasy_chip.dart';
+export 'kasy_date_picker.dart';
 export 'kasy_dialog.dart';
 export 'kasy_otp_verification_bottom_sheet.dart';
 export 'kasy_skeleton.dart';

package/templates/firebase/lib/components/kasy_avatar.dart

@@ -1,7 +1,8 @@
-import 'dart:ui' show lerpDouble;
+import 'dart:ui' as ui show lerpDouble;
 
 import 'package:flutter/foundation.dart' show kIsWeb;
 import 'package:flutter/material.dart';
+import 'package:kasy_kit/components/kasy_avatar_presets.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
 
 /// Logical sizes for [KasyAvatar] (diameter in logical pixels).
@@ -45,7 +46,7 @@ class KasyAvatar extends StatelessWidget {
   final bool showStoryRing;
   final Gradient? storyRingGradient;
   final KasyAvatarStatus? status;
-  final Gradient? backgroundGradient;
+  final KasyAvatarGradientData? backgroundGradient;
   final VoidCallback? onTap;
   final String? semanticLabel;
 
@@ -73,7 +74,7 @@ class KasyAvatar extends StatelessWidget {
   factory KasyAvatar.gradientFill({
     Key? key,
     required KasyAvatarSize size,
-    required Gradient gradient,
+    required KasyAvatarGradientData gradient,
     double? diameter,
     bool showShadow = true,
     VoidCallback? onTap,
@@ -183,17 +184,7 @@ class KasyAvatar extends StatelessWidget {
       return Stack(
         fit: StackFit.expand,
         children: [
-          DecoratedBox(
-            decoration: BoxDecoration(
-              shape: shape == KasyAvatarShape.circle
-                  ? BoxShape.circle
-                  : BoxShape.rectangle,
-              borderRadius: shape == KasyAvatarShape.roundedSquare
-                  ? BorderRadius.circular(_d * 0.32)
-                  : null,
-              gradient: backgroundGradient,
-            ),
-          ),
+          CustomPaint(painter: _AvatarOrbPainter(backgroundGradient!)),
           if (initialsRaw != null && initialsRaw.isNotEmpty)
             Center(
               child: Text(
@@ -497,6 +488,63 @@ _KasyAvatarColors _colorsForTone(
   return _KasyAvatarColors(background: bg, foreground: a);
 }
 
+// ─────────────────────────────────────────────────────────────────────────────
+// Orb painter
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Renders the HeroUI-style orb effect: a soft linear-gradient background
+/// plus a blurred sphere in the lower-center, using geometry extracted from
+/// the Figma SVGs (all 14 presets share identical shape, only colors differ).
+class _AvatarOrbPainter extends CustomPainter {
+  final KasyAvatarGradientData data;
+
+  const _AvatarOrbPainter(this.data);
+
+  @override
+  void paint(Canvas canvas, Size size) {
+    // Background: linear gradient top → bottom.
+    final Rect rect = Offset.zero & size;
+    final Paint bgPaint = Paint()
+      ..shader = LinearGradient(
+        begin: Alignment.topCenter,
+        end: Alignment.bottomCenter,
+        colors: [data.bgTop, data.bgBottom],
+      ).createShader(rect);
+    canvas.drawRect(rect, bgPaint);
+
+    // Orb: blurred circle with diagonal linear gradient.
+    // Geometry normalised from 80x80 px Figma SVG:
+    //   center = (45.625, 52.5)  → (0.5703 w, 0.6563 h)
+    //   radius = 27.5            → 0.344 w
+    //   blur   = stdDeviation 7.8125 → 0.0977 w
+    final Offset center = Offset(
+      size.width * 0.5703,
+      size.height * 0.6563,
+    );
+    final double radius = size.width * 0.344;
+    final double blurSigma = size.width * 0.0977;
+
+    // Gradient aligned to the orb bounding box.
+    final Rect orbRect = Rect.fromCircle(center: center, radius: radius);
+    final Paint orbPaint = Paint()
+      ..shader = LinearGradient(
+        begin: const Alignment(-0.24, 0.0),
+        end: const Alignment(0.75, 1.21),
+        colors: [data.orbTop, data.orbBottom],
+      ).createShader(orbRect)
+      ..maskFilter = MaskFilter.blur(BlurStyle.normal, blurSigma);
+
+    canvas.drawCircle(center, radius, orbPaint);
+  }
+
+  @override
+  bool shouldRepaint(_AvatarOrbPainter old) => data != old.data;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Pressable wrapper
+// ─────────────────────────────────────────────────────────────────────────────
+
 class _KasyAvatarPressable extends StatefulWidget {
   final Widget child;
   final VoidCallback onPressed;
@@ -538,12 +586,12 @@ class _KasyAvatarPressableState extends State<_KasyAvatarPressable>
   double get _s {
     final double t = _c.value.clamp(0.0, 1.0);
     if (t <= 0.28) {
-      return lerpDouble(1.0, _pressIn, t / 0.28)!;
+      return ui.lerpDouble(1.0, _pressIn, t / 0.28)!;
     }
     if (t <= 0.55) {
-      return lerpDouble(_pressIn, _releasePeak, (t - 0.28) / 0.27)!;
+      return ui.lerpDouble(_pressIn, _releasePeak, (t - 0.28) / 0.27)!;
     }
-    return lerpDouble(_releasePeak, 1.0, (t - 0.55) / 0.45)!;
+    return ui.lerpDouble(_releasePeak, 1.0, (t - 0.55) / 0.45)!;
   }
 
   void _tap() {

package/templates/firebase/lib/components/kasy_avatar_presets.dart

@@ -1,133 +1,157 @@
 import 'package:flutter/material.dart';
 
-/// Linear gradient presets for [KasyAvatar] via `backgroundGradient` or
-/// [KasyAvatar.gradientFill].
+/// Gradient data for [KasyAvatar] orb-style fills.
 ///
-/// Matches the HeroUI Figma Kit V3 avatar palette exactly.
-/// All gradients use 141° (upper-left → lower-right), flat from 0%→27%,
-/// then transition to the second color at 100% — same as Figma specification.
+/// Holds the four colors needed to render the background wash and the
+/// soft-focus sphere: [bgTop]/[bgBottom] for the canvas gradient, and
+/// [orbTop]/[orbBottom] for the blurred orb overlay.
+///
+/// Matches the HeroUI Figma Kit V3 "Image Use" avatar palette exactly.
+@immutable
+class KasyAvatarGradientData {
+  final Color bgTop;
+  final Color bgBottom;
+  final Color orbTop;
+  final Color orbBottom;
+
+  const KasyAvatarGradientData({
+    required this.bgTop,
+    required this.bgBottom,
+    required this.orbTop,
+    required this.orbBottom,
+  });
+
+  @override
+  bool operator ==(Object other) {
+    if (identical(this, other)) return true;
+    return other is KasyAvatarGradientData &&
+        other.bgTop == bgTop &&
+        other.bgBottom == bgBottom &&
+        other.orbTop == orbTop &&
+        other.orbBottom == orbBottom;
+  }
+
+  @override
+  int get hashCode => Object.hash(bgTop, bgBottom, orbTop, orbBottom);
+}
+
+/// All 14 orb-style avatar gradient presets (matches Figma "Image Use" section).
 abstract final class KasyAvatarGradients {
-  // 141° CSS angle → Flutter Alignment
-  // begin = upper-left region (-sin141°, cos141°) ≈ (-0.63, -0.78)
-  // end   = lower-right region (+sin141°, -cos141°) ≈ (+0.63, +0.78)
-  static const Alignment _b = Alignment(-0.63, -0.78);
-  static const Alignment _e = Alignment(0.63, 0.78);
-
-  /// Cornflower blue → deep blue
-  static const LinearGradient blue = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF5D9BE7), Color(0xFF5D9BE7), Color(0xFF0026FF)],
-    stops: [0.0, 0.27, 1.0],
+  /// Cornflower-blue canvas, deep-blue orb.
+  static const KasyAvatarGradientData blueDark = KasyAvatarGradientData(
+    bgTop: Color(0xFFE9E9FF),
+    bgBottom: Color(0xFFCCCDF1),
+    orbTop: Color(0xFF5D9BE7),
+    orbBottom: Color(0xFF0026FF),
   );
 
-  /// Cyan-blue → violet
-  static const LinearGradient sky = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF5DD0E7), Color(0xFF5DD0E7), Color(0xFF7300FF)],
-    stops: [0.0, 0.27, 1.0],
+  /// Ice-blue canvas, cyan-to-violet orb.
+  static const KasyAvatarGradientData blue = KasyAvatarGradientData(
+    bgTop: Color(0xFFE9E9FF),
+    bgBottom: Color(0xFFCCE5F1),
+    orbTop: Color(0xFF5DD0E7),
+    orbBottom: Color(0xFF7300FF),
   );
 
-  /// Aqua → deep blue
-  static const LinearGradient teal = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF5DE7E7), Color(0xFF5DE7E7), Color(0xFF001AFF)],
-    stops: [0.0, 0.27, 1.0],
+  /// Pale-aqua canvas, aqua-to-deep-blue orb.
+  static const KasyAvatarGradientData sky = KasyAvatarGradientData(
+    bgTop: Color(0xFFE9FAFF),
+    bgBottom: Color(0xFFCCECF1),
+    orbTop: Color(0xFF5DE7E7),
+    orbBottom: Color(0xFF001AFF),
   );
 
-  /// Mint green → royal blue
-  static const LinearGradient emerald = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF5DE79D), Color(0xFF5DE79D), Color(0xFF0033FF)],
-    stops: [0.0, 0.27, 1.0],
+  /// Mint canvas, seafoam-to-forest orb.
+  static const KasyAvatarGradientData emerald = KasyAvatarGradientData(
+    bgTop: Color(0xFFE9FFF0),
+    bgBottom: Color(0xFFCCF1D6),
+    orbTop: Color(0xFF52DEB0),
+    orbBottom: Color(0xFF0D5C45),
   );
 
-  /// Seafoam → dark forest green
-  static const LinearGradient green = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF52DEB0), Color(0xFF52DEB0), Color(0xFF0D5C45)],
-    stops: [0.0, 0.27, 1.0],
+  /// Pale-green canvas, mint-to-royal-blue orb.
+  static const KasyAvatarGradientData green = KasyAvatarGradientData(
+    bgTop: Color(0xFFE9FFEB),
+    bgBottom: Color(0xFFD3F1CC),
+    orbTop: Color(0xFF5DE79D),
+    orbBottom: Color(0xFF0033FF),
   );
 
-  /// Turquoise → deep forest green
-  static const LinearGradient forest = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF5DD9AF), Color(0xFF5DD9AF), Color(0xFF094E39)],
-    stops: [0.0, 0.27, 1.0],
+  /// Sage canvas, turquoise-to-deep-forest orb.
+  static const KasyAvatarGradientData forest = KasyAvatarGradientData(
+    bgTop: Color(0xFFCDE8D5),
+    bgBottom: Color(0xFF9CD0AA),
+    orbTop: Color(0xFF5DD9AF),
+    orbBottom: Color(0xFF094E39),
   );
 
-  /// Golden yellow → deep red-orange
-  static const LinearGradient orange = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFFE7BD5D), Color(0xFFE7BD5D), Color(0xFFFF1E00)],
-    stops: [0.0, 0.27, 1.0],
+  /// Cream canvas, gold-to-deep-red orb.
+  static const KasyAvatarGradientData orange = KasyAvatarGradientData(
+    bgTop: Color(0xFFFFF8E9),
+    bgBottom: Color(0xFFF1DFCC),
+    orbTop: Color(0xFFE7BD5D),
+    orbBottom: Color(0xFFFF1E00),
   );
 
-  /// Salmon → scarlet
-  static const LinearGradient red = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFFE7885D), Color(0xFFE7885D), Color(0xFFFF0004)],
-    stops: [0.0, 0.27, 1.0],
+  /// Blush canvas, salmon-to-scarlet orb.
+  static const KasyAvatarGradientData red = KasyAvatarGradientData(
+    bgTop: Color(0xFFFFE9E9),
+    bgBottom: Color(0xFFF1CCCC),
+    orbTop: Color(0xFFE7885D),
+    orbBottom: Color(0xFFFF0004),
   );
 
-  /// Soft purple → cobalt blue
-  static const LinearGradient indigo = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFFB45DE7), Color(0xFFB45DE7), Color(0xFF0055FF)],
-    stops: [0.0, 0.27, 1.0],
+  /// Lavender canvas, soft-purple-to-cobalt orb.
+  static const KasyAvatarGradientData indigo = KasyAvatarGradientData(
+    bgTop: Color(0xFFEDCEFF),
+    bgBottom: Color(0xFFF1CCEE),
+    orbTop: Color(0xFFB45DE7),
+    orbBottom: Color(0xFF0055FF),
   );
 
-  /// Medium purple → crimson
-  static const LinearGradient purple = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF8D5DE7), Color(0xFF8D5DE7), Color(0xFFFF0009)],
-    stops: [0.0, 0.27, 1.0],
+  /// Lilac canvas, medium-purple-to-crimson orb.
+  static const KasyAvatarGradientData purple = KasyAvatarGradientData(
+    bgTop: Color(0xFFEFE9FF),
+    bgBottom: Color(0xFFDBCCF1),
+    orbTop: Color(0xFF8D5DE7),
+    orbBottom: Color(0xFFFF0009),
   );
 
-  /// Orchid pink → deep magenta-red
-  static const LinearGradient rose = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFFE75DCB), Color(0xFFE75DCB), Color(0xFFFF000D)],
-    stops: [0.0, 0.27, 1.0],
+  /// Pink-white canvas, orchid-to-magenta orb.
+  static const KasyAvatarGradientData rose = KasyAvatarGradientData(
+    bgTop: Color(0xFFFFE9FB),
+    bgBottom: Color(0xFFF0CCF1),
+    orbTop: Color(0xFFE75DCB),
+    orbBottom: Color(0xFFFF000D),
   );
 
-  /// Hot pink → coral red
-  static const LinearGradient hotPink = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFFE43673), Color(0xFFE43673), Color(0xFFFB5059)],
-    stops: [0.0, 0.27, 1.0],
+  /// Blush canvas, hot-pink-to-coral orb.
+  static const KasyAvatarGradientData hotPink = KasyAvatarGradientData(
+    bgTop: Color(0xFFFFE9E9),
+    bgBottom: Color(0xFFF1CCCD),
+    orbTop: Color(0xFFE43673),
+    orbBottom: Color(0xFFFB5059),
   );
 
-  /// Silver → near-black
-  static const LinearGradient silver = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF949494), Color(0xFF949494), Color(0xFF080808)],
-    stops: [0.0, 0.27, 1.0],
+  /// Light-grey canvas, silver-to-near-black orb.
+  static const KasyAvatarGradientData silver = KasyAvatarGradientData(
+    bgTop: Color(0xFFE3E3E3),
+    bgBottom: Color(0xFFC6C6C6),
+    orbTop: Color(0xFF949494),
+    orbBottom: Color(0xFF080808),
   );
 
-  /// Mid-grey → very dark grey
-  static const LinearGradient black = LinearGradient(
-    begin: _b,
-    end: _e,
-    colors: [Color(0xFF7F7F7F), Color(0xFF7F7F7F), Color(0xFF1F1F1F)],
-    stops: [0.0, 0.27, 1.0],
+  /// Dark-grey canvas, mid-grey-to-very-dark orb.
+  static const KasyAvatarGradientData black = KasyAvatarGradientData(
+    bgTop: Color(0xFF252525),
+    bgBottom: Color(0xFF444444),
+    orbTop: Color(0xFF7F7F7F),
+    orbBottom: Color(0xFF1F1F1F),
   );
 
   /// All 14 presets in display order (matches Figma "Image Use" section).
-  static const List<LinearGradient> all = [
-    blue, sky, teal, emerald, green, forest,
+  static const List<KasyAvatarGradientData> all = [
+    blueDark, blue, sky, emerald, green, forest,
     orange, red, indigo, purple, rose, hotPink,
     silver, black,
   ];