kasy-cli 1.32.0 → 1.35.0

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

@@ -0,0 +1,89 @@
+import 'package:flutter/gestures.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter/widgets.dart';
+
+/// Makes focus rings keyboard-only — the web's `:focus-visible` behaviour.
+///
+/// Flutter's default [FocusHighlightStrategy.automatic] only hides focus rings
+/// for *touch*; on desktop a mouse click keeps them in "traditional" mode, so a
+/// ring raised by Tab navigation never clears once the user grabs the mouse.
+/// This wraps the app and flips the strategy by input type:
+///   - a navigation key (Tab / arrows / Home / End / Page Up·Down) shows rings;
+///   - any pointer press hides them, and — when the user was mid keyboard
+///     navigation — also drops focus, so the next Tab restarts from the top of
+///     the traversal (skip link → sidebar → content) instead of resuming
+///     wherever the ring happened to be.
+///
+/// Plain typing does NOT turn rings on (only navigation keys do), so editing a
+/// text field with the mouse stays ring-free. Uses a global pointer route so it
+/// catches clicks anywhere, including empty areas with no hit target.
+class FocusVisibility extends StatefulWidget {
+  const FocusVisibility({super.key, required this.child});
+
+  final Widget child;
+
+  @override
+  State<FocusVisibility> createState() => _FocusVisibilityState();
+}
+
+class _FocusVisibilityState extends State<FocusVisibility> {
+  static final Set<LogicalKeyboardKey> _navigationKeys = <LogicalKeyboardKey>{
+    LogicalKeyboardKey.tab,
+    LogicalKeyboardKey.arrowUp,
+    LogicalKeyboardKey.arrowDown,
+    LogicalKeyboardKey.arrowLeft,
+    LogicalKeyboardKey.arrowRight,
+    LogicalKeyboardKey.home,
+    LogicalKeyboardKey.end,
+    LogicalKeyboardKey.pageUp,
+    LogicalKeyboardKey.pageDown,
+  };
+
+  @override
+  void initState() {
+    super.initState();
+    // Start ring-free; the first navigation key turns them on.
+    FocusManager.instance.highlightStrategy =
+        FocusHighlightStrategy.alwaysTouch;
+    HardwareKeyboard.instance.addHandler(_handleKey);
+    GestureBinding.instance.pointerRouter.addGlobalRoute(_handlePointer);
+  }
+
+  @override
+  void dispose() {
+    GestureBinding.instance.pointerRouter.removeGlobalRoute(_handlePointer);
+    HardwareKeyboard.instance.removeHandler(_handleKey);
+    super.dispose();
+  }
+
+  bool _handleKey(KeyEvent event) {
+    if (event is KeyDownEvent && _navigationKeys.contains(event.logicalKey)) {
+      _setStrategy(FocusHighlightStrategy.alwaysTraditional);
+    }
+    return false; // observe only — never consume the event
+  }
+
+  void _handlePointer(PointerEvent event) {
+    if (event is! PointerDownEvent) {
+      return;
+    }
+    final FocusManager fm = FocusManager.instance;
+    final bool wasKeyboardNav =
+        fm.highlightMode == FocusHighlightMode.traditional;
+    _setStrategy(FocusHighlightStrategy.alwaysTouch);
+    // Only reset focus when leaving keyboard navigation; a normal click (e.g.
+    // into a text field) then keeps the focus it's about to request.
+    if (wasKeyboardNav) {
+      fm.primaryFocus?.unfocus();
+    }
+  }
+
+  void _setStrategy(FocusHighlightStrategy strategy) {
+    if (FocusManager.instance.highlightStrategy != strategy) {
+      FocusManager.instance.highlightStrategy = strategy;
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) => widget.child;
+}

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

@@ -3,17 +3,19 @@ import 'package:kasy_kit/components/components.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
 import 'package:kasy_kit/i18n/translations.g.dart';
 
-/// Shows a modal bottom sheet displaying app update information
+/// Shows the "what's new" bottom sheet, built on [KasyBottomSheet].
+///
+/// Dismissing it — the Continue button, the drag handle, or tapping the dim
+/// barrier outside — simply closes the sheet and returns the user to the screen
+/// they were on; it never navigates anywhere. The version is already recorded as
+/// seen before this is shown (see `MaybeShowUpdateBottomSheet`), so it won't pop
+/// up again for the same version.
 Future<void> showUpdateBottomSheet({
   required BuildContext context,
   required String version,
-  bool useRootNavigator = true,
 }) async {
-  await showModalBottomSheet(
+  await showKasyBottomSheet<void>(
     context: context,
-    useSafeArea: true,
-    useRootNavigator: useRootNavigator,
-    barrierColor: context.colors.background.withValues(alpha: 0.90),
     isScrollControlled: true,
     builder: (context) => _UpdateBottomSheet(version: version),
   );
@@ -28,130 +30,31 @@ class _UpdateBottomSheet extends StatelessWidget {
   Widget build(BuildContext context) {
     final translations = Translations.of(context).update_bottom_sheet;
 
-    return Container(
-      decoration: BoxDecoration(
-        color: context.colors.surface,
-        borderRadius: const BorderRadius.only(
-          topLeft: Radius.circular(KasyRadius.xl),
-          topRight: Radius.circular(KasyRadius.xl),
+    return KasyBottomSheet(
+      icon: KasyIcons.star,
+      title: translations.title,
+      message: 'Version $version',
+      body: ConstrainedBox(
+        constraints: BoxConstraints(
+          maxHeight: MediaQuery.sizeOf(context).height * 0.5,
         ),
-        border: Border.all(
-          color: context.colors.primary.withValues(alpha: 0.2),
-          strokeAlign: BorderSide.strokeAlignOutside,
-          width: 2,
+        child: ListView.separated(
+          shrinkWrap: true,
+          padding: EdgeInsets.zero,
+          itemBuilder: (context, index) =>
+              _UpdateHighlightTile(highlight: translations.highlights[index]),
+          separatorBuilder: (context, index) =>
+              const SizedBox(height: KasySpacing.sm),
+          itemCount: translations.highlights.length,
         ),
       ),
-      child: SafeArea(
-        minimum: const EdgeInsets.only(bottom: KasySpacing.md),
-        child: Column(
-          mainAxisSize: MainAxisSize.min,
-          crossAxisAlignment: CrossAxisAlignment.start,
-          children: [
-            Flexible(
-              flex: 0,
-              child: Align(
-                child: ClipRRect(
-                  borderRadius: const BorderRadius.only(
-                    topLeft: Radius.circular(KasyRadius.xl),
-                    topRight: Radius.circular(KasyRadius.xl),
-                  ),
-                  child: Image.asset(
-                    'assets/images/update.png',
-                    fit: BoxFit.cover,
-                  ),
-                ),
-              ),
-            ),
-            Padding(
-              padding: const EdgeInsets.fromLTRB(
-                KasySpacing.lg,
-                KasySpacing.lg,
-                KasySpacing.md,
-                0,
-              ),
-              child: Row(
-                children: [
-                  Container(
-                    width: 48,
-                    height: 48,
-                    decoration: BoxDecoration(
-                      color: context.colors.primary.withValues(alpha: 0.1),
-                      borderRadius: KasyRadius.mdBorderRadius,
-                    ),
-                    child: Icon(
-                      KasyIcons.star,
-                      color: context.colors.primary,
-                      size: KasyIconSize.xl,
-                    ),
-                  ),
-                  const SizedBox(width: KasySpacing.md),
-                  Expanded(
-                    child: Column(
-                      crossAxisAlignment: CrossAxisAlignment.start,
-                      children: [
-                        Text(
-                          translations.title,
-                          style: context.textTheme.headlineSmall?.copyWith(
-                            color: context.colors.onSurface,
-                            fontWeight: FontWeight.w700,
-                          ),
-                        ),
-                        Text(
-                          "Version $version",
-                          style: context.textTheme.bodyMedium?.copyWith(
-                            color: context.colors.muted,
-                            fontWeight: FontWeight.w500,
-                          ),
-                        ),
-                      ],
-                    ),
-                  ),
-                  KasyButton.iconOnly(
-                    icon: KasyIcons.close,
-                    variant: KasyButtonVariant.ghost,
-                    foregroundColor: context.colors.muted,
-                    onPressed: () => Navigator.of(context).pop(),
-                    semanticLabel: translations.title,
-                  ),
-                ],
-              ),
-            ),
-            const SizedBox(height: KasySpacing.lg),
-            Flexible(
-              child: ConstrainedBox(
-                constraints: BoxConstraints(
-                  maxHeight: MediaQuery.of(context).size.height * 0.6,
-                ),
-                child: ListView.separated(
-                  shrinkWrap: true,
-                  padding: const EdgeInsets.symmetric(
-                    horizontal: KasySpacing.lg,
-                  ),
-                  itemBuilder: (context, index) {
-                    final highlight = translations.highlights[index];
-                    return _UpdateHighlightTile(highlight: highlight);
-                  },
-                  separatorBuilder: (context, index) =>
-                      const SizedBox(height: KasySpacing.sm),
-                  itemCount: translations.highlights.length,
-                ),
-              ),
-            ),
-            const SizedBox(height: KasySpacing.xl),
-            Padding(
-              padding: const EdgeInsets.symmetric(horizontal: KasySpacing.lg),
-              child: SizedBox(
-                width: double.infinity,
-                child: KasyButton(
-                label: translations.continue_button,
-                expand: true,
-                onPressed: () => Navigator.of(context).pop(),
-              ),
-              ),
-            ),
-          ],
+      actions: [
+        KasyButton(
+          label: translations.continue_button,
+          expand: true,
+          onPressed: () => Navigator.of(context).pop(),
         ),
-      ),
+      ],
     );
   }
 }

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

@@ -115,13 +115,8 @@ class _DetailContainer extends StatelessWidget {
 
   @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),
-      ),
+    return KasyCard(
+      borderRadius: BorderRadius.circular(KasyRadius.xl),
       child: child,
     );
   }
@@ -143,10 +138,18 @@ class _DetailPlaceholder extends StatelessWidget {
               showShadow: true,
             ),
             const SizedBox(height: KasySpacing.md),
+            Text(
+              t.home.cards.assistant_title,
+              textAlign: TextAlign.center,
+              style: context.textTheme.titleMedium?.copyWith(
+                color: context.colors.onBackground,
+              ),
+            ),
+            const SizedBox(height: KasySpacing.xs),
             Text(
               t.ai_chat.no_conversation_selected,
               textAlign: TextAlign.center,
-              style: context.textTheme.bodyLarge?.copyWith(
+              style: context.textTheme.bodyMedium?.copyWith(
                 color: context.colors.muted,
                 height: 1.4,
               ),

package/templates/firebase/lib/features/ai_chat/ui/widgets/ai_chat_composer.dart

@@ -30,6 +30,12 @@ class AiChatComposer extends StatefulWidget {
 class _AiChatComposerState extends State<AiChatComposer> {
   bool _canSend = false;
 
+  // Owns the field focus so we can intercept hardware Enter: plain Enter sends,
+  // Shift+Enter inserts a newline (the standard chat-composer behaviour). On
+  // touch keyboards (no hardware key event) the return key keeps inserting a
+  // newline and the send orb is used, so mobile is unchanged.
+  late final FocusNode _focusNode = FocusNode(onKeyEvent: _onKeyEvent);
+
   @override
   void initState() {
     super.initState();
@@ -40,9 +46,23 @@ class _AiChatComposerState extends State<AiChatComposer> {
   @override
   void dispose() {
     widget.controller.removeListener(_onTextChanged);
+    _focusNode.dispose();
     super.dispose();
   }
 
+  KeyEventResult _onKeyEvent(FocusNode node, KeyEvent event) {
+    if (event is! KeyDownEvent) return KeyEventResult.ignored;
+    final bool isEnter = event.logicalKey == LogicalKeyboardKey.enter ||
+        event.logicalKey == LogicalKeyboardKey.numpadEnter;
+    if (!isEnter) return KeyEventResult.ignored;
+    // Shift+Enter falls through to the field and inserts a newline.
+    if (HardwareKeyboard.instance.isShiftPressed) {
+      return KeyEventResult.ignored;
+    }
+    _handleSend();
+    return KeyEventResult.handled;
+  }
+
   bool _hasSendableText(String value) {
     final String trimmed = value.trim();
     return trimmed.isNotEmpty && trimmed.length <= kAiChatMaxMessageLength;
@@ -88,6 +108,7 @@ class _AiChatComposerState extends State<AiChatComposer> {
             Expanded(
               child: KasyTextField(
                 controller: widget.controller,
+                focusNode: _focusNode,
                 enabled: enabled,
                 variant: KasyTextFieldVariant.embedded,
                 hint: t.ai_chat.hint,

package/templates/firebase/lib/features/ai_chat/ui/widgets/ai_chat_conversation_view.dart

@@ -186,7 +186,6 @@ class _EmptyState extends StatelessWidget {
               t.home.cards.assistant_title,
               textAlign: TextAlign.center,
               style: context.textTheme.titleMedium?.copyWith(
-                fontWeight: FontWeight.w600,
                 color: context.colors.onBackground,
               ),
             ),
@@ -194,7 +193,7 @@ class _EmptyState extends StatelessWidget {
             Text(
               t.ai_chat.empty_state,
               textAlign: TextAlign.center,
-              style: context.textTheme.bodyLarge?.copyWith(
+              style: context.textTheme.bodyMedium?.copyWith(
                 color: context.colors.muted,
                 height: 1.4,
               ),

package/templates/firebase/lib/features/ai_chat/ui/widgets/ai_conversation_list.dart

@@ -207,8 +207,7 @@ class _Header extends StatelessWidget {
                 t.ai_chat.title,
                 maxLines: 1,
                 overflow: TextOverflow.ellipsis,
-                style: context.textTheme.titleLarge?.copyWith(
-                  fontWeight: FontWeight.w800,
+                style: context.kasyTextTheme.pageTitle.copyWith(
                   color: context.colors.onBackground,
                 ),
               ),
@@ -274,7 +273,7 @@ class _EmptyConversations extends StatelessWidget {
         child: Text(
           t.ai_chat.conversations_empty,
           textAlign: TextAlign.center,
-          style: context.textTheme.bodyLarge?.copyWith(
+          style: context.textTheme.bodyMedium?.copyWith(
             color: context.colors.muted,
             height: 1.4,
           ),

package/templates/firebase/lib/features/ai_chat/ui/widgets/ai_conversation_tile.dart

@@ -75,8 +75,7 @@ class _AiConversationTileState extends ConsumerState<AiConversationTile> {
                         title,
                         maxLines: 1,
                         overflow: TextOverflow.ellipsis,
-                        style: context.textTheme.bodyMedium?.copyWith(
-                          fontWeight: FontWeight.w600,
+                        style: context.kasyTextTheme.rowTitle.copyWith(
                           color: titleColor,
                         ),
                       ),

package/templates/firebase/lib/features/authentication/api/auth_web_support.dart

@@ -0,0 +1,12 @@
+/// Whether the app is running inside a *mobile* web browser (phone/tablet).
+///
+/// Drives the OAuth flow choice on web: mobile browsers handle provider popups
+/// unreliably — the provider opens in a new tab and the popup result is
+/// frequently lost when the browser reclaims the backgrounded opener tab, so the
+/// sign-in future never resolves and the app stays stuck "signing in". On mobile
+/// we use a full-page redirect instead (completed at startup by
+/// `getRedirectResult`); desktop web keeps the smoother popup.
+///
+/// Non-web stub: always false. The real implementation lives in
+/// `auth_web_support_web.dart` and is selected via conditional import on web.
+bool isMobileWebBrowser() => false;

package/templates/firebase/lib/features/authentication/api/auth_web_support_web.dart

@@ -0,0 +1,25 @@
+import 'package:web/web.dart' as web;
+
+/// Web implementation: detects a mobile browser from the user-agent (iOS, Android
+/// and other common phone/tablet agents). iPadOS 13+ reports a desktop Safari
+/// user-agent, so we also treat a touch-capable "Macintosh" as mobile.
+///
+/// A false positive only costs the (also-working) redirect flow instead of the
+/// popup, so the heuristic deliberately errs toward catching mobiles.
+bool isMobileWebBrowser() {
+  final ua = web.window.navigator.userAgent.toLowerCase();
+  const needles = [
+    'android',
+    'iphone',
+    'ipad',
+    'ipod',
+    'mobile',
+    'windows phone',
+    'blackberry',
+    'opera mini',
+    'iemobile',
+  ];
+  if (needles.any(ua.contains)) return true;
+  // iPadOS 13+ masquerades as desktop Safari but still exposes touch points.
+  return ua.contains('macintosh') && web.window.navigator.maxTouchPoints > 1;
+}