kasy-cli 1.21.8 → 1.22.0

package/templates/firebase/functions/src/{llm_chat → ai_chat}/index.ts

@@ -1,21 +1,21 @@
 /**
- * Firebase Cloud Function: LLM Chat Proxy (streaming)
+ * Firebase Cloud Function: AI Chat Proxy (streaming)
  *
  * Receives {message, history} from the Flutter app and streams the response
  * back as Server-Sent Events (SSE). The API key never leaves the server.
  *
  * Secrets required (set via `firebase functions:secrets:set`):
- *   - LLM_API_KEY: API key for OpenAI or Gemini
+ *   - AI_API_KEY: API key for OpenAI or Gemini
  *
  * Environment variables (set in functions/.env):
- *   - LLM_PROVIDER: "openai" (default) or "gemini"
- *   - LLM_SYSTEM_PROMPT: System prompt for the agent (optional)
+ *   - AI_PROVIDER: "openai" (default) or "gemini"
+ *   - AI_SYSTEM_PROMPT: System prompt for the agent (optional)
  *
  * App dart-define:
- *   - LLM_CHAT_ENDPOINT: URL of this function after deploy
- *     Example: https://europe-west1-<project-id>.cloudfunctions.net/llmChat
+ *   - AI_CHAT_ENDPOINT: URL of this function after deploy
+ *     Example: https://europe-west1-<project-id>.cloudfunctions.net/aiChat
  *
- * Deploy: kasy deploy  (or: firebase deploy --only functions:llmChat)
+ * Deploy: kasy deploy  (or: firebase deploy --only functions:aiChat)
  */
 
 import { onRequest } from "firebase-functions/v2/https";
@@ -23,7 +23,7 @@ import { defineSecret } from "firebase-functions/params";
 import { getAuth } from "firebase-admin/auth";
 import type { Request, Response } from "express";
 
-const llmApiKey = defineSecret("LLM_API_KEY");
+const aiApiKey = defineSecret("AI_API_KEY");
 
 interface ChatMessage {
   role: "user" | "assistant";
@@ -130,8 +130,8 @@ async function verifyFirebaseToken(req: Request, res: Response): Promise<string
   }
 }
 
-export const llmChat = onRequest(
-  { cors: true, secrets: [llmApiKey] },
+export const aiChat = onRequest(
+  { cors: true, secrets: [aiApiKey] },
   async (req, res) => {
     if (req.method !== "POST") {
       res.status(405).json({ error: "Method not allowed" });
@@ -147,16 +147,16 @@ export const llmChat = onRequest(
       return;
     }
 
-    const apiKey = llmApiKey.value();
+    const apiKey = aiApiKey.value();
     if (!apiKey) {
       res
         .status(500)
-        .json({ error: "LLM_API_KEY not configured. Run: firebase functions:secrets:set LLM_API_KEY" });
+        .json({ error: "AI_API_KEY not configured. Run: firebase functions:secrets:set AI_API_KEY" });
       return;
     }
 
-    const provider = process.env.LLM_PROVIDER ?? "openai";
-    const systemPrompt = process.env.LLM_SYSTEM_PROMPT ?? "";
+    const provider = process.env.AI_PROVIDER ?? "openai";
+    const systemPrompt = process.env.AI_SYSTEM_PROMPT ?? "";
 
     // SSE headers — must be set before any write
     res.setHeader("Content-Type", "text/event-stream");
@@ -172,9 +172,9 @@ export const llmChat = onRequest(
       }
       res.end();
     } catch (err) {
-      console.error("[llm-chat]", err);
+      console.error("[ai-chat]", err);
       // Send error as SSE event so the Flutter client can surface it
-      res.write(`data: ${JSON.stringify({ error: "LLM request failed" })}\n\n`);
+      res.write(`data: ${JSON.stringify({ error: "AI request failed" })}\n\n`);
       res.end();
     }
   }

package/templates/firebase/functions/src/index.ts

@@ -19,7 +19,13 @@ exports.deviceTriggers = require("./notifications/device_triggers");
 exports.subscriptions = require("./subscriptions/subscriptions_functions");
 exports.subscriptionTriggers = require("./subscriptions/triggers");
 
+// stripe web subscriptions (activated when the Stripe module is enabled)
+exports.stripeFunctions = require("./subscriptions/stripe_functions");
+
+// admin console (listUsers — gated on users/{uid}.role == "admin")
+exports.adminFunctions = require("./admin/functions");
+
 // feature requests: vote counter updated atomically by client (WriteBatch)
 
-// llm chat proxy (activated when withLlmChat = true)
-exports.llmChat = require("./llm_chat").llmChat;
+// llm chat proxy (activated when withAiChat = true)
+exports.aiChat = require("./ai_chat").aiChat;

package/templates/firebase/functions/src/notifications/device_triggers.ts

@@ -14,7 +14,7 @@ import {Logger} from "../core/logger/logger";
  * any time. Without it, sending a push to user A could deliver to a phone now
  * signed in as user B.
  */
-export const onDeviceWritten = onDocumentWritten(
+export const dedupeDeviceTokens = onDocumentWritten(
   "users/{userId}/devices/{deviceId}",
   async (event) => {
     const after = event.data?.after?.data();
@@ -25,7 +25,7 @@ export const onDeviceWritten = onDocumentWritten(
 
     const currentUserId = event.params.userId;
     const currentDeviceId = event.params.deviceId;
-    const logger = new Logger("onDeviceWritten");
+    const logger = new Logger("dedupeDeviceTokens");
 
     try {
       const duplicates = await admin

package/templates/firebase/functions/src/notifications/triggers.ts

@@ -7,13 +7,13 @@ import {onDocumentCreated} from "firebase-functions/v2/firestore";
 
 const kChannelId = "appfirebase";
 
-export const onNewNotificationRequest = onDocumentCreated(
+export const onNotificationCreated = onDocumentCreated(
   "users/{userId}/notifications/{notificationId}",
   async (event) => {
     if (!event.data) {
       return;
     }
-    const logger = new Logger("onNewNotificationRequest");
+    const logger = new Logger("onNotificationCreated");
     try {
       const notificationEntity = NotificationEntity.fromDocument(event.data);
       const userId = event.params.userId;
@@ -97,6 +97,6 @@ export const onNewNotificationRequest = onDocumentCreated(
         }
       }
     } catch (e) {
-      logger.error(`Error onNewNotificationRequest users/${event.params.userId}/notifications/${event.id} : ${e}`);
+      logger.error(`Error onNotificationCreated users/${event.params.userId}/notifications/${event.id} : ${e}`);
     }
   });

package/templates/firebase/functions/src/subscriptions/models/subscription_status.ts

@@ -13,6 +13,8 @@ export const Stores = {
   PLAY_STORE: "PLAY_STORE",
   APPLE_STORE: "APPLE_STORE",
   EARLY_BIRD: "EARLY_BIRD",
+  // Subscription purchased on the web via Stripe.
+  STRIPE: "STRIPE",
 } as const;
 
 export type Stores = ObjectValues<typeof Stores>;

package/templates/firebase/functions/src/subscriptions/stripe_functions.ts

@@ -0,0 +1,222 @@
+import {error} from "firebase-functions/logger";
+import {onCall, onRequest, HttpsError} from "firebase-functions/v2/https";
+import {defineSecret, defineString} from "firebase-functions/params";
+import * as admin from "firebase-admin";
+import {Timestamp} from "firebase-admin/firestore";
+import Stripe from "stripe";
+import {Subscription} from "./models/subscriptions";
+import {subscriptionsRepository} from "../core/data/repositories/repositories";
+import {Stores, SubscriptionStatus} from "./models/subscription_status";
+
+// Server-side only. Never exposed to the client.
+const stripeSecretKey = defineSecret("STRIPE_SECRET_KEY");
+const stripeWebhookSecret = defineSecret("STRIPE_WEBHOOK_SECRET");
+// Optional: restrict the listed prices to a single Stripe product.
+const stripeProductId = defineString("STRIPE_PRODUCT_ID", {default: ""});
+
+// Firestore collection mapping a Firebase uid -> its Stripe customer id.
+const CUSTOMERS_COLLECTION = "stripe_customers";
+
+function stripeClient(): Stripe {
+  return new Stripe(stripeSecretKey.value());
+}
+
+async function getOrCreateCustomer(stripe: Stripe, uid: string): Promise<string> {
+  const db = admin.firestore();
+  const ref = db.collection(CUSTOMERS_COLLECTION).doc(uid);
+  const snap = await ref.get();
+  const existing = snap.data()?.customerId as string | undefined;
+  if (existing) return existing;
+  const customer = await stripe.customers.create({metadata: {firebaseUID: uid}});
+  await ref.set({customerId: customer.id, created_at: Timestamp.now()});
+  return customer.id;
+}
+
+function trialDaysFor(price: Stripe.Price, product: Stripe.Product): number | null {
+  const meta = price.metadata?.trial_days ?? product.metadata?.trial_days;
+  return meta ? Number(meta) : null;
+}
+
+// ---------------------------------------------------------------------------
+// listPrices — active recurring prices, mapped to the paywall offer contract.
+// ---------------------------------------------------------------------------
+export const listPrices = onCall({secrets: [stripeSecretKey]}, async () => {
+  const stripe = stripeClient();
+  const params: Stripe.PriceListParams = {
+    active: true,
+    type: "recurring",
+    expand: ["data.product"],
+    limit: 100,
+  };
+  const productFilter = stripeProductId.value();
+  if (productFilter) params.product = productFilter;
+
+  const prices = await stripe.prices.list(params);
+  return prices.data
+    .filter((p) => Boolean(p.recurring))
+    .map((p) => {
+      const product = p.product as Stripe.Product;
+      const features = (product.marketing_features ?? [])
+        .map((f) => f.name)
+        .filter((n): n is string => Boolean(n));
+      return {
+        priceId: p.id,
+        productId: typeof p.product === "string" ? p.product : product.id,
+        productName: product.name ?? "",
+        description: product.description ?? "",
+        unitAmount: p.unit_amount ?? 0,
+        currency: p.currency,
+        interval: p.recurring?.interval ?? "month",
+        intervalCount: p.recurring?.interval_count ?? 1,
+        trialDays: trialDaysFor(p, product),
+        features,
+      };
+    });
+});
+
+// ---------------------------------------------------------------------------
+// createCheckoutSession — hosted Stripe Checkout (mode=subscription).
+// ---------------------------------------------------------------------------
+export const createCheckoutSession = onCall(
+  {secrets: [stripeSecretKey]},
+  async (request) => {
+    const uid = request.auth?.uid;
+    if (!uid) throw new HttpsError("unauthenticated", "Sign in required");
+    const priceId = request.data?.priceId as string | undefined;
+    if (!priceId) throw new HttpsError("invalid-argument", "priceId is required");
+    const successUrl = (request.data?.successUrl as string | undefined) ?? "";
+    const cancelUrl = (request.data?.cancelUrl as string | undefined) ?? successUrl;
+
+    const stripe = stripeClient();
+    const customerId = await getOrCreateCustomer(stripe, uid);
+
+    const price = await stripe.prices.retrieve(priceId, {expand: ["product"]});
+    const trialDays = trialDaysFor(price, price.product as Stripe.Product);
+
+    const session = await stripe.checkout.sessions.create({
+      mode: "subscription",
+      customer: customerId,
+      client_reference_id: uid,
+      line_items: [{price: priceId, quantity: 1}],
+      success_url: successUrl,
+      cancel_url: cancelUrl,
+      subscription_data: {
+        metadata: {firebaseUID: uid},
+        ...(trialDays ? {trial_period_days: trialDays} : {}),
+      },
+    });
+    return {url: session.url};
+  },
+);
+
+// ---------------------------------------------------------------------------
+// createPortalSession — Stripe Customer Portal (manage / cancel).
+// ---------------------------------------------------------------------------
+export const createPortalSession = onCall(
+  {secrets: [stripeSecretKey]},
+  async (request) => {
+    const uid = request.auth?.uid;
+    if (!uid) throw new HttpsError("unauthenticated", "Sign in required");
+    const returnUrl = (request.data?.returnUrl as string | undefined) ?? "";
+
+    const stripe = stripeClient();
+    const snap = await admin
+      .firestore()
+      .collection(CUSTOMERS_COLLECTION)
+      .doc(uid)
+      .get();
+    const customerId = snap.data()?.customerId as string | undefined;
+    if (!customerId) {
+      throw new HttpsError("failed-precondition", "No Stripe customer for user");
+    }
+    const session = await stripe.billingPortal.sessions.create({
+      customer: customerId,
+      return_url: returnUrl,
+    });
+    return {url: session.url};
+  },
+);
+
+// ---------------------------------------------------------------------------
+// stripeWebhook — webhook. The ONLY writer of `subscriptions` for Stripe.
+// ---------------------------------------------------------------------------
+function statusFromStripe(sub: Stripe.Subscription): SubscriptionStatus {
+  switch (sub.status) {
+    case "active":
+    case "trialing":
+      return SubscriptionStatus.ACTIVE;
+    default:
+      // canceled, unpaid, past_due, incomplete, incomplete_expired, paused
+      return SubscriptionStatus.EXPIRED;
+  }
+}
+
+async function upsertFromStripeSubscription(sub: Stripe.Subscription): Promise<void> {
+  const uid = sub.metadata?.firebaseUID;
+  if (!uid) {
+    console.log("[stripe-webhook] subscription without firebaseUID metadata, skipping");
+    return;
+  }
+  const now = Timestamp.now();
+  const existing = await subscriptionsRepository.getFromUserId(uid);
+  // In Stripe API v18 the billing period lives on each subscription item.
+  const item = sub.items.data[0];
+  const priceId = item?.price?.id ?? "";
+  const periodEnd = item?.current_period_end;
+  const expiration = periodEnd
+    ? Timestamp.fromMillis(periodEnd * 1000)
+    : undefined;
+
+  const subscription = new Subscription(
+    {
+      userId: uid,
+      status: statusFromStripe(sub),
+      creationDate: existing?.creationDate ?? now,
+      lastUpdate: now,
+      expirationDate: expiration,
+      store: Stores.STRIPE,
+      productId: priceId,
+    },
+    subscriptionsRepository,
+  );
+  await subscription.save();
+}
+
+export const stripeWebhook = onRequest(
+  {cors: false, secrets: [stripeSecretKey, stripeWebhookSecret]},
+  async (req, res) => {
+    const signature = req.header("stripe-signature");
+    if (!signature) {
+      res.status(400).send("Missing signature");
+      return;
+    }
+    const stripe = stripeClient();
+    let event: Stripe.Event;
+    try {
+      event = stripe.webhooks.constructEvent(
+        req.rawBody,
+        signature,
+        stripeWebhookSecret.value(),
+      );
+    } catch (e) {
+      console.log(`[stripe-webhook] signature verification failed: ${e}`);
+      res.status(400).send("Invalid signature");
+      return;
+    }
+    try {
+      switch (event.type) {
+        case "customer.subscription.created":
+        case "customer.subscription.updated":
+        case "customer.subscription.deleted":
+          await upsertFromStripeSubscription(event.data.object as Stripe.Subscription);
+          break;
+        default:
+          break;
+      }
+      res.status(200).send("ok");
+    } catch (e) {
+      error(e);
+      res.status(500).send(e instanceof Error ? e.message : String(e));
+    }
+  },
+);

package/templates/firebase/functions/src/subscriptions/subscriptions_functions.ts

@@ -84,11 +84,11 @@ async function sendMetaEventsForSubscription(
   }
 }
 
-export const onRcPremiumUpdate = onRequest({cors: true, secrets: [revenuecatToken, metaAccessToken, metaDatasetId]}, async (
+export const revenuecatWebhook = onRequest({cors: true, secrets: [revenuecatToken, metaAccessToken, metaDatasetId]}, async (
   req: https.Request, 
   res: express.Response,
 ) => {
-    console.log("[onPremiumUpdate]");
+    console.log("[revenuecatWebhook]");
     const authorization = req.header("Authorization");
     if (!authorization) {
       console.log("Unauthorized - no token provided");

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

@@ -6,7 +6,6 @@
 ///   import 'package:kasy_kit/components/components.dart';
 library;
 
-export '../core/sidebar/kasy_sidebar.dart';
 export 'kasy_accordion.dart';
 export 'kasy_alert.dart';
 export 'kasy_app_bar.dart';
@@ -20,11 +19,15 @@ export 'kasy_checkbox.dart';
 export 'kasy_chip.dart';
 export 'kasy_date_picker.dart';
 export 'kasy_dialog.dart';
+export 'kasy_image_viewer.dart';
 export 'kasy_otp_verification_bottom_sheet.dart';
+export 'kasy_sidebar.dart';
 export 'kasy_skeleton.dart';
+export 'kasy_status_tag.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';
 export 'kasy_toast.dart';
+export 'kasy_web_header.dart';

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

@@ -29,9 +29,17 @@ import 'package:flutter/foundation.dart' show kIsWeb;
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart' show SystemUiOverlayStyle;
 import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/responsive_layout.dart';
 
 /// Inner toolbar band height (orbit hit targets, title baseline).
 const double kasyAppBarToolbarRowHeight = 44;
+
+/// Effective toolbar band height. [KasyAppBar] serves phone and tablet only — on
+/// desktop the richer web header takes over — so the band keeps a single
+/// compact height across every viewport where the app bar appears.
+double kasyAppBarToolbarRowHeightOf(BuildContext context) =>
+    kasyAppBarToolbarRowHeight;
+
 const double kasyAppBarTitleFontScale = 0.92;
 
 /// Tight vertical padding inside the frost, above/below [kasyAppBarToolbarRowHeight].
@@ -48,9 +56,13 @@ enum KasyAppBarScrollTreatment { overlay, intrinsicScroll }
 
 /// Vertical inset for scroll/viewport when using [KasyAppBarScrollTreatment.overlay].
 double kasyAppBarBodyTopOverlap(BuildContext context) {
+  // On desktop the app bar hides (the web header owns the top chrome).
+  if (MediaQuery.sizeOf(context).width >= DeviceType.large.breakpoint) {
+    return 0;
+  }
   return MediaQuery.paddingOf(context).top +
       kasyAppBarChromePaddingTop +
-      kasyAppBarToolbarRowHeight +
+      kasyAppBarToolbarRowHeightOf(context) +
       kasyAppBarChromePaddingBottom;
 }
 
@@ -112,13 +124,11 @@ class KasyFrostedChromeBackground extends StatelessWidget {
   });
 
   /// Translucent tint so blurred content shows through; tuned per brightness.
+  /// Derived from the global `surface` token so the bar lifts off the canvas
+  /// and follows light/dark automatically.
   Color _tint(BuildContext context) {
     final bool dark = Theme.of(context).brightness == Brightness.dark;
-    if (dark) {
-      return const Color(0xFF161618).withValues(alpha: 0.88);
-    }
-    // White (surface) instead of background grey so the bar lifts off the canvas.
-    return const Color(0xFFFFFFFF).withValues(alpha: 0.82);
+    return context.colors.surface.withValues(alpha: dark ? 0.88 : 0.82);
   }
 
   @override
@@ -227,11 +237,16 @@ class KasyAppBar extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
+    // On desktop the web header owns the top chrome, so the page app bar hides.
+    if (MediaQuery.sizeOf(context).width >= DeviceType.large.breakpoint) {
+      return const SizedBox.shrink();
+    }
     final Color orbFg = context.colors.onSurface;
     final Color orbFill = kasyChromeOrbFillColor(context);
     final VoidCallback handleBack = onBack ?? () => Navigator.maybePop(context);
 
-    final double rowHeight = toolbarHeight ?? kasyAppBarToolbarRowHeight;
+    final double rowHeight =
+        toolbarHeight ?? kasyAppBarToolbarRowHeightOf(context);
     final Widget leading = switch (style) {
       KasyAppBarStyle.rootTab => SizedBox(
         width: 44,

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

@@ -153,9 +153,9 @@ class KasyAvatar extends StatelessWidget {
         width: _d,
         height: _d,
         fit: BoxFit.cover,
-        // Evita o blur de decodificação progressiva de JPEG:
-        // enquanto a imagem carrega, mostra o fallback; quando o primeiro
-        // frame está pronto, faz crossfade suave.
+        // Avoids the blur from progressive JPEG decoding:
+        // while the image loads, show the fallback; when the first
+        // frame is ready, do a smooth crossfade.
         frameBuilder: (context, child, frame, wasSynchronouslyLoaded) {
           if (wasSynchronouslyLoaded) return child;
           return SizedBox(
@@ -301,7 +301,7 @@ class KasyAvatar extends StatelessWidget {
             width: badge,
             height: badge,
             decoration: BoxDecoration(
-              color: const Color(0xFF81C784),
+              color: context.colors.success,
               shape: BoxShape.circle,
               border: Border.all(color: context.colors.surface, width: 2),
             ),
@@ -451,8 +451,9 @@ _KasyAvatarColors _colorsForTone(
   final KasyColors k = context.colors;
   final bool dark = context.isDark;
 
-  // Accent color per tone (Figma: accent=#0485F7, success=#17C964,
-  // warning=#F5A524, danger=#FF383C, neutral uses neutral fg).
+  // Accent color per tone, from the global theme tokens: the "blue" tone maps
+  // to the primary accent, success/warning/danger to their semantic tokens,
+  // neutral to the foreground.
   Color accentColor() => switch (tone) {
     KasyAvatarTone.blue    => k.primary,
     KasyAvatarTone.neutral => k.grey3,

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

@@ -1,7 +1,7 @@
 import 'package:flutter/foundation.dart' show kIsWeb;
 import 'package:flutter/material.dart';
-import 'package:flutter/services.dart';
 import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/core/widgets/kasy_focus_ring.dart';
 import 'package:kasy_kit/core/widgets/kasy_hover.dart';
 import 'package:kasy_kit/core/widgets/kasy_pressable_depth.dart';
 
@@ -496,8 +496,8 @@ class _KasyButtonShell extends StatelessWidget {
 
   Widget _wrapFocus(Widget child, BorderRadius borderRadius) {
     if (!enabled || onPressed == null) return child;
-    return _KeyboardFocus(
-      onActivate: onPressed!,
+    return KasyFocusRing(
+      onActivate: onPressed,
       borderRadius: borderRadius,
       child: child,
     );
@@ -625,30 +625,28 @@ class _KasyButtonShell extends StatelessWidget {
 
     if (pressEffect == KasyButtonPressEffect.both) {
       final bool isDark = Theme.of(context).brightness == Brightness.dark;
-      return _wrapFocus(
-        KasyPressableDepth(
-          semanticLabel: _accessibilityLabel,
-          onPressed: onPressed!,
-          clipBorderRadius: resolvedRadius,
-          hapticFeedbackEnabled: hapticFeedbackEnabled,
-          pressOverlayColor: palette.foreground.withValues(
-            alpha: isDark ? 0.04 : 0.10,
-          ),
-          child: painted,
-        ),
-        resolvedRadius,
-      );
-    }
-
-    return _wrapFocus(
-      KasyPressableDepth(
+      return KasyPressableDepth(
         semanticLabel: _accessibilityLabel,
         onPressed: onPressed!,
         clipBorderRadius: resolvedRadius,
         hapticFeedbackEnabled: hapticFeedbackEnabled,
-        child: painted,
-      ),
-      resolvedRadius,
+        pressOverlayColor: palette.foreground.withValues(
+          alpha: isDark ? 0.04 : 0.10,
+        ),
+        // Wrap the focus ring around the painted visual, not the pressable: the
+        // pressable enforces a 44px min tap target and stretches to its parent,
+        // so ringing it would draw an oversized oval around a small round orb.
+        child: _wrapFocus(painted, resolvedRadius),
+      );
+    }
+
+    return KasyPressableDepth(
+      semanticLabel: _accessibilityLabel,
+      onPressed: onPressed!,
+      clipBorderRadius: resolvedRadius,
+      hapticFeedbackEnabled: hapticFeedbackEnabled,
+      // Ring hugs the visual, not the (larger) tap target. See note above.
+      child: _wrapFocus(painted, resolvedRadius),
     );
   }
 
@@ -840,10 +838,10 @@ class _KasyButtonMetrics {
   final EdgeInsets horizontalPadding;
   final double labelFontSize;
 
-  /// Ícone ao lado do rótulo (botões com texto).
+  /// Icon next to the label (buttons with text).
   final double iconSize;
 
-  /// Tamanho do glifo dentro do botão apenas-ícone (pode diferir de [iconSize]).
+  /// Glyph size inside the icon-only button (may differ from [iconSize]).
   final double iconOnlyGlyphSize;
   final double loadingSpinnerExtent;
 
@@ -858,77 +856,3 @@ class _KasyButtonMetrics {
   });
 }
 
-/// Makes a button keyboard-navigable (Tab) and activates it on Enter/Space.
-/// Shows a focus ring when focused. Inert on touch-only platforms.
-class _KeyboardFocus extends StatefulWidget {
-  final VoidCallback onActivate;
-  final Widget child;
-  final BorderRadius borderRadius;
-
-  const _KeyboardFocus({
-    required this.onActivate,
-    required this.child,
-    required this.borderRadius,
-  });
-
-  @override
-  State<_KeyboardFocus> createState() => _KeyboardFocusState();
-}
-
-class _KeyboardFocusState extends State<_KeyboardFocus> {
-  late final FocusNode _node;
-  bool _focused = false;
-
-  @override
-  void initState() {
-    super.initState();
-    _node = FocusNode();
-    _node.addListener(_onFocusChange);
-  }
-
-  @override
-  void dispose() {
-    _node.removeListener(_onFocusChange);
-    _node.dispose();
-    super.dispose();
-  }
-
-  void _onFocusChange() {
-    if (mounted) setState(() => _focused = _node.hasFocus);
-  }
-
-  KeyEventResult _onKeyEvent(FocusNode node, KeyEvent event) {
-    if (event is KeyDownEvent &&
-        (event.logicalKey == LogicalKeyboardKey.enter ||
-            event.logicalKey == LogicalKeyboardKey.space ||
-            event.logicalKey == LogicalKeyboardKey.numpadEnter)) {
-      widget.onActivate();
-      return KeyEventResult.handled;
-    }
-    return KeyEventResult.ignored;
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final Color focusColor = Theme.of(context).colorScheme.primary;
-    return Focus(
-      focusNode: _node,
-      onKeyEvent: _onKeyEvent,
-      child: AnimatedContainer(
-        duration: const Duration(milliseconds: 120),
-        decoration: _focused
-            ? BoxDecoration(
-                borderRadius: widget.borderRadius,
-                boxShadow: [
-                  BoxShadow(
-                    color: focusColor.withValues(alpha: 0.5),
-                    spreadRadius: 2,
-                  ),
-                ],
-              )
-            : const BoxDecoration(),
-        child: widget.child,
-      ),
-    );
-  }
-}