SIGN IN SIGN UP

Refresh the doc comments that describe an absent variable as null (#4076)

### Motivation

Follow-up to #4043, from @rickvdl's
[review](https://github.com/RevenueCat/purchases-android/pull/4043#pullrequestreview-5015541720).
Some doc comments were untrue after #4043.

### Description

The advice each comment gives is unchanged; only the reason behind it
moves.

- `CaseOperators` kept an example that can no longer happen, since the
lookup throws before `rc.lower` runs. Restated against an explicit
`null`, matching the wording iOS already merged.
- `RulesDimensionValue` also predates `rc.rootVar` (#4049), so its claim
that an iteration predicate cannot see the surrounding scope needed
narrowing to `var`.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Comment-only changes with no runtime or API impact.
> 
> **Overview**
> **Documentation-only follow-up** after #4043: comments still described
missing dimensions as resolving to `null` in the engine; behavior is now
an **unresolved variable** failure.
> 
> Updates KDoc in `DeviceDimensionProvider`, `RulesDimensionProvider`,
`RulesDimensionValue`, and `LocalRulesEvaluator` so omitted dimensions
and unevaluable predicates are described consistently—absent keys fail
resolution rather than silently non-matching, and unknown dimensions are
grouped with other predicates the SDK cannot evaluate when explaining
first-failure vs. later-rule-wins behavior.
> 
> `RulesDimensionValue.ObjectListValue` also notes that iteration
predicates can reach outer scope via **`rc.rootVar`** (#4049), not only
via fields on each record.
> 
> In `CaseOperators`, the no-coercion example is restated: explicit
`null` would stringify to `"null"` under `rc.lower`/`rc.upper`,
replacing an obsolete missing-`var` example that no longer applies after
lookup throws first.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
396914cedbe460a35a1d26b706aa1d9637a72eaa. 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: Cursor <cursoragent@cursor.com>
A
Antonio Pallares committed
69b7c5a0890671fc8b907b0a8e589730407d9530
Parent: 84faa2b
Committed by GitHub <noreply@github.com> on 8/25/2026, 9:41:12 AM