Skip to content

docs(dev-server): document hmr utils#4870

Merged
alicewriteswrongs merged 1 commit intomainfrom
ap/jsdoc-hmr-util
Oct 9, 2023
Merged

docs(dev-server): document hmr utils#4870
alicewriteswrongs merged 1 commit intomainfrom
ap/jsdoc-hmr-util

Conversation

@alicewriteswrongs
Copy link
Contributor

@alicewriteswrongs alicewriteswrongs commented Sep 29, 2023

Add some documentation to src/dev-server/client/hmr-util.ts and friends

Does this introduce a breaking change?

  • Yes
  • No

Testing

This should be a comment-only change

@alicewriteswrongs alicewriteswrongs changed the title Ap/jsdoc hmr util docs(dev-server): document hmr utils Sep 29, 2023
@github-actions
Copy link
Contributor

github-actions bot commented Sep 29, 2023

--strictNullChecks error report

Typechecking with --strictNullChecks resulted in 1414 errors on this branch.

That's the same number of errors on main, so at least we're not creating new ones!

reports and statistics

Our most error-prone files
Path Error Count
src/dev-server/index.ts 37
src/mock-doc/serialize-node.ts 36
src/dev-server/server-process.ts 32
src/compiler/build/build-stats.ts 27
src/compiler/output-targets/dist-lazy/generate-lazy-module.ts 25
src/compiler/style/test/optimize-css.spec.ts 23
src/testing/puppeteer/puppeteer-element.ts 23
src/compiler/prerender/prerender-main.ts 22
src/runtime/vdom/vdom-render.ts 20
src/runtime/client-hydrate.ts 19
src/screenshot/connector-base.ts 19
src/compiler/config/test/validate-paths.spec.ts 16
src/dev-server/request-handler.ts 15
src/compiler/prerender/prerender-optimize.ts 14
src/compiler/sys/stencil-sys.ts 14
src/compiler/transpile/transpile-module.ts 14
src/runtime/vdom/vdom-annotations.ts 14
src/sys/node/node-sys.ts 14
src/compiler/build/build-finish.ts 13
src/compiler/prerender/prerender-queue.ts 13
Our most common errors
Typescript Error Code Count
TS2345 428
TS2322 405
TS18048 312
TS18047 100
TS2722 38
TS2532 36
TS2531 23
TS2454 14
TS2352 13
TS2769 10
TS2790 10
TS2538 8
TS2344 5
TS2416 4
TS2493 3
TS18046 2
TS2684 1
TS2488 1
TS2430 1

Unused exports report

There are 12 unused exports on this PR. That's the same number of errors on main, so at least we're not creating new ones!

Unused exports
File Line Identifier
src/runtime/bootstrap-lazy.ts 21 setNonce
src/screenshot/screenshot-fs.ts 18 readScreenshotData
src/testing/testing-utils.ts 198 withSilentWarn
src/utils/index.ts 140 CUSTOM
src/compiler/app-core/app-data.ts 25 BUILD
src/compiler/app-core/app-data.ts 114 Env
src/compiler/app-core/app-data.ts 116 NAMESPACE
src/compiler/fs-watch/fs-watch-rebuild.ts 110 updateCacheFromRebuild
src/compiler/types/validate-primary-package-output-target.ts 62 satisfies
src/compiler/types/validate-primary-package-output-target.ts 62 Record
src/testing/puppeteer/puppeteer-declarations.ts 485 WaitForEventOptions
src/compiler/sys/fetch/write-fetch-success.ts 7 writeFetchSuccessSync

@alicewriteswrongs alicewriteswrongs marked this pull request as ready for review October 2, 2023 19:42
@alicewriteswrongs alicewriteswrongs requested a review from a team as a code owner October 2, 2023 19:42
Copy link
Member

@rwaskiewicz rwaskiewicz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One quick question - I think this might have contributed to the SNC increase, but I'm not entirely sure 🤔

Comment on lines 67 to 68
(elm as HTMLLinkElement).href &&
(elm as HTMLLinkElement).rel &&
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Couldn't these be undefined? Wouldn't that make it such that the return type of this function could be boolean | undefined as a result?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could add !! to both those checks (which would also evaluate false if href is an empty string)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mm true, I'll throw a !! in there

This adds some documentation to `src/dev-server/client/hmr-util.ts`
which was previously largely undocumented.
@alicewriteswrongs alicewriteswrongs added this pull request to the merge queue Oct 9, 2023
Merged via the queue into main with commit 6f13bd3 Oct 9, 2023
@alicewriteswrongs alicewriteswrongs deleted the ap/jsdoc-hmr-util branch October 9, 2023 16:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants