CardFields feature

[noguier]

Summary of changes

• A completed work of CardFields feature

AI Usage

Which AI Agent Was Used?

• Copilot
• Claude
• Other (Type Name Here)

How was AI used?
Brainstorming, tests generation, troubleshooting

Estimated AI Code Contribution

• less than 30%
• 30 - 60%
• 60 - 100%

Checklist

• Added a changelog entry
• Tested and confirmed payment flows affected by this change are functioning as expected

Authors

List GitHub usernames for everyone who contributed to this pull request.
@noguier , @saralvasquez , @buzzamus

[github-actions]

Dependency Review

✅ No vulnerabilities found.

Scanned Files

• settings.gradle

[Copilot]

Pull request overview

Adds a new CardFields UI component to the UIComponents module, providing a prebuilt card-entry form (card number, expiration, CVV) with formatting, brand detection, validation, and tokenization via CardClient. Also updates the Demo app to surface the new UI Components screen and adds unit/instrumentation test coverage.

Changes:

• Introduces CardFields view + supporting ViewModel/formatters/validators/resources for card input and tokenization.
• Adds extensive unit + instrumentation tests (incl. Robolectric setup) for formatting, validation, accessibility, and state restoration.
• Updates Demo navigation/UI to a new UIComponentsFragment and documents the feature in README/CHANGELOG/dependency docs.

Reviewed changes

Copilot reviewed 68 out of 69 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
UIComponents/src/test/resources/robolectric.properties	Configures Robolectric SDK level for UIComponents unit tests.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/LuhnValidatorUnitTest.kt	Unit tests for Luhn checksum validation behavior.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/ExpirationValidationUseCaseUnitTest.kt	Unit tests for expiration validation rules.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/ExpirationTextInputViewUnitTest.kt	Robolectric tests for expiration input formatting and accessibility.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/ExpirationDateFormatterUnitTest.kt	Unit tests for expiration formatter behavior and cursor logic.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/CvvValidationUseCaseUnitTest.kt	Unit tests for CVV validation per brand.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/CvvTextInputViewUnitTest.kt	Robolectric tests for CVV input constraints and hint overlay behavior.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/CardNumberValidationUseCaseUnitTest.kt	Unit tests for card number validation + brand detection integration.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/CardNumberTextInputViewUnitTest.kt	Robolectric tests for card number input formatting, icon updates, and listener behavior.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/CardNumberFormatterUnitTest.kt	Unit tests for card number formatting and cursor preservation logic.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/CardFieldsViewModelUnitTest.kt	Unit tests for ViewModel validation state machine and form validity aggregation.
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/CardBrandUnitTest.kt	Unit tests for brand detection and brand metadata (lengths/gaps/cvv rules).
UIComponents/src/test/java/com/braintreepayments/api/uicomponents/cardfields/BaseTextInputViewUnitTest.kt	Robolectric tests for base input view hint/error behavior.
UIComponents/src/main/res/values/strings_card_fields.xml	Adds CardFields strings (hints, errors, brand labels, overlay text).
UIComponents/src/main/res/values/dimens.xml	Adds CardFields sizing/spacing dimensions and overlay dimensions.
UIComponents/src/main/res/values/colors.xml	Adds CardFields colors (borders, text, background, error).
UIComponents/src/main/res/layout/cvv_hint_overlay.xml	Layout for the CVV hint popup overlay.
UIComponents/src/main/res/layout/card_fields_view.xml	Layout composing card number + expiration + CVV subviews.
UIComponents/src/main/res/layout/base_text_input.xml	Base input layout used by all CardFields subviews.
UIComponents/src/main/res/drawable/ic_card_field_error.xml	Error icon vector for inline validation UI.
UIComponents/src/main/res/drawable/cvv_hint.xml	CVV hint icon vector.
UIComponents/src/main/res/drawable/cvv_hint_close.xml	Close icon vector for the CVV overlay.
UIComponents/src/main/res/drawable/card_fields_cc_visa.xml	Visa brand icon vector.
UIComponents/src/main/res/drawable/card_fields_cc_unknown.xml	Default/unknown card brand icon vector.
UIComponents/src/main/res/drawable/card_fields_cc_union_pay.xml	UnionPay brand icon vector.
UIComponents/src/main/res/drawable/card_fields_cc_mastercard.xml	Mastercard brand icon vector.
UIComponents/src/main/res/drawable/card_fields_cc_jcb.xml	JCB brand icon vector.
UIComponents/src/main/res/drawable/card_fields_cc_amex.xml	Amex brand icon vector.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/UIComponentsAnalytics.kt	Adds analytics event constants for CardFields presented/validated.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/ValidationResult.kt	Adds ValidationResult sealed type used by view model and UI.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/LuhnValidator.kt	Adds Luhn checksum validator implementation.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/ExpirationValidationUseCase.kt	Adds expiration MMYY validation logic.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/ExpirationTextInputView.kt	Adds expiration input view with formatter/autofill hints.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/ExpirationDateFormatter.kt	Adds expiration formatter (MM/YY) + cursor management.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CvvValidationUseCase.kt	Adds CVV validation logic keyed to card brand.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CvvTextInputView.kt	Adds CVV input view with length filtering and hint overlay wiring.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CvvHintOverlay.kt	Adds PopupWindow overlay implementation for CVV hint.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CvvFormatter.kt	Adds digit-only CVV formatter with truncation + length filter updates.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardNumberValidationUseCase.kt	Adds card number validation + brand detection + UnionPay Luhn exception.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardNumberTextInputView.kt	Adds card number input view with brand icon updates and formatting.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardNumberFormatter.kt	Adds card number formatter inserting spaces per brand gaps + cursor preservation.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardFieldsViewModel.kt	Adds ViewModel coordinating validation, blur rules, and overall form validity.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardFieldsResultCallback.kt	Adds callback interface for CardFields submission results.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardFieldsResult.kt	Adds result type (Success/Failure) for CardFields submission.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardFields.kt	Adds the public CardFields view that wires UI + ViewModel + tokenization + state saving.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardField.kt	Adds enum identifying fields for focus/blur validation.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/CardBrand.kt	Adds card brand detection rules, formatting gaps, icon mapping, and CVV rules.
UIComponents/src/main/java/com/braintreepayments/api/uicomponents/cardfields/BaseTextInputView.kt	Adds reusable input widget with floating label, icons, and error presentation.
UIComponents/src/androidTest/java/com/braintreepayments/api/uicomponents/cardfields/CardFieldsTestActivity.kt	Adds test harness Activity for CardFields instrumentation tests.
UIComponents/src/androidTest/java/com/braintreepayments/api/uicomponents/cardfields/CardFieldsTest.kt	Adds instrumentation tests for validation UI, brand detection, rotation state, and submit-before-init.
UIComponents/src/androidTest/AndroidManifest.xml	Declares the CardFields test Activity for androidTest.
UIComponents/build.gradle	Adds :Card dependency, Autofill, and Robolectric/androidx-test-core for tests.
README.md	Documents CardFields integration steps and usage example.
gradle/libs.versions.toml	Adds androidx.autofill:autofill dependency entry and version.
DEPENDENCIES.md	Updates dependency list to include :Card and androidx.autofill.
Demo/src/main/res/values/styles.xml	Adds a compact toggle button style for demo UI.
Demo/src/main/res/values/strings.xml	Adds new demo strings and removes the Payment Buttons label.
Demo/src/main/res/navigation/nav_graph.xml	Replaces PaymentButtonsFragment route with UIComponentsFragment route.
Demo/src/main/res/layout/fragment_ui_components.xml	Updates demo screen layout to include CardFields and reorganize toggles/buttons.
Demo/src/main/res/drawable/card_fields_pay_button_background.xml	Adds a custom background selector for the CardFields demo “Pay” button.
Demo/src/main/java/com/braintreepayments/demo/UIComponentsFragment.kt	Adds the demo fragment showcasing CardFields + existing buttons.
Demo/src/main/java/com/braintreepayments/demo/PaymentButtonsFragment.java	Removes the old PaymentButtonsFragment implementation.
Demo/src/main/java/com/braintreepayments/demo/MainFragment.kt	Updates main menu to launch the new UI Components screen.
Demo/src/main/java/com/braintreepayments/demo/DemoActivity.java	Updates insets handling to include IME and to not consume insets.
Demo/src/androidTest/java/com/braintreepayments/demo/test/UIInteractionStatesTest.kt	Updates UI automation to navigate via “UI Components”.
Demo/src/androidTest/java/com/braintreepayments/demo/test/PaymentButtonsColorTest.kt	Updates UI automation to navigate via “UI Components”.
CHANGELOG.md	Adds changelog entry announcing CardFields in UIComponents.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[buzzamus]

Pulled down and tested a bunch of scenarios. All looks good great work!

[tdchow]

Very excited to see the card fields feature complete! 🙌

[agedd]

amazing work @noguier!! 🚀