kasy-cli 1.38.0 → 1.39.1

package/templates/firebase/lib/main.dart

@@ -199,13 +199,26 @@ class _MyAppState extends ConsumerState<MyApp> {
                     facebookEventApiProvider,
                   ],
                   onReady: FocusVisibility(
-                    child: WebViewportScale.wrap(
-                      DevicePreview.appBuilder(
-                        context,
-                        ResponsiveTextTheme(
-                          child: child ?? const SizedBox.shrink(),
-                        ),
-                      ),
+                    child: ValueListenableBuilder<bool>(
+                      valueListenable: webDevicePreviewActiveNotifier,
+                      builder: (context, devicePreviewActive, _) {
+                        final Widget app = DevicePreview.appBuilder(
+                          context,
+                          ResponsiveTextTheme(
+                            child: child ?? const SizedBox.shrink(),
+                          ),
+                        );
+                        // The web render-scale correction applies to the REAL
+                        // web app on every breakpoint. Once the device preview
+                        // frame is actually on screen it simulates a NATIVE
+                        // device, so it renders at native 1.0 — skip the scale.
+                        // Gated on the *active* (frame-built) notifier, not the
+                        // raw toggle, so the scale only drops when the frame is
+                        // up (no flash of big unframed app while it builds).
+                        return devicePreviewActive
+                            ? app
+                            : WebViewportScale.wrap(app);
+                      },
                     ),
                   ),
                   onError: (_, error) => InitializationErrorPage(error: error),

package/templates/firebase/lib/router.dart

@@ -220,7 +220,11 @@ GoRouter generateRouter({
         path: '/onboarding',
         pageBuilder: (context, state) => kasyTransitionPage(
           key: state.pageKey,
-          child: const OnboardingPage(),
+          // ?preview=true opens the flow as a side-effect-free walkthrough from
+          // the admin Debug screen (no account creation, returns to Debug).
+          child: OnboardingPage(
+            preview: state.uri.queryParameters['preview'] == 'true',
+          ),
         ),
       ),
       GoRoute(
@@ -311,8 +315,7 @@ GoRouter generateRouter({
       // are ALL branches — each its own URL, reached from the sidebar. Registered
       // always (admins reach it in release too); the redirect above blocks
       // /admin* for non-admins in production. adminSections() is the single
-      // source the sidebar reads too, so branches and nav rows stay aligned (the
-      // debug-only sections drop out of both together).
+      // source the sidebar reads too, so branches and nav rows stay aligned.
       StatefulShellRoute.indexedStack(
         // Enter /admin with the app's standard page transition
         // (KasyNavigationConfig.push), same as every other route — pageBuilder
@@ -338,8 +341,32 @@ GoRouter generateRouter({
         ],
       ),
       // Drill-downs pushed full-screen from inside the console (their own back
-      // button), debug-only — the redirect above keeps /admin* admin-only.
-      if (kDebugMode) ...[
+      // button) — the redirect above keeps /admin* admin-only.
+      //
+      // Paywall variant preview is pushed from the Paywalls section, which ships
+      // in production, so it's registered always.
+      GoRoute(
+        name: 'admin_premium_preview',
+        path: '/admin/premium/:variant',
+        pageBuilder: (context, state) {
+          final paywall = paywallFactoryFromAdminRoute(
+            state.pathParameters['variant'],
+          );
+          if (paywall == null || !withRevenuecat) {
+            return kasyTransitionPage(
+              key: state.pageKey,
+              child: const PageNotFound(),
+            );
+          }
+          return kasyTransitionPage(
+            key: state.pageKey,
+            child: PremiumPage(paywall: paywall),
+          );
+        },
+      ),
+      // Home-widgets panel: developer-only, pushed from the Debug section's
+      // (debug-gated) tile — its route registers only in kDebugMode.
+      if (kDebugMode)
         GoRoute(
           name: 'admin_home_widgets',
           path: adminRouteHomeWidgets,
@@ -348,27 +375,6 @@ GoRouter generateRouter({
             child: const AdminHomeWidgets(),
           ),
         ),
-        // Paywall variant preview — pushed from the Paywalls section.
-        GoRoute(
-          name: 'admin_premium_preview',
-          path: '/admin/premium/:variant',
-          pageBuilder: (context, state) {
-            final paywall = paywallFactoryFromAdminRoute(
-              state.pathParameters['variant'],
-            );
-            if (paywall == null || !withRevenuecat) {
-              return kasyTransitionPage(
-                key: state.pageKey,
-                child: const PageNotFound(),
-              );
-            }
-            return kasyTransitionPage(
-              key: state.pageKey,
-              child: PremiumPage(paywall: paywall),
-            );
-          },
-        ),
-      ],
       GoRoute(
         name: '404',
         path: '/404',

package/templates/firebase/pubspec.yaml

@@ -16,7 +16,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
-version: 1.0.0+60
+version: 1.0.0+67
 
 environment:
   sdk: ^3.11.0
@@ -59,6 +59,7 @@ dependencies:
   flutter_native_splash: ^2.4.7
   flutter_riverpod: ^3.1.0
   flutter_secure_storage: ^9.2.4
+  flutter_svg: ^2.3.0
   flutter_timezone: ^5.0.1
   freezed_annotation: ^3.1.0
   go_router: ^17.1.0

package/templates/firebase/test/admin_shell_chrome_test.dart

@@ -1,8 +1,8 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:go_router/go_router.dart';
+import 'package:kasy_kit/components/kasy_app_bar.dart';
 import 'package:kasy_kit/components/kasy_sidebar.dart';
-import 'package:kasy_kit/components/kasy_web_header.dart';
 import 'package:kasy_kit/core/data/models/user.dart';
 import 'package:kasy_kit/core/states/models/user_state.dart';
 import 'package:kasy_kit/features/settings/ui/components/admin/admin_page.dart';
@@ -49,9 +49,15 @@ UserState _adminUser() => UserState(
   ),
 );
 
+/// The desktop application bar is a [KasyAppBar.application] — same class as the
+/// page bar, told apart by [KasyAppBar.isApplication].
+final Finder _applicationBar = find.byWidgetPredicate(
+  (Widget w) => w is KasyAppBar && w.isApplication,
+);
+
 void main() {
   testWidgets(
-    'admin section (desktop) renders the real KasySidebar + KasyWebHeader',
+    'admin section (desktop) renders the real KasySidebar + application bar',
     (tester) async {
       tester.view.physicalSize = const Size(1400, 900);
       tester.view.devicePixelRatio = 1.0;
@@ -66,7 +72,7 @@ void main() {
 
       // The console uses the app's real chrome components, not a bespoke copy.
       expect(find.byType(KasySidebar), findsOneWidget);
-      expect(find.byType(KasyWebHeader), findsOneWidget);
+      expect(_applicationBar, findsOneWidget);
       expect(find.text('section-overview'), findsOneWidget);
     },
   );
@@ -87,9 +93,9 @@ void main() {
       await tester.pump(const Duration(milliseconds: 300));
 
       // Tools sub-screens get the SAME chrome as every other section now (the
-      // whole point of this change): the persistent rail AND the web header.
+      // whole point of this change): the persistent rail AND the application bar.
       expect(find.byType(KasySidebar), findsOneWidget);
-      expect(find.byType(KasyWebHeader), findsOneWidget);
+      expect(_applicationBar, findsOneWidget);
       expect(find.text('section-sendPush'), findsOneWidget);
 
       // The rail shows the "Ferramentas" group, auto-expanded because one of its

package/templates/firebase/test/app_bar_config_test.dart

@@ -0,0 +1,70 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:kasy_kit/components/components.dart';
+
+/// The per-screen desktop bar override is just data: a screen transforms the
+/// shell default into its own [KasyAppBarConfig]. These lock that logic.
+void main() {
+  group('KasyAppBarConfig', () {
+    test('bare config shows every element (mirrors the shell default)', () {
+      const KasyAppBarConfig c = KasyAppBarConfig();
+      expect(c.showSearch, isTrue);
+      expect(c.showThemeToggle, isTrue);
+      expect(c.showNotifications, isTrue);
+      expect(c.showCreate, isTrue);
+      expect(c.showAvatar, isTrue);
+    });
+
+    test('only() shows just the listed elements but keeps their wiring', () {
+      void bell() {}
+      void toggle() {}
+      final KasyAppBarConfig base = KasyAppBarConfig(
+        onNotifications: bell,
+        onToggleTheme: toggle,
+      );
+
+      final KasyAppBarConfig cfg = base.only(notifications: true, themeToggle: true);
+
+      expect(cfg.showNotifications, isTrue);
+      expect(cfg.showThemeToggle, isTrue);
+      expect(cfg.showSearch, isFalse);
+      expect(cfg.showCreate, isFalse);
+      expect(cfg.showAvatar, isFalse);
+      // The shell's bell/theme callbacks survive the override.
+      expect(cfg.onNotifications, same(bell));
+      expect(cfg.onToggleTheme, same(toggle));
+    });
+
+    test('search preset = search + theme only', () {
+      const KasyAppBarConfig cfg = KasyAppBarConfig.search();
+      expect(cfg.showSearch, isTrue);
+      expect(cfg.showThemeToggle, isTrue);
+      expect(cfg.showNotifications, isFalse);
+      expect(cfg.showCreate, isFalse);
+      expect(cfg.showAvatar, isFalse);
+    });
+
+    test('minimal preset = theme toggle only', () {
+      const KasyAppBarConfig cfg = KasyAppBarConfig.minimal();
+      expect(cfg.showThemeToggle, isTrue);
+      expect(cfg.showSearch, isFalse);
+      expect(cfg.showNotifications, isFalse);
+      expect(cfg.showCreate, isFalse);
+      expect(cfg.showAvatar, isFalse);
+    });
+
+    test('copyWith with no changes is value-equal (no churn on the bar)', () {
+      const KasyAppBarConfig a = KasyAppBarConfig();
+      final KasyAppBarConfig b = a.copyWith();
+      expect(a, equals(b));
+      expect(a.hashCode, equals(b.hashCode));
+    });
+
+    test('copyWith changes only the named field', () {
+      const KasyAppBarConfig a = KasyAppBarConfig();
+      final KasyAppBarConfig b = a.copyWith(showSearch: false);
+      expect(b.showSearch, isFalse);
+      expect(b.showCreate, isTrue);
+      expect(a == b, isFalse);
+    });
+  });
+}

package/templates/firebase/test/components/kasy_text_field_height_test.dart

@@ -0,0 +1,77 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:kasy_kit/components/kasy_text_field.dart';
+import 'package:kasy_kit/core/theme/colors.dart';
+import 'package:kasy_kit/core/theme/providers/theme_provider.dart';
+import 'package:kasy_kit/core/theme/responsive_text_theme.dart';
+import 'package:kasy_kit/core/theme/texts.dart';
+import 'package:kasy_kit/core/theme/universal_theme.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+
+import '../device_test_utils.dart';
+
+/// A single-line [KasyTextField] must render at exactly
+/// [KasyTextField.singleLineHeight] on EVERY breakpoint. The height is locked
+/// with a forced strut (see kasy_text_field.dart) precisely so it cannot drift
+/// between renderers (web CanvasKit vs native) or viewport widths. Run this on
+/// the VM and with `--platform chrome` to cover both renderers.
+void main() {
+  Widget appWithField() {
+    return Builder(builder: (context) {
+      return MaterialApp(
+        theme: ThemeProvider.of(context).light,
+        home: const ResponsiveTextTheme(
+          child: Scaffold(
+            body: Center(
+              child: SizedBox(
+                width: 320,
+                child: KasyTextField(
+                  hint: 'Email',
+                  variant: KasyTextFieldVariant.flat,
+                ),
+              ),
+            ),
+          ),
+        ),
+      );
+    });
+  }
+
+  testWidgets('single-line field height stays locked across breakpoints',
+      (tester) async {
+    SharedPreferences.setMockInitialValues({});
+    final sharedPrefs = await SharedPreferences.getInstance();
+
+    final widget = ThemeProvider(
+      notifier: AppTheme.uniform(
+        sharedPreferences: sharedPrefs,
+        themeFactory: const UniversalThemeFactory(),
+        lightColors: KasyColors.light(),
+        darkColors: KasyColors.dark(),
+        textTheme: KasyTextTheme.build(),
+        defaultMode: ThemeMode.light,
+      ),
+      child: appWithField(),
+    );
+
+    const breakpoints = <Device>[
+      Device(name: 'mobile', width: 375, height: 812, pixelDensity: 3),
+      Device(name: 'tablet', width: 800, height: 1024, pixelDensity: 2),
+      Device(name: 'desktop', width: 1400, height: 900, pixelDensity: 1),
+    ];
+
+    for (final device in breakpoints) {
+      await tester.setScreenSize(device);
+      await tester.pumpWidget(widget);
+      await tester.pumpAndSettle();
+      final double boxHeight =
+          tester.getSize(find.byType(TextField).first).height;
+      expect(
+        boxHeight,
+        KasyTextField.singleLineHeight,
+        reason: 'field box should be ${KasyTextField.singleLineHeight}px on '
+            '${device.name} (${device.width}px wide), got $boxHeight',
+      );
+    }
+  });
+}

package/templates/firebase/test/core/web_viewport_scale_test.dart

@@ -1,28 +1,34 @@
 import 'package:flutter_test/flutter_test.dart';
 import 'package:kasy_kit/core/web_viewport_scale.dart';
 
-/// Locks the desktop web scaling behaviour so a future change to the constants or
-/// the formula can't silently regress it. The headline rule, and the bug this
-/// guards against: the desktop compensation must key off the SCREEN width (OS
-/// scale), NOT the window width — merely resizing the browser window must not
-/// shrink the UI; the extra shrink happens only when the screen itself is small.
+/// Locks the web scaling behaviour so a future change to the constants or the
+/// formula can't silently regress it. Two headline rules:
+/// - the flat cap applies on EVERY web breakpoint (phone/tablet/desktop) so the
+///   whole web app matches native, with no size jump at the desktop breakpoint;
+/// - the desktop high-OS-scale compensation must key off the SCREEN width, NOT
+///   the window width — merely resizing the browser window must not shrink the
+///   UI further; the extra shrink happens only when the screen itself is small.
 void main() {
   group('webViewportEffectiveScale', () {
-    test('no scaling below the desktop breakpoint (mobile/tablet web == native)',
+    test('flat cap applies on tablet/phone web too (no jump at the breakpoint)',
         () {
-      // The window width decides the breakpoint (the layout follows the window),
-      // so below it the scale is 1.0 regardless of the screen — same as native
-      // and the device preview.
-      expect(webViewportEffectiveScale(375), 1.0); // phone
-      expect(webViewportEffectiveScale(900), 1.0); // tablet
-      expect(webViewportEffectiveScale(900, screenWidth: 1470), 1.0);
+      // Below the desktop breakpoint the scale is the flat cap (not 1.0): the
+      // same ~10% web oversize is corrected, and there is no size jump when the
+      // window crosses the desktop breakpoint. Compensation is desktop-only, so
+      // the screen width is ignored here.
+      expect(webViewportEffectiveScale(375), kWebViewportScale); // phone
+      expect(webViewportEffectiveScale(900), kWebViewportScale); // tablet
+      expect(webViewportEffectiveScale(900, screenWidth: 1470), kWebViewportScale);
+      // A small screen does NOT compensate below the breakpoint — that is a
+      // desktop-only concern; tablet/phone always take the flat cap.
+      expect(webViewportEffectiveScale(900, screenWidth: 300), kWebViewportScale);
       expect(
         webViewportEffectiveScale(kWebViewportScaleDesktopBreakpoint - 1),
-        1.0,
+        kWebViewportScale,
       );
     });
 
-    test('desktop on a normal/large screen stays at the flat cap (0.95)', () {
+    test('desktop on a normal/large screen stays at the flat cap', () {
       // Unknown screen (null) → flat cap.
       expect(webViewportEffectiveScale(1280), kWebViewportScale);
       expect(webViewportEffectiveScale(1500), kWebViewportScale);
@@ -43,7 +49,7 @@ void main() {
     });
 
     test('high OS scale (small SCREEN) compensates below the cap', () {
-      // Drop below 0.95 only because the screen is small — independent of window.
+      // Drop below the cap only because the screen is small — independent of window.
       expect(webViewportEffectiveScale(1024, screenWidth: 1024), closeTo(0.80, 1e-4));
       expect(webViewportEffectiveScale(1097, screenWidth: 1097), closeTo(0.857, 1e-3));
       // Even a wide window on a small (high-scale) screen compensates.
@@ -58,7 +64,8 @@ void main() {
     });
 
     test('the maxScale override is respected as the cap', () {
-      expect(webViewportEffectiveScale(1920, screenWidth: 1920, maxScale: 0.9), 0.9);
+      // Use a non-default cap so this genuinely exercises the override.
+      expect(webViewportEffectiveScale(1920, screenWidth: 1920, maxScale: 0.8), 0.8);
     });
 
     test('an absurdly small screen is clamped to the 0.5 floor', () {

package/templates/firebase/tool/design_check.dart

@@ -77,6 +77,15 @@ final List<_Rule> _rules = <_Rule>[
     RegExp(r'Color\(0x|(?<![A-Za-z])Colors\.(?!transparent\b)(?!white)(?!black)[A-Za-z]'),
     'Use a colour token (context.colors.*) instead of a raw Color/Colors value.',
   ),
+  _Rule(
+    'hardcoded-radius',
+    // A numeric literal right after `circular(` — catches BorderRadius.circular(16),
+    // Radius.circular(8) and the only/vertical/horizontal forms (they nest a
+    // Radius.circular). `circular(KasyRadius.lg)` starts with a letter, so it
+    // passes; `circular(size / 2)` likewise (calibrated, not a token miss).
+    RegExp(r'\bcircular\(\s*\d'),
+    'Use a KasyRadius.* token instead of a literal corner radius.',
+  ),
 ];
 
 // The icon rule needs two signals on the same line, so it is handled separately.

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

@@ -1,218 +0,0 @@
-/// Application top header for the **web desktop breakpoint** (viewport ≥ 1024px).
-///
-/// This is the *application* chrome (global search, quick-create, notifications,
-/// profile) — distinct from [KasyAppBar], which is *page* chrome (title / back /
-/// theme) used on phone and tablet. On desktop the sidebar handles navigation,
-/// so this header carries global actions instead of a title or back button.
-///
-/// Composed entirely from existing kit widgets: a [KasyTextField] search box
-/// (fixed 220px), a ghost [KasyButton.iconOnly] for notifications, a neutral
-/// pill [KasyButton] for create, and a gradient [KasyAvatar].
-///
-/// Barrel: [components.dart].
-library;
-
-import 'package:flutter/material.dart';
-import 'package:kasy_kit/components/kasy_avatar.dart';
-import 'package:kasy_kit/components/kasy_avatar_presets.dart';
-import 'package:kasy_kit/components/kasy_button.dart';
-import 'package:kasy_kit/components/kasy_text_field.dart';
-import 'package:kasy_kit/core/theme/theme.dart';
-
-/// Total header height (matches the design: 36px content band + 16px top/bottom).
-const double kasyWebHeaderHeight = 68;
-
-/// Fixed width of the leading search field (matches the design).
-const double kasyWebHeaderSearchWidth = 220;
-
-/// Desktop application header. Place it at the top of the content area (to the
-/// right of the sidebar) on viewports ≥ 1024px.
-class KasyWebHeader extends StatelessWidget {
-  /// Controller for the search field. Optional — omit for a display-only header.
-  final TextEditingController? searchController;
-
-  /// Placeholder shown in the search field.
-  final String searchHint;
-
-  /// Called as the user types in the search field.
-  final ValueChanged<String>? onSearchChanged;
-
-  /// Called when the search field is submitted (Enter).
-  final ValueChanged<String>? onSearchSubmitted;
-
-  /// Notifications (bell) action. When null the bell is disabled. Ignored when
-  /// [notifications] is provided.
-  final VoidCallback? onNotifications;
-
-  /// Shows the unread dot on the notifications bell. Ignored when
-  /// [notifications] is provided.
-  final bool showNotificationBadge;
-
-  /// Custom notifications control. When set, it replaces the built-in bell —
-  /// pass a data-aware widget (e.g. a bell that opens a recent-notifications
-  /// dropdown) so the header itself stays a pure presentational component.
-  final Widget? notifications;
-
-  /// Primary quick-create action. When null the button is disabled.
-  final VoidCallback? onCreate;
-
-  /// Label for the create button.
-  final String createLabel;
-
-  /// Gradient used for the profile avatar fallback (when [avatar] is null).
-  final KasyAvatarGradientData avatarGradient;
-
-  /// Custom avatar widget — pass the signed-in user's avatar (e.g.
-  /// `KasyUserAvatar`) to show their real photo. When null (and [showAvatar] is
-  /// true), a gradient-fill avatar is shown instead.
-  final Widget? avatar;
-
-  /// Whether the profile avatar is shown at all. Set false for a header that
-  /// carries no account chip (e.g. when the sidebar already owns the profile).
-  final bool showAvatar;
-
-  /// Profile avatar tap (open menu / profile). When null the avatar is inert.
-  final VoidCallback? onAvatarTap;
-
-  /// Theme toggle. When set, a sun/moon ghost button is shown before the bell
-  /// (on desktop the web header replaces the app bar's theme toggle).
-  final VoidCallback? onToggleTheme;
-
-  const KasyWebHeader({
-    super.key,
-    this.searchController,
-    this.searchHint = 'Search...',
-    this.onSearchChanged,
-    this.onSearchSubmitted,
-    this.onNotifications,
-    this.showNotificationBadge = false,
-    this.notifications,
-    this.onCreate,
-    this.createLabel = 'Create',
-    this.avatarGradient = KasyAvatarGradients.orange,
-    this.avatar,
-    this.showAvatar = true,
-    this.onAvatarTap,
-    this.onToggleTheme,
-  });
-
-  @override
-  Widget build(BuildContext context) {
-    final KasyColors c = context.colors;
-    return DecoratedBox(
-      decoration: BoxDecoration(
-        // Matches KasySidebar exactly: surface fill + the same `border` hairline
-        // used by the sidebar's vertical edge line, at the same 0.5px width — so
-        // the header's bottom border and the sidebar's top divider read as one
-        // continuous line across the whole chrome in light and dark.
-        color: c.surface,
-        border: Border(
-          bottom: BorderSide(color: c.border, width: 0.5),
-        ),
-      ),
-      // minHeight (not a fixed height) keeps the band at 68 while letting the
-      // search field size naturally, so it never overflows the toolbar row.
-      child: ConstrainedBox(
-        constraints: const BoxConstraints(minHeight: kasyWebHeaderHeight),
-        child: Padding(
-          // Design gutters: 20px horizontal; vertical breathes around the field.
-          padding: const EdgeInsets.symmetric(horizontal: 20, vertical: 12),
-          child: Row(
-            children: [
-              SizedBox(
-                width: kasyWebHeaderSearchWidth,
-                child: _buildSearch(context),
-              ),
-              const Spacer(),
-              if (onToggleTheme != null) ...[
-                _buildThemeToggle(context),
-                const SizedBox(width: KasySpacing.md),
-              ],
-              notifications ?? _buildNotifications(context),
-              const SizedBox(width: KasySpacing.md),
-              KasyButton(
-                label: createLabel,
-                variant: KasyButtonVariant.neutral,
-                size: KasyButtonSize.small,
-                onPressed: onCreate,
-              ),
-              if (showAvatar) ...[
-                const SizedBox(width: KasySpacing.md),
-                avatar ??
-                    KasyAvatar.gradientFill(
-                      size: KasyAvatarSize.small,
-                      diameter: 36,
-                      gradient: avatarGradient,
-                      showShadow: false,
-                      onTap: onAvatarTap,
-                    ),
-              ],
-            ],
-          ),
-        ),
-      ),
-    );
-  }
-
-  Widget _buildSearch(BuildContext context) {
-    return KasyTextField(
-      variant: KasyTextFieldVariant.flat,
-      controller: searchController,
-      hint: searchHint,
-      onChanged: onSearchChanged,
-      onSubmitted: onSearchSubmitted,
-      prefix: Icon(
-        KasyIcons.search,
-        size: KasyIconSize.md,
-        color: context.colors.muted,
-      ),
-      contentPadding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
-    );
-  }
-
-  Widget _buildThemeToggle(BuildContext context) {
-    final bool isDark = Theme.of(context).brightness == Brightness.dark;
-    return KasyButton.iconOnly(
-      icon: isDark ? KasyIcons.lightMode : KasyIcons.darkMode,
-      variant: KasyButtonVariant.ghost,
-      size: KasyButtonSize.small,
-      iconOnlyLayoutExtent: 36,
-      iconGlyphSize: KasyIconSize.md,
-      onPressed: onToggleTheme,
-      semanticLabel: isDark ? 'Light mode' : 'Dark mode',
-    );
-  }
-
-  Widget _buildNotifications(BuildContext context) {
-    final KasyColors c = context.colors;
-    final Widget bell = KasyButton.iconOnly(
-      icon: KasyIcons.notification,
-      variant: KasyButtonVariant.ghost,
-      size: KasyButtonSize.small,
-      iconOnlyLayoutExtent: 36,
-      iconGlyphSize: KasyIconSize.md,
-      onPressed: onNotifications,
-      semanticLabel: 'Notifications',
-    );
-    if (!showNotificationBadge) return bell;
-    return Stack(
-      clipBehavior: Clip.none,
-      children: [
-        bell,
-        Positioned(
-          top: 8,
-          right: 8,
-          child: Container(
-            width: 8,
-            height: 8,
-            decoration: BoxDecoration(
-              color: c.error,
-              shape: BoxShape.circle,
-              border: Border.all(color: c.background, width: 1.5),
-            ),
-          ),
-        ),
-      ],
-    );
-  }
-}

package/templates/firebase/lib/core/chrome/web_header_scope.dart

@@ -1,20 +0,0 @@
-import 'package:flutter/widgets.dart';
-
-/// Marks the subtree that sits BELOW the desktop web header ([KasyWebHeader]) —
-/// i.e. the shell content area, provided by [WebContentWrapper].
-///
-/// [KasyAppBar] uses it to decide whether to hide on desktop: INSIDE this scope
-/// the web header already owns the top chrome, so the page app bar hides; OUTSIDE
-/// it (a full-screen pushed route with no web header above) the app bar stays
-/// visible — so the back button is never lost on desktop.
-class KasyWebHeaderScope extends InheritedWidget {
-  const KasyWebHeaderScope({super.key, required super.child});
-
-  /// True when a [KasyWebHeaderScope] is an ancestor (no rebuild dependency —
-  /// presence is fixed for a given subtree).
-  static bool of(BuildContext context) =>
-      context.getInheritedWidgetOfExactType<KasyWebHeaderScope>() != null;
-
-  @override
-  bool updateShouldNotify(KasyWebHeaderScope oldWidget) => false;
-}