@cementic/cementic-test 0.2.14 → 0.2.16

package/dist/cli.js

@@ -1,11 +1,16 @@
 #!/usr/bin/env node
+import {
+  captureElements,
+  formatCaptureFailure,
+  toPageSummary
+} from "./chunk-WUGSOKKY.js";
 import {
   genCmd
-} from "./chunk-3S26OWNR.js";
+} from "./chunk-PYKYHIO3.js";
 
 // src/cli.ts
 import { Command as Command9 } from "commander";
-import { createRequire as createRequire2 } from "module";
+import { createRequire } from "module";
 
 // src/commands/new.ts
 import { Command } from "commander";
@@ -365,7 +370,7 @@ Examples:
     }
     console.log(`\u2705 Normalized ${index.summary.parsed} case(s). Output \u2192 .cementic/normalized/`);
     if (opts.andGen) {
-      const { gen } = await import("./gen-AGWFMHTO.js");
+      const { gen } = await import("./gen-WYG3JOGJ.js");
       await gen({ lang: opts.lang || "ts", out: "tests/generated" });
     }
   });
@@ -396,7 +401,7 @@ function testCmd() {
 // src/commands/tc.ts
 import { Command as Command4 } from "commander";
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
-import { join as join5 } from "path";
+import { join as join4 } from "path";
 import { createInterface } from "readline/promises";
 import { stdin as input, stdout as output } from "process";
 
@@ -1463,10 +1468,11 @@ RULES:
 9. For presence-only intents such as "verify X" or "X is present", only assert visibility. Do not click and do not assert outcomes after clicking.
 ${RULE_10_PLAYWRIGHT_KNOWLEDGE_BASE2}
 11. For fill steps, never use the literal word "value". If matching CT_VAR_* variables are listed in the prompt, use them in human-readable step text and use a realistic non-generic runtime value in the JSON value field. Otherwise use a field-specific fallback such as test-username or test-password.
-12. The "selector" field must be a raw selector expression such as locator("#username") or getByRole('button', { name: "Login" }). Never wrap selectors in page. or page.locator("...") inside JSON.
-13. Tie-breaker for multiple matching elements: prefer highest confidence, then interactive elements, then the first visible-looking candidate.
-14. If a page clearly contains login or auth fields, do not create submit scenarios that only click the button. Include realistic fill steps for captured username/email and password inputs when the intent asks for auth interaction.
-15. "verify title" means the main visible heading on the page, not the browser tab title, unless the intent explicitly says browser title, tab title, or page title.
+12. When a CTA could realistically be a button or a link, prefer a resilient selector such as getByRole('button', { name: /Join Now/i }).or(page.getByRole('link', { name: /Join Now/i })).
+13. The "selector" field must be a raw selector expression such as locator("#username") or getByRole('button', { name: "Login" }). Never wrap selectors in page. or page.locator("...") inside JSON, except inside Locator.or(...) where the alternate locator must be page-scoped.
+14. Tie-breaker for multiple matching elements: prefer highest confidence, then interactive elements, then the first visible-looking candidate.
+15. If a page clearly contains login or auth fields, do not create submit scenarios that only click the button. Include realistic fill steps for captured username/email and password inputs when the intent asks for auth interaction.
+16. "verify title" means the main visible heading on the page, not the browser tab title, unless the intent explicitly says browser title, tab title, or page title.
 
 OUTPUT SCHEMA:
 {
@@ -2243,7 +2249,7 @@ function extractPresenceClaims(feature, elementMap) {
     const text = extractIntentLabel(segment);
     if (!text) continue;
     const match = findBestMatchingElement(elementMap, text, normalized);
-    const selector = match?.selector ?? buildFallbackSelector(text, normalized);
+    const selector = buildIntentSelector(text, normalized, match);
     claims.push({
       selector,
       human: `${text} is visible`
@@ -2259,16 +2265,23 @@ function chooseHeadingElement(elementMap) {
 function extractIntentLabel(segment) {
   const unquoted = Array.from(segment.matchAll(/["“”']([^"“”']+)["“”']/g)).map((match) => match[1].trim());
   if (unquoted.length > 0) return unquoted[0];
-  return segment.replace(/\b(?:verify|check|confirm|ensure)\b/gi, " ").replace(/\b(?:the|a|an)\b/gi, " ").replace(/\b(?:is|are|be|should be)\b/gi, " ").replace(/\b(?:present|visible|shown|showing|available|exists?)\b/gi, " ").replace(/\b(?:button|link|cta|label|text)\b/gi, " ").replace(/[.?!,:;]+/g, " ").replace(/\s+/g, " ").trim();
+  return segment.replace(/\b(?:verify|check|confirm|ensure)\b/gi, " ").replace(/\b(?:the|a|an)\b/gi, " ").replace(/\b(?:is|are|be|should be)\b/gi, " ").replace(/\b(?:present|visible|shown|showing|available|exists?)\b/gi, " ").replace(/\b(?:on|in)\s+(?:the\s+)?page\b/gi, " ").replace(/\b(?:button|link|cta|label|text)\b/gi, " ").replace(/[.?!,:;]+/g, " ").replace(/\s+/g, " ").trim();
 }
 function findBestMatchingElement(elementMap, text, segment) {
   const preferredCategory = /\bbutton\b/.test(segment) ? "button" : /\blink\b/.test(segment) ? "link" : /\bheading\b/.test(segment) ? "heading" : void 0;
   const query = text.toLowerCase();
   const candidates = elementMap.elements.filter((element) => {
-    if (preferredCategory && element.category !== preferredCategory) return false;
     const haystack = `${element.name ?? ""} ${element.purpose}`.toLowerCase();
     return haystack.includes(query);
   });
+  if (!preferredCategory) return rankElements(candidates)[0];
+  const preferred = candidates.filter((element) => element.category === preferredCategory);
+  if (preferred.length > 0) return rankElements(preferred)[0];
+  if ((preferredCategory === "button" || preferredCategory === "link") && shouldUseAmbiguousCtaSelector(segment, text)) {
+    const alternateCategory = preferredCategory === "button" ? "link" : "button";
+    const alternates = candidates.filter((element) => element.category === alternateCategory);
+    if (alternates.length > 0) return rankElements(alternates)[0];
+  }
   return rankElements(candidates)[0];
 }
 function rankElements(elements) {
@@ -2282,11 +2295,32 @@ function rankElements(elements) {
     return 0;
   });
 }
-function buildFallbackSelector(text, segment) {
+function buildIntentSelector(text, segment, match) {
+  if (shouldUseAmbiguousCtaSelector(segment, text)) {
+    if (/\blink\b/.test(segment)) return buildAmbiguousRoleSelector(text, "link");
+    if (/\bbutton\b/.test(segment) || match?.category === "link" || match?.category === "button") {
+      return buildAmbiguousRoleSelector(text, "button");
+    }
+  }
+  return match?.selector ?? buildFallbackSelector(text, segment);
+}
+function shouldUseAmbiguousCtaSelector(segment, text) {
+  const haystack = `${segment} ${text}`.toLowerCase();
+  return /\b(?:button|link|cta)\b/.test(haystack) && (/\b(?:join|start|get started|sign up|signup|subscribe|buy|purchase|learn more|see how it works|continue)\b/.test(haystack) || /[$€£]/.test(text));
+}
+function buildAmbiguousRoleSelector(text, preferredRole) {
+  const primary = buildRoleSelector(preferredRole, text);
+  const alternate = buildRoleSelector(preferredRole === "button" ? "link" : "button", text);
+  return `${primary}.or(page.${alternate})`;
+}
+function buildRoleSelector(role, text) {
   const safeRegex = text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  if (/\bbutton\b/.test(segment)) return `getByRole('button', { name: /${safeRegex}/i })`;
-  if (/\blink\b/.test(segment)) return `getByRole('link', { name: /${safeRegex}/i })`;
-  if (/\b(?:title|heading)\b/.test(segment)) return `getByRole('heading', { name: /${safeRegex}/i })`;
+  return `getByRole('${role}', { name: /${safeRegex}/i })`;
+}
+function buildFallbackSelector(text, segment) {
+  if (/\bbutton\b/.test(segment)) return buildRoleSelector("button", text);
+  if (/\blink\b/.test(segment)) return buildRoleSelector("link", text);
+  if (/\b(?:title|heading)\b/.test(segment)) return buildRoleSelector("heading", text);
   return `getByText(${JSON.stringify(text)})`;
 }
 function buildAudioSummary(feature, scenarios) {
@@ -2497,6 +2531,10 @@ function extractCtVarTemplate(value) {
 function isAllowedSelector(selector, selectors) {
   if (selector === "page") return true;
   if (selectors.has(selector)) return true;
+  if (/\.or\(page\.(?:getByRole|getByText|getByLabel|getByPlaceholder|getByTestId|locator)\(/.test(selector)) {
+    const primary = selector.replace(/\.or\(page\.(?:getByRole|getByText|getByLabel|getByPlaceholder|getByTestId|locator)\([\s\S]*\)\)\s*$/, "");
+    return isAllowedSelector(primary, selectors);
+  }
   return /^(?:getByRole|getByText|getByLabel|getByPlaceholder|getByTestId)\(/.test(selector) || /^locator\((['"])(#.+?)\1\)$/.test(selector);
 }
 function ensureStatement(value) {
@@ -2521,565 +2559,9 @@ function log(verbose, message) {
   if (verbose) console.log(message);
 }
 
-// src/core/playwright.ts
-import { existsSync as existsSync2 } from "fs";
-import { dirname as dirname2, join as join3, resolve as resolve3 } from "path";
-import { createRequire } from "module";
-import { fileURLToPath as fileURLToPath2, pathToFileURL } from "url";
-var require2 = createRequire(import.meta.url);
-var moduleDir = dirname2(fileURLToPath2(import.meta.url));
-async function resolvePlaywrightChromium(cwd = process.cwd()) {
-  const searchRoots = buildSearchRoots(cwd);
-  for (const packageName of ["@playwright/test", "playwright-core"]) {
-    for (const searchRoot of searchRoots) {
-      const resolvedPath = resolveFromRoot(packageName, searchRoot);
-      if (!resolvedPath) continue;
-      const imported = await import(pathToFileURL(resolvedPath).href);
-      const chromium = imported.chromium ?? imported.default?.chromium;
-      if (chromium) {
-        return {
-          packageName,
-          resolvedPath,
-          searchRoot,
-          chromium
-        };
-      }
-    }
-  }
-  throw new Error(
-    "Playwright runtime not found in this project.\nTry:\n  npm install\n  npx playwright install chromium"
-  );
-}
-function buildSearchRoots(cwd) {
-  const roots = [resolve3(cwd)];
-  const projectRoot = findNearestProjectRoot(cwd);
-  if (projectRoot && projectRoot !== roots[0]) {
-    roots.push(projectRoot);
-  }
-  roots.push(moduleDir);
-  return Array.from(new Set(roots));
-}
-function findNearestProjectRoot(startDir) {
-  let currentDir = resolve3(startDir);
-  while (true) {
-    if (existsSync2(join3(currentDir, "package.json"))) {
-      return currentDir;
-    }
-    const parentDir = dirname2(currentDir);
-    if (parentDir === currentDir) return void 0;
-    currentDir = parentDir;
-  }
-}
-function resolveFromRoot(packageName, searchRoot) {
-  try {
-    return require2.resolve(packageName, { paths: [searchRoot] });
-  } catch {
-    return void 0;
-  }
-}
-
-// src/core/capture.ts
-var SETTLE_MS = 1200;
-var DEFAULT_TIMEOUT_MS = 3e4;
-var MAX_PER_CATEGORY = 50;
-var CaptureRuntimeError = class extends Error {
-  constructor(code, message, options) {
-    super(message);
-    this.name = "CaptureRuntimeError";
-    this.code = code;
-    if (options?.cause !== void 0) {
-      this.cause = options.cause;
-    }
-  }
-};
-async function captureElements(url, options = {}) {
-  const {
-    headless = true,
-    timeoutMs = DEFAULT_TIMEOUT_MS,
-    verbose = false,
-    userAgent = "Mozilla/5.0 (compatible; CementicTest/0.2.7 capture)"
-  } = options;
-  const chromium = await loadChromium();
-  const mode = headless ? "headless" : "headed";
-  log2(verbose, `
-[capture] Starting ${mode} capture: ${url}`);
-  let browser;
-  try {
-    browser = await chromium.launch({
-      headless,
-      slowMo: headless ? 0 : 150
-    });
-  } catch (error) {
-    throw classifyCaptureError(error);
-  }
-  const context = await browser.newContext({
-    userAgent,
-    viewport: { width: 1280, height: 800 },
-    ignoreHTTPSErrors: true
-  });
-  const page = await context.newPage();
-  try {
-    log2(verbose, `  -> Navigating (timeout: ${timeoutMs}ms)`);
-    try {
-      await page.goto(url, {
-        waitUntil: "domcontentloaded",
-        timeout: timeoutMs
-      });
-    } catch (error) {
-      throw new CaptureRuntimeError(
-        "PAGE_LOAD_FAILED",
-        `Page load failed for ${url}. ${error?.message ?? error}`,
-        { cause: error }
-      );
-    }
-    log2(verbose, `  -> Waiting ${SETTLE_MS}ms for page settle`);
-    await page.waitForTimeout(SETTLE_MS);
-    log2(verbose, "  -> Extracting accessibility snapshot");
-    const a11ySnapshot = await getAccessibilitySnapshot(page, verbose);
-    log2(verbose, "  -> Extracting DOM data");
-    const domData = await page.evaluate(extractDomData);
-    const title = await page.title();
-    const finalUrl = page.url();
-    const elements = buildElementMap(domData);
-    const warnings = buildWarnings(elements, domData, a11ySnapshot);
-    const byCategory = {};
-    for (const element of elements) {
-      byCategory[element.category] = (byCategory[element.category] ?? 0) + 1;
-    }
-    const result = {
-      url: finalUrl,
-      title,
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      mode,
-      summary: {
-        totalElements: elements.length,
-        byCategory
-      },
-      elements,
-      warnings
-    };
-    log2(verbose, `  -> Captured ${elements.length} testable elements from "${title}"`);
-    return result;
-  } catch (error) {
-    throw classifyCaptureError(error);
-  } finally {
-    await browser?.close();
-  }
-}
-function toPageSummary(elementMap) {
-  const inputs = elementMap.elements.filter((element) => element.category === "input").slice(0, 30).map((element) => ({
-    label: asString(element.attributes.label),
-    placeholder: asString(element.attributes.placeholder),
-    name: asString(element.attributes.name),
-    type: asString(element.attributes.type),
-    testId: asString(element.attributes.testId)
-  }));
-  return {
-    url: elementMap.url,
-    title: elementMap.title,
-    headings: elementMap.elements.filter((element) => element.category === "heading").map((element) => element.name ?? "").filter(Boolean).slice(0, 20),
-    buttons: elementMap.elements.filter((element) => element.category === "button").map((element) => element.name ?? "").filter(Boolean).slice(0, 30),
-    links: elementMap.elements.filter((element) => element.category === "link").map((element) => element.name ?? "").filter(Boolean).slice(0, 50),
-    inputs,
-    landmarks: [],
-    rawLength: elementMap.elements.length
-  };
-}
-async function loadChromium() {
-  try {
-    const resolution = await resolvePlaywrightChromium(process.cwd());
-    return resolution.chromium;
-  } catch (error) {
-    throw new CaptureRuntimeError(
-      "PLAYWRIGHT_NOT_FOUND",
-      error?.message ?? "Playwright runtime not found in this project.\nTry:\n  npm install\n  npx playwright install chromium",
-      { cause: error }
-    );
-  }
-}
-function extractDomData() {
-  const localMaxPerCategory = 50;
-  const attr = (el, name) => el.getAttribute(name)?.trim() || void 0;
-  const text = (el) => el?.textContent?.replace(/\s+/g, " ").trim() || void 0;
-  const jsString = (value) => JSON.stringify(value);
-  const findLabel = (el) => {
-    const id = attr(el, "id");
-    if (id) {
-      const labelEl = document.querySelector(`label[for="${id}"]`);
-      if (labelEl) return text(labelEl);
-    }
-    const ariaLabel = attr(el, "aria-label");
-    if (ariaLabel) return ariaLabel;
-    const labelledBy = attr(el, "aria-labelledby");
-    if (labelledBy) {
-      const labelEl = document.getElementById(labelledBy);
-      if (labelEl) return text(labelEl);
-    }
-    const closestLabel = el.closest("label");
-    if (closestLabel) {
-      const raw = text(closestLabel) || "";
-      const placeholder = attr(el, "placeholder") || "";
-      return raw.replace(placeholder, "").trim() || void 0;
-    }
-    const previous = el.previousElementSibling;
-    if (previous?.tagName === "LABEL") return text(previous);
-    return void 0;
-  };
-  const buildSelector = (el, labelText, buttonText) => {
-    const testId = attr(el, "data-testid");
-    if (testId) return `getByTestId(${jsString(testId)})`;
-    const id = attr(el, "id");
-    if (id && !id.match(/^(ember|react|vue|ng|auto|rand)/i)) {
-      return `locator(${jsString(`#${id}`)})`;
-    }
-    const ariaLabel = attr(el, "aria-label");
-    if (ariaLabel) {
-      return `getByRole(${jsString(el.getAttribute("role") || el.tagName.toLowerCase())}, { name: ${jsString(ariaLabel)} })`;
-    }
-    if (labelText) {
-      const tag = el.tagName.toLowerCase();
-      if (tag === "input" || tag === "textarea" || tag === "select") {
-        return `getByLabel(${jsString(labelText)})`;
-      }
-    }
-    if (buttonText) return `getByRole('button', { name: ${jsString(buttonText)} })`;
-    const name = attr(el, "name");
-    if (name) return `locator(${jsString(`[name="${name}"]`)})`;
-    return null;
-  };
-  const buttons = [];
-  document.querySelectorAll('button, [role="button"], input[type="submit"], input[type="button"]').forEach((el) => {
-    const buttonText = attr(el, "aria-label") || text(el) || attr(el, "value");
-    const testId = attr(el, "data-testid");
-    const id = attr(el, "id");
-    const type = attr(el, "type");
-    const disabled = el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true";
-    const selector = buildSelector(el, void 0, buttonText);
-    if (buttonText || testId) {
-      buttons.push({
-        tag: el.tagName.toLowerCase(),
-        text: buttonText,
-        testId,
-        id,
-        type,
-        disabled,
-        selector,
-        cssPath: testId ? `[data-testid="${testId}"]` : id ? `#${id}` : null
-      });
-    }
-  });
-  const inputs = [];
-  document.querySelectorAll('input:not([type="hidden"]):not([type="submit"]):not([type="button"]), textarea, select').forEach((el) => {
-    const label = findLabel(el);
-    const placeholder = attr(el, "placeholder");
-    const name = attr(el, "name");
-    const id = attr(el, "id");
-    const type = attr(el, "type") || el.tagName.toLowerCase();
-    const testId = attr(el, "data-testid");
-    const required = el.hasAttribute("required");
-    const selector = buildSelector(el, label);
-    if (label || placeholder || name || testId || id) {
-      inputs.push({
-        tag: el.tagName.toLowerCase(),
-        type,
-        label,
-        placeholder,
-        name,
-        id,
-        testId,
-        required,
-        selector,
-        cssPath: testId ? `[data-testid="${testId}"]` : id ? `#${id}` : name ? `[name="${name}"]` : null
-      });
-    }
-  });
-  const links = [];
-  document.querySelectorAll("a[href]").forEach((el) => {
-    const linkText = attr(el, "aria-label") || text(el);
-    const href = attr(el, "href");
-    const testId = attr(el, "data-testid");
-    if (!linkText || href === "#") return;
-    links.push({
-      text: linkText,
-      href,
-      testId,
-      external: Boolean(href?.startsWith("http") && !href.includes(window.location.hostname)),
-      selector: testId ? `getByTestId(${jsString(testId)})` : `getByRole('link', { name: ${jsString(linkText)} })`
-    });
-  });
-  const headings = [];
-  document.querySelectorAll("h1, h2, h3").forEach((el) => {
-    const headingText = text(el);
-    if (headingText) {
-      headings.push({
-        level: el.tagName.toLowerCase(),
-        text: headingText,
-        selector: `getByRole('heading', { name: ${jsString(headingText)} })`
-      });
-    }
-  });
-  const landmarks = [];
-  document.querySelectorAll("[role], main, nav, header, footer, aside, section[aria-label]").forEach((el) => {
-    const role = attr(el, "role") || el.tagName.toLowerCase();
-    const label = attr(el, "aria-label") || text(el)?.slice(0, 40);
-    if (role && label) landmarks.push({ role, label });
-  });
-  const statusRegions = [];
-  document.querySelectorAll('[role="alert"], [role="status"], [aria-live]').forEach((el) => {
-    const role = attr(el, "role") || "live";
-    statusRegions.push({
-      role,
-      ariaLive: attr(el, "aria-live"),
-      text: text(el),
-      selector: el.getAttribute("role") ? `getByRole(${jsString(role)})` : `locator('[aria-live]')`
-    });
-  });
-  const forms = [];
-  document.querySelectorAll("form").forEach((form, index) => {
-    forms.push({
-      id: attr(form, "id"),
-      label: attr(form, "aria-label") || attr(form, "aria-labelledby"),
-      action: attr(form, "action"),
-      method: attr(form, "method") || "get",
-      fieldCount: form.querySelectorAll("input, textarea, select").length,
-      index
-    });
-  });
-  return {
-    buttons: buttons.slice(0, localMaxPerCategory),
-    inputs: inputs.slice(0, localMaxPerCategory),
-    links: links.slice(0, localMaxPerCategory),
-    headings: headings.slice(0, 20),
-    landmarks,
-    statusRegions,
-    forms,
-    pageUrl: window.location.href,
-    pageTitle: document.title
-  };
-}
-function buildElementMap(domData) {
-  const elements = [];
-  for (const input2 of domData.inputs) {
-    const displayName = input2.label || input2.placeholder || input2.name || input2.testId;
-    if (!displayName) continue;
-    const selector = input2.selector || (input2.testId ? `getByTestId(${JSON.stringify(input2.testId)})` : null) || (input2.label ? `getByLabel(${JSON.stringify(input2.label)})` : null) || (input2.id ? `locator(${JSON.stringify(`#${input2.id}`)})` : null) || (input2.name ? `locator(${JSON.stringify(`[name="${input2.name}"]`)})` : null) || `locator(${JSON.stringify(`${input2.tag}[placeholder="${input2.placeholder ?? ""}"]`)})`;
-    const selectorAlt = [];
-    if (input2.id && !selector.includes(`#${input2.id}`)) selectorAlt.push(`locator(${JSON.stringify(`#${input2.id}`)})`);
-    if (input2.name && !selector.includes(input2.name)) selectorAlt.push(`locator(${JSON.stringify(`[name="${input2.name}"]`)})`);
-    if (input2.testId && !selector.includes(input2.testId)) selectorAlt.push(`getByTestId(${JSON.stringify(input2.testId)})`);
-    if (input2.placeholder && !selector.includes(input2.placeholder)) selectorAlt.push(`getByPlaceholder(${JSON.stringify(input2.placeholder)})`);
-    if (input2.label && !selector.includes(input2.label)) selectorAlt.push(`getByLabel(${JSON.stringify(input2.label)})`);
-    elements.push({
-      category: "input",
-      role: input2.type === "checkbox" ? "checkbox" : "textbox",
-      name: displayName,
-      selector,
-      selectorAlt,
-      purpose: input2.required ? `Required ${input2.type} field - "${displayName}"` : `${input2.type} field - "${displayName}"`,
-      confidence: input2.testId || input2.label || input2.id ? "high" : input2.placeholder ? "medium" : "low",
-      attributes: {
-        type: input2.type,
-        label: input2.label,
-        placeholder: input2.placeholder,
-        name: input2.name,
-        id: input2.id,
-        testId: input2.testId,
-        required: input2.required,
-        tag: input2.tag
-      }
-    });
-  }
-  for (const button of domData.buttons) {
-    const displayName = button.text || button.testId;
-    if (!displayName) continue;
-    const selector = button.selector || (button.testId ? `getByTestId(${JSON.stringify(button.testId)})` : null) || (button.text ? `getByRole('button', { name: ${JSON.stringify(button.text)} })` : null) || (button.id ? `locator(${JSON.stringify(`#${button.id}`)})` : null) || `locator('button')`;
-    const selectorAlt = [];
-    if (button.id && !selector.includes(button.id)) selectorAlt.push(`locator(${JSON.stringify(`#${button.id}`)})`);
-    if (button.testId && !selector.includes(button.testId)) selectorAlt.push(`getByTestId(${JSON.stringify(button.testId)})`);
-    if (button.text && !selector.includes(button.text)) selectorAlt.push(`getByText(${JSON.stringify(button.text)})`);
-    if (button.cssPath) selectorAlt.push(`locator(${JSON.stringify(button.cssPath)})`);
-    elements.push({
-      category: "button",
-      role: "button",
-      name: displayName,
-      selector,
-      selectorAlt,
-      purpose: button.disabled ? `Disabled button - "${displayName}"` : button.type === "submit" ? `Form submit button - "${displayName}"` : `Button - "${displayName}"`,
-      confidence: button.testId || button.text ? "high" : button.id ? "medium" : "low",
-      attributes: {
-        text: button.text,
-        testId: button.testId,
-        id: button.id,
-        type: button.type,
-        disabled: button.disabled,
-        tag: button.tag
-      }
-    });
-  }
-  for (const link of domData.links) {
-    elements.push({
-      category: "link",
-      role: "link",
-      name: link.text,
-      selector: link.selector,
-      selectorAlt: link.testId ? [`getByTestId(${JSON.stringify(link.testId)})`] : [],
-      purpose: link.external ? `External link to "${link.href}" - "${link.text}"` : `Internal navigation link - "${link.text}" -> ${link.href}`,
-      confidence: link.testId ? "high" : "medium",
-      attributes: {
-        text: link.text,
-        href: link.href,
-        testId: link.testId,
-        external: link.external
-      }
-    });
-  }
-  for (const heading of domData.headings) {
-    elements.push({
-      category: "heading",
-      role: "heading",
-      name: heading.text,
-      selector: heading.selector,
-      selectorAlt: [`getByText(${JSON.stringify(heading.text)})`],
-      purpose: `Page ${heading.level} heading - use to assert the correct page or section loaded`,
-      confidence: "medium",
-      attributes: {
-        level: heading.level,
-        text: heading.text
-      }
-    });
-  }
-  for (const status of domData.statusRegions) {
-    elements.push({
-      category: "status",
-      role: status.role,
-      name: status.text || status.role,
-      selector: status.selector,
-      selectorAlt: [],
-      purpose: "Live region - use to assert error messages, success toasts, and validation feedback",
-      confidence: "medium",
-      attributes: {
-        role: status.role,
-        ariaLive: status.ariaLive,
-        currentText: status.text
-      }
-    });
-  }
-  return elements;
-}
-function buildWarnings(elements, domData, a11ySnapshot) {
-  const warnings = [];
-  if (!a11ySnapshot) {
-    warnings.push("Playwright accessibility snapshot was unavailable. Capture continued using DOM extraction only.");
-  }
-  const lowConfidenceInputs = elements.filter((element) => element.category === "input" && element.confidence === "low");
-  if (lowConfidenceInputs.length > 0) {
-    warnings.push(
-      `${lowConfidenceInputs.length} input(s) have low-confidence selectors. Consider adding data-testid attributes to: ${lowConfidenceInputs.map((element) => element.name).filter(Boolean).join(", ")}`
-    );
-  }
-  if (domData.statusRegions.length === 0) {
-    warnings.push("No ARIA alert or status regions detected. Error message assertions may need manual selector adjustments after generation.");
-  }
-  for (const form of domData.forms) {
-    const hasSubmit = domData.buttons.some((button) => button.type === "submit");
-    if (form.fieldCount > 0 && !hasSubmit) {
-      warnings.push(
-        `Form ${form.id || `#${form.index}`} has ${form.fieldCount} field(s) but no detected submit button. It may use keyboard submit or a custom handler.`
-      );
-    }
-  }
-  if (domData.links.length >= MAX_PER_CATEGORY) {
-    warnings.push(`Link count hit the ${MAX_PER_CATEGORY} capture limit. Generation will focus on forms and buttons.`);
-  }
-  const interactive = elements.filter((element) => element.category === "button" || element.category === "input" || element.category === "link");
-  if (interactive.length === 0) {
-    warnings.push("No interactive elements detected. The page may require authentication, render later than the current settle window, or be mostly static content.");
-  }
-  return warnings;
-}
-function log2(verbose, message) {
-  if (verbose) console.log(message);
-}
-async function getAccessibilitySnapshot(page, verbose) {
-  if (!page.accessibility || typeof page.accessibility.snapshot !== "function") {
-    log2(verbose, "  -> Accessibility snapshot API unavailable; continuing with DOM-only capture");
-    return null;
-  }
-  try {
-    return await page.accessibility.snapshot({ interestingOnly: false });
-  } catch (error) {
-    log2(verbose, `  -> Accessibility snapshot failed (${error?.message ?? error}); continuing with DOM-only capture`);
-    return null;
-  }
-}
-function asString(value) {
-  return typeof value === "string" ? value : void 0;
-}
-function formatCaptureFailure(error) {
-  const resolved = classifyCaptureError(error);
-  if (resolved.code === "PLAYWRIGHT_NOT_FOUND") {
-    return [
-      "Playwright not resolvable.",
-      "Playwright runtime not found in this project.",
-      "Try:",
-      "  npm install",
-      "  npx playwright install chromium"
-    ];
-  }
-  if (resolved.code === "BROWSER_NOT_INSTALLED") {
-    return [
-      "Browser not installed.",
-      "Playwright resolved, but Chromium is not installed for this project.",
-      "Try:",
-      "  npx playwright install chromium"
-    ];
-  }
-  if (resolved.code === "PAGE_LOAD_FAILED") {
-    return [
-      "Page load failed.",
-      resolved.message
-    ];
-  }
-  return [
-    "Capture failed.",
-    resolved.message
-  ];
-}
-function classifyCaptureError(error) {
-  if (error instanceof CaptureRuntimeError) {
-    return error;
-  }
-  const message = errorMessage(error);
-  if (isBrowserInstallError(message)) {
-    return new CaptureRuntimeError(
-      "BROWSER_NOT_INSTALLED",
-      "Playwright resolved, but Chromium is not installed for this project.",
-      { cause: error }
-    );
-  }
-  if (isPlaywrightNotFoundError(message)) {
-    return new CaptureRuntimeError(
-      "PLAYWRIGHT_NOT_FOUND",
-      "Playwright runtime not found in this project.",
-      { cause: error }
-    );
-  }
-  return new CaptureRuntimeError("CAPTURE_FAILED", message || "Unknown capture failure.", { cause: error });
-}
-function isBrowserInstallError(message) {
-  return /Executable doesn't exist|browserType\.launch: Executable doesn't exist|Please run the following command|playwright install/i.test(message);
-}
-function isPlaywrightNotFoundError(message) {
-  return /Playwright runtime not found|Cannot find package ['"](?:@playwright\/test|playwright-core)['"]/i.test(message);
-}
-function errorMessage(error) {
-  if (error instanceof Error) return error.message;
-  return String(error ?? "");
-}
-
 // src/core/report.ts
 import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join4 } from "path";
+import { join as join3 } from "path";
 function printCaptureReport(elementMap, analysis) {
   console.log("");
   console.log("=".repeat(60));
@@ -3111,10 +2593,10 @@ function printCaptureReport(elementMap, analysis) {
 function saveCaptureJson(elementMap, analysis, outputDir = ".cementic/capture") {
   mkdirSync3(outputDir, { recursive: true });
   const fileName = `capture-${slugify(elementMap.url)}-${Date.now()}.json`;
-  const filePath = join4(outputDir, fileName);
+  const filePath = join3(outputDir, fileName);
   writeFileSync3(filePath, JSON.stringify({
     _meta: {
-      version: "0.2.7",
+      version: "0.2.16",
       generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
       tool: "@cementic/cementic-test"
     },
@@ -3153,7 +2635,7 @@ function buildCasesMarkdown(analysis) {
 function saveCasesMarkdown(analysis, outputDir = "cases", fileName) {
   mkdirSync3(outputDir, { recursive: true });
   const resolvedFileName = fileName ?? `${slugify(analysis.feature || analysis.url)}.md`;
-  const filePath = join4(outputDir, resolvedFileName);
+  const filePath = join3(outputDir, resolvedFileName);
   writeFileSync3(filePath, buildCasesMarkdown(analysis));
   return filePath;
 }
@@ -3161,7 +2643,7 @@ function saveSpecPreview(analysis, outputDir = "tests/preview") {
   if (analysis.scenarios.length === 0) return null;
   mkdirSync3(outputDir, { recursive: true });
   const fileName = `spec-preview-${slugify(analysis.url)}-${Date.now()}.spec.cjs`;
-  const filePath = join4(outputDir, fileName);
+  const filePath = join3(outputDir, fileName);
   const lines = [];
   lines.push("/**");
   lines.push(" * CementicTest Capture Preview");
@@ -3294,7 +2776,7 @@ async function runTcInteractive(params) {
   });
   mkdirSync4("cases", { recursive: true });
   const fileName = `${prefix.toLowerCase()}-${slugify2(feature)}.md`;
-  const fullPath = join5("cases", fileName);
+  const fullPath = join4("cases", fileName);
   let markdown;
   let pageSummary = void 0;
   if (params.useAi) {
@@ -3448,15 +2930,15 @@ function reportCmd() {
 // src/commands/serve.ts
 import { Command as Command6 } from "commander";
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync3 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { join as join5 } from "path";
 function serveCmd() {
   const cmd = new Command6("serve").description("Serve the Allure report").action(() => {
     console.log("\u{1F4CA} Serving Allure report...");
-    const localAllureBin = join6(process.cwd(), "node_modules", "allure-commandline", "bin", "allure");
+    const localAllureBin = join5(process.cwd(), "node_modules", "allure-commandline", "bin", "allure");
     let executable = "npx";
     let args = ["allure", "serve", "./allure-results"];
-    if (existsSync3(localAllureBin)) {
+    if (existsSync2(localAllureBin)) {
       executable = "node";
       args = [localAllureBin, "serve", "./allure-results"];
     }
@@ -3479,9 +2961,9 @@ function serveCmd() {
 // src/commands/flow.ts
 import { Command as Command7 } from "commander";
 import { spawn as spawn4 } from "child_process";
-import { resolve as resolve4 } from "path";
+import { resolve as resolve3 } from "path";
 function runStep(cmd, args, stepName) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve4, reject) => {
     console.log(`
 \u{1F30A} Flow Step: ${stepName}`);
     console.log(`> ${cmd} ${args.join(" ")}`);
@@ -3491,7 +2973,7 @@ function runStep(cmd, args, stepName) {
     });
     child.on("exit", (code) => {
       if (code === 0) {
-        resolve5();
+        resolve4();
       } else {
         reject(new Error(`${stepName} failed with exit code ${code}`));
       }
@@ -3500,7 +2982,7 @@ function runStep(cmd, args, stepName) {
 }
 function flowCmd() {
   const cmd = new Command7("flow").description("End-to-end flow: Normalize -> Generate -> Run Tests").argument("[casesDir]", "Directory containing test cases", "./cases").option("--lang <lang>", "Target language (ts|js)", "ts").option("--no-run", "Skip running tests").action(async (casesDir, opts) => {
-    const cliBin = resolve4(process.argv[1]);
+    const cliBin = resolve3(process.argv[1]);
     try {
       await runStep(process.execPath, [cliBin, "normalize", casesDir], "Normalize Cases");
       await runStep(process.execPath, [cliBin, "gen", "--lang", opts.lang], "Generate Tests");
@@ -3521,8 +3003,8 @@ function flowCmd() {
 
 // src/commands/ci.ts
 import { Command as Command8 } from "commander";
-import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync5, existsSync as existsSync4 } from "fs";
-import { join as join7 } from "path";
+import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync5, existsSync as existsSync3 } from "fs";
+import { join as join6 } from "path";
 var WORKFLOW_CONTENT = `name: Playwright Tests
 on:
   push:
@@ -3553,15 +3035,15 @@ jobs:
 `;
 function ciCmd() {
   const cmd = new Command8("ci").description("Generate GitHub Actions workflow for CI").action(() => {
-    const githubDir = join7(process.cwd(), ".github");
-    const workflowsDir = join7(githubDir, "workflows");
-    const workflowFile = join7(workflowsDir, "cementic.yml");
+    const githubDir = join6(process.cwd(), ".github");
+    const workflowsDir = join6(githubDir, "workflows");
+    const workflowFile = join6(workflowsDir, "cementic.yml");
     console.log("\u{1F916} Setting up CI/CD workflow...");
-    if (!existsSync4(workflowsDir)) {
+    if (!existsSync3(workflowsDir)) {
       mkdirSync5(workflowsDir, { recursive: true });
       console.log(`Created directory: ${workflowsDir}`);
     }
-    if (existsSync4(workflowFile)) {
+    if (existsSync3(workflowFile)) {
       console.warn(`\u26A0\uFE0F  Workflow file already exists at ${workflowFile}. Skipping.`);
       return;
     }
@@ -3575,8 +3057,8 @@ function ciCmd() {
 }
 
 // src/cli.ts
-var require3 = createRequire2(import.meta.url);
-var { version } = require3("../package.json");
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
 var program = new Command9();
 program.name("ct").description("CementicTest CLI: cases \u2192 normalized \u2192 POM tests \u2192 Playwright").version(version);
 program.addCommand(newCmd());