feat(utils): performance TS ext by BioPhoton · Pull Request #1213 · code-pushup/cli

BioPhoton · 2026-01-12T02:01:49Z

Related to #1197

This PR includes:

perf-hooks.d.ts types to extend performance APIs with Chrome DevTools Extensibility API types so we get autocomplete and type checks when using e.g. performance.mark('mark-name', { details: /*this is typed*/})

nx-cloud · 2026-01-12T02:03:07Z

View your CI Pipeline Execution ↗ for commit a08b227

Command	Status	Duration	Result
`nx run-many --targets=code-pushup --parallel=fa...`	❌ Failed	12m 52s	View ↗
`nx run-many -t unit-test,int-test`	✅ Succeeded	12s	View ↗

☁️ Nx Cloud last updated this comment at 2026-02-01 22:04:52 UTC

github-actions · 2026-01-12T02:10:14Z

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit 7dbf3e3 with previous commit 7b6e72c.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🟡 53	🔴 40
Performance	🔴 33	🔴 36
Security	🔴 47	🔴 45
Code style	🟢 100	🟢 98
Bug prevention	🟡 75	🟡 75
Code coverage	🟢 93	🟢 93
Axe Accessibility	🟡 88	🟡 88
Updates	🟡 78	🟡 78	–
Type Safety	🟡 67	🟡 67	–
Miscellaneous	🟡 67	🟡 67	–
Accessibility	🟢 92	🟢 92	–
Best Practices	🟢 100	🟢 100	–
SEO	🟢 92	🟢 92	–

👍 1 group improved, 👎 6 groups regressed, 👍 6 audits improved, 👎 16 audits regressed, 15 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score
ESLint	Stylistic (functional)	🟢 100	🟡 50
JSDocs coverage	Documentation coverage	🟡 53	🔴 40
Lighthouse	Performance	🔴 33	🔴 36
JS packages	npm audit	🔴 47	🔴 45
ESLint	Suggestions	🟢 100	🟢 98
ESLint	Problems	🟢 100	🟢 99
Code coverage	Code coverage metrics	🟢 93	🟢 93

27 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value
Lighthouse	Initial server response time was short	🟥 Root document took 620 ms	🟩 Root document took 480 ms
ESLint	require setup and teardown to be within a hook	🟩 passed	🟥 19 warnings
ESLint	Disallow unused expressions	🟩 passed	🟥 9 warnings
JSDocs coverage	Interfaces coverage	🟩 0 undocumented interfaces	🟥 9 undocumented interfaces
ESLint	Disallow unused variables	🟩 passed	🟥 7 errors
ESLint	Enforce using a particular method signature syntax	🟩 passed	🟥 7 warnings
ESLint	Prefer property signatures over method signatures.	🟩 passed	🟥 7 warnings
ESLint	Disallow the `any` type	🟩 passed	🟥 4 errors
ESLint	Prefer using the `node:` protocol when importing Node.js builtin modules.	🟩 passed	🟥 1 warning
JSDocs coverage	Methods coverage	🟨 10 undocumented methods	🟨 22 undocumented methods
Lighthouse	Total Blocking Time	🟥 3,150 ms	🟥 1,640 ms
Lighthouse	First Contentful Paint	🟥 3.1 s	🟥 3.3 s
Lighthouse	Speed Index	🟥 7.3 s	🟥 6.8 s
JSDocs coverage	Classes coverage	🟨 5 undocumented classes	🟨 6 undocumented classes
JS packages	Vulnerabilities for npm prod dependencies.	🟨 11 vulnerabilities (2 high, 2 moderate, 7 low)	🟨 11 vulnerabilities (2 high, 3 moderate, 6 low)
Lighthouse	Time to Interactive	🟥 14.2 s	🟥 13.5 s
JSDocs coverage	Properties coverage	🟥 42 undocumented properties	🟥 46 undocumented properties
JSDocs coverage	Types coverage	🟥 264 undocumented types	🟥 266 undocumented types
Code coverage	Branch coverage	🟨 89.2 %	🟨 89.1 %
JSDocs coverage	Functions coverage	🟥 585 undocumented functions	🟥 586 undocumented functions
Code coverage	Line coverage	🟩 92.8 %	🟩 92.8 %
Code coverage	Function coverage	🟩 94.4 %	🟩 94.4 %
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,087 KiB	🟩 Total size was 2,096 KiB
Lighthouse	Minimizes main-thread work	🟥 13.9 s	🟥 9.7 s
Lighthouse	JavaScript execution time	🟥 4.6 s	🟥 3.3 s
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Server Backend Latencies	🟩 640 ms	🟩 1,120 ms
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 31 resources found
Lighthouse	Largest Contentful Paint	🟥 11.7 s	🟥 12.0 s
Lighthouse	Reduce unused CSS	🟥 Potential savings of 125 KiB	🟥 Potential savings of 139 KiB
Lighthouse	Max Potential First Input Delay	🟥 1,190 ms	🟥 1,040 ms
Lighthouse	Network Round Trip Times	🟩 10 ms	🟩 60 ms
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 225 KiB	🟥 Potential savings of 225 KiB
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 86 KiB	🟥 Potential savings of 86 KiB
TypeScript	Semantic errors	🟥 43 errors	🟥 52 errors
Lighthouse	ARIA `tooltip` elements have accessible names	🟩 passed	🟩 0
Axe	ARIA hidden element must not be focusable or contain focusable elements	🟩 201 elements	🟩 202 elements

642 other audits are unchanged.

pkg-pr-new · 2026-01-13T23:35:36Z

Open in StackBlitz

@code-pushup/ci

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

@code-pushup/cli

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

@code-pushup/core

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

@code-pushup/create-cli

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

@code-pushup/nx-plugin

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

@code-pushup/models

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

@code-pushup/axe-plugin

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

@code-pushup/coverage-plugin

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

@code-pushup/eslint-plugin

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

@code-pushup/js-packages-plugin

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

@code-pushup/jsdocs-plugin

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

@code-pushup/lighthouse-plugin

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

@code-pushup/typescript-plugin

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

@code-pushup/utils

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

commit: a08b227

github-actions · 2026-01-13T23:35:40Z

Code PushUp

🥳 Code PushUp report has improved – compared current commit 42e5f04 with previous commit 91f50cf.

💼 Project `utils`

🥳 Code PushUp report has improved.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Documentation	🔴 42	🔴 42

5 other categories are unchanged.

👍 1 group improved, 👍 1 audit improved

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
JSDocs coverage	Documentation coverage	🔴 42	🔴 42

14 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
JSDocs coverage	Types coverage	🟥 65 undocumented types	🟥 65 undocumented types

443 other audits are unchanged.

13 other projects are unchanged.

# Conflicts: # packages/utils/src/lib/performance-observer.ts

…e-ts-ext

Copilot

Pull request overview

This PR extends Node’s perf_hooks typings with Chrome DevTools Extensibility API support and wires that through the profiler utilities so performance.mark/measure and trace encoding/decoding understand structured detail.devtools payloads.

Changes:

Adds perf-hooks.d.ts module augmentations and a type-focused test suite to give perf_hooks entries/marks/measures a typed detail.devtools payload and stricter mark/measure option typing.
Adjusts user-timing detail/DevTools payload types plus trace encode/decode utilities and tests to round-trip DevTools-style detail structures.
Updates TS configs and a report-loading test to include new .d.ts files and reflect required configuration properties.

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/utils/tsconfig.test.json	Includes top-level `src/*.d.ts` so type tests pick up local declaration files.
packages/utils/tsconfig.lib.json	Changes library outDir and include patterns to emit declarations alongside `src` and include new `.d.ts` files.
packages/utils/src/perf-hooks.type.test.ts	New type-only tests asserting the augmented `perf_hooks` APIs and DevTools payload typings; currently reference some undefined helper types.
packages/utils/src/perf-hooks.d.ts	New declaration file augmenting `perf_hooks`/`node:perf_hooks` with DevTools-aware entry, mark, measure, observer list, and `performance` typings.
packages/utils/src/lib/user-timing-extensibility-api.type.ts	Tightens `WithDevToolsPayload`/`DetailPayloadWithDevtools`/`UserTimingDetail` definitions to require `devtools` and adds a convenience detail type.
packages/utils/src/lib/reports/load-report.unit.test.ts	Updates `loadReport` tests to pass `skipReports: false` in line with the stricter `PersistConfig` typing.
packages/utils/src/lib/profiler/trace-file-utils.unit.test.ts	Adjusts expectations for encode/decode helpers and trace event helpers to work with DevTools-shaped `detail.devtools` payloads.
packages/utils/src/lib/profiler/trace-file-utils.ts	Generalizes `encodeDetail`/`decodeDetail`, adds `encodeDetailToString`, and updates trace encode/decode helpers to correctly handle JSON-string and object forms of DevTools detail payloads.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-01T20:53:48Z

+ },
+}) satisfies PerformanceEntryWithDevtools;
+// Invalid examples
+({


PerformanceEntryWithDevtools is referenced here but is not declared anywhere in the project, which will cause a TypeScript error (Cannot find name 'PerformanceEntryWithDevtools') when running the tests. Please either introduce this type (e.g. as a typed alias for PerformanceEntry with the detail payload) or change the tests to assert against an existing exported type instead.

Copilot · 2026-02-01T20:53:49Z

 "extends": "./tsconfig.json",
 "compilerOptions": {
- "outDir": "../../dist/out-tsc",
+ "outDir": "dist",


Changing compilerOptions.outDir to "dist" deviates from the convention used by other packages (e.g. packages/core/tsconfig.lib.json:4 and packages/cli/tsconfig.lib.json:4 still use "../../dist/out-tsc") and may break tooling or publish scripts that expect all library outputs under dist/out-tsc. Please double-check the build/publish configuration for this package and either keep the outDir consistent with the rest of the repo or update the consumers of the build output accordingly.

Copilot · 2026-02-01T20:53:49Z

+ },
+ },
+}) satisfies PerformanceMeasureOptionsWithDevtools;
+// Invalid examples


PerformanceMeasureOptionsWithDevtools is used here but is not declared anywhere in the codebase, so this test file will fail to type-check with Cannot find name 'PerformanceMeasureOptionsWithDevtools'. Either import/define this type (for example as an alias to the existing MeasureOptionsWithDevtools<...>), or update the test to use an existing exported type such as PerformanceMeasureOptions.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

BioPhoton · 2026-02-03T14:56:13Z

Ill drop this feature in favour of our helpers that are fully compatible with all native APIs.

John Doe added 2 commits January 10, 2026 01:49

feat: add performance type extensions
79590b6

fix: wip
70ad6cd

github-actionsBot added 🔬 testing writing tests 🧩 utils 🛠️ tooling labels Jan 12, 2026

github-actionsBot assigned BioPhoton Jan 12, 2026

BioPhoton mentioned this pull request Jan 12, 2026
Implement performance profiling and trace file generation #1197
Open

John Doe added 3 commits January 12, 2026 16:03

fix: wip
5f1c67a

refactor: fix lint
c95589d

refactor: revert ts cfg
5d779e8

github-actionsBot removed the 🛠️ tooling label Jan 12, 2026

John Doe added 2 commits January 14, 2026 00:20

refactor: add APIs
2aff877

refactor: add types
be3d41d

John Doeand others added 10 commits January 14, 2026 00:40

refactor: fix lint
a46bb31

refactor: wip
d78d348

refactor: move types
16511eb

Merge branch 'refs/heads/main' into feat/utils/performance-ts-ext
6b2d6cd
# Conflicts: # packages/utils/src/lib/performance-observer.ts

refactor: docs
c45d91f

Merge branch 'refs/heads/main' into feat/utils/performance-ts-ext
1e385c8

Merge branch 'main' into feat/utils/performance-ts-ext
244508f

refactor: fix d.ts overloads and test them
2db06ff

Merge remote-tracking branch 'origin/main' into feat/utils/performanc…
fd9910c
…e-ts-ext

refactor: wip
fefaed6

github-actionsBot added the 🛠️ tooling label Feb 1, 2026

BioPhoton added 2 commits February 1, 2026 21:49

refactor: wip
48d72d1

refactor: wip
f4566fd

BioPhoton marked this pull request as ready for review February 1, 2026 20:50

BioPhoton requested a review from Copilot February 1, 2026 20:50

Copilotstarted reviewing on behalf of BioPhoton February 1, 2026 20:50 View session

CopilotAI reviewed Feb 1, 2026
View reviewed changes

BioPhoton requested a review from Copilot February 1, 2026 21:46

Copilotstarted reviewing on behalf of BioPhoton February 1, 2026 21:46 View session

BioPhotonand others added 2 commits February 1, 2026 22:46

Update packages/utils/src/lib/user-timing-extensibility-api.type.ts
54f5b01
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update packages/utils/src/perf-hooks.type.test.ts
a08b227
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

CopilotAI reviewed Feb 2, 2026

BioPhoton closed this Feb 3, 2026

Navigation Menu

Uh oh!

feat(utils): performance TS ext - #1213

feat(utils): performance TS ext#1213
BioPhoton wants to merge 21 commits into
mainfrom
feat/utils/performance-ts-ext

BioPhoton commented Jan 12, 2026•
edited
Loading

Uh oh!

nx-cloudBot commented Jan 12, 2026•
edited
Loading

Uh oh!

github-actionsBot commented Jan 12, 2026•
edited
Loading

🗃️ Groups

🛡️ Audits

Uh oh!

pkg-pr-newBot commented Jan 13, 2026•
edited
Loading

Uh oh!

github-actionsBot commented Jan 13, 2026•
edited
Loading

🗃️ Groups

🛡️ Audits

Uh oh!

CopilotAI left a comment

Uh oh!

CopilotAIFeb 1, 2026

Uh oh!

Uh oh!

Uh oh!

CopilotAIFeb 1, 2026

Uh oh!

CopilotAIFeb 1, 2026

Uh oh!

CopilotAI left a comment

Uh oh!

BioPhoton commented Feb 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

BioPhoton commented Jan 12, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Code PushUp

🏷️ Categories

🗃️ Groups

🛡️ Audits

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Code PushUp

💼 Project utils

🗃️ Groups

🛡️ Audits

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

CopilotAIFeb 1, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

CopilotAIFeb 1, 2026

Choose a reason for hiding this comment

Uh oh!

CopilotAIFeb 1, 2026

Choose a reason for hiding this comment

Uh oh!

CopilotAI left a comment

Choose a reason for hiding this comment

Uh oh!

BioPhoton commented Feb 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

BioPhoton commented Jan 12, 2026•
edited
Loading

nx-cloudBot commented Jan 12, 2026•
edited
Loading

github-actionsBot commented Jan 12, 2026•
edited
Loading

pkg-pr-newBot commented Jan 13, 2026•
edited
Loading

github-actionsBot commented Jan 13, 2026•
edited
Loading

💼 Project `utils`