[PM-34125] feat: Add card text analysis pipeline

[SaintPatrck]

🎟️ Tracking

https://bitwarden.atlassian.net/browse/PM-34125

📔 Objective

Add the complete text analysis pipeline for credit card scanning:

• CardNumberUtils: Shared Luhn validation and card number sanitization (ui module)
• CardDataParser: Interface and regex-based implementation for extracting card details from OCR text (number, expiry, CVV, cardholder name)
• CardTextAnalyzer: ML Kit Text Recognition integration for camera frame analysis
• CardScanOverlay: Camera overlay composable for scan UI
• CardScanData: Data class for parsed card fields
• CardNumberUtils in app: Brand detection (detectCardBrand) using VaultCardBrand

Includes full test coverage for parser logic, Luhn validation, and sanitization.

[github-actions]

Overall Assessment: APPROVE

This PR adds the complete text analysis pipeline for credit card scanning. Changes include Luhn validation and card number sanitization utilities, a regex-based OCR data parser for extracting card details, ML Kit Text Recognition integration for camera frame analysis, a card scan overlay composable, and card brand detection. The implementation correctly follows the existing QrCodeAnalyzer pattern, with an appropriate upgrade to AtomicBoolean for thread-safe gating around the asynchronous ML Kit processing. Test coverage is thorough for the parser and validation logic.

Code Review Details

No findings. The code is well-structured, follows established codebase conventions (interface/impl pairs, CompositionLocal provision, @OmitFromCoverage for platform-dependent code, test fixtures), and includes comprehensive test coverage for the parsing and validation logic.

[codecov]

Codecov Report

❌ Patch coverage is 66.00000% with 34 lines in your changes missing coverage. Please review.
✅ Project coverage is 85.65%. Comparing base (c04ac3b) to head (d776756).

Files with missing lines	Patch %	Lines
...m/x8bit/bitwarden/ui/vault/util/CardNumberUtils.kt	44.73%	0 Missing and 21 partials ⚠️
...orm/feature/cardscanner/util/CardDataParserImpl.kt	75.60%	0 Missing and 10 partials ⚠️
...itwarden/ui/platform/composition/LocalProviders.kt	33.33%	2 Missing ⚠️
...atform/feature/cardscanner/util/CardNumberUtils.kt	92.30%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@                             Coverage Diff                              @@
##           card-scanner/1-generalize-camera-preview    #6720      +/-   ##
============================================================================
- Coverage                                     85.72%   85.65%   -0.07%     
============================================================================
  Files                                           944      950       +6     
  Lines                                         60660    60493     -167     
  Branches                                       8566     8592      +26     
============================================================================
- Hits                                          51998    51813     -185     
+ Misses                                         5682     5673       -9     
- Partials                                       2980     3007      +27     

Flag	Coverage Δ
app-data	17.89% <0.00%> (+0.11%)	⬆️
app-ui-auth-tools	20.86% <1.00%> (+0.06%)	⬆️
app-ui-platform	15.60% <1.00%> (-0.40%)	⬇️
app-ui-vault	26.83% <19.00%> (+0.09%)	⬆️
authenticator	6.53% <1.00%> (+0.02%)	⬆️
lib-core-network-bridge	4.24% <0.00%> (+0.01%)	⬆️
lib-data-ui	1.03% <48.00%> (+0.08%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

Checkmarx One – Scan Summary & Details – b1c77782-29ff-43dc-9373-2831ab6431b5

Great job! No new security vulnerabilities introduced in this pull request