@qa-ai-stlc/explorer 0.1.0 → 0.3.0

package/dist/accessibility-tree.d.ts

@@ -0,0 +1,14 @@
+import type { AccessibilityNode } from '@qa-ai-stlc/schemas';
+import { type NormalizeLimits } from './normalize.js';
+export interface NormalizedAccessibilityTree {
+    readonly tree: AccessibilityNode;
+    readonly truncated: boolean;
+}
+/**
+ * Turns the free-form JSON `AuthPage.ariaSnapshotJSON()` returns into a capped
+ * `AccessibilityNode` tree. The input is untrusted, page-derived data (development plan section
+ * 2.6): every field is read defensively, string fields are length-capped, and the total node
+ * count is capped so one page can never grow the artifact — or an agent's context — unbounded.
+ */
+export declare function normalizeAccessibilityTree(raw: unknown, limits?: NormalizeLimits): NormalizedAccessibilityTree;
+//# sourceMappingURL=accessibility-tree.d.ts.map

package/dist/accessibility-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-tree.d.ts","sourceRoot":"","sources":["../src/accessibility-tree.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAO9F,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,eAA0C,GACjD,2BAA2B,CA+D7B"}

package/dist/accessibility-tree.js

@@ -0,0 +1,73 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { DEFAULT_NORMALIZE_LIMITS, truncateText } from './normalize.js';
+const FALLBACK_ROLE = 'generic';
+const TEXT_ROLE = 'text';
+const ROOT_ROLE = 'root';
+const BOOLEAN_FLAGS = ['checked', 'disabled', 'expanded', 'pressed', 'selected'];
+/**
+ * Turns the free-form JSON `AuthPage.ariaSnapshotJSON()` returns into a capped
+ * `AccessibilityNode` tree. The input is untrusted, page-derived data (development plan section
+ * 2.6): every field is read defensively, string fields are length-capped, and the total node
+ * count is capped so one page can never grow the artifact — or an agent's context — unbounded.
+ */
+export function normalizeAccessibilityTree(raw, limits = DEFAULT_NORMALIZE_LIMITS) {
+    let nodeCount = 0;
+    let truncated = false;
+    function normalizeText(text) {
+        const result = truncateText(text, limits);
+        if (result.truncated) {
+            truncated = true;
+        }
+        return result.text;
+    }
+    function visit(node) {
+        nodeCount += 1;
+        if (nodeCount > limits.maxTreeNodes) {
+            truncated = true;
+            return undefined;
+        }
+        // A static text fragment is serialized as a bare string, not an object with role: "text"
+        // (Playwright's own `ariaSnapshotJSON` format).
+        if (typeof node === 'string') {
+            return { role: TEXT_ROLE, text: normalizeText(node) };
+        }
+        const record = typeof node === 'object' && node !== null && !Array.isArray(node)
+            ? node
+            : {};
+        const result = { role: typeof record.role === 'string' ? record.role : FALLBACK_ROLE };
+        if (typeof record.name === 'string') {
+            result.name = normalizeText(record.name);
+        }
+        if (typeof record.text === 'string') {
+            result.text = normalizeText(record.text);
+        }
+        for (const flag of BOOLEAN_FLAGS) {
+            if (typeof record[flag] === 'boolean') {
+                result[flag] = record[flag];
+            }
+        }
+        if (Array.isArray(record.children)) {
+            const children = record.children
+                .map(visit)
+                .filter((child) => child !== undefined);
+            if (children.length > 0) {
+                result.children = children;
+            }
+        }
+        return result;
+    }
+    // `ariaSnapshotJSON()` returns a *list* of root-level nodes, not one root object; a
+    // single-element list is unwrapped, and a multi-element one gets a synthetic root so the
+    // schema's single `accessibilityTree` field always has exactly one tree to hold.
+    // `Array.isArray` narrows to `any[]`, so the elements are re-typed `unknown` explicitly.
+    const rootNodes = Array.isArray(raw) ? raw : undefined;
+    const rootInput = rootNodes === undefined
+        ? raw
+        : rootNodes.length === 1
+            ? rootNodes[0]
+            : { role: ROOT_ROLE, children: rootNodes };
+    const tree = visit(rootInput) ?? { role: FALLBACK_ROLE };
+    return { tree, truncated };
+}
+//# sourceMappingURL=accessibility-tree.js.map

package/dist/accessibility-tree.js.map

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

package/dist/analyze-page.d.ts

@@ -0,0 +1,10 @@
+import type { AuthPage } from '@qa-ai-stlc/core';
+import type { PageModel } from '@qa-ai-stlc/schemas';
+import { type NormalizeLimits } from './normalize.js';
+/**
+ * Builds a `PageModel` for the page `page` is currently showing: its accessibility tree,
+ * interactive elements, forms, tables and dialogs, all length- and count-capped (development plan
+ * section 2.6). Does not navigate; the caller decides which URL is current.
+ */
+export declare function analyzePage(page: AuthPage, url: string, limits?: NormalizeLimits): Promise<PageModel>;
+//# sourceMappingURL=analyze-page.d.ts.map

package/dist/analyze-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-page.d.ts","sourceRoot":"","sources":["../src/analyze-page.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGhF;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,eAA0C,GACjD,OAAO,CAAC,SAAS,CAAC,CAiBpB"}

package/dist/analyze-page.js

@@ -0,0 +1,25 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { normalizeAccessibilityTree } from './accessibility-tree.js';
+import { DEFAULT_NORMALIZE_LIMITS } from './normalize.js';
+import { extractPageElements } from './page-elements.js';
+/**
+ * Builds a `PageModel` for the page `page` is currently showing: its accessibility tree,
+ * interactive elements, forms, tables and dialogs, all length- and count-capped (development plan
+ * section 2.6). Does not navigate; the caller decides which URL is current.
+ */
+export async function analyzePage(page, url, limits = DEFAULT_NORMALIZE_LIMITS) {
+    const rawAccessibilityTree = await page.ariaSnapshotJSON();
+    const { tree, truncated: accessibilityTruncated } = normalizeAccessibilityTree(rawAccessibilityTree, limits);
+    const elements = await extractPageElements(page, limits);
+    return {
+        url,
+        accessibilityTree: tree,
+        interactiveElements: elements.interactiveElements,
+        forms: elements.forms,
+        tables: elements.tables,
+        dialogs: elements.dialogs,
+        truncated: accessibilityTruncated || elements.truncated,
+    };
+}
+//# sourceMappingURL=analyze-page.js.map

package/dist/analyze-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-page.js","sourceRoot":"","sources":["../src/analyze-page.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAItC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAwB,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAc,EACd,GAAW,EACX,SAA0B,wBAAwB;IAElD,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC3D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,sBAAsB,EAAE,GAAG,0BAA0B,CAC5E,oBAAoB,EACpB,MAAM,CACP,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEzD,OAAO;QACL,GAAG;QACH,iBAAiB,EAAE,IAAI;QACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,SAAS,EAAE,sBAAsB,IAAI,QAAQ,CAAC,SAAS;KACxD,CAAC;AACJ,CAAC"}

package/dist/analyze-pages.d.ts

@@ -0,0 +1,24 @@
+import { type BrowserLauncher, type Clock } from '@qa-ai-stlc/core';
+import { type PageModelSet } from '@qa-ai-stlc/schemas';
+import { type ExplorerIdentity } from './identity.js';
+import { type NormalizeLimits } from './normalize.js';
+export interface AnalyzePagesOptions {
+    readonly urls: readonly string[];
+    readonly browserLauncher: BrowserLauncher;
+    /** Signs in before analyzing, reusing `authenticate()` (P1-05). Omit to analyze anonymously. */
+    readonly identity?: ExplorerIdentity;
+    readonly limits?: NormalizeLimits;
+    readonly clock?: Clock;
+}
+export interface AnalyzePagesResult {
+    readonly pageModelSet: PageModelSet;
+    /** Every non-GET request safe mode intercepted and cancelled; always 0 unless something is broken. */
+    readonly blockedRequestCount: number;
+}
+/**
+ * Analyzes every URL in `urls` — typically a crawl's `RouteMap.routes` — in one browser session,
+ * in safe mode (development plan section 6.3 step 3): navigating for analysis never sends a
+ * non-GET request either. Produces one `PageModel` per URL, in the given order.
+ */
+export declare function analyzePages(options: AnalyzePagesOptions): Promise<AnalyzePagesResult>;
+//# sourceMappingURL=analyze-pages.d.ts.map

package/dist/analyze-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-pages.d.ts","sourceRoot":"","sources":["../src/analyze-pages.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,eAAe,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExF,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGhF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,sGAAsG;IACtG,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgC5F"}

package/dist/analyze-pages.js

@@ -0,0 +1,42 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { systemClock } from '@qa-ai-stlc/core';
+import { SCHEMA_VERSION } from '@qa-ai-stlc/schemas';
+import { analyzePage } from './analyze-page.js';
+import { resolveStorageState } from './identity.js';
+import { DEFAULT_NORMALIZE_LIMITS } from './normalize.js';
+import { createSafeModeRouteHandler } from './safe-mode.js';
+/**
+ * Analyzes every URL in `urls` — typically a crawl's `RouteMap.routes` — in one browser session,
+ * in safe mode (development plan section 6.3 step 3): navigating for analysis never sends a
+ * non-GET request either. Produces one `PageModel` per URL, in the given order.
+ */
+export async function analyzePages(options) {
+    const clock = options.clock ?? systemClock;
+    const limits = options.limits ?? DEFAULT_NORMALIZE_LIMITS;
+    const storageState = await resolveStorageState(options.browserLauncher, options.identity);
+    const browser = await options.browserLauncher.launch();
+    try {
+        const context = await browser.newContext(storageState === undefined ? {} : { storageState });
+        const page = await context.newPage();
+        let blockedRequestCount = 0;
+        await page.route('**/*', createSafeModeRouteHandler(() => {
+            blockedRequestCount += 1;
+        }));
+        const pages = [];
+        for (const url of options.urls) {
+            await page.goto(url);
+            pages.push(await analyzePage(page, url, limits));
+        }
+        const pageModelSet = {
+            schemaVersion: SCHEMA_VERSION,
+            generatedAt: clock.now().toISOString(),
+            pages,
+        };
+        return { pageModelSet, blockedRequestCount };
+    }
+    finally {
+        await browser.close();
+    }
+}
+//# sourceMappingURL=analyze-pages.js.map

package/dist/analyze-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-pages.js","sourceRoot":"","sources":["../src/analyze-pages.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,WAAW,EAAoC,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAqC,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAyB,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAwB,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAiB5D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,wBAAwB,CAAC;IAC1D,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1F,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QAC7F,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,CAAC,KAAK,CACd,MAAM,EACN,0BAA0B,CAAC,GAAG,EAAE;YAC9B,mBAAmB,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,KAAK,GAAgB,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,YAAY,GAAiB;YACjC,aAAa,EAAE,cAAc;YAC7B,WAAW,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;YACtC,KAAK;SACN,CAAC;QACF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/crawl.d.ts

@@ -1,11 +1,7 @@
 import { type BrowserLauncher, type Clock } from '@qa-ai-stlc/core';
-import { type IdentityConfig, type RouteMap } from '@qa-ai-stlc/schemas';
-export interface CrawlIdentity {
-    readonly config: IdentityConfig;
-    readonly env: Readonly<Record<string, string | undefined>>;
-    /** Required, and only used, when `identity.config.auth` is `"cdp-attach"`. */
-    readonly cdpEndpointUrl?: string;
-}
+import { type RouteMap } from '@qa-ai-stlc/schemas';
+import { type ExplorerIdentity } from './identity.js';
+export type CrawlIdentity = ExplorerIdentity;
 export interface CrawlOptions {
     readonly startUrl: string;
     /** Hostnames the crawl may navigate to (development plan section 6.4); a link outside it is dropped. */

package/dist/crawl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crawl.d.ts","sourceRoot":"","sources":["../src/crawl.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,KAAK,EAEX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wGAAwG;IACxG,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,sGAAsG;IACtG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sGAAsG;IACtG,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAQD;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAoCvE"}
+{"version":3,"file":"crawl.d.ts","sourceRoot":"","sources":["../src/crawl.ts"],"names":[],"mappings":"AAGA,OAAO,EAA8B,KAAK,eAAe,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAwC,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG1F,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAM3E,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wGAAwG;IACxG,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,sGAAsG;IACtG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sGAAsG;IACtG,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAQD;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAoCvE"}

package/dist/crawl.js

@@ -1,9 +1,10 @@
 // Copyright The QA-AI-STLC Authors
 // SPDX-License-Identifier: Apache-2.0
-import { authenticate, systemClock, } from '@qa-ai-stlc/core';
-import { SCHEMA_VERSION, } from '@qa-ai-stlc/schemas';
+import { systemClock } from '@qa-ai-stlc/core';
+import { SCHEMA_VERSION } from '@qa-ai-stlc/schemas';
 import { isAllowedUrl, normalizeUrl } from './allowlist.js';
 import { extractLinks } from './extract-links.js';
+import { resolveStorageState } from './identity.js';
 import { buildRequestLogHar } from './request-log.js';
 import { createSafeModeRouteHandler } from './safe-mode.js';
 const DEFAULT_MAX_PAGES = 50;
@@ -16,7 +17,7 @@ const DEFAULT_MAX_PAGES = 50;
 export async function crawl(options) {
     const clock = options.clock ?? systemClock;
     const maxPages = options.maxPages ?? DEFAULT_MAX_PAGES;
-    const storageState = await resolveStorageState(options);
+    const storageState = await resolveStorageState(options.browserLauncher, options.identity);
     const browser = await options.browserLauncher.launch();
     try {
         const context = await browser.newContext(storageState === undefined ? {} : { storageState });
@@ -44,16 +45,6 @@ export async function crawl(options) {
         await browser.close();
     }
 }
-async function resolveStorageState(options) {
-    if (options.identity === undefined) {
-        return undefined;
-    }
-    return authenticate(options.browserLauncher, options.identity.config, options.identity.env, {
-        ...(options.identity.cdpEndpointUrl !== undefined
-            ? { cdpEndpointUrl: options.identity.cdpEndpointUrl }
-            : {}),
-    });
-}
 async function visitAllowedRoutes(page, options, maxPages, logEntries) {
     const visited = new Set();
     const routes = [];

package/dist/crawl.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1,11 @@
+import { type BrowserLauncher, type StorageState } from '@qa-ai-stlc/core';
+import type { IdentityConfig } from '@qa-ai-stlc/schemas';
+export interface ExplorerIdentity {
+    readonly config: IdentityConfig;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    /** Required, and only used, when `identity.config.auth` is `"cdp-attach"`. */
+    readonly cdpEndpointUrl?: string;
+}
+/** Signs in through P1-05's `authenticate()` when an identity is given; `undefined` for an anonymous session. */
+export declare function resolveStorageState(browserLauncher: BrowserLauncher, identity: ExplorerIdentity | undefined): Promise<StorageState | undefined>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,iHAAiH;AACjH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GACrC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAOnC"}

package/dist/identity.js

@@ -0,0 +1,13 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { authenticate } from '@qa-ai-stlc/core';
+/** Signs in through P1-05's `authenticate()` when an identity is given; `undefined` for an anonymous session. */
+export async function resolveStorageState(browserLauncher, identity) {
+    if (identity === undefined) {
+        return undefined;
+    }
+    return authenticate(browserLauncher, identity.config, identity.env, {
+        ...(identity.cdpEndpointUrl !== undefined ? { cdpEndpointUrl: identity.cdpEndpointUrl } : {}),
+    });
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,YAAY,EAA2C,MAAM,kBAAkB,CAAC;AAUzF,iHAAiH;AACjH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,eAAgC,EAChC,QAAsC;IAEtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,YAAY,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE;QAClE,GAAG,CAAC,QAAQ,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9F,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,13 @@
+export * from './accessibility-tree.js';
 export * from './allowlist.js';
+export * from './analyze-page.js';
+export * from './analyze-pages.js';
 export * from './crawl.js';
 export * from './extract-links.js';
+export * from './identity.js';
+export * from './normalize.js';
+export * from './page-elements.js';
 export * from './request-log.js';
+export * from './safe-mode.js';
+export * from './synthesize-locators.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,7 +1,15 @@
 // Copyright The QA-AI-STLC Authors
 // SPDX-License-Identifier: Apache-2.0
+export * from './accessibility-tree.js';
 export * from './allowlist.js';
+export * from './analyze-page.js';
+export * from './analyze-pages.js';
 export * from './crawl.js';
 export * from './extract-links.js';
+export * from './identity.js';
+export * from './normalize.js';
+export * from './page-elements.js';
 export * from './request-log.js';
+export * from './safe-mode.js';
+export * from './synthesize-locators.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,25 @@
+export interface NormalizeLimits {
+    readonly maxTextLength: number;
+    readonly maxArrayLength: number;
+    readonly maxTreeNodes: number;
+}
+export declare const DEFAULT_NORMALIZE_LIMITS: NormalizeLimits;
+/**
+ * Caps a single piece of page-derived text (development plan section 2.6): untrusted content
+ * from the application under test is never passed on unbounded. Returns the text unchanged, and
+ * `truncated: false`, when it is already within the limit.
+ */
+export declare function truncateText(text: string, limits?: NormalizeLimits): {
+    readonly text: string;
+    readonly truncated: boolean;
+};
+/**
+ * Caps how many items of a page-derived list (interactive elements, table rows, ...) are kept.
+ * Every element on a page still gets *counted* elsewhere; this only bounds how many are carried
+ * into the artifact and, eventually, into an agent's context.
+ */
+export declare function capArray<T>(items: readonly T[], limits?: NormalizeLimits): {
+    readonly items: readonly T[];
+    readonly truncated: boolean;
+};
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,wBAAwB,EAAE,eAItC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,eAA0C,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAKxD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,GAAE,eAA0C,GACjD;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAK/D"}

package/dist/normalize.js

@@ -0,0 +1,31 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+export const DEFAULT_NORMALIZE_LIMITS = {
+    maxTextLength: 200,
+    maxArrayLength: 200,
+    maxTreeNodes: 500,
+};
+const TRUNCATION_SUFFIX = '…';
+/**
+ * Caps a single piece of page-derived text (development plan section 2.6): untrusted content
+ * from the application under test is never passed on unbounded. Returns the text unchanged, and
+ * `truncated: false`, when it is already within the limit.
+ */
+export function truncateText(text, limits = DEFAULT_NORMALIZE_LIMITS) {
+    if (text.length <= limits.maxTextLength) {
+        return { text, truncated: false };
+    }
+    return { text: text.slice(0, limits.maxTextLength) + TRUNCATION_SUFFIX, truncated: true };
+}
+/**
+ * Caps how many items of a page-derived list (interactive elements, table rows, ...) are kept.
+ * Every element on a page still gets *counted* elsewhere; this only bounds how many are carried
+ * into the artifact and, eventually, into an agent's context.
+ */
+export function capArray(items, limits = DEFAULT_NORMALIZE_LIMITS) {
+    if (items.length <= limits.maxArrayLength) {
+        return { items, truncated: false };
+    }
+    return { items: items.slice(0, limits.maxArrayLength), truncated: true };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAQtC,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,aAAa,EAAE,GAAG;IAClB,cAAc,EAAE,GAAG;IACnB,YAAY,EAAE,GAAG;CAClB,CAAC;AAEF,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,SAA0B,wBAAwB;IAElD,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,iBAAiB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC5F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAmB,EACnB,SAA0B,wBAAwB;IAElD,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC3E,CAAC"}

package/dist/page-elements.d.ts

@@ -0,0 +1,13 @@
+import type { AuthPage } from '@qa-ai-stlc/core';
+import type { Dialog, Form, InteractiveElement, Table } from '@qa-ai-stlc/schemas';
+import { type NormalizeLimits } from './normalize.js';
+export interface PageElements {
+    readonly interactiveElements: InteractiveElement[];
+    readonly forms: Form[];
+    readonly tables: Table[];
+    readonly dialogs: Dialog[];
+    readonly truncated: boolean;
+}
+/** Extracts and normalizes every interactive element, form, table and dialog on the current page. */
+export declare function extractPageElements(page: AuthPage, limits: NormalizeLimits): Promise<PageElements>;
+//# sourceMappingURL=page-elements.d.ts.map

package/dist/page-elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-elements.d.ts","sourceRoot":"","sources":["../src/page-elements.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EACV,MAAM,EACN,IAAI,EAEJ,kBAAkB,EAElB,KAAK,EACN,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA2C9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAkPD,qGAAqG;AACrG,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAuCxG"}

package/dist/page-elements.js

@@ -0,0 +1,255 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { capArray, truncateText } from './normalize.js';
+const INTERACTIVE_ELEMENT_KINDS = [
+    'button',
+    'link',
+    'input',
+    'select',
+    'textarea',
+];
+function isInteractiveElementKind(value) {
+    return INTERACTIVE_ELEMENT_KINDS.includes(value);
+}
+/**
+ * Reads every interactive element, form, table and dialog on the current page. The callback runs
+ * inside the browser (Playwright serializes it across the CDP boundary), so it can reference DOM
+ * globals unavailable to the rest of this package.
+ */
+async function readRawPageElements(page) {
+    /* v8 ignore next 90 -- runs in the browser's own V8 instance, invisible to Node coverage */
+    const result = await page.evaluate(() => {
+        function accessibleName(element) {
+            const ariaLabel = element.getAttribute('aria-label');
+            if (ariaLabel !== null && ariaLabel.trim().length > 0) {
+                return ariaLabel;
+            }
+            const text = element.textContent.trim();
+            return text.length > 0 ? text : undefined;
+        }
+        // A small, explicit table rather than full ARIA role computation: locator synthesis only
+        // needs a role plausible enough for `getByRole`, and the five kinds below are the only ones
+        // this extractor recognizes in the first place.
+        function computeRole(element, kind) {
+            const explicit = element.getAttribute('role');
+            if (explicit !== null && explicit.trim().length > 0) {
+                return explicit;
+            }
+            if (kind === 'textarea') {
+                return 'textbox';
+            }
+            if (kind === 'select') {
+                return 'combobox';
+            }
+            if (kind === 'input') {
+                const type = (element.getAttribute('type') ?? 'text').toLowerCase();
+                if (type === 'checkbox' || type === 'radio') {
+                    return type;
+                }
+                if (type === 'button' || type === 'submit' || type === 'reset') {
+                    return 'button';
+                }
+                return 'textbox';
+            }
+            return kind === 'button' || kind === 'link' ? kind : undefined;
+        }
+        // `for`/`id` association first, then an ancestor `<label>` that wraps the field.
+        function labelText(element) {
+            const id = element.getAttribute('id');
+            if (id !== null && id.length > 0) {
+                const associated = document.querySelector(`label[for="${CSS.escape(id)}"]`);
+                const text = associated?.textContent.trim();
+                if (text !== undefined && text.length > 0) {
+                    return text;
+                }
+            }
+            const wrapping = element.closest('label')?.textContent.trim();
+            return wrapping !== undefined && wrapping.length > 0 ? wrapping : undefined;
+        }
+        // Position among same-tag siblings, so a CSS fallback candidate can be built without a live
+        // page: `tagName:nth-of-type(nthOfType)` scoped to the element's own parent.
+        function nthOfType(element) {
+            const parent = element.parentElement;
+            if (parent === null) {
+                return 1;
+            }
+            let index = 0;
+            for (const sibling of parent.children) {
+                if (sibling.tagName === element.tagName) {
+                    index += 1;
+                    if (sibling === element) {
+                        return index;
+                    }
+                }
+            }
+            return 1;
+        }
+        const kindByTagName = {
+            a: 'link',
+            button: 'button',
+            input: 'input',
+            select: 'select',
+            textarea: 'textarea',
+        };
+        const interactiveElements = Array.from(document.querySelectorAll('button, a[href], input, select, textarea')).map((element) => {
+            const tagName = element.tagName.toLowerCase();
+            const kind = kindByTagName[tagName] ?? tagName;
+            return {
+                kind,
+                accessibleName: accessibleName(element),
+                testId: element.getAttribute('data-testid') ?? undefined,
+                role: computeRole(element, kind),
+                label: labelText(element),
+                placeholder: element.getAttribute('placeholder') ?? undefined,
+                htmlId: element.getAttribute('id') ?? undefined,
+                tagName,
+                nthOfType: nthOfType(element),
+            };
+        });
+        const forms = Array.from(document.querySelectorAll('form')).map((form) => ({
+            action: form.getAttribute('action') ?? undefined,
+            method: (form.getAttribute('method') ?? 'get').toLowerCase(),
+            fields: Array.from(form.querySelectorAll('input, select, textarea')).map((field) => ({
+                name: field.getAttribute('name') ?? undefined,
+                type: field.getAttribute('type') ?? field.tagName.toLowerCase(),
+                required: field.hasAttribute('required'),
+            })),
+        }));
+        const tables = Array.from(document.querySelectorAll('table')).map((table) => ({
+            columnHeaders: Array.from(table.querySelectorAll('thead th')).map((header) => header.textContent.trim()),
+            rowCount: table.querySelectorAll('tbody tr').length,
+        }));
+        const dialogs = Array.from(document.querySelectorAll('dialog, [role="dialog"]')).map((dialog) => ({
+            accessibleName: accessibleName(dialog),
+            open: dialog.hasAttribute('open'),
+        }));
+        return { interactiveElements, forms, tables, dialogs };
+    });
+    return isRawPageElements(result) ? result : undefined;
+}
+function isRawPageElements(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const record = value;
+    return (Array.isArray(record.interactiveElements) &&
+        Array.isArray(record.forms) &&
+        Array.isArray(record.tables) &&
+        Array.isArray(record.dialogs));
+}
+function normalizeInteractiveElement(raw, limits, onTruncated) {
+    if (!isInteractiveElementKind(raw.kind)) {
+        return undefined;
+    }
+    const element = { kind: raw.kind, tagName: raw.tagName, nthOfType: raw.nthOfType };
+    if (raw.accessibleName !== undefined) {
+        const { text, truncated } = truncateText(raw.accessibleName, limits);
+        element.accessibleName = text;
+        if (truncated) {
+            onTruncated();
+        }
+    }
+    if (raw.testId !== undefined) {
+        element.testId = raw.testId;
+    }
+    if (raw.role !== undefined) {
+        element.role = raw.role;
+    }
+    if (raw.label !== undefined) {
+        const { text, truncated } = truncateText(raw.label, limits);
+        element.label = text;
+        if (truncated) {
+            onTruncated();
+        }
+    }
+    if (raw.placeholder !== undefined) {
+        const { text, truncated } = truncateText(raw.placeholder, limits);
+        element.placeholder = text;
+        if (truncated) {
+            onTruncated();
+        }
+    }
+    if (raw.htmlId !== undefined) {
+        const { text, truncated } = truncateText(raw.htmlId, limits);
+        element.htmlId = text;
+        if (truncated) {
+            onTruncated();
+        }
+    }
+    return element;
+}
+function normalizeForm(raw) {
+    const form = {
+        method: raw.method,
+        fields: raw.fields.map((field) => {
+            const result = { type: field.type, required: field.required };
+            if (field.name !== undefined) {
+                result.name = field.name;
+            }
+            return result;
+        }),
+    };
+    if (raw.action !== undefined) {
+        form.action = raw.action;
+    }
+    return form;
+}
+function normalizeTable(raw, limits, onTruncated) {
+    const headers = raw.columnHeaders.map((header) => {
+        const { text, truncated } = truncateText(header, limits);
+        if (truncated) {
+            onTruncated();
+        }
+        return text;
+    });
+    return { columnHeaders: headers, rowCount: raw.rowCount };
+}
+function normalizeDialog(raw, limits, onTruncated) {
+    const dialog = { open: raw.open };
+    if (raw.accessibleName !== undefined) {
+        const { text, truncated } = truncateText(raw.accessibleName, limits);
+        dialog.accessibleName = text;
+        if (truncated) {
+            onTruncated();
+        }
+    }
+    return dialog;
+}
+/** Extracts and normalizes every interactive element, form, table and dialog on the current page. */
+export async function extractPageElements(page, limits) {
+    const raw = await readRawPageElements(page);
+    if (raw === undefined) {
+        return { interactiveElements: [], forms: [], tables: [], dialogs: [], truncated: true };
+    }
+    let truncated = false;
+    const markTruncated = () => {
+        truncated = true;
+    };
+    const interactiveElements = capArray(raw.interactiveElements, limits);
+    if (interactiveElements.truncated) {
+        truncated = true;
+    }
+    const forms = capArray(raw.forms, limits);
+    if (forms.truncated) {
+        truncated = true;
+    }
+    const tables = capArray(raw.tables, limits);
+    if (tables.truncated) {
+        truncated = true;
+    }
+    const dialogs = capArray(raw.dialogs, limits);
+    if (dialogs.truncated) {
+        truncated = true;
+    }
+    const normalizedInteractiveElements = interactiveElements.items
+        .map((element) => normalizeInteractiveElement(element, limits, markTruncated))
+        .filter((element) => element !== undefined);
+    return {
+        interactiveElements: normalizedInteractiveElements,
+        forms: forms.items.map(normalizeForm),
+        tables: tables.items.map((table) => normalizeTable(table, limits, markTruncated)),
+        dialogs: dialogs.items.map((dialog) => normalizeDialog(dialog, limits, markTruncated)),
+        truncated,
+    };
+}
+//# sourceMappingURL=page-elements.js.map

package/dist/page-elements.js.map

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

package/dist/synthesize-locators.d.ts

@@ -0,0 +1,6 @@
+import type { InteractiveElement, LocatorCandidate } from '@qa-ai-stlc/schemas';
+export declare const LOCATOR_POLICIES: readonly ["playwright-default", "testid-first", "strict-no-css"];
+export type LocatorPolicy = (typeof LOCATOR_POLICIES)[number];
+/** Generates locator candidates for one interactive element, ordered by the given policy. */
+export declare function synthesizeLocatorCandidates(element: InteractiveElement, policy: LocatorPolicy): LocatorCandidate[];
+//# sourceMappingURL=synthesize-locators.d.ts.map

package/dist/synthesize-locators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize-locators.d.ts","sourceRoot":"","sources":["../src/synthesize-locators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,eAAO,MAAM,gBAAgB,kEAAmE,CAAC;AACjG,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAyE9D,6FAA6F;AAC7F,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,aAAa,GACpB,gBAAgB,EAAE,CAapB"}

package/dist/synthesize-locators.js

@@ -0,0 +1,74 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+export const LOCATOR_POLICIES = ['playwright-default', 'testid-first', 'strict-no-css'];
+// A CSS `id` is untrusted, page-derived text: it can contain anything, including characters that
+// are not valid unescaped in a CSS identifier. Rather than escaping, an id outside this safe
+// pattern falls back to the nth-of-type candidate below.
+const CSS_SAFE_ID = /^[A-Za-z_][A-Za-z0-9_-]*$/;
+function buildRoleCandidate(element) {
+    const name = element.accessibleName ?? element.label;
+    if (element.role === undefined || name === undefined) {
+        return undefined;
+    }
+    return { strategy: 'role', value: JSON.stringify({ role: element.role, name }), fragile: false };
+}
+function buildTestIdCandidate(element) {
+    return element.testId === undefined
+        ? undefined
+        : { strategy: 'testId', value: element.testId, fragile: false };
+}
+function buildLabelCandidate(element) {
+    return element.label === undefined
+        ? undefined
+        : { strategy: 'label', value: element.label, fragile: false };
+}
+function buildPlaceholderCandidate(element) {
+    return element.placeholder === undefined
+        ? undefined
+        : { strategy: 'placeholder', value: element.placeholder, fragile: false };
+}
+function buildTextCandidate(element) {
+    return element.accessibleName === undefined
+        ? undefined
+        : { strategy: 'text', value: element.accessibleName, fragile: false };
+}
+// The last-resort candidate: always present, always flagged fragile, since a CSS selector breaks
+// under refactors that Playwright's role/label/testid locators survive (development plan 6.3.4).
+function buildCssCandidate(element) {
+    const value = element.htmlId !== undefined && CSS_SAFE_ID.test(element.htmlId)
+        ? `#${element.htmlId}`
+        : `${element.tagName}:nth-of-type(${String(element.nthOfType)})`;
+    return { strategy: 'css', value, fragile: true };
+}
+const NON_CSS_BUILDERS = {
+    role: buildRoleCandidate,
+    testId: buildTestIdCandidate,
+    label: buildLabelCandidate,
+    placeholder: buildPlaceholderCandidate,
+    text: buildTextCandidate,
+};
+// Order follows Playwright's own guidance (development plan 6.3.4): role with an accessible name
+// first, then test ID, then label/placeholder, then text, with CSS always last. `testid-first`
+// swaps the first two for teams that mandate stable test IDs; `strict-no-css` drops the fragile
+// fallback entirely, so an element with none of the other signals gets zero candidates.
+const POLICY_ORDER = {
+    'playwright-default': ['role', 'testId', 'label', 'placeholder', 'text', 'css'],
+    'testid-first': ['testId', 'role', 'label', 'placeholder', 'text', 'css'],
+    'strict-no-css': ['role', 'testId', 'label', 'placeholder', 'text'],
+};
+/** Generates locator candidates for one interactive element, ordered by the given policy. */
+export function synthesizeLocatorCandidates(element, policy) {
+    const candidates = [];
+    for (const strategy of POLICY_ORDER[policy]) {
+        if (strategy === 'css') {
+            candidates.push(buildCssCandidate(element));
+            continue;
+        }
+        const candidate = NON_CSS_BUILDERS[strategy](element);
+        if (candidate !== undefined) {
+            candidates.push(candidate);
+        }
+    }
+    return candidates;
+}
+//# sourceMappingURL=synthesize-locators.js.map

package/dist/synthesize-locators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize-locators.js","sourceRoot":"","sources":["../src/synthesize-locators.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAItC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,oBAAoB,EAAE,cAAc,EAAE,eAAe,CAAU,CAAC;AAMjG,iGAAiG;AACjG,6FAA6F;AAC7F,yDAAyD;AACzD,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEhD,SAAS,kBAAkB,CAAC,OAA2B;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC;IACrD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACnG,CAAC;AAED,SAAS,oBAAoB,CAAC,OAA2B;IACvD,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS;QACjC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA2B;IACtD,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,yBAAyB,CAAC,OAA2B;IAC5D,OAAO,OAAO,CAAC,WAAW,KAAK,SAAS;QACtC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,kBAAkB,CAAC,OAA2B;IACrD,OAAO,OAAO,CAAC,cAAc,KAAK,SAAS;QACzC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC1E,CAAC;AAED,iGAAiG;AACjG,iGAAiG;AACjG,SAAS,iBAAiB,CAAC,OAA2B;IACpD,MAAM,KAAK,GACT,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9D,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE;QACtB,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,gBAAgB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;IACrE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,gBAAgB,GAGlB;IACF,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,yBAAyB;IACtC,IAAI,EAAE,kBAAkB;CACzB,CAAC;AAEF,iGAAiG;AACjG,+FAA+F;AAC/F,gGAAgG;AAChG,wFAAwF;AACxF,MAAM,YAAY,GAA+C;IAC/D,oBAAoB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;IAC/E,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;IACzE,eAAe,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC;CACpE,CAAC;AAEF,6FAA6F;AAC7F,MAAM,UAAU,2BAA2B,CACzC,OAA2B,EAC3B,MAAqB;IAErB,MAAM,UAAU,GAAuB,EAAE,CAAC;IAC1C,KAAK,MAAM,QAAQ,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qa-ai-stlc/explorer",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "The crawler: route discovery in safe mode, redacted request logging, and the route map every later explorer phase builds on.",
   "type": "module",
   "license": "Apache-2.0",
@@ -28,8 +28,8 @@
     "clean": "node ../../scripts/clean-dir.mjs dist"
   },
   "dependencies": {
-    "@qa-ai-stlc/core": "0.1.0",
-    "@qa-ai-stlc/schemas": "0.1.0"
+    "@qa-ai-stlc/core": "0.2.1",
+    "@qa-ai-stlc/schemas": "0.3.0"
   },
   "devDependencies": {
     "@qa-ai-stlc/test-utils": "0.0.0"