kasy-cli 1.18.0 → 1.19.0

package/templates/firebase/lib/core/bottom_menu/bottom_router.dart

@@ -2,7 +2,6 @@ import 'package:bart/bart.dart';
 import 'package:flutter/material.dart';
 import 'package:kasy_kit/components/kasy_app_bar.dart';
 import 'package:kasy_kit/core/bottom_menu/bart_inner_paths.dart';
-import 'package:kasy_kit/core/bottom_menu/kasy_bart_navigation.dart';
 import 'package:kasy_kit/core/bottom_menu/notification_bottom_item.dart';
 import 'package:kasy_kit/core/navigation/kasy_navigation_config.dart';
 import 'package:kasy_kit/core/navigation/kasy_route_transition.dart';
@@ -110,53 +109,18 @@ List<BartMenuRoute> subRoutes() {
   ];
 }
 
-class _HomeInnerRoute extends StatefulWidget {
+/// Marker wrapper for inner home routes. Visibility is owned by
+/// [BottomMenu] (see [BottomMenu._onRouteChanged] + [BartMenuRoute.innerRoute]
+/// `showBottomBar: false`); this widget exists for symmetry with the dashboard
+/// cards and to keep `HomeFeaturesPage` / `HomeComponentsPage` / etc. agnostic
+/// of how they were pushed.
+class _HomeInnerRoute extends StatelessWidget {
   final Widget child;
 
   const _HomeInnerRoute({required this.child});
 
   @override
-  State<_HomeInnerRoute> createState() => _HomeInnerRouteState();
-}
-
-class _HomeInnerRouteState extends State<_HomeInnerRoute> {
-  ModalRoute<Object?>? _route;
-
-  @override
-  void didChangeDependencies() {
-    super.didChangeDependencies();
-    final ModalRoute<Object?>? route = ModalRoute.of(context);
-    if (_route != route) {
-      _route?.animation?.removeStatusListener(_onRouteAnimStatus);
-      _route = route;
-      final Animation<double>? anim = route?.animation;
-      if (anim != null && !anim.isCompleted) {
-        anim.addStatusListener(_onRouteAnimStatus);
-      }
-    }
-    kasyHideBottomBar(context);
-  }
-
-  void _onRouteAnimStatus(AnimationStatus status) {
-    if (mounted && status == AnimationStatus.completed) {
-      kasyHideBottomBar(context);
-    }
-  }
-
-  @override
-  void dispose() {
-    _route?.animation?.removeStatusListener(_onRouteAnimStatus);
-    super.dispose();
-  }
-
-  @override
-  void reassemble() {
-    super.reassemble();
-    kasyHideBottomBar(context);
-  }
-
-  @override
-  Widget build(BuildContext context) => widget.child;
+  Widget build(BuildContext context) => child;
 }
 
 /// Placeholder page for the wishlist tab.

package/templates/firebase/lib/core/dev_inspector/dev_inspector.dart

@@ -2,6 +2,7 @@ import 'dart:async';
 
 import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
+import 'package:flutter/scheduler.dart';
 import 'package:flutter/services.dart';
 import 'package:kasy_kit/core/dev_inspector/dev_inspector_info.dart';
 import 'package:kasy_kit/core/dev_inspector/dev_inspector_service.dart';
@@ -12,6 +13,10 @@ import 'package:kasy_kit/core/theme/providers/theme_provider.dart';
 import 'package:kasy_kit/i18n/translations.g.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 
+const Color _highlightColor = Color(0xFFD2F51E);
+const double _highlightStrokeWidth = 2.0;
+const double _highlightCornerRadius = 4.0;
+
 final GlobalKey<ScaffoldMessengerState> devInspectorRootScaffoldMessengerKey =
     GlobalKey<ScaffoldMessengerState>(debugLabel: 'devInspectorRoot');
 
@@ -31,6 +36,12 @@ final ValueNotifier<bool> devInspectorRevealNowNotifier =
 final ValueNotifier<bool> devInspectorCopyTriggerNotifier =
     ValueNotifier<bool>(false);
 
+/// Active state of the custom inspector. Toggled by the FAB (native) and by
+/// the Web Device Preview pill; observed by [DevInspector] to mount the
+/// tap-absorbing overlay and the highlight.
+final ValueNotifier<bool> devInspectorActiveNotifier =
+    ValueNotifier<bool>(false);
+
 class DevInspector extends StatefulWidget {
   const DevInspector({super.key, required this.child});
 
@@ -45,7 +56,8 @@ class DevInspector extends StatefulWidget {
   State<DevInspector> createState() => _DevInspectorState();
 }
 
-class _DevInspectorState extends State<DevInspector> {
+class _DevInspectorState extends State<DevInspector>
+    with SingleTickerProviderStateMixin {
   static const Duration _fabRevealDelay = Duration(seconds: 2);
   static const Duration _fabDeemphasizeDelay = Duration(seconds: 2);
   static const Duration _fabOpacityAnimation = Duration(milliseconds: 700);
@@ -71,11 +83,15 @@ class _DevInspectorState extends State<DevInspector> {
   bool _fabFadeIn = false;
   bool _fabEmphasized = false;
 
+  DevInspectorInfo? _selectedInfo;
+  RenderObject? _selectedRender;
+  Rect? _highlightRect;
+  Ticker? _highlightTicker;
+
   @override
   void initState() {
     super.initState();
-    WidgetsBinding.instance.debugShowWidgetInspectorOverrideNotifier
-        .addListener(_handleInspectorOverrideChanged);
+    devInspectorActiveNotifier.addListener(_handleActiveChanged);
     devInspectorFabEnabledNotifier.addListener(_onFabEnabledNotifierChanged);
     devInspectorRevealNowNotifier.addListener(_onRevealNow);
     devInspectorCopyTriggerNotifier.addListener(_onCopyTriggered);
@@ -87,13 +103,13 @@ class _DevInspectorState extends State<DevInspector> {
     _revealTimer?.cancel();
     _fabDeemphasizeTimer?.cancel();
     _copyFeedbackTimer?.cancel();
+    _highlightTicker?.dispose();
     devInspectorFabEnabledNotifier.removeListener(_onFabEnabledNotifierChanged);
     devInspectorRevealNowNotifier.removeListener(_onRevealNow);
     devInspectorCopyTriggerNotifier.removeListener(_onCopyTriggered);
-    WidgetsBinding.instance.debugShowWidgetInspectorOverrideNotifier
-        .removeListener(_handleInspectorOverrideChanged);
-    if (_active) {
-      WidgetsBinding.instance.debugShowWidgetInspectorOverride = false;
+    devInspectorActiveNotifier.removeListener(_handleActiveChanged);
+    if (devInspectorActiveNotifier.value) {
+      devInspectorActiveNotifier.value = false;
     }
     super.dispose();
   }
@@ -141,7 +157,7 @@ class _DevInspectorState extends State<DevInspector> {
     if (!mounted) return;
     if (!enabled) {
       if (_active) {
-        WidgetsBinding.instance.debugShowWidgetInspectorOverride = false;
+        devInspectorActiveNotifier.value = false;
       }
       _copyFeedbackTimer?.cancel();
       setState(() {
@@ -152,6 +168,7 @@ class _DevInspectorState extends State<DevInspector> {
         _dragging = false;
         _copyFeedbackText = null;
         _copyFeedbackIsError = false;
+        _clearSelection();
       });
       _copyFeedbackTimer?.cancel();
       return;
@@ -192,17 +209,62 @@ class _DevInspectorState extends State<DevInspector> {
   }
 
   void _setInspectorActive(bool value) {
-    setState(() => _active = value);
-    WidgetsBinding.instance.debugShowWidgetInspectorOverride = value;
+    devInspectorActiveNotifier.value = value;
     HapticFeedback.lightImpact();
   }
 
-  void _handleInspectorOverrideChanged() {
-    final bool override =
-        WidgetsBinding.instance.debugShowWidgetInspectorOverride;
-    if (_active == override) return;
+  void _handleActiveChanged() {
+    final bool active = devInspectorActiveNotifier.value;
+    if (_active == active) return;
     if (!mounted) return;
-    setState(() => _active = override);
+    setState(() {
+      _active = active;
+      if (!active) _clearSelection();
+    });
+  }
+
+  void _clearSelection() {
+    _selectedInfo = null;
+    _selectedRender = null;
+    _highlightRect = null;
+    _stopHighlightTicker();
+  }
+
+  void _onInspectorTap(Offset globalPosition) {
+    final picked = DevInspectorService.pickAt(globalPosition);
+    if (picked == null) {
+      HapticFeedback.heavyImpact();
+      return;
+    }
+    setState(() {
+      _selectedInfo = picked.info;
+      _selectedRender = picked.renderObject;
+      _highlightRect = picked.info.boundingBox;
+    });
+    _startHighlightTicker();
+    HapticFeedback.selectionClick();
+  }
+
+  void _startHighlightTicker() {
+    _highlightTicker ??= createTicker(_onHighlightTick);
+    if (!_highlightTicker!.isActive) _highlightTicker!.start();
+  }
+
+  void _stopHighlightTicker() {
+    if (_highlightTicker?.isActive ?? false) _highlightTicker!.stop();
+  }
+
+  void _onHighlightTick(Duration _) {
+    final RenderObject? target = _selectedRender;
+    if (target == null) return;
+    final Rect? rect = DevInspectorService.remeasure(target);
+    if (rect == null) {
+      setState(_clearSelection);
+      return;
+    }
+    if (_highlightRect != rect) {
+      setState(() => _highlightRect = rect);
+    }
   }
 
   String? _extractRouteHint(DevInspectorInfo info) {
@@ -233,7 +295,7 @@ class _DevInspectorState extends State<DevInspector> {
     if (!_active || _copyBusy) return;
     _copyBusy = true;
     try {
-      final DevInspectorInfo? info = DevInspectorService.inspectSelected();
+      final DevInspectorInfo? info = _selectedInfo;
       if (!mounted) return;
       if (info == null) {
         _showCopyFeedback(t.devInspector.selectWidgetFirst, isError: true);
@@ -308,6 +370,20 @@ class _DevInspectorState extends State<DevInspector> {
               clipBehavior: Clip.none,
               children: <Widget>[
                 widget.child,
+                if (_active)
+                  Positioned.fill(
+                    child: Listener(
+                      behavior: HitTestBehavior.opaque,
+                      onPointerDown: (PointerDownEvent ev) =>
+                          _onInspectorTap(ev.position),
+                      child: IgnorePointer(
+                        child: CustomPaint(
+                          painter: _HighlightPainter(rect: _highlightRect),
+                          size: Size.infinite,
+                        ),
+                      ),
+                    ),
+                  ),
                 if (_fabLayerMounted &&
                     devInspectorFabEnabledNotifier.value)
                   Positioned(
@@ -462,3 +538,29 @@ class _EntryFab extends StatelessWidget {
     );
   }
 }
+
+class _HighlightPainter extends CustomPainter {
+  _HighlightPainter({required this.rect});
+
+  final Rect? rect;
+
+  @override
+  void paint(Canvas canvas, Size size) {
+    final Rect? r = rect;
+    if (r == null || r.isEmpty) return;
+    final Paint paint = Paint()
+      ..color = _highlightColor
+      ..style = PaintingStyle.stroke
+      ..strokeWidth = _highlightStrokeWidth;
+    final Rect outer = r.inflate(_highlightStrokeWidth / 2);
+    final RRect rrect = RRect.fromRectAndRadius(
+      outer,
+      const Radius.circular(_highlightCornerRadius),
+    );
+    canvas.drawRRect(rrect, paint);
+  }
+
+  @override
+  bool shouldRepaint(_HighlightPainter oldDelegate) =>
+      oldDelegate.rect != rect;
+}

package/templates/firebase/lib/core/dev_inspector/dev_inspector_service.dart

@@ -280,23 +280,12 @@ class DevInspectorService {
     );
   }
 
-  /// Reads the widget currently selected in Flutter's native inspector.
-  static DevInspectorInfo? inspectSelected() {
-    if (!kDebugMode) return null;
-    try {
-      // ignore: invalid_use_of_visible_for_testing_member
-      final RenderObject? renderObject =
-          WidgetInspectorService.instance.selection.current;
-      if (renderObject == null) return null;
-      return _extractFromRenderObject(renderObject);
-    } catch (_) {
-      return null;
-    }
-  }
-
-  /// Inspects the widget at a global position, syncs the native inspector
-  /// selection (tooltip + highlight), and return the info.
-  static DevInspectorInfo? inspectAndSelect(Offset globalPosition) {
+  /// Hit-tests at [globalPosition] and returns the inspector info plus the
+  /// underlying render object so the caller can re-measure the bounds during
+  /// animations.
+  static ({DevInspectorInfo info, RenderObject renderObject})? pickAt(
+    Offset globalPosition,
+  ) {
     if (!kDebugMode) return null;
     try {
       final result = BoxHitTestResult();
@@ -308,9 +297,7 @@ class DevInspectorService {
         final RenderObject candidate = entry.target as RenderObject;
         final DevInspectorInfo? info = _extractFromRenderObject(candidate);
         if (info != null) {
-          // ignore: invalid_use_of_protected_member
-          WidgetInspectorService.instance.setSelection(candidate, 'kit_inspector');
-          return info;
+          return (info: info, renderObject: candidate);
         }
       }
       return null;
@@ -318,4 +305,11 @@ class DevInspectorService {
       return null;
     }
   }
+
+  /// Re-measures the global bounding rect of a previously picked render
+  /// object. Returns null if it became detached from the tree.
+  static Rect? remeasure(RenderObject target) {
+    if (!target.attached) return null;
+    return _globalBoundingRect(target);
+  }
 }

package/templates/firebase/lib/core/security/secured_storage.dart

@@ -1,6 +1,8 @@
+import 'package:flutter/foundation.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_secure_storage/flutter_secure_storage.dart';
 import 'package:kasy_kit/core/data/entities/user_entity.dart';
+import 'package:shared_preferences/shared_preferences.dart';
 
 const _kTokenKey = "token";
 const _kUserIdKey = "userId";
@@ -9,38 +11,77 @@ final authSecuredStorageProvider = Provider<AuthSecuredStorage>(
   (ref) => AuthSecuredStorage.fromEnv(),
 );
 
-class AuthSecuredStorage {
-  final FlutterSecureStorage _storage;
+abstract class AuthSecuredStorage {
+  Future<void> write({required Credentials value});
+  Future<Credentials?> read();
+  Future<void> clear();
 
-  AuthSecuredStorage({
-    required FlutterSecureStorage storage,
-  }) : _storage = storage;
+  // Web uses SharedPreferences (LocalStorage) because flutter_secure_storage
+  // has no real on-disk persistence in the browser. Mobile keeps the Keychain
+  // / EncryptedSharedPreferences backend it had before.
+  factory AuthSecuredStorage.fromEnv() {
+    if (kIsWeb) return _WebAuthStorage();
+    return _NativeAuthStorage(storage: const FlutterSecureStorage());
+  }
+}
+
+class _NativeAuthStorage implements AuthSecuredStorage {
+  final FlutterSecureStorage _storage;
 
-  factory AuthSecuredStorage.fromEnv() => AuthSecuredStorage(
-        storage: const FlutterSecureStorage(),
-      );
+  _NativeAuthStorage({required FlutterSecureStorage storage}) : _storage = storage;
 
-  Future<void> write({
-    required Credentials value,
-  }) async {
+  @override
+  Future<void> write({required Credentials value}) async {
     await _storage.write(key: _kUserIdKey, value: value.id);
     await _storage.write(key: _kTokenKey, value: value.token);
   }
 
+  @override
   Future<Credentials?> read() async {
     final userId = await _storage.read(key: _kUserIdKey);
     final token = await _storage.read(key: _kTokenKey);
     if (userId != null && token != null) {
-      return Credentials(
-        id: userId,
-        token: token,
-      );
+      return Credentials(id: userId, token: token);
     }
     return null;
   }
 
+  @override
   Future<void> clear() async {
     await _storage.delete(key: _kUserIdKey);
     await _storage.delete(key: _kTokenKey);
   }
 }
+
+class _WebAuthStorage implements AuthSecuredStorage {
+  Future<SharedPreferences> get _prefs => SharedPreferences.getInstance();
+
+  @override
+  Future<void> write({required Credentials value}) async {
+    final prefs = await _prefs;
+    await prefs.setString(_kUserIdKey, value.id);
+    if (value.token != null) {
+      await prefs.setString(_kTokenKey, value.token!);
+    } else {
+      await prefs.remove(_kTokenKey);
+    }
+  }
+
+  @override
+  Future<Credentials?> read() async {
+    final prefs = await _prefs;
+    final userId = prefs.getString(_kUserIdKey);
+    final token = prefs.getString(_kTokenKey);
+    if (userId != null && token != null) {
+      return Credentials(id: userId, token: token);
+    }
+    return null;
+  }
+
+  @override
+  Future<void> clear() async {
+    final prefs = await _prefs;
+    await prefs.remove(_kUserIdKey);
+    await prefs.remove(_kTokenKey);
+  }
+}

package/templates/firebase/lib/core/theme/providers/theme_provider.dart

@@ -4,6 +4,8 @@ import 'package:kasy_kit/core/theme/colors.dart';
 import 'package:kasy_kit/core/theme/providers/kasy_theme.dart';
 import 'package:kasy_kit/core/theme/texts.dart';
 import 'package:kasy_kit/core/theme/theme_data/theme_data_factory.dart';
+import 'package:kasy_kit/core/theme/web_background_sync.dart'
+    if (dart.library.js_interop) 'package:kasy_kit/core/theme/web_background_sync_web.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 
 /// We use this to access the theme from the BuildContext in all our widgets
@@ -182,6 +184,7 @@ class AppTheme with ChangeNotifier, WidgetsBindingObserver {
         statusBarIconBrightness: isLight ? Brightness.dark : Brightness.light,
       ),
     );
+    syncWebBackgroundColor(isLight ? Brightness.light : Brightness.dark);
   }
 
   ThemeData get dark {

package/templates/firebase/lib/core/theme/web_background_sync.dart

@@ -0,0 +1,3 @@
+import 'package:flutter/material.dart';
+
+void syncWebBackgroundColor(Brightness brightness) {}

package/templates/firebase/lib/core/theme/web_background_sync_web.dart

@@ -0,0 +1,18 @@
+import 'package:flutter/material.dart';
+import 'package:web/web.dart' as web;
+
+void syncWebBackgroundColor(Brightness brightness) {
+  final color = brightness == Brightness.dark ? '#000000' : '#FFFFFF';
+  (web.document.documentElement as web.HTMLElement?)
+      ?.style
+      .setProperty('background-color', color);
+  web.document.body?.style.setProperty('background-color', color);
+  final views = web.document.querySelectorAll(
+    'flutter-view, flt-glass-pane, flt-scene-host',
+  );
+  for (var i = 0; i < views.length; i++) {
+    (views.item(i) as web.HTMLElement?)
+        ?.style
+        .setProperty('background-color', color);
+  }
+}

package/templates/firebase/lib/core/web_device_preview/web_device_preview.dart

@@ -237,8 +237,7 @@ class _WebDevicePreviewState extends State<WebDevicePreview> {
   }
 
   void _toggleInspector() {
-    WidgetsBinding.instance.debugShowWidgetInspectorOverride =
-        !WidgetsBinding.instance.debugShowWidgetInspectorOverride;
+    devInspectorActiveNotifier.value = !devInspectorActiveNotifier.value;
   }
 
   void _copyInspection() {
@@ -383,8 +382,7 @@ class _WebDevicePreviewState extends State<WebDevicePreview> {
                     _landscapeNotifier,
                     _textScaleNotifier,
                     _localeNotifier,
-                    WidgetsBinding.instance
-                        .debugShowWidgetInspectorOverrideNotifier,
+                    devInspectorActiveNotifier,
                   ]),
                   builder: (context, child) => _PreviewControls(
                     platform: _platform,
@@ -395,8 +393,7 @@ class _WebDevicePreviewState extends State<WebDevicePreview> {
                     isLandscape: _landscapeNotifier.value,
                     textScale: _textScaleNotifier.value,
                     currentLocale: _localeNotifier.value,
-                    inspectorEnabled: WidgetsBinding
-                        .instance.debugShowWidgetInspectorOverride,
+                    inspectorEnabled: devInspectorActiveNotifier.value,
                     onPlatformChanged: _setPlatform,
                     onPrev: _prev,
                     onNext: _next,

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

@@ -34,6 +34,12 @@ class FirebaseAuthenticationApi implements AuthenticationApi {
 
   @override
   Future<void> init() async {
+    if (kIsWeb) {
+      // Force LOCAL persistence (IndexedDB) on web. It's the default for the JS
+      // SDK, but Firebase's web bootstrap sometimes resets it to SESSION when
+      // the page loads through a service worker — being explicit avoids that.
+      await _auth.setPersistence(Persistence.LOCAL);
+    }
     _auth.userChanges().listen((event) {
       if (!hasInit) {
         hasInit = true;

package/templates/firebase/lib/features/home/home_components_page.dart

@@ -181,6 +181,7 @@ const Set<String> _kReadyComponents = <String>{
   'Button',
   'Card',
   'Checkbox',
+  'DatePicker',
   'Design System',
   'Dialog',
   'Hover',
@@ -205,6 +206,7 @@ const Set<String> _kWebReadyComponents = <String>{
   'Button',
   'Card',
   'Checkbox',
+  'DatePicker',
   'Design System',
   'Dialog',
   'Hover',
@@ -220,7 +222,6 @@ const Set<String> _kWebReadyComponents = <String>{
 const Set<String> _kUrgentComponents = <String>{
   'Switch',
   'Radio Group',
-  'DatePicker',
 };
 
 const List<_CatalogRow> _kCatalog = [
@@ -236,6 +237,7 @@ const List<_CatalogRow> _kCatalog = [
   _CatalogRow('Button'),
   _CatalogRow('Card'),
   _CatalogRow('Checkbox'),
+  _CatalogRow('DatePicker'),
   _CatalogRow('Dialog'),
   _CatalogRow('Hover'),
   _CatalogRow('Sidebar'),
@@ -246,7 +248,6 @@ const List<_CatalogRow> _kCatalog = [
   _CatalogRow('TextFieldOTP'),
   _CatalogRow('Toast'),
   // Prioridade: Urgente (_kUrgentComponents), A–Z
-  _CatalogRow('DatePicker'),
   _CatalogRow('Radio Group'),
   _CatalogRow('Switch'),
   _CatalogRow('Tabs'),