@a11y-skills/audit 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -3,6 +3,71 @@
 All notable changes to `@a11y-skills/audit` are documented here. This project
 adheres to [Semantic Versioning](https://semver.org/).
 
+## 0.3.0
+
+**Breaking** — every check now returns (and saves) a single axe-style envelope
+instead of its own ad-hoc shape. The public API is not yet stable in `0.x`, so
+this lands as a minor release.
+
+### Changed (breaking)
+
+- All `runXxx()` functions return `AuditCheckResult<TDetails>`: findings are
+  normalized into `violations` / `incomplete` / `passes` / `inapplicable`
+  rule arrays (axe-style `id` / `impact` / `tags` / `helpUrl` / `nodes`), with
+  rule-level counts in `summary`. The former top-level fields (`issues`,
+  `failAA`, `overflowingElements`, `clippedElements`, ...) moved unchanged
+  under `details`.
+- Classification is conservative: only findings whose detection has no blind
+  spot and where no WCAG exception can apply are `violations`
+  (on-focus context change, text-spacing clipping, invalid autocomplete
+  tokens). Everything else — reflow/zoom overflow, meta refresh, orientation
+  lock, missing focus styles, undersized targets — lands in `incomplete`, the
+  manual-review queue.
+- Saved JSON files use the same envelope; the JSON Schemas were rewritten
+  accordingly (`$defs`-based shared envelope + per-check `details` schemas).
+  Pre-0.3.0 result files no longer validate.
+- `saveAuditResult()` no longer appends a disclaimer (the envelope carries it).
+- `runAxeAudit` builds the buckets from the raw axe results: violations and
+  incomplete keep their nodes, passes/inapplicable keep rule metadata only;
+  `details` records the execution configuration.
+
+### Added
+
+- `rule-registry.ts`: per-rule metadata (`sc`, accurate per-SC `wcag*` tags,
+  `impact`, `scope`, classification) — target size split into
+  `a11y-skills/target-size-minimum` (2.5.8 AA) and
+  `a11y-skills/target-size-enhanced` (2.5.5 AAA).
+- Pure normalization mappers (`normalize*`), `buildAuditResult()`, and the
+  opt-in `mergeNormalizedResults()` exported from the package root. The
+  buckets are re-derivable from a saved result's `details`.
+- Element-level evidence: detail records now carry `html` (outerHTML, capped
+  at `HTML_SNIPPET_MAX_LENGTH`) and `htmlTruncated`; focus issues gained
+  `selector`. `TargetSizeIssue.exceptionAssessment`
+  (`ruled-out`/`possible`/`not-assessed`) drives the violation promotion.
+- Tests: mapper unit tests, merge invariants, and ajv (draft 2020-12) schema
+  validation of the produced envelopes.
+
+## 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 してください。
 
@@ -48,7 +67,7 @@ test("axe audit", async ({ page }, testInfo) => {
     // outputFile: "axe-result.json", // 任意で上書き
     // tags: ["wcag2a", "wcag2aa", "wcag21aa", "wcag22aa"],
   });
-  expect(result.violationCount).toBe(0);
+  expect(result.summary.violationCount).toBe(0);
 });
 ```
 
@@ -67,7 +86,7 @@ test("focus indicators", async ({ browser }, testInfo) => {
     screenshot: true,                 // 既定: false
     // contextOptions: { locale: "ja-JP" }, // browser.newContext() に転送
   });
-  expect(result.elementsWithoutFocusStyle).toBe(0);
+  expect(result.details.elementsWithoutFocusStyle).toBe(0);
 });
 ```
 
@@ -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
@@ -113,6 +135,52 @@ TEST_PAGE=https://example.com A11Y_OUTPUT_DIR=./a11y-results npx playwright test
 > を `testMatch` に指定してもテストは見つかりません。上記の 1 行 re-export spec が
 > entry を実行する正式な方法です。
 
+## 結果形式
+
+すべての検査は同じ axe 風の envelope を返し、同じ形式で JSON に保存します:
+
+```ts
+interface AuditCheckResult<TDetails> {
+  source: CheckSource;            // 例: "reflow-check"
+  url: string;
+  timestamp: string;
+  violations: NormalizedRuleResult[];   // 確定した違反
+  incomplete: NormalizedRuleResult[];   // 要手動確認
+  passes: NormalizedRuleResult[];       // 実行して問題が見つからなかったルール
+  inapplicable: NormalizedRuleResult[]; // 検査対象がなかったルール
+  summary: { violationCount; incompleteCount; passCount; checkedNodes? };
+  details: TDetails;              // 検査固有の証跡（測定値・スクリーンショット等）
+  disclaimer: { ... };
+}
+```
+
+各ルール結果は axe と同じ形（`id` / `impact` / `description` / `help` /
+`helpUrl` / `tags` / `nodes[]`、`nodes[].target` / `html` / `htmlTruncated` /
+`failureSummary`）です。独自ルールは名前空間付き
+（`a11y-skills/focus-visible`、`a11y-skills/target-size-minimum` など）で、
+SC ごとに正確な WCAG バージョン・レベルタグ（`wcag2aa`、`wcag21aa`、
+`wcag22aa`、`wcag247` 形式の SC タグ）が付きます。
+
+**分類は保守的です。** 検出に死角がなく WCAG の例外が適用され得ない場合のみ
+`violations` に入ります（フォーカスによる文脈変化、テキストスペーシングの
+クリップ、autocomplete の不正トークン）。それ以外の検出 — reflow/zoom の
+オーバーフロー、meta refresh、画面方向ロック、フォーカススタイル欠如、
+小さすぎるターゲット — は `incomplete` に入ります。`incomplete` はノイズでは
+なく「要手動確認キュー」として扱ってください。
+
+同一ページに対する複数検査の結果を 1 つにまとめるには:
+
+```ts
+import { mergeNormalizedResults } from "@a11y-skills/audit";
+
+const merged = mergeNormalizedResults([axeResult, reflowResult, targetResult]);
+```
+
+`mergeNormalizedResults` は URL 不一致で例外を投げ、ノードを
+`target` + `failureSummary` で重複排除し、複数バケツに現れるルールは
+`violations > incomplete > passes > inapplicable` の優先順位で統合します。
+frame / shadow root 内の同一セレクタは区別しません。
+
 ## 結果型とスキーマ
 
 ```ts
@@ -120,8 +188,10 @@ import type { AxeAuditResult, FocusCheckResult } from "@a11y-skills/audit/schema
 import { RESULT_SCHEMAS } from "@a11y-skills/audit/schemas";
 ```
 
-`RESULT_SCHEMAS` は各検査 id に手書きの JSON Schema を対応付けており、`*-result.json`
-を実行時に検証できます。
+`RESULT_SCHEMAS` は各検査 id に手書きの JSON Schema（draft 2020-12）を
+対応付けており、`*-result.json` を実行時に検証できます。正規化マッパー
+（`normalize*`）と `buildAuditResult` はパッケージルートから export されて
+いるため、保存済み結果の `details` から 4 区分をいつでも再導出できます。
 
 ## ライセンス
 

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).
 
@@ -49,7 +69,7 @@ test("axe audit", async ({ page }, testInfo) => {
     // outputFile: "axe-result.json", // optional override
     // tags: ["wcag2a", "wcag2aa", "wcag21aa", "wcag22aa"],
   });
-  expect(result.violationCount).toBe(0);
+  expect(result.summary.violationCount).toBe(0);
 });
 ```
 
@@ -68,7 +88,7 @@ test("focus indicators", async ({ browser }, testInfo) => {
     screenshot: true,                 // default: false
     // contextOptions: { locale: "ja-JP" }, // forwarded to browser.newContext()
   });
-  expect(result.elementsWithoutFocusStyle).toBe(0);
+  expect(result.details.elementsWithoutFocusStyle).toBe(0);
 });
 ```
 
@@ -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
@@ -115,6 +138,52 @@ TEST_PAGE=https://example.com A11Y_OUTPUT_DIR=./a11y-results npx playwright test
 > `**/node_modules/@a11y-skills/audit/dist/test-entries/*.js` finds no tests.
 > The one-line re-export specs above are the supported way to run the entries.
 
+## Result format
+
+Every check returns — and saves as JSON — the same axe-style envelope:
+
+```ts
+interface AuditCheckResult<TDetails> {
+  source: CheckSource;            // e.g. "reflow-check"
+  url: string;
+  timestamp: string;
+  violations: NormalizedRuleResult[];   // confirmed findings
+  incomplete: NormalizedRuleResult[];   // needs manual review
+  passes: NormalizedRuleResult[];       // rules that ran and found nothing
+  inapplicable: NormalizedRuleResult[]; // nothing to examine
+  summary: { violationCount; incompleteCount; passCount; checkedNodes? };
+  details: TDetails;              // check-specific evidence (measurements, screenshots, ...)
+  disclaimer: { ... };
+}
+```
+
+Each rule result is axe-shaped (`id` / `impact` / `description` / `help` /
+`helpUrl` / `tags` / `nodes[]`, with `nodes[].target` / `html` /
+`htmlTruncated` / `failureSummary`). Custom rules are namespaced
+(`a11y-skills/focus-visible`, `a11y-skills/target-size-minimum`, ...) and
+tagged with accurate WCAG version/level tags (`wcag2aa`, `wcag21aa`,
+`wcag22aa`, `wcag247`-style SC tags).
+
+**Classification is conservative.** A finding lands in `violations` only when
+the detection has no blind spot and no WCAG exception can apply (on-focus
+context change, text-spacing clipping, invalid autocomplete tokens). All other
+detections — reflow/zoom overflow, meta refresh, orientation lock, missing
+focus styles, undersized targets — are `incomplete`: treat that bucket as the
+manual-review queue, not as noise.
+
+To combine several checks for the same page into one view:
+
+```ts
+import { mergeNormalizedResults } from "@a11y-skills/audit";
+
+const merged = mergeNormalizedResults([axeResult, reflowResult, targetResult]);
+```
+
+`mergeNormalizedResults` throws on URL mismatches, deduplicates nodes by
+`target` + `failureSummary`, and resolves a rule appearing in several buckets
+by priority (`violations > incomplete > passes > inapplicable`). Identical
+selectors inside different frames or shadow roots are not distinguished.
+
 ## Result types & schemas
 
 ```ts
@@ -122,8 +191,11 @@ import type { AxeAuditResult, FocusCheckResult } from "@a11y-skills/audit/schema
 import { RESULT_SCHEMAS } from "@a11y-skills/audit/schemas";
 ```
 
-`RESULT_SCHEMAS` maps each check id to a hand-written JSON Schema for validating
-the `*-result.json` files at runtime.
+`RESULT_SCHEMAS` maps each check id to a hand-written JSON Schema
+(draft 2020-12) for validating the `*-result.json` files at runtime. The
+normalization mappers (`normalize*`) and `buildAuditResult` are exported from
+the package root, so the buckets can be re-derived from a saved result's
+`details` at any time.
 
 ## License
 

package/dist/constants.d.ts

@@ -14,6 +14,8 @@ export declare const AUDIT_DISCLAIMER: {
 };
 /** Console disclaimer message */
 export declare const DISCLAIMER_CONSOLE = "\nNote: Automated testing detects only ~30-40% of WCAG issues.\n      Manual testing is required for complete accessibility evaluation.\n";
+/** Maximum length of `NormalizedNode.html` / detail `html` snippets. */
+export declare const HTML_SNIPPET_MAX_LENGTH = 300;
 /** Default axe-core tag set (WCAG 2.0/2.1/2.2 A & AA) */
 export declare const DEFAULT_AXE_TAGS: readonly ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa", "wcag22aa"];
 /** CSS properties to check for focus style changes */
@@ -86,3 +88,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;