docs: minor changes

.firebaserc

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "cooler-alerts"
+  }
+}

.github/ISSUE_TEMPLATE/BUG_REPORT.md

@@ -0,0 +1,24 @@
+---
+name: '🐞 Bug Report'
+about: Create a report
+title: ''
+labels: ['type:Bug', 'status:Unconfirmed']
+assignees: ''
+---
+
+<!--
+Found a bug? Please fill out the sections below. 👍
+-->
+
+### Issue Summary
+
+<!--
+A summary of the issue.
+-->
+
+### Steps to Reproduce
+
+1. 
+
+Any other relevant information. For example, why do you consider this a bug and what did you expect to happen instead?
+

.github/ISSUE_TEMPLATE/FEATURE_REQUEST.md

@@ -0,0 +1,40 @@
+---
+name: '🚀 Feature request'
+about: Suggest an idea/concept/feature to enhance the project
+title: ''
+labels: 'type:Enhancement'
+assignees: ''
+---
+
+### Is your proposal related to a problem?
+
+<!--
+  Provide a clear and concise description of what the problem is.
+-->
+
+(Write your answer here.)
+
+### Describe the solution you'd like
+
+<!--
+  Provide a clear and concise description of what you want to happen.
+-->
+
+(Describe your proposed solution here.)
+
+### Describe alternatives you've considered
+
+<!--
+  Let us know about other solutions you've tried or researched.
+-->
+
+(Write your answer here.)
+
+### Additional context
+
+<!--
+  Is there anything else you can add about the proposal?
+  You might want to link to related issues here, if you haven't already.
+-->
+
+(Write your answer here.)

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

.github/PULL_REQUEST_TEMPLATE/pull_request_template.md

@@ -0,0 +1,15 @@
+# Description
+
+Please include a summary of the change(s) and which issue(s) are to be fixed/addressed or feature(s) to be added. Please also include relevant motivation and context. List any dependencies that are required for this change.
+
+
+## Type of change
+
+Please delete options that are not relevant.
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] This change requires a documentation update
+
+## Screenshots (if appropriate):

.github/workflows/flutter-prod.yml

@@ -0,0 +1,74 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Flutter analyze, test & deploy example web app
+
+on:
+  push:
+    branches: [ "prod" ]
+
+  workflow_dispatch:
+
+env:
+  FLUTTER_VERSION: 3.27.4
+
+jobs:
+  build_and_test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: ${{ env.FLUTTER_VERSION }}
+          channel: 'stable'
+          cache: true
+
+      - run: flutter --version
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Analyze project source
+        run: flutter analyze
+
+      - name: Run tests
+#        run: flutter test --coverage
+        run: echo "Ignoring tests for now."
+
+  deploy-example-web:
+    runs-on: ubuntu-latest
+    needs: build_and_test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Flutter build environment
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: ${{ env.FLUTTER_VERSION }}
+          channel: 'stable'
+          cache: true
+
+      - run: flutter config --enable-web
+      - run: cd ./example; flutter build web --release --target=lib/main.dart --output=build/web
+
+      - name: Archive Production Artifact
+        uses: actions/upload-artifact@master
+        with:
+          name: web-build
+          path: example/build/web
+
+      - name: Firebase Deploy
+        uses: FirebaseExtended/action-hosting-deploy@v0
+        with:
+          repoToken: '${{ secrets.GITHUB_TOKEN }}'
+          firebaseServiceAccount: '${{ secrets.FIREBASE_SERVICE_ACCOUNT_COOLER_ALERTS }}'
+          channelId: live
+          projectId: cooler-alerts
+

CHANGELOG.md

@@ -1,3 +1,27 @@
+## [2.1.2] - 04/03/2025
+
+- Fix: resource animation strings
+- Use `cool_flare` as `flare_flutter` dependency
+- Update example app
+- Update pubspec
+- Update README
+
+## [2.1.1] - 04/03/2025
+
+- Update: example
+- Update: README
+- Fix: pubspec documentation
+
+## [2.1.0] - 04/03/2025
+
+- Added TextAlign & Overflow options for title & text (or body).
+- **BREAKING CHANGES!**: added dialog context to `confirmBtnTap` and `cancelBtnTap` functions. Signatures now are:
+```dart
+void Function(BuildContext context);
+```
+- Added `PopScope` widget with `canPop` to prevent unwanted navigation while dialog is showing.
+- Updated README
+
 ## [2.0.1] - 06/03/2023
 
 - Updated README

README.md

@@ -1,59 +1,103 @@
-# cool_alert
+# cooler_alerts
 
 A Flutter package to display animated alert dialogs
 
+**Please note - the origin [author](https://github.com/emrade) of the [cool_alert](https://pub.dev/packages/cool_alert) hasn't provided updates for an extended period of time.** This package serves to support, and enhance the existing package.
+
 ## Usage
 
-To use this package, add cool_alert as a dependency in your pubspec.yaml file.
-And add this import to your file.
+To use this package, add the package as dependency in your `pubspec.yaml` file.
+
+```dart
+cooler_alerts: ^2.1.2
+```
+
+Then, add this import to your dart file.
+
+```dart
+import 'package:cooler_alerts/cooler_alerts.dart';
+```
 
-import 'package:cool_alert/cool_alert.dart';
+### Coming from the original `cool_alert` package?
+
+The transition is simple: 
+1. change the package name in `pubspec.yaml` from `cool_alert` to `cooler_alerts`
+2. replace all package references from
+```dart
+package:cool_alert/cool_alert.dart;
+```
+to
+```dart
+package:cooler_alerts/cooler_alerts.dart;
+```
 
 ## Image
 ![Screenshot  Gif](screenshots/gif.gif)
 
 ### Example
 
-```
+```dart
 CoolAlert.show(
    context: context,
    type: CoolAlertType.success,
    text: "Your transaction was successful!",
 );
 ```
 
-
 ### CoolAlert Class
 
+| Attribute            | Data type         | Description                                                                     |                               Default Value                               |
+|:---------------------|:------------------|:--------------------------------------------------------------------------------|:-------------------------------------------------------------------------:|
+| context              | BuildContext      | @required                                                                       |                                   Null                                    |
+| type                 | CoolAlertType     | @required - Type of alert dialog, ex: CoolAlertType.success for success dialogs |                                   Null                                    |
+| title                | String            | Set a custom title for dialog                                                   |                    Based on the CoolAlertType selected                    |
+| text                 | String            | Set the description text of the dialog.                                         |                                   Null                                    |
+| widget               | Widget            | Set any you expect widget of the dialog.                                        |                                   Null                                    |
+| confirmBtnText       | String            | Text of confirm button                                                          |                                   'Ok'                                    |
+| confirmBtnTap        | void Function(BuildContext)? | Function that handle click of confirm button, provides dialog context parameter. |                          (c) => Navigator.pop(c)                          |
+| confirmBtnColor      | Color             | Color of confirm Button                                                         |                      Theme.of(context).primaryColor                       |
+| cancelBtnText        | String            | Text of cancel button                                                           |                                 'Cancel'                                  |
+| cancelBtnTap         | void Function(BuildContext)? | Function that handle click of cancel button, provides dialog context parameter.  |                          (c) => Navigator.pop(c)                          |
+| barrierDismissible   | bool              | Dismiss dialog on touch overlay                                                 |                                   true                                    |
+| animType             | CoolAlertAnimType | Type of dialogue enter animation                                                |                          CoolAlertAnimType.scale                          |
+| backgroundColor      | Color             | Background color of the animation                                               |                             Color(0xFF515C6F)                             |
+| confirmBtnTextStyle  | TextStyle         | Confirm button text theme                                                       | TextStyle(color: Colors.white, fontWeight:FontWeight.w600,fontSize: 18.0) |
+| cancelBtnTextStyle   | TextStyle         | Cancel button text theme                                                        | TextStyle(color: Colors.grey, fontWeight:FontWeight.w600,fontSize: 18.0)  |
+| flareAsset           | String            | Custom flare asset                                                              |                              "animation.flr"                              |
+| flareAnimationName   | String            | The name of the flare animation to play                                         |                                  "play"                                   |
+| lottieAsset          | String            | Custom lottie asset                                                             |                             "animation.json"                              |
+| autoCloseDuration    | Duration          | Determines how long the dialog stays open for before closing                    |                                   Null                                    |
+| width                | double            | Dialog width                                                                    |                     MediaQuery.of(context).size.width                     |
+| loopAnimation        | boolean           | Determines if the animation should loop or not                                  |                                   false                                   |
+| closeOnConfirmBtnTap | boolean           | Detemines if dialog closes when the confirm button is tapped                    |                                   true                                    |
+| reverseBtnOrder      | boolean           | Reverse the order of the buttons                                                |                                   false                                   |
+| titleTextAlign       | TextAlign         | Text alignment for title                                                        |                             TextAlign.center                              |
+| titleOverflow        | TextOverflow      | Text overflow for title                                                         |                                   Null                                    |
+| textTextAlign        | TextAlign         | Text alignment for text                                                         |                             TextAlign.center                              |
+| textOverflow         | TextOverflow      | Text overflow for text                                                          |                                   Null                                    |
+| canPop               | boolean                      | Prevents undesired navigation unless explicitly desired.                         |                                   true                                    |
+| onPopInvoked         | void Function(bool)?         | Notifies of whether the context was popped with `didPop` parameter               |                                   Null                                    |
+
+### Popping the dialog
+
+To pop the dialog from one of the buttons, you have the following options.
+
+1. Using `closeOnConfirmBtnTap: true` will automatically pop the dialog when the confirm button is tapped.
+2. Using `confirmBtnTap` or `cancelBtnTap` functions to pop the dialog manually. This should be done with the context provided (see notes below)
+```dart
+CoolAlert.show(
+   context: context,
+   type: CoolAlertType.success,
+   text: "Your transaction was successful!",
+   confirmBtnTap: (dialogContext) {
+      Navigator.pop(dialogContext);
+   }
+);
+```
+**Notes:** 
 
-| Attribute        | Data type           | Description                                                                                                                                                   |            Default Value            |
-|:----------------------|:-------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------:|
-| context| BuildContext | @required                                                                                      |                Null                 |
-| type | CoolAlertType | @required - Type of alert dialog, ex: CoolAlertType.success for success dialogs | Null
-title| String | Set a custom title for dialog                                                                                                |                Based on the CoolAlertType selected|                 |
-| text| String             | Set the description text of the dialog.                                                                                                                       |                Null                 |
-| widget| Widget             | Set any you expect widget of the dialog.                                                                                                                       |                Null                 |
-| confirmBtnText | String             | Text of confirm button                                                                                                                                       |                'Ok'                 |                 |
-| confirmBtnTap| Function           | Function that handle click of confirm button                                                                       |                () => Navigator.pop(context)|
-| confirmBtnColor| Color              | Color of confirm Button                                                                                                                                       |          Theme.of(context).primaryColor          |                |
-| cancelBtnText| String             | Text of cancel button                                                                                                                                       |              'Cancel'               |
-| cancelBtnTap| Function           | Function that handle click of cancel button                                                                     |                () => Navigator.pop(context) 
-| barrierDismissible| bool               | Dismiss dialog on touch overlay                                                                                                                              |                true                 
-| animType              | CoolAlertAnimType| Type of dialogue enter animation                                                                                                                              |           CoolAlertAnimType.scale|
-| backgroundColor              | Color| Background color of the animation                                                                                                                              |           Color(0xFF515C6F)|
-| confirmBtnTextStyle              | TextStyle | Confirm button text theme                                                                                                                              |           TextStyle(color: Colors.white, fontWeight:FontWeight.w600,fontSize: 18.0)|
-| cancelBtnTextStyle              | TextStyle | Cancel button text theme                                                                                                                             |           TextStyle(color: Colors.grey, fontWeight:FontWeight.w600,fontSize: 18.0)|
-| flareAsset              | String | Custom flare asset                                                                                                                             |           "animation.flr" |
-| flareAnimationName              | String | The name of the flare animation to play                                                                                                                             |           "play" |
-| lottieAsset              | String | Custom lottie asset                                                                                                                             |           "animation.json" |
-|autoCloseDuration|Duration|Determines how long the dialog stays open for before closing|Null|
-|width|double|Dialog width|MediaQuery.of(context).size.width|
-|loopAnimation|boolean|Determines if the animation should loop or not|false|
-|closeOnConfirmBtnTap|boolean|Detemines if dialog closes when the confirm button is tapped|true|
-|reverseBtnOrder|boolean|Reverse the order of the buttons|false|
-
-
-
+- if you have have `closeOnConfirmBtnTap: true` while calling `Navigator.pop(dialogContext)` in the above example, you'll pop twice and may run into some issues. Have either one or the other.
+- If you have `autoCloseDuration` set, this is a wrapper for `Navigator.pop(coolAlertParentContext, rootNavigator: true)` after the duration is up. In the above example, if the user taps "confirm" and the dialog auto closes, it will pop twice and you may run into issues.
 
 
 

example/android/app/build.gradle

@@ -26,6 +26,7 @@ apply plugin: 'kotlin-android'
 apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
 
 android {
+    namespace "com.example.example"
     compileSdkVersion flutter.compileSdkVersion
     ndkVersion flutter.ndkVersion
 

example/android/build.gradle

@@ -1,12 +1,12 @@
 buildscript {
-    ext.kotlin_version = '1.7.10'
+    ext.kotlin_version = '1.9.0'
     repositories {
         google()
         mavenCentral()
     }
 
     dependencies {
-        classpath 'com.android.tools.build:gradle:7.2.0'
+        classpath 'com.android.tools.build:gradle:8.5.1'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
@@ -26,6 +26,6 @@ subprojects {
     project.evaluationDependsOn(':app')
 }
 
-task clean(type: Delete) {
+tasks.register("clean", Delete) {
     delete rootProject.buildDir
 }

example/android/gradle/wrapper/gradle-wrapper.properties

@@ -2,4 +2,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.8-all.zip