@a11y-skills/audit 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to `@a11y-skills/audit` are documented here. This project
 adheres to [Semantic Versioning](https://semver.org/).
 
+## 0.3.1
+
+### Fixed
+
+- `runFocusIndicatorCheck`: focus-triggered navigations slower than the
+  per-Tab settle window are no longer silently missed. The settle window is
+  now configurable via the new `navigationSettleMs` option (default: 50), and
+  a `framenavigated` listener additionally catches URL changes that commit and
+  revert within a single window. (#26)
+
 ## 0.3.0
 
 **Breaking** — every check now returns (and saves) a single axe-style envelope

package/dist/constants.d.ts

@@ -24,6 +24,8 @@ export declare const FOCUS_STYLE_PROPERTIES: readonly ["outline", "outlineStyle"
 export declare const FOCUSABLE_SELECTOR: string;
 /** Extra tab iterations for safety margin */
 export declare const EXTRA_TAB_ITERATIONS = 10;
+/** Default ms to wait after each Tab press for a focus-triggered navigation to surface. */
+export declare const DEFAULT_NAVIGATION_SETTLE_MS = 50;
 /**
  * Minimum overlap ratio to report as obscured (0-1)
  * 0.2 means 20% of the focused element must be covered

package/dist/constants.js

@@ -60,6 +60,8 @@ export const FOCUSABLE_SELECTOR = `
 `.trim();
 /** Extra tab iterations for safety margin */
 export const EXTRA_TAB_ITERATIONS = 10;
+/** Default ms to wait after each Tab press for a focus-triggered navigation to surface. */
+export const DEFAULT_NAVIGATION_SETTLE_MS = 50;
 // =============================================================================
 // Focus Obscured Detection Constants (WCAG 2.4.12)
 // =============================================================================
@@ -320,18 +322,62 @@ export const AUTOCOMPLETE_FIELD_PATTERNS = {
 };
 /** 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',
+    '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';
 // =============================================================================
@@ -385,28 +431,60 @@ export const DETECTION_RESULT_FILENAME = 'detection-result.json';
 /** Keywords for pause/stop controls (EN/JP) */
 export const PAUSE_KEYWORDS = [
     // English
-    'pause', 'stop', 'halt', 'freeze', 'play',
+    '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',
+    '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',
+    'carousel',
+    'slider',
+    'slide',
+    'swiper',
+    'slick',
+    'hero',
+    'banner',
+    'gallery',
+    'rotator',
 ];
 /** Navigation control keywords */
 export const NAV_KEYWORDS = [
-    'prev', 'next', '前', '次', 'arrow', 'dot', 'indicator',
+    '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',
+    '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/index.d.ts

@@ -11,5 +11,5 @@
  */
 export * from './types.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 { 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

@@ -11,5 +11,5 @@
  */
 export * from './types.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 { 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

@@ -14,7 +14,7 @@
  */
 export { runAxeAudit, type RunAxeAuditOptions } from './runAxeAudit.js';
 export { runFocusIndicatorCheck, type RunFocusIndicatorCheckOptions, } from './runFocusIndicatorCheck.js';
-export { runReflowCheck, type RunReflowCheckOptions } from './runReflowCheck.js';
+export { runReflowCheck, type RunReflowCheckOptions, } from './runReflowCheck.js';
 export { runTargetSizeCheck, type RunTargetSizeCheckOptions, } from './runTargetSizeCheck.js';
 export { runTextSpacingCheck, type RunTextSpacingCheckOptions, } from './runTextSpacingCheck.js';
 export { runZoomCheck, type RunZoomCheckOptions } from './runZoomCheck.js';

package/dist/playwright/index.js

@@ -14,7 +14,7 @@
  */
 export { runAxeAudit } from './runAxeAudit.js';
 export { runFocusIndicatorCheck, } from './runFocusIndicatorCheck.js';
-export { runReflowCheck } from './runReflowCheck.js';
+export { runReflowCheck, } from './runReflowCheck.js';
 export { runTargetSizeCheck, } from './runTargetSizeCheck.js';
 export { runTextSpacingCheck, } from './runTextSpacingCheck.js';
 export { runZoomCheck } from './runZoomCheck.js';

package/dist/playwright/runAutoPlayDetection.js

@@ -16,7 +16,7 @@
 import * as path from 'node:path';
 import { SCREENSHOT_INTERVALS, CHANGE_THRESHOLD, DEFAULT_AUTO_PLAY_OUTPUT_DIR, DETECTION_RESULT_FILENAME, } from '../constants.js';
 import { buildAuditResult, normalizeAutoPlayDetection, } from '../utils/axe-format.js';
-import { generateRecommendation, printSummary } from '../utils/recommendations.js';
+import { generateRecommendation, printSummary, } from '../utils/recommendations.js';
 /** Capture screenshots at configured intervals. */
 async function captureScreenshots(page, outputDir) {
     const screenshots = [];
@@ -138,6 +138,11 @@ export async function runAutoPlayDetection(options) {
     console.log('\n=== Auto-play Detection Results ===\n');
     console.log(JSON.stringify(result, null, 2));
     saveJsonResult(path.join(outputDir, DETECTION_RESULT_FILENAME), result);
-    printSummary({ hasAutoPlayContent: hasAnyChange, stopsWithin5Seconds, pauseControls, pauseVerification }, outputDir);
+    printSummary({
+        hasAutoPlayContent: hasAnyChange,
+        stopsWithin5Seconds,
+        pauseControls,
+        pauseVerification,
+    }, outputDir);
     return result;
 }

package/dist/playwright/runAutocompleteAudit.js

@@ -31,7 +31,10 @@ function collectBasicFieldInfo(args) {
             html = '';
         }
         if (!html) {
-            return { html: `<${element.tagName.toLowerCase()}>`, htmlTruncated: false };
+            return {
+                html: `<${element.tagName.toLowerCase()}>`,
+                htmlTruncated: false,
+            };
         }
         if (html.length > htmlSnippetMaxLength) {
             return { html: html.slice(0, htmlSnippetMaxLength), htmlTruncated: true };
@@ -54,7 +57,9 @@ function collectBasicFieldInfo(args) {
             path.unshift(selector);
             current = parent;
         }
-        return path.length > 0 ? path.join(' > ') : `[data-index="${elementIndex}"]`;
+        return path.length > 0
+            ? path.join(' > ')
+            : `[data-index="${elementIndex}"]`;
     }
     const skipTypes = ['hidden', 'submit', 'reset', 'button', 'image', 'file'];
     const fields = [];

package/dist/playwright/runFocusIndicatorCheck.d.ts

@@ -22,6 +22,13 @@ export interface RunFocusIndicatorCheckOptions extends OutputLocationOptions {
     screenshot?: boolean;
     /** Options forwarded to `browser.newContext()` (locale, viewport, storageState, ...). */
     contextOptions?: BrowserContextOptions;
+    /**
+     * Milliseconds to wait after each Tab press for a focus-triggered navigation
+     * to surface (default: 50). A navigation that fires after this window may be
+     * missed or attributed to a neighboring element — raise this value when
+     * auditing pages with debounced or otherwise delayed focus handlers.
+     */
+    navigationSettleMs?: number;
 }
 /**
  * Run the focus indicator check, write the result JSON (and optionally a

package/dist/playwright/runFocusIndicatorCheck.js

@@ -10,7 +10,7 @@
  *
  * The context this function creates is closed before it returns.
  */
-import { FOCUSABLE_SELECTOR, FOCUS_STYLE_PROPERTIES, EXTRA_TAB_ITERATIONS, DEFAULT_FOCUS_RESULT_FILE, DEFAULT_FOCUS_SCREENSHOT_FILE, FOCUS_OBSCURED_MIN_OVERLAP_RATIO, FOCUS_OBSCURED_MIN_OVERLAP_PX, FOCUS_OBSCURED_EXCLUDE_SELECTORS, HTML_SNIPPET_MAX_LENGTH, } from '../constants.js';
+import { FOCUSABLE_SELECTOR, FOCUS_STYLE_PROPERTIES, EXTRA_TAB_ITERATIONS, DEFAULT_NAVIGATION_SETTLE_MS, DEFAULT_FOCUS_RESULT_FILE, DEFAULT_FOCUS_SCREENSHOT_FILE, FOCUS_OBSCURED_MIN_OVERLAP_RATIO, FOCUS_OBSCURED_MIN_OVERLAP_PX, FOCUS_OBSCURED_EXCLUDE_SELECTORS, HTML_SNIPPET_MAX_LENGTH, } from '../constants.js';
 import { buildAuditResult, normalizeFocusCheck } from '../utils/axe-format.js';
 import { resolveOutputPath, resolveScreenshotPath, saveAuditResult, takeAuditScreenshot, requireTargetUrl, logAuditHeader, logOutputPaths, } from '../utils/test-harness.js';
 // =============================================================================
@@ -73,7 +73,7 @@ const MAX_RETRIES = 5;
  * screenshot), and return the parsed result.
  */
 export async function runFocusIndicatorCheck(options) {
-    const { browser, targetUrl: targetUrlOption, screenshot = false, contextOptions, ...location } = options;
+    const { browser, targetUrl: targetUrlOption, screenshot = false, contextOptions, navigationSettleMs = DEFAULT_NAVIGATION_SETTLE_MS, ...location } = options;
     const targetUrl = requireTargetUrl(targetUrlOption);
     const resolvedResultPath = resolveOutputPath({
         ...location,
@@ -95,6 +95,18 @@ export async function runFocusIndicatorCheck(options) {
             // Create a fresh context for each attempt to reset init scripts
             context = await browser.newContext(contextOptions);
             const page = await context.newPage();
+            // Track main-frame navigations (WCAG 3.2.1). Catches URL changes that
+            // commit and revert within a single settle window (which the before/after
+            // URL diff alone would miss). A navigation landing between iterations is
+            // absorbed into the next urlBeforeTab and is NOT caught by this listener —
+            // raise navigationSettleMs for pages with slow focus-triggered handlers.
+            // Reset after the initial goto; checked alongside the URL diff.
+            let lateNavigationUrl = null;
+            page.on('framenavigated', (frame) => {
+                if (frame === page.mainFrame()) {
+                    lateNavigationUrl = frame.url();
+                }
+            });
             const focusHistory = [];
             let lastFocusedElement = null;
             let navigationDetected = false;
@@ -160,6 +172,9 @@ export async function runFocusIndicatorCheck(options) {
                     });
                 }, skipSelectors);
             }
+            // Reset the late-navigation flag so the initial goto and skip-element
+            // setup above don't produce false positives in the Tab loop.
+            lateNavigationUrl = null;
             // Tab through all elements with navigation detection
             for (let i = 0; i < count + EXTRA_TAB_ITERATIONS; i++) {
                 const urlBeforeTab = page.url();
@@ -202,7 +217,9 @@ export async function runFocusIndicatorCheck(options) {
                                 el.textContent?.slice(0, 30) ||
                                 '',
                             selector: getSelector(el),
-                            html: htmlTruncated ? html.slice(0, htmlSnippetMaxLength) : html,
+                            html: htmlTruncated
+                                ? html.slice(0, htmlSnippetMaxLength)
+                                : html,
                             htmlTruncated,
                         };
                     }, HTML_SNIPPET_MAX_LENGTH);
@@ -212,18 +229,22 @@ export async function runFocusIndicatorCheck(options) {
                     currentFocusedElement = lastFocusedElement;
                 }
                 // Small wait to allow any navigation to start
-                await page.waitForTimeout(50);
-                // Check if navigation occurred
+                await page.waitForTimeout(navigationSettleMs);
+                // Check if navigation occurred (either within the settle window or late)
                 const urlAfterTab = page.url();
-                if (urlAfterTab !== urlBeforeTab) {
+                const lateNav = lateNavigationUrl !== null && lateNavigationUrl !== urlBeforeTab;
+                if (urlAfterTab !== urlBeforeTab || lateNav) {
                     // 3.2.1 violation detected!
                     navigationDetected = true;
                     const culprit = currentFocusedElement || lastFocusedElement;
                     if (culprit && !skipSelectors.includes(culprit.selector)) {
+                        const toUrl = urlAfterTab !== urlBeforeTab
+                            ? urlAfterTab
+                            : (lateNavigationUrl ?? urlAfterTab);
                         onFocusViolations.push({
                             element: culprit,
                             fromUrl: urlBeforeTab,
-                            toUrl: urlAfterTab,
+                            toUrl,
                             changeType: 'navigation',
                         });
                         skipSelectors.push(culprit.selector);
@@ -231,9 +252,10 @@ export async function runFocusIndicatorCheck(options) {
                         console.warn(`    Element: <${culprit.tag}> "${culprit.name}"`);
                         console.warn(`    Selector: ${culprit.selector}`);
                         console.warn(`    From: ${urlBeforeTab}`);
-                        console.warn(`    To: ${urlAfterTab}`);
+                        console.warn(`    To: ${toUrl}`);
                         console.warn(`    Restarting test with this element skipped...`);
                     }
+                    lateNavigationUrl = null;
                     break;
                 }
             }
@@ -687,7 +709,8 @@ function createFocusTrackerScript(args) {
         // Clamp ratio to max 1.0 to handle overlapping obscurers covering same region
         const obscuredRatio = Math.min(totalOverlapArea / focusedArea, 1.0);
         // Only report if obscured ratio exceeds threshold
-        if (obscuredRatio >= obscuredConfig.minOverlapRatio && overlaps.length > 0) {
+        if (obscuredRatio >= obscuredConfig.minOverlapRatio &&
+            overlaps.length > 0) {
             // Add visual annotation
             addAnnotationBox(focusedEl, `⚠ 2.4.12 Obscured (${(obscuredRatio * 100).toFixed(0)}%)`, 'focus-obscured');
             // Report to test
@@ -715,18 +738,19 @@ function createFocusTrackerScript(args) {
     /**
      * Initialize focus tracker - called after page load
      */
-    window.initFocusTracker = () => {
-        // Create overlay container
-        createOverlay();
-        const elements = [...document.querySelectorAll(focusableSelector)]
-            .filter(isVisible)
-            .filter((el) => !shouldSkip(el));
-        elements.forEach((el) => {
-            baseStyles.set(el, captureStyle(el));
-            elementSelectors.set(el, getSelector(el));
-        });
-        return elements.length;
-    };
+    window.initFocusTracker =
+        () => {
+            // Create overlay container
+            createOverlay();
+            const elements = [...document.querySelectorAll(focusableSelector)]
+                .filter(isVisible)
+                .filter((el) => !shouldSkip(el));
+            elements.forEach((el) => {
+                baseStyles.set(el, captureStyle(el));
+                elementSelectors.set(el, getSelector(el));
+            });
+            return elements.length;
+        };
     /**
      * Handle focus events
      */

package/dist/playwright/runReflowCheck.js

@@ -23,7 +23,10 @@ import { saveAuditResult, takeAuditScreenshot, resolveScreenshotPath, logAuditHe
  */
 export async function runReflowCheck(options) {
     const { page, viewport = REFLOW_VIEWPORT, overflowTolerance = REFLOW_OVERFLOW_TOLERANCE, screenshot = false, ...location } = options;
-    await page.setViewportSize({ width: viewport.width, height: viewport.height });
+    await page.setViewportSize({
+        width: viewport.width,
+        height: viewport.height,
+    });
     const layoutResult = await page.evaluate(createLayoutChecker, {
         viewportWidth: viewport.width,
         overflowTolerance,

package/dist/playwright/runTargetSizeCheck.js

@@ -18,7 +18,7 @@
 import { INTERACTIVE_SELECTOR, TARGET_SIZE_AA, TARGET_SIZE_AAA, INLINE_CONTEXT_TAGS, UA_CONTROLLED_INPUT_TYPES, INLINE_CONTEXT_MIN_TEXT, DEFAULT_TARGET_SIZE_RESULT_FILE, DEFAULT_TARGET_SIZE_SCREENSHOT_FILE, HTML_SNIPPET_MAX_LENGTH, } from '../constants.js';
 import { buildAuditResult, normalizeTargetSizeCheck, } from '../utils/axe-format.js';
 import { saveAuditResult, takeAuditScreenshot, resolveScreenshotPath, logAuditHeader, logSummary, logIssueList, logOutputPaths, } from '../utils/test-harness.js';
-import { addPageAnnotations } from '../utils/annotations.js';
+import { addPageAnnotations, } from '../utils/annotations.js';
 /**
  * Collect basic target information from DOM (runs in browser context).
  */
@@ -33,7 +33,10 @@ function collectBasicTargetInfo(args) {
             html = '';
         }
         if (!html) {
-            return { html: `<${element.tagName.toLowerCase()}>`, htmlTruncated: false };
+            return {
+                html: `<${element.tagName.toLowerCase()}>`,
+                htmlTruncated: false,
+            };
         }
         if (html.length > htmlSnippetMaxLength) {
             return { html: html.slice(0, htmlSnippetMaxLength), htmlTruncated: true };
@@ -59,7 +62,9 @@ function collectBasicTargetInfo(args) {
             path.unshift(selector);
             current = parent;
         }
-        return path.length > 0 ? path.join(' > ') : `[data-index="${elementIndex}"]`;
+        return path.length > 0
+            ? path.join(' > ')
+            : `[data-index="${elementIndex}"]`;
     }
     const targets = [];
     const elements = document.querySelectorAll(interactiveSelector);

package/dist/playwright/runTextSpacingCheck.js

@@ -22,7 +22,10 @@ function collectElementMetrics(args) {
             html = '';
         }
         if (!html) {
-            return { html: `<${element.tagName.toLowerCase()}>`, htmlTruncated: false };
+            return {
+                html: `<${element.tagName.toLowerCase()}>`,
+                htmlTruncated: false,
+            };
         }
         if (html.length > htmlSnippetMaxLength) {
             return { html: html.slice(0, htmlSnippetMaxLength), htmlTruncated: true };
@@ -45,7 +48,9 @@ function collectElementMetrics(args) {
             path.unshift(selector);
             current = parent;
         }
-        return path.length > 0 ? path.join(' > ') : `[data-index="${elementIndex}"]`;
+        return path.length > 0
+            ? path.join(' > ')
+            : `[data-index="${elementIndex}"]`;
     }
     function isVisible(element) {
         const style = window.getComputedStyle(element);
@@ -104,7 +109,10 @@ function injectSpacingAndCollect(args) {
             html = '';
         }
         if (!html) {
-            return { html: `<${element.tagName.toLowerCase()}>`, htmlTruncated: false };
+            return {
+                html: `<${element.tagName.toLowerCase()}>`,
+                htmlTruncated: false,
+            };
         }
         if (html.length > htmlSnippetMaxLength) {
             return { html: html.slice(0, htmlSnippetMaxLength), htmlTruncated: true };
@@ -127,7 +135,9 @@ function injectSpacingAndCollect(args) {
             path.unshift(selector);
             current = parent;
         }
-        return path.length > 0 ? path.join(' > ') : `[data-index="${elementIndex}"]`;
+        return path.length > 0
+            ? path.join(' > ')
+            : `[data-index="${elementIndex}"]`;
     }
     function isVisible(element) {
         const style = window.getComputedStyle(element);

package/dist/playwright/runTimeLimitDetector.js

@@ -30,13 +30,13 @@ function createTimerHookScript(args) {
                 callStack =
                     e.stack?.split('\n').slice(2, 5).join('\n') || null;
             }
-            capturedTimers.push({ type: 'setTimeout', delayMs: actualDelay, callStack });
+            capturedTimers.push({
+                type: 'setTimeout',
+                delayMs: actualDelay,
+                callStack,
+            });
         }
-        return originalSetTimeout.apply(window, [
-            callback,
-            delay,
-            ...rest,
-        ]);
+        return originalSetTimeout.apply(window, [callback, delay, ...rest]);
     };
     window.setInterval = function (callback, delay, ...rest) {
         const actualDelay = delay || 0;
@@ -49,15 +49,16 @@ function createTimerHookScript(args) {
                 callStack =
                     e.stack?.split('\n').slice(2, 5).join('\n') || null;
             }
-            capturedTimers.push({ type: 'setInterval', delayMs: actualDelay, callStack });
+            capturedTimers.push({
+                type: 'setInterval',
+                delayMs: actualDelay,
+                callStack,
+            });
         }
-        return originalSetInterval.apply(window, [
-            callback,
-            delay,
-            ...rest,
-        ]);
+        return originalSetInterval.apply(window, [callback, delay, ...rest]);
     };
-    window.__capturedTimers = capturedTimers;
+    window.__capturedTimers =
+        capturedTimers;
 }
 /** Detect meta refresh + countdown indicators (browser context). */
 function detectTimeLimitIndicators(args) {
@@ -71,7 +72,10 @@ function detectTimeLimitIndicators(args) {
             html = '';
         }
         if (!html) {
-            return { html: `<${element.tagName.toLowerCase()}>`, htmlTruncated: false };
+            return {
+                html: `<${element.tagName.toLowerCase()}>`,
+                htmlTruncated: false,
+            };
         }
         if (html.length > htmlSnippetMaxLength) {
             return { html: html.slice(0, htmlSnippetMaxLength), htmlTruncated: true };
@@ -94,7 +98,9 @@ function detectTimeLimitIndicators(args) {
             path.unshift(selector);
             current = parent;
         }
-        return path.length > 0 ? path.join(' > ') : `[data-index="${elementIndex}"]`;
+        return path.length > 0
+            ? path.join(' > ')
+            : `[data-index="${elementIndex}"]`;
     }
     const metaRefresh = [];
     const metaTags = document.querySelectorAll('meta[http-equiv="refresh"]');

package/dist/playwright/runZoomCheck.js

@@ -30,7 +30,10 @@ function applyZoomAndCheck(args) {
             html = '';
         }
         if (!html) {
-            return { html: `<${element.tagName.toLowerCase()}>`, htmlTruncated: false };
+            return {
+                html: `<${element.tagName.toLowerCase()}>`,
+                htmlTruncated: false,
+            };
         }
         if (html.length > htmlSnippetMaxLength) {
             return { html: html.slice(0, htmlSnippetMaxLength), htmlTruncated: true };
@@ -38,8 +41,7 @@ function applyZoomAndCheck(args) {
         return { html, htmlTruncated: false };
     }
     // Apply CSS zoom
-    document.documentElement.style.zoom =
-        '200%';
+    document.documentElement.style.zoom = '200%';
     // Force reflow
     void document.body.offsetHeight;
     function getUniqueSelector(element, elementIndex) {
@@ -58,7 +60,9 @@ function applyZoomAndCheck(args) {
             path.unshift(selector);
             current = parent;
         }
-        return path.length > 0 ? path.join(' > ') : `[data-index="${elementIndex}"]`;
+        return path.length > 0
+            ? path.join(' > ')
+            : `[data-index="${elementIndex}"]`;
     }
     function isVisible(element) {
         const style = window.getComputedStyle(element);
@@ -122,7 +126,10 @@ function applyZoomAndCheck(args) {
  */
 export async function runZoomCheck(options) {
     const { page, targetUrl: targetUrlOption, viewport = ZOOM_BASE_VIEWPORT, screenshot = false, ...location } = options;
-    await page.setViewportSize({ width: viewport.width, height: viewport.height });
+    await page.setViewportSize({
+        width: viewport.width,
+        height: viewport.height,
+    });
     // If a URL is available, navigate at the base viewport (legacy ordering).
     const targetUrl = targetUrlOption ?? process.env.TEST_PAGE;
     if (targetUrl) {

package/dist/schemas/index.js

@@ -399,7 +399,11 @@ export const AUTOCOMPLETE_AUDIT_RESULT_SCHEMA = buildEnvelopeSchema({
     source: 'autocomplete-audit',
     details: {
         type: 'object',
-        required: ['totalFieldsChecked', 'missingAutocomplete', 'invalidAutocomplete'],
+        required: [
+            'totalFieldsChecked',
+            'missingAutocomplete',
+            'invalidAutocomplete',
+        ],
         properties: {
             totalFieldsChecked: { type: 'number' },
             missingAutocomplete: { type: 'array', items: { type: 'object' } },
@@ -413,7 +417,12 @@ export const TIME_LIMIT_DETECTOR_RESULT_SCHEMA = buildEnvelopeSchema({
     source: 'time-limit-detector',
     details: {
         type: 'object',
-        required: ['metaRefresh', 'timers', 'countdownIndicators', 'hasTimeLimits'],
+        required: [
+            'metaRefresh',
+            'timers',
+            'countdownIndicators',
+            'hasTimeLimits',
+        ],
         properties: {
             metaRefresh: { type: 'array', items: { type: 'object' } },
             timers: { type: 'array', items: { type: 'object' } },

package/dist/utils/axe-format.js

@@ -40,7 +40,9 @@ function bucketize(buckets, key, nodes, applicable, override) {
         return;
     }
     const classification = override ?? getRule(key).classification;
-    (classification === 'violation' ? buckets.violations : buckets.incomplete).push(ruleResult(key, nodes));
+    (classification === 'violation'
+        ? buckets.violations
+        : buckets.incomplete).push(ruleResult(key, nodes));
 }
 /** Build a node from element evidence, synthesizing `html` when missing. */
 function toNode(el, failureSummary) {
@@ -55,7 +57,12 @@ function toNode(el, failureSummary) {
 }
 /** Build a page-level node (`target: ['html']`). */
 function pageNode(failureSummary) {
-    return { target: ['html'], html: '<html>', htmlTruncated: false, failureSummary };
+    return {
+        target: ['html'],
+        html: '<html>',
+        htmlTruncated: false,
+        failureSummary,
+    };
 }
 function describeElement(ref) {
     return `<${ref.tag.toLowerCase()}> "${ref.name}"`;
@@ -188,7 +195,9 @@ export function normalizeOrientationCheck(details) {
     const buckets = emptyBuckets();
     const nodes = [];
     if (details.hasOrientationLock) {
-        const state = details.lockDetectedIn === 'landscape' ? details.landscape : details.portrait;
+        const state = details.lockDetectedIn === 'landscape'
+            ? details.landscape
+            : details.portrait;
         const messagePart = state.lockMessageText
             ? ` Lock message found: "${state.lockMessageText}".`
             : '';

package/dist/utils/layout.js

@@ -17,7 +17,10 @@ export function createLayoutChecker(options) {
             html = '';
         }
         if (!html) {
-            return { html: `<${element.tagName.toLowerCase()}>`, htmlTruncated: false };
+            return {
+                html: `<${element.tagName.toLowerCase()}>`,
+                htmlTruncated: false,
+            };
         }
         if (html.length > htmlSnippetMaxLength) {
             return { html: html.slice(0, htmlSnippetMaxLength), htmlTruncated: true };
@@ -47,7 +50,9 @@ export function createLayoutChecker(options) {
             current = parent;
         }
         // Append element index as fallback for guaranteed uniqueness
-        return path.length > 0 ? path.join(' > ') : `[data-index="${elementIndex}"]`;
+        return path.length > 0
+            ? path.join(' > ')
+            : `[data-index="${elementIndex}"]`;
     }
     function isAllowedOverflow(element) {
         return allowedOverflowSelectors.some((selector) => {

package/dist/utils/recommendations.js

@@ -5,7 +5,7 @@
  * Generate a recommendation based on detection results.
  */
 export function generateRecommendation(ctx) {
-    const { hasAutoPlayContent, stopsWithin5Seconds, pauseControls, pauseVerification } = ctx;
+    const { hasAutoPlayContent, stopsWithin5Seconds, pauseControls, pauseVerification, } = ctx;
     if (!hasAutoPlayContent) {
         return 'No auto-playing content detected in viewport.';
     }
@@ -32,7 +32,7 @@ export function generateRecommendation(ctx) {
  * Print summary to console.
  */
 export function printSummary(ctx, outputDir) {
-    const { hasAutoPlayContent, stopsWithin5Seconds, pauseControls, pauseVerification } = ctx;
+    const { hasAutoPlayContent, stopsWithin5Seconds, pauseControls, pauseVerification, } = ctx;
     console.log('\n--- Summary ---');
     if (!hasAutoPlayContent) {
         console.log('✓ No auto-playing content detected in viewport');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a11y-skills/audit",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Playwright + axe-core based WCAG 2.2 accessibility audit functions (axe, focus indicator, reflow, target size, text spacing, zoom, orientation, autocomplete, time limit, auto-play).",
   "type": "module",
   "license": "MIT",