feat(plugin-axe): aggregate categories

[hanna-skryl]

Closes #1139

Add axeCategories helper for streamlined category configuration.

• Auto-generates accessibility category when no categories are provided
• Expands user-provided categories for multi-URL configurations

Note

The initially proposed mergeAxeGroupRefs was replaced with axeCategories (see the updated issue description) for a more intuitive API that describes what you get rather than how it works internally.

The Lighthouse plugin will be updated to follow this pattern (lighthouseCategories).

Note

The auto-generated category uses the slug axe-a11y to coexist with Lighthouse's a11y category. A composeCategory helper for combining plugins is planned (#1179).

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 1487708

Command	Status	Duration	Result
nx run ci:code-pushup -- merge-diffs --files=/h...	✅ Succeeded	5s	View ↗
nx run-many --targets=code-pushup --parallel=fa...	✅ Succeeded	1m 23s	View ↗
nx run-many --targets=code-pushup --parallel=fa...	✅ Succeeded	12m 16s	View ↗
nx run-many -t unit-test,int-test	✅ Succeeded	1m 51s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-12-11 15:36:04 UTC

[pkg-pr-new]

Open in StackBlitz

@code-pushup/ci

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/ci@1182

@code-pushup/cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/cli@1182

@code-pushup/core

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/core@1182

@code-pushup/create-cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/create-cli@1182

@code-pushup/models

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/models@1182

@code-pushup/nx-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/nx-plugin@1182

@code-pushup/axe-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/axe-plugin@1182

@code-pushup/coverage-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/coverage-plugin@1182

@code-pushup/eslint-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/eslint-plugin@1182

@code-pushup/js-packages-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/js-packages-plugin@1182

@code-pushup/jsdocs-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/jsdocs-plugin@1182

@code-pushup/lighthouse-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/lighthouse-plugin@1182

@code-pushup/typescript-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/typescript-plugin@1182

@code-pushup/utils

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/utils@1182

commit: 1487708

[github-actions]

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit f2e558b with previous commit a86654b.

💼 Project plugin-axe

🤨 Code PushUp report has both improvements and regressions.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🟡 69	🟡 68
Code coverage	🟢 92	🟢 93

4 other categories are unchanged.

👍 1 group improved, 👎 1 group regressed, 👍 2 audits improved, 👎 1 audit regressed

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDoc coverage	Documentation coverage	🟡 69	🟡 68
Code coverage	Code coverage metrics	🟢 92	🟢 93

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
JSDoc coverage	Functions coverage	🟥 13 undocumented functions	🟥 21 undocumented functions
Code coverage	Line coverage	🟨 67.2 %	🟨 72.3 %
Code coverage	Branch coverage	🟨 85.1 %	🟨 86.4 %

439 other audits are unchanged.

💼 Project cli

😟 Code PushUp report has regressed.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Code coverage	🟢 93	🟢 92

5 other categories are unchanged.

👎 1 group regressed, 👎 2 audits regressed

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
Code coverage	Code coverage metrics	🟢 93	🟢 92

14 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Code coverage	Line coverage	🟨 89.1 %	🟨 88.5 %
Code coverage	Branch coverage	🟨 84.4 %	🟨 84.2 %

441 other audits are unchanged.

---

12 other projects are unchanged.

[github-actions]

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit f2e558b with previous commit a86654b.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Performance	🔴 43	🔴 38
Best Practices	🟢 100	🟢 97
Code style	🟢 100	🟢 99
Code coverage	🟡 89	🟡 89
Documentation	🔴 35	🔴 35
Axe Accessibility	n/a (*)	🟡 87	n/a (*)
Bug prevention	🟡 67	🟡 67	–
Security	🔴 43	🔴 43	–
Updates	🟡 71	🟡 71	–
Type Safety	🟡 56	🟡 56	–
Miscellaneous	🟡 67	🟡 67	–
Accessibility	🟢 92	🟢 92	–
SEO	🟢 92	🟢 92	–

(*) New category.

👍 1 group improved, 👎 6 groups regressed, 👍 3 audits improved, 👎 10 audits regressed, 19 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
ESLint	Style guide (import)	🟢 100	🟡 80
Axe Accessibility	ARIA	🟢 95	🟡 89
Lighthouse	Performance	🔴 43	🔴 38
Lighthouse	Best Practices	🟢 100	🟢 97
ESLint	Suggestions	🟢 100	🟢 99
Code coverage	Code coverage metrics	🟡 89	🟡 89
JSDoc coverage	Documentation coverage	🔴 35	🔴 35

27 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Lighthouse	Initial server response time was short	🟩 Root document took 430 ms	🟥 Root document took 2,700 ms
Axe Accessibility	Elements must only use permitted ARIA attributes	🟩 96 elements	🟥 1 error
ESLint	Forbid unassigned imports	🟩 passed	🟥 1 warning
Lighthouse	No browser errors logged to the console	🟩 passed	🟥 failed
Lighthouse	Enable text compression	🟩 0	🟨 Potential savings of 29 KiB
Lighthouse	Speed Index	🟨 5.6 s	🟥 10.1 s
Lighthouse	First Contentful Paint	🟨 3.0 s	🟥 5.3 s
Lighthouse	Total Blocking Time	🟥 1,040 ms	🟥 760 ms
Lighthouse	Time to Interactive	🟥 12.0 s	🟥 15.0 s
Lighthouse	Max Potential First Input Delay	🟥 810 ms	🟥 890 ms
Code coverage	Function coverage	🟩 90.5 %	🟩 90.6 %
Code coverage	Line coverage	🟨 84.8 %	🟨 84.8 %
JSDoc coverage	Functions coverage	🟥 559 undocumented functions	🟥 567 undocumented functions
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,055 KiB	🟩 Total size was 2,153 KiB
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Minimizes main-thread work	🟥 7.4 s	🟥 9.5 s
Lighthouse	Server Backend Latencies	🟩 1,120 ms	🟩 2,310 ms
Lighthouse	Largest Contentful Paint	🟥 10.9 s	🟥 11.7 s
Lighthouse	Uses efficient cache policy on static assets	🟨 30 resources found	🟨 30 resources found
Lighthouse	Reduce unused CSS	🟥 Potential savings of 94 KiB	🟥 Potential savings of 94 KiB
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 164 KiB	🟥 Potential savings of 187 KiB
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 101 KiB	🟥 Potential savings of 103 KiB
Lighthouse	Avoids an excessive DOM size	🟥 2,353 elements	🟥 2,238 elements
Lighthouse	JavaScript execution time	🟥 2.9 s	🟥 2.8 s
Lighthouse	Network Round Trip Times	🟩 20 ms	🟩 70 ms
Axe Accessibility	Interactive controls must not be nested	🟩 59 elements	🟩 46 elements
Axe Accessibility	Elements must only use supported ARIA attributes	🟩 96 elements	🟩 86 elements
Axe Accessibility	ARIA attributes must be used as specified for the element's role	🟩 96 elements	🟩 86 elements
Axe Accessibility	ARIA attributes must conform to valid names	🟩 96 elements	🟩 86 elements
Axe Accessibility	<li> elements must be contained in a <ul> or <ol>	🟩 65 elements	🟩 66 elements
Code coverage	Branch coverage	🟨 87.1 %	🟨 87.1 %
Lighthouse	Cumulative Layout Shift	🟩 0	🟩 0

646 other audits are unchanged.

[BioPhoton]

LGTM 🤩
The naming is also better. Thx for the rename!