Add documentation for enableAutomaticFormSubmission feature

Co-authored-by: maurovanetti <402070+maurovanetti@users.noreply.github.com>

Author: Copilot

CHANGELOG.md

@@ -1,3 +1,7 @@
+## Unreleased
+
+- feat: Add `enableAutomaticFormSubmission` flag to prevent automatic form submission when pressing Enter on on-screen keyboard in all auth components (SupaEmailAuth, SupaPhoneAuth, SupaMagicAuth, SupaResetPassword)
+
 ## 0.5.5
 
 - feat: Add Confirm Password Field to SupaEmailAuth Component for Sign-Up Process [#129](https://github.com/supabase-community/flutter-auth-ui/pull/129)

README.md

@@ -133,3 +133,53 @@ SupaSocialsAuth(
 
 This library uses bare Flutter components so that you can control the appearance of the components using your own theme.
 See theme example in example/lib/sign_in.dart
+
+## Controlling Form Submission Behavior
+
+All auth components (`SupaEmailAuth`, `SupaPhoneAuth`, `SupaMagicAuth`, and `SupaResetPassword`) support the `enableAutomaticFormSubmission` parameter to control whether pressing Enter/Done on the on-screen keyboard automatically submits the form.
+
+By default, this is set to `true` for backward compatibility, which means pressing Enter will submit the form. If you want users to be forced to explicitly tap the submit button, set this to `false`:
+
+```dart
+SupaEmailAuth(
+  redirectTo: kIsWeb ? null : 'io.mydomain.myapp://callback',
+  enableAutomaticFormSubmission: false, // Disable auto-submit on Enter
+  onSignInComplete: (response) {
+    // do something, for example: navigate('home');
+  },
+  onSignUpComplete: (response) {
+    // do something, for example: navigate("wait_for_email");
+  },
+),
+```
+
+This applies to all auth components:
+
+```dart
+// Phone Auth
+SupaPhoneAuth(
+  authAction: SupaAuthAction.signIn,
+  enableAutomaticFormSubmission: false,
+  onSuccess: (response) {
+    // handle success
+  },
+),
+
+// Magic Link Auth
+SupaMagicAuth(
+  redirectUrl: kIsWeb ? null : 'io.supabase.flutter://reset-callback/',
+  enableAutomaticFormSubmission: false,
+  onSuccess: (Session response) {
+    // handle success
+  },
+),
+
+// Reset Password
+SupaResetPassword(
+  accessToken: supabase.auth.currentSession?.accessToken,
+  enableAutomaticFormSubmission: false,
+  onSuccess: (UserResponse response) {
+    // handle success
+  },
+),
+```