@webability/core 1.7.0 → 1.9.0

package/dist/types-CbNyAKbT.d.cts

@@ -1,257 +0,0 @@
-/**
- * @webability/core — type definitions
- */
-/**
- * Minimal page interface satisfied by both Playwright and Puppeteer.
- * No runtime wrapper needed — both libraries implement these methods natively.
- */
-interface PageLike {
-    evaluate<R>(pageFunction: string | ((...args: any[]) => R | Promise<R>), ...args: any[]): Promise<R>;
-    addScriptTag(options: {
-        content: string;
-    }): Promise<unknown>;
-    url(): string;
-    /**
-     * Real keyboard event dispatch (Playwright & Puppeteer both expose this).
-     * Optional so minimal PageLike shims still typecheck. The focusVisible
-     * detector uses `keyboard.press('Tab')` to put the browser into keyboard
-     * interaction modality before probing focus styles — otherwise
-     * `:focus-visible` / keyboard-detection-class patterns (focus-visible
-     * polyfill, `.user-is-tabbing` body class) never activate under a bare
-     * programmatic `.focus()`, producing mass false positives.
-     */
-    keyboard?: {
-        press(key: string): Promise<void>;
-    };
-}
-/** All fix issue types the pipeline can detect and fix. */
-type FixIssueType = 'weak_button_name' | 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'weak_skip_link' | 'missing_button_role' | 'missing_semantic_role' | 'missing_landmark' | 'heading_skip' | 'svg_missing_name' | 'aria_hidden_focusable' | 'adjacent_redundant_link' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'target_too_small' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'decorative_icon' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'duplicate_id' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'broken_anchor' | 'placeholder_link' | 'missing_pattern_title' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'invalid_aria_role' | 'zoom_restriction' | 'missing_button_type' | 'link_consistency' | 'semantic_emphasis' | 'keyboard_trap' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'nested_landmark' | 'combobox_name_missing' | 'landmark_duplicate_unlabeled' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'missing_h1' | 'multiple_h1' | 'empty_heading' | 'javascript_link' | 'broken_aria_reference' | 'main_content_hidden' | 'scrollable_not_focusable' | 'meaningful_sequence' | 'sensory_characteristic' | 'orientation_lock' | 'image_of_text' | 'reflow_overflow' | 'missing_audio_description' | 'missing_transcript' | 'character_key_shortcut' | 'on_input_change' | 'pointer_gesture' | 'pointer_cancellation' | 'motion_actuation' | 'error_prevention_missing' | 'insufficient_navigation' | 'inconsistent_navigation';
-/** WCAG criterion for each issue type. */
-declare const WCAG_BY_ISSUE: Record<FixIssueType, string>;
-/** A single accessibility issue detected on the page. */
-interface DetectedIssue {
-    /** Unique CSS selector targeting the element. */
-    selector: string;
-    /** HTML/ARIA attribute to set (alt, aria-label, role, tabindex, etc.) */
-    attribute: string;
-    /** What the element currently has (empty string if missing). */
-    currentValue: string;
-    /** Classification of the issue. */
-    issueType: FixIssueType;
-    /** WCAG success criterion reference. */
-    wcag: string;
-    /** Contextual info for Claude: nearby heading, parent tag, href, page section. */
-    context: string;
-    /** true = needs Claude to generate the fix value; false = rule already knows it. */
-    needsAI: boolean;
-    /** When needsAI is false, this is the known fix value. */
-    fixValue?: string;
-    /** Optional: image src for alt text generation via vision. */
-    imageSrc?: string;
-    /** Optional: outer HTML snippet (first 300 chars) for Claude context. */
-    outerHtml?: string;
-    /**
-     * Detector-side signal that the VERDICT is uncertain (e.g. contrast against
-     * a gradient). The scanner never reports such a finding: it is resolved to a
-     * verdict by an engine resolver or dropped. For "verdict certain, fix not
-     * mechanical" use `manualFix`.
-     */
-    needsReview?: boolean;
-    /**
-     * The verdict is certain but the suggested fix cannot be applied
-     * mechanically. Sets `fix.needsManualReview`; never changes the verdict.
-     */
-    manualFix?: boolean;
-    /** Why this finding needs review — surfaced to MCP/SDK consumers. */
-    reviewReason?: string;
-    /**
-     * Optional exact user-facing message. Use when the generic
-     * attribute/currentValue template ("missing X", "X is \"Y\"") would state
-     * something false or fabricated — e.g. a weak button name whose name comes
-     * from text content has no missing aria-label to report (persona round 3,
-     * P069: 'weak button name: missing aria-label' on a named control).
-     * formatMessage prefers this verbatim when present.
-     */
-    message?: string;
-}
-/** Every fix detector must implement this interface. */
-interface FixDetector {
-    name: string;
-    detect(page: PageLike): Promise<DetectedIssue[]>;
-    /** Per-page emission cap, when the detector has one. When a run returns
-     *  >= cap findings the results are TRUNCATED (DOM-order biased) and the
-     *  scan reports it via ScanResult.truncated — silent truncation reads as
-     *  "covered everything" when it didn't (loop iter8 / honesty infra). */
-    cap?: number;
-}
-/**
- * Browser-runtime detector signature.
- *
- * Each detector exports a pure, zero-argument browser function that uses the
- * `document` global directly and returns DetectedIssue[]. No Puppeteer, no
- * Node imports, no closures over module-scope variables — so it both:
- *   1. Survives serialization via `page.evaluate(fn)` on the server (puppeteer
- *      stringifies and re-parses the function inside the browser context).
- *   2. Bundles directly into the widget via webpack and runs against the
- *      live customer DOM.
- *
- * Single source of truth — same rules run in both runtimes.
- */
-type BrowserDetector = () => DetectedIssue[];
-interface SiteTheme {
-    cssVars: Record<string, string>;
-    topBgColors: Array<{
-        color: string;
-        count: number;
-    }>;
-    topTextColors: Array<{
-        color: string;
-        count: number;
-    }>;
-}
-type IssueSource = 'webability' | 'axe-core' | 'deep-analysis';
-type IssueImpact = 'critical' | 'serious' | 'moderate' | 'minor';
-type WcagLevel = 'A' | 'AA' | 'AAA';
-/**
- * Confidence tier for a scan finding. Mirrors axe-core's three-tier output —
- * `high` is a confirmed violation safe to act on; `needs_review` is ambiguous
- * (e.g. text on a gradient background, mid-animation opacity, marketing imagery
- * that may legitimately contain text). Consumers should never auto-apply fixes
- * to `needs_review` findings — they belong in the `incomplete[]` bucket and
- * require human judgment.
- */
-type IssueConfidence = 'high' | 'needs_review';
-interface ScanIssue {
-    id: string;
-    source: IssueSource;
-    type: FixIssueType | string;
-    wcag: string;
-    level: WcagLevel;
-    impact: IssueImpact;
-    message: string;
-    selector: string;
-    html?: string;
-    /** When set, this issue is ambiguous and lives in `ScanResult.incomplete[]`. */
-    confidence?: IssueConfidence;
-    /** Why the classifier demoted this issue. Surfaced to MCP/SDK consumers. */
-    reviewReason?: string;
-    fix?: {
-        attribute: string;
-        currentValue: string;
-        suggestedValue?: string;
-        needsManualReview: boolean;
-    };
-}
-/**
- * Signal that the scan never reached the intended page — the target served a
- * bot-challenge / interstitial (Cloudflare "Just a moment…", "Access Denied",
- * a CAPTCHA wall) or the main document returned an HTTP error status. When
- * present, `issues`/`incomplete` are empty and MUST NOT be read as "the page is
- * clean": nothing real was scanned. Lets a caller distinguish "scanned and
- * clean" from "was never actually scanned".
- */
-interface BlockedInfo {
-    /** Human-readable explanation of why the page could not be scanned. */
-    reason: string;
-    /** Challenge vendor when identifiable (e.g. 'Cloudflare', 'PerimeterX/HUMAN'). */
-    vendor?: string;
-    /** HTTP status of the main document response, when known. */
-    status?: number;
-    /** The specific signal that matched (page title, marker selector, or status). */
-    signal?: string;
-}
-interface ScanResult {
-    url: string;
-    timestamp: string;
-    /**
-     * Set when the target served a bot-challenge/interstitial or an HTTP error
-     * instead of the real page. When present, treat `issues`/`incomplete` as
-     * "not scanned" (they are empty), NOT as "no problems found".
-     */
-    blocked?: BlockedInfo;
-    /** High-confidence violations. Safe to surface as bugs. */
-    issues: ScanIssue[];
-    /** Detectors that hit their per-page cap this run — their counts are lower
-     *  bounds, not a census. Additive field; absent = nothing truncated. */
-    truncated?: Array<{
-        detector: string;
-        cap: number;
-    }>;
-    /**
-     * Non-fatal engine subsystem failures that silently disable a category of
-     * checks. Consumers MUST surface these to the user — a result with
-     * `engineWarnings` is NOT a full scan. Currently: `'color:kernel-injection-failed'`
-     * disables all contrast checks for the page. Absent = all subsystems healthy.
-     */
-    engineWarnings?: string[];
-    /** Engine (core package) version that produced this result — provenance */
-    engine?: string;
-    /**
-     * @deprecated Always `[]`. The scanner judges uncertain findings itself:
-     * each becomes a verdict in `issues` or is dropped. The field stays only so
-     * existing consumers that read it keep compiling.
-     */
-    incomplete: ScanIssue[];
-    summary: {
-        total: number;
-        critical: number;
-        serious: number;
-        moderate: number;
-        minor: number;
-        /** @deprecated Always 0 — there is no incomplete bucket. */
-        incomplete: number;
-    };
-    axeResults?: unknown;
-}
-type ViewportPreset = 'mobile' | 'tablet' | 'desktop';
-declare const VIEWPORT_SIZES: Record<ViewportPreset, {
-    width: number;
-    height: number;
-}>;
-interface ScanOptions {
-    wcagTags?: string[];
-    /**
-     * Highest WCAG conformance level to report. Default 'AA': findings whose
-     * criteria are all Level AAA are not reported anywhere (issues, incomplete,
-     * summary). 'AAA' opts in (and adds axe's wcag2aaa rules); 'A' keeps Level A only.
-     */
-    level?: WcagLevel;
-    includeAxe?: boolean;
-    deep?: boolean;
-    deepApiUrl?: string;
-    deepApiKey?: string;
-    dismissModals?: boolean;
-    viewport?: ViewportPreset | {
-        width: number;
-        height: number;
-    };
-    browser?: {
-        headless?: boolean;
-        timeout?: number;
-    };
-    review?: boolean;
-    /** Limit scan to elements within this CSS selector. */
-    rootSelector?: string;
-    /** Include annotated screenshots of violations in results. */
-    enableScreenshots?: boolean;
-    /** Scan content inside iframes. Default: false. */
-    includeIframes?: boolean;
-    /**
-     * Wait for entrance animations to finish before scanning (prevents false
-     * contrast failures on mid-fade text). `false` disables, a number sets the
-     * wait cap in ms. Default: enabled with a 4000ms cap.
-     */
-    settle?: boolean | number;
-    /**
-     * HTTP status of the main-document response, for the Page-object call shape
-     * where the CALLER navigated (e.g. mcp's flow_scan does its own `page.goto`).
-     * The URL-string path captures this itself; on the Page path core cannot see
-     * the response, so a plain 4xx/5xx error page with no challenge DOM markers
-     * would otherwise be scanned as a clean page. Pass the caller's
-     * `response.status()` here so bot-challenge/error-page detection works
-     * uniformly across both entrypoints. Ignored on the URL-string path.
-     */
-    mainStatus?: number;
-}
-
-export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type IssueImpact as I, type PageLike as P, type ScanResult as S, VIEWPORT_SIZES as V, type WcagLevel as W, type ScanOptions as a, type SiteTheme as b, type ScanIssue as c, type FixIssueType as d, type IssueSource as e, type ViewportPreset as f, WCAG_BY_ISSUE as g };

package/dist/types-CbNyAKbT.d.ts

@@ -1,257 +0,0 @@
-/**
- * @webability/core — type definitions
- */
-/**
- * Minimal page interface satisfied by both Playwright and Puppeteer.
- * No runtime wrapper needed — both libraries implement these methods natively.
- */
-interface PageLike {
-    evaluate<R>(pageFunction: string | ((...args: any[]) => R | Promise<R>), ...args: any[]): Promise<R>;
-    addScriptTag(options: {
-        content: string;
-    }): Promise<unknown>;
-    url(): string;
-    /**
-     * Real keyboard event dispatch (Playwright & Puppeteer both expose this).
-     * Optional so minimal PageLike shims still typecheck. The focusVisible
-     * detector uses `keyboard.press('Tab')` to put the browser into keyboard
-     * interaction modality before probing focus styles — otherwise
-     * `:focus-visible` / keyboard-detection-class patterns (focus-visible
-     * polyfill, `.user-is-tabbing` body class) never activate under a bare
-     * programmatic `.focus()`, producing mass false positives.
-     */
-    keyboard?: {
-        press(key: string): Promise<void>;
-    };
-}
-/** All fix issue types the pipeline can detect and fix. */
-type FixIssueType = 'weak_button_name' | 'weak_link_name' | 'weak_heading' | 'weak_iframe_title' | 'weak_page_title' | 'weak_svg_name' | 'weak_skip_link' | 'missing_button_role' | 'missing_semantic_role' | 'missing_landmark' | 'heading_skip' | 'svg_missing_name' | 'aria_hidden_focusable' | 'adjacent_redundant_link' | 'contrast_insufficient' | 'non_text_contrast_insufficient' | 'target_too_small' | 'focus_not_visible' | 'empty_link' | 'unlabeled_button' | 'missing_label' | 'decorative_icon' | 'skip_link' | 'aria_live' | 'missing_alt' | 'identify_input_purpose' | 'redundant_role' | 'duplicate_id' | 'new_window_link' | 'missing_fieldset_legend' | 'missing_table_header' | 'missing_table_caption' | 'missing_table_scope' | 'external_link_warning' | 'download_link_warning' | 'broken_anchor' | 'placeholder_link' | 'missing_pattern_title' | 'missing_autocomplete' | 'missing_media_controls' | 'unsafe_autoplay' | 'invalid_aria_role' | 'zoom_restriction' | 'missing_button_type' | 'link_consistency' | 'semantic_emphasis' | 'keyboard_trap' | 'focus_order_disruption' | 'missing_captions' | 'color_only_link' | 'label_in_name' | 'onfocus_context_change' | 'focus_obscured_by_sticky' | 'text_spacing_blocked' | 'nested_landmark' | 'combobox_name_missing' | 'landmark_duplicate_unlabeled' | 'motion_uncontrollable' | 'auto_refresh' | 'motion_without_reduced_motion' | 'flashing_content' | 'animated_gif_no_pause' | 'missing_required_indicator' | 'background_image_unlabeled' | 'missing_h1' | 'multiple_h1' | 'empty_heading' | 'javascript_link' | 'broken_aria_reference' | 'main_content_hidden' | 'scrollable_not_focusable' | 'meaningful_sequence' | 'sensory_characteristic' | 'orientation_lock' | 'image_of_text' | 'reflow_overflow' | 'missing_audio_description' | 'missing_transcript' | 'character_key_shortcut' | 'on_input_change' | 'pointer_gesture' | 'pointer_cancellation' | 'motion_actuation' | 'error_prevention_missing' | 'insufficient_navigation' | 'inconsistent_navigation';
-/** WCAG criterion for each issue type. */
-declare const WCAG_BY_ISSUE: Record<FixIssueType, string>;
-/** A single accessibility issue detected on the page. */
-interface DetectedIssue {
-    /** Unique CSS selector targeting the element. */
-    selector: string;
-    /** HTML/ARIA attribute to set (alt, aria-label, role, tabindex, etc.) */
-    attribute: string;
-    /** What the element currently has (empty string if missing). */
-    currentValue: string;
-    /** Classification of the issue. */
-    issueType: FixIssueType;
-    /** WCAG success criterion reference. */
-    wcag: string;
-    /** Contextual info for Claude: nearby heading, parent tag, href, page section. */
-    context: string;
-    /** true = needs Claude to generate the fix value; false = rule already knows it. */
-    needsAI: boolean;
-    /** When needsAI is false, this is the known fix value. */
-    fixValue?: string;
-    /** Optional: image src for alt text generation via vision. */
-    imageSrc?: string;
-    /** Optional: outer HTML snippet (first 300 chars) for Claude context. */
-    outerHtml?: string;
-    /**
-     * Detector-side signal that the VERDICT is uncertain (e.g. contrast against
-     * a gradient). The scanner never reports such a finding: it is resolved to a
-     * verdict by an engine resolver or dropped. For "verdict certain, fix not
-     * mechanical" use `manualFix`.
-     */
-    needsReview?: boolean;
-    /**
-     * The verdict is certain but the suggested fix cannot be applied
-     * mechanically. Sets `fix.needsManualReview`; never changes the verdict.
-     */
-    manualFix?: boolean;
-    /** Why this finding needs review — surfaced to MCP/SDK consumers. */
-    reviewReason?: string;
-    /**
-     * Optional exact user-facing message. Use when the generic
-     * attribute/currentValue template ("missing X", "X is \"Y\"") would state
-     * something false or fabricated — e.g. a weak button name whose name comes
-     * from text content has no missing aria-label to report (persona round 3,
-     * P069: 'weak button name: missing aria-label' on a named control).
-     * formatMessage prefers this verbatim when present.
-     */
-    message?: string;
-}
-/** Every fix detector must implement this interface. */
-interface FixDetector {
-    name: string;
-    detect(page: PageLike): Promise<DetectedIssue[]>;
-    /** Per-page emission cap, when the detector has one. When a run returns
-     *  >= cap findings the results are TRUNCATED (DOM-order biased) and the
-     *  scan reports it via ScanResult.truncated — silent truncation reads as
-     *  "covered everything" when it didn't (loop iter8 / honesty infra). */
-    cap?: number;
-}
-/**
- * Browser-runtime detector signature.
- *
- * Each detector exports a pure, zero-argument browser function that uses the
- * `document` global directly and returns DetectedIssue[]. No Puppeteer, no
- * Node imports, no closures over module-scope variables — so it both:
- *   1. Survives serialization via `page.evaluate(fn)` on the server (puppeteer
- *      stringifies and re-parses the function inside the browser context).
- *   2. Bundles directly into the widget via webpack and runs against the
- *      live customer DOM.
- *
- * Single source of truth — same rules run in both runtimes.
- */
-type BrowserDetector = () => DetectedIssue[];
-interface SiteTheme {
-    cssVars: Record<string, string>;
-    topBgColors: Array<{
-        color: string;
-        count: number;
-    }>;
-    topTextColors: Array<{
-        color: string;
-        count: number;
-    }>;
-}
-type IssueSource = 'webability' | 'axe-core' | 'deep-analysis';
-type IssueImpact = 'critical' | 'serious' | 'moderate' | 'minor';
-type WcagLevel = 'A' | 'AA' | 'AAA';
-/**
- * Confidence tier for a scan finding. Mirrors axe-core's three-tier output —
- * `high` is a confirmed violation safe to act on; `needs_review` is ambiguous
- * (e.g. text on a gradient background, mid-animation opacity, marketing imagery
- * that may legitimately contain text). Consumers should never auto-apply fixes
- * to `needs_review` findings — they belong in the `incomplete[]` bucket and
- * require human judgment.
- */
-type IssueConfidence = 'high' | 'needs_review';
-interface ScanIssue {
-    id: string;
-    source: IssueSource;
-    type: FixIssueType | string;
-    wcag: string;
-    level: WcagLevel;
-    impact: IssueImpact;
-    message: string;
-    selector: string;
-    html?: string;
-    /** When set, this issue is ambiguous and lives in `ScanResult.incomplete[]`. */
-    confidence?: IssueConfidence;
-    /** Why the classifier demoted this issue. Surfaced to MCP/SDK consumers. */
-    reviewReason?: string;
-    fix?: {
-        attribute: string;
-        currentValue: string;
-        suggestedValue?: string;
-        needsManualReview: boolean;
-    };
-}
-/**
- * Signal that the scan never reached the intended page — the target served a
- * bot-challenge / interstitial (Cloudflare "Just a moment…", "Access Denied",
- * a CAPTCHA wall) or the main document returned an HTTP error status. When
- * present, `issues`/`incomplete` are empty and MUST NOT be read as "the page is
- * clean": nothing real was scanned. Lets a caller distinguish "scanned and
- * clean" from "was never actually scanned".
- */
-interface BlockedInfo {
-    /** Human-readable explanation of why the page could not be scanned. */
-    reason: string;
-    /** Challenge vendor when identifiable (e.g. 'Cloudflare', 'PerimeterX/HUMAN'). */
-    vendor?: string;
-    /** HTTP status of the main document response, when known. */
-    status?: number;
-    /** The specific signal that matched (page title, marker selector, or status). */
-    signal?: string;
-}
-interface ScanResult {
-    url: string;
-    timestamp: string;
-    /**
-     * Set when the target served a bot-challenge/interstitial or an HTTP error
-     * instead of the real page. When present, treat `issues`/`incomplete` as
-     * "not scanned" (they are empty), NOT as "no problems found".
-     */
-    blocked?: BlockedInfo;
-    /** High-confidence violations. Safe to surface as bugs. */
-    issues: ScanIssue[];
-    /** Detectors that hit their per-page cap this run — their counts are lower
-     *  bounds, not a census. Additive field; absent = nothing truncated. */
-    truncated?: Array<{
-        detector: string;
-        cap: number;
-    }>;
-    /**
-     * Non-fatal engine subsystem failures that silently disable a category of
-     * checks. Consumers MUST surface these to the user — a result with
-     * `engineWarnings` is NOT a full scan. Currently: `'color:kernel-injection-failed'`
-     * disables all contrast checks for the page. Absent = all subsystems healthy.
-     */
-    engineWarnings?: string[];
-    /** Engine (core package) version that produced this result — provenance */
-    engine?: string;
-    /**
-     * @deprecated Always `[]`. The scanner judges uncertain findings itself:
-     * each becomes a verdict in `issues` or is dropped. The field stays only so
-     * existing consumers that read it keep compiling.
-     */
-    incomplete: ScanIssue[];
-    summary: {
-        total: number;
-        critical: number;
-        serious: number;
-        moderate: number;
-        minor: number;
-        /** @deprecated Always 0 — there is no incomplete bucket. */
-        incomplete: number;
-    };
-    axeResults?: unknown;
-}
-type ViewportPreset = 'mobile' | 'tablet' | 'desktop';
-declare const VIEWPORT_SIZES: Record<ViewportPreset, {
-    width: number;
-    height: number;
-}>;
-interface ScanOptions {
-    wcagTags?: string[];
-    /**
-     * Highest WCAG conformance level to report. Default 'AA': findings whose
-     * criteria are all Level AAA are not reported anywhere (issues, incomplete,
-     * summary). 'AAA' opts in (and adds axe's wcag2aaa rules); 'A' keeps Level A only.
-     */
-    level?: WcagLevel;
-    includeAxe?: boolean;
-    deep?: boolean;
-    deepApiUrl?: string;
-    deepApiKey?: string;
-    dismissModals?: boolean;
-    viewport?: ViewportPreset | {
-        width: number;
-        height: number;
-    };
-    browser?: {
-        headless?: boolean;
-        timeout?: number;
-    };
-    review?: boolean;
-    /** Limit scan to elements within this CSS selector. */
-    rootSelector?: string;
-    /** Include annotated screenshots of violations in results. */
-    enableScreenshots?: boolean;
-    /** Scan content inside iframes. Default: false. */
-    includeIframes?: boolean;
-    /**
-     * Wait for entrance animations to finish before scanning (prevents false
-     * contrast failures on mid-fade text). `false` disables, a number sets the
-     * wait cap in ms. Default: enabled with a 4000ms cap.
-     */
-    settle?: boolean | number;
-    /**
-     * HTTP status of the main-document response, for the Page-object call shape
-     * where the CALLER navigated (e.g. mcp's flow_scan does its own `page.goto`).
-     * The URL-string path captures this itself; on the Page path core cannot see
-     * the response, so a plain 4xx/5xx error page with no challenge DOM markers
-     * would otherwise be scanned as a clean page. Pass the caller's
-     * `response.status()` here so bot-challenge/error-page detection works
-     * uniformly across both entrypoints. Ignored on the URL-string path.
-     */
-    mainStatus?: number;
-}
-
-export { type BrowserDetector as B, type DetectedIssue as D, type FixDetector as F, type IssueImpact as I, type PageLike as P, type ScanResult as S, VIEWPORT_SIZES as V, type WcagLevel as W, type ScanOptions as a, type SiteTheme as b, type ScanIssue as c, type FixIssueType as d, type IssueSource as e, type ViewportPreset as f, WCAG_BY_ISSUE as g };