kasy-cli 1.2.1

package/templates/firebase/lib/features/authentication/ui/widgets/recover_password_result.dart

@@ -0,0 +1,62 @@
+import 'package:flutter/material.dart';
+import 'package:go_router/go_router.dart';
+import 'package:kasy_kit/components/components.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/i18n/translations.g.dart';
+
+class RecoverPasswordSent extends StatelessWidget {
+  const RecoverPasswordSent({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return Center(
+      child: Column(
+        children: [
+          const Spacer(),
+          Icon(
+            KasyIcons.checkCircle,
+            color: context.colors.success,
+            size: 64,
+          ),
+          const SizedBox(height: KasySpacing.md),
+          Text(
+            t.recover_password_result.title,
+            style: context.textTheme.headlineMedium!.copyWith(
+              color: context.colors.success,
+            ),
+          ),
+          const SizedBox(height: KasySpacing.md),
+          Padding(
+            padding: const EdgeInsets.symmetric(horizontal: KasySpacing.pageHorizontalGutter),
+            child: Text(
+              t.recover_password_result.description,
+              textAlign: TextAlign.center,
+              style: context.textTheme.titleMedium!.copyWith(
+                color: context.colors.onBackground,
+              ),
+            ),
+          ),
+          const SizedBox(height: KasySpacing.md),
+          KasyButton(
+            label: t.recover_password_result.back_to_signin,
+            onPressed: () => context.pop(),
+          ),
+          const Spacer(),
+          Padding(
+            padding: const EdgeInsets.symmetric(
+              horizontal: KasySpacing.pageHorizontalGutter,
+              vertical: KasySpacing.lg,
+            ),
+            child: Text(
+              t.recover_password_result.note,
+              textAlign: TextAlign.center,
+              style: context.textTheme.titleMedium!.copyWith(
+                color: context.colors.muted,
+              ),
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+}

package/templates/firebase/lib/features/authentication/ui/widgets/round_signin.dart

@@ -0,0 +1,73 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/haptics/kasy_haptics.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+
+typedef SocialSigninCallback = void Function();
+
+class SocialSigninButton extends StatelessWidget {
+  final Image iconImage;
+  final SocialSigninCallback? onPressed;
+
+  const SocialSigninButton({
+    super.key,
+    required this.iconImage,
+    required this.onPressed,
+  });
+
+  factory SocialSigninButton.google(SocialSigninCallback onPressed) {
+    return SocialSigninButton(
+      iconImage: Image.asset("assets/icons/google.png", width: 24),
+      onPressed: onPressed,
+    );
+  }
+
+  factory SocialSigninButton.googlePlayGames(SocialSigninCallback onPressed) {
+    return SocialSigninButton(
+      iconImage: Image.asset("assets/icons/google_play_games.png", width: 24),
+      onPressed: onPressed,
+    );
+  }
+
+  factory SocialSigninButton.facebook(SocialSigninCallback onPressed) {
+    return SocialSigninButton(
+      iconImage: Image.asset("assets/icons/facebook.png", width: 24),
+      onPressed: onPressed,
+    );
+  }
+
+  factory SocialSigninButton.apple(SocialSigninCallback onPressed) {
+    return SocialSigninButton(
+      iconImage: Image.asset("assets/icons/apple.png", width: 24),
+      onPressed: onPressed,
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Container(
+      width: 56,
+      decoration: BoxDecoration(
+        border: Border.all(color: context.colors.outline),
+        shape: BoxShape.circle,
+      ),
+      child: RawMaterialButton(
+        elevation: 0,
+        focusElevation: 0,
+        hoverElevation: 0,
+        highlightElevation: 0,
+        splashColor: Colors.transparent,
+        highlightColor: Colors.transparent,
+        hoverColor: Colors.transparent,
+        focusColor: Colors.transparent,
+        onPressed: () {
+          KasyHaptics.medium(context);
+          onPressed?.call();
+        },
+        shape: const CircleBorder(),
+        fillColor: Colors.transparent,
+        padding: const EdgeInsets.all(KasySpacing.md),
+        child: iconImage,
+      ),
+    );
+  }
+}

package/templates/firebase/lib/features/authentication/ui/widgets/social_separator.dart

@@ -0,0 +1,26 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+import 'package:kasy_kit/i18n/translations.g.dart';
+
+class SocialSeparator extends StatelessWidget {
+  const SocialSeparator({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    final color = context.colors.outline.withValues(alpha: 0.28);
+    return Row(
+      children: [
+        Expanded(child: Divider(color: color, thickness: 0.8)),
+        Padding(
+          padding: const EdgeInsets.all(KasySpacing.md),
+          child: Text(
+            t.auth.signin.or_sign_in_with,
+            textAlign: TextAlign.center,
+            style: context.textTheme.labelSmall,
+          ),
+        ),
+        Expanded(child: Divider(color: color, thickness: 0.8)),
+      ],
+    );
+  }
+}

package/templates/firebase/lib/features/dev/keyboard_test_page.dart

@@ -0,0 +1,93 @@
+import 'package:flutter/material.dart';
+import 'package:kasy_kit/components/kasy_text_field.dart';
+import 'package:kasy_kit/core/theme/theme.dart';
+
+class KeyboardTestPage extends StatefulWidget {
+  const KeyboardTestPage({super.key});
+
+  @override
+  State<KeyboardTestPage> createState() => _KeyboardTestPageState();
+}
+
+class _KeyboardTestPageState extends State<KeyboardTestPage> {
+  final _name = TextEditingController();
+  final _email = TextEditingController();
+  final _phone = TextEditingController();
+  final _password = TextEditingController();
+  final _bio = TextEditingController();
+
+  @override
+  void dispose() {
+    _name.dispose();
+    _email.dispose();
+    _phone.dispose();
+    _password.dispose();
+    _bio.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Keyboard Test')),
+      body: ListView(
+        padding: EdgeInsets.fromLTRB(
+          KasySpacing.pageHorizontalGutter,
+          KasySpacing.md,
+          KasySpacing.pageHorizontalGutter,
+          MediaQuery.paddingOf(context).bottom + 40,
+        ),
+        children: [
+          const Text(
+            'Tap between the fields — the keyboard should stay open without closing and reopening.',
+            style: TextStyle(fontSize: 13, color: Colors.grey),
+          ),
+          const SizedBox(height: KasySpacing.lg),
+          KasyTextField(
+            controller: _name,
+            label: 'Name',
+            hint: 'Your full name',
+            textInputAction: TextInputAction.next,
+            textCapitalization: TextCapitalization.words,
+          ),
+          const SizedBox(height: KasyTextField.adjacentFieldSpacing),
+          KasyTextField(
+            controller: _email,
+            label: 'Email',
+            hint: 'you@example.com',
+            contentType: KasyTextFieldContentType.email,
+            keyboardType: TextInputType.emailAddress,
+            textInputAction: TextInputAction.next,
+          ),
+          const SizedBox(height: KasyTextField.adjacentFieldSpacing),
+          KasyTextField(
+            controller: _phone,
+            label: 'Phone',
+            hint: '+55 11 99999-9999',
+            contentType: KasyTextFieldContentType.phone,
+            keyboardType: TextInputType.phone,
+            textInputAction: TextInputAction.next,
+          ),
+          const SizedBox(height: KasyTextField.adjacentFieldSpacing),
+          KasyTextField(
+            controller: _password,
+            label: 'Password',
+            hint: 'Min 8 characters',
+            contentType: KasyTextFieldContentType.password,
+            textInputAction: TextInputAction.next,
+          ),
+          const SizedBox(height: KasyTextField.adjacentFieldSpacing),
+          KasyTextField(
+            controller: _bio,
+            label: 'Bio',
+            hint: 'Tell us about yourself',
+            textInputAction: TextInputAction.done,
+            minLines: 3,
+            maxLines: 5,
+            textCapitalization: TextCapitalization.sentences,
+          ),
+        ],
+      ),
+    );
+  }
+}

package/templates/firebase/lib/features/feedbacks/api/entities/feature_request_entity.dart

@@ -0,0 +1,27 @@
+import 'package:cloud_firestore/cloud_firestore.dart';
+import 'package:freezed_annotation/freezed_annotation.dart';
+// ignore: depend_on_referenced_packages
+// ignore_for_file: invalid_annotation_target
+
+import 'package:kasy_kit/core/data/entities/json_converters.dart';
+
+part 'feature_request_entity.freezed.dart';
+part 'feature_request_entity.g.dart';
+
+@freezed
+sealed class FeatureRequestEntity with _$FeatureRequestEntity {
+  const factory FeatureRequestEntity({
+    @JsonKey(includeIfNull: false, toJson: Converters.id) String? id,
+    @TimestampConverter() required DateTime creationDate,
+    @TimestampConverter() required DateTime lastUpdateDate,
+    required Map<String, String> title,
+    required Map<String, String> description,
+    required int votes,
+    required bool active, // votes are enabled for this feature
+  }) = FeatureRequestEntityData;
+
+  const FeatureRequestEntity._();
+
+  factory FeatureRequestEntity.fromJson(String id, Map<String, dynamic> json) =>
+      _$FeatureRequestEntityFromJson(json..['id'] = id);
+}

package/templates/firebase/lib/features/feedbacks/api/entities/feature_vote_entity.dart

@@ -0,0 +1,27 @@
+import 'package:cloud_firestore/cloud_firestore.dart';
+import 'package:freezed_annotation/freezed_annotation.dart';
+// ignore: depend_on_referenced_packages
+// ignore_for_file: invalid_annotation_target
+
+import 'package:kasy_kit/core/data/entities/json_converters.dart';
+
+part 'feature_vote_entity.freezed.dart';
+part 'feature_vote_entity.g.dart';
+
+@freezed
+abstract class UserFeatureVoteEntity with _$UserFeatureVoteEntity {
+  const factory UserFeatureVoteEntity({
+    @JsonKey(includeIfNull: false, toJson: Converters.id) String? id,
+    @JsonKey(name: 'creation_date')
+    @TimestampConverter()
+    required DateTime creationDate,
+    required String userId,
+    required String featureId,
+  }) = UserFeatureVoteEntityData;
+
+  const UserFeatureVoteEntity._();
+
+  factory UserFeatureVoteEntity.fromJson(
+          String id, Map<String, dynamic> json) =>
+      _$UserFeatureVoteEntityFromJson(json..['id'] = id);
+}

package/templates/firebase/lib/features/feedbacks/api/feature_request_api.dart

@@ -0,0 +1,51 @@
+import 'package:cloud_firestore/cloud_firestore.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/features/feedbacks/api/entities/feature_request_entity.dart';
+
+final featureRequestApiProvider = Provider<FeatureRequestApi>(
+  (ref) => FeatureRequestApi(
+    client: FirebaseFirestore.instance,
+  ),
+);
+
+class FeatureRequestApi {
+  final FirebaseFirestore _client;
+
+  FeatureRequestApi({
+    required FirebaseFirestore client,
+  }) : _client = client;
+
+  CollectionReference<FeatureRequestEntity?> get _collection => _client
+      .collection('feature_requests')
+      .withConverter(
+        fromFirestore: (snapshot, _) {
+          if (snapshot.exists) {
+            return FeatureRequestEntity.fromJson(snapshot.id, snapshot.data()!);
+          }
+          return null;
+        },
+        toFirestore: (data, _) => data!.toJson(),
+      );
+
+  Future<List<FeatureRequestEntity>> getAllActive() async {
+    final snapshot = await _collection.where('active', isEqualTo: true).get();
+    return snapshot.docs.map((e) => e.data()!).toList();
+  }
+
+  Future<String> create({
+    required String title,
+    required String description,
+  }) async {
+    final now = DateTime.now();
+    final entity = FeatureRequestEntity(
+      creationDate: now,
+      lastUpdateDate: now,
+      title: {'en': title, 'pt': title, 'es': title},
+      description: {'en': description, 'pt': description, 'es': description},
+      votes: 0,
+      active: false,
+    );
+    final docRef = await _collection.add(entity);
+    return docRef.id;
+  }
+}

package/templates/firebase/lib/features/feedbacks/api/feature_vote_api.dart

@@ -0,0 +1,79 @@
+import 'package:cloud_firestore/cloud_firestore.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:kasy_kit/features/feedbacks/api/entities/feature_vote_entity.dart';
+
+final featureVoteApiProvider = Provider<FeatureVoteApi>(
+  (ref) => FeatureVoteApi(
+    client: FirebaseFirestore.instance,
+  ),
+);
+
+class FeatureVoteApi {
+  final FirebaseFirestore _client;
+
+  FeatureVoteApi({
+    required FirebaseFirestore client,
+  }) : _client = client;
+
+  CollectionReference<UserFeatureVoteEntity?> _featureVoteCollection(
+          String featureId) =>
+      _client
+          .collection('feature_requests')
+          .doc(featureId)
+          .collection('votes')
+          .withConverter(
+            fromFirestore: (snapshot, _) {
+              if (snapshot.exists) {
+                return UserFeatureVoteEntity.fromJson(
+                    snapshot.id, snapshot.data()!);
+              }
+              return null;
+            },
+            toFirestore: (data, _) => data!.toJson(),
+          );
+
+  Query<UserFeatureVoteEntity?> get collectionGroup =>
+      _client.collectionGroup('votes').withConverter(
+            fromFirestore: (snapshot, _) {
+              if (snapshot.exists) {
+                return UserFeatureVoteEntity.fromJson(
+                    snapshot.id, snapshot.data()!);
+              }
+              return null;
+            },
+            toFirestore: (data, _) => data!.toJson(),
+          );
+
+  Future<List<UserFeatureVoteEntity>> getUserVotes(String userId) async {
+    final snapshot =
+        await collectionGroup.where('userId', isEqualTo: userId).get();
+    return snapshot.docs.map((e) => e.data()!).toList();
+  }
+
+  Future<UserFeatureVoteEntity> create(String userId, String featureId) async {
+    final result = UserFeatureVoteEntity(
+      id: userId,
+      userId: userId,
+      creationDate: DateTime.now(),
+      featureId: featureId,
+    );
+    final batch = _client.batch();
+    batch.set(_featureVoteCollection(featureId).doc(userId), result);
+    batch.update(
+      _client.collection('feature_requests').doc(featureId),
+      {'votes': FieldValue.increment(1), 'last_update_date': FieldValue.serverTimestamp()},
+    );
+    await batch.commit();
+    return result;
+  }
+
+  Future<void> delete(String featureId, String voteId) async {
+    final batch = _client.batch();
+    batch.delete(_featureVoteCollection(featureId).doc(voteId));
+    batch.update(
+      _client.collection('feature_requests').doc(featureId),
+      {'votes': FieldValue.increment(-1), 'last_update_date': FieldValue.serverTimestamp()},
+    );
+    await batch.commit();
+  }
+}

package/templates/firebase/lib/features/feedbacks/models/feature_requests.dart

@@ -0,0 +1,48 @@
+import 'package:freezed_annotation/freezed_annotation.dart';
+import 'package:kasy_kit/features/feedbacks/api/entities/feature_request_entity.dart';
+import 'package:kasy_kit/features/feedbacks/api/entities/feature_vote_entity.dart';
+
+part 'feature_requests.freezed.dart';
+
+@freezed
+abstract class FeatureRequest with _$FeatureRequest {
+  const factory FeatureRequest({
+    required String id,
+    required DateTime creationDate,
+    required String title,
+    required String description,
+    required int votes,
+  }) = FeatureRequestData;
+
+  const FeatureRequest._();
+
+  factory FeatureRequest.from(FeatureRequestEntity entity, String language) {
+    return FeatureRequest(
+      id: entity.id!,
+      creationDate: entity.creationDate,
+      title: entity.title.containsKey(language)
+          ? entity.title[language]!
+          : entity.title['en']!,
+      description: entity.description.containsKey(language)
+          ? entity.description[language]!
+          : entity.description['en']!,
+      votes: entity.votes,
+    );
+  }
+}
+
+@freezed
+abstract class FeatureRequestVote with _$FeatureRequestVote {
+  const factory FeatureRequestVote({
+    required String id,
+    required String featureId,
+  }) = FeatureRequestVoteData;
+
+  const FeatureRequestVote._();
+
+  factory FeatureRequestVote.from(UserFeatureVoteEntity entity) =>
+      FeatureRequestVote(
+        id: entity.id!,
+        featureId: entity.featureId,
+      );
+}

package/templates/firebase/lib/features/feedbacks/models/feedback_state.dart

@@ -0,0 +1,43 @@
+import 'package:kasy_kit/features/feedbacks/models/feature_requests.dart';
+
+class FeebackPageState {
+  List<FeatureRequestVote> userVotes;
+  List<FeatureRequest> featureRequests;
+
+  FeebackPageState({
+    required this.featureRequests,
+    required this.userVotes,
+  });
+
+  FeebackPageState copyWith({
+    List<FeatureRequest>? featureRequests,
+    List<FeatureRequestVote>? userVotes,
+  }) {
+    return FeebackPageState(
+      featureRequests: featureRequests ?? this.featureRequests,
+      userVotes: userVotes ?? this.userVotes,
+    );
+  }
+
+  FeebackPageState addVote(FeatureRequest feature, int vote) {
+    final index =
+        featureRequests.indexWhere((element) => element.id == feature.id);
+    if (index == -1) {
+      return this;
+    }
+    final newFeature = featureRequests[index].copyWith(
+      votes: (feature.votes + vote).clamp(0, double.maxFinite.toInt()),
+    );
+    final newFeatureRequests = List<FeatureRequest>.from(featureRequests);
+    newFeatureRequests[index] = newFeature;
+    return copyWith(featureRequests: newFeatureRequests);
+  }
+
+  bool hasVoted(FeatureRequest feature) {
+    return userVotes.any((element) => element.featureId == feature.id);
+  }
+
+  bool canVote() {
+    return userVotes.isEmpty;
+  }
+}

package/templates/firebase/lib/features/feedbacks/providers/feedback_page_notifier.dart

@@ -0,0 +1,147 @@
+import 'package:flutter/foundation.dart';
+import 'package:kasy_kit/core/states/translations.dart';
+import 'package:kasy_kit/core/states/user_state_notifier.dart';
+import 'package:kasy_kit/core/toast/toast_service.dart';
+import 'package:kasy_kit/features/feedbacks/models/feature_requests.dart';
+import 'package:kasy_kit/features/feedbacks/models/feedback_state.dart';
+import 'package:kasy_kit/features/feedbacks/repositories/feature_request_repository.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'feedback_page_notifier.g.dart';
+
+@Riverpod()
+class FeedbackPageNotifier extends _$FeedbackPageNotifier {
+  bool _isVoting = false;
+
+  @override
+  Future<FeebackPageState> build() async {
+    final featureRequestRepository = ref.read(featureRequestRepositoryProvider);
+    final userId = ref.read(userStateNotifierProvider).user.idOrNull;
+
+    final userVotes = userId != null
+        ? await featureRequestRepository.getUserVotes(userId)
+        : <FeatureRequestVote>[];
+    final features = await featureRequestRepository.getActiveFeatureRequests();
+    features.sort((a, b) => b.votes.compareTo(a.votes));
+
+    return FeebackPageState(
+      featureRequests: features,
+      userVotes: userVotes,
+    );
+  }
+
+  Future<void> vote(FeatureRequest featureRequest) async {
+    if (_isVoting) return;
+    _isVoting = true;
+    final translations = ref.read(translationsProvider).feature_requests;
+
+    if (state.value!.hasVoted(featureRequest)) {
+      await _unVote(featureRequest);
+      _isVoting = false;
+      return;
+    }
+
+    final oldState = state.value!;
+    final featureRequestRepository = ref.read(featureRequestRepositoryProvider);
+    final userState = ref.read(userStateNotifierProvider);
+
+    try {
+      final userId = userState.user.idOrNull;
+      if (userId == null) return;
+
+      // Optimistic update: count +1 AND mark as voted immediately so
+      // hasVoted returns true right away (prevents inverted toggle).
+      final optimisticVote = FeatureRequestVote(
+        id: '_optimistic',
+        featureId: featureRequest.id,
+      );
+      var newState = state.value!
+          .addVote(featureRequest, 1)
+          .copyWith(
+            userVotes: [...state.value!.userVotes, optimisticVote],
+          );
+      state = AsyncData(newState);
+
+      final userVote = await featureRequestRepository.vote(
+        userId,
+        featureRequest,
+      );
+      // Replace optimistic entry with real vote from server.
+      newState = newState.copyWith(userVotes: [
+        ...newState.userVotes.where((v) => v.id != '_optimistic'),
+        userVote,
+      ]);
+      state = AsyncData(newState);
+      ref.read(toastProvider).success(
+            title: translations.vote_success.title,
+            text: translations.vote_success.description,
+          );
+    } catch (e) {
+      state = AsyncData(oldState);
+      ref.read(toastProvider).error(
+            title: translations.vote_error.title,
+            text: translations.vote_error.description,
+          );
+    } finally {
+      _isVoting = false;
+    }
+  }
+
+  Future<void> _unVote(FeatureRequest featureRequest) async {
+    final oldState = state.value!;
+    final featureRequestRepository = ref.read(featureRequestRepositoryProvider);
+    final userState = ref.read(userStateNotifierProvider);
+
+    try {
+      final userId = userState.user.idOrNull;
+      if (userId == null) return;
+      final voteToDelete = oldState.userVotes
+          .where((e) => e.featureId == featureRequest.id)
+          .firstOrNull;
+      if (voteToDelete == null) return;
+
+      var newState = oldState.addVote(featureRequest, -1);
+      newState = newState.copyWith(userVotes: [
+        ...newState.userVotes.where((e) => e.featureId != featureRequest.id),
+      ]);
+      state = AsyncData(newState);
+
+      // If the vote was only optimistic (never reached the server), skip delete.
+      if (voteToDelete.id == '_optimistic') return;
+      await featureRequestRepository.removeVote(userId, voteToDelete);
+    } catch (e) {
+      debugPrint('Error while unvoting: $e');
+      state = AsyncData(oldState);
+    }
+  }
+
+  Future<void> createFeatureSuggestion({
+    required String title,
+    required String description,
+  }) async {
+    final userId = ref.read(userStateNotifierProvider).user.idOrNull;
+    if (userId == null) return;
+    if (title.isEmpty || description.isEmpty) {
+      final tr = ref.read(translationsProvider).feature_requests.add_feature;
+      ref.read(toastProvider).error(
+            title: tr.error_title,
+            text: tr.error_required,
+          );
+      return;
+    }
+    if (description.length < 40) {
+      final tr = ref.read(translationsProvider).feature_requests.add_feature;
+      ref.read(toastProvider).error(
+            title: tr.error_title,
+            text: tr.error_too_short,
+          );
+      return;
+    }
+    final featureRequestRepository = ref.read(featureRequestRepositoryProvider);
+    await featureRequestRepository.createNewFeatureSuggestion(
+      userId: userId,
+      title: title,
+      description: description,
+    );
+  }
+}