@a13y/devtools 0.1.0

package/dist/runtime/invariants/index.js

@@ -0,0 +1,452 @@
+import { isDevelopment } from '@a13y/core/runtime/env';
+
+// @a13y/devtools - Development-time validators (tree-shakeable in production)
+
+
+// src/runtime/warnings/warning-system.ts
+var Styles = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  blue: "\x1B[34m",
+  cyan: "\x1B[36m",
+  gray: "\x1B[90m",
+  // Backgrounds
+  bgRed: "\x1B[41m",
+  bgYellow: "\x1B[43m",
+  bgBlue: "\x1B[44m"
+};
+var style = (text, ...styles) => {
+  return `${styles.join("")}${text}${Styles.reset}`;
+};
+var WarningSystemClass = class {
+  constructor() {
+    this.config = {
+      enabled: true,
+      minSeverity: "warn",
+      showElement: true,
+      showStackTrace: true,
+      deduplicate: true,
+      onWarning: () => {
+      }
+    };
+    this.warningCache = /* @__PURE__ */ new Set();
+  }
+  /**
+   * Configure the warning system
+   */
+  configure(config) {
+    this.config = { ...this.config, ...config };
+  }
+  /**
+   * Emit a warning
+   */
+  warn(warning) {
+    if (!this.config.enabled) {
+      return;
+    }
+    const severityLevel = { info: 0, warn: 1, error: 2 };
+    if (severityLevel[warning.severity] < severityLevel[this.config.minSeverity]) {
+      return;
+    }
+    if (this.config.deduplicate) {
+      const key = this.getWarningKey(warning);
+      if (this.warningCache.has(key)) {
+        return;
+      }
+      this.warningCache.add(key);
+    }
+    if (this.config.onWarning) {
+      this.config.onWarning(warning);
+    }
+    this.printWarning(warning);
+  }
+  /**
+   * Clear warning cache
+   */
+  clearCache() {
+    this.warningCache.clear();
+  }
+  /**
+   * Generate a unique key for a warning
+   */
+  getWarningKey(warning) {
+    const parts = [warning.code, warning.message];
+    if (warning.element) {
+      const tag = warning.element.tagName.toLowerCase();
+      const id = warning.element.id;
+      const classes = Array.from(warning.element.classList).join(".");
+      parts.push(`${tag}#${id}.${classes}`);
+    }
+    return parts.join("|");
+  }
+  /**
+   * Print warning to console
+   */
+  printWarning(warning) {
+    const { severity, code, category, message, element, wcag, fixes } = warning;
+    const badge = this.getSeverityBadge(severity);
+    console.group(
+      `${badge} ${style(code, Styles.bold, Styles.cyan)} ${style(category, Styles.dim)}`
+    );
+    console.log(style(message, Styles.bold));
+    if (element && this.config.showElement) {
+      console.log(style("\nElement:", Styles.bold));
+      console.log(element);
+    }
+    if (wcag) {
+      console.log(style("\nWCAG:", Styles.bold), `${wcag.criterion} (Level ${wcag.level})`);
+      console.log(style("Learn more:", Styles.blue), wcag.url);
+    }
+    if (fixes.length > 0) {
+      console.log(style("\nHow to fix:", Styles.bold, Styles.cyan));
+      fixes.forEach((fix, index) => {
+        console.log(`${index + 1}. ${fix.description}`);
+        if (fix.example) {
+          console.log(style("\n   Example:", Styles.dim));
+          console.log(style(`   ${fix.example}`, Styles.dim, Styles.gray));
+        }
+        if (fix.learnMoreUrl) {
+          console.log(style("   Learn more:", Styles.blue), fix.learnMoreUrl);
+        }
+      });
+    }
+    if (severity === "error" && this.config.showStackTrace) {
+      console.log(style("\nStack trace:", Styles.dim));
+      console.trace();
+    }
+    console.groupEnd();
+    console.log("");
+  }
+  /**
+   * Get severity badge for console
+   */
+  getSeverityBadge(severity) {
+    switch (severity) {
+      case "error":
+        return style(" ERROR ", Styles.bold, Styles.bgRed);
+      case "warn":
+        return style(" WARN ", Styles.bold, Styles.bgYellow);
+      case "info":
+        return style(" INFO ", Styles.bold, Styles.bgBlue);
+    }
+  }
+};
+var WarningSystem = new WarningSystemClass();
+var createWarning = (partial) => {
+  return {
+    fixes: [],
+    ...partial
+  };
+};
+
+// src/runtime/warnings/warning-types.ts
+var WarningCodes = {
+  // Focus Management (001-099)
+  FOCUS_LOST: "A13Y001",
+  // Keyboard Navigation (100-199)
+  NOT_KEYBOARD_ACCESSIBLE: "A13Y100",
+  MISSING_KEYBOARD_HANDLER: "A13Y101",
+  INVALID_TABINDEX: "A13Y102",
+  // Accessible Name (200-299)
+  MISSING_ACCESSIBLE_NAME: "A13Y200",
+  REDUNDANT_ARIA: "A13Y303",
+  MISSING_REQUIRED_ARIA: "A13Y304"};
+var WCAGUrls = {
+  "2.1.1": "https://www.w3.org/WAI/WCAG22/Understanding/keyboard.html",
+  "2.4.3": "https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html",
+  "4.1.2": "https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html"};
+
+// src/runtime/invariants/invariants.ts
+var invariant = (condition, message) => {
+  if (!isDevelopment()) {
+    return;
+  }
+  if (!condition) {
+    throw new Error(`[@a13y/devtools] Invariant violation: ${message}`);
+  }
+};
+var assertHasAccessibleName = (element, context) => {
+  if (!isDevelopment()) {
+    return;
+  }
+  import('@a13y/core/runtime/aria').then(({ getAccessibleName }) => {
+    const name = getAccessibleName(element);
+    if (!name || name.trim().length === 0) {
+      WarningSystem.warn(
+        createWarning({
+          code: WarningCodes.MISSING_ACCESSIBLE_NAME,
+          severity: "error",
+          category: "accessible-name",
+          message: `Element is missing an accessible name${context ? ` in ${context}` : ""}`,
+          element,
+          wcag: {
+            criterion: "4.1.2",
+            level: "A",
+            url: WCAGUrls["4.1.2"]
+          },
+          fixes: [
+            {
+              description: "Add an aria-label attribute",
+              example: `<${element.tagName.toLowerCase()} aria-label="Descriptive name">`
+            },
+            {
+              description: "Add text content",
+              example: `<${element.tagName.toLowerCase()}>Click me</${element.tagName.toLowerCase()}>`
+            },
+            {
+              description: "Use aria-labelledby to reference another element",
+              example: `<${element.tagName.toLowerCase()} aria-labelledby="label-id">`
+            }
+          ]
+        })
+      );
+    }
+  }).catch(() => {
+  });
+};
+var assertKeyboardAccessible = (element, context) => {
+  if (!isDevelopment()) {
+    return;
+  }
+  const isButton = element instanceof HTMLButtonElement;
+  const isLink = element instanceof HTMLAnchorElement && element.hasAttribute("href");
+  const isInput = element instanceof HTMLInputElement;
+  const hasTabindex = element.hasAttribute("tabindex");
+  const tabindex = hasTabindex ? parseInt(element.getAttribute("tabindex") || "0", 10) : -1;
+  const isAccessible = isButton || isLink || isInput || hasTabindex && tabindex >= 0;
+  if (!isAccessible) {
+    WarningSystem.warn(
+      createWarning({
+        code: WarningCodes.NOT_KEYBOARD_ACCESSIBLE,
+        severity: "error",
+        category: "keyboard-navigation",
+        message: `Element is not keyboard accessible${context ? ` in ${context}` : ""}`,
+        element,
+        wcag: {
+          criterion: "2.1.1",
+          level: "A",
+          url: WCAGUrls["2.1.1"]
+        },
+        fixes: [
+          {
+            description: "Use a semantic HTML element (button, a, input)",
+            example: `<button type="button">Click me</button>`
+          },
+          {
+            description: 'Add tabindex="0" to make it focusable',
+            example: `<${element.tagName.toLowerCase()} tabindex="0">`
+          },
+          {
+            description: "Add keyboard event handlers (Enter, Space)",
+            example: `element.addEventListener('keydown', (e) => {
+  if (e.key === 'Enter' || e.key === ' ') {
+    e.preventDefault();
+    // Handle activation
+  }
+});`
+          }
+        ]
+      })
+    );
+  }
+  const hasClickHandler = element.getAttribute("onclick") !== null;
+  if (hasClickHandler && !isButton && !isLink) {
+    WarningSystem.warn(
+      createWarning({
+        code: WarningCodes.MISSING_KEYBOARD_HANDLER,
+        severity: "warn",
+        category: "keyboard-navigation",
+        message: `Element has click handler but no keyboard handlers${context ? ` in ${context}` : ""}`,
+        element,
+        wcag: {
+          criterion: "2.1.1",
+          level: "A",
+          url: WCAGUrls["2.1.1"]
+        },
+        fixes: [
+          {
+            description: "Add onKeyDown handler for Enter and Space keys",
+            example: `const handleKeyDown = (e: KeyboardEvent) => {
+  if (e.key === 'Enter' || e.key === ' ') {
+    e.preventDefault();
+    onClick(e);
+  }
+};`
+          }
+        ]
+      })
+    );
+  }
+};
+var assertValidTabindex = (element) => {
+  if (!isDevelopment()) {
+    return;
+  }
+  const tabindex = element.getAttribute("tabindex");
+  if (tabindex === null) {
+    return;
+  }
+  const value = parseInt(tabindex, 10);
+  if (value > 0) {
+    WarningSystem.warn(
+      createWarning({
+        code: WarningCodes.INVALID_TABINDEX,
+        severity: "warn",
+        category: "keyboard-navigation",
+        message: `Positive tabindex (${value}) creates confusing tab order`,
+        element,
+        wcag: {
+          criterion: "2.4.3",
+          level: "A",
+          url: WCAGUrls["2.4.3"]
+        },
+        fixes: [
+          {
+            description: 'Use tabindex="0" to add element to natural tab order',
+            example: `<div tabindex="0">Focusable in natural order</div>`
+          },
+          {
+            description: 'Use tabindex="-1" to remove from tab order (programmatic focus only)',
+            example: `<div tabindex="-1">Not in tab order</div>`
+          },
+          {
+            description: "Restructure DOM to achieve desired focus order",
+            learnMoreUrl: "https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html"
+          }
+        ]
+      })
+    );
+  }
+};
+var assertValidAriaAttributes = (element) => {
+  if (!isDevelopment()) {
+    return;
+  }
+  const role = element.getAttribute("role");
+  const ariaAttributes = Array.from(element.attributes).filter(
+    (attr) => attr.name.startsWith("aria-")
+  );
+  if (!role && ariaAttributes.length > 0 && !isSemanticElement(element)) {
+    WarningSystem.warn(
+      createWarning({
+        code: WarningCodes.MISSING_REQUIRED_ARIA,
+        severity: "warn",
+        category: "aria-usage",
+        message: "Element has ARIA attributes but no explicit role",
+        element,
+        wcag: {
+          criterion: "4.1.2",
+          level: "A",
+          url: WCAGUrls["4.1.2"]
+        },
+        fixes: [
+          {
+            description: "Add an appropriate role attribute",
+            example: `<div role="button" aria-pressed="false">Toggle</div>`
+          },
+          {
+            description: "Use a semantic HTML element instead",
+            example: `<button aria-pressed="false">Toggle</button>`
+          }
+        ]
+      })
+    );
+  }
+  if (role && isSemanticElement(element)) {
+    const semanticRole = getImplicitRole(element);
+    if (role === semanticRole) {
+      WarningSystem.warn(
+        createWarning({
+          code: WarningCodes.REDUNDANT_ARIA,
+          severity: "info",
+          category: "aria-usage",
+          message: `Role "${role}" is redundant on <${element.tagName.toLowerCase()}>`,
+          element,
+          fixes: [
+            {
+              description: "Remove the redundant role attribute",
+              example: `<${element.tagName.toLowerCase()}> (role="${role}" is implicit)`
+            }
+          ]
+        })
+      );
+    }
+  }
+};
+var assertFocusVisible = (context) => {
+  if (!isDevelopment()) {
+    return;
+  }
+  setTimeout(() => {
+    const activeElement = document.activeElement;
+    if (!activeElement || activeElement === document.body) {
+      WarningSystem.warn(
+        createWarning({
+          code: WarningCodes.FOCUS_LOST,
+          severity: "warn",
+          category: "focus-management",
+          message: `Focus was lost${context ? ` after ${context}` : ""}`,
+          wcag: {
+            criterion: "2.4.3",
+            level: "A",
+            url: WCAGUrls["2.4.3"]
+          },
+          fixes: [
+            {
+              description: "Ensure focus is moved to an appropriate element",
+              example: `// After closing dialog
+const returnElement = document.getElementById('trigger-button');
+returnElement?.focus();`
+            },
+            {
+              description: "Use FocusManager to save and restore focus",
+              example: `import { FocusManager } from '@a13y/core/runtime/focus';
+
+const restore = FocusManager.saveFocus();
+// ... perform action ...
+restore();`
+            }
+          ]
+        })
+      );
+    }
+  }, 100);
+};
+var isSemanticElement = (element) => {
+  const tag = element.tagName.toLowerCase();
+  const semanticTags = [
+    "button",
+    "a",
+    "input",
+    "select",
+    "textarea",
+    "nav",
+    "main",
+    "article",
+    "section",
+    "header",
+    "footer",
+    "aside"
+  ];
+  return semanticTags.includes(tag);
+};
+var getImplicitRole = (element) => {
+  const tag = element.tagName.toLowerCase();
+  const roleMap = {
+    button: "button",
+    a: "link",
+    nav: "navigation",
+    main: "main",
+    article: "article",
+    section: "region",
+    header: "banner",
+    footer: "contentinfo",
+    aside: "complementary"
+  };
+  return roleMap[tag] || null;
+};
+
+export { assertFocusVisible, assertHasAccessibleName, assertKeyboardAccessible, assertValidAriaAttributes, assertValidTabindex, invariant };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/runtime/invariants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/warnings/warning-system.ts","../../../src/runtime/warnings/warning-types.ts","../../../src/runtime/invariants/invariants.ts"],"names":[],"mappings":";;;;;;AAUA,IAAM,MAAA,GAAS;AAAA,EACb,KAAA,EAAO,SAAA;AAAA,EACP,IAAA,EAAM,SAAA;AAAA,EACN,GAAA,EAAK,SAAA;AAAA,EAKL,IAAA,EAAM,UAAA;AAAA,EACN,IAAA,EAAM,UAAA;AAAA,EACN,IAAA,EAAM,UAAA;AAAA;AAAA,EAGN,KAAA,EAAO,UAAA;AAAA,EACP,QAAA,EAAU,UAAA;AAAA,EACV,MAAA,EAAQ;AACV,CAAA;AAKA,IAAM,KAAA,GAAQ,CAAC,IAAA,EAAA,GAAiB,MAAA,KAA6B;AAC3D,EAAA,OAAO,CAAA,EAAG,OAAO,IAAA,CAAK,EAAE,CAAC,CAAA,EAAG,IAAI,CAAA,EAAG,MAAA,CAAO,KAAK,CAAA,CAAA;AACjD,CAAA;AA6CA,IAAM,qBAAN,MAAyB;AAAA,EAAzB,WAAA,GAAA;AACE,IAAA,IAAA,CAAQ,MAAA,GAAwC;AAAA,MAC9C,OAAA,EAAS,IAAA;AAAA,MACT,WAAA,EAAa,MAAA;AAAA,MACb,WAAA,EAAa,IAAA;AAAA,MACb,cAAA,EAAgB,IAAA;AAAA,MAChB,WAAA,EAAa,IAAA;AAAA,MACb,WAAW,MAAM;AAAA,MAAC;AAAA,KACpB;AAEA,IAAA,IAAA,CAAQ,YAAA,uBAAmB,GAAA,EAAY;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAKvC,UAAU,MAAA,EAAmC;AAC3C,IAAA,IAAA,CAAK,SAAS,EAAE,GAAG,IAAA,CAAK,MAAA,EAAQ,GAAG,MAAA,EAAO;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,KAAK,OAAA,EAAqC;AACxC,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,CAAO,OAAA,EAAS;AACxB,MAAA;AAAA,IACF;AAGA,IAAA,MAAM,gBAAgB,EAAE,IAAA,EAAM,GAAG,IAAA,EAAM,CAAA,EAAG,OAAO,CAAA,EAAE;AACnD,IAAA,IAAI,aAAA,CAAc,QAAQ,QAAQ,CAAA,GAAI,cAAc,IAAA,CAAK,MAAA,CAAO,WAAW,CAAA,EAAG;AAC5E,MAAA;AAAA,IACF;AAGA,IAAA,IAAI,IAAA,CAAK,OAAO,WAAA,EAAa;AAC3B,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,aAAA,CAAc,OAAO,CAAA;AACtC,MAAA,IAAI,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,GAAG,CAAA,EAAG;AAC9B,QAAA;AAAA,MACF;AACA,MAAA,IAAA,CAAK,YAAA,CAAa,IAAI,GAAG,CAAA;AAAA,IAC3B;AAGA,IAAA,IAAI,IAAA,CAAK,OAAO,SAAA,EAAW;AACzB,MAAA,IAAA,CAAK,MAAA,CAAO,UAAU,OAAO,CAAA;AAAA,IAC/B;AAGA,IAAA,IAAA,CAAK,aAAa,OAAO,CAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,UAAA,GAAmB;AACjB,IAAA,IAAA,CAAK,aAAa,KAAA,EAAM;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAc,OAAA,EAAuC;AAC3D,IAAA,MAAM,KAAA,GAAQ,CAAC,OAAA,CAAQ,IAAA,EAAM,QAAQ,OAAO,CAAA;AAE5C,IAAA,IAAI,QAAQ,OAAA,EAAS;AAEnB,MAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,OAAA,CAAQ,OAAA,CAAQ,WAAA,EAAY;AAChD,MAAA,MAAM,EAAA,GAAK,QAAQ,OAAA,CAAQ,EAAA;AAC3B,MAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAQ,SAAS,CAAA,CAAE,KAAK,GAAG,CAAA;AAC9D,MAAA,KAAA,CAAM,KAAK,CAAA,EAAG,GAAG,IAAI,EAAE,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,CAAA;AAAA,IACtC;AAEA,IAAA,OAAO,KAAA,CAAM,KAAK,GAAG,CAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKQ,aAAa,OAAA,EAAqC;AACxD,IAAA,MAAM,EAAE,UAAU,IAAA,EAAM,QAAA,EAAU,SAAS,OAAA,EAAS,IAAA,EAAM,OAAM,GAAI,OAAA;AAGpE,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,gBAAA,CAAiB,QAAQ,CAAA;AAG5C,IAAA,OAAA,CAAQ,KAAA;AAAA,MACN,CAAA,EAAG,KAAK,CAAA,CAAA,EAAI,KAAA,CAAM,MAAM,MAAA,CAAO,IAAA,EAAM,MAAA,CAAO,IAAI,CAAC,CAAA,CAAA,EAAI,KAAA,CAAM,QAAA,EAAU,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,KAClF;AAGA,IAAA,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,OAAA,EAAS,MAAA,CAAO,IAAI,CAAC,CAAA;AAGvC,IAAA,IAAI,OAAA,IAAW,IAAA,CAAK,MAAA,CAAO,WAAA,EAAa;AACtC,MAAA,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,YAAA,EAAc,MAAA,CAAO,IAAI,CAAC,CAAA;AAC5C,MAAA,OAAA,CAAQ,IAAI,OAAO,CAAA;AAAA,IACrB;AAGA,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,SAAA,EAAW,MAAA,CAAO,IAAI,CAAA,EAAG,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA,QAAA,EAAW,IAAA,CAAK,KAAK,CAAA,CAAA,CAAG,CAAA;AACpF,MAAA,OAAA,CAAQ,IAAI,KAAA,CAAM,aAAA,EAAe,OAAO,IAAI,CAAA,EAAG,KAAK,GAAG,CAAA;AAAA,IACzD;AAGA,IAAA,IAAI,KAAA,CAAM,SAAS,CAAA,EAAG;AACpB,MAAA,OAAA,CAAQ,IAAI,KAAA,CAAM,eAAA,EAAiB,OAAO,IAAA,EAAM,MAAA,CAAO,IAAI,CAAC,CAAA;AAC5D,MAAA,KAAA,CAAM,OAAA,CAAQ,CAAC,GAAA,EAAK,KAAA,KAAU;AAC5B,QAAA,OAAA,CAAQ,IAAI,CAAA,EAAG,KAAA,GAAQ,CAAC,CAAA,EAAA,EAAK,GAAA,CAAI,WAAW,CAAA,CAAE,CAAA;AAE9C,QAAA,IAAI,IAAI,OAAA,EAAS;AACf,UAAA,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,eAAA,EAAiB,MAAA,CAAO,GAAG,CAAC,CAAA;AAC9C,UAAA,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,CAAA,GAAA,EAAM,GAAA,CAAI,OAAO,IAAI,MAAA,CAAO,GAAA,EAAK,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,QACjE;AAEA,QAAA,IAAI,IAAI,YAAA,EAAc;AACpB,UAAA,OAAA,CAAQ,IAAI,KAAA,CAAM,gBAAA,EAAkB,OAAO,IAAI,CAAA,EAAG,IAAI,YAAY,CAAA;AAAA,QACpE;AAAA,MACF,CAAC,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,QAAA,KAAa,OAAA,IAAW,IAAA,CAAK,MAAA,CAAO,cAAA,EAAgB;AACtD,MAAA,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,gBAAA,EAAkB,MAAA,CAAO,GAAG,CAAC,CAAA;AAC/C,MAAA,OAAA,CAAQ,KAAA,EAAM;AAAA,IAChB;AAEA,IAAA,OAAA,CAAQ,QAAA,EAAS;AACjB,IAAA,OAAA,CAAQ,IAAI,EAAE,CAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKQ,iBAAiB,QAAA,EAAmC;AAC1D,IAAA,QAAQ,QAAA;AAAU,MAChB,KAAK,OAAA;AACH,QAAA,OAAO,KAAA,CAAM,SAAA,EAAW,MAAA,CAAO,IAAA,EAAM,OAAO,KAAK,CAAA;AAAA,MACnD,KAAK,MAAA;AACH,QAAA,OAAO,KAAA,CAAM,QAAA,EAAU,MAAA,CAAO,IAAA,EAAM,OAAO,QAAQ,CAAA;AAAA,MACrD,KAAK,MAAA;AACH,QAAA,OAAO,KAAA,CAAM,QAAA,EAAU,MAAA,CAAO,IAAA,EAAM,OAAO,MAAM,CAAA;AAAA;AACrD,EACF;AACF,CAAA;AAKO,IAAM,aAAA,GAAgB,IAAI,kBAAA,EAAmB;AAK7C,IAAM,aAAA,GAAgB,CAC3B,OAAA,KAGyB;AACzB,EAAA,OAAO;AAAA,IACL,OAAO,EAAC;AAAA,IACR,GAAG;AAAA,GACL;AACF,CAAA;;;AC9IO,IAAM,YAAA,GAAe;AAAA;AAAA,EAE1B,UAAA,EAAY,SAAA;AAAA,EAIQ;AAAA,EAGpB,uBAAA,EAAyB,SAAA;AAAA,EACzB,wBAAA,EAA0B,SAAA;AAAA,EAC1B,gBAAA,EAAkB,SAAA;AAAA,EAEG;AAAA,EAGrB,uBAAA,EAAyB,SAAA;AAAA,EAUzB,cAAA,EAAgB,SAAA;AAAA,EAChB,qBAAA,EAAuB,SAiBzB,CAAA;AAKO,IAAM,QAAA,GAAW;AAAA,EAGtB,OAAA,EAAS,2DAAA;AAAA,EAET,OAAA,EAAS,8DAAA;AAAA,EAGT,OAAA,EAAS,kEAEX,CAAA;;;AClJO,IAAM,SAAA,GAAY,CAAC,SAAA,EAAoB,OAAA,KAA0B;AACtE,EAAA,IAAI,CAAC,eAAc,EAAG;AACpB,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,sCAAA,EAAyC,OAAO,CAAA,CAAE,CAAA;AAAA,EACpE;AACF;AAKO,IAAM,uBAAA,GAA0B,CAAC,OAAA,EAAkB,OAAA,KAA2B;AACnF,EAAA,IAAI,CAAC,eAAc,EAAG;AACpB,IAAA;AAAA,EACF;AAGA,EAAA,OAAO,yBAAyB,CAAA,CAC7B,IAAA,CAAK,CAAC,EAAE,mBAAkB,KAAM;AAC/B,IAAA,MAAM,IAAA,GAAO,kBAAkB,OAAO,CAAA;AAEtC,IAAA,IAAI,CAAC,IAAA,IAAQ,IAAA,CAAK,IAAA,EAAK,CAAE,WAAW,CAAA,EAAG;AACrC,MAAA,aAAA,CAAc,IAAA;AAAA,QACZ,aAAA,CAAc;AAAA,UACZ,MAAM,YAAA,CAAa,uBAAA;AAAA,UACnB,QAAA,EAAU,OAAA;AAAA,UACV,QAAA,EAAU,iBAAA;AAAA,UACV,SAAS,CAAA,qCAAA,EAAwC,OAAA,GAAU,CAAA,IAAA,EAAO,OAAO,KAAK,EAAE,CAAA,CAAA;AAAA,UAChF,OAAA;AAAA,UACA,IAAA,EAAM;AAAA,YACJ,SAAA,EAAW,OAAA;AAAA,YACX,KAAA,EAAO,GAAA;AAAA,YACP,GAAA,EAAK,SAAS,OAAO;AAAA,WACvB;AAAA,UACA,KAAA,EAAO;AAAA,YACL;AAAA,cACE,WAAA,EAAa,6BAAA;AAAA,cACb,OAAA,EAAS,CAAA,CAAA,EAAI,OAAA,CAAQ,OAAA,CAAQ,aAAa,CAAA,+BAAA;AAAA,aAC5C;AAAA,YACA;AAAA,cACE,WAAA,EAAa,kBAAA;AAAA,cACb,OAAA,EAAS,CAAA,CAAA,EAAI,OAAA,CAAQ,OAAA,CAAQ,WAAA,EAAa,CAAA,WAAA,EAAc,OAAA,CAAQ,OAAA,CAAQ,WAAA,EAAa,CAAA,CAAA;AAAA,aACvF;AAAA,YACA;AAAA,cACE,WAAA,EAAa,kDAAA;AAAA,cACb,OAAA,EAAS,CAAA,CAAA,EAAI,OAAA,CAAQ,OAAA,CAAQ,aAAa,CAAA,4BAAA;AAAA;AAC5C;AACF,SACD;AAAA,OACH;AAAA,IACF;AAAA,EACF,CAAC,CAAA,CACA,KAAA,CAAM,MAAM;AAAA,EAEb,CAAC,CAAA;AACL;AAKO,IAAM,wBAAA,GAA2B,CAAC,OAAA,EAAkB,OAAA,KAA2B;AACpF,EAAA,IAAI,CAAC,eAAc,EAAG;AACpB,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,WAAW,OAAA,YAAmB,iBAAA;AACpC,EAAA,MAAM,MAAA,GAAS,OAAA,YAAmB,iBAAA,IAAqB,OAAA,CAAQ,aAAa,MAAM,CAAA;AAClF,EAAA,MAAM,UAAU,OAAA,YAAmB,gBAAA;AACnC,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,YAAA,CAAa,UAAU,CAAA;AACnD,EAAA,MAAM,QAAA,GAAW,cAAc,QAAA,CAAS,OAAA,CAAQ,aAAa,UAAU,CAAA,IAAK,GAAA,EAAK,EAAE,CAAA,GAAI,EAAA;AAGvF,EAAA,MAAM,YAAA,GAAe,QAAA,IAAY,MAAA,IAAU,OAAA,IAAY,eAAe,QAAA,IAAY,CAAA;AAElF,EAAA,IAAI,CAAC,YAAA,EAAc;AACjB,IAAA,aAAA,CAAc,IAAA;AAAA,MACZ,aAAA,CAAc;AAAA,QACZ,MAAM,YAAA,CAAa,uBAAA;AAAA,QACnB,QAAA,EAAU,OAAA;AAAA,QACV,QAAA,EAAU,qBAAA;AAAA,QACV,SAAS,CAAA,kCAAA,EAAqC,OAAA,GAAU,CAAA,IAAA,EAAO,OAAO,KAAK,EAAE,CAAA,CAAA;AAAA,QAC7E,OAAA;AAAA,QACA,IAAA,EAAM;AAAA,UACJ,SAAA,EAAW,OAAA;AAAA,UACX,KAAA,EAAO,GAAA;AAAA,UACP,GAAA,EAAK,SAAS,OAAO;AAAA,SACvB;AAAA,QACA,KAAA,EAAO;AAAA,UACL;AAAA,YACE,WAAA,EAAa,gDAAA;AAAA,YACb,OAAA,EAAS,CAAA,uCAAA;AAAA,WACX;AAAA,UACA;AAAA,YACE,WAAA,EAAa,uCAAA;AAAA,YACb,OAAA,EAAS,CAAA,CAAA,EAAI,OAAA,CAAQ,OAAA,CAAQ,aAAa,CAAA,cAAA;AAAA,WAC5C;AAAA,UACA;AAAA,YACE,WAAA,EAAa,4CAAA;AAAA,YACb,OAAA,EAAS,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAAA;AAAA;AAMX;AACF,OACD;AAAA,KACH;AAAA,EACF;AAGA,EAAA,MAAM,eAAA,GAAkB,OAAA,CAAQ,YAAA,CAAa,SAAS,CAAA,KAAM,IAAA;AAC5D,EAAA,IAAI,eAAA,IAAmB,CAAC,QAAA,IAAY,CAAC,MAAA,EAAQ;AAC3C,IAAA,aAAA,CAAc,IAAA;AAAA,MACZ,aAAA,CAAc;AAAA,QACZ,MAAM,YAAA,CAAa,wBAAA;AAAA,QACnB,QAAA,EAAU,MAAA;AAAA,QACV,QAAA,EAAU,qBAAA;AAAA,QACV,SAAS,CAAA,kDAAA,EAAqD,OAAA,GAAU,CAAA,IAAA,EAAO,OAAO,KAAK,EAAE,CAAA,CAAA;AAAA,QAC7F,OAAA;AAAA,QACA,IAAA,EAAM;AAAA,UACJ,SAAA,EAAW,OAAA;AAAA,UACX,KAAA,EAAO,GAAA;AAAA,UACP,GAAA,EAAK,SAAS,OAAO;AAAA,SACvB;AAAA,QACA,KAAA,EAAO;AAAA,UACL;AAAA,YACE,WAAA,EAAa,gDAAA;AAAA,YACb,OAAA,EAAS,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAAA;AAAA;AAMX;AACF,OACD;AAAA,KACH;AAAA,EACF;AACF;AAKO,IAAM,mBAAA,GAAsB,CAAC,OAAA,KAA2B;AAC7D,EAAA,IAAI,CAAC,eAAc,EAAG;AACpB,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,YAAA,CAAa,UAAU,CAAA;AAChD,EAAA,IAAI,aAAa,IAAA,EAAM;AACrB,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,QAAA,EAAU,EAAE,CAAA;AAGnC,EAAA,IAAI,QAAQ,CAAA,EAAG;AACb,IAAA,aAAA,CAAc,IAAA;AAAA,MACZ,aAAA,CAAc;AAAA,QACZ,MAAM,YAAA,CAAa,gBAAA;AAAA,QACnB,QAAA,EAAU,MAAA;AAAA,QACV,QAAA,EAAU,qBAAA;AAAA,QACV,OAAA,EAAS,sBAAsB,KAAK,CAAA,6BAAA,CAAA;AAAA,QACpC,OAAA;AAAA,QACA,IAAA,EAAM;AAAA,UACJ,SAAA,EAAW,OAAA;AAAA,UACX,KAAA,EAAO,GAAA;AAAA,UACP,GAAA,EAAK,SAAS,OAAO;AAAA,SACvB;AAAA,QACA,KAAA,EAAO;AAAA,UACL;AAAA,YACE,WAAA,EAAa,sDAAA;AAAA,YACb,OAAA,EAAS,CAAA,kDAAA;AAAA,WACX;AAAA,UACA;AAAA,YACE,WAAA,EAAa,sEAAA;AAAA,YACb,OAAA,EAAS,CAAA,yCAAA;AAAA,WACX;AAAA,UACA;AAAA,YACE,WAAA,EAAa,gDAAA;AAAA,YACb,YAAA,EAAc;AAAA;AAChB;AACF,OACD;AAAA,KACH;AAAA,EACF;AACF;AAKO,IAAM,yBAAA,GAA4B,CAAC,OAAA,KAA2B;AACnE,EAAA,IAAI,CAAC,eAAc,EAAG;AACpB,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,YAAA,CAAa,MAAM,CAAA;AACxC,EAAA,MAAM,cAAA,GAAiB,KAAA,CAAM,IAAA,CAAK,OAAA,CAAQ,UAAU,CAAA,CAAE,MAAA;AAAA,IAAO,CAAC,IAAA,KAC5D,IAAA,CAAK,IAAA,CAAK,WAAW,OAAO;AAAA,GAC9B;AAGA,EAAA,IAAI,CAAC,QAAQ,cAAA,CAAe,MAAA,GAAS,KAAK,CAAC,iBAAA,CAAkB,OAAO,CAAA,EAAG;AACrE,IAAA,aAAA,CAAc,IAAA;AAAA,MACZ,aAAA,CAAc;AAAA,QACZ,MAAM,YAAA,CAAa,qBAAA;AAAA,QACnB,QAAA,EAAU,MAAA;AAAA,QACV,QAAA,EAAU,YAAA;AAAA,QACV,OAAA,EAAS,kDAAA;AAAA,QACT,OAAA;AAAA,QACA,IAAA,EAAM;AAAA,UACJ,SAAA,EAAW,OAAA;AAAA,UACX,KAAA,EAAO,GAAA;AAAA,UACP,GAAA,EAAK,SAAS,OAAO;AAAA,SACvB;AAAA,QACA,KAAA,EAAO;AAAA,UACL;AAAA,YACE,WAAA,EAAa,mCAAA;AAAA,YACb,OAAA,EAAS,CAAA,oDAAA;AAAA,WACX;AAAA,UACA;AAAA,YACE,WAAA,EAAa,qCAAA;AAAA,YACb,OAAA,EAAS,CAAA,4CAAA;AAAA;AACX;AACF,OACD;AAAA,KACH;AAAA,EACF;AAGA,EAAA,IAAI,IAAA,IAAQ,iBAAA,CAAkB,OAAO,CAAA,EAAG;AACtC,IAAA,MAAM,YAAA,GAAe,gBAAgB,OAAO,CAAA;AAC5C,IAAA,IAAI,SAAS,YAAA,EAAc;AACzB,MAAA,aAAA,CAAc,IAAA;AAAA,QACZ,aAAA,CAAc;AAAA,UACZ,MAAM,YAAA,CAAa,cAAA;AAAA,UACnB,QAAA,EAAU,MAAA;AAAA,UACV,QAAA,EAAU,YAAA;AAAA,UACV,SAAS,CAAA,MAAA,EAAS,IAAI,sBAAsB,OAAA,CAAQ,OAAA,CAAQ,aAAa,CAAA,CAAA,CAAA;AAAA,UACzE,OAAA;AAAA,UACA,KAAA,EAAO;AAAA,YACL;AAAA,cACE,WAAA,EAAa,qCAAA;AAAA,cACb,SAAS,CAAA,CAAA,EAAI,OAAA,CAAQ,QAAQ,WAAA,EAAa,YAAY,IAAI,CAAA,cAAA;AAAA;AAC5D;AACF,SACD;AAAA,OACH;AAAA,IACF;AAAA,EACF;AACF;AAKO,IAAM,kBAAA,GAAqB,CAAC,OAAA,KAA2B;AAC5D,EAAA,IAAI,CAAC,eAAc,EAAG;AACpB,IAAA;AAAA,EACF;AAGA,EAAA,UAAA,CAAW,MAAM;AACf,IAAA,MAAM,gBAAgB,QAAA,CAAS,aAAA;AAE/B,IAAA,IAAI,CAAC,aAAA,IAAiB,aAAA,KAAkB,QAAA,CAAS,IAAA,EAAM;AACrD,MAAA,aAAA,CAAc,IAAA;AAAA,QACZ,aAAA,CAAc;AAAA,UACZ,MAAM,YAAA,CAAa,UAAA;AAAA,UACnB,QAAA,EAAU,MAAA;AAAA,UACV,QAAA,EAAU,kBAAA;AAAA,UACV,SAAS,CAAA,cAAA,EAAiB,OAAA,GAAU,CAAA,OAAA,EAAU,OAAO,KAAK,EAAE,CAAA,CAAA;AAAA,UAC5D,IAAA,EAAM;AAAA,YACJ,SAAA,EAAW,OAAA;AAAA,YACX,KAAA,EAAO,GAAA;AAAA,YACP,GAAA,EAAK,SAAS,OAAO;AAAA,WACvB;AAAA,UACA,KAAA,EAAO;AAAA,YACL;AAAA,cACE,WAAA,EAAa,iDAAA;AAAA,cACb,OAAA,EAAS,CAAA;AAAA;AAAA,uBAAA;AAAA,aAGX;AAAA,YACA;AAAA,cACE,WAAA,EAAa,4CAAA;AAAA,cACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA,UAAA;AAAA;AAKX;AACF,SACD;AAAA,OACH;AAAA,IACF;AAAA,EACF,GAAG,GAAG,CAAA;AACR;AAKA,IAAM,iBAAA,GAAoB,CAAC,OAAA,KAA8B;AACvD,EAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,OAAA,CAAQ,WAAA,EAAY;AACxC,EAAA,MAAM,YAAA,GAAe;AAAA,IACnB,QAAA;AAAA,IACA,GAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAA;AAAA,IACA,UAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IACA,SAAA;AAAA,IACA,SAAA;AAAA,IACA,QAAA;AAAA,IACA,QAAA;AAAA,IACA;AAAA,GACF;AACA,EAAA,OAAO,YAAA,CAAa,SAAS,GAAG,CAAA;AAClC,CAAA;AAKA,IAAM,eAAA,GAAkB,CAAC,OAAA,KAAoC;AAC3D,EAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,OAAA,CAAQ,WAAA,EAAY;AAExC,EAAA,MAAM,OAAA,GAAkC;AAAA,IACtC,MAAA,EAAQ,QAAA;AAAA,IACR,CAAA,EAAG,MAAA;AAAA,IACH,GAAA,EAAK,YAAA;AAAA,IACL,IAAA,EAAM,MAAA;AAAA,IACN,OAAA,EAAS,SAAA;AAAA,IACT,OAAA,EAAS,QAAA;AAAA,IACT,MAAA,EAAQ,QAAA;AAAA,IACR,MAAA,EAAQ,aAAA;AAAA,IACR,KAAA,EAAO;AAAA,GACT;AAEA,EAAA,OAAO,OAAA,CAAQ,GAAG,CAAA,IAAK,IAAA;AACzB,CAAA","file":"index.js","sourcesContent":["/**\n * @a13y/devtools - Warning System\n * Structured warning system with styled console output\n */\n\nimport type { AccessibilityWarning, WarningSeverity } from './warning-types';\n\n/**\n * Console styling for warnings\n */\nconst Styles = {\n  reset: '\\x1b[0m',\n  bold: '\\x1b[1m',\n  dim: '\\x1b[2m',\n\n  // Colors\n  red: '\\x1b[31m',\n  yellow: '\\x1b[33m',\n  blue: '\\x1b[34m',\n  cyan: '\\x1b[36m',\n  gray: '\\x1b[90m',\n\n  // Backgrounds\n  bgRed: '\\x1b[41m',\n  bgYellow: '\\x1b[43m',\n  bgBlue: '\\x1b[44m',\n} as const;\n\n/**\n * Format a message with console styling\n */\nconst style = (text: string, ...styles: string[]): string => {\n  return `${styles.join('')}${text}${Styles.reset}`;\n};\n\n/**\n * Configuration for warning system\n */\nexport interface WarningSystemConfig {\n  /**\n   * Enable/disable warnings\n   * @default true in development\n   */\n  enabled?: boolean;\n\n  /**\n   * Minimum severity to show\n   * @default 'warn'\n   */\n  minSeverity?: WarningSeverity;\n\n  /**\n   * Show element in console\n   * @default true\n   */\n  showElement?: boolean;\n\n  /**\n   * Show stack traces for errors\n   * @default true\n   */\n  showStackTrace?: boolean;\n\n  /**\n   * Deduplicate warnings\n   * @default true\n   */\n  deduplicate?: boolean;\n\n  /**\n   * Custom warning handler\n   */\n  onWarning?: (warning: AccessibilityWarning) => void;\n}\n\n/**\n * Warning system class\n */\nclass WarningSystemClass {\n  private config: Required<WarningSystemConfig> = {\n    enabled: true,\n    minSeverity: 'warn',\n    showElement: true,\n    showStackTrace: true,\n    deduplicate: true,\n    onWarning: () => {},\n  };\n\n  private warningCache = new Set<string>();\n\n  /**\n   * Configure the warning system\n   */\n  configure(config: WarningSystemConfig): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Emit a warning\n   */\n  warn(warning: AccessibilityWarning): void {\n    if (!this.config.enabled) {\n      return;\n    }\n\n    // Check severity threshold\n    const severityLevel = { info: 0, warn: 1, error: 2 };\n    if (severityLevel[warning.severity] < severityLevel[this.config.minSeverity]) {\n      return;\n    }\n\n    // Deduplicate\n    if (this.config.deduplicate) {\n      const key = this.getWarningKey(warning);\n      if (this.warningCache.has(key)) {\n        return;\n      }\n      this.warningCache.add(key);\n    }\n\n    // Custom handler\n    if (this.config.onWarning) {\n      this.config.onWarning(warning);\n    }\n\n    // Console output\n    this.printWarning(warning);\n  }\n\n  /**\n   * Clear warning cache\n   */\n  clearCache(): void {\n    this.warningCache.clear();\n  }\n\n  /**\n   * Generate a unique key for a warning\n   */\n  private getWarningKey(warning: AccessibilityWarning): string {\n    const parts = [warning.code, warning.message];\n\n    if (warning.element) {\n      // Use element's tag, id, and classes for uniqueness\n      const tag = warning.element.tagName.toLowerCase();\n      const id = warning.element.id;\n      const classes = Array.from(warning.element.classList).join('.');\n      parts.push(`${tag}#${id}.${classes}`);\n    }\n\n    return parts.join('|');\n  }\n\n  /**\n   * Print warning to console\n   */\n  private printWarning(warning: AccessibilityWarning): void {\n    const { severity, code, category, message, element, wcag, fixes } = warning;\n\n    // Severity badge\n    const badge = this.getSeverityBadge(severity);\n\n    // Header\n    console.group(\n      `${badge} ${style(code, Styles.bold, Styles.cyan)} ${style(category, Styles.dim)}`\n    );\n\n    // Message\n    console.log(style(message, Styles.bold));\n\n    // Element\n    if (element && this.config.showElement) {\n      console.log(style('\\nElement:', Styles.bold));\n      console.log(element);\n    }\n\n    // WCAG info\n    if (wcag) {\n      console.log(style('\\nWCAG:', Styles.bold), `${wcag.criterion} (Level ${wcag.level})`);\n      console.log(style('Learn more:', Styles.blue), wcag.url);\n    }\n\n    // Fix suggestions\n    if (fixes.length > 0) {\n      console.log(style('\\nHow to fix:', Styles.bold, Styles.cyan));\n      fixes.forEach((fix, index) => {\n        console.log(`${index + 1}. ${fix.description}`);\n\n        if (fix.example) {\n          console.log(style('\\n   Example:', Styles.dim));\n          console.log(style(`   ${fix.example}`, Styles.dim, Styles.gray));\n        }\n\n        if (fix.learnMoreUrl) {\n          console.log(style('   Learn more:', Styles.blue), fix.learnMoreUrl);\n        }\n      });\n    }\n\n    // Stack trace for errors\n    if (severity === 'error' && this.config.showStackTrace) {\n      console.log(style('\\nStack trace:', Styles.dim));\n      console.trace();\n    }\n\n    console.groupEnd();\n    console.log(''); // Empty line for spacing\n  }\n\n  /**\n   * Get severity badge for console\n   */\n  private getSeverityBadge(severity: WarningSeverity): string {\n    switch (severity) {\n      case 'error':\n        return style(' ERROR ', Styles.bold, Styles.bgRed);\n      case 'warn':\n        return style(' WARN ', Styles.bold, Styles.bgYellow);\n      case 'info':\n        return style(' INFO ', Styles.bold, Styles.bgBlue);\n    }\n  }\n}\n\n/**\n * Singleton warning system\n */\nexport const WarningSystem = new WarningSystemClass();\n\n/**\n * Helper to create a warning\n */\nexport const createWarning = (\n  partial: Omit<AccessibilityWarning, 'fixes'> & {\n    fixes?: AccessibilityWarning['fixes'];\n  }\n): AccessibilityWarning => {\n  return {\n    fixes: [],\n    ...partial,\n  };\n};\n","/**\n * @a13y/devtools - Warning Types\n * Type definitions for accessibility warnings\n */\n\n/**\n * Warning severity level\n */\nexport type WarningSeverity = 'error' | 'warn' | 'info';\n\n/**\n * WCAG level for the violation\n */\nexport type WCAGLevel = 'A' | 'AA' | 'AAA';\n\n/**\n * Category of accessibility issue\n */\nexport type WarningCategory =\n  | 'focus-management'\n  | 'keyboard-navigation'\n  | 'aria-usage'\n  | 'accessible-name'\n  | 'semantic-html'\n  | 'wcag-compliance'\n  | 'performance';\n\n/**\n * Fix suggestion for a warning\n */\nexport interface FixSuggestion {\n  /**\n   * Description of how to fix the issue\n   */\n  description: string;\n\n  /**\n   * Code example showing the fix\n   */\n  example?: string;\n\n  /**\n   * Link to documentation\n   */\n  learnMoreUrl?: string;\n}\n\n/**\n * Accessibility warning\n */\nexport interface AccessibilityWarning {\n  /**\n   * Unique warning code (e.g., \"A13Y001\")\n   */\n  code: string;\n\n  /**\n   * Severity level\n   */\n  severity: WarningSeverity;\n\n  /**\n   * Category of the issue\n   */\n  category: WarningCategory;\n\n  /**\n   * Human-readable message\n   */\n  message: string;\n\n  /**\n   * Element that caused the warning\n   */\n  element?: Element;\n\n  /**\n   * WCAG criterion violated\n   */\n  wcag?: {\n    criterion: string;\n    level: WCAGLevel;\n    url: string;\n  };\n\n  /**\n   * Suggestions for fixing the issue\n   */\n  fixes: FixSuggestion[];\n\n  /**\n   * Additional context\n   */\n  context?: Record<string, unknown>;\n}\n\n/**\n * Warning code definitions\n */\nexport const WarningCodes = {\n  // Focus Management (001-099)\n  FOCUS_LOST: 'A13Y001',\n  FOCUS_NOT_VISIBLE: 'A13Y002',\n  FOCUS_TRAP_BROKEN: 'A13Y003',\n  FOCUS_ORDER_INVALID: 'A13Y004',\n  FOCUS_NOT_RESTORED: 'A13Y005',\n\n  // Keyboard Navigation (100-199)\n  NOT_KEYBOARD_ACCESSIBLE: 'A13Y100',\n  MISSING_KEYBOARD_HANDLER: 'A13Y101',\n  INVALID_TABINDEX: 'A13Y102',\n  ROVING_TABINDEX_BROKEN: 'A13Y103',\n  MISSING_ESC_HANDLER: 'A13Y104',\n\n  // Accessible Name (200-299)\n  MISSING_ACCESSIBLE_NAME: 'A13Y200',\n  EMPTY_ACCESSIBLE_NAME: 'A13Y201',\n  DUPLICATE_ID: 'A13Y202',\n  INVALID_LABELLEDBY: 'A13Y203',\n  PLACEHOLDER_AS_LABEL: 'A13Y204',\n\n  // ARIA Usage (300-399)\n  INVALID_ARIA_ROLE: 'A13Y300',\n  INVALID_ARIA_ATTRIBUTE: 'A13Y301',\n  CONFLICTING_ARIA: 'A13Y302',\n  REDUNDANT_ARIA: 'A13Y303',\n  MISSING_REQUIRED_ARIA: 'A13Y304',\n  INVALID_ARIA_VALUE: 'A13Y305',\n\n  // Semantic HTML (400-499)\n  DIV_BUTTON: 'A13Y400',\n  DIV_LINK: 'A13Y401',\n  MISSING_LANDMARK: 'A13Y402',\n  INVALID_NESTING: 'A13Y403',\n\n  // WCAG Compliance (500-599)\n  CONTRAST_INSUFFICIENT: 'A13Y500',\n  TARGET_SIZE_TOO_SMALL: 'A13Y501',\n  ANIMATION_NO_REDUCE_MOTION: 'A13Y502',\n\n  // Performance (600-699)\n  TOO_MANY_LIVE_REGIONS: 'A13Y600',\n  EXCESSIVE_ANNOUNCEMENTS: 'A13Y601',\n} as const;\n\n/**\n * WCAG criterion URLs\n */\nexport const WCAGUrls = {\n  '1.3.1': 'https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html',\n  '1.4.3': 'https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html',\n  '2.1.1': 'https://www.w3.org/WAI/WCAG22/Understanding/keyboard.html',\n  '2.1.2': 'https://www.w3.org/WAI/WCAG22/Understanding/no-keyboard-trap.html',\n  '2.4.3': 'https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html',\n  '2.4.7': 'https://www.w3.org/WAI/WCAG22/Understanding/focus-visible.html',\n  '2.5.5': 'https://www.w3.org/WAI/WCAG22/Understanding/target-size.html',\n  '4.1.2': 'https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html',\n  '4.1.3': 'https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html',\n} as const;\n","/**\n * @a13y/devtools - Invariants\n * Development-only assertions for accessibility constraints\n */\n\nimport { isDevelopment } from '@a13y/core/runtime/env';\nimport { createWarning, WarningSystem } from '../warnings/warning-system';\nimport { WarningCodes, WCAGUrls } from '../warnings/warning-types';\n\n/**\n * Assert that a condition is true, throw error if false (development only)\n */\nexport const invariant = (condition: boolean, message: string): void => {\n  if (!isDevelopment()) {\n    return;\n  }\n\n  if (!condition) {\n    throw new Error(`[@a13y/devtools] Invariant violation: ${message}`);\n  }\n};\n\n/**\n * Assert that an element has an accessible name\n */\nexport const assertHasAccessibleName = (element: Element, context?: string): void => {\n  if (!isDevelopment()) {\n    return;\n  }\n\n  // Import getAccessibleName at runtime to avoid circular deps\n  import('@a13y/core/runtime/aria')\n    .then(({ getAccessibleName }) => {\n      const name = getAccessibleName(element);\n\n      if (!name || name.trim().length === 0) {\n        WarningSystem.warn(\n          createWarning({\n            code: WarningCodes.MISSING_ACCESSIBLE_NAME,\n            severity: 'error',\n            category: 'accessible-name',\n            message: `Element is missing an accessible name${context ? ` in ${context}` : ''}`,\n            element,\n            wcag: {\n              criterion: '4.1.2',\n              level: 'A',\n              url: WCAGUrls['4.1.2'],\n            },\n            fixes: [\n              {\n                description: 'Add an aria-label attribute',\n                example: `<${element.tagName.toLowerCase()} aria-label=\"Descriptive name\">`,\n              },\n              {\n                description: 'Add text content',\n                example: `<${element.tagName.toLowerCase()}>Click me</${element.tagName.toLowerCase()}>`,\n              },\n              {\n                description: 'Use aria-labelledby to reference another element',\n                example: `<${element.tagName.toLowerCase()} aria-labelledby=\"label-id\">`,\n              },\n            ],\n          })\n        );\n      }\n    })\n    .catch(() => {\n      // Silently fail if @a13y/core is not available\n    });\n};\n\n/**\n * Assert that an element is keyboard accessible\n */\nexport const assertKeyboardAccessible = (element: Element, context?: string): void => {\n  if (!isDevelopment()) {\n    return;\n  }\n\n  const isButton = element instanceof HTMLButtonElement;\n  const isLink = element instanceof HTMLAnchorElement && element.hasAttribute('href');\n  const isInput = element instanceof HTMLInputElement;\n  const hasTabindex = element.hasAttribute('tabindex');\n  const tabindex = hasTabindex ? parseInt(element.getAttribute('tabindex') || '0', 10) : -1;\n\n  // Check if element is naturally keyboard accessible or has tabindex >= 0\n  const isAccessible = isButton || isLink || isInput || (hasTabindex && tabindex >= 0);\n\n  if (!isAccessible) {\n    WarningSystem.warn(\n      createWarning({\n        code: WarningCodes.NOT_KEYBOARD_ACCESSIBLE,\n        severity: 'error',\n        category: 'keyboard-navigation',\n        message: `Element is not keyboard accessible${context ? ` in ${context}` : ''}`,\n        element,\n        wcag: {\n          criterion: '2.1.1',\n          level: 'A',\n          url: WCAGUrls['2.1.1'],\n        },\n        fixes: [\n          {\n            description: 'Use a semantic HTML element (button, a, input)',\n            example: `<button type=\"button\">Click me</button>`,\n          },\n          {\n            description: 'Add tabindex=\"0\" to make it focusable',\n            example: `<${element.tagName.toLowerCase()} tabindex=\"0\">`,\n          },\n          {\n            description: 'Add keyboard event handlers (Enter, Space)',\n            example: `element.addEventListener('keydown', (e) => {\n  if (e.key === 'Enter' || e.key === ' ') {\n    e.preventDefault();\n    // Handle activation\n  }\n});`,\n          },\n        ],\n      })\n    );\n  }\n\n  // Check for click handler without keyboard handler\n  const hasClickHandler = element.getAttribute('onclick') !== null;\n  if (hasClickHandler && !isButton && !isLink) {\n    WarningSystem.warn(\n      createWarning({\n        code: WarningCodes.MISSING_KEYBOARD_HANDLER,\n        severity: 'warn',\n        category: 'keyboard-navigation',\n        message: `Element has click handler but no keyboard handlers${context ? ` in ${context}` : ''}`,\n        element,\n        wcag: {\n          criterion: '2.1.1',\n          level: 'A',\n          url: WCAGUrls['2.1.1'],\n        },\n        fixes: [\n          {\n            description: 'Add onKeyDown handler for Enter and Space keys',\n            example: `const handleKeyDown = (e: KeyboardEvent) => {\n  if (e.key === 'Enter' || e.key === ' ') {\n    e.preventDefault();\n    onClick(e);\n  }\n};`,\n          },\n        ],\n      })\n    );\n  }\n};\n\n/**\n * Assert that tabindex value is valid\n */\nexport const assertValidTabindex = (element: Element): void => {\n  if (!isDevelopment()) {\n    return;\n  }\n\n  const tabindex = element.getAttribute('tabindex');\n  if (tabindex === null) {\n    return;\n  }\n\n  const value = parseInt(tabindex, 10);\n\n  // Warn about positive tabindex (antipattern)\n  if (value > 0) {\n    WarningSystem.warn(\n      createWarning({\n        code: WarningCodes.INVALID_TABINDEX,\n        severity: 'warn',\n        category: 'keyboard-navigation',\n        message: `Positive tabindex (${value}) creates confusing tab order`,\n        element,\n        wcag: {\n          criterion: '2.4.3',\n          level: 'A',\n          url: WCAGUrls['2.4.3'],\n        },\n        fixes: [\n          {\n            description: 'Use tabindex=\"0\" to add element to natural tab order',\n            example: `<div tabindex=\"0\">Focusable in natural order</div>`,\n          },\n          {\n            description: 'Use tabindex=\"-1\" to remove from tab order (programmatic focus only)',\n            example: `<div tabindex=\"-1\">Not in tab order</div>`,\n          },\n          {\n            description: 'Restructure DOM to achieve desired focus order',\n            learnMoreUrl: 'https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html',\n          },\n        ],\n      })\n    );\n  }\n};\n\n/**\n * Assert that ARIA attributes are valid for the element's role\n */\nexport const assertValidAriaAttributes = (element: Element): void => {\n  if (!isDevelopment()) {\n    return;\n  }\n\n  const role = element.getAttribute('role');\n  const ariaAttributes = Array.from(element.attributes).filter((attr) =>\n    attr.name.startsWith('aria-')\n  );\n\n  // Check for ARIA attributes without role\n  if (!role && ariaAttributes.length > 0 && !isSemanticElement(element)) {\n    WarningSystem.warn(\n      createWarning({\n        code: WarningCodes.MISSING_REQUIRED_ARIA,\n        severity: 'warn',\n        category: 'aria-usage',\n        message: 'Element has ARIA attributes but no explicit role',\n        element,\n        wcag: {\n          criterion: '4.1.2',\n          level: 'A',\n          url: WCAGUrls['4.1.2'],\n        },\n        fixes: [\n          {\n            description: 'Add an appropriate role attribute',\n            example: `<div role=\"button\" aria-pressed=\"false\">Toggle</div>`,\n          },\n          {\n            description: 'Use a semantic HTML element instead',\n            example: `<button aria-pressed=\"false\">Toggle</button>`,\n          },\n        ],\n      })\n    );\n  }\n\n  // Check for redundant ARIA on semantic elements\n  if (role && isSemanticElement(element)) {\n    const semanticRole = getImplicitRole(element);\n    if (role === semanticRole) {\n      WarningSystem.warn(\n        createWarning({\n          code: WarningCodes.REDUNDANT_ARIA,\n          severity: 'info',\n          category: 'aria-usage',\n          message: `Role \"${role}\" is redundant on <${element.tagName.toLowerCase()}>`,\n          element,\n          fixes: [\n            {\n              description: 'Remove the redundant role attribute',\n              example: `<${element.tagName.toLowerCase()}> (role=\"${role}\" is implicit)`,\n            },\n          ],\n        })\n      );\n    }\n  }\n};\n\n/**\n * Assert that focus is visible after an action\n */\nexport const assertFocusVisible = (context?: string): void => {\n  if (!isDevelopment()) {\n    return;\n  }\n\n  // Delay check to allow focus to settle\n  setTimeout(() => {\n    const activeElement = document.activeElement;\n\n    if (!activeElement || activeElement === document.body) {\n      WarningSystem.warn(\n        createWarning({\n          code: WarningCodes.FOCUS_LOST,\n          severity: 'warn',\n          category: 'focus-management',\n          message: `Focus was lost${context ? ` after ${context}` : ''}`,\n          wcag: {\n            criterion: '2.4.3',\n            level: 'A',\n            url: WCAGUrls['2.4.3'],\n          },\n          fixes: [\n            {\n              description: 'Ensure focus is moved to an appropriate element',\n              example: `// After closing dialog\nconst returnElement = document.getElementById('trigger-button');\nreturnElement?.focus();`,\n            },\n            {\n              description: 'Use FocusManager to save and restore focus',\n              example: `import { FocusManager } from '@a13y/core/runtime/focus';\n\nconst restore = FocusManager.saveFocus();\n// ... perform action ...\nrestore();`,\n            },\n          ],\n        })\n      );\n    }\n  }, 100);\n};\n\n/**\n * Check if element is a semantic HTML element\n */\nconst isSemanticElement = (element: Element): boolean => {\n  const tag = element.tagName.toLowerCase();\n  const semanticTags = [\n    'button',\n    'a',\n    'input',\n    'select',\n    'textarea',\n    'nav',\n    'main',\n    'article',\n    'section',\n    'header',\n    'footer',\n    'aside',\n  ];\n  return semanticTags.includes(tag);\n};\n\n/**\n * Get implicit ARIA role of an element\n */\nconst getImplicitRole = (element: Element): string | null => {\n  const tag = element.tagName.toLowerCase();\n\n  const roleMap: Record<string, string> = {\n    button: 'button',\n    a: 'link',\n    nav: 'navigation',\n    main: 'main',\n    article: 'article',\n    section: 'region',\n    header: 'banner',\n    footer: 'contentinfo',\n    aside: 'complementary',\n  };\n\n  return roleMap[tag] || null;\n};\n"]}

package/dist/runtime/validators/index.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @a13y/devtools - ARIA Validator
+ * Validates ARIA attributes and usage
+ */
+/**
+ * ARIA validator class
+ */
+declare class AriaValidator {
+    /**
+     * Validate ARIA attributes on an element
+     */
+    validateElement(element: Element): void;
+    /**
+     * Validate accessible name
+     */
+    validateAccessibleName(element: Element, context?: string): void;
+    /**
+     * Validate role attribute
+     */
+    private validateRole;
+    /**
+     * Validate ARIA attribute
+     */
+    private validateAriaAttribute;
+    /**
+     * Validate ID references in ARIA attributes
+     */
+    private validateIdReferences;
+    /**
+     * Validate required ARIA props for a role
+     */
+    private validateRequiredProps;
+    /**
+     * Check for redundant ARIA
+     */
+    private checkRedundantAria;
+    /**
+     * Check for conflicting ARIA attributes
+     */
+    private checkConflictingAria;
+    /**
+     * Get all ARIA attributes from an element
+     */
+    private getAriaAttributes;
+}
+/**
+ * Singleton ARIA validator
+ */
+declare const ariaValidator: AriaValidator;
+
+/**
+ * @a13y/devtools - Focus Validator
+ * Validates focus management and visual focus indicators
+ */
+/**
+ * Focus validator class
+ */
+declare class FocusValidator {
+    private focusHistory;
+    private isActive;
+    /**
+     * Start monitoring focus changes
+     */
+    start(): void;
+    /**
+     * Stop monitoring focus changes
+     */
+    stop(): void;
+    /**
+     * Validate that focus is visible
+     */
+    validateFocusVisible(element: Element): void;
+    /**
+     * Validate focus trap
+     */
+    validateFocusTrap(container: Element, expectedTrapped: boolean): void;
+    /**
+     * Validate focus order
+     */
+    validateFocusOrder(container: Element): void;
+    /**
+     * Track focus restoration after actions
+     */
+    expectFocusRestoration(expectedElement: Element, action: string): void;
+    private handleFocusIn;
+    private handleFocusOut;
+    private getFocusableElements;
+}
+/**
+ * Singleton focus validator
+ */
+declare const focusValidator: FocusValidator;
+
+/**
+ * @a13y/devtools - Keyboard Validator
+ * Validates keyboard accessibility
+ */
+/**
+ * Keyboard validator class
+ */
+declare class KeyboardValidator {
+    /**
+     * Validate that interactive elements are keyboard accessible
+     */
+    validateInteractiveElement(element: Element): void;
+    /**
+     * Validate that a container's children are reachable via keyboard
+     */
+    validateContainer(container: Element): void;
+    /**
+     * Validate roving tabindex implementation
+     */
+    validateRovingTabindex(container: Element): void;
+    /**
+     * Check for escape key handler in dialogs/modals
+     */
+    validateEscapeHandler(container: Element, shouldHaveEscape: boolean): void;
+    /**
+     * Analyze an element for keyboard accessibility
+     */
+    private analyzeElement;
+    /**
+     * Check if element is focusable
+     */
+    private isFocusable;
+    /**
+     * Find all interactive elements in a container
+     */
+    private findInteractiveElements;
+    /**
+     * Check for div/span styled as button (antipattern)
+     */
+    private checkForDivButton;
+}
+/**
+ * Singleton keyboard validator
+ */
+declare const keyboardValidator: KeyboardValidator;
+
+export { AriaValidator, FocusValidator, KeyboardValidator, ariaValidator, focusValidator, keyboardValidator };