feat(expo-router): add Expo Router support for Screens and navigations and introduce Steps API

- Introduces trigger metadata for steps and edges to capture what fires a site (JS prop, on* option, or callback) to improve cross-boundary flow analysis.
- Extends parsing/analysis to detect triggers in JSX attributes, on* bindings, and late-bound callbacks; adds utilities (calleeText, lastSegment) to extract trigger sources.
- Ships new trigger structures (WireStepTrigger, trigger on WireStepSite/WireStep) and propagates trigger through built steps; updates step labeling to reflect trigger information.
- Adds triggerWords helper and uses it to render human-readable trigger descriptions in Steps UI, including edge labels and per-site visuals.
- Updates UI (ScreensView, StepsView) to display FIRES FROM information, with styling tweaks to highlight triggers and related elements; enhances tooltips and inline text wrapping for readability.
- Extends tests to cover trigger detection and rendering across various binding patterns (prop, option, callback) and inline RN listeners.
- Updates design/docs and changelog to reflect Expo Router integration, per-site trigger metadata, and the new Steps surface.
This commit is contained in:
Colby McHenry
2026-08-28 10:40:38 -05:00
parent e288d7645b
commit 5e06204deb
11 changed files with 245 additions and 38 deletions
+8 -1
View File
@@ -71,6 +71,8 @@ export interface WireStepSite {
* summary of all of them.
*/
when: string;
/** What fires THIS site, when it differs from the link's first. */
trigger?: WireStepTrigger;
}
/** What fires a step or a link: the event it is written under, and the function that writes it there. */
@@ -385,9 +387,14 @@ export async function buildSteps(cg: CodeGraph, projectRoot: string, query: URLS
const viaKey = via.map((v) => v.id).join('>');
const id = `${from.id} ${to.id} ${viaKey}`;
const when = whens.filter((w, i) => w && whens.indexOf(w) === i).join(' && ');
const stamped: WireStepSite = { ...site, when };
const stamped: WireStepSite = { ...site, when, ...(trigger ? { trigger } : {}) };
// A `contains` edge is how a nested handler is FOUND, not a place it is
// called from: its row stays only while no call site has been seen.
const structural = (s: WireStepSite) => s.text.startsWith('defines ');
const existing = links.get(id);
if (existing) {
if (structural(stamped) && existing.sites.some((s) => !structural(s))) return;
if (!structural(stamped) && existing.sites.every(structural)) existing.sites.length = 0;
if (!existing.sites.some((s) => s.file === site.file && s.line === site.line)) existing.sites.push(stamped);
if (!existing.trigger && trigger) existing.trigger = trigger;
if (when !== existing.when) {