docs: blog post on parserOptions.projectService #8031

JoshuaKGoldberg · 2023-12-06T18:46:09Z

PR Checklist

Addresses an existing open issue: fixes Docs: Add blog post & revamped docs for parserOptions.projectService #7350
That issue was marked as accepting prs
Steps in Contributing were taken

Overview

Adds a blog post that describes using parserOptions.projectService (what we previously called parserOptions.EXPERIMENTAL_useProjectService). The flow is roughly:

Introduction: the old situation & an overview of the blog post
Configuration: how to switch over & replace traditional config kludge
Predictability: benefits of the new API & not having tsconfig.eslint.jsons
Scalability: project references support! 🙌
Performance: noting that it's theoretically faster, but not always -- and that that's being treated as a bug
Next steps: feedback, the standalone package, and hope for typescript-go

This was previously blocked on:

feat(typescript-estree): add allowDefaultProjectForFiles project service allowlist option #7752: for locking down how an "additional files / to be given default program type info" should look
feat: add support for flat configs #7935: for example flat configs in the post
Creating a set of example configs on a new, not-yet-created https://github.com/typescript-eslint/examples
Enhancement: Finalize naming for EXPERIMENTAL_useProjectService #9004
Creating and running performance comparisons on ~~a new, not-yet-created https://github.com/typescript-eslint/project-apis-performance-comparison~~ https://github.com/typescript-eslint/performance

This previously had a lot more content on single-run mode and performance comparisons. Both are removed for a more streamlined blog post.

💖

typescript-eslint · 2023-12-06T18:46:12Z

Thanks for the PR, @JoshuaKGoldberg!

typescript-eslint is a 100% community driven project, and we are incredibly grateful that you are contributing to that community.

The core maintainers work on this in their personal time, so please understand that it may not be possible for them to review your work immediately.

Thanks again!

🙏 Please, if you or your company is finding typescript-eslint valuable, help us sustain the project by sponsoring it transparently on https://opencollective.com/typescript-eslint.

netlify · 2023-12-06T18:46:14Z

✅ Deploy Preview for typescript-eslint ready!

Name	Link
🔨 Latest commit	`d598bb9`
🔍 Latest deploy log	https://app.netlify.com/projects/typescript-eslint/deploys/683859a1ade60c00088e128e
😎 Deploy Preview	https://deploy-preview-8031--typescript-eslint.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 99 (🟢 up 2 from production) Accessibility: 100 (no change from production) Best Practices: 100 (no change from production) SEO: 98 (no change from production) PWA: 80 (no change from production) View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

packages/website/blog/2023-09-18-parser-options-project-true.md

packages/website/blog/2024-03-01-parser-options-project-service.md

Josh-Cena

Great to see exciting features

packages/website/blog/2024-03-01-parser-options-project-service.md

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>

packages/website/blog/2024-03-01-parser-options-project-service.md

nx-cloud · 2024-05-11T14:53:10Z

View your CI Pipeline Execution ↗ for commit d598bb9.

Command	Status	Duration	Result
`nx run-many -t typecheck`	✅ Succeeded	1m 51s	View ↗
`nx test eslint-plugin-internal --coverage=false`	✅ Succeeded	<1s	View ↗
`nx run types:build`	✅ Succeeded	<1s	View ↗
`nx run-many -t lint`	✅ Succeeded	8s	View ↗
`nx test typescript-estree --coverage=false`	✅ Succeeded	<1s	View ↗
`nx test eslint-plugin --coverage=false`	✅ Succeeded	<1s	View ↗
`nx typecheck ast-spec`	✅ Succeeded	<1s	View ↗
`nx run integration-tests:test`	✅ Succeeded	<1s	View ↗
`Additional runs (29)`	✅ Succeeded	...	View ↗

☁️ Nx Cloud last updated this comment at 2025-05-29 13:05:52 UTC

JoshuaKGoldberg · 2024-07-18T21:48:39Z

Status update: this is roughly ready for review except parserOptions.projectService no longer outperforms parserOptions.project. That's being investigated in #9571. If we don't get enough fixes on our end & TypeScript's by the time v8 is meant to go stable, we'll have to rephrase the ⚡ Performance section.

JoshuaKGoldberg · 2025-05-21T17:36:24Z

packages/website/blog/2025-05-26-project-service.mdx

+
+As of typescript-eslint@8.33.0, we've also extracted most of the Project Service code into a standalone [`@typescript-eslint/project-service`](/packages/project-service) package.
+It has no dependencies on ESLint and is designed to be usable for any linter to enable TypeScript's Project Service API for typed linting.
+See [Packages > Project Service](/packages/project-service) for more details.


Note that #10383 (comment) proposes a pretty big shake-up in other packages. I don't think it impacts this though. Just an FYI :)

packages/website/blog/2025-05-26-project-service.mdx

ronami

🚀🚀

packages/website/blog/2025-05-26-project-service.mdx

Co-authored-by: Ronen Amiel <ronen.amiel@gmail.com>

docs: blog post on parserOptions.projectService

be19629

JoshuaKGoldberg commented Dec 6, 2023

View reviewed changes

packages/website/blog/2023-09-18-parser-options-project-true.md Outdated Show resolved Hide resolved

JoshuaKGoldberg commented Dec 6, 2023

View reviewed changes

packages/website/blog/2024-03-01-parser-options-project-service.md Outdated Show resolved Hide resolved

JoshuaKGoldberg commented Dec 6, 2023

View reviewed changes

packages/website/blog/2024-03-01-parser-options-project-service.md Outdated Show resolved Hide resolved

JoshuaKGoldberg requested a review from bradzacher December 22, 2023 23:00

liuxingbaoyu mentioned this pull request Dec 23, 2023

chore: Enable useProjectService babel/babel#16192

Merged

bradzacher reviewed Dec 23, 2023

View reviewed changes

JoshuaKGoldberg and others added 2 commits December 24, 2023 00:23

Update packages/website/blog/2023-09-18-parser-options-project-true.md

105a406

Better diffs and a bit of streamlining

a107204

JoshuaKGoldberg commented Dec 24, 2023

View reviewed changes

packages/website/blog/2024-03-01-parser-options-project-service.md Outdated Show resolved Hide resolved

Account for solo and project references at each scale

31cbb5d

Josh-Cena reviewed Dec 24, 2023

View reviewed changes

JoshuaKGoldberg commented Dec 27, 2023

View reviewed changes

packages/website/blog/2024-03-01-parser-options-project-service.md Outdated Show resolved Hide resolved

Apply suggestions from code review

c0b6d90

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>

JoshuaKGoldberg mentioned this pull request Jan 25, 2024

ESLint does not re-compute cross-file information on file changes microsoft/vscode-eslint#1774

Open

Jack-Works reviewed Feb 26, 2024

View reviewed changes

packages/website/blog/2024-03-01-parser-options-project-service.md Outdated Show resolved Hide resolved

This was referenced Apr 26, 2024

Enhancement: Finalize naming for EXPERIMENTAL_useProjectService #9003

Closed

Enhancement: Finalize naming for EXPERIMENTAL_useProjectService #9004

Closed

JoshuaKGoldberg added this to the 8.0.0 milestone Apr 26, 2024

JoshuaKGoldberg mentioned this pull request May 2, 2024

feat: enable @typescript-eslint/recommended in create-next-app --typescript vercel/next.js#52845

Merged

JoshuaKGoldberg added 2 commits May 11, 2024 07:50

Merge branch 'main'

17fd25f

Adjusted vision section

a7097ac

JoshuaKGoldberg mentioned this pull request May 13, 2024

feat(typescript-estree): stabilize EXPERIMENTAL_useProjectService as projectService #9084

Merged

3 tasks

JoshuaKGoldberg mentioned this pull request Jun 22, 2024

Bug: Vue + TypeScript project slowdown with v8 alpha #9312

Closed

4 tasks

Merge branch 'main' into blog-parser-options-project-service

123052c

JoshuaKGoldberg added the blocked by another PR PRs which are ready to go but waiting on another PR label Jul 18, 2024

JoshuaKGoldberg added 12 commits May 21, 2025 11:09

More tweaks

025bf33

Back-links galore

6295c5f

nit: line length 'own'

e5491c4

allowDefaultProject rename

5b379fc

touch up project refs

6b7d8dd

Touch up feedback

aabd064

More proofreading

052ef50

More proofreading

0cfdefd

More proofreading

598ab00

More proofreading

ce6e9af

More proofreading

48bedd5

fix broken link

f08e16f

JoshuaKGoldberg marked this pull request as ready for review May 21, 2025 16:00

JoshuaKGoldberg requested review from Josh-Cena and bradzacher May 21, 2025 16:00

JoshuaKGoldberg commented May 21, 2025

View reviewed changes

benmccann reviewed May 28, 2025

View reviewed changes

packages/website/blog/2025-05-26-project-service.mdx Outdated Show resolved Hide resolved

kirkwaiblinger previously approved these changes May 28, 2025

View reviewed changes

packages/website/blog/2025-05-26-project-service.mdx Show resolved Hide resolved

benmccann mentioned this pull request May 28, 2025

Enhancement: deprecate project setting in favor of projectService setting #11252

Open

4 tasks

ronami previously approved these changes May 28, 2025

View reviewed changes

packages/website/blog/2025-05-26-project-service.mdx Outdated Show resolved Hide resolved

packages/website/blog/2025-05-26-project-service.mdx Outdated Show resolved Hide resolved

Merge branch 'main' into blog-parser-options-project-service

17cf9ad

JoshuaKGoldberg dismissed stale reviews from ronami and kirkwaiblinger via e791a1f May 29, 2025 12:52

JoshuaKGoldberg and others added 4 commits May 29, 2025 15:52

Shoutout Benn and SvelteKit

e791a1f

Add back tsconfigRootDir

b97b547

Apply suggestions from code review

15d054a

Co-authored-by: Ronen Amiel <ronen.amiel@gmail.com>

Update packages/website/blog/2025-05-26-project-service.mdx

d598bb9

Co-authored-by: Ronen Amiel <ronen.amiel@gmail.com>

JoshuaKGoldberg merged commit 02ebbe1 into typescript-eslint:main May 29, 2025
63 checks passed

JoshuaKGoldberg deleted the blog-parser-options-project-service branch May 29, 2025 13:10

github-actions bot locked as resolved and limited conversation to collaborators Jun 6, 2025

Uh oh!

docs: blog post on parserOptions.projectService #8031

docs: blog post on parserOptions.projectService #8031

Uh oh!

Conversation

JoshuaKGoldberg commented Dec 6, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Checklist

Overview

Uh oh!

typescript-eslint bot commented Dec 6, 2023

Uh oh!

netlify bot commented Dec 6, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for typescript-eslint ready!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Josh-Cena left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nx-cloud bot commented May 11, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

JoshuaKGoldberg commented Jul 18, 2024

Uh oh!

JoshuaKGoldberg May 21, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

ronami left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JoshuaKGoldberg commented Dec 6, 2023 •

edited

Loading

netlify bot commented Dec 6, 2023 •

edited

Loading

nx-cloud bot commented May 11, 2024 •

edited

Loading