From c8fcc21e6b3f77b865b812fc3274655172f1bf5f Mon Sep 17 00:00:00 2001
From: PJ <ipriyanshujain@gmail.com>
Date: Tue, 18 Aug 2026 16:11:45 +0530
Subject: [PATCH] docs(spec-language): name the hintText selector's host
 divergence

The line said the key matches placeholder alone, which is true of the web
runtime and not of the tree, where it resolves against the derived
attribute. A spec author reading it wrote a selector that matched on one
host and not the other.
---
 docs/manual/spec-language.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/manual/spec-language.md b/docs/manual/spec-language.md
index 1fd3779..af0366b 100644
--- a/docs/manual/spec-language.md
+++ b/docs/manual/spec-language.md
@@ -156,7 +156,12 @@ Fields available on every element returned by `find` / `findAll`:
   markup writes (`attrs["data-cents"]`, not `attrs.cents`).
 - `attrs.hintText` names an editable field the way a user reads it: its
   `aria-label`, the `<label>` bound to it, its `placeholder`, then its `name`.
-  The `hintText` selector key still matches the `placeholder` attribute alone.
+  The `hintText` selector key does not read that ladder on both hosts: the
+  accessibility tree resolves it against the derived attribute above, and the
+  web runtime resolves it against `placeholder` alone. A field labelled by
+  `aria-label` or a bound `<label>` therefore answers to `{hintText: "Email"}`
+  in one and not the other. Select such a field by `attrs.hintText` until the
+  two agree.
 
 ### KMP (Kotlin Multiplatform)