kasy-cli 1.37.0 → 1.38.0

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

@@ -21,6 +21,53 @@ class DevInspectorInfo {
   final String? semanticWidget;
   final List<String> searchHints;
 
+  /// The widget's main color as a usable hex code (e.g. `#FC0303`), or null if
+  /// none is set. Raw `Color(...)` descriptions aren't useful to a dev — a hex
+  /// is. Text content / labels are intentionally NOT surfaced: they're already
+  /// visible on screen, so repeating them just adds noise.
+  String? get colorHex {
+    for (final p in properties) {
+      final int i = p.indexOf(':');
+      if (i <= 0) continue;
+      if (!p.substring(0, i).toLowerCase().contains('color')) continue;
+      final hex = _parseColorHex(p.substring(i + 1));
+      if (hex != null) return hex;
+    }
+    return null;
+  }
+
+  static String? _parseColorHex(String raw) {
+    // Legacy form: Color(0xAARRGGBB)
+    final legacy = RegExp('0x([0-9a-fA-F]{8})').firstMatch(raw);
+    if (legacy != null) {
+      final v = legacy.group(1)!.toUpperCase();
+      return v.startsWith('FF') ? '#${v.substring(2)}' : '#$v';
+    }
+    // Modern form: Color(alpha: 1.0, red: 0.98, green: 0.0, blue: 0.0, …)
+    double? comp(String key) {
+      final m = RegExp('$key:\\s*([0-9.]+)').firstMatch(raw);
+      return m == null ? null : double.tryParse(m.group(1)!);
+    }
+
+    final r = comp('red');
+    final g = comp('green');
+    final b = comp('blue');
+    if (r == null || g == null || b == null) return null;
+    final a = comp('alpha');
+    String h(double v) =>
+        (v * 255).round().clamp(0, 255).toRadixString(16).padLeft(2, '0').toUpperCase();
+    final rgb = '${h(r)}${h(g)}${h(b)}';
+    return (a == null || a >= 0.999) ? '#$rgb' : '#${h(a)}$rgb';
+  }
+
+  /// Compact size string: `w×h` (logical pixels), e.g. `44×44`. Position is
+  /// intentionally omitted — it isn't useful when identifying/editing a widget.
+  String get sizeLabel {
+    final w = boundingBox.width.toStringAsFixed(0);
+    final h = boundingBox.height.toStringAsFixed(0);
+    return '$w×$h';
+  }
+
   String toAIClipboard({String? routeName}) {
     final buf = StringBuffer();
     buf.writeln('## Inspected widget');

package/templates/firebase/lib/core/icons/kasy_icons.dart

@@ -87,7 +87,11 @@ abstract final class KasyIcons {
   static const IconData moreVert = LucideIcons.ellipsisVertical300;
   static const IconData microphone = LucideIcons.mic300;
   static const IconData northEast = LucideIcons.arrowUpRight300;
-  static const IconData notification = LucideIcons.bell300;
+  // NOTE: the `bell300` glyph in lucide_icons_flutter 3.1.14+2 is corrupted in the
+  // Lucide300 weight font — it renders FILLED instead of outline (the same font
+  // renders every other 300 icon correctly). Use the base `bell` (primary Lucide
+  // font), which is a proper outline bell, so it matches the rest of the linear set.
+  static const IconData notification = LucideIcons.bell;
   static const IconData notificationActive = LucideIcons.bellRing300;
   static const IconData notificationAdd = LucideIcons.bellPlus300;
   static const IconData notificationOff = LucideIcons.bellOff300;
@@ -117,4 +121,15 @@ abstract final class KasyIcons {
   static const IconData upload = LucideIcons.upload300;
   static const IconData video = LucideIcons.video300;
   static const IconData widgets = LucideIcons.component300;
+
+  /// Device frame visible / hidden (web device preview chrome).
+  static const IconData deviceFrame = LucideIcons.smartphone300;
+  static const IconData deviceFrameOff = LucideIcons.scan300;
+
+  /// Screen orientation (web device preview chrome).
+  static const IconData landscape = LucideIcons.rectangleHorizontal300;
+  static const IconData portrait = LucideIcons.rectangleVertical300;
+
+  /// Element inspector pick tool (web device preview chrome).
+  static const IconData inspector = LucideIcons.squareDashedMousePointer300;
 }

package/templates/firebase/lib/core/states/user_state_notifier.dart

@@ -60,8 +60,11 @@ class UserStateNotifier extends _$UserStateNotifier implements OnStartService {
     return ref.read(environmentProvider).authenticationMode;
   }
 
+  StreamSubscription<String?>? _roleSubscription;
+
   @override
   UserState build() {
+    ref.onDispose(() => _roleSubscription?.cancel());
     return const UserState(user: User.loading());
   }
 
@@ -79,6 +82,7 @@ class UserStateNotifier extends _$UserStateNotifier implements OnStartService {
       rethrow;
     }
     assert(state.user is! LoadingUserData, 'UserStateNotifier is not ready');
+    _syncRoleListener();
     await _initDeviceRegistration();
     _deviceRepository.onTokenUpdate(_onUpdateToken);
   }
@@ -89,6 +93,7 @@ class UserStateNotifier extends _$UserStateNotifier implements OnStartService {
   Future<void> onSignin() async {
     state = const UserState(user: User.loading());
     await _loadState();
+    _syncRoleListener();
     await _initDeviceRegistration();
     // A successful sign-in puts the user past first-run onboarding. Remember it
     // so that after a later logout they land on the sign-in screen instead of
@@ -166,6 +171,7 @@ class UserStateNotifier extends _$UserStateNotifier implements OnStartService {
   /// It will unregister the device from the notification service
   /// and logout the user
   Future<void> onLogout() async {
+    _stopRoleListener();
     final userId = state.user.idOrThrow;
     _deviceRepository.removeTokenUpdateListener();
     // Best-effort: if the network call fails we still proceed with logout so
@@ -278,6 +284,7 @@ class UserStateNotifier extends _$UserStateNotifier implements OnStartService {
   /// Here is the function to do it.
   /// It will delete the user account and logout the user
   Future<void> deleteAccount() async {
+    _stopRoleListener();
     final userId = state.user.idOrThrow;
     _deviceRepository.removeTokenUpdateListener();
     try {
@@ -297,6 +304,40 @@ class UserStateNotifier extends _$UserStateNotifier implements OnStartService {
     // continue as a guest.
   }
 
+  // -------------------------------
+  // ROLE LISTENER
+  // -------------------------------
+
+  void _syncRoleListener() {
+    final id = state.user.idOrNull;
+    if (id != null && state.user is AuthenticatedUserData) {
+      _startRoleListener(id);
+    } else {
+      _stopRoleListener();
+    }
+  }
+
+  void _startRoleListener(String userId) {
+    _roleSubscription?.cancel();
+    _roleSubscription = _userRepository
+        .watchRole(userId)
+        .skip(1) // skip initial snapshot — state was just loaded
+        .listen((newRole) {
+          final currentRole = switch (state.user) {
+            AuthenticatedUserData(:final role) => role,
+            _ => null,
+          };
+          if (newRole != currentRole) {
+            refresh();
+          }
+        });
+  }
+
+  void _stopRoleListener() {
+    _roleSubscription?.cancel();
+    _roleSubscription = null;
+  }
+
   // -------------------------------
   // PRIVATES
   // -------------------------------

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

@@ -78,6 +78,15 @@ class UniversalThemeFactory extends KasyThemeDataFactory {
         bottomSheetTheme: const BottomSheetThemeData(
           constraints: BoxConstraints(),
         ),
+        // Drawers are flat panels (like the sidebar rail), not Material 3's
+        // rounded, shadowed sheet: square edge, surface fill, no drop shadow.
+        // Set once here so every Drawer in the app is consistent — no per-use
+        // shape/elevation overrides needed.
+        drawerTheme: DrawerThemeData(
+          backgroundColor: colors.surface,
+          shape: const RoundedRectangleBorder(),
+          elevation: 0,
+        ),
       ),
     );
   }

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

@@ -0,0 +1,14 @@
+/// Exports a device-preview screenshot PNG to the clipboard (web), with a
+/// download fallback.
+///
+/// The real implementation uses web-only APIs (`dart:js_interop` + `package:web`)
+/// which do NOT compile on the Dart VM / native. Those are isolated in
+/// `png_clipboard_web.dart` and pulled in ONLY on web via a conditional import;
+/// everywhere else the no-op stub (`png_clipboard_io.dart`) is used. This keeps
+/// `flutter test` (VM compile) and native builds green — the web-only code never
+/// reaches them.
+library;
+
+export 'png_clipboard_io.dart'
+    if (dart.library.js_interop) 'png_clipboard_web.dart';
+export 'png_export_result.dart';

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

@@ -0,0 +1,9 @@
+import 'dart:typed_data';
+
+import 'package:kasy_kit/core/web_device_preview/png_export_result.dart';
+
+/// Non-web stub. The device preview is web-only, so this never runs at runtime —
+/// it exists only so the VM / native build (and `flutter test`) compile without
+/// the web interop.
+Future<PngExportResult> copyOrDownloadPng(Uint8List bytes) async =>
+    PngExportResult.unavailable;

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

@@ -0,0 +1,36 @@
+import 'dart:js_interop';
+import 'dart:typed_data';
+
+import 'package:kasy_kit/core/web_device_preview/png_export_result.dart';
+import 'package:web/web.dart' as web;
+
+/// Copies [bytes] (a PNG) straight to the clipboard so it can be pasted into an
+/// AI chat. Falls back to a file download if the browser blocks image clipboard
+/// writes.
+Future<PngExportResult> copyOrDownloadPng(Uint8List bytes) async {
+  final blob = web.Blob(
+    <JSAny>[bytes.toJS].toJS,
+    web.BlobPropertyBag(type: 'image/png'),
+  );
+  try {
+    final item = web.ClipboardItem(
+      <String, JSAny>{'image/png': blob}.jsify()! as JSObject,
+    );
+    await web.window.navigator.clipboard
+        .write(<web.ClipboardItem>[item].toJS)
+        .toDart;
+    return PngExportResult.copied;
+  } catch (_) {
+    _downloadBlob(blob);
+    return PngExportResult.downloaded;
+  }
+}
+
+void _downloadBlob(web.Blob blob) {
+  final url = web.URL.createObjectURL(blob);
+  web.HTMLAnchorElement()
+    ..href = url
+    ..download = 'preview_${DateTime.now().millisecondsSinceEpoch}.png'
+    ..click();
+  web.URL.revokeObjectURL(url);
+}

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

@@ -0,0 +1,2 @@
+/// Outcome of exporting the device-preview screenshot PNG.
+enum PngExportResult { copied, downloaded, unavailable }