kasy-cli 1.39.0 → 1.40.0

package/lib/scaffold/CHANGELOG.json

@@ -1,4 +1,27 @@
 {
+  "1.40.0": {
+    "modules": {
+      "components": {
+        "pt": "Novo componente Kasy Menu (menu de ações) + Popover. É aquele menu suspenso de ações que se adapta sozinho à plataforma: no desktop abre como um balão ancorado no botão (popover), no celular vira bottom sheet. Cada item pode ter ícone, descrição, atalho de teclado e submenu; dá pra agrupar em seções (inclusive uma 'zona de perigo' para ações destrutivas, em vermelho) e usar seleção única ou múltipla. Apresente com showKasyMenu (adapta automático, mas dá pra forçar popover ou sheet). Já está registrado na tela de Componentes com preview.",
+        "en": "New Kasy Menu (action menu) + Popover component. It is the dropdown action menu that adapts to the platform on its own: on desktop it opens as a balloon anchored to the button (popover), on mobile it becomes a bottom sheet. Each item can have an icon, description, keyboard shortcut and submenu; you can group items into sections (including a red 'Danger zone' for destructive actions) and use single or multiple selection. Present it with showKasyMenu (adapts automatically, but you can force popover or sheet). Already registered on the Components screen with a preview.",
+        "es": "Nuevo componente Kasy Menu (menú de acciones) + Popover. Es ese menú desplegable de acciones que se adapta solo a la plataforma: en escritorio abre como un globo anclado al botón (popover), en el móvil se vuelve bottom sheet. Cada ítem puede tener icono, descripción, atajo de teclado y submenú; puedes agrupar ítems en secciones (incluida una 'zona de peligro' en rojo para acciones destructivas) y usar selección única o múltiple. Preséntalo con showKasyMenu (se adapta automáticamente, pero puedes forzar popover o sheet). Ya está registrado en la pantalla de Componentes con vista previa."
+      },
+      "core": {
+        "pt": "Navegação ganhou um observador de rotas compartilhado (KasyRouteObserver) no navigator raiz: as telas conseguem reagir quando voltam a aparecer depois que algo aberto por cima delas é fechado (via didPopNext). É a base que mantém o novo Kasy Menu se comportando direito ao abrir/fechar; já vem ligado no router.",
+        "en": "Navigation got a shared route observer (KasyRouteObserver) on the root navigator: screens can react when they are revealed again after something opened on top of them is dismissed (via didPopNext). It is the foundation that keeps the new Kasy Menu behaving correctly as it opens/closes; it comes wired into the router.",
+        "es": "La navegación ganó un observador de rutas compartido (KasyRouteObserver) en el navigator raíz: las pantallas pueden reaccionar cuando vuelven a aparecer luego de que algo abierto encima de ellas se cierra (vía didPopNext). Es la base que mantiene el nuevo Kasy Menu comportándose bien al abrir/cerrar; ya viene conectado en el router."
+      }
+    }
+  },
+  "1.39.1": {
+    "modules": {
+      "core": {
+        "pt": "Ajuste fino da proporção da web: a escala passou de 0.95 para 0.93 (a interface fica um pouco menor, mais perto do tamanho do app nativo). É só calibragem do mesmo knob único (kWebViewportScale) em todos os breakpoints; o nativo continua em 1.0 e dá pra desligar tudo numa linha (kWebViewportScaleEnabled).",
+        "en": "Fine-tuned the web proportion: the scale went from 0.95 to 0.93 (the interface is a touch smaller, closer to the native app size). It is just calibration of the same single knob (kWebViewportScale) across every breakpoint; native stays at 1.0 and the whole thing can be turned off in one line (kWebViewportScaleEnabled).",
+        "es": "Ajuste fino de la proporción web: la escala pasó de 0.95 a 0.93 (la interfaz queda un poco más pequeña, más cerca del tamaño del app nativo). Es solo calibración del mismo knob único (kWebViewportScale) en todos los breakpoints; el nativo se mantiene en 1.0 y todo se puede apagar en una línea (kWebViewportScaleEnabled)."
+      }
+    }
+  },
   "1.39.0": {
     "modules": {
       "core": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.39.0",
+  "version": "1.40.0",
   "description": "CLI for scaffolding production-ready Flutter SaaS apps with Firebase, Supabase, or API REST backends.",
   "bin": {
     "kasy": "./bin/kasy.js"

package/templates/firebase/.firebase/hosting.YnVpbGQvd2Vi.cache

@@ -4,7 +4,6 @@ local_notifications.js,1772398909034,0b44b177c4b8a705ad1b0e3d7532537aad7b230e947
 flutter.js,1777393608000,b42e549a02f5c1428b0ad85dbdc663d400a6d2db10cb8aefcc0fddd592fd6ceb
 firebase-messaging-sw.js,1772484605561,dba3c939f7c240e62f63d06408d5f70e45f1168d00df98726e6a7a20cbd3b0df
 favicon.png,1779810782545,c967afd3c3d4dd165ef2e5cf3f203c3982dfff6a95881859ed163d9c38d75512
-.last_build_id,1781475668120,4a8e13af757aaae5b1160a761d56555ef4370ca7572732cbfa8d98c989424ab0
 splash/img/light-4x.png,1780546027751,abf0e55345e532a4645fe14b01c2948b07c78df50cc6da23648837dfb6271c74
 splash/img/light-3x.png,1780546027699,5f02c94032cb7053807ce89603b109f14ea2740eaa3145dc76c924cbe1d534a9
 splash/img/light-2x.png,1780546027647,3c073b9da154ac8be530f8beefa3579246f223acd819e856a2db000fdabcb67e
@@ -47,29 +46,30 @@ assets/assets/images/icon_android.png,1779810762467,db0f6c9ff904d4571ab40d461100
 assets/assets/images/icon.png,1779745964920,194820ecc4eed7bac14b5605916d87093b4571a28f3ca24863ac09c783343488
 assets/assets/images/favicon.png,1779745964922,194820ecc4eed7bac14b5605916d87093b4571a28f3ca24863ac09c783343488
 assets/assets/images/empty_notifications.jpg,1772398653078,cbb7d57f7cf305cf33ee8cbd15544eb1020670a1a8100f1328b49ca61d76fb7e
-assets/assets/icons/google_play_games.png,1772398653083,533c1d87d7be8690ab173ef42aa92ee8bac3b6e6859c0f97fe30daff2c843501
-assets/assets/icons/google.png,1772398653083,f423e7e7be1e06008d45617d07f095f04da7fdcab9a56523f9e0633828e464e0
-assets/assets/icons/facebook.png,1772398653083,79ac67e449c1db63319d43329ca91f682b4e0bc6a0883b0dfb2a849e13ae6eb6
-assets/assets/icons/apple.png,1772398653083,2a737d8801ca81452b2978bb2e1ac72136acf1a4c338f2de2f77b65e9f6de1fa
-version.json,1781481118464,be3307736a7e600c6e90593352859f1c46bc97666d5cf21a16099effd2a0fed6
-flutter_service_worker.js,1781481120062,baeeaf9f4b8e6f40d3b0549429ceb70ca01f120db6a7ef2f60d5809233dc2205
-assets/FontManifest.json,1781481118640,4d84ab517c27984d36f9a3c8be6f2a72788c0c3985c1d5874297fef0a53407ca
-flutter_bootstrap.js,1781481074600,0955c783148666dcda1406de86f477f1f27ec80a4fc8186ba6cd9bd119d242f9
-assets/AssetManifest.bin,1781481118640,78bccb08a36307a400711a1d7e6868bd5f89a24e63439fb5b6747660323e4475
-index.html,1781481074612,bb8142eb84e9e44049957c3edf86006e1ae5f194c397a8326ce505b68fdf58f4
-assets/AssetManifest.bin.json,1781481118640,50a11b51c3fc4cbed1b5ec3a4f466c6a6b75c481d08d4782c8191f99bdbdba9c
-assets/shaders/stretch_effect.frag,1781481118746,1a7d4ac2be40cf0a459dfb390ef08bcd740f37913ffdee8de3c2ea836a18410e
-assets/shaders/ink_sparkle.frag,1781481118746,1c8e222328206d1e06754f76fb53947aad38d62180aafad5298a3c6f510b173d
-assets/packages/cupertino_icons/assets/CupertinoIcons.ttf,1781481119831,12bc6bf55aad4657f62747b6c1c9b5c120a594ed3540db21729b6db3c847340d
-assets/fonts/MaterialIcons-Regular.otf,1781481119828,0d07767255068e38fcf81755fd997bb15d94d6ef83bb81bd0149f974bfe359a0
-main.dart.js_3.part.js,1781481106966,7dd538a2118493eb8ff1a33ec5c2dd6d355a9a61290f1d8d1e6ad7bf8cc0465f
-main.dart.js_1.part.js,1781481106961,a9d49c1a6aff2181d2d352ebe6a64a58c776ece7784ca86546b17be94ffe42b0
-assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w100.ttf,1781481119830,c16d95412fe2600bda1f53c2b8dc4bd82496f60f7c5a6ecfa180b0f866128712
-assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w400.ttf,1781481119832,edcd01ee13f6ec2285fd18863c0ce0efb0876b290fb427ad5c052f753b3210c8
-assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w600.ttf,1781481119834,008f1e974c9ff4e8d40d16221226e0d34d2298a7feb2bdea8c134a9333929c9c
-assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w500.ttf,1781481119830,3f68f958d0fa13077968a6767339c38ede8705bcadd0382078db6ec4bac96fa0
-assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w300.ttf,1781481119832,aebf5e4f6b1e6de1e61a866f813aa5b08efb4cdd108cc2831d40aad71398c88f
-assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w200.ttf,1781481119830,1f798186cfc3e2fcd54b15aa7b8695bc7c29b781c5058029a8d80ecdfa615904
-assets/NOTICES,1781481118640,a18efc42c5ed99b56481537d0f229ddd3add671c548a893aaf8766f30c854158
-assets/packages/lucide_icons_flutter/assets/lucide.ttf,1781481119830,9b000e47cddf9ada4a6b85fc9577fef7ed2ee261c9279e9a44e4753da28f83d3
-main.dart.js,1781481107454,c98fad1aa11ff6a9335379794ac025a501060a6759943e74365f185cc7a5e8ce
+version.json,1781504123531,9c8bda011bf76cc12c7484af634650c1bddbb07450efd617f39b2ba26ee338ec
+flutter_service_worker.js,1781504124974,baeeaf9f4b8e6f40d3b0549429ceb70ca01f120db6a7ef2f60d5809233dc2205
+flutter_bootstrap.js,1781504070895,8f179b4fd4e2445cb3847d5c5d50f3494b9431636e2c741ce4dca87bdef2efcc
+index.html,1781504070910,bb8142eb84e9e44049957c3edf86006e1ae5f194c397a8326ce505b68fdf58f4
+.last_build_id,1781504125200,fb2a0536078d7023bcc9d41eb14cc00d74532f9465fac7aa9b88dae42e4a249c
+assets/AssetManifest.bin.json,1781504123707,dde7c9126864005877d3ddb3598257c32685e77e36d1586f4441152e19553aef
+assets/FontManifest.json,1781504123706,4d84ab517c27984d36f9a3c8be6f2a72788c0c3985c1d5874297fef0a53407ca
+assets/AssetManifest.bin,1781504123706,b4a445b9a7980358e4e684ecb630fe913953f0ae9d710f1680e6c4cc351c6f50
+assets/shaders/stretch_effect.frag,1781504123803,1a7d4ac2be40cf0a459dfb390ef08bcd740f37913ffdee8de3c2ea836a18410e
+assets/shaders/ink_sparkle.frag,1781504123803,1c8e222328206d1e06754f76fb53947aad38d62180aafad5298a3c6f510b173d
+assets/packages/cupertino_icons/assets/CupertinoIcons.ttf,1781504124761,12bc6bf55aad4657f62747b6c1c9b5c120a594ed3540db21729b6db3c847340d
+assets/assets/icons/facebook.svg,1781501956480,3ab79cd57328f232a9aa93936936529716bf4b201897f3b6eae67484af4da871
+assets/assets/icons/google.svg,1781501956480,aad117cb37a3246dda5ad42e20ad27fafa7fbf7e68215abd3a5a32aed09c53d9
+assets/assets/icons/apple_white.svg,1781501956479,3ba907c614ab6feed0ada8c0617ac1fb0673640436e112be09fad8010cb9a977
+assets/assets/icons/apple_black.svg,1781501956479,1831370c613783b8e26217b69701ca0a4a61d081479a1345ae3b13f2f4b39022
+assets/fonts/MaterialIcons-Regular.otf,1781504124775,63e747df6278f4804031880bd30f6837ae2768e3912afb5328b553fb9ed381c7
+main.dart.js_3.part.js,1781504109925,8b5c438ea9b1cffe57a96cba936c34f7b0f2c16045339ea87fb32db6e1463c1f
+main.dart.js_1.part.js,1781504109916,188da12a7134009601f42c62f1d3cf38e9ebeafe0bfcaf5d32aed852e1c841d0
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w100.ttf,1781504124774,c16d95412fe2600bda1f53c2b8dc4bd82496f60f7c5a6ecfa180b0f866128712
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w600.ttf,1781504124766,008f1e974c9ff4e8d40d16221226e0d34d2298a7feb2bdea8c134a9333929c9c
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w400.ttf,1781504124764,edcd01ee13f6ec2285fd18863c0ce0efb0876b290fb427ad5c052f753b3210c8
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w500.ttf,1781504124763,3f68f958d0fa13077968a6767339c38ede8705bcadd0382078db6ec4bac96fa0
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w300.ttf,1781504124769,aebf5e4f6b1e6de1e61a866f813aa5b08efb4cdd108cc2831d40aad71398c88f
+assets/packages/lucide_icons_flutter/assets/build_font/LucideVariable-w200.ttf,1781504124774,1f798186cfc3e2fcd54b15aa7b8695bc7c29b781c5058029a8d80ecdfa615904
+assets/NOTICES,1781504123707,6ca6b928af7f7208b55e193e670cc5ff8335ec7ef7fa895fbae99609ba9f769d
+assets/packages/lucide_icons_flutter/assets/lucide.ttf,1781504124772,9b000e47cddf9ada4a6b85fc9577fef7ed2ee261c9279e9a44e4753da28f83d3
+main.dart.js,1781504110701,17f0df6beb2983f6a15b397718bf04a9078c12c4d98d83f71866ae15097f6e38

package/templates/firebase/AGENTS.md

@@ -64,8 +64,8 @@ Typography collapses `large`+`xlarge` into one "desktop" tier (same sizes); the
 - **Native mobile** is straightforward: it's the Mobile breakpoint and never
   scales the viewport.
 - **Web render scale** (`WebViewportScale`) is a *separate* concern: Flutter web
-  renders ~10% large, so **desktop only** scales the whole UI to `0.95`. Tablet
-  and mobile web render at natural size, like native. This is NOT the typography
+  renders ~10% large at every width, so the whole web UI (phone, tablet, desktop)
+  is scaled to `0.93`; native renders at natural `1.0`. This is NOT the typography
   scale — don't conflate the two.
 - **Screen width follows content type** (two tiers): read/form screens (Settings,
   Notifications) are contained + centred at `kKasyContentMaxWidth` (600) — set

package/templates/firebase/DESIGN_SYSTEM.md

@@ -107,11 +107,12 @@ separate concern from type sizes, sitting in a layer ON TOP of the responsive
 system — it does NOT replace breakpoints, the type ramp or spacing (turn it off
 and the app is still fully responsive, just larger). Flutter web renders ~10%
 larger than an equivalent native/HTML app at 100% zoom, **at every width**. So the
-whole web app — phone, tablet and desktop — is scaled to `0.95` (~5%; a true
+whole web app — phone, tablet and desktop — is scaled to `0.93` (~7%; a true
 viewport scale, so layout, scrolling and hit-testing stay correct), making web
 read close to the native baseline with **no size jump across breakpoints**. `0.90`
 fully undoes the 10% but reads small on a monitor (native sizes are tuned for a
-phone held close), so `0.95` (the midpoint) is the calibrated default. Two knobs:
+phone held close), so `0.93` (a touch past the midpoint, still short of a full
+undo) is the calibrated default. Two knobs:
 `kWebViewportScaleEnabled` (master on/off — `false` makes web render at native
 `1.0`) and `kWebViewportScale` (the value). Two things are never scaled, both at
 native `1.0`: **native** itself (gated on `kIsWeb`, so iOS/Android/macOS/Windows

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

@@ -1,11 +1,14 @@
 /// Kasy UI components — Material-backed wrappers with a stable kit API.
 ///
-/// Includes screen chrome ([KasyAppBar], [KasyOverlayScaffold], [kasyOverlayPaddedSlivers]).
+/// Includes screen chrome ([KasyAppBar], [KasyOverlayScaffold], [kasyOverlayPaddedSlivers])
+/// and its per-screen desktop config ([KasyAppBarConfig], [KasyAppBarConfigurator]).
 ///
 /// Import:
 ///   import 'package:kasy_kit/components/components.dart';
 library;
 
+export 'package:kasy_kit/core/chrome/app_bar_config.dart';
+export 'package:kasy_kit/core/chrome/app_bar_scope.dart';
 export 'kasy_accordion.dart';
 export 'kasy_alert.dart';
 export 'kasy_app_bar.dart';
@@ -21,7 +24,9 @@ export 'kasy_date_picker.dart';
 export 'kasy_dialog.dart';
 export 'kasy_drop_down.dart';
 export 'kasy_image_viewer.dart';
+export 'kasy_menu.dart';
 export 'kasy_otp_verification_bottom_sheet.dart';
+export 'kasy_popover.dart';
 export 'kasy_screen.dart';
 export 'kasy_sidebar.dart';
 export 'kasy_skeleton.dart';

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

@@ -810,6 +810,12 @@ class KasyOverlayScaffold extends StatelessWidget {
   /// the overlay pattern (bar floats over full-height scroll content).
   final bool hideAppBarOnScroll;
 
+  /// Desktop only: adapt the shell's application bar for this screen. Receives the
+  /// shell default; return e.g. `bar.only(search: true)`. No-op on phone/tablet
+  /// (there the page chrome above is what shows). Shortcut for wrapping the body
+  /// in a [KasyAppBarConfigurator].
+  final KasyAppBarConfigure? applicationBar;
+
   const KasyOverlayScaffold({
     super.key,
     required this.title,
@@ -826,6 +832,7 @@ class KasyOverlayScaffold extends StatelessWidget {
     this.onRefresh,
     this.refreshIndicatorDisplacement = 48,
     this.hideAppBarOnScroll = false,
+    this.applicationBar,
   });
 
   @override
@@ -856,7 +863,7 @@ class KasyOverlayScaffold extends StatelessWidget {
         child: scrollView,
       );
     }
-    return Scaffold(
+    final Widget scaffold = Scaffold(
       backgroundColor: bg,
       body: Stack(
         fit: StackFit.expand,
@@ -878,6 +885,9 @@ class KasyOverlayScaffold extends StatelessWidget {
         ],
       ),
     );
+    final KasyAppBarConfigure? configure = applicationBar;
+    if (configure == null) return scaffold;
+    return KasyAppBarConfigurator(configure: configure, child: scaffold);
   }
 }
 

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

@@ -188,13 +188,31 @@ class KasyBottomSheet extends StatelessWidget {
                   ],
                   if (actions.isNotEmpty) ...[
                     const SizedBox(height: KasySpacing.lg),
-                    ...actions.expand(
-                      (w) => [
-                        w,
-                        if (w != actions.last)
-                          const SizedBox(height: KasySpacing.sm),
-                      ],
-                    ),
+                    // As a desktop dialog, a non-icon form (e.g. edit name,
+                    // create password) lays its buttons side by side with the
+                    // primary on the right — the desktop convention — instead of
+                    // the mobile full-width stack. Icon sheets stay stacked
+                    // (they read as alerts, where stacked full-width is right).
+                    // actions are authored primary-first (stack puts it on top),
+                    // so reverse them here to land cancel-left / confirm-right.
+                    if (floating && !hasIcon && actions.length >= 2)
+                      Row(
+                        children: [
+                          for (int i = actions.length - 1; i >= 0; i--) ...[
+                            if (i < actions.length - 1)
+                              const SizedBox(width: KasySpacing.sm),
+                            Expanded(child: actions[i]),
+                          ],
+                        ],
+                      )
+                    else
+                      ...actions.expand(
+                        (w) => [
+                          w,
+                          if (w != actions.last)
+                            const SizedBox(height: KasySpacing.sm),
+                        ],
+                      ),
                   ],
                 ],
               ),