feat: multi-URL aware helpers for cross-plugin composition #1208

hanna-skryl · 2026-01-08T20:27:29Z

Add multi-URL aware helpers (lighthouseGroupRefs, lighthouseAuditRefs, axeGroupRefs, axeAuditRefs) that expand category refs for multi-URL configurations
Deprecate singular helpers (lighthouseGroupRef, lighthouseAuditRef, axeGroupRef, axeAuditRef) and category helpers (lighthouseCategories, axeCategories)
Remove validateUrlContext in favor of Zod schema validation via pluginUrlContextSchema
Implement weight averaging: when both URL weights and user-defined category ref weights are provided, the final weight is calculated as their average
Add unit tests for new helpers
Update plugin READMEs with new API examples and cross-plugin composition patterns

nx-cloud · 2026-01-08T20:28:49Z

View your CI Pipeline Execution ↗ for commit f7263a4

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 27s	View ↗
`nx run-many --targets=code-pushup --parallel=fa...`	✅ Succeeded	12m 42s	View ↗
`nx run-many -t unit-test,int-test`	✅ Succeeded	5s	View ↗

☁️ Nx Cloud last updated this comment at 2026-01-09 00:10:21 UTC

pkg-pr-new · 2026-01-08T20:29:06Z

Open in StackBlitz

@code-pushup/ci

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

@code-pushup/cli

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

@code-pushup/core

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

@code-pushup/create-cli

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

@code-pushup/models

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

@code-pushup/nx-plugin

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

@code-pushup/axe-plugin

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

@code-pushup/coverage-plugin

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

@code-pushup/js-packages-plugin

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

@code-pushup/eslint-plugin

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

@code-pushup/jsdocs-plugin

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

@code-pushup/lighthouse-plugin

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

@code-pushup/typescript-plugin

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

@code-pushup/utils

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

commit: f7263a4

github-actions · 2026-01-08T20:36:22Z

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit 09f7608 with previous commit 4d69dc3.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Performance	🔴 36	🔴 35
Documentation	🔴 36	🔴 37
Code coverage	🟢 91	🟢 91
Bug prevention	🟡 75	🟡 75
Axe Accessibility	🟡 88	🟡 88
Code style	🟢 99	🟢 99	–
Security	🟡 51	🟡 51	–
Updates	🟡 78	🟡 78	–
Type Safety	🟡 67	🟡 67	–
Miscellaneous	🟡 67	🟡 67	–
Accessibility	🟢 92	🟢 92	–
Best Practices	🟢 100	🟢 100	–
SEO	🟢 92	🟢 92	–

👍 2 groups improved, 👎 1 group regressed, 👍 6 audits improved, 👎 3 audits regressed, 12 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score
Lighthouse	Performance	🔴 36	🔴 35
JSDocs coverage	Documentation coverage	🔴 36	🔴 37
Code coverage	Code coverage metrics	🟢 91	🟢 91

31 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
Lighthouse	Initial server response time was short	🟥 Root document took 630 ms	🟩 Root document took 410 ms
Lighthouse	Total Blocking Time	🟥 1,780 ms	🟥 2,480 ms
JSDocs coverage	Classes coverage	🟥 6 undocumented classes	🟥 5 undocumented classes
Lighthouse	Time to Interactive	🟥 13.4 s	🟥 14.3 s
JSDocs coverage	Functions coverage	🟥 587 undocumented functions	🟥 582 undocumented functions
JSDocs coverage	Variables coverage	🟥 268 undocumented variables	🟥 267 undocumented variables
JSDocs coverage	Types coverage	🟥 248 undocumented types	🟥 249 undocumented types
Code coverage	Line coverage	🟨 87 %	🟨 87.1 %
Code coverage	Function coverage	🟩 94 %	🟩 94.1 %
Lighthouse	Minimizes main-thread work	🟥 9.3 s	🟥 11.9 s
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 31 resources found
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,106 KiB	🟩 Total size was 2,107 KiB
Lighthouse	JavaScript execution time	🟥 4.4 s	🟥 5.4 s
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Largest Contentful Paint	🟥 11.5 s	🟥 11.9 s
Lighthouse	Max Potential First Input Delay	🟥 1,090 ms	🟥 1,330 ms
Lighthouse	Server Backend Latencies	🟩 260 ms	🟩 230 ms
Lighthouse	Speed Index	🟥 6.7 s	🟥 6.7 s
Lighthouse	First Contentful Paint	🟥 3.1 s	🟥 3.1 s
Lighthouse	Network Round Trip Times	🟩 20 ms	🟩 20 ms
Code coverage	Branch coverage	🟨 87.3 %	🟨 87.3 %

658 other audits are unchanged.

github-actions · 2026-01-08T20:43:39Z

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit 09f7608 with previous commit 4d69dc3.

💼 Project `plugin-axe`

🥳 Code PushUp report has improved.

🕵️ See full comparison in Code PushUp portal 🔍

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

4 other categories are unchanged.

👍 2 groups improved, 👍 4 audits improved

🗃️ Groups

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

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
JSDocs coverage	Functions coverage	🟥 24 undocumented functions	🟥 21 undocumented functions
JSDocs coverage	Variables coverage	🟥 19 undocumented variables	🟥 17 undocumented variables
Code coverage	Line coverage	🟨 69.7 %	🟨 71.9 %
Code coverage	Branch coverage	🟨 86.3 %	🟨 87.3 %

439 other audits are unchanged.

💼 Project `utils`

🤨 Code PushUp report has both improvements and regressions.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 38	🔴 40
Code coverage	🟢 95	🟢 95

4 other categories are unchanged.

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

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDocs coverage	Documentation coverage	🔴 38	🔴 40
Code coverage	Code coverage metrics	🟢 95	🟢 95

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
JSDocs coverage	Classes coverage	🟥 3 undocumented classes	🟨 2 undocumented classes
JSDocs coverage	Types coverage	🟥 47 undocumented types	🟥 48 undocumented types
Code coverage	Branch coverage	🟩 91.9 %	🟩 91.9 %
JSDocs coverage	Variables coverage	🟥 40 undocumented variables	🟥 41 undocumented variables
JSDocs coverage	Functions coverage	🟥 236 undocumented functions	🟥 235 undocumented functions
Code coverage	Line coverage	🟩 97 %	🟩 97 %
Code coverage	Function coverage	🟩 95.6 %	🟩 95.6 %

437 other audits are unchanged.

💼 Project `plugin-lighthouse`

🤨 Code PushUp report has both improvements and regressions.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 48	🔴 48
Code coverage	🟢 99	🟢 99

4 other categories are unchanged.

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

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDocs coverage	Documentation coverage	🔴 48	🔴 48
Code coverage	Code coverage metrics	🟢 99	🟢 99

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
JSDocs coverage	Functions coverage	🟥 48 undocumented functions	🟥 47 undocumented functions
Code coverage	Line coverage	🟩 97.2 %	🟩 97 %
Code coverage	Branch coverage	🟩 96.2 %	🟩 96.3 %

441 other audits are unchanged.

💼 Project `models`

🤨 Code PushUp report has both improvements and regressions.

🕵️ See full comparison in Code PushUp portal 🔍

All of 4 categories are unchanged.

1 audit changed without impacting score

🗃️ Groups

All of 12 groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Code coverage	Line coverage	🟩 97.2 %	🟩 97.2 %

436 other audits are unchanged.

10 other projects are unchanged.

packages/plugin-lighthouse/src/lib/utils.unit.test.ts

BioPhoton

test checks could get adjusted

BioPhoton · 2026-01-09T16:34:26Z

packages/plugin-axe/src/lib/categories.ts

-  return [createAggregatedCategory(groups, context)];
+  return [
+    {
+      slug: 'axe-a11y',


could we use AXE_PLUGIN_SLUG here?

BioPhoton

added comment

hanna-skryl self-assigned this Jan 8, 2026

github-actions bot added 📖 Project documentation improvements or additions to the project documentation 🔬 testing writing tests 🧩 models 🧩 utils 🧩 lighthouse-plugin 🧩 axe-plugin labels Jan 8, 2026

hanna-skryl marked this pull request as ready for review January 8, 2026 20:44

hanna-skryl requested a review from BioPhoton as a code owner January 8, 2026 20:44

hanna-skryl requested a review from matejchalk January 8, 2026 20:44

BioPhoton reviewed Jan 8, 2026

View reviewed changes

packages/plugin-lighthouse/src/lib/utils.unit.test.ts Outdated Show resolved Hide resolved

BioPhoton requested changes Jan 8, 2026

View reviewed changes

feat: multi-URL aware helpers for cross-plugin composition

f7263a4

hanna-skryl force-pushed the feat/multi-url-cross-plugin-refs branch from 0461ad8 to f7263a4 Compare January 8, 2026 23:53

hanna-skryl requested a review from BioPhoton January 9, 2026 00:11

BioPhoton reviewed Jan 9, 2026

View reviewed changes

feat: multi-URL aware helpers for cross-plugin composition #1208

Are you sure you want to change the base?

feat: multi-URL aware helpers for cross-plugin composition #1208

Uh oh!

Conversation

hanna-skryl commented Jan 8, 2026

Uh oh!

nx-cloud bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code PushUp

🏷️ Categories

🗃️ Groups

🛡️ Audits

Uh oh!

github-actions bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code PushUp

💼 Project plugin-axe

🗃️ Groups

🛡️ Audits

💼 Project utils

🗃️ Groups

🛡️ Audits

💼 Project plugin-lighthouse

🗃️ Groups

🛡️ Audits

💼 Project models

🗃️ Groups

🛡️ Audits

Uh oh!

Uh oh!

BioPhoton left a comment

Choose a reason for hiding this comment

Uh oh!

BioPhoton Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

BioPhoton left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

nx-cloud bot commented Jan 8, 2026 •

edited

Loading

pkg-pr-new bot commented Jan 8, 2026 •

edited

Loading

github-actions bot commented Jan 8, 2026 •

edited

Loading

github-actions bot commented Jan 8, 2026 •

edited

Loading

💼 Project `plugin-axe`

💼 Project `utils`

💼 Project `plugin-lighthouse`

💼 Project `models`