feat(paywalls): add state-driven paywalls data layer (PWENG-57)

[AlvaroBrey]

Decodes the new server-driven state schema from PaywallComponentsData:

• state_declarations: a top-level map of named, typed (string/bool/int/double) variables with declared defaults.
• state_updates on interactive components (tabs, carousels, buttons): write operations that fire when the component is triggered. Supports literal values and a $value payload reference for the triggering component's identity.
• state_condition in ComponentOverride.Condition: evaluates a named variable against an expected value with EQUALS/NOT_EQUALS operators.

Pure data model — no runtime behavior.

---

Note

Low Risk
Changes are additive JSON models and resilient decoders with no purchase/auth logic; the UI stub means state-based overrides are inert until a later runtime phase.

Overview
Adds decode-only support for server-driven paywall state: top-level state_declarations on PaywallComponentsData, optional state_updates on buttons, carousels, and tabs, and a new state_condition override type.

state_declarations maps names to typed defaults (boolean / integer / double / string) via StateDeclaration and a tolerant StateDeclarationMapSerializer that drops bad entries instead of failing the whole paywall.

state_updates decode as StateUpdate.Set with literal to values or the "$value" payload reference; unknown shapes become Unsupported.

state_condition compares a named state key with = / != (scalar primitives only; null/non-scalar → Unsupported). It is marked isRule like other conditional rules.

In revenuecatui, ComponentOverride.Condition.State is wired to always evaluate false until runtime state exists—overrides gated only on state will not apply yet.

Tests cover deserialization for declarations, updates, conditions, and component wiring.

^{Reviewed by Cursor Bugbot for commit cc087cd. Bugbot is set up for automated code reviews on this repo. Configure here.}

[AlvaroBrey]

• feat(RevenueCatUI): Tab selected-state (PWENG-65) #3664
• feat(RevenueCatUI): evaluate state conditions in the override resolver (PWENG-57) #3661
• feat(RevenueCatUI): add presentation-session state store (PWENG-57) #3660
• feat(paywalls): add state-driven paywalls data layer (PWENG-57) #3656 👈 (View in Graphite)
• main

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

[codecov]

Codecov Report

❌ Patch coverage is 83.63636% with 9 lines in your changes missing coverage. Please review.
✅ Project coverage is 80.58%. Comparing base (3183def) to head (cc087cd).

Files with missing lines	Patch %	Lines
...urchases/paywalls/components/common/StateUpdate.kt	80.00%	2 Missing and 2 partials ⚠️
...ses/paywalls/components/common/StateDeclaration.kt	86.95%	1 Missing and 2 partials ⚠️
...es/paywalls/components/common/ComponentOverride.kt	75.00%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3656      +/-   ##
==========================================
+ Coverage   80.57%   80.58%   +0.01%     
==========================================
  Files         395      397       +2     
  Lines       16316    16371      +55     
  Branches     2322     2332      +10     
==========================================
+ Hits        13146    13192      +46     
- Misses       2243     2247       +4     
- Partials      927      932       +5     

☔ View full report in Codecov by Harness.
📢 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.

[AlvaroBrey]

@cursor review

[AlvaroBrey]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit e7fc9f5. Configure here.}

[tonidero]

Just some small things. Great work!

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit d9f7342. Configure here.}