@a11y-hud/react 0.2.0

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 Arthur Vasconcelos
+
+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.
+
+---
+
+This software includes icons from Lucide (https://lucide.dev/).
+See LICENSE-ICONS.md for details.

package/dist/index.cjs

@@ -0,0 +1,70 @@
+'use strict';
+
+var a11yHud = require('a11y-hud');
+var react = require('react');
+
+// src/hook.ts
+function useA11yHud(options = {}) {
+  const { theme, scope, autoScan, debounce } = options;
+  const instanceRef = react.useRef(null);
+  const elementRef = react.useRef(null);
+  react.useEffect(() => {
+    const instance = a11yHud.mount({
+      ...theme !== void 0 && { theme },
+      ...autoScan !== void 0 && { autoScan },
+      ...debounce !== void 0 && { debounce }
+    });
+    instanceRef.current = instance;
+    elementRef.current = document.querySelector("a11y-hud");
+    return () => {
+      instance.unmount();
+      instanceRef.current = null;
+      elementRef.current = null;
+    };
+  }, []);
+  react.useEffect(() => {
+    if (theme !== void 0) instanceRef.current?.setTheme(theme);
+  }, [theme]);
+  react.useEffect(() => {
+    const el = elementRef.current;
+    if (!el) return;
+    if (autoScan === false) {
+      el.removeAttribute("auto-scan");
+    } else {
+      el.setAttribute("auto-scan", "");
+    }
+  }, [autoScan]);
+  react.useEffect(() => {
+    const el = elementRef.current;
+    if (!el || debounce === void 0) return;
+    el.setAttribute("debounce", String(debounce));
+  }, [debounce]);
+  react.useEffect(() => {
+    const instance = instanceRef.current;
+    if (!instance) return;
+    const el = elementRef.current;
+    if (el) {
+      el.scopeElement = scope?.current ?? void 0;
+    }
+    void instance.runScan();
+  });
+  const runScan = react.useCallback(
+    () => instanceRef.current?.runScan() ?? Promise.resolve(null),
+    []
+  );
+  const setTheme = react.useCallback((t) => {
+    instanceRef.current?.setTheme(t);
+  }, []);
+  return { runScan, setTheme };
+}
+
+// src/component.tsx
+function A11yHud(props) {
+  useA11yHud(props);
+  return null;
+}
+
+exports.A11yHud = A11yHud;
+exports.useA11yHud = useA11yHud;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hook.ts","../src/component.tsx"],"names":["useRef","useEffect","mount","useCallback"],"mappings":";;;;;;AAKO,SAAS,UAAA,CAAW,OAAA,GAA6B,EAAC,EAAqB;AAC5E,EAAA,MAAM,EAAE,KAAA,EAAO,KAAA,EAAO,QAAA,EAAU,UAAS,GAAI,OAAA;AAC7C,EAAA,MAAM,WAAA,GAAcA,aAA+B,IAAI,CAAA;AACvD,EAAA,MAAM,UAAA,GAAaA,aAA8B,IAAI,CAAA;AAKrD,EAAAC,eAAA,CAAU,MAAM;AAGd,IAAA,MAAM,WAAWC,aAAA,CAAM;AAAA,MACrB,GAAI,KAAA,KAAU,MAAA,IAAa,EAAE,KAAA,EAAM;AAAA,MACnC,GAAI,QAAA,KAAa,MAAA,IAAa,EAAE,QAAA,EAAS;AAAA,MACzC,GAAI,QAAA,KAAa,MAAA,IAAa,EAAE,QAAA;AAAS,KAC1C,CAAA;AACD,IAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AACtB,IAAA,UAAA,CAAW,OAAA,GAAU,QAAA,CAAS,aAAA,CAA8B,UAAU,CAAA;AACtE,IAAA,OAAO,MAAM;AACX,MAAA,QAAA,CAAS,OAAA,EAAQ;AACjB,MAAA,WAAA,CAAY,OAAA,GAAU,IAAA;AACtB,MAAA,UAAA,CAAW,OAAA,GAAU,IAAA;AAAA,IACvB,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAAD,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,WAAA,CAAY,OAAA,EAAS,SAAS,KAAK,CAAA;AAAA,EAC9D,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,KAAK,UAAA,CAAW,OAAA;AACtB,IAAA,IAAI,CAAC,EAAA,EAAI;AACT,IAAA,IAAI,aAAa,KAAA,EAAO;AACtB,MAAA,EAAA,CAAG,gBAAgB,WAAW,CAAA;AAAA,IAChC,CAAA,MAAO;AACL,MAAA,EAAA,CAAG,YAAA,CAAa,aAAa,EAAE,CAAA;AAAA,IACjC;AAAA,EACF,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,KAAK,UAAA,CAAW,OAAA;AACtB,IAAA,IAAI,CAAC,EAAA,IAAM,QAAA,KAAa,MAAA,EAAW;AACnC,IAAA,EAAA,CAAG,YAAA,CAAa,UAAA,EAAY,MAAA,CAAO,QAAQ,CAAC,CAAA;AAAA,EAC9C,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAOb,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,WAAW,WAAA,CAAY,OAAA;AAC7B,IAAA,IAAI,CAAC,QAAA,EAAU;AACf,IAAA,MAAM,KAAK,UAAA,CAAW,OAAA;AACtB,IAAA,IAAI,EAAA,EAAI;AACN,MAAA,EAAA,CAAG,YAAA,GAAe,OAAO,OAAA,IAAW,MAAA;AAAA,IACtC;AACA,IAAA,KAAK,SAAS,OAAA,EAAQ;AAAA,EACxB,CAAC,CAAA;AAED,EAAA,MAAM,OAAA,GAAUE,iBAAA;AAAA,IACd,MACE,WAAA,CAAY,OAAA,EAAS,SAAQ,IAAK,OAAA,CAAQ,QAAQ,IAA6B,CAAA;AAAA,IACjF;AAAC,GACH;AAEA,EAAA,MAAM,QAAA,GAAWA,iBAAA,CAAY,CAAC,CAAA,KAAmB;AAC/C,IAAA,WAAA,CAAY,OAAA,EAAS,SAAS,CAAC,CAAA;AAAA,EACjC,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,EAAE,SAAS,QAAA,EAAS;AAC7B;;;ACzEO,SAAS,QAAQ,KAAA,EAA2B;AACjD,EAAA,UAAA,CAAW,KAAK,CAAA;AAChB,EAAA,OAAO,IAAA;AACT","file":"index.cjs","sourcesContent":["import type { A11yHudElement, A11yHudInstance, AxeResults, Theme } from \"a11y-hud\";\nimport { mount } from \"a11y-hud\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport type { UseA11yHudOptions, UseA11yHudReturn } from \"./types.js\";\n\nexport function useA11yHud(options: UseA11yHudOptions = {}): UseA11yHudReturn {\n  const { theme, scope, autoScan, debounce } = options;\n  const instanceRef = useRef<A11yHudInstance | null>(null);\n  const elementRef = useRef<A11yHudElement | null>(null);\n\n  // Mount the CE once. Capture the element reference immediately after mount()\n  // so subsequent effects can access it without re-querying the DOM.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: intentional mount-once effect; initial options are applied here, changes are tracked by the separate sync effects below\n  useEffect(() => {\n    // exactOptionalPropertyTypes forbids passing `undefined` for optional props;\n    // build the options object conditionally to satisfy the constraint.\n    const instance = mount({\n      ...(theme !== undefined && { theme }),\n      ...(autoScan !== undefined && { autoScan }),\n      ...(debounce !== undefined && { debounce }),\n    });\n    instanceRef.current = instance;\n    elementRef.current = document.querySelector<A11yHudElement>(\"a11y-hud\");\n    return () => {\n      instance.unmount();\n      instanceRef.current = null;\n      elementRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (theme !== undefined) instanceRef.current?.setTheme(theme);\n  }, [theme]);\n\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n    if (autoScan === false) {\n      el.removeAttribute(\"auto-scan\");\n    } else {\n      el.setAttribute(\"auto-scan\", \"\");\n    }\n  }, [autoScan]);\n\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el || debounce === undefined) return;\n    el.setAttribute(\"debounce\", String(debounce));\n  }, [debounce]);\n\n  // Render-settled signal: runs after every React commit. Always syncs scope\n  // (including clearing it when scope becomes undefined), then triggers a\n  // rescan. This is the adapter's core value — rescans fire after React\n  // finishes rendering, catching route changes and prop-driven ARIA mutations\n  // that the MutationObserver may coalesce.\n  useEffect(() => {\n    const instance = instanceRef.current;\n    if (!instance) return;\n    const el = elementRef.current;\n    if (el) {\n      el.scopeElement = scope?.current ?? undefined;\n    }\n    void instance.runScan();\n  });\n\n  const runScan = useCallback(\n    (): Promise<AxeResults> =>\n      instanceRef.current?.runScan() ?? Promise.resolve(null as unknown as AxeResults),\n    []\n  );\n\n  const setTheme = useCallback((t: Theme): void => {\n    instanceRef.current?.setTheme(t);\n  }, []);\n\n  return { runScan, setTheme };\n}\n","import { useA11yHud } from \"./hook.js\";\nimport type { A11yHudProps } from \"./types.js\";\n\nexport function A11yHud(props: A11yHudProps): null {\n  useA11yHud(props);\n  return null;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+import { Theme, AxeResults } from 'a11y-hud';
+import { RefObject } from 'react';
+
+interface UseA11yHudOptions {
+    theme?: Theme;
+    scope?: RefObject<Element | null>;
+    autoScan?: boolean;
+    debounce?: number;
+}
+type A11yHudProps = UseA11yHudOptions;
+interface UseA11yHudReturn {
+    runScan(): Promise<AxeResults>;
+    setTheme(theme: Theme): void;
+}
+
+declare function A11yHud(props: A11yHudProps): null;
+
+declare function useA11yHud(options?: UseA11yHudOptions): UseA11yHudReturn;
+
+export { A11yHud, type A11yHudProps, type UseA11yHudOptions, type UseA11yHudReturn, useA11yHud };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { Theme, AxeResults } from 'a11y-hud';
+import { RefObject } from 'react';
+
+interface UseA11yHudOptions {
+    theme?: Theme;
+    scope?: RefObject<Element | null>;
+    autoScan?: boolean;
+    debounce?: number;
+}
+type A11yHudProps = UseA11yHudOptions;
+interface UseA11yHudReturn {
+    runScan(): Promise<AxeResults>;
+    setTheme(theme: Theme): void;
+}
+
+declare function A11yHud(props: A11yHudProps): null;
+
+declare function useA11yHud(options?: UseA11yHudOptions): UseA11yHudReturn;
+
+export { A11yHud, type A11yHudProps, type UseA11yHudOptions, type UseA11yHudReturn, useA11yHud };

package/dist/index.js

@@ -0,0 +1,67 @@
+import { mount } from 'a11y-hud';
+import { useRef, useEffect, useCallback } from 'react';
+
+// src/hook.ts
+function useA11yHud(options = {}) {
+  const { theme, scope, autoScan, debounce } = options;
+  const instanceRef = useRef(null);
+  const elementRef = useRef(null);
+  useEffect(() => {
+    const instance = mount({
+      ...theme !== void 0 && { theme },
+      ...autoScan !== void 0 && { autoScan },
+      ...debounce !== void 0 && { debounce }
+    });
+    instanceRef.current = instance;
+    elementRef.current = document.querySelector("a11y-hud");
+    return () => {
+      instance.unmount();
+      instanceRef.current = null;
+      elementRef.current = null;
+    };
+  }, []);
+  useEffect(() => {
+    if (theme !== void 0) instanceRef.current?.setTheme(theme);
+  }, [theme]);
+  useEffect(() => {
+    const el = elementRef.current;
+    if (!el) return;
+    if (autoScan === false) {
+      el.removeAttribute("auto-scan");
+    } else {
+      el.setAttribute("auto-scan", "");
+    }
+  }, [autoScan]);
+  useEffect(() => {
+    const el = elementRef.current;
+    if (!el || debounce === void 0) return;
+    el.setAttribute("debounce", String(debounce));
+  }, [debounce]);
+  useEffect(() => {
+    const instance = instanceRef.current;
+    if (!instance) return;
+    const el = elementRef.current;
+    if (el) {
+      el.scopeElement = scope?.current ?? void 0;
+    }
+    void instance.runScan();
+  });
+  const runScan = useCallback(
+    () => instanceRef.current?.runScan() ?? Promise.resolve(null),
+    []
+  );
+  const setTheme = useCallback((t) => {
+    instanceRef.current?.setTheme(t);
+  }, []);
+  return { runScan, setTheme };
+}
+
+// src/component.tsx
+function A11yHud(props) {
+  useA11yHud(props);
+  return null;
+}
+
+export { A11yHud, useA11yHud };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hook.ts","../src/component.tsx"],"names":[],"mappings":";;;;AAKO,SAAS,UAAA,CAAW,OAAA,GAA6B,EAAC,EAAqB;AAC5E,EAAA,MAAM,EAAE,KAAA,EAAO,KAAA,EAAO,QAAA,EAAU,UAAS,GAAI,OAAA;AAC7C,EAAA,MAAM,WAAA,GAAc,OAA+B,IAAI,CAAA;AACvD,EAAA,MAAM,UAAA,GAAa,OAA8B,IAAI,CAAA;AAKrD,EAAA,SAAA,CAAU,MAAM;AAGd,IAAA,MAAM,WAAW,KAAA,CAAM;AAAA,MACrB,GAAI,KAAA,KAAU,MAAA,IAAa,EAAE,KAAA,EAAM;AAAA,MACnC,GAAI,QAAA,KAAa,MAAA,IAAa,EAAE,QAAA,EAAS;AAAA,MACzC,GAAI,QAAA,KAAa,MAAA,IAAa,EAAE,QAAA;AAAS,KAC1C,CAAA;AACD,IAAA,WAAA,CAAY,OAAA,GAAU,QAAA;AACtB,IAAA,UAAA,CAAW,OAAA,GAAU,QAAA,CAAS,aAAA,CAA8B,UAAU,CAAA;AACtE,IAAA,OAAO,MAAM;AACX,MAAA,QAAA,CAAS,OAAA,EAAQ;AACjB,MAAA,WAAA,CAAY,OAAA,GAAU,IAAA;AACtB,MAAA,UAAA,CAAW,OAAA,GAAU,IAAA;AAAA,IACvB,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,KAAA,KAAU,MAAA,EAAW,WAAA,CAAY,OAAA,EAAS,SAAS,KAAK,CAAA;AAAA,EAC9D,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,KAAK,UAAA,CAAW,OAAA;AACtB,IAAA,IAAI,CAAC,EAAA,EAAI;AACT,IAAA,IAAI,aAAa,KAAA,EAAO;AACtB,MAAA,EAAA,CAAG,gBAAgB,WAAW,CAAA;AAAA,IAChC,CAAA,MAAO;AACL,MAAA,EAAA,CAAG,YAAA,CAAa,aAAa,EAAE,CAAA;AAAA,IACjC;AAAA,EACF,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,KAAK,UAAA,CAAW,OAAA;AACtB,IAAA,IAAI,CAAC,EAAA,IAAM,QAAA,KAAa,MAAA,EAAW;AACnC,IAAA,EAAA,CAAG,YAAA,CAAa,UAAA,EAAY,MAAA,CAAO,QAAQ,CAAC,CAAA;AAAA,EAC9C,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAOb,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,WAAW,WAAA,CAAY,OAAA;AAC7B,IAAA,IAAI,CAAC,QAAA,EAAU;AACf,IAAA,MAAM,KAAK,UAAA,CAAW,OAAA;AACtB,IAAA,IAAI,EAAA,EAAI;AACN,MAAA,EAAA,CAAG,YAAA,GAAe,OAAO,OAAA,IAAW,MAAA;AAAA,IACtC;AACA,IAAA,KAAK,SAAS,OAAA,EAAQ;AAAA,EACxB,CAAC,CAAA;AAED,EAAA,MAAM,OAAA,GAAU,WAAA;AAAA,IACd,MACE,WAAA,CAAY,OAAA,EAAS,SAAQ,IAAK,OAAA,CAAQ,QAAQ,IAA6B,CAAA;AAAA,IACjF;AAAC,GACH;AAEA,EAAA,MAAM,QAAA,GAAW,WAAA,CAAY,CAAC,CAAA,KAAmB;AAC/C,IAAA,WAAA,CAAY,OAAA,EAAS,SAAS,CAAC,CAAA;AAAA,EACjC,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,EAAE,SAAS,QAAA,EAAS;AAC7B;;;ACzEO,SAAS,QAAQ,KAAA,EAA2B;AACjD,EAAA,UAAA,CAAW,KAAK,CAAA;AAChB,EAAA,OAAO,IAAA;AACT","file":"index.js","sourcesContent":["import type { A11yHudElement, A11yHudInstance, AxeResults, Theme } from \"a11y-hud\";\nimport { mount } from \"a11y-hud\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport type { UseA11yHudOptions, UseA11yHudReturn } from \"./types.js\";\n\nexport function useA11yHud(options: UseA11yHudOptions = {}): UseA11yHudReturn {\n  const { theme, scope, autoScan, debounce } = options;\n  const instanceRef = useRef<A11yHudInstance | null>(null);\n  const elementRef = useRef<A11yHudElement | null>(null);\n\n  // Mount the CE once. Capture the element reference immediately after mount()\n  // so subsequent effects can access it without re-querying the DOM.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: intentional mount-once effect; initial options are applied here, changes are tracked by the separate sync effects below\n  useEffect(() => {\n    // exactOptionalPropertyTypes forbids passing `undefined` for optional props;\n    // build the options object conditionally to satisfy the constraint.\n    const instance = mount({\n      ...(theme !== undefined && { theme }),\n      ...(autoScan !== undefined && { autoScan }),\n      ...(debounce !== undefined && { debounce }),\n    });\n    instanceRef.current = instance;\n    elementRef.current = document.querySelector<A11yHudElement>(\"a11y-hud\");\n    return () => {\n      instance.unmount();\n      instanceRef.current = null;\n      elementRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (theme !== undefined) instanceRef.current?.setTheme(theme);\n  }, [theme]);\n\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el) return;\n    if (autoScan === false) {\n      el.removeAttribute(\"auto-scan\");\n    } else {\n      el.setAttribute(\"auto-scan\", \"\");\n    }\n  }, [autoScan]);\n\n  useEffect(() => {\n    const el = elementRef.current;\n    if (!el || debounce === undefined) return;\n    el.setAttribute(\"debounce\", String(debounce));\n  }, [debounce]);\n\n  // Render-settled signal: runs after every React commit. Always syncs scope\n  // (including clearing it when scope becomes undefined), then triggers a\n  // rescan. This is the adapter's core value — rescans fire after React\n  // finishes rendering, catching route changes and prop-driven ARIA mutations\n  // that the MutationObserver may coalesce.\n  useEffect(() => {\n    const instance = instanceRef.current;\n    if (!instance) return;\n    const el = elementRef.current;\n    if (el) {\n      el.scopeElement = scope?.current ?? undefined;\n    }\n    void instance.runScan();\n  });\n\n  const runScan = useCallback(\n    (): Promise<AxeResults> =>\n      instanceRef.current?.runScan() ?? Promise.resolve(null as unknown as AxeResults),\n    []\n  );\n\n  const setTheme = useCallback((t: Theme): void => {\n    instanceRef.current?.setTheme(t);\n  }, []);\n\n  return { runScan, setTheme };\n}\n","import { useA11yHud } from \"./hook.js\";\nimport type { A11yHudProps } from \"./types.js\";\n\nexport function A11yHud(props: A11yHudProps): null {\n  useA11yHud(props);\n  return null;\n}\n"]}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@a11y-hud/react",
+  "version": "0.2.0",
+  "description": "React adapter for a11y-hud — run axe-core accessibility audits in your React app with no DevTools required.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "a11y-hud": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.49.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitest/coverage-v8": "^4.1.5",
+    "jsdom": "^29.1.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.3.5",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/arthurvasconcelos/a11y-hud#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arthurvasconcelos/a11y-hud.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/arthurvasconcelos/a11y-hud/issues"
+  },
+  "keywords": [
+    "accessibility",
+    "a11y",
+    "axe",
+    "axe-core",
+    "wcag",
+    "react",
+    "dev-tools",
+    "overlay",
+    "hud"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "playwright test",
+    "typecheck": "tsc --noEmit"
+  }
+}