What's New
SDK Improvements
Automatic UI state transitions after first-side capture
After the front side is captured, the UX Manager now automatically walks through transition states before resuming back-side capture:
FIRST_SIDE_CAPTURED → FLIP_CARD → INTRO_BACK
Integrations that depend on exact UI-state timing or key sequences should account for these new intermediate states.
New destroy() method on BlinkCardUxManager
Provides explicit teardown for the UX Manager instance.
Clearer UI state introspection
rawUiStateKey is deprecated and replaced by two explicit getters:
uiStateKey— the stabilized, visible state key (what the feedback UI currently shows).mappedUiStateKey— the latest raw candidate key from the core engine before stabilization (useful for debugging).
New "result_retrieval_failed" processing error
BlinkCardProcessingError now includes "result_retrieval_failed" to surface errors that occur when retrieving the final result from the scanning session.
Camera UI improvements
- The
z-indexof the camera UI dialog (when no target element is provided) is now configurable.
Accessibility improvements
- Screen-reader support and ARIA semantics have been improved across the SDK's UI components, including the feedback overlay and capture dialog.
- Double-tap zoom on camera UI elements is prevented on mobile browsers.
Bug Fixes
- Removed non-functional
feedbackLocalizationprop: ThefeedbackLocalizationproperty onBlinkCardComponentOptionswas a no-op and has been removed. Pass localization strings viafeedbackUiOptions.localizationStringsinstead.
Breaking Changes
Camera dialog locale key renamed
The capture-dialog title locale key has been renamed from scan_document to dialog_title. Update any custom translation files accordingly — the translated string value can remain the same.