Description

This PR:

1. Refreshes the in-app Bitcoin Calculator widget with the v6.1 two-row card treatment and Bitkit number pad interaction.
2. Ports the Android calculator polish from synonymdev/bitkit-android#942, including outside-tap dismissal, long-press backspace clear, stable placeholder/cursor behavior, all-position focused layout handling, focused-widget scroll locking, and vertical numpad collapse on dismiss.
3. Keeps the Calculator OS widget out of scope for now, matching the Android PR decision; the iOS OS widget work is preserved on backup branch:
   ovi/calculator-os-widget-v61-backup-ios.
4. Adds Calculator preview carousel support plus focused formatter/input coverage for grouping, decimal placeholders, localized decimal entry, clearing, fiat-only persistence, visible zero-sat conversion, and BTC supply limits.

Rationale for replacing OS keyboard with custom version of the in-app Numpad revolved around maintaining the app's look and feel and having more control to style it and have it behave like the app usually does in other flows.

Linked Issues/Tasks

• feat: calculator v61 redesign bitkit-android#942
• fix: calculator inputs placeholder bitkit-android#967

Screenshot / Video

Note Recordings are sped up using ffmpeg at 2x for time reasons, actual capture of manual walkhroughs, not AI.

QA Notes

• Changelog fragment: changelog.d/next/554.changed.md

Manual Tests

Reviewer / QA Requested

• 1. Add the calculator widget inside Bitkit and check idle, focused Bitcoin input, and focused fiat input states.
• 2. Enter and delete large Bitcoin and fiat amounts, especially values above 1,000, to confirm grouping and cursor behavior.
• 3. Check decimal behavior on Belgium locale for comma decimals and United States locale for period decimals.
• 4. Focus the bottom input when the calculator is low in the app home widget list and confirm the number pad remains usable above the safe area.
• 5. Focus the calculator from a lower scroll position and confirm the page/layout movement animates instead of jumping.
• 6. Tap outside the calculator and confirm the number pad collapse and bottom tab bar return animate together.
• 7. Repeat focus and dismiss several times and confirm the scan button does not appear highlighted during tab bar movement.
• 8. Try regular widget-list scrolling while the number pad is open, then swipe back to the wallet overview, and confirm only the expected navigation gesture dismisses it.
• 9. Check one-decimal fiat entry and confirm the dimmed trailing zero and cursor do not shift or appear in the wrong place.
• 10. Check classic BTC decimal entry and modern BTC integer entry to confirm number-pad limits match the selected Bitcoin display mode.
• 11. Confirm the number pad has no extra divider bar above it.
• 12. Move the calculator to the first widget position, focus an input, and confirm the calculator plus number pad animate down to the bottom with no other widgets visible underneath.
• 13. Dismiss from that first-position focused state and confirm the normal widget list returns.
• 14. Move the calculator to middle and last widget positions and repeat focus/dismiss to confirm those positions still animate without jumps.
• 15. Put the calculator above Suggestions, focus it, and confirm the transition is a scroll/layout bring-into-view animation instead of a fade.
• 16. Put Suggestions above Calculator, focus it from above center/around center/below center, and confirm the stack settles bottom-aligned above the safe area in all three positions.
• 17. Dismiss the focused calculator and confirm the number pad shrinks vertically until it disappears instead of jumping away.
• 18. Swipe down from the widgets slide to the wallet overview and confirm the original vertical Home pager behavior still works.
• 19. Switch to Classic BTC, focus the Bitcoin input, and confirm the dimmed eight-decimal placeholder stays visible for empty, integer, partial-decimal, and full-decimal values.
• 20. Focus Classic BTC and fiat inputs with a comma-decimal locale and confirm the in-app number pad shows . as the decimal key, matching the Android calculator behavior.

Automated Tests

Added in this PR:

• CalculatorWidgetTests: covers calculator grouping, fiat and Classic BTC decimal placeholder behavior, fixed . calculator decimal key behavior, number-pad delete/clear, decimal caps, localized comma input normalization, localized decimal input handling, fiat-only persistence, symbol shortening, classic BTC-to-sats conversion, classic BTC max-supply rejection, and visible 0 sats for fiat conversions that round to zero.

Automated Checks

• Local:
  • swiftformat Bitkit/Models/CalculatorWidgetData.swift Bitkit/Components/Widgets/CalculatorWidget.swift BitkitTests/CalculatorWidgetTests.swift completed with no formatting changes needed after the Classic BTC placeholder / decimal-key patch.
  • swiftformat Bitkit/Components/Widgets/CalculatorWidget.swift Bitkit/Views/Home/HomeWidgetsView.swift completed with no formatting changes needed after the final animation patch.
  • git diff --check passed.
• Local physical iPhone 17 Air:
  • xcodebuild -workspace Bitkit.xcodeproj/project.xcworkspace -scheme Bitkit -configuration Debug -destination 'id=00008150-001C691C2604401C' -derivedDataPath build/DeviceValidation SWIFT_ACTIVE_COMPILATION_CONDITIONS='$(inherited) E2E_BUILD' build passed on the connected iPhone.
  • removed the known generated static LDKNodeFFI.framework install stub from build/DeviceValidation/Build/Products/Debug-iphoneos/Bitkit.app, re-signed the generated app product, installed it with xcrun devicectl device install app --device 07CD4544-B1F1-59BB-BB01-D50A80AECAC9, and launched to.bitkit successfully.
  • xcodebuild build-for-testing ... -only-testing:BitkitTests/CalculatorWidgetTests passed; after removing the known generated static LDKNodeFFI.framework install stub and re-signing the generated app product, xcodebuild test-without-building ... -only-testing:BitkitTests/CalculatorWidgetTests passed with 14 tests and 0 failures.
  • After the Classic BTC placeholder / decimal-key patch, xcodebuild test-without-building ... -only-testing:BitkitTests/CalculatorWidgetTests passed on the connected iPhone with 18 tests and 0 failures after removing the known generated static LDKNodeFFI.framework install stub from the generated app product.
• Local iPhone Air simulator smoke on iOS 26.4:
  • opened Home → Widgets, tapped the Calculator fiat row, and captured the focused layout; the number pad rendered inline below the calculator, lower widgets stayed hidden while focused, and outside-tap dismissal restored the lower widgets.
  • forced Calculator to the first widget position above Suggestions, focused the fiat row, and confirmed the calculator plus number pad settle down into the viewport without fading. Repeated with Suggestions above Calculator and confirmed the number pad expands inline without shoving the card into a bad position, then outside-tap dismissal restored the widget list.
  • forced Suggestions → Price → Calculator → Blocks, focused the calculator after scrolling it into the higher viewport position, and confirmed the card remains attached to the inline number pad with all number-pad rows visible. Repeated Calculator-first and Suggestions-above-Calculator positions to confirm those focused layouts still settle correctly.
• CI: standard PR validation is expected to cover the normal build/test lanes.