@marcos_feitoza/personal-finance-frontend-core-ui 1.0.2 → 1.1.0

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+# [1.1.0](https://github.com/MarcosOps/personal-finance-frontend-core-ui/compare/v1.0.2...v1.1.0) (2025-11-28)
+
+
+### Features
+
+* add confirmation dialog for deletion operations ([029b159](https://github.com/MarcosOps/personal-finance-frontend-core-ui/commit/029b159d370e2c68f71afeefb320dea7182b58bb))
+* update readme.me ([7b1ac44](https://github.com/MarcosOps/personal-finance-frontend-core-ui/commit/7b1ac445a2b3183283779f710e46a0fed7238657))
+
 ## [1.0.2](https://github.com/MarcosOps/personal-finance-frontend-core-ui/compare/v1.0.1...v1.0.2) (2025-11-26)
 
 

package/README.md

@@ -1,16 +1,35 @@
-# personal_finance_frontend_core_ui
+# Core UI - Frontend (Flutter)
 
-A new Flutter project.
+Este pacote contém os widgets e componentes de interface do usuário (UI) reutilizáveis para a aplicação Personal Finance Frontend.
 
-## Getting Started
+## Propósito
 
-This project is a starting point for a Flutter application.
+O objetivo deste pacote é centralizar e padronizar a aparência e o comportamento dos elementos de UI em todo o aplicativo. Ele fornece uma biblioteca de componentes que podem ser utilizados por outros pacotes de feature, garantindo consistência visual e reduzindo a duplicação de código.
 
-A few resources to get you started if this is your first Flutter project:
+## Conteúdo Principal
 
-- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
-- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
+- **`widgets/`**: Contém diversos widgets reutilizáveis, como `AppFormCard`, `AppDropdown`, `TradeForm`, `DividendLogForm`, `CryptoTradeForm`, `RrspContributionForm`, etc.
+- **`utils/app_dialogs.dart`**: Funções utilitárias para exibir diálogos padronizados (ex: confirmação de exclusão).
+- **`utils/app_logger.dart`**: Implementação de um logger condicional que exibe logs apenas em modo de depuração.
+- **`utils/currency_input_formatter.dart`**: Formatter para campos de entrada de moeda.
+- **`utils/theme_notifier.dart`**: Provedor para gerenciar o tema da aplicação (claro/escuro).
 
-For help getting started with Flutter development, view the
-[online documentation](https://docs.flutter.dev/), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+---
+
+## Como Usar (Instalação como Dependência)
+
+Este pacote é uma dependência local para a aplicação principal (`personal-finance-frontend`) e outras features packages do frontend.
+
+No `pubspec.yaml` do pacote consumidor, adicione a seguinte linha em `dependencies`:
+
+```yaml
+personal_finance_frontend_core_ui:
+  path: ../personal-finance-frontend-core-ui
+```
+
+## Features
+
+-   **Widgets Reutilizáveis**: Componentes de UI com design e comportamento padronizados.
+-   **Diálogos Centralizados**: Funções para exibir diálogos consistentes em todo o aplicativo.
+-   **Logging Condicional**: Um logger que ajuda a manter o console limpo em produção, exibindo mensagens apenas em desenvolvimento.
+-   **Ferramentas de Formatação**: Utilitários para formatar entradas de usuário (ex: valores monetários).

package/lib/utils/app_dialogs.dart

@@ -0,0 +1,30 @@
+import 'package:flutter/material.dart';
+
+class AppDialogs {
+  /// Displays a confirmation dialog for deletion operations.
+  ///
+  /// Returns `true` if the user confirms deletion, `false` otherwise.
+  static Future<bool?> showDeleteConfirmationDialog(
+      BuildContext context, String itemName) async {
+    return await showDialog<bool>(
+      context: context,
+      builder: (BuildContext context) {
+        return AlertDialog(
+          title: const Text('Confirmar Exclusão'),
+          content: Text(
+              'Você tem certeza que deseja excluir "$itemName"? Esta ação não pode ser desfeita.'),
+          actions: <Widget>[
+            TextButton(
+              onPressed: () => Navigator.of(context).pop(false),
+              child: const Text('Cancelar'),
+            ),
+            TextButton(
+              onPressed: () => Navigator.of(context).pop(true),
+              child: const Text('Excluir'),
+            ),
+          ],
+        );
+      },
+    );
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@marcos_feitoza/personal-finance-frontend-core-ui",
-    "version": "1.0.2",
+    "version": "1.1.0",
     "publishConfig": {
         "access": "public"
     },