@@ -142,19 +142,19 @@ export type TypeTextBackendResult = {
142142} ;
143143
144144/**
145- * What a cloud `fill` could establish about its target taking text entry focus
146- * before it sent the keys (#1658). The local Apple runner owns this discipline
147- * in Swift and reports it as a `textEntryRoute`; a cloud session has no runner,
145+ * Focus evidence reported by a cloud `fill` before clearing or typing (#1658).
146+ * The local Apple runner owns this discipline in Swift and reports it as a
147+ * `textEntryRoute`; a cloud session has no runner,
148148 * only what its provider will tell it, so it names what it observed instead of
149149 * which channel it typed through. Listed strongest evidence first:
150150 *
151151 * - `focused-element`: after the tap, the element holding text-entry focus is the
152152 * one this fill aimed at — positive evidence that THIS field, not merely some
153153 * field, took focus. A field that focusing re-laid out still counts.
154- * - `keyboard-shown`: no active-element route, but the software keyboard went
155- * from hidden to shown after our tap. Witnesses that focus arrived somewhere,
156- * which only means our field when the keyboard was down beforehand .
157- * Every value describes a fill that sent its keys AND witnessed focus first .
154+ * - `keyboard-shown`: legacy WebDriver evidence that the software keyboard went
155+ * from hidden to shown after the tap. Retained for released provider results;
156+ * current WebDriver fills require a focused element reference and do not emit it .
157+ * Current cloud fills report `focused-element`, including clear-only fills .
158158 * There is deliberately no value for "typed without evidence": nothing renders
159159 * this field, so such a value would reach a caller as an ordinary success and
160160 * recreate the #1658 silent false success it exists to remove. Every
@@ -167,9 +167,8 @@ export type TypeTextBackendResult = {
167167 * wait could establish anything. `press` + `type` remains the deliberate way
168168 * to enter text unwitnessed.
169169 *
170- * Closed set: the two cloud interactors are its only producers and the boundary
171- * that narrows it (readFillBackendResult in the touch handler) drops a value it
172- * cannot name.
170+ * Closed set accepted by readFillBackendResult at the touch boundary. It keeps
171+ * the legacy result readable and drops values it cannot name.
173172 */
174173export const CLOUD_TEXT_ENTRY_READINESS = [ 'focused-element' , 'keyboard-shown' ] as const ;
175174
0 commit comments