@a11y-skills/audit 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -3,6 +3,27 @@
 All notable changes to `@a11y-skills/audit` are documented here. This project
 adheres to [Semantic Versioning](https://semver.org/).
 
+## 0.2.0
+
+Phase 2 checks added (additive). Still a `0.x` preview — the function API may
+change before `1.0.0` based on downstream feedback.
+
+### Added
+
+- `runTextSpacingCheck` — WCAG 1.4.12.
+- `runZoomCheck` — WCAG 1.4.4.
+- `runOrientationCheck` — WCAG 1.3.4 (owns navigation: takes `page` + `targetUrl`,
+  loads the page at portrait and landscape viewports).
+- `runAutocompleteAudit` — WCAG 1.3.5.
+- `runTimeLimitDetector` — WCAG 2.2.1 (owns navigation: installs a timer hook
+  before `goto`, so takes `page` + `targetUrl`).
+- `runAutoPlayDetection` — WCAG 1.4.2 / 2.2.2. Requires the **optional**
+  dependencies `pixelmatch` + `pngjs` (for pixel-diffing screenshot frames);
+  they are loaded lazily, so importing the package without them keeps the other
+  nine checks working. Throws a clear error if invoked without them.
+- `test-entries/*` and JSON Schemas (`RESULT_SCHEMAS`) for all six new checks.
+- `getTargetUrl(defaultPath)` exported from `@a11y-skills/audit/playwright`.
+
 ## 0.1.0
 
 Initial preview release. The function API may change before `1.0.0` based on

package/README.ja.md

@@ -3,7 +3,7 @@
 Playwright + axe-core ベースの WCAG 2.2 アクセシビリティ検査関数。
 
 本パッケージは [`auditing-wcag`](https://github.com/masuP9/a11y-specialist-skills)
-Claude Code skill から機能本体を切り出したものです。4 つの検査を関数として提供し、
+Claude Code skill から機能本体を切り出したものです。10 個の検査を関数として提供し、
 すぐ実行できる Playwright 用の互換 test entry も同梱します。
 
 > **English: see [README.md](./README.md).**
@@ -11,7 +11,7 @@ Claude Code skill から機能本体を切り出したものです。4 つの検
 > **スコープ.** 自動テストで検出できるのは WCAG 違反の約 30〜40% です。完全な準拠確認には
 > 手動テストが必須です。本パッケージはその一部を自動化します。
 
-## 検査一覧 (v0.1.0)
+## 検査一覧
 
 | 関数 | WCAG |
 | --- | --- |
@@ -19,6 +19,17 @@ Claude Code skill から機能本体を切り出したものです。4 つの検
 | `runFocusIndicatorCheck` | 2.4.7 フォーカスの可視化 / 2.4.12 フォーカスの非遮蔽 / 3.2.1 オンフォーカス |
 | `runReflowCheck` | 1.4.10 リフロー |
 | `runTargetSizeCheck` | 2.5.5 / 2.5.8 ターゲットのサイズ |
+| `runTextSpacingCheck` | 1.4.12 テキストの間隔 |
+| `runZoomCheck` | 1.4.4 テキストのサイズ変更（200% ズーム） |
+| `runOrientationCheck` | 1.3.4 表示の向き |
+| `runAutocompleteAudit` | 1.3.5 入力目的の特定 |
+| `runTimeLimitDetector` | 2.2.1 タイミング調整可能 |
+| `runAutoPlayDetection` | 1.4.2 音声制御 / 2.2.2 一時停止、停止、非表示 |
+
+多くの検査は遷移済みの `page` を受けます。一部は navigation を所有し `targetUrl`
+（または `TEST_PAGE`）を受けます: `runOrientationCheck` と `runTimeLimitDetector`
+（`runZoomCheck` は URL 指定時）。`runFocusIndicatorCheck` は `browser` を受けます。
+`runAutoPlayDetection` は optional 依存 `pixelmatch` + `pngjs` が必要です（インストール参照）。
 
 ## インストール
 
@@ -28,6 +39,14 @@ npm install -D @a11y-skills/audit @playwright/test @axe-core/playwright
 
 `@playwright/test` と `@axe-core/playwright` は **peer dependencies** です。
 
+`runAutoPlayDetection` は追加で `pixelmatch` と `pngjs` を必要とします（**optional
+dependencies** として宣言、既定でインストールされます）。遅延ロードされるため、
+`--omit=optional` でインストールしても他の9検査は動作します:
+
+```sh
+npm install -D pixelmatch pngjs   # runAutoPlayDetection を使う場合のみ
+```
+
 > ESM 専用です。CommonJS ビルドは同梱しません。ESM（または ESM 出力の TypeScript）から
 > import してください。
 
@@ -102,6 +121,9 @@ import "@a11y-skills/audit/test-entries/focus-indicator-check";
 import "@a11y-skills/audit/test-entries/reflow-check";
 // tests/a11y/target-size.spec.ts
 import "@a11y-skills/audit/test-entries/target-size-check";
+// 他にも: text-spacing-check, zoom-200-check, orientation-check,
+// autocomplete-audit, time-limit-detector, auto-play-detection
+import "@a11y-skills/audit/test-entries/text-spacing-check";
 ```
 
 ```sh

package/README.md

@@ -4,7 +4,7 @@ Playwright + axe-core based WCAG 2.2 accessibility audit functions.
 
 This package is the functional core extracted from the
 [`auditing-wcag`](https://github.com/masuP9/a11y-specialist-skills) Claude Code
-skill. It ships four checks as plain functions plus ready-to-run Playwright
+skill. It ships ten checks as plain functions plus ready-to-run Playwright
 test entries.
 
 > **日本語版は [README.ja.md](./README.ja.md) を参照してください。**
@@ -12,7 +12,7 @@ test entries.
 > **Scope.** Automated testing detects only ~30–40% of WCAG issues. Manual
 > testing is required for full conformance. This package automates a subset.
 
-## Checks (v0.1.0)
+## Checks
 
 | Function | WCAG |
 | --- | --- |
@@ -20,6 +20,18 @@ test entries.
 | `runFocusIndicatorCheck` | 2.4.7 Focus Visible / 2.4.12 Focus Not Obscured / 3.2.1 On Focus |
 | `runReflowCheck` | 1.4.10 Reflow |
 | `runTargetSizeCheck` | 2.5.5 / 2.5.8 Target Size |
+| `runTextSpacingCheck` | 1.4.12 Text Spacing |
+| `runZoomCheck` | 1.4.4 Resize Text (200% zoom) |
+| `runOrientationCheck` | 1.3.4 Orientation |
+| `runAutocompleteAudit` | 1.3.5 Identify Input Purpose |
+| `runTimeLimitDetector` | 2.2.1 Timing Adjustable |
+| `runAutoPlayDetection` | 1.4.2 Audio Control / 2.2.2 Pause, Stop, Hide |
+
+Most checks take an already-navigated `page`. A few own navigation and take a
+`targetUrl` instead (or `TEST_PAGE`): `runOrientationCheck` and
+`runTimeLimitDetector` (and `runZoomCheck` when a URL is given).
+`runFocusIndicatorCheck` takes a `browser`. `runAutoPlayDetection` needs the
+optional `pixelmatch` + `pngjs` deps (see Install).
 
 ## Install
 
@@ -29,6 +41,14 @@ npm install -D @a11y-skills/audit @playwright/test @axe-core/playwright
 
 `@playwright/test` and `@axe-core/playwright` are **peer dependencies**.
 
+`runAutoPlayDetection` additionally needs `pixelmatch` and `pngjs` (declared as
+**optional dependencies**, installed by default). They are loaded lazily, so
+the other nine checks work even if you install with `--omit=optional`:
+
+```sh
+npm install -D pixelmatch pngjs   # only if you use runAutoPlayDetection
+```
+
 > ESM only. This package does not ship a CommonJS build; import it from ESM
 > (or a TypeScript project compiled to ESM).
 
@@ -104,6 +124,9 @@ import "@a11y-skills/audit/test-entries/focus-indicator-check";
 import "@a11y-skills/audit/test-entries/reflow-check";
 // tests/a11y/target-size.spec.ts
 import "@a11y-skills/audit/test-entries/target-size-check";
+// ...also: text-spacing-check, zoom-200-check, orientation-check,
+// autocomplete-audit, time-limit-detector, auto-play-detection
+import "@a11y-skills/audit/test-entries/text-spacing-check";
 ```
 
 ```sh

package/dist/constants.d.ts

@@ -86,3 +86,85 @@ export declare const UA_CONTROLLED_INPUT_TYPES: readonly ["checkbox", "radio", "
  * Minimum text length around inline link to qualify for inline exception
  */
 export declare const INLINE_CONTEXT_MIN_TEXT = 10;
+/**
+ * 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 declare const TEXT_SPACING_CSS = "\n  * {\n    line-height: 1.5 !important;\n    letter-spacing: 0.12em !important;\n    word-spacing: 0.16em !important;\n  }\n  p, div, span, li, td, th, dd, dt, label, blockquote {\n    margin-bottom: 2em !important;\n  }\n";
+/** Tolerance for detecting clipping after text spacing changes */
+export declare const TEXT_SPACING_CLIP_TOLERANCE = 2;
+/** Selector for text-containing elements to check */
+export declare const TEXT_SPACING_CHECK_SELECTOR: string;
+export declare const DEFAULT_TEXT_SPACING_RESULT_FILE = "text-spacing-result.json";
+export declare const DEFAULT_TEXT_SPACING_SCREENSHOT_FILE = "text-spacing-screenshot.png";
+/** Zoom factor for resize text test */
+export declare const ZOOM_FACTOR = 2;
+/** Base viewport size before zoom (standard desktop) */
+export declare const ZOOM_BASE_VIEWPORT: {
+    readonly width: 1280;
+    readonly height: 720;
+};
+/** Tolerance for detecting clipping at zoom */
+export declare const ZOOM_CLIP_TOLERANCE = 5;
+export declare const DEFAULT_ZOOM_RESULT_FILE = "zoom-200-result.json";
+export declare const DEFAULT_ZOOM_SCREENSHOT_FILE = "zoom-200-screenshot.png";
+/** Viewport sizes for orientation tests */
+export declare const ORIENTATION_VIEWPORTS: {
+    readonly portrait: {
+        readonly width: 375;
+        readonly height: 667;
+    };
+    readonly landscape: {
+        readonly width: 667;
+        readonly height: 375;
+    };
+};
+/** Keywords indicating orientation lock messages (EN/JP) */
+export declare const ORIENTATION_LOCK_KEYWORDS: readonly ["rotate device", "rotate your device", "rotate your phone", "turn your device", "landscape only", "portrait only", "please rotate", "best viewed in", "for best experience", "画面を回転", "端末を回転", "デバイスを回転", "横向きにして", "縦向きにして", "横画面でご覧", "縦画面でご覧", "回転してください"];
+/** Main content selectors to check visibility */
+export declare const MAIN_CONTENT_SELECTORS: readonly ["main", "[role=\"main\"]", "#main", "#content", ".main-content", "article"];
+export declare const DEFAULT_ORIENTATION_RESULT_FILE = "orientation-result.json";
+export declare const DEFAULT_ORIENTATION_PORTRAIT_SCREENSHOT_FILE = "orientation-screenshot-portrait.png";
+export declare const DEFAULT_ORIENTATION_LANDSCAPE_SCREENSHOT_FILE = "orientation-screenshot-landscape.png";
+/**
+ * Mapping of field patterns to expected autocomplete tokens
+ * Based on HTML autocomplete attribute values
+ */
+export declare const AUTOCOMPLETE_FIELD_PATTERNS: Record<string, RegExp>;
+/** Valid autocomplete token values */
+export declare const VALID_AUTOCOMPLETE_TOKENS: readonly ["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 declare const DEFAULT_AUTOCOMPLETE_RESULT_FILE = "autocomplete-result.json";
+/** Keywords indicating countdown or time limit in visible text (EN/JP) */
+export declare const TIME_LIMIT_KEYWORDS: readonly ["session expires", "session timeout", "time remaining", "time left", "countdown", "expires in", "will timeout", "auto logout", "automatic logout", "セッション終了", "セッションタイムアウト", "残り時間", "タイムアウト", "自動ログアウト", "有効期限", "制限時間", "カウントダウン"];
+/** Timer threshold for reporting (10 minutes in ms) */
+export declare const TIME_LIMIT_THRESHOLD_MS = 600000;
+/** Minimum timer to report (10 seconds in ms, to filter out UI animations) */
+export declare const TIME_LIMIT_MIN_MS = 10000;
+export declare const DEFAULT_TIME_LIMIT_RESULT_FILE = "time-limit-result.json";
+/** Screenshot intervals in milliseconds (0s, 2s, 4s, 6s) */
+export declare const SCREENSHOT_INTERVALS: readonly [0, 2000, 4000, 6000];
+/** Pixel change threshold (0.1% = significant change) */
+export declare const CHANGE_THRESHOLD = 0.1;
+/** Pixelmatch color difference threshold (0-1) */
+export declare const PIXELMATCH_THRESHOLD = 0.1;
+/** Wait time after clicking pause control (ms) */
+export declare const PAUSE_CLICK_WAIT = 500;
+/** Wait time between screenshots for comparison (ms) */
+export declare const SCREENSHOT_COMPARISON_WAIT = 2000;
+export declare const DEFAULT_AUTO_PLAY_OUTPUT_DIR = "./auto-play-screenshots";
+export declare const DETECTION_RESULT_FILENAME = "detection-result.json";
+/** Keywords for pause/stop controls (EN/JP) */
+export declare const PAUSE_KEYWORDS: readonly ["pause", "stop", "halt", "freeze", "play", "一時停止", "停止", "ポーズ", "止める", "再生"];
+/** Class name patterns indicating pause/play controls */
+export declare const CONTROL_CLASS_PATTERNS: readonly ["pause", "play", "stop", "toggle", "switch", "control", "btn-pause", "btn-play", "btn-stop"];
+/** Carousel-related class patterns */
+export declare const CAROUSEL_PATTERNS: readonly ["carousel", "slider", "slide", "swiper", "slick", "hero", "banner", "gallery", "rotator"];
+/** Navigation control keywords */
+export declare const NAV_KEYWORDS: readonly ["prev", "next", "前", "次", "arrow", "dot", "indicator"];
+/** SVG metadata patterns to exclude from accessible names */
+export declare const SVG_METADATA_PATTERNS: readonly ["created with", "made with", "generated by", "svg", "icon", "symbol"];
+/** Maximum parent levels to check for carousel context */
+export declare const MAX_PARENT_LEVELS = 5;

package/dist/constants.js

@@ -182,3 +182,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;