Added WebView dialog support and bumped version to 2.1.0

Author: TutorialsAndroid

CHANGELOG.md

@@ -1,138 +1,81 @@
-## 2.0.0
+## 2.1.0
 
-Major feature upgrade release.
+Feature update release.
 
-This release brings KAlertFlutter much closer to the native Android Java KAlertDialog library with a modern dialog API, professional UI styling, advanced customization, input validation, image dialogs, progress dialogs, and backward compatibility with the old API.
+This release adds WebView dialog support to KAlertFlutter, making the Flutter package more closely aligned with the native Android Java KAlertDialog library. WebView dialogs are useful for showing Terms and Conditions, Privacy Policy, Refund Policy, Help pages, FAQ pages, documentation pages, or any hosted web content directly inside a dialog.
 
 ### New features
 
-- Added new `KAlertDialog` API.
-- Added `KAlertDialog.show()`.
-- Added `KAlertDialog.success()`.
-- Added `KAlertDialog.error()`.
-- Added `KAlertDialog.warning()`.
-- Added `KAlertDialog.info()`.
-- Added `KAlertDialog.question()`.
-- Added `KAlertDialog.progress()`.
-- Added `KAlertDialog.input()`.
-- Added `KAlertDialog.customView()`.
-- Added `KAlertDialog.customImage()`.
-- Added `KAlertDialog.urlImage()`.
-
-### New dialog types
-
-- Added `KAlertType.normal`.
-- Added `KAlertType.success`.
-- Added `KAlertType.error`.
-- Added `KAlertType.warning`.
-- Added `KAlertType.info`.
-- Added `KAlertType.question`.
-- Added `KAlertType.progress`.
-- Added `KAlertType.input`.
-- Added `KAlertType.customImage`.
-- Added `KAlertType.urlImage`.
-- Added `KAlertType.customView`.
-
-### New style presets
-
-- Added `KAlertStyle.classic`.
-- Added `KAlertStyle.modern`.
-- Added `KAlertStyle.minimal`.
-- Added `KAlertStyle.rounded`.
-
-### Image dialog support
-
-- Added custom image dialog support.
-- Added URL image dialog support.
-- Added big URL image mode.
-- Added circle URL image mode.
-- Added `KAlertImageType.big`.
-- Added `KAlertImageType.circle`.
-- Added URL image placeholder support.
-- Added URL image error widget support.
-
-### Input dialog improvements
-
-- Added input validation support.
-- Added input max length support.
-- Added keyboard type support.
-- Added initial input value support.
-- Added input confirm callback.
-- Fixed input dialog controller lifecycle handling.
-- Fixed TextEditingController disposed error.
-
-### Custom view support
-
-- Added support for placing any custom Flutter widget inside the dialog.
-- Added custom view dialog API using `KAlertDialog.customView()`.
-
-### Progress dialog support
-
-- Added progress/loading dialog.
-- Added non-dismissible progress dialog support.
-- Added custom progress color support.
-
-### Dialog customization
-
-- Added custom dialog corner radius.
-- Added custom dialog elevation.
-- Added custom dim amount.
-- Added custom max width.
-- Added custom background color.
-- Added custom title color.
-- Added custom content color.
-- Added custom icon color.
-- Added custom title text style.
-- Added custom content text style.
-- Added title font weight support.
-- Added content font weight support.
-- Added title text size support.
-- Added content text size support.
-
-### Button customization
-
-- Added confirm button text customization.
-- Added cancel button text customization.
-- Added confirm button color customization.
-- Added cancel button color customization.
-- Added confirm button text color customization.
-- Added cancel button text color customization.
-- Added button text size customization.
-- Added confirm button font weight support.
-- Added cancel button font weight support.
-- Added button all-caps control.
-- Added show/hide confirm button support.
-- Added show/hide cancel button support.
-
-### Callback APIs
-
-- Added `onShow` callback.
-- Added `onDismiss` callback.
-- Added `onConfirm` callback.
-- Added `onCancel` callback.
-- Added input confirm callback.
-
-### UI improvements
-
-- Added modern Material-style dialog design.
-- Added smooth fade and scale transition animation.
-- Added animated dialog icons.
-- Added dark mode friendly styling.
-- Added responsive dialog max height handling.
-- Added scroll handling to prevent keyboard overflow.
-- Improved dialog spacing, radius, colors, and button layout.
-
-### Backward compatibility
-
-- Kept old `KAlert.show()` API.
-- Kept old `KAlert.confirm()` API.
-- Kept old `KAlert.prompt()` API.
-- Old API now uses the new modern dialog UI internally.
-
-### Fixes
-
-- Fixed generic result type issue with `KAlertResult<String>`.
-- Fixed `KAlertResult<dynamic>` type error on confirm button click.
-- Fixed `TextEditingController was used after being disposed` issue in input dialogs.
-- Fixed keyboard overflow issue in input dialogs.
-- Improved dialog closing behavior for input and custom callback flows.
+- Added WebView dialog support.
+- Added `KAlertType.webView`.
+- Added `KAlertDialog.webView()`.
+- Added `KAlertDialog.showWebView()`.
+- Added backward-compatible `KAlert.webView()`.
+- Added support for loading hosted web pages inside dialogs.
+- Added Terms and Privacy Policy dialog support.
+- Added Refund Policy, Help, FAQ, and documentation page dialog support.
+- Added horizontal WebView loading progress support.
+- Added center WebView loading spinner support.
+- Added WebView created callback.
+- Added WebView progress callback.
+- Added WebView page started callback.
+- Added WebView page finished callback.
+- Added WebView page error callback.
+- Added navigation request callback support.
+- Added JavaScript enable/disable option.
+- Added WebView zoom enable/disable option.
+- Added configurable WebView height.
+- Added configurable progress color.
+- Added main-frame-only WebView error handling to avoid false errors from failed favicon, script, CSS, image, iframe, or analytics resources.
+
+### New dependency
+
+- Added `webview_flutter` for WebView rendering.
+
+### Usage
+
+```dart
+final result = await KAlertDialog.webView(
+  context: context,
+  title: 'Terms & Privacy Policy',
+  content: 'Please read our terms and privacy policy before continuing.',
+  url: 'https://policies.google.com/privacy',
+  webViewHeight: 420,
+  showHorizontalProgress: true,
+  showCenterLoader: true,
+  javaScriptEnabled: true,
+  enableZoom: false,
+  showCancelButton: true,
+  confirmText: 'I Agree',
+  cancelText: 'Cancel',
+);
+
+if (result?.confirmed == true) {
+  debugPrint('Accepted');
+}
+````
+
+### Backward-compatible usage
+
+```dart
+final accepted = await KAlert.webView(
+  context,
+  url: 'https://policies.google.com/privacy',
+  title: 'Terms & Privacy Policy',
+  message: 'Please read the page before continuing.',
+);
+
+if (accepted == true) {
+  debugPrint('Accepted');
+}
+```
+
+### Platform note
+
+For Android apps, make sure Internet permission is added in `android/app/src/main/AndroidManifest.xml`:
+
+```xml
+<uses-permission android:name="android.permission.INTERNET" />
+```
+
+For best compatibility, use `https://` URLs for Terms, Privacy Policy, Help, FAQ, and documentation pages.