feat(page-controller): reject misused actions and verify input results

docs/agentic-testing/actions.md

@@ -21,6 +21,7 @@
 | el-scroll    | [Element Plus Scrollbar](https://element-plus.org/en-US/component/scrollbar.html) — vertical / horizontal | Scroll target container in both directions. | Correct region and direction.                         |
 | mui-input    | [MUI Autocomplete](https://mui.com/material-ui/react-autocomplete/) — Controlled states                   | Type, select, clear.                        | Displayed inputValue/value stay consistent.           |
 | radix-select | [Radix Select](https://www.radix-ui.com/primitives/docs/components/select)                                | Select, reopen, select another.             | Value updates; focus returns to trigger.              |
+| imask-input  | [IMask](https://imask.js.org/) — phone mask                                                               | Fill, repeat, clear, retype.                | Formatting, clearing, and repeated input work.        |
 
 ## References
 

packages/page-controller/src/PageController.ts

@@ -276,11 +276,14 @@ export class PageController extends EventTarget {
 			this.assertIndexed()
 			const element = getElementByIndex(this.selectorMap, index)
 			const elemText = this.elementTextMap.get(index)
-			await inputTextElement(element, text)
+			const value = await inputTextElement(element, text)
 
 			return {
 				success: true,
-				message: `✅ Input text (${text}) into element (${elemText ?? index}).`,
+				message:
+					value === text
+						? `✅ Input text (${text}) into element (${elemText ?? index}).`
+						: `✅ Input action completed for element (${elemText ?? index}). Note: requested ${JSON.stringify(text)}; current value is ${JSON.stringify(value)}.`,
 			}
 		} catch (error) {
 			return {

packages/page-controller/src/actions.ts

@@ -62,6 +62,12 @@ function blurLastClickedElement() {
  * @private Internal method, subject to change at any time.
  */
 export async function clickElement(element: HTMLElement) {
+	if (isSelectElement(element)) {
+		throw new Error(
+			'Clicking a native <select> cannot open its options. Select the option by its visible text instead.'
+		)
+	}
+
 	blurLastClickedElement()
 
 	lastClickedElement = element
@@ -125,14 +131,37 @@ export async function clickElement(element: HTMLElement) {
 	await waitFor(0.2)
 }
 
+/** `<input>` types whose `value` is not user-typed text. */
+const NON_TEXT_INPUT_TYPES = new Set([
+	'button',
+	'checkbox',
+	'file',
+	'image',
+	'radio',
+	'reset',
+	'submit',
+])
+
+function assertAcceptsText(element: HTMLElement): void {
+	const acceptsText =
+		isTextAreaElement(element) ||
+		element.isContentEditable ||
+		(isInputElement(element) && !NON_TEXT_INPUT_TYPES.has(element.type))
+	if (!acceptsText) {
+		const tag = isInputElement(element)
+			? `<input type="${element.type}">`
+			: `<${element.tagName.toLowerCase()}>`
+		throw new Error(`${tag} does not accept text input.`)
+	}
+}
+
 /**
  * @private Internal method, subject to change at any time.
  */
-export async function inputTextElement(element: HTMLElement, text: string) {
+export async function inputTextElement(element: HTMLElement, text: string): Promise<string> {
+	assertAcceptsText(element)
+
 	const isContentEditable = element.isContentEditable
-	if (!isInputElement(element) && !isTextAreaElement(element) && !isContentEditable) {
-		throw new Error('Element is not an input, textarea, or contenteditable')
-	}
 
 	await clickElement(element)
 
@@ -217,16 +246,18 @@ export async function inputTextElement(element: HTMLElement, text: string) {
 
 		// Trigger blur for validation
 		element.blur()
-	} else {
-		getNativeValueSetter(element as HTMLInputElement | HTMLTextAreaElement).call(element, text)
-	}
 
-	// Only dispatch shared input event for non-contenteditable (contenteditable has its own)
-	if (!isContentEditable) {
-		element.dispatchEvent(new Event('input', { bubbles: true }))
+		await waitFor(0.1)
+		return element.innerText
 	}
 
+	const input = element as HTMLInputElement | HTMLTextAreaElement
+	getNativeValueSetter(input).call(input, text)
+	input.dispatchEvent(new Event('input', { bubbles: true }))
+
 	await waitFor(0.1)
+
+	return input.value
 }
 
 /**
@@ -245,10 +276,19 @@ export async function selectOptionElement(selectElement: HTMLSelectElement, opti
 		throw new Error(`Option with text "${optionText}" not found in select element`)
 	}
 
-	selectElement.value = option.value
+	// Assigning `value` would pick the first option with that value; index targets this exact option.
+	selectElement.selectedIndex = option.index
+	selectElement.dispatchEvent(new Event('input', { bubbles: true }))
 	selectElement.dispatchEvent(new Event('change', { bubbles: true }))
 
 	await waitFor(0.1) // Wait to ensure change event processing completes
+
+	if (selectElement.selectedIndex !== option.index) {
+		const current = selectElement.selectedOptions.item(0)?.textContent?.trim() ?? ''
+		throw new Error(
+			`The page discarded the selection. Expected option ${JSON.stringify(optionText)}, but the current option is ${JSON.stringify(current)}. Inspect the current page state before retrying.`
+		)
+	}
 }
 
 interface ScrollableElement extends Element {