kasy-cli 1.14.0 → 1.15.0

package/lib/utils/png-padding.js

@@ -0,0 +1,120 @@
+const fsp = require('node:fs/promises');
+const { PNG } = require('pngjs');
+
+const ANDROID12_SAFE_RATIO = 0.5;
+
+async function readPng(filePath) {
+  const buffer = await fsp.readFile(filePath);
+  return new Promise((resolve, reject) => {
+    new PNG().parse(buffer, (err, data) => {
+      if (err) reject(err);
+      else resolve(data);
+    });
+  });
+}
+
+function resizeBilinear(src, dstW, dstH) {
+  const dst = new PNG({ width: dstW, height: dstH });
+  const srcW = src.width;
+  const srcH = src.height;
+  const xRatio = srcW > 1 ? (srcW - 1) / dstW : 0;
+  const yRatio = srcH > 1 ? (srcH - 1) / dstH : 0;
+
+  for (let y = 0; y < dstH; y++) {
+    const sy = (y + 0.5) * yRatio;
+    const y0 = Math.floor(sy);
+    const y1 = Math.min(y0 + 1, srcH - 1);
+    const wy = sy - y0;
+
+    for (let x = 0; x < dstW; x++) {
+      const sx = (x + 0.5) * xRatio;
+      const x0 = Math.floor(sx);
+      const x1 = Math.min(x0 + 1, srcW - 1);
+      const wx = sx - x0;
+
+      const i00 = (y0 * srcW + x0) * 4;
+      const i10 = (y0 * srcW + x1) * 4;
+      const i01 = (y1 * srcW + x0) * 4;
+      const i11 = (y1 * srcW + x1) * 4;
+
+      const dstIdx = (y * dstW + x) * 4;
+      for (let c = 0; c < 4; c++) {
+        const top = src.data[i00 + c] * (1 - wx) + src.data[i10 + c] * wx;
+        const bot = src.data[i01 + c] * (1 - wx) + src.data[i11 + c] * wx;
+        dst.data[dstIdx + c] = Math.round(top * (1 - wy) + bot * wy);
+      }
+    }
+  }
+  return dst;
+}
+
+function compositeOnTransparentSquare(logo, canvasSize) {
+  const canvas = new PNG({ width: canvasSize, height: canvasSize });
+  canvas.data.fill(0);
+
+  const offsetX = Math.floor((canvasSize - logo.width) / 2);
+  const offsetY = Math.floor((canvasSize - logo.height) / 2);
+
+  for (let y = 0; y < logo.height; y++) {
+    for (let x = 0; x < logo.width; x++) {
+      const srcIdx = (y * logo.width + x) * 4;
+      const dstIdx = ((y + offsetY) * canvasSize + (x + offsetX)) * 4;
+      canvas.data[dstIdx] = logo.data[srcIdx];
+      canvas.data[dstIdx + 1] = logo.data[srcIdx + 1];
+      canvas.data[dstIdx + 2] = logo.data[srcIdx + 2];
+      canvas.data[dstIdx + 3] = logo.data[srcIdx + 3];
+    }
+  }
+  return canvas;
+}
+
+async function writePng(png, filePath) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    png.pack()
+      .on('data', (chunk) => chunks.push(chunk))
+      .on('end', async () => {
+        try {
+          await fsp.writeFile(filePath, Buffer.concat(chunks));
+          resolve();
+        } catch (e) {
+          reject(e);
+        }
+      })
+      .on('error', reject);
+  });
+}
+
+/**
+ * Read a PNG and write a new one of the same dimensions, with the source
+ * logo scaled down to fit inside the Android 12+ splash safe area (centered,
+ * transparent padding around it). This is what `windowSplashScreenAnimatedIcon`
+ * needs so the OS-applied circular mask doesn't clip the logo edges.
+ *
+ * @param {string} srcPath
+ * @param {string} dstPath
+ * @param {number} safeRatio fraction of the canvas the logo should occupy (default 0.6)
+ */
+async function writeAndroid12Variant(srcPath, dstPath, safeRatio = ANDROID12_SAFE_RATIO) {
+  const src = await readPng(srcPath);
+  const canvasSize = Math.max(src.width, src.height);
+  const safeSide = Math.round(canvasSize * safeRatio);
+
+  const aspect = src.width / src.height;
+  let logoW;
+  let logoH;
+  if (aspect >= 1) {
+    logoW = safeSide;
+    logoH = Math.round(safeSide / aspect);
+  } else {
+    logoH = safeSide;
+    logoW = Math.round(safeSide * aspect);
+  }
+
+  const resized = resizeBilinear(src, logoW, logoH);
+  const composited = compositeOnTransparentSquare(resized, canvasSize);
+  await writePng(composited, dstPath);
+  return { canvasSize, logoW, logoH };
+}
+
+module.exports = { writeAndroid12Variant, ANDROID12_SAFE_RATIO };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kasy-cli",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "CLI for scaffolding production-ready Flutter SaaS apps with Firebase, Supabase, or API REST backends.",
   "bin": {
     "kasy": "./bin/kasy.js"
@@ -39,10 +39,12 @@
     "validate": "node ./bin/kasy.js validate --analyze-only",
     "extract:patch": "node ./scripts/extract_patch.js",
     "check:firebase": "node ./scripts/check-firebase-template.js",
+    "test": "for f in test/*.test.js; do node \"$f\" || exit 1; done",
     "test:google-ios": "node ./test/google-ios-url-scheme.test.js",
     "test:apple-release": "node ./test/apple-release.test.js",
     "test:localize-docs": "node ./test/localize-release-docs.test.js",
-    "test:i18n-accents": "node ./test/i18n-accents.test.js"
+    "test:i18n-accents": "node ./test/i18n-accents.test.js",
+    "lint": "eslint bin lib scripts"
   },
   "dependencies": {
     "@clack/prompts": "^1.4.0",
@@ -51,7 +53,10 @@
     "fs-extra": "^11.2.0",
     "gradient-string": "^1.2.0",
     "kleur": "^4.1.5",
-    "prompts": "^2.4.2",
+    "pngjs": "^7.0.0",
     "yaml": "^2.4.2"
+  },
+  "devDependencies": {
+    "eslint": "^9.39.4"
   }
 }

package/templates/firebase/android/app/src/main/kotlin/com/aicrus/firebase/kit/MyWidget.kt

@@ -220,17 +220,18 @@ class MyWidgetWidget : GlanceAppWidget() {
     return DefaultStrings(greeting, hello)
   }
 
-  /// Builds the same Intent the launcher would fire when the user taps the
-  /// app icon: ACTION_MAIN + CATEGORY_LAUNCHER. Without these flags, the
-  /// activity receives an empty Intent and go_router lands on the
-  /// errorBuilder (the "404 - Page not found" screen).
+  /// Builds the exact Intent the system launcher fires when the user taps
+  /// the app icon. We must NOT add extra flags here — getLaunchIntentForPackage
+  /// already returns `FLAG_ACTIVITY_NEW_TASK | FLAG_ACTIVITY_RESET_IF_NEEDED`,
+  /// which is the same combo the launcher uses. Adding `CLEAR_TOP` destroys
+  /// go_router's navigation stack on warm starts and lands the user on the
+  /// errorBuilder ("404 - Page not found").
   private fun launchAppIntent(context: Context): Intent {
-    return Intent(context, MainActivity::class.java).apply {
-      action = Intent.ACTION_MAIN
-      addCategory(Intent.CATEGORY_LAUNCHER)
-      flags = Intent.FLAG_ACTIVITY_NEW_TASK or
-              Intent.FLAG_ACTIVITY_CLEAR_TOP or
-              Intent.FLAG_ACTIVITY_SINGLE_TOP
-    }
+    return context.packageManager.getLaunchIntentForPackage(context.packageName)
+      ?: Intent(context, MainActivity::class.java).apply {
+        action = Intent.ACTION_MAIN
+        addCategory(Intent.CATEGORY_LAUNCHER)
+        flags = Intent.FLAG_ACTIVITY_NEW_TASK
+      }
   }
 }

package/templates/firebase/android/app/src/main/res/layout/widget_preview.xml

@@ -1,19 +1,21 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- Static preview shown in the Android widget gallery (Android 12+).
-     Mirrors the real widget layout so the user can see what they're
-     adding before they drop it on the home screen. The Glance widget
-     replaces this once placed. -->
+<!-- Static preview shown in the widget gallery (Android 12+).
+     Only uses Views allowed by RemoteViews — no <Space>, no
+     paddingHorizontal/Vertical, no fontFamily. Anything outside
+     the allowlist makes the launcher silently fall back to a gray box. -->
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:background="@drawable/widget_gradient_bg"
     android:orientation="vertical"
-    android:padding="16dp">
+    android:paddingLeft="16dp"
+    android:paddingRight="16dp"
+    android:paddingTop="16dp"
+    android:paddingBottom="16dp">
 
     <TextView
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
-        android:fontFamily="sans-serif-medium"
         android:text="Boa noite"
         android:textColor="#8CFFFFFF"
         android:textSize="11sp" />
@@ -24,20 +26,25 @@
         android:layout_marginTop="4dp"
         android:text="Olá!"
         android:textColor="#FFFFFFFF"
-        android:textSize="24sp"
+        android:textSize="22sp"
         android:textStyle="bold" />
 
-    <Space
+    <!-- Filler row uses TextView with empty text + weight to push the pill
+         to the bottom (Space isn't on the RemoteViews allowlist). -->
+    <TextView
         android:layout_width="match_parent"
         android:layout_height="0dp"
-        android:layout_weight="1" />
+        android:layout_weight="1"
+        android:text="" />
 
     <TextView
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:background="@drawable/widget_pro_pill_bg"
-        android:paddingHorizontal="10dp"
-        android:paddingVertical="5dp"
+        android:paddingLeft="10dp"
+        android:paddingRight="10dp"
+        android:paddingTop="5dp"
+        android:paddingBottom="5dp"
         android:text="⭐ PRO"
         android:textColor="#FFFFD700"
         android:textSize="11sp"

package/templates/firebase/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+  <background android:drawable="@drawable/ic_launcher_background"/>
+  <foreground>
+      <inset
+          android:drawable="@drawable/ic_launcher_foreground"
+          android:inset="16%" />
+  </foreground>
+</adaptive-icon>

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

@@ -22,6 +22,7 @@ export 'kasy_dialog.dart';
 export 'kasy_otp_verification_bottom_sheet.dart';
 export 'kasy_skeleton.dart';
 export 'kasy_swipe_action.dart';
+export 'kasy_tabs.dart';
 export 'kasy_text_area.dart';
 export 'kasy_text_field.dart';
 export 'kasy_text_field_otp.dart';

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

@@ -28,7 +28,7 @@ enum KasyAvatarStatus { online }
 
 /// Design-system avatar: image, initials, icon, gradient, or custom child.
 ///
-/// Decorative radial fills: optional [KasyAvatarOrbGradients] (barrel presets).
+/// Decorative linear fills: optional [KasyAvatarGradients] (barrel presets).
 class KasyAvatar extends StatelessWidget {
   final KasyAvatarSize size;
 
@@ -60,7 +60,7 @@ class KasyAvatar extends StatelessWidget {
     this.tone = KasyAvatarTone.blue,
     this.fallbackSurface = KasyAvatarFallbackSurface.default_,
     this.shape = KasyAvatarShape.circle,
-    this.showShadow = true,
+    this.showShadow = false,
     this.showStoryRing = false,
     this.storyRingGradient,
     this.status,
@@ -244,7 +244,7 @@ class KasyAvatar extends StatelessWidget {
       return ColoredBox(
         color: bg,
         child: Center(
-          child: Icon(glyph, size: _d * 0.48, color: fg),
+          child: Icon(glyph, size: _d * 0.444, color: fg),
         ),
       );
     }
@@ -253,11 +253,12 @@ class KasyAvatar extends StatelessWidget {
       child: Center(
         child: Text(
           label ?? '',
-          style: context.textTheme.titleSmall?.copyWith(
+          style: TextStyle(
             color: fg,
-            fontWeight: FontWeight.w600,
-            fontSize: _d * 0.32,
+            fontWeight: FontWeight.w500,
+            fontSize: _d * 0.333,
             height: 1,
+            leadingDistribution: TextLeadingDistribution.even,
           ),
         ),
       ),
@@ -320,7 +321,10 @@ class KasyAvatar extends StatelessWidget {
   }
 }
 
-/// Horizontal stacked avatars with [KasyColors.surface] separation ring and optional +N.
+/// Horizontal stacked avatars with [KasyColors.surface] separation ring,
+/// optional +N counter, and optional add-action button.
+///
+/// Set [onAdd] to show the "+" button at the end (12 px gap, per Figma spec).
 class KasyAvatarGroup extends StatelessWidget {
   final List<Widget> avatars;
   final int maxVisible;
@@ -329,14 +333,18 @@ class KasyAvatarGroup extends StatelessWidget {
   final bool showShadow;
   final double itemDiameter;
 
+  /// When non-null a circular "+" button is shown after the group.
+  final VoidCallback? onAdd;
+
   const KasyAvatarGroup({
     super.key,
     required this.avatars,
     this.maxVisible = 4,
     this.extraCount = 0,
-    this.overlapFactor = 0.34,
-    this.showShadow = true,
+    this.overlapFactor = 0.28,
+    this.showShadow = false,
     this.itemDiameter = 48,
+    this.onAdd,
   });
 
   @override
@@ -346,9 +354,10 @@ class KasyAvatarGroup extends StatelessWidget {
     final double step = d * (1 - overlapFactor);
     final int showCounter = extraCount > 0 ? 1 : 0;
     final int totalSlots = n + showCounter;
-    final double w = totalSlots <= 0 ? 0 : step * (totalSlots - 1) + d + 4;
-    return SizedBox(
-      width: w,
+    final double stackW = totalSlots <= 0 ? 0 : step * (totalSlots - 1) + d + 4;
+
+    final Widget stack = SizedBox(
+      width: stackW,
       height: d + 4,
       child: Stack(
         clipBehavior: Clip.none,
@@ -371,9 +380,14 @@ class KasyAvatarGroup extends StatelessWidget {
                   child: Center(
                     child: Text(
                       '+$extraCount',
-                      style: context.textTheme.labelLarge?.copyWith(
-                        color: context.colors.primary,
-                        fontWeight: FontWeight.w600,
+                      style: TextStyle(
+                        color: context.isDark
+                            ? const Color(0xFFFCFCFC)
+                            : const Color(0xFF18181B),
+                        fontWeight: FontWeight.w500,
+                        fontSize: 12,
+                        height: 16 / 12,
+                        leadingDistribution: TextLeadingDistribution.even,
                       ),
                     ),
                   ),
@@ -384,22 +398,50 @@ class KasyAvatarGroup extends StatelessWidget {
         ],
       ),
     );
+
+    if (onAdd == null) return stack;
+
+    // Add-action button: circle with "+" icon, 12 px gap (Figma layout_EJ08D4).
+    final Widget addBtn = _KasyAvatarPressable(
+      onPressed: onAdd!,
+      semanticLabel: 'Add member',
+      minSide: d < 44 ? 44.0 : d,
+      child: Container(
+        width: d,
+        height: d,
+        decoration: BoxDecoration(
+          color: context.colors.avatarFallbackFill,
+          shape: BoxShape.circle,
+        ),
+        child: Center(
+          child: Icon(
+            KasyIcons.add,
+            size: d * 0.444,
+            color: context.colors.primary,
+          ),
+        ),
+      ),
+    );
+
+    return Row(
+      mainAxisSize: MainAxisSize.min,
+      children: [stack, const SizedBox(width: 12), addBtn],
+    );
   }
 
   Widget _ringWrap(BuildContext context, double d, Widget child, bool shadow) {
-    final Widget bordered = Container(
+    return Container(
       width: d,
       height: d,
       decoration: BoxDecoration(
         shape: BoxShape.circle,
-        border: Border.all(color: context.colors.surface, width: 2.5),
+        border: Border.all(color: context.colors.surface, width: 2.0),
         boxShadow: shadow ? [KasyShadows.component(context)] : null,
       ),
       child: ClipOval(
         child: SizedBox(width: d, height: d, child: child),
       ),
     );
-    return bordered;
   }
 }
 
@@ -418,52 +460,41 @@ _KasyAvatarColors _colorsForTone(
   final KasyColors k = context.colors;
   final bool dark = context.isDark;
 
-  Color accent() {
-    return switch (tone) {
-      KasyAvatarTone.blue => k.primary,
-      KasyAvatarTone.neutral => k.grey3,
-      KasyAvatarTone.green => k.success,
-      KasyAvatarTone.orange => k.warning,
-      KasyAvatarTone.red => k.error,
-    };
-  }
+  // Accent color per tone (Figma: accent=#0485F7, success=#17C964,
+  // warning=#F5A524, danger=#FF383C, neutral uses neutral fg).
+  Color accentColor() => switch (tone) {
+    KasyAvatarTone.blue    => k.primary,
+    KasyAvatarTone.neutral => k.grey3,
+    KasyAvatarTone.green   => k.success,
+    KasyAvatarTone.orange  => k.warning,
+    KasyAvatarTone.red     => k.error,
+  };
 
+  // Solid surface: all types share the same #EBEBEC bg (Figma fill_J18KAR).
+  // Foreground: neutral → onSurface (#18181B light), others → accent color.
   if (fallbackSurface == KasyAvatarFallbackSurface.default_) {
+    final Color fg = tone == KasyAvatarTone.neutral
+        ? k.onSurface
+        : accentColor();
+    return _KasyAvatarColors(background: k.avatarFallbackFill, foreground: fg);
+  }
+
+  // Neutral soft = same as neutral solid (Figma: no tint for default type).
+  if (tone == KasyAvatarTone.neutral) {
     return _KasyAvatarColors(
       background: k.avatarFallbackFill,
-      foreground: accent(),
+      foreground: k.onSurface,
     );
   }
 
-  if (dark) {
-    final Color a = accent();
-    final Color bg = Color.alphaBlend(a.withValues(alpha: 0.28), k.surface);
-    final Color fg = Color.lerp(a, k.onSurface, 0.45)!;
-    return _KasyAvatarColors(background: bg, foreground: fg);
-  }
-
-  return switch (tone) {
-    KasyAvatarTone.blue => const _KasyAvatarColors(
-      background: Color(0xFFE3F2FD),
-      foreground: Color(0xFF1565C0),
-    ),
-    KasyAvatarTone.neutral => const _KasyAvatarColors(
-      background: Color(0xFFF0F0F0),
-      foreground: Color(0xFF212121),
-    ),
-    KasyAvatarTone.green => const _KasyAvatarColors(
-      background: Color(0xFFE8F5E9),
-      foreground: Color(0xFF1B5E20),
-    ),
-    KasyAvatarTone.orange => const _KasyAvatarColors(
-      background: Color(0xFFFFF3E0),
-      foreground: Color(0xFFE65100),
-    ),
-    KasyAvatarTone.red => const _KasyAvatarColors(
-      background: Color(0xFFFFEBEE),
-      foreground: Color(0xFFB71C1C),
-    ),
-  };
+  // Colored soft: rgba(accent, 0.15) blended over surface (white light / dark).
+  // Figma fill_MVOTCC: rgba(4,133,247,0.15) + #FFFFFF light
+  //                    rgba(4,133,247,0.15) + #18181B dark
+  // Foreground: pure accent color (Figma uses raw accent even in soft).
+  final Color a = accentColor();
+  final Color base = dark ? k.surface : const Color(0xFFFFFFFF);
+  final Color bg = Color.alphaBlend(a.withValues(alpha: 0.15), base);
+  return _KasyAvatarColors(background: bg, foreground: a);
 }
 
 class _KasyAvatarPressable extends StatefulWidget {