@masup9/a11y-audit 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to `@masup9/a11y-audit` are documented here. This project
+adheres to [Semantic Versioning](https://semver.org/).
+
+## 0.1.0
+
+Initial preview release. The function API may change before `1.0.0` based on
+downstream feedback.
+
+### Added
+
+- `runAxeAudit` — axe-core broad WCAG coverage (2.0/2.1/2.2 A & AA).
+- `runFocusIndicatorCheck` — WCAG 2.4.7 / 2.4.12 / 3.2.1 (owns its browser
+  context; supports `contextOptions`).
+- `runReflowCheck` — WCAG 1.4.10.
+- `runTargetSizeCheck` — WCAG 2.5.5 / 2.5.8.
+- Compatibility `test-entries/*`, run via a one-line local re-export spec
+  (`TEST_PAGE` / `A11Y_OUTPUT_DIR`). Note: Playwright excludes `node_modules`
+  from test collection, so a `testMatch` glob into `node_modules` finds no
+  tests — use the re-export spec instead.
+- `schemas` subpath: result types + hand-written JSON Schemas.
+- Output path resolution: `outputDir` option → `A11Y_OUTPUT_DIR` env →
+  `process.cwd()`, with `outputPath`/`outputDir` exclusivity (promoted from
+  the downstream `resolveOutputPath` improvement).
+
+### Notes
+
+- Ported from the `auditing-wcag` skill's vendor scripts, including the
+  downstream strict-TS fix in the focus check.
+- Screenshots default to `false` in the function API; the compatibility entries
+  enable them to preserve legacy behavior.
+- Phase 2 checks (text-spacing / zoom-200 / orientation / autocomplete /
+  time-limit / auto-play) are out of scope for this release.

package/README.ja.md

@@ -0,0 +1,128 @@
+# @masup9/a11y-audit
+
+Playwright + axe-core ベースの WCAG 2.2 アクセシビリティ検査関数。
+
+本パッケージは [`auditing-wcag`](https://github.com/masuP9/a11y-specialist-skills)
+Claude Code skill から機能本体を切り出したものです。4 つの検査を関数として提供し、
+すぐ実行できる Playwright 用の互換 test entry も同梱します。
+
+> **English: see [README.md](./README.md).**
+
+> **スコープ.** 自動テストで検出できるのは WCAG 違反の約 30〜40% です。完全な準拠確認には
+> 手動テストが必須です。本パッケージはその一部を自動化します。
+
+## 検査一覧 (v0.1.0)
+
+| 関数 | WCAG |
+| --- | --- |
+| `runAxeAudit` | axe-core による広範な検出 (2.0/2.1/2.2 A & AA) |
+| `runFocusIndicatorCheck` | 2.4.7 フォーカスの可視化 / 2.4.12 フォーカスの非遮蔽 / 3.2.1 オンフォーカス |
+| `runReflowCheck` | 1.4.10 リフロー |
+| `runTargetSizeCheck` | 2.5.5 / 2.5.8 ターゲットのサイズ |
+
+## インストール
+
+```sh
+npm install -D @masup9/a11y-audit @playwright/test @axe-core/playwright
+```
+
+`@playwright/test` と `@axe-core/playwright` は **peer dependencies** です。
+
+> ESM 専用です。CommonJS ビルドは同梱しません。ESM（または ESM 出力の TypeScript）から
+> import してください。
+
+## 使い方 — 関数 API（推奨）
+
+ページの遷移は呼び出し側で行い、関数は検査の実行・結果 JSON の書き出し・結果オブジェクトの
+return を担います。
+
+```ts
+import { test } from "@playwright/test";
+import { runAxeAudit } from "@masup9/a11y-audit/playwright";
+
+test("axe audit", async ({ page }, testInfo) => {
+  await page.goto("https://example.com");
+  const result = await runAxeAudit({
+    page,
+    outputDir: testInfo.outputDir,   // axe-result.json の出力先
+    // outputFile: "axe-result.json", // 任意で上書き
+    // tags: ["wcag2a", "wcag2aa", "wcag21aa", "wcag22aa"],
+  });
+  expect(result.violationCount).toBe(0);
+});
+```
+
+フォーカス表示検査は、フォーカスで遷移が起きた際に新しい context で再試行するため、
+自身の browser context を所有します。そのため `page` ではなく `browser` と `targetUrl`
+を受け取ります。
+
+```ts
+import { runFocusIndicatorCheck } from "@masup9/a11y-audit/playwright";
+
+test("focus indicators", async ({ browser }, testInfo) => {
+  const result = await runFocusIndicatorCheck({
+    browser,
+    targetUrl: "https://example.com", // または TEST_PAGE 環境変数
+    outputDir: testInfo.outputDir,
+    screenshot: true,                 // 既定: false
+    // contextOptions: { locale: "ja-JP" }, // browser.newContext() に転送
+  });
+  expect(result.elementsWithoutFocusStyle).toBe(0);
+});
+```
+
+### 出力先の解決順
+
+各検査共通:
+
+1. `outputPath` — フルパス（`outputDir`/`outputFile` とは排他）。
+2. それ以外は `outputDir` → `A11Y_OUTPUT_DIR` 環境変数 → `process.cwd()` に、
+   `outputFile` → 各検査の既定ファイル名を結合。
+
+スクリーンショット（有効時）は結果ファイルの隣に書き出します。`outputFile` はファイル名のみ
+指定可能です。絶対パスを使う場合は `outputPath` を使ってください。
+
+> **リフローの注意.** `runReflowCheck` は自身で狭い viewport を設定するため、遷移済みの
+> page でも動作します。load 時にのみ viewport を読むページでは、legacy スクリプトと完全に
+> 同じ結果を得るために `page.goto(...)` の**前**に viewport を設定してください（互換 entry
+> はこれを行っています）。
+
+## 使い方 — 互換 test entry
+
+テスト本体を書きたくない場合は、同梱 entry を 1 行のローカル spec から re-export します。
+entry は import 時に `test(...)` を呼び、`TEST_PAGE`（対象 URL）と `A11Y_OUTPUT_DIR`
+（出力先）を読み、スクリーンショットも撮ります（従来スクリプトと同等の挙動）。
+
+```ts
+// tests/a11y/axe.spec.ts
+import "@masup9/a11y-audit/test-entries/axe-audit";
+// tests/a11y/focus.spec.ts
+import "@masup9/a11y-audit/test-entries/focus-indicator-check";
+// tests/a11y/reflow.spec.ts
+import "@masup9/a11y-audit/test-entries/reflow-check";
+// tests/a11y/target-size.spec.ts
+import "@masup9/a11y-audit/test-entries/target-size-check";
+```
+
+```sh
+TEST_PAGE=https://example.com A11Y_OUTPUT_DIR=./a11y-results npx playwright test
+```
+
+> **`node_modules` への `testMatch` が使えない理由.** Playwright はテスト収集から
+> `node_modules` を除外するため、`**/node_modules/@masup9/a11y-audit/dist/test-entries/*.js`
+> を `testMatch` に指定してもテストは見つかりません。上記の 1 行 re-export spec が
+> entry を実行する正式な方法です。
+
+## 結果型とスキーマ
+
+```ts
+import type { AxeAuditResult, FocusCheckResult } from "@masup9/a11y-audit/schemas";
+import { RESULT_SCHEMAS } from "@masup9/a11y-audit/schemas";
+```
+
+`RESULT_SCHEMAS` は各検査 id に手書きの JSON Schema を対応付けており、`*-result.json`
+を実行時に検証できます。
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,130 @@
+# @masup9/a11y-audit
+
+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
+test entries.
+
+> **日本語版は [README.ja.md](./README.ja.md) を参照してください。**
+
+> **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)
+
+| Function | WCAG |
+| --- | --- |
+| `runAxeAudit` | axe-core broad coverage (2.0/2.1/2.2 A & AA) |
+| `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 |
+
+## Install
+
+```sh
+npm install -D @masup9/a11y-audit @playwright/test @axe-core/playwright
+```
+
+`@playwright/test` and `@axe-core/playwright` are **peer dependencies**.
+
+> ESM only. This package does not ship a CommonJS build; import it from ESM
+> (or a TypeScript project compiled to ESM).
+
+## Usage — function API (recommended)
+
+You navigate the page; the function runs the check, writes a result JSON, and
+returns the parsed result.
+
+```ts
+import { test } from "@playwright/test";
+import { runAxeAudit } from "@masup9/a11y-audit/playwright";
+
+test("axe audit", async ({ page }, testInfo) => {
+  await page.goto("https://example.com");
+  const result = await runAxeAudit({
+    page,
+    outputDir: testInfo.outputDir,   // where to write axe-result.json
+    // outputFile: "axe-result.json", // optional override
+    // tags: ["wcag2a", "wcag2aa", "wcag21aa", "wcag22aa"],
+  });
+  expect(result.violationCount).toBe(0);
+});
+```
+
+The focus indicator check owns its browser context (it restarts in a fresh
+context when focus triggers a navigation), so it takes a `browser` and a
+`targetUrl` instead of a `page`:
+
+```ts
+import { runFocusIndicatorCheck } from "@masup9/a11y-audit/playwright";
+
+test("focus indicators", async ({ browser }, testInfo) => {
+  const result = await runFocusIndicatorCheck({
+    browser,
+    targetUrl: "https://example.com", // or set TEST_PAGE env var
+    outputDir: testInfo.outputDir,
+    screenshot: true,                 // default: false
+    // contextOptions: { locale: "ja-JP" }, // forwarded to browser.newContext()
+  });
+  expect(result.elementsWithoutFocusStyle).toBe(0);
+});
+```
+
+### Output location resolution
+
+For every check:
+
+1. `outputPath` — full path (mutually exclusive with `outputDir`/`outputFile`).
+2. otherwise `outputDir` → `A11Y_OUTPUT_DIR` env → `process.cwd()`, joined with
+   `outputFile` → the check's default filename.
+
+Screenshots (when enabled) are written next to the result file. `outputFile`
+must be a bare filename; use `outputPath` for an absolute location.
+
+> **Reflow note.** `runReflowCheck` sets the narrow viewport itself, so it works
+> on an already-navigated page. For pages that read the viewport only at load
+> time, set the viewport *before* `page.goto(...)` for results identical to the
+> legacy script (the compatibility entry does this).
+
+## Usage — compatibility test entries
+
+If you prefer not to write test bodies, re-export the bundled entries from a
+one-line local spec. The entries call `test(...)` at import time and read
+`TEST_PAGE` (target URL) and `A11Y_OUTPUT_DIR` (output directory), capturing
+screenshots — reproducing the legacy script behavior.
+
+```ts
+// tests/a11y/axe.spec.ts
+import "@masup9/a11y-audit/test-entries/axe-audit";
+// tests/a11y/focus.spec.ts
+import "@masup9/a11y-audit/test-entries/focus-indicator-check";
+// tests/a11y/reflow.spec.ts
+import "@masup9/a11y-audit/test-entries/reflow-check";
+// tests/a11y/target-size.spec.ts
+import "@masup9/a11y-audit/test-entries/target-size-check";
+```
+
+```sh
+TEST_PAGE=https://example.com A11Y_OUTPUT_DIR=./a11y-results npx playwright test
+```
+
+> **Why not `testMatch` into `node_modules`?** Playwright excludes
+> `node_modules` from test collection, so pointing `testMatch` at
+> `**/node_modules/@masup9/a11y-audit/dist/test-entries/*.js` finds no tests.
+> The one-line re-export specs above are the supported way to run the entries.
+
+## Result types & schemas
+
+```ts
+import type { AxeAuditResult, FocusCheckResult } from "@masup9/a11y-audit/schemas";
+import { RESULT_SCHEMAS } from "@masup9/a11y-audit/schemas";
+```
+
+`RESULT_SCHEMAS` maps each check id to a hand-written JSON Schema for validating
+the `*-result.json` files at runtime.
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Constants for the WCAG audit checks shipped in @masup9/a11y-audit.
+ *
+ * Only the constants used by the four checks (axe / focus indicator / reflow /
+ * target size) are included here. Constants for the Phase 2 checks remain in the
+ * skill repository until those checks are ported.
+ */
+/** Disclaimer to include in all audit results */
+export declare const AUDIT_DISCLAIMER: {
+    readonly message: "自動テストで検出できるのはWCAG違反の一部です。完全な準拠確認には手動テストが必須です。";
+    readonly messageEn: "Automated testing can only detect a subset of WCAG violations. Manual testing is required for full compliance.";
+    readonly coverage: "approximately 30-40%";
+    readonly moreInfo: "https://www.w3.org/WAI/test-evaluate/preliminary/";
+};
+/** 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";
+/** 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 */
+export declare const FOCUS_STYLE_PROPERTIES: readonly ["outline", "outlineStyle", "outlineColor", "outlineWidth", "outlineOffset", "boxShadow", "backgroundColor"];
+/** Selector for focusable elements */
+export declare const FOCUSABLE_SELECTOR: string;
+/** Extra tab iterations for safety margin */
+export declare const EXTRA_TAB_ITERATIONS = 10;
+/**
+ * Minimum overlap ratio to report as obscured (0-1)
+ * 0.2 means 20% of the focused element must be covered
+ */
+export declare const FOCUS_OBSCURED_MIN_OVERLAP_RATIO = 0.2;
+/**
+ * Minimum overlap area in pixels to report
+ * Ignores tiny overlaps (e.g., 1px border touches)
+ */
+export declare const FOCUS_OBSCURED_MIN_OVERLAP_PX = 8;
+/**
+ * Selectors to exclude from obscurer detection
+ * These elements should not be considered as obscurers
+ */
+export declare const FOCUS_OBSCURED_EXCLUDE_SELECTORS: readonly ["#focus-audit-overlay", ".focus-audit-box", "[data-focus-visited]"];
+/** Default screenshot filename for the focus indicator check */
+export declare const DEFAULT_FOCUS_SCREENSHOT_FILE = "focus-indicators.png";
+/** Default result filename for the focus indicator check */
+export declare const DEFAULT_FOCUS_RESULT_FILE = "focus-indicator-result.json";
+/** Default result filename for the axe audit */
+export declare const DEFAULT_AXE_RESULT_FILE = "axe-result.json";
+/** Default result filename for the reflow check */
+export declare const DEFAULT_REFLOW_RESULT_FILE = "reflow-result.json";
+/** Default screenshot filename for the reflow check */
+export declare const DEFAULT_REFLOW_SCREENSHOT_FILE = "reflow-screenshot.png";
+/** Default result filename for the target size check */
+export declare const DEFAULT_TARGET_SIZE_RESULT_FILE = "target-size-result.json";
+/** Default screenshot filename for the target size check */
+export declare const DEFAULT_TARGET_SIZE_SCREENSHOT_FILE = "target-size-screenshot.png";
+/** Viewport size for reflow test (320 CSS px width at 400% zoom equivalent) */
+export declare const REFLOW_VIEWPORT: {
+    readonly width: 320;
+    readonly height: 256;
+};
+/** Tolerance for overflow detection in pixels */
+export declare const REFLOW_OVERFLOW_TOLERANCE = 5;
+/** Selector for elements to check for overflow */
+export declare const REFLOW_CHECK_SELECTOR: string;
+/** Elements that are allowed to have horizontal scroll */
+export declare const REFLOW_ALLOWED_OVERFLOW_SELECTORS: readonly ["pre", "code", "table[role=\"presentation\"]", ".data-table", "[data-allow-scroll]"];
+/**
+ * Target Size thresholds in CSS pixels
+ * - AA (2.5.8 Minimum): 24x24 px
+ * - AAA (2.5.5 Enhanced): 44x44 px
+ */
+export declare const TARGET_SIZE_AA = 24;
+export declare const TARGET_SIZE_AAA = 44;
+/**
+ * Selector for interactive elements (tap/click targets)
+ * Includes all elements that users may tap/click to perform actions
+ */
+export declare const INTERACTIVE_SELECTOR: string;
+/**
+ * Tags that indicate inline context (for inline exception)
+ */
+export declare const INLINE_CONTEXT_TAGS: readonly ["p", "li", "dd", "td", "th", "span", "blockquote", "cite", "figcaption"];
+/**
+ * Native input types controlled by user agent (for ua-control exception)
+ */
+export declare const UA_CONTROLLED_INPUT_TYPES: readonly ["checkbox", "radio", "range", "color", "date", "datetime-local", "month", "week", "time", "file"];
+/**
+ * Minimum text length around inline link to qualify for inline exception
+ */
+export declare const INLINE_CONTEXT_MIN_TEXT = 10;

package/dist/constants.js

@@ -0,0 +1,184 @@
+/**
+ * Constants for the WCAG audit checks shipped in @masup9/a11y-audit.
+ *
+ * Only the constants used by the four checks (axe / focus indicator / reflow /
+ * target size) are included here. Constants for the Phase 2 checks remain in the
+ * skill repository until those checks are ported.
+ */
+// =============================================================================
+// Common Disclaimer
+// =============================================================================
+/** Disclaimer to include in all audit results */
+export const AUDIT_DISCLAIMER = {
+    message: '自動テストで検出できるのはWCAG違反の一部です。完全な準拠確認には手動テストが必須です。',
+    messageEn: 'Automated testing can only detect a subset of WCAG violations. Manual testing is required for full compliance.',
+    coverage: 'approximately 30-40%',
+    moreInfo: 'https://www.w3.org/WAI/test-evaluate/preliminary/',
+};
+/** Console disclaimer message */
+export const DISCLAIMER_CONSOLE = `
+Note: Automated testing detects only ~30-40% of WCAG issues.
+      Manual testing is required for complete accessibility evaluation.
+`;
+// =============================================================================
+// Axe Audit defaults (broad WCAG coverage)
+// =============================================================================
+/** Default axe-core tag set (WCAG 2.0/2.1/2.2 A & AA) */
+export const DEFAULT_AXE_TAGS = [
+    'wcag2a',
+    'wcag2aa',
+    'wcag21a',
+    'wcag21aa',
+    'wcag22aa',
+];
+// =============================================================================
+// Focus Indicator Detection Constants (WCAG 2.4.7)
+// =============================================================================
+/** CSS properties to check for focus style changes */
+export const FOCUS_STYLE_PROPERTIES = [
+    'outline',
+    'outlineStyle',
+    'outlineColor',
+    'outlineWidth',
+    'outlineOffset',
+    'boxShadow',
+    'backgroundColor',
+];
+/** Selector for focusable elements */
+export const FOCUSABLE_SELECTOR = `
+  input:not([type="hidden"]):not([disabled]),
+  select:not([disabled]),
+  textarea:not([disabled]),
+  button:not([disabled]),
+  a[href],
+  [tabindex]:not([tabindex="-1"])
+`.trim();
+/** Extra tab iterations for safety margin */
+export const EXTRA_TAB_ITERATIONS = 10;
+// =============================================================================
+// Focus Obscured Detection Constants (WCAG 2.4.12)
+// =============================================================================
+/**
+ * Minimum overlap ratio to report as obscured (0-1)
+ * 0.2 means 20% of the focused element must be covered
+ */
+export const FOCUS_OBSCURED_MIN_OVERLAP_RATIO = 0.2;
+/**
+ * Minimum overlap area in pixels to report
+ * Ignores tiny overlaps (e.g., 1px border touches)
+ */
+export const FOCUS_OBSCURED_MIN_OVERLAP_PX = 8;
+/**
+ * Selectors to exclude from obscurer detection
+ * These elements should not be considered as obscurers
+ */
+export const FOCUS_OBSCURED_EXCLUDE_SELECTORS = [
+    '#focus-audit-overlay',
+    '.focus-audit-box',
+    '[data-focus-visited]',
+];
+// =============================================================================
+// Output filename defaults
+// =============================================================================
+/** Default screenshot filename for the focus indicator check */
+export const DEFAULT_FOCUS_SCREENSHOT_FILE = 'focus-indicators.png';
+/** Default result filename for the focus indicator check */
+export const DEFAULT_FOCUS_RESULT_FILE = 'focus-indicator-result.json';
+/** Default result filename for the axe audit */
+export const DEFAULT_AXE_RESULT_FILE = 'axe-result.json';
+/** Default result filename for the reflow check */
+export const DEFAULT_REFLOW_RESULT_FILE = 'reflow-result.json';
+/** Default screenshot filename for the reflow check */
+export const DEFAULT_REFLOW_SCREENSHOT_FILE = 'reflow-screenshot.png';
+/** Default result filename for the target size check */
+export const DEFAULT_TARGET_SIZE_RESULT_FILE = 'target-size-result.json';
+/** Default screenshot filename for the target size check */
+export const DEFAULT_TARGET_SIZE_SCREENSHOT_FILE = 'target-size-screenshot.png';
+// =============================================================================
+// Reflow Check Constants (WCAG 1.4.10)
+// =============================================================================
+/** Viewport size for reflow test (320 CSS px width at 400% zoom equivalent) */
+export const REFLOW_VIEWPORT = { width: 320, height: 256 };
+/** Tolerance for overflow detection in pixels */
+export const REFLOW_OVERFLOW_TOLERANCE = 5;
+/** Selector for elements to check for overflow */
+export const REFLOW_CHECK_SELECTOR = `
+  p, h1, h2, h3, h4, h5, h6, li, td, th, span, div, section, article,
+  a, button, input, select, textarea, label,
+  img, svg, table, nav, header, footer, main, aside
+`.trim();
+/** Elements that are allowed to have horizontal scroll */
+export const REFLOW_ALLOWED_OVERFLOW_SELECTORS = [
+    'pre',
+    'code',
+    'table[role="presentation"]',
+    '.data-table',
+    '[data-allow-scroll]',
+];
+// =============================================================================
+// Target Size Check Constants (WCAG 2.5.5 / 2.5.8)
+// =============================================================================
+/**
+ * Target Size thresholds in CSS pixels
+ * - AA (2.5.8 Minimum): 24x24 px
+ * - AAA (2.5.5 Enhanced): 44x44 px
+ */
+export const TARGET_SIZE_AA = 24;
+export const TARGET_SIZE_AAA = 44;
+/**
+ * Selector for interactive elements (tap/click targets)
+ * Includes all elements that users may tap/click to perform actions
+ */
+export const INTERACTIVE_SELECTOR = `
+  a[href],
+  button:not([disabled]),
+  input:not([type="hidden"]):not([disabled]),
+  select:not([disabled]),
+  textarea:not([disabled]),
+  [role="button"]:not([aria-disabled="true"]),
+  [role="link"]:not([aria-disabled="true"]),
+  [role="checkbox"]:not([aria-disabled="true"]),
+  [role="radio"]:not([aria-disabled="true"]),
+  [role="switch"]:not([aria-disabled="true"]),
+  [role="menuitem"]:not([aria-disabled="true"]),
+  [role="tab"]:not([aria-disabled="true"]),
+  [role="slider"]:not([aria-disabled="true"]),
+  [role="option"]:not([aria-disabled="true"]),
+  [tabindex]:not([tabindex="-1"]):not([disabled]),
+  summary,
+  label[for],
+  [onclick]:not([disabled])
+`.trim();
+/**
+ * Tags that indicate inline context (for inline exception)
+ */
+export const INLINE_CONTEXT_TAGS = [
+    'p',
+    'li',
+    'dd',
+    'td',
+    'th',
+    'span',
+    'blockquote',
+    'cite',
+    'figcaption',
+];
+/**
+ * Native input types controlled by user agent (for ua-control exception)
+ */
+export const UA_CONTROLLED_INPUT_TYPES = [
+    'checkbox',
+    'radio',
+    'range',
+    'color',
+    'date',
+    'datetime-local',
+    'month',
+    'week',
+    'time',
+    'file',
+];
+/**
+ * Minimum text length around inline link to qualify for inline exception
+ */
+export const INLINE_CONTEXT_MIN_TEXT = 10;

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @masup9/a11y-audit
+ *
+ * Playwright + axe-core based WCAG 2.2 accessibility audit functions.
+ *
+ * - Main subpath (`@masup9/a11y-audit`): shared types & constants.
+ * - `@masup9/a11y-audit/playwright`: the `runXxx()` function API.
+ * - `@masup9/a11y-audit/test-entries/*`: ready-to-run compatibility entries,
+ *   run via a one-line local re-export spec (`import "...test-entries/axe-audit"`).
+ * - `@masup9/a11y-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';

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @masup9/a11y-audit
+ *
+ * Playwright + axe-core based WCAG 2.2 accessibility audit functions.
+ *
+ * - Main subpath (`@masup9/a11y-audit`): shared types & constants.
+ * - `@masup9/a11y-audit/playwright`: the `runXxx()` function API.
+ * - `@masup9/a11y-audit/test-entries/*`: ready-to-run compatibility entries,
+ *   run via a one-line local re-export spec (`import "...test-entries/axe-audit"`).
+ * - `@masup9/a11y-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';

package/dist/playwright/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Function API for the WCAG audit checks.
+ *
+ * Import these to wire the checks into your own Playwright tests:
+ *
+ * ```ts
+ * import { runAxeAudit } from "@masup9/a11y-audit/playwright";
+ *
+ * test("axe", async ({ page }, testInfo) => {
+ *   await page.goto(url);
+ *   await runAxeAudit({ page, outputDir: testInfo.outputDir });
+ * });
+ * ```
+ */
+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';

package/dist/playwright/index.js

@@ -0,0 +1,19 @@
+/**
+ * Function API for the WCAG audit checks.
+ *
+ * Import these to wire the checks into your own Playwright tests:
+ *
+ * ```ts
+ * import { runAxeAudit } from "@masup9/a11y-audit/playwright";
+ *
+ * test("axe", async ({ page }, testInfo) => {
+ *   await page.goto(url);
+ *   await runAxeAudit({ page, outputDir: testInfo.outputDir });
+ * });
+ * ```
+ */
+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';

package/dist/playwright/runAxeAudit.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Axe-core Accessibility Audit (broad WCAG coverage)
+ *
+ * Runs axe-core automated accessibility testing on the *current* page. The
+ * caller is responsible for navigating the page (e.g. `await page.goto(url)`)
+ * before calling this function.
+ *
+ * Axe-core cannot detect all accessibility issues — manual testing and the
+ * other checks in this package are still needed for complete coverage.
+ */
+import type { Page } from '@playwright/test';
+import type { AxeAuditResult } from '../types.js';
+import { type OutputLocationOptions } from '../utils/test-harness.js';
+export interface RunAxeAuditOptions extends OutputLocationOptions {
+    /** A page already navigated to the target URL. */
+    page: Page;
+    /** axe-core tags to run with (default: WCAG 2.0/2.1/2.2 A & AA). */
+    tags?: readonly string[];
+    /** axe rule overrides, forwarded to `AxeBuilder.options({ rules })`. */
+    rules?: Record<string, {
+        enabled: boolean;
+    }>;
+}
+/**
+ * Run an axe-core audit against the current page, write the result JSON, and
+ * return the parsed result.
+ */
+export declare function runAxeAudit(options: RunAxeAuditOptions): Promise<AxeAuditResult>;