@a11y-skills/audit 0.1.0 → 0.3.0

package/dist/constants.js

@@ -21,6 +21,11 @@ Note: Automated testing detects only ~30-40% of WCAG issues.
       Manual testing is required for complete accessibility evaluation.
 `;
 // =============================================================================
+// Normalized result format
+// =============================================================================
+/** Maximum length of `NormalizedNode.html` / detail `html` snippets. */
+export const HTML_SNIPPET_MAX_LENGTH = 300;
+// =============================================================================
 // Axe Audit defaults (broad WCAG coverage)
 // =============================================================================
 /** Default axe-core tag set (WCAG 2.0/2.1/2.2 A & AA) */
@@ -182,3 +187,226 @@ export const UA_CONTROLLED_INPUT_TYPES = [
  * Minimum text length around inline link to qualify for inline exception
  */
 export const INLINE_CONTEXT_MIN_TEXT = 10;
+// =============================================================================
+// Text Spacing Check Constants (WCAG 1.4.12)
+// =============================================================================
+/**
+ * CSS overrides for text spacing test per WCAG 1.4.12
+ * - Line height: at least 1.5 times the font size
+ * - Letter spacing: at least 0.12 times the font size
+ * - Word spacing: at least 0.16 times the font size
+ * - Paragraph spacing: at least 2 times the font size
+ */
+export const TEXT_SPACING_CSS = `
+  * {
+    line-height: 1.5 !important;
+    letter-spacing: 0.12em !important;
+    word-spacing: 0.16em !important;
+  }
+  p, div, span, li, td, th, dd, dt, label, blockquote {
+    margin-bottom: 2em !important;
+  }
+`;
+/** Tolerance for detecting clipping after text spacing changes */
+export const TEXT_SPACING_CLIP_TOLERANCE = 2;
+/** Selector for text-containing elements to check */
+export const TEXT_SPACING_CHECK_SELECTOR = `
+  p, h1, h2, h3, h4, h5, h6, li, td, th, span, div,
+  a, button, label, dd, dt, blockquote, figcaption
+`.trim();
+export const DEFAULT_TEXT_SPACING_RESULT_FILE = 'text-spacing-result.json';
+export const DEFAULT_TEXT_SPACING_SCREENSHOT_FILE = 'text-spacing-screenshot.png';
+// =============================================================================
+// Zoom 200% Check Constants (WCAG 1.4.4)
+// =============================================================================
+/** Zoom factor for resize text test */
+export const ZOOM_FACTOR = 2;
+/** Base viewport size before zoom (standard desktop) */
+export const ZOOM_BASE_VIEWPORT = { width: 1280, height: 720 };
+/** Tolerance for detecting clipping at zoom */
+export const ZOOM_CLIP_TOLERANCE = 5;
+export const DEFAULT_ZOOM_RESULT_FILE = 'zoom-200-result.json';
+export const DEFAULT_ZOOM_SCREENSHOT_FILE = 'zoom-200-screenshot.png';
+// =============================================================================
+// Orientation Check Constants (WCAG 1.3.4)
+// =============================================================================
+/** Viewport sizes for orientation tests */
+export const ORIENTATION_VIEWPORTS = {
+    portrait: { width: 375, height: 667 },
+    landscape: { width: 667, height: 375 },
+};
+/** Keywords indicating orientation lock messages (EN/JP) */
+export const ORIENTATION_LOCK_KEYWORDS = [
+    // English
+    'rotate device',
+    'rotate your device',
+    'rotate your phone',
+    'turn your device',
+    'landscape only',
+    'portrait only',
+    'please rotate',
+    'best viewed in',
+    'for best experience',
+    // Japanese
+    '画面を回転',
+    '端末を回転',
+    'デバイスを回転',
+    '横向きにして',
+    '縦向きにして',
+    '横画面でご覧',
+    '縦画面でご覧',
+    '回転してください',
+];
+/** Main content selectors to check visibility */
+export const MAIN_CONTENT_SELECTORS = [
+    'main',
+    '[role="main"]',
+    '#main',
+    '#content',
+    '.main-content',
+    'article',
+];
+export const DEFAULT_ORIENTATION_RESULT_FILE = 'orientation-result.json';
+export const DEFAULT_ORIENTATION_PORTRAIT_SCREENSHOT_FILE = 'orientation-screenshot-portrait.png';
+export const DEFAULT_ORIENTATION_LANDSCAPE_SCREENSHOT_FILE = 'orientation-screenshot-landscape.png';
+// =============================================================================
+// Autocomplete Audit Constants (WCAG 1.3.5)
+// =============================================================================
+/**
+ * Mapping of field patterns to expected autocomplete tokens
+ * Based on HTML autocomplete attribute values
+ */
+export const AUTOCOMPLETE_FIELD_PATTERNS = {
+    // Name fields
+    name: /^(full.?name|your.?name|氏名|お名前|名前)$/i,
+    'given-name': /^(first.?name|given.?name|名|ファーストネーム|名前)$/i,
+    'family-name': /^(last.?name|family.?name|surname|姓|ラストネーム|苗字)$/i,
+    'honorific-prefix': /^(prefix|title|敬称)$/i,
+    'honorific-suffix': /^(suffix|様|さん)$/i,
+    // Contact fields
+    email: /^(e.?mail|メール|メールアドレス)$/i,
+    tel: /^(phone|tel|telephone|電話|電話番号|携帯)$/i,
+    'tel-national': /^(phone.?national|国内電話)$/i,
+    // Address fields
+    'street-address': /^(address|street|住所|番地)$/i,
+    'address-line1': /^(address.?1|address.?line.?1|住所1)$/i,
+    'address-line2': /^(address.?2|address.?line.?2|住所2)$/i,
+    'postal-code': /^(zip|postal|郵便番号|〒)$/i,
+    country: /^(country|国|国名)$/i,
+    'country-name': /^(country.?name|国名)$/i,
+    // Organization fields
+    organization: /^(company|org|organization|会社|組織|会社名)$/i,
+    'organization-title': /^(title|position|役職|肩書き)$/i,
+    // Username/password
+    username: /^(user.?name|login|ユーザー名|ログインID)$/i,
+    'current-password': /^(password|pass|current.?password|パスワード|現在のパスワード)$/i,
+    'new-password': /^(new.?password|新しいパスワード)$/i,
+    // Payment
+    'cc-name': /^(card.?name|cc.?name|カード名義)$/i,
+    'cc-number': /^(card.?number|cc.?number|カード番号)$/i,
+    'cc-exp': /^(expir|cc.?exp|有効期限)$/i,
+    'cc-exp-month': /^(exp.?month|有効期限.?月)$/i,
+    'cc-exp-year': /^(exp.?year|有効期限.?年)$/i,
+    'cc-csc': /^(cvc|cvv|csc|security.?code|セキュリティコード)$/i,
+    // Dates
+    bday: /^(birth.?day|birthday|dob|生年月日|誕生日)$/i,
+    'bday-day': /^(birth.?day.?day|日)$/i,
+    'bday-month': /^(birth.?day.?month|月)$/i,
+    'bday-year': /^(birth.?day.?year|年)$/i,
+    sex: /^(sex|gender|性別)$/i,
+    // Other
+    url: /^(url|website|homepage|ウェブサイト|ホームページ)$/i,
+    photo: /^(photo|avatar|写真|アバター)$/i,
+};
+/** Valid autocomplete token values */
+export const VALID_AUTOCOMPLETE_TOKENS = [
+    'off', 'on',
+    'name', 'honorific-prefix', 'given-name', 'additional-name', 'family-name', 'honorific-suffix', 'nickname',
+    'email', 'username', 'new-password', 'current-password', 'one-time-code',
+    'organization-title', 'organization',
+    'street-address', 'address-line1', 'address-line2', 'address-line3',
+    'address-level1', 'address-level2', 'address-level3', 'address-level4',
+    'country', 'country-name', 'postal-code',
+    'cc-name', 'cc-given-name', 'cc-additional-name', 'cc-family-name', 'cc-number', 'cc-exp', 'cc-exp-month', 'cc-exp-year', 'cc-csc', 'cc-type',
+    'transaction-currency', 'transaction-amount',
+    'language', 'bday', 'bday-day', 'bday-month', 'bday-year', 'sex',
+    'tel', 'tel-country-code', 'tel-national', 'tel-area-code', 'tel-local', 'tel-local-prefix', 'tel-local-suffix', 'tel-extension',
+    'impp', 'url', 'photo',
+];
+export const DEFAULT_AUTOCOMPLETE_RESULT_FILE = 'autocomplete-result.json';
+// =============================================================================
+// Time Limit Detector Constants (WCAG 2.2.1)
+// =============================================================================
+/** Keywords indicating countdown or time limit in visible text (EN/JP) */
+export const TIME_LIMIT_KEYWORDS = [
+    // English
+    'session expires',
+    'session timeout',
+    'time remaining',
+    'time left',
+    'countdown',
+    'expires in',
+    'will timeout',
+    'auto logout',
+    'automatic logout',
+    // Japanese
+    'セッション終了',
+    'セッションタイムアウト',
+    '残り時間',
+    'タイムアウト',
+    '自動ログアウト',
+    '有効期限',
+    '制限時間',
+    'カウントダウン',
+];
+/** Timer threshold for reporting (10 minutes in ms) */
+export const TIME_LIMIT_THRESHOLD_MS = 600000;
+/** Minimum timer to report (10 seconds in ms, to filter out UI animations) */
+export const TIME_LIMIT_MIN_MS = 10000;
+export const DEFAULT_TIME_LIMIT_RESULT_FILE = 'time-limit-result.json';
+// =============================================================================
+// Auto-play Detection Constants (WCAG 1.4.2 / 2.2.2)
+// =============================================================================
+/** Screenshot intervals in milliseconds (0s, 2s, 4s, 6s) */
+export const SCREENSHOT_INTERVALS = [0, 2000, 4000, 6000];
+/** Pixel change threshold (0.1% = significant change) */
+export const CHANGE_THRESHOLD = 0.1;
+/** Pixelmatch color difference threshold (0-1) */
+export const PIXELMATCH_THRESHOLD = 0.1;
+/** Wait time after clicking pause control (ms) */
+export const PAUSE_CLICK_WAIT = 500;
+/** Wait time between screenshots for comparison (ms) */
+export const SCREENSHOT_COMPARISON_WAIT = 2000;
+export const DEFAULT_AUTO_PLAY_OUTPUT_DIR = './auto-play-screenshots';
+export const DETECTION_RESULT_FILENAME = 'detection-result.json';
+// =============================================================================
+// Pause Control Detection Patterns (WCAG 1.4.2 / 2.2.2)
+// =============================================================================
+/** Keywords for pause/stop controls (EN/JP) */
+export const PAUSE_KEYWORDS = [
+    // English
+    'pause', 'stop', 'halt', 'freeze', 'play',
+    // Japanese
+    '一時停止', '停止', 'ポーズ', '止める', '再生',
+];
+/** Class name patterns indicating pause/play controls */
+export const CONTROL_CLASS_PATTERNS = [
+    'pause', 'play', 'stop', 'toggle', 'switch',
+    'control', 'btn-pause', 'btn-play', 'btn-stop',
+];
+/** Carousel-related class patterns */
+export const CAROUSEL_PATTERNS = [
+    'carousel', 'slider', 'slide', 'swiper', 'slick',
+    'hero', 'banner', 'gallery', 'rotator',
+];
+/** Navigation control keywords */
+export const NAV_KEYWORDS = [
+    'prev', 'next', '前', '次', 'arrow', 'dot', 'indicator',
+];
+/** SVG metadata patterns to exclude from accessible names */
+export const SVG_METADATA_PATTERNS = [
+    'created with', 'made with', 'generated by',
+    'svg', 'icon', 'symbol',
+];
+/** Maximum parent levels to check for carousel context */
+export const MAX_PARENT_LEVELS = 5;

package/dist/detectors/index.d.ts

@@ -0,0 +1 @@
+export { detectPauseControls, verifyPauseControl, createSkippedVerification, } from './pause-control.js';

package/dist/detectors/index.js

@@ -0,0 +1 @@
+export { detectPauseControls, verifyPauseControl, createSkippedVerification, } from './pause-control.js';

package/dist/detectors/pause-control.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pause/Stop control detection for auto-playing content.
+ * WCAG 1.4.2 (Audio Control) / 2.2.2 (Pause, Stop, Hide)
+ */
+import type { Page } from '@playwright/test';
+import type { PauseControlInfo, PauseVerificationResult } from '../types.js';
+/**
+ * Detect pause/stop controls in the page.
+ */
+export declare function detectPauseControls(page: Page): Promise<PauseControlInfo>;
+/**
+ * Verify if clicking the pause control actually stops the auto-play.
+ */
+export declare function verifyPauseControl(page: Page, pauseControls: PauseControlInfo, outputDir: string, changeThreshold: number): Promise<PauseVerificationResult>;
+/**
+ * Create a skipped verification result.
+ */
+export declare function createSkippedVerification(reason: string): PauseVerificationResult;

package/dist/detectors/pause-control.js

@@ -0,0 +1,206 @@
+/**
+ * Pause/Stop control detection for auto-playing content.
+ * WCAG 1.4.2 (Audio Control) / 2.2.2 (Pause, Stop, Hide)
+ */
+import * as path from 'node:path';
+import { compareImages, formatDiffPercent, hasSignificantChange, } from '../utils/image-compare.js';
+import { PAUSE_KEYWORDS, CONTROL_CLASS_PATTERNS, CAROUSEL_PATTERNS, NAV_KEYWORDS, SVG_METADATA_PATTERNS, MAX_PARENT_LEVELS, PAUSE_CLICK_WAIT, SCREENSHOT_COMPARISON_WAIT, } from '../constants.js';
+/**
+ * Detect pause/stop controls in the page.
+ */
+export async function detectPauseControls(page) {
+    const config = {
+        pauseKeywords: [...PAUSE_KEYWORDS],
+        controlClassPatterns: [...CONTROL_CLASS_PATTERNS],
+        carouselPatterns: [...CAROUSEL_PATTERNS],
+        navKeywords: [...NAV_KEYWORDS],
+        svgMetadataPatterns: [...SVG_METADATA_PATTERNS],
+        maxParentLevels: MAX_PARENT_LEVELS,
+    };
+    return await page.evaluate((cfg) => {
+        const controls = [];
+        const carouselIndicators = [];
+        let hasAccessibleName = false;
+        const getSelector = (el) => {
+            if (el.id)
+                return `#${el.id}`;
+            if (el.className) {
+                const classes = el.className
+                    .toString()
+                    .split(' ')
+                    .filter((c) => c)
+                    .join('.');
+                if (classes)
+                    return `${el.tagName.toLowerCase()}.${classes}`;
+            }
+            return el.tagName.toLowerCase();
+        };
+        const interactiveElements = document.querySelectorAll('button, [role="button"], input[type="button"], [tabindex="0"]');
+        interactiveElements.forEach((el) => {
+            const element = el;
+            const tagName = element.tagName.toLowerCase();
+            const ariaLabel = element.getAttribute('aria-label') || '';
+            const textContent = element.textContent?.trim() || '';
+            const className = element.className?.toString() || '';
+            let accessibleName = ariaLabel || textContent;
+            const isSvgMetadata = cfg.svgMetadataPatterns.some((pattern) => accessibleName.toLowerCase().includes(pattern));
+            if (isSvgMetadata) {
+                accessibleName = '';
+            }
+            const lowerName = accessibleName.toLowerCase();
+            const lowerClass = className.toLowerCase();
+            const nameMatch = cfg.pauseKeywords.some((kw) => lowerName.includes(kw.toLowerCase()));
+            const classMatch = cfg.controlClassPatterns.some((pattern) => lowerClass.includes(pattern));
+            const isNearCarousel = cfg.carouselPatterns.some((pattern) => {
+                if (lowerClass.includes(pattern))
+                    return true;
+                let parent = element.parentElement;
+                for (let i = 0; i < cfg.maxParentLevels && parent; i++) {
+                    if (parent.className?.toString().toLowerCase().includes(pattern)) {
+                        return true;
+                    }
+                    parent = parent.parentElement;
+                }
+                return false;
+            });
+            const hasSvg = element.querySelector('svg');
+            let hasPauseIconPattern = false;
+            if (hasSvg) {
+                const rects = hasSvg.querySelectorAll('rect, path');
+                if (rects.length === 2) {
+                    hasPauseIconPattern = true;
+                }
+            }
+            if (nameMatch) {
+                controls.push({
+                    element: tagName,
+                    name: accessibleName || `[class: ${className.slice(0, 50)}]`,
+                    matchedBy: 'accessible-name',
+                    selector: getSelector(element),
+                });
+                hasAccessibleName = true;
+            }
+            else if (classMatch && isNearCarousel) {
+                controls.push({
+                    element: tagName,
+                    name: accessibleName || `[class: ${className.slice(0, 50)}]`,
+                    matchedBy: 'class-name-near-carousel',
+                    selector: getSelector(element),
+                });
+                if (accessibleName)
+                    hasAccessibleName = true;
+            }
+            else if (hasPauseIconPattern && isNearCarousel) {
+                controls.push({
+                    element: tagName,
+                    name: accessibleName || `[class: ${className.slice(0, 50)}]`,
+                    matchedBy: 'svg-icon-pattern',
+                    selector: getSelector(element),
+                });
+                if (accessibleName)
+                    hasAccessibleName = true;
+            }
+            const isNavControl = cfg.navKeywords.some((kw) => lowerName.includes(kw) || lowerClass.includes(kw));
+            if (isNavControl && isNearCarousel) {
+                carouselIndicators.push({
+                    element: tagName,
+                    name: accessibleName || `[class: ${className.slice(0, 50)}]`,
+                });
+            }
+        });
+        return {
+            found: controls.length > 0,
+            controls,
+            carouselIndicators,
+            hasAccessibleName,
+        };
+    }, config);
+}
+/**
+ * Verify if clicking the pause control actually stops the auto-play.
+ */
+export async function verifyPauseControl(page, pauseControls, outputDir, changeThreshold) {
+    const control = pauseControls.controls[0];
+    if (!pauseControls.found || !control) {
+        return {
+            attempted: false,
+            controlClicked: null,
+            beforeClickDiffPercent: null,
+            afterClickDiffPercent: null,
+            pauseWorked: null,
+            error: 'No pause controls found to verify',
+        };
+    }
+    const selector = control.selector;
+    if (!selector) {
+        return {
+            attempted: false,
+            controlClicked: null,
+            beforeClickDiffPercent: null,
+            afterClickDiffPercent: null,
+            pauseWorked: null,
+            error: 'No selector available for pause control',
+        };
+    }
+    try {
+        const beforePath1 = path.join(outputDir, 'verify-before-1.png');
+        const beforePath2 = path.join(outputDir, 'verify-before-2.png');
+        await page.screenshot({ path: beforePath1, fullPage: false });
+        await page.waitForTimeout(SCREENSHOT_COMPARISON_WAIT);
+        await page.screenshot({ path: beforePath2, fullPage: false });
+        const beforeDiff = compareImages(beforePath1, beforePath2, path.join(outputDir, 'verify-before-diff.png'));
+        const element = await page.$(selector);
+        if (!element) {
+            return {
+                attempted: true,
+                controlClicked: selector,
+                beforeClickDiffPercent: formatDiffPercent(beforeDiff.diffPercent),
+                afterClickDiffPercent: null,
+                pauseWorked: null,
+                error: `Could not find element with selector: ${selector}`,
+            };
+        }
+        await element.click();
+        await page.waitForTimeout(PAUSE_CLICK_WAIT);
+        const afterPath1 = path.join(outputDir, 'verify-after-1.png');
+        const afterPath2 = path.join(outputDir, 'verify-after-2.png');
+        await page.screenshot({ path: afterPath1, fullPage: false });
+        await page.waitForTimeout(SCREENSHOT_COMPARISON_WAIT);
+        await page.screenshot({ path: afterPath2, fullPage: false });
+        const afterDiff = compareImages(afterPath1, afterPath2, path.join(outputDir, 'verify-after-diff.png'));
+        const hadChangeBefore = hasSignificantChange(beforeDiff.diffPercent, changeThreshold);
+        const hasChangeAfter = hasSignificantChange(afterDiff.diffPercent, changeThreshold);
+        const pauseWorked = hadChangeBefore && !hasChangeAfter;
+        return {
+            attempted: true,
+            controlClicked: selector,
+            beforeClickDiffPercent: formatDiffPercent(beforeDiff.diffPercent),
+            afterClickDiffPercent: formatDiffPercent(afterDiff.diffPercent),
+            pauseWorked,
+            error: null,
+        };
+    }
+    catch (err) {
+        return {
+            attempted: true,
+            controlClicked: selector,
+            beforeClickDiffPercent: null,
+            afterClickDiffPercent: null,
+            pauseWorked: null,
+            error: `Error during verification: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+/**
+ * Create a skipped verification result.
+ */
+export function createSkippedVerification(reason) {
+    return {
+        attempted: false,
+        controlClicked: null,
+        beforeClickDiffPercent: null,
+        afterClickDiffPercent: null,
+        pauseWorked: null,
+        error: reason,
+    };
+}

package/dist/index.d.ts

@@ -10,4 +10,6 @@
  * - `@a11y-skills/audit/schemas`: result types & JSON Schemas.
  */
 export * from './types.js';
-export { AUDIT_DISCLAIMER, DEFAULT_AXE_TAGS, REFLOW_VIEWPORT, TARGET_SIZE_AA, TARGET_SIZE_AAA, } from './constants.js';
+export { AUDIT_DISCLAIMER, DEFAULT_AXE_TAGS, HTML_SNIPPET_MAX_LENGTH, REFLOW_VIEWPORT, TARGET_SIZE_AA, TARGET_SIZE_AAA, } from './constants.js';
+export { RULES, getRule, type RuleKey, type RuleMeta } from './utils/rule-registry.js';
+export { buildAuditResult, mergeNormalizedResults, normalizeAxeResults, normalizeAutocompleteAudit, normalizeAutoPlayDetection, normalizeFocusCheck, normalizeOrientationCheck, normalizeReflowCheck, normalizeTargetSizeCheck, normalizeTextSpacingCheck, normalizeTimeLimitDetector, normalizeZoomCheck, type MergedAuditResult, type NormalizedBuckets, type RawAxeResults, type RawAxeRule, } from './utils/axe-format.js';

package/dist/index.js

@@ -10,4 +10,6 @@
  * - `@a11y-skills/audit/schemas`: result types & JSON Schemas.
  */
 export * from './types.js';
-export { AUDIT_DISCLAIMER, DEFAULT_AXE_TAGS, REFLOW_VIEWPORT, TARGET_SIZE_AA, TARGET_SIZE_AAA, } from './constants.js';
+export { AUDIT_DISCLAIMER, DEFAULT_AXE_TAGS, HTML_SNIPPET_MAX_LENGTH, REFLOW_VIEWPORT, TARGET_SIZE_AA, TARGET_SIZE_AAA, } from './constants.js';
+export { RULES, getRule } from './utils/rule-registry.js';
+export { buildAuditResult, mergeNormalizedResults, normalizeAxeResults, normalizeAutocompleteAudit, normalizeAutoPlayDetection, normalizeFocusCheck, normalizeOrientationCheck, normalizeReflowCheck, normalizeTargetSizeCheck, normalizeTextSpacingCheck, normalizeTimeLimitDetector, normalizeZoomCheck, } from './utils/axe-format.js';

package/dist/playwright/index.d.ts

@@ -16,4 +16,10 @@ export { runAxeAudit, type RunAxeAuditOptions } from './runAxeAudit.js';
 export { runFocusIndicatorCheck, type RunFocusIndicatorCheckOptions, } from './runFocusIndicatorCheck.js';
 export { runReflowCheck, type RunReflowCheckOptions } from './runReflowCheck.js';
 export { runTargetSizeCheck, type RunTargetSizeCheckOptions, } from './runTargetSizeCheck.js';
-export { resolveOutputPath, type OutputLocationOptions, } from '../utils/test-harness.js';
+export { runTextSpacingCheck, type RunTextSpacingCheckOptions, } from './runTextSpacingCheck.js';
+export { runZoomCheck, type RunZoomCheckOptions } from './runZoomCheck.js';
+export { runOrientationCheck, type RunOrientationCheckOptions, } from './runOrientationCheck.js';
+export { runAutocompleteAudit, type RunAutocompleteAuditOptions, } from './runAutocompleteAudit.js';
+export { runTimeLimitDetector, type RunTimeLimitDetectorOptions, } from './runTimeLimitDetector.js';
+export { runAutoPlayDetection, type RunAutoPlayDetectionOptions, } from './runAutoPlayDetection.js';
+export { resolveOutputPath, getTargetUrl, requireTargetUrl, type OutputLocationOptions, } from '../utils/test-harness.js';

package/dist/playwright/index.js

@@ -16,4 +16,10 @@ export { runAxeAudit } from './runAxeAudit.js';
 export { runFocusIndicatorCheck, } from './runFocusIndicatorCheck.js';
 export { runReflowCheck } from './runReflowCheck.js';
 export { runTargetSizeCheck, } from './runTargetSizeCheck.js';
-export { resolveOutputPath, } from '../utils/test-harness.js';
+export { runTextSpacingCheck, } from './runTextSpacingCheck.js';
+export { runZoomCheck } from './runZoomCheck.js';
+export { runOrientationCheck, } from './runOrientationCheck.js';
+export { runAutocompleteAudit, } from './runAutocompleteAudit.js';
+export { runTimeLimitDetector, } from './runTimeLimitDetector.js';
+export { runAutoPlayDetection, } from './runAutoPlayDetection.js';
+export { resolveOutputPath, getTargetUrl, requireTargetUrl, } from '../utils/test-harness.js';

package/dist/playwright/runAutoPlayDetection.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Auto-play Content Detection — WCAG 1.4.2 (Audio Control) / 2.2.2 (Pause, Stop, Hide)
+ *
+ * Takes screenshots at 2s intervals (0/2/4/6s), pixel-diffs consecutive frames,
+ * detects whether visual content continues past 5s, finds pause/stop controls,
+ * and verifies whether they work.
+ *
+ * The caller is responsible for navigating the page before calling this.
+ *
+ * IMPORTANT: this is the only check that needs `pixelmatch` + `pngjs` (declared
+ * as optionalDependencies). To keep them out of the package barrel, the modules
+ * that pull them (`utils/image-compare`, `detectors`) are imported LAZILY here,
+ * so importing `@a11y-skills/audit/playwright` never requires the optional deps
+ * unless `runAutoPlayDetection` is actually called.
+ */
+import type { Page } from '@playwright/test';
+import type { AutoPlayDetectionResult } from '../types.js';
+export interface RunAutoPlayDetectionOptions {
+    /** A page already navigated to the target URL. */
+    page: Page;
+    /**
+     * Directory for screenshots, diffs, and the result JSON. Defaults to
+     * `<A11Y_OUTPUT_DIR | cwd>/auto-play-screenshots`.
+     */
+    outputDir?: string;
+    /** Significant-change threshold in percent (default: 0.1). */
+    changeThreshold?: number;
+}
+/**
+ * Run auto-play detection against the current page. Writes screenshots, diff
+ * images, and `detection-result.json` into the output directory; returns the
+ * result.
+ *
+ * @throws if the optional `pixelmatch` / `pngjs` deps are not installed.
+ */
+export declare function runAutoPlayDetection(options: RunAutoPlayDetectionOptions): Promise<AutoPlayDetectionResult>;