Resolve a controller-supplied selector to a single actionable locator.
Zero or one match returns the locator unchanged, so the common path keeps
Playwright's auto-wait semantics byte-for-byte (an element that appears a
moment later is still waited for). Only a genuine multi-match — today a
guaranteed strict-mode throw — is narrowed via chooseSelectorMatch.
Never throws: if measurement fails for any reason, the caller gets the
unnarrowed locator and the pre-existing behavior.
Resolve a controller-supplied selector to a single actionable locator.
Zero or one match returns the locator unchanged, so the common path keeps Playwright's auto-wait semantics byte-for-byte (an element that appears a moment later is still waited for). Only a genuine multi-match — today a guaranteed strict-mode throw — is narrowed via chooseSelectorMatch.
Never throws: if measurement fails for any reason, the caller gets the unnarrowed locator and the pre-existing behavior.