[Android] Allow sheet customization

[kiftio]

What changes are you making?

Introduces CheckoutSheetStyle, a new configuration type that decouples native sheet chrome styling from ColorScheme. Previously, properties like closeIcon and closeIconTint were embedded in color scheme definitions, making it awkward to style sheet chrome independently of checkout colors.

CheckoutSheetStyle exposes the following properties:

• cornerRadiusDp — controls the top corner radius of the sheet header (defaults to 32f)
• titleAlignment — aligns the sheet title to START or CENTER (defaults to CENTER)
• toolbarElevationDp — sets the toolbar shadow elevation (defaults to 0f)
• closeIcon — optional custom close button drawable
• closeIconTint — optional tint applied to the default close icon

closeIcon and closeIconTint are moved out of ColorScheme/Colors and into CheckoutSheetStyle. The closeIcon takes precedence over closeIconTint when both are set. The hardcoded checkout_sheet_corner_radius dimension resource is removed in favour of the runtime value from CheckoutSheetStyle.

Configuration gains a sheetStyle field (defaulting to CheckoutSheetStyle()) alongside colorScheme. The demo app's settings screen is updated with a CheckoutSheetStyleSection that lets users switch between a NewDefaults preset and a LegacyDialog preset (square corners, start-aligned title, elevated toolbar), persisted via DataStore.

How to test

1. Configure sheetStyle in your app:

   ShopifyCheckoutKit.configure {
       it.sheetStyle = CheckoutSheetStyle(
           cornerRadiusDp = 32f,
           titleAlignment = CheckoutSheetTitleAlignment.CENTER,
           toolbarElevationDp = 0f,
           closeIconTint = Color.ResourceId(R.color.checkout_close),
       )
   }

2. Present checkout and verify the sheet header reflects the configured corner radius, title alignment, toolbar elevation, and close icon styling.
3. Switch to the LegacyDialog preset in the demo app settings and confirm the sheet renders with square corners, a start-aligned title, and visible toolbar elevation.
4. Set both closeIcon and closeIconTint and confirm the custom drawable takes precedence.
5. Run the unit and interop test suites and confirm all tests pass.

---

Before you merge

Important

• I've added tests to support my implementation
• I have read and agree with the Contribution Guidelines
• I have read and agree with the Code of Conduct
• I've updated the relevant platform README (platforms/swift/README.md and/or platforms/android/README.md)

---

Releasing a new Swift version?

• I have bumped the version in ShopifyCheckoutKit.podspec
• I have bumped the version in platforms/swift/Sources/ShopifyCheckoutKit/ShopifyCheckoutKit.swift
• I have updated the SwiftPM/CocoaPods version snippets in platforms/swift/README.md (major version only)

Releasing a new Embedded Checkout Protocol version?

• I have bumped embeddedCheckoutProtocolAndroid in platforms/android/gradle/libs.versions.toml
• I have updated protocol/languages/kotlin/embedded-checkout-protocol/api/embedded-checkout-protocol.api if the public API changed

Releasing a new Android version?

• I have bumped checkoutKitAndroid in platforms/android/gradle/libs.versions.toml
• I have updated the Gradle/Maven version snippets in platforms/android/README.md

Tip

See the Contributing documentation for the full release process per platform.

[kiftio]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Clip checkout sheet content to rounded top corners #391
• [Android] Allow sheet customization #382 👈 (View in Graphite)
• [Android] Render checkout in bottom sheet #381
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

React Native — Coverage Report

Lines	Statements	Branches	Functions
	91.85% (327/356)	87.98% (183/208)	100% (86/86)

[github-actions]

Package Size

Platform	Artifact	Base	Head	Delta
Android	release AAR	190.2 KiB	199.7 KiB	+9.4 KiB

Android file breakdown

File	Base	Head	Delta
classes.jar	201.0 KiB	210.9 KiB	+9.9 KiB
res/layout/checkout_sheet_content.xml	3.4 KiB	4.0 KiB	+577 B
res/values/values.xml	1.1 KiB	1.2 KiB	+157 B
R.txt	867 B	1.0 KiB	+158 B
proguard.txt	798 B	798 B	0 B
AndroidManifest.xml	578 B	578 B	0 B
res/drawable/close.xml	431 B	431 B	0 B
res/menu/checkout_menu.xml	354 B	354 B	0 B
META-INF/com/android/build/gradle/aar-metadata.properties	157 B	157 B	0 B

Measured from the PR base SHA and PR head SHA. The file breakdown shows uncompressed sizes within each package artifact, so individual files do not sum to the compressed artifact total. This comment reports package artifact sizes only; it is not a final app binary-size report.

[kiftio]

tossed up between tokens (NONE, SMALL, MEDIUM, LARGE) and float values.

This looks more consistent with accelerated checkouts and gives best possibility of matching a consumer app

[kiftio]

https://m3.material.io/components/bottom-sheets/overview

see little drag handle at the top of the image

[kieran-osgood-shopify]

Just a though during tophatting, as we're adding dragToDismissEnabled we might want to also add in the tapAwayToDismissEnabled just to avoid accidental checkout closures (e.g. could easily happen whilst user swipes down to see a notification)?

[kieran-osgood-shopify]

I was going to ask whether Dp is the right unit here, most sheet implementations I've seen opt for a percentage based approach however:

Looking at the material sheet design https://m3.material.io/components/bottom-sheets/specs they have some specs including it being in dp (top margin being 72dp) -

Wondering whether it's worth aligning along these lines?
Granted it's now more legacy but just to make the default design of the sheet look somewhat idiomatic, in lieu of any jetpack compose style sheets

---

Would it make sense from an extensibility perspective to support an array here?
snappoints is pretty common in the react-native sheet implementations, would give us the room to support multiple snap point locations without a singular "dp" from top position

[kieran-osgood-shopify]

Is the headerFontColor the right color to apply here?