aria-ease 6.10.0 → 6.12.0

package/bin/chunk-XERMSYEH.js

@@ -1,363 +0,0 @@
-// src/utils/test/contract/contract.json
-var contract_default = {
-  menu: {
-    path: "./aria-contracts/menu/menu.contract.json",
-    component: "menu"
-  },
-  "combobox.listbox": {
-    path: "./aria-contracts/combobox/combobox.listbox.contract.json",
-    component: "combobox.listbox"
-  },
-  accordion: {
-    path: "./aria-contracts/accordion/accordion.contract.json",
-    component: "accordion"
-  },
-  tabs: {
-    path: "./aria-contracts/tabs/tabs.contract.json",
-    component: "tabs"
-  }
-};
-
-// src/utils/test/src/ContractReporter.ts
-var ContractReporter = class {
-  startTime = 0;
-  componentName = "";
-  staticPasses = 0;
-  staticFailures = 0;
-  staticWarnings = 0;
-  dynamicResults = [];
-  totalTests = 0;
-  skipped = 0;
-  warnings = 0;
-  isPlaywright = false;
-  isCustomContract = false;
-  apgUrl = "https://www.w3.org/WAI/ARIA/apg/";
-  hasPrintedStaticSection = false;
-  hasPrintedDynamicSection = false;
-  constructor(isPlaywright = false, isCustomContract = false) {
-    this.isPlaywright = isPlaywright;
-    this.isCustomContract = isCustomContract;
-  }
-  log(message) {
-    process.stderr.write(message + "\n");
-  }
-  start(componentName, totalTests, apgUrl) {
-    this.startTime = Date.now();
-    this.componentName = componentName;
-    this.totalTests = totalTests;
-    this.hasPrintedStaticSection = false;
-    this.hasPrintedDynamicSection = false;
-    if (apgUrl) {
-      this.apgUrl = apgUrl;
-    }
-    const mode = this.isPlaywright ? "Playwright (Real Browser)" : "jsdom (Fast)";
-    this.log(`
-${"\u2550".repeat(60)}`);
-    this.log(`\u{1F50D} Testing ${componentName.charAt(0).toUpperCase() + componentName.slice(1)} Component - ${mode}`);
-    this.log(`${"\u2550".repeat(60)}
-`);
-  }
-  reportStatic(passes, failures, warnings = 0) {
-    this.staticPasses = passes;
-    this.staticFailures = failures;
-    this.staticWarnings = warnings;
-  }
-  /**
-   * Report individual static test pass
-   */
-  reportStaticTest(description, status, failureMessage, level) {
-    if (!this.hasPrintedStaticSection) {
-      this.log(`${"\u2500".repeat(60)}`);
-      this.log(`\u{1F9EA} Static Assertions`);
-      this.log(`${"\u2500".repeat(60)}`);
-      this.hasPrintedStaticSection = true;
-    }
-    const icon = status === "pass" ? "\u2713" : status === "warn" ? "\u26A0" : status === "skip" ? "\u25CB" : "\u2717";
-    this.log(`  ${icon} ${description}`);
-    if (level) {
-      this.log(`     \u21B3 level=${level}`);
-    }
-    if ((status === "fail" || status === "warn" || status === "skip") && failureMessage) {
-      this.log(`     \u21B3 ${failureMessage}`);
-    }
-  }
-  /**
-   * Report individual dynamic test result
-   */
-  reportTest(test, status, failureMessage) {
-    if (!this.hasPrintedDynamicSection) {
-      this.log("");
-      this.log(`${"\u2500".repeat(60)}`);
-      this.log(`\u2328\uFE0F Dynamic Interaction Tests`);
-      this.log(`${"\u2500".repeat(60)}`);
-      this.hasPrintedDynamicSection = true;
-    }
-    const result = {
-      description: test.description,
-      status,
-      failureMessage,
-      level: test.level
-    };
-    if (status === "skip") {
-      result.skipReason = "Requires real browser (addEventListener events)";
-    }
-    this.dynamicResults.push(result);
-    const icons = { pass: "\u2713", fail: "\u2717", warn: "\u26A0", skip: "\u25CB" };
-    const levelPrefix = test.level ? `[${test.level.toUpperCase()}] ` : "";
-    this.log(`  ${icons[status]} ${levelPrefix}${test.description}`);
-    if (status === "skip" && !this.isPlaywright) {
-      this.log(`     \u21B3 Skipped in jsdom (runs in Playwright)`);
-    }
-    if (status === "fail" && failureMessage) {
-      this.log(`     \u21B3 ${failureMessage}`);
-    }
-    if (status === "warn" && failureMessage) {
-      this.log(`     \u21B3 ${failureMessage}`);
-    }
-    if (status === "skip" && failureMessage) {
-      this.log(`     \u21B3 ${failureMessage}`);
-    }
-  }
-  /**
-   * Report all failures with actionable context
-   */
-  reportFailures(failures) {
-    if (failures.length === 0) return;
-    this.log(`
-${"\u2500".repeat(60)}`);
-    this.log(`\u274C Failures (${failures.length}):
-`);
-    failures.forEach((failure, index) => {
-      this.log(`${index + 1}. ${failure}`);
-      if (failure.includes("aria-")) {
-        this.log(`   \u{1F4A1} Add the missing ARIA attribute to improve screen reader support`);
-      } else if (failure.includes("focus")) {
-        this.log(`   \u{1F4A1} Check keyboard event handlers and focus management`);
-      } else if (failure.includes("visible")) {
-        this.log(`   \u{1F4A1} Verify display/visibility styles and state management`);
-      }
-      this.log("");
-    });
-  }
-  reportWarnings() {
-    const warnings = this.dynamicResults.filter((r) => r.status === "warn");
-    if (warnings.length === 0 && this.staticWarnings === 0) return;
-    this.log(`
-${"\u2500".repeat(60)}`);
-    this.log(`\u26A0\uFE0F Warnings (${this.staticWarnings + warnings.length}):
-`);
-    this.log(`These checks are failing but treated as warnings under the active strictness mode.
-`);
-    warnings.forEach((test, index) => {
-      this.log(`${index + 1}. ${test.description}`);
-      if (test.failureMessage) {
-        this.log(`   \u21B3 ${test.failureMessage}`);
-      }
-      if (test.level) {
-        this.log(`   \u21B3 level=${test.level}`);
-      }
-    });
-    if (this.apgUrl) {
-      this.log(`
-Reference: ${this.apgUrl}
-`);
-    }
-  }
-  /**
-   * Report skipped tests with helpful context
-   */
-  reportSkipped() {
-    if (this.skipped === 0 || this.isPlaywright) return;
-    const skippedTests = this.dynamicResults.filter((r) => r.status === "skip");
-    this.log(`
-${"\u2500".repeat(60)}`);
-    this.log(`\u2139\uFE0F  Skipped Tests (${this.skipped}):
-`);
-    this.log(`These tests use native keyboard events via addEventListener,`);
-    this.log(`which jsdom cannot simulate. They run successfully in Playwright.
-`);
-    skippedTests.forEach((test, index) => {
-      this.log(`${index + 1}. ${test.description}`);
-    });
-    this.log(`
-\u{1F4A1} Run with Playwright for full validation:`);
-    this.log(`   testUiComponent('${this.componentName}', null, 'http://localhost:5173/test-harness?component=component_name')
-`);
-  }
-  /**
-   * Generate final summary with statistics
-   */
-  summary(failures) {
-    const duration = Date.now() - this.startTime;
-    const dynamicPasses = this.dynamicResults.filter((r) => r.status === "pass").length;
-    const dynamicFailures = this.dynamicResults.filter((r) => r.status === "fail").length;
-    const dynamicWarnings = this.dynamicResults.filter((r) => r.status === "warn").length;
-    this.skipped = this.dynamicResults.filter((r) => r.status === "skip").length;
-    this.warnings = this.staticWarnings + dynamicWarnings;
-    const totalPasses = this.staticPasses + dynamicPasses;
-    const totalFailures = this.staticFailures + dynamicFailures;
-    const totalRun = totalPasses + totalFailures + this.warnings;
-    const getComponentMessage = () => {
-      const componentDisplayName = `${this.componentName.charAt(0).toUpperCase()}${this.componentName.slice(1)}`;
-      if (this.isCustomContract) {
-        return `${componentDisplayName} component validates against your custom accessibility policy \u2713`;
-      }
-      return `${componentDisplayName} component meets Aria-Ease baseline WAI-ARIA expectations \u2713`;
-    };
-    if (failures.length > 0) {
-      this.reportFailures(failures);
-    }
-    this.reportWarnings();
-    this.reportSkipped();
-    this.log(`
-${"\u2550".repeat(60)}`);
-    this.log(`\u{1F4CA} Summary
-`);
-    if (totalFailures === 0 && this.skipped === 0 && this.warnings === 0) {
-      this.log(`\u2705 All ${totalRun} tests passed!`);
-      this.log(`   ${getComponentMessage()}`);
-    } else if (totalFailures === 0) {
-      this.log(`\u2705 ${totalPasses}/${totalRun} tests passed`);
-      if (this.skipped > 0) {
-        this.log(`\u25CB  ${this.skipped} tests skipped`);
-      }
-      if (this.warnings > 0) {
-        this.log(`\u26A0\uFE0F ${this.warnings} warning${this.warnings > 1 ? "s" : ""}`);
-      }
-      this.log(`   ${getComponentMessage()}`);
-    } else {
-      this.log(`\u274C ${totalFailures} test${totalFailures > 1 ? "s" : ""} failed`);
-      this.log(`\u2705 ${totalPasses} test${totalPasses > 1 ? "s" : ""} passed`);
-      if (this.warnings > 0) {
-        this.log(`\u26A0\uFE0F ${this.warnings} warning${this.warnings > 1 ? "s" : ""}`);
-      }
-      if (this.skipped > 0) {
-        this.log(`\u25CB  ${this.skipped} test${this.skipped > 1 ? "s" : ""} skipped`);
-      }
-    }
-    this.log(`\u23F1\uFE0F  Duration: ${duration}ms`);
-    this.log(`${"\u2550".repeat(60)}
-`);
-    if (totalFailures > 0) {
-      this.log(`\u{1F527} Next Steps:`);
-      this.log(`   1. Review the failures above`);
-      this.log(`   2. Fix ARIA attributes and keyboard handlers`);
-      this.log(`   3. Re-run tests to verify fixes
-`);
-    } else if (!this.isPlaywright && this.skipped > 0) {
-      this.log(`\u2728 Optional: Run Playwright tests for complete validation
-`);
-    }
-    return {
-      passes: totalPasses,
-      failures: totalFailures,
-      skipped: this.skipped,
-      duration
-    };
-  }
-  /**
-   * Report an error during test execution
-   */
-  error(message, context) {
-    this.log(`
-\u274C Error: ${message}`);
-    if (context) {
-      this.log(`   Context: ${context}`);
-    }
-    this.log("");
-  }
-};
-
-// src/utils/test/src/strictness.ts
-var FALLBACK_LEVEL = "required";
-function normalizeLevel(level) {
-  if (level === "required" || level === "recommended" || level === "optional") {
-    return level;
-  }
-  return FALLBACK_LEVEL;
-}
-function normalizeStrictness(strictness) {
-  if (strictness === "minimal" || strictness === "balanced" || strictness === "strict" || strictness === "paranoid") {
-    return strictness;
-  }
-  return "balanced";
-}
-function resolveEnforcement(level, strictness) {
-  const matrix = {
-    minimal: {
-      required: "error",
-      recommended: "ignore",
-      optional: "ignore"
-    },
-    balanced: {
-      required: "error",
-      recommended: "warning",
-      optional: "ignore"
-    },
-    strict: {
-      required: "error",
-      recommended: "error",
-      optional: "warning"
-    },
-    paranoid: {
-      required: "error",
-      recommended: "error",
-      optional: "error"
-    }
-  };
-  return matrix[strictness][level];
-}
-
-// src/utils/test/src/playwrightTestHarness.ts
-import { chromium } from "playwright";
-var sharedBrowser = null;
-var sharedContext = null;
-async function getOrCreateBrowser() {
-  if (!sharedBrowser) {
-    sharedBrowser = await chromium.launch({
-      headless: true,
-      // Launch with clean browser profile - no extensions, no user data
-      args: [
-        "--disable-extensions",
-        "--disable-blink-features=AutomationControlled"
-      ]
-    });
-  }
-  return sharedBrowser;
-}
-async function getOrCreateContext() {
-  if (!sharedContext) {
-    const browser = await getOrCreateBrowser();
-    sharedContext = await browser.newContext({
-      // Isolated context - no permissions, no geolocation, etc.
-      permissions: [],
-      // Ignore HTTPS errors for local dev servers
-      ignoreHTTPSErrors: true
-    });
-  }
-  return sharedContext;
-}
-async function createTestPage() {
-  const context = await getOrCreateContext();
-  return await context.newPage();
-}
-async function closeSharedBrowser() {
-  if (sharedContext) {
-    await sharedContext.close();
-    sharedContext = null;
-  }
-  if (sharedBrowser) {
-    await sharedBrowser.close();
-    sharedBrowser = null;
-  }
-}
-
-export {
-  contract_default,
-  ContractReporter,
-  normalizeLevel,
-  normalizeStrictness,
-  resolveEnforcement,
-  createTestPage,
-  closeSharedBrowser
-};

package/dist/src/utils/test/aria-contracts/accordion/accordion.contract.json

@@ -1,290 +0,0 @@
-{
-    "meta": {
-        "id": "aria-ease.contract.accordion",
-        "version": "1.0.0",
-        "created": "09-02-2026",
-        "lastUpdated": "19-03-2026",
-        "description": "ARIA Accordion interaction contract. Validates the ARIA and interaction contract for a custom accordion component following the ARIA Authoring Practices Guide accordion with show/hide pattern.",
-        "source": {
-            "apg": "https://www.w3.org/WAI/ARIA/apg/patterns/accordion/",
-            "wcag": ["2.2 AA"]
-        },
-        "W3CName": "Accordion"
-    },
-
-    "selectors": {
-        "trigger": "[data-accordion] [aria-controls][aria-expanded], [aria-controls][aria-expanded]",
-        "focusable": "[data-accordion] [aria-controls][aria-expanded], [aria-controls][aria-expanded]",
-        "relative": "[data-accordion] [aria-controls][aria-expanded], [aria-controls][aria-expanded]",
-        "panel": "[role='region'][aria-labelledby], [role='region'][aria-labelledby]"
-    },
-
-    "observables": {
-        "observable": "focus | visible | attribute | role",
-        "target": "trigger | relative | panel | focusable",
-        "relative": "first | last | next | previous"
-    },
-
-    "relationships": [
-        {
-            "type": "aria-reference",
-            "from": "trigger",
-            "attribute": "aria-controls",
-            "to": "panel"
-        },
-        {
-            "type": "aria-reference",
-            "from": "panel",
-            "attribute": "aria-labelledby",
-            "to": "trigger"
-        }
-    ],
-
-    "static": [
-        {
-            "assertions": [
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "true | false",
-                    "failureMessage": "Accordion trigger button doesn't conform to the ARIA Accordion Button pattern as specified in APG 1.2. Accordion trigger button should have 'aria-expanded=true | false' attribute. This helps assistive technology to keep track of the open or close state of the accordion panel div that the button controls."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-controls",
-                    "failureMessage": "Accordion trigger button doesn't conform to the ARIA Accordion Button pattern as specified in APG 1.2. Accordion trigger button should have 'aria-controls' attribute that points to the id of the accordion panel div it controls with 'role=region'. This helps assistive technology to identify the accordion panel div that the button controls."
-                },
-                {
-                    "target": "panel",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-labelledby | aria-label",
-                    "failureMessage": "Accordion panel doesn't conform to the ARIA Accordion pattern as specified in APG 1.2. Accordion panel should have 'aria-labelledby' attribute that points to the id of the trigger button that controls it."
-                }
-            ]
-        }
-    ],
-
-    "dynamic": [
-        {
-            "description": "Clicking the trigger expands a collapsed panel.",
-            "action": [
-                { "type": "click", "target": "trigger" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "toBeVisible",
-                    "failureMessage": "Panel should be visible after clicking the trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "true",
-                    "failureMessage": "Trigger's aria-expanded attribute should be true after clicking to expand."
-                }
-            ]
-        },
-        {
-            "description": "Clicking the trigger again collapses an expanded panel.",
-            "action": [
-                { "type": "click", "target": "trigger" },
-                { "type": "click", "target": "trigger" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "notToBeVisible",
-                    "failureMessage": "Panel should not be visible after clicking the trigger twice."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "false",
-                    "failureMessage": "Trigger's aria-expanded attribute should be false after collapsing."
-                }
-            ]
-        },
-        {
-            "description": "Pressing Enter on trigger expands a collapsed panel.",
-            "action": [
-                { "type": "keypress", "target": "trigger", "key": "Enter" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "toBeVisible",
-                    "failureMessage": "Panel should be visible after pressing Enter on trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "true",
-                    "failureMessage": "Trigger's should have aria-expanded=true after pressing Enter."
-                }
-            ]
-        },
-        {
-            "description": "Pressing Space on trigger expands a collapsed panel.",
-            "action": [
-                { "type": "keypress", "target": "trigger", "key": "Space" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "toBeVisible",
-                    "failureMessage": "Panel should be visible after pressing Space on trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "true",
-                    "failureMessage": "Trigger's should have aria-expanded=true after pressing Space."
-                }
-            ]
-        },
-        {
-            "description": "Pressing Enter on trigger collapses an expanded panel.",
-            "action": [
-                { "type": "keypress", "target": "trigger", "key": "Enter" },
-                { "type": "keypress", "target": "trigger", "key": "Enter" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "notToBeVisible",
-                    "failureMessage": "Panel should not be visible after pressing Enter on expanded trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "false",
-                    "failureMessage": "Trigger's aria-expanded should be false after collapsing with Enter."
-                }
-            ]
-        },
-        {
-            "description": "Pressing Space on trigger collapses an expanded panel.",
-            "action": [
-                { "type": "keypress", "target": "trigger", "key": "Space" },
-                { "type": "keypress", "target": "trigger", "key": "Space" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "notToBeVisible",
-                    "failureMessage": "Panel should not be visible after pressing Space on expanded trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "false",
-                    "failureMessage": "Trigger's aria-expanded should be false after collapsing with Space."
-                }
-            ]
-        },
-        {
-            "description": "Down Arrow moves focus to next accordion trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "ArrowDown" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "second",
-                    "failureMessage": "Focus should move to the next accordion trigger after pressing Down Arrow."
-                }
-            ]
-        },
-        {
-            "description": "Up Arrow moves focus to previous accordion trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "ArrowUp" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "first",
-                    "failureMessage": "Focus should move to the previous accordion trigger after pressing Up Arrow."
-                }
-            ]
-        },
-        {
-            "description": "Home moves focus to first accordion trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "Home" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "first",
-                    "failureMessage": "Focus should move to the first accordion trigger after pressing Home."
-                }
-            ]
-        },
-        {
-            "description": "End moves focus to last accordion trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "End" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "last",
-                    "failureMessage": "Focus should move to the last accordion trigger after pressing End."
-                }
-            ]
-        },
-        {
-            "description": "Down Arrow wraps focus from last trigger to first trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "ArrowDown" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "first",
-                    "failureMessage": "Focus should wrap from last to first accordion trigger after pressing Down Arrow."
-                }
-            ]
-        },
-        {
-            "description": "Up Arrow wraps focus from first trigger to last trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "ArrowUp" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "last",
-                    "failureMessage": "Focus should wrap from first to last accordion trigger after pressing Up Arrow."
-                }
-            ]
-        }
-    ]
-}