feat(AuthUIConfiguration): implement configuration model, DSL builder and tests

auth/build.gradle.kts

@@ -4,6 +4,7 @@ plugins {
     id("com.android.library")
     id("com.vanniktech.maven.publish")
     id("org.jetbrains.kotlin.android")
+    id("org.jetbrains.kotlin.plugin.compose") version "2.0.0"
 }
 
 android {
@@ -67,9 +68,20 @@ android {
     kotlinOptions {
         jvmTarget = "17"
     }
+    buildFeatures {
+        compose = true
+    }
 }
 
 dependencies {
+    implementation(platform(Config.Libs.Androidx.Compose.bom))
+    implementation(Config.Libs.Androidx.Compose.ui)
+    implementation(Config.Libs.Androidx.Compose.uiGraphics)
+    implementation(Config.Libs.Androidx.Compose.material3)
+    implementation(Config.Libs.Androidx.Compose.foundation)
+    implementation(Config.Libs.Androidx.Compose.tooling)
+    implementation(Config.Libs.Androidx.Compose.toolingPreview)
+    implementation(Config.Libs.Androidx.Compose.activityCompose)
     implementation(Config.Libs.Androidx.materialDesign)
     implementation(Config.Libs.Androidx.activity)
     // The new activity result APIs force us to include Fragment 1.3.0
@@ -101,6 +113,7 @@ dependencies {
     testImplementation(Config.Libs.Test.mockito)
     testImplementation(Config.Libs.Test.core)
     testImplementation(Config.Libs.Test.robolectric)
+    testImplementation(Config.Libs.Test.kotlinReflect)
     testImplementation(Config.Libs.Provider.facebook)
 
     debugImplementation(project(":internal:lintchecks"))

auth/src/main/java/com/firebase/ui/auth/compose/configuration/AuthProvider.kt

@@ -0,0 +1,270 @@
+/*
+ * Copyright 2025 Google Inc. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the
+ * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.firebase.ui.auth.compose.configuration
+
+import android.graphics.Color
+import androidx.compose.ui.graphics.vector.ImageVector
+import com.google.firebase.auth.ActionCodeSettings
+
+@AuthUIConfigurationDsl
+class AuthProvidersBuilder {
+    private val providers = mutableListOf<AuthProvider>()
+
+    fun provider(provider: AuthProvider) {
+        providers.add(provider)
+    }
+
+    internal fun build(): List<AuthProvider> = providers.toList()
+}
+
+/**
+ * Base sealed class for authentication providers.
+ */
+sealed class AuthProvider() {
+    /**
+     * Email/Password authentication provider configuration.
+     */
+    data class Email(
+        /**
+         * Requires the user to provide a display name. Defaults to true.
+         */
+        val requireDisplayName: Boolean = true,
+
+        /**
+         * Enables email link sign-in, Defaults to false.
+         */
+        val enableEmailLinkSignIn: Boolean = false,
+
+        /**
+         * Settings for email link actions.
+         */
+        val actionCodeSettings: ActionCodeSettings?,
+
+        /**
+         * Allows new accounts to be created. Defaults to true.
+         */
+        val allowNewAccounts: Boolean = true,
+
+        /**
+         * The minimum length for a password. Defaults to 6.
+         */
+        val minimumPasswordLength: Int = 6,
+
+        /**
+         * A list of custom password validation rules.
+         */
+        val passwordValidationRules: List<PasswordRule>
+    ) : AuthProvider()
+
+    /**
+     * Phone number authentication provider configuration.
+     */
+    data class Phone(
+        /**
+         * The default country code to pre-select.
+         */
+        val defaultCountryCode: String?,
+
+        /**
+         * A list of allowed country codes.
+         */
+        val allowedCountries: List<String>?,
+
+        /**
+         * The expected length of the SMS verification code. Defaults to 6.
+         */
+        val smsCodeLength: Int = 6,
+
+        /**
+         * The timeout in seconds for receiving the SMS. Defaults to 60L.
+         */
+        val timeout: Long = 60L,
+
+        /**
+         * Enables instant verification of the phone number. Defaults to true.
+         */
+        val enableInstantVerification: Boolean = true,
+
+        /**
+         * Enables automatic retrieval of the SMS code. Defaults to true.
+         */
+        val enableAutoRetrieval: Boolean = true
+    ) : AuthProvider()
+
+    /**
+     * Google Sign-In provider configuration.
+     */
+    data class Google(
+        /**
+         * The list of scopes to request.
+         */
+        val scopes: List<String>,
+
+        /**
+         * The OAuth 2.0 client ID for your server.
+         */
+        val serverClientId: String?,
+
+        /**
+         * Requests an ID token. Default to true.
+         */
+        val requestIdToken: Boolean = true,
+
+        /**
+         * Requests the user's profile information. Defaults to true.
+         */
+        val requestProfile: Boolean = true,
+
+        /**
+         * Requests the user's email address. Defaults to true.
+         */
+        val requestEmail: Boolean = true
+    ) : AuthProvider()
+
+    /**
+     * Facebook Login provider configuration.
+     */
+    data class Facebook(
+        /**
+         * The list of scopes (permissions) to request. Defaults to email and public_profile.
+         */
+        val scopes: List<String> = listOf("email", "public_profile"),
+
+        /**
+         * if true, enable limited login mode. Defaults to false.
+         */
+        val limitedLogin: Boolean = false
+    ) : AuthProvider()
+
+    /**
+     * Twitter/X authentication provider configuration.
+     */
+    data class Twitter(
+        /**
+         * A map of custom OAuth parameters.
+         */
+        val customParameters: Map<String, String>
+    ) : AuthProvider()
+
+    /**
+     * Github authentication provider configuration.
+     */
+    data class Github(
+        /**
+         * The list of scopes to request. Defaults to user:email.
+         */
+        val scopes: List<String> = listOf("user:email"),
+
+        /**
+         * A map of custom OAuth parameters.
+         */
+        val customParameters: Map<String, String>
+    ) : AuthProvider()
+
+    /**
+     * Microsoft authentication provider configuration.
+     */
+    data class Microsoft(
+        /**
+         * The list of scopes to request. Defaults to openid, profile, email.
+         */
+        val scopes: List<String> = listOf("openid", "profile", "email"),
+
+        /**
+         * The tenant ID for Azure Active Directory.
+         */
+        val tenant: String?,
+
+        /**
+         * A map of custom OAuth parameters.
+         */
+        val customParameters: Map<String, String>
+    ) : AuthProvider()
+
+    /**
+     * Yahoo authentication provider configuration.
+     */
+    data class Yahoo(
+        /**
+         * The list of scopes to request. Defaults to openid, profile, email.
+         */
+        val scopes: List<String> = listOf("openid", "profile", "email"),
+
+        /**
+         * A map of custom OAuth parameters.
+         */
+        val customParameters: Map<String, String>
+    ) : AuthProvider()
+
+    /**
+     * Apple Sign-In provider configuration.
+     */
+    data class Apple(
+        /**
+         * The list of scopes to request. Defaults to name and email.
+         */
+        val scopes: List<String> = listOf("name", "email"),
+
+        /**
+         * The locale for the sign-in page.
+         */
+        val locale: String?,
+
+        /**
+         * A map of custom OAuth parameters.
+         */
+        val customParameters: Map<String, String>
+    ) : AuthProvider()
+
+    /**
+     * Anonymous authentication provider. It has no configurable properties.
+     */
+    object Anonymous : AuthProvider()
+
+    /**
+     * A generic OAuth provider for any unsupported provider.
+     */
+    data class GenericOAuth(
+        /**
+         * The provider ID as configured in the Firebase console.
+         */
+        val providerId: String,
+
+        /**
+         * The list of scopes to request.
+         */
+        val scopes: List<String>,
+
+        /**
+         * A map of custom OAuth parameters.
+         */
+        val customParameters: Map<String, String>,
+
+        /**
+         * The text to display on the provider button.
+         */
+        val buttonLabel: String,
+
+        /**
+         * An optional icon for the provider button.
+         */
+        val buttonIcon: ImageVector?,
+
+        /**
+         * An optional background color for the provider button.
+         */
+        val buttonColor: Color?
+    ) : AuthProvider()
+}