browser-debugger-cli 0.6.11 → 0.7.1

package/dist/commands/dom/form.js

@@ -0,0 +1,441 @@
+/**
+ * Form discovery command for semantic form inspection.
+ *
+ * Discovers forms on the page with semantic labels, current values,
+ * validation state, and suggested commands for agent consumption.
+ */
+import { FORM_DISCOVERY_SCRIPT, isRawFormData } from '../../commands/dom/formDiscovery.js';
+import { runCommand } from '../../commands/shared/CommandRunner.js';
+import { jsonOption } from '../../commands/shared/commonOptions.js';
+import { QueryCacheManager } from '../../session/QueryCacheManager.js';
+import { CommandError } from '../../ui/errors/index.js';
+import { formatFormDiscovery } from '../../ui/formatters/form.js';
+import { createLogger } from '../../ui/logging/index.js';
+import { noFormsFoundError, formInIframeError } from '../../ui/messages/errors.js';
+import { EXIT_CODES } from '../../utils/exitCodes.js';
+const log = createLogger('dom');
+/**
+ * Execute form discovery in page context.
+ *
+ * @param cdp - CDP connection
+ * @returns Raw form data from page
+ */
+async function executeFormDiscovery(cdp) {
+    const response = await cdp.send('Runtime.evaluate', {
+        expression: FORM_DISCOVERY_SCRIPT,
+        returnByValue: true,
+    });
+    const cdpResponse = response;
+    if (cdpResponse.exceptionDetails) {
+        throw new CommandError(`Form discovery failed: ${cdpResponse.exceptionDetails.text}`, { suggestion: 'Check if page has loaded completely' }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+    const rawData = cdpResponse.result?.value;
+    if (!isRawFormData(rawData)) {
+        throw new CommandError('Unexpected form discovery response', { suggestion: 'This may be a bug - please report it' }, EXIT_CODES.SOFTWARE_ERROR);
+    }
+    return rawData;
+}
+/**
+ * Build validation state from raw field data.
+ *
+ * @param raw - Raw field data
+ * @returns Structured validation state
+ */
+function buildValidation(raw) {
+    const hasNativeError = !raw.isValid && raw.validationMessage;
+    const hasAriaError = raw.ariaInvalid;
+    const hasSiblingError = !!raw.siblingErrorText;
+    const hasClassError = raw.hasErrorClass;
+    if (hasNativeError) {
+        return {
+            valid: false,
+            message: raw.validationMessage,
+            source: 'native',
+            confidence: 'high',
+        };
+    }
+    if (hasAriaError) {
+        return {
+            valid: false,
+            message: raw.siblingErrorText ?? 'Field is invalid',
+            source: 'aria',
+            confidence: 'high',
+        };
+    }
+    if (hasSiblingError) {
+        return {
+            valid: false,
+            message: raw.siblingErrorText,
+            source: 'sibling',
+            confidence: 'medium',
+        };
+    }
+    if (hasClassError) {
+        return {
+            valid: false,
+            message: 'Field has error styling',
+            source: 'heuristic',
+            confidence: 'low',
+        };
+    }
+    return {
+        valid: true,
+        confidence: 'high',
+    };
+}
+/**
+ * Build field state from raw value.
+ *
+ * @param raw - Raw field data
+ * @returns Field state
+ */
+function buildFieldState(raw) {
+    const type = raw.type.toLowerCase();
+    if (type === 'checkbox' || type === 'radio' || type === 'switch') {
+        return raw.checked || raw.value === true ? 'checked' : 'unchecked';
+    }
+    if (Array.isArray(raw.value)) {
+        return raw.value.length > 0 ? 'filled' : 'empty';
+    }
+    if (typeof raw.value === 'string') {
+        return raw.value.length > 0 ? 'filled' : 'empty';
+    }
+    return 'empty';
+}
+/**
+ * Build masked value for password fields.
+ *
+ * @param raw - Raw field data
+ * @returns Masked value string
+ */
+function buildMaskedValue(raw) {
+    if (raw.inputType === 'password' && typeof raw.value === 'string' && raw.value.length > 0) {
+        return '•'.repeat(Math.min(raw.value.length, 8));
+    }
+    return undefined;
+}
+/**
+ * Build interaction warning for non-native fields.
+ *
+ * @param raw - Raw field data
+ * @returns Warning message or undefined
+ */
+function buildInteractionWarning(raw) {
+    if (raw.native) {
+        return undefined;
+    }
+    const type = raw.type.toLowerCase();
+    if (type === 'contenteditable') {
+        return 'Custom contenteditable - use click + type instead of fill';
+    }
+    if (type === 'combobox' || type === 'listbox') {
+        return 'Custom dropdown - click to open, then select option';
+    }
+    if (type === 'textbox') {
+        return 'Custom textbox - fill may not trigger framework events';
+    }
+    return 'Custom component - standard fill may not work';
+}
+/**
+ * Build fill command for a field.
+ *
+ * @param index - Global element index
+ * @param type - Field type
+ * @returns Command string
+ */
+function buildFieldCommand(index, type) {
+    const lowerType = type.toLowerCase();
+    if (lowerType === 'checkbox' || lowerType === 'radio' || lowerType === 'switch') {
+        return `bdg dom click ${index}`;
+    }
+    if (lowerType === 'file') {
+        return `bdg dom click ${index}`;
+    }
+    return `bdg dom fill ${index} "<value>"`;
+}
+/**
+ * Build selector-based command for a field.
+ *
+ * @param selector - CSS selector
+ * @param type - Field type
+ * @returns Command string
+ */
+function buildSelectorCommand(selector, type) {
+    const lowerType = type.toLowerCase();
+    // Escape backslashes first, then double quotes (CodeQL js/incomplete-string-escaping)
+    const escaped = selector.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    if (lowerType === 'checkbox' || lowerType === 'radio' || lowerType === 'switch') {
+        return `bdg dom click "${escaped}"`;
+    }
+    if (lowerType === 'file') {
+        return `bdg dom click "${escaped}"`;
+    }
+    return `bdg dom fill "${escaped}" "<value>"`;
+}
+/**
+ * Build alternative command for non-native fields.
+ *
+ * @param index - Global element index
+ * @param raw - Raw field data
+ * @returns Alternative command or undefined
+ */
+function buildAlternativeCommand(index, raw) {
+    if (raw.native) {
+        return undefined;
+    }
+    const type = raw.type.toLowerCase();
+    if (type === 'contenteditable' || type === 'textbox') {
+        return `bdg dom click ${index} && bdg dom pressKey ${index} "<value>"`;
+    }
+    return undefined;
+}
+/**
+ * Transform raw field to structured FormField.
+ *
+ * @param raw - Raw field data
+ * @returns Structured FormField
+ */
+function transformField(raw) {
+    return {
+        index: raw.index,
+        formIndex: raw.formIndex,
+        selector: raw.selector,
+        type: raw.type,
+        inputType: raw.inputType,
+        label: raw.label,
+        name: raw.name,
+        placeholder: raw.placeholder,
+        required: raw.required,
+        disabled: raw.disabled,
+        readOnly: raw.readOnly,
+        hidden: raw.hidden,
+        native: raw.native,
+        interactionWarning: buildInteractionWarning(raw),
+        state: buildFieldState(raw),
+        value: raw.value,
+        maskedValue: buildMaskedValue(raw),
+        validation: buildValidation(raw),
+        options: raw.options,
+        command: buildFieldCommand(raw.index, raw.type),
+        selectorCommand: buildSelectorCommand(raw.selector, raw.type),
+        alternativeCommand: buildAlternativeCommand(raw.index, raw),
+    };
+}
+/**
+ * Transform raw button to structured FormButton.
+ *
+ * @param raw - Raw button data
+ * @returns Structured FormButton
+ */
+function transformButton(raw) {
+    return {
+        index: raw.index,
+        selector: raw.selector,
+        label: raw.label,
+        type: raw.type,
+        primary: raw.isPrimary,
+        enabled: !raw.disabled,
+        disabledReason: raw.disabled ? 'Button is disabled' : undefined,
+        command: `bdg dom click ${raw.index}`,
+    };
+}
+/**
+ * Calculate form summary statistics.
+ *
+ * @param fields - Transformed form fields
+ * @param buttons - Transformed form buttons
+ * @returns Form summary
+ */
+function calculateSummary(fields, buttons) {
+    const visibleFields = fields.filter((f) => !f.hidden);
+    const requiredFields = visibleFields.filter((f) => f.required);
+    const filledFields = visibleFields.filter((f) => f.state === 'filled' || f.state === 'checked');
+    const validFields = visibleFields.filter((f) => f.validation.valid);
+    const invalidFields = visibleFields.filter((f) => !f.validation.valid);
+    const emptyRequired = requiredFields.filter((f) => f.state === 'empty' || f.state === 'unchecked');
+    const blockers = [];
+    for (const field of emptyRequired) {
+        blockers.push({
+            index: field.index,
+            label: field.label,
+            reason: 'Required field is empty',
+            command: field.command,
+        });
+    }
+    for (const field of invalidFields) {
+        if (!emptyRequired.includes(field)) {
+            blockers.push({
+                index: field.index,
+                label: field.label,
+                reason: field.validation.message ?? 'Validation failed',
+                command: field.command,
+            });
+        }
+    }
+    const submitButton = buttons.find((b) => b.type === 'submit' && b.primary);
+    if (submitButton && !submitButton.enabled) {
+        blockers.push({
+            index: submitButton.index,
+            label: submitButton.label,
+            reason: submitButton.disabledReason ?? 'Submit button is disabled',
+            command: submitButton.command,
+        });
+    }
+    return {
+        totalFields: visibleFields.length,
+        filledFields: filledFields.length,
+        emptyFields: visibleFields.length - filledFields.length,
+        validFields: validFields.length,
+        invalidFields: invalidFields.length,
+        requiredTotal: requiredFields.length,
+        requiredFilled: requiredFields.length - emptyRequired.length,
+        requiredRemaining: emptyRequired.length,
+        readyToSubmit: blockers.length === 0,
+        blockers,
+    };
+}
+/**
+ * Transform raw form to structured DiscoveredForm.
+ *
+ * @param raw - Raw form data
+ * @returns Structured DiscoveredForm
+ */
+function transformForm(raw) {
+    const fields = raw.fields.map(transformField);
+    const buttons = raw.buttons.map(transformButton);
+    return {
+        index: raw.index,
+        name: raw.name,
+        action: raw.action,
+        method: raw.method,
+        step: raw.step ?? undefined,
+        relevanceScore: raw.relevanceScore,
+        fields,
+        buttons,
+        summary: calculateSummary(fields, buttons),
+    };
+}
+/**
+ * Cache form elements for index-based access.
+ *
+ * @param forms - Discovered forms
+ */
+async function cacheFormElements(forms) {
+    const cacheManager = QueryCacheManager.getInstance();
+    const allElements = [];
+    for (const form of forms) {
+        for (const field of form.fields) {
+            allElements.push({
+                index: field.index,
+                nodeId: 0,
+                selector: field.selector,
+            });
+        }
+        for (const button of form.buttons) {
+            allElements.push({
+                index: button.index,
+                nodeId: 0,
+                selector: button.selector,
+            });
+        }
+    }
+    const navigationId = await cacheManager.getCurrentNavigationId();
+    await cacheManager.set({
+        selector: 'form:auto-discovered',
+        count: allElements.length,
+        nodes: allElements.map((el) => ({
+            index: el.index,
+            nodeId: el.nodeId,
+            tag: 'input',
+            preview: el.selector,
+        })),
+        ...(navigationId !== null && { navigationId }),
+    });
+    log.debug(`Cached ${allElements.length} form elements`);
+}
+/**
+ * Execute CDP connection lifecycle for form discovery.
+ *
+ * @param fn - Function to execute with CDP connection
+ * @returns Result from function
+ */
+async function withCDPConnection(fn) {
+    const { CDPConnection } = await import('../../connection/cdp.js');
+    const { validateActiveSession, getValidatedSessionMetadata, verifyTargetExists } = await import('../../commands/dom/evalHelpers.js');
+    validateActiveSession();
+    const metadata = getValidatedSessionMetadata();
+    if (!metadata.port) {
+        throw new CommandError('Session metadata missing port', { suggestion: 'Restart the session with: bdg stop && bdg <url>' }, EXIT_CODES.SESSION_FILE_ERROR);
+    }
+    await verifyTargetExists(metadata, metadata.port);
+    const cdp = new CDPConnection();
+    if (!metadata.webSocketDebuggerUrl) {
+        throw new CommandError('Session metadata missing webSocketDebuggerUrl', { suggestion: 'Start a new session with: bdg <url>' }, EXIT_CODES.SESSION_FILE_ERROR);
+    }
+    await cdp.connect(metadata.webSocketDebuggerUrl);
+    try {
+        return await fn(cdp);
+    }
+    finally {
+        cdp.close();
+    }
+}
+/**
+ * Handle form discovery command.
+ *
+ * @param options - Command options
+ */
+async function handleFormCommand(options) {
+    await runCommand(async () => {
+        return await withCDPConnection(async (cdp) => {
+            const rawData = await executeFormDiscovery(cdp);
+            if (rawData.forms.length === 0) {
+                const err = noFormsFoundError();
+                return {
+                    success: false,
+                    error: err.message,
+                    exitCode: EXIT_CODES.NO_FORMS_FOUND,
+                    errorContext: { suggestion: err.suggestion },
+                };
+            }
+            const iframeForm = rawData.forms.find((f) => f.inIframe);
+            if (iframeForm && rawData.forms.length === 1) {
+                const err = formInIframeError(iframeForm.iframeUrl ?? 'unknown', iframeForm.crossOrigin ?? false);
+                return {
+                    success: false,
+                    error: err.message,
+                    exitCode: EXIT_CODES.FORM_IN_IFRAME,
+                    errorContext: { suggestion: err.suggestion },
+                };
+            }
+            const allForms = rawData.forms.map(transformForm);
+            const forms = options.all ? allForms : [allForms[0]];
+            // Cache ALL forms so global indices work with bdg dom fill/click
+            await cacheFormElements(allForms);
+            const result = {
+                formCount: rawData.forms.length,
+                selectedForm: 0,
+                forms,
+                brief: options.brief,
+            };
+            return { success: true, data: result };
+        });
+    }, options, formatFormDiscovery);
+}
+/**
+ * Register form discovery command.
+ *
+ * @param domCommand - DOM command group
+ */
+export function registerFormCommand(domCommand) {
+    domCommand
+        .command('form')
+        .description('Discover forms with semantic labels, values, and validation state')
+        .option('--all', 'Show all forms expanded')
+        .option('--brief', 'Quick scan: field names, types, and required status only')
+        .addOption(jsonOption())
+        .action(async (options) => {
+        await handleFormCommand(options);
+    });
+}
+//# sourceMappingURL=form.js.map

package/dist/commands/dom/form.js.map

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

package/dist/commands/dom/formDiscovery.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Form discovery script executed in page context.
+ *
+ * Discovers forms, extracts semantic labels, detects state and validation,
+ * and returns structured data for agent consumption.
+ */
+import type { RawFormData } from '../../commands/dom/formTypes.js';
+/**
+ * Page-context script for form discovery.
+ *
+ * This script runs in the browser via Runtime.evaluate and discovers:
+ * - Native form elements and inputs
+ * - Custom components with ARIA roles
+ * - Labels via priority chain (label[for], aria-label, placeholder, etc.)
+ * - Current values and validation state
+ * - Form relevance scoring for multi-form pages
+ */
+export declare const FORM_DISCOVERY_SCRIPT = "\n(function() {\n  const result = { forms: [] };\n\n  function generateSelector(element) {\n    if (element.id) {\n      return '#' + CSS.escape(element.id);\n    }\n    if (element.name) {\n      const tag = element.tagName.toLowerCase();\n      return tag + '[name=\"' + CSS.escape(element.name) + '\"]';\n    }\n    const tag = element.tagName.toLowerCase();\n    const parent = element.parentElement;\n    if (!parent) return tag;\n    const siblings = Array.from(parent.children).filter(c => c.tagName === element.tagName);\n    if (siblings.length === 1) {\n      const parentSelector = generateSelector(parent);\n      return parentSelector + ' > ' + tag;\n    }\n    const index = siblings.indexOf(element);\n    const parentSelector = generateSelector(parent);\n    return parentSelector + ' > ' + tag + ':nth-of-type(' + (index + 1) + ')';\n  }\n\n  function cleanLabelText(text) {\n    if (!text) return text;\n    const patterns = [\n      /Previous\\s*arrow/gi,\n      /Next\\s*arrow/gi,\n      /\\barrow\\b/gi,\n      /\\bchevron\\b/gi,\n      /\u2190|\u2192|\u2191|\u2193|\u25B2|\u25BC|\u25C0|\u25B6/g,\n      /\\u25C0|\\u25B6|\\u25B2|\\u25BC/g,\n      /Previous|Next|Back|Forward/gi,\n      /^\\s*[<>]\\s*/,\n      /\\s*[<>]\\s*$/,\n    ];\n    let cleaned = text;\n    for (const pattern of patterns) {\n      cleaned = cleaned.replace(pattern, '');\n    }\n    cleaned = cleaned.replace(/\\s{2,}/g, ' ').trim();\n    return cleaned || text.trim();\n  }\n\n  function extractLabel(element) {\n    if (element.id) {\n      const labelFor = document.querySelector('label[for=\"' + CSS.escape(element.id) + '\"]');\n      if (labelFor) return cleanLabelText(labelFor.textContent);\n    }\n    const ariaLabel = element.getAttribute('aria-label');\n    if (ariaLabel) return cleanLabelText(ariaLabel);\n    const ariaLabelledBy = element.getAttribute('aria-labelledby');\n    if (ariaLabelledBy) {\n      const labelEl = document.getElementById(ariaLabelledBy);\n      if (labelEl) return cleanLabelText(labelEl.textContent);\n    }\n    const wrappingLabel = element.closest('label');\n    if (wrappingLabel) {\n      const clone = wrappingLabel.cloneNode(true);\n      const inputs = clone.querySelectorAll('input, select, textarea, button');\n      inputs.forEach(i => i.remove());\n      const text = clone.textContent.trim();\n      if (text) return cleanLabelText(text);\n    }\n    if (element.placeholder) return cleanLabelText(element.placeholder);\n    const title = element.getAttribute('title');\n    if (title) return cleanLabelText(title);\n    if (element.name) {\n      return element.name\n        .replace(/[_-]/g, ' ')\n        .replace(/([a-z])([A-Z])/g, '$1 $2')\n        .replace(/^./, s => s.toUpperCase());\n    }\n    return 'Unlabeled field';\n  }\n\n  function extractButtonLabel(element) {\n    const ariaLabel = element.getAttribute('aria-label');\n    if (ariaLabel) return ariaLabel.trim();\n    if (element.value && element.type !== 'submit') return element.value;\n    const text = element.textContent.trim();\n    if (text) return text;\n    if (element.value) return element.value;\n    const title = element.getAttribute('title');\n    if (title) return title;\n    return 'Button';\n  }\n\n  function getFieldValue(element) {\n    const tag = element.tagName.toLowerCase();\n    const type = element.type?.toLowerCase() || 'text';\n    if (tag === 'select') {\n      if (element.multiple) {\n        return Array.from(element.selectedOptions).map(o => o.value);\n      }\n      return element.value;\n    }\n    if (type === 'checkbox' || type === 'radio') {\n      return element.checked;\n    }\n    if (element.getAttribute('role') === 'checkbox' || element.getAttribute('role') === 'switch') {\n      return element.getAttribute('aria-checked') === 'true';\n    }\n    if (element.isContentEditable) {\n      return element.textContent || '';\n    }\n    return element.value || '';\n  }\n\n  function getFieldState(element, value) {\n    const type = element.type?.toLowerCase() || 'text';\n    if (type === 'checkbox' || element.getAttribute('role') === 'checkbox' || element.getAttribute('role') === 'switch') {\n      return value ? 'checked' : 'unchecked';\n    }\n    if (type === 'radio') {\n      return value ? 'checked' : 'unchecked';\n    }\n    if (Array.isArray(value)) {\n      return value.length > 0 ? 'filled' : 'empty';\n    }\n    if (typeof value === 'string') {\n      return value.length > 0 ? 'filled' : 'empty';\n    }\n    return 'empty';\n  }\n\n  function getFieldType(element) {\n    const tag = element.tagName.toLowerCase();\n    const role = element.getAttribute('role');\n    if (role === 'textbox') return 'textbox';\n    if (role === 'checkbox') return 'checkbox';\n    if (role === 'radio') return 'radio';\n    if (role === 'combobox') return 'combobox';\n    if (role === 'listbox') return 'listbox';\n    if (role === 'switch') return 'switch';\n    if (element.isContentEditable) return 'contenteditable';\n    if (tag === 'textarea') return 'textarea';\n    if (tag === 'select') return 'select';\n    if (tag === 'input') {\n      const type = element.type?.toLowerCase() || 'text';\n      return type;\n    }\n    return 'unknown';\n  }\n\n  function isNativeInput(element) {\n    const tag = element.tagName.toLowerCase();\n    return tag === 'input' || tag === 'textarea' || tag === 'select';\n  }\n\n  function getSelectOptions(element) {\n    if (element.tagName.toLowerCase() !== 'select') return undefined;\n    return Array.from(element.options).map(opt => ({\n      value: opt.value,\n      label: opt.textContent.trim(),\n      selected: opt.selected\n    }));\n  }\n\n  function findSiblingError(element) {\n    const next = element.nextElementSibling;\n    if (next) {\n      const isError = next.classList.contains('error') ||\n                      next.classList.contains('invalid') ||\n                      next.classList.contains('field-error') ||\n                      next.classList.contains('error-message') ||\n                      next.getAttribute('role') === 'alert';\n      if (isError) return next.textContent.trim();\n    }\n    const parent = element.parentElement;\n    if (parent) {\n      const errorEl = parent.querySelector('.error-message, .field-error, [role=\"alert\"]');\n      if (errorEl && errorEl !== element) return errorEl.textContent.trim();\n    }\n    return undefined;\n  }\n\n  function calculateRelevance(formEl, fields, buttons) {\n    let score = 0;\n    const rect = formEl.getBoundingClientRect();\n    const viewportHeight = window.innerHeight;\n    const viewportWidth = window.innerWidth;\n    const centerX = rect.left + rect.width / 2;\n    const centerY = rect.top + rect.height / 2;\n    if (centerX > viewportWidth * 0.2 && centerX < viewportWidth * 0.8) score += 10;\n    if (centerY > 0 && centerY < viewportHeight) score += 5;\n    const isInMain = formEl.closest('main, [role=\"main\"], article, .main-content, #main');\n    if (isInMain) score += 15;\n    const isInHeader = formEl.closest('header, [role=\"banner\"], nav, [role=\"navigation\"]');\n    if (isInHeader) score -= 10;\n    const isInAside = formEl.closest('aside, [role=\"complementary\"], footer, [role=\"contentinfo\"]');\n    if (isInAside) score -= 5;\n    score += Math.min(fields.length * 3, 30);\n    const hasSubmit = buttons.some(b => b.type === 'submit' || b.isPrimary);\n    if (hasSubmit) score += 10;\n    const style = window.getComputedStyle(formEl);\n    if (style.display === 'none' || style.visibility === 'hidden') score -= 100;\n    return score;\n  }\n\n  function detectFormStep(formEl) {\n    const stepIndicators = formEl.querySelectorAll('[aria-current=\"step\"], .step.active, .wizard-step.current');\n    if (stepIndicators.length === 0) {\n      const pageSteps = document.querySelectorAll('.step, .wizard-step, [role=\"tablist\"] [role=\"tab\"]');\n      if (pageSteps.length > 1) {\n        const activeIndex = Array.from(pageSteps).findIndex(s =>\n          s.classList.contains('active') ||\n          s.classList.contains('current') ||\n          s.getAttribute('aria-selected') === 'true'\n        );\n        if (activeIndex >= 0) {\n          return { current: activeIndex + 1, total: pageSteps.length };\n        }\n      }\n    }\n    const ariaStep = formEl.querySelector('[aria-current=\"step\"]');\n    if (ariaStep) {\n      const allSteps = formEl.querySelectorAll('[role=\"listitem\"], .step');\n      const currentIdx = Array.from(allSteps).indexOf(ariaStep);\n      if (currentIdx >= 0) {\n        return { current: currentIdx + 1, total: allSteps.length };\n      }\n    }\n    return null;\n  }\n\n  function findNearbyHeading(formEl) {\n    let sibling = formEl.previousElementSibling;\n    let distance = 0;\n    while (sibling && distance < 3) {\n      if (sibling.matches('h1, h2, h3, h4, h5, h6, [role=\"heading\"]')) {\n        return sibling.textContent.trim();\n      }\n      const heading = sibling.querySelector('h1, h2, h3, h4, h5, h6, [role=\"heading\"]');\n      if (heading) return heading.textContent.trim();\n      sibling = sibling.previousElementSibling;\n      distance++;\n    }\n    const parent = formEl.parentElement;\n    if (parent) {\n      const heading = parent.querySelector(':scope > h1, :scope > h2, :scope > h3');\n      if (heading && heading.compareDocumentPosition(formEl) & Node.DOCUMENT_POSITION_FOLLOWING) {\n        return heading.textContent.trim();\n      }\n    }\n    return null;\n  }\n\n  function matchesWord(text, word) {\n    const pattern = new RegExp('\\\\b' + word + '\\\\b', 'i');\n    return pattern.test(text);\n  }\n\n  function inferFormType(formEl) {\n    const inputs = formEl.querySelectorAll('input, textarea, select');\n    const types = Array.from(inputs).map(i => i.type?.toLowerCase() || i.tagName.toLowerCase());\n    const names = Array.from(inputs).map(i => (i.name || '').toLowerCase());\n    const allText = (Array.from(inputs).map(i => i.name + ' ' + i.placeholder + ' ' + i.id).join(' ')).toLowerCase();\n    if (types.includes('password')) {\n      if (types.filter(t => t === 'password').length >= 2) return 'Change Password';\n      if (matchesWord(allText, 'register') || matchesWord(allText, 'signup') || matchesWord(allText, 'create')) return 'Registration';\n      return 'Login';\n    }\n    const hasSearchRole = formEl.closest('[role=\"search\"]') || formEl.getAttribute('role') === 'search';\n    const hasSearchInput = formEl.querySelector('[type=\"search\"], [aria-label*=\"search\" i]');\n    if (hasSearchRole || hasSearchInput) return 'Search';\n    const interactiveTypes = types.filter(t => !['hidden', 'submit', 'button', 'reset', 'image'].includes(t));\n    if (interactiveTypes.length <= 2 && matchesWord(allText, 'search')) return 'Search';\n    if (matchesWord(allText, 'address') || matchesWord(allText, 'street') || matchesWord(allText, 'postcode') ||\n        matchesWord(allText, 'zipcode') || matchesWord(allText, 'city') || matchesWord(allText, 'county')) {\n      return 'Address';\n    }\n    if (matchesWord(allText, 'email') && (matchesWord(allText, 'message') || matchesWord(allText, 'subject'))) {\n      return 'Contact';\n    }\n    if (matchesWord(allText, 'card') || matchesWord(allText, 'cvv') || matchesWord(allText, 'expiry')) {\n      return 'Payment';\n    }\n    if (names.some(n => matchesWord(n, 'subscribe') || matchesWord(n, 'newsletter'))) {\n      return 'Newsletter';\n    }\n    return null;\n  }\n\n  function extractFormName(formEl) {\n    const ariaLabel = formEl.getAttribute('aria-label');\n    if (ariaLabel) return ariaLabel;\n    const ariaLabelledBy = formEl.getAttribute('aria-labelledby');\n    if (ariaLabelledBy) {\n      const labelEl = document.getElementById(ariaLabelledBy);\n      if (labelEl) return labelEl.textContent.trim();\n    }\n    const headings = formEl.querySelectorAll('h1, h2, h3, h4, h5, h6, [role=\"heading\"]');\n    for (const h of headings) {\n      if (!h.closest('[role=\"dialog\"], [role=\"alertdialog\"], [aria-modal=\"true\"]')) {\n        return h.textContent.trim();\n      }\n    }\n    const legend = formEl.querySelector('legend');\n    if (legend) return legend.textContent.trim();\n    const title = formEl.getAttribute('title');\n    if (title) return title;\n    const name = formEl.getAttribute('name');\n    if (name) {\n      return name\n        .replace(/[_-]/g, ' ')\n        .replace(/([a-z])([A-Z])/g, '$1 $2')\n        .replace(/^./, s => s.toUpperCase());\n    }\n    const nearbyHeading = findNearbyHeading(formEl);\n    if (nearbyHeading) return nearbyHeading;\n    const inferredType = inferFormType(formEl);\n    if (inferredType) return inferredType;\n    return null;\n  }\n\n  function discoverFields(container, formIndex, startIndex) {\n    const fields = [];\n    const nativeInputs = container.querySelectorAll(\n      'input:not([type=\"hidden\"]):not([type=\"submit\"]):not([type=\"button\"]):not([type=\"reset\"]):not([type=\"image\"]), ' +\n      'textarea, ' +\n      'select'\n    );\n    const customInputs = container.querySelectorAll(\n      '[role=\"textbox\"], ' +\n      '[role=\"checkbox\"]:not(input), ' +\n      '[role=\"radio\"]:not(input), ' +\n      '[role=\"combobox\"], ' +\n      '[role=\"listbox\"], ' +\n      '[role=\"switch\"], ' +\n      '[contenteditable=\"true\"]'\n    );\n    const allInputs = new Set([...nativeInputs, ...customInputs]);\n    let idx = startIndex;\n    for (const el of allInputs) {\n      const style = window.getComputedStyle(el);\n      const isHidden = style.display === 'none' || style.visibility === 'hidden' || el.type === 'hidden';\n      const value = getFieldValue(el);\n      fields.push({\n        index: idx,\n        formIndex: formIndex,\n        selector: generateSelector(el),\n        type: getFieldType(el),\n        inputType: el.type?.toLowerCase(),\n        label: extractLabel(el),\n        name: el.name || null,\n        placeholder: el.placeholder || undefined,\n        required: el.required || el.getAttribute('aria-required') === 'true',\n        disabled: el.disabled || el.getAttribute('aria-disabled') === 'true',\n        readOnly: el.readOnly || false,\n        hidden: isHidden,\n        native: isNativeInput(el),\n        value: value,\n        checked: el.checked,\n        validationMessage: el.validationMessage || undefined,\n        isValid: el.checkValidity ? el.checkValidity() : true,\n        ariaInvalid: el.getAttribute('aria-invalid') === 'true',\n        hasErrorClass: el.classList.contains('error') || el.classList.contains('invalid'),\n        siblingErrorText: findSiblingError(el),\n        options: getSelectOptions(el)\n      });\n      idx++;\n    }\n    return fields;\n  }\n\n  function discoverButtons(container, startIndex) {\n    const buttons = [];\n    const buttonEls = container.querySelectorAll(\n      'button, ' +\n      'input[type=\"submit\"], ' +\n      'input[type=\"button\"], ' +\n      'input[type=\"reset\"], ' +\n      '[role=\"button\"]'\n    );\n    let idx = startIndex;\n    for (const el of buttonEls) {\n      const style = window.getComputedStyle(el);\n      if (style.display === 'none' || style.visibility === 'hidden') continue;\n      const type = el.type?.toLowerCase() || 'button';\n      const btnType = type === 'submit' ? 'submit' : type === 'reset' ? 'reset' : 'button';\n      const isPrimary = btnType === 'submit' ||\n                        el.classList.contains('primary') ||\n                        el.classList.contains('btn-primary') ||\n                        el.classList.contains('submit');\n      buttons.push({\n        index: idx,\n        selector: generateSelector(el),\n        label: extractButtonLabel(el),\n        type: btnType,\n        disabled: el.disabled || el.getAttribute('aria-disabled') === 'true',\n        isPrimary: isPrimary\n      });\n      idx++;\n    }\n    return buttons;\n  }\n\n  const forms = document.querySelectorAll('form');\n  let globalIndex = 0;\n\n  if (forms.length === 0) {\n    const bodyFields = discoverFields(document.body, 0, 0);\n    const bodyButtons = discoverButtons(document.body, bodyFields.length);\n    if (bodyFields.length > 0) {\n      result.forms.push({\n        index: 0,\n        name: document.title || 'Page',\n        action: null,\n        method: 'GET',\n        step: null,\n        relevanceScore: bodyFields.length * 3,\n        inIframe: false,\n        fields: bodyFields,\n        buttons: bodyButtons\n      });\n    }\n  } else {\n    for (let i = 0; i < forms.length; i++) {\n      const formEl = forms[i];\n      const fields = discoverFields(formEl, i, globalIndex);\n      globalIndex += fields.length;\n      const buttons = discoverButtons(formEl, globalIndex);\n      globalIndex += buttons.length;\n      const inIframe = formEl.ownerDocument !== document;\n      result.forms.push({\n        index: i,\n        name: extractFormName(formEl),\n        action: formEl.action || null,\n        method: (formEl.method || 'GET').toUpperCase(),\n        step: detectFormStep(formEl),\n        relevanceScore: calculateRelevance(formEl, fields, buttons),\n        inIframe: inIframe,\n        fields: fields,\n        buttons: buttons\n      });\n    }\n  }\n\n  result.forms.sort((a, b) => b.relevanceScore - a.relevanceScore);\n\n  return result;\n})()\n";
+/**
+ * Type guard for raw form data.
+ *
+ * @param value - Unknown value to check
+ * @returns True if value matches RawFormData structure
+ */
+export declare function isRawFormData(value: unknown): value is RawFormData;
+//# sourceMappingURL=formDiscovery.d.ts.map

package/dist/commands/dom/formDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formDiscovery.d.ts","sourceRoot":"","sources":["../../../src/commands/dom/formDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,s9hBA6bjC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAMlE"}