kasy-cli 1.21.9 → 1.23.0

package/templates/firebase/lib/core/widgets/kasy_hover.dart

@@ -6,6 +6,7 @@ import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:kasy_kit/core/haptics/haptic_feedback_notifier.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/kasy_focus_ring.dart';
 
 /// Universal hover/press wrapper — works on any widget shape, any platform.
 ///
@@ -45,8 +46,10 @@ class KasyHover extends ConsumerStatefulWidget {
     this.semanticLabel,
     this.hapticEnabled = true,
     this.hoverEnabled = true,
+    this.pressEnabled = true,
     this.hoverColor,
     this.pressColor,
+    this.focusable = false,
   });
 
   final Widget child;
@@ -75,6 +78,13 @@ class KasyHover extends ConsumerStatefulWidget {
   /// settings) where a hover highlight is visually unwanted.
   final bool hoverEnabled;
 
+  /// Whether the pressed-state background fill is shown on tap.
+  ///
+  /// When false, tapping triggers [onTap] (and haptic/cursor) with no visible
+  /// background highlight. Use on plain list rows (e.g. settings) where the tap
+  /// should just navigate without leaving a grey flash behind.
+  final bool pressEnabled;
+
   /// Exact background colour used while the pointer hovers over the widget.
   ///
   /// When non-null, this solid colour replaces the default semi-transparent
@@ -95,6 +105,13 @@ class KasyHover extends ConsumerStatefulWidget {
   /// background is already tinted so the feedback stays on-palette.
   final Color? pressColor;
 
+  /// When true, the control becomes a keyboard tab-stop by wrapping its visual
+  /// in the kit's [KasyFocusRing]: a focus ring appears during keyboard
+  /// navigation (never on pointer/touch) and Enter/Space triggers [onTap].
+  /// Pointer and touch behaviour are unchanged. Defaults to false so existing
+  /// call sites stay plain, non-focusable rows.
+  final bool focusable;
+
   @override
   ConsumerState<KasyHover> createState() => _KasyHoverState();
 }
@@ -117,22 +134,34 @@ class _KasyHoverState extends ConsumerState<KasyHover> {
   Color _overlayColor(BuildContext context) {
     final bool isDark = Theme.of(context).brightness == Brightness.dark;
     final Color base = widget.pressColor ?? context.colors.onSurface;
-    if (_pressed) return base.withValues(alpha: isDark ? 0.04 : 0.10);
-    if (_hovered && widget.hoverEnabled) {
-      // Solid hover colour — used for nav items where hover must exactly
-      // match the selected background.
-      if (widget.hoverColor != null) return widget.hoverColor!;
-      return base.withValues(alpha: isDark ? 0.02 : 0.06);
-    }
-    // IMPORTANT: when hoverColor is set, the resting state must be the same
-    // colour at alpha=0 (not Colors.transparent = 0x00000000 black).
-    // AnimatedContainer lerps between the two values — lerping from black-
-    // transparent to a light solid colour passes through dark intermediates,
-    // causing a visible flash. Lerping from the same hue at alpha=0 to
-    // alpha=1 only changes opacity → no dark artefact.
+
+    // Nav-item style: a solid hover/selected colour was provided. Keep the
+    // resting, hover and pressed states on the SAME hue — only the intensity
+    // changes, never the colour — so clicking never flashes.
+    //
+    // Resting must be that hue at alpha=0 (NOT Colors.transparent, which is
+    // transparent *black*): an AnimatedContainer lerping from black-transparent
+    // to a light solid passes through dark intermediates and flickers.
+    // Press = the hover fill blended a touch deeper, so hover→press→hover stays
+    // continuous instead of swapping to a different translucent overlay.
     if (widget.hoverColor != null) {
+      if (_pressed && widget.pressEnabled) {
+        return Color.alphaBlend(
+          base.withValues(alpha: isDark ? 0.06 : 0.08),
+          widget.hoverColor!,
+        );
+      }
+      if (_hovered && widget.hoverEnabled) return widget.hoverColor!;
       return widget.hoverColor!.withValues(alpha: 0);
     }
+
+    // Plain rows: a subtle translucent overlay that fades in on hover/press.
+    if (_pressed && widget.pressEnabled) {
+      return base.withValues(alpha: isDark ? 0.04 : 0.10);
+    }
+    if (_hovered && widget.hoverEnabled) {
+      return base.withValues(alpha: isDark ? 0.02 : 0.06);
+    }
     return Colors.transparent;
   }
 
@@ -174,13 +203,23 @@ class _KasyHoverState extends ConsumerState<KasyHover> {
       child: widget.child,
     );
 
+    // Keyboard focus is owned by the kit's single focus indicator so Tab +
+    // Enter/Space behave identically to login, signup and the chat send button.
+    final Widget focusContent = widget.focusable
+        ? KasyFocusRing(
+            borderRadius: widget.borderRadius,
+            onActivate: widget.onTap,
+            child: content,
+          )
+        : content;
+
     Widget interactive = GestureDetector(
       behavior: HitTestBehavior.opaque,
       onTap: _handleTap,
       onTapDown: _onTapDown,
       onTapUp: _onTapUp,
       onTapCancel: _onTapCancel,
-      child: content,
+      child: focusContent,
     );
 
     // MouseRegion is active on all platforms:

package/templates/firebase/lib/core/widgets/kasy_pressable_depth.dart

@@ -10,20 +10,20 @@ import 'package:kasy_kit/core/haptics/haptic_feedback_notifier.dart';
 /// Press-in with slight overshoot-back (same tactility as [KasyAlert] actions).
 ///
 /// No Material ripple. Optional [pressOverlayColor] + [clipBorderRadius]:
-/// clarão rápido no tap (véu), não enquanto o dedo apenas descansa em cima.
-/// Também expõe semântica para TalkBack/VoiceOver e haptic leve opcional ([hapticFeedbackEnabled]).
+/// a quick flash on tap (veil), not while the finger merely rests on it.
+/// Also exposes semantics for TalkBack/VoiceOver and an optional light haptic ([hapticFeedbackEnabled]).
 class KasyPressableDepth extends ConsumerStatefulWidget {
   final Widget child;
   final VoidCallback onPressed;
   final String semanticLabel;
 
-  /// Breve clarão no tap (véu translúcido); não durante o só pressionar.
+  /// Brief flash on tap (translucent veil); not while merely pressing.
   final Color? pressOverlayColor;
 
   /// Required with [pressOverlayColor] when the surface has rounded clips (pill, etc.).
   final BorderRadius? clipBorderRadius;
 
-  /// Se false, não chama [HapticFeedback.lightImpact] no tap.
+  /// If false, does not call [HapticFeedback.lightImpact] on tap.
   final bool hapticFeedbackEnabled;
 
   const KasyPressableDepth({
@@ -122,15 +122,20 @@ class _KasyPressableDepthState extends ConsumerState<KasyPressableDepth>
 
     return Transform.scale(
       scale: _depthScale,
-      child: ClipRRect(
-        borderRadius: widget.clipBorderRadius!,
-        child: Stack(
-          fit: StackFit.passthrough,
-          children: <Widget>[
-            rawChild,
-            Positioned.fill(child: pressVeil),
-          ],
-        ),
+      // Clip only the press veil to the rounded shape — never [rawChild]. The
+      // child may host a keyboard focus ring that paints just outside its box;
+      // clipping the whole stack would shave that ring off.
+      child: Stack(
+        fit: StackFit.passthrough,
+        children: <Widget>[
+          rawChild,
+          Positioned.fill(
+            child: ClipRRect(
+              borderRadius: widget.clipBorderRadius!,
+              child: pressVeil,
+            ),
+          ),
+        ],
       ),
     );
   }

package/templates/firebase/lib/{environnements.dart → environments.dart}

@@ -6,7 +6,7 @@ import 'package:freezed_annotation/freezed_annotation.dart';
 import 'package:kasy_kit/core/config/app_env.dart';
 import 'package:kasy_kit/core/states/user_state_notifier.dart';
 
-part 'environnements.freezed.dart';
+part 'environments.freezed.dart';
 
 // URLs for terms of service and privacy policy
 const kTermsUrl = '';
@@ -37,10 +37,6 @@ sealed class Environment with _$Environment {
     /// (only if you want to use in-app purchases with RevenueCat)
     String? revenueCatIOSApiKey,
 
-    /// RevenueCat Web Billing API key (rcb_xxx or rcb_sb_xxx)
-    /// (only if you want to use subscriptions on web)
-    String? revenueCatWebApiKey,
-
     /// this is used to open the app store page of your app for reviews
     String? appStoreId,
 
@@ -73,10 +69,6 @@ sealed class Environment with _$Environment {
     /// (only if you want to use in-app purchases with RevenueCat)
     String? revenueCatIOSApiKey,
 
-    /// RevenueCat Web Billing API key (rcb_xxx or rcb_sb_xxx)
-    /// (only if you want to use subscriptions on web)
-    String? revenueCatWebApiKey,
-
     /// only if you want to use ads
     String? androidInterstitialAdUnitId,
 
@@ -113,7 +105,6 @@ sealed class Environment with _$Environment {
           appStoreId: '',
           revenueCatAndroidApiKey: AppEnv.rcAndroidApiKey,
           revenueCatIOSApiKey: AppEnv.rcIosApiKey,
-          revenueCatWebApiKey: AppEnv.rcWebApiKey,
           mixpanelToken: AppEnv.mixpanelToken,
           // ─── Authentication mode ──────────────────────────────────────────
           // AuthenticationMode.anonymous (default) → a hidden anonymous Firebase Auth
@@ -134,7 +125,6 @@ sealed class Environment with _$Environment {
           appStoreId: AppEnv.appStoreId,
           revenueCatAndroidApiKey: AppEnv.rcAndroidApiKey,
           revenueCatIOSApiKey: AppEnv.rcIosApiKey,
-          revenueCatWebApiKey: AppEnv.rcWebApiKey,
           sentryDsn: AppEnv.sentryDsn,
           mixpanelToken: AppEnv.mixpanelToken,
           // See dev comment above for details on each mode.
@@ -150,9 +140,8 @@ sealed class Environment with _$Environment {
       revenueCatIOSApiKey != null && revenueCatIOSApiKey!.isNotEmpty,
     TargetPlatform.android =>
       revenueCatAndroidApiKey != null && revenueCatAndroidApiKey!.isNotEmpty,
-    _ =>
-      kIsWeb &&
-          (revenueCatWebApiKey != null && revenueCatWebApiKey!.isNotEmpty),
+    // RevenueCat is mobile-only; web/desktop are never RevenueCat-configured.
+    _ => false,
   };
 }
 

package/templates/firebase/lib/features/ai_chat/ai_chat_page.dart

@@ -0,0 +1,159 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/components/components.dart';
+import 'package:kasy_kit/core/haptics/kasy_haptics.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/responsive_layout.dart';
+import 'package:kasy_kit/features/ai_chat/providers/ai_conversations_notifier.dart';
+import 'package:kasy_kit/features/ai_chat/ui/widgets/ai_chat_avatars.dart';
+import 'package:kasy_kit/features/ai_chat/ui/widgets/ai_chat_conversation_view.dart';
+import 'package:kasy_kit/features/ai_chat/ui/widgets/ai_conversation_list.dart';
+import 'package:kasy_kit/i18n/translations.g.dart';
+
+/// Support / AI chat screen with conversation history.
+///
+/// Responsive:
+/// - phones (small): single pane. The conversation list is shown until a
+///   conversation is opened; opening one swaps to the thread (back returns).
+/// - tablet/desktop (medium+): two panes — the list beside a full-height
+///   container that hosts the active thread (or a placeholder when none).
+class AiChatPage extends StatelessWidget {
+  /// When true the page renders as a root bottom-tab (theme toggle, no back).
+  final bool isRootTab;
+
+  const AiChatPage({super.key, this.isRootTab = false});
+
+  @override
+  Widget build(BuildContext context) {
+    return ResponsiveLayout(
+      small: _MobileLayout(isRootTab: isRootTab),
+      medium: const _WideLayout(),
+    );
+  }
+}
+
+class _MobileLayout extends StatelessWidget {
+  const _MobileLayout({required this.isRootTab});
+
+  final bool isRootTab;
+
+  @override
+  Widget build(BuildContext context) {
+    // Phones show only the conversation list; opening a conversation pushes a
+    // full-screen route (so the bottom nav bar is hidden for the composer).
+    return Scaffold(
+      backgroundColor: context.colors.background,
+      body: Column(
+        children: [
+          KasyAppBar(
+            title: t.ai_chat.title,
+            style: isRootTab
+                ? KasyAppBarStyle.rootTab
+                : KasyAppBarStyle.subpage,
+            onThemeToggle: isRootTab
+                ? () {
+                    KasyHaptics.light(context);
+                    ThemeProvider.of(context).toggle();
+                  }
+                : null,
+          ),
+          const Expanded(
+            child: AiConversationList(swipeToDelete: true, isPhone: true),
+          ),
+        ],
+      ),
+    );
+  }
+}
+
+class _WideLayout extends ConsumerWidget {
+  const _WideLayout();
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final selectedId = ref.watch(selectedConversationIdProvider);
+
+    return Scaffold(
+      backgroundColor: context.colors.background,
+      body: Row(
+        crossAxisAlignment: CrossAxisAlignment.stretch,
+        children: [
+          DecoratedBox(
+            // Vertical hairline matching the sidebar/web-header line.
+            decoration: BoxDecoration(
+              border: Border(
+                right: BorderSide(color: context.colors.border, width: 0.5),
+              ),
+            ),
+            child: const SizedBox(
+              width: 340,
+              child: AiConversationList(),
+            ),
+          ),
+          Expanded(
+            child: Padding(
+              padding: const EdgeInsets.all(KasySpacing.md),
+              child: _DetailContainer(
+                child: selectedId == null
+                    ? const _DetailPlaceholder()
+                    : const AiChatConversationView(),
+              ),
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}
+
+/// Rounded, full-height surface that hosts the active thread (it scrolls
+/// internally). Mirrors the Figma reading-pane container.
+class _DetailContainer extends StatelessWidget {
+  const _DetailContainer({required this.child});
+
+  final Widget child;
+
+  @override
+  Widget build(BuildContext context) {
+    return Container(
+      clipBehavior: Clip.antiAlias,
+      decoration: BoxDecoration(
+        color: context.colors.surface,
+        borderRadius: BorderRadius.circular(24),
+        border: Border.all(color: context.colors.border, width: 0.5),
+      ),
+      child: child,
+    );
+  }
+}
+
+class _DetailPlaceholder extends StatelessWidget {
+  const _DetailPlaceholder();
+
+  @override
+  Widget build(BuildContext context) {
+    return Center(
+      child: Padding(
+        padding: const EdgeInsets.all(KasySpacing.lg),
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            const AiChatAssistantAvatar(
+              diameter: kAiChatEmptyAvatarDiameter,
+              showShadow: true,
+            ),
+            const SizedBox(height: KasySpacing.md),
+            Text(
+              t.ai_chat.no_conversation_selected,
+              textAlign: TextAlign.center,
+              style: context.textTheme.bodyLarge?.copyWith(
+                color: context.colors.muted,
+                height: 1.4,
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}

package/templates/firebase/lib/features/ai_chat/api/ai_chat_api.dart

@@ -0,0 +1,107 @@
+import 'package:cloud_firestore/cloud_firestore.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/features/ai_chat/api/ai_chat_conversation_entity.dart';
+import 'package:kasy_kit/features/ai_chat/api/ai_chat_message_entity.dart';
+import 'package:logger/logger.dart';
+
+final aiChatApiProvider = Provider<AiChatApi>(
+  (ref) => AiChatApi(client: FirebaseFirestore.instance),
+);
+
+/// Firestore layout (one user has many conversations, each has many messages):
+///   users/{userId}/ai_conversations/{conversationId}
+///   users/{userId}/ai_conversations/{conversationId}/messages/{messageId}
+class AiChatApi {
+  final FirebaseFirestore _client;
+  final Logger _logger = Logger();
+
+  AiChatApi({required FirebaseFirestore client}) : _client = client;
+
+  CollectionReference<Map<String, dynamic>> _conversationsRef(String userId) =>
+      _client.collection('users').doc(userId).collection('ai_conversations');
+
+  CollectionReference<Map<String, dynamic>> _messagesRef(
+    String userId,
+    String conversationId,
+  ) => _conversationsRef(userId).doc(conversationId).collection('messages');
+
+  // ---------------------------------------------------------------------------
+  // Conversations
+  // ---------------------------------------------------------------------------
+
+  /// Returns the user's conversations, most recently updated first.
+  Future<List<AiChatConversationEntity>> loadConversations(
+    String userId,
+  ) async {
+    final snapshot = await _conversationsRef(
+      userId,
+    ).orderBy('updatedAt', descending: true).get();
+    return snapshot.docs
+        .map((doc) => AiChatConversationEntity.fromFirestore(doc.id, doc.data()))
+        .toList();
+  }
+
+  /// Creates an empty conversation and returns it (with its generated id).
+  Future<AiChatConversationEntity> createConversation(String userId) async {
+    final now = DateTime.now();
+    final seed = AiChatConversationEntity(
+      id: '',
+      createdAt: now,
+      updatedAt: now,
+    );
+    final ref = await _conversationsRef(userId).add(seed.toFirestore());
+    return AiChatConversationEntity(
+      id: ref.id,
+      createdAt: now,
+      updatedAt: now,
+    );
+  }
+
+  /// Deletes a conversation and all of its messages.
+  Future<void> deleteConversation(String userId, String conversationId) async {
+    final messages = await _messagesRef(userId, conversationId).get();
+    final batch = _client.batch();
+    for (final doc in messages.docs) {
+      batch.delete(doc.reference);
+    }
+    batch.delete(_conversationsRef(userId).doc(conversationId));
+    await batch.commit();
+  }
+
+  // ---------------------------------------------------------------------------
+  // Messages
+  // ---------------------------------------------------------------------------
+
+  /// Returns all messages in a conversation, oldest first.
+  Future<List<AiChatMessageEntity>> loadMessages(
+    String userId,
+    String conversationId,
+  ) async {
+    final snapshot = await _messagesRef(
+      userId,
+      conversationId,
+    ).orderBy('createdAt', descending: false).get();
+    return snapshot.docs
+        .map((doc) => AiChatMessageEntity.fromFirestore(doc.id, doc.data()))
+        .toList();
+  }
+
+  /// Persists a message and denormalizes it onto the parent conversation
+  /// (last message preview + updatedAt) so the list stays cheap to render.
+  Future<void> saveMessage(
+    String userId,
+    String conversationId,
+    AiChatMessageEntity message,
+  ) async {
+    try {
+      await _messagesRef(userId, conversationId).add(message.toFirestore());
+      await _conversationsRef(userId).doc(conversationId).update({
+        'updatedAt': Timestamp.fromDate(message.createdAt),
+        'lastMessageRole': message.role,
+        'lastMessageContent': message.content,
+      });
+    } catch (e) {
+      _logger.e('Failed to persist AI message: $e');
+    }
+  }
+}

package/templates/firebase/lib/features/ai_chat/api/ai_chat_conversation_entity.dart

@@ -0,0 +1,64 @@
+import 'package:cloud_firestore/cloud_firestore.dart';
+
+/// Firestore document mapping for a single AI chat conversation.
+/// Stored at: users/{userId}/ai_conversations/{conversationId}
+///
+/// The last message is denormalized onto the conversation so the list can be
+/// rendered with a single read per conversation (no need to open each
+/// messages subcollection just to show a preview + timestamp).
+class AiChatConversationEntity {
+  final String id;
+  final DateTime createdAt;
+  final DateTime updatedAt;
+
+  /// Role of the most recent message ('user' or 'assistant'), or null when the
+  /// conversation has no messages yet.
+  final String? lastMessageRole;
+
+  /// Content of the most recent message, or null when empty.
+  final String? lastMessageContent;
+
+  const AiChatConversationEntity({
+    required this.id,
+    required this.createdAt,
+    required this.updatedAt,
+    this.lastMessageRole,
+    this.lastMessageContent,
+  });
+
+  bool get isEmpty => lastMessageContent == null;
+
+  AiChatConversationEntity copyWith({
+    DateTime? updatedAt,
+    String? lastMessageRole,
+    String? lastMessageContent,
+  }) {
+    return AiChatConversationEntity(
+      id: id,
+      createdAt: createdAt,
+      updatedAt: updatedAt ?? this.updatedAt,
+      lastMessageRole: lastMessageRole ?? this.lastMessageRole,
+      lastMessageContent: lastMessageContent ?? this.lastMessageContent,
+    );
+  }
+
+  factory AiChatConversationEntity.fromFirestore(
+    String id,
+    Map<String, dynamic> data,
+  ) {
+    return AiChatConversationEntity(
+      id: id,
+      createdAt: (data['createdAt'] as Timestamp?)?.toDate() ?? DateTime.now(),
+      updatedAt: (data['updatedAt'] as Timestamp?)?.toDate() ?? DateTime.now(),
+      lastMessageRole: data['lastMessageRole'] as String?,
+      lastMessageContent: data['lastMessageContent'] as String?,
+    );
+  }
+
+  Map<String, dynamic> toFirestore() => {
+    'createdAt': Timestamp.fromDate(createdAt),
+    'updatedAt': Timestamp.fromDate(updatedAt),
+    'lastMessageRole': lastMessageRole,
+    'lastMessageContent': lastMessageContent,
+  };
+}

package/templates/firebase/lib/features/{llm_chat/api/llm_chat_message_entity.dart → ai_chat/api/ai_chat_message_entity.dart}

@@ -1,25 +1,25 @@
 import 'package:cloud_firestore/cloud_firestore.dart';
 
-/// Firestore document mapping for a single LLM chat message.
-/// Stored at: users/{userId}/llm_messages/{messageId}
-class LlmChatMessageEntity {
+/// Firestore document mapping for a single AI chat message.
+/// Stored at: users/{userId}/ai_messages/{messageId}
+class AiChatMessageEntity {
   final String? id;
   final String role; // 'user' or 'assistant'
   final String content;
   final DateTime createdAt;
 
-  const LlmChatMessageEntity({
+  const AiChatMessageEntity({
     this.id,
     required this.role,
     required this.content,
     required this.createdAt,
   });
 
-  factory LlmChatMessageEntity.fromFirestore(
+  factory AiChatMessageEntity.fromFirestore(
     String id,
     Map<String, dynamic> data,
   ) {
-    return LlmChatMessageEntity(
+    return AiChatMessageEntity(
       id: id,
       role: data['role'] as String,
       content: data['content'] as String,