Lykhoyda
diff --git a/‎.changeset/rnt-selector-resolver-phase1.md‎
Lines changed: 6 additions & 0 deletions b/‎.changeset/rnt-selector-resolver-phase1.md‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎docs/superpowers/plans/2026-06-19-rnt-selector-resolver-phase1.md‎
Lines changed: 2480 additions & 0 deletions b/‎docs/superpowers/plans/2026-06-19-rnt-selector-resolver-phase1.md‎
Lines changed: 2480 additions & 0 deletions
diff --git a/‎docs/superpowers/specs/2026-06-19-rnt-selector-resolver-projector-design.md‎
Lines changed: 198 additions & 0 deletions b/‎docs/superpowers/specs/2026-06-19-rnt-selector-resolver-projector-design.md‎
Lines changed: 198 additions & 0 deletions
diff --git a/‎scripts/cdp-bridge/dist/index.js‎
Lines changed: 21 additions & 2 deletions b/‎scripts/cdp-bridge/dist/index.js‎
Lines changed: 21 additions & 2 deletions
diff --git a/‎scripts/cdp-bridge/dist/injected-helpers.js‎
Lines changed: 729 additions & 2 deletions b/‎scripts/cdp-bridge/dist/injected-helpers.js‎
Lines changed: 729 additions & 2 deletions
diff --git a/‎scripts/cdp-bridge/dist/tools/interact.js‎
Lines changed: 11 additions & 2 deletions b/‎scripts/cdp-bridge/dist/tools/interact.js‎
Lines changed: 11 additions & 2 deletions
diff --git a/‎scripts/cdp-bridge/src/index.ts‎
Lines changed: 27 additions & 2 deletions b/‎scripts/cdp-bridge/src/index.ts‎
Lines changed: 27 additions & 2 deletions
@@ -0,0 +1,6 @@
+---
+"rn-dev-agent-cdp": minor
+"rn-dev-agent-plugin": minor
+---
+
+Add an RNTL-style discovery resolver to the injected helpers. `resolveLadder` finds elements by `byRole(+name)` / `byText` / `byPlaceholder` — ported from React Native Testing Library (matcher + normalizer, accessible-name, role, hidden, host-kind) — with fail-closed truncation and fail-closed multiplicity (never silently picks the wrong element), hidden-element exclusion by default, and a selector bundle (`testID` / `text` / `accessibleName` / `role` / `placeholder` / `anchors`). `interact()` routes `role`/`name`/`text`/`placeholder` selectors through the ladder. Includes RNTL `matchDeepestOnly` so a composite+host fiber pair (e.g. `Text`+`RCTText`) resolves to a single on-device element instead of fail-closing as ambiguous.
@@ -666,14 +666,33 @@ trackedTool('cdp_interact', 'Interact with React components by testID (preferred
         .string()
         .optional()
         .describe('accessibilityLabel prop (used if testID not provided). Tiered match: exact → normalized (trim+lowercase) → substring. Returns Ambiguous error if >1 component matches.'),
-    text: z.string().optional().describe('Required for typeText: the text to enter'),
+    text: z
+        .string()
+        .optional()
+        .describe('For typeText: the text to enter. For the discovery ladder (no testID/accessibilityLabel, action:"press"): byText — match a host Text by its visible text content.'),
+    role: z
+        .string()
+        .optional()
+        .describe('Discovery ladder (press-only): match by accessibility role (e.g. button, tab, link). Combine with `name` for the accessible name. Needs an explicit accessibilityRole — Pressables without one resolve as role "none".'),
+    placeholder: z
+        .string()
+        .optional()
+        .describe('Discovery ladder (press-only): match a TextInput by its placeholder text.'),
+    exact: z
+        .boolean()
+        .optional()
+        .describe('Discovery ladder: require an exact (full-string) match for text/name/placeholder instead of case-insensitive substring.'),
+    includeHidden: z
+        .boolean()
+        .optional()
+        .describe('Discovery ladder: include accessibility-hidden elements (excluded by default).'),
     scrollX: z.number().optional().describe('For scroll: horizontal offset in pixels (default 0)'),
     scrollY: z.number().optional().describe('For scroll: vertical offset in pixels (default 300)'),
     animated: z.boolean().default(true).describe('For scroll: whether to animate'),
     name: z
         .string()
         .optional()
-        .describe('Required for setFieldValue: the React Hook Form field name (same string you passed to useController({name}) or <Controller name="...">).'),
+        .describe('For setFieldValue: the React Hook Form field name (same string you passed to useController({name}) or <Controller name="...">). For the discovery ladder with `role`: the accessible name to match (e.g. role:"button" + name:"Save").'),
     value: z
         .union([z.string(), z.number(), z.boolean()])
         .optional()
 
@@ -1,8 +1,9 @@
 import { okResult, failResult, withConnection } from '../utils.js';
 export function createInteractHandler(getClient) {
     return withConnection(getClient, async (args, client) => {
-        if (!args.testID && !args.accessibilityLabel) {
-            return failResult('Either testID or accessibilityLabel is required');
+        const hasLadderSelector = Boolean(args.role || args.text || args.placeholder);
+        if (!args.testID && !args.accessibilityLabel && !hasLadderSelector) {
+            return failResult('A selector is required: testID / accessibilityLabel, or a discovery-ladder selector (role / text / placeholder).');
         }
         if (args.action === 'typeText' && args.text === undefined) {
             return failResult('text parameter is required for typeText action');
@@ -35,6 +36,14 @@ export function createInteractHandler(getClient) {
             opts.shouldValidate = args.shouldValidate;
         if (args.shouldDirty !== undefined)
             opts.shouldDirty = args.shouldDirty;
+        if (args.role !== undefined)
+            opts.role = args.role;
+        if (args.placeholder !== undefined)
+            opts.placeholder = args.placeholder;
+        if (args.exact !== undefined)
+            opts.exact = args.exact;
+        if (args.includeHidden !== undefined)
+            opts.includeHidden = args.includeHidden;
         const result = await client.evaluate(`__RN_AGENT.interact(${JSON.stringify(opts)})`);
         if (result.error) {
             return failResult(`Interact error: ${result.error}`);
 
@@ -945,15 +945,40 @@ trackedTool(
       .describe(
         'accessibilityLabel prop (used if testID not provided). Tiered match: exact → normalized (trim+lowercase) → substring. Returns Ambiguous error if >1 component matches.',
       ),
-    text: z.string().optional().describe('Required for typeText: the text to enter'),
+    text: z
+      .string()
+      .optional()
+      .describe(
+        'For typeText: the text to enter. For the discovery ladder (no testID/accessibilityLabel, action:"press"): byText — match a host Text by its visible text content.',
+      ),
+    role: z
+      .string()
+      .optional()
+      .describe(
+        'Discovery ladder (press-only): match by accessibility role (e.g. button, tab, link). Combine with `name` for the accessible name. Needs an explicit accessibilityRole — Pressables without one resolve as role "none".',
+      ),
+    placeholder: z
+      .string()
+      .optional()
+      .describe('Discovery ladder (press-only): match a TextInput by its placeholder text.'),
+    exact: z
+      .boolean()
+      .optional()
+      .describe(
+        'Discovery ladder: require an exact (full-string) match for text/name/placeholder instead of case-insensitive substring.',
+      ),
+    includeHidden: z
+      .boolean()
+      .optional()
+      .describe('Discovery ladder: include accessibility-hidden elements (excluded by default).'),
     scrollX: z.number().optional().describe('For scroll: horizontal offset in pixels (default 0)'),
     scrollY: z.number().optional().describe('For scroll: vertical offset in pixels (default 300)'),
     animated: z.boolean().default(true).describe('For scroll: whether to animate'),
     name: z
       .string()
       .optional()
       .describe(
-        'Required for setFieldValue: the React Hook Form field name (same string you passed to useController({name}) or <Controller name="...">).',
+        'For setFieldValue: the React Hook Form field name (same string you passed to useController({name}) or <Controller name="...">). For the discovery ladder with `role`: the accessible name to match (e.g. role:"button" + name:"Save").',
       ),
     value: z
       .union([z.string(), z.number(), z.boolean()])