@kiwa-test/a11y 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cardene777
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,86 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  expectNoViolations: () => expectNoViolations,
+  reportViolations: () => reportViolations,
+  runAxe: () => runAxe
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/audit.ts
+var IMPACT_ORDER = {
+  minor: 0,
+  moderate: 1,
+  serious: 2,
+  critical: 3
+};
+async function loadAxeCore() {
+  try {
+    const mod = await import("axe-core");
+    return mod.default ?? mod;
+  } catch {
+    throw new Error('runAxe requires "axe-core" to be installed. Run `pnpm add -D axe-core`.');
+  }
+}
+async function runAxe(opts = {}) {
+  const axe = await loadAxeCore();
+  const ctx = opts.context ?? (typeof document !== "undefined" ? document : void 0);
+  if (ctx === void 0) {
+    throw new Error("runAxe: no context and no global document (jsdom env required).");
+  }
+  return axe.run(ctx, opts.runOptions ?? {});
+}
+function reportViolations(results, opts = {}) {
+  const maxImpact = opts.maxImpact ?? "minor";
+  const threshold = IMPACT_ORDER[maxImpact];
+  const blocking = results.violations.filter((v) => {
+    if (!v.impact) return false;
+    return IMPACT_ORDER[v.impact] >= threshold;
+  });
+  const summary = blocking.length === 0 ? `No a11y violations at impact >= "${maxImpact}".` : `${blocking.length} a11y violation(s) at impact >= "${maxImpact}":
+` + blocking.map((v) => `  - [${v.impact}] ${v.id}: ${v.help} (${v.nodes.length} node(s))`).join("\n");
+  return { violations: results.violations, blocking, summary };
+}
+function expectNoViolations(results, expect, opts = {}) {
+  const report = reportViolations(results, opts);
+  if (report.blocking.length > 0) {
+    throw new Error(report.summary);
+  }
+  expect(report.blocking.length).toBe(0);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  expectNoViolations,
+  reportViolations,
+  runAxe
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/audit.ts"],"sourcesContent":["export type {\n  AxeViolation,\n  AxeResults,\n  AxeRunModule,\n  AuditOptions,\n} from './types.js';\nexport {\n  runAxe,\n  reportViolations,\n  expectNoViolations,\n  type ViolationReport,\n} from './audit.js';\n","import type {\n  AuditOptions,\n  AxeResults,\n  AxeRunModule,\n  AxeViolation,\n} from './types.js';\n\nconst IMPACT_ORDER: Record<NonNullable<AxeViolation['impact']>, number> = {\n  minor: 0,\n  moderate: 1,\n  serious: 2,\n  critical: 3,\n};\n\nasync function loadAxeCore(): Promise<AxeRunModule> {\n  try {\n    const mod = (await import('axe-core')) as unknown as { default?: AxeRunModule } & AxeRunModule;\n    return mod.default ?? mod;\n  } catch {\n    throw new Error('runAxe requires \"axe-core\" to be installed. Run `pnpm add -D axe-core`.');\n  }\n}\n\nexport async function runAxe(opts: AuditOptions = {}): Promise<AxeResults> {\n  const axe = await loadAxeCore();\n  const ctx =\n    opts.context ?? (typeof document !== 'undefined' ? document : undefined);\n  if (ctx === undefined) {\n    throw new Error('runAxe: no context and no global document (jsdom env required).');\n  }\n  return axe.run(ctx as Element | Document | string, opts.runOptions ?? {});\n}\n\nexport interface ViolationReport {\n  violations: AxeViolation[];\n  blocking: AxeViolation[];\n  summary: string;\n}\n\nexport function reportViolations(\n  results: AxeResults,\n  opts: { maxImpact?: AuditOptions['maxImpact'] } = {},\n): ViolationReport {\n  const maxImpact = opts.maxImpact ?? 'minor';\n  const threshold = IMPACT_ORDER[maxImpact];\n  const blocking = results.violations.filter((v) => {\n    if (!v.impact) return false;\n    return IMPACT_ORDER[v.impact] >= threshold;\n  });\n  const summary = blocking.length === 0\n    ? `No a11y violations at impact >= \"${maxImpact}\".`\n    : `${blocking.length} a11y violation(s) at impact >= \"${maxImpact}\":\\n` +\n      blocking.map((v) => `  - [${v.impact}] ${v.id}: ${v.help} (${v.nodes.length} node(s))`).join('\\n');\n  return { violations: results.violations, blocking, summary };\n}\n\nexport function expectNoViolations(\n  results: AxeResults,\n  expect: { (actual: unknown): { toBe: (expected: unknown) => void } },\n  opts: { maxImpact?: AuditOptions['maxImpact'] } = {},\n): void {\n  const report = reportViolations(results, opts);\n  if (report.blocking.length > 0) {\n    throw new Error(report.summary);\n  }\n  expect(report.blocking.length).toBe(0);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,IAAM,eAAoE;AAAA,EACxE,OAAO;AAAA,EACP,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AACZ;AAEA,eAAe,cAAqC;AAClD,MAAI;AACF,UAAM,MAAO,MAAM,OAAO,UAAU;AACpC,WAAO,IAAI,WAAW;AAAA,EACxB,QAAQ;AACN,UAAM,IAAI,MAAM,yEAAyE;AAAA,EAC3F;AACF;AAEA,eAAsB,OAAO,OAAqB,CAAC,GAAwB;AACzE,QAAM,MAAM,MAAM,YAAY;AAC9B,QAAM,MACJ,KAAK,YAAY,OAAO,aAAa,cAAc,WAAW;AAChE,MAAI,QAAQ,QAAW;AACrB,UAAM,IAAI,MAAM,iEAAiE;AAAA,EACnF;AACA,SAAO,IAAI,IAAI,KAAoC,KAAK,cAAc,CAAC,CAAC;AAC1E;AAQO,SAAS,iBACd,SACA,OAAkD,CAAC,GAClC;AACjB,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,YAAY,aAAa,SAAS;AACxC,QAAM,WAAW,QAAQ,WAAW,OAAO,CAAC,MAAM;AAChD,QAAI,CAAC,EAAE,OAAQ,QAAO;AACtB,WAAO,aAAa,EAAE,MAAM,KAAK;AAAA,EACnC,CAAC;AACD,QAAM,UAAU,SAAS,WAAW,IAChC,oCAAoC,SAAS,OAC7C,GAAG,SAAS,MAAM,oCAAoC,SAAS;AAAA,IAC/D,SAAS,IAAI,CAAC,MAAM,QAAQ,EAAE,MAAM,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,MAAM,MAAM,WAAW,EAAE,KAAK,IAAI;AACrG,SAAO,EAAE,YAAY,QAAQ,YAAY,UAAU,QAAQ;AAC7D;AAEO,SAAS,mBACd,SACA,QACA,OAAkD,CAAC,GAC7C;AACN,QAAM,SAAS,iBAAiB,SAAS,IAAI;AAC7C,MAAI,OAAO,SAAS,SAAS,GAAG;AAC9B,UAAM,IAAI,MAAM,OAAO,OAAO;AAAA,EAChC;AACA,SAAO,OAAO,SAAS,MAAM,EAAE,KAAK,CAAC;AACvC;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,54 @@
+interface AxeViolation {
+    id: string;
+    impact: 'minor' | 'moderate' | 'serious' | 'critical' | null;
+    description: string;
+    help: string;
+    helpUrl: string;
+    nodes: Array<{
+        target: string[];
+        html: string;
+        failureSummary?: string;
+    }>;
+}
+interface AxeResults {
+    violations: AxeViolation[];
+    passes: Array<{
+        id: string;
+    }>;
+    incomplete: Array<{
+        id: string;
+    }>;
+    inapplicable: Array<{
+        id: string;
+    }>;
+}
+interface AuditOptions {
+    /** Element / selector / Document to scan (default: document) */
+    context?: Element | Document | string;
+    /** axe-core run options (passed verbatim) */
+    runOptions?: Record<string, unknown>;
+    /** Maximum impact level allowed before reportViolations throws */
+    maxImpact?: 'minor' | 'moderate' | 'serious' | 'critical';
+}
+interface AxeRunModule {
+    run: (context?: Element | Document | string, options?: Record<string, unknown>) => Promise<AxeResults>;
+}
+
+declare function runAxe(opts?: AuditOptions): Promise<AxeResults>;
+interface ViolationReport {
+    violations: AxeViolation[];
+    blocking: AxeViolation[];
+    summary: string;
+}
+declare function reportViolations(results: AxeResults, opts?: {
+    maxImpact?: AuditOptions['maxImpact'];
+}): ViolationReport;
+declare function expectNoViolations(results: AxeResults, expect: {
+    (actual: unknown): {
+        toBe: (expected: unknown) => void;
+    };
+}, opts?: {
+    maxImpact?: AuditOptions['maxImpact'];
+}): void;
+
+export { type AuditOptions, type AxeResults, type AxeRunModule, type AxeViolation, type ViolationReport, expectNoViolations, reportViolations, runAxe };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+interface AxeViolation {
+    id: string;
+    impact: 'minor' | 'moderate' | 'serious' | 'critical' | null;
+    description: string;
+    help: string;
+    helpUrl: string;
+    nodes: Array<{
+        target: string[];
+        html: string;
+        failureSummary?: string;
+    }>;
+}
+interface AxeResults {
+    violations: AxeViolation[];
+    passes: Array<{
+        id: string;
+    }>;
+    incomplete: Array<{
+        id: string;
+    }>;
+    inapplicable: Array<{
+        id: string;
+    }>;
+}
+interface AuditOptions {
+    /** Element / selector / Document to scan (default: document) */
+    context?: Element | Document | string;
+    /** axe-core run options (passed verbatim) */
+    runOptions?: Record<string, unknown>;
+    /** Maximum impact level allowed before reportViolations throws */
+    maxImpact?: 'minor' | 'moderate' | 'serious' | 'critical';
+}
+interface AxeRunModule {
+    run: (context?: Element | Document | string, options?: Record<string, unknown>) => Promise<AxeResults>;
+}
+
+declare function runAxe(opts?: AuditOptions): Promise<AxeResults>;
+interface ViolationReport {
+    violations: AxeViolation[];
+    blocking: AxeViolation[];
+    summary: string;
+}
+declare function reportViolations(results: AxeResults, opts?: {
+    maxImpact?: AuditOptions['maxImpact'];
+}): ViolationReport;
+declare function expectNoViolations(results: AxeResults, expect: {
+    (actual: unknown): {
+        toBe: (expected: unknown) => void;
+    };
+}, opts?: {
+    maxImpact?: AuditOptions['maxImpact'];
+}): void;
+
+export { type AuditOptions, type AxeResults, type AxeRunModule, type AxeViolation, type ViolationReport, expectNoViolations, reportViolations, runAxe };

package/dist/index.js

@@ -0,0 +1,47 @@
+// src/audit.ts
+var IMPACT_ORDER = {
+  minor: 0,
+  moderate: 1,
+  serious: 2,
+  critical: 3
+};
+async function loadAxeCore() {
+  try {
+    const mod = await import("axe-core");
+    return mod.default ?? mod;
+  } catch {
+    throw new Error('runAxe requires "axe-core" to be installed. Run `pnpm add -D axe-core`.');
+  }
+}
+async function runAxe(opts = {}) {
+  const axe = await loadAxeCore();
+  const ctx = opts.context ?? (typeof document !== "undefined" ? document : void 0);
+  if (ctx === void 0) {
+    throw new Error("runAxe: no context and no global document (jsdom env required).");
+  }
+  return axe.run(ctx, opts.runOptions ?? {});
+}
+function reportViolations(results, opts = {}) {
+  const maxImpact = opts.maxImpact ?? "minor";
+  const threshold = IMPACT_ORDER[maxImpact];
+  const blocking = results.violations.filter((v) => {
+    if (!v.impact) return false;
+    return IMPACT_ORDER[v.impact] >= threshold;
+  });
+  const summary = blocking.length === 0 ? `No a11y violations at impact >= "${maxImpact}".` : `${blocking.length} a11y violation(s) at impact >= "${maxImpact}":
+` + blocking.map((v) => `  - [${v.impact}] ${v.id}: ${v.help} (${v.nodes.length} node(s))`).join("\n");
+  return { violations: results.violations, blocking, summary };
+}
+function expectNoViolations(results, expect, opts = {}) {
+  const report = reportViolations(results, opts);
+  if (report.blocking.length > 0) {
+    throw new Error(report.summary);
+  }
+  expect(report.blocking.length).toBe(0);
+}
+export {
+  expectNoViolations,
+  reportViolations,
+  runAxe
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/audit.ts"],"sourcesContent":["import type {\n  AuditOptions,\n  AxeResults,\n  AxeRunModule,\n  AxeViolation,\n} from './types.js';\n\nconst IMPACT_ORDER: Record<NonNullable<AxeViolation['impact']>, number> = {\n  minor: 0,\n  moderate: 1,\n  serious: 2,\n  critical: 3,\n};\n\nasync function loadAxeCore(): Promise<AxeRunModule> {\n  try {\n    const mod = (await import('axe-core')) as unknown as { default?: AxeRunModule } & AxeRunModule;\n    return mod.default ?? mod;\n  } catch {\n    throw new Error('runAxe requires \"axe-core\" to be installed. Run `pnpm add -D axe-core`.');\n  }\n}\n\nexport async function runAxe(opts: AuditOptions = {}): Promise<AxeResults> {\n  const axe = await loadAxeCore();\n  const ctx =\n    opts.context ?? (typeof document !== 'undefined' ? document : undefined);\n  if (ctx === undefined) {\n    throw new Error('runAxe: no context and no global document (jsdom env required).');\n  }\n  return axe.run(ctx as Element | Document | string, opts.runOptions ?? {});\n}\n\nexport interface ViolationReport {\n  violations: AxeViolation[];\n  blocking: AxeViolation[];\n  summary: string;\n}\n\nexport function reportViolations(\n  results: AxeResults,\n  opts: { maxImpact?: AuditOptions['maxImpact'] } = {},\n): ViolationReport {\n  const maxImpact = opts.maxImpact ?? 'minor';\n  const threshold = IMPACT_ORDER[maxImpact];\n  const blocking = results.violations.filter((v) => {\n    if (!v.impact) return false;\n    return IMPACT_ORDER[v.impact] >= threshold;\n  });\n  const summary = blocking.length === 0\n    ? `No a11y violations at impact >= \"${maxImpact}\".`\n    : `${blocking.length} a11y violation(s) at impact >= \"${maxImpact}\":\\n` +\n      blocking.map((v) => `  - [${v.impact}] ${v.id}: ${v.help} (${v.nodes.length} node(s))`).join('\\n');\n  return { violations: results.violations, blocking, summary };\n}\n\nexport function expectNoViolations(\n  results: AxeResults,\n  expect: { (actual: unknown): { toBe: (expected: unknown) => void } },\n  opts: { maxImpact?: AuditOptions['maxImpact'] } = {},\n): void {\n  const report = reportViolations(results, opts);\n  if (report.blocking.length > 0) {\n    throw new Error(report.summary);\n  }\n  expect(report.blocking.length).toBe(0);\n}\n"],"mappings":";AAOA,IAAM,eAAoE;AAAA,EACxE,OAAO;AAAA,EACP,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AACZ;AAEA,eAAe,cAAqC;AAClD,MAAI;AACF,UAAM,MAAO,MAAM,OAAO,UAAU;AACpC,WAAO,IAAI,WAAW;AAAA,EACxB,QAAQ;AACN,UAAM,IAAI,MAAM,yEAAyE;AAAA,EAC3F;AACF;AAEA,eAAsB,OAAO,OAAqB,CAAC,GAAwB;AACzE,QAAM,MAAM,MAAM,YAAY;AAC9B,QAAM,MACJ,KAAK,YAAY,OAAO,aAAa,cAAc,WAAW;AAChE,MAAI,QAAQ,QAAW;AACrB,UAAM,IAAI,MAAM,iEAAiE;AAAA,EACnF;AACA,SAAO,IAAI,IAAI,KAAoC,KAAK,cAAc,CAAC,CAAC;AAC1E;AAQO,SAAS,iBACd,SACA,OAAkD,CAAC,GAClC;AACjB,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,YAAY,aAAa,SAAS;AACxC,QAAM,WAAW,QAAQ,WAAW,OAAO,CAAC,MAAM;AAChD,QAAI,CAAC,EAAE,OAAQ,QAAO;AACtB,WAAO,aAAa,EAAE,MAAM,KAAK;AAAA,EACnC,CAAC;AACD,QAAM,UAAU,SAAS,WAAW,IAChC,oCAAoC,SAAS,OAC7C,GAAG,SAAS,MAAM,oCAAoC,SAAS;AAAA,IAC/D,SAAS,IAAI,CAAC,MAAM,QAAQ,EAAE,MAAM,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,MAAM,MAAM,WAAW,EAAE,KAAK,IAAI;AACrG,SAAO,EAAE,YAAY,QAAQ,YAAY,UAAU,QAAQ;AAC7D;AAEO,SAAS,mBACd,SACA,QACA,OAAkD,CAAC,GAC7C;AACN,QAAM,SAAS,iBAAiB,SAAS,IAAI;AAC7C,MAAI,OAAO,SAAS,SAAS,GAAG;AAC9B,UAAM,IAAI,MAAM,OAAO,OAAO;AAAA,EAChC;AACA,SAAO,OAAO,SAAS,MAAM,EAAE,KAAK,CAAC;AACvC;","names":[]}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@kiwa-test/a11y",
+  "version": "0.1.0",
+  "description": "Accessibility (a11y) test adapter for kiwa — axe-core integration for jsdom + Playwright pages",
+  "license": "MIT",
+  "author": {
+    "name": "cardene",
+    "url": "https://github.com/cardene777"
+  },
+  "keywords": [
+    "kiwa",
+    "a11y",
+    "axe",
+    "accessibility",
+    "testing",
+    "wcag"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cardene777/kiwa.git",
+    "directory": "packages/a11y"
+  },
+  "homepage": "https://github.com/cardene777/kiwa#readme",
+  "bugs": {
+    "url": "https://github.com/cardene777/kiwa/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@kiwa-test/spec": "0.1.0"
+  },
+  "peerDependencies": {
+    "axe-core": "^4",
+    "jsdom": "^25",
+    "vitest": "^2"
+  },
+  "peerDependenciesMeta": {
+    "jsdom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "axe-core": "^4.10.2",
+    "jsdom": "^25.0.1",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "node -e \"require('node:fs').rmSync('.vitest-dist',{recursive:true,force:true})\" && tsc -p tsconfig.vitest.json && vitest run .vitest-dist/tests --environment jsdom",
+    "test:cov": "node -e \"require('node:fs').rmSync('.vitest-dist',{recursive:true,force:true})\" && tsc -p tsconfig.vitest.json && vitest run .vitest-dist/tests --environment jsdom --coverage --coverage.provider=v8 --coverage.reporter=json --coverage.reporter=json-summary --coverage.reporter=text --coverage.reportsDirectory=coverage --coverage.include='.vitest-dist/src/audit.js' --coverage.include='.vitest-dist/src/index.js' --coverage.exclude='.vitest-dist/tests/**'",
+    "typecheck": "tsc --noEmit"
+  }
+}