…evenueCat#3395)

## Summary
- Follow-up to RevenueCat#3324, which fixed the original ripple-vs-margin issue
(RevenueCat#3321) by adding `.clip(composeShape)` on the click target so the
ripple respects rounded corners. That fix uses a graphics-layer clip,
which also crops descendants — stacks with nested children that
intentionally extend outside the parent (badges with offsets, drop
shadows, decorative elements) get visibly clipped during press.
- Introduces declarative `onStackClick: (() -> Unit)?`, `enabled:
Boolean`, `interactionSource: MutableInteractionSource?` parameters on
`StackComponentView`, threaded through `StackWithOverlaidBadge`,
`StackWithLongEdgeToEdgeBadge`, `StackWithShortEdgeToEdgeBadge`, and
`MainStackComponent`. This lets `MainStackComponent` split the click
gesture from the indication.
- **Plain stack path:** wraps in a `Box {}` containing the stack with
`clickable(indication = null)` (gesture only, no clip on the stack) and
a sibling
`Box(Modifier.matchParentSize().padding(margin).clip(composeShape).indication(source,
LocalIndication.current))` that draws the shape-clipped ripple. Children
render unclipped.
- **Other render paths** (video background, nested badge, overlay) keep
their existing `.clip(composeShape)` on the click target — only the
click wiring is swapped over to the new `onStackClick` parameter. The
overflow-clip fix therefore only applies to the plain render path; this
limitation is documented in the `onStackClick` kdoc so future callers
know what to expect.
- Updates the three call sites (`ButtonComponentView`,
`PackageComponentView`, `TabControlButtonView`) to use the new
declarative API.
- Adds a Compose preview
(`StackComponentView_Preview_Clickable_With_Overflowing_Child_Shadow`)
as a regression guard for the overflowing-child shadow case.

## Test plan
- [x] `./gradlew :ui:revenuecatui:testDefaultsBc8DebugUnitTest` (full
suite + Paparazzi `verify`) — green
- [x] `./gradlew detektAll` — green
- [x] Manual: build a paywall whose plain stack has a nested child
positioned to extend outside the parent (offset, negative padding, or
drop shadow); tap the parent — overflowing child must remain fully
visible during the press, and the ripple must follow the parent's
rounded corners

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Touches core Compose layout/click/semantics for paywall components, so
regressions could affect tap handling, accessibility, or visual clipping
across many paywalls despite being UI-only.
> 
> **Overview**
> Fixes clickable `StackComponentView` ripple rendering so the ripple
remains clipped to the stack shape **without clipping overflowing
children** (e.g. shadows/badges) by splitting gesture handling and
indication onto separate sibling nodes.
> 
> Introduces a new declarative click API on `StackComponentView`
(`onStackClick`, `enabled`, `interactionSource`) and updates existing
button/tab/package components to use it instead of applying
`Modifier.clickable` externally; adds Compose previews as regression
guards. The paywall-tester sample paywall is also updated to use a
`ButtonComponent` for its CTA.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
2471d57. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Siaržuk Bahdaniec <sweid531@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>