@eidra-umain/greenlight 0.1.0

package/dist/parser/schema.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+/** Viewport dimensions. */
+export const ViewportSchema = z.object({
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+});
+/** A single test case: a name and ordered list of plain-English steps. */
+export const TestCaseSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    steps: z.array(z.string().min(1)).min(1),
+});
+/**
+ * Top-level suite definition — matches the YAML format from the spec.
+ *
+ * reusable_steps is a map of name → step list.
+ * variables is a map of name → string value.
+ */
+export const SuiteSchema = z.object({
+    suite: z.string().min(1),
+    base_url: z.url().optional(),
+    viewport: ViewportSchema.optional(),
+    model: z
+        .union([
+        z.string().min(1),
+        z.object({ planner: z.string().min(1), pilot: z.string().min(1) }),
+    ])
+        .optional(),
+    variables: z.record(z.string(), z.string()).optional(),
+    reusable_steps: z.record(z.string(), z.array(z.string().min(1))).optional(),
+    tests: z.array(TestCaseSchema).min(1),
+});
+//# sourceMappingURL=schema.js.map

package/dist/parser/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/parser/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,2BAA2B;AAC3B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAA;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACxC,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC;SACN,KAAK,CAAC;QACN,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;SACD,QAAQ,EAAE;IACZ,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrC,CAAC,CAAA"}

package/dist/parser/steps.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Step preprocessor — expands compound steps into individual atomic steps.
+ *
+ * Runs at load time before execution, so there's no runtime cost.
+ * Each output step maps to exactly one browser action.
+ */
+/**
+ * Expand compound steps in a step list.
+ * E.g. "Select Företag - Ventilation - Kylteknik in the leads form"
+ * becomes three steps: click "Företag", click "Ventilation", click "Kylteknik".
+ */
+export declare function expandSteps(steps: string[]): string[];
+//# sourceMappingURL=steps.d.ts.map

package/dist/parser/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/parser/steps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMrD"}

package/dist/parser/steps.js

@@ -0,0 +1,44 @@
+/**
+ * Step preprocessor — expands compound steps into individual atomic steps.
+ *
+ * Runs at load time before execution, so there's no runtime cost.
+ * Each output step maps to exactly one browser action.
+ */
+/**
+ * Expand compound steps in a step list.
+ * E.g. "Select Företag - Ventilation - Kylteknik in the leads form"
+ * becomes three steps: click "Företag", click "Ventilation", click "Kylteknik".
+ */
+export function expandSteps(steps) {
+    const result = [];
+    for (const step of steps) {
+        result.push(...expandStep(step));
+    }
+    return result;
+}
+function expandStep(step) {
+    // "Select X - Y - Z in <context>" → click each item in context
+    const selectChain = /^select\s+(.+?)(?:\s+(?:in|from|on)\s+(.+))?$/i.exec(step);
+    if (selectChain) {
+        const items = selectChain[1];
+        const context = selectChain[2];
+        // Only split on " - " (spaced dashes) to avoid splitting hyphenated words
+        const parts = items.split(/\s+-\s+/);
+        if (parts.length > 1) {
+            return parts.map((part) => {
+                const trimmed = part.trim();
+                return context
+                    ? `click "${trimmed}" in ${context}`
+                    : `click "${trimmed}"`;
+            });
+        }
+    }
+    // "Do X, then Y, then Z" → individual steps
+    const thenParts = step.split(/,?\s+then\s+/i);
+    if (thenParts.length > 1) {
+        return thenParts.map((part) => part.trim());
+    }
+    // No expansion needed
+    return [step];
+}
+//# sourceMappingURL=steps.js.map

package/dist/parser/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/parser/steps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,MAAM,CAAA;AACd,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC/B,+DAA+D;IAC/D,MAAM,WAAW,GAAG,gDAAgD,CAAC,IAAI,CACxE,IAAI,CACJ,CAAA;IACD,IAAI,WAAW,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;QAE9B,0EAA0E;QAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;gBAC3B,OAAO,OAAO;oBACb,CAAC,CAAC,UAAU,OAAO,QAAQ,OAAO,EAAE;oBACpC,CAAC,CAAC,UAAU,OAAO,GAAG,CAAA;YACxB,CAAC,CAAC,CAAA;QACH,CAAC;IACF,CAAC;IAED,4CAA4C;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;IAC7C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,sBAAsB;IACtB,OAAO,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/parser/variables.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Variable interpolation for suite definitions.
+ *
+ * Resolves patterns like:
+ *   {{varName}}        → from suite-level variables
+ *   {{env.VAR_NAME}}   → from process.env
+ *   {{timestamp}}       → current unix timestamp
+ */
+/**
+ * Resolve all `{{...}}` references in a string.
+ * Throws if a variable cannot be resolved.
+ */
+export declare function interpolate(template: string, variables: Record<string, string>): string;
+/**
+ * Resolve variables in all steps of a suite (mutates nothing — returns a new array).
+ */
+export declare function interpolateSteps(steps: string[], variables: Record<string, string>): string[];
+//# sourceMappingURL=variables.d.ts.map

package/dist/parser/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../src/parser/variables.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CA8BR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,EAAE,CAEV"}

package/dist/parser/variables.js

@@ -0,0 +1,44 @@
+/**
+ * Variable interpolation for suite definitions.
+ *
+ * Resolves patterns like:
+ *   {{varName}}        → from suite-level variables
+ *   {{env.VAR_NAME}}   → from process.env
+ *   {{timestamp}}       → current unix timestamp
+ */
+const PATTERN = /\{\{(.+?)\}\}/g;
+/**
+ * Resolve all `{{...}}` references in a string.
+ * Throws if a variable cannot be resolved.
+ */
+export function interpolate(template, variables) {
+    return template.replace(PATTERN, (_match, key) => {
+        const trimmed = key.trim();
+        // Built-in: timestamp
+        if (trimmed === "timestamp") {
+            return String(Date.now());
+        }
+        // Environment variable: env.X
+        if (trimmed.startsWith("env.")) {
+            const envKey = trimmed.slice(4);
+            const value = process.env[envKey];
+            if (value === undefined) {
+                throw new Error(`Environment variable "${envKey}" is not set (referenced as "{{${trimmed}}}")`);
+            }
+            return value;
+        }
+        // Suite-level variable
+        if (!(trimmed in variables)) {
+            throw new Error(`Unknown variable "{{${trimmed}}}". ` +
+                `Available: ${Object.keys(variables).join(", ") || "(none)"}`);
+        }
+        return variables[trimmed];
+    });
+}
+/**
+ * Resolve variables in all steps of a suite (mutates nothing — returns a new array).
+ */
+export function interpolateSteps(steps, variables) {
+    return steps.map((step) => interpolate(step, variables));
+}
+//# sourceMappingURL=variables.js.map

package/dist/parser/variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../../src/parser/variables.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,GAAG,gBAAgB,CAAA;AAEhC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAC1B,QAAgB,EAChB,SAAiC;IAEjC,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,GAAW,EAAE,EAAE;QACxD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QAE1B,sBAAsB;QACtB,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;QAC1B,CAAC;QAED,8BAA8B;QAC9B,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACd,yBAAyB,MAAM,kCAAkC,OAAO,MAAM,CAC9E,CAAA;YACF,CAAC;YACD,OAAO,KAAK,CAAA;QACb,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACd,uBAAuB,OAAO,OAAO;gBACpC,cAAc,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC9D,CAAA;QACF,CAAC;QACD,OAAO,SAAS,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,KAAe,EACf,SAAiC;IAEjC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;AACzD,CAAC"}

package/dist/pilot/a11y-parser.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Accessibility tree snapshot parser with stable ref assignment.
+ */
+import type { A11yNode } from "../reporter/types.js";
+/** Reset stable ref tracking (call between test cases). */
+export declare function resetRefCounter(): void;
+export interface ParsedLine {
+    indent: number;
+    role: string;
+    name: string;
+    attrs: string[];
+    url?: string;
+    raw: string;
+}
+/**
+ * Parse Playwright's ariaSnapshot YAML-like output into A11yNode tree with refs.
+ * Refs are stable across captures: the same element (identified by its
+ * structural path: role + name + sibling index at each tree level) always
+ * gets the same ref within a test case.
+ */
+export declare function parseA11ySnapshot(raw: string): A11yNode[];
+/**
+ * Format the a11y tree as a readable string with refs, for display and LLM consumption.
+ */
+export declare function formatA11yTree(nodes: A11yNode[], indent?: number): string;
+//# sourceMappingURL=a11y-parser.d.ts.map

package/dist/pilot/a11y-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-parser.d.ts","sourceRoot":"","sources":["../../src/pilot/a11y-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAsBpD,2DAA2D;AAC3D,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AA0CD,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACX;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,CAuEzD;AAyDD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,SAAI,GAAG,MAAM,CAkBpE"}

package/dist/pilot/a11y-parser.js

@@ -0,0 +1,195 @@
+/**
+ * Accessibility tree snapshot parser with stable ref assignment.
+ */
+// ── Stable ref assignment ─────────────────────────────────────────────
+/**
+ * Stable ref assignment.
+ *
+ * Refs are derived from a structural path: each interactive element gets a
+ * ref based on its role, name, and sibling index among same-role siblings.
+ * This makes refs stable across captures — a button "Submit" keeps its ref
+ * even when new elements appear elsewhere in the tree.
+ *
+ * A short integer ref (e1, e2, ...) is assigned to each unique structural
+ * path via a persistent map that survives across captures within a test case.
+ * New elements get the next available integer. Removed elements keep their
+ * slot so that the LLM never sees a ref reassigned to a different element.
+ */
+/** Map from structural path -> stable ref. Persists across captures within a test case. */
+let stableRefMap = new Map();
+let nextRefId = 0;
+/** Reset stable ref tracking (call between test cases). */
+export function resetRefCounter() {
+    stableRefMap = new Map();
+    nextRefId = 0;
+}
+/**
+ * Get or assign a stable ref for a structural path.
+ * The path encodes the element's position: role, name, and sibling index
+ * at each level of the tree.
+ */
+function getStableRef(structuralPath) {
+    const existing = stableRefMap.get(structuralPath);
+    if (existing)
+        return existing;
+    nextRefId++;
+    const ref = `e${String(nextRefId)}`;
+    stableRefMap.set(structuralPath, ref);
+    return ref;
+}
+/**
+ * Roles that represent interactive elements the Pilot can act on.
+ * Non-interactive structural roles (list, listitem, paragraph, etc.)
+ * still appear in the tree but don't get refs.
+ */
+const INTERACTIVE_ROLES = new Set([
+    "link",
+    "button",
+    "searchbox",
+    "textbox",
+    "checkbox",
+    "radio",
+    "combobox",
+    "menuitem",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "option",
+    "slider",
+    "spinbutton",
+    "switch",
+    "tab",
+    "treeitem",
+    "img",
+    "heading",
+]);
+/**
+ * Parse Playwright's ariaSnapshot YAML-like output into A11yNode tree with refs.
+ * Refs are stable across captures: the same element (identified by its
+ * structural path: role + name + sibling index at each tree level) always
+ * gets the same ref within a test case.
+ */
+export function parseA11ySnapshot(raw) {
+    const lines = raw.split("\n");
+    const rootNodes = [];
+    // Stack tracks: indent level, node, structural path prefix, and
+    // sibling counters (role -> count) for assigning sibling indices.
+    const stack = [];
+    // Sibling counters at root level
+    const rootSiblingCounts = new Map();
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        // Metadata lines like "  - /url: ..." — attach to parent
+        const urlMatch = /^(\s*)- \/url:\s*(.+)$/.exec(line);
+        if (urlMatch) {
+            const lastNode = stack.at(-1)?.node;
+            if (lastNode) {
+                lastNode.url = urlMatch[2].trim();
+            }
+            continue;
+        }
+        const parsed = parseLine(line);
+        if (!parsed)
+            continue;
+        // Find parent based on indent level
+        while (stack.length > 0) {
+            const top = stack.at(-1);
+            if (top && top.indent >= parsed.indent) {
+                stack.pop();
+            }
+            else {
+                break;
+            }
+        }
+        // Compute structural path for stable ref assignment
+        const parent = stack.at(-1);
+        const siblingCounts = parent ? parent.siblingCounts : rootSiblingCounts;
+        const pathPrefix = parent ? parent.pathPrefix : "";
+        // Sibling key: role + name (elements with the same role and name
+        // under the same parent get distinguished by index)
+        const siblingKey = `${parsed.role}:${parsed.name}`;
+        const siblingIndex = siblingCounts.get(siblingKey) ?? 0;
+        siblingCounts.set(siblingKey, siblingIndex + 1);
+        const structuralPath = `${pathPrefix}/${parsed.role}:${parsed.name}[${String(siblingIndex)}]`;
+        const node = buildNode(parsed, structuralPath);
+        if (!parent) {
+            rootNodes.push(node);
+        }
+        else {
+            parent.node.children ??= [];
+            parent.node.children.push(node);
+        }
+        stack.push({
+            indent: parsed.indent,
+            node,
+            pathPrefix: structuralPath,
+            siblingCounts: new Map(),
+        });
+    }
+    return rootNodes;
+}
+function parseLine(line) {
+    // Match: "  - role "name" [attrs]" or "  - role: text" or "  - role"
+    const match = /^(\s*)- (\w+)(?:\s+"([^"]*)")?(.*)$/.exec(line);
+    if (!match)
+        return null;
+    const [, spaces, role, quotedName, remainder] = match;
+    const indent = spaces.length;
+    let name = quotedName || "";
+    const rest = remainder.trim();
+    // Parse attributes like [level=1] [checked]
+    const attrs = [];
+    const attrMatches = rest.matchAll(/\[([^\]]+)\]/g);
+    for (const m of attrMatches) {
+        attrs.push(m[1]);
+    }
+    // If no quoted name, check for "role: text" pattern
+    if (!name && rest.startsWith(":")) {
+        name = rest.slice(1).trim();
+    }
+    // Extract level from attrs
+    const levelAttr = attrs.find((a) => a.startsWith("level="));
+    return {
+        indent,
+        role,
+        name,
+        attrs,
+        raw: line.trim(),
+        ...(levelAttr ? {} : {}),
+    };
+}
+function buildNode(parsed, structuralPath) {
+    const isInteractive = INTERACTIVE_ROLES.has(parsed.role);
+    const ref = isInteractive ? getStableRef(structuralPath) : `_${parsed.role}`;
+    const node = {
+        ref,
+        role: parsed.role,
+        name: parsed.name,
+        raw: parsed.raw,
+    };
+    // Extract level for headings
+    const levelAttr = parsed.attrs.find((a) => a.startsWith("level="));
+    if (levelAttr) {
+        node.level = parseInt(levelAttr.split("=")[1], 10);
+    }
+    return node;
+}
+/**
+ * Format the a11y tree as a readable string with refs, for display and LLM consumption.
+ */
+export function formatA11yTree(nodes, indent = 0) {
+    const lines = [];
+    const prefix = "  ".repeat(indent);
+    for (const node of nodes) {
+        const refLabel = node.ref.startsWith("_") ? "" : `[${node.ref}] `;
+        const nameStr = node.name ? ` "${node.name}"` : "";
+        const levelStr = node.level != null ? ` [level=${String(node.level)}]` : "";
+        const urlStr = node.url ? ` → ${node.url}` : "";
+        lines.push(`${prefix}${refLabel}${node.role}${nameStr}${levelStr}${urlStr}`);
+        if (node.children) {
+            lines.push(formatA11yTree(node.children, indent + 1));
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=a11y-parser.js.map

package/dist/pilot/a11y-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-parser.js","sourceRoot":"","sources":["../../src/pilot/a11y-parser.ts"],"names":[],"mappings":"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"}

package/dist/pilot/assertions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Assertion execution — validates page state against expected conditions.
+ */
+import type { Page } from "playwright";
+import type { Action, A11yNode } from "../reporter/types.js";
+/**
+ * Poll an assertion until it passes or the timeout expires.
+ * This handles cases where the page is still updating (e.g. dropdown
+ * appearing after typing, navigation completing, etc.).
+ */
+export declare function pollAssertion(check: () => Promise<void>, timeoutMs?: number): Promise<void>;
+/**
+ * Execute an assertion against the current page state.
+ * Positive assertions (checking something exists/appears) are polled with
+ * a timeout to handle async page updates (dropdowns, navigation, etc.).
+ * Negative assertions (checking something is absent) run once immediately.
+ */
+export declare function executeAssertion(page: Page, action: Action, a11yTree: A11yNode[]): Promise<void>;
+/** Extract a numeric value from a text string. */
+export declare function extractNumber(text: string): number | null;
+/**
+ * Execute a compare assertion: read a current value from the page,
+ * compare it against a remembered value using the specified operator.
+ */
+export declare function executeCompareAssertion(page: Page, action: Action, a11yTree: A11yNode[]): Promise<void>;
+export declare function buildAssertionCheck(page: Page, assertion: {
+    type: string;
+    expected: string;
+}): () => Promise<void>;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/pilot/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/pilot/assertions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAI5D;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC1B,SAAS,SAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKzD;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC5C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CAoFf;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,OAAO,CAAC,IAAI,CAAC,CAqFrB"}